process-watchdog 1.0.0 → 1.1.0

package/dist/plugins/plugin-loader.js

@@ -1,3 +1,7 @@
+import { readdirSync } from 'node:fs';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import os from 'node:os';
 import { ProcessGuardPlugin } from './process-guard.js';
 import { MemoryMonitorPlugin } from './memory-monitor.js';
 import { DiskHealthPlugin } from './disk-health.js';
@@ -10,8 +14,9 @@ const pluginRegistry = {
     'startup-optimizer': StartupOptimizerPlugin,
     'cpu-monitor': CpuMonitorPlugin,
 };
-export function loadPlugins(config) {
+export async function loadPlugins(config, customPluginDir) {
     const plugins = [];
+    // Load built-in plugins from the registry
     for (const [name, PluginClass] of Object.entries(pluginRegistry)) {
         const pluginConfig = config.plugins[name];
         if (!pluginConfig || !pluginConfig.enabled)
@@ -20,6 +25,46 @@ export function loadPlugins(config) {
         plugin.configure(pluginConfig);
         plugins.push(plugin);
     }
+    // Load custom plugins from ~/.aidev/watchdog-plugins/ (or override for testing)
+    const resolvedCustomDir = customPluginDir ?? join(os.homedir(), '.aidev', 'watchdog-plugins');
+    if (existsSync(resolvedCustomDir)) {
+        let entries;
+        try {
+            entries = readdirSync(resolvedCustomDir).filter((f) => f.endsWith('.js'));
+        }
+        catch {
+            entries = [];
+        }
+        for (const filename of entries) {
+            const filePath = join(resolvedCustomDir, filename);
+            try {
+                // Dynamic import to support both `export default` and `export { Plugin }`
+                const mod = await import(filePath);
+                const PluginClass = mod.default ?? mod.Plugin;
+                if (typeof PluginClass !== 'function') {
+                    console.warn(`[watchdog] Custom plugin "${filename}" has no default or Plugin export — skipping.`);
+                    continue;
+                }
+                const plugin = new PluginClass();
+                if (typeof plugin.name !== 'string' ||
+                    typeof plugin.check !== 'function' ||
+                    typeof plugin.fix !== 'function' ||
+                    typeof plugin.configure !== 'function') {
+                    console.warn(`[watchdog] Custom plugin "${filename}" does not implement WatchdogPlugin — skipping.`);
+                    continue;
+                }
+                const pluginConfig = config.plugins[plugin.name];
+                if (pluginConfig) {
+                    plugin.configure(pluginConfig);
+                }
+                plugins.push(plugin);
+                console.log(`[watchdog] Loaded custom plugin: ${plugin.name} (${filename})`);
+            }
+            catch (err) {
+                console.error(`[watchdog] Failed to load custom plugin "${filename}": ${err.message}`);
+            }
+        }
+    }
     return plugins;
 }
 //# sourceMappingURL=plugin-loader.js.map

package/dist/plugins/plugin-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-loader.js","sourceRoot":"","sources":["../../src/plugins/plugin-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,cAAc,GAA6C;IAC/D,eAAe,EAAE,kBAAkB;IACnC,gBAAgB,EAAE,mBAAmB;IACrC,aAAa,EAAE,gBAAgB;IAC/B,mBAAmB,EAAE,sBAAsB;IAC3C,aAAa,EAAE,gBAAgB;CAChC,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QACjE,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE,SAAS;QACrD,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"plugin-loader.js","sourceRoot":"","sources":["../../src/plugins/plugin-loader.ts"],"names":[],"mappings":"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"}

package/dist/plugins/process-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-guard.d.ts","sourceRoot":"","sources":["../../src/plugins/process-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAe7F,qBAAa,kBAAmB,YAAW,cAAc;IACvD,IAAI,SAAmB;IACvB,WAAW,SAA+D;IAC1E,eAAe,SAAU;IACzB,OAAO,CAAC,MAAM,CAKZ;IAEF,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI7B,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAwD7B,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;CA8EhC"}
+{"version":3,"file":"process-guard.d.ts","sourceRoot":"","sources":["../../src/plugins/process-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAe7F,qBAAa,kBAAmB,YAAW,cAAc;IACvD,IAAI,SAAmB;IACvB,WAAW,SAA+D;IAC1E,eAAe,SAAU;IACzB,OAAO,CAAC,MAAM,CAKZ;IAEF,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI7B,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAwD7B,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;CA+DhC"}

package/dist/plugins/process-guard.js

@@ -103,21 +103,6 @@ export class ProcessGuardPlugin {
                 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 {

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "process-watchdog",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Modular PC health agent for the aidev.com.au ecosystem",
   "type": "module",
   "bin": {

package/src/api/routes.ts

@@ -1,4 +1,7 @@
 import { Router } from 'express';
+import { writeFile, mkdir } from 'fs/promises';
+import { join } from 'path';
+import os from 'os';
 import { HistoryStore } from '../store/history.js';
 import { WatchdogPlugin, HealthStatus } from '../plugins/plugin.interface.js';
 import { WatchdogConfig } from '../config.js';
@@ -119,5 +122,58 @@ export function createRoutes(
     res.json(config);
   });
 
+  // PUT /config  — deep-merge partial config and persist to ~/.aidev/watchdog.json
+  router.put('/config', async (req, res) => {
+    const body = req.body;
+    if (!body || typeof body !== 'object' || Array.isArray(body)) {
+      res.status(400).json({ error: 'Request body must be a JSON object' });
+      return;
+    }
+
+    try {
+      // Deep-merge the incoming partial config into the live config object
+      function isPlainObject(v: unknown): v is Record<string, unknown> {
+        return typeof v === 'object' && v !== null && !Array.isArray(v);
+      }
+
+      function deepMerge(
+        target: Record<string, unknown>,
+        source: Record<string, unknown>,
+      ): Record<string, unknown> {
+        const result: Record<string, unknown> = { ...target };
+        for (const key of Object.keys(source)) {
+          const src = source[key];
+          const tgt = result[key];
+          if (isPlainObject(src) && isPlainObject(tgt)) {
+            result[key] = deepMerge(tgt, src);
+          } else {
+            result[key] = src;
+          }
+        }
+        return result;
+      }
+
+      const merged = deepMerge(
+        config as unknown as Record<string, unknown>,
+        body as Record<string, unknown>,
+      ) as unknown as WatchdogConfig;
+
+      // Apply the merged values back onto the live config object so GET /config
+      // reflects the change immediately (without restart)
+      Object.assign(config, merged);
+
+      // Persist user overrides to ~/.aidev/watchdog.json
+      const aidevDir = join(os.homedir(), '.aidev');
+      await mkdir(aidevDir, { recursive: true });
+      const userConfigPath = join(aidevDir, 'watchdog.json');
+      await writeFile(userConfigPath, JSON.stringify(body, null, 2), 'utf-8');
+
+      res.json(config);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      res.status(500).json({ error: message });
+    }
+  });
+
   return router;
 }

package/src/index.ts

@@ -23,7 +23,7 @@ program
   .description('Load config, start scheduler, and watch continuously')
   .action(async () => {
     const config = await loadConfig();
-    const plugins = loadPlugins(config);
+    const plugins = await loadPlugins(config);
 
     const home = process.env.HOME || process.env.USERPROFILE || '.';
     const aidevDir = join(home, '.aidev');
@@ -58,7 +58,7 @@ program
   .description('Run check() on each plugin and print a summary line')
   .action(async () => {
     const config = await loadConfig();
-    const plugins = loadPlugins(config);
+    const plugins = await loadPlugins(config);
 
     for (const plugin of plugins) {
       try {
@@ -84,7 +84,7 @@ program
   .description('Run check() for all or a specific plugin and print detailed metrics')
   .action(async (pluginArg?: string) => {
     const config = await loadConfig();
-    const plugins = loadPlugins(config);
+    const plugins = await loadPlugins(config);
 
     const targets = pluginArg
       ? plugins.filter((p) => p.name === pluginArg)
@@ -125,7 +125,7 @@ program
   .description('Run fix() for all or a specific plugin and print actions and resources freed')
   .action(async (pluginArg?: string) => {
     const config = await loadConfig();
-    const plugins = loadPlugins(config);
+    const plugins = await loadPlugins(config);
 
     const targets = pluginArg
       ? plugins.filter((p) => p.name === pluginArg)
@@ -171,7 +171,7 @@ apiCmd
   .description('Start the HTTP API server')
   .action(async () => {
     const config = await loadConfig();
-    const plugins = loadPlugins(config);
+    const plugins = await loadPlugins(config);
 
     const home = process.env.HOME || process.env.USERPROFILE || '.';
     const aidevDir = join(home, '.aidev');

package/src/platform/index.ts

@@ -1,12 +1,18 @@
 import { PlatformAdapter } from './platform.interface.js';
 import { WindowsPlatform } from './windows.js';
+import { MacOSPlatform } from './macos.js';
+import { LinuxPlatform } from './linux.js';
 
 export function getPlatform(): PlatformAdapter {
   switch (process.platform) {
     case 'win32':
       return new WindowsPlatform();
+    case 'darwin':
+      return new MacOSPlatform();
+    case 'linux':
+      return new LinuxPlatform();
     default:
-      throw new Error(`Unsupported platform: ${process.platform}. Windows support only in v1.`);
+      throw new Error(`Unsupported platform: ${process.platform}`);
   }
 }
 

package/src/platform/linux.ts

@@ -0,0 +1,255 @@
+import { execFileSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import type {
+  PlatformAdapter,
+  ProcessInfo,
+  MemoryInfo,
+  DiskInfo,
+  CpuSample,
+  StartupItem,
+} from './platform.interface.js';
+
+function run(cmd: string, args: string[], timeoutMs = 60000): string {
+  return execFileSync(cmd, args, { encoding: 'utf-8', timeout: timeoutMs }).trim();
+}
+
+/** Read /proc/stat and return raw CPU counters for all CPUs combined (first line). */
+function readProcStatCpu(): {
+  user: number;
+  nice: number;
+  system: number;
+  idle: number;
+  iowait: number;
+  irq: number;
+  softirq: number;
+  total: number;
+} {
+  const stat = fs.readFileSync('/proc/stat', 'utf-8');
+  const cpuLine = stat.split('\n').find((l) => l.startsWith('cpu '));
+  if (!cpuLine) throw new Error('Cannot parse /proc/stat');
+  // cpu  user nice system idle iowait irq softirq steal guest guest_nice
+  const parts = cpuLine.trim().split(/\s+/).slice(1).map(Number);
+  const [user = 0, nice = 0, system = 0, idle = 0, iowait = 0, irq = 0, softirq = 0] = parts;
+  const total = parts.reduce((a, b) => a + b, 0);
+  return { user, nice, system, idle, iowait, irq, softirq, total };
+}
+
+export class LinuxPlatform implements PlatformAdapter {
+  async getProcesses(): Promise<ProcessInfo[]> {
+    // ps aux columns: USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND
+    const raw = run('ps', ['aux']);
+    const lines = raw.split('\n').slice(1); // skip header
+    const result: ProcessInfo[] = [];
+    for (const line of lines) {
+      if (!line.trim()) continue;
+      const parts = line.trim().split(/\s+/);
+      if (parts.length < 11) continue;
+      const pid = parseInt(parts[1], 10);
+      const cpuPct = parseFloat(parts[2]) || 0;
+      const rssKB = parseInt(parts[5], 10) || 0;
+      const name = parts.slice(10).join(' ');
+      if (isNaN(pid)) continue;
+      result.push({
+        pid,
+        name,
+        memoryMB: Math.round(rssKB / 1024),
+        cpu: cpuPct,
+        responding: true,
+      });
+    }
+    return result;
+  }
+
+  async getProcessesByName(name: string): Promise<ProcessInfo[]> {
+    // pgrep -a <name>  =>  "<pid> <full command>"
+    let pgrepOutput = '';
+    try {
+      pgrepOutput = run('pgrep', ['-a', name]);
+    } catch {
+      // pgrep exits non-zero when no matches
+      return [];
+    }
+
+    const pids: number[] = [];
+    for (const line of pgrepOutput.split('\n')) {
+      if (!line.trim()) continue;
+      const pid = parseInt(line.trim().split(/\s+/)[0], 10);
+      if (!isNaN(pid)) pids.push(pid);
+    }
+    if (pids.length === 0) return [];
+
+    const allProcs = await this.getProcesses();
+    return allProcs.filter((p) => pids.includes(p.pid));
+  }
+
+  async getListeningPids(): Promise<number[]> {
+    // ss -tlnp  — shows TCP listening sockets with process info
+    // State  Recv-Q  Send-Q  Local Address:Port  Peer Address:Port  Process
+    // LISTEN 0       128     0.0.0.0:22          0.0.0.0:*          users:(("sshd",pid=1234,fd=3))
+    let raw = '';
+    try {
+      raw = run('ss', ['-tlnp']);
+    } catch {
+      return [];
+    }
+    const pids = new Set<number>();
+    for (const line of raw.split('\n').slice(1)) {
+      // Extract pid=NNNN from users:((...,pid=NNNN,...))
+      const matches = line.matchAll(/pid=(\d+)/g);
+      for (const m of matches) {
+        const pid = parseInt(m[1], 10);
+        if (!isNaN(pid)) pids.add(pid);
+      }
+    }
+    return Array.from(pids);
+  }
+
+  async killProcess(pid: number): Promise<boolean> {
+    try {
+      run('kill', ['-9', String(pid)]);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  async getMemoryInfo(): Promise<MemoryInfo> {
+    // /proc/meminfo keys are in kB
+    const raw = fs.readFileSync('/proc/meminfo', 'utf-8');
+    const getValue = (key: string): number => {
+      const match = raw.match(new RegExp(`^${key}:\\s+(\\d+)`, 'm'));
+      return match ? parseInt(match[1], 10) : 0;
+    };
+
+    const totalKB = getValue('MemTotal');
+    const freeKB = getValue('MemFree');
+    const buffersKB = getValue('Buffers');
+    const cachedKB = getValue('Cached'); // includes "Cached" but not "SwapCached"
+    const sreclaimKB = getValue('SReclaimable');
+    const swapTotalKB = getValue('SwapTotal');
+    const swapFreeKB = getValue('SwapFree');
+
+    const totalMB = Math.round(totalKB / 1024);
+    // Available memory = free + buffers + cached (page cache) + slab reclaimable
+    const availableKB = freeKB + buffersKB + cachedKB + sreclaimKB;
+    const freeMB = Math.round(availableKB / 1024);
+    const usedMB = totalMB - freeMB;
+    const usedPct = totalMB > 0 ? Math.round((usedMB / totalMB) * 100) : 0;
+    const pageFileUsageMB = Math.round((swapTotalKB - swapFreeKB) / 1024);
+
+    return { totalMB, freeMB, usedPct, pageFileUsageMB };
+  }
+
+  async getDiskInfo(): Promise<DiskInfo[]> {
+    // df --block-size=G produces sizes in gigabytes (with trailing G suffix)
+    let raw = '';
+    try {
+      raw = run('df', ['--block-size=G']);
+    } catch {
+      return [];
+    }
+    const result: DiskInfo[] = [];
+    for (const line of raw.split('\n').slice(1)) {
+      if (!line.trim()) continue;
+      const parts = line.trim().split(/\s+/);
+      if (parts.length < 6) continue;
+      // Strip the trailing "G" added by --block-size=G
+      const totalGB = parseInt(parts[1].replace('G', ''), 10);
+      const usedGB = parseInt(parts[2].replace('G', ''), 10);
+      const freeGB = parseInt(parts[3].replace('G', ''), 10);
+      const drive = parts[0];
+      if (isNaN(totalGB) || totalGB <= 0) continue;
+      const usedPct = Math.round((usedGB / totalGB) * 100);
+      result.push({ drive, totalGB, freeGB, usedPct });
+    }
+    return result;
+  }
+
+  async getCpuUsage(samples: number, intervalMs: number): Promise<CpuSample[]> {
+    const result: CpuSample[] = [];
+    const count = Math.max(1, samples);
+
+    let prev = readProcStatCpu();
+
+    for (let i = 0; i < count; i++) {
+      await new Promise<void>((resolve) => setTimeout(resolve, intervalMs));
+
+      try {
+        const curr = readProcStatCpu();
+        const totalDelta = curr.total - prev.total;
+        const idleDelta = curr.idle - prev.idle + (curr.iowait - prev.iowait);
+        const usedPct =
+          totalDelta > 0 ? Math.round(((totalDelta - idleDelta) / totalDelta) * 100) : 0;
+        result.push({ usedPct, timestamp: new Date() });
+        prev = curr;
+      } catch {
+        result.push({ usedPct: 0, timestamp: new Date() });
+      }
+    }
+    return result;
+  }
+
+  async getStartupItems(): Promise<StartupItem[]> {
+    const autostartDir = path.join(os.homedir(), '.config', 'autostart');
+    const items: StartupItem[] = [];
+
+    let files: string[] = [];
+    try {
+      files = fs.readdirSync(autostartDir).filter((f) => f.endsWith('.desktop'));
+    } catch {
+      return items;
+    }
+
+    for (const file of files) {
+      const fullPath = path.join(autostartDir, file);
+      let name = path.basename(file, '.desktop');
+      let command = '';
+      let enabled = true;
+
+      try {
+        const content = fs.readFileSync(fullPath, 'utf-8');
+        for (const line of content.split('\n')) {
+          const trimmed = line.trim();
+          if (trimmed.startsWith('Name=')) {
+            name = trimmed.slice('Name='.length);
+          } else if (trimmed.startsWith('Exec=')) {
+            command = trimmed.slice('Exec='.length);
+          } else if (trimmed.toLowerCase() === 'x-gnome-autostart-enabled=false') {
+            enabled = false;
+          } else if (trimmed.startsWith('Hidden=') && trimmed.split('=')[1]?.toLowerCase() === 'true') {
+            enabled = false;
+          }
+        }
+      } catch {
+        // Failed to read .desktop file — use filename-based defaults
+      }
+
+      items.push({ name, command, location: fullPath, enabled });
+    }
+    return items;
+  }
+
+  async disableStartupItem(name: string): Promise<boolean> {
+    const autostartDir = path.join(os.homedir(), '.config', 'autostart');
+    // Accept both the entry name and the filename (with or without .desktop)
+    const desktopName = name.endsWith('.desktop') ? name : `${name}.desktop`;
+    const desktopPath = path.join(autostartDir, desktopName);
+
+    try {
+      fs.unlinkSync(desktopPath);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  getTempDirs(): string[] {
+    return [
+      '/tmp',
+      path.join(os.homedir(), '.cache'),
+      path.join(os.homedir(), '.npm', '_cacache'),
+    ];
+  }
+}