@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.
- package/README.md +6 -1
- package/README.zh-CN.md +5 -1
- package/bin/cli.ts +2 -2
- package/dist/bin/cli.js +2 -2
- package/dist/bin/internal-cli.js +103 -0
- package/dist/lib/decide.js +81 -90
- package/dist/lib/defaults.json +1 -0
- package/dist/lib/git/review-snapshot.js +79 -0
- package/dist/lib/git/workflow.js +101 -0
- package/dist/lib/internal/git-workflow.js +42 -0
- package/dist/lib/internal/platform-checks.js +119 -0
- package/dist/lib/internal/platform-comment.js +129 -0
- package/dist/lib/internal/platform-context.js +46 -0
- package/dist/lib/internal/platform-issue.js +142 -0
- package/dist/lib/internal/platform-pr.js +146 -0
- package/dist/lib/internal/platform-release-notes.js +53 -0
- package/dist/lib/internal/release-workflow.js +320 -0
- package/dist/lib/internal/task-artifact.js +67 -0
- package/dist/lib/internal/task-context.js +43 -0
- package/dist/lib/internal/task-event.js +70 -0
- package/dist/lib/internal/task-ledger.js +114 -0
- package/dist/lib/internal/task-lifecycle.js +58 -0
- package/dist/lib/internal/task-short-id.js +83 -0
- package/dist/lib/internal/task-snapshot.js +47 -0
- package/dist/lib/internal/task-verify.js +50 -0
- package/dist/lib/internal/task-warning.js +74 -0
- package/dist/lib/platform/adapters.js +14 -0
- package/dist/lib/platform/context.js +146 -0
- package/dist/lib/platform/github-client.js +124 -0
- package/dist/lib/platform/github-release-notes.js +96 -0
- package/dist/lib/platform/issue-comments.js +409 -0
- package/dist/lib/platform/issue-metadata.js +183 -0
- package/dist/lib/platform/issues.js +619 -0
- package/dist/lib/platform/merged-pr-equivalence.js +54 -0
- package/dist/lib/platform/metadata-labels.js +28 -0
- package/dist/lib/platform/pr-checks.js +216 -0
- package/dist/lib/platform/pr-summary.js +88 -0
- package/dist/lib/platform/pull-request-metadata.js +38 -0
- package/dist/lib/platform/pull-requests.js +340 -0
- package/dist/lib/platform/release-notes.js +143 -0
- package/dist/lib/platform/releases.js +82 -0
- package/dist/lib/platform/types.js +22 -0
- package/dist/lib/platform/verification-required.js +102 -0
- package/dist/lib/platform/verification-sync.js +1014 -0
- package/dist/lib/platform/verification.js +6 -0
- package/dist/lib/release/channels.js +31 -0
- package/dist/lib/release/workflow.js +32 -0
- package/dist/lib/render.js +3 -2
- package/dist/lib/run/index.js +24 -7
- package/dist/lib/sandbox/build-proxy.js +63 -0
- package/dist/lib/sandbox/capture.js +25 -3
- package/dist/lib/sandbox/commands/create.js +93 -31
- package/dist/lib/sandbox/commands/enter.js +34 -11
- package/dist/lib/sandbox/commands/list-running.js +10 -8
- package/dist/lib/sandbox/commands/rebuild.js +24 -7
- package/dist/lib/sandbox/commands/show.js +2 -2
- package/dist/lib/sandbox/commands/start.js +53 -15
- package/dist/lib/sandbox/image-build.js +2 -1
- package/dist/lib/sandbox/index.js +6 -6
- package/dist/lib/sandbox/mounts.js +36 -0
- package/dist/lib/sandbox/recovery.js +562 -0
- package/dist/lib/sandbox/runtimes/ai-tools.dockerfile +24 -3
- package/dist/lib/sandbox/runtimes/base.dockerfile +8 -1
- package/dist/lib/sandbox/runtimes/java17.dockerfile +8 -1
- package/dist/lib/sandbox/runtimes/java21.dockerfile +8 -1
- package/dist/lib/sandbox/runtimes/node20.dockerfile +8 -1
- package/dist/lib/sandbox/runtimes/node22.dockerfile +8 -1
- package/dist/lib/sandbox/runtimes/python3.dockerfile +8 -1
- package/dist/lib/sandbox/shell.js +2 -1
- package/dist/lib/sandbox/task-resolver.js +5 -1
- package/dist/lib/sandbox/tools.js +19 -0
- package/dist/lib/server/protocol.js +5 -5
- package/dist/lib/task/activity-log.js +61 -0
- package/dist/lib/task/artifact-lifecycle.js +427 -0
- package/dist/lib/task/command-options.js +30 -0
- package/dist/lib/task/commands/cat.js +36 -6
- package/dist/lib/task/commands/decisions.js +80 -46
- package/dist/lib/task/commands/files.js +21 -7
- package/dist/lib/task/commands/grep.js +55 -7
- package/dist/lib/task/commands/issue-body.js +33 -19
- package/dist/lib/task/commands/log.js +27 -70
- package/dist/lib/task/commands/show.js +20 -7
- package/dist/lib/task/commands/status.js +18 -8
- package/dist/lib/task/decision-intents.js +154 -0
- package/dist/lib/task/decision-items.js +53 -0
- package/dist/lib/task/events.js +318 -0
- package/dist/lib/task/frontmatter.js +159 -1
- package/dist/lib/task/implementation-inputs.js +117 -0
- package/dist/lib/task/index.js +12 -9
- package/dist/lib/task/issue-form.js +21 -6
- package/dist/lib/task/ledger-intents.js +185 -0
- package/dist/lib/task/ledger.js +65 -35
- package/dist/lib/task/lifecycle.js +484 -0
- package/dist/lib/task/resolve-ref.js +152 -32
- package/dist/lib/task/review-artifacts.js +101 -0
- package/dist/lib/task/review-fingerprint.js +55 -0
- package/dist/lib/task/sections.js +358 -4
- package/dist/lib/task/short-id.js +292 -7
- package/dist/lib/task/snapshot.js +95 -0
- package/dist/lib/task/verification-checks.js +8 -0
- package/dist/lib/task/verification-config.js +14 -0
- package/dist/lib/task/verification-engine.js +923 -0
- package/dist/lib/task/verification-review.js +3 -0
- package/dist/lib/task/verification-types.js +2 -0
- package/dist/lib/task/verification.js +113 -0
- package/dist/lib/task/workflow-warning-intents.js +131 -0
- package/dist/lib/task/workflow-warnings.js +10 -78
- package/dist/lib/task/write.js +241 -0
- package/lib/decide.ts +57 -97
- package/lib/defaults.json +1 -0
- package/lib/git/review-snapshot.ts +73 -0
- package/lib/git/workflow.ts +101 -0
- package/lib/internal/git-workflow.ts +37 -0
- package/lib/internal/platform-checks.ts +101 -0
- package/lib/internal/platform-comment.ts +99 -0
- package/lib/internal/platform-context.ts +33 -0
- package/lib/internal/platform-issue.ts +116 -0
- package/lib/internal/platform-pr.ts +119 -0
- package/lib/internal/platform-release-notes.ts +55 -0
- package/lib/internal/release-workflow.ts +288 -0
- package/lib/internal/task-artifact.ts +47 -0
- package/lib/internal/task-context.ts +35 -0
- package/lib/internal/task-event.ts +51 -0
- package/lib/internal/task-ledger.ts +86 -0
- package/lib/internal/task-lifecycle.ts +41 -0
- package/lib/internal/task-short-id.ts +55 -0
- package/lib/internal/task-snapshot.ts +32 -0
- package/lib/internal/task-verify.ts +33 -0
- package/lib/internal/task-warning.ts +50 -0
- package/lib/platform/adapters.ts +30 -0
- package/lib/platform/context.ts +164 -0
- package/lib/platform/github-client.ts +146 -0
- package/lib/platform/github-release-notes.ts +132 -0
- package/lib/platform/issue-comments.ts +479 -0
- package/lib/platform/issue-metadata.ts +250 -0
- package/lib/platform/issues.ts +693 -0
- package/lib/platform/merged-pr-equivalence.ts +70 -0
- package/lib/platform/metadata-labels.ts +33 -0
- package/lib/platform/pr-checks.ts +247 -0
- package/lib/platform/pr-summary.ts +90 -0
- package/lib/platform/pull-request-metadata.ts +69 -0
- package/lib/platform/pull-requests.ts +386 -0
- package/lib/platform/release-notes.ts +167 -0
- package/lib/platform/releases.ts +71 -0
- package/lib/platform/types.ts +74 -0
- package/lib/platform/verification-required.ts +109 -0
- package/{runtime/platform-adapters/platform-sync.github.js → lib/platform/verification-sync.ts} +198 -367
- package/lib/platform/verification.ts +11 -0
- package/lib/release/channels.ts +30 -0
- package/lib/release/workflow.ts +31 -0
- package/lib/render.ts +3 -2
- package/lib/run/index.ts +25 -7
- package/lib/sandbox/build-proxy.ts +94 -0
- package/lib/sandbox/capture.ts +29 -3
- package/lib/sandbox/commands/create.ts +120 -36
- package/lib/sandbox/commands/enter.ts +38 -11
- package/lib/sandbox/commands/list-running.ts +10 -8
- package/lib/sandbox/commands/rebuild.ts +29 -7
- package/lib/sandbox/commands/show.ts +2 -2
- package/lib/sandbox/commands/start.ts +50 -16
- package/lib/sandbox/image-build.ts +4 -1
- package/lib/sandbox/index.ts +6 -6
- package/lib/sandbox/mounts.ts +55 -0
- package/lib/sandbox/recovery.ts +828 -0
- package/lib/sandbox/runtimes/ai-tools.dockerfile +24 -3
- package/lib/sandbox/runtimes/base.dockerfile +8 -1
- package/lib/sandbox/runtimes/java17.dockerfile +8 -1
- package/lib/sandbox/runtimes/java21.dockerfile +8 -1
- package/lib/sandbox/runtimes/node20.dockerfile +8 -1
- package/lib/sandbox/runtimes/node22.dockerfile +8 -1
- package/lib/sandbox/runtimes/python3.dockerfile +8 -1
- package/lib/sandbox/shell.ts +3 -1
- package/lib/sandbox/task-resolver.ts +5 -1
- package/lib/sandbox/tools.ts +31 -0
- package/lib/server/protocol.ts +5 -5
- package/lib/task/activity-log.ts +62 -0
- package/lib/task/artifact-lifecycle.ts +484 -0
- package/lib/task/command-options.ts +32 -0
- package/lib/task/commands/cat.ts +22 -9
- package/lib/task/commands/decisions.ts +49 -47
- package/lib/task/commands/files.ts +14 -6
- package/lib/task/commands/grep.ts +34 -7
- package/lib/task/commands/issue-body.ts +26 -21
- package/lib/task/commands/log.ts +17 -70
- package/lib/task/commands/show.ts +14 -6
- package/lib/task/commands/status.ts +17 -7
- package/lib/task/decision-intents.ts +163 -0
- package/lib/task/decision-items.ts +64 -0
- package/lib/task/events.ts +320 -0
- package/lib/task/frontmatter.ts +202 -2
- package/lib/task/implementation-inputs.ts +137 -0
- package/lib/task/index.ts +12 -9
- package/lib/task/issue-form.ts +24 -6
- package/lib/task/ledger-intents.ts +201 -0
- package/lib/task/ledger.ts +77 -31
- package/lib/task/lifecycle.ts +458 -0
- package/lib/task/resolve-ref.ts +197 -36
- package/{templates/.agents/scripts/lib/review-artifacts.js → lib/task/review-artifacts.ts} +11 -12
- package/{templates/.agents/scripts/lib/post-review-commit.js → lib/task/review-fingerprint.ts} +26 -12
- package/lib/task/sections.ts +486 -4
- package/lib/task/short-id.ts +403 -9
- package/lib/task/snapshot.ts +143 -0
- package/lib/task/verification-checks.ts +9 -0
- package/lib/task/verification-config.ts +20 -0
- package/{templates/.agents/scripts/validate-artifact.js → lib/task/verification-engine.ts} +230 -421
- package/lib/task/verification-review.ts +10 -0
- package/lib/task/verification-types.ts +29 -0
- package/lib/task/verification.ts +156 -0
- package/lib/task/workflow-warning-intents.ts +142 -0
- package/lib/task/workflow-warnings.ts +10 -78
- package/lib/task/write.ts +468 -0
- package/package.json +4 -2
- package/templates/.agents/README.en.md +4 -3
- package/templates/.agents/README.zh-CN.md +4 -3
- package/templates/.agents/rules/README.en.md +6 -5
- package/templates/.agents/rules/README.zh-CN.md +6 -5
- package/templates/.agents/rules/create-issue.en.md +1 -1
- package/templates/.agents/rules/create-issue.github.en.md +5 -184
- package/templates/.agents/rules/create-issue.github.zh-CN.md +12 -178
- package/templates/.agents/rules/create-issue.zh-CN.md +1 -1
- package/templates/.agents/rules/human-decision-context.en.md +36 -0
- package/templates/.agents/rules/human-decision-context.zh-CN.md +36 -0
- package/templates/.agents/rules/issue-fields.github.en.md +4 -148
- package/templates/.agents/rules/issue-fields.github.zh-CN.md +9 -144
- package/templates/.agents/rules/issue-pr-commands.en.md +43 -3
- package/templates/.agents/rules/issue-pr-commands.github.en.md +15 -220
- package/templates/.agents/rules/issue-pr-commands.github.zh-CN.md +23 -213
- package/templates/.agents/rules/issue-pr-commands.zh-CN.md +45 -3
- package/templates/.agents/rules/issue-sync.en.md +1 -1
- package/templates/.agents/rules/issue-sync.github.en.md +14 -301
- package/templates/.agents/rules/issue-sync.github.zh-CN.md +36 -287
- package/templates/.agents/rules/issue-sync.zh-CN.md +1 -1
- package/templates/.agents/rules/milestone-inference.en.md +1 -1
- package/templates/.agents/rules/milestone-inference.github.en.md +7 -119
- package/templates/.agents/rules/milestone-inference.github.zh-CN.md +8 -108
- package/templates/.agents/rules/milestone-inference.zh-CN.md +1 -1
- package/templates/.agents/rules/next-step-output.en.md +12 -11
- package/templates/.agents/rules/next-step-output.zh-CN.md +12 -11
- package/templates/.agents/rules/no-mid-flow-questions.en.md +3 -3
- package/templates/.agents/rules/no-mid-flow-questions.zh-CN.md +3 -3
- package/templates/.agents/rules/pr-checks-commands.en.md +16 -3
- package/templates/.agents/rules/pr-checks-commands.github.en.md +10 -54
- package/templates/.agents/rules/pr-checks-commands.github.zh-CN.md +19 -47
- package/templates/.agents/rules/pr-checks-commands.zh-CN.md +30 -3
- package/templates/.agents/rules/pr-sync.en.md +30 -3
- package/templates/.agents/rules/pr-sync.github.en.md +12 -115
- package/templates/.agents/rules/pr-sync.github.zh-CN.md +26 -104
- package/templates/.agents/rules/pr-sync.zh-CN.md +43 -3
- package/templates/.agents/rules/release-commands.en.md +2 -2
- package/templates/.agents/rules/release-commands.github.en.md +10 -40
- package/templates/.agents/rules/release-commands.github.zh-CN.md +9 -39
- package/templates/.agents/rules/release-commands.zh-CN.md +2 -2
- package/templates/.agents/rules/review-handshake.en.md +10 -6
- package/templates/.agents/rules/review-handshake.zh-CN.md +10 -6
- package/templates/.agents/rules/task-management.en.md +11 -2
- package/templates/.agents/rules/task-management.zh-CN.md +11 -3
- package/templates/.agents/rules/task-short-id.en.md +25 -29
- package/templates/.agents/rules/task-short-id.zh-CN.md +20 -23
- package/templates/.agents/rules/testing-discipline.en.md +20 -2
- package/templates/.agents/rules/testing-discipline.zh-CN.md +20 -2
- package/templates/.agents/scripts/lib/agent-infra-package.js +1 -9
- package/templates/.agents/scripts/task-short-id.js +71 -533
- package/templates/.agents/skills/analyze-task/SKILL.en.md +26 -56
- package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md +30 -60
- package/templates/.agents/skills/analyze-task/config/verify.en.json +1 -3
- package/templates/.agents/skills/analyze-task/config/verify.zh-CN.json +1 -3
- package/templates/.agents/skills/block-task/SKILL.en.md +21 -47
- package/templates/.agents/skills/block-task/SKILL.zh-CN.md +23 -47
- package/templates/.agents/skills/block-task/config/verify.json +1 -2
- package/templates/.agents/skills/cancel-task/SKILL.en.md +16 -45
- package/templates/.agents/skills/cancel-task/SKILL.zh-CN.md +16 -45
- package/templates/.agents/skills/cancel-task/config/verify.json +1 -2
- package/templates/.agents/skills/check-task/SKILL.en.md +6 -3
- package/templates/.agents/skills/check-task/SKILL.zh-CN.md +6 -3
- package/templates/.agents/skills/close-codescan/SKILL.en.md +6 -24
- package/templates/.agents/skills/close-codescan/SKILL.zh-CN.md +6 -24
- package/templates/.agents/skills/close-dependabot/SKILL.en.md +6 -24
- package/templates/.agents/skills/close-dependabot/SKILL.zh-CN.md +6 -24
- package/templates/.agents/skills/code-task/SKILL.en.md +22 -35
- package/templates/.agents/skills/code-task/SKILL.zh-CN.md +28 -44
- package/templates/.agents/skills/code-task/config/verify.en.json +3 -3
- package/templates/.agents/skills/code-task/config/verify.zh-CN.json +3 -3
- package/templates/.agents/skills/code-task/reference/dual-mode.en.md +13 -9
- package/templates/.agents/skills/code-task/reference/dual-mode.zh-CN.md +13 -9
- package/templates/.agents/skills/code-task/reference/fix-mode.en.md +1 -1
- package/templates/.agents/skills/code-task/reference/fix-mode.zh-CN.md +1 -1
- package/templates/.agents/skills/code-task/reference/report-template.en.md +11 -1
- package/templates/.agents/skills/code-task/reference/report-template.zh-CN.md +11 -1
- package/templates/.agents/skills/commit/SKILL.en.md +13 -11
- package/templates/.agents/skills/commit/SKILL.zh-CN.md +13 -11
- package/templates/.agents/skills/commit/config/verify.json +1 -2
- package/templates/.agents/skills/commit/reference/commit-message.en.md +1 -11
- package/templates/.agents/skills/commit/reference/commit-message.zh-CN.md +1 -11
- package/templates/.agents/skills/commit/reference/issue-metadata-sync.en.md +4 -8
- package/templates/.agents/skills/commit/reference/issue-metadata-sync.zh-CN.md +4 -8
- package/templates/.agents/skills/commit/reference/pr-summary-sync.en.md +6 -18
- package/templates/.agents/skills/commit/reference/pr-summary-sync.zh-CN.md +5 -17
- package/templates/.agents/skills/commit/reference/task-status-update.en.md +13 -0
- package/templates/.agents/skills/commit/reference/task-status-update.zh-CN.md +13 -0
- package/templates/.agents/skills/complete-manual-validation/SKILL.en.md +13 -36
- package/templates/.agents/skills/complete-manual-validation/SKILL.zh-CN.md +13 -36
- package/templates/.agents/skills/complete-manual-validation/config/verify.en.json +1 -3
- package/templates/.agents/skills/complete-manual-validation/config/verify.zh-CN.json +1 -3
- package/templates/.agents/skills/complete-manual-validation/reference/summary-update.en.md +10 -54
- package/templates/.agents/skills/complete-manual-validation/reference/summary-update.zh-CN.md +10 -79
- package/templates/.agents/skills/complete-task/SKILL.en.md +59 -63
- package/templates/.agents/skills/complete-task/SKILL.zh-CN.md +59 -63
- package/templates/.agents/skills/complete-task/config/verify.en.json +10 -7
- package/templates/.agents/skills/complete-task/config/verify.zh-CN.json +10 -7
- package/templates/.agents/skills/create-pr/SKILL.en.md +19 -44
- package/templates/.agents/skills/create-pr/SKILL.zh-CN.md +19 -43
- package/templates/.agents/skills/create-pr/config/verify.json +1 -2
- package/templates/.agents/skills/create-pr/reference/comment-publish.en.md +8 -12
- package/templates/.agents/skills/create-pr/reference/comment-publish.zh-CN.md +7 -11
- package/templates/.agents/skills/create-release-note/SKILL.en.md +17 -38
- package/templates/.agents/skills/create-release-note/SKILL.zh-CN.md +16 -37
- package/templates/.agents/skills/create-task/SKILL.en.md +16 -13
- package/templates/.agents/skills/create-task/SKILL.zh-CN.md +16 -13
- package/templates/.agents/skills/create-task/config/verify.json +1 -2
- package/templates/.agents/skills/create-task/reference/context-capture.en.md +29 -0
- package/templates/.agents/skills/create-task/reference/context-capture.zh-CN.md +29 -0
- package/templates/.agents/skills/import-codescan/SKILL.en.md +2 -2
- package/templates/.agents/skills/import-codescan/SKILL.zh-CN.md +2 -2
- package/templates/.agents/skills/import-codescan/config/verify.json +1 -2
- package/templates/.agents/skills/import-dependabot/SKILL.en.md +2 -2
- package/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md +2 -2
- package/templates/.agents/skills/import-dependabot/config/verify.json +1 -2
- package/templates/.agents/skills/import-issue/SKILL.en.md +9 -13
- package/templates/.agents/skills/import-issue/SKILL.zh-CN.md +10 -14
- package/templates/.agents/skills/import-issue/config/verify.json +1 -2
- package/templates/.agents/skills/plan-task/SKILL.en.md +17 -42
- package/templates/.agents/skills/plan-task/SKILL.zh-CN.md +22 -49
- package/templates/.agents/skills/plan-task/config/verify.en.json +1 -3
- package/templates/.agents/skills/plan-task/config/verify.zh-CN.json +1 -3
- package/templates/.agents/skills/post-release/SKILL.en.md +11 -81
- package/templates/.agents/skills/post-release/SKILL.zh-CN.md +8 -78
- package/templates/.agents/skills/refine-title/SKILL.en.md +1 -1
- package/templates/.agents/skills/refine-title/SKILL.zh-CN.md +1 -1
- package/templates/.agents/skills/release/SKILL.en.md +16 -163
- package/templates/.agents/skills/release/SKILL.zh-CN.md +15 -162
- package/templates/.agents/skills/restore-task/SKILL.en.md +11 -29
- package/templates/.agents/skills/restore-task/SKILL.zh-CN.md +11 -29
- package/templates/.agents/skills/restore-task/config/verify.json +1 -2
- package/templates/.agents/skills/review-analysis/SKILL.en.md +13 -25
- package/templates/.agents/skills/review-analysis/SKILL.zh-CN.md +13 -33
- package/templates/.agents/skills/review-analysis/config/verify.en.json +3 -4
- package/templates/.agents/skills/review-analysis/config/verify.zh-CN.json +3 -4
- package/templates/.agents/skills/review-analysis/reference/output-templates.en.md +9 -12
- package/templates/.agents/skills/review-analysis/reference/output-templates.zh-CN.md +9 -12
- package/templates/.agents/skills/review-analysis/reference/report-template.en.md +9 -2
- package/templates/.agents/skills/review-analysis/reference/report-template.zh-CN.md +9 -2
- package/templates/.agents/skills/review-analysis/reference/review-criteria.en.md +7 -0
- package/templates/.agents/skills/review-analysis/reference/review-criteria.zh-CN.md +7 -0
- package/templates/.agents/skills/review-code/SKILL.en.md +22 -36
- package/templates/.agents/skills/review-code/SKILL.zh-CN.md +23 -41
- package/templates/.agents/skills/review-code/config/verify.en.json +3 -4
- package/templates/.agents/skills/review-code/config/verify.zh-CN.json +3 -4
- package/templates/.agents/skills/review-code/reference/output-templates.en.md +56 -18
- package/templates/.agents/skills/review-code/reference/output-templates.zh-CN.md +56 -18
- package/templates/.agents/skills/review-code/reference/report-template.en.md +11 -4
- package/templates/.agents/skills/review-code/reference/report-template.zh-CN.md +11 -4
- package/templates/.agents/skills/review-code/reference/review-criteria.en.md +7 -0
- package/templates/.agents/skills/review-code/reference/review-criteria.zh-CN.md +7 -0
- package/templates/.agents/skills/review-plan/SKILL.en.md +13 -25
- package/templates/.agents/skills/review-plan/SKILL.zh-CN.md +13 -33
- package/templates/.agents/skills/review-plan/config/verify.en.json +3 -4
- package/templates/.agents/skills/review-plan/config/verify.zh-CN.json +3 -4
- package/templates/.agents/skills/review-plan/reference/output-templates.en.md +9 -12
- package/templates/.agents/skills/review-plan/reference/output-templates.zh-CN.md +9 -12
- package/templates/.agents/skills/review-plan/reference/report-template.en.md +9 -2
- package/templates/.agents/skills/review-plan/reference/report-template.zh-CN.md +9 -2
- package/templates/.agents/skills/review-plan/reference/review-criteria.en.md +7 -0
- package/templates/.agents/skills/review-plan/reference/review-criteria.zh-CN.md +7 -0
- package/templates/.agents/skills/update-agent-infra/SKILL.en.md +1 -2
- package/templates/.agents/skills/update-agent-infra/SKILL.zh-CN.md +1 -2
- package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js +3 -15
- package/templates/.agents/skills/watch-pr/SKILL.en.md +24 -14
- package/templates/.agents/skills/watch-pr/SKILL.zh-CN.md +25 -15
- package/templates/.agents/skills/watch-pr/config/verify.json +1 -2
- package/templates/.agents/skills/watch-pr/reference/monitor-and-heal.en.md +2 -2
- package/templates/.agents/skills/watch-pr/reference/monitor-and-heal.zh-CN.md +2 -2
- package/templates/.agents/templates/task.en.md +24 -1
- package/templates/.agents/templates/task.zh-CN.md +24 -1
- package/templates/.claude/commands/analyze-task.en.md +1 -1
- package/templates/.claude/commands/analyze-task.zh-CN.md +1 -1
- package/templates/.claude/commands/block-task.en.md +1 -1
- package/templates/.claude/commands/block-task.zh-CN.md +1 -1
- package/templates/.claude/commands/cancel-task.en.md +1 -1
- package/templates/.claude/commands/cancel-task.zh-CN.md +1 -1
- package/templates/.claude/commands/check-task.en.md +1 -1
- package/templates/.claude/commands/check-task.zh-CN.md +1 -1
- package/templates/.claude/commands/code-task.en.md +1 -1
- package/templates/.claude/commands/code-task.zh-CN.md +1 -1
- package/templates/.claude/commands/commit.en.md +1 -0
- package/templates/.claude/commands/commit.zh-CN.md +1 -0
- package/templates/.claude/commands/complete-manual-validation.en.md +1 -1
- package/templates/.claude/commands/complete-manual-validation.zh-CN.md +1 -1
- package/templates/.claude/commands/complete-task.en.md +1 -1
- package/templates/.claude/commands/complete-task.zh-CN.md +1 -1
- package/templates/.claude/commands/create-pr.en.md +1 -1
- package/templates/.claude/commands/create-pr.zh-CN.md +1 -1
- package/templates/.claude/commands/plan-task.en.md +1 -1
- package/templates/.claude/commands/plan-task.zh-CN.md +1 -1
- package/templates/.claude/commands/review-analysis.en.md +1 -1
- package/templates/.claude/commands/review-analysis.zh-CN.md +1 -1
- package/templates/.claude/commands/review-code.en.md +1 -1
- package/templates/.claude/commands/review-code.zh-CN.md +1 -1
- package/templates/.claude/commands/review-plan.en.md +1 -1
- package/templates/.claude/commands/review-plan.zh-CN.md +1 -1
- package/templates/.claude/commands/watch-pr.en.md +1 -1
- package/templates/.claude/commands/watch-pr.zh-CN.md +1 -1
- package/templates/.gemini/commands/_project_/analyze-task.en.toml +2 -0
- package/templates/.gemini/commands/_project_/analyze-task.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/block-task.en.toml +2 -0
- package/templates/.gemini/commands/_project_/block-task.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/cancel-task.en.toml +2 -0
- package/templates/.gemini/commands/_project_/cancel-task.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/check-task.en.toml +2 -0
- package/templates/.gemini/commands/_project_/check-task.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/code-task.en.toml +2 -0
- package/templates/.gemini/commands/_project_/code-task.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/commit.en.toml +4 -0
- package/templates/.gemini/commands/_project_/commit.zh-CN.toml +4 -0
- package/templates/.gemini/commands/_project_/complete-manual-validation.en.toml +2 -0
- package/templates/.gemini/commands/_project_/complete-manual-validation.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/complete-task.en.toml +2 -0
- package/templates/.gemini/commands/_project_/complete-task.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/create-pr.en.toml +2 -0
- package/templates/.gemini/commands/_project_/create-pr.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/plan-task.en.toml +2 -0
- package/templates/.gemini/commands/_project_/plan-task.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/review-analysis.en.toml +2 -0
- package/templates/.gemini/commands/_project_/review-analysis.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/review-code.en.toml +2 -0
- package/templates/.gemini/commands/_project_/review-code.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/review-plan.en.toml +2 -0
- package/templates/.gemini/commands/_project_/review-plan.zh-CN.toml +2 -0
- package/templates/.gemini/commands/_project_/watch-pr.en.toml +2 -0
- package/templates/.gemini/commands/_project_/watch-pr.zh-CN.toml +2 -0
- package/templates/.git-hooks/check-large-files.cjs +92 -0
- package/templates/.git-hooks/check-version-format.sh +5 -1
- package/templates/.git-hooks/pre-commit +1 -0
- package/templates/.opencode/commands/analyze-task.en.md +1 -1
- package/templates/.opencode/commands/analyze-task.zh-CN.md +1 -1
- package/templates/.opencode/commands/check-task.en.md +1 -1
- package/templates/.opencode/commands/check-task.zh-CN.md +1 -1
- package/templates/.opencode/commands/code-task.en.md +1 -1
- package/templates/.opencode/commands/code-task.zh-CN.md +1 -1
- package/templates/.opencode/commands/commit.en.md +2 -0
- package/templates/.opencode/commands/commit.zh-CN.md +2 -0
- package/templates/.opencode/commands/complete-task.en.md +1 -1
- package/templates/.opencode/commands/complete-task.zh-CN.md +1 -1
- package/templates/.opencode/commands/plan-task.en.md +1 -1
- package/templates/.opencode/commands/plan-task.zh-CN.md +1 -1
- package/templates/.opencode/commands/review-analysis.en.md +1 -1
- package/templates/.opencode/commands/review-analysis.zh-CN.md +1 -1
- package/templates/.opencode/commands/review-code.en.md +1 -1
- package/templates/.opencode/commands/review-code.zh-CN.md +1 -1
- package/templates/.opencode/commands/review-plan.en.md +1 -1
- package/templates/.opencode/commands/review-plan.zh-CN.md +1 -1
- package/templates/.agents/scripts/platform-adapters/platform-sync.github.js +0 -40
- package/templates/.agents/scripts/platform-adapters/platform-sync.js +0 -13
- package/templates/.agents/scripts/review-diff-fingerprint.js +0 -170
- package/templates/.agents/scripts/workflow-warnings.js +0 -290
- package/templates/.agents/skills/code-task/scripts/detect-mode.js +0 -257
- package/templates/.agents/skills/release/scripts/manage-milestones.github.sh +0 -80
- 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
|