milens 0.6.2 → 0.6.4

package/adapters/README.md

@@ -0,0 +1,107 @@
+# Milens Adapter Packs
+
+Ready-to-use configuration files for connecting milens MCP server to popular AI coding harnesses.
+
+## What is milens?
+
+Milens is a code intelligence MCP server that provides deep symbol search, dependency graphs, blast-radius analysis, and pre-commit change detection. These adapter packs wire milens into your AI coding tool so it can answer questions like "what calls this function?" and "what breaks if I change this?"
+
+## Available Adapters
+
+| Harness | Directory | What's included |
+|---|---|---|
+| **Claude Code** | `claude-code/` | `.claude/mcp.json` + `CLAUDE.md` |
+| **OpenCode** | `opencode/` | `.opencode/config.json` + `AGENTS.md` |
+| **Codex** | `codex/` | `.codex/codex.md` |
+| **Cursor** | `cursor/` | `.cursorrules` |
+| **GitHub Copilot** | `copilot/` | `.github/copilot-instructions.md` |
+| **Gemini** | `gemini/` | `.gemini/context.md` |
+| **Zed** | `zed/` | `.zed/settings.json` |
+
+## Installation
+
+### Claude Code
+
+```bash
+cp -r adapters/claude-code/.claude .claude/
+cp adapters/claude-code/CLAUDE.md CLAUDE.md
+```
+
+### OpenCode
+
+```bash
+cp -r adapters/opencode/.opencode .opencode/
+cp adapters/opencode/AGENTS.md AGENTS.md
+```
+
+### Codex
+
+```bash
+cp -r adapters/codex/.codex .codex/
+```
+
+### Cursor
+
+```bash
+cp adapters/cursor/.cursorrules .cursorrules
+```
+
+### GitHub Copilot
+
+```bash
+cp -r adapters/copilot/.github .github/
+```
+
+### Gemini
+
+```bash
+cp -r adapters/gemini/.gemini .gemini/
+```
+
+### Zed
+
+```bash
+cp -r adapters/zed/.zed .zed/
+```
+
+## Verification
+
+After installation, verify milens is connected:
+
+1. Start your AI harness
+2. Look for the milens MCP server in the tools list
+3. Run `mcp_milens_status` to confirm the index is healthy
+
+## Index Maintenance
+
+After significant code changes, refresh the index:
+
+```bash
+npx milens analyze -p . --force
+```
+
+## All Tools Available
+
+| Tool | Purpose |
+|---|---|
+| `mcp_milens_overview` | Combined context + impact + grep |
+| `mcp_milens_edit_check` | Pre-edit safety check |
+| `mcp_milens_impact` | Blast radius analysis |
+| `mcp_milens_context` | 360° caller/callee view |
+| `mcp_milens_query` | Symbol definitions by name |
+| `mcp_milens_grep` | Full-text search all files |
+| `mcp_milens_detect_changes` | Pre-commit change detection |
+| `mcp_milens_explain_relationship` | Shortest path between symbols |
+| `mcp_milens_get_file_symbols` | All symbols in a file |
+| `mcp_milens_get_type_hierarchy` | Class inheritance tree |
+| `mcp_milens_find_dead_code` | Unused exported symbols |
+| `mcp_milens_trace` | Execution flow tracing |
+| `mcp_milens_status` | Index health check |
+
+## Safety Rules (applies to all harnesses)
+
+- Never edit a symbol without `mcp_milens_edit_check` first
+- Never delete/rename without `mcp_milens_grep` + `mcp_milens_impact`
+- Never commit without `mcp_milens_detect_changes`
+- Use `mcp_milens_grep` for phrases/UI text, `mcp_milens_query` for code symbols
+- All milens calls require `repo` set to the absolute workspace root

package/adapters/claude-code/.claude/mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "milens": {
+      "command": "npx",
+      "args": ["milens", "serve"],
+      "env": { "MILENS_PROFILE": "standard" }
+    }
+  }
+}

