@nexical/cli-core 0.1.0 → 0.1.2

package/dist/chunk-Z4RQIDDY.js

@@ -0,0 +1,255 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  CommandLoader
+} from "./chunk-LLXEFSKN.js";
+import {
+  logger,
+  setDebugMode
+} from "./chunk-2HJDWSDA.js";
+
+// src/CLI.ts
+import { cac } from "cac";
+import path from "path";
+import fs from "fs";
+import { fileURLToPath } from "url";
+import pc from "picocolors";
+
+// package.json
+var package_default = {
+  name: "@nexical/cli-core",
+  version: "0.1.2",
+  type: "module",
+  main: "dist/index.js",
+  types: "dist/index.d.ts",
+  exports: {
+    ".": "./dist/index.js"
+  },
+  scripts: {
+    build: "tsup",
+    dev: "tsup --watch",
+    cli: "node dist/cli.js",
+    test: "npm run test:unit && npm run test:integration && npm run test:e2e",
+    "test:unit": "vitest run --config vitest.config.ts --coverage",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:e2e": "npm run build && vitest run --config vitest.e2e.config.ts",
+    "test:watch": "vitest"
+  },
+  dependencies: {
+    cac: "^6.7.14",
+    consola: "^3.4.2",
+    lilconfig: "^3.1.3",
+    picocolors: "^1.1.1",
+    yaml: "^2.8.2",
+    zod: "^3.22.4"
+  },
+  devDependencies: {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^4.0.15",
+    execa: "^9.6.1",
+    "fs-extra": "^11.3.2",
+    tsup: "^8.0.1",
+    typescript: "^5.3.3",
+    vitest: "^4.0.15"
+  }
+};
+
+// src/CLI.ts
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
+var CLI = class {
+  name;
+  cli;
+  loader;
+  HelpCommandClass;
+  config;
+  constructor(config = {}) {
+    this.config = config;
+    this.name = this.config.commandName || "app";
+    this.cli = cac(this.name);
+    this.loader = new CommandLoader(this);
+  }
+  loadedCommands = [];
+  getCommands() {
+    return this.loadedCommands;
+  }
+  getRawCLI() {
+    return this.cli;
+  }
+  async start() {
+    if (process.argv.includes("--debug")) {
+      setDebugMode(true);
+      logger.debug("Debug mode enabled via --debug flag");
+    }
+    let commandsDirs = [];
+    if (this.config.searchDirectories && this.config.searchDirectories.length > 0) {
+      commandsDirs = this.config.searchDirectories;
+    } else {
+      const possibleDirs = [
+        path.resolve(__dirname, "./src/commands"),
+        path.resolve(process.cwd(), "commands")
+        // Fallback relative to cwd?
+      ];
+      for (const dir of possibleDirs) {
+        if (fs.existsSync(dir)) {
+          commandsDirs.push(dir);
+          break;
+        }
+      }
+    }
+    if (commandsDirs.length === 0) {
+      logger.debug("No commands directory found.");
+    }
+    for (const dir of commandsDirs) {
+      await this.loader.load(dir);
+    }
+    this.loadedCommands = this.loader.getCommands();
+    const commandGroups = {};
+    const helpCmd = this.loadedCommands.find((c) => c.command === "help");
+    if (helpCmd) {
+      this.HelpCommandClass = helpCmd.class;
+    }
+    for (const cmd of this.loadedCommands) {
+      const root = cmd.command.split(" ")[0];
+      if (!commandGroups[root]) commandGroups[root] = [];
+      commandGroups[root].push(cmd);
+    }
+    for (const [root, cmds] of Object.entries(commandGroups)) {
+      if (cmds.length === 1 && cmds[0].command === root) {
+        const cmd = cmds[0];
+        const CommandClass = cmd.class;
+        let commandName = cmd.command;
+        const argsDef = CommandClass.args || {};
+        if (argsDef.args) {
+          argsDef.args.forEach((arg) => {
+            const isVariadic = arg.name.endsWith("...");
+            const cleanName = isVariadic ? arg.name.slice(0, -3) : arg.name;
+            commandName += isVariadic ? ` [...${cleanName}]` : ` [${cleanName}]`;
+          });
+        }
+        const cacCommand = this.cli.command(commandName, CommandClass.description || "");
+        if (argsDef.options) {
+          argsDef.options.forEach((opt) => {
+            cacCommand.option(opt.name, opt.description, { default: opt.default });
+          });
+        }
+        this.registerGlobalOptions(cacCommand);
+        cacCommand.action(async (...args) => {
+          const options = args.pop();
+          if (options.help) {
+            await this.runHelp([cmd.command]);
+            return;
+          }
+          const positionalArgs = args;
+          if (argsDef.args) {
+            argsDef.args.forEach((arg, index) => {
+              const isVariadic = arg.name.endsWith("...");
+              const name = isVariadic ? arg.name.slice(0, -3) : arg.name;
+              const val = positionalArgs[index];
+              if (val !== void 0) {
+                options[name] = val;
+              } else if (arg.required) {
+                console.error(pc.red(`Missing required argument: ${name}`));
+                this.runHelp([cmd.command]).then(() => process.exit(1));
+                return;
+              }
+            });
+          }
+          await this.runCommand(CommandClass, options, [cmd.command]);
+        });
+      } else {
+        const commandName = `${root} [subcommand] [...args]`;
+        const cacCommand = this.cli.command(commandName, `Manage ${root} commands`);
+        cacCommand.allowUnknownOptions();
+        this.registerGlobalOptions(cacCommand);
+        cacCommand.action(async (subcommand, ...args) => {
+          const options = args.pop();
+          if (!subcommand || options.help) {
+            await this.runHelp([root, subcommand].filter(Boolean));
+            return;
+          }
+          const fullCommandName = `${root} ${subcommand}`;
+          const cmd = cmds.find((c) => c.command === fullCommandName);
+          if (!cmd) {
+            console.error(pc.red(`Unknown subcommand '${subcommand}' for '${root}'`));
+            process.exit(1);
+          }
+          const CommandClass = cmd.class;
+          const argsDef = CommandClass.args || {};
+          const positionalArgs = args.length > 0 && Array.isArray(args[0]) ? args[0] : args;
+          const childOptions = { ...options };
+          const cmdParts = [root, subcommand];
+          if (argsDef.args) {
+            argsDef.args.forEach((arg, index) => {
+              const isVariadic = arg.name.endsWith("...");
+              const name = isVariadic ? arg.name.slice(0, -3) : arg.name;
+              const val = positionalArgs[index];
+              if (val !== void 0) {
+                if (isVariadic) {
+                  childOptions[name] = positionalArgs.slice(index);
+                } else {
+                  childOptions[name] = val;
+                }
+              } else if (arg.required) {
+                console.error(pc.red(`Missing required argument: ${name}`));
+                this.runHelp(cmdParts).then(() => process.exit(1));
+                return;
+              }
+            });
+          }
+          await this.runCommand(CommandClass, childOptions, cmdParts);
+        });
+      }
+    }
+    this.cli.option("--help, -h", "Display help");
+    this.cli.version(package_default.version);
+    if (process.argv.includes("--help") || process.argv.includes("-h")) {
+      const args = process.argv.slice(2).filter((a) => !a.startsWith("-"));
+      if (args.length === 0) {
+        await this.runHelp([]);
+        process.exit(0);
+      }
+    }
+    try {
+      this.cli.parse();
+    } catch (e) {
+      console.error(pc.red(e.message));
+      console.log("");
+      const args = process.argv.slice(2);
+      const potentialCommand = args.find((a) => !a.startsWith("-"));
+      const helpArgs = potentialCommand ? [potentialCommand] : [];
+      await this.runHelp(helpArgs);
+      process.exit(1);
+    }
+  }
+  registerGlobalOptions(cacCommand) {
+    cacCommand.option("--root-dir <path>", "Override project root");
+    cacCommand.option("--debug", "Enable debug mode");
+    cacCommand.option("--help, -h", "Display help message");
+  }
+  async runHelp(commandParts) {
+    if (this.HelpCommandClass) {
+      const helpInstance = new this.HelpCommandClass(this);
+      await helpInstance.run({ command: commandParts });
+    } else {
+      this.cli.outputHelp();
+    }
+  }
+  async runCommand(CommandClass, options, commandParts = []) {
+    try {
+      const instance = new CommandClass(this, options);
+      await instance.init();
+      await instance.run(options);
+    } catch (e) {
+      console.error(pc.red(e.message));
+      if (options.debug) console.error(e.stack);
+      console.log("");
+      await this.runHelp(commandParts);
+      process.exit(1);
+    }
+  }
+};
+
+export {
+  CLI
+};
+//# sourceMappingURL=chunk-Z4RQIDDY.js.map

