kirograph 0.17.0 → 0.20.0

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.d.ts

@@ -0,0 +1,69 @@
+/**
+ * KiroGraph File Read Cache
+ *
+ * In-memory, session-scoped file cache. First read returns full content,
+ * subsequent reads of unchanged files return a compact "cached" marker (~13 tokens).
+ * Uses content hashing (SHA-256) to detect changes.
+ */
+export interface CacheEntry {
+    contentHash: string;
+    content: string;
+    lastRead: number;
+    readCount: number;
+}
+export interface CacheStats {
+    entries: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+}
+export interface ReadResult {
+    content: string;
+    cached: boolean;
+    changed: boolean;
+    /** Previous content (for diff mode) */
+    previousContent?: string;
+}
+export declare class FileReadCache {
+    private cache;
+    private hits;
+    private misses;
+    /**
+     * 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: string, noCache?: boolean): ReadResult;
+    /**
+     * Get the previously cached content for a file (used by diff mode).
+     */
+    getPreviousContent(filePath: string): string | undefined;
+    /**
+     * Check if a file is in the cache.
+     */
+    has(filePath: string): boolean;
+    /**
+     * Invalidate cache entries for specific files (e.g., after sync).
+     */
+    invalidate(filePaths: string[]): void;
+    /**
+     * Clear all cached entries.
+     */
+    clear(): void;
+    /**
+     * Get cache statistics.
+     */
+    getStats(): CacheStats;
+    /**
+     * List all cached file paths with their metadata.
+     */
+    listEntries(): Array<{
+        path: string;
+        readCount: number;
+        lastRead: number;
+    }>;
+    private hashContent;
+    private formatTimestamp;
+}
+export declare function getFileReadCache(): FileReadCache;
+export declare function resetFileReadCache(): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/mcp/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/mcp/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IAEnB;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,UAAU;IAuDnD;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIxD;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAMrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,QAAQ,IAAI,UAAU;IAUtB;;OAEG;IACH,WAAW,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ3E,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;CASxB;AAKD,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

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"]
+}

package/dist/mcp/read-modes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * KiroGraph Read Modes
+ *
+ * Implements multiple read modes for the kirograph_read tool:
+ * - full: entire file content (default)
+ * - map: structure overview (symbols with line numbers)
+ * - signatures: function/class signatures only
+ * - diff: changes since last read
+ * - lines: specific line range
+ * - imports: import statements
+ * - exports: exported symbols
+ */
+import type KiroGraph from '../index';
+export type ReadMode = 'full' | 'map' | 'signatures' | 'diff' | 'lines' | 'imports' | 'exports';
+export interface ReadModeOptions {
+    mode: ReadMode;
+    filePath: string;
+    start?: number;
+    end?: number;
+    cg?: KiroGraph | null;
+}
+export interface ReadModeResult {
+    content: string;
+    mode: ReadMode;
+    tokenEstimate: number;
+}
+/**
+ * Execute a read mode against a file.
+ */
+export declare function executeReadMode(opts: ReadModeOptions): ReadModeResult;
+//# sourceMappingURL=read-modes.d.ts.map

package/dist/mcp/read-modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-modes.d.ts","sourceRoot":"","sources":["../../src/mcp/read-modes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,SAAS,MAAM,UAAU,CAAC;AAGtC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAqBrE"}