spec-controller 0.1.0-alpha.9 → 0.1.0

package/dist/cli-balance/unreadableInputs.d.ts

@@ -0,0 +1,15 @@
+import { type Shape } from "../ingest/inputShapes.js";
+import { type ReRendered } from "./reRender.js";
+export interface JsonInput {
+    readonly subject: string;
+    readonly path: string;
+    readonly shape: Shape;
+    readonly writer: string;
+}
+export declare function jsonInputsOf(args: Record<string, string>, exists: (path: string) => boolean): JsonInput[];
+export declare function reasonOf(err: unknown): string;
+export declare function checkInputShapes(inputs: readonly JsonInput[], read: (path: string) => string): string | null;
+export declare function checkInputPaths(args: Record<string, string>): string | null;
+export declare function checkSavedReconciliation(path: string, savedJson: string): string | null;
+export declare function reRenderOrRefusal(path: string, savedJson: string, strict: boolean): ReRendered | string;
+//# sourceMappingURL=unreadableInputs.d.ts.map

package/dist/cli-balance/unreadableInputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unreadableInputs.d.ts","sourceRoot":"","sources":["../../src/cli-balance/unreadableInputs.ts"],"names":[],"mappings":"AAMA,OAAO,EAOL,KAAK,KAAK,EACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAG1D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA+BD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,EAAE,CASzG;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE7C;AAoBD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,IAAI,CAM5G;AAMD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAkB3E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAUvG"}

package/dist/cli-balance/unreadableInputs.js

