@ddt-tools/cli 0.2.0 → 0.2.5

package/dist/template-MUJ6X6LN.js

@@ -0,0 +1,396 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/template.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+function templateCommand() {
+  const cmd = new Command("template");
+  cmd.description(
+    "Scaffold a common schema pattern (scd1|scd2|scd3|scd4|scd6|star|fact|scd2-merge|current-view|time-series|audit). Writes .sql files into <out>/."
+  ).argument(
+    "<kind>",
+    "Pattern to scaffold: scd1 | scd2 | scd3 | scd4 | scd6 | star | fact | scd2-merge | current-view | time-series | audit"
+  ).argument("<name>", "Base object name (e.g. CUSTOMER, ORDERS).").option("--catalog <catalog>", "UC catalog name. Default main.", "main").option("--schema <schema>", "Schema name. Default gold.", "gold").option("-o, --out <path>", "Output directory. Default <kind>-<name>/.").option(
+    "--dims <dims>",
+    "[star|fact] Comma-separated dimension names. Default: customer,product,date.",
+    "customer,product,date"
+  ).option(
+    "--track <cols>",
+    "[scd3|scd6] Comma-separated columns to track previous-values for. Default: attribute_1.",
+    "attribute_1"
+  ).option(
+    "--source <fqn>",
+    "[scd2-merge] Source/staging table fully-qualified name. Default main.gold.<name>_stage."
+  ).option("--retention-days <n>", "[time-series] Retention window in days. Default 90.", "90").action(async (kindArg, nameArg, opts) => {
+    const kind = String(kindArg).toLowerCase();
+    const name = String(nameArg);
+    const catalog = String(opts.catalog);
+    const schema = String(opts.schema);
+    const out = opts.out ? path.resolve(String(opts.out)) : path.resolve(`${kind}-${name.toLowerCase()}`);
+    await fs.mkdir(out, { recursive: true });
+    const ctx = { catalog, schema, name };
+    let files;
+    const trackCols = String(opts.track).split(",").map((s) => s.trim()).filter(Boolean);
+    const dims = String(opts.dims).split(",").map((s) => s.trim()).filter(Boolean);
+    if (kind === "scd1") files = renderScd1(ctx);
+    else if (kind === "scd2") files = renderScd2(ctx);
+    else if (kind === "scd3") files = renderScd3(ctx, trackCols);
+    else if (kind === "scd4") files = renderScd4(ctx);
+    else if (kind === "scd6") files = renderScd6(ctx, trackCols);
+    else if (kind === "star") files = renderStar(ctx, dims);
+    else if (kind === "fact") files = renderFact(ctx, dims);
+    else if (kind === "scd2-merge")
+      files = renderScd2Merge(
+        ctx,
+        opts.source ? String(opts.source) : `${catalog}.${schema}.${name.toLowerCase()}_stage`
+      );
+    else if (kind === "current-view") files = renderCurrentView(ctx);
+    else if (kind === "time-series") files = renderTimeSeries(ctx, Number(opts.retentionDays));
+    else if (kind === "audit") files = renderAudit(ctx);
+    else
+      throw new Error(
+        `Unknown template kind: ${kind}. Use scd1 | scd2 | scd3 | scd4 | scd6 | star | fact | scd2-merge | current-view | time-series | audit.`
+      );
+    for (const [rel, contents] of Object.entries(files)) {
+      const filePath = path.join(out, rel);
+      await fs.mkdir(path.dirname(filePath), { recursive: true });
+      await fs.writeFile(filePath, contents, "utf8");
+      console.error(
+        `  wrote ${path.relative(process.cwd(), filePath)} (${contents.length} bytes)`
+      );
+    }
+    console.error(
+      `Done. ${Object.keys(files).length} file(s) written to ${path.relative(process.cwd(), out)}.`
+    );
+  });
+  return cmd;
+}
+function header(why) {
+  return `-- Generated by \`ddt template\`. Why this pattern is the right shape:
+--   ${why}
+--
+-- Edit freely; this is just a starting point.
+
+`;
+}
+function renderScd1(c) {
+  const lower = c.name.toLowerCase();
+  return {
+    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]: header(
+      `SCD1 overwrites the row in place when an attribute changes. No history is
+--   preserved. Use this when downstream only cares about the *current* state.
+--   load_ts/updated_ts give you minimal auditability without history-table cost.`
+    ) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (
+  ${lower}_sk    BIGINT          GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate key \u2014 stable across overwrites',
+  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key',
+  attribute_1    STRING                                          COMMENT 'Replace with real columns',
+  attribute_2    STRING                                          COMMENT 'Replace with real columns',
+  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'When the row was first inserted',
+  updated_ts     TIMESTAMP                                       COMMENT 'When the row was last overwritten'
+)
+USING DELTA
+CLUSTER BY (${lower}_bk)
+TBLPROPERTIES ('delta.enableDeletionVectors' = 'true')
+COMMENT 'SCD1 dimension \u2014 overwrite-on-change. No history kept; join on ${lower}_bk.';
+`
+  };
+}
+function renderScd2(c) {
+  const lower = c.name.toLowerCase();
+  return {
+    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]: header(
+      `SCD2 preserves every historical version of a row by closing the previous
+--   row's VALID_TO when the natural key reappears with new attribute values.
+--   Use this when downstream analytics needs "what did this row look like on date X".`
+    ) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (
+  ${lower}_sk    BIGINT          GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate key',
+  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key',
+  attribute_1    STRING                                          COMMENT 'Replace with real columns',
+  attribute_2    STRING                                          COMMENT 'Replace with real columns',
+  valid_from     TIMESTAMP       NOT NULL                       COMMENT 'When this version became current',
+  valid_to       TIMESTAMP                                       COMMENT 'When this version was superseded; NULL while current',
+  is_current     BOOLEAN         NOT NULL                       COMMENT 'TRUE only on the latest row per BK',
+  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'Insertion timestamp'
+)
+USING DELTA
+CLUSTER BY (${lower}_bk, valid_from)
+TBLPROPERTIES ('delta.enableDeletionVectors' = 'true')
+COMMENT 'SCD2 dimension \u2014 preserves history. Join on (${lower}_bk, is_current=TRUE) for current state.';
+`
+  };
+}
+function renderScd3(c, tracked) {
+  const lower = c.name.toLowerCase();
+  const cols = (tracked.length ? tracked : ["attribute_1"]).map((t) => t.toLowerCase());
+  const prevCols = cols.map(
+    (t) => `  prev_${t}      STRING                                          COMMENT 'Prior value of ${t}'`
+  ).join(",\n");
+  return {
+    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]: header(
+      `SCD3 keeps the current value plus one prior value per tracked column. Use
+--   this when downstream needs "current vs immediately prior" but doesn't need
+--   the full history. Cheaper than SCD2 but lossy beyond one change.`
+    ) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (
+  ${lower}_sk    BIGINT          GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate key',
+  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key',
+${cols.map((t) => `  ${t}      STRING                                          COMMENT 'Current value'`).join(",\n")},
+${prevCols},
+  prev_changed_ts TIMESTAMP                                      COMMENT 'When prior values were captured',
+  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'Insertion timestamp',
+  updated_ts     TIMESTAMP                                       COMMENT 'When this row was last overwritten'
+)
+USING DELTA
+CLUSTER BY (${lower}_bk)
+TBLPROPERTIES ('delta.enableDeletionVectors' = 'true')
+COMMENT 'SCD3 dimension \u2014 current + one prior value for ${cols.join(", ")}.';
+`
+  };
+}
+function renderScd4(c) {
+  const lower = c.name.toLowerCase();
+  return {
+    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]: header(
+      `SCD4 keeps a small, fast "current" table for joins and a separate history
+--   table for slow analytics. Use this when current-state lookups are hot
+--   (every fact query joins to it) and you want the join table skinny.`
+    ) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (
+  ${lower}_sk    BIGINT          GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate key',
+  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key',
+  attribute_1    STRING                                          COMMENT 'Replace with real columns',
+  attribute_2    STRING                                          COMMENT 'Replace with real columns',
+  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'When the row was inserted',
+  updated_ts     TIMESTAMP                                       COMMENT 'When the row was last overwritten'
+)
+USING DELTA
+CLUSTER BY (${lower}_bk)
+TBLPROPERTIES ('delta.enableDeletionVectors' = 'true')
+COMMENT 'SCD4 current-state table. Pair with ${lower}_history for change tracking.';
+`,
+    [`${c.catalog}/${c.schema}/tables/${lower}_history.sql`]: header(
+      `Companion history table for SCD4. Rows are appended (never updated) when
+--   the current table is overwritten \u2014 same columns plus a changed_ts so you
+--   can replay "what did this BK look like at time T".`
+    ) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower}_history (
+  ${lower}_history_sk BIGINT     GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate id for each historical snapshot',
+  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key',
+  attribute_1    STRING                                          COMMENT 'Snapshot of column at changed_ts',
+  attribute_2    STRING                                          COMMENT 'Snapshot of column at changed_ts',
+  changed_ts     TIMESTAMP       NOT NULL                       COMMENT 'When this snapshot was taken',
+  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'When the row was appended'
+)
+USING DELTA
+CLUSTER BY (${lower}_bk, changed_ts)
+TBLPROPERTIES ('delta.enableDeletionVectors' = 'true', 'delta.enableChangeDataFeed' = 'true')
+COMMENT 'SCD4 history-side. Append-only snapshots of ${lower}; reconstruct as-of state via window functions.';
+`
+  };
+}
+function renderScd6(c, tracked) {
+  const lower = c.name.toLowerCase();
+  const cols = (tracked.length ? tracked : ["attribute_1"]).map((t) => t.toLowerCase());
+  const prevCols = cols.map(
+    (t) => `  prev_${t}      STRING                                          COMMENT 'Prior value of ${t}'`
+  ).join(",\n");
+  return {
+    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]: header(
+      `SCD6 = 1 + 2 + 3 hybrid. Full SCD2 history (rows per version), SCD3
+--   "current vs prior" lookback on hot columns, and SCD1 "current value"
+--   denormalized onto every historical row. Heavyweight; use when downstream
+--   consumers ask both "what was it at time T?" and "what's the current value
+--   for the BK on this old row?" in the same query.`
+    ) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (
+  ${lower}_sk    BIGINT          GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate key \u2014 unique per version',
+  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key \u2014 stable across versions',
+${cols.map((t) => `  ${t}      STRING                                          COMMENT 'Value on THIS version'`).join(",\n")},
+${cols.map((t) => `  current_${t}   STRING                                          COMMENT 'Current value for the BK (SCD1 denorm)'`).join(",\n")},
+${prevCols},
+  valid_from     TIMESTAMP       NOT NULL                       COMMENT 'When this version became current',
+  valid_to       TIMESTAMP                                       COMMENT 'When this version was superseded; NULL while current',
+  is_current     BOOLEAN         NOT NULL                       COMMENT 'TRUE only on the latest row per BK',
+  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'Insertion timestamp'
+)
+USING DELTA
+CLUSTER BY (${lower}_bk, valid_from)
+TBLPROPERTIES ('delta.enableDeletionVectors' = 'true')
+COMMENT 'SCD6 dimension \u2014 hybrid 1+2+3. Heavy but answers every common BI question without re-joining.';
+`
+  };
+}
+function renderStar(c, dims) {
+  const fact = c.name.toLowerCase();
+  const out = {};
+  for (const d of dims) {
+    const lower = d.toLowerCase();
+    out[`${c.catalog}/${c.schema}/tables/dim_${lower}.sql`] = header(`Dimension table \u2014 describes the WHAT. Joined by the fact via dim_${lower}_sk.`) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.dim_${lower} (
+  dim_${lower}_sk  BIGINT          GENERATED ALWAYS AS IDENTITY  COMMENT 'Surrogate key',
+  ${lower}_bk      STRING          NOT NULL                      COMMENT 'Business key',
+  ${lower}_name    STRING                                         COMMENT 'Replace with real attributes',
+  country          STRING                                         COMMENT 'Example attribute'
+)
+USING DELTA
+CLUSTER BY (${lower}_bk)
+TBLPROPERTIES ('delta.enableDeletionVectors' = 'true')
+COMMENT 'Dimension table for the ${fact} star schema.';
+`;
+  }
+  out[`${c.catalog}/${c.schema}/tables/fact_${fact}.sql`] = header(
+    `Fact table \u2014 the WHO/WHAT/WHEN/HOW-MUCH. One row per business event.
+--   Surrogate-key FKs to every dimension; measure columns hold the numbers.
+--   CLUSTER BY (event_ts) keeps recent-event scans cheap (Delta data skipping).`
+  ) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.fact_${fact} (
+  fact_${fact}_sk  BIGINT          GENERATED ALWAYS AS IDENTITY  COMMENT 'Surrogate key',
+${dims.map((d) => `  dim_${d.toLowerCase()}_sk  BIGINT                                          COMMENT 'FK to dim_${d.toLowerCase()}'`).join(",\n")},
+  event_ts         TIMESTAMP       NOT NULL                       COMMENT 'When the event occurred',
+  measure_amount   DECIMAL(38,4)                                   COMMENT 'Primary measure',
+  measure_quantity BIGINT                                          COMMENT 'Secondary measure',
+  load_ts          TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'Insertion timestamp'
+)
+USING DELTA
+CLUSTER BY (event_ts)
+TBLPROPERTIES ('delta.enableDeletionVectors' = 'true', 'delta.enableChangeDataFeed' = 'true')
+COMMENT 'Fact table for the ${fact} star. CLUSTER BY event_ts + Photon = cheap recent-window scans.';
+`;
+  return out;
+}
+function renderFact(c, dims) {
+  const fact = c.name.toLowerCase();
+  return {
+    [`${c.catalog}/${c.schema}/tables/fact_${fact}.sql`]: header(
+      `Fact-only template \u2014 assumes the named dimensions already exist. Use this
+--   when adding a new fact to an existing star, rather than scaffolding the
+--   dims a second time. FKs follow the dim_<name>_sk convention.`
+    ) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.fact_${fact} (
+  fact_${fact}_sk  BIGINT          GENERATED ALWAYS AS IDENTITY  COMMENT 'Surrogate key',
+${dims.map((d) => `  dim_${d.toLowerCase()}_sk  BIGINT                                          COMMENT 'FK to dim_${d.toLowerCase()}'`).join(",\n")},
+  event_ts         TIMESTAMP       NOT NULL                       COMMENT 'When the event occurred',
+  measure_amount   DECIMAL(38,4)                                   COMMENT 'Primary measure',
+  measure_quantity BIGINT                                          COMMENT 'Secondary measure',
+  load_ts          TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'Insertion timestamp'
+)
+USING DELTA
+CLUSTER BY (event_ts)
+TBLPROPERTIES ('delta.enableDeletionVectors' = 'true', 'delta.enableChangeDataFeed' = 'true')
+COMMENT 'Fact table fact_${fact}. Add to an existing star \u2014 dimensions assumed to exist.';
+`
+  };
+}
+function renderScd2Merge(c, source) {
+  const lower = c.name.toLowerCase();
+  return {
+    [`${c.catalog}/${c.schema}/scripts/merge_${lower}.sql`]: header(
+      `Canonical SCD2 load. Step 1 closes the prior row when the BK reappears with
+--   different attributes (sets valid_to + is_current=FALSE). Step 2 inserts the
+--   new version. Both steps in one MERGE WHEN MATCHED / WHEN NOT MATCHED.
+--   Source: ${source}.`
+    ) + `-- Single-statement SCD2 merge.
+-- Databricks MERGE supports multiple WHEN MATCHED clauses \u2014 we use one to close
+-- the old row, then a follow-up INSERT to write the new version (the same MERGE
+-- cannot both UPDATE the prior row AND INSERT the new row for the same source
+-- key, so we split).
+
+MERGE INTO ${c.catalog}.${c.schema}.${lower} AS tgt
+USING (
+  SELECT
+    src.${lower}_bk,
+    src.attribute_1,
+    src.attribute_2
+  FROM ${source} AS src
+) AS src
+ON tgt.${lower}_bk = src.${lower}_bk
+   AND tgt.is_current = TRUE
+WHEN MATCHED
+     AND (NOT (tgt.attribute_1 <=> src.attribute_1)
+       OR NOT (tgt.attribute_2 <=> src.attribute_2))
+  THEN UPDATE SET
+    valid_to   = current_timestamp(),
+    is_current = FALSE;
+
+INSERT INTO ${c.catalog}.${c.schema}.${lower} (
+  ${lower}_bk, attribute_1, attribute_2,
+  valid_from, valid_to, is_current
+)
+SELECT
+  src.${lower}_bk,
+  src.attribute_1,
+  src.attribute_2,
+  current_timestamp(),
+  NULL,
+  TRUE
+FROM ${source} AS src
+LEFT JOIN ${c.catalog}.${c.schema}.${lower} AS tgt
+  ON tgt.${lower}_bk = src.${lower}_bk
+     AND tgt.is_current = TRUE
+WHERE tgt.${lower}_bk IS NULL
+   OR NOT (tgt.attribute_1 <=> src.attribute_1)
+   OR NOT (tgt.attribute_2 <=> src.attribute_2);
+`
+  };
+}
+function renderCurrentView(c) {
+  const lower = c.name.toLowerCase();
+  return {
+    [`${c.catalog}/${c.schema}/views/v_${lower}_current.sql`]: header(
+      `Current-state view over an SCD2 table. Lets downstream consumers join on
+--   one canonical "current row per BK" target without remembering the
+--   is_current predicate. Cheap \u2014 Delta filter-pushdown handles it.`
+    ) + `CREATE OR REPLACE VIEW ${c.catalog}.${c.schema}.v_${lower}_current
+COMMENT 'Current rows from ${lower} (SCD2). Join here instead of filtering is_current manually.'
+AS
+SELECT *
+FROM ${c.catalog}.${c.schema}.${lower}
+WHERE is_current = TRUE;
+`
+  };
+}
+function renderTimeSeries(c, retentionDays) {
+  const lower = c.name.toLowerCase();
+  return {
+    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]: header(
+      `Time-series table \u2014 append-only, clustered by event timestamp so recent-event
+--   scans prune to a small number of files. delta.logRetentionDuration bounds
+--   Time-Travel storage cost; aged-out rows must be archived elsewhere.`
+    ) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (
+  event_id      BIGINT          GENERATED ALWAYS AS IDENTITY  COMMENT 'Surrogate id',
+  event_ts      TIMESTAMP       NOT NULL                       COMMENT 'When the event occurred',
+  event_type    STRING                                          COMMENT 'Discriminator',
+  entity_id     STRING                                          COMMENT 'Foreign key to the entity the event is about',
+  payload       MAP<STRING, STRING>                             COMMENT 'Event-specific payload',
+  ingested_ts   TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'When DDT loaded the row'
+)
+USING DELTA
+CLUSTER BY (event_ts)
+TBLPROPERTIES (
+  'delta.enableDeletionVectors' = 'true',
+  'delta.logRetentionDuration' = 'interval ${Math.max(7, Math.min(retentionDays, 365))} days'
+)
+COMMENT 'Time-series ${lower}. Aged out beyond delta.logRetentionDuration; archive separately if you need longer history.';
+`
+  };
+}
+function renderAudit(c) {
+  const lower = c.name.toLowerCase();
+  return {
+    [`${c.catalog}/${c.schema}/tables/${lower}_audit.sql`]: header(
+      `Audit log \u2014 append-only by convention. INSERT-only role grants enforce the
+--   "append-only" property; this table itself doesn't block updates, but the
+--   grants do.`
+    ) + `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower}_audit (
+  audit_id      BIGINT          GENERATED ALWAYS AS IDENTITY  COMMENT 'Surrogate id',
+  audit_ts      TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'When the event was logged',
+  actor         STRING          NOT NULL                       COMMENT 'Who performed the action',
+  action        STRING          NOT NULL                       COMMENT 'What happened',
+  target        STRING                                          COMMENT 'What it was performed on',
+  details       MAP<STRING, STRING>                             COMMENT 'Free-form payload \u2014 keep it small'
+)
+USING DELTA
+CLUSTER BY (audit_ts)
+TBLPROPERTIES ('delta.enableDeletionVectors' = 'true')
+COMMENT 'Audit log for ${lower}. Append-only by convention \u2014 GRANT INSERT only to writer roles.';
+`
+  };
+}
+export {
+  templateCommand
+};
+//# sourceMappingURL=template-MUJ6X6LN.js.map

package/dist/template-MUJ6X6LN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/template.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { Command } from 'commander';\n\n/**\n * `ddt template <kind> <name>` — schema cookbook generator for\n * Databricks Unity Catalog. Mirrors `sdt template` with idioms\n * adapted to Delta + UC (CLUSTER BY, deletion vectors, Photon, no\n * CONSTRAINT NOT ENFORCED — UC doesn't have that flag).\n *\n * Supported kinds:\n *   - `scd1`         — SCD type-1 (overwrite, no history).\n *   - `scd2`         — SCD type-2 (history-preserving).\n *   - `scd3`         — SCD type-3 (one previous value).\n *   - `scd4`         — SCD type-4 (current + history table).\n *   - `scd6`         — Hybrid 1+2+3.\n *   - `star`         — Star schema fact + N dimensions.\n *   - `fact`         — Fact table only, with FKs to named dims.\n *   - `scd2-merge`   — Canonical MERGE for SCD2 load.\n *   - `current-view` — CREATE VIEW WHERE is_current = TRUE.\n *   - `time-series`  — Clustered time-series with retention.\n *   - `audit`        — Append-only audit log.\n */\nexport function templateCommand(): Command {\n  const cmd = new Command('template');\n  cmd\n    .description(\n      'Scaffold a common schema pattern (scd1|scd2|scd3|scd4|scd6|star|fact|scd2-merge|current-view|time-series|audit). Writes .sql files into <out>/.',\n    )\n    .argument(\n      '<kind>',\n      'Pattern to scaffold: scd1 | scd2 | scd3 | scd4 | scd6 | star | fact | scd2-merge | current-view | time-series | audit',\n    )\n    .argument('<name>', 'Base object name (e.g. CUSTOMER, ORDERS).')\n    .option('--catalog <catalog>', 'UC catalog name. Default main.', 'main')\n    .option('--schema <schema>', 'Schema name. Default gold.', 'gold')\n    .option('-o, --out <path>', 'Output directory. Default <kind>-<name>/.')\n    .option(\n      '--dims <dims>',\n      '[star|fact] Comma-separated dimension names. Default: customer,product,date.',\n      'customer,product,date',\n    )\n    .option(\n      '--track <cols>',\n      '[scd3|scd6] Comma-separated columns to track previous-values for. Default: attribute_1.',\n      'attribute_1',\n    )\n    .option(\n      '--source <fqn>',\n      '[scd2-merge] Source/staging table fully-qualified name. Default main.gold.<name>_stage.',\n    )\n    .option('--retention-days <n>', '[time-series] Retention window in days. Default 90.', '90')\n    .action(async (kindArg, nameArg, opts) => {\n      const kind = String(kindArg).toLowerCase();\n      const name = String(nameArg);\n      const catalog = String(opts.catalog);\n      const schema = String(opts.schema);\n      const out = opts.out\n        ? path.resolve(String(opts.out))\n        : path.resolve(`${kind}-${name.toLowerCase()}`);\n      await fs.mkdir(out, { recursive: true });\n\n      const ctx = { catalog, schema, name };\n      let files: Record<string, string>;\n      const trackCols = String(opts.track)\n        .split(',')\n        .map((s) => s.trim())\n        .filter(Boolean);\n      const dims = String(opts.dims)\n        .split(',')\n        .map((s) => s.trim())\n        .filter(Boolean);\n      if (kind === 'scd1') files = renderScd1(ctx);\n      else if (kind === 'scd2') files = renderScd2(ctx);\n      else if (kind === 'scd3') files = renderScd3(ctx, trackCols);\n      else if (kind === 'scd4') files = renderScd4(ctx);\n      else if (kind === 'scd6') files = renderScd6(ctx, trackCols);\n      else if (kind === 'star') files = renderStar(ctx, dims);\n      else if (kind === 'fact') files = renderFact(ctx, dims);\n      else if (kind === 'scd2-merge')\n        files = renderScd2Merge(\n          ctx,\n          opts.source ? String(opts.source) : `${catalog}.${schema}.${name.toLowerCase()}_stage`,\n        );\n      else if (kind === 'current-view') files = renderCurrentView(ctx);\n      else if (kind === 'time-series') files = renderTimeSeries(ctx, Number(opts.retentionDays));\n      else if (kind === 'audit') files = renderAudit(ctx);\n      else\n        throw new Error(\n          `Unknown template kind: ${kind}. Use scd1 | scd2 | scd3 | scd4 | scd6 | star | fact | scd2-merge | current-view | time-series | audit.`,\n        );\n\n      for (const [rel, contents] of Object.entries(files)) {\n        const filePath = path.join(out, rel);\n        await fs.mkdir(path.dirname(filePath), { recursive: true });\n        await fs.writeFile(filePath, contents, 'utf8');\n        console.error(\n          `  wrote ${path.relative(process.cwd(), filePath)} (${contents.length} bytes)`,\n        );\n      }\n      console.error(\n        `Done. ${Object.keys(files).length} file(s) written to ${path.relative(process.cwd(), out)}.`,\n      );\n    });\n  return cmd;\n}\n\ninterface Ctx {\n  catalog: string;\n  schema: string;\n  name: string;\n}\n\nfunction header(why: string): string {\n  return `-- Generated by \\`ddt template\\`. Why this pattern is the right shape:\\n--   ${why}\\n--\\n-- Edit freely; this is just a starting point.\\n\\n`;\n}\n\nfunction renderScd1(c: Ctx): Record<string, string> {\n  const lower = c.name.toLowerCase();\n  return {\n    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]:\n      header(\n        `SCD1 overwrites the row in place when an attribute changes. No history is\n--   preserved. Use this when downstream only cares about the *current* state.\n--   load_ts/updated_ts give you minimal auditability without history-table cost.`,\n      ) +\n      `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (\n  ${lower}_sk    BIGINT          GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate key — stable across overwrites',\n  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key',\n  attribute_1    STRING                                          COMMENT 'Replace with real columns',\n  attribute_2    STRING                                          COMMENT 'Replace with real columns',\n  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'When the row was first inserted',\n  updated_ts     TIMESTAMP                                       COMMENT 'When the row was last overwritten'\n)\nUSING DELTA\nCLUSTER BY (${lower}_bk)\nTBLPROPERTIES ('delta.enableDeletionVectors' = 'true')\nCOMMENT 'SCD1 dimension — overwrite-on-change. No history kept; join on ${lower}_bk.';\n`,\n  };\n}\n\nfunction renderScd2(c: Ctx): Record<string, string> {\n  const lower = c.name.toLowerCase();\n  return {\n    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]:\n      header(\n        `SCD2 preserves every historical version of a row by closing the previous\n--   row's VALID_TO when the natural key reappears with new attribute values.\n--   Use this when downstream analytics needs \"what did this row look like on date X\".`,\n      ) +\n      `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (\n  ${lower}_sk    BIGINT          GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate key',\n  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key',\n  attribute_1    STRING                                          COMMENT 'Replace with real columns',\n  attribute_2    STRING                                          COMMENT 'Replace with real columns',\n  valid_from     TIMESTAMP       NOT NULL                       COMMENT 'When this version became current',\n  valid_to       TIMESTAMP                                       COMMENT 'When this version was superseded; NULL while current',\n  is_current     BOOLEAN         NOT NULL                       COMMENT 'TRUE only on the latest row per BK',\n  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'Insertion timestamp'\n)\nUSING DELTA\nCLUSTER BY (${lower}_bk, valid_from)\nTBLPROPERTIES ('delta.enableDeletionVectors' = 'true')\nCOMMENT 'SCD2 dimension — preserves history. Join on (${lower}_bk, is_current=TRUE) for current state.';\n`,\n  };\n}\n\nfunction renderScd3(c: Ctx, tracked: string[]): Record<string, string> {\n  const lower = c.name.toLowerCase();\n  const cols = (tracked.length ? tracked : ['attribute_1']).map((t) => t.toLowerCase());\n  const prevCols = cols\n    .map(\n      (t) =>\n        `  prev_${t}      STRING                                          COMMENT 'Prior value of ${t}'`,\n    )\n    .join(',\\n');\n  return {\n    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]:\n      header(\n        `SCD3 keeps the current value plus one prior value per tracked column. Use\n--   this when downstream needs \"current vs immediately prior\" but doesn't need\n--   the full history. Cheaper than SCD2 but lossy beyond one change.`,\n      ) +\n      `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (\n  ${lower}_sk    BIGINT          GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate key',\n  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key',\n${cols.map((t) => `  ${t}      STRING                                          COMMENT 'Current value'`).join(',\\n')},\n${prevCols},\n  prev_changed_ts TIMESTAMP                                      COMMENT 'When prior values were captured',\n  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'Insertion timestamp',\n  updated_ts     TIMESTAMP                                       COMMENT 'When this row was last overwritten'\n)\nUSING DELTA\nCLUSTER BY (${lower}_bk)\nTBLPROPERTIES ('delta.enableDeletionVectors' = 'true')\nCOMMENT 'SCD3 dimension — current + one prior value for ${cols.join(', ')}.';\n`,\n  };\n}\n\nfunction renderScd4(c: Ctx): Record<string, string> {\n  const lower = c.name.toLowerCase();\n  return {\n    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]:\n      header(\n        `SCD4 keeps a small, fast \"current\" table for joins and a separate history\n--   table for slow analytics. Use this when current-state lookups are hot\n--   (every fact query joins to it) and you want the join table skinny.`,\n      ) +\n      `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (\n  ${lower}_sk    BIGINT          GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate key',\n  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key',\n  attribute_1    STRING                                          COMMENT 'Replace with real columns',\n  attribute_2    STRING                                          COMMENT 'Replace with real columns',\n  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'When the row was inserted',\n  updated_ts     TIMESTAMP                                       COMMENT 'When the row was last overwritten'\n)\nUSING DELTA\nCLUSTER BY (${lower}_bk)\nTBLPROPERTIES ('delta.enableDeletionVectors' = 'true')\nCOMMENT 'SCD4 current-state table. Pair with ${lower}_history for change tracking.';\n`,\n    [`${c.catalog}/${c.schema}/tables/${lower}_history.sql`]:\n      header(\n        `Companion history table for SCD4. Rows are appended (never updated) when\n--   the current table is overwritten — same columns plus a changed_ts so you\n--   can replay \"what did this BK look like at time T\".`,\n      ) +\n      `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower}_history (\n  ${lower}_history_sk BIGINT     GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate id for each historical snapshot',\n  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key',\n  attribute_1    STRING                                          COMMENT 'Snapshot of column at changed_ts',\n  attribute_2    STRING                                          COMMENT 'Snapshot of column at changed_ts',\n  changed_ts     TIMESTAMP       NOT NULL                       COMMENT 'When this snapshot was taken',\n  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'When the row was appended'\n)\nUSING DELTA\nCLUSTER BY (${lower}_bk, changed_ts)\nTBLPROPERTIES ('delta.enableDeletionVectors' = 'true', 'delta.enableChangeDataFeed' = 'true')\nCOMMENT 'SCD4 history-side. Append-only snapshots of ${lower}; reconstruct as-of state via window functions.';\n`,\n  };\n}\n\nfunction renderScd6(c: Ctx, tracked: string[]): Record<string, string> {\n  const lower = c.name.toLowerCase();\n  const cols = (tracked.length ? tracked : ['attribute_1']).map((t) => t.toLowerCase());\n  const prevCols = cols\n    .map(\n      (t) =>\n        `  prev_${t}      STRING                                          COMMENT 'Prior value of ${t}'`,\n    )\n    .join(',\\n');\n  return {\n    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]:\n      header(\n        `SCD6 = 1 + 2 + 3 hybrid. Full SCD2 history (rows per version), SCD3\n--   \"current vs prior\" lookback on hot columns, and SCD1 \"current value\"\n--   denormalized onto every historical row. Heavyweight; use when downstream\n--   consumers ask both \"what was it at time T?\" and \"what's the current value\n--   for the BK on this old row?\" in the same query.`,\n      ) +\n      `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (\n  ${lower}_sk    BIGINT          GENERATED ALWAYS AS IDENTITY   COMMENT 'Surrogate key — unique per version',\n  ${lower}_bk    STRING          NOT NULL                       COMMENT 'Business key — stable across versions',\n${cols.map((t) => `  ${t}      STRING                                          COMMENT 'Value on THIS version'`).join(',\\n')},\n${cols.map((t) => `  current_${t}   STRING                                          COMMENT 'Current value for the BK (SCD1 denorm)'`).join(',\\n')},\n${prevCols},\n  valid_from     TIMESTAMP       NOT NULL                       COMMENT 'When this version became current',\n  valid_to       TIMESTAMP                                       COMMENT 'When this version was superseded; NULL while current',\n  is_current     BOOLEAN         NOT NULL                       COMMENT 'TRUE only on the latest row per BK',\n  load_ts        TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'Insertion timestamp'\n)\nUSING DELTA\nCLUSTER BY (${lower}_bk, valid_from)\nTBLPROPERTIES ('delta.enableDeletionVectors' = 'true')\nCOMMENT 'SCD6 dimension — hybrid 1+2+3. Heavy but answers every common BI question without re-joining.';\n`,\n  };\n}\n\nfunction renderStar(c: Ctx, dims: string[]): Record<string, string> {\n  const fact = c.name.toLowerCase();\n  const out: Record<string, string> = {};\n  for (const d of dims) {\n    const lower = d.toLowerCase();\n    out[`${c.catalog}/${c.schema}/tables/dim_${lower}.sql`] =\n      header(`Dimension table — describes the WHAT. Joined by the fact via dim_${lower}_sk.`) +\n      `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.dim_${lower} (\n  dim_${lower}_sk  BIGINT          GENERATED ALWAYS AS IDENTITY  COMMENT 'Surrogate key',\n  ${lower}_bk      STRING          NOT NULL                      COMMENT 'Business key',\n  ${lower}_name    STRING                                         COMMENT 'Replace with real attributes',\n  country          STRING                                         COMMENT 'Example attribute'\n)\nUSING DELTA\nCLUSTER BY (${lower}_bk)\nTBLPROPERTIES ('delta.enableDeletionVectors' = 'true')\nCOMMENT 'Dimension table for the ${fact} star schema.';\n`;\n  }\n  out[`${c.catalog}/${c.schema}/tables/fact_${fact}.sql`] =\n    header(\n      `Fact table — the WHO/WHAT/WHEN/HOW-MUCH. One row per business event.\n--   Surrogate-key FKs to every dimension; measure columns hold the numbers.\n--   CLUSTER BY (event_ts) keeps recent-event scans cheap (Delta data skipping).`,\n    ) +\n    `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.fact_${fact} (\n  fact_${fact}_sk  BIGINT          GENERATED ALWAYS AS IDENTITY  COMMENT 'Surrogate key',\n${dims.map((d) => `  dim_${d.toLowerCase()}_sk  BIGINT                                          COMMENT 'FK to dim_${d.toLowerCase()}'`).join(',\\n')},\n  event_ts         TIMESTAMP       NOT NULL                       COMMENT 'When the event occurred',\n  measure_amount   DECIMAL(38,4)                                   COMMENT 'Primary measure',\n  measure_quantity BIGINT                                          COMMENT 'Secondary measure',\n  load_ts          TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'Insertion timestamp'\n)\nUSING DELTA\nCLUSTER BY (event_ts)\nTBLPROPERTIES ('delta.enableDeletionVectors' = 'true', 'delta.enableChangeDataFeed' = 'true')\nCOMMENT 'Fact table for the ${fact} star. CLUSTER BY event_ts + Photon = cheap recent-window scans.';\n`;\n  return out;\n}\n\nfunction renderFact(c: Ctx, dims: string[]): Record<string, string> {\n  const fact = c.name.toLowerCase();\n  return {\n    [`${c.catalog}/${c.schema}/tables/fact_${fact}.sql`]:\n      header(\n        `Fact-only template — assumes the named dimensions already exist. Use this\n--   when adding a new fact to an existing star, rather than scaffolding the\n--   dims a second time. FKs follow the dim_<name>_sk convention.`,\n      ) +\n      `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.fact_${fact} (\n  fact_${fact}_sk  BIGINT          GENERATED ALWAYS AS IDENTITY  COMMENT 'Surrogate key',\n${dims.map((d) => `  dim_${d.toLowerCase()}_sk  BIGINT                                          COMMENT 'FK to dim_${d.toLowerCase()}'`).join(',\\n')},\n  event_ts         TIMESTAMP       NOT NULL                       COMMENT 'When the event occurred',\n  measure_amount   DECIMAL(38,4)                                   COMMENT 'Primary measure',\n  measure_quantity BIGINT                                          COMMENT 'Secondary measure',\n  load_ts          TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'Insertion timestamp'\n)\nUSING DELTA\nCLUSTER BY (event_ts)\nTBLPROPERTIES ('delta.enableDeletionVectors' = 'true', 'delta.enableChangeDataFeed' = 'true')\nCOMMENT 'Fact table fact_${fact}. Add to an existing star — dimensions assumed to exist.';\n`,\n  };\n}\n\nfunction renderScd2Merge(c: Ctx, source: string): Record<string, string> {\n  const lower = c.name.toLowerCase();\n  return {\n    [`${c.catalog}/${c.schema}/scripts/merge_${lower}.sql`]:\n      header(\n        `Canonical SCD2 load. Step 1 closes the prior row when the BK reappears with\n--   different attributes (sets valid_to + is_current=FALSE). Step 2 inserts the\n--   new version. Both steps in one MERGE WHEN MATCHED / WHEN NOT MATCHED.\n--   Source: ${source}.`,\n      ) +\n      `-- Single-statement SCD2 merge.\n-- Databricks MERGE supports multiple WHEN MATCHED clauses — we use one to close\n-- the old row, then a follow-up INSERT to write the new version (the same MERGE\n-- cannot both UPDATE the prior row AND INSERT the new row for the same source\n-- key, so we split).\n\nMERGE INTO ${c.catalog}.${c.schema}.${lower} AS tgt\nUSING (\n  SELECT\n    src.${lower}_bk,\n    src.attribute_1,\n    src.attribute_2\n  FROM ${source} AS src\n) AS src\nON tgt.${lower}_bk = src.${lower}_bk\n   AND tgt.is_current = TRUE\nWHEN MATCHED\n     AND (NOT (tgt.attribute_1 <=> src.attribute_1)\n       OR NOT (tgt.attribute_2 <=> src.attribute_2))\n  THEN UPDATE SET\n    valid_to   = current_timestamp(),\n    is_current = FALSE;\n\nINSERT INTO ${c.catalog}.${c.schema}.${lower} (\n  ${lower}_bk, attribute_1, attribute_2,\n  valid_from, valid_to, is_current\n)\nSELECT\n  src.${lower}_bk,\n  src.attribute_1,\n  src.attribute_2,\n  current_timestamp(),\n  NULL,\n  TRUE\nFROM ${source} AS src\nLEFT JOIN ${c.catalog}.${c.schema}.${lower} AS tgt\n  ON tgt.${lower}_bk = src.${lower}_bk\n     AND tgt.is_current = TRUE\nWHERE tgt.${lower}_bk IS NULL\n   OR NOT (tgt.attribute_1 <=> src.attribute_1)\n   OR NOT (tgt.attribute_2 <=> src.attribute_2);\n`,\n  };\n}\n\nfunction renderCurrentView(c: Ctx): Record<string, string> {\n  const lower = c.name.toLowerCase();\n  return {\n    [`${c.catalog}/${c.schema}/views/v_${lower}_current.sql`]:\n      header(\n        `Current-state view over an SCD2 table. Lets downstream consumers join on\n--   one canonical \"current row per BK\" target without remembering the\n--   is_current predicate. Cheap — Delta filter-pushdown handles it.`,\n      ) +\n      `CREATE OR REPLACE VIEW ${c.catalog}.${c.schema}.v_${lower}_current\nCOMMENT 'Current rows from ${lower} (SCD2). Join here instead of filtering is_current manually.'\nAS\nSELECT *\nFROM ${c.catalog}.${c.schema}.${lower}\nWHERE is_current = TRUE;\n`,\n  };\n}\n\nfunction renderTimeSeries(c: Ctx, retentionDays: number): Record<string, string> {\n  const lower = c.name.toLowerCase();\n  return {\n    [`${c.catalog}/${c.schema}/tables/${lower}.sql`]:\n      header(\n        `Time-series table — append-only, clustered by event timestamp so recent-event\n--   scans prune to a small number of files. delta.logRetentionDuration bounds\n--   Time-Travel storage cost; aged-out rows must be archived elsewhere.`,\n      ) +\n      `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower} (\n  event_id      BIGINT          GENERATED ALWAYS AS IDENTITY  COMMENT 'Surrogate id',\n  event_ts      TIMESTAMP       NOT NULL                       COMMENT 'When the event occurred',\n  event_type    STRING                                          COMMENT 'Discriminator',\n  entity_id     STRING                                          COMMENT 'Foreign key to the entity the event is about',\n  payload       MAP<STRING, STRING>                             COMMENT 'Event-specific payload',\n  ingested_ts   TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'When DDT loaded the row'\n)\nUSING DELTA\nCLUSTER BY (event_ts)\nTBLPROPERTIES (\n  'delta.enableDeletionVectors' = 'true',\n  'delta.logRetentionDuration' = 'interval ${Math.max(7, Math.min(retentionDays, 365))} days'\n)\nCOMMENT 'Time-series ${lower}. Aged out beyond delta.logRetentionDuration; archive separately if you need longer history.';\n`,\n  };\n}\n\nfunction renderAudit(c: Ctx): Record<string, string> {\n  const lower = c.name.toLowerCase();\n  return {\n    [`${c.catalog}/${c.schema}/tables/${lower}_audit.sql`]:\n      header(\n        `Audit log — append-only by convention. INSERT-only role grants enforce the\n--   \"append-only\" property; this table itself doesn't block updates, but the\n--   grants do.`,\n      ) +\n      `CREATE OR REPLACE TABLE ${c.catalog}.${c.schema}.${lower}_audit (\n  audit_id      BIGINT          GENERATED ALWAYS AS IDENTITY  COMMENT 'Surrogate id',\n  audit_ts      TIMESTAMP       NOT NULL DEFAULT current_timestamp() COMMENT 'When the event was logged',\n  actor         STRING          NOT NULL                       COMMENT 'Who performed the action',\n  action        STRING          NOT NULL                       COMMENT 'What happened',\n  target        STRING                                          COMMENT 'What it was performed on',\n  details       MAP<STRING, STRING>                             COMMENT 'Free-form payload — keep it small'\n)\nUSING DELTA\nCLUSTER BY (audit_ts)\nTBLPROPERTIES ('delta.enableDeletionVectors' = 'true')\nCOMMENT 'Audit log for ${lower}. Append-only by convention — GRANT INSERT only to writer roles.';\n`,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/test-XFSQHR2S.js

