@mengde1231/rudder 0.5.13

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