agentic-flow 3.0.0-alpha.1 → 3.0.0

package/dist/cli/update-message.js

@@ -1,175 +0,0 @@
-/**
- * Update Message Display for agentic-flow
- * Displays philosophy-driven update notifications
- */
-import chalk from 'chalk';
-/**
- * Display update message with philosophy
- */
-export function displayUpdateMessage(info) {
-    const { currentVersion, latestVersion, releaseDate, features, philosophy } = info;
-    console.log('\n');
-    console.log(chalk.cyan('╔══════════════════════════════════════════════════════════════╗'));
-    console.log(chalk.cyan('║') + '                                                              ' + chalk.cyan('║'));
-    console.log(chalk.cyan('║') + chalk.bold.white('              agentic-flow v' + latestVersion + '                             ') + chalk.cyan('║'));
-    console.log(chalk.cyan('║') + chalk.bold.yellow('              Intelligence Without Scale                       ') + chalk.cyan('║'));
-    console.log(chalk.cyan('║') + '                                                              ' + chalk.cyan('║'));
-    console.log(chalk.cyan('╚══════════════════════════════════════════════════════════════╝'));
-    console.log('');
-    // Philosophy quote
-    if (philosophy) {
-        console.log(chalk.italic.gray('  "' + philosophy + '"'));
-        console.log('');
-    }
-    // Key features
-    console.log(chalk.bold.white('  ✨ What\'s New:'));
-    console.log('');
-    features.forEach(feature => {
-        const [title, description] = feature.split(':');
-        console.log(chalk.green('  •') + chalk.white(' ' + title.trim()));
-        if (description) {
-            console.log(chalk.gray('     └─ ' + description.trim()));
-        }
-    });
-    console.log('');
-    // Quick actions
-    console.log(chalk.cyan('╔══════════════════════════════════════════════════════════════╗'));
-    console.log(chalk.cyan('║') + chalk.bold.white('  Quick Start:                                                 ') + chalk.cyan('║'));
-    console.log(chalk.cyan('╠══════════════════════════════════════════════════════════════╣'));
-    console.log(chalk.cyan('║') + chalk.white('  Update:     ') + chalk.yellow('npm install -g agentic-flow@latest') + '            ' + chalk.cyan('║'));
-    console.log(chalk.cyan('║') + chalk.white('  Skills:     ') + chalk.yellow('npx agentic-flow skills list') + '                  ' + chalk.cyan('║'));
-    console.log(chalk.cyan('║') + chalk.white('  Learn:      ') + chalk.yellow('npx agentic-flow --help') + '                       ' + chalk.cyan('║'));
-    console.log(chalk.cyan('╚══════════════════════════════════════════════════════════════╝'));
-    console.log('');
-    console.log(chalk.gray('  Release Date: ' + releaseDate));
-    console.log(chalk.gray('  Current Version: v' + currentVersion + ' → v' + latestVersion));
-    console.log('');
-}
-/**
- * Display compact update notification
- */
-export function displayCompactUpdate(currentVersion, latestVersion) {
-    console.log('');
-    console.log(chalk.yellow('🚀 Update Available: ') +
-        chalk.gray('v' + currentVersion) +
-        chalk.white(' → ') +
-        chalk.green('v' + latestVersion));
-    console.log('');
-    console.log(chalk.white('   Run: ') + chalk.cyan('npm install -g agentic-flow@latest'));
-    console.log('   ' + chalk.gray('Intelligence Without Scale'));
-    console.log('');
-}
-/**
- * v1.7.0 specific update message
- */
-export function displayV170Update() {
-    displayUpdateMessage({
-        currentVersion: '1.6.6',
-        latestVersion: '1.7.0',
-        releaseDate: 'October 19, 2025',
-        philosophy: 'The future belongs to systems that are small, structured, and constantly learning.',
-        features: [
-            'Claude Code Skills: 20 skills for orchestration & AgentDB',
-            'Graph-Based Learning: Self-reinforcing patterns through relationships',
-            '150x-12,500x Performance: Light, local, and alive',
-            'Model Optimizer: 85-98% cost savings through smart selection',
-            'Agent-Booster: 352x faster code editing, $0 cost',
-            'Adaptive AI: Learns HOW to think, not WHAT to think',
-        ],
-    });
-}
-/**
- * Philosophy-focused banner
- */
-export function displayPhilosophyBanner() {
-    console.log('\n');
-    console.log(chalk.cyan('═══════════════════════════════════════════════════════════════'));
-    console.log('');
-    console.log(chalk.bold.white('  Intelligence Without Scale'));
-    console.log('');
-    console.log(chalk.gray('  Some people think intelligence needs to be massive to matter.'));
-    console.log(chalk.gray('  I\'ve learned it\'s the opposite.'));
-    console.log('');
-    console.log(chalk.white('  The future belongs to systems that are:'));
-    console.log(chalk.green('  • Small') + chalk.gray(' - Binary quantization: 32x memory reduction'));
-    console.log(chalk.green('  • Structured') + chalk.gray(' - Graph-based: relationships > repetition'));
-    console.log(chalk.green('  • Constantly Learning') + chalk.gray(' - Self-reinforcing patterns'));
-    console.log('');
-    console.log(chalk.yellow('  ⚡ 150x-12,500x faster than traditional approaches'));
-    console.log(chalk.yellow('  💰 $0 cost with local WASM execution'));
-    console.log(chalk.yellow('  🧠 Adaptive AI that learns through feedback'));
-    console.log('');
-    console.log(chalk.italic.gray('  "The traditional approach treats every problem like a nail'));
-    console.log(chalk.italic.gray('   because it only knows the hammer of scale. But the real'));
-    console.log(chalk.italic.gray('   future of AI isn\'t heavy or closed—it\'s light, open,'));
-    console.log(chalk.italic.gray('   and adaptive."'));
-    console.log('');
-    console.log(chalk.cyan('═══════════════════════════════════════════════════════════════'));
-    console.log('\n');
-}
-/**
- * Display graph intelligence explanation
- */
-export function displayGraphIntelligence() {
-    console.log('\n');
-    console.log(chalk.bold.white('🧬 Graph-Based Intelligence'));
-    console.log('');
-    console.log(chalk.gray('  Traditional AI:           agentic-flow:'));
-    console.log(chalk.gray('  ───────────────           ─────────────'));
-    console.log(chalk.red('  Massive models       →   ') + chalk.green('Small vectors (32x smaller)'));
-    console.log(chalk.red('  Dataset repetition   →   ') + chalk.green('Relationship learning'));
-    console.log(chalk.red('  Static weights       →   ') + chalk.green('Self-reinforcing patterns'));
-    console.log(chalk.red('  GPU-dependent        →   ') + chalk.green('CPU-optimized WASM'));
-    console.log(chalk.red('  Declarative (what)   →   ') + chalk.green('Adaptive (how)'));
-    console.log('');
-    console.log(chalk.white('  How it works:'));
-    console.log('');
-    console.log(chalk.gray('  ┌─────────────────────┐'));
-    console.log(chalk.gray('  │ Context Fragment    │') + chalk.white(' ← Idea/Result/Observation'));
-    console.log(chalk.gray('  │ • Domain: "api"     │'));
-    console.log(chalk.gray('  │ • Pattern: {...}    │'));
-    console.log(chalk.gray('  │ • Confidence: 0.95  │'));
-    console.log(chalk.gray('  └─────────────────────┘'));
-    console.log(chalk.gray('           │'));
-    console.log(chalk.gray('      ') + chalk.yellow('Similarity Links'));
-    console.log(chalk.gray('           │'));
-    console.log(chalk.gray('      ┌────┴────┐'));
-    console.log(chalk.gray('      ▼         ▼'));
-    console.log(chalk.gray('    Node A    Node B  ') + chalk.white('← Self-reinforcing graph'));
-    console.log('');
-    console.log(chalk.italic.gray('  Patterns emerge over time. The system learns without'));
-    console.log(chalk.italic.gray('  retraining, adjusting its logic as it goes.'));
-    console.log('\n');
-}
-/**
- * Check if update is available (placeholder - implement with npm registry check)
- */
-export async function checkForUpdates(currentVersion) {
-    try {
-        // TODO: Implement actual npm registry check
-        // For now, return mock data
-        return {
-            updateAvailable: false,
-            latestVersion: currentVersion,
-        };
-    }
-    catch (error) {
-        return {
-            updateAvailable: false,
-        };
-    }
-}
-/**
- * Display update notification on CLI startup (non-intrusive)
- */
-export function displayStartupUpdateCheck(currentVersion, latestVersion) {
-    if (currentVersion !== latestVersion) {
-        console.log('');
-        console.log(chalk.bgYellow.black(' UPDATE ') +
-            ' ' +
-            chalk.yellow('v' + latestVersion + ' available') +
-            chalk.gray(' (current: v' + currentVersion + ')'));
-        console.log(chalk.gray('         Run: ') + chalk.cyan('npm install -g agentic-flow@latest'));
-        console.log('');
-    }
-}

