mindforge-cc 6.2.0-alpha → 6.2.1

package/docs/Templates/Project/AGENTS_LEARNING.md

@@ -0,0 +1,88 @@
+# AGENTS_LEARNING.md — Project Intelligence Evolution
+
+This document captures the cumulative technical intelligence of AI agents operating within this project. It serves as a persistent memory layer to ensure agents evolve by learning from historical mistakes, maintaining high-fidelity engineering discipline, and adhering to architectural standards.
+
+---
+
+## Context
+**Project Name:** [Project Name]
+**Project Type:** [Frontend / Backend / Fullstack / Infra]
+**Tech Stack:** [e.g. Node.js, React, PostgreSQL]
+**System Scope:** [Short description of the system]
+
+---
+
+## 1. Mistakes Observed
+| Mistake | Description | Example | Impact |
+| :--- | :--- | :--- | :--- |
+| [Title] | [Brief description] | [Example code/context] | [Low/Medium/High/Critical] |
+
+---
+
+## 2. Root Cause Analysis
+- [Mistake Name]: [Why did this happen? System design, bad assumptions, or implementation gaps?]
+
+---
+
+## 3. Mitigation & Fix Strategy
+- [Mistake Name]: [Exact steps to fix and preventive measures]
+
+---
+
+## 4. Best Practices (Must Follow)
+- **AI-First Engineering**: [Guideline]
+- **Observability**: [Guideline]
+- [Practice]: [Guideline]
+
+---
+
+## 5. Anti-Patterns (Must Avoid)
+- **Shadow Execution**: [Why it is harmful and what to do instead]
+- [Pattern]: [Why it is harmful and what to do instead]
+
+---
+
+## 6. Architectural Patterns to Follow
+- [Pattern Name]: [Description and application]
+
+---
+
+## 7. Failure Scenarios (Failure-First Thinking)
+- **Scenario**: [What can break?]
+  - **System Behavior**: [How does the system behave?]
+  - **Agent Response**: [How should the agent respond?]
+
+---
+
+## 8. Continuous Learning Rules
+- **Post-Wave Retrospectives**: Update this document after every milestone or major fix.
+- **Log Scavenging**: Analyze session logs for reasoning decay or loops.
+
+---
+
+## Evolution Log
+
+### [Learning Entry - YYYY-MM-DDTHH:MM:SSZ]
+
+**Context:**
+<What task was being performed>
+
+**Mistake:**
+<What went wrong>
+
+**Root Cause:**
+<Why it happened>
+
+**Fix:**
+<What was done>
+
+**Prevention Rule:**
+<Rule to avoid this in future>
+
+**Category:**
+- Best Practice / Anti-Pattern / Bug Fix / Architecture
+
+---
+**Document Status:** Initialized
+**Root Identity:** `did:mindforge:enclave:0x[Identity]`
+**Last Verified:** [Date]

package/docs/architecture/V4-SWARM-MESH.md

@@ -59,7 +59,7 @@ Every swarm cluster operates under strict enterprise governance rules:
 
 - **Audit Trails**: Non-repudiable logs signed by each agent's unique **Decentralized Identifier (DID)**.
 
-- **Identity Hardening (Beast Mode)**: High-tier agents (T3) use asymmetric keys anchored in a simulated **Secure Enclave (HSM)**.
+- **Identity Hardening (Enterprise Mode)**: High-tier agents (T3) use asymmetric keys anchored in a simulated **Secure Enclave (HSM)**.
 - **Integrity Proofs**: All audit blocks are finalized with **Merkle-root payloads** signed by the archiver to prevent tampering.
 
 ---

package/docs/architecture/V5-ENTERPRISE.md

@@ -1,4 +1,4 @@
-# MindForge v5 Architecture: The Enterprise Beast
+# MindForge v5 Architecture: The Enterprise Standard
 
 MindForge v5.1.0 is built on a distributed "Agentic OS" architecture. This major version introduces distributed intelligence and absolute governance via a zero-trust policy-as-code layer.
 

package/docs/ci-cd.md

@@ -16,7 +16,7 @@ MindForge v2.0.0 uses a sophisticated Control + Execution Plane architecture for
 
 ## 🔄 PR Workflow Lifecycle
 
-When you open or update a Pull Request, MindForge triggers the following "Beast" sequence:
+When you open or update a Pull Request, MindForge triggers the following "Enterprise" sequence:
 
 1. **🔍 Classify**: Analyzes diffs to assign a **Governance Tier (1, 2, or 3)**.
 2. **⚖️ Govern**:

