@lwelliott/cortex-cli 1.0.3

package/dist/cli/project.js

@@ -0,0 +1,169 @@
+"use strict";
+// CLI commands for project group
+// Implements plan §5.1: Project Commands
+// Updated per SAD-0039: selectFormat() + formatOutput() pipeline integration
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProjectCommand = createProjectCommand;
+exports.registerProjectCommand = registerProjectCommand;
+exports.removeProjectCommand = removeProjectCommand;
+exports.listProjectCommand = listProjectCommand;
+exports.defaultProjectCommand = defaultProjectCommand;
+exports.infoProjectCommand = infoProjectCommand;
+exports.createProjectGroup = createProjectGroup;
+const commander_1 = require("commander");
+const project_1 = require("../services/project");
+const format_1 = require("../utils/format");
+const format_selector_1 = require("./format-selector");
+const errors_1 = require("../utils/errors");
+/**
+ * Resolve format for error output, falling back to 'table' if resolution fails.
+ */
+function resolveErrorFormat(cmd, isShowCommand) {
+    try {
+        return (0, format_selector_1.selectFormat)(cmd.optsWithGlobals(), isShowCommand);
+    }
+    catch {
+        return 'table';
+    }
+}
+function createProjectCommand() {
+    return new commander_1.Command('create')
+        .description('Create a new project')
+        .argument('<name>', 'Project name')
+        .argument('<folder>', 'Project folder path')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Quiet output')
+        .action((name, folder, _options, cmd) => {
+        try {
+            const opts = cmd.optsWithGlobals();
+            const format = (0, format_selector_1.selectFormat)(opts, false);
+            const result = (0, project_1.createProject)(name, folder);
+            console.log((0, format_selector_1.formatOutput)((0, format_1.formatProjectResult)(result), format, 'project'));
+        }
+        catch (err) {
+            console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), resolveErrorFormat(cmd, false)));
+            process.exit(1);
+        }
+    });
+}
+function registerProjectCommand() {
+    return new commander_1.Command('register')
+        .description('Register an existing project folder')
+        .argument('<name>', 'Project name')
+        .argument('<folder>', 'Project folder path')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Quiet output')
+        .action((name, folder, _options, cmd) => {
+        try {
+            const opts = cmd.optsWithGlobals();
+            const format = (0, format_selector_1.selectFormat)(opts, false);
+            const result = (0, project_1.registerProject)(name, folder);
+            console.log((0, format_selector_1.formatOutput)((0, format_1.formatProjectResult)(result), format, 'project'));
+        }
+        catch (err) {
+            console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), resolveErrorFormat(cmd, false)));
+            process.exit(1);
+        }
+    });
+}
+function removeProjectCommand() {
+    return new commander_1.Command('remove')
+        .description('Remove a project from the registry (preserves database)')
+        .argument('<name>', 'Project name')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Quiet output')
+        .action((name, _options, cmd) => {
+        try {
+            const opts = cmd.optsWithGlobals();
+            const format = (0, format_selector_1.selectFormat)(opts, false);
+            const result = (0, project_1.removeProject)(name);
+            console.log((0, format_selector_1.formatOutput)((0, format_1.formatProjectRemoval)(result.name, result.dbPath), format, 'project'));
+        }
+        catch (err) {
+            console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), resolveErrorFormat(cmd, false)));
+            process.exit(1);
+        }
+    });
+}
+function listProjectCommand() {
+    return new commander_1.Command('list')
+        .description('List all registered projects')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Quiet output')
+        .action((_options, cmd) => {
+        try {
+            const opts = cmd.optsWithGlobals();
+            const format = (0, format_selector_1.selectFormat)(opts, false);
+            const registry = (0, project_1.listAllProjects)();
+            console.log((0, format_selector_1.formatOutput)((0, format_1.formatProjectList)(registry), format, 'project'));
+        }
+        catch (err) {
+            console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), resolveErrorFormat(cmd, false)));
+            process.exit(1);
+        }
+    });
+}
+function defaultProjectCommand() {
+    return new commander_1.Command('default')
+        .description('Set or show the default project')
+        .argument('[name]', 'Project name (omit to show current default)')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Quiet output')
+        .action((name, _options, cmd) => {
+        try {
+            const opts = cmd.optsWithGlobals();
+            const format = (0, format_selector_1.selectFormat)(opts, false);
+            if (name) {
+                (0, project_1.setProjectDefault)(name);
+                console.log((0, format_selector_1.formatOutput)((0, format_1.formatDefaultProject)(name), format, 'project'));
+            }
+            else {
+                const currentDefault = (0, project_1.getDefaultProjectName)();
+                console.log((0, format_selector_1.formatOutput)((0, format_1.formatDefaultProject)(currentDefault), format, 'project'));
+            }
+        }
+        catch (err) {
+            console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), resolveErrorFormat(cmd, false)));
+            process.exit(1);
+        }
+    });
+}
+function infoProjectCommand() {
+    return new commander_1.Command('info')
+        .description('Show project details')
+        .argument('[name]', 'Project name (uses default if omitted)')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Quiet output')
+        .action((name, _options, cmd) => {
+        try {
+            const opts = cmd.optsWithGlobals();
+            const format = (0, format_selector_1.selectFormat)(opts, true);
+            // If name is not provided, try to resolve the default project
+            const projectName = name ?? (0, project_1.getDefaultProjectName)();
+            if (!projectName) {
+                throw new errors_1.ProjectNotFoundError('(no default set)');
+            }
+            const info = (0, project_1.getProjectInfo)(projectName);
+            console.log((0, format_selector_1.formatOutput)((0, format_1.formatProjectInfo)(info), format, 'project'));
+        }
+        catch (err) {
+            console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), resolveErrorFormat(cmd, true)));
+            process.exit(1);
+        }
+    });
+}
+/**
+ * Create the project command group with all subcommands.
+ */
+function createProjectGroup() {
+    const cmd = new commander_1.Command('project')
+        .description('Manage projects');
+    cmd.addCommand(createProjectCommand());
+    cmd.addCommand(registerProjectCommand());
+    cmd.addCommand(removeProjectCommand());
+    cmd.addCommand(listProjectCommand());
+    cmd.addCommand(defaultProjectCommand());
+    cmd.addCommand(infoProjectCommand());
+    return cmd;
+}
+//# sourceMappingURL=project.js.map

