@stravica-ai/rcf-schemas 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -4,6 +4,10 @@ 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.1 - 2026-07-10
+
+Added optional `noCodeNodes` boolean to `fbs.schema.json`. It declares that a build spec produces no traceable code (docs-only or config-only): `rcf build --mark complete` records it via `--no-code-nodes` and the CodeNode gate skips the spec. Additive and backward-compatible - existing FBS documents without the field remain valid. Canonical `$id` URLs stay at `v0.3.0`, following the patch-release precedent set at 0.2.1.
+
 ## 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.

package/docs/fbs.md

@@ -35,6 +35,7 @@ Structurally, each FBS carries the mandatory `bsId` back-reference plus `buildOr
 | `riskLevel` | enum: `low`, `medium`, `high` | Risk classification. |
 | `domain` | string | Free-form domain label. |
 | `notes` | string | FBS-specific gotchas. |
+| `noCodeNodes` | boolean | Declares this build spec produces no traceable code (docs-only or config-only). `rcf build --mark complete` records it via `--no-code-nodes` and the CodeNode gate skips the spec. Added in 0.3.1. |
 
 ## `contextRequirements` shape
 

package/fixtures/invalid/fbs/fbs-007-nocodenodes-non-boolean.json

@@ -0,0 +1,14 @@
+{
+  "fbsId": "FBS-003",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 3,
+  "executionStatus": "complete",
+  "title": "Write the getting-started guide",
+  "summary": "Docs-only build spec with a malformed noCodeNodes value.",
+  "acIds": ["AC-003"],
+  "dependsOnFbsIds": [],
+  "noCodeNodes": "yes",
+  "createdAt": "2026-01-01T00:00:00Z",
+  "updatedAt": "2026-07-10T00:00:00Z"
+}

package/fixtures/valid/fbs/fbs-003-no-code-nodes.json

@@ -0,0 +1,14 @@
+{
+  "fbsId": "FBS-003",
+  "prdId": "PRD-001",
+  "bsId": "BS-001",
+  "buildOrder": 3,
+  "executionStatus": "complete",
+  "title": "Write the getting-started guide",
+  "summary": "Docs-only build spec: authors the getting-started guide under docs/. Produces no traceable code.",
+  "acIds": ["AC-003"],
+  "dependsOnFbsIds": [],
+  "noCodeNodes": true,
+  "createdAt": "2026-01-01T00:00:00Z",
+  "updatedAt": "2026-07-10T00:00:00Z"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stravica-ai/rcf-schemas",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "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/fbs.schema.json

@@ -84,6 +84,10 @@
     "riskLevel": { "enum": ["low", "medium", "high"] },
     "domain": { "type": "string" },
     "notes": { "type": "string" },
+    "noCodeNodes": {
+      "type": "boolean",
+      "description": "Declares this build spec produces no traceable code (docs-only or config-only). rcf build --mark complete records it via --no-code-nodes and the CodeNode gate skips the spec."
+    },
     "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" }
   }