@stravica-ai/rcf-schemas 0.4.3 → 0.4.5

package/CHANGELOG.md

@@ -4,6 +4,50 @@ All notable changes to `@stravica-ai/rcf-schemas` are documented in this file.
 
 The format roughly follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Pre-1.0 breaking changes are signalled by a minor bump per semver 0.x convention.
 
+## 0.4.5 - 2026-08-19
+
+Additive patch bump for the blueprint conflict-resolution mechanism landing in `rcf-lite` Phase 3.5. Adds the schema seam the `rcf blueprint supersede` and `rcf blueprint add --resolve` verbs key to, so a project can record an operator ruling that resolves a cross-blueprint conflict on a scope:global ADR topic. Every change is additive: every 0.4.4-valid document remains valid, and every existing id continues to validate byte-for-byte.
+
+### Added
+
+- **`manifest.schema.json`**: new optional `resolutions[]` at top level, items `$defs.blueprintConflictResolution`. One entry per operator-authored resolution of a cross-blueprint conflict. Fields: `id` (`^res-YYYY-MM-DD-NNN$`), `createdAt`, `kind` (single-valued enum `globalAdrTopic`; the enum is deliberately single-valued so later minor bumps can add further resolution classes additively without breaking existing consumers), `topic` (the topic key the resolution applies to, matching both superseded blueprint ADRs), `resolvedByAdrId` (the project-level ADR id that supersedes the blueprint ADRs), `supersedes[]` (min 2 items, each `{ slug: blueprintSlug, adrId: string }`), and optional `reason` (operator note). Written by `rcf blueprint supersede` and `rcf blueprint add --resolve`; read by the conflict detector so a would-be conflict on a resolved topic is honoured and both blueprint ADRs may co-reside as superseded history.
+- Fixtures (valid): `fixtures/valid/manifest/manifest-012-blueprint-topic-resolution.json` (two applied blueprints whose global auth ADRs collide, resolved by a project-level ADR that supersedes both).
+- Fixtures (invalid): `fixtures/invalid/manifest/manifest-020-resolution-bad-id.json` (resolution id in the wrong shape), `fixtures/invalid/manifest/manifest-021-resolution-single-supersedes.json` (supersedes[] with a single entry, violating minItems 2).
+- Tests: `resolutions[]` cases added to `manifest.test.js` covering the happy path (required fields, with reason, three superseded ADRs, additive composition alongside `blueprints[]` and `standards[]`), the reject-cases (bad id shape, missing required fields, unknown kind, `supersedes[]` minItems 2, uppercase slug in a `supersedes[]` entry, missing `adrId`, and an unrecognised additional property under `additionalProperties: false`), plus a pre-0.4.5 back-compat case that keeps a `blueprints[]`+`standards[]` manifest with no `resolutions[]` valid.
+
+### Notes
+
+- Additive-only: every 0.4.4-valid document remains valid. The prior `blueprints[]` + `standards[]` shape is untouched.
+- `back-compat-freeze.test.js` (added in 0.4.4) continues to assert the frozen pre-0.4.3 chain snapshot validates byte-for-byte; the 0.4.5 additions are new-fields-only and cannot affect existing document bytes.
+- Canonical `$id` URLs stay at `v0.4.0`, following the patch-release precedent set at 0.2.1, 0.3.1, 0.4.1, 0.4.2, 0.4.3, and 0.4.4.
+- Version choice: additive change, no existing document invalidated, no shape widened destructively — per repo precedent this bumps `0.4.4 -> 0.4.5` as a patch.
+
+## 0.4.4 - 2026-08-18
+
+Additive patch bump for the blueprint-library mechanism landing in `rcf-build-lite`. Unblocks Phase 1 of the blueprint programme (`w-2026-08-18-016`) by adding the schema seams the mechanism keys to. Every change is additive: every 0.4.3-valid document remains valid, and every existing id continues to validate byte-for-byte.
+
+### Added
+
+- **`common.schema.json`**: new `$defs.blueprintSlug` and `$defs.standardSlug`, both `^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$`. Shared shape for blueprint and standards-pack slugs; referenced from `manifest.blueprints[]`, `manifest.standards[]`, and `fbs.contextRequirements.standardIds`.
+- **`manifest.schema.json`**: new optional `blueprints[]` at top level, items `$defs.appliedBlueprintRecord` (slug, version, appliedAt, source, optional namespace, optional contributions[] listing every doc id + path the blueprint contributed). Written by the `rcf blueprint` verb family (`add` on clean apply, `upgrade` on re-apply, `remove` deletes the entry). Composition (multiple applied blueprints) is expressed by multiple entries.
+- **`manifest.schema.json`**: new optional `standards[]` at top level, items `$defs.standardsPackRecord` (id `^std-<slug>$`, slug, sourcePath, optional copyPath, tags[], optional summary, `testsProvidedBy` = `standard | agent | none`, `provenance` = `personal | corporate`). Records standards-pack registrations from `rcf init` and `rcf standards add`. `copyPath` is present only when the source lived outside the project root at registration time.
+- **`fbs.schema.json`**: new optional `contextRequirements.standardIds[]`, items reference `common.standardSlug`. Host for the bundle assembler's agentic selective-retrieval step; an operator-authored value overrides the agentic selection.
+- Fixtures (valid): `fixtures/valid/manifest/manifest-008-blueprints-registered.json` (two applied blueprints, one with contributions[]), `fixtures/valid/manifest/manifest-009-standards-in-repo.json` (in-repo standards pack, no copyPath), `fixtures/valid/manifest/manifest-010-standards-copied-in.json` (out-of-root pack with copyPath), `fixtures/valid/fbs/fbs-007-standard-ids.json` (FBS with agentically-populated standardIds), `fixtures/valid/req/req-002-slug-prefix.json`, `fixtures/valid/user-story/us-005-slug-prefix.json`, `fixtures/valid/prd/prd-002-slug-prefix.json`, `fixtures/valid/build-sequence/bs-002-slug-prefix.json`, `fixtures/valid/tad/tad-002-slug-prefix.json`, `fixtures/valid/test-suite/ts-005-slug-prefix.json`, plus `fixtures/valid/manifest/manifest-011-preblueprint-chain-frozen.json` (frozen pre-0.4.3 chain snapshot used by the byte-for-byte back-compat test).
+- Fixtures (invalid): `fixtures/invalid/manifest/manifest-018-blueprint-bad-slug.json`, `fixtures/invalid/manifest/manifest-019-standards-bad-id.json`, `fixtures/invalid/fbs/fbs-013-standard-ids-non-slug.json`, `fixtures/invalid/req/req-003-slug-prefix-uppercase.json`, `fixtures/invalid/user-story/us-005-slug-prefix-trailing-hyphen.json`.
+- Tests: prefix-id cases added to `req.test.js`, `user-story.test.js`, `prd.test.js`, `build-sequence.test.js`, `tad.test.js`, `test-suite.test.js`; blueprints[] and standards[] cases added to `manifest.test.js`; contextRequirements.standardIds cases added to `fbs.test.js`; new `back-compat-freeze.test.js` asserts the frozen pre-0.4.3 chain snapshot validates byte-for-byte (sha256 pin).
+
+### Changed
+
+- **`common.schema.json`**: `prdId`, `reqId`, `usId`, `bsId`, `tadId`, `tsId` patterns widened to accept an optional lowercase kebab-slug prefix, `^([a-z][a-z0-9]*(?:-[a-z0-9]+)*-)?<PREFIX>-\d{3,}$`. Numeric-only ids continue to validate unchanged. Slug prefixes are well-formed kebab (leading letter, lowercase alnum segments joined by single hyphens; leading, trailing, and double hyphens are rejected).
+
+### Notes
+
+- Additive-only: every 0.4.3-valid document remains valid byte-for-byte. `back-compat-freeze.test.js` proves this with a hash-pinned fixture read as raw bytes.
+- Id grammar is now mixed across types: **prefix** for REQ/US/PRD/BS/TAD/TS (this bump), **suffix** for ADR/TAC/FBS/CN (already the shape from 0.4.3). This is a minimal-delta choice tonight to unblock the blueprint mechanism without churning the four types whose suffix affordance already namespaces them. Unifying the grammar is a schemas follow-up; the mixed grammar is documented and the working tools accept both.
+- The `acId` and `tcId` patterns are intentionally left unchanged. AC/TC ids are anchored to their parent US/TS chain, whose ids now carry the slug prefix; adding a redundant prefix on ACs and TCs was out of scope for tonight and adds no expressiveness.
+- Canonical `$id` URLs stay at `v0.4.0`, following the patch-release precedent set at 0.2.1, 0.3.1, 0.4.1, 0.4.2, and 0.4.3.
+- Version choice: per repo precedent (every prior additive change since 0.2.0 has bumped as a **patch**: 0.2.1, 0.3.1, 0.4.1, 0.4.2, 0.4.3), this bumps `0.4.3 -> 0.4.4`. Dave's Path A brief allowed for a minor bump if the repo convention read pattern-widening as minor; the repo convention does not: the 0.4.3 pattern-widening bump was itself a patch. Precedent wins.
+
 ## 0.4.3 - 2026-08-12
 
 Additive patch bump: car 1 of the `rcf-lite` 0.8.0 slug-train. Widens four id patterns to accept an optional kebab-case slug tail (per the slug design ratified on `w-2026-07-28-012`), widens the TS and TC id patterns to drop the 999 cap, adds a shared scope-tag vocabulary in `common.schema.json`, and exposes an optional `scope` field on ACs and TCs. Every change is additive; every existing id and every existing document continues to validate.

