@nicolasmondain/cli-agent 3.0.2

package/dist/executor/js-executor.js

@@ -0,0 +1,77 @@
+/**
+ * JavaScript Executor
+ *
+ * Executes .js files by importing and calling their default export.
+ */
+import { pathToFileURL } from 'node:url';
+import { pathExists } from '../services/file-system.service.js';
+/**
+ * Execute a JavaScript file
+ *
+ * The script must export a default async function that accepts ScriptContext
+ * and returns a CommandResult.
+ *
+ * Example script:
+ * ```javascript
+ * export default async function(context) {
+ *   return {
+ *     success: true,
+ *     message: 'Hello!',
+ *     data: { greeting: 'Hello!' }
+ *   };
+ * }
+ * ```
+ *
+ * @param scriptPath - Absolute path to the JavaScript file
+ * @param context - Execution context
+ * @returns Script execution result
+ */
+export async function executeJavaScript(scriptPath, context) {
+    try {
+        // Check if file exists
+        if (!(await pathExists(scriptPath))) {
+            return {
+                success: false,
+                error: `Script not found: ${scriptPath}`,
+            };
+        }
+        // Use dynamic import with file URL for cross-platform compatibility
+        const scriptUrl = pathToFileURL(scriptPath).href;
+        // Add cache busting to allow re-importing modified scripts
+        const urlWithCacheBust = `${scriptUrl}?t=${Date.now()}`;
+        const module = await import(urlWithCacheBust);
+        // Check for default export
+        if (typeof module.default !== 'function') {
+            return {
+                success: false,
+                error: `Script must export a default function: ${scriptPath}`,
+            };
+        }
+        // Execute the script
+        const result = await module.default(context);
+        // Validate result structure
+        if (!isValidResult(result)) {
+            return {
+                success: false,
+                error: `Script must return an object with a 'success' boolean property: ${scriptPath}`,
+            };
+        }
+        return result;
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Script execution failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+/**
+ * Check if result has required structure
+ */
+function isValidResult(result) {
+    return (result !== null &&
+        typeof result === 'object' &&
+        'success' in result &&
+        typeof result.success === 'boolean');
+}
+//# sourceMappingURL=js-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"js-executor.js","sourceRoot":"","sources":["../../src/executor/js-executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,OAAsB;IAEtB,IAAI,CAAC;QACH,uBAAuB;QACvB,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACpC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,qBAAqB,UAAU,EAAE;aACzC,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;QAEjD,2DAA2D;QAC3D,MAAM,gBAAgB,GAAG,GAAG,SAAS,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAE9C,2BAA2B;QAC3B,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,0CAA0C,UAAU,EAAE;aAC9D,CAAC;QACJ,CAAC;QAED,qBAAqB;QACrB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE7C,4BAA4B;QAC5B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,mEAAmE,UAAU,EAAE;aACvF,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SAC5F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,MAAe;IACpC,OAAO,CACL,MAAM,KAAK,IAAI;QACf,OAAO,MAAM,KAAK,QAAQ;QAC1B,SAAS,IAAI,MAAM;QACnB,OAAQ,MAAuB,CAAC,OAAO,KAAK,SAAS,CACtD,CAAC;AACJ,CAAC"}

package/dist/executor/script-executor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Script Executor
+ *
+ * Executes external scripts (.js, .ts, .sh) and handles output.
+ */
+import type { CommandResult, OutputFormat } from '../types/index.js';
+/**
+ * Context passed to scripts during execution
+ */
+export interface ScriptContext {
+    /** Parsed positional arguments */
+    args: Record<string, unknown>;
+    /** Parsed options */
+    options: Record<string, unknown>;
+    /** Current working directory */
+    cwd: string;
+    /** Output format requested */
+    format: OutputFormat;
+}
+/**
+ * Result from script execution
+ */
+export type ScriptResult = CommandResult<unknown>;
+/**
+ * Execute a script file based on its extension
+ *
+ * @param scriptPath - Path to the script (relative to configDir)
+ * @param context - Execution context with args and options
+ * @param configDir - Directory containing the configuration file
+ * @returns Script execution result
+ */
+export declare function executeScript(scriptPath: string, context: ScriptContext, configDir: string): Promise<ScriptResult>;
+//# sourceMappingURL=script-executor.d.ts.map

package/dist/executor/script-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-executor.d.ts","sourceRoot":"","sources":["../../src/executor/script-executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKrE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;AASlD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CAwBvB"}

package/dist/executor/script-executor.js

@@ -0,0 +1,45 @@
+/**
+ * Script Executor
+ *
+ * Executes external scripts (.js, .ts, .sh) and handles output.
+ */
+import { resolve, extname } from 'node:path';
+import { executeJavaScript } from './js-executor.js';
+import { executeTypeScript } from './ts-executor.js';
+import { executeShell } from './shell-executor.js';
+/**
+ * Supported script extensions
+ */
+const JAVASCRIPT_EXTENSIONS = ['.js', '.mjs', '.cjs'];
+const TYPESCRIPT_EXTENSIONS = ['.ts', '.mts', '.cts'];
+const SHELL_EXTENSIONS = ['.sh'];
+/**
+ * Execute a script file based on its extension
+ *
+ * @param scriptPath - Path to the script (relative to configDir)
+ * @param context - Execution context with args and options
+ * @param configDir - Directory containing the configuration file
+ * @returns Script execution result
+ */
+export async function executeScript(scriptPath, context, configDir) {
+    const absolutePath = resolve(configDir, scriptPath);
+    const ext = extname(absolutePath).toLowerCase();
+    if (JAVASCRIPT_EXTENSIONS.includes(ext)) {
+        return executeJavaScript(absolutePath, context);
+    }
+    if (TYPESCRIPT_EXTENSIONS.includes(ext)) {
+        return executeTypeScript(absolutePath, context);
+    }
+    if (SHELL_EXTENSIONS.includes(ext)) {
+        return executeShell(absolutePath, context);
+    }
+    return {
+        success: false,
+        error: `Unsupported script type: ${ext}. Supported: ${[
+            ...JAVASCRIPT_EXTENSIONS,
+            ...TYPESCRIPT_EXTENSIONS,
+            ...SHELL_EXTENSIONS,
+        ].join(', ')}`,
+    };
+}
+//# sourceMappingURL=script-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"script-executor.js","sourceRoot":"","sources":["../../src/executor/script-executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAqBnD;;GAEG;AACH,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACtD,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACtD,MAAM,gBAAgB,GAAG,CAAC,KAAK,CAAC,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,OAAsB,EACtB,SAAiB;IAEjB,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAEhD,IAAI,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,4BAA4B,GAAG,gBAAgB;YACpD,GAAG,qBAAqB;YACxB,GAAG,qBAAqB;YACxB,GAAG,gBAAgB;SACpB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACf,CAAC;AACJ,CAAC"}

package/dist/executor/shell-executor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shell Executor
+ *
+ * Executes .sh files using the system shell.
+ */
+import type { ScriptContext, ScriptResult } from './script-executor.js';
+/**
+ * Execute a shell script
+ *
+ * Arguments and options are passed as environment variables:
+ * - CLI_AGENT_ARG_<NAME> for arguments (uppercase, underscores)
+ * - CLI_AGENT_OPT_<NAME> for options (uppercase, underscores)
+ * - CLI_AGENT_FORMAT for output format
+ * - CLI_AGENT_CWD for current working directory
+ *
+ * Example script:
+ * ```bash
+ * #!/bin/bash
+ * echo "Name: $CLI_AGENT_OPT_NAME"
+ * echo "Format: $CLI_AGENT_FORMAT"
+ *
+ * # For JSON output:
+ * if [ "$CLI_AGENT_FORMAT" = "json" ]; then
+ *   echo '{"success": true, "message": "Done!"}'
+ * fi
+ * ```
+ *
+ * @param scriptPath - Absolute path to the shell script
+ * @param context - Execution context
+ * @returns Script execution result
+ */
+export declare function executeShell(scriptPath: string, context: ScriptContext): Promise<ScriptResult>;
+//# sourceMappingURL=shell-executor.d.ts.map

package/dist/executor/shell-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-executor.d.ts","sourceRoot":"","sources":["../../src/executor/shell-executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGxE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CA+FvB"}

package/dist/executor/shell-executor.js

@@ -0,0 +1,126 @@
+/**
+ * Shell Executor
+ *
+ * Executes .sh files using the system shell.
+ */
+import { spawn } from 'node:child_process';
+import { pathExists } from '../services/file-system.service.js';
+/**
+ * Execute a shell script
+ *
+ * Arguments and options are passed as environment variables:
+ * - CLI_AGENT_ARG_<NAME> for arguments (uppercase, underscores)
+ * - CLI_AGENT_OPT_<NAME> for options (uppercase, underscores)
+ * - CLI_AGENT_FORMAT for output format
+ * - CLI_AGENT_CWD for current working directory
+ *
+ * Example script:
+ * ```bash
+ * #!/bin/bash
+ * echo "Name: $CLI_AGENT_OPT_NAME"
+ * echo "Format: $CLI_AGENT_FORMAT"
+ *
+ * # For JSON output:
+ * if [ "$CLI_AGENT_FORMAT" = "json" ]; then
+ *   echo '{"success": true, "message": "Done!"}'
+ * fi
+ * ```
+ *
+ * @param scriptPath - Absolute path to the shell script
+ * @param context - Execution context
+ * @returns Script execution result
+ */
+export async function executeShell(scriptPath, context) {
+    // Check if file exists
+    if (!(await pathExists(scriptPath))) {
+        return {
+            success: false,
+            error: `Script not found: ${scriptPath}`,
+        };
+    }
+    return new Promise((resolve) => {
+        // Build environment variables from context
+        const env = { ...process.env };
+        // Add arguments as CLI_AGENT_ARG_<NAME>
+        for (const [key, value] of Object.entries(context.args)) {
+            if (value !== undefined && value !== null) {
+                env[`CLI_AGENT_ARG_${toEnvName(key)}`] = String(value);
+            }
+        }
+        // Add options as CLI_AGENT_OPT_<NAME>
+        for (const [key, value] of Object.entries(context.options)) {
+            if (value !== undefined && value !== null) {
+                // Handle boolean options
+                if (typeof value === 'boolean') {
+                    env[`CLI_AGENT_OPT_${toEnvName(key)}`] = value ? 'true' : 'false';
+                }
+                else {
+                    env[`CLI_AGENT_OPT_${toEnvName(key)}`] = String(value);
+                }
+            }
+        }
+        // Add standard context variables
+        env.CLI_AGENT_FORMAT = context.format;
+        env.CLI_AGENT_CWD = context.cwd;
+        // Spawn bash with the script
+        const child = spawn('bash', [scriptPath], {
+            env,
+            cwd: context.cwd,
+            stdio: ['inherit', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('error', (error) => {
+            resolve({
+                success: false,
+                error: `Failed to execute shell script: ${error.message}`,
+            });
+        });
+        child.on('close', (code) => {
+            // Try to parse JSON output from script
+            const trimmedStdout = stdout.trim();
+            // Look for JSON in the last line (scripts might output logs before JSON)
+            const lines = trimmedStdout.split('\n');
+            const lastLine = lines[lines.length - 1]?.trim() || '';
+            if (lastLine.startsWith('{')) {
+                try {
+                    const result = JSON.parse(lastLine);
+                    if (typeof result === 'object' && 'success' in result) {
+                        resolve(result);
+                        return;
+                    }
+                }
+                catch {
+                    // Not valid JSON, 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}`,
+                });
+            }
+        });
+    });
+}
+/**
+ * Convert a name to environment variable format
+ * Example: "feature-name" -> "FEATURE_NAME"
+ */
+function toEnvName(name) {
+    return name.toUpperCase().replace(/[^A-Z0-9]/g, '_');
+}
+//# sourceMappingURL=shell-executor.js.map

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

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

package/dist/executor/ts-executor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * TypeScript Executor
+ *
+ * Executes .ts files using tsx (preferred) or ts-node.
+ */
+import type { ScriptContext, ScriptResult } from './script-executor.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 declare function executeTypeScript(scriptPath: string, context: ScriptContext): Promise<ScriptResult>;
+/**
+ * Helper to get context in TypeScript scripts
+ *
+ * Usage in script:
+ * ```typescript
+ * import { getScriptContext } from 'cli-agent';
+ * const context = getScriptContext();
+ * ```
+ */
+export declare function getScriptContext(): ScriptContext | null;
+//# sourceMappingURL=ts-executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ts-executor.d.ts","sourceRoot":"","sources":["../../src/executor/ts-executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGxE;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CA6BvB;AA2ED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAWvD"}

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,17 @@
+/**
+ * Library Entry Point
+ *
+ * MCP server that turns your scripts into AI-powered tools.
+ * 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";
+export { createMcpServer, startMcpServer } from "./mcp/mcp-server.js";
+export type { McpServerOptions } from "./mcp/mcp-server.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;;;;;GAKG;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;AAG7D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * Library Entry Point
+ *
+ * MCP server that turns your scripts into AI-powered tools.
+ * 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";
+// MCP Server (for programmatic usage)
+export { createMcpServer, startMcpServer } from "./mcp/mcp-server.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;;;;;GAKG;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;AAE7D,sCAAsC;AACtC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,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"}