process-watchdog 1.0.0

package/dist/plugins/process-guard.js

@@ -0,0 +1,139 @@
+import { getPlatform } from '../platform/index.js';
+const TARGET_NAMES = ['node', 'cmd', 'bash'];
+/** Safely get processes by name — returns [] if none found or platform throws */
+async function safeGetProcessesByName(platform, name) {
+    try {
+        return await platform.getProcessesByName(name);
+    }
+    catch {
+        return [];
+    }
+}
+export class ProcessGuardPlugin {
+    name = 'process-guard';
+    description = 'Detect and kill orphaned processes before they accumulate';
+    defaultInterval = 300000;
+    config = {
+        enabled: true,
+        interval: 300000,
+        autoFix: true,
+        thresholds: { node: 50, cmd: 20, bash: 10 },
+    };
+    configure(opts) {
+        this.config = { ...this.config, ...opts };
+    }
+    async check() {
+        const platform = getPlatform();
+        const listeningPids = new Set(await platform.getListeningPids());
+        const counts = {};
+        const orphanCounts = {};
+        const warnings = [];
+        const suggestedActions = [];
+        for (const name of TARGET_NAMES) {
+            const procs = await safeGetProcessesByName(platform, name);
+            const total = procs.length;
+            const orphans = procs.filter((p) => !listeningPids.has(p.pid)).length;
+            counts[`${name}Count`] = total;
+            orphanCounts[`${name}Orphans`] = orphans;
+            const threshold = this.config.thresholds[name] ?? Infinity;
+            if (total > threshold) {
+                warnings.push(`${name}: ${total} processes exceeds threshold of ${threshold}`);
+                if (orphans > 0) {
+                    suggestedActions.push(`Kill ${orphans} orphaned ${name} processes`);
+                }
+            }
+        }
+        const totalOrphans = (orphanCounts['nodeOrphans'] ?? 0) +
+            (orphanCounts['cmdOrphans'] ?? 0) +
+            (orphanCounts['bashOrphans'] ?? 0);
+        const metrics = {
+            nodeCount: counts['nodeCount'] ?? 0,
+            cmdCount: counts['cmdCount'] ?? 0,
+            bashCount: counts['bashCount'] ?? 0,
+            nodeOrphans: orphanCounts['nodeOrphans'] ?? 0,
+            cmdOrphans: orphanCounts['cmdOrphans'] ?? 0,
+            bashOrphans: orphanCounts['bashOrphans'] ?? 0,
+            totalOrphans,
+        };
+        let status;
+        if (totalOrphans > 100) {
+            status = 'critical';
+        }
+        else if (totalOrphans > 0 && warnings.length > 0) {
+            status = 'warning';
+        }
+        else {
+            status = 'healthy';
+        }
+        const message = warnings.length > 0 ? warnings.join('; ') : 'All process counts within thresholds';
+        return { status, metrics, message, suggestedActions };
+    }
+    async fix() {
+        const platform = getPlatform();
+        const listeningPids = new Set(await platform.getListeningPids());
+        // Capture before metrics
+        const beforeMetrics = {};
+        for (const name of TARGET_NAMES) {
+            const procs = await safeGetProcessesByName(platform, name);
+            beforeMetrics[`${name}Count`] = procs.length;
+            beforeMetrics[`${name}Orphans`] = procs.filter((p) => !listeningPids.has(p.pid)).length;
+        }
+        const actionsKept = [];
+        let totalMemoryFreedMB = 0;
+        // Protect only: this process, its parent, and processes listening on ports (dev servers)
+        const selfPid = process.pid;
+        const parentPid = process.ppid;
+        const protectedPids = new Set([selfPid, parentPid, ...listeningPids].filter((p) => typeof p === 'number'));
+        // Kill orphans only when process count exceeds threshold
+        for (const name of TARGET_NAMES) {
+            const procs = await safeGetProcessesByName(platform, name);
+            const threshold = this.config.thresholds[name] ?? Infinity;
+            if (procs.length <= threshold)
+                continue; // Within limits — skip
+            const orphans = procs.filter((p) => !listeningPids.has(p.pid) && !protectedPids.has(p.pid));
+            let killed = 0;
+            for (const proc of orphans) {
+                const success = await platform.killProcess(proc.pid);
+                if (success) {
+                    killed++;
+                    totalMemoryFreedMB += proc.memoryMB ?? 0;
+                }
+            }
+            if (orphans.length > 0) {
+                actionsKept.push(`Killed ${killed}/${orphans.length} orphaned ${name} processes`);
+            }
+        }
+        // Best-effort: clean up low-CPU conhost processes (skip any that were running at snapshot time)
+        try {
+            const conhosts = await safeGetProcessesByName(platform, 'conhost');
+            for (const proc of conhosts) {
+                if (proc.cpu < 0.1 && !protectedPids.has(proc.pid)) {
+                    const success = await platform.killProcess(proc.pid);
+                    if (success) {
+                        totalMemoryFreedMB += proc.memoryMB ?? 0;
+                    }
+                }
+            }
+        }
+        catch {
+            // best-effort, ignore errors
+        }
+        // Capture after metrics (best-effort — system may be in transition after kills)
+        let afterListeningPids;
+        try {
+            afterListeningPids = new Set(await platform.getListeningPids());
+        }
+        catch {
+            afterListeningPids = new Set();
+        }
+        const afterMetrics = {};
+        for (const name of TARGET_NAMES) {
+            const procs = await safeGetProcessesByName(platform, name);
+            afterMetrics[`${name}Count`] = procs.length;
+            afterMetrics[`${name}Orphans`] = procs.filter((p) => !afterListeningPids.has(p.pid)).length;
+        }
+        const resourcesFreed = `Freed ~${Math.round(totalMemoryFreedMB)} MB RAM`;
+        return { actionsKept, resourcesFreed, beforeMetrics, afterMetrics };
+    }
+}
+//# sourceMappingURL=process-guard.js.map

