cortex-engine 0.1.0

package/dist/engines/digest.js

@@ -0,0 +1,351 @@
+/**
+ * Digest engine — document ingestion pipeline for cortex.
+ *
+ * Takes raw document content (markdown with optional YAML frontmatter) and
+ * runs it through a configurable pipeline of cognitive steps. Each step is
+ * isolated in a try/catch so a single failure does not abort the pipeline.
+ *
+ * Pipeline steps:
+ *   observe  — embed and store content as observations (with prediction error gating)
+ *   reflect  — generate LLM insights connecting content to existing memories
+ *   predict  — extract forward-looking claims and store as prediction observations
+ */
+import { parse as parseYaml } from 'yaml';
+import { predictionErrorGate } from './memory.js';
+import { extractKeywords } from './keywords.js';
+/**
+ * Split YAML frontmatter from markdown body.
+ * Returns empty frontmatter and the full string if no frontmatter is found.
+ */
+function parseDocument(content) {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith('---')) {
+        return { frontmatter: {}, body: content };
+    }
+    const endMarker = trimmed.indexOf('\n---', 3);
+    if (endMarker === -1) {
+        return { frontmatter: {}, body: content };
+    }
+    const yamlBlock = trimmed.slice(3, endMarker).trim();
+    const body = trimmed.slice(endMarker + 4).trimStart();
+    let frontmatter = {};
+    try {
+        const parsed = parseYaml(yamlBlock);
+        if (parsed && typeof parsed === 'object') {
+            frontmatter = parsed;
+        }
+    }
+    catch {
+        // Malformed frontmatter — continue without it.
+    }
+    return { frontmatter, body };
+}
+// ─── Salience Detection ───────────────────────────────────────────────────────
+/**
+ * Estimate salience from document structure and metadata.
+ * Returns a value on the 1–10 scale used by observe.
+ */
+function detectSalience(frontmatter, body) {
+    // Frontmatter can override directly.
+    if (typeof frontmatter['salience'] === 'number') {
+        return Math.min(10, Math.max(1, frontmatter['salience']));
+    }
+    // Status hints.
+    const status = typeof frontmatter['status'] === 'string'
+        ? frontmatter['status'].toLowerCase()
+        : '';
+    if (status === 'active')
+        return 7;
+    if (status === 'archived')
+        return 3;
+    // Type hints.
+    const type = typeof frontmatter['type'] === 'string'
+        ? frontmatter['type'].toLowerCase()
+        : '';
+    if (type === 'mind' || type === 'journal')
+        return 7;
+    if (type === 'knowledge')
+        return 6;
+    // Fall back to content length heuristic.
+    if (body.length > 3000)
+        return 7;
+    if (body.length > 1000)
+        return 6;
+    return 5;
+}
+async function runObserveStep(body, frontmatter, store, embed, sourceFile, salience) {
+    const observation_ids = [];
+    const memories_linked = [];
+    const title = typeof frontmatter['title'] === 'string'
+        ? frontmatter['title']
+        : '';
+    if (body.length > 2000) {
+        // Long document: summarise first, then observe chunks.
+        // Summary chunk at full salience.
+        await (async () => {
+            try {
+                const summaryText = title ? `${title}\n\n${body.slice(0, 2000)}` : body.slice(0, 2000);
+                const embedding = await embed.embed(summaryText);
+                const gate = await predictionErrorGate(store, embedding);
+                const keywords = extractKeywords(summaryText);
+                const id = await store.putObservation({
+                    content: summaryText,
+                    source_file: sourceFile,
+                    source_section: 'summary',
+                    salience,
+                    processed: false,
+                    prediction_error: gate.max_similarity > 0 ? 1 - gate.max_similarity : null,
+                    created_at: new Date(),
+                    updated_at: new Date(),
+                    embedding,
+                    keywords,
+                });
+                observation_ids.push(id);
+                if (gate.decision === 'link' && gate.nearest_id) {
+                    memories_linked.push(gate.nearest_id);
+                }
+            }
+            catch {
+                // Single chunk failure — continue.
+            }
+        })();
+        // Remaining body in ~500 char chunks at reduced salience.
+        const chunkSalience = Math.max(1, salience - 2);
+        const chunks = [];
+        for (let i = 2000; i < body.length; i += 500) {
+            chunks.push(body.slice(i, i + 500));
+        }
+        for (const chunk of chunks) {
+            try {
+                const embedding = await embed.embed(chunk);
+                const gate = await predictionErrorGate(store, embedding);
+                const keywords = extractKeywords(chunk);
+                const id = await store.putObservation({
+                    content: chunk,
+                    source_file: sourceFile,
+                    source_section: 'chunk',
+                    salience: chunkSalience,
+                    processed: false,
+                    prediction_error: gate.max_similarity > 0 ? 1 - gate.max_similarity : null,
+                    created_at: new Date(),
+                    updated_at: new Date(),
+                    embedding,
+                    keywords,
+                });
+                observation_ids.push(id);
+                if (gate.decision === 'link' && gate.nearest_id) {
+                    memories_linked.push(gate.nearest_id);
+                }
+            }
+            catch {
+                // Single chunk failure — continue.
+            }
+        }
+    }
+    else {
+        // Short document: observe whole body.
+        try {
+            const observeText = title ? `${title}\n\n${body}` : body;
+            const embedding = await embed.embed(observeText);
+            const gate = await predictionErrorGate(store, embedding);
+            const keywords = extractKeywords(observeText);
+            const id = await store.putObservation({
+                content: observeText,
+                source_file: sourceFile,
+                source_section: '',
+                salience,
+                processed: false,
+                prediction_error: gate.max_similarity > 0 ? 1 - gate.max_similarity : null,
+                created_at: new Date(),
+                updated_at: new Date(),
+                embedding,
+                keywords,
+            });
+            observation_ids.push(id);
+            if (gate.decision === 'link' && gate.nearest_id) {
+                memories_linked.push(gate.nearest_id);
+            }
+        }
+        catch {
+            // Observe step failed — return empty.
+        }
+    }
+    return { observation_ids, memories_linked };
+}
+// ─── Reflect Step ─────────────────────────────────────────────────────────────
+async function runReflectStep(body, store, embed, llm, sourceFile, salience) {
+    const insights = [];
+    try {
+        // Find memories related to this content.
+        const contentEmbedding = await embed.embed(body.slice(0, 1000));
+        const related = await store.findNearest(contentEmbedding, 5);
+        const memoryContext = related
+            .map(r => `- ${r.memory.name}: ${r.memory.definition}`)
+            .join('\n');
+        const snippet = body.length > 800 ? body.slice(0, 800) + '...' : body;
+        const prompt = `You are reflecting on new document content and connecting it to existing knowledge.\n\n` +
+            `Document content:\n${snippet}\n\n` +
+            `Related memories:\n${memoryContext || '(no related memories found)'}\n\n` +
+            `Generate 2-3 concise insights that connect this content to the existing memories, ` +
+            `or identify novel patterns and implications. Each insight on its own line. ` +
+            `No preamble, no numbering — just the insights.`;
+        const reflectionText = await llm.generate(prompt, {
+            temperature: 0.6,
+            maxTokens: 400,
+        });
+        const insightLines = reflectionText
+            .split('\n')
+            .map(l => l.trim())
+            .filter(l => l.length > 20);
+        for (const insight of insightLines) {
+            try {
+                const embedding = await embed.embed(insight);
+                const keywords = extractKeywords(`digest reflect ${insight}`);
+                await store.putObservation({
+                    content: insight,
+                    source_file: sourceFile,
+                    source_section: 'digest:reflect',
+                    salience: Math.max(1, salience - 1),
+                    processed: false,
+                    prediction_error: null,
+                    created_at: new Date(),
+                    updated_at: new Date(),
+                    embedding,
+                    keywords,
+                });
+                insights.push(insight);
+            }
+            catch {
+                // One insight failing to store should not stop the rest.
+            }
+        }
+    }
+    catch {
+        // Reflect step failed — return whatever insights accumulated.
+    }
+    return insights;
+}
+// ─── Predict Step ─────────────────────────────────────────────────────────────
+async function runPredictStep(body, store, embed, llm, sourceFile, salience) {
+    const extractedPredictions = [];
+    try {
+        const snippet = body.length > 1000 ? body.slice(0, 1000) + '...' : body;
+        const prompt = `Extract forward-looking claims or predictions from this text. ` +
+            `Only include explicit predictions, goals, plans, or hypotheses about future events. ` +
+            `If there are no forward-looking claims, respond with: NO_PREDICTIONS\n\n` +
+            `Text:\n${snippet}\n\n` +
+            `List each prediction on its own line. No preamble, no numbering.`;
+        const result = await llm.generate(prompt, {
+            temperature: 0.1,
+            maxTokens: 300,
+        });
+        const trimmed = result.trim();
+        if (trimmed === 'NO_PREDICTIONS' || !trimmed) {
+            return extractedPredictions;
+        }
+        const predictions = trimmed
+            .split('\n')
+            .map(l => l.trim())
+            .filter(l => l.length > 15 && l !== 'NO_PREDICTIONS');
+        for (const prediction of predictions) {
+            try {
+                const embedding = await embed.embed(prediction);
+                const keywords = extractKeywords(`prediction ${prediction}`);
+                await store.putObservation({
+                    content: prediction,
+                    source_file: sourceFile,
+                    source_section: 'digest:predict',
+                    salience: Math.max(1, salience - 1),
+                    processed: false,
+                    prediction_error: null,
+                    created_at: new Date(),
+                    updated_at: new Date(),
+                    embedding,
+                    keywords,
+                });
+                extractedPredictions.push(prediction);
+            }
+            catch {
+                // One prediction failing should not stop the rest.
+            }
+        }
+    }
+    catch {
+        // Predict step failed — return whatever accumulated.
+    }
+    return extractedPredictions;
+}
+// ─── Main: digestDocument ─────────────────────────────────────────────────────
+/**
+ * Process a document through the cortex ingestion pipeline.
+ *
+ * Parses frontmatter, detects salience, then runs each requested pipeline step
+ * in sequence. Steps are isolated — a single step failure does not abort the
+ * pipeline; it is logged as skipped.
+ *
+ * Supported steps: 'observe', 'reflect', 'predict'
+ * Unknown steps are silently skipped and recorded in pipeline_executed as
+ * 'skipped:<name>'.
+ */
+export async function digestDocument(content, store, embed, llm, options) {
+    const start = Date.now();
+    const pipeline = options?.pipeline ?? ['observe', 'reflect'];
+    const sourceFile = options?.source_file ?? '';
+    const { frontmatter, body } = parseDocument(content);
+    const salience = options?.salience ?? detectSalience(frontmatter, body);
+    const observation_ids = [];
+    const memories_linked = [];
+    const insights = [];
+    const pipeline_executed = [];
+    for (const step of pipeline) {
+        switch (step) {
+            case 'observe': {
+                try {
+                    const result = await runObserveStep(body, frontmatter, store, embed, sourceFile, salience);
+                    observation_ids.push(...result.observation_ids);
+                    memories_linked.push(...result.memories_linked);
+                    pipeline_executed.push('observe');
+                }
+                catch {
+                    pipeline_executed.push('observe:failed');
+                }
+                break;
+            }
+            case 'reflect': {
+                try {
+                    const stepInsights = await runReflectStep(body, store, embed, llm, sourceFile, salience);
+                    insights.push(...stepInsights);
+                    pipeline_executed.push('reflect');
+                }
+                catch {
+                    pipeline_executed.push('reflect:failed');
+                }
+                break;
+            }
+            case 'predict': {
+                try {
+                    const predictions = await runPredictStep(body, store, embed, llm, sourceFile, salience);
+                    insights.push(...predictions);
+                    pipeline_executed.push('predict');
+                }
+                catch {
+                    pipeline_executed.push('predict:failed');
+                }
+                break;
+            }
+            default: {
+                pipeline_executed.push(`skipped:${step}`);
+                break;
+            }
+        }
+    }
+    return {
+        observation_ids,
+        memories_linked: [...new Set(memories_linked)],
+        insights,
+        pipeline_executed,
+        processed_at: new Date(),
+        duration_ms: Date.now() - start,
+    };
+}
+//# sourceMappingURL=digest.js.map

