clawdoctor 0.1.0

package/README.md

@@ -0,0 +1,112 @@
+# clawdoctor
+
+Self-healing monitor for OpenClaw. Watches your gateway, crons, and agent sessions, sends Telegram alerts, and auto-fixes what it can.
+
+Built by people who run 20+ OpenClaw agents in production and got tired of checking if things were still alive.
+
+## Install
+
+```bash
+npm install -g clawdoctor
+```
+
+## Quick Start
+
+```bash
+# Configure
+clawdoctor init
+
+# Start monitoring
+clawdoctor start
+```
+
+## Commands
+
+```bash
+clawdoctor init             # Interactive setup
+clawdoctor start            # Start monitoring daemon
+clawdoctor start --dry-run  # Run without taking healing actions
+clawdoctor stop             # Stop daemon
+clawdoctor status           # Live health check of all monitors
+clawdoctor log              # Show recent events from local database
+clawdoctor log -n 100       # Show 100 events
+clawdoctor log -w GatewayWatcher -s critical  # Filter by watcher/severity
+clawdoctor install-service  # Install as systemd user service
+```
+
+## What It Monitors
+
+| Monitor | What It Watches | Interval |
+|---------|-----------------|----------|
+| **GatewayWatcher** | `openclaw` process running | 30s |
+| **CronWatcher** | `~/.openclaw/state/cron-*.json` for missed/failed crons | 60s |
+| **SessionWatcher** | `~/.openclaw/agents/*/sessions/*.jsonl` for errors, aborts, stuck sessions | 60s |
+| **AuthWatcher** | Gateway logs for 401/403/token expired patterns | 60s |
+| **CostWatcher** | Session token costs — flags if >3x rolling average | 5m |
+
+## What It Fixes
+
+| Healer | Action |
+|--------|--------|
+| **ProcessHealer** | Restarts gateway via `systemctl restart openclaw-gateway` or `openclaw gateway restart`, then verifies |
+| **CronHealer** | Logs the failure and includes the manual rerun command in the alert (Phase 0 — no auto-rerun) |
+
+## Alerts
+
+Telegram alerts with rate limiting (max 1 per monitor per 5 minutes):
+
+```
+🔴 ClawDoctor Alert
+Monitor: GatewayWatcher
+Event: Gateway process not found
+Action: openclaw gateway restart
+Status: ✅ Back online
+─────
+Time: 2026-03-15 03:14 UTC
+Host: devbox
+```
+
+## Configuration
+
+Config lives at `~/.clawdoctor/config.json`:
+
+```json
+{
+  "openclawPath": "/root/.openclaw",
+  "watchers": {
+    "gateway": { "enabled": true, "interval": 30 },
+    "cron": { "enabled": true, "interval": 60 },
+    "session": { "enabled": true, "interval": 60 },
+    "auth": { "enabled": true, "interval": 60 },
+    "cost": { "enabled": true, "interval": 300 }
+  },
+  "healers": {
+    "processRestart": { "enabled": true },
+    "cronRetry": { "enabled": false }
+  },
+  "alerts": {
+    "telegram": {
+      "enabled": true,
+      "botToken": "your-bot-token",
+      "chatId": "your-chat-id"
+    }
+  },
+  "dryRun": false,
+  "retentionDays": 7
+}
+```
+
+Events are stored in `~/.clawdoctor/events.db` (SQLite) and retained for 7 days by default.
+
+## Systemd
+
+```bash
+clawdoctor install-service
+systemctl --user daemon-reload
+systemctl --user enable clawdoctor
+systemctl --user start clawdoctor
+```
+
+## License
+
+MIT

package/dist/alerters/telegram.d.ts