package/docs/commands-reference.md

@@ -1,86 +1,144 @@
-# MindForge v6.0.0-alpha — Commands Reference
+# MindForge — Universal Commands Reference
 
-MindForge commands are organized into functional pillars to support the entire software development lifecycle (SDLC).
+MindForge commands are organized into functional pillars to support the entire software development lifecycle (SDLC), from initial architecture to final delivery at scale.
 
 ---
 
-## 1. Project Management & Setup
+## 1. Project Management & Initialization
+
+Commands to scaffold, orient, and prepare the framework for a specific repository context.
+
+| Command | Description |
+| :--- | :--- |
+| `/mindforge:init-project` | Scaffolds the `.agent/` framework and initializes core planning files (`PROJECT.md`, `STATE.md`). |
+| `/mindforge:init-org` | Standardizes MindForge at the organization level with global guardrails and security policies. |
+| `/mindforge:map-codebase` | Performs deep architectural and semantic mapping of an existing codebase with parallel agents. |
+| `/mindforge:new-runtime` | Scaffolds support for a new AI coding runtime (e.g., custom IDE or proprietary CLI). |
+
+---
+
+## 2. Core SDLC Lifecycle (The 4 Pillars)
+
+The foundational MindForge workflow for predictable, high-quality development cycles.
+
+| Command | Description |
+| :--- | :--- |
+| `/mindforge:plan-phase [N]` | Initiates strategic planning for a milestone: multi-agent discussion → research → atomic XML planning. |
+| `/mindforge:execute-phase [N]` | Orchestrates the implementation of task plans via wave-based parallel execution with atomic commits. |
+| `/mindforge:verify-phase [N]` | Triggers Human Acceptance Testing (UAT) and runs non-bypassable verification gates. |
+| `/mindforge:ship [N]` | Finalizes delivery, generates a rich Pull Request body from artifacts, and prepares for merge. |
+
+---
+
+## 3. Specialized Design & Audit Phases
+
+Mid-cycle protocols for ensuring architectural alignment and visual integrity.
+
+| Command | Description |
+| :--- | :--- |
+| `/mindforge:ui-phase [N]` | Generates a declarative UI Design Contract (`UI-SPEC.md`) before implementation begins. |
+| `/mindforge:ui-review [N]` | Performs a retroactive visual audit of implemented UI against the DESIGN_SYSTEM.md and UI-SPEC.md. |
+| `/mindforge:validate-phase [N]` | Audits a completed phase for requirement coverage and Nyquist validation gaps. |
+| `/mindforge:discuss-phase [N]` | Interactive requirements gathering and decision-locking before creating formal plans. |
+
+---
+
+## 4. Task, Idea & Backlog Management
+
+Capturing and routing engineering intent with zero friction.
 
 | Command | Description |
 | :--- | :--- |
-| `/mindforge:init-project` | Scaffolds the `.agent/` framework and initializes project planning files. |
-| `/mindforge:map-codebase` | Performs deep architectural mapping of an existing codebase. |
-| `/mindforge:health` | Checks the integrity of the MindForge installation and project structure. |
-| `/mindforge:health --repair` | Automatically fixes missing files or broken configurations. |
+| `/mindforge:do <intent>` | Smart natural language dispatcher that routes freeform text to the correct MindForge workflow. |
+| `/mindforge:note <text>` | Captures logic choices, todos, or preferences into session memory with automated promotion to tasks. |
+| `/mindforge:add-backlog <desc>` | Parks speculative ideas in a "parking lot" to keep the active milestone focus lean. |
+| `/mindforge:review-backlog` | Periodically audits and promotes backlog items into the active development roadmap. |
+| `/mindforge:plant-seed <idea>` | Captures forward-looking ideas with triggers that surface automatically at the relevant milestone. |
 
 ---
 
-## 2. The Unified Workflow (4 Pillars)
+## 5. Intelligence, Research & Code Review
+
+Leveraging multi-model intelligence for deep codebase insights and quality assurance.
 
 | Command | Description |
 | :--- | :--- |
