@moretea-labs/forge 1.5.0-rc.1 → 1.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (264) hide show
  1. package/AGENTS.md +9 -11
  2. package/CHANGELOG.md +27 -1
  3. package/CLAUDE.md +8 -10
  4. package/DESIGN.md +278 -0
  5. package/README.md +70 -90
  6. package/README.zh-CN.md +52 -55
  7. package/SKILL.md +8 -11
  8. package/THIRD_PARTY_NOTICES.md +9 -3
  9. package/assets/branding/README.md +4 -2
  10. package/assets/hooks/lib/workflow-state.sh +19 -18
  11. package/assets/hooks/post-edit-guard.sh +6 -75
  12. package/assets/hooks/prompt-guard.sh +24 -12
  13. package/assets/hooks/session-start-context.sh +17 -17
  14. package/assets/hooks/stop-orchestrator.sh +2 -2
  15. package/assets/partials/04-project-structure.partial.md +6 -6
  16. package/assets/partials/05-workflow.partial.md +6 -6
  17. package/assets/partials/07-footer.partial.md +1 -1
  18. package/assets/partials/08-orchestration.partial.md +2 -2
  19. package/assets/partials-agents/02-operating-mode.partial.md +5 -5
  20. package/assets/partials-agents/03-orchestration.partial.md +3 -3
  21. package/assets/partials-agents/04-task-protocol.partial.md +3 -3
  22. package/assets/partials-agents/08-deep-docs.partial.md +1 -1
  23. package/assets/reference-configs/agentic-development-flow.md +49 -86
  24. package/assets/reference-configs/external-tooling.md +21 -61
  25. package/assets/reference-configs/handoff-protocol.md +25 -20
  26. package/assets/reference-configs/harness-overview.md +8 -8
  27. package/assets/skill-version.json +2 -2
  28. package/assets/templates/helpers/archive-workflow.sh +0 -1
  29. package/assets/templates/helpers/capture-plan.sh +3 -3
  30. package/assets/templates/helpers/check-task-workflow.sh +2 -2
  31. package/assets/templates/helpers/codex-handoff-resume.sh +5 -5
  32. package/assets/templates/helpers/ensure-task-workflow.sh +37 -35
  33. package/assets/templates/helpers/new-plan.sh +1 -1
  34. package/assets/templates/helpers/plan-to-todo.sh +2 -2
  35. package/assets/templates/helpers/prepare-codex-handoff.sh +2 -2
  36. package/assets/templates/helpers/prepare-handoff.sh +9 -9
  37. package/assets/templates/helpers/refresh-current-status.sh +2 -2
  38. package/assets/templates/helpers/ship-worktrees.sh +1 -1
  39. package/assets/templates/helpers/sprint-backlog.sh +1 -1
  40. package/assets/templates/helpers/verify-sprint.sh +7 -7
  41. package/assets/templates/helpers/workstream-sync.sh +1 -1
  42. package/assets/templates/plan.template.md +1 -1
  43. package/assets/workflow-contract.v1.json +6 -3
  44. package/docs/architecture/current/README.md +10 -9
  45. package/docs/architecture/current/approved-target-architecture.zh-CN.md +2 -2
  46. package/docs/architecture/current/architecture-invariants.md +2 -2
  47. package/docs/architecture/current/automation-and-schedule-engine.md +15 -15
  48. package/docs/architecture/current/codegraph-context-provider.md +2 -2
  49. package/docs/architecture/current/control-plane-authority-inventory.md +12 -0
  50. package/docs/architecture/current/dispatch-and-agent-strategy.md +11 -11
  51. package/docs/architecture/current/entity-model.md +0 -27
  52. package/docs/architecture/current/failure-recovery.md +0 -24
  53. package/docs/architecture/current/governance.md +1 -1
  54. package/docs/architecture/current/implementation-status.md +1 -1
  55. package/docs/architecture/current/legacy-governance.md +58 -0
  56. package/docs/architecture/current/multi-repository-execution.md +1 -1
  57. package/docs/architecture/current/peer-supercontroller-runtime.md +1 -1
  58. package/docs/architecture/current/personal-assistant-plugin-baseline.md +4 -5
  59. package/docs/architecture/current/scheduler-and-resource-claims.md +0 -10
  60. package/docs/architecture/current/target-requirements-traceability.md +2 -2
  61. package/docs/architecture/current/thin-harness-governance-policy.md +1 -1
  62. package/docs/architecture/current/thin-harness-v1.md +9 -11
  63. package/docs/architecture/domains/runtime-harness.md +1 -1
  64. package/docs/forge-autonomous-goal-loop.md +3 -1
  65. package/docs/forge-chatgpt-mcp-setup.md +67 -176
  66. package/docs/images/forge-banner-cn.svg +26 -1
  67. package/docs/images/forge-banner.svg +26 -1
  68. package/docs/operations/features.md +1 -1
  69. package/docs/operations/homebrew.md +3 -3
  70. package/docs/operations/mcp-tool-exposure.md +5 -5
  71. package/docs/operations/platform-support.md +45 -37
  72. package/docs/operations/platform-support.zh-CN.md +40 -38
  73. package/docs/operations/releasing.md +3 -3
  74. package/docs/operations/releasing.zh-CN.md +3 -3
  75. package/docs/operations/troubleshooting.md +11 -6
  76. package/docs/operations/troubleshooting.zh-CN.md +11 -6
  77. package/docs/public-usage-guide.md +28 -21
  78. package/docs/public-usage-guide.zh-CN.md +28 -21
  79. package/docs/tutorials/01-install-and-start.md +58 -35
  80. package/docs/tutorials/01-install-and-start.zh-CN.md +58 -35
  81. package/docs/tutorials/02-connect-chatgpt.md +118 -46
  82. package/docs/tutorials/02-connect-chatgpt.zh-CN.md +119 -45
  83. package/docs/wiki/Architecture.md +1 -1
  84. package/docs/wiki/Installation.md +2 -2
  85. package/docs/wiki/Quick-Start.md +1 -1
  86. package/docs/wiki/Work-Lifecycle.md +1 -1
  87. package/install.ps1 +4 -5
  88. package/install.sh +4 -6
  89. package/package.json +15 -5
  90. package/scripts/archive-workflow.sh +0 -1
  91. package/scripts/benchmark-thin-harness-mcp-e2e.ts +27 -14
  92. package/scripts/build-controller-ui.ts +28 -0
  93. package/scripts/capture-plan.sh +4 -4
  94. package/scripts/check-agent-tooling.sh +12 -1
  95. package/scripts/check-platform-support.mjs +2 -2
  96. package/scripts/check-public-docs.sh +16 -5
  97. package/scripts/check-release-readiness.sh +5 -11
  98. package/scripts/check-runtime-architecture.mjs +14 -22
  99. package/scripts/check-tarball-install-smoke.sh +3 -2
  100. package/scripts/check-task-workflow.sh +2 -2
  101. package/scripts/codex-handoff-resume.sh +5 -5
  102. package/scripts/create-project-dirs.sh +3 -3
  103. package/scripts/ensure-task-workflow.sh +45 -35
  104. package/scripts/init-project.sh +4 -4
  105. package/scripts/install-desktop-operator-registration.ts +2 -2
  106. package/scripts/lib/project-init-lib.sh +46 -44
  107. package/scripts/migrate-project-template.sh +7 -4
  108. package/scripts/new-plan.sh +1 -1
  109. package/scripts/plan-to-todo.sh +2 -2
  110. package/scripts/prepare-codex-handoff.sh +2 -2
  111. package/scripts/prepare-handoff.sh +9 -9
  112. package/scripts/refresh-current-status.sh +2 -2
  113. package/scripts/setup-plugins.sh +3 -3
  114. package/scripts/ship-worktrees.sh +1 -1
  115. package/scripts/sprint-backlog.sh +5 -5
  116. package/scripts/sync-codex-installed-copies.sh +2 -3
  117. package/scripts/verify-sprint.sh +7 -7
  118. package/scripts/workstream-sync.sh +1 -1
  119. package/src/cli/chatgpt-browser/bridge-extension.ts +1 -1
  120. package/src/cli/chatgpt-browser/bridge-provider.ts +29 -0
  121. package/src/cli/chatgpt-browser/file-policy.ts +3 -1
  122. package/src/cli/commands/chatgpt.ts +51 -0
  123. package/src/cli/commands/doctor.ts +1 -1
  124. package/src/cli/commands/init-hook.ts +213 -70
  125. package/src/cli/commands/init.ts +5 -6
  126. package/src/cli/commands/mcp.ts +31 -5
  127. package/src/cli/commands/runtime.ts +61 -8
  128. package/src/cli/commands/setup-profile.ts +472 -0
  129. package/src/cli/controller/check-runner.ts +20 -3
  130. package/src/cli/controller/codex-continuation.ts +4 -7
  131. package/src/cli/controller/context-pack.ts +118 -14
  132. package/src/cli/controller/operational-plan.ts +4 -4
  133. package/src/cli/controller/task-ledger.ts +10 -10
  134. package/src/cli/controller/work-mode.ts +6 -13
  135. package/src/cli/index.ts +14 -35
  136. package/src/cli/local-bridge/connector-freshness.ts +1 -1
  137. package/src/cli/local-bridge/console-assets.ts +17 -0
  138. package/src/cli/local-bridge/console-automations.ts +160 -0
  139. package/src/cli/local-bridge/dashboard.ts +8 -1303
  140. package/src/cli/local-bridge/facade-api.ts +16 -7
  141. package/src/cli/local-bridge/frontend/src/App.tsx +10 -0
  142. package/src/cli/local-bridge/frontend/src/components/Button.tsx +1 -0
  143. package/src/cli/local-bridge/frontend/src/components/DetailPane.tsx +3 -0
  144. package/src/cli/local-bridge/frontend/src/components/SearchField.tsx +1 -0
  145. package/src/cli/local-bridge/frontend/src/components/SectionHeader.tsx +1 -0
  146. package/src/cli/local-bridge/frontend/src/components/Segmented.tsx +1 -0
  147. package/src/cli/local-bridge/frontend/src/components/StatusText.tsx +3 -0
  148. package/src/cli/local-bridge/frontend/src/design/icons.tsx +11 -0
  149. package/src/cli/local-bridge/frontend/src/design/tokens.css +8 -0
  150. package/src/cli/local-bridge/frontend/src/features/automations/AutomationsView.tsx +3 -0
  151. package/src/cli/local-bridge/frontend/src/features/capabilities/CapabilitiesView.tsx +4 -0
  152. package/src/cli/local-bridge/frontend/src/features/overview/OverviewView.tsx +3 -0
  153. package/src/cli/local-bridge/frontend/src/features/repositories/RepositoriesView.tsx +2 -0
  154. package/src/cli/local-bridge/frontend/src/features/settings/SettingsView.tsx +2 -0
  155. package/src/cli/local-bridge/frontend/src/features/system/SystemView.tsx +2 -0
  156. package/src/cli/local-bridge/frontend/src/features/work/WorkView.tsx +3 -0
  157. package/src/cli/local-bridge/frontend/src/lib/api.ts +23 -0
  158. package/src/cli/local-bridge/frontend/src/lib/format.ts +4 -0
  159. package/src/cli/local-bridge/frontend/src/lib/routes.ts +7 -0
  160. package/src/cli/local-bridge/frontend/src/main.tsx +1 -0
  161. package/src/cli/local-bridge/frontend/src/shell/AppShell.tsx +1 -0
  162. package/src/cli/local-bridge/frontend/src/shell/CommandBar.tsx +2 -0
  163. package/src/cli/local-bridge/frontend/src/shell/Sidebar.tsx +3 -0
  164. package/src/cli/local-bridge/frontend/src/styles.css +12 -0
  165. package/src/cli/local-bridge/frontend/src/types.ts +14 -0
  166. package/src/cli/local-bridge/frontend/src/vite-env.d.ts +1 -0
  167. package/src/cli/local-bridge/frontend/vite.config.ts +27 -0
  168. package/src/cli/local-bridge/server.ts +45 -0
  169. package/src/cli/local-bridge/ui-dist/app.css +1 -0
  170. package/src/cli/local-bridge/ui-dist/app.js +11094 -0
  171. package/src/cli/mcp/auth.ts +2 -0
  172. package/src/cli/mcp/instructions.ts +3 -3
  173. package/src/cli/mcp/legacy-tool-service.ts +27 -23
  174. package/src/cli/mcp/multi-repository.ts +2 -0
  175. package/src/cli/mcp/policy.ts +7 -5
  176. package/src/cli/mcp/repository-tools.ts +53 -14
  177. package/src/cli/mcp/server.ts +5 -10
  178. package/src/cli/mcp/setup.ts +220 -276
  179. package/src/cli/mcp/tool-capability-cache.ts +1 -1
  180. package/src/cli/mcp/toolset-names.ts +1 -1
  181. package/src/cli/mcp/toolset.ts +0 -1
  182. package/src/cli/mcp/transports/http.ts +51 -4
  183. package/src/cli/repositories/branch-name-policy.ts +0 -7
  184. package/src/cli/repositories/controller-home.ts +110 -3
  185. package/src/cli/repositories/safe-patch.ts +1 -1
  186. package/src/cli/repositories/selected-path-actions.ts +26 -24
  187. package/src/core/adoption/gitignore-plan.ts +2 -3
  188. package/src/core/adoption/plan.ts +4 -1
  189. package/src/runtime/control-plane/execution/edit-validation-coordinator.ts +556 -0
  190. package/src/runtime/control-plane/execution/work-handle-store.ts +128 -1
  191. package/src/runtime/control-plane/execution/work-validation-reconciler.ts +277 -0
  192. package/src/runtime/control-plane/execution/work-verification-snapshot.ts +169 -0
  193. package/src/runtime/control-plane/facade/capability-registry.ts +0 -10
  194. package/src/runtime/control-plane/facade/handoff-inbox-store.ts +44 -25
  195. package/src/runtime/control-plane/facade/suggested-actions.ts +7 -1
  196. package/src/runtime/control-plane/facade/types.ts +0 -1
  197. package/src/runtime/control-plane/global-scheduler/scheduler.ts +30 -8
  198. package/src/runtime/control-plane/launcher/chatgpt-work-binding-store.ts +114 -0
  199. package/src/runtime/control-plane/launcher/chatgpt-work-continuation.ts +175 -0
  200. package/src/runtime/control-plane/launcher/launch-reservation-store.ts +161 -0
  201. package/src/runtime/control-plane/launcher/provider-mcp-bootstrap.ts +64 -0
  202. package/src/runtime/control-plane/launcher/thin-launcher.ts +117 -24
  203. package/src/runtime/control-plane/routing/route-policy.ts +14 -14
  204. package/src/runtime/control-plane/runtime-cleanup.ts +0 -1
  205. package/src/runtime/evidence/event-ledger.ts +1 -1
  206. package/src/runtime/{workflow/campaigns/workspace.ts → execution/managed-workspace.ts} +41 -43
  207. package/src/runtime/execution/process-runtime/check-facade.ts +6 -0
  208. package/src/runtime/execution/process-runtime/check-result.ts +45 -0
  209. package/src/runtime/execution/process-runtime/check-runner-sidecar.ts +42 -16
  210. package/src/runtime/execution/process-runtime/command-facade.ts +4 -2
  211. package/src/runtime/execution/process-runtime/gc.ts +1 -1
  212. package/src/runtime/execution/process-runtime/index.ts +3 -0
  213. package/src/runtime/execution/process-runtime/interactive-admission.ts +14 -5
  214. package/src/runtime/execution/process-runtime/persisted-check.ts +285 -0
  215. package/src/runtime/execution/process-runtime/resource-claims.ts +30 -0
  216. package/src/runtime/execution/process-runtime/runtime.ts +18 -1
  217. package/src/runtime/execution/process-runtime/store.ts +1 -19
  218. package/src/runtime/execution/process-runtime/types.ts +4 -0
  219. package/src/runtime/execution/thin-harness/execution-router.ts +0 -1
  220. package/src/runtime/execution/thin-harness/fast-executor.ts +1 -1
  221. package/src/runtime/execution/thin-harness/lightweight-lanes.ts +1 -2
  222. package/src/runtime/execution/thin-harness/types.ts +0 -1
  223. package/src/runtime/execution/workers/executor.ts +1 -1
  224. package/src/runtime/gateway/mcp/execution-tools.ts +1 -1
  225. package/src/runtime/gateway/mcp/persisted-check-process.ts +3 -255
  226. package/src/runtime/gateway/mcp/process-tools.ts +16 -3
  227. package/src/runtime/gateway/mcp/resource-policy.ts +0 -9
  228. package/src/runtime/gateway/mcp/router.ts +117 -182
  229. package/src/runtime/gateway/mcp/runtime-tools.ts +331 -409
  230. package/src/runtime/gateway/mcp/work-validation-reconciler.ts +1 -219
  231. package/src/runtime/plugins/browser-adapter.ts +5 -0
  232. package/src/runtime/plugins/desktop-operator-registration.ts +1 -1
  233. package/src/runtime/plugins/store.ts +14 -6
  234. package/src/runtime/plugins/types.ts +1 -1
  235. package/src/runtime/projections/materialized-view.ts +1 -23
  236. package/src/runtime/recovery/maintenance-executor.ts +9 -0
  237. package/src/runtime/resources/ownership.ts +0 -1
  238. package/src/runtime/root/gateway-adapter.ts +2 -0
  239. package/src/runtime/root/mcp-transport.ts +10 -2
  240. package/src/runtime/root/package-connector-service.ts +136 -0
  241. package/src/runtime/root/package-runtime-release.ts +161 -0
  242. package/src/runtime/root/package-runtime-service.ts +185 -0
  243. package/src/runtime/root/release-materialize.ts +19 -0
  244. package/src/runtime/root/runtime.ts +2 -1
  245. package/src/runtime/root/scheduler.ts +5 -0
  246. package/src/runtime/root/service.ts +18 -5
  247. package/src/runtime/standalone-recovery/core.ts +65 -16
  248. package/src/runtime/workflow/findings/store.ts +145 -106
  249. package/src/runtime/workflow/findings/types.ts +22 -0
  250. package/src/runtime/workflow/schedules/engine.ts +132 -2
  251. package/src/runtime/workflow/schedules/pending-activation.ts +139 -0
  252. package/src/runtime/workflow/schedules/work-continuation.ts +218 -0
  253. package/docs/CHANGELOG.md +0 -978
  254. package/docs/README.zh-CN.md +0 -58
  255. package/scripts/smoke-chatgpt-supervised-automation.ts +0 -208
  256. package/src/cli/commands/controller.ts +0 -680
  257. package/src/runtime/workflow/campaigns/cleanup.ts +0 -263
  258. package/src/runtime/workflow/campaigns/engine.ts +0 -112
  259. package/src/runtime/workflow/campaigns/normalize.ts +0 -100
  260. package/src/runtime/workflow/campaigns/review.ts +0 -315
  261. package/src/runtime/workflow/campaigns/store.ts +0 -526
  262. package/src/runtime/workflow/campaigns/supervisor.ts +0 -112
  263. package/src/runtime/workflow/campaigns/types.ts +0 -290
  264. /package/src/runtime/{workflow/campaigns → execution}/workspace-agent.ts +0 -0
