rcf-lite 0.0.1 → 0.8.0

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

@@ -0,0 +1,52 @@
+{
+  "id": "TS-025",
+  "usId": "US-901",
+  "title": "`rcf verify` subcommand routing (0.7.1 consolidation)",
+  "purpose": "Verify the umbrella CLI mounts `rcf verify` as a first-class subcommand that dispatches to the same handlers the transition-grace `rcf-verify` alias bin exposes, that the top-level help advertises it, and that the alias bin emits a one-line stderr deprecation notice (suppressible via RCF_QUIET) when run directly.",
+  "testLevel": "unit",
+  "acIds": [
+    "AC-901-1",
+    "AC-901-2",
+    "AC-901-3"
+  ],
+  "testCases": [
+    {
+      "id": "TC-025-verify-routes-to-alias-dispatcher",
+      "acId": "AC-901-1",
+      "description": "the `verify` entry on the top-level SUBCOMMANDS map is the same `main` function the alias bin exports",
+      "status": "pending",
+      "testPointer": "test/cli/rcf-verify-subcommand.test.js::AC-901-1: `verify` on the top-level SUBCOMMANDS map is the alias bin's dispatcher"
+    },
+    {
+      "id": "TC-025-verify-help-parity",
+      "acId": "AC-901-1",
+      "description": "`rcf verify --help` and `rcf-verify --help` print byte-identical help",
+      "status": "pending",
+      "testPointer": "test/cli/rcf-verify-subcommand.test.js::AC-901-1 (routing surface): `rcf verify --help` dispatches to the same help block as `rcf-verify --help`"
+    },
+    {
+      "id": "TC-025-top-level-help-lists-verify",
+      "acId": "AC-901-2",
+      "description": "the top-level rcf --help output lists `verify <verb>` alongside the other commands",
+      "status": "pending",
+      "testPointer": "test/cli/rcf-verify-subcommand.test.js::AC-901-2: `rcf --help` advertises the verify subcommand"
+    },
+    {
+      "id": "TC-025-alias-emits-deprecation-notice",
+      "acId": "AC-901-3",
+      "description": "`rcf-verify` alias bin emits exactly one stderr line pointing at `rcf verify` when invoked directly",
+      "status": "pending",
+      "testPointer": "test/cli/rcf-verify-subcommand.test.js::AC-901-3: `rcf-verify` alias emits a one-line stderr deprecation notice on direct invocation"
+    },
+    {
+      "id": "TC-025-alias-honours-quiet-env",
+      "acId": "AC-901-3",
+      "description": "RCF_QUIET=1 silences the deprecation notice for scripted callers",
+      "status": "pending",
+      "testPointer": "test/cli/rcf-verify-subcommand.test.js::AC-901-3 (silencing): `rcf-verify` with RCF_QUIET=1 does not emit the deprecation notice"
+    }
+  ],
+  "status": "draft",
+  "createdAt": "2026-08-11T00:00:00Z",
+  "updatedAt": "2026-08-11T00:00:00Z"
+}

package/rcf/user-stories/us-101.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-101",
+  "prdId": "PRD-001",
+  "reqId": "REQ-001",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Initialise an RCF project on disk",
+  "description": "A project owner starts a new RCF project and gets the canonical on-disk structure created for them, ready to receive documents.",
+  "asA": "project owner starting a new RCF project",
+  "iWant": "to run a single initialise command that creates the rcf folder, the manifest and the root document placeholders",
+  "soThat": "I have a valid RCF project structure on disk without authoring any layout by hand",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-101-1",
+      "description": "Initialise creates the rcf folder and a manifest declaring the three roots",
+      "given": "an empty target directory",
+      "when": "the initialise command runs",
+      "then": "an rcf folder exists containing a manifest that declares prd, tad and bs root references and validates against the manifest schema",
+      "testable": true
+    },
+    {
+      "id": "AC-101-2",
+      "description": "Initialise refuses to overwrite an existing project",
+      "given": "a directory that already contains an rcf manifest",
+      "when": "the initialise command runs without an explicit force flag",
+      "then": "the command exits non-zero, makes no changes and reports that a project already exists",
+      "testable": true
+    },
+    {
+      "id": "AC-101-3",
+      "description": "Every document is discoverable by walking from the roots",
+      "given": "an initialised project with a PRD, a TAD and a Build Sequence",
+      "when": "the project is loaded",
+      "then": "all child documents are resolved by reading the parent id lists, with no child enumeration in the manifest",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-06-25T00:00:00Z"
+}