-| `/mindforge:plan-phase [N]` | Initiates strategic planning for a milestone: discuss → research → plan. Supports `--ads` for adversarial synthesis. |
-| `/mindforge:execute-phase [N]` | Starts autonomous execution of task plans in parallel waves. |
-| `/mindforge:verify-phase [N]` | Runs Human Acceptance Testing (UAT) and automated validation gates. |
-| `/mindforge:ship [N]` | Finalizes delivery, generates release output, and creates a Pull Request. |
+| `/mindforge:research <topic>` | Deep research using Gemini 1.5 Pro's 1-million-token window on the full codebase context. |
+| `/mindforge:cross-review` | Simultaneous code diff review by multiple AI models with consensus detection and synthesis. |
+| `/mindforge:pr-review` | Targeted AI review of a Pull Request with context loading and logic branch verification. |
+| `/mindforge:benchmark` | Measures real-world skill effectiveness over time using standardized scoring vectors. |
 
 ---
 
-## 3. Intelligence & Observability
+## 6. Multi-Agent Workflows & Workstreams
+
+Managing parallel feature tracks and autonomous execution clusters.
 
 | Command | Description |
 | :--- | :--- |
-| `/mindforge:dashboard` | Starts or manages the real-time web observability dashboard. |
-| `/mindforge:browse [URL]` | Launches the browser daemon for visual verification or research. |
-| `/mindforge:personas --list` | Displays all 32+ specialized engineering personas. |
-| `/mindforge:personas --set ID` | Switches the current agent to a specific persona (e.g., `architect`, `executor`). |
-| `/mindforge:tokens` | Analyzes and profiles token usage for the current session. |
-| `/mindforge:neural-orchestrator` | Activates the advanced protocol layer for the current session. |
-| `shard-helper --verify` | (CLI Internal) Verifies the integrity and SHA-256 checksums of memory shards. |
-| `/mindforge:entropy-check`| (Sentinel) Manually trigger Reasoning Entropy Analysis on the current context. |
+| `/mindforge:workstreams` | Manages parallel feature tracks with isolated state and independent planning artifacts. |
+| `/mindforge:agent <persona>` | Invokes or spawns a specialized enterprise persona from the MindForge library (e.g., `sre`, `architect`). |
+| `/mindforge:auto --phase [N]` | Starts the Autonomous Execution Engine for 100% hands-free implementation and state recovery. |
 
 ---
 
-## 4. Knowledge, Skills & Marketplace
+## 7. Observability, Metrics & FinOps
+
+Real-time governance of the AI agent's behavior, costs, and project velocity.
 
 | Command | Description |
 | :--- | :--- |
-| `/mindforge:note "TEXT"` | Captures an architectural decision or project preference into memory. |
-| `/mindforge:remember [TERM]` | Searches the MindForge knowledge graph for relevant context. |
-| `/mindforge:learn [URL/PATH]` | Ingests documentation or source code to build a new validated Skill. |
-| `/mindforge:skills --list` | Lists all active and available skills across the 3-tier registry. |
-| `/mindforge:skills validate [PATH]` | Passes a skill through the 7-Dimension Scorer for quality verification. |
-| `/mindforge:marketplace search [Q]`| Searches community skills from the central registry. |
-| `/mindforge:marketplace install ID` | Installs a verified community skill into the project context. |
-| `mindforge-cc sign <SKILL>`| (Sentinel) Cryptographically sign a skill with a Tier 3 DID signature. |
+| `/mindforge:dashboard` | Starts the local web dashboard for real-time observability and temporal steering. |
+| `/mindforge:status` | Displays a reach terminal dashboard of project state, pending tasks, and recent audit events. |
+| `/mindforge:metrics` | Analyzes session and phase quality trends with automated early warning signals. |
+| `/mindforge:costs` | Tracks real-time token consumption and financial impact across all AI providers. |
+| `/mindforge:tokens` | Profiles token usage efficiency and provides compaction recommendations. |
 
 ---
 
-## 5. Governance & Maintenance
+## 8. Skills, Knowledge & Marketplace
+
+Managing the framework's intelligence capabilities and the global community registry.
 
 | Command | Description |
 | :--- | :--- |
