@adammcarter/use-cases 0.1.0

package/packages/cli/dist/builtins.js

@@ -0,0 +1,235 @@
+// Builtin CLI behaviour that stays OUTSIDE the declarative command registry:
+// version, the `--help` usage catalog, `init` scaffolding, and `schema`
+// introspection. These emit bespoke (non-envelope) output or hold a CI-signed
+// `@use-case` marker (cli_self_documents, in the help machinery), so they live
+// here as a small, marker-stable module. `runBuiltinCli` is the builtins-only
+// fallback the registry dispatcher (index.ts) delegates to when no registry
+// command matches. The core loader lives in ./coreLoader.ts.
+import { resolve } from "node:path";
+import { loadUcmCore } from "./coreLoader.js";
+import { valueAfter } from "./args/parse.js";
+import { renderEnvelope } from "./render.js";
+import { allCommands } from "./command/registry.js";
+import { buildUsageCatalog } from "./command/help-catalog.js";
+const { PUBLIC_SCHEMA_IDS, createCliResult, getVersionInfo, validateFixtureWorkspace, scaffoldWorkspace, isInitTemplate } = await loadUcmCore();
+// Output mode for the whole process. Every command builds the SAME normative
+// envelope; `rendered()` is the single choke-point that decides whether the
+// caller sees the machine JSON (`--json`) or a human-readable view (the default).
+// This is what lets `uc matrix list` work bare while `--json` stays byte-stable.
+let outputJson = false;
+// Thin wrapper over the shared renderer, bound to this dispatcher's process-wide
+// `outputJson` mode. The registry path calls `renderEnvelope` with an explicit
+// flag instead.
+function rendered(envelope) {
+    return renderEnvelope(envelope, outputJson);
+}
+export function runBuiltinCli(argv) {
+    const normalizedArgv = argv[0] === "--" ? argv.slice(1) : argv;
+    const wantsVersion = normalizedArgv.includes("--version") || normalizedArgv.includes("-v") || normalizedArgv[0] === "version";
+    const wantsJson = normalizedArgv.includes("--json");
+    outputJson = wantsJson;
+    if (wantsVersion) {
+        if (wantsJson) {
+            process.stdout.write(rendered(createCliResult("version", getVersionInfo())));
+        }
+        else {
+            process.stdout.write(`${getVersionInfo().version}\n`);
+        }
+        return 0;
+    }
+    // Discoverability: `uc`, `uc --help`, `uc -h`, and `uc <command> --help`
+    // all print a usage envelope. Agents reliably reach for `--help` first, so a
+    // bare or help-flagged invocation must answer with the command/flag catalog
+    // rather than the cryptic command.unknown response.
+    if (normalizedArgv.length === 0 || normalizedArgv.includes("--help") || normalizedArgv.includes("-h")) {
+        return runHelp(normalizedArgv, { json: wantsJson });
+    }
+    if (normalizedArgv[0] === "schema" && normalizedArgv[1] === "list") {
+        process.stdout.write(rendered(createCliResult("schema.list", {
+            schemas: PUBLIC_SCHEMA_IDS.map((id) => ({ id }))
+        })));
+        return 0;
+    }
+    if (normalizedArgv[0] === "schema" && normalizedArgv[1] === "validate-fixtures") {
+        const fixture = valueAfter(normalizedArgv, "--fixture") ?? "tests/fixtures/workspaces/minimal-valid";
+        const fixturePath = resolve(process.cwd(), fixture);
+        const result = validateFixtureWorkspace(fixturePath);
+        process.stdout.write(rendered(createCliResult("schema.validate-fixtures", {
+            fixture,
+            validated_schema_ids: result.validated_schema_ids,
+            expected_state: result.expected_state
+        }, {
+            ok: result.ok,
+            complete: result.complete,
+            diagnostics: result.diagnostics,
+            dataRoot: fixturePath
+        })));
+        return 0;
+    }
+    if (normalizedArgv[0] === "init") {
+        return runInit(normalizedArgv, wantsJson);
+    }
+    // No recognized command: instead of a cryptic one-line hint, print the usage
+    // envelope scoped to whatever group the caller named (e.g. `matrix`) so they
+    // can immediately see the valid subcommands and flags.
+    return runHelp(normalizedArgv, { unknown: true, json: wantsJson });
+}
+// The usage catalog is DERIVED from the declarative command registry (one
+// FlagSpec source of truth) rather than re-typed here. buildUsageCatalog prefixes
+// the non-registry builtins (version / init) onto the projected registry commands.
+const USAGE = buildUsageCatalog(allCommands);
+function selectUsageEntries(tokens) {
+    if (tokens.length === 0) {
+        return USAGE;
+    }
+    const prefix = tokens.join(" ");
+    const exact = USAGE.filter((entry) => entry.name === prefix || entry.name.startsWith(`${prefix} `));
+    if (exact.length > 0) {
+        return exact;
+    }
+    const group = USAGE.filter((entry) => entry.name === tokens[0] || entry.name.startsWith(`${tokens[0]} `));
+    return group.length > 0 ? group : USAGE;
+}
+//: @use-case: diagnostics.contracts.cli_self_documents
+function runHelp(argv, options = {}) {
+    const tokens = argv.filter((arg) => !arg.startsWith("-"));
+    const commands = selectUsageEntries(tokens);
+    const requested = tokens.length > 0 ? tokens.join(" ") : null;
+    const unknownMessage = `No recognized command for '${requested ?? "(none)"}'. See the commands listed below or run \`uc --help\`.`;
+    // Default to human-readable text; emit the JSON envelope only on --json. Agents
+    // (and people) reach for `--help` first and expect prose, not a minified blob.
+    if (!options.json) {
+        process.stdout.write(renderHelpText(commands, { unknown: options.unknown, requested, unknownMessage }));
+        return options.unknown ? 2 : 0;
+    }
+    const data = {
+        schema_version: 1,
+        usage: "uc <command> [subcommand] [flags] --json",
+        requested,
+        commands
+    };
+    const diagnostics = options.unknown
+        ? [
+            {
+                code: "command.unknown",
+                severity: "error",
+                message: unknownMessage,
+                source_path: null,
+                json_pointer: null,
+                entity_id: null,
+                related_ids: []
+            }
+        ]
+        : [];
+    process.stdout.write(rendered(createCliResult("help", data, {
+        ok: !options.unknown,
+        complete: !options.unknown,
+        diagnostics
+    })));
+    return options.unknown ? 2 : 0;
+}
+// Render the usage catalog as readable text. A single matched command shows its
+// full flag list; the broad list stays compact with a pointer to per-command help.
+function renderHelpText(commands, options) {
+    const lines = [];
+    if (options.unknown) {
+        lines.push(`error: ${options.unknownMessage}`, "");
+    }
+    lines.push("uc — use-cases CLI", "");
+    lines.push("Usage: uc <command> [subcommand] [flags] [--json]", "");
+    const detailed = commands.length <= 3;
+    const heading = options.requested ? `Commands matching '${options.requested}':` : "Commands:";
+    lines.push(heading);
+    const width = Math.min(28, commands.reduce((max, c) => Math.max(max, c.name.length), 0));
+    for (const command of commands) {
+        lines.push(`  ${command.name.padEnd(width)}  ${command.summary}`);
+        if (detailed) {
+            for (const f of command.flags) {
+                lines.push(`      ${f.flag.padEnd(34)} ${f.summary}`);
+            }
+        }
+    }
+    lines.push("");
+    if (!detailed) {
+        lines.push("Run `uc <command> --help` for that command's flags.");
+    }
+    lines.push("Add --json to any command for the machine-readable result envelope.");
+    return `${lines.join("\n")}\n`;
+}
+//: @use-case: end diagnostics.contracts.cli_self_documents
+function runInit(argv, wantsJson) {
+    const repoRoot = resolve(process.cwd(), valueAfter(argv, "--repo") ?? ".");
+    const templateRaw = valueAfter(argv, "--template");
+    if (templateRaw !== undefined && !isInitTemplate(templateRaw)) {
+        return writeError("init", "init.unknown_template", `Unknown --template '${templateRaw}'. Use one of generic, js-vitest, python-pytest, go-test.`);
+    }
+    const result = scaffoldWorkspace({
+        repoRoot,
+        template: templateRaw,
+        component: valueAfter(argv, "--component") ?? undefined,
+        force: argv.includes("--force")
+    });
+    const ok = result.status === "created";
+    if (wantsJson) {
+        process.stdout.write(rendered(createCliResult("init", result, {
+            ok,
+            complete: ok,
+            diagnostics: result.diagnostics,
+            workspaceRoot: repoRoot,
+            dataRoot: repoRoot,
+            componentId: result.component_id
+        })));
+    }
+    else if (ok) {
+        const lines = [
+            `Scaffolded a Use Cases workspace in ${repoRoot}`,
+            `  template:  ${result.template}`,
+            `  component: ${result.component_id}`,
+            "  created:",
+            ...result.created_files.map((file) => `    - ${file}`),
+            "",
+            "Next steps:",
+            ...result.next_steps.map((step, index) => `  ${index + 1}. ${step}`),
+            ""
+        ];
+        process.stdout.write(`${lines.join("\n")}\n`);
+    }
+    else {
+        process.stderr.write(`${result.diagnostics[0]?.message ?? "uc init failed."}\n`);
+    }
+    if (ok) {
+        return 0;
+    }
+    return result.diagnostics.some((item) => item.code === "init.path_escape") ? 4 : 1;
+}
+// ---------------------------------------------------------------------------
+// Phase 7 use-case-marker commands (bind / scan / prove / validate-ledger).
+// Thin wiring: parse argv, resolve paths + injected key material, call the core.
+// ---------------------------------------------------------------------------
+// Minimal ULID-shaped id for registry/proof event ids (uniqueness from the tail).
+// SECURITY: reject a user-supplied id that is not a canonical id BEFORE it can
+// become a filesystem path segment (e.g. showcase-runs/<runId>/events.jsonl) or a
+// ledger lookup key. Returns the stable UCM_INVALID_ID / exit-2 invalid-arguments
+// envelope. Returns null when the value is safe, so callers read it as a guard.
+// SECURITY: bound a user-supplied file path (e.g. --plan-file) to the workspace,
+// symlink-safe, BEFORE it is read from disk. Returns the safe absolute path, or an
+// { exitCode } carrying the stable UCM_PATH_ESCAPE / exit-4 envelope on escape.
+function writeError(command, code, message, exitCode = 2) {
+    process.stdout.write(rendered(createCliResult(command, {}, {
+        ok: false,
+        complete: false,
+        diagnostics: [
+            {
+                code,
+                severity: "error",
+                message,
+                source_path: null,
+                json_pointer: null,
+                entity_id: null,
+                related_ids: []
+            }
+        ]
+    })));
+    return exitCode;
+}
+//# sourceMappingURL=builtins.js.map

