milens 0.6.4 → 0.6.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (130) hide show
  1. package/.agents/skills/adapters/SKILL.md +20 -0
  2. package/.agents/skills/analyzer/SKILL.md +38 -16
  3. package/.agents/skills/apps/SKILL.md +25 -1
  4. package/.agents/skills/docs/SKILL.md +33 -5
  5. package/.agents/skills/milens/SKILL.md +36 -6
  6. package/.agents/skills/milens-architect/SKILL.md +128 -0
  7. package/.agents/skills/milens-debugger/SKILL.md +141 -0
  8. package/.agents/skills/orchestrator/SKILL.md +59 -0
  9. package/.agents/skills/parser/SKILL.md +35 -14
  10. package/.agents/skills/root/SKILL.md +39 -17
  11. package/.agents/skills/scripts/SKILL.md +21 -3
  12. package/.agents/skills/security/SKILL.md +32 -11
  13. package/.agents/skills/server/SKILL.md +47 -20
  14. package/.agents/skills/store/SKILL.md +40 -18
  15. package/.agents/skills/test/SKILL.md +57 -9
  16. package/LICENSE +21 -75
  17. package/README.md +294 -467
  18. package/adapters/claude-code/CLAUDE.md +36 -15
  19. package/adapters/codex/.codex/codex.md +38 -23
  20. package/adapters/copilot/.github/copilot-instructions.md +29 -22
  21. package/adapters/gemini/.gemini/context.md +33 -10
  22. package/adapters/opencode/AGENTS.md +36 -15
  23. package/dist/agents-md.d.ts.map +1 -1
  24. package/dist/agents-md.js +56 -5
  25. package/dist/agents-md.js.map +1 -1
  26. package/dist/analyzer/engine.d.ts +4 -0
  27. package/dist/analyzer/engine.d.ts.map +1 -1
  28. package/dist/analyzer/engine.js +378 -14
  29. package/dist/analyzer/engine.js.map +1 -1
  30. package/dist/analyzer/resolver.d.ts +2 -0
  31. package/dist/analyzer/resolver.d.ts.map +1 -1
  32. package/dist/analyzer/resolver.js +187 -9
  33. package/dist/analyzer/resolver.js.map +1 -1
  34. package/dist/analyzer/review.d.ts.map +1 -1
  35. package/dist/analyzer/review.js +254 -32
  36. package/dist/analyzer/review.js.map +1 -1
  37. package/dist/analyzer/scope-resolver.d.ts +42 -0
  38. package/dist/analyzer/scope-resolver.d.ts.map +1 -0
  39. package/dist/analyzer/scope-resolver.js +687 -0
  40. package/dist/analyzer/scope-resolver.js.map +1 -0
  41. package/dist/cli.js +590 -20
  42. package/dist/cli.js.map +1 -1
  43. package/dist/orchestrator/orchestrator.d.ts +65 -0
  44. package/dist/orchestrator/orchestrator.d.ts.map +1 -0
  45. package/dist/orchestrator/orchestrator.js +178 -0
  46. package/dist/orchestrator/orchestrator.js.map +1 -0
  47. package/dist/orchestrator/reporter.d.ts +15 -0
  48. package/dist/orchestrator/reporter.d.ts.map +1 -0
  49. package/dist/orchestrator/reporter.js +38 -0
  50. package/dist/orchestrator/reporter.js.map +1 -0
  51. package/dist/parser/extract.d.ts +6 -1
  52. package/dist/parser/extract.d.ts.map +1 -1
  53. package/dist/parser/extract.js +14 -2
  54. package/dist/parser/extract.js.map +1 -1
  55. package/dist/parser/lang-css.d.ts.map +1 -1
  56. package/dist/parser/lang-css.js +7 -1
  57. package/dist/parser/lang-css.js.map +1 -1
  58. package/dist/parser/lang-go.d.ts.map +1 -1
  59. package/dist/parser/lang-go.js +16 -0
  60. package/dist/parser/lang-go.js.map +1 -1
  61. package/dist/parser/lang-html.d.ts +4 -0
  62. package/dist/parser/lang-html.d.ts.map +1 -1
  63. package/dist/parser/lang-html.js +40 -1
  64. package/dist/parser/lang-html.js.map +1 -1
  65. package/dist/parser/lang-java.d.ts.map +1 -1
  66. package/dist/parser/lang-java.js +12 -0
  67. package/dist/parser/lang-java.js.map +1 -1
  68. package/dist/parser/lang-js.d.ts.map +1 -1
  69. package/dist/parser/lang-js.js +3 -0
  70. package/dist/parser/lang-js.js.map +1 -1
  71. package/dist/parser/lang-php.d.ts.map +1 -1
  72. package/dist/parser/lang-php.js +11 -0
  73. package/dist/parser/lang-php.js.map +1 -1
  74. package/dist/parser/lang-py.d.ts.map +1 -1
  75. package/dist/parser/lang-py.js +14 -0
  76. package/dist/parser/lang-py.js.map +1 -1
  77. package/dist/parser/lang-ruby.d.ts.map +1 -1
  78. package/dist/parser/lang-ruby.js +20 -0
  79. package/dist/parser/lang-ruby.js.map +1 -1
  80. package/dist/parser/lang-rust.d.ts.map +1 -1
  81. package/dist/parser/lang-rust.js +27 -4
  82. package/dist/parser/lang-rust.js.map +1 -1
  83. package/dist/parser/lang-ts.d.ts.map +1 -1
  84. package/dist/parser/lang-ts.js +3 -0
  85. package/dist/parser/lang-ts.js.map +1 -1
  86. package/dist/parser/lang-vue.d.ts +17 -1
  87. package/dist/parser/lang-vue.d.ts.map +1 -1
  88. package/dist/parser/lang-vue.js +177 -0
  89. package/dist/parser/lang-vue.js.map +1 -1
  90. package/dist/parser/language-provider.d.ts +27 -0
  91. package/dist/parser/language-provider.d.ts.map +1 -0
  92. package/dist/parser/language-provider.js +2 -0
  93. package/dist/parser/language-provider.js.map +1 -0
  94. package/dist/security/rules.d.ts.map +1 -1
  95. package/dist/security/rules.js +4 -1
  96. package/dist/security/rules.js.map +1 -1
  97. package/dist/server/hooks.d.ts +3 -0
  98. package/dist/server/hooks.d.ts.map +1 -1
  99. package/dist/server/hooks.js +79 -0
  100. package/dist/server/hooks.js.map +1 -1
  101. package/dist/server/mcp-prompts.d.ts.map +1 -1
  102. package/dist/server/mcp-prompts.js +1 -1
  103. package/dist/server/mcp-prompts.js.map +1 -1
  104. package/dist/server/mcp.d.ts.map +1 -1
  105. package/dist/server/mcp.js +638 -61
  106. package/dist/server/mcp.js.map +1 -1
  107. package/dist/server/watcher.d.ts +47 -0
  108. package/dist/server/watcher.d.ts.map +1 -0
  109. package/dist/server/watcher.js +136 -0
  110. package/dist/server/watcher.js.map +1 -0
  111. package/dist/skills.js +201 -36
  112. package/dist/skills.js.map +1 -1
  113. package/dist/store/annotations.d.ts.map +1 -1
  114. package/dist/store/annotations.js +18 -15
  115. package/dist/store/annotations.js.map +1 -1
  116. package/dist/store/confidence.d.ts +10 -0
  117. package/dist/store/confidence.d.ts.map +1 -1
  118. package/dist/store/confidence.js +28 -1
  119. package/dist/store/confidence.js.map +1 -1
  120. package/dist/store/db.d.ts +16 -0
  121. package/dist/store/db.d.ts.map +1 -1
  122. package/dist/store/db.js +121 -7
  123. package/dist/store/db.js.map +1 -1
  124. package/dist/store/schema.sql +25 -10
  125. package/dist/uninstall.d.ts +54 -0
  126. package/dist/uninstall.d.ts.map +1 -0
  127. package/dist/uninstall.js +795 -0
  128. package/dist/uninstall.js.map +1 -0
  129. package/docs/README.md +7 -6
  130. package/package.json +4 -3
