@rsaglobaltech/specgate 0.8.1

package/dist/packages/core/test/unit/declared-artifacts.test.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * The green diff must touch what the matrix declared (A2).
+ *
+ * A row names `test_artifact` and `technical_artifact`; the prompt hands both
+ * to the agent; nothing checked the diff contained them. An agent can implement
+ * elsewhere, pass the scenario, and leave the matrix pointing at a file where
+ * the logic does not live — the documentary lie `AI_RULES.md` forbids.
+ *
+ * Most of these tests are about *not* firing. A real matrix cell is markdown
+ * written by a person, and the scaffolded one says `` `API /health`, smoke
+ * test ``. A check that treats prose as a path reports every project as broken,
+ * and a warning that is usually wrong is a warning people learn to ignore —
+ * which is how `--strict`-only rules ended up useless in H14.
+ */
+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 DeclaredArtifacts_1 = require("../../src/domain/DeclaredArtifacts");
+(0, node_test_1.test)("a path is a path; a sentence about a path is not", () => {
+    for (const yes of ["src/App.java", "App.java", "features/core/health.feature", "src/health/"]) {
+        assert.equal((0, DeclaredArtifacts_1.looksLikePath)(yes), true, `${yes} should read as a path`);
+    }
+    for (const no of ["API /health", "smoke test", "TBD", "TODO", "N/A", "-", "", "the health API"]) {
+        assert.equal((0, DeclaredArtifacts_1.looksLikePath)(no), false, `${no} should not read as a path`);
+    }
+});
+(0, node_test_1.test)("a cell can be half path and half prose, and both halves are respected", () => {
+    // The realistic case. Forcing the cell to be all one or all the other would
+    // mean either losing the check or inventing findings about the prose.
+    assert.deepEqual((0, DeclaredArtifacts_1.declaredPaths)("`src/Health.java`, smoke test"), ["src/Health.java"]);
+    assert.deepEqual((0, DeclaredArtifacts_1.declaredPaths)("`API /health`, smoke test"), []);
+    assert.deepEqual((0, DeclaredArtifacts_1.declaredPaths)("TBD"), []);
+    assert.deepEqual((0, DeclaredArtifacts_1.declaredPaths)(""), []);
+    assert.deepEqual((0, DeclaredArtifacts_1.declaredPaths)(null), []);
+});
+(0, node_test_1.test)("a declared path the diff never touched is reported, with a fix that names a real flag", () => {
+    const found = (0, DeclaredArtifacts_1.checkDeclaredArtifacts)({
+        requirement: "REQ-007",
+        touched: ["src/Other.java"],
+        technicalArtifact: "`src/Health.java`",
+    });
+    assert.equal(found.length, 1);
+    assert.equal(found[0].code, DeclaredArtifacts_1.ARTIFACT_CODES.UNTOUCHED);
+    assert.equal(found[0].severity, "warning", "a warning by default — see the module note");
+    assert.match(found[0].message, /src\/Health\.java/);
+    assert.match(found[0].fix, /specgate req link REQ-007 --code/);
+});
+(0, node_test_1.test)("the test artifact gets its own flag in the fix", () => {
+    const found = (0, DeclaredArtifacts_1.checkDeclaredArtifacts)({
+        requirement: "REQ-007",
+        touched: [],
+        testArtifact: "`src/test/HealthTest.java`",
+    });
+    assert.match(found[0].fix, /--test/);
+});
+(0, node_test_1.test)("--strict-artifacts promotes it to an error, and nothing else changes", () => {
+    const input = { requirement: "REQ-007", touched: [], technicalArtifact: "`src/Health.java`" };
+    const lenient = (0, DeclaredArtifacts_1.checkDeclaredArtifacts)(input, false);
+    const strict = (0, DeclaredArtifacts_1.checkDeclaredArtifacts)(input, true);
+    assert.equal(lenient[0].severity, "warning");
+    assert.equal(strict[0].severity, "error");
+    assert.equal(strict[0].message, lenient[0].message);
+});
+(0, node_test_1.test)("touching the declared file raises nothing", () => {
+    assert.deepEqual((0, DeclaredArtifacts_1.checkDeclaredArtifacts)({
+        touched: ["src/Health.java", "src/test/HealthTest.java"],
+        technicalArtifact: "`src/Health.java`",
+        testArtifact: "`src/test/HealthTest.java`",
+    }), []);
+});
+(0, node_test_1.test)("a row may name a directory and the work land on files inside it", () => {
+    assert.deepEqual((0, DeclaredArtifacts_1.checkDeclaredArtifacts)({
+        touched: ["src/health/Endpoint.java"],
+        technicalArtifact: "`src/health/`",
+    }), []);
+});
+(0, node_test_1.test)("a prose-only row produces no findings at all", () => {
+    // The scaffolded project. If this ever starts warning, every `specgate init`
+    // hands the user a harness that complains on its first run.
+    assert.deepEqual((0, DeclaredArtifacts_1.checkDeclaredArtifacts)({
+        requirement: "REQ-000",
+        touched: ["src/App.java"],
+        technicalArtifact: "`API /health`, smoke test",
+        testArtifact: "TBD",
+    }), []);
+});
+(0, node_test_1.test)("an empty diff with prose declarations is still silent", () => {
+    assert.deepEqual((0, DeclaredArtifacts_1.checkDeclaredArtifacts)({ touched: [], technicalArtifact: "TBD", testArtifact: "TBD" }), []);
+});
+//# sourceMappingURL=declared-artifacts.test.js.map

