@claude-flow/shared 3.0.0-alpha.1

package/dist/events/domain-events.js

@@ -0,0 +1,165 @@
+/**
+ * Domain Events for Event Sourcing (ADR-007)
+ *
+ * Defines all domain events for the V3 system:
+ * - Agent lifecycle events (spawned, started, stopped, failed)
+ * - Task execution events (created, started, completed, failed)
+ * - Memory operations events (stored, retrieved, deleted)
+ * - Swarm coordination events (initialized, scaled, terminated)
+ *
+ * @module v3/shared/events/domain-events
+ */
+// =============================================================================
+// Event Factory Functions
+// =============================================================================
+let eventCounter = 0;
+function createDomainEvent(type, aggregateId, aggregateType, payload, metadata, causationId, correlationId) {
+    return {
+        id: `evt-${Date.now()}-${++eventCounter}`,
+        type,
+        aggregateId,
+        aggregateType,
+        version: 1, // Version will be set by event store
+        timestamp: Date.now(),
+        source: 'swarm', // Default to swarm, can be overridden
+        payload,
+        metadata,
+        causationId,
+        correlationId,
+    };
+}
+// Agent Event Factories
+export function createAgentSpawnedEvent(agentId, role, domain, capabilities) {
+    return createDomainEvent('agent:spawned', agentId, 'agent', {
+        agentId,
+        role,
+        domain,
+        capabilities,
+    });
+}
+export function createAgentStartedEvent(agentId) {
+    return createDomainEvent('agent:started', agentId, 'agent', {
+        agentId,
+        startedAt: Date.now(),
+    });
+}
+export function createAgentStoppedEvent(agentId, reason) {
+    return createDomainEvent('agent:stopped', agentId, 'agent', {
+        agentId,
+        reason,
+        stoppedAt: Date.now(),
+    });
+}
+export function createAgentFailedEvent(agentId, error) {
+    return createDomainEvent('agent:failed', agentId, 'agent', {
+        agentId,
+        error: error.message,
+        stack: error.stack,
+        failedAt: Date.now(),
+    });
+}
+export function createAgentTaskAssignedEvent(agentId, taskId, assignedAt) {
+    return createDomainEvent('agent:task-assigned', agentId, 'agent', {
+        agentId,
+        taskId,
+        assignedAt: assignedAt ?? Date.now(),
+    });
+}
+export function createAgentTaskCompletedEvent(agentId, taskId, result, completedAt, duration) {
+    return createDomainEvent('agent:task-completed', agentId, 'agent', {
+        agentId,
+        taskId,
+        result,
+        completedAt,
+        duration,
+    });
+}
+// Task Event Factories
+export function createTaskCreatedEvent(taskId, taskType, title, description, priority, dependencies) {
+    return createDomainEvent('task:created', taskId, 'task', {
+        taskId,
+        taskType,
+        title,
+        description,
+        priority,
+        dependencies,
+        createdAt: Date.now(),
+    });
+}
+export function createTaskStartedEvent(taskId, agentId) {
+    return createDomainEvent('task:started', taskId, 'task', {
+        taskId,
+        agentId,
+        startedAt: Date.now(),
+    });
+}
+export function createTaskCompletedEvent(taskId, result, duration) {
+    return createDomainEvent('task:completed', taskId, 'task', {
+        taskId,
+        result,
+        completedAt: Date.now(),
+        duration,
+    });
+}
+export function createTaskFailedEvent(taskId, error, retryCount) {
+    return createDomainEvent('task:failed', taskId, 'task', {
+        taskId,
+        error: error.message,
+        stack: error.stack,
+        failedAt: Date.now(),
+        retryCount,
+    });
+}
+// Memory Event Factories
+export function createMemoryStoredEvent(memoryId, namespace, key, memoryType, size) {
+    return createDomainEvent('memory:stored', memoryId, 'memory', {
+        memoryId,
+        namespace,
+        key,
+        memoryType,
+        size,
+        storedAt: Date.now(),
+    });
+}
+export function createMemoryRetrievedEvent(memoryId, namespace, key, accessCount) {
+    return createDomainEvent('memory:retrieved', memoryId, 'memory', {
+        memoryId,
+        namespace,
+        key,
+        retrievedAt: Date.now(),
+        accessCount,
+    });
+}
+export function createMemoryDeletedEvent(memoryId, namespace, key) {
+    return createDomainEvent('memory:deleted', memoryId, 'memory', {
+        memoryId,
+        namespace,
+        key,
+        deletedAt: Date.now(),
+    });
+}
+// Swarm Event Factories
+export function createSwarmInitializedEvent(topology, maxAgents, config) {
+    return createDomainEvent('swarm:initialized', 'swarm', 'swarm', {
+        topology,
+        maxAgents,
+        config,
+        initializedAt: Date.now(),
+    });
+}
+export function createSwarmScaledEvent(previousAgentCount, newAgentCount, reason) {
+    return createDomainEvent('swarm:scaled', 'swarm', 'swarm', {
+        previousAgentCount,
+        newAgentCount,
+        scaledAt: Date.now(),
+        reason,
+    });
+}
+export function createSwarmTerminatedEvent(reason, metrics) {
+    return createDomainEvent('swarm:terminated', 'swarm', 'swarm', {
+        reason,
+        terminatedAt: Date.now(),
+        metrics,
+    });
+}
+//# sourceMappingURL=domain-events.js.map