package/dist/chunk-Z4RQIDDY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/CLI.ts","../package.json"],"sourcesContent":["import { cac } from 'cac';\nimport { CommandLoader } from './CommandLoader.js';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport pc from 'picocolors';\nimport pkg from '../package.json';\nimport { logger, setDebugMode } from './utils/logger.js';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nexport interface CLIConfig {\n    commandName?: string;\n    searchDirectories?: string[];\n}\n\nexport class CLI {\n    public name: string;\n    private cli: ReturnType<typeof cac>;\n    private loader: CommandLoader;\n    private HelpCommandClass: any;\n    private config: CLIConfig;\n\n    constructor(config: CLIConfig = {}) {\n        this.config = config;\n        this.name = this.config.commandName || 'app';\n        this.cli = cac(this.name);\n        this.loader = new CommandLoader(this);\n    }\n\n    private loadedCommands: any[] = [];\n\n    getCommands() {\n        return this.loadedCommands;\n    }\n\n    getRawCLI() {\n        return this.cli;\n    }\n\n    async start() {\n        // In built version, we are in dist/index.js (from cli/index.ts) -> core bundled? or just imported.\n        // The core logic is now in src/cli/core/src/CLI.ts or dist/core/src/CLI.js\n\n        // Check for debug flag early\n        if (process.argv.includes('--debug')) {\n            setDebugMode(true);\n            logger.debug('Debug mode enabled via --debug flag');\n        }\n\n        let commandsDirs: string[] = [];\n\n        if (this.config.searchDirectories && this.config.searchDirectories.length > 0) {\n            commandsDirs = this.config.searchDirectories;\n        } else {\n            // We assume the standard structure:\n            // cli/\n            //   index.js\n            //   commands/\n            //   core/\n            //     src/\n            //       CLI.ts\n\n            // When running from source (ts-node src/cli/index.ts), specific commands are in src/cli/commands.\n            // core is in src/cli/core/src.\n            // Relative path from CLI.ts to commands: ../../../commands\n\n            const possibleDirs = [\n                path.resolve(__dirname, './src/commands'),\n                path.resolve(process.cwd(), 'commands')    // Fallback relative to cwd?\n            ];\n\n            for (const dir of possibleDirs) {\n                if (fs.existsSync(dir)) {\n                    commandsDirs.push(dir);\n                    break; // Keep existing behavior: verify if we want multiple or just first found\n                }\n            }\n        }\n\n        // Fallback or error\n        if (commandsDirs.length === 0) {\n            logger.debug(\"No commands directory found.\");\n        }\n\n        for (const dir of commandsDirs) {\n            // Loader accumulates commands\n            await this.loader.load(dir);\n        }\n        this.loadedCommands = this.loader.getCommands();\n\n        // Group commands by root command name\n        const commandGroups: Record<string, any[]> = {};\n        // Locate HelpCommand for fallback usage\n        const helpCmd = this.loadedCommands.find(c => c.command === 'help');\n        if (helpCmd) {\n            this.HelpCommandClass = helpCmd.class;\n        }\n\n        for (const cmd of this.loadedCommands) {\n            const root = cmd.command.split(' ')[0];\n            if (!commandGroups[root]) commandGroups[root] = [];\n            commandGroups[root].push(cmd);\n        }\n\n        for (const [root, cmds] of Object.entries(commandGroups)) {\n            // Case 1: Single command, no subcommands (e.g. 'init')\n            if (cmds.length === 1 && cmds[0].command === root) {\n                const cmd = cmds[0];\n                const CommandClass = cmd.class;\n                // Original logic for single command\n                let commandName = cmd.command;\n                const argsDef = CommandClass.args || {};\n                if (argsDef.args) {\n                    argsDef.args.forEach((arg: any) => {\n                        const isVariadic = arg.name.endsWith('...');\n                        const cleanName = isVariadic ? arg.name.slice(0, -3) : arg.name;\n                        // Always use optional brackets [] for CAC to allow --help to pass validation\n                        // We will enforce 'required' manually in the action handler\n                        commandName += isVariadic ? ` [...${cleanName}]` : ` [${cleanName}]`;\n                    });\n                }\n                const cacCommand = this.cli.command(commandName, CommandClass.description || '');\n\n                // Register options\n                if (argsDef.options) {\n                    argsDef.options.forEach((opt: any) => {\n                        cacCommand.option(opt.name, opt.description, { default: opt.default });\n                    });\n                }\n                this.registerGlobalOptions(cacCommand);\n\n                cacCommand.action(async (...args: any[]) => {\n                    const options = args.pop();\n\n                    if (options.help) {\n                        await this.runHelp([cmd.command]);\n                        return;\n                    }\n\n                    const positionalArgs = args;\n\n                    if (argsDef.args) {\n                        argsDef.args.forEach((arg: any, index: number) => {\n                            const isVariadic = arg.name.endsWith('...');\n                            const name = isVariadic ? arg.name.slice(0, -3) : arg.name;\n                            const val = positionalArgs[index];\n\n                            if (val !== undefined) {\n                                options[name] = val;\n                            } else if (arg.required) {\n                                console.error(pc.red(`Missing required argument: ${name}`));\n                                this.runHelp([cmd.command]).then(() => process.exit(1));\n                                return;\n                            }\n                        });\n                    }\n                    await this.runCommand(CommandClass, options, [cmd.command]);\n                });\n            } else {\n                // Case 2: Command with subcommands (e.g. 'module add')\n                // Register 'module <subcommand>' catch-all\n                const commandName = `${root} [subcommand] [...args]`;\n                const cacCommand = this.cli.command(commandName, `Manage ${root} commands`);\n\n                cacCommand.allowUnknownOptions(); // Pass options to subcommand\n                this.registerGlobalOptions(cacCommand);\n\n                cacCommand.action(async (subcommand: string, ...args: any[]) => {\n                    const options = args.pop(); // last is options\n\n                    if (!subcommand || options.help) {\n                        // If --help is passed to 'module --help', subcommand might be caught as 'module' if args parsing is weird?  \n                        // ACTUALLY: cac parses 'module add --help' as subcommand=\"add\".\n                        // 'module --help' might trigger the command itself? No, 'module <subcommand>' expects a subcommand.\n                        // If I run 'module --help', it might fail validation or parse 'help' as subcommand if unlucky, \n                        // but likely it just prints help if we didn't override.\n\n                        await this.runHelp([root, subcommand].filter(Boolean));\n                        return;\n                    }\n\n\n                    // Find matching command\n                    // Match against \"root subcommand\"\n                    const fullCommandName = `${root} ${subcommand}`;\n                    const cmd = cmds.find(c => c.command === fullCommandName);\n\n                    if (!cmd) {\n                        console.error(pc.red(`Unknown subcommand '${subcommand}' for '${root}'`));\n                        process.exit(1);\n                    }\n\n                    const CommandClass = cmd.class;\n                    // Map remaining args? \n                    // The args array contains positional args AFTER subcommand.\n                    // But we didn't define them in CAC, so they are just strings.\n                    // We need to map them manually to the Target Command's args definition.\n                    // argsDef.args usually starts after the command.\n                    // For 'module add <url>', <url> is the first arg after 'add'.\n                    // So 'args' here corresponds to <url>.\n\n                    const argsDef = CommandClass.args || {};\n                    // If using [...args], the variadic args are collected into the first argument array\n                    // args here is what remains after popping options.\n                    const positionalArgs = (args.length > 0 && Array.isArray(args[0])) ? args[0] : args;\n\n                    const childOptions = { ...options }; // Copy options\n\n                    const cmdParts = [root, subcommand];\n\n                    if (argsDef.args) {\n                        argsDef.args.forEach((arg: any, index: number) => {\n                            const isVariadic = arg.name.endsWith('...');\n                            const name = isVariadic ? arg.name.slice(0, -3) : arg.name;\n                            const val = positionalArgs[index];\n\n                            if (val !== undefined) {\n                                if (isVariadic) {\n                                    childOptions[name] = positionalArgs.slice(index);\n                                } else {\n                                    childOptions[name] = val;\n                                }\n                            } else if (arg.required) {\n                                console.error(pc.red(`Missing required argument: ${name}`));\n                                this.runHelp(cmdParts).then(() => process.exit(1));\n                                return;\n                            }\n                        });\n                    }\n\n                    await this.runCommand(CommandClass, childOptions, cmdParts);\n                });\n            }\n        }\n        // Disable default help\n        // this.cli.help(); \n\n        // Manually register global help to ensure it's allowed\n        this.cli.option('--help, -h', 'Display help');\n\n        this.cli.version(pkg.version);\n\n        // Global help interception for root command\n        // If we run `app --help`, we need to catch it.\n        // CAC doesn't expose a clean global action without a command content.\n        // However, if we parse and no command matches, it usually errors or shows help.\n        // If we have default logic, we can put it here?\n        // Let's rely on standard parsing but maybe inspect raw args first?\n\n        if (process.argv.includes('--help') || process.argv.includes('-h')) {\n            // Inspect non-option args to see if there's a command?\n            const args = process.argv.slice(2).filter(a => !a.startsWith('-'));\n            if (args.length === 0) {\n                await this.runHelp([]);\n                process.exit(0);\n            }\n        }\n\n        try {\n            this.cli.parse();\n        } catch (e: any) {\n            console.error(pc.red(e.message));\n\n            // Try to provide helpful context\n            console.log('');\n            // Simple heuristic: find first non-flag arg as command\n            const args = process.argv.slice(2);\n            const potentialCommand = args.find(a => !a.startsWith('-'));\n            // If it matches a loaded command root, show help for it\n            // Otherwise show global help\n\n            // We need to match 'module add' etc?\n            // Just pass the potential command parts to runHelp. \n            // runHelp handles filtering itself? No, runHelp takes commandParts to pass to HelpCommand.\n            // HelpCommand expects `command` array.\n\n            const helpArgs = potentialCommand ? [potentialCommand] : [];\n            await this.runHelp(helpArgs);\n\n            process.exit(1);\n        }\n    }\n\n    private registerGlobalOptions(cacCommand: any) {\n        cacCommand.option('--root-dir <path>', 'Override project root');\n        cacCommand.option('--debug', 'Enable debug mode');\n        cacCommand.option('--help, -h', 'Display help message');\n    }\n\n    private async runHelp(commandParts: string[]) {\n        if (this.HelpCommandClass) {\n            const helpInstance = new this.HelpCommandClass(this);\n            await helpInstance.run({ command: commandParts });\n        } else {\n            // Fallback if HelpCommand not loaded (shouldn't happen)\n            this.cli.outputHelp();\n        }\n    }\n\n    private async runCommand(CommandClass: any, options: any, commandParts: string[] = []) {\n        try {\n            const instance = new CommandClass(this, options);\n            await instance.init();\n            await instance.run(options);\n        } catch (e: any) {\n            console.error(pc.red(e.message));\n            if (options.debug) console.error(e.stack);\n\n            console.log(''); // spacer\n            await this.runHelp(commandParts);\n\n            process.exit(1);\n        }\n    }\n}\n","{\n    \"name\": \"@nexical/cli-core\",\n    \"version\": \"0.1.2\",\n    \"type\": \"module\",\n    \"main\": \"dist/index.js\",\n    \"types\": \"dist/index.d.ts\",\n    \"exports\": {\n        \".\": \"./dist/index.js\"\n    },\n    \"scripts\": {\n        \"build\": \"tsup\",\n        \"dev\": \"tsup --watch\",\n        \"cli\": \"node dist/cli.js\",\n        \"test\": \"npm run test:unit && npm run test:integration && npm run test:e2e\",\n        \"test:unit\": \"vitest run --config vitest.config.ts --coverage\",\n        \"test:integration\": \"vitest run --config vitest.integration.config.ts\",\n        \"test:e2e\": \"npm run build && vitest run --config vitest.e2e.config.ts\",\n        \"test:watch\": \"vitest\"\n    },\n    \"dependencies\": {\n        \"cac\": \"^6.7.14\",\n        \"consola\": \"^3.4.2\",\n        \"lilconfig\": \"^3.1.3\",\n        \"picocolors\": \"^1.1.1\",\n        \"yaml\": \"^2.8.2\",\n        \"zod\": \"^3.22.4\"\n    },\n    \"devDependencies\": {\n        \"@types/fs-extra\": \"^11.0.4\",\n        \"@types/node\": \"^20.10.0\",\n        \"@vitest/coverage-v8\": \"^4.0.15\",\n        \"execa\": \"^9.6.1\",\n        \"fs-extra\": \"^11.3.2\",\n        \"tsup\": \"^8.0.1\",\n        \"typescript\": \"^5.3.3\",\n        \"vitest\": \"^4.0.15\"\n    }\n}"],"mappings":"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","names":[]}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  CLI
+} from "./chunk-Z4RQIDDY.js";
+import "./chunk-LLXEFSKN.js";
+import {
+  logger
+} from "./chunk-2HJDWSDA.js";
+
+// cli.ts
+logger.debug("CLI ENTRY POINT HIT", process.argv);
+var app = new CLI();
+app.start();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { CLI } from './src/CLI.js';\n\nimport { logger } from './src/utils/logger.js';\n\nlogger.debug('CLI ENTRY POINT HIT', process.argv);\n\nconst app = new CLI();\napp.start();\n"],"mappings":";;;;;;;;;;;AAKA,OAAO,MAAM,uBAAuB,QAAQ,IAAI;AAEhD,IAAM,MAAM,IAAI,IAAI;AACpB,IAAI,MAAM;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { CLI, CLIConfig } from './src/CLI.js';
+export { BaseCommand } from './src/BaseCommand.js';
+export { logger, setDebugMode } from './src/utils/logger.js';
+export { runCommand } from './src/utils/shell.js';
+export { CommandArg, CommandDefinition, CommandInterface, CommandOption } from './src/CommandInterface.js';
+import 'cac';
+import 'consola';

package/dist/index.js

@@ -0,0 +1,25 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  runCommand
+} from "./chunk-SNTKHUTX.js";
+import {
+  CLI
+} from "./chunk-Z4RQIDDY.js";
+import "./chunk-C4IL52NB.js";
+import "./chunk-LLXEFSKN.js";
+import {
+  BaseCommand
+} from "./chunk-CKAS75E6.js";
+import "./chunk-IIOHHU2E.js";
+import {
+  logger,
+  setDebugMode
+} from "./chunk-2HJDWSDA.js";
+export {
+  BaseCommand,
+  CLI,
+  logger,
+  runCommand,
+  setDebugMode
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/src/BaseCommand.d.ts

@@ -0,0 +1,21 @@
+import { CommandInterface, CommandDefinition } from './CommandInterface.js';
+
+declare abstract class BaseCommand implements CommandInterface {
+    static usage: string;
+    static description: string;
+    static args: CommandDefinition;
+    static requiresProject: boolean;
+    protected projectRoot: string | null;
+    protected config: any;
+    protected globalOptions: any;
+    protected cli: any;
+    constructor(cli: any, globalOptions?: any);
+    init(): Promise<void>;
+    abstract run(options: any): Promise<void>;
+    success(msg: string): void;
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string | Error, code?: number): void;
+}
+
+export { BaseCommand };

