@ddt-tools/cli 0.2.0 → 0.2.4

package/dist/graph-YYL5UYCJ.js

@@ -0,0 +1,168 @@
+import {
+  attachExplainFlag,
+  runExplain
+} from "./chunk-XFXG347C.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/graph.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import {
+  buildDependencyGraph,
+  diffDependencyGraphs,
+  loadProject,
+  pac,
+  parseProjectModel,
+  renderGraphDot,
+  renderGraphMermaid
+} from "@ddt-tools/core";
+function graphCommand() {
+  const cmd = new Command("graph");
+  cmd.description("Build an object-dependency DAG and emit it as Mermaid or DOT.").requiredOption("--source <path>", ".ddtproj or .ddtpac to analyze.").option("-o, --out <path>", "Output file path. Defaults to stdout.").option(
+    "--format <fmt>",
+    "mermaid | dot | md (Mermaid wrapped in a markdown fenced block)",
+    "mermaid"
+  ).option("--json", "Emit the raw { nodes, edges } JSON instead of a renderer.", false).option(
+    "--compare-to <path>",
+    "A second .ddtproj or .ddtpac. When set, emit added / removed / changed nodes + edges (the DAG delta) instead of the static graph."
+  ).action(async (opts) => {
+    const model = await loadModel(String(opts.source));
+    const graph = buildDependencyGraph(model);
+    let diff;
+    if (opts.compareTo) {
+      const otherModel = await loadModel(String(opts.compareTo));
+      const otherGraph = buildDependencyGraph(otherModel);
+      diff = diffDependencyGraphs(otherGraph, graph);
+    }
+    const fmt = String(opts.format ?? "mermaid").toLowerCase();
+    let payload;
+    if (opts.json) {
+      payload = JSON.stringify(diff ?? graph, null, 2);
+    } else if (diff) {
+      payload = renderDiffMarkdown(diff);
+    } else if (fmt === "mermaid") {
+      payload = renderGraphMermaid(graph);
+    } else if (fmt === "dot") {
+      payload = renderGraphDot(graph);
+    } else if (fmt === "md") {
+      payload = `# Schema dependency graph
+
+${graph.nodes.length} node(s), ${graph.edges.length} edge(s).
+
+\`\`\`mermaid
+${renderGraphMermaid(graph)}
+\`\`\`
+`;
+    } else {
+      throw new Error(`Unknown --format: ${fmt}. Use mermaid | dot | md.`);
+    }
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, payload + (payload.endsWith("\n") ? "" : "\n"), "utf8");
+      console.error(
+        `Wrote ${out} (${payload.length} bytes, ${graph.nodes.length} nodes, ${graph.edges.length} edges).`
+      );
+    } else {
+      process.stdout.write(payload + (payload.endsWith("\n") ? "" : "\n"));
+    }
+    await runExplain(
+      {
+        feature: "graph.explain",
+        systemPrompt: diff ? "You are a data-platform architect narrating a dependency-graph DELTA between two snapshots. Walk through added / removed / changed nodes and edges in plain English. Call out structural shifts (new sources, dropped consumers, type changes) and likely-but-not-yet-broken downstream consequences." : "You are a data-platform architect explaining a dependency graph. Describe the dominant data-flow shape, point out hot or fragile nodes, and recommend any decomposition the graph suggests."
+      },
+      opts,
+      () => diff ? buildDiffPrompt(diff) : buildGraphPrompt(graph)
+    );
+  });
+  attachExplainFlag(cmd);
+  return cmd;
+}
+function renderDiffMarkdown(d) {
+  const lines = ["# Dependency-graph delta", ""];
+  lines.push(
+    `**Summary**: ${d.summary.nodeDelta >= 0 ? "+" : ""}${d.summary.nodeDelta} nodes, ${d.summary.edgeDelta >= 0 ? "+" : ""}${d.summary.edgeDelta} edges. ${d.addedNodes.length} added node(s), ${d.removedNodes.length} removed node(s), ${d.changedNodes.length} changed node(s).`
+  );
+  lines.push("");
+  if (d.addedNodes.length > 0) {
+    lines.push("## Added nodes");
+    for (const n of d.addedNodes) lines.push(`- \`${n.fqn}\` (${n.objectType})`);
+    lines.push("");
+  }
+  if (d.removedNodes.length > 0) {
+    lines.push("## Removed nodes");
+    for (const n of d.removedNodes) lines.push(`- \`${n.fqn}\` (${n.objectType})`);
+    lines.push("");
+  }
+  if (d.changedNodes.length > 0) {
+    lines.push("## Changed nodes (objectType)");
+    for (const c of d.changedNodes) lines.push(`- \`${c.fqn}\`: ${c.before} \u2192 ${c.after}`);
+    lines.push("");
+  }
+  if (d.addedEdges.length > 0) {
+    lines.push("## Added edges");
+    for (const e of d.addedEdges) lines.push(`- \`${e.from}\` \u2192 \`${e.to}\` (${e.kind})`);
+    lines.push("");
+  }
+  if (d.removedEdges.length > 0) {
+    lines.push("## Removed edges");
+    for (const e of d.removedEdges) lines.push(`- \`${e.from}\` \u2192 \`${e.to}\` (${e.kind})`);
+  }
+  return lines.join("\n");
+}
+function buildGraphPrompt(g) {
+  const sample = g.edges.slice(0, 40).map((e) => `  - ${e.from} -> ${e.to}`);
+  return [
+    `Dependency graph: ${g.nodes.length} nodes, ${g.edges.length} edges.`,
+    "",
+    "Edges (up to 40):",
+    ...sample,
+    "",
+    "Narrate this graph in plain English."
+  ].join("\n");
+}
+function buildDiffPrompt(d) {
+  const lines = [];
+  lines.push(
+    `Graph delta: ${d.summary.nodeDelta >= 0 ? "+" : ""}${d.summary.nodeDelta} nodes, ${d.summary.edgeDelta >= 0 ? "+" : ""}${d.summary.edgeDelta} edges.`
+  );
+  if (d.addedNodes.length > 0) {
+    lines.push("", `Added nodes (${d.addedNodes.length}, up to 20):`);
+    for (const n of d.addedNodes.slice(0, 20)) lines.push(`  + ${n.fqn} (${n.objectType})`);
+  }
+  if (d.removedNodes.length > 0) {
+    lines.push("", `Removed nodes (${d.removedNodes.length}, up to 20):`);
+    for (const n of d.removedNodes.slice(0, 20)) lines.push(`  - ${n.fqn} (${n.objectType})`);
+  }
+  if (d.changedNodes.length > 0) {
+    lines.push("", `Changed nodes (${d.changedNodes.length}):`);
+    for (const c of d.changedNodes.slice(0, 20))
+      lines.push(`  ~ ${c.fqn}: ${c.before} -> ${c.after}`);
+  }
+  if (d.addedEdges.length > 0) {
+    lines.push("", `Added edges (${d.addedEdges.length}, up to 20):`);
+    for (const e of d.addedEdges.slice(0, 20)) lines.push(`  + ${e.from} -> ${e.to}`);
+  }
+  if (d.removedEdges.length > 0) {
+    lines.push("", `Removed edges (${d.removedEdges.length}, up to 20):`);
+    for (const e of d.removedEdges.slice(0, 20)) lines.push(`  - ${e.from} -> ${e.to}`);
+  }
+  lines.push(
+    "",
+    "Narrate this delta in plain English. Highlight structural shifts and likely downstream consequences."
+  );
+  return lines.join("\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 {
+  graphCommand
+};
+//# sourceMappingURL=graph-YYL5UYCJ.js.map

package/dist/graph-YYL5UYCJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/graph.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport {\n  buildDependencyGraph,\n  diffDependencyGraphs,\n  loadProject,\n  pac,\n  parseProjectModel,\n  renderGraphDot,\n  renderGraphMermaid,\n  type DatabricksObject,\n  type DependencyGraph,\n  type DependencyGraphDiff,\n} from '@ddt-tools/core';\nimport { attachExplainFlag, runExplain } from '../util/ai-explain.js';\n\n/**\n * `ddt graph` — emit an object-dependency DAG (Mermaid or DOT) from a\n * `.ddtproj` or `.ddtpac`. Lets reviewers see blast radius before a\n * drop. Inspired by DBeaver's \"Object References\" panel — but at the\n * cross-object level rather than column level.\n *\n * With `--compare-to <other-source>`, diffs the two graphs and (when\n * `--explain` is on) narrates the DAG changes in plain English — the\n * AI Phase 6 \"lineage explanation\" surface.\n */\nexport function graphCommand(): Command {\n  const cmd = new Command('graph');\n  cmd\n    .description('Build an object-dependency DAG and emit it as Mermaid or DOT.')\n    .requiredOption('--source <path>', '.ddtproj or .ddtpac to analyze.')\n    .option('-o, --out <path>', 'Output file path. Defaults to stdout.')\n    .option(\n      '--format <fmt>',\n      'mermaid | dot | md (Mermaid wrapped in a markdown fenced block)',\n      'mermaid',\n    )\n    .option('--json', 'Emit the raw { nodes, edges } JSON instead of a renderer.', false)\n    .option(\n      '--compare-to <path>',\n      'A second .ddtproj or .ddtpac. When set, emit added / removed / changed nodes + edges (the DAG delta) instead of the static graph.',\n    )\n    .action(async (opts) => {\n      const model = await loadModel(String(opts.source));\n      const graph = buildDependencyGraph(model);\n\n      let diff: DependencyGraphDiff | undefined;\n      if (opts.compareTo) {\n        const otherModel = await loadModel(String(opts.compareTo));\n        const otherGraph = buildDependencyGraph(otherModel);\n        diff = diffDependencyGraphs(otherGraph, graph);\n      }\n\n      const fmt = String(opts.format ?? 'mermaid').toLowerCase();\n      let payload: string;\n      if (opts.json) {\n        payload = JSON.stringify(diff ?? graph, null, 2);\n      } else if (diff) {\n        payload = renderDiffMarkdown(diff);\n      } else if (fmt === 'mermaid') {\n        payload = renderGraphMermaid(graph);\n      } else if (fmt === 'dot') {\n        payload = renderGraphDot(graph);\n      } else if (fmt === 'md') {\n        payload = `# Schema dependency graph\\n\\n${graph.nodes.length} node(s), ${graph.edges.length} edge(s).\\n\\n\\`\\`\\`mermaid\\n${renderGraphMermaid(graph)}\\n\\`\\`\\`\\n`;\n      } else {\n        throw new Error(`Unknown --format: ${fmt}. Use mermaid | dot | md.`);\n      }\n\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, payload + (payload.endsWith('\\n') ? '' : '\\n'), 'utf8');\n        console.error(\n          `Wrote ${out} (${payload.length} bytes, ${graph.nodes.length} nodes, ${graph.edges.length} edges).`,\n        );\n      } else {\n        process.stdout.write(payload + (payload.endsWith('\\n') ? '' : '\\n'));\n      }\n\n      await runExplain(\n        {\n          feature: 'graph.explain',\n          systemPrompt: diff\n            ? 'You are a data-platform architect narrating a dependency-graph DELTA between two snapshots. Walk through added / removed / changed nodes and edges in plain English. Call out structural shifts (new sources, dropped consumers, type changes) and likely-but-not-yet-broken downstream consequences.'\n            : 'You are a data-platform architect explaining a dependency graph. Describe the dominant data-flow shape, point out hot or fragile nodes, and recommend any decomposition the graph suggests.',\n        },\n        opts as { explain?: boolean },\n        () => (diff ? buildDiffPrompt(diff) : buildGraphPrompt(graph)),\n      );\n    });\n  attachExplainFlag(cmd);\n  return cmd;\n}\n\nfunction renderDiffMarkdown(d: DependencyGraphDiff): string {\n  const lines: string[] = ['# Dependency-graph delta', ''];\n  lines.push(\n    `**Summary**: ${d.summary.nodeDelta >= 0 ? '+' : ''}${d.summary.nodeDelta} nodes, ` +\n      `${d.summary.edgeDelta >= 0 ? '+' : ''}${d.summary.edgeDelta} edges. ` +\n      `${d.addedNodes.length} added node(s), ${d.removedNodes.length} removed node(s), ` +\n      `${d.changedNodes.length} changed node(s).`,\n  );\n  lines.push('');\n  if (d.addedNodes.length > 0) {\n    lines.push('## Added nodes');\n    for (const n of d.addedNodes) lines.push(`- \\`${n.fqn}\\` (${n.objectType})`);\n    lines.push('');\n  }\n  if (d.removedNodes.length > 0) {\n    lines.push('## Removed nodes');\n    for (const n of d.removedNodes) lines.push(`- \\`${n.fqn}\\` (${n.objectType})`);\n    lines.push('');\n  }\n  if (d.changedNodes.length > 0) {\n    lines.push('## Changed nodes (objectType)');\n    for (const c of d.changedNodes) lines.push(`- \\`${c.fqn}\\`: ${c.before} → ${c.after}`);\n    lines.push('');\n  }\n  if (d.addedEdges.length > 0) {\n    lines.push('## Added edges');\n    for (const e of d.addedEdges) lines.push(`- \\`${e.from}\\` → \\`${e.to}\\` (${e.kind})`);\n    lines.push('');\n  }\n  if (d.removedEdges.length > 0) {\n    lines.push('## Removed edges');\n    for (const e of d.removedEdges) lines.push(`- \\`${e.from}\\` → \\`${e.to}\\` (${e.kind})`);\n  }\n  return lines.join('\\n');\n}\n\nfunction buildGraphPrompt(g: DependencyGraph): string {\n  const sample = g.edges.slice(0, 40).map((e) => `  - ${e.from} -> ${e.to}`);\n  return [\n    `Dependency graph: ${g.nodes.length} nodes, ${g.edges.length} edges.`,\n    '',\n    'Edges (up to 40):',\n    ...sample,\n    '',\n    'Narrate this graph in plain English.',\n  ].join('\\n');\n}\n\nfunction buildDiffPrompt(d: DependencyGraphDiff): string {\n  const lines: string[] = [];\n  lines.push(\n    `Graph delta: ${d.summary.nodeDelta >= 0 ? '+' : ''}${d.summary.nodeDelta} nodes, ` +\n      `${d.summary.edgeDelta >= 0 ? '+' : ''}${d.summary.edgeDelta} edges.`,\n  );\n  if (d.addedNodes.length > 0) {\n    lines.push('', `Added nodes (${d.addedNodes.length}, up to 20):`);\n    for (const n of d.addedNodes.slice(0, 20)) lines.push(`  + ${n.fqn} (${n.objectType})`);\n  }\n  if (d.removedNodes.length > 0) {\n    lines.push('', `Removed nodes (${d.removedNodes.length}, up to 20):`);\n    for (const n of d.removedNodes.slice(0, 20)) lines.push(`  - ${n.fqn} (${n.objectType})`);\n  }\n  if (d.changedNodes.length > 0) {\n    lines.push('', `Changed nodes (${d.changedNodes.length}):`);\n    for (const c of d.changedNodes.slice(0, 20))\n      lines.push(`  ~ ${c.fqn}: ${c.before} -> ${c.after}`);\n  }\n  if (d.addedEdges.length > 0) {\n    lines.push('', `Added edges (${d.addedEdges.length}, up to 20):`);\n    for (const e of d.addedEdges.slice(0, 20)) lines.push(`  + ${e.from} -> ${e.to}`);\n  }\n  if (d.removedEdges.length > 0) {\n    lines.push('', `Removed edges (${d.removedEdges.length}, up to 20):`);\n    for (const e of d.removedEdges.slice(0, 20)) lines.push(`  - ${e.from} -> ${e.to}`);\n  }\n  lines.push(\n    '',\n    'Narrate this delta in plain English. Highlight structural shifts and likely downstream consequences.',\n  );\n  return lines.join('\\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)) as DatabricksObject[];\n}\n"],"mappings":"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","names":[]}

package/dist/history-GDRFP4PG.js

@@ -0,0 +1,184 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/history.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import { createConnection, getProfile, queryHistory } from "@ddt-tools/core";
+function historyCommand() {
+  const cmd = new Command("history");
+  cmd.description(
+    "List deploy manifests (default) or query live system.query.* via --last/--query/--verify."
+  ).option(
+    "--dir <path>",
+    "Directory containing *.json manifests (manifest mode).",
+    "./.ddt/history"
+  ).option("--limit <n>", "Manifest mode: most-recent N entries. Live mode: max rows.", "20").option("--json", "Emit JSON instead of human-readable table.", false).option(
+    "--full-sql",
+    "Include full SQL text in the output (default truncated to 120 chars).",
+    false
+  ).option(
+    "--connection <profile>",
+    "Connection profile (required for --last / --query / --verify)."
+  ).option("--last [n]", "Live mode: show the N most-recent queries. Default 20.").option("--query <id>", "Live mode: look up a single query by its statement_id.").option(
+    "--verify <tag>",
+    "Live mode: read all queries tagged with this string. Use the `DDT-TAG` auto-tag from `ddt publish --apply`."
+  ).option("--since <iso>", "Live mode: only include entries after this ISO 8601 timestamp.").action(
+    async (opts) => {
+      const isLive = opts.last !== void 0 || opts.query !== void 0 || opts.verify !== void 0;
+      if (isLive) await runLive(opts);
+      else await runManifests(opts);
+    }
+  );
+  return cmd;
+}
+async function runManifests(opts) {
+  const dir = path.resolve(String(opts.dir ?? "./.ddt/history"));
+  let files;
+  try {
+    const entries2 = await fs.readdir(dir);
+    files = entries2.filter((f) => f.endsWith(".json")).map((f) => path.join(dir, f));
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      console.error(
+        `No history directory at ${dir}. Pass --dir <path> or pipe deploys to write manifests there.`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    throw err;
+  }
+  const entries = [];
+  for (const f of files) {
+    try {
+      const raw = await fs.readFile(f, "utf8");
+      const m = JSON.parse(raw);
+      const stat = await fs.stat(f);
+      entries.push({ path: f, mtime: stat.mtime, manifest: m });
+    } catch {
+    }
+  }
+  entries.sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+  const limit = parseInt(String(opts.limit ?? 20), 10);
+  const visible = entries.slice(0, limit > 0 ? limit : entries.length);
+  if (opts.json) {
+    console.log(
+      JSON.stringify(
+        visible.map((e) => ({ path: e.path, mtime: e.mtime.toISOString(), ...e.manifest })),
+        null,
+        2
+      )
+    );
+    return;
+  }
+  if (visible.length === 0) {
+    console.log(`No manifests found in ${dir}.`);
+    return;
+  }
+  console.log(`History: ${visible.length} of ${entries.length} deploys at ${dir}`);
+  console.log("");
+  console.log(
+    "  DEPLOYED AT          WORKSPACE                          FINAL STATE         STEPS"
+  );
+  console.log(
+    "  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500"
+  );
+  for (const e of visible) {
+    const m = e.manifest;
+    const when = m.deployedAt ? new Date(m.deployedAt).toISOString().slice(0, 19).replace("T", " ") : e.mtime.toISOString().slice(0, 19).replace("T", " ");
+    const host = (m.workspaceHost ?? "?").padEnd(34).slice(0, 34);
+    const state = (m.finalState ?? "?").padEnd(18).slice(0, 18);
+    const succ = m.steps?.filter((s) => s.status === "SUCCESS").length ?? 0;
+    const tot = m.steps?.length ?? 0;
+    console.log(`  ${when}  ${host}  ${state}  ${succ}/${tot}`);
+    if (opts.fullSql) {
+      for (const s of m.steps ?? []) {
+        if (s.forwardSql) console.log(`      [forward] ${s.fqn ?? ""}
+${indent(s.forwardSql, 8)}`);
+      }
+    }
+  }
+  console.log("");
+  console.log(
+    `Pass --json for machine-readable output, --limit <n> to control depth, --full-sql to expand each step.`
+  );
+}
+async function runLive(opts) {
+  if (!opts.connection) {
+    console.error("Live history mode requires --connection <profile>.");
+    process.exitCode = 1;
+    return;
+  }
+  const profile = await getProfile(String(opts.connection));
+  const conn = createConnection(profile);
+  await conn.connect();
+  try {
+    const reader = new queryHistory.DatabricksQueryHistoryReader(conn);
+    const limit = Math.max(1, parseInt(String(opts.limit ?? "20"), 10) || 20);
+    const since = opts.since ? new Date(opts.since) : void 0;
+    let entries = [];
+    if (opts.query) {
+      const e = await reader.readById(String(opts.query));
+      entries = e ? [e] : [];
+    } else if (opts.verify) {
+      entries = await reader.readByTag(String(opts.verify), {
+        ...since ? { since } : {},
+        limit
+      });
+    } else {
+      const n = typeof opts.last === "string" ? parseInt(opts.last, 10) || limit : limit;
+      const user = profile.auth.user ?? profile.auth.principalEmail ?? "";
+      entries = await reader.readByUser(user, {
+        ...since ? { since } : {},
+        limit: n
+      });
+    }
+    if (opts.json) {
+      process.stdout.write(JSON.stringify(entries, null, 2) + "\n");
+      return;
+    }
+    renderEntries(entries, Boolean(opts.fullSql));
+  } finally {
+    await conn.disconnect();
+  }
+}
+function renderEntries(entries, fullSql) {
+  if (entries.length === 0) {
+    console.log("No matching queries found.");
+    return;
+  }
+  console.log(`${entries.length} quer${entries.length === 1 ? "y" : "ies"}:`);
+  console.log("");
+  console.log("  STARTED              STATUS    DURATION  USER                  STATEMENT_ID");
+  console.log(
+    "  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+  );
+  for (const e of entries) {
+    const when = e.startedAt.slice(0, 19).replace("T", " ");
+    const status = e.status.toUpperCase().padEnd(8);
+    const dur = `${e.durationMs}ms`.padEnd(8);
+    const user = (e.user ?? "?").padEnd(20).slice(0, 20);
+    console.log(`  ${when}  ${status}  ${dur}  ${user}  ${e.queryId}`);
+    const sql = fullSql ? e.sqlText : truncate(e.sqlText, 120);
+    if (sql)
+      console.log(
+        `      ${sql.split("\n").map((l) => l.trim()).filter(Boolean).join(" ")}`
+      );
+    if (e.queryTag) console.log(`      tag: ${e.queryTag}`);
+    if (e.errorMessage) console.log(`      ERROR: ${e.errorMessage}`);
+  }
+}
+function indent(text, n) {
+  const pad = " ".repeat(n);
+  return text.split("\n").map((l) => pad + l).join("\n");
+}
+function truncate(s, max) {
+  if (!s) return "";
+  const collapsed = s.replace(/\s+/g, " ").trim();
+  if (collapsed.length <= max) return collapsed;
+  return collapsed.slice(0, max - 1) + "\u2026";
+}
+export {
+  historyCommand
+};
+//# sourceMappingURL=history-GDRFP4PG.js.map

package/dist/history-GDRFP4PG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/history.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport { createConnection, getProfile, queryHistory } from '@ddt-tools/core';\n\ntype QueryHistoryEntry = queryHistory.QueryHistoryEntry;\n\n/**\n * `ddt history` — two modes.\n *\n *   1. **Manifest mode** (default) — read deploy manifests from a\n *      directory and show a chronological summary.\n *\n *   2. **Live mode** (triggered by `--last`, `--query`, or `--verify`)\n *      — query the workspace `system.query.*` tables via the\n *      DatabricksQueryHistoryReader. Requires `--connection <profile>`.\n *\n * Mirrors `sdt history`.\n */\ninterface Manifest {\n  version: 1;\n  deployedAt?: string;\n  workspaceHost?: string;\n  finalState?: string;\n  failedStepId?: string | null;\n  steps?: Array<{\n    status?: string;\n    objectType?: string;\n    fqn?: string;\n    forwardSql?: string;\n    reverseSql?: string;\n  }>;\n}\n\nexport function historyCommand(): Command {\n  const cmd = new Command('history');\n  cmd\n    .description(\n      'List deploy manifests (default) or query live system.query.* via --last/--query/--verify.',\n    )\n    .option(\n      '--dir <path>',\n      'Directory containing *.json manifests (manifest mode).',\n      './.ddt/history',\n    )\n    .option('--limit <n>', 'Manifest mode: most-recent N entries. Live mode: max rows.', '20')\n    .option('--json', 'Emit JSON instead of human-readable table.', false)\n    .option(\n      '--full-sql',\n      'Include full SQL text in the output (default truncated to 120 chars).',\n      false,\n    )\n    .option(\n      '--connection <profile>',\n      'Connection profile (required for --last / --query / --verify).',\n    )\n    .option('--last [n]', 'Live mode: show the N most-recent queries. Default 20.')\n    .option('--query <id>', 'Live mode: look up a single query by its statement_id.')\n    .option(\n      '--verify <tag>',\n      'Live mode: read all queries tagged with this string. Use the `DDT-TAG` auto-tag from `ddt publish --apply`.',\n    )\n    .option('--since <iso>', 'Live mode: only include entries after this ISO 8601 timestamp.')\n    .action(\n      async (opts: {\n        dir?: string;\n        limit?: string;\n        json?: boolean;\n        fullSql?: boolean;\n        connection?: string;\n        last?: boolean | string;\n        query?: string;\n        verify?: string;\n        since?: string;\n      }) => {\n        const isLive =\n          opts.last !== undefined || opts.query !== undefined || opts.verify !== undefined;\n        if (isLive) await runLive(opts);\n        else await runManifests(opts);\n      },\n    );\n  return cmd;\n}\n\nasync function runManifests(opts: {\n  dir?: string;\n  limit?: string;\n  json?: boolean;\n  fullSql?: boolean;\n}): Promise<void> {\n  const dir = path.resolve(String(opts.dir ?? './.ddt/history'));\n  let files: string[];\n  try {\n    const entries = await fs.readdir(dir);\n    files = entries.filter((f) => f.endsWith('.json')).map((f) => path.join(dir, f));\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n      console.error(\n        `No history directory at ${dir}. Pass --dir <path> or pipe deploys to write manifests there.`,\n      );\n      process.exitCode = 1;\n      return;\n    }\n    throw err;\n  }\n\n  const entries: Array<{ path: string; mtime: Date; manifest: Manifest }> = [];\n  for (const f of files) {\n    try {\n      const raw = await fs.readFile(f, 'utf8');\n      const m = JSON.parse(raw) as Manifest;\n      const stat = await fs.stat(f);\n      entries.push({ path: f, mtime: stat.mtime, manifest: m });\n    } catch {\n      // skip files that don't parse\n    }\n  }\n  entries.sort((a, b) => b.mtime.getTime() - a.mtime.getTime());\n\n  const limit = parseInt(String(opts.limit ?? 20), 10);\n  const visible = entries.slice(0, limit > 0 ? limit : entries.length);\n\n  if (opts.json) {\n    console.log(\n      JSON.stringify(\n        visible.map((e) => ({ path: e.path, mtime: e.mtime.toISOString(), ...e.manifest })),\n        null,\n        2,\n      ),\n    );\n    return;\n  }\n\n  if (visible.length === 0) {\n    console.log(`No manifests found in ${dir}.`);\n    return;\n  }\n  console.log(`History: ${visible.length} of ${entries.length} deploys at ${dir}`);\n  console.log('');\n  console.log(\n    '  DEPLOYED AT          WORKSPACE                          FINAL STATE         STEPS',\n  );\n  console.log(\n    '  ─────────────────── ──────────────────────────────────  ──────────────────  ─────',\n  );\n  for (const e of visible) {\n    const m = e.manifest;\n    const when = m.deployedAt\n      ? new Date(m.deployedAt).toISOString().slice(0, 19).replace('T', ' ')\n      : e.mtime.toISOString().slice(0, 19).replace('T', ' ');\n    const host = (m.workspaceHost ?? '?').padEnd(34).slice(0, 34);\n    const state = (m.finalState ?? '?').padEnd(18).slice(0, 18);\n    const succ = m.steps?.filter((s) => s.status === 'SUCCESS').length ?? 0;\n    const tot = m.steps?.length ?? 0;\n    console.log(`  ${when}  ${host}  ${state}  ${succ}/${tot}`);\n    if (opts.fullSql) {\n      for (const s of m.steps ?? []) {\n        if (s.forwardSql) console.log(`      [forward] ${s.fqn ?? ''}\\n${indent(s.forwardSql, 8)}`);\n      }\n    }\n  }\n  console.log('');\n  console.log(\n    `Pass --json for machine-readable output, --limit <n> to control depth, --full-sql to expand each step.`,\n  );\n}\n\nasync function runLive(opts: {\n  connection?: string;\n  last?: boolean | string;\n  query?: string;\n  verify?: string;\n  since?: string;\n  limit?: string;\n  json?: boolean;\n  fullSql?: boolean;\n}): Promise<void> {\n  if (!opts.connection) {\n    console.error('Live history mode requires --connection <profile>.');\n    process.exitCode = 1;\n    return;\n  }\n  const profile = await getProfile(String(opts.connection));\n  const conn = createConnection(profile);\n  await conn.connect();\n  try {\n    const reader = new queryHistory.DatabricksQueryHistoryReader(conn);\n    const limit = Math.max(1, parseInt(String(opts.limit ?? '20'), 10) || 20);\n    const since = opts.since ? new Date(opts.since) : undefined;\n\n    let entries: QueryHistoryEntry[] = [];\n    if (opts.query) {\n      const e = await reader.readById(String(opts.query));\n      entries = e ? [e] : [];\n    } else if (opts.verify) {\n      entries = await reader.readByTag(String(opts.verify), {\n        ...(since ? { since } : {}),\n        limit,\n      });\n    } else {\n      const n = typeof opts.last === 'string' ? parseInt(opts.last, 10) || limit : limit;\n      const user =\n        (profile.auth as { user?: string; principalEmail?: string }).user ??\n        (profile.auth as { principalEmail?: string }).principalEmail ??\n        '';\n      entries = await reader.readByUser(user, {\n        ...(since ? { since } : {}),\n        limit: n,\n      });\n    }\n\n    if (opts.json) {\n      process.stdout.write(JSON.stringify(entries, null, 2) + '\\n');\n      return;\n    }\n    renderEntries(entries, Boolean(opts.fullSql));\n  } finally {\n    await conn.disconnect();\n  }\n}\n\nfunction renderEntries(entries: readonly QueryHistoryEntry[], fullSql: boolean): void {\n  if (entries.length === 0) {\n    console.log('No matching queries found.');\n    return;\n  }\n  console.log(`${entries.length} quer${entries.length === 1 ? 'y' : 'ies'}:`);\n  console.log('');\n  console.log('  STARTED              STATUS    DURATION  USER                  STATEMENT_ID');\n  console.log(\n    '  ─────────────────── ────────  ────────  ───────────────────── ────────────────────────────',\n  );\n  for (const e of entries) {\n    const when = e.startedAt.slice(0, 19).replace('T', ' ');\n    const status = e.status.toUpperCase().padEnd(8);\n    const dur = `${e.durationMs}ms`.padEnd(8);\n    const user = (e.user ?? '?').padEnd(20).slice(0, 20);\n    console.log(`  ${when}  ${status}  ${dur}  ${user}  ${e.queryId}`);\n    const sql = fullSql ? e.sqlText : truncate(e.sqlText, 120);\n    if (sql)\n      console.log(\n        `      ${sql\n          .split('\\n')\n          .map((l: string) => l.trim())\n          .filter(Boolean)\n          .join(' ')}`,\n      );\n    if (e.queryTag) console.log(`      tag: ${e.queryTag}`);\n    if (e.errorMessage) console.log(`      ERROR: ${e.errorMessage}`);\n  }\n}\n\nfunction indent(text: string, n: number): string {\n  const pad = ' '.repeat(n);\n  return text\n    .split('\\n')\n    .map((l) => pad + l)\n    .join('\\n');\n}\n\nfunction truncate(s: string, max: number): string {\n  if (!s) return '';\n  const collapsed = s.replace(/\\s+/g, ' ').trim();\n  if (collapsed.length <= max) return collapsed;\n  return collapsed.slice(0, max - 1) + '…';\n}\n"],"mappings":"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","names":["entries"]}

package/dist/hosts-DRFZTMIJ.js

@@ -0,0 +1,45 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/hosts.ts
+import { Command } from "commander";
+import { hosts as hostsApi } from "@ddt-tools/core";
+function hostsCommand() {
+  const cmd = new Command("hosts");
+  cmd.description(
+    "Browse every host DDT plugs into \u2014 CLI, VS Code, MCP agents, Databricks Workflows, dbt, Airflow, etc. Shows supported versions and the host-specific tailoring notes."
+  );
+  cmd.command("list").description("List every host adapter with its status and version range.").action(() => {
+    const rows = hostsApi.listHosts();
+    const nameWidth = Math.max(...rows.map((h) => h.name.length), 4);
+    let lastKind = "";
+    for (const host of rows) {
+      if (host.kind !== lastKind) {
+        if (lastKind !== "") process.stdout.write("\n");
+        process.stdout.write(`\u2500\u2500 ${host.kind.toUpperCase()} \u2500\u2500
+`);
+        lastKind = host.kind;
+      }
+      const pad = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
+      const versions = hostsApi.hostSummaryLine(host).split(" \xB7 ")[1] ?? "";
+      process.stdout.write(`  ${pad(host.name, nameWidth)}  ${versions}
+`);
+    }
+    process.stdout.write(
+      "\nRun `ddt hosts show <id>` for tailoring notes. See docs/HOST_INTEGRATIONS.md for the per-host playbook.\n"
+    );
+  });
+  cmd.command("show <id>").description("Print supported versions, idioms, and tailoring notes for one host.").action((id) => {
+    const host = hostsApi.getHost(id);
+    if (!host) {
+      console.error(`Unknown host id: "${id}". Run \`ddt hosts list\` to see all ids.`);
+      process.exitCode = 1;
+      return;
+    }
+    process.stdout.write(hostsApi.hostDetailMessage(host) + "\n");
+  });
+  return cmd;
+}
+export {
+  hostsCommand
+};
+//# sourceMappingURL=hosts-DRFZTMIJ.js.map

package/dist/hosts-DRFZTMIJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/hosts.ts"],"sourcesContent":["/**\n * `ddt hosts` — browse every host DDT plugs into, with version-support\n * + tailoring notes. Companion to `ddt features`: features tell you\n * what we do; hosts tell you where you can do it.\n */\nimport { Command } from 'commander';\nimport { hosts as hostsApi } from '@ddt-tools/core';\n\nexport function hostsCommand(): Command {\n  const cmd = new Command('hosts');\n  cmd.description(\n    'Browse every host DDT plugs into — CLI, VS Code, MCP agents, Databricks Workflows, dbt, Airflow, etc. Shows supported versions and the host-specific tailoring notes.',\n  );\n\n  cmd\n    .command('list')\n    .description('List every host adapter with its status and version range.')\n    .action(() => {\n      const rows = hostsApi.listHosts();\n      const nameWidth = Math.max(...rows.map((h) => h.name.length), 4);\n      let lastKind = '';\n      for (const host of rows) {\n        if (host.kind !== lastKind) {\n          if (lastKind !== '') process.stdout.write('\\n');\n          process.stdout.write(`── ${host.kind.toUpperCase()} ──\\n`);\n          lastKind = host.kind;\n        }\n        const pad = (s: string, w: number): string => s + ' '.repeat(Math.max(0, w - s.length));\n        const versions = hostsApi.hostSummaryLine(host).split(' · ')[1] ?? '';\n        process.stdout.write(`  ${pad(host.name, nameWidth)}  ${versions}\\n`);\n      }\n      process.stdout.write(\n        '\\nRun `ddt hosts show <id>` for tailoring notes. See docs/HOST_INTEGRATIONS.md for the per-host playbook.\\n',\n      );\n    });\n\n  cmd\n    .command('show <id>')\n    .description('Print supported versions, idioms, and tailoring notes for one host.')\n    .action((id: string) => {\n      const host = hostsApi.getHost(id);\n      if (!host) {\n        console.error(`Unknown host id: \"${id}\". Run \\`ddt hosts list\\` to see all ids.`);\n        process.exitCode = 1;\n        return;\n      }\n      process.stdout.write(hostsApi.hostDetailMessage(host) + '\\n');\n    });\n\n  return cmd;\n}\n"],"mappings":";;;AAKA,SAAS,eAAe;AACxB,SAAS,SAAS,gBAAgB;AAE3B,SAAS,eAAwB;AACtC,QAAM,MAAM,IAAI,QAAQ,OAAO;AAC/B,MAAI;AAAA,IACF;AAAA,EACF;AAEA,MACG,QAAQ,MAAM,EACd,YAAY,4DAA4D,EACxE,OAAO,MAAM;AACZ,UAAM,OAAO,SAAS,UAAU;AAChC,UAAM,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,CAAC,MAAM,EAAE,KAAK,MAAM,GAAG,CAAC;AAC/D,QAAI,WAAW;AACf,eAAW,QAAQ,MAAM;AACvB,UAAI,KAAK,SAAS,UAAU;AAC1B,YAAI,aAAa,GAAI,SAAQ,OAAO,MAAM,IAAI;AAC9C,gBAAQ,OAAO,MAAM,gBAAM,KAAK,KAAK,YAAY,CAAC;AAAA,CAAO;AACzD,mBAAW,KAAK;AAAA,MAClB;AACA,YAAM,MAAM,CAAC,GAAW,MAAsB,IAAI,IAAI,OAAO,KAAK,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC;AACtF,YAAM,WAAW,SAAS,gBAAgB,IAAI,EAAE,MAAM,QAAK,EAAE,CAAC,KAAK;AACnE,cAAQ,OAAO,MAAM,KAAK,IAAI,KAAK,MAAM,SAAS,CAAC,KAAK,QAAQ;AAAA,CAAI;AAAA,IACtE;AACA,YAAQ,OAAO;AAAA,MACb;AAAA,IACF;AAAA,EACF,CAAC;AAEH,MACG,QAAQ,WAAW,EACnB,YAAY,qEAAqE,EACjF,OAAO,CAAC,OAAe;AACtB,UAAM,OAAO,SAAS,QAAQ,EAAE;AAChC,QAAI,CAAC,MAAM;AACT,cAAQ,MAAM,qBAAqB,EAAE,2CAA2C;AAChF,cAAQ,WAAW;AACnB;AAAA,IACF;AACA,YAAQ,OAAO,MAAM,SAAS,kBAAkB,IAAI,IAAI,IAAI;AAAA,EAC9D,CAAC;AAEH,SAAO;AACT;","names":[]}

package/dist/impact-A4NU6CB2.js

@@ -0,0 +1,63 @@
+import {
+  attachExplainFlag,
+  runExplain
+} from "./chunk-XFXG347C.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/impact.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import {
+  loadProject,
+  pac,
+  parseProjectModel,
+  review
+} from "@ddt-tools/core";
+function impactCommand() {
+  const cmd = new Command("impact");
+  cmd.description(
+    "Single-FQN blast-radius: who feeds it, who reads from it, what findings apply to it."
+  ).argument("<fqn>", "Fully-qualified name to analyze (e.g. main.gold.orders).").requiredOption("--source <path>", ".ddtproj or .ddtpac to analyze.").option("-o, --out <path>", "Output file path. Defaults to stdout.").action(async (fqn, opts) => {
+    const sourcePath = String(opts.source);
+    const model = await loadModel(sourcePath);
+    const md = review.renderImpactReport(model, String(fqn), { source: sourcePath });
+    await emit(md, opts.out);
+    await runExplain(
+      {
+        feature: "impact.explain",
+        systemPrompt: "You are a senior Databricks data engineer explaining an impact analysis to a developer who is about to change one object. Be very direct about the blast radius and what they should test before merging."
+      },
+      opts,
+      () => `Impact report for ${fqn} follows:
+
+${md}
+
+Explain the blast radius and what the engineer should pay attention to.`
+    );
+  });
+  attachExplainFlag(cmd);
+  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);
+}
+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} (${payload.length} bytes).`);
+  } else {
+    process.stdout.write(payload + (payload.endsWith("\n") ? "" : "\n"));
+  }
+}
+export {
+  impactCommand
+};
+//# sourceMappingURL=impact-A4NU6CB2.js.map

package/dist/impact-A4NU6CB2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/impact.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport {\n  loadProject,\n  pac,\n  parseProjectModel,\n  review,\n  type DatabricksObject,\n} from '@ddt-tools/core';\nimport { attachExplainFlag, runExplain } from '../util/ai-explain.js';\n\n/**\n * `ddt impact <fqn>` — single-FQN blast-radius. Mirrors `sdt impact`.\n */\nexport function impactCommand(): Command {\n  const cmd = new Command('impact');\n  cmd\n    .description(\n      'Single-FQN blast-radius: who feeds it, who reads from it, what findings apply to it.',\n    )\n    .argument('<fqn>', 'Fully-qualified name to analyze (e.g. main.gold.orders).')\n    .requiredOption('--source <path>', '.ddtproj or .ddtpac to analyze.')\n    .option('-o, --out <path>', 'Output file path. Defaults to stdout.')\n    .action(async (fqn: string, opts: { source: string; out?: string; explain?: boolean }) => {\n      const sourcePath = String(opts.source);\n      const model = await loadModel(sourcePath);\n      const md = review.renderImpactReport(model, String(fqn), { source: sourcePath });\n      await emit(md, opts.out);\n      await runExplain(\n        {\n          feature: 'impact.explain',\n          systemPrompt:\n            'You are a senior Databricks data engineer explaining an impact analysis to a developer who is about to change one object. Be very direct about the blast radius and what they should test before merging.',\n        },\n        opts,\n        () =>\n          `Impact report for ${fqn} follows:\\n\\n${md}\\n\\nExplain the blast radius and what the engineer should pay attention to.`,\n      );\n    });\n  attachExplainFlag(cmd);\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\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} (${payload.length} bytes).`);\n  } else {\n    process.stdout.write(payload + (payload.endsWith('\\n') ? '' : '\\n'));\n  }\n}\n"],"mappings":";;;;;;;AAAA,SAAS,YAAY,UAAU;AAC/B,OAAO,UAAU;AACjB,SAAS,eAAe;AACxB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAMA,SAAS,gBAAyB;AACvC,QAAM,MAAM,IAAI,QAAQ,QAAQ;AAChC,MACG;AAAA,IACC;AAAA,EACF,EACC,SAAS,SAAS,0DAA0D,EAC5E,eAAe,mBAAmB,iCAAiC,EACnE,OAAO,oBAAoB,uCAAuC,EAClE,OAAO,OAAO,KAAa,SAA8D;AACxF,UAAM,aAAa,OAAO,KAAK,MAAM;AACrC,UAAM,QAAQ,MAAM,UAAU,UAAU;AACxC,UAAM,KAAK,OAAO,mBAAmB,OAAO,OAAO,GAAG,GAAG,EAAE,QAAQ,WAAW,CAAC;AAC/E,UAAM,KAAK,IAAI,KAAK,GAAG;AACvB,UAAM;AAAA,MACJ;AAAA,QACE,SAAS;AAAA,QACT,cACE;AAAA,MACJ;AAAA,MACA;AAAA,MACA,MACE,qBAAqB,GAAG;AAAA;AAAA,EAAgB,EAAE;AAAA;AAAA;AAAA,IAC9C;AAAA,EACF,CAAC;AACH,oBAAkB,GAAG;AACrB,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;AAEA,eAAe,KAAK,SAAiB,KAA6B;AAChE,MAAI,KAAK;AACP,UAAM,IAAI,KAAK,QAAQ,OAAO,GAAG,CAAC;AAClC,UAAM,GAAG,MAAM,KAAK,QAAQ,CAAC,GAAG,EAAE,WAAW,KAAK,CAAC;AACnD,UAAM,GAAG,UAAU,GAAG,WAAW,QAAQ,SAAS,IAAI,IAAI,KAAK,OAAO,MAAM;AAC5E,YAAQ,MAAM,SAAS,CAAC,KAAK,QAAQ,MAAM,UAAU;AAAA,EACvD,OAAO;AACL,YAAQ,OAAO,MAAM,WAAW,QAAQ,SAAS,IAAI,IAAI,KAAK,KAAK;AAAA,EACrE;AACF;","names":[]}

