rcf-lite 0.28.2 → 0.29.0

package/rcf/test-suites/ts-207.json

@@ -0,0 +1,22 @@
+{
+  "id": "TS-207",
+  "usId": "US-17004",
+  "title": "Product Map trace coverage",
+  "purpose": "Cover AC-17004-1: each REQ bucketed by trace completeness with a plain-text \"what is missing\" line.",
+  "testLevel": "integration",
+  "acIds": [
+    "AC-17004-1"
+  ],
+  "testCases": [
+    {
+      "id": "TC-207-trace-coverage-buckets",
+      "acId": "AC-17004-1",
+      "description": "Trace coverage grouping buckets each REQ into the FIRST bucket whose rule it meets (missing-stories, missing-ac-scope, missing-component, missing-tests, complete); a synthetic fixture asserts the classification per REQ id, including the P1-4 dangling-TAC case landing in missing-component.",
+      "status": "passing",
+      "testPointer": "test/view/product-map.test.js::product-map trace coverage places each REQ in the FIRST bucket whose condition it meets, on a synthetic fixture (P2-3)"
+    }
+  ],
+  "status": "approved",
+  "createdAt": "2026-09-21T17:00:00.000Z",
+  "updatedAt": "2026-09-21T18:02:10.973Z"
+}

package/rcf/test-suites/ts-208.json

@@ -0,0 +1,22 @@
+{
+  "id": "TS-208",
+  "usId": "US-17005",
+  "title": "Product Map capability grouping",
+  "purpose": "Cover AC-17005-1: capability:<slug> tag consumption and Unclassified bucket.",
+  "testLevel": "integration",
+  "acIds": [
+    "AC-17005-1"
+  ],
+  "testCases": [
+    {
+      "id": "TC-208-capability-buckets",
+      "acId": "AC-17005-1",
+      "description": "Capability grouping enumerates one bucket per distinct capability:<slug> tag; multi-tag REQs appear in each bucket; untagged REQs go to Unclassified.",
+      "status": "passing",
+      "testPointer": "test/view/product-map.test.js::product-map capability grouping enumerates one bucket per capability slug with Unclassified for untagged REQs"
+    }
+  ],
+  "status": "approved",
+  "createdAt": "2026-09-21T17:00:00.000Z",
+  "updatedAt": "2026-09-21T17:00:00.000Z"
+}

package/rcf/test-suites/ts-209.json

@@ -0,0 +1,22 @@
+{
+  "id": "TS-209",
+  "usId": "US-17101",
+  "title": "Dogfood REQs carry capability tags",
+  "purpose": "Cover AC-17101-1: every REQ file carries at least one capability:<slug> tag drawn from the documented taxonomy.",
+  "testLevel": "integration",
+  "acIds": [
+    "AC-17101-1"
+  ],
+  "testCases": [
+    {
+      "id": "TC-209-every-req-has-capability-tag",
+      "acId": "AC-17101-1",
+      "description": "Every requirement file under packages/rcf-lite/rcf/requirements/ carries at least one capability:<slug> tag, and each slug is listed in docs/capability-tags.md.",
+      "status": "passing",
+      "testPointer": "test/view/capability-tags.test.js::every dogfood REQ carries at least one capability tag mapped to a documented slug"
+    }
+  ],
+  "status": "approved",
+  "createdAt": "2026-09-21T17:00:00.000Z",
+  "updatedAt": "2026-09-21T17:00:00.000Z"
+}

package/rcf/test-suites/ts-210.json

@@ -0,0 +1,22 @@
+{
+  "id": "TS-210",
+  "usId": "US-17102",
+  "title": "Capability taxonomy documented",
+  "purpose": "Cover AC-17102-1: docs/capability-tags.md exists and is linked from docs/README.md.",
+  "testLevel": "integration",
+  "acIds": [
+    "AC-17102-1"
+  ],
+  "testCases": [
+    {
+      "id": "TC-210-taxonomy-doc-present",
+      "acId": "AC-17102-1",
+      "description": "docs/capability-tags.md exists, lists every taxonomy slug with a one-line meaning, states the \"add a capability\" rule, and is linked from docs/README.md.",
+      "status": "passing",
+      "testPointer": "test/view/capability-tags.test.js::docs carry the capability taxonomy and link to it from the docs README"
+    }
+  ],
+  "status": "approved",
+  "createdAt": "2026-09-21T17:00:00.000Z",
+  "updatedAt": "2026-09-21T17:00:00.000Z"
+}

