npm - mindforge-cc - Versions diffs - 8.2.0 → 9.0.0 - Mend

mindforge-cc 8.2.0 → 9.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1048) hide show

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/troubleshooting.md DELETED Viewed

@@ -1,139 +0,0 @@
-# MindForge Troubleshooting (v5.1.0)
-This page lists common issues and fast fixes. If you get stuck, start with
-`/mindforge:health`.
-## 1. Install issues
-### Installer exits immediately
-**Symptom:** `npx mindforge-cc` returns without installing.
-**Fix:** Ensure Node.js 18+.
-```bash
-node -v
-```
-Upgrade if below 18.
-### Existing CLAUDE.md overwritten
-**Symptom:** Custom instructions seem missing.
-**Fix:** The installer creates a backup if the old file didn’t include MindForge.
-Look for `CLAUDE.md.backup-<timestamp>` and merge your content.
-### Commands not showing
-**Symptom:** `/mindforge:help` doesn’t list commands.
-**Fix:** Verify the install location:
-- Claude Code: `~/.claude/commands/mindforge/`
-- Antigravity: `~/.gemini/antigravity/mindforge/`
-Run `/mindforge:health --repair`.
----
-## 2. Health check failures
-### CLAUDE.md drift detected
-**Fix:**
-```
-/mindforge:health --repair
-```
-This restores the canonical MindForge CLAUDE.md.
-### Missing .planning files
-**Fix:**
-```
-/mindforge:init-project
-```
-If you already have a project, run `/mindforge:map-codebase` instead.
----
-## 3. Migration / update problems
-### Update available but fails to apply
-**Fix:** Retry with explicit scope:
-```bash
-npx mindforge-cc@latest --claude --local --force
-```
-Then run:
-```
-/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 v5.1.0
-```
-### AUDIT.jsonl parse errors
-**Fix:** Migration preserves invalid lines. If a line is corrupt, archive it and
-rerun migration. See `.mindforge/audit/AUDIT-SCHEMA.md` for expected format.
----
-## 4. CI mode issues
-### CI silently skips interactive steps
-**Expected:** In CI, MindForge runs non-interactive by design.
-**Fix:** Ensure `CI=true` is set only in CI. Locally, unset it.
-### CI pipeline fails on Tier 3 changes
-**Expected:** Tier 3 changes fail CI by design.
-**Fix:** Route Tier 3 changes through approvals.
----
-## 5. Plugin issues
-### Plugin not loading
-**Fix:**
-- Run `/mindforge:plugins validate`
-- Check `plugin.json` for `mindforge_plugin_api_version: 1.0.0`
-- Ensure `min_mindforge_version` is <= your version
-### Command name conflicts
-**Expected:** Conflicting commands are renamed as `plugin-name-command`.
-**Fix:** Use the renamed command shown in output.
----
-## 6. Token usage too high
-**Fix:**
-- Reduce file reads or limit to ranges
-- Keep PLAN `<action>` lean (150–400 words)
-- Limit full skill injections to 3
-- Use `/mindforge:tokens --profile`
----
-## 7. Security scan failures
-**Fix:**
-- Review `.planning/phases/<N>/SECURITY-REVIEW-<N>.md`
-- Resolve CRITICAL/HIGH findings first
-- Re-run `/mindforge:security-scan --deep --secrets --deps`
----
-## 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/.mindforge/mirrors/mirror-sre-776a1cf9/docs/tutorial.md DELETED Viewed

