groundswell 0.0.1 → 0.0.3

package/dist/__tests__/integration/tree-mirroring.test.js

@@ -0,0 +1,117 @@
+import { describe, it, expect } from 'vitest';
+import { TDDOrchestrator, WorkflowTreeDebugger, } from '../../index.js';
+describe('Tree Mirroring Integration', () => {
+    it('should create 1:1 tree mirror of workflow execution', async () => {
+        const orchestrator = new TDDOrchestrator('TDDOrchestrator');
+        orchestrator.maxCycles = 1; // Limit to one cycle for test
+        const debugger_ = new WorkflowTreeDebugger(orchestrator);
+        const events = [];
+        debugger_.events.subscribe({
+            next: (event) => events.push(event),
+        });
+        try {
+            await orchestrator.run();
+        }
+        catch {
+            // May fail due to random test failures, that's ok
+        }
+        // Verify tree structure
+        const tree = debugger_.getTree();
+        expect(tree.name).toBe('TDDOrchestrator');
+        // Should have at least one child (the cycle)
+        expect(tree.children.length).toBeGreaterThanOrEqual(1);
+        // Child should be named Cycle-N
+        const cycleChild = tree.children.find((c) => c.name.startsWith('Cycle-'));
+        expect(cycleChild).toBeDefined();
+        // Verify events were captured
+        expect(events.some((e) => e.type === 'stepStart')).toBe(true);
+        expect(events.some((e) => e.type === 'taskStart')).toBe(true);
+    });
+    it('should propagate events to root observer', async () => {
+        const orchestrator = new TDDOrchestrator('Root');
+        orchestrator.maxCycles = 1;
+        const allEvents = [];
+        const allLogs = [];
+        const observer = {
+            onLog: (entry) => allLogs.push(entry),
+            onEvent: (event) => allEvents.push(event),
+            onStateUpdated: () => { },
+            onTreeChanged: () => { },
+        };
+        orchestrator.addObserver(observer);
+        try {
+            await orchestrator.run();
+        }
+        catch {
+            // May fail
+        }
+        // Events from child workflows should reach root
+        expect(allLogs.length).toBeGreaterThan(0);
+        expect(allEvents.length).toBeGreaterThan(0);
+        // Should have events from both parent and child
+        const parentEvents = allEvents.filter((e) => 'node' in e && e.node.name === 'Root');
+        const childEvents = allEvents.filter((e) => 'node' in e && e.node.name.startsWith('Cycle-'));
+        expect(parentEvents.length).toBeGreaterThan(0);
+        expect(childEvents.length).toBeGreaterThan(0);
+    });
+    it('should include state snapshot on error', async () => {
+        const orchestrator = new TDDOrchestrator('ErrorTest');
+        orchestrator.maxCycles = 1;
+        const errorEvents = [];
+        orchestrator.addObserver({
+            onLog: () => { },
+            onEvent: (event) => {
+                if (event.type === 'error') {
+                    errorEvents.push(event);
+                }
+            },
+            onStateUpdated: () => { },
+            onTreeChanged: () => { },
+        });
+        try {
+            await orchestrator.run();
+        }
+        catch {
+            // Expected
+        }
+        // If there was an error, it should have state
+        if (errorEvents.length > 0) {
+            const errEvent = errorEvents[0];
+            if (errEvent.type === 'error') {
+                expect(errEvent.error.state).toBeDefined();
+                expect(errEvent.error.logs).toBeDefined();
+                expect(errEvent.error.workflowId).toBeDefined();
+            }
+        }
+    });
+    it('should propagate treeUpdated events to root observers', () => {
+        // ARRANGE: Create parent-child workflow tree
+        const parent = new TDDOrchestrator('Parent');
+        const child = new TDDOrchestrator('Child', parent);
+        // ARRANGE: Set up observer with collection arrays
+        const events = [];
+        const treeChangedCalls = [];
+        // ARRANGE: Create inline observer
+        const observer = {
+            onLog: () => { }, // Empty - not testing logs
+            onEvent: (event) => events.push(event), // Capture events
+            onStateUpdated: () => { }, // Empty - not testing state updates
+            onTreeChanged: (root) => treeChangedCalls.push(root), // Capture tree changes
+        };
+        // ARRANGE: Attach observer to ROOT (parent, not child)
+        parent.addObserver(observer);
+        // ACT: Trigger status change on CHILD workflow
+        child.setStatus('completed');
+        // ASSERT: Verify treeUpdated event was received via onEvent
+        const treeUpdatedEvent = events.find((e) => e.type === 'treeUpdated');
+        expect(treeUpdatedEvent).toBeDefined();
+        // ASSERT: Type guard for discriminated union + verify root node
+        if (treeUpdatedEvent && treeUpdatedEvent.type === 'treeUpdated') {
+            expect(treeUpdatedEvent.root).toBe(parent.getNode());
+        }
+        // ASSERT: Verify onTreeChanged callback was invoked
+        expect(treeChangedCalls).toHaveLength(1);
+        expect(treeChangedCalls[0]).toBe(parent.getNode());
+    });
+});
+//# sourceMappingURL=tree-mirroring.test.js.map

