mindforge-cc 11.8.3 → 11.9.1

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 (435) hide show
  1. package/.agent/mindforge/ship.md +2 -2
  2. package/.agent/mindforge/update.md +1 -1
  3. package/.agent/mindforge/wf-catalog.md +5 -2
  4. package/.agent/mindforge/wf-orchestrate-review.md +35 -0
  5. package/.agent/mindforge/wf-verification-loop.md +45 -0
  6. package/.agent/mindforge/wf-workflow-optimizer.md +51 -0
  7. package/.agent/skills/article-illustrator/SKILL.md +7 -7
  8. package/.agent/skills/arxiv/SKILL.md +6 -6
  9. package/.agent/skills/code-wiki/SKILL.md +11 -11
  10. package/.agent/skills/concept-diagrams/SKILL.md +6 -6
  11. package/.agent/skills/concept-diagrams/examples/apartment-floor-plan-conversion.md +244 -0
  12. package/.agent/skills/concept-diagrams/examples/automated-password-reset-flow.md +276 -0
  13. package/.agent/skills/concept-diagrams/examples/autonomous-llm-research-agent-flow.md +240 -0
  14. package/.agent/skills/concept-diagrams/examples/banana-journey-tree-to-smoothie.md +161 -0
  15. package/.agent/skills/concept-diagrams/examples/commercial-aircraft-structure.md +209 -0
  16. package/.agent/skills/concept-diagrams/examples/cpu-ooo-microarchitecture.md +236 -0
  17. package/.agent/skills/concept-diagrams/examples/electricity-grid-flow.md +182 -0
  18. package/.agent/skills/concept-diagrams/examples/feature-film-production-pipeline.md +172 -0
  19. package/.agent/skills/concept-diagrams/examples/hospital-emergency-department-flow.md +165 -0
  20. package/.agent/skills/concept-diagrams/examples/ml-benchmark-grouped-bar-chart.md +114 -0
  21. package/.agent/skills/concept-diagrams/examples/place-order-uml-sequence.md +325 -0
  22. package/.agent/skills/concept-diagrams/examples/smart-city-infrastructure.md +173 -0
  23. package/.agent/skills/concept-diagrams/examples/smartphone-layer-anatomy.md +154 -0
  24. package/.agent/skills/concept-diagrams/examples/sn2-reaction-mechanism.md +247 -0
  25. package/.agent/skills/concept-diagrams/examples/wind-turbine-structure.md +338 -0
  26. package/.agent/skills/concept-diagrams/templates/template.html +174 -0
  27. package/.agent/skills/domain-intel/SKILL.md +7 -7
  28. package/.agent/skills/duckduckgo-search/SKILL.md +17 -17
  29. package/.agent/skills/github-auth/scripts/gh-env.sh +66 -0
  30. package/.agent/skills/github-code-review/SKILL.md +9 -9
  31. package/.agent/skills/github-pr-workflow/SKILL.md +3 -3
  32. package/.agent/skills/godmode/SKILL.md +8 -8
  33. package/.agent/skills/jupyter-live-kernel/SKILL.md +3 -3
  34. package/.agent/skills/kanban-orchestrator/SKILL.md +10 -10
  35. package/.agent/skills/kanban-worker/SKILL.md +6 -6
  36. package/.agent/skills/llm-wiki/SKILL.md +7 -7
  37. package/.agent/skills/mindforge-autonomous/SKILL.md +1 -1
  38. package/.agent/skills/mindforge-complete-milestone/SKILL.md +1 -1
  39. package/.agent/skills/mindforge-discuss-phase/SKILL.md +1 -1
  40. package/.agent/skills/mindforge-do/SKILL.md +1 -1
  41. package/.agent/skills/mindforge-execute-phase/SKILL.md +1 -1
  42. package/.agent/skills/mindforge-list-workspaces/SKILL.md +1 -1
  43. package/.agent/skills/mindforge-manager/SKILL.md +1 -1
  44. package/.agent/skills/mindforge-neural-orchestrator/SKILL.md +1 -1
  45. package/.agent/skills/mindforge-new-milestone/SKILL.md +4 -4
  46. package/.agent/skills/mindforge-new-project/SKILL.md +4 -4
  47. package/.agent/skills/mindforge-new-workspace/SKILL.md +1 -1
  48. package/.agent/skills/mindforge-note/SKILL.md +1 -1
  49. package/.agent/skills/mindforge-plan-phase/SKILL.md +1 -1
  50. package/.agent/skills/mindforge-profile-user/SKILL.md +1 -1
  51. package/.agent/skills/mindforge-remove-workspace/SKILL.md +1 -1
  52. package/.agent/skills/mindforge-research-phase/SKILL.md +1 -1
  53. package/.agent/skills/mindforge-ui-phase/SKILL.md +1 -1
  54. package/.agent/skills/mindforge-ui-review/SKILL.md +1 -1
  55. package/.agent/skills/mindforge-verify-work/SKILL.md +1 -1
  56. package/.agent/skills/mindforge-workspace-isolated/SKILL.md +1 -1
  57. package/.agent/skills/node-inspect-debugger/SKILL.md +1 -1
  58. package/.agent/skills/obsidian/SKILL.md +15 -15
  59. package/.agent/skills/osint-investigation/SKILL.md +3 -2
  60. package/.agent/skills/osint-investigation/references/sources/courtlistener.md +98 -0
  61. package/.agent/skills/osint-investigation/references/sources/gdelt.md +104 -0
  62. package/.agent/skills/osint-investigation/references/sources/icij-offshore.md +104 -0
  63. package/.agent/skills/osint-investigation/references/sources/nyc-acris.md +90 -0
  64. package/.agent/skills/osint-investigation/references/sources/ofac-sdn.md +92 -0
  65. package/.agent/skills/osint-investigation/references/sources/opencorporates.md +103 -0
  66. package/.agent/skills/osint-investigation/references/sources/sec-edgar.md +83 -0
  67. package/.agent/skills/osint-investigation/references/sources/senate-ld.md +89 -0
  68. package/.agent/skills/osint-investigation/references/sources/usaspending.md +97 -0
  69. package/.agent/skills/osint-investigation/references/sources/wayback.md +93 -0
  70. package/.agent/skills/osint-investigation/references/sources/wikipedia.md +107 -0
  71. package/.agent/skills/osint-investigation/scripts/_http.py +82 -0
  72. package/.agent/skills/osint-investigation/scripts/_normalize.py +67 -0
  73. package/.agent/skills/osint-investigation/scripts/build_findings.py +221 -0
  74. package/.agent/skills/osint-investigation/scripts/entity_resolution.py +228 -0
  75. package/.agent/skills/osint-investigation/scripts/fetch_courtlistener.py +149 -0
  76. package/.agent/skills/osint-investigation/scripts/fetch_gdelt.py +161 -0
  77. package/.agent/skills/osint-investigation/scripts/fetch_icij_offshore.py +234 -0
  78. package/.agent/skills/osint-investigation/scripts/fetch_nyc_acris.py +203 -0
  79. package/.agent/skills/osint-investigation/scripts/fetch_ofac_sdn.py +175 -0
  80. package/.agent/skills/osint-investigation/scripts/fetch_opencorporates.py +191 -0
  81. package/.agent/skills/osint-investigation/scripts/fetch_sec_edgar.py +184 -0
  82. package/.agent/skills/osint-investigation/scripts/fetch_senate_ld.py +146 -0
  83. package/.agent/skills/osint-investigation/scripts/fetch_usaspending.py +170 -0
  84. package/.agent/skills/osint-investigation/scripts/fetch_wayback.py +142 -0
  85. package/.agent/skills/osint-investigation/scripts/fetch_wikipedia.py +266 -0
  86. package/.agent/skills/osint-investigation/scripts/timing_analysis.py +252 -0
  87. package/.agent/skills/oss-forensics/SKILL.md +10 -9
  88. package/.agent/skills/oss-forensics/scripts/evidence-store.py +313 -0
  89. package/.agent/skills/parallel-cli/SKILL.md +2 -2
  90. package/.agent/skills/pinggy-tunnel/SKILL.md +3 -3
  91. package/.agent/skills/pixel-art/SKILL.md +2 -2
  92. package/.agent/skills/plan/SKILL.md +10 -10
  93. package/.agent/skills/requesting-code-review/SKILL.md +4 -6
  94. package/.agent/skills/research-paper-writing/SKILL.md +32 -32
  95. package/.agent/skills/rest-graphql-debug/SKILL.md +31 -32
  96. package/.agent/skills/s6-container-supervision/SKILL.md +1 -1
  97. package/.agent/skills/scrapling/SKILL.md +1 -1
  98. package/.agent/skills/sherlock/SKILL.md +1 -1
  99. package/.agent/skills/simplify-code/SKILL.md +5 -7
  100. package/.agent/skills/skill-authoring/SKILL.md +4 -4
  101. package/.agent/skills/spike/SKILL.md +11 -13
  102. package/.agent/skills/subagent-driven-development/SKILL.md +7 -11
  103. package/.agent/skills/systematic-debugging/SKILL.md +13 -14
  104. package/.agent/skills/test-driven-development/SKILL.md +6 -7
  105. package/.agent/skills/video-orchestrator/SKILL.md +1 -1
  106. package/.agent/skills/web-pentest/SKILL.md +7 -7
  107. package/.claude/commands/mindforge/ship.md +2 -2
  108. package/.claude/commands/mindforge/update.md +1 -1
  109. package/.claude/commands/mindforge/wf-catalog.md +5 -2
  110. package/.claude/commands/mindforge/wf-orchestrate-review.md +35 -0
  111. package/.claude/commands/mindforge/wf-verification-loop.md +45 -0
  112. package/.claude/commands/mindforge/wf-workflow-optimizer.md +51 -0
  113. package/.mindforge/config.json +3 -3
  114. package/.mindforge/dynamic-workflows/REGISTRY.md +4 -1
  115. package/.mindforge/dynamic-workflows/index.json +910 -840
  116. package/.mindforge/dynamic-workflows/scripts/accessibility-audit.js +88 -90
  117. package/.mindforge/dynamic-workflows/scripts/ai-model-eval.js +59 -61
  118. package/.mindforge/dynamic-workflows/scripts/api-contract-test.js +87 -85
  119. package/.mindforge/dynamic-workflows/scripts/api-migration.js +120 -122
  120. package/.mindforge/dynamic-workflows/scripts/architecture-modernization.js +84 -86
  121. package/.mindforge/dynamic-workflows/scripts/code-audit.js +75 -77
  122. package/.mindforge/dynamic-workflows/scripts/code-explainer.js +99 -101
  123. package/.mindforge/dynamic-workflows/scripts/competitive-analysis.js +62 -64
  124. package/.mindforge/dynamic-workflows/scripts/competitive-teardown.js +106 -108
  125. package/.mindforge/dynamic-workflows/scripts/cost-analysis.js +78 -80
  126. package/.mindforge/dynamic-workflows/scripts/data-pipeline-validate.js +47 -49
  127. package/.mindforge/dynamic-workflows/scripts/database-migration.js +85 -87
  128. package/.mindforge/dynamic-workflows/scripts/debug-detective.js +97 -99
  129. package/.mindforge/dynamic-workflows/scripts/dependency-health.js +81 -83
  130. package/.mindforge/dynamic-workflows/scripts/design-system-audit.js +84 -86
  131. package/.mindforge/dynamic-workflows/scripts/documentation-gen.js +65 -67
  132. package/.mindforge/dynamic-workflows/scripts/feature-planner.js +78 -80
  133. package/.mindforge/dynamic-workflows/scripts/incident-response.js +81 -83
  134. package/.mindforge/dynamic-workflows/scripts/multi-repo-sync.js +49 -51
  135. package/.mindforge/dynamic-workflows/scripts/mutation-testing.js +113 -115
  136. package/.mindforge/dynamic-workflows/scripts/onboard-codebase.js +79 -81
  137. package/.mindforge/dynamic-workflows/scripts/orchestrate-review.js +115 -0
  138. package/.mindforge/dynamic-workflows/scripts/perf-optimize.js +97 -99
  139. package/.mindforge/dynamic-workflows/scripts/pr-review.js +61 -63
  140. package/.mindforge/dynamic-workflows/scripts/refactor-plan.js +88 -90
  141. package/.mindforge/dynamic-workflows/scripts/release-prep.js +79 -81
  142. package/.mindforge/dynamic-workflows/scripts/security-hardening.js +117 -119
  143. package/.mindforge/dynamic-workflows/scripts/security-threat-model.js +119 -121
  144. package/.mindforge/dynamic-workflows/scripts/tdd-sprint.js +80 -82
  145. package/.mindforge/dynamic-workflows/scripts/tech-evaluation.js +50 -52
  146. package/.mindforge/dynamic-workflows/scripts/test-coverage-gap.js +68 -70
  147. package/.mindforge/dynamic-workflows/scripts/ux-heuristic-audit.js +89 -91
  148. package/.mindforge/dynamic-workflows/scripts/verification-loop.js +138 -0
  149. package/.mindforge/dynamic-workflows/scripts/workflow-optimizer.js +136 -0
  150. package/.mindforge/dynamic-workflows/scripts/writer-reviewer.js +63 -65
  151. package/.mindforge/memory/sync-manifest.json +1 -1
  152. package/.mindforge/personas/advisor-researcher.md +2 -2
  153. package/.mindforge/personas/api-load-tester.md +1 -1
  154. package/.mindforge/personas/authentication-architect.md +1 -1
  155. package/.mindforge/personas/backup-recovery-specialist.md +1 -1
  156. package/.mindforge/personas/build-optimizer.md +1 -1
  157. package/.mindforge/personas/caching-strategist.md +1 -1
  158. package/.mindforge/personas/chaos-engineer.md +1 -1
  159. package/.mindforge/personas/compliance-auditor.md +1 -1
  160. package/.mindforge/personas/config-management-expert.md +1 -1
  161. package/.mindforge/personas/coverage-specialist.md +1 -1
  162. package/.mindforge/personas/debug-specialist.md +2 -2
  163. package/.mindforge/personas/debugger.md +2 -2
  164. package/.mindforge/personas/dependency-auditor.md +1 -1
  165. package/.mindforge/personas/developer.md +1 -1
  166. package/.mindforge/personas/devops-engineer.md +1 -1
  167. package/.mindforge/personas/doc-auditor.md +1 -1
  168. package/.mindforge/personas/executor.md +1 -1
  169. package/.mindforge/personas/go-specialist.md +1 -1
  170. package/.mindforge/personas/incident-commander.md +1 -1
  171. package/.mindforge/personas/java-specialist.md +1 -1
  172. package/.mindforge/personas/kubernetes-debugger.md +1 -1
  173. package/.mindforge/personas/logging-architect.md +1 -1
  174. package/.mindforge/personas/mf-planner.md +1 -1
  175. package/.mindforge/personas/mf-researcher.md +1 -1
  176. package/.mindforge/personas/mf-reviewer.md +1 -1
  177. package/.mindforge/personas/monorepo-architect.md +2 -1
  178. package/.mindforge/personas/nyquist-auditor.md +1 -1
  179. package/.mindforge/personas/observability-engineer.md +1 -1
  180. package/.mindforge/personas/performance-optimizer.md +1 -1
  181. package/.mindforge/personas/phase-researcher.md +5 -5
  182. package/.mindforge/personas/planner.md +1 -1
  183. package/.mindforge/personas/project-researcher.md +2 -2
  184. package/.mindforge/personas/python-specialist.md +1 -1
  185. package/.mindforge/personas/qa-engineer.md +1 -1
  186. package/.mindforge/personas/release-manager.md +6 -4
  187. package/.mindforge/personas/research-agent.md +4 -4
  188. package/.mindforge/personas/roadmapper-extend.md +1 -1
  189. package/.mindforge/personas/rust-specialist.md +1 -1
  190. package/.mindforge/personas/security-reviewer.md +1 -1
  191. package/.mindforge/personas/tech-writer.md +1 -1
  192. package/.mindforge/personas/typescript-wizard.md +1 -1
  193. package/.mindforge/personas/ui-researcher.md +1 -1
  194. package/.mindforge/skills/accessibility/SKILL.md +2 -2
  195. package/.mindforge/skills/agent-architecture-audit/SKILL.md +11 -0
  196. package/.mindforge/skills/arxiv/SKILL.md +6 -6
  197. package/.mindforge/skills/arxiv/scripts/search_arxiv.py +114 -0
  198. package/.mindforge/skills/code-tour/SKILL.md +2 -2
  199. package/.mindforge/skills/code-wiki/SKILL.md +11 -11
  200. package/.mindforge/skills/code-wiki/templates/README.md +31 -0
  201. package/.mindforge/skills/code-wiki/templates/architecture.md +30 -0
  202. package/.mindforge/skills/code-wiki/templates/getting-started.md +47 -0
  203. package/.mindforge/skills/code-wiki/templates/module.md +38 -0
  204. package/.mindforge/skills/concept-diagrams/SKILL.md +6 -6
  205. package/.mindforge/skills/concept-diagrams/examples/apartment-floor-plan-conversion.md +244 -0
  206. package/.mindforge/skills/concept-diagrams/examples/automated-password-reset-flow.md +276 -0
  207. package/.mindforge/skills/concept-diagrams/examples/autonomous-llm-research-agent-flow.md +240 -0
  208. package/.mindforge/skills/concept-diagrams/examples/banana-journey-tree-to-smoothie.md +161 -0
  209. package/.mindforge/skills/concept-diagrams/examples/commercial-aircraft-structure.md +209 -0
  210. package/.mindforge/skills/concept-diagrams/examples/cpu-ooo-microarchitecture.md +236 -0
  211. package/.mindforge/skills/concept-diagrams/examples/electricity-grid-flow.md +182 -0
  212. package/.mindforge/skills/concept-diagrams/examples/feature-film-production-pipeline.md +172 -0
  213. package/.mindforge/skills/concept-diagrams/examples/hospital-emergency-department-flow.md +165 -0
  214. package/.mindforge/skills/concept-diagrams/examples/ml-benchmark-grouped-bar-chart.md +114 -0
  215. package/.mindforge/skills/concept-diagrams/examples/place-order-uml-sequence.md +325 -0
  216. package/.mindforge/skills/concept-diagrams/examples/smart-city-infrastructure.md +173 -0
  217. package/.mindforge/skills/concept-diagrams/examples/smartphone-layer-anatomy.md +154 -0
  218. package/.mindforge/skills/concept-diagrams/examples/sn2-reaction-mechanism.md +247 -0
  219. package/.mindforge/skills/concept-diagrams/examples/wind-turbine-structure.md +338 -0
  220. package/.mindforge/skills/concept-diagrams/references/dashboard-patterns.md +43 -0
  221. package/.mindforge/skills/concept-diagrams/references/infrastructure-patterns.md +144 -0
  222. package/.mindforge/skills/concept-diagrams/references/physical-shape-cookbook.md +42 -0
  223. package/.mindforge/skills/concept-diagrams/templates/template.html +174 -0
  224. package/.mindforge/skills/creative-ideation/references/full-prompt-library.md +110 -0
  225. package/.mindforge/skills/documentation/SKILL.md +4 -1
  226. package/.mindforge/skills/domain-intel/SKILL.md +7 -7
  227. package/.mindforge/skills/domain-intel/scripts/domain_intel.py +397 -0
  228. package/.mindforge/skills/duckduckgo-search/SKILL.md +17 -17
  229. package/.mindforge/skills/duckduckgo-search/scripts/duckduckgo.sh +28 -0
  230. package/.mindforge/skills/environment-management/SKILL.md +1 -1
  231. package/.mindforge/skills/github-code-review/SKILL.md +9 -9
  232. package/.mindforge/skills/github-code-review/references/review-output-template.md +74 -0
  233. package/.mindforge/skills/github-issues/templates/bug-report.md +35 -0
  234. package/.mindforge/skills/github-issues/templates/feature-request.md +31 -0
  235. package/.mindforge/skills/github-pr-workflow/SKILL.md +3 -3
  236. package/.mindforge/skills/github-pr-workflow/references/ci-troubleshooting.md +183 -0
  237. package/.mindforge/skills/github-pr-workflow/references/conventional-commits.md +71 -0
  238. package/.mindforge/skills/github-pr-workflow/templates/pr-body-bugfix.md +35 -0
  239. package/.mindforge/skills/github-pr-workflow/templates/pr-body-feature.md +33 -0
  240. package/.mindforge/skills/jupyter-live-kernel/SKILL.md +3 -3
  241. package/.mindforge/skills/kanban-orchestrator/SKILL.md +10 -10
  242. package/.mindforge/skills/kanban-worker/SKILL.md +6 -6
  243. package/.mindforge/skills/meme-generation/SKILL.md +1 -1
  244. package/.mindforge/skills/meme-generation/scripts/generate_meme.py +470 -0
  245. package/.mindforge/skills/meme-generation/scripts/templates.json +97 -0
  246. package/.mindforge/skills/obsidian/SKILL.md +15 -15
  247. package/.mindforge/skills/orch-pipeline/SKILL.md +2 -2
  248. package/.mindforge/skills/osint-investigation/SKILL.md +3 -2
  249. package/.mindforge/skills/osint-investigation/references/sources/courtlistener.md +98 -0
  250. package/.mindforge/skills/osint-investigation/references/sources/gdelt.md +104 -0
  251. package/.mindforge/skills/osint-investigation/references/sources/icij-offshore.md +104 -0
  252. package/.mindforge/skills/osint-investigation/references/sources/nyc-acris.md +90 -0
  253. package/.mindforge/skills/osint-investigation/references/sources/ofac-sdn.md +92 -0
  254. package/.mindforge/skills/osint-investigation/references/sources/opencorporates.md +103 -0
  255. package/.mindforge/skills/osint-investigation/references/sources/sec-edgar.md +83 -0
  256. package/.mindforge/skills/osint-investigation/references/sources/senate-ld.md +89 -0
  257. package/.mindforge/skills/osint-investigation/references/sources/usaspending.md +97 -0
  258. package/.mindforge/skills/osint-investigation/references/sources/wayback.md +93 -0
  259. package/.mindforge/skills/osint-investigation/references/sources/wikipedia.md +107 -0
  260. package/.mindforge/skills/osint-investigation/scripts/_http.py +82 -0
  261. package/.mindforge/skills/osint-investigation/scripts/_normalize.py +67 -0
  262. package/.mindforge/skills/osint-investigation/scripts/build_findings.py +221 -0
  263. package/.mindforge/skills/osint-investigation/scripts/entity_resolution.py +228 -0
  264. package/.mindforge/skills/osint-investigation/scripts/fetch_courtlistener.py +149 -0
  265. package/.mindforge/skills/osint-investigation/scripts/fetch_gdelt.py +161 -0
  266. package/.mindforge/skills/osint-investigation/scripts/fetch_icij_offshore.py +234 -0
  267. package/.mindforge/skills/osint-investigation/scripts/fetch_nyc_acris.py +203 -0
  268. package/.mindforge/skills/osint-investigation/scripts/fetch_ofac_sdn.py +175 -0
  269. package/.mindforge/skills/osint-investigation/scripts/fetch_opencorporates.py +191 -0
  270. package/.mindforge/skills/osint-investigation/scripts/fetch_sec_edgar.py +184 -0
  271. package/.mindforge/skills/osint-investigation/scripts/fetch_senate_ld.py +146 -0
  272. package/.mindforge/skills/osint-investigation/scripts/fetch_usaspending.py +170 -0
  273. package/.mindforge/skills/osint-investigation/scripts/fetch_wayback.py +142 -0
  274. package/.mindforge/skills/osint-investigation/scripts/fetch_wikipedia.py +266 -0
  275. package/.mindforge/skills/osint-investigation/scripts/timing_analysis.py +252 -0
  276. package/.mindforge/skills/osint-investigation/templates/source-template.md +59 -0
  277. package/.mindforge/skills/oss-forensics/SKILL.md +6 -6
  278. package/.mindforge/skills/oss-forensics/references/evidence-types.md +89 -0
  279. package/.mindforge/skills/oss-forensics/references/github-archive-guide.md +184 -0
  280. package/.mindforge/skills/oss-forensics/references/investigation-templates.md +131 -0
  281. package/.mindforge/skills/oss-forensics/references/recovery-techniques.md +164 -0
  282. package/.mindforge/skills/oss-forensics/scripts/evidence-store.py +313 -0
  283. package/.mindforge/skills/oss-forensics/templates/forensic-report.md +151 -0
  284. package/.mindforge/skills/oss-forensics/templates/malicious-package-report.md +43 -0
  285. package/.mindforge/skills/pixel-art/SKILL.md +2 -2
  286. package/.mindforge/skills/pixel-art/references/palettes.md +49 -0
  287. package/.mindforge/skills/plan/SKILL.md +10 -10
  288. package/.mindforge/skills/requesting-code-review/SKILL.md +4 -6
  289. package/.mindforge/skills/research-paper-writing/SKILL.md +32 -32
  290. package/.mindforge/skills/research-paper-writing/references/autoreason-methodology.md +394 -0
  291. package/.mindforge/skills/research-paper-writing/references/checklists.md +434 -0
  292. package/.mindforge/skills/research-paper-writing/references/citation-workflow.md +563 -0
  293. package/.mindforge/skills/research-paper-writing/references/experiment-patterns.md +728 -0
  294. package/.mindforge/skills/research-paper-writing/references/human-evaluation.md +476 -0
  295. package/.mindforge/skills/research-paper-writing/references/paper-types.md +481 -0
  296. package/.mindforge/skills/research-paper-writing/references/reviewer-guidelines.md +433 -0
  297. package/.mindforge/skills/research-paper-writing/references/sources.md +191 -0
  298. package/.mindforge/skills/research-paper-writing/references/writing-guide.md +474 -0
  299. package/.mindforge/skills/research-paper-writing/templates/README.md +251 -0
  300. package/.mindforge/skills/scrapling/SKILL.md +1 -1
  301. package/.mindforge/skills/sherlock/SKILL.md +1 -1
  302. package/.mindforge/skills/simplify-code/SKILL.md +5 -7
  303. package/.mindforge/skills/spike/SKILL.md +11 -13
  304. package/.mindforge/skills/subagent-driven-development/SKILL.md +7 -11
  305. package/.mindforge/skills/subagent-driven-development/references/context-budget-discipline.md +53 -0
  306. package/.mindforge/skills/subagent-driven-development/references/gates-taxonomy.md +93 -0
  307. package/.mindforge/skills/systematic-debugging/SKILL.md +13 -14
  308. package/.mindforge/skills/test-driven-development/SKILL.md +6 -7
  309. package/.mindforge/skills/testing-standards/SKILL.md +1 -1
  310. package/.mindforge/skills/web-pentest/SKILL.md +2 -2
  311. package/.mindforge/skills/web-pentest/references/bypass-techniques.md +133 -0
  312. package/.mindforge/skills/web-pentest/references/exploitation-techniques.md +204 -0
  313. package/.mindforge/skills/web-pentest/references/scope-enforcement.md +110 -0
  314. package/.mindforge/skills/web-pentest/references/vuln-taxonomy.md +81 -0
  315. package/.mindforge/skills/web-pentest/templates/authorization.md +69 -0
  316. package/.mindforge/skills/web-pentest/templates/pentest-report.md +178 -0
  317. package/.mindforge/skills/writing-skills/SKILL.md +4 -3
  318. package/CHANGELOG.md +23 -1821
  319. package/MINDFORGE.md +3 -3
  320. package/README.md +58 -510
  321. package/RELEASENOTES.md +87 -2
  322. package/SECURITY.md +5 -3
  323. package/bin/install.js +1 -1
  324. package/bin/models/bedrock-provider.js +192 -0
  325. package/bin/models/model-client.js +19 -0
  326. package/bin/updater/changelog-fetcher.js +95 -5
  327. package/bin/utils/readiness-gate.js +3 -3
  328. package/changelogs/README.md +109 -0
  329. package/changelogs/index.json +103 -0
  330. package/changelogs/v0.1.0.md +21 -0
  331. package/changelogs/v0.2.0.md +15 -0
  332. package/changelogs/v0.3.0.md +28 -0
  333. package/changelogs/v0.4.0.md +29 -0
  334. package/changelogs/v0.5.0.md +34 -0
  335. package/changelogs/v0.6.0.md +34 -0
  336. package/changelogs/v1.0.0.md +60 -0
  337. package/changelogs/v1.0.1.md +15 -0
  338. package/changelogs/v1.0.2.md +10 -0
  339. package/changelogs/v1.0.3.md +10 -0
  340. package/changelogs/v1.0.4.md +10 -0
  341. package/changelogs/v1.0.5.md +10 -0
  342. package/changelogs/v10.0.0.md +71 -0
  343. package/changelogs/v10.0.2.md +15 -0
  344. package/changelogs/v10.0.3.md +21 -0
  345. package/changelogs/v10.0.4.md +16 -0
  346. package/changelogs/v10.0.5.md +16 -0
  347. package/changelogs/v10.0.6.md +15 -0
  348. package/changelogs/v10.0.7.md +15 -0
  349. package/changelogs/v10.0.8.md +15 -0
  350. package/changelogs/v10.0.9.md +15 -0
  351. package/changelogs/v10.1.0.md +16 -0
  352. package/changelogs/v10.1.1.md +15 -0
  353. package/changelogs/v10.2.0.md +14 -0
  354. package/changelogs/v10.3.0.md +13 -0
  355. package/changelogs/v10.4.0.md +13 -0
  356. package/changelogs/v10.5.0.md +13 -0
  357. package/changelogs/v10.6.0.md +13 -0
  358. package/changelogs/v10.7.0.md +15 -0
  359. package/changelogs/v11.0.0.md +66 -0
  360. package/changelogs/v11.0.1.md +10 -0
  361. package/changelogs/v11.1.0.md +56 -0
  362. package/changelogs/v11.2.0.md +41 -0
  363. package/changelogs/v11.2.1.md +38 -0
  364. package/changelogs/v11.3.0.md +45 -0
  365. package/changelogs/v11.3.1.md +39 -0
  366. package/changelogs/v11.4.0.md +38 -0
  367. package/changelogs/v11.5.0.md +77 -0
  368. package/changelogs/v11.5.1.md +47 -0
  369. package/changelogs/v11.6.0.md +45 -0
  370. package/changelogs/v11.7.0.md +30 -0
  371. package/changelogs/v11.7.1.md +8 -0
  372. package/changelogs/v11.8.0.md +19 -0
  373. package/changelogs/v11.8.1.md +28 -0
  374. package/changelogs/v11.8.2.md +22 -0
  375. package/changelogs/v11.8.3.md +22 -0
  376. package/changelogs/v11.9.0.md +17 -0
  377. package/changelogs/v11.9.1.md +8 -0
  378. package/changelogs/v2.0.0-alpha.1.md +42 -0
  379. package/changelogs/v2.0.0-alpha.10.md +13 -0
  380. package/changelogs/v2.0.0-alpha.11.md +14 -0
  381. package/changelogs/v2.0.0-alpha.12.md +16 -0
  382. package/changelogs/v2.0.0-alpha.2.md +14 -0
  383. package/changelogs/v2.0.0-alpha.3.md +17 -0
  384. package/changelogs/v2.0.0-alpha.4.md +17 -0
  385. package/changelogs/v2.0.0-alpha.7.md +18 -0
  386. package/changelogs/v2.0.0-alpha.8.md +11 -0
  387. package/changelogs/v2.0.0-alpha.9.md +12 -0
  388. package/changelogs/v2.0.0.md +35 -0
  389. package/changelogs/v2.1.0.md +22 -0
  390. package/changelogs/v2.1.1.md +25 -0
  391. package/changelogs/v2.1.2.md +21 -0
  392. package/changelogs/v2.3.2.md +19 -0
  393. package/changelogs/v2.3.3.md +16 -0
  394. package/changelogs/v2.3.4.md +16 -0
  395. package/changelogs/v2.3.5.md +21 -0
  396. package/changelogs/v2.4.0.md +29 -0
  397. package/changelogs/v2.5.0.md +26 -0
  398. package/changelogs/v2.6.0.md +26 -0
  399. package/changelogs/v3.0.0.md +17 -0
  400. package/changelogs/v4.0.0.md +19 -0
  401. package/changelogs/v4.1.0.md +19 -0
  402. package/changelogs/v4.3.0.md +31 -0
  403. package/changelogs/v5.0.0-alpha.1.md +35 -0
  404. package/changelogs/v5.0.0-alpha.2.md +22 -0
  405. package/changelogs/v5.1.0.md +42 -0
  406. package/changelogs/v5.2.0.md +18 -0
  407. package/changelogs/v5.3.0.md +14 -0
  408. package/changelogs/v5.4.0.md +28 -0
  409. package/changelogs/v5.5.0.md +11 -0
  410. package/changelogs/v5.6.0.md +11 -0
  411. package/changelogs/v5.7.0.md +12 -0
  412. package/changelogs/v5.8.0.md +12 -0
  413. package/changelogs/v5.9.0.md +11 -0
  414. package/changelogs/v6.0.0-alpha.md +45 -0
  415. package/changelogs/v6.1.0-alpha.md +29 -0
  416. package/changelogs/v6.2.0-alpha.md +30 -0
  417. package/changelogs/v6.2.0.md +21 -0
  418. package/changelogs/v6.3.0.md +14 -0
  419. package/changelogs/v6.4.0.md +13 -0
  420. package/changelogs/v6.5.0.md +13 -0
  421. package/changelogs/v6.6.0.md +12 -0
  422. package/changelogs/v6.7.0.md +12 -0
  423. package/changelogs/v7.0.0.md +13 -0
  424. package/changelogs/v8.0.0.md +14 -0
  425. package/changelogs/v8.1.0.md +13 -0
  426. package/changelogs/v8.2.0.md +12 -0
  427. package/changelogs/v8.2.1.md +11 -0
  428. package/changelogs/v9.0.0.md +20 -0
  429. package/docs/commands-reference.md +72 -4
  430. package/docs/faq.md +38 -1
  431. package/docs/getting-started.md +52 -12
  432. package/docs/sdk-reference.md +36 -3
  433. package/docs/troubleshooting.md +59 -1
  434. package/docs/user-guide.md +7 -4
  435. package/package.json +4 -3
