fastrmemory 0.5.0 → 0.6.0

package/dist/src/search/static-model-install.js.map

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

package/dist/src/search/static-model.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Pure-TypeScript static embedding model (model2vec / potion).
+ *
+ * A model2vec model is a lookup table: one 256-dim vector per WordPiece token, plus the
+ * tokenizer. Inference is mean pooling over the token rows followed by L2 normalization,
+ * exactly as `model2vec.StaticModel.encode` does it: no special tokens, unknown tokens
+ * dropped, no Zipf weighting at inference (that is a training-time re-regularization).
+ *
+ * This module reads `model.safetensors` and `tokenizer.json` directly, so the semantic tier
+ * needs no native binary and no extra runtime dependency.
+ */
+export declare const POTION_BASE_8M: {
+    readonly name: "minishlab/potion-base-8M";
+    readonly revision: "bf8b056651a2c21b8d2565580b8569da283cab23";
+    readonly modelFile: "model.safetensors";
+    readonly modelBytes: 30236760;
+    readonly modelSha256: "f65d0f325faadc1e121c319e2faa41170d3fa07d8c89abd48ca5358d9a223de2";
+    readonly tokenizerFile: "tokenizer.json";
+    readonly tokenizerBytes: 683666;
+    readonly tokenizerSha256: "e67e803f624fb4d67dea1c730d06e1067e1b14d830e2c2202569e3ef0f70bb50";
+    readonly dim: 256;
+    readonly vocabSize: 29528;
+};
+export interface StaticModel {
+    readonly name: string;
+    readonly dim: number;
+    readonly vocabSize: number;
+    /** WordPiece token ids for a string, with special tokens omitted. */
+    tokenize(text: string): number[];
+    /** Mean-pooled, L2-normalized embedding. */
+    embed(text: string): Float32Array;
+}
+interface WordPieceVocab {
+    vocab: Map<string, number>;
+    unkId: number;
+    continuingPrefix: string;
+    maxCharsPerWord: number;
+}
+/** Parses the `model` section of a HuggingFace `tokenizer.json`. */
+export declare function parseWordPieceVocab(tokenizerJson: unknown): WordPieceVocab;
+/**
+ * `BertNormalizer` with the flags this model ships: clean_text, handle_chinese_chars,
+ * lowercase, and strip_accents (which BERT defaults to the lowercase flag when unset).
+ */
+export declare function normalizeBertText(text: string): string;
+/** `BertPreTokenizer`: whitespace-delimited words with punctuation isolated. */
+export declare function preTokenizeBert(normalized: string): string[];
+/** Greedy longest-match-first WordPiece, with whole-word `[UNK]` on failure. */
+export declare function wordPieceTokenize(word: string, vocab: WordPieceVocab): number[];
+export declare function createBertTokenizer(tokenizerJson: unknown): (text: string) => number[];
+export interface SafetensorsTensor {
+    data: Float32Array;
+    shape: number[];
+}
+/** Reads a single 2-D float32 tensor from a safetensors file buffer. */
+export declare function readSafetensorsTensor(buffer: Buffer, name?: string): SafetensorsTensor;
+/**
+ * Loads a model2vec directory (`model.safetensors` + `tokenizer.json`).
+ * Throws when either file is missing or malformed; callers decide whether that is fatal.
+ */
+export declare function loadStaticModel(modelDir: string): StaticModel;
+export {};
+//# sourceMappingURL=static-model.d.ts.map

package/dist/src/search/static-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-model.d.ts","sourceRoot":"","sources":["../../../src/search/static-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,eAAO,MAAM,cAAc;;;;;;;;;;;CAWjB,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACjC,4CAA4C;IAC5C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;CACnC;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,OAAO,GAAG,cAAc,CA0B1E;AAoCD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBtD;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB5D;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAyB/E;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAStF;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAyBtF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CA6C7D"}

package/dist/src/search/static-model.js

