cognitive-core 0.0.2 → 0.1.2

package/dist/learning/knowledge-extractor.js

@@ -0,0 +1,336 @@
+import { createObservation } from '../types/knowledge.js';
+import { tokenize } from '../utils/similarity.js';
+const DEFAULT_CONFIG = {
+    initialConfidence: 0.3,
+    entityMatchThreshold: 0.6,
+    configFilePatterns: [
+        'package.json',
+        'tsconfig.json',
+        'tsconfig',
+        '.eslintrc',
+        'eslint.config',
+        '.prettierrc',
+        'jest.config',
+        'vitest.config',
+        'vite.config',
+        'webpack.config',
+        'next.config',
+        'docker',
+        'Dockerfile',
+        '.env',
+        'Makefile',
+        'pyproject.toml',
+        'Cargo.toml',
+        'go.mod',
+    ],
+};
+/**
+ * KnowledgeExtractor — heuristic engine for extracting factual knowledge
+ * from agent trajectories.
+ *
+ * Runs 4 strategies:
+ * 1. Error patterns → observations (from AnalysisResult.errorPatterns)
+ * 2. Config facts → observations (detect config file reads/writes)
+ * 3. Causal chains → observations + causal links (failure→recovery)
+ * 4. Entity identification → entity updates or new observations
+ *
+ * Plus cross-reference detection for playbook links.
+ */
+export class KnowledgeExtractor {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Extract knowledge from a single trajectory and its analysis.
+     */
+    extract(trajectory, analysis, context) {
+        const observations = [];
+        const entityUpdates = [];
+        const links = [];
+        const playbookLinks = [];
+        // Strategy 1: Error patterns
+        const errorObs = this.extractErrorPatterns(trajectory, analysis);
+        observations.push(...errorObs);
+        // Strategy 2: Config facts
+        const configObs = this.extractConfigFacts(trajectory);
+        observations.push(...configObs);
+        // Strategy 3: Causal chains
+        const { observations: causalObs, links: causalLinks } = this.extractCausalChains(trajectory);
+        observations.push(...causalObs);
+        links.push(...causalLinks);
+        // Strategy 4: Entity identification
+        const entityResults = this.extractEntityKnowledge(trajectory, analysis, observations, context);
+        entityUpdates.push(...entityResults.updates);
+        // Cross-reference: playbook links
+        const pbLinks = this.extractPlaybookLinks(trajectory, observations);
+        playbookLinks.push(...pbLinks);
+        return {
+            observations,
+            entityUpdates,
+            contradictions: [], // Deferred to Phase 3
+            links,
+            playbookLinks,
+        };
+    }
+    // =========================================================================
+    // Strategy 1: Error Patterns → Observations
+    // =========================================================================
+    extractErrorPatterns(trajectory, analysis) {
+        const observations = [];
+        for (const pattern of analysis.errorPatterns) {
+            if (!pattern.suggestedFix)
+                continue;
+            // Extract tool/library name from the error signature
+            const entities = this.extractEntitiesFromText(`${pattern.signature} ${pattern.description}`);
+            observations.push(createObservation({
+                title: `${pattern.type} error: ${pattern.signature}`,
+                body: [
+                    `## Error Pattern`,
+                    '',
+                    `**Type**: ${pattern.type}`,
+                    `**Signature**: ${pattern.signature}`,
+                    `**Description**: ${pattern.description}`,
+                    `**Fix**: ${pattern.suggestedFix}`,
+                    '',
+                    `*Observed in trajectory ${trajectory.id}, domain: ${trajectory.task.domain}*`,
+                ].join('\n'),
+                domain: [trajectory.task.domain],
+                entities,
+                tags: ['error-pattern', pattern.type],
+                confidence: this.config.initialConfidence,
+                source: {
+                    origin: 'extracted',
+                    trajectories: [trajectory.id],
+                },
+            }));
+        }
+        return observations;
+    }
+    // =========================================================================
+    // Strategy 2: Config Facts
+    // =========================================================================
+    extractConfigFacts(trajectory) {
+        const observations = [];
+        const seenConfigs = new Set();
+        for (const step of trajectory.steps) {
+            const actionLower = step.action.toLowerCase();
+            const obsLower = step.observation.toLowerCase();
+            for (const pattern of this.config.configFilePatterns) {
+                const patternLower = pattern.toLowerCase();
+                if (!actionLower.includes(patternLower) &&
+                    !obsLower.includes(patternLower)) {
+                    continue;
+                }
+                // Avoid duplicate observations for the same config file
+                if (seenConfigs.has(pattern))
+                    continue;
+                seenConfigs.add(pattern);
+                // Extract version-like strings from the observation
+                const versions = this.extractVersions(step.observation);
+                const entities = this.extractEntitiesFromText(`${step.action} ${step.observation}`);
+                const bodyParts = [
+                    `## Configuration: ${pattern}`,
+                    '',
+                    `**Action**: ${step.action.slice(0, 200)}`,
+                ];
+                if (versions.length > 0) {
+                    bodyParts.push(`**Versions detected**: ${versions.join(', ')}`);
+                }
+                bodyParts.push('', `**Observation**: ${step.observation.slice(0, 300)}`, '', `*Observed in trajectory ${trajectory.id}*`);
+                observations.push(createObservation({
+                    title: `Config: ${pattern} settings`,
+                    body: bodyParts.join('\n'),
+                    domain: [trajectory.task.domain],
+                    entities,
+                    tags: ['config', pattern.replace(/[^a-zA-Z0-9]/g, '-')],
+                    confidence: this.config.initialConfidence,
+                    source: {
+                        origin: 'extracted',
+                        trajectories: [trajectory.id],
+                    },
+                }));
+            }
+        }
+        return observations;
+    }
+    // =========================================================================
+    // Strategy 3: Causal Chains (failure → recovery)
+    // =========================================================================
+    extractCausalChains(trajectory) {
+        const observations = [];
+        const links = [];
+        for (let i = 0; i < trajectory.steps.length - 1; i++) {
+            const step = trajectory.steps[i];
+            const isFailure = this.isFailureStep(step);
+            if (!isFailure)
+                continue;
+            // Look for recovery in the next 1-3 steps
+            const recoverySteps = [];
+            for (let j = i + 1; j < Math.min(i + 4, trajectory.steps.length); j++) {
+                const nextStep = trajectory.steps[j];
+                if (!this.isFailureStep(nextStep)) {
+                    recoverySteps.push(nextStep);
+                    break;
+                }
+            }
+            if (recoverySteps.length === 0)
+                continue;
+            const recovery = recoverySteps[0];
+            const entities = this.extractEntitiesFromText(`${step.action} ${step.observation} ${recovery.action}`);
+            const failureObs = createObservation({
+                title: `Failure-recovery: ${step.action.slice(0, 50)}`,
+                body: [
+                    `## Causal Chain`,
+                    '',
+                    `**Failed action**: ${step.action.slice(0, 200)}`,
+                    `**Error**: ${step.observation.slice(0, 200)}`,
+                    `**Recovery action**: ${recovery.action.slice(0, 200)}`,
+                    `**Result**: ${recovery.observation.slice(0, 200)}`,
+                    '',
+                    `*Observed in trajectory ${trajectory.id}*`,
+                ].join('\n'),
+                domain: [trajectory.task.domain],
+                entities,
+                tags: ['causal-chain', 'failure-recovery'],
+                confidence: this.config.initialConfidence,
+                source: {
+                    origin: 'extracted',
+                    trajectories: [trajectory.id],
+                },
+                links: [
+                    {
+                        target: `recovery-${trajectory.id}-${i}`,
+                        relation: 'led-to',
+                    },
+                ],
+            });
+            observations.push(failureObs);
+            links.push({
+                from: failureObs.frontmatter.id,
+                to: `recovery-${trajectory.id}-${i}`,
+                relation: 'led-to',
+                layer: 'causal',
+            });
+        }
+        return { observations, links };
+    }
+    // =========================================================================
+    // Strategy 4: Entity Identification
+    // =========================================================================
+    extractEntityKnowledge(trajectory, _analysis, newObservations, context) {
+        const updates = [];
+        const existingEntities = new Set(context?.existingEntities ?? []);
+        if (existingEntities.size === 0)
+            return { updates };
+        // For each existing entity, check if new observations mention it
+        for (const entityName of existingEntities) {
+            const entityLower = entityName.toLowerCase();
+            const relevantObs = newObservations.filter((obs) => {
+                const text = `${obs.frontmatter.entities.join(' ')} ${obs.body}`.toLowerCase();
+                return text.includes(entityLower);
+            });
+            if (relevantObs.length === 0)
+                continue;
+            // Produce an entity update with new evidence
+            const summaries = relevantObs
+                .map((obs) => `- ${obs.body.split('\n')[0].replace(/^#+ /, '')}`)
+                .join('\n');
+            updates.push({
+                entityId: entityName.toLowerCase().replace(/[^a-z0-9]+/g, '-'),
+                section: `## Evidence from trajectory ${trajectory.id}\n\n${summaries}`,
+                trajectoryId: trajectory.id,
+            });
+        }
+        return { updates };
+    }
+    // =========================================================================
+    // Cross-Reference: Playbook Links
+    // =========================================================================
+    extractPlaybookLinks(trajectory, observations) {
+        const links = [];
+        // Check trajectory metadata for injected playbooks
+        const injectedPlaybooks = trajectory.metadata?.injectedPlaybooks;
+        if (!Array.isArray(injectedPlaybooks) || injectedPlaybooks.length === 0) {
+            return links;
+        }
+        // Link each new observation to each injected playbook
+        for (const obs of observations) {
+            for (const playbookId of injectedPlaybooks) {
+                if (typeof playbookId !== 'string')
+                    continue;
+                links.push({
+                    noteId: obs.frontmatter.id,
+                    playbookId,
+                    relation: 'supports',
+                });
+            }
+        }
+        return links;
+    }
+    // =========================================================================
+    // Helpers
+    // =========================================================================
+    isFailureStep(step) {
+        const obs = step.observation.toLowerCase();
+        return (obs.includes('error') ||
+            obs.includes('failed') ||
+            obs.includes('exception') ||
+            obs.includes('cannot') ||
+            obs.includes('unable to') ||
+            obs.includes('not found'));
+    }
+    extractEntitiesFromText(text) {
+        const entities = [];
+        const tokens = tokenize(text);
+        // Known tool/library patterns
+        const knownPatterns = [
+            /\b(node|npm|yarn|pnpm|bun)\b/i,
+            /\b(react|vue|angular|svelte|next|nuxt)\b/i,
+            /\b(express|fastify|koa|hono)\b/i,
+            /\b(prisma|drizzle|typeorm|sequelize|knex)\b/i,
+            /\b(postgres|mysql|sqlite|mongodb|redis)\b/i,
+            /\b(docker|kubernetes|k8s)\b/i,
+            /\b(typescript|javascript|python|rust|go)\b/i,
+            /\b(vitest|jest|mocha|playwright|cypress)\b/i,
+            /\b(eslint|prettier|biome)\b/i,
+            /\b(webpack|vite|esbuild|rollup|turbopack)\b/i,
+            /\b(git|github|gitlab)\b/i,
+        ];
+        for (const pattern of knownPatterns) {
+            const match = text.match(pattern);
+            if (match) {
+                const entity = match[1].toLowerCase();
+                if (!entities.includes(entity)) {
+                    entities.push(entity);
+                }
+            }
+        }
+        // Also extract npm package-like names (scoped or simple)
+        const packagePattern = /@?[a-z][a-z0-9-]*(?:\/[a-z][a-z0-9-]*)?/g;
+        const matches = text.match(packagePattern);
+        if (matches) {
+            for (const m of matches) {
+                if (m.length >= 3 && m.length <= 50 && !entities.includes(m)) {
+                    // Only include if it looks like a real package name
+                    if (tokens.includes(m) || text.includes(`"${m}"`)) {
+                        entities.push(m);
+                    }
+                }
+            }
+        }
+        return entities.slice(0, 10); // Cap at 10 entities
+    }
+    extractVersions(text) {
+        const versionPattern = /\b\d+\.\d+(?:\.\d+)?(?:-[a-zA-Z0-9.]+)?\b/g;
+        const matches = text.match(versionPattern);
+        return matches ? [...new Set(matches)] : [];
+    }
+}
+/**
+ * Create a KnowledgeExtractor with optional config overrides.
+ */
+export function createKnowledgeExtractor(config) {
+    return new KnowledgeExtractor(config);
+}
+//# sourceMappingURL=knowledge-extractor.js.map

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

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

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

