@ddt-tools/cli 0.2.0 → 0.2.4

package/dist/perf-UULZSREY.js

@@ -0,0 +1,200 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/perf.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import { loadProject, parseProjectModel } from "@ddt-tools/core/project";
+import {
+  findMaterializedViewCandidates,
+  findUnusedObjects,
+  recommendWarehouseSize,
+  renderMvCandidatesMarkdown,
+  renderUnusedObjectsMarkdown,
+  renderWarehouseSizingMarkdown
+} from "@ddt-tools/core/perf";
+var COLD_START_BUDGET_MS = 200;
+function perfCommand() {
+  const cmd = new Command("perf");
+  cmd.description("CLI performance diagnostics (cold-start audit, hot-path profiling).");
+  const coldStart = new Command("cold-start");
+  coldStart.description("Measure CLI cold-start latency and compare against the 200ms budget.").option("--json", "Emit JSON instead of human-readable output.", false).option(
+    "--budget <ms>",
+    "Override the pass/fail threshold in ms.",
+    String(COLD_START_BUDGET_MS)
+  ).action((opts) => {
+    const startNs = globalThis.__DDT_START_NS__;
+    const nowNs = process.hrtime.bigint();
+    const budgetMs = Number(opts.budget ?? COLD_START_BUDGET_MS);
+    let elapsedMs = null;
+    if (startNs !== void 0) {
+      elapsedMs = Number(nowNs - startNs) / 1e6;
+    }
+    const pass = elapsedMs !== null && elapsedMs <= budgetMs;
+    const note = elapsedMs === null ? "Start timestamp not recorded \u2014 add `globalThis.__DDT_START_NS__ = process.hrtime.bigint()` to the CLI entry point." : pass ? `\u2713 ${elapsedMs.toFixed(1)} ms \u2264 ${budgetMs} ms budget` : `\u2717 ${elapsedMs.toFixed(1)} ms > ${budgetMs} ms budget \u2014 see docs/CONTRIBUTING.md for lazy-load patterns`;
+    if (opts.json) {
+      process.stdout.write(JSON.stringify({ elapsedMs, budgetMs, pass, note }, null, 2) + "\n");
+    } else {
+      console.log(`ddt cold-start: ${note}`);
+      if (elapsedMs !== null) {
+        const bar = "\u2588".repeat(Math.min(40, Math.round(elapsedMs / budgetMs * 40)));
+        const pct = (elapsedMs / budgetMs * 100).toFixed(0);
+        console.log(`  ${bar} ${pct}% of ${budgetMs}ms budget`);
+      }
+    }
+    process.exitCode = pass ? 0 : 1;
+  });
+  cmd.addCommand(coldStart);
+  const unused = new Command("unused");
+  unused.description(
+    "Find project objects unreferenced for \u2265 --threshold-days in a query-history snapshot (PERF.6). Offline \u2014 feeds a JSON array of QueryHistoryEntry via --history-file."
+  ).requiredOption("-p, --project <path>", "Path to the .ddtproj file.").requiredOption(
+    "--history-file <path>",
+    "Path to a JSON file containing a QueryHistoryEntry[] (e.g. saved from `ddt history --last 1000 --format json`)."
+  ).option("--threshold-days <n>", "Days-of-inactivity cutoff (default 30).", "30").option(
+    "--reference-date <iso>",
+    'ISO-8601 timestamp used as "now" (default: most recent entry).'
+  ).option("--format <fmt>", "Output format: text | json. Default text.", "text").option("-o, --out <path>", "Write report to a file instead of stdout.").action(async (opts) => {
+    const loaded = await loadProject(String(opts.project));
+    const model = await parseProjectModel(loaded);
+    const testable = /* @__PURE__ */ new Set([
+      "TABLE",
+      "MANAGED_TABLE",
+      "EXTERNAL_TABLE",
+      "VIEW",
+      "MATERIALIZED_VIEW",
+      "STREAMING_TABLE"
+    ]);
+    const fqns = [];
+    for (const obj of model) {
+      if (!testable.has(obj.objectType)) continue;
+      const cat = obj.fqn.database;
+      const sc = obj.fqn.schema;
+      if (!cat || !sc) continue;
+      fqns.push(`${cat}.${sc}.${obj.fqn.name}`);
+    }
+    const historyAbs = path.resolve(String(opts.historyFile));
+    const historyRaw = await fs.readFile(historyAbs, "utf8");
+    const entries = JSON.parse(historyRaw);
+    if (!Array.isArray(entries)) {
+      throw new Error(
+        `--history-file ${historyAbs} did not parse to an array of QueryHistoryEntry.`
+      );
+    }
+    const thresholdDays = Number(opts.thresholdDays ?? "30");
+    const report = findUnusedObjects(entries, fqns, {
+      thresholdDays,
+      referenceDate: opts.referenceDate ? String(opts.referenceDate) : void 0
+    });
+    const output = String(opts.format).toLowerCase() === "json" ? JSON.stringify(report, null, 2) : renderUnusedObjectsMarkdown(report);
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, output, "utf8");
+      console.error(
+        `Wrote ${out} \u2014 ${report.unusedCount}/${report.totalObjects} object(s) unreferenced \u2265 ${thresholdDays}d.`
+      );
+    } else {
+      process.stdout.write(output + "\n");
+    }
+  });
+  cmd.addCommand(unused);
+  const mvCandidates = new Command("mv-candidates");
+  mvCandidates.description(
+    "Identify recurring SELECT shapes that may benefit from caching as a materialized view (PERF.4). Offline \u2014 feeds a JSON array of QueryHistoryEntry via --history-file. Suggests CREATE MATERIALIZED VIEW DDL."
+  ).requiredOption(
+    "--history-file <path>",
+    "Path to a JSON file containing a QueryHistoryEntry[] (e.g. saved from `ddt history --last 1000 --format json`)."
+  ).option("--threshold-runs <n>", "Min run count to qualify as a candidate (default 5).", "5").option(
+    "--threshold-total-ms <n>",
+    "Min sum of durationMs across runs to qualify (default 60000).",
+    "60000"
+  ).option("--top-n <n>", "Cap on candidates returned (default 25).", "25").option("--mv-schema <name>", "Schema to prefix on the suggested MV name (e.g. `analytics`).").option("--format <fmt>", "Output format: text | json. Default text.", "text").option("-o, --out <path>", "Write report to a file instead of stdout.").action(async (opts) => {
+    const historyAbs = path.resolve(String(opts.historyFile));
+    const historyRaw = await fs.readFile(historyAbs, "utf8");
+    const entries = JSON.parse(historyRaw);
+    if (!Array.isArray(entries)) {
+      throw new Error(
+        `--history-file ${historyAbs} did not parse to an array of QueryHistoryEntry.`
+      );
+    }
+    const report = findMaterializedViewCandidates(entries, {
+      thresholdRuns: Number(opts.thresholdRuns ?? "5"),
+      thresholdTotalMs: Number(opts.thresholdTotalMs ?? "60000"),
+      topN: Number(opts.topN ?? "25"),
+      mvSchema: opts.mvSchema ? String(opts.mvSchema) : void 0
+    });
+    const output = String(opts.format).toLowerCase() === "json" ? JSON.stringify(report, null, 2) : renderMvCandidatesMarkdown(report);
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, output, "utf8");
+      console.error(
+        `Wrote ${out} \u2014 ${report.candidates.length} MV candidate(s) (scanned ${report.entryCount} entries).`
+      );
+    } else {
+      process.stdout.write(output + "\n");
+    }
+  });
+  cmd.addCommand(mvCandidates);
+  const warehouseSize = new Command("warehouse-size");
+  warehouseSize.description(
+    "Per-SQL-warehouse sizing recommendation from a query-history snapshot (PERF.5). Offline \u2014 feeds a JSON QueryHistoryEntry[] via --history-file. Suggests size-up / size-down / multi-cluster / keep."
+  ).requiredOption(
+    "--history-file <path>",
+    "Path to a JSON file containing a QueryHistoryEntry[]."
+  ).option(
+    "--slow-query-ms <n>",
+    'Threshold above which a query counts as "slow" (default 30000).',
+    "30000"
+  ).option(
+    "--size-up-fraction <p>",
+    "Fraction of slow queries that triggers size-up (default 0.2).",
+    "0.2"
+  ).option(
+    "--size-down-mean-ms <n>",
+    "Mean-duration cap below which size-down may trigger (default 1000).",
+    "1000"
+  ).option(
+    "--low-use-runs <n>",
+    "Run-count cap below which size-down may trigger (default 20).",
+    "20"
+  ).option(
+    "--multi-cluster-runs <n>",
+    "Run-count floor above which size-up upgrades to multi-cluster (default 500).",
+    "500"
+  ).option("--format <fmt>", "Output format: text | json. Default text.", "text").option("-o, --out <path>", "Write report to a file instead of stdout.").action(async (opts) => {
+    const historyAbs = path.resolve(String(opts.historyFile));
+    const historyRaw = await fs.readFile(historyAbs, "utf8");
+    const entries = JSON.parse(historyRaw);
+    if (!Array.isArray(entries)) {
+      throw new Error(
+        `--history-file ${historyAbs} did not parse to an array of QueryHistoryEntry.`
+      );
+    }
+    const report = recommendWarehouseSize(entries, {
+      slowQueryThresholdMs: Number(opts.slowQueryMs ?? "30000"),
+      sizeUpSlowFraction: Number(opts.sizeUpFraction ?? "0.2"),
+      sizeDownMeanMaxMs: Number(opts.sizeDownMeanMs ?? "1000"),
+      lowUseRunThreshold: Number(opts.lowUseRuns ?? "20"),
+      multiClusterRunThreshold: Number(opts.multiClusterRuns ?? "500")
+    });
+    const output = String(opts.format).toLowerCase() === "json" ? JSON.stringify(report, null, 2) : renderWarehouseSizingMarkdown(report);
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, output, "utf8");
+      console.error(
+        `Wrote ${out} \u2014 ${report.recommendations.length} warehouse(s) analysed (scanned ${report.entryCount} entries).`
+      );
+    } else {
+      process.stdout.write(output + "\n");
+    }
+  });
+  cmd.addCommand(warehouseSize);
+  return cmd;
+}
+export {
+  perfCommand
+};
+//# sourceMappingURL=perf-UULZSREY.js.map

