@sdt-tools/cli 0.2.0 → 0.2.5

package/dist/history-RONA7ZTI.js

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

package/dist/history-RONA7ZTI.js.map

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

package/dist/hosts-YBXY2ZG5.js

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

package/dist/hosts-YBXY2ZG5.js.map

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

package/dist/impact-T2JSANHS.js

@@ -0,0 +1,59 @@
+import {
+  attachExplainFlag,
+  runExplain
+} from "./chunk-ZWY4ZRHL.js";
+import "./chunk-VM2H4LAO.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/impact.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import { pac, project, review } from "@sdt-tools/core";
+function impactCommand() {
+  const cmd = new Command("impact");
+  cmd.description(
+    "Single-FQN blast-radius: who feeds it, who reads from it, what findings apply to it."
+  ).argument("<fqn>", "Fully-qualified name to analyze (e.g. ANALYTICS.GOLD.CUSTOMER).").requiredOption("--source <path>", ".sdtproj or .sdtpac to analyze.").option("-o, --out <path>", "Output file path. Defaults to stdout.").action(async (fqn, opts) => {
+    const sourcePath = String(opts.source);
+    const model = await loadModel(sourcePath);
+    const md = review.renderImpactReport(model, String(fqn), { source: sourcePath });
+    await emit(md, opts.out);
+    await runExplain(
+      {
+        feature: "impact.explain",
+        systemPrompt: "You are a senior Snowflake DBA explaining an impact analysis to a developer who is about to change one object. Be very direct about the blast radius and what they should test before merging."
+      },
+      opts,
+      () => `Impact report for ${fqn} follows:
+
+${md}
+
+Explain the blast radius and what the engineer should pay attention to.`
+    );
+  });
+  attachExplainFlag(cmd);
+  return cmd;
+}
+async function loadModel(sourcePath) {
+  if (sourcePath.endsWith(".sdtpac")) {
+    const c = await pac.readPac(sourcePath);
+    return c.model;
+  }
+  const loaded = await project.loadProject(sourcePath);
+  return await project.parseProjectModel(loaded);
+}
+async function emit(payload, out) {
+  if (out) {
+    const p = path.resolve(String(out));
+    await fs.mkdir(path.dirname(p), { recursive: true });
+    await fs.writeFile(p, payload + (payload.endsWith("\n") ? "" : "\n"), "utf8");
+    console.error(`Wrote ${p} (${payload.length} bytes).`);
+  } else {
+    process.stdout.write(payload + (payload.endsWith("\n") ? "" : "\n"));
+  }
+}
+export {
+  impactCommand
+};
+//# sourceMappingURL=impact-T2JSANHS.js.map

