@rsaglobaltech/specgate 0.8.1 → 0.9.0

package/dist/packages/core/src/domain/RequirementRemoval.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Taking a requirement back out (Fase 4.1).
+ *
+ * `req add` had no counterpart. When the matrix got into a state somebody
+ * wanted to undo, two of three cold adoptions repaired it by hand with a
+ * script, because nothing supported it: *"There is no `req rm`/renumber, so I
+ * repaired it with a script."*
+ *
+ * The trigger for that was a defect — `req add` reissuing an id that `adopt`
+ * had already seeded — and that defect is fixed. The gap is not: a matrix a
+ * team cannot delete a row from is not a document a team can maintain.
+ *
+ * ## Why there is no `req renumber`
+ *
+ * It was the other half of what they asked for, and it is deliberately not
+ * here. A requirement id is not only a cell in this table: it appears in
+ * `@REQ-014` Gherkin tags, in test names, in commit messages, in branch names
+ * the harness created, and in whatever a team wrote in their own tracker.
+ * Renumbering the two files this tool owns while every other mention keeps the
+ * old id would leave a project in a worse state than the one it was trying to
+ * fix, and a rename that silently covers 60% of the occurrences is exactly the
+ * kind of half-promise this repository keeps finding in itself.
+ *
+ * Deleting is honest because it is complete: the row and the prose go, and the
+ * caller is told what it did *not* touch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDelivered = isDelivered;
+exports.planRemoval = planRemoval;
+exports.removeMatrixRows = removeMatrixRows;
+exports.removeSpecProse = removeSpecProse;
+const DRAFT = "Draft";
+/** Statuses that mean somebody recorded this requirement as delivered. */
+function isDelivered(status) {
+    const s = String(status || "").trim();
+    return s !== "" && s !== DRAFT;
+}
+function cells(line) {
+    return line.split("|").map((c) => c.trim());
+}
+/**
+ * What removing `reqId` would take out of the matrix.
+ *
+ * `otherRowsUseFeature` decides whether a declared feature file becomes an
+ * orphan: a feature still referenced by another row is nobody's problem.
+ */
+function planRemoval(traceContent, reqId, specContent) {
+    const wanted = String(reqId || "").trim();
+    const lines = String(traceContent || "")
+        .replace(/\r\n/g, "\n")
+        .split("\n");
+    const rows = [];
+    const statuses = [];
+    const declaredFeatures = [];
+    const featuresElsewhere = new Set();
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("|") || trimmed.includes("---"))
+            continue;
+        const c = cells(trimmed);
+        if (c.length < 4)
+            continue;
+        const rowId = c[1];
+        if (!/^REQ-/.test(rowId))
+            continue;
+        const feature = (c[3] || "").replace(/^`|`$/g, "").split("#")[0].trim();
+        if (rowId === wanted) {
+            rows.push(line);
+            statuses.push(c[c.length - 2] || "");
+            if (feature && feature !== "-")
+                declaredFeatures.push(feature);
+        }
+        else if (feature && feature !== "-") {
+            featuresElsewhere.add(feature);
+        }
+    }
+    return {
+        rows,
+        statuses,
+        orphanedFeatures: [...new Set(declaredFeatures)].filter((f) => !featuresElsewhere.has(f)),
+        hasProse: hasProseFor(specContent, wanted),
+    };
+}
+/** Every requirement id a piece of text names. Static: never built from input. */
+const REQ_ID = /\bREQ-[A-Za-z0-9.]+\b/g;
+const HEADING = /^#{2,4}\s+/;
+function namedIds(text) {
+    return text.match(REQ_ID) || [];
+}
+/** `| REQ-014 | …` — the id in a table row's first cell, or null. */
+function firstCellId(trimmedLine) {
+    if (!trimmedLine.startsWith("|"))
+        return null;
+    const first = trimmedLine.split("|")[1];
+    return first === undefined ? null : first.trim();
+}
+function hasProseFor(specContent, reqId) {
+    if (!reqId)
+        return false;
+    for (const line of String(specContent || "")
+        .replace(/\r\n/g, "\n")
+        .split("\n")) {
+        const trimmed = line.trim();
+        if (HEADING.test(trimmed) && namedIds(trimmed).includes(reqId))
+            return true;
+        if (firstCellId(trimmed) === reqId)
+            return true;
+    }
+    return false;
+}
+/** The matrix without `reqId`'s rows. */
+function removeMatrixRows(traceContent, reqId) {
+    const wanted = String(reqId || "").trim();
+    return String(traceContent || "")
+        .replace(/\r\n/g, "\n")
+        .split("\n")
+        .filter((line) => {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("|"))
+            return true;
+        const c = cells(trimmed);
+        return c.length < 2 || c[1] !== wanted;
+    })
+        .join("\n");
+}
+/**
+ * `spec.md` without `reqId`'s section or table row.
+ *
+ * A section runs until the next heading of the same level or higher, matching
+ * how `SpecSections` reads it back — the two have to agree or removal leaves
+ * half a section behind.
+ */
+function removeSpecProse(specContent, reqId) {
+    const wanted = String(reqId || "").trim();
+    const lines = String(specContent || "")
+        .replace(/\r\n/g, "\n")
+        .split("\n");
+    const kept = [];
+    let skipUntilLevel = 0;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        const heading = /^(#{1,6})\s+\S/.exec(trimmed);
+        if (skipUntilLevel > 0) {
+            if (heading && heading[1].length <= skipUntilLevel)
+                skipUntilLevel = 0;
+            else
+                continue;
+        }
+        const reqHeading = /^(#{2,4})\s+(.*)$/.exec(trimmed);
+        if (reqHeading && namedIds(reqHeading[2]).includes(wanted)) {
+            skipUntilLevel = reqHeading[1].length;
+            continue;
+        }
+        if (firstCellId(trimmed) === wanted)
+            continue;
+        kept.push(line);
+    }
+    return kept.join("\n").replace(/\n{3,}/g, "\n\n");
+}
+//# sourceMappingURL=RequirementRemoval.js.map

package/dist/packages/core/src/domain/RequirementRemoval.js.map

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

package/dist/packages/core/src/domain/ScenarioCoverage.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * Does anything actually prove this scenario? (#168)
+ *
+ * A matrix row names one `Scenario ID` and one feature file. The file may hold
+ * five scenarios. Nothing related the other four to anything, so a scenario
+ * could be declared and never tested while every gate stayed green — measured,
+ * with `--strict-tdd --strict-scenarios --strict-links` all on at once.
+ *
+ * That is not a theoretical hole. Handed five scenarios where one contradicted
+ * another, an agent wrote tests for four and silently skipped the impossible
+ * one; the gate approved and the row went to `Implemented`. The scenario it
+ * dropped was precisely the one worth knowing about.
+ *
+ * ## Why matching by name is the right amount of cleverness
+ *
+ * This tool does not run the test suite and cannot know which assertion
+ * corresponds to which scenario. What it can check is that the scenario is
+ * *named* in the artifact the matrix says proves it. That works because it is
+ * what people and agents already do without being asked — `test('SCN-012 money
+ * is rounded half-up')` was written by an agent nobody instructed to do so.
+ *
+ * It is a heuristic, and it is stated as one: this lives behind
+ * `--strict-coverage` rather than in the default gate, because a project that
+ * names its tests some other way would fail through no fault of its own.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalise = normalise;
+exports.scenariosIn = scenariosIn;
+exports.uncoveredScenarios = uncoveredScenarios;
+exports.linkIsUnevidenced = linkIsUnevidenced;
+exports.usesNamingConvention = usesNamingConvention;
+exports.skippedScenarios = skippedScenarios;
+const SCENARIO_LINE = /^(\s*)(Scenario Outline|Scenario|Escenario|Example)\s*:\s*(.*)$/;
+const TAG_LINE = /^\s*@/;
+const SCN_ID = /\b(SCN-[A-Za-z0-9.]+)\b/;
+/** Lowercase alphanumerics only, so punctuation and case cannot break a match. */
+function normalise(text) {
+    return text.toLowerCase().replace(/[^a-z0-9]+/g, "");
+}
+/**
+ * Every scenario in a feature file, with what would identify it in a test.
+ *
+ * Scenario Outlines count: an outline with Examples is still behaviour someone
+ * promised, and skipping it would leave the widest scenarios unchecked.
+ */
+function scenariosIn(featureSource) {
+    const lines = featureSource.replace(/\r\n/g, "\n").split("\n");
+    const out = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        const match = SCENARIO_LINE.exec(lines[i]);
+        if (!match)
+            continue;
+        const title = match[3].trim();
+        if (title === "")
+            continue;
+        const needles = [];
+        // A tag on the line above is the strongest identity: it survives a rename,
+        // which is the one edit that otherwise defeats every link to a scenario.
+        if (i > 0 && TAG_LINE.test(lines[i - 1])) {
+            const tagged = SCN_ID.exec(lines[i - 1]);
+            if (tagged)
+                needles.push(tagged[1]);
+        }
+        const inTitle = SCN_ID.exec(title);
+        if (inTitle && !needles.includes(inTitle[1]))
+            needles.push(inTitle[1]);
+        // Without an id anywhere, the title is all there is.
+        if (needles.length === 0)
+            needles.push(title);
+        out.push({ title, needles });
+    }
+    return out;
+}
+/**
+ * The scenarios none of `testSources` mentions.
+ *
+ * `testSources` is every file the matrix declares as proof for this row — one
+ * file usually, but a directory expands to several, and a scenario proved in
+ * any of them is proved.
+ */
+function uncoveredScenarios(featureSource, testSources) {
+    const haystack = testSources.map(normalise).join("\n");
+    if (haystack === "")
+        return scenariosIn(featureSource);
+    return scenariosIn(featureSource).filter((scenario) => !scenario.needles.some((needle) => haystack.includes(normalise(needle))));
+}
+/**
+ * A declared test artifact that names neither the requirement nor any of its
+ * scenarios (Fase 1.2).
+ *
+ * `--strict-links` is `fs.existsSync` and nothing more, so a link that merely
+ * *lies* passes: measured on a real adoption, a "Vet" requirement ended up
+ * declaring `PetValidatorTests.java` as its proof and every gate stayed green.
+ * `uncoveredScenarios` catches that whenever the row has scenarios to name —
+ * but the rows that lie most easily are the ones `adopt` seeds, which have a
+ * use case and no scenario at all, so there is nothing to match and the check
+ * skips them.
+ *
+ * For those, the requirement id is the only available evidence: a test file
+ * that mentions neither `REQ-014` nor any scenario of REQ-014 is not visibly
+ * proving REQ-014.
+ *
+ * Returns true when the link has no evidence in it.
+ *
+ * ## The limit, stated rather than hidden
+ *
+ * This says the artifact does not *mention* the requirement. It cannot say the
+ * artifact does not *prove* it — that needs the suite executed and coverage
+ * attributed per test, which this tool does not do. Naming is a proxy, and the
+ * flag it lives behind is opt-in for exactly that reason.
+ */
+function linkIsUnevidenced(requirementId, featureSource, testSources) {
+    if (!requirementId)
+        return false;
+    const haystack = testSources.map(normalise).join("\n");
+    if (haystack === "")
+        return true;
+    if (haystack.includes(normalise(requirementId)))
+        return false;
+    return !scenariosIn(featureSource).some((scenario) => scenario.needles.some((needle) => haystack.includes(normalise(needle))));
+}
+/**
+ * Does this project name requirements or scenarios in its tests at all?
+ *
+ * ## Why the check has to ask this first
+ *
+ * `--strict-coverage` matches names, and that works because agents and people
+ * writing tests alongside scenarios do it without being asked. It does **not**
+ * work for the case this product leads with. Retro-fitting specs onto a
+ * brownfield repository means pointing a row at a test that already exists and
+ * was written years before anyone had heard of this tool — and the only way to
+ * satisfy a name match there is to edit that test.
+ *
+ * Which is exactly what `adopt` promises it will never make you do. Measured on
+ * a real adoption: every retro-fitted row failed `link_without_evidence`, and
+ * the only fix was to write `REQ-006` into someone's existing test file. A gate
+ * that contradicts the product's headline promise is not a gate, it is a
+ * reason to stop using the product.
+ *
+ * So the check calibrates on the project instead of assuming. If some tests
+ * name their requirements and others do not, the silent ones are worth
+ * reporting. If none do, the convention is not in use here and the honest
+ * answer is to say the check could not run — not to fail every row for
+ * following a convention nobody adopted.
+ */
+function usesNamingConvention(rows) {
+    return rows.some((row) => !linkIsUnevidenced(row.requirement || "", row.feature, row.tests));
+}
+/**
+ * Which scenarios in one feature file the tests actually name.
+ *
+ * ## Why this is per file and not per project
+ *
+ * The first version calibrated on the whole project: if any test named any
+ * requirement, every row had to. A cold evaluator found what that feels like —
+ * adding one comment, `// Covers REQ-009`, to one test turned three unrelated
+ * rows red at once. They called it a one-comment CI landmine, and they were
+ * right: doing the correct thing produced a punishment, which teaches people
+ * not to do the correct thing.
+ *
+ * Per file, the signal is sharper and the blast radius is the file. If four of
+ * five scenarios in `totals.feature` are named by its test and the fifth is
+ * not, the fifth was skipped — that is exactly #168, an agent quietly dropping
+ * the scenario it could not satisfy. If none are named, nobody has adopted the
+ * convention here yet and there is nothing to conclude.
+ */
+function skippedScenarios(featureSource, testSources) {
+    const all = scenariosIn(featureSource);
+    if (all.length === 0)
+        return [];
+    const uncovered = uncoveredScenarios(featureSource, testSources);
+    // Nothing in this file is named: the convention is not in use here.
+    if (uncovered.length === all.length)
+        return [];
+    return uncovered;
+}
+//# sourceMappingURL=ScenarioCoverage.js.map

package/dist/packages/core/src/domain/ScenarioCoverage.js.map

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

package/dist/packages/core/src/domain/SpecSections.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Requirement prose in `spec.md` (Fase 3.1).
+ *
+ * ## The gap
+ *
+ * `req add` wrote a matrix row and nothing else. The title went into the *Use
+ * Case* column and `spec.md` never gained a section, so the requirement existed
+ * as a table entry with no text anywhere.
+ *
+ * That is one cause with two symptoms, and the second is the expensive one:
+ *
+ *     # Implement REQ-002
+ *     - Feature file: -
+ *     - Test artifact (write this first — TDD): -
+ *     - Production artifact: -
+ *     ## Gherkin scenario
+ *     (empty)
+ *
+ * The harness prompt asks an agent to implement a requirement whose text is
+ * nowhere in the prompt. A cold evaluator's words: *"the loop doesn't close on
+ * a brownfield adopt"*. It cannot, because there is nothing to read.
+ *
+ * ## Why a placeholder obligation and not just the title
+ *
+ * `--strict-requirements` wants an RFC-2119 keyword, and a section that says
+ * only what the user typed would fail the project's own gate the moment they
+ * turned that flag on. Writing `MUST` into the sentence makes the generated
+ * section pass the gate it will be measured by — and marks itself as a draft
+ * the author is expected to rewrite, rather than pretending to be finished
+ * prose.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderRequirementSection = renderRequirementSection;
+exports.hasRequirementSection = hasRequirementSection;
+exports.requirementSections = requirementSections;
+exports.appendRequirementSection = appendRequirementSection;
+exports.extractRequirementSection = extractRequirementSection;
+/** `## REQ-014 — title`, in the shape the validator and `plan` already read. */
+function renderRequirementSection(reqId, title) {
+    const heading = `## ${reqId} — ${title}`;
+    // `MUST satisfy:` rather than `MUST <title>`: a title can start with an
+    // identifier (`res.redirect sets …`) or an acronym, and gluing it onto a verb
+    // produces something ungrammatical often enough that it is not worth the
+    // heuristic that would try to guess.
+    const obligation = String(title || "").trim() || "the behaviour named above";
+    return (`${heading}\n\n` +
+        `The system MUST satisfy: ${obligation}.\n\n` +
+        `> Written by \`specgate req add\`. Replace this sentence with the real ` +
+        `obligation — what must hold, under which conditions, and how it is ` +
+        `observed.\n`);
+}
+/**
+ * A requirement heading, at any level from `##` to `####`.
+ *
+ * Requirements are commonly nested under a section — the shipped template puts
+ * them under "8. Key requirements" — so insisting on top-level `##` would fail
+ * documents that are perfectly well organised. The level is captured because
+ * the extractor needs to know where the section ends.
+ */
+const REQUIREMENT_HEADING = /^(#{2,4})\s+(.*)$/;
+/**
+ * The requirement ids a heading line declares.
+ *
+ * Four shapes turned up in real documents before this stopped enumerating them:
+ * `## REQ-014 — title`, `### REQ-014`, `### Requirement: REQ-100 — title`, and
+ * a table row. Matching "a heading that names the id" covers the first three
+ * without a fifth special case the next document would break anyway.
+ */
+function headingRequirementIds(line) {
+    const m = REQUIREMENT_HEADING.exec(line.trim());
+    if (!m)
+        return null;
+    const ids = m[2].match(/\bREQ-[A-Za-z0-9.]+\b/g) || [];
+    return ids.length > 0 ? { level: m[1].length, ids } : null;
+}
+/**
+ * A requirement row in the `| ID | Requirement | … |` table §8 of the shipped
+ * template uses.
+ *
+ * Two conventions are in the wild and both are legitimate: `adopt` writes
+ * `## REQ-NNN` sections, while the original `init` template — and this
+ * repository's own spec.md — put one row per requirement in a table. Outlawing
+ * the table would have turned every project built from that template red on
+ * upgrade, for text that is right there in the document.
+ *
+ * The prose has to be real: a row whose requirement cell is empty, `-` or `TBD`
+ * is an id with nothing behind it, which is the case worth catching.
+ */
+const REQUIREMENT_TABLE_ROW = /^\|\s*(REQ-[A-Za-z0-9.]+)\s*\|([^|]*)\|/;
+function tableRowText(specSource, reqId) {
+    const wanted = reqId.trim();
+    for (const line of String(specSource || "")
+        .replace(/\r\n/g, "\n")
+        .split("\n")) {
+        const m = REQUIREMENT_TABLE_ROW.exec(line.trim());
+        if (!m || m[1] !== wanted)
+            continue;
+        const text = m[2].trim();
+        if (text === "" || text === "-" || text.toUpperCase() === "TBD")
+            return null;
+        return text;
+    }
+    return null;
+}
+/** Does `spec.md` carry text for this requirement, in either convention? */
+function hasRequirementSection(specSource, reqId) {
+    if (!reqId)
+        return false;
+    const wanted = reqId.trim();
+    const hasHeading = String(specSource || "")
+        .replace(/\r\n/g, "\n")
+        .split("\n")
+        .some((line) => {
+        const heading = headingRequirementIds(line);
+        return heading ? heading.ids.includes(wanted) : false;
+    });
+    return hasHeading || tableRowText(specSource, reqId) !== null;
+}
+/**
+ * Every `REQ-NNN` that `spec.md` declares a section for.
+ *
+ * Used in the other direction by the gate: a matrix row whose requirement has
+ * no section is a row describing something the specification never says.
+ */
+function requirementSections(specSource) {
+    const found = [];
+    for (const line of String(specSource || "")
+        .replace(/\r\n/g, "\n")
+        .split("\n")) {
+        const heading = headingRequirementIds(line);
+        if (heading) {
+            for (const id of heading.ids)
+                if (!found.includes(id))
+                    found.push(id);
+            continue;
+        }
+        const row = REQUIREMENT_TABLE_ROW.exec(line.trim());
+        if (!row || found.includes(row[1]))
+            continue;
+        const text = row[2].trim();
+        if (text === "" || text === "-" || text.toUpperCase() === "TBD")
+            continue;
+        found.push(row[1]);
+    }
+    return found;
+}
+/**
+ * `spec.md` with a section for `reqId` appended, or unchanged if it has one.
+ *
+ * Appends rather than inserting in id order: `spec.md` is a document a person
+ * writes in, and reordering someone's prose to satisfy a sort is a worse
+ * surprise than a section at the end.
+ */
+function appendRequirementSection(specSource, reqId, title) {
+    if (hasRequirementSection(specSource, reqId)) {
+        return { content: specSource, added: false };
+    }
+    const body = String(specSource || "").replace(/\s+$/, "");
+    const separator = body === "" ? "" : "\n\n";
+    return {
+        content: `${body}${separator}${renderRequirementSection(reqId, title)}`,
+        added: true,
+    };
+}
+/**
+ * The body of `## REQ-NNN` in `spec.md`, heading included, or `null`.
+ *
+ * A section runs until the next heading of the same or higher level, so a
+ * `### ` subsection belongs to the requirement and a `## ` does not.
+ */
+function extractRequirementSection(specSource, reqId) {
+    if (!reqId)
+        return null;
+    const lines = String(specSource || "")
+        .replace(/\r\n/g, "\n")
+        .split("\n");
+    let start = -1;
+    let level = 2;
+    for (let i = 0; i < lines.length; i += 1) {
+        const heading = headingRequirementIds(lines[i]);
+        if (heading && heading.ids.includes(reqId.trim())) {
+            start = i;
+            level = heading.level;
+            break;
+        }
+    }
+    // No heading: the table row is the requirement's text, and the prompt needs
+    // it just as much.
+    if (start === -1) {
+        const text = tableRowText(specSource, reqId);
+        return text === null ? null : `## ${reqId.trim()}\n\n${text}`;
+    }
+    // The section ends at the next heading of the same level or higher, so a
+    // `####` sub-heading stays inside the requirement and the next `###` does not.
+    const boundary = new RegExp(`^#{1,${level}}\\s+\\S`);
+    let end = lines.length;
+    for (let i = start + 1; i < lines.length; i += 1) {
+        if (boundary.test(lines[i])) {
+            end = i;
+            break;
+        }
+    }
+    return lines.slice(start, end).join("\n").trim();
+}
+//# sourceMappingURL=SpecSections.js.map

package/dist/packages/core/src/domain/SpecSections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpecSections.js","sourceRoot":"","sources":["../../../../../packages/core/src/domain/SpecSections.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;AAGH,4DAcC;AAyDD,sDAWC;AAQD,kDAiBC;AASD,4DAcC;AAQD,8DAkCC;AA7KD,gFAAgF;AAChF,SAAgB,wBAAwB,CAAC,KAAa,EAAE,KAAa;IACnE,MAAM,OAAO,GAAG,MAAM,KAAK,MAAM,KAAK,EAAE,CAAC;IACzC,wEAAwE;IACxE,8EAA8E;IAC9E,yEAAyE;IACzE,qCAAqC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,2BAA2B,CAAC;IAC7E,OAAO,CACL,GAAG,OAAO,MAAM;QAChB,4BAA4B,UAAU,OAAO;QAC7C,yEAAyE;QACzE,qEAAqE;QACrE,aAAa,CACd,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEhD;;;;;;;GAOG;AACH,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,IAAI,EAAE,CAAC;IACvD,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,qBAAqB,GAAG,yCAAyC,CAAC;AAExE,SAAS,YAAY,CAAC,UAAkB,EAAE,KAAa;IACrD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;SACxC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM;YAAE,SAAS;QACpC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4EAA4E;AAC5E,SAAgB,qBAAqB,CAAC,UAAkB,EAAE,KAAa;IACrE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;SACxC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,KAAK,CAAC,IAAI,CAAC;SACX,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACxD,CAAC,CAAC,CAAC;IACL,OAAO,UAAU,IAAI,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,UAAkB;IACpD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;SACxC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,GAAG;gBAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtE,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAAE,SAAS;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK;YAAE,SAAS;QAC1E,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,wBAAwB,CACtC,UAAkB,EAClB,KAAa,EACb,KAAa;IAEb,IAAI,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO;QACL,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE;QACvE,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,UAAkB,EAAE,KAAa;IACzE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;SACnC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,KAAK,CAAC,IAAI,CAAC,CAAC;IAEf,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACf,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAClD,KAAK,GAAG,CAAC,CAAC;YACV,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YACtB,MAAM;QACR,CAAC;IACH,CAAC;IACD,4EAA4E;IAC5E,mBAAmB;IACnB,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC7C,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;IAChE,CAAC;IAED,yEAAyE;IACzE,+EAA+E;IAC/E,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;IACrD,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5B,GAAG,GAAG,CAAC,CAAC;YACR,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACnD,CAAC"}

package/dist/packages/core/src/domain/TestCommand.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * One answer to "how does this project run its tests" (Fase 2.3).
+ *
+ * There were two, and they disagreed on the same `pom.xml`: `onboard`/`adopt`
+ * said `./mvnw -B test`, `harness init` wrote `mvn -B test`. A cold evaluator
+ * found it by running both and noticing the mismatch, which is a bad way to
+ * learn that a tool has two opinions about your project.
+ *
+ * The wrapper wins, and not by coin toss. The harness runs each attempt in a
+ * bare git worktree; `./mvnw` and `./gradlew` are checked into the repository
+ * and work there, while `mvn` and `gradle` depend on what happens to be
+ * installed on the machine. Preferring the wrapper is the difference between a
+ * gate that runs and a gate that reports "command not found" as a failed
+ * attempt and burns one of the agent's three tries on it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectTestCommand = detectTestCommand;
+exports.hasGherkinRunner = hasGherkinRunner;
+function detectTestCommand(files, opts = {}) {
+    if (files.exists("package.json")) {
+        try {
+            const parsed = JSON.parse(files.read("package.json") || "{}");
+            const scripts = (parsed && parsed.scripts) || {};
+            if (opts.preferVerify && typeof scripts.verify === "string")
+                return "npm run verify";
+            // A declared script is the project's own answer and beats any guess.
+            if (typeof scripts.test === "string")
+                return "npm test";
+        }
+        catch {
+            // A malformed package.json is the user's problem, not a reason to fail
+            // scaffolding — but it is also not evidence of a test script.
+        }
+        return "npm test";
+    }
+    // Wrapper first, everywhere it exists: it is in the repository, so it works
+    // in a bare worktree where the system tool may not be installed.
+    if (files.exists("pom.xml")) {
+        return files.exists("mvnw") ? "./mvnw -B test" : "mvn -B test";
+    }
+    if (files.exists("build.gradle") || files.exists("build.gradle.kts")) {
+        return files.exists("gradlew") ? "./gradlew test" : "gradle test";
+    }
+    if (files.exists("Cargo.toml"))
+        return "cargo test";
+    if (files.exists("go.mod"))
+        return "go test ./...";
+    if (files.exists("pyproject.toml") || files.exists("setup.py"))
+        return "pytest";
+    return null;
+}
+/**
+ * Does anything in this project execute a `.feature` file?
+ *
+ * `doctor` reported "every scenario runnable" from a Gherkin *quality* check —
+ * When, Then, three steps — on a repository with no BDD runner anywhere, while
+ * the harness prompt in the same project said "nothing executes a `.feature`
+ * here". A cold evaluator listed the pair as a contradiction, and it is: one of
+ * them was describing the file and calling it the run.
+ *
+ * Shared so the two cannot drift apart again.
+ */
+function hasGherkinRunner(files) {
+    if (files.exists("features/step_definitions"))
+        return true;
+    for (const manifest of [
+        "package.json",
+        "pom.xml",
+        "build.gradle",
+        "build.gradle.kts",
+        "pyproject.toml",
+    ]) {
+        if (!files.exists(manifest))
+            continue;
+        const source = files.read(manifest) || "";
+        if (/cucumber|behave|pytest-bdd|godog|specflow|reqnroll/i.test(source))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=TestCommand.js.map

package/dist/packages/core/src/domain/TestCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestCommand.js","sourceRoot":"","sources":["../../../../../packages/core/src/domain/TestCommand.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAgCH,8CA4BC;AAaD,4CAcC;AAvDD,SAAgB,iBAAiB,CAAC,KAAmB,EAAE,OAAsB,EAAE;IAC7E,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACjD,IAAI,IAAI,CAAC,YAAY,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO,gBAAgB,CAAC;YACrF,qEAAqE;YACrE,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,UAAU,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,8DAA8D;QAChE,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,4EAA4E;IAC5E,iEAAiE;IACjE,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC;IACjE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC;IACpE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAC;IACpD,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,eAAe,CAAC;IACnD,IAAI,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAC;IAEhF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,gBAAgB,CAAC,KAAmB;IAClD,IAAI,KAAK,CAAC,MAAM,CAAC,2BAA2B,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,KAAK,MAAM,QAAQ,IAAI;QACrB,cAAc;QACd,SAAS;QACT,cAAc;QACd,kBAAkB;QAClB,gBAAgB;KACjB,EAAE,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,SAAS;QACtC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,qDAAqD,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;IACtF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}