spec-controller 0.1.0-alpha.4 → 0.1.0-alpha.40

package/dist/run-management/keptRun.d.ts

@@ -15,24 +15,20 @@
  *     files under a temp root + the repo untouched — never a planner re-run).
  *
  * The store root is an INJECTED parameter — never hardcoded — so the scaffold is
- * location-agnostic (proven against a temp root; the repo is never written). RMG-001 is
- * the dir + the routed outputs; the `run.yaml` stamp (RMG-002) and the `--run-id` mnemonic
- * override (RMG-003) land in later sub-issues.
- *
- * Parent: @SCN-RMG-001 — the run-management layer.
+ * location-agnostic (proven against a temp root; the repo is never written).
  */
 /** The two artefact filenames a kept run routes the tool's outputs into. */
 export declare const RECONCILIATION_DOCUMENT = "spec-reconciliation.md";
 /**
- * The machine artefact filename (@SCN-RMD-001) — renamed `ledger.json` →
+ * The machine artefact filename — renamed `ledger.json` →
  * `spec-reconciliation.json` (parity with `spec-reconciliation.md`): it is the machine form
  * of the WHOLE reconciliation document, not just the ledger.
  */
 export declare const RECONCILIATION_JSON = "spec-reconciliation.json";
-/** The manifest filename a kept run stamps in the run dir (RMG-002). */
+/** The manifest filename a kept run stamps in the run dir. */
 export declare const RUN_MANIFEST = "run.yaml";
 /**
- * The run.yaml schema version this scaffold stamps. Bumped 1 → 2 by 3F-1916, which added
+ * The run.yaml schema version this scaffold stamps. Bumped 1 → 2 when it added
  * the tool identity (`tool_sha` / `tool_version`) — so a reader can tell a run that
  * predates tool-identity recording (schema 1) from one that should carry it (schema 2).
  * run.yaml is write-only (no production reader), so the bump breaks no read path.
@@ -47,7 +43,7 @@ export type RunMode = "balance" | "analyse" | "migrate";
 export interface RunManifestMeta {
     readonly sourceSha: string;
     /**
-     * The TOOL's own git SHA — which spec-controller produced this run (3F-1916), distinct
+     * The TOOL's own git SHA — which spec-controller produced this run, distinct
      * from the target's `sourceSha`. A string ("unknown" when the tool is not a git
      * checkout), mirroring `sourceSha`'s own "unknown" fallback — so run.yaml is internally
      * consistent (both facts use the same absent-marker, never a bare null).
@@ -73,7 +69,7 @@ export interface RunManifest {
     readonly run_id: string;
     readonly target: string;
     readonly source_sha: string;
-    /** The TOOL's identity (3F-1916) — which spec-controller produced the run. */
+    /** The TOOL's identity — which spec-controller produced the run. */
     readonly tool_sha: string;
     readonly tool_version: string;
     readonly mode: RunMode;
@@ -98,12 +94,16 @@ export interface KeptRunPlan {
     readonly reconciliationJsonPath: string;
 }
 /**
- * Invokes the reconciliation tool with the given `--format <fmt>:<path>` specs. INJECTED so
- * the scaffold stays the tool's black-box caller (the real CLI subprocess in the
- * `@integration` arm) and holds no opinion on HOW the tool is run — only WHERE its outputs
- * land (the two file-dest paths the runner hands it).
+ * Invokes the reconciliation tool with the given `--format <fmt>:<path>` specs, and answers
+ * whether it wrote the report those specs name. INJECTED so the scaffold stays the tool's
+ * black-box caller (the real CLI subprocess in the `@integration` arm) and holds no opinion on
+ * HOW the tool is run — only WHERE its outputs land (the two file-dest paths the runner hands it).
+ *
+ * The answer is the command's own, and positive: only the command knows it wrote its report. The
+ * files' existence afterwards cannot say so, because an earlier run under the same run-id may
+ * have left them there.
  */
