@vpxa/kb 0.1.12 → 0.1.15

package/README.md

@@ -23,7 +23,7 @@ This is an **MCP (Model Context Protocol) server** that gives AI agents:
 8. **Graph auto-population** — during indexing, a lightweight regex extractor builds the knowledge graph automatically from TS/JS source files (functions, classes, interfaces, types, imports)
 9. **Optimized reindex** — full reindex skips redundant hash checks, batches graph writes (flush every 50 files), and skips per-file graph deletes when bulk-cleared
 
-The KB auto-indexes configured source directories on startup, stores embeddings in a local LanceDB vector store, and exposes everything through 64 MCP tools, 47 CLI commands, and 2 resources.
+The KB auto-indexes configured source directories on startup, stores embeddings in a local LanceDB vector store, and exposes everything through 64 MCP tools, 45 CLI commands, and 2 resources.
 
 ---
 
@@ -36,6 +36,12 @@ pnpm add -D @vpxa/kb
 # Initialize in your project
 npx @vpxa/kb init
 
+# After upgrading, overwrite all scaffold/skill files
+npx @vpxa/kb init --force
+
+# Check which files are outdated (JSON report for LLM consumption)
+npx @vpxa/kb init --guide
+
 # Index your codebase
 npx @vpxa/kb reindex
 
@@ -54,13 +60,12 @@ npx @vpxa/kb serve
 | Tool | CLI | Description |
 |------|-----|-------------|
 | `kb_search` | `kb search` | Hybrid vector + keyword search |
-| `kb_find` | `kb find` | Federated search (vector, FTS, glob, regex) |
+| `kb_find` | `kb find` | Federated search (vector, FTS, glob, regex). Use `mode: 'examples'` to find usage examples. |
 | `kb_symbol` | `kb symbol` | Resolve symbol definition, imports, references |
 | `kb_lookup` | `kb lookup` | Look up indexed chunks by file path |
 | `kb_trace` | `kb trace` | Forward/backward flow tracing |
-| `kb_find_examples` | `kb examples` | Find usage examples of a symbol |
 | `kb_scope_map` | `kb scope-map` | Generate task-scoped reading plan |
-| `kb_dead_symbols` | `kb dead-symbols` | Find unused exported symbols |
+| `kb_dead_symbols` | `kb dead-symbols` | Find unused exported symbols (source vs docs) |
 | `kb_file_summary` | `kb summarize` | Structural file overview |
 
 ### Code Analysis
@@ -70,14 +75,14 @@ npx @vpxa/kb serve
 | `kb_analyze_dependencies` | `kb analyze deps` | Dependency graph |
 | `kb_analyze_symbols` | `kb analyze symbols` | Symbol extraction |
 | `kb_analyze_patterns` | `kb analyze patterns` | Code pattern detection |
-| `kb_analyze_entry_points` | `kb analyze entry-points` | Entry point discovery |
+| `kb_analyze_entry_points` | `kb analyze entry-points` | Entry point discovery: handlers, CDK constructs, test suites, package exports (walks monorepo workspaces) |
 | `kb_analyze_diagram` | `kb analyze diagram` | Mermaid diagram generation |
 | `kb_blast_radius` | `kb analyze blast-radius` | Change impact analysis |
 
 ### Context Management
 | Tool | CLI | Description |
 |------|-----|-------------|
-| `kb_compact` | `kb compact` | Compress text to relevant sections |
+| `kb_compact` | `kb compact` | Compress text/file to relevant sections (accepts `path`) |
 | `kb_workset` | `kb workset` | Named file set management |
 | `kb_stash` | `kb stash` | Named key-value store |
 | `kb_checkpoint` | `kb checkpoint` | Session checkpoint save/restore |
@@ -104,9 +109,10 @@ npx @vpxa/kb serve
 | Tool | CLI | Description |
 |------|-----|-------------|
 | `kb_eval` | `kb eval` | Sandboxed JavaScript/TypeScript execution |
-| `kb_check` | `kb check` | Incremental typecheck + lint |
+| `kb_check` | `kb check` | Incremental typecheck + lint (`detail`: summary/errors/full) |
 | `kb_test_run` | `kb test` | Run tests with structured results |
 | `kb_batch` | `kb batch` | Parallel operation execution |
+| `kb_audit` | `kb audit` | Unified project audit: runs structure, deps, patterns, health, dead symbols, check, entry points in one call. Returns score, recommendations, and next steps. |
 
 ### Knowledge Management
 | Tool | CLI | Description |
@@ -158,14 +164,14 @@ npx @vpxa/kb serve
 ### System
 | Tool | CLI | Description |
 |------|-----|-------------|
-| `kb_status` | `kb status` | Index statistics |
+| `kb_status` | `kb status` | Index statistics + tree-sitter availability |
 | `kb_reindex` | `kb reindex` | Rebuild index |
-| `kb_health` | `kb health` | Project health checks (package.json, tsconfig, lockfile, etc.) |
+| `kb_health` | `kb health` | Project health checks (package.json, tsconfig, lockfile, circular deps) |
+| `kb_guide` | `kb guide` | Tool discovery — given a goal, recommends tools and workflow order |
 | `kb_queue` | `kb queue` | Task queue for sequential agent operations |
 | `kb_graph` | `kb graph` | Query and manage the knowledge graph (8 actions: find_nodes, find_edges, neighbors, traverse, stats, add, delete, clear) |
 | `kb_onboard` | `kb onboard` | First-time codebase onboarding — runs all analysis tools in one command, auto-persists results |
-| `kb_replay_list` | `kb replay` | View audit trail of tool invocations |
-| `kb_replay_clear` | `kb replay-clear` | Clear the replay audit trail |
+| `kb_replay` | `kb replay` | View or clear the audit trail of tool invocations (action: list/clear) |
 
 ### TUI Dashboard
 
@@ -211,7 +217,7 @@ kb analyze <type> <path>
 kb lookup <path>
 
 # Context
-kb compact <query> [--max-chars N]
+kb compact <query> [--path <file>] [--max-chars N]
 kb workset <action> [name] [--files f1,f2]
 kb stash <action> [key] [value]
 kb checkpoint <action> [label]
@@ -226,7 +232,7 @@ kb transform <expression>
 # Execution
 kb eval <code> [--lang js|ts] [--timeout N]
 kb test [files...] [--grep pattern]
-kb check [--skip-types] [--skip-lint]
+kb check [--skip-types] [--skip-lint] [--detail summary|errors|full]
 kb batch
 
 # Knowledge
@@ -261,7 +267,7 @@ kb status
 kb reindex [--full]
 kb onboard <path> [--generate] [--out-dir <dir>]
 kb serve [--transport stdio|http] [--port N]
