groundswell 0.0.1 → 0.0.3

package/dist/__tests__/adversarial/observer-propagation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-propagation.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/adversarial/observer-propagation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/__tests__/adversarial/observer-propagation.test.js

@@ -0,0 +1,404 @@
+/**
+ * PRD Section 7: Observer Propagation Compliance Test
+ *
+ * Validates that observer propagation works correctly per PRD Section 7 requirements:
+ * - Events from deeply nested children bubble up to root observers via getRoot()
+ * - After reparenting, events propagate to new root's observer (not old root's)
+ * - getRoot() correctly follows parent chain with cycle detection
+ * - All observer callbacks (onEvent, onTreeChanged) are invoked
+ *
+ * Bug Context: The tree integrity bug (child in multiple parents) broke observer
+ * propagation because getRoot() only followed child.parent chain. This test validates
+ * the fix ensures events route to correct observers.
+ *
+ * References:
+ * - Bug Analysis: plan/docs/bugfix-architecture/bug_analysis.md (lines 60-91)
+ * - getRoot() implementation: src/core/workflow.ts (lines 174-189)
+ * - getRootObservers() implementation: src/core/workflow.ts (lines 124-139)
+ * - emitEvent() implementation: src/core/workflow.ts (lines 313-329)
+ */
+import { describe, it, expect } from 'vitest';
+import { Workflow, } from '../../index.js';
+/**
+ * SimpleWorkflow class for testing
+ * Pattern from: src/__tests__/integration/workflow-reparenting.test.ts
+ */
+class SimpleWorkflow extends Workflow {
+    async run() {
+        this.setStatus('running');
+        this.setStatus('completed');
+        return 'done';
+    }
+}
+/**
+ * Observer creation helper
+ * Pattern from: src/__tests__/integration/workflow-reparenting.test.ts:142-147
+ */
+const createObserver = (eventsArray) => ({
+    onLog: () => { }, // Empty - not testing logs in this test suite
+    onEvent: (e) => eventsArray.push(e), // Capture events for validation
+    onStateUpdated: () => { }, // Empty - not testing state updates
+    onTreeChanged: () => { }, // Empty - not testing tree changes
+});
+describe('PRD Section 7: Observer Propagation', () => {
+    describe('Event Bubbling: Grandchild to Root Observer', () => {
+        it('should propagate events from grandchild to root observer via getRoot()', () => {
+            // ============================================================
+            // PHASE 1: Setup - Create 3-level tree
+            // ============================================================
+            // ARRANGE: Create root, child, grandchild hierarchy
+            const root = new SimpleWorkflow('Root');
+            const child = new SimpleWorkflow('Child', root);
+            const grandchild = new SimpleWorkflow('Grandchild', child);
+            // ============================================================
+            // PHASE 2: Add observer to root
+            // ============================================================
+            // ARRANGE: Create event capture array and observer
+            const rootEvents = [];
+            root.addObserver(createObserver(rootEvents));
+            // ============================================================
+            // PHASE 3: Emit event from grandchild
+            // ============================================================
+            // ACT: Clear any construction events, then emit from grandchild
+            // PRD Section 7: "Observers attach to root workflow and receive all events"
+            rootEvents.length = 0; // Clear any construction events
+            grandchild.setStatus('running');
+            // ============================================================
+            // PHASE 4: Verify root observer received event
+            // ============================================================
+            // ASSERT: Root observer should receive event via getRoot() traversal
+            // getRoot() from grandchild returns root, then root.observers receive event
+            const receivedEvent = rootEvents.find((e) => e.type === 'treeUpdated');
+            expect(receivedEvent).toBeDefined();
+            // Type guard for discriminated union
+            if (receivedEvent?.type === 'treeUpdated') {
+                expect(receivedEvent.root.id).toBe(root.id);
+            }
+        });
+        it('should propagate events through multiple hierarchy levels', () => {
+            // ============================================================
+            // Test deeper hierarchy (4+ levels) to verify getRoot() traversal
+            // ============================================================
+            // ARRANGE: Create 5-level deep hierarchy
+            const root = new SimpleWorkflow('Root');
+            const level1 = new SimpleWorkflow('L1', root);
+            const level2 = new SimpleWorkflow('L2', level1);
+            const level3 = new SimpleWorkflow('L3', level2);
+            const level4 = new SimpleWorkflow('L4', level3);
+            const rootEvents = [];
+            root.addObserver(createObserver(rootEvents));
+            // ACT: Emit event from deepest level
+            rootEvents.length = 0;
+            level4.setStatus('running');
+            // ASSERT: Verify event bubbled through 4 levels to root
+            // This validates getRoot() correctly traverses: level4 -> level3 -> level2 -> level1 -> root
+            expect(rootEvents.some((e) => e.type === 'treeUpdated')).toBe(true);
+            // Verify the event root is the original root workflow
+            const treeUpdatedEvent = rootEvents.find((e) => e.type === 'treeUpdated');
+            if (treeUpdatedEvent?.type === 'treeUpdated') {
+                expect(treeUpdatedEvent.root.id).toBe(root.id);
+            }
+        });
+    });
+    describe('Observer Routing After Reparenting', () => {
+        it('should route events to new root observer after reparenting', () => {
+            // ============================================================
+            // PHASE 1: Setup - Create parent1, parent2, grandchild with parent1
+            // ============================================================
+            // ARRANGE: Create initial tree structure
+            const parent1 = new SimpleWorkflow('Parent1');
+            const child1 = new SimpleWorkflow('Child1', parent1);
+            const grandchild = new SimpleWorkflow('Grandchild', child1);
+            const parent2 = new SimpleWorkflow('Parent2');
+            // ============================================================
+            // PHASE 2: Verify initial propagation to parent1 observer
+            // ============================================================
+            // ARRANGE: Create observer for parent1
+            const parent1Events = [];
+            parent1.addObserver(createObserver(parent1Events));
+            // ACT: Emit event from grandchild
+            parent1Events.length = 0;
+            grandchild.setStatus('running');
+            // ASSERT: parent1 observer receives event (initial state)
+            expect(parent1Events.some((e) => e.type === 'treeUpdated')).toBe(true);
+            // ============================================================
+            // PHASE 3: Reparent grandchild to different tree
+            // ============================================================
+            // ACT: First detach from child1, then attach to child2
+            // Pattern: detachChild() -> attachChild() for proper reparenting
+            const child2 = new SimpleWorkflow('Child2', parent2);
+            child1.detachChild(grandchild);
+            child2.attachChild(grandchild);
+            // ============================================================
+            // PHASE 4: Add observer to new root (parent2)
+            // ============================================================
+            // ARRANGE: Create observer for parent2
+            const parent2Events = [];
+            parent2.addObserver(createObserver(parent2Events));
+            // ============================================================
+            // PHASE 5: Emit event from grandchild
+            // ============================================================
+            // ACT: Clear events to isolate post-reparenting behavior
+            parent1Events.length = 0;
+            parent2Events.length = 0;
+            grandchild.setStatus('completed');
+            // ============================================================
+            // PHASE 6: Verify new root observer receives event
+            // ============================================================
+            // ASSERT: parent2 observer receives event (after reparenting)
+            expect(parent2Events.some((e) => e.type === 'treeUpdated')).toBe(true);
+        });
+        it('should not route events to old root observer after reparenting', () => {
+            // ============================================================
+            // CRITICAL VALIDATION: This test validates the bug fix
+            // ============================================================
+            // Bug analysis (bug_analysis.md:60-91) showed:
+            // - child.parent stayed pointing to old parent
+            // - getRoot() returned wrong root
+            // - Old parent's observers still received events after reparenting
+            //
+            // This test ensures that after the fix:
+            // - child.parent is updated to new parent
+            // - getRoot() returns correct root
+            // - Old parent's observers do NOT receive events
+            // ARRANGE: Create two separate trees with observers
+            const parent1 = new SimpleWorkflow('Parent1');
+            const child1 = new SimpleWorkflow('Child1', parent1);
+            const grandchild = new SimpleWorkflow('Grandchild', child1);
+            const parent2 = new SimpleWorkflow('Parent2');
+            const child2 = new SimpleWorkflow('Child2', parent2);
+            const parent1Events = [];
+            const parent2Events = [];
+            parent1.addObserver(createObserver(parent1Events));
+            parent2.addObserver(createObserver(parent2Events));
+            // ACT: Reparent grandchild from parent1 tree to parent2 tree
+            // Pattern: detach from old parent, then attach to new parent
+            child1.detachChild(grandchild);
+            child2.attachChild(grandchild);
+            // Clear events to isolate post-reparenting behavior
+            parent1Events.length = 0;
+            parent2Events.length = 0;
+            // Emit event from grandchild
+            grandchild.setStatus('running');
+            // ASSERT: CRITICAL - Old root's observer must NOT receive event
+            // This was the bug - old parent's observers still received events
+            expect(parent1Events.some((e) => e.type === 'treeUpdated')).toBe(false);
+            expect(parent1Events.length).toBe(0);
+            // ASSERT: New root's observer MUST receive event
+            expect(parent2Events.some((e) => e.type === 'treeUpdated')).toBe(true);
+        });
+    });
+    describe('getRoot() Traversal Correctness', () => {
+        it('should find root workflow via parent chain traversal', () => {
+            // ============================================================
+            // Verify getRoot() from grandchild returns root
+            // ============================================================
+            // This is called internally by getRootObservers()
+            // ARRANGE: Create 3-level tree
+            const root = new SimpleWorkflow('Root');
+            const child = new SimpleWorkflow('Child', root);
+            const grandchild = new SimpleWorkflow('Grandchild', child);
+            // ACT: Call getRoot() on grandchild (protected method, access via cast)
+            const foundRoot = grandchild.getRoot();
+            // ASSERT: getRoot() should return root workflow
+            expect(foundRoot).toBe(root);
+            expect(foundRoot).not.toBe(child);
+            expect(foundRoot).not.toBe(grandchild);
+        });
+        it('should find root through deep parent chain', () => {
+            // ============================================================
+            // Verify getRoot() works correctly with deep hierarchies
+            // ============================================================
+            // ARRANGE: Create 10-level deep hierarchy
+            const root = new SimpleWorkflow('Root');
+            let current = root;
+            for (let i = 0; i < 10; i++) {
+                const nextChild = new SimpleWorkflow(`Level${i}`);
+                current.attachChild(nextChild);
+                current = nextChild;
+            }
+            // ACT: Call getRoot() on deepest child
+            const foundRoot = current.getRoot();
+            // ASSERT: Deepest child's getRoot() returns original root
+            expect(foundRoot).toBe(root);
+        });
+        it('should maintain correct root after multiple reparenting cycles', () => {
+            // ============================================================
+            // Test reparenting: A->B->C  =>  X->Y->C  =>  A->Z->C
+            // ============================================================
+            // ARRANGE: Create initial tree A->B->C
+            const parentA = new SimpleWorkflow('ParentA');
+            const parentB = new SimpleWorkflow('ParentB', parentA);
+            const childC = new SimpleWorkflow('ChildC', parentB);
+            // ASSERT: Initial - C's root should be A
+            expect(childC.getRoot()).toBe(parentA);
+            // ACT: Reparent to X->Y->C
+            const parentX = new SimpleWorkflow('ParentX');
+            const parentY = new SimpleWorkflow('ParentY', parentX);
+            parentB.detachChild(childC);
+            parentY.attachChild(childC);
+            // ASSERT: After first reparenting, C's root should be X
+            expect(childC.getRoot()).toBe(parentX);
+            // ACT: Reparent again to A->Z->C
+            const parentZ = new SimpleWorkflow('ParentZ', parentA);
+            parentY.detachChild(childC);
+            parentZ.attachChild(childC);
+            // ASSERT: After second reparenting, C's root should be A again
+            expect(childC.getRoot()).toBe(parentA);
+        });
+    });
+    describe('Observer Callback Invocation', () => {
+        it('should invoke onEvent() for all event types from children', () => {
+            // ============================================================
+            // Verify onEvent() callback is invoked
+            // ============================================================
+            // ARRANGE: Create 2-level tree with tracking observer
+            const root = new SimpleWorkflow('Root');
+            const child = new SimpleWorkflow('Child', root);
+            let onEventCallCount = 0;
+            let receivedEventType;
+            const trackingObserver = {
+                onLog: () => { },
+                onEvent: (e) => {
+                    onEventCallCount++;
+                    receivedEventType = e.type;
+                },
+                onStateUpdated: () => { },
+                onTreeChanged: () => { },
+            };
+            root.addObserver(trackingObserver);
+            // ACT: Emit event from child
+            child.setStatus('running');
+            // ASSERT: Verify onEvent was called
+            expect(onEventCallCount).toBeGreaterThan(0);
+            expect(receivedEventType).toBeDefined();
+        });
+        it('should invoke onTreeChanged() for tree update events', () => {
+            // ============================================================
+            // Verify onTreeChanged() callback is invoked
+            // ============================================================
+            // ARRANGE: Create 2-level tree with tracking observer
+            const root = new SimpleWorkflow('Root');
+            const child = new SimpleWorkflow('Child', root);
+            let onTreeChangedCallCount = 0;
+            let receivedRoot;
+            const trackingObserver = {
+                onLog: () => { },
+                onEvent: () => { },
+                onStateUpdated: () => { },
+                onTreeChanged: (rootNode) => {
+                    onTreeChangedCallCount++;
+                    receivedRoot = rootNode;
+                },
+            };
+            root.addObserver(trackingObserver);
+            // ACT: Emit tree update event (triggers both onEvent and onTreeChanged)
+            // Note: setStatus() emits treeUpdated event which triggers onTreeChanged()
+            child.setStatus('running');
+            // ASSERT: Verify onTreeChanged was called with correct root
+            expect(onTreeChangedCallCount).toBeGreaterThan(0);
+            expect(receivedRoot).toBeDefined();
+            expect(receivedRoot.id).toBe(root.id);
+        });
+        it('should invoke callbacks in correct order', () => {
+            // ============================================================
+            // Verify callback order: onEvent before onTreeChanged
+            // ============================================================
+            // ARRANGE: Create 2-level tree with order-tracking observer
+            const root = new SimpleWorkflow('Root');
+            const child = new SimpleWorkflow('Child', root);
+            const callOrder = [];
+            const orderTrackingObserver = {
+                onLog: () => callOrder.push('onLog'),
+                onEvent: () => callOrder.push('onEvent'),
+                onStateUpdated: () => callOrder.push('onStateUpdated'),
+                onTreeChanged: () => callOrder.push('onTreeChanged'),
+            };
+            root.addObserver(orderTrackingObserver);
+            // ACT: Emit tree update event
+            callOrder.length = 0;
+            child.setStatus('running');
+            // ASSERT: Verify callback order
+            // emitEvent() calls onEvent() first, then onTreeChanged()
+            // See workflow.ts:318-324
+            const eventIndex = callOrder.indexOf('onEvent');
+            const treeChangedIndex = callOrder.indexOf('onTreeChanged');
+            expect(eventIndex).toBeGreaterThanOrEqual(0);
+            expect(treeChangedIndex).toBeGreaterThanOrEqual(0);
+            expect(eventIndex).toBeLessThan(treeChangedIndex);
+        });
+    });
+    describe('Edge Cases: Cycle Detection', () => {
+        it('should still propagate events after cycle detection validation', () => {
+            // ============================================================
+            // Verify that cycle detection in getRoot() doesn't break normal propagation
+            // ============================================================
+            // getRoot() uses visited Set for cycle detection (workflow.ts:175-188)
+            // This test ensures normal operation is not affected
+            // ARRANGE: Create 3-level tree with no cycles
+            const root = new SimpleWorkflow('Root');
+            const child = new SimpleWorkflow('Child', root);
+            const grandchild = new SimpleWorkflow('Grandchild', child);
+            const rootEvents = [];
+            root.addObserver(createObserver(rootEvents));
+            // ACT: Emit event from grandchild
+            // This should work normally (no cycle exists)
+            grandchild.setStatus('running');
+            // ASSERT: Verify propagation still works
+            expect(rootEvents.some((e) => e.type === 'treeUpdated')).toBe(true);
+            // Verify getRoot() didn't throw cycle detection error
+            const foundRoot = grandchild.getRoot();
+            expect(foundRoot).toBe(root);
+        });
+    });
+    describe('Multiple Reparenting Cycles', () => {
+        it('should handle multiple reparenting cycles correctly', () => {
+            // ============================================================
+            // Test: A->B->C  =>  X->Y->C  =>  A->Z->C  =>  P->Q->C
+            // ============================================================
+            // ARRANGE: Create three potential parents
+            const parentA = new SimpleWorkflow('ParentA');
+            const parentB = new SimpleWorkflow('ParentB', parentA);
+            const childC = new SimpleWorkflow('ChildC', parentB);
+            const parentX = new SimpleWorkflow('ParentX');
+            const parentY = new SimpleWorkflow('ParentY', parentX);
+            const parentP = new SimpleWorkflow('ParentP');
+            const parentQ = new SimpleWorkflow('ParentQ', parentP);
+            const eventsA = [];
+            const eventsX = [];
+            const eventsP = [];
+            const createObserverWithTracking = (eventsArray) => ({
+                onLog: () => { },
+                onEvent: (e) => eventsArray.push(e),
+                onStateUpdated: () => { },
+                onTreeChanged: () => { },
+            });
+            parentA.addObserver(createObserverWithTracking(eventsA));
+            parentX.addObserver(createObserverWithTracking(eventsX));
+            parentP.addObserver(createObserverWithTracking(eventsP));
+            // ACT & ASSERT: Cycle 1 - Verify initial state A->B->C
+            eventsA.length = 0;
+            childC.setStatus('running');
+            expect(eventsA.some((e) => e.type === 'treeUpdated')).toBe(true);
+            // ACT & ASSERT: Cycle 2 - Reparent to X->Y->C
+            parentB.detachChild(childC);
+            parentY.attachChild(childC);
+            eventsA.length = 0;
+            eventsX.length = 0;
+            childC.setStatus('completed');
+            expect(eventsX.some((e) => e.type === 'treeUpdated')).toBe(true);
+            expect(eventsA.some((e) => e.type === 'treeUpdated')).toBe(false);
+            // ACT & ASSERT: Cycle 3 - Reparent to P->Q->C
+            parentY.detachChild(childC);
+            parentQ.attachChild(childC);
+            eventsX.length = 0;
+            eventsP.length = 0;
+            childC.setStatus('running');
+            expect(eventsP.some((e) => e.type === 'treeUpdated')).toBe(true);
+            expect(eventsX.some((e) => e.type === 'treeUpdated')).toBe(false);
+            // Final: Verify getRoot() returns correct root
+            expect(childC.getRoot()).toBe(parentP);
+        });
+    });
+});
+//# sourceMappingURL=observer-propagation.test.js.map

