@abloatai/cli 0.54.0 → 0.55.0

package/dist/cli.cjs

@@ -3970,7 +3970,7 @@ var init_observeCliError = __esm({
     import_errorObservation = require("@abloatai/transaction/errorObservation");
     import_errors5 = require("@abloatai/transaction/errors");
     dsn = process.env.ABLO_CLI_SENTRY_DSN ?? "https://1ac154bff10b06836e1ea9de9e0d92f0@o4510928209772544.ingest.de.sentry.io/4511660691423312" ?? "";
-    release = process.env.ABLO_CLI_RELEASE ?? "@abloatai/cli@0.54.0";
+    release = process.env.ABLO_CLI_RELEASE ?? "@abloatai/cli@0.55.0";
     initialized = false;
     nativeProcessExit = process.exit.bind(process);
     exitBoundaryInstalled = false;
@@ -4297,7 +4297,7 @@ var init_src2 = __esm({
 
 // src/cliEnvironment.ts
 function cliVersion() {
-  return "0.54.0";
+  return "0.55.0";
 }
 function cliOs() {
   const value = (0, import_node_os.platform)();
@@ -5968,6 +5968,28 @@ async function fetchPushedSchema(apiUrl3, apiKey) {
     clearTimeout(t);
   }
 }
+async function fetchDeliveryState(apiUrl3, apiKey, timeoutMs = 4e3) {
+  if (!apiKey) return { kind: "unknown", detail: "no key" };
+  const ctrl = new AbortController();
+  const t = setTimeout(() => {
+    ctrl.abort();
+  }, timeoutMs);
+  try {
+    const res = await fetch(`${apiUrl3}/api/v1/logs/delivery`, {
+      headers: { authorization: `Bearer ${apiKey}` },
+      signal: ctrl.signal
+    });
+    if (!res.ok) return { kind: "unknown", detail: `HTTP ${res.status}` };
+    const parsed = import_wire5.logDeliveryResponseSchema.safeParse(await res.json());
+    if (!parsed.success) return { kind: "unknown", detail: "unrecognized response" };
+    const { window_seconds, recorded, unroutable, sample } = parsed.data;
+    return { kind: "known", window_seconds, recorded, unroutable, sample: sample ?? null };
+  } catch {
+    return { kind: "unknown", detail: "unreachable" };
+  } finally {
+    clearTimeout(t);
+  }
+}
 async function fetchDataSourceState(apiUrl3, apiKey, timeoutMs = 4e3) {
   if (!apiKey) return { kind: "unknown", detail: "no key" };
   const ctrl = new AbortController();
@@ -6069,7 +6091,7 @@ function blockers(input) {
   }
   return found;
 }
-var import_wire5, import_schema4;
+var import_wire5, import_schema4, WRITE_READY_VERDICT;
 var init_readiness = __esm({
   "src/readiness.ts"() {
     "use strict";
@@ -6079,6 +6101,7 @@ var init_readiness = __esm({
     init_dbProvider();
     init_remoteValidation();
     import_schema4 = require("@abloatai/transaction/schema");
+    WRITE_READY_VERDICT = "write infrastructure is ready. Your database constraints and row-level policies still apply.";
   }
 });
 
@@ -285430,6 +285453,14 @@ function render(check2) {
   );
   if (check2.fix) console.log(`    ${" ".repeat(11)}${import_picocolors18.default.dim(`\u2192 ${check2.fix}`)}`);
 }
+function windowWords(seconds) {
+  if (seconds % 3600 === 0) {
+    const hours = seconds / 3600;
+    return hours === 1 ? "the last hour" : `the last ${hours} hours`;
+  }
+  const minutes = Math.max(1, Math.round(seconds / 60));
+  return minutes === 1 ? "the last minute" : `the last ${minutes} minutes`;
+}
 async function ping(apiUrl3) {
   const ctrl = new AbortController();
   const t = setTimeout(() => {
@@ -285572,6 +285603,24 @@ async function inspectDoctor(options = {}) {
   } else {
     checks.push({ label: "database", state: "skip", detail: "nothing connected to check" });
   }
+  const delivery = reachable ? await fetchDeliveryState(apiUrl3, runtimeKey.key) : { kind: "unknown", detail: "unreachable" };
+  if (delivery.kind === "known") {
+    const when = windowWords(delivery.window_seconds);
+    checks.push(
+      delivery.unroutable > 0 ? {
+        label: "delivery",
+        state: "fail",
+        detail: `${delivery.unroutable} of ${delivery.recorded} change${delivery.recorded === 1 ? "" : "s"} in ${when} reached nobody` + (delivery.sample ? ` (e.g. ${delivery.sample.model}/${delivery.sample.id})` : ""),
+        fix: "run `ablo check`. Rows written to Postgres outside Ablo carry no tenancy value, so nothing can route the change."
+      } : {
+        label: "delivery",
+        state: "ok",
+        detail: delivery.recorded === 0 ? `no changes in ${when}` : `${delivery.recorded} change${delivery.recorded === 1 ? "" : "s"} in ${when}, all deliverable`
+      }
+    );
+  } else {
+    checks.push({ label: "delivery", state: "skip", detail: `not determined (${delivery.detail})` });
+  }
   const blocking = blockers({
     reachable,
     hasKey: Boolean(runtimeKey.key),
@@ -285592,7 +285641,8 @@ async function inspectDoctor(options = {}) {
     target,
     dataSource,
     pushedSchema: pushed,
-    schemaDrift: drift
+    schemaDrift: drift,
+    delivery
   };
 }
 function renderDoctorReport(report) {
@@ -285614,7 +285664,7 @@ function renderDoctorReport(report) {
     );
   } else {
     console.log(
-      `  ${import_picocolors18.default.green("\u2713")} ${import_picocolors18.default.dim("write infrastructure is ready \u2014 your database constraints and row-level policies still apply")}`
+      `  ${import_picocolors18.default.green("\u2713")} ${import_picocolors18.default.dim(WRITE_READY_VERDICT)}`
     );
   }
   console.log();
@@ -288136,7 +288186,7 @@ async function status(args = []) {
     );
   } else {
     console.log(
-      `  ${import_picocolors22.default.green("\u2713")} ${import_picocolors22.default.dim("write infrastructure is ready \u2014 database constraints and row-level policies still apply")}`
+      `  ${import_picocolors22.default.green("\u2713")} ${import_picocolors22.default.dim(WRITE_READY_VERDICT)}`
     );
   }
   console.log();
@@ -288623,6 +288673,24 @@ function parseCheckArgs(argv) {
   }
   return { schemaPath, exportName, appSchema };
 }
+function quoteIdent2(raw) {
+  return `"${raw.replace(/"/g, '""')}"`;
+}
+var UNSTAMPED_CAP = 500;
+async function countUnstamped(sql, appSchema, table, column) {
+  try {
+    const rows = await sql.unsafe(
+      `SELECT count(*)::int AS n FROM (
+         SELECT 1 FROM ${quoteIdent2(appSchema)}.${quoteIdent2(table)}
+         WHERE ${quoteIdent2(column)} IS NULL
+         LIMIT ${UNSTAMPED_CAP + 1}
+       ) s`
+    );
+    return rows[0]?.n ?? 0;
+  } catch {
+    return null;
+  }
+}
 function hostOf(connectionString) {
   try {
     return new URL(connectionString).hostname || null;
@@ -288700,7 +288768,6 @@ async function check(argv) {
     await sql.end({ timeout: 2 });
     process.exit(1);
   }
-  await sql.end({ timeout: 2 });
   const colsByTable = /* @__PURE__ */ new Map();
   for (const r2 of rows) {
     let set = colsByTable.get(r2.table_name);
@@ -288739,6 +288806,15 @@ async function check(argv) {
       if (BASE_COLUMNS.has(col) || col === orgCol) continue;
       if (!present.has(col)) problems.push(`missing column "${col}" (field ${fieldName})`);
     }
+    if (orgCol && present.has(orgCol)) {
+      const unstamped = await countUnstamped(sql, args.appSchema, table, orgCol);
+      if (unstamped !== null && unstamped > 0) {
+        const count = unstamped > UNSTAMPED_CAP ? `${UNSTAMPED_CAP}+ rows` : `${unstamped} row${unstamped === 1 ? "" : "s"}`;
+        problems.push(
+          `${count} have no "${orgCol}", so nothing can route them. Ablo stamps it on writes it makes; an insert straight into Postgres does not. Backfill the value, then run \`ablo connect resnapshot\`.`
+        );
+      }
+    }
     if (problems.length > 0) {
       console.log(`  ${import_picocolors25.default.red("\u2717")} ${import_picocolors25.default.bold(key)} ${import_picocolors25.default.dim("\u2192")} ${table}`);
       for (const p2 of problems) console.log(`      ${import_picocolors25.default.red("\u2022")} ${p2}`);
@@ -288752,6 +288828,7 @@ async function check(argv) {
       console.log(`  ${import_picocolors25.default.green("\u2713")} ${import_picocolors25.default.bold(key)} ${import_picocolors25.default.dim(`\u2192 ${table} (id, ${orgCol ?? "no org"} ok)`)}`);
     }
   }
+  await sql.end({ timeout: 2 });
   const modelCount = Object.keys(schemaJson.models).length;
   const ignored = [...colsByTable.keys()].filter((t) => !declaredTables.has(t)).length;
   console.log(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abloatai/cli",
-  "version": "0.54.0",
+  "version": "0.55.0",
   "description": "The ablo command line: set up Ablo, connect your database, and push your schema from the terminal.",
   "license": "Apache-2.0",
   "type": "module",
@@ -35,10 +35,10 @@
   },
   "dependencies": {
     "@sentry/node": "^10.18.0",
-    "@abloatai/transaction": "^0.54.0",
+    "@abloatai/transaction": "^0.55.0",
     "jiti": "^2.7.0",
     "zod": "^4.4.3",
-    "@abloatai/humans": "^0.54.0"
+    "@abloatai/humans": "^0.55.0"
   },
   "devDependencies": {
     "@ablo/product-analytics": "file:../product-analytics",