cognitive-core 0.1.2 → 0.2.1

package/dist/learning/healing-orchestrator.js

@@ -0,0 +1,250 @@
+/**
+ * HealingOrchestrator — Plug-in anomaly detection and repair pattern.
+ *
+ * Inspired by ruvector's HealingOrchestrator (ruvector-dag/healing/orchestrator.rs).
+ * Runs registered anomaly detectors and repair strategies in each maintenance
+ * cycle. Detectors and strategies are push-registered via add methods.
+ *
+ * The orchestrator itself has no internal timer — `runCycle()` is called
+ * explicitly by the MaintenanceScheduler or manually by the caller.
+ */
+/**
+ * HealingOrchestrator — coordinates anomaly detection and repair.
+ */
+export class HealingOrchestrator {
+    detectors = [];
+    strategies = [];
+    cycleHistory = [];
+    maxHistorySize;
+    constructor(options) {
+        this.maxHistorySize = options?.maxHistorySize ?? 20;
+    }
+    /**
+     * Register an anomaly detector.
+     */
+    addDetector(detector) {
+        // Replace existing detector with same name
+        this.detectors = this.detectors.filter(d => d.name !== detector.name);
+        this.detectors.push(detector);
+    }
+    /**
+     * Unregister an anomaly detector by name.
+     */
+    removeDetector(name) {
+        this.detectors = this.detectors.filter(d => d.name !== name);
+    }
+    /**
+     * Register a repair strategy.
+     */
+    addRepairStrategy(strategy) {
+        this.strategies = this.strategies.filter(s => s.name !== strategy.name);
+        this.strategies.push(strategy);
+    }
+    /**
+     * Unregister a repair strategy by name.
+     */
+    removeRepairStrategy(name) {
+        this.strategies = this.strategies.filter(s => s.name !== name);
+    }
+    /**
+     * Run a healing cycle.
+     *
+     * 1. Runs all registered detectors to find anomalies
+     * 2. For each anomaly, finds the first matching repair strategy
+     * 3. Executes the repair
+     */
+    async runCycle(context) {
+        const start = Date.now();
+        const anomalies = [];
+        const repairs = [];
+        // Phase 1: Detection
+        for (const detector of this.detectors) {
+            try {
+                const detected = await detector.detect(context);
+                anomalies.push(...detected);
+            }
+            catch (error) {
+                // Non-critical — log but continue
+                anomalies.push({
+                    type: 'detector-error',
+                    severity: 'low',
+                    description: `Detector '${detector.name}' failed: ${error instanceof Error ? error.message : String(error)}`,
+                    detectorName: detector.name,
+                });
+            }
+        }
+        // Sort by severity (high first)
+        const severityOrder = { high: 0, medium: 1, low: 2 };
+        anomalies.sort((a, b) => (severityOrder[a.severity] ?? 3) - (severityOrder[b.severity] ?? 3));
+        // Phase 2: Repair
+        for (const anomaly of anomalies) {
+            // Skip detector errors (not repairable)
+            if (anomaly.type === 'detector-error')
+                continue;
+            for (const strategy of this.strategies) {
+                if (!strategy.canRepair(anomaly))
+                    continue;
+                const repairStart = Date.now();
+                try {
+                    const result = await strategy.repair(anomaly, context);
+                    repairs.push(result);
+                }
+                catch (error) {
+                    repairs.push({
+                        success: false,
+                        action: `Failed: ${error instanceof Error ? error.message : String(error)}`,
+                        strategyName: strategy.name,
+                        durationMs: Date.now() - repairStart,
+                    });
+                }
+                // Only apply first matching strategy per anomaly
+                break;
+            }
+        }
+        const result = {
+            anomaliesDetected: anomalies,
+            repairs,
+            durationMs: Date.now() - start,
+            timestamp: new Date(),
+        };
+        this.cycleHistory.push(result);
+        if (this.cycleHistory.length > this.maxHistorySize) {
+            this.cycleHistory.shift();
+        }
+        return result;
+    }
+    /**
+     * Get cycle history for diagnostics.
+     */
+    getCycleHistory() {
+        return this.cycleHistory;
+    }
+    /**
+     * Get registered detectors.
+     */
+    getDetectors() {
+        return this.detectors;
+    }
+    /**
+     * Get registered repair strategies.
+     */
+    getRepairStrategies() {
+        return this.strategies;
+    }
+}
+/**
+ * Create a HealingOrchestrator.
+ */
+export function createHealingOrchestrator(options) {
+    return new HealingOrchestrator(options);
+}
+// =========================================================================
+// Built-in Detectors
+// =========================================================================
+/**
+ * Detects when playbook success rates are consistently low,
+ * suggesting playbook drift.
+ */
+export class PlaybookDriftDetector {
+    name = 'playbook-drift';
+    threshold;
+    constructor(threshold = 0.3) {
+        this.threshold = threshold;
+    }
+    async detect(context) {
+        const anomalies = [];
+        if (context.recentSuccessRate < this.threshold &&
+            context.playbookCount > 0 &&
+            context.trajectoriesProcessed >= 5) {
+            anomalies.push({
+                type: 'playbook-drift',
+                severity: 'medium',
+                description: `Recent success rate (${(context.recentSuccessRate * 100).toFixed(0)}%) is below threshold (${(this.threshold * 100).toFixed(0)}%) with ${context.playbookCount} playbooks available`,
+                detectorName: this.name,
+                data: {
+                    successRate: context.recentSuccessRate,
+                    playbookCount: context.playbookCount,
+                },
+            });
+        }
+        return anomalies;
+    }
+}
+/**
+ * Detects when the experience store is growing beyond capacity,
+ * suggesting aggressive pruning is needed.
+ */
+export class MemoryBloatDetector {
+    name = 'memory-bloat';
+    maxExperiences;
+    warningRatio;
+    constructor(maxExperiences = 1000, warningRatio = 0.9) {
+        this.maxExperiences = maxExperiences;
+        this.warningRatio = warningRatio;
+    }
+    async detect(context) {
+        const anomalies = [];
+        if (this.maxExperiences > 0 &&
+            context.experienceCount >= this.maxExperiences * this.warningRatio) {
+            const severity = context.experienceCount >= this.maxExperiences ? 'high' : 'medium';
+            anomalies.push({
+                type: 'memory-bloat',
+                severity,
+                description: `Experience count (${context.experienceCount}) is ${severity === 'high' ? 'at' : 'approaching'} capacity (${this.maxExperiences})`,
+                detectorName: this.name,
+                data: {
+                    experienceCount: context.experienceCount,
+                    maxExperiences: this.maxExperiences,
+                },
+            });
+        }
+        return anomalies;
+    }
+}
+/**
+ * Detects when a custom metric exceeds a Z-score threshold,
+ * inspired by ruvector's Z-score-based outlier detection.
+ */
+export class MetricDriftDetector {
+    name;
+    metricKey;
+    history = [];
+    windowSize;
+    zThreshold;
+    constructor(metricKey, options) {
+        this.name = `metric-drift:${metricKey}`;
+        this.metricKey = metricKey;
+        this.windowSize = options?.windowSize ?? 20;
+        this.zThreshold = options?.zThreshold ?? 2.0;
+    }
+    async detect(context) {
+        const value = context.metrics[this.metricKey];
+        if (value === undefined)
+            return [];
+        this.history.push(value);
+        if (this.history.length > this.windowSize) {
+            this.history.shift();
+        }
+        if (this.history.length < 3)
+            return [];
+        const mean = this.history.reduce((s, v) => s + v, 0) / this.history.length;
+        const variance = this.history.reduce((s, v) => s + (v - mean) ** 2, 0) / this.history.length;
+        const std = Math.sqrt(variance);
+        if (std === 0)
+            return [];
+        const zScore = Math.abs(value - mean) / std;
+        if (zScore >= this.zThreshold) {
+            return [
+                {
+                    type: 'metric-drift',
+                    severity: zScore >= this.zThreshold * 1.5 ? 'high' : 'medium',
+                    description: `Metric '${this.metricKey}' value ${value.toFixed(2)} has z-score ${zScore.toFixed(2)} (threshold: ${this.zThreshold})`,
+                    detectorName: this.name,
+                    data: { metricKey: this.metricKey, value, zScore, mean, std },
+                },
+            ];
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=healing-orchestrator.js.map

package/dist/learning/healing-orchestrator.js.map

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

package/dist/learning/index.d.ts

@@ -1,5 +1,4 @@
 export { TrajectoryAnalyzer, createAnalyzer, simpleCreditAssignment, outcomeCreditAssignment, getCreditAssignmentFn, type AnalysisResult, type ErrorPattern, type TrainingExample, type CreditAssignmentFn, type AnalyzerConfig, } from './analyzer.js';
-export { LearningPipeline, createLearningPipeline, type ProcessResult, type BatchResult, } from './pipeline.js';
 export { PlaybookExtractor, createPlaybookExtractor, type ExtractedPlaybooks, type PlaybookUpdate, type PlaybookExtractorConfig, } from './playbook-extractor.js';
 export { MetaLearner, createMetaLearner, type MetaLearnerConfig, } from './meta-learner.js';
 export { PlaybookUsageInference, createUsageInference, type PlaybookUsageResult, type UsageInferenceConfig, } from './usage-inference.js';
@@ -7,6 +6,12 @@ export { TeamTrajectoryIngester, createTeamTrajectoryIngester, type CompressionC
 export { TeamLearningPipeline, createTeamLearningPipeline, type TeamProcessResult as TeamLearningProcessResult, type TeamBatchResult, } from './team-pipeline.js';
 export { TeamMetaLearner, createTeamMetaLearner, type TeamMetaLearnerConfig, } from './team-meta-learner.js';
 export { KnowledgeExtractor, createKnowledgeExtractor, type KnowledgeExtractorConfig, type ExtractionContext, } from './knowledge-extractor.js';
-export { InMemoryTrajectorySource, FileTrajectorySource, PipelineTrajectorySource, EntireTrajectorySource, type EntireSynthesisOptions, DataclawTrajectorySource, type DataclawSourceOptions, } from './trajectory-sources/index.js';
+export { InMemoryTrajectorySource, FileTrajectorySource, PipelineTrajectorySource, SessionTrajectorySource, type SessionSynthesisOptions, DataclawTrajectorySource, type DataclawSourceOptions, } from './trajectory-sources/index.js';
+export { InstantLoop, createInstantLoop, type InstantLoopResult, type InstantLoopConfig, } from './instant-loop.js';
+export { ReflexionGenerator, createReflexionGenerator, type ReflexionGeneratorConfig, } from './reflexion-generator.js';
 export { LearningEffectivenessTracker, createEffectivenessTracker, type TaskAnnotation, type EffectivenessMetrics, type PlaybookEffectivenessEntry, } from './effectiveness.js';
+export { UnifiedLearningPipeline, createUnifiedPipeline, type UnifiedPipelineConfig, type UnifiedPipelineFeatures, type EfficacyMaintenanceConfig, type ImmediateResult, type UnifiedBatchResult, type UnifiedPipelineStats, type EnergyEvaluation, type EnergySignal, type EscalationReason, type MaintenanceCycleResult, type MaintenanceTask, type HealingCycleResult, type HealthContext, type AnomalyDetector, type RepairStrategy, } from './unified-pipeline.js';
+export { EnergyEvaluator, createEnergyEvaluator, type EnergyEvaluatorConfig, type LaneTransition, } from './energy-evaluator.js';
+export { MaintenanceScheduler, createMaintenanceScheduler, type MaintenanceSchedulerConfig, type MaintenanceMode, type MaintenanceTaskResult, } from './maintenance-scheduler.js';
+export { HealingOrchestrator, createHealingOrchestrator, PlaybookDriftDetector, MemoryBloatDetector, MetricDriftDetector, type Anomaly, type RepairResult, } from './healing-orchestrator.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/learning/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,iBAAiB,IAAI,yBAAyB,EACnD,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,wBAAwB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,GAChC,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,iBAAiB,IAAI,yBAAyB,EACnD,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,wBAAwB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,GAChC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,OAAO,EACZ,KAAK,YAAY,GAClB,MAAM,2BAA2B,CAAC"}

package/dist/learning/index.js

@@ -1,5 +1,4 @@
 export { TrajectoryAnalyzer, createAnalyzer, simpleCreditAssignment, outcomeCreditAssignment, getCreditAssignmentFn, } from './analyzer.js';
-export { LearningPipeline, createLearningPipeline, } from './pipeline.js';
 // Playbook-based learning
 export { PlaybookExtractor, createPlaybookExtractor, } from './playbook-extractor.js';
 export { MetaLearner, createMetaLearner, } from './meta-learner.js';
@@ -11,7 +10,19 @@ export { TeamMetaLearner, createTeamMetaLearner, } from './team-meta-learner.js'
 // Knowledge extraction
 export { KnowledgeExtractor, createKnowledgeExtractor, } from './knowledge-extractor.js';
 // Trajectory sources
-export { InMemoryTrajectorySource, FileTrajectorySource, PipelineTrajectorySource, EntireTrajectorySource, DataclawTrajectorySource, } from './trajectory-sources/index.js';
+export { InMemoryTrajectorySource, FileTrajectorySource, PipelineTrajectorySource, SessionTrajectorySource, DataclawTrajectorySource, } from './trajectory-sources/index.js';
+// Instant (hot-path) learning
+export { InstantLoop, createInstantLoop, } from './instant-loop.js';
+// Reflexion generation
+export { ReflexionGenerator, createReflexionGenerator, } from './reflexion-generator.js';
 // Effectiveness tracking
 export { LearningEffectivenessTracker, createEffectivenessTracker, } from './effectiveness.js';
+// Unified learning pipeline (three-speed: immediate + batch + maintenance)
+export { UnifiedLearningPipeline, createUnifiedPipeline, } from './unified-pipeline.js';
+// Energy evaluator (ruvector-inspired batch trigger)
+export { EnergyEvaluator, createEnergyEvaluator, } from './energy-evaluator.js';
+// Maintenance scheduler (circadian-style duty-gated)
+export { MaintenanceScheduler, createMaintenanceScheduler, } from './maintenance-scheduler.js';
+// Healing orchestrator (plug-in detector/repair)
+export { HealingOrchestrator, createHealingOrchestrator, PlaybookDriftDetector, MemoryBloatDetector, MetricDriftDetector, } from './healing-orchestrator.js';
 //# sourceMappingURL=index.js.map

package/dist/learning/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,GAMtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GAGvB,MAAM,eAAe,CAAC;AAEvB,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAIxB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GAGrB,MAAM,sBAAsB,CAAC;AAE9B,sBAAsB;AACtB,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAM7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAG3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,qBAAqB,GAEtB,MAAM,wBAAwB,CAAC;AAEhC,uBAAuB;AACvB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAGzB,MAAM,0BAA0B,CAAC;AAElC,qBAAqB;AACrB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EAEtB,wBAAwB,GAEzB,MAAM,+BAA+B,CAAC;AAEvC,yBAAyB;AACzB,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAI3B,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,GAMtB,MAAM,eAAe,CAAC;AAEvB,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAIxB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GAGrB,MAAM,sBAAsB,CAAC;AAE9B,sBAAsB;AACtB,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAM7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAG3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,qBAAqB,GAEtB,MAAM,wBAAwB,CAAC;AAEhC,uBAAuB;AACvB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAGzB,MAAM,0BAA0B,CAAC;AAElC,qBAAqB;AACrB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EAEvB,wBAAwB,GAEzB,MAAM,+BAA+B,CAAC;AAEvC,8BAA8B;AAC9B,OAAO,EACL,WAAW,EACX,iBAAiB,GAGlB,MAAM,mBAAmB,CAAC;AAE3B,uBAAuB;AACvB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC;AAElC,yBAAyB;AACzB,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAI3B,MAAM,oBAAoB,CAAC;AAE5B,2EAA2E;AAC3E,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GAgBtB,MAAM,uBAAuB,CAAC;AAE/B,qDAAqD;AACrD,OAAO,EACL,eAAe,EACf,qBAAqB,GAGtB,MAAM,uBAAuB,CAAC;AAE/B,qDAAqD;AACrD,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAI3B,MAAM,4BAA4B,CAAC;AAEpC,iDAAiD;AACjD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,87 @@
+/**
+ * InstantLoop — Hot-path, per-trajectory learning
+ *
+ * Runs synchronously after every trajectory completion (<200ms budget).
+ * No LLM calls. No batch thresholds. Pure in-memory updates:
+ *
+ *   1. Store experience via MemorySystem.storeTrajectory()
+ *   2. Bump matched playbooks (recordSuccess / recordFailure)
+ *   3. Extract lightweight knowledge notes (heuristic only)
+ *   4. Access scores are bumped automatically by the memory layer
+ */
+import type { Trajectory } from '../types/index.js';
+import type { MemorySystem } from '../memory/system.js';
+import { type ReflexionGeneratorConfig } from './reflexion-generator.js';
+/**
+ * Result of a single instant-loop pass
+ */
+export interface InstantLoopResult {
+    /** ID of the stored experience */
+    experienceId: string;
+    /** Playbooks whose confidence was updated */
+    matchedPlaybooks: Array<{
+        id: string;
+        confidenceDelta: number;
+    }>;
+    /** Number of knowledge notes extracted (0 if knowledge bank disabled) */
+    knowledgeNotesExtracted: number;
+    /** Number of causal edges extracted */
+    causalEdgesExtracted: number;
+    /** ID of the generated reflexion episode (if reflexion is enabled) */
+    reflexionEpisodeId?: string;
+    /** Wall-clock duration of the instant loop in ms */
+    durationMs: number;
+}
+/**
+ * InstantLoop configuration
+ */
+export interface InstantLoopConfig {
+    /** Max knowledge notes to extract per trajectory (default: 3) */
+    maxInstantKnowledgeNotes?: number;
+    /** Max playbooks to match per trajectory (default: 3) */
+    maxPlaybookMatches?: number;
+    /** Enable reflexion episode generation (default: true) */
+    enableReflexion?: boolean;
+    /** Enable causal edge extraction (default: true) */
+    enableCausalExtraction?: boolean;
+    /** Configuration for the reflexion generator */
+    reflexionConfig?: ReflexionGeneratorConfig;
+}
+/**
+ * InstantLoop — lightweight, per-trajectory learning
+ */
+export declare class InstantLoop {
+    private memory;
+    private config;
+    private reflexionGenerator;
+    constructor(memory: MemorySystem, config?: InstantLoopConfig);
+    /**
+     * Process a single trajectory immediately after completion.
+     * Target: <200ms for typical trajectories.
+     */
+    process(trajectory: Trajectory): Promise<InstantLoopResult>;
+    /**
+     * Find matching playbooks and update their confidence based on trajectory outcome.
+     * Returns both confidence deltas and the original PlaybookMatch objects for reflexion.
+     */
+    private bumpPlaybooks;
+    /**
+     * Extract lightweight knowledge from a trajectory (heuristic, no LLM).
+     *
+     * Parses error messages, tool names, and file paths from trajectory steps
+     * and stores them as KnowledgeNote observations.
+     */
+    private extractKnowledge;
+    /**
+     * Extract lightweight causal edges from a trajectory.
+     *
+     * From failed trajectories: error message → root cause (if identifiable)
+     * From successful trajectories: approach → outcome patterns
+     */
+    private extractCausalEdges;
+}
+/**
+ * Create an InstantLoop
+ */
+export declare function createInstantLoop(memory: MemorySystem, config?: InstantLoopConfig): InstantLoop;
+//# sourceMappingURL=instant-loop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instant-loop.d.ts","sourceRoot":"","sources":["../../src/learning/instant-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAsB,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,gBAAgB,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,yEAAyE;IACzE,uBAAuB,EAAE,MAAM,CAAC;IAChC,uCAAuC;IACvC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,gDAAgD;IAChD,eAAe,CAAC,EAAE,wBAAwB,CAAC;CAC5C;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAsI;IACpJ,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,iBAAiB;IAW5D;;;OAGG;IACG,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0CjE;;;OAGG;YACW,aAAa;IAsD3B;;;;;OAKG;YACW,gBAAgB;IA8E9B;;;;;OAKG;YACW,kBAAkB;CAgFjC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,iBAAiB,GACzB,WAAW,CAEb"}