@byline/cli 4.19.0 → 5.0.0

package/dist/lib/copied-script-drift.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=copied-script-drift.test.d.ts.map

package/dist/lib/copied-script-drift.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copied-script-drift.test.d.ts","sourceRoot":"","sources":["../../src/lib/copied-script-drift.test.ts"],"names":[],"mappings":""}

package/dist/lib/copied-script-drift.test.js

@@ -0,0 +1,37 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+const here = dirname(fileURLToPath(import.meta.url));
+const cliTemplates = resolve(here, '../templates');
+const webappByline = resolve(here, '../../../../apps/webapp/byline');
+const exactCopies = [
+    {
+        name: 'media regeneration operation',
+        template: 'byline-examples/scripts/regenerate-media-operation.ts',
+        application: 'scripts/regenerate-media-operation.ts',
+    },
+    {
+        name: 'media regeneration caller',
+        template: 'byline-examples/scripts/regenerate-media.ts',
+        application: 'scripts/regenerate-media.ts',
+    },
+    {
+        name: 'PostgreSQL source-locale re-anchor script',
+        template: 'dialects/postgres/byline-examples/scripts/re-anchor.ts',
+        application: 'scripts/re-anchor.ts',
+    },
+    {
+        name: 'singleton seed',
+        template: 'byline-examples/seeds/site-settings.ts',
+        application: 'seeds/site-settings.ts',
+    },
+];
+describe('R01 copied maintenance scripts', () => {
+    for (const copy of exactCopies) {
+        it(`keeps the ${copy.name} byte-for-byte equal to its application copy`, () => {
+            expect(readFileSync(resolve(webappByline, copy.application), 'utf8')).toBe(readFileSync(resolve(cliTemplates, copy.template), 'utf8'));
+        });
+    }
+});
+//# sourceMappingURL=copied-script-drift.test.js.map

package/dist/lib/copied-script-drift.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copied-script-drift.test.js","sourceRoot":"","sources":["../../src/lib/copied-script-drift.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACpD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;AAClD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAA;AAEpE,MAAM,WAAW,GAAG;IAClB;QACE,IAAI,EAAE,8BAA8B;QACpC,QAAQ,EAAE,uDAAuD;QACjE,WAAW,EAAE,uCAAuC;KACrD;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,QAAQ,EAAE,6CAA6C;QACvD,WAAW,EAAE,6BAA6B;KAC3C;IACD;QACE,IAAI,EAAE,2CAA2C;QACjD,QAAQ,EAAE,wDAAwD;QAClE,WAAW,EAAE,sBAAsB;KACpC;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,wCAAwC;QAClD,WAAW,EAAE,wBAAwB;KACtC;CACO,CAAA;AAEV,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,EAAE,CAAC,aAAa,IAAI,CAAC,IAAI,8CAA8C,EAAE,GAAG,EAAE;YAC5E,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CACxE,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAC3D,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/templates/byline-examples/scripts/import-docs.ts

@@ -1,3 +1,4 @@
+import { walkToStatus } from './lib/walk-document-status.js'
 /**
  * This Source Code is subject to the terms of the Mozilla Public
  * License, v. 2.0. If a copy of the MPL was not distributed with this
@@ -185,25 +186,13 @@ function derivePath(frontmatter: DocFrontmatter, locale: string): string {
  * through any intermediate statuses (e.g. needs_review). No-op when the
  * workflow doesn't include the target or when already at/past it.
  */
-async function walkToStatus(
-  handle: DocsHandle,
-  documentId: string,
-  workflowStatuses: readonly { name: string }[],
-  currentStatus: string,
-  targetStatus: string
-): Promise<void> {
-  const currentIdx = workflowStatuses.findIndex((s) => s.name === currentStatus)
-  const targetIdx = workflowStatuses.findIndex((s) => s.name === targetStatus)
-  if (currentIdx === -1 || targetIdx === -1 || targetIdx <= currentIdx) return
-  for (let i = currentIdx + 1; i <= targetIdx; i++) {
-    await handle.changeStatus(documentId, workflowStatuses[i].name)
-  }
-}
+
 
 interface ProcessResult {
   filePath: string
   action: 'created' | 'updated' | 'skipped'
   documentId?: string
+  revision?: number
   path: string
 }
 
