@sdt-tools/cli 0.2.0 → 0.2.6

package/dist/build-VNIQFKSP.js

@@ -0,0 +1,23 @@
+import {
+  logger
+} from "./chunk-VM2H4LAO.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/build.ts
+import { Command } from "commander";
+import { buildProject } from "@sdt-tools/core/pac";
+function buildCommand() {
+  const cmd = new Command("build");
+  cmd.description("Build a .sdtpac from a .sdtproj project.").requiredOption("-p, --project <path>", "Path to the .sdtproj file").option("-o, --out <path>", "Output .sdtpac path (default: <projectRoot>/bin/<name>.sdtpac)").action(async (opts) => {
+    const result = await buildProject(String(opts.project), {
+      outputPath: opts.out ? String(opts.out) : void 0
+    });
+    logger.success(`Built ${result.outputPath}`);
+    logger.dim(`  ${result.fileCount} source file(s), ${result.objectCount} object(s) in model`);
+  });
+  return cmd;
+}
+export {
+  buildCommand
+};
+//# sourceMappingURL=build-VNIQFKSP.js.map

package/dist/build-VNIQFKSP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/build.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { buildProject } from '@sdt-tools/core/pac';\nimport { logger } from '../util/logger.js';\n\nexport function buildCommand(): Command {\n  const cmd = new Command('build');\n  cmd\n    .description('Build a .sdtpac from a .sdtproj project.')\n    .requiredOption('-p, --project <path>', 'Path to the .sdtproj file')\n    .option('-o, --out <path>', 'Output .sdtpac path (default: <projectRoot>/bin/<name>.sdtpac)')\n    .action(async (opts) => {\n      const result = await buildProject(String(opts.project), {\n        outputPath: opts.out ? String(opts.out) : undefined,\n      });\n      logger.success(`Built ${result.outputPath}`);\n      logger.dim(`  ${result.fileCount} source file(s), ${result.objectCount} object(s) in model`);\n    });\n  return cmd;\n}\n"],"mappings":";;;;;;AAAA,SAAS,eAAe;AACxB,SAAS,oBAAoB;AAGtB,SAAS,eAAwB;AACtC,QAAM,MAAM,IAAI,QAAQ,OAAO;AAC/B,MACG,YAAY,0CAA0C,EACtD,eAAe,wBAAwB,2BAA2B,EAClE,OAAO,oBAAoB,gEAAgE,EAC3F,OAAO,OAAO,SAAS;AACtB,UAAM,SAAS,MAAM,aAAa,OAAO,KAAK,OAAO,GAAG;AAAA,MACtD,YAAY,KAAK,MAAM,OAAO,KAAK,GAAG,IAAI;AAAA,IAC5C,CAAC;AACD,WAAO,QAAQ,SAAS,OAAO,UAAU,EAAE;AAC3C,WAAO,IAAI,KAAK,OAAO,SAAS,oBAAoB,OAAO,WAAW,qBAAqB;AAAA,EAC7F,CAAC;AACH,SAAO;AACT;","names":[]}

package/dist/catalog-JLB5VCEV.js

@@ -0,0 +1,137 @@
+import {
+  logger
+} from "./chunk-VM2H4LAO.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/catalog.ts
+import { Command } from "commander";
+import { catalog } from "@sdt-tools/core";
+import { getProfile, SnowflakeConnection } from "@sdt-tools/core/connection";
+var BUILTIN_DATABASES = /* @__PURE__ */ new Set(["SNOWFLAKE", "SNOWFLAKE_SAMPLE_DATA", "UTIL_DB"]);
+function catalogCommand() {
+  const cmd = new Command("catalog");
+  cmd.description(
+    "Manage the per-connection catalog cache used by the Object Explorer + EE2 intellisense."
+  );
+  cmd.command("refresh").description("Open the connection, scan every (non-builtin) database, write the catalog cache.").requiredOption("-c, --connection <name>", "Connection profile name.").option("--root <path>", "Project root. Default cwd.", process.cwd()).option("--databases <csv>", "Comma-separated list. Default: every non-builtin database.").option("--include-builtins", "Include SNOWFLAKE / SNOWFLAKE_SAMPLE_DATA / UTIL_DB.", false).option(
+    "--concurrency <n>",
+    "Bounded-concurrency cap for the bulk-scan pool. Default 10.",
+    "10"
+  ).option("--no-fingerprint-skip", "Force a full scan even when fingerprints are unchanged.").action(async (opts) => {
+    const profile = await getProfile(String(opts.connection));
+    const conn = new SnowflakeConnection(profile);
+    const cache = new catalog.CatalogCache({
+      root: String(opts.root),
+      connection: profile.name
+    });
+    logger.step(`Connecting to ${profile.account} as ${profile.auth.username}\u2026`);
+    await conn.connect();
+    try {
+      const dbs = await resolveDatabases(conn, opts);
+      if (dbs.length === 0) {
+        logger.warn("No databases to scan. Pass --databases or --include-builtins.");
+        return;
+      }
+      logger.dim(
+        `Scanning ${dbs.length} database(s) with concurrency ${Number(opts.concurrency)}.`
+      );
+      const cached = await cache.get();
+      const cachedByDb = new Map(cached.databases.map((d) => [d.database, d]));
+      const concurrency = Math.max(1, Number(opts.concurrency) || 10);
+      const fingerprintSkip = opts.fingerprintSkip !== false;
+      const { results, errors } = await catalog.mapPool(
+        dbs,
+        async (db) => {
+          let freshFingerprint = null;
+          try {
+            const fpRes = await conn.query(
+              catalog.fingerprintSqlForDatabase(db)
+            );
+            freshFingerprint = catalog.parseFingerprintRow(fpRes.rows);
+          } catch (err) {
+            logger.warn(
+              `fingerprint(${db}) failed; falling through to full scan: ${err.message}`
+            );
+          }
+          const cachedDb = cachedByDb.get(db);
+          if (fingerprintSkip && cachedDb && cachedDb.fingerprint != null && freshFingerprint != null && catalog.isFresh(cachedDb.fingerprint, freshFingerprint)) {
+            logger.dim(`  ${db}: fresh; reusing cache`);
+            return { database: db, fingerprint: cachedDb.fingerprint, schemas: cachedDb.schemas };
+          }
+          const scanRes = await conn.query(catalog.bulkScanSqlForDatabase(db));
+          const schemas = catalog.parseBulkScanRows(db, scanRes.rows);
+          const fingerprint = freshFingerprint ?? null;
+          logger.dim(
+            `  ${db}: ${schemas.length} schemas / ${schemas.reduce((sum, s) => sum + s.objects.length, 0)} objects`
+          );
+          return { database: db, fingerprint, schemas };
+        },
+        { concurrency }
+      );
+      for (const e of errors) {
+        logger.warn(`scan failed for "${dbs[e.index]}": ${e.error.message}`);
+      }
+      const snapshot = catalog.refreshFingerprints({
+        version: catalog.CATALOG_SNAPSHOT_VERSION,
+        connection: profile.name,
+        snapshotAt: (/* @__PURE__ */ new Date()).toISOString(),
+        fingerprint: null,
+        databases: results.filter((r) => !!r)
+      });
+      await cache.set(snapshot);
+      logger.success(`Wrote ${snapshot.databases.length} databases to ${cache.path}`);
+    } finally {
+      await conn.disconnect();
+    }
+  });
+  cmd.command("show").description("Pretty-print or JSON-dump the cached snapshot for a connection.").requiredOption("-c, --connection <name>", "Connection profile name.").option("--root <path>", "Project root. Default cwd.", process.cwd()).option("--json", "Emit JSON instead of summary.").action(async (opts) => {
+    const cache = new catalog.CatalogCache({
+      root: String(opts.root),
+      connection: String(opts.connection)
+    });
+    const snapshot = await cache.get();
+    if (opts.json) {
+      console.log(JSON.stringify(snapshot, null, 2));
+      return;
+    }
+    if (snapshot.databases.length === 0) {
+      logger.warn(`Catalog cache is empty for "${opts.connection}".`);
+      logger.dim(`  Cache file: ${cache.path}`);
+      logger.dim(`  Run \`sdt catalog refresh --connection ${opts.connection}\` to populate.`);
+      return;
+    }
+    logger.success(`Snapshot for "${snapshot.connection}" \u2014 ${snapshot.snapshotAt}`);
+    logger.dim(
+      `  Top-level fingerprint: ${snapshot.fingerprint != null ? new Date(snapshot.fingerprint).toISOString() : "(none)"}`
+    );
+    for (const db of snapshot.databases) {
+      const objCount = db.schemas.reduce((sum, s) => sum + s.objects.length, 0);
+      console.log(
+        `  ${db.database.padEnd(32)}  ${db.schemas.length} schemas / ${objCount} objects`
+      );
+    }
+  });
+  cmd.command("clear").description("Delete the cached snapshot for a connection.").requiredOption("-c, --connection <name>", "Connection profile name.").option("--root <path>", "Project root. Default cwd.", process.cwd()).action(async (opts) => {
+    const cache = new catalog.CatalogCache({
+      root: String(opts.root),
+      connection: String(opts.connection)
+    });
+    await cache.clear();
+    logger.success(`Cleared cache for "${opts.connection}".`);
+    logger.dim(`  was: ${cache.path}`);
+  });
+  return cmd;
+}
+async function resolveDatabases(conn, opts) {
+  if (opts.databases) {
+    return String(opts.databases).split(",").map((s) => s.trim()).filter(Boolean);
+  }
+  const res = await conn.query("SHOW DATABASES");
+  const names = res.rows.map((r) => String(r.name ?? r.NAME ?? "")).filter(Boolean);
+  if (opts.includeBuiltins) return names;
+  return names.filter((n) => !BUILTIN_DATABASES.has(n.toUpperCase()));
+}
+export {
+  catalogCommand
+};
+//# sourceMappingURL=catalog-JLB5VCEV.js.map

