@ibotor/smart-trellis 0.5.19

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 (520) hide show
  1. package/LICENSE +235 -0
  2. package/README.md +263 -0
  3. package/bin/smart-trellis.js +3 -0
  4. package/bin/trellis.js +3 -0
  5. package/dist/cli/index.d.ts +3 -0
  6. package/dist/cli/index.d.ts.map +1 -0
  7. package/dist/cli/index.js +132 -0
  8. package/dist/cli/index.js.map +1 -0
  9. package/dist/cli/smart.d.ts +2 -0
  10. package/dist/cli/smart.d.ts.map +1 -0
  11. package/dist/cli/smart.js +41 -0
  12. package/dist/cli/smart.js.map +1 -0
  13. package/dist/commands/init.d.ts +56 -0
  14. package/dist/commands/init.d.ts.map +1 -0
  15. package/dist/commands/init.js +1466 -0
  16. package/dist/commands/init.js.map +1 -0
  17. package/dist/commands/smart-init.d.ts +22 -0
  18. package/dist/commands/smart-init.d.ts.map +1 -0
  19. package/dist/commands/smart-init.js +122 -0
  20. package/dist/commands/smart-init.js.map +1 -0
  21. package/dist/commands/uninstall.d.ts +27 -0
  22. package/dist/commands/uninstall.d.ts.map +1 -0
  23. package/dist/commands/uninstall.js +339 -0
  24. package/dist/commands/uninstall.js.map +1 -0
  25. package/dist/commands/update.d.ts +72 -0
  26. package/dist/commands/update.d.ts.map +1 -0
  27. package/dist/commands/update.js +1926 -0
  28. package/dist/commands/update.js.map +1 -0
  29. package/dist/configurators/antigravity.d.ts +7 -0
  30. package/dist/configurators/antigravity.d.ts.map +1 -0
  31. package/dist/configurators/antigravity.js +19 -0
  32. package/dist/configurators/antigravity.js.map +1 -0
  33. package/dist/configurators/claude.d.ts +9 -0
  34. package/dist/configurators/claude.d.ts.map +1 -0
  35. package/dist/configurators/claude.js +72 -0
  36. package/dist/configurators/claude.js.map +1 -0
  37. package/dist/configurators/codebuddy.d.ts +10 -0
  38. package/dist/configurators/codebuddy.d.ts.map +1 -0
  39. package/dist/configurators/codebuddy.js +30 -0
  40. package/dist/configurators/codebuddy.js.map +1 -0
  41. package/dist/configurators/codex.d.ts +8 -0
  42. package/dist/configurators/codex.d.ts.map +1 -0
  43. package/dist/configurators/codex.js +85 -0
  44. package/dist/configurators/codex.js.map +1 -0
  45. package/dist/configurators/copilot.d.ts +10 -0
  46. package/dist/configurators/copilot.d.ts.map +1 -0
  47. package/dist/configurators/copilot.js +51 -0
  48. package/dist/configurators/copilot.js.map +1 -0
  49. package/dist/configurators/cursor.d.ts +10 -0
  50. package/dist/configurators/cursor.d.ts.map +1 -0
  51. package/dist/configurators/cursor.js +29 -0
  52. package/dist/configurators/cursor.js.map +1 -0
  53. package/dist/configurators/droid.d.ts +10 -0
  54. package/dist/configurators/droid.d.ts.map +1 -0
  55. package/dist/configurators/droid.js +30 -0
  56. package/dist/configurators/droid.js.map +1 -0
  57. package/dist/configurators/gemini.d.ts +16 -0
  58. package/dist/configurators/gemini.d.ts.map +1 -0
  59. package/dist/configurators/gemini.js +38 -0
  60. package/dist/configurators/gemini.js.map +1 -0
  61. package/dist/configurators/index.d.ts +65 -0
  62. package/dist/configurators/index.d.ts.map +1 -0
  63. package/dist/configurators/index.js +367 -0
  64. package/dist/configurators/index.js.map +1 -0
  65. package/dist/configurators/kilo.d.ts +7 -0
  66. package/dist/configurators/kilo.d.ts.map +1 -0
  67. package/dist/configurators/kilo.js +19 -0
  68. package/dist/configurators/kilo.js.map +1 -0
  69. package/dist/configurators/kiro.d.ts +8 -0
  70. package/dist/configurators/kiro.d.ts.map +1 -0
  71. package/dist/configurators/kiro.js +24 -0
  72. package/dist/configurators/kiro.js.map +1 -0
  73. package/dist/configurators/opencode.d.ts +14 -0
  74. package/dist/configurators/opencode.d.ts.map +1 -0
  75. package/dist/configurators/opencode.js +96 -0
  76. package/dist/configurators/opencode.js.map +1 -0
  77. package/dist/configurators/pi.d.ts +3 -0
  78. package/dist/configurators/pi.d.ts.map +1 -0
  79. package/dist/configurators/pi.js +45 -0
  80. package/dist/configurators/pi.js.map +1 -0
  81. package/dist/configurators/qoder.d.ts +11 -0
  82. package/dist/configurators/qoder.d.ts.map +1 -0
  83. package/dist/configurators/qoder.js +31 -0
  84. package/dist/configurators/qoder.js.map +1 -0
  85. package/dist/configurators/shared.d.ts +178 -0
  86. package/dist/configurators/shared.d.ts.map +1 -0
  87. package/dist/configurators/shared.js +538 -0
  88. package/dist/configurators/shared.js.map +1 -0
  89. package/dist/configurators/windsurf.d.ts +7 -0
  90. package/dist/configurators/windsurf.d.ts.map +1 -0
  91. package/dist/configurators/windsurf.js +19 -0
  92. package/dist/configurators/windsurf.js.map +1 -0
  93. package/dist/configurators/workflow.d.ts +29 -0
  94. package/dist/configurators/workflow.d.ts.map +1 -0
  95. package/dist/configurators/workflow.js +163 -0
  96. package/dist/configurators/workflow.js.map +1 -0
  97. package/dist/constants/paths.d.ts +70 -0
  98. package/dist/constants/paths.d.ts.map +1 -0
  99. package/dist/constants/paths.js +79 -0
  100. package/dist/constants/paths.js.map +1 -0
  101. package/dist/constants/version.d.ts +9 -0
  102. package/dist/constants/version.d.ts.map +1 -0
  103. package/dist/constants/version.js +15 -0
  104. package/dist/constants/version.js.map +1 -0
  105. package/dist/index.d.ts +10 -0
  106. package/dist/index.d.ts.map +1 -0
  107. package/dist/index.js +10 -0
  108. package/dist/index.js.map +1 -0
  109. package/dist/migrations/index.d.ts +62 -0
  110. package/dist/migrations/index.d.ts.map +1 -0
  111. package/dist/migrations/index.js +187 -0
  112. package/dist/migrations/index.js.map +1 -0
  113. package/dist/migrations/manifests/0.1.9.json +30 -0
  114. package/dist/migrations/manifests/0.2.0.json +49 -0
  115. package/dist/migrations/manifests/0.2.12.json +9 -0
  116. package/dist/migrations/manifests/0.2.13.json +9 -0
  117. package/dist/migrations/manifests/0.2.14.json +175 -0
  118. package/dist/migrations/manifests/0.2.15.json +33 -0
  119. package/dist/migrations/manifests/0.3.0-beta.0.json +297 -0
  120. package/dist/migrations/manifests/0.3.0-beta.1.json +9 -0
  121. package/dist/migrations/manifests/0.3.0-beta.10.json +9 -0
  122. package/dist/migrations/manifests/0.3.0-beta.11.json +9 -0
  123. package/dist/migrations/manifests/0.3.0-beta.12.json +9 -0
  124. package/dist/migrations/manifests/0.3.0-beta.13.json +9 -0
  125. package/dist/migrations/manifests/0.3.0-beta.14.json +9 -0
  126. package/dist/migrations/manifests/0.3.0-beta.15.json +9 -0
  127. package/dist/migrations/manifests/0.3.0-beta.16.json +9 -0
  128. package/dist/migrations/manifests/0.3.0-beta.2.json +9 -0
  129. package/dist/migrations/manifests/0.3.0-beta.3.json +9 -0
  130. package/dist/migrations/manifests/0.3.0-beta.4.json +9 -0
  131. package/dist/migrations/manifests/0.3.0-beta.5.json +9 -0
  132. package/dist/migrations/manifests/0.3.0-beta.6.json +9 -0
  133. package/dist/migrations/manifests/0.3.0-beta.7.json +11 -0
  134. package/dist/migrations/manifests/0.3.0-beta.8.json +9 -0
  135. package/dist/migrations/manifests/0.3.0-beta.9.json +9 -0
  136. package/dist/migrations/manifests/0.3.0-rc.0.json +9 -0
  137. package/dist/migrations/manifests/0.3.0-rc.1.json +9 -0
  138. package/dist/migrations/manifests/0.3.0-rc.2.json +9 -0
  139. package/dist/migrations/manifests/0.3.0-rc.3.json +9 -0
  140. package/dist/migrations/manifests/0.3.0-rc.4.json +9 -0
  141. package/dist/migrations/manifests/0.3.0-rc.5.json +9 -0
  142. package/dist/migrations/manifests/0.3.0-rc.6.json +9 -0
  143. package/dist/migrations/manifests/0.3.0.json +11 -0
  144. package/dist/migrations/manifests/0.3.1.json +9 -0
  145. package/dist/migrations/manifests/0.3.10.json +9 -0
  146. package/dist/migrations/manifests/0.3.2.json +9 -0
  147. package/dist/migrations/manifests/0.3.3.json +9 -0
  148. package/dist/migrations/manifests/0.3.4.json +21 -0
  149. package/dist/migrations/manifests/0.3.5.json +9 -0
  150. package/dist/migrations/manifests/0.3.6.json +9 -0
  151. package/dist/migrations/manifests/0.3.7.json +9 -0
  152. package/dist/migrations/manifests/0.3.8.json +9 -0
  153. package/dist/migrations/manifests/0.3.9.json +9 -0
  154. package/dist/migrations/manifests/0.4.0-beta.1.json +228 -0
  155. package/dist/migrations/manifests/0.4.0-beta.10.json +9 -0
  156. package/dist/migrations/manifests/0.4.0-beta.2.json +9 -0
  157. package/dist/migrations/manifests/0.4.0-beta.3.json +9 -0
  158. package/dist/migrations/manifests/0.4.0-beta.4.json +9 -0
  159. package/dist/migrations/manifests/0.4.0-beta.5.json +9 -0
  160. package/dist/migrations/manifests/0.4.0-beta.6.json +9 -0
  161. package/dist/migrations/manifests/0.4.0-beta.7.json +9 -0
  162. package/dist/migrations/manifests/0.4.0-beta.8.json +34 -0
  163. package/dist/migrations/manifests/0.4.0-beta.9.json +9 -0
  164. package/dist/migrations/manifests/0.4.0-rc.0.json +9 -0
  165. package/dist/migrations/manifests/0.4.0-rc.1.json +9 -0
  166. package/dist/migrations/manifests/0.4.0.json +9 -0
  167. package/dist/migrations/manifests/0.5.0-beta.0.json +1646 -0
  168. package/dist/migrations/manifests/0.5.0-beta.1.json +9 -0
  169. package/dist/migrations/manifests/0.5.0-beta.10.json +9 -0
  170. package/dist/migrations/manifests/0.5.0-beta.11.json +9 -0
  171. package/dist/migrations/manifests/0.5.0-beta.12.json +9 -0
  172. package/dist/migrations/manifests/0.5.0-beta.13.json +9 -0
  173. package/dist/migrations/manifests/0.5.0-beta.14.json +9 -0
  174. package/dist/migrations/manifests/0.5.0-beta.15.json +116 -0
  175. package/dist/migrations/manifests/0.5.0-beta.16.json +9 -0
  176. package/dist/migrations/manifests/0.5.0-beta.17.json +9 -0
  177. package/dist/migrations/manifests/0.5.0-beta.18.json +9 -0
  178. package/dist/migrations/manifests/0.5.0-beta.19.json +9 -0
  179. package/dist/migrations/manifests/0.5.0-beta.2.json +9 -0
  180. package/dist/migrations/manifests/0.5.0-beta.3.json +9 -0
  181. package/dist/migrations/manifests/0.5.0-beta.4.json +9 -0
  182. package/dist/migrations/manifests/0.5.0-beta.5.json +222 -0
  183. package/dist/migrations/manifests/0.5.0-beta.6.json +9 -0
  184. package/dist/migrations/manifests/0.5.0-beta.7.json +9 -0
  185. package/dist/migrations/manifests/0.5.0-beta.8.json +9 -0
  186. package/dist/migrations/manifests/0.5.0-beta.9.json +48 -0
  187. package/dist/migrations/manifests/0.5.0-rc.0.json +9 -0
  188. package/dist/migrations/manifests/0.5.0-rc.1.json +9 -0
  189. package/dist/migrations/manifests/0.5.0-rc.2.json +9 -0
  190. package/dist/migrations/manifests/0.5.0-rc.3.json +9 -0
  191. package/dist/migrations/manifests/0.5.0-rc.4.json +9 -0
  192. package/dist/migrations/manifests/0.5.0-rc.5.json +9 -0
  193. package/dist/migrations/manifests/0.5.0-rc.6.json +9 -0
  194. package/dist/migrations/manifests/0.5.0-rc.7.json +9 -0
  195. package/dist/migrations/manifests/0.5.0.json +9 -0
  196. package/dist/migrations/manifests/0.5.1.json +9 -0
  197. package/dist/migrations/manifests/0.5.10.json +9 -0
  198. package/dist/migrations/manifests/0.5.11.json +16 -0
  199. package/dist/migrations/manifests/0.5.12.json +9 -0
  200. package/dist/migrations/manifests/0.5.13.json +9 -0
  201. package/dist/migrations/manifests/0.5.14.json +9 -0
  202. package/dist/migrations/manifests/0.5.15.json +9 -0
  203. package/dist/migrations/manifests/0.5.16.json +9 -0
  204. package/dist/migrations/manifests/0.5.17.json +9 -0
  205. package/dist/migrations/manifests/0.5.18.json +9 -0
  206. package/dist/migrations/manifests/0.5.19.json +9 -0
  207. package/dist/migrations/manifests/0.5.2.json +9 -0
  208. package/dist/migrations/manifests/0.5.3.json +9 -0
  209. package/dist/migrations/manifests/0.5.4.json +9 -0
  210. package/dist/migrations/manifests/0.5.5.json +9 -0
  211. package/dist/migrations/manifests/0.5.6.json +9 -0
  212. package/dist/migrations/manifests/0.5.7.json +16 -0
  213. package/dist/migrations/manifests/0.5.8.json +9 -0
  214. package/dist/migrations/manifests/0.5.9.json +9 -0
  215. package/dist/migrations/manifests/0.6.0-beta.0.json +16 -0
  216. package/dist/migrations/manifests/0.6.0-beta.1.json +9 -0
  217. package/dist/migrations/manifests/0.6.0-beta.10.json +9 -0
  218. package/dist/migrations/manifests/0.6.0-beta.11.json +9 -0
  219. package/dist/migrations/manifests/0.6.0-beta.12.json +9 -0
  220. package/dist/migrations/manifests/0.6.0-beta.13.json +9 -0
  221. package/dist/migrations/manifests/0.6.0-beta.14.json +9 -0
  222. package/dist/migrations/manifests/0.6.0-beta.15.json +9 -0
  223. package/dist/migrations/manifests/0.6.0-beta.16.json +9 -0
  224. package/dist/migrations/manifests/0.6.0-beta.17.json +9 -0
  225. package/dist/migrations/manifests/0.6.0-beta.18.json +16 -0
  226. package/dist/migrations/manifests/0.6.0-beta.19.json +9 -0
  227. package/dist/migrations/manifests/0.6.0-beta.2.json +9 -0
  228. package/dist/migrations/manifests/0.6.0-beta.20.json +9 -0
  229. package/dist/migrations/manifests/0.6.0-beta.21.json +9 -0
  230. package/dist/migrations/manifests/0.6.0-beta.3.json +9 -0
  231. package/dist/migrations/manifests/0.6.0-beta.4.json +9 -0
  232. package/dist/migrations/manifests/0.6.0-beta.5.json +9 -0
  233. package/dist/migrations/manifests/0.6.0-beta.6.json +16 -0
  234. package/dist/migrations/manifests/0.6.0-beta.7.json +9 -0
  235. package/dist/migrations/manifests/0.6.0-beta.8.json +9 -0
  236. package/dist/migrations/manifests/0.6.0-beta.9.json +9 -0
  237. package/dist/templates/claude/agents/trellis-check.md +109 -0
  238. package/dist/templates/claude/agents/trellis-implement.md +109 -0
  239. package/dist/templates/claude/agents/trellis-research.md +137 -0
  240. package/dist/templates/claude/index.d.ts +22 -0
  241. package/dist/templates/claude/index.d.ts.map +1 -0
  242. package/dist/templates/claude/index.js +46 -0
  243. package/dist/templates/claude/index.js.map +1 -0
  244. package/dist/templates/claude/settings.json +73 -0
  245. package/dist/templates/codebuddy/agents/trellis-check.md +109 -0
  246. package/dist/templates/codebuddy/agents/trellis-implement.md +109 -0
  247. package/dist/templates/codebuddy/agents/trellis-research.md +137 -0
  248. package/dist/templates/codebuddy/index.d.ts +15 -0
  249. package/dist/templates/codebuddy/index.d.ts.map +1 -0
  250. package/dist/templates/codebuddy/index.js +15 -0
  251. package/dist/templates/codebuddy/index.js.map +1 -0
  252. package/dist/templates/codebuddy/settings.json +59 -0
  253. package/dist/templates/codex/agents/trellis-check.toml +84 -0
  254. package/dist/templates/codex/agents/trellis-implement.toml +65 -0
  255. package/dist/templates/codex/agents/trellis-research.toml +73 -0
  256. package/dist/templates/codex/config.toml +28 -0
  257. package/dist/templates/codex/hooks/session-start.py +481 -0
  258. package/dist/templates/codex/hooks.json +15 -0
  259. package/dist/templates/codex/index.d.ts +39 -0
  260. package/dist/templates/codex/index.d.ts.map +1 -0
  261. package/dist/templates/codex/index.js +85 -0
  262. package/dist/templates/codex/index.js.map +1 -0
  263. package/dist/templates/codex/skills/before-dev/SKILL.md +34 -0
  264. package/dist/templates/codex/skills/brainstorm/SKILL.md +500 -0
  265. package/dist/templates/codex/skills/break-loop/SKILL.md +130 -0
  266. package/dist/templates/codex/skills/check/SKILL.md +30 -0
  267. package/dist/templates/codex/skills/check-cross-layer/SKILL.md +158 -0
  268. package/dist/templates/codex/skills/create-command/SKILL.md +101 -0
  269. package/dist/templates/codex/skills/finish-work/SKILL.md +90 -0
  270. package/dist/templates/codex/skills/improve-ut/SKILL.md +69 -0
  271. package/dist/templates/codex/skills/integrate-skill/SKILL.md +221 -0
  272. package/dist/templates/codex/skills/onboard/SKILL.md +363 -0
  273. package/dist/templates/codex/skills/record-session/SKILL.md +67 -0
  274. package/dist/templates/codex/skills/start/SKILL.md +354 -0
  275. package/dist/templates/codex/skills/update-spec/SKILL.md +335 -0
  276. package/dist/templates/common/bundled-skills/trellis-meta/SKILL.md +73 -0
  277. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/add-project-local-conventions.md +83 -0
  278. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-agents.md +54 -0
  279. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-context-loading.md +81 -0
  280. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-hooks.md +57 -0
  281. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-skills-or-commands.md +78 -0
  282. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-spec-structure.md +83 -0
  283. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-task-lifecycle.md +90 -0
  284. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-workflow.md +64 -0
  285. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/overview.md +55 -0
  286. package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/context-injection.md +68 -0
  287. package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/generated-files.md +80 -0
  288. package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/overview.md +51 -0
  289. package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/spec-system.md +102 -0
  290. package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/task-system.md +101 -0
  291. package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/workflow.md +75 -0
  292. package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/workspace-memory.md +71 -0
  293. package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/agents.md +79 -0
  294. package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/hooks-and-settings.md +69 -0
  295. package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/overview.md +59 -0
  296. package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/platform-map.md +74 -0
  297. package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/skills-and-commands.md +83 -0
  298. package/dist/templates/common/bundled-skills/trellis-spec-bootstarp/SKILL.md +41 -0
  299. package/dist/templates/common/bundled-skills/trellis-spec-bootstarp/references/mcp-setup.md +90 -0
  300. package/dist/templates/common/bundled-skills/trellis-spec-bootstarp/references/repository-analysis.md +59 -0
  301. package/dist/templates/common/bundled-skills/trellis-spec-bootstarp/references/spec-task-planning.md +61 -0
  302. package/dist/templates/common/bundled-skills/trellis-spec-bootstarp/references/spec-writing.md +70 -0
  303. package/dist/templates/common/commands/continue.md +55 -0
  304. package/dist/templates/common/commands/finish-work.md +66 -0
  305. package/dist/templates/common/commands/start.md +58 -0
  306. package/dist/templates/common/index.d.ts +48 -0
  307. package/dist/templates/common/index.d.ts.map +1 -0
  308. package/dist/templates/common/index.js +104 -0
  309. package/dist/templates/common/index.js.map +1 -0
  310. package/dist/templates/common/skills/before-dev.md +29 -0
  311. package/dist/templates/common/skills/brainstorm.md +543 -0
  312. package/dist/templates/common/skills/break-loop.md +125 -0
  313. package/dist/templates/common/skills/check.md +87 -0
  314. package/dist/templates/common/skills/update-spec.md +351 -0
  315. package/dist/templates/copilot/hooks/session-start.py +454 -0
  316. package/dist/templates/copilot/hooks.json +19 -0
  317. package/dist/templates/copilot/index.d.ts +23 -0
  318. package/dist/templates/copilot/index.d.ts.map +1 -0
  319. package/dist/templates/copilot/index.js +54 -0
  320. package/dist/templates/copilot/index.js.map +1 -0
  321. package/dist/templates/copilot/prompts/before-dev.prompt.md +33 -0
  322. package/dist/templates/copilot/prompts/brainstorm.prompt.md +499 -0
  323. package/dist/templates/copilot/prompts/break-loop.prompt.md +129 -0
  324. package/dist/templates/copilot/prompts/check-cross-layer.prompt.md +157 -0
  325. package/dist/templates/copilot/prompts/check.prompt.md +29 -0
  326. package/dist/templates/copilot/prompts/create-command.prompt.md +116 -0
  327. package/dist/templates/copilot/prompts/finish-work.prompt.md +99 -0
  328. package/dist/templates/copilot/prompts/integrate-skill.prompt.md +223 -0
  329. package/dist/templates/copilot/prompts/onboard.prompt.md +362 -0
  330. package/dist/templates/copilot/prompts/parallel.prompt.md +196 -0
  331. package/dist/templates/copilot/prompts/record-session.prompt.md +66 -0
  332. package/dist/templates/copilot/prompts/start.prompt.md +397 -0
  333. package/dist/templates/copilot/prompts/update-spec.prompt.md +358 -0
  334. package/dist/templates/cursor/agents/trellis-check.md +108 -0
  335. package/dist/templates/cursor/agents/trellis-implement.md +108 -0
  336. package/dist/templates/cursor/agents/trellis-research.md +136 -0
  337. package/dist/templates/cursor/hooks.json +24 -0
  338. package/dist/templates/cursor/index.d.ts +13 -0
  339. package/dist/templates/cursor/index.d.ts.map +1 -0
  340. package/dist/templates/cursor/index.js +13 -0
  341. package/dist/templates/cursor/index.js.map +1 -0
  342. package/dist/templates/droid/droids/trellis-check.md +101 -0
  343. package/dist/templates/droid/droids/trellis-implement.md +101 -0
  344. package/dist/templates/droid/droids/trellis-research.md +137 -0
  345. package/dist/templates/droid/index.d.ts +15 -0
  346. package/dist/templates/droid/index.d.ts.map +1 -0
  347. package/dist/templates/droid/index.js +15 -0
  348. package/dist/templates/droid/index.js.map +1 -0
  349. package/dist/templates/droid/settings.json +59 -0
  350. package/dist/templates/extract.d.ts +40 -0
  351. package/dist/templates/extract.d.ts.map +1 -0
  352. package/dist/templates/extract.js +106 -0
  353. package/dist/templates/extract.js.map +1 -0
  354. package/dist/templates/gemini/agents/trellis-check.md +101 -0
  355. package/dist/templates/gemini/agents/trellis-implement.md +101 -0
  356. package/dist/templates/gemini/agents/trellis-research.md +136 -0
  357. package/dist/templates/gemini/index.d.ts +13 -0
  358. package/dist/templates/gemini/index.d.ts.map +1 -0
  359. package/dist/templates/gemini/index.js +13 -0
  360. package/dist/templates/gemini/index.js.map +1 -0
  361. package/dist/templates/gemini/settings.json +28 -0
  362. package/dist/templates/kiro/agents/trellis-check.json +26 -0
  363. package/dist/templates/kiro/agents/trellis-implement.json +26 -0
  364. package/dist/templates/kiro/agents/trellis-research.json +30 -0
  365. package/dist/templates/kiro/index.d.ts +18 -0
  366. package/dist/templates/kiro/index.d.ts.map +1 -0
  367. package/dist/templates/kiro/index.js +18 -0
  368. package/dist/templates/kiro/index.js.map +1 -0
  369. package/dist/templates/markdown/agents.md +21 -0
  370. package/dist/templates/markdown/gitignore.txt +15 -0
  371. package/dist/templates/markdown/index.d.ts +27 -0
  372. package/dist/templates/markdown/index.d.ts.map +1 -0
  373. package/dist/templates/markdown/index.js +52 -0
  374. package/dist/templates/markdown/index.js.map +1 -0
  375. package/dist/templates/markdown/spec/backend/database-guidelines.md.txt +51 -0
  376. package/dist/templates/markdown/spec/backend/directory-structure.md.txt +54 -0
  377. package/dist/templates/markdown/spec/backend/error-handling.md.txt +51 -0
  378. package/dist/templates/markdown/spec/backend/index.md.txt +38 -0
  379. package/dist/templates/markdown/spec/backend/logging-guidelines.md.txt +51 -0
  380. package/dist/templates/markdown/spec/backend/quality-guidelines.md.txt +51 -0
  381. package/dist/templates/markdown/spec/frontend/component-guidelines.md.txt +59 -0
  382. package/dist/templates/markdown/spec/frontend/directory-structure.md.txt +54 -0
  383. package/dist/templates/markdown/spec/frontend/hook-guidelines.md.txt +51 -0
  384. package/dist/templates/markdown/spec/frontend/index.md.txt +39 -0
  385. package/dist/templates/markdown/spec/frontend/quality-guidelines.md.txt +51 -0
  386. package/dist/templates/markdown/spec/frontend/state-management.md.txt +51 -0
  387. package/dist/templates/markdown/spec/frontend/type-safety.md.txt +51 -0
  388. package/dist/templates/markdown/spec/guides/code-reuse-thinking-guide.md.txt +105 -0
  389. package/dist/templates/markdown/spec/guides/cross-layer-thinking-guide.md.txt +162 -0
  390. package/dist/templates/markdown/spec/guides/cross-platform-thinking-guide.md.txt +595 -0
  391. package/dist/templates/markdown/spec/guides/index.md.txt +79 -0
  392. package/dist/templates/markdown/workspace-index.md +125 -0
  393. package/dist/templates/markdown/worktree.yaml.txt +58 -0
  394. package/dist/templates/opencode/agents/trellis-check.md +116 -0
  395. package/dist/templates/opencode/agents/trellis-implement.md +117 -0
  396. package/dist/templates/opencode/agents/trellis-research.md +145 -0
  397. package/dist/templates/opencode/lib/session-utils.js +432 -0
  398. package/dist/templates/opencode/lib/trellis-context.js +381 -0
  399. package/dist/templates/opencode/package.json +5 -0
  400. package/dist/templates/opencode/plugins/inject-subagent-context.js +497 -0
  401. package/dist/templates/opencode/plugins/inject-workflow-state.js +162 -0
  402. package/dist/templates/opencode/plugins/session-start.js +101 -0
  403. package/dist/templates/pi/agents/trellis-check.md +36 -0
  404. package/dist/templates/pi/agents/trellis-implement.md +41 -0
  405. package/dist/templates/pi/agents/trellis-research.md +25 -0
  406. package/dist/templates/pi/extensions/trellis/index.ts.txt +1172 -0
  407. package/dist/templates/pi/index.d.ts +5 -0
  408. package/dist/templates/pi/index.d.ts.map +1 -0
  409. package/dist/templates/pi/index.js +12 -0
  410. package/dist/templates/pi/index.js.map +1 -0
  411. package/dist/templates/pi/settings.json +21 -0
  412. package/dist/templates/qoder/agents/trellis-check.md +102 -0
  413. package/dist/templates/qoder/agents/trellis-implement.md +102 -0
  414. package/dist/templates/qoder/agents/trellis-research.md +137 -0
  415. package/dist/templates/qoder/index.d.ts +15 -0
  416. package/dist/templates/qoder/index.d.ts.map +1 -0
  417. package/dist/templates/qoder/index.js +15 -0
  418. package/dist/templates/qoder/index.js.map +1 -0
  419. package/dist/templates/qoder/settings.json +47 -0
  420. package/dist/templates/shared-hooks/index.d.ts +50 -0
  421. package/dist/templates/shared-hooks/index.d.ts.map +1 -0
  422. package/dist/templates/shared-hooks/index.js +88 -0
  423. package/dist/templates/shared-hooks/index.js.map +1 -0
  424. package/dist/templates/shared-hooks/inject-shell-session-context.py +183 -0
  425. package/dist/templates/shared-hooks/inject-subagent-context.py +749 -0
  426. package/dist/templates/shared-hooks/inject-workflow-state.py +387 -0
  427. package/dist/templates/shared-hooks/session-start.py +797 -0
  428. package/dist/templates/template-utils.d.ts +26 -0
  429. package/dist/templates/template-utils.d.ts.map +1 -0
  430. package/dist/templates/template-utils.js +60 -0
  431. package/dist/templates/template-utils.js.map +1 -0
  432. package/dist/templates/trellis/config.yaml +90 -0
  433. package/dist/templates/trellis/gitignore.txt +32 -0
  434. package/dist/templates/trellis/index.d.ts +52 -0
  435. package/dist/templates/trellis/index.d.ts.map +1 -0
  436. package/dist/templates/trellis/index.js +97 -0
  437. package/dist/templates/trellis/index.js.map +1 -0
  438. package/dist/templates/trellis/scripts/__init__.py +5 -0
  439. package/dist/templates/trellis/scripts/add_session.py +547 -0
  440. package/dist/templates/trellis/scripts/common/__init__.py +92 -0
  441. package/dist/templates/trellis/scripts/common/active_task.py +626 -0
  442. package/dist/templates/trellis/scripts/common/cli_adapter.py +811 -0
  443. package/dist/templates/trellis/scripts/common/config.py +445 -0
  444. package/dist/templates/trellis/scripts/common/developer.py +190 -0
  445. package/dist/templates/trellis/scripts/common/git.py +31 -0
  446. package/dist/templates/trellis/scripts/common/git_context.py +106 -0
  447. package/dist/templates/trellis/scripts/common/io.py +37 -0
  448. package/dist/templates/trellis/scripts/common/log.py +45 -0
  449. package/dist/templates/trellis/scripts/common/packages_context.py +238 -0
  450. package/dist/templates/trellis/scripts/common/paths.py +447 -0
  451. package/dist/templates/trellis/scripts/common/safe_commit.py +285 -0
  452. package/dist/templates/trellis/scripts/common/session_context.py +821 -0
  453. package/dist/templates/trellis/scripts/common/task_context.py +223 -0
  454. package/dist/templates/trellis/scripts/common/task_queue.py +188 -0
  455. package/dist/templates/trellis/scripts/common/task_store.py +697 -0
  456. package/dist/templates/trellis/scripts/common/task_utils.py +274 -0
  457. package/dist/templates/trellis/scripts/common/tasks.py +112 -0
  458. package/dist/templates/trellis/scripts/common/trellis_config.py +131 -0
  459. package/dist/templates/trellis/scripts/common/types.py +110 -0
  460. package/dist/templates/trellis/scripts/common/workflow_phase.py +215 -0
  461. package/dist/templates/trellis/scripts/get_context.py +16 -0
  462. package/dist/templates/trellis/scripts/get_developer.py +26 -0
  463. package/dist/templates/trellis/scripts/hooks/linear_sync.py +243 -0
  464. package/dist/templates/trellis/scripts/init_developer.py +51 -0
  465. package/dist/templates/trellis/scripts/task.py +500 -0
  466. package/dist/templates/trellis/tasks/.gitkeep +0 -0
  467. package/dist/templates/trellis/workflow.md +690 -0
  468. package/dist/types/ai-tools.d.ts +95 -0
  469. package/dist/types/ai-tools.d.ts.map +1 -0
  470. package/dist/types/ai-tools.js +280 -0
  471. package/dist/types/ai-tools.js.map +1 -0
  472. package/dist/types/migration.d.ts +125 -0
  473. package/dist/types/migration.d.ts.map +1 -0
  474. package/dist/types/migration.js +8 -0
  475. package/dist/types/migration.js.map +1 -0
  476. package/dist/utils/compare-versions.d.ts +12 -0
  477. package/dist/utils/compare-versions.d.ts.map +1 -0
  478. package/dist/utils/compare-versions.js +86 -0
  479. package/dist/utils/compare-versions.js.map +1 -0
  480. package/dist/utils/cwd-guard.d.ts +38 -0
  481. package/dist/utils/cwd-guard.d.ts.map +1 -0
  482. package/dist/utils/cwd-guard.js +62 -0
  483. package/dist/utils/cwd-guard.js.map +1 -0
  484. package/dist/utils/file-writer.d.ts +36 -0
  485. package/dist/utils/file-writer.d.ts.map +1 -0
  486. package/dist/utils/file-writer.js +203 -0
  487. package/dist/utils/file-writer.js.map +1 -0
  488. package/dist/utils/manifest-prune.d.ts +61 -0
  489. package/dist/utils/manifest-prune.d.ts.map +1 -0
  490. package/dist/utils/manifest-prune.js +136 -0
  491. package/dist/utils/manifest-prune.js.map +1 -0
  492. package/dist/utils/posix.d.ts +13 -0
  493. package/dist/utils/posix.d.ts.map +1 -0
  494. package/dist/utils/posix.js +15 -0
  495. package/dist/utils/posix.js.map +1 -0
  496. package/dist/utils/project-detector.d.ts +46 -0
  497. package/dist/utils/project-detector.d.ts.map +1 -0
  498. package/dist/utils/project-detector.js +666 -0
  499. package/dist/utils/project-detector.js.map +1 -0
  500. package/dist/utils/proxy.d.ts +25 -0
  501. package/dist/utils/proxy.d.ts.map +1 -0
  502. package/dist/utils/proxy.js +60 -0
  503. package/dist/utils/proxy.js.map +1 -0
  504. package/dist/utils/task-json.d.ts +46 -0
  505. package/dist/utils/task-json.d.ts.map +1 -0
  506. package/dist/utils/task-json.js +49 -0
  507. package/dist/utils/task-json.js.map +1 -0
  508. package/dist/utils/template-fetcher.d.ts +150 -0
  509. package/dist/utils/template-fetcher.d.ts.map +1 -0
  510. package/dist/utils/template-fetcher.js +907 -0
  511. package/dist/utils/template-fetcher.js.map +1 -0
  512. package/dist/utils/template-hash.d.ts +123 -0
  513. package/dist/utils/template-hash.d.ts.map +1 -0
  514. package/dist/utils/template-hash.js +334 -0
  515. package/dist/utils/template-hash.js.map +1 -0
  516. package/dist/utils/uninstall-scrubbers.d.ts +66 -0
  517. package/dist/utils/uninstall-scrubbers.d.ts.map +1 -0
  518. package/dist/utils/uninstall-scrubbers.js +342 -0
  519. package/dist/utils/uninstall-scrubbers.js.map +1 -0
  520. package/package.json +89 -0
