@rsaglobaltech/specgate 0.8.1

package/dist/scripts/license_check.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarise = exports.isAllowed = exports.alternatives = exports.licenseOf = exports.ALLOWED = exports.LicenseCheckCommand = void 0;
+const LicenseCheckCommand_1 = require("./cli/commands/quality/LicenseCheckCommand");
+Object.defineProperty(exports, "LicenseCheckCommand", { enumerable: true, get: function () { return LicenseCheckCommand_1.LicenseCheckCommand; } });
+Object.defineProperty(exports, "ALLOWED", { enumerable: true, get: function () { return LicenseCheckCommand_1.ALLOWED; } });
+Object.defineProperty(exports, "licenseOf", { enumerable: true, get: function () { return LicenseCheckCommand_1.licenseOf; } });
+Object.defineProperty(exports, "alternatives", { enumerable: true, get: function () { return LicenseCheckCommand_1.alternatives; } });
+Object.defineProperty(exports, "isAllowed", { enumerable: true, get: function () { return LicenseCheckCommand_1.isAllowed; } });
+Object.defineProperty(exports, "summarise", { enumerable: true, get: function () { return LicenseCheckCommand_1.summarise; } });
+if (require.main === module) {
+    new LicenseCheckCommand_1.LicenseCheckCommand(process.argv.slice(2)).execute();
+}
+//# sourceMappingURL=license_check.js.map

package/dist/scripts/license_check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license_check.js","sourceRoot":"","sources":["../../scripts/license_check.ts"],"names":[],"mappings":";;;;AACA,oFAOoD;AAE3C,oGARP,yCAAmB,OAQO;AAAE,wFAP5B,6BAAO,OAO4B;AAAE,0FANrC,+BAAS,OAMqC;AAAE,6FALhD,kCAAY,OAKgD;AAAE,0FAJ9D,+BAAS,OAI8D;AAAE,0FAHzE,+BAAS,OAGyE;AAEpF,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,yCAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC3D,CAAC"}

package/dist/scripts/lint_pack.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderDot = exports.renderMermaid = exports.buildPackGraph = exports.runLint = exports.lintScenarioQuality = exports.isGenericTitle = exports.parseFeature = exports.parseArgs = exports.LintPackCommand = void 0;
+const LintPackCommand_1 = require("./cli/commands/pack/LintPackCommand");
+Object.defineProperty(exports, "LintPackCommand", { enumerable: true, get: function () { return LintPackCommand_1.LintPackCommand; } });
+Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return LintPackCommand_1.parseArgs; } });
+Object.defineProperty(exports, "parseFeature", { enumerable: true, get: function () { return LintPackCommand_1.parseFeature; } });
+Object.defineProperty(exports, "isGenericTitle", { enumerable: true, get: function () { return LintPackCommand_1.isGenericTitle; } });
+Object.defineProperty(exports, "lintScenarioQuality", { enumerable: true, get: function () { return LintPackCommand_1.lintScenarioQuality; } });
+Object.defineProperty(exports, "runLint", { enumerable: true, get: function () { return LintPackCommand_1.runLint; } });
+Object.defineProperty(exports, "buildPackGraph", { enumerable: true, get: function () { return LintPackCommand_1.buildPackGraph; } });
+Object.defineProperty(exports, "renderMermaid", { enumerable: true, get: function () { return LintPackCommand_1.renderMermaid; } });
+Object.defineProperty(exports, "renderDot", { enumerable: true, get: function () { return LintPackCommand_1.renderDot; } });
+if (require.main === module) {
+    new LintPackCommand_1.LintPackCommand(process.argv.slice(2)).execute();
+}
+//# sourceMappingURL=lint_pack.js.map