-export type RouteOutputs = (formatSpecs: readonly string[]) => void;
+export type RouteOutputs = (formatSpecs: readonly string[]) => boolean;
 /**
  * PURE planner: yield the run dir `<storeRoot>/<target>/<runId>/` and the two file-dest
  * paths (`<dir>/spec-reconciliation.md`, `<dir>/spec-reconciliation.json`) from the spec. No
@@ -112,7 +112,7 @@ export type RouteOutputs = (formatSpecs: readonly string[]) => void;
  */
 export declare function planKeptRun(spec: KeptRunSpec): KeptRunPlan;
 /**
- * Options for the pure run-id resolver (RMG-003): the operator's OPTIONAL `--run-id` mnemonic
+ * Options for the pure run-id resolver: the operator's OPTIONAL `--run-id` mnemonic
  * and the INJECTED clock instant the default timestamp derives from.
  */
 export interface ResolveRunIdOptions {
@@ -129,14 +129,14 @@ export interface ResolveRunIdOptions {
  * run-id naming the run dir (feeds `KeptRunSpec.runId`). No `--run-id` → an ISO-8601 UTC
  * timestamp derived from the INJECTED `now` (filesystem-safe: no colons, no millis — matching
  * the existing store run dir); `--run-id <mnemonic>` → that mnemonic verbatim (`acme-q3`, `e1`
- * — an earlier precedent), which ignores the clock. No IO — proven `@unit` (RMG-003).
+ * — an earlier precedent), which ignores the clock. No IO — proven `@unit`.
  * The clock is injected (never a bare `new Date()`) so the default timestamp is deterministic
  * under test (the discipline the old `formatRunTimestamp` used). Just default-vs-override — no
  * sanitisation / collision policy (deferred).
  */
 export declare function resolveRunId(options: ResolveRunIdOptions): string;
 /**
- * PURE: build the run.yaml manifest object from the run metadata (RMG-002). `purpose` and
+ * PURE: build the run.yaml manifest object from the run metadata. `purpose` and
  * `links` are stamped EMPTY (the ad-hoc default; slugs are added by operator hand-edit of
  * run.yaml afterward — the documented curation convention); `artefacts` carry the decided
  * filenames. No IO — proven `@unit`.
@@ -145,12 +145,14 @@ export declare function planRunManifest(input: RunManifestInput): RunManifest;
 /** PURE: serialise the manifest to YAML text the impure runner writes verbatim. */
 export declare function serialiseRunManifest(manifest: RunManifest): string;
 /**
- * IMPURE runner: `mkdir -p` the run dir, route the tool's `--format` outputs into the two
- * files via the injected `route` — the document as `md:<documentPath>`, the reconciliation
- * JSON as `json:<reconciliationJsonPath>` — and stamp `run.yaml` with the manifest built from the spec + `meta`
- * (RMG-002). Returns the plan it realised. The only IO. The `mkdir` is load-bearing: the
- * tool's writer uses `writeFileSync`, which needs the parent dir to exist — so the scaffold
- * creates the dir the location-agnostic tool writes into.
+ * IMPURE runner: `mkdir -p` the run dir, route the tool's `--format` outputs into the two files
+ * via the injected `route` — the document as `md:<documentPath>`, the reconciliation JSON as
+ * `json:<reconciliationJsonPath>` — and, only when the route answers that it wrote them, stamp
+ * `run.yaml` from the spec + `meta` and return the plan it realised. A route that wrote nothing
+ * gets no manifest and no plan back, so nothing names a run that did not happen, and an earlier
+ * run's manifest under the same run-id is left as it was. The `mkdir` is load-bearing: the tool's
+ * writer creates no directories, so the scaffold creates the one the location-agnostic tool
+ * writes into.
  */
-export declare function executeKeptRun(spec: KeptRunSpec, meta: RunManifestMeta, route: RouteOutputs): KeptRunPlan;
+export declare function executeKeptRun(spec: KeptRunSpec, meta: RunManifestMeta, route: RouteOutputs): KeptRunPlan | undefined;
 //# sourceMappingURL=keptRun.d.ts.map

package/dist/run-management/keptRun.d.ts.map

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

package/dist/run-management/keptRun.js

@@ -15,27 +15,24 @@
  *     files under a temp root + the repo untouched — never a planner re-run).
  *
  * The store root is an INJECTED parameter — never hardcoded — so the scaffold is
- * location-agnostic (proven against a temp root; the repo is never written). RMG-001 is
- * the dir + the routed outputs; the `run.yaml` stamp (RMG-002) and the `--run-id` mnemonic
- * override (RMG-003) land in later sub-issues.
- *
- * Parent: @SCN-RMG-001 — the run-management layer.
+ * location-agnostic (proven against a temp root; the repo is never written).
  */
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { stringify } from "yaml";
+import { writeOrRefuse } from "../outputLocation.js";
 /** The two artefact filenames a kept run routes the tool's outputs into. */
 export const RECONCILIATION_DOCUMENT = "spec-reconciliation.md";
 /**
- * The machine artefact filename (@SCN-RMD-001) — renamed `ledger.json` →
+ * The machine artefact filename — renamed `ledger.json` →
  * `spec-reconciliation.json` (parity with `spec-reconciliation.md`): it is the machine form
  * of the WHOLE reconciliation document, not just the ledger.
  */
 export const RECONCILIATION_JSON = "spec-reconciliation.json";
