@vpxa/aikit 0.1.58 → 0.1.60

package/scaffold/general/skills/present/SKILL.md

@@ -162,6 +162,154 @@ The dashboard uses a professional dark theme:
 
 ---
 
+## Architecture Diagrams
+
+> **Behavioral rule:** When asked to present, visualize, or display system architecture, infrastructure, or service topology — **always load the `c4-architecture` skill** and use its HTML/SVG format (Method 2 below) for rich visual output via `present`. The Mermaid method (Method 1) is acceptable only for quick in-chat previews or when the user explicitly asks for Mermaid. Default to HTML/SVG for all architecture presentations.
+
+The `present` tool can render C4-style architecture diagrams in both `html` and `browser` formats. The visual design system is centralized in the `c4-architecture` skill's reference file — load that skill for the full type registry, color palette, and template.
+
+**Design system source:** `c4-architecture/references/html-design-system.md` (single source of truth for all architecture diagram styling)
+
+### When to Use (Auto-Trigger)
+
+Load the `c4-architecture` skill and use HTML/SVG format when the user:
+- Asks to "show architecture", "present the system design", "visualize infrastructure"
+- Wants to display service topology, deployment layout, or component relationships
+- Requests architecture review output, system overview dashboards, or technical presentations
+- Uses words like "architecture diagram", "system diagram", "infrastructure diagram"
+
+### Rendering Methods
+
+| Method | Block Type | Format | When to Use |
+|--------|-----------|--------|-------------|
+| Mermaid C4 | `mermaid` | html / browser | Quick diagrams, developer-focused, version-controlled |
+| HTML/SVG | `markdown` | html / browser | Rich visual presentations, stakeholder reviews, dark-themed dashboards |
+
+### Method 1: Mermaid C4 Diagrams
+
+Use a `mermaid` content block with standard C4 Mermaid syntax:
+
+present({
+  format: "html",  // or "browser"
+  title: "System Architecture",
+  content: [
+    {
+      type: "mermaid",
+      title: "C4 Container Diagram",
+      value: `C4Container
+  title Container Diagram - Payment System
+
+  Person(user, "Customer", "Places orders")
+
+  Container_Boundary(app, "Payment Platform") {
+
+---
+
+## Rendering Troubleshooting
+
+### Why `html` format sometimes shows raw text
+
+The `html` format renders content inside an MCP Apps companion iframe (UIResource). The chat text fallback is intentionally minimal (just the title). When the UIResource fails to load, the user sees only the title or raw JSON — NOT the rendered dashboard.
+
+**Common causes of UIResource rendering failure:**
+1. **MCP Apps not enabled** — The setting `chat.mcp.apps.enabled` must be `true` in VS Code settings
+2. **Companion app build missing** — The `packages/present` companion app must be built (`npm run build`)
+3. **Content too large** — Very large content arrays (20+ blocks or tables with 50+ rows) may cause the companion iframe to fail silently
+4. **Iframe loading error** — Network issues, CSP restrictions, or extension conflicts can prevent the iframe from loading
+
+### When to prefer `browser` over `html`
+
+Use `format: "browser"` instead of `html` when:
+- Content has **10+ blocks** or tables with **20+ rows** (large payloads are more reliable in browser)
+- The output must be **guaranteed visible** (browser format always opens, no silent failures)
+- You need **charts + tables + markdown** in the same view (browser renders all block types reliably)
+- The user reports that `html` format "didn't show anything" or "showed raw text"
+
+> **Reliability rule:** If content is complex (5+ blocks of mixed types), prefer `format: "browser"` for guaranteed rendering. The `html` format is best for simple, single-block content.
+
+### Content formatting tips to avoid rendering issues
+
+1. **Use `table` block type** instead of markdown tables inside `markdown` blocks — `table` blocks render natively; markdown pipe-tables may show as raw text in fallback
+2. **Use `cards` and `metrics`** for summary data instead of embedding it in markdown text
+3. **Keep `markdown` blocks for narrative text only** — don't embed HTML, tables, or complex formatting
+4. **Split large content** into multiple smaller `present` calls rather than one massive content array
+5. **For charts:** Always use ChartValue format (`chartType`, `data`, `xKey`, `yKeys`) — NOT Chart.js format (`labels`, `datasets`)
+
+---
+
+    Container(api, "API Gateway", "Kong", "Routes requests")
+    Container(svc, "Payment Service", "Node.js", "Processes payments")
+    ContainerDb(db, "Payment DB", "PostgreSQL", "Transaction records")
+  }
+
+  System_Ext(stripe, "Stripe", "Payment processor")
+
+  Rel(user, api, "HTTPS")
+  Rel(api, svc, "gRPC")
+  Rel(svc, db, "SQL")
+  Rel(svc, stripe, "REST")`
+    }
+  ]
+})
+```
+
+### Method 2: HTML/SVG Architecture Diagrams
+
+For rich visual output, embed the full HTML/SVG diagram in a `markdown` block. Compose with `metrics` and `cards` blocks for a complete dashboard.
+
+**Both `format: "html"` and `format: "browser"` work with this approach.**
+
+```js
+present({
+  format: "html",  // or "browser"
+  title: "System Architecture",
+  content: [
+    {
+      type: "metrics",
+      title: "Overview",
+      value: [
+        { label: "Services", value: "6" },
+        { label: "Data Stores", value: "2" },
+        { label: "External Systems", value: "3" }
+      ]
+    },
+    {
+      type: "markdown",
+      title: "Architecture Diagram",
+      value: "<div class='arch-diagram'><style>/* design system CSS from c4-architecture/references/html-design-system.md */</style><svg viewBox='0 0 1000 680'><!-- SVG components using category colors --></svg></div>"
+    },
+    {
+      type: "cards",
+      title: "Component Summary",
+      value: [
+        { title: "Frontend", body: "React SPA + CDN delivery" },
+        { title: "Backend", body: "3 microservices, gRPC mesh" },
+        { title: "Data", body: "PostgreSQL + Redis cache" }
+      ]
+    }
+  ]
+})
+```
+
+### Component Categories (Quick Reference)
+
+The full type registry with sub-types and icon slots is in `c4-architecture/references/html-design-system.md`. Here is the category summary:
+
+| Category | Stroke | CSS Class | Use For |
+|----------|--------|-----------|---------|
+| Frontend | `#22d3ee` | `.cyan` | SPAs, mobile apps, static sites, PWAs |
+| Backend | `#34d399` | `.emerald` | API services, workers, microservices, serverless |
+| Data | `#a78bfa` | `.violet` | Databases, caches, search engines, warehouses |
+| Infrastructure | `#fbbf24` | `.amber` | CDNs, load balancers, DNS, storage |
+| Messaging | `#fb923c` | `.orange` | Queues, event buses, streams, pub/sub |
+| Security | `#fb7185` | `.rose` | Auth, API gateways, WAF, secret managers |
+| External | `#94a3b8` | `.slate` | Third-party APIs, SaaS, legacy systems |
+| Monitoring | `#38bdf8` | `.sky` | Logging, metrics, tracing, alerting |
+
+> **Centralization note:** Do not duplicate colors or type definitions here. The `c4-architecture` skill's design system is the single source of truth. When categories or colors change, they are updated in one place.
+
+---
+
 ## Best Practices
 
 1. **Use `browser` format** for data-rich content — charts, tables, dashboards. **Always use `browser` in CLI mode** (the `html` UIResource doesn't render in terminal environments).
@@ -178,6 +326,38 @@ The dashboard uses a professional dark theme:
 
 ---
 
+## Rendering Troubleshooting
+
+### Why `html` format sometimes shows raw text
+
+The `html` format renders content inside an MCP Apps companion iframe (UIResource). The chat text fallback is intentionally minimal (just the title). When the UIResource fails to load, the user sees only the title or raw JSON — NOT the rendered dashboard.
+
+**Common causes of UIResource rendering failure:**
+1. **MCP Apps not enabled** — The setting `chat.mcp.apps.enabled` must be `true` in VS Code settings
+2. **Companion app build missing** — The `packages/present` companion app must be built (`npm run build`)
+3. **Content too large** — Very large content arrays (20+ blocks or tables with 50+ rows) may cause the companion iframe to fail silently
+4. **Iframe loading error** — Network issues, CSP restrictions, or extension conflicts can prevent the iframe from loading
+
+### When to prefer `browser` over `html`
+
+Use `format: "browser"` instead of `html` when:
+- Content has **10+ blocks** or tables with **20+ rows** (large payloads are more reliable in browser)
+- The output must be **guaranteed visible** (browser format always opens, no silent failures)
+- You need **charts + tables + markdown** in the same view (browser renders all block types reliably)
+- The user reports that `html` format "didn't show anything" or "showed raw text"
+
+> **Reliability rule:** If content is complex (5+ blocks of mixed types), prefer `format: "browser"` for guaranteed rendering. The `html` format is best for simple, single-block content.
+
+### Content formatting tips to avoid rendering issues
+
+1. **Use `table` block type** instead of markdown tables inside `markdown` blocks — `table` blocks render natively; markdown pipe-tables may show as raw text in fallback
+2. **Use `cards` and `metrics`** for summary data instead of embedding it in markdown text
+3. **Keep `markdown` blocks for narrative text only** — don't embed HTML, tables, or complex formatting
+4. **Split large content** into multiple smaller `present` calls rather than one massive content array
+5. **For charts:** Always use ChartValue format (`chartType`, `data`, `xKey`, `yKeys`) — NOT Chart.js format (`labels`, `datasets`)
+
+---
+
 ## MCP Apps Templates (VS Code Chat Widgets)
 
 When `chat.mcp.apps.enabled` is true in VS Code settings, the `present` tool can render **interactive widgets directly in the chat panel** using the `template` parameter. These are distinct from the browser/html dashboard modes.

package/packages/aikit-client/dist/direct-client.d.ts

@@ -1,37 +0,0 @@
-import { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus } from "./types.js";
-import { IEmbedder } from "../../embeddings/dist/index.js";
-import { IGraphStore, IKnowledgeStore } from "../../store/dist/index.js";
-
-//#region packages/aikit-client/src/direct-client.d.ts
-interface CuratedEntry {
-  path: string;
-  title: string;
-  category: string;
-  tags: string[];
-  content: string;
-}
-interface DirectClientDeps {
-  store: IKnowledgeStore;
-  embedder: IEmbedder;
-  graphStore?: IGraphStore;
-  /** Function to list curated entries */
-  listCurated?: () => Promise<CuratedEntry[]>;
-  /** Function to read a single curated entry */
-  readCurated?: (path: string) => Promise<CuratedEntry | null>;
-}
-declare class DirectKBClient implements IKBClient {
-  private readonly deps;
-  constructor(deps: DirectClientDeps);
-  getStatus(): Promise<KBStatus>;
-  search(query: string, options?: {
-    limit?: number;
-    mode?: 'hybrid' | 'semantic' | 'keyword';
-  }): Promise<KBSearchResult[]>;
-  listKnowledge(): Promise<KBKnowledgeEntry[]>;
-  readKnowledge(path: string): Promise<KBKnowledgeEntry | null>;
-  getGraph(query?: string): Promise<KBGraphData>;
-  getFileTree(): Promise<string[]>;
-  private getEdgesForNodes;
-}
-//#endregion
-export { DirectClientDeps, DirectKBClient };

package/packages/aikit-client/dist/direct-client.js

@@ -1 +0,0 @@
-const e=1e3;var t=class{constructor(e){this.deps=e}async getStatus(){let e=await this.deps.store.getStats();return{totalRecords:e.totalRecords,totalFiles:e.totalFiles,lastIndexedAt:e.lastIndexedAt??null,onboarded:e.totalRecords>0}}async search(e,t){let n=t?.limit??10,i=t?.mode??`hybrid`;if(i===`keyword`)return(await this.deps.store.ftsSearch(e,{limit:n})).map(r);let a=await this.deps.embedder.embedQuery(e);if(i===`semantic`)return(await this.deps.store.search(a,{limit:n})).map(r);let[o,s]=await Promise.all([this.deps.store.search(a,{limit:n*2}),this.deps.store.ftsSearch(e,{limit:n*2}).catch(()=>[])]),c=new Map;for(let e of[...o,...s]){let t=c.get(e.record.id);(!t||e.score>t.score)&&c.set(e.record.id,e)}return[...c.values()].sort((e,t)=>t.score-e.score).slice(0,n).map(r)}async listKnowledge(){return this.deps.listCurated?(await this.deps.listCurated()).map(n):[]}async readKnowledge(e){if(!this.deps.readCurated)return null;let t=await this.deps.readCurated(e);return t?n(t):null}async getGraph(t){if(!this.deps.graphStore)return{nodes:[],edges:[]};let n=await this.deps.graphStore.findNodes(t?{namePattern:t,limit:500}:{limit:500});if(n.length===0)return{nodes:[],edges:[]};let r=t?await this.getEdgesForNodes(n):await this.deps.graphStore.findEdges({limit:e});return{nodes:n.map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:i(r).map(e=>({fromId:e.fromId,toId:e.toId,type:e.type}))}}async getFileTree(){return this.deps.store.listSourcePaths()}async getEdgesForNodes(t){let n=this.deps.graphStore;if(!n)return[];let r=t.flatMap(t=>[n.findEdges({fromId:t.id,limit:e}),n.findEdges({toId:t.id,limit:e})]);return(await Promise.all(r)).flat()}};function n(e){return{path:e.path,title:e.title,category:e.category,tags:e.tags,content:e.content}}function r(e){return{sourcePath:e.record.sourcePath,contentType:e.record.contentType,score:e.score,content:e.record.content,headingPath:e.record.headingPath,startLine:e.record.startLine,endLine:e.record.endLine}}function i(e){let t=new Map;for(let n of e)t.set(n.id,n);return[...t.values()]}export{t as DirectKBClient};

package/packages/aikit-client/dist/mcp-client.d.ts

@@ -1,19 +0,0 @@
-import { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus } from "./types.js";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-
-//#region packages/aikit-client/src/mcp-client.d.ts
-declare class McpKBClient implements IKBClient {
-  private readonly client;
-  constructor(client: Client);
-  getStatus(): Promise<KBStatus>;
-  search(query: string, options?: {
-    limit?: number;
-    mode?: 'hybrid' | 'semantic' | 'keyword';
-  }): Promise<KBSearchResult[]>;
-  listKnowledge(): Promise<KBKnowledgeEntry[]>;
-  readKnowledge(path: string): Promise<KBKnowledgeEntry | null>;
-  getGraph(query?: string): Promise<KBGraphData>;
-  getFileTree(): Promise<string[]>;
-}
-//#endregion
-export { McpKBClient };

package/packages/aikit-client/dist/mcp-client.js

@@ -1,4 +0,0 @@
-import{extractStructured as e,extractText as t}from"./parsers.js";var n=class{constructor(e){this.client=e}async getStatus(){let e=await this.client.callTool({name:`status`,arguments:{}}),t=i(e);if(t)return{totalRecords:l(t.totalRecords),totalFiles:l(t.totalFiles),lastIndexedAt:d(t.lastIndexedAt),onboarded:!!t.onboarded};let n=r(e);return{totalRecords:a(n,/Records:\s*(\d+)/i),totalFiles:a(n,/Files:\s*(\d+)/i),lastIndexedAt:null,onboarded:!/not onboarded/i.test(n)}}async search(e,t){let n=await this.client.callTool({name:`search`,arguments:{query:e,limit:t?.limit??10,search_mode:t?.mode??`hybrid`}}),a=i(n);return a?.results?a.results.map(e=>({sourcePath:f(e.sourcePath??e.path),contentType:f(e.contentType,`unknown`),score:l(e.score),content:f(e.content??e.snippet),headingPath:p(e.headingPath),startLine:u(e.startLine),endLine:u(e.endLine)})):o(r(n))}async listKnowledge(){let e=i(await this.client.callTool({name:`list`,arguments:{}}));return e?.entries?e.entries.map(e=>({path:f(e.path),title:f(e.title),category:f(e.category),tags:m(e.tags),content:f(e.content)})):[]}async readKnowledge(e){try{let t=r(await this.client.callTool({name:`read`,arguments:{path:e}}));return!t||/not found/i.test(t)?null:{path:e,title:e.split(`/`).pop()??e,category:e.split(`/`).at(-2)??`uncategorized`,tags:[],content:t}}catch{return null}}async getGraph(e){let t=s(r(await this.client.callTool({name:`graph`,arguments:{action:`find_nodes`,...e?{name_pattern:e}:{},limit:500}})));return t.length===0?{nodes:[],edges:[]}:{nodes:t,edges:c(r(await this.client.callTool({name:`graph`,arguments:{action:`find_edges`,limit:1e3}})))}}async getFileTree(){let e=await this.client.callTool({name:`find`,arguments:{glob:`**/*`,limit:1e4}}),t=i(e);return t?.results?t.results.map(e=>typeof e==`string`?e:e.path??``).filter(e=>e.length>0):r(e).split(`
-`).map(e=>e.trim()).filter(e=>e.length>0)}};function r(e){return t(e)}function i(t){return e(t)}function a(e,t){let n=t.exec(e);return n?Number.parseInt(n[1],10):0}function o(e){let t=[],n=e.split(/\n(?=\d+\.\s|\*\*)/);for(let e of n){let n=/(?:\*\*|`)([^*`]+?)(?:\*\*|`)/.exec(e),r=/score:\s*([\d.]+)/i.exec(e);n&&t.push({sourcePath:n[1].trim(),contentType:`unknown`,score:r?Number.parseFloat(r[1]):0,content:e.replace(/^.*\n/,``).trim().slice(0,200)})}return t}function s(e){let t=[];for(let n of e.split(`
-`)){let e=/\*\*(.+?)\*\*\s*\(([^,)]+)(?:,\s*id:\s*`?([\w-]+)`?)?/.exec(n);e&&t.push({id:e[3]??`node-${t.length}`,name:e[1],type:e[2]})}return t}function c(e){let t=[];for(let n of e.split(`
-`)){let e=/`?([\w-]+)`?\s*[—-]+\[(\w+)\][→>]\s*`?([\w-]+)`?/.exec(n);e&&t.push({fromId:e[1],toId:e[3],type:e[2]})}return t}function l(e){return typeof e==`number`?e:0}function u(e){return typeof e==`number`?e:void 0}function d(e){return typeof e==`string`?e:null}function f(e,t=``){return typeof e==`string`?e:t}function p(e){return typeof e==`string`?e:void 0}function m(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`):[]}export{n as McpKBClient};

package/packages/aikit-client/dist/parsers.d.ts

@@ -1,35 +0,0 @@
-//#region packages/aikit-client/src/parsers.d.ts
-/**
- * Content parsers for MCP tool responses.
- * Used by McpKBClient to parse structuredContent from tool calls.
- */
-interface ParsedContent<T = unknown> {
-  text: string;
-  structured?: T;
-}
-/**
- * Extract text content from an MCP tool result.
- */
-declare function extractText(result: {
-  content?: unknown;
-} | null | undefined): string;
-/**
- * Extract structured content from an MCP tool result.
- */
-declare function extractStructured<T>(result: {
-  structuredContent?: unknown;
-} | null | undefined): T | undefined;
-/**
- * Parse a tool result, returning both text and structured content.
- */
-declare function parseToolResult<T = unknown>(result: {
-  content?: unknown;
-  structuredContent?: unknown;
-} | null | undefined): ParsedContent<T>;
-/**
- * Try to parse JSON from a text tool result.
- * Returns undefined if parsing fails.
- */
-declare function tryParseJson<T = unknown>(text: string): T | undefined;
-//#endregion
-export { ParsedContent, extractStructured, extractText, parseToolResult, tryParseJson };

package/packages/aikit-client/dist/parsers.js

@@ -1,2 +0,0 @@
-function e(e){return!Array.isArray(e?.content)||e.content.length===0?``:e.content.filter(e=>typeof e==`object`&&!!e).filter(e=>e.type===`text`&&typeof e.text==`string`).map(e=>e.text).join(`
-`)}function t(e){return e?.structuredContent}function n(n){return{text:e(n),structured:t(n)}}function r(e){try{return JSON.parse(e)}catch{return}}export{t as extractStructured,e as extractText,n as parseToolResult,r as tryParseJson};

package/packages/aikit-client/dist/types.d.ts

@@ -1,62 +0,0 @@
-//#region packages/aikit-client/src/types.d.ts
-/**
- * IKBClient — Unified data access interface for AI Kit consumers.
- *
- * Implemented by:
- * - DirectKBClient (in-process, used by TUI)
- * - McpKBClient (over MCP transport, used by Dashboard)
- */
-interface KBStatus {
-  totalRecords: number;
-  totalFiles: number;
-  lastIndexedAt: string | null;
-  onboarded: boolean;
-}
-interface KBSearchResult {
-  sourcePath: string;
-  contentType: string;
-  score: number;
-  content: string;
-  headingPath?: string;
-  startLine?: number;
-  endLine?: number;
-}
-interface KBKnowledgeEntry {
-  path: string;
-  title: string;
-  category: string;
-  tags: string[];
-  content: string;
-}
-interface KBGraphData {
-  nodes: Array<{
-    id: string;
-    name: string;
-    type: string;
-    sourcePath?: string;
-  }>;
-  edges: Array<{
-    fromId: string;
-    toId: string;
-    type: string;
-  }>;
-}
-interface IKBClient {
-  /** Get AI Kit status. */
-  getStatus(): Promise<KBStatus>;
-  /** Search AI Kit. */
-  search(query: string, options?: {
-    limit?: number;
-    mode?: 'hybrid' | 'semantic' | 'keyword';
-  }): Promise<KBSearchResult[]>;
-  /** List curated knowledge entries. */
-  listKnowledge(): Promise<KBKnowledgeEntry[]>;
-  /** Read a specific curated entry. */
-  readKnowledge(path: string): Promise<KBKnowledgeEntry | null>;
-  /** Get knowledge graph data. */
-  getGraph(query?: string): Promise<KBGraphData>;
-  /** Get file tree of indexed sources. */
-  getFileTree(): Promise<string[]>;
-}
-//#endregion
-export { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus };

package/packages/aikit-client/dist/types.js

@@ -1 +0,0 @@
-export{};

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

@@ -1,19 +0,0 @@
-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';
-}
-declare class BlastRadiusAnalyzer {
-  readonly name = "blast-radius";
-  private depAnalyzer;
-  analyze(rootPath: string, options: BlastRadiusOptions): Promise<AnalysisResult>;
-  private formatMarkdown;
-}
-//#endregion
-export { BlastRadiusAnalyzer, BlastRadiusOptions };

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

