@abloatai/cli 0.45.0 → 0.46.0

package/dist/cli.cjs

@@ -4538,6 +4538,7 @@ async function requestRemoteValidation(input) {
     ok: true,
     reachable: verdict.reachable,
     ready: verdict.ready,
+    ...verdict.initial_snapshot !== void 0 ? { initialSnapshot: verdict.initial_snapshot } : {},
     ...verdict.reason !== void 0 ? { reason: verdict.reason } : {},
     failures: verdict.failures
   };
@@ -4565,7 +4566,10 @@ var init_remoteValidation = __esm({
       wal_level: () => `your database isn't set up to share changes as they happen yet`,
       publication: () => `none of your tables are shared with Ablo yet`,
       replication_role: () => `the login Ablo reads with can't follow your changes yet`,
-      replica_identity: (f) => withActual(`some shared tables don't record enough for Ablo to track edits and deletes`, f.actual),
+      replica_identity: (f) => withActual(
+        `some shared tables don't record enough for Ablo to track edits and deletes`,
+        f.actual
+      ),
       table_select: (f) => withActual(`the login Ablo reads with can't read some shared tables`, f.actual),
       write_role: () => `the login Ablo writes with isn't set up yet`,
       row_security: () => `the writer login isn't set to honor your row-level security`,
@@ -4911,7 +4915,8 @@ async function registerDirectDataSource(opts) {
       `
   ${import_picocolors7.default.green("\u2713")} Registered${body.host ? ` ${import_picocolors7.default.dim(body.host)}` : ""}${body.id ? ` ${import_picocolors7.default.dim(`(${body.id})`)}` : ""} as a direct DataSource (${statusNote}).
   Your database is connected. Reads follow its replication stream; writes go through Ablo
-  and land in your own tables. Check the connection anytime with ${import_picocolors7.default.cyan("ablo connect check")}.
+  and land in your own tables. Rows that already exist load automatically \u2014 no manual
+  backfill or row updates. Check their progress with ${import_picocolors7.default.cyan("ablo connect check")}.
 `
     );
     return true;
@@ -6525,10 +6530,9 @@ async function auditTenantSyncInfra(sql) {
   const artifacts = [];
   for (const artifact of import_footprint2.ABLO_FOOTPRINT) {
     const key = artifact.kind === "table" || artifact.kind === "type" ? `public.${artifact.name}` : artifact.name;
-    const rows = await sql.unsafe(
-      FOOTPRINT_LOOKUP[artifact.kind],
-      [key]
-    );
+    const rows = await sql.unsafe(FOOTPRINT_LOOKUP[artifact.kind], [
+      key
+    ]);
     artifacts.push({
       kind: artifact.kind,
       name: artifact.name,
@@ -6637,6 +6641,22 @@ ${ambient}` : ""}`,
     const { label, fix } = describeRemoteFailure(failure);
     printCheckItem({ ok: false, label, fix });
   }
+  if (result.initialSnapshot?.status === "complete") {
+    printCheckItem({ ok: true, label: "Rows that existed before connecting are loaded" });
+  } else if (result.initialSnapshot?.status === "loading") {
+    printCheckItem({
+      ok: false,
+      label: "Rows that existed before connecting are still loading",
+      fix: "No SQL or row-touch script is needed. Ablo snapshots published tables automatically; wait a moment, then rerun `ablo connect check`."
+    });
+  } else if (result.initialSnapshot?.status === "retrying") {
+    printCheckItem({
+      ok: false,
+      label: "Loading existing rows hit an error and Ablo is retrying",
+      fix: `${result.initialSnapshot.detail ?? "The replication worker reported an error."}
+No row updates are needed. Fix the reported connection or database issue, then rerun \`ablo connect check\`.`
+    });
+  }
   console.log();
   if (result.ready) {
     console.log(
@@ -6645,6 +6665,13 @@ ${ambient}` : ""}`,
     );
     process.exit(0);
   }
+  if ((result.initialSnapshot?.status === "loading" || result.initialSnapshot?.status === "retrying") && result.failures.length === 0) {
+    console.log(
+      `  ${import_picocolors12.default.yellow("\u2014")} Not ready yet ${import_picocolors12.default.dim(`\u2014 Ablo is loading existing rows. Re-run ${import_picocolors12.default.bold("ablo connect check")} shortly.`)}
+`
+    );
+    process.exit(1);
+  }
   const count = result.failures.length;
   console.log(
     `  ${import_picocolors12.default.red(`${count} item${count === 1 ? "" : "s"} to fix`)} ${import_picocolors12.default.dim(`\u2014 apply the fixes above, then re-run ${import_picocolors12.default.bold("ablo connect check")}.`)}
@@ -284738,7 +284765,9 @@ async function ping(apiUrl3) {
 }
 function formatConflict(conflict) {
   if (!conflict) return "";
-  const parts = import_schema8.participantKindSchema.options.flatMap((k3) => conflict[k3] ? [`${k3}:${conflict[k3]}`] : []);
+  const parts = import_schema8.participantKindSchema.options.flatMap(
+    (k3) => conflict[k3] ? [`${k3}:${conflict[k3]}`] : []
+  );
   return parts.length ? `{${parts.join(",")}}` : "";
 }
 function printTargetLines(target, localProject, storedOrganizationId, storedOrganizationSlug) {
@@ -284783,13 +284812,21 @@ async function status(args = []) {
   const cfg = readConfig();
   const mode = getMode();
   const runtimeKey = resolveRuntimeApiKey();
-  const target = runtimeKey.key ? await resolveTarget({ url: apiUrl3, apiKey: runtimeKey.key, keySource: runtimeKey.source ?? "stored" }) : null;
+  const target = runtimeKey.key ? await resolveTarget({
+    url: apiUrl3,
+    apiKey: runtimeKey.key,
+    keySource: runtimeKey.source ?? "stored"
+  }) : null;
   if (args.includes("--json")) {
     const entry = getKeyEntry(mode);
     const activeProject2 = getActiveProject();
     const pushed2 = await fetchPushedSchema(apiUrl3, runtimeKey.key);
     const reachableForJson = await ping(apiUrl3);
-    const dataSource2 = reachableForJson ? (await fetchRoutingState(apiUrl3, runtimeKey.key)).source : { kind: "unknown", detail: "unreachable" };
+    const routingForJson = reachableForJson ? await fetchRoutingState(apiUrl3, runtimeKey.key) : {
+      source: { kind: "unknown", detail: "unreachable" },
+      validation: null
+    };
+    const dataSource2 = routingForJson.source;
     const driftForJson = schemaDrift(await readLocalSchemaHash(), pushed2?.hash);
     const out = {
       // The locally-active project (`ablo projects use`); null = org-default.
@@ -284835,6 +284872,10 @@ async function status(args = []) {
       // form of the human verdict: a caller can gate on it in CI rather than
       // discovering the same facts from a failed request later.
       dataSource: dataSource2,
+      // Existing rows are copied into Ablo automatically after a direct source
+      // is connected. Agents can gate a read cutover on this field instead of
+      // probing for one row or inventing a row-touch backfill.
+      initialSnapshot: routingForJson.validation?.ok === true ? routingForJson.validation.initialSnapshot ?? null : null,
       drift: driftForJson,
       blockers: blockers({
         reachable: reachableForJson,
@@ -284868,7 +284909,9 @@ async function status(args = []) {
   );
   const management = getManagementKeyEntry();
   console.log(
-    `  ${import_picocolors19.default.dim("\u25CB")} ${"management".padEnd(12)}  ${management ? import_picocolors19.default.dim(`${management.apiKey.slice(0, 12)}\u2026${management.expiresAt ? ` \xB7 ${expiryLabel(management.expiresAt)}` : ""}`) : import_picocolors19.default.dim("\u2014 no key")}`
+    `  ${import_picocolors19.default.dim("\u25CB")} ${"management".padEnd(12)}  ${management ? import_picocolors19.default.dim(
+      `${management.apiKey.slice(0, 12)}\u2026${management.expiresAt ? ` \xB7 ${expiryLabel(management.expiresAt)}` : ""}`
+    ) : import_picocolors19.default.dim("\u2014 no key")}`
   );
   for (const { key: m2, label } of [
     { key: "sandbox", label: "legacy child" },
@@ -284901,7 +284944,9 @@ async function status(args = []) {
     const how = [...new Set(dataSource.connections)].join(" + ");
     const pooled = detectPoolerIn(dataSource.hosts);
     const unreachable = validation && !validation.ok ? validation.message : void 0;
-    console.log(`  ${import_picocolors19.default.dim("data")}    ${import_picocolors19.default.green("\u2713")} ${import_picocolors19.default.dim(`database connected to this plane (${how})`)}`);
+    console.log(
+      `  ${import_picocolors19.default.dim("data")}    ${import_picocolors19.default.green("\u2713")} ${import_picocolors19.default.dim(`database connected to this plane (${how})`)}`
+    );
     if (pooled) {
       console.log(
         `          ${import_picocolors19.default.yellow("\u26A0")} ${import_picocolors19.default.dim(
@@ -284912,12 +284957,27 @@ async function status(args = []) {
     if (unreachable) {
       console.log(`          ${import_picocolors19.default.red("\u2717")} ${import_picocolors19.default.dim(`Ablo could not reach it \u2014 ${unreachable}`)}`);
     }
+    if (validation?.ok && validation.initialSnapshot?.status === "loading") {
+      console.log(
+        `          ${import_picocolors19.default.yellow("\u25CC")} ${import_picocolors19.default.dim(
+          `loading rows that predate the connection \u2014 automatic; check with ${import_picocolors19.default.bold("ablo connect check")}`
+        )}`
+      );
+    } else if (validation?.ok && validation.initialSnapshot?.status === "retrying") {
+      console.log(
+        `          ${import_picocolors19.default.red("\u2717")} ${import_picocolors19.default.dim(
+          `loading existing rows is retrying${validation.initialSnapshot.detail ? ` \u2014 ${validation.initialSnapshot.detail}` : ""}`
+        )}`
+      );
+    }
   } else if (dataSource.kind === "none") {
     console.log(
       `  ${import_picocolors19.default.dim("data")}    ${import_picocolors19.default.red("\u2717 no database connected to this plane")} ${import_picocolors19.default.dim("\u2014 writes are held")}`
     );
   } else if (reachable) {
-    console.log(`  ${import_picocolors19.default.dim("data")}    ${import_picocolors19.default.yellow("?")} ${import_picocolors19.default.dim(`could not read the plane's databases (${dataSource.detail})`)}`);
+    console.log(
+      `  ${import_picocolors19.default.dim("data")}    ${import_picocolors19.default.yellow("?")} ${import_picocolors19.default.dim(`could not read the plane's databases (${dataSource.detail})`)}`
+    );
   }
   const pushed = reachable ? await fetchPushedSchema(apiUrl3, introspectKey) : null;
   if (reachable) {
@@ -284925,7 +284985,9 @@ async function status(args = []) {
       const when = pushed.pushedAt ? ` ${import_picocolors19.default.dim(`@ ${pushed.pushedAt.slice(0, 10)}`)}` : "";
       const ver = pushed.version != null ? ` ${import_picocolors19.default.dim(`(rev ${pushed.version})`)}` : "";
       const hashLabel = pushed.hash ? ` ${import_picocolors19.default.dim(`hash ${pushed.hash}`)}` : "";
-      console.log(`  ${import_picocolors19.default.dim("schema")}  ${import_picocolors19.default.bold(`${pushed.models.length} models pushed`)}${ver}${hashLabel}${when}`);
+      console.log(
+        `  ${import_picocolors19.default.dim("schema")}  ${import_picocolors19.default.bold(`${pushed.models.length} models pushed`)}${ver}${hashLabel}${when}`
+      );
       for (const m2 of pushed.models) {
         const tn = m2.typename === m2.key ? import_picocolors19.default.dim(`typename=${m2.typename}`) : import_picocolors19.default.yellow(`typename=${m2.typename}`);
         const conflict = formatConflict(m2.conflict);
@@ -284933,7 +284995,9 @@ async function status(args = []) {
         console.log(`          ${import_picocolors19.default.dim("\u2022")} ${m2.key.padEnd(14)} ${tn}${conflictStr2}`);
       }
     } else if (pushed && !pushed.active) {
-      console.log(`  ${import_picocolors19.default.dim("schema")}  ${import_picocolors19.default.yellow("none pushed")} ${import_picocolors19.default.dim(`(run ${import_picocolors19.default.bold("ablo push")} or ${import_picocolors19.default.bold("ablo dev")})`)}`);
+      console.log(
+        `  ${import_picocolors19.default.dim("schema")}  ${import_picocolors19.default.yellow("none pushed")} ${import_picocolors19.default.dim(`(run ${import_picocolors19.default.bold("ablo push")} or ${import_picocolors19.default.bold("ablo dev")})`)}`
+      );
     }
   }
   const drift = schemaDrift(await readLocalSchemaHash(), pushed?.hash);
@@ -284978,7 +285042,9 @@ init_target();
 init_readiness();
 function render(check2) {
   const mark = check2.state === "ok" ? import_picocolors20.default.green("\u2713") : check2.state === "fail" ? import_picocolors20.default.red("\u2717") : import_picocolors20.default.dim("\u2013");
-  console.log(`  ${mark} ${check2.label.padEnd(10)} ${check2.state === "fail" ? check2.detail : import_picocolors20.default.dim(check2.detail)}`);
+  console.log(
+    `  ${mark} ${check2.label.padEnd(10)} ${check2.state === "fail" ? check2.detail : import_picocolors20.default.dim(check2.detail)}`
+  );
   if (check2.fix) console.log(`    ${" ".repeat(11)}${import_picocolors20.default.dim(`\u2192 ${check2.fix}`)}`);
 }
 async function ping2(apiUrl3) {
@@ -285025,7 +285091,11 @@ async function doctor() {
       fix: "check your connection, then re-run `ablo doctor`"
     }
   );
-  const target = runtimeKey.key ? await resolveTarget({ url: apiUrl3, apiKey: runtimeKey.key, keySource: runtimeKey.source ?? "stored" }) : null;
+  const target = runtimeKey.key ? await resolveTarget({
+    url: apiUrl3,
+    apiKey: runtimeKey.key,
+    keySource: runtimeKey.source ?? "stored"
+  }) : null;
   const confirmed = target?.confirmed ?? null;
   if (confirmed) {
     const project = confirmed.project ? confirmed.project.isDefault ? "default" : confirmed.project.name === null ? `${confirmed.project.id} (unnamed \u2014 ${confirmed.project.unnamedReason ?? "the project list did not answer"})` : `${confirmed.project.slug} (${confirmed.project.id})` : "default";
@@ -285071,7 +285141,12 @@ async function doctor() {
       label: "schema",
       state: "ok",
       detail: `${pushed.models.length} models active${pushed.hash ? `, hash ${pushed.hash}` : ""}`
-    } : reachable && runtimeKey.key ? { label: "schema", state: "fail", detail: "none active for this key", fix: "run `ablo push`" } : { label: "schema", state: "skip", detail: "not determined" }
+    } : reachable && runtimeKey.key ? {
+      label: "schema",
+      state: "fail",
+      detail: "none active for this key",
+      fix: "run `ablo push`"
+    } : { label: "schema", state: "skip", detail: "not determined" }
   );
   const drift = schemaDrift(await readLocalSchemaHash(), pushed?.hash);
   if (drift) {
@@ -285084,7 +285159,21 @@ async function doctor() {
   }
   if (dataSource.kind === "connected" && validation) {
     checks.push(
-      validation.ok ? validation.ready ? { label: "database", state: "ok", detail: "reachable from Ablo, and ready to replicate" } : {
+      validation.ok ? validation.ready ? {
+        label: "database",
+        state: "ok",
+        detail: "reachable from Ablo, and ready to replicate"
+      } : validation.initialSnapshot?.status === "loading" && validation.failures.length === 0 ? {
+        label: "database",
+        state: "fail",
+        detail: "reachable; rows that predate the connection are still loading",
+        fix: "wait a moment and rerun `ablo doctor` \u2014 Ablo snapshots them automatically; do not update every row or write a manual backfill"
+      } : validation.initialSnapshot?.status === "retrying" && validation.failures.length === 0 ? {
+        label: "database",
+        state: "fail",
+        detail: `the initial row load is retrying${validation.initialSnapshot.detail ? ` \u2014 ${validation.initialSnapshot.detail}` : ""}`,
+        fix: "fix the reported connection or database issue, then rerun `ablo doctor`; no row-touch backfill is needed"
+      } : {
         label: "database",
         state: "fail",
         detail: `reachable, but not ready (${validation.failures.length} check${validation.failures.length === 1 ? "" : "s"} failing)`,
@@ -285114,7 +285203,9 @@ async function doctor() {
     console.log(
       `  ${import_picocolors20.default.red("\u2717")} ${import_picocolors20.default.bold(`${failed} problem${failed === 1 ? "" : "s"}`)}` + import_picocolors20.default.dim(skipped > 0 ? `, ${skipped} check${skipped === 1 ? "" : "s"} skipped` : "")
     );
-    console.log(import_picocolors20.default.dim("    Fix them in the order above \u2014 an earlier one often explains a later one."));
+    console.log(
+      import_picocolors20.default.dim("    Fix them in the order above \u2014 an earlier one often explains a later one.")
+    );
   } else if (skipped > 0) {
     console.log(
       `  ${import_picocolors20.default.yellow("?")} ${import_picocolors20.default.dim(`nothing is blocking a write, but ${skipped} check${skipped === 1 ? "" : "s"} could not be run`)}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abloatai/cli",
-  "version": "0.45.0",
+  "version": "0.46.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",
@@ -30,10 +30,10 @@
     "directory": "packages/cli"
   },
   "dependencies": {
-    "@abloatai/transaction": "^0.45.0",
+    "@abloatai/transaction": "^0.46.0",
     "jiti": "^2.7.0",
     "zod": "^4.4.3",
-    "@abloatai/humans": "^0.45.0"
+    "@abloatai/humans": "^0.46.0"
   },
   "devDependencies": {
     "@clack/prompts": "^0.11.0",