package/dist/import-2RNYDL4E.js

@@ -0,0 +1,79 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/import.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import { importScript, loadProject, parseScript } from "@ddt-tools/core";
+function importCommand() {
+  const cmd = new Command("import");
+  cmd.description(
+    "Parse a SQL script and write each DDL statement into the .ddtproj tree under its canonical folder."
+  ).requiredOption("--script <path>", "Path to the SQL script to import.").requiredOption("-p, --project <path>", "Path to the .ddtproj file.").option("--dry-run", "Report what would be written without touching disk.", false).option("--force", "Overwrite existing files (default refuses on conflict).", false).option(
+    "--ignore-errors",
+    "Import classifiable statements even when others have errors. Default refuses on any error.",
+    false
+  ).action(async (opts) => {
+    const scriptPath = path.resolve(String(opts.script));
+    const projectPath = path.resolve(String(opts.project));
+    const sql = await fs.readFile(scriptPath, "utf8");
+    const parsed = parseScript(sql);
+    printParseReport(scriptPath, parsed);
+    if (parsed.totalErrors > 0 && !opts.ignoreErrors) {
+      console.error(
+        `
+Refusing to import: ${parsed.totalErrors} parse error(s) above. Fix the script and re-run, or pass --ignore-errors to import the clean statements.`
+      );
+      process.exitCode = 2;
+      return;
+    }
+    const loaded = await loadProject(projectPath);
+    const result = await importScript(parsed, loaded, {
+      dryRun: !!opts.dryRun,
+      force: !!opts.force
+    });
+    console.log("");
+    const verb = opts.dryRun ? "would write" : "wrote";
+    for (const item of result.imported) {
+      const rel = path.relative(loaded.rootDir, item.targetPath);
+      console.log(
+        `  ${verb}  ${item.statement.objectType} ${qualified(item.statement)} \u2192 ${rel}`
+      );
+    }
+    for (const item of result.skipped) {
+      const head = item.statement.objectType && item.statement.fqn ? `${item.statement.objectType} ${qualified(item.statement)}` : `<unclassified statement at line ${item.statement.startLine}>`;
+      console.log(`  skip   ${head} \u2014 ${item.reason}`);
+    }
+    console.log("");
+    console.log(
+      `Summary: ${result.imported.length} ${verb}, ${result.skipped.length} skipped, ${parsed.totalErrors} errors, ${parsed.totalWarnings} warnings.`
+    );
+    if (result.imported.length === 0 && result.skipped.length > 0) {
+      process.exitCode = 1;
+    }
+  });
+  return cmd;
+}
+function qualified(stmt) {
+  if (!stmt.fqn) return "<no fqn>";
+  return [stmt.fqn.database, stmt.fqn.schema, stmt.fqn.name].filter(Boolean).join(".");
+}
+function printParseReport(scriptPath, parsed) {
+  console.log(`Parsed ${parsed.statements.length} statement(s) from ${scriptPath}.`);
+  if (parsed.totalErrors === 0 && parsed.totalWarnings === 0) {
+    console.log("All statements classified cleanly.");
+    return;
+  }
+  for (const stmt of parsed.statements) {
+    if (stmt.errors.length === 0 && stmt.warnings.length === 0) continue;
+    const head = stmt.objectType && stmt.fqn ? `${stmt.objectType} ${qualified(stmt)}` : "<unclassified>";
+    console.log(`
+[line ${stmt.startLine}\u2013${stmt.endLine}] ${head}`);
+    for (const e of stmt.errors) console.log(`  ERROR:   ${e}`);
+    for (const w of stmt.warnings) console.log(`  warning: ${w}`);
+  }
+}
+export {
+  importCommand
+};
+//# sourceMappingURL=import-2RNYDL4E.js.map