package/dist/coordination/drift-detector.d.ts

@@ -1,86 +0,0 @@
-/**
- * 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/coordination/drift-detector.d.ts.map

@@ -1 +0,0 @@
-{"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/coordination/drift-detector.js

@@ -1,218 +0,0 @@
-/**
- * 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

package/dist/coordination/drift-detector.js.map

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

package/dist/coordination/graph-state-manager.d.ts

@@ -1,69 +0,0 @@
-/**
- * Graph-Based Agent State Management
- * Uses @ruvector/graph-node for hypergraph state tracking.
- * Falls back to in-memory maps when the native backend is unavailable.
- */
-interface GraphNode {
-    id: string;
-    type: 'agent' | 'task' | 'episode' | 'skill';
-    properties: Record<string, any>;
-}
-interface GraphEdge {
-    from: string;
-    to: string;
-    type: string;
-    properties: Record<string, any>;
-    timestamp: number;
-}
-interface GraphStats {
-    nodes: number;
-    edges: number;
-    available: boolean;
-}
-export declare class GraphStateManager {
-    private graphDb;
-    private available;
-    private nodes;
-    private edges;
-    /**
-     * Attempt to load @ruvector/graph-node.
-     * Returns true if the native graph backend is available.
-     */
-    initialize(): Promise<boolean>;
-    /**
-     * Add a node to the graph. Persists in the native backend when available.
-     */
-    addNode(node: GraphNode): Promise<void>;
-    /**
-     * Add an edge between two nodes.
-     */
-    addEdge(edge: GraphEdge): Promise<void>;
-    /**
-     * Remove a node and all associated edges.
-     */
-    removeNode(nodeId: string): Promise<void>;
-    /**
-     * Query the graph. Falls back to returning all nodes of matching type.
-     */
-    query(cypher: string): Promise<any[]>;
-    /**
-     * Get all edges connected to a node.
-     */
-    getRelationships(nodeId: string): Promise<GraphEdge[]>;
-    /**
-     * Get a specific node by ID.
-     */
-    getNode(nodeId: string): GraphNode | undefined;
-    /**
-     * Get all nodes of a given type.
-     */
-    getNodesByType(type: GraphNode['type']): GraphNode[];
-    /**
-     * Return current graph statistics.
-     */
-    getStats(): GraphStats;
-    isAvailable(): boolean;
-}
-export declare const graphStateManager: GraphStateManager;
-export {};
-//# sourceMappingURL=graph-state-manager.d.ts.map

package/dist/coordination/graph-state-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph-state-manager.d.ts","sourceRoot":"","sources":["../../src/coordination/graph-state-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,KAAK,CAAmB;IAEhC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAepC;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAkB3C;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAI5D;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI9C;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE;IAIpD;;OAEG;IACH,QAAQ,IAAI,UAAU;IAQtB,WAAW,IAAI,OAAO;CAGvB;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}