create-byan-agent 2.5.0 → 2.6.0

package/src/byan-v2/index.js

@@ -13,6 +13,8 @@ const FiveWhysAnalyzer = require('./dispatcher/five-whys-analyzer');
 const ActiveListener = require('./orchestrator/active-listener');
 const MantraValidator = require('./generation/mantra-validator');
 const VoiceIntegration = require('./integration/voice-integration');
+const EloEngine = require('./elo/index');
+const FactChecker = require('./fact-check/index');
 
 const crypto = require('crypto');
 const fs = require('fs');
@@ -119,6 +121,23 @@ class ByanV2 {
       }
     }
 
+    // EloEngine
+    if (bmadConfig.elo?.enabled !== false) {
+      this.eloEngine = new EloEngine({
+        storagePath: bmadConfig.elo?.storage_path
+      });
+      this.logger.info('[ByanV2] ELO trust system enabled');
+    }
+
+    // FactChecker
+    if (bmadConfig.fact_check?.enabled !== false) {
+      this.factChecker = new FactChecker({
+        ...bmadConfig.fact_check,
+        graph_path: bmadConfig.fact_check?.graph_path || '_byan/_memory/fact-graph.json'
+      }, this.sessionState);
+      this.logger.info('[ByanV2] Fact-check system enabled');
+    }
+
     // VoiceIntegration
     if (bmadConfig.voice_integration?.enabled !== false) {
       this.voiceIntegration = new VoiceIntegration(this.sessionState, this.logger);
@@ -170,6 +189,10 @@ class ByanV2 {
 
     this.metrics.increment('sessionsStarted');
 
+    if (this.eloEngine) {
+      this.eloEngine.applyIdleDecay();
+    }
+
     await this.stateMachine.transition('INTERVIEW');
 
     this.logger.info('State transition', {
@@ -640,12 +663,143 @@ class ByanV2 {
   }
 
   async getSessionSummary() {
-    return {
+    const summary = {
       sessionId: this.sessionState.sessionId,
       questionsAsked: this.sessionState.userResponses.length,
       state: this.stateMachine.getCurrentState().name,
       timestamp: new Date().toISOString()
     };
+
+    if (this.eloEngine) {
+      summary.elo = this.eloEngine.getSummary();
+      summary.recommendedModel = this.eloEngine.routeLLM().model;
+    }
+
+    if (this.factChecker) {
+      summary.factCheck = { enabled: true, mode: this.factChecker.config.mode };
+    }
+
+    return summary;
+  }
+
+  // ========================================
+  // ELO Trust System Methods
+  // ========================================
+
+  /**
+   * Get challenge configuration for the LLM before evaluating a claim.
+   * @param {string} domain
+   * @returns {ChallengeContext}
+   */
+  getClaimContext(domain) {
+    if (!this.eloEngine) throw new Error('ELO system not enabled');
+    return this.eloEngine.evaluateContext(domain);
+  }
+
+  /**
+   * Record the result of a claim evaluation and update ELO.
+   * @param {string} domain
+   * @param {'VALIDATED'|'BLOCKED'|'PARTIALLY_VALID'} result
+   * @param {object} opts - { blockedReason, claimExcerpt }
+   * @returns {{ newRating, delta, tiltDetected, interventionMode, message }}
+   */
+  recordClaimResult(domain, result, opts = {}) {
+    if (!this.eloEngine) throw new Error('ELO system not enabled');
+    return this.eloEngine.recordResult(domain, result, opts);
+  }
+
+  /**
+   * Declare user expertise for a domain (sets provisional ELO).
+   * @param {string} domain
+   * @param {'beginner'|'intermediate'|'advanced'|'expert'|'principal'} level
+   */
+  declareExpertise(domain, level) {
+    if (!this.eloEngine) throw new Error('ELO system not enabled');
+    return this.eloEngine.declareExpertise(domain, level);
+  }
+
+  /**
+   * Get the [ELO] dashboard for a domain: why + how to progress.
+   * @param {string} domain
+   * @returns {string}
+   */
+  getEloDashboard(domain) {
+    if (!this.eloEngine) throw new Error('ELO system not enabled');
+    return this.eloEngine.getDashboard(domain);
+  }
+
+  /**
+   * Get ELO summary across all domains.
+   * @returns {Array}
+   */
+  getEloSummary() {
+    if (!this.eloEngine) return [];
+    return this.eloEngine.getSummary();
+  }
+
+  /**
+   * Get LLM model recommendation based on ELO profile.
+   * @returns {{ model, label, reason, maxRating }}
+   */
+  routeLLM() {
+    if (!this.eloEngine) return { model: 'claude-sonnet-4.5', label: 'default', reason: 'ELO not enabled' };
+    return this.eloEngine.routeLLM();
+  }
+
+  // ========================================
+  // Fact-Check Methods
+  // ========================================
+
+  /**
+   * Check a claim against the knowledge base.
+   * @param {string} claim
+   * @param {object} opts - { domain, level, source, proof }
+   * @returns {{ assertionType, level, score, status, source, proof, warning }}
+   */
+  checkClaim(claim, opts = {}) {
+    if (!this.factChecker) throw new Error('Fact-check system not enabled');
+    return this.factChecker.check(claim, opts);
+  }
+
+  /**
+   * Parse text and auto-detect implicit claims using trigger patterns.
+   * @param {string} text
+   * @returns {Array<{ pattern, matched, position, excerpt }>}
+   */
+  parseClaims(text) {
+    if (!this.factChecker) throw new Error('Fact-check system not enabled');
+    return this.factChecker.parse(text);
+  }
+
+  /**
+   * Mark a claim as user-verified with a proof artifact.
+   * @param {string} claim
+   * @param {string} proof
+   * @returns {{ id, status, claim }}
+   */
+  verifyFact(claim, proof) {
+    if (!this.factChecker) throw new Error('Fact-check system not enabled');
+    return this.factChecker.verify(claim, proof);
+  }
+
+  /**
+   * Generate a Markdown fact sheet for the session.
+   * @param {string} sessionId
+   * @param {object} facts - { verified, claims, disputed, opinions }
+   * @returns {{ content, path }}
+   */
+  generateFactSheet(sessionId, facts, save = true) {
+    if (!this.factChecker) throw new Error('Fact-check system not enabled');
+    return this.factChecker.generateFactSheet(sessionId, facts, save);
+  }
+
+  /**
+   * Get all facts from the persistent knowledge graph.
+   * @returns {Array<object>}
+   */
+  getKnowledgeGraph() {
+    if (!this.factChecker) return [];
+    return this.factChecker.graph.load().facts;
   }
 }