clawaid 1.0.0

package/dist/execute.js

@@ -0,0 +1,153 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeActions = executeActions;
+exports.formatExecuteResults = formatExecuteResults;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+async function runCommand(cmd, timeout = 30000) {
+    try {
+        const { stdout, stderr } = await execAsync(cmd, {
+            timeout,
+            env: {
+                ...process.env,
+                PATH: '/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:' + (process.env.PATH || ''),
+                HOME: os.homedir(),
+            }
+        });
+        const output = (stdout + (stderr ? '\n' + stderr : '')).trim();
+        return { success: true, output: output || '[command completed with no output]' };
+    }
+    catch (err) {
+        if (err && typeof err === 'object' && 'stdout' in err && 'stderr' in err) {
+            const e = err;
+            const out = (e.stdout || '').trim();
+            const errOut = (e.stderr || '').trim();
+            const combined = [out, errOut].filter(Boolean).join('\n');
+            // Some commands return non-zero but still succeed (e.g., kill when process doesn't exist)
+            return { success: false, output: combined || e.message, error: e.message };
+        }
+        return { success: false, output: '', error: err.message };
+    }
+}
+async function backupFile(filePath) {
+    const expandedPath = filePath.replace('~', os.homedir());
+    const backupPath = expandedPath + '.bak.' + Date.now();
+    if (fs.existsSync(expandedPath)) {
+        fs.copyFileSync(expandedPath, backupPath);
+        return backupPath;
+    }
+    return '';
+}
+async function executeActions(actions, onProgress, dryRun = false) {
+    const results = [];
+    const progress = (msg, result) => {
+        if (onProgress)
+            onProgress(msg, result);
+    };
+    if (dryRun) {
+        progress('⚠️ DRY-RUN mode — showing what would be executed:');
+        for (let i = 0; i < actions.length; i++) {
+            const action = actions[i];
+            progress(`  Step ${i + 1}: ${action.description}`);
+            progress(`    $ ${action.command}`);
+            progress(`    Risk: ${action.risk} | Type: ${action.type}`);
+            results.push({
+                action,
+                success: true,
+                output: '[dry-run: not executed]',
+            });
+        }
+        return { results, allSucceeded: true, summary: `Dry run: ${actions.length} actions shown (not executed)` };
+    }
+    for (let i = 0; i < actions.length; i++) {
+        const action = actions[i];
+        progress(`Step ${i + 1}/${actions.length}: ${action.description}`);
+        let backupPath;
+        // Backup file if needed
+        if (action.type === 'file_edit' && action.backup) {
+            try {
+                progress(`  → Creating backup...`);
+                const backupCmd = action.backup.replace('~', os.homedir());
+                // Extract file path from backup command or action command
+                const fileMatch = action.command.match(/['"]?([~\/][^'"]+)['"]?/);
+                if (fileMatch) {
+                    backupPath = await backupFile(fileMatch[1]);
+                    if (backupPath) {
+                        progress(`  → Backed up to: ${backupPath}`);
+                    }
+                }
+            }
+            catch (e) {
+                progress(`  → Backup warning: ${e.message}`);
+            }
+        }
+        // Execute the command
+        progress(`  → Running: ${action.command}`);
+        const { success, output, error } = await runCommand(action.command);
+        const result = {
+            action,
+            success,
+            output,
+            error,
+            backupPath,
+        };
+        results.push(result);
+        progress(`  → ${success ? '✓ Success' : '✗ Failed'}: ${output.slice(0, 200)}`, result);
+        // If a high-risk action fails, stop
+        if (!success && action.risk === 'high') {
+            progress(`High-risk action failed, stopping execution for safety.`);
+            break;
+        }
+        // Small delay between actions
+        await new Promise(resolve => setTimeout(resolve, 500));
+    }
+    const allSucceeded = results.length > 0 && results.every(r => r.success);
+    const successCount = results.filter(r => r.success).length;
+    const summary = `Executed ${results.length} actions: ${successCount} succeeded, ${results.length - successCount} failed`;
+    return { results, allSucceeded, summary };
+}
+function formatExecuteResults(results) {
+    return results.map((r, i) => {
+        const status = r.success ? '✓' : '✗';
+        return `${status} Step ${i + 1}: ${r.action.description}
+  Command: ${r.action.command}
+  Output: ${r.output.slice(0, 300)}${r.error ? `\n  Error: ${r.error}` : ''}${r.backupPath ? `\n  Backup: ${r.backupPath}` : ''}`;
+    }).join('\n\n');
+}
+//# sourceMappingURL=execute.js.map

