rafcode 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 (370) hide show
  1. package/.claude/settings.local.json +32 -0
  2. package/CLAUDE.md +187 -0
  3. package/LICENSE +21 -0
  4. package/RAF/001-raf-task-improvements/input.md +9 -0
  5. package/RAF/001-raf-task-improvements/outcomes/001-add-decisions-folder.md +21 -0
  6. package/RAF/001-raf-task-improvements/outcomes/002-fix-write-error-on-shutdown.md +22 -0
  7. package/RAF/001-raf-task-improvements/outcomes/003-stash-changes-on-failure.md +34 -0
  8. package/RAF/001-raf-task-improvements/outcomes/004-add-project-name-to-commits.md +28 -0
  9. package/RAF/001-raf-task-improvements/outcomes/005-add-running-time-display.md +36 -0
  10. package/RAF/001-raf-task-improvements/outcomes/006-add-task-name-to-logs.md +22 -0
  11. package/RAF/001-raf-task-improvements/outcomes/007-show-model-at-task-start.md +52 -0
  12. package/RAF/001-raf-task-improvements/outcomes/009-remove-editor-placeholder-text.md +20 -0
  13. package/RAF/001-raf-task-improvements/outcomes/SUMMARY.md +83 -0
  14. package/RAF/001-raf-task-improvements/plans/001-add-decisions-folder.md +38 -0
  15. package/RAF/001-raf-task-improvements/plans/002-fix-write-error-on-shutdown.md +33 -0
  16. package/RAF/001-raf-task-improvements/plans/003-stash-changes-on-failure.md +37 -0
  17. package/RAF/001-raf-task-improvements/plans/004-add-project-name-to-commits.md +34 -0
  18. package/RAF/001-raf-task-improvements/plans/005-add-running-time-display.md +39 -0
  19. package/RAF/001-raf-task-improvements/plans/006-add-task-name-to-logs.md +37 -0
  20. package/RAF/001-raf-task-improvements/plans/009-remove-editor-placeholder-text.md +34 -0
  21. package/RAF/002-raf-task-improvements-execution/decisions/DECISIONS.md +13 -0
  22. package/RAF/002-raf-task-improvements-execution/input.md +3 -0
  23. package/RAF/002-raf-task-improvements-execution/outcomes/001-commit-show-model-at-task-start.md +17 -0
  24. package/RAF/002-raf-task-improvements-execution/outcomes/002-delete-skipped-plan.md +23 -0
  25. package/RAF/002-raf-task-improvements-execution/outcomes/SUMMARY.md +32 -0
  26. package/RAF/002-raf-task-improvements-execution/plans/001-commit-show-model-at-task-start.md +37 -0
  27. package/RAF/002-raf-task-improvements-execution/plans/002-delete-skipped-plan.md +23 -0
  28. package/RAF/003-multi-project-execution/decisions/DECISIONS.md +68 -0
  29. package/RAF/003-multi-project-execution/input.md +6 -0
  30. package/RAF/003-multi-project-execution/outcomes/001-remove-state-json.md +52 -0
  31. package/RAF/003-multi-project-execution/outcomes/002-update-raf-status.md +50 -0
  32. package/RAF/003-multi-project-execution/outcomes/003-simplify-git-logic.md +35 -0
  33. package/RAF/003-multi-project-execution/outcomes/004-auto-commit-planning.md +43 -0
  34. package/RAF/003-multi-project-execution/outcomes/005-rerun-failed-tasks.md +43 -0
  35. package/RAF/003-multi-project-execution/outcomes/006-multi-project-execution.md +42 -0
  36. package/RAF/003-multi-project-execution/outcomes/007-verify-timeout.md +54 -0
  37. package/RAF/003-multi-project-execution/outcomes/008-move-decisions-file.md +38 -0
  38. package/RAF/003-multi-project-execution/outcomes/SUMMARY.md +79 -0
  39. package/RAF/003-multi-project-execution/plans/001-remove-state-json.md +71 -0
  40. package/RAF/003-multi-project-execution/plans/002-update-raf-status.md +65 -0
  41. package/RAF/003-multi-project-execution/plans/003-simplify-git-logic.md +74 -0
  42. package/RAF/003-multi-project-execution/plans/004-auto-commit-planning.md +57 -0
  43. package/RAF/003-multi-project-execution/plans/005-rerun-failed-tasks.md +69 -0
  44. package/RAF/003-multi-project-execution/plans/006-multi-project-execution.md +81 -0
  45. package/RAF/003-multi-project-execution/plans/007-verify-timeout.md +63 -0
  46. package/RAF/003-multi-project-execution/plans/008-move-decisions-file.md +78 -0
  47. package/RAF/004-task-naming-optimization/decisions.md +22 -0
  48. package/RAF/004-task-naming-optimization/input.md +6 -0
  49. package/RAF/004-task-naming-optimization/outcomes/001-remove-summary-file.md +17 -0
  50. package/RAF/004-task-naming-optimization/outcomes/002-base36-project-numbering.md +32 -0
  51. package/RAF/004-task-naming-optimization/outcomes/003-improve-haiku-prompt.md +20 -0
  52. package/RAF/004-task-naming-optimization/outcomes/SUMMARY.md +28 -0
  53. package/RAF/004-task-naming-optimization/plans/001-remove-summary-file.md +34 -0
  54. package/RAF/004-task-naming-optimization/plans/002-base36-project-numbering.md +56 -0
  55. package/RAF/004-task-naming-optimization/plans/003-improve-haiku-prompt.md +50 -0
  56. package/RAF/005-task-naming-improvements/decisions.md +60 -0
  57. package/RAF/005-task-naming-improvements/input.md +2 -0
  58. package/RAF/005-task-naming-improvements/outcomes/001-enhance-identifier-resolution.md +42 -0
  59. package/RAF/005-task-naming-improvements/outcomes/002-add-identifier-support-to-status.md +38 -0
  60. package/RAF/005-task-naming-improvements/outcomes/003-update-do-for-full-folder-names.md +44 -0
  61. package/RAF/005-task-naming-improvements/outcomes/004-implement-amend-flag-for-plan.md +55 -0
  62. package/RAF/005-task-naming-improvements/outcomes/005-commit-outcomes-on-complete.md +47 -0
  63. package/RAF/005-task-naming-improvements/outcomes/006-update-execution-prompt-commit-schema.md +40 -0
  64. package/RAF/005-task-naming-improvements/outcomes/007-allow-pending-task-amendments.md +38 -0
  65. package/RAF/005-task-naming-improvements/outcomes/008-fix-timeout-label.md +24 -0
  66. package/RAF/005-task-naming-improvements/plans/001-enhance-identifier-resolution.md +46 -0
  67. package/RAF/005-task-naming-improvements/plans/002-add-identifier-support-to-status.md +36 -0
  68. package/RAF/005-task-naming-improvements/plans/003-update-do-for-full-folder-names.md +38 -0
  69. package/RAF/005-task-naming-improvements/plans/004-implement-amend-flag-for-plan.md +67 -0
  70. package/RAF/005-task-naming-improvements/plans/005-commit-outcomes-on-complete.md +86 -0
  71. package/RAF/005-task-naming-improvements/plans/006-update-execution-prompt-commit-schema.md +60 -0
  72. package/RAF/005-task-naming-improvements/plans/007-allow-pending-task-amendments.md +60 -0
  73. package/RAF/005-task-naming-improvements/plans/008-fix-timeout-label.md +31 -0
  74. package/RAF/006-fix-double-summary-headers/decisions.md +28 -0
  75. package/RAF/006-fix-double-summary-headers/input.md +3 -0
  76. package/RAF/006-fix-double-summary-headers/outcomes/001-fix-double-summary-headers.md +29 -0
  77. package/RAF/006-fix-double-summary-headers/outcomes/002-update-readme-for-npm.md +31 -0
  78. package/RAF/006-fix-double-summary-headers/outcomes/003-npm-publish-instructions.md +30 -0
  79. package/RAF/006-fix-double-summary-headers/outcomes/004-flexible-project-lookup.md +47 -0
  80. package/RAF/006-fix-double-summary-headers/plans/001-fix-double-summary-headers.md +42 -0
  81. package/RAF/006-fix-double-summary-headers/plans/002-update-readme-for-npm.md +44 -0
  82. package/RAF/006-fix-double-summary-headers/plans/003-npm-publish-instructions.md +45 -0
  83. package/RAF/006-fix-double-summary-headers/plans/004-flexible-project-lookup.md +40 -0
  84. package/RAF/007-improve-outcome-format/decisions.md +28 -0
  85. package/RAF/007-improve-outcome-format/input.md +2 -0
  86. package/RAF/007-improve-outcome-format/outcomes/001-update-execution-prompt.md +10 -0
  87. package/RAF/007-improve-outcome-format/outcomes/002-update-state-derivation.md +17 -0
  88. package/RAF/007-improve-outcome-format/outcomes/003-update-do-command-outcome-handling.md +16 -0
  89. package/RAF/007-improve-outcome-format/outcomes/004-implement-failure-analysis.md +16 -0
  90. package/RAF/007-improve-outcome-format/outcomes/005-update-documentation.md +15 -0
  91. package/RAF/007-improve-outcome-format/plans/001-update-execution-prompt.md +36 -0
  92. package/RAF/007-improve-outcome-format/plans/002-update-state-derivation.md +35 -0
  93. package/RAF/007-improve-outcome-format/plans/003-update-do-command-outcome-handling.md +37 -0
  94. package/RAF/007-improve-outcome-format/plans/004-implement-failure-analysis.md +44 -0
  95. package/RAF/007-improve-outcome-format/plans/005-update-documentation.md +33 -0
  96. package/RAF/008-beautiful-do/decisions.md +31 -0
  97. package/RAF/008-beautiful-do/input.md +1 -0
  98. package/RAF/008-beautiful-do/outcomes/001-terminal-symbols.md +55 -0
  99. package/RAF/008-beautiful-do/outcomes/002-refactor-do-output.md +95 -0
  100. package/RAF/008-beautiful-do/outcomes/003-refactor-status-output.md +71 -0
  101. package/RAF/008-beautiful-do/outcomes/004-simplify-logger.md +53 -0
  102. package/RAF/008-beautiful-do/outcomes/005-add-tests.md +41 -0
  103. package/RAF/008-beautiful-do/plans/001-terminal-symbols.md +41 -0
  104. package/RAF/008-beautiful-do/plans/002-refactor-do-output.md +44 -0
  105. package/RAF/008-beautiful-do/plans/003-refactor-status-output.md +37 -0
  106. package/RAF/008-beautiful-do/plans/004-simplify-logger.md +32 -0
  107. package/RAF/008-beautiful-do/plans/005-add-tests.md +40 -0
  108. package/RAF/009-system-promt-ammend/decisions.md +13 -0
  109. package/RAF/009-system-promt-ammend/input.md +9 -0
  110. package/RAF/009-system-promt-ammend/outcomes/001-model-override.md +79 -0
  111. package/RAF/009-system-promt-ammend/outcomes/002-system-prompt-append.md +51 -0
  112. package/RAF/009-system-promt-ammend/outcomes/003-retry-context.md +60 -0
  113. package/RAF/009-system-promt-ammend/plans/001-model-override.md +61 -0
  114. package/RAF/009-system-promt-ammend/plans/002-system-prompt-append.md +56 -0
  115. package/RAF/009-system-promt-ammend/plans/003-retry-context.md +76 -0
  116. package/RAF/010-outcome-marker-fallback/decisions.md +19 -0
  117. package/RAF/010-outcome-marker-fallback/input.md +1 -0
  118. package/RAF/010-outcome-marker-fallback/outcomes/001-outcome-file-marker-fallback.md +35 -0
  119. package/RAF/010-outcome-marker-fallback/outcomes/002-creative-project-naming.md +47 -0
  120. package/RAF/010-outcome-marker-fallback/plans/001-outcome-file-marker-fallback.md +58 -0
  121. package/RAF/010-outcome-marker-fallback/plans/002-creative-project-naming.md +68 -0
  122. package/RAF/011-do-task-in-commit/decisions.md +22 -0
  123. package/RAF/011-do-task-in-commit/input.md +1 -0
  124. package/RAF/011-do-task-in-commit/outcomes/001-update-execution-prompt.md +54 -0
  125. package/RAF/011-do-task-in-commit/outcomes/002-update-tests.md +61 -0
  126. package/RAF/011-do-task-in-commit/outcomes/003-update-documentation.md +51 -0
  127. package/RAF/011-do-task-in-commit/plans/001-update-execution-prompt.md +46 -0
  128. package/RAF/011-do-task-in-commit/plans/002-update-tests.md +51 -0
  129. package/RAF/011-do-task-in-commit/plans/003-update-documentation.md +45 -0
  130. package/RAF/012-name-picker-buffet/decisions.md +40 -0
  131. package/RAF/012-name-picker-buffet/input.md +6 -0
  132. package/RAF/012-name-picker-buffet/outcomes/001-name-picker-for-raf-plan.md +49 -0
  133. package/RAF/012-name-picker-buffet/outcomes/002-interactive-project-picker-for-raf-do.md +49 -0
  134. package/RAF/012-name-picker-buffet/outcomes/003-raf-status-truncation.md +55 -0
  135. package/RAF/012-name-picker-buffet/outcomes/004-failure-reason-details.md +65 -0
  136. package/RAF/012-name-picker-buffet/outcomes/005-remove-raf-commits.md +57 -0
  137. package/RAF/012-name-picker-buffet/outcomes/006-update-execution-prompt-for-commits.md +47 -0
  138. package/RAF/012-name-picker-buffet/outcomes/007-fix-plan-mode-user-prompt.md +83 -0
  139. package/RAF/012-name-picker-buffet/outcomes/008-add-auto-flag-for-plan-mode.md +77 -0
  140. package/RAF/012-name-picker-buffet/plans/001-name-picker-for-raf-plan.md +47 -0
  141. package/RAF/012-name-picker-buffet/plans/002-interactive-project-picker-for-raf-do.md +43 -0
  142. package/RAF/012-name-picker-buffet/plans/003-raf-status-truncation.md +36 -0
  143. package/RAF/012-name-picker-buffet/plans/004-failure-reason-details.md +46 -0
  144. package/RAF/012-name-picker-buffet/plans/005-remove-raf-commits.md +42 -0
  145. package/RAF/012-name-picker-buffet/plans/006-update-execution-prompt-for-commits.md +47 -0
  146. package/RAF/012-name-picker-buffet/plans/007-fix-plan-mode-user-prompt.md +55 -0
  147. package/RAF/012-name-picker-buffet/plans/008-add-auto-flag-for-plan-mode.md +49 -0
  148. package/RAF/013-dependencies-watchdog/decisions.md +37 -0
  149. package/RAF/013-dependencies-watchdog/input.md +1 -0
  150. package/RAF/013-dependencies-watchdog/outcomes/001-define-dependency-syntax.md +56 -0
  151. package/RAF/013-dependencies-watchdog/outcomes/002-update-planning-prompts.md +60 -0
  152. package/RAF/013-dependencies-watchdog/outcomes/003-parse-dependencies-update-state.md +81 -0
  153. package/RAF/013-dependencies-watchdog/outcomes/004-implement-dependency-checking-in-do.md +116 -0
  154. package/RAF/013-dependencies-watchdog/outcomes/005-update-execution-prompts.md +75 -0
  155. package/RAF/013-dependencies-watchdog/outcomes/006-add-tests.md +100 -0
  156. package/RAF/013-dependencies-watchdog/outcomes/007-add-act-alias.md +46 -0
  157. package/RAF/013-dependencies-watchdog/outcomes/008-add-exit-message.md +52 -0
  158. package/RAF/013-dependencies-watchdog/plans/001-define-dependency-syntax.md +32 -0
  159. package/RAF/013-dependencies-watchdog/plans/002-update-planning-prompts.md +38 -0
  160. package/RAF/013-dependencies-watchdog/plans/003-parse-dependencies-update-state.md +46 -0
  161. package/RAF/013-dependencies-watchdog/plans/004-implement-dependency-checking-in-do.md +48 -0
  162. package/RAF/013-dependencies-watchdog/plans/005-update-execution-prompts.md +44 -0
  163. package/RAF/013-dependencies-watchdog/plans/006-add-tests.md +54 -0
  164. package/RAF/013-dependencies-watchdog/plans/007-add-act-alias.md +26 -0
  165. package/RAF/013-dependencies-watchdog/plans/008-add-exit-message.md +31 -0
  166. package/RAF/014-watchdog/decisions.md +16 -0
  167. package/RAF/014-watchdog/input.md +2 -0
  168. package/RAF/014-watchdog/outcomes/001-amend-flag-position.md +50 -0
  169. package/RAF/014-watchdog/outcomes/002-details-only-on-failure.md +58 -0
  170. package/RAF/014-watchdog/plans/001-amend-flag-position.md +34 -0
  171. package/RAF/014-watchdog/plans/002-details-only-on-failure.md +46 -0
  172. package/RAF/015-name-lottery/decisions.md +14 -0
  173. package/RAF/015-name-lottery/input.md +3 -0
  174. package/RAF/015-name-lottery/outcomes/001-auto-pick-project-name.md +31 -0
  175. package/RAF/015-name-lottery/outcomes/002-mention-plan-files-in-commit.md +23 -0
  176. package/RAF/015-name-lottery/outcomes/003-fix-input-md-in-amend-flow.md +44 -0
  177. package/RAF/015-name-lottery/plans/001-auto-pick-project-name.md +38 -0
  178. package/RAF/015-name-lottery/plans/002-mention-plan-files-in-commit.md +32 -0
  179. package/RAF/015-name-lottery/plans/003-fix-input-md-in-amend-flow.md +44 -0
  180. package/README.md +116 -0
  181. package/dist/commands/do.d.ts +12 -0
  182. package/dist/commands/do.d.ts.map +1 -0
  183. package/dist/commands/do.js +684 -0
  184. package/dist/commands/do.js.map +1 -0
  185. package/dist/commands/plan.d.ts +3 -0
  186. package/dist/commands/plan.d.ts.map +1 -0
  187. package/dist/commands/plan.js +345 -0
  188. package/dist/commands/plan.js.map +1 -0
  189. package/dist/commands/status.d.ts +3 -0
  190. package/dist/commands/status.d.ts.map +1 -0
  191. package/dist/commands/status.js +117 -0
  192. package/dist/commands/status.js.map +1 -0
  193. package/dist/core/claude-runner.d.ts +78 -0
  194. package/dist/core/claude-runner.d.ts.map +1 -0
  195. package/dist/core/claude-runner.js +297 -0
  196. package/dist/core/claude-runner.js.map +1 -0
  197. package/dist/core/editor.d.ts +10 -0
  198. package/dist/core/editor.d.ts.map +1 -0
  199. package/dist/core/editor.js +77 -0
  200. package/dist/core/editor.js.map +1 -0
  201. package/dist/core/failure-analyzer.d.ts +28 -0
  202. package/dist/core/failure-analyzer.d.ts.map +1 -0
  203. package/dist/core/failure-analyzer.js +305 -0
  204. package/dist/core/failure-analyzer.js.map +1 -0
  205. package/dist/core/git.d.ts +42 -0
  206. package/dist/core/git.d.ts.map +1 -0
  207. package/dist/core/git.js +148 -0
  208. package/dist/core/git.js.map +1 -0
  209. package/dist/core/project-manager.d.ts +72 -0
  210. package/dist/core/project-manager.d.ts.map +1 -0
  211. package/dist/core/project-manager.js +193 -0
  212. package/dist/core/project-manager.js.map +1 -0
  213. package/dist/core/retry-handler.d.ts +19 -0
  214. package/dist/core/retry-handler.d.ts.map +1 -0
  215. package/dist/core/retry-handler.js +51 -0
  216. package/dist/core/retry-handler.js.map +1 -0
  217. package/dist/core/shutdown-handler.d.ts +30 -0
  218. package/dist/core/shutdown-handler.d.ts.map +1 -0
  219. package/dist/core/shutdown-handler.js +79 -0
  220. package/dist/core/shutdown-handler.js.map +1 -0
  221. package/dist/core/state-derivation.d.ts +82 -0
  222. package/dist/core/state-derivation.d.ts.map +1 -0
  223. package/dist/core/state-derivation.js +271 -0
  224. package/dist/core/state-derivation.js.map +1 -0
  225. package/dist/core/state-manager.d.ts +54 -0
  226. package/dist/core/state-manager.d.ts.map +1 -0
  227. package/dist/core/state-manager.js +198 -0
  228. package/dist/core/state-manager.js.map +1 -0
  229. package/dist/index.d.ts +3 -0
  230. package/dist/index.d.ts.map +1 -0
  231. package/dist/index.js +16 -0
  232. package/dist/index.js.map +1 -0
  233. package/dist/parsers/output-parser.d.ts +19 -0
  234. package/dist/parsers/output-parser.d.ts.map +1 -0
  235. package/dist/parsers/output-parser.js +137 -0
  236. package/dist/parsers/output-parser.js.map +1 -0
  237. package/dist/prompts/amend.d.ts +20 -0
  238. package/dist/prompts/amend.d.ts.map +1 -0
  239. package/dist/prompts/amend.js +166 -0
  240. package/dist/prompts/amend.js.map +1 -0
  241. package/dist/prompts/execution.d.ts +30 -0
  242. package/dist/prompts/execution.d.ts.map +1 -0
  243. package/dist/prompts/execution.js +179 -0
  244. package/dist/prompts/execution.js.map +1 -0
  245. package/dist/prompts/planning.d.ts +15 -0
  246. package/dist/prompts/planning.d.ts.map +1 -0
  247. package/dist/prompts/planning.js +163 -0
  248. package/dist/prompts/planning.js.map +1 -0
  249. package/dist/types/config.d.ts +26 -0
  250. package/dist/types/config.d.ts.map +1 -0
  251. package/dist/types/config.js +7 -0
  252. package/dist/types/config.js.map +1 -0
  253. package/dist/types/state.d.ts +33 -0
  254. package/dist/types/state.d.ts.map +1 -0
  255. package/dist/types/state.js +28 -0
  256. package/dist/types/state.js.map +1 -0
  257. package/dist/ui/name-picker-subprocess.d.ts +11 -0
  258. package/dist/ui/name-picker-subprocess.d.ts.map +1 -0
  259. package/dist/ui/name-picker-subprocess.js +83 -0
  260. package/dist/ui/name-picker-subprocess.js.map +1 -0
  261. package/dist/ui/name-picker.d.ts +19 -0
  262. package/dist/ui/name-picker.d.ts.map +1 -0
  263. package/dist/ui/name-picker.js +173 -0
  264. package/dist/ui/name-picker.js.map +1 -0
  265. package/dist/ui/project-picker.d.ts +27 -0
  266. package/dist/ui/project-picker.d.ts.map +1 -0
  267. package/dist/ui/project-picker.js +58 -0
  268. package/dist/ui/project-picker.js.map +1 -0
  269. package/dist/utils/config.d.ts +24 -0
  270. package/dist/utils/config.d.ts.map +1 -0
  271. package/dist/utils/config.js +63 -0
  272. package/dist/utils/config.js.map +1 -0
  273. package/dist/utils/logger.d.ts +32 -0
  274. package/dist/utils/logger.d.ts.map +1 -0
  275. package/dist/utils/logger.js +60 -0
  276. package/dist/utils/logger.js.map +1 -0
  277. package/dist/utils/name-generator.d.ts +20 -0
  278. package/dist/utils/name-generator.d.ts.map +1 -0
  279. package/dist/utils/name-generator.js +183 -0
  280. package/dist/utils/name-generator.js.map +1 -0
  281. package/dist/utils/paths.d.ts +132 -0
  282. package/dist/utils/paths.d.ts.map +1 -0
  283. package/dist/utils/paths.js +412 -0
  284. package/dist/utils/paths.js.map +1 -0
  285. package/dist/utils/status-line.d.ts +14 -0
  286. package/dist/utils/status-line.d.ts.map +1 -0
  287. package/dist/utils/status-line.js +36 -0
  288. package/dist/utils/status-line.js.map +1 -0
  289. package/dist/utils/terminal-symbols.d.ts +50 -0
  290. package/dist/utils/terminal-symbols.d.ts.map +1 -0
  291. package/dist/utils/terminal-symbols.js +97 -0
  292. package/dist/utils/terminal-symbols.js.map +1 -0
  293. package/dist/utils/timer.d.ts +17 -0
  294. package/dist/utils/timer.d.ts.map +1 -0
  295. package/dist/utils/timer.js +56 -0
  296. package/dist/utils/timer.js.map +1 -0
  297. package/dist/utils/validation.d.ts +17 -0
  298. package/dist/utils/validation.d.ts.map +1 -0
  299. package/dist/utils/validation.js +106 -0
  300. package/dist/utils/validation.js.map +1 -0
  301. package/dist/utils/version.d.ts +2 -0
  302. package/dist/utils/version.d.ts.map +1 -0
  303. package/dist/utils/version.js +12 -0
  304. package/dist/utils/version.js.map +1 -0
  305. package/jest.config.ts +30 -0
  306. package/package.json +55 -0
  307. package/src/commands/do.ts +829 -0
  308. package/src/commands/plan.ts +422 -0
  309. package/src/commands/status.ts +146 -0
  310. package/src/core/claude-runner.ts +374 -0
  311. package/src/core/editor.ts +85 -0
  312. package/src/core/failure-analyzer.ts +372 -0
  313. package/src/core/git.ts +166 -0
  314. package/src/core/project-manager.ts +243 -0
  315. package/src/core/retry-handler.ts +72 -0
  316. package/src/core/shutdown-handler.ts +93 -0
  317. package/src/core/state-derivation.ts +343 -0
  318. package/src/index.ts +20 -0
  319. package/src/parsers/output-parser.ts +164 -0
  320. package/src/prompts/amend.ts +194 -0
  321. package/src/prompts/execution.ts +223 -0
  322. package/src/prompts/planning.ts +175 -0
  323. package/src/types/config.ts +35 -0
  324. package/src/ui/name-picker-subprocess.ts +96 -0
  325. package/src/ui/name-picker.ts +198 -0
  326. package/src/ui/project-picker.ts +80 -0
  327. package/src/utils/config.ts +69 -0
  328. package/src/utils/logger.ts +81 -0
  329. package/src/utils/name-generator.ts +211 -0
  330. package/src/utils/paths.ts +497 -0
  331. package/src/utils/status-line.ts +45 -0
  332. package/src/utils/terminal-symbols.ts +124 -0
  333. package/src/utils/timer.ts +64 -0
  334. package/src/utils/validation.ts +132 -0
  335. package/src/utils/version.ts +12 -0
  336. package/tests/unit/claude-runner-interactive.test.ts +343 -0
  337. package/tests/unit/claude-runner.test.ts +629 -0
  338. package/tests/unit/command-output.test.ts +295 -0
  339. package/tests/unit/config.test.ts +72 -0
  340. package/tests/unit/dependency-integration.test.ts +559 -0
  341. package/tests/unit/do-blocked-tasks.test.ts +323 -0
  342. package/tests/unit/do-command.test.ts +198 -0
  343. package/tests/unit/do-multiproject.test.ts +270 -0
  344. package/tests/unit/do-rerun.test.ts +270 -0
  345. package/tests/unit/execution-prompt.test.ts +406 -0
  346. package/tests/unit/failure-analyzer.test.ts +276 -0
  347. package/tests/unit/failure-history.test.ts +143 -0
  348. package/tests/unit/git-stash.test.ts +138 -0
  349. package/tests/unit/git.test.ts +80 -0
  350. package/tests/unit/logger.test.ts +132 -0
  351. package/tests/unit/name-generator.test.ts +283 -0
  352. package/tests/unit/name-picker.test.ts +179 -0
  353. package/tests/unit/outcome-content.test.ts +166 -0
  354. package/tests/unit/output-parser.test.ts +178 -0
  355. package/tests/unit/paths.test.ts +741 -0
  356. package/tests/unit/plan-command-amend-flag.test.ts +115 -0
  357. package/tests/unit/plan-command-amend-input.test.ts +156 -0
  358. package/tests/unit/plan-command-auto-flag.test.ts +112 -0
  359. package/tests/unit/plan-command.test.ts +580 -0
  360. package/tests/unit/planning-prompt.test.ts +137 -0
  361. package/tests/unit/project-manager.test.ts +265 -0
  362. package/tests/unit/project-picker.test.ts +338 -0
  363. package/tests/unit/retry-handler.test.ts +89 -0
  364. package/tests/unit/state-derivation.test.ts +714 -0
  365. package/tests/unit/status-command.test.ts +271 -0
  366. package/tests/unit/status-line.test.ts +92 -0
  367. package/tests/unit/terminal-symbols.test.ts +214 -0
  368. package/tests/unit/timer.test.ts +102 -0
  369. package/tests/unit/validation.test.ts +118 -0
  370. package/tsconfig.json +26 -0