package/dist/scripts/lint_pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint_pack.js","sourceRoot":"","sources":["../../scripts/lint_pack.ts"],"names":[],"mappings":";;;;AACA,yEAY6C;AAG3C,gGAdA,iCAAe,OAcA;AACf,0FAdA,2BAAS,OAcA;AACT,6FAdA,8BAAY,OAcA;AACZ,+FAdA,gCAAc,OAcA;AACd,oGAdA,qCAAmB,OAcA;AACnB,wFAdA,yBAAO,OAcA;AACP,+FAdA,gCAAc,OAcA;AACd,8FAdA,+BAAa,OAcA;AACb,0FAdA,2BAAS,OAcA;AAKX,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,iCAAe,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACvD,CAAC"}

package/dist/scripts/merge-traceability.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * The git merge driver for `docs/specs/traceability.md`.
+ *
+ * ## What git does with this file
+ *
+ * Git calls a merge driver as a plain process, with three temporary files:
+ *
+ *     merge-traceability.js %O %A %B
+ *                           │  │  └── theirs: the branch being merged in
+ *                           │  └───── ours: the current version, AND the file
+ *                           │              the driver must overwrite with the
+ *                           │              result. Git reads the answer back
+ *                           │              out of this path.
+ *                           └──────── base: the common ancestor. Git passes an
+ *                                     empty file when there is none.
+ *
+ * Exit 0 means "merged, use %A". A non-zero exit means "conflict" — git keeps
+ * whatever %A now contains, which is why the markers are written into it before
+ * exiting 1, and marks the path unmerged so `git status` lists it.
+ *
+ * ## Wiring it up
+ *
+ * Two halves, and only one of them is committed:
+ *
+ *   1. `.gitattributes`, in the repository:
+ *          docs/specs/traceability.md merge=csda-matrix
+ *
+ *   2. git config, which is **local to each clone**:
+ *          git config merge.csda-matrix.name "csda traceability matrix merge"
+ *          git config merge.csda-matrix.driver "node <path>/merge-traceability.js %O %A %B"
+ *
+ * `specgate harness init` writes both. A fresh clone has only the first, and git
+ * then falls back to its built-in line merge — the conflict you would have had
+ * anyway. That fallback is why this can be rolled out gradually: an unconfigured
+ * checkout is no worse off, never silently wrong. `specgate doctor` reports the
+ * gap rather than leaving it to be discovered mid-merge.
+ *
+ * The decision itself is not here. `mergeTraceability` is domain, pure, and
+ * tested without git; this file is the process boundary and nothing else.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const fs = __importStar(require("node:fs"));
+const TraceabilityMerge_1 = require("../packages/core/src/domain/TraceabilityMerge");
+function main(argv) {
+    const [basePath, oursPath, theirsPath] = argv;
+    if (!basePath || !oursPath || !theirsPath) {
+        process.stderr.write("merge-traceability: expected the three paths git passes as %O %A %B.\n" +
+            "Fix: this is a git merge driver, not a command to run by hand. See\n" +
+            "     `specgate harness init`, which registers it.\n");
+        return 2;
+    }
+    // A missing base is normal — git passes an empty file for an unrelated
+    // history — so it reads as "no common ancestor" rather than as an error.
+    const read = (p) => (fs.existsSync(p) ? fs.readFileSync(p, "utf8") : "");
+    const result = (0, TraceabilityMerge_1.mergeTraceability)(read(basePath), read(oursPath), read(theirsPath));
+    fs.writeFileSync(oursPath, result.content, "utf8");
+    if (result.conflicts.length === 0)
+        return 0;
+    process.stderr.write(`traceability.md: ${result.conflicts.length} row(s) need a decision: ` +
+        `${result.conflicts.join(", ")}\n` +
+        "Fix: open the file, and for each conflict keep exactly one of the two rows,\n" +
+        "     deleting the <<<<<<< ======= >>>>>>> lines. Never keep both — a\n" +
+        "     duplicated requirement is the corruption this file must not have.\n" +
+        "     Then `specgate validate <project>` confirms the result is well formed.\n");
+    return 1;
+}
+if (require.main === module) {
+    process.exit(main(process.argv.slice(2)));
+}
+//# sourceMappingURL=merge-traceability.js.map

