@bhimudev/gnanai 0.4.0

package/dist/utils/process-tree.js

@@ -0,0 +1,499 @@
+import { execSync } from 'child_process';
+import path from 'path';
+import { logger } from './logger.js';
+// ============================================================
+// Internal helpers
+// ============================================================
+const MAX_BUFFER = 10 * 1024 * 1024; // 10 MB
+/**
+ * Synchronous sleep using Atomics.wait (Node.js 18+).
+ */
+function syncSleep(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+/**
+ * Parse PowerShell Get-CimInstance JSON output into ProcessNode[].
+ */
+function parsePowerShellJson(raw) {
+    const cleaned = raw.trim().replace(/^\uFEFF/, ''); // strip BOM
+    if (!cleaned)
+        return [];
+    try {
+        const parsed = JSON.parse(cleaned);
+        const arr = Array.isArray(parsed) ? parsed : [parsed]; // single object -> array
+        return arr.map((p) => ({
+            pid: p.ProcessId,
+            ppid: p.ParentProcessId,
+            name: p.Name || '',
+            cmd: p.CommandLine || '', // null CommandLine -> ''
+        }));
+    }
+    catch {
+        logger.warn('Failed to parse PowerShell JSON output');
+        return [];
+    }
+}
+/**
+ * Fallback: parse tasklist CSV output. Returns nodes with ppid=0 (no parent info).
+ */
+function getAllProcessesTasklist() {
+    try {
+        const raw = execSync('tasklist /FO CSV /NH', {
+            encoding: 'utf-8',
+            maxBuffer: MAX_BUFFER,
+            windowsHide: true,
+            timeout: 10_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return raw
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => {
+            const fields = line.match(/"([^"]*)"/g)?.map((f) => f.replace(/"/g, ''));
+            if (!fields || fields.length < 2)
+                return null;
+            return {
+                pid: parseInt(fields[1], 10),
+                ppid: 0,
+                name: fields[0],
+                cmd: '',
+            };
+        })
+            .filter((p) => p !== null && !isNaN(p.pid));
+    }
+    catch {
+        logger.warn('tasklist also failed');
+        return [];
+    }
+}
+/**
+ * Get all processes on Windows using PowerShell, with tasklist fallback.
+ */
+function getAllProcessesWindows() {
+    try {
+        const raw = execSync('powershell -NoProfile -ExecutionPolicy Bypass -Command "Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId,Name,CommandLine | ConvertTo-Json -Compress"', {
+            encoding: 'utf-8',
+            maxBuffer: MAX_BUFFER,
+            windowsHide: true,
+            timeout: 15_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return parsePowerShellJson(raw);
+    }
+    catch (err) {
+        // ENOENT: PowerShell not found. Non-zero exit: PowerShell error.
+        if (err?.code === 'ENOENT' || err?.status !== undefined) {
+            logger.warn('PowerShell unavailable, falling back to tasklist (no tree enumeration)');
+            return getAllProcessesTasklist();
+        }
+        return [];
+    }
+}
+/**
+ * Get all processes on Unix using ps.
+ */
+function getAllProcessesUnix() {
+    try {
+        const raw = execSync('ps -eo pid=,ppid=,args=', {
+            encoding: 'utf-8',
+            maxBuffer: MAX_BUFFER,
+            timeout: 10_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return raw
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => {
+            const match = line.trim().match(/^(\d+)\s+(\d+)\s+(.*)$/);
+            if (!match)
+                return null;
+            const pid = parseInt(match[1], 10);
+            const ppid = parseInt(match[2], 10);
+            const args = match[3].trim();
+            const name = path.basename(args.split(/\s+/)[0]);
+            return { pid, ppid, name, cmd: args };
+        })
+            .filter((p) => p !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get all processes (platform-dispatched).
+ */
+export function getAllProcesses() {
+    return process.platform === 'win32'
+        ? getAllProcessesWindows()
+        : getAllProcessesUnix();
+}
+/**
+ * Build a map of parent PID -> child PIDs.
+ */
+function buildChildMap(processes) {
+    const map = new Map();
+    for (const proc of processes) {
+        const children = map.get(proc.ppid);
+        if (children) {
+            children.push(proc.pid);
+        }
+        else {
+            map.set(proc.ppid, [proc.pid]);
+        }
+    }
+    return map;
+}
+// ============================================================
+// Exported functions
+// ============================================================
+/**
+ * Enumerate the full process tree rooted at rootPid, including root.
+ * Each node includes a `depth` field (root = 0).
+ * Returns empty array if rootPid is not found in the process table.
+ */
+export function enumerateTree(rootPid) {
+    const allProcs = getAllProcesses();
+    const procMap = new Map();
+    for (const p of allProcs) {
+        procMap.set(p.pid, p);
+    }
+    const childMap = buildChildMap(allProcs);
+    const result = [];
+    const visited = new Set();
+    // Check if rootPid is in the process table AND has children
+    const hasRoot = procMap.has(rootPid);
+    const hasChildren = childMap.has(rootPid);
+    // If root not found and no children reference it, return empty
+    if (!hasRoot && !hasChildren)
+        return [];
+    // BFS from rootPid
+    const queue = [
+        { pid: rootPid, depth: 0 },
+    ];
+    while (queue.length > 0) {
+        const { pid, depth } = queue.shift();
+        if (visited.has(pid))
+            continue;
+        visited.add(pid);
+        const proc = procMap.get(pid);
+        // Only add to result if the process exists in the table
+        if (proc) {
+            result.push({ ...proc, depth });
+        }
+        const children = childMap.get(pid) || [];
+        for (const childPid of children) {
+            if (!visited.has(childPid)) {
+                queue.push({ pid: childPid, depth: depth + 1 });
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Enumerate descendants of rootPid (NOT including root itself).
+ * Returns flat array of ProcessNode[].
+ */
+export function enumerateChildren(rootPid) {
+    const tree = enumerateTree(rootPid);
+    return tree
+        .filter((n) => n.pid !== rootPid)
+        .map(({ depth: _, ...rest }) => rest);
+}
+/**
+ * Check if a process is alive. Optionally verify process name matches.
+ */
+export function isAlive(pid, expectedName) {
+    if (process.platform === 'win32') {
+        return isAliveWindows(pid, expectedName);
+    }
+    return isAliveUnix(pid, expectedName);
+}
+function isAliveWindows(pid, expectedName) {
+    try {
+        const raw = execSync(`tasklist /FI "PID eq ${pid}" /FO CSV /NH`, {
+            encoding: 'utf-8',
+            windowsHide: true,
+            timeout: 5_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (raw.includes('INFO: No tasks'))
+            return false;
+        if (!expectedName)
+            return true;
+        // Parse CSV: "name.exe","pid","Session Name","Session#","Mem Usage"
+        const match = raw.match(/"([^"]+)"/);
+        if (!match)
+            return true; // can't parse but process exists
+        return match[1].toLowerCase() === expectedName.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+}
+function isAliveUnix(pid, expectedName) {
+    try {
+        process.kill(pid, 0);
+    }
+    catch (err) {
+        if (err?.code === 'EPERM')
+            return true; // exists but no permission
+        return false; // ESRCH = not found
+    }
+    if (!expectedName)
+        return true;
+    // Check name via ps
+    try {
+        const raw = execSync(`ps -p ${pid} -o comm=`, {
+            encoding: 'utf-8',
+            timeout: 5_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return raw.trim().toLowerCase() === expectedName.toLowerCase();
+    }
+    catch {
+        return true; // can't verify name but process exists
+    }
+}
+/**
+ * Find processes whose working directory or command line relates to dirPath.
+ * Excludes own PID.
+ */
+export function findByCwd(dirPath) {
+    if (process.platform === 'win32') {
+        return findByCwdWindows(dirPath);
+    }
+    return findByCwdUnix(dirPath);
+}
+function findByCwdWindows(dirPath) {
+    const allProcs = getAllProcessesWindows();
+    // Normalize: lowercase + backslashes for consistent matching
+    const normalized = dirPath.replace(/\//g, '\\').toLowerCase();
+    return allProcs.filter((p) => p.pid !== process.pid &&
+        p.cmd.toLowerCase().replace(/\//g, '\\').includes(normalized));
+}
+function findByCwdUnix(dirPath) {
+    let pids;
+    try {
+        const raw = execSync(`lsof +D "${dirPath}" -t 2>/dev/null || true`, {
+            encoding: 'utf-8',
+            maxBuffer: MAX_BUFFER,
+            timeout: 10_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        pids = raw
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((s) => parseInt(s.trim(), 10))
+            .filter((n) => !isNaN(n) && n !== process.pid);
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT') {
+            logger.warn('lsof not available, cannot find processes by directory');
+        }
+        return [];
+    }
+    if (pids.length === 0)
+        return [];
+    // B2: cross-reference with full process table for ProcessNode fields
+    const allProcs = getAllProcessesUnix();
+    const pidSet = new Set(pids);
+    return allProcs.filter((p) => pidSet.has(p.pid));
+}
+/**
+ * Kill a process tree rooted at rootPid. Synchronous.
+ * Returns accounting of killed/survived/errors.
+ */
+export function killTree(rootPid, opts) {
+    if (process.platform === 'win32') {
+        return killTreeWindows(rootPid, opts);
+    }
+    return killTreeUnix(rootPid, opts);
+}
+function killTreeWindows(rootPid, opts) {
+    const killed = [];
+    const survived = [];
+    const errors = [];
+    let tree;
+    try {
+        tree = enumerateTree(rootPid);
+    }
+    catch {
+        // Fallback: best-effort kill without enumeration
+        try {
+            execSync(`taskkill /F /T /PID ${rootPid}`, {
+                windowsHide: true,
+                stdio: 'pipe',
+                timeout: 5000,
+            });
+        }
+        catch {
+            /* truly nothing we can do */
+        }
+        return { killed: [], survived: [], errors: [] };
+    }
+    if (tree.length === 0) {
+        return { killed, survived, errors };
+    }
+    // Sort by depth descending (leaf-to-root)
+    const sorted = [...tree].sort((a, b) => b.depth - a.depth);
+    // Kill each process
+    for (const proc of sorted) {
+        if (proc.pid === process.pid)
+            continue;
+        try {
+            execSync(`taskkill /F /PID ${proc.pid}`, {
+                windowsHide: true,
+                stdio: 'pipe',
+                timeout: 5000,
+            });
+        }
+        catch {
+            // Process may already be dead -- that's OK
+        }
+    }
+    // Re-enumerate survivors
+    let survivors;
+    try {
+        survivors = enumerateTree(rootPid);
+    }
+    catch {
+        survivors = [];
+    }
+    if (survivors.length > 0) {
+        // Retry survivors once
+        const retrySorted = [...survivors].sort((a, b) => b.depth - a.depth);
+        for (const proc of retrySorted) {
+            if (proc.pid === process.pid)
+                continue;
+            try {
+                execSync(`taskkill /F /PID ${proc.pid}`, {
+                    windowsHide: true,
+                    stdio: 'pipe',
+                    timeout: 5000,
+                });
+            }
+            catch {
+                // Process may already be dead
+            }
+        }
+    }
+    // Verify all dead
+    for (const proc of sorted) {
+        if (proc.pid === process.pid)
+            continue;
+        if (isAlive(proc.pid)) {
+            survived.push(proc.pid);
+        }
+        else {
+            killed.push(proc.pid);
+        }
+    }
+    return { killed, survived, errors };
+}
+function killTreeUnix(rootPid, opts) {
+    const killed = [];
+    const survived = [];
+    const errors = [];
+    const gracePeriodMs = opts?.gracePeriodMs ?? 3000;
+    // B1: When gracePeriodMs === 0, skip SIGTERM group kill entirely.
+    if (gracePeriodMs > 0) {
+        let groupKillAttempted = false;
+        try {
+            // Check if rootPid is a process group leader
+            process.kill(-rootPid, 0);
+            // If no throw, it IS a group leader -- send SIGTERM to the group
+            process.kill(-rootPid, 'SIGTERM');
+            groupKillAttempted = true;
+        }
+        catch {
+            // Not a process group leader, or group doesn't exist
+            // Skip group kill, go straight to individual enumeration+kill
+        }
+        if (groupKillAttempted) {
+            // Wait up to gracePeriodMs, polling isAlive in 100ms increments
+            const deadline = Date.now() + gracePeriodMs;
+            while (Date.now() < deadline && isAlive(rootPid)) {
+                syncSleep(100);
+            }
+        }
+    }
+    // Enumerate survivors and kill individually (leaf-to-root)
+    let tree;
+    try {
+        tree = enumerateTree(rootPid);
+    }
+    catch {
+        // Fallback: best-effort kill without enumeration
+        try {
+            process.kill(-rootPid, 'SIGKILL');
+        }
+        catch {
+            /* truly nothing we can do */
+        }
+        return { killed: [], survived: [], errors: [] };
+    }
+    const sorted = [...tree].sort((a, b) => b.depth - a.depth);
+    for (const proc of sorted) {
+        if (proc.pid === process.pid)
+            continue;
+        try {
+            process.kill(proc.pid, 'SIGKILL');
+        }
+        catch {
+            /* ESRCH = already dead */
+        }
+    }
+    // Verify all dead
+    for (const proc of sorted) {
+        if (proc.pid === process.pid)
+            continue;
+        if (isAlive(proc.pid)) {
+            survived.push(proc.pid);
+        }
+        else {
+            killed.push(proc.pid);
+        }
+    }
+    return { killed, survived, errors };
+}
+/**
+ * Kill a single process by PID. Returns true if process is now dead.
+ * Self-PID protected: will not kill own process.
+ */
+export function killSingle(pid) {
+    // Self-PID protection
+    if (pid === process.pid)
+        return false;
+    if (process.platform === 'win32') {
+        try {
+            execSync(`taskkill /F /PID ${pid}`, {
+                windowsHide: true,
+                stdio: 'pipe',
+                timeout: 5000,
+            });
+        }
+        catch {
+            // Process may not exist or permission denied
+        }
+        return !isAlive(pid);
+    }
+    // Unix
+    try {
+        process.kill(pid, 'SIGKILL');
+    }
+    catch (err) {
+        if (err?.code === 'ESRCH') {
+            // Already dead -- that's what we wanted
+            return false;
+        }
+        if (err?.code === 'EPERM') {
+            return false;
+        }
+        return false;
+    }
+    return !isAlive(pid);
+}
+//# sourceMappingURL=process-tree.js.map

package/dist/utils/process-tree.js.map

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

package/dist/utils/repair-mcp-config.d.ts

@@ -0,0 +1,15 @@
+export interface McpRepairResult {
+    fixed: string[];
+    warnings: string[];
+}
+/**
+ * Detect and repair broken MCP configurations from v0.3.0.
+ * Reads, fixes, and writes config files.
+ */
+export declare function repairMcpConfig(projectRoot: string): Promise<McpRepairResult>;
+/**
+ * Read-only diagnosis of MCP configuration issues.
+ * Returns what would be fixed without modifying any files.
+ */
+export declare function diagnoseMcpConfig(projectRoot: string): Promise<McpRepairResult>;
+//# sourceMappingURL=repair-mcp-config.d.ts.map

package/dist/utils/repair-mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-mcp-config.d.ts","sourceRoot":"","sources":["../../src/utils/repair-mcp-config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgJD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAEnF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAErF"}

package/dist/utils/repair-mcp-config.js

@@ -0,0 +1,129 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { readMcpJson, readClaudeSettings, writeClaudeSettings } from './merge-claude-settings.js';
+/**
+ * Atomically write .mcp.json for a project root.
+ */
+async function writeMcpJson(projectRoot, data) {
+    const mcpJsonPath = path.join(projectRoot, '.mcp.json');
+    const tmpPath = path.join(projectRoot, `.mcp.json.tmp.${Date.now()}`);
+    await fs.writeFile(tmpPath, JSON.stringify(data, null, 2) + '\n');
+    await fs.rename(tmpPath, mcpJsonPath);
+}
+function isArchiKnowledgeServer(name) {
+    return name.startsWith('archai-knowledge-');
+}
+/**
+ * Check if an MCP entry has the broken cmd /c wrapper pattern.
+ * Returns true if command === "cmd" && args[0] === "/c" && args[1] === "npx".
+ */
+function hasCmdWrapper(entry) {
+    return (entry.command === 'cmd' &&
+        Array.isArray(entry.args) &&
+        entry.args.length >= 2 &&
+        entry.args[0] === '/c' &&
+        entry.args[1] === 'npx');
+}
+/**
+ * Fix the cmd /c wrapper: rewrite to { command: "npx", args: args.slice(2) }.
+ */
+function fixCmdWrapper(entry) {
+    const args = entry.args;
+    return { ...entry, command: 'npx', args: args.slice(2) };
+}
+/**
+ * Validate an MCP entry has the required shape (command: string, args: string[]).
+ */
+function validateEntryShape(name, entry) {
+    if (typeof entry.command !== 'string') {
+        return `MCP server "${name}": missing or invalid "command" (expected string)`;
+    }
+    if (!Array.isArray(entry.args)) {
+        return `MCP server "${name}": missing or invalid "args" (expected string[])`;
+    }
+    return null;
+}
+/**
+ * Core logic shared by repair and diagnose.
+ * When dryRun is true, no files are written.
+ */
+async function runMcpChecks(projectRoot, dryRun) {
+    const fixed = [];
+    const warnings = [];
+    // Read current .mcp.json
+    const mcpJson = (await readMcpJson(projectRoot));
+    let mcpDirty = false;
+    if (!mcpJson.mcpServers) {
+        mcpJson.mcpServers = {};
+    }
+    // Fix 2: Migrate archai-knowledge-* entries from .claude/settings.json → .mcp.json
+    const claudeSettings = await readClaudeSettings(projectRoot);
+    const settingsServers = (claudeSettings.mcpServers ?? {});
+    let settingsDirty = false;
+    for (const [name, entry] of Object.entries(settingsServers)) {
+        if (!isArchiKnowledgeServer(name))
+            continue;
+        // Migrate to .mcp.json (apply cmd /c fix during migration too)
+        let migratedEntry = { ...entry };
+        if (hasCmdWrapper(migratedEntry)) {
+            migratedEntry = fixCmdWrapper(migratedEntry);
+            fixed.push(`${name}: removed cmd /c wrapper (migrated from settings.json)`);
+        }
+        else {
+            fixed.push(`${name}: migrated from .claude/settings.json to .mcp.json`);
+        }
+        mcpJson.mcpServers[name] = migratedEntry;
+        mcpDirty = true;
+        delete settingsServers[name];
+        settingsDirty = true;
+    }
+    // Fix 1: cmd /c wrapper removal in .mcp.json entries
+    for (const [name, entry] of Object.entries(mcpJson.mcpServers)) {
+        if (!isArchiKnowledgeServer(name))
+            continue;
+        if (hasCmdWrapper(entry)) {
+            mcpJson.mcpServers[name] = fixCmdWrapper(entry);
+            mcpDirty = true;
+            fixed.push(`${name}: removed cmd /c wrapper from .mcp.json`);
+        }
+    }
+    // Check 3: Validate entry shapes (all servers, not just archai ones)
+    for (const [name, entry] of Object.entries(mcpJson.mcpServers)) {
+        const warning = validateEntryShape(name, entry);
+        if (warning) {
+            warnings.push(warning);
+        }
+    }
+    // Write changes if not dry run
+    if (!dryRun) {
+        if (mcpDirty) {
+            await writeMcpJson(projectRoot, mcpJson);
+        }
+        if (settingsDirty) {
+            // Update settings with removed entries
+            if (Object.keys(settingsServers).length === 0) {
+                delete claudeSettings.mcpServers;
+            }
+            else {
+                claudeSettings.mcpServers = settingsServers;
+            }
+            await writeClaudeSettings(projectRoot, claudeSettings);
+        }
+    }
+    return { fixed, warnings };
+}
+/**
+ * Detect and repair broken MCP configurations from v0.3.0.
+ * Reads, fixes, and writes config files.
+ */
+export async function repairMcpConfig(projectRoot) {
+    return runMcpChecks(projectRoot, false);
+}
+/**
+ * Read-only diagnosis of MCP configuration issues.
+ * Returns what would be fixed without modifying any files.
+ */
+export async function diagnoseMcpConfig(projectRoot) {
+    return runMcpChecks(projectRoot, true);
+}
+//# sourceMappingURL=repair-mcp-config.js.map

package/dist/utils/repair-mcp-config.js.map

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