package/dist/impact-T2JSANHS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/impact.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\nimport { pac, project, review } from '@sdt-tools/core';\nimport { attachExplainFlag, runExplain } from '../util/ai-explain.js';\n\n/**\n * `sdt impact <fqn>` — single-FQN blast-radius answer. \"If I change\n * this, what breaks? What feeds it? What pending diagnostics\n * touch it?\" Composition of `@sdt-tools/core/lineage` (upstream/downstream)\n * and `@sdt-tools/core/diagnostics` (findings filtered to the FQN).\n *\n * Output is Markdown by default; `--format json` returns a structured\n * payload for CI integration.\n */\nexport function impactCommand(): Command {\n  const cmd = new Command('impact');\n  cmd\n    .description(\n      'Single-FQN blast-radius: who feeds it, who reads from it, what findings apply to it.',\n    )\n    .argument('<fqn>', 'Fully-qualified name to analyze (e.g. ANALYTICS.GOLD.CUSTOMER).')\n    .requiredOption('--source <path>', '.sdtproj or .sdtpac to analyze.')\n    .option('-o, --out <path>', 'Output file path. Defaults to stdout.')\n    .action(async (fqn: string, opts: { source: string; out?: string; explain?: boolean }) => {\n      const sourcePath = String(opts.source);\n      const model = await loadModel(sourcePath);\n      const md = review.renderImpactReport(model, String(fqn), { source: sourcePath });\n      await emit(md, opts.out);\n      await runExplain(\n        {\n          feature: 'impact.explain',\n          systemPrompt:\n            'You are a senior Snowflake DBA explaining an impact analysis to a developer who is about to change one object. Be very direct about the blast radius and what they should test before merging.',\n        },\n        opts,\n        () =>\n          `Impact report for ${fqn} follows:\\n\\n${md}\\n\\nExplain the blast radius and what the engineer should pay attention to.`,\n      );\n    });\n  attachExplainFlag(cmd);\n  return cmd;\n}\n\nasync function loadModel(sourcePath: string) {\n  if (sourcePath.endsWith('.sdtpac')) {\n    const c = await pac.readPac(sourcePath);\n    return c.model;\n  }\n  const loaded = await project.loadProject(sourcePath);\n  return await project.parseProjectModel(loaded);\n}\n\nasync function emit(payload: string, out: unknown): Promise<void> {\n  if (out) {\n    const p = path.resolve(String(out));\n    await fs.mkdir(path.dirname(p), { recursive: true });\n    await fs.writeFile(p, payload + (payload.endsWith('\\n') ? '' : '\\n'), 'utf8');\n    console.error(`Wrote ${p} (${payload.length} bytes).`);\n  } else {\n    process.stdout.write(payload + (payload.endsWith('\\n') ? '' : '\\n'));\n  }\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,YAAY,UAAU;AAC/B,OAAO,UAAU;AACjB,SAAS,eAAe;AACxB,SAAS,KAAK,SAAS,cAAc;AAY9B,SAAS,gBAAyB;AACvC,QAAM,MAAM,IAAI,QAAQ,QAAQ;AAChC,MACG;AAAA,IACC;AAAA,EACF,EACC,SAAS,SAAS,iEAAiE,EACnF,eAAe,mBAAmB,iCAAiC,EACnE,OAAO,oBAAoB,uCAAuC,EAClE,OAAO,OAAO,KAAa,SAA8D;AACxF,UAAM,aAAa,OAAO,KAAK,MAAM;AACrC,UAAM,QAAQ,MAAM,UAAU,UAAU;AACxC,UAAM,KAAK,OAAO,mBAAmB,OAAO,OAAO,GAAG,GAAG,EAAE,QAAQ,WAAW,CAAC;AAC/E,UAAM,KAAK,IAAI,KAAK,GAAG;AACvB,UAAM;AAAA,MACJ;AAAA,QACE,SAAS;AAAA,QACT,cACE;AAAA,MACJ;AAAA,MACA;AAAA,MACA,MACE,qBAAqB,GAAG;AAAA;AAAA,EAAgB,EAAE;AAAA;AAAA;AAAA,IAC9C;AAAA,EACF,CAAC;AACH,oBAAkB,GAAG;AACrB,SAAO;AACT;AAEA,eAAe,UAAU,YAAoB;AAC3C,MAAI,WAAW,SAAS,SAAS,GAAG;AAClC,UAAM,IAAI,MAAM,IAAI,QAAQ,UAAU;AACtC,WAAO,EAAE;AAAA,EACX;AACA,QAAM,SAAS,MAAM,QAAQ,YAAY,UAAU;AACnD,SAAO,MAAM,QAAQ,kBAAkB,MAAM;AAC/C;AAEA,eAAe,KAAK,SAAiB,KAA6B;AAChE,MAAI,KAAK;AACP,UAAM,IAAI,KAAK,QAAQ,OAAO,GAAG,CAAC;AAClC,UAAM,GAAG,MAAM,KAAK,QAAQ,CAAC,GAAG,EAAE,WAAW,KAAK,CAAC;AACnD,UAAM,GAAG,UAAU,GAAG,WAAW,QAAQ,SAAS,IAAI,IAAI,KAAK,OAAO,MAAM;AAC5E,YAAQ,MAAM,SAAS,CAAC,KAAK,QAAQ,MAAM,UAAU;AAAA,EACvD,OAAO;AACL,YAAQ,OAAO,MAAM,WAAW,QAAQ,SAAS,IAAI,IAAI,KAAK,KAAK;AAAA,EACrE;AACF;","names":[]}

package/dist/import-AELYLY6A.js

@@ -0,0 +1,32 @@
+import {
+  logger
+} from "./chunk-VM2H4LAO.js";
+import "./chunk-DGUM43GV.js";
+
+// src/commands/import.ts
+import { Command } from "commander";
+import { importers as importersApi } from "@sdt-tools/core";
+function importCommand() {
+  return new Command("import").description("Convert artifacts from other tools into an SDT project.").requiredOption(
+    "--from <source>",
+    "Source format (schemachange, snowddl, sqlpackage-dacpac, snowflake-account, snowflake-dcm, terraform-state, sql-files)"
+  ).requiredOption("--source-path <path>", "Source artifact path (file or directory)").requiredOption("--output <dir>", "Output directory for the generated SDT project").option("--connection <profile>", "Connection profile (required for snowflake-account)").action(
+    async (opts) => {
+      const source = opts.from;
+      const importer = importersApi.getImporter(source);
+      const result = await importer.import({
+        sourcePath: opts.sourcePath,
+        outputDir: opts.output,
+        connectionProfile: opts.connection
+      });
+      logger.info(
+        `Imported ${result.filesCreated} files. Project written to ${result.projectPath}`
+      );
+      for (const w of result.warnings) logger.warn(w);
+    }
+  );
+}
+export {
+  importCommand
+};
+//# sourceMappingURL=import-AELYLY6A.js.map

package/dist/import-AELYLY6A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/import.ts"],"sourcesContent":["/**\n * `sdt import` — convert artifacts from other tools into an `.sdtproj`.\n *\n * Sources (all v0.x stubs):\n *   - schemachange       (V*.sql / R__*.sql tree)\n *   - snowddl            (YAML config tree)\n *   - sqlpackage-dacpac  (SQL Server `.dacpac`)\n *   - snowflake-account  (live account → project, like `extract` + skeleton)\n *   - terraform-state    (`.tfstate` from Snowflake-Labs/snowflake provider)\n *   - sql-files          (flat dir of `.sql`)\n */\nimport { Command } from 'commander';\n\nimport { importers as importersApi } from '@sdt-tools/core';\nimport { logger } from '../util/logger.js';\n\nexport function importCommand(): Command {\n  return new Command('import')\n    .description('Convert artifacts from other tools into an SDT project.')\n    .requiredOption(\n      '--from <source>',\n      'Source format (schemachange, snowddl, sqlpackage-dacpac, snowflake-account, snowflake-dcm, terraform-state, sql-files)',\n    )\n    .requiredOption('--source-path <path>', 'Source artifact path (file or directory)')\n    .requiredOption('--output <dir>', 'Output directory for the generated SDT project')\n    .option('--connection <profile>', 'Connection profile (required for snowflake-account)')\n    .action(\n      async (opts: { from: string; sourcePath: string; output: string; connection?: string }) => {\n        const source = opts.from as Parameters<typeof importersApi.getImporter>[0];\n        const importer = importersApi.getImporter(source);\n        const result = await importer.import({\n          sourcePath: opts.sourcePath,\n          outputDir: opts.output,\n          connectionProfile: opts.connection,\n        });\n        logger.info(\n          `Imported ${result.filesCreated} files. Project written to ${result.projectPath}`,\n        );\n        for (const w of result.warnings) logger.warn(w);\n      },\n    );\n}\n"],"mappings":";;;;;;AAWA,SAAS,eAAe;AAExB,SAAS,aAAa,oBAAoB;AAGnC,SAAS,gBAAyB;AACvC,SAAO,IAAI,QAAQ,QAAQ,EACxB,YAAY,yDAAyD,EACrE;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC,eAAe,wBAAwB,0CAA0C,EACjF,eAAe,kBAAkB,gDAAgD,EACjF,OAAO,0BAA0B,qDAAqD,EACtF;AAAA,IACC,OAAO,SAAoF;AACzF,YAAM,SAAS,KAAK;AACpB,YAAM,WAAW,aAAa,YAAY,MAAM;AAChD,YAAM,SAAS,MAAM,SAAS,OAAO;AAAA,QACnC,YAAY,KAAK;AAAA,QACjB,WAAW,KAAK;AAAA,QAChB,mBAAmB,KAAK;AAAA,MAC1B,CAAC;AACD,aAAO;AAAA,QACL,YAAY,OAAO,YAAY,8BAA8B,OAAO,WAAW;AAAA,MACjF;AACA,iBAAW,KAAK,OAAO,SAAU,QAAO,KAAK,CAAC;AAAA,IAChD;AAAA,EACF;AACJ;","names":[]}

package/dist/index.cjs

@@ -86,7 +86,10 @@ var logger = {
 // src/commands/init.ts
 function initCommand() {
   const cmd = new import_commander.Command("init");
-  cmd.description("Initialize a new SDT project in the current directory.").option("--name <name>", "Project name", "NewSnowflakeProject").option("--scope <scope>", "Project scope: account | database | schema", "database").option("--db <database>", "Database name (required for database/schema scope)").option("--schema <schema>", "Schema name (required for schema scope)").option("--dir <dir>", "Target directory (default: cwd)", process.cwd()).action(async (opts) => {
+  cmd.description("Initialize a new SDT project in the current directory.").option("--name <name>", "Project name", "NewSnowflakeProject").option("--scope <scope>", "Project scope: account | database | schema", "database").option("--db <database>", "Database name (required for database/schema scope)").option("--schema <schema>", "Schema name (required for schema scope)").option("--dir <dir>", "Target directory (default: cwd)", process.cwd()).option(
+    "--force",
+    "Overwrite an existing <name>.sdtproj in the target directory. Without this flag, init refuses to clobber an existing project file so a re-run never silently discards your project configuration."
+  ).action(async (opts) => {
     const scopeType = String(opts.scope);
     if (!["account", "database", "schema"].includes(scopeType)) {
       throw new Error(`Invalid --scope: ${opts.scope}. Use account | database | schema.`);
@@ -104,6 +107,15 @@ function initCommand() {
     await import_node_fs.promises.mkdir(root, { recursive: true });
     const project10 = (0, import_project.newProjectTemplate)(String(opts.name), scope);
     const projectPath = import_node_path.default.join(root, `${project10.name}.sdtproj`);
+    if (!opts.force) {
+      try {
+        await import_node_fs.promises.access(projectPath);
+        logger.error(`${projectPath} already exists; pass --force to overwrite.`);
+        process.exitCode = 1;
+        return;
+      } catch {
+      }
+    }
     await (0, import_project.saveProject)(projectPath, project10);
     const seedFolders = ["databases", "scripts/pre", "scripts/post"];
     for (const f of seedFolders) await import_node_fs.promises.mkdir(import_node_path.default.join(root, f), { recursive: true });
@@ -380,7 +392,13 @@ function compareCommand() {
   const cmd = new import_commander5.Command("compare");
   cmd.description(
     "Compare two schemas. Sources may be .sdtproj, .sdtpac, or snowflake://<profile>[/db[/schema]]."
-  ).argument("<source>", "Left side of the comparison").argument("<target>", "Right side of the comparison").option("-o, --output <path>", "Write JSON result to this path").option("--format <format>", "Output format: json | summary | markdown", "summary").option("--ignore-case", "Treat unquoted identifiers case-insensitively", false).option(
+  ).argument("[source]", "Left side of the comparison (or use --source)").argument("[target]", "Right side of the comparison (or use --target)").option(
+    "--source <path>",
+    "Left side of the comparison (flag form of the positional source arg)"
+  ).option(
+    "--target <path>",
+    "Right side of the comparison (flag form of the positional target arg)"
+  ).option("-o, --output <path>", "Write JSON result to this path").option("--format <format>", "Output format: json | summary | markdown", "summary").option("--ignore-case", "Treat unquoted identifiers case-insensitively", false).option(
     "--no-slice",
     "Disable the source project's Slice (if it has one). Default: a project's slice is applied automatically."
   ).option(
@@ -405,7 +423,14 @@ function compareCommand() {
   ).option(
     "--no-history",
     "Skip writing the compare-history audit record (AUDITCMP.1). Default: every compare run writes a record to `.sdt/history/compare/`, exportable via `sdt audit-log emit`."
-  ).action(async (sourceArg, targetArg, opts) => {
+  ).action(async (sourceArgPos, targetArgPos, opts) => {
+    const sourceArg = opts.source ? String(opts.source) : sourceArgPos ? String(sourceArgPos) : "";
+    const targetArg = opts.target ? String(opts.target) : targetArgPos ? String(targetArgPos) : "";
+    if (!sourceArg || !targetArg) {
+      throw new Error(
+        "compare needs a source and a target \u2014 pass them positionally (`sdt compare <source> <target>`) or via `--source`/`--target`."
+      );
+    }
     const nameMapping = await buildMappingFromOptions(opts);
     const source = await resolveSource(String(sourceArg));
     const target = await resolveSource(String(targetArg));
@@ -1575,12 +1600,17 @@ function validateCommand() {
     logger.dim(`  Profiles: ${Object.keys(loaded.project.deploymentProfiles ?? {}).length}`);
     if (opts.checkVariables) {
       const projRoot = import_node_path6.default.dirname(import_node_path6.default.resolve(String(opts.project)));
-      const fileContents = await Promise.all(
-        files.map(async (f) => {
+      const { results } = await import_core6.catalog.mapPool(
+        files,
+        async (f) => {
           const relPath = import_node_path6.default.relative(projRoot, f).split(import_node_path6.default.sep).join("/");
           const content = await import_node_fs6.promises.readFile(f, "utf8");
           return { path: relPath, content };
-        })
+        },
+        { concurrency: 16, stopOnError: true }
+      );
+      const fileContents = results.filter(
+        (r) => r !== void 0
       );
       const profilesBlock = loaded.project.deploymentProfiles ?? {};
       const profileVariableKeys = Object.values(profilesBlock).map(