package/docs/id-conventions.md

@@ -26,6 +26,22 @@ Both forms remain valid: `FBS-004` and `FBS-004-user-login` both validate. Exist
 
 Rationale: parallel authoring on branches can allocate the same number for different titles. The slug makes those distinct addresses at the filesystem and id layer, converting an add/add merge conflict into a clean co-existence. See the `rcf-lite` slug-train design for the full argument.
 
+## Optional slug prefix (0.4.4) — blueprint namespacing
+
+Six families accept an optional kebab-case slug **prefix**: `PRD`, `REQ`, `US`, `BS`, `TAD`, `TS`. The full pattern is:
+
+```
+^([a-z][a-z0-9]*(?:-[a-z0-9]+)*-)?<PREFIX>-\d{3,}$
+```
+
+The prefix is a blueprint's slug (or any well-formed kebab slug) followed by a hyphen. Examples: `spa-REQ-001`, `spa-US-101`, `rest-BS-001`, `my-blueprint-TAD-002`. Existing numeric-only ids continue to validate; the prefix is purely opt-in.
+
+This unblocks the blueprint mechanism landing in `rcf-build-lite`: blueprint-contributed docs carry the blueprint's slug as a namespace so multiple applied blueprints cannot collide on ids and every trace query names the provenance visibly.
+
+**Mixed grammar (intentional, minimal-delta):** ADR/TAC/FBS/CN carry the slug in the **suffix** (0.4.3); PRD/REQ/US/BS/TAD/TS carry it in the **prefix** (0.4.4). ADR/TAC/FBS/CN were left untouched at 0.4.4 because their suffix affordance already namespaces blueprint contributions (`TAC-002-spa-tokens`, `ADR-005-rest-versioning`). Unifying the grammar is a schemas follow-up; the mixed grammar is documented and working tools accept both.
+
+**Not extended:** `AC` and `TC` ids keep the numeric-only + AC-hierarchical / TC-slug forms. AC/TC ids are anchored to their parent US/TS chain, whose ids now carry the slug prefix; adding a redundant prefix on ACs and TCs adds no expressiveness.
+
 ## Prefix table
 
 | Prefix | Document | File? | Where defined |

package/fixtures/invalid/fbs/fbs-013-standard-ids-non-slug.json

