spec-controller 0.1.0-alpha.45 → 0.1.0-alpha.46

package/dist/ingest/ciSourcePaths.js

@@ -1,49 +1,11 @@
-/**
- * Resolve a CI input to the workflow files it names (@SCN-USG-006, 3F-2497).
- *
- * A target's pipeline is routinely split across files — a nightly sweep, a security
- * scan — and reading one of them scores the rest against the target twice over: a
- * NAMED check enforced elsewhere is called a watermelon it is not, an UNNAMED one
- * never reaches the books at all (3F-2238).
- *
- * THIS IS THE ONLY PLACE THAT KNOWS A CI INPUT CAN BE A DIRECTORY. The core takes
- * anonymous source strings so a second ecosystem can supply its own; teaching it to
- * walk a folder would import a filesystem and one provider's layout into a pure
- * parser and close that seam for good. So the walk lives here, at the edge that
- * already resolved `.github/workflows/ci.yml`, and the edge knows exactly as much
- * about GitHub after this slice as it did before.
- *
- * Pure, with the filesystem injected — the resolution rules are the part worth
- * asserting directly, and a fixture tree can only show one of them going wrong at a
- * time.
- */
 import { existsSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
-/** The real filesystem, for the CLI edge. */
 export const NODE_CI_PATH_READER = {
     exists: existsSync,
     isDirectory: (path) => statSync(path).isDirectory(),
     readDir: readdirSync,
 };
-/** Both YAML spellings: a target picks one, and the tool does not get to mind which. */
 const WORKFLOW_EXTENSIONS = [".yml", ".yaml"];
-/**
- * The workflow files a CI input names: every workflow in a directory, or the single
- * file itself.
- *
- * Sorted, so two runs over one tree cannot differ and a diff of two reports never
- * turns on `readdir` ordering.
- *
- * A FILE RESOLVES TO ITSELF ALONE. Sweeping its parent directory would silently widen
- * a caller's deliberate scope, which is the promise @SCN-USG-008 pins at the report level.
- *
- * An absent path resolves to nothing — no sources, no commands, every static check
- * read as unenforced. That over-reports gaps and hides none, the same fail-safe
- * direction `ciRunCommands` takes on a document it cannot parse. The HARD error for a
- * path the caller SUPPLIED and that does not exist is @SCN-CLI-002's, raised upstream;
- * reaching here with nothing means the DEFAULT found no workflows, which is a fact
- * about the target rather than a mistake by its author.
- */
 export function ciSourcePathsOf(ciPath, reader = NODE_CI_PATH_READER) {
     if (!reader.exists(ciPath))
         return [];

package/dist/ingest/ciSourcePaths.js.map

@@ -1 +1 @@
-{"version":3,"file":"ciSourcePaths.js","sourceRoot":"","sources":["../../src/ingest/ciSourcePaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,MAAM,EAAE,UAAU;IAClB,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;IACnD,OAAO,EAAE,WAAW;CACrB,CAAC;AAEF,wFAAwF;AACxF,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,SAAuB,mBAAmB;IAE1C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,MAAM;SACV,OAAO,CAAC,MAAM,CAAC;SACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;SACvE,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"ciSourcePaths.js","sourceRoot":"","sources":["../../src/ingest/ciSourcePaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,MAAM,EAAE,UAAU;IAClB,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;IACnD,OAAO,EAAE,WAAW;CACrB,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,SAAuB,mBAAmB;IAE1C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,MAAM;SACV,OAAO,CAAC,MAAM,CAAC;SACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;SACvE,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/ingest/gherkinValidation.d.ts

@@ -1,89 +1,13 @@
-/**
- * The Gherkin VALIDATOR — the feature corpus's integrity checkpoint (@SCN-CLI-016, 3F-1767).
- *
- * WHY THIS EXISTS. The feature corpus is the ledger's DEBIT side, and it was read by a
- * hand-rolled TAG-LINE SCAN (`parseScenarios`) that never looked for a `Scenario:` header at
- * all: a scenario EXISTED purely because an `@SCN-FFF-NNN` tag line did. So a
- * malformed tag line simply STOPPED BEING A TAG LINE, and its scenario ceased to exist —
- * silently. One stray character, in a file cucumber itself rejects, deleted a failing row and
- * turned an out-of-balance run (exit 1) into a clean BALANCED (exit 0). A dropped scenario
- * cannot even reconcile `missing`, because it was never raised to be missing: the run reads
- * CLEANER THAN REALITY. That is the false-green this tool exists to prevent, aimed at itself.
- *
- * THE FIX (this slice). VALIDATE every feature file with the REAL Gherkin parser — the same one
- * cucumber uses. A file the parser rejects is an input the tool CANNOT READ, and the CLI refuses
- * it: exit 2, halting before reconciling (@SCN-CLI-014/015's Rule — "an input the tool cannot read
- * is a usage error, never a verdict" — extended from the OBSERVATION side to the OBLIGATION side).
- *
- * VALIDATION IS HALF THE STORY. This decides whether a feature file can be READ at all; the corpus
- * is then EXTRACTED from the same real AST by `parseScenarios` (@SCN-LDG-020, 3F-1775), so the
- * scenarios spec-controller reconciles carry exactly the tags cucumber gives them — Feature/Rule
- * tag inheritance included. One reading of the file, not two.
- *
- * PURE: `string → parse errors`. No fs, no process — the file READ lives beside it at the ingest
- * edge, as it does for every other input.
- *
- * WHY IT LIVES IN THE APP, NOT CORE. Core's barrel is the v1 contract surface downstream consumers
- * build on. Since 3F-3449 nothing reds when a symbol is added there — the guard that reconciled it
- * both directions is gone — so keeping it narrow is a discipline rather than a gate. This validator
- * is an INGEST concern (it decides whether an input can be read at all), not part of the
- * reconciliation contract, so it belongs with the other readers at the app edge and the v1 surface
- * stays untouched.
- */
-/** A Gherkin parse failure: the file could not be read as Gherkin at all. */
 export interface GherkinParseError {
-    /** The offending file, as supplied (the operator's locator — what to go and fix). */
     file: string;
-    /** The parser's own message, verbatim — WHAT broke, in the parser's words. */
     message: string;
 }
-/**
- * Validate one `.feature` source with the real Gherkin parser. Returns the parse errors it
- * reports — empty when the file is well-formed Gherkin.
- *
- * The parser is authoritative BY CONSTRUCTION: it is cucumber's own. A file it rejects is one
- * cucumber would refuse to RUN, so a scenario corpus built from it would be a FICTION — which is
- * precisely how a corrupt spec used to read balanced.
- *
- * A parse failure is reported, never thrown: the CLI edge routes it to stderr + exit 2 (the
- * shared typed-error surface), so it can never reach Node's default exit 1 and masquerade as an
- * out-of-balance verdict (@SCN-CLI-014's collision, on the obligation side).
- *
- * @SCN-CLI-016 (3F-1773).
- */
 export declare function parseErrorsIn(file: string, source: string): GherkinParseError[];
-/**
- * The corpus-level REFUSAL (@SCN-GPG-001, 3F-2817). A parse failure is reported per file by
- * `parseErrorsIn` above; this is how a reader of the WHOLE corpus says no.
- *
- * WHY IT CARRIES EVERY FILE. The balance CLI already names every unparseable file it found
- * (@SCN-CLI-016), and a refusal raised at the first bad one would silently narrow that message —
- * a behaviour change dressed as an implementation detail. So the discovery collects the corpus
- * and refuses ONCE, carrying the lot in discovery order.
- *
- * The rendered message is the parser's words, per file, verbatim: a reader must be told WHAT
- * broke by the parser rather than by our paraphrase of it.
- */
 export declare class UnreadableFeatureCorpusError extends Error {
     readonly errors: readonly GherkinParseError[];
     constructor(errors: readonly GherkinParseError[]);
 }
-/**
- * The corpus-level ABSENCE refusal (@SCN-CLI-017, 3F-3345) — sibling to the parse refusal above,
- * and deliberately the same shape: the reader refuses ONCE, and each command decides what the
- * refusal means for it.
- *
- * WHY A TYPED ERROR RATHER THAN AN EMPTY CORPUS. The obvious fix is for `discoverFeatures` to hand
- * back `[]` when the directory is not there, and that would decide for every reader that absence
- * is empty. Typed, each caller decides: `balance` reads it as no corpus (@SCN-CLI-017), and any
- * other reader still meets a refusal. (The second command this guarded, `tags`, left at 3F-3635.)
- *
- * IT CARRIES THE DIRECTORY because the report is owed the name of what it examined — "I found no
- * record" and "I found no regression" must never wear one word (3F-2947), and a consumer told
- * their corpus is empty deserves to know which directory was read to reach that.
- */
 export declare class MissingFeatureCorpusError extends Error {
-    /** The directory that is not there — as resolved, so a reader can print the path examined. */
     readonly directory: string;
     constructor(directory: string);
 }

package/dist/ingest/gherkinValidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gherkinValidation.d.ts","sourceRoot":"","sources":["../../src/ingest/gherkinValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAa/E;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;gBAElC,MAAM,EAAE,SAAS,iBAAiB,EAAE;CAUjD;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAK9B"}
+{"version":3,"file":"gherkinValidation.d.ts","sourceRoot":"","sources":["../../src/ingest/gherkinValidation.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAU/E;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;gBAElC,MAAM,EAAE,SAAS,iBAAiB,EAAE;CAUjD;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAK9B"}

package/dist/ingest/gherkinValidation.js

@@ -1,51 +1,5 @@
-/**
- * The Gherkin VALIDATOR — the feature corpus's integrity checkpoint (@SCN-CLI-016, 3F-1767).
- *
- * WHY THIS EXISTS. The feature corpus is the ledger's DEBIT side, and it was read by a
- * hand-rolled TAG-LINE SCAN (`parseScenarios`) that never looked for a `Scenario:` header at
- * all: a scenario EXISTED purely because an `@SCN-FFF-NNN` tag line did. So a
- * malformed tag line simply STOPPED BEING A TAG LINE, and its scenario ceased to exist —
- * silently. One stray character, in a file cucumber itself rejects, deleted a failing row and
- * turned an out-of-balance run (exit 1) into a clean BALANCED (exit 0). A dropped scenario
- * cannot even reconcile `missing`, because it was never raised to be missing: the run reads
- * CLEANER THAN REALITY. That is the false-green this tool exists to prevent, aimed at itself.
- *
- * THE FIX (this slice). VALIDATE every feature file with the REAL Gherkin parser — the same one
- * cucumber uses. A file the parser rejects is an input the tool CANNOT READ, and the CLI refuses
- * it: exit 2, halting before reconciling (@SCN-CLI-014/015's Rule — "an input the tool cannot read
- * is a usage error, never a verdict" — extended from the OBSERVATION side to the OBLIGATION side).
- *
- * VALIDATION IS HALF THE STORY. This decides whether a feature file can be READ at all; the corpus
- * is then EXTRACTED from the same real AST by `parseScenarios` (@SCN-LDG-020, 3F-1775), so the
- * scenarios spec-controller reconciles carry exactly the tags cucumber gives them — Feature/Rule
- * tag inheritance included. One reading of the file, not two.
- *
- * PURE: `string → parse errors`. No fs, no process — the file READ lives beside it at the ingest
- * edge, as it does for every other input.
- *
- * WHY IT LIVES IN THE APP, NOT CORE. Core's barrel is the v1 contract surface downstream consumers
- * build on. Since 3F-3449 nothing reds when a symbol is added there — the guard that reconciled it
- * both directions is gone — so keeping it narrow is a discipline rather than a gate. This validator
- * is an INGEST concern (it decides whether an input can be read at all), not part of the
- * reconciliation contract, so it belongs with the other readers at the app edge and the v1 surface
- * stays untouched.
- */
 import { AstBuilder, GherkinClassicTokenMatcher, Parser } from "@cucumber/gherkin";
 import { IdGenerator } from "@cucumber/messages";
-/**
- * Validate one `.feature` source with the real Gherkin parser. Returns the parse errors it
- * reports — empty when the file is well-formed Gherkin.
- *
- * The parser is authoritative BY CONSTRUCTION: it is cucumber's own. A file it rejects is one
- * cucumber would refuse to RUN, so a scenario corpus built from it would be a FICTION — which is
- * precisely how a corrupt spec used to read balanced.
- *
- * A parse failure is reported, never thrown: the CLI edge routes it to stderr + exit 2 (the
- * shared typed-error surface), so it can never reach Node's default exit 1 and masquerade as an
- * out-of-balance verdict (@SCN-CLI-014's collision, on the obligation side).
- *
- * @SCN-CLI-016 (3F-1773).
- */
 export function parseErrorsIn(file, source) {
     const parser = new Parser(new AstBuilder(IdGenerator.uuid()), new GherkinClassicTokenMatcher());
     try {
@@ -53,25 +7,10 @@ export function parseErrorsIn(file, source) {
         return [];
     }
     catch (err) {
-        // The parser raises a CompositeParserException carrying every error it found; its message
-        // is the operator's actionable payload (line, column, and what it expected). Reported
-        // verbatim — the tool must not paraphrase the parser and risk describing a fault wrongly.
         const message = err instanceof Error ? err.message : String(err);
         return [{ file, message }];
     }
 }
-/**
- * The corpus-level REFUSAL (@SCN-GPG-001, 3F-2817). A parse failure is reported per file by
- * `parseErrorsIn` above; this is how a reader of the WHOLE corpus says no.
- *
- * WHY IT CARRIES EVERY FILE. The balance CLI already names every unparseable file it found
- * (@SCN-CLI-016), and a refusal raised at the first bad one would silently narrow that message —
- * a behaviour change dressed as an implementation detail. So the discovery collects the corpus
- * and refuses ONCE, carrying the lot in discovery order.
- *
- * The rendered message is the parser's words, per file, verbatim: a reader must be told WHAT
- * broke by the parser rather than by our paraphrase of it.
- */
 export class UnreadableFeatureCorpusError extends Error {
     errors;
     constructor(errors) {
@@ -83,22 +22,7 @@ export class UnreadableFeatureCorpusError extends Error {
         this.errors = errors;
     }
 }
-/**
- * The corpus-level ABSENCE refusal (@SCN-CLI-017, 3F-3345) — sibling to the parse refusal above,
- * and deliberately the same shape: the reader refuses ONCE, and each command decides what the
- * refusal means for it.
- *
- * WHY A TYPED ERROR RATHER THAN AN EMPTY CORPUS. The obvious fix is for `discoverFeatures` to hand
- * back `[]` when the directory is not there, and that would decide for every reader that absence
- * is empty. Typed, each caller decides: `balance` reads it as no corpus (@SCN-CLI-017), and any
- * other reader still meets a refusal. (The second command this guarded, `tags`, left at 3F-3635.)
- *
- * IT CARRIES THE DIRECTORY because the report is owed the name of what it examined — "I found no
- * record" and "I found no regression" must never wear one word (3F-2947), and a consumer told
- * their corpus is empty deserves to know which directory was read to reach that.
- */
 export class MissingFeatureCorpusError extends Error {
-    /** The directory that is not there — as resolved, so a reader can print the path examined. */
     directory;
     constructor(directory) {
         super(`The feature corpus directory does not exist: ${directory}`);

package/dist/ingest/gherkinValidation.js.map

@@ -1 +1 @@
-{"version":3,"file":"gherkinValidation.js","sourceRoot":"","sources":["../../src/ingest/gherkinValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAUjD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,MAAc;IACxD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,0BAA0B,EAAE,CAAC,CAAC;IAEhG,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,0FAA0F;QAC1F,sFAAsF;QACtF,0FAA0F;QAC1F,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,MAAM,CAA+B;IAE9C,YAAY,MAAoC;QAC9C,KAAK,CACH;YACE,yEAAyE;YACzE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC;SAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,8FAA8F;IACrF,SAAS,CAAS;IAE3B,YAAY,SAAiB;QAC3B,KAAK,CAAC,gDAAgD,SAAS,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}
+{"version":3,"file":"gherkinValidation.js","sourceRoot":"","sources":["../../src/ingest/gherkinValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOjD,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,MAAc;IACxD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,0BAA0B,EAAE,CAAC,CAAC;IAEhG,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,MAAM,CAA+B;IAE9C,YAAY,MAAoC;QAC9C,KAAK,CACH;YACE,yEAAyE;YACzE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC;SAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,SAAS,CAAS;IAE3B,YAAY,SAAiB;QAC3B,KAAK,CAAC,gDAAgD,SAAS,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/dist/ingest/ingestQualityChecks.d.ts

@@ -1,105 +1,24 @@
-/**
- * Ingest the target's quality-check inputs — the IMPURE reads behind the balance
- * command (split out of the old cli.ts). Reads evidence
- * obligations from the repo's feature files, observed evidence from the Vitest +
- * Cucumber result JSON, and the static-check evidence from the CI config + package.json,
- * turning each into the engine's in-memory model. The orchestration (arg parsing, the
- * output plan/write, main) stays in cli-balance/cli.ts; these are the file reads it calls.
- *
- * Configurable input paths (no adapter registry in v1 — the readers are named, not
- * registered). Missing result files are tolerated: their evidence is simply absent
- * (the scenario reconciles as missing for that level). The static check kind reads
- * `--ci` (a workflow file or a directory of them, default `.github/workflows`) +
- * `package.json` to observe each fitness check the corpus cites.
- */
 import { type GherkinParseError } from "./gherkinValidation.js";
 import { type EvidenceObligations } from "@3f-consulting/spec-controller-core";
 import type { EvidenceReconciliation } from "@3f-consulting/spec-controller-core";
-/**
- * The reconciler's resolved input paths — the CLI options threaded to the readers.
- * Every path is optional; a missing result file is tolerated (its evidence is
- * simply absent). `packageJson` is the EXTERNALLY-SPECIFIED package.json the static
- * static-check reader reads `exists` from (the --package-json seam):
- * default the tool's own cwd `package.json`; set it to reconcile ANOTHER repo's
- * static checks — required to render the historical watermelon correctly.
- */
 export interface ReconcileOptions {
     features?: string;
     vitest?: string;
     cucumber?: string;
     ci?: string;
     packageJson?: string;
-    /**
-     * The CI RUN'S OWN RECORD of what each of its steps did — the credit
-     * side of every CONVERTED fitness check, written by the consumer's own pipeline and by neither
-     * party to this reconciliation.
-     *
-     * KEPT APART FROM `ci` BECAUSE THE TWO DOCUMENTS ANSWER DIFFERENT QUESTIONS. The workflow FILE
-     * says a check is wired into this pipeline and which row its step cites — a fact about a
-     * repository, true between runs. This is one RUN's record: did it run this time, and what did it
-     * find. Optional like the other result files: a consumer whose pipeline dumps no record, or a
-     * local run with no pipeline at all, hands none, and the converted rows it would have answered
-     * read `missing`.
-     */
     ciSteps?: string;
 }
-/** Where the CI workflows are read from when `--ci` is not given. */
 export declare const DEFAULT_CI_PATH = ".github/workflows";
-/** The target's manifest when `--package-json` is not given: the one in the directory the run is in. */
 export declare const DEFAULT_PACKAGE_JSON = "package.json";
-/**
- * The feature corpus's INTEGRITY CHECKPOINT — validate every discovered
- * `.feature` with the REAL Gherkin parser and report the files it cannot read.
- *
- * The feature corpus is the ledger's DEBIT side, and it used to be read by a tag-line scan that
- * never consulted a parser — so a malformed tag line silently deleted its scenario, and a corrupt
- * spec could read BALANCED. A file the parser rejects is one cucumber would refuse to run: the
- * CLI halts on it (exit 2) rather than reconciling a corpus that is a fiction.
- *
- * THIS IS NOW THE CATCH SITE, NOT THE CALL SITE. The validation moved
- * into `discoverFeatures`, which REFUSES an unreadable corpus rather than returning one, so every
- * corpus reader inherits the refusal instead of each restating it. What is left here is the
- * translation back into the list this CLI edge already prints — same files, same order, same
- * verbatim parser messages, so `balance`'s behaviour is unchanged. Anything that is not a corpus
- * refusal is not ours to interpret and rethrows.
- */
 export declare function featureCorpusParseErrors(featuresDir: string | undefined): GherkinParseError[];
-/** A read of the feature corpus or the CI workflows that the operating system refused. */
 export interface InputReadFault {
     readonly path: string;
     readonly reason: string;
 }
-/**
- * The read of the feature corpus that failed, taken by the same discovery the reconcile uses, or
- * null when it reads. A file the Gherkin parser rejects is not this fault: it is reported by
- * `featureCorpusParseErrors`, after this.
- */
 export declare function corpusReadFault(featuresDir: string | undefined): InputReadFault | null;
-/** The read of a CI workflow that failed, over the same files the reconcile reads, or null when they all read. */
 export declare function ciReadFault(ciPath: string | undefined): InputReadFault | null;
-/**
- * Read the target's `feature-code → slug` map over the same `discoverFeatures` corpus
- * — each coded feature file's `@<FFF>` header (`featureCode`)
- * mapped to its filename `slug`, the full feature name. This is the mapping
- * `scenariosFromFeatures` discards (it keeps only the parsed scenarios). A sibling read to
- * the balance, threaded to `renderMarkdown` (via `writeOutputs`) as the 5th sibling arg
- * (markdown-only — the by-feature cut is markdown-only, so it is NOT serialised to JSON).
- * Uncoded files (`featureCode === null`) are omitted, so the by-feature emitter falls
- * back to the bare `FFF` for any id whose code no file registers. When two files carry one
- * code the map keeps the last, and that run lists `duplicate-feature-code` under Scenario code
- * errors and fails, so a report whose map is ambiguous never passes.
- */
 export declare function readFeatureNames(featuresDir?: string): Map<string, string>;
-/**
- * Read the scenario-corpus census over the discovered feature files (the same
- * `discoverFeatures` corpus `scenariosFromFeatures` reads): sum the raw @SCN
- * occurrences (`countScnOccurrences`) and the scenario count
- * (`parseScenarios(...).length`) across every file, and build the `EvidenceObligations`
- * sibling. Also collects the UNTAGGED scenarios
- * — `parseUntaggedScenarios` per file, each paired with its feature-file
- * locator, sorted by (feature, scenario). Read alongside the balance in `main()` and
- * threaded to the renderers via `writeOutputs`; `runReconcile` stays unchanged.
- */
 export declare function readEvidenceObligations(features?: string): EvidenceObligations;
 export declare function runReconcile(opts: ReconcileOptions): EvidenceReconciliation;
 //# sourceMappingURL=ingestQualityChecks.d.ts.map

package/dist/ingest/ingestQualityChecks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ingestQualityChecks.d.ts","sourceRoot":"","sources":["../../src/ingest/ingestQualityChecks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,qCAAqC,CAAC;AAkB7C,OAAO,KAAK,EAIV,sBAAsB,EACvB,MAAM,qCAAqC,CAAC;AA4B7C;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qEAAqE;AACrE,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD,wGAAwG;AACxG,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AA8EnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,EAAE,CAQ7F;AAED,0FAA0F;AAC1F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAaD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAUtF;AAED,kHAAkH;AAClH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAU7E;AAaD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAM1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAuB9E;AAyCD,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,sBAAsB,CAoE3E"}
+{"version":3,"file":"ingestQualityChecks.d.ts","sourceRoot":"","sources":["../../src/ingest/ingestQualityChecks.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,qCAAqC,CAAC;AAY7C,OAAO,KAAK,EAIV,sBAAsB,EACvB,MAAM,qCAAqC,CAAC;AAO7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAkCnD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,EAAE,CAQ7F;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAQD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAUtF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAU7E;AAYD,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAM1E;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAqB9E;AAmBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,sBAAsB,CA2B3E"}