milens 0.7.1 → 0.7.3

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

@@ -1,77 +1,84 @@
----
-name: milens-server
-description: Code intelligence for the server area — symbols, dependencies, and entry points
----
-
-# Server
-
-## Working with this area
-When working with code in **server/**, 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 113 symbols (22 exported) across 10 files.
-
-## Key Symbols
-- **`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
-- **`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
-- **`SessionContext`** [interface] (src/server/hooks.ts:15) — 4 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
-- **`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`, `getStats`, `getTestCoverage` (+36 more)
-- **root**: `generateCrossRefSection`, `globToRegex`
-- **analyzer**: `reviewPr`, `countDependentFiles`, `analyze`
-- **parser**: `getParser`, `loadLanguage`, `ALL_LANGS`
-- **orchestrator**: `Orchestrator`, `loadSnapshots`, `snapshot`, `persistSnapshots`, `compare`, `runAndFormat`
-- **security**: `loadRules`
-
-## Used By
-- **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
+---
+generated-by: milens
+name: milens-server
+description: Code intelligence for the server area — symbols, dependencies, and entry points
+---
+
+<!-- Generated by milens — safe to delete/regenerate -->
+# Server
+
+## Working with this area
+When working with code in **server/**, 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 154 symbols (37 exported) across 12 files.
+
+## Key Symbols
+- **`Deps`** [interface] (src/server/tools/deps.ts:4) — 11 refs
+- **`HookManager`** [class] (src/server/hooks.ts:43) — 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
+- **`createMcpServer`** [function] (src/server/mcp.ts:452) — 6 refs
+- **`HookConfig`** [interface] (src/server/hooks.ts:5) — 5 refs
+- **`FileWatcher`** [class] (src/server/watcher.ts:50) — 5 refs
+- **`readMode`** [function] (src/server/guard-hook.ts:38) — 4 refs
+- **`writeMode`** [function] (src/server/guard-hook.ts:50) — 4 refs
+- **`handleMarkChecked`** [function] (src/server/guard-hook.ts:147) — 4 refs
+- **`handleCheckEdit`** [function] (src/server/guard-hook.ts:161) — 4 refs
+- **`defaultOnPreCommit`** [function] (src/server/hooks.ts:237) — 4 refs
+- **`defaultOnFileChange`** [function] (src/server/hooks.ts:323) — 4 refs
+
+## Entry Points
+- **`Deps`** [interface] — 11 incoming references
+- **`HookManager`** [class] — 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`, `getStats`, `getTestCoverage` (+38 more)
+- **root**: `generateCrossRefSection`, `globToRegex`
+- **analyzer**: `reviewPr`, `countDependentFiles`, `analyze`
+- **parser**: `getParser`, `loadLanguage`, `ALL_LANGS`
+- **orchestrator**: `Orchestrator`, `loadSnapshots`, `snapshot`, `persistSnapshots`, `compare`, `runAndFormat`
+- **security**: `loadRules`
+
+## Used By
+- **root**: `startHttp`, `startStdio`, `HookManager`, `defaultOnSessionStart`, `defaultOnSessionEnd`, `defaultOnPreCompact`, `defaultOnPostCompact`, `handleMarkChecked` (+6 more)
+- **test**: `defaultOnSessionStart`, `defaultOnPreCompact`, `defaultOnSessionEnd`, `defaultOnPostCompact`, `createMcpServer`, `markChecked`, `checkEdit`, `readMode` (+26 more)
+
+## Files
+- src/server/guard-hook.ts
+- 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/findings-report.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

@@ -1,72 +1,77 @@
----
-name: milens-store
-description: Code intelligence for the store area — symbols, dependencies, and entry points
----
-
-# Store
-
-## Working with this area
-When working with code in **store/**, 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 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) — 21 refs
-- **`RepoRegistry`** [class] (src/store/registry.ts:18) — 16 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:23) — 3 refs
-- **`boostConfidence`** [function] (src/store/confidence.ts:6) — 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
-- **`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`
-
-## Used By
-- **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
-- src/store/annotations.ts
-- src/store/confidence.ts
-- src/store/db.ts
-- src/store/registry.ts
-- src/store/vectors.ts
+---
+generated-by: milens
+name: milens-store
+description: Code intelligence for the store area — symbols, dependencies, and entry points
+---
+
+<!-- Generated by milens — safe to delete/regenerate -->
+# Store
+
+## Working with this area
+When working with code in **store/**, 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 146 symbols (15 exported) across 5 files.
+
+## Key Symbols
+- **`Database`** [class] (src/store/db.ts:10) — 80 refs
+- **`AnnotationStore`** [class] (src/store/annotations.ts:10) — 21 refs
+- **`RepoRegistry`** [class] (src/store/registry.ts:24) — 18 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:23) — 3 refs
+- **`boostConfidence`** [function] (src/store/confidence.ts:6) — 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
+- **`AnnotationStore`** [class] — 21 incoming references
+- **`RepoRegistry`** [class] — 18 incoming references
+- **`findSymbolById`** [method] — 15 incoming references
+- **`rowToSymbol`** [function] — 13 incoming references
+
+## Dependencies
+- **root**: `Annotation`, `AnnotationKey`, `Session`, `EvolutionEvent`, `CodeSymbol`, `SymbolLink`, `RepoEntry`
+
+## Used By
+- **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` (+38 more)
+- **test**: `Database`, `AnnotationStore`, `RepoRegistry`, `boostConfidence`, `decayConfidence`, `getStaleAnnotations`, `promoteSecurityAnnotations`, `runDecayPass` (+76 more)
+- **apps**: `remove`, `getAnnotations`, `Database`, `getCodebaseSummary`
+- **parser**: `load`
+
+## Files
+- src/store/annotations.ts
+- src/store/confidence.ts
+- src/store/db.ts
+- src/store/registry.ts
+- src/store/vectors.ts