@nexical/cli-core 0.1.0 → 0.1.1

package/dist/chunk-PFEYDXIW.js

@@ -0,0 +1,69 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  logger
+} from "./chunk-HETFF3FQ.js";
+
+// src/CommandLoader.ts
+import fs from "fs";
+import path from "path";
+var CommandLoader = class {
+  cli = null;
+  commands = [];
+  importer;
+  constructor(cli, importer = (p) => import(p)) {
+    this.cli = cli;
+    this.importer = importer;
+  }
+  getCommands() {
+    return this.commands;
+  }
+  async load(commandsDir) {
+    logger.debug(`Loading commands from: ${commandsDir}`);
+    if (!fs.existsSync(commandsDir)) {
+      logger.debug(`Commands directory not found: ${commandsDir}`);
+      return [];
+    }
+    await this.scan(commandsDir, []);
+    return this.commands;
+  }
+  async scan(dir, prefix) {
+    const files = fs.readdirSync(dir);
+    for (const file of files) {
+      const fullPath = path.join(dir, file);
+      const stat = fs.statSync(fullPath);
+      if (stat.isDirectory()) {
+        await this.scan(fullPath, [...prefix, file]);
+      } else if ((file.endsWith(".ts") || file.endsWith(".js")) && !file.endsWith(".d.ts")) {
+        logger.debug(`Found potential command file: ${fullPath}`);
+        const name = path.basename(file, path.extname(file));
+        const commandParts = [...prefix];
+        if (name !== "index") {
+          commandParts.push(name);
+        } else if (commandParts.length === 0) {
+          continue;
+        }
+        try {
+          const module = await this.importer(fullPath);
+          const CommandClass = module.default;
+          if (CommandClass) {
+            const commandName = commandParts.join(" ");
+            logger.debug(`Registered command: ${commandName}`);
+            this.commands.push({
+              command: commandName,
+              path: fullPath,
+              instance: new CommandClass(this.cli),
+              class: CommandClass
+            });
+          }
+        } catch (e) {
+          logger.error(`Failed to load command at ${fullPath}`, e);
+        }
+      }
+    }
+  }
+};
+
+export {
+  CommandLoader
+};
+//# sourceMappingURL=chunk-PFEYDXIW.js.map