package/adapters/claude-code/CLAUDE.md

@@ -0,0 +1,58 @@
+# Milens — Code Intelligence for Claude Code
+
+Milens is an MCP server that provides deep code intelligence: symbol search, dependency graphs, blast-radius analysis, and pre-commit change detection.
+
+## Available Tools
+
+| Tool | Purpose |
+|---|---|
+| `mcp_milens_query` | Find symbol definitions by name |
+| `mcp_milens_grep` | Text search across ALL project files |
+| `mcp_milens_context` | 360° view: callers + callees |
+| `mcp_milens_impact` | Blast radius before editing |
+| `mcp_milens_detect_changes` | Pre-commit scope check |
+| `mcp_milens_overview` | Combined context + impact + grep |
+| `mcp_milens_edit_check` | Pre-edit safety check |
+| `mcp_milens_explain_relationship` | Shortest path between two symbols |
+| `mcp_milens_get_file_symbols` | All symbols in a file |
+| `mcp_milens_get_type_hierarchy` | Class inheritance tree |
+| `mcp_milens_find_dead_code` | Unused exported symbols |
+| `mcp_milens_trace` | Trace execution flows from entrypoints |
+| `mcp_milens_status` | Index health check |
+
+All tool calls must include `repo` set to the absolute workspace root.
+
+## Session Workflow
+
+1. **Start** — The milens MCP server connects via `npx milens serve`. Verify with `mcp_milens_status`.
+2. **Recall** — When asked to work on a symbol, use `mcp_milens_overview` for a combined view of context, impact, and text references.
+3. **Code** — Make changes following the edit-safety rules below.
+4. **Verify** — Before committing, run `mcp_milens_detect_changes` to confirm only expected files changed.
+5. **Annotate** — After significant changes, run `npx milens analyze -p . --force` to keep the index fresh.
+
+## Edit Safety (Mandatory)
+
+**Before editing any function, class, or method:**
+1. Call `mcp_milens_edit_check` on the target symbol to see callers and export status.
+2. If depth-1 dependents > 5, **stop and warn the user** before proceeding.
+3. Call `mcp_milens_context` to understand the full caller/callee picture.
+4. Only then make the edit.
+
+**Before deleting or renaming:**
+1. `mcp_milens_grep` — find ALL text references (templates, configs, docs).
+2. `mcp_milens_impact` with `direction: "upstream"` — find code-level dependents.
+3. Combine both results before acting.
+
+**Before committing:**
+- Call `mcp_milens_detect_changes` — if unexpected files appear, stop and report.
+
+## Tool Selection
+
+- Use `mcp_milens_query` for symbol names (camelCase, PascalCase, snake_case).
+- Use `mcp_milens_grep` for multi-word phrases, UI labels, error messages, or text in templates/configs/docs.
+- When in doubt, use `mcp_milens_grep` first — it searches everything.
+
+## Reference
+
+See `AGENTS.md` at the repo root for project-specific context and codebase structure.
+Skill files at `.agents/skills/milens/SKILL.md` provide advanced workflow guides.

package/adapters/codex/.codex/codex.md

