@rsaglobaltech/specgate 0.8.1 → 0.9.0

package/dist/packages/core/test/unit/precedents.test.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Choosing the precedent (D2).
+ *
+ * The prompt is entirely normative — facts, Gherkin, rules, definition of done.
+ * None of it shows an agent what an accepted implementation looks like *here*,
+ * so it invents a house style and the next attempt is spent correcting it.
+ *
+ * The rules below are the ones that decide whether a precedent helps or hurts:
+ * a precedent from another bounded context teaches conventions that do not
+ * apply, with the authority of "this was accepted".
+ */
+const test = require("node:test");
+const assert = require("node:assert/strict");
+const { choosePrecedent, excerpt } = require("../../src/domain/Precedents");
+const row = (id, status, testArtifact = "", technicalArtifact = "") => ({
+    requirementId: id,
+    status,
+    testArtifact,
+    technicalArtifact,
+});
+test("the most recent accepted requirement in the same context wins", () => {
+    const rows = [
+        row("REQ-001", "Verified", "t/one.test.ts", "src/one.ts"),
+        row("REQ-002", "Verified", "t/two.test.ts", "src/two.ts"),
+    ];
+    const contexts = { "REQ-001": "Billing", "REQ-002": "Billing", "REQ-003": "Billing" };
+    const choice = choosePrecedent(rows, contexts, "REQ-003");
+    assert.equal(choice.requirementId, "REQ-002");
+    assert.equal(choice.testArtifact, "t/two.test.ts");
+    assert.equal(choice.technicalArtifact, "src/two.ts");
+});
+test("a different bounded context is not a precedent", () => {
+    // Worse than none: it teaches conventions that do not apply, with the
+    // authority of having been accepted.
+    const rows = [row("REQ-001", "Verified", "t/one.test.ts", "src/one.ts")];
+    const contexts = { "REQ-001": "Billing", "REQ-002": "Shipping" };
+    assert.equal(choosePrecedent(rows, contexts, "REQ-002"), null);
+});
+test("a project with no contexts at all shares one", () => {
+    // A codebase nobody has divided yet is one context, not none.
+    const rows = [row("REQ-001", "Verified", "t/one.test.ts", "src/one.ts")];
+    assert.equal(choosePrecedent(rows, {}, "REQ-002").requirementId, "REQ-001");
+});
+test("Implemented is not Verified", () => {
+    // `Implemented` means the code exists; `Verified` means somebody checked it.
+    // Copying an unchecked implementation propagates whatever is wrong with it.
+    const rows = [row("REQ-001", "Implemented", "t/one.test.ts", "src/one.ts")];
+    assert.equal(choosePrecedent(rows, {}, "REQ-002"), null);
+});
+test("status matching ignores case and padding", () => {
+    const rows = [row("REQ-001", "  verified ", "t/one.test.ts", "src/one.ts")];
+    assert.equal(choosePrecedent(rows, {}, "REQ-002").requirementId, "REQ-001");
+});
+test("a row with no artifacts is not a precedent", () => {
+    // There is nothing to show. A section naming a requirement and quoting
+    // nothing is worse than no section.
+    const rows = [row("REQ-001", "Verified", "TBD", "-")];
+    assert.equal(choosePrecedent(rows, {}, "REQ-002"), null);
+});
+test("one artifact is enough", () => {
+    const rows = [row("REQ-001", "Verified", "t/one.test.ts", "TBD")];
+    const choice = choosePrecedent(rows, {}, "REQ-002");
+    assert.equal(choice.testArtifact, "t/one.test.ts");
+    assert.equal(choice.technicalArtifact, "", "a placeholder must not become a path");
+});
+test("a requirement is never its own precedent", () => {
+    const rows = [row("REQ-002", "Verified", "t/two.test.ts", "src/two.ts")];
+    assert.equal(choosePrecedent(rows, {}, "REQ-002"), null);
+});
+test("a later requirement is not a precedent for an earlier one", () => {
+    // Precedent means already settled. Pointing REQ-001 at REQ-009 would make
+    // the example depend on work that may not exist when REQ-001 is attempted.
+    const rows = [row("REQ-009", "Verified", "t/nine.test.ts", "src/nine.ts")];
+    assert.equal(choosePrecedent(rows, {}, "REQ-001"), null);
+});
+test("backticks around a path are not part of the path", () => {
+    const rows = [row("REQ-001", "Verified", "`t/one.test.ts`", "`src/one.ts`")];
+    const choice = choosePrecedent(rows, {}, "REQ-002");
+    assert.equal(choice.testArtifact, "t/one.test.ts");
+});
+// ── excerpt ──────────────────────────────────────────────────────────────────
+test("a short file is quoted whole", () => {
+    assert.equal(excerpt("a\nb\nc"), "a\nb\nc");
+});
+test("a long file is cut and says so", () => {
+    // A thousand-line class in the prompt costs the agent the budget it needs
+    // for its own work, and the part that teaches the convention is the top.
+    const out = excerpt(Array.from({ length: 100 }, (_, i) => `line ${i}`).join("\n"), 10);
+    assert.match(out, /^line 0\n/);
+    assert.match(out, /… \(90 more lines\)$/);
+    assert.doesNotMatch(out, /line 50/);
+});
+test("excerpt survives an empty file", () => {
+    assert.equal(excerpt(""), "");
+    assert.equal(excerpt(null), "");
+});
+//# sourceMappingURL=precedents.test.js.map