package/rcf/user-stories/us-102.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-102",
+  "prdId": "PRD-001",
+  "reqId": "REQ-001",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Load and walk the tree",
+  "description": "A project owner or an AI tool loads the whole RCF tree from on-disk files in one operation, producing a single validated in-memory view for later commands.",
+  "asA": "project owner or AI tool",
+  "iWant": "to load the whole RCF tree from the on-disk files in one operation",
+  "soThat": "every later command works against a single, validated in-memory view of the project",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-102-1",
+      "description": "Loading reads the manifest roots and resolves every child by walking parent id lists",
+      "given": "an initialised project",
+      "when": "the tree is loaded",
+      "then": "the manifest roots are read and every child is resolved by walking the parent id lists",
+      "testable": true
+    },
+    {
+      "id": "AC-102-2",
+      "description": "Missing or unparseable files are reported as structured errors and do not crash the load",
+      "given": "a document file that is missing or unparseable",
+      "when": "the tree is loaded",
+      "then": "the load reports a structured error naming the document id and the file path, and does not crash",
+      "testable": true
+    },
+    {
+      "id": "AC-102-3",
+      "description": "Broken references are reported as part of project health, not swallowed",
+      "given": "a reference to a document id that has no file",
+      "when": "the tree is loaded",
+      "then": "the broken reference is reported as part of project health, not swallowed",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-06-25T00:00:00Z"
+}

package/rcf/user-stories/us-201.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-201",
+  "prdId": "PRD-001",
+  "reqId": "REQ-002",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Render the tree as a diagram",
+  "description": "A non-coding owner sees the whole RCF tree at a glance as a diagram of documents and the links between them.",
+  "asA": "project owner who cannot read code",
+  "iWant": "a diagram of the whole RCF tree showing documents and the links between them",
+  "soThat": "I can see what is specified at a glance",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-201-1",
+      "description": "The tree is rendered as per-requirement subdiagrams carrying chain edges",
+      "given": "a loaded project",
+      "when": "the diagrams are generated",
+      "then": "each requirement is rendered as its own subdiagram showing the requirement, its user stories and acceptance criteria with edges following the chain and FBS delivery back-links, scoped to that requirement only",
+      "testable": true
+    },
+    {
+      "id": "AC-201-2",
+      "description": "Broken references are marked visibly rather than omitted",
+      "given": "a project with a broken reference",
+      "when": "the diagram is generated",
+      "then": "the broken link is marked visibly rather than omitted silently",
+      "testable": true
+    },
+    {
+      "id": "AC-201-3",
+      "description": "The diagram is produced as source that renders without a running server",
+      "given": "a valid project",
+      "when": "the diagram is generated",
+      "then": "it is produced as a diagram source that renders without a running server",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-07-29T13:34:38.816Z"
+}

package/rcf/user-stories/us-202.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-202",
+  "prdId": "PRD-001",
+  "reqId": "REQ-002",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Browse the tree as a static page",
+  "description": "A project owner opens a static browsable page of the whole RCF tree locally, with each document shown as readable text and inter-document links navigating between sections.",
+  "asA": "project owner",
+  "iWant": "a browsable static page of the whole tree that I can open locally",
+  "soThat": "I can read each document's content and follow its links without a server or a JSON viewer",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-202-1",
+      "description": "The view serves a live page from a local server process and writes no files",
+      "given": "a loaded project",
+      "when": "the view runs",
+      "then": "a valid HTML5 page is served live by a local server process and no files are written to disk",
+      "testable": true
+    },
+    {
+      "id": "AC-202-2",
+      "description": "Each document's key fields are rendered as readable text, not raw JSON",
+      "given": "the page",
+      "when": "a document is shown",
+      "then": "its key fields are rendered as readable text, not raw JSON",
+      "testable": true
+    },
+    {
+      "id": "AC-202-3",
+      "description": "Inter-document links navigate between sections",
+      "given": "the page",
+      "when": "a document links to another",
+      "then": "the link navigates to that document's section",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-07-29T13:34:38.914Z"
+}

package/rcf/user-stories/us-203.json

