spec-controller 0.1.0-alpha.1

package/dist/ingest/ingestQualityChecks.js

@@ -0,0 +1,331 @@
+/**
+ * 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 { join } 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 { 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 mutation-ratchet library, reached for the RECORD half of a bar that names a gate
+// (@SCN-MUT-012): its conventional record name, its reader, and the floor a gate's own figures
+// imply. Through the barrel, which is the surface a consumer holds.
+import { gateRecordFor, killFloorOf, MalformedRecordError, parseGateRecords, RECORD_FILE, } from "../mutation-ratchet/index.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";
+/**
+ * The static-check script-prefix convention set — which package.json script names the
+ * running-guard observer (`runningStaticChecks`) recognises as static checks, SET at the
+ * CLI edge rather than hardcoded in the core parser. `lint:*` is spec-runner's own convention;
+ * `guard:*` is AWTY's (four `guard:*` guards run in AWTY's CI). A third convention adds its
+ * prefix here; the core never assumes the set. No CLI override flag yet — that earns its place
+ * at a third ecosystem, not now (mirrors the VITEST_QUALITY_CHECK stance above).
+ * `qualityCheck: "lint"` (the static-check axis name) is unchanged — this is the script prefix,
+ * not the axis.
+ *
+ * A HEURISTIC FOR FINDING CHECKS, NEVER THE DEFINITION OF ONE (@SCN-USG-009, 3F-2495). Membership
+ * is a property of the CHECK — does it analyse source without executing it — so a target whose
+ * gate this set misses configures it by name via `specController.staticChecks` (the engine's
+ * `resolveStaticChecks`) rather than renaming its scripts to our convention, which is not a thing
+ * the tool can ask of a client.
+ */
+const GUARD_SCRIPT_PREFIXES = ["lint:", "guard:"];
+/**
+ * A refusal met with an absent bar rather than let out of this edge.
+ *
+ * NOTHING IS THROWN OUT OF HERE, and that is the stance rather than caution. A refusal that escapes
+ * costs the whole run its verdict over one bad character in a file nobody may even be reading — a
+ * fault that is loud nowhere, where an absent bar is loud on the ledger. It is `thresholdsOf`'s own
+ * stance for a malformed entry, applied to the half of a bar that now lives in a second file.
+ *
+ * TWO CLASSES AND NO MORE. The record library normalises every fault it can see — the YAML parser's
+ * own included — into `MalformedRecordError` precisely so a caller catches all of them by catching
+ * one; beside it sits the read that never got as far as a record. A bare catch would swallow a
+ * defect in this edge as well, and answer it with the same silent absence.
+ */
+function orNoBar(read) {
+    try {
+        return read();
+    }
+    catch (cause) {
+        if (cause instanceof MalformedRecordError || isReadRefusal(cause))
+            return null;
+        throw cause;
+    }
+}
+/** A filesystem refusal — the record was not there, or could not be opened. */
+function isReadRefusal(cause) {
+    return cause instanceof Error && typeof cause.code === "string";
+}
+/**
+ * A reader over ONE resolution pass's records.
+ *
+ * EACH RECORD IS OPENED ONCE, WHICH IS WHY THIS IS A CLOSURE AND NOT A FUNCTION PER REFERENCE. A
+ * manifest may name several gates of one record, and a reader opening it per entry would let two
+ * references answer for two different states of the same file — a rewrite landing mid-pass, a gate
+ * present for one and gone for the next. One read makes the pass's bars one reading of one record.
+ *
+ * THE REFUSAL IS REMEMBERED TOO. Cacheing only the successes would re-open an absent or unreadable
+ * record per reference, which is the same disagreement by the other door — and the likelier door,
+ * since a record being rewritten is unreadable for exactly the window that matters.
+ *
+ * THE SUBTRACTION IS THE RECORD'S, NOT THIS EDGE'S. `killFloorOf` spends the allowance; an edge
+ * computing `detected - slack` itself would be a second place holding a fact about the record.
+ */
+export function killFloorReaderFor(root
+// The reader's shape is SPELLED here rather than imported, and that is the boundary working
+// rather than a duplication. `KillFloorReader` and the reference it takes are core-internal —
+// the registry-home question (increment D) still governs them — and this module is published, so
+// naming them by their `./internal` types would put an unpublished specifier back in the tarball
+// for a type alone. Structural typing is what makes the closure the engine's parameter accepts.
+) {
+    const opened = new Map();
+    return (reference) => {
+        const recordFile = reference.recordFile ?? RECORD_FILE;
+        if (!opened.has(recordFile)) {
+            opened.set(recordFile, orNoBar(() => parseGateRecords(readFileSync(join(root, recordFile), "utf8"), recordFile)));
+        }
+        const records = opened.get(recordFile);
+        if (records == null)
+            return null;
+        return orNoBar(() => killFloorOf(gateRecordFor(reference.mutationGate, records, recordFile)));
+    };
+}
+/** Read + JSON-parse a file if present, else return undefined. */
+function readJsonIfPresent(path) {
+    if (!path || !existsSync(path))
+        return undefined;
+    return JSON.parse(readFileSync(path, "utf8"));
+}
+/**
+ * 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) {
+    const features = featuresDir !== undefined ? discoverFeatures(featuresDir) : discoverFeatures();
+    return features.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) {
+    const features = featuresDir !== undefined ? discoverFeatures(featuresDir) : discoverFeatures();
+    return features.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 {
+        if (featuresDir !== undefined)
+            discoverFeatures(featuresDir);
+        else
+            discoverFeatures();
+        return [];
+    }
+    catch (err) {
+        if (err instanceof UnreadableFeatureCorpusError)
+            return [...err.errors];
+        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);
+    }
+    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 (`lintFeatureCodes` flags a duplicate code), so the map is unambiguous.
+ */
+export function readFeatureNames(featuresDir) {
+    const features = featuresDir !== undefined ? discoverFeatures(featuresDir) : discoverFeatures();
+    const map = new Map();
+    for (const f of features) {
+        if (f.featureCode !== null)
+            map.set(f.featureCode, f.slug);
+    }
+    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 = features !== undefined ? discoverFeatures(features) : discoverFeatures();
+    let raw = 0;
+    let scenarioCount = 0;
+    const untagged = [];
+    const sources = [];
+    for (const f of featureFiles) {
+        const source = readFileSync(f.path, "utf8");
+        sources.push(source);
+        raw += countScnOccurrences(source);
+        scenarioCount += parseScenarios(source).length;
+        for (const scenario of parseUntaggedScenarios(source)) {
+            untagged.push({ feature: `${f.slug}.feature`, scenario });
+        }
+    }
+    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));
+}
+/**
+ * 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);
+    if (vitestReport)
+        out.push(...parseVitestEvidenceObservations(vitestReport, VITEST_QUALITY_CHECK, root));
+    const cucumberReport = readJsonIfPresent(opts.cucumber);
+    if (cucumberReport)
+        out.push(...parseCucumberEvidenceObservations(cucumberReport, CUCUMBER_QUALITY_CHECK, 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), the check registry (@SCN-LNT-005) and the configured check names
+    // (@SCN-USG-009), 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 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, and a bar naming a mutation gate
+    // finds that target's record rather than this tool's own (@SCN-MUT-012). 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";
+    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.
+        untaggedScenarios: untaggedScenariosFromFeatures(opts.features),
+        packageJson,
+        ciSources: ciSourcePathsOf(ciPath).map((path) => readFileSync(path, "utf8")),
+        measurements: readJsonIfPresent(opts.measurements) ?? {},
+        runtimeObservations: parseRuntimeObservations(opts, root),
+        // The three things the engine's resolvers cannot hold, and each for its own reason: the starter
+        // deferral set and the guard script prefixes are the application layer's own policy, and the
+        // reader opens a file on the target's tree.
+        deferralTags: DEFAULT_DEFERRAL_TAGS,
+        guardScriptPrefixes: GUARD_SCRIPT_PREFIXES,
+        killFloor: killFloorReaderFor(root),
+    });
+}
+// 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

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

package/dist/ingest/ingestScenarios.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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 product-side (static-checks/featureCodes.ts).
+ *
+ * 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

@@ -0,0 +1 @@
+{"version":3,"file":"ingestScenarios.d.ts","sourceRoot":"","sources":["../../src/ingest/ingestScenarios.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,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;AAaD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,EAAE,CAkBjF"}

package/dist/ingest/ingestScenarios.js

@@ -0,0 +1,119 @@
+/**
+ * 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 product-side (static-checks/featureCodes.ts).
+ *
+ * The foundation, folded into the @LDG runtime spine.
+ */
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { UnreadableFeatureCorpusError, parseErrorsIn } from "./gherkinValidation.js";
+/** A code is valid when it is 2–5 uppercase alphanumerics. */
+const CODE_PATTERN = /^[A-Z0-9]{2,5}$/;
+/**
+ * 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 function extractFeatureCode(source) {
+    const lines = source.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (line === "" || line.startsWith("#"))
+            continue;
+        if (line.startsWith("Feature:")) {
+            for (let j = i - 1; j >= 0; j--) {
+                const prev = lines[j].trim();
+                if (prev === "")
+                    continue;
+                if (!prev.startsWith("@"))
+                    break;
+                const tags = prev.split(/\s+/).filter((t) => t.startsWith("@"));
+                for (const tag of tags) {
+                    const bare = tag.slice(1);
+                    if (bare.startsWith("SCN-"))
+                        continue;
+                    if (["unit", "integration", "e2e", "performance", "smoke"].includes(bare))
+                        continue;
+                    if (CODE_PATTERN.test(bare))
+                        return bare;
+                }
+            }
+            return null;
+        }
+    }
+    return 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 function parseScenarioCodes(source) {
+    const codes = [];
+    const codePattern = /^SCN-[A-Z0-9]+-\d+$/;
+    for (const rawLine of source.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line.startsWith("@"))
+            continue;
+        const tokens = line.split(/\s+/);
+        if (!tokens.every((t) => t.startsWith("@")))
+            continue;
+        for (const token of tokens) {
+            const bare = token.slice(1);
+            if (codePattern.test(bare))
+                codes.push(bare);
+        }
+    }
+    return codes;
+}
+/**
+ * Locate the default features/ directory — `./features` under the current
+ * working directory. This is the target repo's own features dir: the directory
+ * a user runs `spec-controller balance` from, and the workspace root when the
+ * feature-code lint runs in CI. Callers that reconcile a different tree pass an
+ * explicit `--features <dir>`, which overrides this default.
+ */
+function featuresDir() {
+    return join(process.cwd(), "features");
+}
+/**
+ * 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 function discoverFeatures(dir = featuresDir()) {
+    const files = readdirSync(dir)
+        .filter((name) => name.endsWith(".feature"))
+        .sort()
+        .map((name) => {
+        const path = join(dir, name);
+        return { name, path, source: readFileSync(path, "utf8") };
+    });
+    const parseErrors = files.flatMap(({ path, source }) => parseErrorsIn(path, source));
+    if (parseErrors.length > 0)
+        throw new UnreadableFeatureCorpusError(parseErrors);
+    return files.map(({ name, path, source }) => ({
+        slug: name.replace(/\.feature$/, ""),
+        path,
+        featureCode: extractFeatureCode(source),
+        scenarioCodes: parseScenarioCodes(source),
+    }));
+}
+//# sourceMappingURL=ingestScenarios.js.map

package/dist/ingest/ingestScenarios.js.map

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

package/dist/mutation-ratchet/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * THE MODULE'S OWN SURFACE — curated symbol by symbol, never a re-export of the tree behind it
+ * (@SCN-RAT-014, 3F-2804).
+ *
+ * A BARREL THAT RE-EXPORTED EVERY MODULE WOULD BE A CONTRACT NOBODY WROTE. Each module below
+ * exports what its own siblings need from it, and sibling-visibility is a much wider set than
+ * consumer-visibility: the gate-block span finder, the field rewriter, the per-verdict message
+ * builders, the status sets and the loader's per-field readers are all exported so their
+ * neighbours can reach them without a second copy. Passing that set on wholesale would freeze
+ * every one of them as something a consumer may depend on, and the first refactor that moved one
+ * would be a breaking change nobody meant to make. So this file names what a caller may hold and
+ * the omissions are decisions.
+ *
+ * WHAT IS HERE IS THIS LIBRARY'S OWN ENTRY, AND WHAT ITS FIRST CONSUMER NEEDS. The entry is
+ * `reconcileGate` — hand it the five terms a project owns and it answers with a verdict. Around it
+ * sit the pieces a consumer that wants to compose its own way needs: the verdict over counts
+ * already in hand, the two readers that turn a report into counts, the recorder, the loader, the
+ * three score functions a consumer rendering its own view needs, the kill floor those same figures
+ * imply in mutants, the default record name, and both error types the functions above raise — the
+ * record fault and the up-only refusal — because a refusal a caller cannot name in a `catch` is a
+ * refusal that caller cannot handle.
+ *
+ * THE KILL FLOOR CROSSES FOR A SECOND KIND OF CONSUMER, AND THAT IS WHY IT IS NOT A SCORE (3F-2788).
+ * Everything above answers a reader that wants this library's verdict. `killFloorOf` answers one
+ * that wants only the BAR — a ledger holding its own measured row to the same figure this library
+ * reconciles against, so the two cannot disagree by construction. A consumer that derived it
+ * instead would be the second place knowing how an allowance is spent.
+ *
+ * THE TYPES ARE SPELLED FOR A CONSUMER'S NAMESPACE RATHER THAN FOR THIS MODULE'S. `GateRecord` and
+ * `GateAllowance` are unambiguous inside a directory about nothing else; imported into a repository
+ * that has gates of several kinds they are not, so they cross this line under the fuller names.
+ * The aliasing is deliberate and one-directional: the internal spellings stay internal.
+ *
+ * AND NO DRIFT GUARD STANDS OVER IT, WHICH IS A DECISION NOW RATHER THAN AN OPEN QUESTION. The
+ * sibling core package's barrel is reflected and compared against a frozen list in both directions,
+ * so a symbol quietly added or dropped reds. That guard is what a PUBLISHED surface is owed, and
+ * 3F-2859 stopped publishing this one: no manifest key resolves here, and no caller outside this
+ * repository can spell the specifier at all. Freezing the list would make every refactor behind
+ * this barrel a change to a contract nobody holds. What the curation above is still for is the
+ * reader of this repository's own gate, and @SCN-RAT-014 reads the list back beside it — so a
+ * symbol added here is a symbol somebody wrote down twice, which is the guard this surface earns.
+ */
+export { RECORD_FILE, reconcileGate, type RatchetRequest } from "./reconcile.js";
+export { floorOf, gateRecordFor, killFloorOf, MalformedRecordError, parseGateRecords, recordedScoreOf, scoreOf, type GateAllowance as MutationGateAllowance, type GateRecord as MutationGateRecord, } from "./record.js";
+export { FallRefusedError, raisedRecordText } from "./ratchet.js";
+export { measurementFromReport, readMutationReport, type MutationReportRead, } from "./report.js";
+export { verdictFor, type MutationMeasurement, type MutationVerdict, type MutationVerdictKind, } from "./verdict.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mutation-ratchet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mutation-ratchet/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EACL,OAAO,EACP,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,OAAO,EACP,KAAK,aAAa,IAAI,qBAAqB,EAC3C,KAAK,UAAU,IAAI,kBAAkB,GACtC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,EACV,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC"}

