@mengde1231/rudder 0.5.3

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 (484) hide show
  1. package/LICENSE +235 -0
  2. package/README.md +136 -0
  3. package/bin/rudder.js +3 -0
  4. package/dist/cli/index.d.ts +3 -0
  5. package/dist/cli/index.d.ts.map +1 -0
  6. package/dist/cli/index.js +132 -0
  7. package/dist/cli/index.js.map +1 -0
  8. package/dist/commands/init.d.ts +57 -0
  9. package/dist/commands/init.d.ts.map +1 -0
  10. package/dist/commands/init.js +1465 -0
  11. package/dist/commands/init.js.map +1 -0
  12. package/dist/commands/uninstall.d.ts +27 -0
  13. package/dist/commands/uninstall.d.ts.map +1 -0
  14. package/dist/commands/uninstall.js +322 -0
  15. package/dist/commands/uninstall.js.map +1 -0
  16. package/dist/commands/update.d.ts +72 -0
  17. package/dist/commands/update.d.ts.map +1 -0
  18. package/dist/commands/update.js +1911 -0
  19. package/dist/commands/update.js.map +1 -0
  20. package/dist/configurators/antigravity.d.ts +7 -0
  21. package/dist/configurators/antigravity.d.ts.map +1 -0
  22. package/dist/configurators/antigravity.js +19 -0
  23. package/dist/configurators/antigravity.js.map +1 -0
  24. package/dist/configurators/claude.d.ts +9 -0
  25. package/dist/configurators/claude.d.ts.map +1 -0
  26. package/dist/configurators/claude.js +69 -0
  27. package/dist/configurators/claude.js.map +1 -0
  28. package/dist/configurators/codebuddy.d.ts +10 -0
  29. package/dist/configurators/codebuddy.d.ts.map +1 -0
  30. package/dist/configurators/codebuddy.js +30 -0
  31. package/dist/configurators/codebuddy.js.map +1 -0
  32. package/dist/configurators/codex.d.ts +8 -0
  33. package/dist/configurators/codex.d.ts.map +1 -0
  34. package/dist/configurators/codex.js +85 -0
  35. package/dist/configurators/codex.js.map +1 -0
  36. package/dist/configurators/copilot.d.ts +10 -0
  37. package/dist/configurators/copilot.d.ts.map +1 -0
  38. package/dist/configurators/copilot.js +51 -0
  39. package/dist/configurators/copilot.js.map +1 -0
  40. package/dist/configurators/cursor.d.ts +10 -0
  41. package/dist/configurators/cursor.d.ts.map +1 -0
  42. package/dist/configurators/cursor.js +29 -0
  43. package/dist/configurators/cursor.js.map +1 -0
  44. package/dist/configurators/droid.d.ts +10 -0
  45. package/dist/configurators/droid.d.ts.map +1 -0
  46. package/dist/configurators/droid.js +30 -0
  47. package/dist/configurators/droid.js.map +1 -0
  48. package/dist/configurators/gemini.d.ts +16 -0
  49. package/dist/configurators/gemini.d.ts.map +1 -0
  50. package/dist/configurators/gemini.js +38 -0
  51. package/dist/configurators/gemini.js.map +1 -0
  52. package/dist/configurators/index.d.ts +65 -0
  53. package/dist/configurators/index.d.ts.map +1 -0
  54. package/dist/configurators/index.js +367 -0
  55. package/dist/configurators/index.js.map +1 -0
  56. package/dist/configurators/kilo.d.ts +7 -0
  57. package/dist/configurators/kilo.d.ts.map +1 -0
  58. package/dist/configurators/kilo.js +19 -0
  59. package/dist/configurators/kilo.js.map +1 -0
  60. package/dist/configurators/kiro.d.ts +8 -0
  61. package/dist/configurators/kiro.d.ts.map +1 -0
  62. package/dist/configurators/kiro.js +24 -0
  63. package/dist/configurators/kiro.js.map +1 -0
  64. package/dist/configurators/opencode.d.ts +14 -0
  65. package/dist/configurators/opencode.d.ts.map +1 -0
  66. package/dist/configurators/opencode.js +96 -0
  67. package/dist/configurators/opencode.js.map +1 -0
  68. package/dist/configurators/pi.d.ts +3 -0
  69. package/dist/configurators/pi.d.ts.map +1 -0
  70. package/dist/configurators/pi.js +45 -0
  71. package/dist/configurators/pi.js.map +1 -0
  72. package/dist/configurators/qoder.d.ts +11 -0
  73. package/dist/configurators/qoder.d.ts.map +1 -0
  74. package/dist/configurators/qoder.js +31 -0
  75. package/dist/configurators/qoder.js.map +1 -0
  76. package/dist/configurators/shared.d.ts +178 -0
  77. package/dist/configurators/shared.d.ts.map +1 -0
  78. package/dist/configurators/shared.js +546 -0
  79. package/dist/configurators/shared.js.map +1 -0
  80. package/dist/configurators/windsurf.d.ts +7 -0
  81. package/dist/configurators/windsurf.d.ts.map +1 -0
  82. package/dist/configurators/windsurf.js +19 -0
  83. package/dist/configurators/windsurf.js.map +1 -0
  84. package/dist/configurators/workflow.d.ts +34 -0
  85. package/dist/configurators/workflow.d.ts.map +1 -0
  86. package/dist/configurators/workflow.js +178 -0
  87. package/dist/configurators/workflow.js.map +1 -0
  88. package/dist/constants/paths.d.ts +70 -0
  89. package/dist/constants/paths.d.ts.map +1 -0
  90. package/dist/constants/paths.js +79 -0
  91. package/dist/constants/paths.js.map +1 -0
  92. package/dist/constants/version.d.ts +9 -0
  93. package/dist/constants/version.d.ts.map +1 -0
  94. package/dist/constants/version.js +15 -0
  95. package/dist/constants/version.js.map +1 -0
  96. package/dist/index.d.ts +9 -0
  97. package/dist/index.d.ts.map +1 -0
  98. package/dist/index.js +9 -0
  99. package/dist/index.js.map +1 -0
  100. package/dist/migrations/index.d.ts +62 -0
  101. package/dist/migrations/index.d.ts.map +1 -0
  102. package/dist/migrations/index.js +187 -0
  103. package/dist/migrations/index.js.map +1 -0
  104. package/dist/migrations/manifests/0.1.9.json +30 -0
  105. package/dist/migrations/manifests/0.2.0.json +49 -0
  106. package/dist/migrations/manifests/0.2.12.json +9 -0
  107. package/dist/migrations/manifests/0.2.13.json +9 -0
  108. package/dist/migrations/manifests/0.2.14.json +175 -0
  109. package/dist/migrations/manifests/0.2.15.json +33 -0
  110. package/dist/migrations/manifests/0.3.0-beta.0.json +297 -0
  111. package/dist/migrations/manifests/0.3.0-beta.1.json +9 -0
  112. package/dist/migrations/manifests/0.3.0-beta.10.json +9 -0
  113. package/dist/migrations/manifests/0.3.0-beta.11.json +9 -0
  114. package/dist/migrations/manifests/0.3.0-beta.12.json +9 -0
  115. package/dist/migrations/manifests/0.3.0-beta.13.json +9 -0
  116. package/dist/migrations/manifests/0.3.0-beta.14.json +9 -0
  117. package/dist/migrations/manifests/0.3.0-beta.15.json +9 -0
  118. package/dist/migrations/manifests/0.3.0-beta.16.json +9 -0
  119. package/dist/migrations/manifests/0.3.0-beta.2.json +9 -0
  120. package/dist/migrations/manifests/0.3.0-beta.3.json +9 -0
  121. package/dist/migrations/manifests/0.3.0-beta.4.json +9 -0
  122. package/dist/migrations/manifests/0.3.0-beta.5.json +9 -0
  123. package/dist/migrations/manifests/0.3.0-beta.6.json +9 -0
  124. package/dist/migrations/manifests/0.3.0-beta.7.json +11 -0
  125. package/dist/migrations/manifests/0.3.0-beta.8.json +9 -0
  126. package/dist/migrations/manifests/0.3.0-beta.9.json +9 -0
  127. package/dist/migrations/manifests/0.3.0-rc.0.json +9 -0
  128. package/dist/migrations/manifests/0.3.0-rc.1.json +9 -0
  129. package/dist/migrations/manifests/0.3.0-rc.2.json +9 -0
  130. package/dist/migrations/manifests/0.3.0-rc.3.json +9 -0
  131. package/dist/migrations/manifests/0.3.0-rc.4.json +9 -0
  132. package/dist/migrations/manifests/0.3.0-rc.5.json +9 -0
  133. package/dist/migrations/manifests/0.3.0-rc.6.json +9 -0
  134. package/dist/migrations/manifests/0.3.0.json +11 -0
  135. package/dist/migrations/manifests/0.3.1.json +9 -0
  136. package/dist/migrations/manifests/0.3.10.json +9 -0
  137. package/dist/migrations/manifests/0.3.2.json +9 -0
  138. package/dist/migrations/manifests/0.3.3.json +9 -0
  139. package/dist/migrations/manifests/0.3.4.json +21 -0
  140. package/dist/migrations/manifests/0.3.5.json +9 -0
  141. package/dist/migrations/manifests/0.3.6.json +9 -0
  142. package/dist/migrations/manifests/0.3.7.json +9 -0
  143. package/dist/migrations/manifests/0.3.8.json +9 -0
  144. package/dist/migrations/manifests/0.3.9.json +9 -0
  145. package/dist/migrations/manifests/0.4.0-beta.1.json +228 -0
  146. package/dist/migrations/manifests/0.4.0-beta.10.json +9 -0
  147. package/dist/migrations/manifests/0.4.0-beta.2.json +9 -0
  148. package/dist/migrations/manifests/0.4.0-beta.3.json +9 -0
  149. package/dist/migrations/manifests/0.4.0-beta.4.json +9 -0
  150. package/dist/migrations/manifests/0.4.0-beta.5.json +9 -0
  151. package/dist/migrations/manifests/0.4.0-beta.6.json +9 -0
  152. package/dist/migrations/manifests/0.4.0-beta.7.json +9 -0
  153. package/dist/migrations/manifests/0.4.0-beta.8.json +34 -0
  154. package/dist/migrations/manifests/0.4.0-beta.9.json +9 -0
  155. package/dist/migrations/manifests/0.4.0-rc.0.json +9 -0
  156. package/dist/migrations/manifests/0.4.0-rc.1.json +9 -0
  157. package/dist/migrations/manifests/0.4.0.json +9 -0
  158. package/dist/migrations/manifests/0.5.0-beta.0.json +1646 -0
  159. package/dist/migrations/manifests/0.5.0-beta.1.json +9 -0
  160. package/dist/migrations/manifests/0.5.0-beta.10.json +9 -0
  161. package/dist/migrations/manifests/0.5.0-beta.11.json +9 -0
  162. package/dist/migrations/manifests/0.5.0-beta.12.json +9 -0
  163. package/dist/migrations/manifests/0.5.0-beta.13.json +9 -0
  164. package/dist/migrations/manifests/0.5.0-beta.14.json +9 -0
  165. package/dist/migrations/manifests/0.5.0-beta.15.json +116 -0
  166. package/dist/migrations/manifests/0.5.0-beta.16.json +9 -0
  167. package/dist/migrations/manifests/0.5.0-beta.17.json +9 -0
  168. package/dist/migrations/manifests/0.5.0-beta.18.json +9 -0
  169. package/dist/migrations/manifests/0.5.0-beta.19.json +9 -0
  170. package/dist/migrations/manifests/0.5.0-beta.2.json +9 -0
  171. package/dist/migrations/manifests/0.5.0-beta.3.json +9 -0
  172. package/dist/migrations/manifests/0.5.0-beta.4.json +9 -0
  173. package/dist/migrations/manifests/0.5.0-beta.5.json +222 -0
  174. package/dist/migrations/manifests/0.5.0-beta.6.json +9 -0
  175. package/dist/migrations/manifests/0.5.0-beta.7.json +9 -0
  176. package/dist/migrations/manifests/0.5.0-beta.8.json +9 -0
  177. package/dist/migrations/manifests/0.5.0-beta.9.json +48 -0
  178. package/dist/migrations/manifests/0.5.0-rc.0.json +9 -0
  179. package/dist/migrations/manifests/0.5.0-rc.1.json +9 -0
  180. package/dist/migrations/manifests/0.5.0-rc.2.json +9 -0
  181. package/dist/migrations/manifests/0.5.0-rc.3.json +9 -0
  182. package/dist/migrations/manifests/0.5.0-rc.4.json +9 -0
  183. package/dist/migrations/manifests/0.5.0-rc.5.json +9 -0
  184. package/dist/migrations/manifests/0.5.0-rc.6.json +9 -0
  185. package/dist/migrations/manifests/0.5.0-rc.7.json +9 -0
  186. package/dist/migrations/manifests/0.5.0.json +9 -0
  187. package/dist/migrations/manifests/0.5.1.json +9 -0
  188. package/dist/migrations/manifests/0.5.10.json +9 -0
  189. package/dist/migrations/manifests/0.5.11.json +16 -0
  190. package/dist/migrations/manifests/0.5.12.json +9 -0
  191. package/dist/migrations/manifests/0.5.13.json +9 -0
  192. package/dist/migrations/manifests/0.5.2.json +9 -0
  193. package/dist/migrations/manifests/0.5.3.json +9 -0
  194. package/dist/migrations/manifests/0.5.4.json +9 -0
  195. package/dist/migrations/manifests/0.5.5.json +9 -0
  196. package/dist/migrations/manifests/0.5.6.json +9 -0
  197. package/dist/migrations/manifests/0.5.7.json +16 -0
  198. package/dist/migrations/manifests/0.5.8.json +9 -0
  199. package/dist/migrations/manifests/0.5.9.json +9 -0
  200. package/dist/migrations/manifests/0.6.0-beta.0.json +16 -0
  201. package/dist/migrations/manifests/0.6.0-beta.1.json +9 -0
  202. package/dist/migrations/manifests/0.6.0-beta.2.json +9 -0
  203. package/dist/migrations/manifests/0.6.0-beta.3.json +9 -0
  204. package/dist/migrations/manifests/0.6.0-beta.4.json +9 -0
  205. package/dist/migrations/manifests/0.6.0-beta.5.json +9 -0
  206. package/dist/migrations/manifests/0.6.0-beta.6.json +16 -0
  207. package/dist/migrations/manifests/0.6.0-beta.7.json +9 -0
  208. package/dist/migrations/manifests/0.6.0-beta.8.json +9 -0
  209. package/dist/templates/claude/agents/rudder-check.md +143 -0
  210. package/dist/templates/claude/agents/rudder-implement.md +109 -0
  211. package/dist/templates/claude/agents/rudder-research.md +137 -0
  212. package/dist/templates/claude/index.d.ts +22 -0
  213. package/dist/templates/claude/index.d.ts.map +1 -0
  214. package/dist/templates/claude/index.js +46 -0
  215. package/dist/templates/claude/index.js.map +1 -0
  216. package/dist/templates/claude/settings.json +73 -0
  217. package/dist/templates/codebuddy/agents/rudder-check.md +143 -0
  218. package/dist/templates/codebuddy/agents/rudder-implement.md +109 -0
  219. package/dist/templates/codebuddy/agents/rudder-research.md +137 -0
  220. package/dist/templates/codebuddy/index.d.ts +15 -0
  221. package/dist/templates/codebuddy/index.d.ts.map +1 -0
  222. package/dist/templates/codebuddy/index.js +15 -0
  223. package/dist/templates/codebuddy/index.js.map +1 -0
  224. package/dist/templates/codebuddy/settings.json +59 -0
  225. package/dist/templates/codex/agents/rudder-check.toml +91 -0
  226. package/dist/templates/codex/agents/rudder-implement.toml +65 -0
  227. package/dist/templates/codex/agents/rudder-research.toml +73 -0
  228. package/dist/templates/codex/config.toml +35 -0
  229. package/dist/templates/codex/hooks/session-start.py +459 -0
  230. package/dist/templates/codex/hooks.json +15 -0
  231. package/dist/templates/codex/index.d.ts +39 -0
  232. package/dist/templates/codex/index.d.ts.map +1 -0
  233. package/dist/templates/codex/index.js +85 -0
  234. package/dist/templates/codex/index.js.map +1 -0
  235. package/dist/templates/codex/skills/before-dev/SKILL.md +34 -0
  236. package/dist/templates/codex/skills/brainstorm/SKILL.md +500 -0
  237. package/dist/templates/codex/skills/break-loop/SKILL.md +130 -0
  238. package/dist/templates/codex/skills/check/SKILL.md +30 -0
  239. package/dist/templates/codex/skills/check-cross-layer/SKILL.md +158 -0
  240. package/dist/templates/codex/skills/create-command/SKILL.md +101 -0
  241. package/dist/templates/codex/skills/finish-work/SKILL.md +90 -0
  242. package/dist/templates/codex/skills/improve-ut/SKILL.md +69 -0
  243. package/dist/templates/codex/skills/integrate-skill/SKILL.md +221 -0
  244. package/dist/templates/codex/skills/onboard/SKILL.md +363 -0
  245. package/dist/templates/codex/skills/record-session/SKILL.md +67 -0
  246. package/dist/templates/codex/skills/start/SKILL.md +354 -0
  247. package/dist/templates/codex/skills/update-spec/SKILL.md +335 -0
  248. package/dist/templates/common/bundled-skills/rudder-meta/SKILL.md +73 -0
  249. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/add-project-local-conventions.md +83 -0
  250. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-agents.md +54 -0
  251. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-context-loading.md +81 -0
  252. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-hooks.md +57 -0
  253. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-skills-or-commands.md +78 -0
  254. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-spec-structure.md +83 -0
  255. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-task-lifecycle.md +90 -0
  256. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-workflow.md +64 -0
  257. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/overview.md +55 -0
  258. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/context-injection.md +68 -0
  259. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/generated-files.md +80 -0
  260. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/overview.md +51 -0
  261. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/spec-system.md +102 -0
  262. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/task-system.md +101 -0
  263. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/workflow.md +75 -0
  264. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/workspace-memory.md +71 -0
  265. package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/agents.md +79 -0
  266. package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/hooks-and-settings.md +69 -0
  267. package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/overview.md +59 -0
  268. package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/platform-map.md +74 -0
  269. package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/skills-and-commands.md +83 -0
  270. package/dist/templates/common/commands/continue.md +55 -0
  271. package/dist/templates/common/commands/finish-work.md +66 -0
  272. package/dist/templates/common/commands/start.md +58 -0
  273. package/dist/templates/common/index.d.ts +48 -0
  274. package/dist/templates/common/index.d.ts.map +1 -0
  275. package/dist/templates/common/index.js +104 -0
  276. package/dist/templates/common/index.js.map +1 -0
  277. package/dist/templates/common/skills/before-dev.md +29 -0
  278. package/dist/templates/common/skills/brainstorm.md +543 -0
  279. package/dist/templates/common/skills/break-loop.md +125 -0
  280. package/dist/templates/common/skills/check.md +87 -0
  281. package/dist/templates/common/skills/update-spec.md +351 -0
  282. package/dist/templates/copilot/hooks/session-start.py +430 -0
  283. package/dist/templates/copilot/hooks.json +19 -0
  284. package/dist/templates/copilot/index.d.ts +23 -0
  285. package/dist/templates/copilot/index.d.ts.map +1 -0
  286. package/dist/templates/copilot/index.js +54 -0
  287. package/dist/templates/copilot/index.js.map +1 -0
  288. package/dist/templates/copilot/prompts/before-dev.prompt.md +33 -0
  289. package/dist/templates/copilot/prompts/brainstorm.prompt.md +499 -0
  290. package/dist/templates/copilot/prompts/break-loop.prompt.md +129 -0
  291. package/dist/templates/copilot/prompts/check-cross-layer.prompt.md +157 -0
  292. package/dist/templates/copilot/prompts/check.prompt.md +29 -0
  293. package/dist/templates/copilot/prompts/create-command.prompt.md +116 -0
  294. package/dist/templates/copilot/prompts/finish-work.prompt.md +99 -0
  295. package/dist/templates/copilot/prompts/integrate-skill.prompt.md +223 -0
  296. package/dist/templates/copilot/prompts/onboard.prompt.md +362 -0
  297. package/dist/templates/copilot/prompts/parallel.prompt.md +196 -0
  298. package/dist/templates/copilot/prompts/record-session.prompt.md +66 -0
  299. package/dist/templates/copilot/prompts/start.prompt.md +397 -0
  300. package/dist/templates/copilot/prompts/update-spec.prompt.md +358 -0
  301. package/dist/templates/cursor/agents/rudder-check.md +142 -0
  302. package/dist/templates/cursor/agents/rudder-implement.md +108 -0
  303. package/dist/templates/cursor/agents/rudder-research.md +136 -0
  304. package/dist/templates/cursor/hooks.json +24 -0
  305. package/dist/templates/cursor/index.d.ts +13 -0
  306. package/dist/templates/cursor/index.d.ts.map +1 -0
  307. package/dist/templates/cursor/index.js +13 -0
  308. package/dist/templates/cursor/index.js.map +1 -0
  309. package/dist/templates/droid/droids/rudder-check.md +135 -0
  310. package/dist/templates/droid/droids/rudder-implement.md +101 -0
  311. package/dist/templates/droid/droids/rudder-research.md +137 -0
  312. package/dist/templates/droid/index.d.ts +15 -0
  313. package/dist/templates/droid/index.d.ts.map +1 -0
  314. package/dist/templates/droid/index.js +15 -0
  315. package/dist/templates/droid/index.js.map +1 -0
  316. package/dist/templates/droid/settings.json +59 -0
  317. package/dist/templates/extract.d.ts +40 -0
  318. package/dist/templates/extract.d.ts.map +1 -0
  319. package/dist/templates/extract.js +106 -0
  320. package/dist/templates/extract.js.map +1 -0
  321. package/dist/templates/gemini/agents/rudder-check.md +135 -0
  322. package/dist/templates/gemini/agents/rudder-implement.md +101 -0
  323. package/dist/templates/gemini/agents/rudder-research.md +136 -0
  324. package/dist/templates/gemini/index.d.ts +13 -0
  325. package/dist/templates/gemini/index.d.ts.map +1 -0
  326. package/dist/templates/gemini/index.js +13 -0
  327. package/dist/templates/gemini/index.js.map +1 -0
  328. package/dist/templates/gemini/settings.json +28 -0
  329. package/dist/templates/kiro/agents/rudder-check.json +26 -0
  330. package/dist/templates/kiro/agents/rudder-implement.json +26 -0
  331. package/dist/templates/kiro/agents/rudder-research.json +30 -0
  332. package/dist/templates/kiro/index.d.ts +18 -0
  333. package/dist/templates/kiro/index.d.ts.map +1 -0
  334. package/dist/templates/kiro/index.js +18 -0
  335. package/dist/templates/kiro/index.js.map +1 -0
  336. package/dist/templates/markdown/agents.md +21 -0
  337. package/dist/templates/markdown/gitignore.txt +15 -0
  338. package/dist/templates/markdown/index.d.ts +27 -0
  339. package/dist/templates/markdown/index.d.ts.map +1 -0
  340. package/dist/templates/markdown/index.js +52 -0
  341. package/dist/templates/markdown/index.js.map +1 -0
  342. package/dist/templates/markdown/spec/backend/database-guidelines.md.txt +51 -0
  343. package/dist/templates/markdown/spec/backend/directory-structure.md.txt +54 -0
  344. package/dist/templates/markdown/spec/backend/error-handling.md.txt +51 -0
  345. package/dist/templates/markdown/spec/backend/index.md.txt +38 -0
  346. package/dist/templates/markdown/spec/backend/logging-guidelines.md.txt +51 -0
  347. package/dist/templates/markdown/spec/backend/quality-guidelines.md.txt +51 -0
  348. package/dist/templates/markdown/spec/frontend/component-guidelines.md.txt +59 -0
  349. package/dist/templates/markdown/spec/frontend/directory-structure.md.txt +54 -0
  350. package/dist/templates/markdown/spec/frontend/hook-guidelines.md.txt +51 -0
  351. package/dist/templates/markdown/spec/frontend/index.md.txt +39 -0
  352. package/dist/templates/markdown/spec/frontend/quality-guidelines.md.txt +51 -0
  353. package/dist/templates/markdown/spec/frontend/state-management.md.txt +51 -0
  354. package/dist/templates/markdown/spec/frontend/type-safety.md.txt +51 -0
  355. package/dist/templates/markdown/spec/guides/code-reuse-thinking-guide.md.txt +105 -0
  356. package/dist/templates/markdown/spec/guides/cross-layer-thinking-guide.md.txt +162 -0
  357. package/dist/templates/markdown/spec/guides/cross-platform-thinking-guide.md.txt +595 -0
  358. package/dist/templates/markdown/spec/guides/index.md.txt +79 -0
  359. package/dist/templates/markdown/workspace-index.md +125 -0
  360. package/dist/templates/markdown/worktree.yaml.txt +58 -0
  361. package/dist/templates/opencode/agents/rudder-check.md +150 -0
  362. package/dist/templates/opencode/agents/rudder-implement.md +117 -0
  363. package/dist/templates/opencode/agents/rudder-research.md +145 -0
  364. package/dist/templates/opencode/lib/rudder-context.js +381 -0
  365. package/dist/templates/opencode/lib/session-utils.js +432 -0
  366. package/dist/templates/opencode/package.json +5 -0
  367. package/dist/templates/opencode/plugins/inject-subagent-context.js +497 -0
  368. package/dist/templates/opencode/plugins/inject-workflow-state.js +162 -0
  369. package/dist/templates/opencode/plugins/session-start.js +101 -0
  370. package/dist/templates/pi/agents/rudder-check.md +103 -0
  371. package/dist/templates/pi/agents/rudder-implement.md +41 -0
  372. package/dist/templates/pi/agents/rudder-research.md +25 -0
  373. package/dist/templates/pi/extensions/rudder/index.ts.txt +1172 -0
  374. package/dist/templates/pi/index.d.ts +5 -0
  375. package/dist/templates/pi/index.d.ts.map +1 -0
  376. package/dist/templates/pi/index.js +12 -0
  377. package/dist/templates/pi/index.js.map +1 -0
  378. package/dist/templates/pi/settings.json +21 -0
  379. package/dist/templates/qoder/agents/rudder-check.md +136 -0
  380. package/dist/templates/qoder/agents/rudder-implement.md +102 -0
  381. package/dist/templates/qoder/agents/rudder-research.md +137 -0
  382. package/dist/templates/qoder/index.d.ts +15 -0
  383. package/dist/templates/qoder/index.d.ts.map +1 -0
  384. package/dist/templates/qoder/index.js +15 -0
  385. package/dist/templates/qoder/index.js.map +1 -0
  386. package/dist/templates/qoder/settings.json +47 -0
  387. package/dist/templates/rudder/config.yaml +131 -0
  388. package/dist/templates/rudder/config_local.yml +17 -0
  389. package/dist/templates/rudder/gitignore.txt +35 -0
  390. package/dist/templates/rudder/index.d.ts +53 -0
  391. package/dist/templates/rudder/index.d.ts.map +1 -0
  392. package/dist/templates/rudder/index.js +98 -0
  393. package/dist/templates/rudder/index.js.map +1 -0
  394. package/dist/templates/rudder/scripts/__init__.py +5 -0
  395. package/dist/templates/rudder/scripts/add_session.py +547 -0
  396. package/dist/templates/rudder/scripts/common/__init__.py +92 -0
  397. package/dist/templates/rudder/scripts/common/active_task.py +626 -0
  398. package/dist/templates/rudder/scripts/common/cli_adapter.py +811 -0
  399. package/dist/templates/rudder/scripts/common/config.py +532 -0
  400. package/dist/templates/rudder/scripts/common/developer.py +190 -0
  401. package/dist/templates/rudder/scripts/common/git.py +31 -0
  402. package/dist/templates/rudder/scripts/common/git_context.py +106 -0
  403. package/dist/templates/rudder/scripts/common/io.py +37 -0
  404. package/dist/templates/rudder/scripts/common/log.py +45 -0
  405. package/dist/templates/rudder/scripts/common/packages_context.py +238 -0
  406. package/dist/templates/rudder/scripts/common/paths.py +447 -0
  407. package/dist/templates/rudder/scripts/common/rudder_config.py +201 -0
  408. package/dist/templates/rudder/scripts/common/safe_commit.py +255 -0
  409. package/dist/templates/rudder/scripts/common/session_context.py +839 -0
  410. package/dist/templates/rudder/scripts/common/task_context.py +223 -0
  411. package/dist/templates/rudder/scripts/common/task_queue.py +188 -0
  412. package/dist/templates/rudder/scripts/common/task_store.py +636 -0
  413. package/dist/templates/rudder/scripts/common/task_utils.py +274 -0
  414. package/dist/templates/rudder/scripts/common/tasks.py +112 -0
  415. package/dist/templates/rudder/scripts/common/types.py +110 -0
  416. package/dist/templates/rudder/scripts/common/workflow_phase.py +215 -0
  417. package/dist/templates/rudder/scripts/get_context.py +16 -0
  418. package/dist/templates/rudder/scripts/get_developer.py +26 -0
  419. package/dist/templates/rudder/scripts/hooks/linear_sync.py +243 -0
  420. package/dist/templates/rudder/scripts/init_developer.py +51 -0
  421. package/dist/templates/rudder/scripts/task.py +500 -0
  422. package/dist/templates/rudder/tasks/.gitkeep +0 -0
  423. package/dist/templates/rudder/workflow.md +710 -0
  424. package/dist/templates/shared-hooks/index.d.ts +50 -0
  425. package/dist/templates/shared-hooks/index.d.ts.map +1 -0
  426. package/dist/templates/shared-hooks/index.js +88 -0
  427. package/dist/templates/shared-hooks/index.js.map +1 -0
  428. package/dist/templates/shared-hooks/inject-shell-session-context.py +183 -0
  429. package/dist/templates/shared-hooks/inject-subagent-context.py +749 -0
  430. package/dist/templates/shared-hooks/inject-workflow-state.py +404 -0
  431. package/dist/templates/shared-hooks/session-start.py +827 -0
  432. package/dist/templates/template-utils.d.ts +26 -0
  433. package/dist/templates/template-utils.d.ts.map +1 -0
  434. package/dist/templates/template-utils.js +60 -0
  435. package/dist/templates/template-utils.js.map +1 -0
  436. package/dist/types/ai-tools.d.ts +95 -0
  437. package/dist/types/ai-tools.d.ts.map +1 -0
  438. package/dist/types/ai-tools.js +280 -0
  439. package/dist/types/ai-tools.js.map +1 -0
  440. package/dist/types/migration.d.ts +125 -0
  441. package/dist/types/migration.d.ts.map +1 -0
  442. package/dist/types/migration.js +8 -0
  443. package/dist/types/migration.js.map +1 -0
  444. package/dist/utils/compare-versions.d.ts +12 -0
  445. package/dist/utils/compare-versions.d.ts.map +1 -0
  446. package/dist/utils/compare-versions.js +86 -0
  447. package/dist/utils/compare-versions.js.map +1 -0
  448. package/dist/utils/file-writer.d.ts +23 -0
  449. package/dist/utils/file-writer.d.ts.map +1 -0
  450. package/dist/utils/file-writer.js +145 -0
  451. package/dist/utils/file-writer.js.map +1 -0
  452. package/dist/utils/posix.d.ts +13 -0
  453. package/dist/utils/posix.d.ts.map +1 -0
  454. package/dist/utils/posix.js +15 -0
  455. package/dist/utils/posix.js.map +1 -0
  456. package/dist/utils/project-detector.d.ts +46 -0
  457. package/dist/utils/project-detector.d.ts.map +1 -0
  458. package/dist/utils/project-detector.js +666 -0
  459. package/dist/utils/project-detector.js.map +1 -0
  460. package/dist/utils/proxy.d.ts +25 -0
  461. package/dist/utils/proxy.d.ts.map +1 -0
  462. package/dist/utils/proxy.js +60 -0
  463. package/dist/utils/proxy.js.map +1 -0
  464. package/dist/utils/task-json.d.ts +46 -0
  465. package/dist/utils/task-json.d.ts.map +1 -0
  466. package/dist/utils/task-json.js +49 -0
  467. package/dist/utils/task-json.js.map +1 -0
  468. package/dist/utils/template-fetcher.d.ts +150 -0
  469. package/dist/utils/template-fetcher.d.ts.map +1 -0
  470. package/dist/utils/template-fetcher.js +907 -0
  471. package/dist/utils/template-fetcher.js.map +1 -0
  472. package/dist/utils/template-hash.d.ts +112 -0
  473. package/dist/utils/template-hash.d.ts.map +1 -0
  474. package/dist/utils/template-hash.js +343 -0
  475. package/dist/utils/template-hash.js.map +1 -0
  476. package/dist/utils/trellis-migrate.d.ts +45 -0
  477. package/dist/utils/trellis-migrate.d.ts.map +1 -0
  478. package/dist/utils/trellis-migrate.js +240 -0
  479. package/dist/utils/trellis-migrate.js.map +1 -0
  480. package/dist/utils/uninstall-scrubbers.d.ts +66 -0
  481. package/dist/utils/uninstall-scrubbers.d.ts.map +1 -0
  482. package/dist/utils/uninstall-scrubbers.js +342 -0
  483. package/dist/utils/uninstall-scrubbers.js.map +1 -0
  484. package/package.json +87 -0