-kb init [--force]
+kb init [--force] [--guide]
 ```
 
 ## Configuration
@@ -296,7 +302,7 @@ kb init [--force]
 │   ├── chunker/      — tree-sitter + regex code chunking
 │   ├── indexer/      — incremental file indexer
 │   ├── analyzers/    — blast-radius, deps, symbols, patterns, diagrams
-│   ├── tools/        — 49 tool modules (64 MCP tools)
+│   ├── tools/        — 52 tool modules (64 MCP tools)
 │   ├── server/       — MCP protocol server
 │   └── cli/          — command-line interface
 ├── bin/kb.mjs        — CLI entry point
@@ -466,7 +472,9 @@ Dependency results include a **confidence** level per import: `high` (ES static
 |-----------|------|----------|-------------|
 | `path` | string | **yes** | Root path |
 
-#### `kb_analyze_entry_points` — Find Lambda handlers, CLI bins, server starts
+#### `kb_analyze_entry_points` — Find Lambda handlers, CDK constructs, test suites, package exports
+
+Walks monorepo workspace packages (pnpm-workspace.yaml / package.json#workspaces), parses `exports` fields, detects CDK constructs and test suites.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -485,12 +493,13 @@ Dependency results include a **confidence** level per import: `high` (ES static
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
-| `text` | string | **yes** | — | The text to compress |
+| `text` | string | no* | — | The text to compress (provide `text` or `path`) |
+| `path` | string | no* | — | File path to read server-side (avoids read_file round-trip) |
 | `query` | string | **yes** | — | Focus query — what are you trying to understand? |
 | `max_chars` | number (100–50000) | no | `3000` | Target output size in characters |
 | `segmentation` | enum | no | `paragraph` | How to split: `paragraph`, `sentence`, `line` |
 
-Uses embedding similarity (no LLM needed) to keep only the segments most relevant to the query. Returns compression stats (original → compressed chars, ratio, segments kept/total) and the compressed text.
+\* At least one of `text` or `path` must be provided. Using `path` is preferred — it eliminates the `read_file` → `compact` two-call chain and prevents token doubling.
 
 #### `kb_workset` — Manage named file sets
 
@@ -641,16 +650,6 @@ Returns a ranked file list with estimated token counts, relevance %, focus line
 
 Follows imports, call sites, and references to build a relationship graph from a starting symbol or file location.
 
-#### `kb_find_examples` — Find real usage examples
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `query` | string | **yes** | — | Symbol or pattern to find examples of |
-| `limit` | number (1–20) | no | `5` | Maximum examples to return |
-| `content_type` | string | no | — | Filter by content type |
-
-Returns usage examples with file paths and code snippets from the indexed codebase.
-
 #### `kb_dead_symbols` — Find unused exported symbols
 
 | Parameter | Type | Required | Default | Description |
@@ -748,6 +747,18 @@ Returns structured pass/fail summary. `isError` set if any tests failed.
 
 Returns per-operation outcomes (success/failure with results or errors).
 
+#### `kb_audit` — Unified project audit
+
+Runs multiple analysis checks in a single call and returns a synthesized report with a composite score (0–100), per-check summaries, and prioritized recommendations.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `path` | string | no | `.` | Root path to audit |
+| `checks` | string[] | no | all | Subset of checks: `structure`, `dependencies`, `patterns`, `health`, `dead_symbols`, `check`, `entry_points` |
+| `detail` | enum | no | `summary` | `summary` (markdown overview) or `full` (structured JSON data) |
+
+Returns `KBResponse<AuditData>` with `next[]` hints for follow-up actions.
+
 ### Git & Environment
 
 #### `kb_git_context` — Summarize Git repository state
@@ -931,13 +942,22 @@ Isolated file copies for parallel exploration. Create a lane, make changes, diff
 
 ### System
 
+#### `kb_guide` — Tool discovery
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `goal` | string | **yes** | — | What you want to accomplish |
+| `max_recommendations` | number | no | 5 | Max tools to recommend (1-10) |
+
+Given a goal description, recommends which KB tools to use and in what order. Matches against 10 predefined workflows: onboard, audit, bugfix, implement, refactor, search, context, memory, validate, analyze.
+
 #### `kb_health` — Run project health checks
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
 | `path` | string | no | cwd | Root directory to check |
 
-Verifies package.json, tsconfig, scripts, lockfile, README, LICENSE, .gitignore.
+Verifies package.json, tsconfig, scripts, lockfile, README, LICENSE, .gitignore, circular dependencies.
 
 #### `kb_queue` — Manage task queues
 
@@ -952,21 +972,18 @@ Verifies package.json, tsconfig, scripts, lockfile, README, LICENSE, .gitignore.
 
 Sequential task queues for agent operations.
 
-#### `kb_replay_list` — View audit trail
+#### `kb_replay` — View or clear audit trail
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
-| `last` | number | no | 20 | Number of entries to return |
-| `tool` | string | no | — | Filter by tool name (e.g., `kb_search`) |
-| `source` | enum | no | — | Filter by source: `mcp` or `cli` |
-| `since` | string | no | — | ISO timestamp — only show entries after this time |
+| `action` | enum | no | `list` | `list` to view entries, `clear` to wipe the log |
+| `last` | number | no | 20 | Number of entries to return (list only) |
+| `tool` | string | no | — | Filter by tool name (list only) |
+| `source` | enum | no | — | Filter by source: `mcp` or `cli` (list only) |
+| `since` | string | no | — | ISO timestamp — only show entries after this time (list only) |
 
 Shows the audit trail of recent tool invocations. Each entry includes tool name, duration, input/output summaries, and status. Useful for debugging agent behavior.
 
-#### `kb_replay_clear` — Clear audit trail
-
-No parameters. Clears the entire replay log.
-
 ---
 
 ## MCP Resources
@@ -1138,6 +1155,6 @@ Every tool response includes a `_Next:` suggestion at the bottom. Follow these h
 - **Workflow Hints**: Every tool response includes `_Next:` suggestions for logical follow-up actions
 - **MCP SDK**: `@modelcontextprotocol/sdk` (stdio + StreamableHTTP transports)
 - **Runtime**: Node.js ≥ 24, TypeScript, ESM, pnpm workspaces
-- **Build**: esbuild with tsc for declarations
+- **Build**: tsdown with integrated dts generation
 - **Lint**: Biome
 - **Test**: Vitest

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpxa/kb",
-  "version": "0.1.12",
+  "version": "0.1.15",
   "type": "module",
   "description": "Local-first AI developer toolkit — knowledge base, code analysis, context management, and developer tools for LLM agents",
   "license": "MIT",
@@ -23,6 +23,7 @@
     "bin/",
     "packages/*/dist/**/*.js",
     "packages/*/dist/**/*.d.ts",
+    "scaffold/",
     "skills/",
     "README.md",
     "LICENSE"
@@ -31,7 +32,8 @@
     ".": "./packages/core/dist/index.js",
     "./tools": "./packages/tools/dist/index.js",
     "./store": "./packages/store/dist/index.js",
-    "./embeddings": "./packages/embeddings/dist/index.js"
+    "./embeddings": "./packages/embeddings/dist/index.js",
+    "./enterprise-bridge": "./packages/enterprise-bridge/dist/index.js"
   },
   "types": "./packages/core/dist/index.d.ts",
   "bin": {
@@ -51,11 +53,12 @@
   "devDependencies": {
     "@biomejs/biome": "^2.x",
     "@types/node": "^24.x",
-    "esbuild": "^0.x",
-    "glob": "^13.x",
     "rimraf": "^6.x",
-    "typescript": "^5.x",
-    "vitest": "^4.x"
+    "tsdown": "^0.x",
+    "turbo": "^2.x",
+    "typescript": "^6.x",
+    "vitest": "^4.x",
+    "ws": "^8.20.0"
   },
   "engines": {
     "node": ">=24"
@@ -63,7 +66,7 @@
   "scripts": {
     "build": "node scripts/build.mjs",
     "typecheck": "tsc -b tsconfig.build.json --emitDeclarationOnly",
-    "clean": "rimraf --glob packages/*/dist packages/*/*.tsbuildinfo",
+    "clean": "turbo run clean && rimraf --glob node_modules \"packages/*/node_modules\"",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",

package/packages/analyzers/dist/blast-radius-analyzer.d.ts

@@ -1,23 +1,20 @@
-/**
- * Blast-radius analyzer.
- *
- * Given a set of changed files, traces the dependency graph to find all
- * affected files (direct + transitive importers) and their associated tests.
- * Returns a minimal review context optimized for token efficiency.
- */
-import type { AnalysisResult } from './types.js';
-export interface BlastRadiusOptions {
-    /** Changed file paths (relative to root) */
-    files: string[];
-    /** Maximum depth of transitive dependency traversal (default: 5) */
-    maxDepth?: number;
-    /** Output format */
-    format?: 'json' | 'markdown';
+import { AnalysisResult } from "./types.js";
+
+//#region packages/analyzers/src/blast-radius-analyzer.d.ts
+interface BlastRadiusOptions {
+  /** Changed file paths (relative to root) */
+  files: string[];
+  /** Maximum depth of transitive dependency traversal (default: 5) */
+  maxDepth?: number;
+  /** Output format */
+  format?: 'json' | 'markdown';
 }
-export declare class BlastRadiusAnalyzer {
-    readonly name = "blast-radius";
-    private depAnalyzer;
-    analyze(rootPath: string, options: BlastRadiusOptions): Promise<AnalysisResult>;
-    private formatMarkdown;
+declare class BlastRadiusAnalyzer {
+  readonly name = "blast-radius";
+  private depAnalyzer;
+  analyze(rootPath: string, options: BlastRadiusOptions): Promise<AnalysisResult>;
+  private formatMarkdown;
 }
+//#endregion
+export { BlastRadiusAnalyzer, BlastRadiusOptions };
 //# sourceMappingURL=blast-radius-analyzer.d.ts.map

package/packages/analyzers/dist/blast-radius-analyzer.js

@@ -1,13 +1,7 @@
-import{DependencyAnalyzer as A}from"./dependency-analyzer.js";class j{name="blast-radius";depAnalyzer=new A;async analyze(d,n){const{files:c,maxDepth:t=5,format:f="markdown"}=n,p=Date.now(),o=(await this.depAnalyzer.analyze(d,{format:"json"})).data,e=o.reverseGraph??{},y=o.testCoverage??{},a=new Map,g=[];for(const s of c){a.set(s,{path:s,reason:"changed",depth:0});const i=s.replace(/\.[jt]sx?$/,"");g.push({path:i,depth:0})}for(;g.length>0;){const s=g.shift();if(!s)break;const{path:i,depth:h}=s;if(h>=t)continue;const l=e[i]??[];for(const m of l){if(a.has(m))continue;const v=h===0?"direct-importer":"transitive-importer";a.set(m,{path:m,reason:v,depth:h+1});const w=m.replace(/\.[jt]sx?$/,"");g.push({path:w,depth:h+1})}}const $=new Set;for(const[s]of a){const i=s.replace(/\.[jt]sx?$/,""),h=y[i]??[];for(const l of h)a.has(l)||($.add(l),a.set(l,{path:l,reason:"test",depth:999}))}const u=[...a.values()].sort((s,i)=>s.depth-i.depth);return{output:f==="json"?JSON.stringify({changedFiles:c,affected:u},null,2):this.formatMarkdown(c,u,e),data:{changedFiles:c,affected:u},meta:{analyzedAt:new Date().toISOString(),scope:d,fileCount:u.length,durationMs:Date.now()-p}}}formatMarkdown(d,n,c){const t=[];t.push(`## Blast Radius Analysis
-`),t.push(`**Changed files:** ${d.length}`),t.push(`**Total affected:** ${n.length}
-`);const f=n.filter(e=>e.reason==="changed");if(f.length>0){t.push(`### Changed Files
-`);for(const e of f)t.push(`- \`${e.path}\``)}const p=n.filter(e=>e.reason==="direct-importer");if(p.length>0){t.push(`
-### Direct Importers (${p.length} files)
-`);for(const e of p)t.push(`- \`${e.path}\``)}const r=n.filter(e=>e.reason==="transitive-importer");if(r.length>0){t.push(`
-### Transitive Importers (${r.length} files)
-`);for(const e of r.slice(0,20))t.push(`- \`${e.path}\` (depth ${e.depth})`);r.length>20&&t.push(`- ... and ${r.length-20} more`)}const o=n.filter(e=>e.reason==="test");if(o.length>0){t.push(`
-### Affected Tests (${o.length} files)
-`);for(const e of o)t.push(`- \`${e.path}\``)}return t.push(`
+import{DependencyAnalyzer as e}from"./dependency-analyzer.js";var t=class{name=`blast-radius`;depAnalyzer=new e;async analyze(e,t){let{files:n,maxDepth:r=5,format:i=`markdown`}=t,a=Date.now(),o=(await this.depAnalyzer.analyze(e,{format:`json`})).data,s=o.reverseGraph??{},c=o.testCoverage??{},l=new Map,u=[];for(let e of n){l.set(e,{path:e,reason:`changed`,depth:0});let t=e.replace(/\.[jt]sx?$/,``);u.push({path:t,depth:0})}for(;u.length>0;){let e=u.shift();if(!e)break;let{path:t,depth:n}=e;if(n>=r)continue;let i=s[t]??[];for(let e of i){if(l.has(e))continue;let t=n===0?`direct-importer`:`transitive-importer`;l.set(e,{path:e,reason:t,depth:n+1});let r=e.replace(/\.[jt]sx?$/,``);u.push({path:r,depth:n+1})}}let d=new Set;for(let[e]of l){let t=c[e.replace(/\.[jt]sx?$/,``)]??[];for(let e of t)l.has(e)||(d.add(e),l.set(e,{path:e,reason:`test`,depth:999}))}let f=[...l.values()].sort((e,t)=>e.depth-t.depth);return{output:i===`json`?JSON.stringify({changedFiles:n,affected:f},null,2):this.formatMarkdown(n,f,s),data:{changedFiles:n,affected:f},meta:{analyzedAt:new Date().toISOString(),scope:e,fileCount:f.length,durationMs:Date.now()-a}}}formatMarkdown(e,t,n){let r=[];r.push(`## Blast Radius Analysis
+`),r.push(`**Changed files:** ${e.length}`),r.push(`**Total affected:** ${t.length}\n`);let i=t.filter(e=>e.reason===`changed`);if(i.length>0){r.push(`### Changed Files
+`);for(let e of i)r.push(`- \`${e.path}\``)}let a=t.filter(e=>e.reason===`direct-importer`);if(a.length>0){r.push(`\n### Direct Importers (${a.length} files)\n`);for(let e of a)r.push(`- \`${e.path}\``)}let o=t.filter(e=>e.reason===`transitive-importer`);if(o.length>0){r.push(`\n### Transitive Importers (${o.length} files)\n`);for(let e of o.slice(0,20))r.push(`- \`${e.path}\` (depth ${e.depth})`);o.length>20&&r.push(`- ... and ${o.length-20} more`)}let s=t.filter(e=>e.reason===`test`);if(s.length>0){r.push(`\n### Affected Tests (${s.length} files)\n`);for(let e of s)r.push(`- \`${e.path}\``)}return r.push(`
 ### Review Summary
-`),t.push("| Category | Count |"),t.push("|----------|-------|"),t.push(`| Changed | ${f.length} |`),t.push(`| Direct importers | ${p.length} |`),t.push(`| Transitive importers | ${r.length} |`),t.push(`| Affected tests | ${o.length} |`),t.push(`| **Total review scope** | **${n.length}** |`),t.join(`
-`)}}export{j as BlastRadiusAnalyzer};
+`),r.push(`| Category | Count |`),r.push(`|----------|-------|`),r.push(`| Changed | ${i.length} |`),r.push(`| Direct importers | ${a.length} |`),r.push(`| Transitive importers | ${o.length} |`),r.push(`| Affected tests | ${s.length} |`),r.push(`| **Total review scope** | **${t.length}** |`),r.join(`
+`)}};export{t as BlastRadiusAnalyzer};
+//# sourceMappingURL=blast-radius-analyzer.js.map

package/packages/analyzers/dist/dependency-analyzer.d.ts

@@ -1,29 +1,33 @@
-import type { AnalysisResult, DependencyAnalyzerOptions, IAnalyzer, ImportInfo } from './types.js';
-export declare class DependencyAnalyzer implements IAnalyzer<DependencyAnalyzerOptions> {
-    readonly name = "dependencies";
-    /** Map of workspace package names to their relative entry point paths */
-    private workspacePackages;
-    analyze(rootPath: string, options?: DependencyAnalyzerOptions): Promise<AnalysisResult>;
-    private collectFiles;
-    private extractImports;
-    private groupExternalDeps;
-    private groupInternalDeps;
-    /**
-     * Build reverse graph: for each source file, who imports it?
-     */
-    buildReverseGraph(imports: ImportInfo[], _rootPath: string): Record<string, string[]>;
-    /**
-     * Build test coverage map: for each source file, which test files exercise it?
-     */
-    buildTestCoverage(imports: ImportInfo[], _rootPath: string): Record<string, string[]>;
-    /** Resolve a relative import path to a normalized file path (best-effort). */
-    private resolveImportPath;
-    /**
-     * Build a map of workspace package names → relative entry point paths.
-     * Scans for package.json files in common workspace dirs.
-     */
-    private buildWorkspaceMap;
-    private formatMarkdown;
-    private formatMermaid;
+import { AnalysisResult, DependencyAnalyzerOptions, IAnalyzer, ImportInfo } from "./types.js";
+
+//#region packages/analyzers/src/dependency-analyzer.d.ts
+declare class DependencyAnalyzer implements IAnalyzer<DependencyAnalyzerOptions> {
+  readonly name = "dependencies";
+  /** Map of workspace package names to their relative entry point paths */
+  private workspacePackages;
+  analyze(rootPath: string, options?: DependencyAnalyzerOptions): Promise<AnalysisResult>;
+  private collectFiles;
+  private extractImports;
+  private groupExternalDeps;
+  private groupInternalDeps;
+  /**
+   * Build reverse graph: for each source file, who imports it?
+   */
+  buildReverseGraph(imports: ImportInfo[], _rootPath: string): Record<string, string[]>;
+  /**
+   * Build test coverage map: for each source file, which test files exercise it?
+   */
+  buildTestCoverage(imports: ImportInfo[], _rootPath: string): Record<string, string[]>;
+  /** Resolve a relative import path to a normalized file path (best-effort). */
+  private resolveImportPath;
+  /**
+   * Build a map of workspace package names → relative entry point paths.
+   * Scans for package.json files in common workspace dirs.
+   */
+  private buildWorkspaceMap;
+  private formatMarkdown;
+  private formatMermaid;
 }
+//#endregion
+export { DependencyAnalyzer };
 //# sourceMappingURL=dependency-analyzer.d.ts.map

package/packages/analyzers/dist/dependency-analyzer.js

@@ -1,11 +1,9 @@
-import{readdir as w,readFile as j}from"node:fs/promises";import{dirname as x,extname as m,join as u,relative as v,resolve as R}from"node:path";const $=new Set([".ts",".tsx",".js",".jsx",".mjs",".cjs",".py",".java",".go",".cs",".kt",".scala",".rb",".rs",".php",".swift"]),P=[{regex:/import\s+(?:(?:type\s+)?(?:(?:\{[^}]*\}|[\w*]+)\s+from\s+)?)['"]([^'"]+)['"]/g,confidence:"high"},{regex:/import\(\s*['"]([^'"]+)['"]\s*\)/g,confidence:"medium"},{regex:/require\(\s*['"]([^'"]+)['"]\s*\)/g,confidence:"medium"},{regex:/^from\s+([\w.]+)\s+import\b/gm,confidence:"high",lang:"python"},{regex:/^import\s+([\w.]+)\s*$/gm,confidence:"high",lang:"python"},{regex:/^import\s+(?:static\s+)?([\w.]+(?:\.\*)?)\s*;/gm,confidence:"high",lang:"java"},{regex:/(?:^import\s+|^\s+)[""]([^""]+)[""]/gm,confidence:"high",lang:"go"},{regex:/^using\s+(?:static\s+)?([\w.]+)\s*;/gm,confidence:"high",lang:"csharp"},{regex:/^use\s+([\w:]+(?:::\w+)*)/gm,confidence:"high",lang:"rust"},{regex:/^use\s+([\w\\]+)\s*;/gm,confidence:"high",lang:"php"},{regex:/require(?:_relative)?\s+['"]([^'"]+)['"]/g,confidence:"medium",lang:"ruby"},{regex:/^import\s+(\w+)\s*$/gm,confidence:"high",lang:"swift"}],I=new Set(["node_modules",".git","dist","build","coverage",".turbo",".cache","cdk.out"]),E=[/\.(test|spec)\.[jt]sx?$/,/\/__tests__\//,/\/test\//,/\/tests\//],b={".ts":"js",".tsx":"js",".js":"js",".jsx":"js",".mjs":"js",".cjs":"js",".py":"python",".java":"java",".kt":"java",".scala":"java",".go":"go",".cs":"csharp",".rs":"rust",".php":"php",".rb":"ruby",".swift":"swift"};function S(a,n){return!n||n==="js"?!a.startsWith(".")&&!a.startsWith("/"):n==="python"?!a.startsWith("."):n==="java"?!a.startsWith("com.")||a.startsWith("com.amazonaws")||a.startsWith("com.google")||a.startsWith("com.fasterxml"):n==="go"?a.includes(".")&&!a.startsWith("."):n==="csharp"?a.startsWith("System")||a.startsWith("Microsoft")||a.startsWith("Newtonsoft")||a.startsWith("Amazon"):n==="rust"?!a.startsWith("crate::")&&!a.startsWith("self::")&&!a.startsWith("super::"):!0}function y(a){return E.some(n=>n.test(a))}class W{name="dependencies";workspacePackages=new Map;async analyze(n,o={}){const{format:i="markdown"}=o,t=Date.now();this.workspacePackages=await this.buildWorkspaceMap(n);const e=await this.collectFiles(n),r=[];for(const d of e){const f=await j(d,"utf-8"),h=this.extractImports(f,d,n);r.push(...h)}const s=this.groupExternalDeps(r),c=this.groupInternalDeps(r,n),g=this.buildReverseGraph(r,n),l=this.buildTestCoverage(r,n);return{output:i==="json"?JSON.stringify({external:s,internal:c,reverseGraph:g,testCoverage:l},null,2):i==="mermaid"?this.formatMermaid(c):this.formatMarkdown(s,c,n,l),data:{external:s,internal:c,reverseGraph:g,testCoverage:l,totalImports:r.length},meta:{analyzedAt:new Date().toISOString(),scope:n,fileCount:e.length,durationMs:Date.now()-t}}}async collectFiles(n){const o=[],i=async t=>{const e=await w(t,{withFileTypes:!0});for(const r of e){if(I.has(r.name)||r.name.startsWith("."))continue;const s=u(t,r.name);r.isDirectory()?await i(s):$.has(m(r.name))&&o.push(s)}};return await i(n),o}extractImports(n,o,i){const t=[],e=m(o).toLowerCase(),r=b[e];for(const s of P){if(s.lang&&s.lang!==r||!s.lang&&r&&r!=="js")continue;const c=new RegExp(s.regex.source,s.regex.flags);let g;for(;(g=c.exec(n))!==null;){const l=g[1],p=S(l,r);t.push({source:l,specifiers:[],filePath:v(i,o).replace(/\\/g,"/"),isExternal:p,confidence:s.confidence})}}return t}groupExternalDeps(n){const o={};for(const t of n){if(!t.isExternal)continue;const e=m(t.filePath).toLowerCase(),r=b[e];let s;if(r==="java"){const c=t.source.split(".");for(;c.length>1;){const g=c[c.length-1];if(g==="*"||/^[A-Z]/.test(g))c.pop();else break}c.length>=2?s=c.slice(0,2).join("."):s=c.join(".")}else if(r==="python")s=t.source.split(".")[0];else if(r==="go")s=t.source;else if(r==="csharp"){const c=t.source.split(".");s=c.length>=2?c.slice(0,2).join("."):t.source}else s=t.source.startsWith("@")?t.source.split("/").slice(0,2).join("/"):t.source.split("/")[0];o[s]||(o[s]={count:0,confidence:t.confidence,usedBy:new Set}),o[s].count++,o[s].usedBy.add(t.filePath),t.confidence==="high"?o[s].confidence="high":t.confidence==="medium"&&o[s].confidence==="low"&&(o[s].confidence="medium")}const i={};for(const[t,e]of Object.entries(o))i[t]={count:e.count,confidence:e.confidence,usedBy:[...e.usedBy]};return i}groupInternalDeps(n,o){const i={};for(const e of n)e.isExternal||(i[e.filePath]||(i[e.filePath]=new Set),i[e.filePath].add(e.source));const t={};for(const[e,r]of Object.entries(i))t[e]=[...r];return t}buildReverseGraph(n,o){const i={};for(const e of n){const r=x(e.filePath),s=this.resolveImportPath(e.source,r);s&&(i[s]||(i[s]=new Set),i[s].add(e.filePath))}const t={};for(const[e,r]of Object.entries(i))t[e]=[...r];return t}buildTestCoverage(n,o){const i={};for(const e of n){if(!y(e.filePath))continue;const r=x(e.filePath),s=this.resolveImportPath(e.source,r);!s||y(s)||(i[s]||(i[s]=new Set),i[s].add(e.filePath))}const t={};for(const[e,r]of Object.entries(i))t[e]=[...r];return t}resolveImportPath(n,o){if(n.startsWith("."))return u(o,n).replace(/\\/g,"/").replace(/\.[jt]sx?$/,"");const i=n.startsWith("@")?n.split("/").slice(0,2).join("/"):n.split("/")[0],t=this.workspacePackages.get(i);return t?t.replace(/\.[jt]sx?$/,""):null}async buildWorkspaceMap(n){const o=new Map,i=["packages","functions","libs","apps","cdk"];for(const t of i){const e=u(n,t);try{const r=await w(e,{withFileTypes:!0});for(const s of r)if(!(!s.isDirectory()||I.has(s.name)))try{const c=u(e,s.name,"package.json"),g=JSON.parse(await j(c,"utf-8"));if(g.name){const l=g.main??g.exports?.["."]??"src/index.ts",p=v(n,R(e,s.name,l)).replace(/\\/g,"/");o.set(g.name,p)}}catch{}}catch{}}return o}formatMarkdown(n,o,i,t){const e=[];e.push(`## Dependencies: ${i}
-`);const r=Object.entries(n).sort((l,p)=>p[1].count-l[1].count),s=r.length,c=r.reduce((l,[,p])=>l+p.count,0),g=r.slice(0,5).map(([l])=>l);e.push(`**${s} external packages**, **${c} total imports**, **${Object.keys(o).length} files** with internal imports.
-`),g.length>0&&e.push(`**Top dependencies**: ${g.join(", ")}
-`),e.push(`### External Dependencies
-`),e.push("| Package | Imports | Used By |"),e.push("|---------|---------|---------|");for(const[l,p]of r)e.push(`| ${l} | ${p.count} | ${p.usedBy.length} ${p.usedBy.length===1?"file":"files"} |`);if(t&&Object.keys(t).length>0){const l=Object.keys(t).length,p=Object.keys(o).filter(f=>!y(f)&&!t[f.replace(/\\.[jt]sx?$/,"")]);e.push(`
+import{readFile as e,readdir as t}from"node:fs/promises";import{dirname as n,extname as r,join as i,relative as a,resolve as o}from"node:path";const s=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`,`.py`,`.java`,`.go`,`.cs`,`.kt`,`.scala`,`.rb`,`.rs`,`.php`,`.swift`]),c=[{regex:/import\s+(?:(?:type\s+)?(?:(?:\{[^}]*\}|[\w*]+)\s+from\s+)?)['"]([^'"]+)['"]/g,confidence:`high`},{regex:/import\(\s*['"]([^'"]+)['"]\s*\)/g,confidence:`medium`},{regex:/require\(\s*['"]([^'"]+)['"]\s*\)/g,confidence:`medium`},{regex:/^from\s+([\w.]+)\s+import\b/gm,confidence:`high`,lang:`python`},{regex:/^import\s+([\w.]+)\s*$/gm,confidence:`high`,lang:`python`},{regex:/^import\s+(?:static\s+)?([\w.]+(?:\.\*)?)\s*;/gm,confidence:`high`,lang:`java`},{regex:/(?:^import\s+|^\s+)[""]([^""]+)[""]/gm,confidence:`high`,lang:`go`},{regex:/^using\s+(?:static\s+)?([\w.]+)\s*;/gm,confidence:`high`,lang:`csharp`},{regex:/^use\s+([\w:]+(?:::\w+)*)/gm,confidence:`high`,lang:`rust`},{regex:/^use\s+([\w\\]+)\s*;/gm,confidence:`high`,lang:`php`},{regex:/require(?:_relative)?\s+['"]([^'"]+)['"]/g,confidence:`medium`,lang:`ruby`},{regex:/^import\s+(\w+)\s*$/gm,confidence:`high`,lang:`swift`}],l=new Set([`node_modules`,`.git`,`dist`,`build`,`coverage`,`.turbo`,`.cache`,`cdk.out`]),u=[/\.(test|spec)\.[jt]sx?$/,/\/__tests__\//,/\/test\//,/\/tests\//],d={".ts":`js`,".tsx":`js`,".js":`js`,".jsx":`js`,".mjs":`js`,".cjs":`js`,".py":`python`,".java":`java`,".kt":`java`,".scala":`java`,".go":`go`,".cs":`csharp`,".rs":`rust`,".php":`php`,".rb":`ruby`,".swift":`swift`};function f(e,t){return!t||t===`js`?!e.startsWith(`.`)&&!e.startsWith(`/`):t===`python`?!e.startsWith(`.`):t===`java`?!e.startsWith(`com.`)||e.startsWith(`com.amazonaws`)||e.startsWith(`com.google`)||e.startsWith(`com.fasterxml`):t===`go`?e.includes(`.`)&&!e.startsWith(`.`):t===`csharp`?e.startsWith(`System`)||e.startsWith(`Microsoft`)||e.startsWith(`Newtonsoft`)||e.startsWith(`Amazon`):t===`rust`?!e.startsWith(`crate::`)&&!e.startsWith(`self::`)&&!e.startsWith(`super::`):!0}function p(e){return u.some(t=>t.test(e))}var m=class{name=`dependencies`;workspacePackages=new Map;async analyze(t,n={}){let{format:r=`markdown`}=n,i=Date.now();this.workspacePackages=await this.buildWorkspaceMap(t);let a=await this.collectFiles(t),o=[];for(let n of a){let r=await e(n,`utf-8`),i=this.extractImports(r,n,t);o.push(...i)}let s=this.groupExternalDeps(o),c=this.groupInternalDeps(o,t),l=this.buildReverseGraph(o,t),u=this.buildTestCoverage(o,t);return{output:r===`json`?JSON.stringify({external:s,internal:c,reverseGraph:l,testCoverage:u},null,2):r===`mermaid`?this.formatMermaid(c):this.formatMarkdown(s,c,t,u),data:{external:s,internal:c,reverseGraph:l,testCoverage:u,totalImports:o.length},meta:{analyzedAt:new Date().toISOString(),scope:t,fileCount:a.length,durationMs:Date.now()-i}}}async collectFiles(e){let n=[],a=async e=>{let o=await t(e,{withFileTypes:!0});for(let t of o){if(l.has(t.name)||t.name.startsWith(`.`))continue;let o=i(e,t.name);t.isDirectory()?await a(o):s.has(r(t.name))&&n.push(o)}};return await a(e),n}extractImports(e,t,n){let i=[],o=d[r(t).toLowerCase()];for(let r of c){if(r.lang&&r.lang!==o||!r.lang&&o&&o!==`js`)continue;let s=new RegExp(r.regex.source,r.regex.flags),c;for(;(c=s.exec(e))!==null;){let e=c[1],s=f(e,o);i.push({source:e,specifiers:[],filePath:a(n,t).replace(/\\/g,`/`),isExternal:s,confidence:r.confidence})}}return i}groupExternalDeps(e){let t={};for(let n of e){if(!n.isExternal)continue;let e=d[r(n.filePath).toLowerCase()],i;if(e===`java`){let e=n.source.split(`.`);for(;e.length>1;){let t=e[e.length-1];if(t===`*`||/^[A-Z]/.test(t))e.pop();else break}i=e.length>=2?e.slice(0,2).join(`.`):e.join(`.`)}else if(e===`python`)i=n.source.split(`.`)[0];else if(e===`go`)i=n.source;else if(e===`csharp`){let e=n.source.split(`.`);i=e.length>=2?e.slice(0,2).join(`.`):n.source}else i=n.source.startsWith(`@`)?n.source.split(`/`).slice(0,2).join(`/`):n.source.split(`/`)[0];t[i]||(t[i]={count:0,confidence:n.confidence,usedBy:new Set}),t[i].count++,t[i].usedBy.add(n.filePath),n.confidence===`high`?t[i].confidence=`high`:n.confidence===`medium`&&t[i].confidence===`low`&&(t[i].confidence=`medium`)}let n={};for(let[e,r]of Object.entries(t))n[e]={count:r.count,confidence:r.confidence,usedBy:[...r.usedBy]};return n}groupInternalDeps(e,t){let n={};for(let t of e)t.isExternal||(n[t.filePath]||(n[t.filePath]=new Set),n[t.filePath].add(t.source));let r={};for(let[e,t]of Object.entries(n))r[e]=[...t];return r}buildReverseGraph(e,t){let r={};for(let t of e){let e=n(t.filePath),i=this.resolveImportPath(t.source,e);i&&(r[i]||(r[i]=new Set),r[i].add(t.filePath))}let i={};for(let[e,t]of Object.entries(r))i[e]=[...t];return i}buildTestCoverage(e,t){let r={};for(let t of e){if(!p(t.filePath))continue;let e=n(t.filePath),i=this.resolveImportPath(t.source,e);!i||p(i)||(r[i]||(r[i]=new Set),r[i].add(t.filePath))}let i={};for(let[e,t]of Object.entries(r))i[e]=[...t];return i}resolveImportPath(e,t){if(e.startsWith(`.`))return i(t,e).replace(/\\/g,`/`).replace(/\.[jt]sx?$/,``);let n=e.startsWith(`@`)?e.split(`/`).slice(0,2).join(`/`):e.split(`/`)[0],r=this.workspacePackages.get(n);return r?r.replace(/\.[jt]sx?$/,``):null}async buildWorkspaceMap(n){let r=new Map;for(let s of[`packages`,`functions`,`libs`,`apps`,`cdk`]){let c=i(n,s);try{let s=await t(c,{withFileTypes:!0});for(let t of s)if(!(!t.isDirectory()||l.has(t.name)))try{let s=i(c,t.name,`package.json`),l=JSON.parse(await e(s,`utf-8`));if(l.name){let e=l.main??l.exports?.[`.`]??`src/index.ts`,i=a(n,o(c,t.name,e)).replace(/\\/g,`/`);r.set(l.name,i)}}catch{}}catch{}}return r}formatMarkdown(e,t,n,r){let i=[];i.push(`## Dependencies: ${n}\n`);let a=Object.entries(e).sort((e,t)=>t[1].count-e[1].count),o=a.length,s=a.reduce((e,[,t])=>e+t.count,0),c=a.slice(0,5).map(([e])=>e);i.push(`**${o} external packages**, **${s} total imports**, **${Object.keys(t).length} files** with internal imports.\n`),c.length>0&&i.push(`**Top dependencies**: ${c.join(`, `)}\n`),i.push(`### External Dependencies
+`),i.push(`| Package | Imports | Used By |`),i.push(`|---------|---------|---------|`);for(let[e,t]of a)i.push(`| ${e} | ${t.count} | ${t.usedBy.length} ${t.usedBy.length===1?`file`:`files`} |`);if(r&&Object.keys(r).length>0){let e=Object.keys(r).length,n=Object.keys(t).filter(e=>!p(e)&&!r[e.replace(/\\.[jt]sx?$/,``)]);i.push(`
 ### Test Coverage Summary