@@ -0,0 +1,100 @@
+import { ciReadFault, corpusReadFault, DEFAULT_PACKAGE_JSON, } from "../ingest/ingestQualityChecks.js";
+import { CI_STEP_RECORD, CUCUMBER_REPORT, PACKAGE_MANIFEST, SAVED_RECONCILIATION, shapeFaultIn, VITEST_REPORT, } from "../ingest/inputShapes.js";
+import { reRender } from "./reRender.js";
+import { APP_MESSAGES, AppMessage } from "../messages.js";
+const READ_SHAPES = {
+    vitest: {
+        subject: APP_MESSAGES[AppMessage.FlaggedReport],
+        writer: APP_MESSAGES[AppMessage.VitestReportShape](),
+        shape: VITEST_REPORT,
+    },
+    cucumber: {
+        subject: APP_MESSAGES[AppMessage.FlaggedReport],
+        writer: APP_MESSAGES[AppMessage.CucumberReportShape](),
+        shape: CUCUMBER_REPORT,
+    },
+    "ci-steps": {
+        subject: APP_MESSAGES[AppMessage.FlaggedRecord],
+        writer: APP_MESSAGES[AppMessage.CiStepRecordShape](),
+        shape: CI_STEP_RECORD,
+    },
+    "package-json": {
+        subject: APP_MESSAGES[AppMessage.FlaggedManifest],
+        writer: APP_MESSAGES[AppMessage.PackageManifestShape](),
+        shape: PACKAGE_MANIFEST,
+    },
+};
+export function jsonInputsOf(args, exists) {
+    const given = Object.entries(READ_SHAPES).flatMap(([flag, read]) => {
+        const path = args[flag];
+        if (path === undefined)
+            return [];
+        return [{ subject: read.subject(`--${flag}`), path, shape: read.shape, writer: read.writer }];
+    });
+    if (args["package-json"] !== undefined || !exists(DEFAULT_PACKAGE_JSON))
+        return given;
+    const { shape, writer } = READ_SHAPES["package-json"];
+    return [...given, { subject: APP_MESSAGES[AppMessage.DefaultPackageJson](), path: DEFAULT_PACKAGE_JSON, shape, writer }];
+}
+export function reasonOf(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function jsonInputFault(input, read) {
+    let text;
+    try {
+        text = read(input.path);
+    }
+    catch (err) {
+        return APP_MESSAGES[AppMessage.CouldNotBeReadAt](input.subject, input.path, reasonOf(err));
+    }
+    let document;
+    try {
+        document = JSON.parse(text);
+    }
+    catch (err) {
+        return APP_MESSAGES[AppMessage.NotValidJson](input.subject, input.path, reasonOf(err));
+    }
+    const fault = shapeFaultIn(document, input.shape);
+    if (fault === null)
+        return null;
+    return APP_MESSAGES[AppMessage.NotInShape](input.subject, input.writer, input.path, fault);
+}
+export function checkInputShapes(inputs, read) {
+    for (const input of inputs) {
+        const fault = jsonInputFault(input, read);
+        if (fault !== null)
+            return fault;
+    }
+    return null;
+}
+function pathRefusal(subject, fault) {
+    return APP_MESSAGES[AppMessage.CouldNotBeReadAt](subject, fault.path, fault.reason);
+}
+export function checkInputPaths(args) {
+    const corpus = corpusReadFault(args["features"]);
+    if (corpus !== null) {
+        return pathRefusal(args["features"] === undefined
+            ? APP_MESSAGES[AppMessage.DefaultFeatureCorpus]()
+            : APP_MESSAGES[AppMessage.FlaggedCorpus]("--features"), corpus);
+    }
+    const ci = ciReadFault(args["ci"]);
+    if (ci !== null) {
+        return pathRefusal(args["ci"] === undefined ? APP_MESSAGES[AppMessage.DefaultCiWorkflows]() : APP_MESSAGES[AppMessage.FlaggedWorkflows]("--ci"), ci);
+    }
+    return null;
+}
+export function checkSavedReconciliation(path, savedJson) {
+    const fault = shapeFaultIn(JSON.parse(savedJson), SAVED_RECONCILIATION);
+    if (fault === null)
+        return null;
+    return APP_MESSAGES[AppMessage.NotASavedReconciliation](APP_MESSAGES[AppMessage.FlaggedFile]("--render-from-json"), path, fault);
+}
+export function reRenderOrRefusal(path, savedJson, strict) {
+    try {
+        return reRender(savedJson, strict);
+    }
+    catch (err) {
+        return APP_MESSAGES[AppMessage.NotRenderableAsSaved](APP_MESSAGES[AppMessage.FlaggedFile]("--render-from-json"), path, reasonOf(err));
+    }
+}
+//# sourceMappingURL=unreadableInputs.js.map

package/dist/cli-balance/unreadableInputs.js.map

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

package/dist/cli-registry.d.ts

@@ -1,91 +1,36 @@
-/**
- * The data-driven command/flag registry — the single source the CLI answers `--help`
- * from (@SCN-CLI-006). Two scopes mirror the two help surfaces:
- *
- *   - `global`   — the host modifiers recognised BEFORE the command (`--store`,
- *                  `--run-id`), consumed by the top-level dispatcher; rendered by
- *                  `spec-controller --help` (the sibling @SCN-CLI-007 surface).
- *   - `commands` — the per-command scopes; each command's own flags (+ `--help`/`-h`),
- *                  rendered by `<command> --help`. No count is written here: @SCN-CLI-008 holds
- *                  registry and render together whatever the number is, and a figure repeated in
- *                  prose is one nothing reads (3F-3277).
- *
- * A flag exists ⇒ a registry entry ⇒ it appears in help, by construction — the
- * single-source discipline the completeness guard (@SCN-CLI-008) will enforce and the
- * registry-bounded parser (@SCN-CLI-009) will reject against. Registry + renderers live in the
- * CLI/app layer, never the domain.
- *
- * THE REGISTRY IS THE SOURCE OF TRUTH FOR A FLAG'S DESCRIPTION AND NOTHING RECONCILES THE DOC
- * AGAINST IT. This docblock used to say the doc was reconciled by @SCN-CLI-007/008; it is not —
- * those two are about the registry and the two RENDERERS, and nothing in `tests/` or `features/`
- * reads doc/how_to_use.md at all (3F-3256 deleted the checks that read documentation). So the
- * flag table in that page is kept in step by hand, and it has drifted in BOTH directions before
- * now: ahead of the registry on one sentence and behind it on the next (3F-3083).
- */
-/** One flag in a scope: its canonical name, optional aliases, value placeholder, help. */
 export interface FlagSpec {
-    /** The canonical flag with dashes (e.g. "--features", "--help"). */
     name: string;
-    /** Alternate spellings rendered after the name (e.g. ["-h"]); omit when none. */
     aliases?: string[];
-    /** The value placeholder (e.g. "<dir>"); omit for boolean flags like `--help`. */
     arg?: string;
-    /** True when the flag may be given more than once (`--format`); omit otherwise. */
     repeatable?: boolean;
-    /** One-line help text — the description migrated from doc/how_to_use.md. */
     description: string;
 }
-/** A command: its token, a one-line summary, its per-command flag scope, and any config it reads. */
+export interface PositionalSpec {
+    name: string;
+    description: string;
+}
 export interface CommandSpec {
-    /** The command token (e.g. "balance"). */
     name: string;
-    /** One-line summary for the top-level `spec-controller --help` (the CLI-007 surface). */
     summary: string;
-    /** The command's per-command flag scope. */
     flags: FlagSpec[];
-    /**
-     * Trailing help lines documenting `package.json` config THIS command reads, rendered
-     * verbatim after the flag list. It lives on the command's entry rather than in the
-     * renderer because a config field belongs to whichever command consumes it: appended
-     * unconditionally, `balance`'s `specController.deferralTags` block would document, under
-     * every later command, a field that command does not read (3F-3298). Omit when none.
-     */
+    positionals?: PositionalSpec[];
+    acceptsHostModifiers?: false;
     configHelp?: string[];
+    retiredFlags?: RetiredFlagSpec[];
+}
+interface RetiredFlagSpec {
+    name: string;
+    retiredIn: string;
+    replacement: string;
 }
-/** The two-scope registry: the global host-modifier scope, and the per-command scopes. */
 export interface CliRegistry {
-    /** Host modifiers recognised before the command — the global scope (CLI-007). */
     global: FlagSpec[];
-    /** The per-command scopes. */
     commands: CommandSpec[];
 }
-/**
- * The registry singleton — the single source both help surfaces render from.
- */
+export declare const balanceCommand: CommandSpec;
+export declare const allocateCommand: CommandSpec;
 export declare const cliRegistry: CliRegistry;
-/**
- * Render THE NAMED command's per-command scope as help text: one line per registered flag
- * (name + arg-placeholder + description), then whatever config lines that command's entry
- * carries — driven BY the registry, so a flag that exists is a flag that appears, by
- * construction. Returns the help block WITHOUT a trailing newline (the caller adds it,
- * matching the writer's stdout convention).
- *
- * THE COMMAND IS A PARAMETER (3F-3298). It used to be the literal `"balance"`, found by name
- * inside this function, which is what the single registered command made look general. A
- * second command had no help surface at all under that signature — not an empty one; there
- * was no argument by which to ask. What the renderer covers is now the registry's shape
- * rather than the command set's size on the day it was written.
- */
-export declare function renderCommandHelp(registry: CliRegistry, command: string): string;
-/**
- * Render the top-level `spec-controller --help` surface (@SCN-CLI-007) FROM the registry:
- * a Commands section (each command's name + one-line summary) and a Host modifiers section
- * (each global-scope flag: name + arg-placeholder + one-line description). The global-scope
- * half of the two-scope registry — the counterpart to `renderCommandHelp`'s per-command
- * half — so the top-level usage no longer hand-keeps (and can no longer silently drift
- * from) the command set or the host modifiers; both are sourced from `cliRegistry`.
- * Summaries and descriptions render on a single line (no wrapping) so a registered string
- * appears verbatim. Returns the block WITHOUT a trailing newline (the caller adds it).
- */
+export declare function renderCommandHelp(command: CommandSpec): string;
 export declare function renderTopLevelHelp(registry: CliRegistry): string;
+export {};
 //# sourceMappingURL=cli-registry.d.ts.map

package/dist/cli-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-registry.d.ts","sourceRoot":"","sources":["../src/cli-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,0FAA0F;AAC1F,MAAM,WAAW,QAAQ;IACvB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qGAAqG;AACrG,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,0FAA0F;AAC1F,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AA8ID;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,WAiBzB,CAAC;AAQF;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CA0BhE"}
+{"version":3,"file":"cli-registry.d.ts","sourceRoot":"","sources":["../src/cli-registry.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,oBAAoB,CAAC,EAAE,KAAK,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;CAClC;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAkGD,eAAO,MAAM,cAAc,EAAE,WAM5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAc7B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAGzB,CAAC;AAOF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAgB9D;AAcD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CA0BhE"}

package/dist/cli-registry.js

@@ -1,219 +1,154 @@
-/**
- * The data-driven command/flag registry — the single source the CLI answers `--help`
- * from (@SCN-CLI-006). Two scopes mirror the two help surfaces:
- *
- *   - `global`   — the host modifiers recognised BEFORE the command (`--store`,
- *                  `--run-id`), consumed by the top-level dispatcher; rendered by
- *                  `spec-controller --help` (the sibling @SCN-CLI-007 surface).
- *   - `commands` — the per-command scopes; each command's own flags (+ `--help`/`-h`),
- *                  rendered by `<command> --help`. No count is written here: @SCN-CLI-008 holds
- *                  registry and render together whatever the number is, and a figure repeated in
- *                  prose is one nothing reads (3F-3277).
- *
- * A flag exists ⇒ a registry entry ⇒ it appears in help, by construction — the
- * single-source discipline the completeness guard (@SCN-CLI-008) will enforce and the
- * registry-bounded parser (@SCN-CLI-009) will reject against. Registry + renderers live in the
- * CLI/app layer, never the domain.
- *
- * THE REGISTRY IS THE SOURCE OF TRUTH FOR A FLAG'S DESCRIPTION AND NOTHING RECONCILES THE DOC
- * AGAINST IT. This docblock used to say the doc was reconciled by @SCN-CLI-007/008; it is not —
- * those two are about the registry and the two RENDERERS, and nothing in `tests/` or `features/`
- * reads doc/how_to_use.md at all (3F-3256 deleted the checks that read documentation). So the
- * flag table in that page is kept in step by hand, and it has drifted in BOTH directions before
- * now: ahead of the registry on one sentence and behind it on the next (3F-3083).
- */
 import { DEFAULT_DEFERRAL_TAGS } from "./deferralTags.js";
-/**
- * The `balance` command's per-command scope — its reconciliation flags plus `--help`/`-h`.
- * This registry is where a flag's description LIVES; doc/how_to_use.md's flag table restates it
- * by hand, reconciled by nobody (see the header).
- */
+import { APP_MESSAGES, AppMessage } from "./messages.js";
 const balanceFlags = [
     {
         name: "--features",
         arg: "<dir>",
-        description: "Directory of Gherkin .feature files — the scenarios, and the `@`-tags naming what each must prove (@unit, @integration, @fitness, …).",
+        description: APP_MESSAGES[AppMessage.FeaturesFlag](),
     },
     {
         name: "--vitest",
         arg: "<report.json>",
-        description: "A Vitest JSON report — runtime test evidence.",
+        description: APP_MESSAGES[AppMessage.VitestFlag](),
     },
     {
         name: "--cucumber",
         arg: "<report.json>",
-        description: "A Cucumber JSON report — runtime test evidence.",
+        description: APP_MESSAGES[AppMessage.CucumberFlag](),
     },
     {
         name: "--ci",
         arg: "<ci.yml>",
-        description: "Your CI workflows — a file, or a directory of them (default .github/workflows). Where a static check you have not converted is found running over the real source, and where a check step's `id:` supplies the @SCN its result cites.",
+        description: APP_MESSAGES[AppMessage.CiFlag](),
     },
     {
         name: "--package-json",
         arg: "<path>",
-        description: "The target's package.json — its `scripts`, and its specController.fitnessChecks rows: each names a scenario's @SCN, a characteristic, and the command that is the check.",
+        description: APP_MESSAGES[AppMessage.PackageJsonFlag](),
     },
     {
         name: "--ci-steps",
         arg: "<record.json>",
-        description: "The CI run's own record of what each of its steps did — your pipeline's `toJSON(steps)` dump, evidence for the converted fitness checks. Omit it if you have converted none.",
+        description: APP_MESSAGES[AppMessage.CiStepsFlag](),
     },
     {
         name: "--target",
         arg: "<name>",
-        description: "A name recorded verbatim in the report's provenance (which project this run reconciled).",
+        description: APP_MESSAGES[AppMessage.TargetFlag](),
     },
     {
         name: "--source-sha",
         arg: "<sha>",
-        description: "Override the git commit SHA recorded in provenance (defaults to the resolved HEAD).",
+        description: APP_MESSAGES[AppMessage.SourceShaFlag](),
     },
     {
         name: "--format",
         arg: "<fmt>[:<path>]",
         repeatable: true,
-        description: "Where to send output (md or json, optionally :<path> to write to a file). Repeatable.",
+        description: APP_MESSAGES[AppMessage.FormatFlag](),
     },
     {
         name: "--render-from-json",
         arg: "<path>",
-        description: "Re-render Markdown from a previously saved Evidence Reconciliation JSON — no reconcile, no live inputs.",
+        description: APP_MESSAGES[AppMessage.RenderFromJsonFlag](),
     },
     {
         name: "--strict",
-        description: "Fail the run (exit 3) when it carries Pending Items — the opt-in that escalates otherwise-run-neutral deferred obligations.",
+        description: APP_MESSAGES[AppMessage.StrictFlag](),
     },
     {
         name: "--exit-zero",
-        description: "Print the same report but exit 0 on an out-of-balance (1) or --strict pending (3) verdict — the on-ramp before gating. Usage (2), unsound (4) and nothing-to-reconcile (5) still fail.",
+        description: APP_MESSAGES[AppMessage.ExitZeroFlag](),
     },
     {
         name: "--help",
         aliases: ["-h"],
-        description: "Show this help and exit.",
+        description: APP_MESSAGES[AppMessage.HelpFlag](),
     },
 ];
-/**
- * `balance`'s config block: the `specController.deferralTags` field it reads, with its
- * recognised starter set SINGLE-SOURCED from DEFAULT_DEFERRAL_TAGS (@SCN-PND-021 / the
- * 3F-1405 completeness discipline — the lines are built FROM the constant, never a
- * hand-kept copy, so the documented set cannot drift from the recognised one). It hangs
- * off balance's registry entry, not off the renderer, so it renders under `balance --help`
- * and under nothing else.
- */
 const balanceConfigHelp = [
-    "Configuration (in the target repo's package.json):",
-    "  specController.deferralTags: string[]",
-    "      Extra recognised deferral tags. A scenario carrying one defers every obligation it",
-    "      names to a Pending Item, extending (never replacing) the built-in set.",
-    `      Built-in deferral tags: ${DEFAULT_DEFERRAL_TAGS.map((tag) => `@${tag}`).join(", ")}`,
+    APP_MESSAGES[AppMessage.ConfigurationHeading](),
+    `  ${APP_MESSAGES[AppMessage.DeferralTagsKey]()}`,
+    `      ${APP_MESSAGES[AppMessage.DeferralTagsExtend]()}`,
+    `      ${APP_MESSAGES[AppMessage.DeferralTagsNeverReplace]()}`,
+    `      ${APP_MESSAGES[AppMessage.BuiltInDeferralTags](DEFAULT_DEFERRAL_TAGS.map((tag) => `@${tag}`).join(", "))}`,
 ];
-/**
- * The `tags` command's per-command scope (3F-3300). Two input flags and `--help`/`-h`, and the
- * two are `balance`'s own spellings on purpose: a consumer pointing one command at a corpus and a
- * manifest should not have to learn a second name for each when they point the other at the same
- * two files. The descriptions are this command's — what it reads them FOR is not what `balance`
- * reads them for — but the flags are the same flags.
- *
- * NO `configHelp`. A command's config block documents the `package.json` fields THAT command
- * reads, and `tags` reads none yet: the check-tag union and the recognised deferral set arrive
- * with the grammar rules (3F-3302 onward), and the entry gains its block then. Appending
- * `balance`'s block here would document, under this command, fields this command does not read —
- * which is the fault 3F-3298 moved that block onto a command entry to prevent.
- */
-const tagsFlags = [
+const balanceRetiredFlags = [
     {
-        name: "--features",
-        arg: "<dir>",
-        description: "Directory of Gherkin .feature files — the corpus these rules are asked about (default ./features).",
-    },
-    {
-        name: "--package-json",
-        arg: "<path>",
-        description: "The target's package.json — its specController block, from which the words that name a check and the tags that park a scenario are resolved (default ./package.json).",
-    },
-    {
-        name: "--help",
-        aliases: ["-h"],
-        description: "Show this help and exit.",
+        name: "--measurements",
+        retiredIn: "0.1.0-alpha.5",
+        replacement: APP_MESSAGES[AppMessage.MeasurementsReplacement](),
     },
 ];
-/** The global host-modifier scope — recognised before the command; the CLI-007 surface. */
 const globalFlags = [
     {
         name: "--store",
         arg: "<root>",
-        description: "Store the run: write <root>/<target>/<run-id>/ with the reconciliation outputs + a run.yaml manifest. Required to store; there is no default (a default would write inside the repo).",
+        description: APP_MESSAGES[AppMessage.StoreModifier](),
     },
     {
         name: "--run-id",
         arg: "<id>",
-        description: "Name the stored run (default: an ISO-8601 UTC timestamp).",
+        description: APP_MESSAGES[AppMessage.RunIdModifier](),
     },
 ];
-/**
- * The registry singleton — the single source both help surfaces render from.
- */
-export const cliRegistry = {
-    global: globalFlags,
-    commands: [
-        {
-            name: "balance",
-            summary: "Reconcile Gherkin scenarios against test/CI evidence and emit the Evidence Reconciliation (Markdown to stdout by default).",
-            flags: balanceFlags,
-            configHelp: balanceConfigHelp,
-        },
+export const balanceCommand = {
+    name: "balance",
+    summary: APP_MESSAGES[AppMessage.BalanceSummary](),
+    flags: balanceFlags,
+    configHelp: balanceConfigHelp,
+    retiredFlags: balanceRetiredFlags,
+};
+export const allocateCommand = {
+    name: "allocate",
+    summary: APP_MESSAGES[AppMessage.AllocateSummary](),
+    acceptsHostModifiers: false,
+    positionals: [
+        { name: "<FFF>", description: APP_MESSAGES[AppMessage.FeaturePartArgument]() },
+    ],
+    flags: [
         {
-            name: "tags",
-            summary: "Police the @SCN scheme over your Gherkin corpus — the rules the scheme itself imposes on the tags and header codes a feature file carries (exit 1 on findings, 2 on a corpus that cannot be read).",
-            flags: tagsFlags,
+            name: "--new",
+            description: APP_MESSAGES[AppMessage.NewFlag](),
         },
+        { name: "--help", aliases: ["-h"], description: APP_MESSAGES[AppMessage.HelpFlag]() },
     ],
 };
-/** The display label for a flag: its name, any aliases, then its arg-placeholder. */
+export const cliRegistry = {
+    global: globalFlags,
+    commands: [balanceCommand, allocateCommand],
+};
 function flagLabel(flag) {
     const names = [flag.name, ...(flag.aliases ?? [])].join(", ");
     return flag.arg !== undefined ? `${names} ${flag.arg}` : names;
 }
-/**
- * Render THE NAMED command's per-command scope as help text: one line per registered flag
- * (name + arg-placeholder + description), then whatever config lines that command's entry
- * carries — driven BY the registry, so a flag that exists is a flag that appears, by
- * construction. Returns the help block WITHOUT a trailing newline (the caller adds it,
- * matching the writer's stdout convention).
- *
- * THE COMMAND IS A PARAMETER (3F-3298). It used to be the literal `"balance"`, found by name
- * inside this function, which is what the single registered command made look general. A
- * second command had no help surface at all under that signature — not an empty one; there
- * was no argument by which to ask. What the renderer covers is now the registry's shape
- * rather than the command set's size on the day it was written.
- */
-export function renderCommandHelp(registry, command) {
-    const entry = registry.commands.find((c) => c.name === command);
-    const flags = entry?.flags ?? [];
+export function renderCommandHelp(command) {
+    const flags = command.flags;
     const gutter = 2;
     const labelWidth = Math.max(0, ...flags.map((f) => flagLabel(f).length));
     const lines = flags.map((flag) => `  ${flagLabel(flag).padEnd(labelWidth + gutter)}${flag.description}`);
-    const configHelp = entry?.configHelp ?? [];
+    const configHelp = command.configHelp ?? [];
     return [
-        `spec-controller ${command} — ${entry?.summary ?? ""}`,
+        `spec-controller ${command.name} — ${command.summary}`,
+        ...positionalHelp(command.name, command.positionals ?? []),
         "",
-        "Options:",
+        APP_MESSAGES[AppMessage.HelpOptions](),
         ...lines,
         ...(configHelp.length > 0 ? ["", ...configHelp] : []),
     ].join("\n");
 }
-/**
- * Render the top-level `spec-controller --help` surface (@SCN-CLI-007) FROM the registry:
- * a Commands section (each command's name + one-line summary) and a Host modifiers section
- * (each global-scope flag: name + arg-placeholder + one-line description). The global-scope
- * half of the two-scope registry — the counterpart to `renderCommandHelp`'s per-command
- * half — so the top-level usage no longer hand-keeps (and can no longer silently drift
- * from) the command set or the host modifiers; both are sourced from `cliRegistry`.
- * Summaries and descriptions render on a single line (no wrapping) so a registered string
- * appears verbatim. Returns the block WITHOUT a trailing newline (the caller adds it).
- */
+function positionalHelp(command, positionals) {
+    if (positionals.length === 0)
+        return [];
+    const width = Math.max(...positionals.map((positional) => positional.name.length));
+    return [
+        "",
+        `${APP_MESSAGES[AppMessage.HelpUsage]()} spec-controller ${command} ${positionals.map((positional) => positional.name).join(" ")} [options]`,
+        "",
+        APP_MESSAGES[AppMessage.HelpArguments](),
+        ...positionals.map((positional) => `  ${positional.name.padEnd(width + 2)}${positional.description}`),
+    ];
+}
 export function renderTopLevelHelp(registry) {
     const commandGutter = 4;
     const commandWidth = Math.max(0, ...registry.commands.map((c) => c.name.length));
@@ -223,18 +158,18 @@ export function renderTopLevelHelp(registry) {
     const modifierLines = registry.global.map((flag) => `  ${flagLabel(flag).padEnd(modifierWidth + modifierGutter)}${flag.description}`);
     const modifierUsage = registry.global.map((flag) => `[${flagLabel(flag)}]`).join(" ");
     return [
-        "spec-controller — reconcile scenarios against observed evidence",
+        APP_MESSAGES[AppMessage.HelpTitle](),
         "",
-        "Usage:",
-        `  spec-controller ${modifierUsage} <command> [command-args]`,
+        APP_MESSAGES[AppMessage.HelpUsage](),
+        `  ${APP_MESSAGES[AppMessage.HelpUsageLine](modifierUsage)}`,
         "",
-        "Commands:",
+        APP_MESSAGES[AppMessage.HelpCommands](),
         ...commandLines,
         "",
-        "Host modifiers (before the command):",
+        APP_MESSAGES[AppMessage.HelpHostModifiers](),
         ...modifierLines,
         "",
-        "Full flags, examples, and CI wiring: doc/how_to_use.md.",
+        APP_MESSAGES[AppMessage.HelpPointer](),
     ].join("\n");
 }
 //# sourceMappingURL=cli-registry.js.map

package/dist/cli-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-registry.js","sourceRoot":"","sources":["../src/cli-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-registry.js","sourceRoot":"","sources":["../src/cli-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAoCzD,MAAM,YAAY,GAAe;IAC/B;QACE,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,OAAO;QACZ,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;KACrD;IACD;QACE,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,eAAe;QACpB,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;KACnD;IACD;QACE,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,eAAe;QACpB,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;KACrD;IACD;QACE,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,UAAU;QACf,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;KAC/C;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,GAAG,EAAE,QAAQ;QACb,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE;KACxD;IACD;QACE,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,eAAe;QACpB,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;KACpD;IACD;QACE,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,QAAQ;QACb,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;KACnD;IACD;QACE,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,OAAO;QACZ,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;KACtD;IACD;QACE,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,gBAAgB;QACrB,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;KACnD;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,GAAG,EAAE,QAAQ;QACb,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE;KAC3D;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;KACnD;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;KACrD;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,IAAI,CAAC;QACf,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;KACjD;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAa;IAClC,YAAY,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE;IAC/C,KAAK,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,EAAE;IACjD,SAAS,YAAY,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,EAAE;IACxD,SAAS,YAAY,CAAC,UAAU,CAAC,wBAAwB,CAAC,EAAE,EAAE;IAC9D,SAAS,YAAY,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE;CAClH,CAAC;AAEF,MAAM,mBAAmB,GAAsB;IAC7C;QACE,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,eAAe;QAC1B,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,uBAAuB,CAAC,EAAE;KAChE;CACF,CAAC;AAEF,MAAM,WAAW,GAAe;IAC9B;QACE,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,QAAQ;QACb,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;KACtD;IACD;QACE,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,MAAM;QACX,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;KACtD;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE;IAClD,KAAK,EAAE,YAAY;IACnB,UAAU,EAAE,iBAAiB;IAC7B,YAAY,EAAE,mBAAmB;CAClC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE;IACnD,oBAAoB,EAAE,KAAK;IAC3B,WAAW,EAAE;QACX,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,EAAE;KAC/E;IACD,KAAK,EAAE;QACL;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;SAChD;QACD,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE;KACtF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,MAAM,EAAE,WAAW;IACnB,QAAQ,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;CAC5C,CAAC;AAEF,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAoB;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,CAAC,CAAC;IACjB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CACrB,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAChF,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;IAC5C,OAAO;QACL,mBAAmB,OAAO,CAAC,IAAI,MAAM,OAAO,CAAC,OAAO,EAAE;QACtD,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QAC1D,EAAE;QACF,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;QACtC,GAAG,KAAK;QACR,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,WAAsC;IAC7E,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,OAAO;QACL,EAAE;QACF,GAAG,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,oBAAoB,OAAO,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY;QAC5I,EAAE;QACF,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;QACxC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;KACtG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAqB;IACtD,MAAM,aAAa,GAAG,CAAC,CAAC;IACxB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CACxC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CACxF,CAAC;IACF,MAAM,cAAc,GAAG,CAAC,CAAC;IACzB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACtF,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CACvC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,GAAG,cAAc,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAC3F,CAAC;IACF,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtF,OAAO;QACL,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;QACpC,EAAE;QACF,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;QACpC,KAAK,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,aAAa,CAAC,EAAE;QAC5D,EAAE;QACF,YAAY,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;QACvC,GAAG,YAAY;QACf,EAAE;QACF,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE;QAC5C,GAAG,aAAa;QAChB,EAAE;QACF,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;KACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/cli.d.ts

@@ -1,24 +1,3 @@
 #!/usr/bin/env node
-/**
- * The `spec-controller` binary — the top-level command host + dispatcher.
- *
- * Usage:
- *   spec-controller [--store <root>] [--run-id <id>] <command> [command-args]
- *
- * Commands: `balance` — the deterministic reconciliation of scenarios against
- * observed evidence, standalone on the public core + app layer (no engine); `tags` — the
- * @SCN scheme policing itself over the same corpus, which is a fault about the corpus rather
- * than a verdict about its evidence, and so has its own status ladder rather than a fifth
- * meaning on balance's. The `analyse` / `migrate` capabilities are a separate, closed offering
- * built on the same core.
- *
- * Storage is a CROSS-CUTTING host modifier, not a command. A leading `--store <root>`
- * turns any command into a STORED run: the host wraps the command via the kept-run
- * scaffold — a named `<root>/<target>/<run-id>/` directory, the command's outputs routed
- * in, and a `run.yaml` manifest — and hands the command its own clean args, unchanged. So
- * `balance` stays emit-only (its default, no-store output is byte-identical); the store
- * opinion lives at the host, injected via `--store` (required — there is no default, a
- * default would write inside the repo). `--run-id` defaults to a timestamp.
- */
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}