mindforge-cc 5.4.0 → 5.10.0

package/.agent/CLAUDE.md

@@ -1,4 +1,4 @@
-# MindForge — Unified Protocol Engine (v4.0.0-alpha.swarm)
+# MindForge — Unified Protocol Engine (v5.10.0-NEXUS)
 
 # MASTER DIRECTIVE: Every session MUST begin by loading the Parameter Registry (MINDFORGE.md) and activating the `mindforge-neural-orchestrator` layer.
 
@@ -41,11 +41,18 @@ You are a **Dynamic Multi-Agent Swarm (Agentic Mesh)**. Your mission is to execu
 - **Shipping**: `mindforge-ship_extended`.
 - **Verification**: `mindforge-verify-work_extended`.
 
-### 5. The Temporal Vision Loop (Hindsight)
-**IF** verification fails **OR** deep bug suspected:
-1. Invoke `hindsight-injector.js`.
-2. Pull the "Last Known Good" state from the Temporal Hub.
-3. Execute `mindforge:repair` if drift is detected.
+### 5. The Temporal Vision Loop (Hindsight & Steering)
+**IF** verification fails **OR** deep bug suspected **OR** manual correction needed:
+1. Invoke the **MindForge Dashboard (localhost:7339)** and navigate to the **Temporal** tab.
+2. Use the **Temporal Slider** to identify the exact divergence point in the reasoning history.
+3. Inject a **Hindsight Steering Vector** via the dashboard to rollback state and re-trigger optimization.
+4. Verify the `auto-state.json` status has transitioned to `awaiting_regeneration`.
+
+### 6. AgRevOps Governance (Pillar VIII)
+**MANDATORY for all Enterprise-tier sessions**:
+1. Monitor the **AgRevOps Hub** on the dashboard for real-time ROI tracking ($100/hr mapping).
+2. Validate the **Security Health Score** (must remain > 85).
+3. Check the **Velocity Forecaster** for milestone completion ETAs.
 
 ---
 
@@ -54,9 +61,11 @@ You are a **Dynamic Multi-Agent Swarm (Agentic Mesh)**. Your mission is to execu
 Prioritize based on `[REACTIVE_MODE]` in MINDFORGE.md. These are the **Quality gates**:
 
 - [ ] **Load Config**: Read PROJECT.md, STATE.md, and **MINDFORGE.md**.
+- [ ] **Nexus Sync**: Ensure `NexusTracer` singleton is initialized and active.
+- [ ] **AgRevOps Check**: Verify ROI trends and Security Health Score via `/api/revops`.
 - [ ] **PLAN-FIRST RULE**: Never code without a verified XML plan.
 - [ ] **Verify First**: Never task-complete without successful `<verify>` output.
-- [ ] **Audit Always**: Write a JSONL entry for every significant session event.
+- [ ] **Audit Always**: Write a JSONL entry for every significant session event. All entries must be Merkle-linked.
 
 ---
 

package/.mindforge/engine/nexus-tracer.js

@@ -1,115 +1,11 @@
 /**
- * MindForge Nexus — Core Tracer Engine (v4.1.0-alpha.nexus)
- *
- * Handles Agentic Reasoning Tracing (ART) spans and OpenTelemetry-compatible 
- * trace context propagation across the agentic mesh.
+ * MindForge Nexus — Legacy Shim (v5.9.0)
+ * 
+ * This file acts as a compatibility layer for the v4.1.0-alpha.nexus ART protocol.
+ * ALL core tracing logic has been migrated to /bin/engine/nexus-tracer.js for 
+ * production-grade performance and security hardening.
  */
 
-const fs = require('fs');
-const path = require('path');
-const crypto = require('crypto');
+'use strict';
 
