You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**What changed, and why.** `09-clients.md`'s API-coverage table cited a
browser-client test file W74b deleted four days before this pass was
written; repoints the column at `SubZeroDev.Adventures`, with no gate in
this repo re-running it. `20-contract.md` §19 gains a third sanctioned
package-root export category — a kind's own reference campaign
(`buildWorldGraphMvpCampaign`) — closing the gap between what W88
shipped and what §19 said, and gets its own decision-log entry rather
than leaving the reasoning in a slice that will eventually be renumbered
out. Regenerates the affected `docs/docs/engine/` pages and fixes a
stale `guide.md` claim (frozen-campaign removal already shipped in
0.9.0, not upcoming).
**Note for the reviewer:** this branch also removes the open-register
item on per-kind event-severity literals from `90-decisions.md` §2 and
`OPEN-QUESTIONS.md`, with no corresponding decision entry explaining the
removal — none of the three new 2026-08-23 entries address it, and I
found no code change implementing the structural fix it called for.
GitHub issue #371 tracks this exact item and is still open. Flagging
rather than silently dropping — worth confirming whether the removal was
intentional (issue resolved elsewhere) or should be restored.
### Verified
**Ran and passed:**
- Parse-check PowerShell scripts — ran locally:
`[System.Management.Automation.Language.Parser]::ParseFile` against
every `*.ps1` in the repo. No parse errors found.
- Run Pester tests — CI `powershell` check passed in 1m4s on this exact
head commit (run 32647649865, job 97214271251). A local reproduction
(`Invoke-Pester -Path tools`) diverged with 10 failures, all inside
`Test-DesignState`/`Read-DesignState`/`Update-DesignProjection` tests
that shell out to `gh` to read dozens of tracked issues (e.g.
`TrackerUnavailable: could not read issue #142...#371`) against a local
`design/state/` cache — that step's own test (#79) asserts CI carries a
`GH_TOKEN` env var this local session's `gh` auth does not replicate the
same way for project/board-scoped lookups. Treated as environment
divergence, not a code defect in this diff: CI ran the same commit and
passed.
- Typecheck, Lint, Test, Pack package, Inspect tarball, Consumer smoke —
CI `engine` check passed in 38s (run 32647649885, job 97214271430). This
PR changes no files under `src/engine/`, so the job's own
change-detection step skips these and the job still reports success.
- Validate Markdown links, terminology, and generated files — initially
failed both locally and in CI (`Documentation links and terminology`,
fail, 4m3s, run 32647649890, job 97214271493):
`build/Test-Documentation.ps1:773` threw *"Generated guide is stale:
docs/docs/guide.md (run /make-human-docs, then stamp the guide)"*
because the earlier `/make-human-docs` pass this session edited
`docs/docs/guide.md` without running the follow-up
`./build/ConvertTo-HumanDocumentation.ps1 -StampGuide` step. Fixed
(`7191435`) by running that stamp step and re-running locally:
*"Human-documentation drift check passed across 18 generated engine
page(s), compatibility pointers, and the guide. Documentation checks
passed across 173 Markdown file(s)."*
- Build documentation, Build and verify landing page, Merge landing page
into documentation build — CI `Verify Documentation Build` passed in
2m11s (run 32647649890, job 97214271395). Not reproducible locally:
these steps run inside the `ghcr.io/the-running-dev/docs-template`
Docker image via the installed `docs.ps1` wrapper, and `docs.ps1` is
generated by `Invoke-SetupDocs` rather than committed to this repo — it
is absent from this checkout.
- Test the host, Positive route and probe smoke, Negative fixture --
corrupted artifact must fail to start — CI `Build, run, and smoke the
image` passed in 2m6s (run 32647649863, job 97214271317). Not attempted
locally: the dotnet test step needs a `NUGET_GITHUB_TOKEN` secret
unavailable locally, and the smoke steps need a full Docker image
build/run this session didn't reproduce.
**Ran and failed:** none, after the guide-digest fix above.
**Did not run:** none — every discovered gate (`# verification: true` in
`.github/workflows/{ci,verify,docs-ci,host-image}.yml`) produced a
result, either from a local run or from CI's own execution of this exact
commit.
---
<details><summary><b>Agent detail</b></summary>
<!-- agent:start -->
- **Kind:** Reconciliation pass (`design/90-decisions.md`, three
2026-08-23 entries) + `/make-human-docs` regeneration
- **Files:** `design/10-design.md`, `design/20-contract.md`,
`design/90-decisions.md`, `docs/docs/engine/02-architecture.md`,
`docs/docs/engine/04-core.md`, `docs/docs/engine/09-clients.md`,
`docs/docs/engine/13-playable-web-demo.md`,
`docs/docs/engine/OPEN-QUESTIONS.md`, `docs/docs/guide.md`
- **Note:** the reconciliation content (design/decisions edits) predates
this session's `/pr` invocation; `/pr` packaged it to a branch,
committed, and pushed. `docs/docs/guide.md`'s content change and digest
stamp were made in this session via `/make-human-docs` and `/verify`.
<!-- agent:end -->
</details>
0 commit comments