package/dist/cli/project.js.map

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

package/dist/cli/relation.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createRelationGroup(): Command;
+//# sourceMappingURL=relation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/cli/relation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,mBAAmB,IAAI,OAAO,CAqC7C"}

package/dist/cli/relation.js

@@ -0,0 +1,128 @@
+"use strict";
+// CLI subcommands for relation group
+// SAD-0003: MOD-010 Graph Relations
+// SAD-0035: Updated to reference documents instead of entities
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRelationGroup = createRelationGroup;
+const commander_1 = require("commander");
+const graph_service_1 = require("../services/graph-service");
+const graph_service_2 = require("../services/graph-service");
+const connection_1 = require("../db/connection");
+const migration_1 = require("../db/migration");
+const project_resolver_1 = require("./project-resolver");
+const format_selector_1 = require("./format-selector");
+function run(fn, optsOrCmd) {
+    try {
+        const opts = optsOrCmd instanceof commander_1.Command ? optsOrCmd.optsWithGlobals() : optsOrCmd;
+        console.log(fn(opts));
+    }
+    catch (err) {
+        const opts = optsOrCmd instanceof commander_1.Command ? optsOrCmd.optsWithGlobals() : optsOrCmd;
+        const format = (0, format_selector_1.selectFormat)(opts);
+        console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), format));
+        process.exit(1);
+    }
+}
+function createRelationGroup() {
+    const group = new commander_1.Command('relation').description('Graph relation management');
+    // relation create
+    group.command('create')
+        .description('Create a relation between two documents')
+        .requiredOption('--from <id>', 'Source document ID')
+        .requiredOption('--type <relType>', 'Relation type name')
+        .requiredOption('--to <id>', 'Target document ID')
+        .option('--props <json>', 'Properties as JSON')
+        .action((_opts, cmd) => run(handleCreate, cmd));
+    // relation remove
+    group.command('remove')
+        .description('Remove a relation by ID')
+        .argument('<id>', 'Relation ID (numeric)')
+        .action((id, _opts, cmd) => run((o) => handleRemove(parseInt(id, 10), o), cmd));
+    // relation query
+    group.command('query')
+        .description('Query relations for a document')
+        .requiredOption('--entity <id>', 'Document ID')
+        .option('--type <relType>', 'Filter by relation type')
+        .option('--direction <dir>', 'Direction: outgoing, incoming, both', 'both')
+        .option('--limit <n>', 'Max results', '100')
+        .option('--offset <n>', 'Offset', '0')
+        .action((_opts, cmd) => run(handleQuery, cmd));
+    // relation related (convenience: shows related documents)
+    group.command('related')
+        .description('Get documents related to a given document')
+        .argument('<id>', 'Document ID')
+        .option('--type <relType>', 'Filter by relation type')
+        .option('--direction <dir>', 'Direction: outgoing, incoming, both', 'outgoing')
+        .action((id, _opts, cmd) => run((o) => handleRelated(id, o), cmd));
+    return group;
+}
+function handleCreate(opts) {
+    const fromId = opts.from;
+    const relType = opts.type;
+    const toId = opts.to;
+    const props = opts.props ? JSON.parse(opts.props) : undefined;
+    const format = (0, format_selector_1.selectFormat)(opts);
+    const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+    const db = (0, connection_1.openConnection)(resolved.dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+        (0, graph_service_2.ensureBuiltinSchemaInitialized)(db);
+        const relation = (0, graph_service_1.createRelation)(db, fromId, relType, toId, props);
+        return (0, format_selector_1.formatOutput)(relation, format);
+    }
+    finally {
+        db.close();
+    }
+}
+function handleRemove(id, opts) {
+    const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+    const db = (0, connection_1.openConnection)(resolved.dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+        (0, graph_service_2.ensureBuiltinSchemaInitialized)(db);
+        (0, graph_service_1.removeRelation)(db, id);
+        return `Relation ${id} removed (inverse also removed if applicable)`;
+    }
+    finally {
+        db.close();
+    }
+}
+function handleQuery(opts) {
+    const entityId = opts.entity;
+    const format = (0, format_selector_1.selectFormat)(opts);
+    const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+    const db = (0, connection_1.openConnection)(resolved.dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+        (0, graph_service_2.ensureBuiltinSchemaInitialized)(db);
+        const relations = (0, graph_service_1.queryRelations)(db, {
+            entityId,
+            relType: opts.type,
+            direction: opts.direction ?? 'both',
+            limit: parseInt(opts.limit, 10),
+            offset: parseInt(opts.offset, 10),
+        });
+        return (0, format_selector_1.formatOutput)(relations, format, 'relation');
+    }
+    finally {
+        db.close();
+    }
+}
+function handleRelated(entityId, opts) {
+    const format = (0, format_selector_1.selectFormat)(opts);
+    const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+    const db = (0, connection_1.openConnection)(resolved.dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+        (0, graph_service_2.ensureBuiltinSchemaInitialized)(db);
+        const related = (0, graph_service_1.getRelatedDocuments)(db, entityId, {
+            relType: opts.type,
+            direction: opts.direction ?? 'outgoing',
+        });
+        return (0, format_selector_1.formatOutput)(related, format, 'relation-related', { parentEntityId: entityId });
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=relation.js.map

package/dist/cli/relation.js.map

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

package/dist/cli/review.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createReviewGroup(): Command;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/cli/review.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,iBAAiB,IAAI,OAAO,CAyG3C"}

package/dist/cli/review.js

@@ -0,0 +1,131 @@
+"use strict";
+// CLI subcommands for review group
+// SAD-0031: Explicit Command IDs — --id required for review add
+// SAD-0010: Review show requires --sprint, --content-file replaces --content
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReviewGroup = createReviewGroup;
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const review_service_1 = require("../services/review-service");
+const sprint_1 = require("../services/sprint");
+const connection_1 = require("../db/connection");
+const migration_1 = require("../db/migration");
+const project_resolver_1 = require("./project-resolver");
+const format_selector_1 = require("./format-selector");
+const errors_1 = require("../utils/errors");
+function run(fn, optsOrCmd) {
+    try {
+        const opts = optsOrCmd instanceof commander_1.Command ? optsOrCmd.optsWithGlobals() : optsOrCmd;
+        console.log(fn(opts));
+    }
+    catch (err) {
+        const opts = optsOrCmd instanceof commander_1.Command ? optsOrCmd.optsWithGlobals() : optsOrCmd;
+        const format = (0, format_selector_1.selectFormat)({ quiet: opts.quiet, json: opts.json, format: opts.format });
+        console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), format));
+        process.exit(1);
+    }
+}
+function createReviewGroup() {
+    const group = new commander_1.Command('review').description('Review management');
+    // review add — uses --content-file (atomic import) and positional <id> (SAD-0031/FS-SS-028-0001)
+    group.command('add')
+        .description('Add a review')
+        .argument('<id>', 'Review ID (4-digit zero-padded, e.g., 0001)')
+        .option('--sprint <id>', 'Sprint ID')
+        .requiredOption('--type <type>', 'Review type (requirements, architecture, code, test, document)')
+        .requiredOption('--verdict <v>', 'Verdict (APPROVED, NEEDS_REWORK, OPEN_QUESTION)')
+        .requiredOption('--content-file <path>', 'File to read review content from')
+        .option('--asset-name <name>', 'Asset name')
+        .option('--asset-ref <ref>', 'Asset reference path')
+        .option('--critical <n>', 'Critical findings count', '0')
+        .option('--major <n>', 'Major findings count', '0')
+        .option('--minor <n>', 'Minor findings count', '0')
+        .option('--suggestion <n>', 'Suggestion count', '0')
+        .action((reviewId, _opts, _cmd) => {
+        run((opts) => {
+            const format = (0, format_selector_1.selectFormat)(opts);
+            const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+            const db = (0, connection_1.openConnection)(resolved.dbPath);
+            const contentFilePath = opts.contentFile;
+            try {
+                (0, migration_1.initializeSchema)(db);
+                // Step 1: Read content file (before transaction — fail fast)
+                let content;
+                try {
+                    content = (0, fs_1.readFileSync)(contentFilePath, 'utf-8');
+                }
+                catch {
+                    throw new errors_1.ReviewContentFileNotFoundError(contentFilePath);
+                }
+                const sprintId = (0, sprint_1.resolveSprint)(db, opts.sprint).id;
+                // Steps 3-5: DB write + commit
+                const result = (0, review_service_1.addReview)(db, sprintId, reviewId, opts.type, opts.verdict, content, {
+                    assetName: opts.assetName,
+                    assetRef: opts.assetRef,
+                    critical: Number(opts.critical),
+                    major: Number(opts.major),
+                    minor: Number(opts.minor),
+                    suggestion: Number(opts.suggestion),
+                });
+                // Step 6: Delete file after successful commit
+                try {
+                    (0, fs_1.unlinkSync)(contentFilePath);
+                }
+                catch { /* best effort */ }
+                return (0, format_selector_1.formatOutput)(result, format, 'review');
+            }
+            finally {
+                // File preserved on failure by not reaching Step 6 delete
+                db.close();
+            }
+        }, _cmd);
+    });
+    // review list
+    group.command('list')
+        .description('List reviews')
+        .option('--sprint <id>', 'Sprint ID')
+        .option('--type <type>', 'Filter by review type')
+        .option('--verdict <v>', 'Filter by verdict')
+        .action((_opts, _cmd) => {
+        run((opts) => {
+            const format = (0, format_selector_1.selectFormat)(opts);
+            const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+            const db = (0, connection_1.openConnection)(resolved.dbPath);
+            try {
+                (0, migration_1.initializeSchema)(db);
+                const sprintId = (0, sprint_1.resolveSprint)(db, opts.sprint).id;
+                const results = (0, review_service_1.listReviews)(db, sprintId, {
+                    type: opts.type,
+                    verdict: opts.verdict,
+                });
+                return (0, format_selector_1.formatOutput)(results, format, 'review');
+            }
+            finally {
+                db.close();
+            }
+        }, _cmd);
+    });
+    // review show — --sprint required (SAD-0010 Part C)
+    group.command('show')
+        .description('Show review detail')
+        .argument('<id>', 'Review number')
+        .option('--sprint <id>', 'Sprint ID')
+        .action((id, _opts, _cmd) => {
+        run((opts) => {
+            const format = (0, format_selector_1.selectFormat)(opts, true); // isShowCommand = true → default markdown
+            const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+            const db = (0, connection_1.openConnection)(resolved.dbPath);
+            try {
+                (0, migration_1.initializeSchema)(db);
+                const sprintId = (0, sprint_1.resolveSprint)(db, opts.sprint).id;
+                const result = (0, review_service_1.getReview)(db, Number(id), sprintId);
+                return (0, format_selector_1.formatOutput)(result, format, 'review');
+            }
+            finally {
+                db.close();
+            }
+        }, _cmd);
+    });
+    return group;
+}
+//# sourceMappingURL=review.js.map