package/dist/import-2RNYDL4E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/import.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport { importScript, loadProject, parseScript, type ParsedStatement } from '@ddt-tools/core';\n\n/**\n * `ddt import` — parse a SQL script and apply each DDL statement to a\n * `.ddtproj` tree, writing each into the canonical folder for its object\n * type (`catalogs/<cat>/schemas/<sch>/<type-folder>/<name>.sql`).\n *\n * Default mode is safe:\n *   - Parses the whole script first; refuses to write anything if any\n *     statement has hard errors. The user reviews the report, fixes the\n *     script, and re-runs.\n *   - Refuses to overwrite existing files. Pass `--force` to clobber.\n *   - `--dry-run` shows the plan without writing.\n */\nexport function importCommand(): Command {\n  const cmd = new Command('import');\n  cmd\n    .description(\n      'Parse a SQL script and write each DDL statement into the .ddtproj tree under its canonical folder.',\n    )\n    .requiredOption('--script <path>', 'Path to the SQL script to import.')\n    .requiredOption('-p, --project <path>', 'Path to the .ddtproj file.')\n    .option('--dry-run', 'Report what would be written without touching disk.', false)\n    .option('--force', 'Overwrite existing files (default refuses on conflict).', false)\n    .option(\n      '--ignore-errors',\n      'Import classifiable statements even when others have errors. Default refuses on any error.',\n      false,\n    )\n    .action(async (opts) => {\n      const scriptPath = path.resolve(String(opts.script));\n      const projectPath = path.resolve(String(opts.project));\n      const sql = await fs.readFile(scriptPath, 'utf8');\n      const parsed = parseScript(sql);\n\n      // Up-front parse report — surfaces every error/warning verbatim.\n      printParseReport(scriptPath, parsed);\n\n      if (parsed.totalErrors > 0 && !opts.ignoreErrors) {\n        console.error(\n          `\\nRefusing to import: ${parsed.totalErrors} parse error(s) above. ` +\n            `Fix the script and re-run, or pass --ignore-errors to import the clean statements.`,\n        );\n        process.exitCode = 2;\n        return;\n      }\n\n      const loaded = await loadProject(projectPath);\n      const result = await importScript(parsed, loaded, {\n        dryRun: !!opts.dryRun,\n        force: !!opts.force,\n      });\n\n      console.log('');\n      const verb = opts.dryRun ? 'would write' : 'wrote';\n      for (const item of result.imported) {\n        const rel = path.relative(loaded.rootDir, item.targetPath);\n        console.log(\n          `  ${verb}  ${item.statement.objectType} ${qualified(item.statement)} → ${rel}`,\n        );\n      }\n      for (const item of result.skipped) {\n        const head =\n          item.statement.objectType && item.statement.fqn\n            ? `${item.statement.objectType} ${qualified(item.statement)}`\n            : `<unclassified statement at line ${item.statement.startLine}>`;\n        console.log(`  skip   ${head} — ${item.reason}`);\n      }\n      console.log('');\n      console.log(\n        `Summary: ${result.imported.length} ${verb}, ${result.skipped.length} skipped, ` +\n          `${parsed.totalErrors} errors, ${parsed.totalWarnings} warnings.`,\n      );\n\n      if (result.imported.length === 0 && result.skipped.length > 0) {\n        process.exitCode = 1;\n      }\n    });\n  return cmd;\n}\n\nfunction qualified(stmt: ParsedStatement): string {\n  if (!stmt.fqn) return '<no fqn>';\n  return [stmt.fqn.database, stmt.fqn.schema, stmt.fqn.name].filter(Boolean).join('.');\n}\n\nfunction printParseReport(scriptPath: string, parsed: ReturnType<typeof parseScript>): void {\n  console.log(`Parsed ${parsed.statements.length} statement(s) from ${scriptPath}.`);\n  if (parsed.totalErrors === 0 && parsed.totalWarnings === 0) {\n    console.log('All statements classified cleanly.');\n    return;\n  }\n  for (const stmt of parsed.statements) {\n    if (stmt.errors.length === 0 && stmt.warnings.length === 0) continue;\n    const head =\n      stmt.objectType && stmt.fqn ? `${stmt.objectType} ${qualified(stmt)}` : '<unclassified>';\n    console.log(`\\n[line ${stmt.startLine}–${stmt.endLine}] ${head}`);\n    for (const e of stmt.errors) console.log(`  ERROR:   ${e}`);\n    for (const w of stmt.warnings) console.log(`  warning: ${w}`);\n  }\n}\n"],"mappings":"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","names":[]}