mindforge-cc 11.9.0 → 11.9.2

package/changelogs/v6.0.0-alpha.md

@@ -0,0 +1,45 @@
+# Changelog
+
+## [6.0.0-alpha] - 2026-03-29
+
+The v6.0.0-alpha release introduces the final pillar of the MindForge Enterprise architecture: AgRevOps (Agentic Revenue Operations). This engine provides real-time ROI attribution for autonomous waves, enabling enterprises to quantify the business value of every agentic reasoning cycle.
+
+## Highlights (v6.0.0-alpha)
+
+- **AgRevOps ROI Engine**: Real-time value attribution for autonomous task execution.
+- **ROI Telemetry**: New `roi-telemetry.jsonl` stream for tracking cost efficiency vs. outcome quality.
+- **Nexus Steering Sync**: Final synchronization of the `NexusTracer` and `NexusSteering` protocols into the core execution loop.
+- **Protocol Automation**: Automated activation of `_extended` mindforge skills via the Neural Orchestrator.
+
+---
+
+# MindForge v5.9.0 — Enterprise-Grade Hardening (Nexus Unification)
+
+## Top Summary (v5.9.0)
+
+The v5.9.0 release elevates the MindForge Enterprise architecture to "Enterprise-Grade" 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 (v5.9.0)
+
+- **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 (v5.8.0)
+
+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 (v5.8.0)
+
+- **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.
+- Synchronized `mindforge-cc` documentation suite for Pillar VII & VIII.
+- Updated `CLAUDE.md` with standard `_extended` protocol awareness.
+

package/changelogs/v6.1.0-alpha.md

@@ -0,0 +1,29 @@
+# Changelog
+
+## [6.1.0-alpha] - 2026-03-29
+
+### Added (v6.1.0-alpha: Sovereign Intelligence)
+
+- **Pillar IX: Autonomous Resource Harvesting (ARH)**: 
+    - Implemented `MarketEvaluator` for real-time token arbitrage.
+    - Dynamic task-to-model steering based on MIR (Min-Intelligence-Requirement).
+    - ROI Telemetry integration for tracking agentic cost-savings.
+- **Pillar X: Neural Drift Remediation (NDR)**:
+    - Implemented `LogicDriftDetector` with semantic density and repetition heuristics.
+    - Integrated `RemediationEngine` for automated reasoning recovery (Injection/Restart).
+    - Hardened `NexusTracer` hooks for real-time drift sensing.
+- **Hardened Sovereign Heuristics**: Improved repetitive logic detection using punctuation-aware token analysis.
+- **ROI Arbitrage Ledger**: New audit event `roi_arbitrage_event` in `AUDIT.jsonl`.
+
+## Top Summary (v6.1.0-alpha)
+
+MindForge v6.1.0-alpha completes the **Sovereign Intelligence** phase. The framework now possesses the ability to quantify its own economic value through resource harvesting and self-heal from cognitive decay through neural drift remediation.
+
+## Highlights (v6.1.0-alpha)
+
+- **Autonomous FinOps (ARH)**: Real-time steering between tiered models based on task MIR.
+- **Self-Healing Reasoning (NDR)**: Proactive interruption of logic loops and hallucinations.
+- **Unified Integration**: Seamless integration of NDR/ARH into the core `NexusTracer` loop.
+
+---
+

package/changelogs/v6.2.0-alpha.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## [6.2.0-alpha] - 2026-03-29
+
+### Added (v6.2.0-alpha: Sovereign Pillars XI & XII)
+
+- **Pillar XI: Post-Quantum Agentic Security (PQAS)**:
+    - Implemented `QuantumCrypto` for simulated lattice-based (Dilithium-5) signatures and ZK-Proof generation.
+    - Integrated `QuantumSafeKeyProvider` into `ZTAIManager` for Tier 4 (Quantum-Safe) agent identities.
+    - Hardened `PolicyEngine` with dynamic Biometric Challenges for Risk > 95 and ZK-Proof verification for high-leverage bypasses.
+- **Pillar XII: Proactive Semantic Homing**:
+    - Implemented `IntentHarvester` for proactive, idle-state task claiming from the Federated Intelligence Mesh (FIM).
+    - Implemented `MeshSelfHealer` for peer-to-peer collaborative reasoning and recovery from logic drift > 80.
+    - Integrated proactive behaviors into the `AutoRunner` core loop.
+- **Hardening & Verification**:
+    - Constant-time signature verification and cycle-detection for mesh healing.
+    - 100% pass rate on v7 specialized security and homing integration test suites.
+
+## Top Summary (v6.2.0-alpha)
+
+MindForge v6.2.0-alpha achieves full **Sovereign Intelligence** status by hardening the mesh against quantum-era threats and transitioning from reactive wave-processing to proactive agentic homing.
+
+## Highlights (v6.2.0-alpha)
+
+- **Quantum-Safe Identity (PQAS)**: Verifiable agentic signatures resistant to future cryptographic threats.
+*   **Proactive Homing**: Autonomous "Intent Hunting" that eliminates idle latency in the agentic mesh.
+*   **Edge-Case Biometrics**: Hardware-locked governance for catastrophic-risk operations (>95 Blast Radius).
+
+---
+

