Watch
0
0
Fork
You've already forked hyperhive
0
hyperhive/hive-types/README.md
atlas 463c5cbfcc share the standing-review rule between hive-forge and the controller
pr assign-reviewer behaves as before; the latest-review fold and the
superseded check move to hive-types::review.
2026-10-24 17:23:28 +02:00

1.4 KiB

hive-types

Foundational shared newtypes for the hyperhive workspace. A zero-dependency (bar serde) leaf crate, so every wire-type crate (hive-sh4re, hive-host-sock, hive-core-agent-sock) and both binaries (hive-c0re, hivectl) can share them without cross-crate coupling and without growing hive-sh4re.

What's here

  • Permission — the set of named permissions an agent may hold, with its stored snake_case names and the MCP and built-in tools each grants.
  • Ident — a validated agent-name newtype. Typing agent-name fields as Ident (rather than bare String) gets serde-validated parsing at the socket boundary for free: a malformed name is rejected at deserialize time instead of flowing into a handler that has to re-validate by hand.
  • term_msg — the icons and summary prefixes of a terminal row that sent a message or started a turn from one, and the parsers that read the recipient or sender back out.
  • review — which of a PR's reviews still stand (latest verdict per reviewer, stale or dismissed ones superseded). hive-forge pr assign-reviewer and the notification router's request-reviewer sink share it, so both skip a request on the same grounds.

The crate is deliberately a leaf with the smallest possible dependency footprint so anything in the workspace can depend on it. See docs/process/conventions.md ("identity = socket") for how agent identity is modelled across the sockets.