@@ -1,290 +0,0 @@
1
- import type { ExecutionJobPriority, ResourceClaimSpec } from '../../execution/jobs/types';
2
-
3
- export type CampaignStatus =
4
- | 'active'
5
- | 'waiting_for_supervisor'
6
- | 'paused'
7
- | 'ready_for_human_acceptance'
8
- | 'completed'
9
- | 'failed'
10
- | 'cancelling'
11
- | 'cancelled'
12
- | 'cancelled_with_leaks';
13
-
14
- export type CampaignTaskStatus =
15
- | 'pending'
16
- | 'queued'
17
- | 'running'
18
- | 'waiting_review'
19
- | 'changes_requested'
20
- | 'succeeded'
21
- | 'succeeded_no_change'
22
- | 'failed'
23
- | 'failed_no_effect'
24
- | 'blocked'
25
- | 'skipped'
26
- | 'cancelled';
27
-
28
- export type CampaignCheckpointKind = 'initial' | 'task_review' | 'failure' | 'scope_change' | 'final';
29
- export type CampaignCheckpointStatus = 'open' | 'submitted' | 'superseded';
30
- export type CampaignReviewPolicy = 'every_task' | 'failures_and_final' | 'final_only';
31
-
32
- export interface CampaignWorkspace {
33
- mode: 'current' | 'isolated';
34
- checkoutId?: string;
35
- root?: string;
36
- branch?: string | null;
37
- baseRevision?: string | null;
38
- managed: boolean;
39
- }
40
-
41
- export interface CampaignGoalRevision {
42
- revision: number;
43
- goalHash: string;
44
- statement: string;
45
- acceptanceCriteria: string[];
46
- nonGoals: string[];
47
- changedBy: string;
48
- changedAt: string;
49
- reason?: string;
50
- }
51
-
52
- export interface CampaignExecutorOptions {
53
- enableDevRunner?: boolean;
54
- enableChatgptBrowser?: boolean;
55
- allowedAgents?: string[];
56
- runnerTimeoutMs?: number;
57
- runnerMaxTimeoutMs?: number;
58
- }
59
-
60
- export interface CampaignTask {
61
- taskId: string;
62
- title: string;
63
- objective: string;
64
- operation: string;
65
- arguments?: Record<string, unknown>;
66
- dependsOn: string[];
67
- priority: ExecutionJobPriority;
68
- resourceClaims: ResourceClaimSpec[];
69
- reviewRequired: boolean;
70
- requiresChanges: boolean;
71
- maxAttempts: number;
72
- status: CampaignTaskStatus;
73
- attempt: number;
74
- jobId?: string;
75
- runId?: string;
76
- checkpointId?: string;
77
- nextAttemptAt?: string;
78
- startedAt?: string;
79
- executionFinishedAt?: string;
80
- completedAt?: string;
81
- supervisorInstructions?: string;
82
- error?: { code: string; message: string; retryable: boolean };
83
- evidenceIds: string[];
84
- outcome?: 'changed' | 'already_satisfied' | 'no_effect';
85
- executor?: CampaignExecutorOptions;
86
- }
87
-
88
- export interface CampaignReviewPacketTask {
89
- taskId: string;
90
- title: string;
91
- objective: string;
92
- status: CampaignTaskStatus;
93
- attempt: number;
94
- operation: string;
95
- jobId?: string;
96
- runId?: string;
97
- error?: CampaignTask['error'];
98
- evidenceIds: string[];
99
- }
100
-
101
- export interface CampaignReviewPacket {
102
- schemaVersion: 1;
103
- campaignId: string;
104
- checkpointId: string;
105
- checkpointKind: CampaignCheckpointKind;
106
- nonce: string;
107
- goalRevision: number;
108
- goalHash: string;
109
- title: string;
110
- goal: string;
111
- acceptanceCriteria: string[];
112
- nonGoals: string[];
113
- task?: CampaignReviewPacketTask;
114
- progress: {
115
- total: number;
116
- succeeded: number;
117
- running: number;
118
- waitingReview: number;
119
- failed: number;
120
- blocked: number;
121
- };
122
- recentEvidenceIds: string[];
123
- createdAt: string;
124
- maxResponseBytes: number;
125
- workspace?: Pick<CampaignWorkspace, 'mode' | 'checkoutId' | 'branch' | 'baseRevision' | 'managed'>;
126
- }
127
-
128
- export type CampaignSupervisorAction =
129
- | 'accept'
130
- | 'request_changes'
131
- | 'retry'
132
- | 'skip'
133
- | 'pause'
134
- | 'resume'
135
- | 'approve_final'
136
- | 'revise_goal'
137
- | 'escalate';
138
-
139
- export interface CampaignSupervisorDecision {
140
- action: CampaignSupervisorAction;
141
- summary: string;
142
- instructions?: string;
143
- revisedGoal?: {
144
- statement: string;
145
- acceptanceCriteria?: string[];
146
- nonGoals?: string[];
147
- reason?: string;
148
- };
149
- submittedBy: string;
150
- submittedAt: string;
151
- }
152
-
153
- export interface CampaignCheckpoint {
154
- checkpointId: string;
155
- kind: CampaignCheckpointKind;
156
- status: CampaignCheckpointStatus;
157
- nonce: string;
158
- goalRevision: number;
159
- taskId?: string;
160
- packet: CampaignReviewPacket;
161
- decision?: CampaignSupervisorDecision;
162
- triggerJobId?: string;
163
- triggerAttempts: number;
164
- nextTriggerAt?: string;
165
- triggeredAt?: string;
166
- triggerError?: string;
167
- createdAt: string;
168
- submittedAt?: string;
169
- }
170
-
171
- export interface CampaignBudget {
172
- maxParallelTasks: number;
173
- maxExecutionJobs: number;
174
- maxSupervisorReviews: number;
175
- defaultTaskMaxAttempts: number;
176
- taskTimeoutMs: number;
177
- retryBaseDelayMs: number;
178
- retryMaxDelayMs: number;
179
- reviewPacketMaxBytes: number;
180
- }
181
-
182
- export interface CampaignSupervisorConfig {
183
- mode: 'pull' | 'operation' | 'workspace_agent';
184
- operation?: string;
185
- workspaceAgentId?: string;
186
- conversationKey?: string;
187
- arguments?: Record<string, unknown>;
188
- priority?: ExecutionJobPriority;
189
- resourceClaims?: ResourceClaimSpec[];
190
- triggerCooldownMs: number;
191
- maxTriggerAttempts: number;
192
- decisionTimeoutMs: number;
193
- }
194
-
195
- export interface CampaignMutationReceipt {
196
- requestId: string;
197
- fingerprint: string;
198
- revision: number;
199
- appliedAt: string;
200
- }
201
-
202
- export interface CampaignCounters {
203
- executionJobsCreated: number;
204
- supervisorReviewsOpened: number;
205
- supervisorDecisionsAccepted: number;
206
- }
207
-
208
- export interface CampaignCleanupResource {
209
- kind: 'job' | 'checkpoint' | 'worktree' | 'branch' | 'checkout' | 'lease' | 'process';
210
- id: string;
211
- status: 'cleaned' | 'preserved' | 'missing' | 'failed';
212
- message?: string;
213
- }
214
-
215
- export interface CampaignCleanupReport {
216
- schemaVersion: 1;
217
- startedAt: string;
218
- finishedAt?: string;
219
- resources: CampaignCleanupResource[];
220
- leaks: string[];
221
- }
222
-
223
- export interface Campaign {
224
- schemaVersion: 1;
225
- revision: number;
226
- campaignId: string;
227
- repoId: string;
228
- checkoutId?: string;
229
- workspace: CampaignWorkspace;
230
- requestId: string;
231
- semanticKey: string;
232
- title: string;
233
- status: CampaignStatus;
234
- goals: CampaignGoalRevision[];
235
- tasks: CampaignTask[];
236
- checkpoints: CampaignCheckpoint[];
237
- budget: CampaignBudget;
238
- supervisor: CampaignSupervisorConfig;
239
- reviewPolicy: CampaignReviewPolicy;
240
- counters: CampaignCounters;
241
- mutationReceipts?: CampaignMutationReceipt[];
242
- pauseReason?: string;
243
- failureReason?: string;
244
- nextReconcileAt?: string;
245
- createdAt: string;
246
- updatedAt: string;
247
- completedAt?: string;
248
- completionOutcome?: 'changed' | 'already_satisfied';
249
- cleanup?: CampaignCleanupReport;
250
- }
251
-
252
- export interface CreateCampaignTaskInput {
253
- taskId: string;
254
- title: string;
255
- objective?: string;
256
- operation: string;
257
- arguments?: Record<string, unknown>;
258
- dependsOn?: string[];
259
- priority?: ExecutionJobPriority;
260
- resourceClaims?: ResourceClaimSpec[];
261
- reviewRequired?: boolean;
262
- requiresChanges?: boolean;
263
- maxAttempts?: number;
264
- executor?: CampaignExecutorOptions;
265
- }
266
-
267
- export interface CreateCampaignInput {
268
- repoId: string;
269
- checkoutId?: string;
270
- workspace?: CampaignWorkspace;
271
- requestId: string;
272
- semanticKey: string;
273
- title: string;
274
- goal: string;
275
- acceptanceCriteria?: string[];
276
- nonGoals?: string[];
277
- tasks: CreateCampaignTaskInput[];
278
- budget?: Partial<CampaignBudget>;
279
- supervisor?: Partial<CampaignSupervisorConfig>;
280
- reviewPolicy?: CampaignReviewPolicy;
281
- createdBy?: string;
282
- }
283
-
284
- export interface CampaignReconcileResult {
285
- campaignId: string;
286
- changed: boolean;
287
- dispatched: number;
288
- checkpointsOpened: number;
289
- status: CampaignStatus;
290
- }