package/packages/cli/dist/builtins.js.map

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

package/packages/cli/dist/command/dispatch.d.ts

@@ -0,0 +1,4 @@
+import type { CliCommand } from "./types.js";
+export declare function matchCommand(commands: readonly CliCommand[], argv: string[]): CliCommand | null;
+export declare function runRegistryCommand(command: CliCommand, argv: string[], json: boolean): number;
+//# sourceMappingURL=dispatch.d.ts.map

package/packages/cli/dist/command/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/command/dispatch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAc/F;AAMD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAgB7F"}

package/packages/cli/dist/command/dispatch.js

@@ -0,0 +1,45 @@
+import { parseFlags } from "../args/parse.js";
+import { renderEnvelope } from "../render.js";
+import { caughtErrorEnvelope } from "../runtime.js";
+// Find the command whose token path is the longest prefix of argv. Two-token
+// paths (e.g. ["matrix","validate"]) win over a one-token group, so a registered
+// leaf is matched precisely; unmatched argv returns null and the caller falls
+// through to the legacy dispatcher.
+export function matchCommand(commands, argv) {
+    let best = null;
+    for (const command of commands) {
+        if (command.path.length > argv.length) {
+            continue;
+        }
+        if (!command.path.every((token, index) => argv[index] === token)) {
+            continue;
+        }
+        if (best === null || command.path.length > best.path.length) {
+            best = command;
+        }
+    }
+    return best;
+}
+// Run a matched registry command: parse its flags, invoke the handler, render
+// the returned envelope (JSON or human per `json`), and return the exit code.
+// Output happens HERE, never in the handler, so rendering stays centralized and
+// byte-identical with the legacy path.
+export function runRegistryCommand(command, argv, json) {
+    const id = command.path.join(".");
+    let envelope;
+    let exitCode;
+    try {
+        const flags = parseFlags(argv, command.flags);
+        ({ envelope, exitCode } = command.handler({ argv, flags, json }));
+    }
+    catch (error) {
+        // A handler that throws (config parse failure, malformed signing key, any
+        // UseCasesPluginError) becomes the standard ok:false envelope instead of an
+        // uncaught stack trace. Exit 1 = "command failed" per the stability policy.
+        envelope = caughtErrorEnvelope(id, error);
+        exitCode = 1;
+    }
+    process.stdout.write(renderEnvelope(envelope, json));
+    return exitCode;
+}
+//# sourceMappingURL=dispatch.js.map

