primitive-admin 1.2.0-alpha.4 → 1.2.0-alpha.5

package/dist/src/lib/generated-sdk-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"generated-sdk-types.js","sourceRoot":"","sources":["../../../src/lib/generated-sdk-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,ogkIAAogkI,CAAC"}
+{"version":3,"file":"generated-sdk-types.js","sourceRoot":"","sources":["../../../src/lib/generated-sdk-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,4j6HAA4j6H,CAAC"}

package/dist/src/lib/login-scope-lines.d.ts

@@ -0,0 +1,15 @@
+/**
+ * What `primitive login` prints about the session it saved (#3891): its scope
+ * and pins, and, when it cannot take destructive actions, how to step up.
+ */
+/** The step-up hint for a login without `admin`. */
+export declare const STEP_UP_HINT = "Deleting apps or databases, removing collaborators and changing user roles need a 15-minute step-up: primitive login --scope admin";
+/**
+ * The lines to print after `Logged in as …` for an exchange's `scope` and
+ * `apps`. None when the exchange names no scope: an older server, whose login
+ * is unscoped.
+ */
+export declare function loginScopeLines(exchange: {
+    scope?: string[];
+    apps?: string[];
+}): string[];

package/dist/src/lib/login-scope-lines.js

@@ -0,0 +1,22 @@
+/**
+ * What `primitive login` prints about the session it saved (#3891): its scope
+ * and pins, and, when it cannot take destructive actions, how to step up.
+ */
+/** The step-up hint for a login without `admin`. */
+export const STEP_UP_HINT = "Deleting apps or databases, removing collaborators and changing user roles need a 15-minute step-up: primitive login --scope admin";
+/**
+ * The lines to print after `Logged in as …` for an exchange's `scope` and
+ * `apps`. None when the exchange names no scope: an older server, whose login
+ * is unscoped.
+ */
+export function loginScopeLines(exchange) {
+    const scope = exchange.scope ?? [];
+    if (scope.length === 0)
+        return [];
+    const apps = exchange.apps ?? [];
+    const lines = [`Scope: ${scope.join(", ")}; apps: ${apps.length > 0 ? apps.join(", ") : "unpinned"}`];
+    if (!scope.includes("admin"))
+        lines.push(STEP_UP_HINT);
+    return lines;
+}
+//# sourceMappingURL=login-scope-lines.js.map

package/dist/src/lib/login-scope-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login-scope-lines.js","sourceRoot":"","sources":["../../../src/lib/login-scope-lines.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GACvB,oIAAoI,CAAC;AAEvI;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAA+C;IAC7E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACtG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/lib/paginate.d.ts

@@ -40,11 +40,6 @@ export interface ListEnvelope<T = any> {
  * `normalizeListEnvelope` (`src/client/internal/listEnvelope.ts`). The two are
  * unrelated — the client helper is not re-exported from `src/client/index.ts`
  * and the CLI does not depend on the client package.
- *
- * `databases operations execute` routes through here too, but conditionally: a
- * registered operation is only sometimes a list, so
- * `normalizeDatabaseOperationResult()` (`api-client.ts`) tests the result shape
- * first and calls this helper only for a Durable Object query page (#2440).
  */
 export declare function normalizeCliListEnvelope<T = any>(raw: unknown): ListEnvelope<T>;
 /**

package/dist/src/lib/paginate.js

@@ -26,11 +26,6 @@
  * `normalizeListEnvelope` (`src/client/internal/listEnvelope.ts`). The two are
  * unrelated — the client helper is not re-exported from `src/client/index.ts`
  * and the CLI does not depend on the client package.
- *
- * `databases operations execute` routes through here too, but conditionally: a
- * registered operation is only sometimes a list, so
- * `normalizeDatabaseOperationResult()` (`api-client.ts`) tests the result shape
- * first and calls this helper only for a Durable Object query page (#2440).
  */
 export function normalizeCliListEnvelope(raw) {
     const page = raw;

package/dist/src/lib/paginate.js.map

@@ -1 +1 @@
-{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../../../src/lib/paginate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkBH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,wBAAwB,CAAU,GAAY;IAC5D,MAAM,IAAI,GAAG,GAA6C,CAAC;IAC3D,MAAM,QAAQ,GACZ,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACtD,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC;QAC3B,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAK,CAAC,UAAU,IAAI,SAAS,CAAC;IACjD,MAAM,QAAQ,GAAoB;QAChC,KAAK,EAAE,QAAe;QACtB,OAAO,EACL,OAAO,IAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;KAC3E,CAAC;IACF,IAAI,UAAU;QAAE,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IACjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAsC;IAEtC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC3E,CAAC;AAaD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAyB,EACzB,UAA2B,EAAE;IAE7B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC1C,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,IAAI,MAA0B,CAAC;IAE/B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,iDAAiD,CACnG,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,iEAAiE,CACjG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../../../src/lib/paginate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkBH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,wBAAwB,CAAU,GAAY;IAC5D,MAAM,IAAI,GAAG,GAA6C,CAAC;IAC3D,MAAM,QAAQ,GACZ,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACtD,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC;QAC3B,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAK,CAAC,UAAU,IAAI,SAAS,CAAC;IACjD,MAAM,QAAQ,GAAoB;QAChC,KAAK,EAAE,QAAe;QACtB,OAAO,EACL,OAAO,IAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;KAC3E,CAAC;IACF,IAAI,UAAU;QAAE,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IACjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAsC;IAEtC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC3E,CAAC;AAaD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAyB,EACzB,UAA2B,EAAE;IAE7B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC1C,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,IAAI,MAA0B,CAAC;IAE/B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,iDAAiD,CACnG,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,iEAAiE,CACjG,CAAC;AACJ,CAAC"}

package/dist/src/lib/refresh-admin-credentials.d.ts

@@ -55,6 +55,13 @@ export declare class RefreshError extends Error {
 export declare const SESSION_REVOKED_MESSAGE = "This session was revoked. Run 'primitive login'.";
 /** Any other refused refresh. */
 export declare const REFRESH_EXPIRED_MESSAGE = "Refresh token expired. Run 'primitive login'.";
+/**
+ * The login was made before scoped sessions: the server no longer refreshes
+ * an unscoped CLI session, and a new login holds the default scope.
+ */
+export declare const SESSION_UNSCOPED_MESSAGE = "Your login predates scoped sessions and can no longer be refreshed. Run 'primitive login' to sign in again.";
+/** What to tell the developer about a refresh the server refused with `code`. */
+export declare function refreshRefusalMessage(code: string | undefined): string;
 /**
  * Exchange the stored refresh token for a fresh `accessToken`. Returns a new
  * `Credentials` object — the caller is responsible for persistence via

package/dist/src/lib/refresh-admin-credentials.js

@@ -53,6 +53,19 @@ export class RefreshError extends Error {
 export const SESSION_REVOKED_MESSAGE = "This session was revoked. Run 'primitive login'.";
 /** Any other refused refresh. */
 export const REFRESH_EXPIRED_MESSAGE = "Refresh token expired. Run 'primitive login'.";
+/**
+ * The login was made before scoped sessions: the server no longer refreshes
+ * an unscoped CLI session, and a new login holds the default scope.
+ */
+export const SESSION_UNSCOPED_MESSAGE = "Your login predates scoped sessions and can no longer be refreshed. Run 'primitive login' to sign in again.";
+/** What to tell the developer about a refresh the server refused with `code`. */
+export function refreshRefusalMessage(code) {
+    if (code === "SESSION_UNSCOPED")
+        return SESSION_UNSCOPED_MESSAGE;
+    if (code === "SESSION_REVOKED")
+        return SESSION_REVOKED_MESSAGE;
+    return REFRESH_EXPIRED_MESSAGE;
+}
 /**
  * Exchange the stored refresh token for a fresh `accessToken`. Returns a new
  * `Credentials` object — the caller is responsible for persistence via
@@ -95,7 +108,8 @@ export async function refreshAdminCredentials(credentials) {
     }
     if (!response.ok) {
         // #3885: a refresh of a revoked session answers 401 with code
-        // SESSION_REVOKED; say so, rather than calling the token expired.
+        // SESSION_REVOKED; say so, rather than calling the token expired. #3891:
+        // an unscoped login answers SESSION_UNSCOPED.
         let code;
         try {
             const body = (await response.json());
@@ -104,9 +118,7 @@ export async function refreshAdminCredentials(credentials) {
         catch {
             // Not JSON: no code to report.
         }
-        throw new RefreshError(code === "SESSION_REVOKED"
-            ? SESSION_REVOKED_MESSAGE
-            : REFRESH_EXPIRED_MESSAGE, "unauthorized", response.status, undefined, code);
+        throw new RefreshError(refreshRefusalMessage(code), "unauthorized", response.status, undefined, code);
     }
     const data = (await response.json());
     const accessToken = data?.accessToken || data?.jwt;

package/dist/src/lib/refresh-admin-credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"refresh-admin-credentials.js","sourceRoot":"","sources":["../../../src/lib/refresh-admin-credentials.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"refresh-admin-credentials.js","sourceRoot":"","sources":["../../../src/lib/refresh-admin-credentials.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/root-import-decision.d.ts

@@ -2,17 +2,18 @@
  * What `documents import` does with a root document export, by format
  * (#4195).
  *
- * A root document is either a legacy document (its export is one Yjs state,
- * MERGED into the target user's root) or a large document (its export is a
- * chain, INSTALLED into the target user's root, and only into one that holds
- * nothing yet). Neither can go into the other, so a mismatch is refused before
- * the run writes anything. When the target user has no root yet, the app's
- * `rootDocumentFormat` setting predicts the format the mint will produce; the
- * root the mint actually returns is decided again against that prediction.
+ * A legacy root export is one Yjs state, MERGED into the target user's root.
+ * A large-document root export (format 2) cannot go anywhere: the platform no
+ * longer serves the format, so it is refused, naming the way across — its
+ * snapshot row chunks, loaded into a record-log document. A target root that
+ * is itself a large document is refused the same way. When the target user
+ * has no root yet, the app's `rootDocumentFormat` setting predicts the format
+ * the mint will produce; the root the mint actually returns is decided again
+ * against that prediction.
  *
  * Pure, so every branch is pinned without a server.
  */
-/** A root document's storage format: 1 (legacy) or 2 (large document). */
+/** A root document's storage format: 1 (legacy) or 2 (large document, refused). */
 export type RootDocumentFormat = 1 | 2;
 /** The facts a root import is decided from. */
 export interface RootImportDecisionInput {
@@ -36,7 +37,7 @@ export interface RootImportDecisionInput {
 }
 /** What to do with a root export. */
 export type RootImportDecision = {
-    outcome: "install" | "merge";
+    outcome: "merge";
     targetFormat: RootDocumentFormat;
 } | {
     outcome: "skip" | "refuse";
@@ -48,12 +49,12 @@ export declare function rootDocumentFormatOf(value: unknown): RootDocumentFormat
 /**
  * Decide what a root export does in the target app.
  *
- * - The formats match: `install` (large) or `merge` (legacy) — into an
- *   existing root only with `overwrite`, otherwise `skip`.
- * - They differ: `refuse`, naming both formats, whatever `overwrite` says.
- * - No root yet: the app's setting predicts the mint (2 is large, absent or 1
- *   legacy) and the same rule applies to the prediction.
+ * - The export is a large document: `refuse`, naming the migration.
+ * - The target root (existing, predicted from the app's setting, or minted)
+ *   is a large document: `refuse`.
  * - A `predictedFormat` that the minted root contradicts: `refuse` — the
  *   setting changed while the import ran.
+ * - Otherwise `merge` — into an existing root only with `overwrite`,
+ *   otherwise `skip`.
  */
 export declare function decideRootImport(input: RootImportDecisionInput): RootImportDecision;

package/dist/src/lib/root-import-decision.js

@@ -2,13 +2,14 @@
  * What `documents import` does with a root document export, by format
  * (#4195).
  *
- * A root document is either a legacy document (its export is one Yjs state,
- * MERGED into the target user's root) or a large document (its export is a
- * chain, INSTALLED into the target user's root, and only into one that holds
- * nothing yet). Neither can go into the other, so a mismatch is refused before
- * the run writes anything. When the target user has no root yet, the app's
- * `rootDocumentFormat` setting predicts the format the mint will produce; the
- * root the mint actually returns is decided again against that prediction.
+ * A legacy root export is one Yjs state, MERGED into the target user's root.
+ * A large-document root export (format 2) cannot go anywhere: the platform no
+ * longer serves the format, so it is refused, naming the way across — its
+ * snapshot row chunks, loaded into a record-log document. A target root that
+ * is itself a large document is refused the same way. When the target user
+ * has no root yet, the app's `rootDocumentFormat` setting predicts the format
+ * the mint will produce; the root the mint actually returns is decided again
+ * against that prediction.
  *
  * Pure, so every branch is pinned without a server.
  */
@@ -16,80 +17,72 @@
 export function rootDocumentFormatOf(value) {
     return Number(value) === 2 ? 2 : 1;
 }
-/** How a reason names a format. */
-function describe(format) {
-    return format === 2
-        ? "a large document (documentFormat 2)"
-        : "a legacy document (documentFormat 1)";
-}
-const REMEDY = "A large-document export is installed as a chain and a legacy export is " +
-    "merged as a Yjs state, so neither can go into the other. Import it into " +
-    "an app whose rootDocumentFormat matches the export, or into a user whose " +
-    "root document has the export's format. Nothing was imported for it.";
+/** Why a large document goes nowhere, and the way across for an export. */
+const NO_LONGER_SERVED = "a large document (documentFormat 2), which the platform no longer serves";
+const MIGRATION = "Create a record-log document and run `primitive documents ingest " +
+    "<document-id> --input <export-dir>` to load its row chunks. Nothing was imported " +
+    "for it.";
 /**
  * Decide what a root export does in the target app.
  *
- * - The formats match: `install` (large) or `merge` (legacy) — into an
- *   existing root only with `overwrite`, otherwise `skip`.
- * - They differ: `refuse`, naming both formats, whatever `overwrite` says.
- * - No root yet: the app's setting predicts the mint (2 is large, absent or 1
- *   legacy) and the same rule applies to the prediction.
+ * - The export is a large document: `refuse`, naming the migration.
+ * - The target root (existing, predicted from the app's setting, or minted)
+ *   is a large document: `refuse`.
  * - A `predictedFormat` that the minted root contradicts: `refuse` — the
  *   setting changed while the import ran.
+ * - Otherwise `merge` — into an existing root only with `overwrite`,
+ *   otherwise `skip`.
  */
 export function decideRootImport(input) {
     const whose = (input.owner
         ? `the root document of ${input.owner}`
         : "the target user's root document") +
         (input.targetRootDocId ? ` (${input.targetRootDocId})` : "");
-    const exportIs = `it is a root document exported as ${describe(input.exportFormat)}`;
+    const target = input.existingRootFormat ?? rootDocumentFormatOf(input.appSetting);
+    if (input.exportFormat === 2) {
+        return {
+            outcome: "refuse",
+            targetFormat: target,
+            reason: `it is a root document exported as ${NO_LONGER_SERVED}. ${MIGRATION}`,
+        };
+    }
     if (input.existingRootFormat === null) {
-        const predicted = rootDocumentFormatOf(input.appSetting);
-        if (predicted !== input.exportFormat) {
+        if (target === 2) {
             return {
                 outcome: "refuse",
-                targetFormat: predicted,
-                reason: `${exportIs}, and this app's rootDocumentFormat would mint ` +
-                    `${whose} as ${describe(predicted)}. ${REMEDY}`,
+                targetFormat: target,
+                reason: `this app's rootDocumentFormat would mint ${whose} as ` +
+                    `${NO_LONGER_SERVED}. Nothing was imported for it.`,
             };
         }
-        return {
-            outcome: predicted === 2 ? "install" : "merge",
-            targetFormat: predicted,
-        };
+        return { outcome: "merge", targetFormat: target };
     }
-    const actual = input.existingRootFormat;
     if (input.predictedFormat !== undefined &&
-        input.predictedFormat !== actual) {
+        input.predictedFormat !== input.existingRootFormat) {
         return {
             outcome: "refuse",
-            targetFormat: actual,
-            reason: `${exportIs}, and ${whose} came back from the server as ` +
-                `${describe(actual)} rather than ${describe(input.predictedFormat)} — ` +
-                `the app's rootDocumentFormat changed while this import ran, or a ` +
-                `sign-in minted the root first. ${REMEDY}`,
+            targetFormat: input.existingRootFormat,
+            reason: `${whose} came back from the server as a different format than the ` +
+                `app's rootDocumentFormat predicted — the setting changed while this ` +
+                `import ran, or a sign-in minted the root first. Nothing was imported ` +
+                `for it.`,
         };
     }
-    if (actual !== input.exportFormat) {
+    if (input.existingRootFormat === 2) {
         return {
             outcome: "refuse",
-            targetFormat: actual,
-            reason: `${exportIs}, and ${whose} is ${describe(actual)}. ${REMEDY}`,
+            targetFormat: 2,
+            reason: `${whose} is ${NO_LONGER_SERVED}. Nothing was imported for it.`,
         };
     }
     if (!input.overwrite) {
         return {
             outcome: "skip",
-            targetFormat: actual,
-            reason: actual === 2
-                ? `${whose} already exists as a large document; a large-document ` +
-                    `root export is installed, not merged, and only into a root that ` +
-                    `holds nothing yet — use --overwrite to install it if the root is ` +
-                    `still empty`
-                : `${whose} already exists; use --overwrite to merge the exported ` +
-                    `content into it`,
+            targetFormat: 1,
+            reason: `${whose} already exists; use --overwrite to merge the exported ` +
+                `content into it`,
         };
     }
-    return { outcome: actual === 2 ? "install" : "merge", targetFormat: actual };
+    return { outcome: "merge", targetFormat: 1 };
 }
 //# sourceMappingURL=root-import-decision.js.map

package/dist/src/lib/root-import-decision.js.map

@@ -1 +1 @@
-{"version":3,"file":"root-import-decision.js","sourceRoot":"","sources":["../../../src/lib/root-import-decision.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"root-import-decision.js","sourceRoot":"","sources":["../../../src/lib/root-import-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmCH,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,2EAA2E;AAC3E,MAAM,gBAAgB,GACpB,0EAA0E,CAAC;AAC7E,MAAM,SAAS,GACb,mEAAmE;IACnE,mFAAmF;IACnF,SAAS,CAAC;AAEZ;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA8B;IAE9B,MAAM,KAAK,GACT,CAAC,KAAK,CAAC,KAAK;QACV,CAAC,CAAC,wBAAwB,KAAK,CAAC,KAAK,EAAE;QACvC,CAAC,CAAC,iCAAiC,CAAC;QACtC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/D,MAAM,MAAM,GACV,KAAK,CAAC,kBAAkB,IAAI,oBAAoB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAErE,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,YAAY,EAAE,MAAM;YACpB,MAAM,EAAE,qCAAqC,gBAAgB,KAAK,SAAS,EAAE;SAC9E,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACtC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,QAAQ;gBACjB,YAAY,EAAE,MAAM;gBACpB,MAAM,EACJ,4CAA4C,KAAK,MAAM;oBACvD,GAAG,gBAAgB,gCAAgC;aACtD,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IACpD,CAAC;IAED,IACE,KAAK,CAAC,eAAe,KAAK,SAAS;QACnC,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC,kBAAkB,EAClD,CAAC;QACD,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,YAAY,EAAE,KAAK,CAAC,kBAAkB;YACtC,MAAM,EACJ,GAAG,KAAK,4DAA4D;gBACpE,sEAAsE;gBACtE,uEAAuE;gBACvE,SAAS;SACZ,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,YAAY,EAAE,CAAC;YACf,MAAM,EAAE,GAAG,KAAK,OAAO,gBAAgB,gCAAgC;SACxE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE,MAAM;YACf,YAAY,EAAE,CAAC;YACf,MAAM,EACJ,GAAG,KAAK,yDAAyD;gBACjE,iBAAiB;SACpB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/src/lib/snapshot-build-rows.d.ts

@@ -58,3 +58,24 @@ export interface SnapshotBuildPayload {
     };
 }
 export declare function snapshotBuildRows(build: SnapshotBuildPayload): SnapshotBuildRow[];
+/**
+ * The rows `documents snapshots get` and `build` print for a record-log
+ * (format 3) document's segment (#4310): where its export began (`B`), the
+ * log number its corrections were read at (`C`), and what it holds.
+ */
+export declare function segmentRows(segment: {
+    segmentId: string;
+    state: string;
+    lsn: number;
+    completedLsn: number | null;
+    rows: number;
+    chunks: number;
+    corrections: number | null;
+    bytes: number;
+    startedAt: number;
+    completedAt: number | null;
+    failure?: {
+        code: string;
+        reason: string;
+    } | null;
+}): SnapshotBuildRow[];

package/dist/src/lib/snapshot-build-rows.js

@@ -84,4 +84,26 @@ export function snapshotBuildRows(build) {
     }
     return rows;
 }
+/**
+ * The rows `documents snapshots get` and `build` print for a record-log
+ * (format 3) document's segment (#4310): where its export began (`B`), the
+ * log number its corrections were read at (`C`), and what it holds.
+ */
+export function segmentRows(segment) {
+    const rows = [
+        ["Segment", segment.segmentId],
+        ["State", segment.state],
+        ["Log number", segment.lsn],
+        ["Completed at log number", segment.completedLsn ?? "—"],
+        ["Rows", segment.rows],
+        ["Chunks", segment.chunks],
+        ["Corrections", segment.corrections ?? "—"],
+        ["Bytes", segment.bytes],
+        ["Started", formatDate(segment.startedAt)],
+        ["Completed", segment.completedAt ? formatDate(segment.completedAt) : "—"],
+    ];
+    if (segment.failure)
+        rows.push(["Failure", `${segment.failure.code} — ${segment.failure.reason}`]);
+    return rows;
+}
 //# sourceMappingURL=snapshot-build-rows.js.map

package/dist/src/lib/snapshot-build-rows.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-build-rows.js","sourceRoot":"","sources":["../../../src/lib/snapshot-build-rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA2CzC,kEAAkE;AAClE,MAAM,MAAM,GAA4B;IACtC,CAAC,WAAW,EAAE,QAAQ,CAAC;IACvB,CAAC,aAAa,EAAE,UAAU,CAAC;IAC3B,CAAC,eAAe,EAAE,YAAY,CAAC;IAC/B,CAAC,WAAW,EAAE,QAAQ,CAAC;IACvB,CAAC,aAAa,EAAE,UAAU,CAAC;IAC3B,CAAC,eAAe,EAAE,YAAY,CAAC;IAC/B,CAAC,kBAAkB,EAAE,cAAc,CAAC;IACpC,CAAC,oBAAoB,EAAE,gBAAgB,CAAC;IACxC,CAAC,sBAAsB,EAAE,kBAAkB,CAAC;CAC7C,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAC/B,KAA2B;IAE3B,MAAM,IAAI,GAAuB;QAC/B,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;QACxB,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;QACtB,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;QACtB,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;QACxB,CAAC,kBAAkB,EAAE,KAAK,CAAC,eAAe,CAAC;QAC3C,CAAC,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,SAA4B,CAAC,CAAC;QAC3D;YACE,WAAW;YACX,KAAK,CAAC,WAAW;gBACf,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,WAA8B,CAAC;gBAClD,CAAC,CAAC,GAAG;SACR;QACD,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;QACtB,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;QACxB,wEAAwE;QACxE,yEAAyE;QACzE,CAAC,YAAY,EAAE,KAAK,CAAC,WAAW,IAAI,GAAG,CAAC;QACxC,CAAC,eAAe,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QAC1C,CAAC,aAAa,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;KACvC,CAAC;IAEF,yEAAyE;IACzE,6EAA6E;IAC7E,4EAA4E;IAC5E,0DAA0D;IAC1D,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAC/E,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,SAA4B,CAAC,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC;QAC1D,IAAI,YAAY,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAC5C,IAAI,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,YAAY,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,IAAI,YAAY,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAqB,CAAC,CAAC,CAAC,CAAC;QAC1E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC;gBACR,WAAW;gBACX,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,UAAU,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE;aACpE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC1D,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"snapshot-build-rows.js","sourceRoot":"","sources":["../../../src/lib/snapshot-build-rows.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/snapshot-build.js

@@ -58,8 +58,13 @@ export async function driveSnapshotBuild(options) {
         onProgress?.("The open epoch carried nothing, so it was not sealed and no build was started.");
         return { exitCode: 0, response, build: null };
     }
-    const buildId = String(response?.buildId ?? "");
-    onProgress?.(`Sealed epoch ${response?.sealedEpoch}; build ${buildId}.`);
+    // A record-log (format 3) document answers with the segment export it
+    // started (#4310); it is watched the same way, to `complete` or `failed`.
+    const segmentId = typeof response?.segmentId === "string" ? response.segmentId : null;
+    const buildId = String(segmentId ?? response?.buildId ?? "");
+    onProgress?.(segmentId
+        ? `Segment ${segmentId} exporting from log number ${response?.lsn}.`
+        : `Sealed epoch ${response?.sealedEpoch}; build ${buildId}.`);
     if (!wait || !buildId)
         return { exitCode: 0, response, build: null };
     const startedAt = now();
@@ -99,7 +104,7 @@ export async function driveSnapshotBuild(options) {
             continue;
         }
         const verification = build?.verification;
-        if (verification?.state === "passed") {
+        if (segmentId ? build?.state === "complete" : verification?.state === "passed") {
             return { exitCode: 0, response, build };
         }
         if (verification?.state === "failed" || build?.state === "failed") {

package/dist/src/lib/snapshot-build.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-build.js","sourceRoot":"","sources":["../../../src/lib/snapshot-build.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"snapshot-build.js","sourceRoot":"","sources":["../../../src/lib/snapshot-build.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/swift-codegen/banners.d.ts

@@ -1,13 +1,17 @@
 /**
  * Ownership banners the CLI's Swift generators stamp and guard against.
  *
- * Three generators now write `.generated.swift` files that may share one
- * output directory — workflows, database types and (since #3344) server
- * functions. Each one sweeps only the files carrying its OWN banner and
- * refuses to overwrite a file carrying another's, so each has to name the
- * other two. The functions banner lives here, with no imports of its own, so
- * `generator.ts` and `dbGenerator.ts` can both name it without deepening the
- * import cycle those two already have.
+ * Two generators write `.generated.swift` files that may share one output
+ * directory — workflows and (since #3344) server functions. Each one sweeps
+ * only the files carrying its OWN banner and refuses to overwrite a file
+ * carrying the other's. The banners live here, with no imports of their own,
+ * so both generators can name them without an import cycle.
+ *
+ * A third generator, the database one, was retired with `primitive databases
+ * codegen` (#3189). Its banners stay RECOGNIZED: a database file left in an
+ * output directory belongs to no generator any more, so both surviving
+ * generators treat it as stale generated output to sweep — never as a file the
+ * author wrote, and never as another live generator's.
  */
 /**
  * Banner prefix stamped at the top of every `functions codegen --lang swift`
@@ -22,3 +26,26 @@ export declare const FUNCTION_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM func
  * invokers but from `prompts/`, so the two are told apart by content too.
  */
 export declare const AGENT_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM prompts/";
+/**
+ * Banner prefix the retired database Swift generator stamped on every
+ * `.generated.swift` file it wrote. RECOGNITION ONLY since #3189 — nothing
+ * emits it. Distinct from the workflow and function banners and from the model
+ * codegen's (`// Generated by swift-bao-codegen`), so recognizing it claims no
+ * live generator's file.
+ */
+export declare const DB_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM database-type-configs/";
+/**
+ * The banner the database generator stamped before issue #2760 renamed the
+ * source directory. RECOGNITION ONLY — nothing emits it.
+ *
+ * Ownership everywhere is `contents.startsWith(banner)`, so without this a file
+ * generated before the rename would match no banner at all and be left behind
+ * as if the author had written it.
+ */
+export declare const LEGACY_DB_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM database-types/";
+/**
+ * Both spellings of the retired database banner. A surviving generator counts
+ * a file carrying either as its own STALE output: a full run deletes it, a
+ * `--check` reports it stale, and a run writing the same name replaces it.
+ */
+export declare const DB_SWIFT_BANNER_PREFIXES: string[];

package/dist/src/lib/swift-codegen/banners.js

@@ -1,13 +1,17 @@
 /**
  * Ownership banners the CLI's Swift generators stamp and guard against.
  *
- * Three generators now write `.generated.swift` files that may share one
- * output directory — workflows, database types and (since #3344) server
- * functions. Each one sweeps only the files carrying its OWN banner and
- * refuses to overwrite a file carrying another's, so each has to name the
- * other two. The functions banner lives here, with no imports of its own, so
- * `generator.ts` and `dbGenerator.ts` can both name it without deepening the
- * import cycle those two already have.
+ * Two generators write `.generated.swift` files that may share one output
+ * directory — workflows and (since #3344) server functions. Each one sweeps
+ * only the files carrying its OWN banner and refuses to overwrite a file
+ * carrying the other's. The banners live here, with no imports of their own,
+ * so both generators can name them without an import cycle.
+ *
+ * A third generator, the database one, was retired with `primitive databases
+ * codegen` (#3189). Its banners stay RECOGNIZED: a database file left in an
+ * output directory belongs to no generator any more, so both surviving
+ * generators treat it as stale generated output to sweep — never as a file the
+ * author wrote, and never as another live generator's.
  */
 /**
  * Banner prefix stamped at the top of every `functions codegen --lang swift`
@@ -22,4 +26,30 @@ export const FUNCTION_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM functions/";
  * invokers but from `prompts/`, so the two are told apart by content too.
  */
 export const AGENT_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM prompts/";
+/**
+ * Banner prefix the retired database Swift generator stamped on every
+ * `.generated.swift` file it wrote. RECOGNITION ONLY since #3189 — nothing
+ * emits it. Distinct from the workflow and function banners and from the model
+ * codegen's (`// Generated by swift-bao-codegen`), so recognizing it claims no
+ * live generator's file.
+ */
+export const DB_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM database-type-configs/";
+/**
+ * The banner the database generator stamped before issue #2760 renamed the
+ * source directory. RECOGNITION ONLY — nothing emits it.
+ *
+ * Ownership everywhere is `contents.startsWith(banner)`, so without this a file
+ * generated before the rename would match no banner at all and be left behind
+ * as if the author had written it.
+ */
+export const LEGACY_DB_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM database-types/";
+/**
+ * Both spellings of the retired database banner. A surviving generator counts
+ * a file carrying either as its own STALE output: a full run deletes it, a
+ * `--check` reports it stale, and a run writing the same name replaces it.
+ */
+export const DB_SWIFT_BANNER_PREFIXES = [
+    DB_SWIFT_BANNER_PREFIX,
+    LEGACY_DB_SWIFT_BANNER_PREFIX,
+];
 //# sourceMappingURL=banners.js.map

package/dist/src/lib/swift-codegen/banners.js.map

@@ -1 +1 @@
-{"version":3,"file":"banners.js","sourceRoot":"","sources":["../../../../src/lib/swift-codegen/banners.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,mCAAmC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,iCAAiC,CAAC"}
+{"version":3,"file":"banners.js","sourceRoot":"","sources":["../../../../src/lib/swift-codegen/banners.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,mCAAmC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,iCAAiC,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,+CAA+C,CAAC;AAEtF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,wCAAwC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,sBAAsB;IACtB,6BAA6B;CAC9B,CAAC"}

package/dist/src/lib/swift-codegen/functionGenerator.d.ts

@@ -1,9 +1,9 @@
 /**
- * `functions codegen --lang swift` — the third CLI Swift generator (#3344).
+ * `functions codegen --lang swift` — a CLI Swift generator (#3344).
  *
  * The Swift counterpart of `function-schema-codegen.ts`'s TypeScript invoker,
- * and the sibling of `generator.ts` (workflows) and `dbGenerator.ts`
- * (database types). Reads the SAME `functions/<key>.toml` files and emits one
+ * and the sibling of `generator.ts` (workflows). Reads the SAME
+ * `functions/<key>.toml` files and emits one
  * `<key>.generated.swift` per function carrying:
  *
  *   - `<Key>Input` / `<Key>Output`, rendered from the declared schemas by the