package/dist/scripts/merge-traceability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-traceability.js","sourceRoot":"","sources":["../../scripts/merge-traceability.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMH,oBA6BC;AAjCD,4CAA8B;AAE9B,qFAAkF;AAElF,SAAgB,IAAI,CAAC,IAAc;IACjC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;IAC9C,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wEAAwE;YACtE,sEAAsE;YACtE,qDAAqD,CACxD,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,IAAA,qCAAiB,EAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnF,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oBAAoB,MAAM,CAAC,SAAS,CAAC,MAAM,2BAA2B;QACpE,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAClC,+EAA+E;QAC/E,wEAAwE;QACxE,0EAA0E;QAC1E,+EAA+E,CAClF,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/scripts/onboard.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.looksLayered = exports.findDeclaredModules = exports.findAdoptedAncestor = exports.proposeCapabilities = exports.titleCase = exports.descendThroughWrappers = exports.BUILD_OUTPUT = exports.NOT_DOMAIN = exports.OnboardCommand = void 0;
+exports.main = main;
+const OnboardCommand_1 = require("./cli/commands/project/OnboardCommand");
+Object.defineProperty(exports, "OnboardCommand", { enumerable: true, get: function () { return OnboardCommand_1.OnboardCommand; } });
+Object.defineProperty(exports, "NOT_DOMAIN", { enumerable: true, get: function () { return OnboardCommand_1.NOT_DOMAIN; } });
+Object.defineProperty(exports, "BUILD_OUTPUT", { enumerable: true, get: function () { return OnboardCommand_1.BUILD_OUTPUT; } });
+Object.defineProperty(exports, "descendThroughWrappers", { enumerable: true, get: function () { return OnboardCommand_1.descendThroughWrappers; } });
+Object.defineProperty(exports, "titleCase", { enumerable: true, get: function () { return OnboardCommand_1.titleCase; } });
+Object.defineProperty(exports, "proposeCapabilities", { enumerable: true, get: function () { return OnboardCommand_1.proposeCapabilities; } });
+Object.defineProperty(exports, "findAdoptedAncestor", { enumerable: true, get: function () { return OnboardCommand_1.findAdoptedAncestor; } });
+Object.defineProperty(exports, "findDeclaredModules", { enumerable: true, get: function () { return OnboardCommand_1.findDeclaredModules; } });
+Object.defineProperty(exports, "looksLayered", { enumerable: true, get: function () { return OnboardCommand_1.looksLayered; } });
+function main(argv) {
+    new OnboardCommand_1.OnboardCommand(argv).execute();
+}
+if (require.main === module) {
+    new OnboardCommand_1.OnboardCommand(process.argv.slice(2)).execute();
+}
+//# sourceMappingURL=onboard.js.map

package/dist/scripts/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../../scripts/onboard.ts"],"names":[],"mappings":";;;;AAyBA,oBAEC;AA1BD,0EAU+C;AAG7C,+FAZA,+BAAc,OAYA;AACd,2FAZA,2BAAU,OAYA;AACV,6FAZA,6BAAY,OAYA;AACZ,uGAZA,uCAAsB,OAYA;AACtB,0FAZA,0BAAS,OAYA;AACT,oGAZA,oCAAmB,OAYA;AACnB,oGAZA,oCAAmB,OAYA;AACnB,oGAZA,oCAAmB,OAYA;AACnB,6FAZA,6BAAY,OAYA;AAGd,SAAgB,IAAI,CAAC,IAAc;IACjC,IAAI,+BAAc,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,+BAAc,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACtD,CAAC"}