-/** The manifest filename a kept run stamps in the run dir (RMG-002). */
+/** The manifest filename a kept run stamps in the run dir. */
 export const RUN_MANIFEST = "run.yaml";
 /**
- * The run.yaml schema version this scaffold stamps. Bumped 1 → 2 by 3F-1916, which added
+ * The run.yaml schema version this scaffold stamps. Bumped 1 → 2 when it added
  * the tool identity (`tool_sha` / `tool_version`) — so a reader can tell a run that
  * predates tool-identity recording (schema 1) from one that should carry it (schema 2).
  * run.yaml is write-only (no production reader), so the bump breaks no read path.
@@ -60,7 +57,7 @@ export function planKeptRun(spec) {
  * run-id naming the run dir (feeds `KeptRunSpec.runId`). No `--run-id` → an ISO-8601 UTC
  * timestamp derived from the INJECTED `now` (filesystem-safe: no colons, no millis — matching
  * the existing store run dir); `--run-id <mnemonic>` → that mnemonic verbatim (`acme-q3`, `e1`
- * — an earlier precedent), which ignores the clock. No IO — proven `@unit` (RMG-003).
+ * — an earlier precedent), which ignores the clock. No IO — proven `@unit`.
  * The clock is injected (never a bare `new Date()`) so the default timestamp is deterministic
  * under test (the discipline the old `formatRunTimestamp` used). Just default-vs-override — no
  * sanitisation / collision policy (deferred).
@@ -83,7 +80,7 @@ function formatRunTimestamp(instant) {
     return instant.toISOString().replace(/\.\d+Z$/, "Z").replace(/:/g, "-");
 }
 /**
- * PURE: build the run.yaml manifest object from the run metadata (RMG-002). `purpose` and
+ * PURE: build the run.yaml manifest object from the run metadata. `purpose` and
  * `links` are stamped EMPTY (the ad-hoc default; slugs are added by operator hand-edit of
  * run.yaml afterward — the documented curation convention); `artefacts` carry the decided
  * filenames. No IO — proven `@unit`.
@@ -113,21 +110,23 @@ export function serialiseRunManifest(manifest) {
     return stringify(manifest);
 }
 /**
- * IMPURE runner: `mkdir -p` the run dir, route the tool's `--format` outputs into the two
- * files via the injected `route` — the document as `md:<documentPath>`, the reconciliation
- * JSON as `json:<reconciliationJsonPath>` — and stamp `run.yaml` with the manifest built from the spec + `meta`
- * (RMG-002). Returns the plan it realised. The only IO. The `mkdir` is load-bearing: the
- * tool's writer uses `writeFileSync`, which needs the parent dir to exist — so the scaffold
- * creates the dir the location-agnostic tool writes into.
+ * IMPURE runner: `mkdir -p` the run dir, route the tool's `--format` outputs into the two files
+ * via the injected `route` — the document as `md:<documentPath>`, the reconciliation JSON as
+ * `json:<reconciliationJsonPath>` — and, only when the route answers that it wrote them, stamp
+ * `run.yaml` from the spec + `meta` and return the plan it realised. A route that wrote nothing
+ * gets no manifest and no plan back, so nothing names a run that did not happen, and an earlier
+ * run's manifest under the same run-id is left as it was. The `mkdir` is load-bearing: the tool's
+ * writer creates no directories, so the scaffold creates the one the location-agnostic tool
+ * writes into.
  */
 export function executeKeptRun(spec, meta, route) {
     const plan = planKeptRun(spec);
-    mkdirSync(plan.runDir, { recursive: true });
-    route([`md:${plan.documentPath}`, `json:${plan.reconciliationJsonPath}`]);
-    // Stamp run.yaml from the spec's run-id/target (so it can't drift from the run dir) + the
-    // manifest-only meta. The serialised YAML is valid — the @integration parses it back.
+    writeOrRefuse("The stored run's directory could not be created", plan.runDir, () => mkdirSync(plan.runDir, { recursive: true }));
+    if (!route([`md:${plan.documentPath}`, `json:${plan.reconciliationJsonPath}`]))
+        return undefined;
     const manifest = planRunManifest({ runId: spec.runId, target: spec.target, ...meta });
-    writeFileSync(join(plan.runDir, RUN_MANIFEST), serialiseRunManifest(manifest));
+    const manifestPath = join(plan.runDir, RUN_MANIFEST);
+    writeOrRefuse("The stored run's run.yaml could not be written", manifestPath, () => writeFileSync(manifestPath, serialiseRunManifest(manifest)));
     return plan;
 }
 //# sourceMappingURL=keptRun.js.map

