@stravica-ai/rcf-schemas 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,25 @@ 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.3.0 - 2026-07-10
+
+Adds the Code Node (`CN`) document kind, the eleventh in the family, bridging the requirements graph to source code.
+
+### Added
+
+- **`cn.schema.json`**: new schema. One file per Code Node. Identity is `path`, a repo-relative source location, optionally `#symbol`-suffixed (for example `src/store/validator.js` or `src/store/validator.js#getAjv`); granularity (file vs symbol) is derived from the presence of `#` and is never stored as its own field. Required: `cnId`, `path`, `implementsAcIds` (may be empty; an orphan CN is a legitimate state), `version`, `status`, `createdAt`, `updatedAt`. Optional: `title`, `description`, `dependencies[]` (CN-to-CN edges, hand-declared).
+- **`common.schema.json`**: new `$defs.cnId` (`^CN-\d{3,}$`) and `$defs.cnStatus` (`draft` | `approved` | `deprecated`).
+- Fixtures under `fixtures/valid/cn/` and `fixtures/invalid/cn/`; targeted tests in `test/cn.test.js`.
+- Recommended file layout: `rcf/code-nodes/`, file naming `cn-NNN.json` (see `docs/file-layout.md`).
+
+### Changed
+
+- **Canonical `$id`** URLs bumped from `https://schemas.stravica.io/rcf/v0.2.0/...` to `https://schemas.stravica.io/rcf/v0.3.0/...` on every schema, in lock-step with the bundle version (unchanged content for the 10 pre-existing document schemas; only `common.schema.json` gains new `$defs` and `cn.schema.json` is new).
+
+### Notes
+
+- The project manifest (`manifest.schema.json`) is intentionally unchanged: it is roots-only (`prd`, `tad`, `bs`) and no document kind, including CN, is enumerated there. CN discovery follows the same convention-derived-path pattern as every other kind (see `docs/file-layout.md`), not a manifest field.
+
 ## 0.2.1 - 2026-07-02
 
 Added optional `tacIds[]` cross-link field on `user-story.schema.json` to close a Phase 3.7 §D2/OQ-P37-1 silent miss. Forward-compatible; no consumer populates the field until Phase 4 CRUD. Backward-compatible - existing US docs without `tacIds` remain valid.

package/README.md