package/dist/__tests__/integration/tree-mirroring.test.js.map

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

package/dist/__tests__/integration/workflow-reparenting.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Integration Test: Reparenting Observer Propagation
+ *
+ * Validates that observer propagation correctly updates when a child
+ * workflow is reparented from one parent to another.
+ *
+ * Pattern 7 (from bug_fix_tasks.json):
+ * "Observer propagation should update after reparenting.
+ *  Events from child should only reach new parent's observers."
+ */
+export {};
+//# sourceMappingURL=workflow-reparenting.test.d.ts.map

package/dist/__tests__/integration/workflow-reparenting.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-reparenting.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/workflow-reparenting.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/integration/workflow-reparenting.test.js

@@ -0,0 +1,239 @@
+/**
+ * Integration Test: Reparenting Observer Propagation
+ *
+ * Validates that observer propagation correctly updates when a child
+ * workflow is reparented from one parent to another.
+ *
+ * Pattern 7 (from bug_fix_tasks.json):
+ * "Observer propagation should update after reparenting.
+ *  Events from child should only reach new parent's observers."
+ */
+import { describe, it, expect } from 'vitest';
+import { Workflow, WorkflowTreeDebugger, } 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('Integration: Reparenting Observer Propagation', () => {
+    it('should update observer propagation after reparenting', () => {
+        // ============================================================
+        // PHASE 1: Setup - Create parent1, parent2, and child
+        // ============================================================
+        // ARRANGE: Create two root workflows (both have parent = null)
+        const parent1 = new SimpleWorkflow('Parent1');
+        const parent2 = new SimpleWorkflow('Parent2');
+        // ARRANGE: Create child attached to parent1 (via constructor)
+        const child = new SimpleWorkflow('Child', parent1);
+        // ASSERT: Verify initial state
+        expect(child.parent).toBe(parent1);
+        expect(parent1.children).toContain(child);
+        expect(parent2.children).not.toContain(child);
+        // ============================================================
+        // PHASE 2: Verify parent1 observer receives events
+        // ============================================================
+        // ARRANGE: Create observer for parent1
+        const parent1Events = [];
+        const parent1Observer = {
+            onLog: () => { }, // Empty - not testing logs
+            onEvent: (event) => parent1Events.push(event), // Capture events
+            onStateUpdated: () => { }, // Empty - not testing state updates
+            onTreeChanged: () => { }, // Empty - not testing tree changes
+        };
+        // ACT: Attach observer to parent1 (must be root workflow)
+        parent1.addObserver(parent1Observer);
+        // ACT: Child emits event (triggers treeUpdated via setStatus)
+        // PATTERN: setStatus() emits treeUpdated event
+        parent1Events.length = 0; // Clear any construction events
+        child.setStatus('running');
+        // ASSERT: Verify parent1 observer received the event
+        const parent1ReceivedEvent = parent1Events.find((e) => e.type === 'treeUpdated');
+        expect(parent1ReceivedEvent).toBeDefined();
+        // ============================================================
+        // PHASE 3: Reparent child from parent1 to parent2
+        // ============================================================
+        // ARRANGE: Create observer for parent2
+        const parent2Events = [];
+        const parent2Observer = {
+            onLog: () => { },
+            onEvent: (event) => parent2Events.push(event),
+            onStateUpdated: () => { },
+            onTreeChanged: () => { },
+        };
+        // ACT: Reparent using detach + attach pattern
+        // CRITICAL: Must detach before attaching to new parent
+        parent1.detachChild(child);
+        parent2.attachChild(child);
+        parent2.addObserver(parent2Observer);
+        // ASSERT: Verify reparenting succeeded
+        expect(child.parent).toBe(parent2);
+        expect(parent2.children).toContain(child);
+        expect(parent1.children).not.toContain(child);
+        // ============================================================
+        // PHASE 4: Verify parent2 observer receives events after reparenting
+        // ============================================================
+        // ACT: Clear events to isolate post-reparenting behavior
+        parent1Events.length = 0;
+        parent2Events.length = 0;
+        // ACT: Child emits event again
+        child.setStatus('completed');
+        // ASSERT: Verify parent2 observer received the event
+        const parent2ReceivedEvent = parent2Events.find((e) => e.type === 'treeUpdated');
+        expect(parent2ReceivedEvent).toBeDefined();
+        // ============================================================
+        // PHASE 5: CRITICAL VALIDATION - parent1 observer does NOT receive events
+        // ============================================================
+        // ASSERT: Verify parent1 observer did NOT receive the post-reparenting event
+        const parent1DidNotReceive = parent1Events.find((e) => e.type === 'treeUpdated');
+        expect(parent1DidNotReceive).toBeUndefined();
+        // ASSERT: Verify event count for parent1 is zero
+        expect(parent1Events.length).toBe(0);
+    });
+    it('should handle multiple reparenting cycles correctly', () => {
+        // ARRANGE: Create three potential parents
+        const parentA = new SimpleWorkflow('ParentA');
+        const parentB = new SimpleWorkflow('ParentB');
+        const parentC = new SimpleWorkflow('ParentC');
+        // ARRANGE: Create child and observers for each parent
+        const child = new SimpleWorkflow('Child', parentA);
+        const eventsA = [];
+        const eventsB = [];
+        const eventsC = [];
+        const createObserver = (eventsArray) => ({
+            onLog: () => { },
+            onEvent: (e) => eventsArray.push(e),
+            onStateUpdated: () => { },
+            onTreeChanged: () => { },
+        });
+        parentA.addObserver(createObserver(eventsA));
+        parentB.addObserver(createObserver(eventsB));
+        parentC.addObserver(createObserver(eventsC));
+        // ACT & ASSERT: Cycle 1 - A -> B
+        eventsA.length = 0;
+        child.setStatus('running');
+        expect(eventsA.some((e) => e.type === 'treeUpdated')).toBe(true);
+        parentA.detachChild(child);
+        parentB.attachChild(child);
+        eventsA.length = 0;
+        eventsB.length = 0;
+        child.setStatus('completed');
+        expect(eventsB.some((e) => e.type === 'treeUpdated')).toBe(true);
+        expect(eventsA.some((e) => e.type === 'treeUpdated')).toBe(false);
+        // ACT & ASSERT: Cycle 2 - B -> C
+        parentB.detachChild(child);
+        parentC.attachChild(child);
+        eventsB.length = 0;
+        eventsC.length = 0;
+        child.setStatus('running');
+        expect(eventsC.some((e) => e.type === 'treeUpdated')).toBe(true);
+        expect(eventsB.some((e) => e.type === 'treeUpdated')).toBe(false);
+        // ACT & ASSERT: Cycle 3 - C -> A (return to original)
+        parentC.detachChild(child);
+        parentA.attachChild(child);
+        eventsC.length = 0;
+        eventsA.length = 0;
+        child.setStatus('completed');
+        expect(eventsA.some((e) => e.type === 'treeUpdated')).toBe(true);
+        expect(eventsC.some((e) => e.type === 'treeUpdated')).toBe(false);
+    });
+    it('should verify tree consistency after reparenting using debugger', () => {
+        // ============================================================
+        // PHASE 1: Setup - Create parent1, parent2, and child
+        // ============================================================
+        // ARRANGE: Create two root workflows
+        const parent1 = new SimpleWorkflow('Parent1');
+        const parent2 = new SimpleWorkflow('Parent2');
+        // ARRANGE: Create child attached to parent1 (via constructor)
+        const child = new SimpleWorkflow('Child', parent1);
+        // ARRANGE: Create debugger attached to parent1
+        const parent1Debugger = new WorkflowTreeDebugger(parent1);
+        // ASSERT: Verify initial tree structure
+        expect(child.parent).toBe(parent1);
+        expect(parent1.children).toContain(child);
+        expect(parent2.children).not.toContain(child);
+        // ASSERT: Verify debugger sees initial structure
+        const initialTree = parent1Debugger.getTree();
+        expect(initialTree.name).toBe('Parent1');
+        expect(initialTree.children.length).toBe(1);
+        expect(initialTree.children[0].name).toBe('Child');
+        // ============================================================
+        // PHASE 2: Reparenting operation
+        // ============================================================
+        // ACT: Reparent child from parent1 to parent2
+        parent1.detachChild(child);
+        parent2.attachChild(child);
+        // ASSERT: Verify basic reparenting succeeded
+        expect(child.parent).toBe(parent2);
+        expect(parent2.children).toContain(child);
+        expect(parent1.children).not.toContain(child);
+        // ============================================================
+        // PHASE 3: Verify workflow tree structure
+        // ============================================================
+        // ASSERT: Verify child.parent points to new parent
+        expect(child.parent).toBe(parent2);
+        // ASSERT: Verify new parent.children includes child
+        expect(parent2.children).toContain(child);
+        // ASSERT: Verify old parent.children does NOT include child
+        expect(parent1.children).not.toContain(child);
+        // ============================================================
+        // PHASE 4: Verify node tree structure using debugger
+        // ============================================================
+        // NOTE: parent1Debugger is still attached to parent1, so it shows parent1's tree
+        // Create debugger for parent2 to see the new tree structure
+        const parent2Debugger = new WorkflowTreeDebugger(parent2);
+        // ASSERT: Verify debugger can find child node
+        const childNode = parent2Debugger.getNode(child.id);
+        expect(childNode).toBeDefined();
+        expect(childNode?.name).toBe('Child');
+        // ASSERT: Verify child's node parent is parent2's node (node tree mirrors workflow tree)
+        const parent2NodeDirect = parent2.getNode();
+        expect(childNode?.parent).toBe(parent2NodeDirect);
+        // ASSERT: Verify parent2's node children includes child's node
+        const parent2Node = parent2Debugger.getNode(parent2.id);
+        const childNodeDirect = child.getNode();
+        expect(parent2Node?.children).toContain(childNodeDirect);
+        // ASSERT: Verify parent1's node children does NOT include child's node
+        const parent1Node = parent1Debugger.getNode(parent1.id);
+        expect(parent1Node?.children).not.toContain(childNodeDirect);
+        // ============================================================
+        // PHASE 5: Visual validation using toTreeString()
+        // ============================================================
+        // ACT: Get tree string for visual debugging
+        const parent2TreeString = parent2Debugger.toTreeString();
+        // ASSERT: Verify tree structure in ASCII representation
+        expect(parent2TreeString).toContain('Parent2');
+        expect(parent2TreeString).toContain('Child');
+        expect(parent2TreeString).toContain('└──'); // Tree connector symbol
+        // ============================================================
+        // PHASE 6: Statistical validation
+        // ============================================================
+        const parent2Stats = parent2Debugger.getStats();
+        expect(parent2Stats.totalNodes).toBe(2); // parent2 + child = 2
+        // ============================================================
+        // CRITICAL VALIDATION: 1:1 Tree Mirror Invariant
+        // ============================================================
+        // Verify workflow tree and node tree are perfectly synchronized
+        // This is the core invariant that must be maintained
+        // Workflow tree state:
+        expect(child.parent).toBe(parent2);
+        expect(parent2.children).toEqual([child]);
+        expect(parent1.children).toEqual([]);
+        // Node tree state (via getNode() method):
+        const childNodeFinal = child.getNode();
+        const parent2NodeFinal = parent2.getNode();
+        const parent1NodeFinal = parent1.getNode();
+        expect(childNodeFinal.parent).toBe(parent2NodeFinal);
+        expect(parent2NodeFinal.children).toEqual([childNodeFinal]);
+        expect(parent1NodeFinal.children).toEqual([]);
+        // Cross-verification: debugger lookup matches direct access
+        expect(parent2Debugger.getNode(child.id)).toBe(childNodeFinal);
+        expect(parent2Debugger.getNode(parent2.id)).toBe(parent2NodeFinal);
+    });
+});
+//# sourceMappingURL=workflow-reparenting.test.js.map

