clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 33
colibri/docs/wiki/naming-decisions.md
Sam & Claude 7bc9483156
Some checks failed
CI / rust (pull_request) Has been cancelled
Details
CI / markdown (pull_request) Has been cancelled
Details
CI / port (pull_request) Has been cancelled
Details
CI / agent-jail-pkgs (pull_request) Has been cancelled
Details
refactor(glasspane): pi_type → event_type; close out wiki residue 
Residue item #1: rename the pi-era `pi_type` field/param to `event_type` in
colibri-glasspane. It names the normalized event-type string (zot events map
onto the same taxonomy), so the harness-neutral name is correct. Internal only
— PiStreamUpdate is not serialized — so no wire impact.

Wiki ledger updated:
- pi_type → event_type added to Shipped (now enforced by wiki-lint).
- Residue items resolved and recorded under Structural decisions:
  - FEATURE_COLIBRI is an internal build-time escape hatch, not a user-facing
    flag — README clarified (clawdie-iso #130).
  - clawdie-gui is the stable operator command; clawdie-startx retained as a
    back-compat alias (both installed) — verified intentional, not drift.
- Known residue now down to the dangling ADR reference only.

Verified: ci-checks.sh green (fmt/clippy/test/markdown); wiki-lint --strict clean.
2026-06-24 10:44:15 +02:00

4.2 KiB
Raw Blame History

Naming decisions ledger

← index

A living record of renames driven by superseded assumptions, so future drift is checkable against one list. "Shipped" means merged to main; verify against the linked code before trusting a row.

Shipped

Old → New Why Anchor
COLIBRI_AUTOSPAWN_PI → COLIBRI_AUTOSPAWN Harness-neutral (default agent is zot, not pi) crates/colibri-daemon/src/socket.rs
COLIBRI_PI_BINARY → COLIBRI_AUTOSPAWN_BINARY same socket.rs (autospawn_agent_if_configured)
pi_session_id → session_id zot agents have session ids too; #[serde(alias)] keeps back-compat crates/colibri-glasspane/src/lib.rs (Pane)
fake-pi-agent.py → sample-pi-agent.py "fake" too loaded; it emits a canned sample scripts/sample-pi-agent.py
non-local spawn default hermes-agent → zot hermes-agent was a nonexistent leftover binary socket.rs (default_agent_args)
usb_nodes → hive_nodes a node is any host that joined the hive, not only a USB boot (+node_type); #161 packaging/mother/mother_schema.sql
pi_type → event_type internal name for the normalized event type; harness-neutral (not serialized) crates/colibri-glasspane/src/lib.rs

In-flight

None currently.

Known residue (not yet actioned)

Item Note
ADR-agent-harness-consolidation.md Referenced but does not exist; AGENTS.md is the real anchor. See agent-harness.

Structural decisions

Decision Why / lesson Anchor
Single home for mother infra = colibri The mother MCP scripts were copied into both colibri and clawdie-iso; the iso copy drifted to an SQL-injectable node-register-mcp on main. Same script in two repos drifts — a lint pass should flag cross-repo duplicates. colibri packaging/mother/; iso removal in iso PR #129
FEATURE_COLIBRI is internal, not user-facing colibri is staged by default; FEATURE_COLIBRI=NO is a build-time escape hatch (e.g. no colibri checkout). README clarified. clawdie-iso #130
clawdie-gui is the stable operator command clawdie-startx retained as a back-compat alias (both installed); docs teach clawdie-gui. Verified intentional, not drift. clawdie-iso/README.md §clawdie-gui; clawdie-iso/build.sh

See also