@pella-labs/pinakes 0.1.0

package/dist/observability/audit.js

@@ -0,0 +1,38 @@
+import { appendFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { logger } from './logger.js';
+/**
+ * Write an audit row to the appropriate DB and mirror to JSONL.
+ *
+ * @param writer    The DB writer for the scope-appropriate bundle.
+ * @param jsonlPath The path for the JSONL mirror file.
+ * @param entry     Audit entry data.
+ */
+export function writeAuditRow(writer, jsonlPath, entry) {
+    const ts = Date.now();
+    // Write to kg_audit table
+    try {
+        writer
+            .prepare(`INSERT INTO kg_audit (ts, tool_name, scope_requested, caller_ctx, response_tokens, error)
+         VALUES (?, ?, ?, ?, ?, ?)`)
+            .run(ts, entry.toolName, entry.scopeRequested, entry.callerCtx ?? null, entry.responseTokens ?? null, entry.error ?? null);
+    }
+    catch (err) {
+        logger.warn({ err, entry }, 'failed to write kg_audit row');
+    }
+    // Mirror to JSONL
+    if (jsonlPath) {
+        try {
+            const dir = dirname(jsonlPath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            const line = JSON.stringify({ ts, ...entry }) + '\n';
+            appendFileSync(jsonlPath, line, 'utf-8');
+        }
+        catch (err) {
+            logger.warn({ err, jsonlPath }, 'failed to append audit JSONL');
+        }
+    }
+}
+//# sourceMappingURL=audit.js.map

package/dist/observability/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/observability/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmBrC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA4B,EAC5B,SAA6B,EAC7B,KAAiB;IAEjB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEtB,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM;aACH,OAAO,CACN;mCAC2B,CAC5B;aACA,GAAG,CACF,EAAE,EACF,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,SAAS,IAAI,IAAI,EACvB,KAAK,CAAC,cAAc,IAAI,IAAI,EAC5B,KAAK,CAAC,KAAK,IAAI,IAAI,CACpB,CAAC;IACN,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,8BAA8B,CAAC,CAAC;IAC9D,CAAC;IAED,kBAAkB;IAClB,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;YACrD,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,8BAA8B,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/observability/logger.d.ts

@@ -0,0 +1,4 @@
+import { type Logger } from 'pino';
+export declare const logger: Logger;
+export declare function child(bindings: Record<string, unknown>): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/observability/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAsB,MAAM,MAAM,CAAC;AAwD7D,eAAO,MAAM,MAAM,EAAE,MAAuB,CAAC;AAE7C,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE/D"}

package/dist/observability/logger.js

@@ -0,0 +1,56 @@
+import { pino } from 'pino';
+/**
+ * Pino logger for KG-MCP.
+ *
+ * CRITICAL: MCP stdio transport uses stdout for the JSON-RPC protocol. Every
+ * log line must go to stderr — writing to stdout would corrupt the protocol
+ * stream and crash the client. Pino's default `destination()` is already
+ * stderr when we pass `process.stderr.fd`, and we never pass a custom
+ * destination that would route to stdout.
+ *
+ * Pretty transport is only enabled when:
+ *   1. `KG_LOG_LEVEL=debug` or `trace`, AND
+ *   2. stderr is a TTY (i.e. a developer is watching in a terminal)
+ *
+ * In production (Pharos-spawned stdio child, non-TTY), logs stay as newline-
+ * delimited JSON for machine consumption.
+ */
+const level = process.env.KG_LOG_LEVEL ?? 'info';
+const isVerbose = level === 'debug' || level === 'trace';
+const isTty = process.stderr.isTTY ?? false;
+const usePretty = isVerbose && isTty;
+const baseOptions = {
+    level,
+    base: {
+        service: 'kg-mcp',
+        pid: process.pid,
+    },
+    timestamp: pino.stdTimeFunctions.isoTime,
+};
+function createLogger() {
+    if (usePretty) {
+        // With a transport, pino offloads to a worker; the transport target itself
+        // writes to stderr via `destination: 2`.
+        return pino({
+            ...baseOptions,
+            transport: {
+                target: 'pino-pretty',
+                options: {
+                    colorize: true,
+                    destination: 2, // stderr
+                    translateTime: 'HH:MM:ss.l',
+                    ignore: 'pid,hostname,service',
+                },
+            },
+        });
+    }
+    // Default path: write NDJSON directly to stderr so stdout stays clean for
+    // the MCP JSON-RPC protocol. `process.stderr` satisfies pino's
+    // DestinationStream contract.
+    return pino(baseOptions, process.stderr);
+}
+export const logger = createLogger();
+export function child(bindings) {
+    return logger.child(bindings);
+}
+//# sourceMappingURL=logger.js.map

package/dist/observability/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmC,MAAM,MAAM,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC;AACjD,MAAM,SAAS,GAAG,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC;AACzD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;AAC5C,MAAM,SAAS,GAAG,SAAS,IAAI,KAAK,CAAC;AAErC,MAAM,WAAW,GAAkB;IACjC,KAAK;IACL,IAAI,EAAE;QACJ,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB;IACD,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;CACzC,CAAC;AAEF,SAAS,YAAY;IACnB,IAAI,SAAS,EAAE,CAAC;QACd,2EAA2E;QAC3E,yCAAyC;QACzC,OAAO,IAAI,CAAC;YACV,GAAG,WAAW;YACd,SAAS,EAAE;gBACT,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,CAAC,EAAE,SAAS;oBACzB,aAAa,EAAE,YAAY;oBAC3B,MAAM,EAAE,sBAAsB;iBAC/B;aACF;SACF,CAAC,CAAC;IACL,CAAC;IACD,0EAA0E;IAC1E,+DAA+D;IAC/D,8BAA8B;IAC9B,OAAO,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAW,YAAY,EAAE,CAAC;AAE7C,MAAM,UAAU,KAAK,CAAC,QAAiC;IACrD,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/observability/metrics.d.ts

@@ -0,0 +1,38 @@
+/**
+ * In-process metrics counters with SIGHUP dump.
+ *
+ * CLAUDE.md §Phase 7: "Metrics dump on SIGHUP: emit all counters as a
+ * single JSON line to stderr."
+ *
+ * All counters are monotonic (never reset). The SIGHUP handler snapshots
+ * everything and writes it to stderr as NDJSON so it doesn't collide with
+ * the MCP stdio protocol on stdout.
+ */
+export interface LatencyBucket {
+    count: number;
+    sum: number;
+    max: number;
+}
+export interface MetricsSnapshot {
+    tool_calls: Record<string, number>;
+    tool_errors: Record<string, number>;
+    tool_latency_ms: Record<string, LatencyBucket>;
+    ingest_files: number;
+    ingest_errors: number;
+    uptime_s: number;
+}
+declare class Metrics {
+    private toolCalls;
+    private toolErrors;
+    private toolLatency;
+    private ingestFiles;
+    private ingestErrors;
+    private readonly startedAt;
+    recordToolCall(tool: string, latencyMs: number, error?: boolean): void;
+    recordIngest(error?: boolean): void;
+    snapshot(): MetricsSnapshot;
+}
+export declare const metrics: Metrics;
+export declare function installSighupHandler(): void;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,cAAM,OAAO;IACX,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IAExC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAYtE,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAKnC,QAAQ,IAAI,eAAe;CAU5B;AAED,eAAO,MAAM,OAAO,SAAgB,CAAC;AAOrC,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C"}

package/dist/observability/metrics.js

@@ -0,0 +1,64 @@
+/**
+ * In-process metrics counters with SIGHUP dump.
+ *
+ * CLAUDE.md §Phase 7: "Metrics dump on SIGHUP: emit all counters as a
+ * single JSON line to stderr."
+ *
+ * All counters are monotonic (never reset). The SIGHUP handler snapshots
+ * everything and writes it to stderr as NDJSON so it doesn't collide with
+ * the MCP stdio protocol on stdout.
+ */
+import { logger } from './logger.js';
+class Metrics {
+    toolCalls = new Map();
+    toolErrors = new Map();
+    toolLatency = new Map();
+    ingestFiles = 0;
+    ingestErrors = 0;
+    startedAt = Date.now();
+    recordToolCall(tool, latencyMs, error) {
+        this.toolCalls.set(tool, (this.toolCalls.get(tool) ?? 0) + 1);
+        if (error) {
+            this.toolErrors.set(tool, (this.toolErrors.get(tool) ?? 0) + 1);
+        }
+        const lat = this.toolLatency.get(tool) ?? { count: 0, sum: 0, max: 0 };
+        lat.count++;
+        lat.sum += latencyMs;
+        lat.max = Math.max(lat.max, latencyMs);
+        this.toolLatency.set(tool, lat);
+    }
+    recordIngest(error) {
+        if (error)
+            this.ingestErrors++;
+        else
+            this.ingestFiles++;
+    }
+    snapshot() {
+        return {
+            tool_calls: Object.fromEntries(this.toolCalls),
+            tool_errors: Object.fromEntries(this.toolErrors),
+            tool_latency_ms: Object.fromEntries(this.toolLatency),
+            ingest_files: this.ingestFiles,
+            ingest_errors: this.ingestErrors,
+            uptime_s: Math.round((Date.now() - this.startedAt) / 1000),
+        };
+    }
+}
+export const metrics = new Metrics();
+/**
+ * Install SIGHUP handler to dump metrics as a single JSON line to stderr.
+ * Safe to call multiple times — only installs once.
+ */
+let sighupInstalled = false;
+export function installSighupHandler() {
+    if (sighupInstalled)
+        return;
+    sighupInstalled = true;
+    process.on('SIGHUP', () => {
+        const snap = metrics.snapshot();
+        // Write directly to stderr to avoid pino's async buffering.
+        process.stderr.write(JSON.stringify({ kg_mcp_metrics: snap }) + '\n');
+        logger.info('SIGHUP: metrics dumped to stderr');
+    });
+}
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiBrC,MAAM,OAAO;IACH,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,WAAW,GAAG,CAAC,CAAC;IAChB,YAAY,GAAG,CAAC,CAAC;IACR,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAExC,cAAc,CAAC,IAAY,EAAE,SAAiB,EAAE,KAAe;QAC7D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,GAAG,CAAC,GAAG,IAAI,SAAS,CAAC;QACrB,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,YAAY,CAAC,KAAe;QAC1B,IAAI,KAAK;YAAE,IAAI,CAAC,YAAY,EAAE,CAAC;;YAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC;IAED,QAAQ;QACN,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;YAC9C,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC;YAChD,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC;YACrD,YAAY,EAAE,IAAI,CAAC,WAAW;YAC9B,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;SAC3D,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAErC;;;GAGG;AACH,IAAI,eAAe,GAAG,KAAK,CAAC;AAC5B,MAAM,UAAU,oBAAoB;IAClC,IAAI,eAAe;QAAE,OAAO;IAC5B,eAAe,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAChC,4DAA4D;QAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/retrieval/embedder.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Embedder interface + default `@xenova/transformers` MiniLM implementation.
+ *
+ * **Why this lives in `retrieval/`** (not `ingest/`): the embedder is shared
+ * between the ingest path (computing chunk embeddings on insert) and the
+ * future query path in Phase 4 (computing query embeddings for vector
+ * search). Putting it under `retrieval/` keeps the code-mode bindings'
+ * mental model consistent — `kg.vec()` and ingest both call into the same
+ * factory.
+ *
+ * **Provider strategy** (CLAUDE.md §AI Rules #3): Phase 2 ships only the
+ * bundled MiniLM provider. Phase 4 adds the env-driven factory:
+ *   - `KG_EMBED_PROVIDER=transformers` (default, this file)
+ *   - `KG_EMBED_PROVIDER=ollama` (HTTP, user-controlled)
+ *   - `KG_EMBED_PROVIDER=voyage` (HTTPS, paid)
+ *   - `KG_EMBED_PROVIDER=openai` (HTTPS, paid)
+ *
+ * **Failure mode** (CLAUDE.md §AI Rules #4): if the embedder fails during
+ * ingest, the ingester logs a warning and inserts the node + chunks WITHOUT
+ * vec rows. Query-time degrades gracefully to FTS5-only for affected chunks.
+ * The contract here is that `embed()` may throw — callers must catch.
+ *
+ * **Singleton**: model load is ~25MB and takes ~800ms cold. We load once
+ * per process via `getDefaultEmbedder()` and share the instance. The
+ * `warmup()` method preloads the model proactively at server startup.
+ */
+/** Embedding output dimension for MiniLM. Locked — changing requires a vec table rebuild. */
+export declare const EMBEDDING_DIM = 384;
+/**
+ * Generic embedder contract. Implementations: `TransformersEmbedder` (default),
+ * `CountingEmbedder` (test wrapper), and Phase 4's `OllamaEmbedder` /
+ * `VoyageEmbedder` / `OpenAIEmbedder`.
+ */
+export interface Embedder {
+    /** Output dimension — load-bearing for the `kg_chunks_vec` schema */
+    readonly dim: number;
+    /** Eagerly load the underlying model. Optional — embed() will lazy-load on first call. */
+    warmup(): Promise<void>;
+    /** Embed a single text. Returns a Float32Array of length `dim`. */
+    embed(text: string): Promise<Float32Array>;
+}
+/**
+ * MiniLM via @xenova/transformers, running locally in-process. No network
+ * calls after first model download. The model is cached under
+ * `~/.cache/huggingface/` (or `XENOVA_CACHE_DIR` if set) so subsequent
+ * starts are fast (<500ms).
+ *
+ * Output: 384-dim Float32Array, mean-pooled across tokens, L2-normalized.
+ * The `pooling: 'mean'` and `normalize: true` options match the upstream
+ * Sentence Transformers reference inference, so embeddings produced here
+ * are interchangeable with embeddings produced by the Python lib.
+ */
+export declare class TransformersEmbedder implements Embedder {
+    private readonly modelName;
+    readonly dim = 384;
+    private pipelinePromise;
+    constructor(modelName?: string);
+    warmup(): Promise<void>;
+    embed(text: string): Promise<Float32Array>;
+    private getPipeline;
+}
+/**
+ * Test-only wrapper that delegates to a real embedder and counts the number
+ * of `embed()` calls. Used by `ingester.test.ts` to verify that re-ingesting
+ * a file with one mutated paragraph triggers exactly one new embedder call —
+ * the load-bearing per-chunk skip-unchanged optimization (Loop 6.5 A4).
+ *
+ * Lives next to the production embedder (not under `__tests__/`) so other
+ * test files can import it without circular dep issues.
+ */
+export declare class CountingEmbedder implements Embedder {
+    private readonly inner;
+    readonly dim: number;
+    /** Number of times `embed()` has been called since construction (or `reset()`). */
+    calls: number;
+    constructor(inner: Embedder);
+    warmup(): Promise<void>;
+    embed(text: string): Promise<Float32Array>;
+    reset(): void;
+}
+/**
+ * Ollama embedder via HTTP POST to `/api/embeddings`.
+ * Requires `KG_OLLAMA_URL` and `KG_OLLAMA_MODEL` env vars.
+ */
+export declare class OllamaEmbedder implements Embedder {
+    private readonly baseUrl;
+    private readonly model;
+    readonly dim: number;
+    constructor(baseUrl: string, model: string, dim?: number);
+    warmup(): Promise<void>;
+    embed(text: string): Promise<Float32Array>;
+}
+/**
+ * Voyage AI embedder via HTTPS POST to `https://api.voyageai.com/v1/embeddings`.
+ * Requires `KG_VOYAGE_API_KEY` env var.
+ */
+export declare class VoyageEmbedder implements Embedder {
+    private readonly apiKey;
+    private readonly model;
+    readonly dim: number;
+    constructor(apiKey: string, model?: string, dim?: number);
+    warmup(): Promise<void>;
+    embed(text: string): Promise<Float32Array>;
+}
+/**
+ * OpenAI embedder via HTTPS POST to `https://api.openai.com/v1/embeddings`.
+ * Requires `KG_OPENAI_API_KEY` env var.
+ */
+export declare class OpenAIEmbedder implements Embedder {
+    private readonly apiKey;
+    private readonly model;
+    readonly dim: number;
+    constructor(apiKey: string, model?: string, dim?: number);
+    warmup(): Promise<void>;
+    embed(text: string): Promise<Float32Array>;
+}
+export type EmbedProvider = 'transformers' | 'ollama' | 'voyage' | 'openai';
+/**
+ * Create an embedder instance based on the provider name and environment.
+ * Used at server startup. Falls back to TransformersEmbedder if the
+ * provider is unrecognized.
+ */
+export declare function createEmbedder(provider?: EmbedProvider): Embedder;
+/**
+ * Singleton accessor. Always returns the same `TransformersEmbedder` instance
+ * within a process so the model loads exactly once. Tests that need a fresh
+ * instance can construct `new TransformersEmbedder()` directly.
+ */
+export declare function getDefaultEmbedder(): TransformersEmbedder;
+//# sourceMappingURL=embedder.d.ts.map

package/dist/retrieval/embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../../src/retrieval/embedder.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,mEAAmE;IACnE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5C;AAQD;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,YAAW,QAAQ;IAKvC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJtC,QAAQ,CAAC,GAAG,OAAiB;IAE7B,OAAO,CAAC,eAAe,CAAmD;gBAE7C,SAAS,GAAE,MAAsB;IAOxD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAclC,WAAW;CAmB1B;AAMD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,QAAQ;IAKnC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,KAAK,SAAK;gBAEmB,KAAK,EAAE,QAAQ;IAItC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAKhD,KAAK,IAAI,IAAI;CAGd;AAMD;;;GAGG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAI3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAGF,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAC9B,GAAG,GAAE,MAAsB;IAKvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAkBjD;AAMD;;;GAGG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAI3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAGF,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAwB,EAChD,GAAG,GAAE,MAAsB;IAKvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAEvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAqBjD;AAMD;;;GAGG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAI3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAGF,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAiC,EACzD,GAAG,GAAE,MAAsB;IAKvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAEvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAqBjD;AAMD,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,QAAQ,CAyBjE;AAQD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,oBAAoB,CAKzD"}

package/dist/retrieval/embedder.js

@@ -0,0 +1,278 @@
+import { pipeline, env } from '@xenova/transformers';
+import { logger } from '../observability/logger.js';
+/**
+ * Embedder interface + default `@xenova/transformers` MiniLM implementation.
+ *
+ * **Why this lives in `retrieval/`** (not `ingest/`): the embedder is shared
+ * between the ingest path (computing chunk embeddings on insert) and the
+ * future query path in Phase 4 (computing query embeddings for vector
+ * search). Putting it under `retrieval/` keeps the code-mode bindings'
+ * mental model consistent — `kg.vec()` and ingest both call into the same
+ * factory.
+ *
+ * **Provider strategy** (CLAUDE.md §AI Rules #3): Phase 2 ships only the
+ * bundled MiniLM provider. Phase 4 adds the env-driven factory:
+ *   - `KG_EMBED_PROVIDER=transformers` (default, this file)
+ *   - `KG_EMBED_PROVIDER=ollama` (HTTP, user-controlled)
+ *   - `KG_EMBED_PROVIDER=voyage` (HTTPS, paid)
+ *   - `KG_EMBED_PROVIDER=openai` (HTTPS, paid)
+ *
+ * **Failure mode** (CLAUDE.md §AI Rules #4): if the embedder fails during
+ * ingest, the ingester logs a warning and inserts the node + chunks WITHOUT
+ * vec rows. Query-time degrades gracefully to FTS5-only for affected chunks.
+ * The contract here is that `embed()` may throw — callers must catch.
+ *
+ * **Singleton**: model load is ~25MB and takes ~800ms cold. We load once
+ * per process via `getDefaultEmbedder()` and share the instance. The
+ * `warmup()` method preloads the model proactively at server startup.
+ */
+/** Embedding output dimension for MiniLM. Locked — changing requires a vec table rebuild. */
+export const EMBEDDING_DIM = 384;
+// ----------------------------------------------------------------------------
+// TransformersEmbedder — Xenova/all-MiniLM-L6-v2-quantized
+// ----------------------------------------------------------------------------
+const DEFAULT_MODEL = 'Xenova/all-MiniLM-L6-v2';
+/**
+ * MiniLM via @xenova/transformers, running locally in-process. No network
+ * calls after first model download. The model is cached under
+ * `~/.cache/huggingface/` (or `XENOVA_CACHE_DIR` if set) so subsequent
+ * starts are fast (<500ms).
+ *
+ * Output: 384-dim Float32Array, mean-pooled across tokens, L2-normalized.
+ * The `pooling: 'mean'` and `normalize: true` options match the upstream
+ * Sentence Transformers reference inference, so embeddings produced here
+ * are interchangeable with embeddings produced by the Python lib.
+ */
+export class TransformersEmbedder {
+    modelName;
+    dim = EMBEDDING_DIM;
+    pipelinePromise = null;
+    constructor(modelName = DEFAULT_MODEL) {
+        this.modelName = modelName;
+        // Allow Xenova to use local cache; only fall back to remote on first run.
+        // Setting allowLocalModels=true is the default but explicit here for clarity.
+        env.allowLocalModels = true;
+        env.allowRemoteModels = true;
+    }
+    async warmup() {
+        await this.getPipeline();
+    }
+    async embed(text) {
+        const extractor = await this.getPipeline();
+        const tensor = await extractor(text, { pooling: 'mean', normalize: true });
+        // Tensor.data is a Float32Array of shape [1, 384]; flatten to length 384.
+        const data = tensor.data;
+        if (data.length !== this.dim) {
+            throw new Error(`embedder produced ${data.length}-dim vector but ${this.dim} was expected — wrong model loaded?`);
+        }
+        // Defensive copy: tensor.data may be reused on the next call.
+        return new Float32Array(data);
+    }
+    async getPipeline() {
+        if (!this.pipelinePromise) {
+            logger.info({ model: this.modelName }, 'loading transformers embedder');
+            const t0 = Date.now();
+            this.pipelinePromise = pipeline('feature-extraction', this.modelName, { quantized: true });
+            this.pipelinePromise
+                .then(() => {
+                logger.info({ model: this.modelName, ms: Date.now() - t0 }, 'transformers embedder ready');
+            })
+                .catch((err) => {
+                logger.error({ err, model: this.modelName }, 'transformers embedder failed to load');
+                // Reset so subsequent calls can retry rather than reusing a rejected promise.
+                this.pipelinePromise = null;
+            });
+        }
+        return this.pipelinePromise;
+    }
+}
+// ----------------------------------------------------------------------------
+// CountingEmbedder — test wrapper used by the per-chunk skip-unchanged test
+// ----------------------------------------------------------------------------
+/**
+ * Test-only wrapper that delegates to a real embedder and counts the number
+ * of `embed()` calls. Used by `ingester.test.ts` to verify that re-ingesting
+ * a file with one mutated paragraph triggers exactly one new embedder call —
+ * the load-bearing per-chunk skip-unchanged optimization (Loop 6.5 A4).
+ *
+ * Lives next to the production embedder (not under `__tests__/`) so other
+ * test files can import it without circular dep issues.
+ */
+export class CountingEmbedder {
+    inner;
+    dim;
+    /** Number of times `embed()` has been called since construction (or `reset()`). */
+    calls = 0;
+    constructor(inner) {
+        this.inner = inner;
+        this.dim = inner.dim;
+    }
+    async warmup() {
+        await this.inner.warmup();
+    }
+    async embed(text) {
+        this.calls++;
+        return this.inner.embed(text);
+    }
+    reset() {
+        this.calls = 0;
+    }
+}
+// ----------------------------------------------------------------------------
+// OllamaEmbedder — HTTP to local Ollama instance
+// ----------------------------------------------------------------------------
+/**
+ * Ollama embedder via HTTP POST to `/api/embeddings`.
+ * Requires `KG_OLLAMA_URL` and `KG_OLLAMA_MODEL` env vars.
+ */
+export class OllamaEmbedder {
+    baseUrl;
+    model;
+    dim;
+    constructor(baseUrl, model, dim = EMBEDDING_DIM) {
+        this.baseUrl = baseUrl;
+        this.model = model;
+        this.dim = dim;
+    }
+    async warmup() {
+        // Ollama loads the model on first request; nothing to pre-warm.
+    }
+    async embed(text) {
+        const res = await fetch(`${this.baseUrl}/api/embeddings`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ model: this.model, prompt: text }),
+        });
+        if (!res.ok) {
+            throw new Error(`Ollama embed failed: ${res.status} ${res.statusText}`);
+        }
+        const json = (await res.json());
+        const vec = new Float32Array(json.embedding);
+        if (vec.length !== this.dim) {
+            throw new Error(`Ollama returned ${vec.length}-dim embedding but ${this.dim} expected`);
+        }
+        return vec;
+    }
+}
+// ----------------------------------------------------------------------------
+// VoyageEmbedder — HTTPS to Voyage AI
+// ----------------------------------------------------------------------------
+/**
+ * Voyage AI embedder via HTTPS POST to `https://api.voyageai.com/v1/embeddings`.
+ * Requires `KG_VOYAGE_API_KEY` env var.
+ */
+export class VoyageEmbedder {
+    apiKey;
+    model;
+    dim;
+    constructor(apiKey, model = 'voyage-code-3', dim = EMBEDDING_DIM) {
+        this.apiKey = apiKey;
+        this.model = model;
+        this.dim = dim;
+    }
+    async warmup() { }
+    async embed(text) {
+        const res = await fetch('https://api.voyageai.com/v1/embeddings', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({ model: this.model, input: text }),
+        });
+        if (!res.ok) {
+            throw new Error(`Voyage embed failed: ${res.status} ${res.statusText}`);
+        }
+        const json = (await res.json());
+        const vec = new Float32Array(json.data[0].embedding);
+        if (vec.length !== this.dim) {
+            throw new Error(`Voyage returned ${vec.length}-dim embedding but ${this.dim} expected`);
+        }
+        return vec;
+    }
+}
+// ----------------------------------------------------------------------------
+// OpenAIEmbedder — HTTPS to OpenAI
+// ----------------------------------------------------------------------------
+/**
+ * OpenAI embedder via HTTPS POST to `https://api.openai.com/v1/embeddings`.
+ * Requires `KG_OPENAI_API_KEY` env var.
+ */
+export class OpenAIEmbedder {
+    apiKey;
+    model;
+    dim;
+    constructor(apiKey, model = 'text-embedding-3-small', dim = EMBEDDING_DIM) {
+        this.apiKey = apiKey;
+        this.model = model;
+        this.dim = dim;
+    }
+    async warmup() { }
+    async embed(text) {
+        const res = await fetch('https://api.openai.com/v1/embeddings', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({ model: this.model, input: text }),
+        });
+        if (!res.ok) {
+            throw new Error(`OpenAI embed failed: ${res.status} ${res.statusText}`);
+        }
+        const json = (await res.json());
+        const vec = new Float32Array(json.data[0].embedding);
+        if (vec.length !== this.dim) {
+            throw new Error(`OpenAI returned ${vec.length}-dim embedding but ${this.dim} expected`);
+        }
+        return vec;
+    }
+}
+/**
+ * Create an embedder instance based on the provider name and environment.
+ * Used at server startup. Falls back to TransformersEmbedder if the
+ * provider is unrecognized.
+ */
+export function createEmbedder(provider) {
+    const p = provider ?? process.env['KG_EMBED_PROVIDER'] ?? 'transformers';
+    switch (p) {
+        case 'ollama': {
+            const url = process.env['KG_OLLAMA_URL'] ?? 'http://localhost:11434';
+            const model = process.env['KG_OLLAMA_MODEL'] ?? 'nomic-embed-text';
+            return new OllamaEmbedder(url, model);
+        }
+        case 'voyage': {
+            const key = process.env['KG_VOYAGE_API_KEY'];
+            if (!key)
+                throw new Error('KG_VOYAGE_API_KEY is required for voyage embedder');
+            const model = process.env['KG_EMBED_MODEL'] ?? 'voyage-code-3';
+            return new VoyageEmbedder(key, model);
+        }
+        case 'openai': {
+            const key = process.env['KG_OPENAI_API_KEY'];
+            if (!key)
+                throw new Error('KG_OPENAI_API_KEY is required for openai embedder');
+            const model = process.env['KG_EMBED_MODEL'] ?? 'text-embedding-3-small';
+            return new OpenAIEmbedder(key, model);
+        }
+        case 'transformers':
+        default:
+            return getDefaultEmbedder();
+    }
+}
+// ----------------------------------------------------------------------------
+// Default factory + singleton
+// ----------------------------------------------------------------------------
+let defaultEmbedder = null;
+/**
+ * Singleton accessor. Always returns the same `TransformersEmbedder` instance
+ * within a process so the model loads exactly once. Tests that need a fresh
+ * instance can construct `new TransformersEmbedder()` directly.
+ */
+export function getDefaultEmbedder() {
+    if (!defaultEmbedder) {
+        defaultEmbedder = new TransformersEmbedder();
+    }
+    return defaultEmbedder;
+}
+//# sourceMappingURL=embedder.js.map

package/dist/retrieval/embedder.js.map

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