abmind 0.0.1 → 0.1.1

package/dist/src/tier-llm-refinement.js

@@ -0,0 +1,131 @@
+/**
+ * tier-llm-refinement.ts — Optional LLM-based refinement for #348 Phase 2.
+ *
+ * Runs when COMPACTION_LLM_ENABLED=true. Takes heuristic-classified messages
+ * and refines their ABM-L rendering via an LLM. Cached per (chatId, messageId).
+ * Falls back to heuristic on any failure — never blocks, never replaces.
+ *
+ * Fires async in afterTurn() / afterResponse() — user never waits.
+ */
+import { logDebug, logWarn } from "./mem-logger.js";
+const TAG = "tier-llm-refinement";
+/**
+ * Simple LRU cache. In-memory only. Lost on restart — acceptable because
+ * next batch refills. Size cap prevents unbounded growth.
+ */
+export class LlmRefinementCache {
+    entries = new Map();
+    maxSize;
+    constructor(maxSize = 10_000) {
+        this.maxSize = maxSize;
+    }
+    get(chatId, messageId) {
+        const key = `${chatId}:${messageId}`;
+        const entry = this.entries.get(key);
+        if (!entry)
+            return null;
+        // Touch for LRU — delete + reinsert moves to end
+        this.entries.delete(key);
+        this.entries.set(key, entry);
+        return entry.refined;
+    }
+    set(chatId, messageId, refined) {
+        const key = `${chatId}:${messageId}`;
+        if (this.entries.size >= this.maxSize && !this.entries.has(key)) {
+            // Evict oldest (first in insertion order)
+            const oldestKey = this.entries.keys().next().value;
+            if (oldestKey)
+                this.entries.delete(oldestKey);
+        }
+        this.entries.set(key, { key, refined, renderedAt: Date.now() });
+    }
+    evictChatRange(chatId, startMessageId, endMessageId) {
+        let evicted = 0;
+        for (const key of [...this.entries.keys()]) {
+            if (!key.startsWith(`${chatId}:`))
+                continue;
+            const msgIdStr = key.substring(chatId.length + 1);
+            const msgId = Number(msgIdStr);
+            if (msgId >= startMessageId && msgId <= endMessageId) {
+                this.entries.delete(key);
+                evicted++;
+            }
+        }
+        return evicted;
+    }
+    size() {
+        return this.entries.size;
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+const SYSTEM_PROMPT = `You are a context-compression assistant. Render conversation turns as ABM-L v1 format.
+
+Format per turn: [ROLE|TYPE|topic|conf|M-date] <compressed body>
+- ROLE: USER or ASSISTANT
+- TYPE: F=fact, D=decision, P=preference, L=lesson, E=event, T=technical, Q=question, O=observation
+- topic: coding/personal/memory/security/relationships/finance/health/work/general
+- conf: 1-5 confidence (default 3)
+- M-date: M2026-04 style
+
+Compress aggressively: drop filler words, keep entities as @name, use pipes/arrows for relationships.
+Output ONE line per turn, in order, NO preamble, NO commentary.`;
+/**
+ * Refine a batch of messages via LLM. Returns map of messageId → refined string.
+ * On any failure, returns empty map (caller falls back to heuristic).
+ */
+export async function refineBatch(messages, llmCall) {
+    if (messages.length === 0)
+        return new Map();
+    const userPrompt = messages
+        .map((m, idx) => {
+        const role = m.role.toUpperCase();
+        const typeHint = m.type_hint ?? "?";
+        const topicHint = m.topic_hint ?? "?";
+        const emotionHint = m.emotion_hint ?? "?";
+        const date = new Date(m.timestamp).toISOString().substring(0, 7); // YYYY-MM
+        return `[TURN ${idx + 1}]\nrole=${role} type_hint=${typeHint} topic_hint=${topicHint} emotion_hint=${emotionHint} date=M${date}\ncontent: ${m.content}`;
+    })
+        .join("\n\n");
+    const maxTokens = Math.max(1000, messages.length * 80); // ~80 tokens per refined line
+    try {
+        const result = await llmCall(SYSTEM_PROMPT, userPrompt, maxTokens);
+        if (!result) {
+            logWarn(TAG, `empty LLM response for batch of ${messages.length}, falling back to heuristic`);
+            return new Map();
+        }
+        return parseBatchResponse(result, messages);
+    }
+    catch (err) {
+        logWarn(TAG, `LLM refinement batch failed: ${err instanceof Error ? err.message : String(err)}`);
+        return new Map();
+    }
+}
+/**
+ * Parse LLM output: one line per turn. Match line-by-line with input messages.
+ * On parse failure for a specific turn, that turn is omitted (caller falls back).
+ */
+function parseBatchResponse(response, messages) {
+    const lines = response
+        .split("\n")
+        .map(l => l.trim())
+        .filter(l => l.length > 0 && l.startsWith("["));
+    const result = new Map();
+    for (let i = 0; i < messages.length && i < lines.length; i++) {
+        const line = lines[i];
+        const msg = messages[i];
+        if (!line || !msg)
+            continue;
+        // Basic shape check: must start with [ and have at least one |
+        if (!line.startsWith("[") || !line.includes("|"))
+            continue;
+        // Must close the bracket header
+        if (!line.includes("]"))
+            continue;
+        result.set(msg.id, line);
+    }
+    logDebug(TAG, `LLM refinement parsed ${result.size}/${messages.length} lines`);
+    return result;
+}
+//# sourceMappingURL=tier-llm-refinement.js.map

package/dist/src/tier-llm-refinement.js.map

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

package/dist/src/timeline-builder.d.ts

@@ -0,0 +1,45 @@
+/**
+ * timeline-builder.ts — Group related memories into narrative timelines.
+ * Pure TypeScript, no LLM. Renders timelines on the fly from stored English.
+ * Reuses buildArc() for emotional trajectory.
+ */
+import { type EmotionArc } from "./emotion-arc.js";
+export interface TimelineMemory {
+    id: number;
+    content_en: string;
+    topic: string;
+    memory_type: string | null;
+    emotion_tags: string | null;
+    importance_flags: string | null;
+    confidence: number | null;
+    created_at: number;
+    emotion_context: string | null;
+}
+export interface Timeline {
+    topic: string;
+    entity: string;
+    entries: TimelineMemory[];
+    arc: EmotionArc;
+    current: TimelineMemory;
+}
+export interface RenderedTimeline {
+    topic: string;
+    entity: string;
+    rendered: string;
+    memoryIds: number[];
+}
+/** Group memories by topic + primary entity, build timelines for groups with 2+ entries. */
+export declare function buildTimelines(memories: ReadonlyArray<TimelineMemory>): Timeline[];
+/** Build cross-topic timelines: follow an entity across topic boundaries. */
+export declare function buildCrossTopicTimelines(memories: ReadonlyArray<TimelineMemory>): Timeline[];
+/** Render a cross-topic timeline. */
+export declare function renderCrossTopicTimeline(tl: Timeline): RenderedTimeline;
+/** Render a timeline to the L2 format. */
+export declare function renderTimeline(tl: Timeline): RenderedTimeline;
+/** Render all timelines for a set of memories. Returns rendered timelines + IDs of memories consumed by timelines. */
+export declare function renderTimelines(memories: ReadonlyArray<TimelineMemory>): {
+    timelines: RenderedTimeline[];
+    crossTopic: RenderedTimeline[];
+    consumedIds: Set<number>;
+};
+//# sourceMappingURL=timeline-builder.d.ts.map

package/dist/src/timeline-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-builder.d.ts","sourceRoot":"","sources":["../../src/timeline-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAeD,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,QAAQ,EAAE,CA0BlF;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,QAAQ,EAAE,CA2B5F;AAgBD,qCAAqC;AACrC,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,GAAG,gBAAgB,CAWvE;AAqBD,0CAA0C;AAC1C,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,gBAAgB,CAW7D;AAED,sHAAsH;AACtH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG;IAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAAC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAQpK"}

package/dist/src/timeline-builder.js

@@ -0,0 +1,147 @@
+/**
+ * timeline-builder.ts — Group related memories into narrative timelines.
+ * Pure TypeScript, no LLM. Renders timelines on the fly from stored English.
+ * Reuses buildArc() for emotional trajectory.
+ */
+import { buildArc } from "./emotion-arc.js";
+import { renderMemory } from "./memory-renderer.js";
+// ── Entity extraction ───────────────────────────────────────────────────────
+/** Extract the primary entity from a memory's content (first @reference or first capitalized proper noun). */
+function primaryEntity(content) {
+    const atRef = content.match(/@([\w-]+)/);
+    if (atRef)
+        return atRef[1];
+    const proper = content.match(/\b([A-Z][a-z]+(?:\s[A-Z][a-z]+)*)\b/);
+    if (proper)
+        return proper[1].toLowerCase();
+    return "_";
+}
+// ── Timeline building ───────────────────────────────────────────────────────
+/** Group memories by topic + primary entity, build timelines for groups with 2+ entries. */
+export function buildTimelines(memories) {
+    const groups = new Map();
+    for (const m of memories) {
+        const entity = primaryEntity(m.content_en);
+        const key = `${m.topic}:${entity}`;
+        const group = groups.get(key);
+        if (group)
+            group.push(m);
+        else
+            groups.set(key, [m]);
+    }
+    const timelines = [];
+    for (const [key, mems] of groups) {
+        if (mems.length < 2)
+            continue;
+        const sorted = mems.sort((a, b) => a.created_at - b.created_at);
+        const [topic, entity] = key.split(":");
+        timelines.push({
+            topic: topic,
+            entity: entity,
+            entries: sorted,
+            arc: buildArc(sorted.map(m => ({ emotion_tags: m.emotion_tags ?? "", created_at: m.created_at }))),
+            current: sorted[sorted.length - 1],
+        });
+    }
+    return timelines.sort((a, b) => b.entries.length - a.entries.length);
+}
+/** Build cross-topic timelines: follow an entity across topic boundaries. */
+export function buildCrossTopicTimelines(memories) {
+    // Group by entity only (across all topics)
+    const entityGroups = new Map();
+    for (const m of memories) {
+        const entity = primaryEntity(m.content_en);
+        if (entity === "_")
+            continue;
+        const group = entityGroups.get(entity);
+        if (group)
+            group.push(m);
+        else
+            entityGroups.set(entity, [m]);
+    }
+    const timelines = [];
+    for (const [entity, mems] of entityGroups) {
+        // Only build cross-topic if entity spans 2+ topics
+        const topics = new Set(mems.map(m => m.topic));
+        if (topics.size < 2 || mems.length < 3)
+            continue;
+        const sorted = mems.sort((a, b) => a.created_at - b.created_at);
+        timelines.push({
+            topic: [...topics].join("+"),
+            entity,
+            entries: sorted,
+            arc: buildArc(sorted.map(m => ({ emotion_tags: m.emotion_tags ?? "", created_at: m.created_at }))),
+            current: sorted[sorted.length - 1],
+        });
+    }
+    return timelines.sort((a, b) => b.entries.length - a.entries.length);
+}
+/** Render a cross-topic timeline entry with topic prefixes. */
+function renderCrossTransition(m) {
+    const date = new Date(m.created_at);
+    const month = date.toLocaleString("en", { month: "short" });
+    const abml = renderMemory({
+        content_en: m.content_en, topic: m.topic,
+        emotion_tags: m.emotion_tags ?? undefined, importance_flags: m.importance_flags ?? undefined,
+        memory_type: m.memory_type ?? undefined, confidence: m.confidence ?? undefined,
+        createdAt: m.created_at,
+    });
+    const body = abml.replace(/^\[[^\]]*\]\s*/, "").replace(/^\([^)]*\)\s*/, "").slice(0, 35).trim();
+    return `${m.topic}:${body}(${month})`;
+}
+/** Render a cross-topic timeline. */
+export function renderCrossTopicTimeline(tl) {
+    const transitions = tl.entries.map(renderCrossTransition).join("→");
+    const arcStr = tl.arc.tags.length > 0 ? tl.arc.tags.slice(0, 4).join("→") : "—";
+    const line1 = `[XTL|${tl.entity}] ${transitions}`;
+    const line2 = `  arc: ${arcStr} ${tl.arc.symbol} | topics: ${tl.topic}`;
+    return {
+        topic: tl.topic,
+        entity: tl.entity,
+        rendered: `${line1}\n${line2}`,
+        memoryIds: tl.entries.map(e => e.id),
+    };
+}
+// ── Timeline rendering ──────────────────────────────────────────────────────
+/** Render a single timeline entry as a short transition phrase. */
+function renderTransition(m) {
+    const date = new Date(m.created_at);
+    const month = date.toLocaleString("en", { month: "short" });
+    const ctx = m.emotion_context ? `,${m.emotion_context}` : "";
+    // Compress to a short phrase: take first 40 chars of compressed content body
+    const abml = renderMemory({
+        content_en: m.content_en, topic: m.topic,
+        emotion_tags: m.emotion_tags ?? undefined, importance_flags: m.importance_flags ?? undefined,
+        memory_type: m.memory_type ?? undefined, confidence: m.confidence ?? undefined,
+        createdAt: m.created_at,
+    });
+    // Extract just the body (after the prefix)
+    const body = abml.replace(/^\[[^\]]*\]\s*/, "").replace(/^\([^)]*\)\s*/, "").slice(0, 40).trim();
+    return `${body}(${month}${ctx})`;
+}
+/** Render a timeline to the L2 format. */
+export function renderTimeline(tl) {
+    const transitions = tl.entries.map(renderTransition).join("→");
+    const arcStr = tl.arc.tags.length > 0 ? tl.arc.tags.slice(0, 4).join("→") : "—";
+    const line1 = `[TL|${tl.topic}|${tl.entity}] ${transitions}`;
+    const line2 = `  arc: ${arcStr} ${tl.arc.symbol} | current: ${renderTransition(tl.current)}`;
+    return {
+        topic: tl.topic,
+        entity: tl.entity,
+        rendered: `${line1}\n${line2}`,
+        memoryIds: tl.entries.map(e => e.id),
+    };
+}
+/** Render all timelines for a set of memories. Returns rendered timelines + IDs of memories consumed by timelines. */
+export function renderTimelines(memories) {
+    const tls = buildTimelines(memories);
+    const rendered = tls.map(renderTimeline);
+    const crossTls = buildCrossTopicTimelines(memories);
+    const crossRendered = crossTls.map(renderCrossTopicTimeline);
+    const consumedIds = new Set();
+    for (const r of [...rendered, ...crossRendered])
+        for (const id of r.memoryIds)
+            consumedIds.add(id);
+    return { timelines: rendered, crossTopic: crossRendered, consumedIds };
+}
+//# sourceMappingURL=timeline-builder.js.map

