mindforge-cc 5.6.0 → 6.0.0-alpha

package/docs/usp-features.md

@@ -1,383 +1,94 @@
-# MindForge v4.2.5 — Unique Selling Points, Features, and Best Practices (v4.2.5)
+# MindForge: 28 Unique Selling Points & Core Features (v6.2 Alpha)
 
-This document summarizes what makes MindForge v4.1.0 distinct, what features
-are included in the official release, and how to use them effectively.
+MindForge is the enterprise's **Agentic OS**, built on the **CADIA v6.2 (Cross-Agentic Deterministic Intelligence Architecture)** framework. It provides a self-healing, self-optimizing environment for autonomous agent execution at scale.
 
 ---
 
-## Unique Selling Points (USPs)
+## The 12 Pillars of Sovereign Intelligence
 
-1. **File‑driven governance, not magic**
-   - MindForge defines behavior through Markdown and JSON schemas, so teams can
-     audit, review, and version everything like normal code.
+1.  **Pillar I: Semantic Vector Consensus** (FIM v2) - Distributed knowledge merging.
+2.  **Pillar II: Dynamic Blast Radius** (APO v2) - Real-time risk scoring (CADIA).
+3.  **Pillar III: Predictive Agentic Reliability** (RES) - Heuristics to detect/interrupt reasoning loops.
+4.  **Pillar IV: Supply Chain Trust** (ZTAI) - Cryptographically signed skills and binary attestation.
+5.  **Pillar V: Multi-Cloud Arbitrage** (MCA) - Task-to-model affinity routing.
+6.  **Pillar VII: Hierarchical Intent Orchestration** (Nexus) - Tiered reasoning capture.
+7.  **Pillar VIII: AgRevOps ROI Engine** (Enterprise) - Quantifying economic value.
+8.  **Pillar IX: Autonomous Resource Harvesting** (ARH) - Real-time token arbitrage.
+9.  **Pillar X: Neural Drift Remediation** (NDR) - Proactive self-healing.
+10. **Pillar VI: Sovereign Reason Enclaves** (ZK-Audit) - Privacy-preserving audit trails.
+11. **Pillar XI: Post-Quantum Agentic Security** (PQAS) - Lattice-based signatures and bypasses.
+12. **Pillar XII: Proactive Semantic Homing** (Homing) - Proactive intent harvesting and mesh healing.
 
-2. **Wave‑based parallel execution**
-   - Plans run in dependency‑ordered “waves,” delivering speed without chaos.
-
-3. **Non‑bypassable compliance gates**
-   - Security, secrets, and test gates are enforced by design, not optional.
-
-4. **Session compaction with continuity**
-   - When context fills, MindForge writes machine‑readable handoffs that preserve
-     state, decisions, and next steps.
-
-5. **Production‑ready installer + updater**
-   - Full install/update/uninstall support for both Claude Code and Antigravity,
-     plus scoped updates and schema migrations.
-
-6. **Built‑in audit trail**
-   - `AUDIT.jsonl` provides a complete, append‑only history of actions and results.
-
-7. **Extensible with plugins and skills**
-   - Plugins add commands and skills without changing core files, keeping upgrades safe.
-
-8. **Autonomous “Walk-Away” Execution (v2)**
-   - `/mindforge:auto` allows for full phase/milestone completion with intelligent stuck detection and node repair (RETRY → DECOMPOSE → ESCALATE).
-
-9. **Persistent Visual QA (v2)**
-   - Headful/headless browser runtime with named session persistence and systematic visual diff verification.
-
-10. **Multi-Model Intelligence Layer (v2)**
-    - Dynamic routing between Anthropic, OpenAI, and Gemini based on task persona and security tier. Adversarial code reviews ensure maximum coverage.
-
-11. **Persistent Knowledge Graph (RAG 2.0)**
-    - Captures and ranks engineering context (decisions, bug patterns, preferences) with **Automatic Semantic Shadowing** — background pattern retrieval without manual prompts.
-
-12. **Real-time Observability Dashboard (v3)**
-    - High-fidelity web interface for live audit streams, metrics visualization, and **Temporal History Scrubbing** with zero performance overhead.
+---
 
