@getplumb/core 0.4.0 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getplumb/core",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Plumb memory engine — storage abstraction, types, and local SQLite driver",
   "license": "MIT",
   "author": "Clay Waters <hello@plumb.run>",

package/dist/extraction-queue.d.ts

@@ -1,72 +0,0 @@
-import type { MessageExchange, Fact } from './types.js';
-/**
- * Extraction function signature expected by ExtractionQueue.
- * Takes an exchange, userId, and sourceChunkId, returns extracted facts.
- * LocalStore binds extractFacts with its own store + llmConfig.
- * T-079: Added sourceChunkId to link extracted facts back to raw_log chunk.
- */
-export type ExtractFn = (exchange: MessageExchange, userId: string, sourceChunkId: string) => Promise<Fact[]>;
-export interface ExtractionQueueOptions {
-    /** Drain interval in milliseconds. Defaults to PLUMB_EXTRACT_INTERVAL_MS env var or 300000 (5 min). */
-    intervalMs?: number;
-    /** Max queue size before early flush. Defaults to PLUMB_EXTRACT_BATCH_SIZE env var or 10. */
-    batchSize?: number;
-    /**
-     * Delay between individual extraction calls within a flush batch (ms).
-     * Defaults to PLUMB_EXTRACT_ITEM_DELAY_MS env var or 6500ms.
-     * Set to pace requests within LLM provider rate limits (e.g. Gemini free tier: 10 RPM = 1 req/6s).
-     */
-    itemDelayMs?: number;
-}
-/**
- * ExtractionQueue — batched fact extraction queue.
- *
- * Replaces the immediate fire-and-forget extractFacts() call inside ingest() with
- * a deferred queue. Raw exchanges are buffered in memory; a background drain loop
- * flushes the queue periodically (default 5 min) or when batch size is reached (default 10).
- *
- * This is a pure cost optimization: one extractFacts() call per exchange, just deferred.
- *
- * Usage:
- *   const queue = new ExtractionQueue(extractFn, { intervalMs: 300_000, batchSize: 10 });
- *   queue.start();
- *   queue.enqueue(exchange, userId);
- *   // ... later
- *   await queue.stop(); // flushes remaining items
- *
- * @see T-071
- */
-export declare class ExtractionQueue {
-    private readonly extractFn;
-    private queue;
-    private timer;
-    private readonly intervalMs;
-    private readonly batchSize;
-    private readonly itemDelayMs;
-    private flushing;
-    constructor(extractFn: ExtractFn, opts?: ExtractionQueueOptions);
-    /**
-     * Enqueue an exchange for fact extraction.
-     * Triggers early flush if batch size threshold is reached.
-     * T-079: Added sourceChunkId parameter to link extracted facts back to raw_log chunk.
-     */
-    enqueue(exchange: MessageExchange, userId: string, sourceChunkId: string): void;
-    /**
-     * Start the background drain loop.
-     * Call this once after construction (e.g., in plugin activate()).
-     */
-    start(): void;
-    /**
-     * Stop the background drain loop and flush remaining items.
-     * Call this before shutdown (e.g., in plugin session_end or process exit).
-     */
-    stop(): Promise<void>;
-    /**
-     * Flush the queue immediately: drain all pending items and call extractFn for each.
-     * Uses Promise.allSettled() so one failed extraction doesn't drop others.
-     * Safe to call concurrently — only one flush runs at a time.
-     * T-079: Pass sourceChunkId to extractFn for processing state machine.
-     */
-    flush(): Promise<void>;
-}
-//# sourceMappingURL=extraction-queue.d.ts.map

package/dist/extraction-queue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extraction-queue.d.ts","sourceRoot":"","sources":["../src/extraction-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,CACtB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,KAClB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAQrB,MAAM,WAAW,sBAAsB;IACrC,uGAAuG;IACvG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;IASxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAR5B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAS;gBAGN,SAAS,EAAE,SAAS,EACrC,IAAI,CAAC,EAAE,sBAAsB;IAO/B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAO/E;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA4B7B"}

package/dist/extraction-queue.js