package/rcf/test-suites/ts-211.json

@@ -0,0 +1,22 @@
+{
+  "createdAt": "2026-09-21T18:46:16.398Z",
+  "updatedAt": "2026-09-21T18:46:16.604Z",
+  "purpose": "Cover the collapsed-by-default buckets, jump-nav rail, per-status mini counts, expand/collapse-all and open-bucket hash restore for AC-17006-1.",
+  "testLevel": "integration",
+  "acIds": [
+    "AC-17006-1"
+  ],
+  "id": "TS-211",
+  "usId": "US-17006",
+  "title": "Product Map interaction model",
+  "testCases": [
+    {
+      "id": "TC-211-interaction-model-buckets",
+      "acId": "AC-17006-1",
+      "description": "Every bucket renders as a collapsed <details class=pm-bucket> with a per-status mini row and a jump-nav chip row per grouping.",
+      "status": "pending",
+      "testPointer": "test/view/product-map.test.js::product-map buckets are <details class=\"pm-bucket\"> collapsed by default with a per-status mini row (AC-17006-1)"
+    }
+  ],
+  "status": "draft"
+}

package/rcf/test-suites/ts-212.json

@@ -0,0 +1,22 @@
+{
+  "createdAt": "2026-09-21T18:46:16.821Z",
+  "updatedAt": "2026-09-21T18:46:17.106Z",
+  "purpose": "Cover the initial-render skeletons and raw-JSON suppression the lazy render depends on for AC-17007-1.",
+  "testLevel": "integration",
+  "acIds": [
+    "AC-17007-1"
+  ],
+  "id": "TS-212",
+  "usId": "US-17007",
+  "title": "Product Map lazy first-load payload",
+  "testCases": [
+    {
+      "id": "TC-212-lazy-skeletons",
+      "acId": "AC-17007-1",
+      "description": "Initial contentHtml emits data-pm-lazy=true skeletons for every grouping and never inlines a raw-JSON disclosure inside a pm-req card.",
+      "status": "pending",
+      "testPointer": "test/view/product-map.test.js::product-map lazy render: initial contentHtml emits skeletons for every grouping (AC-17007-1)"
+    }
+  ],
+  "status": "draft"
+}

package/rcf/test-suites/ts-213.json