@@ -0,0 +1,16 @@
+{
+  "fbsId": "FBS-014",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 14,
+  "executionStatus": "notStarted",
+  "title": "Bad standardIds shape",
+  "summary": "standardIds carries an uppercase entry that is not a valid slug.",
+  "acIds": ["AC-001"],
+  "dependsOnFbsIds": [],
+  "contextRequirements": {
+    "standardIds": ["WSD-Naming"]
+  },
+  "createdAt": "2026-08-18T00:00:00Z",
+  "updatedAt": "2026-08-18T00:00:00Z"
+}

package/fixtures/invalid/manifest/manifest-018-blueprint-bad-slug.json

@@ -0,0 +1,15 @@
+{
+  "version": "2.0.0",
+  "projectName": "Invalid blueprint slug",
+  "prd": { "id": "PRD-001", "path": "rcf/prd.json" },
+  "tad": { "id": "TAD-001", "path": "rcf/tad.json" },
+  "bs":  { "id": "BS-001",  "path": "rcf/build-sequence.json" },
+  "blueprints": [
+    {
+      "slug": "SPA",
+      "version": "1.0.0",
+      "appliedAt": "2026-08-18T10:00:00Z",
+      "source": "@stravica-ai/rcf-blueprint-spa@1.0.0"
+    }
+  ]
+}

package/fixtures/invalid/manifest/manifest-019-standards-bad-id.json

@@ -0,0 +1,17 @@
+{
+  "version": "2.0.0",
+  "projectName": "Invalid standards id",
+  "prd": { "id": "PRD-001", "path": "rcf/prd.json" },
+  "tad": { "id": "TAD-001", "path": "rcf/tad.json" },
+  "bs":  { "id": "BS-001",  "path": "rcf/build-sequence.json" },
+  "standards": [
+    {
+      "id": "wsd-naming",
+      "slug": "wsd-naming",
+      "sourcePath": "docs/standards/wsd-naming",
+      "tags": ["naming"],
+      "testsProvidedBy": "agent",
+      "provenance": "corporate"
+    }
+  ]
+}

package/fixtures/invalid/manifest/manifest-020-resolution-bad-id.json

@@ -0,0 +1,20 @@
+{
+  "version": "2.0.0",
+  "projectName": "Bad resolution id",
+  "prd": { "id": "PRD-001", "path": "rcf/prd.json" },
+  "tad": { "id": "TAD-001", "path": "rcf/tad.json" },
+  "bs":  { "id": "BS-001",  "path": "rcf/build-sequence.json" },
+  "resolutions": [
+    {
+      "id": "resolution-1",
+      "createdAt": "2026-08-19T10:15:00Z",
+      "kind": "globalAdrTopic",
+      "topic": "auth",
+      "resolvedByAdrId": "ADR-042",
+      "supersedes": [
+        { "slug": "spa",  "adrId": "ADR-005-spa" },
+        { "slug": "rest", "adrId": "ADR-003-rest" }
+      ]
+    }
+  ]
+}

package/fixtures/invalid/manifest/manifest-021-resolution-single-supersedes.json

@@ -0,0 +1,19 @@
+{
+  "version": "2.0.0",
+  "projectName": "Resolution with a single supersedes entry (minItems 2 violation)",
+  "prd": { "id": "PRD-001", "path": "rcf/prd.json" },
+  "tad": { "id": "TAD-001", "path": "rcf/tad.json" },
+  "bs":  { "id": "BS-001",  "path": "rcf/build-sequence.json" },
+  "resolutions": [
+    {
+      "id": "res-2026-08-19-001",
+      "createdAt": "2026-08-19T10:15:00Z",
+      "kind": "globalAdrTopic",
+      "topic": "auth",
+      "resolvedByAdrId": "ADR-042",
+      "supersedes": [
+        { "slug": "spa", "adrId": "ADR-005-spa" }
+      ]
+    }
+  ]
+}

package/fixtures/invalid/req/req-005-slug-prefix-uppercase.json

@@ -0,0 +1,13 @@
+{
+  "reqId": "SPA-REQ-001",
+  "prdId": "PRD-001",
+  "title": "Uppercase slug prefix must be rejected",
+  "description": "Slug prefixes are lowercase kebab; upper-case must fail.",
+  "category": "functional",
+  "domain": "ui",
+  "priority": "must",
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-08-18T00:00:00Z",
+  "updatedAt": "2026-08-18T00:00:00Z"
+}

package/fixtures/invalid/user-story/us-005-slug-prefix-trailing-hyphen.json

@@ -0,0 +1,20 @@
+{
+  "usId": "spa--US-101",
+  "prdId": "PRD-001",
+  "reqId": "REQ-001",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Double-hyphen slug prefix must be rejected",
+  "asA": "user",
+  "iWant": "to see this fail",
+  "soThat": "the slug grammar rejects double hyphens",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-001",
+      "description": "n/a",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-08-18T00:00:00Z",
+  "updatedAt": "2026-08-18T00:00:00Z"
+}

package/fixtures/valid/build-sequence/bs-002-slug-prefix.json

@@ -0,0 +1,8 @@
+{
+  "bsId": "spa-BS-001",
+  "prdId": "PRD-001",
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-08-18T00:00:00Z",
+  "updatedAt": "2026-08-18T00:00:00Z"
+}

package/fixtures/valid/fbs/fbs-007-standard-ids.json

@@ -0,0 +1,18 @@
+{
+  "fbsId": "FBS-014",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 14,
+  "executionStatus": "notStarted",
+  "title": "Wire error envelope on the POST /users endpoint",
+  "summary": "Introduce the RFC 7807 problem-details envelope on the POST /users error paths.",
+  "acIds": ["AC-014-1", "AC-014-2"],
+  "dependsOnFbsIds": [],
+  "contextRequirements": {
+    "tacIds": ["TAC-002-error-envelope"],
+    "adrIds": ["ADR-004-rfc7807"],
+    "standardIds": ["wsd-naming", "security-baseline"]
+  },
+  "createdAt": "2026-08-18T00:00:00Z",
+  "updatedAt": "2026-08-18T00:00:00Z"
+}

