hephaestus/docs
Erich Blume ed8c7a733a
Some checks failed
Build / validate (pull_request) Failing after 3s
hephd local mode: file lock + JSON-RPC over unix socket
Slice 6 (tech-spec §3, §6, §10). First async component — the per-device
daemon in local mode.

- `LockGuard`: exclusive advisory flock on a sidecar `<db>.lock`; a second
  acquire fails and releases on drop (the §3.1 lock handoff).
- JSON-RPC (line-delimited): `rpc::dispatch` maps node/task/next/links/log
  methods onto the heph-core Store; `Daemon::serve` accepts unix-socket
  connections and runs dispatch on tokio's blocking pool behind an
  Arc<Mutex<LocalStore>> (DB never touches an async worker).
- Synchronous `Client` for surfaces/CLI; `hephd` binary (clap) opens the
  store under lock and serves the default socket.
- heph-core model/ranking types are now serde-(de)serializable; added
  node.tombstone + Store::tombstone_node.

Tests: 2 lock unit tests + 5 real-socket e2e (round-trip with clock
injection, next, error paths, recurring roll-forward over RPC, 8-client
concurrency). 60 tests green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-05-31 20:28:15 -07:00
..
changelog.d hephd local mode: file lock + JSON-RPC over unix socket 2026-05-31 20:28:15 -07:00
explanation Fold second-pass design review into v1 spec 2026-05-31 18:08:47 -07:00
how-to Initial commit 2026-05-31 06:13:36 -07:00
reference Fold second-pass design review into v1 spec 2026-05-31 18:08:47 -07:00
tutorials Set up hephaestus from template and add design + tech spec 2026-05-31 09:37:28 -07:00
index.md Initial commit 2026-05-31 06:13:36 -07:00
quartz.config.ts Set up hephaestus from template and add design + tech spec 2026-05-31 09:37:28 -07:00
quartz.layout.ts Initial commit 2026-05-31 06:13:36 -07:00