@@ -4,15 +4,15 @@ JSON Schemas for the [Requirements Confidence Framework (RCF)](https://stravica.
 
 **Language-neutral. No code in this package, only schema files, docs, and fixtures.** Every consumer language is first-class: Node, Python, Java, or anything else with a JSON Schema 2020-12 validator.
 
-> **Status:** v0.2.0 - public preview.
+> **Status:** v0.3.0 - public preview.
 >
 > This package is available on the public npm registry as a preview. Ship-quality contract, small consumer surface. The methodology's reference implementation (`Stravica/rcf-build-lite`) is being migrated to consume 0.2.0 during Phase 3.7 of the RCF build and stays private until Phase 9; expect the public consumer path to sharpen up as that lands. If you want to experiment, `npm install @stravica-ai/rcf-schemas` is stable; docs at `https://schemas.stravica.io/` land at Phase 9.
 
 ## What's here
 
-- **11 schema files** in `schemas/`:
+- **12 schema files** in `schemas/`:
   - `common.schema.json` - shared `$defs` (id patterns, status enums, version, timestamp, `docRef`). Referenced via `$ref` from every other schema.
-  - `prd`, `req`, `user-story`, `tad`, `tac`, `adr`, `build-sequence`, `fbs`, `test-suite`, `manifest`.
+  - `prd`, `req`, `user-story`, `tad`, `tac`, `adr`, `build-sequence`, `fbs`, `test-suite`, `manifest`, `cn`.
 - **Per-schema docs** in `docs/` (one page per schema) plus cross-cutting `id-conventions.md` and `file-layout.md`.
 - **JSON test fixtures** in `fixtures/valid/` and `fixtures/invalid/` (every schema covered).
 - **CHANGELOG** in `CHANGELOG.md`.
@@ -38,7 +38,7 @@ pip install stravica-rcf-schemas
 Maven coordinate:
 
 ```
-io.stravica.rcf:rcf-schemas:0.2.0
+io.stravica.rcf:rcf-schemas:0.3.0
 ```
 
 ### Direct fetch (Phase 9 onwards)
@@ -46,7 +46,7 @@ io.stravica.rcf:rcf-schemas:0.2.0
 Each schema is fetchable by its canonical `$id`:
 
 ```
-https://schemas.stravica.io/rcf/v0.2.0/<name>.schema.json
+https://schemas.stravica.io/rcf/v0.3.0/<name>.schema.json
 ```
 
 ## Use
@@ -66,7 +66,7 @@ const pkgRoot = require.resolve('@stravica-ai/rcf-schemas/package.json').replace
 
 const names = [
   'common', 'prd', 'req', 'user-story', 'tad', 'tac', 'adr',
-  'build-sequence', 'fbs', 'test-suite', 'manifest'
+  'build-sequence', 'fbs', 'test-suite', 'manifest', 'cn'
 ];
 
 const ajv = new Ajv({ strict: true, allErrors: true });
@@ -77,7 +77,7 @@ for (const name of names) {
   ajv.addSchema(schema);
 }
 
-const validatePrd = ajv.getSchema('https://schemas.stravica.io/rcf/v0.2.0/prd.schema.json');
+const validatePrd = ajv.getSchema('https://schemas.stravica.io/rcf/v0.3.0/prd.schema.json');
 const ok = validatePrd(myPrdDoc);
 if (!ok) console.error(validatePrd.errors);
 ```
@@ -95,7 +95,7 @@ pkg = files('stravica_rcf_schemas') / 'schemas'
 
 names = [
     'common', 'prd', 'req', 'user-story', 'tad', 'tac', 'adr',
-    'build-sequence', 'fbs', 'test-suite', 'manifest'
+    'build-sequence', 'fbs', 'test-suite', 'manifest', 'cn'
 ]
 
 resources = []
@@ -115,9 +115,9 @@ Configure a `SchemaClient` (everit) or `SchemaLoader` (networknt) that resolves
 
 ### Any other language
 
-The schemas use JSON Schema Draft 2020-12. Any validator that supports 2020-12 + multi-file `$ref` will work. Register the 11 schemas (with `common.schema.json` first) and resolve by `$id`.
+The schemas use JSON Schema Draft 2020-12. Any validator that supports 2020-12 + multi-file `$ref` will work. Register the 12 schemas (with `common.schema.json` first) and resolve by `$id`.
 
-## Chain shape (0.2.0)
+## Chain shape (0.3.0)
 
 Every parent-child edge in the RCF chain is encoded exactly once, on the child, as a mandatory `<parent>Id` field. Parents never store child lists; walkers invert the child references at load time to build the `childrenByParent` map. This makes tree drift structurally impossible.
 
@@ -126,6 +126,7 @@ Every parent-child edge in the RCF chain is encoded exactly once, on the child,
 - TAD is the root of the architecture chain. TAC and ADR each carry `tadId`.
 - BS is the root of the build-sequence chain. FBS carries `bsId`, `buildOrder`, `executionStatus`, and `dependsOnFbsIds[]`.
 - TS carries `usId` and `acIds[]` (the ACs verified). TC lives inline in TS with per-TC `acId`.
+- CN (added 0.3.0) bridges the chain to source code: `implementsAcIds[]` anchors a node to the ACs it satisfies, `dependencies[]` declares CN-to-CN edges. Identity is `path` (optionally `#symbol`-suffixed), not a parent reference - CN sits alongside the chain rather than inside it.
 
 ## Schema reference
 
@@ -134,7 +135,7 @@ Per-schema docs in [`docs/`](./docs/README.md):
 - [common](./docs/common.md) | [prd](./docs/prd.md) | [req](./docs/req.md) | [user-story](./docs/user-story.md)
 - [tad](./docs/tad.md) | [tac](./docs/tac.md) | [adr](./docs/adr.md)
 - [build-sequence](./docs/build-sequence.md) | [fbs](./docs/fbs.md) | [test-suite](./docs/test-suite.md)
-- [manifest](./docs/manifest.md)
+- [manifest](./docs/manifest.md) | [cn](./docs/cn.md)
 
 Cross-cutting:
 

package/docs/README.md

@@ -17,6 +17,7 @@ One page per schema file under `schemas/`.
 - [fbs](./fbs.md) - Functional Build Specification.
 - [test-suite](./test-suite.md) - Test Suite for a single AC.
 - [manifest](./manifest.md) - project roots-only manifest.
+- [cn](./cn.md) - Code Node, bridging the spec graph to source.
 
 ## Cross-cutting
 

package/docs/adr.md

@@ -4,7 +4,7 @@ Architectural Decision Record. One per decision, one file each. Follows the Nyga
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/adr.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/adr.schema.json`
 
 ## Required fields
 

package/docs/build-sequence.md

@@ -4,7 +4,7 @@ Build Sequence. One per project. Pure planning shell. FBS files each carry the m
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/build-sequence.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/build-sequence.schema.json`
 
 ## Required fields
 

package/docs/cn.md

@@ -0,0 +1,50 @@
+# cn.schema.json
+
+Code Node. One file per node. Bridges the requirements graph to source code: identity is a working-tree path, `implementsAcIds` anchors the node into the AC layer, `dependencies` declares CN-to-CN edges.
+
+## Canonical `$id`
+
+`https://schemas.stravica.io/rcf/v0.3.0/cn.schema.json`
+
+## Required fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `cnId` | `^CN-\d{3,}$` | This node's identifier. |
+| `path` | string, min 1 | Repo-relative source path, optionally `#symbol`-suffixed. |
+| `implementsAcIds` | array of `acId`, `minItems: 0` | Acceptance criteria this node satisfies. May be empty: an orphan CN (utilities, glue, wiring) is a legitimate state. |
+| `version` | semver | Per-document version. |
+| `status` | `cnStatus` enum (`draft`, `approved`, `deprecated`) | Lifecycle status. |
+| `createdAt` / `updatedAt` | ISO 8601 date-time | Lifecycle timestamps. |
+
+## Optional fields
+
+| Field | Type | Purpose |
+|---|---|---|
+| `title` | string | Short human-readable label. |
+| `description` | string | Free-form description of what the node does. |
+| `dependencies` | array of `cnId`, `minItems: 0` | Code nodes this node depends on (CN-to-CN edges). Hand-declared. |
+
+## Identity: `path`, optionally `#symbol`-suffixed
+
+Two granularities, both supported by the same `path` field:
+
+- **File-level:** `"src/store/validator.js"` - coarse "this module serves these ACs" mapping.
+- **Symbol-level:** `"src/store/validator.js#getAjv"` - precise, load-bearing nodes.
+
+Granularity is not a stored field. It is fully derivable from the presence of `#` in `path`: a stored copy would be a cross-field consistency bug waiting to happen. A tool that needs to distinguish the two checks for `#` in the path string.
+
+The `path` pattern (`^[^#]+(#[A-Za-z_$][A-Za-z0-9_$]*)?$`) allows at most one `#symbol` suffix, and the symbol portion must look like a valid JS/TS identifier start. This is a shape check only: the schema does not (and cannot) verify the path exists or the symbol resolves in any particular working tree. That is validation-time tooling's job, not the schema's.
+
+## Edges
+
+- **`implementsAcIds[]`** (CN -> AC): the anchor into the spec graph. May be empty.
+- **`dependencies[]`** (CN -> CN): what this node depends on. Optional, hand-declared in this schema version. Auto-derivation from static analysis tooling is a consumer-side concern, not a schema concern.
+
+## Example
+
+See `fixtures/valid/cn/cn-002-comprehensive.json` for a symbol-level CN with both edge types populated.
+
+## Recommended file layout
+
+`rcf/code-nodes/`, file naming `cn-NNN.json` (or `CN-NNN.json`; the schema does not constrain filenames). See [file-layout](./file-layout.md).

package/docs/common.md

@@ -1,10 +1,10 @@
 # common.schema.json
 
-Shared `$defs` referenced via `$ref` from every other RCF schema. ID patterns, status enums, version string, timestamp format, and the `docRef` shape live here. This file is not itself a document schema; consumers register it alongside the other 10 schemas at validator init.
+Shared `$defs` referenced via `$ref` from every other RCF schema. ID patterns, status enums, version string, timestamp format, and the `docRef` shape live here. This file is not itself a document schema; consumers register it alongside the other 11 schemas at validator init.
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/common.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/common.schema.json`
 
 ## What's in `$defs`
 
@@ -21,11 +21,13 @@ Shared `$defs` referenced via `$ref` from every other RCF schema. ID patterns, s
 | `fbsId` | string, `^FBS-\d{3,}$` | `fbs.fbsId`, `fbs.dependsOnFbsIds[]` |
 | `tsId` | string, `^TS-\d{3}$` | `test-suite.id` |
 | `tcId` | string, `^TC-\d{3}-[a-z0-9-]+$` | `test-suite.testCases[].id` |
+| `cnId` | string, `^CN-\d{3,}$` | `cn.cnId`, `cn.dependencies[]` |
 | `version` | string, `^\d+\.\d+\.\d+$` | every doc-type schema |
 | `timestamp` | string, format `date-time` | every doc-type schema |
 | `authoringStatus` | enum: `draft`, `review`, `needsRevision`, `approved`, `superseded` | PRD, REQ, US, TAD, TAC, BS |
 | `adrStatus` | enum: `draft`, `proposed`, `accepted`, `superseded`, `deprecated` | ADR |
 | `executionStatus` | enum: `notStarted`, `inProgress`, `complete`, `verified` | FBS doc + BS slot |
+| `cnStatus` | enum: `draft`, `approved`, `deprecated` | CN |
 | `docRef` | object `{ id, path }` | manifest `prd`, `tad`, `bs` |
 
 ## Why these are shared
@@ -40,4 +42,4 @@ Per-doc-type enums (REQ `category`, REQ `priority`, FBS `riskLevel`, BS `generat
 
 ## Version
 
-Carried on the `$id` URL path segment (`/v0.2.0/`). Bumps in lock-step with the bundle.
+Carried on the `$id` URL path segment (`/v0.3.0/`). Bumps in lock-step with the bundle.

package/docs/fbs.md

@@ -6,7 +6,7 @@ Structurally, each FBS carries the mandatory `bsId` back-reference plus `buildOr
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/fbs.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/fbs.schema.json`
 
 ## Required fields
 

package/docs/file-layout.md

@@ -28,9 +28,12 @@ project-root/
 |   |-- fbs/
 |   |   |-- FBS-001.json
 |   |   `-- FBS-002.json
-|   `-- test-suites/
-|       |-- ts-001.json
-|       `-- ts-002.json
+|   |-- test-suites/
+|   |   |-- ts-001.json
+|   |   `-- ts-002.json
+|   `-- code-nodes/
+|       |-- cn-001.json
+|       `-- cn-002.json
 ```
 
 ## Why everything lives under `rcf/`
@@ -58,5 +61,6 @@ Tools that walk from the manifest roots can resolve child paths by convention:
 - ADR-001 -> `rcf/adrs/ADR-001.json`
 - FBS-001 -> `rcf/fbs/FBS-001.json`
 - TS-001 -> `rcf/test-suites/ts-001.json`
+- CN-001 -> `rcf/code-nodes/cn-001.json`
 
 A future minor bump may introduce an optional `paths` override block on the manifest for adopters who deviate from the recommendation; 0.2.0 ships convention-only.

package/docs/id-conventions.md

@@ -27,6 +27,7 @@ Two families deviate from the family default and are documented alongside their
 | `FBS` | Functional Build Specification | yes | `fbs.schema.json` |
 | `TS`  | Test Suite | yes (one file per suite, sequential id `TS-\d{3}`) | `test-suite.schema.json` |
 | `TC`  | Test Case | no (nested in TS, id `TC-<TS-suffix>-<slug>`) | `test-suite.schema.json` |
+| `CN`  | Code Node | yes | `cn.schema.json` |
 
 All prefixes are defined exactly once in `common.schema.json#/$defs` and referenced via `$ref` everywhere.
 
@@ -49,11 +50,15 @@ Pick per project; the schema does not enforce either form. The published `Stravi
 
 Rationale: sequential numbering for TCs is brittle if you renumber; slug-based ids give readable pointers in test-suite bodies and traceability queries.
 
+## CN ids
+
+`^CN-\d{3,}$`, same shape as the family default. A CN's *identity within the working tree* is a separate field, `path` (optionally `#symbol`-suffixed) - see [cn](./cn.md). The `cnId` is the document id used for cross-references (`dependencies[]`, and inbound from any future kind that anchors to a CN); `path` is what the CN actually points at.
+
 ## File-level vs nested-level: the asymmetry
 
 | Lives in its own file | Lives nested inside a parent |
 |---|---|
-| PRD, REQ, US, TAD, TAC, ADR, BS, FBS, TS | AC (inside US), TC (inside TS) |
+| PRD, REQ, US, TAD, TAC, ADR, BS, FBS, TS, CN | AC (inside US), TC (inside TS) |
 
 **The rule:** narrative-heavy structured documents that grow over time live in their own files (per-doc git history, parallel-safe authoring, no merge conflict on append). Tightly-coupled child structures (AC inside US, TC inside TS) stay nested, splitting them multiplies file counts without benefit.
 

package/docs/manifest.md

@@ -4,7 +4,7 @@ Project manifest. Roots-only shape: declares `prd`, `tad`, `bs`. Children are ow
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/manifest.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/manifest.schema.json`
 
 ## Required fields
 
@@ -39,11 +39,13 @@ Both fields are required.
 
 Singular by design; no child arrays:
 
-- No `userStories[]`, `tacs[]`, `adrs[]`, `fbs[]`, `testSuites[]`, `requirements[]`.
+- No `userStories[]`, `tacs[]`, `adrs[]`, `fbs[]`, `testSuites[]`, `requirements[]`, `codeNodes[]`.
 - No `prds: [...]` array (single-PRD per project).
 - No `activePrdId` (multi-PRD assumption retired).
 - No `buildSequence` (renamed to `bs` for abbreviation consistency with `prd`, `tad`, `fbs`, `tac`, `adr`).
 
+CN (added 0.3.0) follows the same rule as every other non-root kind: no manifest field. Discovery is by the convention-derived path (see [file-layout](./file-layout.md)), same as TAC, ADR, FBS and TS.
+
 ## Why roots-only
 
 SSoT discipline. Every parent-child edge is encoded exactly once, on the child, as a mandatory `<parent>Id` field:

package/docs/prd.md

@@ -4,7 +4,7 @@ Product Requirements Document. One per project. Pure shell document; REQ bodies
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/prd.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/prd.schema.json`
 
 ## Required fields
 

package/docs/req.md

@@ -4,7 +4,7 @@ Individual Requirement within a PRD. One file per REQ. Recommended path: `rcf/re
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/req.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/req.schema.json`
 
 ## Required fields
 

package/docs/tac.md

@@ -4,7 +4,7 @@ Technical Architecture Component. One file per architectural component. Verbose
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/tac.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/tac.schema.json`
 
 ## Required fields
 

package/docs/tad.md

@@ -4,7 +4,7 @@ Master Technical Architecture Document. One per project. Pure shell for cross-cu
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/tad.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/tad.schema.json`
 
 ## Required fields
 

package/docs/test-suite.md

@@ -4,7 +4,7 @@ Test Suite. One file per Test Suite. The JSON specification of what Test Cases e
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/test-suite.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/test-suite.schema.json`
 
 ## TS-as-JSON: what this schema is for
 

package/docs/user-story.md

@@ -4,7 +4,7 @@ User Story document. One file per US. Contains Acceptance Criteria inline as `ac
 
 ## Canonical `$id`
 
-`https://schemas.stravica.io/rcf/v0.2.0/user-story.schema.json`
+`https://schemas.stravica.io/rcf/v0.3.0/user-story.schema.json`
 
 ## Required fields
 

package/fixtures/invalid/cn/cn-001-bad-cnid-prefix.json

@@ -0,0 +1,9 @@
+{
+  "cnId": "CODE-001",
+  "path": "src/store/validator.js",
+  "implementsAcIds": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-01-01T00:00:00Z",
+  "updatedAt": "2026-01-01T00:00:00Z"
+}

package/fixtures/invalid/cn/cn-002-missing-implementsacids.json

@@ -0,0 +1,8 @@
+{
+  "cnId": "CN-001",
+  "path": "src/store/validator.js",
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-01-01T00:00:00Z",
+  "updatedAt": "2026-01-01T00:00:00Z"
+}

package/fixtures/invalid/cn/cn-003-legacy-granularity-field.json

@@ -0,0 +1,10 @@
+{
+  "cnId": "CN-001",
+  "path": "src/store/validator.js",
+  "granularity": "file",
+  "implementsAcIds": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-01-01T00:00:00Z",
+  "updatedAt": "2026-01-01T00:00:00Z"
+}

package/fixtures/invalid/cn/cn-004-bad-dependency-shape.json

@@ -0,0 +1,10 @@
+{
+  "cnId": "CN-001",
+  "path": "src/store/validator.js",
+  "implementsAcIds": [],
+  "dependencies": ["not-a-cn-id"],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-01-01T00:00:00Z",
+  "updatedAt": "2026-01-01T00:00:00Z"
+}

package/fixtures/valid/cn/cn-001-minimal.json

@@ -0,0 +1,9 @@
+{
+  "cnId": "CN-001",
+  "path": "src/store/validator.js",
+  "implementsAcIds": [],
+  "version": "0.1.0",
+  "status": "draft",
+  "createdAt": "2026-01-01T00:00:00Z",
+  "updatedAt": "2026-01-01T00:00:00Z"
+}

package/fixtures/valid/cn/cn-002-comprehensive.json

@@ -0,0 +1,12 @@
+{
+  "cnId": "CN-042",
+  "path": "src/store/validator.js#getAjv",
+  "title": "getAjv",
+  "description": "Builds and caches the configured ajv instance used across the validate pipeline.",
+  "implementsAcIds": ["AC-101-1", "AC-101-2"],
+  "dependencies": ["CN-006", "CN-011"],
+  "version": "1.0.0",
+  "status": "approved",
+  "createdAt": "2026-01-01T00:00:00Z",
+  "updatedAt": "2026-07-09T12:00:00Z"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stravica-ai/rcf-schemas",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "description": "JSON Schemas for the Requirements Confidence Framework (RCF). Language-neutral. The contract every RCF tool keys to.",
   "license": "Apache-2.0",

package/schemas/adr.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/adr.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.0/adr.schema.json",
   "title": "RCF Architectural Decision Record",
   "description": "Architectural Decision Record. One per decision, one file each. Nygard / MADR convention.",
   "type": "object",
@@ -19,11 +19,11 @@
     "updatedAt"
   ],
   "properties": {
-    "adrId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/adrId" },
-    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/prdId" },
-    "tadId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/tadId" },
-    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/version" },
-    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/adrStatus" },
+    "adrId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/adrId" },
+    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/prdId" },
+    "tadId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/tadId" },
+    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/version" },
+    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/adrStatus" },
 
     "title": { "type": "string", "minLength": 1 },
     "context": { "type": "string", "minLength": 1 },
