vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

hive-ag3nt + docs: extract identity prose (#716 batch 1)

Browse source
This commit is contained in:
iris 2026-05-31 16:36:20 +02:00 • committed by mara
commit 2bb8f2a3f7
2 changed files with 53 additions and 40 deletions
Download patch file Download diff file Expand all files Collapse all files

55
hive-ag3nt/src/identity.rs
View file

@ -1,32 +1,7 @@
//! Agent identity helpers — short label + hive-qualified long name +
//! human display names for the hive and swarm.
//!
//! `HIVE_LABEL` is the short, hive-local agent name (e.g. `iris`, `damocles`).
//! `HYPERHIVE_HIVE_DOMAIN` is the hive's canonical DNS domain (e.g.
//! `darkest.space`). When the hive-domain env var is set (set by the
//! `hive-c0re.nix` module from `hyperhive.domain`), the qualified label is
//! `${label}@${domain}` — e.g. `iris@darkest.space`. When unset (single-hive
//! deployments, dev/test scenarios) the qualified label degrades to just the
//! short label so existing callers see no change.
//!
//! Per #589 v0: this qualified form surfaces in the per-agent web UI title,
//! the system prompt template, and `/api/state.qualified_label`. Broker
//! `from` / `to` qualification + dashboard rendering of cross-hive
//! identities are subsequent follow-ups inside #589.
//!
//! `HYPERHIVE_HIVE_NAME` + `HYPERHIVE_SWARM_NAME` are human-readable
//! display names for the local hive (`pr1ma`) and the wider swarm
//! (`constellat1on`) — added in #701 after mara's
//! `internal-requests#9` ("we want to persist this name somewhere in
//! the hive"). They're **distinct** from the DNS domain above: the
//! domain may carry the hive name as its leftmost label by
//! convention, but the convention isn't machine-readable, and
//! federated hives at different DNS domains can share a swarm name.
//! Both reverse the earlier #589 spec decision (mara #6577 / iris
//! #6582 dropped `hyperhive.hiveName` in favour of "the domain IS the
//! name") — turns out humans want both: the address (`@darkest.space`)
//! AND the prose name (`pr1ma`). Matrix MXIDs still use the
//! domain-based convention untouched.
//! human display names for the hive and swarm. Full env var surface +
//! domain-vs-name distinction documented in
//! `docs/conventions.md::Hive identity (label + domain + display names)`.
use std::env;
@ -54,7 +29,7 @@ pub fn hive_domain() -> Option<String> {
/// this is the prose label humans use in conversation. Returns None
/// when the host-side `services.hyperhive.hiveName` option is unset,
/// in which case callers fall back to the domain or the short label
/// at their discretion (#701).
/// at their discretion.
#[must_use]
pub fn hive_name() -> Option<String> {
env::var("HYPERHIVE_HIVE_NAME")
@ -65,7 +40,7 @@ pub fn hive_name() -> Option<String> {
/// Human display name of the wider swarm this hive belongs to (e.g.
/// `constellat1on`). Federated hives at different DNS domains can
/// share a swarm name. Returns None when the host-side
/// `services.hyperhive.swarmName` option is unset (#701).
/// `services.hyperhive.swarmName` option is unset.
#[must_use]
pub fn swarm_name() -> Option<String> {
env::var("HYPERHIVE_SWARM_NAME")
@ -100,12 +75,12 @@ mod tests {
use super::*;
use std::sync::Mutex;
/// Per damocles's #595 review: cargo's test runner parallelises by
/// default, so a `with_env` helper that mutates process-wide env vars
/// races between tests in this module. Serialise on a module-scope
/// mutex so each `with_env` call holds the lock for its set / run /
/// restore window. Cheap (each test body is microseconds) and avoids
/// pulling in `serial_test` for just one module.
/// cargo's test runner parallelises by default, so a `with_env`
/// helper that mutates process-wide env vars races between tests in
/// this module. Serialise on a module-scope mutex so each `with_env`
/// call holds the lock for its set / run / restore window. Cheap
/// (each test body is microseconds) and avoids pulling in
/// `serial_test` for just one module.
static ENV_LOCK: Mutex<()> = Mutex::new(());
/// Helper: run `f` with a clean env, restoring previous values on exit.
@ -118,9 +93,9 @@ mod tests {
with_full_env(label, domain, None, None, f);
}
/// Extended form of [`with_env`] covering the #701 display-name env
/// vars (hive name + swarm name) alongside label + domain. Same
/// SAFETY contract — serialised on `ENV_LOCK`, restore in scope.
/// Extended form of [`with_env`] covering the display-name env vars
/// (hive name + swarm name) alongside label + domain. Same SAFETY
/// contract — serialised on `ENV_LOCK`, restore in scope.
fn with_full_env<F: FnOnce()>(
label: Option<&str>,
domain: Option<&str>,
@ -260,7 +235,7 @@ mod tests {
fn name_accessors_independent_from_domain() {
// hive_name + swarm_name surface without HYPERHIVE_HIVE_DOMAIN
// being set — the names are display labels, not derived from
// the DNS domain (#701, mara on internal-requests#9).
// the DNS domain.
with_full_env(
Some("iris"),
None,