ai-devkit 0.8.1 → 0.10.0

package/dist/util/git.js

@@ -35,6 +35,8 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureGitInstalled = ensureGitInstalled;
 exports.cloneRepository = cloneRepository;
+exports.isGitRepository = isGitRepository;
+exports.pullRepository = pullRepository;
 const child_process_1 = require("child_process");
 const util_1 = require("util");
 const fs = __importStar(require("fs-extra"));
@@ -79,4 +81,30 @@ async function cloneRepository(targetDir, repoName, gitUrl) {
         throw new Error(`Git clone failed: ${error.message}. Check network and git installation.`);
     }
 }
+/**
+ * Checks if a directory is a git repository
+ * @param dirPath - Absolute path to directory
+ * @returns true if .git directory exists
+ */
+async function isGitRepository(dirPath) {
+    const gitDir = path.join(dirPath, '.git');
+    return await fs.pathExists(gitDir);
+}
+/**
+ * Pulls latest changes for a git repository
+ * @param repoPath - Absolute path to git repository
+ * @throws Error if git pull fails
+ */
+async function pullRepository(repoPath) {
+    try {
+        await execAsync('git pull', {
+            cwd: repoPath,
+            timeout: 60000,
+        });
+    }
+    catch (error) {
+        const message = error.message || 'Unknown error';
+        throw new Error(`Git pull failed: ${message}`);
+    }
+}
 //# sourceMappingURL=git.js.map

package/dist/util/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/util/git.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,gDAQC;AAUD,0CAoBC;AAjDD,iDAAqC;AACrC,+BAAiC;AACjC,6CAA+B;AAC/B,2CAA6B;AAE7B,MAAM,SAAS,GAAG,IAAA,gBAAS,EAAC,oBAAI,CAAC,CAAC;AAElC;;;GAGG;AACI,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,QAAgB,EAAE,MAAc;IACvF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,OAAO,SAAS,IAAI,QAAQ,4BAA4B,CAAC,CAAC;QACtE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,8BAA8B,CAAC,CAAC;IACnE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,wCAAwC,MAAM,MAAM,QAAQ,GAAG,EAAE;YAC/E,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC"}
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/util/git.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,gDAQC;AAUD,0CAoBC;AAOD,0CAGC;AAOD,wCAUC;AA5ED,iDAAqC;AACrC,+BAAiC;AACjC,6CAA+B;AAC/B,2CAA6B;AAE7B,MAAM,SAAS,GAAG,IAAA,gBAAS,EAAC,oBAAI,CAAC,CAAC;AAElC;;;GAGG;AACI,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,QAAgB,EAAE,MAAc;IACvF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,OAAO,SAAS,IAAI,QAAQ,4BAA4B,CAAC,CAAC;QACtE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,8BAA8B,CAAC,CAAC;IACnE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,wCAAwC,MAAM,MAAM,QAAQ,GAAG,EAAE;YAC/E,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,UAAU,EAAE;YAC1B,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,eAAe,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/util/process.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Process Detection Utilities
+ *
+ * Utilities for detecting and inspecting running processes on the system.
+ * Primarily focused on macOS/Unix-like systems using the `ps` command.
+ */
+import type { ProcessInfo } from '../lib/adapters/AgentAdapter';
+/**
+ * Options for listing processes
+ */
+export interface ListProcessesOptions {
+    /** Filter processes by name pattern (case-insensitive) */
+    namePattern?: string;
+    /** Include only processes matching these PIDs */
+    pids?: number[];
+}
+/**
+ * List running processes on the system
+ *
+ * @param options Filtering options
+ * @returns Array of process information
+ *
+ * @example
+ * ```typescript
+ * // List all Claude Code processes
+ * const processes = listProcesses({ namePattern: 'claude' });
+ *
+ * // Get specific process info
+ * const process = listProcesses({ pids: [12345] });
+ * ```
+ */
+export declare function listProcesses(options?: ListProcessesOptions): ProcessInfo[];
+/**
+ * Get the current working directory for a specific process
+ *
+ * @param pid Process ID
+ * @returns Working directory path, or empty string if unavailable
+ */
+export declare function getProcessCwd(pid: number): string;
+/**
+ * Get the TTY device for a specific process
+ *
+ * @param pid Process ID
+ * @returns TTY device name (e.g., "ttys030"), or "?" if unavailable
+ */
+export declare function getProcessTty(pid: number): string;
+/**
+ * Check if a process with the given PID is running
+ *
+ * @param pid Process ID
+ * @returns True if process is running
+ */
+export declare function isProcessRunning(pid: number): boolean;
+/**
+ * Get detailed information for a specific process
+ *
+ * @param pid Process ID
+ * @returns Process information, or null if process not found
+ */
+export declare function getProcessInfo(pid: number): ProcessInfo | null;
+//# sourceMappingURL=process.d.ts.map