@@ -0,0 +1,343 @@
1
+ import { jest } from '@jest/globals';
2
+ import { EventEmitter } from 'events';
3
+
4
+ // Create mock pty spawn before importing ClaudeRunner
5
+ const mockPtySpawn = jest.fn();
6
+ const mockExecSync = jest.fn();
7
+
8
+ jest.unstable_mockModule('node-pty', () => ({
9
+ spawn: mockPtySpawn,
10
+ }));
11
+
12
+ jest.unstable_mockModule('node:child_process', () => ({
13
+ spawn: jest.fn(),
14
+ execSync: mockExecSync,
15
+ }));
16
+
17
+ // Import after mocking
18
+ const { ClaudeRunner } = await import('../../src/core/claude-runner.js');
19
+
20
+ describe('ClaudeRunner - runInteractive', () => {
21
+ // Save original stdin/stdout for restoration
22
+ const originalStdin = process.stdin;
23
+ const originalStdout = process.stdout;
24
+
25
+ beforeEach(() => {
26
+ jest.clearAllMocks();
27
+ mockExecSync.mockReturnValue('/usr/local/bin/claude\n');
28
+ });
29
+
30
+ afterEach(() => {
31
+ // Restore stdin/stdout
32
+ Object.defineProperty(process, 'stdin', { value: originalStdin });
33
+ Object.defineProperty(process, 'stdout', { value: originalStdout });
34
+ });
35
+
36
+ /**
37
+ * Creates a mock PTY process for testing.
38
+ */
39
+ function createMockPtyProcess() {
40
+ const proc = new EventEmitter() as any;
41
+ proc.write = jest.fn();
42
+ proc.kill = jest.fn();
43
+ proc.onData = jest.fn().mockImplementation((callback) => {
44
+ proc._dataCallback = callback;
45
+ });
46
+ proc.onExit = jest.fn().mockImplementation((callback) => {
47
+ proc._exitCallback = callback;
48
+ });
49
+ return proc;
50
+ }
51
+
52
+ /**
53
+ * Creates mock stdin for testing.
54
+ */
55
+ function createMockStdin() {
56
+ const stdin = new EventEmitter() as any;
57
+ stdin.isTTY = true;
58
+ stdin.setRawMode = jest.fn();
59
+ stdin.resume = jest.fn();
60
+ stdin.pause = jest.fn();
61
+ return stdin;
62
+ }
63
+
64
+ /**
65
+ * Creates mock stdout for testing.
66
+ */
67
+ function createMockStdout() {
68
+ const stdout = new EventEmitter() as any;
69
+ stdout.write = jest.fn();
70
+ stdout.columns = 80;
71
+ stdout.rows = 24;
72
+ return stdout;
73
+ }
74
+
75
+ describe('argument passing', () => {
76
+ it('should pass system prompt via --append-system-prompt and user message as positional arg', async () => {
77
+ const mockProc = createMockPtyProcess();
78
+ const mockStdin = createMockStdin();
79
+ const mockStdout = createMockStdout();
80
+
81
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
82
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
83
+
84
+ mockPtySpawn.mockReturnValue(mockProc);
85
+
86
+ const runner = new ClaudeRunner();
87
+ const runPromise = runner.runInteractive('System instructions here', 'User message here');
88
+
89
+ // Verify pty.spawn was called with correct arguments
90
+ expect(mockPtySpawn).toHaveBeenCalledTimes(1);
91
+ const spawnArgs = mockPtySpawn.mock.calls[0][1] as string[];
92
+
93
+ // System prompt should be passed via --append-system-prompt
94
+ expect(spawnArgs).toContain('--append-system-prompt');
95
+ const appendIndex = spawnArgs.indexOf('--append-system-prompt');
96
+ expect(spawnArgs[appendIndex + 1]).toBe('System instructions here');
97
+
98
+ // User message should be passed as positional argument (last in args)
99
+ expect(spawnArgs).toContain('User message here');
100
+ expect(spawnArgs[spawnArgs.length - 1]).toBe('User message here');
101
+
102
+ // Should NOT use -p flag (print mode)
103
+ expect(spawnArgs).not.toContain('-p');
104
+
105
+ // Simulate process exit
106
+ mockProc._exitCallback({ exitCode: 0 });
107
+ const exitCode = await runPromise;
108
+ expect(exitCode).toBe(0);
109
+ });
110
+
111
+ it('should pass model flag correctly', async () => {
112
+ const mockProc = createMockPtyProcess();
113
+ const mockStdin = createMockStdin();
114
+ const mockStdout = createMockStdout();
115
+
116
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
117
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
118
+
119
+ mockPtySpawn.mockReturnValue(mockProc);
120
+
121
+ const runner = new ClaudeRunner({ model: 'sonnet' });
122
+ const runPromise = runner.runInteractive('system', 'user');
123
+
124
+ const spawnArgs = mockPtySpawn.mock.calls[0][1] as string[];
125
+ expect(spawnArgs).toContain('--model');
126
+ expect(spawnArgs).toContain('sonnet');
127
+
128
+ mockProc._exitCallback({ exitCode: 0 });
129
+ await runPromise;
130
+ });
131
+
132
+ it('should use opus as default model', async () => {
133
+ const mockProc = createMockPtyProcess();
134
+ const mockStdin = createMockStdin();
135
+ const mockStdout = createMockStdout();
136
+
137
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
138
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
139
+
140
+ mockPtySpawn.mockReturnValue(mockProc);
141
+
142
+ const runner = new ClaudeRunner();
143
+ const runPromise = runner.runInteractive('system', 'user');
144
+
145
+ const spawnArgs = mockPtySpawn.mock.calls[0][1] as string[];
146
+ expect(spawnArgs).toContain('--model');
147
+ expect(spawnArgs).toContain('opus');
148
+
149
+ mockProc._exitCallback({ exitCode: 0 });
150
+ await runPromise;
151
+ });
152
+
153
+ it('should pass working directory to pty.spawn', async () => {
154
+ const mockProc = createMockPtyProcess();
155
+ const mockStdin = createMockStdin();
156
+ const mockStdout = createMockStdout();
157
+
158
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
159
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
160
+
161
+ mockPtySpawn.mockReturnValue(mockProc);
162
+
163
+ const runner = new ClaudeRunner();
164
+ const runPromise = runner.runInteractive('system', 'user', { cwd: '/custom/path' });
165
+
166
+ const spawnOptions = mockPtySpawn.mock.calls[0][2];
167
+ expect(spawnOptions.cwd).toBe('/custom/path');
168
+
169
+ mockProc._exitCallback({ exitCode: 0 });
170
+ await runPromise;
171
+ });
172
+ });
173
+
174
+ describe('flags order', () => {
175
+ it('should have correct order: --model, --append-system-prompt, user message', async () => {
176
+ const mockProc = createMockPtyProcess();
177
+ const mockStdin = createMockStdin();
178
+ const mockStdout = createMockStdout();
179
+
180
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
181
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
182
+
183
+ mockPtySpawn.mockReturnValue(mockProc);
184
+
185
+ const runner = new ClaudeRunner({ model: 'haiku' });
186
+ const runPromise = runner.runInteractive('My system prompt', 'My user message');
187
+
188
+ const spawnArgs = mockPtySpawn.mock.calls[0][1] as string[];
189
+
190
+ // Expected order: ['--model', 'haiku', '--append-system-prompt', 'system', 'user message']
191
+ const modelIndex = spawnArgs.indexOf('--model');
192
+ const appendIndex = spawnArgs.indexOf('--append-system-prompt');
193
+ const userMessageIndex = spawnArgs.indexOf('My user message');
194
+
195
+ // Verify order: --model before --append-system-prompt before user message
196
+ expect(modelIndex).toBeLessThan(appendIndex);
197
+ expect(appendIndex).toBeLessThan(userMessageIndex);
198
+ expect(spawnArgs[modelIndex + 1]).toBe('haiku');
199
+ expect(spawnArgs[appendIndex + 1]).toBe('My system prompt');
200
+
201
+ // User message should be last
202
+ expect(spawnArgs[spawnArgs.length - 1]).toBe('My user message');
203
+
204
+ mockProc._exitCallback({ exitCode: 0 });
205
+ await runPromise;
206
+ });
207
+ });
208
+
209
+ describe('exit handling', () => {
210
+ it('should return exit code from process', async () => {
211
+ const mockProc = createMockPtyProcess();
212
+ const mockStdin = createMockStdin();
213
+ const mockStdout = createMockStdout();
214
+
215
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
216
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
217
+
218
+ mockPtySpawn.mockReturnValue(mockProc);
219
+
220
+ const runner = new ClaudeRunner();
221
+ const runPromise = runner.runInteractive('system', 'user');
222
+
223
+ mockProc._exitCallback({ exitCode: 42 });
224
+ const exitCode = await runPromise;
225
+ expect(exitCode).toBe(42);
226
+ });
227
+
228
+ it('should return 0 for successful completion', async () => {
229
+ const mockProc = createMockPtyProcess();
230
+ const mockStdin = createMockStdin();
231
+ const mockStdout = createMockStdout();
232
+
233
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
234
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
235
+
236
+ mockPtySpawn.mockReturnValue(mockProc);
237
+
238
+ const runner = new ClaudeRunner();
239
+ const runPromise = runner.runInteractive('system', 'user');
240
+
241
+ mockProc._exitCallback({ exitCode: 0 });
242
+ const exitCode = await runPromise;
243
+ expect(exitCode).toBe(0);
244
+ });
245
+ });
246
+
247
+ describe('--dangerously-skip-permissions flag', () => {
248
+ it('should NOT include --dangerously-skip-permissions by default', async () => {
249
+ const mockProc = createMockPtyProcess();
250
+ const mockStdin = createMockStdin();
251
+ const mockStdout = createMockStdout();
252
+
253
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
254
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
255
+
256
+ mockPtySpawn.mockReturnValue(mockProc);
257
+
258
+ const runner = new ClaudeRunner();
259
+ const runPromise = runner.runInteractive('system', 'user');
260
+
261
+ const spawnArgs = mockPtySpawn.mock.calls[0][1] as string[];
262
+ // Interactive mode should NOT skip permissions by default
263
+ expect(spawnArgs).not.toContain('--dangerously-skip-permissions');
264
+
265
+ mockProc._exitCallback({ exitCode: 0 });
266
+ await runPromise;
267
+ });
268
+
269
+ it('should include --dangerously-skip-permissions when option is true', async () => {
270
+ const mockProc = createMockPtyProcess();
271
+ const mockStdin = createMockStdin();
272
+ const mockStdout = createMockStdout();
273
+
274
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
275
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
276
+
277
+ mockPtySpawn.mockReturnValue(mockProc);
278
+
279
+ const runner = new ClaudeRunner();
280
+ const runPromise = runner.runInteractive('system', 'user', {
281
+ dangerouslySkipPermissions: true,
282
+ });
283
+
284
+ const spawnArgs = mockPtySpawn.mock.calls[0][1] as string[];
285
+ expect(spawnArgs).toContain('--dangerously-skip-permissions');
286
+
287
+ mockProc._exitCallback({ exitCode: 0 });
288
+ await runPromise;
289
+ });
290
+
291
+ it('should NOT include --dangerously-skip-permissions when option is false', async () => {
292
+ const mockProc = createMockPtyProcess();
293
+ const mockStdin = createMockStdin();
294
+ const mockStdout = createMockStdout();
295
+
296
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
297
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
298
+
299
+ mockPtySpawn.mockReturnValue(mockProc);
300
+
301
+ const runner = new ClaudeRunner();
302
+ const runPromise = runner.runInteractive('system', 'user', {
303
+ dangerouslySkipPermissions: false,
304
+ });
305
+
306
+ const spawnArgs = mockPtySpawn.mock.calls[0][1] as string[];
307
+ expect(spawnArgs).not.toContain('--dangerously-skip-permissions');
308
+
309
+ mockProc._exitCallback({ exitCode: 0 });
310
+ await runPromise;
311
+ });
312
+
313
+ it('should place --dangerously-skip-permissions after --model and before --append-system-prompt', async () => {
314
+ const mockProc = createMockPtyProcess();
315
+ const mockStdin = createMockStdin();
316
+ const mockStdout = createMockStdout();
317
+
318
+ Object.defineProperty(process, 'stdin', { value: mockStdin, configurable: true });
319
+ Object.defineProperty(process, 'stdout', { value: mockStdout, configurable: true });
320
+
321
+ mockPtySpawn.mockReturnValue(mockProc);
322
+
323
+ const runner = new ClaudeRunner({ model: 'sonnet' });
324
+ const runPromise = runner.runInteractive('my system prompt', 'my user message', {
325
+ dangerouslySkipPermissions: true,
326
+ });
327
+
328
+ const spawnArgs = mockPtySpawn.mock.calls[0][1] as string[];
329
+ const modelIndex = spawnArgs.indexOf('--model');
330
+ const skipIndex = spawnArgs.indexOf('--dangerously-skip-permissions');
331
+ const appendIndex = spawnArgs.indexOf('--append-system-prompt');
332
+ const userMessageIndex = spawnArgs.indexOf('my user message');
333
+
334
+ // --dangerously-skip-permissions should be after --model and before --append-system-prompt
335
+ expect(skipIndex).toBeGreaterThan(modelIndex);
336
+ expect(skipIndex).toBeLessThan(appendIndex);
337
+ expect(appendIndex).toBeLessThan(userMessageIndex);
338
+
339
+ mockProc._exitCallback({ exitCode: 0 });
340
+ await runPromise;
341
+ });
342
+ });
343
+ });