package/packages/cli/dist/command/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/command/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,6EAA6E;AAC7E,iFAAiF;AACjF,8EAA8E;AAC9E,oCAAoC;AACpC,MAAM,UAAU,YAAY,CAAC,QAA+B,EAAE,IAAc;IAC1E,IAAI,IAAI,GAAsB,IAAI,CAAC;IACnC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACjE,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5D,IAAI,GAAG,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAChF,uCAAuC;AACvC,MAAM,UAAU,kBAAkB,CAAC,OAAmB,EAAE,IAAc,EAAE,IAAa;IACnF,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,QAAiB,CAAC;IACtB,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0EAA0E;QAC1E,4EAA4E;QAC5E,4EAA4E;QAC5E,QAAQ,GAAG,mBAAmB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1C,QAAQ,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IACrD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/packages/cli/dist/command/help-catalog.d.ts

@@ -0,0 +1,13 @@
+import type { CliCommand } from "./types.js";
+export type UsageFlag = {
+    flag: string;
+    summary: string;
+};
+export type UsageEntry = {
+    name: string;
+    summary: string;
+    flags: UsageFlag[];
+};
+export declare const BUILTIN_USAGE: UsageEntry[];
+export declare function buildUsageCatalog(commands: CliCommand[]): UsageEntry[];
+//# sourceMappingURL=help-catalog.d.ts.map

