spec-controller 0.1.0-alpha.5 → 0.1.0-alpha.51

package/dist/ingest/ingestQualityChecks.d.ts

@@ -1,109 +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, @SCN-LNT-005):
- * 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 (@SCN-LNT-021, @SCN-LNT-028) — 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;
 }
-/**
- * The feature corpus's INTEGRITY CHECKPOINT (@SCN-CLI-016, 3F-1767) — 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 (@SCN-GPG-001, 3F-2817). 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 const DEFAULT_CI_PATH = ".github/workflows";
+export declare const DEFAULT_PACKAGE_JSON = "package.json";
 export declare function featureCorpusParseErrors(featuresDir: string | undefined): GherkinParseError[];
-/**
- * The `@SCN` ids the feature corpus CARRIES MORE THAN ONCE (@SCN-LDG-020's guardrail, 3F-1775).
- *
- * An `@SCN` identifies exactly ONE scenario — that is the whole basis of attributing evidence to
- * it. If two scenarios carry the same id, a test citing it could be proving EITHER, and the tool
- * cannot know which: the corpus is ambiguous, and any verdict over it is a guess.
- *
- * WHY THIS EXISTS. Tag inheritance made this reachable: an `@SCN` hoisted to a `Feature:`/`Rule:`
- * is inherited by every scenario beneath it (cucumber does this, so we do — parity). Left
- * unhandled, ONE passing test then marked EVERY scenario sharing that id `balanced`, including
- * scenarios nothing proves — a BALANCED-WHEN-BROKEN run, exit 0. A new silent false-green,
- * introduced by the very fix that closed the last one.
- *
- * Refused at the edge (exit 2) rather than reconciled, under the Rule already shipped for the
- * observed side and the corrupt corpus (@SCN-CLI-014/015/016): an input the tool cannot read is a
- * usage error, never a verdict. Whether hoisting an `@SCN` is an authoring fault worth a richer
- * diagnostic is the deferred policy question (3F-1774's sibling); refusing to reconcile a corpus we
- * cannot read is not a policy — it is the floor.
- */
-export declare function featureCorpusDuplicateScnIds(featuresDir: string | undefined): string[];
-/**
- * Read the target's `feature-code → slug` map over the same `discoverFeatures` corpus
- * (@SCN-RPT-006) — 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. One-prefix-one-file holds
- * by invariant (`corpusFaults` raises `duplicate-feature-code`, @SCN-STG-010), so the map is
- * unambiguous. That invariant was `lintFeatureCodes`' until 3F-3313; it is the shipped command's
- * now, which is the first time a CONSUMER of this reader has it too.
- */
+export interface InputReadFault {
+    readonly path: string;
+    readonly reason: string;
+}
+export declare function corpusReadFault(featuresDir: string | undefined): InputReadFault | null;
+export declare function ciReadFault(ciPath: string | undefined): InputReadFault | null;
 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 (@SCN-RPT-008). Also collects the UNTAGGED scenarios
