kirograph 0.16.1 → 0.19.0

package/dist/bin/commands/data.js

@@ -0,0 +1,665 @@
+"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 data_exports = {};
+__export(data_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(data_exports);
+var import_config = require("../../config");
+var import_ui = require("../ui");
+function register(program) {
+  const data = program.command("data").description("Tabular data navigation (requires enableData: true)");
+  data.command("list").description("List all indexed datasets").option("--json", "Output as JSON").action(async (opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      console.error(`  ${import_ui.dim}Then re-run:${import_ui.reset} ${import_ui.violet}${import_ui.bold}kirograph index${import_ui.reset}`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized. Run: kirograph init");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataQueries } = await Promise.resolve().then(() => require("../../data/queries.js"));
+    const dq = new DataQueries(db.getRawDb());
+    const datasets = dq.listDatasets();
+    if (datasets.length === 0) {
+      console.log(`  ${import_ui.dim}No datasets indexed.${import_ui.reset} Run ${import_ui.violet}${import_ui.bold}kirograph index${import_ui.reset} first.`);
+      cg.close();
+      return;
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(datasets, null, 2));
+    } else {
+      console.log(`
+  ${import_ui.bold}Indexed Datasets${import_ui.reset} (${datasets.length})
+`);
+      for (const ds of datasets) {
+        const sizeMb = (ds.fileSize / 1024 / 1024).toFixed(2);
+        console.log(`  ${import_ui.green}${ds.id}${import_ui.reset}`);
+        console.log(`    ${import_ui.dim}File:${import_ui.reset} ${ds.filePath}  ${import_ui.dim}Format:${import_ui.reset} ${ds.format}`);
+        console.log(`    ${import_ui.dim}Rows:${import_ui.reset} ${ds.rowCount.toLocaleString()}  ${import_ui.dim}Columns:${import_ui.reset} ${ds.columnCount}  ${import_ui.dim}Size:${import_ui.reset} ${sizeMb} MB`);
+        console.log();
+      }
+    }
+    cg.close();
+  });
+  data.command("describe <dataset>").description("Show schema and column profiles for a dataset").option("--column <name>", "Deep dive on a single column").option("--json", "Output as JSON").action(async (dataset, opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataQueries } = await Promise.resolve().then(() => require("../../data/queries.js"));
+    const dq = new DataQueries(db.getRawDb());
+    if (opts.column) {
+      const col = dq.describeColumn(dataset, opts.column);
+      if (!col) {
+        console.error(`  \u2716 Column "${opts.column}" not found in dataset "${dataset}".`);
+        cg.close();
+        process.exit(1);
+      }
+      if (opts.json) {
+        console.log(JSON.stringify(col, null, 2));
+      } else {
+        console.log(`
+  ${import_ui.bold}${col.name}${import_ui.reset} ${import_ui.dim}(${col.inferredType})${import_ui.reset}`);
+        console.log(`    ${import_ui.dim}Position:${import_ui.reset}    ${col.position}`);
+        console.log(`    ${import_ui.dim}Nullable:${import_ui.reset}    ${col.nullable ? "yes" : "no"} (${col.nullPct.toFixed(1)}% null, ${col.nullCount} nulls)`);
+        console.log(`    ${import_ui.dim}Cardinality:${import_ui.reset} ${col.cardinality}`);
+        if (col.minValue != null) console.log(`    ${import_ui.dim}Min:${import_ui.reset}         ${col.minValue}`);
+        if (col.maxValue != null) console.log(`    ${import_ui.dim}Max:${import_ui.reset}         ${col.maxValue}`);
+        if (col.meanValue != null) console.log(`    ${import_ui.dim}Mean:${import_ui.reset}        ${col.meanValue.toFixed(4)}`);
+        if (col.sampleValues.length > 0) console.log(`    ${import_ui.dim}Samples:${import_ui.reset}     ${col.sampleValues.join(", ")}`);
+        console.log();
+      }
+      cg.close();
+      return;
+    }
+    const info = dq.describeDataset(dataset);
+    if (!info) {
+      console.error(`  \u2716 Dataset "${dataset}" not found. Run ${import_ui.violet}${import_ui.bold}kirograph data list${import_ui.reset} to see available datasets.`);
+      cg.close();
+      process.exit(1);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(info, null, 2));
+    } else {
+      const ds = info.dataset;
+      const sizeMb = (ds.fileSize / 1024 / 1024).toFixed(2);
+      console.log(`
+  ${import_ui.bold}${ds.id}${import_ui.reset}`);
+      console.log(`  ${import_ui.dim}File:${import_ui.reset} ${ds.filePath}  ${import_ui.dim}Format:${import_ui.reset} ${ds.format}  ${import_ui.dim}Size:${import_ui.reset} ${sizeMb} MB`);
+      console.log(`  ${import_ui.dim}Rows:${import_ui.reset} ${ds.rowCount.toLocaleString()}  ${import_ui.dim}Columns:${import_ui.reset} ${ds.columnCount}`);
+      console.log(`
+  ${import_ui.bold}Columns:${import_ui.reset}
+`);
+      const maxNameLen = Math.max(...info.columns.map((c) => c.name.length), 4);
+      console.log(`  ${"Name".padEnd(maxNameLen)}  ${"Type".padEnd(8)}  ${"Null%".padEnd(6)}  ${"Card".padEnd(6)}  Samples`);
+      console.log(`  ${"-".repeat(maxNameLen)}  ${"-".repeat(8)}  ${"-".repeat(6)}  ${"-".repeat(6)}  -------`);
+      for (const col of info.columns) {
+        const nullPct = col.nullPct > 0 ? `${col.nullPct.toFixed(1)}%` : "0%";
+        const samples = col.sampleValues.slice(0, 3).join(", ");
+        console.log(`  ${col.name.padEnd(maxNameLen)}  ${col.inferredType.padEnd(8)}  ${nullPct.padEnd(6)}  ${String(col.cardinality).padEnd(6)}  ${import_ui.dim}${samples}${import_ui.reset}`);
+      }
+      console.log();
+    }
+    cg.close();
+  });
+  data.command("query <dataset>").description("Query rows with filters").option("--filter <expr...>", "Filters in format column:op:value (e.g. age:gt:18)").option("--columns <cols>", "Comma-separated column names to project").option("--limit <n>", "Max rows to return", "20").option("--offset <n>", "Offset for pagination", "0").option("--json", "Output as JSON").action(async (dataset, opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataQueries } = await Promise.resolve().then(() => require("../../data/queries.js"));
+    const dq = new DataQueries(db.getRawDb());
+    const filters = (opts.filter ?? []).map((f) => {
+      const parts = f.split(":");
+      if (parts.length < 3) {
+        console.error(`  \u2716 Invalid filter format: "${f}". Expected column:op:value`);
+        process.exit(1);
+      }
+      const column = parts[0];
+      const op = parts[1];
+      const val = parts.slice(2).join(":");
+      return { column, op, value: val };
+    });
+    const columns = opts.columns ? opts.columns.split(",").map((c) => c.trim()) : void 0;
+    const limit = parseInt(opts.limit ?? "20", 10);
+    const offset = parseInt(opts.offset ?? "0", 10);
+    const result = dq.queryRows(dataset, { filters, columns, limit, offset });
+    if (!result) {
+      console.error(`  \u2716 Dataset "${dataset}" not found.`);
+      cg.close();
+      process.exit(1);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`
+  ${import_ui.dim}Showing ${result.rows.length} of ${result.totalMatching} matching rows${import_ui.reset}
+`);
+      if (result.rows.length > 0) {
+        const keys = Object.keys(result.rows[0]).filter((k) => k !== "rowid");
+        const widths = keys.map((k) => Math.max(k.length, ...result.rows.map((r) => String(r[k] ?? "").slice(0, 30).length)));
+        console.log("  " + keys.map((k, i) => k.padEnd(widths[i])).join("  "));
+        console.log("  " + widths.map((w) => "-".repeat(w)).join("  "));
+        for (const row of result.rows) {
+          console.log("  " + keys.map((k, i) => String(row[k] ?? "").slice(0, 30).padEnd(widths[i])).join("  "));
+        }
+      }
+      console.log();
+    }
+    cg.close();
+  });
+  data.command("aggregate <dataset>").description("Server-side aggregation (GROUP BY)").requiredOption("--group-by <cols>", "Comma-separated columns to group by").requiredOption("--metric <expr...>", "Metrics in format op:column (e.g. sum:amount, avg:price)").option("--filter <expr...>", "Filters in format column:op:value").option("--json", "Output as JSON").action(async (dataset, opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataQueries } = await Promise.resolve().then(() => require("../../data/queries.js"));
+    const dq = new DataQueries(db.getRawDb());
+    const groupBy = opts.groupBy.split(",").map((c) => c.trim());
+    const metrics = opts.metric.map((m) => {
+      const [op, ...colParts] = m.split(":");
+      const column = colParts.join(":");
+      if (!op || !column) {
+        console.error(`  \u2716 Invalid metric format: "${m}". Expected op:column (e.g. sum:amount)`);
+        process.exit(1);
+      }
+      return { op, column };
+    });
+    const filters = (opts.filter ?? []).map((f) => {
+      const parts = f.split(":");
+      if (parts.length < 3) {
+        console.error(`  \u2716 Invalid filter: "${f}"`);
+        process.exit(1);
+      }
+      return { column: parts[0], op: parts[1], value: parts.slice(2).join(":") };
+    });
+    const result = dq.aggregate(dataset, { groupBy, metrics, filters });
+    if (!result) {
+      console.error(`  \u2716 Dataset "${dataset}" not found.`);
+      cg.close();
+      process.exit(1);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`
+  ${import_ui.dim}${result.rows.length} groups${import_ui.reset}
+`);
+      if (result.rows.length > 0) {
+        const keys = Object.keys(result.rows[0]);
+        const widths = keys.map((k) => Math.max(k.length, ...result.rows.map((r) => String(r[k] ?? "").slice(0, 20).length)));
+        console.log("  " + keys.map((k, i) => k.padEnd(widths[i])).join("  "));
+        console.log("  " + widths.map((w) => "-".repeat(w)).join("  "));
+        for (const row of result.rows) {
+          console.log("  " + keys.map((k, i) => String(row[k] ?? "").slice(0, 20).padEnd(widths[i])).join("  "));
+        }
+      }
+      console.log();
+    }
+    cg.close();
+  });
+  data.command("search <dataset> <query>").description("Search column names and sample values by keyword").option("--json", "Output as JSON").action(async (dataset, query, opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataQueries } = await Promise.resolve().then(() => require("../../data/queries.js"));
+    const dq = new DataQueries(db.getRawDb());
+    const results = dq.searchColumns(dataset, query);
+    if (results.length === 0) {
+      console.log(`  ${import_ui.dim}No columns matching "${query}" in dataset "${dataset}".${import_ui.reset}`);
+      cg.close();
+      return;
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(results, null, 2));
+    } else {
+      console.log(`
+  ${import_ui.bold}Columns matching "${query}"${import_ui.reset} (${results.length})
+`);
+      for (const col of results) {
+        const samples = col.sampleValues.slice(0, 5).join(", ");
+        console.log(`  ${import_ui.green}${col.name}${import_ui.reset} ${import_ui.dim}(${col.inferredType})${import_ui.reset}`);
+        console.log(`    ${import_ui.dim}Cardinality:${import_ui.reset} ${col.cardinality}  ${import_ui.dim}Null:${import_ui.reset} ${col.nullPct.toFixed(1)}%`);
+        if (samples) console.log(`    ${import_ui.dim}Samples:${import_ui.reset} ${samples}`);
+        console.log();
+      }
+    }
+    cg.close();
+  });
+  data.command("index").description("Index all data files (incremental)").option("--json", "Output as JSON").action(async (opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      console.error(`  ${import_ui.dim}Then re-run:${import_ui.reset} ${import_ui.violet}${import_ui.bold}kirograph index${import_ui.reset}`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized. Run: kirograph init");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataIndexer } = await Promise.resolve().then(() => require("../../data/indexer.js"));
+    const indexer = new DataIndexer(db.getRawDb(), config, cwd);
+    const result = await indexer.indexAll({
+      onProgress: (msg) => {
+        if (!opts.json) console.log(`  ${import_ui.dim}${msg}${import_ui.reset}`);
+      }
+    });
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`
+  ${import_ui.green}\u2713${import_ui.reset} Indexed ${import_ui.bold}${result.datasetsIndexed}${import_ui.reset} datasets, ${result.rowsIndexed.toLocaleString()} rows, ${result.columnsProfiled} columns (${result.duration}ms)`);
+      if (result.errors.length > 0) {
+        console.log(`  ${import_ui.dim}Errors (${result.errors.length}):${import_ui.reset}`);
+        for (const err of result.errors.slice(0, 5)) {
+          console.log(`    \u2716 ${err}`);
+        }
+      }
+      console.log();
+    }
+    cg.close();
+  });
+  data.command("reindex").description("Force re-index all data files (ignores content hashes)").option("--json", "Output as JSON").action(async (opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataIndexer } = await Promise.resolve().then(() => require("../../data/indexer.js"));
+    const indexer = new DataIndexer(db.getRawDb(), config, cwd);
+    const result = await indexer.indexAll({
+      force: true,
+      onProgress: (msg) => {
+        if (!opts.json) console.log(`  ${import_ui.dim}${msg}${import_ui.reset}`);
+      }
+    });
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`
+  ${import_ui.green}\u2713${import_ui.reset} Re-indexed ${import_ui.bold}${result.datasetsIndexed}${import_ui.reset} datasets, ${result.rowsIndexed.toLocaleString()} rows, ${result.columnsProfiled} columns (${result.duration}ms)`);
+      if (result.errors.length > 0) {
+        console.log(`  ${import_ui.dim}Errors (${result.errors.length}):${import_ui.reset}`);
+        for (const err of result.errors.slice(0, 5)) {
+          console.log(`    \u2716 ${err}`);
+        }
+      }
+      console.log();
+    }
+    cg.close();
+  });
+  data.command("join <left> <right>").description("SQL JOIN across two indexed datasets").requiredOption("--left-col <col>", "Join column from left dataset").requiredOption("--right-col <col>", "Join column from right dataset").option("--type <type>", "Join type: inner, left, right", "inner").option("--columns <cols>", "Comma-separated column projection (prefix with dataset ID)").option("--limit <n>", "Max rows", "100").option("--json", "Output as JSON").action(async (left, right, opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataQueries } = await Promise.resolve().then(() => require("../../data/queries.js"));
+    const dq = new DataQueries(db.getRawDb());
+    try {
+      const result = dq.join({
+        left,
+        right,
+        leftColumn: opts.leftCol,
+        rightColumn: opts.rightCol,
+        type: opts.type ?? "inner",
+        columns: opts.columns ? opts.columns.split(",").map((c) => c.trim()) : void 0,
+        limit: parseInt(opts.limit ?? "100", 10)
+      });
+      if (!result) {
+        console.error(`  \u2716 One or both datasets not found. Run ${import_ui.violet}${import_ui.bold}kirograph data list${import_ui.reset} to see available datasets.`);
+        cg.close();
+        process.exit(1);
+      }
+      if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(`
+  ${import_ui.dim}${opts.type?.toUpperCase() ?? "INNER"} JOIN: ${left}.${opts.leftCol} = ${right}.${opts.rightCol}${import_ui.reset}`);
+        console.log(`  ${import_ui.dim}Showing ${result.rows.length} of ${result.totalMatching} matching rows${import_ui.reset}
+`);
+        if (result.rows.length > 0) {
+          const keys = Object.keys(result.rows[0]);
+          const widths = keys.map((k) => Math.max(k.length, ...result.rows.map((r) => String(r[k] ?? "").slice(0, 25).length)));
+          console.log("  " + keys.map((k, i) => k.padEnd(widths[i])).join("  "));
+          console.log("  " + widths.map((w) => "-".repeat(w)).join("  "));
+          for (const row of result.rows) {
+            console.log("  " + keys.map((k, i) => String(row[k] ?? "").slice(0, 25).padEnd(widths[i])).join("  "));
+          }
+        }
+        console.log();
+      }
+    } catch (err) {
+      console.error(`  \u2716 ${err instanceof Error ? err.message : String(err)}`);
+      cg.close();
+      process.exit(1);
+    }
+    cg.close();
+  });
+  data.command("correlations <dataset>").description("Pairwise Pearson correlations between numeric columns").option("--threshold <n>", "Min absolute correlation to include", "0.3").option("--json", "Output as JSON").action(async (dataset, opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataQueries } = await Promise.resolve().then(() => require("../../data/queries.js"));
+    const dq = new DataQueries(db.getRawDb());
+    const threshold = parseFloat(opts.threshold ?? "0.3");
+    const pairs = dq.correlations(dataset, threshold);
+    if (pairs === null) {
+      console.error(`  \u2716 Dataset "${dataset}" not found.`);
+      cg.close();
+      process.exit(1);
+    }
+    if (pairs.length === 0) {
+      console.log(`  ${import_ui.dim}No correlations above threshold ${threshold}.${import_ui.reset}`);
+      cg.close();
+      return;
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(pairs, null, 2));
+    } else {
+      console.log(`
+  ${import_ui.bold}Correlations${import_ui.reset} (threshold: ${threshold}, ${pairs.length} pairs)
+`);
+      for (const p of pairs) {
+        const sign = p.correlation > 0 ? "+" : "";
+        const bar = "\u2588".repeat(Math.round(Math.abs(p.correlation) * 10));
+        const color = p.strength === "strong" ? import_ui.green : import_ui.dim;
+        console.log(`  ${color}${bar}${import_ui.reset} ${sign}${p.correlation.toFixed(4)}  ${p.column1} \u2194 ${p.column2}  ${import_ui.dim}(${p.strength})${import_ui.reset}`);
+      }
+      console.log();
+    }
+    cg.close();
+  });
+  data.command("quality <dataset>").description("Data quality triage: rank columns by risk").option("--json", "Output as JSON").action(async (dataset, opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataQueries } = await Promise.resolve().then(() => require("../../data/queries.js"));
+    const dq = new DataQueries(db.getRawDb());
+    const quality = dq.quality(dataset);
+    if (quality === null) {
+      console.error(`  \u2716 Dataset "${dataset}" not found.`);
+      cg.close();
+      process.exit(1);
+    }
+    if (quality.length === 0) {
+      console.log(`  ${import_ui.green}\u2713${import_ui.reset} No quality issues detected. All columns look healthy.`);
+      cg.close();
+      return;
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(quality, null, 2));
+    } else {
+      console.log(`
+  ${import_ui.bold}Quality Report${import_ui.reset} (${quality.length} columns with issues)
+`);
+      for (const q of quality) {
+        const pct = (q.riskScore * 100).toFixed(0);
+        const bar = "\u2588".repeat(Math.round(q.riskScore * 10));
+        console.log(`  ${bar} ${pct}%  ${import_ui.bold}${q.column}${import_ui.reset}`);
+        for (const issue of q.issues) {
+          console.log(`       ${import_ui.dim}\u2022 ${issue}${import_ui.reset}`);
+        }
+      }
+      console.log();
+    }
+    cg.close();
+  });
+  data.command("history <dataset>").description("Show history of schema changes for a dataset").option("--limit <n>", "Max snapshots to show", "10").option("--json", "Output as JSON").action(async (dataset, opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataQueries } = await Promise.resolve().then(() => require("../../data/queries.js"));
+    const dq = new DataQueries(db.getRawDb());
+    const limit = parseInt(opts.limit ?? "10", 10);
+    const history = dq.getHistory(dataset, limit);
+    if (history === null) {
+      console.error(`  \u2716 Dataset "${dataset}" not found.`);
+      cg.close();
+      process.exit(1);
+    }
+    if (history.length === 0) {
+      console.log(`  ${import_ui.dim}No history snapshots for "${dataset}".${import_ui.reset}`);
+      cg.close();
+      return;
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(history, null, 2));
+    } else {
+      console.log(`
+  ${import_ui.bold}Schema History${import_ui.reset} for ${import_ui.green}${dataset}${import_ui.reset} (${history.length} snapshots)
+`);
+      for (const snap of history) {
+        const date = new Date(snap.snapshotAt).toISOString().replace("T", " ").slice(0, 19);
+        console.log(`  ${import_ui.bold}${date}${import_ui.reset}`);
+        console.log(`    ${import_ui.dim}Rows:${import_ui.reset} ${snap.rowCount.toLocaleString()}  ${import_ui.dim}Columns:${import_ui.reset} ${snap.columnCount}  ${import_ui.dim}Hash:${import_ui.reset} ${snap.contentHash.slice(0, 12)}\u2026`);
+        const colNames = snap.columns.map((c) => c.name).join(", ");
+        console.log(`    ${import_ui.dim}Schema:${import_ui.reset} ${colNames}`);
+        console.log();
+      }
+    }
+    cg.close();
+  });
+  data.command("drift <dataset>").description("Show schema drift between last two indexes").option("--json", "Output as JSON").action(async (dataset, opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataQueries } = await Promise.resolve().then(() => require("../../data/queries.js"));
+    const dq = new DataQueries(db.getRawDb());
+    const drift = dq.detectDrift(dataset);
+    if (drift === null) {
+      console.error(`  \u2716 Dataset "${dataset}" not found.`);
+      cg.close();
+      process.exit(1);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(drift, null, 2));
+    } else {
+      if (!drift.hasDrift) {
+        console.log(`
+  ${import_ui.green}\u2713${import_ui.reset} No schema drift detected for "${dataset}".`);
+        if (drift.rowCountDelta !== 0) {
+          const sign = drift.rowCountDelta > 0 ? "+" : "";
+          console.log(`    ${import_ui.dim}Row count change:${import_ui.reset} ${sign}${drift.rowCountDelta}`);
+        }
+      } else {
+        console.log(`
+  ${import_ui.bold}Schema Drift${import_ui.reset} for ${import_ui.green}${dataset}${import_ui.reset}
+`);
+        if (drift.addedColumns.length > 0) {
+          console.log(`  ${import_ui.green}+ Added columns:${import_ui.reset} ${drift.addedColumns.join(", ")}`);
+        }
+        if (drift.removedColumns.length > 0) {
+          console.log(`  ${import_ui.value}\u2212 Removed columns:${import_ui.reset} ${drift.removedColumns.join(", ")}`);
+        }
+        if (drift.changedColumns.length > 0) {
+          console.log(`  ${import_ui.bold}~ Changed columns:${import_ui.reset}`);
+          for (const col of drift.changedColumns) {
+            console.log(`    ${col.name}: ${col.changes.join(", ")}`);
+          }
+        }
+        if (drift.rowCountDelta !== 0) {
+          const sign = drift.rowCountDelta > 0 ? "+" : "";
+          console.log(`
+  ${import_ui.dim}Row count change:${import_ui.reset} ${sign}${drift.rowCountDelta}`);
+        }
+      }
+      console.log();
+    }
+    cg.close();
+  });
+  data.command("lint").description("Validate data index integrity").option("--json", "Output as JSON").action(async (opts) => {
+    const cwd = process.cwd();
+    const config = await (0, import_config.loadConfig)(cwd);
+    if (!config.enableData) {
+      console.error(`  \u2716 Data indexing is not enabled. Set ${import_ui.violet}${import_ui.bold}enableData: true${import_ui.reset} in .kirograph/config.json`);
+      process.exit(1);
+    }
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(cwd)) {
+      console.error("  \u2716 KiroGraph not initialized.");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(cwd);
+    const db = cg.getDatabase();
+    db.applyDataSchema();
+    const { DataLinter } = await Promise.resolve().then(() => require("../../data/lint.js"));
+    const linter = new DataLinter(db.getRawDb(), cwd);
+    const result = linter.lint();
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`
+  ${import_ui.bold}Data Lint${import_ui.reset} \u2014 ${result.datasetsChecked} datasets checked, ${result.healthy} healthy
+`);
+      if (result.issues.length === 0) {
+        console.log(`  ${import_ui.green}\u2713${import_ui.reset} No issues found. Index is healthy.`);
+      } else {
+        for (const issue of result.issues) {
+          const icon = issue.severity === "error" ? "\u2716" : issue.severity === "warning" ? "\u26A0" : "\u2139";
+          const prefix = issue.dataset ? `[${issue.dataset}] ` : "";
+          console.log(`  ${icon} ${prefix}${issue.message}`);
+        }
+      }
+      console.log();
+    }
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=data.js.map