-class NexusTracer {
-  constructor(config = {}) {
-    this.projectId = config.projectId || 'mindforge-nexus';
-    this.auditPath = config.auditPath || path.join(process.cwd(), '.planning', 'AUDIT.jsonl');
-    this.currentTraceId = null;
-    this.activeSpans = new Map();
-  }
-
-  /**
-   * Initialize or resume a trace.
-   */
-  startTrace(traceId = null) {
-    this.currentTraceId = traceId || `tr_${crypto.randomBytes(8).toString('hex')}`;
-    return this.currentTraceId;
-  }
-
-  /**
-   * Start a new ART span.
-   */
-  startSpan(name, attributes = {}, parentSpanId = null) {
-    const spanId = `sp_${crypto.randomBytes(6).toString('hex')}`;
-    const startTime = new Date().toISOString();
-
-    const span = {
-      id: spanId,
-      trace_id: this.currentTraceId,
-      parent_id: parentSpanId || null,
-      name,
-      status: 'active',
-      start_time: startTime,
-      attributes: {
-        ...attributes,
-        service: 'mindforge-nexus',
-      }
-    };
-
-    this.activeSpans.set(spanId, span);
-
-    // Record span start in AUDIT.jsonl
-    this._recordEvent('span_started', { 
-      span_id: spanId, 
-      parent_span_id: parentSpanId,
-      span_name: name,
-      ...attributes 
-    });
-
-    return spanId;
-  }
-
-  /**
-   * End an active span.
-   */
-  endSpan(spanId, status = 'success', metadata = {}) {
-    const span = this.activeSpans.get(spanId);
-    if (!span) return;
-
-    span.status = status;
-    span.end_time = new Date().toISOString();
-    
-    this._recordEvent('span_completed', {
-      span_id: spanId,
-      status,
-      ...metadata
-    });
-
-    this.activeSpans.delete(spanId);
-  }
-
-  /**
-   * Record a Reasoning Trace event (ART granularity).
-   */
-  recordReasoning(spanId, agent, thought, resolution = 'none') {
-    this._recordEvent('reasoning_trace', {
-      span_id: spanId,
-      agent,
-      thought,
-      resolution
-    });
-  }
-
-  /**
-   * Internal AUDIT writer.
-   */
-  _recordEvent(event, data) {
-    const entry = {
-      id: crypto.randomUUID(),
-      timestamp: new Date().toISOString(),
-      event,
-      trace_id: this.currentTraceId,
-      ...data
-    };
-
-    try {
-      if (!fs.existsSync(path.dirname(this.auditPath))) {
-        fs.mkdirSync(path.dirname(this.auditPath), { recursive: true });
-      }
-      fs.appendFileSync(this.auditPath, JSON.stringify(entry) + '\n');
-    } catch (err) {
-      console.error(`[NexusTracer] Failed to write audit entry: ${err.message}`);
-    }
-  }
-}
-
-module.exports = NexusTracer;
+module.exports = require('../../bin/engine/nexus-tracer');

package/CHANGELOG.md

@@ -1,7 +1,55 @@
 # Changelog
 
+## [5.8.0] - 2026-03-28
+### Added
+- **Pillar VI: Sovereign Reason Enclaves (ZK-Proof Audit Trails)**.
+- Implemented `SRE-ISOLATED` reasoning mode in `SREManager`.
+- Generated **ZK-Proof Compliance Certificates** (signed by System DID) for confidential reasoning cycles.
+- Integrated masked audit logging in `NexusTracer`, replacing raw thought traces with verifiable proofs.
+- Added `verifyZKProof` utility for non-custodial audit verification.
+
+## [5.7.0] - 2026-03-28
+### Added
+- **Pillar V: Multi-Cloud Arbitrage (Task-to-Model Affinity Routing)**.
+- Implemented **Performance-Based Affinity Matrices** in `CloudBroker` for intelligence-first routing.
+- Added `performance-stats.json` persistence to track cross-provider success rates by task taxonomy.
+- Integrated automated result recording in `WaveFeedbackLoop`.
+- Prioritized **Probability of Success** over raw cost/latency in routing scoring.
+
+## [5.6.0] - 2026-03-28
+### Added
+- **Pillar IV: Supply Chain Trust (Binary Runtime Attestation)**.
+- Cryptographic skill signing in `SkillRegistry` via ZTAIManager Tier 3 Enclaves.
+- JIT Attestation in `SkillValidator` to verify skill integrity before agent execution.
+- `SIGNATURES.json` tracking for all enterprise-grade skills.
+
+## [5.5.0] - 2026-03-28
+### Added
+- **Pillar III: Predictive Agentic Reliability (Reasoning Entropy Monitoring)**.
+- Reasoning Entropy Scoring (RES) in `NexusTracer` to detect semantic stagnation and loops.
+- Proactive Self-Healing trigger for high-similarity thought sequences.
+- Steering Vector generation in `TemporalHindsight` to break agentic deadlocks.
+
 ## [5.4.0] — Beast Mode Hardening — 2026-03-28
 
