cognitive-core 0.1.0 → 0.2.0

package/dist/learning/instant-loop.js

@@ -0,0 +1,264 @@
+/**
+ * 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 { createObservation } from '../types/knowledge.js';
+import { ReflexionGenerator } from './reflexion-generator.js';
+/**
+ * InstantLoop — lightweight, per-trajectory learning
+ */
+export class InstantLoop {
+    memory;
+    config;
+    reflexionGenerator;
+    constructor(memory, config) {
+        this.memory = memory;
+        this.config = {
+            maxInstantKnowledgeNotes: config?.maxInstantKnowledgeNotes ?? 3,
+            maxPlaybookMatches: config?.maxPlaybookMatches ?? 3,
+            enableReflexion: config?.enableReflexion ?? true,
+            enableCausalExtraction: config?.enableCausalExtraction ?? true,
+        };
+        this.reflexionGenerator = new ReflexionGenerator(config?.reflexionConfig);
+    }
+    /**
+     * Process a single trajectory immediately after completion.
+     * Target: <200ms for typical trajectories.
+     */
+    async process(trajectory) {
+        const start = Date.now();
+        // 1. Store experience
+        const experience = await this.memory.storeTrajectory(trajectory);
+        // 2. Find matching playbooks and bump confidence
+        const matchResult = await this.bumpPlaybooks(trajectory);
+        // 3. Extract lightweight knowledge (heuristic, no LLM)
+        const knowledgeNotesExtracted = await this.extractKnowledge(trajectory);
+        // 4. Extract lightweight causal edges (if enabled)
+        const causalEdgesExtracted = this.config.enableCausalExtraction
+            ? await this.extractCausalEdges(trajectory)
+            : 0;
+        // 5. Generate and store reflexion episode
+        let reflexionEpisodeId;
+        if (this.config.enableReflexion) {
+            try {
+                const episode = await this.reflexionGenerator.generate(trajectory, matchResult.playbookMatches);
+                await this.memory.reflexion.add(episode);
+                reflexionEpisodeId = episode.id;
+            }
+            catch {
+                // Non-critical — don't fail the instant loop for reflexion errors
+            }
+        }
+        return {
+            experienceId: experience.id,
+            matchedPlaybooks: matchResult.deltas,
+            knowledgeNotesExtracted,
+            causalEdgesExtracted,
+            reflexionEpisodeId,
+            durationMs: Date.now() - start,
+        };
+    }
+    /**
+     * Find matching playbooks and update their confidence based on trajectory outcome.
+     * Returns both confidence deltas and the original PlaybookMatch objects for reflexion.
+     */
+    async bumpPlaybooks(trajectory) {
+        const deltas = [];
+        // Find playbooks matching this trajectory's task description
+        let matches;
+        try {
+            matches = await this.memory.playbooks.findMatching(trajectory.task.description, {
+                k: this.config.maxPlaybookMatches,
+                domains: trajectory.task.domain ? [trajectory.task.domain] : undefined,
+                minScore: 0.3,
+            });
+        }
+        catch {
+            return { deltas, playbookMatches: [] };
+        }
+        for (const match of matches) {
+            const before = match.playbook.confidence;
+            if (trajectory.outcome.success) {
+                await this.memory.playbooks.recordSuccess(match.playbook.id, trajectory.id, trajectory.task.domain);
+            }
+            else {
+                await this.memory.playbooks.recordFailure(match.playbook.id, trajectory.id, trajectory.task.domain ?? 'unknown', trajectory.outcome.errorInfo ?? 'Unknown failure');
+            }
+            // Read back the updated confidence
+            const updated = await this.memory.playbooks.get(match.playbook.id);
+            const after = updated?.confidence ?? before;
+            deltas.push({
+                id: match.playbook.id,
+                confidenceDelta: after - before,
+            });
+        }
+        return { deltas, playbookMatches: matches };
+    }
+    /**
+     * 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.
+     */
+    async extractKnowledge(trajectory) {
+        const kb = this.memory.knowledgeBank;
+        if (!kb)
+            return 0;
+        const notes = [];
+        // Extract error patterns from failed steps
+        if (!trajectory.outcome.success && trajectory.outcome.errorInfo) {
+            notes.push({
+                subject: `error:${trajectory.task.domain ?? 'general'}`,
+                content: `Error encountered: ${trajectory.outcome.errorInfo.slice(0, 300)}`,
+            });
+        }
+        // Extract tool usage patterns from steps
+        const toolNames = new Set();
+        const filePaths = new Set();
+        for (const step of trajectory.steps) {
+            // Extract tool names from action strings
+            const toolMatch = step.action?.match(/^(\w+(?:[A-Z]\w*)*)\s/);
+            if (toolMatch) {
+                toolNames.add(toolMatch[1]);
+            }
+            // Extract file paths from observations
+            const pathMatches = step.observation?.match(/(?:\/[\w.-]+)+(?:\.[\w]+)/g);
+            if (pathMatches) {
+                for (const p of pathMatches.slice(0, 5)) {
+                    filePaths.add(p);
+                }
+            }
+        }
+        // Create a tool-usage note if tools were used
+        if (toolNames.size > 0 && trajectory.outcome.success) {
+            notes.push({
+                subject: `tools:${trajectory.task.domain ?? 'general'}`,
+                content: `Successful approach used tools: ${[...toolNames].join(', ')}`,
+            });
+        }
+        // Create a file-paths note for context
+        if (filePaths.size > 0) {
+            notes.push({
+                subject: `files:${trajectory.task.domain ?? 'general'}`,
+                content: `Files involved: ${[...filePaths].slice(0, 10).join(', ')}`,
+            });
+        }
+        // Store up to maxInstantKnowledgeNotes
+        const domain = trajectory.task.domain ?? 'general';
+        let stored = 0;
+        for (const note of notes.slice(0, this.config.maxInstantKnowledgeNotes)) {
+            try {
+                const observation = createObservation({
+                    title: note.subject,
+                    body: note.content,
+                    domain: [domain],
+                    entities: [note.subject],
+                    confidence: trajectory.outcome.success ? 0.7 : 0.4,
+                    source: {
+                        origin: 'extracted',
+                        trajectories: [trajectory.id],
+                    },
+                });
+                await kb.addObservation(observation);
+                stored++;
+            }
+            catch {
+                // Non-critical — don't fail the instant loop for knowledge extraction errors
+            }
+        }
+        return stored;
+    }
+    /**
+     * Extract lightweight causal edges from a trajectory.
+     *
+     * From failed trajectories: error message → root cause (if identifiable)
+     * From successful trajectories: approach → outcome patterns
+     */
+    async extractCausalEdges(trajectory) {
+        const causalStore = this.memory.causal;
+        let extracted = 0;
+        const domain = trajectory.task.domain ?? 'general';
+        const now = new Date();
+        try {
+            if (!trajectory.outcome.success && trajectory.outcome.errorInfo) {
+                // Failed trajectory: extract error → root cause pattern
+                const errorInfo = trajectory.outcome.errorInfo.slice(0, 300);
+                const taskDesc = trajectory.task.description.slice(0, 200);
+                const edge = {
+                    id: `ce-fail-${trajectory.id}`,
+                    cause: `Task: ${taskDesc}`,
+                    effect: `Error: ${errorInfo}`,
+                    confidence: 0.4,
+                    domain,
+                    sourceTrajectoryIds: [trajectory.id],
+                    observedCount: 1,
+                    createdAt: now,
+                    updatedAt: now,
+                };
+                await causalStore.add(edge);
+                extracted++;
+            }
+            if (trajectory.outcome.success) {
+                // Successful trajectory: approach → outcome
+                const taskDesc = trajectory.task.description.slice(0, 200);
+                const solutionSummary = trajectory.outcome.solution !== undefined
+                    ? String(trajectory.outcome.solution).slice(0, 200)
+                    : 'Task completed successfully';
+                const edge = {
+                    id: `ce-succ-${trajectory.id}`,
+                    cause: `Approach: ${taskDesc}`,
+                    effect: `Outcome: ${solutionSummary}`,
+                    confidence: 0.7,
+                    domain,
+                    sourceTrajectoryIds: [trajectory.id],
+                    observedCount: 1,
+                    createdAt: now,
+                    updatedAt: now,
+                };
+                await causalStore.add(edge);
+                extracted++;
+                // Extract tool → outcome edges from steps with high attribution
+                for (const step of trajectory.steps) {
+                    if (step.attributionScore !== undefined &&
+                        step.attributionScore > 0.7 &&
+                        step.action) {
+                        const toolMatch = step.action.match(/^(\w+(?:[A-Z]\w*)*)\s/);
+                        if (toolMatch) {
+                            const toolEdge = {
+                                id: `ce-tool-${trajectory.id}-${toolMatch[1]}`,
+                                cause: `Used tool ${toolMatch[1]} for ${domain} task`,
+                                effect: `Contributed to successful outcome (attribution: ${step.attributionScore.toFixed(2)})`,
+                                confidence: 0.5,
+                                domain,
+                                sourceTrajectoryIds: [trajectory.id],
+                                observedCount: 1,
+                                createdAt: now,
+                                updatedAt: now,
+                            };
+                            await causalStore.add(toolEdge);
+                            extracted++;
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Non-critical — don't fail the instant loop for causal extraction errors
+        }
+        return extracted;
+    }
+}
+/**
+ * Create an InstantLoop
+ */
+export function createInstantLoop(memory, config) {
+    return new InstantLoop(memory, config);
+}
+//# sourceMappingURL=instant-loop.js.map

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

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

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

@@ -0,0 +1,56 @@
+import type { Trajectory } from '../types/trajectory.js';
+import type { AnalysisResult } from './analyzer.js';
+import type { ExtractedKnowledge } from '../types/knowledge.js';
+/**
+ * Configuration for the KnowledgeExtractor.
+ */
+export interface KnowledgeExtractorConfig {
+    /** Minimum confidence for new observations (default: 0.3) */
+    initialConfidence: number;
+    /** Similarity threshold for matching entities in text (default: 0.6) */
+    entityMatchThreshold: number;
+    /** Config file patterns to detect (default: common config files) */
+    configFilePatterns: string[];
+}
+/**
+ * Context about existing knowledge for smarter extraction.
+ */
+export interface ExtractionContext {
+    /** Known entity names from the knowledge bank */
+    existingEntities?: string[];
+    /** Known note IDs (to avoid creating duplicates) */
+    existingNoteIds?: string[];
+}
+/**
+ * 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 declare class KnowledgeExtractor {
+    private config;
+    constructor(config?: Partial<KnowledgeExtractorConfig>);
+    /**
+     * Extract knowledge from a single trajectory and its analysis.
+     */
+    extract(trajectory: Trajectory, analysis: AnalysisResult, context?: ExtractionContext): ExtractedKnowledge;
+    private extractErrorPatterns;
+    private extractConfigFacts;
+    private extractCausalChains;
+    private extractEntityKnowledge;
+    private extractPlaybookLinks;
+    private isFailureStep;
+    private extractEntitiesFromText;
+    private extractVersions;
+}
+/**
+ * Create a KnowledgeExtractor with optional config overrides.
+ */
+export declare function createKnowledgeExtractor(config?: Partial<KnowledgeExtractorConfig>): KnowledgeExtractor;
+//# sourceMappingURL=knowledge-extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-extractor.d.ts","sourceRoot":"","sources":["../../src/learning/knowledge-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EACV,kBAAkB,EAKnB,MAAM,uBAAuB,CAAC;AAI/B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AA2BD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC;IAItD;;OAEG;IACH,OAAO,CACL,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,kBAAkB;IA8CrB,OAAO,CAAC,oBAAoB;IA8C5B,OAAO,CAAC,kBAAkB;IAoE1B,OAAO,CAAC,mBAAmB;IA+E3B,OAAO,CAAC,sBAAsB;IAyC9B,OAAO,CAAC,oBAAoB;IAgC5B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,uBAAuB;IA8C/B,OAAO,CAAC,eAAe;CAKxB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACzC,kBAAkB,CAEpB"}

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