mindforge-cc 8.1.0 → 8.2.0

package/.mindforge/mirrors/mirror-sre-776a1cf9/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [Your name]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/.mindforge/mirrors/mirror-sre-776a1cf9/MINDFORGE.md

@@ -0,0 +1,91 @@
+# MINDFORGE.md — Parameter Registry (v8.1.1)
+
+## 1. IDENTITY & VERSIONING
+
+[NAME]    = MindForge
+[VERSION] = 8.1.0-IDENTITY
+[STABLE]  = true
+[MODE]    = "Sovereign Intelligence Mesh"
+[REQUIRED_CORE_VERSION] = 8.1.0
+[SOVEREIGN_IDENTITY] = true
+
+## 2. INTELLIGENCE TOGGLES (V4 UPDATES)
+
+[SWARM_ORCHESTRATION] = true
+[AUTO_SWARM_THRESHOLD] = 7.0
+[CONTEXT7_DEPTH] = "EXTENDED"
+[DYNAMISM_LEVEL] = 5
+[REACTIVE_MODE] = true
+[CONTEXT_SHARDING] = true
+[ADS_LOOP_ENFORCED]  = true
+[TEMPORAL_VISION]    = true
+[RAG_2_AUTO_SHADOW] = true
+[ENABLE_ART_TRACING] = true
+[ENABLE_ZTAI] = true
+[ZTAI_KEY_TYPE] = "Dilithium-5"
+[NEXUS_TRACE_RETENTION_DAYS] = 30
+[CADIA_CORE] = true
+[PQAS_ENFORCED] = true
+[PROACTIVE_HOMING] = true
+
+---
+
+## 3. MODEL TOPOLOGY
+
+### Persona to Model mapping
+
+[PLANNER]  = claude-opus-4-5
+[EXECUTOR] = claude-sonnet-4-5
+[REVIEWER] = claude-sonnet-4-5
+[VERIFIER] = claude-sonnet-4-5
+[SECURITY] = claude-opus-4-5
+[DEBUG]    = claude-opus-4-5
+[RESEARCH] = gemini-1.5-pro
+[QA]       = claude-4-5-sonnet
+
+---
+
+## 4. GOVERNANCE & ECONOMICS
+
+### Limits and safety gates
+
+[COST_WARN_USD]       = 2.00
+[COST_HARD_LIMIT_USD] = 25.00
+[ADS_DEBATE_ROUNDS]   = 2
+[MIN_SOUL_SCORE]      = 7.0
+[REQUIRE_ADR]         = true
+[BLOCK_ON_SECURITY]   = true
+
+---
+
+## 5. RESOURCE GEOMETRY
+
+### Paths and ports
+
+[BROWSER_PORT]    = 7338
+[DASHBOARD_PORT]  = 7339
+[API_URL]         = <http://localhost:3000>
+[SHARD_RETAIN_DAYS] = 7
+
+---
+
+## 6. PROJECT CONSTRAINTS
+
+### Static rules for the agent
+
+[FORBIDDEN] = """
+
+- No direct DB access from frontend
+- No synchronous I/O in API handlers
+- No console.log in production services
+- No TODO comments in committed code
+
+"""
+
+[INSTRUCTIONS] = """
+
+- Check packages/shared before creating utilities.
+- Backend middleware follows Fastify conventions.
+- Date manipulation using date-fns only.
+
+"""

package/.mindforge/mirrors/mirror-sre-776a1cf9/README.md