package/fixtures/valid/manifest/manifest-008-blueprints-registered.json

@@ -0,0 +1,32 @@
+{
+  "version": "2.0.0",
+  "projectName": "Composed SPA + REST project",
+  "prd": { "id": "PRD-001", "path": "rcf/prd.json" },
+  "tad": { "id": "TAD-001", "path": "rcf/tad.json" },
+  "bs":  { "id": "BS-001",  "path": "rcf/build-sequence.json" },
+  "blueprints": [
+    {
+      "slug": "spa",
+      "version": "1.0.0",
+      "appliedAt": "2026-08-18T10:00:00Z",
+      "source": "@stravica-ai/rcf-blueprint-spa@1.0.0",
+      "contributions": [
+        { "id": "spa-REQ-001", "path": "rcf/requirements/spa-req-001.json", "kind": "req" },
+        { "id": "spa-US-101",  "path": "rcf/user-stories/spa-us-101.json",  "kind": "us"  },
+        { "id": "TAC-002-spa-tokens", "path": "rcf/tacs/tac-002-spa-tokens.json", "kind": "tac" },
+        { "id": "ADR-004-spa-theme",  "path": "rcf/adrs/adr-004-spa-theme.json",  "kind": "adr" }
+      ]
+    },
+    {
+      "slug": "rest",
+      "version": "1.0.0",
+      "appliedAt": "2026-08-18T10:00:05Z",
+      "source": "@stravica-ai/rcf-blueprint-rest@1.0.0",
+      "namespace": "rest",
+      "contributions": [
+        { "id": "rest-REQ-001",       "path": "rcf/requirements/rest-req-001.json", "kind": "req" },
+        { "id": "ADR-005-rest-versioning", "path": "rcf/adrs/adr-005-rest-versioning.json", "kind": "adr" }
+      ]
+    }
+  ]
+}

package/fixtures/valid/manifest/manifest-009-standards-in-repo.json

@@ -0,0 +1,18 @@
+{
+  "version": "2.0.0",
+  "projectName": "In-repo standards project",
+  "prd": { "id": "PRD-001", "path": "rcf/prd.json" },
+  "tad": { "id": "TAD-001", "path": "rcf/tad.json" },
+  "bs":  { "id": "BS-001",  "path": "rcf/build-sequence.json" },
+  "standards": [
+    {
+      "id": "std-wsd-naming",
+      "slug": "wsd-naming",
+      "sourcePath": "docs/standards/wsd-naming",
+      "tags": ["naming", "conventions"],
+      "summary": "Naming conventions for symbols, files and endpoints across WSD services.",
+      "testsProvidedBy": "agent",
+      "provenance": "corporate"
+    }
+  ]
+}

package/fixtures/valid/manifest/manifest-010-standards-copied-in.json

@@ -0,0 +1,26 @@
+{
+  "version": "2.0.0",
+  "projectName": "Out-of-root standards project",
+  "prd": { "id": "PRD-001", "path": "rcf/prd.json" },
+  "tad": { "id": "TAD-001", "path": "rcf/tad.json" },
+  "bs":  { "id": "BS-001",  "path": "rcf/build-sequence.json" },
+  "standards": [
+    {
+      "id": "std-security-baseline",
+      "slug": "security-baseline",
+      "sourcePath": "/Users/thefoot/personal/patterns/security-baseline",
+      "copyPath": "rcf/standards/security-baseline",
+      "tags": ["security", "logging"],
+      "testsProvidedBy": "standard",
+      "provenance": "personal"
+    },
+    {
+      "id": "std-http-errors",
+      "slug": "http-errors",
+      "sourcePath": "docs/patterns/http-errors",
+      "tags": ["api", "errors"],
+      "testsProvidedBy": "none",
+      "provenance": "corporate"
+    }
+  ]
+}

package/fixtures/valid/manifest/manifest-011-preblueprint-chain-frozen.json

@@ -0,0 +1,8 @@
+{
+  "version": "2.0.0",
+  "projectName": "Frozen pre-0.4.3 chain manifest",
+  "prd": { "id": "PRD-001", "path": "rcf/prd.json" },
+  "tad": { "id": "TAD-001", "path": "rcf/tad.json" },
+  "bs":  { "id": "BS-001",  "path": "rcf/build-sequence.json" },
+  "testCommand": "pnpm -r test"
+}

package/fixtures/valid/manifest/manifest-012-blueprint-topic-resolution.json

@@ -0,0 +1,41 @@
+{
+  "version": "2.0.0",
+  "projectName": "Composed SPA + REST project with a resolved auth conflict",
+  "prd": { "id": "PRD-001", "path": "rcf/prd.json" },
+  "tad": { "id": "TAD-001", "path": "rcf/tad.json" },
+  "bs":  { "id": "BS-001",  "path": "rcf/build-sequence.json" },
+  "blueprints": [
+    {
+      "slug": "spa",
+      "version": "1.0.0",
+      "appliedAt": "2026-08-19T10:00:00Z",
+      "source": "@stravica-ai/rcf-blueprint-spa@1.0.0",
+      "contributions": [
+        { "id": "ADR-005-spa", "path": "rcf/adrs/adr-005-spa.json", "kind": "adr", "scope": "global", "topic": "auth" }
+      ]
+    },
+    {
+      "slug": "rest",
+      "version": "1.0.0",
+      "appliedAt": "2026-08-19T10:00:05Z",
+      "source": "@stravica-ai/rcf-blueprint-rest@1.0.0",
+      "contributions": [
+        { "id": "ADR-003-rest", "path": "rcf/adrs/adr-003-rest.json", "kind": "adr", "scope": "global", "topic": "auth" }
+      ]
+    }
+  ],
+  "resolutions": [
+    {
+      "id": "res-2026-08-19-001",
+      "createdAt": "2026-08-19T10:15:00Z",
+      "kind": "globalAdrTopic",
+      "topic": "auth",
+      "resolvedByAdrId": "ADR-042",
+      "supersedes": [
+        { "slug": "spa",  "adrId": "ADR-005-spa" },
+        { "slug": "rest", "adrId": "ADR-003-rest" }
+      ],
+      "reason": "Project auth model is documented in ADR-042; both blueprint auth ADRs remain on disk as superseded history."
+    }
+  ]
+}

