@mimir-labs/cli 0.1.0

package/dist/dx/about/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/dx/about/command.ts"],"names":[],"mappings":";;AAoDA,oDAuCC;AA1FD,qDAO+B;AAC/B,qEAAgE;AAChE,qDAAiD;AACjD,gDAAoD;AAapD,SAAS,cAAc,CAAC,OAAgB;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB;IACzC,OAAO;QACL,KAAK,EAAE,qBAAS;QAChB,QAAQ,EAAE,6BAAiB;QAC3B,MAAM,EAAE,2BAAe;QACvB,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;QAChC,gBAAgB,EAAE;YAChB,IAAA,sBAAU,EAAC,MAAM,CAAC;YAClB,IAAA,sBAAU,EAAC,UAAU,CAAC;YACtB,IAAA,sBAAU,EAAC,UAAU,CAAC;YACtB,IAAA,sBAAU,EAAC,YAAY,CAAC;YACxB,IAAA,sBAAU,EAAC,QAAQ,CAAC;SACrB;QACD,gBAAgB,EAAE;YAChB,gCAAgC;YAChC,IAAA,sBAAU,EAAC,UAAU,CAAC;YACtB,IAAA,sBAAU,EAAC,MAAM,CAAC;SACnB;QACD,IAAI,EAAE,iCAAqB;QAC3B,UAAU,EAAE,8BAAkB;KAC/B,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAgB;IACnD,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,0DAA0D,CAAC;SACvE,MAAM,CAAC,QAAQ,EAAE,yCAAyC,CAAC;SAC3D,MAAM,CAAC,CAAC,OAA2B,EAAE,aAAsB,EAAE,EAAE;QAC9D,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAEjD,IAAI,IAAA,wBAAc,EAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,IAAA,sBAAS,EAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CACT,KAAK,OAAO,CAAC,QAAQ,iHAAiH,CACvI,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEL,IAAA,uCAAiB,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/dx/branding/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const CLI_BRAND = "Mimir CLI";
+export declare const CLI_BINARY_NAME = "mimir";
+export declare const CLI_PROTOCOL_NAME = "APS Protocol";
+export declare const CLI_REPOSITORY_URL = "https://github.com/SeaBassLab/mimir";
+export declare const CLI_DOC_RELATIVE_PATH = "README.md";
+export declare function cliCommand(command?: string): string;

package/dist/dx/branding/constants.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_DOC_RELATIVE_PATH = exports.CLI_REPOSITORY_URL = exports.CLI_PROTOCOL_NAME = exports.CLI_BINARY_NAME = exports.CLI_BRAND = void 0;
+exports.cliCommand = cliCommand;
+exports.CLI_BRAND = "Mimir CLI";
+exports.CLI_BINARY_NAME = "mimir";
+exports.CLI_PROTOCOL_NAME = "APS Protocol";
+exports.CLI_REPOSITORY_URL = "https://github.com/SeaBassLab/mimir";
+exports.CLI_DOC_RELATIVE_PATH = "README.md";
+function cliCommand(command) {
+    return command ? `${exports.CLI_BINARY_NAME} ${command}` : exports.CLI_BINARY_NAME;
+}
+//# sourceMappingURL=constants.js.map

package/dist/dx/branding/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/dx/branding/constants.ts"],"names":[],"mappings":";;;AAMA,gCAEC;AARY,QAAA,SAAS,GAAG,WAAW,CAAC;AACxB,QAAA,eAAe,GAAG,OAAO,CAAC;AAC1B,QAAA,iBAAiB,GAAG,cAAc,CAAC;AACnC,QAAA,kBAAkB,GAAG,qCAAqC,CAAC;AAC3D,QAAA,qBAAqB,GAAG,WAAW,CAAC;AAEjD,SAAgB,UAAU,CAAC,OAAgB;IACzC,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,uBAAe,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,uBAAe,CAAC;AACrE,CAAC"}

package/dist/dx/command-registry/index.d.ts

