@growth-labs/cms 0.8.2 → 0.8.4

package/dist/engine/ai-dek-notifications.d.ts

@@ -6,6 +6,8 @@ export interface DekFailureNotificationInput {
     title: string;
     reason: string;
     userId?: string | null;
+    /** Stable callback/attempt identity for replay-safe background notifications. */
+    occurrenceId?: string;
 }
 /**
  * Create unread, in-app notifications when publication ships without a dek.

package/dist/engine/ai-dek-notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-dek-notifications.d.ts","sourceRoot":"","sources":["../../src/engine/ai-dek-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,MAAM,WAAW,2BAA2B;IAC3C,EAAE,EAAE,UAAU,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CAClD,KAAK,EAAE,2BAA2B,GAChC,OAAO,CAAC,MAAM,CAAC,CA+BjB"}
+{"version":3,"file":"ai-dek-notifications.d.ts","sourceRoot":"","sources":["../../src/engine/ai-dek-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAazC,MAAM,WAAW,2BAA2B;IAC3C,EAAE,EAAE,UAAU,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CAClD,KAAK,EAAE,2BAA2B,GAChC,OAAO,CAAC,MAAM,CAAC,CAmCjB"}

package/dist/engine/ai-dek-notifications.js

@@ -1,3 +1,8 @@
+async function deterministicNotificationId(occurrenceId, userId) {
+    const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(JSON.stringify(['ai-dek-failed.v1', occurrenceId, userId])));
+    const hex = Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0')).join('');
+    return `ai-dek-failed:${hex}`;
+}
 /**
  * Create unread, in-app notifications when publication ships without a dek.
  * Interactive publishes target the actor; background publishes target every
@@ -22,11 +27,15 @@ export async function createDekFailureNotifications(input) {
     const reason = input.reason.trim().slice(0, 160) || 'unknown error';
     const body = `Content was published without a subheading: “${input.title}”. AI generation failed (${reason}). Open the item to add one manually.`;
     for (const userId of [...new Set(userIds)]) {
+        const notificationId = input.occurrenceId
+            ? await deterministicNotificationId(input.occurrenceId, userId)
+            : crypto.randomUUID();
         await input.db
             .prepare(`INSERT INTO cms_notifications
 				 (id, workspace_id, user_id, kind, body, created_at)
-				 VALUES (?, ?, ?, 'ai_dek_failed', ?, unixepoch())`)
-            .bind(crypto.randomUUID(), input.workspaceId, userId, body)
+				 VALUES (?, ?, ?, 'ai_dek_failed', ?, unixepoch())
+				 ON CONFLICT(id) DO NOTHING`)
+            .bind(notificationId, input.workspaceId, userId, body)
             .run();
     }
     return new Set(userIds).size;

package/dist/engine/ai-dek-notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-dek-notifications.js","sourceRoot":"","sources":["../../src/engine/ai-dek-notifications.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAClD,KAAkC;IAElC,IAAI,OAAiB,CAAA;IACrB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;SAAM,CAAC;QACP,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,EAAE;aACzB,OAAO,CACP;;;;0BAIsB,CACtB;aACA,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;aACvB,GAAG,EAAuB,CAAA;QAC5B,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,eAAe,CAAA;IACnE,MAAM,IAAI,GAAG,gDAAgD,KAAK,CAAC,KAAK,4BAA4B,MAAM,uCAAuC,CAAA;IACjJ,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM,KAAK,CAAC,EAAE;aACZ,OAAO,CACP;;uDAEmD,CACnD;aACA,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC;aAC1D,GAAG,EAAE,CAAA;IACR,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAA;AAC7B,CAAC"}
+{"version":3,"file":"ai-dek-notifications.js","sourceRoot":"","sources":["../../src/engine/ai-dek-notifications.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,2BAA2B,CAAC,YAAoB,EAAE,MAAc;IAC9E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CACxC,SAAS,EACT,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,kBAAkB,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CACpF,CAAA;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAChG,EAAE,CACF,CAAA;IACD,OAAO,iBAAiB,GAAG,EAAE,CAAA;AAC9B,CAAC;AAaD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAClD,KAAkC;IAElC,IAAI,OAAiB,CAAA;IACrB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;SAAM,CAAC;QACP,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,EAAE;aACzB,OAAO,CACP;;;;0BAIsB,CACtB;aACA,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;aACvB,GAAG,EAAuB,CAAA;QAC5B,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,eAAe,CAAA;IACnE,MAAM,IAAI,GAAG,gDAAgD,KAAK,CAAC,KAAK,4BAA4B,MAAM,uCAAuC,CAAA;IACjJ,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM,cAAc,GAAG,KAAK,CAAC,YAAY;YACxC,CAAC,CAAC,MAAM,2BAA2B,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC;YAC/D,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;QACtB,MAAM,KAAK,CAAC,EAAE;aACZ,OAAO,CACP;;;gCAG4B,CAC5B;aACA,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC;aACrD,GAAG,EAAE,CAAA;IACR,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAA;AAC7B,CAAC"}

package/dist/engine/ai-dek.d.ts

@@ -26,7 +26,30 @@ export type GenerateContentDekResult = {
     written: false;
     reason: 'not_found';
 };
+export type GenerateContentDekSuggestionResult = {
+    status: 'generated';
+    dek: string;
+} | {
+    status: 'unavailable';
+    dek: null;
+    reason: string;
+};
 export declare function loadDekGenerationContext(db: D1Database, contentId: string): Promise<DekGenerationContext | null>;
+/** Build the prompt context from an already-authorized publication snapshot. */
+export declare function loadDekGenerationContextFromSnapshot(db: D1Database, snapshot: Record<string, unknown>): Promise<DekGenerationContext | null>;
+/** Dispatch and normalize a dek suggestion without creating any D1 write continuation. */
+export declare function generateContentDekSuggestion(input: {
+    context: DekGenerationContext;
+    llm: LlmDispatch;
+}): Promise<GenerateContentDekSuggestionResult>;
+/** Apply a generated suggestion only while its captured editor/publication state is current. */
+export declare function applyGeneratedContentDek(input: {
+    db: D1Database;
+    contentId: string;
+    dek: string;
+    context: DekGenerationContext;
+    expectedPublicationSnapshot?: Record<string, unknown>;
+}): Promise<GenerateContentDekResult>;
 export declare function generateContentDek(input: {
     db: D1Database;
     contentId: string;

package/dist/engine/ai-dek.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-dek.d.ts","sourceRoot":"","sources":["../../src/engine/ai-dek.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,EAAE,KAAK,iBAAiB,EAAkB,MAAM,gBAAgB,CAAA;AAEvE,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,iBAAiB,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,MAAM,wBAAwB,GACjC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAA;AA+B1E,wBAAsB,wBAAwB,CAC7C,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA4BtC;AAUD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC/C,EAAE,EAAE,UAAU,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,WAAW,CAAA;CAChB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA2CpC"}
+{"version":3,"file":"ai-dek.d.ts","sourceRoot":"","sources":["../../src/engine/ai-dek.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAMzC,OAAO,EAAE,KAAK,iBAAiB,EAAkB,MAAM,gBAAgB,CAAA;AAEvE,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,iBAAiB,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,MAAM,wBAAwB,GACjC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAA;AAE1E,MAAM,MAAM,kCAAkC,GAC3C;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAmDvD,wBAAsB,wBAAwB,CAC7C,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAQtC;AAED,gFAAgF;AAChF,wBAAsB,oCAAoC,CACzD,EAAE,EAAE,UAAU,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAgBtC;AAUD,0FAA0F;AAC1F,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACzD,OAAO,EAAE,oBAAoB,CAAA;IAC7B,GAAG,EAAE,WAAW,CAAA;CAChB,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAuB9C;AAED,gGAAgG;AAChG,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACrD,EAAE,EAAE,UAAU,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,oBAAoB,CAAA;IAC7B,2BAA2B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrD,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA4CpC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC/C,EAAE,EAAE,UAAU,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,WAAW,CAAA;CAChB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAqBpC"}

package/dist/engine/ai-dek.js

@@ -1,5 +1,6 @@
 import { dekPrompt } from './ai-prompts.js';
 import { applyAiWrite, parseLockedFields } from './ai-writeback.js';
+import { CURRENT_PUBLICATION_GUARD, currentPublicationSqlGuard, snapshotRecord, } from './publication-current-guard.js';
 import { getContentItem } from './publisher.js';
 export const DEK_EXEMPLAR_LIMIT = 6;
 async function loadTypeSource(db, item) {
@@ -24,13 +25,7 @@ async function loadTypeSource(db, item) {
         .first();
     return (row?.body_markdown || row?.body_html || row?.subtitle || '').trim();
 }
-export async function loadDekGenerationContext(db, contentId) {
-    const item = await getContentItem(db, contentId);
-    if (!item)
-        return null;
-    const typeSource = await loadTypeSource(db, item);
-    const description = item.description?.trim() ?? '';
-    const source = [description, typeSource].filter(Boolean).join('\n\n');
+async function loadExemplars(db, item) {
     const rows = await db
         .prepare(`SELECT title, excerpt
 			 FROM content_items
@@ -43,10 +38,36 @@ export async function loadDekGenerationContext(db, contentId) {
 			          COALESCE(published_at, 0) DESC,
 			          id ASC
 			 LIMIT ?`)
-        .bind(contentId, item.type, DEK_EXEMPLAR_LIMIT)
+        .bind(item.id, item.type, DEK_EXEMPLAR_LIMIT)
         .all();
-    const exemplars = (rows.results ?? []).map((row) => `Headline: ${row.title}\nDek: ${row.excerpt.trim()}`);
-    return { item, source, exemplars };
+    return (rows.results ?? []).map((row) => `Headline: ${row.title}\nDek: ${row.excerpt.trim()}`);
+}
+export async function loadDekGenerationContext(db, contentId) {
+    const item = await getContentItem(db, contentId);
+    if (!item)
+        return null;
+    const typeSource = await loadTypeSource(db, item);
+    const description = item.description?.trim() ?? '';
+    const source = [description, typeSource].filter(Boolean).join('\n\n');
+    return { item, source, exemplars: await loadExemplars(db, item) };
+}
+/** Build the prompt context from an already-authorized publication snapshot. */
+export async function loadDekGenerationContextFromSnapshot(db, snapshot) {
+    const item = snapshotRecord(snapshot.item);
+    if (!item.id || !item.type || !item.title)
+        return null;
+    const content = snapshotRecord(snapshot.content);
+    const typeSource = item.type === 'video'
+        ? String(content.script ?? '').trim()
+        : item.type === 'podcast'
+            ? String(content.transcript ?? '').trim()
+            : String(content.body_markdown || content.body_html || content.subtitle || '').trim();
+    const description = item.description?.trim() ?? '';
+    return {
+        item,
+        source: [description, typeSource].filter(Boolean).join('\n\n'),
+        exemplars: await loadExemplars(db, item),
+    };
 }
 function normalizeDek(text) {
     return text
@@ -55,45 +76,87 @@ function normalizeDek(text) {
         .replace(/\s+/g, ' ')
         .trim();
 }
-export async function generateContentDek(input) {
-    const context = await loadDekGenerationContext(input.db, input.contentId);
-    if (!context) {
-        return { status: 'not_found', dek: null, written: false, reason: 'not_found' };
-    }
+/** Dispatch and normalize a dek suggestion without creating any D1 write continuation. */
+export async function generateContentDekSuggestion(input) {
     const result = await input.llm.dispatch({
         ...dekPrompt({
-            title: context.item.title,
-            source: context.source,
-            exemplars: context.exemplars,
+            title: input.context.item.title,
+            source: input.context.source,
+            exemplars: input.context.exemplars,
         }),
         stream: false,
     });
     if (result instanceof ReadableStream) {
-        return { status: 'unavailable', dek: null, written: false, reason: 'stream_result' };
+        return { status: 'unavailable', dek: null, reason: 'stream_result' };
     }
     if (result.status === 'unavailable') {
         return {
             status: 'unavailable',
             dek: null,
-            written: false,
             reason: result.reason ?? 'unavailable',
         };
     }
     const dek = normalizeDek(result.text);
-    if (!dek) {
-        return { status: 'unavailable', dek: null, written: false, reason: 'empty_result' };
-    }
+    if (!dek)
+        return { status: 'unavailable', dek: null, reason: 'empty_result' };
+    return { status: 'generated', dek };
+}
+/** Apply a generated suggestion only while its captured editor/publication state is current. */
+export async function applyGeneratedContentDek(input) {
     const write = applyAiWrite({
-        locked: parseLockedFields(context.item.ai_locked_fields),
+        locked: parseLockedFields(input.context.item.ai_locked_fields),
         field: 'excerpt',
-        value: dek,
+        value: input.dek,
     });
     if (!write.written)
-        return { status: 'locked', dek, written: false };
-    await input.db
-        .prepare('UPDATE content_items SET excerpt = ?, updated_at = unixepoch() WHERE id = ?')
-        .bind(dek, input.contentId)
-        .run();
-    return { status: 'generated', dek, written: true };
+        return { status: 'locked', dek: input.dek, written: false };
+    const capturedItem = input.context.item;
+    const guardPayload = input.expectedPublicationSnapshot
+        ? JSON.stringify({
+            ...input.expectedPublicationSnapshot,
+            publication_guard: CURRENT_PUBLICATION_GUARD,
+        })
+        : null;
+    const publicationPredicate = guardPayload
+        ? `AND EXISTS (
+			 SELECT 1 FROM (SELECT ? AS payload_json) dek_expected
+			 WHERE ${currentPublicationSqlGuard('dek_expected')}
+		   )`
+        : '';
+    const statement = input.db
+        .prepare(`UPDATE content_items
+			 SET excerpt = ?, updated_at = unixepoch()
+			 WHERE id = ?
+			   AND canonical_version IS ?
+			   AND excerpt IS ?
+			   AND ai_locked_fields IS ?
+			   ${publicationPredicate}`)
+        .bind(input.dek, input.contentId, capturedItem.canonical_version, capturedItem.excerpt, capturedItem.ai_locked_fields, ...(guardPayload ? [guardPayload] : []));
+    const result = await statement.run();
+    if (result.meta?.changes !== 1) {
+        return { status: 'unavailable', dek: null, written: false, reason: 'content_changed' };
+    }
+    return { status: 'generated', dek: input.dek, written: true };
+}
+export async function generateContentDek(input) {
+    const context = await loadDekGenerationContext(input.db, input.contentId);
+    if (!context) {
+        return { status: 'not_found', dek: null, written: false, reason: 'not_found' };
+    }
+    const suggestion = await generateContentDekSuggestion({ context, llm: input.llm });
+    if (suggestion.status === 'unavailable') {
+        return {
+            status: 'unavailable',
+            dek: null,
+            written: false,
+            reason: suggestion.reason,
+        };
+    }
+    return applyGeneratedContentDek({
+        db: input.db,
+        contentId: input.contentId,
+        dek: suggestion.dek,
+        context,
+    });
 }
 //# sourceMappingURL=ai-dek.js.map

package/dist/engine/ai-dek.js.map

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

package/dist/engine/foundry-dispatch.d.ts

@@ -2,8 +2,10 @@ import type { FoundryDispatch } from '../providers/types.js';
 import type { D1Database } from './d1.js';
 export type ProcessingState = 'pending' | 'queued' | 'fetching' | 'transcribing' | 'transcoding' | 'ready' | 'failed';
 export interface DispatchResult {
-    correlationId: string;
+    /** Podcast capture reuse has no persisted correlation to return. */
+    correlationId: string | null;
     triggerToken: string;
+    skipped?: boolean;
 }
 export declare class FoundryDispatchPrerequisiteError extends Error {
     readonly code: "missing_duration";
@@ -21,16 +23,24 @@ export interface CallbackInput {
     description?: string | null;
     excerpt?: string | null;
 }
+/**
+ * Mint a fresh source identity for the caller's source-snapshot CAS. Capture
+ * time records initiation, not worker admission; this helper does not dispatch
+ * work or change readiness. The raw token stays in the private capture record.
+ */
+export declare function createFoundrySourceCaptureToken(capturedAtSeconds?: number): string;
 /**
  * Dispatch a video or podcast content item to Foundry via the injected hook.
- * Mints a fresh `processing_trigger_token` (UUID), calls
+ * Mints a fresh versioned `processing_trigger_token` (capture time + UUID), calls
  * `hook.dispatchVideo({ contentId, sourceUrl, kind, durationSeconds })`, and writes
  * `processing_correlation_id` + advances to `'queued'` in either
  * `video_content` or `podcast_content`.
  *
  * Throws if the item is not a video/podcast.
  */
-export declare function dispatchToFoundry(db: D1Database, contentId: string, hook: Pick<FoundryDispatch, 'dispatchVideo'>): Promise<DispatchResult>;
+export declare function dispatchToFoundry(db: D1Database, contentId: string, hook: Pick<FoundryDispatch, 'dispatchVideo'>, options?: {
+    ifUncaptured?: boolean;
+}): Promise<DispatchResult>;
 /**
  * Apply a Foundry callback event to the state machine.
  *

package/dist/engine/foundry-dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foundry-dispatch.d.ts","sourceRoot":"","sources":["../../src/engine/foundry-dispatch.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAazC,MAAM,MAAM,eAAe,GACxB,SAAS,GACT,QAAQ,GACR,UAAU,GACV,cAAc,GACd,aAAa,GACb,OAAO,GACP,QAAQ,CAAA;AAIX,MAAM,WAAW,cAAc;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IAC1D,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAS;gBAE/B,SAAS,EAAE,MAAM;CAI7B;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,eAAe,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAwCD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACtC,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,GAC1C,OAAO,CAAC,cAAc,CAAC,CA8KzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAoJjG;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CA8ClB"}
+{"version":3,"file":"foundry-dispatch.d.ts","sourceRoot":"","sources":["../../src/engine/foundry-dispatch.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAiC,MAAM,SAAS,CAAA;AAcxE,MAAM,MAAM,eAAe,GACxB,SAAS,GACT,QAAQ,GACR,UAAU,GACV,cAAc,GACd,aAAa,GACb,OAAO,GACP,QAAQ,CAAA;AAIX,MAAM,WAAW,cAAc;IAC9B,oEAAoE;IACpE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IAC1D,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAS;gBAE/B,SAAS,EAAE,MAAM;CAI7B;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,eAAe,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAwCD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC9C,iBAAiB,SAAgC,GAC/C,MAAM,CAKR;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACtC,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,EAC5C,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,cAAc,CAAC,CA8QzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA8KjG;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CA8ClB"}

package/dist/engine/foundry-dispatch.js

@@ -9,6 +9,7 @@
 // ready | failed.  Advances are driven by HMAC-verified callback events keyed
 // on `processing_trigger_token` and deduplicated on `event_id`.
 import { validPodcastSourceUrl } from './podcast-source.js';
+import { mediaPublicationCaptureGuard } from './publication-current-guard.js';
 const TERMINAL_STATES = ['ready', 'failed'];
 export class FoundryDispatchPrerequisiteError extends Error {
     code = 'missing_duration';
@@ -49,18 +50,31 @@ function inferVideoSourceKind(sourceUrl) {
     }
     return 'http_url';
 }
+/**
+ * Mint a fresh source identity for the caller's source-snapshot CAS. Capture
+ * time records initiation, not worker admission; this helper does not dispatch
+ * work or change readiness. The raw token stays in the private capture record.
+ */
+export function createFoundrySourceCaptureToken(capturedAtSeconds = Math.floor(Date.now() / 1000)) {
+    if (!Number.isSafeInteger(capturedAtSeconds) || capturedAtSeconds <= 0) {
+        throw new RangeError('Capture time must be positive safe integer Unix seconds');
+    }
+    return `fronts-source-v2:${capturedAtSeconds}:${crypto.randomUUID()}`;
+}
 /**
  * Dispatch a video or podcast content item to Foundry via the injected hook.
- * Mints a fresh `processing_trigger_token` (UUID), calls
+ * Mints a fresh versioned `processing_trigger_token` (capture time + UUID), calls
  * `hook.dispatchVideo({ contentId, sourceUrl, kind, durationSeconds })`, and writes
  * `processing_correlation_id` + advances to `'queued'` in either
  * `video_content` or `podcast_content`.
  *
  * Throws if the item is not a video/podcast.
  */
-export async function dispatchToFoundry(db, contentId, hook) {
+export async function dispatchToFoundry(db, contentId, hook, options = {}) {
     const content = await db
-        .prepare('SELECT id, type, slug, title, description, canonical_version, status, deleted_at FROM content_items WHERE id = ? LIMIT 1')
+        .prepare(`SELECT id, type, slug, title, description, canonical_version, status, deleted_at,
+			visibility, published_revision_id, published_at, publish_at, publish_tz,
+			fronts_publish_status, fronts_publish_trigger_token FROM content_items WHERE id = ? LIMIT 1`)
         .bind(contentId)
         .first();
     if (!content) {
@@ -68,7 +82,7 @@ export async function dispatchToFoundry(db, contentId, hook) {
     }
     // Determine which media table owns this content id.
     const videoRow = await db
-        .prepare('SELECT content_id, video_id, duration_seconds, processing_source_url, processing_source_kind FROM video_content WHERE content_id = ?')
+        .prepare('SELECT content_id, video_id, duration_seconds, processing_source_url, processing_source_kind, processing_trigger_token, processing_correlation_id FROM video_content WHERE content_id = ?')
         .bind(contentId)
         .first();
     let table;
@@ -79,6 +93,18 @@ export async function dispatchToFoundry(db, contentId, hook) {
     let durationSeconds;
     let podcastSnapshot = null;
     if (videoRow) {
+        if (content.type !== 'video' || content.deleted_at != null || content.status === 'archived') {
+            throw new Error(`dispatchToFoundry: video ${contentId} is inactive`);
+        }
+        if (options.ifUncaptured &&
+            videoRow.processing_trigger_token &&
+            videoRow.processing_correlation_id) {
+            return {
+                correlationId: videoRow.processing_correlation_id,
+                triggerToken: videoRow.processing_trigger_token,
+                skipped: true,
+            };
+        }
         table = 'video_content';
         sourceUrl = videoRow.processing_source_url?.trim() ?? '';
         if (!sourceUrl) {
@@ -102,12 +128,17 @@ export async function dispatchToFoundry(db, contentId, hook) {
             throw new Error(`dispatchToFoundry: podcast ${contentId} is inactive`);
         }
         podcastSnapshot = podcastRow;
-        sourceUrl = podcastRow.audio_r2_key?.trim() ?? '';
+        const selectedSource = podcastRow.processing_source_url?.trim();
+        if (selectedSource &&
+            (podcastRow.processing_source_kind !== 'https' || !validPodcastSourceUrl(selectedSource))) {
+            throw new Error(`dispatchToFoundry: content ${contentId} has an invalid podcast source URL`);
+        }
+        sourceUrl = selectedSource || podcastRow.audio_r2_key?.trim() || '';
         if (!sourceUrl) {
-            throw new Error(`dispatchToFoundry: content ${contentId} has no podcast audio R2 key`);
+            throw new Error(`dispatchToFoundry: content ${contentId} has no podcast source or audio R2 key`);
         }
         kind = 'podcast';
-        sourceKind = 'r2_key';
+        sourceKind = selectedSource ? 'https' : 'r2_key';
         videoId = normalizeVideoId(content.slug, content.slug);
         durationSeconds = podcastRow.duration_seconds;
     }
@@ -116,8 +147,21 @@ export async function dispatchToFoundry(db, contentId, hook) {
         durationSeconds <= 0) {
         throw new FoundryDispatchPrerequisiteError(contentId);
     }
-    const triggerToken = crypto.randomUUID();
+    if (options.ifUncaptured &&
+        podcastSnapshot?.processing_trigger_token?.trim() &&
+        podcastSnapshot.processing_source_kind === 'https' &&
+        validPodcastSourceUrl(podcastSnapshot.processing_source_url)) {
+        // Source edits clear the token. This source/token pair is the CMS's
+        // committed capture evidence; a metadata save need not call the host again.
+        return {
+            correlationId: null,
+            triggerToken: podcastSnapshot.processing_trigger_token,
+            skipped: true,
+        };
+    }
+    const triggerToken = createFoundrySourceCaptureToken();
     const processingTriggerTokenHash = `sha256:${await sha256Hex(triggerToken)}`;
+    const publicationGuard = mediaPublicationCaptureGuard(content, processingTriggerTokenHash);
     const { correlationId, podcastSource } = await hook.dispatchVideo({
         contentId,
         sourceUrl,
@@ -131,13 +175,16 @@ export async function dispatchToFoundry(db, contentId, hook) {
     });
     const now = Math.floor(Date.now() / 1000);
     if (table === 'video_content') {
-        await db
+        if (!videoRow)
+            throw new Error('Video dispatch snapshot is missing');
+        const written = await db
             .prepare(`UPDATE video_content
          SET processing_state = 'queued',
              video_id = ?,
              processing_source_kind = ?,
              processing_correlation_id = ?,
              processing_trigger_token = ?,
+             processing_publication_guard = ?,
              processing_started_at = ?,
              processing_completed_at = NULL,
              processing_last_event_at = NULL,
@@ -148,9 +195,19 @@ export async function dispatchToFoundry(db, contentId, hook) {
              transcript_url = NULL,
              hls_manifest_url = NULL,
              hls_poster_url = NULL
-         WHERE content_id = ?`)
-            .bind(videoId, sourceKind, correlationId, triggerToken, now, contentId)
+         WHERE content_id = ? AND video_id IS ? AND duration_seconds IS ?
+         AND processing_source_url IS ? AND processing_source_kind IS ?
+         AND processing_trigger_token IS ? AND processing_correlation_id IS ?
+         AND EXISTS (SELECT 1 FROM content_items ci WHERE ci.id = video_content.content_id
+         AND ci.type = 'video' AND ci.slug = ? AND ci.canonical_version = ?
+         AND ci.status = ? AND ci.deleted_at IS NULL
+         AND ci.visibility IS ? AND ci.published_revision_id IS ? AND ci.published_at IS ?
+         AND ci.publish_at IS ? AND ci.publish_tz IS ?
+         AND ci.fronts_publish_status IS ? AND ci.fronts_publish_trigger_token IS ?)`)
+            .bind(videoId, sourceKind, correlationId, triggerToken, publicationGuard, now, contentId, videoRow.video_id, videoRow.duration_seconds, videoRow.processing_source_url, videoRow.processing_source_kind, videoRow.processing_trigger_token, videoRow.processing_correlation_id, content.slug, content.canonical_version, content.status, content.visibility, content.published_revision_id, content.published_at, content.publish_at, content.publish_tz, content.fronts_publish_status, content.fronts_publish_trigger_token)
             .run();
+        if (written.meta?.changes !== 1)
+            throw new Error('Video source changed before dispatch acknowledgement');
     }
     else {
         if (!podcastSnapshot)
@@ -171,13 +228,16 @@ export async function dispatchToFoundry(db, contentId, hook) {
         // source/audio/editor snapshot is still current. No stale acknowledgement
         // can restore a replaced source or overwrite a newer processing token.
         const written = await db
-            .prepare(`UPDATE podcast_content SET processing_source_url = ?, processing_source_kind = ?, processing_trigger_token = ?
+            .prepare(`UPDATE podcast_content SET processing_source_url = ?, processing_source_kind = ?, processing_trigger_token = ?, processing_publication_guard = ?, processing_state = 'queued', transcript = ''
 			WHERE content_id = ? AND audio_r2_key IS ? AND duration_seconds IS ? AND transcript IS ?
 			AND processing_source_url IS ? AND processing_source_kind IS ? AND processing_trigger_token IS ?
 			AND EXISTS (SELECT 1 FROM content_items ci WHERE ci.id = podcast_content.content_id
 			AND ci.type = 'podcast' AND ci.slug = ? AND ci.canonical_version = ?
-			AND ci.status = ? AND ci.deleted_at IS NULL)`)
-            .bind(capturedUrl, capturedKind, triggerToken, contentId, podcastSnapshot.audio_r2_key, podcastSnapshot.duration_seconds, podcastSnapshot.transcript, podcastSnapshot.processing_source_url, podcastSnapshot.processing_source_kind, podcastSnapshot.processing_trigger_token, content.slug, content.canonical_version, content.status)
+			AND ci.status = ? AND ci.deleted_at IS NULL
+			AND ci.visibility IS ? AND ci.published_revision_id IS ? AND ci.published_at IS ?
+			AND ci.publish_at IS ? AND ci.publish_tz IS ?
+			AND ci.fronts_publish_status IS ? AND ci.fronts_publish_trigger_token IS ?)`)
+            .bind(capturedUrl, capturedKind, triggerToken, publicationGuard, contentId, podcastSnapshot.audio_r2_key, podcastSnapshot.duration_seconds, podcastSnapshot.transcript, podcastSnapshot.processing_source_url, podcastSnapshot.processing_source_kind, podcastSnapshot.processing_trigger_token, content.slug, content.canonical_version, content.status, content.visibility, content.published_revision_id, content.published_at, content.publish_at, content.publish_tz, content.fronts_publish_status, content.fronts_publish_trigger_token)
             .run();
         if (written.meta?.changes !== 1)
             throw new Error('Podcast source changed before dispatch acknowledgement');
@@ -227,12 +287,17 @@ export async function applyFoundryCallback(db, input) {
     if (!videoRow && !podcastRow) {
         return false; // no matching job for this trigger token
     }
-    // Insert the event row.
+    // A failed event is consumed atomically with terminal state and guard revocation.
+    // Otherwise a transient media write failure would make its retry a no-op.
     const now = Math.floor(Date.now() / 1000);
-    await db
+    const eventStatement = db
         .prepare('INSERT INTO foundry_callback_events (event_id, event_kind, correlation_id, received_at) VALUES (?, ?, ?, ?)')
-        .bind(eventId, eventKind, correlationId, now)
-        .run();
+        .bind(eventId, eventKind, correlationId, now);
+    if (nextState !== 'failed')
+        await eventStatement.run();
+    const applyMediaUpdate = async (statement) => nextState === 'failed'
+        ? (await db.batch([statement, eventStatement]))[0]
+        : await statement.run();
     // Advance the state machine.
     const isTerminal = TERMINAL_STATES.includes(nextState);
     if (podcastRow) {
@@ -240,61 +305,72 @@ export async function applyFoundryCallback(db, input) {
         const nextDurationSeconds = typeof durationSeconds === 'number' && Number.isFinite(durationSeconds)
             ? Math.max(0, Math.floor(durationSeconds))
             : null;
-        if (nextTranscript !== null || nextDurationSeconds !== null) {
-            await db
+        {
+            const updated = await applyMediaUpdate(db
                 .prepare(`UPDATE podcast_content
-					SET transcript = CASE WHEN ? THEN ? ELSE transcript END,
+					SET processing_state = ?, processing_publication_guard = CASE WHEN ? = 'failed' THEN NULL ELSE processing_publication_guard END,
+                        transcript = CASE WHEN ? THEN ? ELSE transcript END,
 						duration_seconds = CASE WHEN ? THEN ? ELSE duration_seconds END
-					WHERE content_id = ?`)
-                .bind(nextTranscript !== null ? 1 : 0, nextTranscript, nextDurationSeconds !== null ? 1 : 0, nextDurationSeconds, podcastRow.content_id)
-                .run();
+					WHERE content_id = ? AND processing_trigger_token = ?`)
+                .bind(nextState, nextState, nextTranscript !== null ? 1 : 0, nextTranscript, nextDurationSeconds !== null ? 1 : 0, nextDurationSeconds, podcastRow.content_id, triggerToken));
+            if (updated.meta?.changes !== 1)
+                return false;
         }
         const nextDescription = typeof description === 'string' && description.trim() ? description.trim() : null;
         const nextExcerpt = typeof excerpt === 'string' && excerpt.trim() ? excerpt.trim() : null;
         if (nextDescription !== null || nextExcerpt !== null) {
-            await db
+            const updated = await db
                 .prepare(`UPDATE content_items
 					SET description = CASE WHEN ? THEN ? ELSE description END,
 						excerpt = CASE WHEN ? THEN ? ELSE excerpt END,
 						updated_at = unixepoch()
-					WHERE id = ?`)
-                .bind(nextDescription !== null ? 1 : 0, nextDescription, nextExcerpt !== null ? 1 : 0, nextExcerpt, podcastRow.content_id)
+					WHERE id = ? AND EXISTS (
+						SELECT 1 FROM podcast_content p WHERE p.content_id = content_items.id
+						AND p.processing_trigger_token = ?
+					)`)
+                .bind(nextDescription !== null ? 1 : 0, nextDescription, nextExcerpt !== null ? 1 : 0, nextExcerpt, podcastRow.content_id, triggerToken)
                 .run();
+            if (updated.meta?.changes !== 1)
+                return false;
         }
-        return true;
+        return Boolean(await db
+            .prepare('SELECT content_id FROM podcast_content WHERE content_id = ? AND processing_trigger_token = ?')
+            .bind(podcastRow.content_id, triggerToken)
+            .first());
     }
     if (!videoRow)
         return false;
     const row = videoRow;
+    let updated;
     if (nextState === 'failed') {
-        await db
+        updated = await applyMediaUpdate(db
             .prepare(`UPDATE video_content
          SET processing_state = ?,
+             processing_publication_guard = NULL,
              processing_last_event_at = ?,
              processing_completed_at = ?,
              processing_error = ?
-         WHERE content_id = ?`)
-            .bind(nextState, now, now, error ?? null, row.content_id)
-            .run();
+         WHERE content_id = ? AND processing_trigger_token = ?`)
+            .bind(nextState, now, now, error ?? null, row.content_id, triggerToken));
     }
     else if (isTerminal) {
         // 'ready'
-        await db
+        updated = await db
             .prepare(`UPDATE video_content
          SET processing_state = ?,
              processing_last_event_at = ?,
              processing_completed_at = ?
-         WHERE content_id = ?`)
-            .bind(nextState, now, now, row.content_id)
+         WHERE content_id = ? AND processing_trigger_token = ?`)
+            .bind(nextState, now, now, row.content_id, triggerToken)
             .run();
     }
     else {
-        await db
-            .prepare('UPDATE video_content SET processing_state = ?, processing_last_event_at = ? WHERE content_id = ?')
-            .bind(nextState, now, row.content_id)
+        updated = await db
+            .prepare('UPDATE video_content SET processing_state = ?, processing_last_event_at = ? WHERE content_id = ? AND processing_trigger_token = ?')
+            .bind(nextState, now, row.content_id, triggerToken)
             .run();
     }
-    return true;
+    return updated.meta?.changes === 1;
 }
 /**
  * Verify a HMAC-SHA256 signature over `rawBody` using `secret`.