mindforge-cc 1.0.4 → 2.0.0-alpha.4

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 (98) hide show
  1. package/.agent/CLAUDE.md +53 -0
  2. package/.agent/mindforge/auto.md +22 -0
  3. package/.agent/mindforge/browse.md +26 -0
  4. package/.agent/mindforge/costs.md +11 -0
  5. package/.agent/mindforge/cross-review.md +17 -0
  6. package/.agent/mindforge/execute-phase.md +5 -3
  7. package/.agent/mindforge/qa.md +16 -0
  8. package/.agent/mindforge/remember.md +14 -0
  9. package/.agent/mindforge/research.md +11 -0
  10. package/.agent/mindforge/steer.md +13 -0
  11. package/.agent/workflows/publish-release.md +36 -0
  12. package/.claude/CLAUDE.md +53 -0
  13. package/.claude/commands/mindforge/auto.md +22 -0
  14. package/.claude/commands/mindforge/browse.md +26 -0
  15. package/.claude/commands/mindforge/costs.md +11 -0
  16. package/.claude/commands/mindforge/cross-review.md +17 -0
  17. package/.claude/commands/mindforge/execute-phase.md +5 -3
  18. package/.claude/commands/mindforge/qa.md +16 -0
  19. package/.claude/commands/mindforge/remember.md +14 -0
  20. package/.claude/commands/mindforge/research.md +11 -0
  21. package/.claude/commands/mindforge/steer.md +13 -0
  22. package/.mindforge/MINDFORGE-V2-SCHEMA.json +47 -0
  23. package/.mindforge/browser/daemon-protocol.md +24 -0
  24. package/.mindforge/browser/qa-engine.md +16 -0
  25. package/.mindforge/browser/session-manager.md +18 -0
  26. package/.mindforge/browser/visual-verify-spec.md +31 -0
  27. package/.mindforge/engine/autonomous/auto-executor.md +266 -0
  28. package/.mindforge/engine/autonomous/headless-adapter.md +66 -0
  29. package/.mindforge/engine/autonomous/node-repair.md +190 -0
  30. package/.mindforge/engine/autonomous/progress-reporter.md +58 -0
  31. package/.mindforge/engine/autonomous/steering-manager.md +64 -0
  32. package/.mindforge/engine/autonomous/stuck-detector.md +89 -0
  33. package/.mindforge/memory/MEMORY-SCHEMA.md +155 -0
  34. package/.mindforge/memory/decision-library.jsonl +0 -0
  35. package/.mindforge/memory/engine/capture-protocol.md +36 -0
  36. package/.mindforge/memory/engine/global-sync-spec.md +42 -0
  37. package/.mindforge/memory/engine/retrieval-spec.md +44 -0
  38. package/.mindforge/memory/knowledge-base.jsonl +7 -0
  39. package/.mindforge/memory/pattern-library.jsonl +1 -0
  40. package/.mindforge/memory/team-preferences.jsonl +4 -0
  41. package/.mindforge/models/model-registry.md +48 -0
  42. package/.mindforge/models/model-router.md +30 -0
  43. package/.mindforge/personas/research-agent.md +24 -0
  44. package/.planning/browser-daemon.log +32 -0
  45. package/.planning/decisions/ADR-021-autonomy-boundary.md +17 -0
  46. package/.planning/decisions/ADR-022-node-repair-hierarchy.md +19 -0
  47. package/.planning/decisions/ADR-023-gate-3-timing.md +15 -0
  48. package/CHANGELOG.md +73 -0
  49. package/MINDFORGE.md +26 -3
  50. package/README.md +59 -18
  51. package/bin/autonomous/auto-runner.js +95 -0
  52. package/bin/autonomous/headless.js +36 -0
  53. package/bin/autonomous/progress-stream.js +49 -0
  54. package/bin/autonomous/repair-operator.js +213 -0
  55. package/bin/autonomous/steer.js +71 -0
  56. package/bin/autonomous/stuck-monitor.js +77 -0
  57. package/bin/browser/browser-daemon.js +139 -0
  58. package/bin/browser/daemon-manager.js +91 -0
  59. package/bin/browser/qa-engine.js +47 -0
  60. package/bin/browser/qa-report-writer.js +32 -0
  61. package/bin/browser/regression-writer.js +27 -0
  62. package/bin/browser/screenshot-store.js +49 -0
  63. package/bin/browser/session-manager.js +93 -0
  64. package/bin/browser/visual-verify-executor.js +89 -0
  65. package/bin/install.js +7 -6
  66. package/bin/installer-core.js +64 -26
  67. package/bin/memory/cli.js +99 -0
  68. package/bin/memory/global-sync.js +107 -0
  69. package/bin/memory/knowledge-capture.js +278 -0
  70. package/bin/memory/knowledge-indexer.js +172 -0
  71. package/bin/memory/knowledge-store.js +319 -0
  72. package/bin/memory/session-memory-loader.js +137 -0
  73. package/bin/migrations/0.1.0-to-0.5.0.js +2 -3
  74. package/bin/migrations/0.5.0-to-0.6.0.js +1 -1
  75. package/bin/migrations/0.6.0-to-1.0.0.js +3 -3
  76. package/bin/migrations/migrate.js +15 -11
  77. package/bin/models/anthropic-provider.js +77 -0
  78. package/bin/models/cost-tracker.js +118 -0
  79. package/bin/models/gemini-provider.js +79 -0
  80. package/bin/models/model-client.js +98 -0
  81. package/bin/models/model-router.js +111 -0
  82. package/bin/models/openai-provider.js +78 -0
  83. package/bin/research/research-engine.js +115 -0
  84. package/bin/review/cross-review-engine.js +81 -0
  85. package/bin/review/finding-synthesizer.js +116 -0
  86. package/bin/review/review-report-writer.js +49 -0
  87. package/bin/updater/self-update.js +13 -13
  88. package/bin/wizard/setup-wizard.js +2 -1
  89. package/docs/adr/ADR-024-browser-localhost-only.md +17 -0
  90. package/docs/adr/ADR-025-visual-verify-failure-treatment.md +19 -0
  91. package/docs/adr/ADR-026-session-persistence-security.md +20 -0
  92. package/docs/architecture/README.md +4 -2
  93. package/docs/publishing-guide.md +78 -0
  94. package/docs/reference/commands.md +17 -2
  95. package/docs/reference/sdk-api.md +6 -1
  96. package/docs/user-guide.md +98 -9
  97. package/docs/usp-features.md +56 -8
  98. package/package.json +3 -2
