kirograph 0.17.0 → 0.19.0

package/dist/graph/refactor.js

@@ -0,0 +1,155 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var refactor_exports = {};
+__export(refactor_exports, {
+  renamePreview: () => renamePreview,
+  suggestRefactorings: () => suggestRefactorings
+});
+module.exports = __toCommonJS(refactor_exports);
+function renamePreview(db, symbolName) {
+  const rawDb = db.getRawDb();
+  const target = rawDb.get(
+    `SELECT id, name, kind, file_path as filePath, start_line as line FROM nodes WHERE name = ? LIMIT 1`,
+    [symbolName]
+  );
+  if (!target) {
+    const qualified = rawDb.get(
+      `SELECT id, name, kind, file_path as filePath, start_line as line FROM nodes WHERE qualified_name LIKE ? LIMIT 1`,
+      [`%${symbolName}`]
+    );
+    if (!qualified) return null;
+    Object.assign(target, qualified);
+  }
+  const incomingEdges = rawDb.all(
+    `SELECT e.source, e.kind, e.line, e.column, n.name as sourceName, n.file_path as sourceFile, n.start_line as sourceLine
+     FROM edges e
+     JOIN nodes n ON n.id = e.source
+     WHERE e.target = ?
+     ORDER BY n.file_path, e.line`,
+    [target.id]
+  );
+  const outgoingEdges = rawDb.all(
+    `SELECT e.target, e.kind, e.line, e.column, n.name as targetName, n.file_path as targetFile
+     FROM edges e
+     JOIN nodes n ON n.id = e.target
+     WHERE e.source = ? AND e.kind IN ('imports', 'exports')`,
+    [target.id]
+  );
+  const references = [];
+  for (const edge of incomingEdges) {
+    references.push({
+      filePath: edge.sourceFile,
+      line: edge.line ?? edge.sourceLine,
+      column: edge.column ?? void 0,
+      context: edge.sourceName,
+      edgeKind: edge.kind
+    });
+  }
+  for (const edge of outgoingEdges) {
+    references.push({
+      filePath: edge.targetFile,
+      line: edge.line ?? 0,
+      column: edge.column ?? void 0,
+      context: edge.targetName,
+      edgeKind: edge.kind
+    });
+  }
+  return {
+    symbol: target.name,
+    kind: target.kind,
+    filePath: target.filePath,
+    line: target.line,
+    references,
+    totalReferences: references.length
+  };
+}
+function suggestRefactorings(db, limit = 10) {
+  const rawDb = db.getRawDb();
+  const suggestions = [];
+  const crossDirEdges = rawDb.all(
+    `SELECT
+       n1.file_path as sourceFile,
+       n2.file_path as targetFile,
+       COUNT(*) as edgeCount
+     FROM edges e
+     JOIN nodes n1 ON n1.id = e.source
+     JOIN nodes n2 ON n2.id = e.target
+     WHERE e.kind = 'calls'
+       AND n1.file_path != n2.file_path
+     GROUP BY n1.file_path, n2.file_path
+     HAVING edgeCount >= 5
+     ORDER BY edgeCount DESC
+     LIMIT 20`
+  );
+  for (const row of crossDirEdges.slice(0, 5)) {
+    const sourceDir = row.sourceFile.split("/").slice(0, -1).join("/");
+    const targetDir = row.targetFile.split("/").slice(0, -1).join("/");
+    if (sourceDir !== targetDir) {
+      suggestions.push({
+        type: "move",
+        description: `\`${row.sourceFile}\` has ${row.edgeCount} calls to \`${row.targetFile}\` \u2014 consider co-locating related code`,
+        symbols: [row.sourceFile, row.targetFile],
+        rationale: `High cross-directory coupling (${row.edgeCount} call edges) suggests these files belong together`,
+        priority: row.edgeCount >= 10 ? "high" : "medium"
+      });
+    }
+  }
+  const largeFiles = rawDb.all(
+    `SELECT file_path, COUNT(*) as symbolCount
+     FROM nodes
+     WHERE kind IN ('function', 'method', 'class')
+     GROUP BY file_path
+     HAVING symbolCount >= 15
+     ORDER BY symbolCount DESC
+     LIMIT 10`
+  );
+  for (const file of largeFiles.slice(0, 3)) {
+    suggestions.push({
+      type: "split",
+      description: `\`${file.file_path}\` has ${file.symbolCount} functions/classes \u2014 consider splitting into focused modules`,
+      symbols: [file.file_path],
+      rationale: `Files with many symbols often handle multiple responsibilities`,
+      priority: file.symbolCount >= 30 ? "high" : "medium"
+    });
+  }
+  const deadExports = rawDb.all(
+    `SELECT n.name, n.kind, n.file_path as filePath
+     FROM nodes n
+     WHERE n.is_exported = 1
+       AND n.kind IN ('function', 'method', 'class')
+       AND NOT EXISTS (SELECT 1 FROM edges e WHERE e.target = n.id AND e.kind = 'calls')
+     LIMIT 10`
+  );
+  if (deadExports.length >= 3) {
+    suggestions.push({
+      type: "extract",
+      description: `${deadExports.length} exported symbols have no callers \u2014 consider removing exports or the symbols themselves`,
+      symbols: deadExports.slice(0, 5).map((d) => `${d.kind} \`${d.name}\` in ${d.filePath}`),
+      rationale: `Exported symbols with no callers are dead API surface \u2014 they add maintenance burden without value`,
+      priority: deadExports.length >= 8 ? "high" : "low"
+    });
+  }
+  return suggestions.slice(0, limit);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  renamePreview,
+  suggestRefactorings
+});
+//# sourceMappingURL=refactor.js.map