-`),e.push(`**${l} source modules** with test coverage.`),p.length>0&&e.push(`**${p.length} source files** with no detected test coverage.`);const d=Object.entries(t).sort((f,h)=>h[1].length-f[1].length);e.push(`
+`),i.push(`**${e} source modules** with test coverage.`),n.length>0&&i.push(`**${n.length} source files** with no detected test coverage.`);let a=Object.entries(r).sort((e,t)=>t[1].length-e[1].length);i.push(`
 **Most-tested modules:**
-`);for(const[f,h]of d.slice(0,10)){const k=f.replace(/\/dist\/[^/]*$/,"/src/index").replace(/\.mjs$/,".ts");e.push(`- ${k} (${h.length} ${h.length===1?"test":"tests"})`)}}return e.join(`
-`)}formatMermaid(n){const o=["graph LR"],i=t=>t.replace(/[^a-zA-Z0-9]/g,"_");for(const[t,e]of Object.entries(n).slice(0,40)){const r=i(t);for(const s of e){const c=i(s);o.push(`  ${r}["${t}"] --> ${c}["${s}"]`)}}return o.join(`
-`)}}export{W as DependencyAnalyzer};
+`);for(let[e,t]of a.slice(0,10)){let n=e.replace(/\/dist\/[^/]*$/,`/src/index`).replace(/\.mjs$/,`.ts`);i.push(`- ${n} (${t.length} ${t.length===1?`test`:`tests`})`)}}return i.join(`
+`)}formatMermaid(e){let t=[`graph LR`],n=e=>e.replace(/[^a-zA-Z0-9]/g,`_`);for(let[r,i]of Object.entries(e).slice(0,40)){let e=n(r);for(let a of i){let i=n(a);t.push(`  ${e}["${r}"] --> ${i}["${a}"]`)}}return t.join(`
+`)}};export{m as DependencyAnalyzer};
+//# sourceMappingURL=dependency-analyzer.js.map