package/dist/events/domain-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-events.js","sourceRoot":"","sources":["../../src/events/domain-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmVH,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB,SAAS,iBAAiB,CACxB,IAAe,EACf,WAAmB,EACnB,aAAiC,EACjC,OAAqB,EACrB,QAAkC,EAClC,WAAoB,EACpB,aAAsB;IAEtB,OAAO;QACL,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE;QACzC,IAAI;QACJ,WAAW;QACX,aAAa;QACb,OAAO,EAAE,CAAC,EAAE,qCAAqC;QACjD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,MAAM,EAAE,OAAO,EAAE,sCAAsC;QACvD,OAAO;QACP,QAAQ;QACR,WAAW;QACX,aAAa;KACT,CAAC;AACT,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,uBAAuB,CACrC,OAAgB,EAChB,IAAY,EACZ,MAAc,EACd,YAAsB;IAEtB,OAAO,iBAAiB,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE;QAC1D,OAAO;QACP,IAAI;QACJ,MAAM;QACN,YAAY;KACb,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,iBAAiB,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE;QAC1D,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB,EAAE,MAAc;IACtE,OAAO,iBAAiB,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE;QAC1D,OAAO;QACP,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,KAAY;IACnE,OAAO,iBAAiB,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE;QACzD,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;KACrB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAAgB,EAChB,MAAc,EACd,UAAmB;IAEnB,OAAO,iBAAiB,CAAC,qBAAqB,EAAE,OAAO,EAAE,OAAO,EAAE;QAChE,OAAO;QACP,MAAM;QACN,UAAU,EAAE,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE;KACrC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,OAAgB,EAChB,MAAc,EACd,MAAe,EACf,WAAmB,EACnB,QAAgB;IAEhB,OAAO,iBAAiB,CAAC,sBAAsB,EAAE,OAAO,EAAE,OAAO,EAAE;QACjE,OAAO;QACP,MAAM;QACN,MAAM;QACN,WAAW;QACX,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,QAAgB,EAChB,KAAa,EACb,WAAmB,EACnB,QAAgB,EAChB,YAAsB;IAEtB,OAAO,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE;QACvD,MAAM;QACN,QAAQ;QACR,KAAK;QACL,WAAW;QACX,QAAQ;QACR,YAAY;QACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,OAAgB;IACrE,OAAO,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE;QACvD,MAAM;QACN,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAc,EACd,MAAe,EACf,QAAgB;IAEhB,OAAO,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE;QACzD,MAAM;QACN,MAAM;QACN,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,KAAY,EACZ,UAAkB;IAElB,OAAO,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE;QACtD,MAAM;QACN,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;QACpB,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,SAAiB,EACjB,GAAW,EACX,UAAkB,EAClB,IAAY;IAEZ,OAAO,iBAAiB,CAAC,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC5D,QAAQ;QACR,SAAS;QACT,GAAG;QACH,UAAU;QACV,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;KACrB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAgB,EAChB,SAAiB,EACjB,GAAW,EACX,WAAmB;IAEnB,OAAO,iBAAiB,CAAC,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC/D,QAAQ;QACR,SAAS;QACT,GAAG;QACH,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,WAAW;KACZ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,SAAiB,EACjB,GAAW;IAEX,OAAO,iBAAiB,CAAC,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC7D,QAAQ;QACR,SAAS;QACT,GAAG;QACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,2BAA2B,CACzC,QAAgB,EAChB,SAAiB,EACjB,MAA+B;IAE/B,OAAO,iBAAiB,CAAC,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE;QAC9D,QAAQ;QACR,SAAS;QACT,MAAM;QACN,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,kBAA0B,EAC1B,aAAqB,EACrB,MAAc;IAEd,OAAO,iBAAiB,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE;QACzD,kBAAkB;QAClB,aAAa;QACb,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;QACpB,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAc,EACd,OAAgC;IAEhC,OAAO,iBAAiB,CAAC,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE;QAC7D,MAAM;QACN,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;QACxB,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/events/event-store.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Event Store Persistence (ADR-007)
+ *
+ * Provides persistent storage for domain events using SQLite.
+ * Supports event replay, snapshots, and projections.
+ *
+ * Key Features:
+ * - Append-only event log
+ * - Event versioning per aggregate
+ * - Event filtering and queries
+ * - Snapshot support for performance
+ * - Event replay for projections
+ * - Cross-platform SQLite (sql.js fallback)
+ *
+ * @module v3/shared/events/event-store
+ */
+import { EventEmitter } from 'node:events';
+import { DomainEvent } from './domain-events.js';
+export interface EventStoreConfig {
+    /** Path to SQLite database file (:memory: for in-memory) */
+    databasePath: string;
+    /** Enable verbose logging */
+    verbose: boolean;
+    /** Auto-persist interval in milliseconds (0 = manual only) */
+    autoPersistInterval: number;
+    /** Maximum events before snapshot recommendation */
+    snapshotThreshold: number;
+    /** Path to sql.js WASM file (optional) */
+    wasmPath?: string;
+}
+export interface EventFilter {
+    /** Filter by aggregate IDs */
+    aggregateIds?: string[];
+    /** Filter by aggregate types */
+    aggregateTypes?: Array<'agent' | 'task' | 'memory' | 'swarm'>;
+    /** Filter by event types */
+    eventTypes?: string[];
+    /** Filter events after timestamp */
+    afterTimestamp?: number;
+    /** Filter events before timestamp */
+    beforeTimestamp?: number;
+    /** Filter by minimum version */
+    fromVersion?: number;
+    /** Limit number of results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+export interface EventSnapshot {
+    /** Aggregate ID */
+    aggregateId: string;
+    /** Aggregate type */
+    aggregateType: 'agent' | 'task' | 'memory' | 'swarm';
+    /** Version at snapshot */
+    version: number;
+    /** Snapshot state */
+    state: Record<string, unknown>;
+    /** Timestamp when snapshot was created */
+    timestamp: number;
+}
+export interface EventStoreStats {
+    totalEvents: number;
+    eventsByType: Record<string, number>;
+    eventsByAggregate: Record<string, number>;
+    oldestEvent: number | null;
+    newestEvent: number | null;
+    snapshotCount: number;
+}
+export declare class EventStore extends EventEmitter {
+    private config;
+    private db;
+    private initialized;
+    private persistTimer;
+    private SQL;
+    private aggregateVersions;
+    constructor(config?: Partial<EventStoreConfig>);
+    /**
+     * Initialize the event store
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shutdown the event store
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Append a new event to the store
+     */
+    append(event: DomainEvent): Promise<void>;
+    /**
+     * Get events for a specific aggregate
+     */
+    getEvents(aggregateId: string, fromVersion?: number): Promise<DomainEvent[]>;
+    /**
+     * Get events by type
+     */
+    getEventsByType(type: string): Promise<DomainEvent[]>;
+    /**
+     * Query events with filters
+     */
+    query(filter: EventFilter): Promise<DomainEvent[]>;
+    /**
+     * Replay events from a specific version
+     */
+    replay(fromVersion?: number): AsyncIterable<DomainEvent>;
+    /**
+     * Save a snapshot for an aggregate
+     */
+    saveSnapshot(snapshot: EventSnapshot): Promise<void>;
+    /**
+     * Get snapshot for an aggregate
+     */
+    getSnapshot(aggregateId: string): Promise<EventSnapshot | null>;
+    /**
+     * Get event store statistics
+     */
+    getStats(): Promise<EventStoreStats>;
+    /**
+     * Persist to disk
+     */
+    persist(): Promise<void>;
+    private createSchema;
+    private loadAggregateVersions;
+    private rowToEvent;
+    private ensureInitialized;
+}
+//# sourceMappingURL=event-store.d.ts.map

package/dist/events/event-store.d.ts.map

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