-| `/mindforge:security-scan` | Performs deep vulnerability scanning and compliance checks. |
-| `/mindforge:update` | Checks for and applies framework updates from the central repository. |
-| `/mindforge:migrate` | Migrates project metadata between framework versions. |
-| `/mindforge:audit --export` | Generates a human-readable PDF report of the session audit log. |
-| `/mindforge:join-discord` | Join the MindForge developer community for support and collaboration. |
+| `/mindforge:remember <term>` | Retrieval-augmented search through the local knowledge graph and session memory. |
+| `/mindforge:learn <source>` | Converts documentation, source code, or npm packages into validated, reusable MindForge skills. |
+| `/mindforge:skills --list` | Lists all active skill packs with tier-based status (Core/Org/Project). |
+| `/mindforge:marketplace` | Discover, evaluate, and install community-published skills from the npm-based registry. |
+| `/mindforge:publish-skill` | Validates, versions, and publishes local skills to the central registry. |
+| `/mindforge:install-skill` | Fetches and configures a skill from the marketplace into the local project. |
 
 ---
 
-## 6. Advanced Neural Protocols (Beast Addition)
+## 9. Governance, Integrations & Maintenance
 
-These protocols represent specialized, high-fidelity engineering behaviors ported and hardened for the MindForge ecosystem.
+Connecting MindForge to enterprise systems and keeping the framework hardened.
 
 | Command | Description |
 | :--- | :--- |
-| `/mindforge:brainstorming` | Deep ideation and requirement exploration before planning. |
-| `/mindforge:swarm-execution` | Swarm-based implementation for independent tasks. |
-| `/mindforge:parallel-mesh` | Orchestrates context across multiple parallel agent waves. |
-| `/mindforge:workspace-isolated` | Manages isolated development environments via git worktrees. |
-| `/mindforge:skill-creation` | Expert protocol for authoring new MindForge skills. |
-| `/mindforge:review-request` | Formalizes peer review requests for completed implementation waves. |
-| `/mindforge:tdd` | Enhanced Test-Driven Development protocol with strict verification. |
-| `/mindforge:debug` | Advanced systematic debugging with persistent state tracking. |
-| `/mindforge:verify-work` | Multi-level truth verification (existence, substance, wiring). |
-| `/mindforge:sentinel-status`| Displays real-time integrity and reliability metrics for the mesh. |
+| `/mindforge:sync-jira` | Synchronizes MindForge milestones and tasks with Jira tickets and status transitions. |
+| `/mindforge:sync-confluence` | Exports architectural decisions and project documentation to Confluence spaces. |
+| `/mindforge:approve [event]` | Issues a manual Tier 3 cryptographic signature for a sensitive or high-risk operation. |
+| `/mindforge:health` | Runs comprehensive framework diagnostics across 7 categories with auto-repair loops. |
+| `/mindforge:update` | Checks for, diffs, and applies MindForge framework updates in a safe, scope-preserving way. |
+| `/mindforge:migrate` | Executes schema migrations for `.planning/` files across framework versions. |
+| `/mindforge:plugins` | Manages the framework plugin system and installs `mindforge-plugin-*` extensions. |
+
+---
+
+## 10. Advanced Engineering Protocols
+
+High-fidelity behaviors ported from the Superpowers library and hardened for production.
+
+| Command | Description |
+| :--- | :--- |
+| `/mindforge:brainstorming` | Deep exploratory protocol for intent clarification and architectural ideation. |
+| `/mindforge:swarm-execution` | Wave-based implemention for independent, non-conflicting tasks. |
+| `/mindforge:parallel-mesh` | Orchestrates a mesh of agent waves with automated dependency compaction. |
+| `/mindforge:workspace` | Manages isolated development environments via git worktrees with smart safety checks. |
+| `/mindforge:tdd` | Strict Test-Driven Development (Red-Green-Refactor) with automated test generation. |
+| `/mindforge:debug` | Systematic debugging using persistent state tracking and Root Cause Analysis. |
+| `/mindforge:verify-work` | Multi-level truth verification protocol (substance, existence, wiring). |
+| `/mindforge:retrospective` | Facilitates structured team retrospectives with objective telemetry and metrics. |
+

package/docs/registry/COMMANDS.md

@@ -20,7 +20,7 @@ This registry catalogs every strategic, operational, and governance command avai
 
 | Command | Description | Invocation | Outcome Goal |
 | :--- | :--- | :--- | :--- |
-| `/mindforge:init-project` | Initialize a new project with the framework. | `/mindforge:init-project` | "Beast Mode" workspace. |
+| `/mindforge:init-project` | Initialize a new project with the framework. | `/mindforge:init-project` | "Enterprise-Grade" workspace. |
 | `/mindforge:init-org` | Set up organization-level policy standards. | `/mindforge:init-org` | Standardized enterprise config. |
 | `/mindforge:new-project` | Structured project initialization wizard. | `/mindforge:new-project` | Validated project baseline. |
 | `/mindforge:milestone` | Define and track high-level milestones. | `/mindforge:milestone` | Recorded project roadmap. |

