@monoes/monograph 1.2.8 → 1.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoes/monograph",
-  "version": "1.2.8",
+  "version": "1.2.9",
   "type": "module",
   "description": "Native TypeScript code intelligence engine for monomind",
   "main": "dist/src/index.js",

package/src/index.ts

@@ -18,12 +18,8 @@ export * from './export/graphml.js';
 export * from './export/svg.js';
 export * from './mcp-tools/index.js';
 export * from './staleness/git-staleness.js';
-export * from './storage/embedding-store.js';
 export * from './search/rrf.js';
-export * from './search/embedder.js';
-export * from './search/embed-batch.js';
 export * from './search/hybrid-query.js';
-export * from './mcp-tools/embed.js';
 export * from './groups/group-config.js';
 export * from './groups/group-search.js';
 export * from './groups/contract-bridge.js';
@@ -72,8 +68,6 @@ export * from './analysis/file-classifier.js';
 export * from './pipeline/phases/evidence.js';
 export * from './registry/repo-registry.js';
 export * from './search/ast-chunker.js';
-export * from './search/http-embedder.js';
-export * from './search/device-config.js';
 export * from './wiki/providers.js';
 export * from './pipeline/phases/variables-phase.js';
 export * from './pipeline/phases/wildcard-phase.js';
@@ -94,7 +88,6 @@ export * from './mcp-tools/query.js';
 export * from './search/diacritic.js';
 export * from './ingest/url-ingest.js';
 export * from './analysis/corpus-health.js';
-export * from './search/exact-search.js';
 export * from './groups/grpc-extractor.js';
 export * from './groups/topic-extractor.js';
 export * from './groups/service-boundary.js';

package/src/mcp-tools/index.ts

@@ -16,7 +16,6 @@ export * from './shape-check.js';
 export * from './neighbors.js';
 export * from './graph-query.js';
 export * from './explain.js';
-export * from './embed.js';
 export * from './group-sync.js';
 export * from './list-repos.js';
 export * from './query.js';

package/src/search/hybrid-query.ts

@@ -1,27 +1,23 @@
 /**
- * Hybrid BM25 + vector search with Reciprocal Rank Fusion.
+ * BM25 search (FTS5) with the historical "hybrid" entry-point signature.
  *
- * When MONOGRAPH_EMBEDDINGS=true (or an embedder is provided), the query is
- * embedded and cosine similarity is computed in JavaScript against all stored
- * vectors.  Both result lists are merged via RRF(K=60).
- *
- * If embeddings are unavailable (table empty, env not set, no embedder),
- * the function falls back to BM25 only — same behaviour as before.
+ * Monograph search is BM25-only. The former embedding/vector branch
+ * (gated on MONOGRAPH_EMBEDDINGS=true) was removed — it was never run in
+ * practice (the embeddings table stayed empty) and did a JS cosine full
+ * scan. The exported function signatures are unchanged so callers do not
+ * need to change.
  */
 
 import type Database from 'better-sqlite3';
-import type { EmbedderFn } from './embedder.js';
-import { mergeRanks, type RankedResult } from './rrf.js';
-import { getAllEmbeddings, countEmbeddings } from '../storage/embedding-store.js';
-import { embedText } from './embedder.js';
+import type { RankedResult } from './rrf.js';
 import { ftsSearch } from '../storage/fts-store.js';
 import { normalizeSearchTerm } from './diacritic.js';
 
 export interface HybridQueryOptions {
   limit?: number;
   label?: string;
-  /** Explicit embedder — overrides MONOGRAPH_EMBEDDINGS env check */
-  embedder?: EmbedderFn;
+  /** @deprecated Embeddings are disabled — this option is ignored; search is BM25-only. */
+  embedder?: unknown;
 }
 
 export interface HybridResult extends RankedResult {
@@ -38,19 +34,15 @@ export interface HybridResult extends RankedResult {
 }
 
 /**
- * Run a hybrid BM25 + cosine search.
- *
- * Falls back to BM25-only when:
- *  - MONOGRAPH_EMBEDDINGS env var is not 'true' AND no explicit embedder is given
- *  - The embeddings table is empty
- *  - Embedding the query string fails
+ * Run a BM25 (FTS5) search. Despite the name, this is BM25-only — the
+ * vector branch was removed; the `embedder` option is ignored.
  */
 export async function hybridQuery(
   db: Database.Database,
   query: string,
   options: HybridQueryOptions = {},
 ): Promise<HybridResult[]> {
-  const { limit = 20, label, embedder } = options;
+  const { limit = 20, label } = options;
 
   // Normalize the query for text-based lookups (strip diacritics, lowercase, trim)
   const normalizedQuery = normalizeSearchTerm(query);
@@ -69,104 +61,5 @@ export async function hybridQuery(
     endLine: r.endLine,
   }));
 
