mindforge-cc 4.3.0 → 5.1.0

package/docs/troubleshooting.md

@@ -1,4 +1,4 @@
-# MindForge Troubleshooting (v1.0.0)
+# MindForge Troubleshooting (v5.1.0)
 
 This page lists common issues and fast fixes. If you get stuck, start with
 `/mindforge:health`.
@@ -54,14 +54,14 @@ npx mindforge-cc@latest --claude --local --force
 ```
 Then run:
 ```
-/mindforge:migrate --from v0.6.0 --to v1.0.0
+/mindforge:migrate --from v5.0.0 --to v5.1.0
 ```
 
 ### Schema mismatch warning on startup
 **Fix:**
 ```
 /mindforge:migrate --dry-run
-/mindforge:migrate --from vX.Y.Z --to v1.0.0
+/mindforge:migrate --from vX.Y.Z --to v5.1.0
 ```
 
 ### AUDIT.jsonl parse errors
@@ -113,7 +113,27 @@ rerun migration. See `.mindforge/audit/AUDIT-SCHEMA.md` for expected format.
 
 ---
 
-## 8. Getting help
+## 8. Neural Protocol Mesh Issues (v5.1.0)
+
+### Protocol Step 0 fails to activate
+**Symptom:** Commands proceed without activating `_extended` skills.
+**Fix:** Run `/mindforge:neural-orchestrator --reset`. Ensure all `_extended` skills are present in `.agent/skills/`.
+
+### Context drift in Parallel Mesh
+**Symptom:** Parallel agents making conflicting decisions.
+**Fix:** Run `/mindforge:parallel-mesh --sync`. This forces a global state re-synchronization across all active worker identities.
+
+### Workspace isolation failure
+**Symptom:** Conflicts between feature branches or dirty worktree.
+**Fix:** Run `/mindforge:workspace-isolated --cleanup`. Use `/mindforge:health --repair` if `.git/worktrees/` is corrupt.
+
+---
+
+## 9. Getting help
 If the above doesn’t resolve it:
 - Review `docs/user-guide.md`
 - Check `docs/security/SECURITY.md` for security issues
+- Open a GitHub issue or join the Discord: `/mindforge:join-discord`
+- **Architecture**: `docs/architecture/V5-ENTERPRISE.md`
+- **Commands**: `docs/commands-reference.md`
+- **Personas**: `docs/PERSONAS.md`

package/docs/user-guide.md

@@ -1,4 +1,4 @@
-# MindForge User Guide (v2.1.1)
+# MindForge User Guide (v5.1.0)
 
 This guide gets you from install to productive, with the minimum needed to run MindForge in a real project. It assumes Node.js 18+.
 
@@ -62,27 +62,27 @@ This analyzes your code, generating `.planning/ARCHITECTURE.md` and inferred dev
 
 ---
 
-## 5. Unified Workflow
+## 5. Unified Workflow (Enabled by Protocol Mesh)
 
-MindForge v2.1.1 uses a unified 4-pillar workflow for predictable delivery:
+MindForge v5.1.0 uses a unified 4-pillar workflow, now hardened by the **Neural Protocol Mesh**. Every core command automatically activates **Protocol Step 0** for maximum tactical rigor.
 
 ```bash