package/dist/plugins/process-guard.js.map

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

package/dist/plugins/startup-optimizer.d.ts

@@ -0,0 +1,11 @@
+import { WatchdogPlugin, HealthCheck, FixResult, PluginConfig } from './plugin.interface.js';
+export declare class StartupOptimizerPlugin implements WatchdogPlugin {
+    name: string;
+    description: string;
+    defaultInterval: number;
+    private config;
+    configure(opts: PluginConfig): void;
+    check(): Promise<HealthCheck>;
+    fix(): Promise<FixResult>;
+}
+//# sourceMappingURL=startup-optimizer.d.ts.map

package/dist/plugins/startup-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-optimizer.d.ts","sourceRoot":"","sources":["../../src/plugins/startup-optimizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAa7F,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,IAAI,SAAuB;IAC3B,WAAW,SAAwD;IACnE,eAAe,SAAK;IACpB,OAAO,CAAC,MAAM,CAKZ;IAEF,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI7B,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IA8B7B,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;CA4ChC"}

package/dist/plugins/startup-optimizer.js

@@ -0,0 +1,78 @@
+import { getPlatform } from '../platform/index.js';
+const KNOWN_BLOAT = [
+    'Docker Desktop',
+    'GoogleDriveFS',
+    'Figma Agent',
+    'CiscoSpark',
+    'CiscoMeetingDaemon',
+    'EasySettingBox',
+    'com.todesktop',
+];
+export class StartupOptimizerPlugin {
+    name = 'startup-optimizer';
+    description = 'Manage startup items to reduce boot resource usage';
+    defaultInterval = 0;
+    config = {
+        enabled: true,
+        interval: 0,
+        autoFix: false,
+        thresholds: {},
+    };
+    configure(opts) {
+        this.config = { ...this.config, ...opts };
+    }
+    async check() {
+        const platform = getPlatform();
+        const items = await platform.getStartupItems();
+        const enabledItems = items.filter((item) => item.enabled);
+        const startupItemCount = enabledItems.length;
+        const bloatItems = enabledItems.filter((item) => KNOWN_BLOAT.some((bloat) => item.name.includes(bloat)));
+        const bloatItemCount = bloatItems.length;
+        const suggestedActions = [];
+        if (bloatItemCount > 0) {
+            suggestedActions.push(`Disable ${bloatItemCount} bloat startup item(s): ${bloatItems.map((b) => b.name).join(', ')}`);
+        }
+        const status = bloatItemCount > 3 ? 'warning' : 'healthy';
+        const message = `${startupItemCount} startup items enabled, ${bloatItemCount} identified as bloat`;
+        return {
+            status,
+            metrics: { startupItemCount, bloatItemCount },
+            message,
+            suggestedActions,
+        };
+    }
+    async fix() {
+        const platform = getPlatform();
+        const itemsBefore = await platform.getStartupItems();
+        const enabledBefore = itemsBefore.filter((item) => item.enabled);
+        const bloatBefore = enabledBefore.filter((item) => KNOWN_BLOAT.some((bloat) => item.name.includes(bloat)));
+        const beforeMetrics = {
+            startupItemCount: enabledBefore.length,
+            bloatItemCount: bloatBefore.length,
+        };
+        const actionsKept = [];
+        let disabledCount = 0;
+        for (const item of bloatBefore) {
+            try {
+                const success = await platform.disableStartupItem(item.name);
+                if (success) {
+                    disabledCount++;
+                    actionsKept.push(`Disabled startup item: ${item.name}`);
+                }
+            }
+            catch {
+                // skip items that fail to disable
+            }
+        }
+        const itemsAfter = await platform.getStartupItems();
+        const enabledAfter = itemsAfter.filter((item) => item.enabled);
+        const bloatAfter = enabledAfter.filter((item) => KNOWN_BLOAT.some((bloat) => item.name.includes(bloat)));
+        const afterMetrics = {
+            startupItemCount: enabledAfter.length,
+            bloatItemCount: bloatAfter.length,
+        };
+        const resourcesFreed = `Disabled ${disabledCount} startup item(s)`;
+        return { actionsKept, resourcesFreed, beforeMetrics, afterMetrics };
+    }
+}
+//# sourceMappingURL=startup-optimizer.js.map