@@ -1,101 +0,0 @@
-/**
- * ExtractionQueue — batched fact extraction queue.
- *
- * Replaces the immediate fire-and-forget extractFacts() call inside ingest() with
- * a deferred queue. Raw exchanges are buffered in memory; a background drain loop
- * flushes the queue periodically (default 5 min) or when batch size is reached (default 10).
- *
- * This is a pure cost optimization: one extractFacts() call per exchange, just deferred.
- *
- * Usage:
- *   const queue = new ExtractionQueue(extractFn, { intervalMs: 300_000, batchSize: 10 });
- *   queue.start();
- *   queue.enqueue(exchange, userId);
- *   // ... later
- *   await queue.stop(); // flushes remaining items
- *
- * @see T-071
- */
-export class ExtractionQueue {
-    extractFn;
-    queue = [];
-    timer = null;
-    intervalMs;
-    batchSize;
-    itemDelayMs;
-    flushing = false; // Prevent concurrent flush() calls
-    constructor(extractFn, opts) {
-        this.extractFn = extractFn;
-        this.intervalMs = opts?.intervalMs ?? Number(process.env.PLUMB_EXTRACT_INTERVAL_MS ?? 300_000);
-        this.batchSize = opts?.batchSize ?? Number(process.env.PLUMB_EXTRACT_BATCH_SIZE ?? 10);
-        this.itemDelayMs = opts?.itemDelayMs ?? Number(process.env.PLUMB_EXTRACT_ITEM_DELAY_MS ?? 6_500);
-    }
-    /**
-     * Enqueue an exchange for fact extraction.
-     * Triggers early flush if batch size threshold is reached.
-     * T-079: Added sourceChunkId parameter to link extracted facts back to raw_log chunk.
-     */
-    enqueue(exchange, userId, sourceChunkId) {
-        this.queue.push({ exchange, userId, sourceChunkId });
-        if (this.queue.length >= this.batchSize) {
-            void this.flush();
-        }
-    }
-    /**
-     * Start the background drain loop.
-     * Call this once after construction (e.g., in plugin activate()).
-     */
-    start() {
-        if (this.timer !== null)
-            return; // Already started
-        this.timer = setInterval(() => void this.flush(), this.intervalMs);
-    }
-    /**
-     * Stop the background drain loop and flush remaining items.
-     * Call this before shutdown (e.g., in plugin session_end or process exit).
-     */
-    async stop() {
-        if (this.timer !== null) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-        await this.flush();
-    }
-    /**
-     * Flush the queue immediately: drain all pending items and call extractFn for each.
-     * Uses Promise.allSettled() so one failed extraction doesn't drop others.
-     * Safe to call concurrently — only one flush runs at a time.
-     * T-079: Pass sourceChunkId to extractFn for processing state machine.
-     */
-    async flush() {
-        // Prevent concurrent flush() calls
-        if (this.flushing)
-            return;
-        this.flushing = true;
-        try {
-            // Snapshot the queue and clear it atomically
-            const batch = this.queue.splice(0);
-            if (batch.length === 0)
-                return;
-            // Extract facts sequentially with per-item delay to respect LLM provider rate limits.
-            // (Gemini free tier: 10 RPM → 1 req/6s; default itemDelayMs=6500 gives safe headroom.)
-            // T-095: Previously used Promise.allSettled() (parallel); switched to sequential to avoid 429s.
-            for (const item of batch) {
-                try {
-                    await this.extractFn(item.exchange, item.userId, item.sourceChunkId);
-                }
-                catch (err) {
-                    // Log but don't abort the batch — match original Promise.allSettled() behavior
-                    console.error('[plumb/extraction-queue] extractFn error:', err);
-                }
-                if (this.itemDelayMs > 0) {
-                    await new Promise(r => setTimeout(r, this.itemDelayMs));
-                }
-            }
-        }
-        finally {
-            this.flushing = false;
-        }
-    }
-}
-//# sourceMappingURL=extraction-queue.js.map

package/dist/extraction-queue.js.map

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

package/dist/extractor.d.ts

