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
Symptom — running Invoke-Pester -Path tools (or tools/Test-DesignState.ps1 directly) against a fresh checkout of this repository fails/could-not-evaluates: design/state/ does not exist anywhere in the tree, but tools/Read-DesignState.ps1, tools/Test-DesignState.ps1, and their own test suites assert real records exist there and self-check against this repository's own state. Expected the design-state reader/checker/projector (added in dc4d9b1) to have something to read; instead six Pester tests fail or report could-not-evaluate, and Test-DesignState.ps1 exits 2 naming StateSetAbsent.
Observed on branch reconcile-after-s13, commit be72319, macOS/Darwin, PowerShell 7.6.4, pwsh.
Reproduce
pwsh -File ./tools/Test-DesignState.ps1 against a checkout of main (or this branch) — exits 2, reporting [ContractListUnreadable] SectionNotFound: design/20-contract.md and [StateSetAbsent] design/state/ is missing or holds zero records.
Invoke-Pester -Path tools -PassThru — six failures/one block failure, all pointing at the same absence: Read-DesignState.Tests.ps1S4.6, Test-DesignState.Tests.ps1S5.6/S12.5/S12.6 (a block failure via a Pester label bug, Pester breaks on functions with unknown label pester/Pester#2669, that also takes down two child assertions), and Update-DesignProjection.Tests.ps1S7.2.
Done when
A regression test fails without the fix and passes with it
Agent instructions
This issue is the specification. A bug has no upstream design document, so unlike a
slice this block is the home rather than a pointer — it carries the constraints instead
of naming where they live.
Authority: the failing tests named above (tools/Read-DesignState.Tests.ps1, tools/Test-DesignState.Tests.ps1, tools/Update-DesignProjection.Tests.ps1), all currently red against this repository's own tree.
Out of scope: the S12.6 block failure's own root cause (a break/continue label mismatch inside the test file, tracked upstream as Pester breaks on functions with unknown label pester/Pester#2669) — that is a test-authoring defect in this repository's Pester usage, separable from whether design/state/ should exist.
Stop if: populating design/state/ turns out to need a contract or schema decision about what belongs in it — that is a design question, not a bug fix.
Verify by reverting the fix and confirming the tests fail again.
Discovered while running /verify on pull request #150; not introduced by that PR, which touches only docs/docs/guide.md.
Symptom — running
Invoke-Pester -Path tools(ortools/Test-DesignState.ps1directly) against a fresh checkout of this repository fails/could-not-evaluates:design/state/does not exist anywhere in the tree, buttools/Read-DesignState.ps1,tools/Test-DesignState.ps1, and their own test suites assert real records exist there and self-check against this repository's own state. Expected the design-state reader/checker/projector (added indc4d9b1) to have something to read; instead six Pester tests fail or report could-not-evaluate, andTest-DesignState.ps1exits 2 namingStateSetAbsent.Observed on branch
reconcile-after-s13, commitbe72319, macOS/Darwin, PowerShell 7.6.4, pwsh.Reproduce
pwsh -File ./tools/Test-DesignState.ps1against a checkout ofmain(or this branch) — exits 2, reporting[ContractListUnreadable] SectionNotFound: design/20-contract.mdand[StateSetAbsent] design/state/ is missing or holds zero records.Invoke-Pester -Path tools -PassThru— six failures/one block failure, all pointing at the same absence:Read-DesignState.Tests.ps1S4.6,Test-DesignState.Tests.ps1S5.6/S12.5/S12.6(a block failure via a Pester label bug, Pester breaks on functions with unknown label pester/Pester#2669, that also takes down two child assertions), andUpdate-DesignProjection.Tests.ps1S7.2.Done when
Agent instructions
This issue is the specification. A bug has no upstream design document, so unlike a
slice this block is the home rather than a pointer — it carries the constraints instead
of naming where they live.
tools/Read-DesignState.Tests.ps1,tools/Test-DesignState.Tests.ps1,tools/Update-DesignProjection.Tests.ps1), all currently red against this repository's own tree.S12.6block failure's own root cause (abreak/continuelabel mismatch inside the test file, tracked upstream as Pester breaks on functions with unknown label pester/Pester#2669) — that is a test-authoring defect in this repository's Pester usage, separable from whetherdesign/state/should exist.design/state/turns out to need a contract or schema decision about what belongs in it — that is a design question, not a bug fix./verifyon pull request #150; not introduced by that PR, which touches onlydocs/docs/guide.md.