@@ -34,14 +34,14 @@
       "items": { "$ref": "#/$defs/alternative" }
     },
 
-    "supersededBy": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/adrId" },
+    "supersededBy": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/adrId" },
     "relatedAdrs": {
       "type": "array",
-      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/adrId" }
+      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/adrId" }
     },
 
-    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" },
-    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" }
+    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" }
   },
   "$defs": {
     "alternative": {

package/schemas/build-sequence.schema.json

@@ -1,22 +1,22 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/build-sequence.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.0/build-sequence.schema.json",
   "title": "RCF Build Sequence",
   "description": "One per project. Pure planning shell. FBSs each carry the mandatory bsId parent reference plus buildOrder; the ordered FBS list is computed by loading every FBS under rcf/fbs/, filtering by bsId, and sorting by buildOrder. Duplicate buildOrder within one BS is a validation error at load time.",
   "type": "object",
   "additionalProperties": false,
   "required": ["bsId", "prdId", "version", "status", "createdAt", "updatedAt"],
   "properties": {
-    "bsId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/bsId" },
-    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/prdId" },
-    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/version" },
-    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/authoringStatus" },
+    "bsId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/bsId" },
+    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/prdId" },
+    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/version" },
+    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/authoringStatus" },
     "title": { "type": "string" },
     "buildPhilosophy": { "type": "string" },
     "generationStrategy": {
       "enum": ["verticalSlice", "dependencyFirst", "domainGrouped", "riskFrontLoaded"]
     },
-    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" },
-    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" }
+    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" }
   }
 }

