@vpxa/aikit 0.1.59 → 0.1.60

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

@@ -1,6 +1,6 @@
 ---
 name: aikit
-description: "Use the @vpxa/aikit AI Kit MCP server for codebase search, analysis, and persistent memory. Load this skill when using aikit_search, aikit_remember, aikit_analyze_*, or any aikit_* tool. Covers all 67 MCP tools: search (hybrid/semantic/keyword), code analysis (structure, dependencies, symbols, patterns, entry points, diagrams, blast radius), knowledge graph (auto-populated module/symbol/import graph with traversal), context management (worksets, stash, checkpoints, restore, lanes), code manipulation (rename, codemod, eval), knowledge management (remember/read/update/forget), web access (fetch, search, http), FORGE protocol (ground, classify, evidence map, stratum cards, digest), brainstorming (interactive ideation sessions), presentation (rich dashboards via present tool), onboarding (full codebase analysis in one call), and developer utilities (regex, encode, measure, changelog, schema-validate, snippet, env, time)."
+description: "Use the @vpxa/aikit AI Kit MCP server for codebase search, analysis, and persistent memory. Load this skill when using aikit_search, aikit_remember, aikit_analyze_*, or any aikit_* tool. Covers all 82 MCP tools: search (hybrid/semantic/keyword), code analysis (structure, dependencies, symbols, patterns, entry points, diagrams, blast radius), knowledge graph (auto-populated module/symbol/import graph with traversal), context management (worksets, stash, checkpoints, restore, lanes), code manipulation (rename, codemod, eval), knowledge management (remember/read/update/forget), web access (fetch, search, http), FORGE protocol (ground, classify, evidence map, stratum cards, digest), brainstorming (interactive ideation sessions), presentation (rich dashboards via present tool), onboarding (full codebase analysis in one call), and developer utilities (regex, encode, measure, changelog, schema-validate, snippet, env, time)."
 metadata:
   category: cross-cutting
   domain: general
@@ -12,7 +12,7 @@ metadata:
 
 # @vpxa/aikit — AI Kit
 
-Local-first AI developer toolkit — 67 MCP tools for search, analysis, context compression, FORGE quality gates, knowledge management, code manipulation, execution, web access, brainstorming, presentation, and developer utilities.
+Local-first AI developer toolkit — 82 MCP tools for search, analysis, context compression, FORGE quality gates, knowledge management, code manipulation, execution, web access, brainstorming, presentation, and developer utilities.
 
 ## When to Use
 
@@ -37,7 +37,7 @@ Local-first AI developer toolkit — 67 MCP tools for search, analysis, context
 core → store → embeddings → chunker → indexer → analyzers → tools → server → cli → tui
 ```
 
-- **MCP server**: 67 tools + 2 resources (via `@modelcontextprotocol/sdk`)
+- **MCP server**: 82 tools + 2 resources (via `@modelcontextprotocol/sdk`)
 - **CLI**: 45 commands (thin dispatcher + 10 command groups)
 - **Search**: Hybrid vector + keyword + RRF fusion
 - **Embeddings**: ONNX local (mxbai-embed-large-v1, 1024 dimensions)
@@ -68,10 +68,11 @@ remember                                         (capture insights)
 
 ### End of Session
 ```