@@ -1,162 +0,0 @@
-# MindForge v2.1.1 — Full Tutorial (Install → Advanced Usage)
-This tutorial walks a new user from installation to advanced usage. It is written for engineers who want to adopt MindForge in a real codebase.
----
-## 1. Install MindForge
-### Claude Code (local, per repo)
-```bash
-npx mindforge-cc@latest --claude --local
-```
-### Antigravity
-```bash
-npx mindforge-cc@latest --antigravity --local
-```
-### Specific Runtime (Universal)
-```bash
-npx mindforge-cc@latest --runtime <name>
-```
----
-## 2. Verify Installation
-Open your agentic runtime (Claude Code, Antigravity, etc.) in your repo and run:
-```bash
-/mindforge:health
-```
-If anything is wrong, run the repair command:
-```bash
-/mindforge:health --repair
-```
----
-## 3. Create a New Project
-```bash
-/mindforge:init-project
-```
-This command scaffolds the framework in `.agent/` and initializes project planning:
-- `.planning/PROJECT.md`: High-level vision and roadmap.
-- `.planning/REQUIREMENTS.md`: Functional and technical specs.
-- `.planning/STATE.md`: Real-time project health and milestone status.
----
-## 4. Onboarding an Existing Codebase
-```bash
-/mindforge:map-codebase
-```
-This command generates architectural insights:
-- `.planning/ARCHITECTURE.md`: Module relationships and data flow.
-- `.planning/CONVENTIONS.md`: Inferred coding styles and patterns.
----
-## 5. Unified Workflow (Phase 1)
-MindForge uses a 4-pillar iterative cycle:
-```bash
-/mindforge:plan-phase 1     # discuss → research → plan
-/mindforge:execute-phase 1  # parallel execution of task plans
-/mindforge:verify-phase 1   # UAT + automated validation
-/mindforge:ship 1           # generate release output + PR
-```
----
-## 6. High-Performance Personas
-MindForge v2.1.1 provides 32+ specialized personas. Each is a "digital twin" of a senior role.
-- To list all personas: `/mindforge:personas --list`
-- To switch persona: `/mindforge:personas --set executor`
----
-## 7. Real-time Dashboard
-Observable engineering is core to MindForge. Start the dashboard to see live agent activity:
-```bash
-/mindforge:dashboard --start --open
-```
-Visit `http://localhost:7339` for the premium web interface.
----
-## 8. Knowledge & Memory Management
-MindForge records architectural decisions to prevent regression.
-- Capture a note: `/mindforge:note "Preference: Use absolute imports for shared libs"`
-- Search memory: `/mindforge:remember --search "api patterns"`
----
-## 9. Self-Building Skills
-Learn new capabilities from documentation URL or local files:
-```bash
-/mindforge:learn https://docs.nextjs.org "nextjs-best-practices"
-```
----
-## 10. Security & Governance
-MindForge enforces strict compliance gates.
-```bash
-/mindforge:security-scan --deep
-```
-This checks for secrets, dependency vulnerabilities, and architectural drift.
----
-## 11. CI/CD Integration
-MindForge is designed for non-interactive execution in CI environments.
-- Set `CI=true` in your environment.
-- Use `/mindforge:ship --auto-pr` for automated delivery.
-See `docs/ci-cd-integration.md` for full pipeline examples.
----
-## 12. Troubleshooting
-If you hit issues, consult these specialized guides:
-- `docs/troubleshooting.md`: Common technical fixes.
-- `docs/faq.md`: Frequent questions and architectural patterns.
-- `docs/upgrade.md`: Migration guides between versions.
----
-## 13. Next Steps
-1. Configure your team preferences in `docs/Templates/Profile/user-profile.md`.
-2. Start your first Phase 1 planning.
-3. Join our community: `/mindforge:join-discord`.

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/upgrade.md DELETED Viewed

@@ -1,58 +0,0 @@
-# MindForge Upgrade Guide (v2.0.0)
-This guide covers upgrades from v0.6.0 to v2.0.0.
-## 1. Check version
-```bash
-node -e "console.log(require('./package.json').version)"
-```
-## 2. Update MindForge
-```
-/mindforge:update
-/mindforge:update --apply
-```
-If the update fails, run:
-```bash
-npx mindforge-cc@latest --claude --local --force
-```
-## 3. Migrate schema files
-### v0.6.0 to v1.0.0
-```
-/mindforge:migrate --from v0.6.0 --to v1.0.0
-```
-### v1.0.0 to v2.0.0
-```
-/mindforge:migrate --from v1.0.0 --to v2.0.0
-```
-MindForge v2 uses an **additive-only** migration strategy. Existing data is never deleted; only new fields (like `runtime`, `agent_id`, and `model_group`) are backfilled into your `AUDIT.jsonl` and `token-usage.jsonl` files.
-## 4. Verify
-```
-/mindforge:health
-/mindforge:status
-```
-## 5. Known breaking changes
-### v1.0.0
-- `VERIFY_PASS_RATE_WARNING_THRESHOLD` now uses 0.0–1.0 (was 0–100)
-- `AUDIT.jsonl` now requires `session_id` (auto-backfilled)
-- `HANDOFF.json` now requires `plugin_api_version`
-### v2.0.0
-- **Multi-Runtime Entry Points**: If installing for Cursor or Copilot, ensure you use the correct `--local` flag to generate `.cursorrules` or `copilot-instructions.md`.
-- **Preambles**: Non-slash runtimes now have a mandatory preamble in their entry files.
-## 6. Rollback
-If anything goes wrong, restore the migration backup:
-```
-ls .planning/migration-backup-*
-cp .planning/migration-backup-<timestamp>/* .planning/
-```
-Then re-run `/mindforge:migrate --dry-run`.

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/user-guide.md DELETED Viewed

