@bhimudev/gnanai 0.4.0

package/dist/utils/process-health.js

@@ -0,0 +1,123 @@
+/**
+ * On-demand health assessment for tracked processes.
+ *
+ * Pure classification logic (`classifyHealth`) plus I/O wrappers
+ * (`assessHealth`, `assessAll`) that resolve process data from
+ * in-process registry or cross-process state files.
+ *
+ * @module process-health
+ * @since Task-PROC-004
+ */
+import path from 'path';
+import { ProcessRegistry } from './process-registry.js';
+import { isAlive } from './process-tree.js';
+const DEFAULT_STATE_DIR = path.join(process.cwd(), '.claude', 'state', 'proc');
+/**
+ * Pure classification function — no I/O, no side effects.
+ * Exported for direct unit testing.
+ *
+ * Priority order: dead > zombie > stuck > idle > healthy.
+ */
+export function classifyHealth(data, alive, thresholds) {
+    const now = Date.now();
+    const baseTime = data.lastEventTime ?? data.startTime;
+    const lastEventAge = Math.max(0, now - baseTime);
+    let status;
+    let details;
+    let recommendation;
+    if (!alive || data.state === 'exited') {
+        status = 'dead';
+        details = `Process not alive (pid: ${data.pid}, last state: ${data.state})`;
+        recommendation = 'Process has exited. Clean up state file if no longer needed.';
+    }
+    else if (data.state === 'result_received') {
+        status = 'zombie';
+        details = `Result received but process still alive (state: ${data.state}, pid: ${data.pid})`;
+        recommendation = 'Process should have exited after result. Kill recommended.';
+    }
+    else if (lastEventAge >= thresholds.stuckThresholdMs) {
+        status = 'stuck';
+        details = `No events for ${lastEventAge}ms (threshold: ${thresholds.stuckThresholdMs}ms)`;
+        recommendation = 'Process appears stuck. Consider killing and restarting.';
+    }
+    else if (lastEventAge >= thresholds.idleThresholdMs) {
+        status = 'idle';
+        details = `No events for ${lastEventAge}ms (threshold: ${thresholds.idleThresholdMs}ms)`;
+        recommendation = 'May be waiting for input or processing a large task';
+    }
+    else {
+        status = 'healthy';
+        details = `Process alive, last event ${lastEventAge}ms ago (${data.eventCount} events)`;
+        recommendation = 'No action needed';
+    }
+    return {
+        id: data.id,
+        pid: data.pid,
+        status,
+        state: data.state,
+        lastEventAge,
+        processAlive: alive,
+        details,
+        recommendation,
+    };
+}
+/**
+ * Assess the health of a single tracked process.
+ *
+ * Checks the in-process registry first (freshest data), then falls back
+ * to cross-process state files on disk.
+ *
+ * @returns ProcessHealthReport or null if process not found
+ */
+export function assessHealth(id, opts) {
+    const dir = opts?.stateDir ?? DEFAULT_STATE_DIR;
+    const thresholds = {
+        idleThresholdMs: opts?.idleThresholdMs ?? 60_000,
+        stuckThresholdMs: opts?.stuckThresholdMs ?? 300_000,
+    };
+    // In-process mode: check live registry first
+    const mp = ProcessRegistry.instance.get(id);
+    if (mp) {
+        const h = mp.health();
+        const startTime = Date.now() - h.uptime;
+        return classifyHealth({ id: mp.id, pid: h.pid, state: h.state, lastEventTime: h.lastEventTime, startTime, eventCount: h.eventCount }, h.alive, thresholds);
+    }
+    // Cross-process mode: read from disk
+    const stateData = ProcessRegistry.readOne(id, dir);
+    if (!stateData)
+        return null;
+    const processAlive = isAlive(stateData.pid);
+    return classifyHealth({ id: stateData.id, pid: stateData.pid, state: stateData.state, lastEventTime: stateData.lastEventTime, startTime: stateData.startTime, eventCount: stateData.eventCount }, processAlive, thresholds);
+}
+/**
+ * Assess the health of all tracked processes.
+ *
+ * Combines in-process registry entries with cross-process state files,
+ * deduplicating by ID (in-process wins).
+ */
+export function assessAll(opts) {
+    const dir = opts?.stateDir ?? DEFAULT_STATE_DIR;
+    const thresholds = {
+        idleThresholdMs: opts?.idleThresholdMs ?? 60_000,
+        stuckThresholdMs: opts?.stuckThresholdMs ?? 300_000,
+    };
+    const reports = [];
+    const inProcessIds = new Set();
+    // In-process: live ManagedProcesses
+    for (const mp of ProcessRegistry.instance.getAll()) {
+        inProcessIds.add(mp.id);
+        const h = mp.health();
+        const startTime = Date.now() - h.uptime;
+        reports.push(classifyHealth({ id: mp.id, pid: h.pid, state: h.state, lastEventTime: h.lastEventTime, startTime, eventCount: h.eventCount }, h.alive, thresholds));
+    }
+    // Cross-process: disk state, skip in-process (dedup)
+    const diskStates = ProcessRegistry.readAll(dir);
+    for (const data of diskStates) {
+        if (inProcessIds.has(data.id))
+            continue;
+        const processAlive = isAlive(data.pid);
+        reports.push(classifyHealth({ id: data.id, pid: data.pid, state: data.state, lastEventTime: data.lastEventTime, startTime: data.startTime, eventCount: data.eventCount }, processAlive, thresholds));
+    }
+    return reports;
+}
+//# sourceMappingURL=process-health.js.map

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

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