@@ -0,0 +1,244 @@
+/**
+ * Pure-TypeScript static embedding model (model2vec / potion).
+ *
+ * A model2vec model is a lookup table: one 256-dim vector per WordPiece token, plus the
+ * tokenizer. Inference is mean pooling over the token rows followed by L2 normalization,
+ * exactly as `model2vec.StaticModel.encode` does it: no special tokens, unknown tokens
+ * dropped, no Zipf weighting at inference (that is a training-time re-regularization).
+ *
+ * This module reads `model.safetensors` and `tokenizer.json` directly, so the semantic tier
+ * needs no native binary and no extra runtime dependency.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export const POTION_BASE_8M = {
+    name: 'minishlab/potion-base-8M',
+    revision: 'bf8b056651a2c21b8d2565580b8569da283cab23',
+    modelFile: 'model.safetensors',
+    modelBytes: 30_236_760,
+    modelSha256: 'f65d0f325faadc1e121c319e2faa41170d3fa07d8c89abd48ca5358d9a223de2',
+    tokenizerFile: 'tokenizer.json',
+    tokenizerBytes: 683_666,
+    tokenizerSha256: 'e67e803f624fb4d67dea1c730d06e1067e1b14d830e2c2202569e3ef0f70bb50',
+    dim: 256,
+    vocabSize: 29_528
+};
+/** Parses the `model` section of a HuggingFace `tokenizer.json`. */
+export function parseWordPieceVocab(tokenizerJson) {
+    const model = tokenizerJson?.model;
+    if (!model || model.type !== 'WordPiece') {
+        throw new Error('tokenizer.json does not contain a WordPiece model');
+    }
+    const raw = model.vocab;
+    if (!raw)
+        throw new Error('tokenizer.json is missing the WordPiece vocabulary');
+    const vocab = new Map();
+    for (const [token, id] of Object.entries(raw)) {
+        if (typeof id === 'number')
+            vocab.set(token, id);
+    }
+    const unkId = vocab.get('[UNK]');
+    if (unkId === undefined)
+        throw new Error('WordPiece vocabulary is missing [UNK]');
+    return {
+        vocab,
+        unkId,
+        continuingPrefix: typeof model.continuing_subword_prefix === 'string'
+            ? model.continuing_subword_prefix
+            : '##',
+        maxCharsPerWord: typeof model.max_input_chars_per_word === 'number'
+            ? model.max_input_chars_per_word
+            : 100
+    };
+}
+/** True for the Unicode code points BERT's `handle_chinese_chars` surrounds with spaces. */
+function isChineseChar(code) {
+    return ((code >= 0x4e00 && code <= 0x9fff) ||
+        (code >= 0x3400 && code <= 0x4dbf) ||
+        (code >= 0x20000 && code <= 0x2a6df) ||
+        (code >= 0x2a700 && code <= 0x2b73f) ||
+        (code >= 0x2b740 && code <= 0x2b81f) ||
+        (code >= 0x2b920 && code <= 0x2ceaf) ||
+        (code >= 0xf900 && code <= 0xfaff) ||
+        (code >= 0x2f800 && code <= 0x2fa1f));
+}
+/** BERT punctuation: ASCII ranges plus every Unicode `P*` code point. */
+function isPunctuation(char) {
+    const code = char.codePointAt(0) ?? 0;
+    if ((code >= 33 && code <= 47) ||
+        (code >= 58 && code <= 64) ||
+        (code >= 91 && code <= 96) ||
+        (code >= 123 && code <= 126)) {
+        return true;
+    }
+    return /\p{P}/u.test(char);
+}
+function isControlOrReplacement(char) {
+    const code = char.codePointAt(0) ?? 0;
+    if (code === 0 || code === 0xfffd)
+        return true;
+    return /\p{Cc}|\p{Cf}/u.test(char);
+}
+/**
+ * `BertNormalizer` with the flags this model ships: clean_text, handle_chinese_chars,
+ * lowercase, and strip_accents (which BERT defaults to the lowercase flag when unset).
+ */
+export function normalizeBertText(text) {
+    let out = '';
+    for (const char of text) {
+        // Whitespace becomes a single space before the control-character filter: the
+        // reference tokenizer treats tabs/newlines as word delimiters, not as noise.
+        if (/\s/u.test(char)) {
+            out += ' ';
+            continue;
+        }
+        if (isControlOrReplacement(char))
+            continue;
+        if (isChineseChar(char.codePointAt(0) ?? 0)) {
+            out += ` ${char} `;
+            continue;
+        }
+        out += char;
+    }
+    return out.toLowerCase().normalize('NFD').replace(/\p{Mn}/gu, '');
+}
+/** `BertPreTokenizer`: whitespace-delimited words with punctuation isolated. */
+export function preTokenizeBert(normalized) {
+    const pieces = [];
+    let current = '';
+    const flush = () => {
+        if (current)
+            pieces.push(current);
+        current = '';
+    };
+    for (const char of normalized) {
+        if (char === ' ') {
+            flush();
+            continue;
+        }
+        if (isPunctuation(char)) {
+            flush();
+            pieces.push(char);
+            continue;
+        }
+        current += char;
+    }
+    flush();
+    return pieces;
+}
+/** Greedy longest-match-first WordPiece, with whole-word `[UNK]` on failure. */
+export function wordPieceTokenize(word, vocab) {
+    if (word.length === 0)
+        return [];
+    if (word.length > vocab.maxCharsPerWord)
+        return [vocab.unkId];
+    const ids = [];
+    let start = 0;
+    while (start < word.length) {
+        let end = word.length;
+        let match = -1;
+        while (start < end) {
+            const piece = start > 0
+                ? `${vocab.continuingPrefix}${word.slice(start, end)}`
+                : word.slice(start, end);
+            const id = vocab.vocab.get(piece);
+            if (id !== undefined) {
+                match = id;
+                break;
+            }
+            end--;
+        }
+        if (match < 0)
+            return [vocab.unkId];
+        ids.push(match);
+        start = end;
+    }
+    return ids;
+}
+export function createBertTokenizer(tokenizerJson) {
+    const vocab = parseWordPieceVocab(tokenizerJson);
+    return (text) => {
+        const ids = [];
+        for (const piece of preTokenizeBert(normalizeBertText(text))) {
+            for (const id of wordPieceTokenize(piece, vocab))
+                ids.push(id);
+        }
+        return ids;
+    };
+}
+/** Reads a single 2-D float32 tensor from a safetensors file buffer. */
+export function readSafetensorsTensor(buffer, name) {
+    if (buffer.byteLength < 9)
+        throw new Error('safetensors file is truncated');
+    const headerLength = Number(buffer.readBigUInt64LE(0));
+    const headerEnd = 8 + headerLength;
+    if (headerEnd > buffer.byteLength)
+        throw new Error('safetensors header exceeds file size');
+    const header = JSON.parse(buffer.subarray(8, headerEnd).toString('utf8'));
+    const key = name ?? Object.keys(header).find((candidate) => candidate !== '__metadata__');
+    if (!key)
+        throw new Error('safetensors file has no tensors');
+    const info = header[key];
+    if (!info || info.dtype !== 'F32' || !info.shape || !info.data_offsets) {
+        throw new Error(`safetensors tensor ${key} is not a float32 tensor`);
+    }
+    const [start, end] = info.data_offsets;
+    if (headerEnd + end > buffer.byteLength)
+        throw new Error('safetensors tensor exceeds file size');
+    const length = (end - start) / Float32Array.BYTES_PER_ELEMENT;
+    const data = new Float32Array(length);
+    new Uint8Array(data.buffer).set(buffer.subarray(headerEnd + start, headerEnd + end));
+    return { data, shape: info.shape };
+}
+/**
+ * Loads a model2vec directory (`model.safetensors` + `tokenizer.json`).
+ * Throws when either file is missing or malformed; callers decide whether that is fatal.
+ */
+export function loadStaticModel(modelDir) {
+    const modelPath = path.join(modelDir, POTION_BASE_8M.modelFile);
+    const tokenizerPath = path.join(modelDir, POTION_BASE_8M.tokenizerFile);
+    const tokenizerJson = JSON.parse(fs.readFileSync(tokenizerPath, 'utf8'));
+    const tokenize = createBertTokenizer(tokenizerJson);
+    const vocab = parseWordPieceVocab(tokenizerJson);
+    const tensor = readSafetensorsTensor(fs.readFileSync(modelPath));
+    if (tensor.shape.length !== 2) {
+        throw new Error(`expected a 2-D embedding matrix, got shape [${tensor.shape.join(', ')}]`);
+    }
+    const [vocabSize, dim] = tensor.shape;
+    const matrix = tensor.data;
+    return {
+        name: POTION_BASE_8M.name,
+        dim,
+        vocabSize,
+        tokenize,
+        embed(text) {
+            const ids = tokenize(text);
+            const out = new Float32Array(dim);
+            let count = 0;
+            for (const id of ids) {
+                if (id === vocab.unkId)
+                    continue;
+                if (id < 0 || id >= vocabSize)
+                    continue;
+                const offset = id * dim;
+                for (let i = 0; i < dim; i++)
+                    out[i] += matrix[offset + i];
+                count++;
+            }
+            if (count === 0)
+                return out;
+            let norm = 0;
+            for (let i = 0; i < dim; i++) {
+                out[i] /= count;
+                norm += out[i] * out[i];
+            }
+            if (norm > 0) {
+                const inv = 1 / Math.sqrt(norm);
+                for (let i = 0; i < dim; i++)
+                    out[i] *= inv;
+            }
+            return out;
+        }
+    };
+}
+//# sourceMappingURL=static-model.js.map