@@ -1,6 +0,0 @@
-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
-`),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};

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

@@ -1,32 +0,0 @@
-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 extractImportsRegex;
-  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 };

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

@@ -1,8 +0,0 @@
-import{readFile as e,readdir as t,stat as n}from"node:fs/promises";import{dirname as r,extname as i,join as a,relative as o,resolve as s}from"node:path";import{SUPPORTED_EXTENSIONS as c,WasmRuntime as l,extractImports as u}from"../../chunker/dist/index.js";const d=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`,`.py`,`.java`,`.go`,`.cs`,`.kt`,`.scala`,`.rb`,`.rs`,`.php`,`.swift`]),f=[{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`}],p=new Set([`node_modules`,`.git`,`dist`,`build`,`coverage`,`.turbo`,`.cache`,`cdk.out`]),m=[/\.(test|spec)\.[jt]sx?$/,/\/__tests__\//,/\/test\//,/\/tests\//],h={".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 g(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 _(e){return m.some(t=>t.test(e))}var v=class{name=`dependencies`;workspacePackages=new Map;async analyze(t,n={}){let{format:r=`markdown`}=n,a=Date.now();this.workspacePackages=await this.buildWorkspaceMap(t);let s=!1;try{await l.ensure(),s=!0}catch{}let d=await this.collectFiles(t),f=[];for(let n of d){let r=await e(n,`utf-8`),a=i(n).toLowerCase(),l=o(t,n).replace(/\\/g,`/`);if(s&&c.has(a)){let e=await u(r,a,l);if(e.length>0)f.push(...e);else{let e=this.extractImportsRegex(r,n,t);f.push(...e)}}else{let e=this.extractImportsRegex(r,n,t);f.push(...e)}}let p=this.groupExternalDeps(f),m=this.groupInternalDeps(f,t),h=this.buildReverseGraph(f,t),g=this.buildTestCoverage(f,t);return{output:r===`json`?JSON.stringify({external:p,internal:m,reverseGraph:h,testCoverage:g},null,2):r===`mermaid`?this.formatMermaid(m):this.formatMarkdown(p,m,t,g),data:{external:p,internal:m,reverseGraph:h,testCoverage:g,totalImports:f.length},meta:{analyzedAt:new Date().toISOString(),scope:t,fileCount:d.length,durationMs:Date.now()-a}}}async collectFiles(e){let r=[],o=async e=>{if(!(await n(e).catch(()=>null))?.isDirectory())return;let s=await t(e,{withFileTypes:!0});for(let t of s){if(p.has(t.name)||t.name.startsWith(`.`))continue;let n=a(e,t.name);t.isDirectory()?await o(n):d.has(i(t.name))&&r.push(n)}};return await o(e),r}extractImportsRegex(e,t,n){let r=[],a=h[i(t).toLowerCase()];for(let i of f){if(i.lang&&i.lang!==a||!i.lang&&a&&a!==`js`)continue;let s=new RegExp(i.regex.source,i.regex.flags),c;for(;(c=s.exec(e))!==null;){let e=c[1],s=g(e,a);r.push({source:e,specifiers:[],filePath:o(n,t).replace(/\\/g,`/`),isExternal:s,confidence:i.confidence})}}return r}groupExternalDeps(e){let t={};for(let n of e){if(!n.isExternal)continue;let e=h[i(n.filePath).toLowerCase()],r;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}r=e.length>=2?e.slice(0,2).join(`.`):e.join(`.`)}else if(e===`python`)r=n.source.split(`.`)[0];else if(e===`go`)r=n.source;else if(e===`csharp`){let e=n.source.split(`.`);r=e.length>=2?e.slice(0,2).join(`.`):n.source}else r=n.source.startsWith(`@`)?n.source.split(`/`).slice(0,2).join(`/`):n.source.split(`/`)[0];t[r]||(t[r]={count:0,confidence:n.confidence,usedBy:new Set}),t[r].count++,t[r].usedBy.add(n.filePath),n.confidence===`high`?t[r].confidence=`high`:n.confidence===`medium`&&t[r].confidence===`low`&&(t[r].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 n={};for(let t of e){let e=r(t.filePath),i=this.resolveImportPath(t.source,e);i&&(n[i]||(n[i]=new Set),n[i].add(t.filePath))}let i={};for(let[e,t]of Object.entries(n))i[e]=[...t];return i}buildTestCoverage(e,t){let n={};for(let t of e){if(!_(t.filePath))continue;let e=r(t.filePath),i=this.resolveImportPath(t.source,e);!i||_(i)||(n[i]||(n[i]=new Set),n[i].add(t.filePath))}let i={};for(let[e,t]of Object.entries(n))i[e]=[...t];return i}resolveImportPath(e,t){if(e.startsWith(`.`))return a(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 i of[`packages`,`functions`,`libs`,`apps`,`cdk`]){let c=a(n,i);try{let i=await t(c,{withFileTypes:!0});for(let t of i)if(!(!t.isDirectory()||p.has(t.name)))try{let i=a(c,t.name,`package.json`),l=JSON.parse(await e(i,`utf-8`));if(l.name){let e=l.main??l.exports?.[`.`]??`src/index.ts`,i=o(n,s(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=>!_(e)&&!r[e.replace(/\\.[jt]sx?$/,``)]);i.push(`
-### Test Coverage Summary
-`),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(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{v as DependencyAnalyzer};

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

@@ -1,16 +0,0 @@
-import { AnalysisResult, DiagramOptions, IAnalyzer } from "./types.js";
-
-//#region packages/analyzers/src/diagram-generator.d.ts
-/**
- * Generates Mermaid diagrams by combining output from other analyzers.
- */
-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 };

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

@@ -1,2 +0,0 @@
-import{DependencyAnalyzer as e}from"./dependency-analyzer.js";import{StructureAnalyzer as t}from"./structure-analyzer.js";import{join as n}from"node:path";import{readFileSync as r,readdirSync as i}from"node:fs";var a=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,a=await this.dependencyAnalyzer.analyze(e,{format:`json`}),o=a.data,s=["```mermaid",`graph TB`],c=(t.children??[]).filter(e=>e.type===`directory`).slice(0,15);for(let e of c){let t=e.name.replace(/[^a-zA-Z0-9]/g,`_`),n=(e.children??[]).filter(e=>e.type===`directory`);if(n.length>0){s.push(`  subgraph ${t}["${e.name}/"]`);for(let e of n.slice(0,12)){let n=`${t}_${e.name.replace(/[^a-zA-Z0-9]/g,`_`)}`,r=Array.isArray(e.children)?e.children.length:0;s.push(`    ${n}["${e.name}/ (${r})"]`)}s.push(`  end`)}else{let n=Array.isArray(e.children)?e.children.length:0;s.push(`  ${t}["${e.name}/ (${n} files)"]`)}}let l=new Set;if(o.internal)for(let[e,t]of Object.entries(o.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}`;l.has(e)||(l.add(e),s.push(`  ${n} --> ${t}`))}}}let u=a.data;if(u.external){let t=new Map;for(let a of[`packages`,`apps`,`libs`,`services`,`functions`])try{for(let o of i(n(e,a),{withFileTypes:!0}))if(o.isDirectory())try{let i=JSON.parse(r(n(e,a,o.name,`package.json`),`utf-8`));i.name&&t.set(i.name,`${a}/${o.name}`)}catch{}}catch{}for(let[e,n]of Object.entries(u.external)){let r=t.get(e);if(!r)continue;let i=r.split(`/`)[0]?.replace(/[^a-zA-Z0-9]/g,`_`),a=Array.isArray(n)?n:n.usedBy;for(let e of a??[]){let t=e.split(`/`)[0]?.replace(/[^a-zA-Z0-9]/g,`_`);if(t&&i&&t!==i){let e=`${t}->${i}`;l.has(e)||(l.add(e),s.push(`  ${t} --> ${i}`))}}}}return s.push("```"),s.join(`
-`)}async generateDependencyDiagram(e){return`\`\`\`mermaid\n${(await this.dependencyAnalyzer.analyze(e,{format:`mermaid`})).output}\n\`\`\``}};export{a as DiagramGenerator};

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