package/dist/src/BaseCommand.js

@@ -0,0 +1,10 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  BaseCommand
+} from "../chunk-CKAS75E6.js";
+import "../chunk-IIOHHU2E.js";
+import "../chunk-2HJDWSDA.js";
+export {
+  BaseCommand
+};
+//# sourceMappingURL=BaseCommand.js.map

package/dist/src/BaseCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/src/CLI.d.ts

@@ -0,0 +1,23 @@
+import * as cac from 'cac';
+
+interface CLIConfig {
+    commandName?: string;
+    searchDirectories?: string[];
+}
+declare class CLI {
+    name: string;
+    private cli;
+    private loader;
+    private HelpCommandClass;
+    private config;
+    constructor(config?: CLIConfig);
+    private loadedCommands;
+    getCommands(): any[];
+    getRawCLI(): cac.CAC;
+    start(): Promise<void>;
+    private registerGlobalOptions;
+    private runHelp;
+    private runCommand;
+}
+
+export { CLI, type CLIConfig };

package/dist/src/CLI.js

@@ -0,0 +1,10 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  CLI
+} from "../chunk-Z4RQIDDY.js";
+import "../chunk-LLXEFSKN.js";
+import "../chunk-2HJDWSDA.js";
+export {
+  CLI
+};
+//# sourceMappingURL=CLI.js.map

