@tenphi/akno-core 0.1.0

package/dist/ops/read.js

@@ -0,0 +1,271 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { annotateLines, LINE_FACT_COLUMNS } from "../kb/line-facts.js";
+import { AknoError, ReadInput } from '@tenphi/akno-protocol';
+import { documentAvailability } from "../ingest/availability.js";
+/**
+ * `read({slug})` returns the full body of a `source` page every time.
+ * The role governs only what recall pulls in unprompted — **this is a relevance
+ * policy, not access control.**
+ */
+export async function read(ctx, rawInput) {
+    const input = ReadInput.parse(rawInput);
+    if (input.document)
+        return readDocument(ctx, input.document);
+    return readPage(ctx, input);
+}
+function readPage(ctx, input) {
+    const row = (input.slug
+        ? ctx.store.db.prepare(SELECT_PAGE + ' WHERE slug = ?').get(input.slug)
+        : ctx.store.db.prepare(SELECT_PAGE + ' WHERE id = ?').get(input.id));
+    if (!row) {
+        throw new AknoError('not_found', `no page at ${input.slug ?? input.id}`, {
+            // A near-miss list turns "not found" into something the caller can act on
+            // instead of guessing again.
+            nearest: nearestSlugs(ctx, input.slug ?? ''),
+        });
+    }
+    let content;
+    try {
+        content = fs.readFileSync(path.join(ctx.config.aknoPath, row.rel_path), 'utf8');
+    }
+    catch (err) {
+        // The index says it exists and the file does not. That is `unavailable`, not
+        // `not_found`: the knowledge base did record this, and the caller should say
+        // so rather than "there is nothing about that".
+        throw new AknoError('unavailable', `${row.slug} is indexed but could not be read: ${message(err)}`);
+    }
+    const allLines = content.split('\n');
+    const from = input.from_line ?? 1;
+    const to = input.to_line ?? allLines.length;
+    const lines = allLines
+        .slice(from - 1, to)
+        .map((text, index) => ({ n: from + index, text }))
+        .filter((line) => line.text.length > 0 || line.n === from);
+    const facts = ctx.store.db
+        .prepare(`SELECT ${LINE_FACT_COLUMNS} FROM facts WHERE page_id = ?
+        AND EXISTS (
+          SELECT 1 FROM pages current_page
+           WHERE current_page.id = facts.page_id
+             AND current_page.derived_hash = current_page.body_hash
+        )`)
+        .all(row.id);
+    const withConfidence = annotateLines(lines, facts);
+    const links = ctx.store.db
+        .prepare('SELECT DISTINCT to_slug, broken FROM links WHERE from_page = ?')
+        .all(row.id);
+    const backlinks = ctx.store.db
+        .prepare('SELECT DISTINCT p.slug FROM links l JOIN pages p ON p.id = l.from_page WHERE l.to_page = ?')
+        .all(row.id);
+    const documents = ctx.store.db
+        .prepare(`SELECT id, rel_path, mime, label, page_count, group_key, renders, text,
+              availability, missing_since
+         FROM documents WHERE page_id = ?`)
+        .all(row.id);
+    const superseded = facts
+        .filter((fact) => fact.valid_to !== null)
+        .map((fact) => ({ claim: fact.claim, valid_to: fact.valid_to }));
+    return {
+        status: 'ok',
+        page: {
+            id: row.id,
+            slug: row.slug,
+            title: row.title,
+            type: row.type,
+            tags: JSON.parse(row.tags),
+            role: row.role,
+            management: { remember: row.remember_management, dream: row.dream_management },
+            about: JSON.parse(row.about),
+            aliases: JSON.parse(row.aliases),
+            frontmatter: JSON.parse(row.frontmatter),
+            summary: row.summary,
+            ...(row.keywords ? { keywords: JSON.parse(row.keywords) } : {}),
+            lines: withConfidence,
+            source_fence_line: row.source_fence_line,
+            links: links.filter((link) => link.broken === 0).map((link) => link.to_slug),
+            backlinks: backlinks.map((link) => link.slug),
+            ...(links.some((l) => l.broken === 1)
+                ? { broken_links: links.filter((l) => l.broken === 1).map((l) => l.to_slug) }
+                : {}),
+            ...(superseded.length > 0 ? { superseded } : {}),
+            ...(documents.length > 0
+                ? {
+                    documents: documents.map((doc) => ({
+                        id: doc.id,
+                        rel_path: doc.rel_path,
+                        ...(doc.mime ? { mime: doc.mime } : {}),
+                        ...(doc.label ? { label: doc.label } : {}),
+                        ...(doc.page_count !== null ? { pages: doc.page_count } : {}),
+                        availability: availabilityForDocument(ctx, doc),
+                    })),
+                }
+                : {}),
+            ...(row.updated_at ? { updated: row.updated_at.slice(0, 10) } : {}),
+            bytes: row.bytes,
+        },
+    };
+}
+const SELECT_DOCUMENT = `SELECT d.id, d.rel_path, d.mime, d.sha256, d.label, d.text, d.page_count,
+                                d.ocr, d.bytes, d.group_key, d.renders, p.slug,
+                                d.availability, d.missing_since
+                           FROM documents d LEFT JOIN pages p ON p.id = d.page_id`;
+/**
+ * A document by id, by its path in the knowledge base, or by its bare filename.
+ *
+ * Someone who has just read a page is holding three handles on the same file and has no
+ * reason to prefer one: the `id` in `documents[]`, the `rel_path` beside it, and the
+ * basename inside the `![[…]]` embed in the body. The embed is the most visible of the
+ * three and used to be the only one that did not work, so the two-call route — read the
+ * page, then read its document — dead-ended on a `not_found` that said only that the id was
+ * wrong, with nothing to try next.
+ *
+ * A bare filename resolves only when exactly one file matches. Quietly picking one of two
+ * `lease.pdf`s would answer a question about one document with the text of another, which
+ * is worse than the error.
+ */
+function resolveDocument(ctx, handle) {
+    const exact = ctx.store.db
+        .prepare(`${SELECT_DOCUMENT} WHERE d.id = ? OR d.rel_path = ?`)
+        .get(handle, handle);
+    if (exact)
+        return exact;
+    const byName = ctx.store.db
+        .prepare(`${SELECT_DOCUMENT} WHERE d.rel_path LIKE '%/' || ? LIMIT 5`)
+        .all(handle);
+    if (byName.length === 1)
+        return byName[0];
+    if (byName.length > 1) {
+        throw new AknoError('invalid', `${byName.length} documents are called ${handle} — name the path`, {
+            matches: byName.map((row) => row.rel_path),
+        });
+    }
+    const leaf = handle.split('/').pop() ?? handle;
+    const nearest = ctx.store.db
+        .prepare('SELECT rel_path FROM documents WHERE rel_path LIKE ? LIMIT 5')
+        .all(`%${leaf}%`);
+    throw new AknoError('not_found', `no document at ${handle}`, {
+        ...(nearest.length > 0 ? { nearest: nearest.map((row) => row.rel_path) } : {}),
+    });
+}
+function readDocument(ctx, documentId) {
+    const found = resolveDocument(ctx, documentId);
+    // Asking for the text file beside a contract is asking for the contract. It holds a copy
+    // of the same text, and answering from the copy would make which of the two you happened
+    // to name matter.
+    const row = found.renders ? resolveDocument(ctx, found.renders) : found;
+    // A document someone's scanner cut into `passport.pdf` and `passport-2.pdf` is one
+    // document, so reading any part returns the whole of it: the text of every part in order,
+    // the total page count, and the other parts' paths. Asking for a passport and getting
+    // half of it, with nothing saying so, is the failure this avoids.
+    //
+    // Renditions are not parts. `contract.pdf.txt` carries the same text as `contract.pdf`,
+    // so joining it in would return the contract twice and count it as a part that could not
+    // be read.
+    const parts = ctx.store.db
+        .prepare(`SELECT id, rel_path, text, page_count, ocr, availability, missing_since FROM documents
+        WHERE group_key = ? AND renders IS NULL ORDER BY part`)
+        .all(row.group_key ?? row.rel_path);
+    const availability = documentAvailability(ctx.store.db, parts);
+    const readable = parts
+        .map((part) => ({ ...part, readableText: part.text ?? renditionTextFor(ctx, part.rel_path) }))
+        .filter((part) => part.readableText !== null);
+    const text = readable.length > 0 ? readable.map((part) => part.readableText).join('\n\n') : null;
+    const pageCount = parts.reduce((sum, part) => (part.page_count === null ? sum : (sum ?? 0) + part.page_count), null);
+    const notes = [];
+    if (availability.status !== 'available') {
+        notes.push(`original file${availability.missing_originals.length === 1 ? '' : 's'} missing: ` +
+            availability.missing_originals.join(', '));
+    }
+    if (text === null) {
+        notes.push('nothing could be read from this file — a photo with no text in it, or a format with no extractor');
+    }
+    else if (readable.length < parts.length) {
+        // Partial is a result, not a failure — but a caller reasoning over half a contract has
+        // to know which half it has.
+        notes.push(`${parts.length - readable.length} of ${parts.length} parts could not be read: ` +
+            parts
+                .filter((part) => part.text === null)
+                .map((part) => part.rel_path)
+                .join(', '));
+    }
+    if (parts.length > 1) {
+        notes.push(`${parts.length} files, read as one document: ${parts.map((part) => part.rel_path).join(', ')}`);
+    }
+    const status = availability.status === 'unavailable'
+        ? 'unavailable'
+        : availability.status === 'degraded' || readable.length < parts.length
+            ? 'degraded'
+            : 'ok';
+    const degraded = [];
+    if (availability.status === 'degraded')
+        degraded.push('document_source_missing');
+    if (text === null || readable.length < parts.length)
+        degraded.push('no_document_text');
+    return {
+        status,
+        // Extraction is a built-in reader, not a model call — so a file nothing could be read
+        // from is its own kind of degraded, and pointing at a model would send someone to
+        // configure one that would not have helped.
+        ...(status === 'degraded' && degraded.length > 0 ? { degraded } : {}),
+        ...(notes.length > 0 ? { note: notes.join('. ') } : {}),
+        document: {
+            id: row.id,
+            page: row.slug,
+            rel_path: row.rel_path,
+            mime: row.mime,
+            sha256: row.sha256,
+            label: row.label,
+            page_count: pageCount,
+            ocr: parts.some((part) => part.ocr === 1),
+            text,
+            bytes: row.bytes,
+            availability,
+        },
+    };
+}
+function availabilityForDocument(ctx, row) {
+    const source = row.renders ? resolveDocument(ctx, row.renders) : row;
+    const parts = ctx.store.db
+        .prepare(`SELECT rel_path, text, availability, missing_since FROM documents
+        WHERE group_key = ? AND renders IS NULL ORDER BY part`)
+        .all(source.group_key ?? source.rel_path);
+    return documentAvailability(ctx.store.db, parts.length > 0 ? parts : [source]);
+}
+/** Read a surviving rendition only when the indexed extraction itself is gone. */
+function renditionTextFor(ctx, sourcePath) {
+    const row = ctx.store.db
+        .prepare(`SELECT rel_path FROM documents
+        WHERE renders = ? AND availability = 'available'
+        ORDER BY rel_path LIMIT 1`)
+        .get(sourcePath);
+    if (!row)
+        return null;
+    try {
+        const content = fs.readFileSync(path.join(ctx.config.aknoPath, row.rel_path), 'utf8');
+        if (!content.startsWith('# Extracted text of '))
+            return content;
+        const bodyAt = content.indexOf('\n\n');
+        return bodyAt === -1 ? content : content.slice(bodyAt + 2).replace(/\n$/, '');
+    }
+    catch {
+        return null;
+    }
+}
+const SELECT_PAGE = `SELECT id, slug, rel_path, title, type, tags, role, remember_management,
+                            dream_management, about, aliases, frontmatter, summary,
+                            keywords, source_fence_line, bytes, updated_at
+                       FROM pages`;
+/** Cheap prefix and substring match. Good enough to catch a typo or a wrong folder. */
+function nearestSlugs(ctx, slug) {
+    if (slug.length === 0)
+        return [];
+    const leaf = slug.split('/').pop() ?? slug;
+    const rows = ctx.store.db
+        .prepare('SELECT slug FROM pages WHERE slug LIKE ? OR slug LIKE ? LIMIT 5')
+        .all(`%${leaf}%`, `${slug}%`);
+    return rows.map((row) => row.slug);
+}
+function message(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=read.js.map

package/dist/ops/read.js.map

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

package/dist/ops/recall.d.ts

@@ -0,0 +1,13 @@
+import { type RecallOutput } from '@tenphi/akno-protocol';
+import type { AknoContext } from '../context.ts';
+/**
+ * The retrieval op. Expand → hybrid search → rerank → assemble → fit a
+ * budget. `mode` selects the expansion strategy and is inferred from the query
+ * by default.
+ *
+ * Four properties matter more here than ranking quality: every line carries its
+ * address, absence has a reason, superseded values come back labelled, and one
+ * budget governs the whole assembly.
+ */
+export declare function recall(ctx: AknoContext, rawInput: unknown): Promise<RecallOutput>;
+//# sourceMappingURL=recall.d.ts.map

package/dist/ops/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/ops/recall.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EAElB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAkOvF"}

package/dist/ops/recall.js

@@ -0,0 +1,297 @@
+import { RecallInput, } from '@tenphi/akno-protocol';
+import { indexDegradation } from "../context.js";
+import { expandQuery, inferMode, splitMultiPart } from "../recall/expand.js";
+import { graphRecallCandidates } from "../recall/graph-arm.js";
+import { fuseHits, hybridSearch, normalizeScores, rerankHits } from "../recall/search.js";
+/**
+ * The retrieval op. Expand → hybrid search → rerank → assemble → fit a
+ * budget. `mode` selects the expansion strategy and is inferred from the query
+ * by default.
+ *
+ * Four properties matter more here than ranking quality: every line carries its
+ * address, absence has a reason, superseded values come back labelled, and one
+ * budget governs the whole assembly.
+ */
+export async function recall(ctx, rawInput) {
+    const input = RecallInput.parse(rawInput);
+    const mode = input.mode ?? inferMode(input.query);
+    const depth = input.depth ?? (mode === 'explore' ? 'summary' : 'lines');
+    const limit = input.limit ?? (mode === 'explore' ? ctx.config.recall.defaultLimit * 2 : ctx.config.recall.defaultLimit);
+    const budget = input.budget ?? ctx.config.recall.defaultBudget;
+    const degraded = new Set();
+    const notes = [];
+    // A knowledge base with nothing in it is `empty`, not a failure — but it must
+    // not be confused with an index that could not be read.
+    const chunkCount = ctx.store.db.prepare('SELECT count(*) AS c FROM chunks').get().c;
+    if (chunkCount === 0) {
+        return {
+            status: 'empty',
+            results: [],
+            searched: [input.query],
+            budget_used: 0,
+            mode,
+            scores: 'relative',
+            note: 'the index holds no chunks yet — run `akno index`',
+        };
+    }
+    // Multi-part questions are split and searched separately, then merged.
+    const parts = mode === 'question' ? splitMultiPart(input.query) : [input.query];
+    const allQueries = [];
+    const allVectorTexts = [];
+    const allConcepts = [];
+    for (const part of parts) {
+        const expansion = await expandQuery(part, mode, ctx.models.expansion, input.expand ?? ctx.config.recall.expansion, ctx.config.recall.expansionTimeoutMs);
+        allQueries.push(...expansion.queries);
+        allVectorTexts.push(...expansion.vectorTexts);
+        allConcepts.push(...expansion.concepts);
+        if (expansion.degraded)
+            degraded.add(expansion.degraded);
+        if (expansion.note)
+            notes.push(expansion.note);
+    }
+    const chunkIds = resolveFilter(ctx, input);
+    if (chunkIds !== null && chunkIds.size === 0) {
+        return {
+            status: 'empty',
+            results: [],
+            searched: dedupe(allQueries),
+            budget_used: 0,
+            mode,
+            scores: 'relative',
+            note: 'the filter matched no indexed evidence',
+        };
+    }
+    let search;
+    try {
+        search = await hybridSearch(ctx.store, ctx.models.embedding, {
+            queries: dedupe(allQueries),
+            vectorTexts: dedupe(allVectorTexts),
+            candidatesPerArm: ctx.config.recall.candidatesPerArm,
+            prefilterAbove: ctx.config.index.annThresholdChunks,
+            ...(chunkIds ? { chunkIds } : {}),
+        });
+    }
+    catch (err) {
+        // The index could not be read. Say so — an agent can honestly offer to check
+        // again, which it cannot do if this returns as "nothing recorded".
+        return {
+            status: 'unavailable',
+            results: [],
+            searched: dedupe(allQueries),
+            budget_used: 0,
+            mode,
+            scores: 'relative',
+            note: err instanceof Error ? err.message : String(err),
+        };
+    }
+    for (const reason of search.degraded)
+        degraded.add(reason);
+    notes.push(...search.notes);
+    let hits = search.hits;
+    if (input.graph ?? ctx.config.recall.graph) {
+        try {
+            const graphResult = await graphRecallCandidates(ctx, input.query, search.hits, chunkIds ?? undefined);
+            for (const reason of graphResult.degraded)
+                degraded.add(reason);
+            notes.push(...graphResult.notes);
+            if (graphResult.hits.length > 0)
+                hits = fuseHits([...search.arms, graphResult.hits]);
+        }
+        catch {
+            // Graph retrieval is an optional candidate arm. Its failure weakens recall, but must not erase the
+            // lexical and vector evidence that is still readable or pretend their result proves absence.
+            degraded.add('no_graph_index');
+            notes.push('the structural graph candidate arm was unavailable');
+        }
+    }
+    let reranked = false;
+    let qualification = null;
+    const shouldRerank = input.rerank ?? true;
+    if (shouldRerank && hits.length > 0 && ctx.models.reranker.available) {
+        const result = await rerankHits(ctx.store, ctx.models.reranker, input.query, hits, ctx.config.models.reranker.topK ?? 40, ctx.config.models.reranker.maxChars ?? 800, ctx.config.models.reranker.scoreOffset ?? 'auto', ctx.config.models.reranker.excludeIrrelevant ?? true);
+        hits = result.hits;
+        qualification = result.qualification;
+        reranked = result.degraded === null;
+        if (result.degraded)
+            degraded.add(result.degraded);
+        if (result.note)
+            notes.push(result.note);
+    }
+    else if (shouldRerank && ctx.models.reranker.requested && !ctx.models.reranker.available) {
+        // `requested` rather than `enabled`: the resolved `enabled` is already false
+        // whenever the role is unusable, so testing it here could never fire and a
+        // user who asked for a reranker would never be told they are not getting one.
+        degraded.add(ctx.models.reranker.degradedReason({}));
+        if (ctx.models.reranker.unavailableReason)
+            notes.push(ctx.models.reranker.unavailableReason);
+    }
+    // Fused ranks only mean something relative to each other, so put them on a
+    // readable scale when a cross-encoder did not supply an absolute one. `relevance`
+    // survives this untouched — it is the field a caller may threshold.
+    if (!reranked)
+        hits = normalizeScores(hits);
+    const scores = hits.some((hit) => hit.relevance !== undefined)
+        ? 'absolute'
+        : 'relative';
+    const assembled = ctx.assembler.assemble({
+        hits,
+        mode,
+        depth,
+        // A lookup wants deep line windows around what matched; a question wants
+        // tight ones across more cards, because the answer is usually one line and
+        // the surrounding paragraph is budget spent on nothing.
+        lineWindow: mode === 'question'
+            ? Math.max(2, Math.ceil(ctx.config.recall.lineWindow / 2))
+            : ctx.config.recall.lineWindow,
+        limit,
+        budget,
+        concepts: dedupe(allConcepts),
+        include: input.include ?? null,
+    });
+    const documentStates = assembled.results.flatMap((result) => result.type === 'document'
+        ? result.availability
+            ? [result.availability]
+            : []
+        : (result.documents ?? []).flatMap((document) => document.availability ? [document.availability] : []));
+    const hasMissingDocumentEvidence = documentStates.some((state) => state.status !== 'available');
+    if (hasMissingDocumentEvidence) {
+        degraded.add('document_source_missing');
+    }
+    for (const reason of indexDegradation(ctx.store))
+        degraded.add(reason);
+    const reasons = [...degraded];
+    const searched = dedupe(allQueries);
+    if (assembled.results.length === 0) {
+        // `empty` carries the expanded queries that found nothing. That list is the
+        // proof an agent needs to say "not recorded" honestly.
+        return {
+            status: reasons.length > 0 ? 'degraded' : 'empty',
+            ...(reasons.length > 0 ? { degraded: reasons } : {}),
+            results: [],
+            searched,
+            budget_used: 0,
+            mode,
+            scores,
+            ...(assembled.coverage ? { coverage: assembled.coverage } : {}),
+            ...(qualification ? { qualification } : {}),
+            note: reasons.length > 0
+                ? 'nothing matched, and the search ran without part of its model stack — this is not proof of absence'
+                : qualification?.applied && qualification.rejected > 0
+                    ? `the reranker disqualified all ${qualification.rejected} judged candidates as irrelevant`
+                    : 'nothing matched any of the queries listed in `searched`',
+        };
+    }
+    const unavailableOnly = assembled.results.every((result) => result.type === 'document' && result.availability?.status === 'unavailable');
+    if (unavailableOnly) {
+        return {
+            status: 'unavailable',
+            results: assembled.results,
+            searched,
+            budget_used: assembled.budgetUsed,
+            mode,
+            scores,
+            ...(assembled.coverage ? { coverage: assembled.coverage } : {}),
+            ...(qualification ? { qualification } : {}),
+            note: 'matching document records remain, but neither their originals nor a readable copy are available',
+        };
+    }
+    return {
+        status: reasons.length > 0 ? 'degraded' : 'ok',
+        ...(reasons.length > 0 ? { degraded: reasons } : {}),
+        results: assembled.results,
+        searched,
+        budget_used: assembled.budgetUsed,
+        mode,
+        scores,
+        ...(assembled.coverage ? { coverage: assembled.coverage } : {}),
+        ...(qualification ? { qualification } : {}),
+        ...(hasMissingDocumentEvidence
+            ? {
+                note: 'some document evidence is retained from an indexed copy or rendition because its original is missing',
+            }
+            : {}),
+    };
+}
+/** Filters resolve to native chunk identities so both page and document evidence can participate. */
+function resolveFilter(ctx, input) {
+    const filter = input.filter;
+    const hasFilter = Boolean(filter?.folder ||
+        filter?.type ||
+        filter?.tags?.length ||
+        filter?.role ||
+        filter?.source ||
+        filter?.ownership ||
+        input.since ||
+        input.until);
+    if (!hasFilter)
+        return null;
+    const clauses = [];
+    const params = [];
+    if (filter?.folder) {
+        clauses.push(`((c.document_id IS NULL AND (p.slug = ? OR p.slug LIKE ?))
+         OR (c.document_id IS NOT NULL AND (d.rel_path = ? OR d.rel_path LIKE ?)))`);
+        params.push(filter.folder, `${filter.folder}/%`, filter.folder, `${filter.folder}/%`);
+    }
+    if (filter?.type) {
+        clauses.push('p.type = ?');
+        params.push(filter.type);
+    }
+    if (filter?.role) {
+        // NULL never equals a role, so orphan documents are explicitly excluded.
+        clauses.push('p.role = ?');
+        params.push(filter.role);
+    }
+    if (filter?.source === 'page')
+        clauses.push('c.document_id IS NULL');
+    if (filter?.source === 'document')
+        clauses.push('c.document_id IS NOT NULL');
+    if (filter?.ownership === 'orphan') {
+        clauses.push('c.document_id IS NOT NULL AND d.page_id IS NULL');
+    }
+    if (filter?.ownership === 'owned')
+        clauses.push('c.page_id IS NOT NULL');
+    if (input.since) {
+        clauses.push(`(CASE WHEN c.document_id IS NULL THEN p.updated_at
+             ELSE datetime(CAST(f.mtime_ns AS INTEGER) / 1000000000, 'unixepoch') END) >= ?`);
+        params.push(input.since);
+    }
+    if (input.until) {
+        // A `YYYY-MM` bound means "through the end of that month".
+        clauses.push(`(CASE WHEN c.document_id IS NULL THEN p.updated_at
+             ELSE datetime(CAST(f.mtime_ns AS INTEGER) / 1000000000, 'unixepoch') END) <= ?`);
+        params.push(`${input.until}￿`);
+    }
+    const sql = `SELECT c.id, p.tags
+                 FROM chunks c
+                 LEFT JOIN pages p ON p.id = c.page_id
+                 LEFT JOIN documents d ON d.id = c.document_id
+                 LEFT JOIN files f ON f.rel_path = d.rel_path
+                ${clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : ''}`;
+    const rows = ctx.store.db.prepare(sql).all(...params);
+    const wanted = filter?.tags?.map((tag) => tag.toLowerCase()) ?? [];
+    const ids = new Set();
+    for (const row of rows) {
+        if (wanted.length > 0) {
+            if (!row.tags)
+                continue;
+            const tags = JSON.parse(row.tags).map((tag) => tag.toLowerCase());
+            if (!wanted.every((tag) => tags.includes(tag)))
+                continue;
+        }
+        ids.add(row.id);
+    }
+    return ids;
+}
+function dedupe(values) {
+    const seen = new Set();
+    const out = [];
+    for (const value of values) {
+        const key = value.toLowerCase().trim();
+        if (key.length === 0 || seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(value);
+    }
+    return out;
+}
+//# sourceMappingURL=recall.js.map

package/dist/ops/recall.js.map

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