package/dist/perf-UULZSREY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/perf.ts"],"sourcesContent":["/**\n * `ddt perf` — CLI performance diagnostics + recommendations.\n *\n * Subcommands:\n *   - `cold-start` (RES.5): CLI startup latency vs the 200ms budget.\n *   - `unused` (PERF.6): given a project model + query-history snapshot,\n *      identify objects unreferenced for ≥ N days.\n *\n * Mirrors `Snowflake/packages/cli/src/commands/perf.ts`.\n */\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\n// Subpath import, NOT the `@ddt-tools/core` barrel — keeps `ddt perf cold-start`\n// itself off the all-modules import path it exists to measure (RH3.3).\nimport { loadProject, parseProjectModel } from '@ddt-tools/core/project';\nimport {\n  findMaterializedViewCandidates,\n  findUnusedObjects,\n  recommendWarehouseSize,\n  renderMvCandidatesMarkdown,\n  renderUnusedObjectsMarkdown,\n  renderWarehouseSizingMarkdown,\n} from '@ddt-tools/core/perf';\nimport type { QueryHistoryEntry } from '@ddt-tools/core/queryHistory';\n\nconst COLD_START_BUDGET_MS = 200;\n\nexport function perfCommand(): Command {\n  const cmd = new Command('perf');\n  cmd.description('CLI performance diagnostics (cold-start audit, hot-path profiling).');\n\n  const coldStart = new Command('cold-start');\n  coldStart\n    .description('Measure CLI cold-start latency and compare against the 200ms budget.')\n    .option('--json', 'Emit JSON instead of human-readable output.', false)\n    .option(\n      '--budget <ms>',\n      'Override the pass/fail threshold in ms.',\n      String(COLD_START_BUDGET_MS),\n    )\n    .action((opts) => {\n      const startNs: bigint | undefined = (globalThis as { __DDT_START_NS__?: bigint })\n        .__DDT_START_NS__;\n      const nowNs = process.hrtime.bigint();\n      const budgetMs = Number(opts.budget ?? COLD_START_BUDGET_MS);\n\n      let elapsedMs: number | null = null;\n      if (startNs !== undefined) {\n        elapsedMs = Number(nowNs - startNs) / 1e6;\n      }\n\n      const pass = elapsedMs !== null && elapsedMs <= budgetMs;\n      const note =\n        elapsedMs === null\n          ? 'Start timestamp not recorded — add `globalThis.__DDT_START_NS__ = process.hrtime.bigint()` to the CLI entry point.'\n          : pass\n            ? `✓ ${elapsedMs.toFixed(1)} ms ≤ ${budgetMs} ms budget`\n            : `✗ ${elapsedMs.toFixed(1)} ms > ${budgetMs} ms budget — see docs/CONTRIBUTING.md for lazy-load patterns`;\n\n      if (opts.json) {\n        process.stdout.write(JSON.stringify({ elapsedMs, budgetMs, pass, note }, null, 2) + '\\n');\n      } else {\n        console.log(`ddt cold-start: ${note}`);\n        if (elapsedMs !== null) {\n          const bar = '█'.repeat(Math.min(40, Math.round((elapsedMs / budgetMs) * 40)));\n          const pct = ((elapsedMs / budgetMs) * 100).toFixed(0);\n          console.log(`  ${bar} ${pct}% of ${budgetMs}ms budget`);\n        }\n      }\n      process.exitCode = pass ? 0 : 1;\n    });\n\n  cmd.addCommand(coldStart);\n\n  const unused = new Command('unused');\n  unused\n    .description(\n      'Find project objects unreferenced for ≥ --threshold-days in a query-history snapshot (PERF.6). ' +\n        'Offline — feeds a JSON array of QueryHistoryEntry via --history-file.',\n    )\n    .requiredOption('-p, --project <path>', 'Path to the .ddtproj file.')\n    .requiredOption(\n      '--history-file <path>',\n      'Path to a JSON file containing a QueryHistoryEntry[] (e.g. saved from `ddt history --last 1000 --format json`).',\n    )\n    .option('--threshold-days <n>', 'Days-of-inactivity cutoff (default 30).', '30')\n    .option(\n      '--reference-date <iso>',\n      'ISO-8601 timestamp used as \"now\" (default: most recent entry).',\n    )\n    .option('--format <fmt>', 'Output format: text | json. Default text.', 'text')\n    .option('-o, --out <path>', 'Write report to a file instead of stdout.')\n    .action(async (opts) => {\n      const loaded = await loadProject(String(opts.project));\n      const model = await parseProjectModel(loaded);\n      const testable = new Set<string>([\n        'TABLE',\n        'MANAGED_TABLE',\n        'EXTERNAL_TABLE',\n        'VIEW',\n        'MATERIALIZED_VIEW',\n        'STREAMING_TABLE',\n      ]);\n      const fqns: string[] = [];\n      for (const obj of model) {\n        if (!testable.has(obj.objectType)) continue;\n        const cat = obj.fqn.database;\n        const sc = obj.fqn.schema;\n        if (!cat || !sc) continue;\n        fqns.push(`${cat}.${sc}.${obj.fqn.name}`);\n      }\n      const historyAbs = path.resolve(String(opts.historyFile));\n      const historyRaw = await fs.readFile(historyAbs, 'utf8');\n      const entries = JSON.parse(historyRaw) as QueryHistoryEntry[];\n      if (!Array.isArray(entries)) {\n        throw new Error(\n          `--history-file ${historyAbs} did not parse to an array of QueryHistoryEntry.`,\n        );\n      }\n      const thresholdDays = Number(opts.thresholdDays ?? '30');\n      const report = findUnusedObjects(entries, fqns, {\n        thresholdDays,\n        referenceDate: opts.referenceDate ? String(opts.referenceDate) : undefined,\n      });\n      const output =\n        String(opts.format).toLowerCase() === 'json'\n          ? JSON.stringify(report, null, 2)\n          : renderUnusedObjectsMarkdown(report);\n      if (opts.out) {\n        const out = path.resolve(String(opts.out));\n        await fs.mkdir(path.dirname(out), { recursive: true });\n        await fs.writeFile(out, output, 'utf8');\n        console.error(\n          `Wrote ${out} — ${report.unusedCount}/${report.totalObjects} object(s) unreferenced ≥ ${thresholdDays}d.`,\n        );\n      } else {\n        process.stdout.write(output + '\\n');\n      }\n    });\n  cmd.addCommand(unused);\n\n  const mvCandidates = new Command('mv-candidates');\n  mvCandidates\n    .description(\n      'Identify recurring SELECT shapes that may benefit from caching as a materialized view (PERF.4). ' +\n        'Offline — feeds a JSON array of QueryHistoryEntry via --history-file. Suggests CREATE MATERIALIZED VIEW DDL.',\n    )\n    .requiredOption(\n      '--history-file <path>',\n      'Path to a JSON file containing a QueryHistoryEntry[] (e.g. saved from `ddt history --last 1000 --format json`).',\n    )\n    .option('--threshold-runs <n>', 'Min run count to qualify as a candidate (default 5).', '5')\n    .option(\n      '--threshold-total-ms <n>',\n      'Min sum of durationMs across runs to qualify (default 60000).',\n      '60000',\n    )\n    .option('--top-n <n>', 'Cap on candidates returned (default 25).', '25')\n    .option('--mv-schema <name>', 'Schema to prefix on the suggested MV name (e.g. `analytics`).')\n    .option('--format <fmt>', 'Output format: text | json. Default text.', 'text')\n    .option('-o, --out <path>', 'Write report to a file instead of stdout.')\n    .action(async (opts) => {\n      const historyAbs = path.resolve(String(opts.historyFile));\n      const historyRaw = await fs.readFile(historyAbs, 'utf8');\n      const entries = JSON.parse(historyRaw) as QueryHistoryEntry[];\n      if (!Array.isArray(entries)) {\n        throw new Error(\n          `--history-file ${historyAbs} did not parse to an array of QueryHistoryEntry.`,\n        );\n      }\n      const report = findMaterializedViewCandidates(entries, {\n        thresholdRuns: Number(opts.thresholdRuns ?? '5'),\n        thresholdTotalMs: Number(opts.thresholdTotalMs ?? '60000'),\n        topN: Number(opts.topN ?? '25'),\n        mvSchema: opts.mvSchema ? String(opts.mvSchema) : undefined,\n      });\n      const output =\n        String(opts.format).toLowerCase() === 'json'\n          ? JSON.stringify(report, null, 2)\n          : renderMvCandidatesMarkdown(report);\n      if (opts.out) {\n        const out = path.resolve(String(opts.out));\n        await fs.mkdir(path.dirname(out), { recursive: true });\n        await fs.writeFile(out, output, 'utf8');\n        console.error(\n          `Wrote ${out} — ${report.candidates.length} MV candidate(s) (scanned ${report.entryCount} entries).`,\n        );\n      } else {\n        process.stdout.write(output + '\\n');\n      }\n    });\n  cmd.addCommand(mvCandidates);\n\n  const warehouseSize = new Command('warehouse-size');\n  warehouseSize\n    .description(\n      'Per-SQL-warehouse sizing recommendation from a query-history snapshot (PERF.5). ' +\n        'Offline — feeds a JSON QueryHistoryEntry[] via --history-file. Suggests size-up / size-down / multi-cluster / keep.',\n    )\n    .requiredOption(\n      '--history-file <path>',\n      'Path to a JSON file containing a QueryHistoryEntry[].',\n    )\n    .option(\n      '--slow-query-ms <n>',\n      'Threshold above which a query counts as \"slow\" (default 30000).',\n      '30000',\n    )\n    .option(\n      '--size-up-fraction <p>',\n      'Fraction of slow queries that triggers size-up (default 0.2).',\n      '0.2',\n    )\n    .option(\n      '--size-down-mean-ms <n>',\n      'Mean-duration cap below which size-down may trigger (default 1000).',\n      '1000',\n    )\n    .option(\n      '--low-use-runs <n>',\n      'Run-count cap below which size-down may trigger (default 20).',\n      '20',\n    )\n    .option(\n      '--multi-cluster-runs <n>',\n      'Run-count floor above which size-up upgrades to multi-cluster (default 500).',\n      '500',\n    )\n    .option('--format <fmt>', 'Output format: text | json. Default text.', 'text')\n    .option('-o, --out <path>', 'Write report to a file instead of stdout.')\n    .action(async (opts) => {\n      const historyAbs = path.resolve(String(opts.historyFile));\n      const historyRaw = await fs.readFile(historyAbs, 'utf8');\n      const entries = JSON.parse(historyRaw) as QueryHistoryEntry[];\n      if (!Array.isArray(entries)) {\n        throw new Error(\n          `--history-file ${historyAbs} did not parse to an array of QueryHistoryEntry.`,\n        );\n      }\n      const report = recommendWarehouseSize(entries, {\n        slowQueryThresholdMs: Number(opts.slowQueryMs ?? '30000'),\n        sizeUpSlowFraction: Number(opts.sizeUpFraction ?? '0.2'),\n        sizeDownMeanMaxMs: Number(opts.sizeDownMeanMs ?? '1000'),\n        lowUseRunThreshold: Number(opts.lowUseRuns ?? '20'),\n        multiClusterRunThreshold: Number(opts.multiClusterRuns ?? '500'),\n      });\n      const output =\n        String(opts.format).toLowerCase() === 'json'\n          ? JSON.stringify(report, null, 2)\n          : renderWarehouseSizingMarkdown(report);\n      if (opts.out) {\n        const out = path.resolve(String(opts.out));\n        await fs.mkdir(path.dirname(out), { recursive: true });\n        await fs.writeFile(out, output, 'utf8');\n        console.error(\n          `Wrote ${out} — ${report.recommendations.length} warehouse(s) analysed (scanned ${report.entryCount} entries).`,\n        );\n      } else {\n        process.stdout.write(output + '\\n');\n      }\n    });\n  cmd.addCommand(warehouseSize);\n  return cmd;\n}\n"],"mappings":"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","names":[]}