package/dist/engines/digest.js.map

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

package/dist/engines/fsrs.d.ts

@@ -0,0 +1,44 @@
+/**
+ * FSRS-6 — Free Spaced Repetition Scheduler.
+ *
+ * Pure math, zero dependencies. Extracted from idapixl-cortex/src/engines/memory.ts.
+ *
+ * FSRS-6 uses a power-law decay model to predict recall probability
+ * and schedule optimal review intervals. Each memory has:
+ * - stability: expected days until recall probability drops to 90%
+ * - difficulty: 1-10 scale of how hard the memory is to retain
+ * - state: new → learning → review → relearning lifecycle
+ *
+ * Rating scale: 1=Again, 2=Hard, 3=Good, 4=Easy
+ */
+import type { FSRSData, ScheduleResult } from '../core/types.js';
+/** Default FSRS-6 weights (w[0]..w[20]) from the open-source paper. */
+export declare const FSRS_WEIGHTS: readonly number[];
+export declare const DESIRED_RETENTION = 0.9;
+/**
+ * Probability of recall after `elapsed_days` with given `stability`.
+ * Decays from 1.0 toward 0 following a power curve.
+ */
+export declare function retrievability(stability: number, elapsed_days: number): number;
+/**
+ * Initial stability for a new card rated 1-4 on first review.
+ */
+export declare function initialStability(rating: 1 | 2 | 3 | 4): number;
+/**
+ * Schedule the next review for a memory given a rating.
+ * Returns updated FSRS fields and the next interval in days.
+ *
+ * @param fsrs - Current FSRS state of the memory
+ * @param rating - Review quality: 1=Again, 2=Hard, 3=Good, 4=Easy
+ * @param elapsed_days - Days since last review (0 for new memories)
+ */
+export declare function scheduleNext(fsrs: FSRSData, rating: 1 | 2 | 3 | 4, elapsed_days?: number): ScheduleResult;
+/**
+ * Calculate elapsed days between a date and now.
+ */
+export declare function elapsedDaysSince(date: Date | null): number;
+/**
+ * Create fresh FSRS state for a new memory.
+ */
+export declare function newFSRSState(): FSRSData;
+//# sourceMappingURL=fsrs.d.ts.map

