@fitlab-ai/agent-infra 0.9.1 → 0.9.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 (476) hide show
  1. package/README.md +24 -11
  2. package/README.zh-CN.md +24 -11
  3. package/bin/cli.ts +12 -0
  4. package/dist/bin/cli.js +14 -0
  5. package/dist/bin/internal-cli.js +30 -0
  6. package/dist/lib/agent-client.js +163 -0
  7. package/dist/lib/agent-clients/adapter.js +337 -0
  8. package/dist/lib/agent-clients/adapters/antigravity-cli.js +64 -0
  9. package/dist/lib/agent-clients/adapters/claude-code.js +71 -0
  10. package/dist/lib/agent-clients/adapters/codex-sandbox.js +210 -0
  11. package/dist/lib/agent-clients/adapters/codex.js +63 -0
  12. package/dist/lib/agent-clients/adapters/index.js +20 -0
  13. package/dist/lib/agent-clients/adapters/opencode.js +73 -0
  14. package/dist/lib/agent-clients/config.js +215 -0
  15. package/dist/lib/agent-clients/custom-tuis.js +99 -0
  16. package/dist/lib/agent-clients/invocation.js +9 -0
  17. package/dist/lib/agent-clients/next-steps.js +47 -0
  18. package/dist/lib/agent-clients/project-assets.js +45 -0
  19. package/dist/lib/agent-clients/reconcile.js +236 -0
  20. package/dist/lib/agent-clients/registry.js +78 -0
  21. package/dist/lib/agent-clients/schema.js +75 -0
  22. package/dist/lib/agent-clients/tokens.js +49 -0
  23. package/dist/lib/agent-clients/types.js +29 -0
  24. package/dist/lib/builtin-tuis.js +9 -14
  25. package/dist/lib/defaults.json +85 -73
  26. package/dist/lib/git/review-snapshot.js +25 -10
  27. package/dist/lib/git/reviewed-commit-equivalence.js +110 -0
  28. package/dist/lib/git/workflow.js +54 -1
  29. package/dist/lib/init.js +47 -91
  30. package/dist/lib/internal/agent-client.js +174 -0
  31. package/dist/lib/internal/git-workflow.js +7 -2
  32. package/dist/lib/internal/platform-checks.js +3 -3
  33. package/dist/lib/internal/platform-comment.js +29 -2
  34. package/dist/lib/internal/platform-issue.js +7 -0
  35. package/dist/lib/internal/platform-pr-review.js +132 -0
  36. package/dist/lib/internal/platform-pr.js +20 -2
  37. package/dist/lib/internal/platform-release-notes.js +52 -16
  38. package/dist/lib/internal/pr-review-grade.js +140 -0
  39. package/dist/lib/internal/release-workflow.js +82 -20
  40. package/dist/lib/internal/task-activity.js +73 -0
  41. package/dist/lib/internal/task-event.js +17 -1
  42. package/dist/lib/internal/task-lifecycle.js +7 -0
  43. package/dist/lib/internal/task-orchestration.js +196 -0
  44. package/dist/lib/internal/task-review.js +70 -0
  45. package/dist/lib/merge.js +2 -1
  46. package/dist/lib/platform/adapters.js +45 -1
  47. package/dist/lib/platform/change-request-git-evidence.js +113 -0
  48. package/dist/lib/platform/completion-backfill.js +122 -0
  49. package/dist/lib/platform/issue-comments.js +3 -2
  50. package/dist/lib/platform/merged-pr-equivalence.js +156 -16
  51. package/dist/lib/platform/pr-checks.js +101 -50
  52. package/dist/lib/platform/pr-review.js +166 -0
  53. package/dist/lib/platform/pull-requests.js +432 -7
  54. package/dist/lib/platform/release-notes.js +85 -3
  55. package/dist/lib/platform/releases.js +1 -1
  56. package/dist/lib/platform/verification-required.js +8 -10
  57. package/dist/lib/pr-review/evidence-grading.js +229 -0
  58. package/dist/lib/prompt.js +15 -3
  59. package/dist/lib/release/channels.js +4 -1
  60. package/dist/lib/release/workflow.js +4 -2
  61. package/dist/lib/remove-dir.js +25 -0
  62. package/dist/lib/run/tui.js +11 -7
  63. package/dist/lib/sandbox/agent-client-reconciler.js +234 -0
  64. package/dist/lib/sandbox/clipboard/linux.js +2 -1
  65. package/dist/lib/sandbox/commands/create.js +76 -200
  66. package/dist/lib/sandbox/commands/enter.js +17 -1
  67. package/dist/lib/sandbox/commands/prune.js +2 -2
  68. package/dist/lib/sandbox/commands/rm.js +3 -2
  69. package/dist/lib/sandbox/commands/show.js +1 -1
  70. package/dist/lib/sandbox/config.js +21 -4
  71. package/dist/lib/sandbox/constants.js +3 -0
  72. package/dist/lib/sandbox/dockerfile.js +2 -1
  73. package/dist/lib/sandbox/managed-fs.js +10 -5
  74. package/dist/lib/sandbox/recovery.js +52 -36
  75. package/dist/lib/sandbox/shell.js +1 -1
  76. package/dist/lib/sandbox/tool-types.js +8 -0
  77. package/dist/lib/sandbox/tools.js +2 -126
  78. package/dist/lib/task/activity-intent.js +101 -0
  79. package/dist/lib/task/artifact-lifecycle.js +3 -50
  80. package/dist/lib/task/commands/decisions.js +50 -20
  81. package/dist/lib/task/commands/log.js +15 -14
  82. package/dist/lib/task/delegation-receipts.js +128 -0
  83. package/dist/lib/task/events.js +146 -8
  84. package/dist/lib/task/finalization-artifacts.js +35 -0
  85. package/dist/lib/task/lifecycle-execution.js +46 -0
  86. package/dist/lib/task/orchestration.js +784 -0
  87. package/dist/lib/task/review-artifacts.js +143 -59
  88. package/dist/lib/task/review-finalization.js +186 -0
  89. package/dist/lib/task/review-fingerprint.js +4 -0
  90. package/dist/lib/task/task-execution-lock.js +231 -0
  91. package/dist/lib/task/verification-checks.js +2 -1
  92. package/dist/lib/task/verification-engine.js +372 -28
  93. package/dist/lib/task/verification-review.js +1 -1
  94. package/dist/lib/task/verification.js +5 -2
  95. package/dist/lib/task/workspace-snapshot.js +46 -0
  96. package/dist/lib/update.js +42 -161
  97. package/lib/agent-client.ts +214 -0
  98. package/lib/agent-clients/adapter.ts +534 -0
  99. package/lib/agent-clients/adapters/antigravity-cli.ts +65 -0
  100. package/lib/agent-clients/adapters/claude-code.ts +79 -0
  101. package/lib/agent-clients/adapters/codex-sandbox.ts +245 -0
  102. package/lib/agent-clients/adapters/codex.ts +67 -0
  103. package/lib/agent-clients/adapters/index.ts +27 -0
  104. package/lib/agent-clients/adapters/opencode.ts +75 -0
  105. package/lib/agent-clients/config.ts +323 -0
  106. package/lib/agent-clients/custom-tuis.ts +149 -0
  107. package/lib/agent-clients/invocation.ts +19 -0
  108. package/lib/agent-clients/next-steps.ts +85 -0
  109. package/lib/agent-clients/project-assets.ts +96 -0
  110. package/lib/agent-clients/reconcile.ts +325 -0
  111. package/lib/agent-clients/registry.ts +154 -0
  112. package/lib/agent-clients/schema.ts +80 -0
  113. package/lib/agent-clients/tokens.ts +53 -0
  114. package/lib/agent-clients/types.ts +92 -0
  115. package/lib/benchmark/schemas/v1.0.0/case-manifest.schema.json +120 -0
  116. package/lib/benchmark/schemas/v1.0.0/common.schema.json +109 -0
  117. package/lib/benchmark/schemas/v1.0.0/grader-result.schema.json +160 -0
  118. package/lib/benchmark/schemas/v1.0.0/run-manifest.schema.json +122 -0
  119. package/lib/benchmark/schemas/v1.0.0/subject.schema.json +227 -0
  120. package/lib/builtin-tuis.ts +16 -15
  121. package/lib/defaults.json +24 -12
  122. package/lib/git/review-snapshot.ts +39 -9
  123. package/lib/git/reviewed-commit-equivalence.ts +135 -0
  124. package/lib/git/workflow.ts +66 -2
  125. package/lib/init.ts +53 -121
  126. package/lib/internal/agent-client.ts +186 -0
  127. package/lib/internal/git-workflow.ts +6 -2
  128. package/lib/internal/platform-checks.ts +4 -4
  129. package/lib/internal/platform-comment.ts +17 -2
  130. package/lib/internal/platform-issue.ts +4 -0
  131. package/lib/internal/platform-pr-review.ts +104 -0
  132. package/lib/internal/platform-pr.ts +14 -1
  133. package/lib/internal/platform-release-notes.ts +59 -16
  134. package/lib/internal/pr-review-grade.ts +130 -0
  135. package/lib/internal/release-workflow.ts +79 -20
  136. package/lib/internal/task-activity.ts +55 -0
  137. package/lib/internal/task-event.ts +9 -1
  138. package/lib/internal/task-lifecycle.ts +4 -0
  139. package/lib/internal/task-orchestration.ts +171 -0
  140. package/lib/internal/task-review.ts +70 -0
  141. package/lib/merge.ts +2 -1
  142. package/lib/platform/adapters.ts +169 -3
  143. package/lib/platform/change-request-git-evidence.ts +159 -0
  144. package/lib/platform/completion-backfill.ts +134 -0
  145. package/lib/platform/issue-comments.ts +3 -2
  146. package/lib/platform/merged-pr-equivalence.ts +178 -19
  147. package/lib/platform/pr-checks.ts +121 -66
  148. package/lib/platform/pr-review.ts +201 -0
  149. package/lib/platform/pull-requests.ts +529 -27
  150. package/lib/platform/release-notes.ts +100 -4
  151. package/lib/platform/releases.ts +1 -1
  152. package/lib/platform/verification-required.ts +12 -10
  153. package/lib/pr-review/evidence-grading.ts +318 -0
  154. package/lib/prompt.ts +16 -3
  155. package/lib/release/channels.ts +4 -1
  156. package/lib/release/workflow.ts +4 -3
  157. package/lib/remove-dir.ts +28 -0
  158. package/lib/run/tui.ts +12 -5
  159. package/lib/sandbox/agent-client-reconciler.ts +378 -0
  160. package/lib/sandbox/clipboard/linux.ts +2 -1
  161. package/lib/sandbox/commands/create.ts +111 -212
  162. package/lib/sandbox/commands/enter.ts +23 -1
  163. package/lib/sandbox/commands/prune.ts +2 -2
  164. package/lib/sandbox/commands/rm.ts +3 -2
  165. package/lib/sandbox/commands/show.ts +1 -1
  166. package/lib/sandbox/config.ts +31 -4
  167. package/lib/sandbox/constants.ts +6 -0
  168. package/lib/sandbox/dockerfile.ts +2 -1
  169. package/lib/sandbox/managed-fs.ts +18 -5
  170. package/lib/sandbox/recovery.ts +98 -67
  171. package/lib/sandbox/shell.ts +1 -1
  172. package/lib/sandbox/tool-types.ts +143 -0
  173. package/lib/sandbox/tools.ts +5 -157
  174. package/lib/server/server.schema.json +2 -2
  175. package/lib/task/activity-intent.ts +128 -0
  176. package/lib/task/artifact-lifecycle.ts +3 -39
  177. package/lib/task/commands/decisions.ts +53 -20
  178. package/lib/task/commands/log.ts +15 -14
  179. package/lib/task/delegation-receipts.ts +199 -0
  180. package/lib/task/events.ts +164 -11
  181. package/lib/task/finalization-artifacts.ts +58 -0
  182. package/lib/task/lifecycle-execution.ts +106 -0
  183. package/lib/task/orchestration.ts +1022 -0
  184. package/lib/task/review-artifacts.ts +201 -69
  185. package/lib/task/review-finalization.ts +306 -0
  186. package/lib/task/review-fingerprint.ts +5 -0
  187. package/lib/task/task-execution-lock.ts +296 -0
  188. package/lib/task/verification-checks.ts +2 -1
  189. package/lib/task/verification-engine.ts +424 -28
  190. package/lib/task/verification-review.ts +1 -0
  191. package/lib/task/verification.ts +8 -3
  192. package/lib/task/workspace-snapshot.ts +57 -0
  193. package/lib/update.ts +48 -184
  194. package/package.json +4 -4
  195. package/templates/.agents/QUICKSTART.en.md +25 -8
  196. package/templates/.agents/QUICKSTART.zh-CN.md +25 -8
  197. package/templates/.agents/README.en.md +29 -25
  198. package/templates/.agents/README.zh-CN.md +29 -25
  199. package/templates/.agents/hooks/lifecycle-delegation.js +75 -0
  200. package/templates/.agents/rules/README.en.md +2 -0
  201. package/templates/.agents/rules/README.zh-CN.md +2 -0
  202. package/templates/.agents/rules/commit-and-pr.en.md +1 -0
  203. package/templates/.agents/rules/commit-and-pr.zh-CN.md +1 -0
  204. package/templates/.agents/rules/create-issue.github.en.md +4 -2
  205. package/templates/.agents/rules/create-issue.github.zh-CN.md +4 -2
  206. package/templates/.agents/rules/human-decision-context.en.md +14 -12
  207. package/templates/.agents/rules/human-decision-context.zh-CN.md +14 -12
  208. package/templates/.agents/rules/issue-fields.github.en.md +3 -1
  209. package/templates/.agents/rules/issue-fields.github.zh-CN.md +3 -1
  210. package/templates/.agents/rules/issue-pr-commands.en.md +5 -3
  211. package/templates/.agents/rules/issue-pr-commands.github.en.md +5 -3
  212. package/templates/.agents/rules/issue-pr-commands.github.zh-CN.md +5 -3
  213. package/templates/.agents/rules/issue-pr-commands.zh-CN.md +5 -3
  214. package/templates/.agents/rules/issue-sync.github.en.md +7 -3
  215. package/templates/.agents/rules/issue-sync.github.zh-CN.md +8 -4
  216. package/templates/.agents/rules/lifecycle-orchestration.en.md +24 -0
  217. package/templates/.agents/rules/lifecycle-orchestration.zh-CN.md +24 -0
  218. package/templates/.agents/rules/milestone-inference.github.en.md +4 -2
  219. package/templates/.agents/rules/milestone-inference.github.zh-CN.md +4 -2
  220. package/templates/.agents/rules/next-step-output.en.md +18 -0
  221. package/templates/.agents/rules/next-step-output.zh-CN.md +18 -0
  222. package/templates/.agents/rules/no-mid-flow-questions.en.md +19 -0
  223. package/templates/.agents/rules/no-mid-flow-questions.zh-CN.md +19 -0
  224. package/templates/.agents/rules/pr-checks-commands.en.md +3 -3
  225. package/templates/.agents/rules/pr-checks-commands.github.en.md +2 -2
  226. package/templates/.agents/rules/pr-checks-commands.github.zh-CN.md +2 -2
  227. package/templates/.agents/rules/pr-checks-commands.zh-CN.md +3 -3
  228. package/templates/.agents/rules/pr-sync.en.md +3 -1
  229. package/templates/.agents/rules/pr-sync.github.en.md +11 -1
  230. package/templates/.agents/rules/pr-sync.github.zh-CN.md +11 -1
  231. package/templates/.agents/rules/pr-sync.zh-CN.md +3 -1
  232. package/templates/.agents/rules/release-commands.en.md +1 -1
  233. package/templates/.agents/rules/release-commands.github.en.md +21 -5
  234. package/templates/.agents/rules/release-commands.github.zh-CN.md +21 -5
  235. package/templates/.agents/rules/release-commands.zh-CN.md +1 -1
  236. package/templates/.agents/rules/review-handshake.en.md +4 -4
  237. package/templates/.agents/rules/review-handshake.zh-CN.md +4 -4
  238. package/templates/.agents/rules/review-method.en.md +113 -0
  239. package/templates/.agents/rules/review-method.zh-CN.md +98 -0
  240. package/templates/.agents/rules/task-management.en.md +11 -0
  241. package/templates/.agents/rules/task-management.zh-CN.md +11 -0
  242. package/templates/.agents/skills/analyze-task/SKILL.en.md +15 -12
  243. package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md +15 -12
  244. package/templates/.agents/skills/block-task/SKILL.en.md +11 -9
  245. package/templates/.agents/skills/block-task/SKILL.zh-CN.md +11 -9
  246. package/templates/.agents/skills/cancel-task/SKILL.en.md +10 -8
  247. package/templates/.agents/skills/cancel-task/SKILL.zh-CN.md +11 -9
  248. package/templates/.agents/skills/check-task/SKILL.en.md +16 -16
  249. package/templates/.agents/skills/check-task/SKILL.zh-CN.md +16 -16
  250. package/templates/.agents/skills/close-codescan/SKILL.en.md +7 -5
  251. package/templates/.agents/skills/close-codescan/SKILL.zh-CN.md +7 -5
  252. package/templates/.agents/skills/close-dependabot/SKILL.en.md +7 -5
  253. package/templates/.agents/skills/close-dependabot/SKILL.zh-CN.md +7 -5
  254. package/templates/.agents/skills/code-task/SKILL.en.md +10 -7
  255. package/templates/.agents/skills/code-task/SKILL.zh-CN.md +13 -10
  256. package/templates/.agents/skills/code-task/reference/fix-mode.en.md +14 -16
  257. package/templates/.agents/skills/code-task/reference/fix-mode.zh-CN.md +14 -16
  258. package/templates/.agents/skills/code-task/reference/output-template.en.md +3 -3
  259. package/templates/.agents/skills/code-task/reference/output-template.zh-CN.md +3 -3
  260. package/templates/.agents/skills/commit/SKILL.en.md +13 -1
  261. package/templates/.agents/skills/commit/SKILL.zh-CN.md +13 -1
  262. package/templates/.agents/skills/commit/reference/commit-message.en.md +1 -1
  263. package/templates/.agents/skills/commit/reference/commit-message.zh-CN.md +1 -1
  264. package/templates/.agents/skills/commit/reference/issue-metadata-sync.en.md +1 -1
  265. package/templates/.agents/skills/commit/reference/issue-metadata-sync.zh-CN.md +1 -1
  266. package/templates/.agents/skills/commit/reference/pr-summary-sync.en.md +1 -1
  267. package/templates/.agents/skills/commit/reference/pr-summary-sync.zh-CN.md +1 -1
  268. package/templates/.agents/skills/commit/reference/task-status-update.en.md +24 -28
  269. package/templates/.agents/skills/commit/reference/task-status-update.zh-CN.md +24 -28
  270. package/templates/.agents/skills/complete-manual-validation/SKILL.en.md +6 -4
  271. package/templates/.agents/skills/complete-manual-validation/SKILL.zh-CN.md +6 -4
  272. package/templates/.agents/skills/complete-manual-validation/reference/summary-update.en.md +1 -1
  273. package/templates/.agents/skills/complete-manual-validation/reference/summary-update.zh-CN.md +1 -1
  274. package/templates/.agents/skills/complete-task/SKILL.en.md +23 -8
  275. package/templates/.agents/skills/complete-task/SKILL.zh-CN.md +23 -8
  276. package/templates/.agents/skills/complete-task/config/verify.en.json +1 -0
  277. package/templates/.agents/skills/complete-task/config/verify.zh-CN.json +1 -0
  278. package/templates/.agents/skills/complete-task/reference/external-delivery.en.md +17 -0
  279. package/templates/.agents/skills/complete-task/reference/external-delivery.zh-CN.md +17 -0
  280. package/templates/.agents/skills/create-pr/SKILL.en.md +13 -11
  281. package/templates/.agents/skills/create-pr/SKILL.zh-CN.md +13 -11
  282. package/templates/.agents/skills/create-pr/reference/comment-publish.en.md +1 -1
  283. package/templates/.agents/skills/create-pr/reference/comment-publish.zh-CN.md +1 -1
  284. package/templates/.agents/skills/create-pr/reference/pr-body-template.en.md +3 -3
  285. package/templates/.agents/skills/create-pr/reference/pr-body-template.zh-CN.md +3 -3
  286. package/templates/.agents/skills/create-release-note/SKILL.en.md +17 -16
  287. package/templates/.agents/skills/create-release-note/SKILL.zh-CN.md +17 -16
  288. package/templates/.agents/skills/create-task/SKILL.en.md +16 -14
  289. package/templates/.agents/skills/create-task/SKILL.zh-CN.md +16 -14
  290. package/templates/.agents/skills/import-codescan/SKILL.en.md +5 -5
  291. package/templates/.agents/skills/import-codescan/SKILL.zh-CN.md +5 -5
  292. package/templates/.agents/skills/import-dependabot/SKILL.en.md +5 -5
  293. package/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md +5 -5
  294. package/templates/.agents/skills/import-issue/SKILL.en.md +10 -8
  295. package/templates/.agents/skills/import-issue/SKILL.zh-CN.md +10 -8
  296. package/templates/.agents/skills/init-labels/SKILL.en.md +4 -4
  297. package/templates/.agents/skills/init-labels/SKILL.zh-CN.md +4 -4
  298. package/templates/.agents/skills/init-milestones/SKILL.en.md +4 -4
  299. package/templates/.agents/skills/init-milestones/SKILL.zh-CN.md +4 -4
  300. package/templates/.agents/skills/plan-task/SKILL.en.md +13 -10
  301. package/templates/.agents/skills/plan-task/SKILL.zh-CN.md +13 -10
  302. package/templates/.agents/skills/post-release/SKILL.en.md +2 -0
  303. package/templates/.agents/skills/post-release/SKILL.zh-CN.md +2 -0
  304. package/templates/.agents/skills/refine-title/SKILL.en.md +1 -1
  305. package/templates/.agents/skills/refine-title/SKILL.zh-CN.md +1 -1
  306. package/templates/.agents/skills/release/SKILL.en.md +16 -10
  307. package/templates/.agents/skills/release/SKILL.zh-CN.md +16 -10
  308. package/templates/.agents/skills/restore-task/SKILL.en.md +4 -1
  309. package/templates/.agents/skills/restore-task/SKILL.zh-CN.md +4 -1
  310. package/templates/.agents/skills/review-analysis/SKILL.en.md +18 -4
  311. package/templates/.agents/skills/review-analysis/SKILL.zh-CN.md +19 -5
  312. package/templates/.agents/skills/review-analysis/config/verify.en.json +6 -0
  313. package/templates/.agents/skills/review-analysis/config/verify.zh-CN.json +6 -0
  314. package/templates/.agents/skills/review-analysis/reference/output-templates.en.md +13 -15
  315. package/templates/.agents/skills/review-analysis/reference/output-templates.zh-CN.md +13 -15
  316. package/templates/.agents/skills/review-analysis/reference/report-template.en.md +51 -5
  317. package/templates/.agents/skills/review-analysis/reference/report-template.zh-CN.md +52 -6
  318. package/templates/.agents/skills/review-analysis/reference/review-criteria.en.md +25 -22
  319. package/templates/.agents/skills/review-analysis/reference/review-criteria.zh-CN.md +25 -22
  320. package/templates/.agents/skills/review-code/SKILL.en.md +35 -12
  321. package/templates/.agents/skills/review-code/SKILL.zh-CN.md +35 -12
  322. package/templates/.agents/skills/review-code/config/verify.en.json +7 -0
  323. package/templates/.agents/skills/review-code/config/verify.zh-CN.json +7 -0
  324. package/templates/.agents/skills/review-code/reference/concurrency-risks.en.md +25 -0
  325. package/templates/.agents/skills/review-code/reference/concurrency-risks.zh-CN.md +25 -0
  326. package/templates/.agents/skills/review-code/reference/cross-platform-risks.en.md +27 -0
  327. package/templates/.agents/skills/review-code/reference/cross-platform-risks.zh-CN.md +27 -0
  328. package/templates/.agents/skills/review-code/reference/documentation-antipatterns.en.md +13 -0
  329. package/templates/.agents/skills/review-code/reference/documentation-antipatterns.zh-CN.md +13 -0
  330. package/templates/.agents/skills/review-code/reference/migration-risks.en.md +25 -0
  331. package/templates/.agents/skills/review-code/reference/migration-risks.zh-CN.md +25 -0
  332. package/templates/.agents/skills/review-code/reference/output-templates.en.md +22 -24
  333. package/templates/.agents/skills/review-code/reference/output-templates.zh-CN.md +22 -24
  334. package/templates/.agents/skills/review-code/reference/report-template.en.md +54 -7
  335. package/templates/.agents/skills/review-code/reference/report-template.zh-CN.md +54 -7
  336. package/templates/.agents/skills/review-code/reference/review-criteria.en.md +29 -24
  337. package/templates/.agents/skills/review-code/reference/review-criteria.zh-CN.md +29 -24
  338. package/templates/.agents/skills/review-code/reference/security-risks.en.md +25 -0
  339. package/templates/.agents/skills/review-code/reference/security-risks.zh-CN.md +25 -0
  340. package/templates/.agents/skills/review-plan/SKILL.en.md +18 -4
  341. package/templates/.agents/skills/review-plan/SKILL.zh-CN.md +19 -5
  342. package/templates/.agents/skills/review-plan/config/verify.en.json +6 -0
  343. package/templates/.agents/skills/review-plan/config/verify.zh-CN.json +6 -0
  344. package/templates/.agents/skills/review-plan/reference/output-templates.en.md +13 -15
  345. package/templates/.agents/skills/review-plan/reference/output-templates.zh-CN.md +13 -15
  346. package/templates/.agents/skills/review-plan/reference/report-template.en.md +61 -5
  347. package/templates/.agents/skills/review-plan/reference/report-template.zh-CN.md +61 -5
  348. package/templates/.agents/skills/review-plan/reference/review-criteria.en.md +21 -24
  349. package/templates/.agents/skills/review-plan/reference/review-criteria.zh-CN.md +21 -24
  350. package/templates/.agents/skills/review-pr/SKILL.en.md +158 -0
  351. package/templates/.agents/skills/review-pr/SKILL.zh-CN.md +158 -0
  352. package/templates/.agents/skills/review-pr/config/verify.en.json +37 -0
  353. package/templates/.agents/skills/review-pr/config/verify.zh-CN.json +37 -0
  354. package/templates/.agents/skills/review-pr/reference/evidence-grading.en.md +65 -0
  355. package/templates/.agents/skills/review-pr/reference/evidence-grading.zh-CN.md +65 -0
  356. package/templates/.agents/skills/review-pr/reference/output-guidance.en.md +18 -0
  357. package/templates/.agents/skills/review-pr/reference/output-guidance.zh-CN.md +18 -0
  358. package/templates/.agents/skills/review-pr/reference/report-template.en.md +85 -0
  359. package/templates/.agents/skills/review-pr/reference/report-template.zh-CN.md +85 -0
  360. package/templates/.agents/skills/run-task/SKILL.en.md +22 -0
  361. package/templates/.agents/skills/run-task/SKILL.zh-CN.md +22 -0
  362. package/templates/.agents/skills/run-task/config/verify.en.json +10 -0
  363. package/templates/.agents/skills/run-task/config/verify.zh-CN.json +10 -0
  364. package/templates/.agents/skills/run-task/reference/host-validation.en.md +20 -0
  365. package/templates/.agents/skills/run-task/reference/host-validation.zh-CN.md +20 -0
  366. package/templates/.agents/skills/test/SKILL.en.md +4 -4
  367. package/templates/.agents/skills/test/SKILL.zh-CN.md +4 -4
  368. package/templates/.agents/skills/test-integration/SKILL.en.md +4 -4
  369. package/templates/.agents/skills/test-integration/SKILL.zh-CN.md +4 -4
  370. package/templates/.agents/skills/update-agent-infra/SKILL.en.md +5 -5
  371. package/templates/.agents/skills/update-agent-infra/SKILL.zh-CN.md +5 -5
  372. package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js +664 -246
  373. package/templates/.agents/skills/upgrade-dependency/SKILL.en.md +4 -4
  374. package/templates/.agents/skills/upgrade-dependency/SKILL.zh-CN.md +4 -4
  375. package/templates/.agents/skills/watch-pr/SKILL.en.md +21 -21
  376. package/templates/.agents/skills/watch-pr/SKILL.zh-CN.md +21 -21
  377. package/templates/.agents/skills/watch-pr/reference/monitor-and-heal.en.md +27 -6
  378. package/templates/.agents/skills/watch-pr/reference/monitor-and-heal.zh-CN.md +26 -5
  379. package/templates/.agents/templates/task.en.md +1 -1
  380. package/templates/.agents/templates/task.zh-CN.md +1 -1
  381. package/templates/.agents/workflows/bug-fix.en.yaml +3 -3
  382. package/templates/.agents/workflows/bug-fix.zh-CN.yaml +3 -3
  383. package/templates/.agents/workflows/code-review.en.yaml +1 -1
  384. package/templates/.agents/workflows/code-review.zh-CN.yaml +1 -1
  385. package/templates/.agents/workflows/feature-development.en.yaml +4 -4
  386. package/templates/.agents/workflows/feature-development.zh-CN.yaml +4 -4
  387. package/templates/.agents/workflows/refactoring.en.yaml +3 -3
  388. package/templates/.agents/workflows/refactoring.zh-CN.yaml +3 -3
  389. package/templates/.claude/agents/agent-infra-lifecycle-executor.en.md +6 -0
  390. package/templates/.claude/agents/agent-infra-lifecycle-executor.zh-CN.md +6 -0
  391. package/templates/.claude/agents/agent-infra-lifecycle-reviewer.en.md +6 -0
  392. package/templates/.claude/agents/agent-infra-lifecycle-reviewer.zh-CN.md +6 -0
  393. package/templates/.claude/commands/post-release.en.md +1 -0
  394. package/templates/.claude/commands/post-release.zh-CN.md +1 -0
  395. package/templates/.claude/commands/review-pr.en.md +8 -0
  396. package/templates/.claude/commands/review-pr.zh-CN.md +8 -0
  397. package/templates/.claude/commands/run-task.en.md +8 -0
  398. package/templates/.claude/commands/run-task.zh-CN.md +8 -0
  399. package/templates/.claude/settings.json +24 -0
  400. package/templates/.codex/agents/agent-infra-lifecycle-executor.en.toml +3 -0
  401. package/templates/.codex/agents/agent-infra-lifecycle-executor.zh-CN.toml +3 -0
  402. package/templates/.codex/agents/agent-infra-lifecycle-reviewer.en.toml +3 -0
  403. package/templates/.codex/agents/agent-infra-lifecycle-reviewer.zh-CN.toml +3 -0
  404. package/templates/.gemini/commands/_project_/review-pr.en.toml +10 -0
  405. package/templates/.gemini/commands/_project_/review-pr.zh-CN.toml +10 -0
  406. package/templates/.opencode/commands/post-release.en.md +2 -0
  407. package/templates/.opencode/commands/post-release.zh-CN.md +2 -0
  408. package/templates/.opencode/commands/review-pr.en.md +11 -0
  409. package/templates/.opencode/commands/review-pr.zh-CN.md +11 -0
  410. package/templates/.opencode/commands/run-task.en.md +11 -0
  411. package/templates/.opencode/commands/run-task.zh-CN.md +11 -0
  412. package/templates/.gemini/commands/_project_/analyze-task.en.toml +0 -10
  413. package/templates/.gemini/commands/_project_/analyze-task.zh-CN.toml +0 -10
  414. package/templates/.gemini/commands/_project_/archive-tasks.en.toml +0 -10
  415. package/templates/.gemini/commands/_project_/archive-tasks.zh-CN.toml +0 -10
  416. package/templates/.gemini/commands/_project_/block-task.en.toml +0 -10
  417. package/templates/.gemini/commands/_project_/block-task.zh-CN.toml +0 -10
  418. package/templates/.gemini/commands/_project_/cancel-task.en.toml +0 -10
  419. package/templates/.gemini/commands/_project_/cancel-task.zh-CN.toml +0 -10
  420. package/templates/.gemini/commands/_project_/check-task.en.toml +0 -10
  421. package/templates/.gemini/commands/_project_/check-task.zh-CN.toml +0 -10
  422. package/templates/.gemini/commands/_project_/close-codescan.en.toml +0 -8
  423. package/templates/.gemini/commands/_project_/close-codescan.zh-CN.toml +0 -8
  424. package/templates/.gemini/commands/_project_/close-dependabot.en.toml +0 -8
  425. package/templates/.gemini/commands/_project_/close-dependabot.zh-CN.toml +0 -8
  426. package/templates/.gemini/commands/_project_/code-task.en.toml +0 -10
  427. package/templates/.gemini/commands/_project_/code-task.zh-CN.toml +0 -10
  428. package/templates/.gemini/commands/_project_/commit.en.toml +0 -10
  429. package/templates/.gemini/commands/_project_/commit.zh-CN.toml +0 -10
  430. package/templates/.gemini/commands/_project_/complete-manual-validation.en.toml +0 -10
  431. package/templates/.gemini/commands/_project_/complete-manual-validation.zh-CN.toml +0 -10
  432. package/templates/.gemini/commands/_project_/complete-task.en.toml +0 -10
  433. package/templates/.gemini/commands/_project_/complete-task.zh-CN.toml +0 -10
  434. package/templates/.gemini/commands/_project_/create-pr.en.toml +0 -10
  435. package/templates/.gemini/commands/_project_/create-pr.zh-CN.toml +0 -10
  436. package/templates/.gemini/commands/_project_/create-release-note.en.toml +0 -8
  437. package/templates/.gemini/commands/_project_/create-release-note.zh-CN.toml +0 -8
  438. package/templates/.gemini/commands/_project_/create-task.en.toml +0 -8
  439. package/templates/.gemini/commands/_project_/create-task.zh-CN.toml +0 -8
  440. package/templates/.gemini/commands/_project_/import-codescan.en.toml +0 -8
  441. package/templates/.gemini/commands/_project_/import-codescan.zh-CN.toml +0 -8
  442. package/templates/.gemini/commands/_project_/import-dependabot.en.toml +0 -8
  443. package/templates/.gemini/commands/_project_/import-dependabot.zh-CN.toml +0 -8
  444. package/templates/.gemini/commands/_project_/import-issue.en.toml +0 -8
  445. package/templates/.gemini/commands/_project_/import-issue.zh-CN.toml +0 -8
  446. package/templates/.gemini/commands/_project_/init-labels.en.toml +0 -8
  447. package/templates/.gemini/commands/_project_/init-labels.zh-CN.toml +0 -8
  448. package/templates/.gemini/commands/_project_/init-milestones.en.toml +0 -10
  449. package/templates/.gemini/commands/_project_/init-milestones.zh-CN.toml +0 -10
  450. package/templates/.gemini/commands/_project_/plan-task.en.toml +0 -10
  451. package/templates/.gemini/commands/_project_/plan-task.zh-CN.toml +0 -10
  452. package/templates/.gemini/commands/_project_/post-release.en.toml +0 -6
  453. package/templates/.gemini/commands/_project_/post-release.zh-CN.toml +0 -6
  454. package/templates/.gemini/commands/_project_/refine-title.en.toml +0 -8
  455. package/templates/.gemini/commands/_project_/refine-title.zh-CN.toml +0 -8
  456. package/templates/.gemini/commands/_project_/release.en.toml +0 -8
  457. package/templates/.gemini/commands/_project_/release.zh-CN.toml +0 -8
  458. package/templates/.gemini/commands/_project_/restore-task.en.toml +0 -8
  459. package/templates/.gemini/commands/_project_/restore-task.zh-CN.toml +0 -8
  460. package/templates/.gemini/commands/_project_/review-analysis.en.toml +0 -10
  461. package/templates/.gemini/commands/_project_/review-analysis.zh-CN.toml +0 -10
  462. package/templates/.gemini/commands/_project_/review-code.en.toml +0 -10
  463. package/templates/.gemini/commands/_project_/review-code.zh-CN.toml +0 -10
  464. package/templates/.gemini/commands/_project_/review-plan.en.toml +0 -10
  465. package/templates/.gemini/commands/_project_/review-plan.zh-CN.toml +0 -10
  466. package/templates/.gemini/commands/_project_/test-integration.en.toml +0 -6
  467. package/templates/.gemini/commands/_project_/test-integration.zh-CN.toml +0 -6
  468. package/templates/.gemini/commands/_project_/test.en.toml +0 -6
  469. package/templates/.gemini/commands/_project_/test.zh-CN.toml +0 -6
  470. package/templates/.gemini/commands/_project_/update-agent-infra.en.toml +0 -6
  471. package/templates/.gemini/commands/_project_/update-agent-infra.zh-CN.toml +0 -6
  472. package/templates/.gemini/commands/_project_/upgrade-dependency.en.toml +0 -8
  473. package/templates/.gemini/commands/_project_/upgrade-dependency.zh-CN.toml +0 -8
  474. package/templates/.gemini/commands/_project_/watch-pr.en.toml +0 -10
  475. package/templates/.gemini/commands/_project_/watch-pr.zh-CN.toml +0 -10
  476. package/templates/.gemini/settings.json +0 -3