@@ -0,0 +1,88 @@
+/**
+ * LLM-Based Playbook Extractor
+ *
+ * Uses language models to generate higher-quality playbooks
+ * from trajectories. Complements the pattern-based extractor
+ * with deeper semantic analysis.
+ */
+import type { Playbook, Trajectory, Refinement } from '../types/index.js';
+import type { AnalysisResult } from './analyzer.js';
+import type { LLMProvider } from '../agents/types.js';
+/**
+ * Configuration for LLM-based extraction
+ */
+export interface LLMExtractorConfig {
+    /** Temperature for LLM calls (default: 0.2 for determinism) */
+    temperature: number;
+    /** Maximum tokens for response */
+    maxTokens: number;
+    /** Whether to extract from single trajectories (vs only batches) */
+    extractFromSingle: boolean;
+    /** Minimum complexity for LLM extraction */
+    minComplexity: number;
+}
+/**
+ * Result from LLM extraction
+ */
+export interface LLMExtractionResult {
+    playbooks: Playbook[];
+    refinements: Array<{
+        playbookId: string;
+        refinement: Refinement;
+    }>;
+    /** Raw LLM response for debugging */
+    rawResponse?: string;
+}
+/**
+ * LLM-Based Playbook Extractor
+ */
+export declare class LLMPlaybookExtractor {
+    private provider;
+    private config;
+    constructor(provider: LLMProvider, config?: Partial<LLMExtractorConfig>);
+    /**
+     * Extract playbooks from trajectories using LLM
+     */
+    extract(trajectories: Trajectory[], analyses: AnalysisResult[], existingPlaybooks?: Playbook[]): Promise<LLMExtractionResult>;
+    /**
+     * Extract a playbook from a single trajectory
+     */
+    private extractFromSingleTrajectory;
+    /**
+     * Extract playbooks from a batch of trajectories
+     */
+    private extractFromBatch;
+    /**
+     * Build prompt for single trajectory extraction
+     */
+    private buildSingleExtractionPrompt;
+    /**
+     * Build prompt for batch extraction
+     */
+    private buildBatchExtractionPrompt;
+    /**
+     * Parse LLM response into extraction result
+     */
+    private parseExtractionResponse;
+    /**
+     * Create a Playbook from LLM-extracted data
+     */
+    private createPlaybookFromLLMData;
+    /**
+     * Parse complexity string
+     */
+    private parseComplexity;
+    /**
+     * Check if two playbooks are similar
+     */
+    private isSimilarPlaybook;
+    /**
+     * Generate a refinement for an existing playbook based on a new trajectory
+     */
+    generateRefinement(playbook: Playbook, trajectory: Trajectory, context: string): Promise<Refinement>;
+}
+/**
+ * Create an LLM-based playbook extractor
+ */
+export declare function createLLMExtractor(provider: LLMProvider, config?: Partial<LLMExtractorConfig>): LLMPlaybookExtractor;
+//# sourceMappingURL=llm-extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm-extractor.d.ts","sourceRoot":"","sources":["../../src/learning/llm-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;CACvB;AASD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,WAAW,EAAE,KAAK,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,UAAU,CAAC;KACxB,CAAC,CAAC;IACH,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,MAAM,CAAqB;gBAEvB,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAKvE;;OAEG;IACG,OAAO,CACX,YAAY,EAAE,UAAU,EAAE,EAC1B,QAAQ,EAAE,cAAc,EAAE,EAC1B,iBAAiB,GAAE,QAAQ,EAAO,GACjC,OAAO,CAAC,mBAAmB,CAAC;IAkE/B;;OAEG;YACW,2BAA2B;IAsBzC;;OAEG;YACW,gBAAgB;IAsB9B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAkEnC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAwDlC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA+D/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAsCjC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACG,kBAAkB,CACtB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC;CA0DvB;AAoBD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EACrB,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,oBAAoB,CAEtB"}