@ddt-tools/cli 0.2.0 → 0.2.4

package/dist/compare-P7JOV76O.js

@@ -0,0 +1,379 @@
+import {
+  attachRelatedOptions
+} from "./chunk-DL3V7UJ2.js";
+import {
+  addMappingFlags,
+  buildMappingFromOptions,
+  describeMapping
+} from "./chunk-2FT6HXKS.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/compare.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import {
+  CompareEngine,
+  PacSource,
+  ai,
+  compileSlice,
+  pac as pacNs,
+  renderHtmlReport,
+  safety,
+  typecheck,
+  writeCompareHistory
+} from "@ddt-tools/core";
+
+// src/util/color.ts
+var ANSI = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  red: "\x1B[31m",
+  yellow: "\x1B[33m",
+  cyan: "\x1B[36m",
+  green: "\x1B[32m",
+  gray: "\x1B[90m"
+};
+function resolveColorMode(flag) {
+  const mode = (flag ?? "auto").toLowerCase();
+  if (mode === "always") return true;
+  if (mode === "never") return false;
+  if (process.env.NO_COLOR) return false;
+  return Boolean(process.stdout.isTTY);
+}
+function makeColorizer(enabled) {
+  if (!enabled) {
+    const identity = (s) => s;
+    return {
+      unrecoverable: identity,
+      destructive: identity,
+      expensive: identity,
+      warning: identity,
+      safe: identity,
+      dim: identity,
+      applyToBlock: identity
+    };
+  }
+  const wrap = (codes) => (s) => `${codes}${s}${ANSI.reset}`;
+  return {
+    unrecoverable: wrap(ANSI.bold + ANSI.red),
+    destructive: wrap(ANSI.red),
+    expensive: wrap(ANSI.yellow),
+    warning: wrap(ANSI.cyan),
+    safe: wrap(ANSI.green),
+    dim: wrap(ANSI.gray),
+    applyToBlock(block) {
+      return block.split("\n").map((line) => {
+        if (/UNRECOVERABLE/.test(line) || line.includes("\u{1F6D1}"))
+          return ANSI.bold + ANSI.red + line + ANSI.reset;
+        if (/DESTRUCTIVE/.test(line)) return ANSI.red + line + ANSI.reset;
+        if (/EXPENSIVE/.test(line)) return ANSI.yellow + line + ANSI.reset;
+        if (/WARNING/.test(line) || line.includes("\u26A0")) return ANSI.cyan + line + ANSI.reset;
+        if (/\bSAFE\b|\bOK\b/.test(line) || line.includes("\u2713"))
+          return ANSI.green + line + ANSI.reset;
+        return line;
+      }).join("\n");
+    }
+  };
+}
+
+// src/commands/compare.ts
+function compareCommand() {
+  const cmd = new Command("compare");
+  cmd.description("Compare two .ddtpac files (pac\u2194pac); project / live compare pending v0.3 polish.").requiredOption("--source <path>", "Source .ddtpac (the desired state).").requiredOption("--target <path>", "Target .ddtpac (the current state).").option("--ignore-case", "Compare object FQNs case-insensitively.", false).option(
+    "--json",
+    "Emit a JSON CompareResult instead of human-readable output. (Alias for --format json.)",
+    false
+  ).option(
+    "--format <fmt>",
+    "Output format: summary | json | markdown. Default summary.",
+    "summary"
+  ).option("--report-html <path>", "Also write a self-contained HTML compare-report to <path>.").option(
+    "--no-slice",
+    "Disable the source pac's Project Slice (if it has one). Default: a sliced pac is partitioned automatically."
+  ).option(
+    "--explain",
+    "After the diff, call the configured AI provider to narrate each change in plain English with reasoning. Requires `ddt ai` to be configured.",
+    false
+  ).option(
+    "--color <mode>",
+    "Colorize severity output: always | never | auto. Default auto (color on TTY).",
+    "auto"
+  ).option(
+    "--type-safe",
+    "After the compare, run the TYPECHECK.1 impact analyzer. Exits with code 2 if the configured --break-on threshold is reached (default `error`). CI-friendly gate \u2014 pair with `--format json` for machine-readable output.",
+    false
+  ).option(
+    "--break-on <severity>",
+    "TYPECHECK.2 threshold for --type-safe: `error` (exit 2 on any error ripple, default) | `warning` (exit 2 on any error OR warning ripple, strict CI mode).",
+    "error"
+  ).option(
+    "--write-impact [path]",
+    "Write the TYPECHECK.1 impact analysis to a JSON file the VS Code extension can surface as squiggle-underlines. Default path: `.ddt/impact.json` resolved relative to CWD. Composes with `--type-safe` \u2014 the file is written before the gate decides exit code."
+  ).option(
+    "--no-history",
+    "Skip writing the compare-history audit record (AUDITCMP.1). Default: every compare run writes a record to `.ddt/history/compare/`, exportable via `ddt audit-log emit`."
+  );
+  addMappingFlags(cmd);
+  cmd.action(async (opts) => {
+    const nameMapping = await buildMappingFromOptions(opts);
+    const engine = new CompareEngine();
+    const source = new PacSource(String(opts.source), "source");
+    const target = new PacSource(String(opts.target), "target");
+    let slice;
+    if (opts.slice !== false) {
+      const srcPac = await pacNs.readPac(String(opts.source));
+      if (srcPac.manifest.slice) slice = compileSlice(srcPac.manifest.slice);
+    }
+    const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const result = await engine.compare(source, target, {
+      ignoreCase: !!opts.ignoreCase,
+      ...nameMapping ? { nameMapping } : {},
+      ...slice ? { sliceFilter: slice } : {}
+    });
+    if (opts.history !== false) {
+      const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+      try {
+        const histAssessment = safety.assess(result);
+        const changed = result.summary.added + result.summary.removed + result.summary.modified;
+        await writeCompareHistory(path.dirname(path.resolve(String(opts.source))), {
+          startedAt,
+          finishedAt,
+          durationMs: Date.parse(finishedAt) - Date.parse(startedAt),
+          outcome: histAssessment.blocked ? "BLOCKED" : changed === 0 ? "NO_CHANGES" : "CHANGES_FOUND",
+          source: { kind: result.source.kind, label: result.source.label },
+          target: { kind: result.target.kind, label: result.target.label },
+          summary: result.summary,
+          sliceApplied: Boolean(slice),
+          ...histAssessment.blocked && histAssessment.blockReason ? { blockReason: histAssessment.blockReason } : {}
+        });
+      } catch {
+      }
+    }
+    if (opts.reportHtml) {
+      const html = renderHtmlReport(result, {
+        title: `Compare ${result.source.label} \u2192 ${result.target.label}`,
+        safety: safety.assess(result)
+      });
+      const htmlPath = path.resolve(String(opts.reportHtml));
+      await fs.mkdir(path.dirname(htmlPath), { recursive: true });
+      await fs.writeFile(htmlPath, html, "utf8");
+      console.error(`Wrote ${htmlPath} (${html.length} bytes).`);
+    }
+    const fmt = opts.json ? "json" : String(opts.format ?? "summary").toLowerCase();
+    if (fmt === "json") {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (fmt === "markdown") {
+      const assessment2 = safety.assess(result);
+      console.log(renderCompareMarkdown(result, assessment2));
+      return;
+    }
+    const s = result.summary;
+    console.log(`Source: ${result.source.kind}:${result.source.label}`);
+    console.log(`Target: ${result.target.kind}:${result.target.label}`);
+    const mappingSummary = describeMapping(nameMapping);
+    if (mappingSummary) console.log(`Mapping: ${mappingSummary}`);
+    if (slice) {
+      const outside = result.outsideScope?.length ?? 0;
+      const refs = result.referenced?.length ?? 0;
+      console.log(
+        `Slice active: ${result.objects.length} owned \xB7 ${outside} outside scope (untouched) \xB7 ${refs} referenced`
+      );
+    }
+    console.log(`Summary: +${s.added} -${s.removed} ~${s.modified} =${s.unchanged}`);
+    for (const o of result.objects) {
+      if (o.kind === "unchanged") continue;
+      const glyph = o.kind === "added" ? "+" : o.kind === "removed" ? "-" : "~";
+      console.log(`  ${glyph} ${o.identity.objectType} ${o.identity.fqn}`);
+      if (o.kind === "modified" && o.changes) {
+        for (const c of o.changes) {
+          console.log(
+            `      \u2022 ${c.path}: ${JSON.stringify(c.target)} \u2192 ${JSON.stringify(c.source)}`
+          );
+        }
+      }
+    }
+    const assessment = safety.assess(result);
+    const buckets = safety.groupByReversibility(assessment);
+    const total = buckets.unrecoverable.length + buckets.dataImpacting.length + buckets.reversible.length;
+    if (total > 0) {
+      const colorize = makeColorizer(resolveColorMode(opts.color));
+      console.log("");
+      console.log("Safety findings (grouped by reversibility):");
+      const block = safety.formatReversibilityBuckets(buckets);
+      const colored = colorize.applyToBlock(block);
+      for (const line of colored.split("\n")) console.log("  " + line);
+      if (assessment.blocked && assessment.blockReason) {
+        console.error("  " + colorize.unrecoverable("BLOCKED: " + assessment.blockReason));
+      }
+    }
+    if (opts.explain) {
+      console.log("");
+      console.log("AI explanation:");
+      try {
+        const userPrompt = buildExplainPrompt(result, assessment);
+        const reply = await ai.complete(
+          [
+            { role: "system", content: SYSTEM_PROMPT },
+            { role: "user", content: userPrompt }
+          ],
+          { feature: "compare.explain" }
+        );
+        for (const line of reply.text.split("\n")) console.log("  " + line);
+      } catch (err) {
+        console.error("  --explain failed: " + (err instanceof Error ? err.message : String(err)));
+        console.error(
+          "  Run `ddt ai status` to verify your AI provider is configured (`ddt ai test` to send a probe)."
+        );
+      }
+    }
+    if (opts.writeImpact !== void 0) {
+      await writeImpactJson(
+        result,
+        opts.writeImpact === true ? void 0 : String(opts.writeImpact)
+      );
+    }
+    if (opts.typeSafe) {
+      const breakOnRaw = String(opts.breakOn ?? "error").toLowerCase();
+      if (breakOnRaw !== "error" && breakOnRaw !== "warning") {
+        throw new Error(
+          `--break-on must be 'error' or 'warning' (got '${opts.breakOn}'). 'error' fails on any error-severity ripple (default); 'warning' fails on any warning or error ripple (strict CI).`
+        );
+      }
+      const breakOn = breakOnRaw;
+      const impactFindings = typecheck.analyzeImpact(result);
+      const impactSummary = typecheck.summarizeImpact(impactFindings);
+      if (impactSummary.findingsCount > 0) {
+        console.log("");
+        console.log(
+          `Type-safety gate (--break-on ${breakOn}) \u2014 ${impactSummary.findingsCount} breaking change(s); ${impactSummary.errors} error ripple(s), ${impactSummary.warnings} warning ripple(s); ${impactSummary.affectedObjects.length} dependent object(s).`
+        );
+        for (const f of impactFindings) {
+          for (const r of f.ripples) {
+            const tag = r.severity === "error" ? "ERROR" : "WARN ";
+            console.log(
+              `  ${tag}  ${r.fqn}  \u2190  ${f.breakingChangeOn.fqn}  (${f.breakingChangeOn.kind})`
+            );
+          }
+        }
+        const failOnError = impactSummary.errors > 0;
+        const failOnWarning = breakOn === "warning" && impactSummary.warnings > 0;
+        if (failOnError) {
+          console.error(
+            `Type-safety gate FAILED \u2014 ${impactSummary.errors} error ripple(s). Fix the dependents (drop / update / re-bind) before re-running compare, OR rerun with the change scoped out of the diff.`
+          );
+          process.exitCode = 2;
+        } else if (failOnWarning) {
+          console.error(
+            `Type-safety gate FAILED (strict --break-on warning) \u2014 ${impactSummary.warnings} warning ripple(s). Tighten the dependent SQL to accept the new type, or drop --break-on warning to allow.`
+          );
+          process.exitCode = 2;
+        }
+      } else {
+        console.log("Type-safety gate PASSED \u2014 no breaking-change ripples detected.");
+      }
+    }
+  });
+  attachRelatedOptions(cmd, [
+    "compare.ignoreCase",
+    "compare.ignoreComments",
+    "compare.ignoreFormattingDifferences",
+    "compare.ignoreClusterBy",
+    "compare.ignorePartitioning",
+    "compare.ignoreStorageLocation"
+  ]);
+  return cmd;
+}
+async function writeImpactJson(result, explicitPath) {
+  const findings = typecheck.analyzeImpact(result);
+  const summary = typecheck.summarizeImpact(findings);
+  const file = {
+    version: typecheck.IMPACT_FILE_VERSION,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    source: `${result.source.kind}:${result.source.label}`,
+    target: `${result.target.kind}:${result.target.label}`,
+    findings,
+    summary
+  };
+  const outPath = explicitPath ? path.resolve(explicitPath) : path.resolve(".ddt", "impact.json");
+  await fs.mkdir(path.dirname(outPath), { recursive: true });
+  await fs.writeFile(outPath, typecheck.serializeImpactFile(file));
+  console.log(
+    `Wrote ${outPath} \u2014 ${summary.findingsCount} finding(s), ${summary.errors} error / ${summary.warnings} warning ripple(s).`
+  );
+}
+var SYSTEM_PROMPT = `You are a senior Databricks Unity Catalog DBA reviewing a schema diff. Your job is to narrate the changes in plain English to a teammate who hasn't seen the underlying SQL. For each change, briefly say:
+  - what it is (e.g. "a new fact table is added")
+  - why a reasonable engineer might do this (the intent)
+  - what to watch out for (the risk, if any)
+
+Be concrete; use the FQNs you're given. Keep it to 3-6 sentences per object. Don't repeat the raw diff back \u2014 explain it.`;
+function buildExplainPrompt(result, assessment) {
+  const lines = [];
+  lines.push(`Source: ${result.source.label}`);
+  lines.push(`Target: ${result.target.label}`);
+  lines.push(
+    `Summary: +${result.summary.added} added, -${result.summary.removed} removed, ~${result.summary.modified} modified.`
+  );
+  lines.push(
+    `Safety: ${assessment.unrecoverable.length} unrecoverable, ${assessment.destructive.length} destructive, ${assessment.expensive.length} expensive, ${assessment.warnings.length} warnings.`
+  );
+  lines.push("");
+  lines.push("Changes (up to 40):");
+  const changed = result.objects.filter((o) => o.kind !== "unchanged").slice(0, 40);
+  for (const o of changed) {
+    lines.push(`- ${o.kind} ${o.identity.objectType} ${o.identity.fqn}`);
+  }
+  if (result.objects.filter((o) => o.kind !== "unchanged").length > 40) {
+    lines.push(
+      `  (\u2026 ${result.objects.filter((o) => o.kind !== "unchanged").length - 40} more truncated)`
+    );
+  }
+  lines.push("");
+  lines.push(
+    "Please narrate this diff in plain English. Group related changes together when it helps."
+  );
+  return lines.join("\n");
+}
+function renderCompareMarkdown(result, assessment) {
+  const lines = [];
+  lines.push(
+    `# Compare: ${result.source.kind}:${result.source.label} \u2192 ${result.target.kind}:${result.target.label}`
+  );
+  lines.push("");
+  lines.push(
+    `**Summary**: +${result.summary.added} added \xB7 -${result.summary.removed} removed \xB7 ~${result.summary.modified} modified \xB7 =${result.summary.unchanged} unchanged.`
+  );
+  lines.push("");
+  lines.push("**Safety**:");
+  lines.push(`- \u{1F6D1} Unrecoverable: ${assessment.unrecoverable.length}`);
+  lines.push(`- \u{1F525} Destructive:    ${assessment.destructive.length}`);
+  lines.push(`- \u23F1 Expensive:      ${assessment.expensive.length}`);
+  lines.push(`- \u26A0 Warnings:        ${assessment.warnings.length}`);
+  if (assessment.blocked) {
+    lines.push("");
+    lines.push(
+      `> **BLOCKED**: ${assessment.blockReason ?? "safety classifier refuses to proceed"}`
+    );
+  }
+  lines.push("");
+  const changed = result.objects.filter((o) => o.kind !== "unchanged");
+  if (changed.length === 0) {
+    lines.push("_No object-level changes._");
+    return lines.join("\n");
+  }
+  lines.push("| Kind | Type | FQN |");
+  lines.push("| --- | --- | --- |");
+  for (const o of changed) {
+    lines.push(`| ${o.kind} | \`${o.identity.objectType}\` | \`${o.identity.fqn}\` |`);
+  }
+  return lines.join("\n");
+}
+export {
+  SYSTEM_PROMPT,
+  buildExplainPrompt,
+  compareCommand
+};
+//# sourceMappingURL=compare-P7JOV76O.js.map

package/dist/compare-P7JOV76O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/compare.ts","../src/util/color.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport {\n  CompareEngine,\n  PacSource,\n  ai,\n  compileSlice,\n  pac as pacNs,\n  renderHtmlReport,\n  safety,\n  typecheck,\n  writeCompareHistory,\n} from '@ddt-tools/core';\nimport { addMappingFlags, buildMappingFromOptions, describeMapping } from '../util/mapping.js';\nimport { attachRelatedOptions } from '../util/help-catalog.js';\nimport { makeColorizer, resolveColorMode } from '../util/color.js';\n\n/**\n * `ddt compare` — pac↔pac compare today. Project↔pac and project↔live require\n * the SQL parser pass (v0.3 polish) + a live driver session.\n *\n * Supports logical-name mapping (`--map`, `--map-file`) so two pacs whose\n * database / schema names differ can compare semantically. See\n * `docs/LOGICAL_NAME_MAPPING.md`.\n */\nexport function compareCommand(): Command {\n  const cmd = new Command('compare');\n  cmd\n    .description('Compare two .ddtpac files (pac↔pac); project / live compare pending v0.3 polish.')\n    .requiredOption('--source <path>', 'Source .ddtpac (the desired state).')\n    .requiredOption('--target <path>', 'Target .ddtpac (the current state).')\n    .option('--ignore-case', 'Compare object FQNs case-insensitively.', false)\n    .option(\n      '--json',\n      'Emit a JSON CompareResult instead of human-readable output. (Alias for --format json.)',\n      false,\n    )\n    .option(\n      '--format <fmt>',\n      'Output format: summary | json | markdown. Default summary.',\n      'summary',\n    )\n    .option('--report-html <path>', 'Also write a self-contained HTML compare-report to <path>.')\n    .option(\n      '--no-slice',\n      \"Disable the source pac's Project Slice (if it has one). Default: a sliced pac is partitioned automatically.\",\n    )\n    .option(\n      '--explain',\n      'After the diff, call the configured AI provider to narrate each change in plain English with reasoning. Requires `ddt ai` to be configured.',\n      false,\n    )\n    .option(\n      '--color <mode>',\n      'Colorize severity output: always | never | auto. Default auto (color on TTY).',\n      'auto',\n    )\n    .option(\n      '--type-safe',\n      'After the compare, run the TYPECHECK.1 impact analyzer. Exits with code 2 if the configured --break-on threshold is reached (default `error`). CI-friendly gate — pair with `--format json` for machine-readable output.',\n      false,\n    )\n    .option(\n      '--break-on <severity>',\n      'TYPECHECK.2 threshold for --type-safe: `error` (exit 2 on any error ripple, default) | `warning` (exit 2 on any error OR warning ripple, strict CI mode).',\n      'error',\n    )\n    .option(\n      '--write-impact [path]',\n      'Write the TYPECHECK.1 impact analysis to a JSON file the VS Code extension can surface as squiggle-underlines. Default path: `.ddt/impact.json` resolved relative to CWD. Composes with `--type-safe` — the file is written before the gate decides exit code.',\n    )\n    .option(\n      '--no-history',\n      'Skip writing the compare-history audit record (AUDITCMP.1). Default: every compare run writes a record to `.ddt/history/compare/`, exportable via `ddt audit-log emit`.',\n    );\n  addMappingFlags(cmd);\n  cmd.action(async (opts) => {\n    const nameMapping = await buildMappingFromOptions(opts);\n    const engine = new CompareEngine();\n    const source = new PacSource(String(opts.source), 'source');\n    const target = new PacSource(String(opts.target), 'target');\n\n    // Auto-pull slice from the source pac's manifest unless --no-slice was set.\n    let slice: ReturnType<typeof compileSlice> | undefined;\n    if (opts.slice !== false) {\n      const srcPac = await pacNs.readPac(String(opts.source));\n      if (srcPac.manifest.slice) slice = compileSlice(srcPac.manifest.slice);\n    }\n\n    const startedAt = new Date().toISOString();\n    const result = await engine.compare(source, target, {\n      ignoreCase: !!opts.ignoreCase,\n      ...(nameMapping ? { nameMapping } : {}),\n      ...(slice ? { sliceFilter: slice } : {}),\n    });\n\n    // AUDITCMP.1 — compare operations leave the same audit trail deploys\n    // do. Written before the format-specific early returns so every\n    // output mode is covered. Best-effort: a failed write never breaks\n    // the compare itself.\n    if (opts.history !== false) {\n      const finishedAt = new Date().toISOString();\n      try {\n        const histAssessment = safety.assess(result);\n        const changed = result.summary.added + result.summary.removed + result.summary.modified;\n        await writeCompareHistory(path.dirname(path.resolve(String(opts.source))), {\n          startedAt,\n          finishedAt,\n          durationMs: Date.parse(finishedAt) - Date.parse(startedAt),\n          outcome: histAssessment.blocked\n            ? 'BLOCKED'\n            : changed === 0\n              ? 'NO_CHANGES'\n              : 'CHANGES_FOUND',\n          source: { kind: result.source.kind, label: result.source.label },\n          target: { kind: result.target.kind, label: result.target.label },\n          summary: result.summary,\n          sliceApplied: Boolean(slice),\n          ...(histAssessment.blocked && histAssessment.blockReason\n            ? { blockReason: histAssessment.blockReason }\n            : {}),\n        });\n      } catch {\n        /* audit trail is best-effort; never fail the compare over it */\n      }\n    }\n\n    if (opts.reportHtml) {\n      const html = renderHtmlReport(result, {\n        title: `Compare ${result.source.label} → ${result.target.label}`,\n        safety: safety.assess(result),\n      });\n      const htmlPath = path.resolve(String(opts.reportHtml));\n      await fs.mkdir(path.dirname(htmlPath), { recursive: true });\n      await fs.writeFile(htmlPath, html, 'utf8');\n      console.error(`Wrote ${htmlPath} (${html.length} bytes).`);\n    }\n\n    const fmt = opts.json ? 'json' : String(opts.format ?? 'summary').toLowerCase();\n    if (fmt === 'json') {\n      console.log(JSON.stringify(result, null, 2));\n      return;\n    }\n    if (fmt === 'markdown') {\n      const assessment = safety.assess(result);\n      console.log(renderCompareMarkdown(result, assessment));\n      return;\n    }\n    const s = result.summary;\n    console.log(`Source: ${result.source.kind}:${result.source.label}`);\n    console.log(`Target: ${result.target.kind}:${result.target.label}`);\n    const mappingSummary = describeMapping(nameMapping);\n    if (mappingSummary) console.log(`Mapping: ${mappingSummary}`);\n    if (slice) {\n      const outside = result.outsideScope?.length ?? 0;\n      const refs = result.referenced?.length ?? 0;\n      console.log(\n        `Slice active: ${result.objects.length} owned · ${outside} outside scope (untouched) · ${refs} referenced`,\n      );\n    }\n    console.log(`Summary: +${s.added} -${s.removed} ~${s.modified} =${s.unchanged}`);\n    for (const o of result.objects) {\n      if (o.kind === 'unchanged') continue;\n      const glyph = o.kind === 'added' ? '+' : o.kind === 'removed' ? '-' : '~';\n      console.log(`  ${glyph} ${o.identity.objectType} ${o.identity.fqn}`);\n      if (o.kind === 'modified' && o.changes) {\n        for (const c of o.changes) {\n          console.log(\n            `      • ${c.path}: ${JSON.stringify(c.target)} → ${JSON.stringify(c.source)}`,\n          );\n        }\n      }\n    }\n\n    // Reversibility-grouped safety findings — Unrecoverable first (highest\n    // urgency), then Data-impacting, then Reversible. Empty buckets are\n    // skipped, and an empty assessment is silent.\n    const assessment = safety.assess(result);\n    const buckets = safety.groupByReversibility(assessment);\n    const total =\n      buckets.unrecoverable.length + buckets.dataImpacting.length + buckets.reversible.length;\n    if (total > 0) {\n      const colorize = makeColorizer(resolveColorMode(opts.color));\n      console.log('');\n      console.log('Safety findings (grouped by reversibility):');\n      const block = safety.formatReversibilityBuckets(buckets);\n      const colored = colorize.applyToBlock(block);\n      for (const line of colored.split('\\n')) console.log('  ' + line);\n      if (assessment.blocked && assessment.blockReason) {\n        console.error('  ' + colorize.unrecoverable('BLOCKED: ' + assessment.blockReason));\n      }\n    }\n\n    // AI-narrated diff (--explain). Calls the configured provider with a\n    // structured prompt containing the diff summary + per-object changes\n    // + safety findings.\n    if (opts.explain) {\n      console.log('');\n      console.log('AI explanation:');\n      try {\n        const userPrompt = buildExplainPrompt(result, assessment);\n        const reply = await ai.complete(\n          [\n            { role: 'system', content: SYSTEM_PROMPT },\n            { role: 'user', content: userPrompt },\n          ],\n          { feature: 'compare.explain' },\n        );\n        for (const line of reply.text.split('\\n')) console.log('  ' + line);\n      } catch (err) {\n        console.error('  --explain failed: ' + (err instanceof Error ? err.message : String(err)));\n        console.error(\n          '  Run `ddt ai status` to verify your AI provider is configured (`ddt ai test` to send a probe).',\n        );\n      }\n    }\n\n    // --write-impact: TYPECHECK.4 — write the impact analysis to a\n    // JSON file the VS Code provider reads. Always runs the analyzer\n    // (even when --type-safe is off) so the editor surface is\n    // independent of the CI-gate flag. Composes with --type-safe.\n    if (opts.writeImpact !== undefined) {\n      await writeImpactJson(\n        result,\n        opts.writeImpact === true ? undefined : String(opts.writeImpact),\n      );\n    }\n\n    // --type-safe: TYPECHECK.2 CI gate. Runs the TYPECHECK.1 impact\n    // analyzer and exits with code 2 if any error-severity ripple\n    // (column-drop or table-drop reaching a dependent object) is\n    // detected. Stays silent on a clean diff so this composes well\n    // with --format json (which already returned above).\n    if (opts.typeSafe) {\n      const breakOnRaw = String(opts.breakOn ?? 'error').toLowerCase();\n      if (breakOnRaw !== 'error' && breakOnRaw !== 'warning') {\n        throw new Error(\n          `--break-on must be 'error' or 'warning' (got '${opts.breakOn}'). 'error' fails on any error-severity ripple (default); 'warning' fails on any warning or error ripple (strict CI).`,\n        );\n      }\n      const breakOn = breakOnRaw as 'error' | 'warning';\n      const impactFindings = typecheck.analyzeImpact(result);\n      const impactSummary = typecheck.summarizeImpact(impactFindings);\n      if (impactSummary.findingsCount > 0) {\n        console.log('');\n        console.log(\n          `Type-safety gate (--break-on ${breakOn}) — ${impactSummary.findingsCount} breaking change(s); ${impactSummary.errors} error ripple(s), ${impactSummary.warnings} warning ripple(s); ${impactSummary.affectedObjects.length} dependent object(s).`,\n        );\n        for (const f of impactFindings) {\n          for (const r of f.ripples) {\n            const tag = r.severity === 'error' ? 'ERROR' : 'WARN ';\n            console.log(\n              `  ${tag}  ${r.fqn}  ←  ${f.breakingChangeOn.fqn}  (${f.breakingChangeOn.kind})`,\n            );\n          }\n        }\n        const failOnError = impactSummary.errors > 0;\n        const failOnWarning = breakOn === 'warning' && impactSummary.warnings > 0;\n        if (failOnError) {\n          console.error(\n            `Type-safety gate FAILED — ${impactSummary.errors} error ripple(s). Fix the dependents (drop / update / re-bind) before re-running compare, OR rerun with the change scoped out of the diff.`,\n          );\n          process.exitCode = 2;\n        } else if (failOnWarning) {\n          console.error(\n            `Type-safety gate FAILED (strict --break-on warning) — ${impactSummary.warnings} warning ripple(s). Tighten the dependent SQL to accept the new type, or drop --break-on warning to allow.`,\n          );\n          process.exitCode = 2;\n        }\n      } else {\n        console.log('Type-safety gate PASSED — no breaking-change ripples detected.');\n      }\n    }\n  });\n  attachRelatedOptions(cmd, [\n    'compare.ignoreCase',\n    'compare.ignoreComments',\n    'compare.ignoreFormattingDifferences',\n    'compare.ignoreClusterBy',\n    'compare.ignorePartitioning',\n    'compare.ignoreStorageLocation',\n  ]);\n  return cmd;\n}\n\n/**\n * TYPECHECK.4 — write the impact analysis JSON to disk so the VS Code\n * provider can surface it as squiggle-underlines. Defaults to\n * `<cwd>/.ddt/impact.json` (DDT compare today is pac↔pac so we don't\n * resolve a project root from the source arg — that wires in when the\n * project-source variant of compare ships).\n */\nasync function writeImpactJson(\n  result: Parameters<typeof typecheck.analyzeImpact>[0],\n  explicitPath: string | undefined,\n): Promise<void> {\n  const findings = typecheck.analyzeImpact(result);\n  const summary = typecheck.summarizeImpact(findings);\n  const file: typecheck.ImpactFile = {\n    version: typecheck.IMPACT_FILE_VERSION,\n    generatedAt: new Date().toISOString(),\n    source: `${result.source.kind}:${result.source.label}`,\n    target: `${result.target.kind}:${result.target.label}`,\n    findings,\n    summary,\n  };\n  const outPath = explicitPath ? path.resolve(explicitPath) : path.resolve('.ddt', 'impact.json');\n  await fs.mkdir(path.dirname(outPath), { recursive: true });\n  await fs.writeFile(outPath, typecheck.serializeImpactFile(file));\n  console.log(\n    `Wrote ${outPath} — ${summary.findingsCount} finding(s), ${summary.errors} error / ${summary.warnings} warning ripple(s).`,\n  );\n}\n\nexport const SYSTEM_PROMPT = `You are a senior Databricks Unity Catalog DBA reviewing a schema diff. Your job is to narrate the changes in plain English to a teammate who hasn't seen the underlying SQL. For each change, briefly say:\n  - what it is (e.g. \"a new fact table is added\")\n  - why a reasonable engineer might do this (the intent)\n  - what to watch out for (the risk, if any)\n\nBe concrete; use the FQNs you're given. Keep it to 3-6 sentences per object. Don't repeat the raw diff back — explain it.`;\n\nexport function buildExplainPrompt(\n  result: {\n    source: { label: string };\n    target: { label: string };\n    objects: Array<{\n      kind: string;\n      identity: { fqn: string; objectType: string };\n      changes?: unknown[];\n    }>;\n    summary: { added: number; removed: number; modified: number; unchanged: number };\n  },\n  assessment: {\n    unrecoverable: unknown[];\n    destructive: unknown[];\n    expensive: unknown[];\n    warnings: unknown[];\n  },\n): string {\n  const lines: string[] = [];\n  lines.push(`Source: ${result.source.label}`);\n  lines.push(`Target: ${result.target.label}`);\n  lines.push(\n    `Summary: +${result.summary.added} added, -${result.summary.removed} removed, ~${result.summary.modified} modified.`,\n  );\n  lines.push(\n    `Safety: ${assessment.unrecoverable.length} unrecoverable, ${assessment.destructive.length} destructive, ${assessment.expensive.length} expensive, ${assessment.warnings.length} warnings.`,\n  );\n  lines.push('');\n  lines.push('Changes (up to 40):');\n  const changed = result.objects.filter((o) => o.kind !== 'unchanged').slice(0, 40);\n  for (const o of changed) {\n    lines.push(`- ${o.kind} ${o.identity.objectType} ${o.identity.fqn}`);\n  }\n  if (result.objects.filter((o) => o.kind !== 'unchanged').length > 40) {\n    lines.push(\n      `  (… ${result.objects.filter((o) => o.kind !== 'unchanged').length - 40} more truncated)`,\n    );\n  }\n  lines.push('');\n  lines.push(\n    'Please narrate this diff in plain English. Group related changes together when it helps.',\n  );\n  return lines.join('\\n');\n}\n\nfunction renderCompareMarkdown(\n  result: {\n    source: { kind: string; label: string };\n    target: { kind: string; label: string };\n    objects: Array<{ kind: string; identity: { fqn: string; objectType: string } }>;\n    summary: { added: number; removed: number; modified: number; unchanged: number };\n  },\n  assessment: {\n    unrecoverable: unknown[];\n    destructive: unknown[];\n    expensive: unknown[];\n    warnings: unknown[];\n    blocked?: boolean;\n    blockReason?: string;\n  },\n): string {\n  const lines: string[] = [];\n  lines.push(\n    `# Compare: ${result.source.kind}:${result.source.label} → ${result.target.kind}:${result.target.label}`,\n  );\n  lines.push('');\n  lines.push(\n    `**Summary**: +${result.summary.added} added · -${result.summary.removed} removed · ~${result.summary.modified} modified · =${result.summary.unchanged} unchanged.`,\n  );\n  lines.push('');\n  lines.push('**Safety**:');\n  lines.push(`- 🛑 Unrecoverable: ${assessment.unrecoverable.length}`);\n  lines.push(`- 🔥 Destructive:    ${assessment.destructive.length}`);\n  lines.push(`- ⏱ Expensive:      ${assessment.expensive.length}`);\n  lines.push(`- ⚠ Warnings:        ${assessment.warnings.length}`);\n  if (assessment.blocked) {\n    lines.push('');\n    lines.push(\n      `> **BLOCKED**: ${assessment.blockReason ?? 'safety classifier refuses to proceed'}`,\n    );\n  }\n  lines.push('');\n  const changed = result.objects.filter((o) => o.kind !== 'unchanged');\n  if (changed.length === 0) {\n    lines.push('_No object-level changes._');\n    return lines.join('\\n');\n  }\n  lines.push('| Kind | Type | FQN |');\n  lines.push('| --- | --- | --- |');\n  for (const o of changed) {\n    lines.push(`| ${o.kind} | \\`${o.identity.objectType}\\` | \\`${o.identity.fqn}\\` |`);\n  }\n  return lines.join('\\n');\n}\n","/**\n * ANSI severity coloring for CLI output, DDT side. Paired with\n * `Snowflake/packages/cli/src/util/color.ts` byte-for-byte at the\n * API level.\n */\nexport type ColorMode = 'always' | 'never' | 'auto';\n\nconst ANSI = {\n  reset: '\\x1b[0m',\n  bold: '\\x1b[1m',\n  red: '\\x1b[31m',\n  yellow: '\\x1b[33m',\n  cyan: '\\x1b[36m',\n  green: '\\x1b[32m',\n  gray: '\\x1b[90m',\n};\n\nexport function resolveColorMode(flag: string | undefined): boolean {\n  const mode = (flag ?? 'auto').toLowerCase() as ColorMode;\n  if (mode === 'always') return true;\n  if (mode === 'never') return false;\n  if (process.env.NO_COLOR) return false;\n  return Boolean(process.stdout.isTTY);\n}\n\nexport interface Colorizer {\n  unrecoverable(s: string): string;\n  destructive(s: string): string;\n  expensive(s: string): string;\n  warning(s: string): string;\n  safe(s: string): string;\n  dim(s: string): string;\n  applyToBlock(block: string): string;\n}\n\nexport function makeColorizer(enabled: boolean): Colorizer {\n  if (!enabled) {\n    const identity = (s: string): string => s;\n    return {\n      unrecoverable: identity,\n      destructive: identity,\n      expensive: identity,\n      warning: identity,\n      safe: identity,\n      dim: identity,\n      applyToBlock: identity,\n    };\n  }\n  const wrap =\n    (codes: string) =>\n    (s: string): string =>\n      `${codes}${s}${ANSI.reset}`;\n  return {\n    unrecoverable: wrap(ANSI.bold + ANSI.red),\n    destructive: wrap(ANSI.red),\n    expensive: wrap(ANSI.yellow),\n    warning: wrap(ANSI.cyan),\n    safe: wrap(ANSI.green),\n    dim: wrap(ANSI.gray),\n    applyToBlock(block: string): string {\n      return block\n        .split('\\n')\n        .map((line) => {\n          if (/UNRECOVERABLE/.test(line) || line.includes('🛑'))\n            return ANSI.bold + ANSI.red + line + ANSI.reset;\n          if (/DESTRUCTIVE/.test(line)) return ANSI.red + line + ANSI.reset;\n          if (/EXPENSIVE/.test(line)) return ANSI.yellow + line + ANSI.reset;\n          if (/WARNING/.test(line) || line.includes('⚠')) return ANSI.cyan + line + ANSI.reset;\n          if (/\\bSAFE\\b|\\bOK\\b/.test(line) || line.includes('✓'))\n            return ANSI.green + line + ANSI.reset;\n          return line;\n        })\n        .join('\\n');\n    },\n  };\n}\n"],"mappings":"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","names":["assessment"]}

package/dist/compare-profiles-H33CXZPD.js

@@ -0,0 +1,219 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/compare-profiles.ts
+import { promises as fs } from "fs";
+import { Command } from "commander";
+import { catalog, compareProfiles, loadProject, pac, parseProjectModel } from "@ddt-tools/core";
+function compareProfilesCommand() {
+  const cmd = new Command("compare-profiles");
+  cmd.description("Manage saved compare profiles (.ddt/compare-profiles.json).");
+  cmd.command("list").description("List every saved profile.").option("--root <path>", "Project root. Default cwd.", process.cwd()).option("--json", "Emit JSON instead of a human table.").action(async (opts) => {
+    const store = new compareProfiles.CompareProfilesStore({ root: String(opts.root) });
+    const all = await store.list();
+    if (opts.json) {
+      console.log(JSON.stringify(all, null, 2));
+      return;
+    }
+    if (all.length === 0) {
+      console.log("(no compare profiles saved yet)");
+      console.log(`  store: ${store.path}`);
+      return;
+    }
+    console.log(`${all.length} compare profile(s):`);
+    for (const p of all) {
+      console.log(`  ${p.id.padEnd(24)}  ${p.name}`);
+      console.log(`    source: ${p.source.kind}=${p.source.reference}`);
+      console.log(`    target: ${p.target.kind}=${p.target.reference}`);
+      console.log(`    mappings: ${p.mappings.length}    updated: ${p.updatedAt}`);
+    }
+  });
+  cmd.command("show").description("Show one profile by id.").argument("<id>", "Profile id (from `compare-profiles list`).").option("--root <path>", "Project root. Default cwd.", process.cwd()).option("--json", "Emit JSON instead of a human table.").action(async (id, opts) => {
+    const store = new compareProfiles.CompareProfilesStore({ root: String(opts.root) });
+    const p = await store.get(String(id));
+    if (!p) {
+      console.error(
+        `No profile with id "${id}". Run \`ddt compare-profiles list\` to enumerate.`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(p, null, 2));
+      return;
+    }
+    console.log(`Profile: ${p.name} (${p.id})`);
+    if (p.description) console.log(`  ${p.description}`);
+    console.log(
+      `  source:  ${p.source.kind}=${p.source.reference}${p.source.catalog ? ` cat=${p.source.catalog}` : ""}${p.source.schema ? ` schema=${p.source.schema}` : ""}`
+    );
+    console.log(
+      `  target:  ${p.target.kind}=${p.target.reference}${p.target.catalog ? ` cat=${p.target.catalog}` : ""}${p.target.schema ? ` schema=${p.target.schema}` : ""}`
+    );
+    console.log(`  case-sensitive: ${p.caseSensitive ? "yes" : "no"}`);
+    console.log(`  rewrite-inside-strings: ${p.rewriteInsideStrings ? "yes" : "no"}`);
+    console.log(`  updatedAt: ${p.updatedAt}`);
+    if (p.mappings.length === 0) {
+      console.log("  mappings: (none \u2014 identity)");
+    } else {
+      console.log(`  mappings (${p.mappings.length}):`);
+      for (const m of p.mappings) console.log(`    ${m.source}  =>  ${m.target}`);
+    }
+  });
+  cmd.command("save").description("Upsert a profile from a JSON file or stdin.").option("--root <path>", "Project root. Default cwd.", process.cwd()).option("--json-file <path>", 'Path to a JSON file containing one profile. Use "-" for stdin.').action(async (opts) => {
+    if (!opts.jsonFile) {
+      throw new Error('--json-file is required (use a path or "-" for stdin).');
+    }
+    const raw = String(opts.jsonFile) === "-" ? await readStdin() : await fs.readFile(String(opts.jsonFile), "utf8");
+    const parsed = JSON.parse(raw);
+    if (!parsed?.id || !parsed?.name || !parsed?.source || !parsed?.target) {
+      throw new Error(
+        "Profile JSON must contain at minimum: id, name, source, target. mappings defaults to []."
+      );
+    }
+    const store = new compareProfiles.CompareProfilesStore({ root: String(opts.root) });
+    const stamped = await store.upsert({ ...parsed, mappings: parsed.mappings ?? [] });
+    console.log(`Saved profile "${stamped.name}" (${stamped.id})`);
+    console.log(`  store: ${store.path}`);
+  });
+  cmd.command("remove").description("Delete one profile by id.").argument("<id>", "Profile id (from `compare-profiles list`).").option("--root <path>", "Project root. Default cwd.", process.cwd()).action(async (id, opts) => {
+    const store = new compareProfiles.CompareProfilesStore({ root: String(opts.root) });
+    const removed = await store.remove(String(id));
+    if (removed) {
+      console.log(`Removed profile "${id}".`);
+    } else {
+      console.warn(`No profile with id "${id}" \u2014 nothing to remove.`);
+    }
+  });
+  cmd.command("preview").description(
+    "Preview which FQNs match between the profile's source and target. Local-only \u2014 no workspace round-trip."
+  ).argument("<id>", "Profile id (from `compare-profiles list`).").option("--root <path>", "Project root. Default cwd.", process.cwd()).option(
+    "--examples <n>",
+    "Max example FQNs to show per bucket in human output. Default 5.",
+    (v) => parseInt(v, 10),
+    5
+  ).option("--json", "Emit the full PreviewSummary as JSON.").action(async (id, opts) => {
+    const store = new compareProfiles.CompareProfilesStore({ root: String(opts.root) });
+    const profile = await store.get(String(id));
+    if (!profile) {
+      console.error(
+        `No profile with id "${id}". Run \`ddt compare-profiles list\` to enumerate.`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    const root = String(opts.root);
+    const source = await resolveEndpointFqns(profile.source, root);
+    const target = await resolveEndpointFqns(profile.target, root);
+    const summary = compareProfiles.previewMatch({
+      source: source.fqns,
+      target: target.fqns,
+      mappings: profile.mappings,
+      ...profile.caseSensitive ? { caseSensitive: true } : {}
+    });
+    if (opts.json) {
+      console.log(
+        JSON.stringify(
+          {
+            profile: { id: profile.id, name: profile.name },
+            source: {
+              kind: profile.source.kind,
+              reference: profile.source.reference,
+              count: source.fqns.length
+            },
+            target: {
+              kind: profile.target.kind,
+              reference: profile.target.reference,
+              count: target.fqns.length
+            },
+            summary
+          },
+          null,
+          2
+        )
+      );
+      return;
+    }
+    console.log(`Preview: ${profile.name} (${profile.id})`);
+    console.log(
+      `  source (${profile.source.kind}=${profile.source.reference}): ${source.fqns.length} object(s)${source.note ? ` \u2014 ${source.note}` : ""}`
+    );
+    console.log(
+      `  target (${profile.target.kind}=${profile.target.reference}): ${target.fqns.length} object(s)${target.note ? ` \u2014 ${target.note}` : ""}`
+    );
+    console.log("");
+    console.log(`  matched:     ${summary.matchedCount}`);
+    console.log(`  source-only: ${summary.sourceOnlyCount}`);
+    console.log(`  target-only: ${summary.targetOnlyCount}`);
+    const exN = Math.max(0, Number(opts.examples));
+    printBucket("matched", summary.matched, exN);
+    printBucket("source-only", summary.sourceOnly, exN);
+    printBucket("target-only", summary.targetOnly, exN);
+    if (summary.matchedCount === 0 && (summary.sourceOnlyCount > 0 || summary.targetOnlyCount > 0)) {
+      console.warn("No FQNs matched \u2014 check the profile's scope and mapping rules.");
+    }
+  });
+  return cmd;
+}
+async function resolveEndpointFqns(endpoint, root) {
+  if (endpoint.kind === "connection") {
+    const cache = new catalog.CatalogCache({ root, connection: endpoint.reference });
+    const snapshot = await cache.get();
+    if (snapshot.catalogs.length === 0) {
+      return {
+        fqns: [],
+        note: `empty catalog cache at ${cache.path} \u2014 run \`ddt catalog refresh --connection ${endpoint.reference}\` first`
+      };
+    }
+    return { fqns: fqnsFromSnapshot(snapshot, endpoint.catalog, endpoint.schema) };
+  }
+  if (endpoint.kind === "pac") {
+    const contents = await pac.readPac(endpoint.reference);
+    return { fqns: fqnsFromObjects(contents.model, endpoint.catalog, endpoint.schema) };
+  }
+  const loaded = await loadProject(endpoint.reference);
+  const model = await parseProjectModel(loaded);
+  return { fqns: fqnsFromObjects(model, endpoint.catalog, endpoint.schema) };
+}
+function fqnsFromSnapshot(snapshot, catalogScope, schemaScope) {
+  const sameId = (a, b) => !!a && !!b && a.toUpperCase() === b.toUpperCase();
+  const out = [];
+  for (const cat of snapshot.catalogs) {
+    if (catalogScope && !sameId(cat.catalog, catalogScope)) continue;
+    for (const sc of cat.schemas) {
+      if (schemaScope && !sameId(sc.schema, schemaScope)) continue;
+      for (const obj of sc.objects) {
+        out.push({ database: obj.catalog, schema: obj.schema, name: obj.name });
+      }
+    }
+  }
+  return out;
+}
+function fqnsFromObjects(model, catalogScope, schemaScope) {
+  const sameId = (a, b) => !!a && !!b && a.toUpperCase() === b.toUpperCase();
+  const out = [];
+  for (const obj of model) {
+    if (catalogScope && !sameId(obj.fqn.database, catalogScope)) continue;
+    if (schemaScope && !sameId(obj.fqn.schema, schemaScope)) continue;
+    out.push(obj.fqn);
+  }
+  return out;
+}
+function printBucket(label, items, exampleN) {
+  if (items.length === 0) return;
+  console.log("");
+  console.log(
+    `  ${label} examples (showing ${Math.min(exampleN, items.length)} of ${items.length}):`
+  );
+  for (const fqn of items.slice(0, exampleN)) console.log(`    ${fqn}`);
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+export {
+  compareProfilesCommand
+};
+//# sourceMappingURL=compare-profiles-H33CXZPD.js.map