@bhimudev/gnanai 0.4.0

package/dist/utils/managed-process.js

@@ -0,0 +1,481 @@
+import { spawn } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import readline from 'readline';
+import { EventEmitter } from 'events';
+import { killTree, enumerateTree, isAlive } from './process-tree.js';
+import { logger } from './logger.js';
+let _registryHook = null;
+export function setRegistryHook(hook) {
+    _registryHook = hook;
+}
+// ============================================================
+// Constants
+// ============================================================
+const DEFAULT_TIMEOUT = 7200; // 2 hours in seconds
+const DEFAULT_GRACE_PERIOD = 30000; // 30 seconds in ms
+const DEFAULT_TREE_SNAPSHOT_INTERVAL = 10; // every 10th event
+const PARENT_ALIVE_CHECK_INTERVAL = 5000; // 5 seconds
+// ============================================================
+// buildCleanEnv
+// ============================================================
+/**
+ * Build a clean environment for the child process.
+ * Removes Claude Code internal env vars that cause hangs when leaked.
+ */
+export function buildCleanEnv() {
+    const env = { ...process.env };
+    delete env.CLAUDECODE;
+    delete env.CLAUDE_CODE_SSE_PORT;
+    delete env.CLAUDE_CODE_ENTRYPOINT;
+    return env;
+}
+// ============================================================
+// StreamJsonMonitor
+// ============================================================
+/**
+ * Monitors stdout for stream-json formatted output.
+ * Parses JSON lines, detects result events, accumulates assistant text.
+ */
+export class StreamJsonMonitor {
+    _assistantText = [];
+    _rawLines = [];
+    _resultCount = 0;
+    _eventCount = 0;
+    _lastEventTime = null;
+    _rl;
+    resultPromise;
+    constructor(stdout) {
+        this._rl = readline.createInterface({ input: stdout });
+        this.resultPromise = new Promise((resolve) => {
+            this._rl.on('line', (line) => {
+                this._rawLines.push(line);
+                if (!line.trim())
+                    return; // skip empty lines
+                try {
+                    const event = JSON.parse(line);
+                    this._eventCount++;
+                    this._lastEventTime = Date.now();
+                    // Accumulate text from assistant events
+                    if (event.type === 'assistant' && Array.isArray(event.content)) {
+                        for (const block of event.content) {
+                            if (block.type === 'text' && typeof block.text === 'string') {
+                                this._assistantText.push(block.text);
+                            }
+                        }
+                    }
+                    // Detect result sentinel
+                    if (event.type === 'result') {
+                        this._resultCount++;
+                        if (this._resultCount === 1) {
+                            resolve(event);
+                        }
+                    }
+                }
+                catch {
+                    // Ignore malformed JSON lines
+                }
+            });
+        });
+    }
+    getTextOutput() {
+        // Fallback: if 0 result events, return raw lines joined (DECISION-6)
+        if (this._resultCount === 0 && this._rawLines.length > 0) {
+            return this._rawLines.filter((l) => l.trim()).join('\n');
+        }
+        return this._assistantText.join('');
+    }
+    getLastEventTime() {
+        return this._lastEventTime;
+    }
+    getEventCount() {
+        return this._eventCount;
+    }
+    destroy() {
+        this._rl.close();
+    }
+}
+// ============================================================
+// PassthroughMonitor
+// ============================================================
+/**
+ * No-op monitor for passthrough stdout mode.
+ * resultPromise never resolves.
+ */
+export class PassthroughMonitor {
+    resultPromise;
+    constructor(_stdout) {
+        this.resultPromise = new Promise(() => {
+            // Intentionally never resolves
+        });
+    }
+    getTextOutput() {
+        return '';
+    }
+    getLastEventTime() {
+        return null;
+    }
+    getEventCount() {
+        return 0;
+    }
+    destroy() {
+        // No-op
+    }
+}
+// ============================================================
+// ProcessStateManager
+// ============================================================
+/**
+ * Manages state files for ManagedProcess instances.
+ * Uses atomic writes (write .tmp then renameSync).
+ */
+export class ProcessStateManager {
+    _data = {};
+    _filePath;
+    _stateDir;
+    constructor(stateDir, id) {
+        this._stateDir = stateDir;
+        this._filePath = path.join(stateDir, `${id}.json`);
+    }
+    update(patch) {
+        try {
+            // Ensure directory exists
+            if (!fs.existsSync(this._stateDir)) {
+                fs.mkdirSync(this._stateDir, { recursive: true });
+            }
+            Object.assign(this._data, patch);
+            const tmp = this._filePath + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(this._data, null, 2));
+            fs.renameSync(tmp, this._filePath);
+        }
+        catch (err) {
+            logger.debug(`State file write failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    getData() {
+        return this._data;
+    }
+    static readAll(stateDir) {
+        try {
+            const files = fs.readdirSync(stateDir).filter((f) => f.endsWith('.json'));
+            return files
+                .map((f) => {
+                try {
+                    return JSON.parse(fs.readFileSync(path.join(stateDir, f), 'utf-8'));
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((d) => d !== null);
+        }
+        catch {
+            return [];
+        }
+    }
+    static readOne(id, stateDir) {
+        try {
+            const filePath = path.join(stateDir, `${id}.json`);
+            return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    static pruneStale(stateDir) {
+        const all = ProcessStateManager.readAll(stateDir);
+        for (const data of all) {
+            if (data.state === 'exited' || !isAlive(data.pid, data.processName)) {
+                try {
+                    fs.unlinkSync(path.join(stateDir, `${data.id}.json`));
+                }
+                catch {
+                    // best-effort
+                }
+            }
+        }
+    }
+}
+/**
+ * Unified process lifecycle abstraction.
+ * Wraps child_process.spawn() with intrinsic monitoring:
+ * state files, stream-json sentinel, lifecycle guards, process tree snapshots.
+ */
+export class ManagedProcess extends EventEmitter {
+    _child;
+    _opts;
+    _monitor;
+    _stateManager;
+    _cleanups = [];
+    _killing = false;
+    _timedOut = false;
+    _parentDied = false;
+    _startTime;
+    _state = 'spawning';
+    completion;
+    exit;
+    pid;
+    constructor(child, opts, monitor, stateManager) {
+        super();
+        this._child = child;
+        this._opts = {
+            ...opts,
+            timeout: opts.timeout ?? DEFAULT_TIMEOUT,
+            gracePeriod: opts.gracePeriod ?? DEFAULT_GRACE_PERIOD,
+            treeSnapshotInterval: opts.treeSnapshotInterval ?? DEFAULT_TREE_SNAPSHOT_INTERVAL,
+        };
+        this._monitor = monitor;
+        this._stateManager = stateManager;
+        this._startTime = Date.now();
+        this.pid = child.pid;
+        // Write initial state
+        this._stateManager.update({
+            id: opts.id,
+            pid: this.pid,
+            processName: opts.cmd,
+            state: 'spawning',
+            cmd: opts.cmd,
+            args: opts.args,
+            cwd: opts.cwd ?? process.cwd(),
+            startTime: this._startTime,
+            lastEventTime: null,
+            eventCount: 0,
+            treeSnapshot: [],
+            exitCode: null,
+            signal: null,
+            error: null,
+        });
+        // Transition to running
+        this._updateState('running');
+        // Capture stderr
+        if (child.stderr) {
+            let stderr = '';
+            child.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('close', () => {
+                if (stderr.trim()) {
+                    logger.debug('Child stderr', stderr.trim());
+                }
+            });
+        }
+        // Set up guards
+        this._setupGuards();
+        // Pipe stdin if specified
+        if (opts.stdin) {
+            const promptStream = fs.createReadStream(opts.stdin);
+            promptStream.pipe(child.stdin);
+            child.stdin.on('error', (err) => {
+                if (err.code === 'EPIPE') {
+                    logger.debug('Child stdin closed (EPIPE)');
+                }
+            });
+        }
+        // Set up completion promise
+        this.completion = new Promise((resolve) => {
+            let resolved = false;
+            const resolveOnce = (result) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                resolve(result);
+            };
+            // 1. Monitor result event (stream-json only)
+            this._monitor.resultPromise.then((resultEvent) => {
+                this._updateState('result_received');
+                this._activateZombieGuard();
+                resolveOnce({
+                    reason: 'result',
+                    exitCode: null,
+                    resultEvent,
+                    textOutput: this._monitor.getTextOutput(),
+                    timedOut: false,
+                });
+            });
+            // 2. Child 'close' event
+            child.on('close', (code, signal) => {
+                const textOutput = this._monitor.getTextOutput();
+                resolveOnce({
+                    reason: this._timedOut ? 'timeout' : this._parentDied ? 'parent-death' : 'exit',
+                    exitCode: code,
+                    textOutput,
+                    timedOut: this._timedOut,
+                });
+            });
+            // 3. Spawn error (ENOENT etc.)
+            child.on('error', (err) => {
+                resolveOnce({
+                    reason: 'error',
+                    exitCode: err.code === 'ENOENT' ? 127 : 1,
+                    timedOut: false,
+                });
+            });
+        });
+        // Set up exit promise
+        this.exit = new Promise((resolve) => {
+            child.on('close', (code, signal) => {
+                this._cleanupGuards();
+                this._updateState('exited');
+                this._stateManager.update({ exitCode: code, signal: signal ?? null });
+                this._monitor.destroy();
+                resolve({ exitCode: code, signal: signal ?? null });
+                _registryHook?.unregister(this._opts.id);
+            });
+        });
+        // Auto-register with ProcessRegistry if hook is set
+        _registryHook?.register(this);
+    }
+    /**
+     * Spawn a managed process. Factory method.
+     */
+    static spawn(opts) {
+        const stateDir = opts.stateDir ?? path.join(process.cwd(), '.claude', 'state', 'proc');
+        const stateManager = new ProcessStateManager(stateDir, opts.id);
+        const child = spawn(opts.cmd, opts.args, {
+            shell: process.platform === 'win32',
+            cwd: opts.cwd ?? process.cwd(),
+            env: opts.env ?? buildCleanEnv(),
+            stdio: ['pipe', 'pipe', 'pipe'],
+            windowsHide: true,
+            detached: process.platform !== 'win32',
+        });
+        const monitor = opts.stdout === 'stream-json'
+            ? new StreamJsonMonitor(child.stdout)
+            : new PassthroughMonitor(child.stdout);
+        return new ManagedProcess(child, opts, monitor, stateManager);
+    }
+    /**
+     * Get the process ID string (task identifier).
+     */
+    get id() {
+        return this._opts.id;
+    }
+    /**
+     * Get current state.
+     */
+    get state() {
+        return this._state;
+    }
+    /**
+     * Kill the process tree. Public async API.
+     */
+    async kill() {
+        return this._killTree();
+    }
+    /**
+     * Get health report.
+     */
+    health() {
+        let treeSize = 1;
+        try {
+            const tree = enumerateTree(this.pid);
+            treeSize = tree.length || 1;
+        }
+        catch {
+            // best-effort
+        }
+        return {
+            pid: this.pid,
+            alive: isAlive(this.pid),
+            state: this._state,
+            lastEventTime: this._monitor.getLastEventTime(),
+            eventCount: this._monitor.getEventCount(),
+            uptime: Date.now() - this._startTime,
+            treeSize,
+        };
+    }
+    // ============================================================
+    // Private methods
+    // ============================================================
+    _updateState(state) {
+        this._state = state;
+        this._stateManager.update({ state });
+    }
+    _setupGuards() {
+        this._cleanups = [];
+        // TimeoutGuard
+        const timeoutMs = (this._opts.timeout ?? DEFAULT_TIMEOUT) * 1000;
+        const timeoutTimer = setTimeout(() => this._onTimeout(), timeoutMs);
+        this._cleanups.push(() => clearTimeout(timeoutTimer));
+        // ParentAliveGuard
+        const parentPid = process.ppid;
+        const parentCheckInterval = setInterval(() => {
+            if (!isAlive(parentPid)) {
+                this._onParentDeath();
+            }
+        }, PARENT_ALIVE_CHECK_INTERVAL);
+        this._cleanups.push(() => clearInterval(parentCheckInterval));
+        // SIGINTGuard
+        const onSignal = () => this._onSignal();
+        process.on('SIGINT', onSignal);
+        process.on('SIGTERM', onSignal);
+        process.on('exit', onSignal);
+        this._cleanups.push(() => {
+            process.removeListener('SIGINT', onSignal);
+            process.removeListener('SIGTERM', onSignal);
+            process.removeListener('exit', onSignal);
+        });
+    }
+    _activateZombieGuard() {
+        const gracePeriod = this._opts.gracePeriod ?? DEFAULT_GRACE_PERIOD;
+        const zombieTimer = setTimeout(() => {
+            if (this._child && !this._child.killed) {
+                this._killTree();
+            }
+        }, gracePeriod);
+        this._cleanups.push(() => clearTimeout(zombieTimer));
+    }
+    _cleanupGuards() {
+        for (const cleanup of this._cleanups) {
+            try {
+                cleanup();
+            }
+            catch {
+                // best-effort
+            }
+        }
+        this._cleanups = [];
+    }
+    _killTree() {
+        if (this._killing)
+            return { killed: [], survived: [], errors: [] };
+        this._killing = true;
+        this._updateState('killing');
+        let result = { killed: [], survived: [], errors: [] };
+        if (this._child?.pid && !this._child.killed) {
+            this._takeTreeSnapshot();
+            result = killTree(this._child.pid, { gracePeriodMs: 0 });
+        }
+        return result;
+    }
+    _onSignal() {
+        this._killTree();
+    }
+    _onTimeout() {
+        this._timedOut = true;
+        logger.warn(`Timeout after ${this._opts.timeout}s, killing process tree`);
+        this._killTree();
+    }
+    _onParentDeath() {
+        this._parentDied = true;
+        this._killTree();
+    }
+    _takeTreeSnapshot() {
+        try {
+            const tree = enumerateTree(this.pid);
+            this._stateManager.update({
+                treeSnapshot: tree.map((n) => ({
+                    pid: n.pid,
+                    ppid: n.ppid,
+                    name: n.name,
+                    cmd: n.cmd,
+                    depth: n.depth,
+                })),
+            });
+        }
+        catch {
+            // best-effort
+        }
+    }
+}
+//# sourceMappingURL=managed-process.js.map

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

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

package/dist/utils/merge-claude-settings.d.ts

@@ -0,0 +1,65 @@
+interface ClaudeSettings {
+    mcpServers?: Record<string, McpServerEntry>;
+    [key: string]: unknown;
+}
+interface McpServerEntry {
+    command: string;
+    args: string[];
+    [key: string]: unknown;
+}
+interface McpJson {
+    mcpServers?: Record<string, McpServerEntry>;
+    [key: string]: unknown;
+}
+/**
+ * Read .claude/settings.json from a project root.
+ * Returns an empty object if the file does not exist or is malformed.
+ */
+export declare function readClaudeSettings(projectRoot: string): Promise<ClaudeSettings>;
+/**
+ * Atomically write .claude/settings.json for a project root.
+ * Uses temp file + rename to prevent corruption.
+ */
+export declare function writeClaudeSettings(projectRoot: string, settings: ClaudeSettings): Promise<void>;
+interface SettingsLocal {
+    permissions?: {
+        allow?: string[];
+        deny?: string[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Read .claude/settings.local.json from a project root.
+ * Returns an empty object if the file does not exist or is malformed.
+ */
+export declare function readSettingsLocal(projectRoot: string): Promise<SettingsLocal>;
+/**
+ * Add a permission rule to the allow list in .claude/settings.local.json.
+ * Idempotent — skips if the rule already exists.
+ */
+export declare function addAllowPermission(projectRoot: string, rule: string): Promise<void>;
+/**
+ * Remove a permission rule from the allow list in .claude/settings.local.json.
+ * No-op if the rule does not exist.
+ */
+export declare function removeAllowPermission(projectRoot: string, rule: string): Promise<void>;
+/**
+ * Read .mcp.json from a project root.
+ * Claude Code reads project-level MCP servers from this file (not .claude/settings.json).
+ * Returns an empty object if the file does not exist or is malformed.
+ */
+export declare function readMcpJson(projectRoot: string): Promise<McpJson>;
+/**
+ * Add an MCP server entry to .mcp.json (project root).
+ * Claude Code reads project-level MCP servers from .mcp.json.
+ * Preserves existing entries.
+ */
+export declare function addMcpServer(projectRoot: string, serverName: string, config: McpServerEntry): Promise<void>;
+/**
+ * Remove an MCP server entry from .mcp.json (project root).
+ * No-op if the server does not exist.
+ */
+export declare function removeMcpServer(projectRoot: string, serverName: string): Promise<void>;
+export {};
+//# sourceMappingURL=merge-claude-settings.d.ts.map

package/dist/utils/merge-claude-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-claude-settings.d.ts","sourceRoot":"","sources":["../../src/utils/merge-claude-settings.ts"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,OAAO;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAQrF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAQnF;AAcD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvE;AAYD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAMf"}