jumbo-cli 1.0.0-beta.0

package/dist/presentation/cli/shared/program/ProgramFactory.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Program Factory
+ *
+ * Creates and configures the Commander.js program instance.
+ * Centralizes CLI structure: name, version, usage, and help formatting.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProgram = createProgram;
+const commander_1 = require("commander");
+const CategoryFormatter_js_1 = require("../help/CategoryFormatter.js");
+/**
+ * Creates a configured Commander program instance.
+ *
+ * @param version - CLI version string
+ * @param commands - Registered commands for categorized help
+ * @returns Configured Commander program
+ */
+function createProgram(version, commands) {
+    const program = new commander_1.Command();
+    program
+        .name("jumbo")
+        .version(version)
+        .usage("<command> <subcommand> [flags]")
+        .configureHelp({
+        // Align option descriptions to start at column 26 (matching command descriptions)
+        // Formula: 2 (indent) + padWidth + 2 (gap) = 26, so padWidth = 22
+        padWidth: () => 22,
+    });
+    // Override help to show categorized commands (gh-style)
+    const originalHelp = program.helpInformation.bind(program);
+    program.helpInformation = function () {
+        // Get original help and capitalize section headers
+        let help = originalHelp().replace(/^Options:/gm, "OPTIONS:");
+        // Replace the default "Commands:" section with categorized version
+        const commandsRegex = /^Commands:[\s\S]*$/m;
+        const match = help.match(commandsRegex);
+        if (match) {
+            // Generate categorized commands section
+            const categorizedCommands = (0, CategoryFormatter_js_1.formatCategorizedCommands)(commands);
+            // Replace entire Commands section with our categorized version
+            help = help.replace(commandsRegex, categorizedCommands);
+        }
+        return help + "\n\n";
+    };
+    return program;
+}
+//# sourceMappingURL=ProgramFactory.js.map

package/dist/presentation/cli/shared/program/ProgramFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramFactory.js","sourceRoot":"","sources":["../../../../../src/presentation/cli/shared/program/ProgramFactory.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAaH,sCAsCC;AAjDD,yCAAoC;AAEpC,uEAAyE;AAEzE;;;;;;GAMG;AACH,SAAgB,aAAa,CAC3B,OAAe,EACf,QAA6B;IAE7B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,OAAO,CAAC;SACb,OAAO,CAAC,OAAO,CAAC;SAChB,KAAK,CAAC,gCAAgC,CAAC;SACvC,aAAa,CAAC;QACb,kFAAkF;QAClF,kEAAkE;QAClE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE;KACnB,CAAC,CAAC;IAEL,wDAAwD;IACxD,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,OAAO,CAAC,eAAe,GAAG;QACxB,mDAAmD;QACnD,IAAI,IAAI,GAAG,YAAY,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAE7D,mEAAmE;QACnE,MAAM,aAAa,GAAG,qBAAqB,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAExC,IAAI,KAAK,EAAE,CAAC;YACV,wCAAwC;YACxC,MAAM,mBAAmB,GAAG,IAAA,gDAAyB,EAAC,QAAQ,CAAC,CAAC;YAEhE,+DAA+D;YAC/D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,IAAI,GAAG,MAAM,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/presentation/cli/shared/prompts/InteractivePromptService.d.ts

