milens 0.6.8 → 0.7.0

package/.agents/skills/orchestrator/SKILL.md

@@ -1,61 +1,61 @@
----
-name: milens-orchestrator
-description: Code intelligence for the orchestrator area — symbols, dependencies, and entry points
----
-
-# Orchestrator
-
-## Working with this area
-When working with code in **orchestrator/**, 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` |
-
-## Overview
-Contains 22 symbols (7 exported) across 2 files.
-
-## Key Symbols
-- **`Orchestrator`** [class] (src/orchestrator/orchestrator.ts:36) — 6 refs
-- **`OrchestratorReport`** [interface] (src/orchestrator/reporter.ts:4) — 5 refs
-- **`formatReport`** [function] (src/orchestrator/reporter.ts:17) — 4 refs
-- **`OrchestratorConfig`** [interface] (src/orchestrator/orchestrator.ts:10) — 2 refs
-- **`ImpactSnapshot`** [interface] (src/orchestrator/orchestrator.ts:18) — 2 refs
-- **`ReportOptions`** [interface] (src/orchestrator/reporter.ts:13) — 2 refs
-- **`ImpactDiff`** [interface] (src/orchestrator/orchestrator.ts:25) — 1 refs
-
-## Entry Points
-- **`Orchestrator`** [class] — 6 incoming references
-- **`e`** [function] — 5 incoming references
-- **`OrchestratorReport`** [interface] — 5 incoming references
-- **`formatReport`** [function] — 4 incoming references
-- **`snapshot`** [method] — 3 incoming references
-
-## Dependencies
-- **store**: `Database`, `findSymbolByName`, `findUpstream`, `clear`, `getTestCoverageGaps`, `findDeadCode`, `close`
-- **analyzer**: `reviewPr`, `ReviewResult`, `SymbolRisk`
-- **root**: `CodeSymbol`, `has`
-- **test**: `add`
-
-## Used By
-- **root**: `Orchestrator`, `subscribe`, `runAndFormat`
-- **server**: `Orchestrator`, `snapshot`, `compare`, `runAndFormat`
-- **test**: `Orchestrator`, `formatReport`, `OrchestratorReport`, `subscribe`, `run`, `snapshot`, `compare`, `cancel` (+3 more)
-- **apps**: `e`
-
-## Files
-- src/orchestrator/orchestrator.ts
-- src/orchestrator/reporter.ts
+---
+name: milens-orchestrator
+description: Code intelligence for the orchestrator area — symbols, dependencies, and entry points
+---
+
+# Orchestrator
+
+## Working with this area
+When working with code in **orchestrator/**, 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` |
+
+## Overview
+Contains 22 symbols (7 exported) across 2 files.
+
+## Key Symbols
+- **`Orchestrator`** [class] (src/orchestrator/orchestrator.ts:36) — 6 refs
+- **`OrchestratorReport`** [interface] (src/orchestrator/reporter.ts:4) — 5 refs
+- **`formatReport`** [function] (src/orchestrator/reporter.ts:17) — 4 refs
+- **`OrchestratorConfig`** [interface] (src/orchestrator/orchestrator.ts:10) — 2 refs
+- **`ImpactSnapshot`** [interface] (src/orchestrator/orchestrator.ts:18) — 2 refs
+- **`ReportOptions`** [interface] (src/orchestrator/reporter.ts:13) — 2 refs
+- **`ImpactDiff`** [interface] (src/orchestrator/orchestrator.ts:25) — 1 refs
+
+## Entry Points
+- **`Orchestrator`** [class] — 6 incoming references
+- **`e`** [function] — 5 incoming references
+- **`OrchestratorReport`** [interface] — 5 incoming references
+- **`formatReport`** [function] — 4 incoming references
+- **`snapshot`** [method] — 3 incoming references
+
+## Dependencies
+- **store**: `Database`, `findSymbolByName`, `findUpstream`, `clear`, `getTestCoverageGaps`, `findDeadCode`, `close`
+- **analyzer**: `reviewPr`, `ReviewResult`, `SymbolRisk`
+- **root**: `CodeSymbol`, `has`
+- **test**: `add`
+
+## Used By
+- **root**: `Orchestrator`, `subscribe`, `runAndFormat`
+- **server**: `Orchestrator`, `loadSnapshots`, `snapshot`, `persistSnapshots`, `compare`, `runAndFormat`
+- **test**: `Orchestrator`, `formatReport`, `OrchestratorReport`, `subscribe`, `run`, `snapshot`, `compare`, `cancel` (+3 more)
+- **apps**: `e`
+
+## Files
+- src/orchestrator/orchestrator.ts
+- src/orchestrator/reporter.ts

package/.agents/skills/parser/SKILL.md

@@ -1,82 +1,83 @@
----
-name: milens-parser
-description: Code intelligence for the parser area — symbols, dependencies, and entry points
----
-
-# Parser
-
-## Working with this area
-When working with code in **parser/**, 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` |
-
-## Overview
-Contains 83 symbols (31 exported) across 16 files.
-
-## Key Symbols
-- **`LangSpec`** [interface] (src/parser/extract.ts:6) — 32 refs
-- **`loadLanguage`** [function] (src/parser/loader.ts:21) — 14 refs
-- **`getParser`** [function] (src/parser/loader.ts:32) — 13 refs
-- **`extractFromTree`** [function] (src/parser/extract.ts:256) — 8 refs
-- **`supportedExtensions`** [function] (src/parser/languages.ts:29) — 6 refs
-- **`extractHtmlScripts`** [function] (src/parser/lang-html.ts:38) — 5 refs
-- **`extractMarkdown`** [function] (src/parser/lang-md.ts:34) — 5 refs
-- **`spec`** [variable] (src/parser/lang-ts.ts:5) — 5 refs
-- **`extractVueScript`** [function] (src/parser/lang-vue.ts:19) — 5 refs
-- **`initTreeSitter`** [function] (src/parser/loader.ts:15) — 5 refs
-- **`clearQueryCache`** [function] (src/parser/extract.ts:72) — 4 refs
-- **`extractHtmlRefs`** [function] (src/parser/lang-html.ts:57) — 4 refs
-- **`extractHtmlLinks`** [function] (src/parser/lang-html.ts:99) — 4 refs
-- **`extractVueTemplateRefs`** [function] (src/parser/lang-vue.ts:38) — 4 refs
-- **`extractVueTemplateAst`** [function] (src/parser/lang-vue.ts:90) — 4 refs
-
-## Entry Points
-- **`LangSpec`** [interface] — 32 incoming references
-- **`loadLanguage`** [function] — 14 incoming references
-- **`getParser`** [function] — 13 incoming references
-- **`extractFromTree`** [function] — 8 incoming references
-- **`supportedExtensions`** [function] — 6 incoming references
-
-## Dependencies
-- **root**: `CodeSymbol`, `RawImport`, `RawCall`, `RawHeritage`, `RawReExport`, `RawTypeBinding`, `RawAssignmentBinding`, `RawReturnType` (+4 more)
-- **test**: `lang`, `add`, `parser`
-- **analyzer**: `resolve`
-- **store**: `load`
-
-## Used By
-- **analyzer**: `langForFile`, `supportedExtensions`, `getParser`, `loadLanguage`, `extractFromTree`, `clearQueryCache`, `extractVueScript`, `extractVueTemplateRefs` (+9 more)
-- **server**: `getParser`, `loadLanguage`, `ALL_LANGS`
-- **test**: `getParser`, `loadLanguage`, `extractFromTree`, `extractVueScript`, `extractVueTemplateRefs`, `extractVueCompositionApi`, `extractVueTemplateAst`, `spec` (+11 more)
-
-## Files
-- src/parser/extract.ts
-- src/parser/lang-css.ts
-- src/parser/lang-go.ts
-- src/parser/lang-html.ts
-- src/parser/lang-java.ts
-- src/parser/lang-js.ts
-- src/parser/lang-md.ts
-- src/parser/lang-php.ts
-- src/parser/lang-py.ts
-- src/parser/lang-ruby.ts
-- src/parser/lang-rust.ts
-- src/parser/lang-ts.ts
-- src/parser/lang-vue.ts
-- src/parser/language-provider.ts
-- src/parser/languages.ts
-- src/parser/loader.ts
+---
+name: milens-parser
+description: Code intelligence for the parser area — symbols, dependencies, and entry points
+---
+
+# Parser
+
+## Working with this area
+When working with code in **parser/**, 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` |
+
+## Overview
+Contains 83 symbols (31 exported) across 16 files.
+
+## Key Symbols
+- **`LangSpec`** [interface] (src/parser/extract.ts:6) — 32 refs
+- **`loadLanguage`** [function] (src/parser/loader.ts:21) — 14 refs
+- **`getParser`** [function] (src/parser/loader.ts:32) — 13 refs
+- **`extractFromTree`** [function] (src/parser/extract.ts:256) — 8 refs
+- **`supportedExtensions`** [function] (src/parser/languages.ts:29) — 6 refs
+- **`extractHtmlScripts`** [function] (src/parser/lang-html.ts:38) — 5 refs
+- **`extractMarkdown`** [function] (src/parser/lang-md.ts:34) — 5 refs
+- **`spec`** [variable] (src/parser/lang-ts.ts:5) — 5 refs
+- **`extractVueScript`** [function] (src/parser/lang-vue.ts:19) — 5 refs
+- **`initTreeSitter`** [function] (src/parser/loader.ts:15) — 5 refs
+- **`clearQueryCache`** [function] (src/parser/extract.ts:72) — 4 refs
+- **`extractHtmlRefs`** [function] (src/parser/lang-html.ts:57) — 4 refs
+- **`extractHtmlLinks`** [function] (src/parser/lang-html.ts:99) — 4 refs
+- **`extractVueTemplateRefs`** [function] (src/parser/lang-vue.ts:38) — 4 refs
+- **`extractVueTemplateAst`** [function] (src/parser/lang-vue.ts:90) — 4 refs
+
+## Entry Points
+- **`LangSpec`** [interface] — 32 incoming references
+- **`loadLanguage`** [function] — 14 incoming references
+- **`getParser`** [function] — 13 incoming references
+- **`extractFromTree`** [function] — 8 incoming references
+- **`supportedExtensions`** [function] — 6 incoming references
+
+## Dependencies
+- **root**: `CodeSymbol`, `RawImport`, `RawCall`, `RawHeritage`, `RawReExport`, `RawTypeBinding`, `RawAssignmentBinding`, `RawReturnType` (+4 more)
+- **test**: `lang`, `add`, `parser`
+- **scripts**: `root`
+- **analyzer**: `resolve`
+- **store**: `load`
+
+## Used By
+- **analyzer**: `langForFile`, `supportedExtensions`, `getParser`, `loadLanguage`, `extractFromTree`, `clearQueryCache`, `extractVueScript`, `extractVueTemplateRefs` (+9 more)
+- **server**: `getParser`, `loadLanguage`, `ALL_LANGS`
+- **test**: `getParser`, `loadLanguage`, `extractFromTree`, `extractVueScript`, `extractVueTemplateRefs`, `extractVueCompositionApi`, `extractVueTemplateAst`, `spec` (+11 more)
+
+## Files
+- src/parser/extract.ts
+- src/parser/lang-css.ts
+- src/parser/lang-go.ts
+- src/parser/lang-html.ts
+- src/parser/lang-java.ts
+- src/parser/lang-js.ts
+- src/parser/lang-md.ts
+- src/parser/lang-php.ts
+- src/parser/lang-py.ts
+- src/parser/lang-ruby.ts
+- src/parser/lang-rust.ts
+- src/parser/lang-ts.ts
+- src/parser/lang-vue.ts
+- src/parser/language-provider.ts
+- src/parser/languages.ts
+- src/parser/loader.ts

package/.agents/skills/root/SKILL.md

@@ -1,86 +1,88 @@
----
-name: milens-root
-description: Code intelligence for the root area — symbols, dependencies, and entry points
----
-
-# Root
-
-## Working with this area
-When working with code in **root/**, 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` |
-
-## Overview
-Contains 229 symbols (153 exported) across 13 files.
-
-## Key Symbols
-- **`CodeSymbol`** [interface] (src/types.ts:8) — 53 refs
-- **`SymbolLink`** [interface] (src/types.ts:26) — 24 refs
-- **`RawCall`** [interface] (src/types.ts:44) — 15 refs
-- **`isTestFile`** [function] (src/utils.ts:2) — 12 refs
-- **`RawImport`** [interface] (src/types.ts:35) — 9 refs
-- **`RawHeritage`** [interface] (src/types.ts:52) — 7 refs
-- **`ExtractionResult`** [interface] (src/types.ts:60) — 6 refs
-- **`RawTypeBinding`** [interface] (src/types.ts:80) — 6 refs
-- **`RawAssignmentBinding`** [interface] (src/types.ts:88) — 6 refs
-- **`RawReturnType`** [interface] (src/types.ts:96) — 5 refs
-- **`RawCallResultBinding`** [interface] (src/types.ts:104) — 5 refs
-- **`generateAgentsMd`** [function] (src/agents-md.ts:43) — 4 refs
-- **`computeMetrics`** [function] (src/metrics.ts:21) — 4 refs
-- **`formatMetricsReport`** [function] (src/metrics.ts:62) — 4 refs
-- **`MilensMetrics`** [interface] (src/metrics.ts:4) — 4 refs
-
-## Entry Points
-- **`CodeSymbol`** [interface] — 53 incoming references
-- **`has`** [function] — 47 incoming references
-- **`SymbolLink`** [interface] — 24 incoming references
-- **`RawCall`** [interface] — 15 incoming references
-- **`isTestFile`** [function] — 12 incoming references
-
-## Dependencies
-- **store**: `Database`, `RepoRegistry`, `AnnotationStore`, `runDecayPass`, `getIncomingLinks`, `getAllSymbols`, `getCodebaseSummary`, `register` (+24 more)
-- **analyzer**: `loadAliases`, `analyze`, `resolve`, `clear`
-- **server**: `startHttp`, `startStdio`, `HookManager`, `get`, `enableHook`, `loadConfig`, `saveConfig`, `disableHook`
-- **security**: `loadRules`, `auditDependencies`
-- **orchestrator**: `Orchestrator`, `subscribe`, `runAndFormat`
-- **test**: `add`, `dbPath`
-- **scripts**: `outDir`
-
-## Used By
-- **analyzer**: `isTestFile`, `CodeSymbol`, `ExtractionResult`, `RawImport`, `RawCall`, `RawHeritage`, `RawReExport`, `RawTypeBinding` (+8 more)
-- **orchestrator**: `CodeSymbol`, `has`
-- **parser**: `CodeSymbol`, `RawImport`, `RawCall`, `RawHeritage`, `RawReExport`, `RawTypeBinding`, `RawAssignmentBinding`, `RawReturnType` (+4 more)
-- **store**: `Annotation`, `AnnotationKey`, `Session`, `EvolutionEvent`, `CodeSymbol`, `SymbolLink`, `RepoEntry`, `has` (+1 more)
-- **test**: `generateAgentsMd`, `AnnotationKey`, `CodeSymbol`, `SymbolLink`, `computeMetrics`, `formatMetricsReport`, `MilensMetrics`, `RawImport` (+17 more)
-- **security**: `has`
-- **server**: `has`
-
-## Files
-- AGENTS.md
-- CLAUDE.md
-- CONTRIBUTING.md
-- DEPLOY.md
-- README.md
-- src/agents-md.ts
-- src/cli.ts
-- src/metrics.ts
-- src/skills.ts
-- src/types.ts
-- src/uninstall.ts
-- src/utils.ts
-- vitest.config.ts
+---
+name: milens-root
+description: Code intelligence for the root area — symbols, dependencies, and entry points
+---
+
+# Root
+
+## Working with this area
+When working with code in **root/**, 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` |
+
+## Overview
+Contains 242 symbols (164 exported) across 13 files.
+
+## Key Symbols
+- **`CodeSymbol`** [interface] (src/types.ts:8) — 53 refs
+- **`SymbolLink`** [interface] (src/types.ts:26) — 24 refs
+- **`RawCall`** [interface] (src/types.ts:44) — 15 refs
+- **`isTestFile`** [function] (src/utils.ts:2) — 12 refs
+- **`RawImport`** [interface] (src/types.ts:35) — 9 refs
+- **`RawHeritage`** [interface] (src/types.ts:52) — 7 refs
+- **`ExtractionResult`** [interface] (src/types.ts:60) — 6 refs
+- **`RawTypeBinding`** [interface] (src/types.ts:80) — 6 refs
+- **`RawAssignmentBinding`** [interface] (src/types.ts:88) — 6 refs
+- **`RawReturnType`** [interface] (src/types.ts:96) — 5 refs
+- **`RawCallResultBinding`** [interface] (src/types.ts:104) — 5 refs
+- **`AnalysisStats`** [interface] (src/types.ts:113) — 5 refs
+- **`generateAgentsMd`** [function] (src/agents-md.ts:93) — 4 refs
+- **`computeMetrics`** [function] (src/metrics.ts:21) — 4 refs
+- **`formatMetricsReport`** [function] (src/metrics.ts:62) — 4 refs
+
+## Entry Points
+- **`CodeSymbol`** [interface] — 53 incoming references
+- **`has`** [function] — 50 incoming references
+- **`SymbolLink`** [interface] — 24 incoming references
+- **`RawCall`** [interface] — 15 incoming references
+- **`isTestFile`** [function] — 12 incoming references
+
+## Dependencies
+- **store**: `Database`, `RepoRegistry`, `AnnotationStore`, `runDecayPass`, `getIncomingLinks`, `getAllSymbols`, `getCodebaseSummary`, `register` (+24 more)
+- **analyzer**: `loadAliases`, `analyze`, `resolve`, `clear`
+- **ui**: `createProgressReporter`, `finalize`
+- **server**: `startHttp`, `startStdio`, `HookManager`, `get`, `enableHook`, `loadConfig`, `saveConfig`, `disableHook`
+- **security**: `loadRules`, `auditDependencies`
+- **orchestrator**: `Orchestrator`, `subscribe`, `runAndFormat`
+- **test**: `add`, `dbPath`
+- **scripts**: `version`, `outDir`, `root`
+
+## Used By
+- **analyzer**: `isTestFile`, `CodeSymbol`, `ExtractionResult`, `RawImport`, `RawCall`, `RawHeritage`, `RawReExport`, `RawTypeBinding` (+8 more)
+- **orchestrator**: `CodeSymbol`, `has`
+- **parser**: `CodeSymbol`, `RawImport`, `RawCall`, `RawHeritage`, `RawReExport`, `RawTypeBinding`, `RawAssignmentBinding`, `RawReturnType` (+4 more)
+- **server**: `generateCrossRefSection`, `has`
+- **store**: `Annotation`, `AnnotationKey`, `Session`, `EvolutionEvent`, `CodeSymbol`, `SymbolLink`, `RepoEntry`, `has` (+1 more)
+- **ui**: `AnalysisStats`
+- **test**: `generateAgentsMd`, `AnnotationKey`, `CodeSymbol`, `SymbolLink`, `computeMetrics`, `formatMetricsReport`, `MilensMetrics`, `RawImport` (+17 more)
+- **security**: `has`
+
+## Files
+- AGENTS.md
+- CLAUDE.md
+- CONTRIBUTING.md
+- DEPLOY.md
+- README.md
+- src/agents-md.ts
+- src/cli.ts
+- src/metrics.ts
+- src/skills.ts
+- src/types.ts
+- src/uninstall.ts
+- src/utils.ts
+- vitest.config.ts

package/.agents/skills/scripts/SKILL.md

@@ -1,45 +1,54 @@
----
-name: milens-scripts
-description: Code intelligence for the scripts area — symbols, dependencies, and entry points
----
-
-# Scripts
-
-## Working with this area
-When working with code in **scripts/**, 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` |
-
-## Overview
-Contains 29 symbols (0 exported) across 1 files.
-
-## Entry Points
-- **`ROOT`** [variable] — 2 incoming references
-- **`outDir`** [variable] — 2 incoming references
-- **`resolveTargets`** [function] — 1 incoming references
-- **`run`** [function] — 1 incoming references
-- **`__dirname`** [variable] — 1 incoming references
-
-## Dependencies
-- **analyzer**: `resolve`
-
-## Used By
-- **root**: `outDir`
-
-## Files
-- scripts/build-standalone.mjs
+---
+name: milens-scripts
+description: Code intelligence for the scripts area — symbols, dependencies, and entry points
+---
+
+# Scripts
+
+## Working with this area
+When working with code in **scripts/**, 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` |
+
+## Overview
+Contains 47 symbols (0 exported) across 3 files.
+
+## Entry Points
+- **`root`** [variable] — 37 incoming references
+- **`version`** [variable] — 4 incoming references
+- **`ROOT`** [variable] — 2 incoming references
+- **`outDir`** [variable] — 2 incoming references
+- **`main`** [function] — 2 incoming references
+
+## Dependencies
+- **analyzer**: `resolve`
+- **store**: `Database`, `getCodebaseSummary`, `close`
+
+## Used By
+- **docs**: `main`
+- **analyzer**: `root`
+- **root**: `version`, `outDir`, `root`
+- **parser**: `root`
+- **security**: `version`
+- **server**: `root`
+- **test**: `root`
+
+## Files
+- scripts/build-standalone.mjs
+- scripts/generate-release-stats.js
+- scripts/update-docs.js