cognitive-core 0.0.2 → 0.1.2

package/dist/learning/meta-learner.js

@@ -0,0 +1,398 @@
+/**
+ * Meta Learner
+ * Learns about learning - analyzes trajectories to improve routing and retrieval
+ */
+import { createMetaObservation, createMetaStrategy } from '../types/index.js';
+const DEFAULT_CONFIG = {
+    minObservationsForStrategies: 10,
+    strategyGenerationInterval: 10,
+    helpfulRetrievalThreshold: 0.7,
+    tacticOverlapThreshold: 2,
+};
+/**
+ * Meta Learner
+ * Generates meta-observations and learns meta-strategies
+ */
+export class MetaLearner {
+    meta;
+    config;
+    observationCount = 0;
+    constructor(meta, config) {
+        this.meta = meta;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Generate reflection from completed trajectory
+     */
+    async generateReflection(trajectory, routing, playbooksUsed) {
+        // Analyze the trajectory
+        const wasSuccessful = trajectory.outcome.success;
+        const actualEffort = trajectory.llmCalls ?? trajectory.steps.length;
+        // Determine retrieval quality
+        const retrievalQuality = this.assessRetrievalQuality(trajectory, playbooksUsed, wasSuccessful);
+        // Determine outcome quality
+        const outcomeQuality = this.assessOutcomeQuality(trajectory, actualEffort, routing.estimatedBudget);
+        // Analyze execution path
+        const execution = this.analyzeExecution(trajectory);
+        // Generate lessons learned
+        const lessons = this.generateLessons(trajectory, routing, playbooksUsed, wasSuccessful);
+        const observation = createMetaObservation({
+            trajectoryId: trajectory.id,
+            routing: {
+                decision: routing.strategy,
+                confidence: routing.confidence,
+                reasoning: routing.reasoning,
+            },
+            memoryUsage: {
+                experiencesRetrieved: 0, // TODO: Track from memory query
+                playbooksApplied: playbooksUsed.map((p) => p.playbook.id),
+                retrievalQuality,
+            },
+            execution,
+            outcome: {
+                success: wasSuccessful,
+                quality: outcomeQuality,
+                effortActual: actualEffort,
+                effortEstimate: routing.estimatedBudget,
+            },
+            lessons,
+        });
+        // Record the observation
+        await this.meta.recordObservation(observation);
+        this.observationCount++;
+        // Periodically generate new meta-strategies
+        if (this.observationCount % this.config.strategyGenerationInterval === 0) {
+            await this.learn();
+        }
+        return observation;
+    }
+    /**
+     * Record a meta-observation from workspace-based reflection output.
+     * Bridges MetaReflectionOutput (from the meta-reflection template)
+     * into the MetaObservation storage format.
+     */
+    async recordFromReflection(reflection, trajectoryId, routing, playbookIds, actualEffort) {
+        const observation = createMetaObservation({
+            trajectoryId,
+            routing: {
+                decision: routing.strategy,
+                confidence: routing.confidence,
+                reasoning: routing.reasoning,
+            },
+            memoryUsage: {
+                experiencesRetrieved: 0,
+                playbooksApplied: playbookIds,
+                retrievalQuality: reflection.retrievalQuality,
+            },
+            execution: {
+                decompositionUsed: reflection.decompositionUsed,
+                refinementIterations: reflection.refinementIterations,
+                backtrackingOccurred: reflection.backtrackingOccurred,
+                toolsUsed: [],
+            },
+            outcome: {
+                success: reflection.outcomeQuality !== 'poor',
+                quality: reflection.outcomeQuality,
+                effortActual: actualEffort,
+                effortEstimate: routing.estimatedBudget,
+            },
+            lessons: {
+                whatWorked: reflection.whatWorked,
+                whatFailed: reflection.whatFailed,
+                suggestions: reflection.suggestions,
+            },
+        });
+        await this.meta.recordObservation(observation);
+        this.observationCount++;
+        if (this.observationCount % this.config.strategyGenerationInterval === 0) {
+            await this.learn();
+        }
+        return observation;
+    }
+    /**
+     * Analyze accumulated observations and generate meta-strategies
+     */
+    async learn() {
+        const stats = await this.meta.getStats();
+        if (stats.totalObservations < this.config.minObservationsForStrategies) {
+            return [];
+        }
+        // Generate new meta-strategies based on patterns
+        const newStrategies = await this.meta.generateMetaStrategies();
+        // Additional strategy generation based on analysis
+        const routingAnalysis = await this.meta.analyzeRoutingEffectiveness();
+        const additionalStrategies = this.generateStrategiesFromAnalysis(routingAnalysis);
+        // Add and save additional strategies
+        for (const strategy of additionalStrategies) {
+            const existing = await this.meta.getStrategy(strategy.id);
+            if (!existing) {
+                await this.meta.addStrategy(strategy);
+                newStrategies.push(strategy);
+            }
+        }
+        return newStrategies;
+    }
+    /**
+     * Apply meta-strategies to adjust routing
+     */
+    async adjustRouting(baseRouting, taskCharacteristics, memoryState) {
+        const context = {
+            taskCharacteristics,
+            memoryState,
+        };
+        const applicableStrategies = await this.meta.getRoutingAdjustments(context);
+        if (applicableStrategies.length === 0) {
+            return baseRouting;
+        }
+        // Apply adjustments
+        let adjustedConfidence = baseRouting.confidence;
+        let adjustedStrategy = baseRouting.strategy;
+        const adjustmentReasons = [];
+        for (const strategy of applicableStrategies) {
+            // Apply routing bias
+            if (strategy.adjustment.routingBias) {
+                for (const [decision, bias] of Object.entries(strategy.adjustment.routingBias)) {
+                    if (decision === baseRouting.strategy) {
+                        adjustedConfidence += bias;
+                    }
+                }
+                // Check if another strategy is strongly preferred
+                const biases = Object.entries(strategy.adjustment.routingBias);
+                for (const [decision, bias] of biases) {
+                    if (bias > 0.3 &&
+                        decision !== baseRouting.strategy &&
+                        baseRouting.confidence < 0.5) {
+                        adjustedStrategy = decision;
+                        adjustmentReasons.push(`Meta-strategy '${strategy.name}' suggests ${decision}`);
+                    }
+                }
+            }
+            // Add execution hint to reasoning
+            if (strategy.adjustment.executionHint) {
+                adjustmentReasons.push(strategy.adjustment.executionHint);
+            }
+        }
+        // Clamp confidence
+        adjustedConfidence = Math.max(0.1, Math.min(0.95, adjustedConfidence));
+        return {
+            strategy: adjustedStrategy,
+            confidence: adjustedConfidence,
+            estimatedBudget: baseRouting.estimatedBudget,
+            reasoning: adjustmentReasons.length > 0
+                ? `${baseRouting.reasoning}. Meta-adjustments: ${adjustmentReasons.join('; ')}`
+                : baseRouting.reasoning,
+        };
+    }
+    /**
+     * Assess retrieval quality based on trajectory outcome
+     */
+    assessRetrievalQuality(trajectory, playbooksUsed, wasSuccessful) {
+        if (playbooksUsed.length === 0) {
+            return 'neutral';
+        }
+        // Check if playbook guidance was followed
+        const guidanceFollowed = this.checkGuidanceFollowed(trajectory, playbooksUsed);
+        if (wasSuccessful && guidanceFollowed) {
+            return 'helpful';
+        }
+        else if (!wasSuccessful && guidanceFollowed) {
+            // Followed guidance but still failed - might be misleading
+            return 'misleading';
+        }
+        else {
+            return 'neutral';
+        }
+    }
+    /**
+     * Check if playbook guidance was followed in the trajectory
+     */
+    checkGuidanceFollowed(trajectory, playbooksUsed) {
+        for (const { playbook } of playbooksUsed) {
+            const tactics = playbook.guidance.tactics;
+            if (tactics.length === 0)
+                continue;
+            // Check if any tactics were reflected in the steps
+            let tacticsFollowed = 0;
+            for (const tactic of tactics) {
+                const tacticWords = tactic.toLowerCase().split(/\s+/);
+                for (const step of trajectory.steps) {
+                    const actionWords = step.action.toLowerCase().split(/\s+/);
+                    const overlap = tacticWords.filter((w) => actionWords.includes(w)).length;
+                    if (overlap >= this.config.tacticOverlapThreshold) {
+                        tacticsFollowed++;
+                        break;
+                    }
+                }
+            }
+            if (tacticsFollowed >= tactics.length * 0.5) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Assess outcome quality
+     */
+    assessOutcomeQuality(trajectory, actualEffort, estimatedEffort) {
+        if (!trajectory.outcome.success) {
+            return 'poor';
+        }
+        // Compare actual vs estimated effort
+        const effortRatio = actualEffort / estimatedEffort;
+        if (effortRatio <= 0.5) {
+            return 'excellent'; // Much less effort than expected
+        }
+        else if (effortRatio <= 1.0) {
+            return 'good'; // Within estimate
+        }
+        else if (effortRatio <= 2.0) {
+            return 'acceptable'; // Some overrun
+        }
+        else {
+            return 'poor'; // Significant overrun
+        }
+    }
+    /**
+     * Analyze execution path
+     */
+    analyzeExecution(trajectory) {
+        const steps = trajectory.steps;
+        const toolsUsed = new Set();
+        let backtrackingOccurred = false;
+        // Collect tools used (extract from action)
+        for (const step of steps) {
+            // Try to extract tool name from action (e.g., "tool_use: Bash" or just "Bash")
+            const toolMatch = step.action.match(/^(?:tool_use:\s*)?(\w+)/);
+            if (toolMatch) {
+                toolsUsed.add(toolMatch[1]);
+            }
+        }
+        // Check for backtracking (similar actions repeated)
+        const actionCounts = new Map();
+        for (const step of steps) {
+            const normalized = step.action.toLowerCase().slice(0, 50);
+            actionCounts.set(normalized, (actionCounts.get(normalized) ?? 0) + 1);
+        }
+        for (const count of actionCounts.values()) {
+            if (count > 2) {
+                backtrackingOccurred = true;
+                break;
+            }
+        }
+        // Check for decomposition (multiple sub-tasks)
+        const decompositionUsed = steps.some((s) => s.thought?.includes('break') ||
+            s.thought?.includes('decompose') ||
+            s.thought?.includes('step by step') ||
+            s.thought?.includes('first,')) ?? false;
+        // Estimate refinement iterations (failures followed by retries)
+        let refinementIterations = 0;
+        for (let i = 0; i < steps.length - 1; i++) {
+            if (steps[i].observation?.includes('error') ||
+                steps[i].observation?.includes('failed')) {
+                if (steps[i + 1]?.thought?.includes('try') || steps[i + 1]?.thought?.includes('fix')) {
+                    refinementIterations++;
+                }
+            }
+        }
+        return {
+            decompositionUsed,
+            refinementIterations,
+            backtrackingOccurred,
+            toolsUsed: Array.from(toolsUsed),
+        };
+    }
+    /**
+     * Generate lessons learned
+     */
+    generateLessons(trajectory, routing, playbooksUsed, wasSuccessful) {
+        const whatWorked = [];
+        const whatFailed = [];
+        const suggestions = [];
+        if (wasSuccessful) {
+            whatWorked.push(`${routing.strategy} routing led to success`);
+            if (playbooksUsed.length > 0) {
+                whatWorked.push(`Playbook guidance was applicable: ${playbooksUsed.map((p) => p.playbook.name).join(', ')}`);
+            }
+            // Check what steps seemed most effective
+            const keySteps = trajectory.steps.filter((s) => !s.observation?.includes('error') && !s.observation?.includes('failed'));
+            if (keySteps.length > 0) {
+                whatWorked.push(`Effective actions: ${keySteps
+                    .slice(0, 3)
+                    .map((s) => s.action.slice(0, 50))
+                    .join(', ')}`);
+            }
+        }
+        else {
+            whatFailed.push(`${routing.strategy} routing did not lead to success`);
+            // Check what went wrong
+            const errorSteps = trajectory.steps.filter((s) => s.observation?.includes('error') || s.observation?.includes('failed'));
+            if (errorSteps.length > 0) {
+                whatFailed.push(`Errors encountered: ${errorSteps
+                    .slice(0, 2)
+                    .map((s) => s.observation?.slice(0, 100))
+                    .join('; ')}`);
+            }
+            // Suggestions based on failure
+            if (routing.confidence > 0.7) {
+                suggestions.push('High confidence did not guarantee success - consider more exploration');
+            }
+            if (playbooksUsed.length > 0) {
+                suggestions.push('Review playbook applicability - guidance may need refinement');
+            }
+            else {
+                suggestions.push('No playbooks were applied - consider extracting patterns from similar tasks');
+            }
+        }
+        return { whatWorked, whatFailed, suggestions };
+    }
+    /**
+     * Generate strategies from routing analysis
+     */
+    generateStrategiesFromAnalysis(analysis) {
+        const strategies = [];
+        // Generate strategy based on success rates
+        for (const [decision, stats] of Object.entries(analysis.byDecision)) {
+            if (stats.total < 5)
+                continue;
+            const successRate = stats.successful / stats.total;
+            if (successRate < 0.4) {
+                // This decision often fails
+                strategies.push(createMetaStrategy({
+                    name: `avoid-${decision}-low-success`,
+                    condition: {
+                        taskCharacteristics: [],
+                        memoryState: [`${decision} suggested`],
+                    },
+                    adjustment: {
+                        routingBias: { [decision]: -0.2 },
+                        retrievalModification: 'expand search',
+                        executionHint: `Consider alternatives to ${decision}`,
+                    },
+                }));
+            }
+            else if (successRate > 0.8 && stats.total >= 10) {
+                // This decision is highly effective
+                strategies.push(createMetaStrategy({
+                    name: `prefer-${decision}-high-success`,
+                    condition: {
+                        taskCharacteristics: [],
+                        memoryState: [`${decision} applicable`],
+                    },
+                    adjustment: {
+                        routingBias: { [decision]: 0.1 },
+                        retrievalModification: '',
+                        executionHint: `${decision} has been effective`,
+                    },
+                }));
+            }
+        }
+        return strategies;
+    }
+}
+/**
+ * Create a meta learner
+ */
+export function createMetaLearner(meta, config) {
+    return new MetaLearner(meta, config);
+}
+//# sourceMappingURL=meta-learner.js.map

package/dist/learning/meta-learner.js.map

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

package/dist/learning/pipeline.d.ts

@@ -0,0 +1,89 @@
+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 { 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;
+    successRate: number;
+}
+/**
+ * Learning Pipeline
+ * Orchestrates trajectory analysis, playbook extraction, and memory updates
+ */
+export declare class LearningPipeline {
+    private analyzer;
+    private playbookExtractor;
+    private memory;
+    private config;
+    private taskRunner;
+    private accumulated;
+    private accumulatedAnalyses;
+    private lastBatchTime;
+    constructor(memory: MemorySystem, config?: Partial<LearningConfig>);
+    /**
+     * 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
+     */
+    processTrajectory(trajectory: Trajectory): 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>): 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":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAKvB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIhE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAiB;IAG/B,OAAO,CAAC,UAAU,CAAkC;IAGpD,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,mBAAmB,CAAwB;IACnD,OAAO,CAAC,aAAa,CAAqB;gBAE9B,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAoBlE;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAI9C;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAyBvE;;;;OAIG;YACW,mBAAmB;IAiBjC;;OAEG;IACH,cAAc,IAAI,OAAO;IA6BzB;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC;IA4E9C;;;OAGG;YACW,gBAAgB;IA0B9B;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;;OAGG;IACH,cAAc,IAAI,sBAAsB,EAAE;IAO1C;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAKxB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;CAMpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,gBAAgB,CAElB"}