@@ -0,0 +1,32 @@
+{
+  "usId": "US-203",
+  "prdId": "PRD-001",
+  "reqId": "REQ-002",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "View reflects current on-disk state",
+  "description": "A project owner regenerates the view and sees exactly what is currently on disk, never a stale snapshot.",
+  "asA": "project owner",
+  "iWant": "the view to reflect exactly what is on disk at the moment it is generated",
+  "soThat": "I never review a stale snapshot",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-203-1",
+      "description": "An edit on disk is present after the view is regenerated",
+      "given": "a document edited on disk",
+      "when": "the view is regenerated",
+      "then": "the change is present in the output",
+      "testable": true
+    },
+    {
+      "id": "AC-203-2",
+      "description": "The view is produced fresh from the on-disk tree and carries no cached prior state",
+      "given": "the view output",
+      "when": "it is generated",
+      "then": "it is produced fresh from the on-disk tree and carries no cached prior state",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-06-25T00:00:00Z"
+}

package/rcf/user-stories/us-301.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-301",
+  "prdId": "PRD-001",
+  "reqId": "REQ-003",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Read any document",
+  "description": "A project owner or AI tool reads any RCF document by id and gets its current content together with a validity report.",
+  "asA": "project owner or AI tool",
+  "iWant": "to read any RCF document by its id",
+  "soThat": "I can inspect a document's current content without opening files by hand",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-301-1",
+      "description": "Reading a valid document returns it and reports it as valid",
+      "given": "a document id",
+      "when": "read runs",
+      "then": "the document is returned and reported as valid against its schema",
+      "testable": true
+    },
+    {
+      "id": "AC-301-2",
+      "description": "Reading an id with no file returns a structured not-found error naming the id",
+      "given": "an id with no file",
+      "when": "read runs",
+      "then": "a structured not-found error is returned naming the id",
+      "testable": true
+    },
+    {
+      "id": "AC-301-3",
+      "description": "Reading an invalid document returns both the content and the validation errors",
+      "given": "a document that exists but fails validation",
+      "when": "read runs",
+      "then": "the document is returned together with the validation errors, so the caller sees both content and the problem",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-06-25T00:00:00Z"
+}

package/rcf/user-stories/us-302.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-302",
+  "prdId": "PRD-001",
+  "reqId": "REQ-003",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Create a document with parent linkage",
+  "description": "A project owner or AI tool creates a new RCF document and the tool maintains the parent linkage automatically.",
+  "asA": "project owner or AI tool",
+  "iWant": "to create a new RCF document and have its parent linkage maintained",
+  "soThat": "the tree stays consistent without me editing two files by hand",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-302-1",
+      "description": "Creating a requirement writes a validating child file carrying the parent edge; the PRD file is not modified",
+      "given": "a request to create a requirement under a PRD",
+      "when": "create runs",
+      "then": "the requirement file is written carrying its prdId parent edge and validating, and the parent PRD file is not modified (child-owned parent edges)",
+      "testable": true
+    },
+    {
+      "id": "AC-302-2",
+      "description": "Creating a document with a conflicting id writes nothing and returns a clear conflict error",
+      "given": "a request to create a document whose id already exists",
+      "when": "create runs",
+      "then": "no file is written and a clear conflict error is returned",
+      "testable": true
+    },
+    {
+      "id": "AC-302-3",
+      "description": "Creating an invalid document writes nothing and returns the validation error",
+      "given": "a request to create a document that would not validate",
+      "when": "create runs",
+      "then": "nothing is written and the validation error is returned",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-07-29T13:34:39.028Z"
+}

package/rcf/user-stories/us-303.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-303",
+  "prdId": "PRD-001",
+  "reqId": "REQ-003",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Update fields safely",
+  "description": "A project owner or AI tool updates fields on an existing document; valid updates persist and invalid updates are refused without disturbing disk state.",
+  "asA": "project owner or AI tool",
+  "iWant": "to update fields on an existing document",
+  "soThat": "I can revise content without rewriting the whole document or risking an invalid result",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-303-1",
+      "description": "A valid update is persisted with updatedAt advanced and validates",
+      "given": "a valid field update",
+      "when": "update runs",
+      "then": "the document is rewritten with the change and its updatedAt timestamp advanced, and it validates",
+      "testable": true
+    },
+    {
+      "id": "AC-303-2",
+      "description": "An update that would invalidate the document leaves disk unchanged and returns the validation error",
+      "given": "an update that would make the document invalid",
+      "when": "update runs",
+      "then": "the document on disk is unchanged and the validation error is returned",
+      "testable": true
+    },
+    {
+      "id": "AC-303-3",
+      "description": "Updating a non-existent document returns a not-found error and writes nothing",
+      "given": "an update to a document that does not exist",
+      "when": "update runs",
+      "then": "a not-found error is returned and nothing is written",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-06-25T00:00:00Z"
+}