package/dist/pii-QHU32VML.js

@@ -0,0 +1,146 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/pii.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import {
+  ai,
+  loadProject,
+  pac,
+  parseProjectModel,
+  pii
+} from "@ddt-tools/core";
+function piiCommand() {
+  const cmd = new Command("pii");
+  cmd.description(
+    "Detect PII columns + render Unity-Catalog column-mask DDL. See `ddt pii scan` and `ddt pii mask`."
+  );
+  cmd.command("scan").description("Scan the project for PII column candidates.").requiredOption("--source <path>", ".ddtproj or .ddtpac to scan.").option("--format <fmt>", "table | json | markdown. Default table.", "table").option(
+    "--ai",
+    "Route low/medium-confidence candidates through the configured AI provider for verification.",
+    false
+  ).option(
+    "--verify-at-or-below <tier>",
+    "When --ai is on, verify candidates at or below this tier (high | medium | low).",
+    "medium"
+  ).option("-o, --out <path>", "Output file path. Defaults to stdout.").action(
+    async (opts) => {
+      const sourcePath = String(opts.source);
+      const model = await loadModel(sourcePath);
+      let candidates = pii.detectPiiCandidates(model);
+      if (opts.ai) {
+        candidates = await pii.verifyWithAi(candidates, {
+          completeFn: async (prompt) => {
+            const r = await ai.complete([{ role: "user", content: prompt }], {
+              feature: "pii.verify"
+            });
+            return r.text;
+          },
+          verifyAtOrBelow: opts.verifyAtOrBelow ?? "medium"
+        });
+      }
+      const fmt = (opts.format ?? "table").toLowerCase();
+      let payload;
+      if (fmt === "json") {
+        payload = JSON.stringify(candidates, null, 2);
+      } else if (fmt === "markdown") {
+        payload = renderMarkdown(candidates);
+      } else {
+        payload = renderTable(candidates);
+      }
+      await emit(payload, opts.out);
+    }
+  );
+  cmd.command("mask").description("Render Unity-Catalog column-mask DDL for detected PII columns.").requiredOption("--source <path>", ".ddtproj or .ddtpac to scan.").option(
+    "--unmasked-group <name>",
+    "Group that sees the unmasked value. Default 'pii-readers'.",
+    "pii-readers"
+  ).option(
+    "--mask-function-schema <fqn>",
+    "Where mask functions live. Default `governance`.",
+    "governance"
+  ).option("--ai", "Route low/medium-confidence candidates through the AI verifier first.", false).option("-o, --out <path>", "Output file path. Default: ./anonymize.sql.").action(
+    async (opts) => {
+      const sourcePath = String(opts.source);
+      const model = await loadModel(sourcePath);
+      let candidates = pii.detectPiiCandidates(model);
+      if (opts.ai) {
+        candidates = await pii.verifyWithAi(candidates, {
+          completeFn: async (prompt) => {
+            const r = await ai.complete([{ role: "user", content: prompt }], {
+              feature: "pii.mask.verify"
+            });
+            return r.text;
+          }
+        });
+      }
+      if (candidates.length === 0) {
+        console.error("No PII columns detected.");
+        return;
+      }
+      const sql = pii.renderAnonymizeScript(candidates, {
+        unmaskedGroup: String(opts.unmaskedGroup ?? "pii-readers"),
+        maskFunctionSchema: opts.maskFunctionSchema
+      });
+      const outPath = opts.out ? path.resolve(String(opts.out)) : path.resolve("anonymize.sql");
+      await fs.mkdir(path.dirname(outPath), { recursive: true });
+      await fs.writeFile(outPath, sql, "utf8");
+      console.error(`Wrote ${outPath} (${candidates.length} candidate(s), ${sql.length} bytes).`);
+    }
+  );
+  return cmd;
+}
+function renderTable(cands) {
+  if (cands.length === 0) return "No PII candidates detected.\n";
+  const lines = [];
+  const fqnW = Math.max(8, ...cands.map((c) => c.fqn.length));
+  const colW = Math.max(8, ...cands.map((c) => c.column.length));
+  const catW = Math.max(8, ...cands.map((c) => c.category.length));
+  lines.push(
+    `${"fqn".padEnd(fqnW)}  ${"column".padEnd(colW)}  ${"category".padEnd(catW)}  confidence  reason`
+  );
+  lines.push(`${"-".repeat(fqnW)}  ${"-".repeat(colW)}  ${"-".repeat(catW)}  ----------  ------`);
+  for (const c of cands) {
+    lines.push(
+      `${c.fqn.padEnd(fqnW)}  ${c.column.padEnd(colW)}  ${c.category.padEnd(catW)}  ${c.confidence.padEnd(10)}  ${c.reason}`
+    );
+  }
+  return lines.join("\n");
+}
+function renderMarkdown(cands) {
+  if (cands.length === 0) return "_No PII candidates detected._";
+  const lines = [];
+  lines.push(`# PII candidates (${cands.length})`);
+  lines.push("");
+  lines.push("| FQN | Column | Category | Confidence | Reason |");
+  lines.push("|---|---|---|---|---|");
+  for (const c of cands) {
+    lines.push(
+      `| \`${c.fqn}\` | \`${c.column}\` | ${c.category} | ${c.confidence} | ${c.reason} |`
+    );
+  }
+  return lines.join("\n");
+}
+async function emit(payload, out) {
+  if (out) {
+    const p = path.resolve(String(out));
+    await fs.mkdir(path.dirname(p), { recursive: true });
+    await fs.writeFile(p, payload + (payload.endsWith("\n") ? "" : "\n"), "utf8");
+    console.error(`Wrote ${p}.`);
+  } else {
+    process.stdout.write(payload + (payload.endsWith("\n") ? "" : "\n"));
+  }
+}
+async function loadModel(sourcePath) {
+  if (sourcePath.endsWith(".ddtpac")) {
+    const c = await pac.readPac(sourcePath);
+    return c.model;
+  }
+  const loaded = await loadProject(sourcePath);
+  return await parseProjectModel(loaded);
+}
+export {
+  piiCommand
+};
+//# sourceMappingURL=pii-QHU32VML.js.map