package/dist/cli/review.js.map

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

package/dist/cli/router.d.ts

@@ -0,0 +1,38 @@
+import type { OutputFormat } from '../models/common';
+/** Handler function signature */
+export type CommandHandler = (db: import('better-sqlite3').Database, format: OutputFormat, args: Record<string, unknown>) => string | void;
+/** Route definition */
+export interface Route {
+    subcommand: string;
+    action: string;
+    handler: CommandHandler;
+}
+/** Router registry */
+export declare class CommandRouter {
+    private routes;
+    /**
+     * Register a route.
+     */
+    register(subcommand: string, action: string, handler: CommandHandler): void;
+    /**
+     * Register multiple routes for a subcommand.
+     */
+    registerAll(subcommand: string, routes: Array<{
+        action: string;
+        handler: CommandHandler;
+    }>): void;
+    /**
+     * Find all actions for a subcommand.
+     */
+    getActions(subcommand: string): string[];
+    /**
+     * Find the handler for a subcommand and action.
+     * Returns null if not found.
+     */
+    resolve(subcommand: string, action: string): CommandHandler | null;
+    /**
+     * Get all registered subcommands.
+     */
+    getSubcommands(): string[];
+}
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,iCAAiC;AACjC,MAAM,MAAM,cAAc,GAAG,CAC3B,EAAE,EAAE,OAAO,gBAAgB,EAAE,QAAQ,EACrC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,MAAM,GAAG,IAAI,CAAC;AAEnB,uBAAuB;AACvB,MAAM,WAAW,KAAK;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,sBAAsB;AACtB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;IAE7B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAI3E;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,CAAC,GAAG,IAAI;IAMjG;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAMxC;;;OAGG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAKlE;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;CAG3B"}