-  // ── Decide whether to add vector results ──────────────────────────────────
-  const embeddingsEnabled =
-    embedder !== undefined || process.env['MONOGRAPH_EMBEDDINGS'] === 'true';
-
-  if (!embeddingsEnabled) return sliceHybrid(bm25Results, limit);
-
-  const embeddingCount = countEmbeddings(db);
-  if (embeddingCount === 0) return sliceHybrid(bm25Results, limit);
-
-  // ── Embed the query ────────────────────────────────────────────────────────
-  let queryVec: Float32Array;
-  try {
-    const fn: import('./embedder.js').EmbedderFn = embedder ?? (await import('./embedder.js').then((m) => m.getEmbedder()));
-    queryVec = await embedText(normalizedQuery, fn);
-  } catch {
-    // Embedding failed — degrade gracefully to BM25
-    return sliceHybrid(bm25Results, limit);
-  }
-
-  // ── Cosine similarity against stored vectors ──────────────────────────────
-  const allVecs = getAllEmbeddings(db);
-  const vectorScored: { id: string; cosine: number }[] = [];
-
-  for (const [nodeId, vec] of allVecs) {
-    const sim = dotProduct(queryVec, vec); // valid because vectors are L2-normalised
-    vectorScored.push({ id: nodeId, cosine: sim });
-  }
-
-  // Sort descending by cosine similarity
-  vectorScored.sort((a, b) => b.cosine - a.cosine);
-
-  // Build vector RankedResult list with node metadata joined from BM25 cache
-  const bm25ById = new Map(bm25Results.map((r) => [r.id, r]));
-  const vectorResults: RankedResult[] = vectorScored.map((vs) => {
-    const meta = bm25ById.get(vs.id);
-    return {
-      id: vs.id,
-      name: (meta?.name as string | undefined) ?? '',
-      normLabel: (meta?.normLabel as string | undefined) ?? '',
-      filePath: (meta?.filePath as string | null | undefined) ?? null,
-      label: (meta?.label as string | undefined) ?? '',
-      score: vs.cosine,
-    };
-  });
-
-  // ── Merge via RRF ──────────────────────────────────────────────────────────
-  const merged = mergeRanks(bm25Results, vectorResults);
-
-  // Enrich nodes not in bm25 cache with a DB lookup
-  const enrichable = merged as Partial<HybridResult>[];
-  const unknownIds = enrichable
-    .filter((r) => !r.name)
-    .map((r) => r.id as string);
-
-  if (unknownIds.length > 0) {
-    const placeholders = unknownIds.map(() => '?').join(',');
-    const rows = db
-      .prepare(
-        `SELECT id, name, norm_label, file_path, label, start_line, end_line FROM nodes WHERE id IN (${placeholders})`,
-      )
-      .all(...unknownIds) as {
-      id: string;
-      name: string;
-      norm_label: string;
-      file_path: string | null;
-      label: string;
-      start_line: number | null;
-      end_line: number | null;
-    }[];
-
-    const rowMap = new Map(rows.map((r) => [r.id, r]));
-    for (const item of enrichable) {
-      if (!item.name) {
-        const row = rowMap.get(item.id as string);
-        if (row) {
-          item.name = row.name;
-          item.normLabel = row.norm_label;
-          item.filePath = row.file_path;
-          item.label = row.label;
-          (item as HybridResult).startLine = row.start_line;
-          (item as HybridResult).endLine = row.end_line;
-        }
-      }
-    }
-  }
-
-  return sliceHybrid(merged, limit);
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function sliceHybrid(results: RankedResult[], limit: number): HybridResult[] {
-  return results.slice(0, limit) as HybridResult[];
-}
-
-function dotProduct(a: Float32Array, b: Float32Array): number {
-  let sum = 0;
-  const len = Math.min(a.length, b.length);
-  for (let i = 0; i < len; i++) sum += a[i] * b[i];
-  return sum;
+  return bm25Results.slice(0, limit) as HybridResult[];
 }