package/dist/execute.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const http = __importStar(require("http"));
+const server_1 = require("./server");
+// Find a free port
+async function findFreePort(start = 7357) {
+    return new Promise((resolve) => {
+        const server = http.createServer();
+        server.listen(start, '127.0.0.1', () => {
+            const port = server.address().port;
+            server.close(() => resolve(port));
+        });
+        server.on('error', () => {
+            resolve(findFreePort(start + 1));
+        });
+    });
+}
+async function openBrowser(url) {
+    const { exec } = await Promise.resolve().then(() => __importStar(require('child_process')));
+    const { promisify } = await Promise.resolve().then(() => __importStar(require('util')));
+    const execAsync = promisify(exec);
+    const platform = process.platform;
+    let cmd;
+    if (platform === 'darwin') {
+        cmd = `open "${url}"`;
+    }
+    else if (platform === 'win32') {
+        cmd = `start "" "${url}"`;
+    }
+    else {
+        cmd = `xdg-open "${url}"`;
+    }
+    try {
+        await execAsync(cmd);
+    }
+    catch {
+        console.log(`Please open your browser to: ${url}`);
+    }
+}
+async function main() {
+    const dryRun = process.argv.includes('--dry-run');
+    const noOpen = process.argv.includes('--no-open');
+    const mockIdx = process.argv.indexOf('--mock');
+    const mockScenario = mockIdx !== -1 ? process.argv[mockIdx + 1] : undefined;
+    const portIdx = process.argv.indexOf('--port');
+    const requestedPort = portIdx !== -1 ? parseInt(process.argv[portIdx + 1], 10) : undefined;
+    if (mockScenario) {
+        console.log(`🧪 MOCK mode: using scenario "${mockScenario}"\n`);
+        global.__clawaid_mock = mockScenario;
+    }
+    console.log('\n🩺 ClawAid\n');
+    if (dryRun)
+        console.log('⚠️  DRY-RUN mode: fixes will NOT be executed\n');
+    console.log('Finding available port...');
+    // Export dry-run flag so server can access it
+    global.__clawaid_dry_run = dryRun;
+    const port = requestedPort || await findFreePort(7357);
+    const url = `http://127.0.0.1:${port}`;
+    console.log('Starting diagnostic server...');
+    await (0, server_1.createServer)(port);
+    console.log(`\n✓ Server running at ${url}`);
+    if (!noOpen) {
+        console.log('Opening browser...\n');
+        await new Promise(resolve => setTimeout(resolve, 300));
+        await openBrowser(url);
+    }
+    else {
+        console.log('Browser auto-open disabled (--no-open)\n');
+    }
+    console.log('ClawAid is running. Press Ctrl+C to stop.\n');
+    // Keep process alive
+    process.on('SIGINT', () => {
+        console.log('\nShutting down ClawAid...');
+        process.exit(0);
+    });
+}
+main().catch((err) => {
+    console.error('Failed to start ClawAid:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/loop.d.ts

@@ -0,0 +1,43 @@
+import { ObservationResult } from './observe';
+import { DiagnosisResult } from './diagnose';
+export type LoopState = 'idle' | 'observing' | 'diagnosing' | 'showing_options' | 'auto_executing' | 'executing' | 'verifying' | 'fixed' | 'not_fixed' | 'healthy' | 'needs_api_key' | 'error';
+export interface LoopEvent {
+    type: 'state_change' | 'progress' | 'diagnosis' | 'action_result' | 'verify_result' | 'request_input' | 'complete' | 'error';
+    data: unknown;
+}
+export type EventCallback = (event: LoopEvent) => void;
+export interface LoopContext {
+    apiKey: string;
+    originalObservation?: ObservationResult;
+    originalObservationText?: string;
+    currentDiagnosis?: DiagnosisResult;
+    attemptHistory: string[];
+    roundNumber: number;
+}
+export declare class DoctorLoop {
+    private callback;
+    private context;
+    private state;
+    private stopped;
+    constructor(callback: EventCallback, apiKey?: string);
+    setApiKey(key: string): void;
+    stop(): void;
+    private emit;
+    private setState;
+    private progress;
+    start(): Promise<void>;
+    provideInput(field: string, value: string): Promise<void>;
+    private runMainLoop;
+    /**
+     * Called when user clicks "Fix" on an option card.
+     * optionId: "A", "B", "C" — if omitted, use the recommended option.
+     */
+    startFix(optionId?: string): Promise<void>;
+    /**
+     * Continue with round 2 or 3 after a failed fix attempt.
+     */
+    private continueAfterFailure;
+    private executeOption;
+    private buildDiagnosticReport;
+}
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAY,eAAe,EAA+B,MAAM,YAAY,CAAC;AAIpF,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,OAAO,GACP,WAAW,GACX,SAAS,GACT,eAAe,GACf,OAAO,CAAC;AAEZ,MAAM,WAAW,SAAS;IACxB,IAAI,EACA,cAAc,GACd,UAAU,GACV,WAAW,GACX,eAAe,GACf,eAAe,GACf,eAAe,GACf,UAAU,GACV,OAAO,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAK;IAShD,SAAS,CAAC,GAAG,EAAE,MAAM;IAIrB,IAAI;IAIJ,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,QAAQ;IAIV,KAAK;IAwBL,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;YAQjC,WAAW;IAiEzB;;;OAGG;IACG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM;IAkChC;;OAEG;YACW,oBAAoB;YA4FpB,aAAa;IAwE3B,OAAO,CAAC,qBAAqB;CAqB9B"}

package/dist/loop.js

@@ -0,0 +1,316 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DoctorLoop = void 0;
+const observe_1 = require("./observe");
+const diagnose_1 = require("./diagnose");
+const execute_1 = require("./execute");
+const verify_1 = require("./verify");
+class DoctorLoop {
+    constructor(callback, apiKey = '') {
+        this.state = 'idle';
+        this.stopped = false;
+        this.callback = callback;
+        this.context = {
+            apiKey,
+            attemptHistory: [],
+            roundNumber: 0,
+        };
+    }
+    setApiKey(key) {
+        this.context.apiKey = key;
+    }
+    stop() {
+        this.stopped = true;
+    }
+    emit(event) {
+        this.callback(event);
+    }
+    setState(state) {
+        this.state = state;
+        this.emit({ type: 'state_change', data: { state } });
+    }
+    progress(msg) {
+        this.emit({ type: 'progress', data: { message: msg } });
+    }
+    async start() {
+        // Check for API key first
+        const autoKey = (0, diagnose_1.extractApiKey)();
+        if (autoKey) {
+            this.context.apiKey = autoKey;
+            this.progress('Found OpenRouter API key in OpenClaw config ✓');
+        }
+        else if (!this.context.apiKey) {
+            this.setState('needs_api_key');
+            this.emit({
+                type: 'request_input',
+                data: {
+                    field: 'apiKey',
+                    label: 'OpenRouter API Key',
+                    placeholder: 'sk-or-...',
+                    hint: '🔒 Local only. Not stored. Only sent to OpenRouter for AI diagnosis.',
+                    instructions: 'ClawAid needs an OpenRouter API key to call Claude for diagnosis. Your existing OpenClaw config does not have an OpenRouter key.',
+                }
+            });
+            return; // Wait for user to provide key via provideInput()
+        }
+        await this.runMainLoop();
+    }
+    async provideInput(field, value) {
+        if (field === 'apiKey') {
+            this.context.apiKey = value;
+            this.progress('API key received, starting diagnosis...');
+            await this.runMainLoop();
+        }
+    }
+    async runMainLoop() {
+        // ── Round 1: Observe + Diagnose ──────────────────────────────────────────
+        this.setState('observing');
+        this.progress('🔍 Gathering system information...');
+        const mockScenario = global.__clawaid_mock;
+        const observation = mockScenario
+            ? (0, observe_1.loadMockObservation)(mockScenario)
+            : await (0, observe_1.observe)((msg) => this.progress(msg));
+        this.context.originalObservation = observation;
+        this.context.originalObservationText = (0, observe_1.formatObservation)(observation);
+        this.progress('✓ System scan complete');
+        this.progress('📡 Sending data to AI for analysis...');
+        this.setState('diagnosing');
+        this.progress('🤔 AI is analyzing your system...');
+        try {
+            const diagnosis = await (0, diagnose_1.diagnose)({
+                apiKey: this.context.apiKey,
+                observationData: this.context.originalObservationText,
+            });
+            this.context.currentDiagnosis = diagnosis;
+            // Healthy?
+            if (diagnosis.healthy && diagnosis.options.length === 0) {
+                this.progress('✅ ' + (diagnosis.diagnosis || 'OpenClaw is running normally. No issues detected.'));
+                this.setState('healthy');
+                this.emit({
+                    type: 'complete',
+                    data: { fixed: false, healthy: true, explanation: diagnosis.diagnosis, warnings: diagnosis.warnings || [], reasoning: diagnosis.reasoning || [] },
+                });
+                return;
+            }
+            this.emit({
+                type: 'diagnosis',
+                data: {
+                    diagnosis: diagnosis.diagnosis,
+                    confidence: diagnosis.confidence,
+                    rootCause: diagnosis.rootCause,
+                    reasoning: diagnosis.reasoning || [],
+                    warnings: diagnosis.warnings || [],
+                    options: diagnosis.options,
+                    alternativeHypotheses: diagnosis.alternativeHypotheses,
+                    round: 1,
+                }
+            });
+            // Always show options to user and wait for their choice
+            this.setState('showing_options');
+            return; // Resumes via startFix(optionId)
+        }
+        catch (err) {
+            this.progress(`❌ AI analysis failed: ${err.message}`);
+            this.setState('error');
+            this.emit({ type: 'error', data: { message: err.message } });
+            return;
+        }
+        // Auto-fix failed → round 2 with updated observation
+        await this.continueAfterFailure(2);
+    }
+    /**
+     * Called when user clicks "Fix" on an option card.
+     * optionId: "A", "B", "C" — if omitted, use the recommended option.
+     */
+    async startFix(optionId) {
+        if (!this.context.currentDiagnosis) {
+            this.progress('No diagnosis available. Please restart.');
+            return;
+        }
+        const options = this.context.currentDiagnosis.options;
+        let chosen;
+        if (optionId) {
+            chosen = options.find(o => o.id === optionId);
+        }
+        if (!chosen) {
+            chosen = options.find(o => o.recommended) || options[0];
+        }
+        if (!chosen) {
+            this.progress('⚠️ No option found to execute.');
+            return;
+        }
+        this.context.roundNumber = 1;
+        const fixed = await this.executeOption(chosen);
+        if (fixed) {
+            this.setState('fixed');
+            this.emit({ type: 'complete', data: { fixed: true, explanation: 'OpenClaw has been successfully repaired!' } });
+            return;
+        }
+        // Not fixed after round 1 user choice → round 2
+        await this.continueAfterFailure(2);
+    }
+    /**
+     * Continue with round 2 or 3 after a failed fix attempt.
+     */
+    async continueAfterFailure(round) {
+        if (this.stopped)
+            return;
+        // Round 3: give up
+        if (round > 3) {
+            this.setState('not_fixed');
+            this.progress('\n😔 After 3 repair rounds, the issue persists.');
+            this.emit({
+                type: 'complete',
+                data: {
+                    fixed: false,
+                    explanation: 'The issue could not be automatically resolved after 3 attempts.',
+                    diagnosticReport: this.buildDiagnosticReport(),
+                }
+            });
+            return;
+        }
+        // Re-observe
+        this.setState('observing');
+        this.progress(`\n🔄 Round ${round}: Re-scanning system...`);
+        const mockScenario = global.__clawaid_mock;
+        let currentObsText;
+        try {
+            const currentObs = mockScenario
+                ? (0, observe_1.loadMockObservation)(mockScenario)
+                : await (0, observe_1.observe)((msg) => this.progress(msg));
+            currentObsText = (0, observe_1.formatObservation)(currentObs);
+        }
+        catch (err) {
+            this.progress(`Observation error: ${err.message}`);
+            currentObsText = this.context.originalObservationText || '';
+        }
+        // Re-diagnose
+        this.setState('diagnosing');
+        this.progress('🤔 AI is re-analyzing with attempt history...');
+        try {
+            const newDiagnosis = await (0, diagnose_1.diagnose)({
+                apiKey: this.context.apiKey,
+                observationData: currentObsText,
+                previousAttempts: this.context.attemptHistory,
+                round,
+            });
+            this.context.currentDiagnosis = newDiagnosis;
+            if (newDiagnosis.healthy && newDiagnosis.options.length === 0) {
+                this.progress('✅ ' + (newDiagnosis.diagnosis || 'OpenClaw is running normally. No issues detected.'));
+                this.setState('healthy');
+                this.emit({ type: 'complete', data: { fixed: false, healthy: true, explanation: newDiagnosis.diagnosis, warnings: newDiagnosis.warnings || [], reasoning: newDiagnosis.reasoning || [] } });
+                return;
+            }
+            this.emit({
+                type: 'diagnosis',
+                data: {
+                    diagnosis: newDiagnosis.diagnosis,
+                    confidence: newDiagnosis.confidence,
+                    rootCause: newDiagnosis.rootCause,
+                    reasoning: newDiagnosis.reasoning || [],
+                    options: newDiagnosis.options,
+                    alternativeHypotheses: newDiagnosis.alternativeHypotheses,
+                    round,
+                }
+            });
+            // Round 3 = give up, just show report
+            if (round === 3) {
+                this.setState('not_fixed');
+                this.emit({
+                    type: 'complete',
+                    data: {
+                        fixed: false,
+                        explanation: 'The issue could not be automatically resolved after 3 attempts.',
+                        diagnosticReport: this.buildDiagnosticReport(),
+                    }
+                });
+                return;
+            }
+            // Always show options to user and wait for their choice
+            this.setState('showing_options');
+            this.context.roundNumber = round;
+        }
+        catch (err) {
+            this.progress(`❌ AI analysis failed: ${err.message}`);
+            this.setState('error');
+            this.emit({ type: 'error', data: { message: err.message } });
+        }
+    }
+    async executeOption(option) {
+        if (option.steps.length === 0) {
+            this.progress('⚠️ No steps in this option.');
+            return false;
+        }
+        const dryRun = Boolean(global.__clawaid_dry_run);
+        this.setState('auto_executing');
+        this.progress(`\n🔧 ${dryRun ? '[DRY-RUN] ' : ''}Executing: ${option.title} (${option.steps.length} step${option.steps.length > 1 ? 's' : ''})...`);
+        const executeResult = await (0, execute_1.executeActions)(option.steps, (msg, result) => {
+            this.progress(msg);
+            if (result) {
+                this.emit({ type: 'action_result', data: result });
+            }
+        }, dryRun);
+        // Record this attempt
+        const attemptSummary = `
+### Attempt ${this.context.roundNumber + 1} — Option ${option.id}: ${option.title}
+Diagnosis: ${this.context.currentDiagnosis?.diagnosis || ''}
+Root cause: ${this.context.currentDiagnosis?.rootCause || ''}
+Steps taken:
+${(0, execute_1.formatExecuteResults)(executeResult.results)}
+Result: ${executeResult.summary}
+`.trim();
+        this.context.attemptHistory.push(attemptSummary);
+        this.context.roundNumber++;
+        // In dry-run mode, skip verification
+        if (dryRun) {
+            this.progress('\n⚠️ DRY-RUN: Skipping verification (nothing was executed).');
+            this.emit({ type: 'verify_result', data: { fixed: false, explanation: 'Dry-run mode — no changes made.' } });
+            return false;
+        }
+        // Verify
+        this.setState('verifying');
+        this.progress('\n🔍 Verifying repair...');
+        try {
+            const verifyResult = await (0, verify_1.verify)(this.context.apiKey, this.context.originalObservationText || '', executeResult.results.map(r => `${r.action.command}: ${r.output}`), (msg) => this.progress(msg));
+            this.emit({
+                type: 'verify_result',
+                data: { fixed: verifyResult.fixed, explanation: verifyResult.explanation },
+            });
+            if (verifyResult.fixed) {
+                this.progress(`\n✅ ${verifyResult.explanation}`);
+                return true;
+            }
+            else {
+                this.progress(`\n⚠️ Not yet fixed: ${verifyResult.explanation}`);
+                return false;
+            }
+        }
+        catch (err) {
+            this.progress(`Verification error: ${err.message}`);
+            return false;
+        }
+    }
+    buildDiagnosticReport() {
+        return `
+# ClawAid - Diagnostic Report
+Generated: ${new Date().toISOString()}
+
+## System State (Initial)
+${this.context.originalObservationText || 'Not captured'}
+
+## Repair Attempts (${this.context.attemptHistory.length} total)
+${this.context.attemptHistory.join('\n\n---\n\n')}
+
+## Summary
+After ${this.context.roundNumber} repair round(s), the issue was not automatically resolved.
+Please review the diagnostic data above and consult the OpenClaw community for assistance.
+
+## Resources
+- OpenClaw Discord: https://discord.gg/openclaw
+- Run manually: openclaw doctor
+- View logs: openclaw logs --follow
+`.trim();
+    }
+}
+exports.DoctorLoop = DoctorLoop;
+//# sourceMappingURL=loop.js.map