@@ -142,7 +142,7 @@ High-fidelity behaviors ported from the Superpowers library and hardened for pro
142
142
 
143
143
  ---
144
144
 
145
- ## 11. Council, Verification & Intelligence (v10.0.3)
145
+ ## 11. Council, Verification & Intelligence (v11.9.0)
146
146
 
147
147
  New commands introduced in the "Council Awakens" release for multi-voice decision-making, verification rigor, and self-evolving agent behavior.
148
148
 
@@ -202,13 +202,12 @@ mindforge <command> [options]
202
202
 
203
203
  ## 🚀 Dynamic Workflow Library
204
204
 
205
- Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands. Each runs via Claude Code's `Workflow` tool with true parallel agent execution. 33 pre-built multi-agent workflows across 5 tiers.
205
+ Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands. Each runs via Claude Code's `Workflow` tool with true parallel agent execution. **35 pre-built multi-agent workflows** across 5 tiers.
206
206
 
207
207
  | Command | Tier | Description |
208
208
  | :--- | :--- | :--- |
209
- | `/mindforge:wf-catalog` | — | Browse all 33 workflows grouped by tier |
209
+ | `/mindforge:wf-catalog` | — | Browse all 35 workflows grouped by tier |
210
210
  | **Research tier** | | |
211
- | `/mindforge:wf-deep-research` | research | Fan-out web research with adversarial claim verification and cited synthesis |
212
211
  | `/mindforge:wf-competitive-analysis` | research | Multi-angle competitive research producing a SWOT and positioning summary |
