kirograph 0.12.1

package/dist/bin/installer/steering.js

@@ -0,0 +1,283 @@
+"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 steering_exports = {};
+__export(steering_exports, {
+  writeSteering: () => writeSteering
+});
+module.exports = __toCommonJS(steering_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_caveman = require("./caveman");
+const STEERING_CONTENT = `---
+inclusion: always
+---
+
+# KiroGraph
+
+KiroGraph builds a semantic knowledge graph of your codebase. Use its MCP tools instead of grep/glob/file reads whenever \`.kirograph/\` exists in the project.
+
+## Quick decision guide
+
+| Question | Tool |
+|----------|------|
+| Where do I start on this task? | \`kirograph_context\` |
+| What is this symbol / show me its code | \`kirograph_node\` with \`includeCode: true\` |
+| Find a symbol by name | \`kirograph_search\` |
+| Who calls function X? | \`kirograph_callers\` |
+| What does function X call? | \`kirograph_callees\` |
+| What breaks if I change X? | \`kirograph_impact\` |
+| How are X and Y connected? | \`kirograph_path\` |
+| What extends / implements this type? | \`kirograph_type_hierarchy\` |
+| Which code is never called? | \`kirograph_dead_code\` |
+| Are there import cycles? | \`kirograph_circular_deps\` |
+| What files are indexed? | \`kirograph_files\` |
+| Is the index healthy? | \`kirograph_status\` |
+| What are the most critical symbols? | \`kirograph_hotspots\` |
+| Any unexpected cross-module coupling? | \`kirograph_surprising\` |
+| What changed since the last snapshot? | \`kirograph_diff\` |
+| What packages/layers exist? | \`kirograph_architecture\` |
+| How coupled is package X? | \`kirograph_coupling\` |
+| What does package X depend on? | \`kirograph_package\` |
+
+---
+
+## Tool reference
+
+### \`kirograph_context\` \u2014 **start here for any code task**
+
+Returns entry points, related symbols, and code snippets for a natural-language task description. Usually enough to orient without any additional tool calls.
+
+\`\`\`
+kirograph_context(task: "fix the auth token expiry bug")
+kirograph_context(task: "add dark mode", maxNodes: 30)
+kirograph_context(task: "refactor payment service", includeCode: false)
+\`\`\`
+
+### \`kirograph_search\` \u2014 find symbols by name
+
+Exact match \u2192 FTS \u2192 LIKE fallback \u2192 vector (last resort). Use instead of grep.
+
+\`\`\`
+kirograph_search(query: "signIn")
+kirograph_search(query: "UserService", kind: "class")
+kirograph_search(query: "auth", limit: 20)
+\`\`\`
+
+Supported kinds: \`function\`, \`method\`, \`class\`, \`interface\`, \`type_alias\`, \`variable\`, \`route\`, \`component\`
+
+### \`kirograph_node\` \u2014 inspect a symbol
+
+Returns kind, file, signature, docstring. Add \`includeCode: true\` to get the full source.
+
+\`\`\`
+kirograph_node(symbol: "validateToken")
+kirograph_node(symbol: "AuthService", includeCode: true)
+\`\`\`
+
+### \`kirograph_callers\` \u2014 who calls this?
+
+BFS over incoming \`calls\` edges (depth 1).
+
+\`\`\`
+kirograph_callers(symbol: "processPayment", limit: 30)
+\`\`\`
+
+### \`kirograph_callees\` \u2014 what does this call?
+
+BFS over outgoing \`calls\` edges (depth 1).
+
+\`\`\`
+kirograph_callees(symbol: "handleRequest")
+\`\`\`
+
+### \`kirograph_impact\` \u2014 blast radius before a change
+
+Traverses all incoming edges up to \`depth\` hops. Call this before editing a symbol.
+
+\`\`\`
+kirograph_impact(symbol: "UserRepository", depth: 3)
+\`\`\`
+
+### \`kirograph_path\` \u2014 how are two symbols connected?
+
+BFS shortest path across all edge types.
+
+\`\`\`
+kirograph_path(from: "LoginController", to: "DatabasePool")
+\`\`\`
+
+### \`kirograph_type_hierarchy\` \u2014 class/interface inheritance
+
+\`\`\`
+kirograph_type_hierarchy(symbol: "BaseRepository", direction: "down")  // derived types
+kirograph_type_hierarchy(symbol: "PaymentService", direction: "up")    // base types
+kirograph_type_hierarchy(symbol: "IUserStore", direction: "both")      // all
+\`\`\`
+
+### \`kirograph_dead_code\` \u2014 unreferenced symbols
+
+Returns unexported symbols with zero incoming edges. Good first step when cleaning up.
+
+\`\`\`
+kirograph_dead_code(limit: 50)
+\`\`\`
+
+### \`kirograph_circular_deps\` \u2014 import cycles
+
+Runs Tarjan's SCC over import edges. No parameters needed.
+
+\`\`\`
+kirograph_circular_deps()
+\`\`\`
+
+### \`kirograph_files\` \u2014 indexed file structure
+
+\`\`\`
+kirograph_files(format: "tree")                          // default
+kirograph_files(format: "flat")                          // one path per line
+kirograph_files(format: "grouped")                       // by directory
+kirograph_files(filterPath: "src/auth", maxDepth: 2)
+kirograph_files(pattern: "**/*.test.ts")
+\`\`\`
+
+### \`kirograph_status\` \u2014 index health
+
+Returns file count, symbol count, edge count, embedding coverage, DB size. Call when something feels off.
+
+### \`kirograph_hotspots\` \u2014 most-connected symbols
+
+Returns the top-N symbols by total edge degree (in + out, excluding structural \`contains\` edges). Use to find core abstractions, identify high blast-radius symbols before a refactor, or understand what the codebase revolves around.
+
+\`\`\`
+kirograph_hotspots(limit: 20)
+\`\`\`
+
+### \`kirograph_surprising\` \u2014 unexpected cross-module coupling
+
+Finds direct edges between symbols in structurally distant files, scored by path distance \xD7 edge-kind weight. Use before a refactor to discover hidden dependencies that will break. High score = more unexpected.
+
+\`\`\`
+kirograph_surprising(limit: 20)
+\`\`\`
+
+### \`kirograph_diff\` \u2014 what changed since a snapshot?
+
+Compares the current graph against a saved snapshot. Shows added/removed symbols and edges. A snapshot must exist \u2014 the user saves one with \`kirograph snapshot save <label>\` before making changes.
+
+\`\`\`
+kirograph_diff()                              // vs latest snapshot
+kirograph_diff(snapshot: "pre-refactor")     // vs named snapshot
+\`\`\`
+
+---
+
+## Architecture tools *(require \`enableArchitecture: true\` in config)*
+
+### \`kirograph_architecture\` \u2014 **start here for architectural questions**
+
+Returns the full package graph, detected layers (api/service/data/ui/shared), and their dependency edges.
+
+\`\`\`
+kirograph_architecture()                    // packages + layers
+kirograph_architecture(level: "packages")
+kirograph_architecture(level: "layers")
+kirograph_architecture(includeFiles: true)  // add file\u2192package assignments
+\`\`\`
+
+### \`kirograph_coupling\` \u2014 stability metrics per package
+
+Returns Ca (afferent \u2014 depended on by), Ce (efferent \u2014 depends on), and instability (Ce/(Ca+Ce)).
+- High Ca + low instability = load-bearing, safe to depend on, risky to change interface.
+- High Ce + high instability = depends on many things, safe to refactor internals.
+
+\`\`\`
+kirograph_coupling()                        // all packages, sorted by instability
+kirograph_coupling(sortBy: "afferent")     // most depended-on first
+kirograph_coupling(sortBy: "efferent")     // most outgoing deps first
+\`\`\`
+
+### \`kirograph_package\` \u2014 drill into one package
+
+Returns metadata, coupling metrics, outgoing deps, incoming dependents, and file list.
+
+\`\`\`
+kirograph_package(package: "auth")
+kirograph_package(package: "src/services", includeFiles: false)
+\`\`\`
+
+---
+
+## Workflows
+
+**Bug fix or feature:**
+1. \`kirograph_context\` \u2014 orient, find entry points.
+2. \`kirograph_node\` with \`includeCode: true\` \u2014 read the relevant symbol.
+3. \`kirograph_callers\` / \`kirograph_callees\` \u2014 trace the call flow.
+4. \`kirograph_impact\` \u2014 check blast radius before editing.
+
+**Refactor planning:**
+1. \`kirograph_hotspots\` \u2014 identify the most-connected symbols; changing these is risky.
+2. \`kirograph_surprising\` \u2014 surface hidden coupling that will break.
+3. \`kirograph_impact\` on specific targets \u2014 confirm blast radius.
+4. \`kirograph_diff\` after the refactor \u2014 verify the structural change matches intent.
+
+**Architectural review:**
+1. \`kirograph_architecture\` \u2014 get the package and layer map.
+2. \`kirograph_coupling\` \u2014 find the most stable (high Ca) and most volatile (high instability) packages.
+3. \`kirograph_package\` \u2014 drill into any package of interest.
+4. \`kirograph_circular_deps\` \u2014 check for import cycles.
+
+**Code cleanup:**
+1. \`kirograph_dead_code\` \u2014 find unreferenced unexported symbols.
+2. \`kirograph_circular_deps\` \u2014 find import cycles to untangle.
+3. \`kirograph_surprising\` \u2014 find unexpected coupling to decouple.
+
+---
+
+## If \`.kirograph/\` does NOT exist
+
+Ask the user: "This project doesn't have KiroGraph initialized. Run \`kirograph init -i\` to build a code knowledge graph for faster exploration?"
+`;
+function buildSteeringContent(cavemanMode) {
+  const caveman = cavemanMode && cavemanMode !== "off" ? import_caveman.CAVEMAN_RULES[cavemanMode] : null;
+  if (!caveman) return STEERING_CONTENT;
+  return STEERING_CONTENT.trimEnd() + "\n\n" + caveman + "\n";
+}
+function writeSteering(kiroDir, cavemanMode) {
+  const steeringDir = path.join(kiroDir, "steering");
+  fs.mkdirSync(steeringDir, { recursive: true });
+  const steeringPath = path.join(steeringDir, "kirograph.md");
+  fs.writeFileSync(steeringPath, buildSteeringContent(cavemanMode));
+  console.log(`  \u2713 Steering file written to ${steeringPath}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  writeSteering
+});
+//# sourceMappingURL=steering.js.map

package/dist/bin/installer/steering.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/installer/steering.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 Kiro steering file\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { CAVEMAN_RULES, CavemanMode } from './caveman';\n\nconst STEERING_CONTENT = `---\ninclusion: always\n---\n\n# KiroGraph\n\nKiroGraph builds a semantic knowledge graph of your codebase. Use its MCP tools instead of grep/glob/file reads whenever \\`.kirograph/\\` exists in the project.\n\n## Quick decision guide\n\n| Question | Tool |\n|----------|------|\n| Where do I start on this task? | \\`kirograph_context\\` |\n| What is this symbol / show me its code | \\`kirograph_node\\` with \\`includeCode: true\\` |\n| Find a symbol by name | \\`kirograph_search\\` |\n| Who calls function X? | \\`kirograph_callers\\` |\n| What does function X call? | \\`kirograph_callees\\` |\n| What breaks if I change X? | \\`kirograph_impact\\` |\n| How are X and Y connected? | \\`kirograph_path\\` |\n| What extends / implements this type? | \\`kirograph_type_hierarchy\\` |\n| Which code is never called? | \\`kirograph_dead_code\\` |\n| Are there import cycles? | \\`kirograph_circular_deps\\` |\n| What files are indexed? | \\`kirograph_files\\` |\n| Is the index healthy? | \\`kirograph_status\\` |\n| What are the most critical symbols? | \\`kirograph_hotspots\\` |\n| Any unexpected cross-module coupling? | \\`kirograph_surprising\\` |\n| What changed since the last snapshot? | \\`kirograph_diff\\` |\n| What packages/layers exist? | \\`kirograph_architecture\\` |\n| How coupled is package X? | \\`kirograph_coupling\\` |\n| What does package X depend on? | \\`kirograph_package\\` |\n\n---\n\n## Tool reference\n\n### \\`kirograph_context\\` \u2014 **start here for any code task**\n\nReturns entry points, related symbols, and code snippets for a natural-language task description. Usually enough to orient without any additional tool calls.\n\n\\`\\`\\`\nkirograph_context(task: \"fix the auth token expiry bug\")\nkirograph_context(task: \"add dark mode\", maxNodes: 30)\nkirograph_context(task: \"refactor payment service\", includeCode: false)\n\\`\\`\\`\n\n### \\`kirograph_search\\` \u2014 find symbols by name\n\nExact match \u2192 FTS \u2192 LIKE fallback \u2192 vector (last resort). Use instead of grep.\n\n\\`\\`\\`\nkirograph_search(query: \"signIn\")\nkirograph_search(query: \"UserService\", kind: \"class\")\nkirograph_search(query: \"auth\", limit: 20)\n\\`\\`\\`\n\nSupported kinds: \\`function\\`, \\`method\\`, \\`class\\`, \\`interface\\`, \\`type_alias\\`, \\`variable\\`, \\`route\\`, \\`component\\`\n\n### \\`kirograph_node\\` \u2014 inspect a symbol\n\nReturns kind, file, signature, docstring. Add \\`includeCode: true\\` to get the full source.\n\n\\`\\`\\`\nkirograph_node(symbol: \"validateToken\")\nkirograph_node(symbol: \"AuthService\", includeCode: true)\n\\`\\`\\`\n\n### \\`kirograph_callers\\` \u2014 who calls this?\n\nBFS over incoming \\`calls\\` edges (depth 1).\n\n\\`\\`\\`\nkirograph_callers(symbol: \"processPayment\", limit: 30)\n\\`\\`\\`\n\n### \\`kirograph_callees\\` \u2014 what does this call?\n\nBFS over outgoing \\`calls\\` edges (depth 1).\n\n\\`\\`\\`\nkirograph_callees(symbol: \"handleRequest\")\n\\`\\`\\`\n\n### \\`kirograph_impact\\` \u2014 blast radius before a change\n\nTraverses all incoming edges up to \\`depth\\` hops. Call this before editing a symbol.\n\n\\`\\`\\`\nkirograph_impact(symbol: \"UserRepository\", depth: 3)\n\\`\\`\\`\n\n### \\`kirograph_path\\` \u2014 how are two symbols connected?\n\nBFS shortest path across all edge types.\n\n\\`\\`\\`\nkirograph_path(from: \"LoginController\", to: \"DatabasePool\")\n\\`\\`\\`\n\n### \\`kirograph_type_hierarchy\\` \u2014 class/interface inheritance\n\n\\`\\`\\`\nkirograph_type_hierarchy(symbol: \"BaseRepository\", direction: \"down\")  // derived types\nkirograph_type_hierarchy(symbol: \"PaymentService\", direction: \"up\")    // base types\nkirograph_type_hierarchy(symbol: \"IUserStore\", direction: \"both\")      // all\n\\`\\`\\`\n\n### \\`kirograph_dead_code\\` \u2014 unreferenced symbols\n\nReturns unexported symbols with zero incoming edges. Good first step when cleaning up.\n\n\\`\\`\\`\nkirograph_dead_code(limit: 50)\n\\`\\`\\`\n\n### \\`kirograph_circular_deps\\` \u2014 import cycles\n\nRuns Tarjan's SCC over import edges. No parameters needed.\n\n\\`\\`\\`\nkirograph_circular_deps()\n\\`\\`\\`\n\n### \\`kirograph_files\\` \u2014 indexed file structure\n\n\\`\\`\\`\nkirograph_files(format: \"tree\")                          // default\nkirograph_files(format: \"flat\")                          // one path per line\nkirograph_files(format: \"grouped\")                       // by directory\nkirograph_files(filterPath: \"src/auth\", maxDepth: 2)\nkirograph_files(pattern: \"**/*.test.ts\")\n\\`\\`\\`\n\n### \\`kirograph_status\\` \u2014 index health\n\nReturns file count, symbol count, edge count, embedding coverage, DB size. Call when something feels off.\n\n### \\`kirograph_hotspots\\` \u2014 most-connected symbols\n\nReturns the top-N symbols by total edge degree (in + out, excluding structural \\`contains\\` edges). Use to find core abstractions, identify high blast-radius symbols before a refactor, or understand what the codebase revolves around.\n\n\\`\\`\\`\nkirograph_hotspots(limit: 20)\n\\`\\`\\`\n\n### \\`kirograph_surprising\\` \u2014 unexpected cross-module coupling\n\nFinds direct edges between symbols in structurally distant files, scored by path distance \u00D7 edge-kind weight. Use before a refactor to discover hidden dependencies that will break. High score = more unexpected.\n\n\\`\\`\\`\nkirograph_surprising(limit: 20)\n\\`\\`\\`\n\n### \\`kirograph_diff\\` \u2014 what changed since a snapshot?\n\nCompares the current graph against a saved snapshot. Shows added/removed symbols and edges. A snapshot must exist \u2014 the user saves one with \\`kirograph snapshot save <label>\\` before making changes.\n\n\\`\\`\\`\nkirograph_diff()                              // vs latest snapshot\nkirograph_diff(snapshot: \"pre-refactor\")     // vs named snapshot\n\\`\\`\\`\n\n---\n\n## Architecture tools *(require \\`enableArchitecture: true\\` in config)*\n\n### \\`kirograph_architecture\\` \u2014 **start here for architectural questions**\n\nReturns the full package graph, detected layers (api/service/data/ui/shared), and their dependency edges.\n\n\\`\\`\\`\nkirograph_architecture()                    // packages + layers\nkirograph_architecture(level: \"packages\")\nkirograph_architecture(level: \"layers\")\nkirograph_architecture(includeFiles: true)  // add file\u2192package assignments\n\\`\\`\\`\n\n### \\`kirograph_coupling\\` \u2014 stability metrics per package\n\nReturns Ca (afferent \u2014 depended on by), Ce (efferent \u2014 depends on), and instability (Ce/(Ca+Ce)).\n- High Ca + low instability = load-bearing, safe to depend on, risky to change interface.\n- High Ce + high instability = depends on many things, safe to refactor internals.\n\n\\`\\`\\`\nkirograph_coupling()                        // all packages, sorted by instability\nkirograph_coupling(sortBy: \"afferent\")     // most depended-on first\nkirograph_coupling(sortBy: \"efferent\")     // most outgoing deps first\n\\`\\`\\`\n\n### \\`kirograph_package\\` \u2014 drill into one package\n\nReturns metadata, coupling metrics, outgoing deps, incoming dependents, and file list.\n\n\\`\\`\\`\nkirograph_package(package: \"auth\")\nkirograph_package(package: \"src/services\", includeFiles: false)\n\\`\\`\\`\n\n---\n\n## Workflows\n\n**Bug fix or feature:**\n1. \\`kirograph_context\\` \u2014 orient, find entry points.\n2. \\`kirograph_node\\` with \\`includeCode: true\\` \u2014 read the relevant symbol.\n3. \\`kirograph_callers\\` / \\`kirograph_callees\\` \u2014 trace the call flow.\n4. \\`kirograph_impact\\` \u2014 check blast radius before editing.\n\n**Refactor planning:**\n1. \\`kirograph_hotspots\\` \u2014 identify the most-connected symbols; changing these is risky.\n2. \\`kirograph_surprising\\` \u2014 surface hidden coupling that will break.\n3. \\`kirograph_impact\\` on specific targets \u2014 confirm blast radius.\n4. \\`kirograph_diff\\` after the refactor \u2014 verify the structural change matches intent.\n\n**Architectural review:**\n1. \\`kirograph_architecture\\` \u2014 get the package and layer map.\n2. \\`kirograph_coupling\\` \u2014 find the most stable (high Ca) and most volatile (high instability) packages.\n3. \\`kirograph_package\\` \u2014 drill into any package of interest.\n4. \\`kirograph_circular_deps\\` \u2014 check for import cycles.\n\n**Code cleanup:**\n1. \\`kirograph_dead_code\\` \u2014 find unreferenced unexported symbols.\n2. \\`kirograph_circular_deps\\` \u2014 find import cycles to untangle.\n3. \\`kirograph_surprising\\` \u2014 find unexpected coupling to decouple.\n\n---\n\n## If \\`.kirograph/\\` does NOT exist\n\nAsk the user: \"This project doesn't have KiroGraph initialized. Run \\`kirograph init -i\\` to build a code knowledge graph for faster exploration?\"\n`;\n\nfunction buildSteeringContent(cavemanMode?: CavemanMode | 'off'): string {\n  const caveman = cavemanMode && cavemanMode !== 'off' ? CAVEMAN_RULES[cavemanMode] : null;\n  if (!caveman) return STEERING_CONTENT;\n  return STEERING_CONTENT.trimEnd() + '\\n\\n' + caveman + '\\n';\n}\n\nexport function writeSteering(kiroDir: string, cavemanMode?: CavemanMode | 'off'): void {\n  const steeringDir = path.join(kiroDir, 'steering');\n  fs.mkdirSync(steeringDir, { recursive: true });\n  const steeringPath = path.join(steeringDir, 'kirograph.md');\n  fs.writeFileSync(steeringPath, buildSteeringContent(cavemanMode));\n  console.log(`  \u2713 Steering file written to ${steeringPath}`);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,SAAoB;AACpB,WAAsB;AACtB,qBAA2C;AAE3C,MAAM,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuOzB,SAAS,qBAAqB,aAA2C;AACvE,QAAM,UAAU,eAAe,gBAAgB,QAAQ,6BAAc,WAAW,IAAI;AACpF,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,iBAAiB,QAAQ,IAAI,SAAS,UAAU;AACzD;AAEO,SAAS,cAAc,SAAiB,aAAyC;AACtF,QAAM,cAAc,KAAK,KAAK,SAAS,UAAU;AACjD,KAAG,UAAU,aAAa,EAAE,WAAW,KAAK,CAAC;AAC7C,QAAM,eAAe,KAAK,KAAK,aAAa,cAAc;AAC1D,KAAG,cAAc,cAAc,qBAAqB,WAAW,CAAC;AAChE,UAAQ,IAAI,qCAAgC,YAAY,EAAE;AAC5D;",
+  "names": []
+}

package/dist/bin/kirograph.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * KiroGraph CLI
+ */
+export {};
+//# sourceMappingURL=kirograph.d.ts.map

package/dist/bin/kirograph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kirograph.d.ts","sourceRoot":"","sources":["../../src/bin/kirograph.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/bin/kirograph.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+"use strict";
+var import_commander = require("commander");
+var import_banner = require("./banner");
+var import_help = require("./commands/help");
+var import_init = require("./commands/init");
+var import_uninit = require("./commands/uninit");
+var import_commands = require("./commands/index");
+var import_sync = require("./commands/sync");
+var import_status = require("./commands/status");
+var import_query = require("./commands/query");
+var import_files = require("./commands/files");
+var import_context = require("./commands/context");
+var import_affected = require("./commands/affected");
+var import_mark_dirty = require("./commands/mark-dirty");
+var import_sync_if_dirty = require("./commands/sync-if-dirty");
+var import_unlock = require("./commands/unlock");
+var import_install = require("./commands/install");
+var import_serve = require("./commands/serve");
+var import_dashboard = require("./commands/dashboard");
+var import_architecture = require("./commands/architecture");
+var import_coupling = require("./commands/coupling");
+var import_package = require("./commands/package");
+var import_caveman = require("./commands/caveman");
+var import_dead_code = require("./commands/dead-code");
+var import_hotspots = require("./commands/hotspots");
+var import_surprising = require("./commands/surprising");
+var import_snapshot = require("./commands/snapshot");
+var import_path = require("./commands/path");
+var import_export = require("./commands/export");
+process.on("uncaughtException", (err) => {
+  const msg = err?.message ?? String(err);
+  const isWasmAbort = msg.includes("Aborted(") || msg.includes("RuntimeError") || err?.constructor?.name === "RuntimeError";
+  if (isWasmAbort) {
+    process.stderr.write([
+      "",
+      "  \u2716 KiroGraph crashed: SQLite WASM runtime aborted.",
+      "",
+      "  Most likely cause: another process (e.g. the Kiro MCP server) is",
+      "  holding the database open while indexing is running.",
+      "",
+      "  How to fix:",
+      "    1. Close Kiro IDE (or disable the kirograph MCP server) before indexing",
+      "    2. Run: kirograph unlock",
+      "    3. Then retry: kirograph index",
+      "",
+      "  If the problem persists, delete the lock manually:",
+      "    del .kirograph\\kirograph.db.lock  (Windows)",
+      "    rm -rf .kirograph/kirograph.db.lock  (macOS/Linux)",
+      ""
+    ].join("\n"));
+    process.exit(1);
+  }
+  process.stderr.write(`Uncaught error: ${msg}
+`);
+  process.exit(1);
+});
+const program = new import_commander.Command();
+program.name("kirograph").description("Semantic code knowledge graph for Kiro").version("0.12.1").addHelpCommand(true).hook("preAction", (thisCommand) => {
+  const name = thisCommand.name();
+  if (name === "init") (0, import_banner.printBanner)();
+});
+(0, import_install.register)(program);
+(0, import_init.register)(program);
+(0, import_uninit.register)(program);
+(0, import_commands.register)(program);
+(0, import_sync.register)(program);
+(0, import_sync_if_dirty.register)(program);
+(0, import_mark_dirty.register)(program);
+(0, import_status.register)(program);
+(0, import_query.register)(program);
+(0, import_context.register)(program);
+(0, import_files.register)(program);
+(0, import_affected.register)(program);
+(0, import_unlock.register)(program);
+(0, import_serve.register)(program);
+(0, import_dashboard.register)(program);
+(0, import_architecture.register)(program);
+(0, import_coupling.register)(program);
+(0, import_package.register)(program);
+(0, import_caveman.register)(program);
+(0, import_dead_code.register)(program);
+(0, import_hotspots.register)(program);
+(0, import_surprising.register)(program);
+(0, import_snapshot.register)(program);
+(0, import_path.register)(program);
+(0, import_export.register)(program);
+if (process.argv.length === 2) {
+  (0, import_banner.printBanner)();
+  (0, import_help.printColoredHelp)();
+  process.exit(0);
+}
+(0, import_help.register)(program);
+program.parse(process.argv);
+//# sourceMappingURL=kirograph.js.map

package/dist/bin/kirograph.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/bin/kirograph.ts"],
+  "sourcesContent": ["#!/usr/bin/env node\n/**\n * KiroGraph CLI\n */\n\nimport { Command } from 'commander';\nimport { printBanner } from './banner';\nimport { printColoredHelp, register as registerHelp } from './commands/help';\nimport { register as registerInit } from './commands/init';\nimport { register as registerUninit } from './commands/uninit';\nimport { register as registerIndex } from './commands/index';\nimport { register as registerSync } from './commands/sync';\nimport { register as registerStatus } from './commands/status';\nimport { register as registerQuery } from './commands/query';\nimport { register as registerFiles } from './commands/files';\nimport { register as registerContext } from './commands/context';\nimport { register as registerAffected } from './commands/affected';\nimport { register as registerMarkDirty } from './commands/mark-dirty';\nimport { register as registerSyncIfDirty } from './commands/sync-if-dirty';\nimport { register as registerUnlock } from './commands/unlock';\nimport { register as registerInstall } from './commands/install';\nimport { register as registerServe } from './commands/serve';\nimport { register as registerDashboard } from './commands/dashboard';\nimport { register as registerArchitecture } from './commands/architecture';\nimport { register as registerCoupling } from './commands/coupling';\nimport { register as registerPackage } from './commands/package';\nimport { register as registerCaveman } from './commands/caveman';\nimport { register as registerDeadCode } from './commands/dead-code';\nimport { register as registerHotspots } from './commands/hotspots';\nimport { register as registerSurprising } from './commands/surprising';\nimport { register as registerSnapshot } from './commands/snapshot';\nimport { register as registerPath } from './commands/path';\nimport { register as registerExport } from './commands/export';\n\n// \u2500\u2500 Global error handler for WASM runtime crashes \u2500\u2500\u2500\u2500\u2500\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// node-sqlite3-wasm calls process.abort() when it hits a fatal error (e.g.\n// database is locked by another process). This produces a raw \"Aborted()\"\n// message with no context. We intercept it here to print a clear explanation\n// before the process exits.\nprocess.on('uncaughtException', (err: Error) => {\n  const msg = err?.message ?? String(err);\n  const isWasmAbort = msg.includes('Aborted(') || msg.includes('RuntimeError') || (err as any)?.constructor?.name === 'RuntimeError';\n\n  if (isWasmAbort) {\n    process.stderr.write([\n      '',\n      '  \u2716 KiroGraph crashed: SQLite WASM runtime aborted.',\n      '',\n      '  Most likely cause: another process (e.g. the Kiro MCP server) is',\n      '  holding the database open while indexing is running.',\n      '',\n      '  How to fix:',\n      '    1. Close Kiro IDE (or disable the kirograph MCP server) before indexing',\n      '    2. Run: kirograph unlock',\n      '    3. Then retry: kirograph index',\n      '',\n      '  If the problem persists, delete the lock manually:',\n      '    del .kirograph\\\\kirograph.db.lock  (Windows)',\n      '    rm -rf .kirograph/kirograph.db.lock  (macOS/Linux)',\n      '',\n    ].join('\\n'));\n    process.exit(1);\n  }\n\n  // Not a WASM crash \u2014 re-throw as normal\n  process.stderr.write(`Uncaught error: ${msg}\\n`);\n  process.exit(1);\n});\n\ndeclare const __CLI_VERSION__: string;\n\nconst program = new Command();\n\nprogram\n  .name('kirograph')\n  .description('Semantic code knowledge graph for Kiro')\n  .version(__CLI_VERSION__)\n  .addHelpCommand(true)\n  .hook('preAction', (thisCommand) => {\n    const name = thisCommand.name();\n    if (name === 'init') printBanner();\n  });\n\nregisterInstall(program);\nregisterInit(program);\nregisterUninit(program);\nregisterIndex(program);\nregisterSync(program);\nregisterSyncIfDirty(program);\nregisterMarkDirty(program);\nregisterStatus(program);\nregisterQuery(program);\nregisterContext(program);\nregisterFiles(program);\nregisterAffected(program);\nregisterUnlock(program);\nregisterServe(program);\nregisterDashboard(program);\nregisterArchitecture(program);\nregisterCoupling(program);\nregisterPackage(program);\nregisterCaveman(program);\nregisterDeadCode(program);\nregisterHotspots(program);\nregisterSurprising(program);\nregisterSnapshot(program);\nregisterPath(program);\nregisterExport(program);\n\n// Show banner + help when called with no arguments, otherwise parse normally\nif (process.argv.length === 2) {\n  printBanner();\n  printColoredHelp();\n  process.exit(0);\n}\n\nregisterHelp(program);\n\nprogram.parse(process.argv);\n"],
+  "mappings": ";;AAKA,uBAAwB;AACxB,oBAA4B;AAC5B,kBAA2D;AAC3D,kBAAyC;AACzC,oBAA2C;AAC3C,sBAA0C;AAC1C,kBAAyC;AACzC,oBAA2C;AAC3C,mBAA0C;AAC1C,mBAA0C;AAC1C,qBAA4C;AAC5C,sBAA6C;AAC7C,wBAA8C;AAC9C,2BAAgD;AAChD,oBAA2C;AAC3C,qBAA4C;AAC5C,mBAA0C;AAC1C,uBAA8C;AAC9C,0BAAiD;AACjD,sBAA6C;AAC7C,qBAA4C;AAC5C,qBAA4C;AAC5C,uBAA6C;AAC7C,sBAA6C;AAC7C,wBAA+C;AAC/C,sBAA6C;AAC7C,kBAAyC;AACzC,oBAA2C;AAQ3C,QAAQ,GAAG,qBAAqB,CAAC,QAAe;AAC9C,QAAM,MAAM,KAAK,WAAW,OAAO,GAAG;AACtC,QAAM,cAAc,IAAI,SAAS,UAAU,KAAK,IAAI,SAAS,cAAc,KAAM,KAAa,aAAa,SAAS;AAEpH,MAAI,aAAa;AACf,YAAQ,OAAO,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI,CAAC;AACZ,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,UAAQ,OAAO,MAAM,mBAAmB,GAAG;AAAA,CAAI;AAC/C,UAAQ,KAAK,CAAC;AAChB,CAAC;AAID,MAAM,UAAU,IAAI,yBAAQ;AAE5B,QACG,KAAK,WAAW,EAChB,YAAY,wCAAwC,EACpD,QAAQ,QAAe,EACvB,eAAe,IAAI,EACnB,KAAK,aAAa,CAAC,gBAAgB;AAClC,QAAM,OAAO,YAAY,KAAK;AAC9B,MAAI,SAAS,OAAQ,gCAAY;AACnC,CAAC;AAAA,IAEH,eAAAA,UAAgB,OAAO;AAAA,IACvB,YAAAC,UAAa,OAAO;AAAA,IACpB,cAAAC,UAAe,OAAO;AAAA,IACtB,gBAAAC,UAAc,OAAO;AAAA,IACrB,YAAAC,UAAa,OAAO;AAAA,IACpB,qBAAAC,UAAoB,OAAO;AAAA,IAC3B,kBAAAC,UAAkB,OAAO;AAAA,IACzB,cAAAC,UAAe,OAAO;AAAA,IACtB,aAAAC,UAAc,OAAO;AAAA,IACrB,eAAAC,UAAgB,OAAO;AAAA,IACvB,aAAAC,UAAc,OAAO;AAAA,IACrB,gBAAAC,UAAiB,OAAO;AAAA,IACxB,cAAAC,UAAe,OAAO;AAAA,IACtB,aAAAC,UAAc,OAAO;AAAA,IACrB,iBAAAC,UAAkB,OAAO;AAAA,IACzB,oBAAAC,UAAqB,OAAO;AAAA,IAC5B,gBAAAC,UAAiB,OAAO;AAAA,IACxB,eAAAC,UAAgB,OAAO;AAAA,IACvB,eAAAC,UAAgB,OAAO;AAAA,IACvB,iBAAAC,UAAiB,OAAO;AAAA,IACxB,gBAAAC,UAAiB,OAAO;AAAA,IACxB,kBAAAC,UAAmB,OAAO;AAAA,IAC1B,gBAAAC,UAAiB,OAAO;AAAA,IACxB,YAAAC,UAAa,OAAO;AAAA,IACpB,cAAAC,UAAe,OAAO;AAGtB,IAAI,QAAQ,KAAK,WAAW,GAAG;AAC7B,iCAAY;AACZ,oCAAiB;AACjB,UAAQ,KAAK,CAAC;AAChB;AAAA,IAEA,YAAAC,UAAa,OAAO;AAEpB,QAAQ,MAAM,QAAQ,IAAI;",
+  "names": ["registerInstall", "registerInit", "registerUninit", "registerIndex", "registerSync", "registerSyncIfDirty", "registerMarkDirty", "registerStatus", "registerQuery", "registerContext", "registerFiles", "registerAffected", "registerUnlock", "registerServe", "registerDashboard", "registerArchitecture", "registerCoupling", "registerPackage", "registerCaveman", "registerDeadCode", "registerHotspots", "registerSurprising", "registerSnapshot", "registerPath", "registerExport", "registerHelp"]
+}

package/dist/bin/progress.d.ts

@@ -0,0 +1,14 @@
+/**
+ * KiroGraph CLI Progress Renderer
+ *
+ * Renders indexAll/sync progress events to stdout.
+ * Lives in src/bin/ because it is a display concern — not part of the core library.
+ */
+import type { IndexProgress } from '../types';
+/**
+ * Renders a single indexAll progress event to stdout.
+ * Scanning and framework detection print a persistent line (with \n).
+ * Parsing, resolving, and embeddings overwrite the current line (\r).
+ */
+export declare function renderIndexProgress(p: IndexProgress): void;
+//# sourceMappingURL=progress.d.ts.map

package/dist/bin/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/bin/progress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAe9C;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAuC1D"}

package/dist/bin/progress.js

@@ -0,0 +1,201 @@
+"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 progress_exports = {};
+__export(progress_exports, {
+  renderIndexProgress: () => renderIndexProgress,
+  renderSyncProgress: () => renderSyncProgress,
+  renderSyncProgressVerbose: () => renderSyncProgressVerbose,
+  renderSyncSummary: () => renderSyncSummary
+});
+module.exports = __toCommonJS(progress_exports);
+const _v = "\x1B[38;5;99m";
+const _r = "\x1B[0m";
+const _d = "\x1B[2m";
+const _g = "\x1B[38;5;114m";
+function _bar(pct, width = 20) {
+  const filled = Math.floor(pct / (100 / width));
+  return "\u2588".repeat(filled) + "\u2591".repeat(width - filled);
+}
+function _num(n) {
+  return n.toLocaleString();
+}
+function renderIndexProgress(p) {
+  const pct = p.total > 0 ? Math.round(p.current / p.total * 100) : 0;
+  if (p.phase === "scanning") {
+    process.stdout.write(`  ${_v}\u2713 scanning${_r}   ${_v}${p.current}${_r} ${_d}files found${_r}
+`);
+  } else if (p.phase === "parsing") {
+    process.stdout.write(`\r  ${_v}parsing${_r}    [${_bar(pct)}] ${_v}${pct}%${_r}${" ".repeat(8)}`);
+    if (p.current === p.total) process.stdout.write("\n");
+  } else if (p.phase === "resolving") {
+    if (p.current === 0 && p.total <= 1) {
+      process.stdout.write(`\r  ${_v}resolving${_r}  cross-file references\u2026${" ".repeat(20)}`);
+    } else if (p.total > 0) {
+      const bar = _bar(pct);
+      const suffix = p.current === p.total ? `${_v}${p.current}${_r}${_d}/${p.total} refs${_r}
+` : `${_v}${p.current}${_r}${_d}/${p.total}${_r}${" ".repeat(10)}`;
+      const prefix = p.current === p.total ? `\r  ${_v}\u2713 resolving${_r}` : `\r  ${_v}resolving${_r} `;
+      process.stdout.write(`${prefix} [${bar}] ${suffix}`);
+    }
+  } else if (p.phase === "detecting frameworks") {
+    if (p.current === 1) {
+      const frameworks = p.meta?.frameworks ?? [];
+      const languages = p.meta?.languages ?? [];
+      const fwLabel = frameworks.length > 0 ? `${_v}${frameworks.join(", ")}${_r}` : `${_d}none${_r}`;
+      const langLabel = languages.length > 0 ? `${_v}${languages.join(", ")}${_r}` : `${_d}none${_r}`;
+      process.stdout.write(`  ${_v}\u2713 languages${_r}  detected: ${langLabel}
+`);
+      process.stdout.write(`  ${_v}\u2713 frameworks${_r} detected: ${fwLabel}
+`);
+    }
+  } else if (p.phase === "embeddings") {
+    if (p.current === -1) {
+      process.stdout.write(`
+  \x1B[33m\u26A0 Large codebase: ${_num(p.total)} embeddable symbols detected.\x1B[0m
+`);
+      process.stdout.write(`  \x1B[33m  Embedding may be slow or memory-intensive. Consider setting enableEmbeddings: false\x1B[0m
+`);
+      process.stdout.write(`  \x1B[33m  for codebases this large, or use a lighter model (e.g. Xenova/all-MiniLM-L6-v2).\x1B[0m
+
+`);
+    } else {
+      process.stdout.write(`\r  ${_v}embeddings${_r} [${_bar(pct)}] ${_v}${pct}%${_r}${" ".repeat(10)}`);
+      if (p.current === p.total && p.total > 0) process.stdout.write("\n");
+    }
+  } else {
+    process.stdout.write(`\r  ${_v}${p.phase}${_r}  ${p.current}/${p.total}${" ".repeat(20)}`);
+  }
+}
+function renderSyncProgress(p) {
+  const pct = p.total > 0 ? Math.round(p.current / p.total * 100) : 0;
+  if (p.phase === "scanning") {
+    if (p.current > 0) {
+      process.stdout.write(`\r  ${_v}\u2713 scanning${_r}   ${_v}${_num(p.current)}${_r} ${_d}files found${_r}
+`);
+    } else {
+      process.stdout.write(`\r  ${_v}scanning${_r}    ${_d}detecting changes\u2026${_r}${" ".repeat(20)}`);
+    }
+  } else if (p.phase === "parsing") {
+    process.stdout.write(`\r  ${_v}parsing${_r}    [${_bar(pct)}] ${_v}${pct}%${_r}${" ".repeat(8)}`);
+    if (p.current === p.total) process.stdout.write("\n");
+  } else if (p.phase === "resolving") {
+    if (p.current === 0 && p.total <= 1) {
+      process.stdout.write(`\r  ${_v}resolving${_r}  cross-file references\u2026${" ".repeat(20)}`);
+    } else if (p.total > 0) {
+      const bar = _bar(pct);
+      const suffix = p.current === p.total ? `${_v}${_num(p.current)}${_r}${_d}/${_num(p.total)} refs${_r}
+` : `${_v}${_num(p.current)}${_r}${_d}/${_num(p.total)}${_r}${" ".repeat(10)}`;
+      const prefix = p.current === p.total ? `\r  ${_v}\u2713 resolving${_r}` : `\r  ${_v}resolving${_r} `;
+      process.stdout.write(`${prefix} [${bar}] ${suffix}`);
+    }
+  } else if (p.phase === "embeddings") {
+    if (p.current === -1) {
+      process.stdout.write(`
+  \x1B[33m\u26A0 Large codebase: ${_num(p.total)} embeddable symbols detected.\x1B[0m
+`);
+      process.stdout.write(`  \x1B[33m  Embedding may be slow or memory-intensive. Consider setting enableEmbeddings: false\x1B[0m
+`);
+      process.stdout.write(`  \x1B[33m  for codebases this large, or use a lighter model (e.g. Xenova/all-MiniLM-L6-v2).\x1B[0m
+
+`);
+    } else {
+      process.stdout.write(`\r  ${_v}embeddings${_r} [${_bar(pct)}] ${_v}${pct}%${_r}${" ".repeat(10)}`);
+      if (p.current === p.total && p.total > 0) process.stdout.write("\n");
+    }
+  } else {
+    process.stdout.write(`\r  ${_v}${p.phase}${_r}  ${p.current}/${p.total}${" ".repeat(20)}`);
+  }
+}
+function renderSyncProgressVerbose(p) {
+  if (p.phase === "scanning") {
+    if (p.meta?.excludeCleanup && p.meta.file) {
+      process.stdout.write(`  ${_d}exclude${_r}  ${_d}${p.meta.file}${_r}
+`);
+    } else if (p.current > 0) {
+      process.stdout.write(`  ${_v}\u2713 scanning${_r}   ${_v}${_num(p.current)}${_r} ${_d}files found${_r}
+`);
+    } else {
+      process.stdout.write(`  ${_v}scanning${_r}    ${_d}detecting changes\u2026${_r}
+`);
+    }
+  } else if (p.phase === "parsing") {
+    if (p.currentFile) {
+      const short = p.currentFile.length > 60 ? "\u2026" + p.currentFile.slice(p.currentFile.length - 59) : p.currentFile;
+      process.stdout.write(`  ${_v}parse${_r}  ${_d}[${_num(p.current)}/${_num(p.total)}]${_r}  ${short}
+`);
+    }
+  } else if (p.phase === "resolving") {
+    if (p.current === 0 && p.total <= 1) {
+      process.stdout.write(`  ${_v}resolving${_r}  cross-file references\u2026
+`);
+    } else if (p.total > 0 && p.current === p.total) {
+      process.stdout.write(`  ${_v}\u2713 resolving${_r}  ${_v}${_num(p.current)}${_r}${_d}/${_num(p.total)} refs${_r}
+`);
+    }
+  } else if (p.phase === "embeddings") {
+    if (p.current === -1) {
+      process.stdout.write(`
+  \x1B[33m\u26A0 Large codebase: ${_num(p.total)} embeddable symbols detected.\x1B[0m
+`);
+      process.stdout.write(`  \x1B[33m  Embedding may be slow or memory-intensive. Consider setting enableEmbeddings: false\x1B[0m
+`);
+      process.stdout.write(`  \x1B[33m  for codebases this large, or use a lighter model (e.g. Xenova/all-MiniLM-L6-v2).\x1B[0m
+
+`);
+    } else {
+      const pct = p.total > 0 ? Math.round(p.current / p.total * 100) : 0;
+      process.stdout.write(`\r  ${_v}embeddings${_r} [${_bar(pct)}] ${_v}${pct}%${_r}${" ".repeat(10)}`);
+      if (p.current === p.total && p.total > 0) process.stdout.write("\n");
+    }
+  } else if (p.phase === "architecture") {
+    if (p.meta?.msg) {
+      process.stdout.write(`  ${_v}architecture${_r}  ${_d}${p.meta.msg}${_r}
+`);
+    } else if (p.current === p.total && p.total > 0) {
+      process.stdout.write(`  ${_v}\u2713 architecture${_r}
+`);
+    }
+  } else {
+    process.stdout.write(`  ${_v}${p.phase}${_r}  ${p.current}/${p.total}
+`);
+  }
+}
+function renderSyncSummary(result) {
+  const secs = (result.duration / 1e3).toFixed(1);
+  const filesChanged = result.added.length + result.modified.length;
+  const filesDeleted = result.removed.length;
+  console.log(`
+  ${_g}\u2713${_r} sync complete ${_d}(${secs}s)${_r}`);
+  console.log(`    ${_d}files scanned:${_r}  ${_v}${_num(result.filesScanned)}${_r}`);
+  console.log(`    ${_d}files changed:${_r}  ${_v}${_num(filesChanged)}${_r}`);
+  console.log(`    ${_d}files deleted:${_r}  ${_v}${_num(filesDeleted)}${_r}`);
+  console.log(`    ${_d}nodes added:${_r}    ${_v}${_num(result.nodesCreated)}${_r}`);
+  console.log(`    ${_d}nodes updated:${_r}  ${_v}${_num(result.nodesUpdated)}${_r}`);
+  console.log(`    ${_d}nodes removed:${_r}  ${_v}${_num(result.nodesRemoved)}${_r}`);
+  console.log(`    ${_d}edges added:${_r}    ${_v}${_num(result.edgesCreated)}${_r}`);
+  console.log(`    ${_d}edges removed:${_r}  ${_v}${_num(result.edgesRemoved)}${_r}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  renderIndexProgress,
+  renderSyncProgress,
+  renderSyncProgressVerbose,
+  renderSyncSummary
+});
+//# sourceMappingURL=progress.js.map