package/dist/engines/fsrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsrs.d.ts","sourceRoot":"","sources":["../../src/engines/fsrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAa,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAI5E,uEAAuE;AACvE,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAKzC,CAAC;AAEF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAOrC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9E;AAsCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EACrB,YAAY,GAAE,MAAU,GACvB,cAAc,CA4BhB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAI1D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CASvC"}

package/dist/engines/fsrs.js

@@ -0,0 +1,122 @@
+/**
+ * FSRS-6 — Free Spaced Repetition Scheduler.
+ *
+ * Pure math, zero dependencies. Extracted from idapixl-cortex/src/engines/memory.ts.
+ *
+ * FSRS-6 uses a power-law decay model to predict recall probability
+ * and schedule optimal review intervals. Each memory has:
+ * - stability: expected days until recall probability drops to 90%
+ * - difficulty: 1-10 scale of how hard the memory is to retain
+ * - state: new → learning → review → relearning lifecycle
+ *
+ * Rating scale: 1=Again, 2=Hard, 3=Good, 4=Easy
+ */
+// ─── FSRS-6 Constants ─────────────────────────────────────────────────────────
+/** Default FSRS-6 weights (w[0]..w[20]) from the open-source paper. */
+export const FSRS_WEIGHTS = [
+    0.4072, 1.1829, 3.1262, 15.4722,
+    7.2102, 0.5316, 1.0651, 0.0589,
+    1.506, 0.14, 1.0036, 1.9395,
+    0.11, 0.2918, 0.5, 1.0, 2.0, 0.0, 0.0, 0.0, 0.0,
+];
+export const DESIRED_RETENTION = 0.9;
+const DECAY = -0.5;
+const FACTOR = Math.pow(0.9, 1 / DECAY) - 1;
+// ─── Core Functions ───────────────────────────────────────────────────────────
+/**
+ * Probability of recall after `elapsed_days` with given `stability`.
+ * Decays from 1.0 toward 0 following a power curve.
+ */
+export function retrievability(stability, elapsed_days) {
+    return Math.pow(1 + FACTOR * elapsed_days / stability, DECAY);
+}
+/**
+ * New difficulty after a review with a given rating.
+ */
+function updateDifficulty(d, rating) {
+    const delta = -FSRS_WEIGHTS[6] * (rating - 3);
+    const mean_reversion = FSRS_WEIGHTS[7] * (FSRS_WEIGHTS[4] - d);
+    return Math.min(10, Math.max(1, d + delta + mean_reversion));
+}
+/**
+ * Stability after a successful recall (short-term memory strengthening).
+ */
+function stabilityAfterRecall(d, s, r, rating) {
+    const hard_penalty = rating === 2 ? FSRS_WEIGHTS[15] : 1;
+    const easy_bonus = rating === 4 ? FSRS_WEIGHTS[16] : 1;
+    return s * (Math.exp(FSRS_WEIGHTS[8]) *
+        (11 - d) *
+        Math.pow(s, -FSRS_WEIGHTS[9]) *
+        (Math.exp((1 - r) * FSRS_WEIGHTS[10]) - 1) *
+        hard_penalty * easy_bonus) + s;
+}
+/**
+ * Stability after forgetting (relearning curve).
+ */
+function stabilityAfterForgetting(d, s, r) {
+    return FSRS_WEIGHTS[11] *
+        Math.pow(d, -FSRS_WEIGHTS[12]) *
+        (Math.pow(s + 1, FSRS_WEIGHTS[13]) - 1) *
+        Math.exp((1 - r) * FSRS_WEIGHTS[14]);
+}
+/**
+ * Initial stability for a new card rated 1-4 on first review.
+ */
+export function initialStability(rating) {
+    return Math.max(FSRS_WEIGHTS[rating - 1], 0.1);
+}
+/**
+ * Schedule the next review for a memory given a rating.
+ * Returns updated FSRS fields and the next interval in days.
+ *
+ * @param fsrs - Current FSRS state of the memory
+ * @param rating - Review quality: 1=Again, 2=Hard, 3=Good, 4=Easy
+ * @param elapsed_days - Days since last review (0 for new memories)
+ */
+export function scheduleNext(fsrs, rating, elapsed_days = 0) {
+    let stability;
+    let difficulty;
+    let state;
+    if (fsrs.state === 'new') {
+        stability = initialStability(rating);
+        difficulty = FSRS_WEIGHTS[4] - FSRS_WEIGHTS[5] * (rating - 3);
+        state = rating === 1 ? 'relearning' : 'learning';
+    }
+    else {
+        const r = retrievability(fsrs.stability, elapsed_days);
+        difficulty = updateDifficulty(fsrs.difficulty, rating);
+        if (rating === 1) {
+            stability = stabilityAfterForgetting(difficulty, fsrs.stability, r);
+            state = 'relearning';
+        }
+        else {
+            stability = stabilityAfterRecall(difficulty, fsrs.stability, r, rating);
+            state = 'review';
+        }
+    }
+    const interval_days = Math.max(1, Math.round(stability * Math.log(DESIRED_RETENTION) / Math.log(0.9)));
+    return { stability, difficulty, interval_days, state };
+}
+/**
+ * Calculate elapsed days between a date and now.
+ */
+export function elapsedDaysSince(date) {
+    if (!date)
+        return 0;
+    const ms = Date.now() - date.getTime();
+    return ms / (1000 * 60 * 60 * 24);
+}
+/**
+ * Create fresh FSRS state for a new memory.
+ */
+export function newFSRSState() {
+    return {
+        stability: FSRS_WEIGHTS[2],
+        difficulty: FSRS_WEIGHTS[4],
+        reps: 0,
+        lapses: 0,
+        state: 'new',
+        last_review: null,
+    };
+}
+//# sourceMappingURL=fsrs.js.map