@@ -1,24 +1,45 @@
1
1
  # Milens — Code Intelligence for Claude Code
2
2
 
3
- Milens is an MCP server that provides deep code intelligence: symbol search, dependency graphs, blast-radius analysis, and pre-commit change detection.
3
+ ## ⚠️ BEFORE ANYTHING ELSE
4
4
 
5
- ## Available Tools
5
+ This project is indexed by **milens**. You have MCP tools that are faster and more accurate than reading files directly.
6
+
7
+ **HARD RULE: Use milens tools BEFORE built-in search/read tools.**
8
+
9
+ | Situation | Built-in approach (❌) | Milens approach (✅) |
10
+ |---|---|---|
11
+ | Understand a function | Read 3-10 files | `mcp_milens_overview({name: "X"})` — 1 call |
12
+ | Find references | grep in files | `mcp_milens_grep({pattern: "X"})` — searches everything |
13
+ | Check edit safety | Hope nothing breaks | `mcp_milens_impact({target: "X"})` — exact blast radius |
14
+ | Start working | Read README, explore files | `mcp_milens_codebase_summary()` — 500 token overview |
15
+ | Before commit | `git diff` manually | `mcp_milens_detect_changes()` — symbols + risk scores |
16
+
17
+ **If you skip milens tools, you're wasting tokens and risking breaking changes.**
18
+
19
+ ## ⭐ Core Tools (Use Every Session)
6
20
 