package/packages/cli/dist/command/help-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-catalog.d.ts","sourceRoot":"","sources":["../../src/command/help-catalog.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,YAAY,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC;AAK/E,eAAO,MAAM,aAAa,EAAE,UAAU,EAarC,CAAC;AAuBF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAItE"}

package/packages/cli/dist/command/help-catalog.js

@@ -0,0 +1,42 @@
+// The non-registry builtins (version / init). These emit bespoke, non-envelope
+// output and never pass through the registry dispatcher, so they have no
+// FlagSpec to derive from — they are authored here verbatim.
+export const BUILTIN_USAGE = [
+    { name: "version", summary: "Print the CLI version.", flags: [{ flag: "--json", summary: "Emit the version envelope." }] },
+    {
+        name: "init",
+        summary: "Scaffold a Use Cases workspace.",
+        flags: [
+            { flag: "--repo <path>", summary: "Target directory to scaffold into." },
+            { flag: "--template <name>", summary: "generic | js-vitest | python-pytest | go-test." },
+            { flag: "--component <id>", summary: "Component id to seed." },
+            { flag: "--force", summary: "Overwrite existing scaffold files." },
+            { flag: "--json", summary: "Emit the JSON result envelope." }
+        ]
+    }
+];
+// Render a single FlagSpec as a usage `flag` string: boolean flags are bare
+// (`--ci`), value-bearing flags append their placeholder (`--repo <path>`).
+function toUsageFlag(flag) {
+    return {
+        flag: flag.kind === "boolean" ? flag.name : `${flag.name} ${flag.valueName ?? ""}`.trim(),
+        summary: flag.summary
+    };
+}
+// Project one registry command into a UsageEntry. Hidden flags are dropped from
+// the generated help (they stay dispatchable).
+function toUsageEntry(command) {
+    return {
+        name: command.path.join(" "),
+        summary: command.summary,
+        flags: command.flags.filter((flag) => !flag.hidden).map(toUsageFlag)
+    };
+}
+// The full usage catalog: the hand-authored builtins followed by every registry
+// command projected from its declarative spec.
+export function buildUsageCatalog(commands) {
+    // Hidden commands stay dispatchable but are omitted from generated help (e.g.
+    // maintainer-only release tooling that users should not reach for).
+    return [...BUILTIN_USAGE, ...commands.filter((command) => !command.hidden).map(toUsageEntry)];
+}
+//# sourceMappingURL=help-catalog.js.map