-/mindforge:plan-phase [N]     # discuss → research → plan
-/mindforge:execute-phase [N]  # parallel execution of task plans
-/mindforge:verify-phase [N]   # UAT + automated validation
-/mindforge:ship [N]           # generate changelog + create PR
+/mindforge:plan-phase [N]     # discuss → research → plan (Step 0: brainstorming)
+/mindforge:execute-phase [N]  # parallel execution of task plans (Step 0: swarm-execution)
+/mindforge:verify-phase [N]   # UAT + automated validation (Step 0: verify-work)
+/mindforge:ship [N]           # generate changelog + create PR (Step 0: ship)
 ```
 
 ---
 
 ## 6. High-Performance Personas
 
-MindForge v2.1.1 introduces 32+ specialized personas. Each persona is optimized for a specific stage of the lifecycle.
+MindForge v5.1.0 features 46+ specialized personas. Each persona is optimized for a specific stage of the lifecycle.
 
-- **Planner**: Orchestrates complex multi-file architectural changes.
-- **Executor**: Focused on pixel-perfect implementation and coding standards.
-- **Debugger**: Systematic root-cause analysis and verification.
-- **Researcher**: Deep codebase and dependency analysis via Context7.
+- **Neural Orchestrator**: Activates and manages the advanced protocol layer.
+- **Brainstormer**: Expert in deep requirements discovery and behavioral ideation.
+- **Swarm Pilot**: Orchestrates multiple independent implementation tasks.
+- **TDD Master**: Enforces strict Test-Driven Development loops with adversarial rigor.
 
 To switch personas or see the full list:
 
@@ -131,19 +131,20 @@ MindForge captures architectural decisions and bug patterns across sessions.
 
 ---
 
-## 10. Self-Building Skills
+## 10. Self-Building Skills & Protocol Creation
 
-Extend MindForge by learning from documentation or community sources.
+Extend MindForge by learning from documentation or authoring custom protocols.
 
 ```bash
 /mindforge:learn https://docs.nextjs.org "nextjs-mastery"
+/mindforge:skill-creation # Author a new high-fidelity protocol
 ```
 
 ---
 
 ## 11. Git & PR Integration
 
-MindForge v2.1.1 features automated PR creation and commit management.
+MindForge features automated PR creation and commit management.
 
 ```bash
 /mindforge:pr-branch "feature/auth-refactor"
@@ -152,7 +153,48 @@ MindForge v2.1.1 features automated PR creation and commit management.
 
 ---
 
-## 12. Update & Maintenance
+## 12. Enterprise Resilience & Governance (v5.1.0)
+
+MindForge v5.1.0 introduces mission-critical resilience and sovereign reasoning for enterprise engineering.
+
+### Multi-Cloud Arbitrage
+MindForge automatically hedges against provider outages and optimizes for cost/latency.
+```bash
+/mindforge:settings --cloud-arbitrage on
+```
+
+### Sovereign Reason Enclaves (SRE)
+Tier 3 (Principal) agents execute reasoning in isolated enclaves to protect sensitive IP.
+```bash
+/mindforge:agent --tier 3 # Automatically triggers SRE
+```
+
+### Dynamic Human-Agent Handover (DHH)
+When autonomous confidence drops or a critical decision is reached, MindForge creates a **Nexus State Bundle** and requests human steering.
+```bash
+/mindforge:auto --handover 0.6 # Triggers handover at 60% confidence
+```
+
+---
+
+## 13. Neural Protocol Mesh (Beast Addition)
+
+The **Beast Addition** introduces 14 hardened protocols from the Superpowers framework, integrated into the core MindForge engine.
+
+- **Brainstorming**: Deep ideation before planning.
+- **Parallel Mesh**: Orchestrates context across multiple agents.
+- **Swarm Execution**: Parallel implementation for high-velocity waves.
+- **Isolated Workspaces**: Environment protection via git worktrees.
+- **Enhanced TDD/Debug**: Strict loops for zero-defect delivery.
+
+Activate the mesh for any session:
+```bash
+/mindforge:neural-orchestrator
+```
+
+---
+
+## 14. Update & Maintenance
 
 Keep your framework current with the latest personas and library updates:
 
@@ -162,8 +204,10 @@ Keep your framework current with the latest personas and library updates:
 
 ---
 
-## 13. Reference & Support
+## 15. Reference & Support
 
+- **Architecture**: `docs/architecture/V5-ENTERPRISE.md`
+- **Governance**: `docs/governance-guide.md`
 - **Commands**: `docs/commands-reference.md`
 - **Personas**: `docs/PERSONAS.md`
 - **Troubleshooting**: `docs/troubleshooting.md`

package/docs/usp-features.md

@@ -70,6 +70,9 @@ are included in the official release, and how to use them effectively.
 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.
 
+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.
+
 ---
 
 ## Feature Set (v2.0.0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindforge-cc",
-  "version": "4.3.0",
+  "version": "5.1.0",
   "description": "MindForge - Enterprise Agentic Framework for Claude Code and Antigravity",
   "bin": {
     "mindforge-cc": "bin/install.js"