package/dist/scripts/plan.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyDependencies = exports.detectOrphans = exports.buildPlan = exports.hintFor = exports.classify = exports.parseTraceability = exports.parseArgs = exports.PlanCommand = void 0;
+const PlanCommand_1 = require("./cli/commands/spec/PlanCommand");
+Object.defineProperty(exports, "PlanCommand", { enumerable: true, get: function () { return PlanCommand_1.PlanCommand; } });
+Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return PlanCommand_1.parseArgs; } });
+Object.defineProperty(exports, "parseTraceability", { enumerable: true, get: function () { return PlanCommand_1.parseTraceability; } });
+Object.defineProperty(exports, "classify", { enumerable: true, get: function () { return PlanCommand_1.classify; } });
+Object.defineProperty(exports, "hintFor", { enumerable: true, get: function () { return PlanCommand_1.hintFor; } });
+Object.defineProperty(exports, "buildPlan", { enumerable: true, get: function () { return PlanCommand_1.buildPlan; } });
+Object.defineProperty(exports, "detectOrphans", { enumerable: true, get: function () { return PlanCommand_1.detectOrphans; } });
+Object.defineProperty(exports, "applyDependencies", { enumerable: true, get: function () { return PlanCommand_1.applyDependencies; } });
+if (require.main === module) {
+    new PlanCommand_1.PlanCommand(process.argv.slice(2)).execute();
+}
+//# sourceMappingURL=plan.js.map

package/dist/scripts/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../scripts/plan.ts"],"names":[],"mappings":";;;;AACA,iEAUyC;AAGvC,4FAZA,yBAAW,OAYA;AACX,0FAZA,uBAAS,OAYA;AAET,kGAZA,+BAAiB,OAYA;AACjB,yFAZA,sBAAQ,OAYA;AACR,wFAZA,qBAAO,OAYA;AACP,0FAZA,uBAAS,OAYA;AACT,8FAZA,2BAAa,OAYA;AACb,kGAZA,+BAAiB,OAYA;AAGnB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,yBAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACnD,CAAC"}