package/schemas/cn.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.0/cn.schema.json",
+  "title": "RCF Code Node",
+  "description": "Code Node document. One file per node. Identity is a working-tree path, optionally #symbol-suffixed; granularity (file vs symbol) is derived from the presence of '#', never stored. Bridges the spec graph to source: implementsAcIds anchors the node into the AC layer, dependencies declares CN-to-CN edges.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["cnId", "path", "implementsAcIds", "version", "status", "createdAt", "updatedAt"],
+  "properties": {
+    "cnId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/cnId" },
+    "path": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^#]+(#[A-Za-z_$][A-Za-z0-9_$]*)?$",
+      "description": "Repo-relative source path, optionally #symbol-suffixed (e.g. \"src/store/validator.js\" or \"src/store/validator.js#getAjv\")."
+    },
+    "title": { "type": "string", "minLength": 1 },
+    "description": { "type": "string" },
+    "implementsAcIds": {
+      "type": "array",
+      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/acId" },
+      "minItems": 0,
+      "description": "Acceptance criteria this code node satisfies. May be empty: an orphan CN (utilities, glue, wiring) is a legitimate state."
+    },
+    "dependencies": {
+      "type": "array",
+      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/cnId" },
+      "minItems": 0,
+      "description": "Code nodes this node depends on (CN-to-CN edges). Hand-declared in v1."
+    },
+    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/version" },
+    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/cnStatus" },
+    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" }
+  }
+}