package/fixtures/valid/prd/prd-002-slug-prefix.json

@@ -0,0 +1,12 @@
+{
+  "prdId": "spa-PRD-001",
+  "productName": "Blueprint-owned PRD fragment",
+  "version": "0.1.0",
+  "status": "draft",
+  "problemStatement": "Blueprint-contributed PRD fragment attached to a wider project PRD.",
+  "objectives": [
+    "Cover the SPA-specific scope the blueprint owns."
+  ],
+  "createdAt": "2026-08-18T00:00:00Z",
+  "updatedAt": "2026-08-18T00:00:00Z"
+}

package/fixtures/valid/req/req-002-slug-prefix.json

@@ -0,0 +1,13 @@
+{
+  "reqId": "spa-REQ-001",
+  "prdId": "PRD-001",
+  "title": "Every route ships loading, empty, error and success states",
+  "description": "Blueprint-contributed requirement: every declared route in the SPA carries all four state visuals.",
+  "category": "functional",
+  "domain": "ui",
+  "priority": "must",
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-08-18T00:00:00Z",
+  "updatedAt": "2026-08-18T00:00:00Z"
+}

package/fixtures/valid/tad/tad-002-slug-prefix.json

@@ -0,0 +1,14 @@
+{
+  "tadId": "spa-TAD-001",
+  "prdId": "PRD-001",
+  "version": "0.1.0",
+  "status": "draft",
+  "systemOverview": {
+    "executiveSummary": "Blueprint-contributed TAD fragment covering the SPA shell.",
+    "systemPurpose": "Frame the design tokens, nav shell and theme parity the SPA blueprint owns.",
+    "architecturalApproach": "Single-page application delivered light and dark by default.",
+    "keyCapabilities": ["Theme toggle", "Skeleton loaders", "Responsive layout"]
+  },
+  "createdAt": "2026-08-18T00:00:00Z",
+  "updatedAt": "2026-08-18T00:00:00Z"
+}

package/fixtures/valid/test-suite/ts-005-slug-prefix.json

@@ -0,0 +1,19 @@
+{
+  "id": "spa-TS-001",
+  "usId": "spa-US-101",
+  "title": "Loading-state coverage on every fetched route",
+  "purpose": "Assert every declared SPA route with a fetch shows a skeleton loader within 100ms.",
+  "testLevel": "unit",
+  "acIds": ["AC-001"],
+  "testCases": [
+    {
+      "id": "TC-001-happy-path",
+      "acId": "AC-001",
+      "description": "Skeleton renders synchronously for a route with a pending fetch.",
+      "status": "pending"
+    }
+  ],
+  "status": "draft",
+  "createdAt": "2026-08-18T00:00:00Z",
+  "updatedAt": "2026-08-18T00:00:00Z"
+}

package/fixtures/valid/user-story/us-005-slug-prefix.json

@@ -0,0 +1,20 @@
+{
+  "usId": "spa-US-101",
+  "prdId": "PRD-001",
+  "reqId": "spa-REQ-001",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "As a visitor I see a loading state on every fetch",
+  "asA": "first-time visitor",
+  "iWant": "to see a skeleton or spinner while data is loading",
+  "soThat": "I know the app is doing something instead of guessing whether it is broken",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-001",
+      "description": "Every route with a fetch shows a skeleton within 100ms of navigation",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-08-18T00:00:00Z",
+  "updatedAt": "2026-08-18T00:00:00Z"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stravica-ai/rcf-schemas",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "type": "module",
   "description": "JSON Schemas for the Requirements Confidence Framework (RCF). Language-neutral. The contract every RCF tool keys to.",
   "license": "Apache-2.0",
@@ -19,6 +19,9 @@
     "LICENSE",
     "CHANGELOG.md"
   ],
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  },
   "devDependencies": {
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1"
@@ -37,8 +40,5 @@
     "json-schema",
     "specifications",
     "traceability"
-  ],
-  "scripts": {
-    "test": "node --test test/*.test.js"
-  }
-}
+  ]
+}

package/schemas/common.schema.json

@@ -2,22 +2,22 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://schemas.stravica.io/rcf/v0.4.0/common.schema.json",
   "title": "RCF Shared Definitions",