package/dist/packages/core/test/unit/declared-artifacts.test.js.map

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

package/dist/packages/core/test/unit/empty-attempt.test.js

@@ -0,0 +1,79 @@
+"use strict";
+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 });
+/**
+ * H19 — the harness gate approved an agent that wrote nothing.
+ *
+ * Reproduced end to end on 2026-08-26 (`--agent "cat {prompt_file} >
+ * /dev/null"` against a generated project reported `pass (1 attempt)` and
+ * moved the row to `Implemented`). These tests pin the decidable core of the
+ * fix so it cannot regress without failing here first.
+ */
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+const EmptyAttempt_1 = require("../../src/domain/EmptyAttempt");
+(0, node_test_1.test)("an attempt that touched nothing is empty", () => {
+    assert.equal((0, EmptyAttempt_1.isEmptyAttempt)([]), true);
+});
+(0, node_test_1.test)("an attempt carrying only the archived prompt is empty", () => {
+    // This is the H19 shape: the harness wrote the archive, the agent wrote
+    // nothing. Counting it would let the harness's bookkeeping vouch for the
+    // agent.
+    assert.equal((0, EmptyAttempt_1.isEmptyAttempt)([`${EmptyAttempt_1.PROMPT_ARCHIVE_DIR}/REQ-000-attempt-1-agent.md`]), true);
+    assert.equal((0, EmptyAttempt_1.isEmptyAttempt)([EmptyAttempt_1.PROMPT_ARCHIVE_DIR]), true);
+});
+(0, node_test_1.test)("one file the agent wrote is enough to not be empty", () => {
+    assert.equal((0, EmptyAttempt_1.isEmptyAttempt)(["src/health.ts"]), false);
+});
+(0, node_test_1.test)("the archived prompt does not hide a real file beside it", () => {
+    assert.equal((0, EmptyAttempt_1.isEmptyAttempt)([`${EmptyAttempt_1.PROMPT_ARCHIVE_DIR}/REQ-000-attempt-1-agent.md`, "src/health.ts"]), false);
+});
+(0, node_test_1.test)("a path merely starting with the archive's name is not the archive", () => {
+    // `.specops/harness-prompts-notes.md` is a different file; a naive
+    // startsWith on the bare directory name would swallow it.
+    assert.equal((0, EmptyAttempt_1.isEmptyAttempt)([`${EmptyAttempt_1.PROMPT_ARCHIVE_DIR}-notes.md`]), false);
+});
+(0, node_test_1.test)("agentAuthoredPaths reports what the agent wrote, in order", () => {
+    assert.deepEqual((0, EmptyAttempt_1.agentAuthoredPaths)([
+        "src/health.ts",
+        `${EmptyAttempt_1.PROMPT_ARCHIVE_DIR}/REQ-000-attempt-1-agent.md`,
+        "tests/health.test.ts",
+    ]), ["src/health.ts", "tests/health.test.ts"]);
+});
+(0, node_test_1.test)("undefined and null touched lists do not throw", () => {
+    assert.equal((0, EmptyAttempt_1.isEmptyAttempt)(undefined), true);
+    assert.deepEqual((0, EmptyAttempt_1.agentAuthoredPaths)(null), []);
+});
+//# sourceMappingURL=empty-attempt.test.js.map