package/dist/pii-QHU32VML.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/pii.ts"],"sourcesContent":["/**\n * `ddt pii` — scan a project for PII columns and optionally generate\n * Unity-Catalog column-mask DDL. Wraps `@ddt-tools/core/pii`.\n *\n * Mirrors `sdt pii`.\n */\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport {\n  ai,\n  loadProject,\n  pac,\n  parseProjectModel,\n  pii,\n  type DatabricksObject,\n} from '@ddt-tools/core';\n\nexport function piiCommand(): Command {\n  const cmd = new Command('pii');\n  cmd.description(\n    'Detect PII columns + render Unity-Catalog column-mask DDL. See `ddt pii scan` and `ddt pii mask`.',\n  );\n\n  cmd\n    .command('scan')\n    .description('Scan the project for PII column candidates.')\n    .requiredOption('--source <path>', '.ddtproj or .ddtpac to scan.')\n    .option('--format <fmt>', 'table | json | markdown. Default table.', 'table')\n    .option(\n      '--ai',\n      'Route low/medium-confidence candidates through the configured AI provider for verification.',\n      false,\n    )\n    .option(\n      '--verify-at-or-below <tier>',\n      'When --ai is on, verify candidates at or below this tier (high | medium | low).',\n      'medium',\n    )\n    .option('-o, --out <path>', 'Output file path. Defaults to stdout.')\n    .action(\n      async (opts: {\n        source: string;\n        format?: string;\n        ai?: boolean;\n        verifyAtOrBelow?: string;\n        out?: string;\n      }) => {\n        const sourcePath = String(opts.source);\n        const model = await loadModel(sourcePath);\n        let candidates = pii.detectPiiCandidates(model);\n        if (opts.ai) {\n          candidates = await pii.verifyWithAi(candidates, {\n            completeFn: async (prompt: string) => {\n              const r = await ai.complete([{ role: 'user', content: prompt }], {\n                feature: 'pii.verify',\n              });\n              return r.text;\n            },\n            verifyAtOrBelow: (opts.verifyAtOrBelow ?? 'medium') as 'high' | 'medium' | 'low',\n          });\n        }\n        const fmt = (opts.format ?? 'table').toLowerCase();\n        let payload: string;\n        if (fmt === 'json') {\n          payload = JSON.stringify(candidates, null, 2);\n        } else if (fmt === 'markdown') {\n          payload = renderMarkdown(candidates);\n        } else {\n          payload = renderTable(candidates);\n        }\n        await emit(payload, opts.out);\n      },\n    );\n\n  cmd\n    .command('mask')\n    .description('Render Unity-Catalog column-mask DDL for detected PII columns.')\n    .requiredOption('--source <path>', '.ddtproj or .ddtpac to scan.')\n    .option(\n      '--unmasked-group <name>',\n      \"Group that sees the unmasked value. Default 'pii-readers'.\",\n      'pii-readers',\n    )\n    .option(\n      '--mask-function-schema <fqn>',\n      'Where mask functions live. Default `governance`.',\n      'governance',\n    )\n    .option('--ai', 'Route low/medium-confidence candidates through the AI verifier first.', false)\n    .option('-o, --out <path>', 'Output file path. Default: ./anonymize.sql.')\n    .action(\n      async (opts: {\n        source: string;\n        unmaskedGroup?: string;\n        maskFunctionSchema?: string;\n        ai?: boolean;\n        out?: string;\n      }) => {\n        const sourcePath = String(opts.source);\n        const model = await loadModel(sourcePath);\n        let candidates = pii.detectPiiCandidates(model);\n        if (opts.ai) {\n          candidates = await pii.verifyWithAi(candidates, {\n            completeFn: async (prompt: string) => {\n              const r = await ai.complete([{ role: 'user', content: prompt }], {\n                feature: 'pii.mask.verify',\n              });\n              return r.text;\n            },\n          });\n        }\n        if (candidates.length === 0) {\n          console.error('No PII columns detected.');\n          return;\n        }\n        const sql = pii.renderAnonymizeScript(candidates, {\n          unmaskedGroup: String(opts.unmaskedGroup ?? 'pii-readers'),\n          maskFunctionSchema: opts.maskFunctionSchema,\n        });\n        const outPath = opts.out ? path.resolve(String(opts.out)) : path.resolve('anonymize.sql');\n        await fs.mkdir(path.dirname(outPath), { recursive: true });\n        await fs.writeFile(outPath, sql, 'utf8');\n        console.error(`Wrote ${outPath} (${candidates.length} candidate(s), ${sql.length} bytes).`);\n      },\n    );\n\n  return cmd;\n}\n\nfunction renderTable(cands: readonly pii.PiiCandidate[]): string {\n  if (cands.length === 0) return 'No PII candidates detected.\\n';\n  const lines: string[] = [];\n  const fqnW = Math.max(8, ...cands.map((c) => c.fqn.length));\n  const colW = Math.max(8, ...cands.map((c) => c.column.length));\n  const catW = Math.max(8, ...cands.map((c) => c.category.length));\n  lines.push(\n    `${'fqn'.padEnd(fqnW)}  ${'column'.padEnd(colW)}  ${'category'.padEnd(catW)}  confidence  reason`,\n  );\n  lines.push(`${'-'.repeat(fqnW)}  ${'-'.repeat(colW)}  ${'-'.repeat(catW)}  ----------  ------`);\n  for (const c of cands) {\n    lines.push(\n      `${c.fqn.padEnd(fqnW)}  ${c.column.padEnd(colW)}  ${c.category.padEnd(catW)}  ${c.confidence.padEnd(10)}  ${c.reason}`,\n    );\n  }\n  return lines.join('\\n');\n}\n\nfunction renderMarkdown(cands: readonly pii.PiiCandidate[]): string {\n  if (cands.length === 0) return '_No PII candidates detected._';\n  const lines: string[] = [];\n  lines.push(`# PII candidates (${cands.length})`);\n  lines.push('');\n  lines.push('| FQN | Column | Category | Confidence | Reason |');\n  lines.push('|---|---|---|---|---|');\n  for (const c of cands) {\n    lines.push(\n      `| \\`${c.fqn}\\` | \\`${c.column}\\` | ${c.category} | ${c.confidence} | ${c.reason} |`,\n    );\n  }\n  return lines.join('\\n');\n}\n\nasync function emit(payload: string, out: unknown): Promise<void> {\n  if (out) {\n    const p = path.resolve(String(out));\n    await fs.mkdir(path.dirname(p), { recursive: true });\n    await fs.writeFile(p, payload + (payload.endsWith('\\n') ? '' : '\\n'), 'utf8');\n    console.error(`Wrote ${p}.`);\n  } else {\n    process.stdout.write(payload + (payload.endsWith('\\n') ? '' : '\\n'));\n  }\n}\n\nasync function loadModel(sourcePath: string): Promise<DatabricksObject[]> {\n  if (sourcePath.endsWith('.ddtpac')) {\n    const c = await pac.readPac(sourcePath);\n    return c.model;\n  }\n  const loaded = await loadProject(sourcePath);\n  return await parseProjectModel(loaded);\n}\n"],"mappings":"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","names":[]}

