@claude-flow/shared 3.0.0-alpha.1

package/dist/events/state-reconstructor.d.ts

@@ -0,0 +1,101 @@
+/**
+ * State Reconstructor - ADR-007 Implementation
+ *
+ * Reconstructs aggregate state from event streams.
+ * Implements event sourcing patterns for V3.
+ *
+ * @module v3/shared/events/state-reconstructor
+ */
+import { EventStore } from './event-store.js';
+import type { DomainEvent } from './domain-events.js';
+/**
+ * Aggregate root interface
+ */
+export interface AggregateRoot {
+    id: string;
+    version: number;
+    apply(event: DomainEvent): void;
+    getState(): Record<string, unknown>;
+}
+/**
+ * Reconstructor options
+ */
+export interface ReconstructorOptions {
+    useSnapshots: boolean;
+    snapshotInterval: number;
+    maxEventsToReplay: number;
+}
+/**
+ * State Reconstructor
+ *
+ * Reconstructs aggregate state from event history.
+ * Supports snapshots for performance optimization.
+ */
+export declare class StateReconstructor {
+    private readonly eventStore;
+    private readonly options;
+    constructor(eventStore: EventStore, options?: Partial<ReconstructorOptions>);
+    /**
+     * Reconstruct aggregate state from events
+     */
+    reconstruct<T extends AggregateRoot>(aggregateId: string, factory: (id: string) => T): Promise<T>;
+    /**
+     * Reconstruct state at a specific point in time
+     */
+    reconstructAtTime<T extends AggregateRoot>(aggregateId: string, factory: (id: string) => T, timestamp: Date): Promise<T>;
+    /**
+     * Reconstruct state at a specific version
+     */
+    reconstructAtVersion<T extends AggregateRoot>(aggregateId: string, factory: (id: string) => T, targetVersion: number): Promise<T>;
+    /**
+     * Apply snapshot to aggregate
+     */
+    private applySnapshot;
+    /**
+     * Create snapshot for aggregate
+     */
+    private createSnapshot;
+    /**
+     * Get aggregate type from instance
+     */
+    private getAggregateType;
+}
+/**
+ * Agent Aggregate - Example implementation
+ */
+export declare class AgentAggregate implements AggregateRoot {
+    id: string;
+    version: number;
+    private state;
+    constructor(id: string);
+    apply(event: DomainEvent): void;
+    getState(): Record<string, unknown>;
+    restoreFromSnapshot(snapshotState: unknown): void;
+    get name(): string;
+    get role(): string;
+    get status(): string;
+    get currentTask(): string | null;
+    get completedTasks(): string[];
+    get capabilities(): string[];
+}
+/**
+ * Task Aggregate - Example implementation
+ */
+export declare class TaskAggregate implements AggregateRoot {
+    id: string;
+    version: number;
+    private state;
+    constructor(id: string);
+    apply(event: DomainEvent): void;
+    getState(): Record<string, unknown>;
+    restoreFromSnapshot(snapshotState: unknown): void;
+    get title(): string;
+    get status(): string;
+    get assignedAgent(): string | null;
+    get result(): unknown;
+}
+/**
+ * Factory function
+ */
+export declare function createStateReconstructor(eventStore: EventStore, options?: Partial<ReconstructorOptions>): StateReconstructor;
+//# sourceMappingURL=state-reconstructor.d.ts.map

package/dist/events/state-reconstructor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-reconstructor.d.ts","sourceRoot":"","sources":["../../src/events/state-reconstructor.ts"],"names":[],"mappings":"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"}

package/dist/events/state-reconstructor.js