package/dist/cli/router.js

@@ -0,0 +1,49 @@
+"use strict";
+// Command router
+// Maps subcommand + action to the appropriate handler function
+// Implements AD-0012: Single Entry Point with Declarative Routing
+// + FS-SS-007-0001 (CLI entry point)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandRouter = void 0;
+/** Router registry */
+class CommandRouter {
+    routes = [];
+    /**
+     * Register a route.
+     */
+    register(subcommand, action, handler) {
+        this.routes.push({ subcommand, action, handler });
+    }
+    /**
+     * Register multiple routes for a subcommand.
+     */
+    registerAll(subcommand, routes) {
+        for (const route of routes) {
+            this.routes.push({ subcommand, action: route.action, handler: route.handler });
+        }
+    }
+    /**
+     * Find all actions for a subcommand.
+     */
+    getActions(subcommand) {
+        return this.routes
+            .filter(r => r.subcommand === subcommand)
+            .map(r => r.action);
+    }
+    /**
+     * Find the handler for a subcommand and action.
+     * Returns null if not found.
+     */
+    resolve(subcommand, action) {
+        const route = this.routes.find(r => r.subcommand === subcommand && r.action === action);
+        return route?.handler ?? null;
+    }
+    /**
+     * Get all registered subcommands.
+     */
+    getSubcommands() {
+        return [...new Set(this.routes.map(r => r.subcommand))];
+    }
+}
+exports.CommandRouter = CommandRouter;
+//# sourceMappingURL=router.js.map

package/dist/cli/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":";AAAA,iBAAiB;AACjB,+DAA+D;AAC/D,kEAAkE;AAClE,qCAAqC;;;AAkBrC,sBAAsB;AACtB,MAAa,aAAa;IAChB,MAAM,GAAY,EAAE,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,UAAkB,EAAE,MAAc,EAAE,OAAuB;QAClE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,UAAkB,EAAE,MAA0D;QACxF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAAkB;QAC3B,OAAO,IAAI,CAAC,MAAM;aACf,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC;aACxC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,UAAkB,EAAE,MAAc;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QACxF,OAAO,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF;AA3CD,sCA2CC"}

package/dist/cli/schema.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createSchemaGroup(): Command;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/cli/schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,wBAAgB,iBAAiB,IAAI,OAAO,CAsE3C"}