@@ -1,22 +0,0 @@
-import type { MemoryStore } from './store.js';
-import { type Fact, type MessageExchange } from './types.js';
-/**
- * Extract facts from a conversation exchange via an LLM call.
- *
- * Makes one LLM call, parses the JSON array response, persists each fact via
- * the provided store, and returns the stored Fact[].
- *
- * Dedup strategy: always insert as a new entry — never update an existing fact
- * with the same subject+predicate. Decay scoring (T-006) handles ranking.
- *
- * @param exchange - The conversation exchange to extract facts from.
- * @param userId   - The user ID to scope facts to (passed to store.store()).
- *                   NOTE: LocalStore captures userId at construction time, so
- *                   this param is accepted here for documentation/future use
- *                   but the store itself enforces the scope.
- * @param store    - The MemoryStore instance to persist facts into.
- * @param llmFn    - Optional LLM function to use (injectable for testing).
- * @param sourceChunkId - Optional raw_log chunk ID (T-079 processing state machine).
- */
-export declare function extractFacts(exchange: MessageExchange, _userId: string, store: MemoryStore, llmFn?: (prompt: string) => Promise<string>, sourceChunkId?: string): Promise<Fact[]>;
-//# sourceMappingURL=extractor.d.ts.map

package/dist/extractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../src/extractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAa,KAAK,IAAI,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AA0JxE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,WAAW,EAClB,KAAK,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAW,EACpD,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,EAAE,CAAC,CAwCjB"}

package/dist/extractor.js

