cognitive-core 0.2.5 → 0.3.1

package/dist/learning/oracle-signal.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Train-time oracle signal — the verifier's reward signal for a COMPLETED task.
+ *
+ * See docs/DESIGN-meta-learning-validation.md § "Train-time oracle signal vs
+ * solve-time firewall". The motivating principle:
+ *
+ *   - Solve/retrieval time (solver): NEVER sees the current task's expected
+ *     output. Hard leakage firewall.
+ *   - Dream/extraction time (learner), on COMPLETED tasks: the verifier's
+ *     expected output + produced-vs-expected diff ARE the reward signal and are
+ *     legitimately available (the task is already scored and closed).
+ *
+ * The signal is stashed on `Outcome.verificationDetails[ORACLE_SIGNAL_KEY]`
+ * AFTER the task is verified, so it rides the trajectory into the dream/extractor
+ * path only. It is deliberately read by NO solver/injection code — the firewall
+ * is enforced by the fact that nothing on the solve path reads
+ * `verificationDetails` (experiences project to taskInput/solutionOutput; the
+ * knowledge injector never renders it).
+ *
+ * Generalization constraint (enforced downstream, by prompts): the distilled
+ * playbook must capture the transferable, family-level CONTRACT (numeric typing,
+ * sort keys, JSON schema shape, "changed"-field semantics) — never the specific
+ * gold values. Distill the answer's SHAPE, strip the answer's CONTENT.
+ */
+/** Well-known key under `Outcome.verificationDetails` that carries the oracle. */
+export declare const ORACLE_SIGNAL_KEY: "oracle";
+/** The train-time oracle reward signal for a completed, verified task. */
+export interface OracleSignal {
+    /** Verifier score for the produced output (0..1). */
+    score?: number;
+    /** Whether the verifier passed the produced output. */
+    passed?: boolean;
+    /**
+     * The verifier's expected artifact / schema, when the harness can expose it.
+     * Often unavailable (e.g. SkillFlow deliberately withholds
+     * expected_output.json from the container), in which case `diff` carries the
+     * signal instead.
+     */
+    expected?: string;
+    /**
+     * The produced-vs-expected diff — i.e. the verifier's own output (pytest
+     * assertion output, test.sh stderr) describing HOW the produced answer
+     * differed from expected. This is the highest-signal field the extractor
+     * needs to distill the output contract.
+     */
+    diff?: string;
+    /** A bounded excerpt of what the agent actually produced. */
+    producedOutput?: string;
+}
+/**
+ * Build a `verificationDetails` object carrying the oracle signal. Callers merge
+ * this into the outcome AFTER verification (never before / never into the solver
+ * prompt). Empty/undefined fields are dropped.
+ */
+export declare function buildOracleVerificationDetails(signal: OracleSignal): Record<string, unknown>;
+/**
+ * Read the oracle signal back out of a `verificationDetails` record.
+ * Returns undefined when no oracle is present (unguided / external trajectory).
+ */
+export declare function readOracleSignal(verificationDetails: Record<string, unknown> | undefined | null): OracleSignal | undefined;
+/**
+ * Format the oracle as a compact text block for the distiller's `verifierOutput`
+ * param. Returns undefined when there is no usable signal. Length-bounded so it
+ * cannot bloat the distillation prompt.
+ */
+export declare function oracleVerifierText(signal: OracleSignal | undefined, maxLen?: number): string | undefined;
+//# sourceMappingURL=oracle-signal.d.ts.map

package/dist/learning/oracle-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-signal.d.ts","sourceRoot":"","sources":["../../src/learning/oracle-signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,EAAG,QAAiB,CAAC;AAEnD,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ5F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GAC9D,YAAY,GAAG,SAAS,CAY1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,MAAM,SAAO,GACZ,MAAM,GAAG,SAAS,CAapB"}

package/dist/learning/oracle-signal.js