package/dist/utils/process-registry.d.ts

@@ -0,0 +1,20 @@
+import { ManagedProcess } from './managed-process.js';
+import type { ProcessStateInfo, HealthReport, KillResult } from '../types/index.js';
+export declare class ProcessRegistry {
+    private static _instance;
+    private _map;
+    private constructor();
+    static get instance(): ProcessRegistry;
+    register(mp: ManagedProcess): void;
+    unregister(id: string): void;
+    get(id: string): ManagedProcess | null;
+    getAll(): ManagedProcess[];
+    healthAll(stateDir?: string): HealthReport[];
+    killAll(): Promise<KillResult[]>;
+    reconcile(stateDir?: string): void;
+    static readAll(stateDir: string): ProcessStateInfo[];
+    static readOne(id: string, stateDir: string): ProcessStateInfo | null;
+    static pruneStale(stateDir: string): void;
+    _resetForTesting(): void;
+}
+//# sourceMappingURL=process-registry.d.ts.map

package/dist/utils/process-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-registry.d.ts","sourceRoot":"","sources":["../../src/utils/process-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAwC,MAAM,sBAAsB,CAAC;AAG5F,OAAO,KAAK,EAAoB,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAItG,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAgC;IACxD,OAAO,CAAC,IAAI,CAA0C;IAEtD,OAAO;IAOP,MAAM,KAAK,QAAQ,IAAI,eAAe,CAKrC;IAED,QAAQ,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAOlC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAItC,MAAM,IAAI,cAAc,EAAE;IAI1B,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IA8BtC,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAatC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAuDlC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAIpD,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIrE,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKzC,gBAAgB,IAAI,IAAI;CAKzB"}

package/dist/utils/process-registry.js