package/schemas/common.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.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 10 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.",
   "$defs": {
     "prdId": {
       "type": "string",
@@ -59,6 +59,11 @@
       "pattern": "^TC-\\d{3}-[a-z0-9-]+$",
       "description": "Test Case identifier. TS suffix (three digits) joined to a lowercase alphanumeric slug."
     },
+    "cnId": {
+      "type": "string",
+      "pattern": "^CN-\\d{3,}$",
+      "description": "Code Node identifier. Three-digit minimum, unbounded above."
+    },
     "version": {
       "type": "string",
       "pattern": "^\\d+\\.\\d+\\.\\d+$",
@@ -81,6 +86,10 @@
       "enum": ["notStarted", "inProgress", "complete", "verified"],
       "description": "Execution-state status for FBS documents and FBS slots within a Build Sequence."
     },
+    "cnStatus": {
+      "enum": ["draft", "approved", "deprecated"],
+      "description": "Lifecycle status for Code Node documents."
+    },
     "docRef": {
       "type": "object",
       "additionalProperties": false,

package/schemas/fbs.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/fbs.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.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).",
   "type": "object",
@@ -19,23 +19,23 @@
     "updatedAt"
   ],
   "properties": {
-    "fbsId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/fbsId" },
-    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/prdId" },
-    "bsId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/bsId" },
+    "fbsId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/fbsId" },
+    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/prdId" },
+    "bsId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/bsId" },
     "buildOrder": { "type": "integer", "minimum": 1 },
