kirograph 0.17.0 → 0.20.0

package/dist/bin/commands/flows.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function register(program: Command): void;
+//# sourceMappingURL=flows.d.ts.map

package/dist/bin/commands/flows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/flows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+D/C"}

package/dist/bin/commands/flows.js

@@ -0,0 +1,97 @@
+"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 flows_exports = {};
+__export(flows_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(flows_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("flows [projectPath]").description("Trace execution flows from entry points through the call graph").option("--entry <symbol>", "Trace from a specific symbol (auto-detects if omitted)").option("--max-flows <n>", "Max flows to return", "10").option("--max-depth <n>", "Max call chain depth", "10").option("--json", "Output as JSON").action(async (projectPath, opts) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const target = path.resolve(projectPath ?? process.cwd());
+    const cg = await KiroGraph.open(target);
+    const { getExecutionFlows, traceFlow, detectEntryPoints } = await Promise.resolve().then(() => require("../../graph/flows.js"));
+    const db = cg.getDatabase();
+    if (opts.entry) {
+      const results = cg.searchNodes(opts.entry, void 0, 5);
+      if (results.length === 0) {
+        console.error(`  Symbol "${opts.entry}" not found.`);
+        cg.close();
+        process.exit(1);
+      }
+      const hops = traceFlow(db, results[0].node.id, parseInt(opts.maxDepth));
+      if (opts.json) {
+        console.log(JSON.stringify(hops, null, 2));
+      } else {
+        console.log(`
+  ${import_ui.bold}Flow from${import_ui.reset} ${import_ui.violet}${opts.entry}${import_ui.reset}
+`);
+        for (let i = 0; i < hops.length; i++) {
+          const hop = hops[i];
+          const indent = "  ".repeat(i + 1);
+          const arrow = i === 0 ? "\u2192" : "\u21B3";
+          const conf = hop.confidence && hop.confidence !== "extracted" ? ` ${import_ui.dim}[${hop.confidence}]${import_ui.reset}` : "";
+          console.log(`${indent}${arrow} ${hop.kind} ${import_ui.violet}${hop.symbol}${import_ui.reset} \u2014 ${import_ui.dim}${hop.filePath}:${hop.line}${import_ui.reset}${conf}`);
+        }
+      }
+    } else {
+      const flows = getExecutionFlows(db, {
+        maxFlows: parseInt(opts.maxFlows),
+        maxDepth: parseInt(opts.maxDepth)
+      });
+      if (opts.json) {
+        console.log(JSON.stringify(flows, null, 2));
+      } else {
+        console.log(`
+  ${import_ui.bold}Execution Flows${import_ui.reset} (${flows.length} detected)
+`);
+        for (const flow of flows) {
+          console.log(`  ${import_ui.green}${flow.entryPoint}${import_ui.reset} (${flow.entryPointKind}) \u2014 criticality: ${flow.criticality.toFixed(2)}`);
+          console.log(`  ${import_ui.dim}${flow.entryPointFile}${import_ui.reset}`);
+          for (let i = 0; i < Math.min(flow.hops.length, 6); i++) {
+            const hop = flow.hops[i];
+            const indent = "  " + "  ".repeat(i);
+            const arrow = i === 0 ? "\u2192" : "\u21B3";
+            console.log(`${indent}${arrow} ${import_ui.dim}${hop.symbol}${import_ui.reset}`);
+          }
+          if (flow.hops.length > 6) console.log(`    ${import_ui.dim}\u2026and ${flow.hops.length - 6} more hops${import_ui.reset}`);
+          console.log();
+        }
+      }
+    }
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=flows.js.map

package/dist/bin/commands/flows.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/flows.ts"],
+  "sourcesContent": ["import { Command } from 'commander';\nimport * as path from 'path';\nimport { dim, reset, violet, bold, green } from '../ui';\n\nexport function register(program: Command): void {\n  program\n    .command('flows [projectPath]')\n    .description('Trace execution flows from entry points through the call graph')\n    .option('--entry <symbol>', 'Trace from a specific symbol (auto-detects if omitted)')\n    .option('--max-flows <n>', 'Max flows to return', '10')\n    .option('--max-depth <n>', 'Max call chain depth', '10')\n    .option('--json', 'Output as JSON')\n    .action(async (projectPath: string | undefined, opts: { entry?: string; maxFlows: string; maxDepth: string; json?: boolean }) => {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const target = path.resolve(projectPath ?? process.cwd());\n      const cg = await KiroGraph.open(target);\n      const { getExecutionFlows, traceFlow, detectEntryPoints } = await Promise.resolve().then(() => require('../../graph/flows.js'));\n      const db = cg.getDatabase();\n\n      if (opts.entry) {\n        const results = cg.searchNodes(opts.entry, undefined, 5);\n        if (results.length === 0) {\n          console.error(`  Symbol \"${opts.entry}\" not found.`);\n          cg.close();\n          process.exit(1);\n        }\n        const hops = traceFlow(db, results[0].node.id, parseInt(opts.maxDepth));\n\n        if (opts.json) {\n          console.log(JSON.stringify(hops, null, 2));\n        } else {\n          console.log(`\\n  ${bold}Flow from${reset} ${violet}${opts.entry}${reset}\\n`);\n          for (let i = 0; i < hops.length; i++) {\n            const hop = hops[i];\n            const indent = '  '.repeat(i + 1);\n            const arrow = i === 0 ? '\u2192' : '\u21B3';\n            const conf = hop.confidence && hop.confidence !== 'extracted' ? ` ${dim}[${hop.confidence}]${reset}` : '';\n            console.log(`${indent}${arrow} ${hop.kind} ${violet}${hop.symbol}${reset} \u2014 ${dim}${hop.filePath}:${hop.line}${reset}${conf}`);\n          }\n        }\n      } else {\n        const flows = getExecutionFlows(db, {\n          maxFlows: parseInt(opts.maxFlows),\n          maxDepth: parseInt(opts.maxDepth),\n        });\n\n        if (opts.json) {\n          console.log(JSON.stringify(flows, null, 2));\n        } else {\n          console.log(`\\n  ${bold}Execution Flows${reset} (${flows.length} detected)\\n`);\n          for (const flow of flows) {\n            console.log(`  ${green}${flow.entryPoint}${reset} (${flow.entryPointKind}) \u2014 criticality: ${flow.criticality.toFixed(2)}`);\n            console.log(`  ${dim}${flow.entryPointFile}${reset}`);\n            for (let i = 0; i < Math.min(flow.hops.length, 6); i++) {\n              const hop = flow.hops[i];\n              const indent = '  ' + '  '.repeat(i);\n              const arrow = i === 0 ? '\u2192' : '\u21B3';\n              console.log(`${indent}${arrow} ${dim}${hop.symbol}${reset}`);\n            }\n            if (flow.hops.length > 6) console.log(`    ${dim}\u2026and ${flow.hops.length - 6} more hops${reset}`);\n            console.log();\n          }\n        }\n      }\n\n      cg.close();\n    });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/bin/commands/gain.d.ts

@@ -0,0 +1,6 @@
+/**
+ * kirograph gain — Token savings analytics CLI command
+ */
+import { Command } from 'commander';
+export declare function register(program: Command): void;
+//# sourceMappingURL=gain.d.ts.map

package/dist/bin/commands/gain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gain.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/gain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkH/C"}

package/dist/bin/commands/help.d.ts

@@ -1,4 +1,11 @@
 import { Command } from 'commander';
+/**
+ * Interactive tabbed help — left/right for tabs, up/down for commands, enter to copy.
+ */
+export declare function printInteractiveHelp(): void;
+/**
+ * Non-interactive full help (for piping, --help flag).
+ */
 export declare function printColoredHelp(): void;
 export declare function register(program: Command): void;
 //# sourceMappingURL=help.d.ts.map

package/dist/bin/commands/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,gBAAgB,IAAI,IAAI,CA0EvC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS/C"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0QpC;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAiG3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAkIvC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAK/C"}