milens 0.6.3 → 0.6.5

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

@@ -0,0 +1,51 @@
+---
+name: milens-adapters
+description: Code intelligence for the adapters area — symbols, dependencies, and entry points
+---
+
+# 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` |
+
+## Overview
+Contains 30 symbols (27 exported) across 3 files.
+
+## Key Symbols
+- **`Milens — Code Intelligence for Claude Code`** [section] (adapters/claude-code/CLAUDE.md:1) — 0 refs
+- **`Available Tools`** [section] (adapters/claude-code/CLAUDE.md:5) — 0 refs
+- **`Session Workflow`** [section] (adapters/claude-code/CLAUDE.md:25) — 0 refs
+- **`Edit Safety (Mandatory)`** [section] (adapters/claude-code/CLAUDE.md:33) — 0 refs
+- **`Tool Selection`** [section] (adapters/claude-code/CLAUDE.md:49) — 0 refs
+- **`Reference`** [section] (adapters/claude-code/CLAUDE.md:55) — 0 refs
+- **`Milens — Code Intelligence for OpenCode`** [section] (adapters/opencode/AGENTS.md:1) — 0 refs
+- **`Available Tools`** [section] (adapters/opencode/AGENTS.md:5) — 0 refs
+- **`Session Workflow`** [section] (adapters/opencode/AGENTS.md:25) — 0 refs
+- **`Edit Safety (Mandatory)`** [section] (adapters/opencode/AGENTS.md:33) — 0 refs
+- **`Tool Selection`** [section] (adapters/opencode/AGENTS.md:49) — 0 refs
+- **`Reference`** [section] (adapters/opencode/AGENTS.md:55) — 0 refs
+- **`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
+
+## Files
+- adapters/README.md
+- adapters/claude-code/CLAUDE.md
+- adapters/opencode/AGENTS.md

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

@@ -0,0 +1,77 @@
+---
+name: milens-analyzer
+description: Code intelligence for the analyzer area — symbols, dependencies, and entry points
+---
+
+# 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` |
+
+## Overview
+Contains 80 symbols (21 exported) across 7 files.
+
+## Key Symbols
+- **`reviewPr`** [function] (src/analyzer/review.ts:101) — 7 refs
+- **`resolveLinksWithStats`** [function] (src/analyzer/resolver.ts:35) — 5 refs
+- **`loadAliases`** [function] (src/analyzer/config.ts:10) — 4 refs
+- **`analyze`** [function] (src/analyzer/engine.ts:125) — 4 refs
+- **`enrichMetadata`** [function] (src/analyzer/enrich.ts:21) — 4 refs
+- **`ReviewResult`** [interface] (src/analyzer/review.ts:17) — 4 refs
+- **`scanFiles`** [function] (src/analyzer/scanner.ts:11) — 4 refs
+- **`resolveLinks`** [function] (src/analyzer/resolver.ts:30) — 3 refs
+- **`reviewSymbol`** [function] (src/analyzer/review.ts:167) — 2 refs
+- **`generateTestPlan`** [function] (src/analyzer/testplan.ts:104) — 2 refs
+- **`findCoverageGaps`** [function] (src/analyzer/testplan.ts:175) — 2 refs
+- **`analyzeTestImpact`** [function] (src/analyzer/testplan.ts:208) — 2 refs
+- **`ResolutionResult`** [interface] (src/analyzer/resolver.ts:22) — 1 refs
+- **`SymbolRisk`** [interface] (src/analyzer/review.ts:8) — 1 refs
+- **`RiskLevel`** [type] (src/analyzer/review.ts:6) — 1 refs
+
+## Entry Points
+- **`find`** [function] — 22 incoming references
+- **`resolve`** [method] — 15 incoming references
+- **`reviewPr`** [function] — 7 incoming references
+- **`resolveLinksWithStats`** [function] — 5 incoming references
+- **`loadAliases`** [function] — 4 incoming references
+
+## Dependencies
+- **parser**: `langForFile`, `supportedExtensions`, `getParser`, `loadLanguage`, `extractFromTree`, `clearQueryCache`, `extractVueScript`, `extractVueTemplateRefs` (+6 more)
+- **root**: `isTestFile`, `CodeSymbol`, `ExtractionResult`, `RawImport`, `RawCall`, `RawHeritage`, `RawReExport`, `RawTypeBinding` (+8 more)
+- **store**: `Database`, `TfIdfProvider`, `EmbeddingStore`, `buildEmbeddingText`, `get`, `clearFiles`, `clear`, `isFileUpToDate` (+23 more)
+- **test**: `parser`, `lang`
+
+## Used By
+- **root**: `loadAliases`, `analyze`, `resolve`, `clear`
+- **orchestrator**: `reviewPr`, `ReviewResult`, `SymbolRisk`
+- **server**: `reviewPr`, `resolve`, `find`
+- **test**: `enrichMetadata`, `resolveLinks`, `resolveLinksWithStats`, `reviewSymbol`, `reviewPr`, `scanFiles`, `generateTestPlan`, `findCoverageGaps` (+5 more)
+- **scripts**: `resolve`
+- **parser**: `find`, `resolve`
+- **store**: `find`, `resolve`
+
+## Files
+- src/analyzer/config.ts
+- src/analyzer/engine.ts
+- src/analyzer/enrich.ts
+- src/analyzer/resolver.ts
+- src/analyzer/review.ts
+- src/analyzer/scanner.ts
+- src/analyzer/testplan.ts

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