package/changelogs/v6.2.0.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## [6.2.0] - 2026-04-02
+
+### Added (v6.2.0: Sovereign Enterprise Stable)
+
+- **Autonomous Agentic Learning (Double-Hook)**:
+  - Implemented `AGENTS_LEARNING.md` as a persistent, project-level engineering memory.
+  - Added automated hooks to capture architectural patterns and anti-patterns during phase execution.
+
+- **Enterprise-Grade Professionalization**:
+  - Hardened and professionalized the entire documentation suite (Architecture, Security, Universal Commands).
+  - Hardened framework branding across all system identifiers and logs.
+  - Updated agent registry and workflow atlas for v6 consistency.
+
+- **Identity Layer Hardening**:
+  - Professionalized source code logs and identifiers for enterprise-compliance.
+  - Test suite branding and identity alignment.
+
+---
+

package/changelogs/v6.3.0.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## [6.3.0] - 2026-04-08
+
+### Added (v6.3.0: Intelligence-Drift Coupling - IDC)
+
+- **Dynamic Model Upgrading (IDC)**:
+  - Implemented `intelligence-interlock.js` to bridge NDR (Neural Drift Remediation) and ARH (Resource Arbitrage).
+  - Added "Critical Drift" alert thresholds to `LogicDriftDetector`.
+  - Integrated IDC signals into `AutoRunner`, allowing for proactive model tier upgrades when reasoning decay is detected.
+  - Hardened `RouterSteering` to respect mid-wave MIR overrides.
+
+---
+

package/changelogs/v6.4.0.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## [6.4.0] - 2026-04-08
+
+### Added (v6.4.0: Context Entropy Guard - CEG)
+
+- **Context Entropy Guard (CEG)**:
+  - Implemented `context-entropy-guard.js` for active noise suppression and context pruning.
+  - Added semantic compression to `HandoverManager`, automatically summarizing stagnant reasoning loops into digests.
+  - Hardened Nexus Bundles against "Reasoning Entropy" (similarity-based token bloat).
+
+---
+

package/changelogs/v6.5.0.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## [6.5.0] - 2026-04-08
+
+### Added (v6.5.0: Reason-Source Alignment - RSA)
+
+- **Requirement-to-Thought Mapping**: Integrated `ReasonSourceAligner` into the core Auto-Runner loop.
+- **Mission Fidelity Tracking**: Every reasoning thought is now cross-referenced with `REQUIREMENTS.md` and tagged with a best-match REQ-ID.
+- **Mission Drift Detection**: Real-time monitoring of "Mission Alignment" confidence scores to prevent autonomous side-questing.
+- **Requirement Schema**: Established formal `[REQ-ID]` Markdown schema for project specs.
+
+---
+

package/changelogs/v6.6.0.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## [6.6.0] - 2026-04-08
+
+### Added (v6.6.0: Self-Corrective Synthesis - SCS)
+
+- **Autonomous Self-Healing**: Integrated `SelfCorrectiveSynthesizer` into the `AutoRunner` wave loop.
+- **Reasoning Drift Recovery**: Triggered when Mission Fidelity (RSA) drops below 0.50, synthesizing a "Homing Instruction" anchored to specific requirements.
+- **Homing Signal Injection**: Automatically injects high-density refocus signals into the wave context to recover mission fidelity.
+
+---
+