package/dist/packages/core/test/unit/empty-attempt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-attempt.test.js","sourceRoot":"","sources":["../../../../../packages/core/test/unit/empty-attempt.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;GAOG;AACH,yCAAiC;AACjC,2DAA6C;AAC7C,gEAIuC;AAEvC,IAAA,gBAAI,EAAC,0CAA0C,EAAE,GAAG,EAAE;IACpD,MAAM,CAAC,KAAK,CAAC,IAAA,6BAAc,EAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,uDAAuD,EAAE,GAAG,EAAE;IACjE,wEAAwE;IACxE,yEAAyE;IACzE,SAAS;IACT,MAAM,CAAC,KAAK,CAAC,IAAA,6BAAc,EAAC,CAAC,GAAG,iCAAkB,6BAA6B,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACzF,MAAM,CAAC,KAAK,CAAC,IAAA,6BAAc,EAAC,CAAC,iCAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,CAAC,KAAK,CAAC,IAAA,6BAAc,EAAC,CAAC,eAAe,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,yDAAyD,EAAE,GAAG,EAAE;IACnE,MAAM,CAAC,KAAK,CACV,IAAA,6BAAc,EAAC,CAAC,GAAG,iCAAkB,6BAA6B,EAAE,eAAe,CAAC,CAAC,EACrF,KAAK,CACN,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,mEAAmE,EAAE,GAAG,EAAE;IAC7E,mEAAmE;IACnE,0DAA0D;IAC1D,MAAM,CAAC,KAAK,CAAC,IAAA,6BAAc,EAAC,CAAC,GAAG,iCAAkB,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC1E,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,2DAA2D,EAAE,GAAG,EAAE;IACrE,MAAM,CAAC,SAAS,CACd,IAAA,iCAAkB,EAAC;QACjB,eAAe;QACf,GAAG,iCAAkB,6BAA6B;QAClD,sBAAsB;KACvB,CAAC,EACF,CAAC,eAAe,EAAE,sBAAsB,CAAC,CAC1C,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAA,gBAAI,EAAC,+CAA+C,EAAE,GAAG,EAAE;IACzD,MAAM,CAAC,KAAK,CAAC,IAAA,6BAAc,EAAC,SAAkB,CAAC,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,SAAS,CAAC,IAAA,iCAAkB,EAAC,IAAa,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC"}