7
21
  | Tool | Purpose |
8
22
  |---|---|
9
- | `mcp_milens_query` | Find symbol definitions by name |
10
- | `mcp_milens_grep` | Text search across ALL project files |
11
- | `mcp_milens_context` | 360° view: callers + callees |
12
- | `mcp_milens_impact` | Blast radius before editing |
13
- | `mcp_milens_detect_changes` | Pre-commit scope check |
14
- | `mcp_milens_overview` | Combined context + impact + grep |
15
- | `mcp_milens_edit_check` | Pre-edit safety check |
16
- | `mcp_milens_explain_relationship` | Shortest path between two symbols |
17
- | `mcp_milens_get_file_symbols` | All symbols in a file |
18
- | `mcp_milens_get_type_hierarchy` | Class inheritance tree |
19
- | `mcp_milens_find_dead_code` | Unused exported symbols |
20
- | `mcp_milens_trace` | Trace execution flows from entrypoints |
21
- | `mcp_milens_status` | Index health check |
23
+ | `mcp_milens_overview` | **Use this first.** Context + impact + grep combined. 1 call replaces 3-5 file reads. |
24
+ | `mcp_milens_impact` | Blast radius BEFORE editing. Shows what WILL BREAK. |
25
+ | `mcp_milens_edit_check` | Pre-edit safety: callers, export status, re-export chains, test coverage |
26
+ | `mcp_milens_context` | 360° view: incoming refs + outgoing deps |
27
+ | `mcp_milens_query` | Find symbol definitions by name (camelCase/PascalCase/snake_case) |
28
+ | `mcp_milens_grep` | Text search ALL project files (code, templates, docs, configs, styles) |
29
+ | `mcp_milens_detect_changes` | Pre-commit: changed symbols + dependents + risk scores |
30
+ | `mcp_milens_codebase_summary` | 500-token project overview. Use instead of reading README. |
31
+
32
+ ### 🔧 Situational Tools (Use When Needed)
33
+
34
+ | Tool | Purpose | Use when... |
35
+ |---|---|---|
36
+ | `mcp_milens_guard_edit_check` | Hard pre-edit gate with audit tracking | Before every edit |
37
+ | `mcp_milens_trace` | Execution flow from entrypoints | Debugging call chains |
38
+ | `mcp_milens_explain_relationship` | Shortest path between two symbols | Understanding connections |
39
+ | `mcp_milens_get_file_symbols` | All symbols in a file with ref/dep counts | Exploring a file |
40
+ | `mcp_milens_get_type_hierarchy` | Inheritance/implementation tree | Class exploration |
41
+ | `mcp_milens_find_dead_code` | Unused exported symbols | Before major refactors |
42
+ | `mcp_milens_status` | Index health: symbols, links, files, coverage | Session start |
22
43
 
23
44
  All tool calls must include `repo` set to the absolute workspace root.
24
45
 
@@ -1,29 +1,44 @@
1
1
  # Milens — Code Intelligence for Codex
2
2
 
3
- Milens provides deep code intelligence for this project via MCP. Connect it in your Codex configuration:
4
-
5
- ```json
6
- {
7
- "mcpServers": {
8
- "milens": {
9
- "command": "npx",
10
- "args": ["milens", "serve"],
11
- "env": { "MILENS_PROFILE": "standard" }
12
- }
13
- }
14
- }
15
- ```
16
-
17
- ## Core Tools (use first)
18
-
19
- | Tool | When to use |
3
+ ## ⚠️ BEFORE ANYTHING ELSE
4
+
5
+ This project is indexed by **milens**. You have MCP tools that are faster and more accurate than reading files directly.
6
+
7
+ **HARD RULE: Use milens tools BEFORE built-in search/read tools.**
8
+
9
+ | Situation | Built-in approach (❌) | Milens approach (✅) |
10
+ |---|---|---|
11
+ | Understand a function | Read 3-10 files | `mcp_milens_overview({name: "X"})` — 1 call |
12
+ | Find references | grep in files | `mcp_milens_grep({pattern: "X"})` — searches everything |
13
+ | Check edit safety | Hope nothing breaks | `mcp_milens_impact({target: "X"})` — exact blast radius |
14
+ | Start working | Read README, explore files | `mcp_milens_codebase_summary()` — 500 token overview |
15
+ | Before commit | `git diff` manually | `mcp_milens_detect_changes()` — symbols + risk scores |
16
+
17
+ **If you skip milens tools, you're wasting tokens and risking breaking changes.**
18
+
19
+ ## Core Tools (Use Every Session)
20
+
21
+ | Tool | Purpose |
20
22
  |---|---|