package/dist/src/CLI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/src/CommandInterface.d.ts

@@ -0,0 +1,21 @@
+interface CommandArg {
+    name: string;
+    required?: boolean;
+    description?: string;
+    default?: any;
+}
+interface CommandOption {
+    name: string;
+    description?: string;
+    default?: any;
+    type?: any[];
+}
+interface CommandDefinition {
+    args?: CommandArg[];
+    options?: CommandOption[];
+}
+interface CommandInterface {
+    run(options: any): Promise<void>;
+}
+
+export type { CommandArg, CommandDefinition, CommandInterface, CommandOption };

package/dist/src/CommandInterface.js

@@ -0,0 +1,3 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import "../chunk-C4IL52NB.js";
+//# sourceMappingURL=CommandInterface.js.map

package/dist/src/CommandInterface.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/src/CommandLoader.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from './BaseCommand.js';
+import './CommandInterface.js';
+
+interface LoadedCommand {
+    command: string;
+    path: string;
+    instance: BaseCommand;
+    class: any;
+}
+declare class CommandLoader {
+    private cli;
+    private commands;
+    private importer;
+    constructor(cli: any, importer?: (path: string) => Promise<any>);
+    getCommands(): LoadedCommand[];
+    load(commandsDir: string): Promise<LoadedCommand[]>;
+    private scan;
+}
+
+export { CommandLoader, type LoadedCommand };