-  "description": "Shared $defs referenced via $ref from every other RCF schema. ID patterns, status enums, version string, timestamp format, and the docRef shape. This file is not a document schema; consumers register it alongside the 11 doc-type schemas at validator init.",
+  "description": "Shared $defs referenced via $ref from every other RCF schema. ID patterns, status enums, version string, timestamp format, and the docRef shape. This file is not a document schema; consumers register it alongside the 11 doc-type schemas at validator init. From 0.4.4 the reqId/usId/prdId/bsId/tadId/tsId patterns accept an optional lowercase kebab-slug prefix (for example, spa-REQ-001) so blueprint mechanisms can contribute namespaced doc ids without colliding with project-authored ids. Existing numeric-only ids remain valid. The adrId/tacId/fbsId/cnId patterns already carry an optional kebab-slug SUFFIX (0.4.3) and are intentionally left untouched: id grammar is mixed across types for tonight (prefix for REQ/US/PRD/BS/TAD/TS; suffix for ADR/TAC/FBS/CN); unifying is a schemas follow-up.",
   "$defs": {
     "prdId": {
       "type": "string",
-      "pattern": "^PRD-\\d{3,}$",
-      "description": "PRD identifier. Three-digit minimum, unbounded above."
+      "pattern": "^([a-z][a-z0-9]*(?:-[a-z0-9]+)*-)?PRD-\\d{3,}$",
+      "description": "PRD identifier. Three-digit minimum, unbounded above. An optional lowercase kebab-slug prefix (for example, spa-PRD-001) is permitted for blueprint-contributed docs; existing numeric-only ids remain valid."
     },
     "reqId": {
       "type": "string",
-      "pattern": "^REQ-\\d{3,}$",
-      "description": "Requirement identifier."
+      "pattern": "^([a-z][a-z0-9]*(?:-[a-z0-9]+)*-)?REQ-\\d{3,}$",
+      "description": "Requirement identifier. An optional lowercase kebab-slug prefix (for example, spa-REQ-001) is permitted for blueprint-contributed docs; existing numeric-only ids remain valid."
     },
     "usId": {
       "type": "string",
-      "pattern": "^US-\\d{3,}$",
-      "description": "User Story identifier."
+      "pattern": "^([a-z][a-z0-9]*(?:-[a-z0-9]+)*-)?US-\\d{3,}$",
+      "description": "User Story identifier. An optional lowercase kebab-slug prefix (for example, spa-US-101) is permitted for blueprint-contributed docs; existing numeric-only ids remain valid."
     },
     "acId": {
       "type": "string",
@@ -26,8 +26,8 @@
     },
     "tadId": {
       "type": "string",
-      "pattern": "^TAD-\\d{3,}$",
-      "description": "Technical Architecture Document identifier."
+      "pattern": "^([a-z][a-z0-9]*(?:-[a-z0-9]+)*-)?TAD-\\d{3,}$",
+      "description": "Technical Architecture Document identifier. An optional lowercase kebab-slug prefix (for example, spa-TAD-001) is permitted for blueprint-contributed docs; existing numeric-only ids remain valid."
     },
     "tacId": {
       "type": "string",
@@ -41,8 +41,8 @@
     },
     "bsId": {
       "type": "string",
-      "pattern": "^BS-\\d{3,}$",
-      "description": "Build Sequence identifier."
+      "pattern": "^([a-z][a-z0-9]*(?:-[a-z0-9]+)*-)?BS-\\d{3,}$",
+      "description": "Build Sequence identifier. An optional lowercase kebab-slug prefix (for example, spa-BS-001) is permitted for blueprint-contributed docs; existing numeric-only ids remain valid."
     },
     "fbsId": {
       "type": "string",
@@ -51,8 +51,8 @@
     },
     "tsId": {
       "type": "string",
-      "pattern": "^TS-\\d{3,}$",
-      "description": "Test Suite identifier. Three-digit minimum, unbounded above."
+      "pattern": "^([a-z][a-z0-9]*(?:-[a-z0-9]+)*-)?TS-\\d{3,}$",
+      "description": "Test Suite identifier. Three-digit minimum, unbounded above. An optional lowercase kebab-slug prefix (for example, spa-TS-001) is permitted for blueprint-contributed docs; existing numeric-only ids remain valid."
     },
     "tcId": {
       "type": "string",
@@ -98,6 +98,16 @@
       "enum": ["library", "runtime", "deployed", "unclassified"],
       "description": "Scope tag classifying where a behaviour is observable. Shared between user-story.acceptanceCriteria[].scope and test-suite.testCases[].scope. library: observable in an isolated library or fixture. runtime: observable in the running product against local integration. deployed: observable on a booted artefact against real config and real network. unclassified: migration state for chains authored before the scope-tag vocabulary shipped; ruleset-enforcing consumers decide whether unclassified is currently accepted."
     },
+    "blueprintSlug": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+      "description": "Blueprint slug in lowercase kebab (for example, spa, rest, msg-consumer). Same shape as the id-prefix slug that namespaces blueprint-contributed docs."
+    },
+    "standardSlug": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+      "description": "Standards-pack slug in lowercase kebab (for example, wsd-naming, security-baseline). Used by manifest.standards[] and referenced by fbs.contextRequirements.standardIds."
+    },
     "docRef": {
       "type": "object",
       "additionalProperties": false,

package/schemas/fbs.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://schemas.stravica.io/rcf/v0.4.0/fbs.schema.json",
   "title": "RCF Functional Build Spec",
-  "description": "Functional Build Specification. One per build session. Carries the mandatory bsId parent reference plus buildOrder and executionStatus. Owns its acIds[] scope (Acceptance Criteria delivered by this FBS) and its dependsOnFbsIds[] graph edge (other FBSs this one depends on).",
+  "description": "Functional Build Specification. One per build session. Carries the mandatory bsId parent reference plus buildOrder and executionStatus. Owns its acIds[] scope (Acceptance Criteria delivered by this FBS) and its dependsOnFbsIds[] graph edge (other FBSs this one depends on). From 0.4.4 the contextRequirements block carries an optional standardIds[] array. It is the host for the bundle assembler's selective-retrieval step: the assembler analyses the FBS work text against the manifest.standards[] tag vocabulary and populates standardIds for that bundle only, or honours an operator override authored on the FBS. Every added field is optional; pre-0.4.4 FBSes remain valid.",
   "type": "object",
   "additionalProperties": false,
   "required": [
@@ -57,6 +57,11 @@
           "type": "array",
           "items": { "$ref": "https://schemas.stravica.io/rcf/v0.4.0/common.schema.json#/$defs/adrId" }
         },
+        "standardIds": {
+          "type": "array",
+          "items": { "$ref": "https://schemas.stravica.io/rcf/v0.4.0/common.schema.json#/$defs/standardSlug" },
+          "description": "Standards-pack slugs (from manifest.standards[]) that apply to this FBS. Populated by the bundle assembler's agentic selective-retrieval step at bundle-assembly time; an operator-authored value overrides the agentic selection for that FBS. Empty or absent means no standards content is included in the bundle; the assembler never blocks on an empty selection."
+        },
         "existingModules": {
           "type": "array",
           "items": { "type": "string" }

package/schemas/manifest.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://schemas.stravica.io/rcf/v0.4.0/manifest.schema.json",
   "title": "RCF Project Manifest",
-  "description": "Project manifest. Roots-only shape: declares prd, tad, bs. Children are owned by their parents and discovered by walking from the roots. From 0.4.0 the manifest also carries optional records for pre-flight configuration, review audits, UI baselines, browser verification, baseline-AC opt-outs, intake classification, register-regression canaries, and the review-surface state. From 0.4.1 the manifest additionally carries optional shipWithoutVerified acknowledgements written by rcf finalise --ship-without-verified. From 0.4.2 the testTheatreFinding shape carries an optional anchorId and drops tsId from its required list when kind is uiBaselineDrift (the drift finding is not anchored on a test suite); every other kind still requires tsId, and any 0.4.0- or 0.4.1-valid record remains valid. Every added field is optional; pre-0.4.0 manifests remain valid.",
+  "description": "Project manifest. Roots-only shape: declares prd, tad, bs. Children are owned by their parents and discovered by walking from the roots. From 0.4.0 the manifest also carries optional records for pre-flight configuration, review audits, UI baselines, browser verification, baseline-AC opt-outs, intake classification, register-regression canaries, and the review-surface state. From 0.4.1 the manifest additionally carries optional shipWithoutVerified acknowledgements written by rcf finalise --ship-without-verified. From 0.4.2 the testTheatreFinding shape carries an optional anchorId and drops tsId from its required list when kind is uiBaselineDrift (the drift finding is not anchored on a test suite); every other kind still requires tsId, and any 0.4.0- or 0.4.1-valid record remains valid. From 0.4.4 the manifest carries two optional additive sections that host the blueprint-library mechanism: blueprints[] (applied-blueprints registry written by rcf blueprint add / remove / upgrade) and standards[] (standards-pack registry written at rcf init and rcf standards add). From 0.4.5 the manifest additionally carries an optional resolutions[] section: one entry per operator-authored resolution of a cross-blueprint conflict, keyed at first by the globalAdrTopic conflict class (two applied blueprints each contributing a scope:global ADR on the same topic, resolved by a project-level ADR that supersedes both). Written by rcf blueprint supersede and by rcf blueprint add --resolve; read by the conflict detector so the resolved conflict is honoured and both blueprint ADRs may co-reside as superseded history. Every added field is optional; pre-0.4.0 manifests remain valid.",
   "type": "object",
   "additionalProperties": false,
   "required": ["version", "projectName", "prd", "tad", "bs"],
@@ -55,6 +55,21 @@
       "type": "array",
       "items": { "$ref": "#/$defs/shipWithoutVerifiedRecord" },
       "description": "Operator acknowledgements recorded when rcf finalise --ship-without-verified acknowledges a MOCK-ONLY-DECLARED or BLOCKED-BY-DECLARATION verdict on the verify report and ships the FBS at complete without promoting to verified. One entry per acknowledgement (verification-integrity-cluster-spec section 5.2). The ack is durable and greppable at ship time."
+    },
+    "blueprints": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/appliedBlueprintRecord" },
+      "description": "Applied-blueprints registry. One entry per rcf blueprint add / upgrade invocation on the project. Records the blueprint's slug, applied version, source, namespace and the ids and paths the blueprint contributed to the tree. Written by the rcf blueprint verb family; read by rcf blueprint list / remove / upgrade. Optional; projects that never call rcf blueprint have no entries. Composition (multiple applied blueprints) is expressed by multiple entries with distinct slugs."
+    },
+    "standards": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/standardsPackRecord" },
+      "description": "Standards-pack registry. One entry per standards folder registered at rcf init (or later via rcf standards add). Records the pack's id, slug, source path, optional copy path (present only when the source lived outside the project root and was copied into rcf/standards/<slug>/ for portability), tag vocabulary, testsProvidedBy classification, and provenance. Read by the bundle assembler's selective-retrieval step when populating fbs.contextRequirements.standardIds. Optional; projects that register no standards have no entries."
+    },
+    "resolutions": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/blueprintConflictResolution" },
+      "description": "Operator-authored resolutions of cross-blueprint conflicts. One entry per resolved conflict. Written by rcf blueprint supersede (which also scaffolds the project-level ADR that supersedes both blueprint ADRs) and by rcf blueprint add --resolve (which records the resolution declaratively on the add itself). Read by the conflict detector at rcf blueprint add: a resolution whose kind and key match a would-be conflict causes the detector to honour the resolution and let both blueprint ADRs co-reside as superseded history. Optional; projects with no cross-blueprint conflicts have no entries."
     }
   },
   "$defs": {
@@ -764,6 +779,155 @@
           "description": "Optional verify-supplied reason string carried through from the report entry."
         }
       }