@@ -0,0 +1,21 @@
+import { ClawDoctorConfig } from '../config.js';
+import { WatchResult } from '../watchers/base.js';
+import { HealResult } from '../healers/base.js';
+interface AlertPayload {
+    watcher: string;
+    result: WatchResult;
+    healResult?: HealResult;
+}
+export declare class TelegramAlerter {
+    private config;
+    private lastAlertTime;
+    constructor(config: ClawDoctorConfig);
+    private isRateLimited;
+    private markAlerted;
+    shouldAlert(result: WatchResult): boolean;
+    sendAlert(payload: AlertPayload): Promise<boolean>;
+    formatMessage(payload: AlertPayload): string;
+    sendRecovery(watcherName: string, message: string): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=telegram.d.ts.map

package/dist/alerters/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/alerters/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOhD,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,aAAa,CAAkC;gBAE3C,MAAM,EAAE,gBAAgB;IAIpC,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;IAInB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAInC,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAuCxD,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;IAsBtC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAS3E"}

package/dist/alerters/telegram.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramAlerter = void 0;
+const utils_js_1 = require("../utils.js");
+const RATE_LIMIT_MS = 5 * 60 * 1000; // 5 minutes per monitor
+const TELEGRAM_API = 'https://api.telegram.org';
+class TelegramAlerter {
+    config;
+    lastAlertTime = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    isRateLimited(watcherName) {
+        const lastAlert = this.lastAlertTime.get(watcherName) ?? 0;
+        return Date.now() - lastAlert < RATE_LIMIT_MS;
+    }
+    markAlerted(watcherName) {
+        this.lastAlertTime.set(watcherName, Date.now());
+    }
+    shouldAlert(result) {
+        return result.severity === 'error' || result.severity === 'critical' || result.severity === 'warning';
+    }
+    async sendAlert(payload) {
+        const { telegram } = this.config.alerts;
+        if (!telegram.enabled || !telegram.botToken || !telegram.chatId) {
+            return false;
+        }
+        if (this.isRateLimited(payload.watcher)) {
+            return false;
+        }
+        const message = this.formatMessage(payload);
+        try {
+            const url = `${TELEGRAM_API}/bot${telegram.botToken}/sendMessage`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    chat_id: telegram.chatId,
+                    text: message,
+                    parse_mode: 'HTML',
+                }),
+            });
+            if (response.ok) {
+                this.markAlerted(payload.watcher);
+                return true;
+            }
+            else {
+                const body = await response.text();
+                console.error(`[TelegramAlerter] Failed to send alert: ${response.status} ${body}`);
+                return false;
+            }
+        }
+        catch (err) {
+            console.error(`[TelegramAlerter] Error sending alert:`, err);
+            return false;
+        }
+    }
+    formatMessage(payload) {
+        const { watcher, result, healResult } = payload;
+        const isOk = result.ok || result.severity === 'info';
+        const icon = isOk ? '🟢' : (result.severity === 'critical' ? '🔴' : '🟡');
+        const actionLine = healResult
+            ? `Action: ${healResult.action}\nStatus: ${healResult.success ? '✅ ' + healResult.message : '❌ ' + healResult.message}`
+            : '';
+        const lines = [
+            `${icon} <b>ClawDoctor Alert</b>`,
+            `Monitor: ${watcher}`,
+            `Event: ${result.message}`,
+            ...(actionLine ? [actionLine] : []),
+            '─────',
+            `Time: ${(0, utils_js_1.nowUtcDisplay)()}`,
+            `Host: ${(0, utils_js_1.hostname)()}`,
+        ];
+        return lines.join('\n');
+    }
+    async sendRecovery(watcherName, message) {
+        const fakeResult = {
+            ok: true,
+            severity: 'info',
+            event_type: 'recovered',
+            message,
+        };
+        return this.sendAlert({ watcher: watcherName, result: fakeResult });
+    }
+}
+exports.TelegramAlerter = TelegramAlerter;
+//# sourceMappingURL=telegram.js.map

