@auto-engineer/pipeline 1.113.0 → 1.114.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @auto-engineer/pipeline@1.113.0 build /home/runner/work/auto-engineer/auto-engineer/packages/pipeline
+> @auto-engineer/pipeline@1.114.0 build /home/runner/work/auto-engineer/auto-engineer/packages/pipeline
 > tsc && tsx ../../scripts/fix-esm-imports.ts
 
 Fixed ESM imports in dist/

package/.turbo/turbo-test.log

@@ -1,5 +1,5 @@
 
-> @auto-engineer/pipeline@1.112.2 test /home/runner/work/auto-engineer/auto-engineer/packages/pipeline
+> @auto-engineer/pipeline@1.113.0 test /home/runner/work/auto-engineer/auto-engineer/packages/pipeline
 > vitest run --reporter=dot
 
 
@@ -9,6 +9,6 @@
 
  Test Files  42 passed (42)
       Tests  582 passed (582)
-   Start at  01:38:58
-   Duration  48.37s (transform 10.59s, setup 0ms, collect 21.13s, tests 40.11s, environment 55ms, prepare 33.75s)
+   Start at  05:52:09
+   Duration  42.70s (transform 8.47s, setup 0ms, collect 17.61s, tests 35.30s, environment 29ms, prepare 29.72s)
 

package/.turbo/turbo-type-check.log

@@ -1,4 +1,4 @@
 
-> @auto-engineer/pipeline@1.112.2 type-check /home/runner/work/auto-engineer/auto-engineer/packages/pipeline
+> @auto-engineer/pipeline@1.113.0 type-check /home/runner/work/auto-engineer/auto-engineer/packages/pipeline
 > tsc --noEmit
 

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @auto-engineer/pipeline
 
