process-watchdog 1.0.0 → 1.2.0

package/BUILDING.md

@@ -0,0 +1,64 @@
+# Building Standalone Installers
+
+Process Watchdog can be packaged into self-contained executables that do not require Node.js to be installed on the target machine. The build pipeline uses **esbuild** to bundle the TypeScript output into a single CommonJS file, then **@yao-pkg/pkg** to wrap it with a Node.js runtime.
+
+## Prerequisites
+
+All dependencies are already in `devDependencies` — run `npm install` once before building.
+
+## Build commands
+
+| Command | Output |
+|---|---|
+| `npm run build:standalone:win` | `standalone/watchdog-win.exe` (Windows x64) |
+| `npm run build:standalone:mac` | `standalone/watchdog-macos` (macOS x64) |
+| `npm run build:standalone:linux` | `standalone/watchdog-linux` (Linux x64) |
+| `npm run build:standalone` | All three targets |
+
+Each command runs three steps automatically:
+
+1. **`npm run build`** — TypeScript compiler (`tsc`) compiles `src/` → `dist/`
+2. **`npm run bundle`** — esbuild bundles `dist/index.js` → `bundle/watchdog.cjs`
+3. **`pkg`** — wraps `bundle/watchdog.cjs` with a Node.js runtime into a single executable
+
+## Why the esbuild step?
+
+`better-sqlite3` uses a native `.node` addon (`better_sqlite3.node`) that cannot be inlined by pkg. The esbuild step bundles everything else while leaving `better-sqlite3` and `node-windows` as external `require()` calls. pkg then carries the `.node` file as an **asset** (see `pkg.assets` in `package.json`) and patches the path at runtime so the executable finds it.
+
+## Native addon details
+
+The `.node` file is embedded in the executable at:
+
+```
+node_modules/better-sqlite3/build/Release/better_sqlite3.node
+```
+
+pkg extracts it to a temporary directory at startup. The `pkg.assets` field in `package.json` controls which files are embedded:
+
+```json
+"assets": [
+  "config/**/*",
+  "node_modules/better-sqlite3/build/Release/better_sqlite3.node"
+]
+```
+
+## Verifying the build
+
+After a successful Windows build:
+
+```
+./standalone/watchdog-win.exe status
+```
+
+The executable should print the current watchdog status without needing Node.js installed.
+
+## Output locations
+
+- `bundle/` — intermediate esbuild output (gitignored)
+- `standalone/` — final executables (gitignored)
+
+Neither directory is committed to source control.
+
+## Cross-compilation notes
+
+pkg downloads pre-built Node.js binaries for the target platform automatically on first use. Building a Linux or macOS binary on Windows is supported — pkg handles the download. However, native addons (`.node` files) are platform-specific: a `better_sqlite3.node` compiled on Windows will not work on Linux. For Linux/macOS targets, the addon must be compiled on that platform. Consider using CI (e.g., GitHub Actions) with platform-specific runners for production cross-platform builds.

package/README.md