213
212
  | `/mindforge:wf-tech-evaluation` | research | Scored technology evaluation across DX, performance, security, ecosystem, and community |
214
213
  | `/mindforge:wf-ai-model-eval` | research | 4-parallel model benchmark agents → scoring matrix → cost/performance recommendation |
@@ -227,6 +226,8 @@ Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands.
227
226
  | `/mindforge:wf-mutation-testing` | dev | Mutant generator → parallel kill-test agents → mutation score + survival report |
228
227
  | `/mindforge:wf-code-explainer` | dev | Structural map → domain extraction → architecture patterns → guided narrative tour for onboarding |
229
228
  | `/mindforge:wf-design-system-audit` | dev | 5 parallel dimension auditors (spacing/color/typography/icons/a11y) → consistency score |
229
+ | `/mindforge:wf-orchestrate-review` | dev | 4-lens parallel review (factual, domain, safety, style) coordinated as one panel → single merged verdict |
230
+ | `/mindforge:wf-verification-loop` | dev | Implementer vs. scorer loop — revises against a fixed metric each round until maxed or round cap hit |
230
231
  | **Ops tier** | | |
231
232
  | `/mindforge:wf-incident-response` | ops | Parallel investigation across logs, metrics, traces, and code → mitigation → RCA → postmortem |