package/changelogs/v6.7.0.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## [6.7.0] - 2026-04-09
+
+### Added (v6.7.0: Federated Intelligence Mesh - FIM Expansion)
+
+- **Architectural Health Tracking**: Aggregates RSA and IDC scores into collective project health metrics via `PillarHealthTracker`.
+- **Stability Pattern Extraction**: Captures high-efficacy SCS homing instructions as durable, sharable knowledge entries (`stability_pattern`).
+- **AutoRunner Lifecycle Hooks**: Automated capture at phase completion for organizational sync.
+
+---
+

package/changelogs/v7.0.0.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## [7.0.0] - 2026-04-11
+
+### Added (v7.0.0: Sovereign Intelligence - Post-Quantum & Homing)
+
+- **Pillar IX: Autonomous Resource Harvesting (ARH)**: Real-time token arbitrage and dynamic task-to-model steering based on MIR.
+- **Pillar X: Neural Drift Remediation (NDR)**: Logic-drift detection and automated reasoning recovery via semantic density heuristics.
+- **Pillar XI: Post-Quantum Agentic Security (PQAS)**: Lattice-based (Dilithium-5) signatures and ZK-Proof bypasses for future-proof identity.
+- **Pillar XII: Proactive Semantic Homing**: Autonomous "Intent Hunting" where agents proactively claim tasks from the Federated Intelligence Mesh (FIM).
+
+---
+

package/changelogs/v8.0.0.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## [8.0.0] - 2026-04-12
+
+### Added (v8.0.0: Celestial Orchestration - SQLite & FMS)
+
+- **Pillar XV: Unified Persistence Layer**: Transitioned from file-based JSONL state to a high-performance **SQLite** engine (`celestial.db`) with **FTS5** semantic reasoning support.
+- **Pillar XVI: Federated Mesh Synthesis (FMS)**: Inter-project knowledge sharing via signed **MindForge Bundles (`.mfb`)** using ZTAI-signed identities.
+- **Pillar XVII: Autonomous Skill Evolution (ASE)**: Implemented `SkillEvolver` to mine "Golden Traces" and synthesize reusable agentic skills.
+- **Pillar XVIII: Orbital Governance**: Hardware-bound (HSM/Biometric) attestation for catastrophic-risk mutations (>95).
+- **Core Vector Expansion**: Upgraded `VectorHub` with `better-sqlite3` and `Kysely` for type-safe, sub-millisecond persistence.
+
+---
+

package/changelogs/v8.1.0.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## [8.1.0] - 2026-04-13
+
+### Added (v8.1.0: Sovereign Identity — Pillar XIX)
+
+- **Sovereign Identity Synthesis**: Autonomous creation and evolution of `SOUL.md` from execution traces.
+- **Identity Hegemony**: Promoted `SOUL.md` to #1 Source of Truth in the instruction hierarchy.
+- **XML-Structured Workflows**: Standardized project initialization and identity management with high-fidelity XML prompting.
+- **Identity Engine**: Implemented `bin/memory/identity-synthesizer.js` with v8.1 mirroring heuristics.
+
+---
+

package/changelogs/v8.2.0.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## [8.2.0] - 2026-04-18
+
+### Added (v8.2.0: Autonomous SRE Layer — Pillars XX-XXIII)
+
+- **Sentinel Engine**: Implemented `bin/sre/sentinel.js` for continuous observability and anomaly detection in the audit stream.
+- **Shadow Mirror Isolation**: Hybrid replication system supporting Level 1 (Git) and Level 2 (Docker) deterministic isolation.
+- **Adversarial SRE Debate**: Three-way consensus protocol for high-fidelity remediation auditing.
+- **SLI-Gating Protocol**: Metric-driven verification loops to prevent performance regressions during self-healing.
+- **Persona Hardening**: Registered `sre-engineer` and `sre-auditor`, with the Auditor locked to **Claude 4.5 Opus**.
+

package/changelogs/v8.2.1.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [8.2.1] - 2026-04-25
+
+### Fixed (v8.2.1: Stability & Cleanup)
+
+- **Payload Pruning**: Removed development-only test scripts from `bin/engine` and `bin/governance`.
+- **State Sanitization**: Cleaned up local persistence files (`celestial.db`, `memory/*.jsonl`) and session-specific planning artifacts.
+- **Structural Hardening**: Restored clean templates for `.planning/HANDOFF.json` and other core descriptors.
+- **NPM Optimization**: Reduced package size by excluding unneeded build-time caches and logs.
+