@@ -0,0 +1,424 @@
+# MindForge v8.1.1 — Sovereign Identity (Pillar XIX Enabled)
+
+MindForge v8.1.1 achieved the **Sovereign Identity** synthesis stage, enabling autonomous `SOUL.md` generation derived from reasoning traces and interaction sentiment (Pillar XIX).
+
+
+## Installation & Setup
+
+### 🚀 Quick Start (No Install)
+
+Run MindForge immediately for a specific runtime without a permanent installation:
+
+```bash
+# 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:
+
+```bash
+npm install -g mindforge-cc@latest
+```
+
+### 📂 Local Project Setup
+
+Initialize MindForge in an existing repository with specialized agent identities:
+
+```bash
+# For Claude Code
+npx mindforge-cc@latest --claude --local
+
+# For Antigravity
+npx mindforge-cc@latest --antigravity --local
+```
+
+---
+
+- **Sovereign Identity Synthesis (v8.1.1)** — Autonomous `SOUL.md` generation derived from reasoning traces and interaction sentiment (Pillar XIX).
+- **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 enriched `IDENTITY.md` protocols
+- **Skills** — 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:
+
+```bash
+/mindforge:health
+```
+
+If issues are found, run:
+```bash
+/mindforge:health --repair
+```
+
+---
+
+
+## Quick start (new project)
+
+```bash
+/mindforge:init-project
+/mindforge:plan-phase 1
+/mindforge:execute-phase 1
+/mindforge:verify-phase 1
+/mindforge:ship 1
+```
+
+
+## Quick start (existing codebase)
+
+```bash
+/mindforge:map-codebase
+/mindforge:do I want to plan the next phase
+/mindforge:plan-phase 1
+```
+
+---
+
+
+## Core workflow
+
+```bash
+/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
+```bash
+/mindforge:update
+/mindforge:update --apply
+/mindforge:migrate --from v0.6.0 --to v1.0.0
+```
+
+---
+
+## Plugin system (v1.0.0)
+Plugins extend MindForge via the `mindforge-plugin-*` namespace.
+
+```
+/mindforge:plugins list
+/mindforge:plugins install mindforge-plugin-<name>
+/mindforge:plugins validate
+```
+
+---
+
+## Token usage profiling
+```
+/mindforge:tokens --profile
+```
+See `.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
+
+<summary><b>v8.1.x — Sovereign Identity (Pillar XIX)</b></summary>
+
+- **Pillar XIX: Sovereign Identity Synthesis**: Autonomous creation and evolution of `SOUL.md` from 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.
+</details>
+
+<details>
+<summary><b>v8.0.x — Celestial Orchestration (SQLite & FMS)</b></summary>
+
+- **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.md` artifacts.
+- **Pillar XVIII: Orbital Governance**: Hardware-locked security gates requiring HSM/Biometric attestation for high-impact mutations (>95).
+</details>
+
+<details>
+<summary><b>v7.x — Sovereign Intelligence (PQAS & Homing)</b></summary>
+
+- **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.
+</details>
+
+<details>
+<summary><b>v6.x — AgRevOps & Stability Patterns</b></summary>
+
+- **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.
+</details>
+
+<details>
+<summary><b>v5.10.x — Nexus Steering & AgRevOps</b></summary>
+
+- **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.
+</details>
+
+<details>
+<summary><b>v5.9.x — Enterprise Level Hardening</b></summary>
+
+- **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 `CloudBroker` with automated failure remediation.
+</details>
+
+<details>
+<summary><b>v5.7.x - v5.8.x — SRE & MCA Protocols</b></summary>
+
+- **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.
+</details>
+
+<details>
+<summary><b>v5.1.x - v5.6.x — The "Enterprise" Era (Protocols & Trust)</b></summary>
+
+- **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.
+</details>
+
+<details>
+<summary><b>v4.x — The Mesh & Nexus Revolution</b></summary>
+
+- **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.
+</details>
+
+<details>
+<summary><b>v3.x — Reactive Autonomous Intelligence</b></summary>
+
+- **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.
+</details>
+
+<details>
+<summary><b>v2.x — The Autonomous Enterprise & Knowledge Graph</b></summary>
+
+- **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`.
+</details>
+
+<details>
+<summary><b>v1.x — Framework Foundation & Core Protocols</b></summary>
+
+- **Unified 4-Pillar Workflow**: Standardized `plan` → `execute` → `verify` → `ship` lifecycle.
+- **Specialized Persona Library**: 32+ high-performance engineering agents with defined capability matrices.
+- **Zero-Trust Logic**: Initial protocol enforcement and audit-trail persistence.
+</details>
+
+---
+
+## Security
+MindForge never stores credentials in files. Review:
+- `docs/security/SECURITY.md`
+- `docs/security/threat-model.md`
+
+---
+
+## ⚖️ License
+MIT © 2026 MindForge Team