@@ -0,0 +1,97 @@
+/**
+ * InteractivePromptService
+ *
+ * Provides reusable interactive prompt utilities for CLI commands.
+ * Uses Inquirer.js for checkbox selections and text inputs.
+ * Designed to be generic and work with any entity type.
+ */
+/**
+ * Configuration for entity selection prompts
+ */
+export interface EntitySelectionConfig<T> {
+    /** Message displayed above the checkbox list */
+    message: string;
+    /** Optional suffix with additional instructions */
+    suffix?: string;
+    /** Function to format each entity for display */
+    formatter: (entity: T) => string;
+    /** Message to display when no entities are available */
+    emptyMessage?: string;
+}
+/**
+ * Result of an entity selection prompt
+ */
+export interface EntitySelectionResult<T> {
+    /** Whether the prompt was shown (false if entities list was empty) */
+    prompted: boolean;
+    /** The selected entities in their original form */
+    selected: T[];
+}
+/**
+ * Configuration for text input prompts
+ */
+export interface TextInputConfig {
+    /** Message displayed for the input */
+    message: string;
+    /** Optional suffix with additional instructions */
+    suffix?: string;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Custom validation function */
+    validate?: (input: string) => boolean | string;
+}
+/**
+ * Configuration for multi-value text input prompts
+ */
+export interface MultiTextInputConfig {
+    /** Message displayed for the input */
+    message: string;
+    /** Optional suffix with additional instructions */
+    suffix?: string;
+    /** Separator for splitting input (default: comma) */
+    separator?: string;
+    /** Minimum number of values required (default: 0) */
+    minValues?: number;
+}
+export declare class InteractivePromptService {
+    /**
+     * Prompts user to select multiple entities from a checkbox list.
+     * Returns the selected entities in their original form.
+     *
+     * @param entities - Array of entities to present for selection
+     * @param config - Configuration for the prompt
+     * @returns Selected entities and whether the prompt was shown
+     */
+    selectEntities<T>(entities: T[], config: EntitySelectionConfig<T>): Promise<EntitySelectionResult<T>>;
+    /**
+     * Prompts user for a single text input.
+     *
+     * @param config - Configuration for the prompt
+     * @returns The entered text (trimmed), or undefined if empty and not required
+     */
+    textInput(config: TextInputConfig): Promise<string | undefined>;
+    /**
+     * Prompts user for multiple text values via comma-separated (or custom separator) input.
+     *
+     * @param config - Configuration for the prompt
+     * @returns Array of entered values (trimmed and filtered for empty)
+     */
+    multiTextInput(config: MultiTextInputConfig): Promise<string[]>;
+    /**
+     * Displays an informational message (for non-interactive displays like decisions).
+     *
+     * @param title - Section title
+     * @param items - Items to display
+     * @param formatter - Function to format each item for display
+     */
+    displayInfo<T>(title: string, items: T[], formatter: (item: T) => string): void;
+    /**
+     * Parses a multi-value string into an array of trimmed, non-empty values.
+     */
+    private parseMultiValue;
+    /**
+     * Truncates a string for the "short" display in checkbox selections.
+     */
+    private truncateForShort;
+}
+//# sourceMappingURL=InteractivePromptService.d.ts.map

package/dist/presentation/cli/shared/prompts/InteractivePromptService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractivePromptService.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/shared/prompts/InteractivePromptService.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,sEAAsE;IACtE,QAAQ,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,QAAQ,EAAE,CAAC,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,wBAAwB;IACnC;;;;;;;OAOG;IACG,cAAc,CAAC,CAAC,EACpB,QAAQ,EAAE,CAAC,EAAE,EACb,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAoCpC;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA2BrE;;;;;OAKG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BrE;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI;IAY/E;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAMzB"}

