gsd-remix 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (554) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +939 -0
  3. package/README.zh-CN.md +876 -0
  4. package/agents/gsd-advisor-researcher.md +127 -0
  5. package/agents/gsd-ai-researcher.md +133 -0
  6. package/agents/gsd-assumptions-analyzer.md +105 -0
  7. package/agents/gsd-code-fixer.md +517 -0
  8. package/agents/gsd-code-reviewer.md +371 -0
  9. package/agents/gsd-codebase-mapper.md +781 -0
  10. package/agents/gsd-debug-session-manager.md +314 -0
  11. package/agents/gsd-debugger.md +1452 -0
  12. package/agents/gsd-doc-classifier.md +168 -0
  13. package/agents/gsd-doc-synthesizer.md +204 -0
  14. package/agents/gsd-doc-verifier.md +217 -0
  15. package/agents/gsd-doc-writer.md +615 -0
  16. package/agents/gsd-domain-researcher.md +153 -0
  17. package/agents/gsd-eval-auditor.md +191 -0
  18. package/agents/gsd-eval-planner.md +154 -0
  19. package/agents/gsd-executor.md +603 -0
  20. package/agents/gsd-framework-selector.md +160 -0
  21. package/agents/gsd-integration-checker.md +470 -0
  22. package/agents/gsd-intel-updater.md +334 -0
  23. package/agents/gsd-nyquist-auditor.md +203 -0
  24. package/agents/gsd-pattern-mapper.md +335 -0
  25. package/agents/gsd-phase-researcher.md +841 -0
  26. package/agents/gsd-plan-checker.md +978 -0
  27. package/agents/gsd-planner.md +1251 -0
  28. package/agents/gsd-project-researcher.md +677 -0
  29. package/agents/gsd-research-synthesizer.md +247 -0
  30. package/agents/gsd-roadmapper.md +688 -0
  31. package/agents/gsd-security-auditor.md +155 -0
  32. package/agents/gsd-ui-auditor.md +495 -0
  33. package/agents/gsd-ui-checker.md +309 -0
  34. package/agents/gsd-ui-researcher.md +380 -0
  35. package/agents/gsd-user-profiler.md +171 -0
  36. package/agents/gsd-verifier.md +830 -0
  37. package/bin/install.js +7062 -0
  38. package/commands/gsd/add-backlog.md +79 -0
  39. package/commands/gsd/add-phase.md +43 -0
  40. package/commands/gsd/add-tests.md +41 -0
  41. package/commands/gsd/add-todo.md +47 -0
  42. package/commands/gsd/ai-integration-phase.md +36 -0
  43. package/commands/gsd/analyze-dependencies.md +34 -0
  44. package/commands/gsd/audit-fix.md +33 -0
  45. package/commands/gsd/audit-milestone.md +36 -0
  46. package/commands/gsd/audit-uat.md +24 -0
  47. package/commands/gsd/autonomous.md +46 -0
  48. package/commands/gsd/check-todos.md +45 -0
  49. package/commands/gsd/cleanup.md +23 -0
  50. package/commands/gsd/code-review-fix.md +52 -0
  51. package/commands/gsd/code-review.md +55 -0
  52. package/commands/gsd/complete-milestone.md +136 -0
  53. package/commands/gsd/debug.md +263 -0
  54. package/commands/gsd/discuss-phase.md +69 -0
  55. package/commands/gsd/do.md +30 -0
  56. package/commands/gsd/docs-update.md +48 -0
  57. package/commands/gsd/eval-review.md +32 -0
  58. package/commands/gsd/execute-phase.md +63 -0
  59. package/commands/gsd/explore.md +27 -0
  60. package/commands/gsd/extract_learnings.md +22 -0
  61. package/commands/gsd/fast.md +30 -0
  62. package/commands/gsd/forensics.md +56 -0
  63. package/commands/gsd/from-gsd2.md +47 -0
  64. package/commands/gsd/graphify.md +201 -0
  65. package/commands/gsd/health.md +22 -0
  66. package/commands/gsd/help.md +24 -0
  67. package/commands/gsd/import.md +37 -0
  68. package/commands/gsd/inbox.md +38 -0
  69. package/commands/gsd/ingest-docs.md +42 -0
  70. package/commands/gsd/insert-phase.md +32 -0
  71. package/commands/gsd/intel.md +179 -0
  72. package/commands/gsd/join-discord.md +19 -0
  73. package/commands/gsd/list-phase-assumptions.md +46 -0
  74. package/commands/gsd/list-workspaces.md +19 -0
  75. package/commands/gsd/manager.md +40 -0
  76. package/commands/gsd/map-codebase.md +71 -0
  77. package/commands/gsd/milestone-summary.md +51 -0
  78. package/commands/gsd/new-milestone.md +44 -0
  79. package/commands/gsd/new-project.md +46 -0
  80. package/commands/gsd/new-workspace.md +44 -0
  81. package/commands/gsd/next.md +28 -0
  82. package/commands/gsd/note.md +34 -0
  83. package/commands/gsd/pause-work.md +38 -0
  84. package/commands/gsd/plan-milestone-gaps.md +34 -0
  85. package/commands/gsd/plan-phase.md +52 -0
  86. package/commands/gsd/plan-review-convergence.md +52 -0
  87. package/commands/gsd/plant-seed.md +28 -0
  88. package/commands/gsd/pr-branch.md +25 -0
  89. package/commands/gsd/profile-user.md +46 -0
  90. package/commands/gsd/progress.md +25 -0
  91. package/commands/gsd/quick.md +173 -0
  92. package/commands/gsd/reapply-patches.md +331 -0
  93. package/commands/gsd/remove-phase.md +31 -0
  94. package/commands/gsd/remove-workspace.md +26 -0
  95. package/commands/gsd/research-phase.md +195 -0
  96. package/commands/gsd/resume-work.md +40 -0
  97. package/commands/gsd/review-backlog.md +62 -0
  98. package/commands/gsd/review.md +40 -0
  99. package/commands/gsd/scan.md +26 -0
  100. package/commands/gsd/secure-phase.md +35 -0
  101. package/commands/gsd/session-report.md +19 -0
  102. package/commands/gsd/set-profile.md +12 -0
  103. package/commands/gsd/settings.md +36 -0
  104. package/commands/gsd/ship.md +23 -0
  105. package/commands/gsd/sketch-wrap-up.md +31 -0
  106. package/commands/gsd/sketch.md +49 -0
  107. package/commands/gsd/spec-phase.md +62 -0
  108. package/commands/gsd/spike-wrap-up.md +31 -0
  109. package/commands/gsd/spike.md +46 -0
  110. package/commands/gsd/stats.md +18 -0
  111. package/commands/gsd/sync-skills.md +19 -0
  112. package/commands/gsd/thread.md +227 -0
  113. package/commands/gsd/ui-phase.md +34 -0
  114. package/commands/gsd/ui-review.md +32 -0
  115. package/commands/gsd/ultraplan-phase.md +33 -0
  116. package/commands/gsd/undo.md +34 -0
  117. package/commands/gsd/update.md +37 -0
  118. package/commands/gsd/validate-phase.md +35 -0
  119. package/commands/gsd/verify-work.md +38 -0
  120. package/commands/gsd/workstreams.md +69 -0
  121. package/get-shit-done/bin/gsd-tools.cjs +1263 -0
  122. package/get-shit-done/bin/lib/artifacts.cjs +52 -0
  123. package/get-shit-done/bin/lib/audit.cjs +757 -0
  124. package/get-shit-done/bin/lib/commands.cjs +1023 -0
  125. package/get-shit-done/bin/lib/config-schema.cjs +79 -0
  126. package/get-shit-done/bin/lib/config.cjs +463 -0
  127. package/get-shit-done/bin/lib/core.cjs +1794 -0
  128. package/get-shit-done/bin/lib/docs.cjs +267 -0
  129. package/get-shit-done/bin/lib/frontmatter.cjs +379 -0
  130. package/get-shit-done/bin/lib/graphify.cjs +494 -0
  131. package/get-shit-done/bin/lib/gsd2-import.cjs +511 -0
  132. package/get-shit-done/bin/lib/init.cjs +1878 -0
  133. package/get-shit-done/bin/lib/intel.cjs +639 -0
  134. package/get-shit-done/bin/lib/learnings.cjs +378 -0
  135. package/get-shit-done/bin/lib/milestone.cjs +283 -0
  136. package/get-shit-done/bin/lib/model-profiles.cjs +71 -0
  137. package/get-shit-done/bin/lib/phase.cjs +1058 -0
  138. package/get-shit-done/bin/lib/profile-output.cjs +1080 -0
  139. package/get-shit-done/bin/lib/profile-pipeline.cjs +539 -0
  140. package/get-shit-done/bin/lib/roadmap.cjs +523 -0
  141. package/get-shit-done/bin/lib/schema-detect.cjs +238 -0
  142. package/get-shit-done/bin/lib/security.cjs +504 -0
  143. package/get-shit-done/bin/lib/state.cjs +1649 -0
  144. package/get-shit-done/bin/lib/template.cjs +226 -0
  145. package/get-shit-done/bin/lib/uat.cjs +288 -0
  146. package/get-shit-done/bin/lib/verify.cjs +1184 -0
  147. package/get-shit-done/bin/lib/workstream.cjs +495 -0
  148. package/get-shit-done/bin/repair-sdk.cjs +177 -0
  149. package/get-shit-done/contexts/dev.md +21 -0
  150. package/get-shit-done/contexts/research.md +22 -0
  151. package/get-shit-done/contexts/review.md +22 -0
  152. package/get-shit-done/references/agent-contracts.md +79 -0
  153. package/get-shit-done/references/ai-evals.md +156 -0
  154. package/get-shit-done/references/ai-frameworks.md +186 -0
  155. package/get-shit-done/references/artifact-types.md +131 -0
  156. package/get-shit-done/references/autonomous-smart-discuss.md +277 -0
  157. package/get-shit-done/references/checkpoints.md +808 -0
  158. package/get-shit-done/references/common-bug-patterns.md +114 -0
  159. package/get-shit-done/references/context-budget.md +49 -0
  160. package/get-shit-done/references/continuation-format.md +253 -0
  161. package/get-shit-done/references/debugger-philosophy.md +76 -0
  162. package/get-shit-done/references/decimal-phase-calculation.md +64 -0
  163. package/get-shit-done/references/doc-conflict-engine.md +91 -0
  164. package/get-shit-done/references/domain-probes.md +125 -0
  165. package/get-shit-done/references/executor-examples.md +110 -0
  166. package/get-shit-done/references/few-shot-examples/plan-checker.md +73 -0
  167. package/get-shit-done/references/few-shot-examples/verifier.md +109 -0
  168. package/get-shit-done/references/gate-prompts.md +100 -0
  169. package/get-shit-done/references/gates.md +70 -0
  170. package/get-shit-done/references/git-integration.md +295 -0
  171. package/get-shit-done/references/git-planning-commit.md +40 -0
  172. package/get-shit-done/references/ios-scaffold.md +123 -0
  173. package/get-shit-done/references/mandatory-initial-read.md +2 -0
  174. package/get-shit-done/references/model-profile-resolution.md +38 -0
  175. package/get-shit-done/references/model-profiles.md +145 -0
  176. package/get-shit-done/references/phase-argument-parsing.md +61 -0
  177. package/get-shit-done/references/planner-antipatterns.md +89 -0
  178. package/get-shit-done/references/planner-gap-closure.md +62 -0
  179. package/get-shit-done/references/planner-reviews.md +39 -0
  180. package/get-shit-done/references/planner-revision.md +87 -0
  181. package/get-shit-done/references/planner-source-audit.md +73 -0
  182. package/get-shit-done/references/planning-config.md +460 -0
  183. package/get-shit-done/references/project-skills-discovery.md +19 -0
  184. package/get-shit-done/references/questioning.md +162 -0
  185. package/get-shit-done/references/revision-loop.md +97 -0
  186. package/get-shit-done/references/sketch-interactivity.md +41 -0
  187. package/get-shit-done/references/sketch-theme-system.md +94 -0
  188. package/get-shit-done/references/sketch-tooling.md +45 -0
  189. package/get-shit-done/references/sketch-variant-patterns.md +81 -0
  190. package/get-shit-done/references/tdd.md +330 -0
  191. package/get-shit-done/references/thinking-models-debug.md +44 -0
  192. package/get-shit-done/references/thinking-models-execution.md +50 -0
  193. package/get-shit-done/references/thinking-models-planning.md +62 -0
  194. package/get-shit-done/references/thinking-models-research.md +50 -0
  195. package/get-shit-done/references/thinking-models-verification.md +55 -0
  196. package/get-shit-done/references/thinking-partner.md +96 -0
  197. package/get-shit-done/references/ui-brand.md +160 -0
  198. package/get-shit-done/references/universal-anti-patterns.md +63 -0
  199. package/get-shit-done/references/user-profiling.md +681 -0
  200. package/get-shit-done/references/verification-overrides.md +227 -0
  201. package/get-shit-done/references/verification-patterns.md +612 -0
  202. package/get-shit-done/references/workstream-flag.md +111 -0
  203. package/get-shit-done/templates/AI-SPEC.md +246 -0
  204. package/get-shit-done/templates/DEBUG.md +169 -0
  205. package/get-shit-done/templates/README.md +76 -0
  206. package/get-shit-done/templates/SECURITY.md +61 -0
  207. package/get-shit-done/templates/UAT.md +265 -0
  208. package/get-shit-done/templates/UI-SPEC.md +100 -0
  209. package/get-shit-done/templates/VALIDATION.md +76 -0
  210. package/get-shit-done/templates/claude-md.md +145 -0
  211. package/get-shit-done/templates/codebase/architecture.md +255 -0
  212. package/get-shit-done/templates/codebase/concerns.md +310 -0
  213. package/get-shit-done/templates/codebase/conventions.md +307 -0
  214. package/get-shit-done/templates/codebase/integrations.md +280 -0
  215. package/get-shit-done/templates/codebase/stack.md +186 -0
  216. package/get-shit-done/templates/codebase/structure.md +285 -0
  217. package/get-shit-done/templates/codebase/testing.md +480 -0
  218. package/get-shit-done/templates/config.json +56 -0
  219. package/get-shit-done/templates/context.md +352 -0
  220. package/get-shit-done/templates/continue-here.md +78 -0
  221. package/get-shit-done/templates/copilot-instructions.md +7 -0
  222. package/get-shit-done/templates/debug-subagent-prompt.md +91 -0
  223. package/get-shit-done/templates/dev-preferences.md +21 -0
  224. package/get-shit-done/templates/discovery.md +146 -0
  225. package/get-shit-done/templates/discussion-log.md +63 -0
  226. package/get-shit-done/templates/milestone-archive.md +123 -0
  227. package/get-shit-done/templates/milestone.md +115 -0
  228. package/get-shit-done/templates/phase-prompt.md +610 -0
  229. package/get-shit-done/templates/planner-subagent-prompt.md +117 -0
  230. package/get-shit-done/templates/project.md +186 -0
  231. package/get-shit-done/templates/requirements.md +231 -0
  232. package/get-shit-done/templates/research-project/ARCHITECTURE.md +204 -0
  233. package/get-shit-done/templates/research-project/FEATURES.md +147 -0
  234. package/get-shit-done/templates/research-project/PITFALLS.md +200 -0
  235. package/get-shit-done/templates/research-project/STACK.md +120 -0
  236. package/get-shit-done/templates/research-project/SUMMARY.md +170 -0
  237. package/get-shit-done/templates/research.md +592 -0
  238. package/get-shit-done/templates/retrospective.md +54 -0
  239. package/get-shit-done/templates/roadmap.md +202 -0
  240. package/get-shit-done/templates/spec.md +307 -0
  241. package/get-shit-done/templates/state.md +184 -0
  242. package/get-shit-done/templates/summary-complex.md +59 -0
  243. package/get-shit-done/templates/summary-minimal.md +41 -0
  244. package/get-shit-done/templates/summary-standard.md +48 -0
  245. package/get-shit-done/templates/summary.md +248 -0
  246. package/get-shit-done/templates/user-profile.md +146 -0
  247. package/get-shit-done/templates/user-setup.md +311 -0
  248. package/get-shit-done/templates/verification-report.md +322 -0
  249. package/get-shit-done/workflows/add-phase.md +112 -0
  250. package/get-shit-done/workflows/add-tests.md +354 -0
  251. package/get-shit-done/workflows/add-todo.md +160 -0
  252. package/get-shit-done/workflows/ai-integration-phase.md +284 -0
  253. package/get-shit-done/workflows/analyze-dependencies.md +96 -0
  254. package/get-shit-done/workflows/audit-fix.md +175 -0
  255. package/get-shit-done/workflows/audit-milestone.md +340 -0
  256. package/get-shit-done/workflows/audit-uat.md +109 -0
  257. package/get-shit-done/workflows/autonomous.md +789 -0
  258. package/get-shit-done/workflows/check-todos.md +179 -0
  259. package/get-shit-done/workflows/cleanup.md +154 -0
  260. package/get-shit-done/workflows/code-review-fix.md +497 -0
  261. package/get-shit-done/workflows/code-review.md +515 -0
  262. package/get-shit-done/workflows/complete-milestone.md +847 -0
  263. package/get-shit-done/workflows/diagnose-issues.md +238 -0
  264. package/get-shit-done/workflows/discovery-phase.md +291 -0
  265. package/get-shit-done/workflows/discuss-phase-assumptions.md +670 -0
  266. package/get-shit-done/workflows/discuss-phase-power.md +308 -0
  267. package/get-shit-done/workflows/discuss-phase.md +1378 -0
  268. package/get-shit-done/workflows/do.md +110 -0
  269. package/get-shit-done/workflows/docs-update.md +1155 -0
  270. package/get-shit-done/workflows/eval-review.md +155 -0
  271. package/get-shit-done/workflows/execute-phase.md +1677 -0
  272. package/get-shit-done/workflows/execute-plan.md +533 -0
  273. package/get-shit-done/workflows/explore.md +141 -0
  274. package/get-shit-done/workflows/extract_learnings.md +242 -0
  275. package/get-shit-done/workflows/fast.md +105 -0
  276. package/get-shit-done/workflows/forensics.md +265 -0
  277. package/get-shit-done/workflows/graduation.md +195 -0
  278. package/get-shit-done/workflows/health.md +314 -0
  279. package/get-shit-done/workflows/help.md +667 -0
  280. package/get-shit-done/workflows/import.md +246 -0
  281. package/get-shit-done/workflows/inbox.md +387 -0
  282. package/get-shit-done/workflows/ingest-docs.md +328 -0
  283. package/get-shit-done/workflows/insert-phase.md +130 -0
  284. package/get-shit-done/workflows/list-phase-assumptions.md +178 -0
  285. package/get-shit-done/workflows/list-workspaces.md +56 -0
  286. package/get-shit-done/workflows/manager.md +365 -0
  287. package/get-shit-done/workflows/map-codebase.md +393 -0
  288. package/get-shit-done/workflows/milestone-summary.md +223 -0
  289. package/get-shit-done/workflows/new-milestone.md +611 -0
  290. package/get-shit-done/workflows/new-project.md +1391 -0
  291. package/get-shit-done/workflows/new-workspace.md +239 -0
  292. package/get-shit-done/workflows/next.md +220 -0
  293. package/get-shit-done/workflows/node-repair.md +92 -0
  294. package/get-shit-done/workflows/note.md +158 -0
  295. package/get-shit-done/workflows/pause-work.md +243 -0
  296. package/get-shit-done/workflows/plan-milestone-gaps.md +273 -0
  297. package/get-shit-done/workflows/plan-phase.md +1349 -0
  298. package/get-shit-done/workflows/plan-review-convergence.md +254 -0
  299. package/get-shit-done/workflows/plant-seed.md +172 -0
  300. package/get-shit-done/workflows/pr-branch.md +157 -0
  301. package/get-shit-done/workflows/profile-user.md +452 -0
  302. package/get-shit-done/workflows/progress.md +619 -0
  303. package/get-shit-done/workflows/quick.md +970 -0
  304. package/get-shit-done/workflows/remove-phase.md +155 -0
  305. package/get-shit-done/workflows/remove-workspace.md +92 -0
  306. package/get-shit-done/workflows/research-phase.md +89 -0
  307. package/get-shit-done/workflows/resume-project.md +326 -0
  308. package/get-shit-done/workflows/review.md +344 -0
  309. package/get-shit-done/workflows/scan.md +102 -0
  310. package/get-shit-done/workflows/secure-phase.md +166 -0
  311. package/get-shit-done/workflows/session-report.md +146 -0
  312. package/get-shit-done/workflows/settings.md +319 -0
  313. package/get-shit-done/workflows/ship.md +302 -0
  314. package/get-shit-done/workflows/sketch-wrap-up.md +283 -0
  315. package/get-shit-done/workflows/sketch.md +286 -0
  316. package/get-shit-done/workflows/spec-phase.md +262 -0
  317. package/get-shit-done/workflows/spike-wrap-up.md +281 -0
  318. package/get-shit-done/workflows/spike.md +362 -0
  319. package/get-shit-done/workflows/stats.md +60 -0
  320. package/get-shit-done/workflows/sync-skills.md +182 -0
  321. package/get-shit-done/workflows/transition.md +693 -0
  322. package/get-shit-done/workflows/ui-phase.md +323 -0
  323. package/get-shit-done/workflows/ui-review.md +190 -0
  324. package/get-shit-done/workflows/ultraplan-phase.md +189 -0
  325. package/get-shit-done/workflows/undo.md +314 -0
  326. package/get-shit-done/workflows/update.md +587 -0
  327. package/get-shit-done/workflows/validate-phase.md +176 -0
  328. package/get-shit-done/workflows/verify-phase.md +465 -0
  329. package/get-shit-done/workflows/verify-work.md +740 -0
  330. package/hooks/dist/gsd-check-update-worker.js +108 -0
  331. package/hooks/dist/gsd-check-update.js +64 -0
  332. package/hooks/dist/gsd-context-monitor.js +192 -0
  333. package/hooks/dist/gsd-phase-boundary.sh +28 -0
  334. package/hooks/dist/gsd-prompt-guard.js +97 -0
  335. package/hooks/dist/gsd-read-guard.js +82 -0
  336. package/hooks/dist/gsd-read-injection-scanner.js +152 -0
  337. package/hooks/dist/gsd-session-state.sh +34 -0
  338. package/hooks/dist/gsd-statusline.js +293 -0
  339. package/hooks/dist/gsd-validate-commit.sh +48 -0
  340. package/hooks/dist/gsd-workflow-guard.js +94 -0
  341. package/hooks/gsd-check-update-worker.js +108 -0
  342. package/hooks/gsd-check-update.js +64 -0
  343. package/hooks/gsd-context-monitor.js +192 -0
  344. package/hooks/gsd-phase-boundary.sh +28 -0
  345. package/hooks/gsd-prompt-guard.js +97 -0
  346. package/hooks/gsd-read-guard.js +82 -0
  347. package/hooks/gsd-read-injection-scanner.js +152 -0
  348. package/hooks/gsd-session-state.sh +34 -0
  349. package/hooks/gsd-statusline.js +293 -0
  350. package/hooks/gsd-validate-commit.sh +48 -0
  351. package/hooks/gsd-workflow-guard.js +94 -0
  352. package/package.json +59 -0
  353. package/scripts/base64-scan.sh +262 -0
  354. package/scripts/build-hooks.js +95 -0
  355. package/scripts/gen-inventory-manifest.cjs +109 -0
  356. package/scripts/prompt-injection-scan.sh +201 -0
  357. package/scripts/run-tests.cjs +33 -0
  358. package/scripts/secret-scan.sh +227 -0
  359. package/sdk/package-lock.json +1998 -0
  360. package/sdk/package.json +52 -0
  361. package/sdk/prompts/agents/gsd-executor.md +110 -0
  362. package/sdk/prompts/agents/gsd-phase-researcher.md +158 -0
  363. package/sdk/prompts/agents/gsd-plan-checker.md +160 -0
  364. package/sdk/prompts/agents/gsd-planner.md +214 -0
  365. package/sdk/prompts/agents/gsd-project-researcher.md +323 -0
  366. package/sdk/prompts/agents/gsd-research-synthesizer.md +237 -0
  367. package/sdk/prompts/agents/gsd-roadmapper.md +670 -0
  368. package/sdk/prompts/agents/gsd-verifier.md +159 -0
  369. package/sdk/prompts/templates/project.md +186 -0
  370. package/sdk/prompts/templates/requirements.md +231 -0
  371. package/sdk/prompts/templates/research-project/ARCHITECTURE.md +204 -0
  372. package/sdk/prompts/templates/research-project/FEATURES.md +147 -0
  373. package/sdk/prompts/templates/research-project/PITFALLS.md +200 -0
  374. package/sdk/prompts/templates/research-project/STACK.md +120 -0
  375. package/sdk/prompts/templates/research-project/SUMMARY.md +170 -0
  376. package/sdk/prompts/templates/roadmap.md +202 -0
  377. package/sdk/prompts/templates/state.md +175 -0
  378. package/sdk/prompts/workflows/discuss-phase.md +126 -0
  379. package/sdk/prompts/workflows/execute-plan.md +106 -0
  380. package/sdk/prompts/workflows/plan-phase.md +84 -0
  381. package/sdk/prompts/workflows/research-phase.md +45 -0
  382. package/sdk/prompts/workflows/verify-phase.md +142 -0
  383. package/sdk/src/assembled-prompts.test.ts +349 -0
  384. package/sdk/src/cli-transport.test.ts +388 -0
  385. package/sdk/src/cli-transport.ts +130 -0
  386. package/sdk/src/cli.test.ts +383 -0
  387. package/sdk/src/cli.ts +670 -0
  388. package/sdk/src/config.test.ts +168 -0
  389. package/sdk/src/config.ts +177 -0
  390. package/sdk/src/context-engine.test.ts +295 -0
  391. package/sdk/src/context-engine.ts +170 -0
  392. package/sdk/src/context-truncation.test.ts +163 -0
  393. package/sdk/src/context-truncation.ts +233 -0
  394. package/sdk/src/e2e.integration.test.ts +178 -0
  395. package/sdk/src/errors.ts +72 -0
  396. package/sdk/src/event-stream.test.ts +661 -0
  397. package/sdk/src/event-stream.ts +441 -0
  398. package/sdk/src/failure-memory.test.ts +457 -0
  399. package/sdk/src/failure-memory.ts +1324 -0
  400. package/sdk/src/golden/capture.ts +95 -0
  401. package/sdk/src/golden/fixtures/generate-slug.golden.json +1 -0
  402. package/sdk/src/golden/fixtures/profile-sample-sessions/demo-project/sample.jsonl +3 -0
  403. package/sdk/src/golden/fixtures/summary-extract-sample.md +26 -0
  404. package/sdk/src/golden/fixtures/uat-render-checkpoint-sample.md +15 -0
  405. package/sdk/src/golden/golden-integration-covered.ts +30 -0
  406. package/sdk/src/golden/golden-mutation-covered.ts +7 -0
  407. package/sdk/src/golden/golden-policy.test.ts +8 -0
  408. package/sdk/src/golden/golden-policy.ts +112 -0
  409. package/sdk/src/golden/golden.integration.test.ts +373 -0
  410. package/sdk/src/golden/init-golden-normalize.ts +15 -0
  411. package/sdk/src/golden/read-only-golden-rows.ts +77 -0
  412. package/sdk/src/golden/read-only-parity.integration.test.ts +125 -0
  413. package/sdk/src/golden/registry-canonical-commands.ts +31 -0
  414. package/sdk/src/gsd-tools.test.ts +409 -0
  415. package/sdk/src/gsd-tools.ts +595 -0
  416. package/sdk/src/headless-prompts.test.ts +159 -0
  417. package/sdk/src/index.ts +333 -0
  418. package/sdk/src/init-e2e.integration.test.ts +136 -0
  419. package/sdk/src/init-runner.test.ts +783 -0
  420. package/sdk/src/init-runner.ts +735 -0
  421. package/sdk/src/lifecycle-e2e.integration.test.ts +258 -0
  422. package/sdk/src/logger.test.ts +149 -0
  423. package/sdk/src/logger.ts +113 -0
  424. package/sdk/src/milestone-runner.test.ts +421 -0
  425. package/sdk/src/phase-prompt.test.ts +538 -0
  426. package/sdk/src/phase-prompt.ts +264 -0
  427. package/sdk/src/phase-runner-types.test.ts +421 -0
  428. package/sdk/src/phase-runner.integration.test.ts +377 -0
  429. package/sdk/src/phase-runner.test.ts +2333 -0
  430. package/sdk/src/phase-runner.ts +1203 -0
  431. package/sdk/src/plan-parser.test.ts +528 -0
  432. package/sdk/src/plan-parser.ts +427 -0
  433. package/sdk/src/prompt-builder.test.ts +306 -0
  434. package/sdk/src/prompt-builder.ts +193 -0
  435. package/sdk/src/prompt-sanitizer.test.ts +260 -0
  436. package/sdk/src/prompt-sanitizer.ts +71 -0
  437. package/sdk/src/query/QUERY-HANDLERS.md +317 -0
  438. package/sdk/src/query/audit-open.ts +722 -0
  439. package/sdk/src/query/check-auto-mode.test.ts +77 -0
  440. package/sdk/src/query/check-auto-mode.ts +50 -0
  441. package/sdk/src/query/check-completion.test.ts +113 -0
  442. package/sdk/src/query/check-completion.ts +182 -0
  443. package/sdk/src/query/check-gates.test.ts +103 -0
  444. package/sdk/src/query/check-gates.ts +112 -0
  445. package/sdk/src/query/check-ship-ready.test.ts +77 -0
  446. package/sdk/src/query/check-ship-ready.ts +103 -0
  447. package/sdk/src/query/check-verification-status.test.ts +143 -0
  448. package/sdk/src/query/check-verification-status.ts +160 -0
  449. package/sdk/src/query/commit.test.ts +202 -0
  450. package/sdk/src/query/commit.ts +301 -0
  451. package/sdk/src/query/config-gates.test.ts +89 -0
  452. package/sdk/src/query/config-gates.ts +69 -0
  453. package/sdk/src/query/config-mutation.test.ts +365 -0
  454. package/sdk/src/query/config-mutation.ts +497 -0
  455. package/sdk/src/query/config-query.test.ts +161 -0
  456. package/sdk/src/query/config-query.ts +190 -0
  457. package/sdk/src/query/context-history.test.ts +165 -0
  458. package/sdk/src/query/context-history.ts +467 -0
  459. package/sdk/src/query/decomposed-handlers.test.ts +365 -0
  460. package/sdk/src/query/detect-custom-files.ts +97 -0
  461. package/sdk/src/query/detect-phase-type.test.ts +105 -0
  462. package/sdk/src/query/detect-phase-type.ts +141 -0
  463. package/sdk/src/query/docs-init.ts +257 -0
  464. package/sdk/src/query/failure-capture.ts +58 -0
  465. package/sdk/src/query/frontmatter-array.test.ts +14 -0
  466. package/sdk/src/query/frontmatter-mutation.test.ts +259 -0
  467. package/sdk/src/query/frontmatter-mutation.ts +343 -0
  468. package/sdk/src/query/frontmatter.test.ts +281 -0
  469. package/sdk/src/query/frontmatter.ts +397 -0
  470. package/sdk/src/query/helpers.test.ts +426 -0
  471. package/sdk/src/query/helpers.ts +482 -0
  472. package/sdk/src/query/index.ts +586 -0
  473. package/sdk/src/query/init-complex.test.ts +232 -0
  474. package/sdk/src/query/init-complex.ts +578 -0
  475. package/sdk/src/query/init.test.ts +522 -0
  476. package/sdk/src/query/init.ts +1046 -0
  477. package/sdk/src/query/intel.test.ts +90 -0
  478. package/sdk/src/query/intel.ts +404 -0
  479. package/sdk/src/query/normalize-query-command.test.ts +50 -0
  480. package/sdk/src/query/normalize-query-command.ts +56 -0
  481. package/sdk/src/query/phase-lifecycle.test.ts +1126 -0
  482. package/sdk/src/query/phase-lifecycle.ts +1799 -0
  483. package/sdk/src/query/phase-list-queries.test.ts +88 -0
  484. package/sdk/src/query/phase-list-queries.ts +152 -0
  485. package/sdk/src/query/phase-ready.test.ts +65 -0
  486. package/sdk/src/query/phase-ready.ts +158 -0
  487. package/sdk/src/query/phase.test.ts +307 -0
  488. package/sdk/src/query/phase.ts +340 -0
  489. package/sdk/src/query/pipeline.test.ts +169 -0
  490. package/sdk/src/query/pipeline.ts +243 -0
  491. package/sdk/src/query/plan-execution-route.test.ts +166 -0
  492. package/sdk/src/query/plan-execution-route.ts +209 -0
  493. package/sdk/src/query/plan-task-structure.test.ts +65 -0
  494. package/sdk/src/query/plan-task-structure.ts +63 -0
  495. package/sdk/src/query/profile-extract-messages.ts +247 -0
  496. package/sdk/src/query/profile-output.ts +908 -0
  497. package/sdk/src/query/profile-questionnaire-data.ts +181 -0
  498. package/sdk/src/query/profile-sample.ts +184 -0
  499. package/sdk/src/query/profile-scan-sessions.ts +174 -0
  500. package/sdk/src/query/profile.test.ts +74 -0
  501. package/sdk/src/query/profile.ts +337 -0
  502. package/sdk/src/query/progress.test.ts +156 -0
  503. package/sdk/src/query/progress.ts +566 -0
  504. package/sdk/src/query/registry.test.ts +216 -0
  505. package/sdk/src/query/registry.ts +174 -0
  506. package/sdk/src/query/requirements-extract-from-plans.test.ts +58 -0
  507. package/sdk/src/query/requirements-extract-from-plans.ts +86 -0
  508. package/sdk/src/query/roadmap-update-plan-progress.ts +132 -0
  509. package/sdk/src/query/roadmap.test.ts +359 -0
  510. package/sdk/src/query/roadmap.ts +591 -0
  511. package/sdk/src/query/route-next-action.test.ts +61 -0
  512. package/sdk/src/query/route-next-action.ts +345 -0
  513. package/sdk/src/query/runtime-health.ts +7 -0
  514. package/sdk/src/query/schema-detect.ts +189 -0
  515. package/sdk/src/query/skill-manifest.ts +214 -0
  516. package/sdk/src/query/skills.test.ts +80 -0
  517. package/sdk/src/query/skills.ts +62 -0
  518. package/sdk/src/query/state-mutation.test.ts +450 -0
  519. package/sdk/src/query/state-mutation.ts +1444 -0
  520. package/sdk/src/query/state-project-load.ts +109 -0
  521. package/sdk/src/query/state.test.ts +347 -0
  522. package/sdk/src/query/state.ts +397 -0
  523. package/sdk/src/query/summary.test.ts +95 -0
  524. package/sdk/src/query/summary.ts +296 -0
  525. package/sdk/src/query/template.test.ts +180 -0
  526. package/sdk/src/query/template.ts +242 -0
  527. package/sdk/src/query/uat.test.ts +77 -0
  528. package/sdk/src/query/uat.ts +314 -0
  529. package/sdk/src/query/utils.test.ts +82 -0
  530. package/sdk/src/query/utils.ts +92 -0
  531. package/sdk/src/query/validate.test.ts +656 -0
  532. package/sdk/src/query/validate.ts +807 -0
  533. package/sdk/src/query/verify.test.ts +414 -0
  534. package/sdk/src/query/verify.ts +645 -0
  535. package/sdk/src/query/websearch.test.ts +31 -0
  536. package/sdk/src/query/websearch.ts +82 -0
  537. package/sdk/src/query/workspace.test.ts +119 -0
  538. package/sdk/src/query/workspace.ts +131 -0
  539. package/sdk/src/query/workstream.test.ts +51 -0
  540. package/sdk/src/query/workstream.ts +434 -0
  541. package/sdk/src/research-gate.test.ts +190 -0
  542. package/sdk/src/research-gate.ts +94 -0
  543. package/sdk/src/runtime-health.test.ts +176 -0
  544. package/sdk/src/runtime-health.ts +387 -0
  545. package/sdk/src/session-runner.test.ts +98 -0
  546. package/sdk/src/session-runner.ts +299 -0
  547. package/sdk/src/tool-scoping.test.ts +160 -0
  548. package/sdk/src/tool-scoping.ts +61 -0
  549. package/sdk/src/types.ts +917 -0
  550. package/sdk/src/workstream-utils.ts +33 -0
  551. package/sdk/src/ws-flag.test.ts +285 -0
  552. package/sdk/src/ws-transport.test.ts +161 -0
  553. package/sdk/src/ws-transport.ts +93 -0
  554. package/sdk/tsconfig.json +20 -0
