milens 0.7.2 → 0.7.3

package/.agents/skills/adapters/SKILL.md

@@ -1,59 +1,59 @@
----
-generated-by: milens
-name: milens-adapters
-description: Code intelligence for the adapters area — symbols, dependencies, and entry points
----
-
-<!-- Generated by milens — safe to delete/regenerate -->
-# Adapters
-
-## Working with this area
-When working with code in **adapters/**, follow these mandatory safety rules:
-
-### Before editing any symbol in this area:
-1. Call `mcp_milens_impact({target: "<symbol>", repo: "<workspaceRoot>"})` — check blast radius
-2. If depth-1 dependents > 5 → **STOP and warn** before proceeding
-3. Call `mcp_milens_context({name: "<symbol>", repo: "<workspaceRoot>"})` — see all callers/callees
-
-### Before committing changes in this area:
-1. Call `mcp_milens_detect_changes({repo: "<workspaceRoot>"})` — verify scope
-2. If unexpected files changed → **STOP and report**
-
-### Key tools for this area:
-| Task | Tool |
-|---|---|
-| Find all references | `mcp_milens_context` |
-| Check edit safety | `mcp_milens_edit_check` |
-| Text search across files | `mcp_milens_grep` |
-| See file symbols | `mcp_milens_get_file_symbols` |
-
-### Edit-safety enforcement
-A `PreToolUse` hook (warn mode by default) reminds you if no milens safety check (`impact`/`context`/`overview`/`guard_edit_check`/`edit_check`/`smart_context`) was called before an `Edit`/`Write`/`MultiEdit`. Opt-in strict deny mode is available via `milens hooks guard-set-mode --mode strict`. Both modes consume the check after one edit. See `.milens/hook-state/config.json`. Known caveat: the underlying `PreToolUse` deny mechanism has at least one reliability issue (https://github.com/anthropics/claude-code/issues/4362).
-
-## Overview
-Contains 61 symbols (55 exported) across 6 files.
-
-## Key Symbols
-- **`Milens Adapter Packs`** [section] (adapters/README.md:1) — 0 refs
-- **`What is milens?`** [section] (adapters/README.md:5) — 0 refs
-- **`Available Adapters`** [section] (adapters/README.md:9) — 0 refs
-- **`Installation`** [section] (adapters/README.md:21) — 0 refs
-- **`Claude Code`** [section] (adapters/README.md:23) — 0 refs
-- **`Claude Code — via `/plugin install` (marketplace)`** [section] (adapters/README.md:50) — 0 refs
-- **`OpenCode`** [section] (adapters/README.md:65) — 0 refs
-- **`Codex`** [section] (adapters/README.md:72) — 0 refs
-- **`Cursor`** [section] (adapters/README.md:78) — 0 refs
-- **`GitHub Copilot`** [section] (adapters/README.md:85) — 0 refs
-- **`Gemini`** [section] (adapters/README.md:92) — 0 refs
-- **`Zed`** [section] (adapters/README.md:98) — 0 refs
-- **`Verification`** [section] (adapters/README.md:104) — 0 refs
-- **`Index Maintenance`** [section] (adapters/README.md:112) — 0 refs
-- **`All Tools Available`** [section] (adapters/README.md:120) — 0 refs
-
-## Files
-- adapters/README.md
-- adapters/claude-code/CLAUDE.md
-- adapters/codex/.codex/codex.md
-- adapters/copilot/.github/copilot-instructions.md
-- adapters/gemini/.gemini/context.md
-- adapters/opencode/AGENTS.md
+---
+generated-by: milens
+name: milens-adapters
+description: Code intelligence for the adapters area — symbols, dependencies, and entry points
+---
+
+<!-- Generated by milens — safe to delete/regenerate -->
+# Adapters
+
+## Working with this area
+When working with code in **adapters/**, follow these mandatory safety rules:
+
+### Before editing any symbol in this area:
+1. Call `mcp_milens_impact({target: "<symbol>", repo: "<workspaceRoot>"})` — check blast radius
+2. If depth-1 dependents > 5 → **STOP and warn** before proceeding
+3. Call `mcp_milens_context({name: "<symbol>", repo: "<workspaceRoot>"})` — see all callers/callees
+
+### Before committing changes in this area:
+1. Call `mcp_milens_detect_changes({repo: "<workspaceRoot>"})` — verify scope
+2. If unexpected files changed → **STOP and report**
+
+### Key tools for this area:
+| Task | Tool |
+|---|---|
+| Find all references | `mcp_milens_context` |
+| Check edit safety | `mcp_milens_edit_check` |
+| Text search across files | `mcp_milens_grep` |
+| See file symbols | `mcp_milens_get_file_symbols` |
+
+### Edit-safety enforcement
+A `PreToolUse` hook (warn mode by default) reminds you if no milens safety check (`impact`/`context`/`overview`/`guard_edit_check`/`edit_check`/`smart_context`) was called before an `Edit`/`Write`/`MultiEdit`. Opt-in strict deny mode is available via `milens hooks guard-set-mode --mode strict`. Both modes consume the check after one edit. See `.milens/hook-state/config.json`. Known caveat: the underlying `PreToolUse` deny mechanism has at least one reliability issue (https://github.com/anthropics/claude-code/issues/4362).
+
+## Overview
+Contains 61 symbols (55 exported) across 6 files.
+
+## Key Symbols
+- **`Milens Adapter Packs`** [section] (adapters/README.md:1) — 0 refs
+- **`What is milens?`** [section] (adapters/README.md:5) — 0 refs
+- **`Available Adapters`** [section] (adapters/README.md:9) — 0 refs
+- **`Installation`** [section] (adapters/README.md:21) — 0 refs
+- **`Claude Code`** [section] (adapters/README.md:23) — 0 refs
+- **`Claude Code — via `/plugin install` (marketplace)`** [section] (adapters/README.md:50) — 0 refs
+- **`OpenCode`** [section] (adapters/README.md:65) — 0 refs
+- **`Codex`** [section] (adapters/README.md:72) — 0 refs
+- **`Cursor`** [section] (adapters/README.md:78) — 0 refs
+- **`GitHub Copilot`** [section] (adapters/README.md:85) — 0 refs
+- **`Gemini`** [section] (adapters/README.md:92) — 0 refs
+- **`Zed`** [section] (adapters/README.md:98) — 0 refs
+- **`Verification`** [section] (adapters/README.md:104) — 0 refs
+- **`Index Maintenance`** [section] (adapters/README.md:112) — 0 refs
+- **`All Tools Available`** [section] (adapters/README.md:120) — 0 refs
+
+## Files
+- adapters/README.md
+- adapters/claude-code/CLAUDE.md
+- adapters/codex/.codex/codex.md
+- adapters/copilot/.github/copilot-instructions.md
+- adapters/gemini/.gemini/context.md
+- adapters/opencode/AGENTS.md

package/.agents/skills/analyzer/SKILL.md

@@ -1,83 +1,83 @@
----
-generated-by: milens
-name: milens-analyzer
-description: Code intelligence for the analyzer area — symbols, dependencies, and entry points
----
-
-<!-- Generated by milens — safe to delete/regenerate -->
-# Analyzer
-
-## Working with this area
-When working with code in **analyzer/**, follow these mandatory safety rules:
-
-### Before editing any symbol in this area:
-1. Call `mcp_milens_impact({target: "<symbol>", repo: "<workspaceRoot>"})` — check blast radius
-2. If depth-1 dependents > 5 → **STOP and warn** before proceeding
-3. Call `mcp_milens_context({name: "<symbol>", repo: "<workspaceRoot>"})` — see all callers/callees
-
-### Before committing changes in this area:
-1. Call `mcp_milens_detect_changes({repo: "<workspaceRoot>"})` — verify scope
-2. If unexpected files changed → **STOP and report**
-
-### Key tools for this area:
-| Task | Tool |
-|---|---|
-| Find all references | `mcp_milens_context` |
-| Check edit safety | `mcp_milens_edit_check` |
-| Text search across files | `mcp_milens_grep` |
-| See file symbols | `mcp_milens_get_file_symbols` |
-
-### Edit-safety enforcement
-A `PreToolUse` hook (warn mode by default) reminds you if no milens safety check (`impact`/`context`/`overview`/`guard_edit_check`/`edit_check`/`smart_context`) was called before an `Edit`/`Write`/`MultiEdit`. Opt-in strict deny mode is available via `milens hooks guard-set-mode --mode strict`. Both modes consume the check after one edit. See `.milens/hook-state/config.json`. Known caveat: the underlying `PreToolUse` deny mechanism has at least one reliability issue (https://github.com/anthropics/claude-code/issues/4362).
-
-## Overview
-Contains 131 symbols (24 exported) across 8 files.
-
-## Key Symbols
-- **`analyze`** [function] (src/analyzer/engine.ts:139) — 10 refs
-- **`resolveLinksWithStats`** [function] (src/analyzer/resolver.ts:54) — 9 refs
-- **`reviewPr`** [function] (src/analyzer/review.ts:261) — 9 refs
-- **`countDependentFiles`** [function] (src/analyzer/risk.ts:13) — 9 refs
-- **`loadAliases`** [function] (src/analyzer/config.ts:10) — 6 refs
-- **`ResolutionResult`** [interface] (src/analyzer/resolver.ts:39) — 6 refs
-- **`classifyRisk`** [function] (src/analyzer/risk.ts:33) — 5 refs
-- **`scoreSymbolRisk`** [function] (src/analyzer/risk.ts:41) — 5 refs
-- **`diffResolutions`** [function] (src/analyzer/scope-resolver.ts:768) — 5 refs
-- **`enrichMetadata`** [function] (src/analyzer/enrich.ts:21) — 4 refs
-- **`ReviewResult`** [interface] (src/analyzer/review.ts:19) — 4 refs
-- **`scanFiles`** [function] (src/analyzer/scanner.ts:11) — 4 refs
-- **`resolveWithScopes`** [function] (src/analyzer/scope-resolver.ts:48) — 4 refs
-- **`clearTreeCache`** [function] (src/analyzer/engine.ts:29) — 3 refs
-- **`resolveLinks`** [function] (src/analyzer/resolver.ts:49) — 3 refs
-
-## Entry Points
-- **`ScopeNode`** [interface] — 11 incoming references
-- **`analyze`** [function] — 10 incoming references
-- **`resolveLinksWithStats`** [function] — 9 incoming references
-- **`reviewPr`** [function] — 9 incoming references
-- **`countDependentFiles`** [function] — 9 incoming references
-
-## Dependencies
-- **parser**: `langForFile`, `supportedExtensions`, `getParser`, `loadLanguage`, `extractFromTree`, `clearQueryCache`, `extractVueScript`, `extractVueTemplateRefs` (+9 more)
-- **root**: `isTestFile`, `CodeSymbol`, `ExtractionResult`, `RawImport`, `RawCall`, `RawHeritage`, `RawReExport`, `RawTypeBinding` (+8 more)
-- **store**: `Database`, `TfIdfProvider`, `EmbeddingStore`, `buildEmbeddingText`, `isFileUpToDate`, `upsertFileHash`, `getSymbolsByFile`, `transaction` (+18 more)
-- **ui**: `ProgressPhase`, `ProgressReporter`, `startPhase`, `tick`, `endPhase`, `finalize`
-
-## Used By
-- **root**: `loadAliases`, `analyze`, `resolve`
-- **orchestrator**: `reviewPr`, `ReviewResult`, `SymbolRisk`
-- **server**: `reviewPr`, `countDependentFiles`, `analyze`
-- **test**: `analyze`, `loadAliases`, `getCachedTree`, `clearTreeCache`, `enrichMetadata`, `resolveLinksWithStats`, `resolveLinks`, `reviewSymbol` (+9 more)
-- **apps**: `resolve`
-- **scripts**: `resolve`
-- **parser**: `resolve`
-
-## Files
-- src/analyzer/config.ts
-- src/analyzer/engine.ts
-- src/analyzer/enrich.ts
-- src/analyzer/resolver.ts
-- src/analyzer/review.ts
-- src/analyzer/risk.ts
-- src/analyzer/scanner.ts
-- src/analyzer/scope-resolver.ts
+---
+generated-by: milens
+name: milens-analyzer
+description: Code intelligence for the analyzer area — symbols, dependencies, and entry points
+---
+
+<!-- Generated by milens — safe to delete/regenerate -->
+# Analyzer
+
+## Working with this area
+When working with code in **analyzer/**, follow these mandatory safety rules:
+
+### Before editing any symbol in this area:
+1. Call `mcp_milens_impact({target: "<symbol>", repo: "<workspaceRoot>"})` — check blast radius
+2. If depth-1 dependents > 5 → **STOP and warn** before proceeding
+3. Call `mcp_milens_context({name: "<symbol>", repo: "<workspaceRoot>"})` — see all callers/callees
+
+### Before committing changes in this area:
+1. Call `mcp_milens_detect_changes({repo: "<workspaceRoot>"})` — verify scope
+2. If unexpected files changed → **STOP and report**
+
+### Key tools for this area:
+| Task | Tool |
+|---|---|
+| Find all references | `mcp_milens_context` |
+| Check edit safety | `mcp_milens_edit_check` |
+| Text search across files | `mcp_milens_grep` |
+| See file symbols | `mcp_milens_get_file_symbols` |
+
+### Edit-safety enforcement
+A `PreToolUse` hook (warn mode by default) reminds you if no milens safety check (`impact`/`context`/`overview`/`guard_edit_check`/`edit_check`/`smart_context`) was called before an `Edit`/`Write`/`MultiEdit`. Opt-in strict deny mode is available via `milens hooks guard-set-mode --mode strict`. Both modes consume the check after one edit. See `.milens/hook-state/config.json`. Known caveat: the underlying `PreToolUse` deny mechanism has at least one reliability issue (https://github.com/anthropics/claude-code/issues/4362).
+
+## Overview
+Contains 131 symbols (24 exported) across 8 files.
+
+## Key Symbols
+- **`analyze`** [function] (src/analyzer/engine.ts:139) — 10 refs
+- **`resolveLinksWithStats`** [function] (src/analyzer/resolver.ts:54) — 9 refs
+- **`reviewPr`** [function] (src/analyzer/review.ts:261) — 9 refs
+- **`countDependentFiles`** [function] (src/analyzer/risk.ts:13) — 9 refs
+- **`loadAliases`** [function] (src/analyzer/config.ts:10) — 6 refs
+- **`ResolutionResult`** [interface] (src/analyzer/resolver.ts:39) — 6 refs
+- **`classifyRisk`** [function] (src/analyzer/risk.ts:33) — 5 refs
+- **`scoreSymbolRisk`** [function] (src/analyzer/risk.ts:41) — 5 refs
+- **`diffResolutions`** [function] (src/analyzer/scope-resolver.ts:768) — 5 refs
+- **`enrichMetadata`** [function] (src/analyzer/enrich.ts:21) — 4 refs
+- **`ReviewResult`** [interface] (src/analyzer/review.ts:19) — 4 refs
+- **`scanFiles`** [function] (src/analyzer/scanner.ts:11) — 4 refs
+- **`resolveWithScopes`** [function] (src/analyzer/scope-resolver.ts:48) — 4 refs
+- **`clearTreeCache`** [function] (src/analyzer/engine.ts:29) — 3 refs
+- **`resolveLinks`** [function] (src/analyzer/resolver.ts:49) — 3 refs
+
+## Entry Points
+- **`ScopeNode`** [interface] — 11 incoming references
+- **`analyze`** [function] — 10 incoming references
+- **`resolveLinksWithStats`** [function] — 9 incoming references
+- **`reviewPr`** [function] — 9 incoming references
+- **`countDependentFiles`** [function] — 9 incoming references
+
+## Dependencies
+- **parser**: `langForFile`, `supportedExtensions`, `getParser`, `loadLanguage`, `extractFromTree`, `clearQueryCache`, `extractVueScript`, `extractVueTemplateRefs` (+9 more)
+- **root**: `isTestFile`, `CodeSymbol`, `ExtractionResult`, `RawImport`, `RawCall`, `RawHeritage`, `RawReExport`, `RawTypeBinding` (+8 more)
+- **store**: `Database`, `TfIdfProvider`, `EmbeddingStore`, `buildEmbeddingText`, `isFileUpToDate`, `upsertFileHash`, `getSymbolsByFile`, `transaction` (+18 more)
+- **ui**: `ProgressPhase`, `ProgressReporter`, `startPhase`, `tick`, `endPhase`, `finalize`
+
+## Used By
+- **root**: `loadAliases`, `analyze`, `resolve`
+- **orchestrator**: `reviewPr`, `ReviewResult`, `SymbolRisk`
+- **server**: `reviewPr`, `countDependentFiles`, `analyze`
+- **test**: `analyze`, `loadAliases`, `getCachedTree`, `clearTreeCache`, `enrichMetadata`, `resolveLinksWithStats`, `resolveLinks`, `reviewSymbol` (+9 more)
+- **apps**: `resolve`
+- **scripts**: `resolve`
+- **parser**: `resolve`
+
+## Files
+- src/analyzer/config.ts
+- src/analyzer/engine.ts
+- src/analyzer/enrich.ts
+- src/analyzer/resolver.ts
+- src/analyzer/review.ts
+- src/analyzer/risk.ts
+- src/analyzer/scanner.ts
+- src/analyzer/scope-resolver.ts

package/.agents/skills/apps/SKILL.md

@@ -1,65 +1,65 @@
----
-generated-by: milens
-name: milens-apps
-description: Code intelligence for the apps area — symbols, dependencies, and entry points
----
-
-<!-- Generated by milens — safe to delete/regenerate -->
-# Apps
-
-## Working with this area
-When working with code in **apps/**, follow these mandatory safety rules:
-
-### Before editing any symbol in this area:
-1. Call `mcp_milens_impact({target: "<symbol>", repo: "<workspaceRoot>"})` — check blast radius
-2. If depth-1 dependents > 5 → **STOP and warn** before proceeding
-3. Call `mcp_milens_context({name: "<symbol>", repo: "<workspaceRoot>"})` — see all callers/callees
-
-### Before committing changes in this area:
-1. Call `mcp_milens_detect_changes({repo: "<workspaceRoot>"})` — verify scope
-2. If unexpected files changed → **STOP and report**
-
-### Key tools for this area:
-| Task | Tool |
-|---|---|
-| Find all references | `mcp_milens_context` |
-| Check edit safety | `mcp_milens_edit_check` |
-| Text search across files | `mcp_milens_grep` |
-| See file symbols | `mcp_milens_get_file_symbols` |
-
-### Edit-safety enforcement
-A `PreToolUse` hook (warn mode by default) reminds you if no milens safety check (`impact`/`context`/`overview`/`guard_edit_check`/`edit_check`/`smart_context`) was called before an `Edit`/`Write`/`MultiEdit`. Opt-in strict deny mode is available via `milens hooks guard-set-mode --mode strict`. Both modes consume the check after one edit. See `.milens/hook-state/config.json`. Known caveat: the underlying `PreToolUse` deny mechanism has at least one reliability issue (https://github.com/anthropics/claude-code/issues/4362).
-
-## Overview
-Contains 40 symbols (8 exported) across 6 files.
-
-## Key Symbols
-- **`Milens Desktop Dashboard`** [section] (apps/dashboard/README.md:1) — 0 refs
-- **`Features`** [section] (apps/dashboard/README.md:5) — 0 refs
-- **`Development`** [section] (apps/dashboard/README.md:13) — 0 refs
-- **`Build`** [section] (apps/dashboard/README.md:19) — 0 refs
-- **`Milens GitHub App`** [section] (apps/github/README.md:1) — 0 refs
-- **`Features`** [section] (apps/github/README.md:5) — 0 refs
-- **`Deployment`** [section] (apps/github/README.md:10) — 0 refs
-- **`Local Development`** [section] (apps/github/README.md:15) — 0 refs
-
-## Entry Points
-- **`DASHBOARD_URL`** [variable] — 3 incoming references
-- **`serverProcess`** [variable] — 3 incoming references
-- **`loadOverview`** [function] — 2 incoming references
-- **`poll`** [function] — 2 incoming references
-- **`__dirname`** [variable] — 2 incoming references
-
-## Dependencies
-- **store**: `remove`, `getAnnotations`, `Database`, `getCodebaseSummary`
-- **analyzer**: `resolve`
-- **scripts**: `parseArgs`, `generatePrPayload`
-- **test**: `create`
-
-## Files
-- apps/dashboard/README.md
-- apps/dashboard/index.html
-- apps/dashboard/main.js
-- apps/dashboard/preload.js
-- apps/github/README.md
-- apps/github/app.js
+---
+generated-by: milens
+name: milens-apps
+description: Code intelligence for the apps area — symbols, dependencies, and entry points
+---
+
+<!-- Generated by milens — safe to delete/regenerate -->
+# Apps
+
+## Working with this area
+When working with code in **apps/**, follow these mandatory safety rules:
+
+### Before editing any symbol in this area:
+1. Call `mcp_milens_impact({target: "<symbol>", repo: "<workspaceRoot>"})` — check blast radius
+2. If depth-1 dependents > 5 → **STOP and warn** before proceeding
+3. Call `mcp_milens_context({name: "<symbol>", repo: "<workspaceRoot>"})` — see all callers/callees
+
+### Before committing changes in this area:
+1. Call `mcp_milens_detect_changes({repo: "<workspaceRoot>"})` — verify scope
+2. If unexpected files changed → **STOP and report**
+
+### Key tools for this area:
+| Task | Tool |
+|---|---|
+| Find all references | `mcp_milens_context` |
+| Check edit safety | `mcp_milens_edit_check` |
+| Text search across files | `mcp_milens_grep` |
+| See file symbols | `mcp_milens_get_file_symbols` |
+
+### Edit-safety enforcement
+A `PreToolUse` hook (warn mode by default) reminds you if no milens safety check (`impact`/`context`/`overview`/`guard_edit_check`/`edit_check`/`smart_context`) was called before an `Edit`/`Write`/`MultiEdit`. Opt-in strict deny mode is available via `milens hooks guard-set-mode --mode strict`. Both modes consume the check after one edit. See `.milens/hook-state/config.json`. Known caveat: the underlying `PreToolUse` deny mechanism has at least one reliability issue (https://github.com/anthropics/claude-code/issues/4362).
+
+## Overview
+Contains 40 symbols (8 exported) across 6 files.
+
+## Key Symbols
+- **`Milens Desktop Dashboard`** [section] (apps/dashboard/README.md:1) — 0 refs
+- **`Features`** [section] (apps/dashboard/README.md:5) — 0 refs
+- **`Development`** [section] (apps/dashboard/README.md:13) — 0 refs
+- **`Build`** [section] (apps/dashboard/README.md:19) — 0 refs
+- **`Milens GitHub App`** [section] (apps/github/README.md:1) — 0 refs
+- **`Features`** [section] (apps/github/README.md:5) — 0 refs
+- **`Deployment`** [section] (apps/github/README.md:10) — 0 refs
+- **`Local Development`** [section] (apps/github/README.md:15) — 0 refs
+
+## Entry Points
+- **`DASHBOARD_URL`** [variable] — 3 incoming references
+- **`serverProcess`** [variable] — 3 incoming references
+- **`loadOverview`** [function] — 2 incoming references
+- **`poll`** [function] — 2 incoming references
+- **`__dirname`** [variable] — 2 incoming references
+
+## Dependencies
+- **store**: `remove`, `getAnnotations`, `Database`, `getCodebaseSummary`
+- **analyzer**: `resolve`
+- **scripts**: `parseArgs`, `generatePrPayload`
+- **test**: `create`
+
+## Files
+- apps/dashboard/README.md
+- apps/dashboard/index.html
+- apps/dashboard/main.js
+- apps/dashboard/preload.js
+- apps/github/README.md
+- apps/github/app.js

package/.agents/skills/docs/SKILL.md

@@ -1,63 +1,63 @@
----
-generated-by: milens
-name: milens-docs
-description: Code intelligence for the docs area — symbols, dependencies, and entry points
----
-
-<!-- Generated by milens — safe to delete/regenerate -->
-# Docs
-
-## Working with this area
-When working with code in **docs/**, follow these mandatory safety rules:
-
-### Before editing any symbol in this area:
-1. Call `mcp_milens_impact({target: "<symbol>", repo: "<workspaceRoot>"})` — check blast radius
-2. If depth-1 dependents > 5 → **STOP and warn** before proceeding
-3. Call `mcp_milens_context({name: "<symbol>", repo: "<workspaceRoot>"})` — see all callers/callees
-
-### Before committing changes in this area:
-1. Call `mcp_milens_detect_changes({repo: "<workspaceRoot>"})` — verify scope
-2. If unexpected files changed → **STOP and report**
-
-### Key tools for this area:
-| Task | Tool |
-|---|---|
-| Find all references | `mcp_milens_context` |
-| Check edit safety | `mcp_milens_edit_check` |
-| Text search across files | `mcp_milens_grep` |
-| See file symbols | `mcp_milens_get_file_symbols` |
-
-### Edit-safety enforcement
-A `PreToolUse` hook (warn mode by default) reminds you if no milens safety check (`impact`/`context`/`overview`/`guard_edit_check`/`edit_check`/`smart_context`) was called before an `Edit`/`Write`/`MultiEdit`. Opt-in strict deny mode is available via `milens hooks guard-set-mode --mode strict`. Both modes consume the check after one edit. See `.milens/hook-state/config.json`. Known caveat: the underlying `PreToolUse` deny mechanism has at least one reliability issue (https://github.com/anthropics/claude-code/issues/4362).
-
-## Overview
-Contains 122 symbols (112 exported) across 10 files.
-
-## Key Symbols
-- **`Milens Documentation`** [section] (docs/README.md:1) — 0 refs
-- **`Getting Started`** [section] (docs/README.md:5) — 0 refs
-- **`Reference`** [section] (docs/README.md:12) — 0 refs
-- **`Accuracy Engine`** [section] (docs/accuracy.md:1) — 0 refs
-- **`Type Bindings`** [section] (docs/accuracy.md:5) — 0 refs
-- **`Method Resolution Order (MRO)`** [section] (docs/accuracy.md:29) — 0 refs
-- **`C3 Linearization Example (Diamond)`** [section] (docs/accuracy.md:45) — 0 refs
-- **`Import Semantics`** [section] (docs/accuracy.md:59) — 0 refs
-- **`Accuracy Fixtures`** [section] (docs/accuracy.md:69) — 0 refs
-- **`Dual-Path Resolution`** [section] (docs/accuracy.md:86) — 0 refs
-- **`Adapter Packs`** [section] (docs/adapters.md:1) — 0 refs
-- **`Available Adapters`** [section] (docs/adapters.md:5) — 0 refs
-- **`Quick Install`** [section] (docs/adapters.md:17) — 0 refs
-- **`Claude Code`** [section] (docs/adapters.md:21) — 0 refs
-- **`OpenCode`** [section] (docs/adapters.md:39) — 0 refs
-
-## Files
-- docs/README.md
-- docs/accuracy.md
-- docs/adapters.md
-- docs/cli.md
-- docs/languages.md
-- docs/pricing.md
-- docs/quickstart.md
-- docs/review.md
-- docs/security-presets.md
-- docs/tools.md
+---
+generated-by: milens
+name: milens-docs
+description: Code intelligence for the docs area — symbols, dependencies, and entry points
+---
+
+<!-- Generated by milens — safe to delete/regenerate -->
+# Docs
+
+## Working with this area
+When working with code in **docs/**, follow these mandatory safety rules:
+
+### Before editing any symbol in this area:
+1. Call `mcp_milens_impact({target: "<symbol>", repo: "<workspaceRoot>"})` — check blast radius
+2. If depth-1 dependents > 5 → **STOP and warn** before proceeding
+3. Call `mcp_milens_context({name: "<symbol>", repo: "<workspaceRoot>"})` — see all callers/callees
+
+### Before committing changes in this area:
+1. Call `mcp_milens_detect_changes({repo: "<workspaceRoot>"})` — verify scope
+2. If unexpected files changed → **STOP and report**
+
+### Key tools for this area:
+| Task | Tool |
+|---|---|
+| Find all references | `mcp_milens_context` |
+| Check edit safety | `mcp_milens_edit_check` |
+| Text search across files | `mcp_milens_grep` |
+| See file symbols | `mcp_milens_get_file_symbols` |
+
+### Edit-safety enforcement
+A `PreToolUse` hook (warn mode by default) reminds you if no milens safety check (`impact`/`context`/`overview`/`guard_edit_check`/`edit_check`/`smart_context`) was called before an `Edit`/`Write`/`MultiEdit`. Opt-in strict deny mode is available via `milens hooks guard-set-mode --mode strict`. Both modes consume the check after one edit. See `.milens/hook-state/config.json`. Known caveat: the underlying `PreToolUse` deny mechanism has at least one reliability issue (https://github.com/anthropics/claude-code/issues/4362).
+
+## Overview
+Contains 122 symbols (112 exported) across 10 files.
+
+## Key Symbols
+- **`Milens Documentation`** [section] (docs/README.md:1) — 0 refs
+- **`Getting Started`** [section] (docs/README.md:5) — 0 refs
+- **`Reference`** [section] (docs/README.md:12) — 0 refs
+- **`Accuracy Engine`** [section] (docs/accuracy.md:1) — 0 refs
+- **`Type Bindings`** [section] (docs/accuracy.md:5) — 0 refs
+- **`Method Resolution Order (MRO)`** [section] (docs/accuracy.md:29) — 0 refs
+- **`C3 Linearization Example (Diamond)`** [section] (docs/accuracy.md:45) — 0 refs
+- **`Import Semantics`** [section] (docs/accuracy.md:59) — 0 refs
+- **`Accuracy Fixtures`** [section] (docs/accuracy.md:69) — 0 refs
+- **`Dual-Path Resolution`** [section] (docs/accuracy.md:86) — 0 refs
+- **`Adapter Packs`** [section] (docs/adapters.md:1) — 0 refs
+- **`Available Adapters`** [section] (docs/adapters.md:5) — 0 refs
+- **`Quick Install`** [section] (docs/adapters.md:17) — 0 refs
+- **`Claude Code`** [section] (docs/adapters.md:21) — 0 refs
+- **`OpenCode`** [section] (docs/adapters.md:39) — 0 refs
+
+## Files
+- docs/README.md
+- docs/accuracy.md
+- docs/adapters.md
+- docs/cli.md
+- docs/languages.md
+- docs/pricing.md
+- docs/quickstart.md
+- docs/review.md
+- docs/security-presets.md
+- docs/tools.md