package/dist/mutation-ratchet/index.js

@@ -0,0 +1,48 @@
+/**
+ * THE MODULE'S OWN SURFACE — curated symbol by symbol, never a re-export of the tree behind it
+ * (@SCN-RAT-014, 3F-2804).
+ *
+ * A BARREL THAT RE-EXPORTED EVERY MODULE WOULD BE A CONTRACT NOBODY WROTE. Each module below
+ * exports what its own siblings need from it, and sibling-visibility is a much wider set than
+ * consumer-visibility: the gate-block span finder, the field rewriter, the per-verdict message
+ * builders, the status sets and the loader's per-field readers are all exported so their
+ * neighbours can reach them without a second copy. Passing that set on wholesale would freeze
+ * every one of them as something a consumer may depend on, and the first refactor that moved one
+ * would be a breaking change nobody meant to make. So this file names what a caller may hold and
+ * the omissions are decisions.
+ *
+ * WHAT IS HERE IS THIS LIBRARY'S OWN ENTRY, AND WHAT ITS FIRST CONSUMER NEEDS. The entry is
+ * `reconcileGate` — hand it the five terms a project owns and it answers with a verdict. Around it
+ * sit the pieces a consumer that wants to compose its own way needs: the verdict over counts
+ * already in hand, the two readers that turn a report into counts, the recorder, the loader, the
+ * three score functions a consumer rendering its own view needs, the kill floor those same figures
+ * imply in mutants, the default record name, and both error types the functions above raise — the
+ * record fault and the up-only refusal — because a refusal a caller cannot name in a `catch` is a
+ * refusal that caller cannot handle.
+ *
+ * THE KILL FLOOR CROSSES FOR A SECOND KIND OF CONSUMER, AND THAT IS WHY IT IS NOT A SCORE (3F-2788).
+ * Everything above answers a reader that wants this library's verdict. `killFloorOf` answers one
+ * that wants only the BAR — a ledger holding its own measured row to the same figure this library
+ * reconciles against, so the two cannot disagree by construction. A consumer that derived it
+ * instead would be the second place knowing how an allowance is spent.
+ *
+ * THE TYPES ARE SPELLED FOR A CONSUMER'S NAMESPACE RATHER THAN FOR THIS MODULE'S. `GateRecord` and
+ * `GateAllowance` are unambiguous inside a directory about nothing else; imported into a repository
+ * that has gates of several kinds they are not, so they cross this line under the fuller names.
+ * The aliasing is deliberate and one-directional: the internal spellings stay internal.
+ *
+ * AND NO DRIFT GUARD STANDS OVER IT, WHICH IS A DECISION NOW RATHER THAN AN OPEN QUESTION. The
+ * sibling core package's barrel is reflected and compared against a frozen list in both directions,
+ * so a symbol quietly added or dropped reds. That guard is what a PUBLISHED surface is owed, and
+ * 3F-2859 stopped publishing this one: no manifest key resolves here, and no caller outside this
+ * repository can spell the specifier at all. Freezing the list would make every refactor behind
+ * this barrel a change to a contract nobody holds. What the curation above is still for is the
+ * reader of this repository's own gate, and @SCN-RAT-014 reads the list back beside it — so a
+ * symbol added here is a symbol somebody wrote down twice, which is the guard this surface earns.
+ */
+export { RECORD_FILE, reconcileGate } from "./reconcile.js";
+export { floorOf, gateRecordFor, killFloorOf, MalformedRecordError, parseGateRecords, recordedScoreOf, scoreOf, } from "./record.js";
+export { FallRefusedError, raisedRecordText } from "./ratchet.js";
+export { measurementFromReport, readMutationReport, } from "./report.js";
+export { verdictFor, } from "./verdict.js";
+//# sourceMappingURL=index.js.map

package/dist/mutation-ratchet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mutation-ratchet/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAuB,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EACL,OAAO,EACP,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,OAAO,GAGR,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,GAIX,MAAM,cAAc,CAAC"}