@@ -0,0 +1,263 @@
+/**
+ * State Reconstructor - ADR-007 Implementation
+ *
+ * Reconstructs aggregate state from event streams.
+ * Implements event sourcing patterns for V3.
+ *
+ * @module v3/shared/events/state-reconstructor
+ */
+/**
+ * State Reconstructor
+ *
+ * Reconstructs aggregate state from event history.
+ * Supports snapshots for performance optimization.
+ */
+export class StateReconstructor {
+    eventStore;
+    options;
+    constructor(eventStore, options) {
+        this.eventStore = eventStore;
+        this.options = {
+            useSnapshots: true,
+            snapshotInterval: 100,
+            maxEventsToReplay: 10000,
+            ...options,
+        };
+    }
+    /**
+     * Reconstruct aggregate state from events
+     */
+    async reconstruct(aggregateId, factory) {
+        const aggregate = factory(aggregateId);
+        // Try to load from snapshot first
+        if (this.options.useSnapshots) {
+            const snapshot = await this.eventStore.getSnapshot(aggregateId);
+            if (snapshot) {
+                this.applySnapshot(aggregate, snapshot);
+            }
+        }
+        // Get events after snapshot version (or all if no snapshot)
+        const events = await this.eventStore.getEvents(aggregateId, aggregate.version + 1);
+        // Apply events
+        for (const event of events) {
+            if (events.length > this.options.maxEventsToReplay) {
+                throw new Error(`Too many events to replay (${events.length}). Consider creating a snapshot.`);
+            }
+            aggregate.apply(event);
+        }
+        // Create snapshot if interval reached
+        if (this.options.useSnapshots && aggregate.version % this.options.snapshotInterval === 0) {
+            await this.createSnapshot(aggregate);
+        }
+        return aggregate;
+    }
+    /**
+     * Reconstruct state at a specific point in time
+     */
+    async reconstructAtTime(aggregateId, factory, timestamp) {
+        const aggregate = factory(aggregateId);
+        // Get all events up to timestamp
+        const allEvents = await this.eventStore.getEvents(aggregateId);
+        const events = allEvents.filter((e) => e.timestamp <= timestamp.getTime());
+        // Apply events
+        for (const event of events) {
+            aggregate.apply(event);
+        }
+        return aggregate;
+    }
+    /**
+     * Reconstruct state at a specific version
+     */
+    async reconstructAtVersion(aggregateId, factory, targetVersion) {
+        const aggregate = factory(aggregateId);
+        // Get events up to target version
+        const events = await this.eventStore.getEvents(aggregateId);
+        const limitedEvents = events.filter((e) => e.version <= targetVersion);
+        // Apply events
+        for (const event of limitedEvents) {
+            aggregate.apply(event);
+        }
+        return aggregate;
+    }
+    /**
+     * Apply snapshot to aggregate
+     */
+    applySnapshot(aggregate, snapshot) {
+        // Type assertion for aggregate that has restoreFromSnapshot
+        const restorable = aggregate;
+        if (typeof restorable.restoreFromSnapshot === 'function') {
+            restorable.restoreFromSnapshot(snapshot.state);
+        }
+        // Update version
+        aggregate.version = snapshot.version;
+    }
+    /**
+     * Create snapshot for aggregate
+     */
+    async createSnapshot(aggregate) {
+        const snapshot = {
+            aggregateId: aggregate.id,
+            aggregateType: this.getAggregateType(aggregate),
+            version: aggregate.version,
+            state: aggregate.getState(),
+            timestamp: Date.now(),
+        };
+        await this.eventStore.saveSnapshot(snapshot);
+    }
+    /**
+     * Get aggregate type from instance
+     */
+    getAggregateType(aggregate) {
+        const typeName = aggregate.constructor.name.toLowerCase().replace('aggregate', '');
+        // Map to valid aggregate types
+        if (typeName === 'agent' || typeName === 'task' || typeName === 'memory' || typeName === 'swarm') {
+            return typeName;
+        }
+        return 'agent'; // Default fallback
+    }
+}
+/**
+ * Agent Aggregate - Example implementation
+ */
+export class AgentAggregate {
+    id;
+    version = 0;
+    state = {
+        name: '',
+        role: '',
+        status: 'idle',
+        currentTask: null,
+        completedTasks: [],
+        capabilities: [],
+        createdAt: null,
+        lastActiveAt: null,
+    };
+    constructor(id) {
+        this.id = id;
+    }
+    apply(event) {
+        this.version = event.version;
+        switch (event.type) {
+            case 'agent:spawned':
+                this.state.name = event.payload.name;
+                this.state.role = event.payload.role;
+                this.state.capabilities = event.payload.capabilities ?? [];
+                this.state.status = 'idle';
+                this.state.createdAt = new Date(event.timestamp);
+                break;
+            case 'agent:started':
+                this.state.status = 'active';
+                this.state.lastActiveAt = new Date(event.timestamp);
+                break;
+            case 'agent:task-assigned':
+                this.state.currentTask = event.payload.taskId;
+                this.state.status = 'busy';
+                this.state.lastActiveAt = new Date(event.timestamp);
+                break;
+            case 'agent:task-completed':
+                this.state.completedTasks.push(event.payload.taskId);
+                this.state.currentTask = null;
+                this.state.status = 'active';
+                this.state.lastActiveAt = new Date(event.timestamp);
+                break;
+            case 'agent:terminated':
+                this.state.status = 'terminated';
+                break;
+        }
+    }
+    getState() {
+        return { ...this.state };
+    }
+    restoreFromSnapshot(snapshotState) {
+        const state = snapshotState;
+        this.state = {
+            ...state,
+            createdAt: state.createdAt ? new Date(state.createdAt) : null,
+            lastActiveAt: state.lastActiveAt ? new Date(state.lastActiveAt) : null,
+        };
+    }
+    // Getters for type safety
+    get name() { return this.state.name; }
+    get role() { return this.state.role; }
+    get status() { return this.state.status; }
+    get currentTask() { return this.state.currentTask; }
+    get completedTasks() { return [...this.state.completedTasks]; }
+    get capabilities() { return [...this.state.capabilities]; }
+}
+/**
+ * Task Aggregate - Example implementation
+ */
+export class TaskAggregate {
+    id;
+    version = 0;
+    state = {
+        title: '',
+        description: '',
+        type: '',
+        priority: 'normal',
+        status: 'pending',
+        assignedAgent: null,
+        result: null,
+        createdAt: null,
+        startedAt: null,
+        completedAt: null,
+    };
+    constructor(id) {
+        this.id = id;
+    }
+    apply(event) {
+        this.version = event.version;
+        switch (event.type) {
+            case 'task:created':
+                this.state.title = event.payload.title;
+                this.state.description = event.payload.description;
+                this.state.type = event.payload.taskType;
+                this.state.priority = event.payload.priority ?? 'normal';
+                this.state.status = 'pending';
+                this.state.createdAt = new Date(event.timestamp);
+                break;
+            case 'task:started':
+                this.state.assignedAgent = event.payload.agentId;
+                this.state.status = 'running';
+                this.state.startedAt = new Date(event.timestamp);
+                break;
+            case 'task:completed':
+                this.state.result = event.payload.result;
+                this.state.status = 'completed';
+                this.state.completedAt = new Date(event.timestamp);
+                break;
+            case 'task:failed':
+                this.state.status = 'failed';
+                this.state.completedAt = new Date(event.timestamp);
+                break;
+            case 'task:cancelled':
+                this.state.status = 'cancelled';
+                this.state.completedAt = new Date(event.timestamp);
+                break;
+        }
+    }
+    getState() {
+        return { ...this.state };
+    }
+    restoreFromSnapshot(snapshotState) {
+        const state = snapshotState;
+        this.state = {
+            ...state,
+            createdAt: state.createdAt ? new Date(state.createdAt) : null,
+            startedAt: state.startedAt ? new Date(state.startedAt) : null,
+            completedAt: state.completedAt ? new Date(state.completedAt) : null,
+        };
+    }
+    // Getters
+    get title() { return this.state.title; }
+    get status() { return this.state.status; }
+    get assignedAgent() { return this.state.assignedAgent; }
+    get result() { return this.state.result; }
+}
+/**
+ * Factory function
+ */
+export function createStateReconstructor(eventStore, options) {
+    return new StateReconstructor(eventStore, options);
+}
+//# sourceMappingURL=state-reconstructor.js.map