package/dist/catalog-JLB5VCEV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/catalog.ts"],"sourcesContent":["/**\n * `sdt catalog` — manage the per-connection catalog cache (EE1 substrate).\n *\n *   sdt catalog refresh --connection <name> [--databases <csv>] [--concurrency <n>]\n *   sdt catalog show    --connection <name> [--json]\n *   sdt catalog clear   --connection <name>\n *\n * `refresh` opens a live Snowflake connection, discovers databases via\n * `SHOW DATABASES`, runs the bulk-scan SQL per database via the bounded\n * promise pool, and writes the assembled snapshot to\n * `<root>/.sdt/cache/<conn>/catalog.msgpack` (RES.1 — was `catalog.json`\n * before 2026-05-16; the cache reader still accepts the legacy form for\n * one major version). Schema fingerprints (`MAX(LAST_ALTERED)`) are\n * checked first; databases that haven't changed since the last refresh\n * are skipped.\n *\n * `show` reads the cache file and pretty-prints (or emits JSON).\n * `clear` deletes the cache file (and its parent dir if empty).\n *\n * Object Explorer (`sdt explorer`) and the eventual EE2 intellisense\n * provider both consume this cache.\n */\nimport { Command } from 'commander';\nimport { catalog } from '@sdt-tools/core';\nimport { getProfile, SnowflakeConnection } from '@sdt-tools/core/connection';\nimport { logger } from '../util/logger.js';\n\n/**\n * Built-in databases that almost no one wants in their cache. Pass\n * `--include-builtins` to keep them.\n */\nconst BUILTIN_DATABASES = new Set(['SNOWFLAKE', 'SNOWFLAKE_SAMPLE_DATA', 'UTIL_DB']);\n\ninterface ShowDatabasesRow {\n  name?: string;\n  NAME?: string;\n}\n\nexport function catalogCommand(): Command {\n  const cmd = new Command('catalog');\n  cmd.description(\n    'Manage the per-connection catalog cache used by the Object Explorer + EE2 intellisense.',\n  );\n\n  cmd\n    .command('refresh')\n    .description('Open the connection, scan every (non-builtin) database, write the catalog cache.')\n    .requiredOption('-c, --connection <name>', 'Connection profile name.')\n    .option('--root <path>', 'Project root. Default cwd.', process.cwd())\n    .option('--databases <csv>', 'Comma-separated list. Default: every non-builtin database.')\n    .option('--include-builtins', 'Include SNOWFLAKE / SNOWFLAKE_SAMPLE_DATA / UTIL_DB.', false)\n    .option(\n      '--concurrency <n>',\n      'Bounded-concurrency cap for the bulk-scan pool. Default 10.',\n      '10',\n    )\n    .option('--no-fingerprint-skip', 'Force a full scan even when fingerprints are unchanged.')\n    .action(async (opts) => {\n      const profile = await getProfile(String(opts.connection));\n      const conn = new SnowflakeConnection(profile);\n      const cache = new catalog.CatalogCache({\n        root: String(opts.root),\n        connection: profile.name,\n      });\n\n      logger.step(`Connecting to ${profile.account} as ${profile.auth.username}…`);\n      await conn.connect();\n      try {\n        const dbs = await resolveDatabases(conn, opts);\n        if (dbs.length === 0) {\n          logger.warn('No databases to scan. Pass --databases or --include-builtins.');\n          return;\n        }\n        logger.dim(\n          `Scanning ${dbs.length} database(s) with concurrency ${Number(opts.concurrency)}.`,\n        );\n\n        const cached = await cache.get();\n        const cachedByDb = new Map(cached.databases.map((d) => [d.database, d] as const));\n\n        const concurrency = Math.max(1, Number(opts.concurrency) || 10);\n        const fingerprintSkip = opts.fingerprintSkip !== false;\n\n        const { results, errors } = await catalog.mapPool(\n          dbs,\n          async (db) => {\n            // Cheap fingerprint probe first.\n            let freshFingerprint: number | null = null;\n            try {\n              const fpRes = await conn.query<{ MAX_LAST_ALTERED: unknown }>(\n                catalog.fingerprintSqlForDatabase(db),\n              );\n              freshFingerprint = catalog.parseFingerprintRow(fpRes.rows);\n            } catch (err) {\n              logger.warn(\n                `fingerprint(${db}) failed; falling through to full scan: ${(err as Error).message}`,\n              );\n            }\n\n            const cachedDb = cachedByDb.get(db);\n            if (\n              fingerprintSkip &&\n              cachedDb &&\n              cachedDb.fingerprint != null &&\n              freshFingerprint != null &&\n              catalog.isFresh(cachedDb.fingerprint, freshFingerprint)\n            ) {\n              logger.dim(`  ${db}: fresh; reusing cache`);\n              return { database: db, fingerprint: cachedDb.fingerprint, schemas: cachedDb.schemas };\n            }\n\n            const scanRes = await conn.query(catalog.bulkScanSqlForDatabase(db));\n            const schemas = catalog.parseBulkScanRows(db, scanRes.rows);\n            const fingerprint = freshFingerprint ?? null;\n            logger.dim(\n              `  ${db}: ${schemas.length} schemas / ${schemas.reduce((sum, s) => sum + s.objects.length, 0)} objects`,\n            );\n            return { database: db, fingerprint, schemas };\n          },\n          { concurrency },\n        );\n\n        for (const e of errors) {\n          logger.warn(`scan failed for \"${dbs[e.index]}\": ${(e.error as Error).message}`);\n        }\n\n        const snapshot = catalog.refreshFingerprints({\n          version: catalog.CATALOG_SNAPSHOT_VERSION,\n          connection: profile.name,\n          snapshotAt: new Date().toISOString(),\n          fingerprint: null,\n          databases: results.filter((r): r is NonNullable<typeof r> => !!r),\n        });\n        await cache.set(snapshot);\n\n        logger.success(`Wrote ${snapshot.databases.length} databases to ${cache.path}`);\n      } finally {\n        await conn.disconnect();\n      }\n    });\n\n  cmd\n    .command('show')\n    .description('Pretty-print or JSON-dump the cached snapshot for a connection.')\n    .requiredOption('-c, --connection <name>', 'Connection profile name.')\n    .option('--root <path>', 'Project root. Default cwd.', process.cwd())\n    .option('--json', 'Emit JSON instead of summary.')\n    .action(async (opts) => {\n      const cache = new catalog.CatalogCache({\n        root: String(opts.root),\n        connection: String(opts.connection),\n      });\n      const snapshot = await cache.get();\n      if (opts.json) {\n        console.log(JSON.stringify(snapshot, null, 2));\n        return;\n      }\n      if (snapshot.databases.length === 0) {\n        logger.warn(`Catalog cache is empty for \"${opts.connection}\".`);\n        logger.dim(`  Cache file: ${cache.path}`);\n        logger.dim(`  Run \\`sdt catalog refresh --connection ${opts.connection}\\` to populate.`);\n        return;\n      }\n      logger.success(`Snapshot for \"${snapshot.connection}\" — ${snapshot.snapshotAt}`);\n      logger.dim(\n        `  Top-level fingerprint: ${snapshot.fingerprint != null ? new Date(snapshot.fingerprint).toISOString() : '(none)'}`,\n      );\n      for (const db of snapshot.databases) {\n        const objCount = db.schemas.reduce((sum, s) => sum + s.objects.length, 0);\n        console.log(\n          `  ${db.database.padEnd(32)}  ${db.schemas.length} schemas / ${objCount} objects`,\n        );\n      }\n    });\n\n  cmd\n    .command('clear')\n    .description('Delete the cached snapshot for a connection.')\n    .requiredOption('-c, --connection <name>', 'Connection profile name.')\n    .option('--root <path>', 'Project root. Default cwd.', process.cwd())\n    .action(async (opts) => {\n      const cache = new catalog.CatalogCache({\n        root: String(opts.root),\n        connection: String(opts.connection),\n      });\n      await cache.clear();\n      logger.success(`Cleared cache for \"${opts.connection}\".`);\n      logger.dim(`  was: ${cache.path}`);\n    });\n\n  return cmd;\n}\n\nasync function resolveDatabases(\n  conn: SnowflakeConnection,\n  opts: { databases?: unknown; includeBuiltins?: unknown },\n): Promise<string[]> {\n  if (opts.databases) {\n    return String(opts.databases)\n      .split(',')\n      .map((s) => s.trim())\n      .filter(Boolean);\n  }\n  const res = await conn.query<ShowDatabasesRow>('SHOW DATABASES');\n  const names = res.rows.map((r) => String(r.name ?? r.NAME ?? '')).filter(Boolean);\n  if (opts.includeBuiltins) return names;\n  return names.filter((n) => !BUILTIN_DATABASES.has(n.toUpperCase()));\n}\n"],"mappings":"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","names":[]}

package/dist/changelog-M7XGDYSY.js

@@ -0,0 +1,220 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/changelog.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { Command } from "commander";
+var execFileP = promisify(execFile);
+var CATEGORY_ORDER = [
+  { type: "feat", heading: "\u2728 Features" },
+  { type: "fix", heading: "\u{1F41B} Bug fixes" },
+  { type: "perf", heading: "\u26A1 Performance" },
+  { type: "refactor", heading: "\u267B\uFE0F Refactoring" },
+  { type: "docs", heading: "\u{1F4DA} Documentation" },
+  { type: "test", heading: "\u{1F9EA} Tests" },
+  { type: "build", heading: "\u{1F527} Build / CI" },
+  { type: "ci", heading: "\u{1F527} Build / CI" },
+  { type: "chore", heading: "\u{1F9F9} Chores" },
+  { type: "style", heading: "\u{1F3A8} Style" }
+];
+function changelogCommand() {
+  const cmd = new Command("changelog");
+  cmd.description(
+    "Generate a Markdown CHANGELOG section from git commits between two refs (Conventional Commits parser)."
+  ).option("--from <ref>", "Starting git ref (exclusive). Default: previous tag.", "").option("--to <ref>", "Ending git ref (inclusive). Default: HEAD.", "HEAD").option("--repo <path>", "Path to the git repository. Default: current directory.", ".").option("--version <name>", "Version heading for the section. Default: --to ref.").option(
+    "--scope <pathspec>",
+    "Restrict to commits touching paths matching this git-pathspec (e.g. `Snowflake/packages/cli/**`). Default: all paths."
+  ).option("-o, --out <path>", "Append/write to file. Default: stdout.").option(
+    "--append",
+    "When --out is set, prepend to existing file (typical changelog behavior).",
+    false
+  ).option(
+    "--manifest-dir <path>",
+    'Directory containing deploy manifests (default: .sdt/history). When set, the changelog appends a "\u{1F680} Deploys" addendum: one row per manifest with step-status counts + safety summary. Manifest reads are best-effort \u2014 corrupt files are skipped silently.'
+  ).action(async (opts) => {
+    const repo = path.resolve(String(opts.repo));
+    const to = String(opts.to);
+    let from = String(opts.from);
+    if (!from) {
+      from = await previousTag(repo, to);
+    }
+    const commits = await collectCommits(
+      repo,
+      from,
+      to,
+      opts.scope ? String(opts.scope) : void 0
+    );
+    const grouped = groupByType(commits);
+    const version = String(opts.version ?? to);
+    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const manifestDir = opts.manifestDir ? path.resolve(String(opts.manifestDir)) : path.join(repo, ".sdt", "history");
+    const deploys = await readDeploySummaries(manifestDir);
+    const md = renderMarkdown(version, today, from, to, grouped, deploys);
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      let body = md;
+      if (opts.append) {
+        try {
+          const existing = await fs.readFile(out, "utf8");
+          body = `${md}
+${existing}`;
+        } catch {
+        }
+      }
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, body, "utf8");
+      console.error(`Wrote ${out} (${commits.length} commit(s)).`);
+    } else {
+      process.stdout.write(md);
+    }
+  });
+  return cmd;
+}
+async function previousTag(repo, ref) {
+  try {
+    const { stdout } = await execFileP("git", ["describe", "--tags", "--abbrev=0", `${ref}^`], {
+      cwd: repo
+    });
+    return stdout.trim();
+  } catch {
+    const { stdout } = await execFileP("git", ["rev-list", "--max-parents=0", "HEAD"], {
+      cwd: repo
+    });
+    return stdout.trim().split("\n")[0] ?? "";
+  }
+}
+async function collectCommits(repo, from, to, scope) {
+  const range = from ? `${from}..${to}` : to;
+  const args = ["log", "--no-merges", "--pretty=format:%H%x01%s", range];
+  if (scope) {
+    args.push("--", scope);
+  }
+  const { stdout } = await execFileP("git", args, {
+    cwd: repo,
+    maxBuffer: 64 * 1024 * 1024
+  });
+  const lines = stdout.split("\n").filter(Boolean);
+  return lines.map((line) => {
+    const [sha, subject] = line.split("
");
+    return parseCommit(sha, subject);
+  });
+}
+function parseCommit(sha, subject) {
+  const m = subject.match(/^([a-z]+)(\(([^)]+)\))?(!)?:\s*(.+)$/i);
+  if (!m) {
+    return { sha, type: "chore", scope: void 0, subject, isBreaking: false };
+  }
+  const type = m[1].toLowerCase();
+  const scope = m[3];
+  const isBreaking = !!m[4];
+  const text = m[5].trim();
+  return { sha, type, scope, subject: text, isBreaking };
+}
+function groupByType(commits) {
+  const out = /* @__PURE__ */ new Map();
+  for (const c of commits) {
+    const canonical = CATEGORY_ORDER.find((cat) => cat.type === c.type)?.type ?? "chore";
+    const arr = out.get(canonical) ?? [];
+    arr.push(c);
+    out.set(canonical, arr);
+  }
+  return out;
+}
+function renderMarkdown(version, date, from, to, grouped, deploys) {
+  const lines = [];
+  lines.push(`## ${version} \u2014 ${date}`);
+  lines.push("");
+  lines.push(`_Range: \`${from || "(initial)"}\`..\`${to}\`_`);
+  lines.push("");
+  const breaking = [...grouped.values()].flat().filter((c) => c.isBreaking);
+  if (breaking.length > 0) {
+    lines.push("### \u26A0\uFE0F BREAKING CHANGES");
+    lines.push("");
+    for (const c of breaking) {
+      lines.push(`- ${formatCommitLine(c)}`);
+    }
+    lines.push("");
+  }
+  const headingsSeen = /* @__PURE__ */ new Set();
+  for (const { heading } of CATEGORY_ORDER) {
+    if (headingsSeen.has(heading)) continue;
+    headingsSeen.add(heading);
+    const types = CATEGORY_ORDER.filter((c) => c.heading === heading).map((c) => c.type);
+    const commits = types.flatMap((t) => grouped.get(t) ?? []);
+    if (commits.length === 0) continue;
+    lines.push(`### ${heading}`);
+    lines.push("");
+    for (const c of commits) {
+      if (c.isBreaking) continue;
+      lines.push(`- ${formatCommitLine(c)}`);
+    }
+    lines.push("");
+  }
+  if (deploys.length > 0) {
+    lines.push("### \u{1F680} Deploys");
+    lines.push("");
+    for (const d of deploys) {
+      lines.push(`- ${formatDeploySummaryLine(d)}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatCommitLine(c) {
+  const scope = c.scope ? `**${c.scope}**: ` : "";
+  return `${scope}${c.subject} (\`${c.sha.slice(0, 7)}\`)`;
+}
+async function readDeploySummaries(dir) {
+  let entries;
+  try {
+    entries = await fs.readdir(dir);
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const name of entries.sort()) {
+    if (!name.endsWith(".json")) continue;
+    try {
+      const body = await fs.readFile(path.join(dir, name), "utf8");
+      const parsed = JSON.parse(body);
+      if (parsed.version !== 1) continue;
+      const steps = Array.isArray(parsed.steps) ? parsed.steps : [];
+      const stepCounts = {};
+      for (const s of steps) {
+        const status = typeof s.status === "string" ? s.status : "unknown";
+        stepCounts[status] = (stepCounts[status] ?? 0) + 1;
+      }
+      out.push({
+        filename: name,
+        ...typeof parsed.deployedAt === "string" ? { deployedAt: parsed.deployedAt } : {},
+        ...typeof parsed.account === "string" ? { account: parsed.account } : {},
+        ...typeof parsed.finalState === "string" ? { finalState: parsed.finalState } : {},
+        failedStepId: parsed.failedStepId ?? null,
+        stepCounts,
+        totalSteps: steps.length
+      });
+    } catch {
+    }
+  }
+  return out;
+}
+function formatDeploySummaryLine(d) {
+  const parts = [];
+  parts.push(`\`${d.filename}\``);
+  if (d.deployedAt) parts.push(d.deployedAt);
+  if (d.account) parts.push(d.account);
+  const stateGlyph = d.finalState === "clean-success" ? "\u2705" : d.finalState === "clean-skipped" ? "\u23ED\uFE0F" : d.finalState === "dirty" ? "\u{1F6D1}" : d.finalState === "clean-partial" ? "\u26A0\uFE0F" : "\xB7";
+  parts.push(`${stateGlyph} ${d.finalState ?? "unknown"}`);
+  parts.push(`${d.totalSteps} step(s)`);
+  const statusTags = Object.entries(d.stepCounts).sort(([a], [b]) => a.localeCompare(b)).map(([s, n]) => `${s}:${n}`).join(", ");
+  if (statusTags) parts.push(`(${statusTags})`);
+  if (d.failedStepId) parts.push(`failed: ${d.failedStepId}`);
+  return parts.join(" \xB7 ");
+}
+export {
+  changelogCommand,
+  parseCommit
+};
+//# sourceMappingURL=changelog-M7XGDYSY.js.map

package/dist/changelog-M7XGDYSY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/changelog.ts"],"sourcesContent":["/**\n * `sdt changelog --from <ref> --to <ref>` — auto-generate a\n * Markdown CHANGELOG section from git commits between two refs.\n *\n * Parses Conventional Commits (`feat:`, `fix:`, `chore:`, `docs:`,\n * `refactor:`, `perf:`, `test:`, `build:`, `style:`, `ci:`),\n * groups commits by category, and emits a release section.\n * Deterministic — no AI dependency. Mirrors `ddt changelog`.\n *\n * Use case: release prep. Cut a tag, run\n * `sdt changelog --from v0.4.0 --to v0.5.0 -o CHANGELOG.md`,\n * commit the updated CHANGELOG with the tag.\n */\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { execFile } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport { Command } from 'commander';\n\nconst execFileP = promisify(execFile);\n\ninterface Commit {\n  sha: string;\n  type: string;\n  scope: string | undefined;\n  subject: string;\n  isBreaking: boolean;\n}\n\nconst CATEGORY_ORDER: Array<{ type: string; heading: string }> = [\n  { type: 'feat', heading: '✨ Features' },\n  { type: 'fix', heading: '🐛 Bug fixes' },\n  { type: 'perf', heading: '⚡ Performance' },\n  { type: 'refactor', heading: '♻️ Refactoring' },\n  { type: 'docs', heading: '📚 Documentation' },\n  { type: 'test', heading: '🧪 Tests' },\n  { type: 'build', heading: '🔧 Build / CI' },\n  { type: 'ci', heading: '🔧 Build / CI' },\n  { type: 'chore', heading: '🧹 Chores' },\n  { type: 'style', heading: '🎨 Style' },\n];\n\nexport function changelogCommand(): Command {\n  const cmd = new Command('changelog');\n  cmd\n    .description(\n      'Generate a Markdown CHANGELOG section from git commits between two refs (Conventional Commits parser).',\n    )\n    .option('--from <ref>', 'Starting git ref (exclusive). Default: previous tag.', '')\n    .option('--to <ref>', 'Ending git ref (inclusive). Default: HEAD.', 'HEAD')\n    .option('--repo <path>', 'Path to the git repository. Default: current directory.', '.')\n    .option('--version <name>', 'Version heading for the section. Default: --to ref.')\n    .option(\n      '--scope <pathspec>',\n      'Restrict to commits touching paths matching this git-pathspec (e.g. `Snowflake/packages/cli/**`). Default: all paths.',\n    )\n    .option('-o, --out <path>', 'Append/write to file. Default: stdout.')\n    .option(\n      '--append',\n      'When --out is set, prepend to existing file (typical changelog behavior).',\n      false,\n    )\n    .option(\n      '--manifest-dir <path>',\n      'Directory containing deploy manifests (default: .sdt/history). When set, the changelog appends a \"🚀 Deploys\" addendum: one row per manifest with step-status counts + safety summary. Manifest reads are best-effort — corrupt files are skipped silently.',\n    )\n    .action(async (opts) => {\n      const repo = path.resolve(String(opts.repo));\n      const to = String(opts.to);\n      let from = String(opts.from);\n      if (!from) {\n        from = await previousTag(repo, to);\n      }\n\n      const commits = await collectCommits(\n        repo,\n        from,\n        to,\n        opts.scope ? String(opts.scope) : undefined,\n      );\n      const grouped = groupByType(commits);\n      const version = String(opts.version ?? to);\n      const today = new Date().toISOString().slice(0, 10);\n      // --manifest-dir: read deploy manifests, build a per-deploy\n      // addendum that surfaces step status + safety counts. Default\n      // dir matches `<tool> publish --apply --manifest` convention.\n      const manifestDir = opts.manifestDir\n        ? path.resolve(String(opts.manifestDir))\n        : path.join(repo, '.sdt', 'history');\n      const deploys = await readDeploySummaries(manifestDir);\n      const md = renderMarkdown(version, today, from, to, grouped, deploys);\n\n      if (opts.out) {\n        const out = path.resolve(String(opts.out));\n        let body = md;\n        if (opts.append) {\n          try {\n            const existing = await fs.readFile(out, 'utf8');\n            body = `${md}\\n${existing}`;\n          } catch {\n            // file doesn't exist — write fresh.\n          }\n        }\n        await fs.mkdir(path.dirname(out), { recursive: true });\n        await fs.writeFile(out, body, 'utf8');\n        console.error(`Wrote ${out} (${commits.length} commit(s)).`);\n      } else {\n        process.stdout.write(md);\n      }\n    });\n  return cmd;\n}\n\nasync function previousTag(repo: string, ref: string): Promise<string> {\n  try {\n    const { stdout } = await execFileP('git', ['describe', '--tags', '--abbrev=0', `${ref}^`], {\n      cwd: repo,\n    });\n    return stdout.trim();\n  } catch {\n    // No previous tag — fall back to the repo's root commit.\n    const { stdout } = await execFileP('git', ['rev-list', '--max-parents=0', 'HEAD'], {\n      cwd: repo,\n    });\n    return stdout.trim().split('\\n')[0] ?? '';\n  }\n}\n\nasync function collectCommits(\n  repo: string,\n  from: string,\n  to: string,\n  scope?: string,\n): Promise<Commit[]> {\n  const range = from ? `${from}..${to}` : to;\n  const args = ['log', '--no-merges', '--pretty=format:%H%x01%s', range];\n  if (scope) {\n    args.push('--', scope);\n  }\n  const { stdout } = await execFileP('git', args, {\n    cwd: repo,\n    maxBuffer: 64 * 1024 * 1024,\n  });\n  const lines = stdout.split('\\n').filter(Boolean);\n  return lines.map((line) => {\n    const [sha, subject] = line.split('\\x01');\n    return parseCommit(sha!, subject!);\n  });\n}\n\nexport function parseCommit(sha: string, subject: string): Commit {\n  // Conventional Commits: <type>(<scope>)?: <subject>\n  // Breaking-change marker is a trailing `!` before the colon.\n  const m = subject.match(/^([a-z]+)(\\(([^)]+)\\))?(!)?:\\s*(.+)$/i);\n  if (!m) {\n    return { sha, type: 'chore', scope: undefined, subject, isBreaking: false };\n  }\n  const type = m[1]!.toLowerCase();\n  const scope = m[3];\n  const isBreaking = !!m[4];\n  const text = m[5]!.trim();\n  return { sha, type, scope, subject: text, isBreaking };\n}\n\nfunction groupByType(commits: Commit[]): Map<string, Commit[]> {\n  const out = new Map<string, Commit[]>();\n  for (const c of commits) {\n    // Map both 'ci' and 'build' to the same bucket via heading lookup.\n    const canonical = CATEGORY_ORDER.find((cat) => cat.type === c.type)?.type ?? 'chore';\n    const arr = out.get(canonical) ?? [];\n    arr.push(c);\n    out.set(canonical, arr);\n  }\n  return out;\n}\n\nfunction renderMarkdown(\n  version: string,\n  date: string,\n  from: string,\n  to: string,\n  grouped: Map<string, Commit[]>,\n  deploys: DeploySummary[],\n): string {\n  const lines: string[] = [];\n  lines.push(`## ${version} — ${date}`);\n  lines.push('');\n  lines.push(`_Range: \\`${from || '(initial)'}\\`..\\`${to}\\`_`);\n  lines.push('');\n\n  const breaking = [...grouped.values()].flat().filter((c) => c.isBreaking);\n  if (breaking.length > 0) {\n    lines.push('### ⚠️ BREAKING CHANGES');\n    lines.push('');\n    for (const c of breaking) {\n      lines.push(`- ${formatCommitLine(c)}`);\n    }\n    lines.push('');\n  }\n\n  const headingsSeen = new Set<string>();\n  for (const { heading } of CATEGORY_ORDER) {\n    if (headingsSeen.has(heading)) continue;\n    headingsSeen.add(heading);\n    const types = CATEGORY_ORDER.filter((c) => c.heading === heading).map((c) => c.type);\n    const commits = types.flatMap((t) => grouped.get(t) ?? []);\n    if (commits.length === 0) continue;\n    lines.push(`### ${heading}`);\n    lines.push('');\n    for (const c of commits) {\n      if (c.isBreaking) continue; // Already listed under BREAKING.\n      lines.push(`- ${formatCommitLine(c)}`);\n    }\n    lines.push('');\n  }\n\n  if (deploys.length > 0) {\n    lines.push('### 🚀 Deploys');\n    lines.push('');\n    for (const d of deploys) {\n      lines.push(`- ${formatDeploySummaryLine(d)}`);\n    }\n    lines.push('');\n  }\n  return lines.join('\\n');\n}\n\nfunction formatCommitLine(c: Commit): string {\n  const scope = c.scope ? `**${c.scope}**: ` : '';\n  return `${scope}${c.subject} (\\`${c.sha.slice(0, 7)}\\`)`;\n}\n\n/** One deploy-manifest summary row for the changelog's 🚀 addendum. */\nexport interface DeploySummary {\n  /** Manifest filename (no path), useful as the link target in markdown. */\n  filename: string;\n  /** ISO timestamp the deploy finished, when present in the manifest. */\n  deployedAt?: string;\n  /** Snowflake account or Databricks workspace host. */\n  account?: string;\n  /** clean-success / clean-partial / dirty / clean-skipped. */\n  finalState?: string;\n  /** Step id of the first failure (when finalState === 'dirty'). */\n  failedStepId?: string | null;\n  /** Per-status counts across all steps. */\n  stepCounts: Record<string, number>;\n  /** Total step count. */\n  totalSteps: number;\n}\n\n/** Read every `<dir>/*.json` deploy manifest into a summary row. Best-effort. */\nasync function readDeploySummaries(dir: string): Promise<DeploySummary[]> {\n  let entries: string[];\n  try {\n    entries = await fs.readdir(dir);\n  } catch {\n    return [];\n  }\n  const out: DeploySummary[] = [];\n  for (const name of entries.sort()) {\n    if (!name.endsWith('.json')) continue;\n    try {\n      const body = await fs.readFile(path.join(dir, name), 'utf8');\n      const parsed = JSON.parse(body) as {\n        version?: number;\n        deployedAt?: string;\n        account?: string;\n        finalState?: string;\n        failedStepId?: string | null;\n        steps?: Array<{ status?: string }>;\n      };\n      if (parsed.version !== 1) continue;\n      const steps = Array.isArray(parsed.steps) ? parsed.steps : [];\n      const stepCounts: Record<string, number> = {};\n      for (const s of steps) {\n        const status = typeof s.status === 'string' ? s.status : 'unknown';\n        stepCounts[status] = (stepCounts[status] ?? 0) + 1;\n      }\n      out.push({\n        filename: name,\n        ...(typeof parsed.deployedAt === 'string' ? { deployedAt: parsed.deployedAt } : {}),\n        ...(typeof parsed.account === 'string' ? { account: parsed.account } : {}),\n        ...(typeof parsed.finalState === 'string' ? { finalState: parsed.finalState } : {}),\n        failedStepId: parsed.failedStepId ?? null,\n        stepCounts,\n        totalSteps: steps.length,\n      });\n    } catch {\n      // Corrupt or missing — skip. Deploy manifests are append-only;\n      // a half-written file is the rare exception.\n    }\n  }\n  return out;\n}\n\n/** Render one DeploySummary as a Markdown bullet. */\nfunction formatDeploySummaryLine(d: DeploySummary): string {\n  const parts: string[] = [];\n  parts.push(`\\`${d.filename}\\``);\n  if (d.deployedAt) parts.push(d.deployedAt);\n  if (d.account) parts.push(d.account);\n  const stateGlyph =\n    d.finalState === 'clean-success'\n      ? '✅'\n      : d.finalState === 'clean-skipped'\n        ? '⏭️'\n        : d.finalState === 'dirty'\n          ? '🛑'\n          : d.finalState === 'clean-partial'\n            ? '⚠️'\n            : '·';\n  parts.push(`${stateGlyph} ${d.finalState ?? 'unknown'}`);\n  parts.push(`${d.totalSteps} step(s)`);\n  const statusTags = Object.entries(d.stepCounts)\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([s, n]) => `${s}:${n}`)\n    .join(', ');\n  if (statusTags) parts.push(`(${statusTags})`);\n  if (d.failedStepId) parts.push(`failed: ${d.failedStepId}`);\n  return parts.join(' · ');\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-DGUM43GV.js

@@ -0,0 +1,11 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+export {
+  __require
+};
+//# sourceMappingURL=chunk-DGUM43GV.js.map

package/dist/chunk-DGUM43GV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-EWXM4KJN.js

@@ -0,0 +1,25 @@
+// src/util/help-catalog.ts
+import { DEPLOY_OPTIONS_CATALOG } from "@sdt-tools/core/options";
+var CATALOG_BY_NAME = new Map(
+  DEPLOY_OPTIONS_CATALOG.map((entry) => [entry.name, entry])
+);
+function attachRelatedOptions(cmd, names) {
+  const entries = [];
+  for (const n of names) {
+    const e = CATALOG_BY_NAME.get(n);
+    if (e) entries.push(e);
+  }
+  if (entries.length === 0) return;
+  const maxName = entries.reduce((m, e) => Math.max(m, e.name.length), 0);
+  const lines = [
+    "",
+    "Related options (run `sdt explain <name>` for safety tier, default, and example):",
+    ...entries.map((e) => `  ${e.name.padEnd(maxName)}  ${e.summary}`)
+  ];
+  cmd.addHelpText("after", lines.join("\n"));
+}
+
+export {
+  attachRelatedOptions
+};
+//# sourceMappingURL=chunk-EWXM4KJN.js.map

package/dist/chunk-EWXM4KJN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util/help-catalog.ts"],"sourcesContent":["/**\n * Per-command --help enrichments — show 3-5 related catalog entries\n * under each command's help screen, with a one-line summary and a\n * pointer to `sdt explain <name>` for the full entry.\n *\n * Free-tier discoverability: a user who opens `sdt publish --help`\n * lands on a clear list of the deployment options that govern the\n * command's safety behaviour, without needing to know they exist or\n * read the project format reference first.\n *\n * Mirrors `Databricks/packages/cli/src/util/help-catalog.ts`.\n */\nimport type { Command } from 'commander';\nimport { DEPLOY_OPTIONS_CATALOG, type OptionEntry } from '@sdt-tools/core/options';\n\nconst CATALOG_BY_NAME: Map<string, OptionEntry> = new Map(\n  DEPLOY_OPTIONS_CATALOG.map((entry) => [entry.name, entry]),\n);\n\n/**\n * Attach an \"After\" help block listing the named catalog entries with\n * one-line summaries. Unknown keys are silently skipped so a stale\n * mapping never breaks --help.\n */\nexport function attachRelatedOptions(cmd: Command, names: readonly string[]): void {\n  const entries: OptionEntry[] = [];\n  for (const n of names) {\n    const e = CATALOG_BY_NAME.get(n);\n    if (e) entries.push(e);\n  }\n  if (entries.length === 0) return;\n  const maxName = entries.reduce((m, e) => Math.max(m, e.name.length), 0);\n  const lines = [\n    '',\n    'Related options (run `sdt explain <name>` for safety tier, default, and example):',\n    ...entries.map((e) => `  ${e.name.padEnd(maxName)}  ${e.summary}`),\n  ];\n  cmd.addHelpText('after', lines.join('\\n'));\n}\n"],"mappings":";AAaA,SAAS,8BAAgD;AAEzD,IAAM,kBAA4C,IAAI;AAAA,EACpD,uBAAuB,IAAI,CAAC,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC;AAC3D;AAOO,SAAS,qBAAqB,KAAc,OAAgC;AACjF,QAAM,UAAyB,CAAC;AAChC,aAAW,KAAK,OAAO;AACrB,UAAM,IAAI,gBAAgB,IAAI,CAAC;AAC/B,QAAI,EAAG,SAAQ,KAAK,CAAC;AAAA,EACvB;AACA,MAAI,QAAQ,WAAW,EAAG;AAC1B,QAAM,UAAU,QAAQ,OAAO,CAAC,GAAG,MAAM,KAAK,IAAI,GAAG,EAAE,KAAK,MAAM,GAAG,CAAC;AACtE,QAAM,QAAQ;AAAA,IACZ;AAAA,IACA;AAAA,IACA,GAAG,QAAQ,IAAI,CAAC,MAAM,KAAK,EAAE,KAAK,OAAO,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE;AAAA,EACnE;AACA,MAAI,YAAY,SAAS,MAAM,KAAK,IAAI,CAAC;AAC3C;","names":[]}

package/dist/chunk-JP2EZLR5.js

@@ -0,0 +1,50 @@
+// src/util/mapping.ts
+import { promises as fs } from "fs";
+import { Option } from "commander";
+import { compare } from "@sdt-tools/core";
+function addMappingFlags(cmd) {
+  return cmd.option(
+    "--map <src=tgt>",
+    "Logical-name mapping (repeatable). Examples: DB_A=DB_B, DB_A.STAGING=DB_B.RAW. Rewrites source-side FQNs and DDL body refs.",
+    (value, previous) => [...previous, value],
+    []
+  ).option("--map-file <path>", "JSON file of mappings.").addOption(
+    new Option(
+      "--map-case-sensitive",
+      "Match identifiers case-sensitively. Default: insensitive."
+    ).default(false)
+  ).addOption(
+    new Option(
+      "--map-rewrite-standalone",
+      "Rewrite standalone one-part refs (e.g. USE DATABASE DB_A). Default: off (safer)."
+    ).default(false)
+  ).addOption(
+    new Option(
+      "--map-rewrite-strings",
+      "Phase 3: also rewrite FQN-shaped tokens inside string literals (best-effort, may produce false positives in legitimate string content). Default: off."
+    ).default(false)
+  );
+}
+async function buildMappingFromOptions(opts) {
+  const flagMappings = Array.isArray(opts.map) ? opts.map : [];
+  let mapping = { entries: [] };
+  if (opts.mapFile) {
+    const raw = await fs.readFile(String(opts.mapFile), "utf8");
+    mapping = compare.mappingFromFile(JSON.parse(raw));
+  }
+  if (flagMappings.length > 0) {
+    const fromArgs = compare.mappingFromArgs(flagMappings);
+    mapping = { entries: [...mapping.entries, ...fromArgs.entries] };
+  }
+  if (mapping.entries.length === 0) return void 0;
+  if (opts.mapCaseSensitive) mapping.caseSensitive = true;
+  if (opts.mapRewriteStandalone) mapping.rewriteStandaloneRefs = true;
+  if (opts.mapRewriteStrings) mapping.rewriteInsideStrings = true;
+  return mapping;
+}
+
+export {
+  addMappingFlags,
+  buildMappingFromOptions
+};
+//# sourceMappingURL=chunk-JP2EZLR5.js.map

package/dist/chunk-JP2EZLR5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util/mapping.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport { Option, type Command } from 'commander';\nimport { compare } from '@sdt-tools/core';\n\ntype NameMapping = compare.NameMapping;\n\nexport interface MappingOptions {\n  map?: string[];\n  mapFile?: string;\n  mapCaseSensitive?: boolean;\n  mapRewriteStandalone?: boolean;\n  mapRewriteStrings?: boolean;\n}\n\n/** Attach `--map`, `--map-file`, `--map-case-sensitive`, `--map-rewrite-standalone`, `--map-rewrite-strings` to a command. */\nexport function addMappingFlags(cmd: Command): Command {\n  return cmd\n    .option(\n      '--map <src=tgt>',\n      'Logical-name mapping (repeatable). Examples: DB_A=DB_B, DB_A.STAGING=DB_B.RAW. Rewrites source-side FQNs and DDL body refs.',\n      (value: string, previous: string[]) => [...previous, value],\n      [] as string[],\n    )\n    .option('--map-file <path>', 'JSON file of mappings.')\n    .addOption(\n      new Option(\n        '--map-case-sensitive',\n        'Match identifiers case-sensitively. Default: insensitive.',\n      ).default(false),\n    )\n    .addOption(\n      new Option(\n        '--map-rewrite-standalone',\n        'Rewrite standalone one-part refs (e.g. USE DATABASE DB_A). Default: off (safer).',\n      ).default(false),\n    )\n    .addOption(\n      new Option(\n        '--map-rewrite-strings',\n        'Phase 3: also rewrite FQN-shaped tokens inside string literals (best-effort, may produce false positives in legitimate string content). Default: off.',\n      ).default(false),\n    );\n}\n\n/** Build a `NameMapping` from `--map`/`--map-file` flag values. Returns undefined when no mappings supplied. */\nexport async function buildMappingFromOptions(\n  opts: MappingOptions,\n): Promise<NameMapping | undefined> {\n  const flagMappings = Array.isArray(opts.map) ? opts.map : [];\n  let mapping: NameMapping = { entries: [] };\n  if (opts.mapFile) {\n    const raw = await fs.readFile(String(opts.mapFile), 'utf8');\n    mapping = compare.mappingFromFile(JSON.parse(raw));\n  }\n  if (flagMappings.length > 0) {\n    const fromArgs = compare.mappingFromArgs(flagMappings);\n    mapping = { entries: [...mapping.entries, ...fromArgs.entries] };\n  }\n  if (mapping.entries.length === 0) return undefined;\n  if (opts.mapCaseSensitive) mapping.caseSensitive = true;\n  if (opts.mapRewriteStandalone) mapping.rewriteStandaloneRefs = true;\n  if (opts.mapRewriteStrings) mapping.rewriteInsideStrings = true;\n  return mapping;\n}\n\n/** Render a one-line summary of a NameMapping for the operator's log output. */\nexport function describeMapping(mapping: NameMapping | undefined): string {\n  if (!mapping || mapping.entries.length === 0) return '';\n  return mapping.entries.map((e) => `${e.source}→${e.target}`).join(', ');\n}\n"],"mappings":";AAAA,SAAS,YAAY,UAAU;AAC/B,SAAS,cAA4B;AACrC,SAAS,eAAe;AAajB,SAAS,gBAAgB,KAAuB;AACrD,SAAO,IACJ;AAAA,IACC;AAAA,IACA;AAAA,IACA,CAAC,OAAe,aAAuB,CAAC,GAAG,UAAU,KAAK;AAAA,IAC1D,CAAC;AAAA,EACH,EACC,OAAO,qBAAqB,wBAAwB,EACpD;AAAA,IACC,IAAI;AAAA,MACF;AAAA,MACA;AAAA,IACF,EAAE,QAAQ,KAAK;AAAA,EACjB,EACC;AAAA,IACC,IAAI;AAAA,MACF;AAAA,MACA;AAAA,IACF,EAAE,QAAQ,KAAK;AAAA,EACjB,EACC;AAAA,IACC,IAAI;AAAA,MACF;AAAA,MACA;AAAA,IACF,EAAE,QAAQ,KAAK;AAAA,EACjB;AACJ;AAGA,eAAsB,wBACpB,MACkC;AAClC,QAAM,eAAe,MAAM,QAAQ,KAAK,GAAG,IAAI,KAAK,MAAM,CAAC;AAC3D,MAAI,UAAuB,EAAE,SAAS,CAAC,EAAE;AACzC,MAAI,KAAK,SAAS;AAChB,UAAM,MAAM,MAAM,GAAG,SAAS,OAAO,KAAK,OAAO,GAAG,MAAM;AAC1D,cAAU,QAAQ,gBAAgB,KAAK,MAAM,GAAG,CAAC;AAAA,EACnD;AACA,MAAI,aAAa,SAAS,GAAG;AAC3B,UAAM,WAAW,QAAQ,gBAAgB,YAAY;AACrD,cAAU,EAAE,SAAS,CAAC,GAAG,QAAQ,SAAS,GAAG,SAAS,OAAO,EAAE;AAAA,EACjE;AACA,MAAI,QAAQ,QAAQ,WAAW,EAAG,QAAO;AACzC,MAAI,KAAK,iBAAkB,SAAQ,gBAAgB;AACnD,MAAI,KAAK,qBAAsB,SAAQ,wBAAwB;AAC/D,MAAI,KAAK,kBAAmB,SAAQ,uBAAuB;AAC3D,SAAO;AACT;","names":[]}

package/dist/chunk-VM2H4LAO.js

@@ -0,0 +1,15 @@
+// src/util/logger.ts
+import chalk from "chalk";
+var logger = {
+  info: (msg) => console.log(msg),
+  success: (msg) => console.log(chalk.green("\u2714"), msg),
+  warn: (msg) => console.warn(chalk.yellow("!"), msg),
+  error: (msg) => console.error(chalk.red("\u2716"), msg),
+  step: (msg) => console.log(chalk.cyan("\u2192"), msg),
+  dim: (msg) => console.log(chalk.gray(msg))
+};
+
+export {
+  logger
+};
+//# sourceMappingURL=chunk-VM2H4LAO.js.map

package/dist/chunk-VM2H4LAO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util/logger.ts"],"sourcesContent":["/**\n * Minimal logger used by the CLI. Wraps chalk/ora so a future move to a\n * non-tty mode is centralised.\n */\nimport chalk from 'chalk';\n\nexport const logger = {\n  info: (msg: string) => console.log(msg),\n  success: (msg: string) => console.log(chalk.green('✔'), msg),\n  warn: (msg: string) => console.warn(chalk.yellow('!'), msg),\n  error: (msg: string) => console.error(chalk.red('✖'), msg),\n  step: (msg: string) => console.log(chalk.cyan('→'), msg),\n  dim: (msg: string) => console.log(chalk.gray(msg)),\n};\n"],"mappings":";AAIA,OAAO,WAAW;AAEX,IAAM,SAAS;AAAA,EACpB,MAAM,CAAC,QAAgB,QAAQ,IAAI,GAAG;AAAA,EACtC,SAAS,CAAC,QAAgB,QAAQ,IAAI,MAAM,MAAM,QAAG,GAAG,GAAG;AAAA,EAC3D,MAAM,CAAC,QAAgB,QAAQ,KAAK,MAAM,OAAO,GAAG,GAAG,GAAG;AAAA,EAC1D,OAAO,CAAC,QAAgB,QAAQ,MAAM,MAAM,IAAI,QAAG,GAAG,GAAG;AAAA,EACzD,MAAM,CAAC,QAAgB,QAAQ,IAAI,MAAM,KAAK,QAAG,GAAG,GAAG;AAAA,EACvD,KAAK,CAAC,QAAgB,QAAQ,IAAI,MAAM,KAAK,GAAG,CAAC;AACnD;","names":[]}

package/dist/chunk-ZWY4ZRHL.js

@@ -0,0 +1,44 @@
+import {
+  logger
+} from "./chunk-VM2H4LAO.js";
+
+// src/util/ai-explain.ts
+import { ai } from "@sdt-tools/core";
+var DEFAULT_SYSTEM_PROMPT = `You are a senior Snowflake DBA reviewing structured output from the SDT 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 `sdt ai` to be configured.",
+    false
+  );
+  return cmd;
+}
+async function runExplain(ctx, opts, buildPrompt) {
+  if (!opts.explain) return;
+  const system = ctx.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
+  logger.info("");
+  logger.info("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")) logger.info("  " + line);
+  } catch (err) {
+    logger.error("  --explain failed: " + (err instanceof Error ? err.message : String(err)));
+    logger.error(
+      "  Run `sdt ai status` to verify your AI provider is configured (`sdt ai test` to send a probe)."
+    );
+  }
+}
+
+export {
+  attachExplainFlag,
+  runExplain
+};
+//# sourceMappingURL=chunk-ZWY4ZRHL.js.map