232
233
  | `/mindforge:wf-release-prep` | ops | Automated release pipeline: tests → changelog → version bump → PR → announcement draft |
@@ -241,8 +242,75 @@ Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands.
241
242
  | `/mindforge:wf-documentation-gen` | intelligence | Parallel per-file doc generation → style normalization → publish-ready documentation |
242
243
  | `/mindforge:wf-api-migration` | intelligence | Breaking change detection → versioning strategy → migration guide → compatibility matrix |
243
244
  | `/mindforge:wf-data-pipeline-validate` | intelligence | Pipeline stage-by-stage validation → data quality gates → anomaly detection report |
245
+ | `/mindforge:wf-workflow-optimizer` | intelligence | Builder + scorer + optimizer roles — each round a separate agent proposes structural process changes, not just output tweaks |
244
246
  | **Beast tier** | | |
245
247
  | `/mindforge:wf-security-hardening` | beast | 5-angle OWASP parallel scout → 3-vote adversarial verification → threat model + remediation roadmap |
246
248
  | `/mindforge:wf-accessibility-audit` | beast | WCAG 2.2 parallel per-criterion audit → 3-vote adversarial verify failures → remediation spec |
247
249
  | `/mindforge:wf-security-threat-model` | beast | Asset inventory → STRIDE threat enumeration → parallel mitigations → CVSS-style score matrix |