package/dist/alerters/telegram.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,42 @@
+export interface WatcherConfig {
+    enabled: boolean;
+    interval: number;
+}
+export interface HealerConfig {
+    enabled: boolean;
+}
+export interface TelegramConfig {
+    enabled: boolean;
+    botToken: string;
+    chatId: string;
+}
+export interface AlertsConfig {
+    telegram: TelegramConfig;
+}
+export interface ClawDoctorConfig {
+    openclawPath: string;
+    watchers: {
+        gateway: WatcherConfig;
+        cron: WatcherConfig;
+        session: WatcherConfig;
+        auth: WatcherConfig;
+        cost: WatcherConfig;
+    };
+    healers: {
+        processRestart: HealerConfig;
+        cronRetry: HealerConfig;
+    };
+    alerts: AlertsConfig;
+    dryRun: boolean;
+    retentionDays: number;
+}
+export declare const AGENTWATCH_DIR: string;
+export declare const CONFIG_PATH: string;
+export declare const DB_PATH: string;
+export declare const PID_PATH: string;
+export declare const DEFAULT_CONFIG: ClawDoctorConfig;
+export declare function loadConfig(): ClawDoctorConfig;
+export declare function saveConfig(config: ClawDoctorConfig): void;
+export declare function ensureAgentwatchDir(): void;
+export declare function configExists(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE;QACR,OAAO,EAAE,aAAa,CAAC;QACvB,IAAI,EAAE,aAAa,CAAC;QACpB,OAAO,EAAE,aAAa,CAAC;QACvB,IAAI,EAAE,aAAa,CAAC;QACpB,IAAI,EAAE,aAAa,CAAC;KACrB,CAAC;IACF,OAAO,EAAE;QACP,cAAc,EAAE,YAAY,CAAC;QAC7B,SAAS,EAAE,YAAY,CAAC;KACzB,CAAC;IACF,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,QAAyC,CAAC;AACrE,eAAO,MAAM,WAAW,QAA2C,CAAC;AACpE,eAAO,MAAM,OAAO,QAAyC,CAAC;AAC9D,eAAO,MAAM,QAAQ,QAA8C,CAAC;AAEpE,eAAO,MAAM,cAAc,EAAE,gBAsB5B,CAAC;AAEF,wBAAgB,UAAU,IAAI,gBAAgB,CAO7C;AAmBD,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAGzD;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/dist/config.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = exports.PID_PATH = exports.DB_PATH = exports.CONFIG_PATH = exports.AGENTWATCH_DIR = void 0;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.ensureAgentwatchDir = ensureAgentwatchDir;
+exports.configExists = configExists;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+exports.AGENTWATCH_DIR = path_1.default.join(os_1.default.homedir(), '.clawdoctor');
+exports.CONFIG_PATH = path_1.default.join(exports.AGENTWATCH_DIR, 'config.json');
+exports.DB_PATH = path_1.default.join(exports.AGENTWATCH_DIR, 'events.db');
+exports.PID_PATH = path_1.default.join(exports.AGENTWATCH_DIR, 'clawdoctor.pid');
+exports.DEFAULT_CONFIG = {
+    openclawPath: path_1.default.join(os_1.default.homedir(), '.openclaw'),
+    watchers: {
+        gateway: { enabled: true, interval: 30 },
+        cron: { enabled: true, interval: 60 },
+        session: { enabled: true, interval: 60 },
+        auth: { enabled: true, interval: 60 },
+        cost: { enabled: true, interval: 300 },
+    },
+    healers: {
+        processRestart: { enabled: true },
+        cronRetry: { enabled: false },
+    },
+    alerts: {
+        telegram: {
+            enabled: false,
+            botToken: '',
+            chatId: '',
+        },
+    },
+    dryRun: false,
+    retentionDays: 7,
+};
+function loadConfig() {
+    if (!fs_1.default.existsSync(exports.CONFIG_PATH)) {
+        throw new Error(`Config not found at ${exports.CONFIG_PATH}. Run 'clawdoctor init' first.`);
+    }
+    const raw = fs_1.default.readFileSync(exports.CONFIG_PATH, 'utf-8');
+    const parsed = JSON.parse(raw);
+    return mergeConfig(exports.DEFAULT_CONFIG, parsed);
+}
+function mergeConfig(defaults, overrides) {
+    return {
+        ...defaults,
+        ...overrides,
+        watchers: { ...defaults.watchers, ...(overrides.watchers ?? {}) },
+        healers: { ...defaults.healers, ...(overrides.healers ?? {}) },
+        alerts: {
+            ...defaults.alerts,
+            ...(overrides.alerts ?? {}),
+            telegram: {
+                ...defaults.alerts.telegram,
+                ...(overrides.alerts?.telegram ?? {}),
+            },
+        },
+    };
+}
+function saveConfig(config) {
+    ensureAgentwatchDir();
+    fs_1.default.writeFileSync(exports.CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
+}
+function ensureAgentwatchDir() {
+    if (!fs_1.default.existsSync(exports.AGENTWATCH_DIR)) {
+        fs_1.default.mkdirSync(exports.AGENTWATCH_DIR, { recursive: true });
+    }
+}
+function configExists() {
+    return fs_1.default.existsSync(exports.CONFIG_PATH);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/daemon.d.ts

@@ -0,0 +1,21 @@
+import { ClawDoctorConfig } from './config.js';
+import { WatchResult } from './watchers/base.js';
+export declare class Daemon {
+    private config;
+    private watchers;
+    private alerter;
+    private processHealer;
+    private cronHealer;
+    private running;
+    private tickInterval;
+    constructor(config: ClawDoctorConfig);
+    private setupWatchers;
+    start(): void;
+    stop(): void;
+    private tick;
+    private runWatcher;
+    private handleResult;
+    private attemptHeal;
+    runOnce(): Promise<Map<string, WatchResult[]>>;
+}
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAe,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkB9D,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAA+B;gBAEvC,MAAM,EAAE,gBAAgB;IAQpC,OAAO,CAAC,aAAa;IAwCrB,KAAK,IAAI,IAAI;IA0Bb,IAAI,IAAI,IAAI;IAUZ,OAAO,CAAC,IAAI;YAYE,UAAU;YAWV,YAAY;YAkBZ,WAAW;IAsBnB,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;CAiBrD"}

package/dist/daemon.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Daemon = void 0;
+const gateway_js_1 = require("./watchers/gateway.js");
+const cron_js_1 = require("./watchers/cron.js");
+const session_js_1 = require("./watchers/session.js");
+const auth_js_1 = require("./watchers/auth.js");
+const cost_js_1 = require("./watchers/cost.js");
+const process_js_1 = require("./healers/process.js");
+const cron_js_2 = require("./healers/cron.js");
+const telegram_js_1 = require("./alerters/telegram.js");
+const store_js_1 = require("./store.js");
+const utils_js_1 = require("./utils.js");
+class Daemon {
+    config;
+    watchers = [];
+    alerter;
+    processHealer;
+    cronHealer;
+    running = false;
+    tickInterval = null;
+    constructor(config) {
+        this.config = config;
+        this.alerter = new telegram_js_1.TelegramAlerter(config);
+        this.processHealer = new process_js_1.ProcessHealer(config);
+        this.cronHealer = new cron_js_2.CronHealer(config);
+        this.setupWatchers();
+    }
+    setupWatchers() {
+        const { watchers } = this.config;
+        if (watchers.gateway.enabled) {
+            this.watchers.push({
+                watcher: new gateway_js_1.GatewayWatcher(this.config),
+                intervalMs: watchers.gateway.interval * 1000,
+                lastRun: 0,
+            });
+        }
+        if (watchers.cron.enabled) {
+            this.watchers.push({
+                watcher: new cron_js_1.CronWatcher(this.config),
+                intervalMs: watchers.cron.interval * 1000,
+                lastRun: 0,
+            });
+        }
+        if (watchers.session.enabled) {
+            this.watchers.push({
+                watcher: new session_js_1.SessionWatcher(this.config),
+                intervalMs: watchers.session.interval * 1000,
+                lastRun: 0,
+            });
+        }
+        if (watchers.auth.enabled) {
+            this.watchers.push({
+                watcher: new auth_js_1.AuthWatcher(this.config),
+                intervalMs: watchers.auth.interval * 1000,
+                lastRun: 0,
+            });
+        }
+        if (watchers.cost.enabled) {
+            this.watchers.push({
+                watcher: new cost_js_1.CostWatcher(this.config),
+                intervalMs: watchers.cost.interval * 1000,
+                lastRun: 0,
+            });
+        }
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        console.log(`[${(0, utils_js_1.nowIso)()}] ClawDoctor daemon started`);
+        console.log(`[${(0, utils_js_1.nowIso)()}] Monitoring ${this.watchers.length} watcher(s)`);
+        if (this.config.dryRun) {
+            console.log(`[${(0, utils_js_1.nowIso)()}] DRY RUN mode — healers will not take action`);
+        }
+        // Run all watchers immediately on start
+        this.tick();
+        // Tick every 5 seconds to check if any watcher is due
+        this.tickInterval = setInterval(() => this.tick(), 5000);
+        // Prune old events daily
+        setInterval(() => {
+            const pruned = (0, store_js_1.pruneOldEvents)(this.config.retentionDays);
+            if (pruned > 0) {
+                console.log(`[${(0, utils_js_1.nowIso)()}] Pruned ${pruned} old event(s)`);
+            }
+        }, 24 * 3600 * 1000);
+    }
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.tickInterval) {
+            clearInterval(this.tickInterval);
+            this.tickInterval = null;
+        }
+        console.log(`[${(0, utils_js_1.nowIso)()}] ClawDoctor daemon stopped`);
+    }
+    tick() {
+        const now = Date.now();
+        for (const entry of this.watchers) {
+            if (now - entry.lastRun >= entry.intervalMs) {
+                entry.lastRun = now;
+                this.runWatcher(entry.watcher).catch(err => {
+                    console.error(`[${(0, utils_js_1.nowIso)()}] Error in ${entry.watcher.name}:`, err);
+                });
+            }
+        }
+    }
+    async runWatcher(watcher) {
+        try {
+            const results = await watcher.run();
+            for (const result of results) {
+                await this.handleResult(watcher, result);
+            }
+        }
+        catch (err) {
+            console.error(`[${(0, utils_js_1.nowIso)()}] ${watcher.name} threw:`, err);
+        }
+    }
+    async handleResult(watcher, result) {
+        const prefix = `[${(0, utils_js_1.nowIso)()}] [${watcher.name}]`;
+        if (result.severity !== 'info') {
+            console.log(`${prefix} ${result.severity.toUpperCase()}: ${result.message}`);
+        }
+        // Auto-healing
+        if (!result.ok) {
+            const healResult = await this.attemptHeal(watcher, result);
+            if (healResult && this.alerter.shouldAlert(result)) {
+                await this.alerter.sendAlert({ watcher: watcher.name, result, healResult });
+            }
+            else if (this.alerter.shouldAlert(result)) {
+                await this.alerter.sendAlert({ watcher: watcher.name, result });
+            }
+        }
+    }
+    async attemptHeal(watcher, result) {
+        if (watcher.name === 'GatewayWatcher' && result.event_type === 'gateway_down') {
+            if (this.config.healers.processRestart.enabled) {
+                console.log(`[${(0, utils_js_1.nowIso)()}] [ProcessHealer] Attempting to restart gateway...`);
+                const healResult = await this.processHealer.heal({});
+                console.log(`[${(0, utils_js_1.nowIso)()}] [ProcessHealer] ${healResult.success ? 'SUCCESS' : 'FAILED'}: ${healResult.message}`);
+                return healResult;
+            }
+        }
+        if (watcher.name === 'CronWatcher' && (result.event_type === 'cron_error' || result.event_type === 'cron_overdue')) {
+            const context = result.details ?? {};
+            const healResult = await this.cronHealer.heal(context);
+            return healResult;
+        }
+        return null;
+    }
+    async runOnce() {
+        const allResults = new Map();
+        for (const entry of this.watchers) {
+            try {
+                const results = await entry.watcher.check();
+                allResults.set(entry.watcher.name, results);
+            }
+            catch (err) {
+                allResults.set(entry.watcher.name, [{
+                        ok: false,
+                        severity: 'error',
+                        event_type: 'watcher_error',
+                        message: `Watcher threw: ${String(err)}`,
+                    }]);
+            }
+        }
+        return allResults;
+    }
+}
+exports.Daemon = Daemon;
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/dist/healers/base.d.ts

@@ -0,0 +1,15 @@
+import { ClawDoctorConfig } from '../config.js';
+export interface HealResult {
+    success: boolean;
+    action: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export declare abstract class BaseHealer {
+    abstract readonly name: string;
+    protected config: ClawDoctorConfig;
+    constructor(config: ClawDoctorConfig);
+    abstract heal(context: Record<string, unknown>): Promise<HealResult>;
+    protected recordHeal(watcherName: string, result: HealResult, eventType: string): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/healers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/healers/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,8BAAsB,UAAU;IAC9B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,SAAS,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAEvB,MAAM,EAAE,gBAAgB;IAIpC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;cAEpD,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;CAYjB"}

package/dist/healers/base.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseHealer = void 0;
+const store_js_1 = require("../store.js");
+const utils_js_1 = require("../utils.js");
+class BaseHealer {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async recordHeal(watcherName, result, eventType) {
+        (0, store_js_1.insertEvent)({
+            timestamp: (0, utils_js_1.nowIso)(),
+            watcher: watcherName,
+            severity: result.success ? 'info' : 'error',
+            event_type: eventType,
+            message: result.message,
+            details: result.details ? JSON.stringify(result.details) : undefined,
+            action_taken: result.action,
+            action_result: result.success ? 'success' : 'failed',
+        });
+    }
+}
+exports.BaseHealer = BaseHealer;
+//# sourceMappingURL=base.js.map

package/dist/healers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/healers/base.ts"],"names":[],"mappings":";;;AACA,0CAA0C;AAC1C,0CAAqC;AASrC,MAAsB,UAAU;IAGpB,MAAM,CAAmB;IAEnC,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAIS,KAAK,CAAC,UAAU,CACxB,WAAmB,EACnB,MAAkB,EAClB,SAAiB;QAEjB,IAAA,sBAAW,EAAC;YACV,SAAS,EAAE,IAAA,iBAAM,GAAE;YACnB,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YAC3C,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YACpE,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;SACrD,CAAC,CAAC;IACL,CAAC;CACF;AA3BD,gCA2BC"}

package/dist/healers/cron.d.ts

@@ -0,0 +1,6 @@
+import { BaseHealer, HealResult } from './base.js';
+export declare class CronHealer extends BaseHealer {
+    readonly name = "CronHealer";
+    heal(context: Record<string, unknown>): Promise<HealResult>;
+}
+//# sourceMappingURL=cron.d.ts.map

package/dist/healers/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/healers/cron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEnD,qBAAa,UAAW,SAAQ,UAAU;IACxC,QAAQ,CAAC,IAAI,gBAAgB;IAEvB,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAoBlE"}

package/dist/healers/cron.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CronHealer = void 0;
+const base_js_1 = require("./base.js");
+class CronHealer extends base_js_1.BaseHealer {
+    name = 'CronHealer';
+    async heal(context) {
+        const cronName = context.cronName ?? 'unknown';
+        const lastRun = context.lastRun ?? 'unknown';
+        const lastError = context.lastError ?? undefined;
+        // Phase 0: do not auto-rerun crons, just log and suggest
+        const manualCommand = cronName !== 'unknown'
+            ? `openclaw cron run ${cronName}`
+            : 'openclaw cron run <cron-name>';
+        const result = {
+            success: true,
+            action: `logged cron failure for '${cronName}'`,
+            message: `Cron '${cronName}' failed${lastError ? `: ${lastError}` : ''}. Last run: ${lastRun}. Manual rerun: \`${manualCommand}\``,
+            details: { cronName, lastRun, lastError, manualCommand },
+        };
+        await this.recordHeal('CronWatcher', result, 'cron_failure_logged');
+        return result;
+    }
+}
+exports.CronHealer = CronHealer;
+//# sourceMappingURL=cron.js.map