Skip to content

S4 — Every reference resolves, and every claim about the engine repository pins a commit - #37

Merged
The-Running-Dev merged 2 commits into
mainfrom
slice/S4
Aug 24, 2026
Merged

S4 — Every reference resolves, and every claim about the engine repository pins a commit#37
The-Running-Dev merged 2 commits into
mainfrom
slice/S4

Conversation

@The-Running-Dev

@The-Running-Dev The-Running-Dev commented Aug 24, 2026

Copy link
Copy Markdown
Owner

Adds cross-reference extraction and checking to the spec-set checker: §N.N section marks and
markdown document links resolve against the corpus, and the 8 mentions of SubZeroDev.GameEngine
documents are classified CrossRepository, listed as unresolvable, and required to carry a pinned
commit sha. All 8 existing cross-repository mentions in life-in-the-fast-lane.md and
bulgaria-adventure.md are now pinned to SubZeroDev.GameEngine's current main commit
(bc74a62). One genuine dangling same-repo reference the new check surfaced —
02-narrative-voice.md's bare §17, which meant the engine spec's §17 but carried no qualifier —
is fixed in the same commit, since leaving it would fail the build for a defect the check exists to
catch.

Closes #11

Verified

Ran and passed:

  • Parse-check PowerShell scripts — every tools/*.ps1 parses cleanly.
  • Validate the core/companion split — 22 core(s) checked, State: Valid.
  • Check the design state against the tree — State: Valid, 0 findings, 0 could-not-evaluate.
  • Check the spec set — State: Valid; 8 documents; 936 declarations; 2 mirror obligations checked; 8 references unresolvable (cross-repository, not checked). Commit 3f214beb175da1a0ebd8469fe3316bf9133ac855, working tree clean.
  • git diff --check — exited 0, no trailing whitespace or conflict markers.

Ran and failed:

  • Run Pester tests — 323 passed, 1 failed, 324 total. The failure, Test-DesignState.Tests.ps1's S18.6, expects EnforcementUnevidenced to block (exit 1) when a decision's SupersededBy is stripped, but design/FROZEN.md (added at 407bcea, before this slice started) downgrades every blocking divergence class to reported while active, so it exits 0. Confirmed pre-existing and unrelated to this branch — reproduces identically on main at cbc5a60 with none of this branch's changes checked out; the test predates the freeze marker and was never updated for it. Tracked as #38.

Did not run:

  • docs.ps1 -BuildOnly (Docusaurus image build) — Docker Desktop is not running locally, and this step is not CI-gated (no # verification: true flag in .github/workflows/verify.yml).

Agent detail
  • Slice: S4 — design/30-slices.md § S4 @ 86fc538f3e44d765f85cbaeff551ec2e06ed8919
  • Criteria met: S4.1, S4.2, S4.3, S4.4, S4.5, S4.6, S4.7, S4.8
  • Left undone: none

…itory pins a commit

Adds reference extraction (§N.N section marks, markdown document links, and
engine/*.md cross-repository mentions) to Read-SpecSet.ps1, and the reference
check, unresolvable bucket, and status-precedence report wiring to
Test-SpecSet.ps1. Pins all 8 existing cross-repository mentions in
life-in-the-fast-lane.md and bulgaria-adventure.md with the SubZeroDev.GameEngine
commit they were true at. Fixes one genuine dangling same-repo reference the new
check surfaced (02-narrative-voice.md's bare §17, which meant the engine spec's
§17 but carried no qualifier). Materialises the Unresolvable scaffold in
design/20-contract.md.
@The-Running-Dev
The-Running-Dev merged commit 09a58d9 into main Aug 24, 2026
0 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

S4 — Every reference resolves, and every claim about the engine repository pins a commit

1 participant