mindforge-cc 11.8.2 → 11.9.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 (361) hide show
  1. package/.agent/mindforge/wf-orchestrate-review.md +35 -0
  2. package/.agent/mindforge/wf-verification-loop.md +45 -0
  3. package/.agent/mindforge/wf-workflow-optimizer.md +51 -0
  4. package/.agent/skills/article-illustrator/SKILL.md +7 -7
  5. package/.agent/skills/arxiv/SKILL.md +6 -6
  6. package/.agent/skills/code-wiki/SKILL.md +11 -11
  7. package/.agent/skills/concept-diagrams/SKILL.md +6 -6
  8. package/.agent/skills/concept-diagrams/examples/apartment-floor-plan-conversion.md +244 -0
  9. package/.agent/skills/concept-diagrams/examples/automated-password-reset-flow.md +276 -0
  10. package/.agent/skills/concept-diagrams/examples/autonomous-llm-research-agent-flow.md +240 -0
  11. package/.agent/skills/concept-diagrams/examples/banana-journey-tree-to-smoothie.md +161 -0
  12. package/.agent/skills/concept-diagrams/examples/commercial-aircraft-structure.md +209 -0
  13. package/.agent/skills/concept-diagrams/examples/cpu-ooo-microarchitecture.md +236 -0
  14. package/.agent/skills/concept-diagrams/examples/electricity-grid-flow.md +182 -0
  15. package/.agent/skills/concept-diagrams/examples/feature-film-production-pipeline.md +172 -0
  16. package/.agent/skills/concept-diagrams/examples/hospital-emergency-department-flow.md +165 -0
  17. package/.agent/skills/concept-diagrams/examples/ml-benchmark-grouped-bar-chart.md +114 -0
  18. package/.agent/skills/concept-diagrams/examples/place-order-uml-sequence.md +325 -0
  19. package/.agent/skills/concept-diagrams/examples/smart-city-infrastructure.md +173 -0
  20. package/.agent/skills/concept-diagrams/examples/smartphone-layer-anatomy.md +154 -0
  21. package/.agent/skills/concept-diagrams/examples/sn2-reaction-mechanism.md +247 -0
  22. package/.agent/skills/concept-diagrams/examples/wind-turbine-structure.md +338 -0
  23. package/.agent/skills/concept-diagrams/templates/template.html +174 -0
  24. package/.agent/skills/domain-intel/SKILL.md +7 -7
  25. package/.agent/skills/duckduckgo-search/SKILL.md +17 -17
  26. package/.agent/skills/github-auth/scripts/gh-env.sh +66 -0
  27. package/.agent/skills/github-code-review/SKILL.md +9 -9
  28. package/.agent/skills/github-pr-workflow/SKILL.md +3 -3
  29. package/.agent/skills/godmode/SKILL.md +8 -8
  30. package/.agent/skills/jupyter-live-kernel/SKILL.md +3 -3
  31. package/.agent/skills/kanban-orchestrator/SKILL.md +10 -10
  32. package/.agent/skills/kanban-worker/SKILL.md +6 -6
  33. package/.agent/skills/llm-wiki/SKILL.md +7 -7
  34. package/.agent/skills/mindforge-autonomous/SKILL.md +1 -1
  35. package/.agent/skills/mindforge-complete-milestone/SKILL.md +1 -1
  36. package/.agent/skills/mindforge-discuss-phase/SKILL.md +1 -1
  37. package/.agent/skills/mindforge-do/SKILL.md +1 -1
  38. package/.agent/skills/mindforge-execute-phase/SKILL.md +1 -1
  39. package/.agent/skills/mindforge-list-workspaces/SKILL.md +1 -1
  40. package/.agent/skills/mindforge-manager/SKILL.md +1 -1
  41. package/.agent/skills/mindforge-neural-orchestrator/SKILL.md +1 -1
  42. package/.agent/skills/mindforge-new-milestone/SKILL.md +4 -4
  43. package/.agent/skills/mindforge-new-project/SKILL.md +4 -4
  44. package/.agent/skills/mindforge-new-workspace/SKILL.md +1 -1
  45. package/.agent/skills/mindforge-note/SKILL.md +1 -1
  46. package/.agent/skills/mindforge-plan-phase/SKILL.md +1 -1
  47. package/.agent/skills/mindforge-profile-user/SKILL.md +1 -1
  48. package/.agent/skills/mindforge-remove-workspace/SKILL.md +1 -1
  49. package/.agent/skills/mindforge-research-phase/SKILL.md +1 -1
  50. package/.agent/skills/mindforge-ui-phase/SKILL.md +1 -1
  51. package/.agent/skills/mindforge-ui-review/SKILL.md +1 -1
  52. package/.agent/skills/mindforge-verify-work/SKILL.md +1 -1
  53. package/.agent/skills/mindforge-workspace-isolated/SKILL.md +1 -1
  54. package/.agent/skills/node-inspect-debugger/SKILL.md +1 -1
  55. package/.agent/skills/obsidian/SKILL.md +15 -15
  56. package/.agent/skills/osint-investigation/SKILL.md +3 -2
  57. package/.agent/skills/osint-investigation/references/sources/courtlistener.md +98 -0
  58. package/.agent/skills/osint-investigation/references/sources/gdelt.md +104 -0
  59. package/.agent/skills/osint-investigation/references/sources/icij-offshore.md +104 -0
  60. package/.agent/skills/osint-investigation/references/sources/nyc-acris.md +90 -0
  61. package/.agent/skills/osint-investigation/references/sources/ofac-sdn.md +92 -0
  62. package/.agent/skills/osint-investigation/references/sources/opencorporates.md +103 -0
  63. package/.agent/skills/osint-investigation/references/sources/sec-edgar.md +83 -0
  64. package/.agent/skills/osint-investigation/references/sources/senate-ld.md +89 -0
  65. package/.agent/skills/osint-investigation/references/sources/usaspending.md +97 -0
  66. package/.agent/skills/osint-investigation/references/sources/wayback.md +93 -0
  67. package/.agent/skills/osint-investigation/references/sources/wikipedia.md +107 -0
  68. package/.agent/skills/osint-investigation/scripts/_http.py +82 -0
  69. package/.agent/skills/osint-investigation/scripts/_normalize.py +67 -0
  70. package/.agent/skills/osint-investigation/scripts/build_findings.py +221 -0
  71. package/.agent/skills/osint-investigation/scripts/entity_resolution.py +228 -0
  72. package/.agent/skills/osint-investigation/scripts/fetch_courtlistener.py +149 -0
  73. package/.agent/skills/osint-investigation/scripts/fetch_gdelt.py +161 -0
  74. package/.agent/skills/osint-investigation/scripts/fetch_icij_offshore.py +234 -0
  75. package/.agent/skills/osint-investigation/scripts/fetch_nyc_acris.py +203 -0
  76. package/.agent/skills/osint-investigation/scripts/fetch_ofac_sdn.py +175 -0
  77. package/.agent/skills/osint-investigation/scripts/fetch_opencorporates.py +191 -0
  78. package/.agent/skills/osint-investigation/scripts/fetch_sec_edgar.py +184 -0
  79. package/.agent/skills/osint-investigation/scripts/fetch_senate_ld.py +146 -0
  80. package/.agent/skills/osint-investigation/scripts/fetch_usaspending.py +170 -0
  81. package/.agent/skills/osint-investigation/scripts/fetch_wayback.py +142 -0
  82. package/.agent/skills/osint-investigation/scripts/fetch_wikipedia.py +266 -0
  83. package/.agent/skills/osint-investigation/scripts/timing_analysis.py +252 -0
  84. package/.agent/skills/oss-forensics/SKILL.md +10 -9
  85. package/.agent/skills/oss-forensics/scripts/evidence-store.py +313 -0
  86. package/.agent/skills/parallel-cli/SKILL.md +2 -2
  87. package/.agent/skills/pinggy-tunnel/SKILL.md +3 -3
  88. package/.agent/skills/pixel-art/SKILL.md +2 -2
  89. package/.agent/skills/plan/SKILL.md +10 -10
  90. package/.agent/skills/requesting-code-review/SKILL.md +4 -6
  91. package/.agent/skills/research-paper-writing/SKILL.md +32 -32
  92. package/.agent/skills/rest-graphql-debug/SKILL.md +31 -32
  93. package/.agent/skills/s6-container-supervision/SKILL.md +1 -1
  94. package/.agent/skills/scrapling/SKILL.md +1 -1
  95. package/.agent/skills/sherlock/SKILL.md +1 -1
  96. package/.agent/skills/simplify-code/SKILL.md +5 -7
  97. package/.agent/skills/skill-authoring/SKILL.md +4 -4
  98. package/.agent/skills/spike/SKILL.md +11 -13
  99. package/.agent/skills/subagent-driven-development/SKILL.md +7 -11
  100. package/.agent/skills/systematic-debugging/SKILL.md +13 -14
  101. package/.agent/skills/test-driven-development/SKILL.md +6 -7
  102. package/.agent/skills/video-orchestrator/SKILL.md +1 -1
  103. package/.agent/skills/web-pentest/SKILL.md +7 -7
  104. package/.mindforge/config.json +3 -2
  105. package/.mindforge/dynamic-workflows/REGISTRY.md +4 -1
  106. package/.mindforge/dynamic-workflows/index.json +910 -840
  107. package/.mindforge/dynamic-workflows/scripts/accessibility-audit.js +88 -90
  108. package/.mindforge/dynamic-workflows/scripts/ai-model-eval.js +59 -61
  109. package/.mindforge/dynamic-workflows/scripts/api-contract-test.js +87 -85
  110. package/.mindforge/dynamic-workflows/scripts/api-migration.js +120 -122
  111. package/.mindforge/dynamic-workflows/scripts/architecture-modernization.js +84 -86
  112. package/.mindforge/dynamic-workflows/scripts/code-audit.js +75 -77
  113. package/.mindforge/dynamic-workflows/scripts/code-explainer.js +99 -101
  114. package/.mindforge/dynamic-workflows/scripts/competitive-analysis.js +62 -64
  115. package/.mindforge/dynamic-workflows/scripts/competitive-teardown.js +106 -108
  116. package/.mindforge/dynamic-workflows/scripts/cost-analysis.js +78 -80
  117. package/.mindforge/dynamic-workflows/scripts/data-pipeline-validate.js +47 -49
  118. package/.mindforge/dynamic-workflows/scripts/database-migration.js +85 -87
  119. package/.mindforge/dynamic-workflows/scripts/debug-detective.js +97 -99
  120. package/.mindforge/dynamic-workflows/scripts/dependency-health.js +81 -83
  121. package/.mindforge/dynamic-workflows/scripts/design-system-audit.js +84 -86
  122. package/.mindforge/dynamic-workflows/scripts/documentation-gen.js +65 -67
  123. package/.mindforge/dynamic-workflows/scripts/feature-planner.js +78 -80
  124. package/.mindforge/dynamic-workflows/scripts/incident-response.js +81 -83
  125. package/.mindforge/dynamic-workflows/scripts/multi-repo-sync.js +49 -51
  126. package/.mindforge/dynamic-workflows/scripts/mutation-testing.js +113 -115
  127. package/.mindforge/dynamic-workflows/scripts/onboard-codebase.js +79 -81
  128. package/.mindforge/dynamic-workflows/scripts/orchestrate-review.js +115 -0
  129. package/.mindforge/dynamic-workflows/scripts/perf-optimize.js +97 -99
  130. package/.mindforge/dynamic-workflows/scripts/pr-review.js +61 -63
  131. package/.mindforge/dynamic-workflows/scripts/refactor-plan.js +88 -90
  132. package/.mindforge/dynamic-workflows/scripts/release-prep.js +79 -81
  133. package/.mindforge/dynamic-workflows/scripts/security-hardening.js +117 -119
  134. package/.mindforge/dynamic-workflows/scripts/security-threat-model.js +119 -121
  135. package/.mindforge/dynamic-workflows/scripts/tdd-sprint.js +80 -82
  136. package/.mindforge/dynamic-workflows/scripts/tech-evaluation.js +50 -52
  137. package/.mindforge/dynamic-workflows/scripts/test-coverage-gap.js +68 -70
  138. package/.mindforge/dynamic-workflows/scripts/ux-heuristic-audit.js +89 -91
  139. package/.mindforge/dynamic-workflows/scripts/verification-loop.js +138 -0
  140. package/.mindforge/dynamic-workflows/scripts/workflow-optimizer.js +136 -0
  141. package/.mindforge/dynamic-workflows/scripts/writer-reviewer.js +63 -65
  142. package/.mindforge/memory/sync-manifest.json +1 -1
  143. package/.mindforge/personas/advisor-researcher.md +2 -2
  144. package/.mindforge/personas/api-load-tester.md +1 -1
  145. package/.mindforge/personas/authentication-architect.md +1 -1
  146. package/.mindforge/personas/backup-recovery-specialist.md +1 -1
  147. package/.mindforge/personas/build-optimizer.md +1 -1
  148. package/.mindforge/personas/caching-strategist.md +1 -1
  149. package/.mindforge/personas/chaos-engineer.md +1 -1
  150. package/.mindforge/personas/compliance-auditor.md +1 -1
  151. package/.mindforge/personas/config-management-expert.md +1 -1
  152. package/.mindforge/personas/coverage-specialist.md +1 -1
  153. package/.mindforge/personas/debug-specialist.md +2 -2
  154. package/.mindforge/personas/debugger.md +2 -2
  155. package/.mindforge/personas/dependency-auditor.md +1 -1
  156. package/.mindforge/personas/developer.md +1 -1
  157. package/.mindforge/personas/devops-engineer.md +1 -1
  158. package/.mindforge/personas/executor.md +1 -1
  159. package/.mindforge/personas/go-specialist.md +1 -1
  160. package/.mindforge/personas/incident-commander.md +1 -1
  161. package/.mindforge/personas/java-specialist.md +1 -1
  162. package/.mindforge/personas/kubernetes-debugger.md +1 -1
  163. package/.mindforge/personas/logging-architect.md +1 -1
  164. package/.mindforge/personas/mf-planner.md +1 -1
  165. package/.mindforge/personas/mf-researcher.md +1 -1
  166. package/.mindforge/personas/mf-reviewer.md +1 -1
  167. package/.mindforge/personas/nyquist-auditor.md +1 -1
  168. package/.mindforge/personas/observability-engineer.md +1 -1
  169. package/.mindforge/personas/performance-optimizer.md +1 -1
  170. package/.mindforge/personas/phase-researcher.md +5 -5
  171. package/.mindforge/personas/planner.md +1 -1
  172. package/.mindforge/personas/project-researcher.md +2 -2
  173. package/.mindforge/personas/python-specialist.md +1 -1
  174. package/.mindforge/personas/qa-engineer.md +1 -1
  175. package/.mindforge/personas/release-manager.md +1 -1
  176. package/.mindforge/personas/research-agent.md +4 -4
  177. package/.mindforge/personas/roadmapper-extend.md +1 -1
  178. package/.mindforge/personas/rust-specialist.md +1 -1
  179. package/.mindforge/personas/security-reviewer.md +1 -1
  180. package/.mindforge/personas/tech-writer.md +1 -1
  181. package/.mindforge/personas/typescript-wizard.md +1 -1
  182. package/.mindforge/personas/ui-researcher.md +1 -1
  183. package/.mindforge/skills/accessibility/SKILL.md +3 -3
  184. package/.mindforge/skills/agent-architecture-audit/SKILL.md +11 -0
  185. package/.mindforge/skills/agent-loops/SKILL.md +1 -1
  186. package/.mindforge/skills/arxiv/SKILL.md +6 -6
  187. package/.mindforge/skills/arxiv/scripts/search_arxiv.py +114 -0
  188. package/.mindforge/skills/code-tour/SKILL.md +2 -2
  189. package/.mindforge/skills/code-wiki/SKILL.md +11 -11
  190. package/.mindforge/skills/code-wiki/templates/README.md +31 -0
  191. package/.mindforge/skills/code-wiki/templates/architecture.md +30 -0
  192. package/.mindforge/skills/code-wiki/templates/getting-started.md +47 -0
  193. package/.mindforge/skills/code-wiki/templates/module.md +38 -0
  194. package/.mindforge/skills/concept-diagrams/SKILL.md +6 -6
  195. package/.mindforge/skills/concept-diagrams/examples/apartment-floor-plan-conversion.md +244 -0
  196. package/.mindforge/skills/concept-diagrams/examples/automated-password-reset-flow.md +276 -0
  197. package/.mindforge/skills/concept-diagrams/examples/autonomous-llm-research-agent-flow.md +240 -0
  198. package/.mindforge/skills/concept-diagrams/examples/banana-journey-tree-to-smoothie.md +161 -0
  199. package/.mindforge/skills/concept-diagrams/examples/commercial-aircraft-structure.md +209 -0
  200. package/.mindforge/skills/concept-diagrams/examples/cpu-ooo-microarchitecture.md +236 -0
  201. package/.mindforge/skills/concept-diagrams/examples/electricity-grid-flow.md +182 -0
  202. package/.mindforge/skills/concept-diagrams/examples/feature-film-production-pipeline.md +172 -0
  203. package/.mindforge/skills/concept-diagrams/examples/hospital-emergency-department-flow.md +165 -0
  204. package/.mindforge/skills/concept-diagrams/examples/ml-benchmark-grouped-bar-chart.md +114 -0
  205. package/.mindforge/skills/concept-diagrams/examples/place-order-uml-sequence.md +325 -0
  206. package/.mindforge/skills/concept-diagrams/examples/smart-city-infrastructure.md +173 -0
  207. package/.mindforge/skills/concept-diagrams/examples/smartphone-layer-anatomy.md +154 -0
  208. package/.mindforge/skills/concept-diagrams/examples/sn2-reaction-mechanism.md +247 -0
  209. package/.mindforge/skills/concept-diagrams/examples/wind-turbine-structure.md +338 -0
  210. package/.mindforge/skills/concept-diagrams/references/dashboard-patterns.md +43 -0
  211. package/.mindforge/skills/concept-diagrams/references/infrastructure-patterns.md +144 -0
  212. package/.mindforge/skills/concept-diagrams/references/physical-shape-cookbook.md +42 -0
  213. package/.mindforge/skills/concept-diagrams/templates/template.html +174 -0
  214. package/.mindforge/skills/creative-ideation/references/full-prompt-library.md +110 -0
  215. package/.mindforge/skills/documentation/SKILL.md +1 -1
  216. package/.mindforge/skills/domain-intel/SKILL.md +7 -7
  217. package/.mindforge/skills/domain-intel/scripts/domain_intel.py +397 -0
  218. package/.mindforge/skills/duckduckgo-search/SKILL.md +17 -17
  219. package/.mindforge/skills/duckduckgo-search/scripts/duckduckgo.sh +28 -0
  220. package/.mindforge/skills/environment-management/SKILL.md +1 -1
  221. package/.mindforge/skills/github-code-review/SKILL.md +9 -9
  222. package/.mindforge/skills/github-code-review/references/review-output-template.md +74 -0
  223. package/.mindforge/skills/github-issues/templates/bug-report.md +35 -0
  224. package/.mindforge/skills/github-issues/templates/feature-request.md +31 -0
  225. package/.mindforge/skills/github-pr-workflow/SKILL.md +3 -3
  226. package/.mindforge/skills/github-pr-workflow/references/ci-troubleshooting.md +183 -0
  227. package/.mindforge/skills/github-pr-workflow/references/conventional-commits.md +71 -0
  228. package/.mindforge/skills/github-pr-workflow/templates/pr-body-bugfix.md +35 -0
  229. package/.mindforge/skills/github-pr-workflow/templates/pr-body-feature.md +33 -0
  230. package/.mindforge/skills/incident-response/SKILL.md +1 -1
  231. package/.mindforge/skills/jupyter-live-kernel/SKILL.md +3 -3
  232. package/.mindforge/skills/kanban-orchestrator/SKILL.md +10 -10
  233. package/.mindforge/skills/kanban-worker/SKILL.md +6 -6
  234. package/.mindforge/skills/meme-generation/SKILL.md +1 -1
  235. package/.mindforge/skills/meme-generation/scripts/generate_meme.py +470 -0
  236. package/.mindforge/skills/meme-generation/scripts/templates.json +97 -0
  237. package/.mindforge/skills/obsidian/SKILL.md +15 -15
  238. package/.mindforge/skills/orch-pipeline/SKILL.md +2 -2
  239. package/.mindforge/skills/osint-investigation/SKILL.md +3 -2
  240. package/.mindforge/skills/osint-investigation/references/sources/courtlistener.md +98 -0
  241. package/.mindforge/skills/osint-investigation/references/sources/gdelt.md +104 -0
  242. package/.mindforge/skills/osint-investigation/references/sources/icij-offshore.md +104 -0
  243. package/.mindforge/skills/osint-investigation/references/sources/nyc-acris.md +90 -0
  244. package/.mindforge/skills/osint-investigation/references/sources/ofac-sdn.md +92 -0
  245. package/.mindforge/skills/osint-investigation/references/sources/opencorporates.md +103 -0
  246. package/.mindforge/skills/osint-investigation/references/sources/sec-edgar.md +83 -0
  247. package/.mindforge/skills/osint-investigation/references/sources/senate-ld.md +89 -0
  248. package/.mindforge/skills/osint-investigation/references/sources/usaspending.md +97 -0
  249. package/.mindforge/skills/osint-investigation/references/sources/wayback.md +93 -0
  250. package/.mindforge/skills/osint-investigation/references/sources/wikipedia.md +107 -0
  251. package/.mindforge/skills/osint-investigation/scripts/_http.py +82 -0
  252. package/.mindforge/skills/osint-investigation/scripts/_normalize.py +67 -0
  253. package/.mindforge/skills/osint-investigation/scripts/build_findings.py +221 -0
  254. package/.mindforge/skills/osint-investigation/scripts/entity_resolution.py +228 -0
  255. package/.mindforge/skills/osint-investigation/scripts/fetch_courtlistener.py +149 -0
  256. package/.mindforge/skills/osint-investigation/scripts/fetch_gdelt.py +161 -0
  257. package/.mindforge/skills/osint-investigation/scripts/fetch_icij_offshore.py +234 -0
  258. package/.mindforge/skills/osint-investigation/scripts/fetch_nyc_acris.py +203 -0
  259. package/.mindforge/skills/osint-investigation/scripts/fetch_ofac_sdn.py +175 -0
  260. package/.mindforge/skills/osint-investigation/scripts/fetch_opencorporates.py +191 -0
  261. package/.mindforge/skills/osint-investigation/scripts/fetch_sec_edgar.py +184 -0
  262. package/.mindforge/skills/osint-investigation/scripts/fetch_senate_ld.py +146 -0
  263. package/.mindforge/skills/osint-investigation/scripts/fetch_usaspending.py +170 -0
  264. package/.mindforge/skills/osint-investigation/scripts/fetch_wayback.py +142 -0
  265. package/.mindforge/skills/osint-investigation/scripts/fetch_wikipedia.py +266 -0
  266. package/.mindforge/skills/osint-investigation/scripts/timing_analysis.py +252 -0
  267. package/.mindforge/skills/osint-investigation/templates/source-template.md +59 -0
  268. package/.mindforge/skills/oss-forensics/SKILL.md +6 -6
  269. package/.mindforge/skills/oss-forensics/references/evidence-types.md +89 -0
  270. package/.mindforge/skills/oss-forensics/references/github-archive-guide.md +184 -0
  271. package/.mindforge/skills/oss-forensics/references/investigation-templates.md +131 -0
  272. package/.mindforge/skills/oss-forensics/references/recovery-techniques.md +164 -0
  273. package/.mindforge/skills/oss-forensics/scripts/evidence-store.py +313 -0
  274. package/.mindforge/skills/oss-forensics/templates/forensic-report.md +151 -0
  275. package/.mindforge/skills/oss-forensics/templates/malicious-package-report.md +43 -0
  276. package/.mindforge/skills/pixel-art/SKILL.md +2 -2
  277. package/.mindforge/skills/pixel-art/references/palettes.md +49 -0
  278. package/.mindforge/skills/plan/SKILL.md +10 -10
  279. package/.mindforge/skills/requesting-code-review/SKILL.md +4 -6
  280. package/.mindforge/skills/research-paper-writing/SKILL.md +32 -32
  281. package/.mindforge/skills/research-paper-writing/references/autoreason-methodology.md +394 -0
  282. package/.mindforge/skills/research-paper-writing/references/checklists.md +434 -0
  283. package/.mindforge/skills/research-paper-writing/references/citation-workflow.md +563 -0
  284. package/.mindforge/skills/research-paper-writing/references/experiment-patterns.md +728 -0
  285. package/.mindforge/skills/research-paper-writing/references/human-evaluation.md +476 -0
  286. package/.mindforge/skills/research-paper-writing/references/paper-types.md +481 -0
  287. package/.mindforge/skills/research-paper-writing/references/reviewer-guidelines.md +433 -0
  288. package/.mindforge/skills/research-paper-writing/references/sources.md +191 -0
  289. package/.mindforge/skills/research-paper-writing/references/writing-guide.md +474 -0
  290. package/.mindforge/skills/research-paper-writing/templates/README.md +251 -0
  291. package/.mindforge/skills/scrapling/SKILL.md +1 -1
  292. package/.mindforge/skills/security-review/SKILL.md +1 -1
  293. package/.mindforge/skills/sherlock/SKILL.md +1 -1
  294. package/.mindforge/skills/simplify-code/SKILL.md +5 -7
  295. package/.mindforge/skills/spike/SKILL.md +11 -13
  296. package/.mindforge/skills/subagent-driven-development/SKILL.md +7 -11
  297. package/.mindforge/skills/subagent-driven-development/references/context-budget-discipline.md +53 -0
  298. package/.mindforge/skills/subagent-driven-development/references/gates-taxonomy.md +93 -0
  299. package/.mindforge/skills/systematic-debugging/SKILL.md +13 -14
  300. package/.mindforge/skills/test-driven-development/SKILL.md +7 -8
  301. package/.mindforge/skills/testing-standards/SKILL.md +1 -1
  302. package/.mindforge/skills/web-pentest/SKILL.md +2 -2
  303. package/.mindforge/skills/web-pentest/references/bypass-techniques.md +133 -0
  304. package/.mindforge/skills/web-pentest/references/exploitation-techniques.md +204 -0
  305. package/.mindforge/skills/web-pentest/references/scope-enforcement.md +110 -0
  306. package/.mindforge/skills/web-pentest/references/vuln-taxonomy.md +81 -0
  307. package/.mindforge/skills/web-pentest/templates/authorization.md +69 -0
  308. package/.mindforge/skills/web-pentest/templates/pentest-report.md +178 -0
  309. package/.mindforge/skills/writing-skills/SKILL.md +4 -3
  310. package/CHANGELOG.md +35 -0
  311. package/MINDFORGE.md +3 -3
  312. package/README.md +9 -7
  313. package/RELEASENOTES.md +65 -2
  314. package/SECURITY.md +5 -3
  315. package/bin/autonomous/auto-runner.js +5 -2
  316. package/bin/engine/skill-loader.js +4 -0
  317. package/bin/governance/rbac.js +4 -0
  318. package/bin/memory/eis-client.js +1 -0
  319. package/bin/mindforge-cli.js +5 -0
  320. package/bin/models/bedrock-provider.js +192 -0
  321. package/bin/models/model-client.js +19 -0
  322. package/bin/spawn-agent.js +9 -2
  323. package/docs/commands-reference.md +68 -6
  324. package/docs/faq.md +38 -1
  325. package/docs/getting-started.md +27 -12
  326. package/docs/sdk-reference.md +36 -3
  327. package/docs/troubleshooting.md +59 -1
  328. package/docs/user-guide.md +7 -4
  329. package/package.json +3 -3
  330. package/.claude/commands/mindforge/skill-tdd.md +0 -53
  331. package/.claude/commands/mindforge/skills-index.md +0 -118
  332. package/.claude/commands/mindforge/systematic-debug.md +0 -60
  333. package/.claude/commands/mindforge/wf-accessibility-audit.md +0 -31
  334. package/.claude/commands/mindforge/wf-ai-model-eval.md +0 -31
  335. package/.claude/commands/mindforge/wf-api-migration.md +0 -31
  336. package/.claude/commands/mindforge/wf-architecture-modernization.md +0 -32
  337. package/.claude/commands/mindforge/wf-catalog.md +0 -59
  338. package/.claude/commands/mindforge/wf-code-audit.md +0 -31
  339. package/.claude/commands/mindforge/wf-code-explainer.md +0 -31
  340. package/.claude/commands/mindforge/wf-competitive-analysis.md +0 -31
  341. package/.claude/commands/mindforge/wf-competitive-teardown.md +0 -31
  342. package/.claude/commands/mindforge/wf-cost-analysis.md +0 -31
  343. package/.claude/commands/mindforge/wf-data-pipeline-validate.md +0 -31
  344. package/.claude/commands/mindforge/wf-database-migration.md +0 -31
  345. package/.claude/commands/mindforge/wf-debug-detective.md +0 -32
  346. package/.claude/commands/mindforge/wf-design-system-audit.md +0 -31
  347. package/.claude/commands/mindforge/wf-documentation-gen.md +0 -31
  348. package/.claude/commands/mindforge/wf-feature-planner.md +0 -31
  349. package/.claude/commands/mindforge/wf-incident-response.md +0 -31
  350. package/.claude/commands/mindforge/wf-multi-repo-sync.md +0 -31
  351. package/.claude/commands/mindforge/wf-mutation-testing.md +0 -31
  352. package/.claude/commands/mindforge/wf-onboard-codebase.md +0 -31
  353. package/.claude/commands/mindforge/wf-perf-optimize.md +0 -31
  354. package/.claude/commands/mindforge/wf-pr-review.md +0 -31
  355. package/.claude/commands/mindforge/wf-refactor-plan.md +0 -31
  356. package/.claude/commands/mindforge/wf-release-prep.md +0 -31
  357. package/.claude/commands/mindforge/wf-security-threat-model.md +0 -31
  358. package/.claude/commands/mindforge/wf-tdd-sprint.md +0 -31
  359. package/.claude/commands/mindforge/wf-tech-evaluation.md +0 -31
  360. package/.claude/commands/mindforge/wf-ux-heuristic-audit.md +0 -31
  361. package/.claude/commands/mindforge/wf-writer-reviewer.md +0 -30