@@ -1,188 +0,0 @@
-import { callLLM } from './llm-client.js';
-import { DecayRate } from './types.js';
-/** Build the extraction prompt from a conversation exchange. */
-function buildExtractionPrompt(exchange) {
-    return (`Extract facts from this conversation exchange worth recalling in a future session.\n\n` +
-        `Apply the 30-day recall test: "If I had no memory of this conversation and someone asked me about this user in 30 days, would knowing this fact help me serve them better?"\n\n` +
-        `User: ${exchange.userMessage}\n` +
-        `Agent: ${exchange.agentResponse}\n\n` +
-        `Extraction tiers (prioritize stable, durable facts):\n` +
-        `Tier 1 (always extract): identity, bio, stable preferences, permanent decisions, named relationships, skills/knowledge\n` +
-        `Tier 2 (extract if confident): project architecture decisions, tool choices, recurring workflows\n` +
-        `Tier 3 (skip unless explicitly significant): events, status updates, transient state, anything already tracked in a task or code\n\n` +
-        `Concrete examples:\n` +
-        `BAD (skip): "There are 2,162 pending raw_log chunks" — transient state, stale immediately\n` +
-        `BAD (skip): "Claude Code ran T-018 independently" — event, already in git history\n` +
-        `BAD (skip): "User registered plumb.run" — event, now complete\n` +
-        `GOOD (keep): "Clay prefers bullet lists over markdown tables" — stable preference\n` +
-        `GOOD (keep): "Plumb uses SQLite + WASM for local storage" — durable decision\n` +
-        `GOOD (keep): "Clay's address is 332 Casper Drive, Lafayette, CO 80026" — identity/bio\n\n` +
-        `Rules:\n` +
-        `- Output ONLY a valid JSON array. No prose, no explanation, no markdown fences.\n` +
-        `- Each item: {"subject": string, "predicate": string, "object": string, "context": string, "confidence": number 0-1, "decay_rate": "slow"|"medium"|"fast"}\n` +
-        `- decay_rate: slow=identity/stable prefs/decisions, medium=project context/tool choices, fast=transient state\n` +
-        `- confidence (calibrated — 0.95 is RARE, reserved for permanent facts):\n` +
-        `  * 0.95: Stable biographical/identity facts, verified permanent data\n` +
-        `    Example: "Clay lives at 332 Casper Drive, Lafayette, CO 80026" (permanent address)\n` +
-        `  * 0.85-0.90: Strong stated preferences, confirmed architectural decisions, recurring behavioral patterns\n` +
-        `    Example: "Clay prefers bullet lists over markdown tables" (stated preference, stable)\n` +
-        `  * 0.70-0.84: Inferred preferences, situational context, likely-but-not-certain facts\n` +
-        `    Example: "Clay seems to prefer morning standup calls" (inferred from behavior)\n` +
-        `  * 0.50-0.69: Speculative observations, one-time mentions, might-be-outdated\n` +
-        `    Example: "Clay might be considering switching to a new job" (speculative)\n` +
-        `  * Below 0.50: Do NOT extract — output [] instead (not worth storing)\n` +
-        `- Output [] liberally — it is better to extract nothing than to extract low-value facts that will pollute future retrieval.\n` +
-        `- Skip: pleasantries, small talk, transient questions, tool outputs, error messages, current date/time statements, agent operating instructions (what the agent should do/read/reply), session identifiers, heartbeat/cron state, facts about the agent itself (unless the agent has a permanent attribute like a name or email), events already recorded elsewhere (git commits, kanban tasks, emails), transient project state\n` +
-        `- Extract: identity/bio, stable preferences, permanent decisions, named relationships, skills/knowledge, project architecture (if durable), tool choices (if durable), recurring workflows\n\n` +
-        `JSON array:`);
-}
-/**
- * Parse a JSON array from LLM output, tolerating markdown code fences and leading prose.
- * Returns empty array on any parse failure.
- */
-function parseJsonArray(text) {
-    // Find the first '[' and last ']' — extract just that substring
-    const start = text.indexOf('[');
-    const end = text.lastIndexOf(']');
-    if (start === -1 || end === -1 || end < start)
-        return [];
-    const jsonSlice = text.slice(start, end + 1).trim();
-    const parsed = JSON.parse(jsonSlice);
-    if (!Array.isArray(parsed))
-        return [];
-    return parsed;
-}
-function toDecayRate(raw) {
-    if (raw === 'slow')
-        return DecayRate.slow;
-    if (raw === 'fast')
-        return DecayRate.fast;
-    return DecayRate.medium;
-}
-/**
- * Filter out ephemeral and agent-instruction facts that should not be stored.
- *
- * Blocks noise patterns:
- * - Current time/date statements (e.g., 'Current time is Friday...')
- * - Session identifiers (e.g., 'Current session is identified by...')
- * - Agent operating instructions (e.g., 'Agent should reply HEARTBEAT_OK')
- * - Heartbeat/cron state facts
- *
- * Does NOT block valid facts like:
- * - 'Agent is named Terra' (permanent attribute)
- * - 'Clay prefers agent to draft emails' (user preference)
- */
-function isNoiseFact(fact) {
-    const subjectLower = fact.subject.toLowerCase();
-    const predicateLower = fact.predicate.toLowerCase();
-    const objectLower = fact.object.toLowerCase();
-    // Block ephemeral timestamp subjects
-    const blockedSubjects = [
-        'current time',
-        'current date',
-        'current session',
-        'today',
-        "today's date",
-    ];
-    if (blockedSubjects.some(blocked => subjectLower.includes(blocked))) {
-        return true;
-    }
-    // Block agent imperative predicates (instructions to the agent)
-    const blockedPredicates = [
-        'should reply',
-        'must reply',
-        'should read',
-        'must read',
-        'should not infer',
-        'must not repeat',
-        'should not repeat',
-        'must not',
-        'should not',
-    ];
-    if (blockedPredicates.some(blocked => predicateLower.includes(blocked))) {
-        return true;
-    }
-    // Block Agent + imperative (should/must) combinations
-    // BUT allow 'Agent is named X' or 'Agent has email X' (permanent attributes)
-    if (subjectLower === 'agent') {
-        // If predicate is a permanent attribute verb, allow it
-        const permanentPredicates = ['is named', 'has email', 'is called', 'name is', 'email is'];
-        const isPermanentAttribute = permanentPredicates.some(perm => predicateLower.includes(perm));
-        if (!isPermanentAttribute) {
-            // Block agent operating instructions
-            if (predicateLower.includes('should') || predicateLower.includes('must') ||
-                predicateLower.includes('needs to') || predicateLower.includes('will')) {
-                return true;
-            }
-        }
-    }
-    // Block date/time patterns in object field (e.g., '2026-03-06', 'Friday, March 6th, 2026')
-    const dateTimePattern = /\d{4}-\d{2}-\d{2}|(monday|tuesday|wednesday|thursday|friday|saturday|sunday).*\d{4}|\d{1,2}:\d{2}\s*(am|pm)/i;
-    if (predicateLower === 'is' && dateTimePattern.test(objectLower)) {
-        return true;
-    }
-    // Block session identifier patterns
-    if (objectLower.includes('openclaw session') || objectLower.includes('session 0x')) {
-        return true;
-    }
-    // Block heartbeat-related facts
-    if (subjectLower.includes('heartbeat') || objectLower.includes('heartbeat')) {
-        return true;
-    }
-    return false;
-}
-/**
- * Extract facts from a conversation exchange via an LLM call.
- *
- * Makes one LLM call, parses the JSON array response, persists each fact via
- * the provided store, and returns the stored Fact[].
- *
- * Dedup strategy: always insert as a new entry — never update an existing fact
- * with the same subject+predicate. Decay scoring (T-006) handles ranking.
- *
- * @param exchange - The conversation exchange to extract facts from.
- * @param userId   - The user ID to scope facts to (passed to store.store()).
- *                   NOTE: LocalStore captures userId at construction time, so
- *                   this param is accepted here for documentation/future use
- *                   but the store itself enforces the scope.
- * @param store    - The MemoryStore instance to persist facts into.
- * @param llmFn    - Optional LLM function to use (injectable for testing).
- * @param sourceChunkId - Optional raw_log chunk ID (T-079 processing state machine).
- */
-export async function extractFacts(exchange, _userId, store, llmFn = callLLM, sourceChunkId) {
-    const prompt = buildExtractionPrompt(exchange);
-    const response = await llmFn(prompt);
-    let rawFacts;
-    try {
-        rawFacts = parseJsonArray(response);
-    }
-    catch {
-        console.error('[plumb/extractor] Failed to parse LLM response as JSON array:', response);
-        return [];
-    }
-    const facts = [];
-    for (const raw of rawFacts) {
-        // Post-extraction noise filter: discard ephemeral facts before storing
-        if (isNoiseFact(raw)) {
-            continue;
-        }
-        const factInput = {
-            subject: String(raw.subject),
-            predicate: String(raw.predicate),
-            object: String(raw.object),
-            confidence: Math.max(0, Math.min(1, Number(raw.confidence))),
-            decayRate: toDecayRate(String(raw.decay_rate)),
-            timestamp: new Date(),
-            sourceSessionId: exchange.sessionId,
-            ...(exchange.sessionLabel !== undefined ? { sourceSessionLabel: exchange.sessionLabel } : {}),
-            ...(raw.context !== undefined ? { context: String(raw.context) } : {}),
-        };
-        // Dedup: always insert as a new entry (do not update existing same subject+predicate).
-        // The store always inserts; decay scoring handles which entry wins at retrieval time.
-        // T-079: Pass sourceChunkId to link fact back to raw_log chunk.
-        const id = await store.store(factInput, sourceChunkId);
-        facts.push({ id, ...factInput });
-    }
-    return facts;
-}
-//# sourceMappingURL=extractor.js.map

