@pennyfarthing/core 10.1.0 → 10.3.0

package/packages/core/dist/workflow/tandem-lifecycle.test.js

@@ -0,0 +1,531 @@
+/**
+ * Tests for Story 95-2: Backseat Agent Spawn and Lifecycle
+ *
+ * RED state tests for tandem backseat agent lifecycle in phased workflows.
+ * These tests cover all 5 acceptance criteria:
+ *
+ * AC1: BikeLane spawns backseat agent at tandem phase start
+ * AC2: BikeLane terminates backseat agent at phase end
+ * AC3: Zero orphan processes (NFR8)
+ * AC4: Primary agent continues if backseat crashes (NFR10)
+ * AC5: Backward compatible (no tandem = no change)
+ *
+ * Run with: npm test
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { mkdirSync, rmSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Import tandem lifecycle functions
+import { spawnBackseat, terminateBackseat, getActiveBackseat, registerCleanupHandler, executeCleanupHandlers, _resetForTesting, } from './tandem-lifecycle.js';
+// Get directory for test fixtures
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEST_DIR = join(__dirname, '__test_tandem_lifecycle__');
+// =============================================================================
+// Test Fixtures
+// =============================================================================
+/** Phase with tandem config (file-watch scope) */
+const PHASE_WITH_TANDEM = {
+    name: 'implement',
+    agent: 'dev',
+    tandem: {
+        partner: 'architect',
+        scope: 'file-watch',
+    },
+};
+/** Phase with tandem config (multiple scopes) */
+const PHASE_WITH_MULTI_SCOPE = {
+    name: 'implement',
+    agent: 'dev',
+    tandem: {
+        partner: 'tea',
+        scope: ['file-watch', 'tool-watch'],
+    },
+};
+/** Phase with tandem config (default scope — no scope specified) */
+const PHASE_WITH_DEFAULT_SCOPE = {
+    name: 'implement',
+    agent: 'dev',
+    tandem: {
+        partner: 'architect',
+    },
+};
+/** Phase without tandem config */
+const PHASE_WITHOUT_TANDEM = {
+    name: 'review',
+    agent: 'reviewer',
+    gate: { type: 'approval' },
+};
+// =============================================================================
+// AC1: BikeLane spawns backseat agent at tandem phase start
+// =============================================================================
+describe('95-2: Tandem Lifecycle', () => {
+    beforeEach(() => {
+        _resetForTesting();
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true });
+        }
+        mkdirSync(TEST_DIR, { recursive: true });
+        mkdirSync(join(TEST_DIR, '.session'), { recursive: true });
+    });
+    afterEach(() => {
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true });
+        }
+    });
+    describe('AC1: Spawn backseat agent at tandem phase start', () => {
+        it('should detect tandem config on phase and spawn backseat', async () => {
+            const params = {
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            assert.strictEqual(result.success, true, 'Spawn should succeed');
+            assert.ok(result.data, 'Should return backseat handle');
+            assert.ok(result.data.taskId, 'Handle should have taskId');
+            assert.strictEqual(result.data.partner, 'architect', 'Partner should match tandem config');
+        });
+        it('should use haiku model for backseat agent', async () => {
+            const params = {
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.data?.model, 'haiku', 'Must use haiku model per framework rules');
+        });
+        it('should run backseat in background', async () => {
+            const params = {
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.data?.runInBackground, true, 'Must run in background');
+        });
+        it('should pass scope config to backseat agent', async () => {
+            const params = {
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            assert.strictEqual(result.success, true);
+            assert.deepStrictEqual(result.data?.scope, ['file-watch'], 'Should normalize scope to array');
+        });
+        it('should handle multiple scopes', async () => {
+            const params = {
+                phase: PHASE_WITH_MULTI_SCOPE,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            assert.strictEqual(result.success, true);
+            assert.deepStrictEqual(result.data?.scope, ['file-watch', 'tool-watch']);
+        });
+        it('should default scope to file-watch when not specified', async () => {
+            const params = {
+                phase: PHASE_WITH_DEFAULT_SCOPE,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            assert.strictEqual(result.success, true);
+            assert.deepStrictEqual(result.data?.scope, ['file-watch'], 'Should default to file-watch');
+        });
+        it('should set observation file path on handle', async () => {
+            const params = {
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            assert.strictEqual(result.success, true);
+            const expectedPath = join(TEST_DIR, '.session', '95-2-tandem-architect.md');
+            assert.strictEqual(result.data?.observationFilePath, expectedPath, 'Observation file path should follow convention');
+        });
+        it('should register cleanup handler at spawn time', async () => {
+            const params = {
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.data?.cleanupRegistered, true, 'Cleanup handler must be registered at spawn time');
+        });
+        it('should return no-op result for phase without tandem', async () => {
+            const params = {
+                phase: PHASE_WITHOUT_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            assert.strictEqual(result.success, true, 'Should succeed (no-op)');
+            assert.strictEqual(result.data, undefined, 'No handle for non-tandem phase');
+        });
+    });
+    // =============================================================================
+    // AC2: BikeLane terminates backseat agent at phase end
+    // =============================================================================
+    describe('AC2: Terminate backseat agent at phase end', () => {
+        it('should terminate active backseat by task ID', async () => {
+            // First spawn
+            const spawnResult = await spawnBackseat({
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            });
+            assert.strictEqual(spawnResult.success, true);
+            const handle = spawnResult.data;
+            const result = await terminateBackseat(handle);
+            assert.strictEqual(result.success, true, 'Termination should succeed');
+        });
+        it('should update background task status on termination', async () => {
+            const spawnResult = await spawnBackseat({
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            });
+            const handle = spawnResult.data;
+            const result = await terminateBackseat(handle);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.data?.status, 'terminated', 'Background task status should be terminated');
+        });
+        it('should clear active backseat after termination', async () => {
+            const spawnResult = await spawnBackseat({
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            });
+            const handle = spawnResult.data;
+            await terminateBackseat(handle);
+            const active = getActiveBackseat('95-2');
+            assert.strictEqual(active, null, 'No active backseat after termination');
+        });
+        it('should handle termination of already-stopped task gracefully', async () => {
+            // Simulate a handle for a task that already stopped
+            const staleHandle = {
+                taskId: 'stale-task-id',
+                partner: 'architect',
+                model: 'haiku',
+                runInBackground: true,
+                scope: ['file-watch'],
+                observationFilePath: join(TEST_DIR, '.session', '95-2-tandem-architect.md'),
+                cleanupRegistered: true,
+            };
+            const result = await terminateBackseat(staleHandle);
+            // Should succeed gracefully, not throw
+            assert.strictEqual(result.success, true, 'Should handle already-stopped gracefully');
+        });
+    });
+    // =============================================================================
+    // AC3: Zero orphan processes (NFR8)
+    // =============================================================================
+    describe('AC3: Zero orphan processes', () => {
+        it('should register cleanup handler that can terminate backseat', async () => {
+            let cleanupCalled = false;
+            const handler = {
+                storyId: '95-2',
+                cleanup: async () => { cleanupCalled = true; },
+            };
+            registerCleanupHandler(handler);
+            await executeCleanupHandlers('95-2');
+            assert.strictEqual(cleanupCalled, true, 'Cleanup handler should be invoked');
+        });
+        it('should execute cleanup handlers even on error', async () => {
+            let cleanupCalled = false;
+            registerCleanupHandler({
+                storyId: '95-2',
+                cleanup: async () => { cleanupCalled = true; },
+            });
+            // Simulate crash-like cleanup
+            await executeCleanupHandlers('95-2');
+            assert.strictEqual(cleanupCalled, true, 'Cleanup must execute even in error scenarios');
+        });
+        it('should support multiple cleanup handlers per story', async () => {
+            let handler1Called = false;
+            let handler2Called = false;
+            registerCleanupHandler({
+                storyId: '95-2',
+                cleanup: async () => { handler1Called = true; },
+            });
+            registerCleanupHandler({
+                storyId: '95-2',
+                cleanup: async () => { handler2Called = true; },
+            });
+            await executeCleanupHandlers('95-2');
+            assert.strictEqual(handler1Called, true, 'First handler should be called');
+            assert.strictEqual(handler2Called, true, 'Second handler should be called');
+        });
+        it('should not affect handlers for other stories', async () => {
+            let otherCalled = false;
+            registerCleanupHandler({
+                storyId: 'other-story',
+                cleanup: async () => { otherCalled = true; },
+            });
+            registerCleanupHandler({
+                storyId: '95-2',
+                cleanup: async () => { },
+            });
+            await executeCleanupHandlers('95-2');
+            assert.strictEqual(otherCalled, false, 'Should not invoke handlers for other stories');
+        });
+        it('should clear handlers after execution', async () => {
+            let callCount = 0;
+            registerCleanupHandler({
+                storyId: '95-2',
+                cleanup: async () => { callCount++; },
+            });
+            await executeCleanupHandlers('95-2');
+            await executeCleanupHandlers('95-2'); // Second call
+            assert.strictEqual(callCount, 1, 'Handler should only execute once');
+        });
+    });
+    // =============================================================================
+    // AC4: Primary agent continues if backseat crashes (NFR10)
+    // =============================================================================
+    describe('AC4: Primary continues if backseat crashes', () => {
+        it('should return success even when backseat process is unavailable', async () => {
+            // Terminating a non-existent task should not throw
+            const deadHandle = {
+                taskId: 'dead-process-id',
+                partner: 'architect',
+                model: 'haiku',
+                runInBackground: true,
+                scope: ['file-watch'],
+                observationFilePath: join(TEST_DIR, '.session', '95-2-tandem-architect.md'),
+                cleanupRegistered: true,
+            };
+            const result = await terminateBackseat(deadHandle);
+            assert.strictEqual(result.success, true, 'Termination must succeed even for crashed backseat');
+        });
+        it('should not throw when cleanup handler encounters error', async () => {
+            registerCleanupHandler({
+                storyId: '95-2',
+                cleanup: async () => { throw new Error('Simulated crash'); },
+            });
+            // executeCleanupHandlers should not throw despite handler error
+            await assert.doesNotReject(() => executeCleanupHandlers('95-2'), 'Cleanup should swallow handler errors');
+        });
+        it('should continue executing remaining handlers after one fails', async () => {
+            let secondCalled = false;
+            registerCleanupHandler({
+                storyId: '95-2',
+                cleanup: async () => { throw new Error('First handler crash'); },
+            });
+            registerCleanupHandler({
+                storyId: '95-2',
+                cleanup: async () => { secondCalled = true; },
+            });
+            await executeCleanupHandlers('95-2');
+            assert.strictEqual(secondCalled, true, 'Remaining handlers must execute even if earlier ones fail');
+        });
+        it('should return error info but success=true for crashed backseat spawn', async () => {
+            // Spawn with invalid config to simulate crash at spawn
+            const params = {
+                phase: {
+                    name: 'test',
+                    agent: 'dev',
+                    tandem: {
+                        partner: '', // Invalid: empty partner
+                    },
+                },
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            // Should not crash the primary agent
+            assert.strictEqual(result.success, false, 'Spawn with invalid config should fail');
+            assert.ok(result.error, 'Should include error message');
+        });
+    });
+    // =============================================================================
+    // AC5: Backward compatible
+    // =============================================================================
+    describe('AC5: Backward compatibility', () => {
+        it('should be a no-op for phases without tandem config', async () => {
+            const params = {
+                phase: PHASE_WITHOUT_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            };
+            const result = await spawnBackseat(params);
+            assert.strictEqual(result.success, true, 'Should succeed as no-op');
+            assert.strictEqual(result.data, undefined, 'No handle for non-tandem');
+        });
+        it('should not modify WorkflowPhase interface contract', () => {
+            // Verify existing phase fields still work without tandem
+            const phase = {
+                name: 'red',
+                agent: 'tea',
+                input: ['session_file'],
+                output: ['failing_tests'],
+                gate: { type: 'tests_fail', condition: 'Coverage check' },
+            };
+            assert.strictEqual(phase.name, 'red');
+            assert.strictEqual(phase.agent, 'tea');
+            assert.ok(Array.isArray(phase.input));
+            assert.ok(Array.isArray(phase.output));
+            assert.strictEqual(phase.gate?.type, 'tests_fail');
+            assert.strictEqual(phase.tandem, undefined, 'Tandem should be optional/undefined');
+        });
+        it('should return null for getActiveBackseat when no tandem running', () => {
+            const active = getActiveBackseat('nonexistent-story');
+            assert.strictEqual(active, null, 'No active backseat for non-tandem story');
+        });
+        it('should handle executeCleanupHandlers with no registered handlers', async () => {
+            // No handlers registered for this story
+            await assert.doesNotReject(() => executeCleanupHandlers('no-handlers-story'), 'Should handle empty cleanup gracefully');
+        });
+        it('should terminate gracefully when no backseat exists for phase transition', async () => {
+            // Simulates completeStep for a non-tandem phase
+            const nullHandle = getActiveBackseat('95-2');
+            assert.strictEqual(nullHandle, null);
+            // No crash, no error — workflow continues
+        });
+    });
+    // =============================================================================
+    // ProcessAdapter integration
+    // =============================================================================
+    describe('ProcessAdapter integration', () => {
+        it('should call adapter.spawn when adapter is provided', async () => {
+            let spawnCalled = false;
+            let spawnParams = {};
+            const adapter = {
+                spawn: async (params) => {
+                    spawnCalled = true;
+                    spawnParams = params;
+                    return { taskId: 'real-task-123' };
+                },
+                terminate: async () => { },
+            };
+            const result = await spawnBackseat({
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+                adapter,
+            });
+            assert.strictEqual(spawnCalled, true, 'Adapter spawn must be called');
+            assert.strictEqual(result.data?.taskId, 'real-task-123', 'Should use adapter taskId');
+            assert.strictEqual(spawnParams.partner, 'architect');
+            assert.strictEqual(spawnParams.model, 'haiku');
+        });
+        it('should call adapter.terminate when terminating with adapter', async () => {
+            let terminatedId = '';
+            const adapter = {
+                spawn: async () => ({ taskId: 'real-task-456' }),
+                terminate: async (taskId) => { terminatedId = taskId; },
+            };
+            const spawnResult = await spawnBackseat({
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+                adapter,
+            });
+            await terminateBackseat(spawnResult.data, adapter);
+            assert.strictEqual(terminatedId, 'real-task-456', 'Adapter terminate must be called with correct taskId');
+        });
+        it('should call adapter.terminate in cleanup handler', async () => {
+            let terminatedId = '';
+            const adapter = {
+                spawn: async () => ({ taskId: 'cleanup-task-789' }),
+                terminate: async (taskId) => { terminatedId = taskId; },
+            };
+            await spawnBackseat({
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+                adapter,
+            });
+            await executeCleanupHandlers('95-2');
+            assert.strictEqual(terminatedId, 'cleanup-task-789', 'Cleanup must call adapter.terminate');
+        });
+        it('should terminate existing backseat before spawning new one for same story', async () => {
+            const terminated = [];
+            const adapter = {
+                spawn: async () => ({ taskId: `task-${++taskCounter}` }),
+                terminate: async (taskId) => { terminated.push(taskId); },
+            };
+            let taskCounter = 0;
+            // First spawn
+            await spawnBackseat({
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+                adapter,
+            });
+            // Second spawn for same story — should terminate first
+            await spawnBackseat({
+                phase: PHASE_WITH_MULTI_SCOPE,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+                adapter,
+            });
+            assert.strictEqual(terminated.length, 1, 'First backseat should be terminated');
+            assert.strictEqual(terminated[0], 'task-1', 'Should terminate the first task');
+        });
+        it('should return error result when adapter.spawn fails', async () => {
+            const adapter = {
+                spawn: async () => { throw new Error('Connection refused'); },
+                terminate: async () => { },
+            };
+            const result = await spawnBackseat({
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+                adapter,
+            });
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error?.includes('Connection refused'));
+        });
+        it('should succeed even when adapter.terminate fails', async () => {
+            const adapter = {
+                spawn: async () => ({ taskId: 'will-fail-terminate' }),
+                terminate: async () => { throw new Error('Process not found'); },
+            };
+            const spawnResult = await spawnBackseat({
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+                adapter,
+            });
+            const result = await terminateBackseat(spawnResult.data, adapter);
+            assert.strictEqual(result.success, true, 'Should swallow terminate errors');
+        });
+    });
+    // =============================================================================
+    // Result format compliance
+    // =============================================================================
+    describe('Result format compliance', () => {
+        it('should return {success, data?, error?} from spawnBackseat', async () => {
+            const result = await spawnBackseat({
+                phase: PHASE_WITH_TANDEM,
+                storyId: '95-2',
+                sessionDir: join(TEST_DIR, '.session'),
+            });
+            assert.ok('success' in result, 'Must have success field');
+            assert.ok(typeof result.success === 'boolean', 'success must be boolean');
+            // data and error are optional
+        });
+        it('should return {success, data?, error?} from terminateBackseat', async () => {
+            const handle = {
+                taskId: 'test-id',
+                partner: 'architect',
+                model: 'haiku',
+                runInBackground: true,
+                scope: ['file-watch'],
+                observationFilePath: '/tmp/test.md',
+                cleanupRegistered: true,
+            };
+            const result = await terminateBackseat(handle);
+            assert.ok('success' in result, 'Must have success field');
+            assert.ok(typeof result.success === 'boolean', 'success must be boolean');
+        });
+    });
+});
+//# sourceMappingURL=tandem-lifecycle.test.js.map

package/packages/core/dist/workflow/tandem-lifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tandem-lifecycle.test.js","sourceRoot":"","sources":["../../src/workflow/tandem-lifecycle.test.ts"],"names":[],"mappings":"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"}

package/packages/core/dist/workflow/tool-watch.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Tool-watch Observation Scope for Story 95-5
+ *
+ * Delivers tool call information (name, params, results) from primary agent
+ * to backseat observer within one tool-use cycle. Truncates large results
+ * to configurable max size. Non-blocking to primary.
+ *
+ * Hook side: processToolCall() appends JSONL to transport file (synchronous, fast).
+ * Backseat side: startToolWatcher() polls JSONL and writes observations.
+ */
+export interface ToolCallEntry {
+    timestamp: string;
+    toolName: string;
+    params: Record<string, unknown>;
+    resultPreview: string;
+    resultSize: number;
+}
+export interface ToolWatchConfig {
+    sessionDir: string;
+    storyId: string;
+    agent: string;
+    persona: string;
+    phase: string;
+    pollIntervalMs?: number;
+    maxResultSize?: number;
+    observationFilePath?: string;
+}
+export interface ToolWatchHandle {
+    running: boolean;
+    pollIntervalMs: number;
+}
+export interface ToolWatchResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+export interface ProcessToolCallParams {
+    sessionDir: string;
+    storyId: string;
+    toolName: string;
+    params: Record<string, unknown>;
+    toolResult: string;
+    maxResultSize?: number;
+}
+/**
+ * Truncate a tool result string to maxSize characters.
+ * Appends `[truncated from N chars]` indicator when truncated.
+ */
+export declare function truncateResult(result: string, maxSize: number): string;
+/**
+ * Record a tool call to the JSONL transport file.
+ * Called from the PostToolUse hook — must be synchronous and fast.
+ */
+export declare function processToolCall(params: ProcessToolCallParams): ToolWatchResult;
+/**
+ * Read tool call entries from a JSONL transport file.
+ * Skips malformed lines gracefully.
+ */
+export declare function readToolCalls(filePath: string): ToolWatchResult<ToolCallEntry[]>;
+/**
+ * Start a polling tool watcher that reads JSONL entries and writes observations.
+ */
+export declare function startToolWatcher(config: ToolWatchConfig): Promise<ToolWatchResult<ToolWatchHandle>>;
+/**
+ * Stop a running tool watcher. Idempotent — safe to call multiple times.
+ */
+export declare function stopToolWatcher(handle: ToolWatchHandle): Promise<ToolWatchResult>;
+//# sourceMappingURL=tool-watch.d.ts.map

package/packages/core/dist/workflow/tool-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-watch.d.ts","sourceRoot":"","sources":["../../src/workflow/tool-watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAgBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAyB9E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAC,aAAa,EAAE,CAAC,CAuBhF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAiE3C;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAYvF"}