mindforge-cc 5.10.0 → 6.1.0-alpha

package/bin/wizard/theme.js

@@ -15,6 +15,8 @@ const Theme = {
     dim: (s) => (TTY ? `\x1b[2m${s}\x1b[0m` : s),
     bold: (s) => (TTY ? `\x1b[1m${s}\x1b[0m` : s),
     italic: (s) => (TTY ? `\x1b[3m${s}\x1b[0m` : s),
+    magenta: (s) => (TTY ? `\x1b[35m${s}\x1b[0m` : s), // Quantum Security
+    orange: (s) => (TTY ? `\x1b[38;5;208m${s}\x1b[0m` : s), // Semantic Homing
   },
 
   chars: {
@@ -59,11 +61,13 @@ const Theme = {
    */
   printBrandManifest() {
     console.log(`  ${this.colors.dim('│')}`);
-    console.log(`  ${this.colors.dim('│')}  ${this.colors.green('🎉 V2.3.0 IS HERE!')} Welcome to MindForge V2!`);
+    console.log(`  ${this.colors.dim('│')}  ${this.colors.magenta('🛡️  SOVEREIGN INTELLIGENCE v6.2.0-alpha')} — PQAS & Proactive Homing Enabled`);
     console.log(`  ${this.colors.dim('│')}`);
     console.log(`  ${this.colors.dim('│')}  ${this.colors.bold('THE PLATFORM VISION:')}`);
     console.log(`  ${this.colors.dim('│')}    - Unified Enterprise Agentic Ecosystem`);
     console.log(`  ${this.colors.dim('│')}    - Modular Skills & Persona Architecture`);
+    // Added Sovereign Intelligence as a core pillar
+    console.log(`  ${this.colors.dim('│')}    - ${this.colors.magenta('Sovereign Intelligence')}: PQ-Safe & Proactive Swarms`);
     console.log(`  ${this.colors.dim('│')}    - Autonomous Governance & Self-Healing`);
     console.log(`  ${this.colors.dim('│')}`);
     console.log(`  ${this.colors.dim('│')}  ${this.colors.yellow('🌟 100% FREE & OPEN SOURCE')}`);

package/docs/CAPABILITIES-MANIFEST.md

@@ -0,0 +1,64 @@
+# MindForge v6.2.0-alpha — Capabilities Manifest
+
+This manifest provides a line-item inventory of every engine, protocol, and feature available in the MindForge "Beast Mode" installation.
+
+## 🛡️ 1. Sovereign Intelligence (Pillars IX-XII)
+The latest advancement in agentic security and proactivity.
+- **Post-Quantum Agentic Security (PQAS)**: 
+    - `QuantumCrypto`: Lattice-based (Dilithium-5) signature simulation for framework integrity.
+    - `ZK-Audit`: Zero-Knowledge proof generation for policy-compliant reasoning.
+    - `Integrity-Verify`: Constant-time manifest verification of framework files.
+- **Proactive Homing**:
+    - `IntentHarvester`: Idle-state task claiming from the Intelligence Mesh.
+    - `MeshSelfHealer`: Peer-to-peer drift detection and recovery logic.
+    - `DriftSense`: Repetition and density-aware loop detection (NDR).
+
+## 🌊 2. Autonomous Swarms (Nexus Engine)
+The core asynchronous execution environment.
+- **NexusTracer**: High-fidelity, async-first reasoning capture and tracing.
+- **WaveExecutor**: Parallel, dependency-aware task execution with prioritized queuing.
+- **TemporalProtocols**: Time-travel debugging, state versioning, and hindsight injection.
+- **ContextInjector**: Dynamic prompt-injection based on environmental signals.
+- **ShardController**: Support for distributed project state across multiple workspaces.
+
+## ⚖️ 3. Enterprise Governance (AgRevOps)
+Tiered security and value attribution for large-scale operations.
+- **Tiered Compliance Gates**:
+    - **Tier 1 (Core)**: Standard operations.
+    - **Tier 2 (Sensitive)**: Requires impact analysis.
+    - **Tier 3 (High-Impact)**: Requires executive/biometric approval (>95 blast radius).
+- **AgRevOps ROI Engine**: 
+    - `MarketEvaluator`: Real-time token arbitrage and model steering.
+    - `ROIAuditor`: Automated value attribution for completed waves.
+- **RBAC Manager**: Role-Based Access Control for persona identities and skill execution.
+
+## 🧠 4. Memory & Knowledge Hub
+The semantic foundation for long-term intelligence.
+- **Global Knowledge Graph**: Multi-project semantic index of decisions and patterns.
+- **SemanticHub**: Federated memory synchronization across distributed enclaves.
+- **GhostPatternDetector**: Identifies emerging antipatterns and optimized workflows autonomously.
+- **SessionMemoryLoader**: Fast-start context restoration from previous sessions.
+
+## 🤝 5. Enterprise Integrations
+Native adapters for the modern engineering stack.
+- **Jira Sync**: Bidirectional issue and milestone synchronization.
+- **Confluence Sync**: Automated architecture and roadmap documentation mirroring.
+- **Slack/Discord Hubs**: Real-time event notifications and approval requests.
+- **GitHub Actions Support**: CI-integrated validation and PR review pipelines.
+
+## 👤 6. Persona Library (30+ Identities)
+Specialized agent essences available via `node bin/spawn-agent.js`.
+- **Strategic**: `mf-planner`, `architect`, `tech-writer`.
+- **Implementation**: `mf-executor`, `developer`, `ui-checker`.
+- **Quality**: `mf-reviewer`, `nyquist-auditor`, `security-reviewer`.
+- **Specialized**: `debug-specialist`, `research-synthesizer`, `user-profiler`.
+
+## 🛠 7. CLI Command Suite (64+ Commands)
+Comprehensive control via `mindforge-cli.js`.
+- **Strategic**: `init-project`, `milestone`, `plan-phase`, `ship`.
+- **Operational**: `auto`, `headless`, `steer`, `stuck-monitor`.
+- **Governance**: `security-scan`, `approve`, `audit`, `metrics`, `tokens`.
+- **Sovereign**: `harvest`, `self-heal`, `quantum-verify`.
+
+---
+*MindForge v6.2.0-alpha "Beast Mode" — Empowering the Autonomous Enterprise.*

package/docs/INTELLIGENCE-MESH.md

@@ -1,49 +1,37 @@
-# MindForge Federated Intelligence Mesh (FIM) (v5.6.0)
-MindForge v5.6.0 — Sentinel-Aware Distributed Intelligence
+# MindForge Federated Intelligence Mesh (FIM) (v6.2.0-alpha)
+MindForge v6.2.0-alpha — Sovereign & Proactive Distributed Intelligence
 
 ## 1. Overview
-The **Federated Intelligence Mesh (FIM)** is the enterprise-grade evolution of the Global Intelligence Mesh. It transitions MindForge from machine-local memory to a distributed organizational intelligence network. Using a central **Enterprise Intelligence Service (EIS)**, FIM enables seamless, authenticated knowledge synchronization across all agents and projects in the enterprise.
+The **Federated Intelligence Mesh (FIM)** is the enterprise-grade evolution of the Global Intelligence Mesh. It transitions MindForge from machine-local memory to a distributed organizational intelligence network. In v6.2.0, FIM evolves from a reactive knowledge store to a **Proactive Homing** mesh where agents actively hunt for intents and collaboratively heal reasoning drift.
 
 ## 2. Architecture
-The V5 mesh is built on three core pillars residing in `bin/memory/`:
+The V6 mesh is built on four core pillars:
 
 ### A. EIS Client (`eis-client.js`)
 - **Role**: Secure, authenticated communicator for the central intelligence hub.
-- **Hardening**: Implements **ZTAI-signed authentication headers**. Every request is cryptographically tied to a verified agent identity (DID).
-- **Communication**: REST-based push/pull protocols with integrity-verified payloads.
+- **Hardening**: Implements **ZTAI-signed authentication headers** with **Post-Quantum (PQAS)** signature support for Tier 4.
 
 ### B. Federated Sync (`federated-sync.js`)
-- **Role**: High-performance synchronization engine between local stores and the organizational mesh.
-- **Delta Sync**: Tracks the `last_sync` timestamp to only pull new organizational insights, significantly reducing latency and compute costs.
-- **Conflict Resolution**: Uses **Hybrid Semantic Synthesis** (Pillar I v5.2.0). 
-  - **Similarity > 0.9**: Near-identical; auto-resolve via **Last-Write-Wins (LWW)**.
-  - **0.75 - 0.9**: Semantic Overlap; triggers **Autonomous ADS Merging**.
-  - **0.6 - 0.75**: Conflict; triggers **Nexus Handover (DHH)** for human steering.
-  - **< 0.6**: Topic Collision; isolates entries into unique IDs to prevent data loss.
-
-### C. Knowledge Graph Bridge (`knowledge-graph.js`)
-- **Role**: Unified memory interface that resolves both local project nodes and remote federated nodes.
-- **Hybrid Traversal**: BFS/DFS algorithms that seamlessly traverse edges spanning across the local-to-global boundary.
+- **Role**: High-performance synchronization engine.
+- **Proactive Homing (v6.2.0)**: Idle agents now use the `IntentHarvester` to proactively pull unassigned tasks from the mesh, reducing orchestrator overhead and latency.
 
-### D. Predictive Reliability Integration (v5.5.0)
-The FIM now monitors the "intelligence flux" of the shared mesh using **Reasoning Entropy Scoring (RES)**.
-- **Mesh Loop Prevention**: Prevents agents from sharing circular or stagnant reasoning patterns back to the central hub.
-- **Steering Vector Sync**: High-confidence steering vectors generated by `TemporalHindsight` are shared across the mesh as "Sovereign Design Patterns" to proactively fix common agentic failure modes.
+### C. Mesh Self-Healer (`mesh-self-healer.js`)
+- **Role**: Peer-to-peer collaborative recovery.
+- **Collaborative Reasoning**: When a mesh node detects a reasoning drift score > 80, peer agents automatically "home in" on the node via the mesh to provide adversarial synthesis and recovery vectors.
 
-### E. Sentinel-Aware Mesh Trust (v5.6.0)
-The mesh enforces **Binary Runtime Attestation** for all shared skills.
-- **Trusted Knowledge Exchange**: Only knowledge generated by agents with a verified Tier 3 DID and a non-tampered skill stack is accepted into the global mesh.
-- **ZTS-Hash Verification**: Every piece of federated intelligence is linked to the SHA-256 hash of the skill that produced it.
+### D. Knowledge Graph Bridge (`knowledge-graph.js`)
+- **Role**: Unified memory interface that resolves both local project nodes and remote federated nodes.
 
 ## 3. Workflow & Provenance
-1. **Verified Capture**: High-confidence findings (>0.8 score) are automatically prepared for mesh promotion.
-2. **Identity-Locked Push**: The `FederatedSync` pushes these findings to the EIS, signed by the originating agent's ZTAI DID.
-3. **Organizational Delta Pull**: Subagents starting new tasks perform a delta-pull to ingest the latest organizational "Ghost Patterns" and success-verified designs.
+1. **Intent Harvesting**: The `IntentHarvester` proactively claims tasks from the FIM based on skill-affinity.
+2. **Verified Capture**: High-confidence findings are automatically prepared for mesh promotion.
+3. **Identity-Locked Push**: The `FederatedSync` pushes findings to the EIS, signed by the agent's ZTAI/PQAS DID.
+4. **Autonomous Healing**: Peer agents proactively reconcile drifting waves in the mesh.
 
 ## 4. Enterprise Value
-- **Verifiable Intelligence**: All knowledge in the mesh has an immutable audit trail back to the agent that discovered it.
-- **Global Self-Healing**: A security vulnerability found in project A becomes a proactive guardrail in project B within seconds.
-- **Elimination of Redundancy**: Multi-thousand-token research chains are executed once and shared universally across the mesh.
+- **Zero-Latency Orchestration**: Proactive task claiming eliminates idle time between waves.
+- **Quantum-Safe Trust**: Modern lattice-based signatures protect the mesh from future cryptographic threats.
+- **Distributed Resilience**: The mesh is a self-healing engine where every agent monitors the health of the whole.
 
 ---
-*Status: V5.2.0 Semantic Consensus Implemented & Verified (2026-03-28)*
+*Status: V6.2.0 Sovereign Pillars XI & XII Implemented & Verified (2026-03-29)*

package/docs/MIND-FORGE-REFERENCE-V6.md

@@ -0,0 +1,96 @@
+# MindForge v6.2.0-alpha — Comprehensive Reference Guide
+
+This is the definitive "Beast Mode" manual for the MindForge ecosystem. It details every command, persona, skill, workflow, and automation hook available in the v6.2.0-alpha distribution.
+
+---
+
+## 🛠 Chapter 1: Command Suite (64+ Core Commands)
+Commands can be invoked directly via the Agent or via the `node bin/mindforge-cli.js` router.
+
+### 🛡️ Strategic & Governance Commands
+| Command | Description | Invocation | How to Test |
+| :--- | :--- | :--- | :--- |
+| `/mindforge:security-scan` | OWASP Top 10 + Sovereign Integrity check. | `/mindforge:security-scan [path] --deep` | Create a test file with an API key and run the scan. |
+| `/mindforge:status` | Real-time project and Sovereign engine health. | `/mindforge:status` | Verify the status reports "Sovereign: Manifested". |
+| `/mindforge:approve` | Generate cryptographic signature for Tier 3 gates. | `/mindforge:approve` | Run on a change with >95 impact score. |
+| `/mindforge:audit` | Query historical reasoning and compliance logs. | `/mindforge:audit --phase 1` | Check `AUDIT.jsonl` for the output. |
+| `/mindforge:health` | 7-pillar diagnostic of framework integrity. | `/mindforge:health` | Verify all modules report as "HEALTHY". |
+| `/mindforge:tokens` | Analyze model usage costs and efficiency. | `/mindforge:tokens --report` | Check for the ROI calculation in the output. |
+
+### 🚀 Operational & Execution Commands
+| Command | Description | Invocation | How to Test |
+| :--- | :--- | :--- | :--- |
+| `/mindforge:auto` | Autonomous execution engine (Wave mode). | `/mindforge:auto` | Run on a planned phase with 3+ independent tasks. |
+| `/mindforge:steer` | Inject mid-execution guidance into the swarm. | `/mindforge:steer [instruction]` | Use during a long-running `/mindforge:auto` session. |
+| `/mindforge:headless` | Run MindForge in background/daemon mode. | `/mindforge:headless` | Check `bin/autonomous/headless.js` pid. |
+| `/mindforge:ship` | Multi-adapter release and PR pipeline. | `/mindforge:ship` | Run after a phase is verified (UAT pass). |
+
+---
+
+## 👤 Chapter 2: Specialized Personas (25+ Essence Profiles)
+Personas are located in `.mindforge/personas/` and are loaded via the `mf-identity` protocol.
+
+### 🧠 Core Reason Enclaves
+- **mf-planner**: Strategic architect. Focuses on minimal complexity and high-fidelity roadmapping.
+- **mf-executor**: Implementation pilot. Expert in "Beast Mode" styling and robust logic.
+- **mf-reviewer**: Quality auditor. Enforces OWASP, performance, and clean code standards.
+- **security-reviewer**: Focused on PQAS integrity and threat modeling.
+- **debug-specialist**: RCA (Root Cause Analysis) expert with persistent state tracking.
+
+**Invocation**: `node bin/spawn-agent.js identity [persona-name]`
+**Testing**: Load a persona and ask for its "Primary Directive" to verify identity lock.
+
+---
+
+## 📚 Chapter 3: SkillStacks (10+ Subject Matter Skills)
+Skills are located in `.mindforge/skills/` and provide specialized domain knowledge.
+
+- **agency-senior-developer**: Expert implementation of modern web stacks.
+- **agency-software-architect**: System design and architectural patterns.
+- **agency-security-engineer**: Threat detection and post-quantum hardening.
+- **agency-ai-engineer**: ML model optimization and agentic steering.
+- **agency-ux-architect**: Fluid animations and premium interface design.
+
+**Invocation**: Automatic via the Neural Orchestrator when relevant tasks are detected.
+**Testing**: Ask for a specific domain task (e.g., "Review this SQL for injection") and verify the correct skill triggers.
+
+---
+
+## 🔄 Chapter 4: Logic Workflows (50+ Interaction Flows)
+Workflows are located in `.agent/workflows/` and define multi-step reasoning patterns.
+
+- **mindforge:discuss-phase**: Requirement gathering -> Assumption analysis -> Planning.
+- **mindforge:execute-phase**: Plan reading -> Wave parallelization -> Self-healing.
+- **mindforge:verify-work**: UAT criteria -> Browser testing -> Evidence capture.
+- **mindforge:ship**: PR creation -> Documentation update -> Version bump.
+
+**Invocation**: Triggered by slash commands or phase transitions.
+**Testing**: Run `/mindforge:next` and verify the agent follows the correct workflow state.
+
+---
+
+## 🔗 Chapter 5: Automation Hooks (6+ Lifecycle Guards)
+Hooks are located in `.agent/hooks/` and enforce framework integrity.
+
+- **mindforge-prompt-guard**: Prevents prompt injection and jailbreak attempts.
+- **mindforge-workflow-guard**: Ensures commands are only run in the correct phase state.
+- **mindforge-statusline**: Provides real-time status telemetry to the terminal.
+- **pre-commit-security**: Runs a `--secrets` scan before every git commit.
+
+**Testing**: Try to commit a file with a dummy API key (should be blocked).
+
+---
+
+## ✨ Chapter 6: Sovereign Intelligence Matrix (v6.2.0-alpha)
+The peak of MindForge architectural pillars (IX-XII).
+
+### 🛡️ Post-Quantum Agentic Security (PQAS)
+- **Quantum-Crypto**: Core engine for lattice-based verification.
+- **Test**: `node bin/governance/quantum-crypto.js --verify .mindforge/engine/`.
+
+### 🏠 Proactive Semantic Homing
+- **Intent-Harvester**: Proactive idle-task claiming engine.
+- **Test**: `node bin/autonomous/intent-harvester.js --status`.
+
+---
+*MindForge v6.2.0-alpha "Beast Mode" — Absolute Sovereignty. Absolute Performance.*

package/docs/architecture/README.md

@@ -1,15 +1,15 @@
 # MindForge Architecture Overview
 
-MindForge v5.0.0 is built on a distributed "Agentic OS" architecture, designed for enterprise-scale intelligence sharing and absolute governance.
+MindForge v6.0.0 is built on a distributed "Agentic OS" architecture, designed for enterprise-scale intelligence sharing and absolute governance.
 
 ---
 
-## 1. Core Architectural Pillars (v5.0.0)
+## 1. Core Architectural Pillars (v6.0.0)
 
-The framework is focused on six major pillars, with V5 introducing the **Distributed Intelligence** and **Policy Governance** layers:
+The framework is focused on eight major pillars, with V6 introducing the **Neural Blast Radius Optimizer (CADIA)**:
 
 1. **Federated Intelligence Mesh (FIM)**: Distributed knowledge sharing with delta-sync and cryptographic provenance. [V5-ENTERPRISE.md](./V5-ENTERPRISE.md)
-2. **Agentic Policy Orchestrator (APO)**: Non-bypassable policy-as-code governance that intercepts autonomous intents.
+2. **CADIA Engine (v6.0.0 Alpha)**: Neural Blast Radius Optimizer that calculates real-time architectural risk based on influence, entropy, and alignment.
 3. **Predictive Agentic Reliability (PAR)**: Self-healing reasoning loops and context refactoring. [PAR-ZTS-SURVEY.md](./PAR-ZTS-SURVEY.md)
 4. **Supply Chain Trust (ZTS)**: Agentic SBOM and 7-dimension skill certification. [PAR-ZTS-SURVEY.md](./PAR-ZTS-SURVEY.md)
 5. **Zero-Trust Agentic Identity (ZTAI)**: DID-based cryptographic signing for all agentic actions and tiered trust enforcement.

package/docs/architecture/V5-ENTERPRISE.md

@@ -13,15 +13,17 @@ The FIM transitions MindForge from local knowledge silos to a shared organizatio
 - **Enterprise Resilience & Governance (v5.1.0)**: A high-availability central hub for sharing high-confidence agentic findings across the entire enterprise.
 - **ZTAI-Signed Provenance**: Every piece of knowledge in the mesh is cryptographically tied to the DID of the agent that generated it.
 
-### Pillar II: Agentic Policy Orchestrator (APO)
+### Pillar II: Agentic Policy Orchestrator (APO) — CADIA Engine (v6.0.0 Alpha)
 
-# MindForge Governance Guide (v5.1.0)
-MindForge v5.1.0 introduces a non-bypassable, intent-level governance layer that evaluates every autonomous wave against organizational security policies.
+# MindForge Governance Guide (v6.0.0)
+MindForge v6.0.0 introduces **Context-Aware Dynamic Impact Analysis (CADIA)**, a non-bypassable, architectural governance layer that evaluates every autonomous wave against organizational security and risk policies.
 
-- **Policy-as-Code (PaC)**: Security rules are defined in declarative JSON/YAML schemas, enabling version-controlled governance.
-- **Real-Time Intent Interception**: The `AutoRunner` intercepts swarm intents (Action, Resource, DID, Tier) before execution.
-- **Dynamic RBAC Mapping**: v5.1.0 automatically maps ZTAI Trust Tiers to project roles based on an agent's **Zero-Trust Agentic Identity (ZTAI)** trust tier.
-- **Fail-Safe Governance**: "Default Deny" posture for sensitive operations (API key access, infra modification, etc.).
+- **Policy-as-Code (PaC)**: Security rules are defined in declarative JSON schemas, enabling version-controlled governance.
+- **Dynamic Blast Radius Analysis**: Calculates real-time architectural risk based on file influence, session entropy (multi-file modification speed), and goal alignment.
+- **Session Entropy Guardrails**: Risk increases logarithmically as an agent touches more files, preventing "Rogue Wave" mass corruption.
+- **ZTAI-Trust Weighting**: Senior agents (Tier 3) gain "Architectural Credit," while Tier 1-2 agents are kept under strict risk caps.
+- **Reasoning Proof Bypass**: Tier 3 agents can override high-risk blocks by providing a cryptographically signed "Reasoning Proof."
+- **Enterprise Audit Log**: All evaluations are logged to `.planning/RISK-AUDIT.jsonl` for compliance reporting.
 
 ### Pillar III: Predictive Agentic Reliability (PAR) (v5.5.0)
 
@@ -61,13 +63,22 @@ SRE provides a "Confidential Computing" environment for the agent's internal tho
 - **Non-Custodial Verification**: New `verifyZKProof` utility allows auditors to cryptographically verify that an agent followed policy within the enclave without ever seeing the raw thoughts.
 - **Thought-Chain Sanitization**: Automated redaction of sensitive patterns (keys, credentials, PII) from reasoning traces before persistent certificate generation.
 
-### Pillar VII: Dynamic Human-Agent Handover (DHH)
+### Pillar VII: Interactive Temporal Steering (NEXUS)
 
-DHH creates a seamless bridge between fully autonomous execution and high-precision human steering.
+NEXUS transforms the `NexusTracer` from a passive observer into an active temporal control plane, enabling sub-second state reconstruction and hindsight injection.
 
-- **Nexus State Bundles**: Automated "Context Freeze" and packaging of memory, diffs, and reasoning traces when agent confidence drops below 60%.
-- **Mid-Wave Steering**: In-flight steering injection into the `AutoRunner` loop, allowing humans to re-orient an active autonomous wave without restarts.
-- **Confidence-to-Human Gating**: Proactive interruption of the autonomous stream for "Human-in-the-Loop" approval on sensitive T3 operations.
+- **Temporal History Slider**: Real-time navigation through the agent's reasoning-space, allowing for high-fidelity state inspection at any point in the execution wave.
+- **Hindsight Injection Protocol**: Allows for the injection of "Steering Vectors" into past reasoning nodes to re-orient the agent's logic without a full session restart.
+- **Rollback-to-State**: Automated state reconstruction that resets the environment and `.planning/` directory to match a specific `auditId` signature.
+- **Dynamic Handover (DHH)**: Integrated confidence-based human escalation when reasoning entropy remains high after steering.
+
+### Pillar VIII: Agentic Revenue Operations (AgRevOps)
+
+AgRevOps treats agentic compute as a first-class financial and governance asset, providing real-time ROI and accountability.
+
+- **ROI Logic Engine**: Maps complex task completions (refactor, test, audit) to developer-hour savings ($100/hr) vs. provider token costs.
+- **Velocity Forecaster**: Predictive analytics that calculate milestone completion ETAs based on historical task-weight throughput and system latency.
+- **Governance Debt Monitoring**: Tracks policy bypasses and high-risk security findings to compute a "Security Health Score" (SHS), ensuring framework liability remains within enterprise bounds.
 
 ---
 
@@ -98,6 +109,9 @@ DHH creates a seamless bridge between fully autonomous execution and high-precis
 | **Recovery Agent** | `bin/engine/temporal-hindsight.js` | Generates steering vectors for proactive recovery. |
 | **Skill Validator** | `bin/skill-validator.js` | JIT Binary Runtime Attestation and 7D scoring. |
 | **SRE Manager** | `bin/engine/sre-manager.js` | Trusted execution enclave management. |
+| **ROI Engine** | `bin/revops/roi-engine.js` | Financial value synthesis and cost/benefit mapping. |
+| **Velocity Forecaster** | `bin/revops/velocity-forecaster.js` | Predictive milestone ETA and throughput analytics. |
+| **Debt Monitor** | `bin/revops/debt-monitor.js` | Security Health Score (SHS) and governance debt tracking. |
 | **Handover Manager** | `bin/engine/handover-manager.js` | Nexus bundle creation and steering logic. |
 | **SBOM Tracer** | `bin/engine/nexus-tracer.js` | SRE-aware audit logging and manifest generation. |
 

package/docs/architecture/V6-SOVEREIGN.md

@@ -0,0 +1,43 @@
+# MindForge v6.1.0-alpha: Sovereign Intelligence (Pillars IX & X)
+
+The **Sovereign Intelligence** phase elevates MindForge from reactive autonomous waves to a self-optimizing, self-healing agentic operating system. This is achieved through real-time financial arbitrage and proactive reasoning integrity monitoring.
+
+---
+
+## Pillar IX: Autonomous Resource Harvesting (ARH)
+
+### Goal
+To maximize the economic efficiency of agentic work by dynamically harvesting the lowest-cost, highest-intelligence compute resources in real-time.
+
+### Components
+- **`MarketEvaluator`**: Real-time tracker for token pricing and intelligence benchmarks across model providers (Anthropic, OpenAI, Gemini).
+- **`RouterSteeringV2`**: Advanced task-to-model affinity engine. It calculates the **Min-Intelligence-Requirement (MIR)** and steers tasks accordingly.
+- **ROI Arbitrage Engine**: Automatically calculates and logs the "dollar value" saved by every autonomous wave compared to standard premium-only routing.
+
+### Workflow
+1. **MIR Analysis**: Before a subagent is spawned, the `CloudBroker` analyzes the task taxonomy.
+2. **Arbitrage Selection**: The `MarketEvaluator` selects the optimal model (e.g., routing small fixes to a local model while keeping architectural reasoning on Gemini 1.5 Pro).
+3. **Telemetry**: Savings are logged to `AUDIT.jsonl` under the `roi_arbitrage_event` category.
+
+---
+
+## Pillar X: Neural Drift Remediation (NDR)
+
+### Goal
+To proactively detect and remediate "Reasoning Drift" (logic loops, hallucinations, and semantic decay) before it corrupts the autonomous execution wave.
+
+### Components
+- **`LogicDriftDetector`**: Heuristics-based engine that analyzes the `reasoning_trace` for semantic density, pattern repetition, and logical contradictions.
+- **`RemediationEngine`**: A stateful recovery system that can trigger `REASONING_RESTART`, `GOLDEN_TRACE_INJECTION`, or `AUTONOMY_HALT`.
+- **NexusTracer Hooks**: Deep integration into the core execution loop to intercept every reasoning span.
+
+### Workflow
+1. **Drift Sensing**: At every 10 reasoning nodes, the `NexusTracer` evaluates the current `DriftScore` (0-100).
+2. **Remediation Trigger**: If `DriftScore > Threshold` (Default 75), the `RemediationEngine` is invoked.
+3. **Audit Closure**: Every remediation action is logged as a `drift_remediation_event`, ensuring the "hindsight" is preserved for future sessions.
+
+---
+
+## Architectural interlock (V6.1)
+
+Sovereign Intelligence is the final layer of the MindForge Enterprise roadmap. It leverages the **CADIA** risk engine (v6.0) and the **ZTAI** identity layer (v5.x) to ensure that all self-healing actions are both safe and non-repudiable.

package/docs/commands-reference.md

@@ -1,4 +1,4 @@
-# MindForge v5.6.0 — Commands Reference
+# MindForge v6.0.0-alpha — Commands Reference
 
 MindForge commands are organized into functional pillars to support the entire software development lifecycle (SDLC).
 

package/docs/feature-dashboard.md

@@ -1,4 +1,4 @@
-# Feature: Real-time Dashboard (v4.1.0)
+# Feature: Real-time Dashboard (v5.10.0)
 
 The MindForge Real-time Dashboard provides a high-fidelity, web-based control center for your agentic workflows. It leverages **Server-Sent Events (SSE)** to push live updates from your codebase directly to your browser with zero performance overhead.
 
@@ -33,11 +33,17 @@ Default access: `http://localhost:7339` (Strictly bound to `127.0.0.1` for secur
 - **Persona Context**: See which agent personas are currently active.
 - **Steerage Feed**: View steering instructions as they are applied.
 
-### 5. MindForge Nexus (v4.1+)
+### 5. MindForge Nexus (v5.10+)
 - **ART Trace Explorer**: Drill down into hierarchical reasoning spans and thought chains.
-- **Mesh Topology**: Visual graph of the active agentic mesh and specialist clusters.
+- **Temporal Control Center**: Dynamic slider-based navigation of reasoning history.
+- **Hindsight Injection**: Rollback project state to any previous `auditId` and inject steering instructions to correct drift.
 - **Reasoning Heatmaps**: Identifying areas of adversarial disagreement and drift in real-time.
 
+### 6. AgRevOps Financial Hub (v5.10+)
+- **ROI Hub**: Real-time tracking of developer-hour value ($100/hr) vs. token expenditure.
+- **Velocity Forecaster**: Predictive analytics for milestone completion ETAs based on live task throughput.
+- **Security Health Score (SHS)**: Dynamic 0-100 score reflecting governance debt and policy compliance.
+
 ## 🛡 Hardened Security
 - **Localhost Binding**: The server refuses connections from external IPs.
 - **CORS Lock-down**: Only allows requests from the local control plane.

package/docs/governance-guide.md

@@ -1,69 +1,99 @@
-# MindForge Governance Guide (v5.6.0)
-Absolute Control through Policy-as-Code (PaC)
+# MindForge Governance Guide (v6.2.0-alpha)
+V6.2.0 Sovereign Intelligence: PQAS & Proactive Homing
 
 ## 1. Goal
-MindForge v5.6.0 introduces a non-bypassable, intent-level governance layer. This guide explains how **Agentic Policy Orchestration (APO)**, **Zero-Trust Agentic Identity (ZTAI)**, and the **Sentinel Execution Center** work together to secure the enterprise development lifecycle.
+MindForge v6.2.0 achieves the final stage of **Sovereign Intelligence**, introducing post-quantum safe identities (PQAS) and proactive agentic homing. This eliminates reactive latency in the mesh and ensures long-term cryptographic resilience against future threats.
 
-## 2. Agentic Policy Orchestrator (APO)
+## 2. Post-Quantum Agentic Security (Pillar XI)
+MindForge implements Pillar XI to harden the identity layer against future quantum computing threats.
+
+### A. Lattice-Based Cryptography
+- **Signature Algorithm**: Dilithium-5 (Lattice-based).
+- **Key Exchange**: Kyber-1024 (Lattice-based).
+- **Hardening**: Every Tier 4 agent action is signed with quantum-safe primitives, ensuring non-repudiation in the post-quantum era.
+
+### B. ZK-Proof Compliance Bypasses
+For high-leverage architectural changes, Tier 3+ agents can generate a **Zero-Knowledge Proof** (simulated SNARK) to verify policy adherence without exposing confidential reasoning logic.
+
+## 3. Proactive Semantic Homing (Pillar XII)
+Pillar XII transitions the autonomous swarm from reactive wave-processing to proactive, self-healing "Homing" behavior.
+
+### A. Intent Harvesting
+Agents in an idle state proactively scan the **Federated Intelligence Mesh (FIM)** for unassigned tasks, claiming them based on **Skill-Affinity** scores to eliminate idle latency.
+
+### B. Mesh Self-Healing
+When an agent experiences critical logic drift (>80), peer agents in the mesh proactively "home in" on the node to provide collaborative reasoning and recovery vectors.
+
+## 4. Agentic Policy Orchestrator (APO) — CADIA Engine
 The APO is a decentralized governance engine that intercepts every autonomous intent before it is executed.
 
 ### A. Intent Interception
 Before the `AutoRunner` begins a new execution wave, it extracts the acting agent's **Intent**:
 - **DID**: The unique identity of the agent.
-- **Action**: The operation being attempted (e.g., `process_phase_wave`, `modify_security_config`).
+- **Action**: The operation being attempted (e.g., `WRITE`, `DELETE`, `EXECUTE`).
 - **Resource**: The target of the action (e.g., specific directories, files, or API endpoints).
 - **Tier**: The ZTAI Trust Tier assigned to the agent.
+- **SessionId**: The unique identifier for the current autonomous session.
+- **Reasoning Proof**: (Tier 3 Only) A justification for high-risk architectural actions.
+
+### B. Policy Evaluation (v6.0.0)
+The upgraded `PolicyEngine` evaluates the intent using the CADIA scoring model:
+1.  **Blast Radius Calculation**: The `ImpactAnalyzer` computes a risk score (0-100) based on architectural influence, session history, and goal alignment.
+2.  **Tier-Based Enforcement**: 
+    - **Score > 25 (LOW)**: Permitted for Tier 1+.
+    - **Score > 50 (MEDIUM)**: Permitted for Tier 2+.
+    - **Score > 80 (CRITICAL)**: **Denied** (Default) for Tier 0-2.
+    - **Tier 3 Bypass**: Senior agents can override a CRITICAL score if a valid `reasoning_proof` is provided.
+
+## 3. CADIA: Dynamic Impact Analysis Logic
+The **ImpactAnalyzer** calculates a precision-weighted score using the follow heuristics:
 
-### B. Policy Evaluation
-The `PolicyEngine` evaluates this intent against organizational **Policy-as-Code (PaC)** definitions (typically stored in `bin/governance/policies/`).
-- **Permit**: The action is allowed and execution proceeds.
-- **Deny**: The action is blocked, and the violation is logged to `AUDIT.jsonl`.
-- **Blast Radius Denial (v5.3.0)**: Action is blocked if the `Impact Score` exceeds the policy `max_impact` threshold.
-- **Escalate**: The action requires a higher-tier DID signature or explicit HITL (Human-in-the-Loop) approval.
-- **Attestation Blocking (v5.6.0)**: Executing a skill without a valid HSM-signed signature is blocked.
+### A. Architectural Influence Engine (x2.5)
+High-influence files (Core, Governance, Models, and Project State) increase the blast radius score significantly.
+- **Paths**: `bin/governance/*`, `bin/engine/*`, `package.json`, `.planning/*`.
 
-## 3. Trust Tier Architecture (ZTAI Hardened)
-V5.1.0 automatically maps ZTAI Trust Tiers to explicit project roles through the `RBACManager`.
+### B. Sensitive Namespace Protection (x4.0)
+Strict multipliers for mission-critical directories:
+- **Namespaces**: `.mindforge/`, `bin/`, `config/`, `.agent/`.
+
+### C. Session Entropy Tracker (+15 per file)
+To prevent "Rogue Wave" mass-corruption, the risk score increases for every file touched in a single session after the 5th modification.
+- **Penalty**: `(session_count - 5) * 15`.
+
+### D. Goal-to-Path Alignment (+40 penalty)
+The system cross-references targets against the **Current Phase** in `.planning/STATE.md`.
+- **Anomalous Behavior**: If an agent tasked with "Fixing UI" attempts to modify `bin/models/cloud-broker.js`, a large penalty is applied.
+
+### E. ZTAI-Trust Scaling (Risk Buffers)
+Trust Tiers (0-3) provide a risk "overhead" buffer:
+- **Tier 1**: -10 points.
+- **Tier 2**: -20 points.
+- **Tier 3**: -30 points (Sovereign Trust).
+
+## 4. Trust Tier Architecture (ZTAI Hardened)
+V6.0.0 maps ZTAI Trust Tiers to explicit project roles through the `RBACManager`.
 
 | Tier | Role | Scope | Hardening |
 | :--- | :--- | :--- | :--- |
-| **0** | Informational | Research/Query only. | Read-only access to non-sensitive docs. |
-| **1** | Implementation| Standard feature dev. | Write access to `/src`, `/tests`, `/bin/memory`. |
-| **2** | Specialized | Security/DevOps Specialist. | Access to `/security`, `/infra`, and `/bin/governance`. |
-| **3** | Principal | Lead Architect / Core Engine. | **HSM-Enclave Signing Required** for all engine modifications. |
-
-### A. Zero-Trust Skill Protocol (v5.6.0)
-The Sentinel layer enforces binary runtime attestation for all skills.
-- **ZTAI Signing**: Developers must use `mindforge-cc sign <skill>` to cryptographically lock a skill. This computes a SHA-256 hash and signs it with a Tier 3 DID.
-- **JIT Verification**: Every `SKILL.md` is verified upon loading. If the hash does not match the signature registry, the `AutoRunner` blocks the skill.
-- **Enterprise Mode**: Strict enforcement requires 100% attestation for all library skills.
-
-### B. Reasoning Entropy Guardrails (v5.5.0)
-The framework proactively monitors the "reasoning space" of the agent to prevent token-burn and logical drifting.
-- **RES Scoring**: `NexusTracer` evaluates reasoning steps for semantic redundancy.
-- **Stagnation Recovery**: When entropy falls below the safety threshold, the system interrupts the wave and injects a **Steering Vector** to force a logical pivot.
-
-## 5. Governance Workflow (V5.1.0)
-1. **ZTAI Handshake**: Agent proves identity using Ed25519 signatures.
-2. **Intent Pulse**: Agentic intent is broadcast to the policy interceptor.
-3. **APO Evaluation**: Policy engine checks the intent against PaC rules.
-4. **Role binding**: `RBACManager` grants or revokes permissions based on the active trust tier.
-5. **Verified Wave**: Execution proceeds only if all policy gates are clear.
+| **0** | Informational | Research/Query only. | Read-only. No CADIA bypass. |
+| **1** | Implementation| Standard feature dev. | Write to `/src`, `/tests`. Session limit: 5 files. |
+| **2** | Specialized | Security/Ops Specialist. | Access to `/security`, `/infra`. Higher risk cap (60). |
+| **3** | Principal | Lead Architect / CEO. | **Full CADIA Bypass** (with Reasoning Proof). |
+
+## 5. Enterprise Audit & Compliance (RISK-AUDIT)
+Every governance evaluation is persistently recorded in `.planning/RISK-AUDIT.jsonl`. This log provides a high-fidelity trail for enterprise compliance:
+- **requestId**: Unique ID for every evaluation.
+- **impactScore**: The final CADIA risk score (0-100).
+- **verdict**: PERMIT or DENY.
+- **reason**: Detailed explanation for the decision (e.g., "Violation: Max Impact Exceeded").
 
 ## 6. Enterprise Policies
-MindForge v5.1.0 ships with default policies including:
+MindForge v6.0.0 ships with default policies including:
 - **`gate_tier_3_engine`**: Blocks all modifications to `bin/autonomous/` unless signed by a Tier 3 DID.
 - **`protect_security_namespace`**: Limits access to `/security` and `/governance` to Tier 2+ specialists.
-- **`mesh_integrity_lock`**: Ensures only high-confidence agents can push to the **Federated Intelligence Mesh**.
-- **`enforce_blast_radius` (v5.3.0)**: Dynamic policy that limits `DELETE` impact to <30 for Tier 1 agents.
-- **`require_skill_attestation` (v5.6.0)**: Forces all skills to have valid ZTAI-signatures before loading.
-- **`monitor_reasoning_entropy` (v5.5.0)**: Automated loop detection and steering for long-running autonomous waves.
-
-## 7. Dynamic Blast Radius (v5.3.0)
-The **ImpactAnalyzer** calculates a score (0-100) for every intent:
-- **Action Type**: `DELETE` (10), `WRITE` (5), `READ` (1).
-- **Sensitivity**: 4x multiplier for `.mindforge/`, `bin/`, and `config/` namespaces.
-- **Fail-Safe**: Defaults to Score 100 (CRITICAL) if analysis fails.
+- **`enforce_blast_radius` (v6.0.0)**: Dynamic policy that enforces a strict 60-point cap for non-Sovereign agents.
+- **`require_skill_attestation`**: Forces all skills to have valid ZTAI-signatures before loading.
 
 ---
-*Status: V5.3.0 Dynamic Blast Radius Implemented & Verified (2026-03-28)*
+*Status: V6.0.0 CADIA (Context-Aware Dynamic Impact Analysis) Implemented & Verified (2026-03-29)*
+

package/docs/registry/AGENTS.md

@@ -0,0 +1,37 @@
+# MindForge — Agent Identity Registry (v6.2.0-alpha)
+
+This registry catalogs the specialized agent identities available for direct invocation and autonomous collaboration within the MindForge mesh.
+
+## 👤 Interaction Layer (Public Identifiers)
+
+| Agent | Core Persona | Interaction Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **mf-planner** | Strategic Architect | Planning & Roadmapping | "Design systems with 10/10 fidelity." |
+| **mf-executor** | Lead Developer | Feature Implementation | "Ship premium-grade code by default." |
+| **mf-reviewer** | Quality Auditor | Review & Validation | "Find the bugs before they ship." |
+| **mf-memory** | Semantic Clerk | Knowledge & History | "Manage the knowledge graph sync." |
+| **mf-researcher** | Discovery Agent | Deep Context Search | "Surface the unknown-unknowns." |
+| **mf-tool** | System Operator | CLI & Environment | "Execute system transformations safely." |
+
+## 🛡️ Specialized Sovereign Agents
+
+| Agent | Core Persona | Operational Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **security-reviewer** | Threat Hunter | Security Hardening | "Secure the framework against threats." |
+| **nyquist-auditor** | Logic Auditor | Requirement Tracing | "Ensure 100% requirement coverage." |
+| **debug-specialist** | RCA Expert | Systematic Debugging | "Debug with persistent state tracking." |
+| **ui-auditor** | Visual Designer | Aesthetic Excellence | "Ensure 10/10 aesthetics & UX." |
+| **verifier** | UAT Specialist | Evidence Validation | "Prove functionality with visual proof." |
+
+## 🧠 Autonomous Swarm Enclaves
+
+| Agent | Core Persona | Collaborative Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **qa-engineer** | Logic Guard | Adversarial Testing | "Find failure modes in the logic." |
+| **tech-writer** | Knowledge Lead | Documentation Sync | "Transform complexity into clarity." |
+| **research-agent** | Data Scraper | Recursive Discovery | "Gather data points from web/repo." |
+| **roadmapper** | Execution Lead | Milestone Sequencing | "Derive phases from requirements." |
+| **user-profiler** | Behavioral Lead | Personalized DX | "Adapt to the unique user needs." |
+
+---
+*For more details, see the [MIND-FORGE-REFERENCE-V6.md](../MIND-FORGE-REFERENCE-V6.md).*