@iflow-mcp/jkheadley-instar 0.26.2

package/dist/monitoring/CoherenceMonitor.js

@@ -0,0 +1,550 @@
+/**
+ * Coherence Monitor — runtime self-awareness for agent infrastructure.
+ *
+ * Prevention stops bugs we've seen. Homeostasis stops bugs we haven't seen yet.
+ *
+ * This monitor periodically checks the agent's own state for coherence:
+ *   1. Config Coherence — do in-memory values match disk?
+ *   2. State Durability — did runtime changes survive the last restart?
+ *   3. Output Sanity — is user-facing output valid?
+ *   4. Feature Readiness — are all expected features properly configured?
+ *
+ * Where possible, it self-corrects. Where it can't, it notifies.
+ * The goal: converge toward natural self-led homeostasis.
+ *
+ * Integrates with HealthChecker via ComponentHealth results.
+ */
+import { EventEmitter } from 'node:events';
+import fs from 'node:fs';
+import path from 'node:path';
+import { ProcessIntegrity } from '../core/ProcessIntegrity.js';
+// Known-bad output patterns that should never appear in user-facing messages
+const BAD_OUTPUT_PATTERNS = [
+    { pattern: 'localhost', context: 'URL', description: 'localhost URL in remote-accessible message' },
+    { pattern: '(check your config)', context: 'PIN', description: 'placeholder text instead of actual value' },
+    { pattern: '127.0.0.1', context: 'URL', description: 'loopback address in remote-accessible message' },
+    { pattern: 'undefined', context: 'variable', description: 'literal "undefined" in user-facing text' },
+    { pattern: '[object Object]', context: 'serialization', description: 'unserialized object in output' },
+];
+export class CoherenceMonitor extends EventEmitter {
+    config;
+    interval = null;
+    lastReport = null;
+    correctionLog = [];
+    /** Track which failure signatures have already been notified (signature → timestamp ms) */
+    notifiedFailures = new Map();
+    /** Don't re-notify about the same failure within this window */
+    static NOTIFY_COOLDOWN_MS = 2 * 60 * 60 * 1000; // 2 hours
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Start periodic coherence monitoring.
+     */
+    start() {
+        if (this.interval)
+            return;
+        const intervalMs = this.config.checkIntervalMs ?? 300_000; // 5 minutes
+        // Run initial check after a delay (let everything initialize)
+        setTimeout(() => {
+            this.runCheck();
+        }, 30_000);
+        // Then run periodically
+        this.interval = setInterval(() => this.runCheck(), intervalMs);
+        this.interval.unref();
+        console.log(`[CoherenceMonitor] Started (every ${Math.round(intervalMs / 60_000)}m)`);
+    }
+    /**
+     * Stop monitoring.
+     */
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+    }
+    /**
+     * Run all coherence checks and return a report.
+     */
+    runCheck() {
+        const checks = [];
+        // Run all check categories
+        checks.push(...this.checkProcessIntegrity());
+        checks.push(...this.checkShadowInstallation());
+        checks.push(...this.checkConfigCoherence());
+        checks.push(...this.checkStateDurability());
+        checks.push(...this.checkOutputSanity());
+        checks.push(...this.checkFeatureReadiness());
+        const passed = checks.filter(c => c.passed).length;
+        const corrected = checks.filter(c => c.corrected).length;
+        const failed = checks.filter(c => !c.passed && !c.corrected).length;
+        let status;
+        if (failed > 0)
+            status = 'incoherent';
+        else if (corrected > 0)
+            status = 'corrected';
+        else
+            status = 'coherent';
+        const report = {
+            timestamp: new Date().toISOString(),
+            status,
+            checks,
+            passed,
+            failed,
+            corrected,
+        };
+        this.lastReport = report;
+        this.emit('check', report);
+        // Cooldown-based: expired entries are cleaned up rather than clearing all on coherent.
+        // This prevents flapping (coherent → incoherent → coherent) from spamming notifications.
+        const now = Date.now();
+        for (const [sig, ts] of this.notifiedFailures) {
+            if (now - ts > CoherenceMonitor.NOTIFY_COOLDOWN_MS) {
+                this.notifiedFailures.delete(sig);
+            }
+        }
+        // Log non-coherent results
+        if (status !== 'coherent') {
+            const failedChecks = checks.filter(c => !c.passed);
+            const correctedChecks = checks.filter(c => c.corrected);
+            if (correctedChecks.length > 0) {
+                console.log(`[CoherenceMonitor] Self-corrected ${correctedChecks.length} issue(s): ${correctedChecks.map(c => c.name).join(', ')}`);
+            }
+            if (failed > 0) {
+                console.warn(`[CoherenceMonitor] ${failed} incoherence(s) detected: ${failedChecks.map(c => `${c.name}: ${c.message}`).join('; ')}`);
+                // Deduplicate notifications: only notify if this failure signature hasn't been
+                // notified within the cooldown window. Prevents flapping from generating spam.
+                const failureSignature = failedChecks.map(c => c.name).sort().join(',');
+                const lastNotified = this.notifiedFailures.get(failureSignature);
+                const isNewFailure = !lastNotified || (now - lastNotified > CoherenceMonitor.NOTIFY_COOLDOWN_MS);
+                if (isNewFailure && this.config.onIncoherence) {
+                    try {
+                        this.config.onIncoherence(report);
+                        this.notifiedFailures.set(failureSignature, now);
+                    }
+                    catch (err) {
+                        console.error(`[CoherenceMonitor] Notification callback failed:`, err);
+                    }
+                }
+            }
+        }
+        // Persist report
+        this.persistReport(report);
+        return report;
+    }
+    /**
+     * Get the last coherence report.
+     */
+    getLastReport() {
+        return this.lastReport;
+    }
+    /**
+     * Get ComponentHealth for integration with HealthChecker.
+     */
+    getHealth() {
+        if (!this.lastReport) {
+            return { status: 'healthy', message: 'Not yet checked', lastCheck: new Date().toISOString() };
+        }
+        const { status, passed, failed, corrected } = this.lastReport;
+        switch (status) {
+            case 'coherent':
+                return { status: 'healthy', message: `All ${passed} checks passed`, lastCheck: this.lastReport.timestamp };
+            case 'corrected':
+                return { status: 'healthy', message: `${passed} passed, ${corrected} self-corrected`, lastCheck: this.lastReport.timestamp };
+            case 'incoherent':
+                return { status: 'degraded', message: `${failed} incoherence(s) detected`, lastCheck: this.lastReport.timestamp };
+        }
+    }
+    /**
+     * Get correction history.
+     */
+    getCorrectionLog() {
+        return [...this.correctionLog];
+    }
+    // ── Check Categories ────────────────────────────────────────────
+    /**
+     * Check 0: Process Integrity
+     * Is this process running the code it claims to be running?
+     * Detects the "stale process" bug where npm install -g updates the binary
+     * on disk but the running process still has old code in memory.
+     */
+    checkProcessIntegrity() {
+        const results = [];
+        const integrity = ProcessIntegrity.getInstance();
+        if (!integrity) {
+            // ProcessIntegrity not initialized — skip gracefully
+            return results;
+        }
+        if (integrity.versionMismatch) {
+            // If the AutoUpdater has already applied this version and a restart is pending,
+            // don't flag the mismatch — it's expected and the restart will resolve it.
+            // This prevents the CoherenceMonitor from creating noise while the AutoUpdater
+            // is deferring the restart for active sessions.
+            const autoUpdaterState = this.readAutoUpdaterState();
+            if (autoUpdaterState?.lastAppliedVersion === integrity.diskVersion) {
+                results.push({
+                    name: 'process-version-mismatch',
+                    passed: true,
+                    message: `Running v${integrity.runningVersion} — update to v${integrity.diskVersion} applied, restart pending`,
+                });
+            }
+            else {
+                results.push({
+                    name: 'process-version-mismatch',
+                    passed: false,
+                    message: `Running v${integrity.runningVersion} but disk has v${integrity.diskVersion} — restart needed`,
+                });
+            }
+        }
+        else {
+            results.push({
+                name: 'process-version-mismatch',
+                passed: true,
+                message: `Running v${integrity.runningVersion} (matches disk)`,
+            });
+        }
+        return results;
+    }
+    /**
+     * Check 0b: Shadow Installation Detection
+     * Is there a local node_modules/instar that shadows the global binary?
+     * The Luna Incident (v0.9.70): a local `npm install instar` created a shadow
+     * that prevented auto-updates from taking effect. Detect this at runtime.
+     */
+    checkShadowInstallation() {
+        const localBin = path.join(process.cwd(), 'node_modules', '.bin', 'instar');
+        const localPkg = path.join(process.cwd(), 'node_modules', 'instar', 'package.json');
+        if (fs.existsSync(localBin) || fs.existsSync(localPkg)) {
+            let localVersion = 'unknown';
+            try {
+                const pkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'node_modules', 'instar', 'package.json'), 'utf-8'));
+                localVersion = pkg.version || 'unknown';
+            }
+            catch { /* ignore */ }
+            return [{
+                    name: 'shadow-installation',
+                    passed: false,
+                    message: `Local node_modules/instar v${localVersion} shadows global binary — auto-updates won't take effect. Remove: rm -rf node_modules package.json package-lock.json`,
+                }];
+        }
+        return [{
+                name: 'shadow-installation',
+                passed: true,
+                message: 'No local shadow installation detected',
+            }];
+    }
+    /**
+     * Check 1: Config Coherence
+     * Do in-memory config values match what's on disk?
+     */
+    checkConfigCoherence() {
+        const results = [];
+        const { liveConfig, stateDir } = this.config;
+        // Check that config.json exists and is parseable
+        const configPath = path.join(stateDir, 'config.json');
+        try {
+            if (!fs.existsSync(configPath)) {
+                results.push({
+                    name: 'config-file-exists',
+                    passed: false,
+                    message: 'config.json missing from state directory',
+                });
+                return results;
+            }
+            JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            results.push({
+                name: 'config-file-valid',
+                passed: true,
+                message: 'config.json exists and is valid JSON',
+            });
+        }
+        catch (err) {
+            results.push({
+                name: 'config-file-valid',
+                passed: false,
+                message: `config.json is corrupt: ${err instanceof Error ? err.message : String(err)}`,
+            });
+            return results;
+        }
+        // Check critical dynamic values via LiveConfig
+        // autoApply should generally be true (default) — if false, verify it's intentional
+        const autoApply = liveConfig.get('updates.autoApply', true);
+        results.push({
+            name: 'config-auto-apply',
+            passed: true, // Just report the value — both true and false are valid
+            message: `updates.autoApply = ${autoApply}`,
+        });
+        return results;
+    }
+    /**
+     * Check 2: State Durability
+     * Did runtime changes survive restarts? Are state files intact?
+     */
+    checkStateDurability() {
+        const results = [];
+        const { stateDir } = this.config;
+        const stateSubDir = path.join(stateDir, 'state');
+        // Check state directory exists
+        if (!fs.existsSync(stateSubDir)) {
+            results.push({
+                name: 'state-dir-exists',
+                passed: false,
+                message: 'state/ subdirectory missing',
+                corrected: true,
+                correctionDetail: 'Created state/ directory',
+            });
+            try {
+                fs.mkdirSync(stateSubDir, { recursive: true });
+                this.logCorrection('state-dir-exists', 'Created missing state/ directory');
+            }
+            catch { /* best effort */ }
+            return results;
+        }
+        // Check auto-updater state file
+        const autoUpdaterState = path.join(stateSubDir, 'auto-updater.json');
+        if (fs.existsSync(autoUpdaterState)) {
+            try {
+                const data = JSON.parse(fs.readFileSync(autoUpdaterState, 'utf-8'));
+                const hasSavedAt = typeof data.savedAt === 'string';
+                results.push({
+                    name: 'state-auto-updater',
+                    passed: hasSavedAt,
+                    message: hasSavedAt ? `Auto-updater state persisted (saved: ${data.savedAt})` : 'Auto-updater state file corrupt',
+                });
+            }
+            catch {
+                results.push({
+                    name: 'state-auto-updater',
+                    passed: false,
+                    message: 'Auto-updater state file corrupt',
+                });
+            }
+        }
+        // Check topic-session registry
+        const registryPath = path.join(stateDir, 'topic-session-registry.json');
+        if (fs.existsSync(registryPath)) {
+            try {
+                const data = JSON.parse(fs.readFileSync(registryPath, 'utf-8'));
+                const topicCount = Array.isArray(data.topics) ? data.topics.length : Object.keys(data).length;
+                results.push({
+                    name: 'state-topic-registry',
+                    passed: true,
+                    message: `Topic registry intact (${topicCount} entries)`,
+                });
+            }
+            catch {
+                results.push({
+                    name: 'state-topic-registry',
+                    passed: false,
+                    message: 'Topic registry corrupt',
+                });
+            }
+        }
+        // Check memory thresholds persistence
+        const thresholdsPath = path.join(stateSubDir, 'memory-thresholds.json');
+        if (fs.existsSync(thresholdsPath)) {
+            try {
+                const data = JSON.parse(fs.readFileSync(thresholdsPath, 'utf-8'));
+                const valid = typeof data.warning === 'number' && typeof data.elevated === 'number' && typeof data.critical === 'number';
+                results.push({
+                    name: 'state-memory-thresholds',
+                    passed: valid,
+                    message: valid
+                        ? `Thresholds persisted: warning=${data.warning}%, elevated=${data.elevated}%, critical=${data.critical}%`
+                        : 'Threshold file exists but values are invalid',
+                });
+            }
+            catch {
+                results.push({
+                    name: 'state-memory-thresholds',
+                    passed: false,
+                    message: 'Memory thresholds file corrupt',
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Check 3: Output Sanity
+     * Scan recent agent messages for known-bad patterns.
+     */
+    checkOutputSanity() {
+        const results = [];
+        const { stateDir } = this.config;
+        // Scan last 50 agent messages from the JSONL log
+        const logPath = path.join(stateDir, 'telegram-messages.jsonl');
+        if (!fs.existsSync(logPath)) {
+            results.push({
+                name: 'output-sanity',
+                passed: true,
+                message: 'No message log to check (new agent)',
+            });
+            return results;
+        }
+        try {
+            const lines = fs.readFileSync(logPath, 'utf-8').trim().split('\n');
+            // Check last 50 agent messages (fromUser: false)
+            const agentMessages = [];
+            for (let i = lines.length - 1; i >= 0 && agentMessages.length < 50; i--) {
+                try {
+                    const entry = JSON.parse(lines[i]);
+                    if (!entry.fromUser && entry.text) {
+                        agentMessages.push({ text: entry.text, timestamp: entry.timestamp });
+                    }
+                }
+                catch { /* skip malformed lines */ }
+            }
+            const violations = [];
+            for (const msg of agentMessages) {
+                for (const bad of BAD_OUTPUT_PATTERNS) {
+                    if (msg.text.includes(bad.pattern)) {
+                        // Exception: localhost in "locally at" phrasing is intentional
+                        if (bad.pattern === 'localhost' && msg.text.includes('locally at'))
+                            continue;
+                        // Exception: localhost in code blocks or instructions
+                        if (bad.pattern === 'localhost' && (msg.text.includes('```') || msg.text.includes('curl')))
+                            continue;
+                        violations.push(`"${bad.pattern}" found in agent message (${bad.description})`);
+                    }
+                }
+            }
+            if (violations.length === 0) {
+                results.push({
+                    name: 'output-sanity',
+                    passed: true,
+                    message: `Last ${agentMessages.length} agent messages clean`,
+                });
+            }
+            else {
+                // Deduplicate violations
+                const unique = [...new Set(violations)];
+                results.push({
+                    name: 'output-sanity',
+                    passed: false,
+                    message: `${unique.length} bad pattern(s) in recent output: ${unique.join('; ')}`,
+                });
+            }
+        }
+        catch (err) {
+            results.push({
+                name: 'output-sanity',
+                passed: false,
+                message: `Failed to scan message log: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+        return results;
+    }
+    /**
+     * Check 4: Feature Readiness
+     * Verify features that should be configured actually are.
+     */
+    checkFeatureReadiness() {
+        const results = [];
+        const { liveConfig, stateDir } = this.config;
+        // If a dashboard topic is registered, PIN should exist
+        try {
+            const stateFile = path.join(stateDir, 'state', 'kv.json');
+            let dashboardTopicExists = false;
+            if (fs.existsSync(stateFile)) {
+                const state = JSON.parse(fs.readFileSync(stateFile, 'utf-8'));
+                dashboardTopicExists = typeof state['dashboard-topic'] === 'number' && state['dashboard-topic'] > 0;
+            }
+            if (dashboardTopicExists) {
+                const pin = liveConfig.get('dashboardPin', '');
+                if (pin) {
+                    results.push({
+                        name: 'readiness-dashboard-pin',
+                        passed: true,
+                        message: 'Dashboard PIN configured',
+                    });
+                }
+                else {
+                    // Self-correct: generate a PIN
+                    const newPin = String(Math.floor(100000 + Math.random() * 900000));
+                    liveConfig.set('dashboardPin', newPin);
+                    results.push({
+                        name: 'readiness-dashboard-pin',
+                        passed: false,
+                        message: 'Dashboard PIN was missing',
+                        corrected: true,
+                        correctionDetail: `Generated PIN: ${newPin}`,
+                    });
+                    this.logCorrection('readiness-dashboard-pin', `Generated missing dashboard PIN: ${newPin}`);
+                }
+            }
+        }
+        catch {
+            // Can't check — not critical
+        }
+        // If Telegram is configured, check that messaging config has a token
+        try {
+            const messaging = liveConfig.get('messaging', []);
+            const telegramConfig = messaging.find(m => m.type === 'telegram');
+            if (telegramConfig) {
+                const hasToken = typeof telegramConfig.config?.token === 'string' && telegramConfig.config.token.length > 0;
+                results.push({
+                    name: 'readiness-telegram-token',
+                    passed: hasToken,
+                    message: hasToken ? 'Telegram bot token configured' : 'Telegram configured but token missing',
+                });
+            }
+        }
+        catch {
+            // Can't check — not critical
+        }
+        // Check that authToken exists (needed for API security)
+        const authToken = liveConfig.get('authToken', '');
+        if (authToken) {
+            results.push({
+                name: 'readiness-auth-token',
+                passed: true,
+                message: 'Auth token configured',
+            });
+        }
+        else {
+            results.push({
+                name: 'readiness-auth-token',
+                passed: false,
+                message: 'No auth token — API is unauthenticated',
+            });
+        }
+        return results;
+    }
+    // ── Internal ────────────────────────────────────────────────────
+    /** Read the AutoUpdater state file to check if a restart is already pending. */
+    readAutoUpdaterState() {
+        try {
+            const statePath = path.join(this.config.stateDir, 'state', 'auto-updater.json');
+            if (!fs.existsSync(statePath))
+                return null;
+            return JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    logCorrection(check, detail) {
+        this.correctionLog.push({
+            timestamp: new Date().toISOString(),
+            check,
+            detail,
+        });
+        // Keep last 100 corrections
+        if (this.correctionLog.length > 100) {
+            this.correctionLog = this.correctionLog.slice(-100);
+        }
+    }
+    persistReport(report) {
+        try {
+            const reportDir = path.join(this.config.stateDir, 'state');
+            fs.mkdirSync(reportDir, { recursive: true });
+            const reportPath = path.join(reportDir, 'coherence-report.json');
+            fs.writeFileSync(reportPath, JSON.stringify(report, null, 2) + '\n');
+        }
+        catch {
+            // @silent-fallback-ok — report persistence is nice-to-have
+        }
+    }
+}
+//# sourceMappingURL=CoherenceMonitor.js.map

package/dist/monitoring/CoherenceMonitor.js.map

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

package/dist/monitoring/CommitmentSentinel.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Commitment Sentinel — LLM-powered scanner that detects unregistered commitments.
+ *
+ * Periodically scans Telegram topic messages to find commitments the agent
+ * made but didn't register via the CommitmentTracker API. Closes the gap
+ * between "the agent said it would" and "the system knows about it."
+ *
+ * Uses IntelligenceProvider (Haiku by default) for lightweight scanning.
+ * Tracks a high-water mark per topic so it only reads new messages each cycle.
+ *
+ * This is the "trust but verify" layer — instead of brittle string matching,
+ * an LLM reads the conversation and understands intent.
+ */
+import type { IntelligenceProvider } from '../core/types.js';
+import type { CommitmentTracker } from './CommitmentTracker.js';
+export interface CommitmentSentinelConfig {
+    /** State directory (.instar/) */
+    stateDir: string;
+    /** LLM provider for scanning */
+    intelligence: IntelligenceProvider;
+    /** CommitmentTracker to register detected commitments */
+    commitmentTracker: CommitmentTracker;
+    /** Scan interval in ms. Default: 300_000 (5 minutes) */
+    scanIntervalMs?: number;
+    /** Maximum messages to scan per topic per cycle. Default: 20 */
+    maxMessagesPerScan?: number;
+}
+export declare class CommitmentSentinel {
+    private config;
+    private scanState;
+    private scanStatePath;
+    private messagesPath;
+    private interval;
+    private isScanning;
+    constructor(config: CommitmentSentinelConfig);
+    start(): void;
+    stop(): void;
+    /**
+     * Scan recent messages for unregistered commitments.
+     */
+    scan(): Promise<number>;
+    /**
+     * Read messages newer than the high-water mark from the JSONL log.
+     */
+    private readNewMessages;
+    /**
+     * Extract user→agent conversation pairs from messages.
+     */
+    private extractConversationPairs;
+    /**
+     * Ask the LLM to detect commitments in conversation pairs.
+     */
+    private detectCommitments;
+    private loadScanState;
+    private saveScanState;
+}
+//# sourceMappingURL=CommitmentSentinel.d.ts.map

package/dist/monitoring/CommitmentSentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommitmentSentinel.d.ts","sourceRoot":"","sources":["../../src/monitoring/CommitmentSentinel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,wBAAwB,CAAC;AAKhF,MAAM,WAAW,wBAAwB;IACvC,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,YAAY,EAAE,oBAAoB,CAAC;IACnC,yDAAyD;IACzD,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA6BD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,wBAAwB;IAS5C,KAAK,IAAI,IAAI;IAcb,IAAI,IAAI,IAAI;IASZ;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IA6E7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAsCvB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAiBhC;;OAEG;YACW,iBAAiB;IAgE/B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,aAAa;CAWtB"}