package/dist/src/__tests__/mcp-tools/embed.test.d.ts

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

package/dist/src/__tests__/mcp-tools/embed.test.d.ts.map

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

package/dist/src/__tests__/mcp-tools/embed.test.js

@@ -1,12 +0,0 @@
-import { describe, it, expect } from 'vitest';
-describe('embed tool exports', () => {
-    it('runEmbed is exported from mcp-tools index', async () => {
-        const mod = await import('../../mcp-tools/index.js');
-        expect(typeof mod.runEmbed).toBe('function');
-    });
-    it('runEmbed is directly importable from embed.js', async () => {
-        const { runEmbed } = await import('../../mcp-tools/embed.js');
-        expect(typeof runEmbed).toBe('function');
-    });
-});
-//# sourceMappingURL=embed.test.js.map

package/dist/src/__tests__/mcp-tools/embed.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"embed.test.js","sourceRoot":"","sources":["../../../../src/__tests__/mcp-tools/embed.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QACrD,MAAM,CAAC,OAAQ,GAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAC9D,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/__tests__/search/embed-stale.test.d.ts

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

package/dist/src/__tests__/search/embed-stale.test.d.ts.map

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

package/dist/src/__tests__/search/embed-stale.test.js

@@ -1,38 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import Database from 'better-sqlite3';
-import { upsertEmbedding, getEmbeddingContentHash, isEmbeddingStale } from '../../storage/embedding-store.js';
-function makeDb() {
-    const db = new Database(':memory:');
-    db.exec(`
-    CREATE TABLE IF NOT EXISTS embeddings (
-      node_id TEXT PRIMARY KEY,
-      vector BLOB NOT NULL,
-      content_hash TEXT,
-      created_at INTEGER DEFAULT (unixepoch())
-    );
-  `);
-    return db;
-}
-describe('embedding stale detection', () => {
-    it('stores content hash with embedding', () => {
-        const db = makeDb();
-        upsertEmbedding(db, 'n1', new Float32Array([0.1, 0.2]), 'hash_abc');
-        const stored = getEmbeddingContentHash(db, 'n1');
-        expect(stored).toBe('hash_abc');
-    });
-    it('isEmbeddingStale returns true when hash differs', () => {
-        const db = makeDb();
-        upsertEmbedding(db, 'n1', new Float32Array([0.1, 0.2]), 'old_hash');
-        expect(isEmbeddingStale(db, 'n1', 'new_hash')).toBe(true);
-    });
-    it('isEmbeddingStale returns false when hash matches', () => {
-        const db = makeDb();
-        upsertEmbedding(db, 'n1', new Float32Array([0.1, 0.2]), 'same_hash');
-        expect(isEmbeddingStale(db, 'n1', 'same_hash')).toBe(false);
-    });
-    it('isEmbeddingStale returns true when no embedding exists', () => {
-        const db = makeDb();
-        expect(isEmbeddingStale(db, 'n1', 'any_hash')).toBe(true);
-    });
-});
-//# sourceMappingURL=embed-stale.test.js.map

package/dist/src/__tests__/search/embed-stale.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"embed-stale.test.js","sourceRoot":"","sources":["../../../../src/__tests__/search/embed-stale.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAE9G,SAAS,MAAM;IACb,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpC,EAAE,CAAC,IAAI,CAAC;;;;;;;GAOP,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,uBAAuB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACpE,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACrE,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/__tests__/search/exact-search.test.d.ts

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

package/dist/src/__tests__/search/exact-search.test.d.ts.map

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

package/dist/src/__tests__/search/exact-search.test.js

@@ -1,49 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import Database from 'better-sqlite3';
-import { exactVectorSearch } from '../../search/exact-search.js';
-function makeDb() {
-    const db = new Database(':memory:');
-    db.exec(`
-    CREATE TABLE nodes (id TEXT PRIMARY KEY, label TEXT NOT NULL, name TEXT NOT NULL,
-      norm_label TEXT, file_path TEXT, start_line INTEGER, end_line INTEGER,
-      community_id INTEGER, is_exported INTEGER DEFAULT 0, language TEXT, properties TEXT);
-    CREATE TABLE embeddings (node_id TEXT PRIMARY KEY, vector BLOB NOT NULL, content_hash TEXT, created_at INTEGER);
-  `);
-    db.prepare(`INSERT INTO nodes VALUES ('n1','Function','doAuth',null,'/auth.ts',1,5,null,1,null,null)`).run();
-    db.prepare(`INSERT INTO nodes VALUES ('n2','Function','renderUI',null,'/ui.ts',1,3,null,1,null,null)`).run();
-    // Store simple 3-dim embeddings: n1 ~ [1, 0, 0], n2 ~ [0, 1, 0]
-    const v1 = new Float32Array([1, 0, 0]);
-    const v2 = new Float32Array([0, 1, 0]);
-    db.prepare(`INSERT INTO embeddings VALUES ('n1', ?, null, 0)`).run(Buffer.from(v1.buffer));
-    db.prepare(`INSERT INTO embeddings VALUES ('n2', ?, null, 0)`).run(Buffer.from(v2.buffer));
-    return db;
-}
-describe('exactVectorSearch', () => {
-    it('returns closest node to query vector', () => {
-        const db = makeDb();
-        const query = new Float32Array([0.9, 0.1, 0]);
-        const results = exactVectorSearch(db, query, { limit: 2 });
-        expect(results[0]?.id).toBe('n1');
-    });
-    it('respects limit', () => {
-        const db = makeDb();
-        const query = new Float32Array([1, 0, 0]);
-        const results = exactVectorSearch(db, query, { limit: 1 });
-        expect(results).toHaveLength(1);
-    });
-    it('returns score between 0 and 1', () => {
-        const db = makeDb();
-        const query = new Float32Array([1, 0, 0]);
-        const results = exactVectorSearch(db, query, { limit: 2 });
-        expect(results[0].score).toBeGreaterThan(0);
-        expect(results[0].score).toBeLessThanOrEqual(1);
-    });
-    it('returns empty array when no embeddings', () => {
-        const db = new Database(':memory:');
-        db.exec(`CREATE TABLE embeddings (node_id TEXT PRIMARY KEY, vector BLOB NOT NULL, content_hash TEXT, created_at INTEGER);
-             CREATE TABLE nodes (id TEXT PRIMARY KEY, label TEXT NOT NULL, name TEXT NOT NULL, norm_label TEXT, file_path TEXT, start_line INTEGER, end_line INTEGER, community_id INTEGER, is_exported INTEGER DEFAULT 0, language TEXT, properties TEXT);`);
-        const results = exactVectorSearch(db, new Float32Array([1, 0, 0]), { limit: 5 });
-        expect(results).toHaveLength(0);
-    });
-});
-//# sourceMappingURL=exact-search.test.js.map

package/dist/src/__tests__/search/exact-search.test.js.map

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

package/dist/src/mcp-tools/embed.d.ts

@@ -1,25 +0,0 @@
-/**
- * monograph_embed MCP tool
- *
- * Embeds all symbol nodes in the Monograph knowledge graph using
- * Snowflake/snowflake-arctic-embed-xs (384 dimensions).
- *
- * Requires @huggingface/transformers to be installed.
- * Returns { embedded, skipped, model } on success or an error message.
- */
-import type Database from 'better-sqlite3';
-export interface EmbedToolInput {
-    codeOnly?: boolean;
-    force?: boolean;
-}
-export interface EmbedToolResult {
-    embedded: number;
-    skipped: number;
-    model: string;
-}
-/**
- * Run the embedding pipeline on the open database.
- * Exported so the CLI handler can call it after opening the DB.
- */
-export declare function runEmbed(db: Database.Database, options?: EmbedToolInput): Promise<EmbedToolResult>;
-//# sourceMappingURL=embed.d.ts.map

package/dist/src/mcp-tools/embed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAsB1B"}

package/dist/src/mcp-tools/embed.js

@@ -1,33 +0,0 @@
-/**
- * monograph_embed MCP tool
- *
- * Embeds all symbol nodes in the Monograph knowledge graph using
- * Snowflake/snowflake-arctic-embed-xs (384 dimensions).
- *
- * Requires @huggingface/transformers to be installed.
- * Returns { embedded, skipped, model } on success or an error message.
- */
-const MODEL = 'Snowflake/snowflake-arctic-embed-xs';
-/**
- * Run the embedding pipeline on the open database.
- * Exported so the CLI handler can call it after opening the DB.
- */
-export async function runEmbed(db, options = {}) {
-    const { force = false, codeOnly = false } = options;
-    let getEmbedder;
-    let embedAll;
-    try {
-        const embedderMod = await import('../search/embedder.js');
-        const batchMod = await import('../search/embed-batch.js');
-        getEmbedder = embedderMod.getEmbedder;
-        embedAll = batchMod.embedAll;
-    }
-    catch {
-        throw new Error('@huggingface/transformers is required for embedding. ' +
-            'Install it with: npm install @huggingface/transformers');
-    }
-    const embedder = await getEmbedder();
-    const result = await embedAll(db, embedder, force, codeOnly);
-    return { ...result, model: MODEL };
-}
-//# sourceMappingURL=embed.js.map

package/dist/src/mcp-tools/embed.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"embed.js","sourceRoot":"","sources":["../../../src/mcp-tools/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,MAAM,KAAK,GAAG,qCAAqC,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,EAAqB,EACrB,UAA0B,EAAE;IAE5B,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEpD,IAAI,WAAmC,CAAC;IACxC,IAAI,QAAkH,CAAC;IAEvH,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAC1D,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC;QACtC,QAAQ,GAAG,QAAQ,CAAC,QAA2B,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,uDAAuD;YACrD,wDAAwD,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,EAAE,QAA0C,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAE/F,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/dist/src/pipeline/phases/embeddings.d.ts

@@ -1,6 +0,0 @@
-import type { PipelinePhase } from '../types.js';
-export interface EmbeddingsOutput {
-    embeddingsBuilt: number;
-}
-export declare const embeddingsPhase: PipelinePhase<EmbeddingsOutput>;
-//# sourceMappingURL=embeddings.d.ts.map

package/dist/src/pipeline/phases/embeddings.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAIlE,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,gBAAgB,CAQ3D,CAAC"}

package/dist/src/pipeline/phases/embeddings.js

@@ -1,12 +0,0 @@
-// buildEmbeddings is not yet in embedding-store; phase is a no-op until it's added
-function buildEmbeddings(_db) { }
-export const embeddingsPhase = {
-    name: 'embeddings',
-    deps: ['communities', 'docs-parse', 'pdf-parse', 'contextual-proximity', 'llm-extract'],
-    async execute(ctx) {
-        buildEmbeddings(ctx.db);
-        const row = ctx.db.prepare('SELECT COUNT(*) as n FROM nodes WHERE embedding IS NOT NULL').get();
-        return { embeddingsBuilt: row.n };
-    },
-};
-//# sourceMappingURL=embeddings.js.map

package/dist/src/pipeline/phases/embeddings.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../../../src/pipeline/phases/embeddings.ts"],"names":[],"mappings":"AACA,mFAAmF;AACnF,SAAS,eAAe,CAAC,GAAY,IAA4B,CAAC;AAMlE,MAAM,CAAC,MAAM,eAAe,GAAoC;IAC9D,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,aAAa,CAAC;IACvF,KAAK,CAAC,OAAO,CAAC,GAAoB;QAChC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxB,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,6DAA6D,CAAC,CAAC,GAAG,EAAmB,CAAC;QACjH,OAAO,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;IACpC,CAAC;CACF,CAAC"}

package/dist/src/search/device-config.d.ts

@@ -1,16 +0,0 @@
-export type EmbedDevice = 'cpu' | 'cuda' | 'mps';
-export interface EmbedDeviceConfig {
-    device?: EmbedDevice;
-    threads?: number;
-}
-/**
- * Resolves the compute device to use for local embedders.
- *
- * Priority:
- *  1. Explicit `config.device` if provided
- *  2. 'mps' on macOS (darwin) when not explicitly overridden
- *  3. 'cuda' when CUDA_VISIBLE_DEVICES env var is set (non-empty)
- *  4. 'cpu' as fallback
- */
-export declare function resolveDevice(config?: EmbedDeviceConfig): EmbedDevice;
-//# sourceMappingURL=device-config.d.ts.map

package/dist/src/search/device-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"device-config.d.ts","sourceRoot":"","sources":["../../../src/search/device-config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAcrE"}

package/dist/src/search/device-config.js

@@ -1,22 +0,0 @@
-/**
- * Resolves the compute device to use for local embedders.
- *
- * Priority:
- *  1. Explicit `config.device` if provided
- *  2. 'mps' on macOS (darwin) when not explicitly overridden
- *  3. 'cuda' when CUDA_VISIBLE_DEVICES env var is set (non-empty)
- *  4. 'cpu' as fallback
- */
-export function resolveDevice(config) {
-    if (config?.device) {
-        return config.device;
-    }
-    if (process.platform === 'darwin') {
-        return 'mps';
-    }
-    if (process.env['CUDA_VISIBLE_DEVICES']) {
-        return 'cuda';
-    }
-    return 'cpu';
-}
-//# sourceMappingURL=device-config.js.map

package/dist/src/search/device-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"device-config.js","sourceRoot":"","sources":["../../../src/search/device-config.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/search/embed-batch.d.ts

@@ -1,30 +0,0 @@
-/**
- * Batch-embed all symbol nodes that don't yet have an embedding stored.
- */
-import type Database from 'better-sqlite3';
-import type { EmbedderFn } from './embedder.js';
-import type { EmbedDeviceConfig } from './device-config.js';
-import type { HttpEmbedderConfig } from './http-embedder.js';
-import { countEmbeddings } from '../storage/embedding-store.js';
-export interface EmbedBatchConfig {
-    device?: EmbedDeviceConfig;
-    remote?: HttpEmbedderConfig;
-    batchSize?: number;
-}
-/**
- * Embed a list of text strings and return an array of embedding vectors.
- *
- * If `config.remote` is provided, delegates to `HttpEmbedder`.
- * Otherwise falls back to the local HuggingFace embedder.
- *
- * @param texts  - Strings to embed
- * @param config - Optional device/remote/batchSize config
- */
-export declare function embedBatch(texts: string[], config?: EmbedBatchConfig): Promise<number[][]>;
-export interface EmbedAllResult {
-    embedded: number;
-    skipped: number;
-}
-export declare function embedAll(db: Database.Database, embedder: EmbedderFn, force?: boolean, codeOnly?: boolean): Promise<EmbedAllResult>;
-export { countEmbeddings };
-//# sourceMappingURL=embed-batch.d.ts.map

package/dist/src/search/embed-batch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"embed-batch.d.ts","sourceRoot":"","sources":["../../../src/search/embed-batch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAA0C,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAKxG,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CA6BrB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAcD,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,UAAU,EACpB,KAAK,UAAQ,EACb,QAAQ,UAAQ,GACf,OAAO,CAAC,cAAc,CAAC,CAkDzB;AAgBD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/src/search/embed-batch.js

@@ -1,99 +0,0 @@
-/**
- * Batch-embed all symbol nodes that don't yet have an embedding stored.
- */
-import { upsertEmbedding, ensureEmbeddingSchema, countEmbeddings } from '../storage/embedding-store.js';
-import { embedText } from './embedder.js';
-const BATCH_SIZE = 32;
-/**
- * Embed a list of text strings and return an array of embedding vectors.
- *
- * If `config.remote` is provided, delegates to `HttpEmbedder`.
- * Otherwise falls back to the local HuggingFace embedder.
- *
- * @param texts  - Strings to embed
- * @param config - Optional device/remote/batchSize config
- */
-export async function embedBatch(texts, config) {
-    // Store device config in a local variable (passed through for future use)
-    const _device = config?.device;
-    void _device;
-    if (config?.remote) {
-        const { HttpEmbedder } = await import('./http-embedder.js');
-        const embedder = new HttpEmbedder(config.remote);
-        return embedder.embedBatch(texts);
-    }
-    // Local embedder path
-    const { getEmbedder } = await import('./embedder.js');
-    const embedderFn = await getEmbedder();
-    const batchSize = config?.batchSize ?? BATCH_SIZE;
-    const results = [];
-    for (let i = 0; i < texts.length; i += batchSize) {
-        const batch = texts.slice(i, i + batchSize);
-        const batchResults = await Promise.all(batch.map(async (text) => {
-            const vector = await embedText(text, embedderFn);
-            return Array.from(vector);
-        }));
-        results.push(...batchResults);
-    }
-    return results;
-}
-/**
- * Embed all nodes that are missing embeddings.
- *
- * Nodes are fetched in batches of BATCH_SIZE to avoid loading the entire DB
- * into memory at once.
- *
- * @param db       - Open monograph database
- * @param embedder - Feature extraction pipeline function
- * @param force    - When true, re-embed nodes even if they already have an embedding
- */
-const CODE_LABELS = new Set(['Function', 'Method', 'Class', 'Module', 'Interface', 'Enum', 'Struct', 'Constructor', 'Variable', 'Const', 'TypeAlias']);
-export async function embedAll(db, embedder, force = false, codeOnly = false) {
-    let embedded = 0;
-    let skipped = 0;
-    // Fetch all node IDs and their name+normLabel (used as the text to embed)
-    const rows = db
-        .prepare(`SELECT id, name, norm_label, label, file_path
-       FROM nodes
-       ORDER BY rowid`)
-        .all();
-    const filteredRows = codeOnly ? rows.filter((r) => CODE_LABELS.has(r.label)) : rows;
-    // Build set of node IDs that already have embeddings
-    const existingIds = force
-        ? new Set()
-        : new Set(db.prepare('SELECT node_id FROM embeddings').all().map((r) => r.node_id));
-    // Filter to only rows that need embedding
-    const toEmbed = filteredRows.filter((r) => !existingIds.has(r.id));
-    skipped = filteredRows.length - toEmbed.length;
-    // Ensure schema migration runs once before any upsert — not per-row.
-    if (toEmbed.length > 0)
-        ensureEmbeddingSchema(db);
-    // Process in batches
-    for (let i = 0; i < toEmbed.length; i += BATCH_SIZE) {
-        const batch = toEmbed.slice(i, i + BATCH_SIZE);
-        await Promise.all(batch.map(async (row) => {
-            const text = buildNodeText(row);
-            try {
-                const vector = await embedText(text, embedder);
-                upsertEmbedding(db, row.id, vector);
-                embedded++;
-            }
-            catch {
-                // Skip nodes that fail to embed (e.g. empty name)
-                skipped++;
-            }
-        }));
-    }
-    return { embedded, skipped };
-}
-// ── Helpers ───────────────────────────────────────────────────────────────────
-function buildNodeText(row) {
-    const parts = [row.name, row.label];
-    if (row.norm_label && row.norm_label !== row.name)
-        parts.push(row.norm_label);
-    if (row.file_path)
-        parts.push(row.file_path);
-    return parts.join(' ');
-}
-export { countEmbeddings };
-//# sourceMappingURL=embed-batch.js.map