@mengde1231/rudder 0.5.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (484) hide show
  1. package/LICENSE +235 -0
  2. package/README.md +136 -0
  3. package/bin/rudder.js +3 -0
  4. package/dist/cli/index.d.ts +3 -0
  5. package/dist/cli/index.d.ts.map +1 -0
  6. package/dist/cli/index.js +132 -0
  7. package/dist/cli/index.js.map +1 -0
  8. package/dist/commands/init.d.ts +57 -0
  9. package/dist/commands/init.d.ts.map +1 -0
  10. package/dist/commands/init.js +1465 -0
  11. package/dist/commands/init.js.map +1 -0
  12. package/dist/commands/uninstall.d.ts +27 -0
  13. package/dist/commands/uninstall.d.ts.map +1 -0
  14. package/dist/commands/uninstall.js +322 -0
  15. package/dist/commands/uninstall.js.map +1 -0
  16. package/dist/commands/update.d.ts +72 -0
  17. package/dist/commands/update.d.ts.map +1 -0
  18. package/dist/commands/update.js +1911 -0
  19. package/dist/commands/update.js.map +1 -0
  20. package/dist/configurators/antigravity.d.ts +7 -0
  21. package/dist/configurators/antigravity.d.ts.map +1 -0
  22. package/dist/configurators/antigravity.js +19 -0
  23. package/dist/configurators/antigravity.js.map +1 -0
  24. package/dist/configurators/claude.d.ts +9 -0
  25. package/dist/configurators/claude.d.ts.map +1 -0
  26. package/dist/configurators/claude.js +69 -0
  27. package/dist/configurators/claude.js.map +1 -0
  28. package/dist/configurators/codebuddy.d.ts +10 -0
  29. package/dist/configurators/codebuddy.d.ts.map +1 -0
  30. package/dist/configurators/codebuddy.js +30 -0
  31. package/dist/configurators/codebuddy.js.map +1 -0
  32. package/dist/configurators/codex.d.ts +8 -0
  33. package/dist/configurators/codex.d.ts.map +1 -0
  34. package/dist/configurators/codex.js +85 -0
  35. package/dist/configurators/codex.js.map +1 -0
  36. package/dist/configurators/copilot.d.ts +10 -0
  37. package/dist/configurators/copilot.d.ts.map +1 -0
  38. package/dist/configurators/copilot.js +51 -0
  39. package/dist/configurators/copilot.js.map +1 -0
  40. package/dist/configurators/cursor.d.ts +10 -0
  41. package/dist/configurators/cursor.d.ts.map +1 -0
  42. package/dist/configurators/cursor.js +29 -0
  43. package/dist/configurators/cursor.js.map +1 -0
  44. package/dist/configurators/droid.d.ts +10 -0
  45. package/dist/configurators/droid.d.ts.map +1 -0
  46. package/dist/configurators/droid.js +30 -0
  47. package/dist/configurators/droid.js.map +1 -0
  48. package/dist/configurators/gemini.d.ts +16 -0
  49. package/dist/configurators/gemini.d.ts.map +1 -0
  50. package/dist/configurators/gemini.js +38 -0
  51. package/dist/configurators/gemini.js.map +1 -0
  52. package/dist/configurators/index.d.ts +65 -0
  53. package/dist/configurators/index.d.ts.map +1 -0
  54. package/dist/configurators/index.js +367 -0
  55. package/dist/configurators/index.js.map +1 -0
  56. package/dist/configurators/kilo.d.ts +7 -0
  57. package/dist/configurators/kilo.d.ts.map +1 -0
  58. package/dist/configurators/kilo.js +19 -0
  59. package/dist/configurators/kilo.js.map +1 -0
  60. package/dist/configurators/kiro.d.ts +8 -0
  61. package/dist/configurators/kiro.d.ts.map +1 -0
  62. package/dist/configurators/kiro.js +24 -0
  63. package/dist/configurators/kiro.js.map +1 -0
  64. package/dist/configurators/opencode.d.ts +14 -0
  65. package/dist/configurators/opencode.d.ts.map +1 -0
  66. package/dist/configurators/opencode.js +96 -0
  67. package/dist/configurators/opencode.js.map +1 -0
  68. package/dist/configurators/pi.d.ts +3 -0
  69. package/dist/configurators/pi.d.ts.map +1 -0
  70. package/dist/configurators/pi.js +45 -0
  71. package/dist/configurators/pi.js.map +1 -0
  72. package/dist/configurators/qoder.d.ts +11 -0
  73. package/dist/configurators/qoder.d.ts.map +1 -0
  74. package/dist/configurators/qoder.js +31 -0
  75. package/dist/configurators/qoder.js.map +1 -0
  76. package/dist/configurators/shared.d.ts +178 -0
  77. package/dist/configurators/shared.d.ts.map +1 -0
  78. package/dist/configurators/shared.js +546 -0
  79. package/dist/configurators/shared.js.map +1 -0
  80. package/dist/configurators/windsurf.d.ts +7 -0
  81. package/dist/configurators/windsurf.d.ts.map +1 -0
  82. package/dist/configurators/windsurf.js +19 -0
  83. package/dist/configurators/windsurf.js.map +1 -0
  84. package/dist/configurators/workflow.d.ts +34 -0
  85. package/dist/configurators/workflow.d.ts.map +1 -0
  86. package/dist/configurators/workflow.js +178 -0
  87. package/dist/configurators/workflow.js.map +1 -0
  88. package/dist/constants/paths.d.ts +70 -0
  89. package/dist/constants/paths.d.ts.map +1 -0
  90. package/dist/constants/paths.js +79 -0
  91. package/dist/constants/paths.js.map +1 -0
  92. package/dist/constants/version.d.ts +9 -0
  93. package/dist/constants/version.d.ts.map +1 -0
  94. package/dist/constants/version.js +15 -0
  95. package/dist/constants/version.js.map +1 -0
  96. package/dist/index.d.ts +9 -0
  97. package/dist/index.d.ts.map +1 -0
  98. package/dist/index.js +9 -0
  99. package/dist/index.js.map +1 -0
  100. package/dist/migrations/index.d.ts +62 -0
  101. package/dist/migrations/index.d.ts.map +1 -0
  102. package/dist/migrations/index.js +187 -0
  103. package/dist/migrations/index.js.map +1 -0
  104. package/dist/migrations/manifests/0.1.9.json +30 -0
  105. package/dist/migrations/manifests/0.2.0.json +49 -0
  106. package/dist/migrations/manifests/0.2.12.json +9 -0
  107. package/dist/migrations/manifests/0.2.13.json +9 -0
  108. package/dist/migrations/manifests/0.2.14.json +175 -0
  109. package/dist/migrations/manifests/0.2.15.json +33 -0
  110. package/dist/migrations/manifests/0.3.0-beta.0.json +297 -0
  111. package/dist/migrations/manifests/0.3.0-beta.1.json +9 -0
  112. package/dist/migrations/manifests/0.3.0-beta.10.json +9 -0
  113. package/dist/migrations/manifests/0.3.0-beta.11.json +9 -0
  114. package/dist/migrations/manifests/0.3.0-beta.12.json +9 -0
  115. package/dist/migrations/manifests/0.3.0-beta.13.json +9 -0
  116. package/dist/migrations/manifests/0.3.0-beta.14.json +9 -0
  117. package/dist/migrations/manifests/0.3.0-beta.15.json +9 -0
  118. package/dist/migrations/manifests/0.3.0-beta.16.json +9 -0
  119. package/dist/migrations/manifests/0.3.0-beta.2.json +9 -0
  120. package/dist/migrations/manifests/0.3.0-beta.3.json +9 -0
  121. package/dist/migrations/manifests/0.3.0-beta.4.json +9 -0
  122. package/dist/migrations/manifests/0.3.0-beta.5.json +9 -0
  123. package/dist/migrations/manifests/0.3.0-beta.6.json +9 -0
  124. package/dist/migrations/manifests/0.3.0-beta.7.json +11 -0
  125. package/dist/migrations/manifests/0.3.0-beta.8.json +9 -0
  126. package/dist/migrations/manifests/0.3.0-beta.9.json +9 -0
  127. package/dist/migrations/manifests/0.3.0-rc.0.json +9 -0
  128. package/dist/migrations/manifests/0.3.0-rc.1.json +9 -0
  129. package/dist/migrations/manifests/0.3.0-rc.2.json +9 -0
  130. package/dist/migrations/manifests/0.3.0-rc.3.json +9 -0
  131. package/dist/migrations/manifests/0.3.0-rc.4.json +9 -0
  132. package/dist/migrations/manifests/0.3.0-rc.5.json +9 -0
  133. package/dist/migrations/manifests/0.3.0-rc.6.json +9 -0
  134. package/dist/migrations/manifests/0.3.0.json +11 -0
  135. package/dist/migrations/manifests/0.3.1.json +9 -0
  136. package/dist/migrations/manifests/0.3.10.json +9 -0
  137. package/dist/migrations/manifests/0.3.2.json +9 -0
  138. package/dist/migrations/manifests/0.3.3.json +9 -0
  139. package/dist/migrations/manifests/0.3.4.json +21 -0
  140. package/dist/migrations/manifests/0.3.5.json +9 -0
  141. package/dist/migrations/manifests/0.3.6.json +9 -0
  142. package/dist/migrations/manifests/0.3.7.json +9 -0
  143. package/dist/migrations/manifests/0.3.8.json +9 -0
  144. package/dist/migrations/manifests/0.3.9.json +9 -0
  145. package/dist/migrations/manifests/0.4.0-beta.1.json +228 -0
  146. package/dist/migrations/manifests/0.4.0-beta.10.json +9 -0
  147. package/dist/migrations/manifests/0.4.0-beta.2.json +9 -0
  148. package/dist/migrations/manifests/0.4.0-beta.3.json +9 -0
  149. package/dist/migrations/manifests/0.4.0-beta.4.json +9 -0
  150. package/dist/migrations/manifests/0.4.0-beta.5.json +9 -0
  151. package/dist/migrations/manifests/0.4.0-beta.6.json +9 -0
  152. package/dist/migrations/manifests/0.4.0-beta.7.json +9 -0
  153. package/dist/migrations/manifests/0.4.0-beta.8.json +34 -0
  154. package/dist/migrations/manifests/0.4.0-beta.9.json +9 -0
  155. package/dist/migrations/manifests/0.4.0-rc.0.json +9 -0
  156. package/dist/migrations/manifests/0.4.0-rc.1.json +9 -0
  157. package/dist/migrations/manifests/0.4.0.json +9 -0
  158. package/dist/migrations/manifests/0.5.0-beta.0.json +1646 -0
  159. package/dist/migrations/manifests/0.5.0-beta.1.json +9 -0
  160. package/dist/migrations/manifests/0.5.0-beta.10.json +9 -0
  161. package/dist/migrations/manifests/0.5.0-beta.11.json +9 -0
  162. package/dist/migrations/manifests/0.5.0-beta.12.json +9 -0
  163. package/dist/migrations/manifests/0.5.0-beta.13.json +9 -0
  164. package/dist/migrations/manifests/0.5.0-beta.14.json +9 -0
  165. package/dist/migrations/manifests/0.5.0-beta.15.json +116 -0
  166. package/dist/migrations/manifests/0.5.0-beta.16.json +9 -0
  167. package/dist/migrations/manifests/0.5.0-beta.17.json +9 -0
  168. package/dist/migrations/manifests/0.5.0-beta.18.json +9 -0
  169. package/dist/migrations/manifests/0.5.0-beta.19.json +9 -0
  170. package/dist/migrations/manifests/0.5.0-beta.2.json +9 -0
  171. package/dist/migrations/manifests/0.5.0-beta.3.json +9 -0
  172. package/dist/migrations/manifests/0.5.0-beta.4.json +9 -0
  173. package/dist/migrations/manifests/0.5.0-beta.5.json +222 -0
  174. package/dist/migrations/manifests/0.5.0-beta.6.json +9 -0
  175. package/dist/migrations/manifests/0.5.0-beta.7.json +9 -0
  176. package/dist/migrations/manifests/0.5.0-beta.8.json +9 -0
  177. package/dist/migrations/manifests/0.5.0-beta.9.json +48 -0
  178. package/dist/migrations/manifests/0.5.0-rc.0.json +9 -0
  179. package/dist/migrations/manifests/0.5.0-rc.1.json +9 -0
  180. package/dist/migrations/manifests/0.5.0-rc.2.json +9 -0
  181. package/dist/migrations/manifests/0.5.0-rc.3.json +9 -0
  182. package/dist/migrations/manifests/0.5.0-rc.4.json +9 -0
  183. package/dist/migrations/manifests/0.5.0-rc.5.json +9 -0
  184. package/dist/migrations/manifests/0.5.0-rc.6.json +9 -0
  185. package/dist/migrations/manifests/0.5.0-rc.7.json +9 -0
  186. package/dist/migrations/manifests/0.5.0.json +9 -0
  187. package/dist/migrations/manifests/0.5.1.json +9 -0
  188. package/dist/migrations/manifests/0.5.10.json +9 -0
  189. package/dist/migrations/manifests/0.5.11.json +16 -0
  190. package/dist/migrations/manifests/0.5.12.json +9 -0
  191. package/dist/migrations/manifests/0.5.13.json +9 -0
  192. package/dist/migrations/manifests/0.5.2.json +9 -0
  193. package/dist/migrations/manifests/0.5.3.json +9 -0
  194. package/dist/migrations/manifests/0.5.4.json +9 -0
  195. package/dist/migrations/manifests/0.5.5.json +9 -0
  196. package/dist/migrations/manifests/0.5.6.json +9 -0
  197. package/dist/migrations/manifests/0.5.7.json +16 -0
  198. package/dist/migrations/manifests/0.5.8.json +9 -0
  199. package/dist/migrations/manifests/0.5.9.json +9 -0
  200. package/dist/migrations/manifests/0.6.0-beta.0.json +16 -0
  201. package/dist/migrations/manifests/0.6.0-beta.1.json +9 -0
  202. package/dist/migrations/manifests/0.6.0-beta.2.json +9 -0
  203. package/dist/migrations/manifests/0.6.0-beta.3.json +9 -0
  204. package/dist/migrations/manifests/0.6.0-beta.4.json +9 -0
  205. package/dist/migrations/manifests/0.6.0-beta.5.json +9 -0
  206. package/dist/migrations/manifests/0.6.0-beta.6.json +16 -0
  207. package/dist/migrations/manifests/0.6.0-beta.7.json +9 -0
  208. package/dist/migrations/manifests/0.6.0-beta.8.json +9 -0
  209. package/dist/templates/claude/agents/rudder-check.md +143 -0
  210. package/dist/templates/claude/agents/rudder-implement.md +109 -0
  211. package/dist/templates/claude/agents/rudder-research.md +137 -0
  212. package/dist/templates/claude/index.d.ts +22 -0
  213. package/dist/templates/claude/index.d.ts.map +1 -0
  214. package/dist/templates/claude/index.js +46 -0
  215. package/dist/templates/claude/index.js.map +1 -0
  216. package/dist/templates/claude/settings.json +73 -0
  217. package/dist/templates/codebuddy/agents/rudder-check.md +143 -0
  218. package/dist/templates/codebuddy/agents/rudder-implement.md +109 -0
  219. package/dist/templates/codebuddy/agents/rudder-research.md +137 -0
  220. package/dist/templates/codebuddy/index.d.ts +15 -0
  221. package/dist/templates/codebuddy/index.d.ts.map +1 -0
  222. package/dist/templates/codebuddy/index.js +15 -0
  223. package/dist/templates/codebuddy/index.js.map +1 -0
  224. package/dist/templates/codebuddy/settings.json +59 -0
  225. package/dist/templates/codex/agents/rudder-check.toml +91 -0
  226. package/dist/templates/codex/agents/rudder-implement.toml +65 -0
  227. package/dist/templates/codex/agents/rudder-research.toml +73 -0
  228. package/dist/templates/codex/config.toml +35 -0
  229. package/dist/templates/codex/hooks/session-start.py +459 -0
  230. package/dist/templates/codex/hooks.json +15 -0
  231. package/dist/templates/codex/index.d.ts +39 -0
  232. package/dist/templates/codex/index.d.ts.map +1 -0
  233. package/dist/templates/codex/index.js +85 -0
  234. package/dist/templates/codex/index.js.map +1 -0
  235. package/dist/templates/codex/skills/before-dev/SKILL.md +34 -0
  236. package/dist/templates/codex/skills/brainstorm/SKILL.md +500 -0
  237. package/dist/templates/codex/skills/break-loop/SKILL.md +130 -0
  238. package/dist/templates/codex/skills/check/SKILL.md +30 -0
  239. package/dist/templates/codex/skills/check-cross-layer/SKILL.md +158 -0
  240. package/dist/templates/codex/skills/create-command/SKILL.md +101 -0
  241. package/dist/templates/codex/skills/finish-work/SKILL.md +90 -0
  242. package/dist/templates/codex/skills/improve-ut/SKILL.md +69 -0
  243. package/dist/templates/codex/skills/integrate-skill/SKILL.md +221 -0
  244. package/dist/templates/codex/skills/onboard/SKILL.md +363 -0
  245. package/dist/templates/codex/skills/record-session/SKILL.md +67 -0
  246. package/dist/templates/codex/skills/start/SKILL.md +354 -0
  247. package/dist/templates/codex/skills/update-spec/SKILL.md +335 -0
  248. package/dist/templates/common/bundled-skills/rudder-meta/SKILL.md +73 -0
  249. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/add-project-local-conventions.md +83 -0
  250. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-agents.md +54 -0
  251. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-context-loading.md +81 -0
  252. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-hooks.md +57 -0
  253. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-skills-or-commands.md +78 -0
  254. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-spec-structure.md +83 -0
  255. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-task-lifecycle.md +90 -0
  256. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/change-workflow.md +64 -0
  257. package/dist/templates/common/bundled-skills/rudder-meta/references/customize-local/overview.md +55 -0
  258. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/context-injection.md +68 -0
  259. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/generated-files.md +80 -0
  260. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/overview.md +51 -0
  261. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/spec-system.md +102 -0
  262. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/task-system.md +101 -0
  263. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/workflow.md +75 -0
  264. package/dist/templates/common/bundled-skills/rudder-meta/references/local-architecture/workspace-memory.md +71 -0
  265. package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/agents.md +79 -0
  266. package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/hooks-and-settings.md +69 -0
  267. package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/overview.md +59 -0
  268. package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/platform-map.md +74 -0
  269. package/dist/templates/common/bundled-skills/rudder-meta/references/platform-files/skills-and-commands.md +83 -0
  270. package/dist/templates/common/commands/continue.md +55 -0
  271. package/dist/templates/common/commands/finish-work.md +66 -0
  272. package/dist/templates/common/commands/start.md +58 -0
  273. package/dist/templates/common/index.d.ts +48 -0
  274. package/dist/templates/common/index.d.ts.map +1 -0
  275. package/dist/templates/common/index.js +104 -0
  276. package/dist/templates/common/index.js.map +1 -0
  277. package/dist/templates/common/skills/before-dev.md +29 -0
  278. package/dist/templates/common/skills/brainstorm.md +543 -0
  279. package/dist/templates/common/skills/break-loop.md +125 -0
  280. package/dist/templates/common/skills/check.md +87 -0
  281. package/dist/templates/common/skills/update-spec.md +351 -0
  282. package/dist/templates/copilot/hooks/session-start.py +430 -0
  283. package/dist/templates/copilot/hooks.json +19 -0
  284. package/dist/templates/copilot/index.d.ts +23 -0
  285. package/dist/templates/copilot/index.d.ts.map +1 -0
  286. package/dist/templates/copilot/index.js +54 -0
  287. package/dist/templates/copilot/index.js.map +1 -0
  288. package/dist/templates/copilot/prompts/before-dev.prompt.md +33 -0
  289. package/dist/templates/copilot/prompts/brainstorm.prompt.md +499 -0
  290. package/dist/templates/copilot/prompts/break-loop.prompt.md +129 -0
  291. package/dist/templates/copilot/prompts/check-cross-layer.prompt.md +157 -0
  292. package/dist/templates/copilot/prompts/check.prompt.md +29 -0
  293. package/dist/templates/copilot/prompts/create-command.prompt.md +116 -0
  294. package/dist/templates/copilot/prompts/finish-work.prompt.md +99 -0
  295. package/dist/templates/copilot/prompts/integrate-skill.prompt.md +223 -0
  296. package/dist/templates/copilot/prompts/onboard.prompt.md +362 -0
  297. package/dist/templates/copilot/prompts/parallel.prompt.md +196 -0
  298. package/dist/templates/copilot/prompts/record-session.prompt.md +66 -0
  299. package/dist/templates/copilot/prompts/start.prompt.md +397 -0
  300. package/dist/templates/copilot/prompts/update-spec.prompt.md +358 -0
  301. package/dist/templates/cursor/agents/rudder-check.md +142 -0
  302. package/dist/templates/cursor/agents/rudder-implement.md +108 -0
  303. package/dist/templates/cursor/agents/rudder-research.md +136 -0
  304. package/dist/templates/cursor/hooks.json +24 -0
  305. package/dist/templates/cursor/index.d.ts +13 -0
  306. package/dist/templates/cursor/index.d.ts.map +1 -0
  307. package/dist/templates/cursor/index.js +13 -0
  308. package/dist/templates/cursor/index.js.map +1 -0
  309. package/dist/templates/droid/droids/rudder-check.md +135 -0
  310. package/dist/templates/droid/droids/rudder-implement.md +101 -0
  311. package/dist/templates/droid/droids/rudder-research.md +137 -0
  312. package/dist/templates/droid/index.d.ts +15 -0
  313. package/dist/templates/droid/index.d.ts.map +1 -0
  314. package/dist/templates/droid/index.js +15 -0
  315. package/dist/templates/droid/index.js.map +1 -0
  316. package/dist/templates/droid/settings.json +59 -0
  317. package/dist/templates/extract.d.ts +40 -0
  318. package/dist/templates/extract.d.ts.map +1 -0
  319. package/dist/templates/extract.js +106 -0
  320. package/dist/templates/extract.js.map +1 -0
  321. package/dist/templates/gemini/agents/rudder-check.md +135 -0
  322. package/dist/templates/gemini/agents/rudder-implement.md +101 -0
  323. package/dist/templates/gemini/agents/rudder-research.md +136 -0
  324. package/dist/templates/gemini/index.d.ts +13 -0
  325. package/dist/templates/gemini/index.d.ts.map +1 -0
  326. package/dist/templates/gemini/index.js +13 -0
  327. package/dist/templates/gemini/index.js.map +1 -0
  328. package/dist/templates/gemini/settings.json +28 -0
  329. package/dist/templates/kiro/agents/rudder-check.json +26 -0
  330. package/dist/templates/kiro/agents/rudder-implement.json +26 -0
  331. package/dist/templates/kiro/agents/rudder-research.json +30 -0
  332. package/dist/templates/kiro/index.d.ts +18 -0
  333. package/dist/templates/kiro/index.d.ts.map +1 -0
  334. package/dist/templates/kiro/index.js +18 -0
  335. package/dist/templates/kiro/index.js.map +1 -0
  336. package/dist/templates/markdown/agents.md +21 -0
  337. package/dist/templates/markdown/gitignore.txt +15 -0
  338. package/dist/templates/markdown/index.d.ts +27 -0
  339. package/dist/templates/markdown/index.d.ts.map +1 -0
  340. package/dist/templates/markdown/index.js +52 -0
  341. package/dist/templates/markdown/index.js.map +1 -0
  342. package/dist/templates/markdown/spec/backend/database-guidelines.md.txt +51 -0
  343. package/dist/templates/markdown/spec/backend/directory-structure.md.txt +54 -0
  344. package/dist/templates/markdown/spec/backend/error-handling.md.txt +51 -0
  345. package/dist/templates/markdown/spec/backend/index.md.txt +38 -0
  346. package/dist/templates/markdown/spec/backend/logging-guidelines.md.txt +51 -0
  347. package/dist/templates/markdown/spec/backend/quality-guidelines.md.txt +51 -0
  348. package/dist/templates/markdown/spec/frontend/component-guidelines.md.txt +59 -0
  349. package/dist/templates/markdown/spec/frontend/directory-structure.md.txt +54 -0
  350. package/dist/templates/markdown/spec/frontend/hook-guidelines.md.txt +51 -0
  351. package/dist/templates/markdown/spec/frontend/index.md.txt +39 -0
  352. package/dist/templates/markdown/spec/frontend/quality-guidelines.md.txt +51 -0
  353. package/dist/templates/markdown/spec/frontend/state-management.md.txt +51 -0
  354. package/dist/templates/markdown/spec/frontend/type-safety.md.txt +51 -0
  355. package/dist/templates/markdown/spec/guides/code-reuse-thinking-guide.md.txt +105 -0
  356. package/dist/templates/markdown/spec/guides/cross-layer-thinking-guide.md.txt +162 -0
  357. package/dist/templates/markdown/spec/guides/cross-platform-thinking-guide.md.txt +595 -0
  358. package/dist/templates/markdown/spec/guides/index.md.txt +79 -0
  359. package/dist/templates/markdown/workspace-index.md +125 -0
  360. package/dist/templates/markdown/worktree.yaml.txt +58 -0
  361. package/dist/templates/opencode/agents/rudder-check.md +150 -0
  362. package/dist/templates/opencode/agents/rudder-implement.md +117 -0
  363. package/dist/templates/opencode/agents/rudder-research.md +145 -0
  364. package/dist/templates/opencode/lib/rudder-context.js +381 -0
  365. package/dist/templates/opencode/lib/session-utils.js +432 -0
  366. package/dist/templates/opencode/package.json +5 -0
  367. package/dist/templates/opencode/plugins/inject-subagent-context.js +497 -0
  368. package/dist/templates/opencode/plugins/inject-workflow-state.js +162 -0
  369. package/dist/templates/opencode/plugins/session-start.js +101 -0
  370. package/dist/templates/pi/agents/rudder-check.md +103 -0
  371. package/dist/templates/pi/agents/rudder-implement.md +41 -0
  372. package/dist/templates/pi/agents/rudder-research.md +25 -0
  373. package/dist/templates/pi/extensions/rudder/index.ts.txt +1172 -0
  374. package/dist/templates/pi/index.d.ts +5 -0
  375. package/dist/templates/pi/index.d.ts.map +1 -0
  376. package/dist/templates/pi/index.js +12 -0
  377. package/dist/templates/pi/index.js.map +1 -0
  378. package/dist/templates/pi/settings.json +21 -0
  379. package/dist/templates/qoder/agents/rudder-check.md +136 -0
  380. package/dist/templates/qoder/agents/rudder-implement.md +102 -0
  381. package/dist/templates/qoder/agents/rudder-research.md +137 -0
  382. package/dist/templates/qoder/index.d.ts +15 -0
  383. package/dist/templates/qoder/index.d.ts.map +1 -0
  384. package/dist/templates/qoder/index.js +15 -0
  385. package/dist/templates/qoder/index.js.map +1 -0
  386. package/dist/templates/qoder/settings.json +47 -0
  387. package/dist/templates/rudder/config.yaml +131 -0
  388. package/dist/templates/rudder/config_local.yml +17 -0
  389. package/dist/templates/rudder/gitignore.txt +35 -0
  390. package/dist/templates/rudder/index.d.ts +53 -0
  391. package/dist/templates/rudder/index.d.ts.map +1 -0
  392. package/dist/templates/rudder/index.js +98 -0
  393. package/dist/templates/rudder/index.js.map +1 -0
  394. package/dist/templates/rudder/scripts/__init__.py +5 -0
  395. package/dist/templates/rudder/scripts/add_session.py +547 -0
  396. package/dist/templates/rudder/scripts/common/__init__.py +92 -0
  397. package/dist/templates/rudder/scripts/common/active_task.py +626 -0
  398. package/dist/templates/rudder/scripts/common/cli_adapter.py +811 -0
  399. package/dist/templates/rudder/scripts/common/config.py +532 -0
  400. package/dist/templates/rudder/scripts/common/developer.py +190 -0
  401. package/dist/templates/rudder/scripts/common/git.py +31 -0
  402. package/dist/templates/rudder/scripts/common/git_context.py +106 -0
  403. package/dist/templates/rudder/scripts/common/io.py +37 -0
  404. package/dist/templates/rudder/scripts/common/log.py +45 -0
  405. package/dist/templates/rudder/scripts/common/packages_context.py +238 -0
  406. package/dist/templates/rudder/scripts/common/paths.py +447 -0
  407. package/dist/templates/rudder/scripts/common/rudder_config.py +201 -0
  408. package/dist/templates/rudder/scripts/common/safe_commit.py +255 -0
  409. package/dist/templates/rudder/scripts/common/session_context.py +839 -0
  410. package/dist/templates/rudder/scripts/common/task_context.py +223 -0
  411. package/dist/templates/rudder/scripts/common/task_queue.py +188 -0
  412. package/dist/templates/rudder/scripts/common/task_store.py +636 -0
  413. package/dist/templates/rudder/scripts/common/task_utils.py +274 -0
  414. package/dist/templates/rudder/scripts/common/tasks.py +112 -0
  415. package/dist/templates/rudder/scripts/common/types.py +110 -0
  416. package/dist/templates/rudder/scripts/common/workflow_phase.py +215 -0
  417. package/dist/templates/rudder/scripts/get_context.py +16 -0
  418. package/dist/templates/rudder/scripts/get_developer.py +26 -0
  419. package/dist/templates/rudder/scripts/hooks/linear_sync.py +243 -0
  420. package/dist/templates/rudder/scripts/init_developer.py +51 -0
  421. package/dist/templates/rudder/scripts/task.py +500 -0
  422. package/dist/templates/rudder/tasks/.gitkeep +0 -0
  423. package/dist/templates/rudder/workflow.md +710 -0
  424. package/dist/templates/shared-hooks/index.d.ts +50 -0
  425. package/dist/templates/shared-hooks/index.d.ts.map +1 -0
  426. package/dist/templates/shared-hooks/index.js +88 -0
  427. package/dist/templates/shared-hooks/index.js.map +1 -0
  428. package/dist/templates/shared-hooks/inject-shell-session-context.py +183 -0
  429. package/dist/templates/shared-hooks/inject-subagent-context.py +749 -0
  430. package/dist/templates/shared-hooks/inject-workflow-state.py +404 -0
  431. package/dist/templates/shared-hooks/session-start.py +827 -0
  432. package/dist/templates/template-utils.d.ts +26 -0
  433. package/dist/templates/template-utils.d.ts.map +1 -0
  434. package/dist/templates/template-utils.js +60 -0
  435. package/dist/templates/template-utils.js.map +1 -0
  436. package/dist/types/ai-tools.d.ts +95 -0
  437. package/dist/types/ai-tools.d.ts.map +1 -0
  438. package/dist/types/ai-tools.js +280 -0
  439. package/dist/types/ai-tools.js.map +1 -0
  440. package/dist/types/migration.d.ts +125 -0
  441. package/dist/types/migration.d.ts.map +1 -0
  442. package/dist/types/migration.js +8 -0
  443. package/dist/types/migration.js.map +1 -0
  444. package/dist/utils/compare-versions.d.ts +12 -0
  445. package/dist/utils/compare-versions.d.ts.map +1 -0
  446. package/dist/utils/compare-versions.js +86 -0
  447. package/dist/utils/compare-versions.js.map +1 -0
  448. package/dist/utils/file-writer.d.ts +23 -0
  449. package/dist/utils/file-writer.d.ts.map +1 -0
  450. package/dist/utils/file-writer.js +145 -0
  451. package/dist/utils/file-writer.js.map +1 -0
  452. package/dist/utils/posix.d.ts +13 -0
  453. package/dist/utils/posix.d.ts.map +1 -0
  454. package/dist/utils/posix.js +15 -0
  455. package/dist/utils/posix.js.map +1 -0
  456. package/dist/utils/project-detector.d.ts +46 -0
  457. package/dist/utils/project-detector.d.ts.map +1 -0
  458. package/dist/utils/project-detector.js +666 -0
  459. package/dist/utils/project-detector.js.map +1 -0
  460. package/dist/utils/proxy.d.ts +25 -0
  461. package/dist/utils/proxy.d.ts.map +1 -0
  462. package/dist/utils/proxy.js +60 -0
  463. package/dist/utils/proxy.js.map +1 -0
  464. package/dist/utils/task-json.d.ts +46 -0
  465. package/dist/utils/task-json.d.ts.map +1 -0
  466. package/dist/utils/task-json.js +49 -0
  467. package/dist/utils/task-json.js.map +1 -0
  468. package/dist/utils/template-fetcher.d.ts +150 -0
  469. package/dist/utils/template-fetcher.d.ts.map +1 -0
  470. package/dist/utils/template-fetcher.js +907 -0
  471. package/dist/utils/template-fetcher.js.map +1 -0
  472. package/dist/utils/template-hash.d.ts +112 -0
  473. package/dist/utils/template-hash.d.ts.map +1 -0
  474. package/dist/utils/template-hash.js +343 -0
  475. package/dist/utils/template-hash.js.map +1 -0
  476. package/dist/utils/trellis-migrate.d.ts +45 -0
  477. package/dist/utils/trellis-migrate.d.ts.map +1 -0
  478. package/dist/utils/trellis-migrate.js +240 -0
  479. package/dist/utils/trellis-migrate.js.map +1 -0
  480. package/dist/utils/uninstall-scrubbers.d.ts +66 -0
  481. package/dist/utils/uninstall-scrubbers.d.ts.map +1 -0
  482. package/dist/utils/uninstall-scrubbers.js +342 -0
  483. package/dist/utils/uninstall-scrubbers.js.map +1 -0
  484. package/package.json +87 -0