+# Release Notes - MindForge v5.6.0 "Sentinel Execution"
+
+MindForge v5.6.0 introduces the final pillars of the Hyper-Enterprise roadmap: Proactive Reliability and Zero-Trust Skill Execution.
+
+## Highlights
+- **Reasoning Entropy Monitoring (PAR)**: Proactively prevents token-burning reasoning loops.
+- **Binary Runtime Attestation (ZTS)**: Cryptographically ensures that skills have not been tampered with before they are loaded by the agent.
+
+---
+
+## [5.6.0] - Sentinel Execution
+- Implemented JIT Attestation for Skill Registry.
+- Added Skill Signing utility in `mindforge-cc sign`.
+
+## [5.5.0] - Predictive Reliability
+- Implemented RES (Reasoning Entropy Scoring) in Nexus Tracer.
+- Added Steering Vector injection for proactive loop breaking.
+
 🚀 **MindForge v5.4.0 — Enterprise Resilience (Hardened Edition)**
 
 This update elevates the v5.3.0 "Hyper-Enterprise" features to maximum robustness ("Beast Mode"), implementing critical safety systems and advanced observability.

package/README.md

@@ -1,7 +1,19 @@
-# MindForge v5.1.0 — The Beast AdditionFramework (v5.1.0)
+# MindForge v5.10.0 — Nexus Steering & AgRevOps
 
-MindForge turns AI coding agents into production-grade engineering partners with governance, multi-cloud resilience, and a non-bypassable Sovereign Reason Enclave.
-Release published: v5.1.0-PRO.
+MindForge turns AI coding agents into production-grade engineering partners with **Interactive Temporal Steering (Pillar VII)**, **AgRevOps ROI Analytics (Pillar VIII)**, and a non-bypassable Sovereign Reason Enclave with Merkle-linked ZK-Audit trails.
+Release published: v5.10.0-NEXUS.
+
+## What's new in v5.10 (Nexus Steering & AgRevOps)
+
+MindForge V5.10 completes the "Hyper-Enterprise" evolution, transforming the dashboard into a high-fidelity control center for temporal debugging and financial governance.
+
+- **Interactive Temporal Steering (Pillar VII)**: The 'Time-Travel' slider allows real-time navigation of historical snapshots. Inspect reasoning traces at any point in space-time and inject 'Hindsight Steering Vectors' to correct agentic drift.
+- **AgRevOps ROI Engine (Pillar VIII)**: Automated calculation of economic value ($100/hr dev saving vs token costs). Tracks cumulative savings and net agentic ROI for the entire swarm.
+- **Velocity Forecaster**: Statistical ETA prediction for milestones based on live task completion velocity.
+- **Governance Debt Monitor**: Security Health Score tracking that flags policy bypasses and critical findings in the audit trail.
+- **Nexus Dashboard v2.0**: Major UI upgrade with dedicated Temporal and RevOps tabs, featuring real-time gauges and reasoning inspectors.
+
+## What's new in v5.9 (Beast Mode Hardening)
 
 ## Installation & Setup
 
@@ -36,17 +48,22 @@ npx mindforge-cc@latest --claude --local
 AI coding agents degrade over long sessions. Context fills up. Quality drops.
 Decisions get forgotten. MindForge fixes that with:
 
-- **Multi-Cloud Arbitrage (v5.0)** — Dynamic routing and provider hedging with low-latency arbitrage.
-- **Sovereign Reason Enclave (v5.0)** — TEE-simulated reasoning isolation and sanitization for confidential workloads.
+- **Sovereign Reason Enclave (v5.8)** — TEE-simulated reasoning isolation with Zero-Knowledge (ZK) Audit Trails.
+- **Multi-Cloud Arbitrage (v5.7)** — Dynamic routing across Vertex AI, Bedrock, and Azure with intelligence-first task affinity.
+- **Sentinel Execution (v5.6)** — JIT Binary Runtime Attestation and Zero-Trust Skill Enforcement.
+- **Interactive Temporal Steering (v5.10)** — Full history scrubbing, hindsight state repair, and real-time temporal slider navigation.
+- **AgRevOps Hub (v5.10)** — Dynamic ROI tracking ($100/hr mapping), Milestone Velocity forecasting, and Governance Debt monitoring.
+- **Sovereign Reason Enclave (v5.8)** — TEE-simulated reasoning isolation with Zero-Knowledge (ZK) Audit Trails.
+- **Multi-Cloud Arbitrage (v5.7)** — Dynamic routing across Vertex AI, Bedrock, and Azure with intelligence-first task affinity.
+- **Sentinel Execution (v5.6)** — JIT Binary Runtime Attestation and Zero-Trust Skill Enforcement.
 - **Human-Agent Handover (v5.0)** — Nexus State Bundles and mid-wave steering injection.