package/dist/events/state-reconstructor.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,80 @@
+/**
+ * V3 Event Bus System
+ * Event-driven communication for the 15-agent swarm
+ *
+ * Based on ADR-007 (Event Sourcing for State Changes)
+ */
+import { EventType, EventHandler, SwarmEvent, AgentId } from './types.js';
+export interface IEventBus {
+    subscribe<T>(eventType: EventType, handler: EventHandler<T>): () => void;
+    subscribeAll(handler: EventHandler): () => void;
+    emit<T>(event: SwarmEvent<T>): Promise<void>;
+    emitSync<T>(event: SwarmEvent<T>): void;
+    getHistory(filter?: EventFilter): SwarmEvent[];
+    clear(): void;
+}
+export interface EventFilter {
+    types?: EventType[];
+    sources?: (AgentId | 'swarm')[];
+    since?: number;
+    until?: number;
+    limit?: number;
+}
+export interface IEventStore {
+    append(event: SwarmEvent): Promise<void>;
+    getEvents(aggregateId: string, fromVersion?: number): Promise<SwarmEvent[]>;
+    getAllEvents(filter?: EventFilter): Promise<SwarmEvent[]>;
+    getSnapshot(aggregateId: string): Promise<EventStoreSnapshot | null>;
+    saveSnapshot(snapshot: EventStoreSnapshot): Promise<void>;
+}
+export interface EventStoreSnapshot {
+    aggregateId: string;
+    version: number;
+    state: unknown;
+    timestamp: number;
+}
+export declare class EventBus implements IEventBus {
+    private handlers;
+    private history;
+    private maxHistorySize;
+    constructor(options?: {
+        maxHistorySize?: number;
+    });
+    subscribe<T>(eventType: EventType, handler: EventHandler<T>): () => void;
+    subscribeAll(handler: EventHandler): () => void;
+    emit<T>(event: SwarmEvent<T>): Promise<void>;
+    emitSync<T>(event: SwarmEvent<T>): void;
+    getHistory(filter?: EventFilter): SwarmEvent[];
+    clear(): void;
+    private addToHistory;
+    private safeExecute;
+}
+export declare class InMemoryEventStore implements IEventStore {
+    private events;
+    private allEvents;
+    private snapshots;
+    append(event: SwarmEvent): Promise<void>;
+    getEvents(aggregateId: string, fromVersion?: number): Promise<SwarmEvent[]>;
+    getAllEvents(filter?: EventFilter): Promise<SwarmEvent[]>;
+    getSnapshot(aggregateId: string): Promise<EventStoreSnapshot | null>;
+    saveSnapshot(snapshot: EventStoreSnapshot): Promise<void>;
+    private extractAggregateId;
+}
+export declare function createEvent<T>(type: EventType, source: AgentId | 'swarm', payload: T): SwarmEvent<T>;
+export declare function agentSpawnedEvent(agentId: AgentId, role: string): SwarmEvent;
+export declare function agentStatusChangedEvent(agentId: AgentId, previousStatus: string, newStatus: string): SwarmEvent;
+export declare function agentTaskAssignedEvent(agentId: AgentId, taskId: string): SwarmEvent;
+export declare function agentTaskCompletedEvent(agentId: AgentId, taskId: string, result: unknown): SwarmEvent;
+export declare function agentErrorEvent(agentId: AgentId, error: Error): SwarmEvent;
+export declare function taskCreatedEvent(taskId: string, type: string, title: string): SwarmEvent;
+export declare function taskQueuedEvent(taskId: string, priority: string): SwarmEvent;
+export declare function taskAssignedEvent(taskId: string, agentId: AgentId): SwarmEvent;
+export declare function taskStartedEvent(taskId: string, agentId: AgentId): SwarmEvent;
+export declare function taskCompletedEvent(taskId: string, result: unknown): SwarmEvent;
+export declare function taskFailedEvent(taskId: string, error: Error): SwarmEvent;
+export declare function taskBlockedEvent(taskId: string, blockedBy: string[]): SwarmEvent;
+export declare function swarmInitializedEvent(config: unknown): SwarmEvent;
+export declare function swarmPhaseChangedEvent(previousPhase: string, newPhase: string): SwarmEvent;
+export declare function swarmMilestoneReachedEvent(milestoneId: string, name: string): SwarmEvent;
+export declare function swarmErrorEvent(error: Error): SwarmEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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