package/dist/src/timeline-builder.js.map

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

package/dist/src/trigram-search.d.ts

@@ -0,0 +1,28 @@
+/**
+ * trigram-search.ts — Sf stage: three-query fuzzy search.
+ *
+ * 1. Porter FTS5 on content_en (stemmed keyword match)
+ * 2. Trigram on content_en + preserved_keyword (fuzzy/typo/substring, diacritics-stripped)
+ * 3. If results < limit: trigram on content_original (Hungarian fallback, diacritics-stripped)
+ */
+import type Database from "better-sqlite3";
+import type { RecallHit } from "./recall-engine.js";
+export type SfOptions = {
+    translated: string[];
+    original?: string;
+    userId: string;
+    limit: number;
+    maxClassification: number;
+    timeStart?: number;
+    timeEnd?: number;
+    topic?: string;
+    tier?: string;
+    emotion?: string;
+    includeExpired?: boolean;
+    resolution?: string;
+};
+export declare function trigramSearch(db: Database.Database, opts: SfOptions): {
+    hits: RecallHit[];
+    extractedIds: number[];
+};
+//# sourceMappingURL=trigram-search.d.ts.map

package/dist/src/trigram-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigram-search.d.ts","sourceRoot":"","sources":["../../src/trigram-search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA+IF,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAkDnH"}