@@ -301,18 +290,22 @@ async function processFile(
   const workflowStatuses = definition?.workflow?.statuses ?? []
   const defaultStatus = workflowStatuses[0]?.name ?? 'draft'
 
-  const existing = await handle.findByPath(docPath, {
+  const selected = await handle.findByPath(docPath, {
     locale,
     status: 'any',
     _bypassBeforeRead: true,
   })
 
+  const existing = selected == null ? null : await handle.findByIdForEdit(selected.id, { locale, _bypassBeforeRead: true })
+  if (selected != null && existing == null) throw new Error('Import target is no longer available; rerun the import.')
+
   if (existing) {
     // Don't clobber publishedOn if Byline already has one.
     if (existing.fields?.publishedOn) {
       delete payload.publishedOn
     }
     const result = await handle.update(existing.id, payload, {
+      expectedRevision: existing.revision,
       locale,
       // Advertise the imported locale (editorial available-locales set), merged
       // with whatever is already advertised so a later-locale re-import doesn't
@@ -320,8 +313,8 @@ async function processFile(
       // completeness ledger (intersection). See docs/08-internationalization/index.md.
       availableLocales: [...new Set([...(existing.availableLocales ?? []), locale])],
     })
-    await walkToStatus(handle, result.documentId, workflowStatuses, defaultStatus, desiredStatus)
-    return { filePath, action: 'updated', documentId: result.documentId, path: docPath }
+    const revision = await walkToStatus(handle, result.documentId, workflowStatuses, defaultStatus, desiredStatus, result.revision)
+    return { filePath, action: 'updated', documentId: result.documentId, revision, path: docPath }
   }
 
   const result = await handle.create(payload, {
@@ -332,7 +325,7 @@ async function processFile(
     // intersection of this editorial set with the completeness ledger.
     availableLocales: [locale],
   })
-  return { filePath, action: 'created', documentId: result.documentId, path: docPath }
+  return { filePath, action: 'created', documentId: result.documentId, revision: result.revision, path: docPath }
 }
 
 /**
@@ -386,7 +379,8 @@ async function placeTreeFromDirectories(
     const groupKey = parentDocumentId ?? ROOT_GROUP
     const beforeDocumentId = lastSiblingByGroup.get(groupKey) ?? null
     try {
-      await handle.placeTreeNode(r.documentId, { parentDocumentId, beforeDocumentId })
+      if (r.revision == null) throw new Error('Imported document has no observed revision')
+      await handle.placeTreeNode(r.documentId, { expectedRevision: r.revision, parentDocumentId, beforeDocumentId })
       lastSiblingByGroup.set(groupKey, r.documentId)
       if (parentDocumentId != null) {
         placed += 1

package/dist/templates/byline-examples/scripts/lib/walk-document-status.ts

@@ -0,0 +1,21 @@
+import type { CollectionHandle } from '@byline/client'
+
+/** Preserve the revision returned by each successful workflow transition.
+ * A conflict terminates the walk; it never fetches a newer observation. */
+export async function walkToStatus(
+  handle: Pick<CollectionHandle, 'changeStatus'>,
+  documentId: string,
+  workflowStatuses: readonly { name: string }[],
+  currentStatus: string,
+  targetStatus: string,
+  expectedRevision: number
+): Promise<number> {
+  const currentIdx = workflowStatuses.findIndex((s) => s.name === currentStatus)
+  const targetIdx = workflowStatuses.findIndex((s) => s.name === targetStatus)
+  if (currentIdx === -1 || targetIdx === -1 || targetIdx <= currentIdx) return expectedRevision
+  for (let i = currentIdx + 1; i <= targetIdx; i++) {
+    const result = await handle.changeStatus(documentId, workflowStatuses[i].name, { expectedRevision })
+    expectedRevision = result.revision
+  }
+  return expectedRevision
+}

package/dist/templates/byline-examples/scripts/regenerate-media-operation.ts

@@ -6,14 +6,10 @@
  * storage.
  */
 
-import type { CollectionHandle } from '@byline/client'
-import {
-  getDefaultStatus,
-  getWorkflowStatuses,
-  type CollectionDefinition,
-  type IDbAdapter,
-  type StoredFileValue,
-} from '@byline/core'
+import type { StoredFileValue } from '@byline/core'
+import { getDocumentHookCommittedDetails } from '@byline/core/services'
+
+export { replaceDocumentFieldsPreservingStatus as replaceMediaVersionPreservingStatus } from '@byline/core/services'
 
 export function storedFilePaths(value: StoredFileValue): Set<string> {
   return new Set([
@@ -47,66 +43,18 @@ export function assertCompleteVariantSet(
   }
 }
 
-/**
- * Write the regenerated fields and restore the captured workflow status as
- * one transaction.
- *
- * `CollectionHandle.update()` creates a new immutable version at the
- * collection's default status. For this maintenance operation, changing that
- * newly-created row to the captured status inside the same transaction is not
- * an editorial transition: no caller can observe the intermediate draft, and
- * an archived item never passes through published. The final version row and
- * its normal `document.updated` activity entry retain the resulting status;
- * the explicit status mutation is additionally audited as a system action.
- *
- * Direct adapter commands are intentional here and should not be copied into
- * ordinary application writes. Scripts are the supported escape hatch for
- * migrations that must preserve metadata while still using the lifecycle for
- * the content update itself.
- */
-export async function replaceMediaVersionPreservingStatus(params: {
-  db: IDbAdapter
-  definition: CollectionDefinition
-  collectionId: string
-  handle: Pick<CollectionHandle, 'update'>
-  documentId: string
-  fields: Record<string, any>
-  targetStatus: string
-}): Promise<{ documentVersionId: string }> {
-  const statuses = getWorkflowStatuses(params.definition).map((status) => status.name)
-  if (!statuses.includes(params.targetStatus)) {
-    throw new Error(
-      `regenerate-media: status '${params.targetStatus}' is not declared on collection ` +
-        `'${params.definition.path}' (declared: ${statuses.join(', ')}).`
-    )
+/** Only rejected document writes may discard freshly prepared storage objects. */
+export function mediaFailureOutcome(
+  error: unknown,
+  freshPaths: ReadonlySet<string>,
+  oldPaths: ReadonlySet<string>
+):
+  | { committed: true; revision: number; cleanupPaths: Set<string> }
+  | { committed: false; cleanupPaths: Set<string> } {
+  const committed = getDocumentHookCommittedDetails(error)
+  if (committed) return { committed: true, revision: committed.revision, cleanupPaths: new Set() }
+  return {
+    committed: false,
+    cleanupPaths: new Set([...freshPaths].filter((path) => !oldPaths.has(path))),
   }
-
-  const defaultStatus = getDefaultStatus(params.definition)
-  return params.db.withTransaction(async () => {
-    const result = await params.handle.update(params.documentId, params.fields)
-    if (params.targetStatus === defaultStatus) return result
-
-    await params.db.commands.documents.setDocumentStatus({
-      document_version_id: result.documentVersionId,
-      status: params.targetStatus,
-    })
-    if (params.targetStatus === 'published') {
-      await params.db.commands.documents.archivePublishedVersions({
-        document_id: params.documentId,
-        excludeVersionId: result.documentVersionId,
-      })
-    }
-    await params.db.commands.audit.append({
-      documentId: params.documentId,
-      collectionId: params.collectionId,
-      actorId: null,
-      actorRealm: 'system',
-      action: 'document.status.changed',
-      field: 'status',
-      before: defaultStatus,
-      after: params.targetStatus,
-    })
-
-    return result
-  })
 }

package/dist/templates/byline-examples/scripts/regenerate-media.ts

@@ -61,17 +61,14 @@ import path from 'node:path'
 
 import { createSuperAdminContext } from '@byline/auth'
 import { createBylineClient } from '@byline/client'
-import {
-  type FieldUploadContext,
-  getCollectionDefinition,
-  getServerConfig,
-} from '@byline/core'
+import { type FieldUploadContext, getCollectionDefinition, getServerConfig } from '@byline/core'
 import { extractImageMeta, generateImageVariants, isBypassMimeType } from '@byline/core/image'
 import { uploadField as coreUploadField } from '@byline/core/services'
-
 import type { MediaFields } from '@byline/generated-types'
+
 import {
   assertCompleteVariantSet,
+  mediaFailureOutcome,
   replaceMediaVersionPreservingStatus,
   storedFilePaths,
 } from './regenerate-media-operation.js'
@@ -120,14 +117,15 @@ async function run(): Promise<void> {
     id: string
     path: string
     status: string
+    revision: number
     fields: MediaFields
   }[] = []
   const pageSize = 100
   for (let page = 1; ; page++) {
-    const result = await handle.find({
+    const result = await handle.findForEdit({
+      locale: 'all',
       page,
       pageSize,
-      status: 'any',
       _bypassBeforeRead: true,
     })
     for (const d of result.docs) {
@@ -135,6 +133,7 @@ async function run(): Promise<void> {
         id: d.id,
         path: d.path,
         status: d.status,
+        revision: d.revision,
         fields: d.fields,
       })
     }
@@ -228,15 +227,10 @@ async function run(): Promise<void> {
       }
 
       const nextFields = { ...doc.fields, [FIELD_NAME]: uploadResult.storedFile }
-      await replaceMediaVersionPreservingStatus({
-        db: config.db,
-        definition,
-        collectionId,
-        handle,
-        documentId: doc.id,
-        fields: nextFields,
-        targetStatus: doc.status,
-      })
+      await replaceMediaVersionPreservingStatus(
+        { ...baseUploadCtx, requestContext },
+        { documentId: doc.id, data: nextFields, expectedRevision: doc.revision }
+      )
 
       const variantSummary =
         uploadResult.storedFile.variants?.map((v) => `${v.name}:${v.format ?? '?'}`).join(', ') ??
@@ -246,11 +240,11 @@ async function run(): Promise<void> {
       )
       processed += 1
     } catch (err) {
-      // The document transaction did not commit. Remove every fresh path we
-      // know about, but never delete a path that belonged to the old value — a
-      // deterministic beforeStore hook may already have overwritten it.
-      const rollbackPaths = new Set([...freshPaths].filter((storagePath) => !oldPaths.has(storagePath)))
-      const cleanupErrors = await deletePathsBestEffort(storage, rollbackPaths)
+      // A post-commit hook failure must retain the files referenced by the saved version.
+      // Rejected writes discard only fresh paths, preserving any reused original path.
+      const outcome = mediaFailureOutcome(err, freshPaths, oldPaths)
+      if (outcome.committed) processed += 1
+      const cleanupErrors = await deletePathsBestEffort(storage, outcome.cleanupPaths)
       const failure = asDocumentError(doc.id, doc.path, err)
       failures.push(
         cleanupErrors.length === 0
@@ -260,7 +254,10 @@ async function run(): Promise<void> {
               `regenerate-media: operation and rollback cleanup failed for '${doc.path}'`
             )
       )
-      console.error(`  ! fail ${doc.id} (${doc.path}):`, err)
+      console.error(
+        `  ! ${outcome.committed ? `saved revision ${outcome.revision}; hook failed` : 'fail'} ${doc.id} (${doc.path}):`,
+        err
+      )
     }
   }
 

package/dist/templates/byline-examples/seeds/site-settings.ts

@@ -11,14 +11,17 @@ import { getSystemBylineClient } from '@byline/client/server'
 /** Seed the singleton slot once, without overwriting later editorial changes. */
 export async function seedSiteSettings(): Promise<'seeded' | 'unchanged'> {
   const settings = getSystemBylineClient().singleton('site-settings')
-  const existing = await settings.get({ status: 'any' })
-  if (existing != null) return 'unchanged'
+  const existing = await settings.getForEdit()
+  if (existing?.state !== 'empty') return 'unchanged'
 
-  await settings.update({
-    siteName: 'Example site',
-    siteDescription:
-      'A concise description of this site for search results and social media previews.',
-  })
+  await settings.update(
+    {
+      siteName: 'Example site',
+      siteDescription:
+        'A concise description of this site for search results and social media previews.',
+    },
+    { expectedState: 'empty' }
+  )
   console.log('Seeded site settings')
   return 'seeded'
 }

package/dist/templates/dialects/postgres/byline-examples/scripts/re-anchor.ts

@@ -16,6 +16,7 @@
  * listed — that list is the outstanding-translation backlog. Re-run as
  * translation progresses; it is idempotent (each doc is its own transaction).
  *
+ * From the application directory containing byline/:
  *   pnpm tsx byline/scripts/re-anchor.ts --to fr
  *   pnpm tsx byline/scripts/re-anchor.ts --to fr --collection pages
  *   pnpm tsx byline/scripts/re-anchor.ts --to fr --dry-run
@@ -28,7 +29,7 @@ import '../server.config.js'
 
 import { parseArgs } from 'node:util'
 
-import { getBylineCore, getServerConfig } from '@byline/core'
+import { documentRevisionFromDatabase, getBylineCore, getServerConfig } from '@byline/core'
 import type { PgAdapter } from '@byline/db-postgres'
 
 const USAGE =
@@ -74,7 +75,19 @@ async function run() {
     `${dryRun ? '[dry-run] ' : ''}re-anchoring ${scope} → content source locale '${targetLocale}'…`
   )
 
-  const report = await db.reAnchorDocuments({ targetLocale, collectionId, dryRun })
+  // Capture each precondition before starting the batch; never refresh and retry a stale target.
+  const observed = await db.pool.query<{ document_id: string; revision: string }>(
+    `SELECT DISTINCT d.id AS document_id, d.revision
+     FROM byline_documents d JOIN byline_document_versions v ON v.document_id = d.id
+     WHERE v.is_deleted = false AND ($1::uuid IS NULL OR v.collection_id = $1::uuid)
+     ORDER BY d.id`,
+    [collectionId ?? null]
+  )
+  const targets = observed.rows.map((row) => ({
+    documentId: row.document_id,
+    expectedRevision: documentRevisionFromDatabase(row.revision),
+  }))
+  const report = await db.reAnchorDocuments({ targets, targetLocale, collectionId, dryRun })
 
   console.log(
     `${dryRun ? '[dry-run] would re-anchor' : '✓ re-anchored'} ${report.reanchored}/${report.total} document(s) → '${targetLocale}'`

package/dist/templates/migrations/mysql/{0000_clean_magdalene.sql → 0000_pale_bastion.sql}

@@ -173,6 +173,7 @@ CREATE TABLE `byline_document_publish_schedules` (
 	`document_id` char(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
 	`collection_id` char(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
 	`target_version_id` char(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+	`authorized_revision` bigint,
 	`publish_at` datetime(6) NOT NULL,
 	`state` varchar(32) NOT NULL DEFAULT 'armed',
 	`suspended_at` datetime(6),
@@ -189,8 +190,9 @@ CREATE TABLE `byline_document_publish_schedules` (
 	`attempt_count` int NOT NULL DEFAULT 0,
 	`last_error` text,
 	CONSTRAINT `byline_document_publish_schedules_document_id` PRIMARY KEY(`document_id`),
+	CONSTRAINT `check_publish_schedules_authorized_revision` CHECK(`byline_document_publish_schedules`.`authorized_revision` IS NULL OR `byline_document_publish_schedules`.`authorized_revision` BETWEEN 1 AND 9007199254740991),
 	CONSTRAINT `check_publish_schedules_state` CHECK(`byline_document_publish_schedules`.`state` IN ('armed', 'needs_reconfirm')),
-	CONSTRAINT `check_publish_schedules_suspended_reason` CHECK(`byline_document_publish_schedules`.`suspended_reason` IS NULL OR `byline_document_publish_schedules`.`suspended_reason` = 'content_edited')
+	CONSTRAINT `check_publish_schedules_suspended_reason` CHECK(`byline_document_publish_schedules`.`suspended_reason` IS NULL OR `byline_document_publish_schedules`.`suspended_reason` IN ('content_edited', 'document_metadata_changed', 'upgrade_invalidated'))
 );
 --> statement-breakpoint
 CREATE TABLE `byline_document_relationships` (
@@ -229,10 +231,12 @@ CREATE TABLE `byline_documents` (
 	`collection_id` char(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
 	`order_key` varchar(128) CHARACTER SET ascii COLLATE ascii_bin,
 	`source_locale` varchar(10) NOT NULL,
+	`revision` bigint NOT NULL,
 	`created_at` datetime(6) NOT NULL DEFAULT CURRENT_TIMESTAMP(6),
 	`updated_at` datetime(6) NOT NULL DEFAULT CURRENT_TIMESTAMP(6),
 	CONSTRAINT `byline_documents_id` PRIMARY KEY(`id`),
-	CONSTRAINT `uq_documents_collection_id_id` UNIQUE(`collection_id`,`id`)
+	CONSTRAINT `uq_documents_collection_id_id` UNIQUE(`collection_id`,`id`),
+	CONSTRAINT `check_documents_revision` CHECK(`byline_documents`.`revision` BETWEEN 1 AND 9007199254740991)
 );
 --> statement-breakpoint
 CREATE TABLE `byline_store_file` (

package/dist/templates/migrations/mysql/meta/_journal.json

@@ -5,8 +5,8 @@
     {
       "idx": 0,
       "version": "5",
-      "when": 1787797706202,
-      "tag": "0000_clean_magdalene",
+      "when": 1788642356080,
+      "tag": "0000_pale_bastion",
       "breakpoints": true
     }
   ]

package/dist/templates/migrations/postgres/{0000_quiet_johnny_blaze.sql → 0000_yielding_vulture.sql}

@@ -163,6 +163,7 @@ CREATE TABLE "byline_document_publish_schedules" (
 	"document_id" uuid PRIMARY KEY NOT NULL,
 	"collection_id" uuid NOT NULL,
 	"target_version_id" uuid NOT NULL,
+	"authorized_revision" bigint,
 	"publish_at" timestamp (6) with time zone NOT NULL,
 	"state" varchar(32) DEFAULT 'armed' NOT NULL,
 	"suspended_at" timestamp (6) with time zone,
@@ -178,8 +179,9 @@ CREATE TABLE "byline_document_publish_schedules" (
 	"next_attempt_at" timestamp (6) with time zone NOT NULL,
 	"attempt_count" integer DEFAULT 0 NOT NULL,
 	"last_error" text,
+	CONSTRAINT "check_publish_schedules_authorized_revision" CHECK ("byline_document_publish_schedules"."authorized_revision" IS NULL OR "byline_document_publish_schedules"."authorized_revision" BETWEEN 1 AND 9007199254740991),
 	CONSTRAINT "check_document_publish_schedules_state" CHECK ("byline_document_publish_schedules"."state" IN ('armed', 'needs_reconfirm')),
-	CONSTRAINT "check_document_publish_schedules_suspended_reason" CHECK ("byline_document_publish_schedules"."suspended_reason" IS NULL OR "byline_document_publish_schedules"."suspended_reason" = 'content_edited')
+	CONSTRAINT "check_document_publish_schedules_suspended_reason" CHECK ("byline_document_publish_schedules"."suspended_reason" IS NULL OR "byline_document_publish_schedules"."suspended_reason" IN ('content_edited', 'document_metadata_changed', 'upgrade_invalidated'))
 );
 --> statement-breakpoint
 CREATE TABLE "byline_document_relationships" (
@@ -217,9 +219,11 @@ CREATE TABLE "byline_documents" (
 	"collection_id" uuid NOT NULL,
 	"order_key" varchar(128) COLLATE "C",
 	"source_locale" varchar(10) NOT NULL,
+	"revision" bigint NOT NULL,
 	"created_at" timestamp (6) with time zone DEFAULT now() NOT NULL,
 	"updated_at" timestamp (6) with time zone DEFAULT now() NOT NULL,
-	CONSTRAINT "uq_documents_collection_id_id" UNIQUE("collection_id","id")
+	CONSTRAINT "uq_documents_collection_id_id" UNIQUE("collection_id","id"),
+	CONSTRAINT "check_documents_revision" CHECK ("byline_documents"."revision" BETWEEN 1 AND 9007199254740991)
 );
 --> statement-breakpoint
 CREATE TABLE "byline_store_file" (

package/dist/templates/migrations/postgres/meta/_journal.json

@@ -5,8 +5,8 @@
     {
       "idx": 0,
       "version": "7",
-      "when": 1787797717481,
-      "tag": "0000_quiet_johnny_blaze",
+      "when": 1788642365591,
+      "tag": "0000_yielding_vulture",
       "breakpoints": true
     }
   ]

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/cli",
   "private": false,
   "license": "MPL-2.0",
-  "version": "4.19.0",
+  "version": "5.0.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -61,7 +61,7 @@
     "typescript": "^7.0.2",
     "unified": "^11.0.5",
     "vitest": "^4.1.11",
-    "@byline/core": "4.19.0"
+    "@byline/core": "5.0.0"
   },
   "publishConfig": {
     "access": "public",