package/dist/util/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/util/process.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,WAAW,EAAE,CA2D/E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgCjD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYjD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASrD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAG9D"}

package/dist/util/process.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Process Detection Utilities
+ *
+ * Utilities for detecting and inspecting running processes on the system.
+ * Primarily focused on macOS/Unix-like systems using the `ps` command.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listProcesses = listProcesses;
+exports.getProcessCwd = getProcessCwd;
+exports.getProcessTty = getProcessTty;
+exports.isProcessRunning = isProcessRunning;
+exports.getProcessInfo = getProcessInfo;
+const child_process_1 = require("child_process");
+/**
+ * List running processes on the system
+ *
+ * @param options Filtering options
+ * @returns Array of process information
+ *
+ * @example
+ * ```typescript
+ * // List all Claude Code processes
+ * const processes = listProcesses({ namePattern: 'claude' });
+ *
+ * // Get specific process info
+ * const process = listProcesses({ pids: [12345] });
+ * ```
+ */
+function listProcesses(options = {}) {
+    try {
+        // Get all processes with full details
+        // Format: user pid command
+        const psOutput = (0, child_process_1.execSync)('ps aux', { encoding: 'utf-8' });
+        const lines = psOutput.trim().split('\n');
+        // Skip header line
+        const processLines = lines.slice(1);
+        const processes = [];
+        for (const line of processLines) {
+            // Parse ps aux output
+            // Format: USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND
+            const parts = line.trim().split(/\s+/);
+            if (parts.length < 11)
+                continue;
+            const pid = parseInt(parts[1], 10);
+            if (isNaN(pid))
+                continue;
+            const tty = parts[6];
+            const command = parts.slice(10).join(' ');
+            // Apply PID filter
+            if (options.pids && !options.pids.includes(pid)) {
+                continue;
+            }
+            // Apply name pattern filter (case-insensitive)
+            if (options.namePattern) {
+                const pattern = options.namePattern.toLowerCase();
+                const commandLower = command.toLowerCase();
+                if (!commandLower.includes(pattern)) {
+                    continue;
+                }
+            }
+            // Get working directory for this process
+            const cwd = getProcessCwd(pid);
+            // Get TTY in short format (remove /dev/ prefix if present)
+            const ttyShort = tty.startsWith('/dev/') ? tty.slice(5) : tty;
+            processes.push({
+                pid,
+                command,
+                cwd,
+                tty: ttyShort,
+            });
+        }
+        return processes;
+    }
+    catch (error) {
+        // If ps command fails, return empty array
+        console.error('Failed to list processes:', error);
+        return [];
+    }
+}
+/**
+ * Get the current working directory for a specific process
+ *
+ * @param pid Process ID
+ * @returns Working directory path, or empty string if unavailable
+ */
+function getProcessCwd(pid) {
+    try {
+        // Use lsof to get the current working directory
+        // -a: AND the selections, -d cwd: get cwd only, -Fn: output format (file names only)
+        const output = (0, child_process_1.execSync)(`lsof -a -p ${pid} -d cwd -Fn 2>/dev/null`, {
+            encoding: 'utf-8',
+        });
+        // Parse lsof output
+        // Format: p{PID}\nn{path}
+        const lines = output.trim().split('\n');
+        for (const line of lines) {
+            if (line.startsWith('n')) {
+                return line.slice(1); // Remove 'n' prefix
+            }
+        }
+        return '';
+    }
+    catch (error) {
+        // If lsof fails, try alternative method using pwdx (Linux)
+        try {
+            const output = (0, child_process_1.execSync)(`pwdx ${pid} 2>/dev/null`, {
+                encoding: 'utf-8',
+            });
+            // Format: {PID}: {path}
+            const match = output.match(/^\d+:\s*(.+)$/);
+            return match ? match[1].trim() : '';
+        }
+        catch {
+            // Both methods failed
+            return '';
+        }
+    }
+}
+/**
+ * Get the TTY device for a specific process
+ *
+ * @param pid Process ID
+ * @returns TTY device name (e.g., "ttys030"), or "?" if unavailable
+ */
+function getProcessTty(pid) {
+    try {
+        const output = (0, child_process_1.execSync)(`ps -p ${pid} -o tty=`, {
+            encoding: 'utf-8',
+        });
+        const tty = output.trim();
+        // Remove /dev/ prefix if present
+        return tty.startsWith('/dev/') ? tty.slice(5) : tty;
+    }
+    catch (error) {
+        return '?';
+    }
+}
+/**
+ * Check if a process with the given PID is running
+ *
+ * @param pid Process ID
+ * @returns True if process is running
+ */
+function isProcessRunning(pid) {
+    try {
+        // Send signal 0 to check if process exists
+        // This doesn't actually send a signal, just checks if we can
+        (0, child_process_1.execSync)(`kill -0 ${pid} 2>/dev/null`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get detailed information for a specific process
+ *
+ * @param pid Process ID
+ * @returns Process information, or null if process not found
+ */
+function getProcessInfo(pid) {
+    const processes = listProcesses({ pids: [pid] });
+    return processes.length > 0 ? processes[0] : null;
+}
+//# sourceMappingURL=process.js.map

package/dist/util/process.js.map

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

package/dist/util/terminal-ui.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Terminal UI utility for consistent message formatting across CLI commands
+ *
+ * @example
+ * ```typescript
+ * import { ui } from '../util/terminal-ui';
+ *
+ * // Display messages
+ * ui.info('Initializing project...');
+ * ui.success('Project initialized successfully!');
+ * ui.warning('Configuration file not found, using defaults');
+ * ui.error('Failed to create directory');
+ *
+ * // Use spinner for async operations
+ * const spinner = ui.spinner('Cloning repository...');
+ * spinner.start();
+ * try {
+ *   await cloneRepo();
+ *   spinner.succeed('Repository cloned successfully');
+ * } catch (error) {
+ *   spinner.fail('Failed to clone repository');
+ *   ui.error(error.message);
+ * }
+ * ```
+ */
+export declare const ui: {
+    /**
+     * Display a text line
+     * @param text - The text to display
+     */
+    text: (text: string, { breakline }?: {
+        breakline?: boolean;
+    }) => void;
+    /**
+     * Display a break line
+     */
+    breakline: () => void;
+    /**
+     * Display informational message (blue)
+     * @param message - The message to display
+     */
+    info: (message: string) => void;
+    /**
+     * Display success message (green)
+     * @param message - The message to display
+     */
+    success: (message: string) => void;
+    /**
+     * Display warning message (yellow)
+     * @param message - The message to display
+     */
+    warning: (message: string) => void;
+    /**
+     * Display error message (red)
+     * @param message - The message to display
+     */
+    error: (message: string) => void;
+    /**
+     * Create a spinner for async operations
+     * @param text - The text to display with the spinner
+     * @returns Ora spinner instance with start/succeed/fail/warn/stop methods
+     */
+    spinner: (text: string) => import("ora").Ora;
+    /**
+     * Display a formatted table with headers and rows
+     * @param options - Table configuration
+     * @example
+     * ```typescript
+     * ui.table({
+     *   headers: ['Name', 'Status', 'Type'],
+     *   rows: [
+     *     ['skill-1', 'active', 'frontend'],
+     *     ['skill-2', 'inactive', 'backend']
+     *   ],
+     *   columnStyles: [chalk.cyan, chalk.green, chalk.dim]
+     * });
+     * ```
+     */
+    table: (options: {
+        headers: string[];
+        rows: string[][];
+        columnStyles?: Array<(text: string) => string>;
+        indent?: string;
+    }) => void;
+    /**
+     * Display a summary section with title and items
+     * @param options - Summary configuration
+     * @example
+     * ```typescript
+     * ui.summary({
+     *   title: 'Update Summary',
+     *   items: [
+     *     { type: 'success', count: 5, label: 'updated' },
+     *     { type: 'warning', count: 2, label: 'skipped' },
+     *     { type: 'error', count: 1, label: 'failed' }
+     *   ],
+     *   details: {
+     *     title: 'Errors',
+     *     items: [
+     *       { message: 'Failed to update registry-1', tip: 'Check network connection' }
+     *     ]
+     *   }
+     * });
+     * ```
+     */
+    summary: (options: {
+        title?: string;
+        items: Array<{
+            type: "success" | "warning" | "error" | "info";
+            count: number;
+            label: string;
+        }>;
+        details?: {
+            title: string;
+            items: Array<{
+                message: string;
+                tip?: string;
+            }>;
+        };
+    }) => void;
+};
+//# sourceMappingURL=terminal-ui.d.ts.map

package/dist/util/terminal-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-ui.d.ts","sourceRoot":"","sources":["../../src/util/terminal-ui.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,EAAE;IACX;;;OAGG;iBACU,MAAM,kBAAyB;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KAA0B,IAAI;IAIjG;;OAEG;qBACY,IAAI;IAInB;;;OAGG;oBACa,MAAM,KAAG,IAAI;IAI7B;;;OAGG;uBACgB,MAAM,KAAG,IAAI;IAIhC;;;OAGG;uBACgB,MAAM,KAAG,IAAI;IAIhC;;;OAGG;qBACc,MAAM,KAAG,IAAI;IAI9B;;;;OAIG;oBACa,MAAM;IAOtB;;;;;;;;;;;;;;OAcG;qBACc;QACb,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QACjB,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,KAAG,IAAI;IA0BR;;;;;;;;;;;;;;;;;;;;OAoBG;uBACgB;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,KAAK,CAAC;YACT,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;YAC/C,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;SACjB,CAAC,CAAC;QACH,OAAO,CAAC,EAAE;YACN,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,KAAK,CAAC;gBACT,OAAO,EAAE,MAAM,CAAC;gBAChB,GAAG,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC,CAAC;SACN,CAAC;KACL,KAAG,IAAI;CA+BX,CAAC"}

package/dist/util/terminal-ui.js

@@ -0,0 +1,177 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ui = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+/**
+ * Sanitize message to prevent terminal injection
+ * Removes ANSI escape codes from user-provided strings
+ */
+const sanitize = (message) => {
+    // eslint-disable-next-line no-control-regex
+    return message.replace(/\x1b\[[0-9;]*m/g, '');
+};
+/**
+ * Terminal UI utility for consistent message formatting across CLI commands
+ *
+ * @example
+ * ```typescript
+ * import { ui } from '../util/terminal-ui';
+ *
+ * // Display messages
+ * ui.info('Initializing project...');
+ * ui.success('Project initialized successfully!');
+ * ui.warning('Configuration file not found, using defaults');
+ * ui.error('Failed to create directory');
+ *
+ * // Use spinner for async operations
+ * const spinner = ui.spinner('Cloning repository...');
+ * spinner.start();
+ * try {
+ *   await cloneRepo();
+ *   spinner.succeed('Repository cloned successfully');
+ * } catch (error) {
+ *   spinner.fail('Failed to clone repository');
+ *   ui.error(error.message);
+ * }
+ * ```
+ */
+exports.ui = {
+    /**
+     * Display a text line
+     * @param text - The text to display
+     */
+    text: (text, { breakline = false } = { breakline: false }) => {
+        console.log(`${breakline ? '\n' : ''}${text}${breakline ? '\n' : ''}`);
+    },
+    /**
+     * Display a break line
+     */
+    breakline: () => {
+        console.log('\n');
+    },
+    /**
+     * Display informational message (blue)
+     * @param message - The message to display
+     */
+    info: (message) => {
+        console.log(chalk_1.default.blue('ℹ'), sanitize(message));
+    },
+    /**
+     * Display success message (green)
+     * @param message - The message to display
+     */
+    success: (message) => {
+        console.log(chalk_1.default.green('✔'), sanitize(message));
+    },
+    /**
+     * Display warning message (yellow)
+     * @param message - The message to display
+     */
+    warning: (message) => {
+        console.log(chalk_1.default.yellow('⚠'), sanitize(message));
+    },
+    /**
+     * Display error message (red)
+     * @param message - The message to display
+     */
+    error: (message) => {
+        console.error(chalk_1.default.red('✖'), sanitize(message));
+    },
+    /**
+     * Create a spinner for async operations
+     * @param text - The text to display with the spinner
+     * @returns Ora spinner instance with start/succeed/fail/warn/stop methods
+     */
+    spinner: (text) => {
+        return (0, ora_1.default)({
+            text: sanitize(text),
+            color: 'cyan',
+        });
+    },
+    /**
+     * Display a formatted table with headers and rows
+     * @param options - Table configuration
+     * @example
+     * ```typescript
+     * ui.table({
+     *   headers: ['Name', 'Status', 'Type'],
+     *   rows: [
+     *     ['skill-1', 'active', 'frontend'],
+     *     ['skill-2', 'inactive', 'backend']
+     *   ],
+     *   columnStyles: [chalk.cyan, chalk.green, chalk.dim]
+     * });
+     * ```
+     */
+    table: (options) => {
+        const { headers, rows, columnStyles = [], indent = '  ' } = options;
+        const columnWidths = headers.map((header, i) => {
+            const maxDataWidth = Math.max(...rows.map(row => (row[i] || '').length));
+            return Math.max(header.length, maxDataWidth);
+        });
+        const headerRow = headers.map((header, i) => {
+            const style = columnStyles[i] || chalk_1.default.bold;
+            return style(header.padEnd(columnWidths[i] + 2));
+        }).join('');
+        console.log(chalk_1.default.dim(indent) + headerRow);
+        const totalWidth = columnWidths.reduce((sum, width) => sum + width + 2, 0);
+        console.log(chalk_1.default.dim(indent + '─'.repeat(totalWidth)));
+        rows.forEach(row => {
+            const formattedRow = row.map((cell, i) => {
+                const style = columnStyles[i] || ((text) => text);
+                return style((cell || '').padEnd(columnWidths[i] + 2));
+            }).join('');
+            console.log(indent + formattedRow);
+        });
+    },
+    /**
+     * Display a summary section with title and items
+     * @param options - Summary configuration
+     * @example
+     * ```typescript
+     * ui.summary({
+     *   title: 'Update Summary',
+     *   items: [
+     *     { type: 'success', count: 5, label: 'updated' },
+     *     { type: 'warning', count: 2, label: 'skipped' },
+     *     { type: 'error', count: 1, label: 'failed' }
+     *   ],
+     *   details: {
+     *     title: 'Errors',
+     *     items: [
+     *       { message: 'Failed to update registry-1', tip: 'Check network connection' }
+     *     ]
+     *   }
+     * });
+     * ```
+     */
+    summary: (options) => {
+        const { title = 'Summary', items, details } = options;
+        console.log(chalk_1.default.bold(`\n\n${title}:`));
+        items.forEach(item => {
+            if (item.count > 0) {
+                const symbol = item.type === 'success' ? '✓' :
+                    item.type === 'warning' ? '⊘' :
+                        item.type === 'error' ? '✗' : 'ℹ';
+                const color = item.type === 'success' ? chalk_1.default.green :
+                    item.type === 'warning' ? chalk_1.default.yellow :
+                        item.type === 'error' ? chalk_1.default.red : chalk_1.default.blue;
+                console.log(color(`  ${symbol} ${item.count} ${item.label}`));
+            }
+        });
+        if (details && details.items.length > 0) {
+            console.log(chalk_1.default.bold(`\n\n${details.title}:`));
+            details.items.forEach(item => {
+                console.log(chalk_1.default.red(`  • ${item.message}`));
+                if (item.tip) {
+                    console.log(chalk_1.default.dim(`    Tip: ${item.tip}`));
+                }
+            });
+        }
+    },
+};
+//# sourceMappingURL=terminal-ui.js.map

package/dist/util/terminal-ui.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-devkit",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "description": "A CLI toolkit for AI-assisted software development with phase templates and environment setup",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,12 +27,13 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@ai-devkit/memory": "^0.2.0",
+    "@ai-devkit/memory": "0.4.0",
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
     "fs-extra": "^11.2.0",
     "gray-matter": "^4.0.3",
     "inquirer": "^8.2.6",
+    "ora": "^9.1.0",
     "yaml": "^2.3.4"
   },
   "devDependencies": {