package/dist/src/search/static-model.js.map

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

package/dist/src/search/temporal.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Temporal query windows.
+ *
+ * "How many times did I bake in the past two weeks?" is not a topical query: it is a
+ * date-bounded one. BM25 cannot see the bound, so it ranks sessions by shared words and
+ * loses the ones outside the window. This module parses the bound into an absolute
+ * interval using the question date, so retrieval can filter on `valid_from` first and
+ * rank inside the surviving set.
+ *
+ * Only explicit, unambiguous ranges are parsed. Anything else returns null and retrieval
+ * behaves exactly as before.
+ */
+export interface TemporalWindow {
+    /** Inclusive lower bound, ISO-8601 UTC. */
+    start: string;
+    /** Inclusive upper bound, ISO-8601 UTC. */
+    end: string;
+    /** Human-readable description of what was parsed, for result annotation. */
+    label: string;
+}
+/** Parses `2023/05/30 (Tue) 23:40` and ISO strings. Returns null for unknown formats. */
+export declare function parseQuestionDate(value: string | undefined | null): Date | null;
+/**
+ * Extracts an absolute window from a question.
+ *
+ * `questionDate` anchors relative ranges. Without it, only absolute ranges ("in 2022",
+ * "in March 2023") can be resolved.
+ */
+export declare function detectTemporalWindow(query: string, questionDate: Date | null): TemporalWindow | null;
+/** True when a memory's `valid_from` falls inside the window. Unparseable dates never match. */
+export declare function withinWindow(validFrom: string, window: TemporalWindow): boolean;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/src/search/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../../src/search/temporal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;CACf;AAoBD,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAiB/E;AAsCD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,GAAG,IAAI,GAAG,cAAc,GAAG,IAAI,CA8FpG;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAI/E"}

