@devflow-tools/workflow-engine 0.16.21 → 0.16.23

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 (55) hide show
  1. package/dist/index.d.ts +2 -1
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +1 -0
  4. package/dist/index.js.map +1 -1
  5. package/dist/types.d.ts +37 -0
  6. package/dist/types.d.ts.map +1 -1
  7. package/dist/workers/context-session.d.ts +52 -0
  8. package/dist/workers/context-session.d.ts.map +1 -0
  9. package/dist/workers/context-session.js +70 -0
  10. package/dist/workers/context-session.js.map +1 -0
  11. package/dist/workers/file-ownership.d.ts +13 -0
  12. package/dist/workers/file-ownership.d.ts.map +1 -0
  13. package/dist/workers/file-ownership.js +87 -0
  14. package/dist/workers/file-ownership.js.map +1 -0
  15. package/dist/workers/git-worktree.d.ts +33 -0
  16. package/dist/workers/git-worktree.d.ts.map +1 -0
  17. package/dist/workers/git-worktree.js +121 -0
  18. package/dist/workers/git-worktree.js.map +1 -0
  19. package/dist/workers/handoff.d.ts +11 -0
  20. package/dist/workers/handoff.d.ts.map +1 -0
  21. package/dist/workers/handoff.js +64 -0
  22. package/dist/workers/handoff.js.map +1 -0
  23. package/dist/workers/host-launcher.d.ts +21 -0
  24. package/dist/workers/host-launcher.d.ts.map +1 -0
  25. package/dist/workers/host-launcher.js +99 -0
  26. package/dist/workers/host-launcher.js.map +1 -0
  27. package/dist/workers/index.d.ts +11 -0
  28. package/dist/workers/index.d.ts.map +1 -0
  29. package/dist/workers/index.js +11 -0
  30. package/dist/workers/index.js.map +1 -0
  31. package/dist/workers/merge-queue.d.ts +55 -0
  32. package/dist/workers/merge-queue.d.ts.map +1 -0
  33. package/dist/workers/merge-queue.js +76 -0
  34. package/dist/workers/merge-queue.js.map +1 -0
  35. package/dist/workers/paths.d.ts +8 -0
  36. package/dist/workers/paths.d.ts.map +1 -0
  37. package/dist/workers/paths.js +49 -0
  38. package/dist/workers/paths.js.map +1 -0
  39. package/dist/workers/scheduler.d.ts +19 -0
  40. package/dist/workers/scheduler.d.ts.map +1 -0
  41. package/dist/workers/scheduler.js +37 -0
  42. package/dist/workers/scheduler.js.map +1 -0
  43. package/dist/workers/types.d.ts +78 -0
  44. package/dist/workers/types.d.ts.map +1 -0
  45. package/dist/workers/types.js +2 -0
  46. package/dist/workers/types.js.map +1 -0
  47. package/dist/workers/verifier.d.ts +66 -0
  48. package/dist/workers/verifier.d.ts.map +1 -0
  49. package/dist/workers/verifier.js +123 -0
  50. package/dist/workers/verifier.js.map +1 -0
  51. package/dist/workflow-engine.d.ts +2 -0
  52. package/dist/workflow-engine.d.ts.map +1 -1
  53. package/dist/workflow-engine.js +92 -1
  54. package/dist/workflow-engine.js.map +1 -1
  55. package/package.json +4 -4
package/dist/index.d.ts CHANGED
@@ -1,7 +1,8 @@
1
1
  export { topologicalSort, executeLevels } from "./dag.js";
2
2
  export { StepResolver } from "./step-resolver.js";
3
3
  export { WorkflowEngine } from "./workflow-engine.js";
4
+ export * from "./workers/index.js";
4
5
  export { classifyWorkflowFailure, getFailureSuggestedActions, } from "./failure-classifier.js";
5
6
  export type { WorkflowFailureClassification, WorkflowFailureSignal, } from "./failure-classifier.js";
6
- export type { StepHandler, StepContext, WorkflowEngineOptions, ResolvedStep, StepState, RunState, RunMetadata, HostActionState, HostActionRecord, RequestHostActionInput, FailHostActionInput, HostActionStore, WorkflowRunExecutionOptions, } from "./types.js";
7
+ export type { StepHandler, StepContext, WorkflowEngineOptions, ResolvedStep, StepState, RunState, RunMetadata, HostActionState, HostActionRecord, RequestHostActionInput, FailHostActionInput, HostActionStore, WorkflowWorkerStore, WorkflowRunExecutionOptions, } from "./types.js";
7
8
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}
package/dist/index.js CHANGED
@@ -1,5 +1,6 @@
1
1
  export { topologicalSort, executeLevels } from "./dag.js";