package/packages/cli/dist/command/help-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-catalog.js","sourceRoot":"","sources":["../../src/command/help-catalog.ts"],"names":[],"mappings":"AAWA,+EAA+E;AAC/E,yEAAyE;AACzE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,EAAE;IAC1H;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,iCAAiC;QAC1C,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,oCAAoC,EAAE;YACxE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,gDAAgD,EAAE;YACxF,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,uBAAuB,EAAE;YAC9D,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,oCAAoC,EAAE;YAClE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gCAAgC,EAAE;SAC9D;KACF;CACF,CAAC;AAEF,4EAA4E;AAC5E,4EAA4E;AAC5E,SAAS,WAAW,CAAC,IAAc;IACjC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;QACzF,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,+CAA+C;AAC/C,SAAS,YAAY,CAAC,OAAmB;IACvC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;KACrE,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,+CAA+C;AAC/C,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,8EAA8E;IAC9E,oEAAoE;IACpE,OAAO,CAAC,GAAG,aAAa,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;AAChG,CAAC"}

package/packages/cli/dist/command/registry.d.ts

@@ -0,0 +1,3 @@
+import type { CliCommand } from "./types.js";
+export declare const allCommands: CliCommand[];
+//# sourceMappingURL=registry.d.ts.map

package/packages/cli/dist/command/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/command/registry.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,eAAO,MAAM,WAAW,EAAE,UAAU,EAcnC,CAAC"}

package/packages/cli/dist/command/registry.js

@@ -0,0 +1,33 @@
+import { capsuleCommands } from "../commands/capsule.js";
+import { doctorCommands } from "../commands/doctor.js";
+import { evidenceCommands } from "../commands/evidence.js";
+import { hostCommands } from "../commands/host.js";
+import { keygenCommands } from "../commands/keygen.js";
+import { markersCommands } from "../commands/markers.js";
+import { matrixCommands } from "../commands/matrix.js";
+import { migrateCommands } from "../commands/migrate.js";
+import { planCommands } from "../commands/plan.js";
+import { recoverCommands } from "../commands/recover.js";
+import { schemaCommands } from "../commands/schema.js";
+import { showcaseCommands } from "../commands/showcase.js";
+import { workflowCommands } from "../commands/workflow.js";
+// The declarative command registry. Anything not listed here falls through to the
+// builtins fallback (builtins.ts); each registered command is parity-verified to
+// stay byte-identical. Handled as builtins, NOT registry commands: version /
+// init / help (bespoke non-envelope output) — kept there permanently.
+export const allCommands = [
+    ...schemaCommands,
+    ...matrixCommands,
+    ...planCommands,
+    ...capsuleCommands,
+    ...evidenceCommands,
+    ...workflowCommands,
+    ...migrateCommands,
+    ...hostCommands,
+    ...doctorCommands,
+    ...markersCommands,
+    ...keygenCommands,
+    ...recoverCommands,
+    ...showcaseCommands
+];
+//# sourceMappingURL=registry.js.map

