refactor: extract embedder into src/embeddings/ subsystem (ROADMAP 3.10)

.github/workflows/benchmark.yml

@@ -228,7 +228,7 @@ jobs:
         uses: actions/cache@v5
         with:
           path: ~/.cache/huggingface
-          key: hf-models-${{ runner.os }}-${{ hashFiles('src/embedder.js') }}
+          key: hf-models-${{ runner.os }}-${{ hashFiles('src/embeddings/**') }}
           restore-keys: hf-models-${{ runner.os }}-
 
       - name: Build graph

.github/workflows/embedding-regression.yml

@@ -6,7 +6,7 @@ on:
   workflow_dispatch:
   pull_request:
     paths:
-      - 'src/embedder.js'
+      - 'src/embeddings/**'
       - 'tests/search/**'
       - 'package.json'
 

CLAUDE.md

@@ -45,7 +45,7 @@ JS source is plain JavaScript (ES modules) in `src/`. No transpilation step. The
 | `builder.js` | Graph building: file collection, parsing, import resolution, incremental hashing |
 | `parser.js` | tree-sitter WASM wrapper; `LANGUAGE_REGISTRY` + per-language extractors for functions, classes, methods, imports, exports, call sites |
 | `queries.js` | Query functions: symbol search, file deps, impact analysis, diff-impact; `SYMBOL_KINDS` constant defines all node kinds |
-| `embedder.js` | Semantic search with `@huggingface/transformers`; multi-query RRF ranking |
+| `embeddings/` | Embedding subsystem: model management, vector generation, semantic/keyword/hybrid search, CLI formatting |
 | `db.js` | SQLite schema and operations (`better-sqlite3`) |
 | `mcp.js` | MCP server exposing graph queries to AI agents; single-repo by default, `--multi-repo` to enable cross-repo access |
 | `cycles.js` | Circular dependency detection |

scripts/embedding-benchmark.js

@@ -26,7 +26,7 @@ const { version, srcDir, cleanup } = await resolveBenchmarkSource();
 const dbPath = path.join(root, '.codegraph', 'graph.db');
 
 const { buildEmbeddings, MODELS, searchData, disposeModel } = await import(
-	srcImport(srcDir, 'embedder.js')
+	srcImport(srcDir, 'embeddings/index.js')
 );
 
 // Redirect console.log to stderr so only JSON goes to stdout

src/cli/commands/embed.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { buildEmbeddings, DEFAULT_MODEL, EMBEDDING_STRATEGIES } from '../../embedder.js';
+import { buildEmbeddings, DEFAULT_MODEL, EMBEDDING_STRATEGIES } from '../../embeddings/index.js';
 
 export const command = {
   name: 'embed [dir]',

src/cli/commands/models.js

@@ -1,4 +1,4 @@
-import { DEFAULT_MODEL, MODELS } from '../../embedder.js';
+import { DEFAULT_MODEL, MODELS } from '../../embeddings/index.js';
 
 export const command = {
   name: 'models',

src/cli/commands/search.js

@@ -1,4 +1,4 @@
-import { search } from '../../embedder.js';
+import { search } from '../../embeddings/index.js';
 
 export const command = {
   name: 'search <query>',