milens 0.7.0 → 0.7.1

package/.agents/skills/security/SKILL.md

@@ -26,18 +26,18 @@ When working with code in **security/**, follow these mandatory safety rules:
 | See file symbols | `mcp_milens_get_file_symbols` |
 
 ## Overview
-Contains 44 symbols (15 exported) across 2 files.
+Contains 45 symbols (15 exported) across 2 files.
 
 ## Key Symbols
-- **`loadRules`** [function] (src/security/rules.ts:1301) — 6 refs
+- **`loadRules`** [function] (src/security/rules.ts:1302) — 6 refs
 - **`auditDependencies`** [function] (src/security/deps.ts:732) — 4 refs
 - **`detectEcosystem`** [function] (src/security/deps.ts:512) — 3 refs
 - **`parseDependencies`** [function] (src/security/deps.ts:524) — 3 refs
 - **`checkVulnerabilities`** [function] (src/security/deps.ts:687) — 3 refs
 - **`Ecosystem`** [type] (src/security/deps.ts:8) — 3 refs
 - **`VulnerabilityReport`** [interface] (src/security/deps.ts:26) — 2 refs
-- **`getRulesByCategory`** [function] (src/security/rules.ts:1308) — 2 refs
-- **`getRulesBySeverity`** [function] (src/security/rules.ts:1312) — 2 refs
+- **`getRulesByCategory`** [function] (src/security/rules.ts:1309) — 2 refs
+- **`getRulesBySeverity`** [function] (src/security/rules.ts:1313) — 2 refs
 - **`SecurityCategory`** [type] (src/security/rules.ts:3) — 1 refs
 - **`Dependency`** [interface] (src/security/deps.ts:10) — 0 refs
 - **`Vulnerability`** [interface] (src/security/deps.ts:16) — 0 refs
@@ -52,11 +52,6 @@ Contains 44 symbols (15 exported) across 2 files.
 - **`detectEcosystem`** [function] — 3 incoming references
 - **`parseDependencies`** [function] — 3 incoming references
 
-## Dependencies
-- **scripts**: `version`
-- **test**: `add`
-- **root**: `has`
-
 ## Used By
 - **root**: `loadRules`, `auditDependencies`
 - **server**: `loadRules`

package/.agents/skills/server/SKILL.md

@@ -26,49 +26,52 @@ When working with code in **server/**, follow these mandatory safety rules:
 | See file symbols | `mcp_milens_get_file_symbols` |
 
 ## Overview
-Contains 102 symbols (16 exported) across 5 files.
+Contains 113 symbols (22 exported) across 10 files.
 
 ## Key Symbols
-- **`HookManager`** [class] (src/server/hooks.ts:43) — 8 refs
+- **`HookManager`** [class] (src/server/hooks.ts:43) — 9 refs
+- **`Deps`** [interface] (src/server/tools/deps.ts:4) — 9 refs
+- **`defaultOnSessionStart`** [function] (src/server/hooks.ts:100) — 8 refs
+- **`defaultOnSessionEnd`** [function] (src/server/hooks.ts:174) — 8 refs
+- **`defaultOnPreCompact`** [function] (src/server/hooks.ts:350) — 8 refs
+- **`defaultOnPostCompact`** [function] (src/server/hooks.ts:368) — 8 refs
 - **`HookConfig`** [interface] (src/server/hooks.ts:5) — 5 refs
-- **`defaultOnSessionStart`** [function] (src/server/hooks.ts:100) — 4 refs
-- **`defaultOnSessionEnd`** [function] (src/server/hooks.ts:174) — 4 refs
+- **`FileWatcher`** [class] (src/server/watcher.ts:50) — 5 refs
 - **`defaultOnPreCommit`** [function] (src/server/hooks.ts:237) — 4 refs
 - **`defaultOnFileChange`** [function] (src/server/hooks.ts:323) — 4 refs
-- **`defaultOnPreCompact`** [function] (src/server/hooks.ts:350) — 4 refs
-- **`defaultOnPostCompact`** [function] (src/server/hooks.ts:368) — 4 refs
 - **`SessionContext`** [interface] (src/server/hooks.ts:15) — 4 refs
-- **`registerAllPrompts`** [function] (src/server/mcp-prompts.ts:637) — 4 refs
-- **`createMcpServer`** [function] (src/server/mcp.ts:451) — 4 refs
-- **`generateTestPlan`** [function] (src/server/test-plan.ts:39) — 4 refs
-- **`FileWatcher`** [class] (src/server/watcher.ts:50) — 3 refs
-- **`startStdio`** [function] (src/server/mcp.ts:2975) — 2 refs
-- **`startHttp`** [function] (src/server/mcp.ts:3014) — 2 refs
+- **`registerAllPrompts`** [function] (src/server/mcp-prompts.ts:623) — 4 refs
+- **`createMcpServer`** [function] (src/server/mcp.ts:452) — 4 refs
+- **`startStdio`** [function] (src/server/mcp.ts:2306) — 4 refs
+- **`startHttp`** [function] (src/server/mcp.ts:2363) — 4 refs
 
 ## Entry Points
-- **`get`** [method] — 13 incoming references
-- **`HookManager`** [class] — 8 incoming references
-- **`loadConfig`** [method] — 7 incoming references
-- **`HookConfig`** [interface] — 5 incoming references
-- **`defaultOnSessionStart`** [function] — 4 incoming references
+- **`HookManager`** [class] — 9 incoming references
+- **`Deps`** [interface] — 9 incoming references
+- **`defaultOnSessionStart`** [function] — 8 incoming references
+- **`defaultOnSessionEnd`** [function] — 8 incoming references
+- **`defaultOnPreCompact`** [function] — 8 incoming references
 
 ## Dependencies
-- **store**: `Database`, `AnnotationStore`, `RepoRegistry`, `runDecayPass`, `getCodebaseSummary`, `recall`, `close`, `getStats` (+36 more)
-- **root**: `generateCrossRefSection`, `has`
-- **analyzer**: `reviewPr`, `analyze`, `resolve`, `clear`
+- **store**: `Database`, `AnnotationStore`, `RepoRegistry`, `runDecayPass`, `getCodebaseSummary`, `recall`, `getStats`, `getTestCoverage` (+36 more)
+- **root**: `generateCrossRefSection`, `globToRegex`
+- **analyzer**: `reviewPr`, `countDependentFiles`, `analyze`
 - **parser**: `getParser`, `loadLanguage`, `ALL_LANGS`
-- **security**: `loadRules`
 - **orchestrator**: `Orchestrator`, `loadSnapshots`, `snapshot`, `persistSnapshots`, `compare`, `runAndFormat`
-- **test**: `add`, `dbPath`
-- **scripts**: `root`
+- **security**: `loadRules`
 
 ## Used By
-- **root**: `startHttp`, `startStdio`, `HookManager`, `get`, `enableHook`, `loadConfig`, `saveConfig`, `disableHook`
-- **test**: `HookManager`, `HookConfig`, `defaultOnSessionStart`, `defaultOnSessionEnd`, `defaultOnPreCommit`, `defaultOnFileChange`, `defaultOnPreCompact`, `defaultOnPostCompact` (+10 more)
+- **root**: `startHttp`, `startStdio`, `HookManager`, `defaultOnSessionStart`, `defaultOnSessionEnd`, `defaultOnPreCompact`, `defaultOnPostCompact`, `enableHook` (+3 more)
+- **test**: `defaultOnSessionStart`, `defaultOnPreCompact`, `defaultOnSessionEnd`, `defaultOnPostCompact`, `HookManager`, `HookConfig`, `defaultOnPreCommit`, `defaultOnFileChange` (+19 more)
 
 ## Files
 - src/server/hooks.ts
 - src/server/mcp-prompts.ts
 - src/server/mcp.ts
 - src/server/test-plan.ts
+- src/server/tools/deps.ts
+- src/server/tools/resources.ts
+- src/server/tools/security.ts
+- src/server/tools/session.ts
+- src/server/tools/testing.ts
 - src/server/watcher.ts

package/.agents/skills/store/SKILL.md

@@ -26,46 +26,42 @@ When working with code in **store/**, follow these mandatory safety rules:
 | See file symbols | `mcp_milens_get_file_symbols` |
 
 ## Overview
-Contains 135 symbols (15 exported) across 5 files.
+Contains 139 symbols (15 exported) across 5 files.
 
 ## Key Symbols
 - **`Database`** [class] (src/store/db.ts:10) — 80 refs
-- **`AnnotationStore`** [class] (src/store/annotations.ts:10) — 19 refs
+- **`AnnotationStore`** [class] (src/store/annotations.ts:10) — 21 refs
 - **`RepoRegistry`** [class] (src/store/registry.ts:18) — 16 refs
-- **`runDecayPass`** [function] (src/store/confidence.ts:85) — 6 refs
+- **`runDecayPass`** [function] (src/store/confidence.ts:87) — 6 refs
 - **`buildEmbeddingText`** [function] (src/store/vectors.ts:250) — 4 refs
 - **`TfIdfProvider`** [class] (src/store/vectors.ts:44) — 4 refs
 - **`EmbeddingStore`** [class] (src/store/vectors.ts:170) — 4 refs
-- **`decayConfidence`** [function] (src/store/confidence.ts:22) — 3 refs
+- **`decayConfidence`** [function] (src/store/confidence.ts:23) — 3 refs
 - **`boostConfidence`** [function] (src/store/confidence.ts:6) — 2 refs
-- **`getStaleAnnotations`** [function] (src/store/confidence.ts:38) — 2 refs
-- **`promoteSecurityAnnotations`** [function] (src/store/confidence.ts:48) — 2 refs
-- **`autoPromote`** [function] (src/store/confidence.ts:106) — 2 refs
+- **`getStaleAnnotations`** [function] (src/store/confidence.ts:40) — 2 refs
+- **`promoteSecurityAnnotations`** [function] (src/store/confidence.ts:50) — 2 refs
+- **`autoPromote`** [function] (src/store/confidence.ts:108) — 2 refs
 - **`EmbeddingProvider`** [interface] (src/store/vectors.ts:15) — 2 refs
 - **`NeuralProvider`** [class] (src/store/vectors.ts:122) — 0 refs
 - **`SimilarResult`** [interface] (src/store/vectors.ts:23) — 0 refs
 
 ## Entry Points
 - **`Database`** [class] — 80 incoming references
-- **`close`** [method] — 33 incoming references
-- **`get`** [method] — 23 incoming references
-- **`AnnotationStore`** [class] — 19 incoming references
+- **`AnnotationStore`** [class] — 21 incoming references
 - **`RepoRegistry`** [class] — 16 incoming references
+- **`findSymbolById`** [method] — 14 incoming references
+- **`rowToSymbol`** [function] — 13 incoming references
 
 ## Dependencies
-- **root**: `Annotation`, `AnnotationKey`, `Session`, `EvolutionEvent`, `CodeSymbol`, `SymbolLink`, `RepoEntry`, `has` (+1 more)
-- **test**: `add`, `dbPath`
-- **analyzer**: `resolve`
+- **root**: `Annotation`, `AnnotationKey`, `Session`, `EvolutionEvent`, `CodeSymbol`, `SymbolLink`, `RepoEntry`
 
 ## Used By
-- **root**: `Database`, `RepoRegistry`, `AnnotationStore`, `runDecayPass`, `getIncomingLinks`, `getAllSymbols`, `getCodebaseSummary`, `register` (+24 more)
-- **analyzer**: `Database`, `TfIdfProvider`, `EmbeddingStore`, `buildEmbeddingText`, `get`, `isFileUpToDate`, `upsertFileHash`, `getSymbolsByFile` (+22 more)
-- **orchestrator**: `Database`, `findSymbolByName`, `findUpstream`, `clear`, `getTestCoverageGaps`, `findDeadCode`, `close`
-- **server**: `Database`, `AnnotationStore`, `RepoRegistry`, `runDecayPass`, `getCodebaseSummary`, `recall`, `close`, `getStats` (+36 more)
-- **test**: `Database`, `AnnotationStore`, `RepoRegistry`, `boostConfidence`, `decayConfidence`, `getStaleAnnotations`, `promoteSecurityAnnotations`, `runDecayPass` (+77 more)
-- **apps**: `remove`, `getAnnotations`, `Database`, `getCodebaseSummary`, `close`
-- **docs**: `remove`
-- **scripts**: `Database`, `getCodebaseSummary`, `close`
+- **root**: `Database`, `RepoRegistry`, `AnnotationStore`, `runDecayPass`, `getIncomingLinks`, `getAllSymbols`, `getCodebaseSummary`, `findDbPath` (+22 more)
+- **analyzer**: `Database`, `TfIdfProvider`, `EmbeddingStore`, `buildEmbeddingText`, `isFileUpToDate`, `upsertFileHash`, `getSymbolsByFile`, `transaction` (+18 more)
+- **orchestrator**: `Database`, `findSymbolByName`, `findUpstream`, `getTestCoverageGaps`, `findDeadCode`
+- **server**: `Database`, `AnnotationStore`, `RepoRegistry`, `runDecayPass`, `getCodebaseSummary`, `recall`, `getStats`, `getTestCoverage` (+36 more)
+- **test**: `Database`, `AnnotationStore`, `RepoRegistry`, `boostConfidence`, `decayConfidence`, `getStaleAnnotations`, `promoteSecurityAnnotations`, `runDecayPass` (+76 more)
+- **apps**: `remove`, `getAnnotations`, `Database`, `getCodebaseSummary`
 - **parser**: `load`
 
 ## Files

package/.agents/skills/test/SKILL.md

@@ -26,13 +26,12 @@ When working with code in **test/**, follow these mandatory safety rules:
 | See file symbols | `mcp_milens_get_file_symbols` |
 
 ## Overview
-Contains 328 symbols (119 exported) across 77 files.
+Contains 351 symbols (119 exported) across 80 files.
 
 ## Key Symbols
 - **`User`** [class] (test/fixtures/accuracy/py-project/src/models.py:1) — 6 refs
 - **`Calculator`** [class] (test/fixtures/accuracy/js-project/src/calculator.js:1) — 5 refs
 - **`User`** [interface] (test/fixtures/ts-project/src/models.ts:1) — 5 refs
-- **`save`** [method] (test/fixtures/accuracy/py-project/src/models.py:14) — 4 refs
 - **`User`** [interface] (test/fixtures/accuracy/ts-project/src/models.ts:1) — 3 refs
 - **`User`** [class] (test/fixtures/py-project/models.py:1) — 3 refs
 - **`User`** [class] (test/fixtures/accuracy/ruby-project/src/models.rb:1) — 3 refs
@@ -43,35 +42,28 @@ Contains 328 symbols (119 exported) across 77 files.
 - **`UserService`** [class] (test/fixtures/ts-project/src/nest-sample.ts:27) — 2 refs
 - **`Save`** [method] (test/fixtures/accuracy/go-project/src/models/user.go:16) — 2 refs
 - **`UserRepo`** [class] (test/fixtures/accuracy/py-project/src/models.py:10) — 2 refs
+- **`save`** [method] (test/fixtures/accuracy/py-project/src/models.py:14) — 2 refs
 - **`UserService`** [class] (test/fixtures/accuracy/py-project/src/service.py:4) — 2 refs
 
 ## Entry Points
-- **`add`** [method] — 46 incoming references
-- **`lang`** [variable] — 12 incoming references
-- **`dbPath`** [function] — 10 incoming references
+- **`dbPath`** [function] — 8 incoming references
 - **`User`** [class] — 6 incoming references
 - **`Calculator`** [class] — 5 incoming references
+- **`User`** [interface] — 5 incoming references
+- **`lang`** [variable] — 5 incoming references
 
 ## Dependencies
-- **analyzer**: `analyze`, `loadAliases`, `getCachedTree`, `clearTreeCache`, `enrichMetadata`, `resolveLinksWithStats`, `resolveLinks`, `reviewSymbol` (+10 more)
-- **store**: `Database`, `AnnotationStore`, `RepoRegistry`, `boostConfidence`, `decayConfidence`, `getStaleAnnotations`, `promoteSecurityAnnotations`, `runDecayPass` (+77 more)
+- **analyzer**: `analyze`, `loadAliases`, `getCachedTree`, `clearTreeCache`, `enrichMetadata`, `resolveLinksWithStats`, `resolveLinks`, `reviewSymbol` (+9 more)
+- **store**: `Database`, `AnnotationStore`, `RepoRegistry`, `boostConfidence`, `decayConfidence`, `getStaleAnnotations`, `promoteSecurityAnnotations`, `runDecayPass` (+76 more)
 - **root**: `generateAgentsMd`, `AnnotationKey`, `CodeSymbol`, `SymbolLink`, `computeMetrics`, `formatMetricsReport`, `MilensMetrics`, `RawImport` (+17 more)
+- **server**: `defaultOnSessionStart`, `defaultOnPreCompact`, `defaultOnSessionEnd`, `defaultOnPostCompact`, `HookManager`, `HookConfig`, `defaultOnPreCommit`, `defaultOnFileChange` (+19 more)
 - **security**: `detectEcosystem`, `parseDependencies`, `checkVulnerabilities`, `auditDependencies`, `loadRules`, `getRulesByCategory`, `getRulesBySeverity`
 - **parser**: `getParser`, `loadLanguage`, `extractFromTree`, `extractVueScript`, `extractVueTemplateRefs`, `extractVueCompositionApi`, `extractVueTemplateAst`, `spec` (+11 more)
-- **server**: `HookManager`, `HookConfig`, `defaultOnSessionStart`, `defaultOnSessionEnd`, `defaultOnPreCommit`, `defaultOnFileChange`, `defaultOnPreCompact`, `defaultOnPostCompact` (+10 more)
 - **orchestrator**: `Orchestrator`, `formatReport`, `OrchestratorReport`, `subscribe`, `run`, `snapshot`, `compare`, `cancel` (+3 more)
-- **scripts**: `root`
+- **scripts**: `detectTypeFromBranch`, `detectScopeFromBranch`, `detectBreakingFromBranch`, `detectBreakingFromLabels`, `slugify`, `parseArgs`, `generateTitle`, `generateBody` (+1 more)
 
 ## Used By
-- **apps**: `add`, `dbPath`
-- **docs**: `add`
-- **root**: `add`, `dbPath`
-- **analyzer**: `add`, `parser`, `lang`
-- **orchestrator**: `add`
-- **parser**: `lang`, `add`, `parser`
-- **security**: `add`
-- **server**: `add`, `dbPath`
-- **store**: `add`, `dbPath`
+- **apps**: `create`
 
 ## Files
 - test/fixtures/accuracy/go-project/src/admin.go
@@ -133,21 +125,24 @@ Contains 328 symbols (119 exported) across 77 files.
 - test/unit/markdown.test.ts
 - test/unit/mcp-prompts.test.ts
 - test/unit/mcp-tools.test.ts
+- test/unit/mcp-transport.test.ts
 - test/unit/metrics.test.ts
 - test/unit/mro.test.ts
 - test/unit/orchestrator.test.ts
 - test/unit/parser-extract-cache.test.ts
 - test/unit/parser-loader.test.ts
+- test/unit/pr-generator.test.ts
 - test/unit/registry.test.ts
 - test/unit/resolver.test.ts
 - test/unit/review.test.ts
+- test/unit/risk.test.ts
 - test/unit/scanner.test.ts
 - test/unit/scope-resolver.test.ts
 - test/unit/security-rules.test.ts
 - test/unit/server-test-plan.test.ts
 - test/unit/skills.test.ts
-- test/unit/testplan.test.ts
 - test/unit/uninstall.test.ts
 - test/unit/utils.test.ts
 - test/unit/vectors.test.ts
 - test/unit/vue-import.test.ts
+- test/unit/watcher.test.ts

package/.agents/skills/ui/SKILL.md

@@ -44,7 +44,7 @@ Contains 10 symbols (3 exported) across 1 files.
 - **root**: `AnalysisStats`
 
 ## Used By
-- **analyzer**: `ProgressPhase`, `ProgressReporter`, `startPhase`, `tick`, `endPhase`, `done`, `finalize`
+- **analyzer**: `ProgressPhase`, `ProgressReporter`, `startPhase`, `tick`, `endPhase`, `finalize`
 - **root**: `createProgressReporter`, `finalize`
 
 ## Files

package/README.md

@@ -98,20 +98,29 @@ Then connect your editor:
 claude mcp add milens -- milens serve -p .
 ```
 
-Or in .mcp.json at plugin root:
+Or drop this in `.mcp.json` at your project root (equivalent, works the same in the CLI, VS Code extension, and desktop app):
 
-```bash
+```json
 {
   "mcpServers": {
     "milens": {
       "type": "stdio",
       "command": "milens",
-      "args": ["serve", "-p", "${workspaceFolder}"]
+      "args": ["serve", "-p", "."]
     }
   }
 }
 ```
 
+Or install as a plugin from the marketplace:
+
+```bash
+/plugin marketplace add fuze210699/milens
+/plugin install milens
+```
+
+See [adapters/README.md](adapters/README.md#claude-code--via-plugin-install-marketplace) for how this avoids the workspace-root pitfall that broke earlier plugin builds.
+
 <details>
 <summary><b>More editors</b> — Cursor, OpenCode, Codex, Gemini, Zed</summary>
 

package/adapters/README.md

@@ -1,107 +1,144 @@
-# 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
+# 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` (+ optional hooks snippet) |
+| **OpenCode** | `opencode/` | `.opencode/config.json` + `AGENTS.md` |
+| **Codex** | `codex/` | `.codex/config.toml` + `.codex/codex.md` |
+| **Cursor** | `cursor/` | `.cursor/mcp.json` + `.cursorrules` |
+| **GitHub Copilot** | `copilot/` | `.vscode/mcp.json` + `.github/copilot-instructions.md` |
+| **Gemini** | `gemini/` | `.gemini/settings.json` + `.gemini/context.md` |
+| **Zed** | `zed/` | `.zed/settings.json` |
+
+## Installation
+
+### Claude Code
+
+Register milens as a **project-scoped MCP server** — this is the one method that works identically across the Claude Code CLI, the VS Code extension, and the desktop app, because it relies on nothing but a plain `.mcp.json` file at your project root (no plugin marketplace involved).
+
+```bash
+cp -r adapters/claude-code/.claude .claude/
+cp adapters/claude-code/CLAUDE.md CLAUDE.md
+claude mcp add milens -- milens serve -p .
+```
+
+That command writes a `.mcp.json` at your project root equivalent to:
+
+```json
+{
+  "mcpServers": {
+    "milens": {
+      "command": "milens",
+      "args": ["serve", "-p", "."]
+    }
+  }
+}
+```
+
+`-p .` is resolved against the process's working directory, which Claude Code always sets to your project root when it spawns the server — so this is the most portable form and needs no environment-variable substitution.
+
+> **Prerequisite:** `npm i -g milens`
+
+### Claude Code — via `/plugin install` (marketplace)
+
+```bash
+/plugin marketplace add fuze210699/milens
+/plugin install milens
+```
+
+This reads `.claude-plugin/marketplace.json` at the repo root, which points at `adapters/claude-code` as the plugin. That plugin ships its own `.mcp.json` with **no `-p` flag** — `milens serve` falls back to the `CLAUDE_PROJECT_DIR` environment variable, which Claude Code injects into every MCP server subprocess it spawns (project-scoped or plugin-scoped).
+
+> **History:** we previously shipped a plugin manifest that passed `${CLAUDE_PLUGIN_ROOT}` as `-p`. That variable resolves to the *plugin's own install directory* (e.g. `~/.claude/plugins/cache/...`), not your project — so it silently indexed the wrong codebase. We removed it in favor of the manual `.mcp.json` method above.
+>
+> The current plugin fixes this by relying on `CLAUDE_PROJECT_DIR` (env var, not a `${...}` template substitution) read directly by the CLI — `resolve(opts.path ?? process.env.CLAUDE_PROJECT_DIR ?? '.')` in `src/cli.ts`. Claude Code's docs don't specify a minimum version for `CLAUDE_PROJECT_DIR` injection into plugin-scoped servers, so **verify with `mcp_milens_status` after install** — if the repo path looks wrong, fall back to the manual `.mcp.json` method above, which is unaffected by any of this and always works.
+
+**Optional: session-start / pre-compact hooks.** Merge the `hooks` key from `adapters/claude-code/.claude/settings.json.hooks-snippet.json` into your project's `.claude/settings.json` (create the file if it doesn't exist yet). Not copied automatically since `.claude/settings.json` commonly holds other project settings you don't want overwritten.
+
+### 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 -r adapters/cursor/.cursor .cursor/
+cp adapters/cursor/.cursorrules .cursorrules
+```
+
+### GitHub Copilot
+
+```bash
+cp -r adapters/copilot/.vscode .vscode/
+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/settings.json.hooks-snippet.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "milens hooks session-start --repo ${CLAUDE_PROJECT_DIR} || true"
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "milens hooks pre-compact --repo ${CLAUDE_PROJECT_DIR} || true"
+          }
+        ]
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,11 @@
+{
+  "name": "milens",
+  "description": "AI-DOS Code Intelligence Platform — knowledge graph, security scanning, impact analysis, and closed-loop AI development with 43 MCP tools",
+  "version": "0.7.1",
+  "author": {
+    "name": "milens"
+  },
+  "homepage": "https://github.com/fuze210699/milens",
+  "repository": "https://github.com/fuze210699/milens",
+  "license": "MIT"
+}

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

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

package/adapters/codex/.codex/config.toml

@@ -0,0 +1,3 @@
+[mcp_servers.milens]
+command = "milens"
+args = ["serve", "-p", "."]

package/adapters/copilot/.vscode/mcp.json

@@ -0,0 +1,10 @@
+{
+  "servers": {
+    "milens": {
+      "type": "stdio",
+      "command": "milens",
+      "args": ["serve", "-p", "${workspaceFolder}"],
+      "env": { "MILENS_PROFILE": "standard" }
+    }
+  }
+}

package/adapters/cursor/.cursor/mcp.json

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