Merge pull request 'Body map after C1: the persona door and the fence are live' (#78) from modeling/body-map-after-c1 into main

This commit is contained in:
Eureka 2026-11-19 22:40:08 +00:00
commit f20a1533c8
3 changed files with 36 additions and 16 deletions

View file

@ -105,19 +105,29 @@ the mission organ and every Persona-side Mind write. New section "The persona-on
"Superseded by C2" marker; facts F1-F40 and the specs they cite keep their tense. C1 (persona door, PR #74 and
gamecult-ops PR #126) and C3a (Projector, PR #76) are pending, not live.
## The persona-only body (after C2, Huginn `66b85c8`)
Revised 2026-11-19 by Modeling (session `modeling-body-map-after-c1`) at Huginn `57b931f`, after C1 (the persona door,
Huginn #74) and gamecult-ops `ecff184` (PR 126) were deployed on Yggdrasil, with the deploy's host checks as evidence.
Eureka's daemon is now `huginn@eureka`; `huginn.service` is gone. The section below is retitled, its C1-pending
markers are replaced by the live door and fence, and "What touches the Mind now" and the "Pending" list are rewritten.
Rows of the older body that name `huginn.service` or an unfenced Persona carry a "Superseded by C1" marker. C3a (PR #76,
in rework), C3b, C3c, C4, C5 and C6 are pending, not live. The swarm brake is still held.
Modeling, 2026-11-19. Read from source at `66b85c8` (merge of PR #75, cut C2 "cut the mission organ and every Persona-side Mind write"). Design source: Huginn `docs/persona-only-heartbeat-map.md` at `d861574` (Imagination's heartbeat map; read it with `git show d861574:docs/persona-only-heartbeat-map.md`). Governing rulings, admitted 2026-11-19: `eureka-body:ruling:persona-only-heartbeat` (the Persona reads her Mind and never writes it; her own memories live in her persona state), `persona-only-interpreter-agentic`, `persona-only-deltas-from-trace`, `persona-only-divergence-parked` and `persona-only-state-writers-self-and-life`.
## The persona-only body (after C2 and C1, Huginn `57b931f`)
This section is the current map of the Persona, heartbeat, Self-run and Mind-write rows. Where an older row, section or fact below disagrees with it, this section wins; those rows carry a "Superseded by C2" marker and keep their history. The deployed state of `66b85c8` on Yggdrasil was not probed in this pass. The last deploy the design map names is `ecf147d`.
Modeling, 2026-11-19. Source read at `66b85c8` (C2) and again at `57b931f` (C1 added). Deployed facts come from the deploy's host checks (Huginn `57b931f` at `/opt/gamecult/huginn/current` on Yggdrasil, gamecult-ops `ecff184`, about 22:40 UTC); this pass did not itself probe the host. C2 is the merge of PR #75, cut C2 "cut the mission organ and every Persona-side Mind write"). Design source: Huginn `docs/persona-only-heartbeat-map.md` at `d861574` (Imagination's heartbeat map; read it with `git show d861574:docs/persona-only-heartbeat-map.md`). Governing rulings, admitted 2026-11-19: `eureka-body:ruling:persona-only-heartbeat` (the Persona reads her Mind and never writes it; her own memories live in her persona state), `persona-only-interpreter-agentic`, `persona-only-deltas-from-trace`, `persona-only-divergence-parked` and `persona-only-state-writers-self-and-life`.
This section is the current map of the Persona, heartbeat, Self-run and Mind-write rows. Where an older row, section or fact below disagrees with it, this section wins; those rows carry a "Superseded by C2" marker and keep their history. Release `57b931f` is live and holds C1 and C2. The installer refuses any release that lacks both: it probes the daemon for `--persona-bind` and the heartbeat for the `HEARTBEAT_BEAT_S` marker.
### The invariant, and what enforces it today
Nothing that acts for a Persona writes her Mind. At `66b85c8` that holds by absence of callers, not by type:
Nothing that acts for a Persona writes her Mind. Since C1 the host enforces that at the door as well as by absence of callers:
- `persona::carry` reads the instance and swarm brakes once and returns `Dead(reason)` or `NoOrgan`. It holds no Mind client, no chat client and no trace writer. The binary `mind-persona` parses the persona flags (`--rooms`, `--operator`, `--minds`, `--self-sender`, and `MIND_PERSONA_*` from `persona.env`), reads the brakes, prints `dead: ...` or `no organ: ...` and exits 0 (2 on bad arguments). It makes no call to the daemon.
- `heartbeat::poll` starts a unit and nothing else. Its only Mind read is `stewardships_of`: one in-force `Stewardship` query per Persona, made only when she has pending chat, to learn the names her projects go by.
- Seam, not yet structural: `MindPort` (`crates/mind-body/src/queue.rs`) still carries `admit`, and each heartbeat `Seat` holds a `&dyn MindPort`. The only non-test caller of `admit` in `mind-body` is `self_run`. "The heartbeat cannot admit" is true of the code and false of the type. The structural cut is C1 (below); until then the test `no_poll_admits_anything_to_any_mind_whatever_it_wakes` is the check.
- **The persona door (C1, live).** Each Mind daemon (`huginn@<i>`, Eureka's included) binds two RUDP listeners: the full door (`--bind`, `10.77.0.1:1787x`) and the persona door (`--persona-bind`, port + 1000, `10.77.0.1:1887x`; it must differ from `--bind`). `Daemon::handle_at(Door, request, now)` checks `HuginnMindRequest::reaches_persona_door` before the Mind is asked. That match has no wildcard, so a new request kind does not compile until classified. The persona door answers `Whoami`, `View`, `Query`, `SearchSources`, `SearchChat`, `ChatWindow`, `StewardedActivity`, `RootsTouched`, `PersonaGet` and `PersonaPut`, and refuses `Admit` with `MindRefusal::NotThisDoor`. Source: `crates/huginn-daemon/src/daemon.rs` (`Door`, `handle_at`), `crates/huginn-mind/src/wire.rs`, `serve.rs` (the second `bind`).
- **The fence (live).** `mind-fence` (nft table `inet mind_fence`) lets a Persona uid reach only its own persona door, plus TCP to the connector at `127.0.0.1:4110`. The heartbeat uid (984) is rejected at every full door, and `mind-heartbeat.service` has `Requires=` and `After=` on `mind-fence.service`, so the heartbeat cannot start unfenced. A Persona therefore cannot `Admit` to any Mind, her own included: the open reach recorded under F38 (a Persona shell running `huginn admit` against her own full door) is closed on the host, not by process discipline. Which endpoint the heartbeat's `stewardships_of` read names was not read in this pass (the unit's environment is gamecult-ops'); the full door is closed to its uid, so it can only be a persona door.
- Seam still open in the type: `MindPort` (`crates/mind-body/src/queue.rs`) still carries `admit`, and each heartbeat `Seat` holds a `&dyn MindPort`. The only non-test caller of `admit` in `mind-body` is `self_run`. C1 made the refusal structural at the wire and the host, not at the trait; the test `no_poll_admits_anything_to_any_mind_whatever_it_wakes` still checks the heartbeat code.
- **Self runs.** polkit grants no one a start of `mind-self@`. Nothing launches it; the return path is the Huginn tag `parked/self-run-launch`. The older note that Self runs are unfenced stays true of the fence (it keys on Persona uids) and is moot while no run starts.
### Organs
@ -126,7 +136,7 @@ Nothing that acts for a Persona writes her Mind. At `66b85c8` that holds by abse
| Persona organ (`mind-persona@<i>`; `crates/mind-body/src/persona.rs`, `src/bin/mind-persona.rs`) | Huginn `mind-body`. Inert: no turn until the three-stage turn (Projector, Persona, Interpreter) lands (C3). | `persona.env` flags; the instance brake and the swarm brake (`control::derive`), read once per start. | One stdout line (`dead` or `no organ`) and an exit status. No Mind write, no persona-state write, no chat, no trace. | None. `Outcome` is `Dead(HeldReason)` or `NoOrgan`. | Everything. It has no write path. | Brake stores `/etc/gamecult/minds/<i>/control.cc` and `swarm.cc`, read only. | C2 deleted the session driver, the reply schema, `act`, the run opener and every admit (parked at `parked/self-run-launch`). It kept `Config`, `sender_role`, `addressees`, `addressing_of`, `render_tail` and `FileTrace` for C3; each unused item carries an `allow(dead_code)` that its first caller removes. | `persona/tests.rs` (`a_held_brake_is_dead_and_a_released_one_has_no_organ`); `tests/persona_bin.rs` (a unit configured from its environment ends dead; a missing or wrong setting ends 2 naming the setting, never the value); `tests/public_surface.txt`. |
| Heartbeat (`mind-heartbeat.service`; `heartbeat.rs`, `tempo.rs`, `bin/mind-heartbeat.rs`) | Huginn `mind-body`. The one process deciding which Persona wakes and when. Sole writer of `heartbeat.cc`. | Swarm envelope and each Persona's brake (`read_effective`); each Persona's pending chat from Bifrost's mouth (`chat.pending`, read only, never acked, at most 16 pages); the unit table through `Launcher::alive`; `stewardships_of` on her Mind; `HEARTBEAT_PERSONAS`, `MIND_PERSONA_OPERATOR`, `HEARTBEAT_POLL_S` (20), `HEARTBEAT_BEAT_S` (1800), `BIFROST_CHAT_ENDPOINT`, `BIFROST_CHAT_KEY_FILE`, `STATE_DIRECTORY`. It holds no connector key. | `systemctl start mind-persona@<i>` through `SystemdLauncher`; `heartbeat.cc` (state, addressing table, poll traces). No run, no brief, no Self-run launch. | Off the beat: the operator, or another Mind of the roster, naming her wakes her once per message (`handled_mentions`, 64 kept). On the beat: when `beat_s` has passed since `last_beat_at`, `tempo::pick` over idle, released Minds by wait since the heartbeat last woke each, bent by a member addressing her. Busy is systemd's: an active unit is busy and a start is a no-op. | Her Mind (a Persona wake is a unit start); `heartbeat.cc` by anything but the heartbeat; the brakes. | `heartbeat.cc` under the unit's `STATE_DIRECTORY`, world-readable: Personas read the addressing table through `HeartbeatView`. `mind-heartbeat timeline` prints the latest poll. | C2 deleted the claimable-brief and Self-run branch, tempo votes and the PID fallback (`tally`, `fallback_beat`), the urgency pulse, `sleep.rs` (no night wake until C4) and `attachment.rs`. It kept `tempo::pick` and `score`. `vote_beat_s` in `InstanceTrace` is retired and always none, kept so old trace records decode. A `heartbeat.cc` holding an older document is refused by name and never migrated. | `heartbeat/tests.rs`: `a_mind_whose_self_holds_briefs_gets_a_persona_wake_and_no_self_run`, `no_poll_admits_anything_to_any_mind_whatever_it_wakes`, the mention and beat tests. |
| Self-run actuator (`mind-self@<i>`; `self_run.rs`, `bin/mind-self-run.rs`) | Huginn `mind-body`. Carries the one in-force Self run of its instance. | The run document (the grant), the lease socket, the Mind, the clock. | One `claude` child, its flush, its stop. | Request prefix, session id (UUIDv5 of the run id), kept transcript. | Nothing launches it. `launch::open_and_launch`, the work queue and the repetition breaker are gone (tag `parked/self-run-launch`). No organ opens a Self run, so `mind-self-run` with no open run exits 3. | The run slot in the Mind; `/var/lib/gamecult/minds/<i>/` state. | Left in place on purpose (C2 keep list): C3b's Interpreter reuses its spawn and sandbox and `lease_client`. `inbox` still reads briefs admitted by agent `mind-persona`; nothing admits them now. | `tests/self_run.rs` (ignored lane: the real binary against the real daemon with a fake `claude`); `self_run/tests.rs`. |
| Persona state (`gamecult.persona_state.v0`, one per mind, `personaId` = instance) | The Persona. No organ of Huginn writes it today. Target writers (ruling `persona-only-state-writers-self-and-life`): her commit step (C3c), and Self and Life on Starfire through `mind-persona edit`. | `PersonaGet`, `PersonaPut` on the daemon. | A receipt per put. | None stored. | The Projector, the Persona stage and the Interpreter never put. A raw `huginn persona put` is detected and recorded `unexplained`, not sanctioned. | The Mind store; the persona door once C1 lands. | `huginn-mind/src/persona.rs` keeps the document and its CAS. C2 removed the organ that was its only writer. | `huginn-mind` persona tests. The target's host negative check belongs to C1. |
| Persona state (`gamecult.persona_state.v0`, one per mind, `personaId` = instance) | The Persona. No organ of Huginn writes it today. Target writers (ruling `persona-only-state-writers-self-and-life`): her commit step (C3c), and Self and Life on Starfire through `mind-persona edit`. | `PersonaGet`, `PersonaPut` on the daemon. | A receipt per put. | None stored. | The Projector, the Persona stage and the Interpreter never put. A raw `huginn persona put` is detected and recorded `unexplained`, not sanctioned. | The Mind store; reached by `PersonaGet` and `PersonaPut` at the persona door (C1, live), the only listener a Persona uid can reach. | `huginn-mind/src/persona.rs` keeps the document and its CAS. C2 removed the organ that was its only writer. | `huginn-mind` persona tests; `serve.rs` tests that the persona door answers her persona and refuses `Admit`. |
| Persona turn trace (`eureka.persona.turn_trace.v1`, `FileTrace`) | The Persona organ, when C3 lands. | Nothing writes it today. | None. | None. | Any Mind writer; any model. | The unit's state directory. | Kept for C3c (trace v2 with `outside_put` and `tuning_changed`). Deltas are read from it over ssh (`persona-only-deltas-from-trace`). | `persona/tests.rs` `the_trace_store_keeps_each_turn_under_its_run_and_turn`. |
| Brake and the stop on hold | Operator. `mind-control brake hold` writes the brake, then stops the instance's units. | The operator's word. | `control.cc`; a blocking `systemctl stop`. | `read_effective` is the one reader. | Every organ of hers. | `/etc/gamecult/minds/<i>/`, `swarm.cc`. | `StopScope` still names three templates: `mind-self@`, `mind-persona@` and `mind-stream@`. The stream organ is parked; its unit name stays on the stop list so a host that still has it installed is stopped. | `tests/cli.rs` and the `launch.rs` stop tests (they spell `mind-stream@`). |
| Parked and deleted organs | Tags on the forge, not main. | n/a | n/a | n/a | Main must not regrow them without a ruling. | n/a | `parked/divergence-stream` holds `stream.rs` and `bin/mind-stream` (ruling `persona-only-divergence-parked`; return condition: measured narrations converge, judged by the eval of the design map's section 3.4; its Projector code is reused by C3a). `parked/self-run-launch` holds `open_and_launch`, the work queue and its breaker (a future spend owner may restore Self runs on address). `sleep.rs` and `attachment.rs` are deleted, not parked: consolidation returns in C4 as a retarget onto `thoughtMemory`. | The C2 negative greps: `start_self_run`, `WORK_QUESTION`, `WAKE_ASK`, `TURN_INSTRUCTION`, `Pulse`, `tempo_vote` absent from `crates/mind-body/src`. |
@ -135,15 +145,22 @@ Nothing that acts for a Persona writes her Mind. At `66b85c8` that holds by abse
| Process | Reads | Writes |
|---|---|---|
| `mind-persona` | nothing | nothing |
| `mind-heartbeat` | `Stewardship` documents of each Persona with pending chat | nothing |
| `mind-persona` | nothing (when C3 lands, only through its persona door) | nothing |
| `mind-heartbeat` | `Stewardship` documents of each Persona with pending chat; it cannot reach any full door | nothing |
| `mind-self-run` | its run, briefs, the Mind | what a Self session admits (unchanged); nothing starts one |
| Self on Starfire | all | the Mind, and persona state through `mind-persona edit` (target; the subcommand is C3c) |
| Self on Starfire | all, through the full door | the Mind, and persona state through `mind-persona edit` (target; the subcommand is C3c) |
| Any Persona uid | at its own persona door: reads and her persona | her own persona state (`PersonaPut`); `Admit` is refused `NotThisDoor` |
### Deployed shape (Yggdrasil, 2026-11-19 ~22:40 UTC)
- `/opt/gamecult/huginn/current` is release `57b931f`; gamecult-ops `ecff184` is installed.
- One daemon template for every Mind: `huginn@<i>`. Eureka's is `huginn@eureka`. `huginn.service` no longer exists; her journal is `journalctl -u huginn@eureka`. Anything that reads or restarts the old unit name is stale.
- Each daemon has two listeners: the full door and the persona door at port + 1000. Eureka's are `10.77.0.1:17872` and, by the rule, `10.77.0.1:18872`; the host check stated the rule, not each Mind's port.
- The swarm brake is held. `mind-self@` has no start path.
### Pending, not live
- **C1, the persona door** (Huginn PR #74 and gamecult-ops PR #126, not merged). Target per the design map: a read-and-own-persona-only listener at the huginn port + 1000 that refuses `Admit`, and an nft fence change that routes Persona uids only to it. Until both merge and deploy, the Persona uid's route to the full door is unchanged. Do not read C1 as live.
- **C3a, the Projector** (Huginn PR #76, not merged). Select stage, Projector, `persona-tuning.toml` and `mind-persona project`. Until it merges, `mind-persona` has no `project` subcommand.
- **C3a, the Projector** (Huginn PR #76, in rework, not merged). Select stage, Projector, `persona-tuning.toml` and `mind-persona project`. Until it merges, `mind-persona` has no `project` subcommand.
- **C3b, C3c, C4, C5, C6** are follow-ups in the design map: the Persona stage and Interpreter; the commit and `edit`; reflection and consolidation; the delta reader `mind-persona since`; identity diff posting. Nothing in main implements them.
### Stale surfaces found in this pass
@ -152,6 +169,7 @@ Fixed here:
- `docs/eureka-body-map.md`: the rows and sections marked "Superseded by C2" (the model page, the units table, the Persona session section and its table, the tempo controller row, and the sections on the live-run decider, the breaker and the Self run). Markers are prefixes; the old text under them was not rewritten.
- `docs/swarm-revival-target.md`: status banner added.
- C1 pass: `docs/swarm-revival-target.md` banner extended; `docs/eureka-self-cut.md` unit name annotated (its dated plan otherwise stands); F4, F36, F38 and the fence row of this map marked superseded. `docs/history/` and `docs/research/` name `huginn.service` as evidence and are not edited.
- `crates/mind-body/README.md`: the heartbeat paragraph described voted tempo, declared urgency and an immediate launch, and the intro omitted the Persona organ.
- `README.md` (repo root): the layout line named `mind-heartbeat` timeline as `mind-body`'s only organ; it now names the live organs.
@ -200,7 +218,7 @@ Each line: what was run, where, result.
`CARGO_MANIFEST_DIR/../schemas/cultnet` at lib.rs:2725). `schemas/cultnet/` holds
13 `epiphany.pipeline.*.v2` schemas, `epiphany.work_organ_state.v0`,
`gamecult.persona_state.v0`, `index.json`, README; `schemas/README.md`.
- **F4 Mind deployment.** `ssh yggdrasil`: `huginn.service` active, ExecStart
- **F4 Mind deployment.** *(Superseded by C1: Eureka's daemon is `huginn@eureka` since 2026-11-19 and `huginn.service` is gone; each daemon also binds a persona door at port + 1000. Tense below is 2026-10-08.)* `ssh yggdrasil`: `huginn.service` active, ExecStart
`/opt/gamecult/huginn/current/huginn-daemon --state-root /var/lib/gamecult/huginn
--instance eureka --bind 10.77.0.1:17872 ...`; `current ->
releases/107552dc...` (Huginn merge of huginn-admission-rules; on 2026-10-08 main added docs only, and since then main has moved code: see F17).
@ -567,9 +585,9 @@ Each line: what was run, where, result.
`{}` still bills the reservation until follow-up `claude-backend-hardening` lands). Follow-ups
`handle-unauthenticated`, `pin-checked-only-at-ready`.
- **F36-F40 (Modeling, 2026-11-02, Yggdrasil read-only).**
F36 `ssh yggdrasil` 2026-11-02: units active: `mind-fence`, `mind-heartbeat`, `mind-persona@{eureka,kiko,nibu,void,weksa}`, `mind-self@{eureka,heimdall,kiko,void}`, `huginn.service` (eureka) and `huginn@{aqua,heimdall,kiko,libby,nibu,void,weksa}`. Deploy `/opt/gamecult/huginn/current` -> `releases/ffd4136a35355587a1a6d04c3cc42d8fabc31e86` = Huginn main head.
F36 `ssh yggdrasil` 2026-11-02: units active: `mind-fence`, `mind-heartbeat`, `mind-persona@{eureka,kiko,nibu,void,weksa}`, `mind-self@{eureka,heimdall,kiko,void}`, `huginn.service` (eureka; *superseded by C1: now `huginn@eureka`*) and `huginn@{aqua,heimdall,kiko,libby,nibu,void,weksa}`. Deploy `/opt/gamecult/huginn/current` -> `releases/ffd4136a35355587a1a6d04c3cc42d8fabc31e86` = Huginn main head.
F37 `systemctl cat mind-persona@.service`: `Requires/After=mind-fence.service`, `User=mind-%i`, `RuntimeMaxSec=4h`, `Restart=no`, `KillMode=control-group`, `ProtectSystem=strict`, seed `persona-seed`.
F38 `nft list table inet mind_fence`: 8 persona uids, 8 uid.port huginn pairs (17872-17879), chain `persona` with reject rules.
F38 `nft list table inet mind_fence`: 8 persona uids, 8 uid.port huginn pairs (17872-17879), chain `persona` with reject rules. *(Superseded by C1: persona uids now reach only their own persona door at port + 1000, plus the connector at `127.0.0.1:4110`; the heartbeat uid 984 is rejected at every full door.)*
F39 `/opt/commons` modes as in the Persona session section; `id mind-eureka` shows no `mind-commons`; `systemctl cat mind-self@.service` shows `SupplementaryGroups=claude-lease mind-commons`, `ReadWritePaths=/opt/commons`.
F40 `grep pombabranca /etc/nginx/sites-enabled/*`: no match; `/site` and `/site/` locations present in `yggdrasil.gamecult.org.conf` (lines 50, 54). Retired `/pombabranca` (7586a3f). A pre-ghostlight backup `sites-available/yggdrasil.gamecult.org.conf.before-ghostlight-*` still names `/pombabranca` but is not enabled.
@ -927,7 +945,7 @@ Ruling `eureka-body:ruling:persona-session-landed` (landed; deployed 2026-11-01
|---|---|---|---|---|---|---|---|---|
| Persona organ (`mind-persona`, Huginn `crates/mind-body/src/persona.rs` `carry`) | **Superseded by C2 (Huginn `66b85c8`; see "The persona-only body").** Replaced by the first row of "The persona-only body": the organ is inert. Huginn. One start of `mind-persona@<i>` adopts the PersonaTurn run the heartbeat opened (none held = `NoRun`, nothing started); it opens no run itself. | Brakes (instance and swarm, read once per process); mouth deliveries (`chat_rudp`, polled every `PERSONA_POLL_S`=5 s while live); her mind (persona state, campaigns in force, responsibilities, recall); `MIND_PERSONA_DOCTRINE` files; plan windows from the lease | Per result: `say` sent through the mouth, `remember` admitted as memories, `settle` resolutions, her `Pulse` vote, `start_self_run` follow-up + `open_and_launch`; then the ack. Closes its run once (`close_run`). | `Progress {acked, turn, answered, last_intent, failure, self_run, refused}` lives in the start, across the session's processes. The mouth's pending deliveries are the truth for "unanswered". | The organ writes no brake and no persona state. A session's text is never scanned: only a decoded `PersonaReply` acts (`decode_reply`). Nothing acks that was not answered; no ack passes an unanswered delivery below the answered seq or a refused batch (PersonaInbox::result owns the ack decision, 0f19eec, Soul s3). | Mouth, mind, lease socket; none shared with the Self | One conversation per process (public rooms together, or one DM room); the next conversation starts a new process in the same start until nothing is pending or `ROTATE_MARGIN_S` before the cap | `crates/mind-body/src/persona/tests.rs`; Soul verdicts s1-s3 on the cut; live units active |
| The session process | **Superseded by C2 (Huginn `66b85c8`; see "The persona-only body").** Deleted with the Persona session. `claude` child via `ClaudeSpawner::in_sandbox`, driven by `self_run::session::drive` (the Self's own driver and `decide`). The actuator owns lifetime and everything entering it. | One framed stdin line per batch; system prompt file (`persona-instructions.md` in the unit's runtime scratch: doctrine + persona state + campaigns, read once per process, so a persona-state change reaches a live session only at its next process) | stream-json results, each constrained by `--json-schema` to `PersonaReply` (`intent` first and required) | Session id = uuid5 of run id + `:p<process>`; no resume, no continue, no fork (`persona_args`). The transcript is a cache; the mind is the truth. | Her tools write nothing in the world except through the decoded reply and the sandbox | `/var/lib/mind-<i>/sandbox` (rw), `<scratch>/claude-config` (rw, fresh from `persona-seed` each process), scratch otherwise ro (aab25a5) | The gate is the bwrap argv (`sandbox_args`, ro-bind `/`, tmpfs `/tmp` `/run` `/etc/gamecult` `/var/lib`, private pid table, `--die-with-parent`, shared network) | Probe `scripts/probe-persona-sandbox-under-systemd.sh`; sandbox tests |
| Mind fence (`mind-fence.service`, ruleset `/etc/gamecult/minds/fence.nft`, table `inet mind_fence`) | gamecult-ops. The one boundary on what her session reaches on the host, keyed on uid, so it binds the organ and the sandbox alike. | Rendered by the installer from every installed Persona drop-in | nft output chain: persona uids may reach their own huginn address:port, the mouth (127.0.0.1:17884), the host's public 80/443 and the internet; every other local/private address, loopback services, WireGuard peers, other Minds' huginn, and all broadcast/multicast are rejected | Live: `persona_uids` set of 8 uids, `huginn` set of 8 uid.port pairs | Nobody stops it to open anything: it has no `ExecStop`. `/etc/nftables.conf` begins with `flush ruleset`; a flush leaves the unit "active" over an empty fence, so every Persona start reloads it (`ExecStartPre=+systemctl reload`). | `/etc/gamecult/minds/fence.nft` | Fence is the host boundary; the sandbox is the process boundary. Residuals named in the runbook: abstract unix sockets, Self runs unfenced. Open reach: her shell can `huginn admit` into her own mind (and, inference from the 2026-10-31 probe, another Mind's by declaring its instance) until A1 (`mind-admission-publisher-unproven`; ruling `persona-session-ships-a1-closes`). | `scripts/test-mind-fence.sh` (throwaway container via ygg-verify); `sudo nft list table inet mind_fence` |
| Mind fence (`mind-fence.service`, ruleset `/etc/gamecult/minds/fence.nft`, table `inet mind_fence`) | **Superseded by C1 (see "The persona-only body"): a Persona uid reaches only its own persona door (port + 1000, refuses `Admit`) and the connector at `127.0.0.1:4110`; the heartbeat uid 984 is rejected at every full door; `mind-heartbeat.service` is `Requires=`/`After=` the fence. The mouth and "her shell can `huginn admit`" below describe the pre-C1 fence.** gamecult-ops. The one boundary on what her session reaches on the host, keyed on uid, so it binds the organ and the sandbox alike. | Rendered by the installer from every installed Persona drop-in | nft output chain: persona uids may reach their own huginn address:port, the mouth (127.0.0.1:17884), the host's public 80/443 and the internet; every other local/private address, loopback services, WireGuard peers, other Minds' huginn, and all broadcast/multicast are rejected | Live: `persona_uids` set of 8 uids, `huginn` set of 8 uid.port pairs | Nobody stops it to open anything: it has no `ExecStop`. `/etc/nftables.conf` begins with `flush ruleset`; a flush leaves the unit "active" over an empty fence, so every Persona start reloads it (`ExecStartPre=+systemctl reload`). | `/etc/gamecult/minds/fence.nft` | Fence is the host boundary; the sandbox is the process boundary. Residuals named in the runbook: abstract unix sockets, Self runs unfenced. Open reach: her shell can `huginn admit` into her own mind (and, inference from the 2026-10-31 probe, another Mind's by declaring its instance) until A1 (`mind-admission-publisher-unproven`; ruling `persona-session-ships-a1-closes`). | `scripts/test-mind-fence.sh` (throwaway container via ygg-verify); `sudo nft list table inet mind_fence` |
| `/opt/commons` | root. Toolchains `bin/` and `opt/` are `root:root 0755`, no ACL, contents root-owned and `go-w` (rulings `commons-toolchains-root-owned`, `commons-install-forgiveness`). Data dirs `handoff/` and `cast-art/` are `root:mind-commons 2775` with a default group rwx ACL. | Installer repairs the commons before its PATH check on every run | Self units get `/opt/commons/bin` on PATH; installs go through root (her Self "has the root path"; Minds ask @eureka in #minds) | none | Any Mind user writing `bin/` or `opt/`. Persona users are not in `mind-commons` and see `/opt/commons` read-only (bwrap `--ro-bind /`, and `ProtectSystem=strict`). | `mind-self@` has `SupplementaryGroups=claude-lease mind-commons` and `ReadWritePaths=/opt/commons` | Toolchain/data split is the cut; one writer class per dir | Live read: `/opt/commons`, `bin`, `opt` root:root 0755; `handoff`, `cast-art` drwxrwsr-x+ root:mind-commons; installer test asserts no group/other-writable path under `bin/` and `opt/` (baa39fd) |
| Connector callers | **Superseded by C2 (Huginn `66b85c8`; see "The persona-only body").** The PersonaTurn lease row has no caller until C3b; SelfRun is unused while no Self run launches. ModelConnector (claude-connector) config at `/etc/gamecult/claude-connector/config.cc`, installed by gamecult-ops `install-claude-connector-yggdrasil.sh` | Each Mind is its own caller (`swarm-one-connector-many-callers-mind-per-daemon`) with a root:root 0600 connection key `connection-<m>.key` that no Mind reads | Two lease rows per Mind: SelfRun bound to `mind-self@<m>` and PersonaTurn bound to `mind-persona@<m>` (the lease is bound to the unit invocation and peer uid, capped by `--lease-max-ms` = cap + slack) | Lease socket `/run/claude-connector/lease.sock`, group `claude-lease` | Installer never deletes a key; `--remove-caller` is the one removal (21c5bf9, f4d90a7). The Persona unit no longer holds a connector key or endpoint, and `KitConnector`/`MAX_TURNS_PER_START` are gone (grep of Huginn origin/main: only history docs name them). The heartbeat's connector key is retired (`connection-heartbeat.key.dollar-era-2026-10-31` is a dead file). | `/etc/gamecult/claude-connector/` | Caller = Mind, lease = unit | bring-up `verify pre` expects one SelfRun and one PersonaTurn lease row per Mind (81f82b4) |
| Heartbeat (`mind-heartbeat`) | **Superseded by C2 (Huginn `66b85c8`; see "The persona-only body").** Replaced by the second row of "The persona-only body"; it opens no run. Huginn. Sole writer of `heartbeat.cc`; opens PersonaTurn and SelfRun runs through `open_and_launch`; classifies nothing, meters nothing. | Swarm envelope, mind, mouth | Starts `mind-persona@<i>`; "busy" is the slot's reading of life: a Persona run whose unit lives (or is in start grace) is busy, a dead holder is not, and the next launch closes it (cbb90d5) | `heartbeat.cc`, read by Persona units via `MIND_HEARTBEAT_STATE` | It never acks a delivery | | The sequence doc's cut 7 (`session-keeper`: floor of one live session, wakes written into live sessions) is not shown landed in the code read; today's heartbeat still launches a unit per beat, and the live session drains deliveries on its own poll. (Unverified beyond the module docs; Soul/Imagination to confirm before the map says "landed".) | |

View file

@ -161,7 +161,7 @@ From r3 B3, now read as a deletion list rather than a body to rebuild:
2026-10-01). `inventory.md:581-588, 726-785` describes the Starfire cognition
body and the "intended Epiphany deployment body (not installed)". These are
deleted or rewritten in the same cut.
- What stays: `huginn.service`, the Bifrost units (`bifrost-persona-feedback`,
- What stays: `huginn.service` (since C1, 2026-11-19, this is `huginn@eureka`), the Bifrost units (`bifrost-persona-feedback`,
`bifrost-persona-mouth`, the watchdog timer), `codex-connector.service` as a
dead unit until the connector cuts land, the `gamecult-model` group and its
key files, user `codex-connector`.

View file

@ -1,5 +1,7 @@
# Swarm revival: target shape (draft)
> **Superseded in part by C1 (Huginn `57b931f`, 2026-11-19).** Personas reach their Mind only at a persona door (port + 1000) that refuses `Admit`, behind the `mind-fence` nft rules; Eureka's daemon is `huginn@eureka`, not `huginn.service`. See `docs/eureka-body-map.md`.
>
> **Superseded in part by C2 (Huginn `66b85c8`).** The Persona turn, the per-instance waker, the start-Self-run tool and the Self-run launch path this draft plans around are deleted or parked; the live Persona, heartbeat and Self-run rows are in `docs/eureka-body-map.md`, "The persona-only body (after C2)". The mind, instance, share and lifecycle tables below still describe the intended swarm shape, not the running one.
Status: draft target, Imagination (`imagination-swarm`), session