package/dist/packages/core/test/unit/gherkin-dialects.test.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * The vendored keyword table, checked against the official one.
+ *
+ * `GherkinDialects.ts` is data copied out of `@cucumber/gherkin` so the CLI can
+ * read Gherkin without a runtime dependency — `package.json` has none, and it
+ * runs through `npx` on other people's machines, so that is a structural
+ * promise rather than a preference.
+ *
+ * The price of vendoring is drift, and this is where it gets paid: every entry
+ * is compared with the installed official table, so bumping Cucumber either
+ * passes or says exactly which keyword moved. Without this file the table is a
+ * copy that slowly stops being one.
+ */
+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 GherkinDialects_1 = require("../../src/domain/GherkinDialects");
+const official = require("@cucumber/gherkin/dist/gherkin-languages.json");
+const installedVersion = require("@cucumber/gherkin/package.json").version;
+const KEYS = [
+    "feature",
+    "background",
+    "rule",
+    "scenario",
+    "scenarioOutline",
+    "examples",
+    "given",
+    "when",
+    "then",
+    "and",
+    "but",
+];
+(0, node_test_1.test)("every vendored dialect matches the official table, keyword for keyword", () => {
+    const drift = [];
+    for (const [tag, dialect] of Object.entries(GherkinDialects_1.DIALECTS)) {
+        const source = official[tag];
+        if (!source) {
+            drift.push(`${tag}: no longer exists in the official table`);
+            continue;
+        }
+        if (dialect.name !== source.name || dialect.native !== source.native) {
+            drift.push(`${tag}: name/native changed — ${source.name} / ${source.native}`);
+        }
+        for (const key of KEYS) {
+            const ours = [...dialect[key]];
+            const theirs = [...(source[key] ?? [])];
+            if (JSON.stringify(ours) !== JSON.stringify(theirs)) {
+                drift.push(`${tag}.${key}: vendored ${JSON.stringify(ours)} vs official ${JSON.stringify(theirs)}`);
+            }
+        }
+    }
+    assert.deepEqual(drift, [], "\n  The vendored table has drifted from @cucumber/gherkin. Regenerate it from\n" +
+        "  node_modules/@cucumber/gherkin/dist/gherkin-languages.json rather than\n" +
+        `  editing by hand:\n  ${drift.join("\n  ")}`);
+});
+(0, node_test_1.test)("the table records which version it was taken from", () => {
+    // Not an equality check: the point is that the recorded version is the one
+    // the drift check above ran against, so a passing suite means the table
+    // matches *this* Cucumber, and the number in the file says which.
+    assert.equal(GherkinDialects_1.DIALECT_TABLE_VERSION, installedVersion, "the vendored table names a different version than the one installed — regenerate it");
+});
+(0, node_test_1.test)("the dialects the CLI offers are the dialects it can parse", () => {
+    // `specgate init` takes LANG en / es / pt. A language the scaffolder offers and
+    // the parser does not know would produce files the tool cannot read back.
+    for (const tag of ["en", "es", "pt"]) {
+        assert.ok(GherkinDialects_1.DIALECTS[tag], `${tag} is offered by init but missing from the table`);
+    }
+    assert.ok(GherkinDialects_1.DIALECTS[GherkinDialects_1.DEFAULT_DIALECT], "the default dialect must exist");
+});
+(0, node_test_1.test)("step keywords keep the trailing space the table gives them", () => {
+    // `"Given "` ends in a space on purpose: it is what stops `Givenchy` from
+    // parsing as a step. Trimming the table would silently widen every keyword.
+    for (const [tag, dialect] of Object.entries(GherkinDialects_1.DIALECTS)) {
+        for (const kind of ["given", "when", "then", "and", "but"]) {
+            for (const keyword of dialect[kind]) {
+                assert.ok(keyword.endsWith(" "), `${tag}.${kind}: ${JSON.stringify(keyword)} lost its trailing space`);
+            }
+        }
+    }
+});
+//# sourceMappingURL=gherkin-dialects.test.js.map

package/dist/packages/core/test/unit/gherkin-dialects.test.js.map

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