@@ -0,0 +1,169 @@
+import "./chunk-DGUM43GV.js";
+
+// src/commands/test.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { Command } from "commander";
+import {
+  loadProject,
+  parseProjectModel,
+  testFramework,
+  createConnection,
+  getProfile
+} from "@ddt-tools/core";
+function testCommand() {
+  const cmd = new Command("test").description(
+    "Declarative tests (unique / not_null / accepted_values / relationships / expression) compiled from YAML to SQL."
+  );
+  cmd.command("list").description("Enumerate test files and their test counts.").requiredOption("-p, --project <path>", "Path to the .ddtproj file.").action(async (opts) => {
+    const loaded = await loadProject(String(opts.project));
+    const files = await testFramework.discoverTests(loaded.rootDir);
+    if (files.length === 0) {
+      console.log(
+        "No tests found. Add files under <project>/tests/<catalog>/<schema>/<table>.test.yaml."
+      );
+      return;
+    }
+    for (const f of files) {
+      console.log(`  ${f.fqn.padEnd(40)} ${String(f.tests.length).padStart(3)} test(s)`);
+      for (const t of f.tests) {
+        const cols = "columns" in t ? `(${(t.columns ?? []).join(", ")})` : "column" in t ? `(${t.column})` : "";
+        console.log(`    - ${t.kind}${cols}${t.name ? ` ${t.name}` : ""}`);
+      }
+    }
+    console.log("");
+    console.log(
+      `${files.length} file(s), ${files.reduce((acc, f) => acc + f.tests.length, 0)} test(s) total.`
+    );
+  });
+  cmd.command("render").description("Compile every test YAML into SQL assertions. Offline; no workspace contact.").requiredOption("-p, --project <path>", "Path to the .ddtproj file.").option("-o, --out <path>", "Write to file. Defaults to stdout.").action(async (opts) => {
+    const loaded = await loadProject(String(opts.project));
+    const files = await testFramework.discoverTests(loaded.rootDir);
+    const sql = testFramework.renderAllTests(files);
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, sql, "utf8");
+      console.error(
+        `Wrote ${out} (${sql.length} bytes, ${files.reduce((a, f) => a + f.tests.length, 0)} test(s)).`
+      );
+    } else {
+      process.stdout.write(sql);
+    }
+  });
+  cmd.command("run").description(
+    "Execute every test assertion against a live Databricks workspace and report pass/fail. Exits 2 when any error-severity test fails. Pro tier \u2014 composes DCM item 5 (data-quality expectations) with the existing dbt-test parity framework."
+  ).requiredOption("-p, --project <path>", "Path to the .ddtproj file.").requiredOption("-c, --connection <profile>", "Connection profile name.").option(
+    "--select <pattern>",
+    'Filter tests to files whose FQN matches a glob pattern. E.g. "main.public.*".'
+  ).option("--fail-fast", "Stop on the first error-severity failure.", false).option(
+    "--sample <n>",
+    "Cap failing-row samples captured per test. Default 10. 0 to skip.",
+    "10"
+  ).option(
+    "--update-snapshots",
+    "TEST.3: overwrite every saved snapshot under .ddt/tests/__snapshots__/ with the live rows. Use when intentional schema change makes drift expected.",
+    false
+  ).option("--format <fmt>", "Output format: text | json. Default text.", "text").option("-o, --out <path>", "Write report to a file instead of stdout.").action(async (opts) => {
+    const loaded = await loadProject(String(opts.project));
+    let files = await testFramework.discoverTests(loaded.rootDir);
+    if (opts.select) {
+      const re = globToRegex(String(opts.select));
+      files = files.filter((f) => re.test(f.fqn));
+    }
+    if (files.length === 0) {
+      console.log(
+        "No tests found. Add files under <project>/tests/<catalog>/<schema>/<table>.test.yaml."
+      );
+      return;
+    }
+    const profile = await getProfile(String(opts.connection));
+    const conn = createConnection(profile);
+    console.error(`test run: connecting to ${profile.auth.host}\u2026`);
+    await conn.connect();
+    const snapshotsDir = path.join(loaded.rootDir, ".ddt", "tests", "__snapshots__");
+    const snapshotStorage = {
+      async read(name) {
+        try {
+          return await fs.readFile(path.join(snapshotsDir, `${name}.json`), "utf8");
+        } catch (e) {
+          if (e.code === "ENOENT") return null;
+          throw e;
+        }
+      },
+      async write(name, body) {
+        await fs.mkdir(snapshotsDir, { recursive: true });
+        await fs.writeFile(path.join(snapshotsDir, `${name}.json`), body, "utf8");
+      }
+    };
+    let report;
+    try {
+      report = await testFramework.runTestFiles(files, conn, {
+        failFast: opts.failFast === true,
+        failingRowSampleCap: Number(opts.sample ?? "10"),
+        snapshotStorage,
+        updateSnapshots: opts.updateSnapshots === true
+      });
+    } finally {
+      await conn.disconnect().catch(() => void 0);
+    }
+    const output = String(opts.format).toLowerCase() === "json" ? testFramework.renderJsonReport(report) : testFramework.renderTextReport(report);
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, output, "utf8");
+      console.error(
+        `Wrote ${out} \u2014 ${report.summary.pass} pass / ${report.summary.fail} fail / ${report.summary.error} error.`
+      );
+    } else {
+      process.stdout.write(output);
+    }
+    if (report.summary.blocking) {
+      process.exitCode = 2;
+    }
+  });
+  cmd.command("coverage").description(
+    "Report which project objects have at least one declarative test (TEST.4). Offline; no workspace contact. Emits a Markdown table (default) or JSON."
+  ).requiredOption("-p, --project <path>", "Path to the .ddtproj file.").option("--format <fmt>", "Output format: text | json. Default text.", "text").option("-o, --out <path>", "Write report to a file instead of stdout.").action(async (opts) => {
+    const loaded = await loadProject(String(opts.project));
+    const files = await testFramework.discoverTests(loaded.rootDir);
+    const model = await parseProjectModel(loaded);
+    const testable = /* @__PURE__ */ new Set([
+      "TABLE",
+      "MANAGED_TABLE",
+      "EXTERNAL_TABLE",
+      "VIEW",
+      "MATERIALIZED_VIEW",
+      "STREAMING_TABLE"
+    ]);
+    const fqns = [];
+    for (const obj of model) {
+      if (!testable.has(obj.objectType)) continue;
+      const cat = obj.fqn.database;
+      const sc = obj.fqn.schema;
+      if (!cat || !sc) continue;
+      fqns.push(`${cat}.${sc}.${obj.fqn.name}`);
+    }
+    const report = testFramework.computeTestCoverage(files, fqns);
+    const output = String(opts.format).toLowerCase() === "json" ? testFramework.renderTestCoverageJson(report) : testFramework.renderTestCoverageMarkdown(report);
+    if (opts.out) {
+      const out = path.resolve(String(opts.out));
+      await fs.mkdir(path.dirname(out), { recursive: true });
+      await fs.writeFile(out, output, "utf8");
+      console.error(
+        `Wrote ${out} \u2014 ${report.withTests}/${report.total} object(s) covered (${report.coveragePct}%).`
+      );
+    } else {
+      process.stdout.write(output + "\n");
+    }
+  });
+  return cmd;
+}
+function globToRegex(pattern) {
+  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+  return new RegExp(`^${escaped}$`, "i");
+}
+export {
+  testCommand
+};
+//# sourceMappingURL=test-XFSQHR2S.js.map