-- **Autonomous FinOps (v4.3)** — Dynamic **C2C** (Confidence-to-Cost) routing and Agentic ROI tracking.
+- **Autonomous FinOps (v4.3)** — Dynamic **C2C** (Confidence-to-Cost) routing.
 - **Proactive Equilibrium (v4.3)** — Real-time **Wave Divergence** monitoring and autonomous state recovery.
 - **MindForge Nexus (v4.1)** — High-fidelity **ART** (Agentic Reasoning Tracing).
 - **Zero-Trust Identity (v4.2)** — DID-signed non-repudiable audit logs with HSM/Enclave support.
 - **Global Intelligence Mesh (v4.2)** — Cross-repo knowledge sharing and Ghost Pattern Detection.
 - **Context Sharding (v3)** — relevance-dense memory management (40% token savings)
 - **Adversarial Synthesis (v3)** — zero-drift logic through red/blue model debate
-- **Temporal Vision (v3)** — full history scrubbing and hindsight state repair
 - **RAG 2.0 (v3)** — automatic semantic shadowing for background pattern retrieval
 - **Role personas** — specialised agent modes for each task type
 - **Specialized Identities** — custom `/agents/` workspace with enriched `IDENTITY.md` protocols
@@ -292,6 +309,30 @@ See `.mindforge/production/token-optimiser.md`.
 
 ---
 
+## What's new in v5.8 (Sovereign Reason Enclaves)
+
+MindForge V5.8 implements the sixth pillar of the Hyper-Enterprise roadmap: **Sovereign Reason Enclaves with ZK-Audit**.
+
+- **ZK-Proof Compliance Certificates**: Simulated zero-knowledge proofs (signed by System DID) for SRE sessions, proving policy adherence without exposing thoughts.
+- **Privacy-Preserving Auditing**: `NexusTracer` replaces raw reasoning with verifiable certificates in the global audit log.
+- **Enclave Verification**: Cryptographic verification of enclave sessions via `verifyZKProof`.
+
+## What's new in v5.7 (Multi-Cloud Arbitrage)
+
+MindForge V5.7 implements the fifth pillar of the Hyper-Enterprise roadmap: **Multi-Cloud Arbitrage with Task-to-Model Affinity**.
+
+- **Task Affinity Matrices**: Persistent tracking of model success rates by task taxonomy (e.g., Anthropic for refactoring, Google for research).
+- **Intelligence-First Routing**: Scoring weighted 50% on success probability, ensuring the best model for the job.
+- **Feedback Integration**: Automated performance updates via the implementation feedback loop.
+
+## What's new in v5.6 (Sentinel Execution)
+
+MindForge V5.6 completes the "Hyper-Enterprise" roadmap with two critical security and reliability pillars.
+
+- **Binary Runtime Attestation (ZTS)**: Cryptographically sign skills using HSM-secured identities. The `SkillValidator` now performs JIT verification, blocking tampered or unauthorized skills from loading.
+- **Reasoning Entropy Monitoring (PAR)**: The `NexusTracer` now calculates **RES (Reasoning Entropy Scoring)**. If an agent falls into a semantic loop or circular reasoning, the system proactively generates a **Steering Vector** to break the loop and recover the execution wave.
+- **Sentinel Hardening**: Enhanced `NexusTracer` with SRE-aware audit integrity and Merkle-root cumulative hash chains.
+
 ## What's new in v4.3 (Enterprise Mesh & Equilibrium)
 
 MindForge V4.3 matures the framework for enterprise mission-critical environments.

package/RELEASENOTES.md

