@fitlab-ai/agent-infra 0.8.5 → 0.9.1

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 (467) hide show
  1. package/README.md +6 -1
  2. package/README.zh-CN.md +5 -1
  3. package/bin/cli.ts +2 -2
  4. package/dist/bin/cli.js +2 -2
  5. package/dist/bin/internal-cli.js +103 -0
  6. package/dist/lib/decide.js +81 -90
  7. package/dist/lib/defaults.json +1 -0
  8. package/dist/lib/git/review-snapshot.js +79 -0
  9. package/dist/lib/git/workflow.js +101 -0
  10. package/dist/lib/internal/git-workflow.js +42 -0
  11. package/dist/lib/internal/platform-checks.js +119 -0
  12. package/dist/lib/internal/platform-comment.js +129 -0
  13. package/dist/lib/internal/platform-context.js +46 -0
  14. package/dist/lib/internal/platform-issue.js +142 -0
  15. package/dist/lib/internal/platform-pr.js +146 -0
  16. package/dist/lib/internal/platform-release-notes.js +53 -0
  17. package/dist/lib/internal/release-workflow.js +320 -0
  18. package/dist/lib/internal/task-artifact.js +67 -0
  19. package/dist/lib/internal/task-context.js +43 -0
  20. package/dist/lib/internal/task-event.js +70 -0
  21. package/dist/lib/internal/task-ledger.js +114 -0
  22. package/dist/lib/internal/task-lifecycle.js +58 -0
  23. package/dist/lib/internal/task-short-id.js +83 -0
  24. package/dist/lib/internal/task-snapshot.js +47 -0
  25. package/dist/lib/internal/task-verify.js +50 -0
  26. package/dist/lib/internal/task-warning.js +74 -0
  27. package/dist/lib/platform/adapters.js +14 -0
  28. package/dist/lib/platform/context.js +146 -0
  29. package/dist/lib/platform/github-client.js +124 -0
  30. package/dist/lib/platform/github-release-notes.js +96 -0
  31. package/dist/lib/platform/issue-comments.js +409 -0
  32. package/dist/lib/platform/issue-metadata.js +183 -0
  33. package/dist/lib/platform/issues.js +619 -0
  34. package/dist/lib/platform/merged-pr-equivalence.js +54 -0
  35. package/dist/lib/platform/metadata-labels.js +28 -0
  36. package/dist/lib/platform/pr-checks.js +216 -0
  37. package/dist/lib/platform/pr-summary.js +88 -0
  38. package/dist/lib/platform/pull-request-metadata.js +38 -0
  39. package/dist/lib/platform/pull-requests.js +340 -0
  40. package/dist/lib/platform/release-notes.js +143 -0
  41. package/dist/lib/platform/releases.js +82 -0
  42. package/dist/lib/platform/types.js +22 -0
  43. package/dist/lib/platform/verification-required.js +102 -0
  44. package/dist/lib/platform/verification-sync.js +1014 -0
  45. package/dist/lib/platform/verification.js +6 -0
  46. package/dist/lib/release/channels.js +31 -0
  47. package/dist/lib/release/workflow.js +32 -0
  48. package/dist/lib/render.js +3 -2
  49. package/dist/lib/run/index.js +24 -7
  50. package/dist/lib/sandbox/build-proxy.js +63 -0
  51. package/dist/lib/sandbox/capture.js +25 -3
  52. package/dist/lib/sandbox/commands/create.js +93 -31
  53. package/dist/lib/sandbox/commands/enter.js +34 -11
  54. package/dist/lib/sandbox/commands/list-running.js +10 -8
  55. package/dist/lib/sandbox/commands/rebuild.js +24 -7
  56. package/dist/lib/sandbox/commands/show.js +2 -2
  57. package/dist/lib/sandbox/commands/start.js +53 -15
  58. package/dist/lib/sandbox/image-build.js +2 -1
  59. package/dist/lib/sandbox/index.js +6 -6
  60. package/dist/lib/sandbox/mounts.js +36 -0
  61. package/dist/lib/sandbox/recovery.js +562 -0
  62. package/dist/lib/sandbox/runtimes/ai-tools.dockerfile +24 -3
  63. package/dist/lib/sandbox/runtimes/base.dockerfile +8 -1
  64. package/dist/lib/sandbox/runtimes/java17.dockerfile +8 -1
  65. package/dist/lib/sandbox/runtimes/java21.dockerfile +8 -1
  66. package/dist/lib/sandbox/runtimes/node20.dockerfile +8 -1
  67. package/dist/lib/sandbox/runtimes/node22.dockerfile +8 -1
  68. package/dist/lib/sandbox/runtimes/python3.dockerfile +8 -1
  69. package/dist/lib/sandbox/shell.js +2 -1
  70. package/dist/lib/sandbox/task-resolver.js +5 -1
  71. package/dist/lib/sandbox/tools.js +19 -0
  72. package/dist/lib/server/protocol.js +5 -5
  73. package/dist/lib/task/activity-log.js +61 -0
  74. package/dist/lib/task/artifact-lifecycle.js +427 -0
  75. package/dist/lib/task/command-options.js +30 -0
  76. package/dist/lib/task/commands/cat.js +36 -6
  77. package/dist/lib/task/commands/decisions.js +80 -46
  78. package/dist/lib/task/commands/files.js +21 -7
  79. package/dist/lib/task/commands/grep.js +55 -7
  80. package/dist/lib/task/commands/issue-body.js +33 -19
  81. package/dist/lib/task/commands/log.js +27 -70
  82. package/dist/lib/task/commands/show.js +20 -7
  83. package/dist/lib/task/commands/status.js +18 -8
  84. package/dist/lib/task/decision-intents.js +154 -0
  85. package/dist/lib/task/decision-items.js +53 -0
  86. package/dist/lib/task/events.js +318 -0
  87. package/dist/lib/task/frontmatter.js +159 -1
  88. package/dist/lib/task/implementation-inputs.js +117 -0
  89. package/dist/lib/task/index.js +12 -9
  90. package/dist/lib/task/issue-form.js +21 -6
  91. package/dist/lib/task/ledger-intents.js +185 -0
  92. package/dist/lib/task/ledger.js +65 -35
  93. package/dist/lib/task/lifecycle.js +484 -0
  94. package/dist/lib/task/resolve-ref.js +152 -32
  95. package/dist/lib/task/review-artifacts.js +101 -0
  96. package/dist/lib/task/review-fingerprint.js +55 -0
  97. package/dist/lib/task/sections.js +358 -4
  98. package/dist/lib/task/short-id.js +292 -7
  99. package/dist/lib/task/snapshot.js +95 -0
  100. package/dist/lib/task/verification-checks.js +8 -0
  101. package/dist/lib/task/verification-config.js +14 -0
  102. package/dist/lib/task/verification-engine.js +923 -0
  103. package/dist/lib/task/verification-review.js +3 -0
  104. package/dist/lib/task/verification-types.js +2 -0
  105. package/dist/lib/task/verification.js +113 -0
  106. package/dist/lib/task/workflow-warning-intents.js +131 -0
  107. package/dist/lib/task/workflow-warnings.js +10 -78
  108. package/dist/lib/task/write.js +241 -0
  109. package/lib/decide.ts +57 -97
  110. package/lib/defaults.json +1 -0
  111. package/lib/git/review-snapshot.ts +73 -0
  112. package/lib/git/workflow.ts +101 -0
  113. package/lib/internal/git-workflow.ts +37 -0
  114. package/lib/internal/platform-checks.ts +101 -0
  115. package/lib/internal/platform-comment.ts +99 -0
  116. package/lib/internal/platform-context.ts +33 -0
  117. package/lib/internal/platform-issue.ts +116 -0
  118. package/lib/internal/platform-pr.ts +119 -0
  119. package/lib/internal/platform-release-notes.ts +55 -0
  120. package/lib/internal/release-workflow.ts +288 -0
  121. package/lib/internal/task-artifact.ts +47 -0
  122. package/lib/internal/task-context.ts +35 -0
  123. package/lib/internal/task-event.ts +51 -0
  124. package/lib/internal/task-ledger.ts +86 -0
  125. package/lib/internal/task-lifecycle.ts +41 -0
  126. package/lib/internal/task-short-id.ts +55 -0
  127. package/lib/internal/task-snapshot.ts +32 -0
  128. package/lib/internal/task-verify.ts +33 -0
  129. package/lib/internal/task-warning.ts +50 -0
  130. package/lib/platform/adapters.ts +30 -0
  131. package/lib/platform/context.ts +164 -0
  132. package/lib/platform/github-client.ts +146 -0
  133. package/lib/platform/github-release-notes.ts +132 -0
  134. package/lib/platform/issue-comments.ts +479 -0
  135. package/lib/platform/issue-metadata.ts +250 -0
  136. package/lib/platform/issues.ts +693 -0
  137. package/lib/platform/merged-pr-equivalence.ts +70 -0
  138. package/lib/platform/metadata-labels.ts +33 -0
  139. package/lib/platform/pr-checks.ts +247 -0
  140. package/lib/platform/pr-summary.ts +90 -0
  141. package/lib/platform/pull-request-metadata.ts +69 -0
  142. package/lib/platform/pull-requests.ts +386 -0
  143. package/lib/platform/release-notes.ts +167 -0
  144. package/lib/platform/releases.ts +71 -0
  145. package/lib/platform/types.ts +74 -0
  146. package/lib/platform/verification-required.ts +109 -0
  147. package/{runtime/platform-adapters/platform-sync.github.js → lib/platform/verification-sync.ts} +198 -367
  148. package/lib/platform/verification.ts +11 -0
  149. package/lib/release/channels.ts +30 -0
  150. package/lib/release/workflow.ts +31 -0
  151. package/lib/render.ts +3 -2
  152. package/lib/run/index.ts +25 -7
  153. package/lib/sandbox/build-proxy.ts +94 -0
  154. package/lib/sandbox/capture.ts +29 -3
  155. package/lib/sandbox/commands/create.ts +120 -36
  156. package/lib/sandbox/commands/enter.ts +38 -11
  157. package/lib/sandbox/commands/list-running.ts +10 -8
  158. package/lib/sandbox/commands/rebuild.ts +29 -7
  159. package/lib/sandbox/commands/show.ts +2 -2
  160. package/lib/sandbox/commands/start.ts +50 -16
  161. package/lib/sandbox/image-build.ts +4 -1
  162. package/lib/sandbox/index.ts +6 -6
  163. package/lib/sandbox/mounts.ts +55 -0
  164. package/lib/sandbox/recovery.ts +828 -0
  165. package/lib/sandbox/runtimes/ai-tools.dockerfile +24 -3
  166. package/lib/sandbox/runtimes/base.dockerfile +8 -1
  167. package/lib/sandbox/runtimes/java17.dockerfile +8 -1
  168. package/lib/sandbox/runtimes/java21.dockerfile +8 -1
  169. package/lib/sandbox/runtimes/node20.dockerfile +8 -1
  170. package/lib/sandbox/runtimes/node22.dockerfile +8 -1
  171. package/lib/sandbox/runtimes/python3.dockerfile +8 -1
  172. package/lib/sandbox/shell.ts +3 -1
  173. package/lib/sandbox/task-resolver.ts +5 -1
  174. package/lib/sandbox/tools.ts +31 -0
  175. package/lib/server/protocol.ts +5 -5
  176. package/lib/task/activity-log.ts +62 -0
  177. package/lib/task/artifact-lifecycle.ts +484 -0
  178. package/lib/task/command-options.ts +32 -0
  179. package/lib/task/commands/cat.ts +22 -9
  180. package/lib/task/commands/decisions.ts +49 -47
  181. package/lib/task/commands/files.ts +14 -6
  182. package/lib/task/commands/grep.ts +34 -7
  183. package/lib/task/commands/issue-body.ts +26 -21
  184. package/lib/task/commands/log.ts +17 -70
  185. package/lib/task/commands/show.ts +14 -6
  186. package/lib/task/commands/status.ts +17 -7
  187. package/lib/task/decision-intents.ts +163 -0
  188. package/lib/task/decision-items.ts +64 -0
  189. package/lib/task/events.ts +320 -0
  190. package/lib/task/frontmatter.ts +202 -2
  191. package/lib/task/implementation-inputs.ts +137 -0
  192. package/lib/task/index.ts +12 -9
  193. package/lib/task/issue-form.ts +24 -6
  194. package/lib/task/ledger-intents.ts +201 -0
  195. package/lib/task/ledger.ts +77 -31
  196. package/lib/task/lifecycle.ts +458 -0
  197. package/lib/task/resolve-ref.ts +197 -36
  198. package/{templates/.agents/scripts/lib/review-artifacts.js → lib/task/review-artifacts.ts} +11 -12
  199. package/{templates/.agents/scripts/lib/post-review-commit.js → lib/task/review-fingerprint.ts} +26 -12
  200. package/lib/task/sections.ts +486 -4
  201. package/lib/task/short-id.ts +403 -9
  202. package/lib/task/snapshot.ts +143 -0
  203. package/lib/task/verification-checks.ts +9 -0
  204. package/lib/task/verification-config.ts +20 -0
  205. package/{templates/.agents/scripts/validate-artifact.js → lib/task/verification-engine.ts} +230 -421
  206. package/lib/task/verification-review.ts +10 -0
  207. package/lib/task/verification-types.ts +29 -0
  208. package/lib/task/verification.ts +156 -0
  209. package/lib/task/workflow-warning-intents.ts +142 -0
  210. package/lib/task/workflow-warnings.ts +10 -78
  211. package/lib/task/write.ts +468 -0
  212. package/package.json +4 -2
  213. package/templates/.agents/README.en.md +4 -3
  214. package/templates/.agents/README.zh-CN.md +4 -3
  215. package/templates/.agents/rules/README.en.md +6 -5
  216. package/templates/.agents/rules/README.zh-CN.md +6 -5
  217. package/templates/.agents/rules/create-issue.en.md +1 -1
  218. package/templates/.agents/rules/create-issue.github.en.md +5 -184
  219. package/templates/.agents/rules/create-issue.github.zh-CN.md +12 -178
  220. package/templates/.agents/rules/create-issue.zh-CN.md +1 -1
  221. package/templates/.agents/rules/human-decision-context.en.md +36 -0
  222. package/templates/.agents/rules/human-decision-context.zh-CN.md +36 -0
  223. package/templates/.agents/rules/issue-fields.github.en.md +4 -148
  224. package/templates/.agents/rules/issue-fields.github.zh-CN.md +9 -144
  225. package/templates/.agents/rules/issue-pr-commands.en.md +43 -3
  226. package/templates/.agents/rules/issue-pr-commands.github.en.md +15 -220
  227. package/templates/.agents/rules/issue-pr-commands.github.zh-CN.md +23 -213
  228. package/templates/.agents/rules/issue-pr-commands.zh-CN.md +45 -3
  229. package/templates/.agents/rules/issue-sync.en.md +1 -1
  230. package/templates/.agents/rules/issue-sync.github.en.md +14 -301
  231. package/templates/.agents/rules/issue-sync.github.zh-CN.md +36 -287
  232. package/templates/.agents/rules/issue-sync.zh-CN.md +1 -1
  233. package/templates/.agents/rules/milestone-inference.en.md +1 -1
  234. package/templates/.agents/rules/milestone-inference.github.en.md +7 -119
  235. package/templates/.agents/rules/milestone-inference.github.zh-CN.md +8 -108
  236. package/templates/.agents/rules/milestone-inference.zh-CN.md +1 -1
  237. package/templates/.agents/rules/next-step-output.en.md +12 -11
  238. package/templates/.agents/rules/next-step-output.zh-CN.md +12 -11
  239. package/templates/.agents/rules/no-mid-flow-questions.en.md +3 -3
  240. package/templates/.agents/rules/no-mid-flow-questions.zh-CN.md +3 -3
  241. package/templates/.agents/rules/pr-checks-commands.en.md +16 -3
  242. package/templates/.agents/rules/pr-checks-commands.github.en.md +10 -54
  243. package/templates/.agents/rules/pr-checks-commands.github.zh-CN.md +19 -47
  244. package/templates/.agents/rules/pr-checks-commands.zh-CN.md +30 -3
  245. package/templates/.agents/rules/pr-sync.en.md +30 -3
  246. package/templates/.agents/rules/pr-sync.github.en.md +12 -115
  247. package/templates/.agents/rules/pr-sync.github.zh-CN.md +26 -104
  248. package/templates/.agents/rules/pr-sync.zh-CN.md +43 -3
  249. package/templates/.agents/rules/release-commands.en.md +2 -2
  250. package/templates/.agents/rules/release-commands.github.en.md +10 -40
  251. package/templates/.agents/rules/release-commands.github.zh-CN.md +9 -39
  252. package/templates/.agents/rules/release-commands.zh-CN.md +2 -2
  253. package/templates/.agents/rules/review-handshake.en.md +10 -6
  254. package/templates/.agents/rules/review-handshake.zh-CN.md +10 -6
  255. package/templates/.agents/rules/task-management.en.md +11 -2
  256. package/templates/.agents/rules/task-management.zh-CN.md +11 -3
  257. package/templates/.agents/rules/task-short-id.en.md +25 -29
  258. package/templates/.agents/rules/task-short-id.zh-CN.md +20 -23
  259. package/templates/.agents/rules/testing-discipline.en.md +20 -2
  260. package/templates/.agents/rules/testing-discipline.zh-CN.md +20 -2
  261. package/templates/.agents/scripts/lib/agent-infra-package.js +1 -9
  262. package/templates/.agents/scripts/task-short-id.js +71 -533
  263. package/templates/.agents/skills/analyze-task/SKILL.en.md +26 -56
  264. package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md +30 -60
  265. package/templates/.agents/skills/analyze-task/config/verify.en.json +1 -3
  266. package/templates/.agents/skills/analyze-task/config/verify.zh-CN.json +1 -3
  267. package/templates/.agents/skills/block-task/SKILL.en.md +21 -47
  268. package/templates/.agents/skills/block-task/SKILL.zh-CN.md +23 -47
  269. package/templates/.agents/skills/block-task/config/verify.json +1 -2
  270. package/templates/.agents/skills/cancel-task/SKILL.en.md +16 -45
  271. package/templates/.agents/skills/cancel-task/SKILL.zh-CN.md +16 -45
  272. package/templates/.agents/skills/cancel-task/config/verify.json +1 -2
  273. package/templates/.agents/skills/check-task/SKILL.en.md +6 -3
  274. package/templates/.agents/skills/check-task/SKILL.zh-CN.md +6 -3
  275. package/templates/.agents/skills/close-codescan/SKILL.en.md +6 -24
  276. package/templates/.agents/skills/close-codescan/SKILL.zh-CN.md +6 -24
  277. package/templates/.agents/skills/close-dependabot/SKILL.en.md +6 -24
  278. package/templates/.agents/skills/close-dependabot/SKILL.zh-CN.md +6 -24
  279. package/templates/.agents/skills/code-task/SKILL.en.md +22 -35
  280. package/templates/.agents/skills/code-task/SKILL.zh-CN.md +28 -44
  281. package/templates/.agents/skills/code-task/config/verify.en.json +3 -3
  282. package/templates/.agents/skills/code-task/config/verify.zh-CN.json +3 -3
  283. package/templates/.agents/skills/code-task/reference/dual-mode.en.md +13 -9
  284. package/templates/.agents/skills/code-task/reference/dual-mode.zh-CN.md +13 -9
  285. package/templates/.agents/skills/code-task/reference/fix-mode.en.md +1 -1
  286. package/templates/.agents/skills/code-task/reference/fix-mode.zh-CN.md +1 -1
  287. package/templates/.agents/skills/code-task/reference/report-template.en.md +11 -1
  288. package/templates/.agents/skills/code-task/reference/report-template.zh-CN.md +11 -1
  289. package/templates/.agents/skills/commit/SKILL.en.md +13 -11
  290. package/templates/.agents/skills/commit/SKILL.zh-CN.md +13 -11
  291. package/templates/.agents/skills/commit/config/verify.json +1 -2
  292. package/templates/.agents/skills/commit/reference/commit-message.en.md +1 -11
  293. package/templates/.agents/skills/commit/reference/commit-message.zh-CN.md +1 -11
  294. package/templates/.agents/skills/commit/reference/issue-metadata-sync.en.md +4 -8
  295. package/templates/.agents/skills/commit/reference/issue-metadata-sync.zh-CN.md +4 -8
  296. package/templates/.agents/skills/commit/reference/pr-summary-sync.en.md +6 -18
  297. package/templates/.agents/skills/commit/reference/pr-summary-sync.zh-CN.md +5 -17
  298. package/templates/.agents/skills/commit/reference/task-status-update.en.md +13 -0
  299. package/templates/.agents/skills/commit/reference/task-status-update.zh-CN.md +13 -0
  300. package/templates/.agents/skills/complete-manual-validation/SKILL.en.md +13 -36
  301. package/templates/.agents/skills/complete-manual-validation/SKILL.zh-CN.md +13 -36
  302. package/templates/.agents/skills/complete-manual-validation/config/verify.en.json +1 -3
  303. package/templates/.agents/skills/complete-manual-validation/config/verify.zh-CN.json +1 -3
  304. package/templates/.agents/skills/complete-manual-validation/reference/summary-update.en.md +10 -54
  305. package/templates/.agents/skills/complete-manual-validation/reference/summary-update.zh-CN.md +10 -79
  306. package/templates/.agents/skills/complete-task/SKILL.en.md +59 -63
  307. package/templates/.agents/skills/complete-task/SKILL.zh-CN.md +59 -63
  308. package/templates/.agents/skills/complete-task/config/verify.en.json +10 -7
  309. package/templates/.agents/skills/complete-task/config/verify.zh-CN.json +10 -7
  310. package/templates/.agents/skills/create-pr/SKILL.en.md +19 -44
  311. package/templates/.agents/skills/create-pr/SKILL.zh-CN.md +19 -43
  312. package/templates/.agents/skills/create-pr/config/verify.json +1 -2
  313. package/templates/.agents/skills/create-pr/reference/comment-publish.en.md +8 -12
  314. package/templates/.agents/skills/create-pr/reference/comment-publish.zh-CN.md +7 -11
  315. package/templates/.agents/skills/create-release-note/SKILL.en.md +17 -38
  316. package/templates/.agents/skills/create-release-note/SKILL.zh-CN.md +16 -37
  317. package/templates/.agents/skills/create-task/SKILL.en.md +16 -13
  318. package/templates/.agents/skills/create-task/SKILL.zh-CN.md +16 -13
  319. package/templates/.agents/skills/create-task/config/verify.json +1 -2
  320. package/templates/.agents/skills/create-task/reference/context-capture.en.md +29 -0
  321. package/templates/.agents/skills/create-task/reference/context-capture.zh-CN.md +29 -0
  322. package/templates/.agents/skills/import-codescan/SKILL.en.md +2 -2
  323. package/templates/.agents/skills/import-codescan/SKILL.zh-CN.md +2 -2
  324. package/templates/.agents/skills/import-codescan/config/verify.json +1 -2
  325. package/templates/.agents/skills/import-dependabot/SKILL.en.md +2 -2
  326. package/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md +2 -2
  327. package/templates/.agents/skills/import-dependabot/config/verify.json +1 -2
  328. package/templates/.agents/skills/import-issue/SKILL.en.md +9 -13
  329. package/templates/.agents/skills/import-issue/SKILL.zh-CN.md +10 -14
  330. package/templates/.agents/skills/import-issue/config/verify.json +1 -2
  331. package/templates/.agents/skills/plan-task/SKILL.en.md +17 -42
  332. package/templates/.agents/skills/plan-task/SKILL.zh-CN.md +22 -49
  333. package/templates/.agents/skills/plan-task/config/verify.en.json +1 -3
  334. package/templates/.agents/skills/plan-task/config/verify.zh-CN.json +1 -3
  335. package/templates/.agents/skills/post-release/SKILL.en.md +11 -81
  336. package/templates/.agents/skills/post-release/SKILL.zh-CN.md +8 -78
  337. package/templates/.agents/skills/refine-title/SKILL.en.md +1 -1
  338. package/templates/.agents/skills/refine-title/SKILL.zh-CN.md +1 -1
  339. package/templates/.agents/skills/release/SKILL.en.md +16 -163
  340. package/templates/.agents/skills/release/SKILL.zh-CN.md +15 -162
  341. package/templates/.agents/skills/restore-task/SKILL.en.md +11 -29
  342. package/templates/.agents/skills/restore-task/SKILL.zh-CN.md +11 -29
  343. package/templates/.agents/skills/restore-task/config/verify.json +1 -2
  344. package/templates/.agents/skills/review-analysis/SKILL.en.md +13 -25
  345. package/templates/.agents/skills/review-analysis/SKILL.zh-CN.md +13 -33
  346. package/templates/.agents/skills/review-analysis/config/verify.en.json +3 -4
  347. package/templates/.agents/skills/review-analysis/config/verify.zh-CN.json +3 -4
  348. package/templates/.agents/skills/review-analysis/reference/output-templates.en.md +9 -12
  349. package/templates/.agents/skills/review-analysis/reference/output-templates.zh-CN.md +9 -12
  350. package/templates/.agents/skills/review-analysis/reference/report-template.en.md +9 -2
  351. package/templates/.agents/skills/review-analysis/reference/report-template.zh-CN.md +9 -2
  352. package/templates/.agents/skills/review-analysis/reference/review-criteria.en.md +7 -0
  353. package/templates/.agents/skills/review-analysis/reference/review-criteria.zh-CN.md +7 -0
  354. package/templates/.agents/skills/review-code/SKILL.en.md +22 -36
  355. package/templates/.agents/skills/review-code/SKILL.zh-CN.md +23 -41
  356. package/templates/.agents/skills/review-code/config/verify.en.json +3 -4
  357. package/templates/.agents/skills/review-code/config/verify.zh-CN.json +3 -4
  358. package/templates/.agents/skills/review-code/reference/output-templates.en.md +56 -18
  359. package/templates/.agents/skills/review-code/reference/output-templates.zh-CN.md +56 -18
  360. package/templates/.agents/skills/review-code/reference/report-template.en.md +11 -4
  361. package/templates/.agents/skills/review-code/reference/report-template.zh-CN.md +11 -4
  362. package/templates/.agents/skills/review-code/reference/review-criteria.en.md +7 -0
  363. package/templates/.agents/skills/review-code/reference/review-criteria.zh-CN.md +7 -0
  364. package/templates/.agents/skills/review-plan/SKILL.en.md +13 -25
  365. package/templates/.agents/skills/review-plan/SKILL.zh-CN.md +13 -33
  366. package/templates/.agents/skills/review-plan/config/verify.en.json +3 -4
  367. package/templates/.agents/skills/review-plan/config/verify.zh-CN.json +3 -4
  368. package/templates/.agents/skills/review-plan/reference/output-templates.en.md +9 -12
  369. package/templates/.agents/skills/review-plan/reference/output-templates.zh-CN.md +9 -12
  370. package/templates/.agents/skills/review-plan/reference/report-template.en.md +9 -2
  371. package/templates/.agents/skills/review-plan/reference/report-template.zh-CN.md +9 -2
  372. package/templates/.agents/skills/review-plan/reference/review-criteria.en.md +7 -0
  373. package/templates/.agents/skills/review-plan/reference/review-criteria.zh-CN.md +7 -0
  374. package/templates/.agents/skills/update-agent-infra/SKILL.en.md +1 -2
  375. package/templates/.agents/skills/update-agent-infra/SKILL.zh-CN.md +1 -2
  376. package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js +3 -15
  377. package/templates/.agents/skills/watch-pr/SKILL.en.md +24 -14
  378. package/templates/.agents/skills/watch-pr/SKILL.zh-CN.md +25 -15
  379. package/templates/.agents/skills/watch-pr/config/verify.json +1 -2
  380. package/templates/.agents/skills/watch-pr/reference/monitor-and-heal.en.md +2 -2
  381. package/templates/.agents/skills/watch-pr/reference/monitor-and-heal.zh-CN.md +2 -2
  382. package/templates/.agents/templates/task.en.md +24 -1
  383. package/templates/.agents/templates/task.zh-CN.md +24 -1
  384. package/templates/.claude/commands/analyze-task.en.md +1 -1
  385. package/templates/.claude/commands/analyze-task.zh-CN.md +1 -1
  386. package/templates/.claude/commands/block-task.en.md +1 -1
  387. package/templates/.claude/commands/block-task.zh-CN.md +1 -1
  388. package/templates/.claude/commands/cancel-task.en.md +1 -1
  389. package/templates/.claude/commands/cancel-task.zh-CN.md +1 -1
  390. package/templates/.claude/commands/check-task.en.md +1 -1
  391. package/templates/.claude/commands/check-task.zh-CN.md +1 -1
  392. package/templates/.claude/commands/code-task.en.md +1 -1
  393. package/templates/.claude/commands/code-task.zh-CN.md +1 -1
  394. package/templates/.claude/commands/commit.en.md +1 -0
  395. package/templates/.claude/commands/commit.zh-CN.md +1 -0
  396. package/templates/.claude/commands/complete-manual-validation.en.md +1 -1
  397. package/templates/.claude/commands/complete-manual-validation.zh-CN.md +1 -1
  398. package/templates/.claude/commands/complete-task.en.md +1 -1
  399. package/templates/.claude/commands/complete-task.zh-CN.md +1 -1
  400. package/templates/.claude/commands/create-pr.en.md +1 -1
  401. package/templates/.claude/commands/create-pr.zh-CN.md +1 -1
  402. package/templates/.claude/commands/plan-task.en.md +1 -1
  403. package/templates/.claude/commands/plan-task.zh-CN.md +1 -1
  404. package/templates/.claude/commands/review-analysis.en.md +1 -1
  405. package/templates/.claude/commands/review-analysis.zh-CN.md +1 -1
  406. package/templates/.claude/commands/review-code.en.md +1 -1
  407. package/templates/.claude/commands/review-code.zh-CN.md +1 -1
  408. package/templates/.claude/commands/review-plan.en.md +1 -1
  409. package/templates/.claude/commands/review-plan.zh-CN.md +1 -1
  410. package/templates/.claude/commands/watch-pr.en.md +1 -1
  411. package/templates/.claude/commands/watch-pr.zh-CN.md +1 -1
  412. package/templates/.gemini/commands/_project_/analyze-task.en.toml +2 -0
  413. package/templates/.gemini/commands/_project_/analyze-task.zh-CN.toml +2 -0
  414. package/templates/.gemini/commands/_project_/block-task.en.toml +2 -0
  415. package/templates/.gemini/commands/_project_/block-task.zh-CN.toml +2 -0
  416. package/templates/.gemini/commands/_project_/cancel-task.en.toml +2 -0
  417. package/templates/.gemini/commands/_project_/cancel-task.zh-CN.toml +2 -0
  418. package/templates/.gemini/commands/_project_/check-task.en.toml +2 -0
  419. package/templates/.gemini/commands/_project_/check-task.zh-CN.toml +2 -0
  420. package/templates/.gemini/commands/_project_/code-task.en.toml +2 -0
  421. package/templates/.gemini/commands/_project_/code-task.zh-CN.toml +2 -0
  422. package/templates/.gemini/commands/_project_/commit.en.toml +4 -0
  423. package/templates/.gemini/commands/_project_/commit.zh-CN.toml +4 -0
  424. package/templates/.gemini/commands/_project_/complete-manual-validation.en.toml +2 -0
  425. package/templates/.gemini/commands/_project_/complete-manual-validation.zh-CN.toml +2 -0
  426. package/templates/.gemini/commands/_project_/complete-task.en.toml +2 -0
  427. package/templates/.gemini/commands/_project_/complete-task.zh-CN.toml +2 -0
  428. package/templates/.gemini/commands/_project_/create-pr.en.toml +2 -0
  429. package/templates/.gemini/commands/_project_/create-pr.zh-CN.toml +2 -0
  430. package/templates/.gemini/commands/_project_/plan-task.en.toml +2 -0
  431. package/templates/.gemini/commands/_project_/plan-task.zh-CN.toml +2 -0
  432. package/templates/.gemini/commands/_project_/review-analysis.en.toml +2 -0
  433. package/templates/.gemini/commands/_project_/review-analysis.zh-CN.toml +2 -0
  434. package/templates/.gemini/commands/_project_/review-code.en.toml +2 -0
  435. package/templates/.gemini/commands/_project_/review-code.zh-CN.toml +2 -0
  436. package/templates/.gemini/commands/_project_/review-plan.en.toml +2 -0
  437. package/templates/.gemini/commands/_project_/review-plan.zh-CN.toml +2 -0
  438. package/templates/.gemini/commands/_project_/watch-pr.en.toml +2 -0
  439. package/templates/.gemini/commands/_project_/watch-pr.zh-CN.toml +2 -0
  440. package/templates/.git-hooks/check-large-files.cjs +92 -0
  441. package/templates/.git-hooks/check-version-format.sh +5 -1
  442. package/templates/.git-hooks/pre-commit +1 -0
  443. package/templates/.opencode/commands/analyze-task.en.md +1 -1
  444. package/templates/.opencode/commands/analyze-task.zh-CN.md +1 -1
  445. package/templates/.opencode/commands/check-task.en.md +1 -1
  446. package/templates/.opencode/commands/check-task.zh-CN.md +1 -1
  447. package/templates/.opencode/commands/code-task.en.md +1 -1
  448. package/templates/.opencode/commands/code-task.zh-CN.md +1 -1
  449. package/templates/.opencode/commands/commit.en.md +2 -0
  450. package/templates/.opencode/commands/commit.zh-CN.md +2 -0
  451. package/templates/.opencode/commands/complete-task.en.md +1 -1
  452. package/templates/.opencode/commands/complete-task.zh-CN.md +1 -1
  453. package/templates/.opencode/commands/plan-task.en.md +1 -1
  454. package/templates/.opencode/commands/plan-task.zh-CN.md +1 -1
  455. package/templates/.opencode/commands/review-analysis.en.md +1 -1
  456. package/templates/.opencode/commands/review-analysis.zh-CN.md +1 -1
  457. package/templates/.opencode/commands/review-code.en.md +1 -1
  458. package/templates/.opencode/commands/review-code.zh-CN.md +1 -1
  459. package/templates/.opencode/commands/review-plan.en.md +1 -1
  460. package/templates/.opencode/commands/review-plan.zh-CN.md +1 -1
  461. package/templates/.agents/scripts/platform-adapters/platform-sync.github.js +0 -40
  462. package/templates/.agents/scripts/platform-adapters/platform-sync.js +0 -13
  463. package/templates/.agents/scripts/review-diff-fingerprint.js +0 -170
  464. package/templates/.agents/scripts/workflow-warnings.js +0 -290
  465. package/templates/.agents/skills/code-task/scripts/detect-mode.js +0 -257
  466. package/templates/.agents/skills/release/scripts/manage-milestones.github.sh +0 -80
  467. package/templates/.agents/skills/release/scripts/manage-milestones.sh +0 -6
