project-graph-mcp 1.3.0 → 1.5.0

package/AGENT_ROLE.md

@@ -5,27 +5,37 @@ You have access to **Project Graph MCP** — a suite of code analysis and projec
 ## 🧭 Navigation & Understanding
 | Tool | Purpose |
 |------|---------|
-| `get_structure` | Get file/folder tree |
-| `get_skeleton` | Get code structure (classes, functions, exports) |
+| `get_skeleton` | Get compact code structure (classes, functions, exports) |
 | `expand` | Deep dive into a class or function |
+| `get_focus_zone` | Get enriched context for recently modified files |
+| `get_call_chain` | Find shortest path between two symbols |
+| `usages` | Find all usages of a symbol across the project |
+| `deps` | Get dependency tree for a symbol |
 | `get_agent_instructions` | Get project coding guidelines |
 | `get_framework_reference` | Get framework AI reference (auto-detects or explicit) |
+| `get_usage_guide` | Get full usage guide with examples |
+| `invalidate_cache` | Refresh graph after code changes (MANDATORY after edits) |
 
 ## 🧪 Testing System
 
 | Tool | Purpose |
 |------|---------|
-| `get_pending_tests` | List @test/@expect annotations needing verification |
-| `mark_test_passed` / `mark_test_failed` | Track test results |
+| `get_pending_tests` | List `[ ]` checklists from `.ctx.md` files |
+| `mark_test_passed` / `mark_test_failed` | Write `[x]` or `[!]` directly to `.ctx.md` |
 | `get_test_summary` | Progress report |
+| `reset_test_state` | Reset all checklists to `[ ]` |
 
-### When to Write @test/@expect
-Add annotations to JSDoc when creating or modifying **interactive methods**:
-- `onclick` / `onchange` / `oninput` event handlers
-- Methods that change DOM state (show/hide, toggle classes/attributes)
-- Navigation and routing methods
-- Form submission and validation handlers
-- Any method with user-visible side effects
+### How Test Checklists Work
+Tests live in `.ctx.md` files (the "agent zone" of the two-tier documentation), not in source code:
+
+```markdown
+# parser.js
+
+## Tests
+- [ ] Parse valid JS file with classes and functions
+- [ ] Handle syntax errors gracefully
+- [x] Parse empty file without crash
+```
 
 ### Browser Testing Workflow (VERIFICATION mode)
 After code changes, you MUST verify UI with this flow:
