agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/coordination/autopilot-learning.js

@@ -0,0 +1,306 @@
+/**
+ * Autopilot Learning Bridge (ADR-058 v2)
+ *
+ * Bridges autopilot coordinator with AgentDB's ReflexionMemory,
+ * LearningSystem, and SONA trajectory tracking. All methods
+ * gracefully no-op when AgentDB/SONA are unavailable.
+ */
+export class AutopilotLearning {
+    agentDB = null;
+    sonaService = null;
+    available = false;
+    sonaAvailable = false;
+    trajectoryId = null;
+    episodeCount = 0;
+    /**
+     * Initialize by dynamically importing AgentDB and SONA services.
+     * Returns true if at least AgentDB is available.
+     */
+    async initialize() {
+        // Try AgentDB
+        try {
+            const { AgentDBService } = await import('../services/agentdb-service.js');
+            this.agentDB = await AgentDBService.getInstance();
+            this.available = true;
+        }
+        catch {
+            this.available = false;
+        }
+        // Try SONA
+        try {
+            const { SonaRvfService } = await import('../services/sona-rvf-service.js');
+            this.sonaService = await SonaRvfService.getInstance();
+            this.sonaAvailable = true;
+        }
+        catch {
+            this.sonaAvailable = false;
+        }
+        return this.available;
+    }
+    /**
+     * Check if learning subsystem is available.
+     */
+    isAvailable() {
+        return this.available;
+    }
+    // -- Episode recording --
+    /**
+     * Record a successful task completion episode.
+     */
+    async recordTaskCompletion(episode) {
+        if (!this.available || !this.agentDB)
+            return;
+        try {
+            const reward = this.calculateReward(episode.iterations, episode.durationMs);
+            await this.agentDB.storeEpisode({
+                sessionId: episode.agentId || 'autopilot',
+                task: `[COMPLETED] ${episode.subject}`,
+                input: `taskId:${episode.taskId} iterations:${episode.iterations}`,
+                output: `Completed in ${episode.durationMs}ms`,
+                reward,
+                success: true,
+                tags: ['autopilot', 'completion'],
+            });
+            this.episodeCount++;
+        }
+        catch {
+            // Silently fail — learning is optional
+        }
+    }
+    /**
+     * Record a task failure episode.
+     */
+    async recordTaskFailure(episode) {
+        if (!this.available || !this.agentDB)
+            return;
+        try {
+            const reward = -0.5;
+            await this.agentDB.storeEpisode({
+                sessionId: episode.agentId || 'autopilot',
+                task: `[FAILED] ${episode.subject}`,
+                input: `taskId:${episode.taskId} iterations:${episode.iterations}`,
+                output: `Failed after ${episode.durationMs}ms`,
+                critique: episode.critique || `Task moved to ${episode.status}`,
+                reward,
+                success: false,
+                tags: ['autopilot', 'failure'],
+            });
+            this.episodeCount++;
+        }
+        catch {
+            // Silently fail
+        }
+    }
+    // -- History recall --
+    /**
+     * Recall similar tasks from past episodes.
+     */
+    async recallSimilarTasks(query, limit = 5) {
+        if (!this.available || !this.agentDB)
+            return [];
+        try {
+            return await this.agentDB.recallEpisodes(query, limit);
+        }
+        catch {
+            return [];
+        }
+    }
+    // -- Re-engagement context --
+    /**
+     * Build re-engagement context from past episodes and patterns.
+     * Queries top 3 remaining tasks against ReflexionMemory.
+     */
+    async getReEngagementContext(tasks) {
+        const empty = {
+            pastFailures: [],
+            pastSuccesses: [],
+            patterns: [],
+            recommendations: [],
+            confidence: 0,
+        };
+        if (!this.available || !this.agentDB)
+            return empty;
+        try {
+            const topTasks = tasks.slice(0, 3);
+            const episodeArrays = await Promise.all(topTasks.map(task => this.agentDB.recallEpisodes(task.subject, 3)));
+            const allEpisodes = episodeArrays.flat();
+            const pastFailures = allEpisodes
+                .filter((ep) => !ep.success)
+                .map((ep) => ({ task: ep.task, critique: ep.critique, reward: ep.reward }));
+            const pastSuccesses = allEpisodes
+                .filter((ep) => ep.success)
+                .map((ep) => ({ task: ep.task, reward: ep.reward }));
+            // Search for completion patterns
+            let patterns = [];
+            try {
+                const searchResults = await this.agentDB.searchPatterns('swarm completion', 5);
+                patterns = searchResults.map((p) => ({
+                    pattern: p.approach || p.taskType,
+                    frequency: p.uses || 1,
+                    avgReward: p.successRate || 0,
+                }));
+            }
+            catch {
+                // Patterns unavailable
+            }
+            // Generate recommendations
+            const recommendations = [];
+            if (pastFailures.length > 0) {
+                const failReasons = pastFailures
+                    .filter((f) => f.critique)
+                    .map((f) => f.critique)
+                    .slice(0, 3);
+                if (failReasons.length > 0) {
+                    recommendations.push(`Avoid previous failure patterns: ${failReasons.join('; ')}`);
+                }
+            }
+            if (pastSuccesses.length > 0) {
+                recommendations.push(`${pastSuccesses.length} similar tasks succeeded before — apply same approach`);
+            }
+            if (patterns.length > 0) {
+                const bestPattern = patterns.sort((a, b) => b.avgReward - a.avgReward)[0];
+                recommendations.push(`Best pattern: ${bestPattern.pattern} (success rate: ${Math.round(bestPattern.avgReward * 100)}%)`);
+            }
+            const confidence = allEpisodes.length > 0
+                ? Math.min(allEpisodes.length / 10, 1)
+                : 0;
+            return { pastFailures, pastSuccesses, patterns, recommendations, confidence };
+        }
+        catch {
+            return empty;
+        }
+    }
+    // -- SONA trajectory --
+    /**
+     * Begin tracking a swarm lifecycle via SONA trajectory.
+     */
+    async beginSwarmTrajectory(_sessionId) {
+        if (!this.sonaAvailable || !this.sonaService)
+            return;
+        try {
+            const traj = this.sonaService.beginTrajectory();
+            this.trajectoryId = traj.id;
+        }
+        catch {
+            this.trajectoryId = null;
+        }
+    }
+    /**
+     * Record an iteration step in the SONA trajectory.
+     */
+    async recordIterationStep(state, driftSignals) {
+        if (!this.sonaAvailable || !this.sonaService || !this.trajectoryId)
+            return;
+        try {
+            const stateStr = `iter:${state.iterations} progress:${Math.round(state.progress)}% completed:${state.completed}/${state.total}`;
+            const actionStr = driftSignals.length > 0
+                ? `drift:${driftSignals.map(s => s.type).join(',')}`
+                : 'normal';
+            const reward = state.total > 0 ? state.completed / state.total : 0;
+            this.sonaService.addStep(this.trajectoryId, {
+                state: stateStr,
+                action: actionStr,
+                reward,
+            });
+        }
+        catch {
+            // Silently fail
+        }
+    }
+    /**
+     * End the SONA trajectory and extract patterns.
+     */
+    async endSwarmTrajectory(finalState) {
+        if (!this.sonaAvailable || !this.sonaService || !this.trajectoryId)
+            return;
+        try {
+            this.sonaService.endTrajectory(this.trajectoryId);
+            this.trajectoryId = null;
+            // Store completion pattern in AgentDB if available
+            if (this.available && this.agentDB && finalState.total > 0) {
+                const successRate = finalState.completed / finalState.total;
+                await this.agentDB.storePattern({
+                    taskType: 'swarm-completion',
+                    approach: `completed ${finalState.completed}/${finalState.total} tasks`,
+                    successRate,
+                    tags: ['autopilot', 'trajectory'],
+                });
+            }
+        }
+        catch {
+            // Silently fail
+        }
+    }
+    // -- Pattern discovery and prediction --
+    /**
+     * Discover success patterns from past swarm completions.
+     */
+    async discoverSuccessPatterns() {
+        if (!this.available || !this.agentDB)
+            return [];
+        try {
+            return await this.agentDB.searchPatterns('swarm completion', 10);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Predict the next best action given current state.
+     */
+    async predictNextAction(state) {
+        if (!this.available || !this.agentDB) {
+            return { action: 'continue', confidence: 0, alternatives: [] };
+        }
+        try {
+            const stateStr = typeof state === 'string' ? state : JSON.stringify(state);
+            return await this.agentDB.predictAction(stateStr);
+        }
+        catch {
+            return { action: 'continue', confidence: 0, alternatives: [] };
+        }
+    }
+    // -- Metrics --
+    /**
+     * Get learning subsystem metrics.
+     */
+    async getMetrics() {
+        const metrics = {
+            available: this.available,
+            episodes: this.episodeCount,
+            patterns: 0,
+            trajectories: 0,
+            sonaStats: null,
+        };
+        if (this.available && this.agentDB) {
+            try {
+                const svcMetrics = await this.agentDB.getMetrics();
+                metrics.episodes = svcMetrics.episodes || this.episodeCount;
+                metrics.patterns = svcMetrics.patterns || 0;
+            }
+            catch {
+                // Use defaults
+            }
+        }
+        if (this.sonaAvailable && this.sonaService) {
+            try {
+                metrics.sonaStats = this.sonaService.getStats();
+                metrics.trajectories = metrics.sonaStats?.totalTrajectories || 0;
+            }
+            catch {
+                // Use defaults
+            }
+        }
+        return metrics;
+    }
+    /**
+     * Calculate reward for a completion episode.
+     * Formula: (1 - iters/(iters+10)) * 0.6 + (1 - min(durationMs/3600000, 1)) * 0.4
+     */
+    calculateReward(iterations, durationMs) {
+        const iterFactor = (1 - iterations / (iterations + 10)) * 0.6;
+        const timeFactor = (1 - Math.min(durationMs / 3600000, 1)) * 0.4;
+        return iterFactor + timeFactor;
+    }
+}
+//# sourceMappingURL=autopilot-learning.js.map

package/dist/agentic-flow/src/coordination/autopilot-learning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autopilot-learning.js","sourceRoot":"","sources":["../../../../src/coordination/autopilot-learning.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Autopilot Learning Bridge (ADR-058 v2)\n *\n * Bridges autopilot coordinator with AgentDB's ReflexionMemory,\n * LearningSystem, and SONA trajectory tracking. All methods\n * gracefully no-op when AgentDB/SONA are unavailable.\n */\n\nexport interface AutopilotEpisode {\n  taskId: string;\n  subject: string;\n  status: string;\n  iterations: number;\n  durationMs: number;\n  critique?: string;\n  agentId?: string;\n}\n\nexport interface ReEngagementContext {\n  pastFailures: Array<{ task: string; critique?: string; reward: number }>;\n  pastSuccesses: Array<{ task: string; reward: number }>;\n  patterns: Array<{ pattern: string; frequency: number; avgReward: number }>;\n  recommendations: string[];\n  confidence: number;\n}\n\nexport interface LearningMetrics {\n  available: boolean;\n  episodes: number;\n  patterns: number;\n  trajectories: number;\n  sonaStats: { totalTrajectories: number; totalSteps: number; avgReward: number; patternsFound: number } | null;\n}\n\nexport class AutopilotLearning {\n  private agentDB: any = null;\n  private sonaService: any = null;\n  private available = false;\n  private sonaAvailable = false;\n  private trajectoryId: string | null = null;\n  private episodeCount = 0;\n\n  /**\n   * Initialize by dynamically importing AgentDB and SONA services.\n   * Returns true if at least AgentDB is available.\n   */\n  async initialize(): Promise<boolean> {\n    // Try AgentDB\n    try {\n      const { AgentDBService } = await import('../services/agentdb-service.js');\n      this.agentDB = await AgentDBService.getInstance();\n      this.available = true;\n    } catch {\n      this.available = false;\n    }\n\n    // Try SONA\n    try {\n      const { SonaRvfService } = await import('../services/sona-rvf-service.js');\n      this.sonaService = await SonaRvfService.getInstance();\n      this.sonaAvailable = true;\n    } catch {\n      this.sonaAvailable = false;\n    }\n\n    return this.available;\n  }\n\n  /**\n   * Check if learning subsystem is available.\n   */\n  isAvailable(): boolean {\n    return this.available;\n  }\n\n  // -- Episode recording --\n\n  /**\n   * Record a successful task completion episode.\n   */\n  async recordTaskCompletion(episode: AutopilotEpisode): Promise<void> {\n    if (!this.available || !this.agentDB) return;\n    try {\n      const reward = this.calculateReward(episode.iterations, episode.durationMs);\n      await this.agentDB.storeEpisode({\n        sessionId: episode.agentId || 'autopilot',\n        task: `[COMPLETED] ${episode.subject}`,\n        input: `taskId:${episode.taskId} iterations:${episode.iterations}`,\n        output: `Completed in ${episode.durationMs}ms`,\n        reward,\n        success: true,\n        tags: ['autopilot', 'completion'],\n      });\n      this.episodeCount++;\n    } catch {\n      // Silently fail — learning is optional\n    }\n  }\n\n  /**\n   * Record a task failure episode.\n   */\n  async recordTaskFailure(episode: AutopilotEpisode): Promise<void> {\n    if (!this.available || !this.agentDB) return;\n    try {\n      const reward = -0.5;\n      await this.agentDB.storeEpisode({\n        sessionId: episode.agentId || 'autopilot',\n        task: `[FAILED] ${episode.subject}`,\n        input: `taskId:${episode.taskId} iterations:${episode.iterations}`,\n        output: `Failed after ${episode.durationMs}ms`,\n        critique: episode.critique || `Task moved to ${episode.status}`,\n        reward,\n        success: false,\n        tags: ['autopilot', 'failure'],\n      });\n      this.episodeCount++;\n    } catch {\n      // Silently fail\n    }\n  }\n\n  // -- History recall --\n\n  /**\n   * Recall similar tasks from past episodes.\n   */\n  async recallSimilarTasks(query: string, limit = 5): Promise<any[]> {\n    if (!this.available || !this.agentDB) return [];\n    try {\n      return await this.agentDB.recallEpisodes(query, limit);\n    } catch {\n      return [];\n    }\n  }\n\n  // -- Re-engagement context --\n\n  /**\n   * Build re-engagement context from past episodes and patterns.\n   * Queries top 3 remaining tasks against ReflexionMemory.\n   */\n  async getReEngagementContext(tasks: Array<{ subject: string; status: string }>): Promise<ReEngagementContext> {\n    const empty: ReEngagementContext = {\n      pastFailures: [],\n      pastSuccesses: [],\n      patterns: [],\n      recommendations: [],\n      confidence: 0,\n    };\n\n    if (!this.available || !this.agentDB) return empty;\n\n    try {\n      const topTasks = tasks.slice(0, 3);\n      const episodeArrays = await Promise.all(\n        topTasks.map(task => this.agentDB.recallEpisodes(task.subject, 3)),\n      );\n      const allEpisodes: any[] = episodeArrays.flat();\n\n      const pastFailures = allEpisodes\n        .filter((ep: any) => !ep.success)\n        .map((ep: any) => ({ task: ep.task, critique: ep.critique, reward: ep.reward }));\n\n      const pastSuccesses = allEpisodes\n        .filter((ep: any) => ep.success)\n        .map((ep: any) => ({ task: ep.task, reward: ep.reward }));\n\n      // Search for completion patterns\n      let patterns: Array<{ pattern: string; frequency: number; avgReward: number }> = [];\n      try {\n        const searchResults = await this.agentDB.searchPatterns('swarm completion', 5);\n        patterns = searchResults.map((p: any) => ({\n          pattern: p.approach || p.taskType,\n          frequency: p.uses || 1,\n          avgReward: p.successRate || 0,\n        }));\n      } catch {\n        // Patterns unavailable\n      }\n\n      // Generate recommendations\n      const recommendations: string[] = [];\n\n      if (pastFailures.length > 0) {\n        const failReasons = pastFailures\n          .filter((f) => f.critique)\n          .map((f) => f.critique)\n          .slice(0, 3);\n        if (failReasons.length > 0) {\n          recommendations.push(`Avoid previous failure patterns: ${failReasons.join('; ')}`);\n        }\n      }\n\n      if (pastSuccesses.length > 0) {\n        recommendations.push(`${pastSuccesses.length} similar tasks succeeded before — apply same approach`);\n      }\n\n      if (patterns.length > 0) {\n        const bestPattern = patterns.sort((a, b) => b.avgReward - a.avgReward)[0];\n        recommendations.push(`Best pattern: ${bestPattern.pattern} (success rate: ${Math.round(bestPattern.avgReward * 100)}%)`);\n      }\n\n      const confidence = allEpisodes.length > 0\n        ? Math.min(allEpisodes.length / 10, 1)\n        : 0;\n\n      return { pastFailures, pastSuccesses, patterns, recommendations, confidence };\n    } catch {\n      return empty;\n    }\n  }\n\n  // -- SONA trajectory --\n\n  /**\n   * Begin tracking a swarm lifecycle via SONA trajectory.\n   */\n  async beginSwarmTrajectory(_sessionId: string): Promise<void> {\n    if (!this.sonaAvailable || !this.sonaService) return;\n    try {\n      const traj = this.sonaService.beginTrajectory();\n      this.trajectoryId = traj.id;\n    } catch {\n      this.trajectoryId = null;\n    }\n  }\n\n  /**\n   * Record an iteration step in the SONA trajectory.\n   */\n  async recordIterationStep(\n    state: { completed: number; total: number; iterations: number; progress: number },\n    driftSignals: Array<{ type: string; severity: string }>,\n  ): Promise<void> {\n    if (!this.sonaAvailable || !this.sonaService || !this.trajectoryId) return;\n    try {\n      const stateStr = `iter:${state.iterations} progress:${Math.round(state.progress)}% completed:${state.completed}/${state.total}`;\n      const actionStr = driftSignals.length > 0\n        ? `drift:${driftSignals.map(s => s.type).join(',')}`\n        : 'normal';\n      const reward = state.total > 0 ? state.completed / state.total : 0;\n\n      this.sonaService.addStep(this.trajectoryId, {\n        state: stateStr,\n        action: actionStr,\n        reward,\n      });\n    } catch {\n      // Silently fail\n    }\n  }\n\n  /**\n   * End the SONA trajectory and extract patterns.\n   */\n  async endSwarmTrajectory(finalState: { completed: number; total: number }): Promise<void> {\n    if (!this.sonaAvailable || !this.sonaService || !this.trajectoryId) return;\n    try {\n      this.sonaService.endTrajectory(this.trajectoryId);\n      this.trajectoryId = null;\n\n      // Store completion pattern in AgentDB if available\n      if (this.available && this.agentDB && finalState.total > 0) {\n        const successRate = finalState.completed / finalState.total;\n        await this.agentDB.storePattern({\n          taskType: 'swarm-completion',\n          approach: `completed ${finalState.completed}/${finalState.total} tasks`,\n          successRate,\n          tags: ['autopilot', 'trajectory'],\n        });\n      }\n    } catch {\n      // Silently fail\n    }\n  }\n\n  // -- Pattern discovery and prediction --\n\n  /**\n   * Discover success patterns from past swarm completions.\n   */\n  async discoverSuccessPatterns(): Promise<any[]> {\n    if (!this.available || !this.agentDB) return [];\n    try {\n      return await this.agentDB.searchPatterns('swarm completion', 10);\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * Predict the next best action given current state.\n   */\n  async predictNextAction(state: any): Promise<any> {\n    if (!this.available || !this.agentDB) {\n      return { action: 'continue', confidence: 0, alternatives: [] };\n    }\n    try {\n      const stateStr = typeof state === 'string' ? state : JSON.stringify(state);\n      return await this.agentDB.predictAction(stateStr);\n    } catch {\n      return { action: 'continue', confidence: 0, alternatives: [] };\n    }\n  }\n\n  // -- Metrics --\n\n  /**\n   * Get learning subsystem metrics.\n   */\n  async getMetrics(): Promise<LearningMetrics> {\n    const metrics: LearningMetrics = {\n      available: this.available,\n      episodes: this.episodeCount,\n      patterns: 0,\n      trajectories: 0,\n      sonaStats: null,\n    };\n\n    if (this.available && this.agentDB) {\n      try {\n        const svcMetrics = await this.agentDB.getMetrics();\n        metrics.episodes = svcMetrics.episodes || this.episodeCount;\n        metrics.patterns = svcMetrics.patterns || 0;\n      } catch {\n        // Use defaults\n      }\n    }\n\n    if (this.sonaAvailable && this.sonaService) {\n      try {\n        metrics.sonaStats = this.sonaService.getStats();\n        metrics.trajectories = metrics.sonaStats?.totalTrajectories || 0;\n      } catch {\n        // Use defaults\n      }\n    }\n\n    return metrics;\n  }\n\n  /**\n   * Calculate reward for a completion episode.\n   * Formula: (1 - iters/(iters+10)) * 0.6 + (1 - min(durationMs/3600000, 1)) * 0.4\n   */\n  private calculateReward(iterations: number, durationMs: number): number {\n    const iterFactor = (1 - iterations / (iterations + 10)) * 0.6;\n    const timeFactor = (1 - Math.min(durationMs / 3600000, 1)) * 0.4;\n    return iterFactor + timeFactor;\n  }\n}\n"]}

package/dist/agentic-flow/src/coordination/drift-detector.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Drift Detector (ADR-058)
+ *
+ * Tracks iteration history and detects four drift types that can degrade
+ * swarm completion: stall, cycling, thrashing, and decay.  Pure TypeScript
+ * with zero external dependencies.
+ */
+export interface DriftConfig {
+    stallThreshold: number;
+    cyclingThreshold: number;
+    thrashingThreshold: number;
+    windowSize: number;
+}
+export type DriftType = 'stall' | 'cycling' | 'thrashing' | 'decay';
+export type DriftSeverity = 'low' | 'medium' | 'high';
+export type MitigationAction = 'escalate' | 'reprioritize' | 'reassign' | 'skip';
+export interface DriftSignal {
+    type: DriftType;
+    severity: DriftSeverity;
+    message: string;
+    affectedTaskIds?: string[];
+    detectedAt: number;
+}
+export interface MitigationStrategy {
+    action: MitigationAction;
+    taskIds: string[];
+    reason: string;
+}
+export interface DriftMetrics {
+    totalSignals: number;
+    signalsByType: Record<DriftType, number>;
+    iterationsSinceLastCompletion: number;
+    completionRateHistory: number[];
+    activeSignals: DriftSignal[];
+}
+export declare class DriftDetector {
+    private config;
+    private completionCounts;
+    private taskFailures;
+    private reassignments;
+    private lastCompletedCount;
+    private iterationsSinceLastCompletion;
+    private signals;
+    private signalCounts;
+    constructor(config?: Partial<DriftConfig>);
+    /**
+     * Record an iteration snapshot.  The coordinator passes the current number
+     * of completed tasks so we can track progress over time.
+     */
+    recordIteration(state: {
+        completed: number;
+    }): void;
+    /**
+     * Record a task failure event.
+     */
+    recordTaskFailure(taskId: string, _reason?: string): void;
+    /**
+     * Record an agent reassignment for a task.
+     */
+    recordAgentReassignment(taskId: string, _fromAgent: string, _toAgent: string): void;
+    /**
+     * Run all four drift detections and return any signals found.
+     */
+    detectDrift(): DriftSignal[];
+    /**
+     * Suggest a mitigation strategy for a given drift signal.
+     */
+    suggestMitigation(signal: DriftSignal): MitigationStrategy;
+    /**
+     * Return current drift metrics.
+     */
+    getMetrics(): DriftMetrics;
+    /**
+     * Reset all internal state.
+     */
+    reset(): void;
+    /**
+     * Return a copy of the current config.
+     */
+    getConfig(): DriftConfig;
+    /**
+     * Merge partial config into the current config.
+     */
+    setConfig(config: Partial<DriftConfig>): void;
+}
+//# sourceMappingURL=drift-detector.d.ts.map

package/dist/agentic-flow/src/coordination/drift-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-detector.d.ts","sourceRoot":"","sources":["../../../../src/coordination/drift-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,cAAc,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACzC,6BAA6B,EAAE,MAAM,CAAC;IACtC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAiBD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,6BAA6B,CAAK;IAC1C,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,YAAY,CAKlB;gBAEU,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAQ7C;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgBnD;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAKzD;;OAEG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IASnF;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IA0E5B;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB;IAmC1D;;OAEG;IACH,UAAU,IAAI,YAAY;IAW1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;CAG9C"}

package/dist/agentic-flow/src/coordination/drift-detector.js

@@ -0,0 +1,218 @@
+/**
+ * Drift Detector (ADR-058)
+ *
+ * Tracks iteration history and detects four drift types that can degrade
+ * swarm completion: stall, cycling, thrashing, and decay.  Pure TypeScript
+ * with zero external dependencies.
+ */
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_DRIFT_CONFIG = {
+    stallThreshold: 5,
+    cyclingThreshold: 3,
+    thrashingThreshold: 3,
+    windowSize: 10,
+};
+// ---------------------------------------------------------------------------
+// DriftDetector
+// ---------------------------------------------------------------------------
+export class DriftDetector {
+    config;
+    completionCounts = [];
+    taskFailures = new Map();
+    reassignments = new Map();
+    lastCompletedCount = 0;
+    iterationsSinceLastCompletion = 0;
+    signals = [];
+    signalCounts = {
+        stall: 0,
+        cycling: 0,
+        thrashing: 0,
+        decay: 0,
+    };
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_DRIFT_CONFIG, ...config };
+    }
+    // -----------------------------------------------------------------------
+    // Recording methods — called by coordinator on each tick / event
+    // -----------------------------------------------------------------------
+    /**
+     * Record an iteration snapshot.  The coordinator passes the current number
+     * of completed tasks so we can track progress over time.
+     */
+    recordIteration(state) {
+        this.completionCounts.push(state.completed);
+        // Trim to sliding window — shift is O(1) amortised vs slice which copies
+        while (this.completionCounts.length > this.config.windowSize) {
+            this.completionCounts.shift();
+        }
+        if (state.completed > this.lastCompletedCount) {
+            this.iterationsSinceLastCompletion = 0;
+            this.lastCompletedCount = state.completed;
+        }
+        else {
+            this.iterationsSinceLastCompletion++;
+        }
+    }
+    /**
+     * Record a task failure event.
+     */
+    recordTaskFailure(taskId, _reason) {
+        const current = this.taskFailures.get(taskId) ?? 0;
+        this.taskFailures.set(taskId, current + 1);
+    }
+    /**
+     * Record an agent reassignment for a task.
+     */
+    recordAgentReassignment(taskId, _fromAgent, _toAgent) {
+        const current = this.reassignments.get(taskId) ?? 0;
+        this.reassignments.set(taskId, current + 1);
+    }
+    // -----------------------------------------------------------------------
+    // Detection — single call returns all active signals
+    // -----------------------------------------------------------------------
+    /**
+     * Run all four drift detections and return any signals found.
+     */
+    detectDrift() {
+        this.signals = [];
+        const now = Date.now();
+        // 1. Stall detection
+        if (this.iterationsSinceLastCompletion >= this.config.stallThreshold) {
+            const signal = {
+                type: 'stall',
+                severity: 'high',
+                message: `No completions in ${this.iterationsSinceLastCompletion} iterations`,
+                detectedAt: now,
+            };
+            this.signals.push(signal);
+        }
+        // 2. Cycling detection
+        for (const [id, count] of this.taskFailures) {
+            if (count >= this.config.cyclingThreshold) {
+                const signal = {
+                    type: 'cycling',
+                    severity: 'medium',
+                    message: `Task ${id} has failed ${count} times`,
+                    affectedTaskIds: [id],
+                    detectedAt: now,
+                };
+                this.signals.push(signal);
+            }
+        }
+        // 3. Thrashing detection
+        for (const [id, count] of this.reassignments) {
+            if (count >= this.config.thrashingThreshold) {
+                const signal = {
+                    type: 'thrashing',
+                    severity: 'medium',
+                    message: `Task ${id} reassigned ${count} times`,
+                    affectedTaskIds: [id],
+                    detectedAt: now,
+                };
+                this.signals.push(signal);
+            }
+        }
+        // 4. Decay detection — inline sums to avoid allocating temp arrays
+        if (this.completionCounts.length >= this.config.windowSize) {
+            const half = Math.floor(this.config.windowSize / 2);
+            let firstSum = 0;
+            let secondSum = 0;
+            for (let i = 0; i < half; i++)
+                firstSum += this.completionCounts[i];
+            for (let i = half; i < this.completionCounts.length; i++)
+                secondSum += this.completionCounts[i];
+            if (firstSum > 0 && secondSum < firstSum * 0.5) {
+                const signal = {
+                    type: 'decay',
+                    severity: 'low',
+                    message: 'Completion rate declining',
+                    detectedAt: now,
+                };
+                this.signals.push(signal);
+            }
+        }
+        // Increment signal counts
+        for (const signal of this.signals) {
+            this.signalCounts[signal.type]++;
+        }
+        return this.signals;
+    }
+    // -----------------------------------------------------------------------
+    // Mitigation
+    // -----------------------------------------------------------------------
+    /**
+     * Suggest a mitigation strategy for a given drift signal.
+     */
+    suggestMitigation(signal) {
+        const taskIds = signal.affectedTaskIds ?? [];
+        switch (signal.type) {
+            case 'stall':
+                return {
+                    action: 'escalate',
+                    taskIds,
+                    reason: 'Swarm stalled - escalating remaining tasks',
+                };
+            case 'cycling':
+                return {
+                    action: 'reprioritize',
+                    taskIds,
+                    reason: 'Task cycling detected - resetting to pending',
+                };
+            case 'thrashing':
+                return {
+                    action: 'reassign',
+                    taskIds,
+                    reason: 'Agent thrashing detected - clearing owner',
+                };
+            case 'decay':
+                return {
+                    action: 'skip',
+                    taskIds,
+                    reason: 'Completion rate decaying - consider skipping blocked tasks',
+                };
+        }
+    }
+    // -----------------------------------------------------------------------
+    // State
+    // -----------------------------------------------------------------------
+    /**
+     * Return current drift metrics.
+     */
+    getMetrics() {
+        const totalSignals = Object.values(this.signalCounts).reduce((a, b) => a + b, 0);
+        return {
+            totalSignals,
+            signalsByType: { ...this.signalCounts },
+            iterationsSinceLastCompletion: this.iterationsSinceLastCompletion,
+            completionRateHistory: [...this.completionCounts],
+            activeSignals: [...this.signals],
+        };
+    }
+    /**
+     * Reset all internal state.
+     */
+    reset() {
+        this.completionCounts = [];
+        this.taskFailures.clear();
+        this.reassignments.clear();
+        this.lastCompletedCount = 0;
+        this.iterationsSinceLastCompletion = 0;
+        this.signals = [];
+        this.signalCounts = { stall: 0, cycling: 0, thrashing: 0, decay: 0 };
+    }
+    /**
+     * Return a copy of the current config.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Merge partial config into the current config.
+     */
+    setConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+//# sourceMappingURL=drift-detector.js.map