package/dist/extractor.js.map

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

package/dist/extractor.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=extractor.test.d.ts.map

package/dist/extractor.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extractor.test.d.ts","sourceRoot":"","sources":["../src/extractor.test.ts"],"names":[],"mappings":""}

package/dist/extractor.test.js

@@ -1,158 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { extractFacts } from './extractor.js';
-import { DecayRate } from './types.js';
-// ---------------------------------------------------------------------------
-// Test fixtures
-// ---------------------------------------------------------------------------
-const testExchange = {
-    userMessage: 'I prefer dark mode for all my editors.',
-    agentResponse: 'Noted, I will use dark mode settings.',
-    timestamp: new Date('2026-01-01T12:00:00Z'),
-    source: 'openclaw',
-    sessionId: 'session-001',
-    sessionLabel: 'prefs-chat',
-};
-const testExchangeNoLabel = {
-    userMessage: 'I use TypeScript for everything.',
-    agentResponse: 'Great choice.',
-    timestamp: new Date('2026-01-01T13:00:00Z'),
-    source: 'openclaw',
-    sessionId: 'session-002',
-};
-// ---------------------------------------------------------------------------
-// In-memory mock store
-// ---------------------------------------------------------------------------
-function createMockStore() {
-    const stored = [];
-    const store = {
-        async store(fact) {
-            const id = crypto.randomUUID();
-            stored.push({ id, ...fact });
-            return id;
-        },
-        async search(_query, _limit) {
-            return [];
-        },
-        async delete(_id) { },
-        async status() {
-            return { factCount: stored.length, rawLogCount: 0, lastIngestion: null, storageBytes: 0 };
-        },
-        async ingest(_exchange) {
-            return { rawLogId: crypto.randomUUID(), factsExtracted: 0, factIds: [] };
-        },
-    };
-    return { store, stored };
-}
-// ---------------------------------------------------------------------------
-// LLM mock helpers
-// ---------------------------------------------------------------------------
-function mockLLM(responseJson) {
-    return async (_prompt) => JSON.stringify(responseJson);
-}
-function mockLLMWithFences(responseJson) {
-    return async (_prompt) => '```json\n' + JSON.stringify(responseJson) + '\n```';
-}
-// ---------------------------------------------------------------------------
-// Tests: structured output parsing
-// ---------------------------------------------------------------------------
-test('extractFacts: parses a valid JSON array and stores each fact', async () => {
-    const { store, stored } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([
-        {
-            subject: 'user',
-            predicate: 'prefers',
-            object: 'dark mode',
-            context: 'mentioned for all editors',
-            confidence: 0.9,
-            decay_rate: 'slow',
-        },
-    ]));
-    assert.equal(result.length, 1);
-    assert.equal(result[0].subject, 'user');
-    assert.equal(result[0].predicate, 'prefers');
-    assert.equal(result[0].object, 'dark mode');
-    assert.equal(result[0].context, 'mentioned for all editors');
-    assert.equal(result[0].confidence, 0.9);
-    assert.equal(result[0].decayRate, DecayRate.slow);
-    assert.equal(result[0].sourceSessionId, 'session-001');
-    assert.equal(result[0].sourceSessionLabel, 'prefs-chat');
-    assert.match(result[0].id, /^[0-9a-f-]{36}$/);
-    assert.equal(stored.length, 1);
-});
-test('extractFacts: strips markdown code fences before parsing', async () => {
-    const { store } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLMWithFences([
-        { subject: 'user', predicate: 'uses', object: 'TypeScript', confidence: 0.95, decay_rate: 'medium' },
-    ]));
-    assert.equal(result.length, 1);
-    assert.equal(result[0].object, 'TypeScript');
-    assert.equal(result[0].decayRate, DecayRate.medium);
-});
-test('extractFacts: returns [] and stores nothing when LLM returns []', async () => {
-    const { store, stored } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([]));
-    assert.equal(result.length, 0);
-    assert.equal(stored.length, 0);
-});
-test('extractFacts: returns [] gracefully when LLM returns invalid JSON', async () => {
-    const { store, stored } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, async () => 'This is definitely not JSON.');
-    assert.equal(result.length, 0);
-    assert.equal(stored.length, 0);
-});
-test('extractFacts: handles multiple facts in one LLM response', async () => {
-    const { store, stored } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([
-        { subject: 'user', predicate: 'prefers', object: 'dark mode', confidence: 0.9, decay_rate: 'slow' },
-        { subject: 'user', predicate: 'uses', object: 'vim keybindings', confidence: 0.8, decay_rate: 'medium' },
-    ]));
-    assert.equal(result.length, 2);
-    assert.equal(stored.length, 2);
-});
-test('extractFacts: clamps confidence to [0, 1]', async () => {
-    const { store } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([
-        { subject: 'a', predicate: 'b', object: 'c', confidence: 1.5, decay_rate: 'slow' },
-        { subject: 'd', predicate: 'e', object: 'f', confidence: -0.3, decay_rate: 'fast' },
-    ]));
-    assert.equal(result[0].confidence, 1.0);
-    assert.equal(result[1].confidence, 0.0);
-});
-test('extractFacts: unknown decay_rate defaults to medium', async () => {
-    const { store } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([{ subject: 'a', predicate: 'b', object: 'c', confidence: 0.5, decay_rate: 'unknown-rate' }]));
-    assert.equal(result[0].decayRate, DecayRate.medium);
-});
-test('extractFacts: sourceSessionLabel is omitted when exchange has no sessionLabel', async () => {
-    const { store } = createMockStore();
-    const result = await extractFacts(testExchangeNoLabel, 'user-1', store, mockLLM([{ subject: 'user', predicate: 'uses', object: 'TypeScript', confidence: 0.9, decay_rate: 'slow' }]));
-    assert.equal(result[0].sourceSessionId, 'session-002');
-    assert.equal(result[0].sourceSessionLabel, undefined);
-});
-test('extractFacts: context field is omitted when LLM does not include it', async () => {
-    const { store } = createMockStore();
-    const result = await extractFacts(testExchange, 'user-1', store, mockLLM([{ subject: 'user', predicate: 'prefers', object: 'dark mode', confidence: 0.9, decay_rate: 'slow' }]));
-    assert.equal(result[0].context, undefined);
-});
-// ---------------------------------------------------------------------------
-// Tests: deduplication strategy
-// ---------------------------------------------------------------------------
-test('extractFacts dedup: inserts new entry when same subject+predicate already exists', async () => {
-    const { store, stored } = createMockStore();
-    const singleFact = [
-        { subject: 'user', predicate: 'prefers', object: 'dark mode', confidence: 0.9, decay_rate: 'slow' },
-    ];
-    // First extraction
-    await extractFacts(testExchange, 'user-1', store, mockLLM(singleFact));
-    assert.equal(stored.length, 1);
-    // Second extraction with same subject+predicate
-    await extractFacts(testExchange, 'user-1', store, mockLLM(singleFact));
-    assert.equal(stored.length, 2, 'should insert new entry, not overwrite existing');
-    // Both entries have unique IDs
-    assert.notEqual(stored[0].id, stored[1].id);
-    // Both have same subject+predicate
-    assert.equal(stored[0].subject, stored[1].subject);
-    assert.equal(stored[0].predicate, stored[1].predicate);
-});
-//# sourceMappingURL=extractor.test.js.map

