@moretea-labs/forge 1.6.0 → 1.7.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/AGENTS.md +4 -0
- package/CHANGELOG.md +39 -0
- package/CLAUDE.md +4 -0
- package/README.md +2 -2
- package/README.zh-CN.md +1 -1
- package/SKILL.md +2 -2
- package/THIRD_PARTY_NOTICES.md +1 -1
- package/agents/openai.yaml +1 -1
- package/assets/hooks/hook-input.sh +11 -8
- package/assets/hooks/lib/session-state.sh +10 -7
- package/assets/hooks/lib/workflow-state.sh +13 -177
- package/assets/hooks/post-tool-observer.sh +8 -2
- package/assets/hooks/prompt-guard.sh +5 -81
- package/assets/hooks/session-start-context.sh +56 -1
- package/assets/partials/05-workflow.partial.md +1 -1
- package/assets/partials-agents/02-operating-mode.partial.md +2 -0
- package/assets/partials-agents/03-orchestration.partial.md +1 -1
- package/assets/plugin-registry.v1.json +3 -3
- package/assets/reference-configs/document-generation.md +1 -1
- package/assets/reference-configs/harness-overview.md +1 -1
- package/assets/reference-configs/sprint-contracts.md +3 -3
- package/assets/skill-version.json +2 -2
- package/assets/templates/contract.template.md +2 -7
- package/assets/templates/helpers/capture-plan.sh +2 -2
- package/assets/templates/helpers/check-architecture-sync.sh +17 -0
- package/assets/templates/helpers/check-task-workflow.sh +4 -4
- package/assets/templates/helpers/contract-worktree.sh +1 -21
- package/assets/templates/helpers/ensure-task-workflow.sh +11 -36
- package/assets/templates/helpers/inspect-project-state.ts +8 -6
- package/assets/templates/helpers/migrate-project-template.sh +22 -45
- package/assets/templates/helpers/migrate-workflow-docs.ts +9 -7
- package/assets/templates/helpers/new-plan.sh +1 -1
- package/assets/templates/helpers/plan-to-todo.sh +12 -37
- package/assets/templates/helpers/ship-worktrees.sh +2 -29
- package/assets/templates/helpers/verify-contract.sh +1 -111
- package/assets/templates/helpers/verify-sprint.sh +3 -180
- package/assets/templates/helpers/workflow-contract.ts +5 -1
- package/assets/templates/plan.template.md +1 -1
- package/assets/templates/review.template.md +9 -34
- package/assets/workflow-contract.v1.json +10 -19
- package/docs/README.md +10 -10
- package/docs/architecture/CURRENT.md +178 -0
- package/docs/architecture/EVOLUTION.md +42 -0
- package/docs/architecture/current/README.md +4 -156
- package/docs/architecture/decisions/20260803-release-identity-binding-and-exit-policy.md +2 -2
- package/docs/architecture/decisions/20260823-immediate-controller-relay.md +53 -0
- package/docs/architecture/decisions/20260826-browser-runtime-v2.md +73 -0
- package/docs/architecture/history/README.md +7 -0
- package/docs/architecture/{chatgpt-handoff-facade.md → history/chatgpt-handoff-facade.md} +4 -0
- package/docs/architecture/{global-hook-runtime.md → history/global-hook-runtime.md} +7 -3
- package/docs/architecture/{ios-semantic-automation-provider-v2.md → history/ios-semantic-automation-provider-v2.md} +6 -2
- package/docs/architecture/history.md +3 -34
- package/docs/architecture/index.md +15 -98
- package/docs/architecture/modules/controller-runtime/transport-lifecycle.md +1 -1
- package/docs/architecture/reviews/2026-08-22-semantic-harness-convergence-acceptance.md +39 -0
- package/docs/architecture/versions/1.6.md +38 -0
- package/docs/architecture/versions/1.7.md +41 -0
- package/docs/forge-chatgpt-browser-engine.md +2 -2
- package/docs/forge-chatgpt-mcp-setup.md +4 -28
- package/docs/forge-chatgpt-supervised-automation.md +3 -3
- package/docs/forge-github-issue-launcher.md +1 -1
- package/docs/forge-plugin-management.md +1 -1
- package/docs/forge-runtime-self-healing-loop.md +1 -1
- package/docs/operations/controller-browser-plugin.md +26 -6
- package/docs/operations/controller-performance-and-502.md +143 -0
- package/docs/operations/controller-reliability-runbook.md +1 -1
- package/docs/operations/features.md +2 -2
- package/docs/operations/github-repository.md +1 -1
- package/docs/operations/homebrew.md +2 -2
- package/docs/operations/mcp-tool-exposure.md +5 -3
- package/docs/wiki/Architecture.md +6 -6
- package/docs/wiki/Implementation.md +2 -2
- package/docs/wiki/Integrations.md +2 -2
- package/docs/wiki/Work-Lifecycle.md +1 -1
- package/package.json +33 -11
- package/scripts/activate-source-baseline.ts +17 -13
- package/scripts/architecture-event.ts +2 -820
- package/scripts/architecture-queue.sh +2 -645
- package/scripts/archive-architecture-request.sh +2 -242
- package/scripts/archive-workflow.sh +1 -291
- package/scripts/benchmark-background-check-overlap.ts +228 -0
- package/scripts/benchmark-mcp-host.sh +117 -0
- package/scripts/benchmark-mcp-transport.ts +170 -0
- package/scripts/benchmark-quality-harness.ts +146 -0
- package/scripts/benchmark-route-session-concurrency.ts +207 -6
- package/scripts/benchmark-thin-harness-mcp-e2e.ts +7 -1
- package/scripts/benchmark-typescript-navigation.ts +186 -0
- package/scripts/benchmark-work-efficiency.ts +334 -0
- package/scripts/capability-config.ts +2 -392
- package/scripts/capability-resolver.ts +2 -503
- package/scripts/capture-plan.sh +1 -332
- package/scripts/check-agent-tooling.sh +2 -1558
- package/scripts/check-architecture-sync.sh +2 -371
- package/scripts/check-brain-manifest.sh +2 -253
- package/scripts/check-context-files.sh +2 -47
- package/scripts/check-deploy-sql-order.sh +2 -115
- package/scripts/check-mcp-compatibility.ts +14 -0
- package/scripts/check-runtime-architecture.mjs +349 -79
- package/scripts/check-skill-version.ts +3 -191
- package/scripts/check-source-duplication.mjs +61 -0
- package/scripts/check-stable-baseline.ts +92 -0
- package/scripts/check-task-sync.sh +2 -63
- package/scripts/check-task-workflow.sh +2 -1000
- package/scripts/codex-handoff-resume.sh +2 -267
- package/scripts/context-contract-sync.sh +2 -514
- package/scripts/contract-run.ts +2 -463
- package/scripts/contract-worktree.sh +1 -722
- package/scripts/ensure-task-workflow.sh +1 -1225
- package/scripts/host-temporary-cloud-mcp-e2e.sh +265 -0
- package/scripts/inspect-project-state.ts +4 -279
- package/scripts/install-standalone-recovery.ts +24 -0
- package/scripts/lib/project-init-lib.sh +22 -46
- package/scripts/lib/run-forge-helper.sh +19 -0
- package/scripts/lib/run-forge-helper.ts +26 -0
- package/scripts/migrate-project-template.sh +1 -1189
- package/scripts/migrate-workflow-docs.ts +4 -412
- package/scripts/new-plan.sh +1 -180
- package/scripts/new-spec.sh +1 -47
- package/scripts/new-sprint.sh +1 -46
- package/scripts/plan-to-todo.sh +1 -796
- package/scripts/prepare-codex-handoff.sh +2 -201
- package/scripts/prepare-handoff.sh +1 -78
- package/scripts/refresh-current-status.sh +2 -467
- package/scripts/run-governed-gate.ts +5 -1
- package/scripts/select-agent-context-blocks.sh +2 -64
- package/scripts/ship-worktrees.sh +1 -558
- package/scripts/smoke-ios-physical-device.ts +4 -2
- package/scripts/smoke-runtime-recovery.ts +1 -35
- package/scripts/smoke-schedule-engine.ts +1 -20
- package/scripts/sprint-backlog.sh +1 -834
- package/scripts/stage-runtime-release.ts +2 -1
- package/scripts/summarize-failures.sh +2 -123
- package/scripts/switch-plan.sh +1 -150
- package/scripts/sync-brain-docs.sh +2 -379
- package/scripts/sync-generated-authority.mjs +175 -0
- package/scripts/verify-contract.sh +2 -703
- package/scripts/verify-forge-runtime.sh +0 -1
- package/scripts/verify-sprint.sh +1 -677
- package/scripts/workflow-contract.ts +4 -205
- package/scripts/workstream-sync.sh +2 -261
- package/src/cli/agent-jobs/executor-health.ts +1 -1
- package/src/cli/commands/init-hook.ts +3 -3
- package/src/cli/commands/mcp.ts +9 -5
- package/src/cli/commands/plugin.ts +12 -3
- package/src/cli/commands/recovery.ts +25 -3
- package/src/cli/commands/runtime.ts +55 -3
- package/src/cli/commands/security.ts +12 -1
- package/src/cli/commands/setup-profile.ts +31 -21
- package/src/cli/controller/check-runner.ts +113 -5
- package/src/cli/controller/composite-result.ts +1 -1
- package/src/cli/controller/context/focus.ts +51 -0
- package/src/cli/controller/context/instruction-context.ts +114 -0
- package/src/cli/controller/context/known-paths.ts +76 -0
- package/src/cli/controller/context/query-planning.ts +110 -0
- package/src/cli/controller/context/rule-resolution.ts +532 -0
- package/src/cli/controller/context/source-materializer.ts +278 -0
- package/src/cli/controller/context/structural.ts +16 -0
- package/src/cli/controller/context/types.ts +286 -0
- package/src/cli/controller/context-pack.ts +828 -487
- package/src/cli/controller/launch-agents.ts +77 -2
- package/src/cli/controller/operational-plan.ts +2 -2
- package/src/cli/controller/work-mode.ts +6 -4
- package/src/cli/editing/edit-session.ts +60 -7
- package/src/cli/github/contracts.ts +16 -0
- package/src/cli/github/github.ts +135 -16
- package/src/cli/github/session.ts +2 -1
- package/src/cli/installer/managed-entries.ts +15 -1
- package/src/cli/local-bridge/console-automations.ts +54 -78
- package/src/cli/local-bridge/console-view-models.ts +1 -35
- package/src/cli/local-bridge/facade-api.ts +37 -264
- package/src/cli/local-bridge/frontend/src/App.tsx +3 -3
- package/src/cli/local-bridge/frontend/src/features/automations/AutomationsView.tsx +23 -13
- package/src/cli/local-bridge/frontend/src/features/capabilities/CapabilitiesView.tsx +37 -4
- package/src/cli/local-bridge/frontend/src/features/overview/OverviewView.tsx +6 -4
- package/src/cli/local-bridge/frontend/src/lib/api.ts +1 -6
- package/src/cli/local-bridge/frontend/src/lib/routes.ts +1 -1
- package/src/cli/local-bridge/frontend/src/shell/Sidebar.tsx +2 -2
- package/src/cli/local-bridge/frontend/src/styles.css +1 -1
- package/src/cli/local-bridge/frontend/src/types.ts +5 -8
- package/src/cli/local-bridge/job-store.ts +1 -490
- package/src/cli/local-bridge/server.ts +2 -515
- package/src/cli/local-bridge/ui-dist/app.css +1 -1
- package/src/cli/local-bridge/ui-dist/app.js +3703 -3757
- package/src/cli/mcp/auth.ts +5 -5
- package/src/cli/mcp/instructions.ts +3 -2
- package/src/cli/mcp/legacy-tool-service.ts +10 -222
- package/src/cli/mcp/multi-repository.ts +16 -5
- package/src/cli/mcp/oauth.ts +175 -26
- package/src/cli/mcp/post-finalize-work-attribution.ts +150 -0
- package/src/cli/mcp/repository-tools.ts +282 -146
- package/src/cli/mcp/server.ts +586 -116
- package/src/cli/mcp/tool-capability-cache.ts +1 -1
- package/src/cli/mcp/tool-contract.ts +14 -0
- package/src/cli/mcp/toolset-selection.ts +1 -1
- package/src/cli/mcp/toolset.ts +44 -7
- package/src/cli/mcp/transports/http.ts +124 -14
- package/src/cli/mcp/transports/session-registry.ts +43 -5
- package/src/cli/mcp/types.ts +3 -3
- package/src/cli/repositories/command-classifier.ts +103 -21
- package/src/cli/repositories/command-executor.ts +78 -526
- package/src/cli/repositories/command-process.ts +108 -0
- package/src/cli/repositories/command-scope.ts +99 -41
- package/src/cli/repositories/controller-home.ts +7 -8
- package/src/cli/repositories/git-command-executor.ts +2 -0
- package/src/cli/repositories/locks.ts +53 -16
- package/src/cli/repositories/repository-snapshot.ts +124 -0
- package/src/cli/repositories/selected-path-actions.ts +17 -9
- package/src/cli/repositories/structured-git.ts +118 -6
- package/src/cli/repository/inspector.ts +563 -65
- package/src/cli/repository/session-cache.ts +58 -17
- package/src/cli/v81-entry.ts +1 -4
- package/src/effects/fs-transaction.ts +85 -17
- package/src/runtime/context/codegraph-read-provider.ts +233 -2
- package/src/runtime/context/codegraph-sidecar.cjs +74 -40
- package/src/runtime/context/generic-lsp-provider.ts +355 -0
- package/src/runtime/context/lsp-client.ts +283 -0
- package/src/runtime/context/semantic-navigation-contract.ts +61 -0
- package/src/runtime/context/semantic-navigation.ts +223 -0
- package/src/runtime/context/swift-navigation.ts +565 -0
- package/src/runtime/context/typescript-navigation.ts +226 -0
- package/src/runtime/control-plane/dispatch-priority.ts +28 -0
- package/src/runtime/control-plane/execution/direct-edit-work-completion.ts +48 -16
- package/src/runtime/control-plane/execution/edit-validation-coordinator.ts +86 -24
- package/src/runtime/control-plane/execution/repository-work-attribution.ts +106 -0
- package/src/runtime/control-plane/execution/retained-work-resume.ts +203 -0
- package/src/runtime/control-plane/execution/session-store.ts +18 -0
- package/src/runtime/control-plane/execution/verification-evidence.ts +58 -3
- package/src/runtime/control-plane/execution/work-completion-authority.ts +58 -0
- package/src/runtime/control-plane/execution/work-evidence-policy.ts +200 -0
- package/src/runtime/control-plane/execution/work-execution-support.ts +386 -0
- package/src/runtime/control-plane/execution/work-finalization-service.ts +1913 -0
- package/src/runtime/control-plane/execution/work-handle-authority.ts +96 -0
- package/src/runtime/control-plane/execution/work-handle-store.ts +27 -2
- package/src/runtime/control-plane/execution/work-lifecycle-audit.ts +258 -0
- package/src/runtime/control-plane/execution/work-operation-service.ts +468 -0
- package/src/runtime/control-plane/execution/work-path-scope.ts +37 -0
- package/src/runtime/control-plane/execution/work-preparation-service.ts +479 -0
- package/src/runtime/control-plane/execution/work-process-evidence.ts +129 -0
- package/src/runtime/control-plane/execution/work-remote-delivery.ts +215 -0
- package/src/runtime/control-plane/execution/work-task-receipt.ts +22 -18
- package/src/runtime/control-plane/execution/work-terminal-cleanup.ts +156 -11
- package/src/runtime/control-plane/execution/work-validation-reconciler.ts +22 -14
- package/src/runtime/control-plane/execution/work-verification-context.ts +56 -0
- package/src/runtime/control-plane/execution/work-verification-service.ts +388 -0
- package/src/runtime/control-plane/execution/work-verification-snapshot.ts +90 -9
- package/src/runtime/control-plane/facade/capability-registry.ts +129 -25
- package/src/runtime/control-plane/facade/controller-round-relay.ts +1118 -0
- package/src/runtime/control-plane/facade/controller-session-store.ts +302 -12
- package/src/runtime/control-plane/facade/goal-workloop-access.ts +17 -1
- package/src/runtime/control-plane/facade/goal-workloop.ts +928 -190
- package/src/runtime/control-plane/facade/index.ts +3 -0
- package/src/runtime/control-plane/facade/plan-contract-store.ts +275 -42
- package/src/runtime/control-plane/facade/repository-work-admission.ts +147 -0
- package/src/runtime/control-plane/facade/requirement-authority.ts +83 -0
- package/src/runtime/control-plane/facade/semantic-admission.ts +205 -0
- package/src/runtime/control-plane/facade/suggested-actions.ts +5 -1
- package/src/runtime/control-plane/facade/types.ts +90 -10
- package/src/runtime/control-plane/facade/work-contract-store.ts +157 -261
- package/src/runtime/control-plane/facade/work-state-machine.ts +250 -0
- package/src/runtime/control-plane/generated-cache-retention.ts +271 -0
- package/src/runtime/control-plane/global-scheduler/config.ts +44 -0
- package/src/runtime/control-plane/global-scheduler/dispatch-capacity.ts +80 -0
- package/src/runtime/control-plane/global-scheduler/durable-admission.ts +46 -0
- package/src/runtime/control-plane/global-scheduler/maintenance.ts +152 -0
- package/src/runtime/control-plane/global-scheduler/projection-refresh.ts +84 -0
- package/src/runtime/control-plane/global-scheduler/reconciliation.ts +3 -3
- package/src/runtime/control-plane/global-scheduler/scheduler.ts +278 -543
- package/src/runtime/control-plane/global-scheduler/source-scan.ts +59 -0
- package/src/runtime/control-plane/global-scheduler/state.ts +88 -0
- package/src/runtime/control-plane/global-scheduler/worker-attachment.ts +57 -0
- package/src/runtime/control-plane/global-scheduler/worker-exit-decision.ts +38 -0
- package/src/runtime/control-plane/global-scheduler/worker-exit-reconciler.ts +175 -0
- package/src/runtime/control-plane/global-scheduler/worker-launch.ts +111 -0
- package/src/runtime/control-plane/global-scheduler/worker-lifecycle-store.ts +64 -0
- package/src/runtime/control-plane/global-scheduler/worker-lifecycle.ts +150 -0
- package/src/runtime/control-plane/global-scheduler/worker-process.ts +119 -0
- package/src/runtime/control-plane/global-scheduler/worker-stderr.ts +60 -0
- package/src/runtime/control-plane/launcher/chatgpt-work-binding-store.ts +63 -0
- package/src/runtime/control-plane/launcher/chatgpt-work-continuation.ts +365 -117
- package/src/runtime/control-plane/launcher/launch-reservation-store.ts +89 -0
- package/src/runtime/control-plane/launcher/thin-launcher.ts +244 -11
- package/src/runtime/control-plane/persistence/controller-home-migration.ts +487 -0
- package/src/runtime/control-plane/persistence/requirement-store.ts +0 -12
- package/src/runtime/control-plane/persistence/sqlite-store.ts +33 -2
- package/src/runtime/control-plane/release-retention.ts +62 -2
- package/src/runtime/control-plane/repo-actor/registry.ts +4 -2
- package/src/runtime/control-plane/routing/route-policy.ts +24 -21
- package/src/runtime/control-plane/routing/workspace-admission.ts +70 -0
- package/src/runtime/control-plane/runtime-status-client.ts +0 -2
- package/src/runtime/diagnostics/mcp-timing.ts +13 -0
- package/src/runtime/diagnostics/mcp-transport-benchmark.ts +129 -0
- package/src/runtime/diagnostics/performance.ts +24 -1
- package/src/runtime/evidence/event-ledger.ts +1 -1
- package/src/runtime/evidence/process-check-execution.ts +18 -0
- package/src/runtime/execution/jobs/child-reference.ts +6 -2
- package/src/runtime/execution/jobs/store.ts +58 -4
- package/src/runtime/execution/jobs/types.ts +1 -1
- package/src/runtime/execution/managed-workspace.ts +203 -1
- package/src/runtime/execution/process-runtime/check-facade.ts +51 -4
- package/src/runtime/execution/process-runtime/check-result.ts +88 -0
- package/src/runtime/execution/process-runtime/check-runner-sidecar.ts +7 -1
- package/src/runtime/execution/process-runtime/check-scheduling.ts +114 -0
- package/src/runtime/execution/process-runtime/command-facade.ts +367 -40
- package/src/runtime/execution/process-runtime/gc.ts +38 -6
- package/src/runtime/execution/process-runtime/lightweight-managed.ts +1201 -0
- package/src/runtime/execution/process-runtime/persisted-check.ts +51 -5
- package/src/runtime/execution/process-runtime/resource-claims.ts +10 -6
- package/src/runtime/execution/process-runtime/runtime.ts +53 -3
- package/src/runtime/execution/process-runtime/store.ts +1 -0
- package/src/runtime/execution/process-runtime/types.ts +4 -12
- package/src/runtime/execution/thin-harness/async-process.ts +12 -2
- package/src/runtime/execution/thin-harness/search-worker.ts +54 -5
- package/src/runtime/execution/work-activity.ts +21 -0
- package/src/runtime/execution/workers/executor.ts +18 -61
- package/src/runtime/gateway/mcp/execution-tools.ts +35 -1852
- package/src/runtime/gateway/mcp/legacy-ios-tool-adapter.ts +61 -0
- package/src/runtime/gateway/mcp/process-tools.ts +83 -37
- package/src/runtime/gateway/mcp/router.ts +186 -84
- package/src/runtime/gateway/mcp/runtime-tool-definitions.ts +565 -0
- package/src/runtime/gateway/mcp/runtime-tools.ts +2378 -1947
- package/src/runtime/plugins/app-store-connect-adapter.ts +216 -47
- package/src/runtime/plugins/browser-adapter.ts +2662 -829
- package/src/runtime/plugins/browser-automation-service.ts +10 -0
- package/src/runtime/plugins/browser-handoff-host.ts +2 -25
- package/src/runtime/plugins/browser-handoff.ts +110 -5
- package/src/runtime/plugins/browser-macos-bridge.ts +701 -63
- package/src/runtime/plugins/browser-manifest-surface.ts +603 -0
- package/src/runtime/plugins/browser-native-session-service.ts +222 -0
- package/src/runtime/plugins/browser-node-bridge.ts +6 -34
- package/src/runtime/plugins/browser-provider-registry.ts +109 -0
- package/src/runtime/plugins/browser-runtime-contract.ts +154 -0
- package/src/runtime/plugins/browser-runtime.ts +193 -0
- package/src/runtime/plugins/browser-session-authority.ts +332 -0
- package/src/runtime/plugins/browser-session-store.ts +121 -0
- package/src/runtime/plugins/browser-session-types.ts +98 -0
- package/src/runtime/plugins/capability-authorization-grants.ts +354 -0
- package/src/runtime/plugins/desktop-operator-registration.ts +10 -4
- package/src/runtime/plugins/external-adapter.ts +358 -3
- package/src/runtime/plugins/external-unix-socket.ts +7 -1
- package/src/runtime/plugins/first-party-registry.ts +2 -0
- package/src/runtime/plugins/github-adapter.ts +125 -0
- package/src/runtime/plugins/ios/agent-device-provider.ts +1 -1
- package/src/runtime/plugins/ios/agent-device-typed-provider.ts +52 -9
- package/src/runtime/plugins/ios/remote-xpc-hid.ts +1171 -0
- package/src/runtime/plugins/ios-adapter.ts +106 -16
- package/src/runtime/plugins/ios-agent-device.ts +234 -64
- package/src/runtime/plugins/ios-physical-device.ts +1143 -392
- package/src/runtime/plugins/lightweight-action.ts +153 -0
- package/src/runtime/plugins/local-system-adapter.ts +123 -6
- package/src/runtime/plugins/macos-capability-broker.ts +47 -9
- package/src/runtime/plugins/plugin-action-sidecar.ts +59 -0
- package/src/runtime/plugins/plugin-management-adapter.ts +49 -8
- package/src/runtime/plugins/resend-adapter.ts +1 -1
- package/src/runtime/plugins/store.ts +330 -33
- package/src/runtime/plugins/types.ts +38 -3
- package/src/runtime/plugins/xiaohongshu-publish.ts +515 -0
- package/src/runtime/projections/git-status-sampler.ts +16 -16
- package/src/runtime/projections/materialized-view.ts +28 -10
- package/src/runtime/recovery/maintenance-executor.ts +426 -25
- package/src/runtime/root/mcp-transport.ts +180 -10
- package/src/runtime/root/package-connector-service.ts +230 -10
- package/src/runtime/root/package-runtime-release.ts +143 -17
- package/src/runtime/root/package-runtime-service.ts +461 -22
- package/src/runtime/root/release-manifest.ts +144 -18
- package/src/runtime/root/release-materialize.ts +125 -32
- package/src/runtime/root/release-store.ts +48 -11
- package/src/runtime/root/runtime.ts +23 -5
- package/src/runtime/root/service.ts +100 -29
- package/src/runtime/root/types.ts +12 -0
- package/src/runtime/safe-tooling/ios-development.ts +321 -63
- package/src/runtime/shared/trusted-executable.ts +62 -0
- package/src/runtime/shared/trusted-node-executable.ts +48 -0
- package/src/runtime/standalone-recovery/core.ts +1079 -240
- package/src/runtime/standalone-recovery/entry.ts +100 -24
- package/src/runtime/standalone-recovery/installer.ts +20 -4
- package/src/runtime/standalone-recovery/service-labels.ts +2 -0
- package/src/runtime/standalone-recovery/watchdog-heartbeat.ts +160 -0
- package/src/runtime/workflow/schedules/browser-probe.ts +81 -3
- package/src/runtime/workflow/schedules/engine.ts +364 -202
- package/src/runtime/workflow/schedules/github-issue-watch.ts +158 -0
- package/src/runtime/workflow/schedules/settlement.ts +64 -17
- package/src/runtime/workflow/schedules/store.ts +209 -19
- package/src/runtime/workflow/schedules/types.ts +2 -4
- package/src/runtime/workflow/schedules/work-continuation.ts +26 -13
- package/src/testing/test-governance.ts +8 -40
- package/assets/reference-configs/heartbeat-triage.md +0 -57
- package/assets/templates/helpers/harness-trace-grade.sh +0 -150
- package/assets/templates/helpers/heartbeat-triage.sh +0 -361
- package/assets/templates/helpers/maintenance-triage.sh +0 -167
- package/docs/architecture/current/approved-target-architecture.zh-CN.md +0 -1501
- package/docs/architecture/current/architecture-invariants.md +0 -331
- package/docs/architecture/current/automation-and-schedule-engine.md +0 -459
- package/docs/architecture/current/codegraph-context-provider.md +0 -238
- package/docs/architecture/current/control-plane-authority-inventory.md +0 -94
- package/docs/architecture/current/controller-repository-decoupling.md +0 -148
- package/docs/architecture/current/dispatch-and-agent-strategy.md +0 -373
- package/docs/architecture/current/entity-model.md +0 -612
- package/docs/architecture/current/external-plugin-governance.md +0 -396
- package/docs/architecture/current/failure-recovery.md +0 -447
- package/docs/architecture/current/governance.md +0 -213
- package/docs/architecture/current/human-interaction-plane.md +0 -87
- package/docs/architecture/current/implementation-status.md +0 -128
- package/docs/architecture/current/job-and-run-lifecycle.md +0 -413
- package/docs/architecture/current/legacy-governance.md +0 -58
- package/docs/architecture/current/local-workspace-target-grants.md +0 -70
- package/docs/architecture/current/migration-roadmap.md +0 -105
- package/docs/architecture/current/multi-repository-execution.md +0 -371
- package/docs/architecture/current/operations-runbook.md +0 -45
- package/docs/architecture/current/peer-supercontroller-runtime.md +0 -32
- package/docs/architecture/current/personal-assistant-plugin-baseline.md +0 -206
- package/docs/architecture/current/repository-access-modes.md +0 -102
- package/docs/architecture/current/route-policy.md +0 -15
- package/docs/architecture/current/route-session-concurrency.md +0 -85
- package/docs/architecture/current/runtime-architecture-simplification.md +0 -214
- package/docs/architecture/current/runtime-directory-map.md +0 -49
- package/docs/architecture/current/runtime-health-and-resource-lifecycle.md +0 -85
- package/docs/architecture/current/scheduler-and-resource-claims.md +0 -422
- package/docs/architecture/current/session-aware-execution-and-authorization.md +0 -77
- package/docs/architecture/current/system-overview.md +0 -169
- package/docs/architecture/current/target-requirements-traceability.md +0 -202
- package/docs/architecture/current/thin-harness-governance-policy.md +0 -32
- package/docs/architecture/current/thin-harness-v1.md +0 -321
- package/docs/architecture/current/verification-and-release-gates.md +0 -391
- package/docs/forge-autonomous-goal-loop.md +0 -9
- package/docs/forge-provider-configuration.md +0 -7
- package/docs/operations/chatgpt-personal-assistant-runtime.md +0 -93
- package/docs/operations/gmail-assistant-routines.md +0 -186
- package/docs/operations/personal-assistant-operator-guide.md +0 -61
- package/docs/operations/provider-configuration.md +0 -31
- package/scripts/harness-trace-grade.sh +0 -150
- package/scripts/heartbeat-triage.sh +0 -361
- package/scripts/maintenance-triage.sh +0 -167
- package/src/cli/local-bridge/frontend/src/features/settings/SettingsView.tsx +0 -2
- package/src/cli/repositories/goal-registry.ts +0 -239
- package/src/runtime/assistant/action-proposals.ts +0 -279
- package/src/runtime/assistant/intent.ts +0 -395
- package/src/runtime/assistant/model-provider.ts +0 -460
- package/src/runtime/assistant/openapi.ts +0 -223
- package/src/runtime/assistant/policy.ts +0 -89
- package/src/runtime/assistant/readiness.ts +0 -258
- package/src/runtime/assistant/routine-runtime.ts +0 -477
- package/src/runtime/assistant/schedule-binding.ts +0 -171
- package/src/runtime/assistant/standing-grants.ts +0 -375
- package/src/runtime/assistant/store.ts +0 -243
- package/src/runtime/assistant/types.ts +0 -135
- package/src/runtime/control-plane/goal-loop/config-facade.ts +0 -700
- package/src/runtime/control-plane/goal-loop/config-store.ts +0 -570
- package/src/runtime/control-plane/goal-loop/config-types.ts +0 -213
- package/src/runtime/control-plane/goal-loop/executor-router.ts +0 -109
- package/src/runtime/control-plane/goal-loop/failure-taxonomy.ts +0 -149
- package/src/runtime/control-plane/goal-loop/goal-contract-store.ts +0 -304
- package/src/runtime/control-plane/goal-loop/goal-loop-engine.ts +0 -1001
- package/src/runtime/control-plane/goal-loop/handoff-packet.ts +0 -160
- package/src/runtime/control-plane/goal-loop/index.ts +0 -13
- package/src/runtime/control-plane/goal-loop/local-tools.ts +0 -290
- package/src/runtime/control-plane/goal-loop/policy-gates.ts +0 -203
- package/src/runtime/control-plane/goal-loop/provider-dispatch.ts +0 -93
- package/src/runtime/control-plane/goal-loop/provider-registry.ts +0 -545
- package/src/runtime/control-plane/goal-loop/types.ts +0 -378
- package/src/runtime/control-plane/startup-recovery.ts +0 -198
- package/src/runtime/gateway/mcp/resource-policy.ts +0 -186
- package/src/runtime/personal-assistant/gmail-triage-manager.ts +0 -231
- package/src/runtime/personal-assistant/reporting-runtime.ts +0 -344
- package/src/runtime/personal-assistant/triage-runtime.ts +0 -748
- package/src/runtime/workflow/findings/store.ts +0 -204
- package/src/runtime/workflow/findings/types.ts +0 -58
- package/src/runtime/workflow/portfolio/engine.ts +0 -20
- package/src/runtime/workflow/portfolio/store.ts +0 -185
- package/src/runtime/workflow/portfolio/types.ts +0 -29
|
@@ -224,19 +224,8 @@ active_slug_or_empty() {
|
|
|
224
224
|
plan_slug_from_path "$active_plan"
|
|
225
225
|
}
|
|
226
226
|
|
|
227
|
-
review_recommends_pass_fallback() {
|
|
228
|
-
local review_file="$1"
|
|
229
|
-
grep -Eq '^> \*\*Recommendation\*\*:[[:space:]]*pass([[:space:]]*)$' "$review_file"
|
|
230
|
-
}
|
|
231
|
-
|
|
232
|
-
external_acceptance_pass_fallback() {
|
|
233
|
-
local review_file="$1"
|
|
234
|
-
grep -Eq '^> \*\*External Acceptance\*\*:[[:space:]]*(pass|manual_override)([[:space:]]*)$' "$review_file" \
|
|
235
|
-
&& grep -Eq '^-?[[:space:]]*P1 blockers:[[:space:]]*none([[:space:]]*)$' "$review_file"
|
|
236
|
-
}
|
|
237
|
-
|
|
238
227
|
require_finish_ready() {
|
|
239
|
-
local contract_file=""
|
|
228
|
+
local contract_file="" checks_file=".ai/harness/checks/latest.json" checks_error=""
|
|
240
229
|
|
|
241
230
|
[[ -x "scripts/contract-worktree.sh" ]] || fail "scripts/contract-worktree.sh is missing or not executable"
|
|
242
231
|
[[ -x "scripts/verify-sprint.sh" ]] || fail "scripts/verify-sprint.sh is missing or not executable"
|
|
@@ -245,27 +234,11 @@ require_finish_ready() {
|
|
|
245
234
|
if declare -F workflow_active_contract >/dev/null 2>&1; then
|
|
246
235
|
contract_file="$(workflow_active_contract 2>/dev/null || true)"
|
|
247
236
|
fi
|
|
248
|
-
if declare -F workflow_active_review >/dev/null 2>&1; then
|
|
249
|
-
review_file="$(workflow_active_review 2>/dev/null || true)"
|
|
250
|
-
fi
|
|
251
237
|
if declare -F workflow_checks_file >/dev/null 2>&1; then
|
|
252
238
|
checks_file="$(workflow_checks_file)"
|
|
253
239
|
fi
|
|
254
240
|
|
|
255
241
|
[[ -n "$contract_file" && -f "$contract_file" ]] || fail "active sprint contract is missing"
|
|
256
|
-
[[ -n "$review_file" && -f "$review_file" ]] || fail "active sprint review is missing"
|
|
257
|
-
|
|
258
|
-
if declare -F workflow_review_recommends_pass >/dev/null 2>&1; then
|
|
259
|
-
workflow_review_recommends_pass "$review_file" || fail "$review_file does not recommend pass"
|
|
260
|
-
else
|
|
261
|
-
review_recommends_pass_fallback "$review_file" || fail "$review_file does not recommend pass"
|
|
262
|
-
fi
|
|
263
|
-
|
|
264
|
-
if declare -F workflow_external_acceptance_pass >/dev/null 2>&1; then
|
|
265
|
-
workflow_external_acceptance_pass "$review_file" || fail "$review_file has no passing external acceptance"
|
|
266
|
-
else
|
|
267
|
-
external_acceptance_pass_fallback "$review_file" || fail "$review_file has no passing external acceptance"
|
|
268
|
-
fi
|
|
269
242
|
|
|
270
243
|
run_cmd bash "scripts/verify-sprint.sh"
|
|
271
244
|
if [[ "$DRY_RUN" -eq 1 ]]; then
|
|
@@ -273,7 +246,7 @@ require_finish_ready() {
|
|
|
273
246
|
fi
|
|
274
247
|
|
|
275
248
|
if declare -F workflow_checks_pass >/dev/null 2>&1; then
|
|
276
|
-
if ! checks_error="$(workflow_checks_pass "$checks_file" "$contract_file"
|
|
249
|
+
if ! checks_error="$(workflow_checks_pass "$checks_file" "$contract_file")"; then
|
|
277
250
|
fail "$checks_error"
|
|
278
251
|
fi
|
|
279
252
|
elif ! grep -Eq '"status"[[:space:]]*:[[:space:]]*"pass"' "$checks_file"; then
|
|
@@ -69,24 +69,6 @@ read_contract_status() {
|
|
|
69
69
|
awk '/^> \*\*Status\*\*:/ {sub(/^.*> \*\*Status\*\*: */, ""); gsub(/\r/, ""); print; exit}' "$file" | xargs
|
|
70
70
|
}
|
|
71
71
|
|
|
72
|
-
read_contract_review_file() {
|
|
73
|
-
local file="$1"
|
|
74
|
-
local line=""
|
|
75
|
-
local value=""
|
|
76
|
-
|
|
77
|
-
line="$(grep -m 1 -E '^> \*\*Review File\*\*:' "$file" || true)"
|
|
78
|
-
[[ -n "$line" ]] || return 0
|
|
79
|
-
|
|
80
|
-
if [[ "$line" == *\`* ]]; then
|
|
81
|
-
value="${line#*\`}"
|
|
82
|
-
value="${value%%\`*}"
|
|
83
|
-
else
|
|
84
|
-
value="${line#*> **Review File**:}"
|
|
85
|
-
fi
|
|
86
|
-
|
|
87
|
-
printf '%s' "$value" | tr -d '\r' | sed -E 's/^[[:space:]]+//; s/[[:space:]]+$//'
|
|
88
|
-
}
|
|
89
|
-
|
|
90
72
|
read_contract_task_profile() {
|
|
91
73
|
local file="$1"
|
|
92
74
|
awk '/^> \*\*Task Profile\*\*:/ {sub(/^.*> \*\*Task Profile\*\*:[[:space:]]*/, ""); gsub(/\r/, ""); print; exit}' "$file" | xargs
|
|
@@ -130,36 +112,6 @@ contract_allowed_paths() {
|
|
|
130
112
|
'
|
|
131
113
|
}
|
|
132
114
|
|
|
133
|
-
review_recommends_pass() {
|
|
134
|
-
local review_file="$1"
|
|
135
|
-
[[ -n "$review_file" && -f "$review_file" ]] || return 1
|
|
136
|
-
grep -Eq '^> \*\*Recommendation\*\*:[[:space:]]*pass[[:space:]]*$' "$review_file"
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
review_score() {
|
|
140
|
-
local review_file="$1"
|
|
141
|
-
local dimension="$2"
|
|
142
|
-
|
|
143
|
-
[[ -n "$review_file" && -f "$review_file" ]] || return 1
|
|
144
|
-
|
|
145
|
-
awk -F'|' -v wanted="$dimension" '
|
|
146
|
-
function trim(s) {
|
|
147
|
-
gsub(/^[[:space:]]+/, "", s)
|
|
148
|
-
gsub(/[[:space:]]+$/, "", s)
|
|
149
|
-
return s
|
|
150
|
-
}
|
|
151
|
-
BEGIN { wanted = tolower(wanted) }
|
|
152
|
-
/^\|/ {
|
|
153
|
-
dim = tolower(trim($2))
|
|
154
|
-
score = trim($3)
|
|
155
|
-
if (dim == wanted && match(score, /[0-9]+/)) {
|
|
156
|
-
print substr(score, RSTART, RLENGTH)
|
|
157
|
-
exit
|
|
158
|
-
}
|
|
159
|
-
}
|
|
160
|
-
' "$review_file"
|
|
161
|
-
}
|
|
162
|
-
|
|
163
115
|
update_contract_status() {
|
|
164
116
|
local file="$1"
|
|
165
117
|
local status="$2"
|
|
@@ -385,14 +337,9 @@ declare -a contain_patterns=()
|
|
|
385
337
|
declare -a files_not_exist=()
|
|
386
338
|
declare -a not_contain_paths=()
|
|
387
339
|
declare -a not_contain_patterns=()
|
|
388
|
-
declare -a qa_dimensions=()
|
|
389
|
-
declare -a qa_mins=()
|
|
390
|
-
declare -a manual_checks=()
|
|
391
340
|
|
|
392
341
|
section=""
|
|
393
342
|
pending_path=""
|
|
394
|
-
pending_dimension=""
|
|
395
|
-
review_file="$(read_contract_review_file "$contract_file" || true)"
|
|
396
343
|
task_profile="$(read_contract_task_profile "$contract_file" || true)"
|
|
397
344
|
declare -a allowed_paths=()
|
|
398
345
|
while IFS= read -r allowed_path; do
|
|
@@ -443,21 +390,10 @@ while IFS= read -r raw_line; do
|
|
|
443
390
|
pending_path=""
|
|
444
391
|
continue
|
|
445
392
|
;;
|
|
446
|
-
qa_scores:)
|
|
447
|
-
section="qa_scores"
|
|
448
|
-
pending_path=""
|
|
449
|
-
pending_dimension=""
|
|
450
|
-
continue
|
|
451
|
-
;;
|
|
452
|
-
manual_checks:)
|
|
453
|
-
section="manual_checks"
|
|
454
|
-
pending_path=""
|
|
455
|
-
continue
|
|
456
|
-
;;
|
|
457
393
|
esac
|
|
458
394
|
|
|
459
395
|
case "$section" in
|
|
460
|
-
files_exist|commands_succeed|files_not_exist|artifacts_exist
|
|
396
|
+
files_exist|commands_succeed|files_not_exist|artifacts_exist)
|
|
461
397
|
if [[ "$trimmed" =~ ^-[[:space:]]*(.+)$ ]]; then
|
|
462
398
|
item="$(strip_quotes "${BASH_REMATCH[1]}")"
|
|
463
399
|
[[ -n "$item" ]] || continue
|
|
@@ -467,8 +403,6 @@ while IFS= read -r raw_line; do
|
|
|
467
403
|
commands_succeed+=("$item")
|
|
468
404
|
elif [[ "$section" == "artifacts_exist" ]]; then
|
|
469
405
|
artifacts_exist+=("$item")
|
|
470
|
-
elif [[ "$section" == "manual_checks" ]]; then
|
|
471
|
-
manual_checks+=("$item")
|
|
472
406
|
else
|
|
473
407
|
files_not_exist+=("$item")
|
|
474
408
|
fi
|
|
@@ -497,19 +431,6 @@ while IFS= read -r raw_line; do
|
|
|
497
431
|
fi
|
|
498
432
|
fi
|
|
499
433
|
;;
|
|
500
|
-
qa_scores)
|
|
501
|
-
if [[ "$trimmed" =~ ^-[[:space:]]*dimension:[[:space:]]*(.+)$ ]]; then
|
|
502
|
-
pending_dimension="$(strip_quotes "${BASH_REMATCH[1]}")"
|
|
503
|
-
elif [[ "$trimmed" =~ ^dimension:[[:space:]]*(.+)$ ]]; then
|
|
504
|
-
pending_dimension="$(strip_quotes "${BASH_REMATCH[1]}")"
|
|
505
|
-
elif [[ "$trimmed" =~ ^min:[[:space:]]*([0-9]+)$ ]]; then
|
|
506
|
-
if [[ -n "$pending_dimension" ]]; then
|
|
507
|
-
qa_dimensions+=("$pending_dimension")
|
|
508
|
-
qa_mins+=("${BASH_REMATCH[1]}")
|
|
509
|
-
pending_dimension=""
|
|
510
|
-
fi
|
|
511
|
-
fi
|
|
512
|
-
;;
|
|
513
434
|
esac
|
|
514
435
|
done <<< "$yaml_block"
|
|
515
436
|
if ((${#tests_pass[@]} || ${#commands_succeed[@]})); then
|
|
@@ -602,37 +523,6 @@ if ((${#commands_succeed[@]})); then
|
|
|
602
523
|
done
|
|
603
524
|
fi
|
|
604
525
|
|
|
605
|
-
if ((${#qa_dimensions[@]})); then
|
|
606
|
-
for idx in "${!qa_dimensions[@]}"; do
|
|
607
|
-
dimension="${qa_dimensions[$idx]}"
|
|
608
|
-
min_score="${qa_mins[$idx]}"
|
|
609
|
-
score="$(review_score "$review_file" "$dimension" || true)"
|
|
610
|
-
|
|
611
|
-
if [[ "$score" =~ ^[0-9]+$ && "$score" -ge "$min_score" ]]; then
|
|
612
|
-
pass "qa_scores" "$dimension" "qa_scores: $dimension ${score}/${min_score}"
|
|
613
|
-
else
|
|
614
|
-
fail "qa_scores" "$dimension" "qa_scores: $dimension score ${score:-missing} < $min_score"
|
|
615
|
-
fi
|
|
616
|
-
done
|
|
617
|
-
fi
|
|
618
|
-
|
|
619
|
-
if ((${#manual_checks[@]})); then
|
|
620
|
-
for check in "${manual_checks[@]}"; do
|
|
621
|
-
case "$check" in
|
|
622
|
-
"Evaluator review file recommends pass")
|
|
623
|
-
if review_recommends_pass "$review_file"; then
|
|
624
|
-
pass "manual_checks" "$check" "manual_checks: $check"
|
|
625
|
-
else
|
|
626
|
-
fail "manual_checks" "$check" "manual_checks: $check"
|
|
627
|
-
fi
|
|
628
|
-
;;
|
|
629
|
-
*)
|
|
630
|
-
fail "manual_checks" "$check" "manual_checks unsupported: $check"
|
|
631
|
-
;;
|
|
632
|
-
esac
|
|
633
|
-
done
|
|
634
|
-
fi
|
|
635
|
-
|
|
636
526
|
if ((${#contain_paths[@]})); then
|
|
637
527
|
for idx in "${!contain_paths[@]}"; do
|
|
638
528
|
path="${contain_paths[$idx]}"
|
|
@@ -20,54 +20,6 @@ json_escape() {
|
|
|
20
20
|
printf '%s' "$value"
|
|
21
21
|
}
|
|
22
22
|
|
|
23
|
-
review_card_field() {
|
|
24
|
-
local file="$1"
|
|
25
|
-
local label="$2"
|
|
26
|
-
[[ -n "$file" && -f "$file" ]] || return 1
|
|
27
|
-
awk -v wanted="$label" '
|
|
28
|
-
function trim(s) {
|
|
29
|
-
gsub(/^[[:space:]]+/, "", s)
|
|
30
|
-
gsub(/[[:space:]]+$/, "", s)
|
|
31
|
-
return s
|
|
32
|
-
}
|
|
33
|
-
BEGIN { wanted = tolower(wanted) }
|
|
34
|
-
/^##[[:space:]]+Human Review Card[[:space:]]*$/ { in_section = 1; next }
|
|
35
|
-
in_section && /^##[[:space:]]+/ { exit }
|
|
36
|
-
!in_section { next }
|
|
37
|
-
/^[[:space:]]*-[[:space:]]*/ {
|
|
38
|
-
line = $0
|
|
39
|
-
sub(/^[[:space:]]*-[[:space:]]*/, "", line)
|
|
40
|
-
key = line
|
|
41
|
-
sub(/:.*/, "", key)
|
|
42
|
-
key = tolower(trim(key))
|
|
43
|
-
if (key == wanted) {
|
|
44
|
-
sub(/^[^:]*:[[:space:]]*/, "", line)
|
|
45
|
-
print trim(line)
|
|
46
|
-
exit
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
' "$file"
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
normalize_status_token() {
|
|
53
|
-
local value="$1"
|
|
54
|
-
value="$(printf '%s' "$value" | sed -E 's/[;,].*$//; s/[[:space:]].*$//; s/^[[:space:]]+//; s/[[:space:]]+$//' | tr '[:upper:]' '[:lower:]')"
|
|
55
|
-
printf '%s' "$value"
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
field_has_concrete_value() {
|
|
59
|
-
local value="$1"
|
|
60
|
-
local token
|
|
61
|
-
token="$(normalize_status_token "$value")"
|
|
62
|
-
[[ -n "$token" ]] || return 1
|
|
63
|
-
case "$token" in
|
|
64
|
-
tbd|todo|n/a|na|none|unknown|unavailable|pending|...)
|
|
65
|
-
return 1
|
|
66
|
-
;;
|
|
67
|
-
esac
|
|
68
|
-
return 0
|
|
69
|
-
}
|
|
70
|
-
|
|
71
23
|
read_contract_task_profile() {
|
|
72
24
|
local file="$1"
|
|
73
25
|
awk '/^> \*\*Task Profile\*\*:/ {sub(/^.*> \*\*Task Profile\*\*:[[:space:]]*/, ""); gsub(/\r/, ""); print; exit}' "$file" | xargs
|
|
@@ -304,25 +256,14 @@ if [[ -f ".ai/hooks/lib/workflow-state.sh" ]]; then
|
|
|
304
256
|
# shellcheck source=/dev/null
|
|
305
257
|
. ".ai/hooks/lib/workflow-state.sh"
|
|
306
258
|
contract_file="$(workflow_active_contract || true)"
|
|
307
|
-
review_file="$(workflow_active_review || true)"
|
|
308
259
|
checks_file="$(workflow_checks_file)"
|
|
309
260
|
else
|
|
310
261
|
contract_file="$(find tasks/contracts -maxdepth 1 -name '*.contract.md' -type f 2>/dev/null | sort | head -n 1)"
|
|
311
|
-
if [[ -n "$contract_file" ]]; then
|
|
312
|
-
contract_slug="$(basename "$contract_file" | sed -E 's/\.contract\.md$//')"
|
|
313
|
-
review_file="tasks/reviews/${contract_slug}.review.md"
|
|
314
|
-
else
|
|
315
|
-
review_file=""
|
|
316
|
-
fi
|
|
317
262
|
checks_file=".ai/harness/checks/latest.json"
|
|
318
263
|
fi
|
|
319
264
|
if [[ -z "$contract_file" || ! -f "$contract_file" ]]; then
|
|
320
265
|
contract_file="$(active_plan_declared_path "Task Contract" || active_plan_declared_path "Sprint Contract" || true)"
|
|
321
266
|
fi
|
|
322
|
-
if [[ -z "$review_file" || ! -f "$review_file" ]]; then
|
|
323
|
-
review_file="$(active_plan_declared_path "Task Review" || active_plan_declared_path "Sprint Review" || true)"
|
|
324
|
-
fi
|
|
325
|
-
|
|
326
267
|
[[ -n "$contract_file" && -f "$contract_file" ]] || { echo "No active sprint contract found" >&2; exit 1; }
|
|
327
268
|
|
|
328
269
|
generated_at="$(date '+%Y-%m-%dT%H:%M:%S%z')"
|
|
@@ -378,74 +319,9 @@ if [[ -n "$contract_output" ]]; then
|
|
|
378
319
|
printf '%s\n' "$contract_output"
|
|
379
320
|
fi
|
|
380
321
|
|
|
381
|
-
review_status="fail"
|
|
382
|
-
review_message="Task review recommends pass and Human Review Card verdict is pass."
|
|
383
|
-
review_card_verdict=""
|
|
384
|
-
review_card_external=""
|
|
385
|
-
review_card_change_type=""
|
|
386
|
-
review_card_rollback=""
|
|
387
|
-
if [[ -z "$review_file" || ! -f "$review_file" ]]; then
|
|
388
|
-
review_message="Missing task review file."
|
|
389
|
-
echo "Missing task review file" >&2
|
|
390
|
-
else
|
|
391
|
-
review_card_verdict="$(normalize_status_token "$(review_card_field "$review_file" "Verdict" || true)")"
|
|
392
|
-
review_card_external="$(review_card_field "$review_file" "External acceptance" || true)"
|
|
393
|
-
review_card_change_type="$(normalize_status_token "$(review_card_field "$review_file" "Change type" || true)")"
|
|
394
|
-
review_card_rollback="$(review_card_field "$review_file" "Rollback" || true)"
|
|
395
|
-
fi
|
|
396
|
-
|
|
397
|
-
if [[ -n "$review_file" && -f "$review_file" ]]; then
|
|
398
|
-
if ! grep -Eq '^> \*\*Recommendation\*\*:[[:space:]]*pass([[:space:]]*)$' "$review_file"; then
|
|
399
|
-
review_message="Task review does not recommend pass."
|
|
400
|
-
echo "Task review does not recommend pass" >&2
|
|
401
|
-
elif [[ -z "$review_card_verdict" ]]; then
|
|
402
|
-
review_message="Task review is missing Human Review Card verdict."
|
|
403
|
-
echo "Task review is missing Human Review Card verdict" >&2
|
|
404
|
-
elif [[ "$review_card_verdict" != "pass" ]]; then
|
|
405
|
-
review_message="Human Review Card verdict is not pass: $review_card_verdict"
|
|
406
|
-
echo "Human Review Card verdict is not pass: $review_card_verdict" >&2
|
|
407
|
-
elif [[ -n "$task_profile" && "$review_card_change_type" != "$task_profile" ]]; then
|
|
408
|
-
review_message="Human Review Card change type does not match task_profile: ${review_card_change_type:-missing} != $task_profile"
|
|
409
|
-
echo "$review_message" >&2
|
|
410
|
-
elif ! field_has_concrete_value "$review_card_rollback"; then
|
|
411
|
-
review_message="Human Review Card rollback is missing or not concrete."
|
|
412
|
-
echo "$review_message" >&2
|
|
413
|
-
else
|
|
414
|
-
review_status="pass"
|
|
415
|
-
fi
|
|
416
|
-
fi
|
|
417
|
-
|
|
418
|
-
external_status="missing"
|
|
419
|
-
external_reviewer=""
|
|
420
|
-
external_source=""
|
|
421
|
-
external_message="External acceptance status is unavailable."
|
|
422
|
-
if declare -F workflow_external_acceptance_status >/dev/null 2>&1; then
|
|
423
|
-
external_row="$(workflow_external_acceptance_status "$review_file")"
|
|
424
|
-
IFS=$'\t' read -r external_status external_reviewer external_source external_message <<< "$external_row"
|
|
425
|
-
fi
|
|
426
|
-
card_external_status="$(normalize_status_token "$review_card_external")"
|
|
427
|
-
case "$external_status" in
|
|
428
|
-
missing|unavailable|"")
|
|
429
|
-
case "$card_external_status" in
|
|
430
|
-
pass|manual_override|not_required)
|
|
431
|
-
external_status="$card_external_status"
|
|
432
|
-
external_message="Human Review Card external acceptance: $review_card_external"
|
|
433
|
-
;;
|
|
434
|
-
esac
|
|
435
|
-
;;
|
|
436
|
-
esac
|
|
437
|
-
|
|
438
322
|
status="fail"
|
|
439
323
|
exit_code=1
|
|
440
|
-
|
|
441
|
-
pass|manual_override|not_required)
|
|
442
|
-
external_gate="pass"
|
|
443
|
-
;;
|
|
444
|
-
*)
|
|
445
|
-
external_gate="fail"
|
|
446
|
-
;;
|
|
447
|
-
esac
|
|
448
|
-
if [[ "$contract_exit" -eq 0 && "$review_status" == "pass" && "$external_gate" == "pass" && "$allowed_paths_status" == "pass" ]]; then
|
|
324
|
+
if [[ "$contract_exit" -eq 0 && "$allowed_paths_status" == "pass" ]]; then
|
|
449
325
|
status="pass"
|
|
450
326
|
exit_code=0
|
|
451
327
|
fi
|
|
@@ -456,10 +332,6 @@ fi
|
|
|
456
332
|
if [[ -z "$failure_class" && "$status" != "pass" ]]; then
|
|
457
333
|
if [[ "$contract_exit" -ne 0 ]]; then
|
|
458
334
|
failure_class="contract"
|
|
459
|
-
elif [[ "$review_status" != "pass" ]]; then
|
|
460
|
-
failure_class="review"
|
|
461
|
-
elif [[ "$external_gate" != "pass" ]]; then
|
|
462
|
-
failure_class="external_acceptance"
|
|
463
335
|
elif [[ "$allowed_paths_status" != "pass" ]]; then
|
|
464
336
|
failure_class="allowed_paths"
|
|
465
337
|
else
|
|
@@ -467,9 +339,9 @@ if [[ -z "$failure_class" && "$status" != "pass" ]]; then
|
|
|
467
339
|
fi
|
|
468
340
|
fi
|
|
469
341
|
if [[ "$status" == "pass" ]]; then
|
|
470
|
-
next_step="finish contract worktree or archive completed task"
|
|
342
|
+
next_step="perform a fresh semantic impact review, then finish contract worktree or archive completed task"
|
|
471
343
|
else
|
|
472
|
-
next_step="resolve failing contract
|
|
344
|
+
next_step="resolve failing contract or allowed_paths evidence"
|
|
473
345
|
fi
|
|
474
346
|
handoff_current_exists=false
|
|
475
347
|
handoff_resume_exists=false
|
|
@@ -492,17 +364,6 @@ if command -v jq >/dev/null 2>&1 && jq -e . "$contract_report" >/dev/null 2>&1;
|
|
|
492
364
|
--arg contract_status "$([[ "$contract_exit" -eq 0 ]] && printf pass || printf fail)" \
|
|
493
365
|
--arg contract_command "$contract_command" \
|
|
494
366
|
--argjson contract_exit "$contract_exit" \
|
|
495
|
-
--arg review_file "${review_file:-}" \
|
|
496
|
-
--arg review_status "$review_status" \
|
|
497
|
-
--arg review_message "$review_message" \
|
|
498
|
-
--arg review_card_verdict "$review_card_verdict" \
|
|
499
|
-
--arg review_card_change_type "$review_card_change_type" \
|
|
500
|
-
--arg review_card_external "$review_card_external" \
|
|
501
|
-
--arg review_card_rollback "$review_card_rollback" \
|
|
502
|
-
--arg external_status "$external_status" \
|
|
503
|
-
--arg external_reviewer "$external_reviewer" \
|
|
504
|
-
--arg external_source "$external_source" \
|
|
505
|
-
--arg external_message "$external_message" \
|
|
506
367
|
--arg worktree "$worktree_path" \
|
|
507
368
|
--arg branch "$branch_name" \
|
|
508
369
|
--arg diff_base_ref "$diff_base_ref" \
|
|
@@ -538,8 +399,6 @@ if command -v jq >/dev/null 2>&1 && jq -e . "$contract_report" >/dev/null 2>&1;
|
|
|
538
399
|
],
|
|
539
400
|
guards: [
|
|
540
401
|
{name: "contract", status: $contract_status},
|
|
541
|
-
{name: "review", status: $review_status},
|
|
542
|
-
{name: "external_acceptance", status: $external_status},
|
|
543
402
|
{name: "allowed_paths", status: ($allowed_paths_check.status // "unavailable")}
|
|
544
403
|
],
|
|
545
404
|
handoffs: [
|
|
@@ -563,23 +422,6 @@ if command -v jq >/dev/null 2>&1 && jq -e . "$contract_report" >/dev/null 2>&1;
|
|
|
563
422
|
report: ($contract_report[0] // {}),
|
|
564
423
|
task_profile: $task_profile,
|
|
565
424
|
allowed_paths: $allowed_paths
|
|
566
|
-
},
|
|
567
|
-
review: {
|
|
568
|
-
file: $review_file,
|
|
569
|
-
status: $review_status,
|
|
570
|
-
message: $review_message,
|
|
571
|
-
card: {
|
|
572
|
-
verdict: $review_card_verdict,
|
|
573
|
-
change_type: $review_card_change_type,
|
|
574
|
-
external_acceptance: $review_card_external,
|
|
575
|
-
rollback: $review_card_rollback
|
|
576
|
-
}
|
|
577
|
-
},
|
|
578
|
-
external_acceptance: {
|
|
579
|
-
status: $external_status,
|
|
580
|
-
reviewer: $external_reviewer,
|
|
581
|
-
source: $external_source,
|
|
582
|
-
message: $external_message
|
|
583
425
|
}
|
|
584
426
|
}' > "$checks_report"
|
|
585
427
|
else
|
|
@@ -617,8 +459,6 @@ else
|
|
|
617
459
|
],
|
|
618
460
|
"guards": [
|
|
619
461
|
{"name": "contract", "status": "$([[ "$contract_exit" -eq 0 ]] && printf pass || printf fail)"},
|
|
620
|
-
{"name": "review", "status": "$(json_escape "$review_status")"},
|
|
621
|
-
{"name": "external_acceptance", "status": "$(json_escape "$external_status")"},
|
|
622
462
|
{"name": "allowed_paths", "status": "$(json_escape "$allowed_paths_status")"}
|
|
623
463
|
],
|
|
624
464
|
"handoffs": [
|
|
@@ -644,23 +484,6 @@ else
|
|
|
644
484
|
"exit_code": $contract_exit,
|
|
645
485
|
"task_profile": "$(json_escape "$task_profile")",
|
|
646
486
|
"allowed_paths": []
|
|
647
|
-
},
|
|
648
|
-
"review": {
|
|
649
|
-
"file": "$(json_escape "${review_file:-}")",
|
|
650
|
-
"status": "$(json_escape "$review_status")",
|
|
651
|
-
"message": "$(json_escape "$review_message")",
|
|
652
|
-
"card": {
|
|
653
|
-
"verdict": "$(json_escape "$review_card_verdict")",
|
|
654
|
-
"change_type": "$(json_escape "$review_card_change_type")",
|
|
655
|
-
"external_acceptance": "$(json_escape "$review_card_external")",
|
|
656
|
-
"rollback": "$(json_escape "$review_card_rollback")"
|
|
657
|
-
}
|
|
658
|
-
},
|
|
659
|
-
"external_acceptance": {
|
|
660
|
-
"status": "$(json_escape "$external_status")",
|
|
661
|
-
"reviewer": "$(json_escape "$external_reviewer")",
|
|
662
|
-
"source": "$(json_escape "$external_source")",
|
|
663
|
-
"message": "$(json_escape "$external_message")"
|
|
664
487
|
}
|
|
665
488
|
}
|
|
666
489
|
EOF_CHECKS
|
|
@@ -65,6 +65,10 @@ export type WorkflowContract = {
|
|
|
65
65
|
helpers: {
|
|
66
66
|
runtimeDirectory?: string;
|
|
67
67
|
compatibilityDirectory?: string;
|
|
68
|
+
/** Legacy manifest field retained for installed contract compatibility. */
|
|
69
|
+
dir?: string;
|
|
70
|
+
/** Legacy runtime-source discriminator still present in v1 manifests. */
|
|
71
|
+
runtimeSource?: string;
|
|
68
72
|
scripts: string[];
|
|
69
73
|
};
|
|
70
74
|
artifacts: {
|
|
@@ -185,7 +189,7 @@ export function getHelperScripts(contract: WorkflowContract): string[] {
|
|
|
185
189
|
}
|
|
186
190
|
|
|
187
191
|
export function getHelperRuntimeDir(contract: WorkflowContract): string {
|
|
188
|
-
return contract.helpers.dir ?? "scripts";
|
|
192
|
+
return contract.helpers.runtimeDirectory ?? contract.helpers.dir ?? contract.helpers.compatibilityDirectory ?? "scripts";
|
|
189
193
|
}
|
|
190
194
|
|
|
191
195
|
export function getRequiredDirectories(contract: WorkflowContract): string[] {
|
|
@@ -6,19 +6,15 @@
|
|
|
6
6
|
> **Notes File**: {{NOTES_FILE}}
|
|
7
7
|
> **Checks File**: {{CHECKS_FILE}}
|
|
8
8
|
> **Last Updated**: {{TIMESTAMP}}
|
|
9
|
-
> **
|
|
9
|
+
> **Summary**:
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Semantic Impact Review
|
|
12
12
|
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
- External acceptance: unavailable
|
|
19
|
-
- Residual risks:
|
|
20
|
-
- Reviewer action required: inspect diff and card
|
|
21
|
-
- Rollback:
|
|
13
|
+
- User intent:
|
|
14
|
+
- Affected domains and downstream consumers:
|
|
15
|
+
- State transitions and persistence/restart impact:
|
|
16
|
+
- Missing impact areas or uncertainty:
|
|
17
|
+
- Residual risks and recovery:
|
|
22
18
|
|
|
23
19
|
## Mode Evidence
|
|
24
20
|
|
|
@@ -28,26 +24,14 @@
|
|
|
28
24
|
|
|
29
25
|
## Verification Evidence
|
|
30
26
|
|
|
31
|
-
-
|
|
27
|
+
- Focused/full checks:
|
|
32
28
|
- Commands run:
|
|
33
29
|
- Manual checks:
|
|
34
30
|
- Supporting artifacts:
|
|
35
31
|
- Implementation notes reviewed:
|
|
36
32
|
- Run snapshot:
|
|
37
33
|
|
|
38
|
-
##
|
|
39
|
-
|
|
40
|
-
> **External Acceptance**: unavailable
|
|
41
|
-
> **External Reviewer**:
|
|
42
|
-
> **External Source**:
|
|
43
|
-
> **External Started**:
|
|
44
|
-
> **External Completed**:
|
|
45
|
-
|
|
46
|
-
- P1 blockers:
|
|
47
|
-
- P2 advisories:
|
|
48
|
-
- Acceptance checklist:
|
|
49
|
-
|
|
50
|
-
## Behavior Diff Notes
|
|
34
|
+
## Scenario Evidence
|
|
51
35
|
|
|
52
36
|
- ...
|
|
53
37
|
|
|
@@ -55,15 +39,6 @@
|
|
|
55
39
|
|
|
56
40
|
- ...
|
|
57
41
|
|
|
58
|
-
## Scorecard
|
|
59
|
-
|
|
60
|
-
| Dimension | Score | Notes |
|
|
61
|
-
|-----------|-------|-------|
|
|
62
|
-
| Functionality | 0/10 | |
|
|
63
|
-
| Product depth | 0/10 | |
|
|
64
|
-
| Design quality | 0/10 | |
|
|
65
|
-
| Code quality | 0/10 | |
|
|
66
|
-
|
|
67
42
|
## Failing Items
|
|
68
43
|
|
|
69
44
|
- ...
|
|
@@ -99,7 +99,6 @@
|
|
|
99
99
|
"verify-contract.sh",
|
|
100
100
|
"summarize-failures.sh",
|
|
101
101
|
"verify-sprint.sh",
|
|
102
|
-
"harness-trace-grade.sh",
|
|
103
102
|
"sprint-backlog.sh",
|
|
104
103
|
"check-task-sync.sh",
|
|
105
104
|
"check-deploy-sql-order.sh",
|
|
@@ -112,8 +111,6 @@
|
|
|
112
111
|
"select-agent-context-blocks.sh",
|
|
113
112
|
"ensure-task-workflow.sh",
|
|
114
113
|
"check-task-workflow.sh",
|
|
115
|
-
"maintenance-triage.sh",
|
|
116
|
-
"heartbeat-triage.sh",
|
|
117
114
|
"switch-plan.sh",
|
|
118
115
|
"workflow-contract.ts",
|
|
119
116
|
"inspect-project-state.ts",
|
|
@@ -164,7 +161,6 @@
|
|
|
164
161
|
".ai/harness/local-jobs",
|
|
165
162
|
".ai/harness/controller",
|
|
166
163
|
".ai/harness/edit-sessions",
|
|
167
|
-
".ai/harness/triage",
|
|
168
164
|
"docs/architecture",
|
|
169
165
|
"docs/architecture/domains",
|
|
170
166
|
"docs/architecture/modules",
|
|
@@ -204,7 +200,6 @@
|
|
|
204
200
|
"scripts/verify-contract.sh",
|
|
205
201
|
"scripts/summarize-failures.sh",
|
|
206
202
|
"scripts/verify-sprint.sh",
|
|
207
|
-
"scripts/harness-trace-grade.sh",
|
|
208
203
|
"scripts/sprint-backlog.sh",
|
|
209
204
|
"scripts/check-task-sync.sh",
|
|
210
205
|
"scripts/check-deploy-sql-order.sh",
|
|
@@ -216,8 +211,6 @@
|
|
|
216
211
|
"scripts/select-agent-context-blocks.sh",
|
|
217
212
|
"scripts/ensure-task-workflow.sh",
|
|
218
213
|
"scripts/check-task-workflow.sh",
|
|
219
|
-
"scripts/maintenance-triage.sh",
|
|
220
|
-
"scripts/heartbeat-triage.sh",
|
|
221
214
|
"scripts/switch-plan.sh",
|
|
222
215
|
"scripts/workflow-contract.ts",
|
|
223
216
|
"scripts/inspect-project-state.ts",
|
|
@@ -246,7 +239,6 @@
|
|
|
246
239
|
"docs/reference-configs/agentic-development-flow.md",
|
|
247
240
|
"docs/reference-configs/external-tooling.md",
|
|
248
241
|
"docs/reference-configs/sprint-contracts.md",
|
|
249
|
-
"docs/reference-configs/heartbeat-triage.md",
|
|
250
242
|
"docs/reference-configs/handoff-protocol.md",
|
|
251
243
|
"docs/reference-configs/document-generation.md",
|
|
252
244
|
"docs/reference-configs/global-working-rules.md",
|
|
@@ -271,9 +263,7 @@
|
|
|
271
263
|
".ai/harness/worktrees/",
|
|
272
264
|
".ai/harness/runs/.gitkeep",
|
|
273
265
|
".ai/harness/local-jobs/",
|
|
274
|
-
".ai/harness/controller/"
|
|
275
|
-
".ai/harness/triage/.gitkeep",
|
|
276
|
-
".ai/harness/triage/inbox.md"
|
|
266
|
+
".ai/harness/controller/"
|
|
277
267
|
]
|
|
278
268
|
},
|
|
279
269
|
"documents": {
|
|
@@ -519,15 +509,16 @@
|
|
|
519
509
|
"scripts/check-context-files.sh",
|
|
520
510
|
"scripts/check-deploy-sql-order.sh",
|
|
521
511
|
"scripts/check-skill-version.ts",
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
512
|
+
"scripts/check-task-sync.sh",
|
|
513
|
+
"scripts/check-task-workflow.sh",
|
|
514
|
+
"scripts/harness-trace-grade.sh",
|
|
515
|
+
"scripts/codex-handoff-resume.sh",
|
|
525
516
|
"scripts/context-contract-sync.sh",
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
517
|
+
"scripts/contract-run.ts",
|
|
518
|
+
"scripts/contract-worktree.sh",
|
|
519
|
+
"scripts/ensure-task-workflow.sh",
|
|
520
|
+
"scripts/heartbeat-triage.sh",
|
|
521
|
+
"scripts/inspect-project-state.ts",
|
|
531
522
|
"scripts/maintenance-triage.sh",
|
|
532
523
|
"scripts/migrate-project-template.sh",
|
|
533
524
|
"scripts/migrate-workflow-docs.ts",
|