package/dist/presentation/cli/shared/prompts/InteractivePromptService.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * InteractivePromptService
+ *
+ * Provides reusable interactive prompt utilities for CLI commands.
+ * Uses Inquirer.js for checkbox selections and text inputs.
+ * Designed to be generic and work with any entity type.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractivePromptService = void 0;
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+class InteractivePromptService {
+    /**
+     * Prompts user to select multiple entities from a checkbox list.
+     * Returns the selected entities in their original form.
+     *
+     * @param entities - Array of entities to present for selection
+     * @param config - Configuration for the prompt
+     * @returns Selected entities and whether the prompt was shown
+     */
+    async selectEntities(entities, config) {
+        // Add spacing before prompt
+        console.log();
+        // Handle empty entity list gracefully
+        if (entities.length === 0) {
+            if (config.emptyMessage) {
+                console.log(chalk_1.default.dim(config.emptyMessage));
+            }
+            return { prompted: false, selected: [] };
+        }
+        // Build choices with original entity stored as value
+        const choices = entities.map((entity, index) => ({
+            name: config.formatter(entity),
+            value: index, // Store index to retrieve original entity
+            short: this.truncateForShort(config.formatter(entity)),
+        }));
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: "checkbox",
+                name: "selection",
+                message: chalk_1.default.cyan(config.message),
+                suffix: config.suffix ? `\n${chalk_1.default.dim(config.suffix)}` : undefined,
+                choices,
+            },
+        ]);
+        // Map selected indices back to original entities
+        const selectedIndices = answers.selection;
+        const selected = selectedIndices.map((index) => entities[index]);
+        return { prompted: true, selected };
+    }
+    /**
+     * Prompts user for a single text input.
+     *
+     * @param config - Configuration for the prompt
+     * @returns The entered text (trimmed), or undefined if empty and not required
+     */
+    async textInput(config) {
+        // Add spacing before prompt
+        console.log();
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: "input",
+                name: "value",
+                message: chalk_1.default.cyan(config.message),
+                suffix: config.suffix ? `\n${chalk_1.default.dim(config.suffix)}` : undefined,
+                validate: (input) => {
+                    const trimmed = input.trim();
+                    if (config.required && !trimmed) {
+                        return "This field is required";
+                    }
+                    if (config.validate) {
+                        return config.validate(trimmed);
+                    }
+                    return true;
+                },
+            },
+        ]);
+        const trimmed = answers.value.trim();
+        return trimmed || undefined;
+    }
+    /**
+     * Prompts user for multiple text values via comma-separated (or custom separator) input.
+     *
+     * @param config - Configuration for the prompt
+     * @returns Array of entered values (trimmed and filtered for empty)
+     */
+    async multiTextInput(config) {
+        // Add spacing before prompt
+        console.log();
+        const separator = config.separator ?? ",";
+        const minValues = config.minValues ?? 0;
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: "input",
+                name: "value",
+                message: chalk_1.default.cyan(config.message),
+                suffix: config.suffix ? `\n${chalk_1.default.dim(config.suffix)}` : undefined,
+                validate: (input) => {
+                    const values = this.parseMultiValue(input, separator);
+                    if (values.length < minValues) {
+                        return `At least ${minValues} value(s) required`;
+                    }
+                    return true;
+                },
+            },
+        ]);
+        return this.parseMultiValue(answers.value, separator);
+    }
+    /**
+     * Displays an informational message (for non-interactive displays like decisions).
+     *
+     * @param title - Section title
+     * @param items - Items to display
+     * @param formatter - Function to format each item for display
+     */
+    displayInfo(title, items, formatter) {
+        if (items.length === 0) {
+            return;
+        }
+        console.log();
+        console.log(chalk_1.default.yellow(title));
+        items.forEach((item) => {
+            console.log(chalk_1.default.dim(`  - ${formatter(item)}`));
+        });
+    }
+    /**
+     * Parses a multi-value string into an array of trimmed, non-empty values.
+     */
+    parseMultiValue(input, separator) {
+        return input
+            .split(separator)
+            .map((v) => v.trim())
+            .filter((v) => v.length > 0);
+    }
+    /**
+     * Truncates a string for the "short" display in checkbox selections.
+     */
+    truncateForShort(text, maxLength = 40) {
+        if (text.length <= maxLength) {
+            return text;
+        }
+        return text.substring(0, maxLength - 3) + "...";
+    }
+}
+exports.InteractivePromptService = InteractivePromptService;
+//# sourceMappingURL=InteractivePromptService.js.map

package/dist/presentation/cli/shared/prompts/InteractivePromptService.js.map

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