@@ -1,7 +1,7 @@
1
- # MindForge v1.0.0 — Unique Selling Points, Features, and Best Practices
1
+ # MindForge v2.0.0 — Unique Selling Points, Features, and Best Practices (v2.0.0-alpha.4)
2
2
 
3
- This document summarizes what makes MindForge v1.0.0 distinct, what features
4
- are included in the first stable release, and how to use them effectively.
3
+ This document summarizes what makes MindForge v2.0.0 distinct, what features
4
+ are included in the latest alpha release, and how to use them effectively.
5
5
 
6
6
  ---
7
7
 
@@ -31,6 +31,18 @@ are included in the first stable release, and how to use them effectively.
31
31
  7. **Extensible with plugins and skills**
32
32
  - Plugins add commands and skills without changing core files, keeping upgrades safe.
33
33
 
34
+ 8. **Autonomous “Walk-Away” Execution (v2)**
35
+ - `/mindforge:auto` allows for full phase/milestone completion with intelligent stuck detection and node repair (RETRY → DECOMPOSE → ESCALATE).
36
+
37
+ 9. **Persistent Visual QA (v2)**
38
+ - Headful/headless browser runtime with named session persistence and systematic visual diff verification.
39
+
40
+ 10. **Multi-Model Intelligence Layer (v2)**
41
+ - Dynamic routing between Anthropic, OpenAI, and Gemini based on task persona and security tier. Adversarial code reviews ensure maximum coverage.
42
+
43
+ 11. **Persistent Knowledge Graph (v2)**
44
+ - Captures and ranks engineering context (decisions, bug patterns, preferences) across project sessions using TF-IDF and confidence reinforcement.
45
+
34
46
  ---
35
47
 
36
48
  ## Feature Set (v1.0.0)
@@ -141,18 +153,54 @@ preserving scope (local vs global).
141
153
 
142
154
  ---
143
155
 
144
- ### 10. Token Usage Optimiser
145
- **What it does:** Profiles and reduces token usage across sessions.
156
+ ### 11. Autonomous Execution (v2)
157
+ **What it does:** Enables handoff-free execution of complex phases and milestones.
146
158
 
147
159
  **How to use:**
160
+ ```bash
161
+ /mindforge:auto --phase 1
162
+ /mindforge:steer "Focus on security hardening next"
148
163
  ```
149
- /mindforge:tokens --profile
150
- /mindforge:tokens --summary
164
+
165
+ ---
166
+
167
+ ### 12. Browser Runtime & Visual QA (v2)
168
+ **What it does:** Playwright-powered browser control with session persistence and automated UI bug detection.
169
+
170
+ **How to use:**
171
+ ```bash
172
+ /mindforge:browse --navigate https://example.com
173
+ /mindforge:qa --diff
174
+ ```
175
+
176
+ ---
177
+
178
+ ### 13. Multi-Model Intelligence (v2)
179
+ **What it does:** Unified API client for Anthropic, OpenAI, and Gemini with persona-based routing and automated cost tracking.
180
+
181
+ **How to use:**
182
+ ```bash
183
+ /mindforge:cross-review # Adversarial multi-model review
184
+ /mindforge:research "Deep search query" # 1M context research
185
+ /mindforge:costs # Usage and budget summary
186
+ ```
187
+
188
+ ---
189
+
190
+ ### 14. Persistent Knowledge Graph (v2)
191
+ **What it does:** Long-term memory system that ensures architectural decisions and bug patterns are never forgotten. Supports TF-IDF search, confidence scoring, and global promotion.
192
+
193
+ **How to use:**
194
+ ```bash
195
+ /mindforge:remember --add "insight" # Manual capture
196
+ /mindforge:remember --search "query" # Manual retrieval
197
+ /mindforge:remember --promote [ID] # Promote to machine-wide global store
198
+ /mindforge:remember --stats # View memory health
151
199
  ```
152
200
 
153
201
  ---
154
202
 
155
- ### 11. SDK (TypeScript)
203
+ ### 15. SDK (TypeScript)
156
204
  **What it does:** Programmatic access to health, audit log, event stream, and commands.
157
205
 
158
206
  **How to use:**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mindforge-cc",
3
- "version": "1.0.4",
3
+ "version": "2.0.0-alpha.4",
4
4
  "description": "MindForge - Enterprise Agentic Framework for Claude Code and Antigravity",
5
5
  "bin": {
6
6
  "mindforge-cc": "bin/install.js"
@@ -39,7 +39,8 @@
39
39
  "@eslint/js": "^9.0.0",
40
40
  "@types/node": "^20.0.0",
41
41
  "eslint": "^9.0.0",
42
- "globals": "^15.0.0"
42
+ "globals": "^15.0.0",
43
+ "playwright": "^1.40.0"
43
44
  },
44
45
  "engines": {
45
46
  "node": ">=18.0.0"