@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,459 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ Codex Session Start Hook - Inject Rudder context into Codex sessions.
5
+
6
+ Output format follows Codex hook protocol:
7
+ stdout JSON → { hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: "..." } }
8
+ """
9
+
10
+ from __future__ import annotations
11
+
12
+ import json
13
+ import os
14
+ import re
15
+ import subprocess
16
+ import sys
17
+ import warnings
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
+ warnings.filterwarnings("ignore")
71
+
72
+ FIRST_REPLY_NOTICE = """<first-reply-notice>
73
+ On the first visible assistant reply in this session, begin with exactly one short Chinese sentence:
74
+ Rudder SessionStart 已注入:workflow、当前任务状态、开发者身份、git 状态、active tasks、spec 索引已加载。
75
+ 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.
76
+ </first-reply-notice>"""
77
+
78
+ SUB_AGENT_NOTICE = """<sub-agent-notice>
79
+ SUB-AGENT NOTICE - READ FIRST IF SPAWNED VIA spawn_agent
80
+
81
+ If your parent session spawned you via spawn_agent with an explicit task
82
+ message above this hook output, that message is your only job.
83
+ - Execute the parent message exactly as written, then return.
84
+ - Ignore all Rudder workflow guidance below this notice.
85
+ - Do NOT call task.py start, task.py add-context, or task.py archive.
86
+ - Do NOT call wait_agent or spawn_agent.
87
+ - Do NOT modify .rudder/tasks/* or any other file unless the parent message
88
+ explicitly asks for that.
89
+
90
+ If you are the main interactive Codex session and the user is typing at the
91
+ terminal with no parent agent, use the workflow guidance below normally.
92
+ </sub-agent-notice>"""
93
+
94
+
95
+ def should_skip_injection() -> bool:
96
+ if os.environ.get("RUDDER_HOOKS") == "0":
97
+ return True
98
+ if os.environ.get("RUDDER_DISABLE_HOOKS") == "1":
99
+ return True
100
+ return os.environ.get("CODEX_NON_INTERACTIVE") == "1"
101
+
102
+
103
+ def configure_project_encoding(project_dir: Path) -> None:
104
+ """Reuse Rudder' shared Windows stdio encoding helper before JSON output."""
105
+ scripts_dir = project_dir / ".rudder" / "scripts"
106
+ if str(scripts_dir) not in sys.path:
107
+ sys.path.insert(0, str(scripts_dir))
108
+
109
+ try:
110
+ from common import configure_encoding # type: ignore[import-not-found]
111
+
112
+ configure_encoding()
113
+ except Exception:
114
+ pass
115
+
116
+
117
+ def _has_curated_jsonl_entry(jsonl_path: Path) -> bool:
118
+ """Return True iff jsonl has at least one row with a ``file`` field.
119
+
120
+ A freshly seeded jsonl only contains a ``{"_example": ...}`` row (no
121
+ ``file`` key) — that is NOT "ready". Readiness requires at least one
122
+ curated entry. Matches the contract used by ``inject-subagent-context.py``.
123
+ """
124
+ try:
125
+ for line in jsonl_path.read_text(encoding="utf-8").splitlines():
126
+ line = line.strip()
127
+ if not line:
128
+ continue
129
+ try:
130
+ row = json.loads(line)
131
+ except json.JSONDecodeError:
132
+ continue
133
+ if isinstance(row, dict) and row.get("file"):
134
+ return True
135
+ except (OSError, UnicodeDecodeError):
136
+ return False
137
+ return False
138
+
139
+
140
+ def read_file(path: Path, fallback: str = "") -> str:
141
+ try:
142
+ return path.read_text(encoding="utf-8")
143
+ except (FileNotFoundError, PermissionError):
144
+ return fallback
145
+
146
+
147
+ def _resolve_context_key(project_dir: Path, hook_input: dict) -> str | None:
148
+ scripts_dir = project_dir / ".rudder" / "scripts"
149
+ if str(scripts_dir) not in sys.path:
150
+ sys.path.insert(0, str(scripts_dir))
151
+ try:
152
+ from common.active_task import resolve_context_key # type: ignore[import-not-found]
153
+ except Exception:
154
+ return None
155
+ return resolve_context_key(hook_input, platform="codex")
156
+
157
+
158
+ def _resolve_active_task(rudder_dir: Path, hook_input: dict):
159
+ scripts_dir = rudder_dir / "scripts"
160
+ if str(scripts_dir) not in sys.path:
161
+ sys.path.insert(0, str(scripts_dir))
162
+ from common.active_task import resolve_active_task # type: ignore[import-not-found]
163
+
164
+ return resolve_active_task(rudder_dir.parent, hook_input, platform="codex")
165
+
166
+
167
+ def run_script(script_path: Path, context_key: str | None = None) -> str:
168
+ try:
169
+ env = os.environ.copy()
170
+ env["PYTHONIOENCODING"] = "utf-8"
171
+ if context_key:
172
+ env["RUDDER_CONTEXT_ID"] = context_key
173
+ cmd = [sys.executable, "-W", "ignore", str(script_path)]
174
+ result = subprocess.run(
175
+ cmd,
176
+ capture_output=True,
177
+ text=True,
178
+ encoding="utf-8",
179
+ errors="replace",
180
+ timeout=5,
181
+ cwd=str(script_path.parent.parent.parent),
182
+ env=env,
183
+ )
184
+ return result.stdout if result.returncode == 0 else "No context available"
185
+ except (subprocess.TimeoutExpired, FileNotFoundError, PermissionError):
186
+ return "No context available"
187
+
188
+
189
+ def _normalize_task_ref(task_ref: str) -> str:
190
+ normalized = task_ref.strip()
191
+ if not normalized:
192
+ return ""
193
+
194
+ path_obj = Path(normalized)
195
+ if path_obj.is_absolute():
196
+ return str(path_obj)
197
+
198
+ normalized = normalized.replace("\\", "/")
199
+ while normalized.startswith("./"):
200
+ normalized = normalized[2:]
201
+
202
+ if normalized.startswith("tasks/"):
203
+ return f".rudder/{normalized}"
204
+
205
+ return normalized
206
+
207
+
208
+ def _resolve_task_dir(rudder_dir: Path, task_ref: str) -> Path:
209
+ normalized = _normalize_task_ref(task_ref)
210
+ path_obj = Path(normalized)
211
+ if path_obj.is_absolute():
212
+ return path_obj
213
+ if normalized.startswith(".rudder/"):
214
+ return rudder_dir.parent / path_obj
215
+ return rudder_dir / "tasks" / path_obj
216
+
217
+
218
+ def _get_task_status(rudder_dir: Path, hook_input: dict) -> str:
219
+ active = _resolve_active_task(rudder_dir, hook_input)
220
+ if not active.task_path:
221
+ return f"Status: NO ACTIVE TASK\nSource: {active.source}\nNext: Describe what you want to work on"
222
+
223
+ task_ref = active.task_path
224
+ task_dir = _resolve_task_dir(rudder_dir, task_ref)
225
+ if active.stale or not task_dir.is_dir():
226
+ return f"Status: STALE POINTER\nTask: {task_ref}\nSource: {active.source}\nNext: Task directory not found. Run: python3 ./.rudder/scripts/task.py finish"
227
+
228
+ task_json_path = task_dir / "task.json"
229
+ task_data: dict = {}
230
+ if task_json_path.is_file():
231
+ try:
232
+ task_data = json.loads(task_json_path.read_text(encoding="utf-8"))
233
+ except (json.JSONDecodeError, PermissionError):
234
+ pass
235
+
236
+ task_title = task_data.get("title", task_ref)
237
+ task_status = task_data.get("status", "unknown")
238
+
239
+ if task_status == "completed":
240
+ return f"Status: COMPLETED\nTask: {task_title}\nSource: {active.source}\nNext: Archive with `python3 ./.rudder/scripts/task.py archive {task_dir.name}` or start a new task"
241
+
242
+ has_context = False
243
+ for jsonl_name in ("implement.jsonl", "check.jsonl", "spec.jsonl"):
244
+ jsonl_path = task_dir / jsonl_name
245
+ if jsonl_path.is_file() and _has_curated_jsonl_entry(jsonl_path):
246
+ has_context = True
247
+ break
248
+
249
+ has_prd = (task_dir / "prd.md").is_file()
250
+
251
+ if not has_prd:
252
+ return f"Status: NOT READY\nTask: {task_title}\nSource: {active.source}\nMissing: prd.md not created\nNext: Write PRD (see workflow.md Phase 1.1) then curate implement.jsonl per Phase 1.3"
253
+
254
+ if not has_context:
255
+ return f"Status: NOT READY\nTask: {task_title}\nSource: {active.source}\nMissing: implement.jsonl / check.jsonl missing or empty\nNext: Curate entries per workflow.md Phase 1.3 (spec + research files only), then `task.py start`"
256
+
257
+ return (
258
+ f"Status: READY\nTask: {task_title}\n"
259
+ f"Source: {active.source}\n"
260
+ "Next required action: dispatch `rudder-implement` per Phase 2.1. "
261
+ "For agent-capable platforms, the default is to NOT edit code in the main session. "
262
+ "After implementation, dispatch `rudder-check` per Phase 2.2 before reporting completion.\n"
263
+ "Sub-agent self-exemption: if you are reading this as a `rudder-implement` or "
264
+ "`rudder-check` sub-agent (your own role / agent name reflects that), this dispatch "
265
+ "instruction does NOT apply to you — you are already the dispatched sub-agent. "
266
+ "Implement / check directly without spawning another sub-agent of the same kind.\n"
267
+ "User override (per-turn escape hatch): if the user's CURRENT message explicitly tells the "
268
+ "main session to handle it directly (\"你直接改\" / \"别派 sub-agent\" / \"main session 写就行\" / "
269
+ "\"do it inline\" / \"不用 sub-agent\"), honor it for this turn and edit code directly. "
270
+ "Per-turn only; do NOT invent an override the user did not say."
271
+ )
272
+
273
+
274
+ def _extract_range(content: str, start_header: str, end_header: str) -> str:
275
+ """Extract lines starting at `## start_header` up to (but excluding) `## end_header`."""
276
+ lines = content.splitlines()
277
+ start: "int | None" = None
278
+ end: int = len(lines)
279
+ start_match = f"## {start_header}"
280
+ end_match = f"## {end_header}"
281
+ for i, line in enumerate(lines):
282
+ stripped = line.strip()
283
+ if start is None and stripped == start_match:
284
+ start = i
285
+ continue
286
+ if start is not None and stripped == end_match:
287
+ end = i
288
+ break
289
+ if start is None:
290
+ return ""
291
+ return "\n".join(lines[start:end]).rstrip()
292
+
293
+
294
+ _BREADCRUMB_TAG_RE = re.compile(
295
+ r"\[workflow-state:([A-Za-z0-9_-]+)\]\s*\n.*?\n\s*\[/workflow-state:\1\]",
296
+ re.DOTALL,
297
+ )
298
+
299
+
300
+ def _strip_breadcrumb_tag_blocks(content: str) -> str:
301
+ return _BREADCRUMB_TAG_RE.sub("", content)
302
+
303
+
304
+ def _build_workflow_toc(workflow_path: Path) -> str:
305
+ """Inject workflow guide: TOC + Phase Index + Phase 1/2/3 step details.
306
+
307
+ Since v0.5.0-rc.0 the [workflow-state:STATUS] breadcrumb tag blocks
308
+ live inside ## Phase Index. They're consumed by inject-workflow-state.py
309
+ on each UserPromptSubmit, so strip them from the session-start payload
310
+ to avoid duplicating context.
311
+ """
312
+ content = read_file(workflow_path)
313
+ if not content:
314
+ return "No workflow.md found"
315
+
316
+ out_lines = [
317
+ "# Development Workflow — Section Index",
318
+ "Full guide: .rudder/workflow.md (read on demand)",
319
+ "",
320
+ "## Table of Contents",
321
+ ]
322
+ for line in content.splitlines():
323
+ if line.startswith("## "):
324
+ out_lines.append(line)
325
+ out_lines += ["", "---", ""]
326
+
327
+ phases = _extract_range(content, "Phase Index", "Customizing Rudder (for forks)")
328
+ if phases:
329
+ out_lines.append(_strip_breadcrumb_tag_blocks(phases).rstrip())
330
+
331
+ return "\n".join(out_lines).rstrip()
332
+
333
+
334
+ def main() -> None:
335
+ if should_skip_injection():
336
+ sys.exit(0)
337
+
338
+ # Read hook input from stdin
339
+ try:
340
+ hook_input = json.loads(sys.stdin.read())
341
+ if not isinstance(hook_input, dict):
342
+ hook_input = {}
343
+ project_dir = Path(_normalize_windows_shell_path(hook_input.get("cwd", "."))).resolve()
344
+ except (json.JSONDecodeError, KeyError):
345
+ hook_input = {}
346
+ project_dir = Path(".").resolve()
347
+
348
+ configure_project_encoding(project_dir)
349
+
350
+ rudder_dir = project_dir / ".rudder"
351
+ context_key = _resolve_context_key(project_dir, hook_input)
352
+
353
+ output = StringIO()
354
+
355
+ output.write(SUB_AGENT_NOTICE)
356
+ output.write("\n\n")
357
+
358
+ output.write("""<session-context>
359
+ You are starting a new session in a Rudder-managed project.
360
+ Read and follow all instructions below carefully.
361
+ </session-context>
362
+
363
+ """)
364
+ output.write(FIRST_REPLY_NOTICE)
365
+ output.write("\n\n")
366
+
367
+ output.write("<current-state>\n")
368
+ context_script = rudder_dir / "scripts" / "get_context.py"
369
+ output.write(run_script(context_script, context_key))
370
+ output.write("\n</current-state>\n\n")
371
+
372
+ output.write("<workflow>\n")
373
+ output.write(_build_workflow_toc(rudder_dir / "workflow.md"))
374
+ output.write("\n</workflow>\n\n")
375
+
376
+ output.write("<guidelines>\n")
377
+ output.write(
378
+ "Project spec indexes are listed by path below. Each index contains a "
379
+ "**Pre-Development Checklist** listing the specific guideline files to "
380
+ "read before coding.\n\n"
381
+ "- If you're spawning an implement/check sub-agent, context is injected "
382
+ "automatically via `{task}/implement.jsonl` / `check.jsonl`. You do NOT "
383
+ "need to read these indexes yourself.\n"
384
+ "- For agent-capable platforms, the default is to dispatch "
385
+ "`rudder-implement` and `rudder-check` (so JSONL context is loaded by "
386
+ "the sub-agents) rather than editing code in the main session. "
387
+ "Honor a per-turn user override only if the user's current message "
388
+ "explicitly opts out (see <task-status> below for override phrases).\n"
389
+ "- Sub-agent self-exemption: if you are reading this as a `rudder-implement` "
390
+ "or `rudder-check` sub-agent, the \"dispatch rudder-implement / rudder-check\" "
391
+ "rule above does NOT apply to you — you are already the dispatched sub-agent. "
392
+ "Do NOT spawn another sub-agent of the same kind; implement / check directly.\n\n"
393
+ )
394
+
395
+ # guides/ inlined (cross-package thinking, broadly useful)
396
+ guides_index = rudder_dir / "spec" / "guides" / "index.md"
397
+ if guides_index.is_file():
398
+ output.write("## guides (inlined — cross-package thinking guides)\n")
399
+ output.write(read_file(guides_index))
400
+ output.write("\n\n")
401
+
402
+ # Other indexes — paths only
403
+ paths: list[str] = []
404
+ spec_dir = rudder_dir / "spec"
405
+ if spec_dir.is_dir():
406
+ for sub in sorted(spec_dir.iterdir()):
407
+ if not sub.is_dir() or sub.name.startswith("."):
408
+ continue
409
+ if sub.name == "guides":
410
+ continue
411
+ index_file = sub / "index.md"
412
+ if index_file.is_file():
413
+ paths.append(f".rudder/spec/{sub.name}/index.md")
414
+ else:
415
+ for nested in sorted(sub.iterdir()):
416
+ if not nested.is_dir():
417
+ continue
418
+ nested_index = nested / "index.md"
419
+ if nested_index.is_file():
420
+ paths.append(
421
+ f".rudder/spec/{sub.name}/{nested.name}/index.md"
422
+ )
423
+
424
+ if paths:
425
+ output.write("## Available spec indexes (read on demand)\n")
426
+ for p in paths:
427
+ output.write(f"- {p}\n")
428
+ output.write("\n")
429
+
430
+ output.write(
431
+ "Discover more via: "
432
+ "`python3 ./.rudder/scripts/get_context.py --mode packages`\n"
433
+ )
434
+ output.write("</guidelines>\n\n")
435
+
436
+ task_status = _get_task_status(rudder_dir, hook_input)
437
+ output.write(f"<task-status>\n{task_status}\n</task-status>\n\n")
438
+
439
+ output.write("""<ready>
440
+ Context loaded. Workflow index, project state, and guidelines are already injected above — do NOT re-read them.
441
+ When the user sends the first message, follow <task-status> and the workflow guide.
442
+ If a task is READY, execute its Next required action without asking whether to continue.
443
+ </ready>""")
444
+
445
+ context = output.getvalue()
446
+ result = {
447
+ "suppressOutput": True,
448
+ "systemMessage": f"Rudder context injected ({len(context)} chars)",
449
+ "hookSpecificOutput": {
450
+ "hookEventName": "SessionStart",
451
+ "additionalContext": context,
452
+ },
453
+ }
454
+
455
+ print(json.dumps(result, ensure_ascii=False), flush=True)
456
+
457
+
458
+ if __name__ == "__main__":
459
+ main()
@@ -0,0 +1,15 @@
1
+ {
2
+ "hooks": {
3
+ "UserPromptSubmit": [
4
+ {
5
+ "hooks": [
6
+ {
7
+ "type": "command",
8
+ "command": "{{PYTHON_CMD}} .codex/hooks/inject-workflow-state.py",
9
+ "timeout": 15
10
+ }
11
+ ]
12
+ }
13
+ ]
14
+ }
15
+ }
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Codex templates
3
+ *
4
+ * These are GENERIC templates for user projects.
5
+ * Do NOT use Rudder project's own .agents/skills or .codex directories
6
+ * (which may be customized).
7
+ *
8
+ * Directory structure:
9
+ * codex/
10
+ * ├── agents/ # Project-scoped Codex custom agents (.toml)
11
+ * ├── codex-skills/ # Codex-specific skills → .codex/skills/
12
+ * ├── skills/ # Shared skills → .agents/skills/
13
+ * └── config.toml # Project-scoped Codex config
14
+ */
15
+ export interface SkillTemplate {
16
+ name: string;
17
+ content: string;
18
+ }
19
+ export interface AgentTemplate {
20
+ name: string;
21
+ content: string;
22
+ }
23
+ export interface ConfigTemplate {
24
+ targetPath: string;
25
+ content: string;
26
+ }
27
+ export declare function getAllAgents(): AgentTemplate[];
28
+ /**
29
+ * Get Codex-specific skills (installed to .codex/skills/, not shared .agents/skills/).
30
+ */
31
+ export declare function getAllCodexSkills(): SkillTemplate[];
32
+ export interface HookTemplate {
33
+ name: string;
34
+ content: string;
35
+ }
36
+ export declare function getAllHooks(): HookTemplate[];
37
+ export declare function getHooksConfig(): string;
38
+ export declare function getConfigTemplate(): ConfigTemplate;
39
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgCH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAc9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,EAAE,CASnD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAW5C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}
@@ -0,0 +1,85 @@
1
+ /**
2
+ * Codex templates
3
+ *
4
+ * These are GENERIC templates for user projects.
5
+ * Do NOT use Rudder project's own .agents/skills or .codex directories
6
+ * (which may be customized).
7
+ *
8
+ * Directory structure:
9
+ * codex/
10
+ * ├── agents/ # Project-scoped Codex custom agents (.toml)
11
+ * ├── codex-skills/ # Codex-specific skills → .codex/skills/
12
+ * ├── skills/ # Shared skills → .agents/skills/
13
+ * └── config.toml # Project-scoped Codex config
14
+ */
15
+ import { readdirSync, readFileSync } from "node:fs";
16
+ import { dirname, join } from "node:path";
17
+ import { fileURLToPath } from "node:url";
18
+ const __filename = fileURLToPath(import.meta.url);
19
+ const __dirname = dirname(__filename);
20
+ function readTemplate(relativePath) {
21
+ return readFileSync(join(__dirname, relativePath), "utf-8");
22
+ }
23
+ function listDirectories(dir) {
24
+ try {
25
+ return readdirSync(join(__dirname, dir), { withFileTypes: true })
26
+ .filter((entry) => entry.isDirectory())
27
+ .map((entry) => entry.name)
28
+ .sort();
29
+ }
30
+ catch {
31
+ return [];
32
+ }
33
+ }
34
+ function listFiles(dir) {
35
+ try {
36
+ return readdirSync(join(__dirname, dir)).sort();
37
+ }
38
+ catch {
39
+ return [];
40
+ }
41
+ }
42
+ // Shared skills are now sourced from common/ templates (see templates/common/index.ts)
43
+ export function getAllAgents() {
44
+ const agents = [];
45
+ for (const file of listFiles("agents")) {
46
+ if (!file.endsWith(".toml")) {
47
+ continue;
48
+ }
49
+ const name = file.replace(".toml", "");
50
+ const content = readTemplate(`agents/${file}`);
51
+ agents.push({ name, content });
52
+ }
53
+ return agents;
54
+ }
55
+ /**
56
+ * Get Codex-specific skills (installed to .codex/skills/, not shared .agents/skills/).
57
+ */
58
+ export function getAllCodexSkills() {
59
+ const skills = [];
60
+ for (const name of listDirectories("codex-skills")) {
61
+ const content = readTemplate(`codex-skills/${name}/SKILL.md`);
62
+ skills.push({ name, content });
63
+ }
64
+ return skills;
65
+ }
66
+ export function getAllHooks() {
67
+ const hooks = [];
68
+ for (const file of listFiles("hooks")) {
69
+ if (!file.endsWith(".py")) {
70
+ continue;
71
+ }
72
+ hooks.push({ name: file, content: readTemplate(`hooks/${file}`) });
73
+ }
74
+ return hooks;
75
+ }
76
+ export function getHooksConfig() {
77
+ return readTemplate("hooks.json");
78
+ }
79
+ export function getConfigTemplate() {
80
+ return {
81
+ targetPath: "config.toml",
82
+ content: readTemplate("config.toml"),
83
+ };
84
+ }
85
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC9D,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;aACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAC1B,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAiBD,uFAAuF;AAEvF,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,YAAY,CAAC,gBAAgB,IAAI,WAAW,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,UAAU,EAAE,aAAa;QACzB,OAAO,EAAE,YAAY,CAAC,aAAa,CAAC;KACrC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,34 @@
1
+ ---
2
+ name: before-dev
3
+ description: "Discovers and injects project-specific coding guidelines from .rudder/spec/ before implementation begins. Reads spec indexes, pre-development checklists, and shared thinking guides for the target package. Use when starting a new coding task, before writing any code, switching to a different package, or needing to refresh project conventions and standards."
4
+ ---
5
+
6
+ Read the relevant development guidelines before starting your task.
7
+
8
+ Execute these steps:
9
+
10
+ 1. **Discover packages and their spec layers**:
11
+ ```bash
12
+ python3 ./.rudder/scripts/get_context.py --mode packages
13
+ ```
14
+
15
+ 2. **Identify which specs apply** to your task based on:
16
+ - Which package you're modifying (e.g., `cli/`, `docs-site/`)
17
+ - What type of work (backend, frontend, unit-test, docs, etc.)
18
+
19
+ 3. **Read the spec index** for each relevant module:
20
+ ```bash
21
+ cat .rudder/spec/<package>/<layer>/index.md
22
+ ```
23
+ Follow the **"Pre-Development Checklist"** section in the index.
24
+
25
+ 4. **Read the specific guideline files** listed in the Pre-Development Checklist that are relevant to your task. The index is NOT the goal — it points you to the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`). Read those files to understand the coding standards and patterns.
26
+
27
+ 5. **Always read shared guides**:
28
+ ```bash
29
+ cat .rudder/spec/guides/index.md
30
+ ```
31
+
32
+ 6. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
33
+
34
+ This step is **mandatory** before writing any code.