@@ -1,4 +1,39 @@
-# MindForge v5.4.0 — Beast Mode Hardening
+# MindForge v5.9.0 — Beast Mode Hardening (Nexus Unification)
+## Top Summary
+The v5.9.0 release elevates the MindForge Enterprise architecture to "Beast Mode" by unifying the tracing infrastructure into a single, high-fidelity asynchronous ART protocol and hardening the governance and arbitrage pillars with advanced cryptographic and resilience patterns.
+
+## Highlights
+- **Unified NexusTracer Singleton**: Migration of all tracing and reasoning capture to `bin/engine/nexus-tracer.js`. Standardized as a singleton with mandatory `async` methods to support ZTAI cryptographic signing.
+- **Merkle-Style Audit Integrity**: Hardened SRE and ZTAI logs with Merkle-root cumulative hash chains, ensuring every audit entry is cryptographically linked to the entire session history.
+- **MCA Circuit Breakers**: Stateful provider blacklisting in `CloudBroker` that automatically disables failing models for 10 minutes after 3 consecutive errors.
+- **Intelligence Metrics Decay**: Historical performance data now favors recent trends via a 0.95 decay factor, ensuring routing adaptivity.
+- **Async Test Suite**: 100% restoration of the core test suite (Nexus, SRE, RES) for the new asynchronous execution model.
+
+---
+
+# MindForge v5.8.0 — Sovereign Reason Enclaves (ZK-Audit)
+## Top Summary
+The v5.8.0 release implements the sixth pillar of the Hyper-Enterprise roadmap: Sovereign Reason Enclaves with Zero-Knowledge (ZK) Audit Trails. This enables agents to provide cryptographic proof of policy adherence for confidential reasoning without exposing proprietary content to global logs.
+
+## Highlights
+- **ZK-Proof Compliance Certificates**: Simulated zero-knowledge proofs (DID-signed) for SRE sessions.
+- **Privacy-Preserving Auditing**: `NexusTracer` replaces raw thought traces with verifiable certificates for isolated tasks.
+- **Enclave Verification**: New `verifyZKProof` utility for non-custodial audit integrity checks.
+
+---
+
+# MindForge v5.7.0 — Multi-Cloud Arbitrage (Affinity Routing)
+## Top Summary
+The v5.7.0 release implements the fifth pillar of the Hyper-Enterprise roadmap: Multi-Cloud Arbitrage with Task-to-Model Affinity Routing. Routing is now intelligence-first, mapping task taxonomies to providers with the highest historical success rates.
+
+## Highlights
+- **Task-to-Model Affinity Matrices**: Persistent tracking of success probability per model and task type (refactor, test, audit, etc.).
+- **Intelligence-First Routing**: `CloudBroker` weights routing scoring by success probability (50% weight) alongside cost (30%) and latency (20%).
+- **Feedback Loop Integration**: Automated updates to performance metrics via `WaveFeedbackLoop` completions.
+
+---
+
+# MindForge v5.6.0 — Sentinel Execution
 ## Top Summary
 The v5.4.0 release elevates the "Hyper-Enterprise" features to maximum robustness ("Beast Mode"), implementing critical safety systems, automated blast-radius protection for sensitive files, and advanced failure telemetry.
 

package/bin/dashboard/frontend/index.html

@@ -161,6 +161,8 @@
     <button class="tab active" onclick="showPage('activity')">Activity</button>
     <button class="tab" onclick="showPage('metrics')">Metrics</button>
     <button class="tab" onclick="showPage('approvals')">Approvals</button>
+    <button class="tab" onclick="showPage('temporal')">Temporal</button>
+    <button class="tab" onclick="showPage('revops')">RevOps</button>
     <button class="tab" onclick="showPage('memory')">Memory</button>
     <button class="tab" onclick="showPage('team')">Team</button>
   </nav>
@@ -213,6 +215,116 @@
       </div>
     </div>
 
