@rsaglobaltech/specgate 0.21.0 → 0.22.1

package/dist/scripts/docs/journey-storyboard.js

@@ -24,56 +24,62 @@ exports.SCRATCH = {
     steps: [
         // Before phase 1 — writing the brief (start/write-the-brief), on a second
         // project, "Lingo", so the court-bookings journey starts clean.
-        {
-            id: "brief-none",
-            page: "start/write-the-brief",
-            cwd: "lingo",
-            argv: sg("draft"),
-            surface: "draft",
-            maxLines: 24,
-            expectExit: 1,
-        },
         {
             id: "brief-new",
             page: "start/write-the-brief",
             cwd: "lingo-new",
-            argv: sg("draft", "--new-brief"),
-            surface: "draft",
-            maxLines: 16,
+            argv: sg("propose", "--from-brief", "--new-brief"),
+            surface: "propose",
+            maxLines: 18,
         },
         {
-            id: "brief-plain",
+            id: "brief-agent",
             page: "start/write-the-brief",
             cwd: "lingo",
-            argv: sg("draft"),
-            surface: "draft",
-            maxLines: 60,
+            argv: sg("propose", "--from-brief", "--agent", "claude -p"),
+            surface: "propose",
+            maxLines: 30,
         },
         {
-            id: "brief-agent",
+            id: "brief-cards-agent",
             page: "start/write-the-brief",
             cwd: "lingo",
-            argv: sg("draft", "--agent", "claude -p"),
-            surface: "draft",
-            maxLines: 30,
+            argv: sg("propose", "--from-brief", "--agent", "claude -p"),
+            surface: "propose",
+            maxLines: 20,
         },
         {
-            id: "brief-error",
+            id: "brief-check",
             page: "start/write-the-brief",
             cwd: "lingo",
-            argv: sg("draft"),
-            surface: "draft",
-            maxLines: 20,
-            expectExit: 1,
+            argv: sg("propose", "--from-brief", "--check"),
+            surface: "propose",
+            maxLines: 24,
         },
         {
             id: "brief-ready",
             page: "start/write-the-brief",
             cwd: "lingo",
-            argv: sg("draft"),
-            surface: "draft",
+            argv: sg("propose", "--from-brief"),
+            surface: "propose",
             maxLines: 16,
         },
+        {
+            id: "brief-draft",
+            page: "start/write-the-brief",
+            cwd: "lingo",
+            argv: sg("propose", "--from-brief", "courses"),
+            surface: "propose",
+            maxLines: 12,
+        },
+        {
+            id: "brief-scope",
+            page: "start/write-the-brief",
+            cwd: "lingo",
+            shell: "sed -n '/^## 0/,/^## 1/p' docs/specs/changes/draft-courses/DRAFTING.md | sed '$d'",
+            surface: null,
+            maxLines: 40,
+        },
         // 1 — Install
         {
             id: "scratch-init",
@@ -104,24 +110,24 @@ exports.SCRATCH = {
             id: "scratch-draft-list",
             page: "start/scratch-2-specify",
             cwd: S,
-            argv: sg("draft"),
-            surface: "draft",
+            argv: sg("propose", "--from-brief"),
+            surface: "propose",
             maxLines: 12,
         },
         {
             id: "scratch-draft-open",
             page: "start/scratch-2-specify",
             cwd: S,
-            argv: sg("draft", "bookings"),
-            surface: "draft",
+            argv: sg("propose", "--from-brief", "bookings"),
+            surface: "propose",
             maxLines: 16,
         },
         {
             id: "scratch-draft-check",
             page: "start/scratch-2-specify",
             cwd: S,
-            argv: sg("draft", "bookings"),
-            surface: "draft",
+            argv: sg("propose", "--from-brief", "bookings"),
+            surface: "propose",
             maxLines: 26,
             expectExit: 1,
         },
@@ -129,8 +135,8 @@ exports.SCRATCH = {
             id: "scratch-draft-check-again",
             page: "start/scratch-2-specify",
             cwd: S,
-            argv: sg("draft", "bookings"),
-            surface: "draft",
+            argv: sg("propose", "--from-brief", "bookings"),
+            surface: "propose",
             maxLines: 12,
         },
         {
@@ -213,11 +219,11 @@ exports.SCRATCH = {
             maxLines: 12,
         },
         {
-            id: "scratch-new",
+            id: "scratch-propose",
             page: "start/scratch-5-every-day",
             cwd: S,
-            argv: sg("new", "A member sees which courts are free on a day"),
-            surface: "new",
+            argv: sg("propose", "free-courts"),
+            surface: "propose",
             maxLines: 14,
         },
         {
@@ -278,20 +284,28 @@ exports.EXISTING = {
             maxLines: 20,
         },
         {
-            id: "existing-new",
+            id: "existing-propose",
             page: "start/existing-2-specify",
             cwd: E,
-            argv: sg("new", "An invoice total is rounded to the cent"),
-            surface: "new",
+            argv: sg("propose", "invoice-rounding"),
+            surface: "propose",
             maxLines: 14,
         },
         {
-            id: "existing-feature",
+            id: "existing-delta",
             page: "start/existing-2-specify",
             cwd: E,
-            shell: "cat features/an-invoice-total-is-rounded-to.feature",
+            shell: "cat docs/specs/changes/invoice-rounding/specs/invoice-rounding/spec.md",
             surface: null,
-            maxLines: 14,
+            maxLines: 16,
+        },
+        {
+            id: "existing-status-change",
+            page: "start/existing-2-specify",
+            cwd: E,
+            argv: sg("status"),
+            surface: "status",
+            maxLines: 20,
         },
         // 3 — Close the first
         {
@@ -319,6 +333,15 @@ exports.EXISTING = {
             surface: "apply",
             maxLines: 14,
         },
+        // A change is archived once every requirement it adds is applied (ADR-0035).
+        {
+            id: "existing-archive",
+            page: "start/existing-3-first-requirement",
+            cwd: E,
+            argv: sg("archive", "invoice-rounding"),
+            surface: "archive",
+            maxLines: 14,
+        },
         // 4 — The gate in CI
         {
             id: "existing-ci",

package/dist/scripts/docs/journey-storyboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"journey-storyboard.js","sourceRoot":"","sources":["../../../scripts/docs/journey-storyboard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"journey-storyboard.js","sourceRoot":"","sources":["../../../scripts/docs/journey-storyboard.ts"],"names":[],"mappings":"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"}

package/dist/scripts/docs/nav.js

@@ -20,28 +20,28 @@ exports.navEntry = navEntry;
 exports.neighbours = neighbours;
 exports.journeyOf = journeyOf;
 /**
- * Simplification plan, phase 6: the places a reader goes, in the order they
- * need them — start, every day, the gate, existing code, reference,
- * extensions — and everything else under "Advanced". Every shipped document
- * is still in exactly one section.
+ * The places a reader goes, in the order they need them: start, where the
+ * work comes from, every day, the gate, existing code, reference, extensions;
+ * then forja, a companion tool, and everything else under "Advanced". Every
+ * shipped document is still in exactly one section.
  */
 exports.NAV = [
     {
         title: "Start",
         icon: "rocket",
-        summary: "Two journeys of five phases — from scratch, or on code you already have — every output recorded from the CLI.",
+        summary: "Install it, learn the ideas behind it, and follow one of two journeys of five short steps — a new project, or code you already have.",
         entries: [
             {
                 slug: "getting-started",
                 group: "Begin",
-                label: "Pick your path",
-                blurb: "Starting from scratch, or bringing code you already have? Both journeys at a glance.",
+                label: "Getting started",
+                blurb: "Install it, choose where you start and where the work comes from, then the four verbs.",
             },
             {
-                slug: "quickstart",
+                slug: "concepts",
                 group: "Begin",
-                label: "You cloned a spec-driven repo",
-                blurb: "Someone handed you a spec-driven repository. Start here instead.",
+                label: "Concepts",
+                blurb: "The six ideas behind every command, and the vocabulary: change, delta, draft, gate, matrix.",
             },
             {
                 slug: "start/scratch-1-install",
@@ -51,19 +51,13 @@ exports.NAV = [
                 label: "Install and set up",
                 blurb: "Create the project with your own tools, set Specgate up, run the gate once.",
             },
-            {
-                slug: "start/write-the-brief",
-                group: "From scratch",
-                label: "Write the brief",
-                blurb: "Your plan as docs/brief.md, the four fields on top — or let your agent propose them.",
-            },
             {
                 slug: "start/scratch-2-specify",
                 group: "From scratch",
                 step: 2,
                 time: "20–60 min a module",
                 label: "Specify",
-                blurb: "The brief becomes a draft per module, checked by `draft --check`, then archived.",
+                blurb: "The brief becomes a draft change per module, checked against the brief, then reviewed by a person.",
             },
             {
                 slug: "start/scratch-3-build",
@@ -79,7 +73,7 @@ exports.NAV = [
                 step: 4,
                 time: "2 min",
                 label: "Prove",
-                blurb: "`done` closes it only through the gate; `check` and `report` show where it stands.",
+                blurb: "`apply` marks a requirement Implemented only through the gate; `check` and `report` show where it stands.",
             },
             {
                 slug: "start/scratch-5-every-day",
@@ -87,7 +81,7 @@ exports.NAV = [
                 step: 5,
                 time: "10 min, once",
                 label: "Every day",
-                blurb: "The gate in CI, the five-command loop, and Gato.",
+                blurb: "The gate in CI, and the four verbs every day.",
             },
             {
                 slug: "start/existing-1-adopt",
@@ -111,7 +105,7 @@ exports.NAV = [
                 step: 3,
                 time: "5 min",
                 label: "First requirement",
-                blurb: "The test you already have names it; `done` closes it.",
+                blurb: "The test you already have names it; `apply` marks it Implemented.",
             },
             {
                 slug: "start/existing-4-ci",
@@ -128,73 +122,38 @@ exports.NAV = [
                 label: "Every day",
                 blurb: "One behaviour per bug fix, one module at a time.",
             },
+            {
+                slug: "quickstart",
+                group: "Someone else set it up",
+                label: "Joining a project",
+                blurb: "The repository already uses Specgate: see where it stands and deliver your first requirement.",
+            },
         ],
     },
     {
-        // ADR-0033: forja's documentation lives here, one site for both tools.
-        title: "New project (forja)",
-        icon: "package",
-        summary: "Start from an empty folder with a whole application: the architecture in place, sign-in working, Specgate adopted.",
+        title: "Where work comes from",
+        icon: "compass",
+        summary: "Three entries into the same lifecycle: a change you describe, a client brief, or a Jira ticket.",
         entries: [
             {
-                slug: "forja/getting-started",
-                group: "Generate",
-                label: "Getting started",
-                blurb: "Generate a Next.js + Expo monorepo in TypeScript, with the hexagon in place.",
-            },
-            {
-                slug: "forja/java",
-                group: "Generate",
-                label: "Java backends",
-                blurb: "A Spring Boot or Quarkus API, a Next.js web app and Keycloak sign-in.",
-            },
-            {
-                slug: "forja/daily-use",
-                group: "Grow it",
-                label: "Daily use",
-                blurb: "Add use cases, entities and ports where the architecture expects them; check the setup.",
-            },
-            {
-                slug: "forja/specgate",
-                group: "Grow it",
-                label: "With Specgate",
-                blurb: "How a generated project adopts Specgate, and how a use case names its requirement.",
-            },
-            {
-                slug: "forja/e2e",
-                group: "Grow it",
-                label: "End-to-end tests",
-                blurb: "Playwright drives the sign-in flow in a real browser.",
-            },
-            {
-                slug: "forja/cli",
-                group: "Reference",
-                label: "forja command line",
-                blurb: "init, add, doctor: every flag and the values it accepts.",
-            },
-            {
-                slug: "forja/config",
-                group: "Reference",
-                label: "forja.config.json",
-                blurb: "Every field, its values and its defaults.",
+                slug: "start/write-the-brief",
+                label: "Write the brief",
+                blurb: "Your plan as docs/brief.md, the four fields on top — or let your agent propose them.",
             },
             {
-                slug: "forja/generated-project",
-                group: "Reference",
-                label: "What it generates",
-                blurb: "Recipe by recipe: the folders, the files, the versions.",
+                slug: "from-a-brief",
+                label: "From a client brief",
+                blurb: "A brief to a reviewed draft: assumptions, open questions and the draft checklist.",
             },
             {
-                slug: "forja/architecture",
-                group: "Reference",
-                label: "The generated architecture",
-                blurb: "The hexagon forja generates and the rules that keep it.",
+                slug: "from-a-ticket",
+                label: "From a Jira ticket",
+                blurb: "A story with acceptance criteria to a change checked against it, a branch and a pull request.",
             },
             {
-                slug: "forja/contributing",
-                group: "Reference",
-                label: "Contributing to forja",
-                blurb: "Develop forja, write a recipe, verify what it generates.",
+                slug: "existing-project-with-jira",
+                label: "An existing codebase, with Jira",
+                blurb: "Adopt a years-old codebase whose work arrives as Jira tickets: the spec grows ticket by ticket.",
             },
         ],
     },
@@ -208,70 +167,23 @@ exports.NAV = [
                 label: "Your team's first PR",
                 blurb: "What the author writes, what the reviewer reads, and what to do when check fails.",
             },
-            {
-                slug: "writing-specs",
-                label: "Writing specs",
-                blurb: "Requirements, scenarios and the traceability matrix.",
-            },
             {
                 slug: "reviewing-changes",
-                label: "Reviewing changes",
+                label: "Change a shipped requirement",
                 blurb: "Propose, review and archive a change to specs that already shipped.",
             },
             {
-                slug: "from-a-brief",
-                label: "From a client brief",
-                blurb: "A brief to a reviewed draft: assumptions, open questions and the draft checklist.",
+                slug: "writing-specs",
+                label: "Writing specs",
+                blurb: "Requirements, scenarios and the traceability matrix.",
             },
             {
                 slug: "new-project",
-                label: "A new project, step by step",
+                label: "A new product, step by step",
                 blurb: "The twelve steps six pilots took, from a client's brief to a running product.",
             },
         ],
     },
-    {
-        title: "Proven on real products",
-        icon: "check",
-        summary: "Six products built from real client briefs — what worked, and what Specgate got wrong.",
-        entries: [
-            {
-                slug: "projects/index",
-                label: "All six, compared",
-                blurb: "Brief, stack, requirements and tests for each pilot, side by side.",
-            },
-            {
-                slug: "projects/rebar-crew",
-                label: "Rebar Crew — field app",
-                blurb: "Expo + Next.js: 47 of 47, after a first round that was done and unusable.",
-            },
-            {
-                slug: "projects/bookings",
-                label: "Bookings — appointments",
-                blurb: "Next.js from a detailed brief: 38 of 38 in five cycles.",
-            },
-            {
-                slug: "projects/credit-shop",
-                label: "Credit shop — e-commerce",
-                blurb: "A five-line brief became 24 requirements, nearly every value an assumption.",
-            },
-            {
-                slug: "projects/fincore",
-                label: "FinCore — core banking",
-                blurb: "Spring Boot: 59 of 60, one legal question left to the client.",
-            },
-            {
-                slug: "projects/eventtech",
-                label: "EventTech — event operations",
-                blurb: "Quarkus with event sourcing and real time: 38 of 38.",
-            },
-            {
-                slug: "projects/healthtech",
-                label: "HealthTech — clinical cases",
-                blurb: "Quarkus in a regulated domain: 23 of 24, no clinical rule invented.",
-            },
-        ],
-    },
     {
         title: "The gate in CI",
         icon: "server",
@@ -316,10 +228,52 @@ exports.NAV = [
             },
         ],
     },
+    {
+        title: "Proven on real products",
+        icon: "check",
+        summary: "Six products built from real client briefs — what worked, and what Specgate got wrong.",
+        entries: [
+            {
+                slug: "projects/index",
+                label: "All six, compared",
+                blurb: "Brief, stack, requirements and tests for each pilot, side by side.",
+            },
+            {
+                slug: "projects/rebar-crew",
+                label: "Rebar Crew — field app",
+                blurb: "Expo + Next.js: 47 of 47, after a first round that was done and unusable.",
+            },
+            {
+                slug: "projects/bookings",
+                label: "Bookings — appointments",
+                blurb: "Next.js from a detailed brief: 38 of 38 in five cycles.",
+            },
+            {
+                slug: "projects/credit-shop",
+                label: "Credit shop — e-commerce",
+                blurb: "A five-line brief became 24 requirements, nearly every value an assumption.",
+            },
+            {
+                slug: "projects/fincore",
+                label: "FinCore — core banking",
+                blurb: "Spring Boot: 59 of 60, one legal question left to the client.",
+            },
+            {
+                slug: "projects/eventtech",
+                label: "EventTech — event operations",
+                blurb: "Quarkus with event sourcing and real time: 38 of 38.",
+            },
+            {
+                slug: "projects/healthtech",
+                label: "HealthTech — clinical cases",
+                blurb: "Quarkus in a regulated domain: 23 of 24, no clinical rule invented.",
+            },
+        ],
+    },
     {
         title: "Reference",
         icon: "book",
-        summary: "Every command, the ideas behind them, and what to do when something fails.",
+        summary: "Every command, a router to the right guide, and what to do when something fails.",
         entries: [
             {
                 slug: "commands",
@@ -327,9 +281,9 @@ exports.NAV = [
                 blurb: "Every command, its flags and its JSON shape.",
             },
             {
-                slug: "concepts",
-                label: "How Specgate thinks",
-                blurb: "Six ideas — requirement, scenario, mention, generated matrix, status, one gate — that explain every command.",
+                slug: "how-to",
+                label: "How-to guides",
+                blurb: "I want to… — the guide for each task.",
             },
             {
                 slug: "faq",
@@ -361,7 +315,7 @@ exports.NAV = [
             {
                 slug: "harness",
                 label: "The harness",
-                blurb: "Unattended delivery: plan → agent → gate → done, one worktree per requirement.",
+                blurb: "Unattended delivery: plan → agent → gate → apply, one worktree per requirement.",
             },
             {
                 slug: "harness-report",
@@ -385,6 +339,74 @@ exports.NAV = [
             },
         ],
     },
+    {
+        // ADR-0033: forja's documentation lives here, one site for both tools.
+        title: "New project (forja)",
+        icon: "package",
+        summary: "forja, a companion tool, generates a whole application with the architecture in place, sign-in working and Specgate adopted.",
+        entries: [
+            {
+                slug: "forja/getting-started",
+                group: "Generate",
+                label: "Getting started",
+                blurb: "Generate a Next.js + Expo monorepo in TypeScript, with the hexagon in place.",
+            },
+            {
+                slug: "forja/java",
+                group: "Generate",
+                label: "Java backends",
+                blurb: "A Spring Boot or Quarkus API, a Next.js web app and Keycloak sign-in.",
+            },
+            {
+                slug: "forja/daily-use",
+                group: "Grow it",
+                label: "Daily use",
+                blurb: "Add use cases, entities and ports where the architecture expects them; check the setup.",
+            },
+            {
+                slug: "forja/specgate",
+                group: "Grow it",
+                label: "With Specgate",
+                blurb: "How a generated project adopts Specgate, and how a use case names its requirement.",
+            },
+            {
+                slug: "forja/e2e",
+                group: "Grow it",
+                label: "End-to-end tests",
+                blurb: "Playwright drives the sign-in flow in a real browser.",
+            },
+            {
+                slug: "forja/cli",
+                group: "Reference",
+                label: "forja command line",
+                blurb: "init, add, doctor: every flag and the values it accepts.",
+            },
+            {
+                slug: "forja/config",
+                group: "Reference",
+                label: "forja.config.json",
+                blurb: "Every field, its values and its defaults.",
+            },
+            {
+                slug: "forja/generated-project",
+                group: "Reference",
+                label: "What it generates",
+                blurb: "Recipe by recipe: the folders, the files, the versions.",
+            },
+            {
+                slug: "forja/architecture",
+                group: "Reference",
+                label: "The generated architecture",
+                blurb: "The hexagon forja generates and the rules that keep it.",
+            },
+            {
+                slug: "forja/contributing",
+                group: "Reference",
+                label: "Contributing to forja",
+                blurb: "Develop forja, write a recipe, verify what it generates.",
+            },
+        ],
+    },
     {
         title: "Advanced",
         icon: "book",
@@ -393,18 +415,13 @@ exports.NAV = [
             {
                 slug: "tutorial",
                 label: "Tutorial: Smart Parking",
-                blurb: "A complete worked example, from a blank folder to a delivered requirement.",
+                blurb: "A complete worked example on a domain pack, from a blank folder to a delivered requirement.",
             },
             {
                 slug: "agent-setup",
                 label: "Choosing your agent",
                 blurb: "Claude, Aider, Cursor or a three-line wrapper — and the two things that bite.",
             },
-            {
-                slug: "how-to",
-                label: "How-to guides",
-                blurb: "Short answers to specific questions.",
-            },
             {
                 slug: "supply-chain",
                 label: "Supply chain",