@codemieai/code 0.0.20 → 0.0.21

package/dist/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,SAAS,EAAE,MAAM;CAI9B;AAED,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI9C;AAED,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI7C;AAED,qBAAa,iBAAkB,SAAQ,YAAY;gBACrC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIzC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKtD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,SAAS,EAAE,MAAM;CAI9B;AAED,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI9C;AAED,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI7C;AAED,qBAAa,iBAAkB,SAAQ,YAAY;gBACrC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIzC;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,YAAY;IAG/B,IAAI,EAAE,YAAY;IAClB,aAAa,CAAC,EAAE,KAAK;gBAF5B,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,YAAY,EAClB,aAAa,CAAC,EAAE,KAAK,YAAA;CAK/B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CA6CvE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKtD"}

package/dist/utils/errors.js

@@ -34,6 +34,70 @@ export class PathSecurityError extends CodeMieError {
         this.name = 'PathSecurityError';
     }
 }
+/**
+ * npm error codes for categorizing failures
+ */
+export var NpmErrorCode;
+(function (NpmErrorCode) {
+    NpmErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    NpmErrorCode["PERMISSION_ERROR"] = "PERMISSION_ERROR";
+    NpmErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    NpmErrorCode["TIMEOUT"] = "TIMEOUT";
+    NpmErrorCode["UNKNOWN"] = "UNKNOWN";
+})(NpmErrorCode || (NpmErrorCode = {}));
+/**
+ * Custom error class for npm operations
+ */
+export class NpmError extends CodeMieError {
+    code;
+    originalError;
+    constructor(message, code, originalError) {
+        super(message);
+        this.code = code;
+        this.originalError = originalError;
+        this.name = 'NpmError';
+    }
+}
+/**
+ * Parse npm error from exec failure and create appropriate NpmError
+ * @param error - The caught error from exec
+ * @param context - Context message (e.g., "Failed to install package-name")
+ * @returns Parsed NpmError with appropriate error code
+ */
+export function parseNpmError(error, context) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const lowerMessage = errorMessage.toLowerCase();
+    // Detect error type from message patterns
+    let code = NpmErrorCode.UNKNOWN;
+    let hint = '';
+    // Timeout (check first - most specific)
+    if (lowerMessage.includes('timed out')) {
+        code = NpmErrorCode.TIMEOUT;
+        hint = 'Operation timed out. Try increasing the timeout or check your connection.';
+    }
+    // Permission errors
+    else if (lowerMessage.includes('eacces') || lowerMessage.includes('eperm')) {
+        code = NpmErrorCode.PERMISSION_ERROR;
+        hint =
+            'Try running with elevated permissions (sudo on Unix) or check directory permissions.';
+    }
+    // Package not found (check before network errors to prioritize 404)
+    else if (lowerMessage.includes('404') ||
+        lowerMessage.includes('e404')) {
+        code = NpmErrorCode.NOT_FOUND;
+        hint = 'Verify the package name and version are correct.';
+    }
+    // Network errors
+    else if (lowerMessage.includes('enotfound') ||
+        lowerMessage.includes('etimedout') ||
+        lowerMessage.includes('eai_again') ||
+        lowerMessage.includes('network')) {
+        code = NpmErrorCode.NETWORK_ERROR;
+        hint = 'Check your internet connection and npm registry configuration.';
+    }
+    const fullMessage = hint ? `${context}: ${errorMessage}\nHint: ${hint}` : `${context}: ${errorMessage}`;
+    return new NpmError(fullMessage, code, error instanceof Error ? error : undefined);
+}
 /**
  * Extracts error message from unknown error type
  * @param error - The caught error (unknown type)

package/dist/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,SAAiB;QAC3B,KAAK,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IACtD,YAAY,SAAiB,EAAE,MAAc;QAC3C,KAAK,CAAC,2BAA2B,SAAS,KAAK,MAAM,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,QAAgB,EAAE,MAAc;QAC1C,KAAK,CAAC,QAAQ,QAAQ,YAAY,MAAM,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACjD,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,4BAA4B,IAAI,MAAM,MAAM,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}

package/dist/utils/npm.d.ts

@@ -0,0 +1,116 @@
+/**
+ * NPM utility wrapper for consistent npm operations
+ *
+ * Provides type-safe API for common npm operations with:
+ * - Consistent timeout management
+ * - Specialized error handling
+ * - Comprehensive logging
+ * - Cross-platform support
+ */
+/**
+ * Base options for npm operations
+ */
+export interface NpmOptions {
+    /** Working directory for npm command */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Operation timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Options for npm install operations
+ */
+export interface NpmInstallOptions extends NpmOptions {
+    /** Package version (e.g., '1.0.0', 'latest') */
+    version?: string;
+}
+/**
+ * Options for npx run operations
+ */
+export interface NpxRunOptions extends NpmOptions {
+    /** Enable interactive mode for user prompts */
+    interactive?: boolean;
+}
+/**
+ * Install a package globally via npm
+ *
+ * @param packageName - Package name to install (e.g., 'typescript')
+ * @param options - Installation options
+ * @throws {NpmError} If installation fails
+ *
+ * @example
+ * ```typescript
+ * // Install latest version
+ * await installGlobal('typescript');
+ *
+ * // Install specific version
+ * await installGlobal('typescript', { version: '5.0.0' });
+ * ```
+ */
+export declare function installGlobal(packageName: string, options?: NpmInstallOptions): Promise<void>;
+/**
+ * Uninstall a package globally via npm
+ *
+ * @param packageName - Package name to uninstall
+ * @param options - Uninstallation options
+ * @throws {NpmError} If uninstallation fails
+ *
+ * @example
+ * ```typescript
+ * await uninstallGlobal('typescript');
+ * ```
+ */
+export declare function uninstallGlobal(packageName: string, options?: NpmOptions): Promise<void>;
+/**
+ * Check if a package is installed globally
+ *
+ * @param packageName - Package name to check
+ * @param options - Check options
+ * @returns True if package is installed globally, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const isInstalled = await listGlobal('typescript');
+ * if (isInstalled) {
+ *   console.log('TypeScript is installed');
+ * }
+ * ```
+ */
+export declare function listGlobal(packageName: string, options?: NpmOptions): Promise<boolean>;
+/**
+ * Get npm version
+ *
+ * @param options - Version check options
+ * @returns npm version string, or null if npm not found
+ *
+ * @example
+ * ```typescript
+ * const version = await getVersion();
+ * if (version) {
+ *   console.log(`npm version: ${version}`);
+ * } else {
+ *   console.log('npm not installed');
+ * }
+ * ```
+ */
+export declare function getVersion(options?: NpmOptions): Promise<string | null>;
+/**
+ * Run a command via npx
+ *
+ * @param command - Command to run (e.g., 'create-react-app')
+ * @param args - Command arguments
+ * @param options - Execution options
+ * @throws {NpmError} If execution fails
+ *
+ * @example
+ * ```typescript
+ * // Run with interactive mode
+ * await npxRun('create-react-app', ['my-app'], { interactive: true });
+ *
+ * // Run with custom timeout
+ * await npxRun('eslint', ['src/'], { timeout: 60000 });
+ * ```
+ */
+export declare function npxRun(command: string, args?: string[], options?: NpxRunOptions): Promise<void>;
+//# sourceMappingURL=npm.d.ts.map

package/dist/utils/npm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../src/utils/npm.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC9B,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,MAAM,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/utils/npm.js

@@ -0,0 +1,180 @@
+/**
+ * NPM utility wrapper for consistent npm operations
+ *
+ * Provides type-safe API for common npm operations with:
+ * - Consistent timeout management
+ * - Specialized error handling
+ * - Comprehensive logging
+ * - Cross-platform support
+ */
+import { exec } from './exec.js';
+import { logger } from './logger.js';
+/**
+ * Install a package globally via npm
+ *
+ * @param packageName - Package name to install (e.g., 'typescript')
+ * @param options - Installation options
+ * @throws {NpmError} If installation fails
+ *
+ * @example
+ * ```typescript
+ * // Install latest version
+ * await installGlobal('typescript');
+ *
+ * // Install specific version
+ * await installGlobal('typescript', { version: '5.0.0' });
+ * ```
+ */
+export async function installGlobal(packageName, options = {}) {
+    const packageSpec = options.version ? `${packageName}@${options.version}` : packageName;
+    const timeout = options.timeout ?? 120000; // 2 minutes default
+    logger.info(`Installing ${packageSpec} globally...`);
+    try {
+        const execOptions = {
+            cwd: options.cwd,
+            env: options.env,
+            timeout
+        };
+        const result = await exec('npm', ['install', '-g', packageSpec], execOptions);
+        if (result.code !== 0) {
+            throw new Error(`npm install exited with code ${result.code}: ${result.stderr || result.stdout}`);
+        }
+        logger.success(`${packageSpec} installed successfully`);
+    }
+    catch (error) {
+        const { parseNpmError } = await import('./errors.js');
+        throw parseNpmError(error, `Failed to install ${packageSpec}`);
+    }
+}
+/**
+ * Uninstall a package globally via npm
+ *
+ * @param packageName - Package name to uninstall
+ * @param options - Uninstallation options
+ * @throws {NpmError} If uninstallation fails
+ *
+ * @example
+ * ```typescript
+ * await uninstallGlobal('typescript');
+ * ```
+ */
+export async function uninstallGlobal(packageName, options = {}) {
+    const timeout = options.timeout ?? 30000; // 30 seconds default
+    logger.info(`Uninstalling ${packageName} globally...`);
+    try {
+        const execOptions = {
+            cwd: options.cwd,
+            env: options.env,
+            timeout
+        };
+        const result = await exec('npm', ['uninstall', '-g', packageName], execOptions);
+        if (result.code !== 0) {
+            throw new Error(`npm uninstall exited with code ${result.code}: ${result.stderr || result.stdout}`);
+        }
+        logger.success(`${packageName} uninstalled successfully`);
+    }
+    catch (error) {
+        const { parseNpmError } = await import('./errors.js');
+        throw parseNpmError(error, `Failed to uninstall ${packageName}`);
+    }
+}
+/**
+ * Check if a package is installed globally
+ *
+ * @param packageName - Package name to check
+ * @param options - Check options
+ * @returns True if package is installed globally, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const isInstalled = await listGlobal('typescript');
+ * if (isInstalled) {
+ *   console.log('TypeScript is installed');
+ * }
+ * ```
+ */
+export async function listGlobal(packageName, options = {}) {
+    const timeout = options.timeout ?? 5000; // 5 seconds default
+    try {
+        const execOptions = {
+            cwd: options.cwd,
+            env: options.env,
+            timeout
+        };
+        const result = await exec('npm', ['list', '-g', packageName], execOptions);
+        // Exit code 0 = installed, 1 = not found, >1 = error
+        return result.code === 0;
+    }
+    catch {
+        // If exec throws, treat as not installed (unless it's a real error)
+        return false;
+    }
+}
+/**
+ * Get npm version
+ *
+ * @param options - Version check options
+ * @returns npm version string, or null if npm not found
+ *
+ * @example
+ * ```typescript
+ * const version = await getVersion();
+ * if (version) {
+ *   console.log(`npm version: ${version}`);
+ * } else {
+ *   console.log('npm not installed');
+ * }
+ * ```
+ */
+export async function getVersion(options = {}) {
+    const timeout = options.timeout ?? 5000; // 5 seconds default
+    try {
+        const execOptions = {
+            cwd: options.cwd,
+            env: options.env,
+            timeout
+        };
+        const result = await exec('npm', ['--version'], execOptions);
+        const match = result.stdout.match(/\d+\.\d+\.\d+/);
+        return match ? match[0] : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Run a command via npx
+ *
+ * @param command - Command to run (e.g., 'create-react-app')
+ * @param args - Command arguments
+ * @param options - Execution options
+ * @throws {NpmError} If execution fails
+ *
+ * @example
+ * ```typescript
+ * // Run with interactive mode
+ * await npxRun('create-react-app', ['my-app'], { interactive: true });
+ *
+ * // Run with custom timeout
+ * await npxRun('eslint', ['src/'], { timeout: 60000 });
+ * ```
+ */
+export async function npxRun(command, args = [], options = {}) {
+    const timeout = options.timeout ?? 300000; // 5 minutes default (download + execution)
+    logger.info(`Running npx ${command} ${args.join(' ')}...`);
+    try {
+        const execOptions = {
+            cwd: options.cwd,
+            env: options.env,
+            timeout,
+            interactive: options.interactive
+        };
+        await exec('npx', [command, ...args], execOptions);
+        logger.success(`npx ${command} completed successfully`);
+    }
+    catch (error) {
+        const { parseNpmError } = await import('./errors.js');
+        throw parseNpmError(error, `Failed to run npx ${command}`);
+    }
+}
+//# sourceMappingURL=npm.js.map

package/dist/utils/npm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.js","sourceRoot":"","sources":["../../src/utils/npm.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAe,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA8BrC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,UAA6B,EAAE;IAE/B,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IACxF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,oBAAoB;IAE/D,MAAM,CAAC,IAAI,CAAC,cAAc,WAAW,cAAc,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,WAAW,GAAgB;YAC/B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO;SACR,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;QAE9E,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CACjF,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,GAAG,WAAW,yBAAyB,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,aAAa,CAAC,KAAK,EAAE,qBAAqB,WAAW,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,UAAsB,EAAE;IAExB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,qBAAqB;IAE/D,MAAM,CAAC,IAAI,CAAC,gBAAgB,WAAW,cAAc,CAAC,CAAC;IAEvD,IAAI,CAAC;QACH,MAAM,WAAW,GAAgB;YAC/B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO;SACR,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;QAEhF,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,kCAAkC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CACnF,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,GAAG,WAAW,2BAA2B,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,aAAa,CAAC,KAAK,EAAE,uBAAuB,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,UAAsB,EAAE;IAExB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,oBAAoB;IAE7D,IAAI,CAAC;QACH,MAAM,WAAW,GAAgB;YAC/B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO;SACR,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;QAC3E,qDAAqD;QACrD,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAAsB,EAAE;IAExB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,oBAAoB;IAE7D,IAAI,CAAC;QACH,MAAM,WAAW,GAAgB;YAC/B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO;SACR,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAe,EACf,OAAiB,EAAE,EACnB,UAAyB,EAAE;IAE3B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,2CAA2C;IAEtF,MAAM,CAAC,IAAI,CAAC,eAAe,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,WAAW,GAAgB;YAC/B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,OAAO,OAAO,yBAAyB,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,aAAa,CAAC,KAAK,EAAE,qBAAqB,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemieai/code",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "description": "Unified AI coding assistant CLI - Manage Claude Code, Codex, Gemini & custom agents. Multi-provider support (OpenAI, Azure, LiteLLM, SSO). Built-in LangGraph agent with file operations & git integration.",
   "type": "module",
   "main": "dist/index.js",
@@ -45,7 +45,7 @@
   },
   "lint-staged": {
     "*.ts": [
-      "eslint --max-warnings=0",
+      "eslint --max-warnings=0 --no-warn-ignored",
       "vitest related --run"
     ],
     "package.json": [