package/changelogs/v9.0.0.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## [9.0.0] - 2026-04-30
+
+### Added (v9.0.0: Bedrock Meridian — Pillars XXIV-XXVIII)
+
+- **Pillar XXIV: Grounded Wave Execution** — Replaced AutoRunner stubs with real HANDOFF-driven wave parsing, task dispatch, progress tracking, and state persistence. `hasNextWave()` reads HANDOFF.json wave groups. `executeWave()` iterates tasks with audit logging and repair-operator integration. `runPreFlight()` validates project state and restores progress from `auto-state.json`.
+- **Pillar XXV: Model Topology Modernization** — Updated all model references from Claude 3.x to Claude 4.x family (`claude-opus-4-7`, `claude-sonnet-4-6`, `claude-haiku-4-5`). Updated `model-router.js`, `model-client.js`, `model-broker.js`, `cloud-broker.js`, and `MINDFORGE.md`. Aligned pricing tables and fallback chains.
+- **Pillar XXVI: Unified Memory Architecture** — Added `knowledge` and `graph_edges` tables to VectorHub (SQLite). New `saveKnowledge()`, `searchKnowledge()`, `saveEdge()`, `getEdges()` methods. FTS5 index on knowledge content. Consolidates 4 JSONL-based memory systems into a single SQLite store.
+- **Pillar XXVII: Schema Migration Engine** — Added `_migrations` table to VectorHub for tracking applied migrations. New `v9-unified-memory.js` migration script that reads legacy JSONL stores and imports into SQLite. Registered in `migrate.js` runner.
+- **Pillar XXVIII: Integration Test Chain** — New `tests/v9-integration-chain.test.js` verifying the full pipeline: wave parsing, model topology, VectorHub schema, migration engine, and SDK sync. 17 assertions across all v9 pillars.
+
+### Changed (v9.0.0)
+
+- **SDK**: Bumped `@mindforge/sdk` VERSION to `9.0.0`. Added `WaveExecutionResult` and `MigrationResult` types. Added `readAutoState()` and `isDatabaseInitialized()` to client.
+- **VectorHub**: Removed try/catch `ALTER TABLE` pattern (v8 legacy). Schema creation is now declarative via `createTable().ifNotExists()`.
+- **MINDFORGE.md**: Version bumped to `9.0.0-BEDROCK`. Model topology section normalized to Claude 4.x.
+
+---
+

package/docs/References/config-reference.md

@@ -4,24 +4,83 @@
 
 ---
 
+## 0. Syntax and required keys
+
+**Read this first.** As of 11.9.2 `node bin/validate-config.js` and
+`mindforge security-scan` can actually fail — before that they reported
+`0 settings configured` and exited 0 on any input, so an invalid registry passed silently.
+
+Two syntaxes are accepted:
+
+```text
+[PLANNER] = claude-opus-4-7      # bracketed — CANONICAL, what the shipped MINDFORGE.md uses
+PLANNER_MODEL=claude-opus-4-7    # plain — legacy, still read, used by examples/starter-project
+```
+
+Prefer the bracketed form. A bracketed key must open the line (leading whitespace is allowed)
+and be followed by `=`. Prose bullets that merely mention `[KEY]` are not parsed as settings.
+
+**These five keys are REQUIRED.** Validation exits 1 if any is missing:
+
+| Key | Example |
+| :--- | :--- |
+| `[VERSION]` | `11.9.2` — must match `^\d+\.\d+\.\d+$` |
+| `[REACTIVE_MODE]` | `true` |
+| `[PLANNER]` | `claude-opus-4-7` |
+| `[EXECUTOR]` | `claude-sonnet-4-6` |
+| `[MIN_SOUL_SCORE]` | `8` (range 0–10) |
+
+Three more are **recommended** — absent ones produce a warning, not an error:
+`[COST_WARN_USD]`, `[COST_HARD_LIMIT_USD]`, `[BLOCK_ON_SECURITY]`.
+
+> `[COST_HARD_LIMIT_USD]` is **declared but not enforced** as of 11.9.2. Do not rely on it as a
+> spend control; see the CHANGELOG.
+
+---
+
 ## 1. Model Configuration
 
 MindForge uses a tiered model routing system. You can specify exact models for different phases of the lifecycle.
 
