cognitive-core 0.2.4 → 0.3.1

package/dist/learning/llm-extractor.js

@@ -0,0 +1,372 @@
+/**
+ * LLM-Based Playbook Extractor
+ *
+ * Uses language models to generate higher-quality playbooks
+ * from trajectories. Complements the pattern-based extractor
+ * with deeper semantic analysis.
+ */
+import { createPlaybook } from '../types/index.js';
+const DEFAULT_CONFIG = {
+    temperature: 0.2,
+    maxTokens: 2000,
+    extractFromSingle: true,
+    minComplexity: 3, // Minimum steps to warrant LLM extraction
+};
+/**
+ * LLM-Based Playbook Extractor
+ */
+export class LLMPlaybookExtractor {
+    provider;
+    config;
+    constructor(provider, config) {
+        this.provider = provider;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Extract playbooks from trajectories using LLM
+     */
+    async extract(trajectories, analyses, existingPlaybooks = []) {
+        // Filter to successful, complex enough trajectories
+        const candidates = trajectories.filter((t, i) => {
+            const analysis = analyses[i];
+            return (analysis?.success &&
+                analysis.abstractable &&
+                t.steps.length >= this.config.minComplexity);
+        });
+        if (candidates.length === 0) {
+            return { playbooks: [], refinements: [] };
+        }
+        // Extract playbooks from each candidate
+        const allResults = {
+            playbooks: [],
+            refinements: [],
+        };
+        // Process individually for better quality
+        if (this.config.extractFromSingle) {
+            for (let i = 0; i < candidates.length; i++) {
+                const trajectory = candidates[i];
+                const analysis = analyses.find((_, idx) => trajectories[idx] === trajectory);
+                if (!analysis)
+                    continue;
+                const result = await this.extractFromSingleTrajectory(trajectory, analysis, existingPlaybooks);
+                allResults.playbooks.push(...result.playbooks);
+                allResults.refinements.push(...result.refinements);
+            }
+        }
+        // Also do batch extraction if we have multiple
+        if (candidates.length >= 2) {
+            const batchResult = await this.extractFromBatch(candidates, analyses.filter((_, i) => candidates.includes(trajectories[i])), existingPlaybooks);
+            // Merge with individual results (avoid duplicates)
+            for (const playbook of batchResult.playbooks) {
+                const isDuplicate = allResults.playbooks.some((p) => this.isSimilarPlaybook(p, playbook));
+                if (!isDuplicate) {
+                    allResults.playbooks.push(playbook);
+                }
+            }
+            allResults.refinements.push(...batchResult.refinements);
+        }
+        return allResults;
+    }
+    /**
+     * Extract a playbook from a single trajectory
+     */
+    async extractFromSingleTrajectory(trajectory, analysis, existingPlaybooks) {
+        const prompt = this.buildSingleExtractionPrompt(trajectory, analysis, existingPlaybooks);
+        const response = await this.provider.complete([{ role: 'user', content: prompt }], {
+            temperature: this.config.temperature,
+            maxTokens: this.config.maxTokens,
+        });
+        return this.parseExtractionResponse(response, trajectory);
+    }
+    /**
+     * Extract playbooks from a batch of trajectories
+     */
+    async extractFromBatch(trajectories, analyses, existingPlaybooks) {
+        const prompt = this.buildBatchExtractionPrompt(trajectories, analyses, existingPlaybooks);
+        const response = await this.provider.complete([{ role: 'user', content: prompt }], {
+            temperature: this.config.temperature,
+            maxTokens: this.config.maxTokens * 2,
+        });
+        return this.parseExtractionResponse(response);
+    }
+    /**
+     * Build prompt for single trajectory extraction
+     */
+    buildSingleExtractionPrompt(trajectory, analysis, existingPlaybooks) {
+        const keyStepsDesc = analysis.keySteps
+            .map((idx) => {
+            const step = trajectory.steps[idx];
+            return step
+                ? `  - Step ${idx + 1}: ${step.action}${step.thought ? ` (reasoning: ${step.thought})` : ''}`
+                : '';
+        })
+            .filter(Boolean)
+            .join('\n');
+        const existingPlaybookNames = existingPlaybooks
+            .map((p) => `- ${p.name}: ${p.guidance.strategy.slice(0, 100)}`)
+            .slice(0, 5)
+            .join('\n');
+        return `Analyze this successful problem-solving trajectory and extract a reusable playbook.
+
+## Task
+${trajectory.task.description}
+Domain: ${trajectory.task.domain}
+
+## Solution Steps
+${trajectory.steps.map((s, i) => `${i + 1}. ${s.action}${s.observation ? `\n   Observation: ${s.observation.slice(0, 100)}` : ''}`).join('\n')}
+
+## Key Steps (most important for success)
+${keyStepsDesc}
+
+## Outcome
+${trajectory.outcome.success ? 'SUCCESS' : 'FAILURE'}: ${trajectory.outcome.solution ?? trajectory.outcome.errorInfo ?? 'No details'}
+
+${existingPlaybooks.length > 0 ? `## Existing Playbooks (avoid duplicates)
+${existingPlaybookNames}` : ''}
+
+## Instructions
+Extract a reusable playbook that captures the essential approach. Focus on:
+1. What situations trigger this approach
+2. The core strategy/pattern used
+3. Key tactical steps
+4. Success/failure indicators
+
+Respond in JSON format:
+{
+  "playbook": {
+    "name": "kebab-case-name",
+    "situations": ["when X happens", "for Y type problems"],
+    "triggers": ["error messages", "signals that trigger this"],
+    "antiPatterns": ["when NOT to use this"],
+    "strategy": "High-level approach description",
+    "tactics": ["specific technique 1", "specific technique 2"],
+    "steps": ["step 1", "step 2", "step 3"],
+    "successIndicators": ["how to know it worked"],
+    "failureIndicators": ["how to know it failed"],
+    "complexity": "simple|moderate|complex",
+    "estimatedEffort": 5
+  },
+  "isRefinementOf": null
+}
+
+If this is better suited as a refinement to an existing playbook, set isRefinementOf to the playbook name and include only the refinement details.`;
+    }
+    /**
+     * Build prompt for batch extraction
+     */
+    buildBatchExtractionPrompt(trajectories, analyses, existingPlaybooks) {
+        const trajectorySummaries = trajectories
+            .map((t, i) => {
+            const analysis = analyses[i];
+            const keySteps = analysis?.keySteps ?? [];
+            return `### Trajectory ${i + 1}
+Task: ${t.task.description}
+Domain: ${t.task.domain}
+Steps: ${t.steps.length}
+Key steps: ${keySteps.map((idx) => t.steps[idx]?.action ?? '').join(' → ')}
+Outcome: ${t.outcome.success ? 'SUCCESS' : 'FAILURE'}`;
+        })
+            .join('\n\n');
+        const existingPlaybookNames = existingPlaybooks
+            .map((p) => `- ${p.name}`)
+            .slice(0, 10)
+            .join('\n');
+        return `Analyze these successful trajectories and identify common patterns that can be extracted as reusable playbooks.
+
+## Trajectories
+${trajectorySummaries}
+
+${existingPlaybooks.length > 0 ? `## Existing Playbooks (avoid duplicates)
+${existingPlaybookNames}` : ''}
+
+## Instructions
+Identify patterns that appear across multiple trajectories and extract them as playbooks.
+Focus on generalizable approaches, not task-specific details.
+
+Respond in JSON format:
+{
+  "playbooks": [
+    {
+      "name": "kebab-case-name",
+      "situations": ["when X happens"],
+      "triggers": [],
+      "antiPatterns": [],
+      "strategy": "Description",
+      "tactics": ["technique 1"],
+      "steps": ["step 1", "step 2"],
+      "successIndicators": ["indicator"],
+      "failureIndicators": ["indicator"],
+      "complexity": "simple|moderate|complex",
+      "estimatedEffort": 5,
+      "sourceTrajectories": [1, 2]
+    }
+  ]
+}`;
+    }
+    /**
+     * Parse LLM response into extraction result
+     */
+    parseExtractionResponse(response, sourceTrajectory) {
+        const result = {
+            playbooks: [],
+            refinements: [],
+            rawResponse: response,
+        };
+        try {
+            // Extract JSON from response
+            const jsonMatch = response.match(/\{[\s\S]*\}/);
+            if (!jsonMatch) {
+                return result;
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            // Handle single playbook response
+            if (parsed.playbook && !parsed.isRefinementOf) {
+                const playbook = this.createPlaybookFromLLMData(parsed.playbook, sourceTrajectory);
+                result.playbooks.push(playbook);
+            }
+            // Handle refinement response
+            if (parsed.playbook && parsed.isRefinementOf) {
+                result.refinements.push({
+                    playbookId: parsed.isRefinementOf,
+                    refinement: {
+                        context: parsed.playbook.situations?.[0] ?? 'General refinement',
+                        addition: parsed.playbook.strategy ?? '',
+                        source: 'success',
+                        addedAt: new Date(),
+                    },
+                });
+            }
+            // Handle batch response
+            if (parsed.playbooks && Array.isArray(parsed.playbooks)) {
+                for (const pbData of parsed.playbooks) {
+                    const playbook = this.createPlaybookFromLLMData(pbData);
+                    result.playbooks.push(playbook);
+                }
+            }
+        }
+        catch (error) {
+            // JSON parsing failed, return empty result
+            console.warn('Failed to parse LLM extraction response:', error instanceof Error ? error.message : error);
+        }
+        return result;
+    }
+    /**
+     * Create a Playbook from LLM-extracted data
+     */
+    createPlaybookFromLLMData(data, sourceTrajectory) {
+        const domain = sourceTrajectory?.task.domain ?? 'general';
+        const sourceIds = sourceTrajectory ? [sourceTrajectory.id] : [];
+        return createPlaybook({
+            name: data.name ?? `llm-extracted-${Date.now()}`,
+            applicability: {
+                situations: data.situations ?? [],
+                triggers: data.triggers ?? [],
+                antiPatterns: data.antiPatterns ?? [],
+                domains: [domain],
+            },
+            guidance: {
+                strategy: data.strategy ?? '',
+                tactics: data.tactics ?? [],
+                steps: data.steps ?? [],
+            },
+            verification: {
+                successIndicators: data.successIndicators ?? [],
+                failureIndicators: data.failureIndicators ?? [],
+            },
+            evolution: {
+                version: '1.0.0',
+                createdFrom: sourceIds,
+                failures: [],
+                refinements: [],
+                successCount: 1,
+                failureCount: 0,
+            },
+            confidence: 0.6, // Start with moderate confidence for LLM-extracted
+            complexity: this.parseComplexity(data.complexity),
+            estimatedEffort: data.estimatedEffort ?? 5,
+        });
+    }
+    /**
+     * Parse complexity string
+     */
+    parseComplexity(complexity) {
+        const normalized = complexity?.toLowerCase();
+        if (normalized === 'simple')
+            return 'simple';
+        if (normalized === 'complex')
+            return 'complex';
+        return 'moderate';
+    }
+    /**
+     * Check if two playbooks are similar
+     */
+    isSimilarPlaybook(a, b) {
+        // Simple name-based check
+        if (a.name === b.name)
+            return true;
+        // Check situation overlap
+        const aSituations = new Set(a.applicability.situations);
+        const bSituations = b.applicability.situations;
+        const overlap = bSituations.filter((s) => aSituations.has(s)).length;
+        return overlap >= Math.min(aSituations.size, bSituations.length) * 0.8;
+    }
+    /**
+     * Generate a refinement for an existing playbook based on a new trajectory
+     */
+    async generateRefinement(playbook, trajectory, context) {
+        const prompt = `Given this existing playbook and a new trajectory, generate a refinement.
+
+## Existing Playbook: ${playbook.name}
+Strategy: ${playbook.guidance.strategy}
+Steps: ${playbook.guidance.steps?.join(' → ') ?? 'None'}
+
+## New Trajectory
+Task: ${trajectory.task.description}
+Steps taken: ${trajectory.steps.map((s) => s.action).join(' → ')}
+Outcome: ${trajectory.outcome.success ? 'SUCCESS' : 'FAILURE'}
+
+## Context
+${context}
+
+## Instructions
+Generate a refinement that captures what's new or different in this trajectory.
+
+Respond in JSON:
+{
+  "context": "when/where this refinement applies",
+  "addition": "what to add/change in the approach"
+}`;
+        const response = await this.provider.complete([{ role: 'user', content: prompt }], {
+            temperature: this.config.temperature,
+            maxTokens: 500,
+        });
+        try {
+            const jsonMatch = response.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                const parsed = JSON.parse(jsonMatch[0]);
+                return {
+                    context: parsed.context ?? context,
+                    addition: parsed.addition ?? '',
+                    source: trajectory.outcome.success ? 'success' : 'failure',
+                    addedAt: new Date(),
+                };
+            }
+        }
+        catch {
+            // Fall back to simple refinement
+        }
+        return {
+            context,
+            addition: `Additional approach from trajectory: ${trajectory.steps[0]?.action ?? ''}`,
+            source: trajectory.outcome.success ? 'success' : 'failure',
+            addedAt: new Date(),
+        };
+    }
+}
+/**
+ * Create an LLM-based playbook extractor
+ */
+export function createLLMExtractor(provider, config) {
+    return new LLMPlaybookExtractor(provider, config);
+}
+//# sourceMappingURL=llm-extractor.js.map

package/dist/learning/llm-extractor.js.map

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

package/dist/learning/loop-coordinator.d.ts

@@ -0,0 +1,61 @@
+/**
+ * LoopCoordinator — Coordinates instant (hot) and background (cold) learning
+ *
+ * Every trajectory flows through the InstantLoop immediately. The coordinator
+ * tracks a pending count and signals when the existing batch pipeline should
+ * run. It does NOT own the batch pipeline — Atlas does — but it provides the
+ * `shouldRunBatch()` check and accumulation count.
+ */
+import type { Trajectory } from '../types/index.js';
+import type { SqlitePersistence } from '../persistence/index.js';
+import { InstantLoop, type InstantLoopResult } from './instant-loop.js';
+/**
+ * LoopCoordinator configuration
+ */
+export interface LoopCoordinatorConfig {
+    /** Trajectories needed before recommending a batch run (default: 10) */
+    batchThreshold?: number;
+    /** Log a warning if the instant loop exceeds this budget in ms (default: 200) */
+    maxInstantLatencyMs?: number;
+}
+/**
+ * LoopCoordinator — hot + cold learning coordination
+ */
+export declare class LoopCoordinator {
+    private instantLoop;
+    private config;
+    private pendingCount;
+    private _onLatencyWarning;
+    private persistence?;
+    constructor(instantLoop: InstantLoop, config?: LoopCoordinatorConfig, persistence?: SqlitePersistence);
+    /**
+     * Called on every trajectory completion.
+     * Runs the instant loop and increments the pending batch count.
+     */
+    onTrajectoryComplete(trajectory: Trajectory): Promise<InstantLoopResult>;
+    /**
+     * Check whether the batch pipeline should run.
+     */
+    shouldRunBatch(): boolean;
+    /**
+     * Reset the pending count (called after a batch run completes).
+     */
+    resetPendingCount(): void;
+    /**
+     * Load persisted pending count. Call after persistence is initialized.
+     */
+    loadPersistedState(): void;
+    /**
+     * Get the current pending trajectory count.
+     */
+    getPendingCount(): number;
+    /**
+     * Register a callback for latency budget warnings.
+     */
+    onLatencyWarning(callback: (durationMs: number) => void): void;
+}
+/**
+ * Create a LoopCoordinator
+ */
+export declare function createLoopCoordinator(instantLoop: InstantLoop, config?: LoopCoordinatorConfig, persistence?: SqlitePersistence): LoopCoordinator;
+//# sourceMappingURL=loop-coordinator.d.ts.map

package/dist/learning/loop-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-coordinator.d.ts","sourceRoot":"","sources":["../../src/learning/loop-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,WAAW,CAAC,CAAoB;gBAGtC,WAAW,EAAE,WAAW,EACxB,MAAM,CAAC,EAAE,qBAAqB,EAC9B,WAAW,CAAC,EAAE,iBAAiB;IAkBjC;;;OAGG;IACG,oBAAoB,CACxB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,iBAAiB,CAAC;IAkB7B;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAQzB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAS1B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAG/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,MAAM,CAAC,EAAE,qBAAqB,EAC9B,WAAW,CAAC,EAAE,iBAAiB,GAC9B,eAAe,CAEjB"}

package/dist/learning/loop-coordinator.js

@@ -0,0 +1,96 @@
+/**
+ * LoopCoordinator — Coordinates instant (hot) and background (cold) learning
+ *
+ * Every trajectory flows through the InstantLoop immediately. The coordinator
+ * tracks a pending count and signals when the existing batch pipeline should
+ * run. It does NOT own the batch pipeline — Atlas does — but it provides the
+ * `shouldRunBatch()` check and accumulation count.
+ */
+/**
+ * LoopCoordinator — hot + cold learning coordination
+ */
+export class LoopCoordinator {
+    instantLoop;
+    config;
+    pendingCount = 0;
+    _onLatencyWarning = null;
+    persistence;
+    constructor(instantLoop, config, persistence) {
+        this.instantLoop = instantLoop;
+        this.config = {
+            batchThreshold: config?.batchThreshold ?? 10,
+            maxInstantLatencyMs: config?.maxInstantLatencyMs ?? 200,
+        };
+        this.persistence = persistence;
+        // Load persisted pending count
+        if (persistence?.isInitialized) {
+            const saved = persistence.getSystemState('loop_coordinator');
+            if (saved) {
+                this.pendingCount = saved.pendingCount;
+            }
+        }
+    }
+    /**
+     * Called on every trajectory completion.
+     * Runs the instant loop and increments the pending batch count.
+     */
+    async onTrajectoryComplete(trajectory) {
+        const result = await this.instantLoop.process(trajectory);
+        this.pendingCount++;
+        if (this.persistence) {
+            this.persistence.setSystemState('loop_coordinator', { pendingCount: this.pendingCount });
+        }
+        // Warn if instant loop exceeded latency budget
+        if (result.durationMs > this.config.maxInstantLatencyMs) {
+            if (this._onLatencyWarning) {
+                this._onLatencyWarning(result.durationMs);
+            }
+        }
+        return result;
+    }
+    /**
+     * Check whether the batch pipeline should run.
+     */
+    shouldRunBatch() {
+        return this.pendingCount >= this.config.batchThreshold;
+    }
+    /**
+     * Reset the pending count (called after a batch run completes).
+     */
+    resetPendingCount() {
+        this.pendingCount = 0;
+        if (this.persistence) {
+            this.persistence.setSystemState('loop_coordinator', { pendingCount: 0 });
+        }
+    }
+    /**
+     * Load persisted pending count. Call after persistence is initialized.
+     */
+    loadPersistedState() {
+        if (this.persistence?.isInitialized) {
+            const saved = this.persistence.getSystemState('loop_coordinator');
+            if (saved) {
+                this.pendingCount = saved.pendingCount;
+            }
+        }
+    }
+    /**
+     * Get the current pending trajectory count.
+     */
+    getPendingCount() {
+        return this.pendingCount;
+    }
+    /**
+     * Register a callback for latency budget warnings.
+     */
+    onLatencyWarning(callback) {
+        this._onLatencyWarning = callback;
+    }
+}
+/**
+ * Create a LoopCoordinator
+ */
+export function createLoopCoordinator(instantLoop, config, persistence) {
+    return new LoopCoordinator(instantLoop, config, persistence);
+}
+//# sourceMappingURL=loop-coordinator.js.map

package/dist/learning/loop-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-coordinator.js","sourceRoot":"","sources":["../../src/learning/loop-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,WAAW,CAAc;IACzB,MAAM,CAAkC;IACxC,YAAY,GAAG,CAAC,CAAC;IACjB,iBAAiB,GAA0C,IAAI,CAAC;IAChE,WAAW,CAAqB;IAExC,YACE,WAAwB,EACxB,MAA8B,EAC9B,WAA+B;QAE/B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG;YACZ,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,EAAE;YAC5C,mBAAmB,EAAE,MAAM,EAAE,mBAAmB,IAAI,GAAG;SACxD,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,+BAA+B;QAC/B,IAAI,WAAW,EAAE,aAAa,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,cAAc,CAA2B,kBAAkB,CAAC,CAAC;YACvF,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,oBAAoB,CACxB,UAAsB;QAEtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC3F,CAAC;QAED,+CAA+C;QAC/C,IAAI,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACxD,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC3B,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAEtB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,IAAI,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAA2B,kBAAkB,CAAC,CAAC;YAC5F,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAAsC;QACrD,IAAI,CAAC,iBAAiB,GAAG,QAAQ,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAwB,EACxB,MAA8B,EAC9B,WAA+B;IAE/B,OAAO,IAAI,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AAC/D,CAAC"}

package/dist/learning/maintenance-scheduler.d.ts

@@ -12,6 +12,7 @@
  * contention. A duty-factor model ensures maintenance doesn't starve
  * the primary learning pipeline.
  */
+import { type Clock } from '../utils/clock.js';
 /**
  * Maintenance trigger mode.
  */
@@ -22,7 +23,16 @@ export type MaintenanceMode = 'manual' | 'afterNBatches' | 'periodic';
 export interface MaintenanceSchedulerConfig {
     /** Trigger mode (default: 'afterNBatches') */
     mode: MaintenanceMode;
-    /** For 'afterNBatches' mode: batches between maintenance runs (default: 5) */
+    /**
+     * For 'afterNBatches' mode: batches between maintenance runs (default: 1 —
+     * maintenance runs after every dream/batch). Dreams are already infrequent
+     * (queue-depth/staleness gated), and every maintenance task self-gates on
+     * its own preconditions (judge/LLM availability, evidence thresholds,
+     * per-cycle caps), so a higher interval only delays the mutation/curation
+     * loop without saving meaningful work. The old default of 5 made the
+     * mutation tasks effectively unreachable (~50 solves before the first
+     * opportunity).
+     */
     batchInterval: number;
     /** For 'periodic' mode: milliseconds between runs (default: 3600000 = 1h) */
     intervalMs: number;
@@ -58,7 +68,7 @@ export interface MaintenanceCycleResult {
     /** Whether the cycle actually ran (false if deferred or not due) */
     ran: boolean;
     /** Reason the cycle was skipped, if applicable */
-    skipReason?: 'not_due' | 'batch_in_progress' | 'manual_mode' | 'queue_empty';
+    skipReason?: 'not_due' | 'batch_in_progress' | 'manual_mode' | 'queue_empty' | 'validation_disabled';
     /** Results from each task that ran */
     taskResults: MaintenanceTaskResult[];
     /** Total duration of the cycle in ms */
@@ -76,7 +86,8 @@ export declare class MaintenanceScheduler {
     private lastMaintenanceTime;
     private isBatchRunning;
     private cycleHistory;
-    constructor(config?: Partial<MaintenanceSchedulerConfig>);
+    private readonly clock;
+    constructor(config?: Partial<MaintenanceSchedulerConfig>, clock?: Clock);
     /**
      * Register a maintenance task.
      * Tasks are sorted by priority (descending) before execution.
@@ -137,5 +148,5 @@ export declare class MaintenanceScheduler {
 /**
  * Create a MaintenanceScheduler.
  */
-export declare function createMaintenanceScheduler(config?: Partial<MaintenanceSchedulerConfig>): MaintenanceScheduler;
+export declare function createMaintenanceScheduler(config?: Partial<MaintenanceSchedulerConfig>, clock?: Clock): MaintenanceScheduler;
 //# sourceMappingURL=maintenance-scheduler.d.ts.map

package/dist/learning/maintenance-scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"maintenance-scheduler.d.ts","sourceRoot":"","sources":["../../src/learning/maintenance-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,eAAe,GAAG,UAAU,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,8CAA8C;IAC9C,IAAI,EAAE,eAAe,CAAC;IACtB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,OAAO,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,GAAG,EAAE,OAAO,CAAC;IACb,kDAAkD;IAClD,UAAU,CAAC,EAAE,SAAS,GAAG,mBAAmB,GAAG,aAAa,GAAG,aAAa,CAAC;IAC7E,sCAAsC;IACtC,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,2BAA2B,CAAK;IACxC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAgC;gBAExC,MAAM,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC;IAIxD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAOzC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC;;;OAGG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAiB/B;;;;;OAKG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmDpF;;OAEG;IACH,kBAAkB,IAAI,SAAS,eAAe,EAAE;IAIhD;;OAEG;IACH,eAAe,IAAI,SAAS,sBAAsB,EAAE;IAIpD;;OAEG;IACH,8BAA8B,IAAI,MAAM;IAIxC;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,0BAA0B,CAAC;IAIjD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI;IAI/D,OAAO,CAAC,UAAU;CAYnB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAC3C,oBAAoB,CAEtB"}
+{"version":3,"file":"maintenance-scheduler.d.ts","sourceRoot":"","sources":["../../src/learning/maintenance-scheduler.ts"],"names":[],"mappings":"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"}