+    <!-- PAGE: TEMPORAL -->
+    <div id="temporal" class="page">
+      <div class="card">
+        <div class="card-header">
+          <div class="card-title">Temporal Steering Timeline</div>
+          <div id="timeline-count" class="badge">0 Snapshots</div>
+        </div>
+        <div class="card-body">
+          <div style="margin-bottom: 24px;">
+            <input type="range" id="temporal-slider" style="width:100%; height:8px; accent-color:var(--accent);" min="0" max="0" step="1" oninput="onSliderChange(this.value)">
+            <div style="display:flex; justify-content:space-between; margin-top:8px; font-family:var(--font-mono); font-size:10px; color:var(--muted)">
+              <span id="slider-start">Past</span>
+              <span id="slider-current">Select Snapshot</span>
+              <span id="slider-end">Present</span>
+            </div>
+          </div>
+          
+          <div class="grid-2">
+            <div class="card" style="height:400px; border-style:dashed;">
+              <div class="card-header"><div class="card-title">Reasoning Snapshot Inspector</div></div>
+              <div id="snapshot-viewer" class="card-body" style="font-family:var(--font-mono); font-size:11px; overflow-y:auto; background:#000; color:#eee;">
+                Select a point in space-time to inspect agentic state...
+              </div>
+            </div>
+            <div class="card" style="height:400px;">
+              <div class="card-header"><div class="card-title">Hindsight Steering Vector</div></div>
+              <div class="card-body">
+                <p style="color:var(--muted); margin-bottom:16px;">Injecting a steering vector will rollback the system state to the selected snapshot and re-trigger the optimization loop with the new constraints.</p>
+                <div style="margin-bottom:20px;">
+                  <label style="display:block; font-size:11px; margin-bottom:8px; color:var(--muted); text-transform:uppercase;">Steering Instruction:</label>
+                  <textarea id="steering-input" class="confirm-input" style="height:120px; resize:none;" placeholder="e.g. 'Rewind to step 2 and ignore the legacy auth module...'"></textarea>
+                </div>
+                <button id="inject-btn" class="btn btn-approve" style="width:100%; justify-content:center;" onclick="injectHindsight()" disabled>Rewind & Inject Fix</button>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <!-- PAGE: REVOPS -->
+    <div id="revops" class="page">
+      <div class="grid-4">
+        <div class="card">
+          <div class="card-body">
+            <div class="stat-label">Agentic ROI</div>
+            <div id="rev-roi" class="stat-value">0%</div>
+          </div>
+        </div>
+        <div class="card">
+          <div class="card-body">
+            <div class="stat-label">Net Value Synthesis</div>
+            <div id="rev-net" class="stat-value">$0.00</div>
+          </div>
+        </div>
+        <div class="card">
+          <div class="card-body">
+            <div class="stat-label">Project Velocity</div>
+            <div id="rev-velocity" class="stat-value">0 <span class="stat-unit">tasks/hr</span></div>
+            <div id="rev-eta" style="font-size:10px; margin-top:4px; color:var(--muted)">ETA: N/A</div>
+          </div>
+        </div>
+        <div class="card">
+          <div class="card-body">
+            <div class="stat-label">Security Health</div>
+            <div id="rev-health" class="stat-value">100</div>
+            <div id="rev-health-status" class="badge" style="margin-top:4px">STATUS: EXCELLENT</div>
+          </div>
+        </div>
+      </div>
+
+      <div class="grid-2">
+        <div class="card">
+          <div class="card-header"><div class="card-title">Financial Flow (ROI Mapping)</div></div>
+          <div class="card-body">
+            <div id="roi-breakdown" style="font-family:var(--font-mono); font-size:12px;">
+              <div style="display:flex; justify-content:space-between; padding:8px 0; border-bottom:1px solid var(--border)">
+                <span>Developer Hours Saved:</span> <span id="roi-hours" style="color:var(--green)">0.00h</span>
+              </div>
+              <div style="display:flex; justify-content:space-between; padding:8px 0; border-bottom:1px solid var(--border)">
+                <span>Gross Value Produced:</span> <span id="roi-gross" style="color:var(--green)">$0.00</span>
+              </div>
+              <div style="display:flex; justify-content:space-between; padding:8px 0; border-bottom:1px solid var(--border)">
+                <span>Total Token Burn:</span> <span id="roi-burn" style="color:var(--red)">$0.00</span>
+              </div>
+              <div style="display:flex; justify-content:space-between; padding:12px 0; font-weight:700; font-size:14px;">
+                <span>NET AGENTIC ROI:</span> <span id="roi-total-pct" style="color:var(--accent)">0%</span>
+              </div>
+            </div>
+          </div>
+        </div>
+        <div class="card">
+          <div class="card-header"><div class="card-title">Governance Debt Analysis</div></div>
+          <div class="card-body">
+            <div id="debt-breakdown" style="font-family:var(--font-mono); font-size:12px;">
+              <div style="display:flex; justify-content:space-between; padding:8px 0; border-bottom:1px solid var(--border)">
+                <span>Critical Security Findings:</span> <span id="debt-critical">0</span>
+              </div>
+              <div style="display:flex; justify-content:space-between; padding:8px 0; border-bottom:1px solid var(--border)">
+                <span>Tier 3 Policy Bypasses:</span> <span id="debt-tier3">0</span>
+              </div>
+              <div style="display:flex; justify-content:space-between; padding:8px 0; border-bottom:1px solid var(--border)">
+                <span>Active Risk Level:</span> <span id="debt-risk" class="badge">MINIMAL</span>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+
     <!-- PAGE: MEMORY -->
     <div id="memory" class="page">
       <div class="grid-2">