@@ -0,0 +1,52 @@
+# Milens — Code Intelligence for Codex
+
+Milens provides deep code intelligence for this project via MCP. Connect it in your Codex configuration:
+
+```json
+{
+  "mcpServers": {
+    "milens": {
+      "command": "npx",
+      "args": ["milens", "serve"],
+      "env": { "MILENS_PROFILE": "standard" }
+    }
+  }
+}
+```
+
+## Core Tools (use first)
+
+| Tool | When to use |
+|---|---|
+| `mcp_milens_overview` | First look at any symbol you need to understand or edit — combines context, impact, and text search |
+| `mcp_milens_edit_check` | Before editing any function/class/method — shows callers and export status |
+| `mcp_milens_impact` | Check blast radius — what breaks if this symbol changes |
+| `mcp_milens_query` | Find code symbols by name (camelCase, PascalCase, snake_case) |
+| `mcp_milens_grep` | Full-text search for phrases, UI labels, error strings, docs, configs |
+| `mcp_milens_detect_changes` | Pre-commit check — verify only expected files changed |
+
+All milens MCP calls require `repo` set to the absolute workspace root path.
+
+## Session Workflow
+
+1. **Connect** — Verify milens is running with `mcp_milens_status`.
+2. **Understand** — For any symbol the user mentions, call `mcp_milens_overview` first.
+3. **Edit safely** — Run `mcp_milens_edit_check` before touching any symbol. If dependents > 5, warn the user.
+4. **Verify** — Before committing, call `mcp_milens_detect_changes` to confirm scope.
+5. **Refresh** — After significant changes: `npx milens analyze -p . --force`.
+
+## Safety Rules
+
+- Never edit without `mcp_milens_edit_check` first.
+- Never delete/rename without both `mcp_milens_grep` AND `mcp_milens_impact`.
+- Never commit without `mcp_milens_detect_changes`.
+- Never call milens tools without the `repo` parameter.
+- Use `mcp_milens_grep` (not `mcp_milens_query`) for multi-word or display-text searches.
+
+## Advanced Workflows
+
+See `.agents/skills/milens/SKILL.md` for full documentation, including:
+- `mcp_milens_trace` — execution flow tracing
+- `mcp_milens_get_type_hierarchy` — inheritance trees
+- `mcp_milens_find_dead_code` — dead code detection
+- `mcp_milens_explain_relationship` — how two symbols are connected

package/adapters/copilot/.github/copilot-instructions.md