package/dist/packages/core/test/unit/precedents.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"precedents.test.js","sourceRoot":"","sources":["../../../../../packages/core/test/unit/precedents.test.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/test/unit/requirement-removal.test.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Fase 4.1: `req add` had no counterpart, so two cold adoptions repaired the
+ * matrix by hand with a script.
+ */
+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 });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+const RequirementRemoval_1 = require("../../src/domain/RequirementRemoval");
+const HEADER = "| Requirement | Scenario ID | Feature file | Use Case | Command/Query | Aggregate | Event | Technical artifact | Test artifact | Status |\n" +
+    "| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |";
+const MATRIX = [
+    HEADER,
+    "| REQ-001 | SCN-001 | `features/core/health.feature` | UC-001 Health | - | - | - | src/h.js | tests/h.js | Verified |",
+    "| REQ-002 | SCN-002 | `features/billing/totals.feature` | UC-002 Totals | - | - | - | src/t.js | tests/t.js | Draft |",
+    "| REQ-003 | SCN-003 | `features/core/health.feature` | UC-003 Also health | - | - | - | src/x.js | tests/x.js | Draft |",
+].join("\n");
+const SPEC = [
+    "# Spec",
+    "",
+    "## 8. Key requirements",
+    "",
+    "| ID | Requirement | Priority | Status |",
+    "|---|---|---|---|",
+    "| REQ-002 | Totals are rounded | Must | Draft |",
+    "",
+    "### REQ-002 — Totals are rounded",
+    "",
+    "The system MUST satisfy: Totals are rounded.",
+    "",
+    "### REQ-003 — Also health",
+    "",
+    "kept",
+].join("\n");
+(0, node_test_1.test)("the plan names every row the id owns", () => {
+    const plan = (0, RequirementRemoval_1.planRemoval)(MATRIX, "REQ-002", SPEC);
+    assert.equal(plan.rows.length, 1);
+    assert.deepEqual(plan.statuses, ["Draft"]);
+    assert.equal(plan.hasProse, true);
+});
+(0, node_test_1.test)("a feature file another row still uses is not orphaned", () => {
+    // REQ-001 and REQ-003 share health.feature; removing one leaves it referenced.
+    assert.deepEqual((0, RequirementRemoval_1.planRemoval)(MATRIX, "REQ-001", SPEC).orphanedFeatures, []);
+    assert.deepEqual((0, RequirementRemoval_1.planRemoval)(MATRIX, "REQ-002", SPEC).orphanedFeatures, [
+        "features/billing/totals.feature",
+    ]);
+});
+(0, node_test_1.test)("a delivered requirement is flagged, a draft is not", () => {
+    // Removing an Implemented row deletes the record that something shipped.
+    assert.equal((0, RequirementRemoval_1.isDelivered)("Verified"), true);
+    assert.equal((0, RequirementRemoval_1.isDelivered)("Implemented"), true);
+    assert.equal((0, RequirementRemoval_1.isDelivered)("Draft"), false);
+    assert.equal((0, RequirementRemoval_1.isDelivered)(""), false);
+    assert.equal((0, RequirementRemoval_1.planRemoval)(MATRIX, "REQ-001", SPEC).statuses.some(RequirementRemoval_1.isDelivered), true);
+});
+(0, node_test_1.test)("removing takes the row and leaves the others alone", () => {
+    const after = (0, RequirementRemoval_1.removeMatrixRows)(MATRIX, "REQ-002");
+    assert.ok(!after.includes("REQ-002"));
+    assert.ok(after.includes("REQ-001"));
+    assert.ok(after.includes("REQ-003"));
+    assert.ok(after.includes("| Requirement | Scenario ID |"), "the header survives");
+});
+(0, node_test_1.test)("duplicate rows under one id all go", () => {
+    const withDupe = MATRIX + "\n| REQ-002 | SCN-009 | - | UC-002 again | - | - | - | - | - | Draft |";
+    assert.equal((0, RequirementRemoval_1.planRemoval)(withDupe, "REQ-002", SPEC).rows.length, 2);
+    assert.ok(!(0, RequirementRemoval_1.removeMatrixRows)(withDupe, "REQ-002").includes("REQ-002"));
+});
+(0, node_test_1.test)("the prose goes: both the section and the table row", () => {
+    const after = (0, RequirementRemoval_1.removeSpecProse)(SPEC, "REQ-002");
+    assert.ok(!after.includes("REQ-002"));
+    assert.ok(!after.includes("Totals are rounded"), "the section body goes with its heading");
+    assert.ok(after.includes("### REQ-003 — Also health"), "the next requirement survives");
+    assert.ok(after.includes("kept"));
+    assert.ok(after.includes("## 8. Key requirements"), "the enclosing section survives");
+});
+(0, node_test_1.test)("removing the last requirement does not eat the rest of the document", () => {
+    const spec = "## 8. Key requirements\n\n### REQ-002 — Gone\n\nbody\n\n## 9. Non-functional\n\nkept\n";
+    const after = (0, RequirementRemoval_1.removeSpecProse)(spec, "REQ-002");
+    assert.ok(!after.includes("REQ-002"));
+    assert.ok(after.includes("## 9. Non-functional"));
+    assert.ok(after.includes("kept"));
+});
+(0, node_test_1.test)("an id that is not there changes nothing", () => {
+    assert.equal((0, RequirementRemoval_1.removeMatrixRows)(MATRIX, "REQ-999"), MATRIX);
+    assert.equal((0, RequirementRemoval_1.planRemoval)(MATRIX, "REQ-999", SPEC).rows.length, 0);
+});
+(0, node_test_1.test)("REQ-01 does not match REQ-014", () => {
+    const m = HEADER + "\n| REQ-014 | - | - | UC | - | - | - | - | - | Draft |";
+    assert.equal((0, RequirementRemoval_1.removeMatrixRows)(m, "REQ-01"), m);
+});
+//# sourceMappingURL=requirement-removal.test.js.map