package/dist/__tests__/integration/workflow-reparenting.test.js.map

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

package/dist/__tests__/unit/agent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent.test.d.ts.map

package/dist/__tests__/unit/agent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/agent.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/agent.test.js

@@ -0,0 +1,143 @@
+import { describe, it, expect } from 'vitest';
+import { Agent } from '../../core/agent.js';
+import { MCPHandler } from '../../core/mcp-handler.js';
+describe('Agent', () => {
+    it('should create with unique id', () => {
+        const a1 = new Agent();
+        const a2 = new Agent();
+        expect(a1.id).not.toBe(a2.id);
+    });
+    it('should use default name when not provided', () => {
+        const agent = new Agent();
+        expect(agent.name).toBe('Agent');
+    });
+    it('should use custom name when provided', () => {
+        const agent = new Agent({ name: 'CustomAgent' });
+        expect(agent.name).toBe('CustomAgent');
+    });
+    it('should provide access to MCP handler', () => {
+        const agent = new Agent();
+        const handler = agent.getMcpHandler();
+        expect(handler).toBeInstanceOf(MCPHandler);
+    });
+    it('should register MCP servers from config', () => {
+        const agent = new Agent({
+            mcps: [
+                {
+                    name: 'test-mcp',
+                    transport: 'inprocess',
+                    tools: [
+                        {
+                            name: 'test_tool',
+                            description: 'A test tool',
+                            input_schema: { type: 'object', properties: {} },
+                        },
+                    ],
+                },
+            ],
+        });
+        const handler = agent.getMcpHandler();
+        expect(handler.getServerNames()).toContain('test-mcp');
+        expect(handler.hasTool('test-mcp__test_tool')).toBe(true);
+    });
+});
+describe('MCPHandler', () => {
+    it('should register and unregister servers', () => {
+        const handler = new MCPHandler();
+        handler.registerServer({
+            name: 'server1',
+            transport: 'inprocess',
+        });
+        expect(handler.getServerNames()).toContain('server1');
+        handler.unregisterServer('server1');
+        expect(handler.getServerNames()).not.toContain('server1');
+    });
+    it('should throw when registering duplicate server', () => {
+        const handler = new MCPHandler();
+        handler.registerServer({
+            name: 'server1',
+            transport: 'inprocess',
+        });
+        expect(() => handler.registerServer({
+            name: 'server1',
+            transport: 'inprocess',
+        })).toThrow("MCP server 'server1' is already registered");
+    });
+    it('should convert tools to full names', () => {
+        const handler = new MCPHandler();
+        handler.registerServer({
+            name: 'myserver',
+            transport: 'inprocess',
+            tools: [
+                {
+                    name: 'tool1',
+                    description: 'Tool 1',
+                    input_schema: { type: 'object', properties: {} },
+                },
+                {
+                    name: 'tool2',
+                    description: 'Tool 2',
+                    input_schema: { type: 'object', properties: {} },
+                },
+            ],
+        });
+        const tools = handler.getTools();
+        expect(tools).toHaveLength(2);
+        expect(tools[0].name).toBe('myserver__tool1');
+        expect(tools[1].name).toBe('myserver__tool2');
+    });
+    it('should execute registered tool', async () => {
+        const handler = new MCPHandler();
+        handler.registerServer({
+            name: 'math',
+            transport: 'inprocess',
+            tools: [
+                {
+                    name: 'add',
+                    description: 'Add two numbers',
+                    input_schema: {
+                        type: 'object',
+                        properties: {
+                            a: { type: 'number' },
+                            b: { type: 'number' },
+                        },
+                    },
+                },
+            ],
+        });
+        handler.registerToolExecutor('math', 'add', async (input) => {
+            const { a, b } = input;
+            return a + b;
+        });
+        const result = await handler.executeTool('math__add', { a: 2, b: 3 });
+        expect(result.content).toBe('5');
+        expect(result.is_error).toBeUndefined();
+    });
+    it('should return error for unknown tool', async () => {
+        const handler = new MCPHandler();
+        const result = await handler.executeTool('unknown__tool', {});
+        expect(result.is_error).toBe(true);
+        expect(result.content).toContain('not found');
+    });
+    it('should return error when tool throws', async () => {
+        const handler = new MCPHandler();
+        handler.registerServer({
+            name: 'failing',
+            transport: 'inprocess',
+            tools: [
+                {
+                    name: 'fail',
+                    description: 'Always fails',
+                    input_schema: { type: 'object', properties: {} },
+                },
+            ],
+        });
+        handler.registerToolExecutor('failing', 'fail', async () => {
+            throw new Error('Tool error');
+        });
+        const result = await handler.executeTool('failing__fail', {});
+        expect(result.is_error).toBe(true);
+        expect(result.content).toContain('Tool error');
+    });
+});
+//# sourceMappingURL=agent.test.js.map

package/dist/__tests__/unit/agent.test.js.map

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

package/dist/__tests__/unit/cache-key.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for cache key generation
+ */
+export {};
+//# sourceMappingURL=cache-key.test.d.ts.map

package/dist/__tests__/unit/cache-key.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/cache-key.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}