-13. **Self-Building Skills Platform (v3)**
-    - Automatically capture and score engineering patterns from docs, npm, or session history into high-quality `SKILL.md` files with non-bypassable quality gates.
+## 26 Elite Unique Selling Points (USPs)
 
-14. **Context Sharding (v3)**
-    - 40% reduction in token waste via **Semantic Relevance Density (SRD)** management of Hot/Warm/Cold context tiers.
+1.  **File-Driven Governance**: Behavior defined by Markdown/JSON, auditable like code.
+2.  **Wave-Based Parallel Execution**: Dependency-ordered clusters for speed without chaos.
+3.  **Non-Bypassable Compliance Gates**: 5 mandatory safety checks (Secrets, CVEs, Tests, etc.).
+4.  **Session Compaction & Continuity**: Machine-readable handoffs to preserve state across context turns.
+5.  **Production-Grade Installer**: Built-in update/uninstall and schema migration suite.
+6.  **Immutable Audit Trail**: Append-only `AUDIT.jsonl` for total transparency.
+7.  **Modular Skill Registry**: Extend capabilities without altering core engine files.
+8.  **Autonomous "Walk-Away" (v2)**: Intelligence repair (RETRY → DECOMPOSE) for independent work.
+9.  **Persistent Visual QA**: Browser runtime with visual diff verification.
+10. **Adversarial Multi-Model Review**: Cross-model validation (Gemini/Claude) for critical paths.
+11. **Automatic Semantic Shadowing**: RAG 2.0 with background pattern retrieval.
+12. **Temporal History Scrubbing**: "Time-Travel" dashboard to inspect and steer past states.
+13. **Self-Building Skills Platform**: Capture patterns from docs/npm into validated `SKILL.md` files.
+14. **Semantic Relevance Density (SRD)**: 40% reduction in token waste via tiered context sharding.
+15. **Red-Team Decision Synthesis**: Zero architectural drift through debate loops.
+16. **Hindsight Injection**: Correct logic errors on-the-fly via the Nexus temporal injector.
+17. **Dynamic Swarm Mesh**: Orchestrated specialist sub-agents with shared `SWARM-STATE`.
+18. **DID-Signed Identity (ZTAI)**: Non-repudiable logs backed by Decentralized Identifiers.
+19. **Sentinel Runtime Attestation**: Cryptographic integrity checks for every logic module.
+20. **Reasoning Entropy Scoring (RES)**: Proactive interruption of semantic deadlocks.
+21. **Nexus Temporal Slider**: High-fidelity dashboard for reasoning navigation.
+22. **AgRevOps Financial Governance**: Real-time dollar-value mapping per agentic cycle.
+23. **CADIA Blast Radius Optimizer**: Real-time architectural risk assessment (0-100).
+24. **Sovereign ROI Arbitrage**: Automated steering to lowest-cost/highest-value model tiers.
+25. **Ghost Pattern Detection**: Automated planning-phase detection of past architectural failures.
+26. **Sentinel Execution Center**: Centralized JIT attestation and reasoning guardrail enforcement.
 
-15. **Adversarial Decision Synthesis (v3)**
-    - Zero architectural drift through Red-Team/Blue-Team debate loops and automated synthesis scoring.
+---
 
-16. **Temporal Vision (v3)**
-    - Full-fidelity history navigation, hindsight injection, and automated state repair across the execution wave.
+## Sovereign Core Feature Set
 
-17. **Dynamic Swarm Orchestration (v4)**
-    - Parallel "Agentic Mesh" with shared state (`SWARM-STATE.json`) and leader-led synthesis of specialist outcomes.
+### 1. Unified Intelligence Layer
+Unified API for Anthropic, OpenAI, and Gemini with persona-based routing and budget enforcement.
 