@@ -0,0 +1,115 @@
+# Process Watchdog
+
+[![npm version](https://img.shields.io/npm/v/process-watchdog.svg)](https://www.npmjs.com/package/process-watchdog)
+
+Modular PC health agent for the aidev.com.au ecosystem.
+
+---
+
+## Features
+
+- 5 built-in plugins: `process-guard`, `memory-monitor`, `disk-health`, `startup-optimizer`, `cpu-monitor`
+- REST API on port 3400 (`/api/v1`)
+- `watchdog` CLI tool
+- Windows service support via `node-windows`
+- aidev.com.au dashboard integration (totalRecall, mah)
+
+---
+
+## Quick Start
+
+```bash
+npm install -g process-watchdog
+
+watchdog status   # one-shot health check
+watchdog start    # run continuously with scheduler
+```
+
+---
+
+## CLI Commands
+
+| Command                    | Description                                        |
+|----------------------------|----------------------------------------------------|
+| `watchdog start`           | Load config, start scheduler, watch continuously   |
+| `watchdog stop`            | Stop the running watchdog process                  |
+| `watchdog status`          | Run check() on each plugin and print a summary     |
+| `watchdog check [plugin]`  | Detailed metrics for all or a specific plugin      |
+| `watchdog fix [plugin]`    | Run fix() for all or a specific plugin             |
+| `watchdog api start`       | Start the HTTP REST API server                     |
+| `watchdog install-service` | Install watchdog as a Windows system service       |
+| `watchdog uninstall-service` | Uninstall the Windows system service             |
+
+---
+
+## Plugins
+
+| Plugin              | Description                                  | Default Interval | Auto-Fix |
+|---------------------|----------------------------------------------|-----------------|----------|
+| `process-guard`     | Kills runaway node/cmd/bash processes        | 5 min           | Yes      |
+| `memory-monitor`    | Alerts on high RAM usage                     | 2 min           | No       |
+| `disk-health`       | Checks disk usage and cleans temp files      | 30 min          | Yes      |
+| `startup-optimizer` | Audits startup programs                      | On demand       | No       |
+| `cpu-monitor`       | Alerts on sustained high CPU usage           | 2 min           | No       |
+
+---
+
+## API Endpoints
+
+All routes are prefixed with `/api/v1`.
+
+| Method | Endpoint               | Description                                          |
+|--------|------------------------|------------------------------------------------------|
+| GET    | `/health`              | Overall service health and per-plugin status         |
+| GET    | `/plugins`             | List all plugins with config and last check time     |
+| GET    | `/plugins/:name`       | Plugin details and last 50 history entries           |
+| POST   | `/plugins/:name/run`   | Run `check` or `fix` on a plugin (`{ action }` body) |
+| GET    | `/history`             | Check/fix history (query: `plugin`, `limit`)         |
+| GET    | `/config`              | Current active configuration                         |
+
+---
+
+## Configuration
+
+**Default config** — `config/default.json` in the package.
+
+**User override** — `~/.aidev/watchdog.json` (merged over defaults at startup).
+
+Key options:
+
+```jsonc
+{
+  "port": 3400,
+  "logLevel": "info",
+  "historyRetentionDays": 30,
+  "plugins": {
+    "process-guard": { "enabled": true, "interval": 300000, "autoFix": true },
+    "memory-monitor": { "enabled": true, "interval": 120000, "autoFix": false }
+    // ...
+  }
+}
+```
+
+History and the SQLite database are stored at `~/.aidev/watchdog.db`.
+
+---
+
+## Dashboard
+
+Open `dashboard/watchdog.html` in a browser while the API server is running to view a live health overview compatible with aidev.com.au.
+
+---
+
+## Development
+
+```bash
+npm run build   # compile TypeScript → dist/
+npm test        # run tests with vitest
+npm run dev     # run from source with tsx (no build step)
+```
+
+---
+
+## License
+
+MIT

package/dashboard/watchdog.html

@@ -372,6 +372,176 @@
       font-size: 13px;
     }
 
+    /* ── Config editor ── */
+    .config-plugin-block {
+      border: 1px solid var(--card-border);
+      border-radius: 8px;
+      margin-bottom: 14px;
+      overflow: hidden;
+    }
+
+    .config-plugin-block:last-of-type { margin-bottom: 0; }
+
+    .config-plugin-header {
+      background: rgba(79,195,247,0.06);
+      border-bottom: 1px solid var(--card-border);
+      padding: 10px 16px;
+      display: flex;
+      align-items: center;
+      gap: 12px;
+    }
+
+    .config-plugin-name {
+      font-weight: 700;
+      font-size: 13px;
+      flex: 1;
+      color: var(--accent);
+      font-family: 'Consolas', 'SF Mono', monospace;
+    }
+
+    .config-plugin-body {
+      padding: 12px 16px;
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+      gap: 10px 20px;
+    }
+
+    .config-field {
+      display: flex;
+      flex-direction: column;
+      gap: 4px;
+    }
+
+    .config-label {
+      font-size: 11px;
+      font-weight: 600;
+      color: var(--text-muted);
+      text-transform: uppercase;
+      letter-spacing: 0.06em;
+    }
+
+    .config-input {
+      background: var(--bg);
+      border: 1px solid var(--card-border);
+      border-radius: 5px;
+      color: var(--text);
+      font-size: 13px;
+      padding: 5px 9px;
+      width: 100%;
+      transition: border-color 0.15s;
+      font-family: inherit;
+    }
+
+    .config-input:focus {
+      outline: none;
+      border-color: var(--accent);
+    }
+
+    .config-thresholds {
+      grid-column: 1 / -1;
+    }
+
+    .config-threshold-row {
+      display: flex;
+      align-items: center;
+      gap: 6px;
+      margin-bottom: 6px;
+    }
+
+    .config-threshold-row:last-child { margin-bottom: 0; }
+
+    .config-threshold-key {
+      flex: 1;
+      min-width: 0;
+    }
+
+    .config-threshold-val {
+      width: 100px;
+      flex-shrink: 0;
+    }
+
+    /* Toggle switch */
+    .toggle-wrap {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      padding-top: 20px;
+    }
+
+    .toggle {
+      position: relative;
+      width: 36px;
+      height: 20px;
+      flex-shrink: 0;
+    }
+
+    .toggle input { opacity: 0; width: 0; height: 0; position: absolute; }
+
+    .toggle-slider {
+      position: absolute;
+      inset: 0;
+      background: var(--card-border);
+      border-radius: 20px;
+      cursor: pointer;
+      transition: background 0.2s;
+    }
+
+    .toggle-slider::before {
+      content: '';
+      position: absolute;
+      width: 14px;
+      height: 14px;
+      left: 3px;
+      top: 3px;
+      background: var(--text-muted);
+      border-radius: 50%;
+      transition: transform 0.2s, background 0.2s;
+    }
+
+    .toggle input:checked + .toggle-slider { background: rgba(79,195,247,0.25); }
+    .toggle input:checked + .toggle-slider::before {
+      transform: translateX(16px);
+      background: var(--accent);
+    }
+
+    /* Config action bar */
+    .config-actions {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      margin-top: 16px;
+    }
+
+    .btn-save {
+      background: rgba(79,195,247,0.15);
+      border-color: var(--accent);
+      color: var(--accent);
+      padding: 8px 20px;
+      font-size: 13px;
+    }
+
+    .config-feedback {
+      font-size: 12px;
+      font-weight: 600;
+      padding: 4px 10px;
+      border-radius: 5px;
+      display: none;
+    }
+
+    .config-feedback.success {
+      display: inline-block;
+      background: rgba(102,187,106,0.15);
+      color: var(--healthy);
+      border: 1px solid var(--healthy);
+    }
+
+    .config-feedback.error {
+      display: inline-block;
+      background: rgba(239,83,80,0.15);
+      color: var(--critical);
+      border: 1px solid var(--critical);
+    }
+
     /* ── Footer ── */
     footer {
       text-align: center;
@@ -440,6 +610,18 @@
     </div>
   </section>
 
+  <section id="config-section">
+    <h2>Configuration</h2>
+    <div class="card" id="config-card">
+      <div class="history-empty" id="config-loading">Loading configuration…</div>
+      <div id="config-plugins" style="display:none;"></div>
+      <div class="config-actions" id="config-actions" style="display:none;">
+        <button class="btn btn-save" id="config-save-btn" type="button">Save Changes</button>
+        <span class="config-feedback" id="config-feedback"></span>
+      </div>
+    </div>
+  </section>
+
 </main>
 
 <footer>
@@ -843,11 +1025,235 @@
     }
   }
 