@@ -0,0 +1,94 @@
+/**
+ * Train-time oracle signal — the verifier's reward signal for a COMPLETED task.
+ *
+ * See docs/DESIGN-meta-learning-validation.md § "Train-time oracle signal vs
+ * solve-time firewall". The motivating principle:
+ *
+ *   - Solve/retrieval time (solver): NEVER sees the current task's expected
+ *     output. Hard leakage firewall.
+ *   - Dream/extraction time (learner), on COMPLETED tasks: the verifier's
+ *     expected output + produced-vs-expected diff ARE the reward signal and are
+ *     legitimately available (the task is already scored and closed).
+ *
+ * The signal is stashed on `Outcome.verificationDetails[ORACLE_SIGNAL_KEY]`
+ * AFTER the task is verified, so it rides the trajectory into the dream/extractor
+ * path only. It is deliberately read by NO solver/injection code — the firewall
+ * is enforced by the fact that nothing on the solve path reads
+ * `verificationDetails` (experiences project to taskInput/solutionOutput; the
+ * knowledge injector never renders it).
+ *
+ * Generalization constraint (enforced downstream, by prompts): the distilled
+ * playbook must capture the transferable, family-level CONTRACT (numeric typing,
+ * sort keys, JSON schema shape, "changed"-field semantics) — never the specific
+ * gold values. Distill the answer's SHAPE, strip the answer's CONTENT.
+ */
+/** Well-known key under `Outcome.verificationDetails` that carries the oracle. */
+export const ORACLE_SIGNAL_KEY = 'oracle';
+/**
+ * Build a `verificationDetails` object carrying the oracle signal. Callers merge
+ * this into the outcome AFTER verification (never before / never into the solver
+ * prompt). Empty/undefined fields are dropped.
+ */
+export function buildOracleVerificationDetails(signal) {
+    const oracle = {};
+    if (typeof signal.score === 'number')
+        oracle.score = signal.score;
+    if (typeof signal.passed === 'boolean')
+        oracle.passed = signal.passed;
+    if (signal.expected)
+        oracle.expected = signal.expected;
+    if (signal.diff)
+        oracle.diff = signal.diff;
+    if (signal.producedOutput)
+        oracle.producedOutput = signal.producedOutput;
+    return { [ORACLE_SIGNAL_KEY]: oracle };
+}
+/**
+ * Read the oracle signal back out of a `verificationDetails` record.
+ * Returns undefined when no oracle is present (unguided / external trajectory).
+ */
+export function readOracleSignal(verificationDetails) {
+    if (!verificationDetails)
+        return undefined;
+    const raw = verificationDetails[ORACLE_SIGNAL_KEY];
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    const o = raw;
+    const signal = {};
+    if (typeof o.score === 'number')
+        signal.score = o.score;
+    if (typeof o.passed === 'boolean')
+        signal.passed = o.passed;
+    if (typeof o.expected === 'string')
+        signal.expected = o.expected;
+    if (typeof o.diff === 'string')
+        signal.diff = o.diff;
+    if (typeof o.producedOutput === 'string')
+        signal.producedOutput = o.producedOutput;
+    return Object.keys(signal).length > 0 ? signal : undefined;
+}
+/**
+ * Format the oracle as a compact text block for the distiller's `verifierOutput`
+ * param. Returns undefined when there is no usable signal. Length-bounded so it
+ * cannot bloat the distillation prompt.
+ */
+export function oracleVerifierText(signal, maxLen = 1200) {
+    if (!signal)
+        return undefined;
+    const parts = [];
+    if (typeof signal.score === 'number') {
+        parts.push(`score=${signal.score.toFixed(2)}${signal.passed ? ' (passed)' : ' (failed)'}`);
+    }
+    else if (typeof signal.passed === 'boolean') {
+        parts.push(signal.passed ? 'verifier: passed' : 'verifier: failed');
+    }
+    if (signal.expected)
+        parts.push(`Expected output/schema:\n${signal.expected}`);
+    if (signal.diff)
+        parts.push(`Produced-vs-expected (verifier output):\n${signal.diff}`);
+    if (parts.length === 0)
+        return undefined;
+    const text = parts.join('\n');
+    return text.length > maxLen ? text.slice(0, maxLen) : text;
+}
+//# sourceMappingURL=oracle-signal.js.map

package/dist/learning/oracle-signal.js.map

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

package/dist/learning/pipeline.d.ts

