@ddt-tools/cli 0.2.0 → 0.2.4

package/dist/diagnose-WPUL67E4.js

@@ -0,0 +1,150 @@
+import {
+  attachExplainFlag,
+  runExplain
+} from "./chunk-XFXG347C.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/diagnose.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import {
+  diagnostics,
+  interop,
+  loadProject,
+  pac,
+  parseProjectModel
+} from "@ddt-tools/core";
+function diagnoseCommand() {
+  const cmd = new Command("diagnose");
+  cmd.description(
+    "Project-level health report: lint + lineage smells + object smells + cost smells, with reasoning."
+  ).requiredOption("--source <path>", ".ddtproj or .ddtpac to analyze.").option(
+    "--category <c>",
+    "Filter to one category: lint | lineage | smell | cost | dim-modeling."
+  ).option(
+    "--min-severity <s>",
+    "Filter to a minimum severity: error | warning | info. Default info (everything).",
+    "info"
+  ).option(
+    "--format <fmt>",
+    "table | json | markdown | sarif. sarif emits SARIF 2.1.0 for GitHub code-scanning / Azure DevOps. Default table.",
+    "table"
+  ).option("-o, --out <path>", "Output file path. Defaults to stdout.").action(
+    async (opts) => {
+      const sourcePath = String(opts.source);
+      const model = await loadModel(sourcePath);
+      const report = diagnostics.analyzeProject(model, {
+        source: sourcePath,
+        ...opts.category ? { category: String(opts.category) } : {},
+        ...opts.minSeverity ? { minSeverity: String(opts.minSeverity) } : {}
+      });
+      const fmt = String(opts.format ?? "table").toLowerCase();
+      let payload;
+      if (fmt === "json") {
+        payload = JSON.stringify(report, null, 2);
+      } else if (fmt === "markdown") {
+        payload = renderReportMarkdown(report);
+      } else if (fmt === "sarif") {
+        payload = JSON.stringify(interop.diagnosticReportToSarif(report), null, 2);
+      } else if (fmt === "table") {
+        payload = diagnostics.formatReport(report);
+      } else {
+        throw new Error(`Unknown --format: ${fmt}. Use table | json | markdown | sarif.`);
+      }
+      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, ${report.findings.length} finding(s)).`
+        );
+      } else {
+        process.stdout.write(payload + (payload.endsWith("\n") ? "" : "\n"));
+      }
+      if (report.totals.error > 0) process.exitCode = 1;
+      await runExplain({ feature: "diagnose.explain" }, opts, () => buildDiagnosePrompt(report));
+    }
+  );
+  attachExplainFlag(cmd);
+  return cmd;
+}
+function buildDiagnosePrompt(report) {
+  const lines = [];
+  lines.push(`Source: ${report.source || "(unknown)"}`);
+  lines.push(
+    `Totals: ${report.totals.error} error, ${report.totals.warning} warning, ${report.totals.info} info`
+  );
+  lines.push("");
+  const top = report.findings.slice().sort((a, b) => sevWeight(b.severity) - sevWeight(a.severity)).slice(0, 40);
+  lines.push(`Top ${top.length} findings (highest severity first):`);
+  for (const d of top) {
+    lines.push(`- [${d.severity}] ${d.id} \xB7 ${d.fqn || "(project)"} \u2014 ${d.message}`);
+  }
+  if (report.findings.length > top.length) {
+    lines.push(`(\u2026 ${report.findings.length - top.length} more truncated)`);
+  }
+  lines.push("");
+  lines.push(
+    "Explain the dominant themes, what they suggest about the project health, and the highest-leverage fixes the team should tackle first."
+  );
+  return lines.join("\n");
+}
+function sevWeight(s) {
+  return s === "error" ? 3 : s === "warning" ? 2 : 1;
+}
+function renderReportMarkdown(report) {
+  const lines = [];
+  lines.push(`# Diagnostic report \u2014 \`${report.source || "(no source)"}\``);
+  lines.push("");
+  lines.push(`Generated: ${report.generatedAt}`);
+  lines.push("");
+  lines.push(
+    `**Totals:** ${report.totals.error} error \xB7 ${report.totals.warning} warning \xB7 ${report.totals.info} info`
+  );
+  lines.push("");
+  lines.push("## By category");
+  lines.push("");
+  lines.push("| Category | Count |");
+  lines.push("|---|---|");
+  for (const [k, v] of Object.entries(report.byCategory)) {
+    if (v > 0) lines.push(`| ${k} | ${v} |`);
+  }
+  lines.push("");
+  if (report.findings.length === 0) {
+    lines.push("_No findings._");
+    return lines.join("\n");
+  }
+  lines.push("## Findings");
+  lines.push("");
+  for (const d of report.findings) {
+    const glyph = d.severity === "error" ? "\u{1F6D1}" : d.severity === "warning" ? "\u26A0\uFE0F" : "\u2139\uFE0F";
+    lines.push(`### ${glyph} \`${d.id}\` \u2014 ${d.fqn || "(project)"}`);
+    lines.push("");
+    lines.push(`**${d.message}**`);
+    lines.push("");
+    lines.push(`*Why:* ${d.reasoning}`);
+    lines.push("");
+    lines.push(`*Suggestion:* ${d.suggestion}`);
+    lines.push("");
+    if (d.related && d.related.length > 0) {
+      lines.push(
+        `*Related:* ${d.related.slice(0, 5).map((r) => `\`${r}\``).join(", ")}`
+      );
+      lines.push("");
+    }
+  }
+  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 {
+  diagnoseCommand
+};
+//# sourceMappingURL=diagnose-WPUL67E4.js.map

package/dist/diagnose-WPUL67E4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/diagnose.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport {\n  diagnostics,\n  interop,\n  loadProject,\n  pac,\n  parseProjectModel,\n  type DatabricksObject,\n} from '@ddt-tools/core';\nimport { attachExplainFlag, runExplain } from '../util/ai-explain.js';\n\n/**\n * `ddt diagnose` — project-level health report. Bundles lint, lineage\n * smells (orphan / no-downstream / hot-table / cycle), object smells\n * (`SELECT *` in views, large tables without CLUSTER BY / Z-ORDER,\n * streaming tables without watermark / checkpoint, deletion-vector\n * gaps) and cost smells (long delta.logRetentionDuration). Every\n * finding ships with a **reasoning** line explaining *why* it matters.\n *\n * Mirrors `sdt diagnose`.\n */\nexport function diagnoseCommand(): Command {\n  const cmd = new Command('diagnose');\n  cmd\n    .description(\n      'Project-level health report: lint + lineage smells + object smells + cost smells, with reasoning.',\n    )\n    .requiredOption('--source <path>', '.ddtproj or .ddtpac to analyze.')\n    .option(\n      '--category <c>',\n      'Filter to one category: lint | lineage | smell | cost | dim-modeling.',\n    )\n    .option(\n      '--min-severity <s>',\n      'Filter to a minimum severity: error | warning | info. Default info (everything).',\n      'info',\n    )\n    .option(\n      '--format <fmt>',\n      'table | json | markdown | sarif. sarif emits SARIF 2.1.0 for GitHub code-scanning / Azure DevOps. Default table.',\n      'table',\n    )\n    .option('-o, --out <path>', 'Output file path. Defaults to stdout.')\n    .action(\n      async (opts: {\n        source: string;\n        category?: string;\n        minSeverity?: string;\n        format?: string;\n        out?: string;\n        explain?: boolean;\n      }) => {\n        const sourcePath = String(opts.source);\n        const model = await loadModel(sourcePath);\n        const report = diagnostics.analyzeProject(model, {\n          source: sourcePath,\n          ...(opts.category\n            ? { category: String(opts.category) as diagnostics.DiagnosticCategory }\n            : {}),\n          ...(opts.minSeverity\n            ? { minSeverity: String(opts.minSeverity) as diagnostics.DiagnosticSeverity }\n            : {}),\n        });\n\n        const fmt = String(opts.format ?? 'table').toLowerCase();\n        let payload: string;\n        if (fmt === 'json') {\n          payload = JSON.stringify(report, null, 2);\n        } else if (fmt === 'markdown') {\n          payload = renderReportMarkdown(report);\n        } else if (fmt === 'sarif') {\n          payload = JSON.stringify(interop.diagnosticReportToSarif(report), null, 2);\n        } else if (fmt === 'table') {\n          payload = diagnostics.formatReport(report);\n        } else {\n          throw new Error(`Unknown --format: ${fmt}. Use table | json | markdown | sarif.`);\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, ${report.findings.length} finding(s)).`,\n          );\n        } else {\n          process.stdout.write(payload + (payload.endsWith('\\n') ? '' : '\\n'));\n        }\n\n        if (report.totals.error > 0) process.exitCode = 1;\n\n        await runExplain({ feature: 'diagnose.explain' }, opts, () => buildDiagnosePrompt(report));\n      },\n    );\n  attachExplainFlag(cmd);\n  return cmd;\n}\n\nfunction buildDiagnosePrompt(report: diagnostics.DiagnosticReport): string {\n  const lines: string[] = [];\n  lines.push(`Source: ${report.source || '(unknown)'}`);\n  lines.push(\n    `Totals: ${report.totals.error} error, ${report.totals.warning} warning, ${report.totals.info} info`,\n  );\n  lines.push('');\n  const top = report.findings\n    .slice()\n    .sort((a, b) => sevWeight(b.severity) - sevWeight(a.severity))\n    .slice(0, 40);\n  lines.push(`Top ${top.length} findings (highest severity first):`);\n  for (const d of top) {\n    lines.push(`- [${d.severity}] ${d.id} · ${d.fqn || '(project)'} — ${d.message}`);\n  }\n  if (report.findings.length > top.length) {\n    lines.push(`(… ${report.findings.length - top.length} more truncated)`);\n  }\n  lines.push('');\n  lines.push(\n    'Explain the dominant themes, what they suggest about the project health, and the highest-leverage fixes the team should tackle first.',\n  );\n  return lines.join('\\n');\n}\n\nfunction sevWeight(s: diagnostics.DiagnosticSeverity): number {\n  return s === 'error' ? 3 : s === 'warning' ? 2 : 1;\n}\n\nfunction renderReportMarkdown(report: diagnostics.DiagnosticReport): string {\n  const lines: string[] = [];\n  lines.push(`# Diagnostic report — \\`${report.source || '(no source)'}\\``);\n  lines.push('');\n  lines.push(`Generated: ${report.generatedAt}`);\n  lines.push('');\n  lines.push(\n    `**Totals:** ${report.totals.error} error · ${report.totals.warning} warning · ${report.totals.info} info`,\n  );\n  lines.push('');\n  lines.push('## By category');\n  lines.push('');\n  lines.push('| Category | Count |');\n  lines.push('|---|---|');\n  for (const [k, v] of Object.entries(report.byCategory)) {\n    if (v > 0) lines.push(`| ${k} | ${v} |`);\n  }\n  lines.push('');\n  if (report.findings.length === 0) {\n    lines.push('_No findings._');\n    return lines.join('\\n');\n  }\n  lines.push('## Findings');\n  lines.push('');\n  for (const d of report.findings) {\n    const glyph = d.severity === 'error' ? '🛑' : d.severity === 'warning' ? '⚠️' : 'ℹ️';\n    lines.push(`### ${glyph} \\`${d.id}\\` — ${d.fqn || '(project)'}`);\n    lines.push('');\n    lines.push(`**${d.message}**`);\n    lines.push('');\n    lines.push(`*Why:* ${d.reasoning}`);\n    lines.push('');\n    lines.push(`*Suggestion:* ${d.suggestion}`);\n    lines.push('');\n    if (d.related && d.related.length > 0) {\n      lines.push(\n        `*Related:* ${d.related\n          .slice(0, 5)\n          .map((r) => `\\`${r}\\``)\n          .join(', ')}`,\n      );\n      lines.push('');\n    }\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);\n}\n"],"mappings":"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","names":[]}