@@ -0,0 +1,25 @@
+export type DxFlag = {
+    name: string;
+    description: string;
+};
+export type DxExitCode = {
+    code: number;
+    meaning: string;
+};
+export type DxCommandMeta = {
+    name: string;
+    description: string;
+    usage: string;
+    examples: string[];
+    flags: DxFlag[];
+    aliases: string[];
+    hidden: boolean;
+    category: "core" | "diagnostics" | "workflow" | "dx";
+    notes: string[];
+    exitCodes: DxExitCode[];
+    subcommands: string[];
+};
+export declare function getCommandRegistry(): DxCommandMeta[];
+export declare function findCommandMeta(commandName: string): DxCommandMeta | undefined;
+export declare function listVisibleCommandNames(): string[];
+export declare function listAllFlags(): string[];

package/dist/dx/command-registry/index.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCommandRegistry = getCommandRegistry;
+exports.findCommandMeta = findCommandMeta;
+exports.listVisibleCommandNames = listVisibleCommandNames;
+exports.listAllFlags = listAllFlags;
+const constants_1 = require("../branding/constants");
+const COMMANDS = [
+    {
+        name: "init",
+        description: "Initialize APS support in package.json",
+        usage: `${(0, constants_1.cliCommand)("init")} [--json] [--dry-run]`,
+        examples: [(0, constants_1.cliCommand)("init"), `${(0, constants_1.cliCommand)("init")} --dry-run`, `${(0, constants_1.cliCommand)("init")} --json`],
+        flags: [{ name: "--json", description: "Emit deterministic machine-readable result." }],
+        aliases: [],
+        hidden: false,
+        category: "core",
+        notes: ["Creates or completes the aps section in package.json."],
+        exitCodes: [
+            { code: 0, meaning: "APS config initialized or already present." },
+            { code: 1, meaning: "Initialization failed (missing package.json or invalid JSON)." }
+        ],
+        subcommands: []
+    },
+    {
+        name: "generate",
+        description: "Generate APS resources from package evidence",
+        usage: `${(0, constants_1.cliCommand)("generate")} [--json] [--force]`,
+        examples: [(0, constants_1.cliCommand)("generate"), `${(0, constants_1.cliCommand)("generate")} --force`, `${(0, constants_1.cliCommand)("generate")} --json`],
+        flags: [
+            { name: "--json", description: "Emit machine-readable generation report." },
+            { name: "--force", description: "Replace existing generated resources in dist/aps." }
+        ],
+        aliases: [],
+        hidden: false,
+        category: "workflow",
+        notes: ["Does not overwrite existing generated output unless --force is provided."],
+        exitCodes: [
+            { code: 0, meaning: "Generation completed and validation passed." },
+            { code: 1, meaning: "Generation failed or validation failed." }
+        ],
+        subcommands: []
+    },
+    {
+        name: "discover",
+        description: "Discover APS-enabled dependencies and load APS manifests",
+        usage: `${(0, constants_1.cliCommand)("discover")} [--json]`,
+        examples: [(0, constants_1.cliCommand)("discover"), `${(0, constants_1.cliCommand)("discover")} --json`],
+        flags: [{ name: "--json", description: "Emit deterministic machine-readable discovery result." }],
+        aliases: [],
+        hidden: false,
+        category: "core",
+        notes: ["Inspects dependencies and devDependencies from package.json."],
+        exitCodes: [
+            { code: 0, meaning: "Discovery completed." },
+            { code: 1, meaning: "Discovery failed." }
+        ],
+        subcommands: []
+    },
+    {
+        name: "validate",
+        description: "Validate APS compliance for current package",
+        usage: `${(0, constants_1.cliCommand)("validate")} [--json]`,
+        examples: [(0, constants_1.cliCommand)("validate"), `${(0, constants_1.cliCommand)("validate")} --json`],
+        flags: [{ name: "--json", description: "Emit deterministic machine-readable validation result." }],
+        aliases: [],
+        hidden: false,
+        category: "core",
+        notes: ["Checks package APS config, manifest schema, and declared resource paths."],
+        exitCodes: [
+            { code: 0, meaning: "Validation passed." },
+            { code: 1, meaning: "Validation failed." }
+        ],
+        subcommands: []
+    },
+    {
+        name: "governance",
+        description: "Validate provenance, evidence, lifecycle and trust rules for published knowledge",
+        usage: `${(0, constants_1.cliCommand)("governance")} [--json]`,
+        examples: [(0, constants_1.cliCommand)("governance"), `${(0, constants_1.cliCommand)("governance")} --json`],
+        flags: [{ name: "--json", description: "Emit machine-readable governance result." }],
+        aliases: [],
+        hidden: false,
+        category: "diagnostics",
+        notes: ["Runs governance validators over the configured APS manifest."],
+        exitCodes: [
+            { code: 0, meaning: "Governance validation passed." },
+            { code: 1, meaning: "Governance validation failed." }
+        ],
+        subcommands: []
+    },
+    {
+        name: "doctor",
+        description: "Evaluate APS provider maturity (L0-L3)",
+        usage: `${(0, constants_1.cliCommand)("doctor")} [--json]`,
+        examples: [(0, constants_1.cliCommand)("doctor"), `${(0, constants_1.cliCommand)("doctor")} --json`],
+        flags: [{ name: "--json", description: "Emit machine-readable doctor report." }],
+        aliases: [],
+        hidden: false,
+        category: "diagnostics",
+        notes: ["Returns non-zero when maturity is below maximum."],
+        exitCodes: [
+            { code: 0, meaning: "All discovered providers reached maximum maturity." },
+            { code: 1, meaning: "At least one provider is below maximum maturity or execution failed." }
+        ],
+        subcommands: []
+    },
+    {
+        name: "sync",
+        description: "Synchronize APS context to configured AI agent adapters",
+        usage: `${(0, constants_1.cliCommand)("sync")} [--json] [--dry-run]`,
+        examples: [(0, constants_1.cliCommand)("sync"), `${(0, constants_1.cliCommand)("sync")} --dry-run`, `${(0, constants_1.cliCommand)("sync")} --json`],
+        flags: [{ name: "--json", description: "Emit deterministic machine-readable sync result." }],
+        aliases: [],
+        hidden: false,
+        category: "workflow",
+        notes: ["Sync reports adapter status and keeps user-authored content untouched."],
+        exitCodes: [
+            { code: 0, meaning: "Sync completed." },
+            { code: 1, meaning: "Sync failed." }
+        ],
+        subcommands: []
+    },
+    {
+        name: "context",
+        description: "Generate AI agent context from discovered APS packages",
+        usage: `${(0, constants_1.cliCommand)("context")} [--json] [--dry-run]`,
+        examples: [(0, constants_1.cliCommand)("context"), `${(0, constants_1.cliCommand)("context")} --dry-run`, `${(0, constants_1.cliCommand)("context")} --json`],
+        flags: [{ name: "--json", description: "Emit deterministic machine-readable context result." }],
+        aliases: [],
+        hidden: false,
+        category: "workflow",
+        notes: ["Generates local context files and updates AGENTS.md managed section."],
+        exitCodes: [
+            { code: 0, meaning: "Context generation completed." },
+            { code: 1, meaning: "Context generation failed." }
+        ],
+        subcommands: []
+    },
+    {
+        name: "completion",
+        description: "Print shell completion scripts",
+        usage: `${(0, constants_1.cliCommand)("completion")} <bash|zsh|fish|powershell>`,
+        examples: [
+            `${(0, constants_1.cliCommand)("completion")} bash`,
+            `${(0, constants_1.cliCommand)("completion")} zsh`,
+            `${(0, constants_1.cliCommand)("completion")} fish`,
+            `${(0, constants_1.cliCommand)("completion")} powershell`
+        ],
+        flags: [],
+        aliases: [],
+        hidden: false,
+        category: "dx",
+        notes: ["Prints completion scripts to stdout; does not install automatically."],
+        exitCodes: [
+            { code: 0, meaning: "Script printed successfully." },
+            { code: 2, meaning: "Unsupported or missing shell argument." }
+        ],
+        subcommands: ["bash", "zsh", "fish", "powershell"]
+    },
+    {
+        name: "about",
+        description: "Show an overview of APS Protocol and Mimir CLI workflows",
+        usage: `${(0, constants_1.cliCommand)("about")} [--json]`,
+        examples: [(0, constants_1.cliCommand)("about"), `${(0, constants_1.cliCommand)("about")} --json`],
+        flags: [{ name: "--json", description: "Emit machine-readable about information." }],
+        aliases: [],
+        hidden: false,
+        category: "dx",
+        notes: ["Good starting point for first-time CLI users."],
+        exitCodes: [
+            { code: 0, meaning: "About information displayed." },
+            { code: 1, meaning: "About command failed unexpectedly." }
+        ],
+        subcommands: []
+    },
+    {
+        name: "help",
+        description: "Show Mimir CLI help",
+        usage: `${(0, constants_1.cliCommand)("help")} [command]`,
+        examples: [(0, constants_1.cliCommand)("help"), `${(0, constants_1.cliCommand)("help")} generate`, `${(0, constants_1.cliCommand)("help")} completion`],
+        flags: [],
+        aliases: [],
+        hidden: false,
+        category: "dx",
+        notes: [`Use ${constants_1.CLI_BINARY_NAME} <command> --help for command-specific quick help.`],
+        exitCodes: [
+            { code: 0, meaning: "Help displayed." },
+            { code: 2, meaning: "Unknown command name provided." }
+        ],
+        subcommands: [
+            "init",
+            "generate",
+            "discover",
+            "validate",
+            "governance",
+            "doctor",
+            "sync",
+            "context",
+            "completion",
+            "about",
+            "help"
+        ]
+    }
+];
+function getCommandRegistry() {
+    return [...COMMANDS];
+}
+function findCommandMeta(commandName) {
+    const normalized = commandName.trim().toLowerCase();
+    return COMMANDS.find((command) => command.name === normalized || command.aliases.includes(normalized));
+}
+function listVisibleCommandNames() {
+    return COMMANDS.filter((command) => !command.hidden)
+        .map((command) => command.name)
+        .sort((a, b) => a.localeCompare(b));
+}
+function listAllFlags() {
+    const flags = new Set([
+        "--help",
+        "--version",
+        "--json",
+        "--dry-run",
+        "--verbose",
+        "--quiet"
+    ]);
+    for (const command of COMMANDS) {
+        for (const flag of command.flags) {
+            flags.add(flag.name);
+        }
+    }
+    return [...flags].sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=index.js.map

package/dist/dx/command-registry/index.js.map

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

package/dist/dx/completion/command.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerCompletionCommand(program: Command): void;

package/dist/dx/completion/command.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCompletionCommand = registerCompletionCommand;
+const attach_command_help_1 = require("../help/attach-command-help");
+const scripts_1 = require("./scripts");
+const constants_1 = require("../branding/constants");
+const cli_output_1 = require("../output/cli-output");
+function isSupportedShell(value) {
+    return value === "bash" || value === "zsh" || value === "fish" || value === "powershell";
+}
+function buildScript(shell) {
+    switch (shell) {
+        case "bash":
+            return (0, scripts_1.buildBashCompletionScript)();
+        case "zsh":
+            return (0, scripts_1.buildZshCompletionScript)();
+        case "fish":
+            return (0, scripts_1.buildFishCompletionScript)();
+        case "powershell":
+            return (0, scripts_1.buildPowerShellCompletionScript)();
+        default:
+            return "";
+    }
+}
+function registerCompletionCommand(program) {
+    const command = program
+        .command("completion [shell]")
+        .description("Print shell completion scripts")
+        .action((shell) => {
+        if (!shell) {
+            (0, cli_output_1.errorMessage)(`missing shell argument. Use '${constants_1.CLI_BINARY_NAME} completion <bash|zsh|fish|powershell>'.`);
+            (0, cli_output_1.setExitCode)(cli_output_1.EXIT_CODES.USAGE_ERROR);
+            return;
+        }
+        const normalized = shell.trim().toLowerCase();
+        if (!isSupportedShell(normalized)) {
+            (0, cli_output_1.errorMessage)(`unsupported shell '${shell}'. Expected: bash, zsh, fish, powershell.`);
+            (0, cli_output_1.setExitCode)(cli_output_1.EXIT_CODES.USAGE_ERROR);
+            return;
+        }
+        console.log(buildScript(normalized));
+    });
+    (0, attach_command_help_1.attachCommandHelp)(command, "completion");
+}
+//# sourceMappingURL=command.js.map

package/dist/dx/completion/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/dx/completion/command.ts"],"names":[],"mappings":";;AAgCA,8DAsBC;AArDD,qEAAgE;AAChE,uCAKmB;AACnB,qDAAwD;AACxD,qDAA6E;AAI7E,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,YAAY,CAAC;AAC3F,CAAC;AAED,SAAS,WAAW,CAAC,KAAqB;IACxC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO,IAAA,mCAAyB,GAAE,CAAC;QACrC,KAAK,KAAK;YACR,OAAO,IAAA,kCAAwB,GAAE,CAAC;QACpC,KAAK,MAAM;YACT,OAAO,IAAA,mCAAyB,GAAE,CAAC;QACrC,KAAK,YAAY;YACf,OAAO,IAAA,yCAA+B,GAAE,CAAC;QAC3C;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAgB,yBAAyB,CAAC,OAAgB;IACxD,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,CAAC,KAAc,EAAE,EAAE;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAA,yBAAY,EAAC,gCAAgC,2BAAe,0CAA0C,CAAC,CAAC;YACxG,IAAA,wBAAW,EAAC,uBAAU,CAAC,WAAW,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,IAAA,yBAAY,EAAC,sBAAsB,KAAK,2CAA2C,CAAC,CAAC;YACrF,IAAA,wBAAW,EAAC,uBAAU,CAAC,WAAW,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEL,IAAA,uCAAiB,EAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAC3C,CAAC"}

package/dist/dx/completion/scripts.d.ts

@@ -0,0 +1,4 @@
+export declare function buildBashCompletionScript(): string;
+export declare function buildZshCompletionScript(): string;
+export declare function buildFishCompletionScript(): string;
+export declare function buildPowerShellCompletionScript(): string;

package/dist/dx/completion/scripts.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBashCompletionScript = buildBashCompletionScript;
+exports.buildZshCompletionScript = buildZshCompletionScript;
+exports.buildFishCompletionScript = buildFishCompletionScript;
+exports.buildPowerShellCompletionScript = buildPowerShellCompletionScript;
+const command_registry_1 = require("../command-registry");
+const constants_1 = require("../branding/constants");
+function escapeForSingleQuotes(value) {
+    return value.replace(/'/g, "''");
+}
+function buildCommandFlagsMapShell() {
+    const entries = (0, command_registry_1.getCommandRegistry)()
+        .map((command) => {
+        const flags = command.flags.map((flag) => flag.name).join(" ");
+        const subcommands = command.subcommands.join(" ");
+        return `    ${command.name}) echo \"${[flags, subcommands].filter(Boolean).join(" ")}\" ;;`;
+    })
+        .join("\n");
+    return entries;
+}
+function buildBashCompletionScript() {
+    const commands = (0, command_registry_1.listVisibleCommandNames)().join(" ");
+    const globalFlags = (0, command_registry_1.listAllFlags)().join(" ");
+    return `# Mimir completion for bash
+_mimir_completion() {
+  local cur prev first
+  COMPREPLY=()
+  cur="${"${COMP_WORDS[COMP_CWORD]}"}"
+  prev="${"${COMP_WORDS[COMP_CWORD-1]}"}"
+  first="${"${COMP_WORDS[1]}"}"
+
+  if [[ $COMP_CWORD -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "${commands} ${globalFlags}" -- "$cur") )
+    return 0
+  fi
+
+  local cmd_flags
+  case "$first" in
+${buildCommandFlagsMapShell()}
+    *) cmd_flags="" ;;
+  esac
+
+  COMPREPLY=( $(compgen -W "$cmd_flags ${globalFlags}" -- "$cur") )
+  return 0
+}
+
+complete -F _mimir_completion ${constants_1.CLI_BINARY_NAME}
+`;
+}
+function buildZshCompletionScript() {
+    const commands = (0, command_registry_1.listVisibleCommandNames)()
+        .map((command) => `'${command}:${command}'`)
+        .join(" ");
+    const commandCase = (0, command_registry_1.getCommandRegistry)()
+        .map((command) => {
+        const allArgs = [...command.flags.map((flag) => flag.name), ...command.subcommands];
+        if (allArgs.length === 0) {
+            return `      ${command.name}) _values 'options' ;;`;
+        }
+        return `      ${command.name}) _values 'options' ${allArgs
+            .map((item) => `'${item}[${item}]'`)
+            .join(" ")} ;;`;
+    })
+        .join("\n");
+    return `#compdef ${constants_1.CLI_BINARY_NAME}
+
+_mimir() {
+  local -a commands
+  commands=(${commands})
+
+  if (( CURRENT == 2 )); then
+    _describe 'command' commands
+    return
+  fi
+
+  local cmd="$words[2]"
+  case "$cmd" in
+${commandCase}
+    *) _values 'global options' '--help[Show help]' '--version[Show version]' ;;
+  esac
+}
+
+_mimir "$@"
+`;
+}
+function buildFishCompletionScript() {
+    const commandLines = (0, command_registry_1.listVisibleCommandNames)()
+        .map((command) => `complete -c ${constants_1.CLI_BINARY_NAME} -f -n '__fish_use_subcommand' -a '${command}'`)
+        .join("\n");
+    const argumentLines = (0, command_registry_1.getCommandRegistry)()
+        .flatMap((command) => {
+        const items = [...command.flags.map((flag) => flag.name), ...command.subcommands];
+        return items.map((item) => `complete -c ${constants_1.CLI_BINARY_NAME} -f -n '__fish_seen_subcommand_from ${command.name}' -a '${escapeForSingleQuotes(item)}'`);
+    })
+        .join("\n");
+    return `# Mimir completion for fish
+${commandLines}
+
+${argumentLines}
+`;
+}
+function buildPowerShellCompletionScript() {
+    const commands = (0, command_registry_1.listVisibleCommandNames)();
+    const commandMap = (0, command_registry_1.getCommandRegistry)().reduce((acc, command) => {
+        acc[command.name] = [...command.flags.map((flag) => flag.name), ...command.subcommands];
+        return acc;
+    }, {});
+    const commandArray = commands.map((command) => `'${command}'`).join(", ");
+    const commandCases = commands
+        .map((command) => {
+        const items = (commandMap[command] ?? []).map((item) => `'${item}'`).join(", ");
+        return `      '${command}' { $suggestions = @(${items}) }`;
+    })
+        .join("\n");
+    return `Register-ArgumentCompleter -Native -CommandName ${constants_1.CLI_BINARY_NAME} -ScriptBlock {
+  param($wordToComplete, $commandAst, $cursorPosition)
+
+  $tokens = $commandAst.CommandElements | ForEach-Object { $_.Extent.Text }
+  $commands = @(${commandArray})
+
+  if ($tokens.Count -le 2) {
+    $commands | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+      [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+    }
+    return
+  }
+
+  $command = $tokens[1]
+  $suggestions = @()
+
+  switch ($command) {
+${commandCases}
+      default { $suggestions = @('--help', '--version') }
+  }
+
+  $suggestions | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+  }
+}
+`;
+}
+//# sourceMappingURL=scripts.js.map

package/dist/dx/completion/scripts.js.map

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

package/dist/dx/help/attach-command-help.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function attachCommandHelp(command: Command, commandName: string): void;

package/dist/dx/help/attach-command-help.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attachCommandHelp = attachCommandHelp;
+const command_registry_1 = require("../command-registry");
+const formatter_1 = require("./formatter");
+function attachCommandHelp(command, commandName) {
+    const meta = (0, command_registry_1.findCommandMeta)(commandName);
+    if (!meta) {
+        return;
+    }
+    command.addHelpText("after", (0, formatter_1.formatDetailedHelp)(meta));
+}
+//# sourceMappingURL=attach-command-help.js.map

package/dist/dx/help/attach-command-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-command-help.js","sourceRoot":"","sources":["../../../src/dx/help/attach-command-help.ts"],"names":[],"mappings":";;AAIA,8CAOC;AAVD,0DAAsD;AACtD,2CAAiD;AAEjD,SAAgB,iBAAiB,CAAC,OAAgB,EAAE,WAAmB;IACrE,MAAM,IAAI,GAAG,IAAA,kCAAe,EAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IAED,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,IAAA,8BAAkB,EAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/dx/help/command.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerHelpCommand(program: Command): void;

package/dist/dx/help/command.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHelpCommand = registerHelpCommand;
+const attach_command_help_1 = require("./attach-command-help");
+const command_registry_1 = require("../command-registry");
+const formatter_1 = require("./formatter");
+const constants_1 = require("../branding/constants");
+const cli_output_1 = require("../output/cli-output");
+function printGeneralHelp() {
+    const registry = (0, command_registry_1.getCommandRegistry)().filter((command) => !command.hidden);
+    console.log(constants_1.CLI_BRAND);
+    console.log(`Reference implementation CLI for the ${constants_1.CLI_PROTOCOL_NAME}`);
+    console.log("");
+    console.log("Commands:");
+    const maxLen = Math.max(...registry.map((command) => command.name.length));
+    for (const command of registry) {
+        const padded = command.name.padEnd(maxLen, " ");
+        console.log(`- ${padded}  ${command.description}`);
+    }
+    console.log("");
+    console.log("Quick examples:");
+    console.log(`- ${(0, constants_1.cliCommand)("about")}`);
+    console.log(`- ${(0, constants_1.cliCommand)("init")}`);
+    console.log(`- ${(0, constants_1.cliCommand)("generate")} --force`);
+    console.log(`- ${(0, constants_1.cliCommand)("validate")}`);
+    console.log(`- ${(0, constants_1.cliCommand)("governance")} --json`);
+    console.log(`- ${(0, constants_1.cliCommand)("doctor")} --json`);
+    console.log(`- ${(0, constants_1.cliCommand)("completion")} zsh`);
+    console.log("");
+    console.log("Docs:");
+    console.log(`- ${constants_1.CLI_DOC_RELATIVE_PATH}`);
+    console.log("");
+    console.log("Global options:");
+    console.log("- --json      Emit deterministic JSON output");
+    console.log("- --dry-run   Show planned actions without changing files");
+    console.log("- --verbose   Enable verbose output");
+    console.log("- --quiet     Suppress non-error output");
+    console.log("");
+    console.log(`Use '${(0, constants_1.cliCommand)("help")} <command>' for detailed command help.`);
+}
+function registerHelpCommand(program) {
+    const command = program
+        .command("help [commandName]")
+        .description("Show Mimir CLI help")
+        .action((commandName) => {
+        if (!commandName || commandName.trim() === "") {
+            printGeneralHelp();
+            return;
+        }
+        const target = program.commands.find((candidate) => candidate.name() === commandName ||
+            candidate.aliases().includes(commandName) ||
+            (commandName === "help" && candidate.name() === "help"));
+        if (!target) {
+            (0, cli_output_1.errorMessage)(`unknown command '${commandName}'.`);
+            console.error(`Available commands: ${(0, command_registry_1.listVisibleCommandNames)().join(", ")}`);
+            (0, cli_output_1.setExitCode)(cli_output_1.EXIT_CODES.USAGE_ERROR);
+            return;
+        }
+        const baseHelp = target.helpInformation();
+        const meta = (0, command_registry_1.findCommandMeta)(commandName);
+        if (!meta) {
+            console.log(baseHelp);
+            return;
+        }
+        const details = (0, formatter_1.formatDetailedHelp)(meta);
+        const alreadyIncludesDetails = baseHelp.includes(`Name: ${constants_1.CLI_BINARY_NAME} ${meta.name}`);
+        if (alreadyIncludesDetails) {
+            console.log(baseHelp);
+            return;
+        }
+        console.log(`${baseHelp.trimEnd()}\n${details}`);
+    });
+    (0, attach_command_help_1.attachCommandHelp)(command, "help");
+}
+//# sourceMappingURL=command.js.map

package/dist/dx/help/command.js.map

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

package/dist/dx/help/formatter.d.ts

@@ -0,0 +1,2 @@
+import type { DxCommandMeta } from "../command-registry";
+export declare function formatDetailedHelp(meta: DxCommandMeta): string;