-    "executionStatus": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/executionStatus" },
+    "executionStatus": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/executionStatus" },
     "title": { "type": "string", "minLength": 1 },
     "summary": { "type": "string", "minLength": 1 },
     "approach": { "type": "string" },
     "acIds": {
       "type": "array",
       "minItems": 1,
-      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/acId" }
+      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/acId" }
     },
     "dependsOnFbsIds": {
       "type": "array",
       "minItems": 0,
-      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/fbsId" }
+      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/fbsId" }
     },
     "contextRequirements": {
       "type": "object",
@@ -51,11 +51,11 @@
         },
         "tacIds": {
           "type": "array",
-          "items": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/tacId" }
+          "items": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/tacId" }
         },
         "adrIds": {
           "type": "array",
-          "items": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/adrId" }
+          "items": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/adrId" }
         },
         "existingModules": {
           "type": "array",
@@ -84,7 +84,7 @@
     "riskLevel": { "enum": ["low", "medium", "high"] },
     "domain": { "type": "string" },
     "notes": { "type": "string" },
-    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" },
-    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" }
+    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" }
   }
 }

package/schemas/manifest.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/manifest.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.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.",
   "type": "object",
@@ -10,8 +10,8 @@
     "version": { "type": "string", "const": "2.0.0" },
     "projectName": { "type": "string", "minLength": 1 },
     "description": { "type": "string" },
