@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,547 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ Add a new session to journal file and update index.md.
5
+
6
+ Usage:
7
+ python3 add_session.py --title "Title" --commit "hash" --summary "Summary" [--package cli]
8
+ python3 add_session.py --title "Title" --branch "feat/my-branch"
9
+
10
+ # Pipe detailed content via stdin (use --stdin to opt in):
11
+ cat << 'EOF' | python3 add_session.py --stdin --title "Title" --summary "Summary"
12
+ <session content here>
13
+ EOF
14
+
15
+ Branch resolution order:
16
+ 1. --branch CLI arg (explicit)
17
+ 2. task.json branch field (from active task)
18
+ 3. git branch --show-current (auto-detect)
19
+ 4. None (omitted gracefully)
20
+ """
21
+
22
+ from __future__ import annotations
23
+
24
+ import argparse
25
+ import re
26
+ import sys
27
+ from datetime import datetime
28
+ from pathlib import Path
29
+
30
+ from common.paths import (
31
+ FILE_JOURNAL_PREFIX,
32
+ get_repo_root,
33
+ get_current_task,
34
+ get_developer,
35
+ get_workspace_dir,
36
+ )
37
+ from common.developer import ensure_developer
38
+ from common.git import run_git
39
+ from common.safe_commit import (
40
+ print_gitignore_warning,
41
+ safe_git_add,
42
+ safe_rudder_paths_to_add,
43
+ )
44
+ from common.tasks import load_task
45
+ from common.config import (
46
+ get_packages,
47
+ get_session_auto_commit,
48
+ get_session_commit_message,
49
+ get_max_journal_lines,
50
+ is_monorepo,
51
+ resolve_package,
52
+ validate_package,
53
+ )
54
+
55
+
56
+ # =============================================================================
57
+ # Helper Functions
58
+ # =============================================================================
59
+
60
+ def get_latest_journal_info(dev_dir: Path) -> tuple[Path | None, int, int]:
61
+ """Get latest journal file info.
62
+
63
+ Returns:
64
+ Tuple of (file_path, file_number, line_count).
65
+ """
66
+ latest_file: Path | None = None
67
+ latest_num = -1
68
+
69
+ for f in dev_dir.glob(f"{FILE_JOURNAL_PREFIX}*.md"):
70
+ if not f.is_file():
71
+ continue
72
+
73
+ match = re.search(r"(\d+)$", f.stem)
74
+ if match:
75
+ num = int(match.group(1))
76
+ if num > latest_num:
77
+ latest_num = num
78
+ latest_file = f
79
+
80
+ if latest_file:
81
+ lines = len(latest_file.read_text(encoding="utf-8").splitlines())
82
+ return latest_file, latest_num, lines
83
+
84
+ return None, 0, 0
85
+
86
+
87
+ def get_current_session(index_file: Path) -> int:
88
+ """Get current session number from index.md."""
89
+ if not index_file.is_file():
90
+ return 0
91
+
92
+ content = index_file.read_text(encoding="utf-8")
93
+ for line in content.splitlines():
94
+ if "Total Sessions" in line:
95
+ match = re.search(r":\s*(\d+)", line)
96
+ if match:
97
+ return int(match.group(1))
98
+ return 0
99
+
100
+
101
+ def _extract_journal_num(filename: str) -> int:
102
+ """Extract journal number from filename for sorting."""
103
+ match = re.search(r"(\d+)", filename)
104
+ return int(match.group(1)) if match else 0
105
+
106
+
107
+ def count_journal_files(dev_dir: Path, active_num: int) -> str:
108
+ """Count journal files and return table rows."""
109
+ active_file = f"{FILE_JOURNAL_PREFIX}{active_num}.md"
110
+ result_lines = []
111
+
112
+ files = sorted(
113
+ [f for f in dev_dir.glob(f"{FILE_JOURNAL_PREFIX}*.md") if f.is_file()],
114
+ key=lambda f: _extract_journal_num(f.stem),
115
+ reverse=True
116
+ )
117
+
118
+ for f in files:
119
+ filename = f.name
120
+ lines = len(f.read_text(encoding="utf-8").splitlines())
121
+ status = "Active" if filename == active_file else "Archived"
122
+ result_lines.append(f"| `{filename}` | ~{lines} | {status} |")
123
+
124
+ return "\n".join(result_lines)
125
+
126
+
127
+ def create_new_journal_file(
128
+ dev_dir: Path, num: int, developer: str, today: str, max_lines: int = 2000,
129
+ ) -> Path:
130
+ """Create a new journal file."""
131
+ prev_num = num - 1
132
+ new_file = dev_dir / f"{FILE_JOURNAL_PREFIX}{num}.md"
133
+
134
+ content = f"""# Journal - {developer} (Part {num})
135
+
136
+ > Continuation from `{FILE_JOURNAL_PREFIX}{prev_num}.md` (archived at ~{max_lines} lines)
137
+ > Started: {today}
138
+
139
+ ---
140
+
141
+ """
142
+ new_file.write_text(content, encoding="utf-8")
143
+ return new_file
144
+
145
+
146
+ def generate_session_content(
147
+ session_num: int,
148
+ title: str,
149
+ commit: str,
150
+ summary: str,
151
+ extra_content: str,
152
+ today: str,
153
+ package: str | None = None,
154
+ branch: str | None = None,
155
+ ) -> str:
156
+ """Generate session content."""
157
+ if commit and commit != "-":
158
+ commit_table = """| Hash | Message |
159
+ |------|---------|"""
160
+ for c in commit.split(","):
161
+ c = c.strip()
162
+ commit_table += f"\n| `{c}` | (see git log) |"
163
+ else:
164
+ commit_table = "(No commits - planning session)"
165
+
166
+ package_line = f"\n**Package**: {package}" if package else ""
167
+ branch_line = f"\n**Branch**: `{branch}`" if branch else ""
168
+
169
+ return f"""
170
+
171
+ ## Session {session_num}: {title}
172
+
173
+ **Date**: {today}
174
+ **Task**: {title}{package_line}{branch_line}
175
+
176
+ ### Summary
177
+
178
+ {summary}
179
+
180
+ ### Main Changes
181
+
182
+ {extra_content}
183
+
184
+ ### Git Commits
185
+
186
+ {commit_table}
187
+
188
+ ### Testing
189
+
190
+ - [OK] (Add test results)
191
+
192
+ ### Status
193
+
194
+ [OK] **Completed**
195
+
196
+ ### Next Steps
197
+
198
+ - None - task complete
199
+ """
200
+
201
+
202
+ def update_index(
203
+ index_file: Path,
204
+ dev_dir: Path,
205
+ title: str,
206
+ commit: str,
207
+ new_session: int,
208
+ active_file: str,
209
+ today: str,
210
+ branch: str | None = None,
211
+ ) -> bool:
212
+ """Update index.md with new session info."""
213
+ # Format commit for display
214
+ commit_display = "-"
215
+ if commit and commit != "-":
216
+ commit_display = re.sub(r"([a-f0-9]{7,})", r"`\1`", commit.replace(",", ", "))
217
+
218
+ # Get file number from active_file name
219
+ match = re.search(r"(\d+)", active_file)
220
+ active_num = int(match.group(1)) if match else 0
221
+ files_table = count_journal_files(dev_dir, active_num)
222
+
223
+ print(f"Updating index.md for session {new_session}...")
224
+ print(f" Title: {title}")
225
+ print(f" Commit: {commit_display}")
226
+ print(f" Active File: {active_file}")
227
+ print()
228
+
229
+ content = index_file.read_text(encoding="utf-8")
230
+
231
+ if "@@@auto:current-status" not in content:
232
+ print("Error: Markers not found in index.md. Please ensure markers exist.", file=sys.stderr)
233
+ return False
234
+
235
+ # Process sections
236
+ lines = content.splitlines()
237
+ new_lines = []
238
+
239
+ in_current_status = False
240
+ in_active_documents = False
241
+ in_session_history = False
242
+ header_written = False
243
+
244
+ for line in lines:
245
+ if "@@@auto:current-status" in line:
246
+ new_lines.append(line)
247
+ in_current_status = True
248
+ new_lines.append(f"- **Active File**: `{active_file}`")
249
+ new_lines.append(f"- **Total Sessions**: {new_session}")
250
+ new_lines.append(f"- **Last Active**: {today}")
251
+ continue
252
+
253
+ if "@@@/auto:current-status" in line:
254
+ in_current_status = False
255
+ new_lines.append(line)
256
+ continue
257
+
258
+ if "@@@auto:active-documents" in line:
259
+ new_lines.append(line)
260
+ in_active_documents = True
261
+ new_lines.append("| File | Lines | Status |")
262
+ new_lines.append("|------|-------|--------|")
263
+ new_lines.append(files_table)
264
+ continue
265
+
266
+ if "@@@/auto:active-documents" in line:
267
+ in_active_documents = False
268
+ new_lines.append(line)
269
+ continue
270
+
271
+ if "@@@auto:session-history" in line:
272
+ new_lines.append(line)
273
+ in_session_history = True
274
+ header_written = False
275
+ continue
276
+
277
+ if "@@@/auto:session-history" in line:
278
+ in_session_history = False
279
+ new_lines.append(line)
280
+ continue
281
+
282
+ if in_current_status:
283
+ continue
284
+
285
+ if in_active_documents:
286
+ continue
287
+
288
+ if in_session_history:
289
+ # Migrate old 4/6-column headers to 5-column Branch-only history.
290
+ if re.match(
291
+ r"^\|\s*#\s*\|\s*Date\s*\|\s*Title\s*\|\s*Commits\s*\|\s*Branch\s*\|\s*Base Branch\s*\|\s*$",
292
+ line,
293
+ ):
294
+ new_lines.append("| # | Date | Title | Commits | Branch |")
295
+ continue
296
+ if re.match(r"^\|\s*#\s*\|\s*Date\s*\|\s*Title\s*\|\s*Commits\s*\|\s*Branch\s*\|\s*$", line):
297
+ new_lines.append("| # | Date | Title | Commits | Branch |")
298
+ continue
299
+ if re.match(r"^\|\s*#\s*\|\s*Date\s*\|\s*Title\s*\|\s*Commits\s*\|\s*$", line):
300
+ new_lines.append("| # | Date | Title | Commits | Branch |")
301
+ continue
302
+ if re.match(r"^\|[-| ]+\|\s*$", line) and not header_written:
303
+ new_lines.append("|---|------|-------|---------|--------|")
304
+ new_lines.append(f"| {new_session} | {today} | {title} | {commit_display} | `{branch or '-'}` |")
305
+ header_written = True
306
+ continue
307
+ new_lines.append(line)
308
+ continue
309
+
310
+ new_lines.append(line)
311
+
312
+ index_file.write_text("\n".join(new_lines), encoding="utf-8")
313
+ print("[OK] Updated index.md successfully!")
314
+ return True
315
+
316
+
317
+ # =============================================================================
318
+ # Main Function
319
+ # =============================================================================
320
+
321
+ def _auto_commit_workspace(repo_root: Path) -> None:
322
+ """Stage Rudder-owned workspace + task paths and commit.
323
+
324
+ Path scope is restricted to specific products (journal files, index.md,
325
+ active task dirs, the archive subtree). We never `git add` the whole
326
+ `.rudder/` tree, and if `.gitignore` blocks the specific paths we
327
+ warn + skip — never retry with ``-f``.
328
+
329
+ Honors ``session_auto_commit`` in ``.rudder/config.yaml``: when set to
330
+ ``false``, this function returns immediately without touching git
331
+ (journal/index files are still written to disk by the caller).
332
+ """
333
+ if not get_session_auto_commit(repo_root):
334
+ print(
335
+ "[OK] session_auto_commit: false — skipping git stage/commit.",
336
+ file=sys.stderr,
337
+ )
338
+ return
339
+
340
+ commit_msg = get_session_commit_message(repo_root)
341
+ paths = safe_rudder_paths_to_add(repo_root)
342
+ if not paths:
343
+ print("[OK] No workspace changes to commit.", file=sys.stderr)
344
+ return
345
+
346
+ success, _, err = safe_git_add(paths, repo_root)
347
+ if not success:
348
+ if err and "ignored by" in err.lower():
349
+ print_gitignore_warning(paths)
350
+ else:
351
+ print(
352
+ f"[WARN] git add failed: {err.strip() if err else 'unknown error'}",
353
+ file=sys.stderr,
354
+ )
355
+ return
356
+
357
+ # Check if there are staged changes for the paths we just staged.
358
+ rc, _, _ = run_git(
359
+ ["diff", "--cached", "--quiet", "--", *paths], cwd=repo_root
360
+ )
361
+ if rc == 0:
362
+ print("[OK] No workspace changes to commit.", file=sys.stderr)
363
+ return
364
+
365
+ rc, _, commit_err = run_git(["commit", "-m", commit_msg], cwd=repo_root)
366
+ if rc == 0:
367
+ print(f"[OK] Auto-committed: {commit_msg}", file=sys.stderr)
368
+ else:
369
+ print(
370
+ f"[WARN] Auto-commit failed: {commit_err.strip()}",
371
+ file=sys.stderr,
372
+ )
373
+
374
+
375
+ def add_session(
376
+ title: str,
377
+ commit: str = "-",
378
+ summary: str = "(Add summary)",
379
+ extra_content: str = "(Add details)",
380
+ auto_commit: bool = True,
381
+ package: str | None = None,
382
+ branch: str | None = None,
383
+ ) -> int:
384
+ """Add a new session."""
385
+ repo_root = get_repo_root()
386
+ ensure_developer(repo_root)
387
+
388
+ developer = get_developer(repo_root)
389
+ if not developer:
390
+ print("Error: Developer not initialized", file=sys.stderr)
391
+ return 1
392
+
393
+ dev_dir = get_workspace_dir(repo_root)
394
+ if not dev_dir:
395
+ print("Error: Workspace directory not found", file=sys.stderr)
396
+ return 1
397
+
398
+ max_lines = get_max_journal_lines(repo_root)
399
+
400
+ index_file = dev_dir / "index.md"
401
+ today = datetime.now().strftime("%Y-%m-%d")
402
+
403
+ journal_file, current_num, current_lines = get_latest_journal_info(dev_dir)
404
+ current_session = get_current_session(index_file)
405
+ new_session = current_session + 1
406
+
407
+ session_content = generate_session_content(
408
+ new_session, title, commit, summary, extra_content, today, package,
409
+ branch,
410
+ )
411
+ content_lines = len(session_content.splitlines())
412
+
413
+ print("========================================", file=sys.stderr)
414
+ print("ADD SESSION", file=sys.stderr)
415
+ print("========================================", file=sys.stderr)
416
+ print("", file=sys.stderr)
417
+ print(f"Session: {new_session}", file=sys.stderr)
418
+ print(f"Title: {title}", file=sys.stderr)
419
+ print(f"Commit: {commit}", file=sys.stderr)
420
+ print("", file=sys.stderr)
421
+ print(f"Current journal file: {FILE_JOURNAL_PREFIX}{current_num}.md", file=sys.stderr)
422
+ print(f"Current lines: {current_lines}", file=sys.stderr)
423
+ print(f"New content lines: {content_lines}", file=sys.stderr)
424
+ print(f"Total after append: {current_lines + content_lines}", file=sys.stderr)
425
+ print("", file=sys.stderr)
426
+
427
+ target_file = journal_file
428
+ target_num = current_num
429
+
430
+ if current_lines + content_lines > max_lines:
431
+ target_num = current_num + 1
432
+ print(f"[!] Exceeds {max_lines} lines, creating {FILE_JOURNAL_PREFIX}{target_num}.md", file=sys.stderr)
433
+ target_file = create_new_journal_file(dev_dir, target_num, developer, today, max_lines)
434
+ print(f"Created: {target_file}", file=sys.stderr)
435
+
436
+ # Append session content
437
+ if target_file:
438
+ with target_file.open("a", encoding="utf-8") as f:
439
+ f.write(session_content)
440
+ print(f"[OK] Appended session to {target_file.name}", file=sys.stderr)
441
+
442
+ print("", file=sys.stderr)
443
+
444
+ # Update index.md
445
+ active_file = f"{FILE_JOURNAL_PREFIX}{target_num}.md"
446
+ if not update_index(
447
+ index_file,
448
+ dev_dir,
449
+ title,
450
+ commit,
451
+ new_session,
452
+ active_file,
453
+ today,
454
+ branch,
455
+ ):
456
+ return 1
457
+
458
+ print("", file=sys.stderr)
459
+ print("========================================", file=sys.stderr)
460
+ print(f"[OK] Session {new_session} added successfully!", file=sys.stderr)
461
+ print("========================================", file=sys.stderr)
462
+ print("", file=sys.stderr)
463
+ print("Files updated:", file=sys.stderr)
464
+ print(f" - {target_file.name if target_file else 'journal'}", file=sys.stderr)
465
+ print(" - index.md", file=sys.stderr)
466
+
467
+ # Auto-commit workspace changes
468
+ if auto_commit:
469
+ print("", file=sys.stderr)
470
+ _auto_commit_workspace(repo_root)
471
+
472
+ return 0
473
+
474
+
475
+ # =============================================================================
476
+ # Main Entry
477
+ # =============================================================================
478
+
479
+ def main() -> int:
480
+ """CLI entry point."""
481
+ parser = argparse.ArgumentParser(
482
+ description="Add a new session to journal file and update index.md"
483
+ )
484
+ parser.add_argument("--title", required=True, help="Session title")
485
+ parser.add_argument("--commit", default="-", help="Comma-separated commit hashes")
486
+ parser.add_argument("--summary", default="(Add summary)", help="Brief summary")
487
+ parser.add_argument("--content-file", help="Path to file with detailed content")
488
+ parser.add_argument("--package", help="Package name tag (e.g., cli, docs-site)")
489
+ parser.add_argument("--branch", help="Branch name (auto-detected if omitted)")
490
+ parser.add_argument("--no-commit", action="store_true",
491
+ help="Skip auto-commit of workspace changes")
492
+ parser.add_argument("--stdin", action="store_true",
493
+ help="Read extra content from stdin (explicit opt-in)")
494
+
495
+ args = parser.parse_args()
496
+
497
+ extra_content = "(Add details)"
498
+ if args.content_file:
499
+ content_path = Path(args.content_file)
500
+ if content_path.is_file():
501
+ extra_content = content_path.read_text(encoding="utf-8")
502
+ elif args.stdin:
503
+ extra_content = sys.stdin.read()
504
+
505
+ # Load active task once — shared by package and branch resolution
506
+ repo_root = get_repo_root()
507
+ current = get_current_task(repo_root)
508
+ task_data = load_task(repo_root / current) if current else None
509
+
510
+ package = args.package
511
+ if package:
512
+ # CLI source: fail-fast in monorepo, ignore in single-repo
513
+ if not is_monorepo(repo_root):
514
+ print("Warning: --package ignored in single-repo project", file=sys.stderr)
515
+ package = None
516
+ elif not validate_package(package, repo_root):
517
+ packages = get_packages(repo_root)
518
+ available = ", ".join(sorted(packages.keys())) if packages else "(none)"
519
+ print(f"Error: unknown package '{package}'. Available: {available}", file=sys.stderr)
520
+ return 1
521
+ else:
522
+ # Inferred: active task's task.json.package → default_package → None
523
+ task_package = task_data.package if task_data else None
524
+ package = resolve_package(task_package, repo_root)
525
+
526
+ # Resolve branch: CLI → task.json → git auto-detect → None
527
+ branch = args.branch
528
+
529
+ if not branch:
530
+ if task_data and task_data.raw.get("branch"):
531
+ branch = task_data.raw["branch"]
532
+ else:
533
+ _, branch_out, _ = run_git(["branch", "--show-current"], cwd=repo_root)
534
+ detected = branch_out.strip()
535
+ if detected:
536
+ branch = detected
537
+
538
+ return add_session(
539
+ args.title, args.commit, args.summary, extra_content,
540
+ auto_commit=not args.no_commit,
541
+ package=package,
542
+ branch=branch,
543
+ )
544
+
545
+
546
+ if __name__ == "__main__":
547
+ sys.exit(main())
@@ -0,0 +1,92 @@
1
+ """
2
+ Common utilities for Rudder workflow scripts.
3
+
4
+ This module provides shared functionality used by other Rudder scripts.
5
+ """
6
+
7
+ import io
8
+ import sys
9
+
10
+ # =============================================================================
11
+ # Windows Encoding Fix (MUST be at top, before any other output)
12
+ # =============================================================================
13
+ # On Windows, stdout defaults to the system code page (often GBK/CP936).
14
+ # This causes UnicodeEncodeError when printing non-ASCII characters.
15
+ #
16
+ # Any script that imports from common will automatically get this fix.
17
+ # =============================================================================
18
+
19
+
20
+ def _configure_stream(stream: object) -> object:
21
+ """Configure a stream for UTF-8 encoding on Windows."""
22
+ # Try reconfigure() first (Python 3.7+, more reliable)
23
+ if hasattr(stream, "reconfigure"):
24
+ stream.reconfigure(encoding="utf-8", errors="replace") # type: ignore[union-attr]
25
+ return stream
26
+ # Fallback: detach and rewrap with TextIOWrapper
27
+ elif hasattr(stream, "detach"):
28
+ return io.TextIOWrapper(
29
+ stream.detach(), # type: ignore[union-attr]
30
+ encoding="utf-8",
31
+ errors="replace",
32
+ )
33
+ return stream
34
+
35
+
36
+ if sys.platform == "win32":
37
+ sys.stdout = _configure_stream(sys.stdout) # type: ignore[assignment]
38
+ sys.stderr = _configure_stream(sys.stderr) # type: ignore[assignment]
39
+ sys.stdin = _configure_stream(sys.stdin) # type: ignore[assignment]
40
+
41
+
42
+ def configure_encoding() -> None:
43
+ """
44
+ Configure stdout/stderr/stdin for UTF-8 encoding on Windows.
45
+
46
+ This is automatically called when importing from common,
47
+ but can be called manually for scripts that don't import common.
48
+
49
+ Safe to call multiple times.
50
+ """
51
+ global sys
52
+ if sys.platform == "win32":
53
+ sys.stdout = _configure_stream(sys.stdout) # type: ignore[assignment]
54
+ sys.stderr = _configure_stream(sys.stderr) # type: ignore[assignment]
55
+ sys.stdin = _configure_stream(sys.stdin) # type: ignore[assignment]
56
+
57
+
58
+ from .paths import (
59
+ DIR_WORKFLOW,
60
+ DIR_WORKSPACE,
61
+ DIR_TASKS,
62
+ DIR_ARCHIVE,
63
+ DIR_SPEC,
64
+ DIR_SCRIPTS,
65
+ FILE_DEVELOPER,
66
+ FILE_CURRENT_TASK,
67
+ FILE_TASK_JSON,
68
+ FILE_JOURNAL_PREFIX,
69
+ get_repo_root,
70
+ get_developer,
71
+ check_developer,
72
+ get_tasks_dir,
73
+ get_workspace_dir,
74
+ get_active_journal_file,
75
+ count_lines,
76
+ get_current_task,
77
+ get_current_task_abs,
78
+ normalize_task_ref,
79
+ resolve_task_ref,
80
+ set_current_task,
81
+ clear_current_task,
82
+ has_current_task,
83
+ generate_task_date_prefix,
84
+ )
85
+
86
+ from .active_task import (
87
+ ActiveTask,
88
+ clear_active_task,
89
+ resolve_active_task,
90
+ resolve_context_key,
91
+ set_active_task,
92
+ )