248
250
 
251
+ ---
252
+
253
+ ## Dynamic Workflow Library (35 workflows)
254
+
255
+ All workflow commands follow the pattern `/mindforge:wf-<name>`.
256
+
257
+ Invoke via CLI:
258
+ ```bash
259
+ node bin/mindforge-cli.js workflow list # browse all 35
260
+ node bin/mindforge-cli.js workflow info <name> # phases + description
261
+ ```
262
+
263
+ ### Research Tier (5 workflows)
264
+ | Command | Description |
265
+ |---------|-------------|
266
+ | `/mindforge:wf-competitive-analysis` | SWOT and positioning from 5 parallel research angles |
267
+ | `/mindforge:wf-tech-evaluation` | Scored technology evaluation across 5 dimensions |
268
+ | `/mindforge:wf-ai-model-eval` | Benchmark AI models → scoring matrix → recommendation |
269
+ | `/mindforge:wf-ux-heuristic-audit` | 10 Nielsen heuristics parallel audit → fix brief |
270
+ | `/mindforge:wf-competitive-teardown` | 5 competitor angles → positioning report |
271
+
272
+ ### Dev Tier (14 workflows)
273
+ | Command | Description |
274
+ |---------|-------------|
275
+ | `/mindforge:wf-code-audit` | Parallel security + quality + performance audit |
276
+ | `/mindforge:wf-feature-planner` | Brief → PRD → architecture → user stories |
277
+ | `/mindforge:wf-pr-review` | 4-dimensional parallel PR review → verdict |
278
+ | `/mindforge:wf-tdd-sprint` | Strict Red-Green-Refactor TDD loop |
279
+ | `/mindforge:wf-refactor-plan` | Technical debt scan → risk-sorted refactor plan |
280
+ | `/mindforge:wf-test-coverage-gap` | Per-module coverage analysis → test-writing plan |
281
+ | `/mindforge:wf-api-contract-test` | Spec vs impl Writer/Reviewer → violation report |
282
+ | `/mindforge:wf-debug-detective` | 4-hypothesis parallel investigation → scientific RCA |
283
+ | `/mindforge:wf-writer-reviewer` | Implement → fresh context review → verdict |
284
+ | `/mindforge:wf-mutation-testing` | Mutant generator → parallel kill-test → score |
285
+ | `/mindforge:wf-code-explainer` | Structure → domain → architecture → narrative tour |
286
+ | `/mindforge:wf-design-system-audit` | 5-dimension parallel audit → consistency score |
287
+ | `/mindforge:wf-orchestrate-review` | 4-lens panel (factual/domain/safety/style) → merged verdict |
288
+ | `/mindforge:wf-verification-loop` | Implementer vs. scorer loop → re-attempts until score maxed |
289
+
290
+ ### Ops Tier (6 workflows)
291
+ | Command | Description |
292
+ |---------|-------------|
293
+ | `/mindforge:wf-incident-response` | Parallel investigation → RCA → postmortem |
294
+ | `/mindforge:wf-release-prep` | Tests → changelog → version bump → PR |
295
+ | `/mindforge:wf-dependency-health` | CVE + license + staleness audit → risk matrix |
296
+ | `/mindforge:wf-database-migration` | Schema diff → risk → scripts → runbook |
297
+ | `/mindforge:wf-multi-repo-sync` | Per-repo audit → divergence map → sync plan |
298
+ | `/mindforge:wf-cost-analysis` | Infra/API/query/bundle cost agents → ROI plan |
299
+
300
+ ### Intelligence Tier (7 workflows)
301
+ | Command | Description |
302
+ |---------|-------------|
303
+ | `/mindforge:wf-onboard-codebase` | Map → domain → architecture → guided tour |
304
+ | `/mindforge:wf-perf-optimize` | Profile → bottleneck hunt → prioritized fix plan |
305
+ | `/mindforge:wf-architecture-modernization` | Legacy map → 3 designs → migration roadmap |
306
+ | `/mindforge:wf-documentation-gen` | Parallel doc gen → normalize → publish-ready |
307
+ | `/mindforge:wf-api-migration` | Breaking change detection → guide → compat matrix |
308
+ | `/mindforge:wf-data-pipeline-validate` | Stage-by-stage validation → quality gates |
309
+ | `/mindforge:wf-workflow-optimizer` | Builder + scorer + optimizer → revises the process itself, not just outputs |
310
+
311
+ ### Beast Tier (3 workflows — 5 phases, 8+ agents, adversarial 3-vote verification)
312
+ | Command | Description |
313
+ |---------|-------------|
314
+ | `/mindforge:wf-security-hardening` | 5-angle OWASP scout → 3-vote verify → STRIDE → roadmap |
315
+ | `/mindforge:wf-accessibility-audit` | WCAG 2.2 per-criterion → 3-vote verify → remediation spec |
316
+ | `/mindforge:wf-security-threat-model` | Asset inventory → STRIDE x6 → mitigations → CVSS matrix |
package/docs/faq.md CHANGED
@@ -1,4 +1,4 @@
1
- # MindForge FAQ (v1.0.0)
1
+ # MindForge FAQ (v11.9.0)
2
2
 