package/dist/graph/refactor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/graph/refactor.ts"],
+  "sourcesContent": ["/**\n * Refactoring Tools\n *\n * - rename: Preview all locations that reference a symbol (rename preview)\n * - suggest: Community-driven refactoring suggestions\n */\n\nimport type { GraphDatabase } from '../db/database';\n\nexport interface RenameLocation {\n  filePath: string;\n  line: number;\n  column?: number;\n  context: string; // The referencing symbol's name\n  edgeKind: string;\n}\n\nexport interface RenamePreview {\n  symbol: string;\n  kind: string;\n  filePath: string;\n  line: number;\n  references: RenameLocation[];\n  totalReferences: number;\n}\n\nexport interface RefactorSuggestion {\n  type: 'move' | 'split' | 'extract' | 'group';\n  description: string;\n  symbols: string[];\n  rationale: string;\n  priority: 'high' | 'medium' | 'low';\n}\n\n/**\n * Generate a rename preview: find all locations that reference a symbol.\n * This shows what would need to change if the symbol is renamed.\n */\nexport function renamePreview(db: GraphDatabase, symbolName: string): RenamePreview | null {\n  const rawDb = db.getRawDb();\n\n  // Find the target symbol\n  const target = rawDb.get(\n    `SELECT id, name, kind, file_path as filePath, start_line as line FROM nodes WHERE name = ? LIMIT 1`,\n    [symbolName]\n  ) as any;\n\n  if (!target) {\n    // Try qualified name\n    const qualified = rawDb.get(\n      `SELECT id, name, kind, file_path as filePath, start_line as line FROM nodes WHERE qualified_name LIKE ? LIMIT 1`,\n      [`%${symbolName}`]\n    ) as any;\n    if (!qualified) return null;\n    Object.assign(target, qualified);\n  }\n\n  // Find all edges pointing TO this symbol (references, calls, imports)\n  const incomingEdges = rawDb.all(\n    `SELECT e.source, e.kind, e.line, e.column, n.name as sourceName, n.file_path as sourceFile, n.start_line as sourceLine\n     FROM edges e\n     JOIN nodes n ON n.id = e.source\n     WHERE e.target = ?\n     ORDER BY n.file_path, e.line`,\n    [target.id]\n  ) as any[];\n\n  // Find all edges FROM this symbol (for completeness \u2014 shows what it calls)\n  const outgoingEdges = rawDb.all(\n    `SELECT e.target, e.kind, e.line, e.column, n.name as targetName, n.file_path as targetFile\n     FROM edges e\n     JOIN nodes n ON n.id = e.target\n     WHERE e.source = ? AND e.kind IN ('imports', 'exports')`,\n    [target.id]\n  ) as any[];\n\n  const references: RenameLocation[] = [];\n\n  for (const edge of incomingEdges) {\n    references.push({\n      filePath: edge.sourceFile,\n      line: edge.line ?? edge.sourceLine,\n      column: edge.column ?? undefined,\n      context: edge.sourceName,\n      edgeKind: edge.kind,\n    });\n  }\n\n  // Also include export/import edges from the symbol itself\n  for (const edge of outgoingEdges) {\n    references.push({\n      filePath: edge.targetFile,\n      line: edge.line ?? 0,\n      column: edge.column ?? undefined,\n      context: edge.targetName,\n      edgeKind: edge.kind,\n    });\n  }\n\n  return {\n    symbol: target.name,\n    kind: target.kind,\n    filePath: target.filePath,\n    line: target.line,\n    references,\n    totalReferences: references.length,\n  };\n}\n\n/**\n * Generate refactoring suggestions based on graph structure.\n * Looks for:\n * - Symbols that are far from their most-connected peers (move candidates)\n * - Files with too many symbols in different \"clusters\" (split candidates)\n * - Groups of related symbols scattered across files (group candidates)\n */\nexport function suggestRefactorings(db: GraphDatabase, limit = 10): RefactorSuggestion[] {\n  const rawDb = db.getRawDb();\n  const suggestions: RefactorSuggestion[] = [];\n\n  // 1. Find files with high fan-out to a single other directory (move candidates)\n  const crossDirEdges = rawDb.all(\n    `SELECT\n       n1.file_path as sourceFile,\n       n2.file_path as targetFile,\n       COUNT(*) as edgeCount\n     FROM edges e\n     JOIN nodes n1 ON n1.id = e.source\n     JOIN nodes n2 ON n2.id = e.target\n     WHERE e.kind = 'calls'\n       AND n1.file_path != n2.file_path\n     GROUP BY n1.file_path, n2.file_path\n     HAVING edgeCount >= 5\n     ORDER BY edgeCount DESC\n     LIMIT 20`\n  ) as any[];\n\n  for (const row of crossDirEdges.slice(0, 5)) {\n    const sourceDir = row.sourceFile.split('/').slice(0, -1).join('/');\n    const targetDir = row.targetFile.split('/').slice(0, -1).join('/');\n    if (sourceDir !== targetDir) {\n      suggestions.push({\n        type: 'move',\n        description: `\\`${row.sourceFile}\\` has ${row.edgeCount} calls to \\`${row.targetFile}\\` \u2014 consider co-locating related code`,\n        symbols: [row.sourceFile, row.targetFile],\n        rationale: `High cross-directory coupling (${row.edgeCount} call edges) suggests these files belong together`,\n        priority: row.edgeCount >= 10 ? 'high' : 'medium',\n      });\n    }\n  }\n\n  // 2. Find large files (split candidates)\n  const largeFiles = rawDb.all(\n    `SELECT file_path, COUNT(*) as symbolCount\n     FROM nodes\n     WHERE kind IN ('function', 'method', 'class')\n     GROUP BY file_path\n     HAVING symbolCount >= 15\n     ORDER BY symbolCount DESC\n     LIMIT 10`\n  ) as any[];\n\n  for (const file of largeFiles.slice(0, 3)) {\n    suggestions.push({\n      type: 'split',\n      description: `\\`${file.file_path}\\` has ${file.symbolCount} functions/classes \u2014 consider splitting into focused modules`,\n      symbols: [file.file_path],\n      rationale: `Files with many symbols often handle multiple responsibilities`,\n      priority: file.symbolCount >= 30 ? 'high' : 'medium',\n    });\n  }\n\n  // 3. Find exported symbols with zero callers (dead export candidates)\n  const deadExports = rawDb.all(\n    `SELECT n.name, n.kind, n.file_path as filePath\n     FROM nodes n\n     WHERE n.is_exported = 1\n       AND n.kind IN ('function', 'method', 'class')\n       AND NOT EXISTS (SELECT 1 FROM edges e WHERE e.target = n.id AND e.kind = 'calls')\n     LIMIT 10`\n  ) as any[];\n\n  if (deadExports.length >= 3) {\n    suggestions.push({\n      type: 'extract',\n      description: `${deadExports.length} exported symbols have no callers \u2014 consider removing exports or the symbols themselves`,\n      symbols: deadExports.slice(0, 5).map((d: any) => `${d.kind} \\`${d.name}\\` in ${d.filePath}`),\n      rationale: `Exported symbols with no callers are dead API surface \u2014 they add maintenance burden without value`,\n      priority: deadExports.length >= 8 ? 'high' : 'low',\n    });\n  }\n\n  return suggestions.slice(0, limit);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/index.js

@@ -54,7 +54,7 @@ class KiroGraph {
     this.db = db;
     this.config = config;
     this.queryManager = new import_queries.GraphQueryManager(db);
-    this.resolver = new import_resolution.ReferenceResolver(db, config);
+    this.resolver = new import_resolution.ReferenceResolver(db, config, projectRoot);
     this.vectors = new import_vectors.VectorManager(db, config, projectRoot);
     this.contextBuilder = new import_context.ContextBuilder(db, this.resolver, this.vectors, projectRoot);
     this.arch = new import_architecture.ArchitectureAnalyzer(db, config, 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);\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      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  ): 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      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

@@ -0,0 +1,172 @@
+"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 cache_exports = {};
+__export(cache_exports, {
+  FileReadCache: () => FileReadCache,
+  getFileReadCache: () => getFileReadCache,
+  resetFileReadCache: () => resetFileReadCache
+});
+module.exports = __toCommonJS(cache_exports);
+var fs = __toESM(require("fs"));
+var crypto = __toESM(require("crypto"));
+class FileReadCache {
+  constructor() {
+    this.cache = /* @__PURE__ */ new Map();
+    this.hits = 0;
+    this.misses = 0;
+  }
+  /**
+   * Read a file with caching. Returns full content on first read or if changed,
+   * returns a compact marker if unchanged since last read.
+   */
+  read(filePath, noCache = false) {
+    let content;
+    try {
+      content = fs.readFileSync(filePath, "utf8");
+    } catch (err) {
+      throw new Error(`Cannot read file: ${err.message}`);
+    }
+    if (noCache) {
+      const hash2 = this.hashContent(content);
+      const previous = this.cache.get(filePath);
+      this.cache.set(filePath, {
+        contentHash: hash2,
+        content,
+        lastRead: Date.now(),
+        readCount: (previous?.readCount ?? 0) + 1
+      });
+      this.misses++;
+      return { content, cached: false, changed: false };
+    }
+    const hash = this.hashContent(content);
+    const existing = this.cache.get(filePath);
+    if (existing && existing.contentHash === hash) {
+      this.hits++;
+      existing.lastRead = Date.now();
+      existing.readCount++;
+      return {
+        content: `[cached: unchanged since ${this.formatTimestamp(existing.lastRead)}] (${existing.readCount} reads)`,
+        cached: true,
+        changed: false
+      };
+    }
+    this.misses++;
+    const previousContent = existing?.content;
+    this.cache.set(filePath, {
+      contentHash: hash,
+      content,
+      lastRead: Date.now(),
+      readCount: (existing?.readCount ?? 0) + 1
+    });
+    if (existing) {
+      return { content, cached: false, changed: true, previousContent };
+    }
+    return { content, cached: false, changed: false };
+  }
+  /**
+   * Get the previously cached content for a file (used by diff mode).
+   */
+  getPreviousContent(filePath) {
+    return this.cache.get(filePath)?.content;
+  }
+  /**
+   * Check if a file is in the cache.
+   */
+  has(filePath) {
+    return this.cache.has(filePath);
+  }
+  /**
+   * Invalidate cache entries for specific files (e.g., after sync).
+   */
+  invalidate(filePaths) {
+    for (const fp of filePaths) {
+      this.cache.delete(fp);
+    }
+  }
+  /**
+   * Clear all cached entries.
+   */
+  clear() {
+    this.cache.clear();
+    this.hits = 0;
+    this.misses = 0;
+  }
+  /**
+   * Get cache statistics.
+   */
+  getStats() {
+    const total = this.hits + this.misses;
+    return {
+      entries: this.cache.size,
+      hits: this.hits,
+      misses: this.misses,
+      hitRate: total > 0 ? Math.round(this.hits / total * 100) : 0
+    };
+  }
+  /**
+   * List all cached file paths with their metadata.
+   */
+  listEntries() {
+    return [...this.cache.entries()].map(([p, e]) => ({
+      path: p,
+      readCount: e.readCount,
+      lastRead: e.lastRead
+    }));
+  }
+  hashContent(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+  }
+  formatTimestamp(ts) {
+    const diff = Date.now() - ts;
+    const seconds = Math.floor(diff / 1e3);
+    if (seconds < 60) return `${seconds}s ago`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60) return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    return `${hours}h ago`;
+  }
+}
+let _instance = null;
+function getFileReadCache() {
+  if (!_instance) {
+    _instance = new FileReadCache();
+  }
+  return _instance;
+}
+function resetFileReadCache() {
+  _instance?.clear();
+  _instance = null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FileReadCache,
+  getFileReadCache,
+  resetFileReadCache
+});
+//# sourceMappingURL=cache.js.map

package/dist/mcp/cache.js.map

@@ -0,0 +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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",
+  "names": ["hash"]
+}