-    "prd": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/docRef" },
-    "tad": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/docRef" },
-    "bs": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/docRef" }
+    "prd": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/docRef" },
+    "tad": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/docRef" },
+    "bs": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/docRef" }
   }
 }

package/schemas/prd.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/prd.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.0/prd.schema.json",
   "title": "RCF PRD",
   "description": "Product Requirements Document. One per project. The PRD is a pure shell document; requirement bodies live in individual req.schema.json files and each REQ carries the mandatory prdId back-reference. The walker computes the PRD's requirement list by inverting REQ.prdId at load time.",
   "type": "object",
@@ -16,10 +16,10 @@
     "updatedAt"
   ],
   "properties": {
-    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/prdId" },
+    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/prdId" },
     "productName": { "type": "string", "minLength": 1 },
-    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/version" },
-    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/authoringStatus" },
+    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/version" },
+    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/authoringStatus" },
     "executiveSummary": { "type": "string" },
     "problemStatement": { "type": "string", "minLength": 1 },
     "targetUsers": {
@@ -43,7 +43,7 @@
       "type": "array",
       "items": { "type": "string", "minLength": 1 }
     },
-    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" },
-    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" }
+    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" }
   }
 }

package/schemas/req.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/req.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.0/req.schema.json",
   "title": "RCF Requirement",
   "description": "Individual requirement within a PRD. One file per requirement. Recommended path: rcf/requirements/REQ-001.json. Carries the mandatory prdId parent reference; the PRD does not list its requirements.",
   "type": "object",
@@ -19,8 +19,8 @@
     "updatedAt"
   ],
   "properties": {
-    "reqId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/reqId" },
-    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/prdId" },
+    "reqId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/reqId" },
+    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/prdId" },
     "title": { "type": "string", "minLength": 1 },
     "description": { "type": "string", "minLength": 1 },
     "category": { "enum": ["functional", "nonFunctional", "technical", "security"] },
@@ -31,9 +31,9 @@
       "type": "array",
       "items": { "type": "string" }
     },
-    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/version" },
-    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/authoringStatus" },
-    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" },
-    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" }
+    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/version" },
+    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/authoringStatus" },
+    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" }
   }
 }

package/schemas/tac.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/tac.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.0/tac.schema.json",
   "title": "RCF Technical Architecture Component",
   "description": "One per architectural component. Verbose per-component descriptions are fine; the schema does not constrain length.",
   "type": "object",
@@ -18,11 +18,11 @@
     "updatedAt"
   ],
   "properties": {
-    "tacId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/tacId" },
-    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/prdId" },
-    "tadId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/tadId" },
-    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/version" },
-    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/authoringStatus" },
+    "tacId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/tacId" },
+    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/prdId" },
+    "tadId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/tadId" },
+    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/version" },
+    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/authoringStatus" },
 
     "name": { "type": "string", "minLength": 1 },
     "purpose": { "type": "string", "minLength": 1 },
@@ -44,8 +44,8 @@
     "tradeoffs": { "type": "string" },
     "notes": { "type": "string" },
 
-    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" },
-    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" }
+    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" }
   },
   "$defs": {
     "interfaceDef": {
@@ -65,7 +65,7 @@
       "properties": {
         "name": { "type": "string", "minLength": 1 },
         "kind": { "enum": ["tac", "external"] },
-        "tacId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/tacId" },
+        "tacId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/tacId" },
         "description": { "type": "string" }
       }
     }