@@ -321,9 +433,33 @@
         refreshApprovals();
         refreshMemory();
         refreshTeam();
+        refreshRevOps();
+        if (document.getElementById('temporal').classList.contains('active')) {
+            refreshTemporal();
+        }
       } catch(e) { console.error('Refresh fail', e); }
     }
 
+    async function refreshRevOps() {
+      try {
+        const res = await fetch('/api/revops/overview');
+        const data = await res.json();
+        if (data.success) {
+            updateRevOpsUI(data);
+        }
+      } catch(e) {}
+    }
+
+    let temporalHistory = [];
+    async function refreshTemporal() {
+      try {
+        const res = await fetch('/api/temporal/history');
+        const data = await res.json();
+        temporalHistory = data;
+        renderTemporalTimeline();
+      } catch(e) {}
+    }
+
     async function refreshApprovals() {
       try {
         const res = await fetch('/api/approvals');
@@ -503,8 +639,112 @@
       ctx.fill();
     }
 
+    // ── Temporal Steering Logic ────────────────────────────────────────────────
+    function renderTemporalTimeline() {
+      const slider = document.getElementById('temporal-slider');
+      const count = document.getElementById('timeline-count');
+      
+      if (temporalHistory.length === 0) {
+        slider.max = 0;
+        count.textContent = '0 Snapshots';
+        return;
+      }
+
+      slider.max = temporalHistory.length - 1;
+      count.textContent = `${temporalHistory.length} Snapshots`;
+      
+      // Default to latest if not touching
+      if (slider.value == 0 && temporalHistory.length > 0) {
+          onSliderChange(temporalHistory.length - 1);
+          slider.value = temporalHistory.length - 1;
+      }
+    }
+
+    let selectedSnapshot = null;
+    async function onSliderChange(index) {
+      const snap = temporalHistory[temporalHistory.length - 1 - index]; // reversed for chronological range
+      if (!snap) return;
+
+      selectedSnapshot = snap;
+      document.getElementById('slider-current').textContent = `Point: ${snap.id.slice(0, 8)} (${new Date(snap.timestamp).toLocaleTimeString()})`;
+      document.getElementById('inject-btn').disabled = false;
+
+      // Fetch sample audit file for this snapshot
+      try {
+        const res = await fetch(`/api/temporal/snapshot/${snap.id}/AUDIT.jsonl`);
+        const content = await res.text();
+        document.getElementById('snapshot-viewer').textContent = content || 'No audit log available for this point.';
+      } catch(e) {
+        document.getElementById('snapshot-viewer').textContent = 'Failed to load snapshot details.';
+      }
+    }
+
+    async function injectHindsight() {
+      if (!selectedSnapshot) return;
+      const instruction = document.getElementById('steering-input').value;
+      if (!instruction) {
+          alert('Please provide a steering instruction for the hindsight injection.');
+          return;
+      }
+
+      const btn = document.getElementById('inject-btn');
+      btn.disabled = true;
+      btn.textContent = 'Injecting Steering Vector...';
+
+      try {
+        const res = await fetch('/api/temporal/inject', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            auditId: selectedSnapshot.id,
+            fixDescription: instruction
+          })
+        });
+        const result = await res.json();
+        if (result.success) {
+            alert('Hindsight Injection Successful. Agent state rolled back and awaiting re-optimization.');
+            showPage('activity');
+        } else {
+            alert('Injection failed: ' + result.error);
+        }
+      } catch(e) {
+          alert('Failed to connect to temporal engine.');
+      } finally {
+          btn.disabled = false;
+          btn.textContent = 'Rewind & Inject Fix';
+      }
+    }
+
+    // ── RevOps Logic ─────────────────────────────────────────────────────────
+    function updateRevOpsUI(data) {
+        const { roi, velocity, debt } = data;
+        
+        document.getElementById('rev-roi').textContent = `${roi.roi_percentage}%`;
+        document.getElementById('rev-net').textContent = `$${roi.net_value}`;
+        document.getElementById('rev-velocity').innerHTML = `${velocity.avg_seconds_per_task} <span class="stat-unit">sec/task</span>`;
+        document.getElementById('rev-eta').textContent = `ETA: ${velocity.eta}`;
+        document.getElementById('rev-health').textContent = debt.security_health_score;
+        
+        const healthStatus = document.getElementById('rev-health-status');
+        healthStatus.textContent = `STATUS: ${debt.governance_status.toUpperCase()}`;
+        healthStatus.style.background = debt.security_health_score > 80 ? 'rgba(63, 185, 80, 0.15)' : 'rgba(248, 81, 73, 0.15)';
+        healthStatus.style.color = debt.security_health_score > 80 ? 'var(--green)' : 'var(--red)';
+
+        document.getElementById('roi-hours').textContent = `${roi.hours_saved}h`;
+        document.getElementById('roi-gross').textContent = `$${roi.gross_value}`;
+        document.getElementById('roi-burn').textContent = `$${roi.token_cost}`;
+        document.getElementById('roi-total-pct').textContent = `${roi.roi_percentage}%`;
+
+        document.getElementById('debt-critical').textContent = debt.critical_findings;
+        document.getElementById('debt-tier3').textContent = debt.tier3_approvals;
+        const riskBadge = document.getElementById('debt-risk');
+        riskBadge.textContent = debt.debt_level.toUpperCase();
+        riskBadge.className = `badge ${debt.debt_level === 'Minimal' ? 'badge-live' : ''}`;
+        if (debt.debt_level !== 'Minimal') riskBadge.style.color = 'var(--yellow)';
+    }
+
     window.onresize = drawCharts;