+session_digest({ persist: true })                              # Auto-capture session activity
 remember({ title: "Session checkpoint: <topic>", content: "<what was done, decisions made, next steps>", category: "conventions" })
 ```
 
-## Tool Catalog (67 tools)
+## Tool Catalog (82 tools)
 
 ### Search & Discovery (8)
 | Tool | CLI | Purpose |
@@ -176,9 +177,10 @@ Lane actions: `create` (copy files to lane), `list`, `status` (modified/added/de
 | `stratum_card` | — | Generate T1/T2 compressed context cards from files (10-100x token reduction) |
 | `digest` | — | Compress N text sources into token-budgeted summary |
 
-### System (8)
+### System (9)
 | Tool | CLI | Purpose |
 |------|-----|---------|
+| `config` | `aikit config` | View or update project configuration (kb.config.json) |
 | `status` | `aikit status` | Index statistics |
 | `reindex` | `aikit reindex` | Rebuild index |
 | `health` | `aikit health` | Project health checks (package.json, tsconfig, lockfile, circular deps) |
@@ -188,7 +190,7 @@ Lane actions: `create` (copy files to lane), `list`, `status` (modified/added/de
 | `queue` | `aikit queue` | Task queue for sequential agent operations (create/push/next/done/fail) |
 | `replay` | `aikit replay` | View or clear the audit trail of tool invocations (action: list/clear) |
 
-### Flows (7)
+### Flows (10)
 | Tool | CLI | Purpose |
 |------|-----|---------|
 | `flow_list` | `aikit flow list` | List available flows |
@@ -198,6 +200,9 @@ Lane actions: `create` (copy files to lane), `list`, `status` (modified/added/de
 | `flow_status` | `aikit flow status` | Check if a flow is active and view the current step |
 | `flow_read_instruction` | `aikit flow read-instruction` | Read the current step's instruction file content directly |
 | `flow_reset` | `aikit flow reset` | Clear flow state to start over |
+| `flow_add` | `aikit flow add` | Add a custom flow from a directory |
+| `flow_update` | `aikit flow update` | Update an existing custom flow |
+| `flow_remove` | `aikit flow remove` | Remove a custom flow |
 
 ### Presentation (1)
 | Tool | CLI | Purpose |
@@ -209,6 +214,18 @@ Lane actions: `create` (copy files to lane), `list`, `status` (modified/added/de
 |------|-----|---------|
 | `brainstorm` | — | Interactive brainstorming and ideation sessions with structured output |
 
+### Meta-Tools — Tool Discovery (3)
+| Tool | CLI | Purpose |
+|------|-----|---------|
+| `list_tools` | — | List all active AI Kit tools with names, titles, and categories. Accepts optional `category` filter. Use for initial tool discovery. |
+| `describe_tool` | — | Get detailed metadata for a specific tool (title, categories, annotations). Use after `list_tools` to understand a tool before calling it. |
+| `search_tools` | — | Search active tools by keyword across names, titles, and categories. Use when you know what you need but not the tool name. |
+
+### Session Management (1)
+| Tool | CLI | Purpose |
+|------|-----|---------|
+| `session_digest` | — | Generate a compressed digest of session activity (replay log, stash, checkpoints). Options: `scope` (tools/stash/all), `since`, `last`, `focus`, `mode` (deterministic/sampling), `tokenBudget`, `persist`. Use at session end for handoff or mid-session to review what happened. |
+
 ## Flow System
 
 Flows are multi-step guided workflows that structure complex tasks. Each step has a skill file with detailed instructions, required artifacts, and agent assignments.
@@ -235,6 +252,14 @@ flow_status()                        # Check progress
 flow_reset()                         # Clear state, start over
 ```
 
+Custom flow lifecycle management:
+
+```text
+flow_add({ source: ".github/flows/my-flow" })
+flow_update({ name: "my-flow" })
+flow_remove({ name: "my-flow" })
+```
+
 ### Creating Custom Flows
 
 1. Create a directory under `.github/flows/<flow-name>/`
@@ -541,10 +566,46 @@ aikit reindex       # Rebuild index
   "indexing": { "chunkSize": 1500, "chunkOverlap": 200, "minChunkSize": 100, "concurrency": 5 },
   "embedding": { "model": "mixedbread-ai/mxbai-embed-large-v1", "dimensions": 1024 },
   "store": { "backend": "lancedb", "path": ".aikit-data" },
