generated from eblume/project-template
Erich Blume
e6524fddbb
All checks were successful
Build / validate (pull_request) Successful in 5m23s
Kick off the C2 Mikado chain for an opt-in (default-off) hephd
self-update mode (forge-poll -> cargo install from tag -> self-restart).
Goal card plus eight prerequisite cards, indexed from how-to.md:
release-poll-version-check, self-update-opt-in-flag (leaves)
-> self-update-poll-loop (notify-only core)
service-env-forge-access (leaf, the cargo/forge blocker)
+ self-update-poll-loop -> cargo-install-from-tag
service-respawn-on-clean-exit (leaf, systemd Restart=always)
+ cargo-install-from-tag -> self-restart-after-update
verify-hub-dropout-resilience (leaf, lock in the base-case guarantee)
Grounded in research of hephd's sync loop, daemon lifecycle, the
launchd/systemd service templates, and the forge releases API.
Captured from Hephaestus task 01KTA2NSNRYT902HC3VRW00S1J.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1.8 KiB
1.8 KiB
| title | modified | tags | ||
|---|---|---|---|---|
| How-To Guides | 2026-03-03 |
|
How-To Guides
Task-oriented guides for common operations.
Knowledge Base
- agent-change-process — C0/C1/C2 change classification and Mikado method
heph
- install-heph — Install
heph/hephdfrom the forge, set up the Neovim plugin, and isolate in-repo development - run-the-daemon — Run
hephdas an OS service withheph daemon start/stop/restart/status - set-up-sync-hub — Stand up the canonical hub (indri) and connect an existing device as an offline-capable spoke
- import-todoist — Seed a heph store from your Todoist projects + tasks (
mise run import-todoist)
Active Mikado chains
C2 chain: hephd self-update (opt-in daemon auto-update). See agent-change-process for the method.
- hephd-self-update — goal: opt-in, default-off mode where
hephdpolls for new releases and auto-updates itself - self-update-opt-in-flag — the
--self-updateopt-in flag (default off) - release-poll-version-check — poll the forge releases API and semver-compare against the running version
- self-update-poll-loop — background task wiring the flag to the version check (notify-only core)
- service-env-forge-access — give the daemon's service environment cargo + forge SSH access (the cargo/forge blocker)
- cargo-install-from-tag — rebuild + install the new binaries via
cargo installfrom the release tag - service-respawn-on-clean-exit — make the service manager respawn hephd after a clean exit (systemd
Restart=always) - self-restart-after-update — exit cleanly after a successful install so the new binary takes over
- verify-hub-dropout-resilience — lock in "the hub can vanish at any moment" as the base case