-18. **Zero-Trust Agentic Identity "Beast Mode" (v4.2)**
-    - Non-repudiable audit trails signed by unique Decentralized Identifiers (DIDs) for every swarm action. Tier 3 agents use simulated **Secure Enclave (HSM)** signing.
+### 2. Autonomous Workflow Engine
+End-to-end lifecycle management: `/plan` → `/execute` → `/verify` → `/ship`.
 
-19. **MindForge Nexus: Agentic Reasoning Tracing (v4.1)**
-    - High-fidelity **ART** spans embedded in the execution engine, providing deep visibility into agentic "thought chains" and parallel mesh reasoning.
+### 3. Agentic Observability
+Real-time web dashboard for audit streams, reasoning heatmaps, and financial metrics.
 
-20. **Global Intelligence Mesh (v4.2)**
-    - Cross-repository knowledge sharing via the **Semantic Hub**. Proactive **Ghost Pattern Detection** identifies and prevents repeating past organizational failures.
+### 4. Zero-Trust Security
+Mandatory DID signatures, JIT skill attestation, and "Default Deny" posture for sensitive files.
 
-19. **MindForge Nexus: Agentic Reasoning Tracing (v4.1)**
-    - High-fidelity **ART** spans embedded in the execution engine, providing deep visibility into agentic "thought chains" and parallel mesh reasoning.
+### 5. Multi-Project Memory (Global Mesh)
+Organizational-level knowledge sharing via the Global Intelligence Mesh.
 
 ---
 
-## Feature Set (v2.0.0)
-
-### 1. Installation & Distribution
-**What it does:** Production‑grade installer with update, uninstall, and CI support.
+## Execution Guide (v6.1 Alpha)
 
-**How to use:**
 ```bash
-npx mindforge-cc@latest --claude --global
-npx mindforge-cc@latest --claude --local
-npx mindforge-cc@latest --antigravity --global
-```
-
----
-
-### 2. Core Workflow Engine
-**What it does:** End‑to‑end lifecycle for planning, execution, verification, and shipping.
-
-**How to use:**
-```
+# Core Cycle
 /mindforge:init-project
 /mindforge:plan-phase 1
 /mindforge:execute-phase 1
 /mindforge:verify-phase 1
 /mindforge:ship 1
-```
-
----
-
-### 3. Wave Execution
-**What it does:** Runs independent plans in parallel waves based on dependencies.
-
-**How to use:**
-- Create a phase plan with dependencies
-- Run `/mindforge:execute-phase N`
-- MindForge groups tasks into waves automatically
-
----
-
-### 4. Governance & Compliance Gates
-**What it does:** Enforces secret scanning, CRITICAL security findings, tests,
-CVE checks, and GDPR retention.
-
-**How to use:**
-```
-/mindforge:security-scan --deep --secrets --deps
-/mindforge:verify-phase 1
-```
-
----
-
-### 5. Intelligence Layer
-**What it does:** Health checks, difficulty scoring, anti‑pattern detection,
-team profiling, and metrics.
-
-**How to use:**
-```
-/mindforge:health
-/mindforge:metrics
-/mindforge:profile-team
-```
-
----
-
-### 6. Skills Platform
-**What it does:** Loads skill packs on keyword triggers (Core/Org/Project tiers).
-
-**How to use:**
-```
-/mindforge:skills list
-/mindforge:skills validate
-```
-
----
-
-### 7. Plugin System
-**What it does:** Extends MindForge with new commands, skills, personas, and hooks.
-
-**How to use:**
-```
-/mindforge:plugins list
-/mindforge:plugins install mindforge-plugin-<name>
-/mindforge:plugins validate
-```
-
----
-
-### 8. Migration Engine
-**What it does:** Safely upgrades `.planning/` schemas across versions with backups.
-
-**How to use:**
-```
-/mindforge:migrate --from v0.6.0 --to v1.0.0
-```
-
----
 