package/dist/presentation/cli/shared/prompts/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Interactive prompts module
+ *
+ * Provides reusable interactive prompt utilities for CLI commands.
+ */
+export { InteractivePromptService, EntitySelectionConfig, EntitySelectionResult, TextInputConfig, MultiTextInputConfig, } from "./InteractivePromptService.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/presentation/cli/shared/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/shared/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,GACrB,MAAM,+BAA+B,CAAC"}

package/dist/presentation/cli/shared/prompts/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Interactive prompts module
+ *
+ * Provides reusable interactive prompt utilities for CLI commands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractivePromptService = void 0;
+var InteractivePromptService_js_1 = require("./InteractivePromptService.js");
+Object.defineProperty(exports, "InteractivePromptService", { enumerable: true, get: function () { return InteractivePromptService_js_1.InteractivePromptService; } });
+//# sourceMappingURL=index.js.map

package/dist/presentation/cli/shared/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/presentation/cli/shared/prompts/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6EAMuC;AALrC,uIAAA,wBAAwB,OAAA"}

package/dist/presentation/cli/shared/registry/CommandMetadata.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Command Metadata Model
+ *
+ * Formalized model for command metadata that enables:
+ * - Self-documenting commands
+ * - Consistent CLI behavior
+ * - Auto-generated help text
+ * - Build-time command discovery
+ */
+/**
+ * Command option definition
+ */
+export interface CommandOption {
+    /** Option flags (e.g., "--goal-id <goalId>" or "-g, --goal-id <goalId>") */
+    flags: string;
+    /** Human-readable description of what this option does */
+    description: string;
+    /** Default value if not provided (only for optional options) */
+    default?: string | number | boolean;
+}
+/**
+ * Usage example for a command
+ */
+export interface CommandExample {
+    /** Example command invocation */
+    command: string;
+    /** What this example demonstrates */
+    description: string;
+}
+/**
+ * Command category for organizing help output
+ */
+export type CommandCategory = "project-knowledge" | "relations" | "solution" | "work";
+/**
+ * Complete command metadata
+ */
+export interface CommandMetadata {
+    /** Command description (shown in help) */
+    description: string;
+    /** Category for grouping in help output (gh-style organization) */
+    category?: CommandCategory;
+    /** Required options (command will error if not provided) */
+    requiredOptions?: CommandOption[];
+    /** Optional options */
+    options?: CommandOption[];
+    /** Usage examples (shown in detailed help) */
+    examples?: CommandExample[];
+    /** Related commands (for discoverability) */
+    related?: string[];
+    /** Hide from main help (for deprecated/experimental commands) */
+    hidden?: boolean;
+    /** Top-level command aliases (e.g., ["init"] makes "jumbo init" work like "jumbo project init") */
+    topLevelAliases?: string[];
+    /**
+     * Whether this command requires an initialized Jumbo project to run.
+     * @default true - Most commands require project context
+     * Set to false for commands like "project init" that bootstrap a new project.
+     */
+    requiresProject?: boolean;
+}
+/**
+ * Registered command with handler
+ * Generated at build time by scanning command files
+ */
+export interface RegisteredCommand {
+    /** Command path (e.g., "goal start", "project init") */
+    path: string;
+    /** Command metadata */
+    metadata: CommandMetadata;
+    /** Command handler function */
+    handler: (...args: any[]) => Promise<void>;
+}
+/**
+ * Convention: Command file paths map to command paths
+ *
+ * File: work/goal.start.ts
+ *   → Parent: "goal" (from filename prefix)
+ *   → Subcommand: "start" (from filename suffix)
+ *   → Full path: "goal start"
+ *
+ * File: project-knowledge/project.init.ts
+ *   → Parent: "project"
+ *   → Subcommand: "init"
+ *   → Full path: "project init"
+ */
+export declare function parseCommandPath(filePath: string): {
+    parent: string;
+    subcommand: string;
+};
+//# sourceMappingURL=CommandMetadata.d.ts.map