3
3
  ## Is MindForge tied to Claude only?
4
4
  No. MindForge supports Claude Code and Antigravity. Install with `--claude`,
@@ -36,3 +36,40 @@ Plugins are preferred for sharing and versioning.
36
36
  /mindforge:update
37
37
  /mindforge:update --apply
38
38
  ```
39
+
40
+ ## Dynamic Workflows
41
+
42
+ **Q: How many workflows does MindForge v11.9.0 include?**
43
+ 35 pre-built multi-agent workflows across 5 tiers: Research (5), Dev (14), Ops (6), Intelligence (7), Beast (3).
44
+
45
+ **Q: How do I run a workflow?**
46
+ Via Claude Code slash command: `/mindforge:wf-code-audit`
47
+ Via CLI: `node bin/mindforge-cli.js workflow list` to browse, then `workflow info <name>` for details.
48
+
49
+ **Q: What is the Beast tier?**
50
+ Beast tier workflows run 5 phases with 8+ concurrent agents and adversarial 3-vote verification. Included: `security-hardening`, `accessibility-audit`, `security-threat-model`.
51
+
52
+ **Q: Why are there only 35 workflows when some docs say 33?**
53
+ The `deep-research` workflow was removed before the v11.8.0 release (the superpowers built-in `/deep-research` covers this better). The correct count is 35.
54
+
55
+ ## Version & Stability
56
+
57
+ **Q: What version is current?**
58
+ v11.9.0 — verify with `node bin/mindforge-cli.js --version`
59
+
60
+ **Q: Is v11.9.0 production-stable?**
61
+ Yes. The IQ200 deep-audit (258 discrete checks across 14 dimensions) shows 258/258 passing. 0 CVEs, 0 test failures, 0 ESLint errors, 0 TypeScript errors.
62
+
63
+ **Q: What npm dist-tags point to v11.9.0?**
64
+ Both `latest` and `stable`: `npx mindforge-cc@stable` or `npx mindforge-cc@latest`
65
+
66
+ ## Known Limitations
67
+
68
+ **Q: Why does `spawn architect` exit with an error?**
69
+ Spawn dispatch is not yet implemented in v11.9.0. Use `/mindforge:auto` or `/mindforge:next` from Claude Code instead.
70
+
71
+ **Q: Why does ZTAI show a Tier-3 warning?**
72
+ Tier-3 trust uses in-process key simulation in v11.9.0 — this is intentional and safe. `SECURITY_TIER_3_SIMULATED = true` is the documented v11.x behavior. Hardware TPM/HSM is planned for v12.x.
73
+
74
+ **Q: What is the test coverage?**
75
+ 95/97 tests passing (0 failures, 2 permanently env-skipped). Line coverage ~66% — gaps are in `bin/source-loader.js` and `scripts/ci/validate-assets.js`. Target is 80% for v11.9.0.
@@ -1,11 +1,12 @@
1
- # MindForge — Getting Started (v11.8.0)
1
+ # MindForge — Getting Started (v11.9.0)
2
2
 
3
3
  This guide gets you from zero to a working MindForge project in under five minutes.
4
4
 
5
5
  ## Prerequisites
6
6
 
7
- - **Node.js 18+** (LTS recommended)
8
- - No native build tools required MindForge uses sql.js (pure WASM) for all database operations
7
+ - **Node.js** >= 18.0.0 (`node --version` to check)
8
+ - **Claude Code** CLI installed and authenticated (`claude --version`)
9
+ - Git (recommended for project-level install)
9
10
 
10
11
  ## Install
11
12
 
@@ -28,6 +29,12 @@ npx mindforge-cc@latest --claude --local
28
29
 
29
30
  After installation, the `mindforge` CLI command is available for runtime operations (health checks, security scans, headless execution, etc.).
30
31
 
32
+ **Global install** (system-wide `/mindforge` commands for your primary AI coding runtime):
33
+
34
+ ```bash
35
+ npm install -g mindforge-cc@latest
36
+ ```
37
+
31
38
  ### 2. Claude Code plugin (self-hosted marketplace)
32
39
 
33
40
  Install MindForge as a Claude Code plugin from its marketplace:
@@ -37,6 +44,8 @@ Install MindForge as a Claude Code plugin from its marketplace:
37
44
  /plugin install mindforge@mindforge
38
45
  ```
