Skip to content

Amend SS5 so an unresolvable subject is not an unchecked run - #34

Merged
The-Running-Dev merged 5 commits into
mainfrom
contract/ss5-unresolvable-split
Aug 23, 2026
Merged

Amend SS5 so an unresolvable subject is not an unchecked run#34
The-Running-Dev merged 5 commits into
mainfrom
contract/ss5-unresolvable-split

Conversation

@The-Running-Dev

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

Copy link
Copy Markdown
Owner

Resolves design/30-slices.md § Contract questions 1, which blocks #11 from starting.
SS5 escalated any unchecked entry to exit 2, but CrossRepositoryUnresolvable is a permanent
steady state, not a degraded run — so from S4's first commit, Verify would go red on every
branch with no edit able to clear it. Splits the one word doing two jobs: unchecked still
forces exit 2; a new unresolvable list holds checks completed against a subject a recorded
decision placed out of reach, reported and counted but never affecting run status.

Also fixes two pre-existing design-state findings uncovered while verifying this PR: the
install-code-review-agent command and the 2026-08-23 kit-sync decision-log heading (both
added by a prior /kit-sync session, before this branch) had no unit/decision record naming
them, which failed Test-DesignState.ps1 and the CI verify check on every branch.

Closes #11 (unblocks)

Verified

Ran and passed:

  • Parse-check PowerShell scripts — all 33 *.ps1 files parsed cleanly
  • Run Pester tests — 310 passed, 0 failed
  • Validate the core/companion split — 22 core(s) checked, 0 companions present
  • Check the design state against the tree — 0 findings, exit 0 (9 non-blocking MirrorStale work/* records reported, expected since the last /track sync)
  • Check the spec set — Valid; 8 documents; 936 declarations; 2 mirror obligations checked; working tree clean
  • docs.ps1 -BuildOnly (Docusaurus image build) — image built successfully
  • git diff --check — no trailing whitespace or conflict markers

Ran and failed:

  • (none)

Did not run:

  • (none — every discovered gate ran)

Agent detail
  • Type: Contract amendment — design/30-slices.md § Contract questions 1, resolved via /contract
  • Unblocks: S4 — Every reference resolves, and every claim about the engine repository pins a commit #11 (S4)
  • Touches: design/20-contract.md (SS5 reworded, SS6/SS9/SS18), design/90-decisions.md, design/state-index.md, mirror-obligation bound (Contract Question 2); plus the design-state fix: design/state/units/command/install-code-review-agent.md, design/state/decisions/2026-08-23-kit-sync-reconciliation-agents-md-content-forks-and-three-tools-test-files-left-divergent.md, design/state/units/document/agents-md.md

Unblocks S4, which design/30-slices.md gates on "do not start until SS5
is settled".

SS5 escalated any unchecked entry to exit 2; CrossRepositoryUnresolvable
was filed as an unchecked entry described as a permanent steady state;
verify.yml fails the step on 2. The corpus carries 8 engine/*.md
references made permanently unresolvable by the 2026-08-20 no-EnginePath
decision, so from the commit S4 lands, Verify is red on every branch and
no edit to this repository can clear it.

Split the one word that was doing two jobs. Unchecked now means only a
degraded run and still forces exit 2, leaving I19/I20 and AGENTS.md
Verification untouched. A second list, unresolvable, holds a check that
completed against a subject a recorded decision placed out of reach; it
is reported and counted every run and never changes run status. The list
is closed at one member and widening it is a contract amendment.

SS5 reworded, SS6 counts four buckets so S4.6's sum still holds, SS9
keeps "never passed, never broken" verbatim, and new SS18 requires every
completed run to name its unresolvable count so the report carries what
the exit code no longer does.

Also records the mirror-obligation bound from contract question 2: an
obligation asserts its body is a complete restatement of the
declaration's membership, and there is no partial form, because the
wisdom defect the brief names is a missing member. No check or marker
changes.

Corrects descriptive drift found in passing: the invariants block is a
live projected region rendered from design/state/invariants/*.md, not a
scaffold awaiting those records.
Two design-state findings were pre-existing at this branch's base commit:
the install-code-review-agent command had no unit record naming it as
Anchor, and the 2026-08-23 kit-sync decision-log heading had no decision
record naming it. Both blocked Test-DesignState.ps1 and the CI verify
gate on every branch. Added the missing unit and decision records,
bound the decision to unit/document/agents-md's Live list, and
regenerated design/state-index.md's stale units and decision-affects
projections.
The SS5 amendment split unchecked from unresolvable, and S4 was written
against the old single list. S4.3 put the 8 engine references in the
unchecked list, which forces exit 2 — the permanently red build the
amendment removed. S4.5 deferred its exit code to a question now settled,
and S4.6 summed three buckets where SS6 now counts four. All three are
reworded on their existing ids, so /track sees no drift from them.

SS18 and the Unresolvable scaffold had no criterion at all. S4.7 and S4.8
add them; those two ids are drift against issue #11 and are /track's to
reconcile.

Contract questions becomes Resolved contract questions, pointing at the
two 2026-08-23 decisions rather than still saying S4 must not start.

S1, S2, S3 and S5 have closed issues, so their bodies retire to the Landed
index per How this document is kept. All four were last complete at
394505a and git show returns them.
@The-Running-Dev
The-Running-Dev merged commit 6d257d4 into main Aug 23, 2026
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