mindforge-cc 5.6.0 → 6.0.0-alpha

package/docs/registry/README.md

@@ -0,0 +1,27 @@
+# MindForge — Documentation Registry Hub (v6.2.0-alpha)
+
+Welcome to the central high-fidelity registry for the MindForge framework. This hub provides 100% transparency into the specialized assets, cognitive patterns, and automated guards that power the environment.
+
+## 🗂️ Framework Registries
+
+| Registry | Content Scope | Primary Purpose |
+| :--- | :--- | :--- |
+| **[COMMANDS.md](./COMMANDS.md)** | 64+ Core Operations | Direct terminal interaction reference. |
+| **[SKILLS.md](./SKILLS.md)** | 70+ Atomic Skills | Distributed capability and tool mappings. |
+| **[PERSONAS.md](./PERSONAS.md)** | 35+ Cognitive Egos | Specialized agent reasoning configurations. |
+| **[WORKFLOWS.md](./WORKFLOWS.md)** | 100+ Automations | High-fidelity lifecycle and task flows. |
+| **[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
+
+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.
+
+## 🔍 How to Use This Hub
+
+1.  **Search**: Use `Ctrl+F` across any registry to find specific functional keywords.
+2.  **Invoke**: Use the "Trigger Commands" in [WORKFLOWS.md](./WORKFLOWS.md) for automated task orchestration.
+3.  **Audit**: Cross-reference [HOOKS.md](./HOOKS.md) to understand the security guards active in your session.
+
+---
+*MindForge v6.2.0-alpha — Absolute Sovereignty. Absolute Performance. Absolute Transparency.*

package/docs/registry/SKILLS.md

@@ -0,0 +1,142 @@
+# MindForge — Skill Registry (v6.2.0-alpha)
+
+This registry catalogs the high-fidelity SkillStacks available to the MindForge Intelligence Mesh.
+
+## 🧠 Technical Architecture & Engineering
+
+| Skill | Primary Domain | Primary Capability |
+| :--- | :--- | :--- |
+| **agency-senior-developer** | Implementation | "Beast Mode" 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. |
+| **agency-mobile-app-builder** | Native Apps | Multi-platform mobile development (iOS/Android). |
+
+## 🛡️ Security & Compliance
+
+| Skill | Primary Domain | Primary Capability |
+| :--- | :--- | :--- |
+| **agency-security-engineer** | Hardening | Threat detection and post-quantum security modeling. |
+| **agency-blockchain-security** | Smart Contracts | Vulnerability detection and formal verification. |
+| **agency-compliance-auditor** | Regulation | SOC 2 / ISO 27001 readiness and evidence gathering. |
+| **agency-legal-compliance** | Legal | Jurisdiction-aware data handling and licensing review. |
+
+## 🤖 AI & Data Intelligence
+
+| Skill | Primary Domain | Primary Capability |
+| :--- | :--- | :--- |
+| **agency-ai-engineer** | ML Integration | Agentic steering and model optimization. |
+| **agency-data-engineer** | Pipelines | Scalable ETL/ELT and lakehouse architecture. |
+| **agency-database-optimizer** | Performance | Query optimization and indexing strategies. |
+| **agency-analytics-reporter** | Insights | Data-driven storytelling and KPI dashboards. |
+
+## 🎨 Design & Experience
+
+| Skill | Primary Domain | Primary Capability |
+| :--- | :--- | :--- |
+| **agency-ui-designer** | Visual Identity | Pixel-perfect components and consistent branding. |
+| **agency-ux-architect** | Human Interface | Fluid animations and intuitive user flows. |
+| **agency-whimsy-injector** | Personality | Interactive delight and playful brand experiences. |
+
+## 🛠️ MindForge Atomic Skills (Exhaustive)
+
+These atomic skills are the underlying mechanics of the framework, providing specialized capabilities across the entire project lifecycle.
+
+### 🔄 Core & Lifecycle Management
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-next` | Automatically advance to the next logical step in the workflow. |
+| `mindforge-progress` | Check project progress, show context, and route to next action. |
+| `mindforge-status` | Display a rich dashboard of active project state and readiness. |
+| `mindforge-help` | Show available commands and comprehensive usage guides. |
+| `mindforge-update` | Update MindForge to the latest version with changelog analysis. |
+| `mindforge-settings` | Configure framework toggles, security gates, and model profiles. |
+| `mindforge-session-report` | Generate post-session summaries and resource consumption analysis. |
+| `mindforge-stats` | Display metrics, git velocity, and project timelines. |
+
+### ♟️ Strategic Planning & Research
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-brainstorming` | Must use before creative work to explore requirements and design. |
+| `mindforge-research-phase` | Deep research for technical implementation strategies. |
+| `mindforge-map-codebase` | Parallel codebase mapping and semantic index creation. |
+| `mindforge-milestone-summary` | Comprehensive project onboarding and overview generation. |
+| `mindforge-discuss-phase` | Context gathering via adaptive stakeholder questioning. |
+| `mindforge-plan-phase` | Create detailed documentation (PLAN.md) with verification loops. |
+| `mindforge-plan-phase_extended` | Multi-step planning from specs and complex requirements. |
+| `mindforge-plan-milestone-gaps` | Close roadmap gaps identified during milestone audits. |
+| `mindforge-list-phase-assumptions` | Surface approach assumptions before committing to a plan. |
+
+### 🚀 Implementation & Execution
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-execute-phase` | High-velocity implementation with wave-based parallelization. |
+| `mindforge-execute-phase_extended` | Multi-session implementation with state-preservation checkpoints. |
+| `mindforge-swarm-execution` | Execute independent tasks simultaneously within a session. |
+| `mindforge-tdd` | Strict Red-Green-Refactor test-driven development. |
+| `mindforge-tdd_extended` | Advanced TDD for complex features and obscure bugfixes. |
+| `mindforge-fast` | Trivial task execution with zero framework overhead. |
+| `mindforge-do` | Smart natural language dispatcher for automated routing. |
+| `mindforge-manager` | Interactive command center for multi-phase orchestration. |
+| `mindforge-ui-phase` | Generate a high-fidelity UI Design Contract (UI-SPEC.md). |
+
+### ✅ Quality, Verification & Ship
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-verify-work` | Validate built features through conversational UAT. |
+| `mindforge-verify-work_extended` | Evidence-first verification (proof before assertions). |
+| `mindforge-ui-review` | Retroactive 6-pillar visual and accessibility audit. |
+| `mindforge-debug` | Systematic debugging with persistent session state. |
+| `mindforge-debug_extended` | Deep root-cause analysis (RCA) for complex failures. |
+| `mindforge-validate-phase` | Fill Nyquist validation gaps for completed work. |
+| `mindforge-audit-milestone` | Verify completion against original strategic intent. |
+| `mindforge-audit-uat` | Cross-phase audit of all outstanding verification items. |
+| `mindforge-review-request` | Verify requirements compliance before branch merge. |
+| `mindforge-review-inbound` | Technical audit of received code review feedback. |
+| `mindforge-pr-branch` | Create clean PR branches (filtering internal framework noise). |
+| `mindforge-ship` | Full release pipeline (PR, review, and merge). |
+| `mindforge-ship_extended` | Integration decision engine for completed implementation. |
+
+### 🛠️ Environment & Workspace
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-new-project` | Deep-research project initialization and setup. |
+| `mindforge-new-milestone` | Initialize new milestone cycles and update PROJECT.md. |
+| `mindforge-new-workspace` | Create isolated repositories with independent planning state. |
+| `mindforge-workspace-isolated` | Git worktree creation for clean feature isolation. |
+| `mindforge-list-workspaces` | Display all active MindForge workspaces and their health. |
+| `mindforge-remove-workspace` | Safe cleanup of workspaces and associated worktrees. |
+| `mindforge-resume-work` | Full context restoration from previous session state. |
+| `mindforge-pause-work` | Mid-phase handoff creation for session suspension. |
+| `mindforge-cleanup` | Archive phase directories from completed milestones. |
+| `mindforge-workstreams` | Manage parallel feature tracks with isolated state. |
+| `mindforge-add-backlog` | Park speculative ideas in the "Parking Lot" (999.x). |
+| `mindforge-review-backlog` | Promote backlog items to the active milestone roadmap. |
+| `mindforge-add-phase` | Append new phases to the current milestone. |
+| `mindforge-insert-phase` | Insert urgent decimal phases (e.g. 72.1) dynamically. |
+| `mindforge-remove-phase` | Remove future phases and automatically renumber roadmap. |
+| `mindforge-add-todo` | Capture real-time tasks from the conversation context. |
+| `mindforge-note` | Zero-friction idea capture and observation log. |
+| `mindforge-plant-seed` | Forward-looking idea capture with trigger conditions. |
+
+### 🧠 Intelligence & Memory
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-neural-orchestrator` | Automated skill discovery and tool invocation protocol. |
+| `mindforge-thread` | Persistent cross-session context and thread management. |
+| `mindforge-memory` | Semantic clerk for long-term knowledge graph access. |
+| `mindforge-skill-creation` | Learn, validate, and commit new framework capabilities. |
+| `mindforge-forensics` | Post-mortem analysis of failed workflows and state. |
+| `mindforge-system-architecture` | Multi-service design and scaling decision support. |
+| `mindforge-profile-user` | Generate and maintain developer behavioral profiles. |
+| `mindforge-reapply-patches` | Restore local modifications after framework updates. |
+| `mindforge-join-discord` | Direct community integration and support access. |
+
+---
+*For more details, see the [MIND-FORGE-REFERENCE-V6.md](../MIND-FORGE-REFERENCE-V6.md).*

package/docs/registry/WORKFLOWS.md

@@ -0,0 +1,72 @@
+# MindForge — Workflow Registry (v6.2.0-alpha)
+
+This registry catalogs the automated interaction flows available in the MindForge environment.
+
+## 🧱 Initialization & Setup
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:init-project** | `/mindforge:init-project` | "Context extraction -> Framework initialization -> Baseline." | New MindForge project. |
+| **mindforge:init-org** | `/mindforge:init-org` | "Organization-level standards -> Shared-configs -> Policies." | Standardized enterprise org. |
+| **mindforge:new-runtime** | `/mindforge:new-runtime` | "Environment detection -> SDK scaffolding -> Test-loop." | Support for new target AI coding runtime. |
+| **forge:init-project** | `/forge:init-project` | "FORGE-framework initialization -> Local deployment." | FORGE-ready workspace. |
+
+## 🧠 Strategic Planning & Discovery
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:brainstorming** | `/mindforge:brainstorming` | "Intent exploration -> Requirement discovery -> Spec-generation." | Approved requirements. |
+| **mindforge:milestone** | `/mindforge:milestone` | "Requirement clustering -> Timeline generation -> Slotting." | Recorded PROJECT.md roadmap. |
+| **mindforge:architecture** | `/mindforge:architecture` | "Domain modeling -> Pattern selection -> Interface contract." | ARCHITECTURE and UI-SPEC docs. |
+| **mindforge:discuss-phase** | `/mindforge:discuss-phase` | "Adaptive context gathering -> Assumption analysis -> Planning." | Approved PLAN.md. |
+| **mindforge:plan-phase** | `/mindforge:plan-phase` | "Multi-phase blueprinting -> Security review -> Dependency check." | Approved implementation plan. |
+| **mindforge:planner** | `/mindforge:planner` | "Invoke mf-planner -> Logic verification -> Minimization." | Strategic planning support. |
+| **mindforge:researcher** | `/mindforge:researcher` | "Invoke mf-researcher -> Deep context search -> Summary." | Contextual research summaries. |
+
+## 🚀 Execution & Implementation
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:execute-phase** | `/mindforge:execute-phase` | "Wave processing -> Parallel execution -> Swarm implementation." | Completed feature phase. |
+| **mindforge:workstreams** | `/mindforge:workstreams` | "Feature track isolation -> Git Worktree sync -> PR-ready." | Parallel feature development. |
+| **mindforge:tdd** | `/mindforge:tdd` | "Test-definition -> Implementation -> Refactor-cycle." | 100% tested feature code. |
+| **mindforge:executor** | `/mindforge:executor` | "Invoke mf-executor -> Logic implementation -> Atomic commits." | High-fidelity execution assistance. |
+| **mindforge:do** | `/mindforge:do` | "NLP intent routing -> Dispatcher -> Command execution." | Smart, intent-based action. |
+| **mindforge:auto** | `/mindforge:auto` | "Autonomous wave execution -> Self-correcting loop -> Sync." | Bulk, unattended execution. |
+| **mindforge:debug** | `/mindforge:debug` | "RCA investigation -> Log analysis -> Systematic repair." | Resolution of complex defects. |
+| **mindforge:quick** | `/mindforge:quick` | "Atomic task execution -> Validation -> Immediate commit." | Ultra-fast trivial changes. |
+| **mindforge:steer** | `/mindforge:steer` | "Engine interception -> Mid-execution guidance -> Adaptation." | Corrected autonomous engine flow. |
+
+## 🛡️ Verification & Quality
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:health** | `/mindforge:health` | "Component diagnostics -> Config-audit -> Self-repair." | Balanced system health state. |
+| **mindforge:validate-phase** | `/mindforge:validate-phase` | "Pillar gap analysis -> Requirement tracing -> Closure." | Validated and archived phase. |
+| **mindforge:pr-review** | `/mindforge:pr-review` | "Diff analysis -> Security check -> Performance-audit." | Quality-assured code review. |
+| **mindforge:security-scan** | `/mindforge:security-scan` | "Threat detection -> Hardcoding check -> OWASP auditing." | Hardened system security. |
+| **mindforge:metrics** | `/mindforge:metrics` | "Quality trends -> Speed index -> Efficiency scores." | Real-time performance insights. |
+| **mindforge:tokens** | `/mindforge:tokens` | "Consumption profile -> Cost analysis -> Optimization paths." | Optimized framework operation. |
+| **mindforge:reviewer** | `/mindforge:reviewer` | "Invoke mf-reviewer -> Independent quality check." | High-confidence code audit. |
+| **mindforge:audit** | `/mindforge:audit` | "Structured log analysis -> Integration query -> History." | Comprehensive event traceability. |
+
+## 📦 Release & Shipping
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:ship** | `/mindforge:ship` | "PR generation -> Documentation sync -> Release tagging." | Merged features and updated docs. |
+| **mindforge:release** | `/mindforge:release` | "Framework sync -> SemVer bump -> Global distribution." | New framework version release. |
+| **mindforge:complete-milestone** | `/mindforge:complete-milestone` | "Verification -> Archival -> Next-milestone setup." | Archived milestone and prep-next. |
+| **publish-release** | `/publish-release` | "Build orchestration -> Registry sync -> Distribution." | Deployed version to distribution hub. |
+
+## 🧠 Knowledge & AI Intelligence
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:learn** | `/mindforge:learn` | "Source ingestion -> Validation -> Reusable skill creation." | New framework capability (SKILL.md). |
+| **mindforge:remember** | `/mindforge:remember` | "Knowledge graph sync -> Semantic association -> Growth." | Evolving framework IQ. |
+| **mindforge:memory** | `/mindforge:memory` | "Invoke mf-memory -> Persistent context retrieval." | Real-time knowledge graph interaction. |
+| **mindforge:research** | `/mindforge:research` | "Deep context ingestion (Gemini) -> Logic synthesis." | Comprehensive research artifacts. |
+
+---
+*For more details, see the [MIND-FORGE-REFERENCE-V6.md](../MIND-FORGE-REFERENCE-V6.md).*

package/docs/user-guide.md

@@ -1,4 +1,4 @@
-# MindForge User Guide (v5.1.0)
+# MindForge User Guide (v5.10.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+.
 
@@ -169,10 +169,18 @@ Tier 3 (Principal) agents execute reasoning in isolated enclaves to protect sens
 /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.
+### Dynamic Human-Agent Handover & Temporal Steering (Pillar VII)
+NEXUS enables sub-second state reconstruction and **Hindsight Injection**. When an agent drifts, roll back its logic via the Dashboard's **Temporal Slider** and inject a steering vector to re-orient the wave.
 ```bash
-/mindforge:auto --handover 0.6 # Triggers handover at 60% confidence
+/mindforge:temporal status     # View active reasoning snapshots
+/mindforge:temporal inject [ID] # Manual CLI-based hindsight
+```
+
+### Agentic Revenue Operations (AgRevOps) (Pillar VIII)
+Treat compute as a financial asset. Monitor ROI ($100/hr value mapping) and Security Health directly.
+```bash
+/mindforge:costs --roi         # Detailed financial analysis
+/mindforge:finops status       # View velocity and debt metrics
 ```
 
 ---
@@ -204,11 +212,33 @@ Keep your framework current with the latest personas and library updates:
 
 ---
 
-## 15. Reference & Support
+---
+
+## 16. Mastering the Nexus: Temporal Steering
+
+MindForge v5.10.0 allows you to "time-travel" through your agent's reasoning.
+
+1.  **Launch the Dashboard**: `/mindforge:dashboard --start --open`
+2.  **Navigate to 'Temporal'**: Use the horizontal slider to scrub through reasoning snapshots.
+3.  **Inspect State**: View the exact memory, file diffs, and thought chain at that point in space-time.
+4.  **Inject Hindsight**: If you see a logic error, use the **Hindsight Injector** form to roll back and provide a corrective "Steering Vector."
+
+## 17. AgRevOps: Financial Health & ROI
+
+Monitor your project's economic performance in real-time via the **RevOps Hub**.
+
+- **ROI Pulse**: Tracks net value (Dev hours saved vs. Token cost).
+- **Velocity Gauge**: Real-time forecasting of milestone completion dates.
+- **Security Health Score (SHS)**: A 0-100 score that penalizes policy bypasses and critical findings. Maintain a score > 80 to ensure autonomous stability.
+
+---
+
+## 18. Reference & Support
 
 - **Architecture**: `docs/architecture/V5-ENTERPRISE.md`
 - **Governance**: `docs/governance-guide.md`
+- **Dashboard**: `docs/feature-dashboard.md`
+- **USP & Roadmap**: `docs/usp-features.md`
 - **Commands**: `docs/commands-reference.md`
-- **Personas**: `docs/PERSONAS.md`
 - **Troubleshooting**: `docs/troubleshooting.md`
 - **Discord**: `/mindforge:join-discord`