kirograph 0.27.1 → 0.28.0

package/dist/index.js

@@ -74,7 +74,7 @@ class KiroGraph {
     await kg.vectors.initialize(onModelProgress);
     return kg;
   }
-  static async open(projectRoot, onModelProgress) {
+  static async open(projectRoot, onModelProgress, opts) {
     const resolved = path.resolve(projectRoot);
     (0, import_utils.validateProjectPath)(resolved);
     if (!fs.existsSync(path.join(resolved, KIROGRAPH_DIR))) {
@@ -83,7 +83,9 @@ class KiroGraph {
     const cfg = await (0, import_config.loadConfig)(resolved);
     const db = new import_database.GraphDatabase(resolved);
     const kg = new KiroGraph(resolved, db, cfg);
-    await kg.vectors.initialize(onModelProgress);
+    if (!opts?.skipVectors) {
+      await kg.vectors.initialize(onModelProgress);
+    }
     return kg;
   }
   static isInitialized(projectRoot) {

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["/**\n * KiroGraph \u2014 Semantic code knowledge graph for Kiro\n *\n * Pure facade. Every method delegates to a focused sub-system.\n * No business logic lives here.\n */\n\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { GraphDatabase } from './db/database';\nimport { validatePathWithinRoot, validateProjectPath } from './utils';\nimport { loadConfig, createDefaultConfig, saveConfig } from './config';\nimport type { KiroGraphConfig } from './config';\nimport { GraphQueryManager } from './graph/queries';\nimport { ReferenceResolver } from './resolution/index';\nimport { VectorManager } from './vectors/index';\nimport { ContextBuilder } from './context/index';\nimport { ArchitectureAnalyzer } from './architecture/index';\nimport { LockManager } from './core/lock-manager';\nimport { IndexPipeline } from './core/pipeline';\nimport { buildFileTree } from './core/file-tree';\nimport { SnapshotManager } from './core/snapshot';\nimport { Searcher } from './search/searcher';\nimport type { FileTreeNode, FileTree } from './core/file-tree';\nimport type { GraphSnapshot, GraphDiff } from './core/snapshot';\n\nexport type { GraphSnapshot, GraphDiff };\nimport type {\n  Node, Edge, NodeKind, IndexResult, IndexProgress, SyncResult, TaskContext,\n  SearchResult, SearchOptions, NodeContext, NodeMetrics,\n} from './types';\nimport type { ArchitectureResult } from './architecture/types';\n\nexport type { FileTreeNode, FileTree };\n\nconst KIROGRAPH_DIR = '.kirograph';\n\nexport default class KiroGraph {\n  private readonly db: GraphDatabase;\n  private readonly config: KiroGraphConfig;\n  private readonly projectRoot: string;\n  private readonly queryManager: GraphQueryManager;\n  private readonly resolver: ReferenceResolver;\n  private readonly vectors: VectorManager;\n  private readonly contextBuilder: ContextBuilder;\n  private readonly arch: ArchitectureAnalyzer;\n  private readonly lock: LockManager;\n  private readonly pipeline: IndexPipeline;\n  private readonly searcher: Searcher;\n\n  private constructor(projectRoot: string, db: GraphDatabase, config: KiroGraphConfig) {\n    this.projectRoot = projectRoot;\n    this.db = db;\n    this.config = config;\n    this.queryManager = new GraphQueryManager(db);\n    this.resolver = new ReferenceResolver(db, config, projectRoot);\n    this.vectors = new VectorManager(db, config, projectRoot);\n    this.contextBuilder = new ContextBuilder(db, this.resolver, this.vectors, projectRoot);\n    this.arch = new ArchitectureAnalyzer(db, config, projectRoot);\n    this.lock = new LockManager(projectRoot);\n    this.pipeline = new IndexPipeline(db, this.vectors, this.resolver, this.arch, this.lock, config, projectRoot);\n    this.searcher = new Searcher(db);\n  }\n\n  // \u2500\u2500 Factory \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  static async init(\n    projectRoot: string,\n    config?: Partial<KiroGraphConfig>,\n    onModelProgress?: (file: string, loaded: number, total: number, done: boolean) => void,\n  ): Promise<KiroGraph> {\n    const resolved = path.resolve(projectRoot);\n    validateProjectPath(resolved);\n    fs.mkdirSync(path.join(resolved, KIROGRAPH_DIR), { recursive: true });\n    const cfg = { ...createDefaultConfig(resolved), ...config };\n    await saveConfig(resolved, cfg);\n    const db = new GraphDatabase(resolved);\n    const kg = new KiroGraph(resolved, db, cfg);\n    await kg.vectors.initialize(onModelProgress);\n    return kg;\n  }\n\n  static async open(\n    projectRoot: string,\n    onModelProgress?: (file: string, loaded: number, total: number, done: boolean) => void,\n  ): Promise<KiroGraph> {\n    const resolved = path.resolve(projectRoot);\n    validateProjectPath(resolved);\n    if (!fs.existsSync(path.join(resolved, KIROGRAPH_DIR))) {\n      throw new Error(`KiroGraph not initialized at ${resolved}. Run: kirograph init`);\n    }\n    const cfg = await loadConfig(resolved);\n    const db = new GraphDatabase(resolved);\n    const kg = new KiroGraph(resolved, db, cfg);\n    await kg.vectors.initialize(onModelProgress);\n    return kg;\n  }\n\n  static isInitialized(projectRoot: string): boolean {\n    return fs.existsSync(path.join(path.resolve(projectRoot), KIROGRAPH_DIR));\n  }\n\n  // \u2500\u2500 Lock / dirty marker \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  unlockForce(): void { this.lock.forceRelease(); }\n  markDirty(): void { this.lock.markDirty(); }\n  clearDirty(): void { this.lock.clearDirty(); }\n  isDirty(): boolean { return this.lock.isDirty(); }\n  isIndexLocked(): boolean { return this.lock.isLocked(); }\n\n  async syncIfDirty(): Promise<SyncResult | null> {\n    if (!this.isDirty()) return null;\n    return this.sync();\n  }\n\n  /**\n   * Returns the number of files that have changed on disk but are not yet\n   * reflected in the index. Used by the MCP status tool to warn the agent\n   * when the index may be stale.\n   */\n  async getPendingSyncCount(): Promise<number> {\n    try {\n      const { getChangedFiles, scanDirectory } = await Promise.resolve().then(() => require('./sync/index.js'));\n      const gitChanged = await getChangedFiles(this.projectRoot, this.config);\n      const hasGitChanges =\n        gitChanged.added.length > 0 ||\n        gitChanged.modified.length > 0 ||\n        gitChanged.removed.length > 0;\n\n      if (hasGitChanges) {\n        return gitChanged.added.length + gitChanged.modified.length + gitChanged.removed.length;\n      }\n\n      // Fallback: compare indexed set vs current filesystem set\n      const indexed = new Set(this.db.getAllFiles().map((f: { path: string }) => f.path));\n      const current = new Set(\n        (await scanDirectory(this.projectRoot, this.config))\n          .map(f => require('path').relative(this.projectRoot, f).replace(/\\\\/g, '/'))\n      );\n      let pending = 0;\n      for (const p of indexed) { if (!current.has(p)) pending++; }\n      for (const p of current) { if (!indexed.has(p)) pending++; }\n      return pending;\n    } catch {\n      return 0;\n    }\n  }\n\n  // \u2500\u2500 Indexing \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  async indexAll(opts?: { onProgress?: (p: IndexProgress) => void; force?: boolean; signal?: AbortSignal }): Promise<IndexResult> {\n    return this.pipeline.indexAll(opts);\n  }\n\n  async sync(changedFilesOrOpts?: string[] | { files?: string[]; onProgress?: (p: IndexProgress) => void }): Promise<SyncResult> {\n    if (Array.isArray(changedFilesOrOpts)) {\n      return this.pipeline.sync({ changedFiles: changedFilesOrOpts });\n    }\n    return this.pipeline.sync({\n      changedFiles: changedFilesOrOpts?.files,\n      onProgress: changedFilesOrOpts?.onProgress,\n    });\n  }\n\n  // \u2500\u2500 Symbol search \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  searchNodes(query: string, kindOrOpts?: NodeKind | SearchOptions, limit = 20): SearchResult[] {\n    return this.searcher.search(query, kindOrOpts, limit);\n  }\n\n  // \u2500\u2500 Graph queries \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  async getCallers(nodeId: string, limit = 30): Promise<Node[]> { return this.queryManager.getCallers(nodeId, limit); }\n  async getCallees(nodeId: string, limit = 30): Promise<Node[]> { return this.queryManager.getCallees(nodeId, limit); }\n  async getImpactRadius(nodeId: string, depth = 2): Promise<Node[]> { return this.queryManager.getImpactRadius(nodeId, depth); }\n  getAllNodes(): Node[] { return this.db.getAllNodes(); }\n  getAllEdges(): Edge[] { return this.db.getAllEdges(); }\n  findDeadCode(limit = 50): Node[] { return this.db.findDeadCode(limit); }\n  findCircularDependencies(): string[][] { return this.db.findCircularDependencies(); }\n  async findPath(fromId: string, toId: string, maxDepth = 10): Promise<Node[]> { return this.queryManager.findPath(fromId, toId, maxDepth); }\n  getTypeHierarchy(nodeId: string, direction: 'up' | 'down' | 'both' = 'both'): Node[] { return this.db.getTypeHierarchy(nodeId, direction); }\n  getNode(id: string): Node | null { return this.db.getNode(id); }\n  getNodeContext(nodeId: string): NodeContext | null { return this.db.getNodeContext(nodeId); }\n  getNodeMetrics(nodeId: string): NodeMetrics { return this.db.getNodeMetrics(nodeId); }\n\n  getNodeSource(node: Node): string | null {\n    const absPath = validatePathWithinRoot(path.join(this.projectRoot, node.filePath), this.projectRoot);\n    if (!absPath) return null;\n    try {\n      return fs.readFileSync(absPath, 'utf8').split('\\n').slice(node.startLine - 1, node.endLine).join('\\n');\n    } catch { return null; }\n  }\n\n  // \u2500\u2500 Context building \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  async buildContext(task: string, opts?: { maxNodes?: number; includeCode?: boolean }): Promise<TaskContext> {\n    return this.contextBuilder.buildTaskContext(task, opts);\n  }\n\n  // \u2500\u2500 File browsing \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getFiles(opts?: { filterPath?: string; pattern?: string; maxDepth?: number }): FileTree {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const picomatch = opts?.pattern ? require('picomatch')(opts.pattern) : null;\n    const filtered = this.db.getAllFiles().filter(f => {\n      if (opts?.filterPath && !f.path.startsWith(opts.filterPath)) return false;\n      if (picomatch && !picomatch(f.path)) return false;\n      return true;\n    });\n    return buildFileTree(filtered, opts?.maxDepth);\n  }\n\n  getAffectedTests(changedFiles: string[], opts?: { depth?: number; testPattern?: string }): string[] {\n    return this.queryManager.getAffectedTests(changedFiles, opts);\n  }\n\n  // \u2500\u2500 Graph insights \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  findHotspots(limit = 20): Array<Node & { degree: number; inDegree: number; outDegree: number }> {\n    return this.db.findHotspots(limit);\n  }\n\n  findSurprisingConnections(limit = 20): Array<{ source: Node; target: Node; kind: string; score: number }> {\n    return this.db.findSurprisingConnections(limit);\n  }\n\n  // \u2500\u2500 Snapshots \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  createSnapshotManager(): SnapshotManager {\n    return new SnapshotManager(this.db, this.projectRoot);\n  }\n\n  // \u2500\u2500 Stats \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  async getStats() {\n    const stats = this.db.getStats();\n    const vecIndexCount = await this.vectors.vecIndexCount();\n    const embeddingCount = vecIndexCount > 0 ? vecIndexCount : stats.embeddingCount;\n    const EMBEDDABLE = ['function', 'method', 'class', 'interface', 'type_alias', 'component', 'module'];\n    const embeddableNodeCount = EMBEDDABLE.reduce((sum, k) => sum + (stats.nodesByKind[k] ?? 0), 0);\n    const pendingFiles = await this.getPendingSyncCount();\n    const syncRunning = this.isIndexLocked();\n    return {\n      ...stats,\n      embeddingCount,\n      embeddableNodeCount,\n      embeddingsEnabled: this.config.enableEmbeddings ?? false,\n      embeddingModel: this.config.embeddingModel,\n      useVecIndex: this.config.useVecIndex ?? false,\n      semanticEngine: this.config.semanticEngine ?? 'cosine',\n      turbovecBits: this.config.turbovecBits,\n      vecIndexCount,\n      engineFallback: this.vectors.getEngineFallback(),\n      frameworks: this.config.frameworkHints ?? [],\n      architectureEnabled: this.config.enableArchitecture ?? false,\n      ...(this.config.enableArchitecture ? { architectureStats: this.db.getArchStats() } : {}),\n      pendingFiles,\n      syncRunning,\n      syncWarningThreshold: this.config.syncWarningThreshold ?? 10,\n    };\n  }\n\n  getEngineFallback(): string | null { return this.vectors.getEngineFallback(); }\n\n  // \u2500\u2500 Architecture API \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getArchitecture(): ArchitectureResult & {\n    filePackages: Record<string, string[]>;\n    fileLayers: Record<string, Array<{ layerId: string; confidence: number; matchedPattern: string }>>;\n  } {\n    const base = this.db.getArchitectureResult();\n\n    const filePackages: Record<string, string[]> = {};\n    for (const { filePath, packageId } of this.db.getArchFilePackages()) {\n      if (!filePackages[filePath]) filePackages[filePath] = [];\n      filePackages[filePath].push(packageId);\n    }\n\n    const fileLayers: Record<string, Array<{ layerId: string; confidence: number; matchedPattern: string }>> = {};\n    for (const row of this.db.getArchFileLayers()) {\n      if (!fileLayers[row.filePath]) fileLayers[row.filePath] = [];\n      fileLayers[row.filePath].push({ layerId: row.layerId, confidence: row.confidence, matchedPattern: row.matchedPattern });\n    }\n\n    return { ...base, filePackages, fileLayers };\n  }\n\n  isArchitectureEnabled(): boolean { return this.config.enableArchitecture ?? false; }\n\n  // \u2500\u2500 Misc \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getProjectRoot(): string { return this.projectRoot; }\n\n  getDatabase(): GraphDatabase { return this.db; }\n\n  close(): void {\n    this.vectors.close();\n    this.lock.release();\n    this.db.close();\n  }\n}\n\n// \u2500\u2500 Module-level helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/** Walk up directories to find the nearest .kirograph/ folder. */\nexport function findNearestKiroGraphRoot(startPath: string): string | null {\n  let current = path.resolve(startPath);\n  while (true) {\n    if (fs.existsSync(path.join(current, KIROGRAPH_DIR))) return current;\n    const parent = path.dirname(current);\n    if (parent === current) return null;\n    current = parent;\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * KiroGraph \u2014 Semantic code knowledge graph for Kiro\n *\n * Pure facade. Every method delegates to a focused sub-system.\n * No business logic lives here.\n */\n\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { GraphDatabase } from './db/database';\nimport { validatePathWithinRoot, validateProjectPath } from './utils';\nimport { loadConfig, createDefaultConfig, saveConfig } from './config';\nimport type { KiroGraphConfig } from './config';\nimport { GraphQueryManager } from './graph/queries';\nimport { ReferenceResolver } from './resolution/index';\nimport { VectorManager } from './vectors/index';\nimport { ContextBuilder } from './context/index';\nimport { ArchitectureAnalyzer } from './architecture/index';\nimport { LockManager } from './core/lock-manager';\nimport { IndexPipeline } from './core/pipeline';\nimport { buildFileTree } from './core/file-tree';\nimport { SnapshotManager } from './core/snapshot';\nimport { Searcher } from './search/searcher';\nimport type { FileTreeNode, FileTree } from './core/file-tree';\nimport type { GraphSnapshot, GraphDiff } from './core/snapshot';\n\nexport type { GraphSnapshot, GraphDiff };\nimport type {\n  Node, Edge, NodeKind, IndexResult, IndexProgress, SyncResult, TaskContext,\n  SearchResult, SearchOptions, NodeContext, NodeMetrics,\n} from './types';\nimport type { ArchitectureResult } from './architecture/types';\n\nexport type { FileTreeNode, FileTree };\n\nconst KIROGRAPH_DIR = '.kirograph';\n\nexport default class KiroGraph {\n  private readonly db: GraphDatabase;\n  private readonly config: KiroGraphConfig;\n  private readonly projectRoot: string;\n  private readonly queryManager: GraphQueryManager;\n  private readonly resolver: ReferenceResolver;\n  private readonly vectors: VectorManager;\n  private readonly contextBuilder: ContextBuilder;\n  private readonly arch: ArchitectureAnalyzer;\n  private readonly lock: LockManager;\n  private readonly pipeline: IndexPipeline;\n  private readonly searcher: Searcher;\n\n  private constructor(projectRoot: string, db: GraphDatabase, config: KiroGraphConfig) {\n    this.projectRoot = projectRoot;\n    this.db = db;\n    this.config = config;\n    this.queryManager = new GraphQueryManager(db);\n    this.resolver = new ReferenceResolver(db, config, projectRoot);\n    this.vectors = new VectorManager(db, config, projectRoot);\n    this.contextBuilder = new ContextBuilder(db, this.resolver, this.vectors, projectRoot);\n    this.arch = new ArchitectureAnalyzer(db, config, projectRoot);\n    this.lock = new LockManager(projectRoot);\n    this.pipeline = new IndexPipeline(db, this.vectors, this.resolver, this.arch, this.lock, config, projectRoot);\n    this.searcher = new Searcher(db);\n  }\n\n  // \u2500\u2500 Factory \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  static async init(\n    projectRoot: string,\n    config?: Partial<KiroGraphConfig>,\n    onModelProgress?: (file: string, loaded: number, total: number, done: boolean) => void,\n  ): Promise<KiroGraph> {\n    const resolved = path.resolve(projectRoot);\n    validateProjectPath(resolved);\n    fs.mkdirSync(path.join(resolved, KIROGRAPH_DIR), { recursive: true });\n    const cfg = { ...createDefaultConfig(resolved), ...config };\n    await saveConfig(resolved, cfg);\n    const db = new GraphDatabase(resolved);\n    const kg = new KiroGraph(resolved, db, cfg);\n    await kg.vectors.initialize(onModelProgress);\n    return kg;\n  }\n\n  static async open(\n    projectRoot: string,\n    onModelProgress?: (file: string, loaded: number, total: number, done: boolean) => void,\n    opts?: { skipVectors?: boolean },\n  ): Promise<KiroGraph> {\n    const resolved = path.resolve(projectRoot);\n    validateProjectPath(resolved);\n    if (!fs.existsSync(path.join(resolved, KIROGRAPH_DIR))) {\n      throw new Error(`KiroGraph not initialized at ${resolved}. Run: kirograph init`);\n    }\n    const cfg = await loadConfig(resolved);\n    const db = new GraphDatabase(resolved);\n    const kg = new KiroGraph(resolved, db, cfg);\n    if (!opts?.skipVectors) {\n      await kg.vectors.initialize(onModelProgress);\n    }\n    return kg;\n  }\n\n  static isInitialized(projectRoot: string): boolean {\n    return fs.existsSync(path.join(path.resolve(projectRoot), KIROGRAPH_DIR));\n  }\n\n  // \u2500\u2500 Lock / dirty marker \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  unlockForce(): void { this.lock.forceRelease(); }\n  markDirty(): void { this.lock.markDirty(); }\n  clearDirty(): void { this.lock.clearDirty(); }\n  isDirty(): boolean { return this.lock.isDirty(); }\n  isIndexLocked(): boolean { return this.lock.isLocked(); }\n\n  async syncIfDirty(): Promise<SyncResult | null> {\n    if (!this.isDirty()) return null;\n    return this.sync();\n  }\n\n  /**\n   * Returns the number of files that have changed on disk but are not yet\n   * reflected in the index. Used by the MCP status tool to warn the agent\n   * when the index may be stale.\n   */\n  async getPendingSyncCount(): Promise<number> {\n    try {\n      const { getChangedFiles, scanDirectory } = await Promise.resolve().then(() => require('./sync/index.js'));\n      const gitChanged = await getChangedFiles(this.projectRoot, this.config);\n      const hasGitChanges =\n        gitChanged.added.length > 0 ||\n        gitChanged.modified.length > 0 ||\n        gitChanged.removed.length > 0;\n\n      if (hasGitChanges) {\n        return gitChanged.added.length + gitChanged.modified.length + gitChanged.removed.length;\n      }\n\n      // Fallback: compare indexed set vs current filesystem set\n      const indexed = new Set(this.db.getAllFiles().map((f: { path: string }) => f.path));\n      const current = new Set(\n        (await scanDirectory(this.projectRoot, this.config))\n          .map(f => require('path').relative(this.projectRoot, f).replace(/\\\\/g, '/'))\n      );\n      let pending = 0;\n      for (const p of indexed) { if (!current.has(p)) pending++; }\n      for (const p of current) { if (!indexed.has(p)) pending++; }\n      return pending;\n    } catch {\n      return 0;\n    }\n  }\n\n  // \u2500\u2500 Indexing \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  async indexAll(opts?: { onProgress?: (p: IndexProgress) => void; force?: boolean; signal?: AbortSignal }): Promise<IndexResult> {\n    return this.pipeline.indexAll(opts);\n  }\n\n  async sync(changedFilesOrOpts?: string[] | { files?: string[]; onProgress?: (p: IndexProgress) => void }): Promise<SyncResult> {\n    if (Array.isArray(changedFilesOrOpts)) {\n      return this.pipeline.sync({ changedFiles: changedFilesOrOpts });\n    }\n    return this.pipeline.sync({\n      changedFiles: changedFilesOrOpts?.files,\n      onProgress: changedFilesOrOpts?.onProgress,\n    });\n  }\n\n  // \u2500\u2500 Symbol search \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  searchNodes(query: string, kindOrOpts?: NodeKind | SearchOptions, limit = 20): SearchResult[] {\n    return this.searcher.search(query, kindOrOpts, limit);\n  }\n\n  // \u2500\u2500 Graph queries \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  async getCallers(nodeId: string, limit = 30): Promise<Node[]> { return this.queryManager.getCallers(nodeId, limit); }\n  async getCallees(nodeId: string, limit = 30): Promise<Node[]> { return this.queryManager.getCallees(nodeId, limit); }\n  async getImpactRadius(nodeId: string, depth = 2): Promise<Node[]> { return this.queryManager.getImpactRadius(nodeId, depth); }\n  getAllNodes(): Node[] { return this.db.getAllNodes(); }\n  getAllEdges(): Edge[] { return this.db.getAllEdges(); }\n  findDeadCode(limit = 50): Node[] { return this.db.findDeadCode(limit); }\n  findCircularDependencies(): string[][] { return this.db.findCircularDependencies(); }\n  async findPath(fromId: string, toId: string, maxDepth = 10): Promise<Node[]> { return this.queryManager.findPath(fromId, toId, maxDepth); }\n  getTypeHierarchy(nodeId: string, direction: 'up' | 'down' | 'both' = 'both'): Node[] { return this.db.getTypeHierarchy(nodeId, direction); }\n  getNode(id: string): Node | null { return this.db.getNode(id); }\n  getNodeContext(nodeId: string): NodeContext | null { return this.db.getNodeContext(nodeId); }\n  getNodeMetrics(nodeId: string): NodeMetrics { return this.db.getNodeMetrics(nodeId); }\n\n  getNodeSource(node: Node): string | null {\n    const absPath = validatePathWithinRoot(path.join(this.projectRoot, node.filePath), this.projectRoot);\n    if (!absPath) return null;\n    try {\n      return fs.readFileSync(absPath, 'utf8').split('\\n').slice(node.startLine - 1, node.endLine).join('\\n');\n    } catch { return null; }\n  }\n\n  // \u2500\u2500 Context building \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  async buildContext(task: string, opts?: { maxNodes?: number; includeCode?: boolean }): Promise<TaskContext> {\n    return this.contextBuilder.buildTaskContext(task, opts);\n  }\n\n  // \u2500\u2500 File browsing \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getFiles(opts?: { filterPath?: string; pattern?: string; maxDepth?: number }): FileTree {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const picomatch = opts?.pattern ? require('picomatch')(opts.pattern) : null;\n    const filtered = this.db.getAllFiles().filter(f => {\n      if (opts?.filterPath && !f.path.startsWith(opts.filterPath)) return false;\n      if (picomatch && !picomatch(f.path)) return false;\n      return true;\n    });\n    return buildFileTree(filtered, opts?.maxDepth);\n  }\n\n  getAffectedTests(changedFiles: string[], opts?: { depth?: number; testPattern?: string }): string[] {\n    return this.queryManager.getAffectedTests(changedFiles, opts);\n  }\n\n  // \u2500\u2500 Graph insights \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  findHotspots(limit = 20): Array<Node & { degree: number; inDegree: number; outDegree: number }> {\n    return this.db.findHotspots(limit);\n  }\n\n  findSurprisingConnections(limit = 20): Array<{ source: Node; target: Node; kind: string; score: number }> {\n    return this.db.findSurprisingConnections(limit);\n  }\n\n  // \u2500\u2500 Snapshots \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  createSnapshotManager(): SnapshotManager {\n    return new SnapshotManager(this.db, this.projectRoot);\n  }\n\n  // \u2500\u2500 Stats \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  async getStats() {\n    const stats = this.db.getStats();\n    const vecIndexCount = await this.vectors.vecIndexCount();\n    const embeddingCount = vecIndexCount > 0 ? vecIndexCount : stats.embeddingCount;\n    const EMBEDDABLE = ['function', 'method', 'class', 'interface', 'type_alias', 'component', 'module'];\n    const embeddableNodeCount = EMBEDDABLE.reduce((sum, k) => sum + (stats.nodesByKind[k] ?? 0), 0);\n    const pendingFiles = await this.getPendingSyncCount();\n    const syncRunning = this.isIndexLocked();\n    return {\n      ...stats,\n      embeddingCount,\n      embeddableNodeCount,\n      embeddingsEnabled: this.config.enableEmbeddings ?? false,\n      embeddingModel: this.config.embeddingModel,\n      useVecIndex: this.config.useVecIndex ?? false,\n      semanticEngine: this.config.semanticEngine ?? 'cosine',\n      turbovecBits: this.config.turbovecBits,\n      vecIndexCount,\n      engineFallback: this.vectors.getEngineFallback(),\n      frameworks: this.config.frameworkHints ?? [],\n      architectureEnabled: this.config.enableArchitecture ?? false,\n      ...(this.config.enableArchitecture ? { architectureStats: this.db.getArchStats() } : {}),\n      pendingFiles,\n      syncRunning,\n      syncWarningThreshold: this.config.syncWarningThreshold ?? 10,\n    };\n  }\n\n  getEngineFallback(): string | null { return this.vectors.getEngineFallback(); }\n\n  // \u2500\u2500 Architecture API \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getArchitecture(): ArchitectureResult & {\n    filePackages: Record<string, string[]>;\n    fileLayers: Record<string, Array<{ layerId: string; confidence: number; matchedPattern: string }>>;\n  } {\n    const base = this.db.getArchitectureResult();\n\n    const filePackages: Record<string, string[]> = {};\n    for (const { filePath, packageId } of this.db.getArchFilePackages()) {\n      if (!filePackages[filePath]) filePackages[filePath] = [];\n      filePackages[filePath].push(packageId);\n    }\n\n    const fileLayers: Record<string, Array<{ layerId: string; confidence: number; matchedPattern: string }>> = {};\n    for (const row of this.db.getArchFileLayers()) {\n      if (!fileLayers[row.filePath]) fileLayers[row.filePath] = [];\n      fileLayers[row.filePath].push({ layerId: row.layerId, confidence: row.confidence, matchedPattern: row.matchedPattern });\n    }\n\n    return { ...base, filePackages, fileLayers };\n  }\n\n  isArchitectureEnabled(): boolean { return this.config.enableArchitecture ?? false; }\n\n  // \u2500\u2500 Misc \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getProjectRoot(): string { return this.projectRoot; }\n\n  getDatabase(): GraphDatabase { return this.db; }\n\n  close(): void {\n    this.vectors.close();\n    this.lock.release();\n    this.db.close();\n  }\n}\n\n// \u2500\u2500 Module-level helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/** Walk up directories to find the nearest .kirograph/ folder. */\nexport function findNearestKiroGraphRoot(startPath: string): string | null {\n  let current = path.resolve(startPath);\n  while (true) {\n    if (fs.existsSync(path.join(current, KIROGRAPH_DIR))) return current;\n    const parent = path.dirname(current);\n    if (parent === current) return null;\n    current = parent;\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/mcp/cache.js

@@ -71,7 +71,7 @@ class FileReadCache {
       existing.lastRead = Date.now();
       existing.readCount++;
       return {
-        content: `[cached: unchanged since ${this.formatTimestamp(existing.lastRead)}] (${existing.readCount} reads)`,
+        content: `[cached: file unchanged \u2014 use kirograph_retrieve to get full content, or noCache:true to force re-read]`,
         cached: true,
         changed: false
       };

package/dist/mcp/cache.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/mcp/cache.ts"],
-  "sourcesContent": ["/**\n * KiroGraph File Read Cache\n *\n * In-memory, session-scoped file cache. First read returns full content,\n * subsequent reads of unchanged files return a compact \"cached\" marker (~13 tokens).\n * Uses content hashing (SHA-256) to detect changes.\n */\n\nimport * as fs from 'fs';\nimport * as crypto from 'crypto';\n\nexport interface CacheEntry {\n  contentHash: string;\n  content: string;\n  lastRead: number;\n  readCount: number;\n}\n\nexport interface CacheStats {\n  entries: number;\n  hits: number;\n  misses: number;\n  hitRate: number;\n}\n\nexport interface ReadResult {\n  content: string;\n  cached: boolean;\n  changed: boolean;\n  /** Previous content (for diff mode) */\n  previousContent?: string;\n}\n\nexport class FileReadCache {\n  private cache = new Map<string, CacheEntry>();\n  private hits = 0;\n  private misses = 0;\n\n  /**\n   * Read a file with caching. Returns full content on first read or if changed,\n   * returns a compact marker if unchanged since last read.\n   */\n  read(filePath: string, noCache = false): ReadResult {\n    let content: string;\n    try {\n      content = fs.readFileSync(filePath, 'utf8');\n    } catch (err: any) {\n      throw new Error(`Cannot read file: ${err.message}`);\n    }\n\n    if (noCache) {\n      const hash = this.hashContent(content);\n      const previous = this.cache.get(filePath);\n      this.cache.set(filePath, {\n        contentHash: hash,\n        content,\n        lastRead: Date.now(),\n        readCount: (previous?.readCount ?? 0) + 1,\n      });\n      this.misses++;\n      return { content, cached: false, changed: false };\n    }\n\n    const hash = this.hashContent(content);\n    const existing = this.cache.get(filePath);\n\n    if (existing && existing.contentHash === hash) {\n      // Cache hit \u2014 file unchanged\n      this.hits++;\n      existing.lastRead = Date.now();\n      existing.readCount++;\n      return {\n        content: `[cached: unchanged since ${this.formatTimestamp(existing.lastRead)}] (${existing.readCount} reads)`,\n        cached: true,\n        changed: false,\n      };\n    }\n\n    // Cache miss or file changed\n    this.misses++;\n    const previousContent = existing?.content;\n    this.cache.set(filePath, {\n      contentHash: hash,\n      content,\n      lastRead: Date.now(),\n      readCount: (existing?.readCount ?? 0) + 1,\n    });\n\n    if (existing) {\n      // File changed since last read\n      return { content, cached: false, changed: true, previousContent };\n    }\n\n    // First read\n    return { content, cached: false, changed: false };\n  }\n\n  /**\n   * Get the previously cached content for a file (used by diff mode).\n   */\n  getPreviousContent(filePath: string): string | undefined {\n    return this.cache.get(filePath)?.content;\n  }\n\n  /**\n   * Check if a file is in the cache.\n   */\n  has(filePath: string): boolean {\n    return this.cache.has(filePath);\n  }\n\n  /**\n   * Invalidate cache entries for specific files (e.g., after sync).\n   */\n  invalidate(filePaths: string[]): void {\n    for (const fp of filePaths) {\n      this.cache.delete(fp);\n    }\n  }\n\n  /**\n   * Clear all cached entries.\n   */\n  clear(): void {\n    this.cache.clear();\n    this.hits = 0;\n    this.misses = 0;\n  }\n\n  /**\n   * Get cache statistics.\n   */\n  getStats(): CacheStats {\n    const total = this.hits + this.misses;\n    return {\n      entries: this.cache.size,\n      hits: this.hits,\n      misses: this.misses,\n      hitRate: total > 0 ? Math.round((this.hits / total) * 100) : 0,\n    };\n  }\n\n  /**\n   * List all cached file paths with their metadata.\n   */\n  listEntries(): Array<{ path: string; readCount: number; lastRead: number }> {\n    return [...this.cache.entries()].map(([p, e]) => ({\n      path: p,\n      readCount: e.readCount,\n      lastRead: e.lastRead,\n    }));\n  }\n\n  private hashContent(content: string): string {\n    return crypto.createHash('sha256').update(content).digest('hex');\n  }\n\n  private formatTimestamp(ts: number): string {\n    const diff = Date.now() - ts;\n    const seconds = Math.floor(diff / 1000);\n    if (seconds < 60) return `${seconds}s ago`;\n    const minutes = Math.floor(seconds / 60);\n    if (minutes < 60) return `${minutes}m ago`;\n    const hours = Math.floor(minutes / 60);\n    return `${hours}h ago`;\n  }\n}\n\n// Singleton instance \u2014 session-scoped (lives as long as the MCP server process)\nlet _instance: FileReadCache | null = null;\n\nexport function getFileReadCache(): FileReadCache {\n  if (!_instance) {\n    _instance = new FileReadCache();\n  }\n  return _instance;\n}\n\nexport function resetFileReadCache(): void {\n  _instance?.clear();\n  _instance = null;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * KiroGraph File Read Cache\n *\n * In-memory, session-scoped file cache. First read returns full content,\n * subsequent reads of unchanged files return a compact \"cached\" marker (~13 tokens).\n * Uses content hashing (SHA-256) to detect changes.\n */\n\nimport * as fs from 'fs';\nimport * as crypto from 'crypto';\n\nexport interface CacheEntry {\n  contentHash: string;\n  content: string;\n  lastRead: number;\n  readCount: number;\n}\n\nexport interface CacheStats {\n  entries: number;\n  hits: number;\n  misses: number;\n  hitRate: number;\n}\n\nexport interface ReadResult {\n  content: string;\n  cached: boolean;\n  changed: boolean;\n  /** Previous content (for diff mode) */\n  previousContent?: string;\n}\n\nexport class FileReadCache {\n  private cache = new Map<string, CacheEntry>();\n  private hits = 0;\n  private misses = 0;\n\n  /**\n   * Read a file with caching. Returns full content on first read or if changed,\n   * returns a compact marker if unchanged since last read.\n   */\n  read(filePath: string, noCache = false): ReadResult {\n    let content: string;\n    try {\n      content = fs.readFileSync(filePath, 'utf8');\n    } catch (err: any) {\n      throw new Error(`Cannot read file: ${err.message}`);\n    }\n\n    if (noCache) {\n      const hash = this.hashContent(content);\n      const previous = this.cache.get(filePath);\n      this.cache.set(filePath, {\n        contentHash: hash,\n        content,\n        lastRead: Date.now(),\n        readCount: (previous?.readCount ?? 0) + 1,\n      });\n      this.misses++;\n      return { content, cached: false, changed: false };\n    }\n\n    const hash = this.hashContent(content);\n    const existing = this.cache.get(filePath);\n\n    if (existing && existing.contentHash === hash) {\n      // Cache hit \u2014 file unchanged\n      this.hits++;\n      existing.lastRead = Date.now();\n      existing.readCount++;\n      return {\n        content: `[cached: file unchanged \u2014 use kirograph_retrieve to get full content, or noCache:true to force re-read]`,\n        cached: true,\n        changed: false,\n      };\n    }\n\n    // Cache miss or file changed\n    this.misses++;\n    const previousContent = existing?.content;\n    this.cache.set(filePath, {\n      contentHash: hash,\n      content,\n      lastRead: Date.now(),\n      readCount: (existing?.readCount ?? 0) + 1,\n    });\n\n    if (existing) {\n      // File changed since last read\n      return { content, cached: false, changed: true, previousContent };\n    }\n\n    // First read\n    return { content, cached: false, changed: false };\n  }\n\n  /**\n   * Get the previously cached content for a file (used by diff mode).\n   */\n  getPreviousContent(filePath: string): string | undefined {\n    return this.cache.get(filePath)?.content;\n  }\n\n  /**\n   * Check if a file is in the cache.\n   */\n  has(filePath: string): boolean {\n    return this.cache.has(filePath);\n  }\n\n  /**\n   * Invalidate cache entries for specific files (e.g., after sync).\n   */\n  invalidate(filePaths: string[]): void {\n    for (const fp of filePaths) {\n      this.cache.delete(fp);\n    }\n  }\n\n  /**\n   * Clear all cached entries.\n   */\n  clear(): void {\n    this.cache.clear();\n    this.hits = 0;\n    this.misses = 0;\n  }\n\n  /**\n   * Get cache statistics.\n   */\n  getStats(): CacheStats {\n    const total = this.hits + this.misses;\n    return {\n      entries: this.cache.size,\n      hits: this.hits,\n      misses: this.misses,\n      hitRate: total > 0 ? Math.round((this.hits / total) * 100) : 0,\n    };\n  }\n\n  /**\n   * List all cached file paths with their metadata.\n   */\n  listEntries(): Array<{ path: string; readCount: number; lastRead: number }> {\n    return [...this.cache.entries()].map(([p, e]) => ({\n      path: p,\n      readCount: e.readCount,\n      lastRead: e.lastRead,\n    }));\n  }\n\n  private hashContent(content: string): string {\n    return crypto.createHash('sha256').update(content).digest('hex');\n  }\n\n  private formatTimestamp(ts: number): string {\n    const diff = Date.now() - ts;\n    const seconds = Math.floor(diff / 1000);\n    if (seconds < 60) return `${seconds}s ago`;\n    const minutes = Math.floor(seconds / 60);\n    if (minutes < 60) return `${minutes}m ago`;\n    const hours = Math.floor(minutes / 60);\n    return `${hours}h ago`;\n  }\n}\n\n// Singleton instance \u2014 session-scoped (lives as long as the MCP server process)\nlet _instance: FileReadCache | null = null;\n\nexport function getFileReadCache(): FileReadCache {\n  if (!_instance) {\n    _instance = new FileReadCache();\n  }\n  return _instance;\n}\n\nexport function resetFileReadCache(): void {\n  _instance?.clear();\n  _instance = null;\n}\n"],
+  "mappings": "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",
   "names": ["hash"]
 }

package/dist/mcp/handler.js

@@ -0,0 +1,446 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var handler_exports = {};
+__export(handler_exports, {
+  ToolHandler: () => ToolHandler
+});
+module.exports = __toCommonJS(handler_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_child_process = require("child_process");
+var import__ = __toESM(require("../index"));
+var import_errors = require("../errors");
+var import_compression = require("../compression/index");
+var import_tracker = require("../compression/tracker");
+var import_utils = require("./handlers/utils");
+var import_core = require("./handlers/core");
+var import_code_health = require("./handlers/code-health");
+var import_architecture = require("./handlers/architecture");
+var import_edit_primitives = require("./handlers/edit-primitives");
+var import_git_context = require("./handlers/git-context");
+var import_complexity = require("./handlers/complexity");
+var import_memory = require("./handlers/memory");
+var import_docs = require("./handlers/docs");
+var import_data = require("./handlers/data");
+var import_watchmen = require("./handlers/watchmen");
+var import_security = require("./handlers/security");
+var import_patterns = require("./handlers/patterns");
+var import_wiki = require("./handlers/wiki");
+var import_branch = require("./handlers/branch");
+const CORE_TOOLS = /* @__PURE__ */ new Set([
+  "kirograph_search",
+  "kirograph_context",
+  "kirograph_callers",
+  "kirograph_callees",
+  "kirograph_impact",
+  "kirograph_node",
+  "kirograph_status",
+  "kirograph_files",
+  "kirograph_affected"
+]);
+const CODE_HEALTH_TOOLS = /* @__PURE__ */ new Set([
+  "kirograph_dead_code",
+  "kirograph_circular_deps",
+  "kirograph_path",
+  "kirograph_type_hierarchy",
+  "kirograph_hotspots",
+  "kirograph_surprising",
+  "kirograph_diff",
+  "kirograph_snapshot_save",
+  "kirograph_snapshot_list",
+  "kirograph_module_api",
+  "kirograph_rename_preview",
+  "kirograph_doc_coverage",
+  "kirograph_god_class",
+  "kirograph_inheritance_depth",
+  "kirograph_recursion",
+  "kirograph_largest",
+  "kirograph_rank",
+  "kirograph_distribution",
+  "kirograph_annotations",
+  "kirograph_session_start",
+  "kirograph_session_end",
+  "kirograph_unused_imports",
+  "kirograph_gini",
+  "kirograph_dependency_depth"
+]);
+const ARCHITECTURE_TOOLS = /* @__PURE__ */ new Set([
+  "kirograph_architecture",
+  "kirograph_coupling",
+  "kirograph_package",
+  "kirograph_communities",
+  "kirograph_manifest"
+]);
+const GIT_CONTEXT_TOOLS = /* @__PURE__ */ new Set([
+  "kirograph_flows",
+  "kirograph_diff_context",
+  "kirograph_commit_context",
+  "kirograph_pr_context",
+  "kirograph_changelog",
+  "kirograph_test_map",
+  "kirograph_test_coverage"
+]);
+const COMPLEXITY_TOOLS = /* @__PURE__ */ new Set([
+  "kirograph_complexity",
+  "kirograph_simplify_scan",
+  "kirograph_health",
+  "kirograph_dsm",
+  "kirograph_test_risk"
+]);
+const BRANCH_TOOLS = /* @__PURE__ */ new Set(["kirograph_branch_list", "kirograph_branch_diff", "kirograph_branch_search"]);
+const EDIT_PRIMITIVES_TOOLS = /* @__PURE__ */ new Set([
+  "kirograph_refactor",
+  "kirograph_str_replace",
+  "kirograph_multi_str_replace",
+  "kirograph_insert_at",
+  "kirograph_ast_grep_rewrite"
+]);
+const SECURITY_TOOLS = /* @__PURE__ */ new Set([
+  "kirograph_security",
+  "kirograph_vulns",
+  "kirograph_vuln_add",
+  "kirograph_vuln_suppress",
+  "kirograph_sbom",
+  "kirograph_vex",
+  "kirograph_reachability",
+  "kirograph_staleness",
+  "kirograph_licenses",
+  "kirograph_attack_surface",
+  "kirograph_secrets",
+  "kirograph_security_flows",
+  "kirograph_supply_chain",
+  "kirograph_dep_confusion",
+  "kirograph_remediation"
+]);
+const PATTERNS_TOOLS = /* @__PURE__ */ new Set([
+  "kirograph_live_search",
+  "kirograph_pattern_coverage",
+  "kirograph_pattern_save_baseline",
+  "kirograph_pattern_diff"
+]);
+const WATCHMEN_TOOLS = /* @__PURE__ */ new Set([
+  "kirograph_watchmen_status",
+  "kirograph_watchmen_synthesize",
+  "kirograph_watchmen_reset"
+]);
+class ToolHandler {
+  constructor(cg) {
+    this.connections = /* @__PURE__ */ new Map();
+    this.defaultCg = cg;
+  }
+  setDefaultKiroGraph(cg) {
+    this.defaultCg = cg;
+  }
+  /** Close all cached cross-project connections. */
+  closeAll() {
+    for (const cg of this.connections.values()) {
+      try {
+        cg.close();
+      } catch {
+      }
+    }
+    this.connections.clear();
+  }
+  async getConnection(projectPath) {
+    if (!projectPath) return this.defaultCg;
+    const resolved = import_path.default.resolve(projectPath);
+    if (!import_path.default.isAbsolute(resolved)) return null;
+    if (this.connections.has(resolved)) return this.connections.get(resolved);
+    try {
+      const cg = await import__.default.open(resolved);
+      this.connections.set(resolved, cg);
+      return cg;
+    } catch {
+      return null;
+    }
+  }
+  async handle(toolName, args) {
+    try {
+      const text = await this.dispatch(toolName, args);
+      const truncated = (0, import_utils.truncate)(text);
+      let metricsTrailer = "";
+      if (toolName !== "kirograph_exec" && toolName !== "kirograph_gain") {
+        try {
+          const projectRoot = args.projectPath || this.defaultCg?.getProjectRoot() || process.cwd();
+          const { estimateNaiveCost } = await Promise.resolve().then(() => require("../compression/naive-cost.js"));
+          const { estimateTokens } = await Promise.resolve().then(() => require("../compression/index.js"));
+          const outputTokens = estimateTokens(truncated);
+          const naiveCost = estimateNaiveCost(toolName, outputTokens, args);
+          if (naiveCost !== null && naiveCost > outputTokens) {
+            const tracker = new import_tracker.TokenTracker(projectRoot);
+            if (toolName.startsWith("kirograph_mem_")) {
+              tracker.recordMemorySaving(toolName, outputTokens, naiveCost);
+            } else if (toolName.startsWith("kirograph_docs_")) {
+              tracker.recordDocsSaving(toolName, outputTokens, naiveCost);
+            } else if (toolName.startsWith("kirograph_data_")) {
+              tracker.recordDataSaving(toolName, outputTokens, naiveCost);
+            } else {
+              tracker.recordGraphSaving(toolName, outputTokens, naiveCost);
+            }
+            const saved = Math.round((naiveCost - outputTokens) / naiveCost * 100);
+            metricsTrailer = `
+
+[kirograph_metrics: before=${naiveCost} after=${outputTokens} saved=${saved}%]`;
+          } else {
+            metricsTrailer = `
+
+[kirograph_metrics: tokens=${outputTokens}]`;
+          }
+        } catch {
+        }
+      }
+      return { content: [{ type: "text", text: truncated + metricsTrailer }] };
+    } catch (err) {
+      (0, import_errors.logError)("MCP tool error", { tool: toolName, error: err });
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+    }
+  }
+  async dispatch(toolName, args) {
+    if (toolName === "kirograph_exec") {
+      const cmd = args.command;
+      if (!cmd) return "Error: command is required.";
+      const projectRoot = args.projectPath || args.cwd || process.cwd();
+      const execCwd = args.cwd || projectRoot;
+      let defaultLevel = "normal";
+      try {
+        const { loadConfig } = await Promise.resolve().then(() => require("../config.js"));
+        const config = await loadConfig(projectRoot);
+        if (config.shellCompressionLevel && config.shellCompressionLevel !== "off") {
+          defaultLevel = config.shellCompressionLevel;
+        }
+      } catch {
+      }
+      const level = args.level ?? defaultLevel;
+      const timeout = (args.timeout ?? 60) * 1e3;
+      let rawOutput;
+      let exitCode = 0;
+      try {
+        rawOutput = (0, import_child_process.execSync)(cmd, {
+          cwd: execCwd,
+          timeout,
+          encoding: "utf8",
+          stdio: ["pipe", "pipe", "pipe"],
+          maxBuffer: 10 * 1024 * 1024
+        });
+      } catch (err) {
+        rawOutput = (err.stdout || "") + (err.stderr || "");
+        exitCode = err.status ?? 1;
+      }
+      const result = (0, import_compression.compress)(cmd, rawOutput, { level, preserveErrors: exitCode !== 0 });
+      const tracker = new import_tracker.TokenTracker(projectRoot);
+      tracker.record(cmd, result.originalTokens, result.compressedTokens, result.strategy);
+      const header = exitCode !== 0 ? `[exit ${exitCode}] ` : "";
+      const footer = result.savings > 5 ? `
+
+[${result.savings}% tokens saved | ${result.originalTokens}\u2192${result.compressedTokens} | ${result.strategy}]` : "";
+      return `${header}${result.output}${footer}`;
+    }
+    if (toolName === "kirograph_gain") {
+      const projectRoot = args.projectPath || process.cwd();
+      const period = args.period ?? "session";
+      const tracker = new import_tracker.TokenTracker(projectRoot);
+      const stats = tracker.getStats(period);
+      if (stats.totalCommands === 0) {
+        return "No savings recorded yet. Use kirograph tools and kirograph_exec \u2014 savings are tracked automatically.";
+      }
+      const lines = [
+        `Token Savings (${period}):`,
+        `  Total calls: ${stats.totalCommands}`,
+        `  Tokens without KiroGraph: ~${stats.totalOriginal.toLocaleString()}`,
+        `  Tokens with KiroGraph:    ~${stats.totalCompressed.toLocaleString()}`,
+        `  Saved: ${stats.totalSaved.toLocaleString()} tokens (${stats.savingsPercent}%)`
+      ];
+      if (stats.bySource.exec.count > 0 || stats.bySource.graph.count > 0 || stats.bySource.memory.count > 0 || stats.bySource.docs.count > 0) {
+        lines.push("", "By source:");
+        if (stats.bySource.graph.count > 0) {
+          lines.push(`  Graph tools: ${stats.bySource.graph.count} calls, ~${stats.bySource.graph.saved.toLocaleString()} tokens saved (vs file reads/grep)`);
+        }
+        if (stats.bySource.docs.count > 0) {
+          lines.push(`  Docs tools: ${stats.bySource.docs.count} calls, ~${stats.bySource.docs.saved.toLocaleString()} tokens saved (vs reading full doc files)`);
+        }
+        if (stats.bySource.data.count > 0) {
+          lines.push(`  Data tools: ${stats.bySource.data.count} calls, ~${stats.bySource.data.saved.toLocaleString()} tokens saved (vs loading raw data files)`);
+        }
+        if (stats.bySource.exec.count > 0) {
+          lines.push(`  Compression: ${stats.bySource.exec.count} calls, ~${stats.bySource.exec.saved.toLocaleString()} tokens saved (vs raw output)`);
+        }
+        if (stats.bySource.memory.count > 0) {
+          lines.push(`  Memory: ${stats.bySource.memory.count} calls, ~${stats.bySource.memory.saved.toLocaleString()} tokens saved (vs re-discovering context)`);
+        }
+      }
+      if (Object.keys(stats.byFamily).length > 0) {
+        lines.push("", "Top families:");
+        for (const [family, data] of Object.entries(stats.byFamily).slice(0, 7)) {
+          lines.push(`  ${family}: ${data.count} calls, ${data.savings}% avg savings`);
+        }
+      }
+      if (stats.recentCommands.length > 0) {
+        lines.push("", "Recent:");
+        for (const cmd of stats.recentCommands.slice(0, 5)) {
+          const tag = cmd.source === "graph" ? "\u{1F4CA}" : "\u26A1";
+          lines.push(`  ${tag} ${cmd.command.slice(0, 40)} \u2192 ${cmd.savings}% saved`);
+        }
+      }
+      return lines.join("\n");
+    }
+    if (toolName === "kirograph_read") {
+      const filePath = args.path;
+      if (!filePath) return "Error: path is required.";
+      const projectRoot = args.projectPath || process.cwd();
+      const resolvedPath = import_path.default.isAbsolute(filePath) ? filePath : import_path.default.join(projectRoot, filePath);
+      const mode = args.mode ?? "full";
+      const noCache = args.noCache ?? false;
+      if (!import_fs.default.existsSync(resolvedPath)) {
+        return `Error: File not found: ${resolvedPath}`;
+      }
+      const { getFileReadCache } = await Promise.resolve().then(() => require("./cache.js"));
+      const { executeReadMode } = await Promise.resolve().then(() => require("./read-modes.js"));
+      const cache = getFileReadCache();
+      if (mode !== "full") {
+        let cg2 = null;
+        try {
+          cg2 = await this.getConnection(args.projectPath);
+        } catch {
+        }
+        const result2 = executeReadMode({
+          mode,
+          filePath: resolvedPath,
+          start: args.start,
+          end: args.end,
+          cg: cg2
+        });
+        cache.read(resolvedPath, true);
+        return result2.content;
+      }
+      const result = cache.read(resolvedPath, noCache);
+      if (result.cached) {
+        return result.content;
+      }
+      if (result.changed) {
+        return `[file changed since last read]
+
+${result.content}`;
+      }
+      return result.content;
+    }
+    if (toolName === "kirograph_retrieve") {
+      const filePath = args.path;
+      if (!filePath) return "Error: path is required.";
+      const projectRoot = args.projectPath || process.cwd();
+      const resolvedPath = import_path.default.isAbsolute(filePath) ? filePath : import_path.default.join(projectRoot, filePath);
+      const { getFileReadCache } = await Promise.resolve().then(() => require("./cache.js"));
+      const cache = getFileReadCache();
+      const cached = cache.getPreviousContent(resolvedPath);
+      if (cached !== void 0) {
+        return cached;
+      }
+      if (!import_fs.default.existsSync(resolvedPath)) {
+        return `Error: File not found: ${resolvedPath}`;
+      }
+      const result = cache.read(resolvedPath, true);
+      return result.content;
+    }
+    if (toolName === "kirograph_compress") {
+      const text = args.text;
+      if (!text) return "Error: text is required.";
+      const rawLevel = args.level ?? "full";
+      const command = args.command;
+      const { estimateTokens: est } = await Promise.resolve().then(() => require("../compression/index.js"));
+      const originalTokens = est(text);
+      let compressed;
+      let strategy;
+      if (command) {
+        const shellLevel = rawLevel === "ultra" ? "ultra" : rawLevel === "lite" || rawLevel === "normal" ? "normal" : "aggressive";
+        const { compress: compress2 } = await Promise.resolve().then(() => require("../compression/index.js"));
+        const result = compress2(command, text, { level: shellLevel });
+        compressed = result.output;
+        strategy = `rtk:${result.commandFamily}:${shellLevel}`;
+      } else {
+        const cavemanLevel = rawLevel === "normal" || rawLevel === "lite" ? "lite" : rawLevel === "aggressive" ? "full" : rawLevel;
+        const { compressObservation } = await Promise.resolve().then(() => require("../memory/compress.js"));
+        const result = compressObservation(text, cavemanLevel);
+        compressed = result.compressed;
+        strategy = `caveman:${cavemanLevel}`;
+      }
+      const compressedTokens = est(compressed);
+      const savings = originalTokens > 0 ? Math.round((originalTokens - compressedTokens) / originalTokens * 100) : 0;
+      const footer = savings > 5 ? `
+
+[${savings}% tokens saved | ${originalTokens}\u2192${compressedTokens} | ${strategy}]` : "";
+      return compressed + footer;
+    }
+    if (toolName === "kirograph_budget") {
+      const projectRoot = args.projectPath || process.cwd();
+      const reset = args.reset ?? false;
+      const { BudgetTracker } = await Promise.resolve().then(() => require("../compression/tracker.js"));
+      const budget = BudgetTracker.getInstance(projectRoot);
+      if (reset) {
+        budget.reset();
+        return "Context budget counters reset.";
+      }
+      const status = budget.getStatus();
+      const lines = [
+        "Context Budget:",
+        `  Tokens consumed: ${status.consumed.toLocaleString()}`,
+        `  Budget limit:    ${status.limit > 0 ? status.limit.toLocaleString() : "unlimited"}`,
+        `  Remaining:       ${status.limit > 0 ? status.remaining.toLocaleString() : "\u221E"}`,
+        `  Utilization:     ${status.utilization}%`
+      ];
+      if (status.warning) {
+        lines.push(`
+  \u26A0 ${status.warning}`);
+      }
+      return lines.join("\n");
+    }
+    const cg = await this.getConnection(args.projectPath);
+    if (!cg) return "KiroGraph not initialized. Run `kirograph init` in your project first.";
+    (0, import_utils.writeSessionMarker)(cg.getProjectRoot());
+    if (CORE_TOOLS.has(toolName)) return (0, import_core.handleCore)(toolName, args, cg);
+    if (CODE_HEALTH_TOOLS.has(toolName)) return (0, import_code_health.handleCodeHealth)(toolName, args, cg);
+    if (ARCHITECTURE_TOOLS.has(toolName)) return (0, import_architecture.handleArchitecture)(toolName, args, cg);
+    if (GIT_CONTEXT_TOOLS.has(toolName)) return (0, import_git_context.handleGitContext)(toolName, args, cg);
+    if (COMPLEXITY_TOOLS.has(toolName)) return (0, import_complexity.handleComplexity)(toolName, args, cg);
+    if (BRANCH_TOOLS.has(toolName)) return (0, import_branch.handleBranch)(toolName, args, cg);
+    if (EDIT_PRIMITIVES_TOOLS.has(toolName)) return (0, import_edit_primitives.handleEditPrimitives)(toolName, args, cg);
+    if (SECURITY_TOOLS.has(toolName)) return (0, import_security.handleSecurity)(toolName, args, cg);
+    if (PATTERNS_TOOLS.has(toolName)) return (0, import_patterns.handlePatterns)(toolName, args, cg);
+    if (WATCHMEN_TOOLS.has(toolName)) return (0, import_watchmen.handleWatchmen)(toolName, args, cg);
+    if (toolName.startsWith("kirograph_mem_")) return (0, import_memory.handleMemory)(toolName, args, cg);
+    if (toolName.startsWith("kirograph_docs_")) return (0, import_docs.handleDocs)(toolName, args, cg);
+    if (toolName.startsWith("kirograph_data_")) return (0, import_data.handleData)(toolName, args, cg);
+    if (toolName.startsWith("kirograph_wiki_")) return (0, import_wiki.handleWiki)(toolName, args, cg);
+    return `Unknown tool: ${toolName}`;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ToolHandler
+});
+//# sourceMappingURL=handler.js.map