@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,396 @@
1
+ #!/usr/bin/env python3
2
+ """Rudder per-turn breadcrumb hook (UserPromptSubmit / BeforeAgent equivalent).
3
+
4
+ Runs on every user prompt. Resolves the active task through Rudder'
5
+ session-aware active task resolver and emits a short <workflow-state>
6
+ block reminding the main AI what task is active and its expected flow.
7
+
8
+ The emitted ``hookEventName`` field is platform-aware: most hosts expect
9
+ ``UserPromptSubmit`` (Claude Code naming, also accepted by Cursor / Qoder /
10
+ CodeBuddy / Droid / Codex / Copilot wiring), but Gemini CLI 0.40.x renamed
11
+ its per-turn event to ``BeforeAgent`` and its schema validator rejects the
12
+ legacy name. ``_detect_platform`` picks the right value at runtime.
13
+ Breadcrumb text is pulled exclusively from workflow.md
14
+ [workflow-state:STATUS] tag blocks — workflow.md is the single source of
15
+ truth. There are no fallback dicts in this script: when workflow.md is
16
+ missing or a tag is absent, the breadcrumb degrades to a generic
17
+ "Refer to workflow.md for current step." line so users see (and fix)
18
+ the broken state instead of the hook silently masking it.
19
+
20
+ Shared across all hook-capable platforms (Claude, Cursor, Codex, Qoder,
21
+ CodeBuddy, Droid, Gemini, Copilot). Kiro is not wired (no per-turn
22
+ hook entry point). Written to each platform's hooks directory via
23
+ writeSharedHooks() at init time.
24
+
25
+ Silent exit 0 cases (no output):
26
+ - No .rudder/ directory found (not a Rudder project)
27
+ - task.json malformed or missing status
28
+ """
29
+ from __future__ import annotations
30
+
31
+ import json
32
+ import os
33
+ import re
34
+ import sys
35
+ from pathlib import Path
36
+ from typing import Optional
37
+
38
+
39
+ CODEX_SUB_AGENT_NOTICE = """<sub-agent-notice>
40
+ SUB-AGENT NOTICE - READ FIRST IF SPAWNED VIA spawn_agent
41
+
42
+ If your parent session spawned you via spawn_agent with an explicit task
43
+ message above this hook output, that message is your only job.
44
+ - Execute the parent message exactly as written, then return.
45
+ - Ignore all Rudder workflow guidance below this notice.
46
+ - Do NOT call task.py start, task.py add-context, or task.py archive.
47
+ - Do NOT call wait_agent or spawn_agent.
48
+ - Do NOT modify .rudder/tasks/* or any other file unless the parent message
49
+ explicitly asks for that.
50
+
51
+ If you are the main interactive Codex session and the user is typing at the
52
+ terminal with no parent agent, use the workflow guidance below normally.
53
+ </sub-agent-notice>"""
54
+
55
+
56
+ # Bootstrap notice for Codex while the session has no active task. Replaces the
57
+ # heavyweight SessionStart context injection — instead of pushing 9.5 KB of
58
+ # workflow text up front, we just nudge the AI to read the `rudder-start` skill once.
59
+ # The nudge keeps showing up while status == "no_task" (cheap text, AI won't
60
+ # re-read after the first time). Once a task is created the breadcrumb status
61
+ # flips and this notice stops appearing automatically. Sub-agents are warded
62
+ # off by the <sub-agent-notice> above plus the explicit exemption below.
63
+ CODEX_NO_TASK_BOOTSTRAP_NOTICE = """<rudder-bootstrap>
64
+ You are running in a Rudder-managed Codex session and there is no active task yet.
65
+ If you have not already loaded Rudder context this session, read the `rudder-start` skill once:
66
+
67
+ $rudder-start
68
+
69
+ (equivalent to reading `.agents/skills/rudder-start/SKILL.md` and following its Steps 1-3)
70
+
71
+ The skill walks you through workflow.md, dev profile, git status, active tasks, and spec
72
+ indexes. Then route the user's request per the <workflow-state> A/B/C rules below.
73
+
74
+ Sub-agent exemption: if you are a sub-agent (spawned via spawn_agent with a parent task
75
+ message), DO NOT read `$rudder-start`. Execute the parent message directly as instructed by the
76
+ <sub-agent-notice> above.
77
+ </rudder-bootstrap>"""
78
+
79
+
80
+ # ---------------------------------------------------------------------------
81
+ # CWD-robust Rudder root discovery (fixes hook-path-robustness for this hook)
82
+ # ---------------------------------------------------------------------------
83
+
84
+ def find_rudder_root(start: Path) -> Optional[Path]:
85
+ """Walk up from start to find directory containing .rudder/.
86
+
87
+ Handles CWD drift: subdirectory launches, monorepo packages, etc.
88
+ Returns None if no .rudder/ found (silent no-op).
89
+ """
90
+ cur = start.resolve()
91
+ while cur != cur.parent:
92
+ if (cur / ".rudder").is_dir():
93
+ return cur
94
+ cur = cur.parent
95
+ return None
96
+
97
+
98
+ # ---------------------------------------------------------------------------
99
+ # Active task discovery
100
+ # ---------------------------------------------------------------------------
101
+
102
+ def _detect_platform(input_data: dict) -> str | None:
103
+ if isinstance(input_data.get("cursor_version"), str):
104
+ return "cursor"
105
+ env_map = {
106
+ "CLAUDE_PROJECT_DIR": "claude",
107
+ "CURSOR_PROJECT_DIR": "cursor",
108
+ "CODEBUDDY_PROJECT_DIR": "codebuddy",
109
+ "FACTORY_PROJECT_DIR": "droid",
110
+ "GEMINI_PROJECT_DIR": "gemini",
111
+ "QODER_PROJECT_DIR": "qoder",
112
+ "KIRO_PROJECT_DIR": "kiro",
113
+ "COPILOT_PROJECT_DIR": "copilot",
114
+ }
115
+ for env_name, platform in env_map.items():
116
+ if os.environ.get(env_name):
117
+ return platform
118
+ script_parts = set(Path(sys.argv[0]).parts)
119
+ if ".claude" in script_parts:
120
+ return "claude"
121
+ if ".cursor" in script_parts:
122
+ return "cursor"
123
+ if ".codex" in script_parts:
124
+ return "codex"
125
+ if ".gemini" in script_parts:
126
+ return "gemini"
127
+ if ".qoder" in script_parts:
128
+ return "qoder"
129
+ if ".codebuddy" in script_parts:
130
+ return "codebuddy"
131
+ if ".factory" in script_parts:
132
+ return "droid"
133
+ if ".kiro" in script_parts:
134
+ return "kiro"
135
+ return None
136
+
137
+
138
+ def _resolve_active_task(root: Path, input_data: dict):
139
+ scripts_dir = root / ".rudder" / "scripts"
140
+ if str(scripts_dir) not in sys.path:
141
+ sys.path.insert(0, str(scripts_dir))
142
+ from common.active_task import resolve_active_task # type: ignore[import-not-found]
143
+
144
+ return resolve_active_task(root, input_data, platform=_detect_platform(input_data))
145
+
146
+
147
+ def get_active_task(root: Path, input_data: dict) -> Optional[tuple[str, str, str]]:
148
+ """Return (task_id, status, source) from the current active task."""
149
+ active = _resolve_active_task(root, input_data)
150
+ if not active.task_path:
151
+ return None
152
+
153
+ task_dir = Path(active.task_path)
154
+ if not task_dir.is_absolute():
155
+ task_dir = root / task_dir
156
+ if active.stale:
157
+ return task_dir.name, f"stale_{active.source_type}", active.source
158
+
159
+ task_json = task_dir / "task.json"
160
+ if not task_json.is_file():
161
+ return None
162
+ try:
163
+ data = json.loads(task_json.read_text(encoding="utf-8"))
164
+ except (json.JSONDecodeError, OSError):
165
+ return None
166
+
167
+ task_id = data.get("id") or task_dir.name
168
+ status = data.get("status", "")
169
+ if not isinstance(status, str) or not status:
170
+ return None
171
+ return task_id, status, active.source
172
+
173
+
174
+ # ---------------------------------------------------------------------------
175
+ # Breadcrumb loading: parse workflow.md, fall back to hardcoded defaults
176
+ # ---------------------------------------------------------------------------
177
+
178
+ # Supports STATUS values with letters, digits, underscores, hyphens
179
+ # (so "in-review" / "blocked-by-team" work alongside "in_progress").
180
+ _TAG_RE = re.compile(
181
+ r"\[workflow-state:([A-Za-z0-9_-]+)\]\s*\n(.*?)\n\s*\[/workflow-state:\1\]",
182
+ re.DOTALL,
183
+ )
184
+
185
+ def load_breadcrumbs(root: Path) -> dict[str, str]:
186
+ """Parse workflow.md for [workflow-state:STATUS] blocks.
187
+
188
+ Returns {status: body_text}. workflow.md is the single source of
189
+ truth — there are no fallback dicts in this script. Missing tags
190
+ (or a missing/unreadable workflow.md) fall back to a generic line
191
+ in build_breadcrumb so users see the broken state and fix
192
+ workflow.md, rather than the hook silently masking the issue.
193
+ """
194
+ workflow = root / ".rudder" / "workflow.md"
195
+ if not workflow.is_file():
196
+ return {}
197
+ try:
198
+ content = workflow.read_text(encoding="utf-8")
199
+ except OSError:
200
+ return {}
201
+
202
+ result: dict[str, str] = {}
203
+ for match in _TAG_RE.finditer(content):
204
+ status = match.group(1)
205
+ body = match.group(2).strip()
206
+ if body:
207
+ result[status] = body
208
+ return result
209
+
210
+
211
+ def _read_rudder_config(root: Path) -> dict:
212
+ """Load .rudder/config.yaml via the bundled rudder_config helper.
213
+
214
+ The helper lives in .rudder/scripts/common; the hook lives outside the
215
+ scripts tree, so we extend sys.path before importing.
216
+ """
217
+ scripts_dir = root / ".rudder" / "scripts"
218
+ if str(scripts_dir) not in sys.path:
219
+ sys.path.insert(0, str(scripts_dir))
220
+ try:
221
+ from common.rudder_config import read_rudder_config # type: ignore[import-not-found]
222
+ except Exception:
223
+ return {}
224
+ try:
225
+ return read_rudder_config(root)
226
+ except Exception:
227
+ return {}
228
+
229
+
230
+ def _build_tool_paths_block(root: Path) -> str:
231
+ """Build <tool-paths> block for per-turn breadcrumb."""
232
+ try:
233
+ scripts_dir = root / ".rudder" / "scripts"
234
+ if str(scripts_dir) not in sys.path:
235
+ sys.path.insert(0, str(scripts_dir))
236
+ from common.rudder_config import resolve_tools # type: ignore[import-not-found]
237
+ tools = resolve_tools(root)
238
+ except Exception:
239
+ return ""
240
+
241
+ if not tools:
242
+ return ""
243
+
244
+ lines = ["<tool-paths>", "Tool paths:"]
245
+ for name, info in sorted(tools.items()):
246
+ path = info.get("path", name)
247
+ parts = [path]
248
+ version = info.get("version")
249
+ if version:
250
+ parts.append(f"(required: {version})")
251
+ lines.append(f"- {name}: {' '.join(parts)}")
252
+ lines.append("</tool-paths>")
253
+ return "\n".join(lines)
254
+
255
+
256
+ def _codex_mode_banner(config: dict) -> str:
257
+ """Emit a `<codex-mode>` banner for the additionalContext payload.
258
+
259
+ Reads `codex.dispatch_mode` from .rudder/config.yaml; defaults to
260
+ `inline` when missing or invalid because Codex sub-agents run with
261
+ `fork_turns="none"` isolation and can't inherit the parent session's
262
+ task context. The banner makes the active mode explicit to Codex AI
263
+ per turn, complementing the workflow-state body which is per-status.
264
+ Mode tells AI which dispatch protocol to follow; workflow-state tells
265
+ AI what step it's at.
266
+ """
267
+ mode = "inline"
268
+ if isinstance(config, dict):
269
+ codex_cfg = config.get("codex")
270
+ if isinstance(codex_cfg, dict):
271
+ cfg_mode = codex_cfg.get("dispatch_mode")
272
+ if cfg_mode in ("inline", "sub-agent"):
273
+ mode = cfg_mode
274
+ return f"<codex-mode>{mode}</codex-mode>"
275
+
276
+
277
+ def resolve_breadcrumb_key(
278
+ status: str, platform: str | None, config: dict
279
+ ) -> str:
280
+ """Pick the breadcrumb tag key based on Codex dispatch_mode.
281
+
282
+ Codex defaults to ``inline`` because sub-agents run with ``fork_turns="none"``
283
+ isolation and can't inherit the parent session's task context. Users can
284
+ opt into ``codex.dispatch_mode: sub-agent`` in ``.rudder/config.yaml``
285
+ to use the parallel ``<status>-inline`` tag → ``<status>`` flip. Invalid
286
+ or missing values fall back to inline.
287
+
288
+ Non-codex platforms return the plain status unchanged.
289
+ """
290
+ if platform == "codex":
291
+ mode = "inline"
292
+ if isinstance(config, dict):
293
+ codex_cfg = config.get("codex")
294
+ if isinstance(codex_cfg, dict):
295
+ cfg_mode = codex_cfg.get("dispatch_mode")
296
+ if cfg_mode in ("inline", "sub-agent"):
297
+ mode = cfg_mode
298
+ return f"{status}-inline" if mode == "inline" else status
299
+ return status
300
+
301
+
302
+ def build_breadcrumb(
303
+ task_id: Optional[str],
304
+ status: str,
305
+ templates: dict[str, str],
306
+ source: str | None = None,
307
+ breadcrumb_key: str | None = None,
308
+ ) -> str:
309
+ """Build the <workflow-state>...</workflow-state> block.
310
+
311
+ - Known status (tag present in workflow.md) → detailed template body
312
+ - Unknown status (no tag, or workflow.md missing) → generic
313
+ "Refer to workflow.md for current step." line
314
+ - `no_task` pseudo-status (task_id is None) → header omits task info
315
+ """
316
+ lookup_key = breadcrumb_key or status
317
+ body = templates.get(lookup_key)
318
+ if body is None and lookup_key != status:
319
+ body = templates.get(status)
320
+ if body is None:
321
+ body = "Refer to workflow.md for current step."
322
+ header = f"Status: {status}" if task_id is None else f"Task: {task_id} ({status})"
323
+ if source:
324
+ header = f"{header}\nSource: {source}"
325
+ return f"<workflow-state>\n{header}\n{body}\n</workflow-state>"
326
+
327
+
328
+ # ---------------------------------------------------------------------------
329
+ # Entry
330
+ # ---------------------------------------------------------------------------
331
+
332
+ def main() -> int:
333
+ if os.environ.get("RUDDER_HOOKS") == "0" or os.environ.get("RUDDER_DISABLE_HOOKS") == "1":
334
+ return 0
335
+
336
+ try:
337
+ data = json.load(sys.stdin)
338
+ except (json.JSONDecodeError, ValueError):
339
+ data = {}
340
+
341
+ cwd_str = data.get("cwd") or os.getcwd()
342
+ cwd = Path(cwd_str)
343
+
344
+ root = find_rudder_root(cwd)
345
+ if root is None:
346
+ return 0 # not a Rudder project
347
+
348
+ templates = load_breadcrumbs(root)
349
+ platform = _detect_platform(data)
350
+ config = _read_rudder_config(root)
351
+ task = get_active_task(root, data)
352
+ if task is None:
353
+ # No active task — still emit a breadcrumb nudging AI toward
354
+ # rudder-brainstorm + task.py create when user describes real work.
355
+ no_task_key = resolve_breadcrumb_key("no_task", platform, config)
356
+ breadcrumb = build_breadcrumb(
357
+ None, "no_task", templates, breadcrumb_key=no_task_key
358
+ )
359
+ else:
360
+ task_id, status, source = task
361
+ status_key = resolve_breadcrumb_key(status, platform, config)
362
+ breadcrumb = build_breadcrumb(
363
+ task_id, status, templates, source, breadcrumb_key=status_key
364
+ )
365
+ if platform == "codex":
366
+ parts: list[str] = [CODEX_SUB_AGENT_NOTICE]
367
+ if task is None:
368
+ parts.append(CODEX_NO_TASK_BOOTSTRAP_NOTICE)
369
+ parts.append(_codex_mode_banner(config))
370
+ parts.append(breadcrumb)
371
+ breadcrumb = "\n\n".join(parts)
372
+
373
+ # Gemini CLI 0.40.x rejects "UserPromptSubmit" — its per-turn event is
374
+ # named "BeforeAgent". Other platforms (Claude/Cursor/Qoder/CodeBuddy/
375
+ # Droid/Codex/Copilot) accept the original Claude-style name.
376
+ hook_event_name = (
377
+ "BeforeAgent" if platform == "gemini" else "UserPromptSubmit"
378
+ )
379
+
380
+ # Append tool paths to the breadcrumb for all platforms
381
+ tool_paths = _build_tool_paths_block(root)
382
+ if tool_paths:
383
+ breadcrumb = f"{breadcrumb}\n\n{tool_paths}"
384
+
385
+ output = {
386
+ "hookSpecificOutput": {
387
+ "hookEventName": hook_event_name,
388
+ "additionalContext": breadcrumb,
389
+ }
390
+ }
391
+ print(json.dumps(output))
392
+ return 0
393
+
394
+
395
+ if __name__ == "__main__":
396
+ sys.exit(main())