+## 1.114.0
+
+### Minor Changes
+
+- [`9570b75`](https://github.com/BeOnAuto/auto-engineer/commit/9570b75c9312b6b714e8be89960a5ee7de2d8d48) Thanks [@github-actions[bot]](https://github.com/github-actions%5Bbot%5D)! - - **global**: imrpoves ui generation pipeline
+  - **component-implementor-react**: rewrite pipeline with parallel gen, fix loops, and evaluation
+  - **component-implementor-react**: add test-generation agent
+  - **component-implementor-react**: add test-fix agent and loop
+  - **component-implementor-react**: add evaluation agent
+
+### Patch Changes
+
+- [`cae4cf2`](https://github.com/BeOnAuto/auto-engineer/commit/cae4cf2f82d363ea696bd6cf9f10d5d35364659f) Thanks [@SamHatoum](https://github.com/SamHatoum)! - - Removed internal planning files from the repository
+
+- Updated dependencies [[`9570b75`](https://github.com/BeOnAuto/auto-engineer/commit/9570b75c9312b6b714e8be89960a5ee7de2d8d48), [`cae4cf2`](https://github.com/BeOnAuto/auto-engineer/commit/cae4cf2f82d363ea696bd6cf9f10d5d35364659f)]:
+  - @auto-engineer/file-store@1.114.0
+  - @auto-engineer/message-bus@1.114.0
+
 ## 1.113.0
 
 ### Minor Changes

package/package.json

@@ -14,8 +14,8 @@
     "get-port": "^7.1.0",
     "jose": "^5.9.6",
     "nanoid": "^5.0.0",
-    "@auto-engineer/file-store": "1.113.0",
-    "@auto-engineer/message-bus": "1.113.0"
+    "@auto-engineer/file-store": "1.114.0",
+    "@auto-engineer/message-bus": "1.114.0"
   },
   "devDependencies": {
     "@types/cors": "^2.8.17",
@@ -24,7 +24,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.113.0",
+  "version": "1.114.0",
   "scripts": {
     "build": "tsc && tsx ../../scripts/fix-esm-imports.ts",
     "test": "vitest run --reporter=dot",

package/ketchup-plan.md

@@ -1,1269 +0,0 @@
-# Pipeline Package - Ketchup Plan
-
-## TODO
-
-### Fix Settled Node Labels and Event Routing (Bursts 107-112)
-
-- [x] Burst 107: processSettledHandler uses descriptor.label for graph node [depends: none]
-- [x] Burst 108: bridge filters commands by sourceEventTypes [depends: none]
-- [x] Burst 109: builder sets sourceEventTypes from emit chain event type [depends: none]
-- [x] Burst 110: Add label and sourceEventTypes to descriptor and builder (merged into 107+109)
-- [x] Burst 111: Add source event filtering to bridge (merged into 108)
-- [x] Burst 112: Thread source event type through pipeline server [depends: 110, 111]
-
-### Graph Rendering Fix (Burst 106)
-
-- [ ] Burst 106: Show source commands whose events are listened to by the pipeline [depends: none]
-
-### Phase 11: 100% Test Coverage (Bursts 93-102)
-
-**Goal**: Achieve 100% test coverage by testing uncovered code or removing dead code.
-
-**Current Coverage**: 96.53% lines, 97.13% branches, 94.94% functions
-
----
-
-#### Burst 93: Exclude barrel exports from coverage
-
-| Value | Remove false positives from coverage report |
-| Approach | Change `src/index.ts` to `src/**/index.ts` in vitest.config.ts |
-| Size | S |
-
----
-
-#### Burst 94: Test config/pipeline-config.ts
-
-| Value | 0% → 100% coverage for config module |
-| Approach | Test pipelineConfig() identity fn and loadPipelineConfig() with mocked loader |
-| Size | M |
-
-```typescript
-it('should return config unchanged', () => {
-  const config = { plugins: [], pipeline: mockPipeline };
-  expect(pipelineConfig(config)).toBe(config);
-});
-
-it('should load plugins and adapt handlers', async () => {
-  const config = { plugins: ['./test-plugin'], pipeline: mockPipeline };
-  const result = await loadPipelineConfig(config, '/workspace');
-  expect(result.handlers).toBeDefined();
-  expect(result.pipeline).toBe(mockPipeline);
-});
-```
-
----
-
-#### Burst 95: Test filter-graph.ts addEdgeIfNew (lines 63-69)
-
-| Value | Cover duplicate edge scenario |
-| Approach | Test graph with duplicate edges when maintainEdges=true |
-| Size | S |
-
-```typescript
-it('should deduplicate edges when reconnecting', () => {
-  const graph = {
-    nodes: [{ id: 'a', type: 'command', label: 'A' }, { id: 'b', type: 'event', label: 'B' }, { id: 'c', type: 'command', label: 'C' }],
-    edges: [{ from: 'a', to: 'b' }, { from: 'a', to: 'b' }] // Duplicate
-  };
-  const result = filterGraph(graph, { excludeTypes: [], maintainEdges: true });
-  // Edges should be deduplicated
-});
-```
-
----
-
-#### Burst 96: Test await-tracker-projection.ts null document errors (lines 48-49, 60-61)
-
-| Value | Cover error paths |
-| Approach | Test evolve() throws when applying events to null document |
-| Size | S |
-
-```typescript
-it('should throw when applying AwaitItemCompleted to null', () => {
-  expect(() => evolve(null, { type: 'AwaitItemCompleted', data: { correlationId: 'c1', key: 'k', result: {} } }))
-    .toThrow('Cannot apply AwaitItemCompleted to null document');
-});
-
-it('should throw when applying AwaitCompleted to null', () => {
-  expect(() => evolve(null, { type: 'AwaitCompleted', data: { correlationId: 'c1' } }))
-    .toThrow('Cannot apply AwaitCompleted to null document');
-});
-```
-
----
-
-#### Burst 97: Remove or test phased-executor.ts getActiveSessionCount (lines 99-101)
-
-| Value | Remove dead code or add test |
-| Approach | Check if used; if not, remove; if used, test |
-| Size | S |
-
----
-
-#### Burst 98: Test pipeline-runtime.ts fallback path (line 46)
-
-| Value | Cover when ctx.startPhased is undefined |
-| Approach | Call handleEvent with context missing startPhased |
-| Size | S |
-
-```typescript
-it('should fallback to executeForEachPhasedHandler when ctx.startPhased undefined', async () => {
-  const ctx = { correlationId: 'c1', emit: vi.fn(), sendCommand: vi.fn() }; // No startPhased
-  await runtime.handleEvent(event, ctx);
-  expect(ctx.sendCommand).toHaveBeenCalled(); // Fallback dispatched commands
-});
-```
-
----
-
-#### Burst 99: Remove or test settled-tracker.ts getRegisteredHandlerCount (lines 62-63)
-
-| Value | Remove dead code or add test |
-| Approach | Check if used; if not, remove; if used, test |
-| Size | S |
-
----
-
-#### Burst 100: Test sse-manager.ts clientCount getter (lines 14-15)
-
-| Value | Cover getter or remove if dead |
-| Approach | Check usage; test or remove |
-| Size | S |
-
-```typescript
-it('should return client count', () => {
-  const manager = new SSEManager();
-  expect(manager.clientCount).toBe(0);
-  manager.addClient('c1', mockResponse);
-  expect(manager.clientCount).toBe(1);
-});
-```
-
----
-
-#### Burst 101: Test pipeline-read-model.ts line 79 branch
-
-| Value | Cover endedCount === 0 with no pending items |
-| Approach | Create scenario where items exist but all are running then all complete to idle |
-| Size | S |
-
----
-
-#### Burst 102: Final verification - run coverage, all at 100%
-
-| Value | Confirm 100% coverage achieved |
-| Approach | Run pnpm test:coverage, verify all thresholds pass |
-| Size | S |
-
----
-
-### Phase 10: SQLite Event Store Persistence (Bursts 88-92)
-
-**Goal**: Replace in-memory event store with SQLite for persistence. Events survive restarts; projections rebuilt from event stream on startup.
-
-**Current State**:
-```
-In-Memory EventStore → In-Memory Projections → Lost on restart
-```
-
-**Target State**:
-```
-SQLite EventStore → Consumer → In-Memory Projections (rebuilt on startup)
-```
-
----
-
-#### Burst 88: Async createPipelineEventStore with config
-
-| Value | Enable async initialization and configurable file path |
-| Approach | Make createPipelineEventStore async, accept optional config |
-| Size | S |
-
-```typescript
-it('should create event store with default config', async () => {
-  const context = await createPipelineEventStore();
-  expect(context.eventStore).toBeDefined();
-  expect(context.readModel).toBeDefined();
-  await context.close();
-});
-
-it('should accept custom fileName config', async () => {
-  const context = await createPipelineEventStore({ fileName: ':memory:' });
-  expect(context.eventStore).toBeDefined();
-  await context.close();
-});
-```
-
----
-
-#### Burst 89: SQLite event store with schema auto-migration
-
-| Value | Events persist to SQLite file |
-| Approach | Replace getInMemoryEventStore with getSQLiteEventStore |
-| Size | M |
-
-```typescript
-it('should persist events to SQLite', async () => {
-  const context = await createPipelineEventStore({ fileName: ':memory:' });
-  await context.eventStore.appendToStream('test-stream', [
-    { type: 'TestEvent', data: { value: 42 } }
-  ]);
-  const stream = await context.eventStore.readStream('test-stream');
-  expect(stream.events).toHaveLength(1);
-  await context.close();
-});
-```
-
----
-
-#### Burst 90: Consumer replays events to projections
-
-| Value | Projections rebuilt from event stream on startup |
-| Approach | Consumer with projection-updater processor from BEGINNING |
-| Size | M |
-
-```typescript
-it('should replay events to projections on startup', async () => {
-  const context = await createPipelineEventStore({ fileName: ':memory:' });
-  await context.eventStore.appendToStream('pipeline-c1', [
-    { type: 'ItemStatusChanged', data: { correlationId: 'c1', commandType: 'Cmd', itemKey: 'k1', requestId: 'r1', status: 'running', attemptCount: 1 } }
-  ]);
-  // Allow consumer to process
-  await new Promise(resolve => setTimeout(resolve, 50));
-  const item = await context.readModel.getItemStatus('c1', 'Cmd', 'k1');
-  expect(item?.status).toBe('running');
-  await context.close();
-});
-```
-
----
-
-#### Burst 91: close() stops and closes consumer
-
-| Value | Clean shutdown without resource leaks |
-| Approach | Call consumer.stop() and consumer.close() in close() |
-| Size | S |
-
-```typescript
-it('should stop consumer on close', async () => {
-  const context = await createPipelineEventStore({ fileName: ':memory:' });
-  await context.close();
-  // No error means success - consumer stopped cleanly
-});
-```
-
----
-
-#### Burst 92: PipelineServer uses async factory
-
-| Value | Server initializes SQLite event store |
-| Approach | Static PipelineServer.create() factory, configurable fileName |
-| Size | M |
-| Files | `src/server/pipeline-server.ts` |
-
-```typescript
-it('should create server with async event store initialization', async () => {
-  const server = await PipelineServer.create({ port: 0 });
-  expect(server.port).toBeGreaterThan(0);
-  await server.stop();
-});
-```
-
----
-
-### Phase 9: Remove Dual Caches - Pure Event Sourcing (Bursts 71-87)
-
-**Goal**: Remove `nodeStatusCache` and `itemStatusCache` from PipelineServer. All runtime state derived from Emmett projections via `PipelineReadModel`.
-
-**Current State** (dual source of truth):
-
-```
-Commands → Cache (mutable) + Emmett Events → Projections
-                  ↓                              ↓
-          Used for lookups              Also stores same data
-```
-
-**Target State** (single source of truth):
-
-```
-Commands → Emmett Events → Projections → ReadModel queries
-```
-
----
-
-#### Burst 71: Add getNodeStatus query (test)
-
-| Value | Query node status from projection |
-| Approach | `getNodeStatus(correlationId, commandName)` returns status or null |
-| Size | S |
-
-```typescript
-it("should return null when no node status exists", async () => {
-  const result = await readModel.getNodeStatus("c1", "CreateUser");
-  expect(result).toBeNull();
-});
-
-it("should return node status from NodeStatus collection", async () => {
-  const collection =
-    database.collection<WithId<NodeStatusDocument>>("NodeStatus");
-  await collection.insertOne({
-    _id: "ns-c1-CreateUser",
-    correlationId: "c1",
-    commandName: "CreateUser",
-    status: "running",
-    pendingCount: 1,
-    endedCount: 0,
-  });
-
-  const result = await readModel.getNodeStatus("c1", "CreateUser");
-  expect(result).toEqual({
-    correlationId: "c1",
-    commandName: "CreateUser",
-    status: "running",
-    pendingCount: 1,
-    endedCount: 0,
-  });
-});
-```
-
----
-
-#### Burst 72: Add getNodeStatus query (implement)
-
-| Value | Can query node status from projection |
-| Approach | Query NodeStatus collection with filter |
-| Size | S |
-| Files | `src/store/pipeline-read-model.ts` |
-
----
-
-#### Burst 73: Add getItemStatus query (test)
-
-| Value | Query item status from projection |
-| Approach | `getItemStatus(correlationId, commandType, itemKey)` returns ItemStatusDocument or null |
-| Size | S |
-
-```typescript
-it("should return null when no item status exists", async () => {
-  const result = await readModel.getItemStatus("c1", "CreateUser", "item1");
-  expect(result).toBeNull();
-});
-
-it("should return item status from ItemStatus collection", async () => {
-  const collection =
-    database.collection<WithId<ItemStatusDocument>>("ItemStatus");
-  await collection.insertOne({
-    _id: "is-c1-CreateUser-item1",
-    correlationId: "c1",
-    commandType: "CreateUser",
-    itemKey: "item1",
-    currentRequestId: "r1",
-    status: "running",
-    attemptCount: 1,
-  });
-
-  const result = await readModel.getItemStatus("c1", "CreateUser", "item1");
-  expect(result).toMatchObject({
-    correlationId: "c1",
-    commandType: "CreateUser",
-    itemKey: "item1",
-    attemptCount: 1,
-  });
-});
-```
-
----
-
-#### Burst 74: Add getItemStatus query (implement)
-
-| Value | Can query item status from projection |
-| Approach | Query ItemStatus collection with filter |
-| Size | S |
-| Files | `src/store/pipeline-read-model.ts` |
-
----
-
-#### Burst 75: Replace previousStatus lookup (test)
-
-| Value | Get previousStatus from projection instead of cache |
-| Approach | Verify `updateNodeStatus` emits correct previousStatus |
-| Size | M |
-
-Existing tests should pass with projection-based previousStatus lookup.
-
----
-
-#### Burst 76: Replace previousStatus lookup (implement)
-
-| Value | Remove nodeStatusCache usage in updateNodeStatus |
-| Approach | Query `readModel.getNodeStatus()` for previousStatus |
-| Size | M |
-| Files | `src/server/pipeline-server.ts` lines 468-478 |
-
-```typescript
-private async updateNodeStatus(correlationId: string, commandName: string, status: NodeStatus): Promise<void> {
-  const existing = await this.eventStoreContext.readModel.getNodeStatus(correlationId, commandName);
-  const previousStatus: NodeStatus = existing?.status ?? 'idle';
-  await this.emitNodeStatusChanged(correlationId, commandName, status, previousStatus);
-  await this.broadcastNodeStatusChanged(correlationId, commandName, status, previousStatus);
-}
-```
-
----
-
-#### Burst 77: Replace hasCorrelation check (test)
-
-| Value | Detect new correlationId via projection |
-| Approach | Test that PipelineRunStarted is emitted only for new correlationIds |
-| Size | M |
-
-Existing broadcast tests should pass with projection-based detection.
-
----
-
-#### Burst 78: Replace hasCorrelation check (implement)
-
-| Value | Remove nodeStatusCache.has() check |
-| Approach | Use `readModel.hasCorrelation()` instead |
-| Size | M |
-| Files | `src/server/pipeline-server.ts` line 874 |
-
-```typescript
-const isNewCorrelationId =
-  !(await this.eventStoreContext.readModel.hasCorrelation(
-    command.correlationId
-  ));
-```
-
----
-
-#### Burst 79: Replace item creation/update logic (test)
-
-| Value | Get/create item status from projection |
-| Approach | Test item creation with correct attemptCount from projection |
-| Size | M |
-
-```typescript
-it("should increment attemptCount on retry", async () => {
-  // First command creates item with attemptCount=1
-  // Second command (same itemKey) should have attemptCount=2
-});
-```
-
----
-
-#### Burst 80: Replace item creation/update logic (implement)
-
-| Value | Remove itemStatusCache from getOrCreateItemStatus |
-| Approach | Query projection for existing item, derive attemptCount |
-| Size | M |
-| Files | `src/server/pipeline-server.ts` lines 520-565 |
-
-```typescript
-private async getOrCreateItemStatus(
-  correlationId: string,
-  commandType: string,
-  itemKey: string,
-  requestId: string,
-): Promise<{ attemptCount: number }> {
-  const existing = await this.eventStoreContext.readModel.getItemStatus(correlationId, commandType, itemKey);
-  const attemptCount = (existing?.attemptCount ?? 0) + 1;
-
-  await this.emitItemStatusChanged(
-    correlationId,
-    commandType,
-    itemKey,
-    requestId,
-    'running',
-    attemptCount,
-  );
-
-  return { attemptCount };
-}
-```
-
----
-
-#### Burst 81: Replace item update logic (test)
-
-| Value | Update item status via events only |
-| Approach | Test item status update emits event with correct data |
-| Size | S |
-
-Existing tests should pass with event-only updates.
-
----
-
-#### Burst 82: Replace item update logic (implement)
-
-| Value | Remove itemStatusCache from updateItemStatus |
-| Approach | Query projection for currentRequestId and attemptCount, emit event |
-| Size | S |
-| Files | `src/server/pipeline-server.ts` lines 567-591 |
-
-```typescript
-private async updateItemStatus(
-  correlationId: string,
-  commandType: string,
-  itemKey: string,
-  status: 'running' | 'success' | 'error',
-): Promise<void> {
-  const existing = await this.eventStoreContext.readModel.getItemStatus(correlationId, commandType, itemKey);
-  if (existing !== null) {
-    await this.emitItemStatusChanged(
-      correlationId,
-      commandType,
-      itemKey,
-      existing.currentRequestId,
-      status,
-      existing.attemptCount,
-    );
-  }
-}
-```
-
----
-
-#### Burst 83: Remove nodeStatusCache field
-
-| Value | Single source of truth |
-| Approach | Delete the field declaration |
-| Size | S |
-| Files | `src/server/pipeline-server.ts` line 465 |
-
----
-
-#### Burst 84: Remove itemStatusCache field
-
-| Value | Single source of truth |
-| Approach | Delete the field declaration |
-| Size | S |
-| Files | `src/server/pipeline-server.ts` line 466 |
-
----
-
-#### Burst 85: Remove ItemStatus interface (if unused)
-
-| Value | Clean up dead code |
-| Approach | Delete if no longer referenced |
-| Size | S |
-| Files | `src/server/pipeline-server.ts` lines 44-51 |
-
----
-
-#### Burst 86: Remove latestCorrelationId field
-
-| Value | Derive from LatestRunProjection |
-| Approach | Query LatestRun projection instead |
-| Size | S |
-| Files | `src/server/pipeline-server.ts` lines 67, 877 |
-
----
-
-#### Burst 87: Final verification and cleanup
-
-| Value | All tests pass, no dual state |
-| Approach | Run full test suite, verify 100% coverage |
-| Size | M |
-
-**Success Criteria:**
-
-1. ✅ `nodeStatusCache` field removed
-2. ✅ `itemStatusCache` field removed
-3. ✅ `ItemStatus` interface removed (if unused)
-4. ✅ `latestCorrelationId` derived from projection
-5. ✅ All state queries go through `PipelineReadModel`
-6. ✅ All tests pass with 100% coverage
-7. ✅ No mutable Maps tracking runtime state in PipelineServer
-
----
-
-### Phase 3: Phased Execution Pattern (Bursts 27-34)
-
-#### Burst 27: ForEachBuilder Interface & TriggerBuilder.forEach()
-
-| Value | Entry point to phased execution pattern |
-| Approach | TriggerBuilder.forEach() returns ForEachBuilder |
-| Size | S |
-
-```typescript
-it("should return ForEachBuilder from TriggerBuilder.forEach()", () => {
-  type ItemsEvent = { data: { items: Array<{ id: string }> } };
-  const builder = define("test")
-    .on("ItemsReady")
-    .forEach((e: ItemsEvent) => e.data.items);
-
-  expect(builder).toBeDefined();
-  expect(typeof builder.groupInto).toBe("function");
-});
-```
-
----
-
-#### Burst 28: ForEachBuilder.groupInto() with phases
-
-| Value | Define execution phases for items |
-| Approach | groupInto() accepts phase names and classifier |
-| Size | M |
-
-```typescript
-it("should configure phases with groupInto()", () => {
-  type Item = { id: string; type: "critical" | "normal" };
-  const pipeline = define("test")
-    .on("ItemsReady")
-    .forEach((e: { data: { items: Item[] } }) => e.data.items)
-    .groupInto(["critical", "normal"], (item: Item) => item.type)
-    .process("ProcessItem", (item: Item) => ({ itemId: item.id }))
-    .build();
-
-  const handler = pipeline.descriptor.handlers[0] as ForEachPhasedDescriptor;
-  expect(handler.phases).toEqual(["critical", "normal"]);
-});
-```
-
----
-
-#### Burst 29: PhasedBuilder.process() with emit factory
-
-| Value | Define command emission for each item |
-| Approach | process() accepts commandType and data factory |
-| Size | S |
-
-```typescript
-it("should configure emitFactory with process()", () => {
-  type Item = { id: string };
-  const pipeline = define("test")
-    .on("ItemsReady")
-    .forEach((e: { data: { items: Item[] } }) => e.data.items)
-    .groupInto(["phase1"], () => "phase1")
-    .process("ProcessItem", (item: Item) => ({ itemId: item.id }))
-    .build();
-
-  const handler = pipeline.descriptor.handlers[0] as ForEachPhasedDescriptor;
-  expect(typeof handler.emitFactory).toBe("function");
-});
-```
-
----
-
-#### Burst 30: PhasedBuilder.stopOnFailure()
-
-| Value | Configure failure behavior |
-| Approach | stopOnFailure() sets flag in descriptor |
-| Size | S |
-
-```typescript
-it("should set stopOnFailure flag", () => {
-  const pipeline = define("test")
-    .on("ItemsReady")
-    .forEach((e: { data: { items: unknown[] } }) => e.data.items)
-    .groupInto(["phase1"], () => "phase1")
-    .process("ProcessItem", () => ({}))
-    .stopOnFailure()
-    .build();
-
-  const handler = pipeline.descriptor.handlers[0] as ForEachPhasedDescriptor;
-  expect(handler.stopOnFailure).toBe(true);
-});
-```
-
----
-
-#### Burst 31: PhasedBuilder.onComplete()
-
-| Value | Configure completion events |
-| Approach | onComplete() sets success/failure event types |
-| Size | M |
-
-```typescript
-it("should configure completion events", () => {
-  type Item = { id: string };
-  const pipeline = define("test")
-    .on("ItemsReady")
-    .forEach((e: { data: { items: Item[] } }) => e.data.items)
-    .groupInto(["phase1"], () => "phase1")
-    .process("ProcessItem", (item: Item) => ({ itemId: item.id }))
-    .onComplete({
-      success: "AllItemsProcessed",
-      failure: "ProcessingFailed",
-      itemKey: (e: { data: { itemId: string } }) => e.data.itemId,
-    })
-    .build();
-
-  const handler = pipeline.descriptor.handlers[0] as ForEachPhasedDescriptor;
-  expect(handler.completion.successEvent).toBe("AllItemsProcessed");
-  expect(handler.completion.failureEvent).toBe("ProcessingFailed");
-});
-```
-
----
-
-#### Burst 32: Chaining from PhasedBuilder
-
-| Value | Continue pipeline definition after phased |
-| Approach | PhasedBuilder returns to chain |
-| Size | S |
-
-```typescript
-it("should chain on() from PhasedBuilder", () => {
-  const pipeline = define("test")
-    .on("ItemsReady")
-    .forEach((e: { data: { items: unknown[] } }) => e.data.items)
-    .groupInto(["phase1"], () => "phase1")
-    .process("ProcessItem", () => ({}))
-    .onComplete({ success: "Done", failure: "Failed", itemKey: () => "" })
-    .on("Done")
-    .emit("Notify", {})
-    .build();
-
-  expect(pipeline.descriptor.handlers).toHaveLength(2);
-});
-```
-
----
-
-#### Burst 33: Default stopOnFailure behavior
-
-| Value | Sensible defaults |
-| Approach | stopOnFailure defaults to false |
-| Size | S |
-
-```typescript
-it("should default stopOnFailure to false", () => {
-  const pipeline = define("test")
-    .on("ItemsReady")
-    .forEach((e: { data: { items: unknown[] } }) => e.data.items)
-    .groupInto(["phase1"], () => "phase1")
-    .process("ProcessItem", () => ({}))
-    .onComplete({ success: "Done", failure: "Failed", itemKey: () => "" })
-    .build();
-
-  const handler = pipeline.descriptor.handlers[0] as ForEachPhasedDescriptor;
-  expect(handler.stopOnFailure).toBe(false);
-});
-```
-
----
-
-#### Burst 34: Phase 3 Integration Test
-
-| Value | Validate complete phased pipeline |
-| Approach | Integration test with realistic scenario |
-| Size | M |
-
-```typescript
-it("should create complete phased execution pipeline", () => {
-  type Component = { path: string; priority: "high" | "medium" | "low" };
-  type ComponentEvent = { data: { components: Component[] } };
-
-  const pipeline = define("component-processor")
-    .version("1.0.0")
-    .description("Process components in priority phases")
-    .on("ComponentsGenerated")
-    .when((e: ComponentEvent) => e.data.components.length > 0)
-    .forEach((e: ComponentEvent) => e.data.components)
-    .groupInto(["high", "medium", "low"], (c: Component) => c.priority)
-    .process("ImplementComponent", (c: Component) => ({
-      componentPath: c.path,
-    }))
-    .stopOnFailure()
-    .onComplete({
-      success: "AllComponentsImplemented",
-      failure: "ComponentImplementationFailed",
-      itemKey: (e: { data: { componentPath: string } }) => e.data.componentPath,
-    })
-    .build();
-
-  expect(pipeline.descriptor.name).toBe("component-processor");
-  const handler = pipeline.descriptor.handlers[0] as ForEachPhasedDescriptor;
-  expect(handler.type).toBe("foreach-phased");
-  expect(handler.phases).toEqual(["high", "medium", "low"]);
-  expect(handler.stopOnFailure).toBe(true);
-});
-```
-
----
-
-### Phase 4: Custom Handlers (Bursts 35-37)
-
-#### Burst 35: TriggerBuilder.handle() basic
-
-| Value | Escape hatch for imperative logic |
-| Approach | handle() accepts async handler function |
-| Size | S |
-
-```typescript
-it("should capture custom handler", () => {
-  const handler = async (e: { data: unknown }) => {
-    console.log(e);
-  };
-  const pipeline = define("test").on("CustomEvent").handle(handler).build();
-
-  const desc = pipeline.descriptor.handlers[0] as CustomHandlerDescriptor;
-  expect(desc.type).toBe("custom");
-  expect(desc.handler).toBe(handler);
-});
-```
-
----
-
-#### Burst 36: handle() with declaredEmits
-
-| Value | Graph introspection support |
-| Approach | Optional second param for declared emits |
-| Size | S |
-
-```typescript
-it("should capture declaredEmits for graph introspection", () => {
-  const pipeline = define("test")
-    .on("CustomEvent")
-    .handle(async () => {}, { emits: ["EventA", "EventB"] })
-    .build();
-
-  const desc = pipeline.descriptor.handlers[0] as CustomHandlerDescriptor;
-  expect(desc.declaredEmits).toEqual(["EventA", "EventB"]);
-});
-```
-
----
-
-#### Burst 37: Phase 4 Integration & Chaining
-
-| Value | Complete custom handler support |
-| Approach | Chaining from handle() |
-| Size | S |
-
-```typescript
-it("should chain on() from handle()", () => {
-  const pipeline = define("test")
-    .on("EventA")
-    .handle(async () => {})
-    .on("EventB")
-    .emit("CommandB", {})
-    .build();
-
-  expect(pipeline.descriptor.handlers).toHaveLength(2);
-});
-```
-
----
-
-### Phase 5: Graph Extraction (Bursts 38-42)
-
-#### Burst 38: GraphIR type definition
-
-| Value | Intermediate representation for visualization |
-| Approach | Define nodes and edges types |
-| Size | S |
-
-```typescript
-it("should define GraphIR with nodes and edges", () => {
-  const graph: GraphIR = {
-    nodes: [
-      { id: "evt:Start", type: "event", label: "Start" },
-      { id: "cmd:Process", type: "command", label: "Process" },
-    ],
-    edges: [{ from: "evt:Start", to: "cmd:Process", label: "triggers" }],
-  };
-  expect(graph.nodes).toHaveLength(2);
-});
-```
-
----
-
-#### Burst 39: Pipeline.toGraph() basic
-
-| Value | Extract graph from pipeline |
-| Approach | toGraph() method on Pipeline |
-| Size | M |
-
-```typescript
-it("should extract graph from emit handler", () => {
-  const pipeline = define("test").on("Start").emit("Process", {}).build();
-
-  const graph = pipeline.toGraph();
-  expect(graph.nodes.some((n) => n.id === "evt:Start")).toBe(true);
-  expect(graph.nodes.some((n) => n.id === "cmd:Process")).toBe(true);
-});
-```
-
----
-
-#### Burst 40: toGraph() with run-await handlers
-
-| Value | Graph extraction for scatter-gather |
-| Approach | Include await relationships |
-| Size | M |
-
----
-
-#### Burst 41: toGraph() with foreach-phased handlers
-
-| Value | Graph extraction for phased execution |
-| Approach | Include phase groupings |
-| Size | M |
-
----
-
-#### Burst 42: toGraph() with custom handlers
-
-| Value | Graph extraction using declaredEmits |
-| Approach | Use declaredEmits for edges |
-| Size | S |
-
----
-
-### Phase 6: Cloud Abstractions (Bursts 43-48)
-
-(Deferred - interfaces only, no runtime implementation yet)
-
----
-
-### Phase 7: Pipeline Runtime (Bursts 49-54)
-
-(Deferred - requires Phase 6 abstractions)
-
----
-
-## DONE
-
-### Phase 13: PipelineRunCompleted Event (Bursts 107-112) ✅
-
-- [x] Burst 107: Create QuiescenceTracker class with increment/decrement/isQuiescent (f4bc85c4)
-- [x] Burst 108: Add debounce logic to QuiescenceTracker with configurable delay (411129cb)
-- [x] Burst 109-111: Wire QuiescenceTracker into PipelineServer, emit PipelineRunCompleted (0011d83b)
-- [x] Burst 112: Verify quiescence tracking handles retries naturally (bb928573)
-
----
-
-### Command Concurrency Control (Bursts CG-1 to CG-8) ✅
-
-- [x] Burst CG-1: Gate registration + passthrough (d0a733c8)
-- [x] Burst CG-2: Cancel-in-progress (a6f2f3dc)
-- [x] Burst CG-3: Queue enqueue + drain + FIFO (852f4f2b)
-- [x] Burst CG-4: PipelineContext signal + server wiring (6f1ba55e)
-- [x] Burst CG-5: processCommand integration (49b44544)
-- [x] Burst CG-6: Cancel-in-progress through server (acf1064d)
-- [x] Burst CG-7: Queue + dispatch paths through server (7a8a4bd3)
-- [x] Burst CG-8: Config-level concurrency wiring (b5db28a1)
-
----
-
-### V2 Engine Internal Swap ✅
-
-- [x] Burst V2-1: Add processKeyed/getState/resetInstance to WorkflowProcessor [depends: none] (d7b0fbc6)
-- [x] Burst V2-2: V2RuntimeBridge — settled path [depends: V2-1] (867c844a)
-- [x] Burst V2-3: V2RuntimeBridge — phased path [depends: V2-1] (985add45)
-- [x] Burst V2-4: Wire bridge into PipelineServer [depends: V2-2, V2-3] (df6e6fcf)
-- [x] Burst V2-5+V2-6: Remove v1 runtime classes and update exports [depends: V2-4] (98b1025c)
-
----
-
-### Phase 12: Consistent Non-Blocking Dispatch (Bursts 103-105) ✅
-
-- [x] Burst 103: Add `await` to `startPhased` call in pipeline-runtime.ts (e9b391f4)
-- [x] Burst 104: Make `sendCommand` non-blocking in pipeline-server.ts (2309cf5b)
-- [x] Burst 105: Fix phased executor race condition in countPendingInPhase (03f4f951)
-
----
-
-### Phase 8: CLI Integration (Bursts 67-70) ✅
-
-Burst 67-70 complete. E2E tests validate CLI parity.
-
-### Burst 69-70: E2E Tests for CLI Parity
-
-Implemented:
-
-- 8 E2E tests validating endpoint compatibility
-- Tests for `/registry`, `/pipeline`, `/sessions`, `/messages`, `/stats`, `/command`
-- Tests for command execution and event routing through pipeline
-- Tests for pipeline chain with multiple handlers
-
-All 99 tests pass with 100% coverage.
-
----
-
-### Burst 67-68: Enhanced /pipeline Response
-
-Implemented:
-
-- Added `folds: []` to `/registry` response
-- Added `commandToEvents` mapping from command handlers
-- Added `eventToCommand` mapping from pipeline handlers
-- Added `PipelineNode` shape with `id`, `name`, `title`, `status`
-- 4 new tests for response shapes
-
-All 91 tests pass with 100% coverage.
-
----
-
-### Burst 53-54: AwaitTracker
-
-Implemented:
-
-- `AwaitTracker` class for scatter-gather completion tracking
-- `startAwaiting()` to register pending keys
-- `markComplete()` to mark individual keys as done
-- `isComplete()` to check if all keys are done
-- `getResults()` to collect results and clear tracking
-- 7 tests for await tracking functionality
-- Exported from package index
-
-All 87 tests pass with 100% coverage.
-
----
-
-### Burst 55-66: PipelineServer
-
-Implemented:
-
-- `PipelineServer` class with HTTP endpoints
-- `/health`, `/registry`, `/pipeline`, `/messages`, `/sessions`, `/stats` endpoints
-- `POST /command` with command handler validation and 404 for unknown commands
-- Event routing through registered pipelines
-- Custom handler context support (emit, sendCommand)
-- Command handlers returning multiple events
-- Integration test for complete workflow
-- 16 tests for server functionality
-- Exports added to public API
-
-All 80 tests pass with 100% coverage.
-
----
-
-### Burst 51-52: Run-await and ForEach-phased Runtime
-
-Implemented:
-
-- `handleEvent()` for run-await handlers with command dispatch
-- Data factory support in static run-await commands
-- ForEach-phased item processing with phase ordering
-- Custom handler receives PipelineContext
-
-All 80 tests pass with 100% coverage.
-
----
-
-### Burst 45-50: PipelineRuntime Core
-
-Implemented:
-
-- `PipelineRuntime` class with descriptor and handler index
-- `getHandlersForEvent()` for O(1) handler lookup by event type
-- `getMatchingHandlers()` with predicate filtering
-- `handleEvent()` for emit and custom handlers
-- Data factory resolution for emit handlers
-- 7 tests for runtime functionality
-
-All 59 tests pass with 100% coverage.
-
----
-
-### Burst 43-44: PipelineContext & RuntimeConfig
-
-Implemented:
-
-- `PipelineContext` interface with `emit()`, `sendCommand()`, `correlationId`
-- `RuntimeConfig` interface with optional `defaultTimeout`
-- 4 tests for context/config types
-
----
-
-### Burst 38-42: Phase 5 Graph Extraction
-
-Implemented:
-
-- `GraphIR` type with `nodes` and `edges` arrays
-- `GraphNode` with `id`, `type` ('event' | 'command'), `label`
-- `GraphEdge` with `from`, `to`, optional `label`
-- `Pipeline.toGraph()` method for all handler types
-- Emit handler graph extraction
-- Run-await handler graph extraction with success/failure events
-- Foreach-phased handler graph extraction with completion events
-- Custom handler graph extraction using `declaredEmits`
-- Node deduplication
-- 9 tests for graph functionality
-
-All 46 tests pass with 100% coverage.
-
----
-
-### Burst 35-37: Phase 4 Custom Handlers
-
-Implemented:
-
-- `TriggerBuilder.handle()` with async handler function
-- `handle()` with `declaredEmits` option for graph introspection
-- `HandleChain` for chaining `on()` and `build()`
-- 3 tests for custom handler functionality
-
-All 37 tests pass with 100% coverage.
-
----
-
-### Burst 27-34: Phase 3 Phased Execution Pattern
-
-Implemented:
-
-- `TriggerBuilder.forEach()` returns `ForEachBuilder`
-- `ForEachBuilder.groupInto()` with phase classifier
-- `PhasedBuilder.process()` with emit factory
-- `PhasedChain.stopOnFailure()` optional flag
-- `PhasedChain.onComplete()` with success/failure events
-- `PhasedTerminal` for chaining
-- Integration test with complete phased pipeline
-
-All 34 tests pass with 100% coverage.
-
----
-
-### Burst 19-26: Phase 2 Scatter-Gather Pattern
-
-Implemented:
-
-- `TriggerBuilder.run()` returns `RunBuilder`
-- `run()` accepts static `CommandDispatch[]` or factory function
-- `RunBuilder.awaitAll()` with key extractor and optional timeout
-- `GatherBuilder.onSuccess()` with `SuccessContext`
-- `GatherBuilder.onFailure()` with `FailureContext`
-- Chaining: `on()` and `build()` from `GatherBuilder`
-- Integration test with complete scatter-gather pipeline
-
-New types added:
-
-- `SuccessContext<T>` - results, duration, triggerEvent
-- `FailureContext<T>` - failures, successes, triggerEvent
-- `GatherEventConfig<T>` - eventType, dataFactory
-
-All 26 tests pass with 100% coverage.
-
----
-
-### Burst 13, 15, 18: Remaining Phase 1 features
-
-- emit() with data factory
-- when() predicate for conditional execution
-- Integration test with complete pipeline
-
-All Phase 1 tests pass with 100% coverage.
-
----
-
-### Burst 6-12, 14, 16, 17: Builder API (batched)
-
-Implemented:
-
-- define() entry point
-- version() and description()
-- build() returns frozen Pipeline
-- on() returns TriggerBuilder
-- emit() with static data
-- EmitChain.build() captures handler
-- Parallel emit() chain
-- EmitChain.on() continues chain
-- key() named extractors
-
-All tests pass with 100% coverage.
-
----
-
-### Burst 5: PipelineDescriptor Type
-
-| Value | Pipeline structure definition |
-| Approach | Interface with metadata + handlers array |
-| Size | S |
-
-```typescript
-it("should create PipelineDescriptor", () => {
-  const descriptor: PipelineDescriptor = {
-    name: "test-pipeline",
-    version: "1.0.0",
-    keys: new Map(),
-    handlers: [],
-  };
-  expect(descriptor.name).toBe("test-pipeline");
-});
-```
-
----
-
-### Burst 4: dispatch() Helper
-
-| Value | Ergonomic CommandDispatch creation |
-| Approach | Simple factory function |
-| Size | S |
-
-```typescript
-it("should create CommandDispatch via dispatch()", () => {
-  const cmd = dispatch("CheckTests", { targetDirectory: "./src" });
-  expect(cmd).toEqual({
-    commandType: "CheckTests",
-    data: { targetDirectory: "./src" },
-  });
-});
-```
-
----
-
-### Burst 3: CommandDispatch Type
-
-| Value | Dispatch instruction type |
-| Approach | Simple interface with commandType + data |
-| Size | S |
-
-```typescript
-it("should create CommandDispatch with static data", () => {
-  const cmd: CommandDispatch = {
-    commandType: "CheckTests",
-    data: { targetDirectory: "./src", scope: "slice" },
-  };
-  expect(cmd).toEqual({
-    commandType: "CheckTests",
-    data: { targetDirectory: "./src", scope: "slice" },
-  });
-});
-
-it("should create CommandDispatch with data factory", () => {
-  const cmd: CommandDispatch = {
-    commandType: "ImplementSlice",
-    data: (e) => ({ slicePath: e.data.path }),
-  };
-  const event: Event = { type: "SliceGenerated", data: { path: "./slice" } };
-  const resolved = typeof cmd.data === "function" ? cmd.data(event) : cmd.data;
-  expect(resolved).toEqual({ slicePath: "./slice" });
-});
-```
-
----
-
-### Burst 2: Core Types
-
-| Value | Foundation types |
-| Approach | Re-export message-bus types + add pipeline types |
-| Size | S |
-
-```typescript
-it("should re-export Command and Event from message-bus", () => {
-  const cmd: Command = { type: "Test", data: {} };
-  const evt: Event = { type: "TestDone", data: {} };
-  expect(cmd.type).toBe("Test");
-  expect(evt.type).toBe("TestDone");
-});
-```
-
----
-
-### Burst 1: Package Scaffold
-
-| Value | Foundation for all work |
-| Approach | Copy patterns from `@auto-engineer/id` |
-| Size | S |
-
-**Files:**
-
-- `package.json` - deps: `@auto-engineer/message-bus: workspace:*`
-- `tsconfig.json` - extends base, composite: true
-- `tsconfig.test.json` - includes \*.specs.ts
-- `vitest.config.ts` - 100% coverage thresholds
-- `src/index.ts` - empty export