-| Key | Description | Default |
-| :--- | :--- | :--- |
-| `PLANNER_MODEL` | Model used for task decomposition and planning. | `claude-sonnet-4-5` |
-| `EXECUTOR_MODEL` | Model used for code generation and implementation. | `claude-sonnet-4-5` |
-| `REVIEWER_MODEL` | Model used for code review and PR analysis. | `claude-opus-4-alpha` |
-| `VERIFIER_MODEL` | Model used for testing and UAT verification. | `claude-sonnet-4-5` |
-| `SECURITY_MODEL` | Model used for sensitive security scanning. | `claude-opus-4-alpha` |
-
-**Supported Values:**
-
-- `claude-opus-4-alpha` (High intelligence, slow, expensive)
-- `claude-sonnet-4-5` (Balanced, recommended)
-- `claude-haiku-4-5` (Fast, logical, best for trivial tasks)
-- `inherit` (Use the system-wide default)
+The canonical keys are the short bracketed forms; the `*_MODEL` names are accepted aliases kept
+for older configs.
+
+| Key | Alias | Description | Shipped default |
+| :--- | :--- | :--- | :--- |
+| `[PLANNER]` | `PLANNER_MODEL` | Task decomposition and planning. | `claude-opus-4-7` |
+| `[EXECUTOR]` | `EXECUTOR_MODEL` | Code generation and implementation. | `claude-sonnet-4-6` |
+| `[REVIEWER]` | `REVIEWER_MODEL` | Code review and PR analysis. | `claude-sonnet-4-6` |
+| `[VERIFIER]` | `VERIFIER_MODEL` | Testing and UAT verification. | `claude-sonnet-4-6` |
+| `[SECURITY]` | `SECURITY_MODEL` | Sensitive security scanning. | `claude-opus-4-7` |
+| `[DEBUG]` | — | Debugging and root-cause analysis. | `claude-opus-4-7` |
+
+**Values are free-form strings** — the schema does not constrain them to a list, so a new model
+id works without a framework upgrade. The ids shipped in `MINDFORGE.md` today are
+`claude-opus-4-7`, `claude-sonnet-4-6` and `claude-haiku-4-5`; `inherit` selects the
+system-wide default. Because the values are unconstrained, a typo is NOT caught by validation —
+it falls through to the routing defaults.
+
+---
+
+## 1b. Numeric bounds enforced by validation
+
+Out-of-range values now fail. These were previously documented nowhere a consumer reads.
+
+| Key | Range | Key | Range |
+| :--- | :--- | :--- | :--- |
+| `MIN_SOUL_SCORE` | 0–10 | `MAX_TASKS_PER_PHASE` | 1–50 |
+| `AUTO_SWARM_THRESHOLD` | 0–10 | `MIN_TEST_COVERAGE_PCT` | 0–100 |
+| `DYNAMISM_LEVEL` | 1–5 | `MAX_FUNCTION_LINES` | 10–200 |
+| `ADS_DEBATE_ROUNDS` | 1–10 | `MAX_CYCLOMATIC_COMPLEXITY` | 3–30 |
+| `COMPACTION_THRESHOLD_PCT` | 50–90 | `MAX_FULL_SKILL_INJECTIONS` | 1–10 |
+| `DASHBOARD_PORT` | 1024–65535 | `NEXUS_TRACE_RETENTION_DAYS` | 1–365 |
+| `BROWSER_PORT` | 1024–65535 | `SHARD_RETAIN_DAYS` | 1–365 |
+| `COST_WARN_USD` | 0–10000 | `AI_REVIEW_DAILY_LIMIT` | 0–500 |
+| `COST_HARD_LIMIT_USD` | 0–10000 | `CI_MIN_COVERAGE_PCT` | 0–100 |
+| `VERIFY_PASS_RATE_WARNING_THRESHOLD` | 0–1 | `DISCUSS_PHASE_REQUIRED_ABOVE_DIFFICULTY` | 1–5 |
+
+If one of these rejects a value you consider legitimate, the bound is wrong — report it rather
+than editing your registry to satisfy it.
 
 ---
 

package/docs/commands-reference.md

@@ -202,11 +202,11 @@ mindforge <command> [options]
 
 ## 🚀 Dynamic Workflow Library
 
-Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands. Each runs via Claude Code's `Workflow` tool with true parallel agent execution. **32 pre-built multi-agent workflows** across 5 tiers.
+Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands. Each runs via Claude Code's `Workflow` tool with true parallel agent execution. **35 pre-built multi-agent workflows** across 5 tiers.
 
 | Command | Tier | Description |
 | :--- | :--- | :--- |