package/dist/src/search/temporal.js

@@ -0,0 +1,164 @@
+/**
+ * Temporal query windows.
+ *
+ * "How many times did I bake in the past two weeks?" is not a topical query: it is a
+ * date-bounded one. BM25 cannot see the bound, so it ranks sessions by shared words and
+ * loses the ones outside the window. This module parses the bound into an absolute
+ * interval using the question date, so retrieval can filter on `valid_from` first and
+ * rank inside the surviving set.
+ *
+ * Only explicit, unambiguous ranges are parsed. Anything else returns null and retrieval
+ * behaves exactly as before.
+ */
+const MONTHS = {
+    january: 1, february: 2, march: 3, april: 4, may: 5, june: 6,
+    july: 7, august: 8, september: 9, october: 10, november: 11, december: 12,
+    jan: 1, feb: 2, mar: 3, apr: 4, jun: 6, jul: 7, aug: 8, sep: 9, sept: 9, oct: 10, nov: 11, dec: 12
+};
+const NUMBER_WORDS = {
+    one: 1, two: 2, three: 3, four: 4, five: 5, six: 6, seven: 7, eight: 8, nine: 9, ten: 10,
+    eleven: 11, twelve: 12, a: 1, an: 1
+};
+const UNIT_MS = {
+    day: 86_400_000,
+    week: 7 * 86_400_000,
+    month: 30 * 86_400_000,
+    year: 365 * 86_400_000
+};
+/** Parses `2023/05/30 (Tue) 23:40` and ISO strings. Returns null for unknown formats. */
+export function parseQuestionDate(value) {
+    if (!value)
+        return null;
+    const match = /^(\d{4})[/-](\d{2})[/-](\d{2})(?:\s*\([A-Za-z]{3}\))?(?:[T ](\d{2}):(\d{2})(?::(\d{2}))?)?/.exec(value.trim());
+    if (match) {
+        const [, year, month, day, hour, minute, second] = match;
+        const date = new Date(Date.UTC(Number(year), Number(month) - 1, Number(day), hour ? Number(hour) : 0, minute ? Number(minute) : 0, second ? Number(second) : 0));
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+function iso(date) {
+    return date.toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+function windowFrom(start, end, label) {
+    if (start.getTime() > end.getTime())
+        return null;
+    return { start: iso(start), end: iso(end), label };
+}
+function subtractUnits(date, amount, unit) {
+    if (unit === 'month') {
+        // Calendar months have different lengths, so the day is clamped to the last day of
+        // the target month instead of rolling forward (2023-05-30 minus 3 months is
+        // 2023-02-28, not 2023-03-02).
+        const year = date.getUTCFullYear();
+        const month = date.getUTCMonth() - amount;
+        const lastDay = new Date(Date.UTC(year, month + 1, 0)).getUTCDate();
+        const day = Math.min(date.getUTCDate(), lastDay);
+        return new Date(Date.UTC(year, month, day, date.getUTCHours(), date.getUTCMinutes(), date.getUTCSeconds(), date.getUTCMilliseconds()));
+    }
+    if (unit === 'year') {
+        const copy = new Date(date.getTime());
+        copy.setUTCFullYear(copy.getUTCFullYear() - amount);
+        return copy;
+    }
+    return new Date(date.getTime() - amount * UNIT_MS[unit]);
+}
+/**
+ * Extracts an absolute window from a question.
+ *
+ * `questionDate` anchors relative ranges. Without it, only absolute ranges ("in 2022",
+ * "in March 2023") can be resolved.
+ */
+export function detectTemporalWindow(query, questionDate) {
+    const text = query.toLowerCase().replace(/\s+/g, ' ').trim();
+    const anchor = questionDate ?? null;
+    // "past two weeks", "last 3 months", "in the past year"
+    const counted = /\b(?:in the )?(?:past|last)\s+(\d+|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve)\s+(day|week|month|year)s?\b/.exec(text);
+    if (counted && anchor) {
+        const amount = /^\d+$/.test(counted[1]) ? Number(counted[1]) : NUMBER_WORDS[counted[1]];
+        if (amount > 0) {
+            return windowFrom(subtractUnits(anchor, amount, counted[2]), anchor, `past ${counted[1]} ${counted[2]}${amount === 1 ? '' : 's'}`);
+        }
+    }
+    // "past few months", "last couple of weeks"
+    const vague = /\b(?:in the )?(?:past|last)\s+(few|couple(?: of)?)\s+(day|week|month|year)s?\b/.exec(text);
+    if (vague && anchor) {
+        // "a few" is conventionally three; "a couple" is two.
+        const amount = vague[1] === 'few' ? 3 : 2;
+        return windowFrom(subtractUnits(anchor, amount, vague[2]), anchor, `past ${vague[1]} ${vague[2]}s`);
+    }
+    if (anchor) {
+        // "this week / month / year"
+        const current = /\bthis (week|month|year)\b/.exec(text);
+        if (current) {
+            const unit = current[1];
+            let start;
+            if (unit === 'week') {
+                start = new Date(anchor.getTime());
+                const day = start.getUTCDay();
+                start.setUTCDate(start.getUTCDate() - ((day + 6) % 7));
+                start.setUTCHours(0, 0, 0, 0);
+            }
+            else if (unit === 'month') {
+                start = new Date(Date.UTC(anchor.getUTCFullYear(), anchor.getUTCMonth(), 1));
+            }
+            else {
+                start = new Date(Date.UTC(anchor.getUTCFullYear(), 0, 1));
+            }
+            return windowFrom(start, anchor, `this ${unit}`);
+        }
+        // "last week / month / year"
+        const previous = /\blast (week|month|year)\b/.exec(text);
+        if (previous) {
+            const unit = previous[1];
+            if (unit === 'year') {
+                const year = anchor.getUTCFullYear() - 1;
+                return windowFrom(new Date(Date.UTC(year, 0, 1)), new Date(Date.UTC(year, 11, 31, 23, 59, 59)), 'last year');
+            }
+            if (unit === 'month') {
+                const start = new Date(Date.UTC(anchor.getUTCFullYear(), anchor.getUTCMonth() - 1, 1));
+                const end = new Date(Date.UTC(anchor.getUTCFullYear(), anchor.getUTCMonth(), 0, 23, 59, 59));
+                return windowFrom(start, end, 'last month');
+            }
+            const start = new Date(anchor.getTime());
+            const day = start.getUTCDay();
+            start.setUTCDate(start.getUTCDate() - ((day + 6) % 7) - 7);
+            start.setUTCHours(0, 0, 0, 0);
+            return windowFrom(start, new Date(start.getTime() + 7 * UNIT_MS.day - 1000), 'last week');
+        }
+        // "since the start of the year", "since the beginning of this year", "since this year"
+        if (/\bsince (?:the )?(?:start|beginning) of (?:the|this) year\b|\bsince (?:the )?(?:this )?year\b/.test(text)) {
+            return windowFrom(new Date(Date.UTC(anchor.getUTCFullYear(), 0, 1)), anchor, 'since the start of the year');
+        }
+        // "since 2021", "since March 2022"
+        const since = /\bsince\s+(?:(january|february|march|april|may|june|july|august|september|october|november|december|jan|feb|mar|apr|jun|jul|aug|sep|sept|oct|nov|dec)\s+)?(\d{4})\b/.exec(text);
+        if (since) {
+            const month = since[1] ? MONTHS[since[1]] : 1;
+            const year = Number(since[2]);
+            return windowFrom(new Date(Date.UTC(year, month - 1, 1)), anchor, `since ${since[1] ? `${since[1]} ` : ''}${year}`);
+        }
+    }
+    // Absolute year: "in 2022", "during 2021"
+    const year = /\b(?:in|during)\s+(\d{4})\b/.exec(text);
+    if (year) {
+        const value = Number(year[1]);
+        return windowFrom(new Date(Date.UTC(value, 0, 1)), new Date(Date.UTC(value, 11, 31, 23, 59, 59)), `in ${value}`);
+    }
+    // Absolute month + year: "in March 2023"
+    const monthYear = /\b(?:in|during)\s+(january|february|march|april|may|june|july|august|september|october|november|december)\s+(\d{4})\b/.exec(text);
+    if (monthYear) {
+        const month = MONTHS[monthYear[1]];
+        const value = Number(monthYear[2]);
+        return windowFrom(new Date(Date.UTC(value, month - 1, 1)), new Date(Date.UTC(value, month, 0, 23, 59, 59)), `${monthYear[1]} ${value}`);
+    }
+    return null;
+}
+/** True when a memory's `valid_from` falls inside the window. Unparseable dates never match. */
+export function withinWindow(validFrom, window) {
+    const time = Date.parse(validFrom);
+    if (Number.isNaN(time))
+        return false;
+    return time >= Date.parse(window.start) && time <= Date.parse(window.end);
+}
+//# sourceMappingURL=temporal.js.map

package/dist/src/search/temporal.js.map

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

package/llms-install.md

@@ -27,9 +27,9 @@ From the project the developer works in, configure the MCP client with one comma
 fastr mcp init --client claude
 ```
 
-Supported project-scoped clients are `claude`, `cursor`, `vscode`, `opencode`, `gemini`, and `copilot`. Use `--client all --scope project` for all six. User-scoped clients are `claude`, `cursor`, `vscode`, `gemini`, `windsurf`, `antigravity`, `claude-desktop`, and `codex`; `codex` prints a TOML snippet for `~/.codex/config.toml` instead of rewriting it. The default writes `fastrmemory@latest`; add `--channel pinned` to write the exact version, `--runner pnpm|yarn|bunx` to change the package runner, and `--dry-run` to inspect without writing. Existing JSON is merged, unrelated keys are preserved, and the first change writes a `.fastr.bak` backup. Pass `--source local` to write the active CLI path plus an absolute `--project`; use the default `--source registry` for portable configs. `--source local` ships in `0.5.0` (prepared); `0.4.0` remains the published install target until `v0.5.0`; on published `0.4.0`, `fastr setup` writes an installed-CLI entry.
+Supported project-scoped clients are `claude`, `cursor`, `vscode`, `opencode`, `gemini`, and `copilot`. Use `--client all --scope project` for all six. User-scoped clients are `claude`, `cursor`, `vscode`, `gemini`, `windsurf`, `antigravity`, `claude-desktop`, and `codex`; `codex` prints a TOML snippet for `~/.codex/config.toml` instead of rewriting it. The default writes `fastrmemory@latest`; add `--channel pinned` to write the exact version, `--runner pnpm|yarn|bunx` to change the package runner, and `--dry-run` to inspect without writing. Existing JSON is merged, unrelated keys are preserved, and the first change writes a `.fastr.bak` backup. Pass `--source local` to write the active CLI path plus an absolute `--project`; use the default `--source registry` for portable configs. `--source local` ships in published `0.5.0`; `0.4.0` remains published historical, and on `0.4.0`, `fastr setup` writes an installed-CLI entry.
 
-> `mcp init` ships in published `0.4.0`; `npx fastrmemory@latest mcp init ...` now resolves to `0.4.0`. If the command is missing, check `fastr --version`, install `npm install -g fastrmemory@0.4.0`, or run `npx -y fastrmemory@0.4.0 mcp init ...`. For the previous release, use `fastr setup` or pin `fastrmemory@0.3.1`.
+> `mcp init` ships in `0.4.0` and later; `npx fastrmemory@latest mcp init ...` now resolves to published `0.5.0`. If the command is missing, check `fastr --version`, install `npm install -g fastrmemory@0.5.0`, or run `npx -y fastrmemory@0.5.0 mcp init ...`. For the previous release, use `fastr setup` or pin `fastrmemory@0.3.1`.
 
 For the full installer (database initialization, `AGENTS.md`, skills, and lifecycle hooks), run:
 
@@ -58,7 +58,7 @@ Any MCP client can launch the stdio server directly:
 }
 ```
 
-For user-scoped clients (Claude Desktop, Antigravity, Windsurf, and the Claude Code entry in `~/.claude.json`), append `--project /absolute/path/to/project` so the client's launch directory cannot select the wrong database. `fastr mcp init --scope user` adds this automatically. On native Windows, `fastr mcp init` emits `cmd /c npx ...`; a manual entry can use `cmd /c npx -y fastrmemory@latest mcp` if the client cannot launch `npx` directly. `fastr setup` writes the absolute `node` path automatically. On current `main`, `fastr mcp init --source local` writes the same installed-CLI shape. The full 41-tool surface is the default; add `--profile core` to expose the 12-tool daily loop.
+For user-scoped clients (Claude Desktop, Antigravity, Windsurf, and the Claude Code entry in `~/.claude.json`), append `--project /absolute/path/to/project` so the client's launch directory cannot select the wrong database. `fastr mcp init --scope user` adds this automatically. On native Windows, `fastr mcp init` emits `cmd /c npx ...`; a manual entry can use `cmd /c npx -y fastrmemory@latest mcp` if the client cannot launch `npx` directly. `fastr setup` writes the absolute `node` path automatically. On published `0.5.0`, `fastr mcp init --source local` writes the same installed-CLI shape. The default core profile exposes 12 tools, including `fastr_tools` and `fastr_call`; add `--profile full` to expose all 43.
 
 ## 5. Verify
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fastrmemory",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "mcpName": "io.github.atifjubaer/fastrmemory",
   "description": "High-Performance Cognitive Agent Memory Engine with Bi-Temporal SQLite and Official MCP v2",
   "type": "module",
@@ -52,6 +52,7 @@
     "smoke:gemini": "npm run build:core && node scripts/smoke-gemini.mjs",
     "smoke:copilot": "npm run build:core && node scripts/smoke-copilot.mjs",
     "smoke:opencode": "npm run build:core && node scripts/smoke-opencode.mjs",
+    "smoke:hooks": "npm run build:core && node scripts/smoke-hooks.mjs",
     "test:crash": "node scripts/crash-test.mjs",
     "check:skills": "node scripts/check-skills.mjs",
     "check:dist-ui": "node scripts/check-dist-ui.mjs",
@@ -64,6 +65,9 @@
     "bench:legacy": "tsx scripts/capture-bench.ts",
     "bench:public": "tsx scripts/eval-public.ts",
     "bench:external": "tsx scripts/eval-external.ts",
+    "bench:vs": "tsx scripts/bench-vs.ts",
+    "bench:fetch": "tsx scripts/fetch-bench-data.ts",
+    "bench:setup": "tsx scripts/fetch-bench-data.ts --engines",
     "bench:verify": "node scripts/check-bench.mjs",
     "verify:replay": "tsx scripts/verify-replay.ts",
     "check:ci": "npm run test && npm run test:isolation && npm run check:skills && npm run check:dist-ui && npm run check:package && npm run check:query-plans && npm run check:recall-latency && npm run check:install-size && npm run verify:replay && npm run check:hygiene && npm run check:docs && npm run check:crash && npm run bench:verify",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.atifjubaer/fastrmemory",
   "title": "FastrMemory",
   "description": "Local-first cognitive agent memory with bi-temporal SQLite, replayable history, and triple-stream retrieval.",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "websiteUrl": "https://github.com/atifjubaer/fastrmemory",
   "repository": {
     "url": "https://github.com/atifjubaer/fastrmemory",

package/skills/skills.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://skills.sh/schema/v1.json",
   "name": "fastrmemory-skills",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Agent Skills that teach coding agents when to recall, log traps, curate, and commit FastrMemory.",
   "author": "Fastrsoft",
   "license": "Apache-2.0",