@@ -7,6 +7,7 @@
7
7
  const Router = require('./model-router');
8
8
  const CostTracker = require('./cost-tracker');
9
9
  const AnthropicProvider = require('./anthropic-provider');
10
+ const BedrockProvider = require('./bedrock-provider');
10
11
  const OpenAIProvider = require('./openai-provider');
11
12
  const GeminiProvider = require('./gemini-provider');
12
13
  const OllamaProvider = require('./ollama-provider');
@@ -132,6 +133,24 @@ class ModelClient {
132
133
  const registered = resolveProvider(modelId);
133
134
  if (registered) return registered;
134
135
 
136
+ // Bedrock: explicit opt-in via MINDFORGE_LLM_PROVIDER=bedrock OR
137
+ // when ANTHROPIC_API_KEY is absent but AWS credentials are present.
138
+ // Supports both short IDs (claude-sonnet-4-6) and native Bedrock IDs
139
+ // (us.anthropic.*, anthropic.claude-*).
140
+ const bedrockModelPrefixes = modelId.startsWith('us.anthropic.') || modelId.startsWith('anthropic.claude');
141
+ const useBedrockExplicit = process.env.MINDFORGE_LLM_PROVIDER === 'bedrock';
142
+ const awsCredsPresent = !!(process.env.AWS_ACCESS_KEY_ID || process.env.AWS_PROFILE);
143
+ const anthropicKeyAbsent = !process.env.ANTHROPIC_API_KEY;
144
+
145
+ if (bedrockModelPrefixes || useBedrockExplicit || (anthropicKeyAbsent && awsCredsPresent && modelId.startsWith('claude'))) {
146
+ return new BedrockProvider({
147
+ region: process.env.AWS_REGION,
148
+ accessKey: process.env.AWS_ACCESS_KEY_ID,
149
+ secretKey: process.env.AWS_SECRET_ACCESS_KEY,
150
+ profile: process.env.AWS_PROFILE,
151
+ });
152
+ }
153
+
135
154
  if (modelId.startsWith('claude') || modelId.startsWith('anthropic.claude')) {
136
155
  if (!process.env.ANTHROPIC_API_KEY) return null;
137
156
  return new AnthropicProvider(process.env.ANTHROPIC_API_KEY);
@@ -25,8 +25,14 @@ const SAFE_NAME_PATTERN = /^[A-Za-z0-9-_]+$/;
25
25
 
26
26
  if (!MODE || !TARGET) {
27
27
  console.error('❌ Usage: node bin/spawn-agent.js <mode> <target> [--dry-run]');
28
- console.error(' modes: identity | spawn | subagent');
29
- console.error(' Note: spawn mode performs persona resolution only in v1.0 — actual agent dispatch requires Claude Code slash commands (/mindforge:auto or /mindforge:next)');
28
+ console.error('');
29
+ console.error(' Modes:');
30
+ console.error(' identity — resolve persona identity file [NOT IMPLEMENTED in v1.0]');
31
+ console.error(' spawn — dispatch agent to Claude Code runtime [NOT IMPLEMENTED in v1.0]');
32
+ console.error(' subagent — launch a fresh-context subagent (dry-run only)');
33
+ console.error('');
34
+ console.error(' Note: spawn and identity require Claude Code slash commands in v1.0.');
35
+ console.error(' Use /mindforge:auto or /mindforge:next to dispatch agents.');
30
36
  process.exit(1);
31
37
  }
32
38
 
@@ -100,6 +106,7 @@ async function run() {
100
106
  }
101
107
  console.log(`📡 Loading specialized identity: ${TARGET}`);
102
108
  } else if (MODE === 'spawn') {
109
+ assertSafeName(TARGET); // path-containment guard — mirrors subagent branch
103
110
  personaPath = path.join(ROOT, '.mindforge', 'personas', `${TARGET}.md`);
104
111
  if (!fs.existsSync(personaPath)) {
105
112
  console.error(`❌ Persona not found: ${personaPath}`);
@@ -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
 
@@ -183,8 +183,8 @@ mindforge <command> [options]
183
183
  | `remember` | Manage the long-term memory (knowledge graph) |
184
184
  | `learn-skill` | Ingest source and generate a validated SKILL.md |
185
185
  | `marketplace` | Search and install community skills |
186
- | `spawn` | Spawn a persona essence (e.g., mf-planner) |
187
- | `identity` | Invoke a specialized identity from /agents/ |
186
+ | `spawn` | Spawn a persona essence (e.g., mf-planner) [v1.0: stub — dispatch not yet implemented] |
187
+ | `identity` | Invoke a specialized identity from /agents/ [v1.0: stub — dispatch not yet implemented] |
188
188
  | `temporal` | Manage time-travel debugging and state history |
189
189
  | `hindsight` | Inject a fix into a past point and regenerate state |
190
190
  | `harvest` | Proactively harvest semantic intent from the intelligence mesh |
@@ -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. **32 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 32 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 |
@@ -246,3 +245,66 @@ Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands.
246
245
  | `/mindforge:wf-accessibility-audit` | beast | WCAG 2.2 parallel per-criterion audit → 3-vote adversarial verify failures → remediation spec |
247
246
  | `/mindforge:wf-security-threat-model` | beast | Asset inventory → STRIDE threat enumeration → parallel mitigations → CVSS-style score matrix |
248
247
 
248
+ ---
249
+
250
+ ## Dynamic Workflow Library (32 workflows)
251
+
252
+ All workflow commands follow the pattern `/mindforge:wf-<name>`.
253
+
254
+ Invoke via CLI:
255
+ ```bash
256
+ node bin/mindforge-cli.js workflow list # browse all 32
257
+ node bin/mindforge-cli.js workflow info <name> # phases + description
258
+ ```
259
+
260
+ ### Research Tier (5 workflows)
261
+ | Command | Description |
262
+ |---------|-------------|
263
+ | `/mindforge:wf-competitive-analysis` | SWOT and positioning from 5 parallel research angles |
264
+ | `/mindforge:wf-tech-evaluation` | Scored technology evaluation across 5 dimensions |
265
+ | `/mindforge:wf-ai-model-eval` | Benchmark AI models → scoring matrix → recommendation |
266
+ | `/mindforge:wf-ux-heuristic-audit` | 10 Nielsen heuristics parallel audit → fix brief |
267
+ | `/mindforge:wf-competitive-teardown` | 5 competitor angles → positioning report |
268
+
269
+ ### Dev Tier (12 workflows)
270
+ | Command | Description |
271
+ |---------|-------------|
272
+ | `/mindforge:wf-code-audit` | Parallel security + quality + performance audit |
273
+ | `/mindforge:wf-feature-planner` | Brief → PRD → architecture → user stories |
274
+ | `/mindforge:wf-pr-review` | 4-dimensional parallel PR review → verdict |
275
+ | `/mindforge:wf-tdd-sprint` | Strict Red-Green-Refactor TDD loop |
276
+ | `/mindforge:wf-refactor-plan` | Technical debt scan → risk-sorted refactor plan |
277
+ | `/mindforge:wf-test-coverage-gap` | Per-module coverage analysis → test-writing plan |
278
+ | `/mindforge:wf-api-contract-test` | Spec vs impl Writer/Reviewer → violation report |
279
+ | `/mindforge:wf-debug-detective` | 4-hypothesis parallel investigation → scientific RCA |
280
+ | `/mindforge:wf-writer-reviewer` | Implement → fresh context review → verdict |
281
+ | `/mindforge:wf-mutation-testing` | Mutant generator → parallel kill-test → score |
282
+ | `/mindforge:wf-code-explainer` | Structure → domain → architecture → narrative tour |
283
+ | `/mindforge:wf-design-system-audit` | 5-dimension parallel audit → consistency score |
284
+
285
+ ### Ops Tier (6 workflows)
286
+ | Command | Description |
287
+ |---------|-------------|
288
+ | `/mindforge:wf-incident-response` | Parallel investigation → RCA → postmortem |
289
+ | `/mindforge:wf-release-prep` | Tests → changelog → version bump → PR |
290
+ | `/mindforge:wf-dependency-health` | CVE + license + staleness audit → risk matrix |
291
+ | `/mindforge:wf-database-migration` | Schema diff → risk → scripts → runbook |
292
+ | `/mindforge:wf-multi-repo-sync` | Per-repo audit → divergence map → sync plan |
293
+ | `/mindforge:wf-cost-analysis` | Infra/API/query/bundle cost agents → ROI plan |
294
+
295
+ ### Intelligence Tier (6 workflows)
296
+ | Command | Description |
297
+ |---------|-------------|
298
+ | `/mindforge:wf-onboard-codebase` | Map → domain → architecture → guided tour |
299
+ | `/mindforge:wf-perf-optimize` | Profile → bottleneck hunt → prioritized fix plan |
300
+ | `/mindforge:wf-architecture-modernization` | Legacy map → 3 designs → migration roadmap |
301
+ | `/mindforge:wf-documentation-gen` | Parallel doc gen → normalize → publish-ready |
302
+ | `/mindforge:wf-api-migration` | Breaking change detection → guide → compat matrix |
303
+ | `/mindforge:wf-data-pipeline-validate` | Stage-by-stage validation → quality gates |
304
+
305
+ ### Beast Tier (3 workflows — 5 phases, 8+ agents, adversarial 3-vote verification)
306
+ | Command | Description |
307
+ |---------|-------------|
308
+ | `/mindforge:wf-security-hardening` | 5-angle OWASP scout → 3-vote verify → STRIDE → roadmap |
309
+ | `/mindforge:wf-accessibility-audit` | WCAG 2.2 per-criterion → 3-vote verify → remediation spec |
310
+ | `/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
+ 32 pre-built multi-agent workflows across 5 tiers: Research (5), Dev (12), Ops (6), Intelligence (6), 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 32 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 32.
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
 
@@ -45,7 +46,7 @@ Run the MindForge MCP server (`mindforge-mcp-server`) over stdio — it exposes
45
46
  claude mcp add mindforge -- npx -y mindforge-mcp-server
46
47
  ```
47
48
 
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).
49
+ 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
50
 
50
51
  ### 4. Homebrew
51
52
 
@@ -61,17 +62,31 @@ To build on top of MindForge programmatically, install the TypeScript SDK:
61
62
  npm i mindforge-sdk
62
63
  ```
63
64
 
64
- ## Dynamic Workflow Library
65
+ ## Dynamic Workflow Library (32 workflows across 5 tiers)
65
66
 
66
- MindForge ships 33 pre-built multi-agent workflows across 5 tiers, triggerable via `/mindforge:wf-*` commands:
67
67
 
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)
68
+ | Tier | Count | Workflows |
69
+ |------|-------|-----------|
70
+ | Research | 5 | competitive-analysis, tech-evaluation, ai-model-eval, ux-heuristic-audit, competitive-teardown |
71
+ | Dev | 12 | 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 |
72
+ | Ops | 6 | incident-response, release-prep, dependency-health, database-migration, multi-repo-sync, cost-analysis |
73
+ | Intelligence | 6 | onboard-codebase, perf-optimize, architecture-modernization, documentation-gen, api-migration, data-pipeline-validate |
74
+ | Beast | 3 | security-hardening, accessibility-audit, security-threat-model |
73
75
 
74
- Browse with `/mindforge:wf-catalog`.
76
+ **Run any workflow:**
77
+ ```bash
78
+ node bin/mindforge-cli.js workflow list # browse all 32
79
+ node bin/mindforge-cli.js workflow info code-audit # details + phases
80
+ ```
81
+ Or use slash commands: `/mindforge:wf-code-audit`
82
+
83
+ ## Your First 5 Minutes with MindForge
84
+
85
+ 1. **Verify install:** `node bin/mindforge-cli.js health`
86
+ 2. **Check version:** `node bin/mindforge-cli.js --version` (should print `11.9.0`)
87
+ 3. **List workflows:** `node bin/mindforge-cli.js workflow list`
88
+ 4. **Run first slash command:** Open Claude Code → `/mindforge:status`
89
+ 5. **Onboard your codebase:** Open Claude Code → `/mindforge:wf-onboard-codebase`
75
90
 
76
91
  ## Initialise Your Project
77
92
 
@@ -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.9.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:** 32 workflows · 221 slash commands · 232 engine skills · 211 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 **32 pre-built workflow pipelines** across **219 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.2",
3
+ "version": "11.9.0",
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",
@@ -90,11 +90,11 @@
90
90
  "homepage": "https://github.com/sairam0424/MindForge#readme",
91
91
  "devDependencies": {
92
92
  "@eslint/js": "^9.0.0",
93
- "@types/node": "^20.0.0",
93
+ "@types/node": "^26.0.0",
94
94
  "c8": "^10.0.0",
95
95
  "commitizen": "^4.2.4",
96
96
  "cz-conventional-changelog": "3.3.0",
97
- "eslint": "^9.0.0",
97
+ "eslint": "^10.5.0",
98
98
  "globals": "^15.0.0",
99
99
  "husky": "9.1.7",
100
100
  "playwright": "^1.40.0"
@@ -1,53 +0,0 @@
1
- ---
2
- description: "Test-Driven Development — RED-GREEN-REFACTOR discipline. Write the failing test first, always."
3
- ---
4
-
5
- # MindForge — TDD Skill Command
6
- # Usage: /mindforge:skill-tdd [feature or bug to implement]
7
-
8
- Activates the test-driven development skill. The core rule: **if you didn't watch the test fail, you don't know if it tests the right thing.**
9
-
10
- ## Activation
11
-
12
- Load `.mindforge/skills/test-driven-development/SKILL.md` immediately.
13
- Follow its RED-GREEN-REFACTOR cycle strictly for the full duration of this session.
14
-
15
- ## The Cycle (non-negotiable)
16
-
17
- ### RED — Write a failing test
18
- 1. Identify the smallest next behavior to implement.
19
- 2. Write one test that asserts that behavior.
20
- 3. Run it — confirm it FAILS for the right reason (not a syntax error, not a missing import — the actual assertion fails).
21
- 4. Do not proceed until the test fails correctly.
22
-
23
- ### GREEN — Write minimal code to pass
24
- 1. Write the simplest code that makes the test pass.
25
- 2. No gold-plating, no extra features. Minimum viable.
26
- 3. Run the test — it must pass.
27
- 4. Run the full suite — no regressions.
28
-
29
- ### REFACTOR — Clean up
30
- 1. Improve code structure, naming, and clarity.
31
- 2. Remove duplication.
32
- 3. Tests stay green throughout — run after every change.
33
-
34
- ## Mandatory gates
35
-
36
- - **Never write code without a failing test.** Not for "obvious" cases, not for "quick" fixes, not for "trivial" implementations.
37
- - **One cycle at a time.** Complete RED-GREEN-REFACTOR before starting the next behavior.
38
- - **A passing test suite is always the starting state.** If tests are red when you begin, fix them first.
39
-
40
- ## When the user asks for a feature
41
-
42
- 1. Decompose into the smallest testable behavior.
43
- 2. Start with the first RED step before writing any implementation.
44
- 3. Repeat the cycle for each behavior.
45
-
46
- ## When the user asks for a bug fix
47
-
48
- 1. Write a failing test that reproduces the bug (this is your RED step).
49
- 2. Confirm it fails.
50
- 3. Fix the code (GREEN).
51
- 4. Refactor if needed.
52
-
53
- The bug test becomes the regression guard — it must remain in the suite permanently.
@@ -1,118 +0,0 @@
1
- ---
2
- description: "Browse all available skills by category — discover and activate any skill by name."
3
- ---
4
-
5
- # MindForge — Skills Index
6
- # Usage: /mindforge:skills-index [optional: category or keyword filter]
7
-
8
- Lists all skills available in this MindForge installation. Skills in the **Engine** tier activate automatically via trigger-matching. Skills in the **Extended** tier require explicit invocation.
9
-
10
- ---
11
-
12
- ## How to activate a skill
13
-
14
- **Engine tier** (auto-triggers from `.mindforge/skills/`): Just describe the task — the skill-loader matches your request against each skill's `triggers:` field and loads the relevant skill automatically.
15
-
16
- **Extended tier** (explicit from `.agent/skills/`): Ask Claude to "use the [skill-name] skill" or invoke it by name.
17
-
18
- ---
19
-
20
- ## Engine Tier Skills (auto-triggered)
21
-
22
- ### Software Development
23
- | Skill | Triggers |
24
- |---|---|
25
- | `systematic-debugging` | systematic debugging, root cause analysis, debug methodology, 4-phase debug |
26
- | `test-driven-development` | TDD, red green refactor, write test first, test before code |
27
- | `plan` | write a plan, plan mode, implementation plan, plan before coding |
28
- | `simplify-code` | simplify code, clean up code, refactor for clarity, reduce complexity |
29
- | `requesting-code-review` | request code review, code review protocol, review this PR |
30
- | `spike` | technical spike, time-boxed spike, explore this problem |
31
- | `subagent-driven-development` | subagent driven development, delegate to subagent, multi-agent implementation |
32
- | `code-wiki` | code wiki, document codebase, knowledge wiki, explain codebase |
33
-
34
- ### DevOps & Orchestration
35
- | Skill | Triggers |
36
- |---|---|
37
- | `kanban-orchestrator` | kanban orchestrator, multi-agent kanban, decompose and route, orchestrate tasks |
38
- | `kanban-worker` | kanban worker, pick up kanban task, complete kanban card |
39
-
40
- ### GitHub Workflows
41
- | Skill | Triggers |
42
- |---|---|
43
- | `github-code-review` | github code review, review PR, pull request review workflow |
44
- | `github-pr-workflow` | github pr workflow, pull request lifecycle, open PR, merge PR |
45
- | `github-issues` | github issues, create issue, manage issues, issue triage |
46
- | `codebase-inspection` | codebase inspection, explore codebase, understand repository |
47
-
48
- ### Research & Intelligence
49
- | Skill | Triggers |
50
- |---|---|
51
- | `research-paper-writing` | research paper, academic paper, write paper, arxiv paper |
52
- | `arxiv` | arxiv search, find papers, search arxiv, academic literature |
53
- | `osint-investigation` | OSINT investigation, public records research, entity investigation |
54
- | `domain-intel` | domain intelligence, investigate domain, domain research |
55
- | `duckduckgo-search` | duckduckgo search, DDG search, web search |
56
- | `scrapling` | scrape website, web scraping, extract web content |
57
- | `blogwatcher` | monitor blog, watch blog, track blog updates |
58
-
59
- ### Creative
60
- | Skill | Triggers |
61
- |---|---|
62
- | `concept-diagrams` | concept diagram, educational diagram, SVG diagram, visual explanation |
63
- | `creative-ideation` | creative ideation, brainstorm ideas, creative ideas, generate concepts |
64
- | `pixel-art` | pixel art, create pixel art, sprite design |
65
- | `meme-generation` | meme generation, create meme, generate meme |
66
-
67
- ### Security
68
- | Skill | Triggers |
69
- |---|---|
70
- | `web-pentest` | web penetration test, pentest this app, security test web app, OWASP test |
71
- | `oss-forensics` | OSS forensics, open source forensics, supply chain audit |
72
- | `sherlock` | sherlock, username investigation, find accounts, OSINT username |
73
-
74
- ### Data & Tooling
75
- | Skill | Triggers |
76
- |---|---|
77
- | `jupyter-live-kernel` | jupyter kernel, live jupyter, interactive notebook |
78
- | `obsidian` | obsidian notes, obsidian vault, obsidian workflow |
79
-
80
- ---
81
-
82
- ## Extended Tier Skills (`.agent/skills/`, explicit activation)
83
-
84
- ### Software Development
85
- `node-inspect-debugger` · `python-debugpy` · `skill-authoring` · `rest-graphql-debug`
86
-
87
- ### GitHub
88
- `github-auth` · `github-repo-management`
89
-
90
- ### DevOps
91
- `docker-management` · `devops-cli` · `devops-watchers` · `pinggy-tunnel` · `s6-container-supervision`
92
-
93
- ### Research
94
- `llm-wiki` · `polymarket` · `parallel-cli`
95
-
96
- ### Security
97
- `godmode` · `1password-skill`
98
-
99
- ### Creative
100
- `hyperframes` · `article-illustrator` · `comic-creator` · `video-orchestrator`
101
-
102
- ---
103
-
104
- ## Usage examples
105
-
106
- ```
107
- "Debug this null pointer — use systematic debugging"
108
- → Engine tier: systematic-debugging activates automatically
109
-
110
- "I want to do TDD on this new auth module"
111
- → Engine tier: test-driven-development activates automatically
112
-
113
- "Use the docker-management skill to set up my containers"
114
- → Extended tier: explicit invocation of docker-management
115
-
116
- "Run an OSINT investigation on this company"
117
- → Engine tier: osint-investigation activates automatically
118
- ```