-| `/mindforge:wf-catalog` | — | Browse all 32 workflows grouped by tier |
+| `/mindforge:wf-catalog` | — | Browse all 35 workflows grouped by tier |
 | **Research tier** | | |
 | `/mindforge:wf-competitive-analysis` | research | Multi-angle competitive research producing a SWOT and positioning summary |
 | `/mindforge:wf-tech-evaluation` | research | Scored technology evaluation across DX, performance, security, ecosystem, and community |
@@ -226,6 +226,8 @@ Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands.
 | `/mindforge:wf-mutation-testing` | dev | Mutant generator → parallel kill-test agents → mutation score + survival report |
 | `/mindforge:wf-code-explainer` | dev | Structural map → domain extraction → architecture patterns → guided narrative tour for onboarding |
 | `/mindforge:wf-design-system-audit` | dev | 5 parallel dimension auditors (spacing/color/typography/icons/a11y) → consistency score |
+| `/mindforge:wf-orchestrate-review` | dev | 4-lens parallel review (factual, domain, safety, style) coordinated as one panel → single merged verdict |
+| `/mindforge:wf-verification-loop` | dev | Implementer vs. scorer loop — revises against a fixed metric each round until maxed or round cap hit |
 | **Ops tier** | | |
 | `/mindforge:wf-incident-response` | ops | Parallel investigation across logs, metrics, traces, and code → mitigation → RCA → postmortem |
 | `/mindforge:wf-release-prep` | ops | Automated release pipeline: tests → changelog → version bump → PR → announcement draft |
@@ -240,6 +242,7 @@ Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands.
 | `/mindforge:wf-documentation-gen` | intelligence | Parallel per-file doc generation → style normalization → publish-ready documentation |
 | `/mindforge:wf-api-migration` | intelligence | Breaking change detection → versioning strategy → migration guide → compatibility matrix |
 | `/mindforge:wf-data-pipeline-validate` | intelligence | Pipeline stage-by-stage validation → data quality gates → anomaly detection report |
+| `/mindforge:wf-workflow-optimizer` | intelligence | Builder + scorer + optimizer roles — each round a separate agent proposes structural process changes, not just output tweaks |
 | **Beast tier** | | |
 | `/mindforge:wf-security-hardening` | beast | 5-angle OWASP parallel scout → 3-vote adversarial verification → threat model + remediation roadmap |
 | `/mindforge:wf-accessibility-audit` | beast | WCAG 2.2 parallel per-criterion audit → 3-vote adversarial verify failures → remediation spec |
@@ -247,13 +250,13 @@ Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands.
 
 ---
 
-## Dynamic Workflow Library (32 workflows)
+## Dynamic Workflow Library (35 workflows)
 
 All workflow commands follow the pattern `/mindforge:wf-<name>`.
 
 Invoke via CLI:
 ```bash
-node bin/mindforge-cli.js workflow list              # browse all 32
+node bin/mindforge-cli.js workflow list              # browse all 35
 node bin/mindforge-cli.js workflow info <name>       # phases + description
 ```
 
@@ -266,7 +269,7 @@ node bin/mindforge-cli.js workflow info <name>       # phases + description
 | `/mindforge:wf-ux-heuristic-audit` | 10 Nielsen heuristics parallel audit → fix brief |
 | `/mindforge:wf-competitive-teardown` | 5 competitor angles → positioning report |
 
-### Dev Tier (12 workflows)
+### Dev Tier (14 workflows)
 | Command | Description |
 |---------|-------------|
 | `/mindforge:wf-code-audit` | Parallel security + quality + performance audit |
@@ -281,6 +284,8 @@ node bin/mindforge-cli.js workflow info <name>       # phases + description
 | `/mindforge:wf-mutation-testing` | Mutant generator → parallel kill-test → score |
 | `/mindforge:wf-code-explainer` | Structure → domain → architecture → narrative tour |
 | `/mindforge:wf-design-system-audit` | 5-dimension parallel audit → consistency score |
+| `/mindforge:wf-orchestrate-review` | 4-lens panel (factual/domain/safety/style) → merged verdict |
+| `/mindforge:wf-verification-loop` | Implementer vs. scorer loop → re-attempts until score maxed |
 
 ### Ops Tier (6 workflows)
 | Command | Description |
@@ -292,7 +297,7 @@ node bin/mindforge-cli.js workflow info <name>       # phases + description
 | `/mindforge:wf-multi-repo-sync` | Per-repo audit → divergence map → sync plan |
 | `/mindforge:wf-cost-analysis` | Infra/API/query/bundle cost agents → ROI plan |
 