package/dist/src/trigram-search.js

@@ -0,0 +1,192 @@
+/**
+ * trigram-search.ts — Sf stage: three-query fuzzy search.
+ *
+ * 1. Porter FTS5 on content_en (stemmed keyword match)
+ * 2. Trigram on content_en + preserved_keyword (fuzzy/typo/substring, diacritics-stripped)
+ * 3. If results < limit: trigram on content_original (Hungarian fallback, diacritics-stripped)
+ */
+import { localISO } from "./local-time.js";
+/** Strip diacritics (mirrors the SQLite function). */
+function stripDiacritics(text) {
+    return text.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
+}
+/** Generate substring queries for fuzzy matching when full word fails.
+ *  Splits word into overlapping windows of ~half length (min 4 chars). */
+function substrings(word, minLen = 4) {
+    if (word.length <= minLen + 2)
+        return [];
+    const windowLen = Math.max(Math.floor(word.length / 2), minLen);
+    const subs = [];
+    for (let i = 0; i <= word.length - windowLen; i += Math.max(1, Math.floor(windowLen / 2))) {
+        subs.push(word.slice(i, i + windowLen));
+    }
+    return subs;
+}
+/** QWERTZ↔QWERTY z/y swap variant. */
+const ZY_SWAP = { z: "y", y: "z" };
+function zyVariant(word) {
+    const swapped = [...word].map(c => ZY_SWAP[c] ?? c).join("");
+    return swapped === word ? "" : swapped;
+}
+function trigramQuery(db, table, keyword, where, params, fetchLimit, addRow, source) {
+    const stripped = stripDiacritics(keyword);
+    if (stripped.length < 3)
+        return;
+    try {
+        const rows = db.prepare(`SELECT ${MEM_COLS} FROM ${table} ft
+       JOIN extracted_memories em ON ft.rowid = em.id
+       WHERE ${table} MATCH ? AND ${where}
+       ORDER BY rank LIMIT ?`).all(`"${stripped}"`, ...params, fetchLimit);
+        for (const r of rows)
+            addRow(r, source);
+        if (rows.length > 0)
+            return;
+        // Fallback 1: z↔y swap (QWERTZ keyboard)
+        const zy = zyVariant(stripped);
+        if (zy) {
+            const zyRows = db.prepare(`SELECT ${MEM_COLS} FROM ${table} ft
+         JOIN extracted_memories em ON ft.rowid = em.id
+         WHERE ${table} MATCH ? AND ${where}
+         ORDER BY rank LIMIT ?`).all(`"${zy}"`, ...params, fetchLimit);
+            for (const r of zyRows)
+                addRow(r, source);
+            if (zyRows.length > 0)
+                return;
+        }
+        // Fallback 2: substring windows for typo tolerance
+        for (const sub of substrings(stripped)) {
+            try {
+                const subRows = db.prepare(`SELECT ${MEM_COLS} FROM ${table} ft
+           JOIN extracted_memories em ON ft.rowid = em.id
+           WHERE ${table} MATCH ? AND ${where}
+           ORDER BY rank LIMIT ?`).all(`"${sub}"`, ...params, fetchLimit);
+                for (const r of subRows)
+                    addRow(r, source);
+            }
+            catch { /* */ }
+        }
+    }
+    catch { /* trigram query error */ }
+}
+const EMOTION_GROUPS = {
+    positive: ["joy", "pride", "excitement", "relief", "gratitude", "love", "hope", "humor"],
+    negative: ["frustration", "anger", "fear", "grief", "anxiety", "exhaustion", "doubt"],
+    "high-energy": ["excitement", "anger", "determination", "surprise"],
+};
+function expandEmotionFilter(emotion) {
+    return EMOTION_GROUPS[emotion] ?? emotion.split(",").map(s => s.trim()).filter(Boolean);
+}
+function buildWhereClause(opts) {
+    const conditions = ["1=1"];
+    const params = [];
+    if (opts.maxClassification !== undefined) {
+        conditions.push("COALESCE(em.classification, 0) <= ?");
+        params.push(opts.maxClassification);
+    }
+    // Privacy: class 0-1 shared, class 2+ private to owner
+    if (opts.userId) {
+        conditions.push("(COALESCE(em.classification, 0) <= 1 OR em.user_id = ?)");
+        params.push(opts.userId);
+    }
+    if (opts.timeStart) {
+        conditions.push("em.created_at >= ?");
+        params.push(opts.timeStart);
+    }
+    if (opts.timeEnd) {
+        conditions.push("em.created_at <= ?");
+        params.push(opts.timeEnd);
+    }
+    if (opts.topic) {
+        conditions.push("em.topic = ?");
+        params.push(opts.topic);
+    }
+    if (opts.tier) {
+        conditions.push("em.tier = ?");
+        params.push(opts.tier);
+    }
+    if (!opts.includeExpired) {
+        conditions.push("em.valid_to IS NULL");
+    }
+    if (opts.emotion) {
+        const tags = expandEmotionFilter(opts.emotion);
+        conditions.push(`(${tags.map(t => { params.push(`%${t}%`); return "em.emotion_tags LIKE ?"; }).join(" OR ")})`);
+    }
+    return { where: conditions.join(" AND "), params };
+}
+function darwinismScore(row) {
+    const base = 0.95;
+    const recallBoost = Math.min(row.recall_count * 0.02, 0.2);
+    const relevanceBoost = Math.min((row.relevance_score ?? 0) * 0.01, 0.1);
+    return base + recallBoost + relevanceBoost;
+}
+function rowToHit(row, source) {
+    return {
+        id: row.id,
+        content: row.content_en ?? "",
+        date: localISO(new Date(row.created_at)),
+        source,
+        score: darwinismScore(row),
+        ...(row.source_message_ids ? { source_ids: row.source_message_ids } : {}),
+        contentOriginal: row.content_original ?? undefined,
+        memoryType: row.memory_type ?? undefined,
+        trust: row.trust ?? undefined,
+        integrity: row.integrity ?? undefined,
+        credibility: row.credibility ?? undefined,
+        classification: row.classification ?? undefined,
+    };
+}
+const MEM_COLS = `em.id, em.content_en, em.content_original, em.memory_type, em.created_at,
+  em.source_message_ids, em.trust, em.integrity, em.credibility, em.classification,
+  em.recall_count, COALESCE(em.relevance_score, 0) as relevance_score, em.preserved_keyword`;
+export function trigramSearch(db, opts) {
+    const seen = new Set();
+    const hits = [];
+    const extractedIds = [];
+    const { where, params } = buildWhereClause(opts);
+    const fetchLimit = opts.limit * 3;
+    const addRow = (row, source) => {
+        if (seen.has(row.id))
+            return;
+        seen.add(row.id);
+        extractedIds.push(row.id);
+        hits.push(rowToHit(row, source));
+    };
+    // Sf.1: Porter FTS5 on content_en (existing index)
+    const query = opts.translated.join(" ");
+    if (query.trim()) {
+        try {
+            const ftsQuery = opts.translated.map(kw => `"${kw.replace(/"/g, "")}"`).join(" OR ");
+            const rows = db.prepare(`SELECT ${MEM_COLS} FROM extracted_memories_fts ft
+         JOIN extracted_memories em ON ft.rowid = em.id
+         WHERE extracted_memories_fts MATCH ? AND ${where}
+         ORDER BY rank LIMIT ?`).all(ftsQuery, ...params, fetchLimit);
+            for (const r of rows)
+                addRow(r, "Sf:porter");
+        }
+        catch { /* FTS5 query error */ }
+    }
+    // Sf.2: Trigram on content_en + preserved_keyword (diacritics-stripped)
+    if (hits.length < opts.limit) {
+        const allKw = [...opts.translated];
+        if (opts.original)
+            allKw.push(opts.original);
+        for (const kw of allKw) {
+            if (hits.length >= opts.limit)
+                break;
+            trigramQuery(db, "content_en_trigram", kw, where, params, fetchLimit, addRow, "Sf:trigram_en");
+        }
+    }
+    // Sf.3: Trigram on content_original (Hungarian fallback, only if results < limit)
+    if (hits.length < opts.limit) {
+        const allKw = [...opts.translated];
+        if (opts.original)
+            allKw.push(opts.original);
+        for (const kw of allKw) {
+            if (hits.length >= opts.limit)
+                break;
+            trigramQuery(db, "content_original_trigram", kw, where, params, fetchLimit, addRow, "Sf:trigram_orig");
+        }
+    }
+    return { hits, extractedIds };
+}
+//# sourceMappingURL=trigram-search.js.map

