macro-agent 0.1.8 → 0.1.10
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/CLAUDE.md +166 -33
- package/README.md +781 -131
- package/dist/acp/claude-code-replay.d.ts +11 -0
- package/dist/acp/claude-code-replay.d.ts.map +1 -0
- package/dist/acp/claude-code-replay.js +190 -0
- package/dist/acp/claude-code-replay.js.map +1 -0
- package/dist/acp/macro-agent.d.ts.map +1 -1
- package/dist/acp/macro-agent.js +155 -6
- package/dist/acp/macro-agent.js.map +1 -1
- package/dist/acp/types.d.ts +9 -0
- package/dist/acp/types.d.ts.map +1 -1
- package/dist/acp/types.js.map +1 -1
- package/dist/agent/agent-manager-v2.d.ts +21 -0
- package/dist/agent/agent-manager-v2.d.ts.map +1 -1
- package/dist/agent/agent-manager-v2.js +234 -43
- package/dist/agent/agent-manager-v2.js.map +1 -1
- package/dist/agent/agent-manager.d.ts +12 -0
- package/dist/agent/agent-manager.d.ts.map +1 -1
- package/dist/agent/agent-manager.js.map +1 -1
- package/dist/agent/types.d.ts +15 -2
- package/dist/agent/types.d.ts.map +1 -1
- package/dist/agent/types.js.map +1 -1
- package/dist/boot-v2.d.ts +41 -0
- package/dist/boot-v2.d.ts.map +1 -1
- package/dist/boot-v2.js +16 -1
- package/dist/boot-v2.js.map +1 -1
- package/dist/cli/index.js +56 -0
- package/dist/cli/index.js.map +1 -1
- package/dist/cognitive/macro-agent-backend.d.ts.map +1 -1
- package/dist/cognitive/macro-agent-backend.js +40 -22
- package/dist/cognitive/macro-agent-backend.js.map +1 -1
- package/dist/integrations/skilltree.d.ts.map +1 -1
- package/dist/integrations/skilltree.js +1 -0
- package/dist/integrations/skilltree.js.map +1 -1
- package/dist/lifecycle/cleanup.d.ts +33 -2
- package/dist/lifecycle/cleanup.d.ts.map +1 -1
- package/dist/lifecycle/cleanup.js +28 -6
- package/dist/lifecycle/cleanup.js.map +1 -1
- package/dist/lifecycle/handlers-v2.d.ts +7 -0
- package/dist/lifecycle/handlers-v2.d.ts.map +1 -1
- package/dist/lifecycle/handlers-v2.js +28 -2
- package/dist/lifecycle/handlers-v2.js.map +1 -1
- package/dist/lifecycle/types.d.ts +11 -0
- package/dist/lifecycle/types.d.ts.map +1 -1
- package/dist/lifecycle/types.js.map +1 -1
- package/dist/map/acp-bridge.d.ts +9 -0
- package/dist/map/acp-bridge.d.ts.map +1 -1
- package/dist/map/acp-bridge.js +15 -2
- package/dist/map/acp-bridge.js.map +1 -1
- package/dist/map/cascade-bridge.d.ts +44 -0
- package/dist/map/cascade-bridge.d.ts.map +1 -0
- package/dist/map/cascade-bridge.js +257 -0
- package/dist/map/cascade-bridge.js.map +1 -0
- package/dist/map/lifecycle-bridge.d.ts +1 -1
- package/dist/map/lifecycle-bridge.d.ts.map +1 -1
- package/dist/map/lifecycle-bridge.js +58 -23
- package/dist/map/lifecycle-bridge.js.map +1 -1
- package/dist/map/server.d.ts.map +1 -1
- package/dist/map/server.js +47 -6
- package/dist/map/server.js.map +1 -1
- package/dist/map/sidecar.d.ts.map +1 -1
- package/dist/map/sidecar.js +33 -2
- package/dist/map/sidecar.js.map +1 -1
- package/dist/map/types.d.ts +20 -0
- package/dist/map/types.d.ts.map +1 -1
- package/dist/mcp/tools/done-v2.d.ts.map +1 -1
- package/dist/mcp/tools/done-v2.js +8 -0
- package/dist/mcp/tools/done-v2.js.map +1 -1
- package/dist/teams/team-manager-v2.d.ts.map +1 -1
- package/dist/teams/team-manager-v2.js +26 -0
- package/dist/teams/team-manager-v2.js.map +1 -1
- package/dist/teams/team-runtime-v2.d.ts.map +1 -1
- package/dist/teams/team-runtime-v2.js +16 -3
- package/dist/teams/team-runtime-v2.js.map +1 -1
- package/dist/workspace/config.d.ts +10 -10
- package/dist/workspace/config.d.ts.map +1 -1
- package/dist/workspace/config.js +4 -4
- package/dist/workspace/config.js.map +1 -1
- package/dist/workspace/git-cascade-adapter.d.ts +510 -0
- package/dist/workspace/git-cascade-adapter.d.ts.map +1 -0
- package/dist/workspace/git-cascade-adapter.js +908 -0
- package/dist/workspace/git-cascade-adapter.js.map +1 -0
- package/dist/workspace/index.d.ts +3 -3
- package/dist/workspace/index.d.ts.map +1 -1
- package/dist/workspace/index.js +4 -4
- package/dist/workspace/index.js.map +1 -1
- package/dist/workspace/landing/direct-push.d.ts +20 -0
- package/dist/workspace/landing/direct-push.d.ts.map +1 -0
- package/dist/workspace/landing/direct-push.js +74 -0
- package/dist/workspace/landing/direct-push.js.map +1 -0
- package/dist/workspace/landing/index.d.ts +29 -0
- package/dist/workspace/landing/index.d.ts.map +1 -0
- package/dist/workspace/landing/index.js +37 -0
- package/dist/workspace/landing/index.js.map +1 -0
- package/dist/workspace/landing/merge-to-parent.d.ts +41 -0
- package/dist/workspace/landing/merge-to-parent.d.ts.map +1 -0
- package/dist/workspace/landing/merge-to-parent.js +185 -0
- package/dist/workspace/landing/merge-to-parent.js.map +1 -0
- package/dist/workspace/landing/optimistic-push.d.ts +16 -0
- package/dist/workspace/landing/optimistic-push.d.ts.map +1 -0
- package/dist/workspace/landing/optimistic-push.js +27 -0
- package/dist/workspace/landing/optimistic-push.js.map +1 -0
- package/dist/workspace/landing/queue-to-branch.d.ts +24 -0
- package/dist/workspace/landing/queue-to-branch.d.ts.map +1 -0
- package/dist/workspace/landing/queue-to-branch.js +79 -0
- package/dist/workspace/landing/queue-to-branch.js.map +1 -0
- package/dist/workspace/merge-queue/merge-queue.d.ts +10 -0
- package/dist/workspace/merge-queue/merge-queue.d.ts.map +1 -1
- package/dist/workspace/merge-queue/merge-queue.js +10 -0
- package/dist/workspace/merge-queue/merge-queue.js.map +1 -1
- package/dist/workspace/merge-queue/types.d.ts +16 -2
- package/dist/workspace/merge-queue/types.d.ts.map +1 -1
- package/dist/workspace/merge-queue/types.js +9 -0
- package/dist/workspace/merge-queue/types.js.map +1 -1
- package/dist/workspace/pool/types.d.ts +1 -0
- package/dist/workspace/pool/types.d.ts.map +1 -1
- package/dist/workspace/pool/worktree-pool.d.ts.map +1 -1
- package/dist/workspace/pool/worktree-pool.js +1 -0
- package/dist/workspace/pool/worktree-pool.js.map +1 -1
- package/dist/workspace/recovery/abandon.d.ts +15 -0
- package/dist/workspace/recovery/abandon.d.ts.map +1 -0
- package/dist/workspace/recovery/abandon.js +45 -0
- package/dist/workspace/recovery/abandon.js.map +1 -0
- package/dist/workspace/recovery/auto-resolve.d.ts +27 -0
- package/dist/workspace/recovery/auto-resolve.d.ts.map +1 -0
- package/dist/workspace/recovery/auto-resolve.js +99 -0
- package/dist/workspace/recovery/auto-resolve.js.map +1 -0
- package/dist/workspace/recovery/defer.d.ts +15 -0
- package/dist/workspace/recovery/defer.d.ts.map +1 -0
- package/dist/workspace/recovery/defer.js +16 -0
- package/dist/workspace/recovery/defer.js.map +1 -0
- package/dist/workspace/recovery/escalate.d.ts +16 -0
- package/dist/workspace/recovery/escalate.d.ts.map +1 -0
- package/dist/workspace/recovery/escalate.js +24 -0
- package/dist/workspace/recovery/escalate.js.map +1 -0
- package/dist/workspace/recovery/index.d.ts +32 -0
- package/dist/workspace/recovery/index.d.ts.map +1 -0
- package/dist/workspace/recovery/index.js +45 -0
- package/dist/workspace/recovery/index.js.map +1 -0
- package/dist/workspace/recovery/spawn-resolver.d.ts +45 -0
- package/dist/workspace/recovery/spawn-resolver.d.ts.map +1 -0
- package/dist/workspace/recovery/spawn-resolver.js +111 -0
- package/dist/workspace/recovery/spawn-resolver.js.map +1 -0
- package/dist/workspace/recovery/types.d.ts +63 -0
- package/dist/workspace/recovery/types.d.ts.map +1 -0
- package/dist/workspace/recovery/types.js +12 -0
- package/dist/workspace/recovery/types.js.map +1 -0
- package/dist/workspace/topology/index.d.ts +9 -0
- package/dist/workspace/topology/index.d.ts.map +1 -0
- package/dist/workspace/topology/index.js +8 -0
- package/dist/workspace/topology/index.js.map +1 -0
- package/dist/workspace/topology/no-workspace.d.ts +18 -0
- package/dist/workspace/topology/no-workspace.d.ts.map +1 -0
- package/dist/workspace/topology/no-workspace.js +25 -0
- package/dist/workspace/topology/no-workspace.js.map +1 -0
- package/dist/workspace/topology/types.d.ts +97 -0
- package/dist/workspace/topology/types.d.ts.map +1 -0
- package/dist/workspace/topology/types.js +20 -0
- package/dist/workspace/topology/types.js.map +1 -0
- package/dist/workspace/topology/yaml-driven.d.ts +69 -0
- package/dist/workspace/topology/yaml-driven.d.ts.map +1 -0
- package/dist/workspace/topology/yaml-driven.js +273 -0
- package/dist/workspace/topology/yaml-driven.js.map +1 -0
- package/dist/workspace/types-v3.d.ts +110 -0
- package/dist/workspace/types-v3.d.ts.map +1 -0
- package/dist/workspace/types-v3.js +20 -0
- package/dist/workspace/types-v3.js.map +1 -0
- package/dist/workspace/types.d.ts +145 -17
- package/dist/workspace/types.d.ts.map +1 -1
- package/dist/workspace/workspace-manager.d.ts +92 -13
- package/dist/workspace/workspace-manager.d.ts.map +1 -1
- package/dist/workspace/workspace-manager.js +373 -13
- package/dist/workspace/workspace-manager.js.map +1 -1
- package/dist/workspace/yaml-schema.d.ts +254 -0
- package/dist/workspace/yaml-schema.d.ts.map +1 -0
- package/dist/workspace/yaml-schema.js +170 -0
- package/dist/workspace/yaml-schema.js.map +1 -0
- package/docs/conflict-recovery.md +472 -0
- package/docs/git-cascade-integration-gaps.md +678 -0
- package/docs/workspace-interfaces.md +731 -0
- package/docs/workspace-redesign-plan.md +302 -0
- package/package.json +4 -4
- package/src/__tests__/e2e/auto-sync.e2e.test.ts +257 -0
- package/src/__tests__/e2e/cascade-rebase.e2e.test.ts +254 -0
- package/src/__tests__/e2e/cli-run.e2e.test.ts +167 -0
- package/src/__tests__/e2e/self-driving-v3.e2e.test.ts +197 -0
- package/src/__tests__/e2e/spawn-resolver.e2e.test.ts +200 -0
- package/src/__tests__/e2e/workspace-lifecycle.e2e.test.ts +30 -22
- package/src/__tests__/e2e/workspace-v3.e2e.test.ts +413 -0
- package/src/acp/__tests__/claude-code-replay.test.ts +225 -0
- package/src/acp/__tests__/macro-agent.test.ts +39 -1
- package/src/acp/claude-code-replay.ts +208 -0
- package/src/acp/macro-agent.ts +167 -9
- package/src/acp/types.ts +10 -0
- package/src/agent/__tests__/agent-manager-topology.test.ts +73 -0
- package/src/agent/__tests__/agent-manager-v2.test.ts +66 -0
- package/src/agent/__tests__/task-ref-resolution.test.ts +231 -0
- package/src/agent/agent-manager-v2.ts +293 -48
- package/src/agent/agent-manager.ts +14 -0
- package/src/agent/types.ts +16 -2
- package/src/boot-v2.ts +68 -1
- package/src/cli/index.ts +61 -0
- package/src/cognitive/macro-agent-backend.ts +45 -29
- package/src/integrations/skilltree.ts +1 -0
- package/src/lifecycle/cleanup.ts +52 -3
- package/src/lifecycle/handlers-v2.ts +40 -3
- package/src/lifecycle/types.ts +12 -0
- package/src/map/__tests__/cascade-bridge.test.ts +229 -0
- package/src/map/__tests__/lifecycle-bridge.test.ts +86 -10
- package/src/map/acp-bridge.ts +26 -3
- package/src/map/cascade-bridge.ts +301 -0
- package/src/map/lifecycle-bridge.ts +52 -17
- package/src/map/server.ts +47 -6
- package/src/map/sidecar.ts +31 -1
- package/src/map/types.ts +20 -0
- package/src/mcp/tools/done-v2.ts +9 -0
- package/src/teams/team-manager-v2.ts +37 -0
- package/src/teams/team-runtime-v2.ts +23 -3
- package/src/workspace/__tests__/{dataplane-adapter.test.ts → git-cascade-adapter.test.ts} +209 -14
- package/src/workspace/__tests__/self-driving-yaml.test.ts +114 -0
- package/src/workspace/__tests__/shared-worktree-refcount.test.ts +154 -0
- package/src/workspace/__tests__/standalone-mode.test.ts +118 -0
- package/src/workspace/__tests__/workspace-manager-v3.test.ts +245 -0
- package/src/workspace/__tests__/yaml-schema.test.ts +210 -0
- package/src/workspace/config.ts +11 -11
- package/src/workspace/git-cascade-adapter.ts +1186 -0
- package/src/workspace/index.ts +11 -11
- package/src/workspace/landing/__tests__/strategies.test.ts +142 -0
- package/src/workspace/landing/direct-push.ts +91 -0
- package/src/workspace/landing/index.ts +40 -0
- package/src/workspace/landing/merge-to-parent.ts +228 -0
- package/src/workspace/landing/optimistic-push.ts +36 -0
- package/src/workspace/landing/queue-to-branch.ts +108 -0
- package/src/workspace/merge-queue/merge-queue.ts +10 -0
- package/src/workspace/merge-queue/types.ts +16 -2
- package/src/workspace/pool/__tests__/worktree-pool.integration.test.ts +5 -5
- package/src/workspace/pool/types.ts +1 -0
- package/src/workspace/pool/worktree-pool.ts +1 -0
- package/src/workspace/recovery/__tests__/auto-resolve-integration.test.ts +127 -0
- package/src/workspace/recovery/__tests__/spawn-resolver.test.ts +139 -0
- package/src/workspace/recovery/__tests__/strategies.test.ts +145 -0
- package/src/workspace/recovery/abandon.ts +51 -0
- package/src/workspace/recovery/auto-resolve.ts +119 -0
- package/src/workspace/recovery/defer.ts +23 -0
- package/src/workspace/recovery/escalate.ts +30 -0
- package/src/workspace/recovery/index.ts +58 -0
- package/src/workspace/recovery/spawn-resolver.ts +145 -0
- package/src/workspace/recovery/types.ts +54 -0
- package/src/workspace/topology/__tests__/yaml-driven.test.ts +345 -0
- package/src/workspace/topology/index.ts +18 -0
- package/src/workspace/topology/no-workspace.ts +39 -0
- package/src/workspace/topology/types.ts +116 -0
- package/src/workspace/topology/yaml-driven.ts +316 -0
- package/src/workspace/types-v3.ts +155 -0
- package/src/workspace/types.ts +191 -20
- package/src/workspace/workspace-manager.ts +474 -19
- package/src/workspace/yaml-schema.ts +216 -0
- package/src/workspace/dataplane-adapter.ts +0 -546
|
@@ -24,7 +24,7 @@ export type TaskId = string;
|
|
|
24
24
|
/**
|
|
25
25
|
* Agent role types that require workspaces
|
|
26
26
|
*/
|
|
27
|
-
export type WorkspaceRole = 'worker' | 'integrator' | 'coordinator';
|
|
27
|
+
export type WorkspaceRole = 'worker' | 'integrator' | 'coordinator' | 'v3';
|
|
28
28
|
/**
|
|
29
29
|
* Workspace represents an isolated git worktree assigned to an agent.
|
|
30
30
|
*
|
|
@@ -129,7 +129,7 @@ export interface CleanupStatus {
|
|
|
129
129
|
/**
|
|
130
130
|
* WorkspaceManager interface for managing agent workspaces.
|
|
131
131
|
*
|
|
132
|
-
* Bridges macro-agent roles to
|
|
132
|
+
* Bridges macro-agent roles to git-cascade streams and worktrees.
|
|
133
133
|
*
|
|
134
134
|
* @see [[s-7ktd]] WorkspaceManager API section
|
|
135
135
|
*/
|
|
@@ -137,6 +137,10 @@ export interface WorkspaceManager {
|
|
|
137
137
|
/**
|
|
138
138
|
* Create an integration stream for a coordinator.
|
|
139
139
|
*
|
|
140
|
+
* Role-shaped convenience method. For stream-first semantics (fork from
|
|
141
|
+
* another stream, pseudo-principal ownership, richer metadata), prefer
|
|
142
|
+
* `createStreamV3({ name, ownerId, forkFrom, parent?, metadata? })`.
|
|
143
|
+
*
|
|
140
144
|
* @param coordinatorId - ID of the coordinator agent
|
|
141
145
|
* @param config - Stream configuration
|
|
142
146
|
* @returns Stream ID
|
|
@@ -152,26 +156,22 @@ export interface WorkspaceManager {
|
|
|
152
156
|
/**
|
|
153
157
|
* Create a workspace for a worker agent.
|
|
154
158
|
*
|
|
155
|
-
*
|
|
156
|
-
*
|
|
157
|
-
* @param streamId - ID of the integration stream
|
|
158
|
-
* @returns Worker workspace
|
|
159
|
+
* Role-shaped convenience. For role-neutral allocation, prefer
|
|
160
|
+
* `allocateWorktree({ agentId, streamId })`.
|
|
159
161
|
*/
|
|
160
162
|
createWorkerWorkspace(workerId: AgentId, taskId: TaskId, streamId: StreamId): WorkerWorkspace;
|
|
161
163
|
/**
|
|
162
164
|
* Create a workspace for an integrator agent.
|
|
163
165
|
*
|
|
164
|
-
*
|
|
165
|
-
*
|
|
166
|
-
* @returns Integrator workspace
|
|
166
|
+
* Role-shaped convenience. For role-neutral allocation, prefer
|
|
167
|
+
* `allocateWorktree({ agentId, streamId })`.
|
|
167
168
|
*/
|
|
168
169
|
createIntegratorWorkspace(integratorId: AgentId, streamId: StreamId): IntegratorWorkspace;
|
|
169
170
|
/**
|
|
170
171
|
* Create a workspace for a coordinator agent.
|
|
171
172
|
*
|
|
172
|
-
*
|
|
173
|
-
*
|
|
174
|
-
* @returns Coordinator workspace
|
|
173
|
+
* Role-shaped convenience. For role-neutral allocation, prefer
|
|
174
|
+
* `allocateWorktree({ agentId, streamId })`.
|
|
175
175
|
*/
|
|
176
176
|
createCoordinatorWorkspace(coordinatorId: AgentId, streamId: StreamId): CoordinatorWorkspace;
|
|
177
177
|
/**
|
|
@@ -183,6 +183,9 @@ export interface WorkspaceManager {
|
|
|
183
183
|
/**
|
|
184
184
|
* Create a task under a stream.
|
|
185
185
|
*
|
|
186
|
+
* @deprecated V3 does not use git-cascade's `workerTasks` layer for
|
|
187
|
+
* task tracking; use opentasks via `TasksAdapter` instead. This method
|
|
188
|
+
* exists only for the legacy capability-based dispatch path.
|
|
186
189
|
* @param streamId - ID of the integration stream
|
|
187
190
|
* @param options - Task creation options
|
|
188
191
|
* @returns Task ID
|
|
@@ -191,6 +194,10 @@ export interface WorkspaceManager {
|
|
|
191
194
|
/**
|
|
192
195
|
* Claim a task for a worker.
|
|
193
196
|
*
|
|
197
|
+
* @deprecated See `createTask` — V3 uses opentasks. This method cuts the
|
|
198
|
+
* git-cascade worker branch via `startTask`; V3 equivalent is
|
|
199
|
+
* `allocateWorktree({ agentId, streamId })` + `commitChanges` on the
|
|
200
|
+
* stream branch directly.
|
|
194
201
|
* @param taskId - ID of the task to claim
|
|
195
202
|
* @param workerId - ID of the worker agent
|
|
196
203
|
* @param worktree - Path to the worker's worktree
|
|
@@ -200,6 +207,8 @@ export interface WorkspaceManager {
|
|
|
200
207
|
/**
|
|
201
208
|
* Get the next available task for a stream.
|
|
202
209
|
*
|
|
210
|
+
* @deprecated Use opentasks for task queueing; git-cascade's worker task
|
|
211
|
+
* layer is redundant in V3.
|
|
203
212
|
* @param streamId - ID of the integration stream
|
|
204
213
|
* @returns Next task or null if none available
|
|
205
214
|
*/
|
|
@@ -229,21 +238,140 @@ export interface WorkspaceManager {
|
|
|
229
238
|
/**
|
|
230
239
|
* Get the merge queue for coordinating worker merges.
|
|
231
240
|
*
|
|
232
|
-
*
|
|
233
|
-
*
|
|
241
|
+
* @deprecated Use git-cascade's built-in queue via the V3 surface —
|
|
242
|
+
* `workspaceManager.addToMergeQueue` (when exposed) or the
|
|
243
|
+
* `queue-to-branch` `LandingStrategy`. This method returns the legacy
|
|
244
|
+
* macro-agent MergeQueue that duplicates git-cascade's schema; kept for
|
|
245
|
+
* legacy callers until teams migrate to `macro_agent.workspace` YAML.
|
|
234
246
|
*
|
|
235
|
-
* @returns MergeQueue instance
|
|
247
|
+
* @returns Legacy MergeQueue instance (duplicate of git-cascade's queue)
|
|
236
248
|
*/
|
|
237
249
|
getMergeQueue(): MergeQueueInterface;
|
|
250
|
+
/**
|
|
251
|
+
* Create a new stream. Stream-first equivalent of `createIntegrationStream`;
|
|
252
|
+
* does not require a coordinator owner — any `Principal` (including pseudo
|
|
253
|
+
* principals like `team:<name>`) can own.
|
|
254
|
+
*
|
|
255
|
+
* @see docs/workspace-interfaces.md §5
|
|
256
|
+
*/
|
|
257
|
+
createStreamV3(spec: import('./types-v3.js').StreamSpec): StreamId;
|
|
258
|
+
/**
|
|
259
|
+
* Fork a child stream from a parent. Enables stacking workflows (solo stack,
|
|
260
|
+
* long-lived feature + subtasks).
|
|
261
|
+
*/
|
|
262
|
+
forkStream(opts: {
|
|
263
|
+
parentStreamId: StreamId;
|
|
264
|
+
name: string;
|
|
265
|
+
ownerId: import('./types-v3.js').Principal;
|
|
266
|
+
metadata?: Record<string, unknown>;
|
|
267
|
+
}): StreamId;
|
|
268
|
+
/**
|
|
269
|
+
* Merge a source stream into a target stream.
|
|
270
|
+
*/
|
|
271
|
+
mergeStream(opts: {
|
|
272
|
+
sourceStreamId: StreamId;
|
|
273
|
+
targetStreamId: StreamId;
|
|
274
|
+
agentId: import('./types-v3.js').Principal;
|
|
275
|
+
worktree: string;
|
|
276
|
+
}): import('./types-v3.js').MergeResult;
|
|
277
|
+
/**
|
|
278
|
+
* Rebase a stream onto its parent.
|
|
279
|
+
*/
|
|
280
|
+
syncWithParent(opts: {
|
|
281
|
+
streamId: StreamId;
|
|
282
|
+
agentId: import('./types-v3.js').Principal;
|
|
283
|
+
worktree: string;
|
|
284
|
+
onConflict?: import('./types-v3.js').ConflictStrategy;
|
|
285
|
+
}): import('./types-v3.js').RebaseResult;
|
|
286
|
+
/**
|
|
287
|
+
* Lifecycle transitions for streams.
|
|
288
|
+
*/
|
|
289
|
+
abandonStream(streamId: StreamId, opts?: {
|
|
290
|
+
cascade?: boolean;
|
|
291
|
+
reason?: string;
|
|
292
|
+
}): void;
|
|
293
|
+
pauseStream(streamId: StreamId, reason?: string): void;
|
|
294
|
+
resumeStream(streamId: StreamId): void;
|
|
295
|
+
/**
|
|
296
|
+
* Stream queries.
|
|
297
|
+
*/
|
|
298
|
+
listStreams(filter?: {
|
|
299
|
+
ownerId?: import('./types-v3.js').Principal;
|
|
300
|
+
status?: import('./types-v3.js').Stream['status'];
|
|
301
|
+
}): import('./types-v3.js').Stream[];
|
|
302
|
+
/**
|
|
303
|
+
* Commit with Change-Id tracking. Use this instead of raw `git commit` when
|
|
304
|
+
* committing on behalf of a streamed agent.
|
|
305
|
+
*/
|
|
306
|
+
commitChanges(opts: {
|
|
307
|
+
agentId: import('./types-v3.js').Principal;
|
|
308
|
+
streamId: StreamId;
|
|
309
|
+
worktree: string;
|
|
310
|
+
message: string;
|
|
311
|
+
}): {
|
|
312
|
+
commit: string;
|
|
313
|
+
changeId: import('./types-v3.js').ChangeId;
|
|
314
|
+
};
|
|
315
|
+
/**
|
|
316
|
+
* Mark a set of changes as merged (e.g., after a landing strategy completes).
|
|
317
|
+
*/
|
|
318
|
+
markChangesMerged(changeIds: import('./types-v3.js').ChangeId[]): void;
|
|
319
|
+
getChange(changeId: import('./types-v3.js').ChangeId): import('./types-v3.js').Change | null;
|
|
320
|
+
getChangeByCommit(commit: string): import('./types-v3.js').Change | null;
|
|
321
|
+
/**
|
|
322
|
+
* Allocate a worktree for an agent, optionally attached to a stream.
|
|
323
|
+
* Stream-first equivalent of `createWorker/Integrator/CoordinatorWorkspace`.
|
|
324
|
+
*/
|
|
325
|
+
allocateWorktree(opts: import('./types-v3.js').AllocateWorktreeOpts): import('./types-v3.js').Worktree;
|
|
326
|
+
/**
|
|
327
|
+
* Get the worktree owned by a principal (if any).
|
|
328
|
+
*/
|
|
329
|
+
getWorktreeForAgent(agentId: import('./types-v3.js').Principal): import('./types-v3.js').Worktree | null;
|
|
330
|
+
/**
|
|
331
|
+
* Register a landing strategy. Registered strategies can be referenced by
|
|
332
|
+
* name from role YAML (see Phase 5 — `LandingStrategy` integration).
|
|
333
|
+
*/
|
|
334
|
+
registerLandingStrategy(strategy: import('./types-v3.js').LandingStrategy): void;
|
|
335
|
+
/**
|
|
336
|
+
* Run macro-level reconciliation:
|
|
337
|
+
* - Delegates to git-cascade's `reconcile()` for stream↔git sync.
|
|
338
|
+
* - Cleans up orphan worktrees and stale pool entries.
|
|
339
|
+
* Intended to be called once on boot.
|
|
340
|
+
*/
|
|
341
|
+
reconcileV3(): import('./types-v3.js').MacroReconcileResult;
|
|
342
|
+
/**
|
|
343
|
+
* Resolve a conflict record (typically called by a resolver agent via the
|
|
344
|
+
* `resolve_conflict` MCP tool after it fixes conflict markers and commits).
|
|
345
|
+
* Emits `conflict:resolved` event.
|
|
346
|
+
*/
|
|
347
|
+
resolveConflict(opts: {
|
|
348
|
+
conflictId: string;
|
|
349
|
+
resolvedBy: import('./types-v3.js').Principal;
|
|
350
|
+
resolutionCommit?: string;
|
|
351
|
+
/** How the conflict was resolved. Default 'agent'. */
|
|
352
|
+
method?: 'ours' | 'theirs' | 'manual' | 'agent' | 'auto-resolve' | 'spawn-resolver' | 'abandoned';
|
|
353
|
+
/** Human-readable resolution summary. */
|
|
354
|
+
summary?: string;
|
|
355
|
+
}): void;
|
|
356
|
+
/**
|
|
357
|
+
* Subscribe to workspace events. Returns an unsubscribe function.
|
|
358
|
+
*/
|
|
359
|
+
onEvent(callback: WorkspaceEventCallback): () => void;
|
|
238
360
|
/**
|
|
239
361
|
* Close the workspace manager and release resources.
|
|
240
362
|
*/
|
|
241
363
|
close(): void;
|
|
242
364
|
}
|
|
243
365
|
/**
|
|
244
|
-
* Events emitted by WorkspaceManager
|
|
366
|
+
* Events emitted by WorkspaceManager.
|
|
367
|
+
*
|
|
368
|
+
* Legacy events (`workspace:*`, `child:*`, `branches:*`, `branch:*`) drive the
|
|
369
|
+
* existing role-shaped lifecycle. V3 events (`stream:*`, `worktree:*`,
|
|
370
|
+
* `change:*`, `conflict:*`, `landing:*`, `cascade:*`, `mergeQueue:*`) drive the
|
|
371
|
+
* stream-first redesign and are re-emitted from the underlying git-cascade
|
|
372
|
+
* adapter. Consumers narrow on the type string.
|
|
245
373
|
*/
|
|
246
|
-
export type WorkspaceEventType = 'workspace:created' | 'workspace:deallocated' | 'child:registered' | 'branches:cleaned' | 'branch:deleted';
|
|
374
|
+
export type WorkspaceEventType = 'workspace:created' | 'workspace:deallocated' | 'child:registered' | 'branches:cleaned' | 'branch:deleted' | 'stream:created' | 'stream:forked' | 'stream:committed' | 'stream:merged' | 'stream:conflicted' | 'stream:abandoned' | 'stream:paused' | 'stream:resumed' | 'worktree:allocated' | 'worktree:shared' | 'worktree:released' | 'change:merged' | 'change:dropped' | 'conflict:created' | 'conflict:resolved' | 'landing:started' | 'landing:completed' | 'cascade:completed' | 'mergeQueue:added' | 'mergeQueue:ready' | 'mergeQueue:cancelled' | 'mergeQueue:removed';
|
|
247
375
|
/**
|
|
248
376
|
* Event payload for workspace events
|
|
249
377
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* WorkspaceManager Implementation
|
|
3
3
|
*
|
|
4
|
-
* Bridges macro-agent roles to
|
|
4
|
+
* Bridges macro-agent roles to git-cascade streams and worktrees.
|
|
5
5
|
* Provides a higher-level API for workspace management.
|
|
6
6
|
*
|
|
7
7
|
* @module workspace/workspace-manager
|
|
8
8
|
* @implements [[s-7ktd]] WorkspaceManager API section
|
|
9
9
|
*/
|
|
10
10
|
import type { Stream, WorkerTask, StartTaskResult, CleanupWorkerBranchesOptions, CleanupResult } from 'git-cascade';
|
|
11
|
-
import {
|
|
12
|
-
import type {
|
|
11
|
+
import { GitCascadeAdapter } from './git-cascade-adapter.js';
|
|
12
|
+
import type { GitCascadeConfig, WorktreePoolConfig } from './config.js';
|
|
13
13
|
import { WorktreePool } from './pool/worktree-pool.js';
|
|
14
14
|
import type { AllocationStrategy, AcquireOptions } from './pool/types.js';
|
|
15
15
|
import type { AgentId, StreamId, TaskId, Workspace, WorkerWorkspace, IntegratorWorkspace, CoordinatorWorkspace, WorkspaceManager, StreamConfig, CreateTaskOptions, WorkspaceEventCallback } from './types.js';
|
|
@@ -17,7 +17,7 @@ import type { MergeQueueInterface } from './merge-queue/types.js';
|
|
|
17
17
|
/**
|
|
18
18
|
* Configuration options for DefaultWorkspaceManager.
|
|
19
19
|
*/
|
|
20
|
-
export interface WorkspaceManagerConfig extends
|
|
20
|
+
export interface WorkspaceManagerConfig extends GitCascadeConfig {
|
|
21
21
|
/**
|
|
22
22
|
* Base directory for worktrees.
|
|
23
23
|
* Defaults to `<repoPath>/.worktrees`.
|
|
@@ -33,7 +33,7 @@ export interface WorkspaceManagerConfig extends DataplaneConfig {
|
|
|
33
33
|
* DefaultWorkspaceManager implements the WorkspaceManager interface.
|
|
34
34
|
*
|
|
35
35
|
* Responsibilities:
|
|
36
|
-
* - Wraps
|
|
36
|
+
* - Wraps GitCascadeAdapter for stream/worktree operations
|
|
37
37
|
* - Maintains agentId → workspace mappings
|
|
38
38
|
* - Emits events on workspace lifecycle changes
|
|
39
39
|
*
|
|
@@ -51,10 +51,20 @@ export declare class DefaultWorkspaceManager implements WorkspaceManager {
|
|
|
51
51
|
/**
|
|
52
52
|
* Create a new DefaultWorkspaceManager.
|
|
53
53
|
*
|
|
54
|
-
* @param adapter -
|
|
54
|
+
* @param adapter - GitCascadeAdapter instance
|
|
55
55
|
* @param config - Configuration options
|
|
56
56
|
*/
|
|
57
|
-
constructor(adapter:
|
|
57
|
+
constructor(adapter: GitCascadeAdapter, config?: Partial<WorkspaceManagerConfig>);
|
|
58
|
+
/**
|
|
59
|
+
* Access the underlying GitCascadeAdapter. Exposed for bridges that
|
|
60
|
+
* subscribe to the cascade event stream (e.g., the MAP cascade-bridge
|
|
61
|
+
* that forwards events to an OpenHive hub).
|
|
62
|
+
*
|
|
63
|
+
* Most callers should use the WorkspaceManager API surface. Use this only
|
|
64
|
+
* when direct access to the adapter's event stream or primitives is
|
|
65
|
+
* required.
|
|
66
|
+
*/
|
|
67
|
+
getGitCascadeAdapter(): GitCascadeAdapter;
|
|
58
68
|
/**
|
|
59
69
|
* Subscribe to workspace events.
|
|
60
70
|
*
|
|
@@ -172,16 +182,16 @@ export declare class DefaultWorkspaceManager implements WorkspaceManager {
|
|
|
172
182
|
*/
|
|
173
183
|
registerChildWorkspace(coordinatorId: AgentId, childId: AgentId, childPath: string): void;
|
|
174
184
|
/**
|
|
175
|
-
* Get the underlying
|
|
185
|
+
* Get the underlying GitCascadeAdapter.
|
|
176
186
|
*
|
|
177
187
|
* Use with caution - prefer manager methods for operations.
|
|
178
188
|
*/
|
|
179
|
-
get rawAdapter():
|
|
189
|
+
get rawAdapter(): GitCascadeAdapter;
|
|
180
190
|
/**
|
|
181
191
|
* Get the merge queue for coordinating worker merges.
|
|
182
192
|
*
|
|
183
193
|
* The merge queue is lazily initialized on first access and uses
|
|
184
|
-
* the same database as the
|
|
194
|
+
* the same database as the git-cascade adapter.
|
|
185
195
|
*
|
|
186
196
|
* @returns MergeQueue instance
|
|
187
197
|
*/
|
|
@@ -293,6 +303,75 @@ export declare class DefaultWorkspaceManager implements WorkspaceManager {
|
|
|
293
303
|
* @returns true if deleted, false if branch didn't exist
|
|
294
304
|
*/
|
|
295
305
|
deleteWorkerBranch(branchName: string): boolean;
|
|
306
|
+
private readonly landingStrategies;
|
|
307
|
+
/**
|
|
308
|
+
* Ref-counted sharing state keyed by worktree path.
|
|
309
|
+
*
|
|
310
|
+
* - `ownerId`: the principal that originally allocated the worktree (the
|
|
311
|
+
* id that git-cascade's tracker associates with the worktree).
|
|
312
|
+
* - `sharers`: other agents that allocated via `sharedWithAgent`.
|
|
313
|
+
* - `ownerDeparted`: set when the owner deallocates but sharers remain —
|
|
314
|
+
* the actual git-cascade teardown is deferred until `sharers` is empty.
|
|
315
|
+
*/
|
|
316
|
+
private readonly sharedWorktreeRefs;
|
|
317
|
+
createStreamV3(spec: import('./types-v3.js').StreamSpec): StreamId;
|
|
318
|
+
forkStream(opts: {
|
|
319
|
+
parentStreamId: StreamId;
|
|
320
|
+
name: string;
|
|
321
|
+
ownerId: import('./types-v3.js').Principal;
|
|
322
|
+
metadata?: Record<string, unknown>;
|
|
323
|
+
}): StreamId;
|
|
324
|
+
mergeStream(opts: {
|
|
325
|
+
sourceStreamId: StreamId;
|
|
326
|
+
targetStreamId: StreamId;
|
|
327
|
+
agentId: import('./types-v3.js').Principal;
|
|
328
|
+
worktree: string;
|
|
329
|
+
}): import('./types-v3.js').MergeResult;
|
|
330
|
+
syncWithParent(opts: {
|
|
331
|
+
streamId: StreamId;
|
|
332
|
+
agentId: import('./types-v3.js').Principal;
|
|
333
|
+
worktree: string;
|
|
334
|
+
onConflict?: import('./types-v3.js').ConflictStrategy;
|
|
335
|
+
}): import('./types-v3.js').RebaseResult;
|
|
336
|
+
abandonStream(streamId: StreamId, opts?: {
|
|
337
|
+
cascade?: boolean;
|
|
338
|
+
reason?: string;
|
|
339
|
+
}): void;
|
|
340
|
+
pauseStream(streamId: StreamId, reason?: string): void;
|
|
341
|
+
resumeStream(streamId: StreamId): void;
|
|
342
|
+
listStreams(filter?: {
|
|
343
|
+
ownerId?: import('./types-v3.js').Principal;
|
|
344
|
+
status?: import('./types-v3.js').Stream['status'];
|
|
345
|
+
}): import('./types-v3.js').Stream[];
|
|
346
|
+
commitChanges(opts: {
|
|
347
|
+
agentId: import('./types-v3.js').Principal;
|
|
348
|
+
streamId: StreamId;
|
|
349
|
+
worktree: string;
|
|
350
|
+
message: string;
|
|
351
|
+
}): {
|
|
352
|
+
commit: string;
|
|
353
|
+
changeId: import('./types-v3.js').ChangeId;
|
|
354
|
+
};
|
|
355
|
+
markChangesMerged(changeIds: import('./types-v3.js').ChangeId[]): void;
|
|
356
|
+
getChange(changeId: import('./types-v3.js').ChangeId): import('./types-v3.js').Change | null;
|
|
357
|
+
getChangeByCommit(commit: string): import('./types-v3.js').Change | null;
|
|
358
|
+
allocateWorktree(opts: import('./types-v3.js').AllocateWorktreeOpts): import('./types-v3.js').Worktree;
|
|
359
|
+
getWorktreeForAgent(agentId: import('./types-v3.js').Principal): import('./types-v3.js').Worktree | null;
|
|
360
|
+
registerLandingStrategy(strategy: import('./types-v3.js').LandingStrategy): void;
|
|
361
|
+
reconcileV3(): import('./types-v3.js').MacroReconcileResult;
|
|
362
|
+
resolveConflict(opts: {
|
|
363
|
+
conflictId: string;
|
|
364
|
+
resolvedBy: import('./types-v3.js').Principal;
|
|
365
|
+
resolutionCommit?: string;
|
|
366
|
+
/**
|
|
367
|
+
* How the conflict was resolved. Defaults to 'agent' for the legacy
|
|
368
|
+
* call shape; recovery strategies should pass an explicit method so
|
|
369
|
+
* the OpenHive hub records the right resolution.
|
|
370
|
+
*/
|
|
371
|
+
method?: import('git-cascade').ConflictResolution['method'] | 'auto-resolve' | 'spawn-resolver' | 'abandoned';
|
|
372
|
+
/** Human-readable resolution summary (e.g., 'merged with -X ours'). */
|
|
373
|
+
summary?: string;
|
|
374
|
+
}): void;
|
|
296
375
|
/**
|
|
297
376
|
* Close the workspace manager and release resources.
|
|
298
377
|
*/
|
|
@@ -321,11 +400,11 @@ export declare class DefaultWorkspaceManager implements WorkspaceManager {
|
|
|
321
400
|
*/
|
|
322
401
|
export declare function createWorkspaceManager(config: WorkspaceManagerConfig): DefaultWorkspaceManager;
|
|
323
402
|
/**
|
|
324
|
-
* Create a WorkspaceManager with an existing
|
|
403
|
+
* Create a WorkspaceManager with an existing GitCascadeAdapter.
|
|
325
404
|
*
|
|
326
|
-
* @param adapter -
|
|
405
|
+
* @param adapter - GitCascadeAdapter instance
|
|
327
406
|
* @param config - Configuration options
|
|
328
407
|
* @returns WorkspaceManager instance
|
|
329
408
|
*/
|
|
330
|
-
export declare function createWorkspaceManagerWithAdapter(adapter:
|
|
409
|
+
export declare function createWorkspaceManagerWithAdapter(adapter: GitCascadeAdapter, config?: Partial<WorkspaceManagerConfig>): DefaultWorkspaceManager;
|
|
331
410
|
//# sourceMappingURL=workspace-manager.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workspace-manager.d.ts","sourceRoot":"","sources":["../../src/workspace/workspace-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAiB,4BAA4B,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnI,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"workspace-manager.d.ts","sourceRoot":"","sources":["../../src/workspace/workspace-manager.ts"],"names":[],"mappings":"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"}
|