@nicolasmondain/cli-agent 2.1.0

package/dist/executor/ts-executor.js

@@ -0,0 +1,134 @@
+/**
+ * TypeScript Executor
+ *
+ * Executes .ts files using tsx (preferred) or ts-node.
+ */
+import { spawn } from 'node:child_process';
+import { pathExists } from '../services/file-system.service.js';
+/**
+ * Execute a TypeScript file
+ *
+ * Strategy:
+ * 1. Try to use tsx (fast, modern TS executor)
+ * 2. Fall back to ts-node
+ * 3. Return error with installation instructions if neither available
+ *
+ * The script must export a default async function that accepts ScriptContext
+ * and returns a CommandResult.
+ *
+ * @param scriptPath - Absolute path to the TypeScript file
+ * @param context - Execution context
+ * @returns Script execution result
+ */
+export async function executeTypeScript(scriptPath, context) {
+    // Check if file exists
+    if (!(await pathExists(scriptPath))) {
+        return {
+            success: false,
+            error: `Script not found: ${scriptPath}`,
+        };
+    }
+    // Serialize context to pass to the script via environment variable
+    const contextJson = JSON.stringify(context);
+    // Try tsx first, then ts-node
+    const executors = ['tsx', 'ts-node'];
+    for (const executor of executors) {
+        const result = await runWithExecutor(executor, scriptPath, contextJson);
+        if (result !== null) {
+            return result;
+        }
+    }
+    return {
+        success: false,
+        error: 'No TypeScript executor found. Please install one:\n' +
+            '  npm install -g tsx     (recommended, faster)\n' +
+            '  npm install -g ts-node',
+    };
+}
+/**
+ * Run script with a specific TypeScript executor
+ * Returns null if executor is not available
+ */
+async function runWithExecutor(executor, scriptPath, contextJson) {
+    return new Promise((resolve) => {
+        const child = spawn(executor, [scriptPath], {
+            env: {
+                ...process.env,
+                CLI_AGENT_CONTEXT: contextJson,
+            },
+            stdio: ['inherit', 'pipe', 'pipe'],
+            shell: false,
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('error', (error) => {
+            // Executor not found - return null to try next one
+            if (error.code === 'ENOENT') {
+                resolve(null);
+            }
+            else {
+                resolve({
+                    success: false,
+                    error: `Failed to execute with ${executor}: ${error.message}`,
+                });
+            }
+        });
+        child.on('close', (code) => {
+            // Try to parse JSON output from script
+            const trimmedStdout = stdout.trim();
+            if (trimmedStdout) {
+                try {
+                    const result = JSON.parse(trimmedStdout);
+                    if (typeof result === 'object' && 'success' in result) {
+                        resolve(result);
+                        return;
+                    }
+                }
+                catch {
+                    // Not JSON output, continue to wrap
+                }
+            }
+            // Script didn't output valid JSON result, wrap output
+            if (code === 0) {
+                resolve({
+                    success: true,
+                    message: trimmedStdout || 'Script completed successfully',
+                });
+            }
+            else {
+                resolve({
+                    success: false,
+                    error: stderr.trim() || trimmedStdout || `Script exited with code ${code}`,
+                });
+            }
+        });
+    });
+}
+/**
+ * Helper to get context in TypeScript scripts
+ *
+ * Usage in script:
+ * ```typescript
+ * import { getScriptContext } from 'cli-agent';
+ * const context = getScriptContext();
+ * ```
+ */
+export function getScriptContext() {
+    const contextJson = process.env.CLI_AGENT_CONTEXT;
+    if (!contextJson) {
+        return null;
+    }
+    try {
+        return JSON.parse(contextJson);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=ts-executor.js.map

package/dist/executor/ts-executor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Library Entry Point
+ *
+ * Exports the public API for consumers to use in their scripts.
+ */
+export type { OutputFormat, LogLevel, CommandResult, ScriptContext, ExitCodeValue, } from "./types/index.js";
+export { ExitCode } from "./types/index.js";
+export type { CliConfig, CommandConfig, ArgumentConfig, OptionConfig, LoadConfigResult, } from "./config/config-schema.js";
+export { toKebabCase, toPascalCase, toCamelCase, toScreamingSnakeCase, isValidFeatureName, getFeatureNameError, } from "./services/naming.service.js";
+export { pathExists, isDirectory, createDirectory, createFile, resolvePath, joinPath, createEntries, checkExistingPaths, } from "./services/file-system.service.js";
+export { setLogLevel, getLogLevel, logError, logWarn, logInfo, logSuccess, logDebug, logTrace, logBox, resetLogger, } from "./infra/logger.js";
+export { outputResult } from "./infra/output.js";
+export { getScriptContext } from "./executor/ts-executor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,YAAY,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,YAAY,EACZ,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,UAAU,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,OAAO,EACP,OAAO,EACP,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * Library Entry Point
+ *
+ * Exports the public API for consumers to use in their scripts.
+ */
+export { ExitCode } from "./types/index.js";
+// Utility Services (consumers can use these in their scripts)
+export { toKebabCase, toPascalCase, toCamelCase, toScreamingSnakeCase, isValidFeatureName, getFeatureNameError, } from "./services/naming.service.js";
+export { pathExists, isDirectory, createDirectory, createFile, resolvePath, joinPath, createEntries, checkExistingPaths, } from "./services/file-system.service.js";
+// Infrastructure (consumers can use these in their scripts)
+export { setLogLevel, getLogLevel, logError, logWarn, logInfo, logSuccess, logDebug, logTrace, logBox, resetLogger, } from "./infra/logger.js";
+export { outputResult } from "./infra/output.js";
+// Script context helper (for TypeScript scripts executed via tsx/ts-node)
+export { getScriptContext } from "./executor/ts-executor.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAW5C,8DAA8D;AAC9D,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,UAAU,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAE3C,4DAA4D;AAC5D,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,OAAO,EACP,OAAO,EACP,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,0EAA0E;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/infra/logger.d.ts

@@ -0,0 +1,42 @@
+import type { LogLevel } from '../types/index.js';
+/**
+ * Set the log level for the logger
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Get the current log level
+ */
+export declare function getLogLevel(): LogLevel;
+/**
+ * Log an error message (always shown unless quiet)
+ */
+export declare function logError(message: string, ...args: unknown[]): void;
+/**
+ * Log a warning message
+ */
+export declare function logWarn(message: string, ...args: unknown[]): void;
+/**
+ * Log an info message
+ */
+export declare function logInfo(message: string, ...args: unknown[]): void;
+/**
+ * Log a success message
+ */
+export declare function logSuccess(message: string, ...args: unknown[]): void;
+/**
+ * Log a debug message (only in verbose/debug mode)
+ */
+export declare function logDebug(message: string, ...args: unknown[]): void;
+/**
+ * Log a trace message (only in debug mode)
+ */
+export declare function logTrace(message: string, ...args: unknown[]): void;
+/**
+ * Create a boxed message for important outputs
+ */
+export declare function logBox(message: string): void;
+/**
+ * Reset logger instance (useful for testing)
+ */
+export declare function resetLogger(): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/infra/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/infra/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAoClD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAKjD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAEpE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC"}

package/dist/infra/logger.js

@@ -0,0 +1,96 @@
+import { createConsola } from 'consola';
+/**
+ * Logger instance configured for CLI usage
+ * - All logs go to stderr (keeps stdout clean for results)
+ * - Supports different verbosity levels
+ */
+let loggerInstance = null;
+let currentLogLevel = 'normal';
+/**
+ * Map our log levels to consola log levels
+ */
+const LOG_LEVEL_MAP = {
+    quiet: -1, // Only errors
+    normal: 3, // Info and above
+    verbose: 4, // Debug and above
+    debug: 5, // Trace and above
+};
+/**
+ * Create or get the logger instance
+ */
+function getLogger() {
+    if (!loggerInstance) {
+        loggerInstance = createConsola({
+            level: LOG_LEVEL_MAP[currentLogLevel],
+            // Force output to stderr
+            stderr: process.stderr,
+            stdout: process.stderr,
+        });
+    }
+    return loggerInstance;
+}
+/**
+ * Set the log level for the logger
+ */
+export function setLogLevel(level) {
+    currentLogLevel = level;
+    if (loggerInstance) {
+        loggerInstance.level = LOG_LEVEL_MAP[level];
+    }
+}
+/**
+ * Get the current log level
+ */
+export function getLogLevel() {
+    return currentLogLevel;
+}
+/**
+ * Log an error message (always shown unless quiet)
+ */
+export function logError(message, ...args) {
+    getLogger().error(message, ...args);
+}
+/**
+ * Log a warning message
+ */
+export function logWarn(message, ...args) {
+    getLogger().warn(message, ...args);
+}
+/**
+ * Log an info message
+ */
+export function logInfo(message, ...args) {
+    getLogger().info(message, ...args);
+}
+/**
+ * Log a success message
+ */
+export function logSuccess(message, ...args) {
+    getLogger().success(message, ...args);
+}
+/**
+ * Log a debug message (only in verbose/debug mode)
+ */
+export function logDebug(message, ...args) {
+    getLogger().debug(message, ...args);
+}
+/**
+ * Log a trace message (only in debug mode)
+ */
+export function logTrace(message, ...args) {
+    getLogger().trace(message, ...args);
+}
+/**
+ * Create a boxed message for important outputs
+ */
+export function logBox(message) {
+    getLogger().box(message);
+}
+/**
+ * Reset logger instance (useful for testing)
+ */
+export function resetLogger() {
+    loggerInstance = null;
+    currentLogLevel = 'normal';
+}
+//# sourceMappingURL=logger.js.map

package/dist/infra/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/infra/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAwB,MAAM,SAAS,CAAC;AAG9D;;;;GAIG;AAEH,IAAI,cAAc,GAA2B,IAAI,CAAC;AAClD,IAAI,eAAe,GAAa,QAAQ,CAAC;AAEzC;;GAEG;AACH,MAAM,aAAa,GAA6B;IAC9C,KAAK,EAAE,CAAC,CAAC,EAAK,cAAc;IAC5B,MAAM,EAAE,CAAC,EAAK,iBAAiB;IAC/B,OAAO,EAAE,CAAC,EAAI,kBAAkB;IAChC,KAAK,EAAE,CAAC,EAAM,kBAAkB;CACjC,CAAC;AAEF;;GAEG;AACH,SAAS,SAAS;IAChB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,aAAa,CAAC;YAC7B,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC;YACrC,yBAAyB;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,eAAe,GAAG,KAAK,CAAC;IACxB,IAAI,cAAc,EAAE,CAAC;QACnB,cAAc,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,GAAG,IAAe;IAC1D,SAAS,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe;IACzD,SAAS,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe;IACzD,SAAS,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,GAAG,IAAe;IAC5D,SAAS,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,GAAG,IAAe;IAC1D,SAAS,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,GAAG,IAAe;IAC1D,SAAS,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,OAAe;IACpC,SAAS,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,cAAc,GAAG,IAAI,CAAC;IACtB,eAAe,GAAG,QAAQ,CAAC;AAC7B,CAAC"}

package/dist/infra/output.d.ts

@@ -0,0 +1,11 @@
+import type { CommandResult, OutputFormat } from "../types/index.js";
+/**
+ * Output utilities for CLI commands
+ * - Results go to stdout (for piping/parsing)
+ * - Supports human-readable and JSON formats
+ */
+/**
+ * Output a result to stdout in the specified format
+ */
+export declare function outputResult<T>(result: CommandResult<T>, format: OutputFormat): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/infra/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/infra/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,MAAM,EAAE,YAAY,GACnB,IAAI,CAMN"}

package/dist/infra/output.js

@@ -0,0 +1,70 @@
+/**
+ * Output utilities for CLI commands
+ * - Results go to stdout (for piping/parsing)
+ * - Supports human-readable and JSON formats
+ */
+/**
+ * Output a result to stdout in the specified format
+ */
+export function outputResult(result, format) {
+    if (format === "json") {
+        outputJson(result);
+    }
+    else {
+        outputHuman(result);
+    }
+}
+/**
+ * Output result as JSON to stdout
+ */
+function outputJson(result) {
+    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+}
+/**
+ * Output result in human-readable format to stdout
+ */
+function outputHuman(result) {
+    if (result.success) {
+        if (result.message) {
+            console.log(result.message);
+        }
+        if (result.data !== undefined) {
+            formatData(result.data);
+        }
+    }
+    else {
+        console.error(`Error: ${result.error ?? "Unknown error"}`);
+    }
+}
+/**
+ * Format data for human-readable output
+ */
+function formatData(data) {
+    if (data === null || data === undefined) {
+        return;
+    }
+    if (typeof data === "string") {
+        // String data - output directly
+        console.log(data);
+    }
+    else if (typeof data === "number" || typeof data === "boolean") {
+        // Primitive data - output directly
+        console.log(String(data));
+    }
+    else if (Array.isArray(data)) {
+        // Array data - output each item
+        for (const item of data) {
+            if (typeof item === "object" && item !== null) {
+                console.log(JSON.stringify(item, null, 2));
+            }
+            else {
+                console.log(String(item));
+            }
+        }
+    }
+    else if (typeof data === "object") {
+        // Object data - pretty print JSON
+        console.log(JSON.stringify(data, null, 2));
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/infra/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/infra/output.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAwB,EACxB,MAAoB;IAEpB,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,UAAU,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAI,MAAwB;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAI,MAAwB;IAC9C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAI,IAAO;IAC5B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO;IACT,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,gCAAgC;QAChC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;SAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,SAAS,EAAE,CAAC;QACjE,mCAAmC;QACnC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5B,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,gCAAgC;QAChC,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC9C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,kCAAkC;QAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/mcp/manifest-generator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * MCP Manifest Generator
+ *
+ * Converts cli-agent configuration to MCP (Model Context Protocol) tool manifest.
+ * This enables native integration with Claude Code and other MCP-compatible clients.
+ */
+import type { CliConfig, CommandConfig } from "../config/config-schema.js";
+/**
+ * MCP Tool Input Schema (JSON Schema format)
+ */
+export interface McpInputSchema {
+    type: "object";
+    properties: Record<string, McpPropertySchema>;
+    required?: string[];
+}
+/**
+ * MCP Property Schema
+ */
+export interface McpPropertySchema {
+    type: string;
+    description?: string;
+    default?: unknown;
+    enum?: string[];
+}
+/**
+ * MCP Tool Definition
+ */
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: McpInputSchema;
+}
+/**
+ * MCP Tools Manifest
+ */
+export interface McpManifest {
+    tools: McpTool[];
+}
+/**
+ * Convert a command config to MCP tool definition
+ */
+export declare function commandToMcpTool(cmd: CommandConfig): McpTool;
+/**
+ * Generate MCP manifest from cli-agent configuration
+ */
+export declare function generateMcpManifest(config: CliConfig): McpManifest;
+/**
+ * Generate MCP manifest as formatted JSON string
+ */
+export declare function generateMcpManifestJson(config: CliConfig, pretty?: boolean): string;
+//# sourceMappingURL=manifest-generator.d.ts.map

package/dist/mcp/manifest-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-generator.d.ts","sourceRoot":"","sources":["../../src/mcp/manifest-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAGd,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAmFD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CA0C5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAIlE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,UAAO,GACZ,MAAM,CAGR"}

package/dist/mcp/manifest-generator.js

@@ -0,0 +1,130 @@
+/**
+ * MCP Manifest Generator
+ *
+ * Converts cli-agent configuration to MCP (Model Context Protocol) tool manifest.
+ * This enables native integration with Claude Code and other MCP-compatible clients.
+ */
+/**
+ * Parse option flags to extract the option name
+ * Examples:
+ *   "-n, --name <value>" -> "name"
+ *   "--verbose" -> "verbose"
+ *   "-f, --force" -> "force"
+ */
+function parseOptionName(flags) {
+    // Match --option-name or -o, --option-name patterns
+    const match = flags.match(/--([a-zA-Z][\w-]*)/);
+    if (match && match[1]) {
+        return match[1];
+    }
+    return flags.replace(/[^a-zA-Z0-9-]/g, "");
+}
+/**
+ * Determine if option takes a value based on flags
+ * Examples:
+ *   "-n, --name <value>" -> true (required value)
+ *   "--count [num]" -> true (optional value)
+ *   "--verbose" -> false (boolean flag)
+ */
+function optionTakesValue(flags) {
+    return flags.includes("<") || flags.includes("[");
+}
+/**
+ * Convert an argument config to MCP property schema
+ */
+function argumentToProperty(arg) {
+    const property = {
+        type: "string",
+    };
+    if (arg.description) {
+        property.description = arg.description;
+    }
+    if (arg.variadic) {
+        // Variadic arguments accept multiple values
+        return {
+            type: "array",
+            description: arg.description,
+        };
+    }
+    return property;
+}
+/**
+ * Convert an option config to MCP property schema
+ */
+function optionToProperty(opt) {
+    const takesValue = optionTakesValue(opt.flags);
+    const property = {
+        type: takesValue ? "string" : "boolean",
+    };
+    if (opt.description) {
+        property.description = opt.description;
+    }
+    if (opt.default !== undefined) {
+        property.default = opt.default;
+        // Infer type from default value
+        if (typeof opt.default === "number") {
+            property.type = "number";
+        }
+        else if (typeof opt.default === "boolean") {
+            property.type = "boolean";
+        }
+    }
+    if (opt.choices && opt.choices.length > 0) {
+        property.enum = opt.choices;
+    }
+    return property;
+}
+/**
+ * Convert a command config to MCP tool definition
+ */
+export function commandToMcpTool(cmd) {
+    const properties = {};
+    const required = [];
+    // Convert arguments
+    if (cmd.arguments) {
+        for (const arg of cmd.arguments) {
+            properties[arg.name] = argumentToProperty(arg);
+            // Arguments are required by default unless explicitly set to false
+            if (arg.required !== false) {
+                required.push(arg.name);
+            }
+        }
+    }
+    // Convert options
+    if (cmd.options) {
+        for (const opt of cmd.options) {
+            const optName = parseOptionName(opt.flags);
+            properties[optName] = optionToProperty(opt);
+            if (opt.required) {
+                required.push(optName);
+            }
+        }
+    }
+    const tool = {
+        name: cmd.name,
+        description: cmd.description ?? `Execute ${cmd.name} command`,
+        inputSchema: {
+            type: "object",
+            properties,
+        },
+    };
+    if (required.length > 0) {
+        tool.inputSchema.required = required;
+    }
+    return tool;
+}
+/**
+ * Generate MCP manifest from cli-agent configuration
+ */
+export function generateMcpManifest(config) {
+    const tools = config.commands.map(commandToMcpTool);
+    return { tools };
+}
+/**
+ * Generate MCP manifest as formatted JSON string
+ */
+export function generateMcpManifestJson(config, pretty = true) {
+    const manifest = generateMcpManifest(config);
+    return pretty ? JSON.stringify(manifest, null, 2) : JSON.stringify(manifest);
+}
+//# sourceMappingURL=manifest-generator.js.map

package/dist/mcp/manifest-generator.js.map

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

package/dist/services/file-system.service.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Represents a file or directory to be created
+ */
+export interface FileEntry {
+    /** Relative path from the base directory */
+    path: string;
+    /** Type of entry */
+    type: "file" | "directory";
+    /** Content for files (undefined for directories) */
+    content?: string;
+}
+/**
+ * File system service for creating files and directories
+ */
+/**
+ * Check if a path exists
+ */
+export declare function pathExists(path: string): Promise<boolean>;
+/**
+ * Check if a path is a directory
+ */
+export declare function isDirectory(path: string): Promise<boolean>;
+/**
+ * Create a directory (and parent directories if needed)
+ */
+export declare function createDirectory(path: string): Promise<void>;
+/**
+ * Create a file with content
+ * Creates parent directories if they don't exist
+ */
+export declare function createFile(path: string, content: string): Promise<void>;
+/**
+ * Resolve a path relative to a base path
+ */
+export declare function resolvePath(basePath: string, relativePath: string): string;
+/**
+ * Join path segments
+ */
+export declare function joinPath(...segments: string[]): string;
+/**
+ * Create all entries (files and directories) for a feature
+ * Returns the list of created paths
+ */
+export declare function createEntries(basePath: string, entries: FileEntry[]): Promise<{
+    files: string[];
+    directories: string[];
+}>;
+/**
+ * Check if any of the given paths already exist
+ * Returns the list of existing paths
+ */
+export declare function checkExistingPaths(basePath: string, paths: string[]): Promise<string[]>;
+//# sourceMappingURL=file-system.service.d.ts.map