@@ -0,0 +1,62 @@
+# Milens — Code Intelligence for GitHub Copilot
+
+This project uses [milens](https://opencode.ai) for deep code intelligence. The milens MCP server provides symbol search, dependency graphs, blast-radius analysis, and pre-commit safety checks.
+
+## MCP Configuration
+
+Add to your Copilot MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "milens": {
+      "command": "npx",
+      "args": ["milens", "serve"],
+      "env": { "MILENS_PROFILE": "standard" }
+    }
+  }
+}
+```
+
+All tool calls must include `repo` set to the absolute workspace root.
+
+## Key Tools
+
+| Tool | Purpose |
+|---|---|
+| `mcp_milens_overview` | Combined context + impact + grep in one call |
+| `mcp_milens_edit_check` | Pre-edit safety: callers, export status, warnings |
+| `mcp_milens_impact` | Blast radius — what depends on this symbol |
+| `mcp_milens_context` | 360° view of incoming refs + outgoing deps |
+| `mcp_milens_query` | Symbol lookup by name |
+| `mcp_milens_grep` | Full-text search across all files |
+| `mcp_milens_detect_changes` | Git diff → affected symbols |
+| `mcp_milens_status` | Index health check |
+
+## Session Workflow
+
+1. **Start** — Verify milens is connected: `mcp_milens_status`.
+2. **Recall** — For any symbol, use `mcp_milens_overview` for a comprehensive first look.
+3. **Code** — Edit only after running `mcp_milens_edit_check` on the target.
+4. **Verify** — Before commit: `mcp_milens_detect_changes`.
+5. **Refresh** — After big changes: `npx milens analyze -p . --force`.
+
+## Safety: Always Check Before Editing
+
+- **Before modifying any function/class/method** → `mcp_milens_edit_check`
+  - If depth-1 dependents > 5, warn the user and present alternatives.
+- **Before deleting/renaming any symbol** → `mcp_milens_grep` + `mcp_milens_impact`
+  - Grep catches text/string references; impact catches code references.
+- **Before committing** → `mcp_milens_detect_changes`
+  - Stop and report if unexpected files are in the diff.
+
+## Tool Selection
+
+- Symbol names (camelCase, PascalCase, snake_case) → `mcp_milens_query`
+- Multi-word phrases, UI strings, error messages → `mcp_milens_grep`
+- In doubt → `mcp_milens_grep` first
+
+## Reference
+
+- Full documentation: `.agents/skills/milens/SKILL.md`
+- Project context: `AGENTS.md`

package/adapters/cursor/.cursorrules

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "milens": {
+      "command": "npx",
+      "args": ["milens", "serve"],
+      "env": { "MILENS_PROFILE": "standard" }
+    }
+  }
+}

package/adapters/gemini/.gemini/context.md

@@ -0,0 +1,58 @@
+# Milens — Code Intelligence
+
+This project is indexed by **milens**, an MCP server that provides deep code intelligence (symbol search, dependency graphs, blast-radius analysis, change detection). The index covers 616 symbols, 843 links, across 59 files.
+
+## MCP Connection
+
+```json
+{
+  "mcpServers": {
+    "milens": {
+      "command": "npx",
+      "args": ["milens", "serve"],
+      "env": { "MILENS_PROFILE": "standard" }
+    }
+  }
+}
+```
+
+All milens MCP calls require the `repo` parameter set to the absolute workspace root.
+
+## Essential Tools
+
+| Tool | Description |
+|---|---|
+| `mcp_milens_overview` | First-stop: context + impact + grep combined |
+| `mcp_milens_edit_check` | Pre-edit safety: callers, exports, warnings |
+| `mcp_milens_impact` | Upstream/downstream blast radius |
+| `mcp_milens_context` | Full incoming + outgoing dependency view |
+| `mcp_milens_query` | Symbol search by name |
+| `mcp_milens_grep` | Text search everywhere (templates, configs, docs) |
+| `mcp_milens_detect_changes` | Git-aware change detection |
+| `mcp_milens_trace` | Execution flow from entrypoints |
+| `mcp_milens_find_dead_code` | Unused exported symbols |
+| `mcp_milens_status` | Index health |
+
+## Workflow
+
+**Every session follows this pattern:**
+
+1. **Start** — `mcp_milens_status` to verify the index is healthy.
+2. **Understand** — `mcp_milens_overview({name, repo})` for any symbol mentioned.
+3. **Edit safely** — `mcp_milens_edit_check` before touching hub/shared code. Halt if dependents > 5.
+4. **Verify** — `mcp_milens_detect_changes` before committing. Report unexpected changes.
+5. **Refresh** — `npx milens analyze -p . --force` after significant edits.
+
+## Mandatory Safety Rules
+
+- **Never edit** a symbol without `mcp_milens_edit_check` first.
+- **Never delete/rename** without `mcp_milens_grep` AND `mcp_milens_impact`.
+- **Never commit** without `mcp_milens_detect_changes`.
+- **Never omit** the `repo` parameter from milens calls.
+- **Use `mcp_milens_grep`** (not `mcp_milens_query`) for phrases, UI text, config strings.
+
+## Codebase Structure
+
+- `.agents/skills/milens/SKILL.md` — full milens documentation
+- `.agents/skills/` — area-specific skill files (analyzer, parser, server, store, etc.)
+- `AGENTS.md` — project-level instructions and conventions

package/adapters/opencode/.opencode/config.json

@@ -0,0 +1,9 @@
+{
+  "mcp": {
+    "milens": {
+      "command": "npx",
+      "args": ["milens", "serve"],
+      "env": { "MILENS_PROFILE": "standard" }
+    }
+  }
+}

package/adapters/opencode/AGENTS.md

@@ -0,0 +1,58 @@
+# Milens — Code Intelligence for OpenCode
+
+Milens is an MCP server that provides deep code intelligence: symbol search, dependency graphs, blast-radius analysis, and pre-commit change detection. This file configures OpenCode to use milens automatically.
+
+## Available Tools
+
+| Tool | Purpose |
+|---|---|
+| `mcp_milens_query` | Find symbol definitions by name |
+| `mcp_milens_grep` | Text search across ALL project files |
+| `mcp_milens_context` | 360° view: callers + callees |
+| `mcp_milens_impact` | Blast radius before editing |
+| `mcp_milens_detect_changes` | Pre-commit scope check |
+| `mcp_milens_overview` | Combined context + impact + grep |
+| `mcp_milens_edit_check` | Pre-edit safety check |
+| `mcp_milens_explain_relationship` | Shortest path between two symbols |
+| `mcp_milens_get_file_symbols` | All symbols in a file |
+| `mcp_milens_get_type_hierarchy` | Class inheritance tree |
+| `mcp_milens_find_dead_code` | Unused exported symbols |
+| `mcp_milens_trace` | Trace execution flows from entrypoints |
+| `mcp_milens_status` | Index health check |
+
+All tool calls must include `repo` set to the absolute workspace root.
+
+## Session Workflow
+
+1. **Start** — The milens MCP server connects via the `.opencode/config.json` entry. Verify with `mcp_milens_status`.
+2. **Recall** — When asked to work on a symbol, use `mcp_milens_overview` for a combined view of context, impact, and text references.
+3. **Code** — Make changes following the edit-safety rules below.
+4. **Verify** — Before committing, run `mcp_milens_detect_changes` to confirm only expected files changed.
+5. **Annotate** — After significant changes, run `npx milens analyze -p . --force` to keep the index fresh.
+
+## Edit Safety (Mandatory)
+
+**Before editing any function, class, or method:**
+1. Call `mcp_milens_edit_check` on the target symbol to see callers and export status.
+2. If depth-1 dependents > 5, **stop and warn the user** before proceeding.
+3. Call `mcp_milens_context` to understand the full caller/callee picture.
+4. Only then make the edit.
+
+**Before deleting or renaming:**
+1. `mcp_milens_grep` — find ALL text references (templates, configs, docs).
+2. `mcp_milens_impact` with `direction: "upstream"` — find code-level dependents.
+3. Combine both results before acting.
+
+**Before committing:**
+- Call `mcp_milens_detect_changes` — if unexpected files appear, stop and report.
+
+## Tool Selection
+
+- Use `mcp_milens_query` for symbol names (camelCase, PascalCase, snake_case).
+- Use `mcp_milens_grep` for multi-word phrases, UI labels, error messages, or text in templates/configs/docs.
+- When in doubt, use `mcp_milens_grep` first — it searches everything.
+
+## Reference
+
+Skill files at `.agents/skills/milens/SKILL.md` provide advanced workflow guides.
+See the project `AGENTS.md` for codebase-specific context.

package/adapters/zed/.zed/settings.json

@@ -0,0 +1,8 @@
+{
+  "context_servers": {
+    "milens": {
+      "command": "npx milens serve",
+      "env": { "MILENS_PROFILE": "minimal" }
+    }
+  }
+}

package/dist/agents-md.d.ts

@@ -0,0 +1,3 @@
+import { Database } from './store/db.js';
+export declare function generateAgentsMd(db: Database, rootPath: string): string;
+//# sourceMappingURL=agents-md.d.ts.map

package/dist/agents-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA0CzC,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+EvE"}

package/dist/agents-md.js

@@ -0,0 +1,112 @@
+import { readFileSync } from 'node:fs';
+import { join, relative, basename, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function readMilensVersion() {
+    const candidates = [
+        join(__dirname, '..', 'package.json'),
+        join(__dirname, '..', '..', 'package.json'),
+    ];
+    for (const p of candidates) {
+        try {
+            const pkg = JSON.parse(readFileSync(p, 'utf-8'));
+            if (pkg.version)
+                return pkg.version;
+        }
+        catch { }
+    }
+    return 'unknown';
+}
+function countDependents(db, symbolId) {
+    const links = db.getIncomingLinks(symbolId);
+    const uniqueFrom = new Set();
+    for (const l of links) {
+        if (l.type !== 'contains')
+            uniqueFrom.add(l.fromId);
+    }
+    return uniqueFrom.size;
+}
+function relativeFilePath(filePath, rootPath) {
+    const rel = relative(rootPath, filePath);
+    return rel.replace(/\\/g, '/');
+}
+function findRouteSymbols(db) {
+    const all = db.getAllSymbols();
+    const routePatterns = /[\/\\]route\.[jt]sx?$|[\/\\]router[\/\\]|[\/\\]routes[\/\\]|[\/\\]api[\/\\]/;
+    return all.filter(s => routePatterns.test(s.filePath) && s.exported && (s.kind === 'function' || s.kind === 'method' || s.kind === 'class'));
+}
+export function generateAgentsMd(db, rootPath) {
+    const version = readMilensVersion();
+    const date = new Date().toISOString().split('T')[0];
+    const repoName = basename(rootPath);
+    const summary = db.getCodebaseSummary();
+    const lines = [];
+    lines.push(`# Project: ${repoName}`);
+    lines.push('');
+    lines.push(`> Auto-generated by milens ${version} on ${date}`);
+    lines.push('');
+    lines.push('## Codebase Summary');
+    lines.push(`- Symbols: ${summary.symbols} | Links: ${summary.links} | Files: ${summary.files}`);
+    lines.push(`- Test coverage: ${summary.coveragePct}%`);
+    lines.push('');
+    lines.push('## Domain Map');
+    lines.push('| Domain | Files | Symbols | Description |');
+    lines.push('|---|---|---|---|');
+    if (summary.domains.length > 0) {
+        for (const d of summary.domains) {
+            lines.push(`| ${d.domain} | ${d.files} | ${d.symbols} |  |`);
+        }
+    }
+    else {
+        lines.push('| (none) | 0 | 0 | No domain clusters detected |');
+    }
+    lines.push('');
+    lines.push('## Critical Symbols (Top Hubs — DO NOT modify without impact check)');
+    lines.push('| Symbol | Kind | File | Heat | Dependents | Risk |');
+    lines.push('|---|---|---|---|---|---|');
+    const hubs = summary.topHubs.filter(h => (h.heat ?? 0) > 0);
+    if (hubs.length > 0) {
+        for (const hub of hubs) {
+            const heat = hub.heat ?? 0;
+            const dependents = countDependents(db, hub.id);
+            const file = relativeFilePath(hub.filePath, rootPath);
+            const risk = heat >= 10 ? 'HIGH' : heat >= 5 ? 'MEDIUM' : 'LOW';
+            lines.push(`| ${hub.name} | ${hub.kind} | ${file}:${hub.startLine} | ${heat} | ${dependents} | ${risk} |`);
+        }
+    }
+    else {
+        lines.push('| (none) | — | — | — | — | — |');
+    }
+    lines.push('');
+    const routes = findRouteSymbols(db);
+    lines.push('## API Endpoints');
+    if (routes.length > 0) {
+        lines.push('| Method | Path | Handler | File |');
+        lines.push('|---|---|---|---|');
+        for (const sym of routes.slice(0, 30)) {
+            const file = relativeFilePath(sym.filePath, rootPath);
+            const name = sym.signature ?? sym.name;
+            lines.push(`| — | — | ${name} | ${file}:${sym.startLine} |`);
+        }
+    }
+    else {
+        lines.push('');
+        lines.push('No routes detected.');
+    }
+    lines.push('');
+    lines.push('## Milens Workflows Available');
+    lines.push('- `/milens:plan "feature"` — generate implementation plan');
+    lines.push('- `/milens:review` — review current changes');
+    lines.push('- `/milens:tdd <symbol>` — write tests with coverage analysis');
+    lines.push('- `/milens:security` — security audit');
+    lines.push('- `/milens:refactor <symbol>` — safe refactor with blast radius check');
+    lines.push('');
+    lines.push('## Session Startup');
+    lines.push('When starting work, call:');
+    lines.push('1. session_start({agent: "your-agent-name"})');
+    lines.push('2. recall({}) — retrieve past annotations');
+    lines.push('3. codebase_summary({}) — refresh context');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=agents-md.js.map

