@sparkleideas/claims 3.0.0-alpha.8-patch.26 → 3.0.0-alpha.8-patch.28

package/dist/application/load-balancer.js

@@ -0,0 +1,430 @@
+/**
+ * Load Balancer Service for Claims Module (ADR-016)
+ *
+ * Balances work across the swarm by:
+ * - Tracking agent load and utilization
+ * - Detecting overloaded/underloaded agents
+ * - Rebalancing work through handoff mechanisms
+ *
+ * Rebalancing Algorithm:
+ * 1. Calculate average load across swarm
+ * 2. Identify overloaded agents (>1.5x average utilization)
+ * 3. Identify underloaded agents (<0.5x average utilization)
+ * 4. Move low-progress (<25%) work from overloaded to underloaded
+ * 5. Prefer same agent type for transfers
+ * 6. Use handoff mechanism (not direct reassignment)
+ *
+ * Events Emitted:
+ * - SwarmRebalanced: When rebalancing operation completes
+ * - AgentOverloaded: When an agent exceeds load threshold
+ * - AgentUnderloaded: When an agent is below load threshold
+ *
+ * @module v3/@sparkleideas/claims/application/load-balancer
+ */
+import { EventEmitter } from 'node:events';
+// =============================================================================
+// Load Balancer Implementation
+// =============================================================================
+const DEFAULT_REBALANCE_OPTIONS = {
+    maxProgressToMove: 25,
+    preferSameType: true,
+    overloadThreshold: 1.5,
+    underloadThreshold: 0.5,
+    maxMovesPerRebalance: 10,
+    useHandoff: true,
+};
+/**
+ * Load Balancer Service
+ *
+ * Balances work across the swarm using the following algorithm:
+ * 1. Calculate average load across swarm
+ * 2. Identify overloaded agents (>1.5x average utilization)
+ * 3. Identify underloaded agents (<0.5x average utilization)
+ * 4. Move low-progress (<25%) work from overloaded to underloaded
+ * 5. Prefer same agent type for transfers
+ * 6. Use handoff mechanism (not direct reassignment)
+ */
+export class LoadBalancer extends EventEmitter {
+    claimRepository;
+    agentRegistry;
+    handoffService;
+    constructor(claimRepository, agentRegistry, handoffService) {
+        super();
+        this.claimRepository = claimRepository;
+        this.agentRegistry = agentRegistry;
+        this.handoffService = handoffService;
+    }
+    /**
+     * Get load information for a specific agent
+     */
+    async getAgentLoad(agentId) {
+        const agent = await this.agentRegistry.getAgent(agentId);
+        if (!agent) {
+            throw new Error(`Agent not found: ${agentId}`);
+        }
+        const claims = await this.claimRepository.getClaimsByAgent(agentId);
+        const completionHistory = await this.claimRepository.getAgentCompletionHistory(agentId, 50);
+        const utilization = this.calculateUtilization(claims, agent.maxClaims);
+        const blockedCount = claims.filter((c) => c.status === 'blocked').length;
+        const avgCompletionTime = completionHistory.length > 0
+            ? completionHistory.reduce((sum, t) => sum + t, 0) / completionHistory.length
+            : 0;
+        return {
+            agentId: agent.agentId,
+            agentType: agent.agentType,
+            claimCount: claims.length,
+            maxClaims: agent.maxClaims,
+            utilization,
+            claims,
+            avgCompletionTime,
+            currentBlockedCount: blockedCount,
+        };
+    }
+    /**
+     * Get load overview for entire swarm
+     */
+    async getSwarmLoad(swarmId) {
+        const agents = await this.agentRegistry.getAgentsBySwarm(swarmId);
+        const claimsByAgent = await this.claimRepository.getClaimsBySwarm(swarmId);
+        const agentLoads = [];
+        let totalClaims = 0;
+        let totalUtilization = 0;
+        let activeAgents = 0;
+        for (const agent of agents) {
+            const claims = claimsByAgent.get(agent.agentId) || [];
+            const completionHistory = await this.claimRepository.getAgentCompletionHistory(agent.agentId, 50);
+            const utilization = this.calculateUtilization(claims, agent.maxClaims);
+            const blockedCount = claims.filter((c) => c.status === 'blocked').length;
+            const avgCompletionTime = completionHistory.length > 0
+                ? completionHistory.reduce((sum, t) => sum + t, 0) / completionHistory.length
+                : 0;
+            const loadInfo = {
+                agentId: agent.agentId,
+                agentType: agent.agentType,
+                claimCount: claims.length,
+                maxClaims: agent.maxClaims,
+                utilization,
+                claims,
+                avgCompletionTime,
+                currentBlockedCount: blockedCount,
+            };
+            agentLoads.push(loadInfo);
+            totalClaims += claims.length;
+            totalUtilization += utilization;
+            if (claims.length > 0) {
+                activeAgents++;
+            }
+        }
+        const avgUtilization = agents.length > 0 ? totalUtilization / agents.length : 0;
+        // Detect overloaded/underloaded
+        const overloadedAgents = agentLoads
+            .filter((a) => a.utilization > avgUtilization * DEFAULT_REBALANCE_OPTIONS.overloadThreshold)
+            .map((a) => a.agentId);
+        const underloadedAgents = agentLoads
+            .filter((a) => a.utilization < avgUtilization * DEFAULT_REBALANCE_OPTIONS.underloadThreshold)
+            .map((a) => a.agentId);
+        // Calculate balance score (0-1, higher is better)
+        const balanceScore = this.calculateBalanceScore(agentLoads);
+        return {
+            swarmId,
+            totalAgents: agents.length,
+            activeAgents,
+            totalClaims,
+            avgUtilization,
+            agents: agentLoads,
+            overloadedAgents,
+            underloadedAgents,
+            balanceScore,
+        };
+    }
+    /**
+     * Rebalance work across swarm
+     */
+    async rebalance(swarmId, options) {
+        const startTime = Date.now();
+        const opts = { ...DEFAULT_REBALANCE_OPTIONS, ...options };
+        // Get current state
+        const swarmLoad = await this.getSwarmLoad(swarmId);
+        const previousBalanceScore = swarmLoad.balanceScore;
+        // Detect imbalance
+        const imbalance = await this.detectImbalance(swarmId);
+        const moved = [];
+        const suggested = [];
+        // Process overloaded agents
+        for (const overloaded of imbalance.overloaded) {
+            // Find movable claims (low progress, not blocked)
+            const movableClaims = overloaded.movableClaims
+                .filter((c) => c.progress < opts.maxProgressToMove && c.status === 'active')
+                .sort((a, b) => a.progress - b.progress); // Move lowest progress first
+            for (const claim of movableClaims) {
+                if (moved.length + suggested.length >= opts.maxMovesPerRebalance) {
+                    break;
+                }
+                // Find suitable target agent
+                const target = this.findBestTarget(overloaded.agentType, imbalance.underloaded, opts.preferSameType);
+                if (!target) {
+                    suggested.push({
+                        issueId: claim.issueId,
+                        currentOwner: { type: 'agent', agentId: overloaded.agentId, agentType: overloaded.agentType },
+                        suggestedOwner: { type: 'agent', agentId: 'none-available', agentType: overloaded.agentType },
+                        reason: 'No suitable underloaded agent available',
+                    });
+                    continue;
+                }
+                const from = {
+                    type: 'agent',
+                    agentId: overloaded.agentId,
+                    agentType: overloaded.agentType,
+                };
+                const to = {
+                    type: 'agent',
+                    agentId: target.agentId,
+                    agentType: target.agentType,
+                };
+                if (opts.useHandoff) {
+                    // Use handoff mechanism
+                    await this.handoffService.requestHandoff(claim.issueId, from, to, `Load balancing: redistributing work across swarm (${overloaded.utilization.toFixed(2)} -> ${target.utilization.toFixed(2)} utilization)`);
+                    moved.push({ issueId: claim.issueId, from, to });
+                }
+                else {
+                    // Just suggest, don't execute
+                    suggested.push({
+                        issueId: claim.issueId,
+                        currentOwner: from,
+                        suggestedOwner: to,
+                        reason: `Load balancing: agent ${overloaded.agentId} overloaded at ${(overloaded.utilization * 100).toFixed(0)}%`,
+                    });
+                }
+                // Update target's capacity tracking (in-memory for this operation)
+                target.availableCapacity--;
+                if (target.availableCapacity <= 0) {
+                    const idx = imbalance.underloaded.indexOf(target);
+                    if (idx >= 0) {
+                        imbalance.underloaded.splice(idx, 1);
+                    }
+                }
+            }
+        }
+        // Calculate new balance score
+        const newSwarmLoad = await this.getSwarmLoad(swarmId);
+        const newBalanceScore = newSwarmLoad.balanceScore;
+        const result = {
+            moved,
+            suggested,
+            stats: {
+                totalMoved: moved.length,
+                totalSuggested: suggested.length,
+                previousBalanceScore,
+                newBalanceScore,
+                executionTimeMs: Date.now() - startTime,
+            },
+        };
+        // Emit swarm rebalanced event
+        this.emit('swarm:rebalanced', {
+            type: 'swarm:rebalanced',
+            swarmId,
+            timestamp: new Date(),
+            result,
+        });
+        return result;
+    }
+    /**
+     * Preview rebalance without applying changes
+     */
+    async previewRebalance(swarmId, options) {
+        // Force useHandoff to false for preview - we just want suggestions
+        return this.rebalance(swarmId, { ...options, useHandoff: false });
+    }
+    /**
+     * Detect overloaded/underloaded agents
+     */
+    async detectImbalance(swarmId) {
+        const swarmLoad = await this.getSwarmLoad(swarmId);
+        const avgLoad = swarmLoad.avgUtilization;
+        const overloaded = [];
+        const underloaded = [];
+        const recommendations = [];
+        for (const agent of swarmLoad.agents) {
+            const isOverloaded = agent.utilization > avgLoad * DEFAULT_REBALANCE_OPTIONS.overloadThreshold;
+            const isUnderloaded = agent.utilization < avgLoad * DEFAULT_REBALANCE_OPTIONS.underloadThreshold;
+            if (isOverloaded) {
+                const excessClaims = Math.ceil(agent.claimCount - agent.maxClaims * avgLoad);
+                const movableClaims = agent.claims.filter((c) => c.progress < DEFAULT_REBALANCE_OPTIONS.maxProgressToMove);
+                overloaded.push({
+                    agentId: agent.agentId,
+                    agentType: agent.agentType,
+                    utilization: agent.utilization,
+                    excessClaims: Math.max(0, excessClaims),
+                    movableClaims,
+                });
+                // Emit overloaded event
+                this.emit('agent:overloaded', {
+                    type: 'agent:overloaded',
+                    agentId: agent.agentId,
+                    agentType: agent.agentType,
+                    utilization: agent.utilization,
+                    claimCount: agent.claimCount,
+                    maxClaims: agent.maxClaims,
+                    timestamp: new Date(),
+                });
+                if (movableClaims.length > 0) {
+                    recommendations.push(`Agent ${agent.agentId} (${agent.agentType}) is overloaded at ${(agent.utilization * 100).toFixed(0)}% with ${movableClaims.length} movable claims`);
+                }
+            }
+            if (isUnderloaded) {
+                const availableCapacity = agent.maxClaims - agent.claimCount;
+                underloaded.push({
+                    agentId: agent.agentId,
+                    agentType: agent.agentType,
+                    utilization: agent.utilization,
+                    availableCapacity,
+                });
+                // Emit underloaded event
+                this.emit('agent:underloaded', {
+                    type: 'agent:underloaded',
+                    agentId: agent.agentId,
+                    agentType: agent.agentType,
+                    utilization: agent.utilization,
+                    claimCount: agent.claimCount,
+                    maxClaims: agent.maxClaims,
+                    timestamp: new Date(),
+                });
+            }
+        }
+        // Generate recommendations
+        if (overloaded.length > 0 && underloaded.length > 0) {
+            const totalMovable = overloaded.reduce((sum, o) => sum + o.movableClaims.length, 0);
+            const totalCapacity = underloaded.reduce((sum, u) => sum + u.availableCapacity, 0);
+            recommendations.push(`Can redistribute up to ${Math.min(totalMovable, totalCapacity)} claims from ${overloaded.length} overloaded to ${underloaded.length} underloaded agents`);
+        }
+        if (overloaded.length > 0 && underloaded.length === 0) {
+            recommendations.push(`${overloaded.length} overloaded agents but no underloaded agents available. Consider spawning more agents.`);
+        }
+        const isBalanced = overloaded.length === 0 ||
+            swarmLoad.balanceScore > 0.8;
+        return {
+            swarmId,
+            timestamp: new Date(),
+            isBalanced,
+            balanceScore: swarmLoad.balanceScore,
+            avgLoad,
+            overloaded,
+            underloaded,
+            recommendations,
+        };
+    }
+    // =============================================================================
+    // Private Helper Methods
+    // =============================================================================
+    /**
+     * Calculate utilization based on claims and their priorities
+     */
+    calculateUtilization(claims, maxClaims) {
+        if (maxClaims === 0)
+            return 0;
+        if (claims.length === 0)
+            return 0;
+        // Weight claims by priority
+        const priorityWeights = {
+            critical: 2.0,
+            high: 1.5,
+            medium: 1.0,
+            low: 0.5,
+        };
+        let weightedCount = 0;
+        for (const claim of claims) {
+            const weight = priorityWeights[claim.priority] || 1.0;
+            // Blocked claims count less toward utilization
+            const blockFactor = claim.status === 'blocked' ? 0.5 : 1.0;
+            weightedCount += weight * blockFactor;
+        }
+        // Normalize to 0-1 range
+        return Math.min(1, weightedCount / maxClaims);
+    }
+    /**
+     * Calculate balance score for the swarm (0-1, higher is better)
+     *
+     * Uses coefficient of variation: 1 - (stdDev / mean)
+     * A perfectly balanced swarm has score = 1
+     */
+    calculateBalanceScore(agentLoads) {
+        if (agentLoads.length === 0)
+            return 1;
+        if (agentLoads.length === 1)
+            return 1;
+        const utilizations = agentLoads.map((a) => a.utilization);
+        const mean = utilizations.reduce((sum, u) => sum + u, 0) / utilizations.length;
+        if (mean === 0)
+            return 1; // No work = perfectly balanced
+        const variance = utilizations.reduce((sum, u) => sum + Math.pow(u - mean, 2), 0) /
+            utilizations.length;
+        const stdDev = Math.sqrt(variance);
+        // Coefficient of variation normalized to 0-1
+        const cv = stdDev / mean;
+        const score = Math.max(0, Math.min(1, 1 - cv));
+        return score;
+    }
+    /**
+     * Find the best target agent for receiving a transferred claim
+     */
+    findBestTarget(sourceAgentType, candidates, preferSameType) {
+        if (candidates.length === 0)
+            return null;
+        // Sort candidates by preference
+        const sorted = [...candidates].sort((a, b) => {
+            // Prefer same type if configured
+            if (preferSameType) {
+                const aMatch = a.agentType === sourceAgentType ? 0 : 1;
+                const bMatch = b.agentType === sourceAgentType ? 0 : 1;
+                if (aMatch !== bMatch)
+                    return aMatch - bMatch;
+            }
+            // Then by available capacity (more is better)
+            if (a.availableCapacity !== b.availableCapacity) {
+                return b.availableCapacity - a.availableCapacity;
+            }
+            // Then by utilization (lower is better)
+            return a.utilization - b.utilization;
+        });
+        return sorted[0] || null;
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create a LoadBalancer instance with dependencies
+ *
+ * @param claimRepository - Repository for accessing claim data
+ * @param agentRegistry - Registry for agent metadata
+ * @param handoffService - Service for initiating claim handoffs
+ * @returns A configured LoadBalancer instance
+ *
+ * @example
+ * ```typescript
+ * const loadBalancer = createLoadBalancer(
+ *   claimRepository,
+ *   agentRegistry,
+ *   handoffService
+ * );
+ *
+ * // Get swarm load overview
+ * const swarmLoad = await loadBalancer.getSwarmLoad('swarm-1');
+ *
+ * // Detect and report imbalances
+ * const imbalance = await loadBalancer.detectImbalance('swarm-1');
+ *
+ * // Preview rebalancing without applying
+ * const preview = await loadBalancer.previewRebalance('swarm-1');
+ *
+ * // Execute rebalancing with handoffs
+ * const result = await loadBalancer.rebalance('swarm-1', {
+ *   maxProgressToMove: 25,
+ *   preferSameType: true
+ * });
+ * ```
+ */
+export function createLoadBalancer(claimRepository, agentRegistry, handoffService) {
+    return new LoadBalancer(claimRepository, agentRegistry, handoffService);
+}
+//# sourceMappingURL=load-balancer.js.map

package/dist/application/load-balancer.js.map

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

package/dist/application/work-stealing-service.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Work Stealing Service - Application Layer
+ *
+ * Handles work stealing to maximize swarm throughput by redistributing
+ * work from stale, blocked, or overloaded agents to available ones.
+ *
+ * @module v3/claims/application/work-stealing-service
+ */
+import { type IssueId, type Claimant, type AgentType, type StealableInfo, type StealResult, type WorkStealingConfig, type IssueClaimWithStealing, type IIssueClaimRepository, type IWorkStealingEventBus, type WorkStealingEvent, type WorkStealingEventType } from '../domain/types.js';
+/**
+ * Work Stealing Service Interface
+ */
+export interface IWorkStealingService {
+    /** Mark work as stealable */
+    markStealable(issueId: IssueId, info: StealableInfo): Promise<void>;
+    /** Steal work from another agent */
+    steal(issueId: IssueId, stealer: Claimant): Promise<StealResult>;
+    /** Get list of stealable issues */
+    getStealable(agentType?: AgentType): Promise<IssueClaimWithStealing[]>;
+    /** Contest a steal (original owner wants it back) */
+    contestSteal(issueId: IssueId, originalClaimant: Claimant, reason: string): Promise<void>;
+    /** Resolve contest (queen/human decides) */
+    resolveContest(issueId: IssueId, winner: Claimant, reason: string): Promise<void>;
+    /** Auto-detect stealable work based on config thresholds */
+    detectStaleWork(config: WorkStealingConfig): Promise<IssueClaimWithStealing[]>;
+    /** Auto-mark stealable work based on config thresholds */
+    autoMarkStealable(config: WorkStealingConfig): Promise<number>;
+}
+/**
+ * Simple in-memory event bus for work stealing events
+ */
+export declare class InMemoryWorkStealingEventBus implements IWorkStealingEventBus {
+    private handlers;
+    private history;
+    private maxHistorySize;
+    constructor(options?: {
+        maxHistorySize?: number;
+    });
+    emit(event: WorkStealingEvent): Promise<void>;
+    subscribe(eventType: WorkStealingEventType, handler: (event: WorkStealingEvent) => void | Promise<void>): () => void;
+    subscribeAll(handler: (event: WorkStealingEvent) => void | Promise<void>): () => void;
+    getHistory(filter?: {
+        types?: WorkStealingEventType[];
+        limit?: number;
+    }): WorkStealingEvent[];
+    private addToHistory;
+    private safeExecute;
+}
+/**
+ * Work Stealing Service
+ *
+ * Implements work stealing algorithms to maximize swarm throughput by
+ * redistributing work from stale, blocked, or overloaded agents.
+ */
+export declare class WorkStealingService implements IWorkStealingService {
+    private readonly repository;
+    private readonly eventBus;
+    private readonly config;
+    constructor(repository: IIssueClaimRepository, eventBus: IWorkStealingEventBus, config?: Partial<WorkStealingConfig>);
+    /**
+     * Mark work as stealable with the given reason
+     */
+    markStealable(issueId: IssueId, info: StealableInfo): Promise<void>;
+    /**
+     * Steal work from another agent
+     */
+    steal(issueId: IssueId, stealer: Claimant): Promise<StealResult>;
+    /**
+     * Get list of stealable issues, optionally filtered by agent type
+     */
+    getStealable(agentType?: AgentType): Promise<IssueClaimWithStealing[]>;
+    /**
+     * Contest a steal (original owner wants the work back)
+     */
+    contestSteal(issueId: IssueId, originalClaimant: Claimant, reason: string): Promise<void>;
+    /**
+     * Resolve a contest (queen or human decides the winner)
+     */
+    resolveContest(issueId: IssueId, winner: Claimant, reason: string): Promise<void>;
+    /**
+     * Detect stale work based on config thresholds
+     */
+    detectStaleWork(config: WorkStealingConfig): Promise<IssueClaimWithStealing[]>;
+    /**
+     * Auto-mark stealable work based on config thresholds
+     */
+    autoMarkStealable(config: WorkStealingConfig): Promise<number>;
+    /**
+     * Check if claim is in grace period
+     */
+    private isInGracePeriod;
+    /**
+     * Check if claim is in grace period with specific config
+     */
+    private isInGracePeriodWithConfig;
+    /**
+     * Check if claim is protected by progress
+     */
+    private isProtectedByProgress;
+    /**
+     * Check if claim is protected by progress with specific config
+     */
+    private isProtectedByProgressWithConfig;
+    /**
+     * Get agent type from claimant
+     */
+    private getAgentType;
+    /**
+     * Check if cross-type stealing is allowed
+     */
+    private canStealCrossType;
+    /**
+     * Get allowed stealer types for a claimant
+     */
+    private getAllowedStealerTypes;
+    /**
+     * Determine the stale reason for a claim
+     */
+    private determineStaleReason;
+    /**
+     * Determine who resolved the contest
+     */
+    private determineResolver;
+    /**
+     * Create a steal error result
+     */
+    private stealError;
+    /**
+     * Emit IssueMarkedStealable event
+     */
+    private emitMarkedStealableEvent;
+    /**
+     * Emit IssueStolen event
+     */
+    private emitStolenEvent;
+    /**
+     * Emit StealContested event
+     */
+    private emitContestEvent;
+    /**
+     * Emit StealContestResolved event
+     */
+    private emitContestResolvedEvent;
+}
+/**
+ * Create a new WorkStealingService with default event bus
+ */
+export declare function createWorkStealingService(repository: IIssueClaimRepository, config?: Partial<WorkStealingConfig>, eventBus?: IWorkStealingEventBus): WorkStealingService;
+//# sourceMappingURL=work-stealing-service.d.ts.map

package/dist/application/work-stealing-service.d.ts.map

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