Imenik odločitev o poimenovanju

← kazalo

Živa evidenca preimenovanj, ki so jih pognale presežene predpostavke, da je

prihodnji odmik preverljiv proti enemu seznamu. "Dostavljeno" pomeni združeno

v main; preveri proti povezani kodi, preden zaupaš vrstici.

Načelo poimenovanja — privzeto nevtralno glede na opremo

Poimenuj stvar po tem, kar je, ne po opremi, ki je trenutno privzeta:

samodejni zagon, "agent") → nevtralno ime. Oprema je _nastavljiva

vrednost_ (npr. COLIBRI_AUTOSPAWN_BINARY=zot), nikoli zapečena v ime in

vedno preglasljiva s strani operaterja.

opreme sodi vanjo, vzporednice pa ostanejo simetrične (zot_event_type ↔

pi_event_type, AgentRuntime::{Zot, Pi}), tako da nobena ni

privilegirana.

Vrstice pi_* v Dostavljeno so svarilna zgodba: nevtralni

koncepti, napačno poimenovani po opremi. Enako velja za dokumentacijo —

referenca na opremo je nevtralna (AGENT-EVENTS-REFERENCE), ne ZOT-…, razen

če resnično gre samo za eno opremo.

Dostavljeno

| Staro → Novo | Zakaj | Sidro |

| ------------------------------------------------ | ----------------------------------------------------------------------------------------- | ---------------------------------------------- |

| COLIBRI_AUTOSPAWN_PI → COLIBRI_AUTOSPAWN | Nevtralno glede na opremo (privzeti agent je zot, ne pi) | crates/colibri-daemon/src/socket.rs |

| COLIBRI_PI_BINARY → COLIBRI_AUTOSPAWN_BINARY | enako | socket.rs (autospawn_agent_if_configured) |

| pi_session_id → session_id | zot agenti imajo tudi ID-je sej; #[serde(alias)] ohranja povratno združljivost | crates/colibri-glasspane/src/lib.rs (Pane) |

| sample-pi-agent.py | Preimenovano iz podedovanega imena testnega agenta; oddaja konzerviran _sample_ | scripts/sample-pi-agent.py |

| nelokalni privzeti spawn hermes-agent → zot | hermes-agent je bil neobstoječ ostanek binarne datoteke | socket.rs (default_agent_args) |

| usb_nodes → hive_nodes | vozlišče je vsak gostitelj, ki se je pridružil hive, ne samo USB zagon (+node_type) | packaging/mother/mother_schema.sql |

| pi_type → event_type | notranje ime za normalizirano vrsto dogodka; nevtralno glede na opremo (ni serializirano) | crates/colibri-glasspane/src/lib.rs |

V teku

_Trenutno nobeno._

Znani ostanek (še ni ukrepan)

| Predmet | Opomba |

| ------------------------------------ | ------------------------------------------------------------------------------------------------- |

| ADR-agent-harness-consolidation.md | Omenjen, vendar ne obstaja; AGENTS.md je pravo sidro. Glej agent-harness. |

Strukturne odločitve

| Odločitev | Zakaj / nauk | Sidro |

| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |

| En sam dom za matično infrastrukturo = colibri | Matični MCP skripti so bili kopirani v oba colibri in clawdie-iso; kopija iso je odnesla v SQL-injectable node-register-mcp na main. Ista skripta v dveh repozitorijih odnese — lint prehod bi moral označiti medrepozitorijske dvojnike. | colibri packaging/mother/; odstranitev iso v iso PR #129 |

| FEATURE_COLIBRI je notranja, ni uporabniško vidna | colibri je privzeto vključen; FEATURE_COLIBRI=NO je izhod v sili ob gradnji (npr. brez prevzema colibri). README pojasnjen. | clawdie-iso #130 |

| clawdie-gui je stabilen operaterski ukaz | clawdie-startx ohranjen kot vzdevek za povratno združljivost (oba nameščena); dokumentacija uči clawdie-gui. Preverjeno namerno, ne odmik. | clawdie-iso/README.md §clawdie-gui; clawdie-iso/build.sh |

Glej tudi