2
2
  export { StepResolver } from "./step-resolver.js";
3
3
  export { WorkflowEngine } from "./workflow-engine.js";
4
+ export * from "./workers/index.js";
4
5
  export { classifyWorkflowFailure, getFailureSuggestedActions, } from "./failure-classifier.js";
5
6
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}
package/dist/types.d.ts CHANGED
@@ -38,6 +38,35 @@ export interface HostActionStore {
38
38
  getHostAction(projectRoot: string, actionId: string): HostActionRecord | null | Promise<HostActionRecord | null>;
39
39
  failHostAction(input: FailHostActionInput): HostActionRecord | Promise<HostActionRecord>;
40
40
  }
41
+ export interface WorkflowWorkerStore {
42
+ createWorkflowWorker(input: {
43
+ runId: string;
44
+ stepId: string;
45
+ projectRoot: string;
46
+ branch: string;
47
+ worktreePath: string;
48
+ host: string;
49
+ contextReceipt: string;
50
+ retrievalSessionId?: string;
51
+ sessionId?: string;
52
+ executionId?: string;
53
+ baseRevision: string;
54
+ allowedFiles: string[];
55
+ handoff: Record<string, unknown>;
56
+ }): {
57
+ workerId: string;
58
+ state: string;
59
+ } | Promise<{
60
+ workerId: string;
61
+ state: string;
62
+ }>;
63
+ enqueueWork?(input: {
64
+ idempotencyKey: string;
65
+ kind: 'workflow.worker_start';
66
+ projectRoot: string;
67
+ payload: Record<string, unknown>;
68
+ }): unknown;
69
+ }
41
70
  export interface WorkflowRunExecutionOptions {
42
71
  telemetryRunId?: string;
43
72
  sessionId?: string;
@@ -72,6 +101,12 @@ export interface WorkflowEngineOptions extends Partial<Omit<StepContext, "sessio
72
101
  sessionId?: string;
73
102
  hostActionStore?: HostActionStore;
74
103
  truthfulWorkflow?: RolloutMode;
104
+ worktreeWorkers?: RolloutMode;
105
+ workerStore?: WorkflowWorkerStore;
106
+ workerHost?: 'claude-code' | 'codex';
107
+ workerHomeDir?: string;
108
+ revisionProvider?: (projectRoot: string) => string | Promise<string>;
109
+ retrievalSessionId?: string;
75
110
  now?: () => number;
76
111
  }