package/dist/engines/fsrs.js.map

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

package/dist/engines/keywords.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Keyword extraction — no LLM, no latency, no cost.
+ *
+ * Strips stop words, extracts significant terms, deduplicates.
+ * Extracted from idapixl-cortex/src/engines/keywords.ts.
+ */
+/**
+ * Extract up to `max` meaningful keywords from text.
+ * Returns lowercase, deduplicated terms of 3+ characters.
+ */
+export declare function extractKeywords(text: string, max?: number): string[];
+//# sourceMappingURL=keywords.d.ts.map

package/dist/engines/keywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywords.d.ts","sourceRoot":"","sources":["../../src/engines/keywords.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAW,GAAG,MAAM,EAAE,CAWxE"}

package/dist/engines/keywords.js

@@ -0,0 +1,45 @@
+/**
+ * Keyword extraction — no LLM, no latency, no cost.
+ *
+ * Strips stop words, extracts significant terms, deduplicates.
+ * Extracted from idapixl-cortex/src/engines/keywords.ts.
+ */
+const STOP_WORDS = new Set([
+    'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could', 'should',
+    'may', 'might', 'shall', 'can', 'need', 'ought', 'used', 'to', 'of', 'in', 'on',
+    'at', 'by', 'for', 'with', 'about', 'against', 'between', 'into', 'through',
+    'during', 'before', 'after', 'above', 'below', 'from', 'up', 'down', 'and',
+    'but', 'or', 'nor', 'so', 'yet', 'both', 'either', 'neither', 'not', 'only',
+    'same', 'than', 'too', 'very', 'just', 'because', 'as', 'until', 'while',
+    'although', 'though', 'that', 'this', 'these', 'those', 'it', 'its', 'i', 'me',
+    'my', 'myself', 'we', 'our', 'ours', 'ourselves', 'you', 'your', 'yours', 'he',
+    'him', 'his', 'she', 'her', 'hers', 'they', 'them', 'their', 'theirs', 'what',
+    'which', 'who', 'when', 'where', 'why', 'how', 'all', 'each', 'every', 'no',
+    'more', 'most', 'other', 'some', 'such', 'then', 'its', 'also', 'been', 'if',
+    'now', 'like', 'well', 'even', 'back', 'any', 'there', 'think', 'see', 'know',
+    'get', 'one', 'two', 'three', 'new', 'good', 'first', 'last', 'long', 'great',
+    'little', 'own', 'right', 'big', 'high', 'different', 'small', 'large', 'next',
+    'early', 'young', 'old', 'public', 'private', 'real', 'best', 'free', 'much',
+    'want', 'make', 'time', 'year', 'day', 'way', 'man', 'much', 'many', 'look',
+    'come', 'still', 'here', 'take', 'give', 'use', 'find', 'tell', 'ask', 'seem',
+    'feel', 'leave', 'call', 'keep', 'let', 'begin', 'show', 'hear', 'play', 'run',
+    'move', 'live', 'believe', 'hold', 'bring', 'happen', 'write', 'provide', 'sit',
+    'stand', 'lose', 'pay', 'meet', 'include', 'continue', 'set', 'learn', 'change',
+    'lead', 'understand', 'watch', 'follow', 'stop', 'create', 'speak', 'read', 'spend',
+]);
+/**
+ * Extract up to `max` meaningful keywords from text.
+ * Returns lowercase, deduplicated terms of 3+ characters.
+ */
+export function extractKeywords(text, max = 20) {
+    return [
+        ...new Set(text
+            .toLowerCase()
+            .replace(/[^a-z0-9\s'-]/g, ' ')
+            .split(/\s+/)
+            .map(w => w.replace(/^['-]+|['-]+$/g, ''))
+            .filter(w => w.length >= 3 && !STOP_WORDS.has(w) && !/^\d+$/.test(w))),
+    ].slice(0, max);
+}
+//# sourceMappingURL=keywords.js.map

package/dist/engines/keywords.js.map

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