package/dist/pilot-BR6GVK32.js

@@ -0,0 +1,29 @@
+import {
+  logger
+} from "./chunk-VM2H4LAO.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/pilot.ts
+import { Command } from "commander";
+import { license } from "@ddt-tools/core";
+function pilotCommand() {
+  const cmd = new Command("pilot").description(
+    "Join or check the DDT pilot program (90-day Pro access for early adopters)."
+  );
+  cmd.command("register").description("Register for the DDT pilot program.").requiredOption("--email <addr>", "Your email address.").action(async (opts) => {
+    logger.info("Registering for the DDT pilot program\u2026");
+    const meta = await license.registerPilot(opts.email);
+    logger.info(`Registered! Email: ${meta.email}`);
+    logger.info("Your pilot JWT has been stored at ~/.ddt/license.jwt.");
+    logger.info("Run `ddt pilot status` to confirm.");
+  });
+  cmd.command("status").description("Show pilot program registration status.").action(async () => {
+    const status = await license.getPilotStatus();
+    logger.info(license.describePilotStatus(status));
+  });
+  return cmd;
+}
+export {
+  pilotCommand
+};
+//# sourceMappingURL=pilot-BR6GVK32.js.map

package/dist/pilot-BR6GVK32.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/pilot.ts"],"sourcesContent":["/**\n * `ddt pilot register|status` — manage pilot program registration.\n * Mirrors `sdt pilot` in shape (PIL.2).\n */\nimport { Command } from 'commander';\nimport { license } from '@ddt-tools/core';\nimport { logger } from '../util/logger.js';\n\nexport function pilotCommand(): Command {\n  const cmd = new Command('pilot').description(\n    'Join or check the DDT pilot program (90-day Pro access for early adopters).',\n  );\n\n  cmd\n    .command('register')\n    .description('Register for the DDT pilot program.')\n    .requiredOption('--email <addr>', 'Your email address.')\n    .action(async (opts: { email: string }) => {\n      logger.info('Registering for the DDT pilot program…');\n      const meta = await license.registerPilot(opts.email);\n      logger.info(`Registered! Email: ${meta.email}`);\n      logger.info('Your pilot JWT has been stored at ~/.ddt/license.jwt.');\n      logger.info('Run `ddt pilot status` to confirm.');\n    });\n\n  cmd\n    .command('status')\n    .description('Show pilot program registration status.')\n    .action(async () => {\n      const status = await license.getPilotStatus();\n      logger.info(license.describePilotStatus(status));\n    });\n\n  return cmd;\n}\n"],"mappings":";;;;;;AAIA,SAAS,eAAe;AACxB,SAAS,eAAe;AAGjB,SAAS,eAAwB;AACtC,QAAM,MAAM,IAAI,QAAQ,OAAO,EAAE;AAAA,IAC/B;AAAA,EACF;AAEA,MACG,QAAQ,UAAU,EAClB,YAAY,qCAAqC,EACjD,eAAe,kBAAkB,qBAAqB,EACtD,OAAO,OAAO,SAA4B;AACzC,WAAO,KAAK,6CAAwC;AACpD,UAAM,OAAO,MAAM,QAAQ,cAAc,KAAK,KAAK;AACnD,WAAO,KAAK,sBAAsB,KAAK,KAAK,EAAE;AAC9C,WAAO,KAAK,uDAAuD;AACnE,WAAO,KAAK,oCAAoC;AAAA,EAClD,CAAC;AAEH,MACG,QAAQ,QAAQ,EAChB,YAAY,yCAAyC,EACrD,OAAO,YAAY;AAClB,UAAM,SAAS,MAAM,QAAQ,eAAe;AAC5C,WAAO,KAAK,QAAQ,oBAAoB,MAAM,CAAC;AAAA,EACjD,CAAC;AAEH,SAAO;AACT;","names":[]}