@@ -0,0 +1,28 @@
1
+ # Project-scoped Codex defaults for Trellis workflows.
2
+ # Codex merges this layer after the user-level config when the project
3
+ # is marked as a trusted project. To trust this project, add it under
4
+ # `[projects]` in ~/.codex/config.toml, e.g.:
5
+ #
6
+ # [projects."/abs/path/to/this/repo"]
7
+ # trust_level = "trusted"
8
+
9
+ # Keep AGENTS.md as the primary project instruction file.
10
+ project_doc_fallback_filenames = ["AGENTS.md"]
11
+
12
+ # Codex hooks (`hooks.json` in this directory) only fire when the user
13
+ # has enabled them in their USER-level config: `[features].hooks = true`
14
+ # in ~/.codex/config.toml (Codex 0.129+; legacy name: `codex_hooks = true`,
15
+ # still works but emits a deprecation warning on 0.129+). Project-level
16
+ # config.toml cannot set feature flags; they must be user-level.
17
+ # Codex 0.129+ additionally gates each installed hook behind a one-time
18
+ # `/hooks` TUI review; until the user approves it, the hook stays inactive.
19
+
20
+ # NOTE: Trellis intentionally does NOT write a [features.multi_agent_v2]
21
+ # block here. Codex CLI changed `features` deserialization between 0.130
22
+ # and 0.131: the structured table form (with max_concurrent_threads_per_session
23
+ # / *_wait_timeout_ms) is only accepted by 0.131+. On 0.130 and earlier —
24
+ # including the codex CLI bundled inside the Codex desktop app — it fails
25
+ # with `data did not match any variant of untagged enum FeatureToml`, which
26
+ # aborts the entire config load and blocks Codex from starting. Codex's own
27
+ # default for multi_agent_v2 is used instead; tune it in your user-level
28
+ # config if needed.
@@ -0,0 +1,481 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ Codex Session Start Hook - Inject Trellis context into Codex sessions.
5
+
6
+ Output format follows Codex hook protocol:
7
+ stdout JSON → { hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: "..." } }
8
+ """
9
+
10
+ from __future__ import annotations
11
+
12
+ import json
13
+ import os
14
+ import re
15
+ import subprocess
16
+ import sys
17
+ import warnings
18
+ from io import StringIO
19
+ from pathlib import Path
20
+
21
+ # Force UTF-8 on stdin/stdout/stderr on Windows. Default codepage there is
22
+ # cp936 / cp1252 / etc. — non-ASCII content (Chinese task names, prd snippets)
23
+ # both in stdin (hook payload from host CLI) and stdout (our emitted blocks)
24
+ # raises UnicodeDecodeError / UnicodeEncodeError. Equivalent to `python -X utf8`
25
+ # but applied per-stream so we don't depend on host CLI's command wiring.
26
+ if sys.platform.startswith("win"):
27
+ import io as _io
28
+ for _stream_name in ("stdin", "stdout", "stderr"):
29
+ _stream = getattr(sys, _stream_name, None)
30
+ if _stream is None:
31
+ continue
32
+ if hasattr(_stream, "reconfigure"):
33
+ try:
34
+ _stream.reconfigure(encoding="utf-8", errors="replace") # type: ignore[union-attr]
35
+ except Exception:
36
+ pass
37
+ elif hasattr(_stream, "detach"):
38
+ try:
39
+ setattr(sys, _stream_name, _io.TextIOWrapper(_stream.detach(), encoding="utf-8", errors="replace"))
40
+ except Exception:
41
+ pass
42
+
43
+
44
+ def _normalize_windows_shell_path(path_str: str) -> str:
45
+ """Normalize Unix-style shell paths to real Windows paths.
46
+
47
+ On Windows, shells like Git Bash / MSYS2 / Cygwin may report paths like
48
+ `/d/Users/...` or `/cygdrive/d/Users/...`. `Path.resolve()` will misinterpret
49
+ these as `D:/d/Users...` on drive D: (or similar), breaking repo root
50
+ detection.
51
+
52
+ This function is intentionally conservative: it only rewrites patterns that
53
+ unambiguously represent a drive letter mount.
54
+ """
55
+ if not isinstance(path_str, str) or not path_str:
56
+ return path_str
57
+
58
+ # Only relevant on Windows; keep other platforms untouched.
59
+ if not sys.platform.startswith("win"):
60
+ return path_str
61
+
62
+ p = path_str.strip()
63
+
64
+ # Already a Windows drive path (C:\... or C:/...)
65
+ if re.match(r"^[A-Za-z]:[\/]", p):
66
+ return p
67
+
68
+ # MSYS/Git-Bash style: /c/Users/... or /d/Work/...
69
+ m = re.match(r"^/([A-Za-z])/(.*)", p)
70
+ if m:
71
+ drive, rest = m.group(1).upper(), m.group(2)
72
+ rest = rest.replace('/', '\\')
73
+ return f"{drive}:\\{rest}"
74
+
75
+ # Cygwin style: /cygdrive/c/Users/...
76
+ m = re.match(r"^/cygdrive/([A-Za-z])/(.*)", p)
77
+ if m:
78
+ drive, rest = m.group(1).upper(), m.group(2)
79
+ rest = rest.replace('/', '\\')
80
+ return f"{drive}:\\{rest}"
81
+
82
+ # WSL mounted drive (sometimes leaked into env): /mnt/c/Users/...
83
+ m = re.match(r"^/mnt/([A-Za-z])/(.*)", p)
84
+ if m:
85
+ drive, rest = m.group(1).upper(), m.group(2)
86
+ rest = rest.replace('/', '\\')
87
+ return f"{drive}:\\{rest}"
88
+
89
+ return path_str
90
+
91
+
92
+ warnings.filterwarnings("ignore")
93
+
94
+ FIRST_REPLY_NOTICE = """<first-reply-notice>
95
+ On the first visible assistant reply in this session, begin with exactly one short Chinese sentence:
96
+ Trellis SessionStart 已注入:workflow、当前任务状态、开发者身份、git 状态、active tasks、spec 索引已加载。
97
+ Then continue directly with the user's request. This notice is one-shot: do not repeat it after the first assistant reply in the same session.
98
+ </first-reply-notice>"""
99
+
100
+ SUB_AGENT_NOTICE = """<sub-agent-notice>
101
+ SUB-AGENT NOTICE - READ FIRST IF SPAWNED VIA spawn_agent
102
+
103
+ If your parent session spawned you via spawn_agent with an explicit task
104
+ message above this hook output, that message is your only job.
105
+ - Execute the parent message exactly as written, then return.
106
+ - Ignore all Trellis workflow guidance below this notice.
107
+ - Do NOT call task.py start, task.py add-context, or task.py archive.
108
+ - Do NOT call wait_agent or spawn_agent.
109
+ - Do NOT modify .trellis/tasks/* or any other file unless the parent message
110
+ explicitly asks for that.
111
+
112
+ If you are the main interactive Codex session and the user is typing at the
113
+ terminal with no parent agent, use the workflow guidance below normally.
114
+ </sub-agent-notice>"""
115
+
116
+
117
+ def should_skip_injection() -> bool:
118
+ if os.environ.get("TRELLIS_HOOKS") == "0":
119
+ return True
120
+ if os.environ.get("TRELLIS_DISABLE_HOOKS") == "1":
121
+ return True
122
+ return os.environ.get("CODEX_NON_INTERACTIVE") == "1"
123
+
124
+
125
+ def configure_project_encoding(project_dir: Path) -> None:
126
+ """Reuse Trellis' shared Windows stdio encoding helper before JSON output."""
127
+ scripts_dir = project_dir / ".trellis" / "scripts"
128
+ if str(scripts_dir) not in sys.path:
129
+ sys.path.insert(0, str(scripts_dir))
130
+
131
+ try:
132
+ from common import configure_encoding # type: ignore[import-not-found]
133
+
134
+ configure_encoding()
135
+ except Exception:
136
+ pass
137
+
138
+
139
+ def _has_curated_jsonl_entry(jsonl_path: Path) -> bool:
140
+ """Return True iff jsonl has at least one row with a ``file`` field.
141
+
142
+ A freshly seeded jsonl only contains a ``{"_example": ...}`` row (no
143
+ ``file`` key) — that is NOT "ready". Readiness requires at least one
144
+ curated entry. Matches the contract used by ``inject-subagent-context.py``.
145
+ """
146
+ try:
147
+ for line in jsonl_path.read_text(encoding="utf-8").splitlines():
148
+ line = line.strip()
149
+ if not line:
150
+ continue
151
+ try:
152
+ row = json.loads(line)
153
+ except json.JSONDecodeError:
154
+ continue
155
+ if isinstance(row, dict) and row.get("file"):
156
+ return True
157
+ except (OSError, UnicodeDecodeError):
158
+ return False
159
+ return False
160
+
161
+
162
+ def read_file(path: Path, fallback: str = "") -> str:
163
+ try:
164
+ return path.read_text(encoding="utf-8")
165
+ except (FileNotFoundError, PermissionError):
166
+ return fallback
167
+
168
+
169
+ def _resolve_context_key(project_dir: Path, hook_input: dict) -> str | None:
170
+ scripts_dir = project_dir / ".trellis" / "scripts"
171
+ if str(scripts_dir) not in sys.path:
172
+ sys.path.insert(0, str(scripts_dir))
173
+ try:
174
+ from common.active_task import resolve_context_key # type: ignore[import-not-found]
175
+ except Exception:
176
+ return None
177
+ return resolve_context_key(hook_input, platform="codex")
178
+
179
+
180
+ def _resolve_active_task(trellis_dir: Path, hook_input: dict):
181
+ scripts_dir = trellis_dir / "scripts"
182
+ if str(scripts_dir) not in sys.path:
183
+ sys.path.insert(0, str(scripts_dir))
184
+ from common.active_task import resolve_active_task # type: ignore[import-not-found]
185
+
186
+ return resolve_active_task(trellis_dir.parent, hook_input, platform="codex")
187
+
188
+
189
+ def run_script(script_path: Path, context_key: str | None = None) -> str:
190
+ try:
191
+ env = os.environ.copy()
192
+ env["PYTHONIOENCODING"] = "utf-8"
193
+ if context_key:
194
+ env["TRELLIS_CONTEXT_ID"] = context_key
195
+ cmd = [sys.executable, "-W", "ignore", str(script_path)]
196
+ result = subprocess.run(
197
+ cmd,
198
+ capture_output=True,
199
+ text=True,
200
+ encoding="utf-8",
201
+ errors="replace",
202
+ timeout=5,
203
+ cwd=str(script_path.parent.parent.parent),
204
+ env=env,
205
+ )
206
+ return result.stdout if result.returncode == 0 else "No context available"
207
+ except (subprocess.TimeoutExpired, FileNotFoundError, PermissionError):
208
+ return "No context available"
209
+
210
+
211
+ def _normalize_task_ref(task_ref: str) -> str:
212
+ normalized = task_ref.strip()
213
+ if not normalized:
214
+ return ""
215
+
216
+ path_obj = Path(normalized)
217
+ if path_obj.is_absolute():
218
+ return str(path_obj)
219
+
220
+ normalized = normalized.replace("\\", "/")
221
+ while normalized.startswith("./"):
222
+ normalized = normalized[2:]
223
+
224
+ if normalized.startswith("tasks/"):
225
+ return f".trellis/{normalized}"
226
+
227
+ return normalized
228
+
229
+
230
+ def _resolve_task_dir(trellis_dir: Path, task_ref: str) -> Path:
231
+ normalized = _normalize_task_ref(task_ref)
232
+ path_obj = Path(normalized)
233
+ if path_obj.is_absolute():
234
+ return path_obj
235
+ if normalized.startswith(".trellis/"):
236
+ return trellis_dir.parent / path_obj
237
+ return trellis_dir / "tasks" / path_obj
238
+
239
+
240
+ def _get_task_status(trellis_dir: Path, hook_input: dict) -> str:
241
+ active = _resolve_active_task(trellis_dir, hook_input)
242
+ if not active.task_path:
243
+ return f"Status: NO ACTIVE TASK\nSource: {active.source}\nNext: Describe what you want to work on"
244
+
245
+ task_ref = active.task_path
246
+ task_dir = _resolve_task_dir(trellis_dir, task_ref)
247
+ if active.stale or not task_dir.is_dir():
248
+ return f"Status: STALE POINTER\nTask: {task_ref}\nSource: {active.source}\nNext: Task directory not found. Run: python3 ./.trellis/scripts/task.py finish"
249
+
250
+ task_json_path = task_dir / "task.json"
251
+ task_data: dict = {}
252
+ if task_json_path.is_file():
253
+ try:
254
+ task_data = json.loads(task_json_path.read_text(encoding="utf-8"))
255
+ except (json.JSONDecodeError, PermissionError):
256
+ pass
257
+
258
+ task_title = task_data.get("title", task_ref)
259
+ task_status = task_data.get("status", "unknown")
260
+
261
+ if task_status == "completed":
262
+ return f"Status: COMPLETED\nTask: {task_title}\nSource: {active.source}\nNext: Archive with `python3 ./.trellis/scripts/task.py archive {task_dir.name}` or start a new task"
263
+
264
+ has_context = False
265
+ for jsonl_name in ("implement.jsonl", "check.jsonl", "spec.jsonl"):
266
+ jsonl_path = task_dir / jsonl_name
267
+ if jsonl_path.is_file() and _has_curated_jsonl_entry(jsonl_path):
268
+ has_context = True
269
+ break
270
+
271
+ has_prd = (task_dir / "prd.md").is_file()
272
+
273
+ if not has_prd:
274
+ return f"Status: NOT READY\nTask: {task_title}\nSource: {active.source}\nMissing: prd.md not created\nNext: Write PRD (see workflow.md Phase 1.1) then curate implement.jsonl per Phase 1.3"
275
+
276
+ if not has_context:
277
+ return f"Status: NOT READY\nTask: {task_title}\nSource: {active.source}\nMissing: implement.jsonl / check.jsonl missing or empty\nNext: Curate entries per workflow.md Phase 1.3 (spec + research files only), then `task.py start`"
278
+
279
+ return (
280
+ f"Status: READY\nTask: {task_title}\n"
281
+ f"Source: {active.source}\n"
282
+ "Next required action: dispatch `trellis-implement` per Phase 2.1. "
283
+ "For agent-capable platforms, the default is to NOT edit code in the main session. "
284
+ "After implementation, dispatch `trellis-check` per Phase 2.2 before reporting completion.\n"
285
+ "Sub-agent self-exemption: if you are reading this as a `trellis-implement` or "
286
+ "`trellis-check` sub-agent (your own role / agent name reflects that), this dispatch "
287
+ "instruction does NOT apply to you — you are already the dispatched sub-agent. "
288
+ "Implement / check directly without spawning another sub-agent of the same kind.\n"
289
+ "User override (per-turn escape hatch): if the user's CURRENT message explicitly tells the "
290
+ "main session to handle it directly (\"你直接改\" / \"别派 sub-agent\" / \"main session 写就行\" / "
291
+ "\"do it inline\" / \"不用 sub-agent\"), honor it for this turn and edit code directly. "
292
+ "Per-turn only; do NOT invent an override the user did not say."
293
+ )
294
+
295
+
296
+ def _extract_range(content: str, start_header: str, end_header: str) -> str:
297
+ """Extract lines starting at `## start_header` up to (but excluding) `## end_header`."""
298
+ lines = content.splitlines()
299
+ start: "int | None" = None
300
+ end: int = len(lines)
301
+ start_match = f"## {start_header}"
302
+ end_match = f"## {end_header}"
303
+ for i, line in enumerate(lines):
304
+ stripped = line.strip()
305
+ if start is None and stripped == start_match:
306
+ start = i
307
+ continue
308
+ if start is not None and stripped == end_match:
309
+ end = i
310
+ break
311
+ if start is None:
312
+ return ""
313
+ return "\n".join(lines[start:end]).rstrip()
314
+
315
+
316
+ _BREADCRUMB_TAG_RE = re.compile(
317
+ r"\[workflow-state:([A-Za-z0-9_-]+)\]\s*\n.*?\n\s*\[/workflow-state:\1\]",
318
+ re.DOTALL,
319
+ )
320
+
321
+
322
+ def _strip_breadcrumb_tag_blocks(content: str) -> str:
323
+ return _BREADCRUMB_TAG_RE.sub("", content)
324
+
325
+
326
+ def _build_workflow_toc(workflow_path: Path) -> str:
327
+ """Inject workflow guide: TOC + Phase Index + Phase 1/2/3 step details.
328
+
329
+ Since v0.5.0-rc.0 the [workflow-state:STATUS] breadcrumb tag blocks
330
+ live inside ## Phase Index. They're consumed by inject-workflow-state.py
331
+ on each UserPromptSubmit, so strip them from the session-start payload
332
+ to avoid duplicating context.
333
+ """
334
+ content = read_file(workflow_path)
335
+ if not content:
336
+ return "No workflow.md found"
337
+
338
+ out_lines = [
339
+ "# Development Workflow — Section Index",
340
+ "Full guide: .trellis/workflow.md (read on demand)",
341
+ "",
342
+ "## Table of Contents",
343
+ ]
344
+ for line in content.splitlines():
345
+ if line.startswith("## "):
346
+ out_lines.append(line)
347
+ out_lines += ["", "---", ""]
348
+
349
+ phases = _extract_range(content, "Phase Index", "Customizing Trellis (for forks)")
350
+ if phases:
351
+ out_lines.append(_strip_breadcrumb_tag_blocks(phases).rstrip())
352
+
353
+ return "\n".join(out_lines).rstrip()
354
+
355
+
356
+ def main() -> None:
357
+ if should_skip_injection():
358
+ sys.exit(0)
359
+
360
+ # Read hook input from stdin
361
+ try:
362
+ hook_input = json.loads(sys.stdin.read())
363
+ if not isinstance(hook_input, dict):
364
+ hook_input = {}
365
+ project_dir = Path(_normalize_windows_shell_path(hook_input.get("cwd", "."))).resolve()
366
+ except (json.JSONDecodeError, KeyError):
367
+ hook_input = {}
368
+ project_dir = Path(".").resolve()
369
+
370
+ configure_project_encoding(project_dir)
371
+
372
+ trellis_dir = project_dir / ".trellis"
373
+ context_key = _resolve_context_key(project_dir, hook_input)
374
+
375
+ output = StringIO()
376
+
377
+ output.write(SUB_AGENT_NOTICE)
378
+ output.write("\n\n")
379
+
380
+ output.write("""<session-context>
381
+ You are starting a new session in a Trellis-managed project.
382
+ Read and follow all instructions below carefully.
383
+ </session-context>
384
+
385
+ """)
386
+ output.write(FIRST_REPLY_NOTICE)
387
+ output.write("\n\n")
388
+
389
+ output.write("<current-state>\n")
390
+ context_script = trellis_dir / "scripts" / "get_context.py"
391
+ output.write(run_script(context_script, context_key))
392
+ output.write("\n</current-state>\n\n")
393
+
394
+ output.write("<workflow>\n")
395
+ output.write(_build_workflow_toc(trellis_dir / "workflow.md"))
396
+ output.write("\n</workflow>\n\n")
397
+
398
+ output.write("<guidelines>\n")
399
+ output.write(
400
+ "Project spec indexes are listed by path below. Each index contains a "
401
+ "**Pre-Development Checklist** listing the specific guideline files to "
402
+ "read before coding.\n\n"
403
+ "- If you're spawning an implement/check sub-agent, context is injected "
404
+ "automatically via `{task}/implement.jsonl` / `check.jsonl`. You do NOT "
405
+ "need to read these indexes yourself.\n"
406
+ "- For agent-capable platforms, the default is to dispatch "
407
+ "`trellis-implement` and `trellis-check` (so JSONL context is loaded by "
408
+ "the sub-agents) rather than editing code in the main session. "
409
+ "Honor a per-turn user override only if the user's current message "
410
+ "explicitly opts out (see <task-status> below for override phrases).\n"
411
+ "- Sub-agent self-exemption: if you are reading this as a `trellis-implement` "
412
+ "or `trellis-check` sub-agent, the \"dispatch trellis-implement / trellis-check\" "
413
+ "rule above does NOT apply to you — you are already the dispatched sub-agent. "
414
+ "Do NOT spawn another sub-agent of the same kind; implement / check directly.\n\n"
415
+ )
416
+
417
+ # guides/ inlined (cross-package thinking, broadly useful)
418
+ guides_index = trellis_dir / "spec" / "guides" / "index.md"
419
+ if guides_index.is_file():
420
+ output.write("## guides (inlined — cross-package thinking guides)\n")
421
+ output.write(read_file(guides_index))
422
+ output.write("\n\n")
423
+
424
+ # Other indexes — paths only
425
+ paths: list[str] = []
426
+ spec_dir = trellis_dir / "spec"
427
+ if spec_dir.is_dir():
428
+ for sub in sorted(spec_dir.iterdir()):
429
+ if not sub.is_dir() or sub.name.startswith("."):
430
+ continue
431
+ if sub.name == "guides":
432
+ continue
433
+ index_file = sub / "index.md"
434
+ if index_file.is_file():
435
+ paths.append(f".trellis/spec/{sub.name}/index.md")
436
+ else:
437
+ for nested in sorted(sub.iterdir()):
438
+ if not nested.is_dir():
439
+ continue
440
+ nested_index = nested / "index.md"
441
+ if nested_index.is_file():
442
+ paths.append(
443
+ f".trellis/spec/{sub.name}/{nested.name}/index.md"
444
+ )
445
+
446
+ if paths:
447
+ output.write("## Available spec indexes (read on demand)\n")
448
+ for p in paths:
449
+ output.write(f"- {p}\n")
450
+ output.write("\n")
451
+
452
+ output.write(
453
+ "Discover more via: "
454
+ "`python3 ./.trellis/scripts/get_context.py --mode packages`\n"
455
+ )
456
+ output.write("</guidelines>\n\n")
457
+
458
+ task_status = _get_task_status(trellis_dir, hook_input)
459
+ output.write(f"<task-status>\n{task_status}\n</task-status>\n\n")
460
+
461
+ output.write("""<ready>
462
+ Context loaded. Workflow index, project state, and guidelines are already injected above — do NOT re-read them.
463
+ When the user sends the first message, follow <task-status> and the workflow guide.
464
+ If a task is READY, execute its Next required action without asking whether to continue.
465
+ </ready>""")
466
+
467
+ context = output.getvalue()
468
+ result = {
469
+ "suppressOutput": True,
470
+ "systemMessage": f"Trellis context injected ({len(context)} chars)",
471
+ "hookSpecificOutput": {
472
+ "hookEventName": "SessionStart",
473
+ "additionalContext": context,
474
+ },
475
+ }
476
+
477
+ print(json.dumps(result, ensure_ascii=False), flush=True)
478
+
479
+
480
+ if __name__ == "__main__":
481
+ main()
@@ -0,0 +1,15 @@
1
+ {
2
+ "hooks": {
3
+ "UserPromptSubmit": [
4
+ {
5
+ "hooks": [
6
+ {
7
+ "type": "command",
8
+ "command": "{{PYTHON_CMD}} -X utf8 .codex/hooks/inject-workflow-state.py",
9
+ "timeout": 15
10
+ }
11
+ ]
12
+ }
13
+ ]
14
+ }
15
+ }
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Codex templates
3
+ *
4
+ * These are GENERIC templates for user projects.
5
+ * Do NOT use Trellis project's own .agents/skills or .codex directories
6
+ * (which may be customized).
7
+ *
8
+ * Directory structure:
9
+ * codex/
10
+ * ├── agents/ # Project-scoped Codex custom agents (.toml)
11
+ * ├── codex-skills/ # Codex-specific skills → .codex/skills/
12
+ * ├── skills/ # Shared skills → .agents/skills/
13
+ * └── config.toml # Project-scoped Codex config
14
+ */
15
+ export interface SkillTemplate {
16
+ name: string;
17
+ content: string;
18
+ }
19
+ export interface AgentTemplate {
20
+ name: string;
21
+ content: string;
22
+ }
23
+ export interface ConfigTemplate {
24
+ targetPath: string;
25
+ content: string;
26
+ }
27
+ export declare function getAllAgents(): AgentTemplate[];
28
+ /**
29
+ * Get Codex-specific skills (installed to .codex/skills/, not shared .agents/skills/).
30
+ */
31
+ export declare function getAllCodexSkills(): SkillTemplate[];
32
+ export interface HookTemplate {
33
+ name: string;
34
+ content: string;
35
+ }
36
+ export declare function getAllHooks(): HookTemplate[];
37
+ export declare function getHooksConfig(): string;
38
+ export declare function getConfigTemplate(): ConfigTemplate;
39
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgCH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAc9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,EAAE,CASnD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAW5C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}
@@ -0,0 +1,85 @@
1
+ /**
2
+ * Codex templates
3
+ *
4
+ * These are GENERIC templates for user projects.
5
+ * Do NOT use Trellis project's own .agents/skills or .codex directories
6
+ * (which may be customized).
7
+ *
8
+ * Directory structure:
9
+ * codex/
10
+ * ├── agents/ # Project-scoped Codex custom agents (.toml)
11
+ * ├── codex-skills/ # Codex-specific skills → .codex/skills/
12
+ * ├── skills/ # Shared skills → .agents/skills/
13
+ * └── config.toml # Project-scoped Codex config
14
+ */
15
+ import { readdirSync, readFileSync } from "node:fs";
16
+ import { dirname, join } from "node:path";
17
+ import { fileURLToPath } from "node:url";
18
+ const __filename = fileURLToPath(import.meta.url);
19
+ const __dirname = dirname(__filename);
20
+ function readTemplate(relativePath) {
21
+ return readFileSync(join(__dirname, relativePath), "utf-8");
22
+ }
23
+ function listDirectories(dir) {
24
+ try {
25
+ return readdirSync(join(__dirname, dir), { withFileTypes: true })
26
+ .filter((entry) => entry.isDirectory())
27
+ .map((entry) => entry.name)
28
+ .sort();
29
+ }
30
+ catch {
31
+ return [];
32
+ }
33
+ }
34
+ function listFiles(dir) {
35
+ try {
36
+ return readdirSync(join(__dirname, dir)).sort();
37
+ }
38
+ catch {
39
+ return [];
40
+ }
41
+ }
42
+ // Shared skills are now sourced from common/ templates (see templates/common/index.ts)
43
+ export function getAllAgents() {
44
+ const agents = [];
45
+ for (const file of listFiles("agents")) {
46
+ if (!file.endsWith(".toml")) {
47
+ continue;
48
+ }
49
+ const name = file.replace(".toml", "");
50
+ const content = readTemplate(`agents/${file}`);
51
+ agents.push({ name, content });
52
+ }
53
+ return agents;
54
+ }
55
+ /**
56
+ * Get Codex-specific skills (installed to .codex/skills/, not shared .agents/skills/).
57
+ */
58
+ export function getAllCodexSkills() {
59
+ const skills = [];
60
+ for (const name of listDirectories("codex-skills")) {
61
+ const content = readTemplate(`codex-skills/${name}/SKILL.md`);
62
+ skills.push({ name, content });
63
+ }
64
+ return skills;
65
+ }
66
+ export function getAllHooks() {
67
+ const hooks = [];
68
+ for (const file of listFiles("hooks")) {
69
+ if (!file.endsWith(".py")) {
70
+ continue;
71
+ }
72
+ hooks.push({ name: file, content: readTemplate(`hooks/${file}`) });
73
+ }
74
+ return hooks;
75
+ }
76
+ export function getHooksConfig() {
77
+ return readTemplate("hooks.json");
78
+ }
79
+ export function getConfigTemplate() {
80
+ return {
81
+ targetPath: "config.toml",
82
+ content: readTemplate("config.toml"),
83
+ };
84
+ }
85
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC9D,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;aACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAC1B,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAiBD,uFAAuF;AAEvF,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,YAAY,CAAC,gBAAgB,IAAI,WAAW,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,UAAU,EAAE,aAAa;QACzB,OAAO,EAAE,YAAY,CAAC,aAAa,CAAC;KACrC,CAAC;AACJ,CAAC"}