rcf-lite 0.18.0 → 0.20.0

package/rcf/code-nodes/cn-088.json

@@ -0,0 +1,14 @@
+{
+  "cnId": "CN-088",
+  "path": "src/blueprint/companions.js#renderAmbiguousLibraryRefusal",
+  "title": "companions.js: two-libraries-one-role refusal renderer with the three-path resolution message (spec 2.4)",
+  "description": "Anchored by the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022); see the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md for the full trace.",
+  "implementsAcIds": [
+    "AC-1404-2"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/code-nodes/cn-089.json

@@ -0,0 +1,14 @@
+{
+  "cnId": "CN-089",
+  "path": "src/cli/blueprint.js#handleCompanionsVerb",
+  "title": "rcf define blueprint companions <slug> propagates the ambiguousLibraries refusal to exit 3",
+  "description": "Anchored by the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022); see the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md for the full trace.",
+  "implementsAcIds": [
+    "AC-1404-2"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/code-nodes/cn-090.json

@@ -0,0 +1,14 @@
+{
+  "cnId": "CN-090",
+  "path": "src/cli/validate.js#main",
+  "title": "rcf define validate consults validateCompanionPinsResolvable so an unresolvable pin exits 3 with the ratified message shape",
+  "description": "Anchored by the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022); see the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md for the full trace.",
+  "implementsAcIds": [
+    "AC-1404-3"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/code-nodes/cn-091.json

@@ -0,0 +1,14 @@
+{
+  "cnId": "CN-091",
+  "path": "src/blueprint/companions.js#validateCompanionPinsResolvable",
+  "title": "companions.js: unresolvable pin detection walks applied > libraries > shelf and returns rcfError entries the validate CLI folds into exit 3",
+  "description": "Anchored by the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022); see the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md for the full trace.",
+  "implementsAcIds": [
+    "AC-1404-3"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/code-nodes/cn-092.json

@@ -0,0 +1,15 @@
+{
+  "cnId": "CN-092",
+  "path": "src/blueprint/loader.js#validateStandardsTrace",
+  "title": "Loader validates standardsTrace[] shape and refuses missing standardsTraceClause on every ADR contribution (amendment A2 wording preserved)",
+  "description": "Anchored by the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022); see the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md for the full trace.",
+  "implementsAcIds": [
+    "AC-1501-1",
+    "AC-1501-2"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/code-nodes/cn-093.json

@@ -0,0 +1,15 @@
+{
+  "cnId": "CN-093",
+  "path": "src/blueprint/loader.js#preserveAdrDisciplineFields",
+  "title": "Loader preserves recommendedDefault, elicited and standardsTraceClause on ADR contributions so consumers read them off the LoadedBlueprint",
+  "description": "Anchored by the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022); see the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md for the full trace.",
+  "implementsAcIds": [
+    "AC-1501-1",
+    "AC-1501-3"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/code-nodes/cn-094.json

@@ -0,0 +1,14 @@
+{
+  "cnId": "CN-094",
+  "path": "../../blueprints/application-api-rest/blueprint.json",
+  "title": "application-api-rest 2.1.0 declares suggestedCompanions for logging + errorHandling; ADR-304 retained without scope:global (topic transferred to ADR-1601)",
+  "description": "Anchored by the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022); see the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md for the full trace.",
+  "implementsAcIds": [
+    "AC-1402-1"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/code-nodes/cn-095.json

@@ -0,0 +1,14 @@
+{
+  "cnId": "CN-095",
+  "path": "../../blueprints/application-spa/blueprint.json",
+  "title": "application-spa 1.5.0 declares suggestedCompanions for logging + errorHandling to inform the browser-facing boundary",
+  "description": "Anchored by the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022); see the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md for the full trace.",
+  "implementsAcIds": [
+    "AC-1402-1"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/code-nodes/cn-096.json

@@ -0,0 +1,14 @@
+{
+  "cnId": "CN-096",
+  "path": "src/blueprint/apply.js#applyBlueprint",
+  "title": "apply.js: ApplyResult carries suggestedCompanions from the source blueprint so the CLI can render the resolved suggestion block after a successful apply",
+  "description": "Anchored by the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022); see the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md for the full trace.",
+  "implementsAcIds": [
+    "AC-1402-1"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/code-nodes/cn-097.json

@@ -0,0 +1,14 @@
+{
+  "cnId": "CN-097",
+  "path": "src/blueprint/companions.js#unsetCompanionPin",
+  "title": "companions.js: unsetCompanionPin removes the roles.<role> entry, deletes the file when empty, refuses exit 2 when no pin exists for the role",
+  "description": "Anchored by the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022); see the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md for the full trace.",
+  "implementsAcIds": [
+    "AC-1403-2"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/code-nodes/cn-098.json

@@ -0,0 +1,13 @@
+{
+  "cnId": "CN-098",
+  "path": "src/cli/eval-coverage.js#main",
+  "title": "eval-coverage.js: rcf audit eval coverage main handler; parses args, dispatches strict gate, formats table/json/mermaid, exits 4 on missing",
+  "implementsAcIds": [
+    "AC-1601-1"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T16:25:42.896Z",
+  "updatedAt": "2026-09-04T16:25:42.896Z"
+}

package/rcf/code-nodes/cn-099.json

@@ -0,0 +1,13 @@
+{
+  "cnId": "CN-099",
+  "path": "src/query/eval-coverage.js#computeEvalCoverage",
+  "title": "eval-coverage.js: computeEvalCoverage pure function classifies each AC into covered/covered-optional/missing/not-required",
+  "implementsAcIds": [
+    "AC-1601-1"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T16:25:43.056Z",
+  "updatedAt": "2026-09-04T16:25:43.056Z"
+}

package/rcf/code-nodes/cn-100.json

@@ -0,0 +1,13 @@
+{
+  "cnId": "CN-100",
+  "path": "src/verify/verdict/index.js#evalPerAcVerdict",
+  "title": "verdict/index.js: evalPerAcVerdict emits EVAL-MISSING or EVAL-BELOW-THRESHOLD for nonDeterministic ACs",
+  "implementsAcIds": [
+    "AC-1601-2"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T16:25:43.219Z",
+  "updatedAt": "2026-09-04T16:25:43.219Z"
+}

package/rcf/code-nodes/cn-101.json

@@ -0,0 +1,13 @@
+{
+  "cnId": "CN-101",
+  "path": "src/verify/chain/index.js#evalBindingFor",
+  "title": "chain/index.js: evalBindingFor aggregates evalStatus + evalRunVerdict per AC from tree.evals[]",
+  "implementsAcIds": [
+    "AC-1601-2"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T16:25:43.382Z",
+  "updatedAt": "2026-09-04T16:25:43.382Z"
+}

package/rcf/code-nodes/cn-102.json

@@ -0,0 +1,13 @@
+{
+  "cnId": "CN-102",
+  "path": "src/finalise/ship-without-eval.js#composeShipWithoutEvalRecord",
+  "title": "ship-without-eval.js: composeShipWithoutEvalRecord builds the ack record with monotonic id, reason, declared per-AC verdicts, reportPath",
+  "implementsAcIds": [
+    "AC-1601-3"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T16:25:43.546Z",
+  "updatedAt": "2026-09-04T16:25:43.546Z"
+}

package/rcf/code-nodes/cn-103.json

@@ -0,0 +1,13 @@
+{
+  "cnId": "CN-103",
+  "path": "src/finalise/ingest.js#reportHasEvalRefusal",
+  "title": "ingest.js: reportHasEvalRefusal / findEvalRefusalAcs read EVAL-MISSING and EVAL-BELOW-THRESHOLD from perAcVerdicts[]",
+  "implementsAcIds": [
+    "AC-1601-3"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T16:25:43.709Z",
+  "updatedAt": "2026-09-04T16:25:43.709Z"
+}

package/rcf/code-nodes/cn-104.json

@@ -0,0 +1,13 @@
+{
+  "cnId": "CN-104",
+  "path": "src/eval/judge.js#runOneCase",
+  "title": "eval/judge.js: runOneCase spawns claude (or codex) with -p system-prompt, sends per-case payload on stdin, validates response, returns graded envelope",
+  "implementsAcIds": [
+    "AC-1601-4"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T16:25:43.873Z",
+  "updatedAt": "2026-09-04T16:25:43.873Z"
+}

package/rcf/code-nodes/cn-105.json

@@ -0,0 +1,13 @@
+{
+  "cnId": "CN-105",
+  "path": "src/eval/judge.js#composeRunRecord",
+  "title": "eval/judge.js: composeRunRecord aggregates perCriterion scores, applies criticalMustPass, resolves pass/fail verdict",
+  "implementsAcIds": [
+    "AC-1601-4"
+  ],
+  "dependencies": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T16:25:44.037Z",
+  "updatedAt": "2026-09-04T16:25:44.037Z"
+}

package/rcf/evals/eval-001.json

@@ -0,0 +1,55 @@
+{
+  "id": "EVAL-001",
+  "usId": "US-1601",
+  "acIds": ["AC-1601-4"],
+  "title": "LLM-as-judge invocation shape: enum-guarded invoker, valid response envelope, honest verdict rollup",
+  "purpose": "Grades whether the LLM-as-judge run path returns a graded envelope that reads as trustworthy (aggregate score corresponds to the graded criteria, criticalFailures reflect declared critical criteria that failed, invoker was on the {claude, codex} enum, no HTTP-API call fingerprints in the recorded runRecord notes). The observable output of the judge invocation is non-deterministic (an LLM grader's rationale prose changes run to run) so TS/TC coverage alone cannot certify the shape: an EVAL is the honest peer contract. AC-1601-4 declares determinism nonDeterministic for this reason.",
+  "criteria": [
+    {
+      "id": "invoker-enum",
+      "description": "the invoker recorded on the run was 'claude' or 'codex' (subscription-only rule holds); no API key or HTTP anthropic.com fingerprint appears in stderr or notes",
+      "critical": true
+    },
+    {
+      "id": "response-envelope",
+      "description": "the graded response validated against judge.harness.responseSchemaPath and carries a numeric aggregateScore between 0 and 1 with a perCriterion array"
+    },
+    {
+      "id": "verdict-honesty",
+      "description": "the resolved verdict is 'pass' when the aggregate meets threshold and no critical criterion failed; 'fail' otherwise; 'pending' is not accepted as the final verdict on a completed run"
+    }
+  ],
+  "cases": [
+    {
+      "id": "smoke-shape",
+      "input": {
+        "prompt": "grade this greeting on the criteria",
+        "criteria": ["invoker-enum", "response-envelope", "verdict-honesty"]
+      },
+      "notes": "one graded case is enough to certify the shape; a real train would carry a case per scenario"
+    }
+  ],
+  "judge": {
+    "type": "rubric"
+  },
+  "passThreshold": {
+    "aggregateScore": 0.8,
+    "criticalMustPass": true
+  },
+  "runRecord": [
+    {
+      "runId": "2026-09-04T16:25:00Z-hand-authored",
+      "runAt": "2026-09-04T16:25:00Z",
+      "runner": "hand-authored, seeded from unit suite outcomes",
+      "aggregateScore": 1.0,
+      "criticalFailures": [],
+      "perCaseScores": [
+        { "caseId": "smoke-shape", "score": 1.0 }
+      ],
+      "verdict": "pass"
+    }
+  ],
+  "status": "approved",
+  "createdAt": "2026-09-04T16:25:00Z",
+  "updatedAt": "2026-09-04T16:25:00Z"
+}

package/rcf/fbs/fbs-028.json

@@ -0,0 +1,27 @@
+{
+  "fbsId": "FBS-028",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 28,
+  "executionStatus": "verified",
+  "title": "observability-logging v1.0.0 shelf blueprint (contributions + README + guide + docs/topics.md + assets), applies clean into a fresh fixture",
+  "summary": "Core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). Covers the AC set above end to end through the shipped code paths named on the paired CN implementsAcIds[] and the paired TS testPointer entries under packages/rcf-lite/test/. Runtime provenance: Node 24.14.0 on the repo's dogfood tree; each fixture verified in scratchpad. See the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md.",
+  "acIds": [
+    "AC-1301-1",
+    "AC-1301-2",
+    "AC-1301-3"
+  ],
+  "dependsOnFbsIds": [
+    "FBS-027"
+  ],
+  "contextRequirements": {
+    "tacIds": [],
+    "adrIds": []
+  },
+  "domain": "blueprints",
+  "estimatedSize": "small",
+  "riskLevel": "low",
+  "notes": "Part of the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). One FBS per US on REQ-013/014/015.",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/fbs/fbs-029.json

@@ -0,0 +1,27 @@
+{
+  "fbsId": "FBS-029",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 29,
+  "executionStatus": "verified",
+  "title": "application-error-handling v1.0.0 shelf blueprint (contributions + README + guide + docs/topics.md + assets); errorHandling topic distinct from errorEnvelope",
+  "summary": "Core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). Covers the AC set above end to end through the shipped code paths named on the paired CN implementsAcIds[] and the paired TS testPointer entries under packages/rcf-lite/test/. Runtime provenance: Node 24.14.0 on the repo's dogfood tree; each fixture verified in scratchpad. See the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md.",
+  "acIds": [
+    "AC-1302-1",
+    "AC-1302-2",
+    "AC-1302-3"
+  ],
+  "dependsOnFbsIds": [
+    "FBS-028"
+  ],
+  "contextRequirements": {
+    "tacIds": [],
+    "adrIds": []
+  },
+  "domain": "blueprints",
+  "estimatedSize": "small",
+  "riskLevel": "low",
+  "notes": "Part of the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). One FBS per US on REQ-013/014/015.",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/fbs/fbs-030.json

@@ -0,0 +1,27 @@
+{
+  "fbsId": "FBS-030",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 30,
+  "executionStatus": "verified",
+  "title": "Loader accepts providesRoles[] and suggestedCompanions[] with shape validation + em-dash / emoji refusal on reason strings + paired-scope:global-ADR gate",
+  "summary": "Core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). Covers the AC set above end to end through the shipped code paths named on the paired CN implementsAcIds[] and the paired TS testPointer entries under packages/rcf-lite/test/. Runtime provenance: Node 24.14.0 on the repo's dogfood tree; each fixture verified in scratchpad. See the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md.",
+  "acIds": [
+    "AC-1401-1",
+    "AC-1401-2",
+    "AC-1401-3"
+  ],
+  "dependsOnFbsIds": [
+    "FBS-029"
+  ],
+  "contextRequirements": {
+    "tacIds": [],
+    "adrIds": []
+  },
+  "domain": "blueprints",
+  "estimatedSize": "small",
+  "riskLevel": "low",
+  "notes": "Part of the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). One FBS per US on REQ-013/014/015.",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/fbs/fbs-031.json

@@ -0,0 +1,27 @@
+{
+  "fbsId": "FBS-031",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 31,
+  "executionStatus": "verified",
+  "title": "rcf define blueprint add prints resolved companion suggestions after apply; --companion selectors preflight-refuse non-providers; --no-companion-suggestions suppresses both phases; pins land in rcf/companions.json",
+  "summary": "Core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). Covers the AC set above end to end through the shipped code paths named on the paired CN implementsAcIds[] and the paired TS testPointer entries under packages/rcf-lite/test/. Runtime provenance: Node 24.14.0 on the repo's dogfood tree; each fixture verified in scratchpad. See the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md.",
+  "acIds": [
+    "AC-1402-1",
+    "AC-1402-2",
+    "AC-1402-3"
+  ],
+  "dependsOnFbsIds": [
+    "FBS-030"
+  ],
+  "contextRequirements": {
+    "tacIds": [],
+    "adrIds": []
+  },
+  "domain": "blueprints",
+  "estimatedSize": "small",
+  "riskLevel": "low",
+  "notes": "Part of the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). One FBS per US on REQ-013/014/015.",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/fbs/fbs-032.json

@@ -0,0 +1,27 @@
+{
+  "fbsId": "FBS-032",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 32,
+  "executionStatus": "verified",
+  "title": "rcf define blueprint companions <slug>|set|unset sub-verbs (text output with origin annotations; --json envelope; set/unset round-trip; unset without pin refuses)",
+  "summary": "Core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). Covers the AC set above end to end through the shipped code paths named on the paired CN implementsAcIds[] and the paired TS testPointer entries under packages/rcf-lite/test/. Runtime provenance: Node 24.14.0 on the repo's dogfood tree; each fixture verified in scratchpad. See the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md.",
+  "acIds": [
+    "AC-1403-1",
+    "AC-1403-2",
+    "AC-1403-3"
+  ],
+  "dependsOnFbsIds": [
+    "FBS-031"
+  ],
+  "contextRequirements": {
+    "tacIds": [],
+    "adrIds": []
+  },
+  "domain": "blueprints",
+  "estimatedSize": "small",
+  "riskLevel": "low",
+  "notes": "Part of the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). One FBS per US on REQ-013/014/015.",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/fbs/fbs-033.json

@@ -0,0 +1,27 @@
+{
+  "fbsId": "FBS-033",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 33,
+  "executionStatus": "verified",
+  "title": "Deterministic tier ladder resolver (applied > pinned > registered library > shelf); two-libraries-one-role refuses exit 3 with three-path resolution message on both add and companions verb; validate refuses unresolvable pin exit 3",
+  "summary": "Core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). Covers the AC set above end to end through the shipped code paths named on the paired CN implementsAcIds[] and the paired TS testPointer entries under packages/rcf-lite/test/. Runtime provenance: Node 24.14.0 on the repo's dogfood tree; each fixture verified in scratchpad. See the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md.",
+  "acIds": [
+    "AC-1404-1",
+    "AC-1404-2",
+    "AC-1404-3"
+  ],
+  "dependsOnFbsIds": [
+    "FBS-032"
+  ],
+  "contextRequirements": {
+    "tacIds": [],
+    "adrIds": []
+  },
+  "domain": "blueprints",
+  "estimatedSize": "small",
+  "riskLevel": "low",
+  "notes": "Part of the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). One FBS per US on REQ-013/014/015.",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/fbs/fbs-034.json

@@ -0,0 +1,27 @@
+{
+  "fbsId": "FBS-034",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 34,
+  "executionStatus": "verified",
+  "title": "Loader accepts standardsTrace[] + per-ADR recommendedDefault / elicited / standardsTraceClause; refuses missing standardsTraceClause when standardsTrace is declared; no cross-check on clause severity to kind (amendment A2)",
+  "summary": "Core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). Covers the AC set above end to end through the shipped code paths named on the paired CN implementsAcIds[] and the paired TS testPointer entries under packages/rcf-lite/test/. Runtime provenance: Node 24.14.0 on the repo's dogfood tree; each fixture verified in scratchpad. See the spec at projects/rcf-lite-wsd/specs/rcf-lite-core-companions-spec-2026-09-04.md.",
+  "acIds": [
+    "AC-1501-1",
+    "AC-1501-2",
+    "AC-1501-3"
+  ],
+  "dependsOnFbsIds": [
+    "FBS-033"
+  ],
+  "contextRequirements": {
+    "tacIds": [],
+    "adrIds": []
+  },
+  "domain": "blueprints",
+  "estimatedSize": "small",
+  "riskLevel": "low",
+  "notes": "Part of the core companions train (w-2026-09-03-dave-030, d-2026-09-04-022). One FBS per US on REQ-013/014/015.",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/fbs/fbs-035.json

@@ -0,0 +1,18 @@
+{
+  "createdAt": "2026-09-04T16:22:49.426Z",
+  "updatedAt": "2026-09-04T17:20:42.095Z",
+  "acIds": [
+    "AC-1601-1",
+    "AC-1601-2",
+    "AC-1601-3",
+    "AC-1601-4"
+  ],
+  "fbsId": "FBS-035",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 35,
+  "executionStatus": "notStarted",
+  "title": "rcf-lite consumer wiring for the rcf-schemas 0.6.0 EVAL node (L1 audit / L2 verdict / L3 finalise / L4 define + judge)",
+  "summary": "Consumer wiring for the rcf-schemas 0.6.0 EVAL node across four tracks: L1 audits EVAL coverage on the tree, L2 folds EVAL-MISSING and EVAL-BELOW-THRESHOLD into per-AC verdicts on the verify report, L3 gates finalise on EVAL refusals with an opt-out via --ship-without-eval, and L4 lands rcf define --determinism plus the judge invocation module.",
+  "dependsOnFbsIds": []
+}

package/rcf/requirements/req-013.json

@@ -0,0 +1,22 @@
+{
+  "reqId": "REQ-013",
+  "prdId": "PRD-001",
+  "title": "Core shelf gains two general-enterprise-practice companion blueprints: observability-logging and application-error-handling",
+  "description": "The shipped core shelf carries two new blueprints written to general enterprise practice, not to any one organisation's standards. `observability-logging` v1.0.0 (category `observability`, US band 15101-15899, ADR/TAC suffix block 16xx) contributes REQs, USs, TACs and ADRs for a structured single-line JSON emission surface with a correlation-identifier propagation contract, a redaction boundary anchored to named PII categories, an operator-elicited level vocabulary, and an environment/service-name/service-version stamping contract. Its `providesRoles` field carries `[\"logging\"]` and its ADR-1601 mints the shelf-wide `logging` global topic (transferred from `application-api-rest-ADR-304`, retained there as a superseded record per version-rule discipline). `application-error-handling` v1.0.0 (category `application`, US band 16101-16899, ADR/TAC suffix block 17xx) contributes REQs, USs, TACs and ADRs for the uncaught-exception boundary, the internal error record shape (code, category, message, correlation identifier, cause chain, redacted context), a transient/permanent/unknown classification vocabulary, and error emission delegated through the logging companion. Its `providesRoles` carries `[\"errorHandling\"]` and its ADR-1701 mints the `errorHandling` global topic (distinct from `errorEnvelope`, which stays with `application-api-rest` as the REST wire shape). Both blueprints ship the same anatomy every shipped shelf blueprint teaches: `blueprint.json` + `contributions/` + `README.md` + `guide/<slug>.md` + `docs/topics.md` + `assets/`; every AC is runtime-observable through a stdout capture, a filesystem-write observer, or a stubbed transport.",
+  "category": "functional",
+  "domain": "blueprints",
+  "priority": "must",
+  "rationale": "The core shelf carried no logging or error-handling blueprint before this train; every WSD-facing service blueprint (Dex's `wsd-api-rest`) stated its companion suggestions in prose only, with no core fallback for projects that had not registered the WSD library. Baz on 2026-09-03 during the WSD blueprint round review ratified two decisions in one clause: the core shelf carries a `logging` and an `error-handling` blueprint written to general enterprise practice (not to any one organisation's standards), and a companion-suggestion mechanism (REQ-014) surfaces them at apply time. Shipping the two blueprints as general-enterprise-practice siblings of the WSD library halves means every project falls back to a sensible logging and error-handling contract without adopting a library, and the WSD library becomes a specialisation (adds `standardsTrace[]`, adds WSD-specific ADR clauses) that the mechanism resolves in preference to the core when the library is registered.",
+  "tags": [
+    "blueprints",
+    "observability",
+    "logging",
+    "error-handling",
+    "companions",
+    "shelf"
+  ],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/requirements/req-014.json

@@ -0,0 +1,22 @@
+{
+  "reqId": "REQ-014",
+  "prdId": "PRD-001",
+  "title": "Companion-suggestion mechanism: additive manifest fields, deterministic resolution rule, `rcf define blueprint companions` verb, refusal shapes, project-level pin file, agent-facing paragraph",
+  "description": "The blueprint mechanism gains a suggestion channel that a service blueprint uses to name the companion roles it recommends alongside itself, and the loader resolves each role deterministically. Two additive optional top-level fields land on `blueprint.json`: `providesRoles[]` names the roles a blueprint provides (lower camelCase strings on `^[a-z][a-zA-Z0-9]*$`); a blueprint declaring a role MUST also carry the paired `scope: global` ADR on the topic string the role names (a `logging` role carries a `scope: global, topic: logging` ADR; a `errorHandling` role carries `scope: global, topic: errorHandling`). `suggestedCompanions[]` is a non-empty array of `{role, reason}` objects the service blueprint recommends. The resolution rule walks a deterministic tier ladder for each suggested role: applied provider wins first (already resolved at apply time), then registered library provider (`rcf/blueprint-libraries.json`), then core-shelf provider. A single library candidate wins over the shelf candidate; two library candidates for one role refuses at apply and at `rcf define blueprint companions` with exit 3 and a three-path resolution message (explicit `--companion` selector, project-level pin, or removing one library). A `--companion <role>=<slug>` selector on `rcf define blueprint add` accepts `<libraryPrefix>:<slug>` or a bare shelf slug and writes the choice to `rcf/companions.json`; naming a slug that does not declare the role refuses exit 2. A project-level `rcf/companions.json` (schemaVersion 1, current pin only per amendment A1, no per-apply history, no severity field) records role-to-provider pinnings; `rcf define blueprint companions set|unset` writes and removes pins; the file rides git. `rcf define validate` refuses exit 3 when a pinned role names an unresolvable provider. The apply-time suggestion block prints after `rcf define blueprint add` succeeds and is suppressible with `--no-companion-suggestions`. The three surfaces (apply-time block, `rcf define blueprint companions <slug>` verb, `rcf define blueprint list` annotation for suggested-but-not-applied companions) render the same resolution through a single loader function. A paragraph on the managed agent-instructions block's `How to talk to your operator` section (regenerated via `scripts/gen-managed-artefacts.mjs`) tells the agent to surface resolved companions verbally without picking. The mechanism is suggestion, never compulsion: a blueprint that declares `suggestedCompanions: [\"logging\"]` still applies cleanly with no logging blueprint present. Backward-compatible: a blueprint that does not declare `suggestedCompanions[]` produces an empty resolution and prints no block.",
+  "category": "functional",
+  "domain": "blueprints",
+  "priority": "must",
+  "rationale": "Before this train, service blueprints named their companion suggestions in prose in each README and each guide, and the machine could not act on them: `rcf define blueprint add` could not print a suggestion, `rcf define blueprint list` could not annotate an outstanding one, the agent could not know which library provider to prefer, and the operator had no place to record a project-level choice that outlived any single apply. Baz on 2026-09-03 during the WSD blueprint round review ratified the mechanism in the same clause as the two new core blueprints: the mechanism surfaces the suggestion three ways from one resolution rule, the agent surfaces the resolved companions verbally, and the operator adopts explicitly. Suggestion by role (not by slug) is the load-bearing choice: a service blueprint ships once and works with every library that provides the role; the operator's opt-in to a library IS the choice the resolution rule records.",
+  "tags": [
+    "blueprints",
+    "companions",
+    "provides-roles",
+    "suggested-companions",
+    "resolution",
+    "pin"
+  ],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}

package/rcf/requirements/req-015.json

@@ -0,0 +1,21 @@
+{
+  "reqId": "REQ-015",
+  "prdId": "PRD-001",
+  "title": "Standards-derived-blueprint discipline: authoring standard section 8a, additive contribution fields, load-time validation",
+  "description": "The blueprint-authoring standard gains a section 8a that names the standards-derived discipline for any blueprint that composes on an organisational or industry standard: MUST clauses become ACs where the clause binds a testable runtime or artefact behaviour; a MUST that binds an operator choice (choice-shaped) may land as a `recommendedDefault: true` ADR carrying the clause id on `standardsTraceClause`; not-carried rows stay allowed with a named reason (per amendment A2, Baz 2026-09-04T12:20:31Z). SHOULD clauses become recommended ADR defaults (`recommendedDefault: true`) with the elicited-parameter alternative documented in the ADR's consequences. MAY clauses become elicited ADR choices (`elicited: true`) that the applying operator supplies at apply. Three additive optional ADR-contribution fields on `blueprint.json`: `recommendedDefault: true` marks the ADR as a SHOULD (or a choice-shaped MUST); `elicited: true` marks the ADR as taking an operator-supplied value at apply; `standardsTraceClause` records the standard clause identifier verbatim (`WSD-001 clause 3.1`, `RFC 7807 section 3.1`) or the sentinel `\"generic enterprise practice\"` for the neutral shelf blueprints. `recommendedDefault` and `elicited` are mutually independent. One additive blueprint-level field: `standardsTrace[]` is a list of `{id, version}` objects naming the standards the blueprint composes; optional; a blueprint that ships without it is a general-enterprise-practice blueprint by default. Load-time validation: if `standardsTrace[]` is set, every ADR contribution MUST carry a non-null `standardsTraceClause` (refusal shape: `blueprint '<slug>' declares standardsTrace but ADR contribution '<id>' has no standardsTraceClause; every ADR must reference a standard clause or the sentinel 'generic enterprise practice'.`); no cross-check on clause severity to kind mapping (that discipline is prose, not code). The discipline lands the moment a blueprint declares `standardsTrace[]`; zero shelf blueprints declare it today (the two new core blueprints in REQ-013 are general enterprise practice). Dex's WSD library at 0.9.1 already ships standards-trace tables that this discipline formalises.",
+  "category": "functional",
+  "domain": "blueprints",
+  "priority": "must",
+  "rationale": "Dex's WSD library composes on the WSD-001 through WSD-012 standards with clause-level trace tables under `docs/standards-trace.md`. Before this train, the trace lived in prose only, and a library blueprint's ADR could omit any standard reference without the loader noticing. Baz on 2026-09-03 during the WSD blueprint round review ratified the discipline as `really good idea` and made it the shelf standard for any future library or shipped blueprint that composes on named standards. Baz amendment A2 (2026-09-04T12:20:31Z) refined the MUST-to-kind mapping to admit choice-shaped MUSTs as ADRs so the WSD library's 41 MUSTs (27 to AC, 8 to ADR, 8 not-carried per Dex's tables) fit under the discipline without renumbering. The additive fields and load-time validation give machine-checkable adherence without changing any existing blueprint (zero shelf blueprints declare `standardsTrace[]` today).",
+  "tags": [
+    "blueprints",
+    "authoring",
+    "standards",
+    "traceability",
+    "loader"
+  ],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-09-04T12:20:00Z",
+  "updatedAt": "2026-09-04T12:20:00Z"
+}