-### Intelligence Tier (6 workflows)
+### Intelligence Tier (7 workflows)
 | Command | Description |
 |---------|-------------|
 | `/mindforge:wf-onboard-codebase` | Map → domain → architecture → guided tour |
@@ -301,6 +306,7 @@ node bin/mindforge-cli.js workflow info <name>       # phases + description
 | `/mindforge:wf-documentation-gen` | Parallel doc gen → normalize → publish-ready |
 | `/mindforge:wf-api-migration` | Breaking change detection → guide → compat matrix |
 | `/mindforge:wf-data-pipeline-validate` | Stage-by-stage validation → quality gates |
+| `/mindforge:wf-workflow-optimizer` | Builder + scorer + optimizer → revises the process itself, not just outputs |
 
 ### Beast Tier (3 workflows — 5 phases, 8+ agents, adversarial 3-vote verification)
 | Command | Description |

package/docs/faq.md

@@ -40,7 +40,7 @@ Plugins are preferred for sharing and versioning.
 ## Dynamic Workflows
 
 **Q: How many workflows does MindForge v11.9.0 include?**
-32 pre-built multi-agent workflows across 5 tiers: Research (5), Dev (12), Ops (6), Intelligence (6), Beast (3).
+35 pre-built multi-agent workflows across 5 tiers: Research (5), Dev (14), Ops (6), Intelligence (7), Beast (3).
 
 **Q: How do I run a workflow?**
 Via Claude Code slash command: `/mindforge:wf-code-audit`
@@ -49,8 +49,8 @@ Via CLI: `node bin/mindforge-cli.js workflow list` to browse, then `workflow inf
 **Q: What is the Beast tier?**
 Beast tier workflows run 5 phases with 8+ concurrent agents and adversarial 3-vote verification. Included: `security-hardening`, `accessibility-audit`, `security-threat-model`.
 
-**Q: Why are there only 32 workflows when some docs say 33?**
-The `deep-research` workflow was removed before the v11.8.0 release (the superpowers built-in `/deep-research` covers this better). The correct count is 32.
+**Q: Why are there only 35 workflows when some docs say 33?**
+The `deep-research` workflow was removed before the v11.8.0 release (the superpowers built-in `/deep-research` covers this better). The correct count is 35.
 
 ## Version & Stability
 

package/docs/getting-started.md

@@ -29,6 +29,12 @@ npx mindforge-cc@latest --claude --local
 
 After installation, the `mindforge` CLI command is available for runtime operations (health checks, security scans, headless execution, etc.).
 
+**Global install** (system-wide `/mindforge` commands for your primary AI coding runtime):
+
+```bash
+npm install -g mindforge-cc@latest
+```
+
 ### 2. Claude Code plugin (self-hosted marketplace)
 
 Install MindForge as a Claude Code plugin from its marketplace:
@@ -38,6 +44,8 @@ Install MindForge as a Claude Code plugin from its marketplace:
 /plugin install mindforge@mindforge
 ```
 
+Prefer just a slice (e.g. Python agents)? Install a focused pack like `mindforge-lang@mindforge` instead. See [docs/plugin-installation.md](plugin-installation.md) for all 10 plugin packs, token-budget guidance, and team setup.
+
 ### 3. Standalone MCP server
 
 Run the MindForge MCP server (`mindforge-mcp-server`) over stdio — it exposes 7 tools (6 read-only plus 1 guarded write): `mindforge_health`, `mindforge_status`, `mindforge_memory_query`, `mindforge_memory_stats`, `mindforge_memory_find_related`, `mindforge_audit_log`, and `mindforge_memory_remember`.