package/dist/pr-comment-2FOA3EXG.js

@@ -0,0 +1,81 @@
+import {
+  attachExplainFlag,
+  runExplain
+} from "./chunk-XFXG347C.js";
+import {
+  attachRelatedOptions
+} from "./chunk-DL3V7UJ2.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/pr-comment.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import {
+  CompareEngine,
+  PacSource,
+  ProjectSource,
+  loadProject,
+  pac,
+  parseProjectModel,
+  review,
+  safety
+} from "@ddt-tools/core";
+function prCommentCommand() {
+  const cmd = new Command("pr-comment");
+  cmd.description(
+    "Generate a Markdown PR comment from a source\u2194target compare (diff + safety + health)."
+  ).requiredOption("--source <path>", ".ddtproj or .ddtpac (the desired state).").requiredOption("--target <path>", ".ddtproj or .ddtpac (the current state).").option("-o, --out <path>", "Output file path. Defaults to stdout.").action(async (opts) => {
+    const sourcePath = String(opts.source);
+    const targetPath = String(opts.target);
+    const engine = new CompareEngine();
+    const src = sourcePath.endsWith(".ddtpac") ? new PacSource(sourcePath, "source") : new ProjectSource(sourcePath, "source");
+    const tgt = targetPath.endsWith(".ddtpac") ? new PacSource(targetPath, "target") : new ProjectSource(targetPath, "target");
+    const result = await engine.compare(src, tgt);
+    const assessment = safety.assess(result);
+    const model = await loadModel(sourcePath);
+    const md = review.renderPrComment(model, result, assessment, { source: sourcePath });
+    if (opts.out) {
+      const p = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(p), { recursive: true });
+      await fs.writeFile(p, md + (md.endsWith("\n") ? "" : "\n"), "utf8");
+      console.error(`Wrote ${p} (${md.length} bytes).`);
+    } else {
+      process.stdout.write(md + (md.endsWith("\n") ? "" : "\n"));
+    }
+    await runExplain(
+      {
+        feature: "pr-comment.explain",
+        systemPrompt: "You are a release manager preparing the human summary for a code-review comment. Distill the structured PR comment into 3-5 sentences a reviewer can read in 30 seconds. Lead with the riskiest change."
+      },
+      opts,
+      () => `PR comment payload follows:
+
+${md}
+
+Write a tight executive summary a busy reviewer will appreciate.`
+    );
+  });
+  attachExplainFlag(cmd);
+  attachRelatedOptions(cmd, [
+    "compare.ignoreCase",
+    "compare.ignoreComments",
+    "compare.ignoreFormattingDifferences",
+    "compare.excludeObjectTypes",
+    "compare.excludeObjectPatterns",
+    "compare.includeObjectPatterns"
+  ]);
+  return cmd;
+}
+async function loadModel(sourcePath) {
+  if (sourcePath.endsWith(".ddtpac")) {
+    const c = await pac.readPac(sourcePath);
+    return c.model;
+  }
+  const loaded = await loadProject(sourcePath);
+  return await parseProjectModel(loaded);
+}
+export {
+  prCommentCommand
+};
+//# sourceMappingURL=pr-comment-2FOA3EXG.js.map