package/dist/src/CommandLoader.js

@@ -0,0 +1,9 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  CommandLoader
+} from "../chunk-LLXEFSKN.js";
+import "../chunk-2HJDWSDA.js";
+export {
+  CommandLoader
+};
+//# sourceMappingURL=CommandLoader.js.map

package/dist/src/CommandLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/src/commands/help.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../BaseCommand.js';
+import '../CommandInterface.js';
+
+declare class HelpCommand extends BaseCommand {
+    static description: string;
+    static args: {
+        args: {
+            name: string;
+            required: boolean;
+            description: string;
+        }[];
+        options: never[];
+    };
+    run(options: any): Promise<void>;
+    private printGlobalHelp;
+    private printCommandHelp;
+}
+
+export { HelpCommand as default };

package/dist/src/commands/help.js

@@ -0,0 +1,134 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  BaseCommand
+} from "../../chunk-CKAS75E6.js";
+import "../../chunk-IIOHHU2E.js";
+import "../../chunk-2HJDWSDA.js";
+
+// src/commands/help.ts
+import pc from "picocolors";
+var HelpCommand = class extends BaseCommand {
+  static description = "Display help for commands.";
+  static args = {
+    args: [
+      { name: "command...", required: false, description: "Command name to get help for" }
+    ],
+    options: []
+  };
+  async run(options) {
+    const commandParts = options.command || [];
+    const query = commandParts.join(" ");
+    if (!query) {
+      this.printGlobalHelp();
+      return;
+    }
+    const commands = this.cli.getCommands();
+    const exactMatch = commands.find((c) => c.command === query);
+    if (exactMatch) {
+      const cacCmd = this.cli.getRawCLI().commands.find((c) => c.name === query);
+      this.printCommandHelp(exactMatch, cacCmd);
+      return;
+    }
+    const namespaceMatches = commands.filter((c) => c.command.startsWith(query + " "));
+    if (namespaceMatches.length > 0) {
+      console.log(`
+  Commands for ${pc.bold(query)}:
+`);
+      for (const cmd of namespaceMatches) {
+        const name = cmd.command;
+        const desc = cmd.class.description || "";
+        console.log(`  ${pc.cyan(name.padEnd(20))} ${desc}`);
+      }
+      console.log("");
+      return;
+    }
+    this.error(`Unknown command: ${query}`);
+  }
+  printGlobalHelp() {
+    const commands = this.cli.getCommands();
+    const bin = this.cli.name;
+    console.log("");
+    console.log(`  Usage: ${pc.cyan(bin)} <command> [options]`);
+    console.log("");
+    console.log("  Commands:");
+    console.log("");
+    for (const cmd of commands) {
+      const name = cmd.command;
+      const desc = cmd.class.description || "";
+      console.log(`    ${pc.cyan(name.padEnd(25))} ${desc}`);
+    }
+    console.log("");
+    console.log("  Options:");
+    console.log("");
+    console.log(`    ${pc.yellow("--help".padEnd(25))} Display this message`);
+    console.log(`    ${pc.yellow("--version".padEnd(25))} Display version number`);
+    console.log(`    ${pc.yellow("--root-dir <path>".padEnd(25))} Override project root`);
+    console.log(`    ${pc.yellow("--debug".padEnd(25))} Enable debug mode`);
+    console.log("");
+  }
+  printCommandHelp(loadedCommand, cacCmd) {
+    const CommandClass = loadedCommand.class;
+    let usage = CommandClass.usage;
+    if (!usage && cacCmd) usage = cacCmd.rawName;
+    if (!usage) {
+      let tempUsage = loadedCommand.command;
+      const args = CommandClass.args?.args || [];
+      args.forEach((arg) => {
+        const isVariadic = arg.name.endsWith("...");
+        const cleanName = isVariadic ? arg.name.slice(0, -3) : arg.name;
+        if (arg.required) tempUsage += isVariadic ? ` <...${cleanName}>` : ` <${cleanName}>`;
+        else tempUsage += isVariadic ? ` [...${cleanName}]` : ` [${cleanName}]`;
+      });
+      usage = tempUsage;
+    }
+    console.log("");
+    console.log(`  Usage: ${pc.cyan(usage)}`);
+    console.log("");
+    const description = CommandClass.description || cacCmd && cacCmd.description || "";
+    console.log(`  ${description}`);
+    console.log("");
+    const argsDef = CommandClass.args?.args;
+    if (argsDef && Array.isArray(argsDef) && argsDef.length > 0) {
+      console.log("  Arguments:");
+      for (const arg of argsDef) {
+        const name = arg.name;
+        const desc = arg.description || "";
+        const required = arg.required ? " (required)" : "";
+        console.log(`    ${pc.cyan(name.padEnd(25))} ${desc}${pc.dim(required)}`);
+      }
+      console.log("");
+    }
+    const optionsList = [];
+    if (cacCmd) {
+      optionsList.push(...cacCmd.options);
+    } else {
+      const classOptions = CommandClass.args?.options || [];
+      for (const opt of classOptions) {
+        optionsList.push({
+          rawName: opt.name,
+          // e.g. '--repo <url>'
+          description: opt.description,
+          config: { default: opt.default }
+        });
+      }
+      optionsList.push({ rawName: "--help", description: "Display this message", config: {} });
+      optionsList.push({ rawName: "--version", description: "Display version number", config: {} });
+      optionsList.push({ rawName: "--root-dir <path>", description: "Override project root", config: {} });
+      optionsList.push({ rawName: "--debug", description: "Enable debug mode", config: {} });
+    }
+    if (optionsList.length > 0) {
+      console.log("  Options:");
+      for (const opt of optionsList) {
+        const flags = opt.rawName.padEnd(25);
+        const desc = opt.description || "";
+        const def = opt.config?.default ? ` (default: ${opt.config.default})` : "";
+        console.log(`    ${pc.yellow(flags)} ${desc}${pc.dim(def)}`);
+      }
+      console.log("");
+    }
+  }
+};
+export {
+  HelpCommand as default
+};
+//# sourceMappingURL=help.js.map