package/schemas/tad.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/tad.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.0/tad.schema.json",
   "title": "RCF Technical Architecture Document",
   "description": "Master Technical Architecture Document. One per project. TACs and ADRs each carry the mandatory tadId parent reference; the TAD does not list them. The walker computes both children lists by inverting TAC.tadId and ADR.tadId at load time. The schema defines the FULL set of possible sections; what's required for a given project is a tooling decision.",
   "type": "object",
@@ -15,10 +15,10 @@
     "updatedAt"
   ],
   "properties": {
-    "tadId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/tadId" },
-    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/prdId" },
-    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/version" },
-    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/authoringStatus" },
+    "tadId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/tadId" },
+    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/prdId" },
+    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/version" },
+    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/authoringStatus" },
 
     "systemOverview": { "$ref": "#/$defs/systemOverview" },
 
@@ -32,8 +32,8 @@
     "deploymentArchitecture": { "$ref": "#/$defs/deploymentArchitecture" },
     "operationalConcerns": { "$ref": "#/$defs/operationalConcerns" },
 
-    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" },
-    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" }
+    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" }
   },
   "$defs": {
     "systemOverview": {

package/schemas/test-suite.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/test-suite.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.0/test-suite.schema.json",
   "title": "RCF Test Suite",
   "description": "One file per Test Suite. Verifies one or more Acceptance Criteria (on the User Story identified by usId) via inline Test Cases. Test Suites hold the AC references; ACs stay clean of downstream references. Test-run status per TC is authored (Phase 3.7) and later derived from real test runs (Phase 6+).",
   "type": "object",
@@ -18,24 +18,24 @@
     "updatedAt"
   ],
   "properties": {
-    "id": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/tsId" },
-    "usId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/usId" },
+    "id": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/tsId" },
+    "usId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/usId" },
     "title": { "type": "string", "minLength": 1 },
     "purpose": { "type": "string", "minLength": 1 },
     "testLevel": { "enum": ["unit", "integration", "e2e", "contract", "manual"] },
     "acIds": {
       "type": "array",
       "minItems": 1,
-      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/acId" }
+      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/acId" }
     },
     "testCases": {
       "type": "array",
       "minItems": 0,
       "items": { "$ref": "#/$defs/testCase" }
     },
-    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/authoringStatus" },
-    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" },
-    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" }
+    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/authoringStatus" },
+    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" }
   },
   "$defs": {
     "testCase": {
@@ -48,7 +48,7 @@
           "pattern": "^TC-\\d{3}-[a-z0-9-]+$",
           "description": "Test Case identifier. TS suffix (three digits) joined to a lowercase alphanumeric slug (hyphens allowed)."
         },
-        "acId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/acId" },
+        "acId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/acId" },
         "description": { "type": "string", "minLength": 1 },
         "testPointer": {
           "type": "string",

package/schemas/user-story.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.stravica.io/rcf/v0.2.0/user-story.schema.json",
+  "$id": "https://schemas.stravica.io/rcf/v0.3.0/user-story.schema.json",
   "title": "RCF User Story",
   "description": "User Story document. One file per US. Contains its Acceptance Criteria inline as acceptanceCriteria[].",
   "type": "object",
@@ -20,11 +20,11 @@
     "updatedAt"
   ],
   "properties": {
-    "usId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/usId" },
-    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/prdId" },
-    "reqId": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/reqId" },
-    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/version" },
-    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/authoringStatus" },
+    "usId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/usId" },
+    "prdId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/prdId" },
+    "reqId": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/reqId" },
+    "version": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/version" },
+    "status": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/authoringStatus" },
     "title": { "type": "string", "minLength": 1 },
     "description": { "type": "string" },
     "asA": { "type": "string", "minLength": 1 },
@@ -38,10 +38,10 @@
     "tacIds": {
       "type": "array",
       "minItems": 0,
-      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/tacId" }
+      "items": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/tacId" }
     },
-    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" },
-    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/timestamp" }
+    "createdAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/timestamp" }
   },
   "$defs": {
     "acceptanceCriterion": {
@@ -49,7 +49,7 @@
       "additionalProperties": false,
       "required": ["id", "description", "testable"],
       "properties": {
-        "id": { "$ref": "https://schemas.stravica.io/rcf/v0.2.0/common.schema.json#/$defs/acId" },
+        "id": { "$ref": "https://schemas.stravica.io/rcf/v0.3.0/common.schema.json#/$defs/acId" },
         "description": { "type": "string", "minLength": 1 },
         "given": { "type": "string" },
         "when": { "type": "string" },