thuban 0.3.1 → 0.3.3

package/packages/scanner/health-checker.js

@@ -1,586 +1,586 @@
-/**
- * Health Checker
- *
- * @purpose Event-driven HealthChecker component
- * @module sentinel
- * @layer application
- * @imports-from fs, path, events
- * @exports-to sentinel
- * @side-effects File system reads, Console output, Event emission
- * @critical-for sentinel
- */
-
-/**
- * Sentinel Health Checker
- *
- * Monitors the health of all Orion systems.
- * Checks: Senate, Citadel, Forge, OCEE, Handoff, Shadow Realm, Knowledge
- */
-
-const fs = require('fs');
-const path = require('path');
-const EventEmitter = require('events');
-
-class HealthChecker extends EventEmitter {
-  constructor(config = {}) {
-    super();
-
-    this.config = {
-      rootPath: config.rootPath || process.cwd(),
-      serverPath: config.serverPath || path.join(config.rootPath || process.cwd(), 'server'),
-      checkTimeout: config.checkTimeout || 5000,
-      ...config
-    };
-
-    // Define system health checks
-    this.systemChecks = [
-      {
-        id: 'senate',
-        name: 'Senate',
-        description: 'Multi-model orchestration',
-        check: () => this._checkSenate()
-      },
-      {
-        id: 'citadel',
-        name: 'Citadel',
-        description: '5-layer safety system',
-        check: () => this._checkCitadel()
-      },
-      {
-        id: 'forge',
-        name: 'Forge',
-        description: 'Build system',
-        check: () => this._checkForge()
-      },
-      {
-        id: 'ocee',
-        name: 'OCEE',
-        description: 'Orchestrated continuous execution',
-        check: () => this._checkOCEE()
-      },
-      {
-        id: 'handoff',
-        name: 'Handoff',
-        description: 'Human-AI collaboration',
-        check: () => this._checkHandoff()
-      },
-      {
-        id: 'shadow_realm',
-        name: 'Shadow Realm',
-        description: 'Validation sandbox',
-        check: () => this._checkShadowRealm()
-      },
-      {
-        id: 'knowledge',
-        name: 'Knowledge Manager',
-        description: 'Build tracking and learning',
-        check: () => this._checkKnowledge()
-      },
-      {
-        id: 'server',
-        name: 'Express Server',
-        description: 'API server health',
-        check: () => this._checkServer()
-      }
-    ];
-  }
-
-  /**
-   * Check health of all systems
-   */
-  async checkAll() {
-    console.log('[HEALTH-CHECKER] Running full health check...');
-    const startTime = Date.now();
-
-    const result = {
-      timestamp: new Date().toISOString(),
-      duration: 0,
-      overall: 'healthy',
-      systems: [],
-      healthySystems: [],
-      unhealthySystems: [],
-      summary: {}
-    };
-
-    for (const systemCheck of this.systemChecks) {
-      try {
-        const checkResult = await Promise.race([
-          systemCheck.check(),
-          this._timeout(this.config.checkTimeout)
-        ]);
-
-        const systemResult = {
-          id: systemCheck.id,
-          name: systemCheck.name,
-          description: systemCheck.description,
-          status: checkResult.healthy ? 'healthy' : 'unhealthy',
-          healthy: checkResult.healthy,
-          details: checkResult.details || {},
-          issues: checkResult.issues || [],
-          lastChecked: new Date().toISOString()
-        };
-
-        result.systems.push(systemResult);
-
-        if (systemResult.healthy) {
-          result.healthySystems.push(systemCheck.id);
-        } else {
-          result.unhealthySystems.push(systemCheck.id);
-        }
-      } catch (error) {
-        result.systems.push({
-          id: systemCheck.id,
-          name: systemCheck.name,
-          description: systemCheck.description,
-          status: 'error',
-          healthy: false,
-          error: error.message,
-          lastChecked: new Date().toISOString()
-        });
-        result.unhealthySystems.push(systemCheck.id);
-      }
-    }
-
-    // Determine overall health
-    if (result.unhealthySystems.length === 0) {
-      result.overall = 'healthy';
-    } else if (result.unhealthySystems.length <= 2) {
-      result.overall = 'degraded';
-    } else {
-      result.overall = 'unhealthy';
-    }
-
-    result.duration = Date.now() - startTime;
-    result.summary = {
-      total: this.systemChecks.length,
-      healthy: result.healthySystems.length,
-      unhealthy: result.unhealthySystems.length
-    };
-
-    console.log(`[HEALTH-CHECKER] Health check complete: ${result.overall} (${result.summary.healthy}/${result.summary.total} systems healthy)`);
-    this.emit('checkComplete', result);
-
-    return result;
-  }
-
-  /**
-   * Check health of a specific system
-   */
-  async checkSystem(systemId) {
-    const systemCheck = this.systemChecks.find(s => s.id === systemId);
-    if (!systemCheck) {
-      return { error: `Unknown system: ${systemId}` };
-    }
-
-    try {
-      const result = await systemCheck.check();
-      return {
-        id: systemCheck.id,
-        name: systemCheck.name,
-        ...result,
-        lastChecked: new Date().toISOString()
-      };
-    } catch (error) {
-      return {
-        id: systemCheck.id,
-        name: systemCheck.name,
-        healthy: false,
-        error: error.message,
-        lastChecked: new Date().toISOString()
-      };
-    }
-  }
-
-  /**
-   * Get list of available system checks
-   */
-  getAvailableChecks() {
-    return this.systemChecks.map(s => ({
-      id: s.id,
-      name: s.name,
-      description: s.description
-    }));
-  }
-
-  // Individual system checks
-
-  async _checkSenate() {
-    const result = {
-      healthy: true,
-      details: {},
-      issues: []
-    };
-
-    try {
-      // Check if senate files exist
-      const senateFiles = [
-        path.join(this.config.serverPath, 'senate.js'),
-        path.join(this.config.serverPath, 'senate-v2.js'),
-        path.join(this.config.serverPath, 'data', 'model-registry.json'),
-        path.join(this.config.serverPath, 'data', 'senate-weights-v2.json')
-      ];
-
-      let filesFound = 0;
-      for (const file of senateFiles) {
-        if (fs.existsSync(file)) {
-          filesFound++;
-        }
-      }
-
-      result.details.filesFound = filesFound;
-      result.details.totalFiles = senateFiles.length;
-
-      // Check model registry
-      const registryPath = path.join(this.config.serverPath, 'data', 'model-registry.json');
-      if (fs.existsSync(registryPath)) {
-        const registry = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
-        result.details.providersConfigured = Object.keys(registry.providers || {}).length;
-        result.details.modelsRegistered = Object.values(registry.providers || {})
-          .reduce((sum, p) => sum + (p.models?.length || 0), 0);
-      }
-
-      if (filesFound < 2) {
-        result.healthy = false;
-        result.issues.push('Core Senate files missing');
-      }
-
-    } catch (error) {
-      result.healthy = false;
-      result.issues.push(`Senate check failed: ${error.message}`);
-    }
-
-    return result;
-  }
-
-  async _checkCitadel() {
-    const result = {
-      healthy: true,
-      details: {},
-      issues: []
-    };
-
-    try {
-      // Check if citadel files exist
-      const citadelPath = path.join(this.config.rootPath, 'citadel');
-      const citadelFiles = [
-        'enforcer.js',
-        'watchers.js',
-        'constitution-loader.js',
-        'file-guard.js'
-      ];
-
-      let filesFound = 0;
-      for (const file of citadelFiles) {
-        if (fs.existsSync(path.join(citadelPath, file))) {
-          filesFound++;
-        }
-      }
-
-      result.details.filesFound = filesFound;
-      result.details.totalFiles = citadelFiles.length;
-
-      // Check audit logs
-      const auditPath = path.join(citadelPath, 'audit');
-      if (fs.existsSync(auditPath)) {
-        const auditFiles = fs.readdirSync(auditPath).filter(f => f.endsWith('.json'));
-        result.details.auditFilesCount = auditFiles.length;
-
-        // Check most recent audit
-        if (auditFiles.length > 0) {
-          const latestAudit = auditFiles.sort().pop();
-          const latestPath = path.join(auditPath, latestAudit);
-          const auditStat = fs.statSync(latestPath);
-          result.details.lastAudit = auditStat.mtime.toISOString();
-
-          // Warn if no audit in 24 hours
-          const hoursSinceAudit = (Date.now() - auditStat.mtime.getTime()) / (1000 * 60 * 60);
-          if (hoursSinceAudit > 24) {
-            result.issues.push(`No audit activity in ${Math.round(hoursSinceAudit)} hours`);
-          }
-        }
-      }
-
-      if (filesFound < 3) {
-        result.healthy = false;
-        result.issues.push('Core Citadel files missing');
-      }
-
-    } catch (error) {
-      result.healthy = false;
-      result.issues.push(`Citadel check failed: ${error.message}`);
-    }
-
-    return result;
-  }
-
-  async _checkForge() {
-    const result = {
-      healthy: true,
-      details: {},
-      issues: []
-    };
-
-    try {
-      const forgePath = path.join(this.config.rootPath, 'forge');
-      const forgeFiles = [
-        'forge-core.js',
-        'task-decomposer.js',
-        'intent-matcher.js',
-        'diagnostician-v2.js',
-        'prescriber.js',
-        'forge-loop.js'
-      ];
-
-      let filesFound = 0;
-      for (const file of forgeFiles) {
-        if (fs.existsSync(path.join(forgePath, file))) {
-          filesFound++;
-        }
-      }
-
-      result.details.filesFound = filesFound;
-      result.details.totalFiles = forgeFiles.length;
-      result.details.completeness = Math.round((filesFound / forgeFiles.length) * 100) + '%';
-
-      if (filesFound < 4) {
-        result.healthy = false;
-        result.issues.push('Core Forge components missing');
-      }
-
-    } catch (error) {
-      result.healthy = false;
-      result.issues.push(`Forge check failed: ${error.message}`);
-    }
-
-    return result;
-  }
-
-  async _checkOCEE() {
-    const result = {
-      healthy: true,
-      details: {},
-      issues: []
-    };
-
-    try {
-      const oceePath = path.join(this.config.serverPath, 'ocee');
-      const oceeFiles = [
-        'ocee-core.js',
-        'persistent-task-queue.js',
-        'checkpoint-manager.js',
-        'build-session-manager.js',
-        'build-graph-generator.js'
-      ];
-
-      let filesFound = 0;
-      for (const file of oceeFiles) {
-        if (fs.existsSync(path.join(oceePath, file))) {
-          filesFound++;
-        }
-      }
-
-      result.details.filesFound = filesFound;
-      result.details.totalFiles = oceeFiles.length;
-
-      // Check for active tasks
-      const taskQueuePath = path.join(oceePath, 'queue');
-      if (fs.existsSync(taskQueuePath)) {
-        try {
-          const queueFiles = fs.readdirSync(taskQueuePath);
-          result.details.pendingTasks = queueFiles.length;
-        } catch (e) {
-          result.details.pendingTasks = 'unknown';
-        }
-      }
-
-      if (filesFound < 3) {
-        result.healthy = false;
-        result.issues.push('Core OCEE components missing');
-      }
-
-    } catch (error) {
-      result.healthy = false;
-      result.issues.push(`OCEE check failed: ${error.message}`);
-    }
-
-    return result;
-  }
-
-  async _checkHandoff() {
-    const result = {
-      healthy: true,
-      details: {},
-      issues: []
-    };
-
-    try {
-      const handoffPath = path.join(this.config.serverPath, 'handoff');
-      const handoffFiles = [
-        'index.js',
-        'risk-scorer.js',
-        'gate-checker.js',
-        'mission-state.js',
-        'audit-logger.js',
-        'evidence-bundle.js',
-        'cost-tracker.js'
-      ];
-
-      let filesFound = 0;
-      for (const file of handoffFiles) {
-        if (fs.existsSync(path.join(handoffPath, file))) {
-          filesFound++;
-        }
-      }
-
-      result.details.filesFound = filesFound;
-      result.details.totalFiles = handoffFiles.length;
-
-      if (filesFound < 5) {
-        result.healthy = false;
-        result.issues.push('Core Handoff components missing');
-      }
-
-    } catch (error) {
-      result.healthy = false;
-      result.issues.push(`Handoff check failed: ${error.message}`);
-    }
-
-    return result;
-  }
-
-  async _checkShadowRealm() {
-    const result = {
-      healthy: true,
-      details: {},
-      issues: []
-    };
-
-    try {
-      const shadowPath = path.join(this.config.rootPath, 'build-engine', 'orion-core');
-      const shadowFiles = [
-        'shadow-realm-v2.js',
-        'foreman.js',
-        'healing-loop.js'
-      ];
-
-      let filesFound = 0;
-      for (const file of shadowFiles) {
-        if (fs.existsSync(path.join(shadowPath, file))) {
-          filesFound++;
-        }
-      }
-
-      result.details.filesFound = filesFound;
-      result.details.totalFiles = shadowFiles.length;
-
-      // Test shadow realm validation
-      try {
-        const shadowRealm = require(path.join(shadowPath, 'shadow-realm-v2.js'));
-        const testResult = shadowRealm.validateInSandbox('console.log("test");', 'test.js');
-        result.details.validationWorking = testResult.syntaxValid === true;
-      } catch (e) {
-        result.details.validationWorking = false;
-        result.issues.push(`Shadow Realm validation test failed: ${e.message}`);
-      }
-
-      if (filesFound < 2) {
-        result.healthy = false;
-        result.issues.push('Core Shadow Realm components missing');
-      }
-
-    } catch (error) {
-      result.healthy = false;
-      result.issues.push(`Shadow Realm check failed: ${error.message}`);
-    }
-
-    return result;
-  }
-
-  async _checkKnowledge() {
-    const result = {
-      healthy: true,
-      details: {},
-      issues: []
-    };
-
-    try {
-      const knowledgePath = path.join(this.config.rootPath, 'orion-knowledge.json');
-
-      if (fs.existsSync(knowledgePath)) {
-        const knowledge = JSON.parse(fs.readFileSync(knowledgePath, 'utf8'));
-        result.details.buildsTracked = knowledge.builds?.length || 0;
-        result.details.capabilitiesTracked = knowledge.capabilities?.length || 0;
-
-        // Check for recent activity
-        if (knowledge.builds && knowledge.builds.length > 0) {
-          const latestBuild = knowledge.builds[knowledge.builds.length - 1];
-          result.details.lastBuild = latestBuild.timestamp || latestBuild.date;
-        }
-      } else {
-        result.healthy = false;
-        result.issues.push('orion-knowledge.json not found');
-      }
-
-    } catch (error) {
-      result.healthy = false;
-      result.issues.push(`Knowledge check failed: ${error.message}`);
-    }
-
-    return result;
-  }
-
-  async _checkServer() {
-    const result = {
-      healthy: true,
-      details: {},
-      issues: []
-    };
-
-    try {
-      // Check if server files exist
-      const serverFiles = [
-        path.join(this.config.serverPath, 'package.json'),
-        path.join(this.config.serverPath, 'index.js')
-      ];
-
-      let filesFound = 0;
-      for (const file of serverFiles) {
-        if (fs.existsSync(file)) {
-          filesFound++;
-        }
-      }
-
-      result.details.filesFound = filesFound;
-
-      // Check package.json for dependencies
-      const pkgPath = path.join(this.config.serverPath, 'package.json');
-      if (fs.existsSync(pkgPath)) {
-        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-        result.details.dependencies = Object.keys(pkg.dependencies || {}).length;
-        result.details.nodeVersion = pkg.engines?.node || 'not specified';
-      }
-
-      // Check node_modules exists
-      const nodeModulesPath = path.join(this.config.serverPath, 'node_modules');
-      result.details.nodeModulesInstalled = fs.existsSync(nodeModulesPath);
-
-      if (!result.details.nodeModulesInstalled) {
-        result.issues.push('node_modules not installed - run npm install');
-      }
-
-    } catch (error) {
-      result.healthy = false;
-      result.issues.push(`Server check failed: ${error.message}`);
-    }
-
-    return result;
-  }
-
-  _timeout(ms) {
-    return new Promise((_, reject) =>
-      setTimeout(() => reject(new Error('Health check timeout')), ms)
-    );
-  }
-}
-
-module.exports = HealthChecker;
+/**
+ * Health Checker
+ *
+ * @purpose Event-driven HealthChecker component
+ * @module sentinel
+ * @layer application
+ * @imports-from fs, path, events
+ * @exports-to sentinel
+ * @side-effects File system reads, Console output, Event emission
+ * @critical-for sentinel
+ */
+
+/**
+ * Sentinel Health Checker
+ *
+ * Monitors the health of all Orion systems.
+ * Checks: Senate, Citadel, Forge, OCEE, Handoff, Shadow Realm, Knowledge
+ */
+
+const fs = require('fs');
+const path = require('path');
+const EventEmitter = require('events');
+
+class HealthChecker extends EventEmitter {
+  constructor(config = {}) {
+    super();
+
+    this.config = {
+      rootPath: config.rootPath || process.cwd(),
+      serverPath: config.serverPath || path.join(config.rootPath || process.cwd(), 'server'),
+      checkTimeout: config.checkTimeout || 5000,
+      ...config
+    };
+
+    // Define system health checks
+    this.systemChecks = [
+      {
+        id: 'senate',
+        name: 'Senate',
+        description: 'Multi-model orchestration',
+        check: () => this._checkSenate()
+      },
+      {
+        id: 'citadel',
+        name: 'Citadel',
+        description: '5-layer safety system',
+        check: () => this._checkCitadel()
+      },
+      {
+        id: 'forge',
+        name: 'Forge',
+        description: 'Build system',
+        check: () => this._checkForge()
+      },
+      {
+        id: 'ocee',
+        name: 'OCEE',
+        description: 'Orchestrated continuous execution',
+        check: () => this._checkOCEE()
+      },
+      {
+        id: 'handoff',
+        name: 'Handoff',
+        description: 'Human-AI collaboration',
+        check: () => this._checkHandoff()
+      },
+      {
+        id: 'shadow_realm',
+        name: 'Shadow Realm',
+        description: 'Validation sandbox',
+        check: () => this._checkShadowRealm()
+      },
+      {
+        id: 'knowledge',
+        name: 'Knowledge Manager',
+        description: 'Build tracking and learning',
+        check: () => this._checkKnowledge()
+      },
+      {
+        id: 'server',
+        name: 'Express Server',
+        description: 'API server health',
+        check: () => this._checkServer()
+      }
+    ];
+  }
+
+  /**
+   * Check health of all systems
+   */
+  async checkAll() {
+    console.log('[HEALTH-CHECKER] Running full health check...');
+    const startTime = Date.now();
+
+    const result = {
+      timestamp: new Date().toISOString(),
+      duration: 0,
+      overall: 'healthy',
+      systems: [],
+      healthySystems: [],
+      unhealthySystems: [],
+      summary: {}
+    };
+
+    for (const systemCheck of this.systemChecks) {
+      try {
+        const checkResult = await Promise.race([
+          systemCheck.check(),
+          this._timeout(this.config.checkTimeout)
+        ]);
+
+        const systemResult = {
+          id: systemCheck.id,
+          name: systemCheck.name,
+          description: systemCheck.description,
+          status: checkResult.healthy ? 'healthy' : 'unhealthy',
+          healthy: checkResult.healthy,
+          details: checkResult.details || {},
+          issues: checkResult.issues || [],
+          lastChecked: new Date().toISOString()
+        };
+
+        result.systems.push(systemResult);
+
+        if (systemResult.healthy) {
+          result.healthySystems.push(systemCheck.id);
+        } else {
+          result.unhealthySystems.push(systemCheck.id);
+        }
+      } catch (error) {
+        result.systems.push({
+          id: systemCheck.id,
+          name: systemCheck.name,
+          description: systemCheck.description,
+          status: 'error',
+          healthy: false,
+          error: error.message,
+          lastChecked: new Date().toISOString()
+        });
+        result.unhealthySystems.push(systemCheck.id);
+      }
+    }
+
+    // Determine overall health
+    if (result.unhealthySystems.length === 0) {
+      result.overall = 'healthy';
+    } else if (result.unhealthySystems.length <= 2) {
+      result.overall = 'degraded';
+    } else {
+      result.overall = 'unhealthy';
+    }
+
+    result.duration = Date.now() - startTime;
+    result.summary = {
+      total: this.systemChecks.length,
+      healthy: result.healthySystems.length,
+      unhealthy: result.unhealthySystems.length
+    };
+
+    console.log(`[HEALTH-CHECKER] Health check complete: ${result.overall} (${result.summary.healthy}/${result.summary.total} systems healthy)`);
+    this.emit('checkComplete', result);
+
+    return result;
+  }
+
+  /**
+   * Check health of a specific system
+   */
+  async checkSystem(systemId) {
+    const systemCheck = this.systemChecks.find(s => s.id === systemId);
+    if (!systemCheck) {
+      return { error: `Unknown system: ${systemId}` };
+    }
+
+    try {
+      const result = await systemCheck.check();
+      return {
+        id: systemCheck.id,
+        name: systemCheck.name,
+        ...result,
+        lastChecked: new Date().toISOString()
+      };
+    } catch (error) {
+      return {
+        id: systemCheck.id,
+        name: systemCheck.name,
+        healthy: false,
+        error: error.message,
+        lastChecked: new Date().toISOString()
+      };
+    }
+  }
+
+  /**
+   * Get list of available system checks
+   */
+  getAvailableChecks() {
+    return this.systemChecks.map(s => ({
+      id: s.id,
+      name: s.name,
+      description: s.description
+    }));
+  }
+
+  // Individual system checks
+
+  async _checkSenate() {
+    const result = {
+      healthy: true,
+      details: {},
+      issues: []
+    };
+
+    try {
+      // Check if senate files exist
+      const senateFiles = [
+        path.join(this.config.serverPath, 'senate.js'),
+        path.join(this.config.serverPath, 'senate-v2.js'),
+        path.join(this.config.serverPath, 'data', 'model-registry.json'),
+        path.join(this.config.serverPath, 'data', 'senate-weights-v2.json')
+      ];
+
+      let filesFound = 0;
+      for (const file of senateFiles) {
+        if (fs.existsSync(file)) {
+          filesFound++;
+        }
+      }
+
+      result.details.filesFound = filesFound;
+      result.details.totalFiles = senateFiles.length;
+
+      // Check model registry
+      const registryPath = path.join(this.config.serverPath, 'data', 'model-registry.json');
+      if (fs.existsSync(registryPath)) {
+        const registry = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
+        result.details.providersConfigured = Object.keys(registry.providers || {}).length;
+        result.details.modelsRegistered = Object.values(registry.providers || {})
+          .reduce((sum, p) => sum + (p.models?.length || 0), 0);
+      }
+
+      if (filesFound < 2) {
+        result.healthy = false;
+        result.issues.push('Core Senate files missing');
+      }
+
+    } catch (error) {
+      result.healthy = false;
+      result.issues.push(`Senate check failed: ${error.message}`);
+    }
+
+    return result;
+  }
+
+  async _checkCitadel() {
+    const result = {
+      healthy: true,
+      details: {},
+      issues: []
+    };
+
+    try {
+      // Check if citadel files exist
+      const citadelPath = path.join(this.config.rootPath, 'citadel');
+      const citadelFiles = [
+        'enforcer.js',
+        'watchers.js',
+        'constitution-loader.js',
+        'file-guard.js'
+      ];
+
+      let filesFound = 0;
+      for (const file of citadelFiles) {
+        if (fs.existsSync(path.join(citadelPath, file))) {
+          filesFound++;
+        }
+      }
+
+      result.details.filesFound = filesFound;
+      result.details.totalFiles = citadelFiles.length;
+
+      // Check audit logs
+      const auditPath = path.join(citadelPath, 'audit');
+      if (fs.existsSync(auditPath)) {
+        const auditFiles = fs.readdirSync(auditPath).filter(f => f.endsWith('.json'));
+        result.details.auditFilesCount = auditFiles.length;
+
+        // Check most recent audit
+        if (auditFiles.length > 0) {
+          const latestAudit = auditFiles.sort().pop();
+          const latestPath = path.join(auditPath, latestAudit);
+          const auditStat = fs.statSync(latestPath);
+          result.details.lastAudit = auditStat.mtime.toISOString();
+
+          // Warn if no audit in 24 hours
+          const hoursSinceAudit = (Date.now() - auditStat.mtime.getTime()) / (1000 * 60 * 60);
+          if (hoursSinceAudit > 24) {
+            result.issues.push(`No audit activity in ${Math.round(hoursSinceAudit)} hours`);
+          }
+        }
+      }
+
+      if (filesFound < 3) {
+        result.healthy = false;
+        result.issues.push('Core Citadel files missing');
+      }
+
+    } catch (error) {
+      result.healthy = false;
+      result.issues.push(`Citadel check failed: ${error.message}`);
+    }
+
+    return result;
+  }
+
+  async _checkForge() {
+    const result = {
+      healthy: true,
+      details: {},
+      issues: []
+    };
+
+    try {
+      const forgePath = path.join(this.config.rootPath, 'forge');
+      const forgeFiles = [
+        'forge-core.js',
+        'task-decomposer.js',
+        'intent-matcher.js',
+        'diagnostician-v2.js',
+        'prescriber.js',
+        'forge-loop.js'
+      ];
+
+      let filesFound = 0;
+      for (const file of forgeFiles) {
+        if (fs.existsSync(path.join(forgePath, file))) {
+          filesFound++;
+        }
+      }
+
+      result.details.filesFound = filesFound;
+      result.details.totalFiles = forgeFiles.length;
+      result.details.completeness = Math.round((filesFound / forgeFiles.length) * 100) + '%';
+
+      if (filesFound < 4) {
+        result.healthy = false;
+        result.issues.push('Core Forge components missing');
+      }
+
+    } catch (error) {
+      result.healthy = false;
+      result.issues.push(`Forge check failed: ${error.message}`);
+    }
+
+    return result;
+  }
+
+  async _checkOCEE() {
+    const result = {
+      healthy: true,
+      details: {},
+      issues: []
+    };
+
+    try {
+      const oceePath = path.join(this.config.serverPath, 'ocee');
+      const oceeFiles = [
+        'ocee-core.js',
+        'persistent-task-queue.js',
+        'checkpoint-manager.js',
+        'build-session-manager.js',
+        'build-graph-generator.js'
+      ];
+
+      let filesFound = 0;
+      for (const file of oceeFiles) {
+        if (fs.existsSync(path.join(oceePath, file))) {
+          filesFound++;
+        }
+      }
+
+      result.details.filesFound = filesFound;
+      result.details.totalFiles = oceeFiles.length;
+
+      // Check for active tasks
+      const taskQueuePath = path.join(oceePath, 'queue');
+      if (fs.existsSync(taskQueuePath)) {
+        try {
+          const queueFiles = fs.readdirSync(taskQueuePath);
+          result.details.pendingTasks = queueFiles.length;
+        } catch (e) {
+          result.details.pendingTasks = 'unknown';
+        }
+      }
+
+      if (filesFound < 3) {
+        result.healthy = false;
+        result.issues.push('Core OCEE components missing');
+      }
+
+    } catch (error) {
+      result.healthy = false;
+      result.issues.push(`OCEE check failed: ${error.message}`);
+    }
+
+    return result;
+  }
+
+  async _checkHandoff() {
+    const result = {
+      healthy: true,
+      details: {},
+      issues: []
+    };
+
+    try {
+      const handoffPath = path.join(this.config.serverPath, 'handoff');
+      const handoffFiles = [
+        'index.js',
+        'risk-scorer.js',
+        'gate-checker.js',
+        'mission-state.js',
+        'audit-logger.js',
+        'evidence-bundle.js',
+        'cost-tracker.js'
+      ];
+
+      let filesFound = 0;
+      for (const file of handoffFiles) {
+        if (fs.existsSync(path.join(handoffPath, file))) {
+          filesFound++;
+        }
+      }
+
+      result.details.filesFound = filesFound;
+      result.details.totalFiles = handoffFiles.length;
+
+      if (filesFound < 5) {
+        result.healthy = false;
+        result.issues.push('Core Handoff components missing');
+      }
+
+    } catch (error) {
+      result.healthy = false;
+      result.issues.push(`Handoff check failed: ${error.message}`);
+    }
+
+    return result;
+  }
+
+  async _checkShadowRealm() {
+    const result = {
+      healthy: true,
+      details: {},
+      issues: []
+    };
+
+    try {
+      const shadowPath = path.join(this.config.rootPath, 'build-engine', 'orion-core');
+      const shadowFiles = [
+        'shadow-realm-v2.js',
+        'foreman.js',
+        'healing-loop.js'
+      ];
+
+      let filesFound = 0;
+      for (const file of shadowFiles) {
+        if (fs.existsSync(path.join(shadowPath, file))) {
+          filesFound++;
+        }
+      }
+
+      result.details.filesFound = filesFound;
+      result.details.totalFiles = shadowFiles.length;
+
+      // Test shadow realm validation
+      try {
+        const shadowRealm = require(path.join(shadowPath, 'shadow-realm-v2.js'));
+        const testResult = shadowRealm.validateInSandbox('console.log("test");', 'test.js');
+        result.details.validationWorking = testResult.syntaxValid === true;
+      } catch (e) {
+        result.details.validationWorking = false;
+        result.issues.push(`Shadow Realm validation test failed: ${e.message}`);
+      }
+
+      if (filesFound < 2) {
+        result.healthy = false;
+        result.issues.push('Core Shadow Realm components missing');
+      }
+
+    } catch (error) {
+      result.healthy = false;
+      result.issues.push(`Shadow Realm check failed: ${error.message}`);
+    }
+
+    return result;
+  }
+
+  async _checkKnowledge() {
+    const result = {
+      healthy: true,
+      details: {},
+      issues: []
+    };
+
+    try {
+      const knowledgePath = path.join(this.config.rootPath, 'orion-knowledge.json');
+
+      if (fs.existsSync(knowledgePath)) {
+        const knowledge = JSON.parse(fs.readFileSync(knowledgePath, 'utf8'));
+        result.details.buildsTracked = knowledge.builds?.length || 0;
+        result.details.capabilitiesTracked = knowledge.capabilities?.length || 0;
+
+        // Check for recent activity
+        if (knowledge.builds && knowledge.builds.length > 0) {
+          const latestBuild = knowledge.builds[knowledge.builds.length - 1];
+          result.details.lastBuild = latestBuild.timestamp || latestBuild.date;
+        }
+      } else {
+        result.healthy = false;
+        result.issues.push('orion-knowledge.json not found');
+      }
+
+    } catch (error) {
+      result.healthy = false;
+      result.issues.push(`Knowledge check failed: ${error.message}`);
+    }
+
+    return result;
+  }
+
+  async _checkServer() {
+    const result = {
+      healthy: true,
+      details: {},
+      issues: []
+    };
+
+    try {
+      // Check if server files exist
+      const serverFiles = [
+        path.join(this.config.serverPath, 'package.json'),
+        path.join(this.config.serverPath, 'index.js')
+      ];
+
+      let filesFound = 0;
+      for (const file of serverFiles) {
+        if (fs.existsSync(file)) {
+          filesFound++;
+        }
+      }
+
+      result.details.filesFound = filesFound;
+
+      // Check package.json for dependencies
+      const pkgPath = path.join(this.config.serverPath, 'package.json');
+      if (fs.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        result.details.dependencies = Object.keys(pkg.dependencies || {}).length;
+        result.details.nodeVersion = pkg.engines?.node || 'not specified';
+      }
+
+      // Check node_modules exists
+      const nodeModulesPath = path.join(this.config.serverPath, 'node_modules');
+      result.details.nodeModulesInstalled = fs.existsSync(nodeModulesPath);
+
+      if (!result.details.nodeModulesInstalled) {
+        result.issues.push('node_modules not installed - run npm install');
+      }
+
+    } catch (error) {
+      result.healthy = false;
+      result.issues.push(`Server check failed: ${error.message}`);
+    }
+
+    return result;
+  }
+
+  _timeout(ms) {
+    return new Promise((_, reject) =>
+      setTimeout(() => reject(new Error('Health check timeout')), ms)
+    );
+  }
+}
+
+module.exports = HealthChecker;