package/dist/packages/core/test/unit/requirement-removal.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-removal.test.js","sourceRoot":"","sources":["../../../../../packages/core/test/unit/requirement-removal.test.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/test/unit/scenario-coverage.test.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * #168: a scenario declared in a feature file that nothing tests.
+ */
+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 });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+const ScenarioCoverage_1 = require("../../src/domain/ScenarioCoverage");
+const FEATURE = `Feature: Invoice totals
+
+  Scenario: SCN-010 subtotal is the sum of line amounts
+    Given two lines
+    When the invoice is totalled
+    Then the subtotal is their sum
+
+  Scenario: SCN-011 tax is applied per line
+    Given two rates
+    When the invoice is totalled
+    Then each line carries its own rate
+
+  Scenario: SCN-012 a fully discounted invoice carries no tax
+    Given a 100% discount
+    When the invoice is totalled
+    Then the tax is zero
+`;
+(0, node_test_1.test)("every scenario in the file is found, not just the one the row names", () => {
+    assert.deepEqual((0, ScenarioCoverage_1.scenariosIn)(FEATURE).map((s) => s.needles[0]), ["SCN-010", "SCN-011", "SCN-012"]);
+});
+(0, node_test_1.test)("the scenario nothing tests is the one reported", () => {
+    // The measured case: an agent wrote tests for the scenarios it could satisfy
+    // and skipped the one it could not.
+    const tests = [
+        `test("SCN-010 subtotal is the sum of line amounts", () => {});
+     test("SCN-011 tax is applied per line", () => {});`,
+    ];
+    const missing = (0, ScenarioCoverage_1.uncoveredScenarios)(FEATURE, tests);
+    assert.equal(missing.length, 1);
+    assert.match(missing[0].title, /fully discounted/);
+});
+(0, node_test_1.test)("a fully covered feature reports nothing", () => {
+    const tests = ["SCN-010 SCN-011 SCN-012"];
+    assert.deepEqual((0, ScenarioCoverage_1.uncoveredScenarios)(FEATURE, tests), []);
+});
+(0, node_test_1.test)("a tag identifies a scenario even after the title is reworded", () => {
+    // The one edit that otherwise defeats every link to a scenario.
+    const tagged = `Feature: F
+
+  @REQ-001 @SCN-042
+  Scenario: something else entirely now
+    Given a thing
+    When it happens
+    Then it holds
+`;
+    assert.deepEqual((0, ScenarioCoverage_1.scenariosIn)(tagged)[0].needles, ["SCN-042"]);
+    assert.deepEqual((0, ScenarioCoverage_1.uncoveredScenarios)(tagged, ["covers @SCN-042 here"]), []);
+});
+(0, node_test_1.test)("without an id anywhere, the title is the identity", () => {
+    const untagged = `Feature: F
+
+  Scenario: the cart rejects a negative quantity
+    Given a cart
+    When a negative quantity is added
+    Then it is rejected
+`;
+    assert.deepEqual((0, ScenarioCoverage_1.scenariosIn)(untagged)[0].needles, ["the cart rejects a negative quantity"]);
+    assert.deepEqual((0, ScenarioCoverage_1.uncoveredScenarios)(untagged, ['test("The cart rejects a negative quantity!", ...)']), [], "punctuation and case must not break a title match");
+    assert.equal((0, ScenarioCoverage_1.uncoveredScenarios)(untagged, ["something unrelated"]).length, 1);
+});
+(0, node_test_1.test)("a Scenario Outline counts — the widest scenarios must not be the unchecked ones", () => {
+    const outline = `Feature: F
+
+  Scenario Outline: SCN-050 rounding across currencies
+    Given <amount>
+    When it is rounded
+    Then it is <result>
+
+    Examples:
+      | amount | result |
+      | 1.005  | 1.01   |
+`;
+    assert.equal((0, ScenarioCoverage_1.scenariosIn)(outline).length, 1);
+    assert.equal((0, ScenarioCoverage_1.uncoveredScenarios)(outline, ["nothing"]).length, 1);
+});
+(0, node_test_1.test)("a scenario proved in any of several test files is proved", () => {
+    const missing = (0, ScenarioCoverage_1.uncoveredScenarios)(FEATURE, ["SCN-010", "SCN-011", "SCN-012 over here"]);
+    assert.deepEqual(missing, []);
+});
+(0, node_test_1.test)("no test sources at all leaves every scenario uncovered", () => {
+    assert.equal((0, ScenarioCoverage_1.uncoveredScenarios)(FEATURE, []).length, 3);
+});
+(0, node_test_1.test)("normalise strips what should not decide a match", () => {
+    assert.equal((0, ScenarioCoverage_1.normalise)("SCN-010: Subtotal!"), (0, ScenarioCoverage_1.normalise)("scn010 subtotal"));
+});
+// ── Fase 1.2: a link that exists but lies ────────────────────────────────────
+(0, node_test_1.test)("a test artifact naming the requirement is evidence enough", () => {
+    assert.equal((0, ScenarioCoverage_1.linkIsUnevidenced)("REQ-014", "", ['test("REQ-014 vets are listed")']), false);
+});
+(0, node_test_1.test)("a test artifact naming one of the requirement's scenarios is evidence", () => {
+    assert.equal((0, ScenarioCoverage_1.linkIsUnevidenced)("REQ-010", FEATURE, ["SCN-011 tax"]), false);
+});
+(0, node_test_1.test)("the measured lie: a seeded row pointed at somebody else's test", () => {
+    // A "Vet" requirement declaring PetValidatorTests.java as its proof. The row
+    // has no scenario, so there is nothing for the scenario check to match on —
+    // which is exactly why those rows lie most easily.
+    assert.equal((0, ScenarioCoverage_1.linkIsUnevidenced)("REQ-014", "", ["class PetTypeFormatterTests { void formatsAName() {} }"]), true);
+});
+(0, node_test_1.test)("no test sources at all is not evidence", () => {
+    assert.equal((0, ScenarioCoverage_1.linkIsUnevidenced)("REQ-014", FEATURE, []), true);
+});
+(0, node_test_1.test)("a row with no requirement id is not this check's business", () => {
+    assert.equal((0, ScenarioCoverage_1.linkIsUnevidenced)("", FEATURE, ["anything"]), false);
+});
+//# sourceMappingURL=scenario-coverage.test.js.map