@@ -1,244 +0,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+.
-## 1. Install
-### Claude Code (global)
-```bash
-npx mindforge-cc@latest --claude --global
-```
-### Claude Code (local, per project)
-```bash
-npx mindforge-cc@latest --claude --local
-```
-### Antigravity
-```bash
-npx mindforge-cc@latest --antigravity --local
-```
-### Specific Runtime (Universal)
-```bash
-npx mindforge-cc@latest --runtime <name>
-```
----
-## 2. Verify Installation
-Open your agentic runtime (Claude Code, Antigravity, etc.) in your project directory and run:
-```bash
-/mindforge:health
-```
-If health reports issues, run:
-```bash
-/mindforge:health --repair
-```
-## 3. Initialize a New Project
-```bash
-/mindforge:init-project
-```
-This scaffolds the core framework in `.agent/` and creates project-specific planning artifacts in `.planning/`.
-## 4. Onboarding an Existing Codebase
-```bash
-/mindforge:map-codebase
-```
-This analyzes your code, generating `.planning/ARCHITECTURE.md` and inferred development conventions.
----
-## 5. Unified Workflow (Enabled by Protocol Mesh)
-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 (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 v5.1.0 features 46+ specialized personas. Each persona is optimized for a specific stage of the lifecycle.
-- **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:
-```bash
-/mindforge:personas --list
-```
----
-## 7. Autonomous Execution
-For complex tasks that require minimal intervention:
-```bash
-/mindforge:autonomous --phase [N]
-```
-Use the **Steer** command to guide logic without stopping execution:
-```bash
-/mindforge:steer "Prioritize the React component refactoring"
-```
----
-## 8. Real-time Dashboard
-Observe your agent waves, token spend, and milestone progress in real-time.
-```bash
-/mindforge:dashboard --start --open
-```
-The dashboard provides a premium web interface at `http://localhost:7339`.
----
-## 9. Persistent Knowledge & Memory
-MindForge captures architectural decisions and bug patterns across sessions.
-```bash
-/mindforge:note "Add to memory: Always use functional components for UI"
-/mindforge:remember --search "auth patterns"
-```
----
-## 10. Self-Building Skills & Protocol Creation
-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 features automated PR creation and commit management.
-```bash
-/mindforge:pr-branch "feature/auth-refactor"
-/mindforge:ship --auto-pr
-```
----
-## 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 & 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: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
-```
----
-## 13. Neural Protocol Mesh (Enterprise Expansion)
-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.
-- **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:
-```bash
-/mindforge:update --apply
-```
----
----
-## 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`
-- **Troubleshooting**: `docs/troubleshooting.md`
-- **Discord**: `/mindforge:join-discord`

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/usp-features.md DELETED Viewed

@@ -1,102 +0,0 @@
-# MindForge: 32 Unique Selling Points & Core Features (v8.0.0 Celestial)
-MindForge is the enterprise's **Agentic OS**, built on the **CADIA v6.2 (Cross-Agentic Deterministic Intelligence Architecture)** framework. It provides a self-healing, self-optimizing environment for autonomous agent execution at scale.
----
-## The 16 Pillars of Celestial Intelligence
-1.  **Pillar I: Semantic Vector Consensus** (FIM v2) - Distributed knowledge merging.
-2.  **Pillar II: Dynamic Blast Radius** (APO v2) - Real-time risk scoring (CADIA).
-3.  **Pillar III: Predictive Agentic Reliability** (RES) - Heuristics to detect/interrupt reasoning loops.
-4.  **Pillar IV: Supply Chain Trust** (ZTAI) - Cryptographically signed skills and binary attestation.
-5.  **Pillar V: Multi-Cloud Arbitrage** (MCA) - Task-to-model affinity routing.
-6.  **Pillar VII: Hierarchical Intent Orchestration** (Nexus) - Tiered reasoning capture.
-7.  **Pillar VIII: AgRevOps ROI Engine** (Enterprise) - Quantifying economic value.
-8.  **Pillar IX: Autonomous Resource Harvesting** (ARH) - Real-time token arbitrage.
-9.  **Pillar X: Neural Drift Remediation** (NDR) - Proactive self-healing.
-10. **Pillar VI: Sovereign Reason Enclaves** (ZK-Audit) - Privacy-preserving audit trails.
-11. **Pillar XI: Post-Quantum Agentic Security** (PQAS) - Lattice-based signatures and bypasses.
-12. **Pillar XII: Proactive Semantic Homing** (Homing) - Proactive intent harvesting and mesh healing.
-13. **Pillar XV: Unified Persistence Layer** (v8) - Sub-millisecond SQL reasoning audits.
-14. **Pillar XVI: Federated Mesh Synthesis** (v8) - Cryptographically signed knowledge handoffs.
-15. **Pillar XVII: Autonomous Skill Evolution** (v8) - Self-generating skills from reasoning traces.
-16. **Pillar XVIII: Orbital Governance** (v8) - Hardware-attested safety gates (HSM).
----
-## 30 Elite Unique Selling Points (USPs)
-1.  **File-Driven Governance**: Behavior defined by Markdown/JSON, auditable like code.
-2.  **Wave-Based Parallel Execution**: Dependency-ordered clusters for speed without chaos.
-3.  **Non-Bypassable Compliance Gates**: 5 mandatory safety checks (Secrets, CVEs, Tests, etc.).
-4.  **Session Compaction & Continuity**: Machine-readable handoffs to preserve state across context turns.
-5.  **Production-Grade Installer**: Built-in update/uninstall and schema migration suite.
-6.  **Immutable Audit Trail**: Append-only `AUDIT.jsonl` for total transparency.
-7.  **Modular Skill Registry**: Extend capabilities without altering core engine files.
-8.  **Autonomous "Walk-Away" (v2)**: Intelligence repair (RETRY → DECOMPOSE) for independent work.
-9.  **Persistent Visual QA**: Browser runtime with visual diff verification.
-10. **Adversarial Multi-Model Review**: Cross-model validation (Gemini/Claude) for critical paths.
-11. **Automatic Semantic Shadowing**: RAG 2.0 with background pattern retrieval.
-12. **Temporal History Scrubbing**: "Time-Travel" dashboard to inspect and steer past states.
-13. **Self-Building Skills Platform**: Capture patterns from docs/npm into validated `SKILL.md` files.
-14. **Semantic Relevance Density (SRD)**: 40% reduction in token waste via tiered context sharding.
-15. **Red-Team Decision Synthesis**: Zero architectural drift through debate loops.
-16. **Hindsight Injection**: Correct logic errors on-the-fly via the Nexus temporal injector.
-17. **Dynamic Swarm Mesh**: Orchestrated specialist sub-agents with shared `SWARM-STATE`.
-18. **DID-Signed Identity (ZTAI)**: Non-repudiable logs backed by Decentralized Identifiers.
-19. **Sentinel Runtime Attestation**: Cryptographic integrity checks for every logic module.
-20. **Reasoning Entropy Scoring (RES)**: Proactive interruption of semantic deadlocks.
-21. **Nexus Temporal Slider**: High-fidelity dashboard for reasoning navigation.
-22. **AgRevOps Financial Governance**: Real-time dollar-value mapping per agentic cycle.
-23. **CADIA Blast Radius Optimizer**: Real-time architectural risk assessment (0-100).
-24. **Sovereign ROI Arbitrage**: Automated steering to lowest-cost/highest-value model tiers.
-25. **Ghost Pattern Detection**: Automated planning-phase detection of past architectural failures.
-26. **Sentinel Execution Center**: Centralized JIT attestation and reasoning guardrail enforcement.
-27. **Unified Persistence (Celestial DB)**: High-performance SQL engine for sub-millisecond reasoning audits.
-28. **Federated Mesh Synthesis**: Secure, signed knowledge exchange via MindForge Bundles (.mfb).
-29. **Autonomous Skill Evolution**: Trace-to-Skill mining loop for self-improving reasoning patterns.
-30. **Hardware-Bound Attestation**: HSM/Biometric security gates for critical architectural mutations.
----
-## Sovereign Core Feature Set
-### 1. Unified Intelligence Layer
-Unified API for Anthropic, OpenAI, and Gemini with persona-based routing and budget enforcement.
-### 2. Autonomous Workflow Engine
-End-to-end lifecycle management: `/plan` → `/execute` → `/verify` → `/ship`.
-### 3. Agentic Observability
-Real-time web dashboard for audit streams, reasoning heatmaps, and financial metrics.
-### 4. Zero-Trust Security
-Mandatory DID signatures, JIT skill attestation, and "Default Deny" posture for sensitive files.
-### 5. Multi-Project Memory (Global Mesh)
-Organizational-level knowledge sharing via the Global Intelligence Mesh.
----
-## Execution Guide (v6.1 Alpha)
-```bash
-# Core Cycle
-/mindforge:init-project
-/mindforge:plan-phase 1
-/mindforge:execute-phase 1
-/mindforge:verify-phase 1
-/mindforge:ship 1
-# Sovereign Commands
-/mindforge:auto --phase 1    # Autonomous Walk-Away
-/mindforge:costs --roi       # Detailed ROI analysis
-/mindforge:cross-review      # Adversarial review
-/mindforge:memory sync       # Global Mesh sync
-```
----
-## Summary
-MindForge v8.0.0 **Celestial Orchestration** represents the pinnacle of the Agentic OS evolution. By combining **Unified SQL Persistence** and **Federated Mesh Synthesis** with the core Sentinel security layer, it provides the first framework capable of local reasoning speed at a global federated scale with hardware-attested governance.