package/packages/cli/dist/command/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/command/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,kFAAkF;AAClF,iFAAiF;AACjF,6EAA6E;AAC7E,sEAAsE;AACtE,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,GAAG,cAAc;IACjB,GAAG,cAAc;IACjB,GAAG,YAAY;IACf,GAAG,eAAe;IAClB,GAAG,gBAAgB;IACnB,GAAG,gBAAgB;IACnB,GAAG,eAAe;IAClB,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,eAAe;IAClB,GAAG,cAAc;IACjB,GAAG,eAAe;IAClB,GAAG,gBAAgB;CACpB,CAAC"}

package/packages/cli/dist/command/types.d.ts

@@ -0,0 +1,32 @@
+export type CommandPath = readonly [string, ...string[]];
+export type FlagKind = "boolean" | "string" | "integer";
+export interface FlagSpec {
+    readonly key: string;
+    readonly name: `--${string}`;
+    readonly kind: FlagKind;
+    readonly summary: string;
+    readonly valueName?: string;
+    readonly repeatable?: boolean;
+    readonly required?: boolean;
+    readonly hidden?: boolean;
+}
+export type ParsedFlags = Record<string, string | string[] | number | boolean | undefined>;
+export interface HandlerContext {
+    readonly argv: string[];
+    readonly flags: ParsedFlags;
+    readonly json: boolean;
+}
+export interface CommandOutput {
+    readonly envelope: unknown;
+    readonly exitCode: number;
+}
+export type CliHandler = (context: HandlerContext) => CommandOutput;
+export interface CliCommand {
+    readonly path: CommandPath;
+    readonly command: string;
+    readonly summary: string;
+    readonly flags: readonly FlagSpec[];
+    readonly handler: CliHandler;
+    readonly hidden?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/cli/dist/command/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/command/types.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAEzD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAMxD,MAAM,WAAW,QAAQ;IAEvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;AAE3F,MAAM,WAAW,cAAc;IAG7B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAKD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,aAAa,CAAC;AAEpE,MAAM,WAAW,UAAU;IAEzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAG3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/packages/cli/dist/command/types.js

@@ -0,0 +1,6 @@
+// Declarative command model. Each leaf CLI command is data: a token path, a
+// flag spec, and a handler that maps parsed args to a result envelope. Dispatch,
+// arg-parsing, and help all derive from this — replacing the legacy if-chains,
+// the 175 inline arg reads, and the hand-maintained USAGE table.
+export {};
+//# sourceMappingURL=types.js.map

package/packages/cli/dist/command/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/command/types.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,iFAAiF;AACjF,+EAA+E;AAC/E,iEAAiE"}

package/packages/cli/dist/commands/capsule.d.ts

@@ -0,0 +1,7 @@
+import type { CliCommand } from "../command/types.js";
+export declare const capsuleListCommand: CliCommand;
+export declare const capsuleValidateCommand: CliCommand;
+export declare const capsulePlanCommand: CliCommand;
+export declare const capsuleRunCommand: CliCommand;
+export declare const capsuleCommands: CliCommand[];
+//# sourceMappingURL=capsule.d.ts.map

package/packages/cli/dist/commands/capsule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsule.d.ts","sourceRoot":"","sources":["../../src/commands/capsule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,qBAAqB,CAAC;AA8CrE,eAAO,MAAM,kBAAkB,EAAE,UAqChC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,UAuBpC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,UA+BhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,UA4C/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,UAAU,EAKvC,CAAC"}