package/dist/__tests__/adversarial/observer-propagation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-propagation.test.js","sourceRoot":"","sources":["../../../src/__tests__/adversarial/observer-propagation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,QAAQ,GAGT,MAAM,gBAAgB,CAAC;AAExB;;;GAGG;AACH,MAAM,cAAe,SAAQ,QAAQ;IACnC,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,cAAc,GAAG,CAAC,WAA4B,EAAoB,EAAE,CAAC,CAAC;IAC1E,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,8CAA8C;IAC/D,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,gCAAgC;IACrE,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,oCAAoC;IAC9D,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,mCAAmC;CAC7D,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,QAAQ,CAAC,6CAA6C,EAAE,GAAG,EAAE;QAC3D,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;YAChF,+DAA+D;YAC/D,uCAAuC;YACvC,+DAA+D;YAC/D,oDAAoD;YACpD,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAE3D,+DAA+D;YAC/D,gCAAgC;YAChC,+DAA+D;YAC/D,mDAAmD;YACnD,MAAM,UAAU,GAAoB,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;YAE7C,+DAA+D;YAC/D,sCAAsC;YACtC,+DAA+D;YAC/D,gEAAgE;YAChE,4EAA4E;YAC5E,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,gCAAgC;YACvD,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAEhC,+DAA+D;YAC/D,+CAA+C;YAC/C,+DAA+D;YAC/D,qEAAqE;YACrE,4EAA4E;YAC5E,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;YACvE,MAAM,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;YAEpC,qCAAqC;YACrC,IAAI,aAAa,EAAE,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC1C,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACnE,+DAA+D;YAC/D,kEAAkE;YAClE,+DAA+D;YAC/D,yCAAyC;YACzC,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAEhD,MAAM,UAAU,GAAoB,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;YAE7C,qCAAqC;YACrC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;YACtB,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAE5B,wDAAwD;YACxD,6FAA6F;YAC7F,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEpE,sDAAsD;YACtD,MAAM,gBAAgB,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;YAC1E,IAAI,gBAAgB,EAAE,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC7C,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAClD,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;YACpE,+DAA+D;YAC/D,oEAAoE;YACpE,+DAA+D;YAC/D,yCAAyC;YACzC,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC5D,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;YAE9C,+DAA+D;YAC/D,0DAA0D;YAC1D,+DAA+D;YAC/D,uCAAuC;YACvC,MAAM,aAAa,GAAoB,EAAE,CAAC;YAC1C,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;YAEnD,kCAAkC;YAClC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;YACzB,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAEhC,0DAA0D;YAC1D,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEvE,+DAA+D;YAC/D,iDAAiD;YACjD,+DAA+D;YAC/D,uDAAuD;YACvD,iEAAiE;YACjE,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAC/B,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAE/B,+DAA+D;YAC/D,8CAA8C;YAC9C,+DAA+D;YAC/D,uCAAuC;YACvC,MAAM,aAAa,GAAoB,EAAE,CAAC;YAC1C,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;YAEnD,+DAA+D;YAC/D,sCAAsC;YACtC,+DAA+D;YAC/D,yDAAyD;YACzD,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;YACzB,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;YACzB,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAElC,+DAA+D;YAC/D,mDAAmD;YACnD,+DAA+D;YAC/D,8DAA8D;YAC9D,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACxE,+DAA+D;YAC/D,uDAAuD;YACvD,+DAA+D;YAC/D,+CAA+C;YAC/C,+CAA+C;YAC/C,kCAAkC;YAClC,mEAAmE;YACnE,EAAE;YACF,wCAAwC;YACxC,0CAA0C;YAC1C,mCAAmC;YACnC,iDAAiD;YAEjD,oDAAoD;YACpD,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC5D,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAErD,MAAM,aAAa,GAAoB,EAAE,CAAC;YAC1C,MAAM,aAAa,GAAoB,EAAE,CAAC;YAE1C,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;YACnD,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;YAEnD,6DAA6D;YAC7D,6DAA6D;YAC7D,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAC/B,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAE/B,oDAAoD;YACpD,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;YACzB,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;YAEzB,6BAA6B;YAC7B,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAEhC,gEAAgE;YAChE,kEAAkE;YAClE,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxE,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAErC,iDAAiD;YACjD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC/C,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,+DAA+D;YAC/D,gDAAgD;YAChD,+DAA+D;YAC/D,kDAAkD;YAClD,+BAA+B;YAC/B,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAE3D,wEAAwE;YACxE,MAAM,SAAS,GAAI,UAAkB,CAAC,OAAO,EAAE,CAAC;YAEhD,gDAAgD;YAChD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,+DAA+D;YAC/D,yDAAyD;YACzD,+DAA+D;YAC/D,0CAA0C;YAC1C,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,OAAO,GAAG,IAAI,CAAC;YAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5B,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAClD,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;gBAC/B,OAAO,GAAG,SAAS,CAAC;YACtB,CAAC;YAED,uCAAuC;YACvC,MAAM,SAAS,GAAI,OAAe,CAAC,OAAO,EAAE,CAAC;YAE7C,0DAA0D;YAC1D,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACxE,+DAA+D;YAC/D,sDAAsD;YACtD,+DAA+D;YAC/D,uCAAuC;YACvC,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAErD,yCAAyC;YACzC,MAAM,CAAE,MAAc,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEhD,2BAA2B;YAC3B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACvD,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC5B,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAE5B,wDAAwD;YACxD,MAAM,CAAE,MAAc,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEhD,iCAAiC;YACjC,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACvD,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC5B,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAE5B,+DAA+D;YAC/D,MAAM,CAAE,MAAc,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;QAC5C,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACnE,+DAA+D;YAC/D,uCAAuC;YACvC,+DAA+D;YAC/D,sDAAsD;YACtD,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAEhD,IAAI,gBAAgB,GAAG,CAAC,CAAC;YACzB,IAAI,iBAAqC,CAAC;YAE1C,MAAM,gBAAgB,GAAqB;gBACzC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;gBACf,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;oBACb,gBAAgB,EAAE,CAAC;oBACnB,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC7B,CAAC;gBACD,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;gBACxB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;aACxB,CAAC;YAEF,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;YAEnC,6BAA6B;YAC7B,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAE3B,oCAAoC;YACpC,MAAM,CAAC,gBAAgB,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,+DAA+D;YAC/D,6CAA6C;YAC7C,+DAA+D;YAC/D,sDAAsD;YACtD,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAEhD,IAAI,sBAAsB,GAAG,CAAC,CAAC;YAC/B,IAAI,YAAiB,CAAC;YAEtB,MAAM,gBAAgB,GAAqB;gBACzC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;gBACf,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;gBACjB,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;gBACxB,aAAa,EAAE,CAAC,QAAQ,EAAE,EAAE;oBAC1B,sBAAsB,EAAE,CAAC;oBACzB,YAAY,GAAG,QAAQ,CAAC;gBAC1B,CAAC;aACF,CAAC;YAEF,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;YAEnC,wEAAwE;YACxE,2EAA2E;YAC3E,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAE3B,4DAA4D;YAC5D,MAAM,CAAC,sBAAsB,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;YACnC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,+DAA+D;YAC/D,sDAAsD;YACtD,+DAA+D;YAC/D,4DAA4D;YAC5D,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAEhD,MAAM,SAAS,GAAa,EAAE,CAAC;YAE/B,MAAM,qBAAqB,GAAqB;gBAC9C,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;gBACpC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;gBACxC,cAAc,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC;gBACtD,aAAa,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC;aACrD,CAAC;YAEF,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;YAExC,8BAA8B;YAC9B,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;YACrB,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAE3B,gCAAgC;YAChC,0DAA0D;YAC1D,0BAA0B;YAC1B,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChD,MAAM,gBAAgB,GAAG,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YAE5D,MAAM,CAAC,UAAU,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YAC7C,MAAM,CAAC,gBAAgB,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YACnD,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACxE,+DAA+D;YAC/D,4EAA4E;YAC5E,+DAA+D;YAC/D,uEAAuE;YACvE,qDAAqD;YAErD,8CAA8C;YAC9C,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAE3D,MAAM,UAAU,GAAoB,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;YAE7C,kCAAkC;YAClC,8CAA8C;YAC9C,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAEhC,yCAAyC;YACzC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEpE,sDAAsD;YACtD,MAAM,SAAS,GAAI,UAAkB,CAAC,OAAO,EAAE,CAAC;YAChD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,+DAA+D;YAC/D,uDAAuD;YACvD,+DAA+D;YAC/D,0CAA0C;YAC1C,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAErD,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAEvD,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAEvD,MAAM,OAAO,GAAoB,EAAE,CAAC;YACpC,MAAM,OAAO,GAAoB,EAAE,CAAC;YACpC,MAAM,OAAO,GAAoB,EAAE,CAAC;YAEpC,MAAM,0BAA0B,GAAG,CAAC,WAA4B,EAAoB,EAAE,CAAC,CAAC;gBACtF,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;gBACf,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;gBACnC,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;gBACxB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;aACxB,CAAC,CAAC;YAEH,OAAO,CAAC,WAAW,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;YACzD,OAAO,CAAC,WAAW,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;YACzD,OAAO,CAAC,WAAW,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;YAEzD,uDAAuD;YACvD,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAC5B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEjE,8CAA8C;YAC9C,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC5B,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAE5B,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAElE,8CAA8C;YAC9C,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC5B,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAE5B,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAC5B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAElE,+CAA+C;YAC/C,MAAM,CAAE,MAAc,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/adversarial/parent-validation.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Parent Validation Tests (TDD Red Phase)
+ *
+ * These tests validate the attachChild() method properly prevents
+ * attaching a child workflow that already has a different parent.
+ *
+ * This is the RED phase of TDD - tests are written to FAIL initially,
+ * documenting the expected behavior before implementation.
+ *
+ * Related: plan/docs/bugfix-architecture/bug_analysis.md
+ */
+export {};
+//# sourceMappingURL=parent-validation.test.d.ts.map