@@ -0,0 +1,50 @@
+{
+  "createdAt": "2026-09-22T11:59:39Z",
+  "updatedAt": "2026-09-22T15:00:00Z",
+  "purpose": "Cover the blueprint badge on every REQ row and the by-blueprint grouping (bucket per applied blueprint plus Application bucket, capability second level, hash round-trip, /product-map/blueprint partial endpoint) for AC-17008-1.",
+  "testLevel": "integration",
+  "acIds": [
+    "AC-17008-1"
+  ],
+  "id": "TS-213",
+  "usId": "US-17008",
+  "title": "Product Map by-blueprint grouping and blueprint badge",
+  "testCases": [
+    {
+      "id": "TC-213-badge",
+      "acId": "AC-17008-1",
+      "description": "In the shape grouping rendered over a fixture project that applies one blueprint contributing two REQs, both contributed REQ rows carry a pm-blueprint-badge in their summary while the non-blueprint (Application) REQ rows do not.",
+      "status": "pending",
+      "testPointer": "test/view/product-map.test.js::product-map: blueprint badge on every contributed REQ row across groupings (AC-17008-1)"
+    },
+    {
+      "id": "TC-213-buckets",
+      "acId": "AC-17008-1",
+      "description": "The by-blueprint grouping over a fixture with one applied blueprint (2 contributed REQs) and 2 non-blueprint REQs renders exactly two buckets: a blueprint bucket with count 2 and an Application bucket with count 2.",
+      "status": "pending",
+      "testPointer": "test/view/product-map.test.js::product-map: by-blueprint grouping yields one bucket per applied blueprint plus an Application bucket (AC-17008-1)"
+    },
+    {
+      "id": "TC-213-capability-second-level",
+      "acId": "AC-17008-1",
+      "description": "Inside each by-blueprint bucket the second level is capability (existing capability:<slug> tags), then requirement rows, then the usual drill-down.",
+      "status": "pending",
+      "testPointer": "test/view/product-map.test.js::product-map: by-blueprint bucket second level is capability then REQ (AC-17008-1)"
+    },
+    {
+      "id": "TC-213-hash-and-lazy-endpoint",
+      "acId": "AC-17008-1",
+      "description": "The inline script's PM_GROUPS constant lists 'blueprint', the lazy fetch endpoint /product-map/blueprint is exposed on the pre-rendered pmPartials, and renderProductMapGrouping(model, 'blueprint') returns a non-empty string.",
+      "status": "pending",
+      "testPointer": "test/view/product-map.test.js::product-map: by-blueprint grouping wired into PM_GROUPS, pmPartials and renderProductMapGrouping (AC-17008-1)"
+    },
+    {
+      "id": "TC-213-empty-blueprints",
+      "acId": "AC-17008-1",
+      "description": "A project with no applied blueprints (manifest.blueprints empty) renders the by-blueprint grouping with a single Application bucket and no error banner.",
+      "status": "pending",
+      "testPointer": "test/view/product-map.test.js::product-map: by-blueprint grouping on a project with no applied blueprints renders a single Application bucket (AC-17008-1)"
+    }
+  ],
+  "status": "draft"
+}

package/rcf/test-suites/ts-214.json

@@ -0,0 +1,74 @@
+{
+  "createdAt": "2026-09-24T12:00:00Z",
+  "updatedAt": "2026-09-24T12:00:00Z",
+  "purpose": "Cover the delta-detection primitives (hashDocument, computeTreeHash, computeDelta) and the freeze record I/O (load, save, validate) against AC-17201-1..4 on US-17201.",
+  "testLevel": "unit",
+  "acIds": [
+    "AC-17201-1",
+    "AC-17201-2",
+    "AC-17201-3",
+    "AC-17201-4"
+  ],
+  "id": "TS-214",
+  "usId": "US-17201",
+  "title": "Delta detection and freeze record primitives",
+  "testCases": [
+    {
+      "id": "TC-214-delta-shape",
+      "acId": "AC-17201-1",
+      "description": "computeDelta returns the shape proposal section 2.2 pins: frozen / frozenAt / treeHash / currentTreeHash / changed / added / removed / briefSince / unchanged, and classifies changed / added / removed correctly against a divergent freeze record.",
+      "status": "pending",
+      "testPointer": "test/query/delta.test.js::delta: changed / added / removed classify against the freeze record"
+    },
+    {
+      "id": "TC-214-unchanged",
+      "acId": "AC-17201-1",
+      "description": "A tree that matches the freeze record produces empty changed / added / removed lists and unchanged equal to the docHashes count.",
+      "status": "pending",
+      "testPointer": "test/query/delta.test.js::delta: an unchanged tree against a matching freeze reports empty changed/added/removed"
+    },
+    {
+      "id": "TC-214-canonical",
+      "acId": "AC-17201-2",
+      "description": "hashDocument is invariant under a whitespace-only reformat: two documents that parse to the same object hash identically and produce zero changed entries in the delta.",
+      "status": "pending",
+      "testPointer": "test/query/delta.test.js::delta: a whitespace-only reformat of a document produces zero changed ids"
+    },
+    {
+      "id": "TC-214-hash-shape",
+      "acId": "AC-17201-2",
+      "description": "hashDocument returns a sha256:<64-hex> string over the canonical JSON form of the parsed document.",
+      "status": "pending",
+      "testPointer": "test/query/delta.test.js::delta: hashDocument returns a sha256:<64-hex> string over the canonical form"
+    },
+    {
+      "id": "TC-214-freeze-missing",
+      "acId": "AC-17201-3",
+      "description": "loadFreezeRecord returns null when rcf/define/freeze.json is absent; a malformed body raises FreezeRecordError with the parseFailure code.",
+      "status": "pending",
+      "testPointer": "test/define/freeze-record.test.js::freeze-record: a malformed JSON body raises FreezeRecordError with parseFailure code"
+    },
+    {
+      "id": "TC-214-freeze-schema",
+      "acId": "AC-17201-3",
+      "description": "A body with a non-sha256 docHashes value is refused with a FreezeRecordError naming the failing docHashes.<id> field.",
+      "status": "pending",
+      "testPointer": "test/define/freeze-record.test.js::freeze-record: docHashes with a non-sha256 value is refused"
+    },
+    {
+      "id": "TC-214-roundtrip",
+      "acId": "AC-17201-4",
+      "description": "saveFreezeRecord followed by loadFreezeRecord round-trips every field including unknown extension fields (counts, litmus, versions, note).",
+      "status": "pending",
+      "testPointer": "test/define/freeze-record.test.js::freeze-record: unknown top-level fields survive a save/load round trip"
+    },
+    {
+      "id": "TC-214-refuse-invalid-write",
+      "acId": "AC-17201-4",
+      "description": "saveFreezeRecord refuses an invalid record and writes nothing to disk.",
+      "status": "pending",
+      "testPointer": "test/define/freeze-record.test.js::freeze-record: saveFreezeRecord refuses to write an invalid record"
+    }
+  ],
+  "status": "draft"
+}

