@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,827 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ Session Start Hook - Inject structured context
5
+ """
6
+ from __future__ import annotations
7
+
8
+ # IMPORTANT: Suppress all warnings FIRST
9
+ import warnings
10
+ warnings.filterwarnings("ignore")
11
+
12
+ import json
13
+ import os
14
+ import re
15
+ import shlex
16
+ import subprocess
17
+ import sys
18
+ from io import StringIO
19
+ from pathlib import Path
20
+
21
+
22
+ def _normalize_windows_shell_path(path_str: str) -> str:
23
+ """Normalize Unix-style shell paths to real Windows paths.
24
+
25
+ On Windows, shells like Git Bash / MSYS2 / Cygwin may report paths like
26
+ `/d/Users/...` or `/cygdrive/d/Users/...`. `Path.resolve()` will misinterpret
27
+ these as `D:/d/Users...` on drive D: (or similar), breaking repo root
28
+ detection.
29
+
30
+ This function is intentionally conservative: it only rewrites patterns that
31
+ unambiguously represent a drive letter mount.
32
+ """
33
+ if not isinstance(path_str, str) or not path_str:
34
+ return path_str
35
+
36
+ # Only relevant on Windows; keep other platforms untouched.
37
+ if not sys.platform.startswith("win"):
38
+ return path_str
39
+
40
+ p = path_str.strip()
41
+
42
+ # Already a Windows drive path (C:\... or C:/...)
43
+ if re.match(r"^[A-Za-z]:[\/]", p):
44
+ return p
45
+
46
+ # MSYS/Git-Bash style: /c/Users/... or /d/Work/...
47
+ m = re.match(r"^/([A-Za-z])/(.*)", p)
48
+ if m:
49
+ drive, rest = m.group(1).upper(), m.group(2)
50
+ rest = rest.replace('/', '\\')
51
+ return f"{drive}:\\{rest}"
52
+
53
+ # Cygwin style: /cygdrive/c/Users/...
54
+ m = re.match(r"^/cygdrive/([A-Za-z])/(.*)", p)
55
+ if m:
56
+ drive, rest = m.group(1).upper(), m.group(2)
57
+ rest = rest.replace('/', '\\')
58
+ return f"{drive}:\\{rest}"
59
+
60
+ # WSL mounted drive (sometimes leaked into env): /mnt/c/Users/...
61
+ m = re.match(r"^/mnt/([A-Za-z])/(.*)", p)
62
+ if m:
63
+ drive, rest = m.group(1).upper(), m.group(2)
64
+ rest = rest.replace('/', '\\')
65
+ return f"{drive}:\\{rest}"
66
+
67
+ return path_str
68
+
69
+
70
+ FIRST_REPLY_NOTICE = """<first-reply-notice>
71
+ On the first visible assistant reply in this session, begin with exactly one short Chinese sentence:
72
+ Rudder SessionStart 已注入:workflow、当前任务状态、开发者身份、git 状态、active tasks、spec 索引已加载。
73
+ Then continue directly with the user's request. This notice is one-shot: do not repeat it after the first assistant reply in the same session.
74
+ </first-reply-notice>"""
75
+
76
+ # Force UTF-8 on stdin/stdout/stderr on Windows. Default codepage there is
77
+ # cp936 / cp1252 / etc. — non-ASCII content (Chinese task names, prd snippets)
78
+ # both in stdin (hook payload from host CLI) and stdout (our emitted blocks)
79
+ # raises UnicodeDecodeError / UnicodeEncodeError. Equivalent to `python -X utf8`
80
+ # but applied per-stream so we don't depend on host CLI's command wiring.
81
+ if sys.platform.startswith("win"):
82
+ import io as _io
83
+ for _stream_name in ("stdin", "stdout", "stderr"):
84
+ _stream = getattr(sys, _stream_name, None)
85
+ if _stream is None:
86
+ continue
87
+ if hasattr(_stream, "reconfigure"):
88
+ try:
89
+ _stream.reconfigure(encoding="utf-8", errors="replace") # type: ignore[union-attr]
90
+ except Exception:
91
+ pass
92
+ elif hasattr(_stream, "detach"):
93
+ try:
94
+ setattr(sys, _stream_name, _io.TextIOWrapper(_stream.detach(), encoding="utf-8", errors="replace"))
95
+ except Exception:
96
+ pass
97
+
98
+
99
+
100
+ def _has_curated_jsonl_entry(jsonl_path: Path) -> bool:
101
+ """Return True iff jsonl has at least one row with a ``file`` field.
102
+
103
+ A freshly seeded jsonl only contains a ``{"_example": ...}`` row (no
104
+ ``file`` key) — that is NOT "ready". Readiness requires at least one
105
+ curated entry. Matches the contract used by hook-inject and pull-based
106
+ sub-agent context loaders.
107
+ """
108
+ try:
109
+ for line in jsonl_path.read_text(encoding="utf-8").splitlines():
110
+ line = line.strip()
111
+ if not line:
112
+ continue
113
+ try:
114
+ row = json.loads(line)
115
+ except json.JSONDecodeError:
116
+ continue
117
+ if isinstance(row, dict) and row.get("file"):
118
+ return True
119
+ except (OSError, UnicodeDecodeError):
120
+ return False
121
+ return False
122
+
123
+
124
+ def should_skip_injection() -> bool:
125
+ """Check if any platform's non-interactive flag is set, or if Rudder
126
+ hooks are explicitly disabled via RUDDER_HOOKS=0 / RUDDER_DISABLE_HOOKS=1.
127
+ """
128
+ if os.environ.get("RUDDER_HOOKS") == "0":
129
+ return True
130
+ if os.environ.get("RUDDER_DISABLE_HOOKS") == "1":
131
+ return True
132
+ non_interactive_vars = [
133
+ "CLAUDE_NON_INTERACTIVE",
134
+ "QODER_NON_INTERACTIVE",
135
+ "CODEBUDDY_NON_INTERACTIVE",
136
+ "FACTORY_NON_INTERACTIVE",
137
+ "CURSOR_NON_INTERACTIVE",
138
+ "GEMINI_NON_INTERACTIVE",
139
+ "KIRO_NON_INTERACTIVE",
140
+ "COPILOT_NON_INTERACTIVE",
141
+ ]
142
+ return any(os.environ.get(var) == "1" for var in non_interactive_vars)
143
+
144
+
145
+ def read_file(path: Path, fallback: str = "") -> str:
146
+ try:
147
+ return path.read_text(encoding="utf-8")
148
+ except (FileNotFoundError, PermissionError):
149
+ return fallback
150
+
151
+
152
+ def _detect_platform(input_data: dict) -> str | None:
153
+ if isinstance(input_data.get("cursor_version"), str):
154
+ return "cursor"
155
+ env_map = {
156
+ "CLAUDE_PROJECT_DIR": "claude",
157
+ "CURSOR_PROJECT_DIR": "cursor",
158
+ "CODEBUDDY_PROJECT_DIR": "codebuddy",
159
+ "FACTORY_PROJECT_DIR": "droid",
160
+ "GEMINI_PROJECT_DIR": "gemini",
161
+ "QODER_PROJECT_DIR": "qoder",
162
+ "KIRO_PROJECT_DIR": "kiro",
163
+ "COPILOT_PROJECT_DIR": "copilot",
164
+ }
165
+ for env_name, platform in env_map.items():
166
+ if os.environ.get(env_name):
167
+ return platform
168
+ script_parts = set(Path(sys.argv[0]).parts)
169
+ if ".claude" in script_parts:
170
+ return "claude"
171
+ if ".cursor" in script_parts:
172
+ return "cursor"
173
+ if ".codex" in script_parts:
174
+ return "codex"
175
+ if ".gemini" in script_parts:
176
+ return "gemini"
177
+ if ".qoder" in script_parts:
178
+ return "qoder"
179
+ if ".codebuddy" in script_parts:
180
+ return "codebuddy"
181
+ if ".factory" in script_parts:
182
+ return "droid"
183
+ if ".kiro" in script_parts:
184
+ return "kiro"
185
+ return None
186
+
187
+
188
+ def _resolve_context_key(rudder_dir: Path, input_data: dict) -> str | None:
189
+ scripts_dir = rudder_dir / "scripts"
190
+ if str(scripts_dir) not in sys.path:
191
+ sys.path.insert(0, str(scripts_dir))
192
+ from common.active_task import resolve_context_key # type: ignore[import-not-found]
193
+
194
+ return resolve_context_key(input_data, platform=_detect_platform(input_data))
195
+
196
+
197
+ def _persist_context_key_for_bash(context_key: str | None) -> None:
198
+ """Expose Rudder session identity to later Claude Code Bash commands.
199
+
200
+ Claude Code SessionStart hooks can append exports to CLAUDE_ENV_FILE; those
201
+ variables are then available to Bash tools in the same conversation. Without
202
+ this bridge, `task.py start` has hook stdin during SessionStart but no
203
+ session identity when the AI later runs it as a normal shell command.
204
+ """
205
+ if not context_key:
206
+ return
207
+ env_file = os.environ.get("CLAUDE_ENV_FILE")
208
+ if not env_file:
209
+ return
210
+ try:
211
+ with open(env_file, "a", encoding="utf-8") as handle:
212
+ handle.write(f"export RUDDER_CONTEXT_ID={shlex.quote(context_key)}\n")
213
+ except OSError:
214
+ pass
215
+
216
+
217
+ def _resolve_active_task(rudder_dir: Path, input_data: dict):
218
+ scripts_dir = rudder_dir / "scripts"
219
+ if str(scripts_dir) not in sys.path:
220
+ sys.path.insert(0, str(scripts_dir))
221
+ from common.active_task import resolve_active_task # type: ignore[import-not-found]
222
+
223
+ return resolve_active_task(
224
+ rudder_dir.parent,
225
+ input_data,
226
+ platform=_detect_platform(input_data),
227
+ )
228
+
229
+
230
+ def run_script(script_path: Path, context_key: str | None = None) -> str:
231
+ try:
232
+ if script_path.suffix == ".py":
233
+ # Add PYTHONIOENCODING to force UTF-8 in subprocess
234
+ env = os.environ.copy()
235
+ env["PYTHONIOENCODING"] = "utf-8"
236
+ if context_key:
237
+ env["RUDDER_CONTEXT_ID"] = context_key
238
+ cmd = [sys.executable, "-W", "ignore", str(script_path)]
239
+ else:
240
+ env = os.environ.copy()
241
+ if context_key:
242
+ env["RUDDER_CONTEXT_ID"] = context_key
243
+ cmd = [str(script_path)]
244
+
245
+ result = subprocess.run(
246
+ cmd,
247
+ capture_output=True,
248
+ text=True,
249
+ encoding="utf-8",
250
+ errors="replace",
251
+ timeout=5,
252
+ cwd=script_path.parent.parent.parent,
253
+ env=env,
254
+ )
255
+ return result.stdout if result.returncode == 0 else "No context available"
256
+ except (subprocess.TimeoutExpired, FileNotFoundError, PermissionError):
257
+ return "No context available"
258
+
259
+
260
+ def _normalize_task_ref(task_ref: str) -> str:
261
+ normalized = task_ref.strip()
262
+ if not normalized:
263
+ return ""
264
+
265
+ path_obj = Path(normalized)
266
+ if path_obj.is_absolute():
267
+ return str(path_obj)
268
+
269
+ normalized = normalized.replace("\\", "/")
270
+ while normalized.startswith("./"):
271
+ normalized = normalized[2:]
272
+
273
+ if normalized.startswith("tasks/"):
274
+ return f".rudder/{normalized}"
275
+
276
+ return normalized
277
+
278
+
279
+ def _resolve_task_dir(rudder_dir: Path, task_ref: str) -> Path:
280
+ normalized = _normalize_task_ref(task_ref)
281
+ path_obj = Path(normalized)
282
+ if path_obj.is_absolute():
283
+ return path_obj
284
+ if normalized.startswith(".rudder/"):
285
+ return rudder_dir.parent / path_obj
286
+ return rudder_dir / "tasks" / path_obj
287
+
288
+
289
+ def _get_task_status(rudder_dir: Path, input_data: dict) -> str:
290
+ """Check current task status and return structured status string with explicit next action.
291
+
292
+ Returns a block with three fields:
293
+ - Status: current state
294
+ - Task: task identifier (when applicable)
295
+ - Next-Action: explicit skill/command/tool call the AI should invoke
296
+ """
297
+ active = _resolve_active_task(rudder_dir, input_data)
298
+
299
+ # Case 1: No active task — waiting for user to describe intent
300
+ if not active.task_path:
301
+ return (
302
+ "Status: NO ACTIVE TASK\n"
303
+ f"Source: {active.source}\n"
304
+ "Next-Action: After the user describes their intent, load skill `rudder-brainstorm` "
305
+ "to clarify requirements and create a task via `python3 ./.rudder/scripts/task.py create`.\n"
306
+ "Research reminder: for research-heavy tasks (comparing tools, reading external docs, "
307
+ "cross-platform surveys), spawn `rudder-research` sub-agents via the Task tool — "
308
+ "they persist findings to `{TASK_DIR}/research/*.md` and keep main context clean. "
309
+ "Do NOT do 10+ inline WebFetch/WebSearch in the main conversation.\n"
310
+ "User override (per-turn escape hatch): if the user's first message explicitly opts "
311
+ "out of the workflow (\"跳过 rudder\" / \"别走流程\" / \"小修一下\" / \"直接改\" / "
312
+ "\"skip rudder\" / \"no task\" / \"just do it\"), honor it for this turn — "
313
+ "acknowledge briefly and proceed without creating a task. Per-turn only."
314
+ )
315
+
316
+ # Case 2: Stale pointer — task dir was deleted
317
+ task_ref = active.task_path
318
+ task_dir = _resolve_task_dir(rudder_dir, task_ref)
319
+ if active.stale or not task_dir.is_dir():
320
+ return (
321
+ f"Status: STALE POINTER\nTask: {task_ref}\n"
322
+ f"Source: {active.source}\n"
323
+ f"Next-Action: Run `python3 ./.rudder/scripts/task.py finish` to clear the stale pointer, "
324
+ "then ask the user what to work on next."
325
+ )
326
+
327
+ # Read task.json
328
+ task_json_path = task_dir / "task.json"
329
+ task_data = {}
330
+ if task_json_path.is_file():
331
+ try:
332
+ task_data = json.loads(task_json_path.read_text(encoding="utf-8"))
333
+ except (json.JSONDecodeError, PermissionError):
334
+ pass
335
+
336
+ task_title = task_data.get("title", task_ref)
337
+ task_status = task_data.get("status", "unknown")
338
+
339
+ # Case 3: Task completed — time to archive
340
+ if task_status == "completed":
341
+ return (
342
+ f"Status: COMPLETED\nTask: {task_title}\n"
343
+ f"Source: {active.source}\n"
344
+ f"Next-Action: Load skill `rudder-update-spec` to capture learnings, "
345
+ f"then archive with `python3 ./.rudder/scripts/task.py archive {task_dir.name}`."
346
+ )
347
+
348
+ has_prd = (task_dir / "prd.md").is_file()
349
+
350
+ # Case 4: No PRD — still in Plan phase
351
+ if not has_prd:
352
+ return (
353
+ f"Status: PLANNING\nTask: {task_title}\n"
354
+ f"Source: {active.source}\n"
355
+ "Next-Action: Load skill `rudder-brainstorm` to clarify requirements with the user "
356
+ "and produce prd.md in the task directory.\n"
357
+ "Research reminder: when the task needs external research (tool comparison, docs, "
358
+ "conventions survey), spawn `rudder-research` sub-agents — don't WebFetch/WebSearch "
359
+ "inline in the main session. Findings go to `{task_dir}/research/*.md`; PRD only links to them."
360
+ )
361
+
362
+ # Case 4b: PRD exists but implement.jsonl has only seed (no curated entries) — Phase 1.3 gate
363
+ implement_jsonl = task_dir / "implement.jsonl"
364
+ if implement_jsonl.is_file() and not _has_curated_jsonl_entry(implement_jsonl):
365
+ return (
366
+ f"Status: PLANNING (Phase 1.3)\nTask: {task_title}\n"
367
+ f"Source: {active.source}\n"
368
+ "Next-Action: Curate `implement.jsonl` and `check.jsonl` with the spec + research files "
369
+ "the Phase 2 sub-agents will need. Only spec paths (`.rudder/spec/**/*.md`) and research "
370
+ "files (`{TASK_DIR}/research/*.md`) — no code paths. Run "
371
+ "`python3 ./.rudder/scripts/get_context.py --mode packages` to list available specs, "
372
+ "then edit the jsonl files or use `python3 ./.rudder/scripts/task.py add-context`. "
373
+ "See `.rudder/workflow.md` Phase 1.3 for details."
374
+ )
375
+
376
+ # Case 5: PRD + curated jsonl (or agent-less platform with no jsonl) — enter Execute phase
377
+ return (
378
+ f"Status: READY\nTask: {task_title}\n"
379
+ f"Source: {active.source}\n"
380
+ "Next required action: dispatch `rudder-implement` per Phase 2.1. "
381
+ "For agent-capable platforms, the default is to NOT edit code in the main session. "
382
+ "After implementation, dispatch `rudder-check` per Phase 2.2 before reporting completion.\n"
383
+ "Sub-agent roster: `rudder-implement` (writes code), `rudder-check` (verifies + self-fixes), "
384
+ "`rudder-research` (persists findings to `research/*.md` — use when you'd otherwise do "
385
+ "multiple WebFetch/WebSearch inline).\n"
386
+ "Sub-agent self-exemption: if you are reading this as a `rudder-implement` or "
387
+ "`rudder-check` sub-agent (your own role / agent name reflects that), this dispatch "
388
+ "instruction does NOT apply to you — you are already the dispatched sub-agent. "
389
+ "Implement / check directly without spawning another sub-agent of the same kind.\n"
390
+ "User override (per-turn escape hatch): if the user's CURRENT message explicitly tells the "
391
+ "main session to handle it directly (\"你直接改\" / \"别派 sub-agent\" / \"main session 写就行\" / "
392
+ "\"do it inline\" / \"不用 sub-agent\"), honor it for this turn and edit code directly. "
393
+ "Per-turn only; do NOT invent an override the user did not say."
394
+ )
395
+
396
+
397
+ def _load_rudder_config(rudder_dir: Path, input_data: dict) -> tuple:
398
+ """Load Rudder config for session-start decisions.
399
+
400
+ Returns:
401
+ (is_mono, packages_dict, spec_scope, task_pkg, default_pkg)
402
+ """
403
+ scripts_dir = rudder_dir / "scripts"
404
+ if str(scripts_dir) not in sys.path:
405
+ sys.path.insert(0, str(scripts_dir))
406
+
407
+ try:
408
+ from common.config import get_default_package, get_packages, get_spec_scope, is_monorepo # type: ignore[import-not-found]
409
+ from common.paths import get_current_task # type: ignore[import-not-found]
410
+
411
+ repo_root = rudder_dir.parent
412
+ is_mono = is_monorepo(repo_root)
413
+ packages = get_packages(repo_root) or {}
414
+ scope = get_spec_scope(repo_root)
415
+
416
+ # Get active task's package
417
+ task_pkg = None
418
+ current = get_current_task(
419
+ repo_root,
420
+ input_data,
421
+ platform=_detect_platform(input_data),
422
+ )
423
+ if current:
424
+ task_json = repo_root / current / "task.json"
425
+ if task_json.is_file():
426
+ try:
427
+ data = json.loads(task_json.read_text(encoding="utf-8"))
428
+ if isinstance(data, dict):
429
+ tp = data.get("package")
430
+ if isinstance(tp, str) and tp:
431
+ task_pkg = tp
432
+ except (json.JSONDecodeError, OSError):
433
+ pass
434
+
435
+ default_pkg = get_default_package(repo_root)
436
+ return is_mono, packages, scope, task_pkg, default_pkg
437
+ except Exception:
438
+ return False, {}, None, None, None
439
+
440
+
441
+ def _check_legacy_spec(rudder_dir: Path, is_mono: bool, packages: dict) -> str | None:
442
+ """Check for legacy spec directory structure in monorepo.
443
+
444
+ Returns warning message if legacy structure detected, None otherwise.
445
+ """
446
+ if not is_mono or not packages:
447
+ return None
448
+
449
+ spec_dir = rudder_dir / "spec"
450
+ if not spec_dir.is_dir():
451
+ return None
452
+
453
+ # Check for legacy flat spec dirs (spec/backend/, spec/frontend/ with index.md)
454
+ has_legacy = False
455
+ for legacy_name in ("backend", "frontend"):
456
+ legacy_dir = spec_dir / legacy_name
457
+ if legacy_dir.is_dir() and (legacy_dir / "index.md").is_file():
458
+ has_legacy = True
459
+ break
460
+
461
+ if not has_legacy:
462
+ return None
463
+
464
+ # Check which packages are missing spec/<pkg>/ directory
465
+ missing = [
466
+ name for name in sorted(packages.keys())
467
+ if not (spec_dir / name).is_dir()
468
+ ]
469
+
470
+ if not missing:
471
+ return None # All packages have spec dirs
472
+
473
+ if len(missing) == len(packages):
474
+ return (
475
+ f"[!] Legacy spec structure detected: found `spec/backend/` or `spec/frontend/` "
476
+ f"but no package-scoped `spec/<package>/` directories.\n"
477
+ f"Monorepo packages: {', '.join(sorted(packages.keys()))}\n"
478
+ f"Please reorganize: `spec/backend/` -> `spec/<package>/backend/`"
479
+ )
480
+ return (
481
+ f"[!] Partial spec migration detected: packages {', '.join(missing)} "
482
+ f"still missing `spec/<pkg>/` directory.\n"
483
+ f"Please complete migration for all packages."
484
+ )
485
+
486
+
487
+ def _build_tool_paths_block(rudder_dir: Path) -> str:
488
+ """Build <tool-paths> block for session-start context."""
489
+ repo_root = rudder_dir.parent
490
+ try:
491
+ from common.rudder_config import resolve_tools # type: ignore[import-not-found]
492
+ tools = resolve_tools(repo_root)
493
+ except Exception:
494
+ return ""
495
+
496
+ if not tools:
497
+ return ""
498
+
499
+ lines = ["<tool-paths>", "Tool paths for this project:"]
500
+ for name, info in sorted(tools.items()):
501
+ path = info.get("path", name)
502
+ parts = [path]
503
+ version = info.get("version")
504
+ if version:
505
+ parts.append(f"(required version: {version})")
506
+ lines.append(f"- {name}: {' '.join(parts)}")
507
+ lines.append("")
508
+ lines.append("If a tool is missing or the path is wrong, locate the correct path and update `.rudder/config_local.yml`.")
509
+ lines.append("</tool-paths>")
510
+ return "\n".join(lines)
511
+
512
+
513
+ def _resolve_spec_scope(
514
+ is_mono: bool,
515
+ packages: dict,
516
+ scope,
517
+ task_pkg: str | None,
518
+ default_pkg: str | None,
519
+ ) -> set | None:
520
+ """Resolve which packages should have their specs injected.
521
+
522
+ Returns:
523
+ Set of package names to include, or None for full scan.
524
+ """
525
+ if not is_mono or not packages:
526
+ return None # Single-repo: full scan
527
+
528
+ if scope is None:
529
+ return None # No scope configured: full scan
530
+
531
+ if isinstance(scope, str) and scope == "active_task":
532
+ if task_pkg and task_pkg in packages:
533
+ return {task_pkg}
534
+ if default_pkg and default_pkg in packages:
535
+ return {default_pkg}
536
+ return None # Fallback to full scan
537
+
538
+ if isinstance(scope, list):
539
+ valid = set()
540
+ for entry in scope:
541
+ if entry in packages:
542
+ valid.add(entry)
543
+ else:
544
+ print(
545
+ f"Warning: spec_scope contains unknown package: {entry}, ignoring",
546
+ file=sys.stderr,
547
+ )
548
+
549
+ if valid:
550
+ # Warn if active task is out of scope
551
+ if task_pkg and task_pkg not in valid:
552
+ print(
553
+ f"Warning: active task package '{task_pkg}' is out of configured spec_scope",
554
+ file=sys.stderr,
555
+ )
556
+ return valid
557
+
558
+ # All entries invalid: fallback chain
559
+ print(
560
+ "Warning: all spec_scope entries invalid, falling back to task/default/full",
561
+ file=sys.stderr,
562
+ )
563
+ if task_pkg and task_pkg in packages:
564
+ return {task_pkg}
565
+ if default_pkg and default_pkg in packages:
566
+ return {default_pkg}
567
+ return None # Full scan
568
+
569
+ return None # Unknown scope type: full scan
570
+
571
+
572
+ def _extract_range(content: str, start_header: str, end_header: str) -> str:
573
+ """Extract lines starting at `## start_header` up to (but excluding) `## end_header`.
574
+
575
+ Both parameters are full header lines WITHOUT the `## ` prefix (e.g. "Phase Index").
576
+ Returns empty string if start header is not found.
577
+ End header missing → extracts to end of file.
578
+ """
579
+ lines = content.splitlines()
580
+ start: int | None = None
581
+ end: int = len(lines)
582
+ start_match = f"## {start_header}"
583
+ end_match = f"## {end_header}"
584
+ for i, line in enumerate(lines):
585
+ stripped = line.strip()
586
+ if start is None and stripped == start_match:
587
+ start = i
588
+ continue
589
+ if start is not None and stripped == end_match:
590
+ end = i
591
+ break
592
+ if start is None:
593
+ return ""
594
+ return "\n".join(lines[start:end]).rstrip()
595
+
596
+
597
+ _BREADCRUMB_TAG_RE = re.compile(
598
+ r"\[workflow-state:([A-Za-z0-9_-]+)\]\s*\n.*?\n\s*\[/workflow-state:\1\]",
599
+ re.DOTALL,
600
+ )
601
+
602
+
603
+ def _strip_breadcrumb_tag_blocks(content: str) -> str:
604
+ """Remove `[workflow-state:STATUS]...[/workflow-state:STATUS]` blocks.
605
+
606
+ The tag blocks live inside `## Phase Index` (since v0.5.0-rc.0, when
607
+ they were colocated with their phase summaries) and are consumed by the
608
+ UserPromptSubmit hook (`inject-workflow-state.py`). The session-start
609
+ payload already covers the full step bodies, so re-inlining the
610
+ breadcrumbs here would just duplicate context.
611
+ """
612
+ return _BREADCRUMB_TAG_RE.sub("", content)
613
+
614
+
615
+ def _build_workflow_overview(workflow_path: Path) -> str:
616
+ """Inject the workflow guide for the session.
617
+
618
+ Contents:
619
+ 1. Section index (all `## ` headings — navigation)
620
+ 2. Phase Index section (rules, skill routing table, anti-rationalization table)
621
+ 3. Phase 1/2/3 step-level details (the actual how-to for each step)
622
+
623
+ The meta sections (Core Principles / Rudder System / Customizing
624
+ Rudder) are NOT injected — Core Principles is short prose the AI can
625
+ Read on demand; Rudder System lists reference commands duplicated in
626
+ step bodies; Customizing Rudder is for forks. Workflow-state breadcrumb
627
+ tag blocks (which now live inside Phase Index since v0.5.0-rc.0) are
628
+ stripped from the extracted range — they're consumed by the
629
+ UserPromptSubmit hook, not the session-start preamble.
630
+
631
+ Total budget: Phase Index ~2 KB + Phase 1/2/3 ~7 KB = ~9 KB.
632
+ """
633
+ content = read_file(workflow_path)
634
+ if not content:
635
+ return "No workflow.md found"
636
+
637
+ out_lines = [
638
+ "# Development Workflow — Section Index",
639
+ "Full guide: .rudder/workflow.md (read on demand)",
640
+ "",
641
+ "## Table of Contents",
642
+ ]
643
+ for line in content.splitlines():
644
+ if line.startswith("## "):
645
+ out_lines.append(line)
646
+ out_lines += ["", "---", ""]
647
+
648
+ # Extract Phase Index through the end of Phase 3 (before "Customizing
649
+ # Rudder" — the docs-for-forks footer added in v0.5.0-rc.0). Since
650
+ # sections appear in order Phase Index → Phase 1 → Phase 2 → Phase 3 →
651
+ # Customizing Rudder, a single range grab captures all four. The
652
+ # breadcrumb tag blocks now embedded inside Phase Index are stripped so
653
+ # they don't duplicate the per-turn UserPromptSubmit injection.
654
+ phases = _extract_range(
655
+ content, "Phase Index", "Customizing Rudder (for forks)"
656
+ )
657
+ if phases:
658
+ out_lines.append(_strip_breadcrumb_tag_blocks(phases).rstrip())
659
+
660
+ return "\n".join(out_lines).rstrip()
661
+
662
+
663
+ def main():
664
+ if should_skip_injection():
665
+ sys.exit(0)
666
+
667
+ try:
668
+ hook_input = json.loads(sys.stdin.read())
669
+ if not isinstance(hook_input, dict):
670
+ hook_input = {}
671
+ except (json.JSONDecodeError, ValueError):
672
+ hook_input = {}
673
+
674
+ # Try platform-specific env vars, hook cwd, fallback to cwd
675
+ project_dir_env_vars = [
676
+ "CLAUDE_PROJECT_DIR",
677
+ "QODER_PROJECT_DIR",
678
+ "CODEBUDDY_PROJECT_DIR",
679
+ "FACTORY_PROJECT_DIR",
680
+ "CURSOR_PROJECT_DIR",
681
+ "GEMINI_PROJECT_DIR",
682
+ "KIRO_PROJECT_DIR",
683
+ "COPILOT_PROJECT_DIR",
684
+ ]
685
+ project_dir = None
686
+ for var in project_dir_env_vars:
687
+ val = os.environ.get(var)
688
+ if val:
689
+ project_dir = Path(_normalize_windows_shell_path(val)).resolve()
690
+ break
691
+ if project_dir is None:
692
+ project_dir = Path(_normalize_windows_shell_path(hook_input.get("cwd", "."))).resolve()
693
+
694
+ rudder_dir = project_dir / ".rudder"
695
+ context_key = _resolve_context_key(rudder_dir, hook_input)
696
+ _persist_context_key_for_bash(context_key)
697
+
698
+ # Load config for scope filtering and legacy detection
699
+ is_mono, packages, scope_config, task_pkg, default_pkg = _load_rudder_config(
700
+ rudder_dir,
701
+ hook_input,
702
+ )
703
+ allowed_pkgs = _resolve_spec_scope(is_mono, packages, scope_config, task_pkg, default_pkg)
704
+
705
+ output = StringIO()
706
+
707
+ output.write("""<session-context>
708
+ You are starting a new session in a Rudder-managed project.
709
+ Read and follow all instructions below carefully.
710
+ </session-context>
711
+
712
+ """)
713
+ output.write(FIRST_REPLY_NOTICE)
714
+ output.write("\n\n")
715
+
716
+ # Legacy migration warning
717
+ legacy_warning = _check_legacy_spec(rudder_dir, is_mono, packages)
718
+ if legacy_warning:
719
+ output.write(f"<migration-warning>\n{legacy_warning}\n</migration-warning>\n\n")
720
+
721
+ output.write("<current-state>\n")
722
+ context_script = rudder_dir / "scripts" / "get_context.py"
723
+ output.write(run_script(context_script, context_key))
724
+ output.write("\n</current-state>\n\n")
725
+
726
+ output.write("<workflow>\n")
727
+ output.write(_build_workflow_overview(rudder_dir / "workflow.md"))
728
+ output.write("\n</workflow>\n\n")
729
+
730
+ output.write("<guidelines>\n")
731
+ output.write(
732
+ "Project spec indexes are listed by path below. Each index contains a "
733
+ "**Pre-Development Checklist** listing the specific guideline files to "
734
+ "read before coding.\n\n"
735
+ "- If you're spawning an implement/check sub-agent, context is injected "
736
+ "or loaded by the sub-agent via `{task}/implement.jsonl` / `check.jsonl`. "
737
+ "You do NOT need to read these indexes yourself.\n"
738
+ "- For agent-capable platforms, the default is to dispatch "
739
+ "`rudder-implement` and `rudder-check` (so JSONL context is loaded by "
740
+ "the sub-agents) rather than editing code in the main session. "
741
+ "Honor a per-turn user override only if the user's current message "
742
+ "explicitly opts out (see <task-status> below for override phrases).\n"
743
+ "- Sub-agent self-exemption: if you are reading this as a `rudder-implement` "
744
+ "or `rudder-check` sub-agent, the \"dispatch rudder-implement / rudder-check\" "
745
+ "rule above does NOT apply to you — you are already the dispatched sub-agent. "
746
+ "Do NOT spawn another sub-agent of the same kind; implement / check directly.\n\n"
747
+ )
748
+
749
+ # guides/ is cross-package thinking — always include inline (small, broadly useful)
750
+ guides_index = rudder_dir / "spec" / "guides" / "index.md"
751
+ if guides_index.is_file():
752
+ output.write("## guides (inlined — cross-package thinking guides)\n")
753
+ output.write(read_file(guides_index))
754
+ output.write("\n\n")
755
+
756
+ # Other spec indexes — paths only (main agent reads on demand;
757
+ # sub-agents get their specific specs via jsonl injection)
758
+ paths: list[str] = []
759
+ spec_dir = rudder_dir / "spec"
760
+ if spec_dir.is_dir():
761
+ for sub in sorted(spec_dir.iterdir()):
762
+ if not sub.is_dir() or sub.name.startswith("."):
763
+ continue
764
+ if sub.name == "guides":
765
+ continue # already inlined above
766
+
767
+ index_file = sub / "index.md"
768
+ if index_file.is_file():
769
+ # Flat spec dir (single-repo layer like spec/backend/)
770
+ paths.append(f".rudder/spec/{sub.name}/index.md")
771
+ else:
772
+ # Nested package dirs (monorepo: spec/<pkg>/<layer>/index.md)
773
+ # Apply scope filter
774
+ if allowed_pkgs is not None and sub.name not in allowed_pkgs:
775
+ continue
776
+ for nested in sorted(sub.iterdir()):
777
+ if not nested.is_dir():
778
+ continue
779
+ nested_index = nested / "index.md"
780
+ if nested_index.is_file():
781
+ paths.append(
782
+ f".rudder/spec/{sub.name}/{nested.name}/index.md"
783
+ )
784
+
785
+ if paths:
786
+ output.write("## Available spec indexes (read on demand)\n")
787
+ for p in paths:
788
+ output.write(f"- {p}\n")
789
+ output.write("\n")
790
+
791
+ output.write(
792
+ "Discover more via: "
793
+ "`python3 ./.rudder/scripts/get_context.py --mode packages`\n"
794
+ )
795
+ output.write("</guidelines>\n\n")
796
+
797
+ # Tool paths block
798
+ tool_paths_block = _build_tool_paths_block(rudder_dir)
799
+ if tool_paths_block:
800
+ output.write(tool_paths_block)
801
+ output.write("\n\n")
802
+
803
+ # Check task status and inject structured tag
804
+ task_status = _get_task_status(rudder_dir, hook_input)
805
+ output.write(f"<task-status>\n{task_status}\n</task-status>\n\n")
806
+
807
+ output.write("""<ready>
808
+ Context loaded. Workflow index, project state, and guidelines are already injected above — do NOT re-read them.
809
+ When the user sends the first message, follow <task-status> and the workflow guide.
810
+ If a task is READY, execute its Next required action without asking whether to continue.
811
+ </ready>""")
812
+
813
+ context_text = output.getvalue()
814
+ result = {
815
+ "hookSpecificOutput": {
816
+ "hookEventName": "SessionStart",
817
+ "additionalContext": context_text,
818
+ },
819
+ "additional_context": context_text,
820
+ }
821
+
822
+ # Output JSON - stdout is already configured for UTF-8
823
+ print(json.dumps(result, ensure_ascii=False), flush=True)
824
+
825
+
826
+ if __name__ == "__main__":
827
+ main()