obsidian-anchor 0.2.0

package/dist/index.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createContext } from "./container.js";
+import { VaultWatcher } from "./index/watcher.js";
+import { buildServer, SERVER_NAME, SERVER_VERSION } from "./server.js";
+import { logger } from "./util/logger.js";
+let watcher;
+let shuttingDown = false;
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    const positionals = [];
+    const config = {};
+    let reindex = false;
+    const num = (raw) => {
+        if (raw === undefined)
+            return undefined;
+        const value = Number(raw);
+        return Number.isFinite(value) ? value : undefined;
+    };
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === undefined)
+            continue;
+        switch (arg) {
+            case "--reindex":
+                reindex = true;
+                break;
+            case "--watch-polling":
+                process.env.ANCHOR_WATCH_POLLING = "1";
+                break;
+            case "--verifier": {
+                const value = args[(i += 1)];
+                if (value)
+                    process.env.ANCHOR_VERIFIER = value;
+                break;
+            }
+            case "--embedding": {
+                const value = args[(i += 1)];
+                if (value)
+                    process.env.ANCHOR_EMBEDDING = value;
+                break;
+            }
+            case "--knn": {
+                const value = num(args[(i += 1)]);
+                if (value !== undefined)
+                    config.knn = value;
+                break;
+            }
+            case "--grounded-threshold": {
+                const value = num(args[(i += 1)]);
+                if (value !== undefined)
+                    config.grounded = value;
+                break;
+            }
+            case "--refuse-threshold": {
+                const value = num(args[(i += 1)]);
+                if (value !== undefined)
+                    config.refuse = value;
+                break;
+            }
+            case "--evidence-min-score": {
+                const value = num(args[(i += 1)]);
+                if (value !== undefined)
+                    config.evidenceMinScore = value;
+                break;
+            }
+            case "--verify-timeout-ms": {
+                const value = num(args[(i += 1)]);
+                if (value !== undefined)
+                    config.verifyTimeoutMs = value;
+                break;
+            }
+            default:
+                if (!arg.startsWith("-"))
+                    positionals.push(arg);
+                break;
+        }
+    }
+    return { vaultPath: positionals[0], reindex, config };
+}
+function installGlobalErrorHandlers() {
+    process.on("unhandledRejection", (reason) => {
+        logger.error("Unhandled promise rejection", {
+            reason: reason instanceof Error ? reason.message : String(reason),
+        });
+    });
+    process.on("uncaughtException", (error) => {
+        logger.error("Uncaught exception", { error: error.message });
+        process.exit(1);
+    });
+}
+function installShutdownHandlers(context) {
+    let closing = false;
+    const closeDb = () => {
+        try {
+            context?.db.close();
+        }
+        catch (error) {
+            logger.error("Error closing the index database", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    };
+    const shutdown = (reason, forceExit) => {
+        if (closing)
+            return;
+        closing = true;
+        shuttingDown = true;
+        logger.info(`Shutting down (${reason})`);
+        if (forceExit) {
+            void watcher?.stop();
+            closeDb();
+            process.exit(0);
+            return;
+        }
+        // stdin-close: stop the watcher, wait for any in-flight initial index to
+        // settle, then close the DB and let the event loop drain so final responses
+        // still flush. `shuttingDown` prevents the index pass from starting a new
+        // watcher afterwards.
+        void (async () => {
+            await watcher?.stop();
+            const indexing = context?.indexing;
+            if (indexing) {
+                try {
+                    await indexing;
+                }
+                catch {
+                    // already logged during indexing
+                }
+            }
+            closeDb();
+        })();
+    };
+    process.on("SIGINT", () => { shutdown("SIGINT", true); });
+    process.on("SIGTERM", () => { shutdown("SIGTERM", true); });
+    // The MCP client closing stdin (EOF) is also a shutdown signal — otherwise the
+    // persistent file watcher keeps the process alive after the client exits.
+    process.stdin.on("end", () => { shutdown("stdin closed", false); });
+    process.stdin.on("close", () => { shutdown("stdin closed", false); });
+}
+async function main() {
+    installGlobalErrorHandlers();
+    const { vaultPath, reindex, config } = parseArgs(process.argv);
+    let context;
+    if (vaultPath) {
+        const absVault = resolve(vaultPath);
+        logger.info("Starting Anchor", { vaultPath: absVault });
+        const ctx = createContext(absVault, { config, reindex });
+        context = ctx;
+        installShutdownHandlers(ctx);
+        // Index in the BACKGROUND so a large vault never blocks the MCP initialize
+        // handshake. Vault-backed tools await `context.indexing` before serving, so
+        // an early call simply waits for the first index pass to finish. Once the
+        // initial pass is done, watch the vault to keep the index live.
+        ctx.indexing = ctx.indexer
+            .indexAll()
+            .then((stats) => {
+            logger.info("Vault indexed", stats);
+            if (shuttingDown)
+                return;
+            watcher = new VaultWatcher(absVault, ctx.indexer, {
+                // Set ANCHOR_WATCH_POLLING=1 on filesystems without native fs events
+                // (network drives, WSL, Docker volumes).
+                usePolling: process.env.ANCHOR_WATCH_POLLING === "1",
+            });
+            watcher.start();
+            logger.info("Watching vault for changes");
+        })
+            .catch((error) => {
+            logger.error("Initial indexing failed", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        });
+    }
+    else {
+        installShutdownHandlers(undefined);
+        logger.warn("No vault path provided; starting in no-vault mode (only the ping tool is available). " +
+            "Usage: obsidian-anchor <path-to-vault>");
+    }
+    const server = buildServer(context);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info(`Anchor MCP server ready (${SERVER_NAME} v${SERVER_VERSION})`);
+}
+main().catch((error) => {
+    logger.error("Fatal error during startup", {
+        error: error instanceof Error ? error.message : String(error),
+    });
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.js

@@ -0,0 +1,61 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { registerCite } from "./tools/cite.js";
+import { registerRestoreNote } from "./tools/restoreNote.js";
+import { registerSafeEdit } from "./tools/safeEdit.js";
+import { registerSearchNotes } from "./tools/searchNotes.js";
+import { registerVerifyGrounding } from "./tools/verifyGrounding.js";
+import { logger } from "./util/logger.js";
+export const SERVER_NAME = "anchor";
+export const SERVER_VERSION = "0.2.0";
+/**
+ * Builds the Anchor MCP server with its tools registered.
+ *
+ * The server is transport-agnostic: callers attach a transport (stdio in
+ * production, in-memory in tests) via `server.connect(...)`. Vault-backed tools
+ * are registered only when an {@link AppContext} is supplied.
+ */
+export function buildServer(context) {
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    registerPingTool(server);
+    if (context) {
+        registerSearchNotes(server, context);
+        registerVerifyGrounding(server, context);
+        registerCite(server, context);
+        registerSafeEdit(server, context);
+        registerRestoreNote(server, context);
+    }
+    return server;
+}
+/**
+ * A trivial health-check tool. It exists so the server boot, tool registration,
+ * and transport handshake can be validated end-to-end before any real tooling
+ * (search / grounding) lands.
+ */
+function registerPingTool(server) {
+    server.registerTool("ping", {
+        title: "Ping",
+        description: "Health check. Returns pong plus the server name and version.",
+        inputSchema: {},
+        outputSchema: {
+            pong: z.literal(true),
+            server: z.string(),
+            version: z.string(),
+        },
+    }, () => {
+        logger.debug("ping invoked");
+        const payload = {
+            pong: true,
+            server: SERVER_NAME,
+            version: SERVER_VERSION,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload) }],
+            structuredContent: payload,
+        };
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAoB;IAC9C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,IAAI,OAAO,EAAE,CAAC;QACZ,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,MAAiB;IACzC,MAAM,CAAC,YAAY,CACjB,MAAM,EACN;QACE,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,EAAE;QACf,YAAY,EAAE;YACZ,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACpB;KACF,EACD,GAAG,EAAE;QACH,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC7B,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,IAAa;YACnB,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,cAAc;SACxB,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1D,iBAAiB,EAAE,OAAO;SAC3B,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/store/chunkStore.js

@@ -0,0 +1,82 @@
+// Column aliasing so rows hydrate directly into StoredChunk (camelCase) fields.
+const HYDRATE_COLUMNS = "chunk_id AS chunkId, path AS notePath, heading_path AS headingPath, " +
+    "block_id AS blockId, anchor, ordinal, char_start AS charStart, char_end AS charEnd, text";
+/**
+ * Owns the relational side of the index: notes, chunks, and their wikilinks.
+ * Vector rows live in {@link VectorStore} and are keyed by the same chunk id.
+ */
+export class ChunkStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Inserts a note row and returns its id. Caller ensures the path is new. */
+    insertNote(note, indexedAt) {
+        const result = this.db
+            .prepare("INSERT INTO notes (path, mtime_ms, content_hash, indexed_at) VALUES (?, ?, ?, ?)")
+            .run(note.path, note.mtimeMs, note.contentHash, indexedAt);
+        return Number(result.lastInsertRowid);
+    }
+    /** Inserts one chunk (and its wikilinks); returns the new chunk id. */
+    insertChunk(noteId, chunk) {
+        const result = this.db
+            .prepare("INSERT INTO chunks " +
+            "(note_id, path, heading_path, block_id, anchor, ordinal, char_start, char_end, text, token_est) " +
+            "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)")
+            .run(noteId, chunk.meta.path, chunk.meta.headingPath, chunk.meta.blockId, chunk.meta.anchor, chunk.ordinal, chunk.charStart, chunk.charEnd, chunk.text, chunk.tokenEst);
+        const chunkId = Number(result.lastInsertRowid);
+        this.insertWikilinks(chunkId, chunk);
+        return chunkId;
+    }
+    insertWikilinks(chunkId, chunk) {
+        if (chunk.meta.wikilinks.length === 0)
+            return;
+        const stmt = this.db.prepare("INSERT INTO wikilinks (chunk_id, target_note, target_anchor, alias) VALUES (?, ?, ?, ?)");
+        for (const link of chunk.meta.wikilinks) {
+            stmt.run(chunkId, link.targetNote, link.targetAnchor, link.alias);
+        }
+    }
+    /** Looks up a note id by path, or undefined if not indexed. */
+    getNoteId(path) {
+        const row = this.db.prepare("SELECT note_id AS id FROM notes WHERE path = ?").get(path);
+        return row?.id;
+    }
+    /** Returns every indexed note (id + path), e.g. to prune ones deleted on disk. */
+    getAllNotes() {
+        return this.db.prepare("SELECT note_id AS noteId, path FROM notes").all();
+    }
+    /** Looks up a note's id and content hash by path (for incremental indexing). */
+    getNote(path) {
+        return this.db
+            .prepare("SELECT note_id AS noteId, content_hash AS contentHash FROM notes WHERE path = ?")
+            .get(path);
+    }
+    /** Returns the chunk ids belonging to a note. */
+    getChunkIdsForNote(noteId) {
+        const rows = this.db
+            .prepare("SELECT chunk_id AS id FROM chunks WHERE note_id = ?")
+            .all(noteId);
+        return rows.map((r) => r.id);
+    }
+    getChunk(chunkId) {
+        return this.db.prepare(`SELECT ${HYDRATE_COLUMNS} FROM chunks WHERE chunk_id = ?`).get(chunkId);
+    }
+    /** Hydrates chunks by id, preserving the given id order and dropping misses. */
+    hydrate(chunkIds) {
+        if (chunkIds.length === 0)
+            return [];
+        const placeholders = chunkIds.map(() => "?").join(", ");
+        const rows = this.db
+            .prepare(`SELECT ${HYDRATE_COLUMNS} FROM chunks WHERE chunk_id IN (${placeholders})`)
+            .all(...chunkIds);
+        const byId = new Map(rows.map((r) => [r.chunkId, r]));
+        return chunkIds
+            .map((id) => byId.get(id))
+            .filter((c) => c !== undefined);
+    }
+    /** Deletes a note row by id (cascades chunks + wikilinks via foreign keys). */
+    deleteNoteRow(noteId) {
+        this.db.prepare("DELETE FROM notes WHERE note_id = ?").run(noteId);
+    }
+}
+//# sourceMappingURL=chunkStore.js.map

package/dist/store/chunkStore.js.map

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

package/dist/store/db.js

@@ -0,0 +1,59 @@
+import Database from "better-sqlite3";
+import * as sqliteVec from "sqlite-vec";
+import { logger } from "../util/logger.js";
+import { FALLBACK_VEC_SCHEMA_SQL, RELATIONAL_SCHEMA_SQL, SCHEMA_VERSION, vecSchemaSql } from "./schema.js";
+const IN_MEMORY = ":memory:";
+/**
+ * Opens and migrates the Anchor index database. It tries to load the sqlite-vec
+ * native extension; if that fails on this platform, it falls back to a pure-JS
+ * brute-force vector store so Anchor still works (just slower on large vaults).
+ */
+export function openDb(options) {
+    const db = new Database(options.path);
+    let vectorBackend = "native";
+    try {
+        sqliteVec.load(db);
+        const probe = db.prepare("SELECT vec_version() AS v").get();
+        if (!probe?.v)
+            throw new Error("vec_version() returned no value after load");
+        logger.debug("Vector extension ready", { vecVersion: probe.v });
+    }
+    catch (error) {
+        vectorBackend = "fallback";
+        logger.warn("sqlite-vec native extension unavailable; using the pure-JS vector fallback (slower on large vaults)", { detail: error instanceof Error ? error.message : String(error) });
+    }
+    if (options.path !== IN_MEMORY) {
+        db.pragma("journal_mode = WAL");
+    }
+    db.pragma("synchronous = NORMAL");
+    db.pragma("foreign_keys = ON");
+    migrate(db, options, vectorBackend);
+    return { db, vectorBackend };
+}
+function readMeta(db, key) {
+    const row = db.prepare("SELECT value FROM meta WHERE key = ?").get(key);
+    return row?.value;
+}
+function writeMeta(db, key, value) {
+    db.prepare("INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value").run(key, value);
+}
+function migrate(db, options, backend) {
+    db.exec(RELATIONAL_SCHEMA_SQL);
+    const prevDim = readMeta(db, "embedding_dim");
+    const prevModel = readMeta(db, "embedding_model");
+    const dimChanged = prevDim !== undefined && Number(prevDim) !== options.dim;
+    const modelChanged = prevModel !== undefined && prevModel !== options.embeddingModel;
+    if (dimChanged || modelChanged) {
+        logger.warn("Embedding configuration changed; rebuilding the vector index and clearing the stored index (a re-index is required).", { prevModel, prevDim, model: options.embeddingModel, dim: options.dim });
+        db.exec("DROP TABLE IF EXISTS vec_chunks;");
+        db.exec("DROP TABLE IF EXISTS vec_chunks_js;");
+        // Stored chunks reference embeddings that no longer match the active model;
+        // clear them so the next indexing pass rebuilds everything consistently.
+        db.exec("DELETE FROM chunks; DELETE FROM notes;");
+    }
+    db.exec(backend === "native" ? vecSchemaSql(options.dim) : FALLBACK_VEC_SCHEMA_SQL);
+    writeMeta(db, "schema_version", String(SCHEMA_VERSION));
+    writeMeta(db, "embedding_model", options.embeddingModel);
+    writeMeta(db, "embedding_dim", String(options.dim));
+}
+//# sourceMappingURL=db.js.map

package/dist/store/db.js.map

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

package/dist/store/schema.js

@@ -0,0 +1,67 @@
+// Index database schema. Kept as inlined SQL (rather than a .sql asset) so it
+// ships cleanly in the compiled dist/ output for `npx` distribution.
+export const SCHEMA_VERSION = 1;
+/**
+ * Relational tables + indexes. Dimension-independent and idempotent
+ * (`IF NOT EXISTS`), so it is safe to run on every open.
+ */
+export const RELATIONAL_SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS meta (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS notes (
+  note_id      INTEGER PRIMARY KEY,
+  path         TEXT NOT NULL UNIQUE,
+  mtime_ms     INTEGER NOT NULL,
+  content_hash TEXT NOT NULL,
+  indexed_at   INTEGER NOT NULL
+);
+
+-- One row per chunk == the citation / evidence unit.
+CREATE TABLE IF NOT EXISTS chunks (
+  chunk_id     INTEGER PRIMARY KEY,
+  note_id      INTEGER NOT NULL REFERENCES notes(note_id) ON DELETE CASCADE,
+  path         TEXT NOT NULL,
+  heading_path TEXT,
+  block_id     TEXT,
+  anchor       TEXT NOT NULL,
+  ordinal      INTEGER NOT NULL,
+  char_start   INTEGER NOT NULL,
+  char_end     INTEGER NOT NULL,
+  text         TEXT NOT NULL,
+  token_est    INTEGER NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_chunks_note  ON chunks(note_id);
+CREATE INDEX IF NOT EXISTS idx_chunks_block ON chunks(path, block_id);
+
+CREATE TABLE IF NOT EXISTS wikilinks (
+  chunk_id      INTEGER NOT NULL REFERENCES chunks(chunk_id) ON DELETE CASCADE,
+  target_note   TEXT NOT NULL,
+  target_anchor TEXT,
+  alias         TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_wikilinks_chunk  ON wikilinks(chunk_id);
+CREATE INDEX IF NOT EXISTS idx_wikilinks_target ON wikilinks(target_note);
+`;
+/**
+ * The vec0 virtual table holding chunk embeddings. Its column width is fixed at
+ * creation time, so it is templated by the active embedding dimension and
+ * rebuilt whenever the embedding provider (and thus the dimension) changes.
+ */
+export function vecSchemaSql(dim) {
+    return `CREATE VIRTUAL TABLE IF NOT EXISTS vec_chunks USING vec0(
+  chunk_id INTEGER PRIMARY KEY,
+  embedding float[${dim}]
+);`;
+}
+/**
+ * Fallback embedding table used when the sqlite-vec native extension can't be
+ * loaded. KNN is brute-forced in JS over these blobs (slower, but it works).
+ */
+export const FALLBACK_VEC_SCHEMA_SQL = `CREATE TABLE IF NOT EXISTS vec_chunks_js (
+  chunk_id  INTEGER PRIMARY KEY,
+  embedding BLOB NOT NULL
+);`;
+//# sourceMappingURL=schema.js.map

package/dist/store/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/store/schema.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qEAAqE;AAErE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCpC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO;;oBAEW,GAAG;GACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;GAGpC,CAAC"}

package/dist/store/search.js

@@ -0,0 +1,33 @@
+/**
+ * Semantic search: embed the query, find nearest chunks, and hydrate them with
+ * their Obsidian citation metadata. This is the retrieval primitive reused by
+ * the grounding pipeline ("reuse, don't reinvent" search).
+ */
+export class SearchService {
+    embeddings;
+    vectorStore;
+    chunkStore;
+    constructor(embeddings, vectorStore, chunkStore) {
+        this.embeddings = embeddings;
+        this.vectorStore = vectorStore;
+        this.chunkStore = chunkStore;
+    }
+    async search(query, limit) {
+        const queryVector = await this.embeddings.embedOne(query);
+        const hits = this.vectorStore.knn(queryVector, limit);
+        if (hits.length === 0)
+            return [];
+        const distanceById = new Map(hits.map((hit) => [hit.chunkId, hit.distance]));
+        const stored = this.chunkStore.hydrate(hits.map((hit) => hit.chunkId));
+        return stored.map((chunk) => {
+            const distance = distanceById.get(chunk.chunkId) ?? 0;
+            return { ...chunk, distance, score: distanceToScore(distance) };
+        });
+    }
+}
+/** Maps L2 distance between normalized vectors to a cosine similarity in 0..1. */
+function distanceToScore(distance) {
+    const cosine = 1 - (distance * distance) / 2;
+    return Math.max(0, Math.min(1, cosine));
+}
+//# sourceMappingURL=search.js.map

package/dist/store/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/store/search.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAEL;IACA;IACA;IAHnB,YACmB,UAA6B,EAC7B,WAAwB,EACxB,UAAsB;QAFtB,eAAU,GAAV,UAAU,CAAmB;QAC7B,gBAAW,GAAX,WAAW,CAAa;QACxB,eAAU,GAAV,UAAU,CAAY;IACtC,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAa;QACvC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEjC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAU,CAAC,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAEvE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1B,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtD,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,kFAAkF;AAClF,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/store/types.js

@@ -0,0 +1,3 @@
+// Persistence-facing chunk shapes returned by the store layer.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/store/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAAA,+DAA+D"}

package/dist/store/vectorStore.js

@@ -0,0 +1,77 @@
+/**
+ * Owns the embedding store. With the native sqlite-vec extension it uses a vec0
+ * virtual table; without it (fallback) it stores blobs in a plain table and
+ * brute-forces cosine KNN in JS. Vector rows are keyed by the same chunk id as
+ * the relational `chunks` table but are not foreign-key linked, so the indexer
+ * must delete vector rows explicitly when a note is re-indexed.
+ */
+export class VectorStore {
+    db;
+    backend;
+    constructor(db, backend = "native") {
+        this.db = db;
+        this.backend = backend;
+    }
+    /** Stores the embedding for a chunk. */
+    insert(chunkId, embedding) {
+        if (this.backend === "native") {
+            // vec0 requires the primary key as a SQLite INTEGER (BigInt) and the vector
+            // as a packed float32 blob.
+            this.db
+                .prepare("INSERT INTO vec_chunks (chunk_id, embedding) VALUES (?, ?)")
+                .run(BigInt(chunkId), toBlob(embedding));
+            return;
+        }
+        this.db
+            .prepare("INSERT OR REPLACE INTO vec_chunks_js (chunk_id, embedding) VALUES (?, ?)")
+            .run(chunkId, toBlob(embedding));
+    }
+    /** Approximate-nearest-neighbour search; up to k hits, closest first. */
+    knn(query, k) {
+        if (this.backend === "native") {
+            return this.db
+                .prepare("SELECT chunk_id AS chunkId, distance FROM vec_chunks " +
+                "WHERE embedding MATCH ? AND k = ? ORDER BY distance")
+                .all(toBlob(query), k);
+        }
+        // Fallback: brute-force. Embeddings are unit-normalized, so cosine == dot
+        // product, and L2 distance == sqrt(2 - 2*dot).
+        const rows = this.db.prepare("SELECT chunk_id AS chunkId, embedding FROM vec_chunks_js").all();
+        const scored = rows.map((row) => {
+            const vector = bufferToFloat32(row.embedding);
+            const length = Math.min(vector.length, query.length);
+            let dot = 0;
+            for (let i = 0; i < length; i += 1)
+                dot += (query[i] ?? 0) * (vector[i] ?? 0);
+            return { chunkId: row.chunkId, distance: Math.sqrt(Math.max(0, 2 - 2 * dot)) };
+        });
+        scored.sort((a, b) => a.distance - b.distance);
+        return scored.slice(0, k);
+    }
+    deleteByChunkIds(chunkIds) {
+        if (chunkIds.length === 0)
+            return;
+        if (this.backend === "native") {
+            const stmt = this.db.prepare("DELETE FROM vec_chunks WHERE chunk_id = ?");
+            for (const id of chunkIds)
+                stmt.run(BigInt(id));
+            return;
+        }
+        const stmt = this.db.prepare("DELETE FROM vec_chunks_js WHERE chunk_id = ?");
+        for (const id of chunkIds)
+            stmt.run(id);
+    }
+    count() {
+        const table = this.backend === "native" ? "vec_chunks" : "vec_chunks_js";
+        const row = this.db.prepare(`SELECT count(*) AS n FROM ${table}`).get();
+        return row.n;
+    }
+}
+/** Packs a Float32Array into a Buffer view for binding as a blob. */
+function toBlob(vector) {
+    return Buffer.from(vector.buffer, vector.byteOffset, vector.byteLength);
+}
+function bufferToFloat32(buffer) {
+    return new Float32Array(buffer.buffer, buffer.byteOffset, Math.floor(buffer.byteLength / 4));
+}
+//# sourceMappingURL=vectorStore.js.map

package/dist/store/vectorStore.js.map

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