@@ -0,0 +1,757 @@
1
+ /**
2
+ * Open Artifact Audit — Cross-type unresolved state scanner
3
+ *
4
+ * Scans all .planning/ artifact categories for items with open/unresolved state.
5
+ * Returns structured JSON for workflow consumption.
6
+ * Called by: gsd-tools.cjs audit-open
7
+ * Used by: /gsd-complete-milestone pre-close gate
8
+ */
9
+
10
+ 'use strict';
11
+
12
+ const fs = require('fs');
13
+ const path = require('path');
14
+ const { planningDir, toPosixPath } = require('./core.cjs');
15
+ const { extractFrontmatter } = require('./frontmatter.cjs');
16
+ const { requireSafePath, sanitizeForDisplay } = require('./security.cjs');
17
+
18
+ /**
19
+ * Scan .planning/debug/ for open sessions.
20
+ * Open = status NOT in ['resolved', 'complete'].
21
+ * Ignores the resolved/ subdirectory.
22
+ */
23
+ function scanDebugSessions(planDir) {
24
+ const debugDir = path.join(planDir, 'debug');
25
+ if (!fs.existsSync(debugDir)) return [];
26
+
27
+ const results = [];
28
+ let files;
29
+ try {
30
+ files = fs.readdirSync(debugDir, { withFileTypes: true });
31
+ } catch {
32
+ return [{ scan_error: true }];
33
+ }
34
+
35
+ for (const entry of files) {
36
+ if (!entry.isFile()) continue;
37
+ if (!entry.name.endsWith('.md')) continue;
38
+
39
+ const filePath = path.join(debugDir, entry.name);
40
+
41
+ let safeFilePath;
42
+ try {
43
+ safeFilePath = requireSafePath(filePath, planDir, 'debug session file', { allowAbsolute: true });
44
+ } catch {
45
+ continue;
46
+ }
47
+
48
+ let content;
49
+ try {
50
+ content = fs.readFileSync(safeFilePath, 'utf-8');
51
+ } catch {
52
+ continue;
53
+ }
54
+
55
+ const fm = extractFrontmatter(content);
56
+ const status = (fm.status || 'unknown').toLowerCase();
57
+ if (status === 'resolved' || status === 'complete') continue;
58
+
59
+ // Extract hypothesis from "Current Focus" block if parseable
60
+ let hypothesis = '';
61
+ const focusMatch = content.match(/##\s*Current Focus[^\n]*\n([\s\S]*?)(?=\n##\s|$)/i);
62
+ if (focusMatch) {
63
+ const focusText = focusMatch[1].trim().split('\n')[0].trim();
64
+ hypothesis = sanitizeForDisplay(focusText.slice(0, 100));
65
+ }
66
+
67
+ const slug = path.basename(entry.name, '.md');
68
+ results.push({
69
+ slug: sanitizeForDisplay(slug),
70
+ status: sanitizeForDisplay(status),
71
+ updated: sanitizeForDisplay(String(fm.updated || fm.date || '')),
72
+ hypothesis,
73
+ });
74
+ }
75
+
76
+ return results;
77
+ }
78
+
79
+ /**
80
+ * Scan .planning/quick/ for incomplete tasks.
81
+ * Incomplete if SUMMARY.md missing or status !== 'complete'.
82
+ */
83
+ function scanQuickTasks(planDir) {
84
+ const quickDir = path.join(planDir, 'quick');
85
+ if (!fs.existsSync(quickDir)) return [];
86
+
87
+ let entries;
88
+ try {
89
+ entries = fs.readdirSync(quickDir, { withFileTypes: true });
90
+ } catch {
91
+ return [{ scan_error: true }];
92
+ }
93
+
94
+ const results = [];
95
+ for (const entry of entries) {
96
+ if (!entry.isDirectory()) continue;
97
+
98
+ const dirName = entry.name;
99
+ const taskDir = path.join(quickDir, dirName);
100
+
101
+ let safeTaskDir;
102
+ try {
103
+ safeTaskDir = requireSafePath(taskDir, planDir, 'quick task dir', { allowAbsolute: true });
104
+ } catch {
105
+ continue;
106
+ }
107
+
108
+ const summaryPath = path.join(safeTaskDir, 'SUMMARY.md');
109
+
110
+ let status = 'missing';
111
+ let description = '';
112
+
113
+ if (fs.existsSync(summaryPath)) {
114
+ let safeSum;
115
+ try {
116
+ safeSum = requireSafePath(summaryPath, planDir, 'quick task summary', { allowAbsolute: true });
117
+ } catch {
118
+ continue;
119
+ }
120
+ try {
121
+ const content = fs.readFileSync(safeSum, 'utf-8');
122
+ const fm = extractFrontmatter(content);
123
+ status = (fm.status || 'unknown').toLowerCase();
124
+ } catch {
125
+ status = 'unreadable';
126
+ }
127
+ }
128
+
129
+ if (status === 'complete') continue;
130
+
131
+ // Parse date and slug from directory name: YYYYMMDD-slug or YYYY-MM-DD-slug
132
+ let date = '';
133
+ let slug = sanitizeForDisplay(dirName);
134
+ const dateMatch = dirName.match(/^(\d{4}-?\d{2}-?\d{2})-(.+)$/);
135
+ if (dateMatch) {
136
+ date = dateMatch[1];
137
+ slug = sanitizeForDisplay(dateMatch[2]);
138
+ }
139
+
140
+ results.push({
141
+ slug,
142
+ date,
143
+ status: sanitizeForDisplay(status),
144
+ description,
145
+ });
146
+ }
147
+
148
+ return results;
149
+ }
150
+
151
+ /**
152
+ * Scan .planning/threads/ for open threads.
153
+ * Open if status in ['open', 'in_progress', 'in progress'] (case-insensitive).
154
+ */
155
+ function scanThreads(planDir) {
156
+ const threadsDir = path.join(planDir, 'threads');
157
+ if (!fs.existsSync(threadsDir)) return [];
158
+
159
+ let files;
160
+ try {
161
+ files = fs.readdirSync(threadsDir, { withFileTypes: true });
162
+ } catch {
163
+ return [{ scan_error: true }];
164
+ }
165
+
166
+ const openStatuses = new Set(['open', 'in_progress', 'in progress']);
167
+ const results = [];
168
+
169
+ for (const entry of files) {
170
+ if (!entry.isFile()) continue;
171
+ if (!entry.name.endsWith('.md')) continue;
172
+
173
+ const filePath = path.join(threadsDir, entry.name);
174
+
175
+ let safeFilePath;
176
+ try {
177
+ safeFilePath = requireSafePath(filePath, planDir, 'thread file', { allowAbsolute: true });
178
+ } catch {
179
+ continue;
180
+ }
181
+
182
+ let content;
183
+ try {
184
+ content = fs.readFileSync(safeFilePath, 'utf-8');
185
+ } catch {
186
+ continue;
187
+ }
188
+
189
+ const fm = extractFrontmatter(content);
190
+ let status = (fm.status || '').toLowerCase().trim();
191
+
192
+ // Fall back to scanning body for ## Status: OPEN / IN PROGRESS
193
+ if (!status) {
194
+ const bodyStatusMatch = content.match(/##\s*Status:\s*(OPEN|IN PROGRESS|IN_PROGRESS)/i);
195
+ if (bodyStatusMatch) {
196
+ status = bodyStatusMatch[1].toLowerCase().replace(/ /g, '_');
197
+ }
198
+ }
199
+
200
+ if (!openStatuses.has(status)) continue;
201
+
202
+ // Extract title from # Thread: heading or frontmatter title
203
+ let title = sanitizeForDisplay(String(fm.title || ''));
204
+ if (!title) {
205
+ const headingMatch = content.match(/^#\s*Thread:\s*(.+)$/m);
206
+ if (headingMatch) {
207
+ title = sanitizeForDisplay(headingMatch[1].trim().slice(0, 100));
208
+ }
209
+ }
210
+
211
+ const slug = path.basename(entry.name, '.md');
212
+ results.push({
213
+ slug: sanitizeForDisplay(slug),
214
+ status: sanitizeForDisplay(status),
215
+ updated: sanitizeForDisplay(String(fm.updated || fm.date || '')),
216
+ title,
217
+ });
218
+ }
219
+
220
+ return results;
221
+ }
222
+
223
+ /**
224
+ * Scan .planning/todos/pending/ for pending todos.
225
+ * Returns array of { filename, priority, area, summary }.
226
+ * Display limited to first 5 + count of remainder.
227
+ */
228
+ function scanTodos(planDir) {
229
+ const pendingDir = path.join(planDir, 'todos', 'pending');
230
+ if (!fs.existsSync(pendingDir)) return [];
231
+
232
+ let files;
233
+ try {
234
+ files = fs.readdirSync(pendingDir, { withFileTypes: true });
235
+ } catch {
236
+ return [{ scan_error: true }];
237
+ }
238
+
239
+ const mdFiles = files.filter(e => e.isFile() && e.name.endsWith('.md'));
240
+ const results = [];
241
+
242
+ const displayFiles = mdFiles.slice(0, 5);
243
+ for (const entry of displayFiles) {
244
+ const filePath = path.join(pendingDir, entry.name);
245
+
246
+ let safeFilePath;
247
+ try {
248
+ safeFilePath = requireSafePath(filePath, planDir, 'todo file', { allowAbsolute: true });
249
+ } catch {
250
+ continue;
251
+ }
252
+
253
+ let content;
254
+ try {
255
+ content = fs.readFileSync(safeFilePath, 'utf-8');
256
+ } catch {
257
+ continue;
258
+ }
259
+
260
+ const fm = extractFrontmatter(content);
261
+
262
+ // Extract first line of body after frontmatter
263
+ const bodyMatch = content.replace(/^---[\s\S]*?---\n?/, '');
264
+ const firstLine = bodyMatch.trim().split('\n')[0] || '';
265
+ const summary = sanitizeForDisplay(firstLine.slice(0, 100));
266
+
267
+ results.push({
268
+ filename: sanitizeForDisplay(entry.name),
269
+ priority: sanitizeForDisplay(String(fm.priority || '')),
270
+ area: sanitizeForDisplay(String(fm.area || '')),
271
+ summary,
272
+ });
273
+ }
274
+
275
+ if (mdFiles.length > 5) {
276
+ results.push({ _remainder_count: mdFiles.length - 5 });
277
+ }
278
+
279
+ return results;
280
+ }
281
+
282
+ /**
283
+ * Scan .planning/seeds/SEED-*.md for unimplemented seeds.
284
+ * Unimplemented if status in ['dormant', 'active', 'triggered'].
285
+ */
286
+ function scanSeeds(planDir) {
287
+ const seedsDir = path.join(planDir, 'seeds');
288
+ if (!fs.existsSync(seedsDir)) return [];
289
+
290
+ let files;
291
+ try {
292
+ files = fs.readdirSync(seedsDir, { withFileTypes: true });
293
+ } catch {
294
+ return [{ scan_error: true }];
295
+ }
296
+
297
+ const unimplementedStatuses = new Set(['dormant', 'active', 'triggered']);
298
+ const results = [];
299
+
300
+ for (const entry of files) {
301
+ if (!entry.isFile()) continue;
302
+ if (!entry.name.startsWith('SEED-') || !entry.name.endsWith('.md')) continue;
303
+
304
+ const filePath = path.join(seedsDir, entry.name);
305
+
306
+ let safeFilePath;
307
+ try {
308
+ safeFilePath = requireSafePath(filePath, planDir, 'seed file', { allowAbsolute: true });
309
+ } catch {
310
+ continue;
311
+ }
312
+
313
+ let content;
314
+ try {
315
+ content = fs.readFileSync(safeFilePath, 'utf-8');
316
+ } catch {
317
+ continue;
318
+ }
319
+
320
+ const fm = extractFrontmatter(content);
321
+ const status = (fm.status || 'dormant').toLowerCase();
322
+
323
+ if (!unimplementedStatuses.has(status)) continue;
324
+
325
+ // Extract seed_id from filename or frontmatter
326
+ const seedIdMatch = entry.name.match(/^(SEED-[\w-]+)\.md$/);
327
+ const seed_id = seedIdMatch ? seedIdMatch[1] : path.basename(entry.name, '.md');
328
+ const slug = sanitizeForDisplay(seed_id.replace(/^SEED-/, ''));
329
+
330
+ let title = sanitizeForDisplay(String(fm.title || ''));
331
+ if (!title) {
332
+ const headingMatch = content.match(/^#\s*(.+)$/m);
333
+ if (headingMatch) title = sanitizeForDisplay(headingMatch[1].trim().slice(0, 100));
334
+ }
335
+
336
+ results.push({
337
+ seed_id: sanitizeForDisplay(seed_id),
338
+ slug,
339
+ status: sanitizeForDisplay(status),
340
+ title,
341
+ });
342
+ }
343
+
344
+ return results;
345
+ }
346
+
347
+ /**
348
+ * Scan .planning/phases for UAT gaps (UAT files with status != 'complete').
349
+ */
350
+ function scanUatGaps(planDir) {
351
+ const phasesDir = path.join(planDir, 'phases');
352
+ if (!fs.existsSync(phasesDir)) return [];
353
+
354
+ let dirs;
355
+ try {
356
+ dirs = fs.readdirSync(phasesDir, { withFileTypes: true })
357
+ .filter(e => e.isDirectory())
358
+ .map(e => e.name)
359
+ .sort();
360
+ } catch {
361
+ return [{ scan_error: true }];
362
+ }
363
+
364
+ const results = [];
365
+
366
+ for (const dir of dirs) {
367
+ const phaseDir = path.join(phasesDir, dir);
368
+ const phaseMatch = dir.match(/^(\d+[A-Z]?(?:\.\d+)*)/i);
369
+ const phaseNum = phaseMatch ? phaseMatch[1] : dir;
370
+
371
+ let files;
372
+ try {
373
+ files = fs.readdirSync(phaseDir);
374
+ } catch {
375
+ continue;
376
+ }
377
+
378
+ for (const file of files.filter(f => f.includes('-UAT') && f.endsWith('.md'))) {
379
+ const filePath = path.join(phaseDir, file);
380
+
381
+ let safeFilePath;
382
+ try {
383
+ safeFilePath = requireSafePath(filePath, planDir, 'UAT file', { allowAbsolute: true });
384
+ } catch {
385
+ continue;
386
+ }
387
+
388
+ let content;
389
+ try {
390
+ content = fs.readFileSync(safeFilePath, 'utf-8');
391
+ } catch {
392
+ continue;
393
+ }
394
+
395
+ const fm = extractFrontmatter(content);
396
+ const status = (fm.status || 'unknown').toLowerCase();
397
+
398
+ if (status === 'complete') continue;
399
+
400
+ // Count open scenarios
401
+ const pendingMatches = (content.match(/result:\s*(?:pending|\[pending\])/gi) || []).length;
402
+
403
+ results.push({
404
+ phase: sanitizeForDisplay(phaseNum),
405
+ file: sanitizeForDisplay(file),
406
+ status: sanitizeForDisplay(status),
407
+ open_scenario_count: pendingMatches,
408
+ });
409
+ }
410
+ }
411
+
412
+ return results;
413
+ }
414
+
415
+ /**
416
+ * Scan .planning/phases for VERIFICATION gaps.
417
+ */
418
+ function scanVerificationGaps(planDir) {
419
+ const phasesDir = path.join(planDir, 'phases');
420
+ if (!fs.existsSync(phasesDir)) return [];
421
+
422
+ let dirs;
423
+ try {
424
+ dirs = fs.readdirSync(phasesDir, { withFileTypes: true })
425
+ .filter(e => e.isDirectory())
426
+ .map(e => e.name)
427
+ .sort();
428
+ } catch {
429
+ return [{ scan_error: true }];
430
+ }
431
+
432
+ const results = [];
433
+
434
+ for (const dir of dirs) {
435
+ const phaseDir = path.join(phasesDir, dir);
436
+ const phaseMatch = dir.match(/^(\d+[A-Z]?(?:\.\d+)*)/i);
437
+ const phaseNum = phaseMatch ? phaseMatch[1] : dir;
438
+
439
+ let files;
440
+ try {
441
+ files = fs.readdirSync(phaseDir);
442
+ } catch {
443
+ continue;
444
+ }
445
+
446
+ for (const file of files.filter(f => f.includes('-VERIFICATION') && f.endsWith('.md'))) {
447
+ const filePath = path.join(phaseDir, file);
448
+
449
+ let safeFilePath;
450
+ try {
451
+ safeFilePath = requireSafePath(filePath, planDir, 'VERIFICATION file', { allowAbsolute: true });
452
+ } catch {
453
+ continue;
454
+ }
455
+
456
+ let content;
457
+ try {
458
+ content = fs.readFileSync(safeFilePath, 'utf-8');
459
+ } catch {
460
+ continue;
461
+ }
462
+
463
+ const fm = extractFrontmatter(content);
464
+ const status = (fm.status || 'unknown').toLowerCase();
465
+
466
+ if (status !== 'gaps_found' && status !== 'human_needed') continue;
467
+
468
+ results.push({
469
+ phase: sanitizeForDisplay(phaseNum),
470
+ file: sanitizeForDisplay(file),
471
+ status: sanitizeForDisplay(status),
472
+ });
473
+ }
474
+ }
475
+
476
+ return results;
477
+ }
478
+
479
+ /**
480
+ * Scan .planning/phases for CONTEXT files with open_questions.
481
+ */
482
+ function scanContextQuestions(planDir) {
483
+ const phasesDir = path.join(planDir, 'phases');
484
+ if (!fs.existsSync(phasesDir)) return [];
485
+
486
+ let dirs;
487
+ try {
488
+ dirs = fs.readdirSync(phasesDir, { withFileTypes: true })
489
+ .filter(e => e.isDirectory())
490
+ .map(e => e.name)
491
+ .sort();
492
+ } catch {
493
+ return [{ scan_error: true }];
494
+ }
495
+
496
+ const results = [];
497
+
498
+ for (const dir of dirs) {
499
+ const phaseDir = path.join(phasesDir, dir);
500
+ const phaseMatch = dir.match(/^(\d+[A-Z]?(?:\.\d+)*)/i);
501
+ const phaseNum = phaseMatch ? phaseMatch[1] : dir;
502
+
503
+ let files;
504
+ try {
505
+ files = fs.readdirSync(phaseDir);
506
+ } catch {
507
+ continue;
508
+ }
509
+
510
+ for (const file of files.filter(f => f.includes('-CONTEXT') && f.endsWith('.md'))) {
511
+ const filePath = path.join(phaseDir, file);
512
+
513
+ let safeFilePath;
514
+ try {
515
+ safeFilePath = requireSafePath(filePath, planDir, 'CONTEXT file', { allowAbsolute: true });
516
+ } catch {
517
+ continue;
518
+ }
519
+
520
+ let content;
521
+ try {
522
+ content = fs.readFileSync(safeFilePath, 'utf-8');
523
+ } catch {
524
+ continue;
525
+ }
526
+
527
+ const fm = extractFrontmatter(content);
528
+
529
+ // Check frontmatter open_questions field
530
+ let questions = [];
531
+ if (fm.open_questions) {
532
+ if (Array.isArray(fm.open_questions) && fm.open_questions.length > 0) {
533
+ questions = fm.open_questions.map(q => sanitizeForDisplay(String(q).slice(0, 200)));
534
+ }
535
+ }
536
+
537
+ // Also check for ## Open Questions section in body
538
+ if (questions.length === 0) {
539
+ const oqMatch = content.match(/##\s*Open Questions[^\n]*\n([\s\S]*?)(?=\n##\s|$)/i);
540
+ if (oqMatch) {
541
+ const oqBody = oqMatch[1].trim();
542
+ if (oqBody && oqBody.length > 0 && !/^\s*none\s*$/i.test(oqBody)) {
543
+ const items = oqBody.split('\n')
544
+ .map(l => l.trim())
545
+ .filter(l => l && l !== '-' && l !== '*')
546
+ .filter(l => /^[-*\d]/.test(l) || l.includes('?'));
547
+ questions = items.slice(0, 3).map(q => sanitizeForDisplay(q.slice(0, 200)));
548
+ }
549
+ }
550
+ }
551
+
552
+ if (questions.length === 0) continue;
553
+
554
+ results.push({
555
+ phase: sanitizeForDisplay(phaseNum),
556
+ file: sanitizeForDisplay(file),
557
+ question_count: questions.length,
558
+ questions: questions.slice(0, 3),
559
+ });
560
+ }
561
+ }
562
+
563
+ return results;
564
+ }
565
+
566
+ /**
567
+ * Main audit function. Scans all .planning/ artifact categories.
568
+ *
569
+ * @param {string} cwd - Project root directory
570
+ * @returns {object} Structured audit result
571
+ */
572
+ function auditOpenArtifacts(cwd) {
573
+ const planDir = planningDir(cwd);
574
+
575
+ const debugSessions = (() => {
576
+ try { return scanDebugSessions(planDir); } catch { return [{ scan_error: true }]; }
577
+ })();
578
+
579
+ const quickTasks = (() => {
580
+ try { return scanQuickTasks(planDir); } catch { return [{ scan_error: true }]; }
581
+ })();
582
+
583
+ const threads = (() => {
584
+ try { return scanThreads(planDir); } catch { return [{ scan_error: true }]; }
585
+ })();
586
+
587
+ const todos = (() => {
588
+ try { return scanTodos(planDir); } catch { return [{ scan_error: true }]; }
589
+ })();
590
+
591
+ const seeds = (() => {
592
+ try { return scanSeeds(planDir); } catch { return [{ scan_error: true }]; }
593
+ })();
594
+
595
+ const uatGaps = (() => {
596
+ try { return scanUatGaps(planDir); } catch { return [{ scan_error: true }]; }
597
+ })();
598
+
599
+ const verificationGaps = (() => {
600
+ try { return scanVerificationGaps(planDir); } catch { return [{ scan_error: true }]; }
601
+ })();
602
+
603
+ const contextQuestions = (() => {
604
+ try { return scanContextQuestions(planDir); } catch { return [{ scan_error: true }]; }
605
+ })();
606
+
607
+ // Count real items (not scan_error sentinels)
608
+ const countReal = arr => arr.filter(i => !i.scan_error && !i._remainder_count).length;
609
+
610
+ const counts = {
611
+ debug_sessions: countReal(debugSessions),
612
+ quick_tasks: countReal(quickTasks),
613
+ threads: countReal(threads),
614
+ todos: countReal(todos),
615
+ seeds: countReal(seeds),
616
+ uat_gaps: countReal(uatGaps),
617
+ verification_gaps: countReal(verificationGaps),
618
+ context_questions: countReal(contextQuestions),
619
+ };
620
+ counts.total = Object.values(counts).reduce((s, n) => s + n, 0);
621
+
622
+ return {
623
+ scanned_at: new Date().toISOString(),
624
+ has_open_items: counts.total > 0,
625
+ counts,
626
+ items: {
627
+ debug_sessions: debugSessions,
628
+ quick_tasks: quickTasks,
629
+ threads,
630
+ todos,
631
+ seeds,
632
+ uat_gaps: uatGaps,
633
+ verification_gaps: verificationGaps,
634
+ context_questions: contextQuestions,
635
+ },
636
+ };
637
+ }
638
+
639
+ /**
640
+ * Format the audit result as a human-readable report.
641
+ *
642
+ * @param {object} auditResult - Result from auditOpenArtifacts()
643
+ * @returns {string} Formatted report
644
+ */
645
+ function formatAuditReport(auditResult) {
646
+ const { counts, items, has_open_items } = auditResult;
647
+ const lines = [];
648
+ const hr = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━';
649
+
650
+ lines.push(hr);
651
+ lines.push(' Milestone Close: Open Artifact Audit');
652
+ lines.push(hr);
653
+
654
+ if (!has_open_items) {
655
+ lines.push('');
656
+ lines.push(' All artifact types clear. Safe to proceed.');
657
+ lines.push('');
658
+ lines.push(hr);
659
+ return lines.join('\n');
660
+ }
661
+
662
+ // Debug sessions (blocking quality — red)
663
+ if (counts.debug_sessions > 0) {
664
+ lines.push('');
665
+ lines.push(`🔴 Debug Sessions (${counts.debug_sessions} open)`);
666
+ for (const item of items.debug_sessions.filter(i => !i.scan_error)) {
667
+ const hyp = item.hypothesis ? ` — ${item.hypothesis}` : '';
668
+ lines.push(` • ${item.slug} [${item.status}]${hyp}`);
669
+ }
670
+ }
671
+
672
+ // UAT gaps (blocking quality — red)
673
+ if (counts.uat_gaps > 0) {
674
+ lines.push('');
675
+ lines.push(`🔴 UAT Gaps (${counts.uat_gaps} phases with incomplete UAT)`);
676
+ for (const item of items.uat_gaps.filter(i => !i.scan_error)) {
677
+ lines.push(` • Phase ${item.phase}: ${item.file} [${item.status}] — ${item.open_scenario_count} pending scenarios`);
678
+ }
679
+ }
680
+
681
+ // Verification gaps (blocking quality — red)
682
+ if (counts.verification_gaps > 0) {
683
+ lines.push('');
684
+ lines.push(`🔴 Verification Gaps (${counts.verification_gaps} unresolved)`);
685
+ for (const item of items.verification_gaps.filter(i => !i.scan_error)) {
686
+ lines.push(` • Phase ${item.phase}: ${item.file} [${item.status}]`);
687
+ }
688
+ }
689
+
690
+ // Quick tasks (incomplete work — yellow)
691
+ if (counts.quick_tasks > 0) {
692
+ lines.push('');
693
+ lines.push(`🟡 Quick Tasks (${counts.quick_tasks} incomplete)`);
694
+ for (const item of items.quick_tasks.filter(i => !i.scan_error)) {
695
+ const d = item.date ? ` (${item.date})` : '';
696
+ lines.push(` • ${item.slug}${d} [${item.status}]`);
697
+ }
698
+ }
699
+
700
+ // Todos (incomplete work — yellow)
701
+ if (counts.todos > 0) {
702
+ const realTodos = items.todos.filter(i => !i.scan_error && !i._remainder_count);
703
+ const remainder = items.todos.find(i => i._remainder_count);
704
+ lines.push('');
705
+ lines.push(`🟡 Pending Todos (${counts.todos} pending)`);
706
+ for (const item of realTodos) {
707
+ const area = item.area ? ` [${item.area}]` : '';
708
+ const pri = item.priority ? ` (${item.priority})` : '';
709
+ lines.push(` • ${item.filename}${area}${pri}`);
710
+ if (item.summary) lines.push(` ${item.summary}`);
711
+ }
712
+ if (remainder) {
713
+ lines.push(` ... and ${remainder._remainder_count} more`);
714
+ }
715
+ }
716
+
717
+ // Threads (deferred decisions — blue)
718
+ if (counts.threads > 0) {
719
+ lines.push('');
720
+ lines.push(`🔵 Open Threads (${counts.threads} active)`);
721
+ for (const item of items.threads.filter(i => !i.scan_error)) {
722
+ const title = item.title ? ` — ${item.title}` : '';
723
+ lines.push(` • ${item.slug} [${item.status}]${title}`);
724
+ }
725
+ }
726
+
727
+ // Seeds (deferred decisions — blue)
728
+ if (counts.seeds > 0) {
729
+ lines.push('');
730
+ lines.push(`🔵 Unimplemented Seeds (${counts.seeds} pending)`);
731
+ for (const item of items.seeds.filter(i => !i.scan_error)) {
732
+ const title = item.title ? ` — ${item.title}` : '';
733
+ lines.push(` • ${item.seed_id} [${item.status}]${title}`);
734
+ }
735
+ }
736
+
737
+ // Context questions (deferred decisions — blue)
738
+ if (counts.context_questions > 0) {
739
+ lines.push('');
740
+ lines.push(`🔵 CONTEXT Open Questions (${counts.context_questions} phases with open questions)`);
741
+ for (const item of items.context_questions.filter(i => !i.scan_error)) {
742
+ lines.push(` • Phase ${item.phase}: ${item.file} (${item.question_count} question${item.question_count !== 1 ? 's' : ''})`);
743
+ for (const q of item.questions) {
744
+ lines.push(` - ${q}`);
745
+ }
746
+ }
747
+ }
748
+
749
+ lines.push('');
750
+ lines.push(hr);
751
+ lines.push(` ${counts.total} item${counts.total !== 1 ? 's' : ''} require decisions before close.`);
752
+ lines.push(hr);
753
+
754
+ return lines.join('\n');
755
+ }
756
+
757
+ module.exports = { auditOpenArtifacts, formatAuditReport };