package/dist/chunk-PFEYDXIW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/CommandLoader.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { BaseCommand } from './BaseCommand.js';\nimport { logger } from './utils/logger.js';\n\nexport interface LoadedCommand {\n    command: string;\n    path: string;\n    instance: BaseCommand;\n    class: any;\n}\n\nexport class CommandLoader {\n    private cli: any = null;\n    private commands: LoadedCommand[] = [];\n    private importer: (path: string) => Promise<any>;\n\n    constructor(cli: any, importer: (path: string) => Promise<any> = (p) => import(p)) {\n        this.cli = cli;\n        this.importer = importer;\n    }\n\n    getCommands(): LoadedCommand[] {\n        return this.commands;\n    }\n\n    async load(commandsDir: string): Promise<LoadedCommand[]> {\n        logger.debug(`Loading commands from: ${commandsDir}`);\n        if (!fs.existsSync(commandsDir)) {\n            logger.debug(`Commands directory not found: ${commandsDir}`);\n            return [];\n        }\n\n        await this.scan(commandsDir, []);\n        return this.commands;\n    }\n\n    private async scan(dir: string, prefix: string[]) {\n        const files = fs.readdirSync(dir);\n\n        for (const file of files) {\n            const fullPath = path.join(dir, file);\n            const stat = fs.statSync(fullPath);\n\n            if (stat.isDirectory()) {\n                await this.scan(fullPath, [...prefix, file]);\n            } else if ((file.endsWith('.ts') || file.endsWith('.js')) && !file.endsWith('.d.ts')) {\n                // Ignore index files or non-command files if needed, but for now scan all.\n                // Assuming \"index.ts\" might be the command for the directory path itself if we supported that,\n                // but let's stick to \"create.ts\" -> \"create\"\n                logger.debug(`Found potential command file: ${fullPath}`);\n\n                const name = path.basename(file, path.extname(file));\n                const commandParts = [...prefix];\n                if (name !== 'index') {\n                    commandParts.push(name);\n                } else if (commandParts.length === 0) {\n                    continue; // skip src/commands/index.ts if it exists and doesn't map to anything specific\n                }\n\n                // Import\n                try {\n                    const module = await this.importer(fullPath);\n                    // Assume default export is the command class\n                    const CommandClass = module.default;\n\n                    if (CommandClass) { // Loose check for now to debug\n                        const commandName = commandParts.join(' ');\n                        logger.debug(`Registered command: ${commandName}`);\n                        this.commands.push({\n                            command: commandName,\n                            path: fullPath,\n                            instance: new CommandClass(this.cli),\n                            class: CommandClass\n                        });\n                    }\n                } catch (e) {\n                    logger.error(`Failed to load command at ${fullPath}`, e);\n                }\n            }\n        }\n    }\n}\n"],"mappings":";;;;;;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AAWV,IAAM,gBAAN,MAAoB;AAAA,EACf,MAAW;AAAA,EACX,WAA4B,CAAC;AAAA,EAC7B;AAAA,EAER,YAAY,KAAU,WAA2C,CAAC,MAAM,OAAO,IAAI;AAC/E,SAAK,MAAM;AACX,SAAK,WAAW;AAAA,EACpB;AAAA,EAEA,cAA+B;AAC3B,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,MAAM,KAAK,aAA+C;AACtD,WAAO,MAAM,0BAA0B,WAAW,EAAE;AACpD,QAAI,CAAC,GAAG,WAAW,WAAW,GAAG;AAC7B,aAAO,MAAM,iCAAiC,WAAW,EAAE;AAC3D,aAAO,CAAC;AAAA,IACZ;AAEA,UAAM,KAAK,KAAK,aAAa,CAAC,CAAC;AAC/B,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,MAAc,KAAK,KAAa,QAAkB;AAC9C,UAAM,QAAQ,GAAG,YAAY,GAAG;AAEhC,eAAW,QAAQ,OAAO;AACtB,YAAM,WAAW,KAAK,KAAK,KAAK,IAAI;AACpC,YAAM,OAAO,GAAG,SAAS,QAAQ;AAEjC,UAAI,KAAK,YAAY,GAAG;AACpB,cAAM,KAAK,KAAK,UAAU,CAAC,GAAG,QAAQ,IAAI,CAAC;AAAA,MAC/C,YAAY,KAAK,SAAS,KAAK,KAAK,KAAK,SAAS,KAAK,MAAM,CAAC,KAAK,SAAS,OAAO,GAAG;AAIlF,eAAO,MAAM,iCAAiC,QAAQ,EAAE;AAExD,cAAM,OAAO,KAAK,SAAS,MAAM,KAAK,QAAQ,IAAI,CAAC;AACnD,cAAM,eAAe,CAAC,GAAG,MAAM;AAC/B,YAAI,SAAS,SAAS;AAClB,uBAAa,KAAK,IAAI;AAAA,QAC1B,WAAW,aAAa,WAAW,GAAG;AAClC;AAAA,QACJ;AAGA,YAAI;AACA,gBAAM,SAAS,MAAM,KAAK,SAAS,QAAQ;AAE3C,gBAAM,eAAe,OAAO;AAE5B,cAAI,cAAc;AACd,kBAAM,cAAc,aAAa,KAAK,GAAG;AACzC,mBAAO,MAAM,uBAAuB,WAAW,EAAE;AACjD,iBAAK,SAAS,KAAK;AAAA,cACf,SAAS;AAAA,cACT,MAAM;AAAA,cACN,UAAU,IAAI,aAAa,KAAK,GAAG;AAAA,cACnC,OAAO;AAAA,YACX,CAAC;AAAA,UACL;AAAA,QACJ,SAAS,GAAG;AACR,iBAAO,MAAM,6BAA6B,QAAQ,IAAI,CAAC;AAAA,QAC3D;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AACJ;","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-2NZ4H42M.js";
+import "./chunk-PFEYDXIW.js";
+import {
+  logger
+} from "./chunk-HETFF3FQ.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,4 @@
+export { CLI, CLIConfig } from './src/CLI.js';
+export { BaseCommand } from './src/BaseCommand.js';
+export { CommandArg, CommandDefinition, CommandInterface, CommandOption } from './src/CommandInterface.js';
+import 'cac';

package/dist/index.js

@@ -0,0 +1,16 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  CLI
+} from "./chunk-2NZ4H42M.js";
+import "./chunk-C4IL52NB.js";
+import "./chunk-PFEYDXIW.js";
+import {
+  BaseCommand
+} from "./chunk-6LSNSDTL.js";
+import "./chunk-5YGASH25.js";
+import "./chunk-HETFF3FQ.js";
+export {
+  BaseCommand,
+  CLI
+};
+//# 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-6LSNSDTL.js";
+import "../chunk-5YGASH25.js";
+import "../chunk-HETFF3FQ.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-2NZ4H42M.js";
+import "../chunk-PFEYDXIW.js";
+import "../chunk-HETFF3FQ.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-PFEYDXIW.js";
+import "../chunk-HETFF3FQ.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-6LSNSDTL.js";
+import "../../chunk-5YGASH25.js";
+import "../../chunk-HETFF3FQ.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

package/dist/src/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/help.ts"],"sourcesContent":["import { BaseCommand } from '../BaseCommand.js';\nimport pc from 'picocolors';\n\nexport default class HelpCommand extends BaseCommand {\n    static description = 'Display help for commands.';\n\n    static args = {\n        args: [\n            { name: 'command...', required: false, description: 'Command name to get help for' }\n        ],\n        options: []\n    };\n\n    async run(options: any) {\n        const commandParts = options.command || [];\n        const query = commandParts.join(' ');\n\n        if (!query) {\n            // General help\n            this.printGlobalHelp();\n            return;\n        }\n\n        // Search for specific command or namespace\n        const commands = this.cli.getCommands();\n\n        // Exact match?\n        const exactMatch = commands.find((c: any) => c.command === query);\n        if (exactMatch) {\n            // Try to find CAC command if it exists (e.g. top-level commands like 'init')\n            // For subcommands (e.g. 'module add'), CAC might only have 'module <subcommand>', \n            // so cacCmd will be undefined for the exact query.\n            const cacCmd = this.cli.getRawCLI().commands.find((c: any) => c.name === query);\n\n            this.printCommandHelp(exactMatch, cacCmd);\n            return;\n        }\n\n        // Namespace match? (e.g. \"module\" matches \"module add\", \"module remove\")\n        const namespaceMatches = commands.filter((c: any) => c.command.startsWith(query + ' '));\n\n        if (namespaceMatches.length > 0) {\n            console.log(`\\n  Commands for ${pc.bold(query)}:\\n`);\n            for (const cmd of namespaceMatches) {\n                const name = cmd.command;\n                const desc = cmd.class.description || '';\n                console.log(`  ${pc.cyan(name.padEnd(20))} ${desc}`);\n            }\n            console.log('');\n            return;\n        }\n\n        this.error(`Unknown command: ${query}`);\n    }\n\n    private printGlobalHelp() {\n        const commands = this.cli.getCommands();\n        const bin = this.cli.name;\n\n        console.log('');\n        console.log(`  Usage: ${pc.cyan(bin)} <command> [options]`);\n        console.log('');\n        console.log('  Commands:');\n        console.log('');\n\n        for (const cmd of commands) {\n            const name = cmd.command;\n            const desc = cmd.class.description || '';\n            console.log(`    ${pc.cyan(name.padEnd(25))} ${desc}`);\n        }\n\n        console.log('');\n        console.log('  Options:');\n        console.log('');\n        console.log(`    ${pc.yellow('--help'.padEnd(25))} Display this message`);\n        console.log(`    ${pc.yellow('--version'.padEnd(25))} Display version number`);\n        console.log(`    ${pc.yellow('--root-dir <path>'.padEnd(25))} Override project root`);\n        console.log(`    ${pc.yellow('--debug'.padEnd(25))} Enable debug mode`);\n        console.log('');\n    }\n\n    private printCommandHelp(loadedCommand: any, cacCmd?: any) {\n        const CommandClass = loadedCommand.class;\n\n        let usage = CommandClass.usage;\n        if (!usage && cacCmd) usage = cacCmd.rawName;\n\n        // Fallback: construct usage from args definition if usage is missing\n        if (!usage) {\n            let tempUsage = loadedCommand.command;\n            const args = CommandClass.args?.args || [];\n            args.forEach((arg: any) => {\n                const isVariadic = arg.name.endsWith('...');\n                const cleanName = isVariadic ? arg.name.slice(0, -3) : arg.name;\n                if (arg.required) tempUsage += isVariadic ? ` <...${cleanName}>` : ` <${cleanName}>`;\n                else tempUsage += isVariadic ? ` [...${cleanName}]` : ` [${cleanName}]`;\n            });\n            usage = tempUsage;\n        }\n\n        console.log('');\n        console.log(`  Usage: ${pc.cyan(usage)}`);\n        console.log('');\n\n        const description = CommandClass.description || (cacCmd && cacCmd.description) || '';\n        console.log(`  ${description}`);\n        console.log('');\n\n        // Arguments\n        // Prefer class definition (or cacCmd definition if we wanted, but class is source of truth for our commands)\n        const argsDef = CommandClass.args?.args;\n        if (argsDef && Array.isArray(argsDef) && argsDef.length > 0) {\n            console.log('  Arguments:');\n            for (const arg of argsDef) {\n                const name = arg.name;\n                const desc = arg.description || '';\n                const required = arg.required ? ' (required)' : '';\n                console.log(`    ${pc.cyan(name.padEnd(25))} ${desc}${pc.dim(required)}`);\n            }\n            console.log('');\n        }\n\n        // Options\n        const optionsList = [];\n\n        if (cacCmd) {\n            // If CAC command exists, use its parsed options (includes globals)\n            optionsList.push(...cacCmd.options);\n        } else {\n            // Reconstruct options from Class + Globals\n            const classOptions = CommandClass.args?.options || [];\n\n            for (const opt of classOptions) {\n                optionsList.push({\n                    rawName: opt.name, // e.g. '--repo <url>'\n                    description: opt.description,\n                    config: { default: opt.default }\n                });\n            }\n\n            // Append Global Options manually since they are always available\n            optionsList.push({ rawName: '--help', description: 'Display this message', config: {} });\n            optionsList.push({ rawName: '--version', description: 'Display version number', config: {} });\n            optionsList.push({ rawName: '--root-dir <path>', description: 'Override project root', config: {} });\n            optionsList.push({ rawName: '--debug', description: 'Enable debug mode', config: {} });\n        }\n\n        if (optionsList.length > 0) {\n            console.log('  Options:');\n            for (const opt of optionsList) {\n                const flags = opt.rawName.padEnd(25);\n                const desc = opt.description || '';\n                const def = opt.config?.default ? ` (default: ${opt.config.default})` : '';\n                console.log(`    ${pc.yellow(flags)} ${desc}${pc.dim(def)}`);\n            }\n            console.log('');\n        }\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/src/utils/config.d.ts

@@ -0,0 +1,7 @@
+import { Loader } from 'lilconfig';
+
+declare const loadYaml: Loader;
+declare function findProjectRoot(commandName: string, startDir: string): Promise<string | null>;
+declare function loadConfig(commandName: string, rootDir: string): Promise<any>;
+
+export { findProjectRoot, loadConfig, loadYaml };

package/dist/src/utils/config.js

@@ -0,0 +1,13 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  findProjectRoot,
+  loadConfig,
+  loadYaml
+} from "../../chunk-5YGASH25.js";
+import "../../chunk-HETFF3FQ.js";
+export {
+  findProjectRoot,
+  loadConfig,
+  loadYaml
+};
+//# sourceMappingURL=config.js.map

package/dist/src/utils/config.js.map

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

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,6 @@
+import * as consola from 'consola';
+
+declare const logger: consola.ConsolaInstance;
+declare function setDebugMode(enabled: boolean): void;
+
+export { logger, setDebugMode };

package/dist/src/utils/logger.js

@@ -0,0 +1,10 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  logger,
+  setDebugMode
+} from "../../chunk-HETFF3FQ.js";
+export {
+  logger,
+  setDebugMode
+};
+//# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

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

package/dist/src/utils/shell.d.ts

@@ -0,0 +1,3 @@
+declare function runCommand(command: string, cwd?: string): Promise<void>;
+
+export { runCommand };

package/dist/src/utils/shell.js

@@ -0,0 +1,28 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  logger
+} from "../../chunk-HETFF3FQ.js";
+
+// src/utils/shell.ts
+import { exec } from "child_process";
+import { promisify } from "util";
+var execAsync = promisify(exec);
+async function runCommand(command, cwd) {
+  try {
+    logger.debug(`Executing command: ${command} in ${cwd || process.cwd()}`);
+    const { stdout } = await execAsync(command, { cwd });
+    if (stdout) {
+      console.log(stdout);
+    }
+  } catch (error) {
+    logger.error(`Command failed: ${command}`);
+    if (error.stderr) {
+      logger.error(error.stderr);
+    }
+    throw new Error(`Command failed: ${command}`);
+  }
+}
+export {
+  runCommand
+};
+//# sourceMappingURL=shell.js.map

package/dist/src/utils/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/shell.ts"],"sourcesContent":["import { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport { logger } from './logger.js';\n\nconst execAsync = promisify(exec);\n\nexport async function runCommand(command: string, cwd?: string): Promise<void> {\n    try {\n        logger.debug(`Executing command: ${command} in ${cwd || process.cwd()}`);\n        const { stdout } = await execAsync(command, { cwd });\n        if (stdout) {\n            console.log(stdout);\n        }\n    } catch (error: any) {\n        logger.error(`Command failed: ${command}`);\n        if (error.stderr) {\n            logger.error(error.stderr);\n        }\n        throw new Error(`Command failed: ${command}`);\n    }\n}\n"],"mappings":";;;;;;AAAA,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAG1B,IAAM,YAAY,UAAU,IAAI;AAEhC,eAAsB,WAAW,SAAiB,KAA6B;AAC3E,MAAI;AACA,WAAO,MAAM,sBAAsB,OAAO,OAAO,OAAO,QAAQ,IAAI,CAAC,EAAE;AACvE,UAAM,EAAE,OAAO,IAAI,MAAM,UAAU,SAAS,EAAE,IAAI,CAAC;AACnD,QAAI,QAAQ;AACR,cAAQ,IAAI,MAAM;AAAA,IACtB;AAAA,EACJ,SAAS,OAAY;AACjB,WAAO,MAAM,mBAAmB,OAAO,EAAE;AACzC,QAAI,MAAM,QAAQ;AACd,aAAO,MAAM,MAAM,MAAM;AAAA,IAC7B;AACA,UAAM,IAAI,MAAM,mBAAmB,OAAO,EAAE;AAAA,EAChD;AACJ;","names":[]}

package/index.ts

@@ -1,9 +1,3 @@
-#!/usr/bin/env node
-import { CLI } from './src/CLI.js';
-
-import { logger } from './src/utils/logger.js';
-
-logger.debug('CLI ENTRY POINT HIT', process.argv);
-
-const app = new CLI();
-app.start();
+export { CLI, CLIConfig } from './src/CLI.js';
+export { BaseCommand } from './src/BaseCommand.js';
+export * from './src/CommandInterface.js';

package/package.json

@@ -1,11 +1,16 @@
 {
     "name": "@nexical/cli-core",
-    "version": "0.1.0",
+    "version": "0.1.1",
     "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": "./dist/index.js"
+    },
     "scripts": {
         "build": "tsup",
         "dev": "tsup --watch",
-        "cli": "node dist/index.js",
+        "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",

package/test/utils/integration-helpers.ts

@@ -4,7 +4,7 @@ import { fileURLToPath } from 'node:url';
 
 // Constants
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-export const CLI_BIN = path.resolve(__dirname, '../../dist/index.js');
+export const CLI_BIN = path.resolve(__dirname, '../../dist/cli.js');
 
 /**
  * Runs the CLI command against the compiled binary (E2E style)

package/tsconfig.json

@@ -14,9 +14,9 @@
         "outDir": "./dist"
     },
     "include": [
+        "cli.ts",
         "src/**/*",
-        "test/**/*",
-        "../utils/environment.ts"
+        "test/**/*"
     ],
     "exclude": [
         "node_modules",

package/tsup.config.ts

@@ -1,7 +1,7 @@
 import type { Options } from 'tsup';
 
 export default <Options>{
-    entry: ['index.ts', 'src/**/*.ts'],
+    entry: ['index.ts', 'cli.ts', 'src/**/*.ts'],
     format: ['esm'],
     target: 'node18',
     clean: true,