@nexical/cli-core 0.1.0 → 0.1.2

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-IIOHHU2E.js";
+import "../../chunk-2HJDWSDA.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-2HJDWSDA.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,9 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  runCommand
+} from "../../chunk-SNTKHUTX.js";
+import "../../chunk-2HJDWSDA.js";
+export {
+  runCommand
+};
+//# sourceMappingURL=shell.js.map

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

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

package/index.ts

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

package/package.json

@@ -1,11 +1,16 @@
 {
     "name": "@nexical/cli-core",
-    "version": "0.1.0",
+    "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/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/src/utils/logger.ts

@@ -2,9 +2,9 @@ import { consola, LogLevels } from 'consola';
 
 export const logger = consola.create({
     defaults: {
-        tag: 'DEBUG',
+        tag: 'CLI',
     },
-    level: LogLevels.info, // Default to info
+    level: LogLevels.info
 });
 
 export function setDebugMode(enabled: boolean) {

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,