730c923a97
The deletion PR removed the types but left ~10 sites still describing
them. Two are real breakage rather than staleness: rustdoc intra-doc
links to deleted items ([NodeView::kind] and [Self::snapshot] in
job_queue/mod.rs). Neither clippy --all-targets -D warnings nor cargo
test resolves intra-doc links, so the tree was green with both already
dangling.
The rest reassert facts the deletion made false: docs/coordinator.md
documented the event as RebuildQueueChanged { seq, queue: [DagView...] }
with a per-node field list, and three sites pointed at the removed
/api/state.rebuild_queue endpoint.
One is pointer rot rather than a rename, and no grep for a deleted name
finds it: SchedulesChanged justified itself as "same snapshot-shape
rationale as RebuildQueueChanged" -- which the deletion turned into the
one event that is not a snapshot. Repointed at TombstonesChanged /
MetaInputsChanged, in both the Rust doc and the dashboard doc.
Two are pre-existing and strictly out of scope, swept under the
pfadfinderregel because the same grep surfaced them: hive-sh4re/README
advertised a jobs module that crate has not had since the host-sock
split, and hive-host-sock/README claimed its own payload types live in
hive-sh4re.
Docs and comments only -- no behaviour, no API, no test changes.
32 lines
1.3 KiB
Markdown
32 lines
1.3 KiB
Markdown
# hive-sh4re
|
|
|
|
The **shared payload vocabulary** between `hive-c0re` and the in-container
|
|
harness — the common types (`Message`, `Approval`, `LooseEnd`, `HelperEvent`, …)
|
|
that the per-socket wire protocols are built from. The request/response
|
|
*envelopes* themselves now live in the per-socket crates (below); this crate
|
|
holds the payloads they carry.
|
|
|
|
## Where it sits
|
|
|
|
This is the shared payload crate; the per-socket *protocol envelopes* have been
|
|
split into their own smaller crates so specialised binaries don't have to pull
|
|
in all of `hive-sh4re`:
|
|
|
|
- `hive-host-sock` — host admin socket (`hivectl` ↔ `hive-c0re`)
|
|
- `hive-core-agent-sock` — per-agent/manager socket (`/run/hive/mcp.sock`)
|
|
- `hive-priv-sock` — the privileged-helper socket
|
|
|
|
Those crates re-export or reference the payload types that still live here
|
|
(`Approval`, `Message`, `LooseEnd`, …).
|
|
|
|
## Modules
|
|
|
|
- **`wire_time`** — the timestamp convention: wire fields are
|
|
`chrono::DateTime<Utc>` (serialized RFC 3339), while sqlite storage + input
|
|
args stay unix-epoch `i64`; this module owns the two boundary conversions.
|
|
- **`paths`** — well-known on-disk path helpers.
|
|
- **`assets`** — resolves bundled runtime asset paths (branding, prompts) under
|
|
`HIVE_ASSETS_DIR`.
|
|
|
|
Agent-name fields are typed as `hive_types::Ident` for serde-validated parsing at
|
|
the socket boundary.
|