package/dist/packages/core/test/unit/scenario-coverage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-coverage.test.js","sourceRoot":"","sources":["../../../../../packages/core/test/unit/scenario-coverage.test.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/test/unit/spec-sections.test.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Fase 3.1: `req add` wrote a matrix row and no prose anywhere.
+ */
+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 });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+const SpecSections_1 = require("../../src/domain/SpecSections");
+(0, node_test_1.test)("the generated section carries an obligation keyword", () => {
+    // Otherwise the section fails --strict-requirements, and a project would be
+    // failing a gate over text the tool itself just wrote.
+    const section = (0, SpecSections_1.renderRequirementSection)("REQ-014", "Vets are listed alphabetically");
+    assert.match(section, /^## REQ-014 — Vets are listed alphabetically$/m);
+    assert.match(section, /\bMUST\b/);
+});
+(0, node_test_1.test)("the section says it is a draft, rather than pretending to be finished", () => {
+    assert.match((0, SpecSections_1.renderRequirementSection)("REQ-014", "Vets are listed"), /Replace this sentence/);
+});
+(0, node_test_1.test)("a title starting with an identifier still reads as a sentence", () => {
+    // `MUST res.redirect sets Location` is not English. `MUST satisfy:` is, for
+    // every title, without a heuristic that guesses at grammar.
+    assert.match((0, SpecSections_1.renderRequirementSection)("REQ-002", "res.redirect sets Location and status 302"), /MUST satisfy: res\.redirect sets Location and status 302\./);
+    assert.match((0, SpecSections_1.renderRequirementSection)("REQ-003", "HTTP caching is respected"), /MUST satisfy: HTTP caching is respected\./);
+});
+(0, node_test_1.test)("an existing section is found, and a different id is not", () => {
+    const spec = "# Spec\n\n## REQ-001 — One\n\ntext\n\n## REQ-014 — Fourteen\n\ntext\n";
+    assert.equal((0, SpecSections_1.hasRequirementSection)(spec, "REQ-014"), true);
+    assert.equal((0, SpecSections_1.hasRequirementSection)(spec, "REQ-01"), false, "REQ-01 must not match REQ-014");
+    assert.equal((0, SpecSections_1.hasRequirementSection)(spec, "REQ-999"), false);
+    assert.deepEqual((0, SpecSections_1.requirementSections)(spec), ["REQ-001", "REQ-014"]);
+});
+(0, node_test_1.test)("a mention in prose is not a section, but a nested heading is", () => {
+    // The shipped template puts requirements under "8. Key requirements", so
+    // insisting on top-level `##` would reject documents that are perfectly well
+    // organised. A sentence naming the id is still not a section.
+    assert.equal((0, SpecSections_1.hasRequirementSection)("# Spec\n\nSee REQ-014 for details.\n", "REQ-014"), false);
+    assert.equal((0, SpecSections_1.hasRequirementSection)("# Spec\n\n### REQ-014 — Nested\n\ntext\n", "REQ-014"), true);
+    assert.equal((0, SpecSections_1.hasRequirementSection)("# Spec\n\n##### REQ-014 — Too deep\n", "REQ-014"), false);
+});
+(0, node_test_1.test)("a nested section ends at the next heading of its own level", () => {
+    const spec = [
+        "## 8. Key requirements",
+        "",
+        "### REQ-001 — First",
+        "",
+        "The system MUST do the first thing.",
+        "",
+        "#### Notes",
+        "",
+        "still part of REQ-001",
+        "",
+        "### REQ-002 — Second",
+        "",
+        "not part of REQ-001",
+    ].join("\n");
+    const section = (0, SpecSections_1.extractRequirementSection)(spec, "REQ-001");
+    assert.match(section, /MUST do the first thing/);
+    assert.match(section, /still part of REQ-001/, "a deeper sub-heading stays inside");
+    assert.doesNotMatch(section, /not part of REQ-001/);
+});
+(0, node_test_1.test)("appending adds the section once and is idempotent", () => {
+    const before = "# Spec\n\n## REQ-001 — One\n\ntext\n";
+    const first = (0, SpecSections_1.appendRequirementSection)(before, "REQ-002", "Totals are rounded");
+    assert.equal(first.added, true);
+    assert.equal((0, SpecSections_1.hasRequirementSection)(first.content, "REQ-002"), true);
+    const second = (0, SpecSections_1.appendRequirementSection)(first.content, "REQ-002", "Totals are rounded");
+    assert.equal(second.added, false);
+    assert.equal(second.content, first.content, "running req add twice must not duplicate prose");
+});
+(0, node_test_1.test)("appending does not reorder what a person wrote", () => {
+    // spec.md is a document someone writes in. Sorting their prose to satisfy an
+    // id order is a worse surprise than a section at the end.
+    const before = "# Spec\n\n## REQ-050 — Later\n\ntext\n";
+    const after = (0, SpecSections_1.appendRequirementSection)(before, "REQ-002", "Earlier").content;
+    assert.ok(after.indexOf("REQ-050") < after.indexOf("REQ-002"));
+});
+(0, node_test_1.test)("an empty spec gets a section without a leading blank run", () => {
+    const { content } = (0, SpecSections_1.appendRequirementSection)("", "REQ-001", "First");
+    assert.ok(content.startsWith("## REQ-001"));
+});
+// ── The shapes real documents turned out to use ──────────────────────────────
+(0, node_test_1.test)("a labelled heading declares its requirement", () => {
+    // `### Requirement: REQ-100 — title` is what capability specs use. Four
+    // shapes turned up before this stopped enumerating them.
+    const spec = "## Requirements\n\n### Requirement: REQ-100 — A change is a folder\n\ntext\n";
+    assert.equal((0, SpecSections_1.hasRequirementSection)(spec, "REQ-100"), true);
+    assert.match((0, SpecSections_1.extractRequirementSection)(spec, "REQ-100"), /A change is a folder/);
+});
+(0, node_test_1.test)("the §8 table counts as the requirement's text", () => {
+    // The original `init` template, and this repository's own spec.md. Outlawing
+    // it would have turned every project built from that template red on
+    // upgrade, over text that is right there in the document.
+    const spec = [
+        "## 8. Key requirements",
+        "",
+        "| ID | Requirement | Priority | Status |",
+        "|---|---|---|---|",
+        "| REQ-001 | `init` generates a valid project skeleton. | Must | Verified |",
+        "| REQ-002 | - | Must | Draft |",
+    ].join("\n");
+    assert.equal((0, SpecSections_1.hasRequirementSection)(spec, "REQ-001"), true);
+    assert.match((0, SpecSections_1.extractRequirementSection)(spec, "REQ-001"), /generates a valid project skeleton/);
+    // A row with no prose is an id with nothing behind it — the case worth catching.
+    assert.equal((0, SpecSections_1.hasRequirementSection)(spec, "REQ-002"), false);
+    assert.deepEqual((0, SpecSections_1.requirementSections)(spec), ["REQ-001"]);
+});
+(0, node_test_1.test)("a TBD or empty requirement cell is not text", () => {
+    for (const cell of ["TBD", "", "   ", "-"]) {
+        const spec = `| ID | Requirement |\n|---|---|\n| REQ-005 | ${cell} |\n`;
+        assert.equal((0, SpecSections_1.hasRequirementSection)(spec, "REQ-005"), false, `'${cell}' should not count`);
+    }
+});
+//# sourceMappingURL=spec-sections.test.js.map

package/dist/packages/core/test/unit/spec-sections.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-sections.test.js","sourceRoot":"","sources":["../../../../../packages/core/test/unit/spec-sections.test.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,yCAAiC;AACjC,2DAA6C;AAE7C,gEAMuC;AAEvC,IAAA,gBAAI,EAAC,qDAAqD,EAAE,GAAG,EAAE;IAC/D,4EAA4E;IAC5E,uDAAuD;IACvD,MAAM,OAAO,GAAG,IAAA,uCAAwB,EAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;IACtF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,gDAAgD,CAAC,CAAC;IACxE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,uEAAuE,EAAE,GAAG,EAAE;IACjF,MAAM,CAAC,KAAK,CAAC,IAAA,uCAAwB,EAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,uBAAuB,CAAC,CAAC;AAChG,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,+DAA+D,EAAE,GAAG,EAAE;IACzE,4EAA4E;IAC5E,4DAA4D;IAC5D,MAAM,CAAC,KAAK,CACV,IAAA,uCAAwB,EAAC,SAAS,EAAE,2CAA2C,CAAC,EAChF,4DAA4D,CAC7D,CAAC;IACF,MAAM,CAAC,KAAK,CACV,IAAA,uCAAwB,EAAC,SAAS,EAAE,2BAA2B,CAAC,EAChE,2CAA2C,CAC5C,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,yDAAyD,EAAE,GAAG,EAAE;IACnE,MAAM,IAAI,GAAG,uEAAuE,CAAC;IACrF,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,+BAA+B,CAAC,CAAC;IAC5F,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,IAAI,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5D,MAAM,CAAC,SAAS,CAAC,IAAA,kCAAmB,EAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,8DAA8D,EAAE,GAAG,EAAE;IACxE,yEAAyE;IACzE,6EAA6E;IAC7E,8DAA8D;IAC9D,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,sCAAsC,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9F,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,0CAA0C,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IACjG,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,sCAAsC,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;AAChG,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,4DAA4D,EAAE,GAAG,EAAE;IACtE,MAAM,IAAI,GAAG;QACX,wBAAwB;QACxB,EAAE;QACF,qBAAqB;QACrB,EAAE;QACF,qCAAqC;QACrC,EAAE;QACF,YAAY;QACZ,EAAE;QACF,uBAAuB;QACvB,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,qBAAqB;KACtB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,IAAA,wCAAyB,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,CAAC,OAAQ,EAAE,yBAAyB,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,OAAQ,EAAE,uBAAuB,EAAE,mCAAmC,CAAC,CAAC;IACrF,MAAM,CAAC,YAAY,CAAC,OAAQ,EAAE,qBAAqB,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,MAAM,MAAM,GAAG,sCAAsC,CAAC;IACtD,MAAM,KAAK,GAAG,IAAA,uCAAwB,EAAC,MAAM,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;IAChF,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAG,IAAA,uCAAwB,EAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACxF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,gDAAgD,CAAC,CAAC;AAChG,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,gDAAgD,EAAE,GAAG,EAAE;IAC1D,6EAA6E;IAC7E,0DAA0D;IAC1D,MAAM,MAAM,GAAG,wCAAwC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAA,uCAAwB,EAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC;IAC7E,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,uCAAwB,EAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACrE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,IAAA,gBAAI,EAAC,6CAA6C,EAAE,GAAG,EAAE;IACvD,wEAAwE;IACxE,yDAAyD;IACzD,MAAM,IAAI,GAAG,8EAA8E,CAAC;IAC5F,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,CAAC,IAAA,wCAAyB,EAAC,IAAI,EAAE,SAAS,CAAE,EAAE,sBAAsB,CAAC,CAAC;AACpF,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,+CAA+C,EAAE,GAAG,EAAE;IACzD,6EAA6E;IAC7E,qEAAqE;IACrE,0DAA0D;IAC1D,MAAM,IAAI,GAAG;QACX,wBAAwB;QACxB,EAAE;QACF,0CAA0C;QAC1C,mBAAmB;QACnB,4EAA4E;QAC5E,gCAAgC;KACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,CAAC,IAAA,wCAAyB,EAAC,IAAI,EAAE,SAAS,CAAE,EAAE,oCAAoC,CAAC,CAAC;IAEhG,iFAAiF;IACjF,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,IAAI,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5D,MAAM,CAAC,SAAS,CAAC,IAAA,kCAAmB,EAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,6CAA6C,EAAE,GAAG,EAAE;IACvD,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,gDAAgD,IAAI,MAAM,CAAC;QACxE,MAAM,CAAC,KAAK,CAAC,IAAA,oCAAqB,EAAC,IAAI,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,IAAI,oBAAoB,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/packages/core/test/unit/test-command.test.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Fase 2.3: two detectors disagreed on the same pom.xml.
+ */
+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 });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+const TestCommand_1 = require("../../src/domain/TestCommand");
+function files(map) {
+    return {
+        exists: (p) => Object.prototype.hasOwnProperty.call(map, p),
+        read: (p) => (typeof map[p] === "string" ? map[p] : null),
+    };
+}
+(0, node_test_1.test)("the wrapper wins, because the harness runs in a bare worktree", () => {
+    // `./mvnw` is checked in and works there; `mvn` depends on the machine.
+    // Getting this wrong burns one of the agent's three attempts on
+    // "command not found".
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "pom.xml": true, mvnw: true })), "./mvnw -B test");
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "build.gradle": true, gradlew: true })), "./gradlew test");
+});
+(0, node_test_1.test)("without a wrapper, the system tool is the only option", () => {
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "pom.xml": true })), "mvn -B test");
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "build.gradle.kts": true })), "gradle test");
+});
+(0, node_test_1.test)("a declared npm script is the project's own answer", () => {
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "package.json": '{"scripts":{"test":"vitest"}}' })), "npm test");
+});
+(0, node_test_1.test)("a malformed package.json does not crash the caller", () => {
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "package.json": "{ not json" })), "npm test");
+});
+(0, node_test_1.test)("the other ecosystems", () => {
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "Cargo.toml": true })), "cargo test");
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "go.mod": true })), "go test ./...");
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "pyproject.toml": true })), "pytest");
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "setup.py": true })), "pytest");
+});
+(0, node_test_1.test)("nothing recognisable returns null, and null is a real answer", () => {
+    // Guessing `npm test` into a Python repository is how AI_RULES.md ended up
+    // reading `Testing: unknown` two lines above `Test command: python -m pytest`.
+    assert.equal((0, TestCommand_1.detectTestCommand)(files({ "README.md": true })), null);
+});
+(0, node_test_1.test)("both callers would now agree on the same project", () => {
+    const project = files({ "pom.xml": true, mvnw: true });
+    assert.equal((0, TestCommand_1.detectTestCommand)(project), (0, TestCommand_1.detectTestCommand)(project));
+    assert.equal((0, TestCommand_1.detectTestCommand)(project), "./mvnw -B test");
+});
+//# sourceMappingURL=test-command.test.js.map