@@ -37,20 +47,9 @@ After code changes, you MUST verify UI with this flow:
 4. get_test_summary(path)            → final report before completing task
 ```
 
-**Rule**: If `get_pending_tests()` returns items, they MUST be executed in the browser before the task is marked complete. Never skip browser verification when @test annotations exist.
-
-### Example
-```javascript
-/**
- * Delete selected persona
- *
- * @test click: Click delete button on persona card
- * @test click: Confirm in dialog
- * @expect element: Persona removed from list
- * @expect visual: Toast notification appears
- */
-async onDeletePersona() { ... }
-```
+**Rule**: If `get_pending_tests()` returns items, they MUST be executed before the task is marked complete.
+
+> **Note**: Test state is persistent (written to files) and survives agent session restarts.
 
 ## 🗄️ Database Analysis
 | Tool | Purpose |
@@ -71,16 +70,72 @@ The graph automatically detects SQL queries in your code:
 - Column-level dead code detection is best-effort.
 - ORM-specific patterns (Prisma, Sequelize, Knex query builder) are not yet supported.
 
+## 🧠 AI Context Layer
+| Tool | Purpose |
+|------|---------|
+| `get_ai_context` | **Boot**: skeleton + docs + compressed files in one call |
+| `get_compressed_file` | Terser-minified source with export legend |
+| `get_project_docs` | Doc Dialect documentation (auto + manual .context/) |
+| `generate_context_docs` | Generate .context/ templates from AST (batch concurrent) |
+| `check_stale_docs` | Detect outdated .ctx files by @sig hash |
+| `discover_sub_projects` | Find sub-projects in monorepo (packages/apps/services/...) |
+| `get_analysis_summary` | Quick health score — cached metrics only, skips cross-file |
+| `compact_project` | Compact all JS files — strips comments/whitespace (mangle:false) |
+| `beautify_project` | Beautify/expand all JS files — inverse of compact |
+
+### AI-First Workflow
+1. **Boot**: `get_ai_context(path)` — loads skeleton + docs (~1700 tokens vs ~60K original)
+2. **Drill**: `expand(symbol)` or `get_compressed_file(file)` — go deeper when needed
+3. **Enrich**: `generate_context_docs(path)` creates `.context/*.ctx` with `{DESCRIBE}` markers. Fill them with compact descriptions.
+
+### Doc Dialect Storage (Two-Tier)
+`.context/` mirrors your source tree with two files per source:
+```
+.context/                  ← auto-generated (mirror)
+├── project.ctx
+├── parser.ctx             ← Machine zone: AST signatures, @sig
+├── parser.ctx.md          ← Agent zone: notes, TODO, decisions
+└── utils/
+    └── helpers.ctx
+
+src/
+├── parser.js
+├── parser.ctx             ← colocated override (wins!)
+└── utils/
+    └── helpers.js
+```
+
+### Doc Dialect Format
+`.context/` files use a compact pipe-separated format:
+```
+--- parser.js ---
+export parseProject()→resolve,findJSFiles,readFileSync|scans dir, parses all files
+parseFileByExtension()→parseSQL,parsePython,parseGo|routes by extension
+PATTERNS: lang-*.js for non-JS|regex fallback for Python
+EDGE_CASES: Python uses regex, not AST|Go interfaces ≠ classes
+```
+
+### Enrichment Workflow
+| Step | How |
+|------|-----|
+| 1. Generate | `generate_context_docs` creates templates with `{DESCRIBE}` markers + `@sig` hash |
+| 2. Enrich | Delegate to agent-pool: `delegate_task({ skill: "doc-enricher" })` |
+| 3. Monitor | `check_stale_docs` detects when source changes invalidate docs |
+| 4. Update | Regenerate with `overwrite: true` — existing descriptions are preserved |
+
 ## 🔍 Code Quality Analysis
 | Tool | Purpose |
 |------|---------|
 | `get_full_analysis` | Run ALL checks + Health Score (0-100) |
+| `get_analysis_summary` | Quick health score (cached only, fast) |
 | `get_dead_code` | Find unused functions/classes |
 | `get_undocumented` | Find missing JSDoc |
 | `get_similar_functions` | Detect code duplicates |
 | `get_complexity` | Cyclomatic complexity metrics |
 | `get_large_files` | Files needing split |
 | `get_outdated_patterns` | Legacy patterns + redundant npm deps |
+| `check_jsdoc_consistency` | Validate JSDoc ↔ AST signatures |
+| `check_types` | Optional tsc type checking (requires TypeScript) |
 | `generate_jsdoc` | Auto-generate JSDoc templates |
 
 ## 🔧 Custom Rules (Configurable)
@@ -96,11 +151,11 @@ Rules are applied automatically based on:
 - Import patterns in source code
 - Code patterns (e.g., `extends Symbiote`)
 
-### Pre-built Rulesets (85 rules)
+### Pre-built Rulesets (86 rules)
 | Ruleset | Rules | Framework |
 |---------|-------|-----------|
 | `symbiote-2x` | 12 | Symbiote.js 2.x |
-| `symbiote-3x` | 17 | Symbiote.js 3.x |
+| `symbiote-3x` | 18 | Symbiote.js 3.x |
 | `react-18` | 6 | React 18 |
 | `react-19` | 5 | React 19 (Server Components) |
 | `vue-3` | 5 | Vue 3 Composition API |
@@ -109,7 +164,7 @@ Rules are applied automatically based on:
 | `fastify-5` | 5 | Fastify 5.x |
 | `nestjs-10` | 6 | NestJS 10.x |
 | `typescript-5` | 5 | TypeScript 5.x |
-| `node-22` | 7 | Node.js 22+ |
+| `node-22` | 13 | Node.js 22+ |
 
 ### Creating New Rules
 Read project workflow docs (e.g., `.agent/workflows/symbiote-audit.md`) and use `set_custom_rule`:
@@ -134,12 +189,14 @@ Read project workflow docs (e.g., `.agent/workflows/symbiote-audit.md`) and use
 |------|---------|
 | `get_filters` / `set_filters` | Configure excluded directories |
 | `add_excludes` / `remove_excludes` | Modify exclude list |
+| `reset_filters` | Reset to defaults |
 
 ## 🚀 Recommended Workflow
 
-1. **Start**: `get_structure` → understand project layout
-2. **Dive**: `get_skeleton` → map code architecture
+1. **Boot**: `get_ai_context` → understand entire project in ~1700 tokens
+2. **Dive**: `expand` / `get_compressed_file` → drill into specific files
 3. **Analyze**: `get_full_analysis` → find issues (Health Score)
 4. **Check Rules**: `check_custom_rules` → framework-specific violations
 5. **Fix**: Address issues by severity (error → warning → info)
 6. **Verify**: `get_pending_tests` → execute in browser → `mark_test_passed/failed` → `get_test_summary`
+7. **Document**: `generate_context_docs` → enrich .ctx files with PATTERNS and EDGE_CASES

package/AGENT_ROLE_MINIMAL.md

@@ -1,6 +1,6 @@
 # Project Graph MCP
 
-You have **Project Graph MCP** tools available — code analysis, project navigation, and framework-specific linting.
+You have **Project Graph MCP** tools available — 45 tools for code analysis, project navigation, monorepo scanning, and framework-specific linting.
 
 ## Quick Start
 
@@ -15,9 +15,11 @@ You have **Project Graph MCP** tools available — code analysis, project naviga
 - `expand(symbol)` — Deep dive into class/function (use symbols from skeleton's `L` field)
 - `deps(symbol)` — Dependency tree (imports, usedBy, calls)
 - `usages(symbol)` — Find all usages across project
+- `invalidate_cache` — Refresh graph after code changes
 
 ### Code Quality
 - `get_full_analysis` — Run ALL checks + Health Score
+- `get_analysis_summary` — Quick health score (cached only, fast)
 - `get_dead_code` — Unused functions/classes  
 - `get_undocumented` — Missing JSDoc
 - `get_similar_functions` — Code duplicates
@@ -25,10 +27,21 @@ You have **Project Graph MCP** tools available — code analysis, project naviga
 - `get_large_files` — Files needing split
 - `get_outdated_patterns` — Legacy patterns
 
+### AI Context
+- `get_ai_context` — **Boot**: skeleton + docs + compressed files (~97% savings)
+- `get_compressed_file` — Terser-minified source with export legend
+- `get_project_docs` — Doc Dialect documentation (.context/)
+- `generate_context_docs` — Generate .context/ templates with `@sig` staleness hashes
+- `check_stale_docs` — Check which .ctx files need updating
+- `discover_sub_projects` — Find sub-projects in monorepo
+- `compact_project` — Compact all JS files (strips comments/whitespace, preserves names)
+- `beautify_project` — Beautify/expand all JS files (inverse of compact)
+
 ### Testing
-- `get_pending_tests` — List @test/@expect annotations
-- `mark_test_passed(testId)` / `mark_test_failed(testId, reason)`
+- `get_pending_tests` — List `[ ]` checklists from `.ctx.md` files
+- `mark_test_passed(testId)` / `mark_test_failed(testId, reason)` — writes to `.ctx.md`
 - `get_test_summary` — Progress report
+- `reset_test_state` — Reset all checklists to `[ ]`
 
 ### Custom Rules
 - `check_custom_rules(path)` — Run framework-specific analysis (auto-detected)
@@ -40,11 +53,13 @@ You have **Project Graph MCP** tools available — code analysis, project naviga
 ## Workflow
 
 ```
-1. get_skeleton("src/")        → Understand structure
-2. get_full_analysis("src/")   → Find issues (Health Score)
-3. check_custom_rules("src/")  → Framework violations
-4. Fix by severity: error → warning → info
-5. get_pending_tests("src/")   → Verification checklist
+1. get_ai_context("src/")       → Boot: ~1700 tokens for entire project
+2. expand(symbol)               → Drill into specific class/function
+3. get_full_analysis("src/")    → Find issues (Health Score)
+4. check_custom_rules("src/")   → Framework violations
+5. Fix by severity: error → warning → info
+6. get_pending_tests("src/")    → Verification checklist
+7. generate_context_docs("src/")→ Enrich .ctx files
 ```
 
 ## Tips

package/README.md

@@ -5,10 +5,10 @@
 
 # project-graph-mcp
 
-An MCP server that parses your source code into a **10-50x compressed skeleton** — classes, functions, imports, and dependencies in a minified JSON. Agents navigate the graph using `expand`, `deps`, and `usages` without reading irrelevant files.
+An MCP server that parses your source code into a **10-50x compressed skeleton** — classes, functions, imports, and dependencies in a minified JSON. Agents navigate the graph using `expand`, `deps`, and `usages` without reading irrelevant files. The **AI Context Layer** compresses an entire codebase into ~1700 tokens (97% savings) with a single `get_ai_context` call. Supports **monorepo scanning** and **streaming analysis** for large codebases.
 
 > [!TIP]
-> **132 kB, 47 files, zero external dependencies.** Add one line to your MCP config and the server downloads itself on the next IDE restart.
+> **132 kB, 47 files, zero external dependencies.** 49 MCP tools. Add one line to your MCP config and the server downloads itself on the next IDE restart.
 
 ### Project Skeleton (10-50x compression)
 
@@ -44,27 +44,107 @@ stripStringsAndComments(code, { backtick: true, templateInterpolation: false })
 - **Duplicate detection** — finds functionally similar functions by signature + structure similarity
 - **Large file analysis** — candidates for splitting by lines, functions, and exports count
 - **Legacy pattern finder** — outdated code patterns and redundant npm deps (built into Node.js 18+)
-- **Health Score (0-100)** — aggregated result from all checks in one call
+- **JSDoc consistency** — validates `@param` count/names and `@returns` against AST signatures
+- **Type checking** — optional `tsc --checkJs` wrapper with graceful fallback
+- **Health Score (0-100)** — aggregated result from all checks in one call (`get_full_analysis` or quick `get_analysis_summary`)
+- **Incremental cache** — per-file analysis results cached in `.context/.cache/` with content hashing
 
-### Test Checklists
+### AI Context Layer
+
+One call loads everything an agent needs to understand a project:
+
+```javascript
+get_ai_context({ path: "src/" })
+// → { skeleton, docs, totalTokens: 1742, savings: "97%" }
+```
+
+- **Code compression** — Terser-minified source with export legend headers (20-55% per file)
+- **Compact Code Mode** — project-wide `compact`/`beautify` (preserves all names, strips comments/whitespace)
+- **Doc Dialect** — compact `.context/` documentation format, auto-generated from AST with `{DESCRIBE}` markers
+- **Two-tier `.ctx`** — `.ctx` (machine-generated, AST signatures) + `.ctx.md` (agent notes, TODO, decisions)
+- **Self-enriching** — `@enrich` instructions embedded in `.ctx` files guide any AI agent to fill descriptions
+- **Staleness detection** — `@sig` hashes track structural changes; `check_stale_docs` identifies outdated docs
+- **Merge strategy** — regenerating `.ctx` files preserves existing descriptions
+- **Boot aggregator** — `get_ai_context` combines skeleton + docs + compressed files in one response
+
+```
+# Generate .context/ documentation templates
+npx project-graph-mcp generate-ctx src/
 
-JSDoc annotations (`@test` and `@expect`) define test checklists directly in the code:
+# View project docs in compact format
+npx project-graph-mcp docs src/
+
+# Compress a single file for AI
+npx project-graph-mcp compress src/parser.js
+```
+
+### Compact Code Architecture
+
+Three modes for AI-native codebase editing — configure per project via `.context/config.json`:
+
+| Mode | Storage | Agent reads | Agent edits |
+|------|---------|-------------|-------------|
+| **1 — Native Compact** | Minified JS | Files directly | Files directly |
+| **2 — Full Storage** (default) | Formatted JS | `get_compressed_file` | `edit_compressed` |
+| **3 — IDE Virtual** | Minified JS | IDE renders full view | IDE handles mapping |
+
+**Mode 2 workflow** (recommended):
 
 ```javascript
-/**
- * Create new user via API
- *
- * @test request: POST /api/users with valid data
- * @expect status: 201 Created
- */
-async createUser(data) { ... }
+// 1. Read compressed view (saves 20-55% tokens)
+get_compressed_file({ path: "src/parser.js" })
+
+// 2. Edit by symbol name — server finds it via AST
+edit_compressed({
+  path: "src/parser.js",
+  symbol: "parseFile",
+  code: "export async function parseFile(code, filename) { /* new body */ }"
+})
+
+// 3. Validate .ctx contracts after editing
+validate_ctx_contracts({ path: "." })
 ```
 
-The agent calls `get_pending_tests`, runs the test, then `mark_test_passed`. Supports browser, API, CLI, and integration test types.
+**`.ctx` typed signatures** — JSDoc types extracted into compact format:
+
+```
+parseFile(code:string,filename:string)→Promise<ParseResult>→parse,walk|parse JS file into AST
+```
+
+```bash
+# Set project mode
+npx project-graph-mcp set-mode . 2
+
+# Validate .ctx documentation matches source
+npx project-graph-mcp validate-ctx . --strict
+```
+
+### Test Checklists
+
+Test checklists live in `.ctx.md` files (alongside documentation), not in source code:
+
+```markdown
+## Tests
+- [ ] POST /api/users with valid data → 201 Created
+- [ ] GET /api/users/:id returns user object
+- [x] DELETE /api/users/:id → 204 No Content
+```
+
+The agent calls `get_pending_tests`, runs the test, then `mark_test_passed` (which writes `[x]` directly to the `.ctx.md` file). Test state is persistent and survives session restarts.
+
+### Monorepo Support
+
+`discover_sub_projects` scans standard monorepo directories (`packages/`, `apps/`, `services/`, `modules/`, `libs/`, `plugins/`) for sub-projects with `package.json`. Combined with `parseProject({ recursive: true })`, agents can analyze entire monorepos.
+
+### Performance
+
+- **Batch concurrency** — `generate_context_docs` processes 5 files in parallel
+- **Quick health check** — `get_analysis_summary` runs only cached per-file metrics (skips expensive cross-file analysis)
+- **Streaming analysis** — `getFullAnalysisStreaming` yields results incrementally as each sub-analysis completes
 
 ### Custom Rules & Framework References
 
-10 pre-built rulesets (62 rules) for React 18/19, Vue 3, Next.js 15, Express 5, Fastify 5, NestJS 10, TypeScript 5, Node.js 22, and [Symbiote.js](https://github.com/symbiotejs/symbiote.js). The server auto-detects your project type and returns adapted documentation via `get_framework_reference`.
+11 pre-built rulesets (86 rules) for React 18/19, Vue 3, Next.js 15, Express 5, Fastify 5, NestJS 10, TypeScript 5, Node.js 22, and [Symbiote.js](https://github.com/symbiotejs/symbiote.js). The server auto-detects your project type and returns adapted documentation via `get_framework_reference`.
 
 Custom project conventions can be added in the `rules/` directory or configured by the agent via `set_custom_rule`.
 
@@ -130,6 +210,12 @@ npx project-graph-mcp deadcode src/       # Find unused code
 npx project-graph-mcp complexity src/     # Cyclomatic complexity
 npx project-graph-mcp similar src/        # Find duplicates
 npx project-graph-mcp pending src/        # List pending tests
+npx project-graph-mcp compress src/f.js   # Compress file for AI
+npx project-graph-mcp docs src/           # Project docs (doc-dialect)
+npx project-graph-mcp generate-ctx src/   # Generate .context/ docs
+npx project-graph-mcp validate-ctx .      # Validate .ctx ↔ source
+npx project-graph-mcp mode .             # Show current editing mode
+npx project-graph-mcp set-mode . 2       # Set mode (1/2/3)
 npx project-graph-mcp help                # All commands
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-graph-mcp",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "type": "module",
   "description": "MCP server for AI agents — multi-language project graph (JS, TS, Python, Go), code quality analysis, and framework-specific lint rules. Zero dependencies.",
   "main": "src/server.js",

package/src/.project-graph-cache.json

@@ -0,0 +1 @@
+{"version":1,"path":"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src","mtimes":{"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/ai-context.js":1775705820005.593,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/analysis-cache.js":1775705820005.9824,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/cli-handlers.js":1775742844572.4338,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/cli.js":1775742927037.4722,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/compact.js":1775705820007.682,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/complexity.js":1775705820008.1265,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/compress.js":1775708193583.2522,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/ctx-to-jsdoc.js":1775742405151.9907,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/custom-rules.js":1775705820009.4775,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/db-analysis.js":1775705820010.2769,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/dead-code.js":1775705820010.873,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/doc-dialect.js":1775707208614.9092,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/filters.js":1775705820011.479,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/framework-references.js":1775705820011.642,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/full-analysis.js":1775705820012.3645,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/graph-builder.js":1775705820012.8542,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/instructions.js":1775705820013.5242,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/jsdoc-checker.js":1775705820013.9524,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/jsdoc-generator.js":1775705820014.3755,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/lang-go.js":1775705820014.5596,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/lang-python.js":1775705820014.7178,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/lang-sql.js":1775705820015.08,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/lang-typescript.js":1775705820015.259,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/lang-utils.js":1775705820015.4016,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/large-files.js":1775705820015.7256,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/mcp-server.js":1775742958113.3992,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/mode-config.js":1775708353549.937,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/outdated-patterns.js":1775705820016.414,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/parser.js":1775707186671.276,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/server.js":1775705820017.2703,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/similar-functions.js":1775705820017.9243,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/test-annotations.js":1775705820018.533,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/tool-defs.js":1775708400999.8848,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/tools.js":1775705820019.4646,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/type-checker.js":1775705820019.783,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/undocumented.js":1775705820020.2156,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/workspace.js":1775705820020.5132},"graph":{"v":1,"legend":{"estimateTokens":"eT","getAiContext":"AC","computeSig":"cS","computeContentHash":"CH","getCachePath":"CP","readCache":"rC","writeCache":"wC","isCacheValid":"CV","invalidateAllCaches":"AC1","getArg":"gA","getPath":"gP","printHelp":"pH","runCLI":"CLI","walkJSFiles":"JSF","compactFile":"cF","beautifyFile":"bF","compactProject":"cP","expandProject":"eP","findJSFiles":"JSF1","calculateComplexity":"cC","getRating":"gR","analyzeComplexityFile":"CF","analyzeFile":"aF","getComplexity":"gC","extractLegend":"eL","compressFile":"cF1","editCompressed":"eC","findSymbolRange":"SR","parseCtxFile":"CF1","buildJSDocBlock":"JSD","findCtxFile":"CF2","findExportStart":"ES","injectJSDoc":"JSD1","stripJSDoc":"JSD2","splitTopLevelParams":"TLP","validateCtxContracts":"CC","parseGraphignore":"pG","isGraphignored":"iG","loadRuleSets":"RS","saveRuleSet":"RS1","findFiles":"fF","isExcluded":"iE","isInStringOrComment":"ISO","isWithinContext":"WC","checkFileAgainstRule":"FAR","getCustomRules":"CR","setCustomRule":"CR1","deleteCustomRule":"CR2","detectProjectRuleSets":"PRS","checkCustomRules":"CR3","getDBSchema":"DBS","getTableUsage":"TU","getDBDeadTables":"DBD","collectReferencedColumns":"RC","findProjectRoot":"PR","analyzeFileLocals":"FL","getDeadCode":"DC","generateDocDialect":"DD","walkCtxFiles":"CF3","resolveCtxPath":"CP1","resolveCtxMdPath":"CMP","readContextDocs":"CD","getProjectDocs":"PD","computeSignature":"cS1","parseCtxDescriptions":"CD1","checkStaleness":"cS2","buildFileTemplate":"FT","generateContextFiles":"CF4","processFileCtx":"FC","getFilters":"gF","setFilters":"sF","addExcludes":"aE","removeExcludes":"rE","resetFilters":"rF","parseGitignore":"pG1","shouldExcludeDir":"ED","shouldExcludeFile":"EF","matchWildcard":"mW","matchGitignorePattern":"GP","fetchReference":"fR","listAvailable":"lA","getFrameworkReference":"FR","calculateHealthScore":"HS","runCacheableAnalyses":"CA","aggregateComplexity":"aC","aggregateUndocumented":"aU","aggregateJSDoc":"JSD3","getFullAnalysis":"FA","getAnalysisSummaryOnly":"ASO","getFullAnalysisStreaming":"FAS","minifyLegend":"mL","createShortName":"SN","buildGraph":"bG","createSkeleton":"cS3","getInstructions":"gI","extractJSDocComments":"JSD4","findJSDocBefore":"JSD5","extractParamName":"PN","inferTypeFromDefault":"TFD","hasReturnValue":"RV","validateFunction":"vF","checkJSDocFile":"JSD6","checkJSDocConsistency":"JSD7","generateJSDoc":"JSD8","buildJSDoc":"JSD9","inferParamType":"PT","generateJSDocFor":"JSD10","parseGo":"pG2","extractImports":"eI","getBody":"gB","extractCalls":"eC1","parsePython":"pP","isSQLString":"SQL","isValidTableName":"VTN","extractSQLFromString":"SQL1","parseSQL":"SQL2","parseColumns":"pC","splitByTopLevelComma":"BTL","extractSQLFromCode":"SQL3","parseTypeScript":"TS","extractParams":"eP1","stripStringsAndComments":"SAC","getLargeFiles":"LF","createServer":"cS4","startStdioServer":"SS","getConfig":"gC1","setConfig":"sC","getModeDescription":"MD","getModeWorkflow":"MW","analyzeFilePatterns":"FP","analyzePackageJson":"PJ","getOutdatedPatterns":"OP","parseFile":"pF","extractCallsAndSQL":"CAS","getTagName":"TN","getCallMethodName":"CMN","extractStringValue":"SV","templateToString":"TS1","discoverSubProjects":"SP","parseProject":"pP1","parseFileByExtension":"FBE","isSourceFile":"SF","buildJSDocTypeMap":"JSD11","findJSDocForNode":"JSD12","enrichParamsWithTypes":"PWT","extractSignatures":"eS","buildSignature":"bS","hashBodyStructure":"BS","calculateSimilarity":"cS5","getSimilarFunctions":"SF1","findCtxMdFiles":"CMF","parseAnnotations":"pA","groupByName":"BN","getAllFeatures":"AF","getPendingTests":"PT1","markTestPassed":"TP","markTestFailed":"TF","updateTestState":"TS2","getTestSummary":"TS3","resetTestState":"TS4","saveDiskCache":"DC1","loadDiskCache":"DC2","getGraph":"gG","detectChanges":"dC","snapshotMtimes":"sM","getSkeleton":"gS","getFocusZone":"FZ","expand":"ex","deps":"de","usages":"us","extractMethod":"eM","getCallChain":"CC1","invalidateCache":"iC","detectTsc":"dT","parseDiagnosticLine":"DL","buildArgs":"bA","checkTypes":"cT","extractComments":"eC2","checkMissing":"cM","checkUndocumentedFile":"UF","getUndocumented":"gU","getUndocumentedSummary":"US","setRoots":"sR","getWorkspaceRoot":"WR","resolvePath":"rP"},"reverseLegend":{"eT":"estimateTokens","AC":"getAiContext","cS":"computeSig","CH":"computeContentHash","CP":"getCachePath","rC":"readCache","wC":"writeCache","CV":"isCacheValid","AC1":"invalidateAllCaches","gA":"getArg","gP":"getPath","pH":"printHelp","CLI":"runCLI","JSF":"walkJSFiles","cF":"compactFile","bF":"beautifyFile","cP":"compactProject","eP":"expandProject","JSF1":"findJSFiles","cC":"calculateComplexity","gR":"getRating","CF":"analyzeComplexityFile","aF":"analyzeFile","gC":"getComplexity","eL":"extractLegend","cF1":"compressFile","eC":"editCompressed","SR":"findSymbolRange","CF1":"parseCtxFile","JSD":"buildJSDocBlock","CF2":"findCtxFile","ES":"findExportStart","JSD1":"injectJSDoc","JSD2":"stripJSDoc","TLP":"splitTopLevelParams","CC":"validateCtxContracts","pG":"parseGraphignore","iG":"isGraphignored","RS":"loadRuleSets","RS1":"saveRuleSet","fF":"findFiles","iE":"isExcluded","ISO":"isInStringOrComment","WC":"isWithinContext","FAR":"checkFileAgainstRule","CR":"getCustomRules","CR1":"setCustomRule","CR2":"deleteCustomRule","PRS":"detectProjectRuleSets","CR3":"checkCustomRules","DBS":"getDBSchema","TU":"getTableUsage","DBD":"getDBDeadTables","RC":"collectReferencedColumns","PR":"findProjectRoot","FL":"analyzeFileLocals","DC":"getDeadCode","DD":"generateDocDialect","CF3":"walkCtxFiles","CP1":"resolveCtxPath","CMP":"resolveCtxMdPath","CD":"readContextDocs","PD":"getProjectDocs","cS1":"computeSignature","CD1":"parseCtxDescriptions","cS2":"checkStaleness","FT":"buildFileTemplate","CF4":"generateContextFiles","FC":"processFileCtx","gF":"getFilters","sF":"setFilters","aE":"addExcludes","rE":"removeExcludes","rF":"resetFilters","pG1":"parseGitignore","ED":"shouldExcludeDir","EF":"shouldExcludeFile","mW":"matchWildcard","GP":"matchGitignorePattern","fR":"fetchReference","lA":"listAvailable","FR":"getFrameworkReference","HS":"calculateHealthScore","CA":"runCacheableAnalyses","aC":"aggregateComplexity","aU":"aggregateUndocumented","JSD3":"aggregateJSDoc","FA":"getFullAnalysis","ASO":"getAnalysisSummaryOnly","FAS":"getFullAnalysisStreaming","mL":"minifyLegend","SN":"createShortName","bG":"buildGraph","cS3":"createSkeleton","gI":"getInstructions","JSD4":"extractJSDocComments","JSD5":"findJSDocBefore","PN":"extractParamName","TFD":"inferTypeFromDefault","RV":"hasReturnValue","vF":"validateFunction","JSD6":"checkJSDocFile","JSD7":"checkJSDocConsistency","JSD8":"generateJSDoc","JSD9":"buildJSDoc","PT":"inferParamType","JSD10":"generateJSDocFor","pG2":"parseGo","eI":"extractImports","gB":"getBody","eC1":"extractCalls","pP":"parsePython","SQL":"isSQLString","VTN":"isValidTableName","SQL1":"extractSQLFromString","SQL2":"parseSQL","pC":"parseColumns","BTL":"splitByTopLevelComma","SQL3":"extractSQLFromCode","TS":"parseTypeScript","eP1":"extractParams","SAC":"stripStringsAndComments","LF":"getLargeFiles","cS4":"createServer","SS":"startStdioServer","gC1":"getConfig","sC":"setConfig","MD":"getModeDescription","MW":"getModeWorkflow","FP":"analyzeFilePatterns","PJ":"analyzePackageJson","OP":"getOutdatedPatterns","pF":"parseFile","CAS":"extractCallsAndSQL","TN":"getTagName","CMN":"getCallMethodName","SV":"extractStringValue","TS1":"templateToString","SP":"discoverSubProjects","pP1":"parseProject","FBE":"parseFileByExtension","SF":"isSourceFile","JSD11":"buildJSDocTypeMap","JSD12":"findJSDocForNode","PWT":"enrichParamsWithTypes","eS":"extractSignatures","bS":"buildSignature","BS":"hashBodyStructure","cS5":"calculateSimilarity","SF1":"getSimilarFunctions","CMF":"findCtxMdFiles","pA":"parseAnnotations","BN":"groupByName","AF":"getAllFeatures","PT1":"getPendingTests","TP":"markTestPassed","TF":"markTestFailed","TS2":"updateTestState","TS3":"getTestSummary","TS4":"resetTestState","DC1":"saveDiskCache","DC2":"loadDiskCache","gG":"getGraph","dC":"detectChanges","sM":"snapshotMtimes","gS":"getSkeleton","FZ":"getFocusZone","ex":"expand","de":"deps","us":"usages","eM":"extractMethod","CC1":"getCallChain","iC":"invalidateCache","dT":"detectTsc","DL":"parseDiagnosticLine","bA":"buildArgs","cT":"checkTypes","eC2":"extractComments","cM":"checkMissing","UF":"checkUndocumentedFile","gU":"getUndocumented","US":"getUndocumentedSummary","sR":"setRoots","WR":"getWorkspaceRoot","rP":"resolvePath"},"stats":{"files":37,"classes":0,"functions":200,"tables":0},"nodes":{"eT":{"t":"F","e":false,"f":"compress.js"},"AC":{"t":"F","e":true,"f":"ai-context.js"},"cS":{"t":"F","e":true,"f":"analysis-cache.js"},"CH":{"t":"F","e":true,"f":"analysis-cache.js"},"CP":{"t":"F","e":true,"f":"analysis-cache.js"},"rC":{"t":"F","e":true,"f":"analysis-cache.js"},"wC":{"t":"F","e":true,"f":"analysis-cache.js"},"CV":{"t":"F","e":true,"f":"analysis-cache.js"},"AC1":{"t":"F","e":true,"f":"analysis-cache.js"},"gA":{"t":"F","e":false,"f":"cli-handlers.js"},"gP":{"t":"F","e":false,"f":"cli-handlers.js"},"pH":{"t":"F","e":true,"f":"cli.js"},"CLI":{"t":"F","e":true,"f":"cli.js"},"JSF":{"t":"F","e":false,"f":"ctx-to-jsdoc.js"},"cF":{"t":"F","e":false,"f":"compact.js"},"bF":{"t":"F","e":false,"f":"compact.js"},"cP":{"t":"F","e":true,"f":"compact.js"},"eP":{"t":"F","e":true,"f":"compact.js"},"JSF1":{"t":"F","e":false,"f":"undocumented.js"},"cC":{"t":"F","e":false,"f":"complexity.js"},"gR":{"t":"F","e":false,"f":"complexity.js"},"CF":{"t":"F","e":true,"f":"complexity.js"},"aF":{"t":"F","e":false,"f":"large-files.js"},"gC":{"t":"F","e":true,"f":"complexity.js"},"eL":{"t":"F","e":false,"f":"compress.js"},"cF1":{"t":"F","e":true,"f":"compress.js"},"eC":{"t":"F","e":true,"f":"compress.js"},"SR":{"t":"F","e":false,"f":"compress.js"},"CF1":{"t":"F","e":true,"f":"ctx-to-jsdoc.js"},"JSD":{"t":"F","e":false,"f":"ctx-to-jsdoc.js"},"CF2":{"t":"F","e":false,"f":"ctx-to-jsdoc.js"},"ES":{"t":"F","e":false,"f":"ctx-to-jsdoc.js"},"JSD1":{"t":"F","e":true,"f":"ctx-to-jsdoc.js"},"JSD2":{"t":"F","e":true,"f":"ctx-to-jsdoc.js"},"TLP":{"t":"F","e":false,"f":"ctx-to-jsdoc.js"},"CC":{"t":"F","e":true,"f":"ctx-to-jsdoc.js"},"pG":{"t":"F","e":false,"f":"custom-rules.js"},"iG":{"t":"F","e":false,"f":"custom-rules.js"},"RS":{"t":"F","e":false,"f":"custom-rules.js"},"RS1":{"t":"F","e":false,"f":"custom-rules.js"},"fF":{"t":"F","e":false,"f":"custom-rules.js"},"iE":{"t":"F","e":false,"f":"custom-rules.js"},"ISO":{"t":"F","e":false,"f":"custom-rules.js"},"WC":{"t":"F","e":false,"f":"custom-rules.js"},"FAR":{"t":"F","e":false,"f":"custom-rules.js"},"CR":{"t":"F","e":true,"f":"custom-rules.js"},"CR1":{"t":"F","e":true,"f":"custom-rules.js"},"CR2":{"t":"F","e":true,"f":"custom-rules.js"},"PRS":{"t":"F","e":true,"f":"custom-rules.js"},"CR3":{"t":"F","e":true,"f":"custom-rules.js"},"DBS":{"t":"F","e":true,"f":"db-analysis.js"},"TU":{"t":"F","e":true,"f":"db-analysis.js"},"DBD":{"t":"F","e":true,"f":"db-analysis.js"},"RC":{"t":"F","e":false,"f":"db-analysis.js"},"PR":{"t":"F","e":false,"f":"dead-code.js"},"FL":{"t":"F","e":false,"f":"dead-code.js"},"DC":{"t":"F","e":true,"f":"dead-code.js"},"DD":{"t":"F","e":true,"f":"doc-dialect.js"},"CF3":{"t":"F","e":false,"f":"doc-dialect.js"},"CP1":{"t":"F","e":false,"f":"doc-dialect.js"},"CMP":{"t":"F","e":false,"f":"doc-dialect.js"},"CD":{"t":"F","e":true,"f":"doc-dialect.js"},"PD":{"t":"F","e":true,"f":"doc-dialect.js"},"cS1":{"t":"F","e":false,"f":"doc-dialect.js"},"CD1":{"t":"F","e":false,"f":"doc-dialect.js"},"cS2":{"t":"F","e":true,"f":"doc-dialect.js"},"FT":{"t":"F","e":false,"f":"doc-dialect.js"},"CF4":{"t":"F","e":true,"f":"doc-dialect.js"},"FC":{"t":"F","e":false,"f":"doc-dialect.js"},"gF":{"t":"F","e":true,"f":"filters.js"},"sF":{"t":"F","e":true,"f":"filters.js"},"aE":{"t":"F","e":true,"f":"filters.js"},"rE":{"t":"F","e":true,"f":"filters.js"},"rF":{"t":"F","e":true,"f":"filters.js"},"pG1":{"t":"F","e":true,"f":"filters.js"},"ED":{"t":"F","e":true,"f":"filters.js"},"EF":{"t":"F","e":true,"f":"filters.js"},"mW":{"t":"F","e":false,"f":"filters.js"},"GP":{"t":"F","e":false,"f":"filters.js"},"fR":{"t":"F","e":false,"f":"framework-references.js"},"lA":{"t":"F","e":false,"f":"framework-references.js"},"FR":{"t":"F","e":true,"f":"framework-references.js"},"HS":{"t":"F","e":false,"f":"full-analysis.js"},"CA":{"t":"F","e":false,"f":"full-analysis.js"},"aC":{"t":"F","e":false,"f":"full-analysis.js"},"aU":{"t":"F","e":false,"f":"full-analysis.js"},"JSD3":{"t":"F","e":false,"f":"full-analysis.js"},"FA":{"t":"F","e":true,"f":"full-analysis.js"},"ASO":{"t":"F","e":true,"f":"full-analysis.js"},"FAS":{"t":"F","e":true,"f":"full-analysis.js"},"mL":{"t":"F","e":true,"f":"graph-builder.js"},"SN":{"t":"F","e":false,"f":"graph-builder.js"},"bG":{"t":"F","e":true,"f":"graph-builder.js"},"cS3":{"t":"F","e":true,"f":"graph-builder.js"},"gI":{"t":"F","e":true,"f":"instructions.js"},"JSD4":{"t":"F","e":false,"f":"jsdoc-checker.js"},"JSD5":{"t":"F","e":false,"f":"undocumented.js"},"PN":{"t":"F","e":false,"f":"similar-functions.js"},"TFD":{"t":"F","e":false,"f":"jsdoc-checker.js"},"RV":{"t":"F","e":false,"f":"jsdoc-checker.js"},"vF":{"t":"F","e":false,"f":"jsdoc-checker.js"},"JSD6":{"t":"F","e":true,"f":"jsdoc-checker.js"},"JSD7":{"t":"F","e":true,"f":"jsdoc-checker.js"},"JSD8":{"t":"F","e":true,"f":"jsdoc-generator.js"},"JSD9":{"t":"F","e":false,"f":"jsdoc-generator.js"},"PT":{"t":"F","e":false,"f":"jsdoc-generator.js"},"JSD10":{"t":"F","e":true,"f":"jsdoc-generator.js"},"pG2":{"t":"F","e":true,"f":"lang-go.js"},"eI":{"t":"F","e":false,"f":"lang-go.js"},"gB":{"t":"F","e":false,"f":"lang-go.js"},"eC1":{"t":"F","e":false,"f":"lang-go.js"},"pP":{"t":"F","e":true,"f":"lang-python.js"},"SQL":{"t":"F","e":true,"f":"lang-sql.js"},"VTN":{"t":"F","e":false,"f":"lang-sql.js"},"SQL1":{"t":"F","e":true,"f":"lang-sql.js"},"SQL2":{"t":"F","e":true,"f":"lang-sql.js"},"pC":{"t":"F","e":false,"f":"lang-sql.js"},"BTL":{"t":"F","e":false,"f":"lang-sql.js"},"SQL3":{"t":"F","e":true,"f":"lang-sql.js"},"TS":{"t":"F","e":true,"f":"lang-typescript.js"},"eP1":{"t":"F","e":false,"f":"lang-typescript.js"},"SAC":{"t":"F","e":true,"f":"lang-utils.js"},"LF":{"t":"F","e":true,"f":"large-files.js"},"cS4":{"t":"F","e":true,"f":"mcp-server.js"},"SS":{"t":"F","e":true,"f":"mcp-server.js"},"gC1":{"t":"F","e":true,"f":"mode-config.js"},"sC":{"t":"F","e":true,"f":"mode-config.js"},"MD":{"t":"F","e":true,"f":"mode-config.js"},"MW":{"t":"F","e":true,"f":"mode-config.js"},"FP":{"t":"F","e":false,"f":"outdated-patterns.js"},"PJ":{"t":"F","e":false,"f":"outdated-patterns.js"},"OP":{"t":"F","e":true,"f":"outdated-patterns.js"},"pF":{"t":"F","e":true,"f":"parser.js"},"CAS":{"t":"F","e":false,"f":"parser.js"},"TN":{"t":"F","e":false,"f":"parser.js"},"CMN":{"t":"F","e":false,"f":"parser.js"},"SV":{"t":"F","e":false,"f":"parser.js"},"TS1":{"t":"F","e":false,"f":"parser.js"},"SP":{"t":"F","e":true,"f":"parser.js"},"pP1":{"t":"F","e":true,"f":"parser.js"},"FBE":{"t":"F","e":false,"f":"parser.js"},"SF":{"t":"F","e":false,"f":"parser.js"},"JSD11":{"t":"F","e":false,"f":"parser.js"},"JSD12":{"t":"F","e":false,"f":"parser.js"},"PWT":{"t":"F","e":false,"f":"parser.js"},"eS":{"t":"F","e":false,"f":"similar-functions.js"},"bS":{"t":"F","e":false,"f":"similar-functions.js"},"BS":{"t":"F","e":false,"f":"similar-functions.js"},"cS5":{"t":"F","e":false,"f":"similar-functions.js"},"SF1":{"t":"F","e":true,"f":"similar-functions.js"},"CMF":{"t":"F","e":false,"f":"test-annotations.js"},"pA":{"t":"F","e":true,"f":"test-annotations.js"},"BN":{"t":"F","e":false,"f":"test-annotations.js"},"AF":{"t":"F","e":true,"f":"test-annotations.js"},"PT1":{"t":"F","e":true,"f":"test-annotations.js"},"TP":{"t":"F","e":true,"f":"test-annotations.js"},"TF":{"t":"F","e":true,"f":"test-annotations.js"},"TS2":{"t":"F","e":false,"f":"test-annotations.js"},"TS3":{"t":"F","e":true,"f":"test-annotations.js"},"TS4":{"t":"F","e":true,"f":"test-annotations.js"},"DC1":{"t":"F","e":false,"f":"tools.js"},"DC2":{"t":"F","e":false,"f":"tools.js"},"gG":{"t":"F","e":true,"f":"tools.js"},"dC":{"t":"F","e":false,"f":"tools.js"},"sM":{"t":"F","e":false,"f":"tools.js"},"gS":{"t":"F","e":true,"f":"tools.js"},"FZ":{"t":"F","e":true,"f":"tools.js"},"ex":{"t":"F","e":true,"f":"tools.js"},"de":{"t":"F","e":true,"f":"tools.js"},"us":{"t":"F","e":true,"f":"tools.js"},"eM":{"t":"F","e":false,"f":"tools.js"},"CC1":{"t":"F","e":true,"f":"tools.js"},"iC":{"t":"F","e":true,"f":"tools.js"},"dT":{"t":"F","e":false,"f":"type-checker.js"},"DL":{"t":"F","e":false,"f":"type-checker.js"},"bA":{"t":"F","e":false,"f":"type-checker.js"},"cT":{"t":"F","e":true,"f":"type-checker.js"},"eC2":{"t":"F","e":false,"f":"undocumented.js"},"cM":{"t":"F","e":false,"f":"undocumented.js"},"UF":{"t":"F","e":true,"f":"undocumented.js"},"gU":{"t":"F","e":true,"f":"undocumented.js"},"US":{"t":"F","e":true,"f":"undocumented.js"},"sR":{"t":"F","e":true,"f":"workspace.js"},"WR":{"t":"F","e":true,"f":"workspace.js"},"rP":{"t":"F","e":true,"f":"workspace.js"}},"edges":[],"orphans":["estimateTokens","getArg","getPath","walkJSFiles","compactFile","beautifyFile","findJSFiles","calculateComplexity","getRating","analyzeFile","extractLegend","findSymbolRange","buildJSDocBlock","findCtxFile","findExportStart","splitTopLevelParams","parseGraphignore","isGraphignored","loadRuleSets","saveRuleSet","findFiles","isExcluded","isInStringOrComment","isWithinContext","checkFileAgainstRule","collectReferencedColumns","findProjectRoot","analyzeFileLocals","walkCtxFiles","resolveCtxPath","resolveCtxMdPath","computeSignature","parseCtxDescriptions","buildFileTemplate","processFileCtx","matchWildcard","matchGitignorePattern","fetchReference","listAvailable","calculateHealthScore","runCacheableAnalyses","aggregateComplexity","aggregateUndocumented","aggregateJSDoc","createShortName","extractJSDocComments","findJSDocBefore","extractParamName","inferTypeFromDefault","hasReturnValue","validateFunction","buildJSDoc","inferParamType","extractImports","getBody","extractCalls","isValidTableName","parseColumns","splitByTopLevelComma","extractParams","analyzeFilePatterns","analyzePackageJson","extractCallsAndSQL","getTagName","getCallMethodName","extractStringValue","templateToString","parseFileByExtension","isSourceFile","buildJSDocTypeMap","findJSDocForNode","enrichParamsWithTypes","extractSignatures","buildSignature","hashBodyStructure","calculateSimilarity","findCtxMdFiles","groupByName","updateTestState","saveDiskCache","loadDiskCache","detectChanges","snapshotMtimes","extractMethod","detectTsc","parseDiagnosticLine","buildArgs","extractComments","checkMissing"],"duplicates":{},"files":["ai-context.js","analysis-cache.js","cli-handlers.js","cli.js","compact.js","complexity.js","compress.js","ctx-to-jsdoc.js","custom-rules.js","db-analysis.js","dead-code.js","doc-dialect.js","filters.js","framework-references.js","full-analysis.js","graph-builder.js","instructions.js","jsdoc-checker.js","jsdoc-generator.js","lang-go.js","lang-python.js","lang-sql.js","lang-typescript.js","lang-utils.js","large-files.js","mcp-server.js","mode-config.js","outdated-patterns.js","parser.js","server.js","similar-functions.js","test-annotations.js","tool-defs.js","tools.js","type-checker.js","undocumented.js","workspace.js"]}}

package/src/ai-context.js

@@ -0,0 +1,113 @@
+/**
+ * AI Context Boot — Single-call agent bootstrap
+ *
+ * Combines skeleton + doc-dialect + optional compressed files
+ * into one response for AI agent initialization.
+ */
+
+import { resolve, extname } from 'path';
+import { getSkeleton, getGraph } from './tools.js';
+import { getProjectDocs } from './doc-dialect.js';
+import { compressFile } from './compress.js';
+import { findJSFiles } from './parser.js';
+
+/** Supported extensions for compression */
+const COMPRESSIBLE = new Set(['.js', '.mjs', '.ts', '.tsx']);
+
+/**
+ * Estimate tokens for any value (string or object)
+ * @param {*} value
+ * @returns {number}
+ */
+function estimateTokens(value) {
+  const str = typeof value === 'string' ? value : JSON.stringify(value);
+  return Math.ceil(str.length / 4);
+}
+
+/**
+ * Load complete AI context for agent bootstrap
+ * @param {string} dirPath - Project directory
+ * @param {Object} [options]
+ * @param {string[]} [options.includeFiles] - Specific files to include compressed
+ * @param {boolean} [options.includeDocs=true] - Include doc-dialect
+ * @param {boolean} [options.includeSkeleton=true] - Include skeleton
+ * @returns {Promise<{skeleton?: Object, docs?: string, files?: Object, totalTokens: number, vsOriginal: number, savings: string}>}
+ */
+export async function getAiContext(dirPath, options = {}) {
+  const {
+    includeFiles = [],
+    includeDocs = true,
+    includeSkeleton = true,
+  } = options;
+
+  const projectPath = resolve(dirPath);
+  const result = {};
+  let totalTokens = 0;
+
+  // 1. Skeleton
+  if (includeSkeleton) {
+    result.skeleton = await getSkeleton(projectPath);
+    totalTokens += estimateTokens(result.skeleton);
+  }
+
+  // 2. Doc Dialect
+  if (includeDocs) {
+    const graph = await getGraph(projectPath);
+    result.docs = getProjectDocs(graph, projectPath);
+    totalTokens += estimateTokens(result.docs);
+  }
+
+  // 3. Compressed files
+  if (includeFiles.length > 0) {
+    result.files = {};
+    const allFiles = findJSFiles(projectPath);
+
+    for (const requestedFile of includeFiles) {
+      // Find matching file (by name or path)
+      const match = allFiles.find(f =>
+        f.endsWith(requestedFile) || f.endsWith('/' + requestedFile)
+      );
+
+      if (!match) {
+        result.files[requestedFile] = { error: `File not found: ${requestedFile}` };
+        continue;
+      }
+
+      const ext = extname(match).toLowerCase();
+      if (!COMPRESSIBLE.has(ext)) {
+        result.files[requestedFile] = { error: `Unsupported file type: ${ext}` };
+        continue;
+      }
+
+      try {
+        const compressed = await compressFile(match, { beautify: true, legend: true });
+        result.files[requestedFile] = compressed.code;
+        totalTokens += compressed.compressed;
+      } catch (e) {
+        result.files[requestedFile] = { error: e.message };
+      }
+    }
+  }
+
+  // Estimate original size for savings calculation
+  const allFiles = findJSFiles(projectPath);
+  let vsOriginal = 0;
+  for (const file of allFiles) {
+    try {
+      const { readFileSync } = await import('fs');
+      vsOriginal += estimateTokens(readFileSync(file, 'utf-8'));
+    } catch {
+      // skip unreadable
+    }
+  }
+
+  const savings = vsOriginal > 0
+    ? Math.round((1 - totalTokens / vsOriginal) * 100)
+    : 0;
+
+  result.totalTokens = totalTokens;
+  result.vsOriginal = vsOriginal;
+  result.savings = `${savings}%`;
+
+  return result;
+}