package/dist/discover-DEO2R5T6.js

@@ -0,0 +1,78 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/discover.ts
+import { rmSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { Command } from "commander";
+import chalk from "chalk";
+import { FeatureAdvisor, DDT_HINT_RULES } from "@ddt-tools/core/discovery";
+var IMPORTANT_COMMANDS = [
+  "build",
+  "publish",
+  "compare",
+  "drift",
+  "lint",
+  "extract",
+  "safety",
+  "verify",
+  "validate",
+  "script"
+];
+function discoverCommand() {
+  const cmd = new Command("discover");
+  cmd.description("Show personalized feature suggestions based on your usage history.").option("--reset", "Clear usage history and start fresh.").action((opts) => {
+    if (opts.reset) {
+      try {
+        rmSync(join(homedir(), ".ddt", "discovery.json"), { force: true });
+      } catch {
+      }
+      console.log(chalk.dim("  Discovery history cleared."));
+      return;
+    }
+    const advisor = new FeatureAdvisor("ddt", DDT_HINT_RULES);
+    const stats = advisor.getUsageStats();
+    const total = Object.values(stats).reduce((a, b) => a + b, 0);
+    console.log("");
+    console.log(chalk.bold("  Feature Discovery") + chalk.dim(" \u2014 based on your usage history"));
+    console.log("");
+    if (total === 0) {
+      console.log(
+        chalk.dim(
+          "  No usage recorded yet. Run a few ddt commands to get personalized suggestions.\n"
+        )
+      );
+      console.log(chalk.dim("  Quick start:"));
+      console.log(`    ${chalk.cyan("ddt init")}             initialize a new project`);
+      console.log(`    ${chalk.cyan("ddt build")}            build a .ddtpac artifact`);
+      console.log(`    ${chalk.cyan("ddt compare")}          compare project vs. Unity Catalog`);
+      console.log("");
+      console.log(chalk.dim("  ddt features list \xB7 ddt explain <topic>"));
+      console.log("");
+      return;
+    }
+    const tried = IMPORTANT_COMMANDS.filter((c) => (stats[c] ?? 0) > 0);
+    const untried = IMPORTANT_COMMANDS.filter((c) => (stats[c] ?? 0) === 0);
+    if (tried.length > 0) {
+      console.log(chalk.dim("  Commands you use:"));
+      const sorted = [...tried].sort((a, b) => (stats[b] ?? 0) - (stats[a] ?? 0));
+      for (const c of sorted) {
+        console.log(`    ${chalk.green("\u2714")} ddt ${c.padEnd(14)} ${chalk.dim(`${stats[c]}\xD7`)}`);
+      }
+      console.log("");
+    }
+    if (untried.length > 0) {
+      console.log(chalk.dim("  Worth exploring:"));
+      for (const c of untried) {
+        console.log(`    ${chalk.yellow("\u2192")} ${chalk.cyan(`ddt ${c}`)}`);
+      }
+      console.log("");
+    }
+    console.log(chalk.dim("  ddt features list \xB7 ddt explain <topic>\n"));
+  });
+  return cmd;
+}
+export {
+  discoverCommand
+};
+//# sourceMappingURL=discover-DEO2R5T6.js.map

package/dist/discover-DEO2R5T6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/discover.ts"],"sourcesContent":["import { rmSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { homedir } from 'node:os';\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { FeatureAdvisor, DDT_HINT_RULES } from '@ddt-tools/core/discovery';\n\nconst IMPORTANT_COMMANDS = [\n  'build',\n  'publish',\n  'compare',\n  'drift',\n  'lint',\n  'extract',\n  'safety',\n  'verify',\n  'validate',\n  'script',\n];\n\nexport function discoverCommand(): Command {\n  const cmd = new Command('discover');\n  cmd\n    .description('Show personalized feature suggestions based on your usage history.')\n    .option('--reset', 'Clear usage history and start fresh.')\n    .action((opts) => {\n      if (opts.reset as boolean) {\n        try {\n          rmSync(join(homedir(), '.ddt', 'discovery.json'), { force: true });\n        } catch {\n          /* ignore */\n        }\n        console.log(chalk.dim('  Discovery history cleared.'));\n        return;\n      }\n\n      const advisor = new FeatureAdvisor('ddt', DDT_HINT_RULES);\n      const stats = advisor.getUsageStats();\n      const total = Object.values(stats).reduce((a, b) => a + b, 0);\n\n      console.log('');\n      console.log(chalk.bold('  Feature Discovery') + chalk.dim(' — based on your usage history'));\n      console.log('');\n\n      if (total === 0) {\n        console.log(\n          chalk.dim(\n            '  No usage recorded yet. Run a few ddt commands to get personalized suggestions.\\n',\n          ),\n        );\n        console.log(chalk.dim('  Quick start:'));\n        console.log(`    ${chalk.cyan('ddt init')}             initialize a new project`);\n        console.log(`    ${chalk.cyan('ddt build')}            build a .ddtpac artifact`);\n        console.log(`    ${chalk.cyan('ddt compare')}          compare project vs. Unity Catalog`);\n        console.log('');\n        console.log(chalk.dim('  ddt features list · ddt explain <topic>'));\n        console.log('');\n        return;\n      }\n\n      const tried = IMPORTANT_COMMANDS.filter((c) => (stats[c] ?? 0) > 0);\n      const untried = IMPORTANT_COMMANDS.filter((c) => (stats[c] ?? 0) === 0);\n\n      if (tried.length > 0) {\n        console.log(chalk.dim('  Commands you use:'));\n        const sorted = [...tried].sort((a, b) => (stats[b] ?? 0) - (stats[a] ?? 0));\n        for (const c of sorted) {\n          console.log(`    ${chalk.green('✔')} ddt ${c.padEnd(14)} ${chalk.dim(`${stats[c]}×`)}`);\n        }\n        console.log('');\n      }\n\n      if (untried.length > 0) {\n        console.log(chalk.dim('  Worth exploring:'));\n        for (const c of untried) {\n          console.log(`    ${chalk.yellow('→')} ${chalk.cyan(`ddt ${c}`)}`);\n        }\n        console.log('');\n      }\n\n      console.log(chalk.dim('  ddt features list · ddt explain <topic>\\n'));\n    });\n  return cmd;\n}\n"],"mappings":";;;AAAA,SAAS,cAAc;AACvB,SAAS,YAAY;AACrB,SAAS,eAAe;AACxB,SAAS,eAAe;AACxB,OAAO,WAAW;AAClB,SAAS,gBAAgB,sBAAsB;AAE/C,IAAM,qBAAqB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,kBAA2B;AACzC,QAAM,MAAM,IAAI,QAAQ,UAAU;AAClC,MACG,YAAY,oEAAoE,EAChF,OAAO,WAAW,sCAAsC,EACxD,OAAO,CAAC,SAAS;AAChB,QAAI,KAAK,OAAkB;AACzB,UAAI;AACF,eAAO,KAAK,QAAQ,GAAG,QAAQ,gBAAgB,GAAG,EAAE,OAAO,KAAK,CAAC;AAAA,MACnE,QAAQ;AAAA,MAER;AACA,cAAQ,IAAI,MAAM,IAAI,8BAA8B,CAAC;AACrD;AAAA,IACF;AAEA,UAAM,UAAU,IAAI,eAAe,OAAO,cAAc;AACxD,UAAM,QAAQ,QAAQ,cAAc;AACpC,UAAM,QAAQ,OAAO,OAAO,KAAK,EAAE,OAAO,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC;AAE5D,YAAQ,IAAI,EAAE;AACd,YAAQ,IAAI,MAAM,KAAK,qBAAqB,IAAI,MAAM,IAAI,qCAAgC,CAAC;AAC3F,YAAQ,IAAI,EAAE;AAEd,QAAI,UAAU,GAAG;AACf,cAAQ;AAAA,QACN,MAAM;AAAA,UACJ;AAAA,QACF;AAAA,MACF;AACA,cAAQ,IAAI,MAAM,IAAI,gBAAgB,CAAC;AACvC,cAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC,uCAAuC;AAChF,cAAQ,IAAI,OAAO,MAAM,KAAK,WAAW,CAAC,sCAAsC;AAChF,cAAQ,IAAI,OAAO,MAAM,KAAK,aAAa,CAAC,6CAA6C;AACzF,cAAQ,IAAI,EAAE;AACd,cAAQ,IAAI,MAAM,IAAI,8CAA2C,CAAC;AAClE,cAAQ,IAAI,EAAE;AACd;AAAA,IACF;AAEA,UAAM,QAAQ,mBAAmB,OAAO,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,CAAC;AAClE,UAAM,UAAU,mBAAmB,OAAO,CAAC,OAAO,MAAM,CAAC,KAAK,OAAO,CAAC;AAEtE,QAAI,MAAM,SAAS,GAAG;AACpB,cAAQ,IAAI,MAAM,IAAI,qBAAqB,CAAC;AAC5C,YAAM,SAAS,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,GAAG,OAAO,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,KAAK,EAAE;AAC1E,iBAAW,KAAK,QAAQ;AACtB,gBAAQ,IAAI,OAAO,MAAM,MAAM,QAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,IAAI,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,MAAG,CAAC,EAAE;AAAA,MACxF;AACA,cAAQ,IAAI,EAAE;AAAA,IAChB;AAEA,QAAI,QAAQ,SAAS,GAAG;AACtB,cAAQ,IAAI,MAAM,IAAI,oBAAoB,CAAC;AAC3C,iBAAW,KAAK,SAAS;AACvB,gBAAQ,IAAI,OAAO,MAAM,OAAO,QAAG,CAAC,IAAI,MAAM,KAAK,OAAO,CAAC,EAAE,CAAC,EAAE;AAAA,MAClE;AACA,cAAQ,IAAI,EAAE;AAAA,IAChB;AAEA,YAAQ,IAAI,MAAM,IAAI,gDAA6C,CAAC;AAAA,EACtE,CAAC;AACH,SAAO;AACT;","names":[]}

package/dist/docs-QNY3MUVO.js

@@ -0,0 +1,183 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/docs.ts
+import { promises as fs } from "fs";
+import { execSync } from "child_process";
+import path from "path";
+import { Command } from "commander";
+import {
+  loadProject,
+  parseProjectModel,
+  renderDocsReport,
+  renderErdMarkdown,
+  renderErd3dHtml,
+  pac,
+  ai,
+  comments
+} from "@ddt-tools/core";
+import { buildDocsPublishPlan, renderDocsWorkflowYaml, searchDocs } from "@ddt-tools/core/docs";
+function docsCommand() {
+  const cmd = new Command("docs");
+  cmd.description("Generate HTML schema docs from a .ddtproj or .ddtpac.").requiredOption("--source <path>", ".ddtproj or .ddtpac to document.").option("-o, --out <path>", "Output HTML file path (omit when using --augment-comments).").option("--title <text>", "Page title.", "Schema docs").option(
+    "--augment-comments",
+    "Skip HTML rendering. Instead, call the configured AI provider to suggest comments for every empty COMMENT slot and emit COMMENT ON / ALTER COLUMN SQL.",
+    false
+  ).option(
+    "--augment-out <path>",
+    "When --augment-comments is set, write the script here. Default ./augment-comments.sql."
+  ).option(
+    "--augment-max-calls <n>",
+    "When --augment-comments is set, cap AI calls. Default unbounded.",
+    (v) => parseInt(v, 10)
+  ).option(
+    "--augment-max-length <n>",
+    "When --augment-comments is set, cap suggestion length in characters. Default 200.",
+    (v) => parseInt(v, 10)
+  ).action(
+    async (opts) => {
+      const model = await loadModel(String(opts.source));
+      if (opts.augmentComments) {
+        const targets = comments.findMissingComments(model);
+        if (targets.length === 0) {
+          console.log("No missing COMMENT slots found. Nothing to augment.");
+          return;
+        }
+        console.log(`Found ${targets.length} missing comment slot(s). Calling AI provider\u2026`);
+        const suggestions = await comments.augmentComments(targets, {
+          completeFn: async (prompt) => {
+            const r = await ai.complete([{ role: "user", content: prompt }], {
+              feature: "docs.augment-comments"
+            });
+            return r.text;
+          },
+          ...opts.augmentMaxLength ? { maxCommentLength: opts.augmentMaxLength } : {},
+          ...opts.augmentMaxCalls ? { maxCalls: opts.augmentMaxCalls } : {}
+        });
+        const sql = comments.renderAlterCommentScript(suggestions);
+        const accepted = suggestions.filter((s) => s.suggestion.trim().length > 0).length;
+        const uncertain = suggestions.length - accepted;
+        const outPath2 = opts.augmentOut ? path.resolve(String(opts.augmentOut)) : path.resolve("augment-comments.sql");
+        await fs.mkdir(path.dirname(outPath2), { recursive: true });
+        await fs.writeFile(outPath2, sql, "utf8");
+        console.log(
+          `Wrote ${outPath2} (${accepted} suggestion(s), ${uncertain} flagged for review).`
+        );
+        return;
+      }
+      if (!opts.out) {
+        throw new Error("Missing --out. Required unless --augment-comments is set.");
+      }
+      const html = renderDocsReport(model, { title: String(opts.title ?? "Schema docs") });
+      const outPath = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(outPath), { recursive: true });
+      await fs.writeFile(outPath, html, "utf8");
+      console.log(`Wrote ${outPath} (${html.length} bytes, ${model.length} objects).`);
+    }
+  );
+  cmd.command("build").description(
+    "Build the HTML schema docs site (alias for the parent command with --out default)."
+  ).requiredOption("--source <path>", ".ddtproj or .ddtpac to document.").option("-o, --out <path>", "Output HTML file path.", "dist/docs/index.html").option("--title <text>", "Page title.", "Schema docs").action(async (opts) => {
+    const model = await loadModel(String(opts.source));
+    const html = renderDocsReport(model, { title: String(opts.title ?? "Schema docs") });
+    const outPath = path.resolve(String(opts.out));
+    await fs.mkdir(path.dirname(outPath), { recursive: true });
+    await fs.writeFile(outPath, html, "utf8");
+    console.log(`Wrote ${outPath} (${html.length} bytes, ${model.length} objects).`);
+  });
+  cmd.command("publish").description("Publish the generated docs site to a gh-pages branch.").requiredOption("--site <path>", "Path to the built docs site directory (e.g. dist/docs).").option("--branch <name>", "Target branch name.", "gh-pages").option("--remote <name>", "Git remote name.", "origin").option("--message <text>", "Commit message.", "chore(docs): deploy schema docs [skip ci]").option("--dry-run", "Print the commands that would be executed without running them.", false).option("--emit-workflow <path>", "Write a GitHub Actions workflow YAML template to this path.").action(async (opts) => {
+    if (opts.emitWorkflow) {
+      const yaml = renderDocsWorkflowYaml({ branch: opts.branch, trigger: "main" });
+      const wPath = path.resolve(String(opts.emitWorkflow));
+      await fs.mkdir(path.dirname(wPath), { recursive: true });
+      await fs.writeFile(wPath, yaml, "utf8");
+      console.log(`Wrote workflow template \u2192 ${wPath}`);
+      return;
+    }
+    const plan = buildDocsPublishPlan({
+      siteDir: path.resolve(String(opts.site)),
+      branch: opts.branch,
+      remote: opts.remote,
+      message: opts.message
+    });
+    for (const step of plan.steps) {
+      console.log(`  ${step.description}`);
+      if (opts.dryRun) {
+        console.log(`    [dry-run] ${step.command}`);
+      } else {
+        execSync(step.command, { stdio: "inherit" });
+      }
+    }
+    if (!opts.dryRun) console.log(`Done \u2014 site pushed to ${plan.remote}/${plan.branch}.`);
+  });
+  cmd.command("search").description("Search object names, comments, and column names in a .ddtproj or .ddtpac.").argument("<query>", "Search query string.").requiredOption("--source <path>", ".ddtproj or .ddtpac to search.").option("-n, --max-results <n>", "Maximum number of results to return.", (v) => parseInt(v, 10)).action(async (query, opts) => {
+    const model = await loadModel(String(opts.source));
+    const hits = searchDocs(model, query, {
+      maxResults: opts.maxResults
+    });
+    if (hits.length === 0) {
+      console.log(`No results for "${query}".`);
+      return;
+    }
+    for (const hit of hits) {
+      console.log(`[${hit.score}] ${hit.objectFqn} (${hit.objectType}) \u2014 ${hit.field}`);
+      console.log(`    ${hit.snippet}`);
+    }
+    console.log(`
+${hits.length} result(s) for "${query}".`);
+  });
+  return cmd;
+}
+function erdCommand() {
+  const cmd = new Command("erd");
+  cmd.description(
+    "Generate an ER diagram (Mermaid Markdown or interactive 3D HTML) from a .ddtproj or .ddtpac."
+  ).requiredOption("--source <path>", ".ddtproj or .ddtpac to diagram.").requiredOption(
+    "-o, --out <path>",
+    "Output file path. Format inferred from extension (.md \u2192 mermaid, .html \u2192 html3d) unless --format is given."
+  ).option("--title <text>", "Diagram title.", "Schema ER diagram").option(
+    "--format <fmt>",
+    "Output format: mermaid | html3d. Default: inferred from --out extension, falling back to mermaid."
+  ).action(async (opts) => {
+    const model = await loadModel(String(opts.source));
+    const title = String(opts.title ?? "Schema ER diagram");
+    const fmt = resolveErdFormat(String(opts.out), opts.format);
+    let content;
+    if (fmt === "html3d") {
+      content = renderErd3dHtml(model, { title });
+    } else {
+      content = renderErdMarkdown(model, title);
+    }
+    const outPath = path.resolve(String(opts.out));
+    await fs.mkdir(path.dirname(outPath), { recursive: true });
+    await fs.writeFile(outPath, content, "utf8");
+    console.log(
+      `Wrote ${outPath} (${content.length} bytes, ${model.length} objects, format=${fmt}).`
+    );
+  });
+  return cmd;
+}
+function resolveErdFormat(outPath, explicit) {
+  if (explicit) {
+    const e = explicit.toLowerCase();
+    if (e === "mermaid" || e === "md") return "mermaid";
+    if (e === "html3d" || e === "3d" || e === "html") return "html3d";
+    throw new Error(`Unknown --format "${explicit}". Expected: mermaid | html3d.`);
+  }
+  const ext = outPath.toLowerCase();
+  if (ext.endsWith(".html") || ext.endsWith(".htm")) return "html3d";
+  return "mermaid";
+}
+async function loadModel(sourcePath) {
+  if (sourcePath.endsWith(".ddtpac")) {
+    const pacContents = await pac.readPac(sourcePath);
+    return pacContents.model;
+  }
+  const loaded = await loadProject(sourcePath);
+  const parsed = await parseProjectModel(loaded);
+  return parsed;
+}
+export {
+  docsCommand,
+  erdCommand
+};
+//# sourceMappingURL=docs-QNY3MUVO.js.map

package/dist/docs-QNY3MUVO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/docs.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport { execSync } from 'node:child_process';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport {\n  loadProject,\n  parseProjectModel,\n  renderDocsReport,\n  renderErdMarkdown,\n  renderErd3dHtml,\n  pac,\n  ai,\n  comments,\n  type DatabricksObject,\n} from '@ddt-tools/core';\nimport { buildDocsPublishPlan, renderDocsWorkflowYaml, searchDocs } from '@ddt-tools/core/docs';\n\n/**\n * `ddt docs` — auto-generate HTML schema docs from a `.ddtproj` or\n * `.ddtpac`. dbt-docs-style: catalog → schema → object navigation with\n * per-object detail panels.\n */\nexport function docsCommand(): Command {\n  const cmd = new Command('docs');\n  cmd\n    .description('Generate HTML schema docs from a .ddtproj or .ddtpac.')\n    .requiredOption('--source <path>', '.ddtproj or .ddtpac to document.')\n    .option('-o, --out <path>', 'Output HTML file path (omit when using --augment-comments).')\n    .option('--title <text>', 'Page title.', 'Schema docs')\n    .option(\n      '--augment-comments',\n      'Skip HTML rendering. Instead, call the configured AI provider to suggest comments for every empty COMMENT slot and emit COMMENT ON / ALTER COLUMN SQL.',\n      false,\n    )\n    .option(\n      '--augment-out <path>',\n      'When --augment-comments is set, write the script here. Default ./augment-comments.sql.',\n    )\n    .option(\n      '--augment-max-calls <n>',\n      'When --augment-comments is set, cap AI calls. Default unbounded.',\n      (v) => parseInt(v, 10),\n    )\n    .option(\n      '--augment-max-length <n>',\n      'When --augment-comments is set, cap suggestion length in characters. Default 200.',\n      (v) => parseInt(v, 10),\n    )\n    .action(\n      async (opts: {\n        source: string;\n        out?: string;\n        title?: string;\n        augmentComments?: boolean;\n        augmentOut?: string;\n        augmentMaxCalls?: number;\n        augmentMaxLength?: number;\n      }) => {\n        const model = await loadModel(String(opts.source));\n\n        if (opts.augmentComments) {\n          const targets = comments.findMissingComments(model);\n          if (targets.length === 0) {\n            console.log('No missing COMMENT slots found. Nothing to augment.');\n            return;\n          }\n          console.log(`Found ${targets.length} missing comment slot(s). Calling AI provider…`);\n          const suggestions = await comments.augmentComments(targets, {\n            completeFn: async (prompt: string) => {\n              const r = await ai.complete([{ role: 'user', content: prompt }], {\n                feature: 'docs.augment-comments',\n              });\n              return r.text;\n            },\n            ...(opts.augmentMaxLength ? { maxCommentLength: opts.augmentMaxLength } : {}),\n            ...(opts.augmentMaxCalls ? { maxCalls: opts.augmentMaxCalls } : {}),\n          });\n          const sql = comments.renderAlterCommentScript(suggestions);\n          const accepted = suggestions.filter((s) => s.suggestion.trim().length > 0).length;\n          const uncertain = suggestions.length - accepted;\n          const outPath = opts.augmentOut\n            ? path.resolve(String(opts.augmentOut))\n            : path.resolve('augment-comments.sql');\n          await fs.mkdir(path.dirname(outPath), { recursive: true });\n          await fs.writeFile(outPath, sql, 'utf8');\n          console.log(\n            `Wrote ${outPath} (${accepted} suggestion(s), ${uncertain} flagged for review).`,\n          );\n          return;\n        }\n\n        if (!opts.out) {\n          throw new Error('Missing --out. Required unless --augment-comments is set.');\n        }\n        const html = renderDocsReport(model, { title: String(opts.title ?? 'Schema docs') });\n        const outPath = path.resolve(String(opts.out));\n        await fs.mkdir(path.dirname(outPath), { recursive: true });\n        await fs.writeFile(outPath, html, 'utf8');\n        console.log(`Wrote ${outPath} (${html.length} bytes, ${model.length} objects).`);\n      },\n    );\n\n  cmd\n    .command('build')\n    .description(\n      'Build the HTML schema docs site (alias for the parent command with --out default).',\n    )\n    .requiredOption('--source <path>', '.ddtproj or .ddtpac to document.')\n    .option('-o, --out <path>', 'Output HTML file path.', 'dist/docs/index.html')\n    .option('--title <text>', 'Page title.', 'Schema docs')\n    .action(async (opts: { source: string; out: string; title?: string }) => {\n      const model = await loadModel(String(opts.source));\n      const html = renderDocsReport(model, { title: String(opts.title ?? 'Schema docs') });\n      const outPath = path.resolve(String(opts.out));\n      await fs.mkdir(path.dirname(outPath), { recursive: true });\n      await fs.writeFile(outPath, html, 'utf8');\n      console.log(`Wrote ${outPath} (${html.length} bytes, ${model.length} objects).`);\n    });\n\n  cmd\n    .command('publish')\n    .description('Publish the generated docs site to a gh-pages branch.')\n    .requiredOption('--site <path>', 'Path to the built docs site directory (e.g. dist/docs).')\n    .option('--branch <name>', 'Target branch name.', 'gh-pages')\n    .option('--remote <name>', 'Git remote name.', 'origin')\n    .option('--message <text>', 'Commit message.', 'chore(docs): deploy schema docs [skip ci]')\n    .option('--dry-run', 'Print the commands that would be executed without running them.', false)\n    .option('--emit-workflow <path>', 'Write a GitHub Actions workflow YAML template to this path.')\n    .action(async (opts) => {\n      if (opts.emitWorkflow) {\n        const yaml = renderDocsWorkflowYaml({ branch: opts.branch, trigger: 'main' });\n        const wPath = path.resolve(String(opts.emitWorkflow));\n        await fs.mkdir(path.dirname(wPath), { recursive: true });\n        await fs.writeFile(wPath, yaml, 'utf8');\n        console.log(`Wrote workflow template → ${wPath}`);\n        return;\n      }\n      const plan = buildDocsPublishPlan({\n        siteDir: path.resolve(String(opts.site)),\n        branch: opts.branch,\n        remote: opts.remote,\n        message: opts.message,\n      });\n      for (const step of plan.steps) {\n        console.log(`  ${step.description}`);\n        if (opts.dryRun) {\n          console.log(`    [dry-run] ${step.command}`);\n        } else {\n          execSync(step.command, { stdio: 'inherit' });\n        }\n      }\n      if (!opts.dryRun) console.log(`Done — site pushed to ${plan.remote}/${plan.branch}.`);\n    });\n\n  cmd\n    .command('search')\n    .description('Search object names, comments, and column names in a .ddtproj or .ddtpac.')\n    .argument('<query>', 'Search query string.')\n    .requiredOption('--source <path>', '.ddtproj or .ddtpac to search.')\n    .option('-n, --max-results <n>', 'Maximum number of results to return.', (v) => parseInt(v, 10))\n    .action(async (query: string, opts: { source: string; maxResults?: number }) => {\n      const model = await loadModel(String(opts.source));\n      const hits = searchDocs(model as Parameters<typeof searchDocs>[0], query, {\n        maxResults: opts.maxResults,\n      });\n      if (hits.length === 0) {\n        console.log(`No results for \"${query}\".`);\n        return;\n      }\n      for (const hit of hits) {\n        console.log(`[${hit.score}] ${hit.objectFqn} (${hit.objectType}) — ${hit.field}`);\n        console.log(`    ${hit.snippet}`);\n      }\n      console.log(`\\n${hits.length} result(s) for \"${query}\".`);\n    });\n\n  return cmd;\n}\n\n/**\n * `ddt erd` — auto-generate an ER diagram from a `.ddtproj` or `.ddtpac`.\n *\n * Output format defaults to Mermaid Markdown for back-compat. Pass\n * `--format html3d` (or write to a `.html` file) to emit the interactive\n * 3D WebGL viewer — a single self-contained HTML file you can open in\n * any browser. The 3D viewer lays out schemas as horizontal planes with\n * tables as boxes and FKs as bezier curves; supports click-to-focus,\n * search, 2D toggle, and full orbit/pan/zoom. See DIAG-1 spec.\n */\nexport function erdCommand(): Command {\n  const cmd = new Command('erd');\n  cmd\n    .description(\n      'Generate an ER diagram (Mermaid Markdown or interactive 3D HTML) from a .ddtproj or .ddtpac.',\n    )\n    .requiredOption('--source <path>', '.ddtproj or .ddtpac to diagram.')\n    .requiredOption(\n      '-o, --out <path>',\n      'Output file path. Format inferred from extension (.md → mermaid, .html → html3d) unless --format is given.',\n    )\n    .option('--title <text>', 'Diagram title.', 'Schema ER diagram')\n    .option(\n      '--format <fmt>',\n      'Output format: mermaid | html3d. Default: inferred from --out extension, falling back to mermaid.',\n    )\n    .action(async (opts: { source: string; out: string; title?: string; format?: string }) => {\n      const model = await loadModel(String(opts.source));\n      const title = String(opts.title ?? 'Schema ER diagram');\n      const fmt = resolveErdFormat(String(opts.out), opts.format);\n      let content: string;\n      if (fmt === 'html3d') {\n        content = renderErd3dHtml(model, { title });\n      } else {\n        content = renderErdMarkdown(model, title);\n      }\n      const outPath = path.resolve(String(opts.out));\n      await fs.mkdir(path.dirname(outPath), { recursive: true });\n      await fs.writeFile(outPath, content, 'utf8');\n      console.log(\n        `Wrote ${outPath} (${content.length} bytes, ${model.length} objects, format=${fmt}).`,\n      );\n    });\n  return cmd;\n}\n\nfunction resolveErdFormat(outPath: string, explicit?: string): 'mermaid' | 'html3d' {\n  if (explicit) {\n    const e = explicit.toLowerCase();\n    if (e === 'mermaid' || e === 'md') return 'mermaid';\n    if (e === 'html3d' || e === '3d' || e === 'html') return 'html3d';\n    throw new Error(`Unknown --format \"${explicit}\". Expected: mermaid | html3d.`);\n  }\n  const ext = outPath.toLowerCase();\n  if (ext.endsWith('.html') || ext.endsWith('.htm')) return 'html3d';\n  return 'mermaid';\n}\n\nasync function loadModel(sourcePath: string): Promise<DatabricksObject[]> {\n  if (sourcePath.endsWith('.ddtpac')) {\n    const pacContents = await pac.readPac(sourcePath);\n    return pacContents.model;\n  }\n  const loaded = await loadProject(sourcePath);\n  const parsed = await parseProjectModel(loaded);\n  return parsed as DatabricksObject[];\n}\n"],"mappings":"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","names":["outPath"]}