package/rcf/user-stories/us-304.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-304",
+  "prdId": "PRD-001",
+  "reqId": "REQ-003",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Delete with reference safety",
+  "description": "A project owner or AI tool deletes a document and the tool refuses to silently orphan its dependants, offering a cascade flag for intentional sub-tree removal.",
+  "asA": "project owner or AI tool",
+  "iWant": "to delete a document without silently orphaning the documents that depend on it",
+  "soThat": "I cannot accidentally break the tree",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-304-1",
+      "description": "Deleting a document with dependants without the cascade flag is refused and the blocking references are listed",
+      "given": "a document with children or inbound references",
+      "when": "delete runs without a cascade flag",
+      "then": "nothing is deleted and the blocking references are listed",
+      "testable": true
+    },
+    {
+      "id": "AC-304-2",
+      "description": "Deleting with the cascade flag removes the sub-tree and cleans parent references, leaving the tree valid",
+      "given": "a document with children",
+      "when": "delete runs with a cascade flag",
+      "then": "the document and its children are removed and every parent reference to them is cleaned up, leaving the tree valid",
+      "testable": true
+    },
+    {
+      "id": "AC-304-3",
+      "description": "Deleting an unreferenced document removes the file and updates the parent id list",
+      "given": "a document with no references",
+      "when": "delete runs",
+      "then": "the file is removed and the parent id list is updated, leaving the tree valid",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-06-25T00:00:00Z"
+}

package/rcf/user-stories/us-401.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-401",
+  "prdId": "PRD-001",
+  "reqId": "REQ-004",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Coverage report",
+  "description": "A project owner generates a coverage report over the tree, listing what is unspecified and untested without reading every document.",
+  "asA": "project owner",
+  "iWant": "a coverage report over the tree",
+  "soThat": "I can see at a glance what is unspecified or untested without reading every document",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-401-1",
+      "description": "Coverage lists every requirement that has no user story",
+      "given": "a loaded project",
+      "when": "coverage runs",
+      "then": "it lists every requirement that has no user story",
+      "testable": true
+    },
+    {
+      "id": "AC-401-2",
+      "description": "Coverage lists every acceptance criterion that has no test suite",
+      "given": "a loaded project",
+      "when": "coverage runs",
+      "then": "it lists every acceptance criterion that has no test suite",
+      "testable": true
+    },
+    {
+      "id": "AC-401-3",
+      "description": "A fully covered project reports complete coverage with no gaps",
+      "given": "a fully covered project",
+      "when": "coverage runs",
+      "then": "it reports complete coverage with no gaps",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-06-25T00:00:00Z"
+}

package/rcf/user-stories/us-402.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-402",
+  "prdId": "PRD-001",
+  "reqId": "REQ-004",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Trace forward and back",
+  "description": "A project owner or AI tool traces from any document forward to its descendants or back to its ancestors, walking only the intent chain.",
+  "asA": "project owner or AI tool",
+  "iWant": "to trace from any document forward to its descendants and back to its ancestors",
+  "soThat": "I can follow an agreed decision down to the work that satisfies it, or a piece of work up to the decision it serves",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-402-1",
+      "description": "Trace forward from a requirement returns the user stories, acceptance criteria and any test suites beneath it",
+      "given": "a requirement id",
+      "when": "trace forward runs",
+      "then": "it returns the user stories, acceptance criteria and any test suites beneath it",
+      "testable": true
+    },
+    {
+      "id": "AC-402-2",
+      "description": "Trace back from an acceptance criterion returns the parent user story, its requirement and the PRD",
+      "given": "an acceptance criterion id",
+      "when": "trace back runs",
+      "then": "it returns the parent user story, its requirement and the PRD",
+      "testable": true
+    },
+    {
+      "id": "AC-402-3",
+      "description": "Forward trace surfaces delivering FBS as cross-link leaves; backward trace walks the intent chain only",
+      "given": "the trace",
+      "when": "it is computed",
+      "then": "forward trace surfaces an AC's delivering FBS items as cross-link leaves and never traverses through the FBS layer, and backward trace walks the intent chain only (AC to US to REQ to PRD) with no FBS nodes",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-07-29T13:34:39.127Z"
+}