-  "curated": { "path": "curated" }
+  "curated": { "path": "curated", "adapter": "filesystem" }
+}
+```
+
+## Tool Profiles
+
+Tool profiles control which subset of the 82 tools are active. Profiles reduce token overhead by exposing only relevant tools for a given task.
+
+### Built-in Profiles
+
+| Profile | Description | Use When |
+|---------|-------------|----------|
+| `full` | All tools enabled (default) | General development, orchestration |
+| `safe` | Read-only tools — no file/state modifications | Code review, analysis, research |
+| `research` | Search, analysis, knowledge, web access | Investigation, documentation |
+| `minimal` | Essential tools only — search, check, test | Simple tasks, low-token budgets |
+| `discovery` | Full toolset + meta-tools for guided exploration | New users, onboarding, tool learning |
+
+### Activating a Profile
+
+Set `toolProfile` in `kb.config.json`:
+
+```json
+{
+  "toolProfile": "research"
 }
 ```
 
+Base tools (`status`, `config`, `guide`, `health`) are **always available** regardless of profile.
+
+### Meta-Tool Discovery Pattern (Token Cost Reduction)
+
+Instead of loading all 82 tool descriptions at session start, use the `discovery` profile:
+
+1. `list_tools()` — get a compact list of tool names + categories (~50 tokens)
+2. `search_tools({ query: "what I need" })` — find relevant tools by keyword
+3. `describe_tool({ tool_name: "specific_tool" })` — get full metadata only for tools you'll use
+
+This pattern reduces initial tool-loading cost from ~3000 tokens to ~200 tokens.
+
 ## IDE Integration
 
 ### VS Code — HTTP mode (recommended for development)
@@ -626,6 +687,9 @@ Flows are structured multi-step workflows that guide agents through complex task
 | `flow_step` | Advance: `next`, `skip`, or `redo` current step |
 | `flow_read_instruction` | Read the current step's instruction file content directly |
 | `flow_reset` | Clear flow state to start over |
+| `flow_add` | Add a custom flow from a directory |
+| `flow_update` | Update an existing custom flow |
+| `flow_remove` | Remove a custom flow |
 
 ### Flow Selection
 

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 };

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

@@ -1,2 +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}from"node:path";import{SUPPORTED_EXTENSIONS as s,WasmRuntime as c,detectPatterns as l}from"../../chunker/dist/index.js";const u=new Set([`node_modules`,`.git`,`dist`,`build`,`coverage`,`.turbo`,`.cache`,`cdk.out`,`__pycache__`,`.venv`,`target`,`bin`,`obj`,`.gradle`,`venv`,`env`]),d=[{dirs:[`adapters`,`ports`],pattern:`Hexagonal Architecture`,description:`Ports & adapters (hexagonal) separation`},{dirs:[`domain`,`infrastructure`,`application`],pattern:`Clean Architecture`,description:`Layered with domain/infrastructure separation`},{dirs:[`controllers`,`models`],pattern:`MVC Pattern`,description:`Model-View-Controller structure`},{dirs:[`repositories`],pattern:`Repository Pattern`,description:`Data access abstraction via repositories`},{dirs:[`factories`],pattern:`Factory Pattern`,description:`Object creation via factories`},{dirs:[`handlers`],pattern:`Handler Pattern`,description:`Event/request handler separation`},{dirs:[`middleware`],pattern:`Middleware Pattern`,description:`Request pipeline middleware`},{dirs:[`hooks`],pattern:`React Hooks`,description:`Custom React hooks for logic reuse`},{dirs:[`components`],pattern:`Component Architecture`,description:`UI component-based structure`},{dirs:[`stacks`,`constructs`],pattern:`CDK IaC`,description:`AWS CDK infrastructure as code`},{dirs:[`lambdas`,`functions`],pattern:`Serverless`,description:`Serverless function architecture`}];function f(e){if(e.length<=3)return e;let t=new Map;for(let n of e){let e=n.split(`/`),r=e.length>1?e.slice(0,-1).join(`/`):`.`,i=t.get(r);i?i.push(n):t.set(r,[n])}let n=[];for(let[e,r]of t)r.length>=3?n.push(`${e}/ (${r.length} files)`):n.push(...r);return n.slice(0,5)}const p=[{regex:/container\.register|@injectable|@inject/i,pattern:`Dependency Injection`,description:`IoC container or DI decorators`},{regex:/\.pipe\(|Observable|BehaviorSubject/i,pattern:`Reactive (RxJS)`,description:`Reactive programming with observables`,lang:`js`},{regex:/createContext|useContext/i,pattern:`React Context`,description:`React Context API for state sharing`,lang:`js`},{regex:/createSlice|configureStore/i,pattern:`Redux Toolkit`,description:`Redux state management`,lang:`js`},{regex:/defineStore|usePinia/i,pattern:`Pinia Store`,description:`Vue Pinia state management`,lang:`js`},{regex:/\.(test|spec)\.[jt]sx?|describe\s*\(|\bit\s*\([\s'"]/i,pattern:`Test Suite`,description:`Unit/integration test files`},{regex:/@SpringBootApplication|@EnableAutoConfiguration/,pattern:`Spring Boot`,description:`Spring Boot application framework`,lang:`java`,definitive:!0},{regex:/@Autowired|@Component|@Service|@Repository|@Controller/,pattern:`Spring DI`,description:`Spring dependency injection`,lang:`java`},{regex:/@RestController|@RequestMapping|@GetMapping|@PostMapping/,pattern:`Spring REST`,description:`Spring REST API controllers`,lang:`java`},{regex:/app\s*=\s*Flask\s*\(|@app\.route/,pattern:`Flask`,description:`Flask web framework`,lang:`python`},{regex:/app\s*=\s*FastAPI\s*\(|@app\.get|@app\.post/,pattern:`FastAPI`,description:`FastAPI web framework`,lang:`python`},{regex:/func\s+main\s*\(\s*\)|http\.ListenAndServe/,pattern:`Go Application`,description:`Go main application`,lang:`go`},{regex:/export\s+(?:async\s+)?function\s+create[A-Z]\w+/,pattern:`Factory`,description:`Object creation via create*() functions`,lang:`js`},{regex:/(?:export\s+)?function\s+wrap[A-Z]\w+/,pattern:`Wrapper/Decorator`,description:`Higher-order function wrapping`,lang:`js`},{regex:/(?:const|let)\s+\w+\s*=\s*new\s+(?:Map|WeakMap)\s*[<(]/,pattern:`Singleton Cache`,description:`Module-level cache with lazy initialization`,lang:`js`},{regex:/Record<string,\s*(?:\w+)?Handler>|\.(?:get|post|put|delete)\s*\(/,pattern:`Router/Dispatcher`,description:`Request routing/dispatch table`,lang:`js`},{regex:/export\s+(?:default\s+)?class\s+\w+\s+extends\s+(?:Construct|Stack|NestedStack|Stage)/,pattern:`CDK Construct`,description:`AWS CDK infrastructure construct`,lang:`js`,definitive:!0}];var m=class{name=`patterns`;async analyze(e,t={}){let n=Date.now(),r=await this.collectDirectories(e),i=this.detectDirectoryPatterns(r,e),a=await this.collectCodeFiles(e),o=await this.detectCodePatterns(a,e),s=[...i,...o],c=await this.detectConfigPatterns(e),l=c.find(e=>e.pattern===`Maven`||e.pattern===`Gradle`||e.pattern===`Gradle (Kotlin DSL)`||e.pattern===`Node.js Project`||e.pattern===`Go Module`||e.pattern===`Rust (Cargo)`),u=new Set([`Ruby (Bundler)`,`PHP (Composer)`,`Swift Package`,`SBT`]);for(let e of c)l&&u.has(e.pattern)||s.push(e);return{output:this.formatMarkdown(s,e),data:{patterns:s,total:s.length},meta:{analyzedAt:new Date().toISOString(),scope:e,fileCount:a.length,durationMs:Date.now()-n}}}async collectDirectories(e){let t=[],i=async(e,o)=>{if(o>5||!(await r(e).catch(()=>null))?.isDirectory())return;let s=await n(e,{withFileTypes:!0});for(let n of s){if(!n.isDirectory()||u.has(n.name)||n.name.startsWith(`.`))continue;let r=a(e,n.name);t.push(n.name),await i(r,o+1)}};return await i(e,0),t}async collectCodeFiles(e){let t=[],r=new Set([`.ts`,`.tsx`,`.js`,`.jsx`,`.java`,`.py`,`.go`,`.cs`,`.kt`,`.scala`,`.rb`,`.rs`,`.php`,`.swift`]),o=async e=>{let s=await n(e,{withFileTypes:!0});for(let n of s){if(u.has(n.name)||n.name.startsWith(`.`))continue;let s=a(e,n.name);n.isDirectory()?await o(s):r.has(i(n.name))&&t.push(s)}};return await o(e),t}detectDirectoryPatterns(e,t){let n=new Set(e.map(e=>e.toLowerCase())),r=[];for(let e of d){let t=e.dirs.filter(e=>n.has(e));t.length!==0&&(e.dirs.length>1&&t.length<2||r.push({pattern:e.pattern,description:e.description,locations:t.map(e=>`${e}/`),confidence:t.length===e.dirs.length?`high`:`medium`}))}return r}async detectCodePatterns(e,n){let r=[],a={},u=!1;try{await c.ensure(),u=!0}catch{}let d=e.filter(e=>/Application\.\w+$|Main\.\w+$|app\.\w+$|main\.\w+$/i.test(e)||/Controller|Service|Handler|Router/i.test(e)),m=e.filter(e=>!d.includes(e)),h=[...d.slice(0,50),...m.slice(0,150)];for(let e of h)try{let r=await t(e,`utf-8`),c=i(e).toLowerCase(),d=o(n,e).replace(/\\/g,`/`);if(/analyzers\/src\//.test(d))continue;if(u&&s.has(c)){let e=await l(r,c,d);for(let t of e){a[t.pattern]||(a[t.pattern]=new Set);for(let e of t.locations)a[t.pattern].add(e)}}let f=c===`.java`||c===`.kt`||c===`.scala`?`java`:c===`.py`?`python`:c===`.go`?`go`:`js`;for(let e of p)e.lang&&e.lang!==f||e.regex.test(r)&&(a[e.pattern]||(a[e.pattern]=new Set),a[e.pattern].add(d))}catch{}for(let e of p){let t=a[e.pattern];if(t&&t.size>0){let n=f([...t]);r.push({pattern:e.pattern,description:e.description,locations:n,confidence:e.definitive||t.size>=3?`high`:t.size>=2?`medium`:`low`})}}let g=new Set(p.map(e=>e.pattern));for(let[e,t]of Object.entries(a)){if(g.has(e)||t.size===0)continue;let n=f([...t]);r.push({pattern:e,description:`Detected via AST analysis`,locations:n,confidence:t.size>=3?`high`:t.size>=2?`medium`:`low`})}return r}async detectConfigPatterns(t){let n=[];for(let r of[{file:`Dockerfile`,pattern:`Docker`,description:`Containerized application`},{file:`docker-compose.yml`,pattern:`Docker Compose`,description:`Container orchestration`},{file:`cdk.json`,pattern:`AWS CDK`,description:`AWS CDK infrastructure as code`},{file:`terraform.tf`,pattern:`Terraform`,description:`Terraform IaC`},{file:`main.tf`,pattern:`Terraform`,description:`Terraform IaC`}])try{await e(a(t,r.file)),n.push({pattern:r.pattern,description:r.description,locations:[r.file],confidence:`high`})}catch{}return n}formatMarkdown(e,t){let n=[];n.push(`## Patterns Detected: ${t}\n`),n.push(`**${e.length} patterns** found\n`);let r={high:[],medium:[],low:[]};for(let t of e)r[t.confidence].push(t);for(let[e,t]of Object.entries(r))if(t.length!==0){n.push(`### ${e.charAt(0).toUpperCase()+e.slice(1)} Confidence\n`);for(let e of t)n.push(`- **${e.pattern}**: ${e.description}`),n.push(`  Locations: ${e.locations.slice(0,5).join(`, `)}`);n.push(``)}return n.join(`
-`)}};export{m as PatternAnalyzer};