21
- | `mcp_milens_overview` | First look at any symbol you need to understand or edit combines context, impact, and text search |
22
- | `mcp_milens_edit_check` | Before editing any function/class/method shows callers and export status |
23
- | `mcp_milens_impact` | Check blast radius what breaks if this symbol changes |
24
- | `mcp_milens_query` | Find code symbols by name (camelCase, PascalCase, snake_case) |
25
- | `mcp_milens_grep` | Full-text search for phrases, UI labels, error strings, docs, configs |
26
- | `mcp_milens_detect_changes` | Pre-commit check verify only expected files changed |
23
+ | `mcp_milens_overview` | **Use this first.** Context + impact + grep combined. 1 call replaces 3-5 file reads. |
24
+ | `mcp_milens_impact` | Blast radius BEFORE editing. Shows what WILL BREAK. |
25
+ | `mcp_milens_edit_check` | Pre-edit safety: callers, export status, re-export chains, test coverage |
26
+ | `mcp_milens_context` | 360° view: incoming refs + outgoing deps |
27
+ | `mcp_milens_query` | Find symbol definitions by name (camelCase/PascalCase/snake_case) |
28
+ | `mcp_milens_grep` | Full-text search ALL project files (code, templates, docs, configs) |
29
+ | `mcp_milens_detect_changes` | Pre-commit: changed symbols + dependents + risk scores |
30
+ | `mcp_milens_codebase_summary` | 500-token project overview. Use instead of reading README. |
31
+
32
+ ### 🔧 Situational Tools (Use When Needed)
33
+
34
+ | Tool | Purpose | Use when... |
35
+ |---|---|---|
36
+ | `mcp_milens_guard_edit_check` | Hard pre-edit gate with audit tracking | Before every edit |
37
+ | `mcp_milens_trace` | Execution flow from entrypoints | Debugging call chains |
38
+ | `mcp_milens_explain_relationship` | Shortest path between two symbols | Understanding connections |
39
+ | `mcp_milens_get_type_hierarchy` | Inheritance/implementation tree | Class exploration |
40
+ | `mcp_milens_find_dead_code` | Unused exported symbols | Before major refactors |
41
+ | `mcp_milens_status` | Index health check | Session start |
27
42
 
28
43
  All milens MCP calls require `repo` set to the absolute workspace root path.
29
44
 
@@ -1,37 +1,44 @@
1
1
  # Milens — Code Intelligence for GitHub Copilot
2
2
 