package/rcf/user-stories/us-403.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-403",
+  "prdId": "PRD-001",
+  "reqId": "REQ-004",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Impact analysis",
+  "description": "A project owner or AI tool asks what is affected if a document changes and gets the descendants and FBS slots that ripple from the edit.",
+  "asA": "project owner or AI tool",
+  "iWant": "to ask what is affected if I change a given document",
+  "soThat": "I understand the ripple of an edit before I make it",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-403-1",
+      "description": "Impact analysis on a requirement returns descendant documents and FBS slots whose acceptance criteria fall under it",
+      "given": "a requirement id",
+      "when": "impact analysis runs",
+      "then": "it returns the descendant documents that depend on it and any FBS slots whose acceptance criteria fall under it",
+      "testable": true
+    },
+    {
+      "id": "AC-403-2",
+      "description": "Impact analysis on an architecture document returns the FBS items that reference it as context",
+      "given": "an architecture document id",
+      "when": "impact analysis runs",
+      "then": "it returns the FBS items that reference it as context",
+      "testable": true
+    },
+    {
+      "id": "AC-403-3",
+      "description": "Impact analysis on a document with no dependents reports an empty impact set",
+      "given": "a document with no dependents",
+      "when": "impact analysis runs",
+      "then": "it reports an empty impact set",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-06-25T00:00:00Z"
+}

package/rcf/user-stories/us-501.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-501",
+  "prdId": "PRD-001",
+  "reqId": "REQ-005",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Assemble a build prompt",
+  "description": "A project owner or AI tool turns a Functional Build Specification into a single implementation prompt with the acceptance criteria and the architectural context the coding agent needs.",
+  "asA": "project owner or AI tool",
+  "iWant": "to turn a Functional Build Specification into a single implementation prompt",
+  "soThat": "a coding agent has everything it needs to implement the slice, traceable to the acceptance criteria it must satisfy",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-501-1",
+      "description": "Build assembly walks each AC in acIds to its parent user story and includes the Given/When/Then in the prompt",
+      "given": "an FBS id",
+      "when": "build assembly runs",
+      "then": "it walks each acceptance criterion in acIds to its parent user story and includes the criterion's Given/When/Then in the prompt",
+      "testable": true
+    },
+    {
+      "id": "AC-501-2",
+      "description": "Build assembly walks the referenced TACs and ADRs and includes their relevant content in the prompt",
+      "given": "an FBS that declares architectural context",
+      "when": "build assembly runs",
+      "then": "it walks the referenced TACs and ADRs and includes their relevant content in the prompt",
+      "testable": true
+    },
+    {
+      "id": "AC-501-3",
+      "description": "The assembled prompt is a single markdown document naming FBS, summary, approach, ACs and architectural context",
+      "given": "the assembled prompt",
+      "when": "it is produced",
+      "then": "it is a single markdown document naming the FBS, its summary and approach, the acceptance criteria, and the architectural context",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-06-25T00:00:00Z"
+}

package/rcf/user-stories/us-502.json

@@ -0,0 +1,40 @@
+{
+  "usId": "US-502",
+  "prdId": "PRD-001",
+  "reqId": "REQ-005",
+  "version": "0.1.0",
+  "status": "draft",
+  "title": "Build order respects dependencies",
+  "description": "A project owner or AI tool computes a build order that honours the dependency graph declared on FBS items, surfaces parallel-safe items, and detects cycles.",
+  "asA": "project owner or AI tool",
+  "iWant": "the build order to respect the dependency graph declared on the FBS items",
+  "soThat": "no slice is built before the work it depends on",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-502-1",
+      "description": "The computed order is a valid topological order in which dependencies precede dependents",
+      "given": "a set of FBS items with declared dependencies",
+      "when": "the build order is computed",
+      "then": "it is a valid ordering in which every dependency precedes the items that depend on it",
+      "testable": true
+    },
+    {
+      "id": "AC-502-2",
+      "description": "FBS items with no dependency between them are reported as parallel-safe",
+      "given": "FBS items with no dependency between them",
+      "when": "the build order is computed",
+      "then": "they are reported as parallel-safe",
+      "testable": true
+    },
+    {
+      "id": "AC-502-3",
+      "description": "A dependency cycle is detected and reported rather than producing a partial order",
+      "given": "a dependency cycle",
+      "when": "the build order is computed",
+      "then": "the cycle is detected and reported rather than producing a partial order",
+      "testable": true
+    }
+  ],
+  "createdAt": "2026-06-25T00:00:00Z",
+  "updatedAt": "2026-06-25T00:00:00Z"
+}