@@ -0,0 +1,66 @@
+---
+name: milens-apps
+description: Code intelligence for the apps area — symbols, dependencies, and entry points
+---
+
+# 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` |
+
+## Overview
+Contains 38 symbols (12 exported) across 10 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
+- **`AgentsMdGenerator`** [class] (apps/github/generators/agents-md.js:1) — 0 refs
+- **`SecurityGenerator`** [class] (apps/github/generators/security.js:1) — 0 refs
+- **`SkillsGenerator`** [class] (apps/github/generators/skills.js:1) — 0 refs
+- **`MilensRunner`** [class] (apps/github/handlers/milens-runner.js:6) — 0 refs
+
+## Entry Points
+- **`createWindow`** [function] — 1 incoming references
+- **`__dirname`** [variable] — 1 incoming references
+- **`checkRateLimit`** [function] — 1 incoming references
+- **`getTier`** [function] — 1 incoming references
+- **`runMilensAnalyze`** [function] — 1 incoming references
+
+## Dependencies
+- **store**: `remove`, `Database`, `getCodebaseSummary`, `close`
+- **test**: `dbPath`
+
+## 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
+- apps/github/generators/agents-md.js
+- apps/github/generators/security.js
+- apps/github/generators/skills.js
+- apps/github/handlers/milens-runner.js

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

