groundswell 0.0.1 → 0.0.3

package/dist/__tests__/adversarial/complex-circular-reference.test.d.ts.map

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

package/dist/__tests__/adversarial/complex-circular-reference.test.js

@@ -0,0 +1,127 @@
+/**
+ * Complex Circular Reference Tests
+ *
+ * These tests validate that isDescendantOf() correctly detects circular
+ * references at various depths in the workflow tree.
+ *
+ * Test Cases:
+ * 1. Immediate circular reference (depth 1): child.attachChild(parent)
+ * 2. Two-level circular reference (depth 2): grandchild.attachChild(root)
+ * 3. Three-level circular reference (depth 3): great-grandchild.attachChild(root)
+ *
+ * Pattern from: plan/docs/bugfix-architecture/implementation_patterns.md Pattern 8
+ * Related: plan/bugfix/P1M3T1S3/PRP.md
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { Workflow } from '../../index.js';
+/**
+ * SimpleWorkflow class for testing
+ * Pattern from: src/__tests__/adversarial/circular-reference.test.ts:20-26
+ */
+class SimpleWorkflow extends Workflow {
+    async run() {
+        this.setStatus('running');
+        this.setStatus('completed');
+        return 'done';
+    }
+}
+describe('Adversarial: Complex Circular Reference Detection', () => {
+    /**
+     * Setup: Mock console methods to capture error messages
+     * Pattern from: src/__tests__/adversarial/circular-reference.test.ts:33-37
+     */
+    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();
+    });
+    /**
+     * Test 1: Immediate Circular Reference (depth 1)
+     *
+     * Validates that attachChild() prevents creating a cycle when a child
+     * attempts to attach its immediate parent as its child.
+     *
+     * Hierarchy: root -> child1
+     * Cycle attempt: child1.attachChild(root)
+     *
+     * Expected: Error thrown with message containing 'circular' OR 'cycle' OR 'ancestor'
+     */
+    it('should throw when attaching immediate parent as child (depth 1)', () => {
+        // ARRANGE: Create 2-level hierarchy (root, child1)
+        const root = new SimpleWorkflow('Root');
+        const child1 = new SimpleWorkflow('Child1', root);
+        // Verify initial state
+        // CRITICAL: Constructor auto-attaches child to parent at workflow.ts:113-116
+        expect(child1.parent).toBe(root);
+        expect(root.children).toContain(child1);
+        // ACT & ASSERT: Attempting to attach parent as child should throw
+        // This validates isDescendantOf() detects the immediate ancestor
+        expect(() => child1.attachChild(root)).toThrow(/circular|cycle|ancestor/i);
+    });
+    /**
+     * Test 2: Two-Level Circular Reference (depth 2)
+     *
+     * Validates that attachChild() prevents creating a cycle when a grandchild
+     * attempts to attach its grandparent (root) as its child.
+     *
+     * Hierarchy: root -> child1 -> child2
+     * Cycle attempt: child2.attachChild(root)
+     *
+     * Expected: Error thrown with message containing 'circular' OR 'cycle' OR 'ancestor'
+     */
+    it('should throw when attaching grandparent as child (depth 2)', () => {
+        // ARRANGE: Create 3-level hierarchy (root, child1, child2)
+        const root = new SimpleWorkflow('Root');
+        const child1 = new SimpleWorkflow('Child1', root);
+        const child2 = new SimpleWorkflow('Child2', child1);
+        // Verify initial state
+        // CRITICAL: Constructor auto-attaches at workflow.ts:113-116
+        expect(child2.parent).toBe(child1);
+        expect(child1.parent).toBe(root);
+        expect(root.children).toContain(child1);
+        expect(child1.children).toContain(child2);
+        // ACT & ASSERT: Attempting to attach root as child of child2 should throw
+        // This validates isDescendantOf() traverses the full ancestor chain
+        expect(() => child2.attachChild(root)).toThrow(/circular|cycle|ancestor/i);
+    });
+    /**
+     * Test 3: Three-Level Circular Reference (depth 3)
+     *
+     * Validates that attachChild() prevents creating a cycle when a great-grandchild
+     * attempts to attach its great-grandparent (root) as its child.
+     *
+     * Hierarchy: root -> child1 -> child2 -> child3
+     * Cycle attempt: child3.attachChild(root)
+     *
+     * Expected: Error thrown with message containing 'circular' OR 'cycle' OR 'ancestor'
+     *
+     * This test provides NEW coverage not present in circular-reference.test.ts
+     * which only tests depth 1 (immediate parent) and depth 2 (ancestor).
+     */
+    it('should throw when attaching great-grandparent as child (depth 3)', () => {
+        // ARRANGE: Create 4-level hierarchy (root, child1, child2, child3)
+        const root = new SimpleWorkflow('Root');
+        const child1 = new SimpleWorkflow('Child1', root); // root -> child1
+        const child2 = new SimpleWorkflow('Child2', child1); // root -> child1 -> child2
+        const child3 = new SimpleWorkflow('Child3', child2); // root -> child1 -> child2 -> child3
+        // Verify initial state
+        // CRITICAL: Constructor auto-attaches at workflow.ts:113-116
+        expect(child3.parent).toBe(child2);
+        expect(child2.parent).toBe(child1);
+        expect(child1.parent).toBe(root);
+        expect(root.children).toContain(child1);
+        expect(child1.children).toContain(child2);
+        expect(child2.children).toContain(child3);
+        // ACT & ASSERT: Attempting to attach root as child of child3 should throw
+        // This validates isDescendantOf() detects deep ancestors (3+ levels)
+        expect(() => child3.attachChild(root)).toThrow(/circular|cycle|ancestor/i);
+    });
+});
+//# sourceMappingURL=complex-circular-reference.test.js.map

package/dist/__tests__/adversarial/complex-circular-reference.test.js.map

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

package/dist/__tests__/adversarial/concurrent-task-failures.test.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Concurrent Task Failure Scenarios Test Suite
+ *
+ * Tests the Promise.allSettled implementation in @Task decorator
+ * for concurrent execution with various failure scenarios.
+ *
+ * Validates:
+ * - Single child failure in concurrent batch
+ * - Multiple children failing concurrently
+ * - Mixed success/failure scenarios
+ * - All children failing edge case
+ * - No orphaned or hanging promises
+ * - Error collection correctness
+ * - Event emission during failures
+ *
+ * Related:
+ * - S2 Implementation: Promise.allSettled in task.ts (lines 111-120)
+ * - Bug: 001_e8e04329daf3 - Concurrent task error collection
+ */
+export {};
+//# sourceMappingURL=concurrent-task-failures.test.d.ts.map

package/dist/__tests__/adversarial/concurrent-task-failures.test.d.ts.map

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