package/dist/scripts/plugin/gate-hook.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * The `Stop` hook: the spec gate, inside the agent's loop.
+ *
+ * `specgate validate --strict-tdd` has always run in CI — that is, *after* the
+ * agent finished and left. This runs it when the agent is about to stop, while
+ * it still has the context to fix what it broke, and refuses the stop while the
+ * gate is red. It is the difference between a gate that reviews an agent's work
+ * and one the agent cannot walk past.
+ *
+ * **The loop hazard is the whole design problem.** A `Stop` hook that blocks
+ * whenever the gate fails can trap a session forever: the agent tries, fails,
+ * is blocked, tries again. So this blocks **at most once per user prompt**,
+ * keyed on the `prompt_id` the hook receives. The second time the same prompt
+ * comes back it reports the findings and lets the session end, because at that
+ * point the agent has already been told and a human needs to see the answer.
+ *
+ * Contract (verified against the hooks reference):
+ *   - stdin: JSON with `cwd`, `prompt_id`, `hook_event_name`
+ *   - exit 2: blocks the stop, and stderr is what Claude is told
+ *   - exit 0: allows it
+ * Anything unexpected exits 0. A hook that breaks a session because the CLI
+ * was missing would be worse than no hook at all.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.alreadyBlocked = alreadyBlocked;
+exports.renderFindings = renderFindings;
+exports.decide = decide;
+exports.main = main;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const MARKER_DIR = path.join(os.tmpdir(), "csda-gate-hook");
+/**
+ * Has this prompt already been blocked once?
+ *
+ * The marker is per prompt and lives in the temp directory: it must not touch
+ * the project, because the harness refuses to start on a dirty tree and this
+ * hook has no business dirtying anyone's repository.
+ */
+function alreadyBlocked(promptId) {
+    if (!promptId)
+        return false;
+    const marker = path.join(MARKER_DIR, `${promptId.replace(/[^\w-]/g, "")}.blocked`);
+    if (fs.existsSync(marker))
+        return true;
+    try {
+        fs.mkdirSync(MARKER_DIR, { recursive: true });
+        fs.writeFileSync(marker, "", "utf8");
+    }
+    catch {
+        // If the marker cannot be written, err towards not blocking: a session that
+        // cannot be ended is a worse failure than a gate finding that goes unsaid.
+        return true;
+    }
+    return false;
+}
+/** Turn the validator's diagnostics into something an agent can act on. */
+function renderFindings(diagnostics) {
+    const lines = ["The spec gate is failing, so this work is not finished:", ""];
+    for (const d of diagnostics.slice(0, 10)) {
+        lines.push(`  • [${d.code ?? "error"}] ${d.message ?? ""}`);
+        if (d.fix)
+            lines.push(`    fix: ${d.fix}`);
+    }
+    if (diagnostics.length > 10)
+        lines.push(`  … and ${diagnostics.length - 10} more.`);
+    lines.push("", "Run `specgate validate . --strict-tdd` to see all of it.");
+    return lines.join("\n");
+}
+/**
+ * Run the gate and decide.
+ *
+ * @param runValidate injected so the decision is testable without a CLI
+ */
+function decide(input, runValidate, blockedAlready) {
+    const cwd = input.cwd ?? process.cwd();
+    let gate;
+    try {
+        gate = runValidate(cwd);
+    }
+    catch {
+        // Not a spec-driven project, or no CLI on PATH. Say nothing.
+        return { block: false, message: "" };
+    }
+    if (gate.ok)
+        return { block: false, message: "" };
+    const findings = renderFindings(gate.diagnostics);
+    if (blockedAlready(input.prompt_id ?? "")) {
+        // Told once already. Let the human see the answer rather than looping.
+        return { block: false, message: findings };
+    }
+    return { block: true, message: findings };
+}
+function runValidate(cwd) {
+    if (!fs.existsSync(path.join(cwd, "spec.md")))
+        throw new Error("not a spec-driven project");
+    const r = (0, node_child_process_1.spawnSync)("npx", ["--no-install", "specgate", "validate", cwd, "--strict-tdd", "--json"], {
+        encoding: "utf8",
+        timeout: 120_000,
+        maxBuffer: 16 * 1024 * 1024,
+    });
+    if (r.error || typeof r.status !== "number")
+        throw new Error("could not run specgate");
+    let parsed;
+    try {
+        parsed = JSON.parse(r.stdout);
+    }
+    catch {
+        throw new Error("specgate validate did not emit one JSON document");
+    }
+    const diagnostics = (parsed.status ?? []).filter((d) => d.severity === "error");
+    return { ok: r.status === 0, diagnostics };
+}
+function main(raw) {
+    let input;
+    try {
+        input = JSON.parse(raw);
+    }
+    catch {
+        return 0;
+    }
+    const decision = decide(input, runValidate, alreadyBlocked);
+    if (decision.message)
+        process.stderr.write(`${decision.message}\n`);
+    return decision.block ? 2 : 0;
+}
+if (require.main === module) {
+    let raw = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (c) => {
+        raw += c;
+    });
+    process.stdin.on("end", () => process.exit(main(raw)));
+}
+//# sourceMappingURL=gate-hook.js.map

package/dist/scripts/plugin/gate-hook.js.map

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

package/dist/scripts/report.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sparkline = exports.parseArgs = exports.renderJson = exports.renderHtml = exports.readSpecops = exports.buildDeclaredValues = exports.buildReport = exports.ReportCommand = void 0;
+const ReportCommand_1 = require("./cli/commands/quality/ReportCommand");
+Object.defineProperty(exports, "ReportCommand", { enumerable: true, get: function () { return ReportCommand_1.ReportCommand; } });
+Object.defineProperty(exports, "buildReport", { enumerable: true, get: function () { return ReportCommand_1.buildReport; } });
+Object.defineProperty(exports, "buildDeclaredValues", { enumerable: true, get: function () { return ReportCommand_1.buildDeclaredValues; } });
+Object.defineProperty(exports, "readSpecops", { enumerable: true, get: function () { return ReportCommand_1.readSpecops; } });
+Object.defineProperty(exports, "renderHtml", { enumerable: true, get: function () { return ReportCommand_1.renderHtml; } });
+Object.defineProperty(exports, "renderJson", { enumerable: true, get: function () { return ReportCommand_1.renderJson; } });
+Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return ReportCommand_1.parseArgs; } });
+Object.defineProperty(exports, "sparkline", { enumerable: true, get: function () { return ReportCommand_1.sparkline; } });
+if (require.main === module) {
+    new ReportCommand_1.ReportCommand(process.argv.slice(2)).execute();
+}
+//# sourceMappingURL=report.js.map