@@ -0,0 +1,73 @@
+---
+name: milens-docs
+description: Code intelligence for the docs area — symbols, dependencies, and entry points
+---
+
+# 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` |
+
+## Overview
+Contains 129 symbols (109 exported) across 18 files.
+
+## Key Symbols
+- **`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:29) — 0 refs
+- **`Cursor`** [section] (docs/adapters.md:36) — 0 refs
+- **`GitHub Copilot`** [section] (docs/adapters.md:42) — 0 refs
+- **`Codex`** [section] (docs/adapters.md:48) — 0 refs
+- **`Gemini`** [section] (docs/adapters.md:54) — 0 refs
+- **`Zed`** [section] (docs/adapters.md:60) — 0 refs
+- **`Automated Install`** [section] (docs/adapters.md:66) — 0 refs
+- **`Profile Selection`** [section] (docs/adapters.md:74) — 0 refs
+- **`MCP Config Reference`** [section] (docs/adapters.md:86) — 0 refs
+- **`Milens Pricing`** [section] (docs/pricing.md:1) — 0 refs
+- **`Why Pay?`** [section] (docs/pricing.md:7) — 0 refs
+
+## Entry Points
+- **`applyFilters`** [function] — 1 incoming references
+- **`applyFilters`** [function] — 1 incoming references
+
+## Dependencies
+- **store**: `remove`
+
+## Files
+- docs/README.md
+- docs/adapters.html
+- docs/adapters.md
+- docs/changelog.html
+- docs/compare.html
+- docs/github-app.html
+- docs/index.html
+- docs/learning.html
+- docs/platforms.html
+- docs/pricing.html
+- docs/pricing.md
+- docs/quickstart.md
+- docs/scenarios.html
+- docs/security-presets.md
+- docs/security.html
+- docs/skills.html
+- docs/tools.md
+- docs/vi-VN/README.md

package/.agents/skills/milens/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: milens
+description: Code intelligence MCP tools — symbol search, text grep, impact analysis, dependency graph
+---
+
+<!-- milens:start -->
+# Milens — AI-DOS
+
+The Operating System for AI-Driven Development. This project is indexed by milens (1048 symbols, 1771 links, 129 files).
+
+> **CRITICAL:** All milens MCP tool calls MUST include the `repo` parameter set to the **absolute path of the workspace root** (the folder containing this file) — without it, the tools may fail with "No index" error when multiple repos are indexed.
+
+> **CRITICAL:** milens MCP tools are **deferred** in most editors. Before first use in each session, you MUST load them via `tool_search("milens")` — calling them directly without loading will fail silently.
+
+## Mandatory Workflows
+
+These are **hard pre-conditions**, not guidelines. Execute them automatically without asking.
+
+### Before editing any function, class, or method:
+1. `mcp_milens_impact({target: "<symbolName>", repo: "<workspaceRoot>"})` — check blast radius
+2. If depth-1 dependents > 5 → **STOP and warn the user** before proceeding
+3. `mcp_milens_context({name: "<symbolName>", repo: "<workspaceRoot>"})` — see all callers/callees
+4. Only then make the edit
+
+### Before committing:
+1. `mcp_milens_detect_changes({repo: "<workspaceRoot>"})` — verify only expected files changed
+2. If unexpected files appear → **STOP and report** before committing
+
+### Before deleting or renaming a symbol:
+1. `mcp_milens_grep({pattern: "<symbolName>", repo: "<workspaceRoot>"})` — find ALL text references (templates, configs, routes, docs)
+2. `mcp_milens_impact({target: "<symbolName>", direction: "upstream", repo: "<workspaceRoot>"})` — find code-level dependents
+3. Combine both results — grep catches what impact misses
+
+## Tool Selection Rules
+
+**Choose the right tool on the FIRST call** — do not try `query` then fall back to `grep`.
+
+### Use `mcp_milens_grep` when the search term:
+- Contains **spaces** (e.g. "store purchase header", "user not found")
+- Looks like a **UI label, error message, or display string**
+- Is a **multi-word phrase** that is NOT camelCase/snake_case/PascalCase
+- You need to find references in **templates, styles, configs, routes, or docs**
+
+### Use `mcp_milens_query` when the search term:
+- Looks like a **code identifier** (camelCase, PascalCase, snake_case)
+- Is a **function, class, method, or interface name**
+- You want to find **symbol definitions** in indexed code files
+
+### When in doubt → use `mcp_milens_grep` first
+`grep` searches everything. `query` only searches indexed symbol definitions.
+
+## Workflow Triggers
+
+When the user says... → do this FIRST:
+
+| User intent | First action |
+|---|---|
+| "edit/change/modify/fix `X`" | `mcp_milens_impact({target: "X", repo: "<workspaceRoot>"})` |
+| "delete/remove `X`" | `mcp_milens_grep({pattern: "X", repo: "<workspaceRoot>"})` then `mcp_milens_impact` |
+| "rename `X`" | `mcp_milens_grep({pattern: "X", repo: "<workspaceRoot>"})` then `mcp_milens_impact` |
+| "find/search for `X`" | Choose `query` or `grep` per rules above |
+| "commit" / "push" | `mcp_milens_detect_changes({repo: "<workspaceRoot>"})` |
+| "what calls/uses `X`" | `mcp_milens_context({name: "X", repo: "<workspaceRoot>"})` |
+| "what happens if I change `X`" | `mcp_milens_impact({target: "X", repo: "<workspaceRoot>"})` |
+| "how are `A` and `B` connected" | `mcp_milens_explain_relationship({from: "A", to: "B", repo: "<workspaceRoot>"})` |
+| "explore/understand `X`" | `mcp_milens_context({name: "X", repo: "<workspaceRoot>"})` |
+| "update/write docs for `X`" | `mcp_milens_grep({pattern: "X", include: "**/*.md"})` — find existing docs mentioning X, then `mcp_milens_context({name: "X"})` for full symbol info |
+| "research/explore docs" | `mcp_milens_get_file_symbols({file: "<doc.md>"})` — see document outline (headings as sections) |
+| "what docs mention `X`" | `mcp_milens_grep({pattern: "X", include: "**/*.md"})` — find all markdown references |
+| "review this PR" | `mcp_milens_review_pr({repo: "<workspaceRoot>"})` — risk assessment for changed files |
+| "is `X` risky to change" | `mcp_milens_review_symbol({name: "X", repo: "<workspaceRoot>"})` |
+| "write tests for `X`" | `mcp_milens_test_plan({name: "X", repo: "<workspaceRoot>"})` — deps, mocks, suggested tests |
+| "what needs tests" | `mcp_milens_test_coverage_gaps({repo: "<workspaceRoot>"})` — untested symbols by risk |
+| "which tests to run" | `mcp_milens_test_impact({repo: "<workspaceRoot>"})` — maps changes → test files |
+| "remember/note that `X`..." | `mcp_milens_annotate({symbol: "X", key: "note", value: "...", repo: "<workspaceRoot>"})` |
+| "what do we know about `X`" | `mcp_milens_recall({symbol: "X", repo: "<workspaceRoot>"})` |
+| "start new session" | `mcp_milens_session_start({agent: "...", repo: "<workspaceRoot>"})` |
+| "find code like `X`" | `mcp_milens_find_similar({name: "X", repo: "<workspaceRoot>"})` |
+| "search for `concept`" | `mcp_milens_semantic_search({query: "concept", repo: "<workspaceRoot>"})` |
+| "generate tests for `X`" | `mcp_milens_test_generate({symbol: "X", repo: "<workspaceRoot>"})` |
+| "fix security issue in `X`" | `mcp_milens_fix_apply({ruleId, file, line, repo: "<workspaceRoot>"})` |
+| "remove dead code" | `mcp_milens_find_dead_code()` then `dead_code_remove` prompt |
+| "orchestrate/check changes" | `mcp_milens_orchestrate({repo: "<workspaceRoot>"})` |
+| "compare impact of `X`" | `mcp_milens_compare_impact({name: "X", action: "snapshot"|"compare", repo: "<workspaceRoot>"})` |
+| "check pre-commit" | `mcp_milens_pre_commit_check({repo: "<workspaceRoot>"})` |
+| "save/restore context" | `mcp_milens_hook_preCompact()` / `mcp_milens_hook_postCompact()` |
+| "scan security / audit security" | `mcp_milens_security_scan({repo: "<workspaceRoot>"})` — full audit across all 50+ rules |
+| "end session" / "finish work" | `mcp_milens_session_end({session_id: "..."})` — record stats, trigger onSessionEnd hook |
+| "what did session X do" | `mcp_milens_session_context({session_id: "..."})` — get annotations + tool calls |
+| "file changed to X" | `mcp_milens_hook_onFileChange({files: ["path/to/file"], repo: "<workspaceRoot>"})` |
+
+## Documentation Workflows
+
+Milens indexes **Markdown files** (.md, .mdx) — headings become `section` symbols with parent-child hierarchy, and local links become cross-file references.
+
+### Researching or exploring documentation:
+1. `mcp_milens_get_file_symbols({file: "README.md", repo: "<workspaceRoot>"})` — see the full heading outline (TOC) of any doc
+2. `mcp_milens_query({query: "<topic>"})` — search section headings across all docs and code
+3. `mcp_milens_grep({pattern: "<keyword>", include: "**/*.md"})` — text search within docs only
+
+### Before updating documentation:
+1. `mcp_milens_get_file_symbols({file: "<doc.md>"})` — understand document structure first
+2. If documenting a code symbol: `mcp_milens_context({name: "<symbolName>"})` — get full symbol info (signature, callers, deps)
+3. `mcp_milens_grep({pattern: "<symbolName>", include: "**/*.md"})` — check if other docs already reference it
+
+### After renaming/deleting a code symbol:
+- `mcp_milens_grep({pattern: "<oldName>", include: "**/*.md"})` — find docs that need updating (milens indexes markdown links as cross-file references)
+
+## Never Do
+
+- NEVER edit a symbol without first running `mcp_milens_impact` on it.
+- NEVER delete or rename without running both `mcp_milens_grep` and `mcp_milens_impact`.
+- NEVER commit without running `mcp_milens_detect_changes()`.
+- NEVER call milens MCP tools without the `repo` parameter.
+- NEVER use `mcp_milens_query` for multi-word display text or UI labels — use `mcp_milens_grep`.
+
+---
+
+## Reference
+
+### Tools
+
+| Tool | Purpose |
+|---|---|
+| `mcp_milens_query` | Find symbol definitions by name (FTS5) |
+| `mcp_milens_grep` | Text search ALL files (templates, styles, configs, docs) |
+| `mcp_milens_context` | 360° view: incoming refs + outgoing deps |
+| `mcp_milens_impact` | Blast radius before editing |
+| `mcp_milens_detect_changes` | Pre-commit scope check |
+| `mcp_milens_explain_relationship` | Shortest path between two symbols |
+| `mcp_milens_get_file_symbols` | All symbols in a file |
+| `mcp_milens_get_type_hierarchy` | Class inheritance tree |
+| `mcp_milens_find_dead_code` | Unused exported symbols |
+| `mcp_milens_status` | Index stats for a repository: symbols, links, files, coverage %, staleness |
+| `mcp_milens_edit_check` | Pre-edit safety: callers + export status + re-export chains + test coverage |
+| `mcp_milens_trace` | Execution flow: call chains from entrypoints to a symbol |
+| `mcp_milens_routes` | Detect framework routes/endpoints (Express, FastAPI, NestJS, etc.) |
+| `mcp_milens_smart_context` | Intent-aware context: understand/edit/debug/test |
+| `mcp_milens_overview` | Combined context + impact + grep in ONE call. Preferred before editing/deleting/renaming a symbol. |
+| `mcp_milens_domains` | Domain clusters: groups of files forming logical modules |
+| `mcp_milens_repos` | List all indexed repositories with summary stats |
+| `mcp_milens_ast_explore` | Explore raw AST structure of a code file |
+| `mcp_milens_test_query` | Run a tree-sitter query against a code snippet and return matched nodes with capture names |
+| `mcp_milens_review_pr` | PR risk assessment: scores changed symbols by blast radius + test coverage |
+| `mcp_milens_review_symbol` | Single symbol risk: role, heat, dependents, test status |
+| `mcp_milens_test_plan` | Dependency-aware test plan: mocks, strategies, suggested tests |
+| `mcp_milens_test_coverage_gaps` | Untested exported symbols sorted by risk |
+| `mcp_milens_test_impact` | Which tests to run for current changes |
+| `mcp_milens_annotate` | Store observation/note about a symbol (persists across sessions) |
+| `mcp_milens_recall` | Retrieve annotations (filter by symbol, key, agent, session) |
+| `mcp_milens_session_start` | Register agent session for multi-agent coordination |
+| `mcp_milens_session_context` | Get session metadata + annotations |
+| `mcp_milens_handoff` | Transfer context between agent sessions |
+| `mcp_milens_codebase_summary` | High-level bootstrapping context: domains, key symbols, coverage |
+| `mcp_milens_semantic_search` | Hybrid FTS5 + vector search (requires --embeddings) |
+| `mcp_milens_find_similar` | Find symbols similar by embedding proximity |
+| `mcp_milens_compare_impact` | Compare impact graph before/after edit — detects regressions |
+| `mcp_milens_orchestrate` | Run full orchestration cycle: detect_changes → review_pr → impact → coverage gaps → dead code → action plan |
+| `mcp_milens_fix_apply` | Apply a security fix to a file (creates backup) |
+| `mcp_milens_test_generate` | Auto-generate test file: detects framework (vitest/jest/mocha/pytest) and writes complete test with mock strategy |
+| `mcp_milens_pre_commit_check` | Pre-commit risk scan: review_pr + dead code + coverage gaps |
+| `mcp_milens_hook_preCompact` | Save metrics snapshot before context compaction |
+| `mcp_milens_hook_postCompact` | Restore context by recalling annotations after compaction |
+| `mcp_milens_session_end` | End a session and record its stats. Use at the end of every session. |
+| `mcp_milens_hook_onFileChange` | Trigger the onFileChange hook. Call when files are modified to get impact summary. |
+| `mcp_milens_security_scan` | Scan codebase for security vulnerabilities using 50+ built-in rules. Replaces multiple manual grep() calls. |
+
+### Keeping the Index Fresh
+
+After significant code changes: `npx milens analyze -p . --force` (replace `.` with your project root if running from a different directory)
+
+### Skills
+
+| Task | Read this skill file |
+|------|---------------------|
+| General milens tools reference | `.agents/skills/milens/SKILL.md` |
+| Work in the Adapters area | `.agents/skills/adapters/SKILL.md` |
+| Work in the Root area | `.agents/skills/root/SKILL.md` |
+| Work in the Apps area | `.agents/skills/apps/SKILL.md` |
+| Work in the Docs area | `.agents/skills/docs/SKILL.md` |
+| Work in the Test area | `.agents/skills/test/SKILL.md` |
+| Work in the Scripts area | `.agents/skills/scripts/SKILL.md` |
+| Work in the Analyzer area | `.agents/skills/analyzer/SKILL.md` |
+| Work in the Orchestrator area | `.agents/skills/orchestrator/SKILL.md` |
+| Work in the Parser area | `.agents/skills/parser/SKILL.md` |
+| Work in the Security area | `.agents/skills/security/SKILL.md` |
+| Work in the Server area | `.agents/skills/server/SKILL.md` |
+| Work in the Store area | `.agents/skills/store/SKILL.md` |
+| Execute milens-plan workflow | `.agents/skills/milens-plan/SKILL.md` |
+| Execute milens-code-review workflow | `.agents/skills/milens-code-review/SKILL.md` |
+| Execute milens-tdd workflow | `.agents/skills/milens-tdd/SKILL.md` |
+| Execute milens-security-review workflow | `.agents/skills/milens-security-review/SKILL.md` |
+| Execute milens-refactor-clean workflow | `.agents/skills/milens-refactor-clean/SKILL.md` |
+| Execute milens-eval workflow | `.agents/skills/milens-eval/SKILL.md` |
+| Execute milens-architect workflow | `.agents/skills/milens-architect/SKILL.md` |
+| Execute milens-debugger workflow | `.agents/skills/milens-debugger/SKILL.md` |
+
+<!-- milens:end -->

package/.agents/skills/milens-architect/SKILL.md

@@ -0,0 +1,128 @@
+---
+name: milens-architect
+description: Architecture Analysis — domains, routes, coupling, class hierarchy, and refactoring suggestions with scorecard
+---
+
+# milens-architect — Architecture Analysis
+
+Analyze the architecture of the codebase: domain clusters, API routes, execution traces, class hierarchies, coupling hotspots, and produce a structured scorecard with refactoring suggestions.
+
+## Tools Required
+
+| Tool | Purpose |
+|---|---|
+| `mcp_milens_codebase_summary` | High-level project overview |
+| `mcp_milens_domains` | Module clusters with cohesion scores |
+| `mcp_milens_routes` | API endpoints inventory |
+| `mcp_milens_get_type_hierarchy` | Class/interface inheritance trees |
+| `mcp_milens_trace` | Execution flow from entrypoints |
+| `mcp_milens_explain_relationship` | Shortest path between two symbols |
+| `mcp_milens_find_dead_code` | Unused exported symbols |
+| `mcp_milens_review_symbol` | Deep-dive single symbol risk |
+| `mcp_milens_impact` | Blast radius analysis |
+
+> **CRITICAL:** All milens MCP tool calls MUST include the `repo` parameter set to the **absolute path of the workspace root**.
+
+## Workflow
+
+### Step 1: Codebase Overview
+
+Get a high-level picture of the codebase structure.
+
+```
+mcp_milens_codebase_summary({repo: "<workspaceRoot>"})
+```
+
+### Step 2: Domain Map
+
+Identify logical module groupings and cohesion.
+
+```
+mcp_milens_domains({repo: "<workspaceRoot>"})
+```
+
+For each domain with > 5 files, note: file count, symbol count, and description.
+
+### Step 3: Route Inventory
+
+Map all API endpoints to handler functions.
+
+```
+mcp_milens_routes({repo: "<workspaceRoot>"})
+```
+
+Document: HTTP method, path, handler symbol, and domain.
+
+### Step 4: Class Hierarchy
+
+For each key class/interface in the codebase, trace inheritance chains.
+
+```
+mcp_milens_get_type_hierarchy({name: "<BaseClass>", repo: "<workspaceRoot>"})
+```
+
+### Step 5: Execution Traces
+
+Trace critical execution paths from entrypoints.
+
+```
+mcp_milens_trace({name: "<entrypoint>", direction: "from", repo: "<workspaceRoot>"})
+```
+
+### Step 6: Coupling Analysis
+
+For the top 5 hub symbols, analyze inter-domain coupling:
+
+```
+mcp_milens_impact({target: "<hubSymbol>", depth: 3, repo: "<workspaceRoot>"})
+```
+
+```
+mcp_milens_explain_relationship({from: "<domain-a>", to: "<domain-b>", repo: "<workspaceRoot>"})
+```
+
+### Step 7: Dead Code Detection
+
+Find unused symbols that may indicate architectural drift.
+
+```
+mcp_milens_find_dead_code({limit: 30, repo: "<workspaceRoot>"})
+```
+
+### Step 8: Architecture Scorecard
+
+Produce a structured scorecard:
+
+| Dimension | Score (1-10) | Notes |
+|---|---|---|
+| Domain Cohesion | | |
+| Inter-domain Coupling | | |
+| Route Coverage | | |
+| Entry Point Clarity | | |
+| Inheritance Depth | | |
+| Dead Code Ratio | | |
+
+List top 3 refactoring suggestions with risk levels and effort estimates.
+
+## Quality Gate
+
+### PASS if:
+- [x] All domains documented with file/symbol counts
+- [x] All API routes mapped to handlers
+- [x] At least 5 class hierarchies traced
+- [x] At least 3 execution traces analyzed
+- [x] Coupling hotspots identified
+- [x] Architecture scorecard completed with scores
+- [x] Top 3 refactoring suggestions documented with risk levels
+
+### FAIL if:
+- [ ] Any step skipped without documented reason
+- [ ] Scorecard incomplete or scored without evidence
+- [ ] Refactoring suggestions lack risk assessment
+
+## Never Skip
+
+1. Always run `mcp_milens_codebase_summary` first — it provides the scaffolding for all other steps
+2. Never skip coupling analysis — it's the most critical architecture insight
+3. Always include risk levels and effort estimates in refactoring suggestions
+4. Cross-reference findings with `mcp_milens_review_symbol` for CRITICAL hubs