package/rcf/test-suites/ts-215.json

@@ -0,0 +1,211 @@
+{
+  "createdAt": "2026-09-24T12:00:00Z",
+  "updatedAt": "2026-10-02T16:40:00Z",
+  "purpose": "Cover the four sidecar ledgers, the rcf define ledger CLI (add / resolve / list with --json) and the walker-invisibility invariant on rcf/define/ (AC-17301-1..4 on US-17301), the update subverb and the closed resolvedBy pointer grammar (AC-17302-1..6 on US-17302), the statement-file markers (AC-18701-1..6 on US-18701) and the scan wiring (AC-18702-1..6 on US-18702).",
+  "testLevel": "integration",
+  "acIds": [
+    "AC-17301-1",
+    "AC-17301-2",
+    "AC-17301-3",
+    "AC-17301-4",
+    "AC-17302-1",
+    "AC-17302-2",
+    "AC-17302-3",
+    "AC-17302-4",
+    "AC-17302-5",
+    "AC-17302-6",
+    "AC-18701-1",
+    "AC-18701-2",
+    "AC-18701-3",
+    "AC-18701-4",
+    "AC-18701-5",
+    "AC-18701-6",
+    "AC-18702-1",
+    "AC-18702-2",
+    "AC-18702-3",
+    "AC-18702-4",
+    "AC-18702-5",
+    "AC-18702-6"
+  ],
+  "id": "TS-215",
+  "usId": "US-17301",
+  "title": "Sidecar ledgers, rcf define ledger and walker invisibility (extended for update + intake markers + scans)",
+  "testCases": [
+    {
+      "id": "TC-215-brief-add-text",
+      "acId": "AC-17301-1",
+      "description": "rcf define ledger brief add --text mints id 1 with status open, kind capability by default, and writes rcf/define/brief-ledger.json.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI: brief add --text appends a numbered statement"
+    },
+    {
+      "id": "TC-215-brief-refuse-mixed",
+      "acId": "AC-17301-1",
+      "description": "rcf define ledger brief add refuses conflicting --text and --from with a usage-class error (exit 2).",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI: brief add refuses conflicting --text and --from with a usage error"
+    },
+    {
+      "id": "TC-215-decisions-list-241",
+      "acId": "AC-17301-2",
+      "description": "rcf define ledger decisions list prints the numbered #241 format: question, options as 'letter) text', default and blocks labelled on their own lines.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI: decisions list prints the numbered #241 format"
+    },
+    {
+      "id": "TC-215-list-json",
+      "acId": "AC-17301-2",
+      "description": "rcf define ledger <name> list --json emits { ledger, <arrayKey>: [...] } with the same body loadLedger returns.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI: list --json emits the machine-readable envelope"
+    },
+    {
+      "id": "TC-215-brief-from-file",
+      "acId": "AC-17301-3",
+      "description": "rcf define ledger brief add --from <file> splits by non-empty lines, mints sequential ids and writes every statement with the resolved kind.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI: brief add --from <file> splits by non-empty line"
+    },
+    {
+      "id": "TC-215-parse-brief-bullets",
+      "acId": "AC-17301-3",
+      "description": "parseBriefFromFile strips leading '- ', '* ' and '<n>. ' bullets so drafts match the raw statement text.",
+      "status": "pending",
+      "testPointer": "test/define/ledgers.test.js::ledgers: parseBriefFromFile splits by non-empty lines and strips bullets"
+    },
+    {
+      "id": "TC-215-walker-invisible",
+      "acId": "AC-17301-4",
+      "description": "walkTree run over a project seeded with rcf/define/freeze.json, the four ledger files and a bug-bait req-999.json under rcf/define/ never surfaces any rcf/define/ path in errors or byId.",
+      "status": "pending",
+      "testPointer": "test/store/walker-invisible-define.test.js::walkTree never surfaces rcf/define/ files as documents in byId"
+    },
+    {
+      "id": "TC-215-brief-update-fields-and-preserve-id",
+      "acId": "AC-17302-1",
+      "description": "updateEntry patches brief fields (kind, resolvedBy) and preserves id and addedAt; the CLI brief update subverb returns 0 and the write lands on the ledger with the patched fields.",
+      "status": "pending",
+      "testPointer": "test/define/ledgers.test.js::updateEntry (AC-17302-1): patches brief fields and preserves id / addedAt"
+    },
+    {
+      "id": "TC-215-decisions-update-wellformed",
+      "acId": "AC-17302-2",
+      "description": "decisions update patches options and default so decisions:wellFormed shape passes (two options + a default).",
+      "status": "pending",
+      "testPointer": "test/define/ledgers.test.js::updateEntry (AC-17302-2): decisions update patches options and default and passes wellFormed shape"
+    },
+    {
+      "id": "TC-215-resolvedby-grammar-each-form",
+      "acId": "AC-17302-3",
+      "description": "Each resolvedBy pointer form (REQ-nnn, TAD.entity:<name>, PRD.user:<name>, TAD.system:<name>, TAC-nnnn, omitted:<reason>) resolves on the fixture and D2's skeleton:resolvedBy passes it.",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates (REQ-173, AC-17302-3): each pointer form resolves on the fixture"
+    },
+    {
+      "id": "TC-215-update-refuses-nongrammar",
+      "acId": "AC-17302-4",
+      "description": "brief update --resolved-by with a free-text pointer exits 2 naming the grammar and the ledger is unchanged.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI (AC-17302-4): brief update --resolved-by outside the grammar exits 2 and writes nothing"
+    },
+    {
+      "id": "TC-215-d2-dangling-pointer-fails",
+      "acId": "AC-17302-5",
+      "description": "A statement with resolvedBy REQ-999 on a tree with no REQ-999 fails skeleton:resolvedBy with 'pointer does not resolve'.",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates (REQ-173, AC-17302-5): REQ-999 fails with \"pointer does not resolve\""
+    },
+    {
+      "id": "TC-215-d2-title-hit-dropped",
+      "acId": "AC-17302-6",
+      "description": "In 0.30.0 skeleton:resolvedBy no longer passes a statement on a REQ-title text hit alone; a resolvedBy pointer is required.",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates (REQ-173, AC-17302-6): a text-title hit alone does NOT pass in 0.30.0"
+    },
+    {
+      "id": "TC-215-markers-kind-and-source",
+      "acId": "AC-18701-1",
+      "description": "parseBriefFromFile parses a leading [kind] and a trailing (source: ...) marker; the CLI brief add --from mints a statement with that kind, text and source.",
+      "status": "pending",
+      "testPointer": "test/define/ledgers.test.js::parseBriefFromFile (AC-18701-1): leading [kind] and trailing (source: ...) markers mint one statement"
+    },
+    {
+      "id": "TC-215-defaults-from-flags",
+      "acId": "AC-18701-2",
+      "description": "A line without markers inherits --kind and --source from CLI flags.",
+      "status": "pending",
+      "testPointer": "test/define/ledgers.test.js::parseBriefFromFile (AC-18701-2): a line without markers inherits --kind and --source"
+    },
+    {
+      "id": "TC-215-question-heuristic",
+      "acId": "AC-18701-3",
+      "description": "A trailing '?' or a TBC/TBD/Open:/Question: prefix with no [kind] marker kinds the statement openQuestion.",
+      "status": "pending",
+      "testPointer": "test/define/ledgers.test.js::parseBriefFromFile (AC-18701-3): a question-mark trailing line is kinded openQuestion"
+    },
+    {
+      "id": "TC-215-029-line-per-statement-unchanged",
+      "acId": "AC-18701-4",
+      "description": "A 0.29.0 line-per-statement file (no markers) parses to the same drafts as the 0.29.0 code path produced.",
+      "status": "pending",
+      "testPointer": "test/define/ledgers.test.js::parseBriefFromFile (AC-18701-4): a 0.29.0 line-per-statement file parses unchanged"
+    },
+    {
+      "id": "TC-215-unknown-kind-exits-2",
+      "acId": "AC-18701-5",
+      "description": "A line with an unknown [kind] exits 2 naming the accepted kinds and writes nothing to the ledger.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI (AC-18701-5): brief add --from with an unknown [kind] exits 2 before writing"
+    },
+    {
+      "id": "TC-215-dry-run-no-write",
+      "acId": "AC-18701-6",
+      "description": "brief add --from --dry-run never creates or modifies rcf/define/brief-ledger.json.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI (AC-18701-6, --dry-run): writes nothing"
+    },
+    {
+      "id": "TC-215-scan-mints-openquestion",
+      "acId": "AC-18702-1",
+      "description": "A new statement that the contradiction scan flags against an existing statement adds one openQuestion statement with source scan:contradiction:<id>,<id>.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI (AC-18702-1): mechanical scan on brief add mints an openQuestion with scan: source"
+    },
+    {
+      "id": "TC-215-findings-mints-openquestions",
+      "acId": "AC-18702-2",
+      "description": "--findings <path> accepts rcf discover intake --input shape and mints one openQuestion per finding with source scan:<name>.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI (AC-18702-2): --findings file mints one openQuestion per finding with scan: source"
+    },
+    {
+      "id": "TC-215-scans-compare-every-existing",
+      "acId": "AC-18702-3",
+      "description": "runIntakeScansOnDelta compares every new statement against every existing statement (the frozen set is every statement).",
+      "status": "pending",
+      "testPointer": "test/intake/validate.test.js::runIntakeScansOnDelta (AC-18702-3): on a frozen set the comparison set is every existing statement"
+    },
+    {
+      "id": "TC-215-json-emits-added-and-findings",
+      "acId": "AC-18702-4",
+      "description": "brief add --json emits { added: [...], findings: [...] } on stdout.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI (AC-18702-4, --json): emits { added, findings }"
+    },
+    {
+      "id": "TC-215-no-scan-plus-findings-exits-2",
+      "acId": "AC-18702-5",
+      "description": "--no-scan combined with --findings exits 2 naming the conflict.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI (AC-18702-5): --no-scan with --findings exits 2"
+    },
+    {
+      "id": "TC-215-text-runs-no-scan",
+      "acId": "AC-18702-6",
+      "description": "brief add --text runs no scan and appends no openQuestion statement.",
+      "status": "pending",
+      "testPointer": "test/cli/ledger.test.js::ledger CLI (AC-18702-6): --text runs no scan and appends no openQuestion"
+    }
+  ],
+  "status": "draft"
+}

