@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,430 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ Copilot Session Start Hook - Emit Rudder session-start context.
5
+
6
+ Microsoft VS Code Agent hooks are in preview and have been documented since
7
+ VS Code 1.110 (February 2026). The official documentation
8
+ (https://code.visualstudio.com/docs/copilot/customization/hooks) defines
9
+ `SessionStart.hookSpecificOutput.additionalContext` as the field used to inject
10
+ additional context into the agent's conversation.
11
+
12
+ This script emits the spec-compliant SessionStart payload. Whether Copilot
13
+ actually consumes `additionalContext` depends on the user's installed VS Code
14
+ and Copilot versions, which is outside Rudder's control. UserPromptSubmit
15
+ breadcrumbs remain available as a per-turn complement.
16
+ """
17
+
18
+ from __future__ import annotations
19
+
20
+ import json
21
+ import os
22
+ import re
23
+ import subprocess
24
+ import sys
25
+ import warnings
26
+ from io import StringIO
27
+ from pathlib import Path
28
+
29
+
30
+ def _normalize_windows_shell_path(path_str: str) -> str:
31
+ """Normalize Unix-style shell paths to real Windows paths.
32
+
33
+ On Windows, shells like Git Bash / MSYS2 / Cygwin may report paths like
34
+ `/d/Users/...` or `/cygdrive/d/Users/...`. `Path.resolve()` will misinterpret
35
+ these as `D:/d/Users...` on drive D: (or similar), breaking repo root
36
+ detection.
37
+
38
+ This function is intentionally conservative: it only rewrites patterns that
39
+ unambiguously represent a drive letter mount.
40
+ """
41
+ if not isinstance(path_str, str) or not path_str:
42
+ return path_str
43
+
44
+ # Only relevant on Windows; keep other platforms untouched.
45
+ if not sys.platform.startswith("win"):
46
+ return path_str
47
+
48
+ p = path_str.strip()
49
+
50
+ # Already a Windows drive path (C:\... or C:/...)
51
+ if re.match(r"^[A-Za-z]:[\/]", p):
52
+ return p
53
+
54
+ # MSYS/Git-Bash style: /c/Users/... or /d/Work/...
55
+ m = re.match(r"^/([A-Za-z])/(.*)", p)
56
+ if m:
57
+ drive, rest = m.group(1).upper(), m.group(2)
58
+ rest = rest.replace('/', '\\')
59
+ return f"{drive}:\\{rest}"
60
+
61
+ # Cygwin style: /cygdrive/c/Users/...
62
+ m = re.match(r"^/cygdrive/([A-Za-z])/(.*)", p)
63
+ if m:
64
+ drive, rest = m.group(1).upper(), m.group(2)
65
+ rest = rest.replace('/', '\\')
66
+ return f"{drive}:\\{rest}"
67
+
68
+ # WSL mounted drive (sometimes leaked into env): /mnt/c/Users/...
69
+ m = re.match(r"^/mnt/([A-Za-z])/(.*)", p)
70
+ if m:
71
+ drive, rest = m.group(1).upper(), m.group(2)
72
+ rest = rest.replace('/', '\\')
73
+ return f"{drive}:\\{rest}"
74
+
75
+ return path_str
76
+
77
+
78
+ warnings.filterwarnings("ignore")
79
+
80
+
81
+ def should_skip_injection() -> bool:
82
+ if os.environ.get("RUDDER_HOOKS") == "0":
83
+ return True
84
+ if os.environ.get("RUDDER_DISABLE_HOOKS") == "1":
85
+ return True
86
+ return os.environ.get("COPILOT_NON_INTERACTIVE") == "1"
87
+
88
+
89
+ def configure_project_encoding(project_dir: Path) -> None:
90
+ """Reuse Rudder' shared Windows stdio encoding helper before JSON output."""
91
+ scripts_dir = project_dir / ".rudder" / "scripts"
92
+ if str(scripts_dir) not in sys.path:
93
+ sys.path.insert(0, str(scripts_dir))
94
+
95
+ try:
96
+ from common import configure_encoding # type: ignore[import-not-found]
97
+
98
+ configure_encoding()
99
+ except Exception:
100
+ pass
101
+
102
+
103
+ def _has_curated_jsonl_entry(jsonl_path: Path) -> bool:
104
+ """Return True iff jsonl has at least one row with a ``file`` field.
105
+
106
+ A freshly seeded jsonl only contains a ``{"_example": ...}`` row (no
107
+ ``file`` key) — that is NOT "ready". Readiness requires at least one
108
+ curated entry. Matches the contract used by ``inject-subagent-context.py``.
109
+ """
110
+ try:
111
+ for line in jsonl_path.read_text(encoding="utf-8").splitlines():
112
+ line = line.strip()
113
+ if not line:
114
+ continue
115
+ try:
116
+ row = json.loads(line)
117
+ except json.JSONDecodeError:
118
+ continue
119
+ if isinstance(row, dict) and row.get("file"):
120
+ return True
121
+ except (OSError, UnicodeDecodeError):
122
+ return False
123
+ return False
124
+
125
+
126
+ def read_file(path: Path, fallback: str = "") -> str:
127
+ try:
128
+ return path.read_text(encoding="utf-8")
129
+ except (FileNotFoundError, PermissionError):
130
+ return fallback
131
+
132
+
133
+ def _resolve_context_key(project_dir: Path, hook_input: dict) -> str | None:
134
+ scripts_dir = project_dir / ".rudder" / "scripts"
135
+ if str(scripts_dir) not in sys.path:
136
+ sys.path.insert(0, str(scripts_dir))
137
+ try:
138
+ from common.active_task import resolve_context_key # type: ignore[import-not-found]
139
+ except Exception:
140
+ return None
141
+ return resolve_context_key(hook_input, platform="copilot")
142
+
143
+
144
+ def _resolve_active_task(rudder_dir: Path, hook_input: dict):
145
+ scripts_dir = rudder_dir / "scripts"
146
+ if str(scripts_dir) not in sys.path:
147
+ sys.path.insert(0, str(scripts_dir))
148
+ from common.active_task import resolve_active_task # type: ignore[import-not-found]
149
+
150
+ return resolve_active_task(rudder_dir.parent, hook_input, platform="copilot")
151
+
152
+
153
+ def run_script(script_path: Path, context_key: str | None = None) -> str:
154
+ try:
155
+ env = os.environ.copy()
156
+ env["PYTHONIOENCODING"] = "utf-8"
157
+ if context_key:
158
+ env["RUDDER_CONTEXT_ID"] = context_key
159
+ cmd = [sys.executable, "-W", "ignore", str(script_path)]
160
+ result = subprocess.run(
161
+ cmd,
162
+ capture_output=True,
163
+ text=True,
164
+ encoding="utf-8",
165
+ errors="replace",
166
+ timeout=5,
167
+ cwd=str(script_path.parent.parent.parent),
168
+ env=env,
169
+ )
170
+ return result.stdout if result.returncode == 0 else "No context available"
171
+ except (subprocess.TimeoutExpired, FileNotFoundError, PermissionError):
172
+ return "No context available"
173
+
174
+
175
+ def _normalize_task_ref(task_ref: str) -> str:
176
+ normalized = task_ref.strip()
177
+ if not normalized:
178
+ return ""
179
+
180
+ path_obj = Path(normalized)
181
+ if path_obj.is_absolute():
182
+ return str(path_obj)
183
+
184
+ normalized = normalized.replace("\\", "/")
185
+ while normalized.startswith("./"):
186
+ normalized = normalized[2:]
187
+
188
+ if normalized.startswith("tasks/"):
189
+ return f".rudder/{normalized}"
190
+
191
+ return normalized
192
+
193
+
194
+ def _resolve_task_dir(rudder_dir: Path, task_ref: str) -> Path:
195
+ normalized = _normalize_task_ref(task_ref)
196
+ path_obj = Path(normalized)
197
+ if path_obj.is_absolute():
198
+ return path_obj
199
+ if normalized.startswith(".rudder/"):
200
+ return rudder_dir.parent / path_obj
201
+ return rudder_dir / "tasks" / path_obj
202
+
203
+
204
+ def _get_task_status(rudder_dir: Path, hook_input: dict) -> str:
205
+ active = _resolve_active_task(rudder_dir, hook_input)
206
+ if not active.task_path:
207
+ return f"Status: NO ACTIVE TASK\nSource: {active.source}\nNext: Describe what you want to work on"
208
+
209
+ task_ref = active.task_path
210
+ task_dir = _resolve_task_dir(rudder_dir, task_ref)
211
+ if active.stale or not task_dir.is_dir():
212
+ return f"Status: STALE POINTER\nTask: {task_ref}\nSource: {active.source}\nNext: Task directory not found. Run: python3 ./.rudder/scripts/task.py finish"
213
+
214
+ task_json_path = task_dir / "task.json"
215
+ task_data: dict = {}
216
+ if task_json_path.is_file():
217
+ try:
218
+ task_data = json.loads(task_json_path.read_text(encoding="utf-8"))
219
+ except (json.JSONDecodeError, PermissionError):
220
+ pass
221
+
222
+ task_title = task_data.get("title", task_ref)
223
+ task_status = task_data.get("status", "unknown")
224
+
225
+ if task_status == "completed":
226
+ 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"
227
+
228
+ has_context = False
229
+ for jsonl_name in ("implement.jsonl", "check.jsonl", "spec.jsonl"):
230
+ jsonl_path = task_dir / jsonl_name
231
+ if jsonl_path.is_file() and _has_curated_jsonl_entry(jsonl_path):
232
+ has_context = True
233
+ break
234
+
235
+ has_prd = (task_dir / "prd.md").is_file()
236
+
237
+ if not has_prd:
238
+ 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"
239
+
240
+ if not has_context:
241
+ 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`"
242
+
243
+ return (
244
+ f"Status: READY\nTask: {task_title}\n"
245
+ f"Source: {active.source}\n"
246
+ "Next required action: dispatch `rudder-implement` per Phase 2.1. "
247
+ "For agent-capable platforms, the default is to NOT edit code in the main session. "
248
+ "After implementation, dispatch `rudder-check` per Phase 2.2 before reporting completion.\n"
249
+ "User override (per-turn escape hatch): if the user's CURRENT message explicitly tells the "
250
+ "main session to handle it directly (\"你直接改\" / \"别派 sub-agent\" / \"main session 写就行\" / "
251
+ "\"do it inline\" / \"不用 sub-agent\"), honor it for this turn and edit code directly. "
252
+ "Per-turn only; do NOT invent an override the user did not say."
253
+ )
254
+
255
+
256
+ def _extract_range(content: str, start_header: str, end_header: str) -> str:
257
+ """Extract lines starting at `## start_header` up to (but excluding) `## end_header`."""
258
+ lines = content.splitlines()
259
+ start: "int | None" = None
260
+ end: int = len(lines)
261
+ start_match = f"## {start_header}"
262
+ end_match = f"## {end_header}"
263
+ for i, line in enumerate(lines):
264
+ stripped = line.strip()
265
+ if start is None and stripped == start_match:
266
+ start = i
267
+ continue
268
+ if start is not None and stripped == end_match:
269
+ end = i
270
+ break
271
+ if start is None:
272
+ return ""
273
+ return "\n".join(lines[start:end]).rstrip()
274
+
275
+
276
+ _BREADCRUMB_TAG_RE = re.compile(
277
+ r"\[workflow-state:([A-Za-z0-9_-]+)\]\s*\n.*?\n\s*\[/workflow-state:\1\]",
278
+ re.DOTALL,
279
+ )
280
+
281
+
282
+ def _strip_breadcrumb_tag_blocks(content: str) -> str:
283
+ return _BREADCRUMB_TAG_RE.sub("", content)
284
+
285
+
286
+ def _build_workflow_toc(workflow_path: Path) -> str:
287
+ """Inject workflow guide: TOC + Phase Index + Phase 1/2/3 step details.
288
+
289
+ Since v0.5.0-rc.0 the [workflow-state:STATUS] breadcrumb tag blocks
290
+ live inside ## Phase Index. They're consumed by inject-workflow-state.py
291
+ on each UserPromptSubmit, so strip them from the session-start payload.
292
+ """
293
+ content = read_file(workflow_path)
294
+ if not content:
295
+ return "No workflow.md found"
296
+
297
+ out_lines = [
298
+ "# Development Workflow — Section Index",
299
+ "Full guide: .rudder/workflow.md (read on demand)",
300
+ "",
301
+ "## Table of Contents",
302
+ ]
303
+ for line in content.splitlines():
304
+ if line.startswith("## "):
305
+ out_lines.append(line)
306
+ out_lines += ["", "---", ""]
307
+
308
+ phases = _extract_range(content, "Phase Index", "Customizing Rudder (for forks)")
309
+ if phases:
310
+ out_lines.append(_strip_breadcrumb_tag_blocks(phases).rstrip())
311
+
312
+ return "\n".join(out_lines).rstrip()
313
+
314
+
315
+ def main() -> None:
316
+ if should_skip_injection():
317
+ sys.exit(0)
318
+
319
+ # Read hook input from stdin
320
+ try:
321
+ hook_input = json.loads(sys.stdin.read())
322
+ if not isinstance(hook_input, dict):
323
+ hook_input = {}
324
+ project_dir = Path(_normalize_windows_shell_path(hook_input.get("cwd", "."))).resolve()
325
+ except (json.JSONDecodeError, KeyError):
326
+ hook_input = {}
327
+ project_dir = Path(".").resolve()
328
+
329
+ configure_project_encoding(project_dir)
330
+
331
+ rudder_dir = project_dir / ".rudder"
332
+ context_key = _resolve_context_key(project_dir, hook_input)
333
+
334
+ output = StringIO()
335
+
336
+ output.write("""<session-context>
337
+ You are starting a new session in a Rudder-managed project.
338
+ Read and follow all instructions below carefully.
339
+ </session-context>
340
+
341
+ """)
342
+
343
+ output.write("<current-state>\n")
344
+ context_script = rudder_dir / "scripts" / "get_context.py"
345
+ output.write(run_script(context_script, context_key))
346
+ output.write("\n</current-state>\n\n")
347
+
348
+ output.write("<workflow>\n")
349
+ output.write(_build_workflow_toc(rudder_dir / "workflow.md"))
350
+ output.write("\n</workflow>\n\n")
351
+
352
+ output.write("<guidelines>\n")
353
+ output.write(
354
+ "Project spec indexes are listed by path below. Each index contains a "
355
+ "**Pre-Development Checklist** listing the specific guideline files to "
356
+ "read before coding.\n\n"
357
+ "- If you're spawning an implement/check sub-agent, context is injected "
358
+ "automatically via `{task}/implement.jsonl` / `check.jsonl`. You do NOT "
359
+ "need to read these indexes yourself.\n"
360
+ "- For agent-capable platforms, the default is to dispatch "
361
+ "`rudder-implement` and `rudder-check` (so JSONL context is loaded by "
362
+ "the sub-agents) rather than editing code in the main session. "
363
+ "Honor a per-turn user override only if the user's current message "
364
+ "explicitly opts out (see <task-status> below for override phrases).\n\n"
365
+ )
366
+
367
+ # guides/ inlined (cross-package thinking, broadly useful)
368
+ guides_index = rudder_dir / "spec" / "guides" / "index.md"
369
+ if guides_index.is_file():
370
+ output.write("## guides (inlined — cross-package thinking guides)\n")
371
+ output.write(read_file(guides_index))
372
+ output.write("\n\n")
373
+
374
+ # Other indexes — paths only
375
+ paths: list[str] = []
376
+ spec_dir = rudder_dir / "spec"
377
+ if spec_dir.is_dir():
378
+ for sub in sorted(spec_dir.iterdir()):
379
+ if not sub.is_dir() or sub.name.startswith("."):
380
+ continue
381
+ if sub.name == "guides":
382
+ continue
383
+ index_file = sub / "index.md"
384
+ if index_file.is_file():
385
+ paths.append(f".rudder/spec/{sub.name}/index.md")
386
+ else:
387
+ for nested in sorted(sub.iterdir()):
388
+ if not nested.is_dir():
389
+ continue
390
+ nested_index = nested / "index.md"
391
+ if nested_index.is_file():
392
+ paths.append(
393
+ f".rudder/spec/{sub.name}/{nested.name}/index.md"
394
+ )
395
+
396
+ if paths:
397
+ output.write("## Available spec indexes (read on demand)\n")
398
+ for p in paths:
399
+ output.write(f"- {p}\n")
400
+ output.write("\n")
401
+
402
+ output.write(
403
+ "Discover more via: "
404
+ "`python3 ./.rudder/scripts/get_context.py --mode packages`\n"
405
+ )
406
+ output.write("</guidelines>\n\n")
407
+
408
+ task_status = _get_task_status(rudder_dir, hook_input)
409
+ output.write(f"<task-status>\n{task_status}\n</task-status>\n\n")
410
+
411
+ output.write("""<ready>
412
+ Context loaded. Workflow index, project state, and guidelines are already injected above — do NOT re-read them.
413
+ When the user sends the first message, follow <task-status> and the workflow guide.
414
+ If a task is READY, execute its Next required action without asking whether to continue.
415
+ </ready>""")
416
+
417
+ context = output.getvalue()
418
+ result = {
419
+ "suppressOutput": True,
420
+ "hookSpecificOutput": {
421
+ "hookEventName": "SessionStart",
422
+ "additionalContext": context,
423
+ },
424
+ }
425
+
426
+ print(json.dumps(result, ensure_ascii=False), flush=True)
427
+
428
+
429
+ if __name__ == "__main__":
430
+ main()
@@ -0,0 +1,19 @@
1
+ {
2
+ "hooks": {
3
+ "SessionStart": [
4
+ {
5
+ "type": "command",
6
+ "command": "{{PYTHON_CMD}} .github/copilot/hooks/session-start.py",
7
+ "timeout": 30
8
+ }
9
+ ],
10
+ "userPromptSubmitted": [
11
+ {
12
+ "type": "command",
13
+ "bash": "{{PYTHON_CMD}} .github/copilot/hooks/inject-workflow-state.py",
14
+ "powershell": "{{PYTHON_CMD}} .github/copilot/hooks/inject-workflow-state.py",
15
+ "timeoutSec": 15
16
+ }
17
+ ]
18
+ }
19
+ }
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Copilot templates
3
+ *
4
+ * These are GENERIC templates for user projects.
5
+ *
6
+ * Directory structure:
7
+ * copilot/
8
+ * ├── prompts/ # Slash-command prompts → .github/prompts/*.prompt.md
9
+ * ├── hooks/ # Hook scripts → .github/copilot/hooks/
10
+ * └── hooks.json # Hooks config → .github/hooks/rudder.json
11
+ */
12
+ export interface HookTemplate {
13
+ name: string;
14
+ content: string;
15
+ }
16
+ export interface PromptTemplate {
17
+ name: string;
18
+ content: string;
19
+ }
20
+ export declare function getAllHooks(): HookTemplate[];
21
+ export declare function getHooksConfig(): string;
22
+ export declare function getAllPrompts(): PromptTemplate[];
23
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,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,aAAa,IAAI,cAAc,EAAE,CAchD"}
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Copilot templates
3
+ *
4
+ * These are GENERIC templates for user projects.
5
+ *
6
+ * Directory structure:
7
+ * copilot/
8
+ * ├── prompts/ # Slash-command prompts → .github/prompts/*.prompt.md
9
+ * ├── hooks/ # Hook scripts → .github/copilot/hooks/
10
+ * └── hooks.json # Hooks config → .github/hooks/rudder.json
11
+ */
12
+ import { readdirSync, readFileSync } from "node:fs";
13
+ import { dirname, join } from "node:path";
14
+ import { fileURLToPath } from "node:url";
15
+ const __filename = fileURLToPath(import.meta.url);
16
+ const __dirname = dirname(__filename);
17
+ function readTemplate(relativePath) {
18
+ return readFileSync(join(__dirname, relativePath), "utf-8");
19
+ }
20
+ function listFiles(dir) {
21
+ try {
22
+ return readdirSync(join(__dirname, dir)).sort();
23
+ }
24
+ catch {
25
+ return [];
26
+ }
27
+ }
28
+ export function getAllHooks() {
29
+ const hooks = [];
30
+ for (const file of listFiles("hooks")) {
31
+ if (!file.endsWith(".py")) {
32
+ continue;
33
+ }
34
+ hooks.push({ name: file, content: readTemplate(`hooks/${file}`) });
35
+ }
36
+ return hooks;
37
+ }
38
+ export function getHooksConfig() {
39
+ return readTemplate("hooks.json");
40
+ }
41
+ export function getAllPrompts() {
42
+ const prompts = [];
43
+ for (const file of listFiles("prompts")) {
44
+ if (!file.endsWith(".prompt.md")) {
45
+ continue;
46
+ }
47
+ prompts.push({
48
+ name: file.slice(0, -".prompt.md".length),
49
+ content: readTemplate(`prompts/${file}`),
50
+ });
51
+ }
52
+ return prompts;
53
+ }
54
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;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,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;AAYD,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,aAAa;IAC3B,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;YACzC,OAAO,EAAE,YAAY,CAAC,WAAW,IAAI,EAAE,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,33 @@
1
+ ---
2
+ description: "Rudder Copilot prompt: before-dev.prompt"
3
+ ---
4
+
5
+ Read the relevant development guidelines before starting your task.
6
+
7
+ Execute these steps:
8
+
9
+ 1. **Discover packages and their spec layers**:
10
+ ```bash
11
+ python3 ./.rudder/scripts/get_context.py --mode packages
12
+ ```
13
+
14
+ 2. **Identify which specs apply** to your task based on:
15
+ - Which package you're modifying (e.g., `cli/`, `docs-site/`)
16
+ - What type of work (backend, frontend, unit-test, docs, etc.)
17
+
18
+ 3. **Read the spec index** for each relevant module:
19
+ ```bash
20
+ cat .rudder/spec/<package>/<layer>/index.md
21
+ ```
22
+ Follow the **"Pre-Development Checklist"** section in the index.
23
+
24
+ 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.
25
+
26
+ 5. **Always read shared guides**:
27
+ ```bash
28
+ cat .rudder/spec/guides/index.md
29
+ ```
30
+
31
+ 6. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
32
+
33
+ This step is **mandatory** before writing any code.