feat(admin): live admin commands in trace 5 (schema 63)
Foundation / checks (checks) (push) Successful in 5s
Foundation / checks (client) (push) Successful in 5s
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 5s
Foundation / checks (network) (push) Successful in 4s
Foundation / checks (postgres) (push) Successful in 5s
Foundation / checks (tsan) (push) Successful in 5s
Foundation / postgres-tools (push) Successful in 30s
Foundation / server-image (push) Successful in 4m44s
Foundation / image (push) Successful in 5m33s

The admin portal can now spawn wildlife, add bubbles, add to or release the
spent pool, remove a cell and grant a cell's reserve on a running rules-13
region (ADR-0182 section 10). No new owner format or region opening.

- Trace 5: trace 4 plus 64-byte command records counted in the tick header's
  last word; a batch without commands stays trace 4 (older builds replay it).
  Bundle 15 admits trace 5.
- CellularLives::admin_candidate applies a tick's commands after its births,
  each on a copy kept only when it applies and closes: imports through the
  boundary ledger, removals into the spent pool with a new `removed` corpse
  cause, spawned roots via the ADR-0180 seed (now a shared helper) funded by
  an exact import. Refused commands change nothing.
- Schema 63: the immutable admin_commands queue (spawn identities from the
  life allocator), pending/history reads, and binding of every recorded
  command exactly once inside both cellular publishers; the SQL trace parsers
  read trace 5 through its trace-4 normal form.
- The region polls pending commands every 2 s and appends up to 16 per tick;
  the admin API and portal gain region actions, per-cell Remove/Grant and the
  command history.
- Fixes an existing test that did not advance its head after a tick commit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
dingo
2026-10-27 17:14:04 -04:00
co-authored by Claude Opus 5.5
parent b075198040
commit b1cc3b121b
32 changed files with 1487 additions and 138 deletions
+33
View File
@@ -10508,3 +10508,36 @@ Limits: no live region has read a SQL window yet, and no process test drives the
window through a real session; the elapsed-time guard of the 2026-10-08 clock amendment is
still pending. Applying it needs the DEV `aevolution_admin` role and the admin portal's own
login first.
## 2026-10-27 - Admin commands in trace 5 (schema 63)
Scope: ADR-0182 section 10. Operators queue commands in the admin portal (remove a cell,
grant a reserve, add bubbles, add to or release the spent pool, spawn wildlife); the
cellular region applies each once after a tick's births and records it in trace 5, which
bundle 15 admits beside trace 4. Publication binds each recorded command to its queue row
in the same transaction. No owner format, rules, manifest bundle, genome, wire version or
golden changed; a corpse may carry the new `removed` cause (refused by older readers).
The ADR-0180 seeding loop moved into a shared helper with identical draws.
Executed (WSL Ubuntu, GCC 14.2 Release/NDEBUG, build/m97-postgres):
- `cellular-revamp-owner-contracts`: new case applying all six kinds plus a refused one
(missing target): results, closure through the boundary ledger, the exact spent pool,
bubble counts, the removed corpse, spawned wildlife, restore, determinism, trace-5
round trip and replay equality, trace 4 refusing commands; the existing starting-wildlife
and trace cases still pass after the seeding refactor.
- `tools/ci/postgres-check.sh --full` passed (637 s, every phase). New PostgreSQL cases: on
the starting-wildlife region, commands queued through `admin_enqueue_command_v1` (spawn
identities from the life allocator), a tampered trace-5 batch refused by the binding, the
exact batch published with three bindings at its tick and no pending commands left,
recovery equal to the applied state, and a second publication of the same commands
refused; admin API command endpoints (shape refusals, unknown region, author/reason,
history order, runtime role limited to the pending read, rows immutable).
- An existing test bug surfaced: the starting-wildlife publication test did not advance its
head after its tick commit; it now does before the command batch.
- clang-tidy 19 (warnings as errors) on the changed sources after narrowing the command kind
to a byte (the trace keeps a u16 and refuses values over 255); clang-format 19.1.5;
`node --check` on the portal script.
Limits: no live region has applied a command yet; the portal's command forms were not
driven in a browser.