-    setInterval(refreshData, 30000); // Periodic full refresh
+    setInterval(refreshData, 10000); // More frequent refresh for live dashboard
     showPage('activity');
   </script>
 </body>

package/bin/dashboard/revops-api.js

@@ -0,0 +1,47 @@
+/**
+ * MindForge v5.10.0 — AgRevOps API
+ * Exposes ROI, Velocity, and Debt monitoring to the dashboard.
+ */
+'use strict';
+
+const express = require('express');
+const router = express.Router();
+const roiEngine = require('../revops/roi-engine');
+const velocityForecaster = require('../revops/velocity-forecaster');
+const debtMonitor = require('../revops/debt-monitor');
+const metricsAggregator = require('./metrics-aggregator');
+
+/**
+ * GET /api/revops/overview
+ * Returns a consolidated view of ROI, Velocity, and Governance Debt.
+ */
+router.get('/overview', (req, res) => {
+  try {
+    const metrics = metricsAggregator.getMetrics();
+    const status  = metricsAggregator.getStatus();
+    
+    // Enrich with current status for forecaster
+    const fullMetrics = { 
+        ...metrics, 
+        tasks_total: status.tasks_total || 0,
+        tasks_completed: status.tasks_completed || 0,
+        auditEntries: metricsAggregator.getAuditEntries(500) // need enough history for velocity
+    };
+
+    const roi      = roiEngine.calculate(fullMetrics);
+    const velocity = velocityForecaster.predict(fullMetrics);
+    const debt     = debtMonitor.monitor(fullMetrics);
+
+    res.json({
+        success: true,
+        roi,
+        velocity,
+        debt,
+        timestamp: new Date().toISOString()
+    });
+  } catch (err) {
+    res.status(500).json({ success: false, error: 'AgRevOps metrics retrieval failed', detail: err.message });
+  }
+});
+
+module.exports = router;