@bhimudev/gnanai 0.4.0

package/dist/commands/cleanup.js

@@ -0,0 +1,380 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs-extra';
+import path from 'path';
+import { logger } from '../utils/logger.js';
+import { loadVersionFile, saveVersionFile, getOrphanedFiles, removeFile, } from '../utils/version-tracker.js';
+import { listBackups, pruneOldBackups, } from '../utils/backup.js';
+import { getTemplateHashes, getCustomFiles, } from '../utils/migration.js';
+import { ProcessStateManager } from '../utils/managed-process.js';
+import { isAlive, killTree } from '../utils/process-tree.js';
+const CLAUDE_DIR = '.claude';
+/**
+ * Find deprecated files (files that exist but are no longer in templates).
+ */
+async function findDeprecatedFiles() {
+    const versionFile = await loadVersionFile(CLAUDE_DIR);
+    if (!versionFile) {
+        return [];
+    }
+    // Get orphaned files from version tracking
+    const orphaned = getOrphanedFiles(versionFile);
+    // Also check for files that exist on disk but aren't in templates
+    const templateHashes = await getTemplateHashes();
+    const templatePaths = new Set(templateHashes.keys());
+    const customFiles = await getCustomFiles(CLAUDE_DIR);
+    // Deprecated = orphaned from tracking AND not in current templates
+    // AND not a custom file (user-created)
+    const deprecated = [];
+    for (const orphanPath of orphaned) {
+        if (!templatePaths.has(orphanPath)) {
+            deprecated.push(orphanPath);
+        }
+    }
+    return deprecated;
+}
+/**
+ * Find files that exist but aren't tracked or templated.
+ */
+async function findUnknownFiles() {
+    const customFiles = await getCustomFiles(CLAUDE_DIR);
+    const versionFile = await loadVersionFile(CLAUDE_DIR);
+    if (!versionFile) {
+        return customFiles;
+    }
+    // Files that are custom AND not tracked
+    const trackedPaths = new Set(Object.keys(versionFile.files));
+    return customFiles.filter(f => !trackedPaths.has(f));
+}
+/**
+ * Clean up deprecated files.
+ */
+async function cleanupDeprecated(options) {
+    const deprecated = await findDeprecatedFiles();
+    if (deprecated.length === 0) {
+        logger.info('No deprecated files found.');
+        return 0;
+    }
+    console.log('');
+    logger.section('Deprecated Files');
+    console.log('');
+    for (const file of deprecated) {
+        console.log(chalk.yellow(`  ${file}`));
+    }
+    console.log('');
+    if (options.dryRun) {
+        logger.info(chalk.yellow(`Would remove ${deprecated.length} deprecated file(s).`));
+        return 0;
+    }
+    if (!options.yes) {
+        const { confirm } = await inquirer.prompt([{
+                type: 'confirm',
+                name: 'confirm',
+                message: `Remove ${deprecated.length} deprecated file(s)?`,
+                default: false,
+            }]);
+        if (!confirm) {
+            logger.info('Cleanup cancelled.');
+            return 0;
+        }
+    }
+    const spinner = ora('Removing deprecated files...').start();
+    let removed = 0;
+    // Load version file once before the loop
+    let versionFile = await loadVersionFile(CLAUDE_DIR);
+    for (const file of deprecated) {
+        try {
+            const fullPath = file.startsWith('.claude/')
+                ? file
+                : path.join(CLAUDE_DIR, file);
+            if (await fs.pathExists(fullPath)) {
+                await fs.remove(fullPath);
+                removed++;
+                logger.debug(`Removed: ${file}`);
+            }
+            // Remove from version tracking (in-memory)
+            if (versionFile) {
+                versionFile = removeFile(versionFile, file);
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to remove ${file}`, error);
+        }
+    }
+    // Save version file once after all removals
+    if (versionFile) {
+        await saveVersionFile(CLAUDE_DIR, versionFile);
+    }
+    spinner.succeed(`Removed ${removed} deprecated file(s)`);
+    return removed;
+}
+/**
+ * Clean up old backups.
+ */
+async function cleanupBackups(options) {
+    const keepCount = options.keepBackups ?? 5;
+    const backups = await listBackups(CLAUDE_DIR);
+    if (backups.length === 0) {
+        logger.info('No backups found.');
+        return 0;
+    }
+    if (backups.length <= keepCount) {
+        logger.info(`Only ${backups.length} backup(s) found, keeping all (limit: ${keepCount}).`);
+        return 0;
+    }
+    const toRemove = backups.slice(keepCount);
+    console.log('');
+    logger.section('Old Backups');
+    console.log('');
+    console.log(chalk.gray(`  Keeping ${keepCount} most recent backup(s)`));
+    console.log('');
+    console.log('  Would remove:');
+    for (const backup of toRemove) {
+        const date = backup.createdAt.toLocaleString();
+        console.log(chalk.yellow(`    ${backup.timestamp} (${date})`));
+    }
+    console.log('');
+    if (options.dryRun) {
+        logger.info(chalk.yellow(`Would remove ${toRemove.length} old backup(s).`));
+        return 0;
+    }
+    if (!options.yes) {
+        const { confirm } = await inquirer.prompt([{
+                type: 'confirm',
+                name: 'confirm',
+                message: `Remove ${toRemove.length} old backup(s)?`,
+                default: false,
+            }]);
+        if (!confirm) {
+            logger.info('Cleanup cancelled.');
+            return 0;
+        }
+    }
+    const spinner = ora('Removing old backups...').start();
+    const removed = await pruneOldBackups(CLAUDE_DIR, keepCount);
+    spinner.succeed(`Removed ${removed} old backup(s)`);
+    return removed;
+}
+/**
+ * Clean up zombie processes and prune stale state files.
+ */
+export async function cleanupZombies(options) {
+    const stateDir = path.join(process.cwd(), '.claude', 'state', 'proc');
+    const allStates = ProcessStateManager.readAll(stateDir);
+    if (allStates.length === 0) {
+        logger.info('No process state files found.');
+        return 0;
+    }
+    // Classify processes
+    const toPrune = [];
+    const toKill = [];
+    const skipped = [];
+    for (const data of allStates) {
+        const filePath = path.join(stateDir, `${data.id}.json`);
+        if (data.state === 'exited') {
+            toPrune.push({ data, filePath });
+            continue;
+        }
+        const alive = isAlive(data.pid, data.processName);
+        if (!alive) {
+            toPrune.push({ data, filePath });
+        }
+        else if (data.state === 'result_received' || data.state === 'killing') {
+            toKill.push({ data, filePath });
+        }
+        else {
+            // state === 'running' or 'spawning' — skip, warn user
+            skipped.push({ data, reason: `alive (state: ${data.state})` });
+        }
+    }
+    // Display summary
+    console.log('');
+    logger.section('Process State Cleanup');
+    console.log('');
+    if (toKill.length > 0) {
+        console.log(chalk.red(`  Zombie processes to kill: ${toKill.length}`));
+        for (const entry of toKill) {
+            console.log(chalk.gray(`    - ${entry.data.id} (pid: ${entry.data.pid}, state: ${entry.data.state})`));
+        }
+    }
+    if (toPrune.length > 0) {
+        console.log(chalk.yellow(`  Stale state files to prune: ${toPrune.length}`));
+        for (const entry of toPrune) {
+            console.log(chalk.gray(`    - ${entry.data.id} (pid: ${entry.data.pid}, state: ${entry.data.state})`));
+        }
+    }
+    if (skipped.length > 0) {
+        console.log(chalk.blue(`  Active processes skipped: ${skipped.length}`));
+        for (const entry of skipped) {
+            console.log(chalk.gray(`    - ${entry.data.id} (pid: ${entry.data.pid}, ${entry.reason})`));
+            logger.warn(`Skipping ${entry.data.id}: process is ${entry.reason}`);
+        }
+    }
+    console.log('');
+    const totalActionable = toKill.length + toPrune.length;
+    if (totalActionable === 0) {
+        logger.info('Nothing to clean up.');
+        return 0;
+    }
+    if (options.dryRun) {
+        logger.info(chalk.yellow(`Would kill ${toKill.length} zombie(s) and prune ${toPrune.length} stale file(s).`));
+        return 0;
+    }
+    if (!options.yes) {
+        const { confirm } = await inquirer.prompt([{
+                type: 'confirm',
+                name: 'confirm',
+                message: `Kill ${toKill.length} zombie process(es) and prune ${toPrune.length} stale state file(s)?`,
+                default: false,
+            }]);
+        if (!confirm) {
+            logger.info('Cleanup cancelled.');
+            return 0;
+        }
+    }
+    const spinner = ora('Cleaning up process state...').start();
+    let removed = 0;
+    // Kill zombie processes
+    for (const entry of toKill) {
+        const result = killTree(entry.data.pid);
+        if (result.survived.length > 0) {
+            logger.warn(`Some processes survived kill for ${entry.data.id}: PIDs ${result.survived.join(', ')}`);
+        }
+        try {
+            fs.removeSync(entry.filePath);
+            removed++;
+        }
+        catch (err) {
+            logger.warn(`Failed to delete state file: ${entry.filePath}`);
+        }
+    }
+    // Prune stale state files
+    for (const entry of toPrune) {
+        try {
+            fs.removeSync(entry.filePath);
+            removed++;
+        }
+        catch (err) {
+            logger.warn(`Failed to delete state file: ${entry.filePath}`);
+        }
+    }
+    spinner.succeed(`Cleaned ${removed} process state file(s) (${toKill.length} killed, ${toPrune.length} pruned, ${skipped.length} skipped)`);
+    return removed;
+}
+/**
+ * Show cleanup status without removing anything.
+ */
+async function showStatus() {
+    console.log('');
+    logger.section('Cleanup Status');
+    console.log('');
+    // Deprecated files
+    const deprecated = await findDeprecatedFiles();
+    if (deprecated.length > 0) {
+        console.log(chalk.yellow(`  Deprecated files: ${deprecated.length}`));
+        for (const file of deprecated.slice(0, 5)) {
+            console.log(chalk.gray(`    - ${file}`));
+        }
+        if (deprecated.length > 5) {
+            console.log(chalk.gray(`    ... and ${deprecated.length - 5} more`));
+        }
+    }
+    else {
+        console.log(chalk.green('  Deprecated files: 0'));
+    }
+    console.log('');
+    // Unknown files (custom, not tracked)
+    const unknown = await findUnknownFiles();
+    if (unknown.length > 0) {
+        console.log(chalk.blue(`  Custom files (not tracked): ${unknown.length}`));
+        for (const file of unknown.slice(0, 5)) {
+            console.log(chalk.gray(`    - ${file}`));
+        }
+        if (unknown.length > 5) {
+            console.log(chalk.gray(`    ... and ${unknown.length - 5} more`));
+        }
+    }
+    else {
+        console.log(chalk.green('  Custom files: 0'));
+    }
+    console.log('');
+    // Backups
+    const backups = await listBackups(CLAUDE_DIR);
+    console.log(`  Backups: ${backups.length}`);
+    if (backups.length > 5) {
+        console.log(chalk.yellow(`    ${backups.length - 5} can be pruned (keeping 5)`));
+    }
+    console.log('');
+    // Process state files
+    const stateDir = path.join(process.cwd(), '.claude', 'state', 'proc');
+    const procStates = ProcessStateManager.readAll(stateDir);
+    if (procStates.length > 0) {
+        const exited = procStates.filter(s => s.state === 'exited').length;
+        const nonExited = procStates.length - exited;
+        console.log(`  Process state files: ${procStates.length}`);
+        if (exited > 0) {
+            console.log(chalk.yellow(`    ${exited} exited (can be pruned)`));
+        }
+        if (nonExited > 0) {
+            console.log(chalk.blue(`    ${nonExited} active/zombie`));
+        }
+    }
+    else {
+        console.log(chalk.green('  Process state files: 0'));
+    }
+    console.log('');
+    // Show available cleanup commands
+    logger.info('Available cleanup commands:');
+    console.log('');
+    console.log(`  ${chalk.cyan('archai cleanup --deprecated')}  Remove deprecated files`);
+    console.log(`  ${chalk.cyan('archai cleanup --backups')}     Prune old backups`);
+    console.log(`  ${chalk.cyan('archai cleanup --zombies')}     Kill zombie processes and prune stale state files`);
+    console.log(`  ${chalk.cyan('archai cleanup --all')}         Clean everything`);
+    console.log('');
+}
+/**
+ * Main cleanup command.
+ */
+export async function cleanup(options = {}) {
+    logger.banner();
+    // If no specific option, show status
+    if (!options.deprecated && !options.backups && !options.zombies && !options.all) {
+        await showStatus();
+        return;
+    }
+    let totalRemoved = 0;
+    // Clean deprecated files
+    if (options.deprecated || options.all) {
+        const removed = await cleanupDeprecated(options);
+        totalRemoved += removed;
+    }
+    // Clean old backups
+    if (options.backups || options.all) {
+        if (options.deprecated || options.all) {
+            console.log(''); // Add spacing between sections
+        }
+        const removed = await cleanupBackups(options);
+        totalRemoved += removed;
+    }
+    // Clean zombie processes and stale state files
+    if (options.zombies || options.all) {
+        if (options.deprecated || options.backups || options.all) {
+            console.log('');
+        }
+        const removed = await cleanupZombies(options);
+        totalRemoved += removed;
+    }
+    console.log('');
+    if (options.dryRun) {
+        logger.info('Dry run complete. No files were removed.');
+    }
+    else if (totalRemoved > 0) {
+        logger.success(`Cleanup complete! Removed ${totalRemoved} item(s).`);
+    }
+    else {
+        logger.info('Nothing to clean up.');
+    }
+    console.log('');
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/commands/cleanup.js.map

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

package/dist/commands/dispatch.d.ts

@@ -0,0 +1,13 @@
+import type { DispatchOptions } from '../types/index.js';
+/**
+ * Spawn `claude -p` as a managed child process.
+ *
+ * All process lifecycle (spawn, monitoring, timeout, signal handling, cleanup)
+ * is delegated to ManagedProcess. This function handles:
+ * - Prompt file validation
+ * - Argument building
+ * - Output file writing
+ * - Exit code forwarding
+ */
+export declare function dispatch(opts: DispatchOptions): Promise<void>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/commands/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/commands/dispatch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DnE"}

package/dist/commands/dispatch.js

@@ -0,0 +1,85 @@
+import fs from 'fs';
+import path from 'path';
+import { logger } from '../utils/logger.js';
+import { ManagedProcess } from '../utils/managed-process.js';
+/**
+ * Spawn `claude -p` as a managed child process.
+ *
+ * All process lifecycle (spawn, monitoring, timeout, signal handling, cleanup)
+ * is delegated to ManagedProcess. This function handles:
+ * - Prompt file validation
+ * - Argument building
+ * - Output file writing
+ * - Exit code forwarding
+ */
+export async function dispatch(opts) {
+    const { agent, promptFile, output, exitCodeFile, cwd, maxTurns, timeout } = opts;
+    // BC-7: Prompt file validation (RETAINED)
+    const resolvedPromptFile = path.resolve(promptFile);
+    if (!fs.existsSync(resolvedPromptFile)) {
+        logger.error(`Prompt file not found: ${resolvedPromptFile}`);
+        process.exitCode = 1;
+        return;
+    }
+    // BC-7: Arg building (RETAINED)
+    const args = ['-p', '--agent', agent, '--output-format', 'stream-json', '--verbose'];
+    if (maxTurns) {
+        args.push('--max-turns', String(maxTurns));
+    }
+    // BC-7: Output directory creation (RETAINED)
+    const resolvedOutput = path.resolve(output);
+    const outputDir = path.dirname(resolvedOutput);
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    logger.info(`Dispatching claude -p --agent ${agent}`);
+    // BC-6: Delegate ALL lifecycle to ManagedProcess
+    const mp = ManagedProcess.spawn({
+        id: opts.taskId || `dispatch-${Date.now()}`,
+        cmd: 'claude',
+        args,
+        cwd: cwd ? path.resolve(cwd) : process.cwd(),
+        stdin: resolvedPromptFile,
+        stdout: 'stream-json',
+        timeout,
+    });
+    // Await completion
+    const completion = await mp.completion;
+    // BC-7: Write output file from accumulated text (RETAINED)
+    fs.writeFileSync(resolvedOutput, completion.textOutput || '', 'utf-8');
+    // Await actual exit
+    const exit = await mp.exit;
+    const exitCode = completion.timedOut ? 124 : (exit.exitCode ?? 1);
+    // BC-7: Write exit code file (RETAINED)
+    if (exitCodeFile) {
+        writeExitCode(exitCodeFile, exitCode);
+    }
+    if (completion.timedOut) {
+        logger.warn('Process timed out (exit code 124)');
+    }
+    else if (exitCode !== 0) {
+        logger.warn(`Process exited with code ${exitCode}`);
+    }
+    else {
+        logger.success('Dispatch complete (exit code 0)');
+    }
+    // BC-7: Exit code forwarding (RETAINED)
+    process.exitCode = exitCode;
+}
+/**
+ * Write exit code to a file (for parallel task patterns).
+ */
+function writeExitCode(filePath, code) {
+    try {
+        const resolved = path.resolve(filePath);
+        const dir = path.dirname(resolved);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(resolved, String(code), 'utf-8');
+    }
+    catch (err) {
+        logger.warn(`Failed to write exit code file: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/commands/dispatch.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function doctor(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAWA,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA0J5C"}

package/dist/commands/doctor.js

@@ -0,0 +1,155 @@
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import { logger } from '../utils/logger.js';
+import { getClaudeCliInfo } from '../generator/claude-cli.js';
+import { diagnoseMcpConfig } from '../utils/repair-mcp-config.js';
+export async function doctor() {
+    logger.banner();
+    logger.section('System Health Check');
+    console.log('');
+    const checks = [
+        {
+            name: 'Node.js version',
+            check: async () => {
+                const version = process.version;
+                const major = parseInt(version.slice(1).split('.')[0]);
+                return {
+                    pass: major >= 18,
+                    message: major >= 18 ? `${version} (OK)` : `${version} (requires 18+)`,
+                };
+            },
+        },
+        {
+            name: 'Claude Code CLI',
+            check: async () => {
+                const info = getClaudeCliInfo();
+                if (!info.available) {
+                    return { pass: false, message: 'Not found - install from https://claude.ai/code' };
+                }
+                if (!info.compatible) {
+                    return {
+                        pass: false,
+                        message: `Version ${info.version} - upgrade recommended`
+                    };
+                }
+                return { pass: true, message: `${info.version || 'Installed'}` };
+            },
+        },
+        {
+            name: 'Folder structure',
+            check: async () => {
+                const required = [
+                    '.claude/agents',
+                    '.claude/state',
+                    '.claude/plans',
+                    '.knowledge/context',
+                    '.tasks/inbox',
+                    '.tasks/templates',
+                    '.supervisor',
+                    '.agents',
+                ];
+                const missing = [];
+                for (const dir of required) {
+                    if (!(await fs.pathExists(dir))) {
+                        missing.push(dir);
+                    }
+                }
+                return {
+                    pass: missing.length === 0,
+                    message: missing.length === 0 ? 'Complete' : `Missing: ${missing.join(', ')}`,
+                };
+            },
+        },
+        {
+            name: 'Configuration file',
+            check: async () => {
+                const exists = await fs.pathExists('archai.config.md');
+                return {
+                    pass: exists,
+                    message: exists ? 'Found' : 'Not found - run "archai init"',
+                };
+            },
+        },
+        {
+            name: 'Project description',
+            check: async () => {
+                const path = '.knowledge/context/project-description.md';
+                const exists = await fs.pathExists(path);
+                if (!exists) {
+                    return { pass: false, message: 'Not found' };
+                }
+                const content = await fs.readFile(path, 'utf-8');
+                const hasPlaceholders = content.includes('[Project Name]') || content.includes('[What does this');
+                return {
+                    pass: !hasPlaceholders,
+                    message: hasPlaceholders ? 'Found but needs to be filled in' : 'Configured',
+                };
+            },
+        },
+        {
+            name: 'MCP configuration',
+            check: async () => {
+                const result = await diagnoseMcpConfig(process.cwd());
+                if (result.fixed.length > 0) {
+                    return {
+                        pass: false,
+                        message: `${result.fixed.length} issue(s) found — run "archai update" to fix`,
+                    };
+                }
+                return { pass: true, message: 'OK' };
+            },
+        },
+        {
+            name: 'Core agents',
+            check: async () => {
+                const coreAgents = [
+                    'maestro-agent',
+                    'maestro-headless-agent',
+                    'deep-analyst',
+                    'plan-validator',
+                    'tdd-designer',
+                    'critical-reviewer',
+                    'implementation-agent',
+                    'code-reviewer',
+                    'cleanup-agent',
+                    'finalization-agent',
+                    'task-orchestrator',
+                    'task-prep',
+                    'quick-fix',
+                    'git-coordinator',
+                    'boss-agent',
+                ];
+                const missing = [];
+                for (const agent of coreAgents) {
+                    if (!(await fs.pathExists(`.claude/agents/${agent}.md`))) {
+                        missing.push(agent);
+                    }
+                }
+                return {
+                    pass: missing.length === 0,
+                    message: missing.length === 0 ? `${coreAgents.length} agents installed` : `Missing: ${missing.join(', ')}`,
+                };
+            },
+        },
+    ];
+    let allPassed = true;
+    for (const check of checks) {
+        const result = await check.check();
+        const icon = result.pass ? chalk.green('✓') : chalk.red('✗');
+        const status = result.pass ? chalk.green(result.message) : chalk.red(result.message);
+        console.log(`  ${icon} ${check.name}: ${status}`);
+        if (!result.pass)
+            allPassed = false;
+    }
+    console.log('');
+    logger.divider();
+    console.log('');
+    if (allPassed) {
+        logger.success('All checks passed! Your archai setup is healthy.');
+    }
+    else {
+        logger.warn('Some checks failed. Fix the issues above and run "archai doctor" again.');
+    }
+    console.log('');
+}
+//# sourceMappingURL=doctor.js.map