package/dist/agents-md.js.map

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

package/dist/analyzer/engine.d.ts

@@ -5,6 +5,7 @@ interface EngineOptions {
     verbose?: boolean;
     force?: boolean;
     aliases?: Record<string, string>;
+    embeddings?: boolean;
 }
 export declare function analyze(opts: EngineOptions): Promise<AnalysisStats>;
 export {};

package/dist/analyzer/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/analyzer/engine.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAyJ,aAAa,EAAE,MAAM,aAAa,CAAC;AAgExM,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAmBD,wBAAsB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAwRzE"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/analyzer/engine.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAyJ,aAAa,EAAE,MAAM,aAAa,CAAC;AAgExM,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAmBD,wBAAsB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAkTzE"}

package/dist/analyzer/engine.js

@@ -10,7 +10,9 @@ import { extractHtmlScripts, extractHtmlRefs } from '../parser/lang-html.js';
 import { extractMarkdown } from '../parser/lang-md.js';
 import { resolveLinksWithStats } from './resolver.js';
 import { enrichMetadata } from './enrich.js';
+import { isTestFile } from '../utils.js';
 import { Database } from '../store/db.js';
+import { TfIdfProvider, EmbeddingStore, buildEmbeddingText } from '../store/vectors.js';
 // ── Async batch file reader ──
 // Reads multiple files concurrently with concurrency limit to avoid fd exhaustion
 const READ_CONCURRENCY = 32;
