@fitlab-ai/agent-infra 0.9.13 → 0.9.15
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 +10 -0
- package/README.zh-CN.md +10 -0
- package/bin/cli.ts +26 -9
- package/bin/internal-cli.sh +45 -0
- package/dist/bin/cli.js +173 -157
- package/dist/bin/internal-cli.js +126 -42
- package/dist/lib/agent-client.js +5 -0
- package/dist/lib/agent-clients/adapters/codex-lifecycle/capability-store.js +165 -27
- package/dist/lib/agent-clients/adapters/codex-lifecycle/sandbox-controller.js +3 -2
- package/dist/lib/defaults.json +103 -103
- package/dist/lib/fs/durable-write.js +37 -0
- package/dist/lib/fs/file-lock.js +111 -0
- package/dist/lib/host-control/audit.js +19 -0
- package/dist/lib/host-control/client.js +142 -0
- package/dist/lib/host-control/command.js +49 -0
- package/dist/lib/host-control/path.js +160 -0
- package/dist/lib/host-control/secure-fs.js +140 -0
- package/dist/lib/host-control/server.js +159 -0
- package/dist/lib/host-control/service.js +112 -0
- package/dist/lib/init.js +11 -2
- package/dist/lib/internal/agent-client.js +5 -2
- package/dist/lib/internal/cli-route-inventory.js +154 -0
- package/dist/lib/internal/codex-lifecycle.js +15 -12
- package/dist/lib/internal/codex-sandbox-controller.js +8 -2
- package/dist/lib/internal/demo-promotion.js +322 -0
- package/dist/lib/internal/demo-transcript.js +454 -0
- package/dist/lib/internal/git-workflow.js +10 -6
- package/dist/lib/internal/host-control.js +28 -0
- package/dist/lib/internal/manual-validation.js +322 -0
- package/dist/lib/internal/platform-checks.js +16 -4
- package/dist/lib/internal/platform-comment.js +16 -4
- package/dist/lib/internal/platform-context.js +4 -1
- package/dist/lib/internal/platform-issue.js +12 -4
- package/dist/lib/internal/platform-metadata.js +88 -0
- package/dist/lib/internal/platform-pr-review.js +16 -3
- package/dist/lib/internal/platform-pr.js +42 -14
- package/dist/lib/internal/platform-release-notes.js +6 -3
- package/dist/lib/internal/platform-security.js +93 -0
- package/dist/lib/internal/pr-review-grade.js +14 -3
- package/dist/lib/internal/release-workflow.js +82 -89
- package/dist/lib/internal/sandbox-control.js +171 -7
- package/dist/lib/internal/task-activity.js +13 -4
- package/dist/lib/internal/task-artifact.js +19 -107
- package/dist/lib/internal/task-context.js +4 -1
- package/dist/lib/internal/task-create.js +48 -14
- package/dist/lib/internal/task-delivery.js +4 -1
- package/dist/lib/internal/task-event.js +38 -35
- package/dist/lib/internal/task-finalization.js +4 -1
- package/dist/lib/internal/task-invalidation.js +4 -1
- package/dist/lib/internal/task-ledger.js +12 -1
- package/dist/lib/internal/task-lifecycle.js +4 -1
- package/dist/lib/internal/task-operation-registry.js +519 -0
- package/dist/lib/internal/task-orchestration.js +12 -0
- package/dist/lib/internal/task-override.js +10 -3
- package/dist/lib/internal/task-qualification.js +90 -0
- package/dist/lib/internal/task-review.js +10 -52
- package/dist/lib/internal/task-short-id.js +11 -1
- package/dist/lib/internal/task-snapshot.js +4 -1
- package/dist/lib/internal/task-validate.js +37 -12
- package/dist/lib/internal/task-verify.js +5 -1
- package/dist/lib/internal/task-warning.js +8 -1
- package/dist/lib/owned-path.js +33 -0
- package/dist/lib/platform/check-status.js +11 -0
- package/dist/lib/platform/comment-safety.js +229 -0
- package/dist/lib/platform/completion-backfill.js +1 -1
- package/dist/lib/platform/github-data.js +241 -0
- package/dist/lib/platform/github-provider.js +248 -26
- package/dist/lib/platform/issue-comments.js +146 -34
- package/dist/lib/platform/issues.js +1 -179
- package/dist/lib/platform/pr-change-report.js +6 -12
- package/dist/lib/platform/pr-checks.js +12 -65
- package/dist/lib/platform/pr-summary.js +83 -10
- package/dist/lib/platform/provider-contract.d.ts +67 -1
- package/dist/lib/platform/provider-contract.js +6 -2
- package/dist/lib/platform/provider-validation.js +76 -3
- package/dist/lib/platform/pull-requests.js +117 -275
- package/dist/lib/platform/repository-metadata.js +377 -0
- package/dist/lib/platform/security-alerts.js +155 -0
- package/dist/lib/platform/snapshots.js +2 -0
- package/dist/lib/platform/verification-sync.js +154 -162
- package/dist/lib/process-data/index.js +7 -0
- package/dist/lib/release/workflow.js +1 -1
- package/dist/lib/run/index.js +5 -0
- package/dist/lib/sandbox/commands/control-status.js +22 -0
- package/dist/lib/sandbox/commands/create.js +39 -8
- package/dist/lib/sandbox/commands/ls.js +5 -0
- package/dist/lib/sandbox/commands/rm.js +3 -807
- package/dist/lib/sandbox/commands/show.js +16 -0
- package/dist/lib/sandbox/control/audit.js +203 -0
- package/dist/lib/sandbox/control/client.js +125 -12
- package/dist/lib/sandbox/control/completed-reentry.js +85 -0
- package/dist/lib/sandbox/control/container-identity.js +28 -31
- package/dist/lib/sandbox/control/executor.js +233 -34
- package/dist/lib/sandbox/control/finalization-response.js +27 -0
- package/dist/lib/sandbox/control/identity-sentinel.js +107 -0
- package/dist/lib/sandbox/control/lifecycle.js +656 -128
- package/dist/lib/sandbox/control/native-file-lock.js +85 -0
- package/dist/lib/sandbox/control/protocol.js +55 -4
- package/dist/lib/sandbox/control/server.js +720 -79
- package/dist/lib/sandbox/control/state.js +63 -3
- package/dist/lib/sandbox/control/task-view.js +183 -0
- package/dist/lib/sandbox/control/task-workflow.js +74 -0
- package/dist/lib/sandbox/control/workflow-executor.js +99 -0
- package/dist/lib/sandbox/engines/authority.js +289 -0
- package/dist/lib/sandbox/engines/docker-exact-discovery.js +97 -0
- package/dist/lib/sandbox/index.js +7 -2
- package/dist/lib/sandbox/recovery.js +49 -5
- package/dist/lib/sandbox/removal.js +1717 -0
- package/dist/lib/sandbox/task-cleanup.js +217 -0
- package/dist/lib/sandbox/workspace-view.js +15 -15
- package/dist/lib/sandbox/worktree-safety.js +4 -1
- package/dist/lib/server/index.js +8 -0
- package/dist/lib/task/activity-intent.js +2 -1
- package/dist/lib/task/activity-log.js +30 -24
- package/dist/lib/task/artifact-command.js +101 -0
- package/dist/lib/task/artifact-lifecycle.js +71 -40
- package/dist/lib/task/artifact-name.js +36 -0
- package/dist/lib/task/artifact-operations.js +474 -0
- package/dist/lib/task/artifact-receipts.js +3 -15
- package/dist/lib/task/artifact-repair-intent.js +130 -0
- package/dist/lib/task/artifact-schema.js +127 -0
- package/dist/lib/task/capabilities.js +83 -19
- package/dist/lib/task/codex-orchestration.js +71 -25
- package/dist/lib/task/commit-identity.js +28 -0
- package/dist/lib/task/commit-operation.js +2 -16
- package/dist/lib/task/control-authority.js +375 -5
- package/dist/lib/task/control-recovery.js +128 -0
- package/dist/lib/task/create-service.js +103 -4
- package/dist/lib/task/create.js +80 -2
- package/dist/lib/task/decision-details.js +2 -46
- package/dist/lib/task/events.js +306 -76
- package/dist/lib/task/finalization-state.js +9 -0
- package/dist/lib/task/human-override.js +3 -6
- package/dist/lib/task/implementation-inputs.js +3 -3
- package/dist/lib/task/index.js +11 -3
- package/dist/lib/task/intermediate-cleanup.js +383 -0
- package/dist/lib/task/invalidation.js +18 -65
- package/dist/lib/task/ledger-intents.js +7 -22
- package/dist/lib/task/ledger.js +1 -3
- package/dist/lib/task/lifecycle.js +19 -1
- package/dist/lib/task/local-artifact-finalization.js +190 -290
- package/dist/lib/task/manual-validation-completion.js +26 -0
- package/dist/lib/task/manual-validation-evidence.js +130 -0
- package/dist/lib/task/manual-validation-receipt.js +101 -0
- package/dist/lib/task/manual-validation-shared.js +40 -0
- package/dist/lib/task/manual-validation-transaction.js +243 -0
- package/dist/lib/task/markdown.js +47 -0
- package/dist/lib/task/orchestration.js +206 -69
- package/dist/lib/task/qualification-audit.js +476 -0
- package/dist/lib/task/qualification-confirmation.js +109 -0
- package/dist/lib/task/qualification-intents.js +148 -0
- package/dist/lib/task/review-artifacts.js +23 -40
- package/dist/lib/task/review-command.js +25 -0
- package/dist/lib/task/review-finalization.js +146 -97
- package/dist/lib/task/review-fingerprint.js +2 -2
- package/dist/lib/task/sections.js +34 -54
- package/dist/lib/task/verification-config.js +11 -0
- package/dist/lib/task/verification-engine.js +170 -327
- package/dist/lib/task/verification.js +1 -1
- package/dist/lib/task/workflow-command.js +17 -0
- package/dist/lib/task/workflow-warning-intents.js +0 -16
- package/dist/lib/task/workflow-warnings.js +28 -2
- package/dist/lib/update.js +2 -0
- package/dist/lifecycle-build-manifest.json +3 -3
- package/lib/agent-client.ts +9 -0
- package/lib/agent-clients/adapters/codex-lifecycle/capability-store.ts +223 -33
- package/lib/agent-clients/adapters/codex-lifecycle/sandbox-controller.ts +3 -2
- package/lib/fs/durable-write.ts +29 -0
- package/lib/fs/file-lock.ts +113 -0
- package/lib/host-control/audit.ts +22 -0
- package/lib/host-control/client.ts +172 -0
- package/lib/host-control/command.ts +60 -0
- package/lib/host-control/path.ts +167 -0
- package/lib/host-control/secure-fs.ts +135 -0
- package/lib/host-control/server.ts +180 -0
- package/lib/host-control/service.ts +133 -0
- package/lib/init.ts +15 -2
- package/lib/internal/agent-client.ts +4 -2
- package/lib/internal/cli-route-inventory.ts +142 -0
- package/lib/internal/codex-lifecycle.ts +14 -12
- package/lib/internal/codex-sandbox-controller.ts +7 -2
- package/lib/internal/demo-promotion.ts +354 -0
- package/lib/internal/demo-transcript.ts +419 -0
- package/lib/internal/git-workflow.ts +9 -6
- package/lib/internal/host-control.ts +28 -0
- package/lib/internal/manual-validation.ts +306 -0
- package/lib/internal/platform-checks.ts +12 -4
- package/lib/internal/platform-comment.ts +12 -4
- package/lib/internal/platform-context.ts +3 -1
- package/lib/internal/platform-issue.ts +11 -4
- package/lib/internal/platform-metadata.ts +70 -0
- package/lib/internal/platform-pr-review.ts +14 -3
- package/lib/internal/platform-pr.ts +38 -14
- package/lib/internal/platform-release-notes.ts +5 -3
- package/lib/internal/platform-security.ts +83 -0
- package/lib/internal/pr-review-grade.ts +10 -3
- package/lib/internal/release-workflow.ts +91 -87
- package/lib/internal/sandbox-control.ts +181 -6
- package/lib/internal/task-activity.ts +12 -4
- package/lib/internal/task-artifact.ts +15 -79
- package/lib/internal/task-context.ts +3 -1
- package/lib/internal/task-create.ts +76 -15
- package/lib/internal/task-delivery.ts +3 -1
- package/lib/internal/task-event.ts +21 -10
- package/lib/internal/task-finalization.ts +3 -1
- package/lib/internal/task-invalidation.ts +3 -1
- package/lib/internal/task-ledger.ts +11 -1
- package/lib/internal/task-lifecycle.ts +3 -1
- package/lib/internal/task-operation-registry.ts +590 -0
- package/lib/internal/task-orchestration.ts +12 -0
- package/lib/internal/task-override.ts +9 -3
- package/lib/internal/task-qualification.ts +61 -0
- package/lib/internal/task-review.ts +7 -50
- package/lib/internal/task-short-id.ts +10 -1
- package/lib/internal/task-snapshot.ts +3 -1
- package/lib/internal/task-validate.ts +32 -12
- package/lib/internal/task-verify.ts +4 -1
- package/lib/internal/task-warning.ts +7 -1
- package/lib/owned-path.ts +26 -0
- package/lib/platform/check-status.ts +9 -0
- package/lib/platform/comment-safety.ts +255 -0
- package/lib/platform/completion-backfill.ts +1 -1
- package/lib/platform/github-data.ts +322 -0
- package/lib/platform/github-provider.ts +244 -27
- package/lib/platform/issue-comments.ts +159 -35
- package/lib/platform/issues.ts +4 -245
- package/lib/platform/pr-change-report.ts +6 -12
- package/lib/platform/pr-checks.ts +13 -77
- package/lib/platform/pr-summary.ts +88 -11
- package/lib/platform/provider-contract.ts +78 -3
- package/lib/platform/provider-validation.ts +85 -3
- package/lib/platform/pull-requests.ts +129 -348
- package/lib/platform/repository-metadata.ts +453 -0
- package/lib/platform/security-alerts.ts +191 -0
- package/lib/platform/snapshots.ts +53 -0
- package/lib/platform/verification-sync.ts +171 -177
- package/lib/process-data/index.ts +7 -0
- package/lib/release/workflow.ts +3 -3
- package/lib/run/index.ts +5 -0
- package/lib/sandbox/commands/control-status.ts +26 -0
- package/lib/sandbox/commands/create.ts +53 -12
- package/lib/sandbox/commands/ls.ts +7 -0
- package/lib/sandbox/commands/rm.ts +3 -996
- package/lib/sandbox/commands/show.ts +16 -0
- package/lib/sandbox/control/audit.ts +253 -0
- package/lib/sandbox/control/client.ts +150 -13
- package/lib/sandbox/control/completed-reentry.ts +98 -0
- package/lib/sandbox/control/container-identity.ts +27 -43
- package/lib/sandbox/control/executor.ts +262 -37
- package/lib/sandbox/control/finalization-response.ts +29 -0
- package/lib/sandbox/control/identity-sentinel.ts +137 -0
- package/lib/sandbox/control/lifecycle.ts +672 -18
- package/lib/sandbox/control/native-file-lock.ts +108 -0
- package/lib/sandbox/control/protocol.ts +80 -8
- package/lib/sandbox/control/server.ts +779 -82
- package/lib/sandbox/control/state.ts +84 -3
- package/lib/sandbox/control/task-view.ts +240 -0
- package/lib/sandbox/control/task-workflow.ts +95 -0
- package/lib/sandbox/control/workflow-executor.ts +102 -0
- package/lib/sandbox/engines/authority.ts +365 -0
- package/lib/sandbox/engines/docker-exact-discovery.ts +132 -0
- package/lib/sandbox/index.ts +9 -2
- package/lib/sandbox/recovery.ts +49 -6
- package/lib/sandbox/removal.ts +2144 -0
- package/lib/sandbox/task-cleanup.ts +209 -0
- package/lib/sandbox/workspace-view.ts +26 -18
- package/lib/sandbox/worktree-safety.ts +4 -1
- package/lib/server/index.ts +10 -0
- package/lib/task/activity-intent.ts +2 -2
- package/lib/task/activity-log.ts +27 -19
- package/lib/task/artifact-command.ts +104 -0
- package/lib/task/artifact-lifecycle.ts +66 -39
- package/lib/task/artifact-name.ts +55 -0
- package/lib/task/artifact-operations.ts +580 -0
- package/lib/task/artifact-receipts.ts +3 -14
- package/lib/task/artifact-repair-intent.ts +152 -0
- package/lib/task/artifact-schema.ts +163 -0
- package/lib/task/capabilities.ts +82 -22
- package/lib/task/codex-orchestration.ts +85 -24
- package/lib/task/commit-identity.ts +31 -0
- package/lib/task/commit-operation.ts +2 -16
- package/lib/task/control-authority.ts +513 -6
- package/lib/task/control-recovery.ts +174 -0
- package/lib/task/create-service.ts +131 -6
- package/lib/task/create.ts +83 -1
- package/lib/task/decision-details.ts +3 -71
- package/lib/task/events.ts +292 -75
- package/lib/task/finalization-state.ts +11 -0
- package/lib/task/human-override.ts +3 -8
- package/lib/task/implementation-inputs.ts +3 -3
- package/lib/task/index.ts +16 -3
- package/lib/task/intermediate-cleanup.ts +455 -0
- package/lib/task/invalidation.ts +18 -62
- package/lib/task/ledger-intents.ts +7 -24
- package/lib/task/ledger.ts +1 -3
- package/lib/task/lifecycle.ts +17 -1
- package/lib/task/local-artifact-finalization.ts +223 -388
- package/lib/task/manual-validation-completion.ts +40 -0
- package/lib/task/manual-validation-evidence.ts +209 -0
- package/lib/task/manual-validation-receipt.ts +152 -0
- package/lib/task/manual-validation-shared.ts +50 -0
- package/lib/task/manual-validation-transaction.ts +304 -0
- package/lib/task/markdown.ts +70 -0
- package/lib/task/orchestration.ts +191 -68
- package/lib/task/qualification-audit.ts +588 -0
- package/lib/task/qualification-confirmation.ts +117 -0
- package/lib/task/qualification-intents.ts +150 -0
- package/lib/task/review-artifacts.ts +21 -41
- package/lib/task/review-command.ts +23 -0
- package/lib/task/review-finalization.ts +154 -153
- package/lib/task/review-fingerprint.ts +2 -2
- package/lib/task/sections.ts +33 -52
- package/lib/task/verification-config.ts +12 -0
- package/lib/task/verification-engine.ts +165 -370
- package/lib/task/verification-types.ts +17 -0
- package/lib/task/verification.ts +1 -1
- package/lib/task/workflow-command.ts +18 -0
- package/lib/task/workflow-warning-intents.ts +0 -13
- package/lib/task/workflow-warnings.ts +21 -2
- package/lib/update.ts +6 -0
- package/package.json +7 -2
- package/templates/.agents/hooks/lifecycle-delegation.js +6 -6
- package/templates/.agents/rules/README.en.md +2 -0
- package/templates/.agents/rules/README.zh-CN.md +2 -0
- package/templates/.agents/rules/decision-qualification.en.md +22 -0
- package/templates/.agents/rules/decision-qualification.zh-CN.md +22 -0
- package/templates/.agents/rules/evidence-reporting.en.md +28 -0
- package/templates/.agents/rules/evidence-reporting.zh-CN.md +28 -0
- package/templates/.agents/rules/label-milestone-setup.en.md +7 -7
- package/templates/.agents/rules/label-milestone-setup.zh-CN.md +7 -7
- package/templates/.agents/rules/local-artifact-repair.en.md +5 -1
- package/templates/.agents/rules/local-artifact-repair.zh-CN.md +5 -1
- package/templates/.agents/rules/security-alerts.en.md +8 -8
- package/templates/.agents/rules/security-alerts.zh-CN.md +8 -8
- package/templates/.agents/rules/testing-discipline.en.md +2 -0
- package/templates/.agents/rules/testing-discipline.zh-CN.md +2 -0
- package/templates/.agents/scripts/package.json +3 -0
- package/templates/.agents/skills/analyze-task/SKILL.en.md +15 -2
- package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md +19 -2
- package/templates/.agents/skills/analyze-task/config/verify.en.json +1 -12
- package/templates/.agents/skills/analyze-task/config/verify.zh-CN.json +1 -12
- package/templates/.agents/skills/close-codescan/SKILL.en.md +2 -2
- package/templates/.agents/skills/close-codescan/SKILL.zh-CN.md +2 -2
- package/templates/.agents/skills/close-dependabot/SKILL.en.md +2 -2
- package/templates/.agents/skills/close-dependabot/SKILL.zh-CN.md +2 -2
- package/templates/.agents/skills/code-task/SKILL.en.md +14 -1
- package/templates/.agents/skills/code-task/SKILL.zh-CN.md +14 -1
- package/templates/.agents/skills/code-task/config/verify.en.json +5 -14
- package/templates/.agents/skills/code-task/config/verify.zh-CN.json +5 -14
- package/templates/.agents/skills/code-task/reference/code-rules.en.md +5 -4
- package/templates/.agents/skills/code-task/reference/code-rules.zh-CN.md +5 -4
- package/templates/.agents/skills/code-task/reference/dual-mode.en.md +1 -1
- package/templates/.agents/skills/code-task/reference/dual-mode.zh-CN.md +1 -1
- package/templates/.agents/skills/code-task/reference/fix-mode.en.md +3 -1
- package/templates/.agents/skills/code-task/reference/fix-mode.zh-CN.md +3 -1
- package/templates/.agents/skills/code-task/reference/report-template.en.md +42 -15
- package/templates/.agents/skills/code-task/reference/report-template.zh-CN.md +39 -12
- package/templates/.agents/skills/complete-manual-validation/SKILL.en.md +37 -21
- package/templates/.agents/skills/complete-manual-validation/SKILL.zh-CN.md +37 -21
- package/templates/.agents/skills/complete-manual-validation/config/verify.en.json +1 -1
- package/templates/.agents/skills/complete-manual-validation/config/verify.zh-CN.json +1 -1
- package/templates/.agents/skills/complete-manual-validation/reference/report-template.en.md +4 -0
- package/templates/.agents/skills/complete-manual-validation/reference/report-template.zh-CN.md +4 -0
- package/templates/.agents/skills/complete-manual-validation/reference/summary-update.en.md +16 -7
- package/templates/.agents/skills/complete-manual-validation/reference/summary-update.zh-CN.md +16 -7
- package/templates/.agents/skills/complete-task/SKILL.en.md +10 -23
- package/templates/.agents/skills/complete-task/SKILL.zh-CN.md +10 -23
- package/templates/.agents/skills/create-task/SKILL.en.md +8 -0
- package/templates/.agents/skills/create-task/SKILL.zh-CN.md +7 -0
- package/templates/.agents/skills/import-codescan/SKILL.en.md +1 -1
- package/templates/.agents/skills/import-codescan/SKILL.zh-CN.md +1 -1
- package/templates/.agents/skills/import-dependabot/SKILL.en.md +1 -1
- package/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md +1 -1
- package/templates/.agents/skills/init-labels/SKILL.en.md +8 -8
- package/templates/.agents/skills/init-labels/SKILL.zh-CN.md +8 -8
- package/templates/.agents/skills/init-milestones/SKILL.en.md +9 -11
- package/templates/.agents/skills/init-milestones/SKILL.zh-CN.md +9 -11
- package/templates/.agents/skills/plan-task/SKILL.en.md +14 -1
- package/templates/.agents/skills/plan-task/SKILL.zh-CN.md +16 -1
- package/templates/.agents/skills/plan-task/config/verify.en.json +4 -14
- package/templates/.agents/skills/plan-task/config/verify.zh-CN.json +4 -14
- package/templates/.agents/skills/release/SKILL.en.md +7 -3
- package/templates/.agents/skills/release/SKILL.zh-CN.md +7 -3
- package/templates/.agents/skills/review-analysis/SKILL.en.md +14 -1
- package/templates/.agents/skills/review-analysis/SKILL.zh-CN.md +14 -1
- package/templates/.agents/skills/review-analysis/config/verify.en.json +1 -18
- package/templates/.agents/skills/review-analysis/config/verify.zh-CN.json +1 -18
- package/templates/.agents/skills/review-analysis/reference/report-template.en.md +50 -23
- package/templates/.agents/skills/review-analysis/reference/report-template.zh-CN.md +45 -18
- package/templates/.agents/skills/review-code/SKILL.en.md +14 -1
- package/templates/.agents/skills/review-code/SKILL.zh-CN.md +14 -1
- package/templates/.agents/skills/review-code/config/verify.en.json +1 -23
- package/templates/.agents/skills/review-code/config/verify.zh-CN.json +1 -23
- package/templates/.agents/skills/review-code/reference/report-template.en.md +49 -22
- package/templates/.agents/skills/review-code/reference/report-template.zh-CN.md +45 -18
- package/templates/.agents/skills/review-plan/SKILL.en.md +14 -1
- package/templates/.agents/skills/review-plan/SKILL.zh-CN.md +14 -1
- package/templates/.agents/skills/review-plan/config/verify.en.json +1 -18
- package/templates/.agents/skills/review-plan/config/verify.zh-CN.json +1 -18
- package/templates/.agents/skills/review-plan/reference/report-template.en.md +49 -22
- package/templates/.agents/skills/review-plan/reference/report-template.zh-CN.md +45 -18
- package/templates/.agents/skills/review-pr/SKILL.en.md +5 -1
- package/templates/.agents/skills/review-pr/SKILL.zh-CN.md +5 -1
- package/templates/.agents/skills/review-pr/reference/report-template.en.md +4 -3
- package/templates/.agents/skills/review-pr/reference/report-template.zh-CN.md +4 -3
- package/templates/.agents/skills/run-manual-validation/SKILL.en.md +25 -4
- package/templates/.agents/skills/run-manual-validation/SKILL.zh-CN.md +25 -4
- package/templates/.agents/skills/run-manual-validation/reference/discovery-and-execution.en.md +4 -1
- package/templates/.agents/skills/run-manual-validation/reference/discovery-and-execution.zh-CN.md +4 -1
- package/templates/.agents/skills/run-manual-validation/reference/report-template.en.md +5 -1
- package/templates/.agents/skills/run-manual-validation/reference/report-template.zh-CN.md +5 -1
- package/templates/.agents/skills/run-task/SKILL.en.md +1 -1
- package/templates/.agents/skills/run-task/SKILL.zh-CN.md +1 -1
- package/templates/.agents/skills/test/SKILL.en.md +29 -7
- package/templates/.agents/skills/test/SKILL.zh-CN.md +29 -7
- package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js +14 -0
- package/templates/.agents/templates/task.en.md +6 -0
- package/templates/.agents/templates/task.zh-CN.md +6 -0
- package/templates/.claude/commands/run-manual-validation.en.md +1 -1
- package/templates/.claude/commands/run-manual-validation.zh-CN.md +1 -1
- package/dist/lib/platform/adapters.js +0 -56
- package/lib/platform/adapters.ts +0 -197
- package/templates/.agents/scripts/security-alerts.github.sh +0 -151
- package/templates/.agents/scripts/security-alerts.sh +0 -31
- package/templates/.agents/skills/init-labels/scripts/init-labels.github.sh +0 -146
- package/templates/.agents/skills/init-labels/scripts/init-labels.sh +0 -32
- package/templates/.agents/skills/init-milestones/scripts/init-milestones.github.sh +0 -294
- package/templates/.agents/skills/init-milestones/scripts/init-milestones.sh +0 -6
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { isCompletionEvidence } from '../../task/orchestration.js';
|
|
2
|
+
import { parseControlOutput } from '../../task/control-recovery.js';
|
|
1
3
|
import { execFileSync } from 'node:child_process';
|
|
2
4
|
import fs from 'node:fs';
|
|
3
5
|
import path from 'node:path';
|
|
@@ -5,6 +7,7 @@ import { createHash, randomUUID } from 'node:crypto';
|
|
|
5
7
|
import { buildProcessTreeStopCommand } from '../../server/process-control.js';
|
|
6
8
|
import { getProcessIdentityState } from '../../server/process-state.js';
|
|
7
9
|
import { parseSandboxControlResultEvidence, parseSandboxControlPayload, parseSandboxControlReservation, SANDBOX_CONTROL_MAX_RESPONSE_BYTES, SANDBOX_CONTROL_MAX_LOGICAL_RECORDS, SANDBOX_CONTROL_MAX_TERMINAL_RECORD_BYTES, SANDBOX_CONTROL_RESERVATION_BYTES } from './protocol.js';
|
|
10
|
+
import { parseSandboxTaskView, taskViewForManifest } from './task-view.js';
|
|
8
11
|
export const SANDBOX_CONTROL_AUDIT_MAX_BYTES = 1024 * 1024;
|
|
9
12
|
export const SANDBOX_CONTROL_EXECUTION_STOP_MS = 2_000;
|
|
10
13
|
function assertRegularFile(filePath) {
|
|
@@ -69,6 +72,62 @@ export function reservationPath(manifest, requestId) {
|
|
|
69
72
|
throw new Error('SANDBOX_CONTROL_RESERVATION_INVALID');
|
|
70
73
|
return path.join(manifest.processingDir, requestId, 'reservation.json');
|
|
71
74
|
}
|
|
75
|
+
export function terminalResultPath(manifest, requestId) {
|
|
76
|
+
if (!/^[a-f0-9-]{16,64}$/u.test(requestId))
|
|
77
|
+
throw new Error('SANDBOX_CONTROL_TERMINAL_RESULT_INVALID');
|
|
78
|
+
return path.join(manifest.processingDir, requestId, 'terminal-result.json');
|
|
79
|
+
}
|
|
80
|
+
export function createSandboxControlTerminalResult(manifest, request, output) {
|
|
81
|
+
const nested = parseControlOutput(output) ?? {};
|
|
82
|
+
const run = nested.run && typeof nested.run === 'object' && !Array.isArray(nested.run)
|
|
83
|
+
? nested.run : null;
|
|
84
|
+
const rawCompletion = nested.completionEvidence ?? run?.completionEvidence;
|
|
85
|
+
const operation = request.operation ?? (typeof nested.intent === 'string' ? nested.intent : null) ?? '';
|
|
86
|
+
return {
|
|
87
|
+
version: 1,
|
|
88
|
+
requestId: request.id,
|
|
89
|
+
generation: manifest.generation,
|
|
90
|
+
taskId: manifest.taskId,
|
|
91
|
+
intentDigest: createHash('sha256').update(`${request.family}\0${operation}`, 'utf8').digest('hex'),
|
|
92
|
+
targetState: typeof nested.targetState === 'string' ? nested.targetState : null,
|
|
93
|
+
status: typeof nested.status === 'string' ? nested.status : 'completed',
|
|
94
|
+
changed: typeof nested.changed === 'boolean' ? nested.changed : null,
|
|
95
|
+
completionEvidence: isCompletionEvidence(rawCompletion) ? rawCompletion : null
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
export function writeSandboxControlTerminalResult(manifest, request, output) {
|
|
99
|
+
const result = createSandboxControlTerminalResult(manifest, request, output);
|
|
100
|
+
const filePath = terminalResultPath(manifest, request.id);
|
|
101
|
+
try {
|
|
102
|
+
atomicWriteJsonNoReplace(filePath, result);
|
|
103
|
+
}
|
|
104
|
+
catch (error) {
|
|
105
|
+
if (!(error instanceof Error) || error.message !== 'SANDBOX_CONTROL_TERMINAL_ALREADY_EXISTS')
|
|
106
|
+
throw error;
|
|
107
|
+
const existing = readSandboxControlTerminalResult(filePath);
|
|
108
|
+
if (JSON.stringify(existing) !== JSON.stringify(result))
|
|
109
|
+
throw new Error('SANDBOX_CONTROL_TERMINAL_RESULT_CONFLICT');
|
|
110
|
+
}
|
|
111
|
+
return readSandboxControlTerminalResult(filePath);
|
|
112
|
+
}
|
|
113
|
+
export function readSandboxControlTerminalResult(filePath) {
|
|
114
|
+
const value = readJsonFile(filePath);
|
|
115
|
+
if (!value || value.version !== 1 || typeof value.requestId !== 'string'
|
|
116
|
+
|| typeof value.generation !== 'string' || (value.taskId !== null && typeof value.taskId !== 'string')
|
|
117
|
+
|| typeof value.intentDigest !== 'string' || !/^[a-f0-9]{64}$/u.test(value.intentDigest)
|
|
118
|
+
|| (value.targetState !== null && typeof value.targetState !== 'string')
|
|
119
|
+
|| typeof value.status !== 'string'
|
|
120
|
+
|| (value.changed !== null && typeof value.changed !== 'boolean')) {
|
|
121
|
+
throw new Error('SANDBOX_CONTROL_TERMINAL_RESULT_INVALID');
|
|
122
|
+
}
|
|
123
|
+
if (value.completionEvidence !== null && !isCompletionEvidence(value.completionEvidence)) {
|
|
124
|
+
throw new Error('SANDBOX_CONTROL_TERMINAL_RESULT_INVALID');
|
|
125
|
+
}
|
|
126
|
+
if (value.changed === undefined) {
|
|
127
|
+
throw new Error('SANDBOX_CONTROL_TERMINAL_RESULT_INVALID');
|
|
128
|
+
}
|
|
129
|
+
return value;
|
|
130
|
+
}
|
|
72
131
|
export function readSandboxControlResultEvidence(filePath) {
|
|
73
132
|
assertRegularFile(filePath);
|
|
74
133
|
const raw = fs.readFileSync(filePath, 'utf8');
|
|
@@ -233,16 +292,16 @@ export function sandboxControlGenerationUsage(manifest) {
|
|
|
233
292
|
export function statusPath(manifest) {
|
|
234
293
|
return path.join(manifest.publicStatusDir, 'status.json');
|
|
235
294
|
}
|
|
236
|
-
export function writeSandboxControlStatus(manifest, broker, state, reasonCode, activeRequestId, now = Date.now()) {
|
|
295
|
+
export function writeSandboxControlStatus(manifest, broker, state, reasonCode, activeRequestId, now = Date.now(), taskView = taskViewForManifest(manifest)) {
|
|
237
296
|
const status = {
|
|
238
|
-
version:
|
|
297
|
+
version: 3, generation: manifest.generation, broker, state, reasonCode, activeRequestId, updatedAt: now, taskView
|
|
239
298
|
};
|
|
240
299
|
atomicWriteJson(statusPath(manifest), status, 0o600, false);
|
|
241
300
|
return status;
|
|
242
301
|
}
|
|
243
302
|
export function parseSandboxControlStatus(value) {
|
|
244
303
|
const status = value;
|
|
245
|
-
if (!status || status.version !==
|
|
304
|
+
if (!status || status.version !== 3 || typeof status.generation !== 'string'
|
|
246
305
|
|| !status.broker || !Number.isSafeInteger(status.broker.pid) || typeof status.broker.startTime !== 'number'
|
|
247
306
|
|| !Number.isSafeInteger(status.broker.startTime) || typeof status.broker.brokerId !== 'string'
|
|
248
307
|
|| status.broker.brokerId.length === 0
|
|
@@ -251,6 +310,7 @@ export function parseSandboxControlStatus(value) {
|
|
|
251
310
|
|| (status.activeRequestId !== null && typeof status.activeRequestId !== 'string')
|
|
252
311
|
|| !Number.isSafeInteger(status.updatedAt))
|
|
253
312
|
throw new Error('SANDBOX_CONTROL_STATUS_INVALID');
|
|
313
|
+
parseSandboxTaskView(status.taskView);
|
|
254
314
|
return status;
|
|
255
315
|
}
|
|
256
316
|
export function readSandboxControlStatus(directory) {
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
export const SANDBOX_TASK_VIEW_STATES = ['not-applicable', 'current', 'finalized-stale', 'unknown'];
|
|
4
|
+
export const SANDBOX_TASK_VIEW_SOURCES = ['active', 'completed', 'unknown'];
|
|
5
|
+
function invalidView(message) {
|
|
6
|
+
return new Error(`SANDBOX_TASK_VIEW_INVALID: ${message}`);
|
|
7
|
+
}
|
|
8
|
+
function receiptIdentity(value, generation, requestId) {
|
|
9
|
+
if (!value || typeof value !== 'object' || Array.isArray(value))
|
|
10
|
+
return null;
|
|
11
|
+
const receipt = value;
|
|
12
|
+
const binding = receipt.controlBinding;
|
|
13
|
+
if (!binding || typeof binding !== 'object' || Array.isArray(binding))
|
|
14
|
+
return null;
|
|
15
|
+
const controlBinding = binding;
|
|
16
|
+
if (receipt.version !== 2 || typeof receipt.receiptId !== 'string' || receipt.receiptId.length === 0
|
|
17
|
+
|| !Number.isSafeInteger(receipt.revision) || receipt.revision < 0
|
|
18
|
+
|| receipt.lifecycle !== 'done'
|
|
19
|
+
|| controlBinding.generation !== generation
|
|
20
|
+
|| typeof controlBinding.requestId !== 'string'
|
|
21
|
+
|| !/^[a-f0-9-]{16,64}$/u.test(controlBinding.requestId)
|
|
22
|
+
|| (requestId !== undefined && controlBinding.requestId !== requestId))
|
|
23
|
+
return null;
|
|
24
|
+
return {
|
|
25
|
+
receiptId: receipt.receiptId,
|
|
26
|
+
revision: receipt.revision,
|
|
27
|
+
generation,
|
|
28
|
+
requestId: controlBinding.requestId
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
export function parseSandboxTaskView(value) {
|
|
32
|
+
if (!value || typeof value !== 'object' || Array.isArray(value))
|
|
33
|
+
throw invalidView('taskView must be an object');
|
|
34
|
+
const view = value;
|
|
35
|
+
const receipt = view.receipt === null ? null : parseSandboxTaskViewReceipt(view.receipt);
|
|
36
|
+
if (!SANDBOX_TASK_VIEW_STATES.includes(view.state)
|
|
37
|
+
|| (view.taskId !== null && typeof view.taskId !== 'string')
|
|
38
|
+
|| (view.observedSource !== null && !SANDBOX_TASK_VIEW_SOURCES.includes(view.observedSource))
|
|
39
|
+
|| (view.reasonCode !== null && typeof view.reasonCode !== 'string')
|
|
40
|
+
|| (view.receipt !== null && receipt === null)) {
|
|
41
|
+
throw invalidView('taskView schema is invalid');
|
|
42
|
+
}
|
|
43
|
+
if (view.state === 'not-applicable' && (view.taskId !== null || view.observedSource !== null || view.receipt !== null)) {
|
|
44
|
+
throw invalidView('not-applicable taskView cannot carry task evidence');
|
|
45
|
+
}
|
|
46
|
+
if (view.state === 'current' && (view.taskId === null || view.observedSource === null)) {
|
|
47
|
+
throw invalidView('current taskView requires taskId and observedSource');
|
|
48
|
+
}
|
|
49
|
+
if (view.state === 'current' && view.observedSource === 'completed' && view.receipt === null) {
|
|
50
|
+
throw invalidView('completed current taskView requires receipt');
|
|
51
|
+
}
|
|
52
|
+
if (view.state === 'finalized-stale' && (view.taskId === null || view.receipt === null)) {
|
|
53
|
+
throw invalidView('finalized-stale taskView requires taskId and receipt');
|
|
54
|
+
}
|
|
55
|
+
return view;
|
|
56
|
+
}
|
|
57
|
+
function parseSandboxTaskViewReceipt(value) {
|
|
58
|
+
if (!value || typeof value !== 'object' || Array.isArray(value))
|
|
59
|
+
return null;
|
|
60
|
+
const receipt = value;
|
|
61
|
+
if (Object.keys(receipt).sort().join(',') !== 'generation,receiptId,requestId,revision'
|
|
62
|
+
|| typeof receipt.receiptId !== 'string' || receipt.receiptId.length === 0
|
|
63
|
+
|| !Number.isSafeInteger(receipt.revision) || receipt.revision < 0
|
|
64
|
+
|| typeof receipt.generation !== 'string' || receipt.generation.length === 0
|
|
65
|
+
|| typeof receipt.requestId !== 'string' || !/^[a-f0-9-]{16,64}$/u.test(receipt.requestId))
|
|
66
|
+
return null;
|
|
67
|
+
return receipt;
|
|
68
|
+
}
|
|
69
|
+
export function taskViewForManifest(params) {
|
|
70
|
+
if (params.mode !== 'task-bound' || !params.taskId) {
|
|
71
|
+
return { state: 'not-applicable', taskId: null, observedSource: null, receipt: null, reasonCode: null };
|
|
72
|
+
}
|
|
73
|
+
const active = path.join(params.repoRoot, '.agents', 'workspace', 'active', params.taskId, 'task.md');
|
|
74
|
+
const completed = path.join(params.repoRoot, '.agents', 'workspace', 'completed', params.taskId, 'task.md');
|
|
75
|
+
const activeExists = fs.existsSync(active);
|
|
76
|
+
const completedExists = fs.existsSync(completed);
|
|
77
|
+
if (activeExists === completedExists) {
|
|
78
|
+
return {
|
|
79
|
+
state: 'unknown', taskId: params.taskId,
|
|
80
|
+
observedSource: activeExists ? 'unknown' : null,
|
|
81
|
+
receipt: null, reasonCode: activeExists ? 'SANDBOX_TASK_VIEW_SOURCE_CONFLICT' : 'SANDBOX_TASK_VIEW_SOURCE_MISSING'
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
const source = completedExists ? 'completed' : 'active';
|
|
85
|
+
const receipt = receiptIdentity(params.receipt, params.generation);
|
|
86
|
+
const receiptProvided = params.receipt !== undefined && params.receipt !== null;
|
|
87
|
+
if (source === 'completed' && receipt) {
|
|
88
|
+
return { state: 'current', taskId: params.taskId, observedSource: source, receipt, reasonCode: null };
|
|
89
|
+
}
|
|
90
|
+
if (source === 'active' && receipt) {
|
|
91
|
+
return {
|
|
92
|
+
state: 'finalized-stale', taskId: params.taskId, observedSource: source, receipt,
|
|
93
|
+
reasonCode: 'SANDBOX_TASK_VIEW_SOURCE_STALE'
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
if (receiptProvided) {
|
|
97
|
+
return {
|
|
98
|
+
state: 'unknown', taskId: params.taskId, observedSource: source, receipt: null,
|
|
99
|
+
reasonCode: 'SANDBOX_TASK_VIEW_RECEIPT_INVALID'
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
if (source === 'active') {
|
|
103
|
+
return { state: 'current', taskId: params.taskId, observedSource: source, receipt: null, reasonCode: null };
|
|
104
|
+
}
|
|
105
|
+
return {
|
|
106
|
+
state: 'unknown', taskId: params.taskId, observedSource: source, receipt: null,
|
|
107
|
+
reasonCode: 'SANDBOX_TASK_VIEW_EVIDENCE_UNAVAILABLE'
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
export function projectSandboxTaskView(input) {
|
|
111
|
+
if (input.mode !== 'task-bound' || !input.taskId) {
|
|
112
|
+
return { state: 'not-applicable', taskId: null, observedSource: null, receipt: null, reasonCode: null };
|
|
113
|
+
}
|
|
114
|
+
const receipt = receiptIdentity(input.receipt, input.generation, input.requestId);
|
|
115
|
+
if (input.source === 'completed' && receipt && input.sourceMatches) {
|
|
116
|
+
return { state: 'current', taskId: input.taskId, observedSource: 'completed', receipt, reasonCode: null };
|
|
117
|
+
}
|
|
118
|
+
if (receipt && input.source === 'active' && !input.sourceMatches) {
|
|
119
|
+
return { state: 'finalized-stale', taskId: input.taskId, observedSource: 'active', receipt, reasonCode: 'SANDBOX_TASK_VIEW_SOURCE_STALE' };
|
|
120
|
+
}
|
|
121
|
+
if (!receipt && input.source === 'active' && input.sourceMatches) {
|
|
122
|
+
return { state: 'current', taskId: input.taskId, observedSource: 'active', receipt: null, reasonCode: null };
|
|
123
|
+
}
|
|
124
|
+
return {
|
|
125
|
+
state: 'unknown',
|
|
126
|
+
taskId: input.taskId,
|
|
127
|
+
observedSource: input.source,
|
|
128
|
+
receipt,
|
|
129
|
+
reasonCode: receipt ? 'SANDBOX_TASK_VIEW_SOURCE_UNCONFIRMED' : 'SANDBOX_TASK_VIEW_EVIDENCE_UNAVAILABLE'
|
|
130
|
+
};
|
|
131
|
+
}
|
|
132
|
+
export function taskViewAfterFinalization(params) {
|
|
133
|
+
const receipt = receiptIdentity(params.receipt, params.generation, params.requestId);
|
|
134
|
+
if (!receipt) {
|
|
135
|
+
return {
|
|
136
|
+
state: 'unknown', taskId: params.taskId, observedSource: 'unknown', receipt: null,
|
|
137
|
+
reasonCode: 'SANDBOX_TASK_VIEW_RECEIPT_INVALID'
|
|
138
|
+
};
|
|
139
|
+
}
|
|
140
|
+
return {
|
|
141
|
+
state: 'finalized-stale', taskId: params.taskId, observedSource: 'active', receipt,
|
|
142
|
+
reasonCode: 'SANDBOX_TASK_VIEW_FINALIZED'
|
|
143
|
+
};
|
|
144
|
+
}
|
|
145
|
+
export function mergeSandboxTaskView(canonical, previous) {
|
|
146
|
+
if (previous.state !== 'finalized-stale' && previous.state !== 'unknown')
|
|
147
|
+
return canonical;
|
|
148
|
+
return previous;
|
|
149
|
+
}
|
|
150
|
+
export function accessSandboxTaskView(view, effect) {
|
|
151
|
+
if (effect === 'diagnostic' || effect === 'cleanup' || effect === 'recovery') {
|
|
152
|
+
return { allowed: true, state: view.state, reasonCode: view.reasonCode, message: null };
|
|
153
|
+
}
|
|
154
|
+
if (view.state === 'current' && view.observedSource === 'active') {
|
|
155
|
+
return { allowed: true, state: view.state, reasonCode: null, message: null };
|
|
156
|
+
}
|
|
157
|
+
const reasonCode = view.state === 'current'
|
|
158
|
+
? 'SANDBOX_TASK_VIEW_COMPLETED_READ_ONLY'
|
|
159
|
+
: view.reasonCode ?? `SANDBOX_TASK_VIEW_${view.state.toUpperCase().replaceAll('-', '_')}`;
|
|
160
|
+
return {
|
|
161
|
+
allowed: false,
|
|
162
|
+
state: view.state,
|
|
163
|
+
reasonCode,
|
|
164
|
+
message: view.state === 'unknown'
|
|
165
|
+
? 'task view cannot be confirmed; inspect status, recover the original request, or explicitly clean up the sandbox'
|
|
166
|
+
: view.state === 'finalized-stale'
|
|
167
|
+
? 'task view is finalized/stale; exit or clean up the sandbox, or use a validated re-entry'
|
|
168
|
+
: 'completed task views are read-only'
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
export function taskViewFromStatus(value) {
|
|
172
|
+
if (!value || typeof value !== 'object' || Array.isArray(value))
|
|
173
|
+
throw invalidView('status must be an object');
|
|
174
|
+
const status = value;
|
|
175
|
+
if (status.version !== 3)
|
|
176
|
+
throw invalidView('status version is unsupported');
|
|
177
|
+
const taskView = parseSandboxTaskView(status.taskView);
|
|
178
|
+
if (taskView.receipt && taskView.receipt.generation !== status.generation) {
|
|
179
|
+
throw invalidView('taskView receipt generation does not match status generation');
|
|
180
|
+
}
|
|
181
|
+
return taskView;
|
|
182
|
+
}
|
|
183
|
+
//# sourceMappingURL=task-view.js.map
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { randomUUID } from 'node:crypto';
|
|
4
|
+
import { readStableFile, SecureFileError, writeAtomicFile } from '../../host-control/secure-fs.js';
|
|
5
|
+
import { TASK_WORKFLOW_COMMANDS, TASK_WORKFLOW_OPERATIONS } from '../../task/workflow-command.js';
|
|
6
|
+
export function validateTaskWorkflowRequest(value) {
|
|
7
|
+
if (!value || typeof value !== 'object' || Array.isArray(value))
|
|
8
|
+
throw new Error('TASK_WORKFLOW_REQUEST_INVALID');
|
|
9
|
+
const request = value;
|
|
10
|
+
if (Object.keys(request).sort().join(',') !== 'args,generation,id,operation,taskId,version'
|
|
11
|
+
|| request.version !== 1 || typeof request.id !== 'string' || !/^[a-f0-9-]{16,64}$/u.test(request.id)
|
|
12
|
+
|| typeof request.taskId !== 'string' || !/^TASK-\d{8}-\d{6}$/u.test(request.taskId)
|
|
13
|
+
|| typeof request.generation !== 'string' || !request.generation
|
|
14
|
+
|| !Object.hasOwn(TASK_WORKFLOW_COMMANDS, request.operation)
|
|
15
|
+
|| !Array.isArray(request.args) || request.args.length < 2 || request.args.length > 128
|
|
16
|
+
|| !request.args.every((arg) => typeof arg === 'string' && !/[\r\n]/u.test(arg))
|
|
17
|
+
|| request.args[0] !== request.taskId)
|
|
18
|
+
throw new Error('TASK_WORKFLOW_REQUEST_INVALID');
|
|
19
|
+
const [, selector] = TASK_WORKFLOW_COMMANDS[request.operation];
|
|
20
|
+
if (selector !== null && request.args[1] !== selector)
|
|
21
|
+
throw new Error('TASK_WORKFLOW_REQUEST_INVALID');
|
|
22
|
+
return request;
|
|
23
|
+
}
|
|
24
|
+
/** Preserve argv verbatim; the domain command owns option parsing and validation. */
|
|
25
|
+
export function createTaskWorkflowRequest(command, args, taskId, generation) {
|
|
26
|
+
const operation = TASK_WORKFLOW_OPERATIONS.find((key) => {
|
|
27
|
+
const [name, selector] = TASK_WORKFLOW_COMMANDS[key];
|
|
28
|
+
return name === command && (selector === null || selector === args[1]);
|
|
29
|
+
});
|
|
30
|
+
if (!operation)
|
|
31
|
+
throw new Error('TASK_WORKFLOW_OPERATION_UNSUPPORTED');
|
|
32
|
+
return validateTaskWorkflowRequest({ version: 1, id: randomUUID(), taskId, generation, operation, args: [...args] });
|
|
33
|
+
}
|
|
34
|
+
export function canonicalArtifactName(value) {
|
|
35
|
+
return /^(?:analysis|plan|code|review-analysis|review-plan|review-code)(?:-r[1-9]\d*)?\.md$/u.test(value)
|
|
36
|
+
&& path.basename(value) === value;
|
|
37
|
+
}
|
|
38
|
+
function assertTaskArtifactDirectory(directory) {
|
|
39
|
+
const resolved = path.resolve(directory);
|
|
40
|
+
let stat;
|
|
41
|
+
try {
|
|
42
|
+
stat = fs.lstatSync(resolved);
|
|
43
|
+
}
|
|
44
|
+
catch {
|
|
45
|
+
throw new SecureFileError('TASK_ARTIFACT_WRITE_DENIED', 'task directory is unavailable');
|
|
46
|
+
}
|
|
47
|
+
if (!stat.isDirectory() || stat.isSymbolicLink()) {
|
|
48
|
+
throw new SecureFileError('TASK_ARTIFACT_WRITE_DENIED', 'task directory must be a real directory');
|
|
49
|
+
}
|
|
50
|
+
return resolved;
|
|
51
|
+
}
|
|
52
|
+
export async function readTaskArtifact(taskDir, input) {
|
|
53
|
+
if (!canonicalArtifactName(input.artifact))
|
|
54
|
+
throw new SecureFileError('TASK_ARTIFACT_WRITE_DENIED', 'artifact must be a canonical top-level basename');
|
|
55
|
+
const root = assertTaskArtifactDirectory(taskDir);
|
|
56
|
+
const candidate = path.join(root, input.artifact);
|
|
57
|
+
if (path.dirname(candidate) !== root)
|
|
58
|
+
throw new SecureFileError('TASK_ARTIFACT_WRITE_DENIED', 'artifact escapes task directory');
|
|
59
|
+
const stable = await readStableFile(candidate, {
|
|
60
|
+
maxBytes: 1024 * 1024,
|
|
61
|
+
...(input.expectedSha256 ? { expectedSha256: input.expectedSha256 } : {})
|
|
62
|
+
});
|
|
63
|
+
return { artifact: input.artifact, bytes: stable.bytes, sha256: stable.sha256 };
|
|
64
|
+
}
|
|
65
|
+
export async function writeTaskArtifact(taskDir, artifact) {
|
|
66
|
+
if (!canonicalArtifactName(artifact.artifact))
|
|
67
|
+
throw new SecureFileError('TASK_ARTIFACT_WRITE_DENIED', 'artifact must be a canonical top-level basename');
|
|
68
|
+
const root = assertTaskArtifactDirectory(taskDir);
|
|
69
|
+
const target = path.join(root, artifact.artifact);
|
|
70
|
+
if (path.dirname(target) !== root)
|
|
71
|
+
throw new SecureFileError('TASK_ARTIFACT_WRITE_DENIED', 'artifact escapes task directory');
|
|
72
|
+
await writeAtomicFile(target, artifact.bytes, 0o600, artifact.expectedSha256);
|
|
73
|
+
}
|
|
74
|
+
//# sourceMappingURL=task-workflow.js.map
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import { TASK_WORKFLOW_COMMANDS } from '../../task/workflow-command.js';
|
|
2
|
+
import { parseArtifactCommand, executeArtifactCommand } from '../../task/artifact-command.js';
|
|
3
|
+
import { parseReviewCommand } from '../../task/review-command.js';
|
|
4
|
+
import { prepareLocalArtifact, commitLocalArtifactProvenance } from '../../task/local-artifact-finalization.js';
|
|
5
|
+
import { prepareReviewSummaryCandidate, commitReviewSummaryProvenance } from '../../task/review-finalization.js';
|
|
6
|
+
import { withTaskExecutionLock } from '../../task/task-execution-lock.js';
|
|
7
|
+
import { dispatchHostControlCommand } from '../../host-control/command.js';
|
|
8
|
+
import { assertSandboxTaskSource } from '../workspace-view.js';
|
|
9
|
+
import { appendDiagnosticAudit } from './audit.js';
|
|
10
|
+
import { readTaskArtifact, writeTaskArtifact } from './task-workflow.js';
|
|
11
|
+
import { applyTaskEvent } from '../../task/events.js';
|
|
12
|
+
import { parseTaskEventRequest } from '../../internal/task-event.js';
|
|
13
|
+
function executionResult(result) {
|
|
14
|
+
return { exitCode: result.status === 'failed' || result.status === 'refused' ? 1 : 0, stdout: `${JSON.stringify(result)}\n`, stderr: '' };
|
|
15
|
+
}
|
|
16
|
+
/** The broker already authorized this host executor; domain operations own validation. */
|
|
17
|
+
export async function executeTaskWorkflow(manifest, request, lifecycleRecoveryAttestation = null) {
|
|
18
|
+
let publicationStarted = false;
|
|
19
|
+
try {
|
|
20
|
+
const taskDir = assertSandboxTaskSource(manifest.repoRoot, request.taskId);
|
|
21
|
+
const [command] = TASK_WORKFLOW_COMMANDS[request.operation];
|
|
22
|
+
if (request.operation === 'event') {
|
|
23
|
+
const eventRequest = parseTaskEventRequest(request.args);
|
|
24
|
+
const boundEventRequest = lifecycleRecoveryAttestation && eventRequest.requestId === undefined
|
|
25
|
+
? { ...eventRequest, requestId: lifecycleRecoveryAttestation.lifecycleRequestId }
|
|
26
|
+
: eventRequest;
|
|
27
|
+
const result = applyTaskEvent(boundEventRequest, {
|
|
28
|
+
repoRoot: manifest.repoRoot,
|
|
29
|
+
lifecycleRecoveryAttestation,
|
|
30
|
+
deferLifecycleRecoveryConsumption: true
|
|
31
|
+
});
|
|
32
|
+
return executionResult(result);
|
|
33
|
+
}
|
|
34
|
+
if (command !== 'task-artifact' && command !== 'task-review') {
|
|
35
|
+
publicationStarted = true;
|
|
36
|
+
// Inherit this executor's process group so its existing recovery owns the worker too.
|
|
37
|
+
const result = await dispatchHostControlCommand({
|
|
38
|
+
operation: command, payload: { workingDirectory: manifest.repoRoot, args: request.args }
|
|
39
|
+
});
|
|
40
|
+
return result;
|
|
41
|
+
}
|
|
42
|
+
const input = command === 'task-artifact' ? parseArtifactCommand(request.args) : parseReviewCommand(request.args);
|
|
43
|
+
if (command === 'task-artifact' && 'operation' in input && input.operation === 'inspect') {
|
|
44
|
+
return executionResult(executeArtifactCommand(input, { repoRoot: manifest.repoRoot }));
|
|
45
|
+
}
|
|
46
|
+
if ('operation' in input && (input.operation === 'init' || input.operation === 'repair')) {
|
|
47
|
+
return executionResult(executeArtifactCommand(input, { repoRoot: manifest.repoRoot, artifactDir: taskDir }));
|
|
48
|
+
}
|
|
49
|
+
return await withTaskExecutionLock(manifest.repoRoot, request.taskId, `sandbox-control.${request.operation}`, async () => {
|
|
50
|
+
const artifact = await readTaskArtifact(taskDir, { artifact: input.artifact });
|
|
51
|
+
const content = artifact.bytes.toString('utf8');
|
|
52
|
+
let result;
|
|
53
|
+
if ('operation' in input) {
|
|
54
|
+
const { family } = input;
|
|
55
|
+
if (family !== 'analysis' && family !== 'plan' && family !== 'code')
|
|
56
|
+
throw new Error('ARTIFACT_IDENTITY_INVALID');
|
|
57
|
+
const local = { taskRef: request.taskId, family, artifact: input.artifact, repoRoot: manifest.repoRoot };
|
|
58
|
+
const prepared = prepareLocalArtifact(local, content, lifecycleRecoveryAttestation ?? undefined);
|
|
59
|
+
if (prepared.result.status === 'failed')
|
|
60
|
+
return executionResult(commitLocalArtifactProvenance(prepared));
|
|
61
|
+
publicationStarted = true;
|
|
62
|
+
await writeTaskArtifact(taskDir, {
|
|
63
|
+
artifact: artifact.artifact,
|
|
64
|
+
bytes: artifact.bytes,
|
|
65
|
+
expectedSha256: artifact.sha256
|
|
66
|
+
});
|
|
67
|
+
result = commitLocalArtifactProvenance(prepared);
|
|
68
|
+
}
|
|
69
|
+
else {
|
|
70
|
+
if (input.overrideTicket)
|
|
71
|
+
throw new Error('TASK_WORKFLOW_OVERRIDE_UNSUPPORTED');
|
|
72
|
+
const prepared = prepareReviewSummaryCandidate(input, content, { repoRoot: manifest.repoRoot });
|
|
73
|
+
if (input.dryRun || prepared.result.status === 'planned')
|
|
74
|
+
return executionResult(prepared.result);
|
|
75
|
+
if (prepared.result.status === 'failed')
|
|
76
|
+
return executionResult(commitReviewSummaryProvenance(prepared, manifest.repoRoot));
|
|
77
|
+
publicationStarted = true;
|
|
78
|
+
await writeTaskArtifact(taskDir, {
|
|
79
|
+
artifact: input.artifact,
|
|
80
|
+
bytes: Buffer.from(prepared.content, 'utf8'),
|
|
81
|
+
expectedSha256: artifact.sha256
|
|
82
|
+
});
|
|
83
|
+
result = commitReviewSummaryProvenance(prepared, manifest.repoRoot);
|
|
84
|
+
}
|
|
85
|
+
if (result.status !== 'failed')
|
|
86
|
+
appendDiagnosticAudit(manifest, 'task-workflow-artifact-finalized', {
|
|
87
|
+
requestId: request.id, sandboxTaskId: request.taskId, workflowOperation: request.operation,
|
|
88
|
+
artifact: input.artifact, sha256: result.artifactSha256, semanticDigest: result.semanticDigest
|
|
89
|
+
});
|
|
90
|
+
return executionResult({ ...result, changed: true });
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
catch (error) {
|
|
94
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
95
|
+
const code = error?.code ?? /^([A-Z][A-Z0-9_]+)/u.exec(message)?.[1] ?? 'TASK_WORKFLOW_REQUEST_INVALID';
|
|
96
|
+
return executionResult({ status: 'failed', changed: publicationStarted ? null : false, error: { code, message } });
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
//# sourceMappingURL=workflow-executor.js.map
|