spec-controller 0.1.0-alpha.36 → 0.1.0-alpha.38

package/dist/ingest/ingestQualityChecks.js

@@ -22,11 +22,11 @@ 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
+// THE WHOLE COMPOSITION, THROUGH THE PUBLIC BARREL AND NOTHING ELSE. This module travels
+// in the tarball, and it once 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
+// workspace stayed green. The nine are still internal; 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";
@@ -40,7 +40,7 @@ import { resolveTargetRoot } from "../run-management/resolveRunInputs.js";
 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
+ * THIS TOOL, RUN TO RECONCILE — 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.
  *
@@ -54,6 +54,10 @@ const CUCUMBER_QUALITY_CHECK = "integration";
  * (`parse/commandRuns`), so this names the reconciliation and nothing else the tool can do.
  */
 const RECONCILER_INVOCATION = "spec-controller balance";
+/** Where the CI workflows are read from when `--ci` is not given. */
+export 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 const DEFAULT_PACKAGE_JSON = "package.json";
 /** Read + JSON-parse a file if present, else return undefined. */
 function readJsonIfPresent(path) {
     if (!path || !existsSync(path))
@@ -61,13 +65,13 @@ function readJsonIfPresent(path) {
     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.
+ * THE CORPUS `balance` READS — the shared discovery, with an ABSENT directory read as NO CORPUS.
+ * 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
+ * the OUT-OF-BALANCE code, which is exactly the collision the unreadable-input guards 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
@@ -76,12 +80,12 @@ function readJsonIfPresent(path) {
  * also why `discoverFeatures` is not the place to be tolerant — see its own note, and
  * `MissingFeatureCorpusError`'s.
  *
- * IT IS `[]`, NOT A VERDICT. Zero rows is what @SCN-CLI-019 reads as NOTHING TO RECONCILE, and a
+ * IT IS `[]`, NOT A VERDICT. Zero rows is what the verdict 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.
+ * — 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
+ * edge, exit 2. 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.
  */
@@ -99,7 +103,7 @@ function balanceCorpus(featuresDir) {
  * 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).
+ * was not built from is exactly the phantom-row fault.
  */
 function featureSources(featuresDir) {
     return balanceCorpus(featuresDir).map((f) => readFileSync(f.path, "utf8"));
@@ -108,7 +112,7 @@ 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`
+ * The feature corpus's UNTAGGED half — 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
@@ -123,7 +127,7 @@ 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
+ * 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
@@ -131,7 +135,7 @@ function untaggedScenariosFromFeatures(featuresDir) {
  * 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
+ * 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
@@ -149,9 +153,65 @@ export function featureCorpusParseErrors(featuresDir) {
         throw err;
     }
 }
+/**
+ * A read the operating system refused, as a fault naming the path; null for anything else. Every
+ * refusal is the same fault to the run, whichever it is: a file where a directory is read or the
+ * reverse, a path it is not permitted to read, or any other reason the OS gives.
+ */
+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 };
+}
+/**
+ * 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 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;
+    }
+}
+/** The read of a CI workflow that failed, over the same files the reconcile reads, or null when they all read. */
+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;
+    }
+}
+/** One workflow file's read, whose failure carries the file's path, which reading a directory gives none of. */
+function readCiSource(source) {
+    try {
+        readFileSync(source, "utf8");
+    }
+    catch (err) {
+        const errno = err;
+        errno.path ??= source;
+        throw err;
+    }
+}
 /**
  * Read the target's `feature-code → slug` map over the same `discoverFeatures` corpus
- * (@SCN-RPT-006) — each coded feature file's `@<FFF>` header (`featureCode`)
+ * — 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
@@ -159,7 +219,7 @@ export function featureCorpusParseErrors(featuresDir) {
  * 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 (@SCN-STG-010, 3F-3635), so a report whose map is ambiguous never passes.
+ * errors and fails, so a report whose map is ambiguous never passes.
  */
 export function readFeatureNames(featuresDir) {
     const map = new Map();
@@ -174,8 +234,8 @@ export function readFeatureNames(featuresDir) {
  * `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
+ * 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.
  */
@@ -203,10 +263,10 @@ export function readEvidenceObligations(features) {
 }
 /**
  * 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
+ * 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
+ * tag, 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) {
@@ -221,39 +281,39 @@ function parseRuntimeObservations(opts, root) {
 }
 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`
+    // extension 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
+    // 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
+    // a narrowing.
+    const ciPath = opts.ci ?? DEFAULT_CI_PATH;
+    // RESOLVED ONCE, READ TWICE. 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 ciPaths = ciSourcePathsOf(ciPath);
     // The corpus, discovered and read ONCE: its bytes, and — paired by index — which file each came
-    // from and the header code it carries, for the scenario code errors (3F-3635).
+    // from and the header code it carries, for the scenario code errors.
     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
+        // The corpus's bytes, read ONCE at this impure edge. 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).
+        // discoveries that disagree about the corpus.
         featureSources: corpusFiles.map((f) => f.source),
         featureFiles: corpusFiles.map(({ slug, featureCode }) => ({ slug, featureCode })),
         // The untagged half by its `<feature> : <scenario>` locator — parsed here because the locator
@@ -267,24 +327,24 @@ export function runReconcile(opts) {
         // 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
+        // undefined rather than empty, and that distinction reaches the reader: "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
+        // STRUCTURALLY, NOT BY NAME: this module travels in the tarball and reaches core through the PUBLIC barrel alone, 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
+        // reconcile is a fact about this product's command line. THE PREFIX SET USED TO SIT HERE AND IS GONE: 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 static-check kind-counts are no longer read as a parallel census:
 // 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

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

@@ -3,10 +3,10 @@
  * and reads each file's header code into DiscoveredFeature records (split out of the old
  * spec/featureCodes.ts). The pure header parser (extractFeatureCode) lives here with its 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
+ * featureCode.ts); the duplicate-code lint is engine-side too, in
  * parse/scenarioCodeErrors.ts, and no longer a private check under tests/checks/.
  *
- * NO PER-FILE LIST OF SCENARIO CODES (3F-3636). One used to ride here, read by a copy of the
+ * NO PER-FILE LIST OF SCENARIO CODES. One used to ride here, read by a copy of the
  * @SCN grammar of its own, and nothing but its own test read it; a scenario's code is read by the
  * engine's scenario walk, which is the reading the ledger's accounts are minted from.
  *
@@ -28,7 +28,7 @@ export interface DiscoveredFeature {
 export declare function extractFeatureCode(source: string): string | null;
 /**
  * Discover every feature file on disk and its header code — REFUSING a corpus the Gherkin
- * parser rejects (@SCN-GPG-001, 3F-2817).
+ * parser rejects.
  *
  * 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
@@ -36,7 +36,7 @@ export declare function extractFeatureCode(source: string): string | null;
  * 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
+ * unreadable file and the balance CLI prints them all. 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.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"ingestScenarios.d.ts","sourceRoot":"","sources":["../../src/ingest/ingestScenarios.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;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;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKhE;AA8DD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,EAAE,CAiBjF"}
+{"version":3,"file":"ingestScenarios.d.ts","sourceRoot":"","sources":["../../src/ingest/ingestScenarios.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;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;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKhE;AA2ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,EAAE,CAiBjF"}

package/dist/ingest/ingestScenarios.js

@@ -3,10 +3,10 @@
  * and reads each file's header code into DiscoveredFeature records (split out of the old
  * spec/featureCodes.ts). The pure header parser (extractFeatureCode) lives here with its 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
+ * featureCode.ts); the duplicate-code lint is engine-side too, in
  * parse/scenarioCodeErrors.ts, and no longer a private check under tests/checks/.
  *
- * NO PER-FILE LIST OF SCENARIO CODES (3F-3636). One used to ride here, read by a copy of the
+ * NO PER-FILE LIST OF SCENARIO CODES. One used to ride here, read by a copy of the
  * @SCN grammar of its own, and nothing but its own test read it; a scenario's code is read by the
  * engine's scenario walk, which is the reading the ledger's accounts are minted from.
  *
@@ -62,8 +62,7 @@ function featuresDir() {
     return join(process.cwd(), "features");
 }
 /**
- * List the corpus directory, REFUSING an absent one by name rather than by `ENOENT` (@SCN-CLI-017,
- * 3F-3345).
+ * List the corpus directory, REFUSING an absent one by name rather than by `ENOENT`.
  *
  * Absence stays a REFUSAL AT THE READER — what changed is that it is typed, so a caller can decide.
  * `balance` opts in to reporting on a target that has no corpus (most targets have no `features/`
@@ -75,7 +74,7 @@ function featuresDir() {
  * a different fault and is not ours to reinterpret — it rethrows.
  *
  * A SUPPLIED `--features` never reaches here absent: `checkInputsExist` refuses it at the CLI edge
- * with exit 2 (@SCN-CLI-002). Supplied-but-absent is the operator mistyping; absent-by-default is
+ * with exit 2. Supplied-but-absent is the operator mistyping; absent-by-default is
  * the target's honest shape.
  */
 function corpusFileNames(dir) {
@@ -88,9 +87,23 @@ function corpusFileNames(dir) {
         throw err;
     }
 }
+/**
+ * A feature file's text. A read the operating system refuses keeps its error, and gains the file's
+ * path when it has none: reading a directory fails with no path at all.
+ */
+function readFeatureSource(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch (err) {
+        const errno = err;
+        errno.path ??= path;
+        throw err;
+    }
+}
 /**
  * Discover every feature file on disk and its header code — REFUSING a corpus the Gherkin
- * parser rejects (@SCN-GPG-001, 3F-2817).
+ * parser rejects.
  *
  * 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
@@ -98,7 +111,7 @@ function corpusFileNames(dir) {
  * 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
+ * unreadable file and the balance CLI prints them all. 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.
  *
@@ -111,7 +124,7 @@ export function discoverFeatures(dir = featuresDir()) {
         .sort()
         .map((name) => {
         const path = join(dir, name);
-        return { name, path, source: readFileSync(path, "utf8") };
+        return { name, path, source: readFeatureSource(path) };
     });
     const parseErrors = files.flatMap(({ path, source }) => parseErrorsIn(path, source));
     if (parseErrors.length > 0)

package/dist/ingest/ingestScenarios.js.map

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

package/dist/ingest/inputShapes.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The shape each JSON input `balance` reads must have before its reader is handed it: the fields
+ * that reader goes on to read, and nothing more. A report is its producer's document, so a field
+ * the reader never touches is never checked, and a well-formed empty report is still a report.
+ *
+ * A document that is not this shape is an input the tool cannot read. Read anyway, it either
+ * throws part-way or is read as nothing and reaches a verdict about evidence it discarded, and
+ * both of those end on the out-of-balance code.
+ */
+/** A leaf kind, a list of one shape, a record of named fields, or a map whose entries share one. */
+export type Shape = "string" | "number" | "boolean" | "anything" | {
+    readonly list: Shape;
+} | {
+    readonly fields: Readonly<Record<string, Shape>>;
+    readonly required?: readonly string[];
+} | {
+    readonly entries: Shape;
+    readonly keys?: RegExp;
+};
+/** What the Vitest JSON reporter writes, as far as the Vitest reader reads it. */
+export declare const VITEST_REPORT: Shape;
+/** What the Cucumber JSON formatter writes, as far as the Cucumber reader reads it. */
+export declare const CUCUMBER_REPORT: Shape;
+/**
+ * A CI run's step record, as far as the step-record reader reads it: an object of steps keyed by
+ * step id, of which it credits only those keyed by a scenario code, reading each one's `outcome`.
+ * The key grammar is the reader's own, so a step it never credits is never checked.
+ */
+export declare const CI_STEP_RECORD: Shape;
+/**
+ * A package.json, as far as the run reads it outside the `specController` block: an object whose
+ * `scripts` are a map of commands. The `specController` block is left to its own resolvers, which
+ * read a value they cannot use as absent rather than refuse the run over it.
+ */
+export declare const PACKAGE_MANIFEST: Shape;
+/**
+ * A reconciliation this tool saved, at its top: the sections every one carries, and the optional
+ * ones in their kind. Below the top the renderer is the reader, and a document it cannot render
+ * is refused where it renders.
+ */
+export declare const SAVED_RECONCILIATION: Shape;
+/**
+ * The first place `value` is not `shape`, said as the path to it and what was found there, or null
+ * when the whole value is that shape. `where` is the path so far; the top level has none.
+ */
+export declare function shapeFaultIn(value: unknown, shape: Shape, where?: string): string | null;
+//# sourceMappingURL=inputShapes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputShapes.d.ts","sourceRoot":"","sources":["../../src/ingest/inputShapes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oGAAoG;AACpG,MAAM,MAAM,KAAK,GACb,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,UAAU,GACV;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GACxB;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC3F;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAKxD,kFAAkF;AAClF,eAAO,MAAM,aAAa,EAAE,KAc3B,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,eAAe,EAAE,KAe7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,KAG5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAsD,CAAC;AAEtF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAWlC,CAAC;AAkBF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,SAAK,GAAG,MAAM,GAAG,IAAI,CASpF"}

package/dist/ingest/inputShapes.js

@@ -0,0 +1,143 @@
+/**
+ * The shape each JSON input `balance` reads must have before its reader is handed it: the fields
+ * that reader goes on to read, and nothing more. A report is its producer's document, so a field
+ * the reader never touches is never checked, and a well-formed empty report is still a report.
+ *
+ * A document that is not this shape is an input the tool cannot read. Read anyway, it either
+ * throws part-way or is read as nothing and reaches a verdict about evidence it discarded, and
+ * both of those end on the out-of-balance code.
+ */
+/** What the Vitest JSON reporter writes, as far as the Vitest reader reads it. */
+export const VITEST_REPORT = {
+    fields: {
+        testResults: {
+            list: {
+                fields: {
+                    name: "string",
+                    status: "string",
+                    message: "string",
+                    assertionResults: { list: { fields: { fullName: "string", title: "string", status: "string" } } },
+                },
+            },
+        },
+    },
+    required: ["testResults"],
+};
+/** What the Cucumber JSON formatter writes, as far as the Cucumber reader reads it. */
+export const CUCUMBER_REPORT = {
+    list: {
+        fields: {
+            uri: "string",
+            name: "string",
+            elements: {
+                list: {
+                    fields: {
+                        tags: { list: { fields: { name: "string" } } },
+                        steps: { list: { fields: { keyword: "string", name: "string", result: { fields: { status: "string" } } } } },
+                    },
+                },
+            },
+        },
+    },
+};
+/**
+ * A CI run's step record, as far as the step-record reader reads it: an object of steps keyed by
+ * step id, of which it credits only those keyed by a scenario code, reading each one's `outcome`.
+ * The key grammar is the reader's own, so a step it never credits is never checked.
+ */
+export const CI_STEP_RECORD = {
+    entries: { fields: { outcome: "string" } },
+    keys: /^SCN-[A-Z0-9]{2,5}-\d+$/,
+};
+/**
+ * A package.json, as far as the run reads it outside the `specController` block: an object whose
+ * `scripts` are a map of commands. The `specController` block is left to its own resolvers, which
+ * read a value they cannot use as absent rather than refuse the run over it.
+ */
+export const PACKAGE_MANIFEST = { fields: { scripts: { entries: "string" } } };
+/**
+ * A reconciliation this tool saved, at its top: the sections every one carries, and the optional
+ * ones in their kind. Below the top the renderer is the reader, and a document it cannot render
+ * is refused where it renders.
+ */
+export const SAVED_RECONCILIATION = {
+    fields: {
+        runProvenance: { fields: {} },
+        summary: { fields: {} },
+        ledger: { fields: { scenarioReconciliations: { list: "anything" } }, required: ["scenarioReconciliations"] },
+        scenarioCodeErrors: { list: "anything" },
+        scenarioCodePopulation: { fields: {} },
+        evidenceObligations: { fields: {} },
+        metadata: { fields: {} },
+    },
+    required: ["runProvenance", "summary", "ledger"],
+};
+function kindOf(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "a list";
+    if (typeof value === "object")
+        return "an object";
+    return `a ${typeof value}`;
+}
+function expectedKindOf(shape) {
+    if (typeof shape === "string")
+        return `a ${shape}`;
+    return "list" in shape ? "a list" : "an object";
+}
+function pathOf(where, key) {
+    return where === "" ? key : `${where}.${key}`;
+}
+/**
+ * The first place `value` is not `shape`, said as the path to it and what was found there, or null
+ * when the whole value is that shape. `where` is the path so far; the top level has none.
+ */
+export function shapeFaultIn(value, shape, where = "") {
+    if (shape === "anything")
+        return null;
+    const found = kindOf(value);
+    const expected = expectedKindOf(shape);
+    if (found !== expected)
+        return `${where === "" ? "the top level" : where} is ${found}, not ${expected}`;
+    if (typeof shape === "string")
+        return null;
+    if ("list" in shape)
+        return listFault(value, shape.list, where);
+    if ("entries" in shape)
+        return entriesFault(value, shape, where);
+    return fieldsFault(value, shape, where);
+}
+function listFault(items, item, where) {
+    for (const [index, value] of items.entries()) {
+        const fault = shapeFaultIn(value, item, `${where}[${index}]`);
+        if (fault !== null)
+            return fault;
+    }
+    return null;
+}
+function fieldsFault(record, shape, where) {
+    for (const [key, field] of Object.entries(shape.fields)) {
+        const path = pathOf(where, key);
+        if (record[key] === undefined) {
+            if (shape.required?.includes(key) === true)
+                return `${path} is missing`;
+            continue;
+        }
+        const fault = shapeFaultIn(record[key], field, path);
+        if (fault !== null)
+            return fault;
+    }
+    return null;
+}
+function entriesFault(record, shape, where) {
+    for (const [key, value] of Object.entries(record)) {
+        if (shape.keys !== undefined && !shape.keys.test(key))
+            continue;
+        const fault = shapeFaultIn(value, shape.entries, pathOf(where, key));
+        if (fault !== null)
+            return fault;
+    }
+    return null;
+}
+//# sourceMappingURL=inputShapes.js.map