package/dist/run-management/keptRun.js.map

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

package/dist/storedRun.d.ts

@@ -0,0 +1,27 @@
+/**
+ * What the host does with a command before a stored run starts: dispatch it unwrapped, or wrap it
+ * in the kept-run scaffold. Pure, so `cli.ts`'s dispatcher reads its answer rather than deciding.
+ */
+import { type CommandSpec } from "./cli-registry.js";
+import type { HostInvocation } from "./host.js";
+/**
+ * True when the host dispatches the command itself, never inside a stored run: no store was asked
+ * for, or the command's help was, which is answered before the store is touched.
+ */
+export declare function dispatchesUnstored(inv: HostInvocation): boolean;
+/**
+ * The refusal for a re-render given a store or a run-id, else undefined: a re-render writes only to
+ * stdout and keeps no run. It is the host's to refuse, not `balance`'s, because a stored run hands
+ * `balance` a `--format` for each report file, and `balance` cannot tell that one from a `--format`
+ * the operator typed; only the host knows which host modifiers were given. It names only those, so a
+ * re-render given a run-id alone is never told to add the store it would refuse in turn.
+ */
+export declare function storedReRenderRefusal(inv: HostInvocation): string | undefined;
+/**
+ * The refusal for a run-id given with no store, before a command that keeps a run, else undefined.
+ * A run-id names a stored run, so with no store there is no run for it to name: dropping it without
+ * a word would leave the operator looking later for a run that was never kept. A request for the
+ * command's help is answered instead, since help keeps no run either.
+ */
+export declare function unstoredRunIdRefusal(inv: HostInvocation, commands?: readonly CommandSpec[]): string | undefined;
+//# sourceMappingURL=storedRun.d.ts.map

package/dist/storedRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storedRun.d.ts","sourceRoot":"","sources":["../src/storedRun.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAU7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,QAAQ,GAAE,SAAS,WAAW,EAAyB,GACtD,MAAM,GAAG,SAAS,CASpB"}

package/dist/storedRun.js

@@ -0,0 +1,49 @@
+/**
+ * What the host does with a command before a stored run starts: dispatch it unwrapped, or wrap it
+ * in the kept-run scaffold. Pure, so `cli.ts`'s dispatcher reads its answer rather than deciding.
+ */
+import { asksForHelp } from "./cli-args.js";
+import { cliRegistry } from "./cli-registry.js";
+/**
+ * True when the host dispatches the command itself, never inside a stored run: no store was asked
+ * for, or the command's help was, which is answered before the store is touched.
+ */
+export function dispatchesUnstored(inv) {
+    return inv.store === undefined || asksForHelp(inv.commandArgs);
+}
+/**
+ * The refusal for a re-render given a store or a run-id, else undefined: a re-render writes only to
+ * stdout and keeps no run. It is the host's to refuse, not `balance`'s, because a stored run hands
+ * `balance` a `--format` for each report file, and `balance` cannot tell that one from a `--format`
+ * the operator typed; only the host knows which host modifiers were given. It names only those, so a
+ * re-render given a run-id alone is never told to add the store it would refuse in turn.
+ */
+export function storedReRenderRefusal(inv) {
+    if (inv.command !== "balance" || asksForHelp(inv.commandArgs))
+        return undefined;
+    if (!inv.commandArgs.includes("--render-from-json"))
+        return undefined;
+    const given = [inv.store === undefined ? [] : ["--store"], inv.runId === undefined ? [] : ["--run-id"]].flat();
+    if (given.length === 0)
+        return undefined;
+    return (`spec-controller: usage error — 'balance --render-from-json' re-renders a saved report to stdout and keeps no run, ` +
+        `and was given ${given.join(", ")}: a re-render is not stored.\n` +
+        `Run 'spec-controller balance --render-from-json <path>' without ${given.length === 1 ? "it" : "them"}.`);
+}
+/**
+ * The refusal for a run-id given with no store, before a command that keeps a run, else undefined.
+ * A run-id names a stored run, so with no store there is no run for it to name: dropping it without
+ * a word would leave the operator looking later for a run that was never kept. A request for the
+ * command's help is answered instead, since help keeps no run either.
+ */
+export function unstoredRunIdRefusal(inv, commands = cliRegistry.commands) {
+    if (inv.runId === undefined || inv.store !== undefined || asksForHelp(inv.commandArgs))
+        return undefined;
+    const entry = commands.find((command) => command.name === inv.command);
+    if (entry === undefined || entry.acceptsHostModifiers === false)
+        return undefined;
+    return (`spec-controller: usage error — --run-id names a stored run, and was given '${inv.runId}' with no --store, ` +
+        `so no run is kept under it.\n` +
+        `To keep the run under that name, give --store <root> as well; otherwise run '${entry.name}' without --run-id.`);
+}
+//# sourceMappingURL=storedRun.js.map