package/dist/__tests__/adversarial/parent-validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-validation.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/adversarial/parent-validation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/__tests__/adversarial/parent-validation.test.js

@@ -0,0 +1,128 @@
+/**
+ * Parent Validation Tests (TDD Red Phase)
+ *
+ * These tests validate the attachChild() method properly prevents
+ * attaching a child workflow that already has a different parent.
+ *
+ * This is the RED phase of TDD - tests are written to FAIL initially,
+ * documenting the expected behavior before implementation.
+ *
+ * Related: plan/docs/bugfix-architecture/bug_analysis.md
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { Workflow } from '../../index.js';
+/**
+ * SimpleWorkflow class for testing
+ * Pattern from: src/__tests__/unit/workflow.test.ts:4-11
+ */
+class SimpleWorkflow extends Workflow {
+    async run() {
+        this.setStatus('running');
+        this.setStatus('completed');
+        return 'done';
+    }
+}
+describe('Adversarial: Parent Validation', () => {
+    /**
+     * Setup: Mock console methods to capture error messages
+     * Pattern from: research/console-mocking.md "Basic Spying Patterns"
+     */
+    beforeEach(() => {
+        vi.spyOn(console, 'log').mockImplementation(() => { });
+        vi.spyOn(console, 'error').mockImplementation(() => { });
+        vi.spyOn(console, 'warn').mockImplementation(() => { });
+    });
+    /**
+     * Teardown: Restore all mocks to prevent test pollution
+     * CRITICAL: Always use vi.restoreAllMocks() in afterEach
+     */
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    /**
+     * Primary failing test for parent validation bug
+     *
+     * Bug: attachChild() only checks if child is already attached to THIS workflow
+     * It does NOT check if child already has a different parent
+     *
+     * Expected: Error thrown with message containing 'already has a parent'
+     * Actual: No error thrown, inconsistent tree state created
+     *
+     * Pattern from: research/error-assertions.md "Partial Message Matching"
+     */
+    it('should throw when attaching child that already has a different parent', () => {
+        // ARRANGE: Create two parent workflows
+        const parent1 = new SimpleWorkflow('Parent1');
+        const parent2 = new SimpleWorkflow('Parent2');
+        // ARRANGE: Create child with parent1 (constructor auto-attaches)
+        // CRITICAL: Constructor calls parent.attachChild(this) at workflow.ts:113-116
+        const child = new SimpleWorkflow('Child', parent1);
+        // Verify initial state
+        expect(child.parent).toBe(parent1);
+        expect(parent1.children).toContain(child);
+        // ACT & ASSERT: Attempting to attach child to parent2 should throw
+        // This test FAILS because attachChild() doesn't check child.parent !== this
+        expect(() => parent2.attachChild(child)).toThrow('already has a parent');
+    });
+    /**
+     * Test: Manual Parent Mutation with 'as any'
+     *
+     * Scenario: Even if someone manually mutates child.parent using 'as any',
+     * attachChild() should still validate and throw an error.
+     *
+     * This tests the defensive programming aspect - that the existing validation
+     * checks catch inconsistent state even when TypeScript type safety is bypassed.
+     *
+     * The attachChild() method has two validation checks (in order):
+     * 1. Line 217-219: children.includes(child) check
+     * 2. Line 222-228: child.parent !== null && child.parent !== this check
+     *
+     * When we manually mutate (child as any).parent = parent2, the child is
+     * still in parent1.children, so the first check throws first.
+     *
+     * Pattern from: plan/bugfix/P1M3T1S2/PRP.md "Manual Parent Mutation Test"
+     */
+    it('should throw when manually mutating parent with as any then calling attachChild', () => {
+        // ARRANGE: Create two parent workflows
+        const parent1 = new SimpleWorkflow('Parent1');
+        const parent2 = new SimpleWorkflow('Parent2');
+        // ARRANGE: Create child with parent1 (constructor auto-attaches)
+        // CRITICAL: Constructor calls parent.attachChild(this) at workflow.ts:113-116
+        const child = new SimpleWorkflow('Child', parent1);
+        // Verify initial state - child should be attached to parent1
+        expect(child.parent).toBe(parent1);
+        expect(parent1.children).toContain(child);
+        // ARRANGE: Manually mutate child.parent using 'as any' to bypass TypeScript
+        // This simulates a developer bypassing the type system
+        child.parent = parent2;
+        // Verify manual mutation worked
+        expect(child.parent).toBe(parent2); // Now points to parent2
+        expect(parent1.children).toContain(child); // But still in parent1's children array!
+        // ACT & ASSERT: parent1.attachChild(child) should throw
+        // The validation at workflow.ts:217-219 checks children.includes(child) first
+        // Since child is still in parent1.children, it throws "Child already attached"
+        // This is defensive programming - even manual mutation is caught
+        expect(() => parent1.attachChild(child)).toThrow('Child already attached to this workflow');
+    });
+    /**
+     * Verify console.error is called with helpful message
+     *
+     * Pattern from: research/console-mocking.md "Verifying Error Messages"
+     */
+    it('should log helpful error message to console when attaching child with existing parent', () => {
+        // ARRANGE
+        const parent1 = new SimpleWorkflow('Parent1');
+        const parent2 = new SimpleWorkflow('Parent2');
+        const child = new SimpleWorkflow('Child', parent1);
+        // ACT: Attempt the invalid attachment
+        try {
+            parent2.attachChild(child);
+        }
+        catch (err) {
+            // Expected error - test will fail because error isn't thrown yet
+        }
+        // ASSERT: Console.error should be called with helpful message
+        expect(console.error).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=parent-validation.test.js.map

package/dist/__tests__/adversarial/parent-validation.test.js.map

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

package/dist/__tests__/adversarial/prd-12-2-compliance.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PRD Section 12.2 Compliance Tests
+ *
+ * PRD Reference: PRPs/PRDs/001-hierarchical-workflow-engine.md, Section 12.2 (lines 311-368)
+ *
+ * These tests explicitly validate ALL requirements from PRD Section 12.2 for the Workflow Base Class
+ * related to parent-child tree structure integrity:
+ *
+ * PRD Section 12.2 Requirements:
+ * 1. Child has exactly one parent
+ * 2. child.parent matches parent (bidirectional link)
+ * 3. Child appears in only one parent's children array
+ * 4. Node tree mirrors workflow tree (1:1 correspondence)
+ *
+ * Each test includes clear documentation linking assertions to specific PRD requirements.
+ *
+ * Related: plan/bugfix/P1M3T2S1/PRP.md - PRD compliance validation for attachChild() bug fix
+ */
+export {};
+//# sourceMappingURL=prd-12-2-compliance.test.d.ts.map

package/dist/__tests__/adversarial/prd-12-2-compliance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-12-2-compliance.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/adversarial/prd-12-2-compliance.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}