package/dist/scripts/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../scripts/report.ts"],"names":[],"mappings":";;;;AACA,wEAU8C;AAG5C,8FAZA,6BAAa,OAYA;AACb,4FAZA,2BAAW,OAYA;AACX,oGAZA,mCAAmB,OAYA;AACnB,4FAZA,2BAAW,OAYA;AACX,2FAZA,0BAAU,OAYA;AACV,2FAZA,0BAAU,OAYA;AACV,0FAZA,yBAAS,OAYA;AACT,0FAZA,yBAAS,OAYA;AAIX,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,6BAAa,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACrD,CAAC"}

package/dist/scripts/req.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateRequirementFields = exports.appendRequirement = exports.isMatrixDataLine = exports.buildRow = exports.nextScenarioId = exports.nextReqId = exports.pad3 = exports.LINK_FIELDS = exports.COL = exports.ReqCommand = void 0;
+/**
+ * Supported subcommands: "add", "link", "done", "list"
+ */
+const ReqCommand_1 = require("./cli/commands/spec/ReqCommand");
+Object.defineProperty(exports, "ReqCommand", { enumerable: true, get: function () { return ReqCommand_1.ReqCommand; } });
+Object.defineProperty(exports, "COL", { enumerable: true, get: function () { return ReqCommand_1.COL; } });
+Object.defineProperty(exports, "LINK_FIELDS", { enumerable: true, get: function () { return ReqCommand_1.LINK_FIELDS; } });
+Object.defineProperty(exports, "pad3", { enumerable: true, get: function () { return ReqCommand_1.pad3; } });
+Object.defineProperty(exports, "nextReqId", { enumerable: true, get: function () { return ReqCommand_1.nextReqId; } });
+Object.defineProperty(exports, "nextScenarioId", { enumerable: true, get: function () { return ReqCommand_1.nextScenarioId; } });
+Object.defineProperty(exports, "buildRow", { enumerable: true, get: function () { return ReqCommand_1.buildRow; } });
+Object.defineProperty(exports, "isMatrixDataLine", { enumerable: true, get: function () { return ReqCommand_1.isMatrixDataLine; } });
+Object.defineProperty(exports, "appendRequirement", { enumerable: true, get: function () { return ReqCommand_1.appendRequirement; } });
+Object.defineProperty(exports, "updateRequirementFields", { enumerable: true, get: function () { return ReqCommand_1.updateRequirementFields; } });
+if (require.main === module) {
+    new ReqCommand_1.ReqCommand(process.argv.slice(2)).execute();
+}
+//# sourceMappingURL=req.js.map