@@ -0,0 +1,151 @@
+import path from 'path';
+import fs from 'fs';
+import { ProcessStateManager, setRegistryHook } from './managed-process.js';
+import { isAlive } from './process-tree.js';
+import { logger } from './logger.js';
+const DEFAULT_STATE_DIR = path.join(process.cwd(), '.claude', 'state', 'proc');
+export class ProcessRegistry {
+    static _instance = null;
+    _map = new Map();
+    constructor() {
+        setRegistryHook({
+            register: (mp) => this.register(mp),
+            unregister: (id) => this.unregister(id),
+        });
+    }
+    static get instance() {
+        if (!ProcessRegistry._instance) {
+            ProcessRegistry._instance = new ProcessRegistry();
+        }
+        return ProcessRegistry._instance;
+    }
+    register(mp) {
+        if (this._map.has(mp.id)) {
+            logger.warn(`ProcessRegistry: overwriting existing entry for id '${mp.id}'`);
+        }
+        this._map.set(mp.id, mp);
+    }
+    unregister(id) {
+        this._map.delete(id);
+    }
+    get(id) {
+        return this._map.get(id) ?? null;
+    }
+    getAll() {
+        return [...this._map.values()];
+    }
+    healthAll(stateDir) {
+        const dir = stateDir ?? DEFAULT_STATE_DIR;
+        const reports = [];
+        const inProcessIds = new Set();
+        // In-process: live health from registered ManagedProcesses
+        for (const [id, mp] of this._map) {
+            inProcessIds.add(id);
+            reports.push(mp.health());
+        }
+        // Cross-process: read disk state files, skip in-process
+        // TODO(PROC-perf): batch isAlive checks when N > 10
+        const diskStates = ProcessStateManager.readAll(dir);
+        for (const data of diskStates) {
+            if (inProcessIds.has(data.id))
+                continue; // dedup: in-process wins
+            reports.push({
+                pid: data.pid,
+                alive: isAlive(data.pid),
+                state: data.state,
+                lastEventTime: data.lastEventTime,
+                eventCount: data.eventCount,
+                uptime: Date.now() - data.startTime,
+                treeSize: data.treeSnapshot?.length || 1,
+            });
+        }
+        return reports;
+    }
+    async killAll() {
+        const entries = [...this._map.values()]; // snapshot — mp.kill() triggers unregister
+        const results = [];
+        for (const mp of entries) {
+            try {
+                results.push(await mp.kill());
+            }
+            catch (err) {
+                results.push({ killed: [], survived: [], errors: [String(err)] });
+            }
+        }
+        return results;
+    }
+    reconcile(stateDir) {
+        const dir = stateDir ?? DEFAULT_STATE_DIR;
+        let files;
+        try {
+            files = fs.readdirSync(dir).filter(f => f.endsWith('.json'));
+        }
+        catch {
+            return; // dir doesn't exist — nothing to reconcile
+        }
+        for (const file of files) {
+            const filePath = path.join(dir, file);
+            let data;
+            // Step 1: Parse JSON
+            try {
+                const raw = fs.readFileSync(filePath, 'utf-8');
+                data = JSON.parse(raw);
+            }
+            catch {
+                // Corrupted JSON — delete with warning
+                logger.warn(`ProcessRegistry: deleting corrupted state file: ${file}`);
+                try {
+                    fs.unlinkSync(filePath);
+                }
+                catch { /* best-effort */ }
+                continue;
+            }
+            // Skip in-process entries (live MP is the authority)
+            if (this._map.has(data.id))
+                continue;
+            // Skip already-exited
+            if (data.state === 'exited')
+                continue;
+            // Step 2: Dead check (PID-only)
+            if (!isAlive(data.pid)) {
+                // Update state file to exited (atomic write)
+                data.state = 'exited';
+                data.error = 'detected dead by reconcile';
+                try {
+                    const tmpPath = filePath + '.tmp';
+                    fs.writeFileSync(tmpPath, JSON.stringify(data, null, 2));
+                    fs.renameSync(tmpPath, filePath);
+                }
+                catch { /* best-effort */ }
+                continue;
+            }
+            // Step 3: PID reuse check (PID + name)
+            if (!isAlive(data.pid, data.processName)) {
+                // PID reused by different process — prune
+                try {
+                    fs.unlinkSync(filePath);
+                }
+                catch { /* best-effort */ }
+                continue;
+            }
+            // Step 4: Alive and matches — skip
+        }
+    }
+    // Static state file readers — delegate to ProcessStateManager
+    static readAll(stateDir) {
+        return ProcessStateManager.readAll(stateDir);
+    }
+    static readOne(id, stateDir) {
+        return ProcessStateManager.readOne(id, stateDir);
+    }
+    static pruneStale(stateDir) {
+        ProcessStateManager.pruneStale(stateDir);
+    }
+    // Test isolation
+    _resetForTesting() {
+        this._map.clear();
+        setRegistryHook(null);
+        ProcessRegistry._instance = null;
+    }
+}
+//# sourceMappingURL=process-registry.js.map

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

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

package/dist/utils/process-tree.d.ts

@@ -0,0 +1,51 @@
+export interface ProcessNode {
+    pid: number;
+    ppid: number;
+    name: string;
+    cmd: string;
+}
+export interface KillResult {
+    killed: number[];
+    survived: number[];
+    errors: string[];
+}
+export interface KillOptions {
+    gracePeriodMs?: number;
+}
+/**
+ * Get all processes (platform-dispatched).
+ */
+export declare function getAllProcesses(): ProcessNode[];
+/**
+ * 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 declare function enumerateTree(rootPid: number): (ProcessNode & {
+    depth: number;
+})[];
+/**
+ * Enumerate descendants of rootPid (NOT including root itself).
+ * Returns flat array of ProcessNode[].
+ */
+export declare function enumerateChildren(rootPid: number): ProcessNode[];
+/**
+ * Check if a process is alive. Optionally verify process name matches.
+ */
+export declare function isAlive(pid: number, expectedName?: string): boolean;
+/**
+ * Find processes whose working directory or command line relates to dirPath.
+ * Excludes own PID.
+ */
+export declare function findByCwd(dirPath: string): ProcessNode[];
+/**
+ * Kill a process tree rooted at rootPid. Synchronous.
+ * Returns accounting of killed/survived/errors.
+ */
+export declare function killTree(rootPid: number, opts?: KillOptions): KillResult;
+/**
+ * Kill a single process by PID. Returns true if process is now dead.
+ * Self-PID protected: will not kill own process.
+ */
+export declare function killSingle(pid: number): boolean;
+//# sourceMappingURL=process-tree.d.ts.map

package/dist/utils/process-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-tree.d.ts","sourceRoot":"","sources":["../../src/utils/process-tree.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA6HD;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,EAAE,CAI/C;AAwBD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,GACd,CAAC,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CA2CrC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAKhE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAKnE;AA4CD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAKxD;AA2CD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,GACjB,UAAU,CAKZ;AAqJD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA+B/C"}