@@ -0,0 +1,236 @@
1
+ import crypto from 'node:crypto';
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import defaults from '../defaults.json' with { type: 'json' };
5
+ import { normalizeAgentClients, serializeAgentClients } from './config.js';
6
+ import { normalizeCustomTUIs } from './custom-tuis.js';
7
+ import { renderNextStepCommands } from './next-steps.js';
8
+ import { planAgentClientProjectAssets } from './project-assets.js';
9
+ import { listAgentClientAdapters, listEnabledAgentClientAdapters } from './registry.js';
10
+ function isRecord(value) {
11
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
12
+ }
13
+ function hash(content) {
14
+ return `sha256:${crypto.createHash('sha256').update(content).digest('hex')}`;
15
+ }
16
+ function trustedBaseline(value) {
17
+ return typeof value === 'string' && /^sha256:[a-f0-9]{64}$/.test(value)
18
+ ? value
19
+ : null;
20
+ }
21
+ function cloneState(state) {
22
+ return Object.fromEntries(Object.entries(state).map(([id, value]) => [id, { ...value }]));
23
+ }
24
+ function applyMutation(state, mutation) {
25
+ if (mutation.type === 'none')
26
+ return cloneState(state);
27
+ if (mutation.type === 'replace-state')
28
+ return cloneState(mutation.state);
29
+ return Object.fromEntries(Object.entries(state).map(([id, value]) => [
30
+ id,
31
+ id === mutation.id ? { ...value, enabled: mutation.value } : { ...value }
32
+ ]));
33
+ }
34
+ function registryFrom(value) {
35
+ const files = isRecord(value) ? value : {};
36
+ const strings = (candidate) => Array.isArray(candidate)
37
+ ? candidate.filter((entry) => typeof entry === 'string')
38
+ : [];
39
+ return {
40
+ managed: strings(files.managed),
41
+ merged: strings(files.merged),
42
+ ejected: strings(files.ejected)
43
+ };
44
+ }
45
+ function isPathOwnedByOtherPlatform(relativePath, platformType) {
46
+ const top = relativePath.replace(/\\/g, '/').replace(/^\.\//, '').split('/')[0] ?? '';
47
+ return top.startsWith('.')
48
+ && ['github', 'none'].includes(top.slice(1))
49
+ && top.slice(1) !== platformType;
50
+ }
51
+ function renderSeed(content, config) {
52
+ return content
53
+ .replaceAll('{{project}}', String(config.project ?? ''))
54
+ .replaceAll('{{org}}', String(config.org ?? ''));
55
+ }
56
+ function planAgentClientReconciliation(input) {
57
+ const normalized = normalizeAgentClients(input.config);
58
+ const desired = applyMutation(normalized.state, input.mutation);
59
+ const adapters = listAgentClientAdapters();
60
+ const current = registryFrom(input.config.files);
61
+ const sharedDefaults = {
62
+ managed: defaults.files.managed.filter((entry) => !isPathOwnedByOtherPlatform(entry, input.platformType)),
63
+ merged: defaults.files.merged.filter((entry) => !isPathOwnedByOtherPlatform(entry, input.platformType)),
64
+ ejected: defaults.files.ejected
65
+ };
66
+ const projectAssets = planAgentClientProjectAssets({
67
+ current,
68
+ sharedDefaults,
69
+ enabledAdapters: listEnabledAgentClientAdapters(desired),
70
+ allAdapters: adapters
71
+ });
72
+ const nextConfig = structuredClone(input.config);
73
+ nextConfig.agentClients = serializeAgentClients(desired);
74
+ delete nextConfig.tuis;
75
+ if (normalized.remainingSandboxTools !== undefined) {
76
+ const sandbox = isRecord(nextConfig.sandbox) ? { ...nextConfig.sandbox } : {};
77
+ sandbox.tools = [
78
+ 'agent-infra',
79
+ ...normalized.remainingSandboxTools.filter((tool) => tool !== 'agent-infra')
80
+ ];
81
+ nextConfig.sandbox = sandbox;
82
+ }
83
+ const existingFiles = isRecord(nextConfig.files) ? nextConfig.files : {};
84
+ const existingBaselines = isRecord(existingFiles.managedBaselines)
85
+ ? existingFiles.managedBaselines
86
+ : {};
87
+ const baselines = { ...existingBaselines };
88
+ nextConfig.files = {
89
+ ...existingFiles,
90
+ managed: [...projectAssets.registry.managed],
91
+ merged: [...projectAssets.registry.merged],
92
+ ejected: [...projectAssets.registry.ejected],
93
+ managedBaselines: baselines
94
+ };
95
+ const projectName = String(input.config.project ?? '');
96
+ const language = input.language === 'zh-CN' ? 'zh-CN' : 'en';
97
+ const seedOperations = [];
98
+ for (const adapter of adapters) {
99
+ for (const seed of adapter.project.seedCommands) {
100
+ const relativeTarget = seed.target.replaceAll('${projectName}', projectName);
101
+ const target = path.join(input.projectRoot, relativeTarget);
102
+ const templatePath = path.join(input.templateRoot, seed.templates[language]);
103
+ const content = renderSeed(fs.readFileSync(templatePath, 'utf8'), input.config);
104
+ const templateHash = hash(content);
105
+ const exists = fs.existsSync(target);
106
+ const localHash = exists ? hash(fs.readFileSync(target)) : null;
107
+ const baseline = trustedBaseline(baselines[relativeTarget]);
108
+ const enabled = desired[adapter.id].enabled;
109
+ if (enabled) {
110
+ if (!exists || (baseline !== null && localHash === baseline)) {
111
+ baselines[relativeTarget] = templateHash;
112
+ seedOperations.push({
113
+ kind: localHash === templateHash ? 'unchanged' : 'write',
114
+ clientId: adapter.id,
115
+ target: relativeTarget,
116
+ ...(localHash === templateHash ? {} : { content })
117
+ });
118
+ }
119
+ else if (localHash === templateHash) {
120
+ baselines[relativeTarget] = templateHash;
121
+ seedOperations.push({ kind: 'unchanged', clientId: adapter.id, target: relativeTarget });
122
+ }
123
+ else {
124
+ seedOperations.push({
125
+ kind: 'protect',
126
+ clientId: adapter.id,
127
+ target: relativeTarget,
128
+ reason: baseline ? 'user-modified' : 'unknown-origin'
129
+ });
130
+ }
131
+ }
132
+ else if (!exists) {
133
+ delete baselines[relativeTarget];
134
+ seedOperations.push({ kind: 'unchanged', clientId: adapter.id, target: relativeTarget });
135
+ }
136
+ else if ((baseline !== null && localHash === baseline) || localHash === templateHash) {
137
+ delete baselines[relativeTarget];
138
+ seedOperations.push({ kind: 'remove', clientId: adapter.id, target: relativeTarget });
139
+ }
140
+ else {
141
+ seedOperations.push({
142
+ kind: 'protect',
143
+ clientId: adapter.id,
144
+ target: relativeTarget,
145
+ reason: baseline ? 'user-modified' : 'unknown-origin'
146
+ });
147
+ }
148
+ }
149
+ }
150
+ if (Object.keys(baselines).length === 0) {
151
+ delete nextConfig.files.managedBaselines;
152
+ }
153
+ const custom = normalizeCustomTUIs(input.projectRoot, input.config.customTUIs ?? []);
154
+ const nextSteps = renderNextStepCommands({
155
+ projectName,
156
+ state: desired,
157
+ customTUIs: custom.items,
158
+ skillName: 'update-agent-infra'
159
+ });
160
+ const actionableSeed = seedOperations.some((operation) => operation.kind === 'write' || operation.kind === 'remove');
161
+ const changed = JSON.stringify(nextConfig) !== JSON.stringify(input.config)
162
+ || actionableSeed;
163
+ return Object.freeze({
164
+ source: normalized.source,
165
+ before: normalized.state,
166
+ desired,
167
+ nextConfig,
168
+ projectAssets,
169
+ seedOperations: Object.freeze(seedOperations),
170
+ nextSteps,
171
+ diagnostics: Object.freeze([...normalized.diagnostics, ...custom.diagnostics]),
172
+ changed,
173
+ projectRoot: input.projectRoot,
174
+ configPath: path.join(input.projectRoot, '.agents', '.airc.json')
175
+ });
176
+ }
177
+ function applyAgentClientReconciliation(plan, dependencies = {}) {
178
+ const mkdirSync = dependencies.mkdirSync ?? fs.mkdirSync;
179
+ const writeFileSync = dependencies.writeFileSync ?? fs.writeFileSync;
180
+ const renameSync = dependencies.renameSync ?? fs.renameSync;
181
+ const unlinkSync = dependencies.unlinkSync ?? fs.unlinkSync;
182
+ const applied = [];
183
+ const protectedTargets = [];
184
+ const unchanged = [];
185
+ for (const operation of plan.seedOperations) {
186
+ const target = path.join(plan.projectRoot, operation.target);
187
+ if (operation.kind === 'write') {
188
+ mkdirSync(path.dirname(target), { recursive: true });
189
+ writeFileSync(target, operation.content, 'utf8');
190
+ applied.push(operation.target);
191
+ }
192
+ else if (operation.kind === 'remove') {
193
+ if (fs.existsSync(target))
194
+ unlinkSync(target);
195
+ applied.push(operation.target);
196
+ }
197
+ else if (operation.kind === 'protect') {
198
+ protectedTargets.push(operation.target);
199
+ }
200
+ else {
201
+ unchanged.push(operation.target);
202
+ }
203
+ }
204
+ const serialized = `${JSON.stringify(plan.nextConfig, null, 2)}\n`;
205
+ const previous = fs.existsSync(plan.configPath)
206
+ ? fs.readFileSync(plan.configPath, 'utf8')
207
+ : null;
208
+ const configUpdated = previous !== serialized;
209
+ if (configUpdated) {
210
+ mkdirSync(path.dirname(plan.configPath), { recursive: true });
211
+ const temporary = `${plan.configPath}.tmp-${process.pid}-${Date.now()}`;
212
+ try {
213
+ writeFileSync(temporary, serialized, 'utf8');
214
+ renameSync(temporary, plan.configPath);
215
+ }
216
+ catch (error) {
217
+ try {
218
+ if (fs.existsSync(temporary))
219
+ unlinkSync(temporary);
220
+ }
221
+ catch {
222
+ // Preserve the original error; a later idempotent rerun can clean stale state.
223
+ }
224
+ throw error;
225
+ }
226
+ }
227
+ return Object.freeze({
228
+ status: configUpdated || applied.length > 0 ? 'applied' : 'unchanged',
229
+ configUpdated,
230
+ applied: Object.freeze(applied),
231
+ protected: Object.freeze(protectedTargets),
232
+ unchanged: Object.freeze(unchanged)
233
+ });
234
+ }
235
+ export { applyAgentClientReconciliation, planAgentClientReconciliation };
236
+ //# sourceMappingURL=reconcile.js.map
@@ -0,0 +1,78 @@
1
+ import { BUILTIN_AGENT_CLIENT_ADAPTERS } from './adapters/index.js';
2
+ import { AGENT_CLIENT_IDS, isAgentClientId } from './types.js';
3
+ function buildRegistry() {
4
+ if (BUILTIN_AGENT_CLIENT_ADAPTERS.length !== AGENT_CLIENT_IDS.length) {
5
+ throw new Error('Agent Client Registry is incomplete');
6
+ }
7
+ const byId = new Map(BUILTIN_AGENT_CLIENT_ADAPTERS.map((adapter) => [adapter.id, adapter]));
8
+ if (byId.size !== BUILTIN_AGENT_CLIENT_ADAPTERS.length) {
9
+ throw new Error('Agent Client Registry contains duplicate IDs');
10
+ }
11
+ const adapters = Object.freeze(AGENT_CLIENT_IDS.map((id) => {
12
+ const adapter = byId.get(id);
13
+ if (!adapter || adapter.id !== id) {
14
+ throw new Error(`Agent Client Registry is missing '${id}'`);
15
+ }
16
+ return adapter;
17
+ }));
18
+ const ownedPaths = adapters.flatMap((adapter) => adapter.project.ownedPathPrefixes.map((prefix) => ({
19
+ id: adapter.id,
20
+ prefix
21
+ })));
22
+ for (const [index, current] of ownedPaths.entries()) {
23
+ for (const other of ownedPaths.slice(index + 1)) {
24
+ if (current.id !== other.id
25
+ && (current.prefix.startsWith(other.prefix)
26
+ || other.prefix.startsWith(current.prefix))) {
27
+ throw new Error(`Agent Client owned paths overlap: '${current.prefix}' and '${other.prefix}'`);
28
+ }
29
+ }
30
+ }
31
+ const registry = Object.freeze(Object.fromEntries(adapters.map((adapter) => [adapter.id, adapter])));
32
+ return Object.freeze({ registry, adapters });
33
+ }
34
+ const built = buildRegistry();
35
+ const AGENT_CLIENT_REGISTRY = built.registry;
36
+ const AGENT_CLIENT_ADAPTERS = built.adapters;
37
+ function listAgentClientAdapters() {
38
+ return AGENT_CLIENT_ADAPTERS;
39
+ }
40
+ function getAgentClientAdapter(id) {
41
+ if (!isAgentClientId(id)) {
42
+ throw new Error(`No Agent Client adapter registered for '${String(id)}'`);
43
+ }
44
+ return AGENT_CLIENT_REGISTRY[id];
45
+ }
46
+ function listEnabledAgentClientAdapters(state) {
47
+ return Object.freeze(AGENT_CLIENT_ADAPTERS.filter((adapter) => state[adapter.id].enabled));
48
+ }
49
+ function listInstalledAgentClientAdapters(state) {
50
+ return Object.freeze(AGENT_CLIENT_ADAPTERS.filter((adapter) => state[adapter.id].installInSandbox));
51
+ }
52
+ function getAgentClientCapability(id, capability) {
53
+ return getAgentClientAdapter(id).capabilities[capability];
54
+ }
55
+ function getAgentClientModelSelection(id) {
56
+ return getAgentClientAdapter(id).modelSelection;
57
+ }
58
+ function getAgentClientDelegationEvidence(id) {
59
+ return getAgentClientAdapter(id).delegationEvidence;
60
+ }
61
+ function listEnabledAgentClientAdaptersByCapability(state, capability, acceptedLevels) {
62
+ const accepted = new Set(acceptedLevels);
63
+ return Object.freeze(AGENT_CLIENT_ADAPTERS.filter((adapter) => state[adapter.id].enabled
64
+ && accepted.has(adapter.capabilities[capability].level)));
65
+ }
66
+ function createAgentClientManifest() {
67
+ return Object.freeze(AGENT_CLIENT_ADAPTERS.map((adapter) => Object.freeze({
68
+ id: adapter.id,
69
+ displayName: adapter.displayName,
70
+ invocation: adapter.invocation,
71
+ ownedPathPrefixes: Object.freeze([...adapter.project.ownedPathPrefixes]),
72
+ managed: Object.freeze([...adapter.project.managed]),
73
+ merged: Object.freeze([...adapter.project.merged]),
74
+ ejected: Object.freeze([...adapter.project.ejected])
75
+ })));
76
+ }
77
+ export { AGENT_CLIENT_REGISTRY, createAgentClientManifest, getAgentClientAdapter, getAgentClientCapability, getAgentClientDelegationEvidence, getAgentClientModelSelection, listAgentClientAdapters, listEnabledAgentClientAdapters, listEnabledAgentClientAdaptersByCapability, listInstalledAgentClientAdapters };
78
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1,75 @@
1
+ import { AGENT_CLIENT_CAPABILITY_IDS, AGENT_CLIENT_IDS, AGENT_CLIENT_SUPPORT_LEVELS } from './types.js';
2
+ const AGENT_CLIENTS_SCHEMA = {
3
+ $schema: 'http://json-schema.org/draft-07/schema#',
4
+ type: 'object',
5
+ required: ['agentClients'],
6
+ properties: {
7
+ agentClients: {
8
+ type: 'array',
9
+ minItems: AGENT_CLIENT_IDS.length,
10
+ maxItems: AGENT_CLIENT_IDS.length,
11
+ uniqueItems: true,
12
+ description: 'Canonical Agent Client configuration. Object ID completeness and uniqueness are enforced by the runtime normalizer.',
13
+ items: {
14
+ type: 'object',
15
+ additionalProperties: false,
16
+ required: ['id', 'enabled', 'installInSandbox'],
17
+ properties: {
18
+ id: {
19
+ type: 'string',
20
+ enum: [...AGENT_CLIENT_IDS]
21
+ },
22
+ enabled: {
23
+ type: 'boolean'
24
+ },
25
+ installInSandbox: {
26
+ type: 'boolean'
27
+ },
28
+ orchestration: {
29
+ type: 'object',
30
+ additionalProperties: false,
31
+ required: ['executor', 'reviewer'],
32
+ properties: {
33
+ executor: { $ref: '#/definitions/orchestrationRolePolicy' },
34
+ reviewer: { $ref: '#/definitions/orchestrationRolePolicy' }
35
+ }
36
+ }
37
+ }
38
+ }
39
+ },
40
+ customTUIs: {
41
+ type: 'array',
42
+ items: {
43
+ type: 'object',
44
+ additionalProperties: true,
45
+ required: ['name', 'dir', 'invoke'],
46
+ properties: {
47
+ name: { type: 'string' },
48
+ dir: { type: 'string' },
49
+ invoke: { type: 'string' }
50
+ }
51
+ }
52
+ }
53
+ },
54
+ definitions: {
55
+ orchestrationRolePolicy: {
56
+ type: 'object',
57
+ additionalProperties: false,
58
+ required: ['model', 'reasoningEffort'],
59
+ properties: {
60
+ model: { type: 'string', minLength: 1 },
61
+ reasoningEffort: { type: 'string', minLength: 1 }
62
+ }
63
+ },
64
+ agentClientCapabilityId: {
65
+ type: 'string',
66
+ enum: [...AGENT_CLIENT_CAPABILITY_IDS]
67
+ },
68
+ agentClientSupportLevel: {
69
+ type: 'string',
70
+ enum: [...AGENT_CLIENT_SUPPORT_LEVELS]
71
+ }
72
+ }
73
+ };
74
+ export { AGENT_CLIENTS_SCHEMA };
75
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1,49 @@
1
+ // Active AI collaborator short tokens — the write-side whitelist for the
2
+ // activity log. Migrated from lib/task/commands/log.ts so that the write-side
3
+ // internal commands and the rendering side share one definition. Historical
4
+ // Gemini tokens remain read-only and are handled by classifyAgent below.
5
+ export const KNOWN_AI_AGENTS = new Set(['claude', 'codex', 'antigravity', 'opencode', 'cursor']);
6
+ // Long name -> short name mapping (HD-4, decision A): `claude-code` reuses the
7
+ // existing orchestration precedent, and `antigravity-cli` is the active
8
+ // client. `gemini-cli` is intentionally not writable.
9
+ export const AGENT_LONG_NAMES = {
10
+ 'claude-code': 'claude',
11
+ 'antigravity-cli': 'antigravity'
12
+ };
13
+ export const AGENT_USAGE_HINT = "agent must be a short token (claude/codex/antigravity/opencode/cursor), " +
14
+ "a long name (claude-code -> claude, antigravity-cli -> antigravity), or 'human'";
15
+ // Read-side historical compatibility for activity-log rendering: `gemini` and
16
+ // `gemini-cli` stay recognizable when displaying old logs, but are never
17
+ // accepted by normalizeAgentToken (write side).
18
+ const READ_KNOWN_AI_AGENTS = new Set([...KNOWN_AI_AGENTS, 'gemini']);
19
+ const READ_AGENT_LONG_NAMES = {
20
+ ...AGENT_LONG_NAMES,
21
+ 'gemini-cli': 'gemini'
22
+ };
23
+ // Strict write-side validation: the value must be exactly a short token, a
24
+ // long name, or 'human'; returns the normalized short token, or null when
25
+ // the value is not a recognized agent.
26
+ export function normalizeAgentToken(value) {
27
+ const trimmed = value.trim();
28
+ if (trimmed === 'human')
29
+ return 'human';
30
+ if (KNOWN_AI_AGENTS.has(trimmed))
31
+ return trimmed;
32
+ const short = AGENT_LONG_NAMES[trimmed];
33
+ return short ?? null;
34
+ }
35
+ // Loose rendering-side classification: tolerates historical parenthetical
36
+ // annotations; unknown tokens keep the `human` grouping but get a visible
37
+ // signal. The "known AI token" test is `classifyAgent(value).status === 'ai'`.
38
+ export function classifyAgent(raw) {
39
+ const token = raw.trim().split(/\s+/)[0]?.replace(/\(.*$/, '') ?? '';
40
+ if (token === '')
41
+ return { status: 'unknown', display: 'human' };
42
+ if (token === 'human')
43
+ return { status: 'human', display: 'human' };
44
+ if (READ_KNOWN_AI_AGENTS.has(token))
45
+ return { status: 'ai', display: token };
46
+ const short = READ_AGENT_LONG_NAMES[token];
47
+ return short ? { status: 'ai', display: short } : { status: 'unknown', display: 'human' };
48
+ }
49
+ //# sourceMappingURL=tokens.js.map
@@ -0,0 +1,29 @@
1
+ const AGENT_CLIENT_IDS = [
2
+ 'claude-code',
3
+ 'codex',
4
+ 'antigravity-cli',
5
+ 'opencode'
6
+ ];
7
+ const AGENT_CLIENT_CAPABILITY_IDS = [
8
+ 'instructions',
9
+ 'skills',
10
+ 'commands',
11
+ 'hooks',
12
+ 'subagents',
13
+ 'orchestration',
14
+ 'sandbox',
15
+ 'verification'
16
+ ];
17
+ const AGENT_CLIENT_SUPPORT_LEVELS = [
18
+ 'compatible',
19
+ 'integrated',
20
+ 'verified',
21
+ 'experimental',
22
+ 'unsupported'
23
+ ];
24
+ function isAgentClientId(value) {
25
+ return typeof value === 'string'
26
+ && AGENT_CLIENT_IDS.includes(value);
27
+ }
28
+ export { AGENT_CLIENT_IDS, AGENT_CLIENT_CAPABILITY_IDS, AGENT_CLIENT_SUPPORT_LEVELS, isAgentClientId };
29
+ //# sourceMappingURL=types.js.map
@@ -1,18 +1,13 @@
1
- const BUILTIN_TUI_IDS = ['claude-code', 'codex', 'gemini-cli', 'opencode'];
2
- const BUILTIN_TUI_DISPLAY = {
3
- 'claude-code': 'Claude Code',
4
- 'codex': 'Codex',
5
- 'gemini-cli': 'Gemini CLI',
6
- 'opencode': 'OpenCode'
7
- };
8
- const BUILTIN_TUI_OWNED_PATH_PREFIXES = {
9
- 'claude-code': ['.claude/'],
10
- 'codex': ['.codex/'],
11
- 'gemini-cli': ['.gemini/'],
12
- 'opencode': ['.opencode/']
13
- };
1
+ import { AGENT_CLIENT_IDS, isAgentClientId } from './agent-clients/types.js';
2
+ import { listAgentClientAdapters } from './agent-clients/registry.js';
3
+ const BUILTIN_TUI_IDS = AGENT_CLIENT_IDS;
4
+ const BUILTIN_TUI_DISPLAY = Object.fromEntries(listAgentClientAdapters().map((adapter) => [adapter.id, adapter.displayName]));
5
+ const BUILTIN_TUI_OWNED_PATH_PREFIXES = Object.fromEntries(listAgentClientAdapters().map((adapter) => [
6
+ adapter.id,
7
+ [...adapter.project.ownedPathPrefixes]
8
+ ]));
14
9
  function isBuiltinTUIId(value) {
15
- return typeof value === 'string' && BUILTIN_TUI_IDS.includes(value);
10
+ return isAgentClientId(value);
16
11
  }
17
12
  function resolveEnabledTUIs(value) {
18
13
  // Missing field / null / non-array → full set (backward compat for legacy
@@ -1,77 +1,89 @@
1
1
  {
2
- "platform": {
3
- "type": "github"
4
- },
5
- "sandbox": {
6
- "engine": null,
7
- "runtimes": [
8
- "node22"
2
+ "platform": {
3
+ "type": "github"
4
+ },
5
+ "agentClients": [
6
+ {
7
+ "id": "claude-code",
8
+ "enabled": true,
9
+ "installInSandbox": true
10
+ },
11
+ {
12
+ "id": "codex",
13
+ "enabled": true,
14
+ "installInSandbox": true
15
+ },
16
+ {
17
+ "id": "antigravity-cli",
18
+ "enabled": true,
19
+ "installInSandbox": true
20
+ },
21
+ {
22
+ "id": "opencode",
23
+ "enabled": true,
24
+ "installInSandbox": true
25
+ }
9
26
  ],
10
- "tools": [
11
- "agent-infra",
12
- "claude-code",
13
- "codex",
14
- "gemini-cli",
15
- "opencode"
16
- ],
17
- "refreshIntervalDays": 7,
18
- "dockerfile": null,
19
- "vm": {
20
- "cpu": null,
21
- "memory": null,
22
- "disk": null
27
+ "sandbox": {
28
+ "engine": null,
29
+ "runtimes": [
30
+ "node22"
31
+ ],
32
+ "tools": [
33
+ "agent-infra"
34
+ ],
35
+ "refreshIntervalDays": 7,
36
+ "dockerfile": null,
37
+ "vm": {
38
+ "cpu": null,
39
+ "memory": null,
40
+ "disk": null
41
+ }
42
+ },
43
+ "task": {
44
+ "shortIdLength": 2
45
+ },
46
+ "labels": {
47
+ "in": {}
48
+ },
49
+ "files": {
50
+ "managed": [
51
+ ".agents/QUICKSTART.md",
52
+ ".agents/README.md",
53
+ ".agents/hooks/",
54
+ ".agents/rules/",
55
+ ".agents/scripts/",
56
+ ".agents/skills/",
57
+ ".agents/templates/",
58
+ ".agents/workflows/",
59
+ ".agents/workspace/README.md",
60
+ ".git-hooks/check-large-files.cjs",
61
+ ".git-hooks/check-version-format.sh",
62
+ ".github/scripts/",
63
+ ".github/workflows/metadata-sync.yml",
64
+ ".github/workflows/pr-label.yml",
65
+ ".github/workflows/status-label.yml"
66
+ ],
67
+ "guardedManaged": [
68
+ ".github/workflows/metadata-sync.yml",
69
+ ".github/workflows/pr-label.yml",
70
+ ".github/workflows/status-label.yml"
71
+ ],
72
+ "merged": [
73
+ "**/post-release.*",
74
+ "**/release.*",
75
+ "**/test-integration.*",
76
+ "**/test.*",
77
+ "**/upgrade-dependency.*",
78
+ ".agents/rules/testing-discipline.*",
79
+ ".agents/skills/post-release/SKILL.*",
80
+ ".agents/skills/release/SKILL.*",
81
+ ".agents/skills/test-integration/SKILL.*",
82
+ ".agents/skills/test/SKILL.*",
83
+ ".agents/skills/upgrade-dependency/SKILL.*",
84
+ ".git-hooks/pre-commit",
85
+ ".gitignore"
86
+ ],
87
+ "ejected": []
23
88
  }
24
- },
25
- "task": {
26
- "shortIdLength": 2
27
- },
28
- "labels": {
29
- "in": {}
30
- },
31
- "files": {
32
- "managed": [
33
- ".agents/QUICKSTART.md",
34
- ".agents/README.md",
35
- ".agents/hooks/",
36
- ".agents/rules/",
37
- ".agents/scripts/",
38
- ".agents/skills/",
39
- ".agents/templates/",
40
- ".agents/workflows/",
41
- ".agents/workspace/README.md",
42
- ".claude/commands/",
43
- ".codex/hooks.json",
44
- ".gemini/commands/",
45
- ".git-hooks/check-large-files.cjs",
46
- ".git-hooks/check-version-format.sh",
47
- ".github/scripts/",
48
- ".github/workflows/metadata-sync.yml",
49
- ".github/workflows/pr-label.yml",
50
- ".github/workflows/status-label.yml",
51
- ".opencode/commands/"
52
- ],
53
- "guardedManaged": [
54
- ".github/workflows/metadata-sync.yml",
55
- ".github/workflows/pr-label.yml",
56
- ".github/workflows/status-label.yml"
57
- ],
58
- "merged": [
59
- "**/post-release.*",
60
- "**/release.*",
61
- "**/test-integration.*",
62
- "**/test.*",
63
- "**/upgrade-dependency.*",
64
- ".agents/rules/testing-discipline.*",
65
- ".agents/skills/post-release/SKILL.*",
66
- ".agents/skills/release/SKILL.*",
67
- ".agents/skills/test-integration/SKILL.*",
68
- ".agents/skills/test/SKILL.*",
69
- ".agents/skills/upgrade-dependency/SKILL.*",
70
- ".claude/settings.json",
71
- ".gemini/settings.json",
72
- ".git-hooks/pre-commit",
73
- ".gitignore"
74
- ],
75
- "ejected": []
76
- }
77
89
  }