package/dist/scripts/req.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"req.js","sourceRoot":"","sources":["../../scripts/req.ts"],"names":[],"mappings":";;;;AACA;;GAEG;AACH,+DAWwC;AAGtC,2FAbA,uBAAU,OAaA;AACV,oFAbA,gBAAG,OAaA;AACH,4FAbA,wBAAW,OAaA;AACX,qFAbA,iBAAI,OAaA;AACJ,0FAbA,sBAAS,OAaA;AACT,+FAbA,2BAAc,OAaA;AACd,yFAbA,qBAAQ,OAaA;AACR,iGAbA,6BAAgB,OAaA;AAChB,kGAbA,8BAAiB,OAaA;AACjB,wGAbA,oCAAuB,OAaA;AAGzB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,uBAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/dist/scripts/schema/cli.js

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * `specgate schema init | fork | validate | which` — inspect and override the
+ * artefact graph a change follows.
+ *
+ * Most teams never touch this. It exists because "which artefacts does a
+ * change produce?" is a house style, not a law, and hardcoding one answer is
+ * how a tool acquires a reputation for ceremony.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIXES = void 0;
+exports.schemaPath = schemaPath;
+exports.writeSchema = writeSchema;
+exports.main = main;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const project_root_1 = require("../lib/project-root");
+const diagnostics_1 = require("../lib/diagnostics");
+const agent_1 = require("../lib/agent");
+const registry_1 = require("./registry");
+function usage() {
+    process.stdout.write("Usage:\n" +
+        "  specgate schema which [<name>]        where a schema comes from, and its graph\n" +
+        "  specgate schema init <name>           write a new schema from the default\n" +
+        "  specgate schema fork <from> <to>      copy a built-in into the project to edit\n" +
+        "  specgate schema validate [<name>]     check a schema's graph is sound\n\n" +
+        `Built-in: ${Object.keys(registry_1.BUILT_IN).join(", ")}\n` +
+        `Project schemas live in ${registry_1.SCHEMA_DIR}/<name>/${registry_1.SCHEMA_FILE}.\n`);
+}
+function schemaPath(projectDir, name) {
+    return path.join(projectDir, registry_1.SCHEMA_DIR, name, registry_1.SCHEMA_FILE);
+}
+function writeSchema(projectDir, name, schema) {
+    const file = schemaPath(projectDir, name);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, (0, registry_1.toYaml)({ ...schema, name }), "utf8");
+    return path.join(registry_1.SCHEMA_DIR, name, registry_1.SCHEMA_FILE);
+}
+function main(argv) {
+    const io = (0, agent_1.agentIo)((0, agent_1.wantsJson)(argv));
+    const NULL_SHAPE = { schema: null };
+    const args = argv.filter((a) => a !== "--json");
+    if (args.includes("--help") || args.includes("-h") || args.length === 0) {
+        usage();
+        process.exit(args.length === 0 ? agent_1.EXIT.USAGE : agent_1.EXIT.OK);
+    }
+    let projectDirArg = ".";
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--project-dir" && args[i + 1])
+            projectDirArg = args[++i];
+        else if (!args[i].startsWith("-"))
+            positional.push(args[i]);
+    }
+    let projectDir;
+    try {
+        projectDir = (0, project_root_1.resolveProjectDir)(projectDirArg);
+    }
+    catch (err) {
+        io.usage(NULL_SHAPE, [
+            (0, diagnostics_1.error)("project_not_found", (0, diagnostics_1.errorMessage)(err), {
+                fix: "Run from inside a spec-driven project, or pass --project-dir.",
+            }),
+        ]);
+    }
+    const [action, ...rest] = positional;
+    if (action === "which") {
+        const name = rest[0] || "spec-driven";
+        const found = (0, registry_1.resolveSchema)(projectDir, name);
+        if (!found) {
+            io.fail(NULL_SHAPE, [
+                (0, diagnostics_1.error)("schema_not_found", `No schema named "${name}".`, {
+                    target: name,
+                    fix: `Available: ${(0, registry_1.listSchemas)(projectDir).join(", ")}.`,
+                }),
+            ]);
+        }
+        return io.emit({
+            schema: { ...found.schema, source: found.source, path: found.path },
+            available: (0, registry_1.listSchemas)(projectDir),
+        }, () => {
+            process.stdout.write(`\n  ${found.schema.name}  (${found.source})\n`);
+            if (found.path)
+                process.stdout.write(`  ${found.path}\n`);
+            process.stdout.write(`\n  ${found.schema.description || ""}\n\n`);
+            for (const a of found.schema.artifacts) {
+                const deps = a.requires.length ? `  ← ${a.requires.join(", ")}` : "";
+                process.stdout.write(`    ${a.id.padEnd(10)} ${a.generates}${deps}\n`);
+            }
+            process.stdout.write(`\n  Available: ${(0, registry_1.listSchemas)(projectDir).join(", ")}\n\n`);
+        });
+    }
+    if (action === "init" || action === "fork") {
+        // `init` starts from the default; `fork` names the schema to copy.
+        const from = action === "fork" ? rest[0] : "spec-driven";
+        const to = action === "fork" ? rest[1] : rest[0];
+        if (!to) {
+            io.usage(NULL_SHAPE, [
+                (0, diagnostics_1.error)("schema_name_required", "Name the schema to create.", {
+                    fix: action === "fork"
+                        ? "specgate schema fork spec-driven my-flow"
+                        : "specgate schema init my-flow",
+                }),
+            ]);
+        }
+        const source = (0, registry_1.resolveSchema)(projectDir, from);
+        if (!source) {
+            io.fail(NULL_SHAPE, [
+                (0, diagnostics_1.error)("schema_not_found", `No schema named "${from}" to copy.`, {
+                    target: from,
+                    fix: `Available: ${(0, registry_1.listSchemas)(projectDir).join(", ")}.`,
+                }),
+            ]);
+        }
+        const dest = schemaPath(projectDir, to);
+        if (fs.existsSync(dest)) {
+            io.fail(NULL_SHAPE, [
+                (0, diagnostics_1.error)("schema_exists", `${path.join(registry_1.SCHEMA_DIR, to, registry_1.SCHEMA_FILE)} already exists.`, {
+                    target: to,
+                    fix: "Edit it, or choose another name.",
+                }),
+            ]);
+        }
+        const written = writeSchema(projectDir, to, source.schema);
+        return io.emit({ schema: { name: to, path: written, from } }, () => process.stdout.write(`\n  ✔  ${to} written to ${written}\n     copied from ${from} (${source.source})\n\n` +
+            `  Use it: specgate change new <id> --schema ${to}\n\n`));
+    }
+    if (action === "validate") {
+        const name = rest[0] || "spec-driven";
+        const found = (0, registry_1.resolveSchema)(projectDir, name);
+        if (!found) {
+            io.fail(NULL_SHAPE, [
+                (0, diagnostics_1.error)("schema_not_found", `No schema named "${name}".`, {
+                    target: name,
+                    fix: `Available: ${(0, registry_1.listSchemas)(projectDir).join(", ")}.`,
+                }),
+            ]);
+        }
+        const problems = (0, registry_1.validateSchema)(found.schema);
+        const diagnostics = problems.map((p) => (0, diagnostics_1.diagnostic)("error", p.code, p.message, {
+            ...(p.target ? { target: p.target } : {}),
+            fix: exports.FIXES[p.code] || "Correct the schema file and re-run.",
+        }));
+        if (found.source === "built-in") {
+            diagnostics.push((0, diagnostics_1.warning)("schema_is_built_in", `"${name}" is built in — there is nothing to edit yet.`, {
+                fix: `specgate schema fork ${name} my-${name}`,
+            }));
+        }
+        return io.emitAndGate({
+            schema: { name: found.schema.name, source: found.source, path: found.path },
+            status: diagnostics,
+        }, () => {
+            if (problems.length === 0) {
+                process.stdout.write(`\n  ✔  ${name} is a sound graph (${found.source})\n\n`);
+                return;
+            }
+            process.stdout.write(`\n  ✖  ${name} has ${problems.length} problem(s)\n\n`);
+            for (const p of problems)
+                process.stdout.write(`    ${p.message}\n`);
+            process.stdout.write("\n");
+        });
+    }
+    io.usage(NULL_SHAPE, [
+        (0, diagnostics_1.error)("schema_action_unknown", `Unknown action: ${action}.`, {
+            target: action,
+            fix: "Use one of: which, init, fork, validate.",
+        }),
+    ]);
+}
+exports.FIXES = {
+    schema_no_name: "Add a top-level `name:` line.",
+    schema_no_artifacts: "Declare at least one entry under `artifacts:`.",
+    artifact_no_id: "Every artifact needs an `id`.",
+    artifact_duplicate_id: "Rename one of the two — ids identify an artifact.",
+    artifact_no_output: "Add a `generates:` path or glob.",
+    artifact_unknown_dependency: "Declare the artifact it requires, or drop the dependency. A dependency on something that does not exist marks every dependent artifact blocked forever.",
+    artifact_cycle: "Break the cycle — the graph has to be acyclic to be orderable.",
+};
+if (require.main === module)
+    main(process.argv.slice(2));
+//# sourceMappingURL=cli.js.map