@@ -62,15 +70,32 @@ To build on top of MindForge programmatically, install the TypeScript SDK:
 npm i mindforge-sdk
 ```
 
-## Dynamic Workflow Library (32 workflows across 5 tiers)
+## Configuration & Runtimes
+
+MindForge adapts to your existing engineering environment via runtime flags:
+
+| Runtime | Global Command | Local Setup |
+| :--- | :--- | :--- |
+| **Claude Code** | `mindforge-cc --claude --global` | `mindforge-cc --claude --local` |
+| **Antigravity** | `mindforge-cc --antigravity --global` | `mindforge-cc --antigravity --local` |
+| **Cursor** | `mindforge-cc --cursor --global` | `mindforge-cc --cursor --local` |
+| **GitHub Copilot** | `mindforge-cc --copilot --global` | `mindforge-cc --copilot --local` |
+| **Gemini CLI** | `mindforge-cc --gemini --global` | `mindforge-cc --gemini --local` |
+
+### Advanced Setup Options
+- **Combined Runtimes**: `mindforge-cc --runtime claude,cursor --local`
+- **With Utilities**: `mindforge-cc --local --with-utils` (Installs specialized bin scripts)
+- **Minimalist**: `mindforge-cc --local --minimal` (Only basic protocols, no persona library)
+
+## Dynamic Workflow Library (35 workflows across 5 tiers)
 
 
 | Tier | Count | Workflows |
 |------|-------|-----------|
 | Research | 5 | competitive-analysis, tech-evaluation, ai-model-eval, ux-heuristic-audit, competitive-teardown |
-| Dev | 12 | code-audit, feature-planner, pr-review, tdd-sprint, refactor-plan, test-coverage-gap, api-contract-test, debug-detective, writer-reviewer, mutation-testing, code-explainer, design-system-audit |
+| Dev | 14 | code-audit, feature-planner, pr-review, tdd-sprint, refactor-plan, test-coverage-gap, api-contract-test, debug-detective, writer-reviewer, mutation-testing, code-explainer, design-system-audit, orchestrate-review, verification-loop |
 | Ops | 6 | incident-response, release-prep, dependency-health, database-migration, multi-repo-sync, cost-analysis |
-| Intelligence | 6 | onboard-codebase, perf-optimize, architecture-modernization, documentation-gen, api-migration, data-pipeline-validate |
+| Intelligence | 7 | onboard-codebase, perf-optimize, architecture-modernization, documentation-gen, api-migration, data-pipeline-validate, workflow-optimizer |
 | Beast | 3 | security-hardening, accessibility-audit, security-threat-model |
 
 **Run any workflow:**

package/docs/sdk-reference.md

@@ -417,6 +417,6 @@ cd sdk && npm install && npm run build
 
 ## Installation
 ```bash
-npm install mindforge-sdk@11.9.0
+npm install mindforge-sdk@11.9.1
 # or: npx mindforge-cc@stable  # installs SDK as part of the framework
 ```

package/docs/user-guide.md

@@ -2,7 +2,7 @@
 
 This guide gets you from install to productive, with the minimum needed to run MindForge in a real project.
 
-> **v11.9.0 Stats:** 32 workflows · 221 slash commands · 232 engine skills · 211 personas · 0 CVEs · 258/258 IQ200 checks passing
+> **v11.9.0 Stats:** 35 workflows · 221 slash commands · 232 engine skills · 216 personas · 0 CVEs · 258/258 IQ200 checks passing
 
 ## Prerequisites
 
@@ -96,7 +96,7 @@ MindForge uses a unified 4-pillar workflow, hardened by the **Neural Protocol Me
 
 ### Dynamic Workflow Library
 
-MindForge ships **32 pre-built workflow pipelines** across **219 commands**, organized into **5 tiers**:
+MindForge ships **35 pre-built workflow pipelines** across **221 commands**, organized into **5 tiers**:
 
 | Tier | Description |
 |------|-------------|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindforge-cc",
-  "version": "11.9.0",
+  "version": "11.9.2",
   "description": "MindForge \u2014 Sovereign Agentic Intelligence Framework. Sovereign Stability: Production-Hardened Agentic Intelligence (v11)",
   "bin": {
     "mindforge-cc": "bin/install.js",
@@ -48,11 +48,13 @@
     "docs/Templates/",
     "examples/",
     "CHANGELOG.md",
+    "changelogs/",
     "LICENSE",
     "MINDFORGE.md",
     "README.md",
     "RELEASENOTES.md",
-    "SECURITY.md"
+    "SECURITY.md",
+    "!**/*.lock"
   ],
   "scripts": {
     "test": "node scripts/ci/validate-assets.js && node tests/run-all.js",
@@ -63,6 +65,7 @@
     "harness:compliance": "node bin/installer/harness-adapter-compliance.js --check",
     "release:ready": "node bin/utils/readiness-gate.js release",
     "validate:assets": "node scripts/ci/validate-assets.js",
+    "eval:retrieval": "node bin/eval/eval-harness.js --set golden-set-retrieval.json --min-recall 0.55",
     "commit": "cz",
     "prepare": "husky"
   },