@@ -327,6 +329,31 @@ export async function analyze(opts) {
         db.setMeta('exported_production_symbols', String(exportedProduction.length));
         db.rebuildSearch();
     });
+    // Phase 8: Generate embeddings (optional)
+    if (opts.embeddings) {
+        const provider = new TfIdfProvider();
+        const texts = allSymbols.map(s => buildEmbeddingText({
+            name: s.name, kind: s.kind, filePath: s.filePath, signature: s.signature,
+        }));
+        provider.trainIdf(texts);
+        await provider.init();
+        const store = new EmbeddingStore(db.connection, provider.dimensions);
+        const EMBED_BATCH = 200;
+        let embedded = 0;
+        for (let i = 0; i < allSymbols.length; i += EMBED_BATCH) {
+            const batch = allSymbols.slice(i, i + EMBED_BATCH);
+            const batchTexts = texts.slice(i, i + EMBED_BATCH);
+            const vecs = await provider.embedBatch(batchTexts);
+            db.transaction(() => {
+                for (let j = 0; j < batch.length; j++) {
+                    store.store(batch[j].id, vecs[j], provider.name);
+                }
+            });
+            embedded += batch.length;
+        }
+        if (opts.verbose)
+            console.log(`[embed] Generated ${embedded} embeddings (${provider.name})`);
+    }
     const stats = {
         filesScanned: files.length,
         filesParsed,
@@ -488,12 +515,4 @@ function parseDocFile(source, filePath, spec) {
     }
     return null;
 }
-/** Check if a file path looks like a test/spec file */
-function isTestFile(filePath) {
-    return /\.(test|spec)\.[jt]sx?$/.test(filePath) ||
-        /^tests?[/\\]/.test(filePath) ||
-        /__tests__[/\\]/.test(filePath) ||
-        /_test\.(go|py|rb|rs|java|php)$/.test(filePath) ||
-        /^test_.*\.py$/.test(filePath.split('/').pop() ?? '');
-}
 //# sourceMappingURL=engine.js.map