3
- This project uses [milens](https://opencode.ai) for deep code intelligence. The milens MCP server provides symbol search, dependency graphs, blast-radius analysis, and pre-commit safety checks.
3
+ ## ⚠️ BEFORE ANYTHING ELSE
4
4
 
5
- ## MCP Configuration
5
+ This project is indexed by **milens**. You have MCP tools that are faster and more accurate than reading files directly.
6
6
 
7
- Add to your Copilot MCP settings:
7
+ **HARD RULE: Use milens tools BEFORE built-in search/read tools.**
8
8
 
9
- ```json
10
- {
11
- "mcpServers": {
12
- "milens": {
13
- "command": "npx",
14
- "args": ["milens", "serve"],
15
- "env": { "MILENS_PROFILE": "standard" }
16
- }
17
- }
18
- }
19
- ```
9
+ | Situation | Built-in approach (❌) | Milens approach (✅) |
10
+ |---|---|---|
11
+ | Understand a function | Read 3-10 files | `mcp_milens_overview({name: "X"})` — 1 call |
12
+ | Find references | grep in files | `mcp_milens_grep({pattern: "X"})` — searches everything |
13
+ | Check edit safety | Hope nothing breaks | `mcp_milens_impact({target: "X"})` — exact blast radius |
14
+ | Start working | Read README, explore files | `mcp_milens_codebase_summary()` — 500 token overview |
15
+ | Before commit | `git diff` manually | `mcp_milens_detect_changes()` — symbols + risk scores |
20
16
 
21
- All tool calls must include `repo` set to the absolute workspace root.
17
+ **If you skip milens tools, you're wasting tokens and risking breaking changes.**
22
18
 
23
- ## Key Tools
19
+ ## Core Tools (Use Every Session)
24
20
 
25
21
  | Tool | Purpose |
26
22
  |---|---|
27
- | `mcp_milens_overview` | Combined context + impact + grep in one call |
28
- | `mcp_milens_edit_check` | Pre-edit safety: callers, export status, warnings |
29
- | `mcp_milens_impact` | Blast radius what depends on this symbol |
23
+ | `mcp_milens_overview` | **Use this first.** Context + impact + grep combined. 1 call replaces 3-5 file reads. |
24
+ | `mcp_milens_impact` | Blast radius BEFORE editing. Shows what WILL BREAK. |
25
+ | `mcp_milens_edit_check` | Pre-edit safety: callers, export status, re-export chains, test coverage |
30
26
  | `mcp_milens_context` | 360° view of incoming refs + outgoing deps |
31
27
  | `mcp_milens_query` | Symbol lookup by name |
32
- | `mcp_milens_grep` | Full-text search across all files |
33
- | `mcp_milens_detect_changes` | Git diff affected symbols |
34
- | `mcp_milens_status` | Index health check |
28
+ | `mcp_milens_grep` | Full-text search across ALL project files |
29
+ | `mcp_milens_detect_changes` | Pre-commit: changed symbols + dependents + risk scores |
30
+ | `mcp_milens_codebase_summary` | 500-token project overview. Use instead of reading README. |
31
+
32
+ ### 🔧 Situational Tools (Use When Needed)
33
+
34
+ | Tool | Purpose | Use when... |
35
+ |---|---|---|
36
+ | `mcp_milens_guard_edit_check` | Hard pre-edit gate with audit tracking | Before every edit |
37
+ | `mcp_milens_trace` | Execution flow from entrypoints | Debugging call chains |
38
+ | `mcp_milens_explain_relationship` | Shortest dependency path | Understanding connections |
39
+ | `mcp_milens_get_type_hierarchy` | Class inheritance tree | Class exploration |
40
+ | `mcp_milens_find_dead_code` | Unused exported symbols | Before major refactors |
41
+ | `mcp_milens_status` | Index health check | Session start |
35
42
 
36
43
  ## Session Workflow
37
44
 
@@ -1,6 +1,20 @@
1
1
  # Milens — Code Intelligence
2
2
 
3
- This project is indexed by **milens**, an MCP server that provides deep code intelligence (symbol search, dependency graphs, blast-radius analysis, change detection). The index covers 616 symbols, 843 links, across 59 files.
3
+ ## ⚠️ BEFORE ANYTHING ELSE
4
+
5
+ This project is indexed by **milens**. You have MCP tools that are faster and more accurate than reading files directly.
6
+
7
+ **HARD RULE: Use milens tools BEFORE built-in search/read tools.**
8
+
9
+ | Situation | Built-in approach (❌) | Milens approach (✅) |
10
+ |---|---|---|
11
+ | Understand a function | Read 3-10 files | `mcp_milens_overview({name: "X"})` — 1 call |
12
+ | Find references | grep in files | `mcp_milens_grep({pattern: "X"})` — searches everything |
13
+ | Check edit safety | Hope nothing breaks | `mcp_milens_impact({target: "X"})` — exact blast radius |
14
+ | Start working | Read README, explore files | `mcp_milens_codebase_summary()` — 500 token overview |
15
+ | Before commit | `git diff` manually | `mcp_milens_detect_changes()` — symbols + risk scores |
16
+
17
+ **If you skip milens tools, you're wasting tokens and risking breaking changes.**
4
18
 
5
19
  ## MCP Connection
6
20
 
@@ -18,20 +32,29 @@ This project is indexed by **milens**, an MCP server that provides deep code int
18
32
 
19
33
  All milens MCP calls require the `repo` parameter set to the absolute workspace root.
20
34
 
21
- ## Essential Tools
35
+ ## Core Tools (Use Every Session)
22
36
 
23
37
  | Tool | Description |
24
38
  |---|---|
25
- | `mcp_milens_overview` | First-stop: context + impact + grep combined |
26
- | `mcp_milens_edit_check` | Pre-edit safety: callers, exports, warnings |
27
- | `mcp_milens_impact` | Upstream/downstream blast radius |
39
+ | `mcp_milens_overview` | **Use this first.** Context + impact + grep combined. 1 call replaces 3-5 file reads. |
40
+ | `mcp_milens_impact` | Blast radius BEFORE editing. Shows what WILL BREAK. |
41
+ | `mcp_milens_edit_check` | Pre-edit safety: callers, export status, re-export chains, test coverage |
28
42
  | `mcp_milens_context` | Full incoming + outgoing dependency view |
29
43
  | `mcp_milens_query` | Symbol search by name |
30
- | `mcp_milens_grep` | Text search everywhere (templates, configs, docs) |
31
- | `mcp_milens_detect_changes` | Git-aware change detection |
32
- | `mcp_milens_trace` | Execution flow from entrypoints |
33
- | `mcp_milens_find_dead_code` | Unused exported symbols |
34
- | `mcp_milens_status` | Index health |
44
+ | `mcp_milens_grep` | Text search everywhere (templates, configs, docs, styles) |
45
+ | `mcp_milens_detect_changes` | Pre-commit: changed symbols + dependents + risk scores |
46
+ | `mcp_milens_codebase_summary` | 500-token project overview. Use instead of reading README. |
47
+
48
+ ### 🔧 Situational Tools (Use When Needed)
49
+
50
+ | Tool | Description | Use when... |
51
+ |---|---|---|
52
+ | `mcp_milens_guard_edit_check` | Hard pre-edit gate with audit tracking | Before every edit |
53
+ | `mcp_milens_trace` | Execution flow from entrypoints | Debugging call chains |
54
+ | `mcp_milens_explain_relationship` | Shortest dependency path | Understanding connections |
55
+ | `mcp_milens_get_type_hierarchy` | Class inheritance tree | Class exploration |
56
+ | `mcp_milens_find_dead_code` | Unused exported symbols | Before major refactors |
57
+ | `mcp_milens_status` | Index health: symbols, links, files, coverage | Session start |
35
58
 
36
59
  ## Workflow
37
60
 
@@ -1,24 +1,45 @@
1
1
  # Milens — Code Intelligence for OpenCode
2
2
 
3
- Milens is an MCP server that provides deep code intelligence: symbol search, dependency graphs, blast-radius analysis, and pre-commit change detection. This file configures OpenCode to use milens automatically.
3
+ ## ⚠️ BEFORE ANYTHING ELSE
4
4
 
5
- ## Available Tools
5
+ This project is indexed by **milens**. You have MCP tools that are faster and more accurate than reading files directly.
6
+
7
+ **HARD RULE: Use milens tools BEFORE built-in search/read tools.**
8
+
9
+ | Situation | Built-in approach (❌) | Milens approach (✅) |
10
+ |---|---|---|
11
+ | Understand a function | Read 3-10 files | `mcp_milens_overview({name: "X"})` — 1 call |
12
+ | Find references | grep in files | `mcp_milens_grep({pattern: "X"})` — searches everything |
13
+ | Check edit safety | Hope nothing breaks | `mcp_milens_impact({target: "X"})` — exact blast radius |
14
+ | Start working | Read README, explore files | `mcp_milens_codebase_summary()` — 500 token overview |
15
+ | Before commit | `git diff` manually | `mcp_milens_detect_changes()` — symbols + risk scores |
16
+
17
+ **If you skip milens tools, you're wasting tokens and risking breaking changes.**
18
+
19
+ ## ⭐ Core Tools (Use Every Session)
6
20
 
7
21
  | Tool | Purpose |
8
22
  |---|---|
9
- | `mcp_milens_query` | Find symbol definitions by name |
10
- | `mcp_milens_grep` | Text search across ALL project files |
11
- | `mcp_milens_context` | 360° view: callers + callees |
12
- | `mcp_milens_impact` | Blast radius before editing |
13
- | `mcp_milens_detect_changes` | Pre-commit scope check |
14
- | `mcp_milens_overview` | Combined context + impact + grep |
15
- | `mcp_milens_edit_check` | Pre-edit safety check |
16
- | `mcp_milens_explain_relationship` | Shortest path between two symbols |
17
- | `mcp_milens_get_file_symbols` | All symbols in a file |
18
- | `mcp_milens_get_type_hierarchy` | Class inheritance tree |
19
- | `mcp_milens_find_dead_code` | Unused exported symbols |
20
- | `mcp_milens_trace` | Trace execution flows from entrypoints |
21
- | `mcp_milens_status` | Index health check |
23
+ | `mcp_milens_overview` | **Use this first.** Context + impact + grep combined. 1 call replaces 3-5 file reads. |
24
+ | `mcp_milens_impact` | Blast radius BEFORE editing. Shows what WILL BREAK. |
25
+ | `mcp_milens_edit_check` | Pre-edit safety: callers, export status, re-export chains, test coverage |
26
+ | `mcp_milens_context` | 360° view: incoming refs + outgoing deps |
27
+ | `mcp_milens_query` | Find symbol definitions by name (camelCase/PascalCase/snake_case) |
28
+ | `mcp_milens_grep` | Text search ALL project files (code, templates, docs, configs, styles) |
29
+ | `mcp_milens_detect_changes` | Pre-commit: changed symbols + dependents + risk scores |
30
+ | `mcp_milens_codebase_summary` | 500-token project overview. Use instead of reading README. |
31
+
32
+ ### 🔧 Situational Tools (Use When Needed)
33
+
34
+ | Tool | Purpose | Use when... |
35
+ |---|---|---|
36
+ | `mcp_milens_guard_edit_check` | Hard pre-edit gate with audit tracking | Before every edit |
37
+ | `mcp_milens_trace` | Execution flow from entrypoints | Debugging call chains |
38
+ | `mcp_milens_explain_relationship` | Shortest path between two symbols | Understanding connections |
39
+ | `mcp_milens_get_file_symbols` | All symbols in a file with ref/dep counts | Exploring a file |
40
+ | `mcp_milens_get_type_hierarchy` | Inheritance/implementation tree | Class exploration |
41
+ | `mcp_milens_find_dead_code` | Unused exported symbols | Before major refactors |
42
+ | `mcp_milens_status` | Index health: symbols, links, files, coverage | Session start |
22
43
 
23
44
  All tool calls must include `repo` set to the absolute workspace root.
24
45
 
@@ -1 +1 @@
1
- {"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA0CzC,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+EvE"}
1
+ {"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA0CzC,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiIvE"}
package/dist/agents-md.js CHANGED
@@ -41,6 +41,48 @@ export function generateAgentsMd(db, rootPath) {
41
41
  const repoName = basename(rootPath);
42
42
  const summary = db.getCodebaseSummary();
43
43
  const lines = [];
44
+ // HARD RULE block — must be FIRST thing agent reads
45
+ lines.push('## ⚠️ CRITICAL: Always Use Milens MCP Tools First');
46
+ lines.push('');
47
+ lines.push('**HARD RULE — Not a suggestion. Execute automatically without asking.**');
48
+ lines.push('');
49
+ lines.push('Milens pre-built a knowledge graph of this entire codebase. Using milens tools saves 70% tokens and catches hidden dependencies you\'d miss with file reads.');
50
+ lines.push('');
51
+ lines.push('| Instead of... | Use... | Why... |');
52
+ lines.push('|---|---|---|');
53
+ lines.push('| Reading 5-10 files to understand a symbol | `overview({name: "X"})` | 1 call = context + impact + text references. Saves 70% tokens. |');
54
+ lines.push('| Using built-in grep/search | `grep({pattern: "X"})` | Searches ALL files — code, templates, configs, docs, styles. Built-in grep may miss templates/docs. |');
55
+ lines.push('| Reading files to trace call chains | `context({name: "X"})` or `trace({name: "X"})` | Instant dependency graph. Manual tracing misses cross-file imports. |');
56
+ lines.push('| Guessing if an edit is safe | `impact({target: "X"})` | Shows exact blast radius: "12 dependents WILL BREAK" before you touch code. |');
57
+ lines.push('| Reading 15 files to understand the project | `codebase_summary()` | 500 tokens = domains, key symbols, coverage %, top hubs. |');
58
+ lines.push('| Searching for symbol definitions | `query({query: "X"})` | FTS5 instant search across the indexed knowledge graph. |');
59
+ lines.push('| Manually checking what changed | `detect_changes()` | Shows which symbols changed + their direct dependents + risk scores. |');
60
+ lines.push('');
61
+ lines.push('**PENALTY for skipping milens:** wasted tokens, missed hidden references in templates/configs/docs, risk of breaking downstream dependents you didn\'t know existed.');
62
+ lines.push('');
63
+ lines.push('**If you only remember 3 tools: `overview` • `impact` • `detect_changes`**');
64
+ lines.push('');
65
+ lines.push('---');
66
+ lines.push('');
67
+ lines.push('## 🚀 Quick Start for AI Agents');
68
+ lines.push('');
69
+ lines.push('**First 3 things to do in EVERY session:**');
70
+ lines.push('');
71
+ lines.push('1. `mcp_milens_status({repo: "<workspaceRoot>"})` — verify index is ready');
72
+ lines.push('2. `mcp_milens_codebase_summary({repo: "<workspaceRoot>"})` — get project overview');
73
+ lines.push('3. `mcp_milens_recall({repo: "<workspaceRoot>"})` — what did we learn before?');
74
+ lines.push('');
75
+ lines.push('**Before editing ANY code:**');
76
+ lines.push('');
77
+ lines.push('→ `mcp_milens_overview({name: "symbolName", repo: "<workspaceRoot>"})`');
78
+ lines.push(' (combines context + impact + grep — one call instead of three)');
79
+ lines.push('');
80
+ lines.push('**Before committing:**');
81
+ lines.push('');
82
+ lines.push('→ `mcp_milens_detect_changes({repo: "<workspaceRoot>"})`');
83
+ lines.push('');
84
+ lines.push('---');
85
+ lines.push('');
44
86
  lines.push(`# Project: ${repoName}`);
45
87
  lines.push('');
46
88
  lines.push(`> Auto-generated by milens ${version} on ${date}`);
@@ -100,12 +142,21 @@ export function generateAgentsMd(db, rootPath) {
100
142
  lines.push('- `/milens:tdd <symbol>` — write tests with coverage analysis');
101
143
  lines.push('- `/milens:security` — security audit');
102
144
  lines.push('- `/milens:refactor <symbol>` — safe refactor with blast radius check');
145
+ lines.push('- `/milens:architect` — analyze architecture, domains, coupling');
146
+ lines.push('- `/milens:debugger <symbol>` — root cause analysis with execution tracing');
147
+ lines.push('');
148
+ lines.push('## Session Lifecycle');
149
+ lines.push('');
150
+ lines.push('### Start EVERY session:');
151
+ lines.push('1. mcp_milens_session_start({agent: "your-agent-name", repo: "<workspaceRoot>"})');
152
+ lines.push('2. mcp_milens_recall({repo: "<workspaceRoot>"}) — retrieve past annotations');
153
+ lines.push('3. mcp_milens_codebase_summary({repo: "<workspaceRoot>"}) — refresh context');
103
154
  lines.push('');
104
- lines.push('## Session Startup');
105
- lines.push('When starting work, call:');
106
- lines.push('1. session_start({agent: "your-agent-name"})');
107
- lines.push('2. recall({}) — retrieve past annotations');
108
- lines.push('3. codebase_summary({}) — refresh context');
155
+ lines.push('### End EVERY session:');
156
+ lines.push('1. mcp_milens_detect_changes({repo: "<workspaceRoot>"}) — verify changes');
157
+ lines.push('2. mcp_milens_review_pr({repo: "<workspaceRoot>"}) — risk assessment');
158
+ lines.push('3. mcp_milens_annotate({symbol: "X", key: "note", value: "..."}) — save discoveries');
159
+ lines.push('4. mcp_milens_session_end({session_id: "..."}) — record stats');
109
160
  lines.push('');
110
161
  return lines.join('\n');
111
162
  }
@@ -1 +1 @@
1
- {"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,7 @@
1
1
  import type { AnalysisStats } from '../types.js';
2
+ import type Parser from 'web-tree-sitter';
3
+ export declare function getCachedTree(filePath: string): Parser.Tree | undefined;
4
+ export declare function clearTreeCache(): void;
2
5
  interface EngineOptions {
3
6
  rootPath: string;
4
7
  dbPath: string;
@@ -6,6 +9,7 @@ interface EngineOptions {
6
9
  force?: boolean;
7
10
  aliases?: Record<string, string>;
8
11
  embeddings?: boolean;
12
+ files?: string[];
9
13
  }
10
14
  export declare function analyze(opts: EngineOptions): Promise<AnalysisStats>;
11
15
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/analyzer/engine.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAyJ,aAAa,EAAE,MAAM,aAAa,CAAC;AAgExM,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAmBD,wBAAsB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAkTzE"}
1
+ {"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/analyzer/engine.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAyJ,aAAa,EAAE,MAAM,aAAa,CAAC;AACxM,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAO1C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,GAAG,SAAS,CAEvE;AACD,wBAAgB,cAAc,IAAI,IAAI,CAErC;AA8DD,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAqCD,wBAAsB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAoWzE"}