package/rcf/test-suites/ts-216.json

@@ -0,0 +1,94 @@
+{
+  "createdAt": "2026-09-24T14:30:00Z",
+  "updatedAt": "2026-10-01T13:12:16Z",
+  "purpose": "Cover the DEFINE stage-gate check functions D1..D8 (AC-17401-1..8) with unit tests over hand-built TreeModel and ledger fixtures.",
+  "testLevel": "unit",
+  "acIds": [
+    "AC-17401-1",
+    "AC-17401-2",
+    "AC-17401-3",
+    "AC-17401-4",
+    "AC-17401-5",
+    "AC-17401-6",
+    "AC-17401-7",
+    "AC-17401-8",
+    "AC-17401-9",
+    "AC-17401-10"
+  ],
+  "id": "TS-216",
+  "usId": "US-17401",
+  "title": "Stage gates D1..D8 check functions",
+  "testCases": [
+    {
+      "id": "TC-216-shape",
+      "acId": "AC-17401-1",
+      "description": "Every check function returns { stage, gate, state, checks[] } and every entry in checks[] is { name, ok, over: 'delta'|'tree', pass, total, failing }; failing is empty when ok is true.",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates: every check function returns the section 2.4 shape"
+    },
+    {
+      "id": "TC-216-blocking-vs-warn",
+      "acId": "AC-17401-2",
+      "description": "Blocking stages fold to failing on any check.ok false; warn-with-ack stages (D3, D5, D6) also fold to failing on any check.ok false unless freeze.gates[<gate>].state === 'acknowledged' AND at.hash === currentTreeHash.",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates: warn-with-ack fold honours freeze.gates acknowledgement at the current hash"
+    },
+    {
+      "id": "TC-216-not-applicable",
+      "acId": "AC-17401-3",
+      "description": "notApplicable is decided per stage per section 3.2: D2 with no statement of a resolving kind and no REQ/PRD/TAD in scope; D3 with no TAC and no shaped REQ in scope; D5 with no REQ in scope; D7 with no open decisions and profile.skipReviewFor 'singleDocument' and one-document delta.",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates: notApplicable decision per stage"
+    },
+    {
+      "id": "TC-216-d4-floors",
+      "acId": "AC-17401-4",
+      "description": "checkD4Stories enforces every REQ has US, every US has testable AC + failure AC (parsed by [failure] prefix or opt-out with baselineKey 'defineD4:failure') + must-not AC (or opt-out with 'defineD4:mustNot'), tacIds non-empty and resolving, no TODO placeholder in AC.description.",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates: D4 floors and per-class opt-outs"
+    },
+    {
+      "id": "TC-216-d3-shapes",
+      "acId": "AC-17401-5",
+      "description": "checkD3Shapes runs only the cheap data-backed checks: every TAC in scope has at least one interface, and every interface kind is in the closed vocabulary. Unknown kinds show up in failing[].",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates: D3 interface presence and kind vocabulary"
+    },
+    {
+      "id": "TC-216-d5-crosscut",
+      "acId": "AC-17401-6",
+      "description": "checkD5Crosscut checks TAD.securityArchitecture presence when any REQ has shape 'auth' or 'httpApi'; TAD.operationalConcerns when any AC has '[deployed]' marker; no dangling 'open' concerns on in-scope REQs.",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates: D5 crosscut cheap checks"
+    },
+    {
+      "id": "TC-216-d6-consistency",
+      "acId": "AC-17401-7",
+      "description": "checkD6Consistency asserts validateErrors is empty tree-wide and probeOpenCount is zero; the richer scans are named seams (0.30).",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates: D6 consistency validate + probe count"
+    },
+    {
+      "id": "TC-216-d8-freeze",
+      "acId": "AC-17401-8",
+      "description": "checkD8Freeze asserts prior stages passed/acknowledged, every AC owned by exactly one FBS, computeQueue nextActionable not null, validateErrors empty.",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates: D8 tree-wide freeze checks"
+    },
+    {
+      "id": "TC-216-d2-data-architecture",
+      "acId": "AC-17401-9",
+      "description": "checkD2Skeleton reads tad.dataArchitecture.{dataStores,coreEntities} per rcf-schemas 0.6.3; a tree with populated dataArchitecture passes skeleton:tadPersistence and empty/missing/wrong-top-level trees fail with the schema-anchored ids.",
+      "status": "pending",
+      "testPointer": "test/query/gates.test.js::gates: D2 skeleton:tadPersistence reads tad.dataArchitecture.* per schema 0.6.3"
+    },
+    {
+      "id": "TC-216-identity-seed-surface",
+      "acId": "AC-17401-10",
+      "description": "IDENTITY_TEMPLATE carries a '## Surface' section between '## Register' and '## Project-scoped notes' naming viewer/runningApp/prDiff and seeded to 'prDiff'; writeIdentityTemplate on a fresh dir seeds a profile that satisfies checkD1Brief surface markers; an existing profile.md is left byte-identical (slice-1 'kept' contract).",
+      "status": "pending",
+      "testPointer": "test/setup/identity-register.test.js::IDENTITY_TEMPLATE carries a ## Surface heading between ## Register and ## Project-scoped notes"
+    }
+  ],
+  "status": "draft"
+}