package/dist/packages/core/test/unit/gherkin-keyword-case.test.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Lines that were trying to be Gherkin keywords and are not (F3).
+ *
+ * Cucumber discards them in silence: `GIVEN a flag` is prose to it, so the
+ * scenario ends up with fewer steps than it appears to have — or none. That
+ * silence is what let H14 ship 27 scenarios which executed nothing while
+ * `pack lint --strict` reported the packs as fine.
+ *
+ * The risk of a check like this is the opposite failure: crying wolf on prose
+ * that merely resembles a keyword. Most of what is asserted here is that it
+ * stays quiet.
+ */
+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 Gherkin_1 = require("../../src/domain/Gherkin");
+const feature = (...lines) => lines.join("\n") + "\n";
+(0, node_test_1.test)("upper-case step keywords are reported with the spelling that works", () => {
+    // H14 exactly. The fix has to be literal: "write `Given`" is actionable,
+    // "no steps found" is a riddle.
+    const issues = (0, Gherkin_1.findKeywordCaseIssues)(feature("Feature: Flags", "  Scenario: Rollout", "    GIVEN a flag", "    WHEN evaluated", "    THEN it works"));
+    assert.deepEqual(issues.map((i) => [i.line, i.found, i.expected]), [
+        [3, "GIVEN", "Given"],
+        [4, "WHEN", "When"],
+        [5, "THEN", "Then"],
+    ]);
+});
+(0, node_test_1.test)("a mis-cased block keyword is reported too", () => {
+    const issues = (0, Gherkin_1.findKeywordCaseIssues)(feature("Feature: Flags", "  SCENARIO: Rollout", "    Given a flag"));
+    assert.equal(issues.length, 1);
+    assert.equal(issues[0].found, "SCENARIO");
+    assert.equal(issues[0].expected, "Scenario");
+});
+(0, node_test_1.test)("a space before the colon is caught, though the case is right", () => {
+    // `Feature :` reads as correct and is not: Cucumber does not recognise it,
+    // so the whole file silently has no feature.
+    const issues = (0, Gherkin_1.findKeywordCaseIssues)(feature("Feature : Flags", "  Scenario: Rollout", "    Given a flag"));
+    assert.equal(issues.length, 1);
+    assert.equal(issues[0].expected, "Feature");
+});
+(0, node_test_1.test)("lower-case keywords are caught as well as upper-case ones", () => {
+    const issues = (0, Gherkin_1.findKeywordCaseIssues)(feature("Feature: Flags", "  Scenario: Rollout", "    given a flag"));
+    assert.deepEqual(issues.map((i) => [i.found, i.expected]), [["given", "Given"]]);
+});
+(0, node_test_1.test)("a correct file reports nothing", () => {
+    const issues = (0, Gherkin_1.findKeywordCaseIssues)(feature("@tagged", "Feature: Flags", "  Background:", "    Given a tenant", "  Rule: Rollout", "    Scenario Outline: Percentages", "      Given a flag at <n>", "      When users are evaluated", "      Then roughly <n> receive it", "      And nobody else does", "      * even this one", "      Examples:", "        | n  |", "        | 50 |"));
+    assert.deepEqual(issues, []);
+});
+(0, node_test_1.test)("a word that merely starts like a keyword is not a mistake", () => {
+    // `Givenchy` begins with `Given`. The trailing space in the keyword table is
+    // what separates them, and this is the test that keeps it there.
+    const issues = (0, Gherkin_1.findKeywordCaseIssues)(feature("Feature: Brands", "  Scenario: Launch", "    Given Givenchy launched a product"));
+    assert.deepEqual(issues, []);
+});
+(0, node_test_1.test)("keywords inside a doc string are content, not mistakes", () => {
+    const issues = (0, Gherkin_1.findKeywordCaseIssues)(feature("Feature: Payloads", "  Scenario: A body that looks like Gherkin", "    Given a request body", '      """', "      GIVEN this is documentation", "      SCENARIO: and so is this", '      """', "    When it is sent", "    Then it is accepted"));
+    assert.deepEqual(issues, []);
+});
+(0, node_test_1.test)("data tables, comments and tags are left alone", () => {
+    const issues = (0, Gherkin_1.findKeywordCaseIssues)(feature("# GIVEN this comment mentions a keyword", "@GIVEN", "Feature: Tables", "  Scenario Outline: Rows", "    Given a value <v>", "    Examples:", "      | v     |", "      | GIVEN |"));
+    assert.deepEqual(issues, []);
+});
+(0, node_test_1.test)("the Spanish dialect is judged by its own keywords", () => {
+    const wrong = (0, Gherkin_1.findKeywordCaseIssues)(feature("# language: es", "Característica: Facturación", "  Escenario: Emitir", "    DADO un cliente"));
+    assert.deepEqual(wrong.map((i) => [i.found, i.expected]), [["DADO", "Dado"]]);
+    const right = (0, Gherkin_1.findKeywordCaseIssues)(feature("# language: es", "Característica: Facturación", "  Escenario: Emitir", "    Dado un cliente"));
+    assert.deepEqual(right, []);
+});
+(0, node_test_1.test)("an English keyword in a Spanish file is not silently accepted", () => {
+    // `Given` is not a keyword in `es`, so Cucumber reads it as prose. Reporting
+    // it as an unknown keyword would be wrong — it is a dialect mismatch — but
+    // staying silent is what H14 was.
+    const issues = (0, Gherkin_1.findKeywordCaseIssues)(feature("# language: es", "Característica: X", "  Escenario: Y", "    Given a customer"));
+    assert.deepEqual(issues, [], "not a case mistake; `scenario_has_no_steps` is what reports this");
+});
+//# sourceMappingURL=gherkin-keyword-case.test.js.map

