@ddt-tools/cli 0.2.0 → 0.2.4

package/dist/chunk-XFXG347C.js

@@ -0,0 +1,40 @@
+// src/util/ai-explain.ts
+import { ai } from "@ddt-tools/core";
+var DEFAULT_SYSTEM_PROMPT = `You are a senior Databricks data engineer reviewing structured output from the DDT CLI. Narrate it for a teammate who has not seen the underlying SQL. Be concrete and specific \u2014 reference identifiers by name. Group related items together. Skip information that is already obvious from the structured output; add the missing intent, risks, and follow-up actions. 4-10 sentences total unless the data warrants more.`;
+function attachExplainFlag(cmd, description) {
+  const hasExplain = cmd.options.some((o) => o.long === "--explain" || o.long === "--ai-explain");
+  if (hasExplain) return cmd;
+  cmd.option(
+    "--explain",
+    description ?? "After the structured output, call the configured AI provider to narrate the result in plain English. Requires `ddt ai` to be configured.",
+    false
+  );
+  return cmd;
+}
+async function runExplain(ctx, opts, buildPrompt) {
+  if (!opts.explain) return;
+  const system = ctx.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
+  console.log("");
+  console.log("AI explanation:");
+  try {
+    const reply = await ai.complete(
+      [
+        { role: "system", content: system },
+        { role: "user", content: buildPrompt() }
+      ],
+      { feature: ctx.feature }
+    );
+    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)."
+    );
+  }
+}
+
+export {
+  attachExplainFlag,
+  runExplain
+};
+//# sourceMappingURL=chunk-XFXG347C.js.map

package/dist/chunk-XFXG347C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util/ai-explain.ts"],"sourcesContent":["/**\n * `--explain` flag helper — shared across every command that produces a\n * structured report (compare, diagnose, review, impact, cost-estimate,\n * lineage, lint, pr-comment, test, …).\n *\n * Each consumer calls `attachExplainFlag(cmd, { feature, systemPrompt })`\n * during command construction, then awaits `runExplain(buildPrompt, opts)`\n * after the structured output has been printed. The helper:\n *\n *   - declares the `--explain` (alias `--ai-explain`) flag,\n *   - reads the configured AI provider via `@ddt-tools/core/ai`,\n *   - calls `complete()` with a stable system prompt + the consumer's\n *     prompt body,\n *   - prints the narration to stdout under an \"AI explanation:\" header,\n *   - gracefully degrades when no provider is configured (a friendly\n *     hint pointing at `ddt ai status` is printed; non-zero exit code is\n *     NOT set — `--explain` is best-effort decoration on top of the\n *     structured output).\n *\n * Mirrors `Snowflake/packages/cli/src/util/ai-explain.ts`.\n */\nimport type { Command } from 'commander';\nimport { ai } from '@ddt-tools/core';\n\nexport interface ExplainContext {\n  feature: string;\n  systemPrompt?: string;\n}\n\nconst DEFAULT_SYSTEM_PROMPT = `You are a senior Databricks data engineer reviewing structured output from the DDT CLI. Narrate it for a teammate who has not seen the underlying SQL. Be concrete and specific — reference identifiers by name. Group related items together. Skip information that is already obvious from the structured output; add the missing intent, risks, and follow-up actions. 4-10 sentences total unless the data warrants more.`;\n\nexport function attachExplainFlag(cmd: Command, description?: string): Command {\n  const hasExplain = cmd.options.some((o) => o.long === '--explain' || o.long === '--ai-explain');\n  if (hasExplain) return cmd;\n  cmd.option(\n    '--explain',\n    description ??\n      'After the structured output, call the configured AI provider to narrate the result in plain English. Requires `ddt ai` to be configured.',\n    false,\n  );\n  return cmd;\n}\n\nexport async function runExplain(\n  ctx: ExplainContext,\n  opts: { explain?: boolean },\n  buildPrompt: () => string,\n): Promise<void> {\n  if (!opts.explain) return;\n  const system = ctx.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;\n  console.log('');\n  console.log('AI explanation:');\n  try {\n    const reply = await ai.complete(\n      [\n        { role: 'system', content: system },\n        { role: 'user', content: buildPrompt() },\n      ],\n      { feature: ctx.feature },\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"],"mappings":";AAsBA,SAAS,UAAU;AAOnB,IAAM,wBAAwB;AAEvB,SAAS,kBAAkB,KAAc,aAA+B;AAC7E,QAAM,aAAa,IAAI,QAAQ,KAAK,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,SAAS,cAAc;AAC9F,MAAI,WAAY,QAAO;AACvB,MAAI;AAAA,IACF;AAAA,IACA,eACE;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAsB,WACpB,KACA,MACA,aACe;AACf,MAAI,CAAC,KAAK,QAAS;AACnB,QAAM,SAAS,IAAI,gBAAgB;AACnC,UAAQ,IAAI,EAAE;AACd,UAAQ,IAAI,iBAAiB;AAC7B,MAAI;AACF,UAAM,QAAQ,MAAM,GAAG;AAAA,MACrB;AAAA,QACE,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,QAClC,EAAE,MAAM,QAAQ,SAAS,YAAY,EAAE;AAAA,MACzC;AAAA,MACA,EAAE,SAAS,IAAI,QAAQ;AAAA,IACzB;AACA,eAAW,QAAQ,MAAM,KAAK,MAAM,IAAI,EAAG,SAAQ,IAAI,OAAO,IAAI;AAAA,EACpE,SAAS,KAAK;AACZ,YAAQ,MAAM,0BAA0B,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,EAAE;AACzF,YAAQ;AAAA,MACN;AAAA,IACF;AAAA,EACF;AACF;","names":[]}