77
112
  export interface ResolvedStep {
@@ -89,6 +124,8 @@ export interface StepState {
89
124
  verifiedActionIds?: string[];
90
125
  evidenceHash?: string;
91
126
  shadowCandidate?: Record<string, unknown>;
127
+ workerId?: string;
128
+ workerSchedule?: Record<string, unknown>;
92
129
  error?: string;
93
130
  startedAt?: number;
94
131
  finishedAt?: number;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ import type { RetrievalGapKind } from '@devflow-tools/sdk';
2
+ export interface WorkerContextGap {
3
+ kind: RetrievalGapKind;
4
+ target?: string;
5
+ reason: string;
6
+ evidence?: string[];
7
+ }
8
+ export interface WorkerContextRefinementRequest {
9
+ workerId: string;
10
+ runId: string;
11
+ stepId: string;
12
+ projectRoot: string;
13
+ sessionId: string;
14
+ executionId: string;
15
+ retrievalSessionId: string;
16
+ baselineReceipt: string;
17
+ currentReceipt: string;
18
+ baseRevision: string;
19
+ query: string;
20
+ missingContext: WorkerContextGap[];
21
+ maxTokens?: number;
22
+ }
23
+ export interface WorkerContextRefinementResult {
24
+ workerId: string;
25
+ receipt: string;
26
+ cycle: number;
27
+ remainingTokenBudget: number;
28
+ selectedIds: string[];
29
+ rejectedIds: string[];
30
+ state: 'open' | 'satisfied' | 'exhausted' | 'expired';
31
+ }
32
+ export interface WorkerContextAdapter {
33
+ refine(request: WorkerContextRefinementRequest): Promise<WorkerContextRefinementResult>;
34
+ }
35
+ export interface WorkerContextAttribution {
36
+ workerId: string;
37
+ receipts: string[];
38
+ selectedIds: string[];
39
+ adoptedIds: string[];
40
+ outcome?: 'verified' | 'failed' | 'hold';
41
+ }
42
+ export declare class WorkerContextSessionController {
43
+ private readonly adapter;
44
+ private readonly revisionProvider;
45
+ private readonly state;
46
+ constructor(adapter: WorkerContextAdapter, revisionProvider: (projectRoot: string) => string | Promise<string>);
47
+ refine(request: WorkerContextRefinementRequest): Promise<WorkerContextRefinementResult>;
48
+ recordAdoption(workerId: string, receipt: string, adoptedIds: string[]): WorkerContextAttribution;
49
+ recordOutcome(workerId: string, outcome: 'verified' | 'failed' | 'hold'): WorkerContextAttribution;
50
+ getAttribution(workerId: string): WorkerContextAttribution | undefined;
51
+ }
52
+ //# sourceMappingURL=context-session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-session.d.ts","sourceRoot":"","sources":["../../src/workers/context-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;CACvD;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC1C;AAED,qBAAa,8BAA8B;IAIvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAJnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+C;gBAGlD,OAAO,EAAE,oBAAoB,EAC7B,gBAAgB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGhF,MAAM,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAuB7F,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,wBAAwB;IAUjG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,wBAAwB;IAQlG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS;CAIvE"}
@@ -0,0 +1,70 @@
1
+ export class WorkerContextSessionController {
2
+ adapter;
3
+ revisionProvider;
4
+ state = new Map();
5
+ constructor(adapter, revisionProvider) {
6
+ this.adapter = adapter;
7
+ this.revisionProvider = revisionProvider;
8
+ }
9
+ async refine(request) {
10
+ validateRefinementRequest(request);
11
+ const currentRevision = await this.revisionProvider(request.projectRoot);
12
+ if (currentRevision !== request.baseRevision)
13
+ throw new Error('WORKER_CONTEXT_STALE_BASE_REVISION');
14
+ const existing = this.state.get(request.workerId);
15
+ if (existing && existing.receipts.length > 0 && !existing.receipts.includes(request.currentReceipt)) {
16
+ throw new Error('WORKER_CONTEXT_RECEIPT_MISMATCH');
17
+ }
18
+ const result = await this.adapter.refine(request);
19
+ if (result.workerId !== request.workerId)
20
+ throw new Error('WORKER_CONTEXT_CROSS_WORKER_RESULT');
21
+ if (result.cycle < 1 || result.cycle > 3 || result.remainingTokenBudget < 0 || !result.receipt.trim()) {
22
+ throw new Error('WORKER_CONTEXT_INVALID_REFINEMENT_RESULT');
23
+ }
24
+ this.state.set(request.workerId, {
25
+ workerId: request.workerId,
26
+ receipts: [...new Set([...(existing?.receipts ?? []), request.currentReceipt, result.receipt])],
27
+ selectedIds: [...new Set([...(existing?.selectedIds ?? []), ...result.selectedIds])],
28
+ adoptedIds: existing?.adoptedIds ?? [],
29
+ outcome: existing?.outcome,
30
+ });
31
+ return result;
32
+ }
33
+ recordAdoption(workerId, receipt, adoptedIds) {
34
+ const existing = this.state.get(workerId);
35
+ if (!existing || !existing.receipts.includes(receipt))
36
+ throw new Error('WORKER_CONTEXT_ADOPTION_RECEIPT_MISMATCH');
37
+ const selected = new Set(existing.selectedIds);
38
+ if (adoptedIds.some(id => !selected.has(id)))
39
+ throw new Error('WORKER_CONTEXT_ADOPTION_NOT_SELECTED');
40
+ const updated = { ...existing, adoptedIds: [...new Set([...existing.adoptedIds, ...adoptedIds])] };
41
+ this.state.set(workerId, updated);
42
+ return updated;
43
+ }
44
+ recordOutcome(workerId, outcome) {
45
+ const existing = this.state.get(workerId);
46
+ if (!existing)
47
+ throw new Error('WORKER_CONTEXT_ATTRIBUTION_NOT_FOUND');
48
+ const updated = { ...existing, outcome };
49
+ this.state.set(workerId, updated);
50
+ return updated;
51
+ }
52
+ getAttribution(workerId) {
53
+ const value = this.state.get(workerId);
54
+ return value ? { ...value, receipts: [...value.receipts], selectedIds: [...value.selectedIds], adoptedIds: [...value.adoptedIds] } : undefined;
55
+ }
56
+ }
57
+ function validateRefinementRequest(request) {
58
+ for (const [field, value] of Object.entries({
59
+ workerId: request.workerId, runId: request.runId, stepId: request.stepId,
60
+ projectRoot: request.projectRoot, sessionId: request.sessionId, executionId: request.executionId,
61
+ retrievalSessionId: request.retrievalSessionId, baselineReceipt: request.baselineReceipt,
62
+ currentReceipt: request.currentReceipt, baseRevision: request.baseRevision, query: request.query,
63
+ })) {
64
+ if (!value.trim())
65
+ throw new Error(`WORKER_CONTEXT_REQUIRED:${field}`);
66
+ }
67
+ if (request.missingContext.length === 0)
68
+ throw new Error('WORKER_CONTEXT_GAP_REQUIRED');
69
+ }
70
+ //# sourceMappingURL=context-session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-session.js","sourceRoot":"","sources":["../../src/workers/context-session.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { WorkflowStepDef, StepInstruction } from '@devflow-tools/sdk';
2
+ export type OwnershipRisk = 'low' | 'high';
3
+ export interface FileOwnership {
4
+ exactFiles: string[];
5
+ directories: string[];
6
+ risk: OwnershipRisk;
7
+ reasons: string[];
8
+ }
9
+ type RuntimeStep = WorkflowStepDef | StepInstruction;
10
+ export declare function predictFileOwnership(step: RuntimeStep, input?: Record<string, unknown>): FileOwnership;
11
+ export declare function ownershipOverlaps(left: FileOwnership, right: FileOwnership): boolean;
12
+ export {};
13
+ //# sourceMappingURL=file-ownership.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-ownership.d.ts","sourceRoot":"","sources":["../../src/workers/file-ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE3E,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,KAAK,WAAW,GAAG,eAAe,GAAG,eAAe,CAAC;AAWrD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,aAAa,CA2B1G;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAKpF"}
@@ -0,0 +1,87 @@
1
+ const SERIAL_PATTERNS = [
2
+ /(^|\/)(package-lock\.json|npm-shrinkwrap\.json|pnpm-lock\.yaml|yarn\.lock)$/i,
3
+ /(^|\/)(package\.json|lerna\.json|nx\.json|tsconfig(?:\.[^/]+)?\.json)$/i,
4
+ /(^|\/)(migrations?|prisma)(\/|$)/i,
5
+ /(^|\/)(plugin-registry\.json|generated|dist)(\/|$)/i,
6
+ /(^|\/)(\.github|\.devflow|config)(\/|$)/i,
7
+ /(^|\/)(changelog|changeset|version)(\.|\/|$)/i,
8
+ ];
9
+ export function predictFileOwnership(step, input = {}) {
10
+ const candidates = new Set();
11
+ collectPaths(input, candidates);
12
+ if ('instruction' in step)
13
+ collectTextPaths(step.instruction, candidates);
14
+ if ('title' in step)
15
+ collectTextPaths(step.title, candidates);
16
+ if ('description' in step)
17
+ collectTextPaths(step.description, candidates);
18
+ const exactFiles = [];
19
+ const directories = [];
20
+ const reasons = [];
21
+ for (const raw of candidates) {
22
+ const path = normalizeOwnedPath(raw);
23
+ if (!path)
24
+ continue;
25
+ if (path.endsWith('/**') || path.endsWith('/'))
26
+ directories.push(path.replace(/\/\*\*$/, '').replace(/\/$/, ''));
27
+ else
28
+ exactFiles.push(path);
29
+ }
30
+ const all = [...exactFiles, ...directories];
31
+ if (all.length === 0)
32
+ reasons.push('unknown_file_scope');
33
+ for (const path of all) {
34
+ if (SERIAL_PATTERNS.some(pattern => pattern.test(path)))
35
+ reasons.push(`serialized_resource:${path}`);
36
+ }
37
+ return {
38
+ exactFiles: [...new Set(exactFiles)].sort(),
39
+ directories: [...new Set(directories)].sort(),
40
+ risk: reasons.length > 0 ? 'high' : 'low',
41
+ reasons: [...new Set(reasons)].sort(),
42
+ };
43
+ }
44
+ export function ownershipOverlaps(left, right) {
45
+ if (left.risk === 'high' || right.risk === 'high')
46
+ return true;
47
+ const leftPaths = [...left.exactFiles, ...left.directories];
48
+ const rightPaths = [...right.exactFiles, ...right.directories];
49
+ return leftPaths.some(leftPath => rightPaths.some(rightPath => pathOverlaps(leftPath, rightPath)));
50
+ }
51
+ function pathOverlaps(left, right) {
52
+ return left === right || left.startsWith(`${right}/`) || right.startsWith(`${left}/`);
53
+ }
54
+ function collectPaths(value, output, key = '', depth = 0) {
55
+ if (depth > 4 || value == null)
56
+ return;
57
+ if (typeof value === 'string') {
58
+ if (/file|path|target|scope|allow/i.test(key)) {
59
+ value.split(/[\n,]/).map(item => item.trim()).filter(Boolean).forEach(item => output.add(item));
60
+ }
61
+ else {
62
+ collectTextPaths(value, output);
63
+ }
64
+ return;
65
+ }
66
+ if (Array.isArray(value)) {
67
+ value.forEach(item => collectPaths(item, output, key, depth + 1));
68
+ return;
69
+ }
70
+ if (typeof value === 'object') {
71
+ for (const [childKey, childValue] of Object.entries(value)) {
72
+ collectPaths(childValue, output, childKey, depth + 1);
73
+ }
74
+ }
75
+ }
76
+ function collectTextPaths(text, output) {
77
+ const matches = text.match(/(?:^|[\s`'"(])((?:\.?[a-zA-Z0-9_-]+\/)+[a-zA-Z0-9_.*-]+\.[a-zA-Z0-9_-]+|(?:\.?[a-zA-Z0-9_-]+\/)+\*\*)/g) ?? [];
78
+ for (const match of matches)
79
+ output.add(match.trim().replace(/^[`'"(]+|[`'")]+$/g, ''));
80
+ }
81
+ function normalizeOwnedPath(value) {
82
+ const normalized = value.trim().replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/+/g, '/');
83
+ if (!normalized || normalized.startsWith('/') || normalized === '..' || normalized.startsWith('../'))
84
+ return null;
85
+ return normalized;
86
+ }
87
+ //# sourceMappingURL=file-ownership.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-ownership.js","sourceRoot":"","sources":["../../src/workers/file-ownership.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ import type { GitCommandResult, WorktreeDescriptor } from './types.js';
2
+ export interface GitRunnerOptions {
3
+ timeoutMs?: number;
4
+ maxOutputBytes?: number;
5
+ }
6
+ export declare function runGit(cwd: string, args: string[], options?: GitRunnerOptions): Promise<GitCommandResult>;
7
+ export declare function requireGitSuccess(cwd: string, args: string[], options?: GitRunnerOptions): Promise<GitCommandResult>;
8
+ export declare function resolveRepositoryRoot(cwd: string): Promise<string>;
9
+ export declare function gitRevision(cwd: string, revision?: string): Promise<string>;
10
+ export declare function gitStatus(cwd: string): Promise<string[]>;
11
+ export declare function gitChangedFiles(cwd: string, baseRevision: string, candidate?: string): Promise<string[]>;
12
+ export declare function gitMergeBase(cwd: string, left: string, right: string): Promise<string>;
13
+ export declare function simulateMerge(cwd: string, parent: string, candidate: string): Promise<GitCommandResult>;
14
+ export declare function createManagedWorktree(input: {
15
+ projectRoot: string;
16
+ runId: string;
17
+ stepId: string;
18
+ baseRevision?: string;
19
+ homeDir?: string;
20
+ registered: boolean;
21
+ }): Promise<WorktreeDescriptor>;
22
+ export declare function cleanupManagedWorktree(input: {
23
+ repositoryRoot: string;
24
+ worktreePath: string;
25
+ branch: string;
26
+ homeDir?: string;
27
+ registered: boolean;
28
+ handoffDurable: boolean;
29
+ }): Promise<{
30
+ cleaned: boolean;
31
+ reason?: string;
32
+ }>;
33
+ //# sourceMappingURL=git-worktree.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"git-worktree.d.ts","sourceRoot":"","sources":["../../src/workers/git-worktree.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,MAAM,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAsC3B;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAM1H;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjF;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG9D;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG9G;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5F;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAO7G;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwB9B;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAWjD"}
@@ -0,0 +1,121 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { existsSync, lstatSync, mkdirSync } from 'node:fs';
3
+ import { dirname, resolve } from 'node:path';
4
+ import { assertSafeWorkerPath, workerBranch, workerWorktreePath } from './paths.js';
5
+ export async function runGit(cwd, args, options = {}) {
6
+ if (!Array.isArray(args) || args.some(arg => typeof arg !== 'string' || arg.includes('\0'))) {
7
+ throw new Error('GIT_ARGUMENTS_INVALID');
8
+ }
9
+ const timeoutMs = Math.max(100, Math.min(options.timeoutMs ?? 30_000, 10 * 60_000));
10
+ const maxOutputBytes = Math.max(1_024, Math.min(options.maxOutputBytes ?? 512_000, 4_000_000));
11
+ return new Promise((resolvePromise, reject) => {
12
+ const child = spawn('git', args, { cwd, shell: false, stdio: ['ignore', 'pipe', 'pipe'] });
13
+ let stdout = Buffer.alloc(0);
14
+ let stderr = Buffer.alloc(0);
15
+ let truncated = false;
16
+ let timedOut = false;
17
+ const append = (target, chunk) => {
18
+ if (target.length >= maxOutputBytes) {
19
+ truncated = true;
20
+ return target;
21
+ }
22
+ const remaining = maxOutputBytes - target.length;
23
+ if (chunk.length > remaining)
24
+ truncated = true;
25
+ return Buffer.concat([target, chunk.subarray(0, remaining)]);
26
+ };
27
+ child.stdout.on('data', chunk => { stdout = append(stdout, Buffer.from(chunk)); });
28
+ child.stderr.on('data', chunk => { stderr = append(stderr, Buffer.from(chunk)); });
29
+ child.on('error', reject);
30
+ const timer = setTimeout(() => {
31
+ timedOut = true;
32
+ child.kill('SIGTERM');
33
+ setTimeout(() => child.kill('SIGKILL'), 2_000).unref();
34
+ }, timeoutMs);
35
+ timer.unref();
36
+ child.on('close', code => {
37
+ clearTimeout(timer);
38
+ resolvePromise({
39
+ command: 'git', args: [...args], cwd, exitCode: code ?? -1,
40
+ stdout: stdout.toString('utf8'), stderr: stderr.toString('utf8'), timedOut, truncated,
41
+ });
42
+ });
43
+ });
44
+ }
45
+ export async function requireGitSuccess(cwd, args, options) {
46
+ const result = await runGit(cwd, args, options);
47
+ if (result.exitCode !== 0 || result.timedOut) {
48
+ throw new Error(`GIT_COMMAND_FAILED:${args[0] ?? 'unknown'}:${result.stderr.trim().slice(0, 500)}`);
49
+ }
50
+ return result;
51
+ }
52
+ export async function resolveRepositoryRoot(cwd) {
53
+ const result = await requireGitSuccess(cwd, ['rev-parse', '--show-toplevel']);
54
+ return resolve(result.stdout.trim());
55
+ }
56
+ export async function gitRevision(cwd, revision = 'HEAD') {
57
+ return (await requireGitSuccess(cwd, ['rev-parse', '--verify', revision])).stdout.trim();
58
+ }
59
+ export async function gitStatus(cwd) {
60
+ const output = (await requireGitSuccess(cwd, ['status', '--porcelain=v1', '-z'])).stdout;
61
+ return output.split('\0').filter(Boolean);
62
+ }
63
+ export async function gitChangedFiles(cwd, baseRevision, candidate = 'HEAD') {
64
+ const output = (await requireGitSuccess(cwd, ['diff', '--name-only', '-z', `${baseRevision}...${candidate}`])).stdout;
65
+ return output.split('\0').filter(Boolean).sort();
66
+ }
67
+ export async function gitMergeBase(cwd, left, right) {
68
+ return (await requireGitSuccess(cwd, ['merge-base', left, right])).stdout.trim();
69
+ }
70
+ export async function simulateMerge(cwd, parent, candidate) {
71
+ const writeTree = await runGit(cwd, ['merge-tree', '--write-tree', parent, candidate], { maxOutputBytes: 1_000_000 });
72
+ if (writeTree.exitCode !== 129 && !/unknown option|usage:/i.test(writeTree.stderr))
73
+ return writeTree;
74
+ const base = await gitMergeBase(cwd, parent, candidate);
75
+ const fallback = await runGit(cwd, ['merge-tree', base, parent, candidate], { maxOutputBytes: 1_000_000 });
76
+ if (/^<{7}|^>{7}|changed in both/im.test(fallback.stdout))
77
+ return { ...fallback, exitCode: 1 };
78
+ return fallback;
79
+ }
80
+ export async function createManagedWorktree(input) {
81
+ if (!input.registered)
82
+ throw new Error('WORKTREE_DATABASE_RECORD_REQUIRED');
83
+ const repositoryRoot = await resolveRepositoryRoot(input.projectRoot);
84
+ const branch = workerBranch(input.runId, input.stepId);
85
+ const worktreePath = assertSafeWorkerPath(repositoryRoot, workerWorktreePath(repositoryRoot, input.runId, input.stepId, input.homeDir), input.homeDir);
86
+ if (existsSync(worktreePath))
87
+ throw new Error(`WORKTREE_PATH_EXISTS:${worktreePath}`);
88
+ mkdirSync(dirname(worktreePath), { recursive: true });
89
+ const baseRevision = await gitRevision(repositoryRoot, input.baseRevision ?? 'HEAD');
90
+ const branchCheck = await runGit(repositoryRoot, ['show-ref', '--verify', '--quiet', `refs/heads/${branch}`]);
91
+ if (branchCheck.exitCode === 0)
92
+ throw new Error(`WORKTREE_BRANCH_EXISTS:${branch}`);
93
+ try {
94
+ await requireGitSuccess(repositoryRoot, ['worktree', 'add', '-b', branch, worktreePath, baseRevision], { timeoutMs: 120_000 });
95
+ }
96
+ catch (error) {
97
+ if (existsSync(worktreePath) && !lstatSync(worktreePath).isSymbolicLink()) {
98
+ await runGit(repositoryRoot, ['worktree', 'remove', worktreePath]);
99
+ }
100
+ await runGit(repositoryRoot, ['branch', '-d', branch]);
101
+ throw error;
102
+ }
103
+ return { repositoryRoot, worktreePath, branch, baseRevision };
104
+ }
105
+ export async function cleanupManagedWorktree(input) {
106
+ if (!input.registered)
107
+ return { cleaned: false, reason: 'unregistered_worktree' };
108
+ assertSafeWorkerPath(input.repositoryRoot, input.worktreePath, input.homeDir);
109
+ if (!input.handoffDurable)
110
+ return { cleaned: false, reason: 'handoff_not_durable' };
111
+ if ((await gitStatus(input.worktreePath)).length > 0)
112
+ return { cleaned: false, reason: 'dirty_worktree' };
113
+ const merged = await runGit(input.repositoryRoot, ['branch', '--merged', 'HEAD', '--format=%(refname:short)']);
114
+ const mergedBranches = new Set(merged.stdout.split('\n').map(value => value.trim()).filter(Boolean));
115
+ if (!mergedBranches.has(input.branch))
116
+ return { cleaned: false, reason: 'branch_not_merged' };
117
+ await requireGitSuccess(input.repositoryRoot, ['worktree', 'remove', input.worktreePath], { timeoutMs: 120_000 });
118
+ await requireGitSuccess(input.repositoryRoot, ['branch', '-d', input.branch]);
119
+ return { cleaned: true };
120
+ }
121
+ //# sourceMappingURL=git-worktree.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"git-worktree.js","sourceRoot":"","sources":["../../src/workers/git-worktree.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { WorkerHandoff, WorkerTaskEnvelope } from './types.js';
2
+ export declare function writeJsonAtomic(path: string, value: unknown): void;
3
+ export declare function writeWorkerTask(path: string, envelope: WorkerTaskEnvelope): void;
4
+ export declare function readWorkerHandoff(path: string, expected: {
5
+ workerId: string;
6
+ runId: string;
7
+ stepId: string;
8
+ contextReceipt: string;
9
+ worktreePath: string;
10
+ }): WorkerHandoff;
11
+ //# sourceMappingURL=handoff.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/workers/handoff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIpE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAKlE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAGhF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,aAAa,CA8BhB"}
@@ -0,0 +1,64 @@
1
+ import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
2
+ import { dirname, isAbsolute, relative } from 'node:path';
3
+ const MAX_HANDOFF_BYTES = 1_000_000;
4
+ export function writeJsonAtomic(path, value) {
5
+ mkdirSync(dirname(path), { recursive: true });
6
+ const temporary = `${path}.${process.pid}.${Date.now()}.tmp`;
7
+ writeFileSync(temporary, `${JSON.stringify(value, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
8
+ renameSync(temporary, path);
9
+ }
10
+ export function writeWorkerTask(path, envelope) {
11
+ validateWorkerTask(envelope);
12
+ writeJsonAtomic(path, envelope);
13
+ }
14
+ export function readWorkerHandoff(path, expected) {
15
+ const raw = readFileSync(path);
16
+ if (raw.length > MAX_HANDOFF_BYTES)
17
+ throw new Error('WORKER_HANDOFF_TOO_LARGE');
18
+ let value;
19
+ try {
20
+ value = JSON.parse(raw.toString('utf8'));
21
+ }
22
+ catch {
23
+ throw new Error('WORKER_HANDOFF_INVALID_JSON');
24
+ }
25
+ if (!value || typeof value !== 'object' || Array.isArray(value))
26
+ throw new Error('WORKER_HANDOFF_INVALID');
27
+ const handoff = value;
28
+ for (const [field, actual, wanted] of [
29
+ ['workerId', handoff.workerId, expected.workerId],
30
+ ['runId', handoff.runId, expected.runId],
31
+ ['stepId', handoff.stepId, expected.stepId],
32
+ ['contextReceipt', handoff.contextReceipt, expected.contextReceipt],
33
+ ]) {
34
+ if (actual !== wanted)
35
+ throw new Error(`WORKER_HANDOFF_MISMATCH:${field}`);
36
+ }
37
+ if (!['completed', 'failed', 'cancelled', 'timed_out'].includes(handoff.hostStatus)) {
38
+ throw new Error('WORKER_HANDOFF_INVALID_STATUS');
39
+ }
40
+ if (!handoff.baseRevision?.trim() || !handoff.finalRevision?.trim() || !handoff.summary?.trim()) {
41
+ throw new Error('WORKER_HANDOFF_MISSING_EVIDENCE');
42
+ }
43
+ for (const field of ['changedFiles', 'toolReceipts', 'reportReceipts', 'verificationIntent']) {
44
+ if (!Array.isArray(handoff[field]) || handoff[field].some(value => typeof value !== 'string')) {
45
+ throw new Error(`WORKER_HANDOFF_INVALID_FIELD:${field}`);
46
+ }
47
+ }
48
+ for (const file of handoff.changedFiles) {
49
+ if (isAbsolute(file) || relative('.', file).startsWith('..'))
50
+ throw new Error(`WORKER_HANDOFF_PATH_ESCAPE:${file}`);
51
+ }
52
+ return handoff;
53
+ }
54
+ function validateWorkerTask(envelope) {
55
+ if (!envelope.workerId.trim() || !envelope.contextReceipt.trim() || !envelope.baseRevision.trim()) {
56
+ throw new Error('WORKER_TASK_IDENTITY_REQUIRED');
57
+ }
58
+ if (envelope.constraints.recursiveWorkers !== false)
59
+ throw new Error('WORKER_RECURSION_MUST_BE_DISABLED');
60
+ if (envelope.allowedFiles.some(path => isAbsolute(path) || relative('.', path).startsWith('..'))) {
61
+ throw new Error('WORKER_TASK_ALLOWED_PATH_ESCAPE');
62
+ }
63
+ }
64
+ //# sourceMappingURL=handoff.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../src/workers/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1D,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpC,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAc;IAC1D,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IAC7D,aAAa,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnG,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAA4B;IACxE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC7B,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAM/C;IACC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,CAAC,MAAM,GAAG,iBAAiB;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAChF,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAAC,CAAC;IAC3G,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC3G,MAAM,OAAO,GAAG,KAAsB,CAAC;IACvC,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI;QACpC,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;QACjD,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC;QACxC,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;QAC3C,CAAC,gBAAgB,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC;KACpE,EAAE,CAAC;QACF,IAAI,MAAM,KAAK,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,CAAC,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,CAAU,EAAE,CAAC;QACtG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC9F,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACxC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;IACtH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,QAA4B;IACtD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;QAClG,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,QAAQ,CAAC,WAAW,CAAC,gBAAgB,KAAK,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC1G,IAAI,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACjG,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}