package/packages/analyzers/dist/diagram-generator.d.ts

@@ -1,13 +1,17 @@
-import type { AnalysisResult, DiagramOptions, IAnalyzer } from './types.js';
+import { AnalysisResult, DiagramOptions, IAnalyzer } from "./types.js";
+
+//#region packages/analyzers/src/diagram-generator.d.ts
 /**
  * Generates Mermaid diagrams by combining output from other analyzers.
  */
-export declare class DiagramGenerator implements IAnalyzer<DiagramOptions> {
-    readonly name = "diagrams";
-    private readonly structureAnalyzer;
-    private readonly dependencyAnalyzer;
-    analyze(rootPath: string, options?: DiagramOptions): Promise<AnalysisResult>;
-    private generateArchitectureDiagram;
-    private generateDependencyDiagram;
+declare class DiagramGenerator implements IAnalyzer<DiagramOptions> {
+  readonly name = "diagrams";
+  private readonly structureAnalyzer;
+  private readonly dependencyAnalyzer;
+  analyze(rootPath: string, options?: DiagramOptions): Promise<AnalysisResult>;
+  private generateArchitectureDiagram;
+  private generateDependencyDiagram;
 }
+//#endregion
+export { DiagramGenerator };
 //# sourceMappingURL=diagram-generator.d.ts.map

package/packages/analyzers/dist/diagram-generator.js

@@ -1,4 +1,3 @@
-import{DependencyAnalyzer as u}from"./dependency-analyzer.js";import{StructureAnalyzer as g}from"./structure-analyzer.js";class D{name="diagrams";structureAnalyzer=new g;dependencyAnalyzer=new u;async analyze(r,d={}){const{diagramType:o="architecture"}=d,p=Date.now();let s;return o==="dependencies"?s=await this.generateDependencyDiagram(r):s=await this.generateArchitectureDiagram(r),{output:s,data:{diagramType:o},meta:{analyzedAt:new Date().toISOString(),scope:r,fileCount:0,durationMs:Date.now()-p}}}async generateArchitectureDiagram(r){const o=(await this.structureAnalyzer.analyze(r,{format:"json",maxDepth:4})).data.tree,s=(await this.dependencyAnalyzer.analyze(r,{format:"json"})).data,n=["```mermaid","graph TB"],y=(o.children??[]).filter(t=>t.type==="directory").slice(0,15);for(const t of y){const c=t.name.replace(/[^a-zA-Z0-9]/g,"_"),a=(t.children??[]).filter(e=>e.type==="directory");if(a.length>0){n.push(`  subgraph ${c}["${t.name}/"]`);for(const e of a.slice(0,12)){const i=`${c}_${e.name.replace(/[^a-zA-Z0-9]/g,"_")}`,l=Array.isArray(e.children)?e.children.length:0;n.push(`    ${i}["${e.name}/ (${l})"]`)}n.push("  end")}else{const e=Array.isArray(t.children)?t.children.length:0;n.push(`  ${c}["${t.name}/ (${e} files)"]`)}}const m=new Set;if(s.internal)for(const[t,c]of Object.entries(s.internal)){const a=t.split("/")[0]?.replace(/[^a-zA-Z0-9]/g,"_");for(const e of c){if(e.startsWith("."))continue;const i=e.split("/")[0]?.replace(/[^a-zA-Z0-9]/g,"_");if(a&&i&&a!==i){const l=`${a}->${i}`;m.has(l)||(m.add(l),n.push(`  ${a} --> ${i}`))}}}return n.push("```"),n.join(`
-`)}async generateDependencyDiagram(r){return`\`\`\`mermaid
-${(await this.dependencyAnalyzer.analyze(r,{format:"mermaid"})).output}
-\`\`\``}}export{D as DiagramGenerator};
+import{DependencyAnalyzer as e}from"./dependency-analyzer.js";import{StructureAnalyzer as t}from"./structure-analyzer.js";var n=class{name=`diagrams`;structureAnalyzer=new t;dependencyAnalyzer=new e;async analyze(e,t={}){let{diagramType:n=`architecture`}=t,r=Date.now(),i;switch(n){case`dependencies`:i=await this.generateDependencyDiagram(e);break;default:i=await this.generateArchitectureDiagram(e);break}return{output:i,data:{diagramType:n},meta:{analyzedAt:new Date().toISOString(),scope:e,fileCount:0,durationMs:Date.now()-r}}}async generateArchitectureDiagram(e){let t=(await this.structureAnalyzer.analyze(e,{format:`json`,maxDepth:4})).data.tree,n=(await this.dependencyAnalyzer.analyze(e,{format:`json`})).data,r=["```mermaid",`graph TB`],i=(t.children??[]).filter(e=>e.type===`directory`).slice(0,15);for(let e of i){let t=e.name.replace(/[^a-zA-Z0-9]/g,`_`),n=(e.children??[]).filter(e=>e.type===`directory`);if(n.length>0){r.push(`  subgraph ${t}["${e.name}/"]`);for(let e of n.slice(0,12)){let n=`${t}_${e.name.replace(/[^a-zA-Z0-9]/g,`_`)}`,i=Array.isArray(e.children)?e.children.length:0;r.push(`    ${n}["${e.name}/ (${i})"]`)}r.push(`  end`)}else{let n=Array.isArray(e.children)?e.children.length:0;r.push(`  ${t}["${e.name}/ (${n} files)"]`)}}let a=new Set;if(n.internal)for(let[e,t]of Object.entries(n.internal)){let n=e.split(`/`)[0]?.replace(/[^a-zA-Z0-9]/g,`_`);for(let e of t){if(e.startsWith(`.`))continue;let t=e.split(`/`)[0]?.replace(/[^a-zA-Z0-9]/g,`_`);if(n&&t&&n!==t){let e=`${n}->${t}`;a.has(e)||(a.add(e),r.push(`  ${n} --> ${t}`))}}}return r.push("```"),r.join(`
+`)}async generateDependencyDiagram(e){return`\`\`\`mermaid\n${(await this.dependencyAnalyzer.analyze(e,{format:`mermaid`})).output}\n\`\`\``}};export{n as DiagramGenerator};
+//# sourceMappingURL=diagram-generator.js.map

package/packages/analyzers/dist/entry-point-analyzer.d.ts

@@ -1,19 +1,41 @@
-import type { AnalysisResult, AnalyzerOptions, IAnalyzer } from './types.js';
-export declare class EntryPointAnalyzer implements IAnalyzer<AnalyzerOptions> {
-    readonly name = "entry-points";
-    analyze(rootPath: string, _options?: AnalyzerOptions): Promise<AnalysisResult>;
-    private fromPackageJson;
-    private fromHandlerExports;
-    /** Extract a meaningful name from the file path for non-JS entry points */
-    private inferNameFromFile;
-    /**
-     * Derive a contextual name from the directory path for generic handler/main files.
-     * E.g., "services/channels/email/delivery/src/handler.ts" → "email-delivery"
-     */
-    private deriveContextualName;
-    private inferEntryType;
-    private detectTrigger;
-    private collectFiles;
-    private formatMarkdown;
+import { AnalysisResult, AnalyzerOptions, IAnalyzer } from "./types.js";
+
+//#region packages/analyzers/src/entry-point-analyzer.d.ts
+declare class EntryPointAnalyzer implements IAnalyzer<AnalyzerOptions> {
+  readonly name = "entry-points";
+  analyze(rootPath: string, _options?: AnalyzerOptions): Promise<AnalysisResult>;
+  private fromPackageJson;
+  /** Parse package.json `exports` field into entry points. */
+  private parseExportsField;
+  /** Resolve export value through condition maps (import > default > first string). */
+  private resolveExportValue;
+  /**
+   * Find all workspace package directories in a monorepo.
+   * Supports pnpm-workspace.yaml and package.json#workspaces.
+   */
+  private findWorkspacePackages;
+  /** Simple YAML parser for pnpm-workspace.yaml — extracts packages list. */
+  private parsePnpmWorkspaceYaml;
+  /**
+   * Expand a workspace glob like "packages/*" into actual directories
+   * that contain package.json files.
+   */
+  private expandWorkspaceGlob;
+  private fromHandlerExports;
+  /** Check if a file is a test suite. */
+  private isTestFile;
+  /** Extract a meaningful name from the file path for non-JS entry points */
+  private inferNameFromFile;
+  /**
+   * Derive a contextual name from the directory path for generic handler/main files.
+   * E.g., "services/channels/email/delivery/src/handler.ts" → "email-delivery"
+   */
+  private deriveContextualName;
+  private inferEntryType;
+  private detectTrigger;
+  private collectFiles;
+  private formatMarkdown;
 }
+//#endregion
+export { EntryPointAnalyzer };
 //# sourceMappingURL=entry-point-analyzer.d.ts.map