package/dist/packages/core/test/unit/gherkin-keyword-case.test.js.map

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

package/dist/packages/core/test/unit/gherkin-quality.test.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * The scenario-quality rules, tested where they now live (A3).
+ *
+ * They used to live inside `pack lint` and judge one thing: a `pack.yaml`. The
+ * harness does not gate packs, it gates projects, and a project's features
+ * arrive by routes that never touch `pack lint`. Moving the rules into the
+ * domain is what lets `validate --strict-scenarios`, `doctor` and `harness run`
+ * reach the same verdict instead of growing three drifting copies — which is
+ * exactly how H14 happened.
+ *
+ * Severity is the part worth pinning: two rules are errors and can never be
+ * demoted to style, because the scenarios they catch *pass*.
+ */
+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 GherkinQuality_1 = require("../../src/domain/GherkinQuality");
+const codesOf = (findings) => findings.map((f) => f.code);
+const byCode = (findings, code) => findings.find((f) => f.code === code);
+const GOOD = {
+    name: "Defining a flag emits FlagDefined",
+    steps: [
+        { keyword: "given", text: "no flag with id 'new-checkout' exists" },
+        { keyword: "when", text: "an operator defines the flag with default=false" },
+        { keyword: "then", text: "FlagDefined is emitted" },
+    ],
+    outline: false,
+    hasExamples: true,
+};
+(0, node_test_1.test)("a well-formed scenario raises nothing", () => {
+    assert.deepEqual((0, GherkinQuality_1.analyseScenario)(GOOD, "SCN-001"), []);
+});
+(0, node_test_1.test)("an empty scenario is an error, never a warning", () => {
+    // The whole point of A3 meeting H14: Cucumber reports this as
+    // `1 scenario (1 passed) · 0 steps · exit 0`. A warning would let it ship.
+    const found = (0, GherkinQuality_1.analyseScenario)({ ...GOOD, steps: [] }, "SCN-001");
+    const noSteps = byCode(found, GherkinQuality_1.QUALITY_CODES.NO_STEPS);
+    assert.ok(noSteps, `expected ${GherkinQuality_1.QUALITY_CODES.NO_STEPS}, got ${codesOf(found)}`);
+    assert.equal(noSteps.severity, "error");
+    assert.ok(noSteps.fix, "a rule without a fix is a rule the user cannot act on");
+    assert.match(noSteps.message, /case-sensitive/, "it should name the usual cause");
+});
+(0, node_test_1.test)("a Scenario Outline without Examples is an error — it runs zero times", () => {
+    const found = (0, GherkinQuality_1.analyseScenario)({ ...GOOD, outline: true, hasExamples: false }, "SCN-001");
+    const outline = byCode(found, GherkinQuality_1.QUALITY_CODES.OUTLINE_WITHOUT_EXAMPLES);
+    assert.ok(outline);
+    assert.equal(outline.severity, "error");
+});
+(0, node_test_1.test)("thin, actionless, assertionless and vague scenarios are warnings", () => {
+    // They weaken the signal; they do not fake it. Blocking on them would make
+    // the tool unusable on a repository brought in with `specgate adopt`.
+    const thin = (0, GherkinQuality_1.analyseScenario)({ ...GOOD, steps: [{ keyword: "given", text: "a thing" }] }, "SCN-001");
+    assert.equal(byCode(thin, GherkinQuality_1.QUALITY_CODES.TOO_FEW_STEPS).severity, "warning");
+    assert.equal(byCode(thin, GherkinQuality_1.QUALITY_CODES.NO_WHEN).severity, "warning");
+    assert.equal(byCode(thin, GherkinQuality_1.QUALITY_CODES.NO_THEN).severity, "warning");
+    const vague = (0, GherkinQuality_1.analyseScenario)({ ...GOOD, steps: [...GOOD.steps, { keyword: "then", text: "it works correctly" }] }, "SCN-001");
+    const v = byCode(vague, GherkinQuality_1.QUALITY_CODES.VAGUE_STEP);
+    assert.ok(v, `expected a vague-step finding, got ${codesOf(vague)}`);
+    assert.equal(v.severity, "warning");
+});
+(0, node_test_1.test)("every finding carries the target it was asked to report against", () => {
+    const found = (0, GherkinQuality_1.analyseScenario)({ ...GOOD, steps: [] }, "SCN-042", "features/x.feature");
+    assert.equal(found[0].target, "SCN-042");
+    assert.equal(found[0].file, "features/x.feature");
+});
+(0, node_test_1.test)("isGenericTitle knows a name from a placeholder", () => {
+    for (const bad of ["", "Test", "Scenario 1", "Example", "Untitled", "two words"]) {
+        assert.equal((0, GherkinQuality_1.isGenericTitle)(bad), true, `${JSON.stringify(bad)} should be generic`);
+    }
+    assert.equal((0, GherkinQuality_1.isGenericTitle)("Defining a flag emits FlagDefined"), false);
+});
+(0, node_test_1.test)("keyword case is judged on the raw text, with the line and the fix", () => {
+    const source = [
+        "Feature: Flags",
+        "  Scenario: Defining a flag emits FlagDefined",
+        "    GIVEN no flag exists",
+        "    When an operator defines one",
+        "    Then FlagDefined is emitted",
+        "",
+    ].join("\n");
+    const found = (0, GherkinQuality_1.analyseKeywordCase)(source, "features/flags.feature");
+    assert.equal(found.length, 1, `expected one, got ${JSON.stringify(found)}`);
+    assert.equal(found[0].code, GherkinQuality_1.QUALITY_CODES.KEYWORD_CASE);
+    assert.equal(found[0].severity, "error");
+    assert.equal(found[0].line, 3);
+    assert.equal(found[0].file, "features/flags.feature");
+    assert.match(found[0].message, /`GIVEN`/);
+    assert.match(found[0].message, /`Given`/);
+});
+(0, node_test_1.test)("a source-level analysis reports the case error and the emptiness it causes", () => {
+    // Both, deliberately. The case error says what to change; `no steps` says
+    // what it costs. One without the other is either a riddle or a nag.
+    const source = [
+        "Feature: Flags",
+        "  Scenario: Defining a flag emits FlagDefined",
+        "    GIVEN no flag exists",
+        "    WHEN an operator defines one",
+        "    THEN FlagDefined is emitted",
+        "",
+    ].join("\n");
+    const codes = codesOf((0, GherkinQuality_1.analyseGherkinSource)(source, "features/flags.feature"));
+    assert.equal(codes.filter((c) => c === GherkinQuality_1.QUALITY_CODES.KEYWORD_CASE).length, 3);
+    assert.ok(codes.includes(GherkinQuality_1.QUALITY_CODES.NO_STEPS));
+});
+(0, node_test_1.test)("a good source analyses clean, in Spanish as in English", () => {
+    const es = [
+        "# language: es",
+        "Característica: Facturación",
+        "  Escenario: Emitir una factura genera InvoiceIssued",
+        "    Dado un cliente con id 'C-1'",
+        "    Cuando se emite la factura por 100 EUR",
+        "    Entonces se emite InvoiceIssued",
+        "",
+    ].join("\n");
+    assert.deepEqual((0, GherkinQuality_1.analyseGherkinSource)(es, "features/facturacion.feature"), []);
+});
+//# sourceMappingURL=gherkin-quality.test.js.map

package/dist/packages/core/test/unit/gherkin-quality.test.js.map

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