package/dist/extractor.test.js.map

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

package/dist/fact-search.d.ts

@@ -1,32 +0,0 @@
-/**
- * Fact hybrid search (Layer 2 retrieval).
- *
- * Pipeline:
- *   1. BM25 keyword search over concatenated fact text (subject+predicate+object+context)
- *   2. KNN vector search via JS cosine similarity (replaces sqlite-vec)
- *   3. Reciprocal Rank Fusion (RRF, k=60) merges both ranked lists
- *   4. Recency decay: score *= e^(-lambda × age_in_days), using per-fact decay_rate
- *   5. Cross-encoder reranker (top-20 candidates → Xenova/ms-marco-MiniLM-L-6-v2)
- *   6. Return top-k by reranker score (falls back to RRF×decay if reranker fails)
- *
- * Decay lambdas by fact decay_rate:
- *   slow=0.003 (half-life ~231 days) — identity, stable preferences
- *   medium=0.012 (half-life ~58 days) — project context, tool choices
- *   fast=0.05 (half-life ~14 days) — transient state
- */
-import type { WasmDb } from './wasm-db.js';
-import type { SearchResult } from './types.js';
-/**
- * Hybrid search over facts.
- *
- * @param db                The WASM SQLite Database instance
- * @param userId            Scopes the search to this user's data
- * @param query             Natural language query string
- * @param limit             Number of results to return (default 20)
- * @param preloadedCorpus   Optional pre-loaded vec_facts corpus (T-096: in-memory cache)
- */
-export declare function searchFacts(db: WasmDb, userId: string, query: string, limit?: number, preloadedCorpus?: Array<{
-    rowid: number;
-    embedding: Float32Array;
-}>): Promise<readonly SearchResult[]>;
-//# sourceMappingURL=fact-search.d.ts.map

package/dist/fact-search.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fact-search.d.ts","sourceRoot":"","sources":["../src/fact-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA0F/C;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,EACV,eAAe,CAAC,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,GAClE,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CA2GlC"}