@@ -0,0 +1,116 @@
+import type { Trajectory, LearningConfig } from '../types/index.js';
+import type { TrajectoryWithAnalysis } from '../types/trajectory-source.js';
+import type { MemorySystem } from '../memory/system.js';
+import { type AnalysisResult } from './analyzer.js';
+import type { SqlitePersistence } from '../persistence/index.js';
+import type { AgenticTaskRunner } from '../workspace/runner.js';
+/**
+ * Result of processing a single trajectory
+ */
+export interface ProcessResult {
+    trajectoryId: string;
+    stored: boolean;
+    analysis: AnalysisResult;
+    abstractable: boolean;
+    playbookExtracted: boolean;
+}
+/**
+ * Result of batch learning
+ */
+export interface BatchResult {
+    trajectoriesProcessed: number;
+    playbooksExtracted: number;
+    experiencesPruned: number;
+    experiencesCompressed: {
+        promoted: number;
+        demoted: number;
+        evicted: number;
+    };
+    experiencesClustered: number;
+    successRate: number;
+}
+/**
+ * Learning Pipeline
+ * Orchestrates trajectory analysis, playbook extraction, and memory updates
+ */
+/**
+ * Feature flags for optional ruvector-inspired subsystems in the batch pipeline.
+ */
+export interface PipelineFeatureOptions {
+    /** Enable temporal compression (Hot/Warm/Cold/Evict) in batch pipeline (default: true) */
+    enableTemporalCompression?: boolean;
+    /** Enable experience clustering via ReasoningBank in batch pipeline (default: true) */
+    enableReasoningBank?: boolean;
+}
+export declare class LearningPipeline {
+    private analyzer;
+    private playbookExtractor;
+    private temporalCompressor;
+    private reasoningBank;
+    private memory;
+    private config;
+    private taskRunner;
+    private accumulated;
+    private accumulatedAnalyses;
+    private lastBatchTime;
+    constructor(memory: MemorySystem, config?: Partial<LearningConfig>, featureOptions?: PipelineFeatureOptions, persistence?: SqlitePersistence);
+    /**
+     * Load persisted state for internal components (TemporalCompressor, ReasoningBank).
+     * Call after persistence is initialized.
+     */
+    loadPersistedState(): void;
+    /**
+     * Set the agentic task runner for workspace-based analysis.
+     * When set, analysis tasks are delegated to templates (with heuristic fallback).
+     */
+    setTaskRunner(runner: AgenticTaskRunner): void;
+    /**
+     * Process a single trajectory.
+     * Set skipStore to true if the caller already stored the experience
+     * (e.g., via InstantLoop / LoopCoordinator).
+     */
+    processTrajectory(trajectory: Trajectory, options?: {
+        skipStore?: boolean;
+    }): Promise<ProcessResult>;
+    /**
+     * Run trajectory analysis via the workspace template.
+     * The template's assessComplexity() routes simple cases to heuristicFallback()
+     * (which calls the existing TrajectoryAnalyzer), so this is safe for all inputs.
+     */
+    private analyzeWithTemplate;
+    /**
+     * Check if batch learning should run
+     */
+    shouldRunBatch(): boolean;
+    /**
+     * Run batch learning on accumulated trajectories
+     */
+    runBatchLearning(): Promise<BatchResult>;
+    /**
+     * Run playbook extraction via the workspace template.
+     * Falls back to heuristic extractor on failure.
+     */
+    private extractPlaybooks;
+    /**
+     * Get accumulated trajectory count
+     */
+    getAccumulatedCount(): number;
+    /**
+     * Get accumulated trajectories with their analyses.
+     * Read-only view — does not clear the accumulator.
+     */
+    getAccumulated(): TrajectoryWithAnalysis[];
+    /**
+     * Clear accumulated trajectories
+     */
+    clearAccumulated(): void;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<LearningConfig>): void;
+}
+/**
+ * Create a learning pipeline
+ */
+export declare function createLearningPipeline(memory: MemorySystem, config?: Partial<LearningConfig>, featureOptions?: PipelineFeatureOptions, persistence?: SqlitePersistence): LearningPipeline;
+//# sourceMappingURL=pipeline.d.ts.map

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

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

package/dist/learning/pipeline.js