39
46
 
47
+ Prefer just a slice (e.g. Python agents)? Install a focused pack like `mindforge-lang@mindforge` instead. See [docs/plugin-installation.md](plugin-installation.md) for all 10 plugin packs, token-budget guidance, and team setup.
48
+
40
49
  ### 3. Standalone MCP server
41
50
 
42
51
  Run the MindForge MCP server (`mindforge-mcp-server`) over stdio — it exposes 7 tools (6 read-only plus 1 guarded write): `mindforge_health`, `mindforge_status`, `mindforge_memory_query`, `mindforge_memory_stats`, `mindforge_memory_find_related`, `mindforge_audit_log`, and `mindforge_memory_remember`.
@@ -45,7 +54,7 @@ Run the MindForge MCP server (`mindforge-mcp-server`) over stdio — it exposes
45
54
  claude mcp add mindforge -- npx -y mindforge-mcp-server
46
55
  ```
47
56
 
48
- This server is also published to the [MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.sairam0424/mindforge` (currently `11.5.1`, marked latest).
57
+ This server is also published to the [MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.sairam0424/mindforge` (currently `11.9.0`, marked latest).
49
58
 
50
59
  ### 4. Homebrew
51
60
 
@@ -61,17 +70,48 @@ To build on top of MindForge programmatically, install the TypeScript SDK:
61
70
  npm i mindforge-sdk
62
71
  ```
63
72
 
64
- ## Dynamic Workflow Library
73
+ ## Configuration & Runtimes
74
+
75
+ MindForge adapts to your existing engineering environment via runtime flags:
76
+
77
+ | Runtime | Global Command | Local Setup |
78
+ | :--- | :--- | :--- |
79
+ | **Claude Code** | `mindforge-cc --claude --global` | `mindforge-cc --claude --local` |
80
+ | **Antigravity** | `mindforge-cc --antigravity --global` | `mindforge-cc --antigravity --local` |
81
+ | **Cursor** | `mindforge-cc --cursor --global` | `mindforge-cc --cursor --local` |
82
+ | **GitHub Copilot** | `mindforge-cc --copilot --global` | `mindforge-cc --copilot --local` |
83
+ | **Gemini CLI** | `mindforge-cc --gemini --global` | `mindforge-cc --gemini --local` |
65
84
 
66
- MindForge ships 33 pre-built multi-agent workflows across 5 tiers, triggerable via `/mindforge:wf-*` commands:
85
+ ### Advanced Setup Options
86
+ - **Combined Runtimes**: `mindforge-cc --runtime claude,cursor --local`
87
+ - **With Utilities**: `mindforge-cc --local --with-utils` (Installs specialized bin scripts)
88
+ - **Minimalist**: `mindforge-cc --local --minimal` (Only basic protocols, no persona library)
89
+
90
+ ## Dynamic Workflow Library (35 workflows across 5 tiers)
91
+
92
+
93
+ | Tier | Count | Workflows |
94
+ |------|-------|-----------|
95
+ | Research | 5 | competitive-analysis, tech-evaluation, ai-model-eval, ux-heuristic-audit, competitive-teardown |
96
+ | Dev | 14 | code-audit, feature-planner, pr-review, tdd-sprint, refactor-plan, test-coverage-gap, api-contract-test, debug-detective, writer-reviewer, mutation-testing, code-explainer, design-system-audit, orchestrate-review, verification-loop |
97
+ | Ops | 6 | incident-response, release-prep, dependency-health, database-migration, multi-repo-sync, cost-analysis |
98
+ | Intelligence | 7 | onboard-codebase, perf-optimize, architecture-modernization, documentation-gen, api-migration, data-pipeline-validate, workflow-optimizer |
99
+ | Beast | 3 | security-hardening, accessibility-audit, security-threat-model |
100
+
101
+ **Run any workflow:**
102
+ ```bash
103
+ node bin/mindforge-cli.js workflow list # browse all 32
104
+ node bin/mindforge-cli.js workflow info code-audit # details + phases
105
+ ```
106
+ Or use slash commands: `/mindforge:wf-code-audit`
67
107
 
68
- - **Beast** Compound adversarial workflows (security-hardening, accessibility-audit, security-threat-model)
69
- - **Intelligence** — Deep analysis (architecture-modernization, documentation-gen, api-migration, data-pipeline-validate)
70
- - **Ops** — Infrastructure (incident-response, release-prep, dependency-health, database-migration, multi-repo-sync, cost-analysis)
71
- - **Dev** — Coding assistant (code-audit, feature-planner, pr-review, tdd-sprint, refactor-plan + 7 more)
72
- - **Research** — Research & analysis (deep-research, competitive-analysis, tech-evaluation + 3 more)
108
+ ## Your First 5 Minutes with MindForge
73
109
 
74
- Browse with `/mindforge:wf-catalog`.
110
+ 1. **Verify install:** `node bin/mindforge-cli.js health`
111
+ 2. **Check version:** `node bin/mindforge-cli.js --version` (should print `11.9.0`)
112
+ 3. **List workflows:** `node bin/mindforge-cli.js workflow list`
113
+ 4. **Run first slash command:** Open Claude Code → `/mindforge:status`
114
+ 5. **Onboard your codebase:** Open Claude Code → `/mindforge:wf-onboard-codebase`
75
115
 
76
116
  ## Initialise Your Project
77
117
 
@@ -14,7 +14,24 @@ import {
14
14
  } from '@mindforge/sdk';
15
15
  ```
16
16
 
17
- Current SDK version: `11.8.1`
17
+ Current SDK version: `11.9.0`
18
+
19
+ ---
20
+
21
+ ## SDK Exports (v11.9.0)
22
+
23
+ ```javascript
24
+ const {
25
+ MindForgeClient, // Main API client
26
+ MindForgeEventStream, // SSE event stream
27
+ WebSocketEventStream, // WebSocket stream
28
+ commands, // Command registry
29
+ batch, // Batch execution
30
+ MindForgeMemory, // Memory interface
31
+ VERSION // '11.9.0'
32
+ } = require('mindforge-sdk');
33
+ // or: import { MindForgeClient, VERSION } from 'mindforge-sdk';
34
+ ```
18
35
 
19
36
  ---
20
37
 
@@ -97,13 +114,13 @@ Returns the absolute path to the project's `celestial.db` SQLite database file.
97
114
 
98
115
  Imports a session snapshot captured from a browser environment into the local session store.
99
116
 
100
- > **[NOT IMPLEMENTED — v1.0]** This method always throws. Check `sessionManager.capabilities.importFromBrowser === false` before calling. Use `saveSession`/`loadSession` instead.
117
+ > **[NOT IMPLEMENTED — v11.x]** This method always throws. Planned for a future release. Use `saveSession`/`loadSession` instead. Check `capabilities.importFromBrowser === false` before calling.
101
118
 
102
119
  #### `resolveRemoteNode(nodeId: string): Promise<unknown>`
103
120
 
104
121
  Resolves context for a node residing on a remote EIS (Edge Intelligence Shard) instance.
105
122
 
106
- > **[NOT IMPLEMENTED — v1.0]** `resolveRemoteNode(nodeId)` always throws. Cross-node context resolution is local-only in v1.0. Planned for v1.1.
123
+ > **[NOT IMPLEMENTED — v11.x]** This method always throws. Planned for a future release. Cross-node context resolution is local-only in v11.x. Planned for v12.x.
107
124
 
108
125
  ---
109
126
 
@@ -387,3 +404,19 @@ count, deprecation state, and SHA-256 checksum.
387
404
  - CORS is restricted to localhost origins (exact match, no wildcards).
388
405
  - Do not expose SDK endpoints or the SSE server to public networks.
389
406
  - API keys passed via `MindForgeConfig` are held in memory only — never written to disk.
407
+
408
+ ---
409
+
410
+ ## TypeScript
411
+
412
+ The SDK includes full TypeScript type definitions. Build the SDK:
413
+ ```bash
414
+ cd sdk && npm install && npm run build
415
+ ```
416
+ `@types/node` is installed as a dev dependency. The SDK achieves **0 typecheck errors** in v11.9.0.
417
+
418
+ ## Installation
419
+ ```bash
420
+ npm install mindforge-sdk@11.8.0
421
+ # or: npx mindforge-cc@stable # installs SDK as part of the framework
422
+ ```
@@ -1,4 +1,4 @@
1
- # MindForge Troubleshooting (v11.3.1)
1
+ # MindForge Troubleshooting (v11.9.0)
2
2
 
3
3
  This page lists common issues and fast fixes. If you get stuck, start with
4
4
  `/mindforge:health`.
@@ -146,3 +146,61 @@ Browser cookie import from native browser profiles is not implemented in v1.0. U
146
146
 
147
147
  ## Tests fail when run from a parent directory
148
148
  All tests must be run from the MindForge project root: `cd /path/to/MindForge && npm test`. Running from the parent workspace will produce false failures.
149
+
150
+ ---
151
+
152
+ ## Agent spawn returns immediately with no action
153
+
154
+ **Symptom:** `node bin/spawn-agent.js spawn architect` exits 1 with "Agent spawn dispatch not implemented in v1.0."
155
+
156
+ **Cause:** Spawn dispatch is a v1.0 stub — real agent dispatch requires Claude Code slash commands.
157
+
158
+ **Fix:** Use `/mindforge:auto` or `/mindforge:next` from Claude Code instead.
159
+
160
+ ---
161
+
162
+ ## `importFromBrowser` crashes with "not implemented"
163
+
164
+ **Symptom:** Calling `importFromBrowser(source)` throws unconditionally.
165
+
166
+ **Cause:** Native browser cookie DB import was removed when `better-sqlite3` was replaced with sql.js/WASM.
167
+
168
+ **Fix:** Use `saveSession`/`loadSession` instead. Check `sessionManager.capabilities.importFromBrowser` (returns `false`) before calling.
169
+
170
+ ---
171
+
172
+ ## Tests fail when run from parent directory
173
+
174
+ **Symptom:** ~52 false test failures when running `npm test` from `Not-Humans-World/` parent.
175
+
176
+ **Cause:** Test files use relative paths anchored to the MindForge project root.
177
+
178
+ **Fix:** Always run from the MindForge root: `cd /path/to/MindForge && npm test`
179
+
180
+ ---
181
+
182
+ ## `node bin/mindforge-cli.js validate-config` prints "Unknown command"
183
+
184
+ **Symptom:** The CLI does not recognize `validate-config` as a subcommand.
185
+
186
+ **Cause:** `validate-config` is exposed as a standalone binary, not a CLI subcommand.
187
+
188
+ **Fix:** Run `node bin/validate-config.js` directly.
189
+
190
+ ---
191
+
192
+ ## ZTAI Tier-3 warning appears unexpectedly
193
+
194
+ **Symptom:** `[ZTAI] WARNING: Tier-3 trust using simulated in-process key storage` appears on commands like `pr-review`.
195
+
196
+ **Cause:** Tier-3 trust uses in-process key simulation in v11.9.0. This is expected and safe — `SECURITY_TIER_3_SIMULATED = true` is the documented behavior.
197
+
198
+ **Fix:** No action required. See `SECURITY.md` for full disclosure. This is not a security vulnerability.
199
+
200
+ ---
201
+
202
+ ## `node bin/mindforge-cli.js --version` exits 1 (older installs)
203
+
204
+ **Symptom:** `--version` flag reports "Unknown command" on installs older than v11.9.0.
205
+
206
+ **Fix:** Upgrade to v11.9.0: `npx mindforge-cc@latest install`
@@ -1,7 +1,9 @@
1
- # MindForge User Guide (v11.8.0)
1
+ # MindForge User Guide (v11.9.0)
2
2
 
3
3
  This guide gets you from install to productive, with the minimum needed to run MindForge in a real project.
4
4
 
5
+ > **v11.9.0 Stats:** 35 workflows · 221 slash commands · 232 engine skills · 216 personas · 0 CVEs · 258/258 IQ200 checks passing
6
+
5
7
  ## Prerequisites
6
8
 
7
9
  - **Node.js 18+** (LTS recommended)
@@ -42,9 +44,10 @@ mindforge health # Verify project integrity
42
44
  mindforge security-scan # Run security checks
43
45
  mindforge headless # Run agent in non-interactive mode
44
46
  mindforge --verbose ... # Enable verbose output for debugging
47
+ mindforge --version # Print installed version (e.g. 11.9.0) and exit 0
45
48
  ```
46
49
 
47
- Use `--verbose` (or `-v`) on any command for detailed diagnostic output.
50
+ Use `--verbose` (or `-v`) on any command for detailed diagnostic output. Use `--version` (or `-V`) to print the installed version and exit.
48
51
 
49
52
  ---
50
53
 
@@ -93,7 +96,7 @@ MindForge uses a unified 4-pillar workflow, hardened by the **Neural Protocol Me
93
96
 
94
97
  ### Dynamic Workflow Library
95
98
 
96
- MindForge ships **33 pre-built workflow pipelines** across **219 commands**, organized into **5 tiers**:
99
+ MindForge ships **35 pre-built workflow pipelines** across **221 commands**, organized into **5 tiers**:
97
100
 
98
101
  | Tier | Description |
99
102
  |------|-------------|
@@ -114,7 +117,7 @@ Discover all available workflows:
114
117
 
115
118
  ## 6. High-Performance Personas
116
119
 
117
- MindForge features 108 specialized personas. Each persona is optimized for a specific stage of the lifecycle.
120
+ MindForge features 211 specialized personas. Each persona is optimized for a specific stage of the lifecycle.
118
121
 
119
122
  - **Neural Orchestrator**: Activates and manages the advanced protocol layer.
120
123
  - **Brainstormer**: Expert in deep requirements discovery and behavioral ideation.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mindforge-cc",
3
- "version": "11.8.3",
3
+ "version": "11.9.1",
4
4
  "description": "MindForge \u2014 Sovereign Agentic Intelligence Framework. Sovereign Stability: Production-Hardened Agentic Intelligence (v11)",
5
5
  "bin": {
6
6
  "mindforge-cc": "bin/install.js",
@@ -48,6 +48,7 @@
48
48
  "docs/Templates/",
49
49
  "examples/",
50
50
  "CHANGELOG.md",
51
+ "changelogs/",
51
52
  "LICENSE",
52
53
  "MINDFORGE.md",
53
54
  "README.md",
@@ -90,11 +91,11 @@
90
91
  "homepage": "https://github.com/sairam0424/MindForge#readme",
91
92
  "devDependencies": {
92
93
  "@eslint/js": "^9.0.0",
93
- "@types/node": "^20.0.0",
94
+ "@types/node": "^26.0.0",
94
95
  "c8": "^10.0.0",
95
96
  "commitizen": "^4.2.4",
96
97
  "cz-conventional-changelog": "3.3.0",
97
- "eslint": "^9.0.0",
98
+ "eslint": "^10.5.0",
98
99
  "globals": "^15.0.0",
99
100
  "husky": "9.1.7",
100
101
  "playwright": "^1.40.0"