@nexical/cli-core 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,195 @@
+# @nexical/cli-core
+
+The core framework for building powerful, extensible Command Line Interfaces (CLIs) within the Nexical ecosystem.
+
+This package provides the foundational architecture for specialized CLI toolsets, including command discovery, execution orchestration, and a class-based command pattern. It is designed to be **agnostic**, allowing it to be used as the backbone for other CLI tools that need a similar structure and extensibility.
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+    - [Configuration](#configuration)
+    - [Directory Structure](#directory-structure)
+- [Creating Commands](#creating-commands)
+    - [The BaseCommand](#the-basecommand)
+    - [Defining Arguments & Options](#defining-arguments--options)
+    - [Command Discovery Rules](#command-discovery-rules)
+- [Architecture](#architecture)
+- [License](#license)
+
+---
+
+## Features
+
+*   **Class-Based Architecture**: Build commands as TypeScript classes with inheritance and lifecycle methods.
+*   **Dynamic Discovery**: Automatically recursively finds and registers commands from specified directories.
+*   **Type-Safe Definitions**: Declarative definition of arguments and options.
+*   **Built-in Help**: Automatic generation of help text for commands and subcommands.
+*   **Configuration Support**: Aware of project-level configuration (e.g., `{command_name}.yml`).
+*   **Robust Error Handling**: Standardized error reporting and debug modes.
+
+---
+
+## Installation
+
+This package is typically used as a dependency within a specific CLI implementation (like `@astrical/cli`).
+
+```bash
+npm install @nexical/cli-core
+```
+
+---
+
+## Usage
+
+To use the core framework, you need to instantiate the `CLI` class and start it. This is typically done in your CLI's entry point (e.g., `index.ts`).
+
+### Configuration
+
+The `CLI` class accepts a `CLIConfig` object to customize behavior:
+
+```typescript
+import { CLI } from '@nexical/cli-core';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const app = new CLI({
+    // 1. The name of your binary/command (displayed in help)
+    commandName: 'my-cli', 
+
+    // 2. Directories to recursively search for command files
+    searchDirectories: [
+        path.resolve(__dirname, 'commands'),
+        // You can add multiple directories, e.g., for plugins
+        path.resolve(process.cwd(), 'plugins/commands')
+    ]
+});
+
+app.start();
+```
+
+### Directory Structure
+
+A typical project using `@nexical/cli-core` looks like this:
+
+```
+my-cli/
+├── package.json
+├── src/
+│   ├── index.ts        <-- Entry point (initializes CLI)
+│   └── commands/       <-- Command files
+│       ├── init.ts
+│       ├── build.ts
+│       └── module/     <-- Subcommands
+│           ├── add.ts
+│           └── list.ts
+```
+
+---
+
+## Creating Commands
+
+The core framework itself only includes a **Help** command. All functional commands must be implemented by consuming libraries.
+
+### The BaseCommand
+
+All commands must extend the `BaseCommand` abstract class exported by the core.
+
+```typescript
+// src/commands/greet.ts
+import { BaseCommand } from '@nexical/cli-core';
+
+export default class GreetCommand extends BaseCommand {
+    // Description shown in help
+    static description = 'Greets the user';
+
+    // Implement the run method
+    async run(options: any) {
+        this.log('Hello from my-cli!');
+    }
+}
+```
+
+### Defining Arguments & Options
+
+You can define arguments and options using the static `args` property.
+
+```typescript
+export default class GreetCommand extends BaseCommand {
+    static description = 'Greets the user with a custom message';
+
+    static args = {
+        // Positional arguments
+        args: [
+            { 
+                name: 'name', 
+                required: false, 
+                description: 'Name to greet',
+                default: 'World'
+            }
+        ],
+        // Flags/Options
+        options: [
+            { 
+                name: '--shout', 
+                description: 'Print in uppercase', 
+                default: false 
+            },
+            {
+                name: '--count <n>',
+                description: 'Number of times to greet',
+                default: 1
+            }
+        ]
+    };
+
+    async run(options: any) {
+        // 'name' comes from args (mapped to options by name)
+        // 'shout' and 'count' come from options
+        const { name, shout, count } = options;
+        
+        const message = `Hello, ${name}!`;
+        const finalMessage = shout ? message.toUpperCase() : message;
+
+        for (let i = 0; i < count; i++) {
+            this.log(finalMessage);
+        }
+    }
+}
+```
+
+### Command Discovery Rules
+
+The `CommandLoader` uses the file structure to determine command names:
+
+*   **File Name = Command Name**: 
+    *   `commands/build.ts` -> `my-cli build`
+*   **Nested Directories = Subcommands**:
+    *   `commands/user/create.ts` -> `my-cli user create`
+*   **Index Files = Parent Command**:
+    *   `commands/user/index.ts` -> `my-cli user` (The handler for the root `user` command)
+    
+> **Note**: A file must default export a class extending `BaseCommand` to be registered.
+
+---
+
+## Architecture
+
+The core is built around three main components:
+
+1.  **`CLI`**: The main entry point. It wraps [CAC](https://github.com/cacjs/cac) to handle argument parsing and acts as the dependency injection container for commands.
+2.  **`CommandLoader`**: Scans the filesystem for command files. It handles importing typescript files and validating that they export a valid command class.
+3.  **`BaseCommand`**: Provides the interface for commands, including:
+    *   `init()`: Async initialization hook (pre-run).
+    *   `run()`: The main execution logic.
+    *   `this.projectRoot`: Automatically resolved path to the project root (if running in a project context).
+    *   Logging helpers (`this.success`, `this.warn`, `this.error`).
+
+---
+
+## License
+
+Apache-2.0

package/cli.ts

@@ -0,0 +1,9 @@
+#!/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();

package/dist/chunk-2NZ4H42M.js

@@ -0,0 +1,255 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  CommandLoader
+} from "./chunk-PFEYDXIW.js";
+import {
+  logger,
+  setDebugMode
+} from "./chunk-HETFF3FQ.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.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/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-2NZ4H42M.js.map

package/dist/chunk-2NZ4H42M.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.1\",\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/chunk-5YGASH25.js

@@ -0,0 +1,48 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  logger
+} from "./chunk-HETFF3FQ.js";
+
+// src/utils/config.ts
+import { lilconfig } from "lilconfig";
+import path from "path";
+import YAML from "yaml";
+var loadYaml = (filepath, content) => {
+  return YAML.parse(content);
+};
+async function findProjectRoot(commandName, startDir) {
+  const searchPlaces = [`${commandName}.yml`, `${commandName}.yaml`];
+  const explorer = lilconfig(commandName, {
+    searchPlaces,
+    loaders: {
+      ".yml": loadYaml,
+      ".yaml": loadYaml
+    }
+  });
+  const result = await explorer.search(startDir);
+  if (result) {
+    logger.debug(`Project root found at: ${path.dirname(result.filepath)}`);
+    return path.dirname(result.filepath);
+  }
+  return null;
+}
+async function loadConfig(commandName, rootDir) {
+  const searchPlaces = [`${commandName}.yml`, `${commandName}.yaml`];
+  const explorer = lilconfig(commandName, {
+    searchPlaces,
+    loaders: {
+      ".yml": loadYaml,
+      ".yaml": loadYaml
+    }
+  });
+  const result = await explorer.search(rootDir);
+  logger.debug(result ? `Loaded config from ${result.filepath}` : `No config found in ${rootDir}`);
+  return result ? result.config : {};
+}
+
+export {
+  loadYaml,
+  findProjectRoot,
+  loadConfig
+};
+//# sourceMappingURL=chunk-5YGASH25.js.map

package/dist/chunk-5YGASH25.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/config.ts"],"sourcesContent":["import { lilconfig, type Loader } from 'lilconfig';\nimport path from 'node:path';\nimport YAML from 'yaml';\nimport { logger } from './logger.js';\n\nexport const loadYaml: Loader = (filepath, content) => {\n    return YAML.parse(content);\n};\n\nexport async function findProjectRoot(commandName: string, startDir: string): Promise<string | null> {\n    const searchPlaces = [`${commandName}.yml`, `${commandName}.yaml`];\n\n    // We use lilconfig to find the file up the tree\n    const explorer = lilconfig(commandName, {\n        searchPlaces,\n        loaders: {\n            '.yml': loadYaml,\n            '.yaml': loadYaml,\n        }\n    });\n\n    const result = await explorer.search(startDir);\n    if (result) {\n        logger.debug(`Project root found at: ${path.dirname(result.filepath)}`);\n        return path.dirname(result.filepath);\n    }\n\n    return null;\n}\n\nexport async function loadConfig(commandName: string, rootDir: string): Promise<any> {\n    const searchPlaces = [`${commandName}.yml`, `${commandName}.yaml`];\n    const explorer = lilconfig(commandName, {\n        searchPlaces,\n        loaders: {\n            '.yml': loadYaml,\n            '.yaml': loadYaml,\n        }\n    });\n    const result = await explorer.search(rootDir);\n    logger.debug(result ? `Loaded config from ${result.filepath}` : `No config found in ${rootDir}`);\n    return result ? result.config : {};\n}\n"],"mappings":";;;;;;AAAA,SAAS,iBAA8B;AACvC,OAAO,UAAU;AACjB,OAAO,UAAU;AAGV,IAAM,WAAmB,CAAC,UAAU,YAAY;AACnD,SAAO,KAAK,MAAM,OAAO;AAC7B;AAEA,eAAsB,gBAAgB,aAAqB,UAA0C;AACjG,QAAM,eAAe,CAAC,GAAG,WAAW,QAAQ,GAAG,WAAW,OAAO;AAGjE,QAAM,WAAW,UAAU,aAAa;AAAA,IACpC;AAAA,IACA,SAAS;AAAA,MACL,QAAQ;AAAA,MACR,SAAS;AAAA,IACb;AAAA,EACJ,CAAC;AAED,QAAM,SAAS,MAAM,SAAS,OAAO,QAAQ;AAC7C,MAAI,QAAQ;AACR,WAAO,MAAM,0BAA0B,KAAK,QAAQ,OAAO,QAAQ,CAAC,EAAE;AACtE,WAAO,KAAK,QAAQ,OAAO,QAAQ;AAAA,EACvC;AAEA,SAAO;AACX;AAEA,eAAsB,WAAW,aAAqB,SAA+B;AACjF,QAAM,eAAe,CAAC,GAAG,WAAW,QAAQ,GAAG,WAAW,OAAO;AACjE,QAAM,WAAW,UAAU,aAAa;AAAA,IACpC;AAAA,IACA,SAAS;AAAA,MACL,QAAQ;AAAA,MACR,SAAS;AAAA,IACb;AAAA,EACJ,CAAC;AACD,QAAM,SAAS,MAAM,SAAS,OAAO,OAAO;AAC5C,SAAO,MAAM,SAAS,sBAAsB,OAAO,QAAQ,KAAK,sBAAsB,OAAO,EAAE;AAC/F,SAAO,SAAS,OAAO,SAAS,CAAC;AACrC;","names":[]}

package/dist/chunk-6LSNSDTL.js

@@ -0,0 +1,67 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  findProjectRoot,
+  loadConfig
+} from "./chunk-5YGASH25.js";
+import {
+  logger
+} from "./chunk-HETFF3FQ.js";
+
+// src/BaseCommand.ts
+import process from "process";
+var BaseCommand = class {
+  static usage = "";
+  static description = "";
+  static args = {};
+  // Configurable flags
+  static requiresProject = false;
+  projectRoot = null;
+  config = {};
+  globalOptions = {};
+  cli = null;
+  constructor(cli, globalOptions = {}) {
+    this.globalOptions = globalOptions;
+    this.cli = cli;
+  }
+  async init() {
+    if (this.globalOptions.rootDir) {
+      this.projectRoot = this.globalOptions.rootDir;
+    } else {
+      this.projectRoot = await findProjectRoot(this.cli.name, process.cwd());
+    }
+    const requiresProject = this.constructor.requiresProject;
+    if (requiresProject && !this.projectRoot) {
+      this.error("This command requires to be run within an app project (app.yml not found).", 1);
+      return;
+    }
+    if (this.projectRoot) {
+      this.config = await loadConfig(this.cli.name, this.projectRoot);
+    }
+  }
+  // Helpers
+  success(msg) {
+    logger.success(msg);
+  }
+  info(msg) {
+    logger.info(msg);
+  }
+  warn(msg) {
+    logger.warn(msg);
+  }
+  error(msg, code = 1) {
+    if (msg instanceof Error) {
+      logger.error(msg.message);
+      if (this.globalOptions.debug) {
+        logger.error(msg.stack);
+      }
+    } else {
+      logger.error(msg);
+    }
+    process.exit(code);
+  }
+};
+
+export {
+  BaseCommand
+};
+//# sourceMappingURL=chunk-6LSNSDTL.js.map

package/dist/chunk-6LSNSDTL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/BaseCommand.ts"],"sourcesContent":["import { logger } from './utils/logger.js';\nimport { CommandDefinition, CommandInterface } from './CommandInterface.js';\nimport { findProjectRoot, loadConfig } from './utils/config.js';\nimport process from 'node:process';\n\nexport abstract class BaseCommand implements CommandInterface {\n    static usage = '';\n    static description = '';\n    static args: CommandDefinition = {};\n\n    // Configurable flags\n    static requiresProject = false;\n\n    protected projectRoot: string | null = null;\n    protected config: any = {};\n    protected globalOptions: any = {};\n    protected cli: any = null;\n\n\n    constructor(cli: any, globalOptions: any = {}) {\n        this.globalOptions = globalOptions;\n        this.cli = cli;\n    }\n\n    async init() {\n        // 1. Root detection strategy\n        if (this.globalOptions.rootDir) {\n            this.projectRoot = this.globalOptions.rootDir;\n        } else {\n            this.projectRoot = await findProjectRoot(this.cli.name, process.cwd());\n        }\n\n        const requiresProject = (this.constructor as any).requiresProject;\n\n        if (requiresProject && !this.projectRoot) {\n            this.error('This command requires to be run within an app project (app.yml not found).', 1);\n            return; // TS doesn't know error exits\n        }\n\n        if (this.projectRoot) {\n            this.config = await loadConfig(this.cli.name, this.projectRoot);\n            // logger.debug(`Loaded config from ${this.projectRoot}`);\n        }\n    }\n\n    abstract run(options: any): Promise<void>;\n\n    // Helpers\n    success(msg: string) {\n        logger.success(msg);\n    }\n\n\n    info(msg: string) {\n        logger.info(msg);\n    }\n\n    warn(msg: string) {\n        logger.warn(msg);\n    }\n\n    error(msg: string | Error, code = 1) {\n        if (msg instanceof Error) {\n            logger.error(msg.message);\n            if (this.globalOptions.debug) {\n                logger.error(msg.stack);\n            }\n        } else {\n            logger.error(msg);\n        }\n        process.exit(code);\n    }\n}\n"],"mappings":";;;;;;;;;;AAGA,OAAO,aAAa;AAEb,IAAe,cAAf,MAAuD;AAAA,EAC1D,OAAO,QAAQ;AAAA,EACf,OAAO,cAAc;AAAA,EACrB,OAAO,OAA0B,CAAC;AAAA;AAAA,EAGlC,OAAO,kBAAkB;AAAA,EAEf,cAA6B;AAAA,EAC7B,SAAc,CAAC;AAAA,EACf,gBAAqB,CAAC;AAAA,EACtB,MAAW;AAAA,EAGrB,YAAY,KAAU,gBAAqB,CAAC,GAAG;AAC3C,SAAK,gBAAgB;AACrB,SAAK,MAAM;AAAA,EACf;AAAA,EAEA,MAAM,OAAO;AAET,QAAI,KAAK,cAAc,SAAS;AAC5B,WAAK,cAAc,KAAK,cAAc;AAAA,IAC1C,OAAO;AACH,WAAK,cAAc,MAAM,gBAAgB,KAAK,IAAI,MAAM,QAAQ,IAAI,CAAC;AAAA,IACzE;AAEA,UAAM,kBAAmB,KAAK,YAAoB;AAElD,QAAI,mBAAmB,CAAC,KAAK,aAAa;AACtC,WAAK,MAAM,8EAA8E,CAAC;AAC1F;AAAA,IACJ;AAEA,QAAI,KAAK,aAAa;AAClB,WAAK,SAAS,MAAM,WAAW,KAAK,IAAI,MAAM,KAAK,WAAW;AAAA,IAElE;AAAA,EACJ;AAAA;AAAA,EAKA,QAAQ,KAAa;AACjB,WAAO,QAAQ,GAAG;AAAA,EACtB;AAAA,EAGA,KAAK,KAAa;AACd,WAAO,KAAK,GAAG;AAAA,EACnB;AAAA,EAEA,KAAK,KAAa;AACd,WAAO,KAAK,GAAG;AAAA,EACnB;AAAA,EAEA,MAAM,KAAqB,OAAO,GAAG;AACjC,QAAI,eAAe,OAAO;AACtB,aAAO,MAAM,IAAI,OAAO;AACxB,UAAI,KAAK,cAAc,OAAO;AAC1B,eAAO,MAAM,IAAI,KAAK;AAAA,MAC1B;AAAA,IACJ,OAAO;AACH,aAAO,MAAM,GAAG;AAAA,IACpB;AACA,YAAQ,KAAK,IAAI;AAAA,EACrB;AACJ;","names":[]}

package/dist/chunk-C4IL52NB.js

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

package/dist/chunk-C4IL52NB.js.map

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

package/dist/chunk-HETFF3FQ.js

@@ -0,0 +1,20 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+
+// src/utils/logger.ts
+import { consola, LogLevels } from "consola";
+var logger = consola.create({
+  defaults: {
+    tag: "DEBUG"
+  },
+  level: LogLevels.info
+  // Default to info
+});
+function setDebugMode(enabled) {
+  logger.level = enabled ? LogLevels.debug : LogLevels.info;
+}
+
+export {
+  logger,
+  setDebugMode
+};
+//# sourceMappingURL=chunk-HETFF3FQ.js.map

package/dist/chunk-HETFF3FQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/logger.ts"],"sourcesContent":["import { consola, LogLevels } from 'consola';\n\nexport const logger = consola.create({\n    defaults: {\n        tag: 'DEBUG',\n    },\n    level: LogLevels.info, // Default to info\n});\n\nexport function setDebugMode(enabled: boolean) {\n    logger.level = enabled ? LogLevels.debug : LogLevels.info;\n}\n"],"mappings":";;;AAAA,SAAS,SAAS,iBAAiB;AAE5B,IAAM,SAAS,QAAQ,OAAO;AAAA,EACjC,UAAU;AAAA,IACN,KAAK;AAAA,EACT;AAAA,EACA,OAAO,UAAU;AAAA;AACrB,CAAC;AAEM,SAAS,aAAa,SAAkB;AAC3C,SAAO,QAAQ,UAAU,UAAU,QAAQ,UAAU;AACzD;","names":[]}