@@ -0,0 +1,532 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Rudder configuration reader.
4
+
5
+ Reads settings from .rudder/config.yaml with sensible defaults.
6
+ """
7
+
8
+ from __future__ import annotations
9
+
10
+ import sys
11
+ from pathlib import Path
12
+
13
+ from .paths import DIR_WORKFLOW, get_repo_root
14
+
15
+
16
+ # =============================================================================
17
+ # YAML Simple Parser (no dependencies)
18
+ # =============================================================================
19
+
20
+
21
+ def _unquote(s: str) -> str:
22
+ """Remove exactly one layer of matching surrounding quotes.
23
+
24
+ Unlike str.strip('"'), this only removes the outermost pair,
25
+ preserving any nested quotes inside the value.
26
+
27
+ Examples:
28
+ _unquote('"hello"') -> 'hello'
29
+ _unquote("'hello'") -> 'hello'
30
+ _unquote('"echo \\'hi\\'"') -> "echo 'hi'"
31
+ _unquote('hello') -> 'hello'
32
+ _unquote('"hello\\'') -> '"hello\\'' (mismatched, unchanged)
33
+ """
34
+ if len(s) >= 2 and s[0] == s[-1] and s[0] in ('"', "'"):
35
+ return s[1:-1]
36
+ return s
37
+
38
+
39
+ def _strip_inline_comment(value: str) -> str:
40
+ """Strip ` # …` inline comments while preserving `#` inside quoted strings.
41
+
42
+ YAML treats ` #` (space-hash) as a comment opener; bare `#` inside a token
43
+ is part of the value. Quoted strings are immune.
44
+
45
+ Mirrors :func:`common.rudder_config._strip_inline_comment` so both
46
+ parsers handle ``key: value # comment`` identically.
47
+ """
48
+ in_quote: str | None = None
49
+ for idx, ch in enumerate(value):
50
+ if in_quote:
51
+ if ch == in_quote:
52
+ in_quote = None
53
+ continue
54
+ if ch in ('"', "'"):
55
+ in_quote = ch
56
+ continue
57
+ if ch == "#" and (idx == 0 or value[idx - 1].isspace()):
58
+ return value[:idx]
59
+ return value
60
+
61
+
62
+ def parse_simple_yaml(content: str) -> dict:
63
+ """Parse simple YAML with nested dict support (no dependencies).
64
+
65
+ Supports:
66
+ - key: value (string)
67
+ - key: (followed by list items)
68
+ - item1
69
+ - item2
70
+ - key: (followed by nested dict)
71
+ nested_key: value
72
+ nested_key2:
73
+ - item
74
+
75
+ Uses indentation to detect nesting (2+ spaces deeper = child).
76
+
77
+ Args:
78
+ content: YAML content string.
79
+
80
+ Returns:
81
+ Parsed dict (values can be str, list[str], or dict).
82
+ """
83
+ lines = content.splitlines()
84
+ result: dict = {}
85
+ _parse_yaml_block(lines, 0, 0, result)
86
+ return result
87
+
88
+
89
+ def _parse_yaml_block(
90
+ lines: list[str], start: int, min_indent: int, target: dict
91
+ ) -> int:
92
+ """Parse a YAML block into target dict, returning next line index."""
93
+ i = start
94
+ current_list: list | None = None
95
+
96
+ while i < len(lines):
97
+ line = lines[i]
98
+ stripped = line.strip()
99
+
100
+ # Skip empty lines and comments
101
+ if not stripped or stripped.startswith("#"):
102
+ i += 1
103
+ continue
104
+
105
+ # Calculate indentation
106
+ indent = len(line) - len(line.lstrip())
107
+
108
+ # If dedented past our block, we're done
109
+ if indent < min_indent:
110
+ break
111
+
112
+ if stripped.startswith("- "):
113
+ if current_list is not None:
114
+ current_list.append(_unquote(stripped[2:].strip()))
115
+ i += 1
116
+ elif ":" in stripped:
117
+ key, _, value = stripped.partition(":")
118
+ key = key.strip()
119
+ value = _strip_inline_comment(value).strip()
120
+ value = _unquote(value)
121
+ current_list = None
122
+
123
+ if value:
124
+ # key: value
125
+ target[key] = value
126
+ i += 1
127
+ else:
128
+ # key: (no value) — peek ahead to determine list vs nested dict
129
+ next_i, next_line = _next_content_line(lines, i + 1)
130
+ if next_i >= len(lines):
131
+ target[key] = {}
132
+ i = next_i
133
+ elif next_line.strip().startswith("- "):
134
+ # It's a list
135
+ current_list = []
136
+ target[key] = current_list
137
+ i += 1
138
+ else:
139
+ next_indent = len(next_line) - len(next_line.lstrip())
140
+ if next_indent > indent:
141
+ # It's a nested dict
142
+ nested: dict = {}
143
+ target[key] = nested
144
+ i = _parse_yaml_block(lines, i + 1, next_indent, nested)
145
+ else:
146
+ # Empty value, same or less indent follows
147
+ target[key] = {}
148
+ i += 1
149
+ else:
150
+ i += 1
151
+
152
+ return i
153
+
154
+
155
+ def _next_content_line(lines: list[str], start: int) -> tuple[int, str]:
156
+ """Find the next non-empty, non-comment line."""
157
+ i = start
158
+ while i < len(lines):
159
+ stripped = lines[i].strip()
160
+ if stripped and not stripped.startswith("#"):
161
+ return i, lines[i]
162
+ i += 1
163
+ return i, ""
164
+
165
+
166
+ # Defaults
167
+ DEFAULT_SESSION_COMMIT_MESSAGE = "chore: record journal"
168
+ DEFAULT_MAX_JOURNAL_LINES = 2000
169
+ DEFAULT_SESSION_AUTO_COMMIT = False # journal / task archive auto-commit
170
+ DEFAULT_CODE_AUTO_COMMIT = False # Phase 3.4 code commit
171
+
172
+ CONFIG_FILE = "config.yaml"
173
+
174
+
175
+ def _is_true_config_value(value: object) -> bool:
176
+ """Return True when a config value represents an enabled flag."""
177
+ if isinstance(value, bool):
178
+ return value
179
+ if isinstance(value, str):
180
+ return value.strip().lower() == "true"
181
+ return False
182
+
183
+
184
+ def _get_config_path(repo_root: Path | None = None) -> Path:
185
+ """Get path to config.yaml."""
186
+ root = repo_root or get_repo_root()
187
+ return root / DIR_WORKFLOW / CONFIG_FILE
188
+
189
+
190
+ def _load_config(repo_root: Path | None = None) -> dict:
191
+ """Load and parse config.yaml. Returns empty dict on any error."""
192
+ config_file = _get_config_path(repo_root)
193
+ try:
194
+ content = config_file.read_text(encoding="utf-8")
195
+ return parse_simple_yaml(content)
196
+ except (OSError, IOError):
197
+ return {}
198
+
199
+
200
+ def get_session_commit_message(repo_root: Path | None = None) -> str:
201
+ """Get the commit message for auto-committing session records."""
202
+ config = _load_config(repo_root)
203
+ return config.get("session_commit_message", DEFAULT_SESSION_COMMIT_MESSAGE)
204
+
205
+
206
+ def get_max_journal_lines(repo_root: Path | None = None) -> int:
207
+ """Get the maximum lines per journal file."""
208
+ config = _load_config(repo_root)
209
+ value = config.get("max_journal_lines", DEFAULT_MAX_JOURNAL_LINES)
210
+ try:
211
+ return int(value)
212
+ except (ValueError, TypeError):
213
+ return DEFAULT_MAX_JOURNAL_LINES
214
+
215
+
216
+ def get_session_auto_commit(repo_root: Path | None = None) -> bool:
217
+ """Whether scripts should auto-stage + auto-commit session/task changes.
218
+
219
+ Governs both ``add_session.py:_auto_commit_workspace`` and
220
+ ``task_store.py:_auto_commit_archive``.
221
+
222
+ Default: ``False`` — files are written to disk; the user manages
223
+ ``git add`` / ``git commit`` themselves.
224
+ Set ``session_auto_commit: true`` in ``.rudder/config.yaml`` to re-enable
225
+ auto-staging.
226
+
227
+ Accepts native YAML booleans (``true`` / ``false``) and the string
228
+ aliases ``true / false / yes / no / 1 / 0 / on / off`` (case-insensitive).
229
+ Invalid values fall back to ``True`` with a stderr warning.
230
+ """
231
+ config = _load_config(repo_root)
232
+ raw = config.get("session_auto_commit", DEFAULT_SESSION_AUTO_COMMIT)
233
+ if isinstance(raw, bool):
234
+ return raw
235
+ s = str(raw).strip().lower()
236
+ if s in ("true", "yes", "1", "on"):
237
+ return True
238
+ if s in ("false", "no", "0", "off"):
239
+ return False
240
+ print(
241
+ f"[WARN] invalid session_auto_commit value: {raw!r}; using false (default)",
242
+ file=sys.stderr,
243
+ )
244
+ return DEFAULT_SESSION_AUTO_COMMIT
245
+
246
+
247
+ def get_code_auto_commit(repo_root: Path | None = None) -> bool:
248
+ """Whether Phase 3.4 should auto-commit code without user confirmation.
249
+
250
+ Default: ``False`` — AI shows ``git diff --stat``, states commit message,
251
+ and asks for user confirmation (Y/n) before committing.
252
+ Set ``code_auto_commit: true`` to skip the confirmation step.
253
+
254
+ Accepts native YAML booleans and the string aliases
255
+ ``true / false / yes / no / 1 / 0 / on / off`` (case-insensitive).
256
+ Invalid values fall back to ``False``.
257
+ """
258
+ config = _load_config(repo_root)
259
+ raw = config.get("code_auto_commit", DEFAULT_CODE_AUTO_COMMIT)
260
+ if isinstance(raw, bool):
261
+ return raw
262
+ s = str(raw).strip().lower()
263
+ if s in ("true", "yes", "1", "on"):
264
+ return True
265
+ if s in ("false", "no", "0", "off"):
266
+ return False
267
+ return DEFAULT_CODE_AUTO_COMMIT
268
+
269
+
270
+ def get_hooks(event: str, repo_root: Path | None = None) -> list[str]:
271
+ """Get hook commands for a lifecycle event.
272
+
273
+ Args:
274
+ event: Event name (e.g. "after_create", "after_archive").
275
+ repo_root: Repository root path.
276
+
277
+ Returns:
278
+ List of shell commands to execute, empty if none configured.
279
+ """
280
+ config = _load_config(repo_root)
281
+ hooks = config.get("hooks")
282
+ if not isinstance(hooks, dict):
283
+ return []
284
+ commands = hooks.get(event)
285
+ if isinstance(commands, list):
286
+ return [str(c) for c in commands]
287
+ return []
288
+
289
+
290
+ # =============================================================================
291
+ # Monorepo / Packages
292
+ # =============================================================================
293
+
294
+
295
+ def get_packages(repo_root: Path | None = None) -> dict[str, dict] | None:
296
+ """Get monorepo package declarations.
297
+
298
+ Returns:
299
+ Dict mapping package name to its config (path, type, etc.),
300
+ or None if not configured (single-repo mode).
301
+
302
+ Example return:
303
+ {"cli": {"path": "packages/cli"}, "docs-site": {"path": "docs-site", "type": "submodule"}}
304
+ """
305
+ config = _load_config(repo_root)
306
+ packages = config.get("packages")
307
+ if not isinstance(packages, dict):
308
+ return None
309
+ # Ensure each value is a dict (filter out scalar entries)
310
+ filtered = {k: v for k, v in packages.items() if isinstance(v, dict)}
311
+ if not filtered:
312
+ return None
313
+ return filtered
314
+
315
+
316
+ def get_default_package(repo_root: Path | None = None) -> str | None:
317
+ """Get the default package name from config.
318
+
319
+ Returns:
320
+ Package name string, or None if not configured.
321
+ """
322
+ config = _load_config(repo_root)
323
+ value = config.get("default_package")
324
+ return str(value) if value else None
325
+
326
+
327
+ def get_submodule_packages(repo_root: Path | None = None) -> dict[str, str]:
328
+ """Get packages that are git submodules.
329
+
330
+ Returns:
331
+ Dict mapping package name to its path for submodule-type packages.
332
+ Empty dict if none configured.
333
+
334
+ Example return:
335
+ {"docs-site": "docs-site"}
336
+ """
337
+ packages = get_packages(repo_root)
338
+ if packages is None:
339
+ return {}
340
+ return {
341
+ name: cfg.get("path", name)
342
+ for name, cfg in packages.items()
343
+ if cfg.get("type") == "submodule"
344
+ }
345
+
346
+
347
+ def get_git_packages(repo_root: Path | None = None) -> dict[str, str]:
348
+ """Get packages that have their own independent git repository.
349
+
350
+ These are sub-directories with their own .git (not submodules),
351
+ marked with ``git: true`` in config.yaml.
352
+
353
+ Returns:
354
+ Dict mapping package name to its path for git-repo packages.
355
+ Empty dict if none configured.
356
+
357
+ Example config::
358
+
359
+ packages:
360
+ backend:
361
+ path: iqs
362
+ git: true
363
+
364
+ Example return::
365
+
366
+ {"backend": "iqs"}
367
+ """
368
+ packages = get_packages(repo_root)
369
+ if packages is None:
370
+ return {}
371
+ return {
372
+ name: cfg.get("path", name)
373
+ for name, cfg in packages.items()
374
+ if _is_true_config_value(cfg.get("git"))
375
+ }
376
+
377
+
378
+ def is_monorepo(repo_root: Path | None = None) -> bool:
379
+ """Check if the project is configured as a monorepo (has packages in config)."""
380
+ return get_packages(repo_root) is not None
381
+
382
+
383
+ def get_spec_base(package: str | None = None, repo_root: Path | None = None) -> str:
384
+ """Get the spec directory base path relative to .rudder/.
385
+
386
+ Single-repo: returns "spec"
387
+ Monorepo with package: returns "spec/<package>"
388
+ Monorepo without package: returns "spec" (caller should specify package)
389
+ """
390
+ if package and is_monorepo(repo_root):
391
+ return f"spec/{package}"
392
+ return "spec"
393
+
394
+
395
+ def validate_package(package: str, repo_root: Path | None = None) -> bool:
396
+ """Check if a package name is valid in this project.
397
+
398
+ Single-repo (no packages configured): always returns True.
399
+ Monorepo: returns True only if package exists in config.yaml packages.
400
+ """
401
+ packages = get_packages(repo_root)
402
+ if packages is None:
403
+ return True # Single-repo, no validation needed
404
+ return package in packages
405
+
406
+
407
+ def resolve_package(
408
+ task_package: str | None = None,
409
+ repo_root: Path | None = None,
410
+ ) -> str | None:
411
+ """Resolve package from inferred sources with validation.
412
+
413
+ Checks in order: task_package → default_package.
414
+ Invalid inferred values print a warning to stderr and are skipped.
415
+
416
+ Returns:
417
+ Resolved package name, or None if no valid package found.
418
+
419
+ Note:
420
+ CLI --package should be validated separately by the caller
421
+ (fail-fast with available packages list on error).
422
+ """
423
+ packages = get_packages(repo_root)
424
+ if packages is None:
425
+ return None # Single-repo, no package needed
426
+
427
+ # Try task_package (guard against non-string values from malformed JSON)
428
+ if task_package and isinstance(task_package, str):
429
+ if task_package in packages:
430
+ return task_package
431
+ print(
432
+ f"Warning: task.json package '{task_package}' not found in config, skipping",
433
+ file=sys.stderr,
434
+ )
435
+
436
+ # Try default_package
437
+ default = get_default_package(repo_root)
438
+ if default:
439
+ if default in packages:
440
+ return default
441
+ print(
442
+ f"Warning: default_package '{default}' not found in config, skipping",
443
+ file=sys.stderr,
444
+ )
445
+
446
+ return None
447
+
448
+
449
+ def get_spec_scope(repo_root: Path | None = None) -> list[str] | str | None:
450
+ """Get session.spec_scope configuration.
451
+
452
+ Returns:
453
+ list[str]: Package names to include in spec scanning.
454
+ str: "active_task" to use current task's package.
455
+ None: No scope configured (scan all packages).
456
+ """
457
+ config = _load_config(repo_root)
458
+ session = config.get("session")
459
+ if not isinstance(session, dict):
460
+ return None
461
+
462
+ scope = session.get("spec_scope")
463
+ if scope is None:
464
+ return None
465
+ if isinstance(scope, str):
466
+ return scope # e.g. "active_task"
467
+ if isinstance(scope, list):
468
+ return [str(s) for s in scope]
469
+ return None
470
+
471
+
472
+ # =============================================================================
473
+ # Tool Path Configuration
474
+ # =============================================================================
475
+
476
+ LOCAL_CONFIG_FILE = "config_local.yml"
477
+
478
+
479
+ def _load_local_config(repo_root: Path | None = None) -> dict:
480
+ """Load .rudder/config_local.yml (personal overrides). Returns {} on missing."""
481
+ root = repo_root or get_repo_root()
482
+ local_config_file = root / DIR_WORKFLOW / LOCAL_CONFIG_FILE
483
+ try:
484
+ content = local_config_file.read_text(encoding="utf-8")
485
+ return parse_simple_yaml(content)
486
+ except (OSError, IOError):
487
+ return {}
488
+
489
+
490
+ def resolve_tools(repo_root: Path | None = None) -> dict[str, dict]:
491
+ """Merge tools from config.yaml with local path overrides from config_local.yml.
492
+
493
+ config_local.yml wins on path; config.yaml declares what tools are needed.
494
+ Tools only in config_local.yml (discovered by AI during sessions) are also included.
495
+ Returns dict like:
496
+ {
497
+ "java": {"path": "/usr/.../java", "version": "21"},
498
+ "mvn": {"path": "/opt/maven/bin/mvn", "version": "3.9"},
499
+ }
500
+ """
501
+ root = repo_root or get_repo_root()
502
+
503
+ # Read required tools from config.yaml
504
+ config = _load_config(root)
505
+ tools = config.get("tools")
506
+ if not isinstance(tools, dict):
507
+ tools = {}
508
+
509
+ # Read personal overrides from config_local.yml
510
+ local = _load_local_config(root)
511
+ local_tools = local.get("tools")
512
+ local_overrides: dict[str, dict] = {}
513
+ if isinstance(local_tools, dict):
514
+ for name, cfg in local_tools.items():
515
+ if isinstance(cfg, dict):
516
+ local_overrides[name] = cfg
517
+
518
+ result: dict[str, dict] = {}
519
+ for name, cfg in tools.items():
520
+ merged: dict = cfg if isinstance(cfg, dict) else {"version": str(cfg)}
521
+ # Personal override wins on path
522
+ if name in local_overrides:
523
+ for k, v in local_overrides[name].items():
524
+ merged[k] = v
525
+ result[name] = merged
526
+
527
+ # Include tools only in config_local.yml (AI-discovered)
528
+ for name, cfg in local_overrides.items():
529
+ if name not in result:
530
+ result[name] = cfg
531
+
532
+ return result