package/rcf/test-suites/ts-217.json

@@ -0,0 +1,62 @@
+{
+  "createdAt": "2026-09-24T14:30:00Z",
+  "updatedAt": "2026-09-24T14:30:00Z",
+  "purpose": "Cover computeReadiness and the rcf define readiness CLI (AC-17501-1..6) with unit tests over fixture trees + a CLI spawn, plus a targeted test of the P3 loadAllLedgers fix.",
+  "testLevel": "unit",
+  "acIds": [
+    "AC-17501-1",
+    "AC-17501-2",
+    "AC-17501-3",
+    "AC-17501-4",
+    "AC-17501-5",
+    "AC-17501-6"
+  ],
+  "id": "TS-217",
+  "usId": "US-17501",
+  "title": "computeReadiness and rcf define readiness CLI",
+  "testCases": [
+    {
+      "id": "TC-217-shape",
+      "acId": "AC-17501-1",
+      "description": "computeReadiness returns { tree, delta, stages, nextAction, coverage, decisions, freezeable } and freezeable is true when every stage state is in { passed, acknowledged, notApplicable }.",
+      "status": "pending",
+      "testPointer": "test/query/readiness.test.js::readiness: returns the section 2.4 shape and freezeable folds correctly"
+    },
+    {
+      "id": "TC-217-fanout",
+      "acId": "AC-17501-2",
+      "description": "Fan-out: computeImpact runs once per id in changed union added; impacted is the deduplicated union; impactedFbs is the subset with kind 'fbs' AND actionNeeded 're-execute'.",
+      "status": "pending",
+      "testPointer": "test/query/readiness.test.js::readiness: fan-out impacted / impactedFbs (frozen delta)"
+    },
+    {
+      "id": "TC-217-coverage",
+      "acId": "AC-17501-3",
+      "description": "coverage.tree is a tree-wide CoverageResult; coverage.delta is one CoverageResult per unique REQ ancestor of the delta ids.",
+      "status": "pending",
+      "testPointer": "test/query/readiness.test.js::readiness: coverage tree-wide and per REQ ancestor"
+    },
+    {
+      "id": "TC-217-next-action",
+      "acId": "AC-17501-4",
+      "description": "nextAction picks the first failing stage in D1..D8 order and the first failing check inside it, listing ids and a rcf define readiness --check <short-name> command; null when no stage is failing.",
+      "status": "pending",
+      "testPointer": "test/query/readiness.test.js::readiness: nextAction picks first failing stage and check"
+    },
+    {
+      "id": "TC-217-cli",
+      "acId": "AC-17501-5",
+      "description": "The CLI prints text summary by default and JSON with --json; --check <stage> exits 4 on blocking failure, 0 with a [warn] on warn-with-ack unacknowledged failure, 0 otherwise; admissibility refusal exits 4.",
+      "status": "pending",
+      "testPointer": "test/cli/readiness.test.js::readiness cli: text output shape and --check exit codes"
+    },
+    {
+      "id": "TC-217-load-all-ledgers",
+      "acId": "AC-17501-6",
+      "description": "loadAllLedgers omits ledgers whose files are absent so computeDelta records no docHash for absent ledgers; a project with only brief-ledger.json sees exactly one ledger:brief docHash.",
+      "status": "pending",
+      "testPointer": "test/define/ledgers.test.js::ledgers: loadAllLedgers omits absent ledger files"
+    }
+  ],
+  "status": "draft"
+}