@@ -0,0 +1,288 @@
+import { createAnalyzer, } from './analyzer.js';
+import { createPlaybookExtractor, } from './playbook-extractor.js';
+import { TemporalCompressor } from '../memory/temporal-compressor.js';
+import { ReasoningBank } from '../memory/reasoning-bank.js';
+import { trajectoryAnalysisTemplate } from '../workspace/templates/trajectory-analysis.js';
+import { playbookExtractionTemplate } from '../workspace/templates/playbook-extraction.js';
+export class LearningPipeline {
+    analyzer;
+    playbookExtractor;
+    temporalCompressor;
+    reasoningBank;
+    memory;
+    config;
+    // Optional agentic task runner for workspace-based analysis
+    taskRunner = null;
+    // Accumulated trajectories for batch learning
+    accumulated = [];
+    accumulatedAnalyses = [];
+    lastBatchTime = null;
+    constructor(memory, config, featureOptions, persistence) {
+        this.memory = memory;
+        this.config = {
+            creditStrategy: config?.creditStrategy ?? 'simple',
+            patternExtractor: config?.patternExtractor ?? 'llm',
+            minTrajectories: config?.minTrajectories ?? 10,
+            minHoursSinceLast: config?.minHoursSinceLast,
+            minSuccessRate: config?.minSuccessRate,
+            deduplicationThreshold: config?.deduplicationThreshold ?? 0.9,
+            maxExperiences: config?.maxExperiences ?? 1000,
+        };
+        this.analyzer = createAnalyzer(this.config.creditStrategy);
+        this.temporalCompressor = (featureOptions?.enableTemporalCompression ?? true)
+            ? new TemporalCompressor(undefined, persistence)
+            : null;
+        this.reasoningBank = (featureOptions?.enableReasoningBank ?? true)
+            ? new ReasoningBank(undefined, persistence)
+            : null;
+        this.playbookExtractor = createPlaybookExtractor({
+            minTrajectories: this.config.minTrajectories,
+            mergeThreshold: this.config.deduplicationThreshold,
+            minSuccessRate: this.config.minSuccessRate ?? 0.6,
+        });
+    }
+    /**
+     * Load persisted state for internal components (TemporalCompressor, ReasoningBank).
+     * Call after persistence is initialized.
+     */
+    loadPersistedState() {
+        this.temporalCompressor?.loadPersistedState();
+        this.reasoningBank?.loadPersistedState();
+    }
+    /**
+     * Set the agentic task runner for workspace-based analysis.
+     * When set, analysis tasks are delegated to templates (with heuristic fallback).
+     */
+    setTaskRunner(runner) {
+        this.taskRunner = runner;
+    }
+    /**
+     * Process a single trajectory.
+     * Set skipStore to true if the caller already stored the experience
+     * (e.g., via InstantLoop / LoopCoordinator).
+     */
+    async processTrajectory(trajectory, options) {
+        // Store in experience memory (unless already stored by instant loop)
+        if (!options?.skipStore) {
+            await this.memory.storeTrajectory(trajectory);
+        }
+        // Analyze: workspace-based when runner available, heuristic otherwise
+        let analysis;
+        if (this.taskRunner) {
+            analysis = await this.analyzeWithTemplate(trajectory);
+        }
+        else {
+            analysis = await this.analyzer.analyze(trajectory);
+        }
+        // Accumulate for batch learning
+        this.accumulated.push(trajectory);
+        this.accumulatedAnalyses.push(analysis);
+        return {
+            trajectoryId: trajectory.id,
+            stored: true,
+            analysis,
+            abstractable: analysis.abstractable,
+            playbookExtracted: false, // Playbooks are extracted in batch
+        };
+    }
+    /**
+     * Run trajectory analysis via the workspace template.
+     * The template's assessComplexity() routes simple cases to heuristicFallback()
+     * (which calls the existing TrajectoryAnalyzer), so this is safe for all inputs.
+     */
+    async analyzeWithTemplate(trajectory) {
+        try {
+            const result = await this.taskRunner.run(trajectoryAnalysisTemplate, {
+                trajectory,
+                creditStrategy: this.config.creditStrategy,
+            });
+            return result.output;
+        }
+        catch (error) {
+            // If workspace-based analysis fails, fall back to heuristic
+            console.error('Workspace-based trajectory analysis failed, falling back to heuristic:', error instanceof Error ? error.message : error);
+            return this.analyzer.analyze(trajectory);
+        }
+    }
+    /**
+     * Check if batch learning should run
+     */
+    shouldRunBatch() {
+        // Check minimum trajectories
+        if (this.accumulated.length < this.config.minTrajectories) {
+            return false;
+        }
+        // Check time since last batch
+        if (this.config.minHoursSinceLast && this.lastBatchTime) {
+            const hoursSinceLast = (Date.now() - this.lastBatchTime.getTime()) / (1000 * 60 * 60);
+            if (hoursSinceLast < this.config.minHoursSinceLast) {
+                return false;
+            }
+        }
+        // Check success rate
+        if (this.config.minSuccessRate) {
+            const successCount = this.accumulatedAnalyses.filter((a) => a.success).length;
+            const successRate = successCount / this.accumulated.length;
+            if (successRate < this.config.minSuccessRate) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Run batch learning on accumulated trajectories
+     */
+    async runBatchLearning() {
+        if (this.accumulated.length === 0) {
+            return {
+                trajectoriesProcessed: 0,
+                playbooksExtracted: 0,
+                experiencesPruned: 0,
+                experiencesCompressed: { promoted: 0, demoted: 0, evicted: 0 },
+                experiencesClustered: 0,
+                successRate: 0,
+            };
+        }
+        // Extract playbooks: workspace-based when runner available, heuristic otherwise
+        let playbooksAdded = 0;
+        const existingPlaybooks = await this.memory.playbooks.getAll();
+        const playbookExtraction = await this.extractPlaybooks(existingPlaybooks);
+        // Add new playbooks
+        for (const playbook of playbookExtraction.new) {
+            const exists = await this.memory.playbooks.exists(playbook.name, this.config.deduplicationThreshold);
+            if (!exists) {
+                await this.memory.playbooks.add(playbook);
+                playbooksAdded++;
+            }
+        }
+        // Apply updates to existing playbooks
+        for (const update of playbookExtraction.updates) {
+            if (update.refinement) {
+                await this.memory.playbooks.addRefinement(update.id, update.refinement.context, update.refinement.addition, update.refinement.source);
+            }
+            if (update.newTrigger) {
+                const playbook = await this.memory.playbooks.get(update.id);
+                if (playbook && !playbook.applicability.triggers.includes(update.newTrigger)) {
+                    playbook.applicability.triggers.push(update.newTrigger);
+                    await this.memory.playbooks.add(playbook);
+                }
+            }
+            if (update.newAntiPattern) {
+                const playbook = await this.memory.playbooks.get(update.id);
+                if (playbook && !playbook.applicability.antiPatterns.includes(update.newAntiPattern)) {
+                    playbook.applicability.antiPatterns.push(update.newAntiPattern);
+                    await this.memory.playbooks.add(playbook);
+                }
+            }
+        }
+        // Temporal compression pass — run after extraction so full-fidelity
+        // experience data is available for playbook extraction before compression
+        let compressionEvicted = 0;
+        let compressionPromoted = 0;
+        let compressionDemoted = 0;
+        if (this.temporalCompressor) {
+            const allExperiences = await this.memory.experiences.getAll();
+            const compressionResult = await this.temporalCompressor.compress(allExperiences);
+            // Apply compression updates (tier changes, compressed data)
+            for (const [id, updates] of compressionResult.updates) {
+                await this.memory.experiences.update(id, updates);
+            }
+            // Evict experiences whose patterns should already be captured in clusters
+            for (const id of compressionResult.evicted) {
+                await this.memory.experiences.delete(id);
+            }
+            compressionEvicted = compressionResult.evicted.length;
+            compressionPromoted = compressionResult.promoted.length;
+            compressionDemoted = compressionResult.demoted.length;
+        }
+        // Re-cluster experiences in the ReasoningBank for faster retrieval.
+        // Uses post-compression experience set so clusters reflect current state.
+        const currentExperiences = await this.memory.experiences.getAll();
+        if (this.reasoningBank) {
+            this.reasoningBank.buildClusters(currentExperiences);
+        }
+        // Prune experiences if needed
+        const pruned = await this.memory.experiences.prune({
+            maxCount: this.config.maxExperiences,
+        });
+        // Calculate success rate
+        const successCount = this.accumulatedAnalyses.filter((a) => a.success).length;
+        const successRate = successCount / this.accumulated.length;
+        // Clear accumulated and update time
+        const trajectoriesProcessed = this.accumulated.length;
+        this.accumulated = [];
+        this.accumulatedAnalyses = [];
+        this.lastBatchTime = new Date();
+        return {
+            trajectoriesProcessed,
+            playbooksExtracted: playbooksAdded,
+            experiencesPruned: pruned.totalPruned + compressionEvicted,
+            experiencesCompressed: {
+                promoted: compressionPromoted,
+                demoted: compressionDemoted,
+                evicted: compressionEvicted,
+            },
+            experiencesClustered: currentExperiences.length,
+            successRate,
+        };
+    }
+    /**
+     * Run playbook extraction via the workspace template.
+     * Falls back to heuristic extractor on failure.
+     */
+    async extractPlaybooks(existingPlaybooks) {
+        if (this.taskRunner) {
+            try {
+                const result = await this.taskRunner.run(playbookExtractionTemplate, {
+                    trajectories: this.accumulated,
+                    analyses: this.accumulatedAnalyses,
+                    existingPlaybooks,
+                });
+                return result.output;
+            }
+            catch (error) {
+                console.error('Workspace-based playbook extraction failed, falling back to heuristic:', error instanceof Error ? error.message : error);
+            }
+        }
+        return this.playbookExtractor.extract(this.accumulated, this.accumulatedAnalyses, existingPlaybooks);
+    }
+    /**
+     * Get accumulated trajectory count
+     */
+    getAccumulatedCount() {
+        return this.accumulated.length;
+    }
+    /**
+     * Get accumulated trajectories with their analyses.
+     * Read-only view — does not clear the accumulator.
+     */
+    getAccumulated() {
+        return this.accumulated.map((trajectory, i) => ({
+            trajectory,
+            analysis: this.accumulatedAnalyses[i],
+        }));
+    }
+    /**
+     * Clear accumulated trajectories
+     */
+    clearAccumulated() {
+        this.accumulated = [];
+        this.accumulatedAnalyses = [];
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+        if (config.creditStrategy) {
+            this.analyzer.setStrategy(config.creditStrategy);
+        }
+    }
+}
+/**
+ * Create a learning pipeline
+ */
+export function createLearningPipeline(memory, config, featureOptions, persistence) {
+    return new LearningPipeline(memory, config, featureOptions, persistence);
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/learning/pipeline.js.map

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

package/dist/learning/playbook-extractor.d.ts

@@ -57,6 +57,14 @@ export declare class PlaybookExtractor {
      * Extract error-recovery patterns
      */
     private extractErrorPatterns;
+    /**
+     * G3: derive a conservative, general "avoid-X" anti-pattern from a
+     * classified error. Uses the error's classified type/description (not raw
+     * noise) so the anti-pattern is meaningful and stable. The signature is
+     * truncated to keep it concise. Returns undefined when there's nothing
+     * meaningful to assert, so callers never emit spurious anti-patterns.
+     */
+    private errorToAntiPattern;
     /**
      * Normalize an action for pattern matching
      */

package/dist/learning/playbook-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playbook-extractor.d.ts","sourceRoot":"","sources":["../../src/learning/playbook-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;CACxB;AAQD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAIrD;;OAEG;IACG,OAAO,CACX,YAAY,EAAE,UAAU,EAAE,EAC1B,QAAQ,EAAE,cAAc,EAAE,EAC1B,iBAAiB,GAAE,QAAQ,EAAO,GACjC,OAAO,CAAC,kBAAkB,CAAC;IAsC9B;;OAEG;YACW,iBAAiB;IAkC/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuE1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwD5B;;OAEG;IACH,OAAO,CAAC,eAAe;IA2BvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,cAAc;IA0CtB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA8CjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAiFlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA6B7D;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgBnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAoCtB;;OAEG;IACG,kBAAkB,CACtB,SAAS,EAAE,QAAQ,EACnB,gBAAgB,EAAE,UAAU,EAC5B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC;CAiBvB;AAcD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACxC,iBAAiB,CAEnB"}
+{"version":3,"file":"playbook-extractor.d.ts","sourceRoot":"","sources":["../../src/learning/playbook-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AAE5F,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAiClE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;CACxB;AAQD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAIrD;;OAEG;IACG,OAAO,CACX,YAAY,EAAE,UAAU,EAAE,EAC1B,QAAQ,EAAE,cAAc,EAAE,EAC1B,iBAAiB,GAAE,QAAQ,EAAO,GACjC,OAAO,CAAC,kBAAkB,CAAC;IA0C9B;;OAEG;YACW,iBAAiB;IAmC/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0E1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA2D5B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,eAAe;IA2BvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,cAAc;IA2CtB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAmDjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAiFlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA6B7D;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgBnC;;OAEG;IACH,OAAO,CAAC,cAAc;IA0CtB;;OAEG;IACG,kBAAkB,CACtB,SAAS,EAAE,QAAQ,EACnB,gBAAgB,EAAE,UAAU,EAC5B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC;CAkBvB;AAsCD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACxC,iBAAiB,CAEnB"}