-### 9. Self‑Update System
-**What it does:** Checks for updates, shows changelog diff, applies updates while
-preserving scope (local vs global).
-
-**How to use:**
-```
-/mindforge:update
-/mindforge:update --apply
-```
-
----
-
-### 11. Autonomous Execution (v2)
-**What it does:** Enables handoff-free execution of complex phases and milestones.
-
-**How to use:**
-```bash
-/mindforge:auto --phase 1
-/mindforge:steer "Focus on security hardening next"
+# Sovereign Commands
+/mindforge:auto --phase 1    # Autonomous Walk-Away
+/mindforge:costs --roi       # Detailed ROI analysis
+/mindforge:cross-review      # Adversarial review
+/mindforge:memory sync       # Global Mesh sync
 ```
 
 ---
 
-### 12. Browser Runtime & Visual QA (v2)
-**What it does:** Playwright-powered browser control with session persistence and automated UI bug detection.
-
-**How to use:**
-```bash
-/mindforge:browse --navigate https://example.com
-/mindforge:qa --diff
-```
-
----
-
-### 13. Multi-Model Intelligence (v2)
-**What it does:** Unified API client for Anthropic, OpenAI, and Gemini with persona-based routing and automated cost tracking.
-
-**How to use:**
-```bash
-/mindforge:cross-review # Adversarial multi-model review
-/mindforge:research "Deep search query" # 1M context research
-/mindforge:costs # Usage and budget summary
-```
-
----
-
-### 14. Persistent Knowledge Graph (v2)
-**What it does:** Long-term memory system that ensures architectural decisions and bug patterns are never forgotten. Supports TF-IDF search, confidence scoring, and global promotion.
-
-**How to use:**
-```bash
-/mindforge:remember --add "insight" # Manual capture
-/mindforge:remember --search "query" # Manual retrieval
-/mindforge:remember --promote [ID] # Promote to machine-wide global store
-/mindforge:remember --stats # View memory health
-```
-
----
-
-### 18. Adversarial Decision Synthesis (v3)
-**What it does:** Ensures architectural integrity by debating every major decision through competing model personas.
-
-**How to use:**
-```bash
-/mindforge:cross-review --ads # Triggers heavy synthesis mode
-```
-
----
-
-### 19. Temporal Vision & Hindsight (v3)
-**What it does:** Provides the "Temporal Slider" for the Dashboard and the `hindsight-injector` for automated state repair.
-
-**How to use:**
-```bash
-/mindforge:temporal status
-/mindforge:temporal inject [AUDIT_ID]
-```
-
----
-
-### 20. Context Sharding Manager (v3)
-**What it does:** Dramatically improves session longevity by sharding context based on sematic relevance.
-
-**How to use:**
-```bash
-/mindforge:memory shard
-/mindforge:memory status --srd
-```
-
----
-
-### 21. Dynamic Swarm Mesh (v4)
-**What it does:** Orchestrates parallel specialist clusters (e.g., Security, UI, Data) with automated state coordination.
-
-**How to use:**
-```bash
-/mindforge:swarm spawn --template [NAME]
-/mindforge:swarm status --mesh
-```
-
----
-
-### 22. ZTAI Governance & Beast Mode (v4.2)
-**What it does:** Enforces cryptographic signing and trust-tier validation for all autonomous agent actions. Tier 3 agents utilize simulated Secure Enclaves for principal-level non-repudiation.
-
-**How to use:**
-```bash
-/mindforge:identity verify [AGENT_ID]
-/mindforge:identity sign --did
-/mindforge:identity audit --manifest # Generates Merkle-root integrity proof
-```
-
----
-
-### 23. Global Intelligence Mesh (v4.2)
-**What it does:** Synchronizes local repo memory with a global organizational store. Includes Ghost Pattern Detection to flag architectural anti-patterns from past failures.
-
-**How to use:**
-```bash
-/mindforge:memory sync --global
-/mindforge:memory status --mesh
-/mindforge:plan-phase --detect-ghosts # Automated during planning
-```
----
-
-### 24. Autonomous FinOps Hub (v4.3)
-**What it does:** Enterprise-grade economics engine that treats compute as a first-class resource. The `ModelBroker` utilizes a **Confidence-to-Cost (C2C)** engine to dynamically route tasks based on complexity and trust tier.
-
-**How to use:**
-```bash
-/mindforge:finops status # View consumption and budget profile
-/mindforge:costs --roi # Detailed Agentic ROI analysis
-/mindforge:finops budget 500 # Set project-level budget ($500)
-```
-
----
-
-### 25. Proactive Equilibrium (Self-Healing) (v4.3)
-**What it does:** Achieves autonomous reliability via a `WaveFeedbackLoop`. If execution divergence exceeds 20%, the system performs **Temporal Hindsight** analysis and automatically rewrites the plan to recover.
-
-**How to use:**
-- Automated: Triggers during `/mindforge:execute-phase` when divergence is detected.
-- Manual: `/mindforge:temporal analyze` to run RCA on the last wave.
-**What it does:** High-fidelity Agentic Reasoning Tracing (ART) for the agentic mesh. Logs spans, parent-trace IDs, and granular reasoning traces.
-
-**How to use:**
-- Automated: Every wave/task execution triggers Nexus Tracer spans.
-- Manual: Query `.planning/AUDIT.jsonl` for `trace_id` and `span_id` chains.
-- Dashboard: Real-time visualization of mesh traces and reasoning heatmaps.
-
----
-
-### 15. SDK (TypeScript)
-**What it does:** Programmatic access to health, audit log, event stream, and commands.
-
-**How to use:**
-```ts
-import { MindForgeClient } from '@mindforge/sdk';
-const client = new MindForgeClient({ projectRoot: '.' });
-const report = await client.health();
-```
-
----
-
-## Best Practices for v2.0.0
-
-1. **Always run health after install**
-   - `/mindforge:health --repair` fixes drift immediately.
-
-2. **Keep PLAN files lean**
-   - Focus on *what*, not *how* (150–400 words).
-
-3. **Use local installs for repos**
-   - Local installs are safer and prevent cross‑project drift.
-
-4. **Run migrations explicitly**
-   - Don’t rely on auto‑inference when upgrading older state files.
-
-5. **Treat plugins like production dependencies**
-   - Validate plugins and prefer pinned versions.
-
-6. **Use the audit log as ground truth**
-   - Query `.planning/AUDIT.jsonl` for accountability and traceability.
-
-7. **Gate Tier 3 changes through approvals**
-   - CI will block Tier 3 changes without explicit approval.
-
-8. **Keep secrets out of files**
-   - Use environment variables only. MindForge enforces this.
-
----
-
-## Using MindForge for Your Requirements
-
-### If you need strict governance
-- Run full workflow (`plan → execute → verify → ship`)
-- Enable security scans and approvals
-
-### If you need fast iteration
-- Use `/mindforge:quick` for single tasks
-- Keep local install with minimal setup
-
-### If you need team scale
-- Use milestones, approvals, and `/mindforge:profile-team`
-- Enable CI mode for consistent enforcement
-
----
-
 ## Summary
-MindForge v4.3.0 combines governance, observability, and autonomous execution rigor with **enterprise-grade economics (FinOps)** and **self-healing reliability**. Its core value is providing a non-repudiable, cost-optimized, and resilient AI development engine for the most demanding software projects.
+MindForge v6.1.0-alpha **Sovereign Intelligence** represents the pinnacle of the Agentic OS evolution. By combining **Interactive Temporal Steering** and **AgRevOps Financial Governance** with the core Sentinel security layer, it provides the first framework capable of self-correcting logic drift and quantifying its own economic value in real-time.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mindforge-cc",
-  "version": "5.6.0",
-  "description": "MindForge - Enterprise Agentic Framework for Claude Code and Antigravity",
+  "version": "6.0.0-alpha",
+  "description": "MindForge — Sovereign Agentic Intelligence Framework. (CADIA v6.2 & PQAS Enabled)",
   "bin": {
     "mindforge-cc": "bin/install.js"
   },