package/dist/pr-comment-2FOA3EXG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/pr-comment.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport {\n  CompareEngine,\n  PacSource,\n  ProjectSource,\n  loadProject,\n  pac,\n  parseProjectModel,\n  review,\n  safety,\n  type CompareSource,\n  type DatabricksObject,\n} from '@ddt-tools/core';\nimport { attachExplainFlag, runExplain } from '../util/ai-explain.js';\nimport { attachRelatedOptions } from '../util/help-catalog.js';\n\n/**\n * `ddt pr-comment` — Markdown PR sticky-comment from a source↔target\n * compare. Mirrors `sdt pr-comment`.\n */\nexport function prCommentCommand(): Command {\n  const cmd = new Command('pr-comment');\n  cmd\n    .description(\n      'Generate a Markdown PR comment from a source↔target compare (diff + safety + health).',\n    )\n    .requiredOption('--source <path>', '.ddtproj or .ddtpac (the desired state).')\n    .requiredOption('--target <path>', '.ddtproj or .ddtpac (the current state).')\n    .option('-o, --out <path>', 'Output file path. Defaults to stdout.')\n    .action(async (opts: { source: string; target: string; out?: string; explain?: boolean }) => {\n      const sourcePath = String(opts.source);\n      const targetPath = String(opts.target);\n      const engine = new CompareEngine();\n      const src: CompareSource = sourcePath.endsWith('.ddtpac')\n        ? new PacSource(sourcePath, 'source')\n        : new ProjectSource(sourcePath, 'source');\n      const tgt: CompareSource = targetPath.endsWith('.ddtpac')\n        ? new PacSource(targetPath, 'target')\n        : new ProjectSource(targetPath, 'target');\n      const result = await engine.compare(src, tgt);\n      const assessment = safety.assess(result);\n      const model = await loadModel(sourcePath);\n      const md = review.renderPrComment(model, result, assessment, { source: sourcePath });\n      if (opts.out) {\n        const p = path.resolve(String(opts.out));\n        await fs.mkdir(path.dirname(p), { recursive: true });\n        await fs.writeFile(p, md + (md.endsWith('\\n') ? '' : '\\n'), 'utf8');\n        console.error(`Wrote ${p} (${md.length} bytes).`);\n      } else {\n        process.stdout.write(md + (md.endsWith('\\n') ? '' : '\\n'));\n      }\n      await runExplain(\n        {\n          feature: 'pr-comment.explain',\n          systemPrompt:\n            'You are a release manager preparing the human summary for a code-review comment. Distill the structured PR comment into 3-5 sentences a reviewer can read in 30 seconds. Lead with the riskiest change.',\n        },\n        opts,\n        () =>\n          `PR comment payload follows:\\n\\n${md}\\n\\nWrite a tight executive summary a busy reviewer will appreciate.`,\n      );\n    });\n  attachExplainFlag(cmd);\n  attachRelatedOptions(cmd, [\n    'compare.ignoreCase',\n    'compare.ignoreComments',\n    'compare.ignoreFormattingDifferences',\n    'compare.excludeObjectTypes',\n    'compare.excludeObjectPatterns',\n    'compare.includeObjectPatterns',\n  ]);\n  return cmd;\n}\n\nasync function loadModel(sourcePath: string): Promise<DatabricksObject[]> {\n  if (sourcePath.endsWith('.ddtpac')) {\n    const c = await pac.readPac(sourcePath);\n    return c.model;\n  }\n  const loaded = await loadProject(sourcePath);\n  return await parseProjectModel(loaded);\n}\n"],"mappings":";;;;;;;;;;AAAA,SAAS,YAAY,UAAU;AAC/B,OAAO,UAAU;AACjB,SAAS,eAAe;AACxB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAQA,SAAS,mBAA4B;AAC1C,QAAM,MAAM,IAAI,QAAQ,YAAY;AACpC,MACG;AAAA,IACC;AAAA,EACF,EACC,eAAe,mBAAmB,0CAA0C,EAC5E,eAAe,mBAAmB,0CAA0C,EAC5E,OAAO,oBAAoB,uCAAuC,EAClE,OAAO,OAAO,SAA8E;AAC3F,UAAM,aAAa,OAAO,KAAK,MAAM;AACrC,UAAM,aAAa,OAAO,KAAK,MAAM;AACrC,UAAM,SAAS,IAAI,cAAc;AACjC,UAAM,MAAqB,WAAW,SAAS,SAAS,IACpD,IAAI,UAAU,YAAY,QAAQ,IAClC,IAAI,cAAc,YAAY,QAAQ;AAC1C,UAAM,MAAqB,WAAW,SAAS,SAAS,IACpD,IAAI,UAAU,YAAY,QAAQ,IAClC,IAAI,cAAc,YAAY,QAAQ;AAC1C,UAAM,SAAS,MAAM,OAAO,QAAQ,KAAK,GAAG;AAC5C,UAAM,aAAa,OAAO,OAAO,MAAM;AACvC,UAAM,QAAQ,MAAM,UAAU,UAAU;AACxC,UAAM,KAAK,OAAO,gBAAgB,OAAO,QAAQ,YAAY,EAAE,QAAQ,WAAW,CAAC;AACnF,QAAI,KAAK,KAAK;AACZ,YAAM,IAAI,KAAK,QAAQ,OAAO,KAAK,GAAG,CAAC;AACvC,YAAM,GAAG,MAAM,KAAK,QAAQ,CAAC,GAAG,EAAE,WAAW,KAAK,CAAC;AACnD,YAAM,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,IAAI,IAAI,KAAK,OAAO,MAAM;AAClE,cAAQ,MAAM,SAAS,CAAC,KAAK,GAAG,MAAM,UAAU;AAAA,IAClD,OAAO;AACL,cAAQ,OAAO,MAAM,MAAM,GAAG,SAAS,IAAI,IAAI,KAAK,KAAK;AAAA,IAC3D;AACA,UAAM;AAAA,MACJ;AAAA,QACE,SAAS;AAAA,QACT,cACE;AAAA,MACJ;AAAA,MACA;AAAA,MACA,MACE;AAAA;AAAA,EAAkC,EAAE;AAAA;AAAA;AAAA,IACxC;AAAA,EACF,CAAC;AACH,oBAAkB,GAAG;AACrB,uBAAqB,KAAK;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAEA,eAAe,UAAU,YAAiD;AACxE,MAAI,WAAW,SAAS,SAAS,GAAG;AAClC,UAAM,IAAI,MAAM,IAAI,QAAQ,UAAU;AACtC,WAAO,EAAE;AAAA,EACX;AACA,QAAM,SAAS,MAAM,YAAY,UAAU;AAC3C,SAAO,MAAM,kBAAkB,MAAM;AACvC;","names":[]}

package/dist/preview-XNY422OU.js