package/dist/plugins/startup-optimizer.js.map

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

package/dist/scheduler.d.ts

@@ -0,0 +1,16 @@
+import { WatchdogPlugin } from './plugins/plugin.interface.js';
+interface SchedulerOptions {
+    autoFix: Record<string, boolean>;
+}
+export declare class Scheduler {
+    private plugins;
+    private options;
+    private timers;
+    private running;
+    constructor(plugins: WatchdogPlugin[], options: SchedulerOptions);
+    start(overrideIntervalMs?: number): void;
+    stop(): void;
+    isRunning(): boolean;
+}
+export {};
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,gBAAgB;IAKhE,KAAK,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI;IA4BxC,IAAI,IAAI,IAAI;IAMZ,SAAS,IAAI,OAAO;CACrB"}

package/dist/scheduler.js

@@ -0,0 +1,46 @@
+export class Scheduler {
+    plugins;
+    options;
+    timers = [];
+    running = false;
+    constructor(plugins, options) {
+        this.plugins = plugins;
+        this.options = options;
+    }
+    start(overrideIntervalMs) {
+        if (this.running)
+            return;
+        this.running = true;
+        for (const plugin of this.plugins) {
+            const interval = overrideIntervalMs ?? plugin.defaultInterval;
+            if (interval <= 0)
+                continue;
+            const run = async () => {
+                if (!this.running)
+                    return;
+                try {
+                    const result = await plugin.check();
+                    const shouldFix = this.options.autoFix[plugin.name] &&
+                        (result.status === 'critical' || result.status === 'warning');
+                    if (shouldFix) {
+                        await plugin.fix();
+                    }
+                }
+                catch (err) {
+                    console.error(`[watchdog] ${plugin.name} error:`, err);
+                }
+            };
+            run(); // Run immediately
+            const timer = setInterval(run, interval);
+            this.timers.push(timer);
+        }
+    }
+    stop() {
+        this.running = false;
+        for (const timer of this.timers)
+            clearInterval(timer);
+        this.timers = [];
+    }
+    isRunning() { return this.running; }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,SAAS;IACZ,OAAO,CAAmB;IAC1B,OAAO,CAAmB;IAC1B,MAAM,GAAqB,EAAE,CAAC;IAC9B,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,OAAyB,EAAE,OAAyB;QAC9D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,kBAA2B;QAC/B,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,kBAAkB,IAAI,MAAM,CAAC,eAAe,CAAC;YAC9D,IAAI,QAAQ,IAAI,CAAC;gBAAE,SAAS;YAE5B,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;gBACrB,IAAI,CAAC,IAAI,CAAC,OAAO;oBAAE,OAAO;gBAC1B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;oBACpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;wBACjD,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;oBAChE,IAAI,SAAS,EAAE,CAAC;wBACd,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;oBACrB,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,cAAc,MAAM,CAAC,IAAI,SAAS,EAAE,GAAG,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC,CAAC;YAEF,GAAG,EAAE,CAAC,CAAC,kBAAkB;YACzB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,aAAa,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,SAAS,KAAc,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;CAC9C"}

package/dist/store/history.d.ts

@@ -0,0 +1,20 @@
+export interface HistoryRow {
+    id: number;
+    plugin: string;
+    type: string;
+    status: string;
+    metrics: string | null;
+    actions: string | null;
+    message: string | null;
+    timestamp: string;
+}
+export declare class HistoryStore {
+    private db;
+    constructor(dbPath?: string);
+    recordCheck(plugin: string, status: string, metrics: Record<string, unknown>, message: string): void;
+    recordFix(plugin: string, actions: string[], resourcesFreed: string): void;
+    getHistory(plugin: string | null, limit: number): HistoryRow[];
+    getLastChecks(): Record<string, HistoryRow>;
+    close(): void;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/store/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/store/history.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,GAAE,MAAwB;IAiB5C,WAAW,CACT,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,GACd,IAAI;IAQP,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAQ1E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE;IAa9D,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAmB3C,KAAK,IAAI,IAAI;CAGd"}

package/dist/store/history.js

@@ -0,0 +1,60 @@
+import Database from 'better-sqlite3';
+export class HistoryStore {
+    db;
+    constructor(dbPath = './watchdog.db') {
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS history (
+        id        INTEGER PRIMARY KEY AUTOINCREMENT,
+        plugin    TEXT    NOT NULL,
+        type      TEXT    NOT NULL,
+        status    TEXT    NOT NULL,
+        metrics   TEXT,
+        actions   TEXT,
+        message   TEXT,
+        timestamp TEXT    NOT NULL DEFAULT (datetime('now'))
+      )
+    `);
+    }
+    recordCheck(plugin, status, metrics, message) {
+        const stmt = this.db.prepare(`INSERT INTO history (plugin, type, status, metrics, message)
+       VALUES (?, 'check', ?, ?, ?)`);
+        stmt.run(plugin, status, JSON.stringify(metrics), message);
+    }
+    recordFix(plugin, actions, resourcesFreed) {
+        const stmt = this.db.prepare(`INSERT INTO history (plugin, type, status, actions, message)
+       VALUES (?, 'fix', 'fixed', ?, ?)`);
+        stmt.run(plugin, JSON.stringify(actions), resourcesFreed);
+    }
+    getHistory(plugin, limit) {
+        if (plugin !== null) {
+            const stmt = this.db.prepare(`SELECT * FROM history WHERE plugin = ? ORDER BY id DESC LIMIT ?`);
+            return stmt.all(plugin, limit);
+        }
+        const stmt = this.db.prepare(`SELECT * FROM history ORDER BY id DESC LIMIT ?`);
+        return stmt.all(limit);
+    }
+    getLastChecks() {
+        const stmt = this.db.prepare(`
+      SELECT h.*
+      FROM history h
+      INNER JOIN (
+        SELECT plugin, MAX(id) AS max_id
+        FROM history
+        WHERE type = 'check'
+        GROUP BY plugin
+      ) latest ON h.id = latest.max_id
+    `);
+        const rows = stmt.all();
+        const result = {};
+        for (const row of rows) {
+            result[row.plugin] = row;
+        }
+        return result;
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/store/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/store/history.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAatC,MAAM,OAAO,YAAY;IACf,EAAE,CAAoB;IAE9B,YAAY,SAAiB,eAAe;QAC1C,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;KAWZ,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CACT,MAAc,EACd,MAAc,EACd,OAAgC,EAChC,OAAe;QAEf,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B;oCAC8B,CAC/B,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,SAAS,CAAC,MAAc,EAAE,OAAiB,EAAE,cAAsB;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B;wCACkC,CACnC,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC;IAC5D,CAAC;IAED,UAAU,CAAC,MAAqB,EAAE,KAAa;QAC7C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,iEAAiE,CAClE,CAAC;YACF,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAiB,CAAC;QACjD,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,gDAAgD,CACjD,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAiB,CAAC;IACzC,CAAC;IAED,aAAa;QACX,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;KAS5B,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAkB,CAAC;QACxC,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "process-watchdog",
+  "version": "1.0.0",
+  "description": "Modular PC health agent for the aidev.com.au ecosystem",
+  "type": "module",
+  "bin": {
+    "watchdog": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "better-sqlite3": "^12.8.0",
+    "commander": "^14.0.3",
+    "express": "^5.2.1",
+    "node-windows": "^1.0.0-beta.8"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.6.0",
+    "@types/node-windows": "^0.1.6",
+    "@types/supertest": "^7.2.0",
+    "supertest": "^7.2.2",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4"
+  }
+}

package/src/api/routes.ts

@@ -0,0 +1,123 @@
+import { Router } from 'express';
+import { HistoryStore } from '../store/history.js';
+import { WatchdogPlugin, HealthStatus } from '../plugins/plugin.interface.js';
+import { WatchdogConfig } from '../config.js';
+
+const STATUS_ORDER: HealthStatus[] = ['healthy', 'warning', 'critical'];
+
+function worstStatus(statuses: HealthStatus[]): HealthStatus {
+  let worst: HealthStatus = 'healthy';
+  for (const s of statuses) {
+    if (STATUS_ORDER.indexOf(s) > STATUS_ORDER.indexOf(worst)) {
+      worst = s;
+    }
+  }
+  return worst;
+}
+
+export function createRoutes(
+  store: HistoryStore,
+  plugins: WatchdogPlugin[],
+  config: WatchdogConfig,
+): Router {
+  const router = Router();
+
+  // GET /health
+  router.get('/health', (_req, res) => {
+    const lastChecks = store.getLastChecks();
+    const pluginStatuses: Record<string, { status: string; lastRun: string | null }> = {};
+    const statuses: HealthStatus[] = [];
+
+    for (const plugin of plugins) {
+      const last = lastChecks[plugin.name];
+      pluginStatuses[plugin.name] = {
+        status: last ? last.status : 'healthy',
+        lastRun: last ? last.timestamp : null,
+      };
+      if (last) {
+        statuses.push(last.status as HealthStatus);
+      }
+    }
+
+    res.json({
+      service: 'process-watchdog',
+      version: '1.0.0',
+      status: worstStatus(statuses),
+      uptime: Math.floor(process.uptime()),
+      plugins: pluginStatuses,
+    });
+  });
+
+  // GET /plugins
+  router.get('/plugins', (_req, res) => {
+    const lastChecks = store.getLastChecks();
+    const result = plugins.map((plugin) => {
+      const last = lastChecks[plugin.name];
+      const pluginConfig = config.plugins[plugin.name];
+      return {
+        name: plugin.name,
+        description: plugin.description,
+        interval: pluginConfig ? pluginConfig.interval : plugin.defaultInterval,
+        lastCheck: last ? last.timestamp : null,
+      };
+    });
+    res.json(result);
+  });
+
+  // GET /plugins/:name
+  router.get('/plugins/:name', (req, res) => {
+    const plugin = plugins.find((p) => p.name === req.params.name);
+    if (!plugin) {
+      res.status(404).json({ error: `Plugin '${req.params.name}' not found` });
+      return;
+    }
+    const history = store.getHistory(plugin.name, 50);
+    res.json({
+      name: plugin.name,
+      description: plugin.description,
+      history,
+    });
+  });
+
+  // POST /plugins/:name/run
+  router.post('/plugins/:name/run', async (req, res) => {
+    const plugin = plugins.find((p) => p.name === req.params.name);
+    if (!plugin) {
+      res.status(404).json({ error: `Plugin '${req.params.name}' not found` });
+      return;
+    }
+
+    const action: 'check' | 'fix' = req.body?.action === 'fix' ? 'fix' : 'check';
+
+    try {
+      if (action === 'fix') {
+        const result = await plugin.fix();
+        store.recordFix(plugin.name, result.actionsKept, result.resourcesFreed);
+        res.json({ action, result });
+      } else {
+        const result = await plugin.check();
+        store.recordCheck(plugin.name, result.status, result.metrics, result.message);
+        res.json({ action, result });
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      res.status(500).json({ error: message });
+    }
+  });
+
+  // GET /history
+  router.get('/history', (req, res) => {
+    const pluginFilter = typeof req.query.plugin === 'string' ? req.query.plugin : null;
+    const limitRaw = parseInt(String(req.query.limit ?? '50'), 10);
+    const limit = isNaN(limitRaw) || limitRaw <= 0 ? 50 : limitRaw;
+    const history = store.getHistory(pluginFilter, limit);
+    res.json(history);
+  });
+
+  // GET /config
+  router.get('/config', (_req, res) => {
+    res.json(config);
+  });
+
+  return router;
+}

package/src/api/server.ts

@@ -0,0 +1,20 @@
+import express from 'express';
+import { HistoryStore } from '../store/history.js';
+import { WatchdogPlugin } from '../plugins/plugin.interface.js';
+import { WatchdogConfig } from '../config.js';
+import { createRoutes } from './routes.js';
+
+export function createApp(store: HistoryStore, plugins: WatchdogPlugin[], config: WatchdogConfig): express.Express {
+  const app = express();
+  app.use(express.json());
+  app.use('/api/v1', createRoutes(store, plugins, config));
+  return app;
+}
+
+export function startServer(store: HistoryStore, plugins: WatchdogPlugin[], config: WatchdogConfig) {
+  const app = createApp(store, plugins, config);
+  const server = app.listen(config.port, () => {
+    console.log(`[watchdog] API server running on port ${config.port}`);
+  });
+  return { app, close: () => server.close() };
+}