package/dist/src/trigram-search.js.map

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

package/dist/src/turn-classifier.d.ts

@@ -0,0 +1,29 @@
+/**
+ * turn-classifier.ts — Heuristic classifier for conversation turns.
+ *
+ * Runs at turn write time. Derives type/topic/emotion hints for later
+ * middle-tier rendering (#348). Pure function, no LLM, no I/O.
+ *
+ * Hint values are nullable on the messages row — missing hints mean
+ * "classifier hadn't run for this turn" (historical messages, or
+ * classifier disabled). Renderer falls back to defaults.
+ */
+export interface TurnHints {
+    typeHint: string | null;
+    topicHint: string | null;
+    emotionHint: string | null;
+}
+declare const TOPIC_VOCAB: readonly ["coding", "personal", "memory", "security", "relationships", "money", "finance", "health", "work", "family", "travel", "food", "music", "sports", "politics", "general"];
+/**
+ * Classify a single conversation turn. Pure function.
+ *
+ * @param role "user" or "assistant"
+ * @param content Raw message text
+ * @returns Hints (nullable — returns null when no rule matches)
+ */
+export declare function classifyTurn(role: string, content: string): TurnHints;
+/** Full type name from single-letter code. Used by renderer. */
+export declare function typeCodeToFull(code: string | null | undefined): string;
+/** Export topic vocabulary for tests / validation. */
+export { TOPIC_VOCAB };
+//# sourceMappingURL=turn-classifier.d.ts.map

package/dist/src/turn-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-classifier.d.ts","sourceRoot":"","sources":["../../src/turn-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAaD,QAAA,MAAM,WAAW,oLAIP,CAAC;AA6DX;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CASrE;AAuFD,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAOtE;AAED,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAE,CAAC"}