+  // ── Config editor ─────────────────────────────────────────────────────────
+
+  // Store the raw config so Save knows what to build from
+  var _loadedConfig = null;
+
+  function buildConfigEditor(config) {
+    _loadedConfig = config;
+    var container = document.getElementById('config-plugins');
+    while (container.firstChild) container.removeChild(container.firstChild);
+
+    var plugins = config.plugins || {};
+
+    Object.keys(plugins).forEach(function (pluginName) {
+      var pcfg = plugins[pluginName];
+
+      var block = el('div', 'config-plugin-block');
+
+      // ── Header: plugin name + enabled toggle ──
+      var header = el('div', 'config-plugin-header');
+
+      var nameEl = el('span', 'config-plugin-name');
+      setText(nameEl, pluginName);
+      header.appendChild(nameEl);
+
+      var enabledLabel = el('span', 'config-label');
+      setText(enabledLabel, 'Enabled');
+      enabledLabel.style.marginRight = '6px';
+
+      var toggleWrap = el('label', 'toggle');
+      var toggleInput = el('input');
+      toggleInput.type = 'checkbox';
+      toggleInput.id = 'cfg-enabled-' + pluginName;
+      toggleInput.checked = !!pcfg.enabled;
+      var toggleSlider = el('span', 'toggle-slider');
+      toggleWrap.appendChild(toggleInput);
+      toggleWrap.appendChild(toggleSlider);
+
+      header.appendChild(enabledLabel);
+      header.appendChild(toggleWrap);
+      block.appendChild(header);
+
+      // ── Body: interval + autoFix + thresholds ──
+      var body = el('div', 'config-plugin-body');
+
+      // Interval (ms → seconds)
+      if (pcfg.interval !== undefined) {
+        var intervalField = el('div', 'config-field');
+        var intervalLabel = el('label', 'config-label');
+        setText(intervalLabel, 'Interval (seconds)');
+        intervalLabel.htmlFor = 'cfg-interval-' + pluginName;
+        var intervalInput = el('input', 'config-input');
+        intervalInput.type = 'number';
+        intervalInput.id = 'cfg-interval-' + pluginName;
+        intervalInput.min = '0';
+        intervalInput.value = String(Math.round(pcfg.interval / 1000));
+        intervalField.appendChild(intervalLabel);
+        intervalField.appendChild(intervalInput);
+        body.appendChild(intervalField);
+      }
+
+      // AutoFix toggle
+      if (pcfg.autoFix !== undefined) {
+        var autoFixField = el('div', 'config-field');
+        var autoFixLabel = el('label', 'config-label');
+        setText(autoFixLabel, 'Auto Fix');
+        autoFixLabel.htmlFor = 'cfg-autofix-' + pluginName;
+        var autoFixToggleWrap = el('div', 'toggle-wrap');
+        var autoFixToggle = el('label', 'toggle');
+        var autoFixInput = el('input');
+        autoFixInput.type = 'checkbox';
+        autoFixInput.id = 'cfg-autofix-' + pluginName;
+        autoFixInput.checked = !!pcfg.autoFix;
+        var autoFixSlider = el('span', 'toggle-slider');
+        autoFixToggle.appendChild(autoFixInput);
+        autoFixToggle.appendChild(autoFixSlider);
+        autoFixToggleWrap.appendChild(autoFixToggle);
+        autoFixField.appendChild(autoFixLabel);
+        autoFixField.appendChild(autoFixToggleWrap);
+        body.appendChild(autoFixField);
+      }
+
+      // Thresholds
+      var thresholds = pcfg.thresholds || {};
+      var threshKeys = Object.keys(thresholds);
+      if (threshKeys.length > 0) {
+        var threshField = el('div', 'config-field config-thresholds');
+        var threshHeading = el('span', 'config-label');
+        setText(threshHeading, 'Thresholds');
+        threshField.appendChild(threshHeading);
+
+        threshKeys.forEach(function (key) {
+          var row = el('div', 'config-threshold-row');
+
+          var keyInput = el('input', 'config-input config-threshold-key');
+          keyInput.type = 'text';
+          keyInput.value = key;
+          keyInput.readOnly = true;
+          keyInput.style.color = 'var(--text-muted)';
+
+          var valInput = el('input', 'config-input config-threshold-val');
+          valInput.type = 'number';
+          valInput.id = 'cfg-thresh-' + pluginName + '-' + key;
+          valInput.value = String(thresholds[key]);
+          valInput.dataset.plugin = pluginName;
+          valInput.dataset.key = key;
+
+          row.appendChild(keyInput);
+          row.appendChild(valInput);
+          threshField.appendChild(row);
+        });
+
+        body.appendChild(threshField);
+      }
+
+      block.appendChild(body);
+      container.appendChild(block);
+    });
+
+    document.getElementById('config-loading').style.display = 'none';
+    container.style.display = 'block';
+    document.getElementById('config-actions').style.display = 'flex';
+  }
+
+  function collectConfigPayload() {
+    if (!_loadedConfig) return null;
+    var plugins = _loadedConfig.plugins || {};
+    var payload = { plugins: {} };
+
+    Object.keys(plugins).forEach(function (pluginName) {
+      var pcfg = plugins[pluginName];
+      var out = {};
+
+      // enabled
+      var enabledEl = document.getElementById('cfg-enabled-' + pluginName);
+      if (enabledEl) out.enabled = enabledEl.checked;
+
+      // interval (seconds → ms)
+      var intervalEl = document.getElementById('cfg-interval-' + pluginName);
+      if (intervalEl) {
+        var secs = parseFloat(intervalEl.value);
+        out.interval = isNaN(secs) ? pcfg.interval : Math.round(secs * 1000);
+      }
+
+      // autoFix
+      var autoFixEl = document.getElementById('cfg-autofix-' + pluginName);
+      if (autoFixEl) out.autoFix = autoFixEl.checked;
+
+      // thresholds
+      var thresholds = pcfg.thresholds || {};
+      if (Object.keys(thresholds).length > 0) {
+        out.thresholds = {};
+        Object.keys(thresholds).forEach(function (key) {
+          var valEl = document.getElementById('cfg-thresh-' + pluginName + '-' + key);
+          if (valEl) {
+            var num = parseFloat(valEl.value);
+            out.thresholds[key] = isNaN(num) ? thresholds[key] : num;
+          } else {
+            out.thresholds[key] = thresholds[key];
+          }
+        });
+      }
+
+      payload.plugins[pluginName] = out;
+    });
+
+    return payload;
+  }
+
+  function showConfigFeedback(type, message) {
+    var fb = document.getElementById('config-feedback');
+    fb.className = 'config-feedback ' + type;
+    setText(fb, message);
+    clearTimeout(fb._hideTimer);
+    fb._hideTimer = setTimeout(function () {
+      fb.className = 'config-feedback';
+      setText(fb, '');
+    }, 4000);
+  }
+
+  async function fetchConfig() {
+    try {
+      var res = await fetch(API_BASE + '/config', { cache: 'no-store' });
+      if (!res.ok) throw new Error('HTTP ' + res.status);
+      var data = await res.json();
+      buildConfigEditor(data);
+    } catch (err) {
+      console.warn('[watchdog] fetchConfig error:', err.message);
+      var loadingEl = document.getElementById('config-loading');
+      setText(loadingEl, 'Unable to load configuration.');
+    }
+  }
+
+  async function saveConfig() {
+    var saveBtn = document.getElementById('config-save-btn');
+    saveBtn.disabled = true;
+    var payload = collectConfigPayload();
+    if (!payload) {
+      showConfigFeedback('error', 'Nothing to save.');
+      saveBtn.disabled = false;
+      return;
+    }
+    try {
+      var res = await fetch(API_BASE + '/config', {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+      });
+      var data = await res.json();
+      if (res.ok) {
+        showConfigFeedback('success', 'Configuration saved.');
+        buildConfigEditor(data);
+      } else {
+        showConfigFeedback('error', data.error || 'Save failed (HTTP ' + res.status + ').');
+      }
+    } catch (err) {
+      showConfigFeedback('error', 'Save error: ' + err.message);
+    } finally {
+      saveBtn.disabled = false;
+    }
+  }
+
+  document.getElementById('config-save-btn').addEventListener('click', saveConfig);
+
   // ── Boot ─────────────────────────────────────────────────────────────────
 
   buildGaugeGrid();
   fetchHealth();
   fetchHistory();
+  fetchConfig();
   setInterval(function () { fetchHealth(); fetchHistory(); }, 15000);
 
 }());

package/dist/api/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAgB,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAc9C,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,cAAc,EAAE,EACzB,MAAM,EAAE,cAAc,GACrB,MAAM,CAqGR"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAgB,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAc9C,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,cAAc,EAAE,EACzB,MAAM,EAAE,cAAc,GACrB,MAAM,CA0JR"}

package/dist/api/routes.js

@@ -1,4 +1,7 @@
 import { Router } from 'express';
+import { writeFile, mkdir } from 'fs/promises';
+import { join } from 'path';
+import os from 'os';
 const STATUS_ORDER = ['healthy', 'warning', 'critical'];
 function worstStatus(statuses) {
     let worst = 'healthy';
@@ -100,6 +103,48 @@ export function createRoutes(store, plugins, config) {
     router.get('/config', (_req, res) => {
         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) {
+                return typeof v === 'object' && v !== null && !Array.isArray(v);
+            }
+            function deepMerge(target, source) {
+                const result = { ...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, body);
+            // 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;
 }
 //# sourceMappingURL=routes.js.map