mindforge-cc
v9.0.0
Published
MindForge — Sovereign Agentic Intelligence Framework. Bedrock Meridian: Grounded Execution (Pillars XXIV-XXVIII)
Maintainers
Readme
MindForge v9.0.0 — Bedrock Meridian (Grounded Execution)
MindForge v9.0.0 "Bedrock Meridian" grounds previously-stub implementations into real, auditable execution. This release introduces grounded wave dispatch via HANDOFF.json, consolidates all memory stores into a single SQLite database, modernizes the model topology to the Claude 4.x family, and adds a 27-assertion integration test chain — completing the transition from framework scaffolding to production-verified infrastructure (Pillars XXIV-XXVIII).
Installation & Setup
🚀 Quick Start (No Install)
Run MindForge immediately for a specific runtime without a permanent installation:
# For Claude Code
npx mindforge-cc@latest --claude --global
# For Antigravity
npx mindforge-cc@latest --antigravity --global🌍 Global Installation
Enable system-wide /mindforge commands for your primary AI coding runtime:
npm install -g mindforge-cc@latest📂 Local Project Setup
Initialize MindForge in an existing repository with specialized agent identities:
# For Claude Code
npx mindforge-cc@latest --claude --local
# For Antigravity
npx mindforge-cc@latest --antigravity --localGrounded Wave Execution (v9.0.0) — AutoRunner reads HANDOFF.json wave groups, dispatches tasks with audit tracing, persists progress, and resumes on restart (Pillar XXIV).
Model Topology Modernization (v9.0.0) — All model references updated to the Claude 4.x family: claude-opus-4-7, claude-sonnet-4-6, claude-haiku-4-5 (Pillar XXV).
Unified Memory Architecture (v9.0.0) — Knowledge and graph edges consolidated into SQLite (celestial.db) with FTS5 search. Four JSONL stores replaced by one queryable store (Pillar XXVI).
Schema Migration Engine (v9.0.0) —
_migrationstable with versioned migration tracking and transaction-wrapped bulk imports (Pillar XXVII).Integration Test Chain (v9.0.0) — 27-assertion end-to-end test suite validating the full execution pipeline (Pillar XXVIII).
Sovereign Identity Synthesis (v8.1.1) — Autonomous
SOUL.mdgeneration derived from reasoning traces and interaction sentiment (Pillar XIX).Autonomous SRE Layer (v8.2.0) — Self-healing production reliability engine with reactive sentinel observability and adversarial remediation auditing (Pillars XX-XXIII).
Unified Persistence Layer (v8.0) — Centralized SQLite/FTS5 engine for sub-millisecond reasoning audits and semantic reasoning (Pillar XV).
Federated Mesh Synthesis (v8.0) — Signed knowledge handoffs via MindForge Bundles (
.mfb) and federated intelligence synchronization (Pillar XVI).Autonomous Skill Evolution (v8.0) — Self-generating persistent skills from reasoning traces with logic-drift mining (Pillar XVII).
Orbital Governance (v8.0) — Hardware-bound (HSM/Biometric) attestation for high-blast-radius security gates (Pillar XVIII).
Post-Quantum Agentic Security (v7.0) — Lattice-based (Dilithium-5) signatures and ZK-Proof bypasses (Pillar XI).
Proactive Semantic Homing (v7.0) — Autonomous "Intent Hunting" and peer-healing mesh behavior (Pillar XII).
Autonomous Resource Harvesting (v7.0) — Real-time token arbitrage and dynamic task routing (Pillar IX).
Neural Drift Remediation (v7.0) — Semantic density heuristics and automated reasoning recovery (Pillar X).
Interactive Temporal Steering (v5.10) — Full history scrubbing, hindsight state repair, and real-time temporal slider navigation (Pillar VII).
AgRevOps Hub (v6.0) — Dynamic ROI tracking ($100/hr mapping), Milestone Velocity forecasting, and Governance Debt monitoring (Pillar VIII).
Sovereign Reason Enclave (v5.8) — TEE-simulated reasoning isolation with Zero-Knowledge (ZK) Audit Trails (Pillar VI).
Multi-Cloud Arbitrage (v5.7) — Dynamic routing across Vertex AI, Bedrock, and Azure with intelligence-first task affinity (Pillar V).
Sentinel Execution (v5.6) — JIT Binary Runtime Attestation and Zero-Trust Skill Enforcement (Pillar IV).
Predictive Agentic Reliability (v5.5) — Advanced loop detection and self-healing resonance (Pillar III).
Dynamic Blast Radius (v5.3) — Real-time impact analysis and circuit-breaker safety in the federated sync (Pillar II).
Semantic Vector Consensus (v5.2) — FIM v2 with cosine-similarity conflict resolution (Pillar I).
Human-Agent Handover (v5.0) — Nexus State Bundles and mid-wave steering injection.
Autonomous FinOps (v4.3) — Dynamic C2C (Confidence-to-Cost) routing.
Proactive Equilibrium (v4.3) — Real-time Wave Divergence monitoring and autonomous state recovery.
MindForge Nexus (v4.1) — High-fidelity ART (Agentic Reasoning Tracing).
Zero-Trust Identity (v4.2) — DID-signed non-repudiable audit logs with HSM/Enclave support.
Global Intelligence Mesh (v4.2) — Cross-repo knowledge sharing and Ghost Pattern Detection.
Context Sharding (v3) — relevance-dense memory management (40% token savings)
Adversarial Synthesis (v3) — zero-drift logic through red/blue model debate
RAG 2.0 (v3) — automatic semantic shadowing for background pattern retrieval
Role personas — specialised agent modes for each task type
Specialized Identities — custom
/agents/workspace with enrichedIDENTITY.mdprotocolsSkills — just-in-time domain knowledge loaded on demand
Wave execution — parallelism with dependency safety
Autonomous Engine — walk-away execution with steerability
Real-time Dashboard — web-based observability with Temporal Slider
Browser Runtime — headful/headless visual QA and sessions
Multi-Model Intelligence — dynamic routing, adversarial reviews, and deep research (v2)
Persistent Knowledge Graph — long-term memory across all engineering sessions (v2)
Self-Building Skills — automatically capture knowledge from any source into reusable skills (v2)
Quality gates — compliance and security are non-bypassable
Audit trail — append-only history of every action
🛠️ 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)
Verify
Open Claude Code or Antigravity in your project directory and run:
/mindforge:healthIf issues are found, run:
/mindforge:health --repairQuick start (new project)
/mindforge:init-project
/mindforge:plan-phase 1
/mindforge:execute-phase 1
/mindforge:verify-phase 1
/mindforge:ship 1Quick start (existing codebase)
/mindforge:map-codebase
/mindforge:do I want to plan the next phase
/mindforge:plan-phase 1Core workflow
/mindforge:init-project
→ Requirements interview
→ Creates PROJECT.md, REQUIREMENTS.md, STATE.md
/mindforge:do <text>
→ Smart natural language dispatcher (v2)
/mindforge:note <text>
→ Zero-friction idea capture and todo promotion (v2)
/mindforge:ui-phase 1
→ Create UI design contract (UI-SPEC.md) (v2)
/mindforge:plan-phase 1 [--ads]
→ Discuss scope and decisions
→ Research domain (parallel)
→ Create atomic XML task plans
→ (Optional) Run Adversarial Decision Synthesis (ADS) loop
/mindforge:execute-phase 1
→ Wave-based parallel execution
→ One commit per task
→ Automated verification
/mindforge:ui-review 1
→ Retroactive 6-pillar visual audit (v2)
/mindforge:validate-phase 1
→ Requirement coverage and test gap audit (v2)
/mindforge:session-report
→ Automated post-session stakeholder summary (v2)
/mindforge:add-backlog <desc>
→ Park ideas in 999.x "parking lot" (v2)
/mindforge:review-backlog
→ Review and promote backlog items (v2)
/mindforge:plant-seed <idea>
→ Capture speculative ideas with triggers (v2)
/mindforge:workstreams
→ Parallel feature tracks with isolated state (v2)
/mindforge:execute-phase 1
→ Wave-based parallel execution
→ One commit per task
→ Automated verification
/mindforge:verify-phase 1
→ Human acceptance testing
→ Debug agent on failures
→ UAT sign-off
/mindforge:ship 1
→ Changelog generation
→ Final quality gates
→ PR creation
/mindforge:auto --phase 1
→ Walk-away autonomous execution (v2)
→ Intelligent stuck detection and node repair
→ External steering via steering-queue
/mindforge:qa
→ Systematic visual verification of UI changes (v2)
→ Automated regression test generation
→ Persistent browser sessions and daemon
/mindforge:cross-review
→ Adversarial multi-model code review and synthesis (v2)
→ Consensus detection and severity normalization
/mindforge:research
→ Deep research using Gemini 1.5 Pro 1M context (v2)
→ Codebase-wide context packaging and SSRF protection
/mindforge:costs
→ Real-time token usage and cost profiling (v2)
→ Daily budget tracking across all providers
/mindforge:remember
→ Manual knowledge management and search (v2)
→ Persistent knowledge graph retrieval and promotion
/mindforge:dashboard
→ Real-time web observability and governance at localhost:7339 (v2)
→ Live audit logs, metrics, activity, and team feed
/mindforge:learn
→ Automatically capture skills from Docs, Sessions, or npm (v2)
→ 7-dimension quality scoring and injection protection
/mindforge:marketplace
→ Search, install, and publish community skills (v2)
→ Verified installation via npm-based registry
/mindforge:new-runtime
→ Scaffold custom runtime configurations for any AI agent (v2)Execution Modes
MindForge supports multiple interaction models to fit your engineering workflow:
- In-IDE Orchestration: Use
/mindforge:agent <persona>for real-time delegation. - Enterprise Workflows: Specialized commands like
/mindforge:tdd,/mindforge:architecture, and/mindforge:planner. - CLI Automation: Run
node bin/mindforge-cli.js spawn <persona>for scripted tasks.
Updates and migrations
/mindforge:update
/mindforge:update --apply
/mindforge:migrate --from v0.6.0 --to v1.0.0Plugin system (v1.0.0)
Plugins extend MindForge via the mindforge-plugin-* namespace.
/mindforge:plugins list
/mindforge:plugins install mindforge-plugin-<name>
/mindforge:plugins validateToken usage profiling
/mindforge:tokens --profileSee .mindforge/production/token-optimiser.md.
Documentation
- User Guide:
docs/user-guide.md - Troubleshooting:
docs/troubleshooting.md - CI Quickstart:
docs/ci-quickstart.md - Requirements:
docs/requirements.md - Quick verify:
docs/quick-verify.md - Upgrade guide:
docs/upgrade.md - FAQ:
docs/faq.md - Release notes:
RELEASENOTES.md - Release checklist guide:
docs/release-checklist-guide.md - USPs and features:
docs/usp-features.md - Full tutorial:
docs/tutorial.md - Commands:
docs/reference/commands.md - Config reference:
docs/reference/config-reference.md - SDK:
docs/reference/sdk-api.md - Skills:
docs/reference/skills-api.md - Audit events:
docs/reference/audit-events.md - Security:
docs/security/SECURITY.md - Threat model:
docs/security/threat-model.md - Architecture:
docs/architecture/README.md - Contributing:
docs/contributing/CONTRIBUTING.md
📜 Framework Evolution & Version History
- Pillar XIX: Sovereign Identity Synthesis: Autonomous creation and evolution of
SOUL.mdfrom execution traces. - Soul Mirroring: Agent personality and decision-heuristics that self-adapt based on persistent user interaction sentiment.
- Identity Enforcement: Mandatory alignment of subagents with the instance's unique Sovereign Identity.
- Pillar XV: Unified Persistence Layer: Transition from file-based JSONL state to a high-performance SQLite engine with FTS5 semantic search.
- Pillar XVI: Federated Mesh Synthesis (FMS): Inter-project knowledge sharing via cryptographically signed
.mfb(MindForge Bundles). - Pillar XVII: Autonomous Skill Evolution (ASE): Automated mining of "Golden Traces" to synthesize reusable
.skill.mdartifacts. - Pillar XVIII: Orbital Governance: Hardware-locked security gates requiring HSM/Biometric attestation for high-impact mutations (>95).
- Pillar XI: Post-Quantum Agentic Security (PQAS): Lattice-based (Dilithium-5) signatures and ZK-Proof bypasses for Tier 4 agent identities.
- Pillar XII: Proactive Semantic Homing: Autonomous "Intent Hunting" where agents proactively claim tasks and peer-heal logic drift (>80) in the mesh.
- Pillar IX: Autonomous Resource Harvesting (ARH): Real-time token arbitrage and dynamic task routing based on MIR (Min-Intelligence-Requirement).
- Pillar X: Neural Drift Remediation (NDR): Semantic density heuristics and automated reasoning recovery to break logic loops and hallucinations.
- Agentic Learning Loop: Mandatory "Read Before, Record After" protocol for all agentic actions, ensuring a persistent, self-improving engineering memory.
- AgRevOps ROI Engine (Pillar VIII): Real-time value attribution ($100/hr dev saving mapping) for every autonomous reasoning cycle.
- FIM Expansion: Aggregation of collective project health metrics via
PillarHealthTracker. - CADIA Optimizer (Pillar II Upgrade): Dynamic risk scoring (0-100) and session entropy guardrails to prevent rogue behaviors.
- Homing Signal Injection: Automated capture of high-efficacy SCS homing instructions as durable, sharable knowledge.
- Interactive Temporal Steering (Pillar VII): Hindsight injection and temporal slider navigation via the Nexus Dashboard.
- ROI Engine (Pillar VIII): Automated financial governance and cumulative agentic ROI tracking.
- Velocity Forecaster: Statistical ETA prediction for milestones based on live telemetry.
- Unified NexusTracer: Single, high-fidelity ART protocol singleton with a core asynchronous drive.
- Merkle-Style Audit Integrity: Hardened SRE and ZTAI logs with cumulative Merkle-hash chains.
- MCA Circuit Breakers: Stateful provider blacklisting in the
CloudBrokerwith automated failure remediation.
- Sovereign Reason Enclaves (v5.8): ZK-Proof compliance certificates for confidential reasoning cycles.
- Multi-Cloud Arbitrage (v5.7): Intelligence-first routing using persistent Task-to-Model success matrices.
- Sentinel Execution (v5.6): Binary Runtime Attestation and Reasoning Entropy Scoring (RES).
- Predictive Agentic Reliability (v5.5): Advanced loop detection (Semantic Mirroring) and self-healing triggers.
- Dynamic Blast Radius (v5.3/v5.4): Real-time impact analysis and circuit-breaker safety in the federated sync.
- Semantic Vector Consensus (v5.2): FIM v2 with cosine-similarity conflict resolution.
- Enterprise Edition Protocols (v5.1): 14 advanced agentic protocols (Brainstorming, Swarm, Parallel Mesh) integrated from Superpowers.
- Enterprise Mesh (v4.3): Autonomous FinOps and Proactive Equilibrium (Wave Monitoring).
- Identity & Memory (v4.2): Zero-Trust Agentic Identity (ZTAI) with Ed25519 signing.
- MindForge Nexus (v4.1): Hierarchical ART tracing and trace context propagation.
- Mesh Dynamic Swarms (v4.0): Parallel, task-aware specialist clusters and micro-persona factory.
- Context Sharding (SRD): 40% reduction in token waste via relevance-dense Hot/Warm/Cold context tiers.
- Adversarial Decision Synthesis (ADS): Zero-drift architectural logic through Red-Blue model debate.
- Temporal Vision: Full-fidelity history navigation, hindsight injection, and automated state repair.
- RAG 2.0 (Auto-Shadowing): Background pattern retrieval from the local knowledge graph.
- Multi-Runtime Support: Official adapters for Claude Code, Antigravity, Cursor, Gemini, and Copilot.
- RAG 2.0: Typed-edge Local Knowledge Graph with proactive context shadowing and TF-IDF search.
- Temporal Vision: Full-fidelity history navigation, state snapshotting, and hindsight injection.
- Self-Building Skills: Automated skill capture from documentation and phase outputs via
/mindforge:learn.
- Unified 4-Pillar Workflow: Standardized
plan→execute→verify→shiplifecycle. - Specialized Persona Library: 32+ high-performance engineering agents with defined capability matrices.
- Zero-Trust Logic: Initial protocol enforcement and audit-trail persistence.
Security
MindForge never stores credentials in files. Review:
docs/security/SECURITY.mddocs/security/threat-model.md
⚖️ License
MIT © 2026 MindForge Team eam