+    },
+    "appliedBlueprintRecord": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "version", "appliedAt", "source"],
+      "properties": {
+        "slug": { "$ref": "https://schemas.stravica.io/rcf/v0.4.0/common.schema.json#/$defs/blueprintSlug" },
+        "version": { "$ref": "https://schemas.stravica.io/rcf/v0.4.0/common.schema.json#/$defs/version" },
+        "appliedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.4.0/common.schema.json#/$defs/timestamp" },
+        "source": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Where the blueprint was resolved from at apply time (for example, a registry path, a git ref, or a local file path). Provenance for rcf blueprint upgrade."
+        },
+        "namespace": {
+          "$ref": "https://schemas.stravica.io/rcf/v0.4.0/common.schema.json#/$defs/blueprintSlug",
+          "description": "Doc-id namespace used for this blueprint's contributions. Defaults to slug when omitted; the field exists so an operator can rename the namespace at add-time to avoid a project-authored slug collision."
+        },
+        "contributions": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/appliedBlueprintContribution" },
+          "description": "Every doc id and file path the blueprint contributed to the tree at apply time. Makes rcf blueprint remove and rcf blueprint upgrade mechanical: remove deletes exactly these paths and refuses when any project-authored doc references any of these ids; upgrade diffs the new contribution set against this one."
+        }
+      },
+      "description": "One applied-blueprint record. Written by rcf blueprint add on clean apply and rewritten by rcf blueprint upgrade; removed by rcf blueprint remove."
+    },
+    "appliedBlueprintContribution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Contributed doc id (for example, spa-REQ-001, or TAC-002-spa-logging when the doc kind namespaces via kebab-suffix). Schema-wise a minLength: 1 string because the union of all doc-id patterns is enforced at the owning doc's schema."
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Project-relative path the contribution was written to (for example, rcf/requirements/spa-req-001.json)."
+        },
+        "kind": {
+          "enum": ["prd", "req", "us", "tad", "tac", "adr", "bs", "fbs", "ts", "cn"],
+          "description": "Optional doc-kind classifier. Purely informational; the id + path pair is authoritative."
+        },
+        "scope": {
+          "enum": ["global"],
+          "description": "ADR contributions only: marks a whole-project decision (auth model, error envelope, versioning strategy). Two applied blueprints each contributing a scope:global ADR on the same topic is a hard conflict, surfaced by rcf blueprint add. Absent for non-global contributions."
+        },
+        "topic": {
+          "type": "string",
+          "minLength": 1,
+          "description": "ADR contributions only, required in practice when scope=global: the topic key the conflict detector matches on (for example, 'versioning', 'auth', 'errorEnvelope'). Absent for non-global contributions."
+        }
+      }
+    },
+    "standardsPackRecord": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "slug", "sourcePath", "tags", "testsProvidedBy", "provenance"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^std-[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+          "description": "Standards-pack record id. Format: std-<slug>. Slug is repeated in the id so the record id is grep-friendly across the manifest."
+        },
+        "slug": { "$ref": "https://schemas.stravica.io/rcf/v0.4.0/common.schema.json#/$defs/standardSlug" },
+        "sourcePath": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Path to the standards content. When the source lives inside the project root the pack is referenced in place (no copy is written); when outside, the pack is copied into rcf/standards/<slug>/ and copyPath records the copy destination."
+        },
+        "copyPath": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Present only when sourcePath was outside the project root at registration time. Points at the in-tree mirror under rcf/standards/<slug>/. Absent for in-repo sources (reference-by-default)."
+        },
+        "tags": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "description": "Ordered tag vocabulary for this pack (for example, naming, security, logging, ui, api). Read by the bundle assembler's selective-retrieval step alongside the pack summary when scoring relevance to an FBS's work text."
+        },
+        "summary": {
+          "type": "string",
+          "description": "Short human-readable summary of the pack's scope. Read by the selective-retrieval step; omitted for guidance-only packs where the tags carry enough signal."
+        },
+        "testsProvidedBy": {
+          "enum": ["standard", "agent", "none"],
+          "description": "How adherence to this pack is expressed. standard: the pack ships adherence checks that convert into ACs in the tree at registration or standards add time. agent: the working agent derives adherence from the pack's prose during build. none: guidance-only; the pack contributes prose that lands in the bundle but no adherence tests."
+        },
+        "provenance": {
+          "enum": ["personal", "corporate"],
+          "description": "Records whether the pack is a personal pattern collection or a corporate standards library. Reads at bundle-time as informational; init records the distinction so a project-level report can name where each pack came from."
+        }
+      },
+      "description": "One standards-pack registration. Written by rcf init (during standards prompting) and rcf standards add; read by the bundle assembler's selective-retrieval step."
+    },
+    "blueprintConflictResolution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "createdAt", "kind", "topic", "resolvedByAdrId", "supersedes"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^res-\\d{4}-\\d{2}-\\d{2}-\\d{3}$",
+          "description": "Blueprint-conflict-resolution record id. Format: res-YYYY-MM-DD-NNN. Monotonic per project."
+        },
+        "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.4.0/common.schema.json#/$defs/timestamp" },
+        "kind": {
+          "enum": ["globalAdrTopic"],
+          "description": "Which conflict class this record resolves. Currently the only kind is globalAdrTopic (two applied blueprints each contributing a scope:global ADR on the same topic). The enum is single-valued so a later minor bump can add further resolution classes additively without breaking existing consumers."
+        },
+        "topic": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The topic key the resolution applies to (for example, 'auth', 'versioning', 'errorEnvelope'). Matches the topic on both superseded blueprint ADRs. Required for kind=globalAdrTopic; the conflict detector reads this to know which would-be conflict the record honours."
+        },
+        "resolvedByAdrId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The project-level ADR id that supersedes the blueprint ADRs (for example, ADR-042). Its file lives outside any applied blueprint's namespace and is authored at rcf blueprint supersede time. Provenance for the resolution; the conflict detector does not currently re-read the referenced ADR."
+        },
+        "supersedes": {
+          "type": "array",
+          "minItems": 2,
+          "items": { "$ref": "#/$defs/blueprintConflictResolutionSupersededAdr" },
+          "description": "The blueprint ADRs this resolution supersedes. Two entries at minimum: the two applied blueprints whose global ADRs collided on topic. Both blueprint ADRs co-reside on disk as superseded history; the resolvedByAdrId is the live decision."
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Optional operator note recording why this resolution was chosen. Free text; the schema does not enforce a minimum floor here so the operator can record a terse one-liner when the resolvedByAdrId itself carries the reasoning."
+        }
+      },
+      "description": "One blueprint-conflict resolution. Written by rcf blueprint supersede (scaffolds the resolvedByAdrId and appends the record) and by rcf blueprint add --resolve (appends the record without scaffolding a new ADR). Read by the conflict detector to skip a would-be conflict when a resolution matches."
+    },
+    "blueprintConflictResolutionSupersededAdr": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slug", "adrId"],
+      "properties": {
+        "slug": { "$ref": "https://schemas.stravica.io/rcf/v0.4.0/common.schema.json#/$defs/blueprintSlug" },
+        "adrId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The blueprint-owned ADR id that is superseded (for example, spa-ADR-005 or ADR-005-spa). Kept as a free-string minLength: 1 so the shape does not have to encode the mixed prefix/suffix namespacing grammar."
+        }
+      },
+      "description": "One superseded blueprint ADR: the applied blueprint's slug plus the ADR id inside that blueprint's contribution set."
     }
   }
 }