- * (@SCN-RPT-014) — `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;AAYH,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;AA6B7C;;;;;;;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;AA8ED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,EAAE,CAQ7F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAStF;AAED;;;;;;;;;;;;GAYG;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,CAqB9E;AA0CD,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,sBAAsB,CA2D3E"}
+{"version":3,"file":"ingestQualityChecks.d.ts","sourceRoot":"","sources":["../../src/ingest/ingestQualityChecks.ts"],"names":[],"mappings":"AAUA,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,CAmB9E;AAmBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,sBAAsB,CA2B3E"}

package/dist/ingest/ingestQualityChecks.js

@@ -1,91 +1,25 @@
-/**
- * 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 { readFileSync, existsSync } from "node:fs";
 import { basename } from "node:path";
 import { ciSourcePathsOf } from "./ciSourcePaths.js";
 import { discoverFeatures } from "./ingestScenarios.js";
-import { parseScenarios, countScnOccurrences, parseUntaggedScenarios, proseOnlyCodes, } from "@3f-consulting/spec-controller-core";
+import { parseScenarios, countScnOccurrences, parseUntaggedScenarios, sharedScnCodesOf, } from "@3f-consulting/spec-controller-core";
 import { MissingFeatureCorpusError, UnreadableFeatureCorpusError, } from "./gherkinValidation.js";
 import { DEFAULT_DEFERRAL_TAGS } from "../deferralTags.js";
 import { evidenceObligations, } from "@3f-consulting/spec-controller-core";
 import { parseVitestEvidenceObservations, } from "@3f-consulting/spec-controller-core";
 import { parseCucumberEvidenceObservations, } from "@3f-consulting/spec-controller-core";
-// THE WHOLE COMPOSITION, THROUGH THE PUBLIC BARREL AND NOTHING ELSE (3F-3086). This module travels
-// in the tarball, and until 3F-3089 it reached nine core symbols through the UNPUBLISHED
-// `./internal` subpath to assemble the reconciliation itself — which is why an installed
-// `spec-controller balance --help` threw ERR_PACKAGE_PATH_NOT_EXPORTED while every gate in this
-// workspace stayed green. The nine are still internal (3F-2837 stands, unamended); what moved is
-// their CALLER. What is left here is the reads: this edge opens the files and hands the bytes over.
 import { evidenceReconciliationFromSources } from "@3f-consulting/spec-controller-core";
 import { resolveTargetRoot } from "../run-management/resolveRunInputs.js";
-/**
- * The per-input FALLBACK quality-check for each JS-ecosystem result source — the
- * source→quality-check mapping, SET at the CLI edge rather than hardcoded in the core
- * parsers / countRuntimeEvidenceObservationKinds. A second ecosystem (pytest / JUnit) sets its own here (or
- * via an adapter); the core never assumes a mapping. No CLI override flag yet — that
- * earns its place at the second ecosystem, not now.
- */
 const VITEST_QUALITY_CHECK = "unit";
 const CUCUMBER_QUALITY_CHECK = "integration";
-/**
- * THIS TOOL, RUN TO RECONCILE (@SCN-USG-014, 3F-3343) — the invocation whose step is the
- * reconciler rather than one of the reconciled rows, SET at the CLI edge and injected into the
- * core like the prefixes above and the workflow names below.
- *
- * HOW THIS PRODUCT IS INVOKED IS THIS LAYER'S FACT. `spec-controller` is the `bin` this package
- * publishes and `balance` is the command that reconciles; the engine holds neither, and a core
- * that assumed them would be asserting something about a command line it never sees.
- *
- * BOTH TOKENS, AND THE SECOND IS NOT DECORATION. This repository's own pipeline runs
- * `pnpm spec-controller tags` beside its balance step — the same binary, doing something that is
- * an ordinary step of the pipeline being reconciled — so an invocation naming the binary alone
- * would take that step off the books. The comparison is whole, adjacent shell tokens
- * (`parse/commandRuns`), so this names the reconciliation and nothing else the tool can do.
- */
 const RECONCILER_INVOCATION = "spec-controller balance";
-/** Read + JSON-parse a file if present, else return undefined. */
+export const DEFAULT_CI_PATH = ".github/workflows";
+export const DEFAULT_PACKAGE_JSON = "package.json";
 function readJsonIfPresent(path) {
     if (!path || !existsSync(path))
         return undefined;
     return JSON.parse(readFileSync(path, "utf8"));
 }
-/**
- * THE CORPUS `balance` READS — the shared discovery, with an ABSENT directory read as NO CORPUS
- * (@SCN-CLI-017, 3F-3345). The single place this command opts in.
- *
- * `new-client` is a supported adoption state, not a degraded one, and most targets have no
- * `features/` directory at all — so an absent DEFAULT corpus is the target's honest shape and
- * `balance` reports on it. Left to escape it was a raw `ENOENT` landing on Node's default exit 1,
- * the OUT-OF-BALANCE code, which is exactly the collision @SCN-CLI-014/015/016 closed on every
- * other input, alive on the one path each new consumer is guaranteed to take.
- *
- * ONE HELPER, NOT FIVE CATCHES, and that is the whole reason it exists: five readers each doing
- * this by hand is five chances for one to stay intolerant, and a run that reports on a corpus for
- * four of its readings and throws on the fifth is worse than one that throws. The translation is
- * also why `discoverFeatures` is not the place to be tolerant — see its own note, and
- * `MissingFeatureCorpusError`'s: `tags` reaches the same reader and keeps refusing.
- *
- * IT IS `[]`, NOT A VERDICT. Zero rows is what @SCN-CLI-019 reads as NOTHING TO RECONCILE, and a
- * corpus-less target that still has uncited credits keeps its suspense row and its exit 1
- * (@SCN-CLI-020) — this reader says what it found, never what the run means.
- *
- * A supplied-but-absent `--features` never arrives here: `checkInputsExist` refuses it at the CLI
- * edge, exit 2 (@SCN-CLI-002). The precedent is `ciSourcePathsOf`, which already answers an absent
- * DEFAULT `.github/workflows` with `[]` for the same reason — the default finding nothing is a fact
- * about the target, not a mistake by its author.
- */
 function balanceCorpus(featuresDir) {
     try {
         return featuresDir !== undefined ? discoverFeatures(featuresDir) : discoverFeatures();
@@ -96,49 +30,15 @@ function balanceCorpus(featuresDir) {
         throw err;
     }
 }
-/**
- * The discovered feature corpus's SOURCES — read once so the two readings a citing run needs (the
- * obligations, and the corpus hop's `check tag → @SCN`) are taken from the same bytes. Two
- * discoveries could disagree about the corpus, and a citation resolved against a corpus the ledger
- * was not built from is exactly the phantom-row fault (@SCN-LNT-009).
- */
 function featureSources(featuresDir) {
     return balanceCorpus(featuresDir).map((f) => readFileSync(f.path, "utf8"));
 }
 function scenariosFromFeatures(featuresDir, deferralTags = DEFAULT_DEFERRAL_TAGS) {
     return featureSources(featuresDir).flatMap((source) => parseScenarios(source, deferralTags));
 }
-/**
- * The feature corpus's UNTAGGED half (@SCN-LDG-021, 3F-1774) — the scenarios `parseScenarios`
- * discards because they carry no `@SCN`. They are REAL scenarios: cucumber runs them, so each
- * owns a real Evidence Obligation — but the obligation has no code for an Evidence Observation to
- * link to, so it can never be discharged. `reconcile` gives each its own out-of-balance row
- * (`no-scn-code`); before this read they were invisible to the ledger, and a run whose only fault
- * was an untagged scenario printed "N scenario(s) carry no @SCN tag" and exited 0 BALANCED.
- *
- * Each is handled by its `<feature> : <scenario>` locator — the SAME locator the untagged warning
- * prints — because a bare scenario name is not unique across the corpus, and the row must say
- * where to go.
- */
 function untaggedScenariosFromFeatures(featuresDir) {
     return balanceCorpus(featuresDir).flatMap((f) => parseUntaggedScenarios(readFileSync(f.path, "utf8")).map((scenario) => `${f.slug}.feature : ${scenario}`));
 }
-/**
- * The feature corpus's INTEGRITY CHECKPOINT (@SCN-CLI-016, 3F-1767) — 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 (@SCN-GPG-001, 3F-2817). 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 function featureCorpusParseErrors(featuresDir) {
     try {
         balanceCorpus(featuresDir);
@@ -150,48 +50,50 @@ export function featureCorpusParseErrors(featuresDir) {
         throw err;
     }
 }
-/**
- * The `@SCN` ids the feature corpus CARRIES MORE THAN ONCE (@SCN-LDG-020's guardrail, 3F-1775).
- *
- * An `@SCN` identifies exactly ONE scenario — that is the whole basis of attributing evidence to
- * it. If two scenarios carry the same id, a test citing it could be proving EITHER, and the tool
- * cannot know which: the corpus is ambiguous, and any verdict over it is a guess.
- *
- * WHY THIS EXISTS. Tag inheritance made this reachable: an `@SCN` hoisted to a `Feature:`/`Rule:`
- * is inherited by every scenario beneath it (cucumber does this, so we do — parity). Left
- * unhandled, ONE passing test then marked EVERY scenario sharing that id `balanced`, including
- * scenarios nothing proves — a BALANCED-WHEN-BROKEN run, exit 0. A new silent false-green,
- * introduced by the very fix that closed the last one.
- *
- * Refused at the edge (exit 2) rather than reconciled, under the Rule already shipped for the
- * observed side and the corrupt corpus (@SCN-CLI-014/015/016): an input the tool cannot read is a
- * usage error, never a verdict. Whether hoisting an `@SCN` is an authoring fault worth a richer
- * diagnostic is the deferred policy question (3F-1774's sibling); refusing to reconcile a corpus we
- * cannot read is not a policy — it is the floor.
- */
-export function featureCorpusDuplicateScnIds(featuresDir) {
-    const seen = new Set();
-    const duplicates = new Set();
-    for (const scenario of scenariosFromFeatures(featuresDir)) {
-        if (seen.has(scenario.scnId))
-            duplicates.add(scenario.scnId);
-        seen.add(scenario.scnId);
+function readFaultOf(err, path) {
+    const errno = err;
+    if (!(err instanceof Error) || typeof errno.code !== "string")
+        return null;
+    return { path: errno.path ?? path, reason: err.message };
+}
+export function corpusReadFault(featuresDir) {
+    try {
+        balanceCorpus(featuresDir);
+        return null;
+    }
+    catch (err) {
+        if (err instanceof UnreadableFeatureCorpusError)
+            return null;
+        const fault = readFaultOf(err, featuresDir ?? "features");
+        if (fault === null)
+            throw err;
+        return fault;
+    }
+}
+export function ciReadFault(ciPath) {
+    const path = ciPath ?? DEFAULT_CI_PATH;
+    try {
+        for (const source of ciSourcePathsOf(path))
+            readCiSource(source);
+        return null;
+    }
+    catch (err) {
+        const fault = readFaultOf(err, path);
+        if (fault === null)
+            throw err;
+        return fault;
+    }
+}
+function readCiSource(source) {
+    try {
+        readFileSync(source, "utf8");
+    }
+    catch (err) {
+        const errno = err;
+        errno.path ??= source;
+        throw err;
     }
-    return [...duplicates].sort();
 }
-/**
- * Read the target's `feature-code → slug` map over the same `discoverFeatures` corpus
- * (@SCN-RPT-006) — 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. One-prefix-one-file holds
- * by invariant (`corpusFaults` raises `duplicate-feature-code`, @SCN-STG-010), so the map is
- * unambiguous. That invariant was `lintFeatureCodes`' until 3F-3313; it is the shipped command's
- * now, which is the first time a CONSUMER of this reader has it too.
- */
 export function readFeatureNames(featuresDir) {
     const map = new Map();
     for (const f of balanceCorpus(featuresDir)) {
@@ -200,25 +102,15 @@ export function readFeatureNames(featuresDir) {
     }
     return map;
 }
-/**
- * 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 (@SCN-RPT-008). Also collects the UNTAGGED scenarios
- * (@SCN-RPT-014) — `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 function readEvidenceObligations(features) {
     const featureFiles = balanceCorpus(features);
     let raw = 0;
     let scenarioCount = 0;
     const untagged = [];
-    const sources = [];
+    const files = [];
     for (const f of featureFiles) {
         const source = readFileSync(f.path, "utf8");
-        sources.push(source);
+        files.push({ feature: `${f.slug}.feature`, source });
         raw += countScnOccurrences(source);
         scenarioCount += parseScenarios(source).length;
         for (const scenario of parseUntaggedScenarios(source)) {
@@ -226,18 +118,8 @@ export function readEvidenceObligations(features) {
         }
     }
     untagged.sort((a, b) => a.feature.localeCompare(b.feature) || a.scenario.localeCompare(b.scenario));
-    // The prose-only codes are a CROSS-CORPUS difference (a code tagged in any file isn't
-    // dangling), so it reads all sources at once — not per-file like the others.
-    return evidenceObligations(raw, scenarioCount, untagged, proseOnlyCodes(sources));
+    return evidenceObligations(raw, scenarioCount, untagged, sharedScnCodesOf(files));
 }
-/**
- * Parse the target's RUNTIME observations ONCE — the tag-derived, per-tier observation set
- * (@SCN-RPT-017 / 3F-1452 FULL UNIFY) fed to BOTH the reconciler and the runtime census, so the
- * two can never disagree. Each source's FALLBACK quality-check is set at the CLI edge
- * (vitest⇒unit, cucumber⇒integration); the parsers DERIVE the level from the cited scenario's tier
- * tag (@SCN-LDG-011 / 3F-1434), using the fallback only for an untagged scenario. A missing report
- * contributes nothing. Root-relative so a phantom-scenario row's where-to-fix stays portable.
- */
 function parseRuntimeObservations(opts, root) {
     const out = [];
     const vitestReport = readJsonIfPresent(opts.vitest);
@@ -249,66 +131,27 @@ function parseRuntimeObservations(opts, root) {
     return out;
 }
 export function runReconcile(opts) {
-    // Read the target's package.json ONCE — its `specController.*` config supplies the deferral-tag
-    // extension (@SCN-PND-021) and the configured fitness rows, and its `scripts` back the `exists`
-    // read. The disk read stays at this impure edge; the engine takes the resolved values as
-    // injected params, staying pure.
-    const pkgPath = opts.packageJson ?? "package.json";
+    const pkgPath = opts.packageJson ?? DEFAULT_PACKAGE_JSON;
     const packageJson = readJsonIfPresent(pkgPath) ?? {};
-    // The TARGET repo root — the credit locators are made relative to it, so a phantom-scenario row's
-    // where-to-fix (ruling Q5) stays portable in a banked artefact. Resolved ONCE here and threaded,
-    // which is also what keeps `execFileSync` and `process.cwd()` out of the engine.
     const root = resolveTargetRoot({ features: opts.features });
-    // `--ci` names a workflow FILE or a DIRECTORY of them, and defaults to the directory
-    // (@SCN-USG-006, 3F-2238): a pipeline split across files enforces its checks just as one
-    // file does, and reading only ci.yml both invents watermelons for named checks enforced
-    // elsewhere and drops uncited ones off the books entirely. Path semantics carry the
-    // file-vs-directory distinction, so one flag stays one flag and an explicit file is still
-    // a narrowing (@SCN-USG-008).
-    const ciPath = opts.ci ?? ".github/workflows";
-    // RESOLVED ONCE, READ TWICE (@SCN-USG-015). The engine takes anonymous source strings and holds
-    // no filesystem, so the mapping from a step's source index back to the workflow file it came
-    // from is made HERE, where the paths are already in hand — `ciSourcePaths.ts` is explicit that
-    // keeping the core that way is the point. Resolving the list twice would be two chances for the
-    // bytes and the names to fall out of the order they are paired by.
+    const ciPath = opts.ci ?? DEFAULT_CI_PATH;
     const ciPaths = ciSourcePathsOf(ciPath);
+    const corpusFiles = balanceCorpus(opts.features).map((f) => ({
+        slug: f.slug,
+        featureCode: f.featureCode,
+        source: readFileSync(f.path, "utf8"),
+    }));
     return evidenceReconciliationFromSources({
-        // The corpus's bytes, read ONCE at this impure edge (3F-3088). The engine composes the three
-        // readings a citing run needs from this one array, so they cannot be assembled from two
-        // discoveries that disagree about the corpus (@SCN-LNT-009).
-        featureSources: featureSources(opts.features),
-        // The untagged half by its `<feature> : <scenario>` locator — parsed here because the locator
-        // names the FILE, which the discovery knows and a source string does not.
+        featureSources: corpusFiles.map((f) => f.source),
+        featureFiles: corpusFiles.map(({ slug, featureCode }) => ({ slug, featureCode })),
         untaggedScenarios: untaggedScenariosFromFeatures(opts.features),
         packageJson,
         ciSources: ciPaths.map((path) => readFileSync(path, "utf8")),
-        // THE FILE, NOT THE PATH. A `notChecks` entry opens with the workflow's own name — `ci.yml`,
-        // `release.yml` — which is what a consumer reads at the head of their run log and the only
-        // half of the entry that does not come out of the workflow's own text. The directory it sits
-        // in is the caller's `--ci`, not the consumer's subject, so it is not part of what they write.
         ciSourceNames: ciPaths.map((path) => basename(path)),
-        // The CONVERTED checks' credit stream, read at this edge like every other report. Absent it is
-        // undefined rather than empty, and that distinction reaches the reader (@SCN-LNT-027): "no
-        // record" is a run nobody recorded, "a record holding nothing" is a run that recorded none of
-        // these steps, and those are opposite facts.
-        // STRUCTURALLY, NOT BY NAME: this module travels in the tarball and reaches core through the PUBLIC barrel alone (3F-3086), and
-        // `CiStepRecord` is not on it. The shape is the document's, which is the consumer's, so what is
-        // written here is what the file holds rather than a contract owed to anyone.
         ciStepRecord: readJsonIfPresent(opts.ciSteps),
         runtimeObservations: parseRuntimeObservations(opts, root),
-        // The two things the engine's resolvers cannot hold, and each for its own reason: the
-        // starter deferral set is the application layer's own policy, and how this tool is invoked to
-        // reconcile is a fact about this product's command line. THE PREFIX SET USED TO SIT HERE AND IS GONE (@SCN-USG-004, 3F-3343): the
-        // engine no longer decides a check's membership by its name, so there is no convention left
-        // for this edge to own.
         deferralTags: DEFAULT_DEFERRAL_TAGS,
         reconcilerInvocation: RECONCILER_INVOCATION,
     });
 }
-// The static-check kind-counts are no longer read as a parallel census (@SCN-USG-001 / 3F-2118):
-// the former `readStaticEvidenceObservationCounts` re-built the static check observations and
-// re-derived the running / uncited split from a second read of the CI config. That counting now
-// FOLDS onto the Ledger the reconciler already produced (`staticObservationTally`, an internal
-// domain fold the renderers apply), so it cannot drift from the verdict — it counts the SAME posted
-// static-check credits `runReconcile` banked. The census read is deleted, not relocated.
 //# sourceMappingURL=ingestQualityChecks.js.map

package/dist/ingest/ingestQualityChecks.js.map

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

package/dist/ingest/ingestScenarios.d.ts

@@ -1,53 +1,8 @@
-/**
- * Ingest the target's feature files — the IMPURE reader that walks features/ on disk
- * and parses each file's feature code + scenario codes into DiscoveredFeature
- * records (split out of the old spec/featureCodes.ts). The pure per-source
- * parsers (extractFeatureCode / parseScenarioCodes) live here with their sole consumer;
- * the `scnId → feature-code` grammar helper is engine-side (packages/core/src/lib/
- * featureCode.ts); the duplicate-code lint is engine-side too since 3F-3313, as @SCN-STG-010 in
- * parse/corpusFaults.ts, and no longer a private check under tests/checks/.
- *
- * The foundation, folded into the @LDG runtime spine.
- */
-/** A feature file discovered on disk, with its `@<FFF>` header code (if any). */
 export interface DiscoveredFeature {
-    /** The feature-file basename without the .feature extension. */
     slug: string;
-    /** Absolute path to the feature file. */
     path: string;
     featureCode: string | null;
-    /** Every @SCN-<FFF>-<NNN> scenario code in the file, in order, duplicates kept. */
-    scenarioCodes: string[];
 }
-/**
- * Read the Feature-level @<FFF> header tag from a feature file's source — the
- * first tag immediately preceding the `Feature:` keyword that is not an @SCN id
- * or a recognised evidence/routing tag. Returns null if absent.
- */
 export declare function extractFeatureCode(source: string): string | null;
-/**
- * Parse every @SCN-<FFF>-<NNN> scenario code in a feature file's source, in
- * document order, duplicates preserved. Only genuine TAG LINES are scanned (a
- * line whose first non-blank character is `@` and whose every whitespace-
- * separated token is a tag) — prose that merely mentions a code is skipped.
- */
-export declare function parseScenarioCodes(source: string): string[];
-/**
- * Discover every feature file on disk and its header code — REFUSING a corpus the Gherkin
- * parser rejects (@SCN-GPG-001, 3F-2817).
- *
- * The refusal lives HERE, in the one reader every corpus consumer already goes through, so a
- * consumer INHERITS it rather than restating it. It is not a second parser: it is the existing
- * `parseErrorsIn` — cucumber's own — reached from the shared discovery instead of only from the
- * balance CLI's edge. One answer to "what is a feature file".
- *
- * WHY THE WHOLE CORPUS, NOT THE FIRST BAD FILE. `featureCorpusParseErrors` reports every
- * unreadable file and the balance CLI prints them all (@SCN-CLI-016). Refusing at the first
- * failure would silently narrow that message, so every file is parsed and the refusal is raised
- * once, carrying the lot in discovery order.
- *
- * And NO PARTIAL CORPUS is ever returned: a caller that could scan the readable half of a
- * rejected tree would be back to reporting a verdict over a corpus it cannot read.
- */
 export declare function discoverFeatures(dir?: string): DiscoveredFeature[];
 //# sourceMappingURL=ingestScenarios.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ingestScenarios.d.ts","sourceRoot":"","sources":["../../src/ingest/ingestScenarios.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mFAAmF;IACnF,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAc3D;AAwCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,EAAE,CAkBjF"}
+{"version":3,"file":"ingestScenarios.d.ts","sourceRoot":"","sources":["../../src/ingest/ingestScenarios.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKhE;AA0CD,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,EAAE,CAiBjF"}