@@ -0,0 +1,636 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Task CRUD operations.
4
+
5
+ Provides:
6
+ ensure_tasks_dir - Ensure tasks directory exists
7
+ cmd_create - Create a new task
8
+ cmd_archive - Archive completed task
9
+ cmd_set_branch - Set git branch for task
10
+ cmd_set_base_branch - Set PR target branch
11
+ cmd_set_scope - Set scope for PR title
12
+ cmd_add_subtask - Link child task to parent
13
+ cmd_remove_subtask - Unlink child task from parent
14
+ """
15
+
16
+ from __future__ import annotations
17
+
18
+ import argparse
19
+ import json
20
+ import re
21
+ import sys
22
+ from datetime import datetime
23
+ from pathlib import Path
24
+
25
+ from .config import (
26
+ get_packages,
27
+ get_session_auto_commit,
28
+ is_monorepo,
29
+ resolve_package,
30
+ validate_package,
31
+ )
32
+ from .git import run_git
33
+ from .io import read_json, write_json
34
+ from .log import Colors, colored
35
+ from .paths import (
36
+ DIR_ARCHIVE,
37
+ DIR_TASKS,
38
+ DIR_WORKFLOW,
39
+ FILE_TASK_JSON,
40
+ generate_task_date_prefix,
41
+ get_developer,
42
+ get_repo_root,
43
+ get_tasks_dir,
44
+ )
45
+ from .safe_commit import (
46
+ print_gitignore_warning,
47
+ safe_archive_paths_to_add,
48
+ safe_git_add,
49
+ )
50
+ from .task_utils import (
51
+ archive_task_complete,
52
+ find_task_by_name,
53
+ resolve_task_dir,
54
+ run_task_hooks,
55
+ )
56
+
57
+
58
+ # =============================================================================
59
+ # Helper Functions
60
+ # =============================================================================
61
+
62
+ def _slugify(title: str) -> str:
63
+ """Convert title to slug (only works with ASCII)."""
64
+ result = title.lower()
65
+ result = re.sub(r"[^a-z0-9]", "-", result)
66
+ result = re.sub(r"-+", "-", result)
67
+ result = result.strip("-")
68
+ return result
69
+
70
+
71
+ def ensure_tasks_dir(repo_root: Path) -> Path:
72
+ """Ensure tasks directory exists."""
73
+ tasks_dir = get_tasks_dir(repo_root)
74
+ archive_dir = tasks_dir / "archive"
75
+
76
+ if not tasks_dir.exists():
77
+ tasks_dir.mkdir(parents=True)
78
+ print(colored(f"Created tasks directory: {tasks_dir}", Colors.GREEN), file=sys.stderr)
79
+
80
+ if not archive_dir.exists():
81
+ archive_dir.mkdir(parents=True)
82
+
83
+ return tasks_dir
84
+
85
+
86
+ # =============================================================================
87
+ # Sub-agent platform detection + JSONL seeding
88
+ # =============================================================================
89
+
90
+ # Config directories of platforms that consume implement.jsonl / check.jsonl.
91
+ # Keep in sync with src/types/ai-tools.ts AI_TOOLS entries — these are the
92
+ # platforms listed in workflow.md's "agent-capable" Skill Routing block
93
+ # (Class-1 hook-inject + Class-2 pull-based preludes). Kilo / Antigravity /
94
+ # Windsurf are NOT in this list: they do not consume JSONL.
95
+ _SUBAGENT_CONFIG_DIRS: tuple[str, ...] = (
96
+ ".claude",
97
+ ".cursor",
98
+ ".codex",
99
+ ".kiro",
100
+ ".gemini",
101
+ ".opencode",
102
+ ".qoder",
103
+ ".codebuddy",
104
+ ".factory", # Factory Droid
105
+ ".github/copilot",
106
+ ".pi", # Pi Agent
107
+ )
108
+
109
+ _SEED_EXAMPLE = (
110
+ "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. "
111
+ "Put spec/research files only — no code paths. "
112
+ "Run `python3 .rudder/scripts/get_context.py --mode packages` to list available specs. "
113
+ "Delete this line once real entries are added."
114
+ )
115
+
116
+
117
+ def _has_subagent_platform(repo_root: Path) -> bool:
118
+ """Return True if any sub-agent-capable platform is configured.
119
+
120
+ Detected by probing well-known config directories at the repo root. Used
121
+ only to decide whether ``task.py create`` should seed empty
122
+ ``implement.jsonl`` / ``check.jsonl`` files.
123
+ """
124
+ for config_dir in _SUBAGENT_CONFIG_DIRS:
125
+ if (repo_root / config_dir).is_dir():
126
+ return True
127
+ return False
128
+
129
+
130
+ def _write_seed_jsonl(path: Path) -> None:
131
+ """Write a one-line seed JSONL file with a self-describing ``_example``.
132
+
133
+ The seed row has no ``file`` field, so downstream consumers (hooks +
134
+ preludes) that iterate entries via ``item.get("file")`` naturally skip
135
+ it. The row exists purely as an in-file prompt for the AI curator.
136
+ """
137
+ seed = {"_example": _SEED_EXAMPLE}
138
+ path.write_text(json.dumps(seed, ensure_ascii=False) + "\n", encoding="utf-8")
139
+
140
+
141
+ # =============================================================================
142
+ # Command: create
143
+ # =============================================================================
144
+
145
+ def cmd_create(args: argparse.Namespace) -> int:
146
+ """Create a new task."""
147
+ repo_root = get_repo_root()
148
+
149
+ if not args.title:
150
+ print(colored("Error: title is required", Colors.RED), file=sys.stderr)
151
+ return 1
152
+
153
+ # Validate --package (CLI source: fail-fast)
154
+ package: str | None = getattr(args, "package", None)
155
+ if not is_monorepo(repo_root):
156
+ # Single-repo: ignore --package, no package prefix
157
+ if package:
158
+ print(colored(f"Warning: --package ignored in single-repo project", Colors.YELLOW), file=sys.stderr)
159
+ package = None
160
+ elif package:
161
+ if not validate_package(package, repo_root):
162
+ packages = get_packages(repo_root)
163
+ available = ", ".join(sorted(packages.keys())) if packages else "(none)"
164
+ print(colored(f"Error: unknown package '{package}'. Available: {available}", Colors.RED), file=sys.stderr)
165
+ return 1
166
+ else:
167
+ # Inferred: default_package → None (no task.json yet for create)
168
+ package = resolve_package(repo_root=repo_root)
169
+
170
+ # Default assignee to current developer
171
+ assignee = args.assignee
172
+ if not assignee:
173
+ assignee = get_developer(repo_root)
174
+ if not assignee:
175
+ print(colored("Error: No developer set. Run init_developer.py first or use --assignee", Colors.RED), file=sys.stderr)
176
+ return 1
177
+
178
+ ensure_tasks_dir(repo_root)
179
+
180
+ # Get current developer as creator
181
+ creator = get_developer(repo_root) or assignee
182
+
183
+ # Generate slug if not provided
184
+ slug = args.slug or _slugify(args.title)
185
+ if not slug:
186
+ print(colored("Error: could not generate slug from title", Colors.RED), file=sys.stderr)
187
+ return 1
188
+
189
+ # Create task directory with MM-DD-slug format
190
+ tasks_dir = get_tasks_dir(repo_root)
191
+ date_prefix = generate_task_date_prefix()
192
+ dir_name = f"{date_prefix}-{slug}"
193
+ task_dir = tasks_dir / dir_name
194
+ task_json_path = task_dir / FILE_TASK_JSON
195
+
196
+ if task_dir.exists():
197
+ print(colored(f"Warning: Task directory already exists: {dir_name}", Colors.YELLOW), file=sys.stderr)
198
+ else:
199
+ task_dir.mkdir(parents=True)
200
+
201
+ today = datetime.now().strftime("%Y-%m-%d")
202
+
203
+ # Record current branch as base_branch (PR target)
204
+ _, branch_out, _ = run_git(["branch", "--show-current"], cwd=repo_root)
205
+ current_branch = branch_out.strip() or "main"
206
+
207
+ task_data = {
208
+ "id": slug,
209
+ "name": slug,
210
+ "title": args.title,
211
+ "description": args.description or "",
212
+ "status": "planning",
213
+ "dev_type": None,
214
+ "scope": None,
215
+ "package": package,
216
+ "priority": args.priority,
217
+ "creator": creator,
218
+ "assignee": assignee,
219
+ "createdAt": today,
220
+ "completedAt": None,
221
+ "branch": None,
222
+ "base_branch": current_branch,
223
+ "worktree_path": None,
224
+ "commit": None,
225
+ "pr_url": None,
226
+ "subtasks": [],
227
+ "children": [],
228
+ "parent": None,
229
+ "relatedFiles": [],
230
+ "notes": "",
231
+ "meta": {},
232
+ }
233
+
234
+ write_json(task_json_path, task_data)
235
+
236
+ # Seed implement.jsonl / check.jsonl for sub-agent-capable platforms.
237
+ # Agent curates real entries in Phase 1.3 (see .rudder/workflow.md).
238
+ # Agent-less platforms (Kilo / Antigravity / Windsurf) skip this — they
239
+ # load specs via the rudder-before-dev skill instead of JSONL.
240
+ seeded_jsonl = False
241
+ if _has_subagent_platform(repo_root):
242
+ for jsonl_name in ("implement.jsonl", "check.jsonl"):
243
+ jsonl_path = task_dir / jsonl_name
244
+ if not jsonl_path.exists():
245
+ _write_seed_jsonl(jsonl_path)
246
+ seeded_jsonl = True
247
+
248
+ # Handle --parent: establish bidirectional link
249
+ if args.parent:
250
+ parent_dir = resolve_task_dir(args.parent, repo_root)
251
+ parent_json_path = parent_dir / FILE_TASK_JSON
252
+ if not parent_json_path.is_file():
253
+ print(colored(f"Warning: Parent task.json not found: {args.parent}", Colors.YELLOW), file=sys.stderr)
254
+ else:
255
+ parent_data = read_json(parent_json_path)
256
+ if parent_data:
257
+ # Add child to parent's children list
258
+ parent_children = parent_data.get("children", [])
259
+ if dir_name not in parent_children:
260
+ parent_children.append(dir_name)
261
+ parent_data["children"] = parent_children
262
+ write_json(parent_json_path, parent_data)
263
+
264
+ # Set parent in child's task.json
265
+ task_data["parent"] = parent_dir.name
266
+ write_json(task_json_path, task_data)
267
+
268
+ print(colored(f"Linked as child of: {parent_dir.name}", Colors.GREEN), file=sys.stderr)
269
+
270
+ # Auto-activate the new task so the per-turn breadcrumb fires planning
271
+ # state. Best-effort: gracefully degrade if no session identity (CLI run
272
+ # outside an AI session) — the task is still created, the user can run
273
+ # task.py start later. Pointer is session-scoped so this never affects
274
+ # other AI sessions.
275
+ try:
276
+ from .active_task import resolve_context_key, set_active_task
277
+ if resolve_context_key():
278
+ try:
279
+ rel_dir = task_dir.relative_to(repo_root).as_posix()
280
+ except ValueError:
281
+ rel_dir = str(task_dir)
282
+ set_active_task(rel_dir, repo_root)
283
+ except Exception:
284
+ pass
285
+
286
+ print(colored(f"Created task: {dir_name}", Colors.GREEN), file=sys.stderr)
287
+ print("", file=sys.stderr)
288
+ print(colored("Next steps:", Colors.BLUE), file=sys.stderr)
289
+ print(" 1. Create prd.md with requirements", file=sys.stderr)
290
+ if seeded_jsonl:
291
+ print(
292
+ " 2. Curate implement.jsonl / check.jsonl (spec + research files only — "
293
+ "see .rudder/workflow.md Phase 1.3)",
294
+ file=sys.stderr,
295
+ )
296
+ print(" 3. Run: python3 task.py start <dir>", file=sys.stderr)
297
+ else:
298
+ print(" 2. Run: python3 task.py start <dir>", file=sys.stderr)
299
+ print("", file=sys.stderr)
300
+
301
+ # Output relative path for script chaining
302
+ print(f"{DIR_WORKFLOW}/{DIR_TASKS}/{dir_name}")
303
+
304
+ run_task_hooks("after_create", task_json_path, repo_root)
305
+ return 0
306
+
307
+
308
+ # =============================================================================
309
+ # Command: archive
310
+ # =============================================================================
311
+
312
+ def cmd_archive(args: argparse.Namespace) -> int:
313
+ """Archive completed task."""
314
+ repo_root = get_repo_root()
315
+ task_name = args.name
316
+
317
+ if not task_name:
318
+ print(colored("Error: Task name is required", Colors.RED), file=sys.stderr)
319
+ return 1
320
+
321
+ tasks_dir = get_tasks_dir(repo_root)
322
+
323
+ # Resolve task directory (supports task name, relative path, or absolute path)
324
+ task_dir = resolve_task_dir(task_name, repo_root)
325
+
326
+ if not task_dir or not task_dir.is_dir():
327
+ print(colored(f"Error: Task not found: {task_name}", Colors.RED), file=sys.stderr)
328
+ print("Active tasks:", file=sys.stderr)
329
+ # Import lazily to avoid circular dependency
330
+ from .tasks import iter_active_tasks
331
+ for t in iter_active_tasks(tasks_dir):
332
+ print(f" - {t.dir_name}/", file=sys.stderr)
333
+ return 1
334
+
335
+ dir_name = task_dir.name
336
+ task_json_path = task_dir / FILE_TASK_JSON
337
+
338
+ # Update status before archiving
339
+ today = datetime.now().strftime("%Y-%m-%d")
340
+ if task_json_path.is_file():
341
+ data = read_json(task_json_path)
342
+ if data:
343
+ data["status"] = "completed"
344
+ data["completedAt"] = today
345
+ write_json(task_json_path, data)
346
+
347
+ # Handle subtask relationships on archive.
348
+ # Keep this task in its parent's children list so progress
349
+ # counters (children_progress) stay consistent — children
350
+ # missing from the active set are treated as completed.
351
+ task_children = data.get("children", [])
352
+
353
+ # If this is a parent, clear parent field in all children
354
+ if task_children:
355
+ for child_name in task_children:
356
+ child_dir_path = find_task_by_name(child_name, tasks_dir)
357
+ if child_dir_path:
358
+ child_json = child_dir_path / FILE_TASK_JSON
359
+ if child_json.is_file():
360
+ child_data = read_json(child_json)
361
+ if child_data:
362
+ child_data["parent"] = None
363
+ write_json(child_json, child_data)
364
+
365
+ # Clear any session that still points at this task before the path moves.
366
+ from .active_task import clear_task_from_sessions
367
+ clear_task_from_sessions(str(task_dir), repo_root)
368
+
369
+ # Archive
370
+ result = archive_task_complete(task_dir, repo_root)
371
+ if "archived_to" in result:
372
+ archive_dest = Path(result["archived_to"])
373
+ year_month = archive_dest.parent.name
374
+ print(colored(f"Archived: {dir_name} -> archive/{year_month}/", Colors.GREEN), file=sys.stderr)
375
+
376
+ # Auto-commit unless --no-commit
377
+ if not getattr(args, "no_commit", False):
378
+ _auto_commit_archive(dir_name, repo_root)
379
+
380
+ # Return the archive path
381
+ print(f"{DIR_WORKFLOW}/{DIR_TASKS}/{DIR_ARCHIVE}/{year_month}/{dir_name}")
382
+
383
+ # Run hooks with the archived path
384
+ archived_json = archive_dest / FILE_TASK_JSON
385
+ run_task_hooks("after_archive", archived_json, repo_root)
386
+ return 0
387
+
388
+ return 1
389
+
390
+
391
+ def _auto_commit_archive(task_name: str, repo_root: Path) -> None:
392
+ """Stage Rudder-owned task paths and commit after archive.
393
+
394
+ Only stages specific subpaths (the archive subtree and active task dirs),
395
+ never the whole ``.rudder/`` tree. If ``.gitignore`` blocks the paths,
396
+ we warn + skip — we do NOT retry with ``git add -f``. The warning
397
+ explicitly forbids ``git add -f .rudder/`` (which would fan out to
398
+ caches/backups) and points users at ``session_auto_commit: false``.
399
+
400
+ Honors ``session_auto_commit`` in ``.rudder/config.yaml``: when set to
401
+ ``false``, this function returns immediately without touching git
402
+ (the archive directory move on disk is unaffected).
403
+ """
404
+ if not get_session_auto_commit(repo_root):
405
+ print(
406
+ "[OK] session_auto_commit: false — skipping git stage/commit.",
407
+ file=sys.stderr,
408
+ )
409
+ return
410
+
411
+ paths = safe_archive_paths_to_add(repo_root)
412
+ if not paths:
413
+ print("[OK] No task changes to commit.", file=sys.stderr)
414
+ return
415
+
416
+ success, _, err = safe_git_add(paths, repo_root)
417
+ if not success:
418
+ if err and "ignored by" in err.lower():
419
+ print_gitignore_warning(paths)
420
+ else:
421
+ print(
422
+ f"[WARN] git add failed: {err.strip() if err else 'unknown error'}",
423
+ file=sys.stderr,
424
+ )
425
+ return
426
+
427
+ rc, _, _ = run_git(
428
+ ["diff", "--cached", "--quiet", "--", *paths], cwd=repo_root
429
+ )
430
+ if rc == 0:
431
+ print("[OK] No task changes to commit.", file=sys.stderr)
432
+ return
433
+
434
+ commit_msg = f"chore(task): archive {task_name}"
435
+ rc, _, err = run_git(["commit", "-m", commit_msg], cwd=repo_root)
436
+ if rc == 0:
437
+ print(f"[OK] Auto-committed: {commit_msg}", file=sys.stderr)
438
+ else:
439
+ print(f"[WARN] Auto-commit failed: {err.strip()}", file=sys.stderr)
440
+
441
+
442
+ # =============================================================================
443
+ # Command: add-subtask
444
+ # =============================================================================
445
+
446
+ def cmd_add_subtask(args: argparse.Namespace) -> int:
447
+ """Link a child task to a parent task."""
448
+ repo_root = get_repo_root()
449
+
450
+ parent_dir = resolve_task_dir(args.parent_dir, repo_root)
451
+ child_dir = resolve_task_dir(args.child_dir, repo_root)
452
+
453
+ parent_json_path = parent_dir / FILE_TASK_JSON
454
+ child_json_path = child_dir / FILE_TASK_JSON
455
+
456
+ if not parent_json_path.is_file():
457
+ print(colored(f"Error: Parent task.json not found: {args.parent_dir}", Colors.RED), file=sys.stderr)
458
+ return 1
459
+
460
+ if not child_json_path.is_file():
461
+ print(colored(f"Error: Child task.json not found: {args.child_dir}", Colors.RED), file=sys.stderr)
462
+ return 1
463
+
464
+ parent_data = read_json(parent_json_path)
465
+ child_data = read_json(child_json_path)
466
+
467
+ if not parent_data or not child_data:
468
+ print(colored("Error: Failed to read task.json", Colors.RED), file=sys.stderr)
469
+ return 1
470
+
471
+ # Check if child already has a parent
472
+ existing_parent = child_data.get("parent")
473
+ if existing_parent:
474
+ print(colored(f"Error: Child task already has a parent: {existing_parent}", Colors.RED), file=sys.stderr)
475
+ return 1
476
+
477
+ # Add child to parent's children list
478
+ parent_children = parent_data.get("children", [])
479
+ child_dir_name = child_dir.name
480
+ if child_dir_name not in parent_children:
481
+ parent_children.append(child_dir_name)
482
+ parent_data["children"] = parent_children
483
+
484
+ # Set parent in child's task.json
485
+ child_data["parent"] = parent_dir.name
486
+
487
+ # Write both
488
+ write_json(parent_json_path, parent_data)
489
+ write_json(child_json_path, child_data)
490
+
491
+ print(colored(f"Linked: {child_dir.name} -> {parent_dir.name}", Colors.GREEN), file=sys.stderr)
492
+ return 0
493
+
494
+
495
+ # =============================================================================
496
+ # Command: remove-subtask
497
+ # =============================================================================
498
+
499
+ def cmd_remove_subtask(args: argparse.Namespace) -> int:
500
+ """Unlink a child task from a parent task."""
501
+ repo_root = get_repo_root()
502
+
503
+ parent_dir = resolve_task_dir(args.parent_dir, repo_root)
504
+ child_dir = resolve_task_dir(args.child_dir, repo_root)
505
+
506
+ parent_json_path = parent_dir / FILE_TASK_JSON
507
+ child_json_path = child_dir / FILE_TASK_JSON
508
+
509
+ if not parent_json_path.is_file():
510
+ print(colored(f"Error: Parent task.json not found: {args.parent_dir}", Colors.RED), file=sys.stderr)
511
+ return 1
512
+
513
+ if not child_json_path.is_file():
514
+ print(colored(f"Error: Child task.json not found: {args.child_dir}", Colors.RED), file=sys.stderr)
515
+ return 1
516
+
517
+ parent_data = read_json(parent_json_path)
518
+ child_data = read_json(child_json_path)
519
+
520
+ if not parent_data or not child_data:
521
+ print(colored("Error: Failed to read task.json", Colors.RED), file=sys.stderr)
522
+ return 1
523
+
524
+ # Remove child from parent's children list
525
+ parent_children = parent_data.get("children", [])
526
+ child_dir_name = child_dir.name
527
+ if child_dir_name in parent_children:
528
+ parent_children.remove(child_dir_name)
529
+ parent_data["children"] = parent_children
530
+
531
+ # Clear parent in child's task.json
532
+ child_data["parent"] = None
533
+
534
+ # Write both
535
+ write_json(parent_json_path, parent_data)
536
+ write_json(child_json_path, child_data)
537
+
538
+ print(colored(f"Unlinked: {child_dir.name} from {parent_dir.name}", Colors.GREEN), file=sys.stderr)
539
+ return 0
540
+
541
+
542
+ # =============================================================================
543
+ # Command: set-branch
544
+ # =============================================================================
545
+
546
+ def cmd_set_branch(args: argparse.Namespace) -> int:
547
+ """Set git branch for task."""
548
+ repo_root = get_repo_root()
549
+ target_dir = resolve_task_dir(args.dir, repo_root)
550
+ branch = args.branch
551
+
552
+ if not branch:
553
+ print(colored("Error: Missing arguments", Colors.RED))
554
+ print("Usage: python3 task.py set-branch <task-dir> <branch-name>")
555
+ return 1
556
+
557
+ task_json = target_dir / FILE_TASK_JSON
558
+ if not task_json.is_file():
559
+ print(colored(f"Error: task.json not found at {target_dir}", Colors.RED))
560
+ return 1
561
+
562
+ data = read_json(task_json)
563
+ if not data:
564
+ return 1
565
+
566
+ data["branch"] = branch
567
+ write_json(task_json, data)
568
+
569
+ print(colored(f"✓ Branch set to: {branch}", Colors.GREEN))
570
+ return 0
571
+
572
+
573
+ # =============================================================================
574
+ # Command: set-base-branch
575
+ # =============================================================================
576
+
577
+ def cmd_set_base_branch(args: argparse.Namespace) -> int:
578
+ """Set the base branch (PR target) for task."""
579
+ repo_root = get_repo_root()
580
+ target_dir = resolve_task_dir(args.dir, repo_root)
581
+ base_branch = args.base_branch
582
+
583
+ if not base_branch:
584
+ print(colored("Error: Missing arguments", Colors.RED))
585
+ print("Usage: python3 task.py set-base-branch <task-dir> <base-branch>")
586
+ print("Example: python3 task.py set-base-branch <dir> develop")
587
+ print()
588
+ print("This sets the target branch for PR (the branch your feature will merge into).")
589
+ return 1
590
+
591
+ task_json = target_dir / FILE_TASK_JSON
592
+ if not task_json.is_file():
593
+ print(colored(f"Error: task.json not found at {target_dir}", Colors.RED))
594
+ return 1
595
+
596
+ data = read_json(task_json)
597
+ if not data:
598
+ return 1
599
+
600
+ data["base_branch"] = base_branch
601
+ write_json(task_json, data)
602
+
603
+ print(colored(f"✓ Base branch set to: {base_branch}", Colors.GREEN))
604
+ print(f" PR will target: {base_branch}")
605
+ return 0
606
+
607
+
608
+ # =============================================================================
609
+ # Command: set-scope
610
+ # =============================================================================
611
+
612
+ def cmd_set_scope(args: argparse.Namespace) -> int:
613
+ """Set scope for PR title."""
614
+ repo_root = get_repo_root()
615
+ target_dir = resolve_task_dir(args.dir, repo_root)
616
+ scope = args.scope
617
+
618
+ if not scope:
619
+ print(colored("Error: Missing arguments", Colors.RED))
620
+ print("Usage: python3 task.py set-scope <task-dir> <scope>")
621
+ return 1
622
+
623
+ task_json = target_dir / FILE_TASK_JSON
624
+ if not task_json.is_file():
625
+ print(colored(f"Error: task.json not found at {target_dir}", Colors.RED))
626
+ return 1
627
+
628
+ data = read_json(task_json)
629
+ if not data:
630
+ return 1
631
+
632
+ data["scope"] = scope
633
+ write_json(task_json, data)
634
+
635
+ print(colored(f"✓ Scope set to: {scope}", Colors.GREEN))
636
+ return 0