package/docs/registry/PERSONAS.md

@@ -17,7 +17,7 @@ This registry catalogs the specialized agent essences available for direct inter
 
 | Persona | Identifier | Cognitive Focus | Primary Directive |
 | :--- | :--- | :--- | :--- |
-| **mf-executor** | Lead Developer | "Beast Mode" Logic & UI | "Ship premium-grade code with 100% test coverage." |
+| **mf-executor** | Lead Developer | "Enterprise-Grade" Logic & UI | "Ship premium-grade code with 100% test coverage." |
 | **developer** | Code Smith | Clean Code & Patterns | "Implement features according to the approved plan." |
 | **executor** | Pilot Developer | Atomic Multi-Plan | "Executes implementation plans with high fidelity and atomic commits." |
 | **tech-writer** | Documentation Lead | Clarity & Accuracy | "Transform engineering complexity into readable documentation." |

package/docs/registry/README.md

@@ -13,7 +13,7 @@ Welcome to the central high-fidelity registry for the MindForge framework. This
 | **[HOOKS.md](./HOOKS.md)** | 10+ Framework Guards | Security, visibility, and automation triggers. |
 | **[AGENTS.md](./AGENTS.md)** | 20+ Digital Identities | Invocable personas and internal swarms. |
 
-## 🚀 "Beast Mode" Ready
+## 🚀 "Enterprise-Grade" Ready
 
 These registries are synchronized automatically during every `mindforge init` or `update` cycle. They ensure that every framework capability is discoverable, verifiable, and enforceable by both human developers and AI agents.
 

package/docs/registry/SKILLS.md

@@ -6,7 +6,7 @@ This registry catalogs the high-fidelity SkillStacks available to the MindForge
 
 | Skill | Primary Domain | Primary Capability |
 | :--- | :--- | :--- |
-| **agency-senior-developer** | Implementation | "Beast Mode" styling and robust logic. |
+| **agency-senior-developer** | Implementation | "Enterprise-Grade" styling and robust logic. |
 | **agency-software-architect** | System Design | Architectural pattern selection and complexity control. |
 | **agency-backend-architect** | Core Logic | Database schema design and high-performance API logic. |
 | **agency-frontend-developer** | Web Interface | Fluid components and interactive design systems. |

package/docs/security/ZTAI-OVERVIEW.md

@@ -1,6 +1,6 @@
 # Zero-Trust Agentic Identity (ZTAI) Overview
 
-MindForge v4.2 introduces **ZTAI Beast Mode**, an enterprise-grade identity layer that ensures every agent action is cryptographically signed and non-repudiable.
+MindForge v4.2 introduces **ZTAI Enterprise Mode**, an enterprise-grade identity layer that ensures every agent action is cryptographically signed and non-repudiable.
 
 ## 1. Asymmetric Identity Model
 Every MindForge persona in the 32+ agent library is assigned a unique asymmetric key pair (Ed25519) upon project initialization or agent spawning.

package/docs/user-guide.md

@@ -185,9 +185,9 @@ Treat compute as a financial asset. Monitor ROI ($100/hr value mapping) and Secu
 
 ---
 
-## 13. Neural Protocol Mesh (Beast Addition)
+## 13. Neural Protocol Mesh (Enterprise Expansion)
 
-The **Beast Addition** introduces 14 hardened protocols from the Superpowers framework, integrated into the core MindForge engine.
+The **Enterprise Expansion** 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.

package/docs/workflow-atlas.md

@@ -6,7 +6,7 @@ This document classifies every workflow and action in the MindForge `.github/` d
 
 ## 🏗️ The 5-Layer Plane Architecture (v2.0.0 — Recommended)
 
-These workflows form the modular "Beast" architecture implemented for enterprise-grade autonomy.
+These workflows form the modular "Enterprise" architecture implemented for enterprise-grade autonomy.
 
 ### 1. Control Plane (`control-plane.yml`)
 - **Primary Trigger**: `push` or `pull_request` to `main` or `develop`.

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "mindforge-cc",
-  "version": "6.2.0-alpha",
+  "version": "6.2.1",
+
   "description": "MindForge — Sovereign Agentic Intelligence Framework. (CADIA v6.2 & PQAS Enabled)",
   "bin": {
     "mindforge-cc": "bin/install.js"