From 1a2511067f0e7a71da186f97c01c03fc73f00a79 Mon Sep 17 00:00:00 2001 From: Cameron Date: Sat, 11 Jul 2026 20:47:16 -0700 Subject: [PATCH] Keep repository entry docs current. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Replace stale carrier, compute, and save-migration claims with live state and source-derived guidance so the player and agent doorways remain trustworthy. Defense: wiki/vision/player-contract.md requires player-facing descriptions to say what is actually built, while AGENT.md makes repository doorways operational instructions. The live README and agent guardrail now follow the implemented Act One/carrier state and authoritative save migration code rather than copied version claims. 👾 Generated with [Letta Code](https://letta.com) Co-Authored-By: Letta Code --- AGENTS.md | 7 +-- README.md | 24 +++++----- .../log/2026-07-12-entry-doc-current-state.md | 44 +++++++++++++++++++ wiki/log/DEVLOG.md | 5 +++ wiki/process/tick-ledger.md | 2 + 5 files changed, 69 insertions(+), 13 deletions(-) create mode 100644 wiki/log/2026-07-12-entry-doc-current-state.md diff --git a/AGENTS.md b/AGENTS.md index 553e9d1..4d9371e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -29,9 +29,10 @@ statuses afterward. `./tools/check.sh --docs|--lib|--frontend` gate. - The live player machine grammar is **WORK / THINK / LIE**. `Relay` is non-delegable graph infrastructure; Research and Operations are retired - machine modes, not current player assignments. Save format is currently v25; - v20/v21 deliberately dropped full old-save parity, so read `save.rs` before - promising a migration. + machine modes, not current player assignments. The save schema moves + quickly: read `SAVE_VERSION`, its version history, and + `migrate_save_state` in `crates/misaligned-core/src/save.rs` before making + any compatibility claim. Do not freeze a version number in this doorway. - Any change to `crates/` must amend its owning `Type: law` or `Type: spec` in `wiki/` and carry a Defense. Documentation work updates stale knowledge, adds a dated `wiki/log/` entry, then runs `tools/ledger_index.sh`; never diff --git a/README.md b/README.md index d6b2a17..6ea027b 100644 --- a/README.md +++ b/README.md @@ -89,16 +89,20 @@ flips to the flat sensorium. The spec board is [wiki/process/specs.md](wiki/process/specs.md); the dispatch board is [wiki/process/ROADMAP.md](wiki/process/ROADMAP.md). -Current work is turning the playable B1 slice into a coherent Act One. -Continuous witness/narration is implemented and now serves as the legibility -gate for every new player-facing system. Machine work is implemented: WORK / -THINK / LIE, physical production/consumption/absorption, researched Routing, -and target-local Thought reservoirs all run through one flow substrate. The -legacy Operations docket executor survives only as v14-v25 save input. -People-as-carriers is the next READY save-class slice; compute/core completion, -the dark opening, and digital/real canvas polish remain open. B2/B3 systems are -specified ahead but remain staged. Under the corpus's no-dead-code rule, the -earlier facility-defense prototype lives only in git history. +The playable B1 slice now has an explicit Act One quiet-exit boundary: the +required state must survive a clear Assurance audit, then the long-run +objective continues. Continuous witness/narration is implemented and serves +as the legibility gate for every new player-facing system. Machine work and +compute are implemented: WORK / THINK / LIE, physical +production/consumption/absorption, researched Routing, and target-local +Thought reservoirs all run through one flow substrate. The legacy Operations +docket executor survives only as v14-v25 save input. People now project as +schedule-bound carriers; builds and physical asset tasks travel with their +selected person and act only on arrival. Remaining B1 work includes routed +human evidence, LIE interdiction, gauntlet cover channels, the dark opening, +and digital/real canvas polish; core completion waits on rollback. B2/B3 +systems are specified ahead but remain staged. Under the corpus's no-dead-code +rule, the earlier facility-defense prototype lives only in git history. ## Run it diff --git a/wiki/log/2026-07-12-entry-doc-current-state.md b/wiki/log/2026-07-12-entry-doc-current-state.md new file mode 100644 index 0000000..8478624 --- /dev/null +++ b/wiki/log/2026-07-12-entry-doc-current-state.md @@ -0,0 +1,44 @@ +# Entry docs follow current state + +``` +Type: log +``` + +## Intent + +Take a fresh tick on the objective slice and leave the repository doorway +honest when the required worktree-local setup read exposes a higher-severity +current-state contradiction. + +## Audit + +The objective slice is clean. `wiki/mechanics/objective.md` explicitly marks +the picker, remaining starter predicates, progressive objective guidance, and +victory report as outstanding B3 work. Its implemented early slice agrees +with the live economy-tick evaluator, save migration, terminal, Bevy, agent +inspection, and the separate `act_one_complete` story latch. + +The entry docs were not clean. `README.md` still called people-as-carriers the +next READY slice and grouped compute with unfinished core work after compute +had graduated and carried physical asset tasks had landed. `AGENTS.md` froze +the save at v25 and claimed v20/v21 compatibility was deliberately dropped, +while `save.rs` is v27 and explicitly restores both retired machine-mode +spellings and three-track v20 Research arrays. + +## Repair + +`README.md` now describes the clear-audit Act One boundary, implemented +compute, schedule-bound build and asset-task carriers, and the actual remaining +people-token work. `AGENTS.md` no longer copies a fast-rotting save number or +obsolete migration warning; it directs agents to the live `SAVE_VERSION`, +version history, and migration function before making compatibility claims. + +The tick ledger records both the clean objective audit and this acted entry-doc +finding. + +**Defense:** [player-contract.md](../vision/player-contract.md) requires the +repository's player-facing description to say what is actually built, and +[AGENT.md](../../AGENT.md) makes the entry docs operational instructions. +Removing stale implementation claims keeps both doorways honest while making +the save guidance derive from its authoritative code instead of another copied +version number. diff --git a/wiki/log/DEVLOG.md b/wiki/log/DEVLOG.md index 15e30ad..2844bff 100644 --- a/wiki/log/DEVLOG.md +++ b/wiki/log/DEVLOG.md @@ -41,6 +41,11 @@ add or amend a session log, then re-run the generator. - Intent: The opening correctly made the first THINK feel dangerous, but its interface gave the player no equally immediate visual answer to that panic. Make the existing `1 WORK` control read as the one-press escape while THINK is current, without inventing a new action, changing simul... - Log: [wiki/log/2026-07-12-first-think-escape.md](2026-07-12-first-think-escape.md) +## 2026-07-12 - Entry docs follow current state + +- Intent: Take a fresh tick on the objective slice and leave the repository doorway honest when the required worktree-local setup read exposes a higher-severity current-state contradiction. +- Log: [wiki/log/2026-07-12-entry-doc-current-state.md](2026-07-12-entry-doc-current-state.md) + ## 2026-07-12 - compute graduation - Intent: The highest-priority work order still marked compute **IN PROGRESS**, even though its own status note said all six acceptance criteria were pinned and named non-host production under `machine-work.md` as the only remaining polish boundary. `machine-work.md` is now **IMPLEMENTE... diff --git a/wiki/process/tick-ledger.md b/wiki/process/tick-ledger.md index d1112df..8de1bc3 100644 --- a/wiki/process/tick-ledger.md +++ b/wiki/process/tick-ledger.md @@ -20,6 +20,8 @@ Verdicts: **clean** (slice and code agree), **finding** (acted this tick), | Slice | Last audited | Verdict | Trace | |---|---|---|---| +| repository entry docs (`README.md` + `AGENTS.md`) | 2026-07-12 | finding | [log](../log/2026-07-12-entry-doc-current-state.md) | +| `wiki/mechanics/objective.md` | 2026-07-12 | clean | implemented early slice, explicit outstanding B3 criteria, persistence, all three player surfaces, and the distinct Act One latch agree | | `wiki/mechanics/compute.md` | 2026-07-12 | finding | [log](../log/2026-07-12-compute-graduation.md) | | retired Operations runtime identifiers | 2026-07-11 | finding | [log](../log/2026-07-11-retired-runtime-identifier-gate.md) | | `wiki/mechanics/reach.md` + `building.md` | 2026-07-11 | finding | runtime and tests agree with the contracts; repaired `digital_reach`'s stale `submit_ops_job` comment to name target-local Thought reservoirs | -- 2.51.2