package/dist/storedRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storedRun.js","sourceRoot":"","sources":["../src/storedRun.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAoB,MAAM,mBAAmB,CAAC;AAGlE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAmB;IACpD,OAAO,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAmB;IACvD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IAChF,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAAE,OAAO,SAAS,CAAC;IACtE,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/G,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,CACL,oHAAoH;QACpH,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gCAAgC;QACjE,mEAAmE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CACzG,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAmB,EACnB,WAAmC,WAAW,CAAC,QAAQ;IAEvD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IACzG,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;IACvE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,oBAAoB,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IAClF,OAAO,CACL,8EAA8E,GAAG,CAAC,KAAK,qBAAqB;QAC5G,+BAA+B;QAC/B,gFAAgF,KAAK,CAAC,IAAI,qBAAqB,CAChH,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-controller",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.40",
   "description": "Reconcile the behaviour your scenarios name against the evidence that actually ran — the deterministic `balance` CLI.",
   "keywords": [
     "reconciliation",
@@ -25,7 +25,7 @@
     "@cucumber/gherkin": "^41.0.0",
     "@cucumber/messages": "^34.0.1",
     "yaml": "^2.9.0",
-    "@3f-consulting/spec-controller-core": "0.1.0-alpha.4"
+    "@3f-consulting/spec-controller-core": "0.1.0-alpha.40"
   },
   "publishConfig": {
     "access": "public"

package/dist/corpus/cli.d.ts

@@ -1,34 +0,0 @@
-/**
- * The `tags` command — `spec-controller tags`, the `@SCN` scheme policing itself over a
- * target's Gherkin corpus.
- *
- * THIS EDGE OWNS ONLY THE READS. The rule is `corpusFaults`, in core, reached through the ROOT
- * barrel and nothing else: `./internal` is dropped by `publishConfig.exports` at pack time, and
- * this module travels in the tarball. That is not a style preference — an installed
- * `balance --help` once threw ERR_PACKAGE_PATH_NOT_EXPORTED behind thirteen green gates because a
- * published module reached that subpath (3F-3086). So what happens here is: discover the corpus,
- * read the manifest, build the mutation-record reader, hand over the bytes.
- *
- * ITS OWN COMMAND RATHER THAN A `balance` FLAG. `balance`'s exit code IS its verdict — 0
- * balanced, 1 out of balance, 3 pending-under-strict, 4 unsound, 5 nothing to reconcile — and a
- * corpus FAULT is not a reconciliation verdict. A flag would either overload one of those codes or
- * add a further meaning to a status a consumer's CI branches on. A second command costs one registry entry and gives
- * the fault its own ladder:
- *
- *   0 — the corpus obeys the scheme.
- *   1 — findings; the corpus was read and it breaks a rule.
- *   2 — the corpus (or the manifest) could not be READ at all. Not a verdict, because nothing was
- *       concluded. Sibling to @SCN-CLI-014/015/016 on `balance`, and the same argument: an input
- *       the tool cannot read is a usage error, never a verdict.
- *
- * Usage:
- *   spec-controller tags [--features <dir>] [--package-json <path>]
- */
-/**
- * Police a target's corpus against the `@SCN` scheme's own rules.
- *
- * `process.exitCode` RATHER THAN `process.exit`, so whatever has been written is flushed intact
- * rather than truncated mid-write — the convention `balance`'s own gate settled on.
- */
-export declare function runTags(argv: string[]): void;
-//# sourceMappingURL=cli.d.ts.map

package/dist/corpus/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/corpus/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAiEH;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAkD5C"}

package/dist/corpus/cli.js

@@ -1,128 +0,0 @@
-/**
- * The `tags` command — `spec-controller tags`, the `@SCN` scheme policing itself over a
- * target's Gherkin corpus.
- *
- * THIS EDGE OWNS ONLY THE READS. The rule is `corpusFaults`, in core, reached through the ROOT
- * barrel and nothing else: `./internal` is dropped by `publishConfig.exports` at pack time, and
- * this module travels in the tarball. That is not a style preference — an installed
- * `balance --help` once threw ERR_PACKAGE_PATH_NOT_EXPORTED behind thirteen green gates because a
- * published module reached that subpath (3F-3086). So what happens here is: discover the corpus,
- * read the manifest, build the mutation-record reader, hand over the bytes.
- *
- * ITS OWN COMMAND RATHER THAN A `balance` FLAG. `balance`'s exit code IS its verdict — 0
- * balanced, 1 out of balance, 3 pending-under-strict, 4 unsound, 5 nothing to reconcile — and a
- * corpus FAULT is not a reconciliation verdict. A flag would either overload one of those codes or
- * add a further meaning to a status a consumer's CI branches on. A second command costs one registry entry and gives
- * the fault its own ladder:
- *
- *   0 — the corpus obeys the scheme.
- *   1 — findings; the corpus was read and it breaks a rule.
- *   2 — the corpus (or the manifest) could not be READ at all. Not a verdict, because nothing was
- *       concluded. Sibling to @SCN-CLI-014/015/016 on `balance`, and the same argument: an input
- *       the tool cannot read is a usage error, never a verdict.
- *
- * Usage:
- *   spec-controller tags [--features <dir>] [--package-json <path>]
- */
-import { existsSync, readFileSync } from "node:fs";
-import { corpusFaults } from "@3f-consulting/spec-controller-core";
-import { cliRegistry, renderCommandHelp } from "../cli-registry.js";
-import { checkUnknownFlags, parseArgs } from "../cli-args.js";
-import { DEFAULT_DEFERRAL_TAGS } from "../deferralTags.js";
-import { UnreadableFeatureCorpusError } from "../ingest/gherkinValidation.js";
-import { discoverFeatures } from "../ingest/ingestScenarios.js";
-import { killFloorReaderFor } from "../ingest/ingestQualityChecks.js";
-import { resolveTargetRoot, resolveToolIdentity } from "../run-management/resolveRunInputs.js";
-/**
- * Read everything the rule takes, or say why it could not be read.
- *
- * ONE PLACE, ONE STATUS, because it is one Rule. A corpus the Gherkin parser rejects, a features
- * directory that is not there, and a manifest that is not JSON are three spellings of "the tool
- * could not read its input" — and every one of them, left to escape, lands on Node's default exit
- * 1, which is this command's code for FINDINGS. A crashed invocation would then be
- * indistinguishable by status from a corpus that genuinely breaks a rule, which is exactly the
- * collision 3F-1742 closed on `balance`.
- *
- * THE PARSE REFUSAL IS INHERITED, NOT RESTATED (@SCN-GPG-001). `discoverFeatures` refuses a corpus
- * cucumber could not run rather than returning one, so this command gets that refusal by going
- * through the shared discovery — the same way `balance` does — and what is left here is turning
- * it into this command's status. Its message carries the parser's own words verbatim.
- *
- * THE SOURCES ARE READ HERE because the rule is pure and takes bytes. `DiscoveredFeature` carries
- * the header code and the scenario ids but not the file's text, and the grammar rules that follow
- * this one need the text to walk the tags.
- */
-function readCorpusInputs(featuresDir, manifestPath) {
-    try {
-        const discovered = featuresDir === undefined ? discoverFeatures() : discoverFeatures(featuresDir);
-        return {
-            ok: true,
-            features: discovered.map((f) => ({
-                slug: f.slug,
-                featureCode: f.featureCode,
-                source: readFileSync(f.path, "utf8"),
-            })),
-            packageJson: existsSync(manifestPath)
-                ? JSON.parse(readFileSync(manifestPath, "utf8"))
-                : {},
-            root: resolveTargetRoot({ features: featuresDir }),
-        };
-    }
-    catch (err) {
-        if (err instanceof UnreadableFeatureCorpusError)
-            return { ok: false, error: err.message };
-        const failure = err instanceof Error ? err.message : String(err);
-        return { ok: false, error: `The corpus could not be read: ${failure}` };
-    }
-}
-/**
- * Police a target's corpus against the `@SCN` scheme's own rules.
- *
- * `process.exitCode` RATHER THAN `process.exit`, so whatever has been written is flushed intact
- * rather than truncated mid-write — the convention `balance`'s own gate settled on.
- */
-export function runTags(argv) {
-    // Answer `--help`/`-h` from the registry BEFORE any parse, so it never falls through as a stray
-    // flag while the command runs anyway. The registry is the single source, so a flag that exists
-    // is a flag that appears in help — there is no hand-kept list here to drift.
-    if (argv.includes("--help") || argv.includes("-h")) {
-        process.stdout.write(renderCommandHelp(cliRegistry, "tags") + "\n");
-        return;
-    }
-    const args = parseArgs(argv);
-    // Registry-bounded parse (@SCN-CLI-009's rule, applied to this command's own scope): `tags`
-    // accepts ONLY the flags its registry entry lists. By construction, not by assertion — the
-    // helper is the one `balance` uses, given this command's name.
-    const unknownFlagError = checkUnknownFlags(args, cliRegistry, "tags", resolveToolIdentity().toolVersion);
-    if (unknownFlagError) {
-        process.stderr.write(unknownFlagError + "\n");
-        process.exitCode = 2;
-        return;
-    }
-    // `--package-json` defaults to the manifest at the cwd, matching `balance`'s default: the
-    // target is the tree you are standing in unless you say otherwise.
-    const inputs = readCorpusInputs(args["features"], args["package-json"] ?? "package.json");
-    if (!inputs.ok) {
-        process.stderr.write(inputs.error + "\n");
-        process.exitCode = 2;
-        return;
-    }
-    const faults = corpusFaults({
-        features: inputs.features,
-        packageJson: inputs.packageJson,
-        // The STARTER deferral set — the application layer's own policy, which a target's config may
-        // only extend. Single-sourced here for the reason the reconcile composition takes it as a
-        // parameter: which words the community recognises is the product's answer, not the engine's.
-        deferralTags: DEFAULT_DEFERRAL_TAGS,
-        killFloor: killFloorReaderFor(inputs.root),
-    });
-    if (faults.length === 0) {
-        process.stdout.write("tags: OK — every feature code names one feature file, and every tag on the corpus obeys the @SCN scheme's own rules.\n");
-        return;
-    }
-    process.stderr.write(`tags: FAILED — ${faults.length} finding(s):\n`);
-    for (const fault of faults)
-        process.stderr.write(`  ${fault.message}\n`);
-    process.exitCode = 1;
-}
-//# sourceMappingURL=cli.js.map

package/dist/corpus/cli.js.map

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

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

@@ -1,51 +0,0 @@
-/**
- * THE MODULE'S OWN SURFACE — curated symbol by symbol, never a re-export of the tree behind it
- * (3F-2804, 3F-3337).
- *
- * WHAT IS BEHIND THIS BARREL NOW IS TWO READERS, AND THE RATCHET THEY WERE BUILT FOR IS GONE
- * (3F-3337). `record.ts` reads a target's banked gate record and hands back the kill floor it
- * implies; `report.ts` counts a mutation report's own mutants into a measurement. What left with
- * the ratchet is everything that COMPARED the two — the verdicts, the up-only recorder, the
- * reconciliation entry and the command that ended on it — because this repository's gate is now a
- * per-mutant comparison the runner keeps, and nothing types a mutation count here any more.
- *
- * ITS TWO CONSUMERS ARE BOTH IN THIS TREE, AND THEY WANT DIFFERENT HALVES. `ingest/
- * ingestQualityChecks.ts` wants the RECORD half: the engine's `mutationGate` bar kind lets a target
- * author a fitness row naming a gate instead of a figure, which is a published capability decided
- * over a target's own record (@SCN-MUT-012, @SCN-MUT-013). `tests/checks/mutationScoreCli.ts` wants
- * the REPORT half: `pnpm mutation:score` takes the two counts out of a sweep's report and divides
- * them (@SCN-MUT-007, @SCN-MUT-008). Neither wants the other's, which is why both are named here
- * rather than the tree behind them being passed on wholesale.
- *
- * 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. Passing that set on wholesale would freeze every one of them as something a
- * caller 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.
- *
- * THE KILL FLOOR IS THE BAR, AND IT IS NOT A SCORE (3F-2788). `killFloorOf` answers a ledger
- * holding a measured row to the figure a gate's own record implies, in mutants — a percentage would
- * fold the kill lost and the population grown into one number, which is the distinction a bar on
- * this axis exists to keep. 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` is
- * unambiguous inside a directory about nothing else; imported into a repository that has gates of
- * several kinds it is not, so it crosses this line under the fuller name. The aliasing is
- * deliberate and one-directional: the internal spelling stays internal.
- *
- * AND NO DRIFT GUARD STANDS OVER IT, WHICH IS A DECISION RATHER THAN AN OPEN QUESTION. 3F-2859
- * stopped publishing this barrel: 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 it
- * a change to a contract nobody holds.
- *
- * THE COMPARISON THIS PARAGRAPH USED TO DRAW IS GONE, AND SAYING SO IS THE POINT. It read: 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 being what a PUBLISHED surface is owed, and this
- * one is not published. At 3F-3449 that arm was deleted with the rest of the packaging checks this
- * repository wrote for itself, so NEITHER barrel is guarded now and the contrast no longer carries
- * the argument. What still carries it is the second sentence above, which never depended on it.
- */
-export { floorOf, gateRecordFor, killFloorOf, MalformedRecordError, parseGateRecords, RECORD_FILE, type GateRecord as MutationGateRecord, } from "./record.js";
-export { measurementFromReport, readMutationReport, type MutationMeasurement, type MutationReportRead, } from "./report.js";
-//# sourceMappingURL=index.d.ts.map

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

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

package/dist/mutation-ratchet/index.js

@@ -1,51 +0,0 @@
-/**
- * THE MODULE'S OWN SURFACE — curated symbol by symbol, never a re-export of the tree behind it
- * (3F-2804, 3F-3337).
- *
- * WHAT IS BEHIND THIS BARREL NOW IS TWO READERS, AND THE RATCHET THEY WERE BUILT FOR IS GONE
- * (3F-3337). `record.ts` reads a target's banked gate record and hands back the kill floor it
- * implies; `report.ts` counts a mutation report's own mutants into a measurement. What left with
- * the ratchet is everything that COMPARED the two — the verdicts, the up-only recorder, the
- * reconciliation entry and the command that ended on it — because this repository's gate is now a
- * per-mutant comparison the runner keeps, and nothing types a mutation count here any more.
- *
- * ITS TWO CONSUMERS ARE BOTH IN THIS TREE, AND THEY WANT DIFFERENT HALVES. `ingest/
- * ingestQualityChecks.ts` wants the RECORD half: the engine's `mutationGate` bar kind lets a target
- * author a fitness row naming a gate instead of a figure, which is a published capability decided
- * over a target's own record (@SCN-MUT-012, @SCN-MUT-013). `tests/checks/mutationScoreCli.ts` wants
- * the REPORT half: `pnpm mutation:score` takes the two counts out of a sweep's report and divides
- * them (@SCN-MUT-007, @SCN-MUT-008). Neither wants the other's, which is why both are named here
- * rather than the tree behind them being passed on wholesale.
- *
- * 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. Passing that set on wholesale would freeze every one of them as something a
- * caller 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.
- *
- * THE KILL FLOOR IS THE BAR, AND IT IS NOT A SCORE (3F-2788). `killFloorOf` answers a ledger
- * holding a measured row to the figure a gate's own record implies, in mutants — a percentage would
- * fold the kill lost and the population grown into one number, which is the distinction a bar on
- * this axis exists to keep. 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` is
- * unambiguous inside a directory about nothing else; imported into a repository that has gates of
- * several kinds it is not, so it crosses this line under the fuller name. The aliasing is
- * deliberate and one-directional: the internal spelling stays internal.
- *
- * AND NO DRIFT GUARD STANDS OVER IT, WHICH IS A DECISION RATHER THAN AN OPEN QUESTION. 3F-2859
- * stopped publishing this barrel: 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 it
- * a change to a contract nobody holds.
- *
- * THE COMPARISON THIS PARAGRAPH USED TO DRAW IS GONE, AND SAYING SO IS THE POINT. It read: 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 being what a PUBLISHED surface is owed, and this
- * one is not published. At 3F-3449 that arm was deleted with the rest of the packaging checks this
- * repository wrote for itself, so NEITHER barrel is guarded now and the contrast no longer carries
- * the argument. What still carries it is the second sentence above, which never depended on it.
- */
-export { floorOf, gateRecordFor, killFloorOf, MalformedRecordError, parseGateRecords, RECORD_FILE, } from "./record.js";
-export { measurementFromReport, readMutationReport, } from "./report.js";
-//# sourceMappingURL=index.js.map