@@ -0,0 +1,96 @@
1
+ import { createGitHubClient } from './github-client.js';
2
+ function normalizeGitHubActor(actor) {
3
+ const name = String(actor.name || '').trim();
4
+ const email = actor.email ? String(actor.email).trim() : null;
5
+ const platformLogin = actor.user?.login?.trim().toLowerCase() || null;
6
+ const noReplyLogin = email
7
+ ? /^(?:\d+\+)?([^@]+)@users\.noreply\.github\.com$/i.exec(email)?.[1]?.toLowerCase() || null
8
+ : null;
9
+ const login = platformLogin || noReplyLogin;
10
+ return {
11
+ name,
12
+ email,
13
+ login,
14
+ bot: Boolean(login?.endsWith('[bot]')),
15
+ resolution: platformLogin ? 'platform-user' : noReplyLogin ? 'platform-noreply' : 'unresolved'
16
+ };
17
+ }
18
+ function failure(error) {
19
+ return {
20
+ status: error.retryable ? 'blocked' : 'failed',
21
+ changed: false,
22
+ operation: null,
23
+ url: null,
24
+ error
25
+ };
26
+ }
27
+ function publishGitHubReleaseNotes(input, options = {}) {
28
+ const client = options.client ?? createGitHubClient();
29
+ const inspected = client.json(['release', 'view', input.tag, '--repo', input.repository, '--json', 'url'], { cwd: options.cwd });
30
+ if (!inspected.ok && inspected.error.code !== 'RESOURCE_NOT_FOUND')
31
+ return failure(inspected.error);
32
+ const exists = inspected.ok;
33
+ const operation = exists ? 'release:update-notes' : 'release:create';
34
+ if (input.dryRun) {
35
+ return {
36
+ status: 'planned',
37
+ changed: false,
38
+ operation,
39
+ url: inspected.ok ? inspected.value.url || null : null,
40
+ error: null
41
+ };
42
+ }
43
+ const args = exists
44
+ ? ['release', 'edit', input.tag, '--repo', input.repository, '--notes-file', input.notesFile]
45
+ : ['release', 'create', input.tag, '--repo', input.repository, '--title', input.title, '--notes-file', input.notesFile];
46
+ const written = client.text(args, { cwd: options.cwd, method: exists ? 'PATCH' : 'POST' });
47
+ if (!written.ok)
48
+ return failure(written.error);
49
+ return {
50
+ status: 'applied',
51
+ changed: true,
52
+ operation,
53
+ url: written.value || (inspected.ok ? inspected.value.url || null : null),
54
+ error: null
55
+ };
56
+ }
57
+ function fetchGitHubReleaseNoteData(input, options = {}) {
58
+ const client = options.client ?? createGitHubClient();
59
+ const releases = client.json(['release', 'list', '--repo', input.repository, '--limit', String(input.historyLimit + 10), '--json', 'tagName,isDraft,isPrerelease'], { cwd: options.cwd });
60
+ if (!releases.ok)
61
+ return failure(releases.error);
62
+ const history = [];
63
+ for (const item of releases.value.filter((entry) => !entry.isDraft && !entry.isPrerelease).slice(0, input.historyLimit)) {
64
+ const viewed = client.json(['release', 'view', String(item.tagName), '--repo', input.repository, '--json', 'body,url'], { cwd: options.cwd });
65
+ if (!viewed.ok)
66
+ return failure(viewed.error);
67
+ history.push({ tag: String(item.tagName), body: String(viewed.value.body || ''), url: viewed.value.url || null });
68
+ }
69
+ const prs = client.json(['pr', 'list', '--repo', input.repository, '--state', 'merged', '--base', input.branch, '--limit', '1000', '--json', 'number,title,body,url,mergedAt,labels,author,closingIssuesReferences'], { cwd: options.cwd });
70
+ if (!prs.ok)
71
+ return failure(prs.error);
72
+ const authors = new Map();
73
+ for (const oid of input.commitOids) {
74
+ const query = `query($owner:String!,$name:String!,$oid:GitObjectID!){repository(owner:$owner,name:$name){object(oid:$oid){... on Commit{authors(first:100){nodes{name email user{login}} pageInfo{hasNextPage}}}}}}`;
75
+ const [owner, name] = input.repository.split('/');
76
+ const result = client.json([
77
+ 'api', 'graphql', '-f', `query=${query}`, '-F', `owner=${owner}`, '-F', `name=${name}`, '-F', `oid=${oid}`
78
+ ], { cwd: options.cwd });
79
+ if (!result.ok)
80
+ return failure(result.error);
81
+ const connection = result.value.data?.repository?.object?.authors;
82
+ if (connection?.pageInfo?.hasNextPage) {
83
+ return failure({ code: 'RELEASE_NOTES_AUTHORS_TRUNCATED', message: `Commit authors exceeded the supported page size for ${oid}`, retryable: false });
84
+ }
85
+ authors.set(oid, (connection?.nodes || []).map(normalizeGitHubActor));
86
+ }
87
+ const fromTime = Date.parse(input.fromTime);
88
+ const toTime = Date.parse(input.toTime);
89
+ const pullRequests = prs.value.filter((item) => {
90
+ const mergedAt = Date.parse(String(item.mergedAt || ''));
91
+ return Number.isFinite(mergedAt) && mergedAt > fromTime && mergedAt <= toTime;
92
+ });
93
+ return { status: 'no-op', changed: false, history, pullRequests, authors, error: null };
94
+ }
95
+ export { fetchGitHubReleaseNoteData, normalizeGitHubActor, publishGitHubReleaseNotes };
96
+ //# sourceMappingURL=github-release-notes.js.map
@@ -0,0 +1,409 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { parseTaskFrontmatter } from '../task/frontmatter.js';
4
+ import { resolveTaskRef } from '../task/resolve-ref.js';
5
+ import { createGitHubClient } from './github-client.js';
6
+ import { resolvePlatformContext } from './context.js';
7
+ import { platformResult } from './types.js';
8
+ const MARKERS = {
9
+ task: (taskId) => `<!-- sync-issue:${taskId}:task -->`,
10
+ artifact: (taskId, stem) => `<!-- sync-issue:${taskId}:${stem} -->`,
11
+ artifactChunk: (taskId, stem, part, total) => `<!-- sync-issue:${taskId}:${stem}:${part}/${total} -->`,
12
+ summary: (taskId) => `<!-- sync-issue:${taskId}:summary -->`,
13
+ cancel: (taskId) => `<!-- sync-issue:${taskId}:cancel -->`
14
+ };
15
+ const ARTIFACT_TITLES = {
16
+ analysis: '需求分析',
17
+ 'review-analysis': '需求分析审查',
18
+ plan: '技术方案',
19
+ 'review-plan': '技术方案审查',
20
+ code: '实现报告',
21
+ 'review-code': '代码审查',
22
+ 'manual-validation': '人工验证报告'
23
+ };
24
+ function normalizeCommentContent(content) {
25
+ return content.replace(/\r\n/g, '\n').replace(/\n+$/, '\n');
26
+ }
27
+ function splitFrontmatter(content) {
28
+ const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
29
+ if (!match)
30
+ return { frontmatter: null, body: content };
31
+ return { frontmatter: match[1], body: content.slice(match[0].length).replace(/^\r?\n/, '') };
32
+ }
33
+ function footer(agent, taskId) {
34
+ return `---\n*由 ${agent} 自动生成 · 内部追踪:${taskId}*`;
35
+ }
36
+ function renderTaskComment(content, taskId, agent) {
37
+ const split = splitFrontmatter(content);
38
+ const taskBody = split.frontmatter === null
39
+ ? split.body
40
+ : `<details><summary>元数据 (frontmatter)</summary>\n\n\`\`\`yaml\n---\n${split.frontmatter}\n---\n\`\`\`\n\n</details>\n\n${split.body}`;
41
+ return normalizeCommentContent([
42
+ MARKERS.task(taskId),
43
+ '## 任务文件',
44
+ '',
45
+ `> **${agent}** · ${taskId}`,
46
+ '',
47
+ taskBody.replace(/\n+$/, ''),
48
+ '',
49
+ footer(agent, taskId)
50
+ ].join('\n'));
51
+ }
52
+ function artifactIdentity(artifact) {
53
+ const stem = path.basename(artifact, '.md');
54
+ const match = stem.match(/^(analysis|review-analysis|plan|review-plan|code|review-code|manual-validation)(?:-r(\d+))?$/);
55
+ if (!match)
56
+ throw new Error(`unsupported artifact '${artifact}'`);
57
+ const base = ARTIFACT_TITLES[match[1]];
58
+ const round = match[2] ? Number(match[2]) : 1;
59
+ return { stem, title: `${base}(Round ${round})` };
60
+ }
61
+ function chunkByUtf8(content, maxBytes) {
62
+ if (maxBytes <= 0)
63
+ throw new Error('comment byte limit is too small');
64
+ const chunks = [];
65
+ let remaining = content;
66
+ while (remaining) {
67
+ if (Buffer.byteLength(remaining, 'utf8') <= maxBytes) {
68
+ chunks.push(remaining);
69
+ break;
70
+ }
71
+ let bytes = 0;
72
+ let index = 0;
73
+ let newlineIndex = -1;
74
+ for (const character of remaining) {
75
+ const size = Buffer.byteLength(character, 'utf8');
76
+ if (bytes + size > maxBytes)
77
+ break;
78
+ bytes += size;
79
+ index += character.length;
80
+ if (character === '\n')
81
+ newlineIndex = index;
82
+ }
83
+ const cut = newlineIndex > 0 ? newlineIndex : index;
84
+ if (cut === 0)
85
+ throw new Error('comment byte limit cannot fit one Unicode code point');
86
+ chunks.push(remaining.slice(0, cut));
87
+ remaining = remaining.slice(cut);
88
+ }
89
+ return chunks.length > 0 ? chunks : [''];
90
+ }
91
+ function buildArtifactChunk(taskId, stem, title, agent, content, part, total, chunked, backfill) {
92
+ const marker = chunked ? MARKERS.artifactChunk(taskId, stem, part, total) : MARKERS.artifact(taskId, stem);
93
+ const heading = chunked ? `## ${title}(${part}/${total})` : `## ${title}`;
94
+ const timelineHint = backfill ? '> 历史产物补发' : null;
95
+ const body = normalizeCommentContent([
96
+ marker,
97
+ heading,
98
+ ...(timelineHint ? ['', timelineHint] : []),
99
+ '',
100
+ `> **${agent}** · ${taskId}`,
101
+ '',
102
+ content,
103
+ '',
104
+ footer(agent, taskId)
105
+ ].join('\n'));
106
+ return { marker, body, content, part, total };
107
+ }
108
+ function chunkArtifactComment(input) {
109
+ const byteLimit = input.byteLimit || 60_000;
110
+ const identity = artifactIdentity(input.artifact);
111
+ const single = buildArtifactChunk(input.taskId, identity.stem, identity.title, input.agent, input.body, 1, 1, false, Boolean(input.backfill));
112
+ if (Buffer.byteLength(single.body, 'utf8') <= byteLimit)
113
+ return [single];
114
+ let total = 2;
115
+ let pieces = [];
116
+ for (;;) {
117
+ const probe = buildArtifactChunk(input.taskId, identity.stem, identity.title, input.agent, '', total, total, true, Boolean(input.backfill));
118
+ const available = byteLimit - Buffer.byteLength(probe.body, 'utf8');
119
+ pieces = chunkByUtf8(input.body, available);
120
+ if (pieces.length === total)
121
+ break;
122
+ total = pieces.length;
123
+ }
124
+ return pieces.map((content, index) => {
125
+ const chunk = buildArtifactChunk(input.taskId, identity.stem, identity.title, input.agent, content, index + 1, total, true, Boolean(input.backfill));
126
+ if (Buffer.byteLength(chunk.body, 'utf8') > byteLimit)
127
+ throw new Error('rendered comment exceeds byte limit');
128
+ return chunk;
129
+ });
130
+ }
131
+ function findMarkerComments(comments, marker) {
132
+ return comments.filter((comment) => normalizeCommentContent(String(comment.body || '')).split('\n', 1)[0] === marker);
133
+ }
134
+ function flattenComments(value) {
135
+ if (!Array.isArray(value))
136
+ return [];
137
+ const flattened = value.flatMap((entry) => Array.isArray(entry) ? entry : [entry]);
138
+ return flattened.filter((entry) => Boolean(entry && typeof entry === 'object' && typeof entry.id === 'number' && typeof entry.body === 'string'));
139
+ }
140
+ function issueNumberFromTask(content) {
141
+ const value = parseTaskFrontmatter(content).issue_number;
142
+ const number = Number(value);
143
+ return Number.isInteger(number) && number > 0 ? number : null;
144
+ }
145
+ function listRemoteComments(client, repo, issue, cwd) {
146
+ const result = client.json([
147
+ 'api', '--paginate', '--slurp', `repos/${repo}/issues/${issue}/comments?per_page=100`
148
+ ], { cwd });
149
+ return result.ok ? { ok: true, value: flattenComments(result.value) } : result;
150
+ }
151
+ function contextFields(context) {
152
+ return {
153
+ platform: context.platform,
154
+ capabilities: context.capabilities
155
+ };
156
+ }
157
+ function hasResolvedPlatformContext(context) {
158
+ return context.status === 'degraded' || (context.status === 'no-op' && context.error === null);
159
+ }
160
+ function bodyEnvelope(marker, title, taskId, agent, body) {
161
+ return normalizeCommentContent([
162
+ marker, `## ${title}`, '', `> **${agent}** · ${taskId}`, '', body.replace(/\n+$/, ''), '', footer(agent, taskId)
163
+ ].join('\n'));
164
+ }
165
+ function resolveArtifactBody(taskDir, artifact) {
166
+ if (path.basename(artifact) !== artifact || !artifact.endsWith('.md'))
167
+ throw new Error('artifact must be a canonical markdown filename');
168
+ artifactIdentity(artifact);
169
+ const artifactPath = path.join(taskDir, artifact);
170
+ const stat = fs.lstatSync(artifactPath);
171
+ if (!stat.isFile() || stat.isSymbolicLink())
172
+ throw new Error('artifact must be a regular file');
173
+ const realTaskDir = fs.realpathSync(taskDir);
174
+ const realArtifact = fs.realpathSync(artifactPath);
175
+ if (path.dirname(realArtifact) !== realTaskDir)
176
+ throw new Error('artifact must stay inside the task directory');
177
+ return fs.readFileSync(realArtifact, 'utf8');
178
+ }
179
+ function expectedComments(taskId, taskContent, taskDir, options) {
180
+ if (options.kind === 'task') {
181
+ const body = renderTaskComment(taskContent, taskId, options.agent);
182
+ return [{ marker: MARKERS.task(taskId), body, content: taskContent, part: 1, total: 1 }];
183
+ }
184
+ if (options.kind === 'artifact') {
185
+ if (!options.artifact)
186
+ throw new Error('artifact sync requires an artifact filename');
187
+ return chunkArtifactComment({
188
+ taskId,
189
+ artifact: options.artifact,
190
+ agent: options.agent,
191
+ body: resolveArtifactBody(taskDir, options.artifact),
192
+ backfill: options.backfill
193
+ });
194
+ }
195
+ if (options.body === undefined)
196
+ throw new Error(`${options.kind} sync requires a body`);
197
+ const marker = options.kind === 'summary' ? MARKERS.summary(taskId) : MARKERS.cancel(taskId);
198
+ const title = options.kind === 'summary' ? '交付摘要' : '任务取消';
199
+ const body = bodyEnvelope(marker, title, taskId, options.agent, options.body);
200
+ return [{ marker, body, content: options.body, part: 1, total: 1 }];
201
+ }
202
+ function markerPrefix(taskId, options) {
203
+ if (options.kind === 'task')
204
+ return `<!-- sync-issue:${taskId}:task`;
205
+ if (options.kind === 'summary')
206
+ return `<!-- sync-issue:${taskId}:summary`;
207
+ if (options.kind === 'cancel')
208
+ return `<!-- sync-issue:${taskId}:cancel`;
209
+ const stem = path.basename(options.artifact || '', '.md');
210
+ return `<!-- sync-issue:${taskId}:${stem}`;
211
+ }
212
+ function relatedComments(comments, prefix) {
213
+ const base = `${prefix} -->`;
214
+ const chunkNamespace = `${prefix}:`;
215
+ return comments.filter((comment) => {
216
+ const first = normalizeCommentContent(comment.body).split('\n', 1)[0] || '';
217
+ return first === base || (first.startsWith(chunkNamespace) && first.endsWith(' -->'));
218
+ });
219
+ }
220
+ function validateRelatedMarkerSet(comments, prefix) {
221
+ const markers = comments.map((comment) => normalizeCommentContent(comment.body).split('\n', 1)[0] || '');
222
+ if (new Set(markers).size !== markers.length)
223
+ return { ok: false, code: 'COMMENT_MARKER_CONFLICT' };
224
+ const base = `${prefix} -->`;
225
+ const escaped = prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
226
+ const chunkPattern = new RegExp(`^${escaped}:(\\d+)\\/(\\d+) -->$`);
227
+ const hasBase = markers.includes(base);
228
+ const chunks = markers.map((marker) => marker.match(chunkPattern)).filter((match) => Boolean(match));
229
+ if (markers.some((marker) => marker !== base && !chunkPattern.test(marker)))
230
+ return { ok: false, code: 'COMMENT_MARKER_CONFLICT' };
231
+ if (hasBase && chunks.length > 0)
232
+ return { ok: false, code: 'COMMENT_MARKER_CONFLICT' };
233
+ if (chunks.length === 0)
234
+ return { ok: true, code: null };
235
+ const totals = new Set(chunks.map((match) => Number(match[2])));
236
+ if (totals.size !== 1)
237
+ return { ok: false, code: 'COMMENT_MARKER_CONFLICT' };
238
+ const total = Number(chunks[0][2]);
239
+ const parts = chunks.map((match) => Number(match[1])).sort((left, right) => left - right);
240
+ const complete = total > 0 && parts.length === total && parts.every((part, index) => part === index + 1);
241
+ return complete ? { ok: true, code: null } : { ok: false, code: 'COMMENT_MARKER_CONFLICT' };
242
+ }
243
+ function writeComment(client, repo, issue, cwd, body, id) {
244
+ const endpoint = id ? `repos/${repo}/issues/comments/${id}` : `repos/${repo}/issues/${issue}/comments`;
245
+ return client.json(['api', endpoint, '-X', id ? 'PATCH' : 'POST', '--input', '-'], { cwd, method: id ? 'PATCH' : 'POST', input: JSON.stringify({ body }) });
246
+ }
247
+ function syncPlatformComment(taskRef, options) {
248
+ const resolved = resolveTaskRef(taskRef, options.cwd ? { repoRoot: options.cwd } : {});
249
+ if (!resolved.ok) {
250
+ return platformResult('failed', {
251
+ error: { code: resolved.code, message: resolved.message, retryable: false }
252
+ });
253
+ }
254
+ const taskContent = fs.readFileSync(resolved.taskMdPath, 'utf8');
255
+ const issue = issueNumberFromTask(taskContent);
256
+ if (!issue) {
257
+ return platformResult('no-op', {
258
+ error: { code: 'ISSUE_NOT_LINKED', message: 'Task has no valid issue_number', retryable: false }
259
+ });
260
+ }
261
+ const context = resolvePlatformContext({ cwd: resolved.repoRoot, client: options.client });
262
+ if (!hasResolvedPlatformContext(context))
263
+ return context;
264
+ const client = options.client || createGitHubClient();
265
+ const listed = listRemoteComments(client, context.platform.repository, issue, resolved.repoRoot);
266
+ if (!listed.ok) {
267
+ return platformResult(listed.error.retryable ? 'blocked' : 'failed', {
268
+ ...contextFields(context), resource: { kind: 'issue', number: issue }, error: listed.error
269
+ });
270
+ }
271
+ let desired;
272
+ try {
273
+ desired = expectedComments(resolved.taskId, taskContent, resolved.taskDir, options);
274
+ }
275
+ catch (error) {
276
+ return platformResult('failed', {
277
+ ...contextFields(context),
278
+ resource: { kind: 'issue', number: issue },
279
+ error: { code: 'COMMENT_PAYLOAD_INVALID', message: error instanceof Error ? error.message : String(error), retryable: false }
280
+ });
281
+ }
282
+ const existing = relatedComments(listed.value, markerPrefix(resolved.taskId, options));
283
+ if (!validateRelatedMarkerSet(existing, markerPrefix(resolved.taskId, options)).ok) {
284
+ return platformResult('failed', {
285
+ ...contextFields(context),
286
+ resource: { kind: 'issue', number: issue },
287
+ error: { code: 'COMMENT_MARKER_CONFLICT', message: 'Multiple comments use the same registered marker', retryable: false }
288
+ });
289
+ }
290
+ // Backfill only supplies missing artifact comments; valid existing marker sets stay untouched.
291
+ if (options.kind === 'artifact' && options.backfill && existing.length > 0) {
292
+ const operations = existing.map((comment) => ({
293
+ name: `comment:${normalizeCommentContent(comment.body).split('\n', 1)[0]}`,
294
+ status: 'no-op',
295
+ reasonCode: 'BACKFILL_ALREADY_PRESENT'
296
+ }));
297
+ return platformResult('no-op', {
298
+ ...contextFields(context),
299
+ changed: false,
300
+ resource: { kind: 'issue', number: issue },
301
+ operations,
302
+ comment: {
303
+ kind: options.kind,
304
+ marker: desired[0].marker,
305
+ ids: existing.map((comment) => comment.id),
306
+ parts: existing.length
307
+ },
308
+ error: null
309
+ });
310
+ }
311
+ const repo = context.platform.repository;
312
+ const operations = [];
313
+ const ids = [];
314
+ for (const item of desired) {
315
+ const current = existing.find((comment) => normalizeCommentContent(comment.body).split('\n', 1)[0] === item.marker);
316
+ if (current && normalizeCommentContent(current.body) === normalizeCommentContent(item.body)) {
317
+ ids.push(current.id);
318
+ operations.push({ name: `comment:${item.marker}`, status: 'no-op', reasonCode: null });
319
+ continue;
320
+ }
321
+ const written = writeComment(client, repo, issue, resolved.repoRoot, item.body, current?.id);
322
+ if (!written.ok) {
323
+ if (!current && written.error.retryable) {
324
+ const reconciled = listRemoteComments(client, repo, issue, resolved.repoRoot);
325
+ const found = reconciled.ok ? findMarkerComments(reconciled.value, item.marker) : [];
326
+ if (found.length === 1) {
327
+ ids.push(found[0].id);
328
+ operations.push({ name: `comment:${item.marker}`, status: 'applied', reasonCode: 'CREATE_RECONCILED' });
329
+ continue;
330
+ }
331
+ }
332
+ return platformResult(written.error.retryable ? 'blocked' : 'failed', {
333
+ ...contextFields(context),
334
+ resource: { kind: 'issue', number: issue },
335
+ operations,
336
+ error: written.error
337
+ });
338
+ }
339
+ ids.push(current?.id || written.value.id || 0);
340
+ operations.push({ name: `comment:${item.marker}`, status: 'applied', reasonCode: null });
341
+ }
342
+ const desiredMarkers = new Set(desired.map((item) => item.marker));
343
+ const stale = existing.filter((comment) => !desiredMarkers.has(normalizeCommentContent(comment.body).split('\n', 1)[0]));
344
+ for (const comment of stale) {
345
+ const deleted = client.text(['api', `repos/${repo}/issues/comments/${comment.id}`, '-X', 'DELETE'], {
346
+ cwd: resolved.repoRoot, method: 'DELETE'
347
+ });
348
+ if (!deleted.ok) {
349
+ return platformResult(deleted.error.retryable ? 'blocked' : 'failed', {
350
+ ...contextFields(context),
351
+ resource: { kind: 'issue', number: issue },
352
+ operations,
353
+ error: deleted.error
354
+ });
355
+ }
356
+ operations.push({ name: `comment:${comment.id}`, status: 'applied', reasonCode: 'STALE_CHUNK_DELETED' });
357
+ }
358
+ const changed = operations.some((operation) => operation.status === 'applied');
359
+ return platformResult(changed ? 'applied' : 'no-op', {
360
+ ...contextFields(context),
361
+ changed,
362
+ resource: { kind: 'issue', number: issue },
363
+ operations,
364
+ comment: { kind: options.kind, marker: desired[0].marker, ids, parts: desired.length },
365
+ error: null
366
+ });
367
+ }
368
+ function listPlatformComments(issue, cwd = process.cwd(), client = createGitHubClient()) {
369
+ const context = resolvePlatformContext({ cwd, client });
370
+ if (!hasResolvedPlatformContext(context))
371
+ return context;
372
+ const result = listRemoteComments(client, context.platform.repository, issue, cwd);
373
+ if (!result.ok) {
374
+ return platformResult(result.error.retryable ? 'blocked' : 'failed', {
375
+ ...contextFields(context), resource: { kind: 'issue', number: issue }, error: result.error
376
+ });
377
+ }
378
+ return { ...platformResult('no-op', { ...contextFields(context), resource: { kind: 'issue', number: issue }, error: null }), comments: result.value };
379
+ }
380
+ function checkPlatformCommentOwner(taskRef, options = {}) {
381
+ const resolved = resolveTaskRef(taskRef, options.cwd ? { repoRoot: options.cwd } : {});
382
+ if (!resolved.ok)
383
+ return platformResult('failed', { error: { code: resolved.code, message: resolved.message, retryable: false } });
384
+ const content = fs.readFileSync(resolved.taskMdPath, 'utf8');
385
+ const issue = issueNumberFromTask(content);
386
+ if (!issue)
387
+ return platformResult('no-op', { error: { code: 'ISSUE_NOT_LINKED', message: 'Task has no valid issue_number', retryable: false } });
388
+ const client = options.client || createGitHubClient();
389
+ const context = resolvePlatformContext({ cwd: resolved.repoRoot, client });
390
+ if (!hasResolvedPlatformContext(context))
391
+ return context;
392
+ const listed = listRemoteComments(client, context.platform.repository, issue, resolved.repoRoot);
393
+ if (!listed.ok)
394
+ return platformResult(listed.error.retryable ? 'blocked' : 'failed', { ...contextFields(context), error: listed.error });
395
+ const matches = findMarkerComments(listed.value, MARKERS.task(resolved.taskId));
396
+ if (matches.length > 1)
397
+ return platformResult('failed', { ...contextFields(context), error: { code: 'COMMENT_MARKER_CONFLICT', message: 'Multiple task comments use the registered marker', retryable: false } });
398
+ const owner = matches[0]?.user?.login;
399
+ if (owner && owner !== context.platform.currentUser && !context.capabilities.triage) {
400
+ return platformResult('blocked', {
401
+ ...contextFields(context),
402
+ resource: { kind: 'issue', number: issue },
403
+ error: { code: 'COMMENT_OWNER_CONFLICT', message: `Task comment is owned by '${owner}'`, retryable: false }
404
+ });
405
+ }
406
+ return platformResult('no-op', { ...contextFields(context), resource: { kind: 'issue', number: issue }, error: null });
407
+ }
408
+ export { MARKERS, chunkArtifactComment, findMarkerComments, listRemoteComments, checkPlatformCommentOwner, listPlatformComments, normalizeCommentContent, renderTaskComment, syncPlatformComment, validateRelatedMarkerSet, writeComment };
409
+ //# sourceMappingURL=issue-comments.js.map