@@ -1,40 +0,0 @@
-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 };

package/packages/analyzers/dist/entry-point-analyzer.js

@@ -1,4 +0,0 @@
-import{access as e,readFile as t,readdir as n,stat as r}from"node:fs/promises";import{extname as i,join as a,relative as o,resolve as s}from"node:path";import{SUPPORTED_EXTENSIONS as c,WasmRuntime as l,detectEntryPoints as u}from"../../chunker/dist/index.js";const d=new Set([`node_modules`,`.git`,`dist`,`build`,`coverage`,`.turbo`,`.cache`,`cdk.out`,`__pycache__`,`.venv`,`target`,`bin`,`obj`,`.gradle`,`venv`,`env`]),f=new Set([`test`,`tests`,`__tests__`,`spec`,`specs`,`test-utils`]),p=[/export\s+const\s+(handler|main)\s*(?::[^=]*)?\s*=/,/export\s+(?:async\s+)?function\s+(handler|main)\s*\(/,/export\s+const\s+(\w+Handler)\s*(?::[^=]*)?\s*=/,/export\s+default\s+app/,/^app\s*=\s*(?:Flask|FastAPI)\s*\(/m,/^urlpatterns\s*=\s*\[/m,/^if\s+__name__\s*==\s*['"]__main__['"]:/m,/public\s+static\s+void\s+main\s*\(\s*String/,/@SpringBootApplication/,/^func\s+main\s*\(\s*\)/m],m=/export\s+(?:default\s+)?class\s+(\w+)\s+extends\s+(?:Construct|Stack|NestedStack|Stage)/,h=[/from\s+['"]vitest['"]/,/from\s+['"]jest['"]/,/from\s+['"]mocha['"]/,/import\s+.*['"]@jest\/globals['"]/,/require\s*\(\s*['"](?:vitest|jest|mocha)['"]\s*\)/],g=[{regex:/SqsEventSource|SQSEvent|sqs/i,trigger:`SQS`},{regex:/SnsEventSource|SNSEvent|sns/i,trigger:`SNS`},{regex:/ApiGateway|APIGatewayEvent|httpApi|restApi/i,trigger:`API Gateway`},{regex:/ScheduleExpression|EventBridgeRule|schedule/i,trigger:`EventBridge Schedule`},{regex:/S3EventSource|S3Event|s3/i,trigger:`S3`},{regex:/DynamoEventSource|DynamoDBStream/i,trigger:`DynamoDB Stream`},{regex:/@RequestMapping|@GetMapping|@PostMapping/i,trigger:`HTTP Endpoint`},{regex:/http\.ListenAndServe|gin\.Default|echo\.New/i,trigger:`HTTP Server`},{regex:/app\.route\(|@app\.get|@app\.post|@router\./i,trigger:`HTTP Route`}];var _=class{name=`entry-points`;async analyze(e,t={}){let n=Date.now(),r=[],i=await this.findWorkspacePackages(e);if(i.length>0)for(let t of i){let n=await this.fromPackageJson(t,e);r.push(...n)}else{let t=await this.fromPackageJson(e,e);r.push(...t)}let a=await this.fromHandlerExports(e);return r.push(...a),{output:this.formatMarkdown(r,e),data:{entryPoints:r,total:r.length},meta:{analyzedAt:new Date().toISOString(),scope:e,fileCount:r.length,durationMs:Date.now()-n}}}async fromPackageJson(n,r){let i=[],s=o(r,n).replace(/\\/g,`/`)||`.`;try{let r=a(n,`package.json`);await e(r);let o=JSON.parse(await t(r,`utf-8`)),c=s===`.`?``:`${s}/`;if(o.main&&i.push({name:o.name?`${o.name}:main`:`main`,type:`main`,filePath:`${c}${o.main}`}),o.bin){let e=typeof o.bin==`string`?{[o.name??`cli`]:o.bin}:o.bin;for(let[t,n]of Object.entries(e))i.push({name:t,type:`cli`,filePath:`${c}${n}`})}if(o.exports){let e=this.parseExportsField(o.exports,o.name??s,c);i.push(...e)}o.scripts?.start&&i.push({name:o.name?`${o.name}:start`:`start`,type:`server`,filePath:o.scripts.start,trigger:`npm start`})}catch{}return i}parseExportsField(e,t,n){let r=[];if(typeof e==`string`)return r.push({name:t,type:`main`,filePath:`${n}${e}`}),r;if(typeof e!=`object`||!e)return r;for(let[i,a]of Object.entries(e)){if(!i.startsWith(`.`))continue;let e=i===`.`?t:`${t}/${i.slice(2)}`,o=this.resolveExportValue(a);o&&r.push({name:e,type:`main`,filePath:`${n}${o}`})}return r}resolveExportValue(e){if(typeof e==`string`)return e;if(typeof e!=`object`||!e)return;let t=e;for(let e of[`import`,`default`,`require`])if(typeof t[e]==`string`)return t[e];for(let e of Object.values(t))if(typeof e==`string`)return e}async findWorkspacePackages(n){let r=[];try{let i=a(n,`pnpm-workspace.yaml`);await e(i);let o=await t(i,`utf-8`),s=this.parsePnpmWorkspaceYaml(o);for(let e of s){let t=await this.expandWorkspaceGlob(n,e);r.push(...t)}if(r.length>0)return r}catch{}try{let e=a(n,`package.json`),i=JSON.parse(await t(e,`utf-8`)),o=Array.isArray(i.workspaces)?i.workspaces:i.workspaces?.packages??[];for(let e of o){let t=await this.expandWorkspaceGlob(n,e);r.push(...t)}}catch{}return r}parsePnpmWorkspaceYaml(e){let t=[],n=!1;for(let r of e.split(`
-`)){let e=r.trim();if(e===`packages:`){n=!0;continue}if(n){if(e.startsWith(`- `))t.push(e.slice(2).replace(/^['"]|['"]$/g,``));else if(e&&!e.startsWith(`#`))break}}return t}async expandWorkspaceGlob(t,r){let i=[],o=r.indexOf(`*`);if(o===-1){let n=s(t,r);try{await e(a(n,`package.json`)),i.push(n)}catch{}return i}let c=s(t,r.slice(0,o));try{let t=await n(c,{withFileTypes:!0});for(let n of t){if(!n.isDirectory()||d.has(n.name))continue;let t=a(c,n.name);try{await e(a(t,`package.json`)),i.push(t)}catch{}}}catch{}return i}async fromHandlerExports(e){let n=[],r=await this.collectFiles(e),a=!1;try{await l.ensure(),a=!0}catch{}for(let s of r)try{let r=await t(s,`utf-8`),l=o(e,s).replace(/\\/g,`/`),d=i(s);if(!l.split(`/`).some(e=>f.has(e))){let e=!1;if(a&&c.has(d)){let t=await u(r,d,l);for(let i of t)i.trigger||(i.type===`cdk-construct`?i.trigger=`CDK Construct`:i.trigger=this.detectTrigger(r)),n.push(i),e=!0}if(!e)for(let t of p){let i=r.match(t);if(i){let t=i[1]??this.inferNameFromFile(l);(t===`handler`||t===`main`)&&(t=this.deriveContextualName(l)??t);let a=/@SpringBootApplication/.test(r)?`HTTP Server`:this.detectTrigger(r);n.push({name:t,type:this.inferEntryType(i[1]??t,l),filePath:l,trigger:a}),e=!0;break}}if(!e){let e=r.match(m);e&&n.push({name:e[1],type:`cdk-construct`,filePath:l,trigger:`CDK Construct`})}}this.isTestFile(l,r)&&n.push({name:this.inferNameFromFile(l),type:`test`,filePath:l,trigger:`Test Suite`})}catch{}return n}isTestFile(e,t){return/\.(test|spec)\.[jt]sx?$/.test(e)?h.some(e=>e.test(t)):!1}inferNameFromFile(e){return(e.split(/[/\\]/).pop()??`default`).replace(/\.\w+$/,``)}deriveContextualName(e){let t=e.split(`/`).filter(e=>e!==`src`&&e!==`lib`);if(t.pop(),t.length===0)return;let n=t.filter(e=>![`services`,`functions`,`lambdas`,`handlers`,`packages`,`apps`].includes(e));if(n.length===0)return;let r=n.slice(-2);return r.length===2&&r[1].startsWith(r[0])?r[1]:r.join(`-`)}inferEntryType(e,t){return e===`handler`||e===`main`||t.includes(`handler`)||/functions[/]/.test(t)||e.endsWith(`Handler`)?`lambda-handler`:(t.endsWith(`.py`)||t.endsWith(`.go`)||t.endsWith(`.java`),`main`)}detectTrigger(e){for(let t of g)if(t.regex.test(e))return t.trigger}async collectFiles(e){let t=[],o=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.java`,`.py`,`.go`,`.cs`,`.kt`,`.rb`,`.rs`,`.php`,`.swift`]),s=async(e,c)=>{if(c>10||!(await r(e).catch(()=>null))?.isDirectory())return;let l=await n(e,{withFileTypes:!0});for(let n of l){if(d.has(n.name)||n.name.startsWith(`.`))continue;let r=a(e,n.name);n.isDirectory()?await s(r,c+1):o.has(i(n.name))&&t.push(r)}};return await s(e,0),t}formatMarkdown(e,t){let n=[];if(n.push(`## Entry Points: ${t}\n`),n.push(`**${e.length} entry ${e.length===1?`point`:`points`}** found\n`),e.length===0)return n.push(`No entry points detected.`),n.join(`
-`);let r=new Map;for(let t of e){let e=r.get(t.type)??[];e.push(t),r.set(t.type,e)}let i=[`lambda-handler`,`main`,`server`,`cli`,`bin`,`cdk-construct`,`test`],a=[...r.entries()].sort((e,t)=>i.indexOf(e[0])-i.indexOf(t[0]));n.push(`| Name | Type | File | Trigger |`),n.push(`|------|------|------|---------|`);for(let[,e]of a)for(let t of e)n.push(`| ${t.name} | ${t.type} | ${t.filePath} | ${t.trigger??`—`} |`);return n.join(`
-`)}};export{_ as EntryPointAnalyzer};

package/packages/analyzers/dist/knowledge-producer.d.ts

@@ -1,40 +0,0 @@
-import { ExtractionBaselines } from "./types.js";
-import { DependencyAnalyzer } from "./dependency-analyzer.js";
-import { DiagramGenerator } from "./diagram-generator.js";
-import { EntryPointAnalyzer } from "./entry-point-analyzer.js";
-import { PatternAnalyzer } from "./pattern-analyzer.js";
-import { StructureAnalyzer } from "./structure-analyzer.js";
-import { SymbolAnalyzer } from "./symbol-analyzer.js";
-
-//#region packages/analyzers/src/knowledge-producer.d.ts
-interface Analyzers {
-  structure: StructureAnalyzer;
-  dependencies: DependencyAnalyzer;
-  symbols: SymbolAnalyzer;
-  patterns: PatternAnalyzer;
-  entryPoints: EntryPointAnalyzer;
-  diagrams: DiagramGenerator;
-}
-/**
- * Orchestrates Tier 1 deterministic extraction and prepares
- * synthesis instructions for the LLM to produce knowledge.
- */
-declare class KnowledgeProducer {
-  private readonly analyzers;
-  constructor(analyzers: Analyzers);
-  /**
-   * Run Tier 1 deterministic extraction for specified aspects.
-   */
-  runExtraction(scope: string, aspects: string[]): Promise<ExtractionBaselines>;
-  /**
-   * Build synthesis instructions from baselines for the LLM.
-   */
-  buildSynthesisInstructions(baselines: ExtractionBaselines, _aspects: string[]): string;
-  /**
-   * Build cross-references between baselines (symbols ↔ entry-points ↔ patterns).
-   * Helps the LLM see connections across independently generated sections.
-   */
-  private buildCrossReferences;
-}
-//#endregion
-export { Analyzers, KnowledgeProducer };

package/packages/analyzers/dist/knowledge-producer.js

@@ -1,26 +0,0 @@
-const e={structure:`structure`,dependencies:`dependencies`,symbols:`symbols`,patterns:`patterns`,"entry-points":`entryPoints`,diagrams:`diagrams`},t=Object.keys(e);var n=class{constructor(e){this.analyzers=e}async runExtraction(n,r){let i=r.includes(`all`)?t:r,a={},o=[];for(let t of i){let r=e[t];if(!r)continue;let i=this.analyzers[r];i&&(t===`diagrams`?o.push({key:`diagrams`,promise:i.analyze(n,{diagramType:`architecture`})}):o.push({key:t,promise:i.analyze(n)}))}let s=await Promise.allSettled(o.map(async e=>({key:e.key,result:await e.promise})));for(let e of s){if(e.status!==`fulfilled`)continue;let{key:t,result:n}=e.value;t===`diagrams`?a.diagrams=[n]:a[t]=n}return a}buildSynthesisInstructions(e,t){let n=[];if(n.push(`## Knowledge Production Results
-`),n.push(`### Extraction Baselines (auto-generated)
-`),e.structure&&(n.push(`#### File Structure
-`),n.push(e.structure.output),n.push(``)),e.dependencies&&(n.push(`#### Dependencies
-`),n.push(e.dependencies.output),n.push(``)),e.symbols&&(n.push(`#### Symbols
-`),n.push(e.symbols.output),n.push(``)),e.patterns&&(n.push(`#### Detected Patterns
-`),n.push(e.patterns.output),n.push(``)),e.entryPoints&&(n.push(`#### Entry Points
-`),n.push(e.entryPoints.output),n.push(``)),e.diagrams&&e.diagrams.length>0){n.push(`#### Architecture Diagram
-`);for(let t of e.diagrams)n.push(t.output);n.push(``)}let r=this.buildCrossReferences(e);if(r.length>0){n.push(`#### Cross-References
-`),n.push(`_Connections between baselines to aid synthesis:_
-`);for(let e of r)n.push(`- ${e}`);n.push(``)}return n.push(`### Your Task: Synthesize Knowledge
-`),n.push(`Based on the baselines above and your reading of the source files, produce`),n.push("the following knowledge documents using `aikit_remember`:\n"),n.push(`1. **Domain Overview** (category: \`architecture\`)
-   - What this service does, boundary with other services
-   - Key entities and their lifecycle
-`),n.push(`2. **Architecture Summary** (category: \`architecture\`)
-   - Layer structure, dependency flow
-   - Key design decisions
-`),n.push(`3. **Pattern Usage** (category: \`patterns\`)
-   - Which patterns are used and why
-   - Where to find examples
-`),n.push(`4. **Conventions** (category: \`conventions\`)
-   - Naming conventions observed
-   - File organization rules
-   - Testing patterns
-`),n.push("Store each as a separate `aikit_remember` call with descriptive titles.\n"),n.join(`
-`)}buildCrossReferences(e){let t=[],n=new Set;if(e.symbols?.output)for(let t of e.symbols.output.matchAll(/`(\w+)`\s*\((?:function|class|interface|type|const|enum)\)/g))n.add(t[1]);let r=new Set;if(e.entryPoints?.output)for(let t of e.entryPoints.output.matchAll(/`(\w+)`.*?(?:handler|main|server|cli|test|construct)/gi))r.add(t[1]);for(let e of r)n.has(e)&&t.push(`Entry point \`${e}\` is also listed in symbols — check its call graph for downstream dependencies`);if(e.patterns?.output&&n.size>0){for(let r of[`Singleton`,`Factory`,`Observer`,`Builder`,`Strategy`,`Middleware`,`Repository`])if(e.patterns.output.includes(r)){let i=e.patterns.output.split(r)[1]?.slice(0,200)??``;for(let e of n)if(i.includes(e)){t.push(`Symbol \`${e}\` uses the ${r} pattern`);break}}}return t}};export{n as KnowledgeProducer};

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

@@ -1,15 +0,0 @@
-import { AnalysisResult, AnalyzerOptions, IAnalyzer } from "./types.js";
-
-//#region packages/analyzers/src/pattern-analyzer.d.ts
-declare class PatternAnalyzer implements IAnalyzer<AnalyzerOptions> {
-  readonly name = "patterns";
-  analyze(rootPath: string, _options?: AnalyzerOptions): Promise<AnalysisResult>;
-  private collectDirectories;
-  private collectCodeFiles;
-  private detectDirectoryPatterns;
-  private detectCodePatterns;
-  private detectConfigPatterns;
-  private formatMarkdown;
-}
-//#endregion
-export { PatternAnalyzer };