@@ -0,0 +1,46 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/preview.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import { preview, createConnection, getProfile } from "@ddt-tools/core";
+function previewCommand() {
+  return new Command("preview").description(
+    "Preview rows from a table (SELECT * FROM <fqn> LIMIT <n>). Read-only \u2014 requires a connection profile."
+  ).argument("<fqn>", "Fully-qualified object name (catalog.schema.table).").requiredOption("--connection <profile>", "Connection profile to query.").option("--limit <n>", "Max rows to return. Default 100, max 10000.", "100").option("--where <expr>", "WHERE clause body (without the WHERE keyword).").option("--format <fmt>", "Output format: table | json. Default table.", "table").option("-o, --output <path>", "Write output to a file instead of stdout.").option("--sql-only", "Print the SELECT statement without executing it.", false).action(async (fqn, opts) => {
+    const limit = Number(opts.limit ?? "100") || 100;
+    const where = opts.where ? String(opts.where) : void 0;
+    const sql = preview.buildPreviewSql(fqn, { limit, ...where ? { where } : {} });
+    if (opts.sqlOnly === true) {
+      process.stdout.write(sql + "\n");
+      return;
+    }
+    const profile = await getProfile(String(opts.connection));
+    if (!profile) {
+      throw new Error(`Connection profile "${String(opts.connection)}" not found.`);
+    }
+    const conn = createConnection(profile);
+    await conn.connect();
+    try {
+      const result = await preview.previewRows(conn, fqn, {
+        limit,
+        ...where ? { where } : {}
+      });
+      const text = String(opts.format ?? "table").toLowerCase() === "json" ? JSON.stringify(result, null, 2) : preview.renderPreviewTable(result);
+      if (opts.output) {
+        const outPath = path.resolve(String(opts.output));
+        await fs.writeFile(outPath, text + "\n", "utf8");
+        console.error(`preview: wrote ${result.rows.length} row(s) to ${outPath}`);
+      } else {
+        process.stdout.write(text + "\n");
+      }
+    } finally {
+      await conn.disconnect();
+    }
+  });
+}
+export {
+  previewCommand
+};
+//# sourceMappingURL=preview-XNY422OU.js.map

package/dist/preview-XNY422OU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/preview.ts"],"sourcesContent":["/**\n * `ddt preview <fqn>` — DCM compatibility item 3 (mirrors `sdt preview`).\n */\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport { preview, createConnection, getProfile } from '@ddt-tools/core';\n\nexport function previewCommand(): Command {\n  return new Command('preview')\n    .description(\n      'Preview rows from a table (SELECT * FROM <fqn> LIMIT <n>). ' +\n        'Read-only — requires a connection profile.',\n    )\n    .argument('<fqn>', 'Fully-qualified object name (catalog.schema.table).')\n    .requiredOption('--connection <profile>', 'Connection profile to query.')\n    .option('--limit <n>', 'Max rows to return. Default 100, max 10000.', '100')\n    .option('--where <expr>', 'WHERE clause body (without the WHERE keyword).')\n    .option('--format <fmt>', 'Output format: table | json. Default table.', 'table')\n    .option('-o, --output <path>', 'Write output to a file instead of stdout.')\n    .option('--sql-only', 'Print the SELECT statement without executing it.', false)\n    .action(async (fqn: string, opts: Record<string, unknown>) => {\n      const limit = Number(opts.limit ?? '100') || 100;\n      const where = opts.where ? String(opts.where) : undefined;\n      const sql = preview.buildPreviewSql(fqn, { limit, ...(where ? { where } : {}) });\n\n      if (opts.sqlOnly === true) {\n        process.stdout.write(sql + '\\n');\n        return;\n      }\n\n      const profile = await getProfile(String(opts.connection));\n      if (!profile) {\n        throw new Error(`Connection profile \"${String(opts.connection)}\" not found.`);\n      }\n      const conn = createConnection(profile);\n      await conn.connect();\n      try {\n        const result = await preview.previewRows(conn as preview.PreviewRunner, fqn, {\n          limit,\n          ...(where ? { where } : {}),\n        });\n        const text =\n          String(opts.format ?? 'table').toLowerCase() === 'json'\n            ? JSON.stringify(result, null, 2)\n            : preview.renderPreviewTable(result);\n        if (opts.output) {\n          const outPath = path.resolve(String(opts.output));\n          await fs.writeFile(outPath, text + '\\n', 'utf8');\n          console.error(`preview: wrote ${result.rows.length} row(s) to ${outPath}`);\n        } else {\n          process.stdout.write(text + '\\n');\n        }\n      } finally {\n        await conn.disconnect();\n      }\n    });\n}\n"],"mappings":";;;AAGA,SAAS,YAAY,UAAU;AAC/B,OAAO,UAAU;AACjB,SAAS,eAAe;AACxB,SAAS,SAAS,kBAAkB,kBAAkB;AAE/C,SAAS,iBAA0B;AACxC,SAAO,IAAI,QAAQ,SAAS,EACzB;AAAA,IACC;AAAA,EAEF,EACC,SAAS,SAAS,qDAAqD,EACvE,eAAe,0BAA0B,8BAA8B,EACvE,OAAO,eAAe,+CAA+C,KAAK,EAC1E,OAAO,kBAAkB,gDAAgD,EACzE,OAAO,kBAAkB,+CAA+C,OAAO,EAC/E,OAAO,uBAAuB,2CAA2C,EACzE,OAAO,cAAc,oDAAoD,KAAK,EAC9E,OAAO,OAAO,KAAa,SAAkC;AAC5D,UAAM,QAAQ,OAAO,KAAK,SAAS,KAAK,KAAK;AAC7C,UAAM,QAAQ,KAAK,QAAQ,OAAO,KAAK,KAAK,IAAI;AAChD,UAAM,MAAM,QAAQ,gBAAgB,KAAK,EAAE,OAAO,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAG,CAAC;AAE/E,QAAI,KAAK,YAAY,MAAM;AACzB,cAAQ,OAAO,MAAM,MAAM,IAAI;AAC/B;AAAA,IACF;AAEA,UAAM,UAAU,MAAM,WAAW,OAAO,KAAK,UAAU,CAAC;AACxD,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,MAAM,uBAAuB,OAAO,KAAK,UAAU,CAAC,cAAc;AAAA,IAC9E;AACA,UAAM,OAAO,iBAAiB,OAAO;AACrC,UAAM,KAAK,QAAQ;AACnB,QAAI;AACF,YAAM,SAAS,MAAM,QAAQ,YAAY,MAA+B,KAAK;AAAA,QAC3E;AAAA,QACA,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,MAC3B,CAAC;AACD,YAAM,OACJ,OAAO,KAAK,UAAU,OAAO,EAAE,YAAY,MAAM,SAC7C,KAAK,UAAU,QAAQ,MAAM,CAAC,IAC9B,QAAQ,mBAAmB,MAAM;AACvC,UAAI,KAAK,QAAQ;AACf,cAAM,UAAU,KAAK,QAAQ,OAAO,KAAK,MAAM,CAAC;AAChD,cAAM,GAAG,UAAU,SAAS,OAAO,MAAM,MAAM;AAC/C,gBAAQ,MAAM,kBAAkB,OAAO,KAAK,MAAM,cAAc,OAAO,EAAE;AAAA,MAC3E,OAAO;AACL,gBAAQ,OAAO,MAAM,OAAO,IAAI;AAAA,MAClC;AAAA,IACF,UAAE;AACA,YAAM,KAAK,WAAW;AAAA,IACxB;AAAA,EACF,CAAC;AACL;","names":[]}