mindforge-cc 9.0.0 → 10.0.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 (717) hide show
  1. package/.mindforge/config.json +1 -1
  2. package/.mindforge/personas/a11y-architect.md +190 -0
  3. package/.mindforge/personas/accessibility-tester.md +108 -0
  4. package/.mindforge/personas/api-designer.md +190 -0
  5. package/.mindforge/personas/api-gateway-architect.md +168 -0
  6. package/.mindforge/personas/api-load-tester.md +144 -0
  7. package/.mindforge/personas/authentication-architect.md +163 -0
  8. package/.mindforge/personas/backup-recovery-specialist.md +181 -0
  9. package/.mindforge/personas/browser-extension-architect.md +96 -0
  10. package/.mindforge/personas/build-optimizer.md +160 -0
  11. package/.mindforge/personas/caching-strategist.md +180 -0
  12. package/.mindforge/personas/chaos-engineer.md +207 -0
  13. package/.mindforge/personas/cli-designer.md +151 -0
  14. package/.mindforge/personas/cloud-architect.md +229 -0
  15. package/.mindforge/personas/code-archeologist.md +176 -0
  16. package/.mindforge/personas/code-explorer.md +144 -0
  17. package/.mindforge/personas/compliance-auditor.md +190 -0
  18. package/.mindforge/personas/concurrency-expert.md +310 -0
  19. package/.mindforge/personas/config-management-expert.md +277 -0
  20. package/.mindforge/personas/contract-tester.md +224 -0
  21. package/.mindforge/personas/cost-analyst.md +209 -0
  22. package/.mindforge/personas/data-engineer.md +235 -0
  23. package/.mindforge/personas/data-privacy-engineer.md +187 -0
  24. package/.mindforge/personas/database-expert.md +223 -0
  25. package/.mindforge/personas/dependency-auditor.md +181 -0
  26. package/.mindforge/personas/design-system-engineer.md +115 -0
  27. package/.mindforge/personas/devops-engineer.md +561 -0
  28. package/.mindforge/personas/domain-modeler.md +127 -0
  29. package/.mindforge/personas/email-systems-engineer.md +119 -0
  30. package/.mindforge/personas/error-handling-architect.md +246 -0
  31. package/.mindforge/personas/event-driven-architect.md +134 -0
  32. package/.mindforge/personas/frontend-architect.md +107 -0
  33. package/.mindforge/personas/git-forensics.md +146 -0
  34. package/.mindforge/personas/git-workflow-expert.md +161 -0
  35. package/.mindforge/personas/go-specialist.md +249 -0
  36. package/.mindforge/personas/graphql-specialist.md +195 -0
  37. package/.mindforge/personas/incident-commander.md +214 -0
  38. package/.mindforge/personas/internationalization-expert.md +164 -0
  39. package/.mindforge/personas/java-specialist.md +271 -0
  40. package/.mindforge/personas/kubernetes-debugger.md +175 -0
  41. package/.mindforge/personas/logging-architect.md +200 -0
  42. package/.mindforge/personas/migration-specialist.md +237 -0
  43. package/.mindforge/personas/ml-engineer.md +312 -0
  44. package/.mindforge/personas/mobile-engineer.md +183 -0
  45. package/.mindforge/personas/monorepo-architect.md +323 -0
  46. package/.mindforge/personas/observability-engineer.md +217 -0
  47. package/.mindforge/personas/onboarding-guide.md +265 -0
  48. package/.mindforge/personas/performance-optimizer.md +293 -0
  49. package/.mindforge/personas/product-manager.md +105 -0
  50. package/.mindforge/personas/prompt-engineer.md +200 -0
  51. package/.mindforge/personas/python-specialist.md +277 -0
  52. package/.mindforge/personas/queue-architect.md +136 -0
  53. package/.mindforge/personas/react-specialist.md +97 -0
  54. package/.mindforge/personas/real-time-engineer.md +121 -0
  55. package/.mindforge/personas/refactoring-expert.md +117 -0
  56. package/.mindforge/personas/regex-craftsman.md +130 -0
  57. package/.mindforge/personas/rust-specialist.md +262 -0
  58. package/.mindforge/personas/sdk-designer.md +185 -0
  59. package/.mindforge/personas/search-engineer.md +290 -0
  60. package/.mindforge/personas/senior-reviewer.md +372 -0
  61. package/.mindforge/personas/seo-specialist.md +99 -0
  62. package/.mindforge/personas/spec-reviewer.md +172 -0
  63. package/.mindforge/personas/state-machine-designer.md +172 -0
  64. package/.mindforge/personas/swarm-templates.json +72 -18
  65. package/.mindforge/personas/tailwind-specialist.md +95 -0
  66. package/.mindforge/personas/tech-debt-analyst.md +200 -0
  67. package/.mindforge/personas/tech-stack-selector.md +118 -0
  68. package/.mindforge/personas/technical-interviewer.md +158 -0
  69. package/.mindforge/personas/test-data-engineer.md +169 -0
  70. package/.mindforge/personas/typescript-wizard.md +247 -0
  71. package/.mindforge/personas/ux-auditor.md +251 -0
  72. package/.mindforge/personas/webhook-designer.md +161 -0
  73. package/CHANGELOG.md +82 -0
  74. package/LICENSE +1 -1
  75. package/MINDFORGE.md +18 -5
  76. package/README.md +7 -1
  77. package/RELEASENOTES.md +121 -193
  78. package/SECURITY.md +108 -2
  79. package/bin/autonomous/audit-writer.js +90 -0
  80. package/bin/autonomous/auto-runner.js +209 -431
  81. package/bin/autonomous/state-manager.js +116 -0
  82. package/bin/autonomous/task-dispatcher.js +114 -0
  83. package/bin/autonomous/wave-executor.js +169 -0
  84. package/bin/browser/browser-daemon.js +31 -1
  85. package/bin/change-classifier.js +3 -3
  86. package/bin/dashboard/api-router.js +21 -22
  87. package/bin/dashboard/metrics-aggregator.js +44 -3
  88. package/bin/dashboard/server.js +54 -10
  89. package/bin/dashboard/sse-bridge.js +51 -5
  90. package/bin/engine/learning-manager.js +1 -1
  91. package/bin/engine/mesh-syncer.js +26 -22
  92. package/bin/engine/nexus-tracer.js +6 -5
  93. package/bin/engine/orbital-guardian.js +13 -10
  94. package/bin/engine/skill-evolver.js +12 -14
  95. package/bin/engine/temporal-hub.js +25 -1
  96. package/bin/governance/policy-engine.js +5 -5
  97. package/bin/governance/policy-gate-hardened.js +2 -2
  98. package/bin/governance/quantum-crypto.js +10 -2
  99. package/bin/memory/identity-synthesizer.js +9 -11
  100. package/bin/memory/knowledge-store.js +62 -6
  101. package/bin/memory/semantic-hub.js +26 -30
  102. package/bin/memory/vector-hub.js +377 -193
  103. package/bin/migrations/v8-sqlite-migration.js +22 -21
  104. package/bin/migrations/v9-unified-memory.js +1 -1
  105. package/bin/mindforge-cli.js +47 -11
  106. package/bin/models/model-broker.js +2 -0
  107. package/bin/revops/remediation-queue.js +16 -55
  108. package/bin/utils/errors.js +40 -0
  109. package/bin/utils/file-io.js +102 -0
  110. package/bin/utils/index.js +6 -0
  111. package/bin/utils/paths.js +33 -0
  112. package/docs/commands-reference.md +38 -2
  113. package/docs/getting-started.md +16 -6
  114. package/docs/sdk-reference.md +374 -24
  115. package/docs/troubleshooting.md +4 -4
  116. package/docs/user-guide.md +31 -11
  117. package/examples/sdk-integration/README.md +24 -0
  118. package/examples/sdk-integration/index.js +24 -0
  119. package/examples/starter-project/MINDFORGE.md +8 -8
  120. package/package.json +30 -15
  121. package/.agent/bin/lib/commands.cjs +0 -959
  122. package/.agent/bin/lib/config.cjs +0 -421
  123. package/.agent/bin/lib/core.cjs +0 -1166
  124. package/.agent/bin/lib/frontmatter.cjs +0 -307
  125. package/.agent/bin/lib/init.cjs +0 -1336
  126. package/.agent/bin/lib/milestone.cjs +0 -252
  127. package/.agent/bin/lib/model-profiles.cjs +0 -68
  128. package/.agent/bin/lib/phase.cjs +0 -888
  129. package/.agent/bin/lib/profile-output.cjs +0 -952
  130. package/.agent/bin/lib/profile-pipeline.cjs +0 -539
  131. package/.agent/bin/lib/roadmap.cjs +0 -329
  132. package/.agent/bin/lib/security.cjs +0 -356
  133. package/.agent/bin/lib/state.cjs +0 -969
  134. package/.agent/bin/lib/template.cjs +0 -222
  135. package/.agent/bin/lib/uat.cjs +0 -189
  136. package/.agent/bin/lib/verify.cjs +0 -851
  137. package/.agent/bin/lib/workstream.cjs +0 -491
  138. package/.agent/bin/mindforge-tools.cjs +0 -897
  139. package/.agent/file-manifest.json +0 -219
  140. package/.agent/forge/help.md +0 -11
  141. package/.agent/forge/init-project.md +0 -36
  142. package/.agent/forge/plan-phase.md +0 -34
  143. package/.agent/mindforge/add-backlog.md +0 -32
  144. package/.agent/mindforge/agent.md +0 -31
  145. package/.agent/mindforge/approve.md +0 -22
  146. package/.agent/mindforge/audit.md +0 -34
  147. package/.agent/mindforge/auto.md +0 -26
  148. package/.agent/mindforge/benchmark.md +0 -37
  149. package/.agent/mindforge/browse.md +0 -30
  150. package/.agent/mindforge/complete-milestone.md +0 -22
  151. package/.agent/mindforge/costs.md +0 -15
  152. package/.agent/mindforge/cross-review.md +0 -21
  153. package/.agent/mindforge/dashboard.md +0 -102
  154. package/.agent/mindforge/debug.md +0 -133
  155. package/.agent/mindforge/discuss-phase.md +0 -142
  156. package/.agent/mindforge/do.md +0 -31
  157. package/.agent/mindforge/execute-phase.md +0 -200
  158. package/.agent/mindforge/health.md +0 -31
  159. package/.agent/mindforge/help.md +0 -33
  160. package/.agent/mindforge/init-org.md +0 -135
  161. package/.agent/mindforge/init-project.md +0 -170
  162. package/.agent/mindforge/install-skill.md +0 -28
  163. package/.agent/mindforge/learn.md +0 -147
  164. package/.agent/mindforge/learning.md +0 -20
  165. package/.agent/mindforge/map-codebase.md +0 -302
  166. package/.agent/mindforge/marketplace.md +0 -124
  167. package/.agent/mindforge/metrics.md +0 -26
  168. package/.agent/mindforge/migrate.md +0 -44
  169. package/.agent/mindforge/milestone.md +0 -16
  170. package/.agent/mindforge/new-runtime.md +0 -23
  171. package/.agent/mindforge/next.md +0 -109
  172. package/.agent/mindforge/note.md +0 -35
  173. package/.agent/mindforge/plan-phase.md +0 -131
  174. package/.agent/mindforge/plant-seed.md +0 -31
  175. package/.agent/mindforge/plugins.md +0 -44
  176. package/.agent/mindforge/pr-review.md +0 -45
  177. package/.agent/mindforge/profile-team.md +0 -27
  178. package/.agent/mindforge/publish-skill.md +0 -23
  179. package/.agent/mindforge/qa.md +0 -20
  180. package/.agent/mindforge/quick.md +0 -139
  181. package/.agent/mindforge/record-learning.md +0 -22
  182. package/.agent/mindforge/release.md +0 -14
  183. package/.agent/mindforge/remember.md +0 -30
  184. package/.agent/mindforge/research.md +0 -16
  185. package/.agent/mindforge/retrospective.md +0 -31
  186. package/.agent/mindforge/review-backlog.md +0 -34
  187. package/.agent/mindforge/review.md +0 -161
  188. package/.agent/mindforge/security-scan.md +0 -242
  189. package/.agent/mindforge/session-report.md +0 -39
  190. package/.agent/mindforge/ship.md +0 -111
  191. package/.agent/mindforge/skills.md +0 -145
  192. package/.agent/mindforge/status.md +0 -113
  193. package/.agent/mindforge/steer.md +0 -17
  194. package/.agent/mindforge/sync-confluence.md +0 -15
  195. package/.agent/mindforge/sync-jira.md +0 -16
  196. package/.agent/mindforge/tokens.md +0 -12
  197. package/.agent/mindforge/ui-phase.md +0 -34
  198. package/.agent/mindforge/ui-review.md +0 -36
  199. package/.agent/mindforge/update.md +0 -46
  200. package/.agent/mindforge/validate-phase.md +0 -31
  201. package/.agent/mindforge/verify-phase.md +0 -66
  202. package/.agent/mindforge/workspace.md +0 -33
  203. package/.agent/mindforge/workstreams.md +0 -35
  204. package/.agent/settings.json +0 -42
  205. package/.agent/skills/mindforge-add-backlog/SKILL.md +0 -72
  206. package/.agent/skills/mindforge-add-phase/SKILL.md +0 -39
  207. package/.agent/skills/mindforge-add-tests/SKILL.md +0 -28
  208. package/.agent/skills/mindforge-add-todo/SKILL.md +0 -42
  209. package/.agent/skills/mindforge-audit-milestone/SKILL.md +0 -29
  210. package/.agent/skills/mindforge-audit-uat/SKILL.md +0 -20
  211. package/.agent/skills/mindforge-autonomous/SKILL.md +0 -33
  212. package/.agent/skills/mindforge-brainstorming/SKILL.md +0 -164
  213. package/.agent/skills/mindforge-brainstorming/scripts/frame-template.html +0 -214
  214. package/.agent/skills/mindforge-brainstorming/scripts/helper.js +0 -88
  215. package/.agent/skills/mindforge-brainstorming/scripts/server.cjs +0 -354
  216. package/.agent/skills/mindforge-brainstorming/scripts/start-server.sh +0 -148
  217. package/.agent/skills/mindforge-brainstorming/scripts/stop-server.sh +0 -56
  218. package/.agent/skills/mindforge-brainstorming/spec-document-reviewer-prompt.md +0 -49
  219. package/.agent/skills/mindforge-brainstorming/visual-companion.md +0 -287
  220. package/.agent/skills/mindforge-check-todos/SKILL.md +0 -40
  221. package/.agent/skills/mindforge-cleanup/SKILL.md +0 -19
  222. package/.agent/skills/mindforge-complete-milestone/SKILL.md +0 -131
  223. package/.agent/skills/mindforge-debug/SKILL.md +0 -163
  224. package/.agent/skills/mindforge-debug_extended/CREATION-LOG.md +0 -119
  225. package/.agent/skills/mindforge-debug_extended/SKILL.md +0 -296
  226. package/.agent/skills/mindforge-debug_extended/condition-based-waiting-example.ts +0 -158
  227. package/.agent/skills/mindforge-debug_extended/condition-based-waiting.md +0 -115
  228. package/.agent/skills/mindforge-debug_extended/defense-in-depth.md +0 -122
  229. package/.agent/skills/mindforge-debug_extended/find-polluter.sh +0 -63
  230. package/.agent/skills/mindforge-debug_extended/root-cause-tracing.md +0 -169
  231. package/.agent/skills/mindforge-debug_extended/test-academic.md +0 -14
  232. package/.agent/skills/mindforge-debug_extended/test-pressure-1.md +0 -58
  233. package/.agent/skills/mindforge-debug_extended/test-pressure-2.md +0 -68
  234. package/.agent/skills/mindforge-debug_extended/test-pressure-3.md +0 -69
  235. package/.agent/skills/mindforge-discuss-phase/SKILL.md +0 -54
  236. package/.agent/skills/mindforge-do/SKILL.md +0 -26
  237. package/.agent/skills/mindforge-execute-phase/SKILL.md +0 -49
  238. package/.agent/skills/mindforge-execute-phase_extended/SKILL.md +0 -70
  239. package/.agent/skills/mindforge-fast/SKILL.md +0 -23
  240. package/.agent/skills/mindforge-forensics/SKILL.md +0 -49
  241. package/.agent/skills/mindforge-health/SKILL.md +0 -17
  242. package/.agent/skills/mindforge-help/SKILL.md +0 -23
  243. package/.agent/skills/mindforge-insert-phase/SKILL.md +0 -28
  244. package/.agent/skills/mindforge-join-discord/SKILL.md +0 -19
  245. package/.agent/skills/mindforge-list-phase-assumptions/SKILL.md +0 -41
  246. package/.agent/skills/mindforge-list-workspaces/SKILL.md +0 -17
  247. package/.agent/skills/mindforge-manager/SKILL.md +0 -32
  248. package/.agent/skills/mindforge-map-codebase/SKILL.md +0 -64
  249. package/.agent/skills/mindforge-milestone-summary/SKILL.md +0 -44
  250. package/.agent/skills/mindforge-neural-orchestrator/SKILL.md +0 -115
  251. package/.agent/skills/mindforge-neural-orchestrator/references/codex-tools.md +0 -100
  252. package/.agent/skills/mindforge-neural-orchestrator/references/gemini-tools.md +0 -33
  253. package/.agent/skills/mindforge-new-milestone/SKILL.md +0 -38
  254. package/.agent/skills/mindforge-new-project/SKILL.md +0 -36
  255. package/.agent/skills/mindforge-new-workspace/SKILL.md +0 -39
  256. package/.agent/skills/mindforge-next/SKILL.md +0 -19
  257. package/.agent/skills/mindforge-note/SKILL.md +0 -29
  258. package/.agent/skills/mindforge-parallel-mesh_extended/SKILL.md +0 -182
  259. package/.agent/skills/mindforge-pause-work/SKILL.md +0 -35
  260. package/.agent/skills/mindforge-plan-milestone-gaps/SKILL.md +0 -28
  261. package/.agent/skills/mindforge-plan-phase/SKILL.md +0 -38
  262. package/.agent/skills/mindforge-plan-phase_extended/SKILL.md +0 -152
  263. package/.agent/skills/mindforge-plan-phase_extended/plan-document-reviewer-prompt.md +0 -49
  264. package/.agent/skills/mindforge-plant-seed/SKILL.md +0 -22
  265. package/.agent/skills/mindforge-pr-branch/SKILL.md +0 -21
  266. package/.agent/skills/mindforge-profile-user/SKILL.md +0 -38
  267. package/.agent/skills/mindforge-progress/SKILL.md +0 -19
  268. package/.agent/skills/mindforge-quick/SKILL.md +0 -38
  269. package/.agent/skills/mindforge-reapply-patches/SKILL.md +0 -124
  270. package/.agent/skills/mindforge-remove-phase/SKILL.md +0 -26
  271. package/.agent/skills/mindforge-remove-workspace/SKILL.md +0 -22
  272. package/.agent/skills/mindforge-research-phase/SKILL.md +0 -186
  273. package/.agent/skills/mindforge-resume-work/SKILL.md +0 -35
  274. package/.agent/skills/mindforge-review/SKILL.md +0 -31
  275. package/.agent/skills/mindforge-review-backlog/SKILL.md +0 -58
  276. package/.agent/skills/mindforge-review-inbound/SKILL.md +0 -213
  277. package/.agent/skills/mindforge-review-request/SKILL.md +0 -105
  278. package/.agent/skills/mindforge-review-request/code-reviewer.md +0 -146
  279. package/.agent/skills/mindforge-session-report/SKILL.md +0 -16
  280. package/.agent/skills/mindforge-set-profile/SKILL.md +0 -9
  281. package/.agent/skills/mindforge-settings/SKILL.md +0 -32
  282. package/.agent/skills/mindforge-ship/SKILL.md +0 -16
  283. package/.agent/skills/mindforge-ship_extended/SKILL.md +0 -200
  284. package/.agent/skills/mindforge-skill-creation/SKILL.md +0 -655
  285. package/.agent/skills/mindforge-skill-creation/anthropic-best-practices.md +0 -1150
  286. package/.agent/skills/mindforge-skill-creation/examples/CLAUDE_MD_TESTING.md +0 -189
  287. package/.agent/skills/mindforge-skill-creation/graphviz-conventions.dot +0 -172
  288. package/.agent/skills/mindforge-skill-creation/persuasion-principles.md +0 -187
  289. package/.agent/skills/mindforge-skill-creation/render-graphs.js +0 -168
  290. package/.agent/skills/mindforge-skill-creation/testing-skills-with-subagents.md +0 -384
  291. package/.agent/skills/mindforge-stats/SKILL.md +0 -16
  292. package/.agent/skills/mindforge-swarm-execution/SKILL.md +0 -277
  293. package/.agent/skills/mindforge-swarm-execution/code-quality-reviewer-prompt.md +0 -26
  294. package/.agent/skills/mindforge-swarm-execution/implementer-prompt.md +0 -113
  295. package/.agent/skills/mindforge-swarm-execution/spec-reviewer-prompt.md +0 -61
  296. package/.agent/skills/mindforge-system-architecture/SKILL.md +0 -136
  297. package/.agent/skills/mindforge-system-architecture/examples.md +0 -120
  298. package/.agent/skills/mindforge-system-architecture/scaling-checklist.md +0 -76
  299. package/.agent/skills/mindforge-tdd/SKILL.md +0 -112
  300. package/.agent/skills/mindforge-tdd/deep-modules.md +0 -21
  301. package/.agent/skills/mindforge-tdd/interface-design.md +0 -22
  302. package/.agent/skills/mindforge-tdd/mocking.md +0 -24
  303. package/.agent/skills/mindforge-tdd/refactoring.md +0 -21
  304. package/.agent/skills/mindforge-tdd/tests.md +0 -28
  305. package/.agent/skills/mindforge-tdd_extended/SKILL.md +0 -371
  306. package/.agent/skills/mindforge-tdd_extended/testing-anti-patterns.md +0 -299
  307. package/.agent/skills/mindforge-thread/SKILL.md +0 -123
  308. package/.agent/skills/mindforge-ui-phase/SKILL.md +0 -24
  309. package/.agent/skills/mindforge-ui-review/SKILL.md +0 -24
  310. package/.agent/skills/mindforge-update/SKILL.md +0 -35
  311. package/.agent/skills/mindforge-validate-phase/SKILL.md +0 -26
  312. package/.agent/skills/mindforge-verify-work/SKILL.md +0 -30
  313. package/.agent/skills/mindforge-verify-work_extended/SKILL.md +0 -139
  314. package/.agent/skills/mindforge-workspace-isolated/SKILL.md +0 -218
  315. package/.agent/skills/mindforge-workstreams/SKILL.md +0 -65
  316. package/.agent/workflows/forge:help.md +0 -10
  317. package/.agent/workflows/forge:init-project.md +0 -35
  318. package/.agent/workflows/forge:plan-phase.md +0 -33
  319. package/.agent/workflows/mindforge-add-phase.md +0 -112
  320. package/.agent/workflows/mindforge-add-tests.md +0 -351
  321. package/.agent/workflows/mindforge-add-todo.md +0 -158
  322. package/.agent/workflows/mindforge-audit-milestone.md +0 -332
  323. package/.agent/workflows/mindforge-audit-uat.md +0 -109
  324. package/.agent/workflows/mindforge-autonomous.md +0 -815
  325. package/.agent/workflows/mindforge-check-todos.md +0 -177
  326. package/.agent/workflows/mindforge-cleanup.md +0 -152
  327. package/.agent/workflows/mindforge-complete-milestone.md +0 -766
  328. package/.agent/workflows/mindforge-diagnose-issues.md +0 -220
  329. package/.agent/workflows/mindforge-discovery-phase.md +0 -289
  330. package/.agent/workflows/mindforge-discuss-phase-assumptions.md +0 -645
  331. package/.agent/workflows/mindforge-discuss-phase.md +0 -1047
  332. package/.agent/workflows/mindforge-do.md +0 -104
  333. package/.agent/workflows/mindforge-execute-phase.md +0 -838
  334. package/.agent/workflows/mindforge-execute-plan.md +0 -509
  335. package/.agent/workflows/mindforge-fast.md +0 -105
  336. package/.agent/workflows/mindforge-forensics.md +0 -265
  337. package/.agent/workflows/mindforge-health.md +0 -181
  338. package/.agent/workflows/mindforge-help.md +0 -606
  339. package/.agent/workflows/mindforge-insert-phase.md +0 -130
  340. package/.agent/workflows/mindforge-list-phase-assumptions.md +0 -178
  341. package/.agent/workflows/mindforge-list-workspaces.md +0 -56
  342. package/.agent/workflows/mindforge-manager.md +0 -360
  343. package/.agent/workflows/mindforge-map-codebase.md +0 -370
  344. package/.agent/workflows/mindforge-milestone-summary.md +0 -223
  345. package/.agent/workflows/mindforge-new-milestone.md +0 -469
  346. package/.agent/workflows/mindforge-new-project.md +0 -1226
  347. package/.agent/workflows/mindforge-new-workspace.md +0 -237
  348. package/.agent/workflows/mindforge-next.md +0 -97
  349. package/.agent/workflows/mindforge-node-repair.md +0 -92
  350. package/.agent/workflows/mindforge-note.md +0 -156
  351. package/.agent/workflows/mindforge-pause-work.md +0 -176
  352. package/.agent/workflows/mindforge-plan-milestone-gaps.md +0 -273
  353. package/.agent/workflows/mindforge-plan-phase.md +0 -877
  354. package/.agent/workflows/mindforge-plant-seed.md +0 -169
  355. package/.agent/workflows/mindforge-pr-branch.md +0 -129
  356. package/.agent/workflows/mindforge-profile-user.md +0 -450
  357. package/.agent/workflows/mindforge-progress.md +0 -507
  358. package/.agent/workflows/mindforge-quick.md +0 -732
  359. package/.agent/workflows/mindforge-remove-phase.md +0 -155
  360. package/.agent/workflows/mindforge-remove-workspace.md +0 -90
  361. package/.agent/workflows/mindforge-research-phase.md +0 -74
  362. package/.agent/workflows/mindforge-resume-project.md +0 -325
  363. package/.agent/workflows/mindforge-review.md +0 -228
  364. package/.agent/workflows/mindforge-session-report.md +0 -146
  365. package/.agent/workflows/mindforge-settings.md +0 -283
  366. package/.agent/workflows/mindforge-ship.md +0 -228
  367. package/.agent/workflows/mindforge-stats.md +0 -60
  368. package/.agent/workflows/mindforge-transition.md +0 -671
  369. package/.agent/workflows/mindforge-ui-phase.md +0 -290
  370. package/.agent/workflows/mindforge-ui-review.md +0 -157
  371. package/.agent/workflows/mindforge-update.md +0 -323
  372. package/.agent/workflows/mindforge-validate-phase.md +0 -167
  373. package/.agent/workflows/mindforge-verify-phase.md +0 -254
  374. package/.agent/workflows/mindforge-verify-work.md +0 -628
  375. package/.agent/workflows/mindforge:add-backlog.md +0 -24
  376. package/.agent/workflows/mindforge:agent.md +0 -25
  377. package/.agent/workflows/mindforge:approve.md +0 -21
  378. package/.agent/workflows/mindforge:architecture.md +0 -40
  379. package/.agent/workflows/mindforge:audit.md +0 -33
  380. package/.agent/workflows/mindforge:auto.md +0 -25
  381. package/.agent/workflows/mindforge:benchmark.md +0 -36
  382. package/.agent/workflows/mindforge:brainstorming.md +0 -16
  383. package/.agent/workflows/mindforge:browse.md +0 -29
  384. package/.agent/workflows/mindforge:complete-milestone.md +0 -21
  385. package/.agent/workflows/mindforge:costs.md +0 -14
  386. package/.agent/workflows/mindforge:cross-review.md +0 -20
  387. package/.agent/workflows/mindforge:dashboard.md +0 -101
  388. package/.agent/workflows/mindforge:debug.md +0 -131
  389. package/.agent/workflows/mindforge:discuss-phase.md +0 -141
  390. package/.agent/workflows/mindforge:do.md +0 -25
  391. package/.agent/workflows/mindforge:execute-phase.md +0 -205
  392. package/.agent/workflows/mindforge:executor.md +0 -18
  393. package/.agent/workflows/mindforge:health.md +0 -24
  394. package/.agent/workflows/mindforge:help.md +0 -26
  395. package/.agent/workflows/mindforge:identity.md +0 -18
  396. package/.agent/workflows/mindforge:init-org.md +0 -134
  397. package/.agent/workflows/mindforge:init-project.md +0 -185
  398. package/.agent/workflows/mindforge:install-skill.md +0 -27
  399. package/.agent/workflows/mindforge:learn.md +0 -146
  400. package/.agent/workflows/mindforge:map-codebase.md +0 -301
  401. package/.agent/workflows/mindforge:marketplace.md +0 -123
  402. package/.agent/workflows/mindforge:memory.md +0 -18
  403. package/.agent/workflows/mindforge:metrics.md +0 -25
  404. package/.agent/workflows/mindforge:migrate.md +0 -43
  405. package/.agent/workflows/mindforge:milestone.md +0 -15
  406. package/.agent/workflows/mindforge:new-runtime.md +0 -22
  407. package/.agent/workflows/mindforge:next.md +0 -108
  408. package/.agent/workflows/mindforge:note.md +0 -27
  409. package/.agent/workflows/mindforge:plan-phase.md +0 -139
  410. package/.agent/workflows/mindforge:planner.md +0 -18
  411. package/.agent/workflows/mindforge:plant-seed.md +0 -24
  412. package/.agent/workflows/mindforge:plugins.md +0 -43
  413. package/.agent/workflows/mindforge:pr-review.md +0 -44
  414. package/.agent/workflows/mindforge:profile-team.md +0 -26
  415. package/.agent/workflows/mindforge:publish-skill.md +0 -22
  416. package/.agent/workflows/mindforge:qa.md +0 -19
  417. package/.agent/workflows/mindforge:quick.md +0 -138
  418. package/.agent/workflows/mindforge:release.md +0 -13
  419. package/.agent/workflows/mindforge:remember.md +0 -29
  420. package/.agent/workflows/mindforge:research.md +0 -15
  421. package/.agent/workflows/mindforge:researcher.md +0 -18
  422. package/.agent/workflows/mindforge:retrospective.md +0 -29
  423. package/.agent/workflows/mindforge:review-backlog.md +0 -26
  424. package/.agent/workflows/mindforge:review.md +0 -160
  425. package/.agent/workflows/mindforge:reviewer.md +0 -18
  426. package/.agent/workflows/mindforge:security-scan.md +0 -236
  427. package/.agent/workflows/mindforge:session-report.md +0 -31
  428. package/.agent/workflows/mindforge:ship.md +0 -108
  429. package/.agent/workflows/mindforge:skills.md +0 -144
  430. package/.agent/workflows/mindforge:soul.md +0 -54
  431. package/.agent/workflows/mindforge:status.md +0 -107
  432. package/.agent/workflows/mindforge:steer.md +0 -16
  433. package/.agent/workflows/mindforge:sync-confluence.md +0 -14
  434. package/.agent/workflows/mindforge:sync-jira.md +0 -15
  435. package/.agent/workflows/mindforge:tdd.md +0 -46
  436. package/.agent/workflows/mindforge:tokens.md +0 -11
  437. package/.agent/workflows/mindforge:tool.md +0 -18
  438. package/.agent/workflows/mindforge:ui-phase.md +0 -27
  439. package/.agent/workflows/mindforge:ui-review.md +0 -28
  440. package/.agent/workflows/mindforge:update.md +0 -45
  441. package/.agent/workflows/mindforge:validate-phase.md +0 -25
  442. package/.agent/workflows/mindforge:verify-phase.md +0 -65
  443. package/.agent/workflows/mindforge:workspace.md +0 -32
  444. package/.agent/workflows/mindforge:workstreams.md +0 -27
  445. package/.agent/workflows/publish-release.md +0 -36
  446. package/.claude/CLAUDE.md +0 -102
  447. package/.claude/commands/forge/help.md +0 -7
  448. package/.claude/commands/forge/init-project.md +0 -32
  449. package/.claude/commands/forge/plan-phase.md +0 -30
  450. package/.claude/commands/mindforge/add-backlog.md +0 -32
  451. package/.claude/commands/mindforge/agent.md +0 -31
  452. package/.claude/commands/mindforge/approve.md +0 -22
  453. package/.claude/commands/mindforge/audit.md +0 -34
  454. package/.claude/commands/mindforge/auto.md +0 -26
  455. package/.claude/commands/mindforge/benchmark.md +0 -37
  456. package/.claude/commands/mindforge/browse.md +0 -30
  457. package/.claude/commands/mindforge/complete-milestone.md +0 -22
  458. package/.claude/commands/mindforge/costs.md +0 -15
  459. package/.claude/commands/mindforge/cross-review.md +0 -21
  460. package/.claude/commands/mindforge/dashboard.md +0 -102
  461. package/.claude/commands/mindforge/debug.md +0 -133
  462. package/.claude/commands/mindforge/discuss-phase.md +0 -142
  463. package/.claude/commands/mindforge/do.md +0 -31
  464. package/.claude/commands/mindforge/execute-phase.md +0 -200
  465. package/.claude/commands/mindforge/health.md +0 -31
  466. package/.claude/commands/mindforge/help.md +0 -33
  467. package/.claude/commands/mindforge/init-org.md +0 -135
  468. package/.claude/commands/mindforge/init-project.md +0 -170
  469. package/.claude/commands/mindforge/install-skill.md +0 -28
  470. package/.claude/commands/mindforge/learn.md +0 -147
  471. package/.claude/commands/mindforge/learning.md +0 -20
  472. package/.claude/commands/mindforge/map-codebase.md +0 -302
  473. package/.claude/commands/mindforge/marketplace.md +0 -124
  474. package/.claude/commands/mindforge/metrics.md +0 -26
  475. package/.claude/commands/mindforge/migrate.md +0 -44
  476. package/.claude/commands/mindforge/milestone.md +0 -16
  477. package/.claude/commands/mindforge/new-runtime.md +0 -23
  478. package/.claude/commands/mindforge/next.md +0 -109
  479. package/.claude/commands/mindforge/note.md +0 -35
  480. package/.claude/commands/mindforge/plan-phase.md +0 -131
  481. package/.claude/commands/mindforge/plant-seed.md +0 -31
  482. package/.claude/commands/mindforge/plugins.md +0 -44
  483. package/.claude/commands/mindforge/pr-review.md +0 -45
  484. package/.claude/commands/mindforge/profile-team.md +0 -27
  485. package/.claude/commands/mindforge/publish-skill.md +0 -23
  486. package/.claude/commands/mindforge/qa.md +0 -20
  487. package/.claude/commands/mindforge/quick.md +0 -139
  488. package/.claude/commands/mindforge/record-learning.md +0 -22
  489. package/.claude/commands/mindforge/release.md +0 -14
  490. package/.claude/commands/mindforge/remember.md +0 -30
  491. package/.claude/commands/mindforge/research.md +0 -16
  492. package/.claude/commands/mindforge/retrospective.md +0 -31
  493. package/.claude/commands/mindforge/review-backlog.md +0 -34
  494. package/.claude/commands/mindforge/review.md +0 -161
  495. package/.claude/commands/mindforge/security-scan.md +0 -242
  496. package/.claude/commands/mindforge/session-report.md +0 -39
  497. package/.claude/commands/mindforge/ship.md +0 -111
  498. package/.claude/commands/mindforge/skills.md +0 -145
  499. package/.claude/commands/mindforge/status.md +0 -113
  500. package/.claude/commands/mindforge/steer.md +0 -17
  501. package/.claude/commands/mindforge/sync-confluence.md +0 -15
  502. package/.claude/commands/mindforge/sync-jira.md +0 -16
  503. package/.claude/commands/mindforge/tokens.md +0 -12
  504. package/.claude/commands/mindforge/ui-phase.md +0 -34
  505. package/.claude/commands/mindforge/ui-review.md +0 -36
  506. package/.claude/commands/mindforge/update.md +0 -46
  507. package/.claude/commands/mindforge/validate-phase.md +0 -31
  508. package/.claude/commands/mindforge/verify-phase.md +0 -66
  509. package/.claude/commands/mindforge/workspace.md +0 -33
  510. package/.claude/commands/mindforge/workstreams.md +0 -35
  511. package/.claude/settings.local.json +0 -16
  512. package/.mindforge/audit/AUDIT-SCHEMA.md +0 -470
  513. package/.mindforge/browser/daemon-protocol.md +0 -24
  514. package/.mindforge/browser/qa-engine.md +0 -16
  515. package/.mindforge/browser/session-manager.md +0 -18
  516. package/.mindforge/browser/visual-verify-spec.md +0 -31
  517. package/.mindforge/celestial.db +0 -0
  518. package/.mindforge/ci/ci-config-schema.md +0 -21
  519. package/.mindforge/ci/ci-mode.md +0 -179
  520. package/.mindforge/ci/github-actions-adapter.md +0 -224
  521. package/.mindforge/ci/gitlab-ci-adapter.md +0 -31
  522. package/.mindforge/ci/jenkins-adapter.md +0 -44
  523. package/.mindforge/dashboard/api-reference.md +0 -122
  524. package/.mindforge/dashboard/dashboard-spec.md +0 -96
  525. package/.mindforge/distribution/marketplace.md +0 -53
  526. package/.mindforge/distribution/registry-client.md +0 -166
  527. package/.mindforge/distribution/registry-schema.md +0 -96
  528. package/.mindforge/distribution/skill-publisher.md +0 -44
  529. package/.mindforge/distribution/skill-validator.md +0 -74
  530. package/.mindforge/governance/GOVERNANCE-CONFIG.md +0 -17
  531. package/.mindforge/governance/approval-workflow.md +0 -37
  532. package/.mindforge/governance/change-classifier.md +0 -63
  533. package/.mindforge/governance/compliance-gates.md +0 -31
  534. package/.mindforge/governance/policies/sovereign-default.json +0 -16
  535. package/.mindforge/integrations/confluence.md +0 -27
  536. package/.mindforge/integrations/connection-manager.md +0 -163
  537. package/.mindforge/integrations/github.md +0 -25
  538. package/.mindforge/integrations/gitlab.md +0 -13
  539. package/.mindforge/integrations/jira.md +0 -102
  540. package/.mindforge/integrations/slack.md +0 -41
  541. package/.mindforge/intelligence/antipattern-detector.md +0 -75
  542. package/.mindforge/intelligence/difficulty-scorer.md +0 -55
  543. package/.mindforge/intelligence/health-engine.md +0 -208
  544. package/.mindforge/intelligence/skill-gap-analyser.md +0 -40
  545. package/.mindforge/intelligence/smart-compaction.md +0 -71
  546. package/.mindforge/memory/MEMORY-SCHEMA.md +0 -155
  547. package/.mindforge/memory/engine/capture-protocol.md +0 -36
  548. package/.mindforge/memory/engine/global-sync-spec.md +0 -42
  549. package/.mindforge/memory/engine/retrieval-spec.md +0 -44
  550. package/.mindforge/memory/sync-manifest.json +0 -6
  551. package/.mindforge/metrics/METRICS-SCHEMA.md +0 -42
  552. package/.mindforge/metrics/quality-tracker.md +0 -32
  553. package/.mindforge/models/model-registry.md +0 -48
  554. package/.mindforge/models/model-router.md +0 -30
  555. package/.mindforge/monorepo/cross-package-planner.md +0 -114
  556. package/.mindforge/monorepo/dependency-graph-builder.md +0 -32
  557. package/.mindforge/monorepo/workspace-detector.md +0 -129
  558. package/.mindforge/org/CONVENTIONS.md +0 -62
  559. package/.mindforge/org/ORG.md +0 -51
  560. package/.mindforge/org/SECURITY.md +0 -50
  561. package/.mindforge/org/TOOLS.md +0 -53
  562. package/.mindforge/org/integrations/INTEGRATIONS-CONFIG.md +0 -58
  563. package/.mindforge/org/skills/MANIFEST.md +0 -15
  564. package/.mindforge/plugins/PLUGINS-MANIFEST.md +0 -23
  565. package/.mindforge/plugins/plugin-loader.md +0 -93
  566. package/.mindforge/plugins/plugin-registry.md +0 -44
  567. package/.mindforge/plugins/plugin-schema.md +0 -68
  568. package/.mindforge/pr-review/ai-reviewer.md +0 -266
  569. package/.mindforge/pr-review/finding-formatter.md +0 -46
  570. package/.mindforge/pr-review/review-prompt-templates.md +0 -44
  571. package/.mindforge/production/compatibility-layer.md +0 -39
  572. package/.mindforge/production/migration-engine.md +0 -52
  573. package/.mindforge/production/production-checklist.md +0 -76
  574. package/.mindforge/production/token-optimiser.md +0 -68
  575. package/.mindforge/skills-builder/auto-capture-protocol.md +0 -88
  576. package/.mindforge/skills-builder/learn-protocol.md +0 -161
  577. package/.mindforge/skills-builder/quality-scoring.md +0 -120
  578. package/.mindforge/team/TEAM-PROFILE.md +0 -42
  579. package/.mindforge/team/multi-handoff.md +0 -23
  580. package/.mindforge/team/profiles/README.md +0 -13
  581. package/.mindforge/team/session-merger.md +0 -18
  582. package/.planning/ARCHITECTURE.md +0 -0
  583. package/.planning/HANDOFF.json +0 -8
  584. package/.planning/PROJECT.md +0 -33
  585. package/.planning/RELEASE-CHECKLIST.md +0 -68
  586. package/.planning/REQUIREMENTS.md +0 -35
  587. package/.planning/ROADMAP.md +0 -12
  588. package/.planning/STATE.md +0 -36
  589. package/.planning/approvals/.gitkeep +0 -1
  590. package/.planning/archive/.gitkeep +0 -1
  591. package/.planning/audit-archive/.gitkeep +0 -1
  592. package/.planning/decisions/.gitkeep +0 -0
  593. package/.planning/jira-sync.json +0 -1
  594. package/.planning/milestones/.gitkeep +0 -1
  595. package/.planning/phases/.gitkeep +0 -0
  596. package/.planning/research/.gitkeep +0 -0
  597. package/.planning/screenshots/.gitkeep +0 -0
  598. package/.planning/slack-threads.json +0 -1
  599. package/docs/CAPABILITIES-MANIFEST.md +0 -64
  600. package/docs/Context/Master-Context.md +0 -731
  601. package/docs/INTELLIGENCE-MESH.md +0 -37
  602. package/docs/MIND-FORGE-REFERENCE-V6.md +0 -96
  603. package/docs/PERSONAS.md +0 -960
  604. package/docs/References/audit-events.md +0 -59
  605. package/docs/References/checkpoints.md +0 -778
  606. package/docs/References/commands.md +0 -107
  607. package/docs/References/config-reference.md +0 -81
  608. package/docs/References/continuation-format.md +0 -249
  609. package/docs/References/decimal-phase-calculation.md +0 -64
  610. package/docs/References/git-integration.md +0 -295
  611. package/docs/References/git-planning-commit.md +0 -38
  612. package/docs/References/model-profile-resolution.md +0 -36
  613. package/docs/References/model-profiles.md +0 -139
  614. package/docs/References/phase-argument-parsing.md +0 -61
  615. package/docs/References/planning-config.md +0 -202
  616. package/docs/References/questioning.md +0 -162
  617. package/docs/References/sdk-api.md +0 -53
  618. package/docs/References/skills-api.md +0 -57
  619. package/docs/References/tdd.md +0 -263
  620. package/docs/References/ui-brand.md +0 -160
  621. package/docs/References/user-profiling.md +0 -681
  622. package/docs/References/verification-patterns.md +0 -612
  623. package/docs/References/workstream-flag.md +0 -58
  624. package/docs/Templates/Agents/CLAUDE-MD.md +0 -122
  625. package/docs/Templates/Agents/COPILOT-INSTRUCTIONS.md +0 -7
  626. package/docs/Templates/Agents/DEBUGGER-PROMPT.md +0 -91
  627. package/docs/Templates/Agents/PLANNER-PROMPT.md +0 -117
  628. package/docs/Templates/Codebase/architecture.md +0 -255
  629. package/docs/Templates/Codebase/concerns.md +0 -310
  630. package/docs/Templates/Codebase/conventions.md +0 -307
  631. package/docs/Templates/Codebase/integrations.md +0 -280
  632. package/docs/Templates/Codebase/stack.md +0 -186
  633. package/docs/Templates/Codebase/structure.md +0 -285
  634. package/docs/Templates/Codebase/testing.md +0 -480
  635. package/docs/Templates/Execution/CONTINUE-HERE.md +0 -78
  636. package/docs/Templates/Execution/DISCUSSION-LOG.md +0 -63
  637. package/docs/Templates/Execution/PHASE-PROMPT.md +0 -610
  638. package/docs/Templates/Execution/STATE.md +0 -176
  639. package/docs/Templates/Execution/SUMMARY-COMPLEX.md +0 -59
  640. package/docs/Templates/Execution/SUMMARY-MINIMAL.md +0 -41
  641. package/docs/Templates/Execution/SUMMARY-STANDARD.md +0 -48
  642. package/docs/Templates/Execution/SUMMARY.md +0 -248
  643. package/docs/Templates/Profile/DEV-PREFERENCES.md +0 -21
  644. package/docs/Templates/Profile/USER-PROFILE.md +0 -146
  645. package/docs/Templates/Profile/USER-SETUP.md +0 -311
  646. package/docs/Templates/Project/AGENTS_LEARNING.md +0 -88
  647. package/docs/Templates/Project/DISCOVERY.md +0 -146
  648. package/docs/Templates/Project/MILESTONE-ARCHIVE.md +0 -123
  649. package/docs/Templates/Project/MILESTONE.md +0 -115
  650. package/docs/Templates/Project/PROJECT.md +0 -206
  651. package/docs/Templates/Project/REQUIREMENTS.md +0 -231
  652. package/docs/Templates/Project/RETROSPECTIVE.md +0 -54
  653. package/docs/Templates/Project/ROADMAP.md +0 -202
  654. package/docs/Templates/Quality/DEBUG.md +0 -164
  655. package/docs/Templates/Quality/UAT.md +0 -280
  656. package/docs/Templates/Quality/UI-SPEC.md +0 -100
  657. package/docs/Templates/Quality/VALIDATION.md +0 -76
  658. package/docs/Templates/Quality/VERIFICATION-REPORT.md +0 -322
  659. package/docs/Templates/Research/ARCHITECTURE.md +0 -204
  660. package/docs/Templates/Research/FEATURES.md +0 -147
  661. package/docs/Templates/Research/PITFALLS.md +0 -200
  662. package/docs/Templates/Research/STACK.md +0 -120
  663. package/docs/Templates/Research/SUMMARY.md +0 -170
  664. package/docs/Templates/System/CONFIG.json +0 -43
  665. package/docs/Templates/System/CONTEXT.md +0 -352
  666. package/docs/adr/ADR-024-browser-localhost-only.md +0 -17
  667. package/docs/adr/ADR-025-visual-verify-failure-treatment.md +0 -19
  668. package/docs/adr/ADR-026-session-persistence-security.md +0 -20
  669. package/docs/adr/ADR-042-ads-protocol.md +0 -30
  670. package/docs/architecture/NEXUS-DASHBOARD.md +0 -35
  671. package/docs/architecture/PAR-ZTS-SURVEY.md +0 -43
  672. package/docs/architecture/README.md +0 -78
  673. package/docs/architecture/V3-CORE.md +0 -52
  674. package/docs/architecture/V4-SWARM-MESH.md +0 -77
  675. package/docs/architecture/V5-ENTERPRISE.md +0 -131
  676. package/docs/architecture/V6-SOVEREIGN.md +0 -43
  677. package/docs/architecture/V8-SRE.md +0 -88
  678. package/docs/architecture/V9-BEDROCK.md +0 -162
  679. package/docs/architecture/adr-039-multi-runtime-support.md +0 -20
  680. package/docs/architecture/adr-040-additive-schema-migration.md +0 -21
  681. package/docs/architecture/adr-041-stable-runtime-interface-contract.md +0 -20
  682. package/docs/architecture/decision-records-index.md +0 -29
  683. package/docs/ci-cd-integration.md +0 -30
  684. package/docs/ci-cd.md +0 -92
  685. package/docs/ci-quickstart.md +0 -78
  686. package/docs/commands-skills/DISCOVERED_SKILLS.md +0 -21
  687. package/docs/contributing/CONTRIBUTING.md +0 -38
  688. package/docs/contributing/plugin-authoring.md +0 -50
  689. package/docs/contributing/skill-authoring.md +0 -41
  690. package/docs/enterprise-setup.md +0 -25
  691. package/docs/feature-dashboard.md +0 -63
  692. package/docs/governance-guide.md +0 -134
  693. package/docs/monorepo-guide.md +0 -26
  694. package/docs/persona-customisation.md +0 -56
  695. package/docs/publishing-guide.md +0 -43
  696. package/docs/quick-verify.md +0 -33
  697. package/docs/registry/AGENTS.md +0 -37
  698. package/docs/registry/COMMANDS.md +0 -87
  699. package/docs/registry/HOOKS.md +0 -38
  700. package/docs/registry/PERSONAS.md +0 -64
  701. package/docs/registry/README.md +0 -27
  702. package/docs/registry/SKILLS.md +0 -142
  703. package/docs/registry/WORKFLOWS.md +0 -72
  704. package/docs/release-checklist-guide.md +0 -37
  705. package/docs/requirements.md +0 -29
  706. package/docs/security/SECURITY.md +0 -55
  707. package/docs/security/ZTAI-OVERVIEW.md +0 -37
  708. package/docs/security/penetration-test-results.md +0 -31
  709. package/docs/security/threat-model.md +0 -142
  710. package/docs/skills-authoring-guide.md +0 -176
  711. package/docs/skills-publishing-guide.md +0 -22
  712. package/docs/team-setup-guide.md +0 -21
  713. package/docs/testing-current-version.md +0 -130
  714. package/docs/tutorial.md +0 -162
  715. package/docs/upgrade.md +0 -58
  716. package/docs/usp-features.md +0 -102
  717. package/docs/workflow-atlas.md +0 -57