package/dist/presentation/cli/shared/registry/CommandMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandMetadata.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/shared/registry/CommandMetadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IAEd,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,mBAAmB,GACnB,WAAW,GACX,UAAU,GACV,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IAEpB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B,4DAA4D;IAC5D,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAElC,uBAAuB;IACvB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAE1B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAE5B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,mGAAmG;IACnG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IAEb,uBAAuB;IACvB,QAAQ,EAAE,eAAe,CAAC;IAE1B,+BAA+B;IAC/B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAezF"}

package/dist/presentation/cli/shared/registry/CommandMetadata.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Command Metadata Model
+ *
+ * Formalized model for command metadata that enables:
+ * - Self-documenting commands
+ * - Consistent CLI behavior
+ * - Auto-generated help text
+ * - Build-time command discovery
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCommandPath = parseCommandPath;
+/**
+ * Convention: Command file paths map to command paths
+ *
+ * File: work/goal.start.ts
+ *   → Parent: "goal" (from filename prefix)
+ *   → Subcommand: "start" (from filename suffix)
+ *   → Full path: "goal start"
+ *
+ * File: project-knowledge/project.init.ts
+ *   → Parent: "project"
+ *   → Subcommand: "init"
+ *   → Full path: "project init"
+ */
+function parseCommandPath(filePath) {
+    // Extract filename without extension: "goal.start.ts" → "goal.start"
+    const filename = filePath.split('/').pop()?.replace(/\.ts$/, '') || '';
+    // Split on dot: "goal.start" → ["goal", "start"]
+    const parts = filename.split('.');
+    if (parts.length !== 2) {
+        throw new Error(`Invalid command filename: ${filePath}. Expected format: <parent>.<subcommand>.ts`);
+    }
+    return {
+        parent: parts[0],
+        subcommand: parts[1]
+    };
+}
+//# sourceMappingURL=CommandMetadata.js.map

package/dist/presentation/cli/shared/registry/CommandMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandMetadata.js","sourceRoot":"","sources":["../../../../../src/presentation/cli/shared/registry/CommandMetadata.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAoGH,4CAeC;AA5BD;;;;;;;;;;;;GAYG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,qEAAqE;IACrE,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IAEvE,iDAAiD;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,6CAA6C,CAAC,CAAC;IACtG,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAChB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;KACrB,CAAC;AACJ,CAAC"}

package/dist/presentation/cli/shared/registry/CommanderApplicator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Commander.js Applicator
+ *
+ * Applies framework-agnostic command metadata to Commander.js.
+ * This is ONE adapter - future: InkApplicator for React TUI.
+ */
+import { Command } from "commander";
+import { RegisteredCommand } from "./CommandMetadata.js";
+import { ApplicationContainer } from "../../../../infrastructure/composition/bootstrap.js";
+/**
+ * Applies registered commands to Commander.js
+ */
+export declare class CommanderApplicator {
+    private parentCommands;
+    private container?;
+    private program?;
+    apply(program: Command, commands: RegisteredCommand[], container?: ApplicationContainer): void;
+    private groupByParent;
+    private createParentCommand;
+    private registerCommand;
+    private formatExamples;
+    private formatRelated;
+    /**
+     * Registers top-level aliases for a command
+     * e.g., "init" as alias for "project init"
+     */
+    private registerTopLevelAliases;
+}
+//# sourceMappingURL=CommanderApplicator.d.ts.map

package/dist/presentation/cli/shared/registry/CommanderApplicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommanderApplicator.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/shared/registry/CommanderApplicator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAE3F;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,SAAS,CAAC,CAAuB;IACzC,OAAO,CAAC,OAAO,CAAC,CAAU;IAE1B,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,EAAE,SAAS,CAAC,EAAE,oBAAoB,GAAG,IAAI;IAe9F,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,eAAe;IA+CvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IAIrB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;CAqDhC"}