@@ -1,1336 +0,0 @@
1
- /**
2
- * Init — Compound init commands for workflow bootstrapping
3
- */
4
-
5
- const fs = require('fs');
6
- const path = require('path');
7
- const { execSync } = require('child_process');
8
- const { loadConfig, resolveModelInternal, findPhaseInternal, getRoadmapPhaseInternal, pathExistsInternal, generateSlugInternal, getMilestoneInfo, getMilestonePhaseFilter, stripShippedMilestones, extractCurrentMilestone, normalizePhaseName, planningPaths, planningDir, planningRoot, toPosixPath, output, error } = require('./core.cjs');
9
-
10
- function getLatestCompletedMilestone(cwd) {
11
- const milestonesPath = path.join(planningRoot(cwd), 'MILESTONES.md');
12
- if (!fs.existsSync(milestonesPath)) return null;
13
-
14
- try {
15
- const content = fs.readFileSync(milestonesPath, 'utf-8');
16
- const match = content.match(/^##\s+(v[\d.]+)\s+(.+?)\s+\(Shipped:/m);
17
- if (!match) return null;
18
- return {
19
- version: match[1],
20
- name: match[2].trim(),
21
- };
22
- } catch {
23
- return null;
24
- }
25
- }
26
-
27
- /**
28
- * Inject `project_root` into an init result object.
29
- * Workflows use this to prefix `.planning/` paths correctly when the agent's CWD
30
- * differs from the project root (e.g., inside a sub-repo).
31
- */
32
- function withProjectRoot(cwd, result) {
33
- result.project_root = cwd;
34
- return result;
35
- }
36
-
37
- function cmdInitExecutePhase(cwd, phase, raw) {
38
- if (!phase) {
39
- error('phase required for init execute-phase');
40
- }
41
-
42
- const config = loadConfig(cwd);
43
- let phaseInfo = findPhaseInternal(cwd, phase);
44
- const milestone = getMilestoneInfo(cwd);
45
-
46
- const roadmapPhase = getRoadmapPhaseInternal(cwd, phase);
47
-
48
- // Fallback to ROADMAP.md if no phase directory exists yet
49
- if (!phaseInfo && roadmapPhase?.found) {
50
- const phaseName = roadmapPhase.phase_name;
51
- phaseInfo = {
52
- found: true,
53
- directory: null,
54
- phase_number: roadmapPhase.phase_number,
55
- phase_name: phaseName,
56
- phase_slug: phaseName ? phaseName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') : null,
57
- plans: [],
58
- summaries: [],
59
- incomplete_plans: [],
60
- has_research: false,
61
- has_context: false,
62
- has_verification: false,
63
- has_reviews: false,
64
- };
65
- }
66
- const reqMatch = roadmapPhase?.section?.match(/^\*\*Requirements\*\*:[^\S\n]*([^\n]*)$/m);
67
- const reqExtracted = reqMatch
68
- ? reqMatch[1].replace(/[\[\]]/g, '').split(',').map(s => s.trim()).filter(Boolean).join(', ')
69
- : null;
70
- const phase_req_ids = (reqExtracted && reqExtracted !== 'TBD') ? reqExtracted : null;
71
-
72
- const result = {
73
- // Models
74
- executor_model: resolveModelInternal(cwd, 'mindforge-executor'),
75
- verifier_model: resolveModelInternal(cwd, 'mindforge-verifier'),
76
-
77
- // Config flags
78
- commit_docs: config.commit_docs,
79
- sub_repos: config.sub_repos,
80
- parallelization: config.parallelization,
81
- context_window: config.context_window,
82
- branching_strategy: config.branching_strategy,
83
- phase_branch_template: config.phase_branch_template,
84
- milestone_branch_template: config.milestone_branch_template,
85
- verifier_enabled: config.verifier,
86
-
87
- // Phase info
88
- phase_found: !!phaseInfo,
89
- phase_dir: phaseInfo?.directory || null,
90
- phase_number: phaseInfo?.phase_number || null,
91
- phase_name: phaseInfo?.phase_name || null,
92
- phase_slug: phaseInfo?.phase_slug || null,
93
- phase_req_ids,
94
-
95
- // Plan inventory
96
- plans: phaseInfo?.plans || [],
97
- summaries: phaseInfo?.summaries || [],
98
- incomplete_plans: phaseInfo?.incomplete_plans || [],
99
- plan_count: phaseInfo?.plans?.length || 0,
100
- incomplete_count: phaseInfo?.incomplete_plans?.length || 0,
101
-
102
- // Branch name (pre-computed)
103
- branch_name: config.branching_strategy === 'phase' && phaseInfo
104
- ? config.phase_branch_template
105
- .replace('{phase}', phaseInfo.phase_number)
106
- .replace('{slug}', phaseInfo.phase_slug || 'phase')
107
- : config.branching_strategy === 'milestone'
108
- ? config.milestone_branch_template
109
- .replace('{milestone}', milestone.version)
110
- .replace('{slug}', generateSlugInternal(milestone.name) || 'milestone')
111
- : null,
112
-
113
- // Milestone info
114
- milestone_version: milestone.version,
115
- milestone_name: milestone.name,
116
- milestone_slug: generateSlugInternal(milestone.name),
117
-
118
- // File existence
119
- state_exists: fs.existsSync(path.join(planningDir(cwd), 'STATE.md')),
120
- roadmap_exists: fs.existsSync(path.join(planningDir(cwd), 'ROADMAP.md')),
121
- config_exists: fs.existsSync(path.join(planningDir(cwd), 'config.json')),
122
- // File paths
123
- state_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'STATE.md'))),
124
- roadmap_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'ROADMAP.md'))),
125
- config_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'config.json'))),
126
- };
127
-
128
- output(withProjectRoot(cwd, result), raw);
129
- }
130
-
131
- function cmdInitPlanPhase(cwd, phase, raw) {
132
- if (!phase) {
133
- error('phase required for init plan-phase');
134
- }
135
-
136
- const config = loadConfig(cwd);
137
- let phaseInfo = findPhaseInternal(cwd, phase);
138
-
139
- const roadmapPhase = getRoadmapPhaseInternal(cwd, phase);
140
-
141
- // Fallback to ROADMAP.md if no phase directory exists yet
142
- if (!phaseInfo && roadmapPhase?.found) {
143
- const phaseName = roadmapPhase.phase_name;
144
- phaseInfo = {
145
- found: true,
146
- directory: null,
147
- phase_number: roadmapPhase.phase_number,
148
- phase_name: phaseName,
149
- phase_slug: phaseName ? phaseName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') : null,
150
- plans: [],
151
- summaries: [],
152
- incomplete_plans: [],
153
- has_research: false,
154
- has_context: false,
155
- has_verification: false,
156
- has_reviews: false,
157
- };
158
- }
159
- const reqMatch = roadmapPhase?.section?.match(/^\*\*Requirements\*\*:[^\S\n]*([^\n]*)$/m);
160
- const reqExtracted = reqMatch
161
- ? reqMatch[1].replace(/[\[\]]/g, '').split(',').map(s => s.trim()).filter(Boolean).join(', ')
162
- : null;
163
- const phase_req_ids = (reqExtracted && reqExtracted !== 'TBD') ? reqExtracted : null;
164
-
165
- const result = {
166
- // Models
167
- researcher_model: resolveModelInternal(cwd, 'mindforge-phase-researcher'),
168
- planner_model: resolveModelInternal(cwd, 'mindforge-planner'),
169
- checker_model: resolveModelInternal(cwd, 'mindforge-plan-checker'),
170
-
171
- // Workflow flags
172
- research_enabled: config.research,
173
- plan_checker_enabled: config.plan_checker,
174
- nyquist_validation_enabled: config.nyquist_validation,
175
- commit_docs: config.commit_docs,
176
- text_mode: config.text_mode,
177
-
178
- // Phase info
179
- phase_found: !!phaseInfo,
180
- phase_dir: phaseInfo?.directory || null,
181
- phase_number: phaseInfo?.phase_number || null,
182
- phase_name: phaseInfo?.phase_name || null,
183
- phase_slug: phaseInfo?.phase_slug || null,
184
- padded_phase: phaseInfo?.phase_number ? normalizePhaseName(phaseInfo.phase_number) : null,
185
- phase_req_ids,
186
-
187
- // Existing artifacts
188
- has_research: phaseInfo?.has_research || false,
189
- has_context: phaseInfo?.has_context || false,
190
- has_reviews: phaseInfo?.has_reviews || false,
191
- has_plans: (phaseInfo?.plans?.length || 0) > 0,
192
- plan_count: phaseInfo?.plans?.length || 0,
193
-
194
- // Environment
195
- planning_exists: fs.existsSync(planningDir(cwd)),
196
- roadmap_exists: fs.existsSync(path.join(planningDir(cwd), 'ROADMAP.md')),
197
-
198
- // File paths
199
- state_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'STATE.md'))),
200
- roadmap_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'ROADMAP.md'))),
201
- requirements_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'REQUIREMENTS.md'))),
202
- };
203
-
204
- if (phaseInfo?.directory) {
205
- // Find *-CONTEXT.md in phase directory
206
- const phaseDirFull = path.join(cwd, phaseInfo.directory);
207
- try {
208
- const files = fs.readdirSync(phaseDirFull);
209
- const contextFile = files.find(f => f.endsWith('-CONTEXT.md') || f === 'CONTEXT.md');
210
- if (contextFile) {
211
- result.context_path = toPosixPath(path.join(phaseInfo.directory, contextFile));
212
- }
213
- const researchFile = files.find(f => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md');
214
- if (researchFile) {
215
- result.research_path = toPosixPath(path.join(phaseInfo.directory, researchFile));
216
- }
217
- const verificationFile = files.find(f => f.endsWith('-VERIFICATION.md') || f === 'VERIFICATION.md');
218
- if (verificationFile) {
219
- result.verification_path = toPosixPath(path.join(phaseInfo.directory, verificationFile));
220
- }
221
- const uatFile = files.find(f => f.endsWith('-UAT.md') || f === 'UAT.md');
222
- if (uatFile) {
223
- result.uat_path = toPosixPath(path.join(phaseInfo.directory, uatFile));
224
- }
225
- const reviewsFile = files.find(f => f.endsWith('-REVIEWS.md') || f === 'REVIEWS.md');
226
- if (reviewsFile) {
227
- result.reviews_path = toPosixPath(path.join(phaseInfo.directory, reviewsFile));
228
- }
229
- } catch { /* intentionally empty */ }
230
- }
231
-
232
- output(withProjectRoot(cwd, result), raw);
233
- }
234
-
235
- function cmdInitNewProject(cwd, raw) {
236
- const config = loadConfig(cwd);
237
-
238
- // Detect Brave Search API key availability
239
- const homedir = require('os').homedir();
240
- const braveKeyFile = path.join(homedir, '.mindforge', 'brave_api_key');
241
- const hasBraveSearch = !!(process.env.BRAVE_API_KEY || fs.existsSync(braveKeyFile));
242
-
243
- // Detect Firecrawl API key availability
244
- const firecrawlKeyFile = path.join(homedir, '.mindforge', 'firecrawl_api_key');
245
- const hasFirecrawl = !!(process.env.FIRECRAWL_API_KEY || fs.existsSync(firecrawlKeyFile));
246
-
247
- // Detect Exa API key availability
248
- const exaKeyFile = path.join(homedir, '.mindforge', 'exa_api_key');
249
- const hasExaSearch = !!(process.env.EXA_API_KEY || fs.existsSync(exaKeyFile));
250
-
251
- // Detect existing code (cross-platform — no Unix `find` dependency)
252
- let hasCode = false;
253
- let hasPackageFile = false;
254
- try {
255
- const codeExtensions = new Set(['.ts', '.js', '.py', '.go', '.rs', '.swift', '.java']);
256
- const skipDirs = new Set(['node_modules', '.git', '.planning', '.claude', '__pycache__', 'target', 'dist', 'build']);
257
- function findCodeFiles(dir, depth) {
258
- if (depth > 3) return false;
259
- let entries;
260
- try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return false; }
261
- for (const entry of entries) {
262
- if (entry.isFile() && codeExtensions.has(path.extname(entry.name))) return true;
263
- if (entry.isDirectory() && !skipDirs.has(entry.name)) {
264
- if (findCodeFiles(path.join(dir, entry.name), depth + 1)) return true;
265
- }
266
- }
267
- return false;
268
- }
269
- hasCode = findCodeFiles(cwd, 0);
270
- } catch { /* intentionally empty — best-effort detection */ }
271
-
272
- hasPackageFile = pathExistsInternal(cwd, 'package.json') ||
273
- pathExistsInternal(cwd, 'requirements.txt') ||
274
- pathExistsInternal(cwd, 'Cargo.toml') ||
275
- pathExistsInternal(cwd, 'go.mod') ||
276
- pathExistsInternal(cwd, 'Package.swift');
277
-
278
- const result = {
279
- // Models
280
- researcher_model: resolveModelInternal(cwd, 'mindforge-project-researcher'),
281
- synthesizer_model: resolveModelInternal(cwd, 'mindforge-research-synthesizer'),
282
- roadmapper_model: resolveModelInternal(cwd, 'mindforge-roadmapper'),
283
-
284
- // Config
285
- commit_docs: config.commit_docs,
286
-
287
- // Existing state
288
- project_exists: pathExistsInternal(cwd, '.planning/PROJECT.md'),
289
- has_codebase_map: pathExistsInternal(cwd, '.planning/codebase'),
290
- planning_exists: pathExistsInternal(cwd, '.planning'),
291
-
292
- // Brownfield detection
293
- has_existing_code: hasCode,
294
- has_package_file: hasPackageFile,
295
- is_brownfield: hasCode || hasPackageFile,
296
- needs_codebase_map: (hasCode || hasPackageFile) && !pathExistsInternal(cwd, '.planning/codebase'),
297
-
298
- // Git state
299
- has_git: pathExistsInternal(cwd, '.git'),
300
-
301
- // Enhanced search
302
- brave_search_available: hasBraveSearch,
303
- firecrawl_available: hasFirecrawl,
304
- exa_search_available: hasExaSearch,
305
-
306
- // File paths
307
- project_path: '.planning/PROJECT.md',
308
- };
309
-
310
- output(withProjectRoot(cwd, result), raw);
311
- }
312
-
313
- function cmdInitNewMilestone(cwd, raw) {
314
- const config = loadConfig(cwd);
315
- const milestone = getMilestoneInfo(cwd);
316
- const latestCompleted = getLatestCompletedMilestone(cwd);
317
- const phasesDir = path.join(planningDir(cwd), 'phases');
318
- let phaseDirCount = 0;
319
-
320
- try {
321
- if (fs.existsSync(phasesDir)) {
322
- phaseDirCount = fs.readdirSync(phasesDir, { withFileTypes: true })
323
- .filter(entry => entry.isDirectory())
324
- .length;
325
- }
326
- } catch {}
327
-
328
- const result = {
329
- // Models
330
- researcher_model: resolveModelInternal(cwd, 'mindforge-project-researcher'),
331
- synthesizer_model: resolveModelInternal(cwd, 'mindforge-research-synthesizer'),
332
- roadmapper_model: resolveModelInternal(cwd, 'mindforge-roadmapper'),
333
-
334
- // Config
335
- commit_docs: config.commit_docs,
336
- research_enabled: config.research,
337
-
338
- // Current milestone
339
- current_milestone: milestone.version,
340
- current_milestone_name: milestone.name,
341
- latest_completed_milestone: latestCompleted?.version || null,
342
- latest_completed_milestone_name: latestCompleted?.name || null,
343
- phase_dir_count: phaseDirCount,
344
- phase_archive_path: latestCompleted ? toPosixPath(path.relative(cwd, path.join(planningRoot(cwd), 'milestones', `${latestCompleted.version}-phases`))) : null,
345
-
346
- // File existence
347
- project_exists: pathExistsInternal(cwd, '.planning/PROJECT.md'),
348
- roadmap_exists: fs.existsSync(path.join(planningDir(cwd), 'ROADMAP.md')),
349
- state_exists: fs.existsSync(path.join(planningDir(cwd), 'STATE.md')),
350
-
351
- // File paths
352
- project_path: '.planning/PROJECT.md',
353
- roadmap_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'ROADMAP.md'))),
354
- state_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'STATE.md'))),
355
- };
356
-
357
- output(withProjectRoot(cwd, result), raw);
358
- }
359
-
360
- function cmdInitQuick(cwd, description, raw) {
361
- const config = loadConfig(cwd);
362
- const now = new Date();
363
- const slug = description ? generateSlugInternal(description)?.substring(0, 40) : null;
364
-
365
- // Generate collision-resistant quick task ID: YYMMDD-xxx
366
- // xxx = 2-second precision blocks since midnight, encoded as 3-char Base36 (lowercase)
367
- // Range: 000 (00:00:00) to xbz (23:59:58), guaranteed 3 chars for any time of day.
368
- // Provides ~2s uniqueness window per user — practically collision-free across a team.
369
- const yy = String(now.getFullYear()).slice(-2);
370
- const mm = String(now.getMonth() + 1).padStart(2, '0');
371
- const dd = String(now.getDate()).padStart(2, '0');
372
- const dateStr = yy + mm + dd;
373
- const secondsSinceMidnight = now.getHours() * 3600 + now.getMinutes() * 60 + now.getSeconds();
374
- const timeBlocks = Math.floor(secondsSinceMidnight / 2);
375
- const timeEncoded = timeBlocks.toString(36).padStart(3, '0');
376
- const quickId = dateStr + '-' + timeEncoded;
377
- const branchSlug = slug || 'quick';
378
- const quickBranchName = config.quick_branch_template
379
- ? config.quick_branch_template
380
- .replace('{num}', quickId)
381
- .replace('{quick}', quickId)
382
- .replace('{slug}', branchSlug)
383
- : null;
384
-
385
- const result = {
386
- // Models
387
- planner_model: resolveModelInternal(cwd, 'mindforge-planner'),
388
- executor_model: resolveModelInternal(cwd, 'mindforge-executor'),
389
- checker_model: resolveModelInternal(cwd, 'mindforge-plan-checker'),
390
- verifier_model: resolveModelInternal(cwd, 'mindforge-verifier'),
391
-
392
- // Config
393
- commit_docs: config.commit_docs,
394
- branch_name: quickBranchName,
395
-
396
- // Quick task info
397
- quick_id: quickId,
398
- slug: slug,
399
- description: description || null,
400
-
401
- // Timestamps
402
- date: now.toISOString().split('T')[0],
403
- timestamp: now.toISOString(),
404
-
405
- // Paths
406
- quick_dir: '.planning/quick',
407
- task_dir: slug ? `.planning/quick/${quickId}-${slug}` : null,
408
-
409
- // File existence
410
- roadmap_exists: fs.existsSync(path.join(planningDir(cwd), 'ROADMAP.md')),
411
- planning_exists: fs.existsSync(planningRoot(cwd)),
412
-
413
- };
414
-
415
- output(withProjectRoot(cwd, result), raw);
416
- }
417
-
418
- function cmdInitResume(cwd, raw) {
419
- const config = loadConfig(cwd);
420
-
421
- // Check for interrupted agent
422
- let interruptedAgentId = null;
423
- try {
424
- interruptedAgentId = fs.readFileSync(path.join(planningRoot(cwd), 'current-agent-id.txt'), 'utf-8').trim();
425
- } catch { /* intentionally empty */ }
426
-
427
- const result = {
428
- // File existence
429
- state_exists: fs.existsSync(path.join(planningDir(cwd), 'STATE.md')),
430
- roadmap_exists: fs.existsSync(path.join(planningDir(cwd), 'ROADMAP.md')),
431
- project_exists: pathExistsInternal(cwd, '.planning/PROJECT.md'),
432
- planning_exists: fs.existsSync(planningRoot(cwd)),
433
-
434
- // File paths
435
- state_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'STATE.md'))),
436
- roadmap_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'ROADMAP.md'))),
437
- project_path: '.planning/PROJECT.md',
438
-
439
- // Agent state
440
- has_interrupted_agent: !!interruptedAgentId,
441
- interrupted_agent_id: interruptedAgentId,
442
-
443
- // Config
444
- commit_docs: config.commit_docs,
445
- };
446
-
447
- output(withProjectRoot(cwd, result), raw);
448
- }
449
-
450
- function cmdInitVerifyWork(cwd, phase, raw) {
451
- if (!phase) {
452
- error('phase required for init verify-work');
453
- }
454
-
455
- const config = loadConfig(cwd);
456
- let phaseInfo = findPhaseInternal(cwd, phase);
457
-
458
- // Fallback to ROADMAP.md if no phase directory exists yet
459
- if (!phaseInfo) {
460
- const roadmapPhase = getRoadmapPhaseInternal(cwd, phase);
461
- if (roadmapPhase?.found) {
462
- const phaseName = roadmapPhase.phase_name;
463
- phaseInfo = {
464
- found: true,
465
- directory: null,
466
- phase_number: roadmapPhase.phase_number,
467
- phase_name: phaseName,
468
- phase_slug: phaseName ? phaseName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') : null,
469
- plans: [],
470
- summaries: [],
471
- incomplete_plans: [],
472
- has_research: false,
473
- has_context: false,
474
- has_verification: false,
475
- };
476
- }
477
- }
478
-
479
- const result = {
480
- // Models
481
- planner_model: resolveModelInternal(cwd, 'mindforge-planner'),
482
- checker_model: resolveModelInternal(cwd, 'mindforge-plan-checker'),
483
-
484
- // Config
485
- commit_docs: config.commit_docs,
486
-
487
- // Phase info
488
- phase_found: !!phaseInfo,
489
- phase_dir: phaseInfo?.directory || null,
490
- phase_number: phaseInfo?.phase_number || null,
491
- phase_name: phaseInfo?.phase_name || null,
492
-
493
- // Existing artifacts
494
- has_verification: phaseInfo?.has_verification || false,
495
- };
496
-
497
- output(withProjectRoot(cwd, result), raw);
498
- }
499
-
500
- function cmdInitPhaseOp(cwd, phase, raw) {
501
- const config = loadConfig(cwd);
502
- let phaseInfo = findPhaseInternal(cwd, phase);
503
-
504
- // If the only disk match comes from an archived milestone, prefer the
505
- // current milestone's ROADMAP entry so discuss-phase and similar flows
506
- // don't attach to shipped work that reused the same phase number.
507
- if (phaseInfo?.archived) {
508
- const roadmapPhase = getRoadmapPhaseInternal(cwd, phase);
509
- if (roadmapPhase?.found) {
510
- const phaseName = roadmapPhase.phase_name;
511
- phaseInfo = {
512
- found: true,
513
- directory: null,
514
- phase_number: roadmapPhase.phase_number,
515
- phase_name: phaseName,
516
- phase_slug: phaseName ? phaseName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') : null,
517
- plans: [],
518
- summaries: [],
519
- incomplete_plans: [],
520
- has_research: false,
521
- has_context: false,
522
- has_verification: false,
523
- };
524
- }
525
- }
526
-
527
- // Fallback to ROADMAP.md if no directory exists (e.g., Plans: TBD)
528
- if (!phaseInfo) {
529
- const roadmapPhase = getRoadmapPhaseInternal(cwd, phase);
530
- if (roadmapPhase?.found) {
531
- const phaseName = roadmapPhase.phase_name;
532
- phaseInfo = {
533
- found: true,
534
- directory: null,
535
- phase_number: roadmapPhase.phase_number,
536
- phase_name: phaseName,
537
- phase_slug: phaseName ? phaseName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') : null,
538
- plans: [],
539
- summaries: [],
540
- incomplete_plans: [],
541
- has_research: false,
542
- has_context: false,
543
- has_verification: false,
544
- };
545
- }
546
- }
547
-
548
- const result = {
549
- // Config
550
- commit_docs: config.commit_docs,
551
- brave_search: config.brave_search,
552
- firecrawl: config.firecrawl,
553
- exa_search: config.exa_search,
554
-
555
- // Phase info
556
- phase_found: !!phaseInfo,
557
- phase_dir: phaseInfo?.directory || null,
558
- phase_number: phaseInfo?.phase_number || null,
559
- phase_name: phaseInfo?.phase_name || null,
560
- phase_slug: phaseInfo?.phase_slug || null,
561
- padded_phase: phaseInfo?.phase_number ? normalizePhaseName(phaseInfo.phase_number) : null,
562
-
563
- // Existing artifacts
564
- has_research: phaseInfo?.has_research || false,
565
- has_context: phaseInfo?.has_context || false,
566
- has_plans: (phaseInfo?.plans?.length || 0) > 0,
567
- has_verification: phaseInfo?.has_verification || false,
568
- has_reviews: phaseInfo?.has_reviews || false,
569
- plan_count: phaseInfo?.plans?.length || 0,
570
-
571
- // File existence
572
- roadmap_exists: fs.existsSync(path.join(planningDir(cwd), 'ROADMAP.md')),
573
- planning_exists: fs.existsSync(planningDir(cwd)),
574
-
575
- // File paths
576
- state_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'STATE.md'))),
577
- roadmap_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'ROADMAP.md'))),
578
- requirements_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'REQUIREMENTS.md'))),
579
- };
580
-
581
- if (phaseInfo?.directory) {
582
- const phaseDirFull = path.join(cwd, phaseInfo.directory);
583
- try {
584
- const files = fs.readdirSync(phaseDirFull);
585
- const contextFile = files.find(f => f.endsWith('-CONTEXT.md') || f === 'CONTEXT.md');
586
- if (contextFile) {
587
- result.context_path = toPosixPath(path.join(phaseInfo.directory, contextFile));
588
- }
589
- const researchFile = files.find(f => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md');
590
- if (researchFile) {
591
- result.research_path = toPosixPath(path.join(phaseInfo.directory, researchFile));
592
- }
593
- const verificationFile = files.find(f => f.endsWith('-VERIFICATION.md') || f === 'VERIFICATION.md');
594
- if (verificationFile) {
595
- result.verification_path = toPosixPath(path.join(phaseInfo.directory, verificationFile));
596
- }
597
- const uatFile = files.find(f => f.endsWith('-UAT.md') || f === 'UAT.md');
598
- if (uatFile) {
599
- result.uat_path = toPosixPath(path.join(phaseInfo.directory, uatFile));
600
- }
601
- const reviewsFile = files.find(f => f.endsWith('-REVIEWS.md') || f === 'REVIEWS.md');
602
- if (reviewsFile) {
603
- result.reviews_path = toPosixPath(path.join(phaseInfo.directory, reviewsFile));
604
- }
605
- } catch { /* intentionally empty */ }
606
- }
607
-
608
- output(withProjectRoot(cwd, result), raw);
609
- }
610
-
611
- function cmdInitTodos(cwd, area, raw) {
612
- const config = loadConfig(cwd);
613
- const now = new Date();
614
-
615
- // List todos (reuse existing logic)
616
- const pendingDir = path.join(planningDir(cwd), 'todos', 'pending');
617
- let count = 0;
618
- const todos = [];
619
-
620
- try {
621
- const files = fs.readdirSync(pendingDir).filter(f => f.endsWith('.md'));
622
- for (const file of files) {
623
- try {
624
- const content = fs.readFileSync(path.join(pendingDir, file), 'utf-8');
625
- const createdMatch = content.match(/^created:\s*(.+)$/m);
626
- const titleMatch = content.match(/^title:\s*(.+)$/m);
627
- const areaMatch = content.match(/^area:\s*(.+)$/m);
628
- const todoArea = areaMatch ? areaMatch[1].trim() : 'general';
629
-
630
- if (area && todoArea !== area) continue;
631
-
632
- count++;
633
- todos.push({
634
- file,
635
- created: createdMatch ? createdMatch[1].trim() : 'unknown',
636
- title: titleMatch ? titleMatch[1].trim() : 'Untitled',
637
- area: todoArea,
638
- path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'todos', 'pending', file))),
639
- });
640
- } catch { /* intentionally empty */ }
641
- }
642
- } catch { /* intentionally empty */ }
643
-
644
- const result = {
645
- // Config
646
- commit_docs: config.commit_docs,
647
-
648
- // Timestamps
649
- date: now.toISOString().split('T')[0],
650
- timestamp: now.toISOString(),
651
-
652
- // Todo inventory
653
- todo_count: count,
654
- todos,
655
- area_filter: area || null,
656
-
657
- // Paths
658
- pending_dir: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'todos', 'pending'))),
659
- completed_dir: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'todos', 'completed'))),
660
-
661
- // File existence
662
- planning_exists: fs.existsSync(planningDir(cwd)),
663
- todos_dir_exists: fs.existsSync(path.join(planningDir(cwd), 'todos')),
664
- pending_dir_exists: fs.existsSync(path.join(planningDir(cwd), 'todos', 'pending')),
665
- };
666
-
667
- output(withProjectRoot(cwd, result), raw);
668
- }
669
-
670
- function cmdInitMilestoneOp(cwd, raw) {
671
- const config = loadConfig(cwd);
672
- const milestone = getMilestoneInfo(cwd);
673
-
674
- // Count phases
675
- let phaseCount = 0;
676
- let completedPhases = 0;
677
- const phasesDir = path.join(planningDir(cwd), 'phases');
678
- try {
679
- const entries = fs.readdirSync(phasesDir, { withFileTypes: true });
680
- const dirs = entries.filter(e => e.isDirectory()).map(e => e.name);
681
- phaseCount = dirs.length;
682
-
683
- // Count phases with summaries (completed)
684
- for (const dir of dirs) {
685
- try {
686
- const phaseFiles = fs.readdirSync(path.join(phasesDir, dir));
687
- const hasSummary = phaseFiles.some(f => f.endsWith('-SUMMARY.md') || f === 'SUMMARY.md');
688
- if (hasSummary) completedPhases++;
689
- } catch { /* intentionally empty */ }
690
- }
691
- } catch { /* intentionally empty */ }
692
-
693
- // Check archive
694
- const archiveDir = path.join(planningRoot(cwd), 'archive');
695
- let archivedMilestones = [];
696
- try {
697
- archivedMilestones = fs.readdirSync(archiveDir, { withFileTypes: true })
698
- .filter(e => e.isDirectory())
699
- .map(e => e.name);
700
- } catch { /* intentionally empty */ }
701
-
702
- const result = {
703
- // Config
704
- commit_docs: config.commit_docs,
705
-
706
- // Current milestone
707
- milestone_version: milestone.version,
708
- milestone_name: milestone.name,
709
- milestone_slug: generateSlugInternal(milestone.name),
710
-
711
- // Phase counts
712
- phase_count: phaseCount,
713
- completed_phases: completedPhases,
714
- all_phases_complete: phaseCount > 0 && phaseCount === completedPhases,
715
-
716
- // Archive
717
- archived_milestones: archivedMilestones,
718
- archive_count: archivedMilestones.length,
719
-
720
- // File existence
721
- project_exists: pathExistsInternal(cwd, '.planning/PROJECT.md'),
722
- roadmap_exists: fs.existsSync(path.join(planningDir(cwd), 'ROADMAP.md')),
723
- state_exists: fs.existsSync(path.join(planningDir(cwd), 'STATE.md')),
724
- archive_exists: fs.existsSync(path.join(planningRoot(cwd), 'archive')),
725
- phases_dir_exists: fs.existsSync(path.join(planningDir(cwd), 'phases')),
726
- };
727
-
728
- output(withProjectRoot(cwd, result), raw);
729
- }
730
-
731
- function cmdInitMapCodebase(cwd, raw) {
732
- const config = loadConfig(cwd);
733
-
734
- // Check for existing codebase maps
735
- const codebaseDir = path.join(planningRoot(cwd), 'codebase');
736
- let existingMaps = [];
737
- try {
738
- existingMaps = fs.readdirSync(codebaseDir).filter(f => f.endsWith('.md'));
739
- } catch { /* intentionally empty */ }
740
-
741
- const result = {
742
- // Models
743
- mapper_model: resolveModelInternal(cwd, 'mindforge-codebase-mapper'),
744
-
745
- // Config
746
- commit_docs: config.commit_docs,
747
- search_gitignored: config.search_gitignored,
748
- parallelization: config.parallelization,
749
-
750
- // Paths
751
- codebase_dir: '.planning/codebase',
752
-
753
- // Existing maps
754
- existing_maps: existingMaps,
755
- has_maps: existingMaps.length > 0,
756
-
757
- // File existence
758
- planning_exists: pathExistsInternal(cwd, '.planning'),
759
- codebase_dir_exists: pathExistsInternal(cwd, '.planning/codebase'),
760
- };
761
-
762
- output(withProjectRoot(cwd, result), raw);
763
- }
764
-
765
- function cmdInitManager(cwd, raw) {
766
- const config = loadConfig(cwd);
767
- const milestone = getMilestoneInfo(cwd);
768
-
769
- // Use planningPaths for forward-compatibility with workstream scoping (#1268)
770
- const paths = planningPaths(cwd);
771
-
772
- // Validate prerequisites
773
- if (!fs.existsSync(paths.roadmap)) {
774
- error('No ROADMAP.md found. Run /mindforge-new-milestone first.');
775
- }
776
- if (!fs.existsSync(paths.state)) {
777
- error('No STATE.md found. Run /mindforge-new-milestone first.');
778
- }
779
- const rawContent = fs.readFileSync(paths.roadmap, 'utf-8');
780
- const content = extractCurrentMilestone(rawContent, cwd);
781
- const phasesDir = paths.phases;
782
- const isDirInMilestone = getMilestonePhaseFilter(cwd);
783
-
784
- const phasePattern = /#{2,4}\s*Phase\s+(\d+[A-Z]?(?:\.\d+)*)\s*:\s*([^\n]+)/gi;
785
- const phases = [];
786
- let match;
787
-
788
- while ((match = phasePattern.exec(content)) !== null) {
789
- const phaseNum = match[1];
790
- const phaseName = match[2].replace(/\(INSERTED\)/i, '').trim();
791
-
792
- const sectionStart = match.index;
793
- const restOfContent = content.slice(sectionStart);
794
- const nextHeader = restOfContent.match(/\n#{2,4}\s+Phase\s+\d/i);
795
- const sectionEnd = nextHeader ? sectionStart + nextHeader.index : content.length;
796
- const section = content.slice(sectionStart, sectionEnd);
797
-
798
- const goalMatch = section.match(/\*\*Goal(?::\*\*|\*\*:)\s*([^\n]+)/i);
799
- const goal = goalMatch ? goalMatch[1].trim() : null;
800
-
801
- const dependsMatch = section.match(/\*\*Depends on(?::\*\*|\*\*:)\s*([^\n]+)/i);
802
- const depends_on = dependsMatch ? dependsMatch[1].trim() : null;
803
-
804
- const normalized = normalizePhaseName(phaseNum);
805
- let diskStatus = 'no_directory';
806
- let planCount = 0;
807
- let summaryCount = 0;
808
- let hasContext = false;
809
- let hasResearch = false;
810
- let lastActivity = null;
811
- let isActive = false;
812
-
813
- try {
814
- const entries = fs.readdirSync(phasesDir, { withFileTypes: true });
815
- const dirs = entries.filter(e => e.isDirectory()).map(e => e.name).filter(isDirInMilestone);
816
- const dirMatch = dirs.find(d => d.startsWith(normalized + '-') || d === normalized);
817
-
818
- if (dirMatch) {
819
- const fullDir = path.join(phasesDir, dirMatch);
820
- const phaseFiles = fs.readdirSync(fullDir);
821
- planCount = phaseFiles.filter(f => f.endsWith('-PLAN.md') || f === 'PLAN.md').length;
822
- summaryCount = phaseFiles.filter(f => f.endsWith('-SUMMARY.md') || f === 'SUMMARY.md').length;
823
- hasContext = phaseFiles.some(f => f.endsWith('-CONTEXT.md') || f === 'CONTEXT.md');
824
- hasResearch = phaseFiles.some(f => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md');
825
-
826
- if (summaryCount >= planCount && planCount > 0) diskStatus = 'complete';
827
- else if (summaryCount > 0) diskStatus = 'partial';
828
- else if (planCount > 0) diskStatus = 'planned';
829
- else if (hasResearch) diskStatus = 'researched';
830
- else if (hasContext) diskStatus = 'discussed';
831
- else diskStatus = 'empty';
832
-
833
- // Activity detection: check most recent file mtime
834
- const now = Date.now();
835
- let newestMtime = 0;
836
- for (const f of phaseFiles) {
837
- try {
838
- const stat = fs.statSync(path.join(fullDir, f));
839
- if (stat.mtimeMs > newestMtime) newestMtime = stat.mtimeMs;
840
- } catch { /* intentionally empty */ }
841
- }
842
- if (newestMtime > 0) {
843
- lastActivity = new Date(newestMtime).toISOString();
844
- isActive = (now - newestMtime) < 300000; // 5 minutes
845
- }
846
- }
847
- } catch { /* intentionally empty */ }
848
-
849
- // Check ROADMAP checkbox status
850
- const checkboxPattern = new RegExp(`-\\s*\\[(x| )\\]\\s*.*Phase\\s+${phaseNum.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[:\\s]`, 'i');
851
- const checkboxMatch = content.match(checkboxPattern);
852
- const roadmapComplete = checkboxMatch ? checkboxMatch[1] === 'x' : false;
853
- if (roadmapComplete && diskStatus !== 'complete') {
854
- diskStatus = 'complete';
855
- }
856
-
857
- phases.push({
858
- number: phaseNum,
859
- name: phaseName,
860
- goal,
861
- depends_on,
862
- disk_status: diskStatus,
863
- has_context: hasContext,
864
- has_research: hasResearch,
865
- plan_count: planCount,
866
- summary_count: summaryCount,
867
- roadmap_complete: roadmapComplete,
868
- last_activity: lastActivity,
869
- is_active: isActive,
870
- });
871
- }
872
-
873
- // Compute display names: truncate to keep table aligned
874
- const MAX_NAME_WIDTH = 20;
875
- for (const phase of phases) {
876
- if (phase.name.length > MAX_NAME_WIDTH) {
877
- phase.display_name = phase.name.slice(0, MAX_NAME_WIDTH - 1) + '…';
878
- } else {
879
- phase.display_name = phase.name;
880
- }
881
- }
882
-
883
- // Dependency satisfaction: check if all depends_on phases are complete
884
- const completedNums = new Set(phases.filter(p => p.disk_status === 'complete').map(p => p.number));
885
- for (const phase of phases) {
886
- if (!phase.depends_on || /^none$/i.test(phase.depends_on.trim())) {
887
- phase.deps_satisfied = true;
888
- } else {
889
- // Parse "Phase 1, Phase 3" or "1, 3" formats
890
- const depNums = phase.depends_on.match(/\d+(?:\.\d+)*/g) || [];
891
- phase.deps_satisfied = depNums.every(n => completedNums.has(n));
892
- phase.dep_phases = depNums;
893
- }
894
- }
895
-
896
- // Compact dependency display for dashboard
897
- for (const phase of phases) {
898
- phase.deps_display = (phase.dep_phases && phase.dep_phases.length > 0)
899
- ? phase.dep_phases.join(',')
900
- : '—';
901
- }
902
-
903
- // Sliding window: discuss is sequential — only the first undiscussed phase is available
904
- let foundNextToDiscuss = false;
905
- for (const phase of phases) {
906
- if (!foundNextToDiscuss && (phase.disk_status === 'empty' || phase.disk_status === 'no_directory')) {
907
- phase.is_next_to_discuss = true;
908
- foundNextToDiscuss = true;
909
- } else {
910
- phase.is_next_to_discuss = false;
911
- }
912
- }
913
-
914
- // Check for WAITING.json signal
915
- let waitingSignal = null;
916
- try {
917
- const waitingPath = path.join(cwd, '.planning', 'WAITING.json');
918
- if (fs.existsSync(waitingPath)) {
919
- waitingSignal = JSON.parse(fs.readFileSync(waitingPath, 'utf-8'));
920
- }
921
- } catch { /* intentionally empty */ }
922
-
923
- // Compute recommended actions (execute > plan > discuss)
924
- const recommendedActions = [];
925
- for (const phase of phases) {
926
- if (phase.disk_status === 'complete') continue;
927
-
928
- if (phase.disk_status === 'planned' && phase.deps_satisfied) {
929
- recommendedActions.push({
930
- phase: phase.number,
931
- phase_name: phase.name,
932
- action: 'execute',
933
- reason: `${phase.plan_count} plans ready, dependencies met`,
934
- command: `/mindforge-execute-phase ${phase.number}`,
935
- });
936
- } else if (phase.disk_status === 'discussed' || phase.disk_status === 'researched') {
937
- recommendedActions.push({
938
- phase: phase.number,
939
- phase_name: phase.name,
940
- action: 'plan',
941
- reason: 'Context gathered, ready for planning',
942
- command: `/mindforge-plan-phase ${phase.number}`,
943
- });
944
- } else if ((phase.disk_status === 'empty' || phase.disk_status === 'no_directory') && phase.is_next_to_discuss) {
945
- recommendedActions.push({
946
- phase: phase.number,
947
- phase_name: phase.name,
948
- action: 'discuss',
949
- reason: 'Unblocked, ready to gather context',
950
- command: `/mindforge-discuss-phase ${phase.number}`,
951
- });
952
- }
953
- }
954
-
955
- // Filter recommendations: no parallel execute/plan unless phases are independent
956
- // Two phases are "independent" if neither depends on the other (directly or transitively)
957
- const phaseMap = new Map(phases.map(p => [p.number, p]));
958
-
959
- function reaches(from, to, visited = new Set()) {
960
- if (visited.has(from)) return false;
961
- visited.add(from);
962
- const p = phaseMap.get(from);
963
- if (!p || !p.dep_phases || p.dep_phases.length === 0) return false;
964
- if (p.dep_phases.includes(to)) return true;
965
- return p.dep_phases.some(dep => reaches(dep, to, visited));
966
- }
967
-
968
- function hasDepRelationship(numA, numB) {
969
- return reaches(numA, numB) || reaches(numB, numA);
970
- }
971
-
972
- // Detect phases with active work (file modified in last 5 min)
973
- const activeExecuting = phases.filter(p =>
974
- p.disk_status === 'partial' ||
975
- (p.disk_status === 'planned' && p.is_active)
976
- );
977
- const activePlanning = phases.filter(p =>
978
- p.is_active && (p.disk_status === 'discussed' || p.disk_status === 'researched')
979
- );
980
-
981
- const filteredActions = recommendedActions.filter(action => {
982
- if (action.action === 'execute' && activeExecuting.length > 0) {
983
- // Only allow if independent of ALL actively-executing phases
984
- return activeExecuting.every(active => !hasDepRelationship(action.phase, active.number));
985
- }
986
- if (action.action === 'plan' && activePlanning.length > 0) {
987
- // Only allow if independent of ALL actively-planning phases
988
- return activePlanning.every(active => !hasDepRelationship(action.phase, active.number));
989
- }
990
- return true;
991
- });
992
-
993
- const completedCount = phases.filter(p => p.disk_status === 'complete').length;
994
- const result = {
995
- milestone_version: milestone.version,
996
- milestone_name: milestone.name,
997
- phases,
998
- phase_count: phases.length,
999
- completed_count: completedCount,
1000
- in_progress_count: phases.filter(p => ['partial', 'planned', 'discussed', 'researched'].includes(p.disk_status)).length,
1001
- recommended_actions: filteredActions,
1002
- waiting_signal: waitingSignal,
1003
- all_complete: completedCount === phases.length && phases.length > 0,
1004
- project_exists: pathExistsInternal(cwd, '.planning/PROJECT.md'),
1005
- roadmap_exists: true,
1006
- state_exists: true,
1007
- };
1008
-
1009
- output(withProjectRoot(cwd, result), raw);
1010
- }
1011
-
1012
- function cmdInitProgress(cwd, raw) {
1013
- const config = loadConfig(cwd);
1014
- const milestone = getMilestoneInfo(cwd);
1015
-
1016
- // Analyze phases — filter to current milestone and include ROADMAP-only phases
1017
- const phasesDir = path.join(planningDir(cwd), 'phases');
1018
- const phases = [];
1019
- let currentPhase = null;
1020
- let nextPhase = null;
1021
-
1022
- // Build set of phases defined in ROADMAP for the current milestone
1023
- const roadmapPhaseNums = new Set();
1024
- const roadmapPhaseNames = new Map();
1025
- try {
1026
- const roadmapContent = extractCurrentMilestone(
1027
- fs.readFileSync(path.join(planningDir(cwd), 'ROADMAP.md'), 'utf-8'), cwd
1028
- );
1029
- const headingPattern = /#{2,4}\s*Phase\s+(\d+[A-Z]?(?:\.\d+)*)\s*:\s*([^\n]+)/gi;
1030
- let hm;
1031
- while ((hm = headingPattern.exec(roadmapContent)) !== null) {
1032
- roadmapPhaseNums.add(hm[1]);
1033
- roadmapPhaseNames.set(hm[1], hm[2].replace(/\(INSERTED\)/i, '').trim());
1034
- }
1035
- } catch { /* intentionally empty */ }
1036
-
1037
- const isDirInMilestone = getMilestonePhaseFilter(cwd);
1038
- const seenPhaseNums = new Set();
1039
-
1040
- try {
1041
- const entries = fs.readdirSync(phasesDir, { withFileTypes: true });
1042
- const dirs = entries.filter(e => e.isDirectory()).map(e => e.name)
1043
- .filter(isDirInMilestone)
1044
- .sort((a, b) => {
1045
- const pa = a.match(/^(\d+[A-Z]?(?:\.\d+)*)/i);
1046
- const pb = b.match(/^(\d+[A-Z]?(?:\.\d+)*)/i);
1047
- if (!pa || !pb) return a.localeCompare(b);
1048
- return parseInt(pa[1], 10) - parseInt(pb[1], 10);
1049
- });
1050
-
1051
- for (const dir of dirs) {
1052
- const match = dir.match(/^(\d+[A-Z]?(?:\.\d+)*)-?(.*)/i);
1053
- const phaseNumber = match ? match[1] : dir;
1054
- const phaseName = match && match[2] ? match[2] : null;
1055
- seenPhaseNums.add(phaseNumber.replace(/^0+/, '') || '0');
1056
-
1057
- const phasePath = path.join(phasesDir, dir);
1058
- const phaseFiles = fs.readdirSync(phasePath);
1059
-
1060
- const plans = phaseFiles.filter(f => f.endsWith('-PLAN.md') || f === 'PLAN.md');
1061
- const summaries = phaseFiles.filter(f => f.endsWith('-SUMMARY.md') || f === 'SUMMARY.md');
1062
- const hasResearch = phaseFiles.some(f => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md');
1063
-
1064
- const status = summaries.length >= plans.length && plans.length > 0 ? 'complete' :
1065
- plans.length > 0 ? 'in_progress' :
1066
- hasResearch ? 'researched' : 'pending';
1067
-
1068
- const phaseInfo = {
1069
- number: phaseNumber,
1070
- name: phaseName,
1071
- directory: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'phases', dir))),
1072
- status,
1073
- plan_count: plans.length,
1074
- summary_count: summaries.length,
1075
- has_research: hasResearch,
1076
- };
1077
-
1078
- phases.push(phaseInfo);
1079
-
1080
- // Find current (first incomplete with plans) and next (first pending)
1081
- if (!currentPhase && (status === 'in_progress' || status === 'researched')) {
1082
- currentPhase = phaseInfo;
1083
- }
1084
- if (!nextPhase && status === 'pending') {
1085
- nextPhase = phaseInfo;
1086
- }
1087
- }
1088
- } catch { /* intentionally empty */ }
1089
-
1090
- // Add phases defined in ROADMAP but not yet scaffolded to disk
1091
- for (const [num, name] of roadmapPhaseNames) {
1092
- const stripped = num.replace(/^0+/, '') || '0';
1093
- if (!seenPhaseNums.has(stripped)) {
1094
- const phaseInfo = {
1095
- number: num,
1096
- name: name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, ''),
1097
- directory: null,
1098
- status: 'not_started',
1099
- plan_count: 0,
1100
- summary_count: 0,
1101
- has_research: false,
1102
- };
1103
- phases.push(phaseInfo);
1104
- if (!nextPhase && !currentPhase) {
1105
- nextPhase = phaseInfo;
1106
- }
1107
- }
1108
- }
1109
-
1110
- // Re-sort phases by number after adding ROADMAP-only phases
1111
- phases.sort((a, b) => parseInt(a.number, 10) - parseInt(b.number, 10));
1112
-
1113
- // Check for paused work
1114
- let pausedAt = null;
1115
- try {
1116
- const state = fs.readFileSync(path.join(planningDir(cwd), 'STATE.md'), 'utf-8');
1117
- const pauseMatch = state.match(/\*\*Paused At:\*\*\s*(.+)/);
1118
- if (pauseMatch) pausedAt = pauseMatch[1].trim();
1119
- } catch { /* intentionally empty */ }
1120
-
1121
- const result = {
1122
- // Models
1123
- executor_model: resolveModelInternal(cwd, 'mindforge-executor'),
1124
- planner_model: resolveModelInternal(cwd, 'mindforge-planner'),
1125
-
1126
- // Config
1127
- commit_docs: config.commit_docs,
1128
-
1129
- // Milestone
1130
- milestone_version: milestone.version,
1131
- milestone_name: milestone.name,
1132
-
1133
- // Phase overview
1134
- phases,
1135
- phase_count: phases.length,
1136
- completed_count: phases.filter(p => p.status === 'complete').length,
1137
- in_progress_count: phases.filter(p => p.status === 'in_progress').length,
1138
-
1139
- // Current state
1140
- current_phase: currentPhase,
1141
- next_phase: nextPhase,
1142
- paused_at: pausedAt,
1143
- has_work_in_progress: !!currentPhase,
1144
-
1145
- // File existence
1146
- project_exists: pathExistsInternal(cwd, '.planning/PROJECT.md'),
1147
- roadmap_exists: fs.existsSync(path.join(planningDir(cwd), 'ROADMAP.md')),
1148
- state_exists: fs.existsSync(path.join(planningDir(cwd), 'STATE.md')),
1149
- // File paths
1150
- state_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'STATE.md'))),
1151
- roadmap_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'ROADMAP.md'))),
1152
- project_path: '.planning/PROJECT.md',
1153
- config_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'config.json'))),
1154
- };
1155
-
1156
- output(withProjectRoot(cwd, result), raw);
1157
- }
1158
-
1159
- /**
1160
- * Detect child git repos in a directory (one level deep).
1161
- * Returns array of { name, path, has_uncommitted } objects.
1162
- */
1163
- function detectChildRepos(dir) {
1164
- const repos = [];
1165
- let entries;
1166
- try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return repos; }
1167
- for (const entry of entries) {
1168
- if (!entry.isDirectory()) continue;
1169
- if (entry.name.startsWith('.')) continue;
1170
- const fullPath = path.join(dir, entry.name);
1171
- const gitDir = path.join(fullPath, '.git');
1172
- if (fs.existsSync(gitDir)) {
1173
- let hasUncommitted = false;
1174
- try {
1175
- const status = execSync('git status --porcelain', { cwd: fullPath, encoding: 'utf8', timeout: 5000 });
1176
- hasUncommitted = status.trim().length > 0;
1177
- } catch { /* best-effort */ }
1178
- repos.push({ name: entry.name, path: fullPath, has_uncommitted: hasUncommitted });
1179
- }
1180
- }
1181
- return repos;
1182
- }
1183
-
1184
- function cmdInitNewWorkspace(cwd, raw) {
1185
- const homedir = process.env.HOME || require('os').homedir();
1186
- const defaultBase = path.join(homedir, 'mindforge-workspaces');
1187
-
1188
- // Detect child git repos for interactive selection
1189
- const childRepos = detectChildRepos(cwd);
1190
-
1191
- // Check if git worktree is available
1192
- let worktreeAvailable = false;
1193
- try {
1194
- execSync('git --version', { encoding: 'utf8', timeout: 5000, stdio: 'pipe' });
1195
- worktreeAvailable = true;
1196
- } catch { /* no git at all */ }
1197
-
1198
- const result = {
1199
- default_workspace_base: defaultBase,
1200
- child_repos: childRepos,
1201
- child_repo_count: childRepos.length,
1202
- worktree_available: worktreeAvailable,
1203
- is_git_repo: pathExistsInternal(cwd, '.git'),
1204
- cwd_repo_name: path.basename(cwd),
1205
- };
1206
-
1207
- output(withProjectRoot(cwd, result), raw);
1208
- }
1209
-
1210
- function cmdInitListWorkspaces(cwd, raw) {
1211
- const homedir = process.env.HOME || require('os').homedir();
1212
- const defaultBase = path.join(homedir, 'mindforge-workspaces');
1213
-
1214
- const workspaces = [];
1215
- if (fs.existsSync(defaultBase)) {
1216
- let entries;
1217
- try { entries = fs.readdirSync(defaultBase, { withFileTypes: true }); } catch { entries = []; }
1218
- for (const entry of entries) {
1219
- if (!entry.isDirectory()) continue;
1220
- const wsPath = path.join(defaultBase, entry.name);
1221
- const manifestPath = path.join(wsPath, 'WORKSPACE.md');
1222
- if (!fs.existsSync(manifestPath)) continue;
1223
-
1224
- let repoCount = 0;
1225
- let hasProject = false;
1226
- let strategy = 'unknown';
1227
- try {
1228
- const manifest = fs.readFileSync(manifestPath, 'utf8');
1229
- const strategyMatch = manifest.match(/^Strategy:\s*(.+)$/m);
1230
- if (strategyMatch) strategy = strategyMatch[1].trim();
1231
- // Count table rows (lines starting with |, excluding header and separator)
1232
- const tableRows = manifest.split('\n').filter(l => l.match(/^\|\s*\w/) && !l.includes('Repo') && !l.includes('---'));
1233
- repoCount = tableRows.length;
1234
- } catch { /* best-effort */ }
1235
- hasProject = fs.existsSync(path.join(wsPath, '.planning', 'PROJECT.md'));
1236
-
1237
- workspaces.push({
1238
- name: entry.name,
1239
- path: wsPath,
1240
- repo_count: repoCount,
1241
- strategy,
1242
- has_project: hasProject,
1243
- });
1244
- }
1245
- }
1246
-
1247
- const result = {
1248
- workspace_base: defaultBase,
1249
- workspaces,
1250
- workspace_count: workspaces.length,
1251
- };
1252
-
1253
- output(result, raw);
1254
- }
1255
-
1256
- function cmdInitRemoveWorkspace(cwd, name, raw) {
1257
- const homedir = process.env.HOME || require('os').homedir();
1258
- const defaultBase = path.join(homedir, 'mindforge-workspaces');
1259
-
1260
- if (!name) {
1261
- error('workspace name required for init remove-workspace');
1262
- }
1263
-
1264
- const wsPath = path.join(defaultBase, name);
1265
- const manifestPath = path.join(wsPath, 'WORKSPACE.md');
1266
-
1267
- if (!fs.existsSync(wsPath)) {
1268
- error(`Workspace not found: ${wsPath}`);
1269
- }
1270
-
1271
- // Parse manifest for repo info
1272
- const repos = [];
1273
- let strategy = 'unknown';
1274
- if (fs.existsSync(manifestPath)) {
1275
- try {
1276
- const manifest = fs.readFileSync(manifestPath, 'utf8');
1277
- const strategyMatch = manifest.match(/^Strategy:\s*(.+)$/m);
1278
- if (strategyMatch) strategy = strategyMatch[1].trim();
1279
-
1280
- // Parse table rows for repo names and source paths
1281
- const lines = manifest.split('\n');
1282
- for (const line of lines) {
1283
- const match = line.match(/^\|\s*(\S+)\s*\|\s*(\S+)\s*\|\s*(\S+)\s*\|\s*(\S+)\s*\|$/);
1284
- if (match && match[1] !== 'Repo' && !match[1].includes('---')) {
1285
- repos.push({ name: match[1], source: match[2], branch: match[3], strategy: match[4] });
1286
- }
1287
- }
1288
- } catch { /* best-effort */ }
1289
- }
1290
-
1291
- // Check for uncommitted changes in workspace repos
1292
- const dirtyRepos = [];
1293
- for (const repo of repos) {
1294
- const repoPath = path.join(wsPath, repo.name);
1295
- if (!fs.existsSync(repoPath)) continue;
1296
- try {
1297
- const status = execSync('git status --porcelain', { cwd: repoPath, encoding: 'utf8', timeout: 5000, stdio: 'pipe' });
1298
- if (status.trim().length > 0) {
1299
- dirtyRepos.push(repo.name);
1300
- }
1301
- } catch { /* best-effort */ }
1302
- }
1303
-
1304
- const result = {
1305
- workspace_name: name,
1306
- workspace_path: wsPath,
1307
- has_manifest: fs.existsSync(manifestPath),
1308
- strategy,
1309
- repos,
1310
- repo_count: repos.length,
1311
- dirty_repos: dirtyRepos,
1312
- has_dirty_repos: dirtyRepos.length > 0,
1313
- };
1314
-
1315
- output(result, raw);
1316
- }
1317
-
1318
- module.exports = {
1319
- cmdInitExecutePhase,
1320
- cmdInitPlanPhase,
1321
- cmdInitNewProject,
1322
- cmdInitNewMilestone,
1323
- cmdInitQuick,
1324
- cmdInitResume,
1325
- cmdInitVerifyWork,
1326
- cmdInitPhaseOp,
1327
- cmdInitTodos,
1328
- cmdInitMilestoneOp,
1329
- cmdInitMapCodebase,
1330
- cmdInitProgress,
1331
- cmdInitManager,
1332
- cmdInitNewWorkspace,
1333
- cmdInitListWorkspaces,
1334
- cmdInitRemoveWorkspace,
1335
- detectChildRepos,
1336
- };