@growth-labs/cms 0.8.33 → 0.8.35

package/dist/ui/editor/content-payload.d.ts

@@ -49,6 +49,11 @@ export declare function canCreateContentDraft(contentType: ContentType, draft: C
     requirePrimaryTopic?: boolean;
 }): boolean;
 export declare function foundryDispatchSourceForDraft(contentType: ContentType, draft: ContentDraftFields): string | null;
+/** Explain the same prerequisites that gate the first save, using the host's field label. */
+export declare function contentDraftSaveError(contentType: ContentType, draft: ContentDraftFields, requirements?: {
+    requirePrimaryTopic?: boolean;
+    primaryTopicLabel?: string;
+}): string | null;
 export declare function inferVideoSourceKind(sourceUrl: string): 'dropbox' | 'http_url';
 export declare function buildContentUpdatePayload(contentType: ContentType, draft: ContentDraftFields): Record<string, unknown>;
 export declare function buildContentCreatePayload(contentType: ContentType, draft: ContentDraftFields): Record<string, unknown>;

package/dist/ui/editor/content-payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-payload.d.ts","sourceRoot":"","sources":["../../../src/ui/editor/content-payload.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"content-payload.d.ts","sourceRoot":"","sources":["../../../src/ui/editor/content-payload.ts"],"names":[],"mappings":"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"}

package/dist/ui/editor/content-payload.js

@@ -99,6 +99,19 @@ export function foundryDispatchSourceForDraft(contentType, draft) {
     }
     return null;
 }
+/** Explain the same prerequisites that gate the first save, using the host's field label. */
+export function contentDraftSaveError(contentType, draft, requirements = {}) {
+    if (canCreateContentDraft(contentType, draft, requirements))
+        return null;
+    if (requirements.requirePrimaryTopic && !draft.primaryTopic?.trim()) {
+        return `Select ${requirements.primaryTopicLabel || 'a primary topic'} before saving.`;
+    }
+    const mediaSource = foundryDispatchSourceForDraft(contentType, draft);
+    if (mediaSource && normalizeMediaDurationSeconds(draft.durationSeconds) === null) {
+        return 'Enter the authoritative media duration in whole seconds before saving.';
+    }
+    return 'Add the required title and content before saving.';
+}
 export function inferVideoSourceKind(sourceUrl) {
     try {
         const { hostname } = new URL(sourceUrl);

package/dist/ui/editor/content-payload.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growth-labs/cms",
-  "version": "0.8.33",
+  "version": "0.8.35",
   "type": "module",
   "bin": {
     "growth-labs-cms-migrations": "./dist/cli/migrations.js",

package/src/engine/content-metadata.ts

@@ -137,3 +137,38 @@ export const ContentMetadataSchema = z
 		}
 	})
 	.transform((metadata) => metadata as ContentMetadata)
+
+// A prepared improvement supplies partial credits. Keep recorded names and
+// their provenance when preparation has no new credit, rather than replacing
+// the entire source record with UNKNOWN fields.
+export function mergePinnedArticleMetadata(
+	recorded: ContentMetadata,
+	incoming: ContentMetadata,
+): ContentMetadata {
+	const merged = { ...recorded, ...incoming }
+	const isObject = (value: ContentMetadataValue | undefined): value is ContentMetadata =>
+		value !== null && typeof value === 'object' && !Array.isArray(value)
+	if (!isObject(recorded.credits) || !isObject(incoming.credits)) return merged
+	const prior = recorded.credits
+	const updates = incoming.credits
+	const credits = { ...prior, ...updates }
+	for (const role of ['originalWriter', 'presenter', 'editor']) {
+		const statusKey = `${role}Status`
+		const name = updates[role]
+		const status = updates[statusKey]
+		const missingName = name === undefined || (typeof name === 'string' && name.trim() === '')
+		if (
+			prior[role] !== undefined &&
+			(status === 'UNKNOWN' || (missingName && status === undefined))
+		) {
+			credits[role] = prior[role]
+			if (prior[statusKey] !== undefined) credits[statusKey] = prior[statusKey]
+			else delete credits[statusKey]
+		} else if (!missingName && name !== prior[role] && status === undefined) {
+			// A different name cannot inherit the previous person's verification.
+			credits[statusKey] = 'UNKNOWN'
+		}
+	}
+	merged.credits = credits
+	return merged
+}

package/src/engine/publisher.ts

@@ -343,6 +343,8 @@ export interface UpdateContentInput extends Partial<BaseContentInput> {
 export interface UpdateContentOptions {
 	/** Atomically apply the update only while the content row has this status. */
 	requiredStatus?: ContentStatus
+	/** Pin a machine body update to the canonical version it inspected. Requires requiredStatus. */
+	expectedCanonicalVersion?: number
 	/** Apply a resolved media source only while this exact source identity is still stored. */
 	expectedMediaSource?: {
 		sourceUrl: string | null
@@ -354,6 +356,8 @@ export interface UpdateContentResult {
 	slug: string
 	/** Present when requiredStatus lost a race before the mutation transaction. */
 	statusConflict?: string
+	/** A newer canonical edit won before the atomic update. */
+	canonicalVersionConflict?: boolean
 	/** Present when a newer media-source update won while this request was resolving. */
 	mediaSourceConflict?: boolean
 }
@@ -811,6 +815,14 @@ export async function updateContentItem(
 	input: UpdateContentInput,
 	options: UpdateContentOptions = {},
 ): Promise<UpdateContentResult | null> {
+	if (
+		options.expectedCanonicalVersion !== undefined &&
+		(!options.requiredStatus ||
+			!Number.isSafeInteger(options.expectedCanonicalVersion) ||
+			options.expectedCanonicalVersion < 1)
+	) {
+		throw new TypeError('Canonical-version updates require a valid version and status constraint')
+	}
 	const tagPairs = input.tags === undefined ? null : validateDeclaredTagList(input.tags)
 	const existing = await getContentItem(db, id)
 	if (!existing) return null
@@ -1047,6 +1059,10 @@ export async function updateContentItem(
 		// D1 batch is a transaction: the status predicate and every content-table
 		// write linearize together, so a native publish/schedule cannot interleave
 		// between the base row and its body row.
+		const versionPredicate =
+			options.expectedCanonicalVersion === undefined ? '' : ' AND canonical_version = ?'
+		const versionBindings =
+			options.expectedCanonicalVersion === undefined ? [] : [options.expectedCanonicalVersion]
 		const statements = [
 			db
 				.prepare(
@@ -1056,7 +1072,7 @@ export async function updateContentItem(
 					  hero_image_id = ?, hero_image_alt = ?, hero_image_caption = ?, social_image_id = ?,
 					  canonical_url = ?, ai_locked_fields = ?, seo_focus_keyword = ?, metadata_json = ?,
 					  updated_at = unixepoch(), canonical_version = canonical_version + 1
-					 WHERE id = ? AND status = ? AND deleted_at IS NULL
+					 WHERE id = ? AND status = ? AND deleted_at IS NULL${versionPredicate}
 					 RETURNING slug`,
 				)
 				.bind(
@@ -1081,6 +1097,7 @@ export async function updateContentItem(
 					metadataJson,
 					id,
 					options.requiredStatus,
+					...versionBindings,
 				),
 		]
 
@@ -1137,7 +1154,7 @@ export async function updateContentItem(
 						 WHERE content_id = ?
 						   AND EXISTS (
 						     SELECT 1 FROM content_items
-						     WHERE id = ? AND status = ? AND deleted_at IS NULL
+						     WHERE id = ? AND status = ? AND deleted_at IS NULL${versionPredicate}
 						   )
 						 RETURNING content_id`,
 					)
@@ -1167,6 +1184,7 @@ export async function updateContentItem(
 						id,
 						id,
 						options.requiredStatus,
+						...versionBindings,
 					),
 			)
 		}
@@ -1178,11 +1196,11 @@ export async function updateContentItem(
 			// up front even when the guarded write below is refused.
 			const tagRows = tagPairs.length > 0 ? await ensureTags(db, tagPairs) : []
 			const statusGuard = `EXISTS (SELECT 1 FROM content_items
-			   WHERE id = ? AND status = ? AND deleted_at IS NULL)`
+			   WHERE id = ? AND status = ? AND deleted_at IS NULL${versionPredicate})`
 			statements.push(
 				db
 					.prepare(`DELETE FROM content_tag_links WHERE content_id = ? AND ${statusGuard}`)
-					.bind(id, id, options.requiredStatus),
+					.bind(id, id, options.requiredStatus, ...versionBindings),
 			)
 			for (const tag of tagRows) {
 				statements.push(
@@ -1191,11 +1209,16 @@ export async function updateContentItem(
 							`INSERT INTO content_tag_links (content_id, tag_id, label)
 							 SELECT ?, ?, ? WHERE ${statusGuard}`,
 						)
-						.bind(id, tag.id, tag.label, id, options.requiredStatus),
+						.bind(id, tag.id, tag.label, id, options.requiredStatus, ...versionBindings),
 				)
 			}
 		}
 
+		// D1 batch is atomic. Keep the base row's version unchanged while every
+		// dependent body/tag write checks it; advance it only as the final write.
+		const baseStatement = statements.shift()!
+		const baseResultIndex = statements.length
+		statements.push(baseStatement)
 		const statusResultIndex = statements.length
 		statements.push(
 			db
@@ -1204,10 +1227,13 @@ export async function updateContentItem(
 		)
 		const results = await db.batch(statements)
 		const baseChanged =
-			(results[0]?.results?.length ?? 0) > 0 ||
-			(results[0]?.meta as { changes?: number } | undefined)?.changes === 1
+			(results[baseResultIndex]?.results?.length ?? 0) > 0 ||
+			(results[baseResultIndex]?.meta as { changes?: number } | undefined)?.changes === 1
 		if (!baseChanged) {
 			const status = results[statusResultIndex]?.results?.[0]?.status
+			if (status === options.requiredStatus && options.expectedCanonicalVersion !== undefined) {
+				return { slug: existing.slug, canonicalVersionConflict: true }
+			}
 			return typeof status === 'string' ? { slug: existing.slug, statusConflict: status } : null
 		}
 		return { slug }

package/src/foundry-emit.ts

@@ -35,6 +35,9 @@ const HERO_IMAGE_KEY = /^[A-Za-z0-9][A-Za-z0-9._\-/]*$/
 export const FoundryArticleV2Schema = z
 	.object({
 		schemaVersion: z.literal(FOUNDRY_ARTICLE_SCHEMA_VERSION),
+		createOnly: z.literal(true).optional(),
+		/** Actual CMS source revision pinned by a strategy-led improvement. */
+		expectedRevisionId: z.string().uuid().optional(),
 		slug: z.string().refine(isCanonicalSlug, {
 			message: 'slug must already be canonical: lowercase a-z, 0-9 and single hyphens, 3-512 chars',
 		}),

package/src/routes/content-insights.ts

@@ -11,7 +11,11 @@ import {
 	undismissInsight,
 } from '../engine/content-insights.js'
 import { verifyHmac } from '../engine/foundry-dispatch.js'
-import { listPublishedContent, PublishedContentReadError } from '../engine/published-content.js'
+import {
+	getPublishedContentBySlug,
+	listPublishedContent,
+	PublishedContentReadError,
+} from '../engine/published-content.js'
 import { InsightsIngestPayloadSchema } from '../schema/insights-ingest.js'
 import { InsightDismissalReasonCodeSchema } from '../schema/types.js'
 import type { CmsRouteConfig } from './config.js'
@@ -56,6 +60,22 @@ const PublishedArticleStateSchema = z
 	})
 	.strict()
 
+const PublishedArticleSourceSchema = z
+	.object({
+		ok: z.literal(true),
+		schema: z.literal('cms.published-article-source.v1'),
+		site: z.string().min(1),
+		observed_at: z.string().datetime(),
+		article: PublishedArticleStateSchema.extend({
+			hero_image_url: z.string().url().nullable(),
+			body_markdown: z.string().min(1).max(1_000_000),
+			description: z.string().nullable(),
+			byline: z.string().nullable(),
+			tags: z.array(z.string()),
+		}).strict(),
+	})
+	.strict()
+
 const PublishedInputsResponseSchema = z
 	.object({
 		ok: z.literal(true),
@@ -76,6 +96,64 @@ async function publishedInputs(ctx: RouteContext, url: URL, siteId: string): Pro
 		return json({ error: 'invalid_published_mode' }, 400)
 	if (siteId === 'default') return json({ error: 'publication_identity_not_configured' }, 503)
 	if (url.searchParams.get('site') !== siteId) return json({ error: 'publication_mismatch' }, 403)
+	const articleSlug = url.searchParams.get('article')
+	if (articleSlug !== null) {
+		const slug = z
+			.string()
+			.min(1)
+			.max(512)
+			.regex(/^[a-z0-9][a-z0-9-]*$/)
+			.safeParse(articleSlug)
+		if (!slug.success || url.searchParams.has('cursor') || url.searchParams.has('limit'))
+			return json({ error: 'invalid_article_source_request' }, 400)
+		try {
+			const content = await getPublishedContentBySlug(ctx.db, slug.data)
+			if (!content || content.type !== 'article')
+				return json({ error: 'published_article_missing' }, 404)
+			const item = content.payload.item
+			let heroImageUrl: string | null = null
+			if (item.hero_image_id) {
+				const asset = await ctx.db
+					.prepare(
+						"SELECT public_url FROM media_assets WHERE id = ? AND asset_type = 'image' AND status = 'ready'",
+					)
+					.bind(item.hero_image_id)
+					.first<{ public_url: string | null }>()
+				const publicUrl = z.string().url().safeParse(asset?.public_url)
+				if (publicUrl.success) heroImageUrl = publicUrl.data
+			}
+			const result = PublishedArticleSourceSchema.safeParse({
+				ok: true,
+				schema: 'cms.published-article-source.v1',
+				site: siteId,
+				observed_at: new Date().toISOString(),
+				article: {
+					content_id: content.contentId,
+					revision_id: content.revisionId,
+					slug: content.slug,
+					title: item.title,
+					canonical_url: item.canonical_url ?? null,
+					published_at: content.publishedAt,
+					source_id: item.source_id ?? null,
+					youtube_video_id: content.metadata.videoId ?? null,
+					hero_image_id: item.hero_image_id ?? null,
+					hero_image_url: heroImageUrl,
+					hero_image_caption: item.hero_image_caption ?? null,
+					body_markdown: content.payload.content?.body_markdown,
+					description: item.description ?? null,
+					byline: item.byline ?? null,
+					tags: content.payload.tags,
+				},
+			})
+			if (!result.success) return json({ error: 'published_article_source_invalid' }, 409)
+			if (new TextEncoder().encode(JSON.stringify(result.data)).byteLength > 4 << 20)
+				return json({ error: 'published_article_source_too_large' }, 409)
+			return json(result.data)
+		} catch (error) {
+			if (error instanceof PublishedContentReadError) return json({ error: error.code }, 409)
+			throw error
+		}
+	}
 	const limit = z.coerce
 		.number()
 		.int()

package/src/routes/content.ts

@@ -235,6 +235,8 @@ export interface ContentRouteConfig extends CmsRouteConfig {
 	videoSourceProductionEnabled?: boolean
 	/** Internal machine-route constraint: atomically update only in this status. */
 	updateStatusConstraint?: ContentStatus
+	/** Internal machine-route pin; joins the existing status-constrained atomic batch. */
+	updateCanonicalVersionConstraint?: number
 	/**
 	 * Internal (Foundry machine route, M3-18): replaces ONLY the publish action's
 	 * commit step (publishContent + createRevision) with the caller's — publishOne
@@ -1807,6 +1809,7 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 			try {
 				updated = await updateContentItem(ctx.db, id, parsed.data, {
 					requiredStatus: config.updateStatusConstraint,
+					expectedCanonicalVersion: config.updateCanonicalVersionConstraint,
 					...(expectedMediaSource ? { expectedMediaSource } : {}),
 				})
 			} catch (error) {
@@ -1821,6 +1824,9 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 			if (updated.statusConflict) {
 				return json({ error: 'update_status_conflict', state: updated.statusConflict }, 409)
 			}
+			if (updated.canonicalVersionConflict) {
+				return json({ error: 'update_canonical_conflict' }, 409)
+			}
 			if (updated.mediaSourceConflict) {
 				return json({ error: 'media_source_conflict' }, 409)
 			}

package/src/routes/foundry-publish.ts

@@ -1,5 +1,6 @@
 import { isCanonicalHost, sha256Hex, verifyFoundryRequest } from '@growth-labs/foundry-signing'
 import { z } from 'zod'
+import { ContentMetadataSchema, mergePinnedArticleMetadata } from '../engine/content-metadata.js'
 import { type PublicationReconciler, publishOne } from '../engine/publication.js'
 import { PublicationCurrentSnapshotError } from '../engine/publication-current-guard.js'
 import { PublishContentValidationError } from '../engine/publisher.js'
@@ -263,6 +264,9 @@ async function mapUpdateConflict(response: Response, id: string): Promise<Respon
 	if (response.status !== 409) return response
 	try {
 		const payload = (await response.clone().json()) as { error?: unknown; state?: unknown }
+		if (payload.error === 'update_canonical_conflict') {
+			return json({ error: 'human_edit_pending', external_id: id }, 409)
+		}
 		if (payload.error === 'update_status_conflict' && typeof payload.state === 'string') {
 			return approvalConflict(id, payload.state)
 		}
@@ -470,6 +474,7 @@ async function bindAdoption(
 	config: ContentRouteConfig,
 	id: string,
 	candidate: ContentCandidate,
+	expectedVersion?: number,
 ): Promise<boolean> {
 	const sourceId = `${SOURCE_PREFIX}${id}`
 	await ctx.db.batch([
@@ -477,9 +482,17 @@ async function bindAdoption(
 			.prepare(
 				`UPDATE content_items SET source_id = ?, updated_at = unixepoch()
 				 WHERE id = ? AND deleted_at IS NULL AND type = 'article' AND source_id = ?
-				   AND NOT EXISTS (SELECT 1 FROM cms_foundry_articles WHERE content_id = ?)`,
+				   AND NOT EXISTS (SELECT 1 FROM cms_foundry_articles WHERE content_id = ?)
+				   AND (? IS NULL OR canonical_version = ?)`,
 			)
-			.bind(sourceId, candidate.id, candidate.source_id, candidate.id),
+			.bind(
+				sourceId,
+				candidate.id,
+				candidate.source_id,
+				candidate.id,
+				expectedVersion ?? null,
+				expectedVersion ?? null,
+			),
 		ctx.db
 			.prepare(
 				`INSERT INTO cms_activity_log (id, workspace_id, user_id, action, target_id, target_title, type)
@@ -518,6 +531,27 @@ async function canonicalVersion(ctx: RouteContext, contentId: string): Promise<n
 	return row?.canonical_version ?? null
 }
 
+/** A signed improvement names the actual immutable CMS revision it read. */
+async function sourceRevisionVersion(
+	ctx: RouteContext,
+	contentId: string,
+	revisionId: string,
+): Promise<number | null> {
+	const revision = await getRevision(ctx.db, contentId, revisionId)
+	if (!revision) return null
+	const item = revision.payload.item as Record<string, unknown> | undefined
+	const version = item?.canonical_version
+	if (
+		item?.id !== contentId ||
+		item.type !== 'article' ||
+		typeof version !== 'number' ||
+		!Number.isSafeInteger(version) ||
+		version < 1
+	)
+		return null
+	return (await canonicalVersion(ctx, contentId)) === version ? version : null
+}
+
 /**
  * Record what this v2 PUT wrote as a History revision (the autosave/restore
  * mechanism; it never moves the published pointer), created_by `foundry` and
@@ -595,6 +629,12 @@ async function putV2(
 	const body = parsed.data
 
 	const prior = await findArticle(ctx, id)
+	if (body.createOnly && prior && (prior.request_sha256 !== bodyHash || prior.status !== 'draft')) {
+		return json(
+			{ error: 'article_already_exists', external_id: id, content_id: prior.content_id },
+			409,
+		)
+	}
 	if (prior?.request_sha256 === bodyHash) {
 		console.info('[cms] foundry article request deduplicated', {
 			externalId: id,
@@ -610,8 +650,41 @@ async function putV2(
 	// Scheduled, review and archived items stay human-owned.
 	if (bound && !V2_WRITABLE.has(bound.status)) return approvalConflict(id, bound.status)
 
+	if (body.createOnly) {
+		if (body.expectedRevisionId) return json({ error: 'create_only_has_source_revision' }, 400)
+		if (body.adoptSourceId || bound)
+			return json({ error: 'article_already_exists', external_id: id }, 409)
+		const slugHolder = await findCandidate(ctx, 'slug', body.slug)
+		if (slugHolder) return slugConflict(id, body.slug, slugHolder.id)
+		const videoId = body.metadata?.videoId
+		if (typeof videoId !== 'string' || !/^[A-Za-z0-9_-]{11}$/.test(videoId))
+			return json({ error: 'create_only_requires_source_video' }, 400)
+		// Check the actual CMS working and immutable published projections, not
+		// just Foundry's own relationship ledger. A creation cannot adopt or edit.
+		const associated = await ctx.db
+			.prepare(`SELECT c.id FROM content_items c
+    LEFT JOIN content_revisions r ON r.id=c.published_revision_id AND r.content_id=c.id
+    WHERE c.type='article' AND c.deleted_at IS NULL AND (
+      CASE WHEN json_valid(c.metadata_json) THEN json_extract(c.metadata_json,'$.videoId') END = ?
+      OR CASE WHEN json_valid(json_extract(r.payload_json,'$.item.metadata_json')) THEN json_extract(json_extract(r.payload_json,'$.item.metadata_json'),'$.videoId') END = ?
+    ) LIMIT 1`)
+			.bind(videoId, videoId)
+			.first<{ id: string }>()
+		if (associated)
+			return json(
+				{ error: 'article_video_already_exists', external_id: id, content_id: associated.id },
+				409,
+			)
+	}
 	let adoption: Adoption | null = null
+	let expectedSourceVersion: number | undefined
 	if (bound) {
+		if (body.expectedRevisionId) {
+			const version = await sourceRevisionVersion(ctx, bound.id, body.expectedRevisionId)
+			if (version === null) return json({ error: 'human_edit_pending', external_id: id }, 409)
+			expectedSourceVersion = version
+		}
+
 		const holder = await findCandidate(ctx, 'slug', body.slug)
 		if (holder && holder.id !== bound.id) return slugConflict(id, body.slug, holder.id)
 	} else {
@@ -619,7 +692,12 @@ async function putV2(
 		if ('error' in resolved) return resolved.error
 		if (resolved.candidate && resolved.matchedBy) {
 			const candidate = resolved.candidate
-			if (!(await bindAdoption(ctx, config, id, candidate))) {
+			if (body.expectedRevisionId) {
+				const version = await sourceRevisionVersion(ctx, candidate.id, body.expectedRevisionId)
+				if (version === null) return json({ error: 'human_edit_pending', external_id: id }, 409)
+				expectedSourceVersion = version
+			}
+			if (!(await bindAdoption(ctx, config, id, candidate, expectedSourceVersion))) {
 				return json(
 					{
 						error: 'adoption_conflict',
@@ -656,11 +734,34 @@ async function putV2(
 		}
 	}
 
-	// The canonical version Foundry's write must produce is one over this.
-	const priorVersion = bound ? await canonicalVersion(ctx, bound.id) : null
+	// Preserve a newer human working copy before PUT, not merely at publication.
+	// The native update pins this same canonical version in its atomic batch.
+	if (body.expectedRevisionId && !bound)
+		return json({ error: 'source_revision_missing', external_id: id }, 409)
+	const priorVersion =
+		expectedSourceVersion ?? (bound ? await canonicalVersion(ctx, bound.id) : null)
 	const heroImageId = body.hero_image_url
 		? await heroAssetId(body.hero_image_url)
 		: (body.hero_image_key ?? undefined)
+	// A pinned improvement augments its exact source metadata. Existing dates,
+	// image provenance and other recorded fields survive preparation updates.
+	let metadata = body.metadata
+	if (body.expectedRevisionId && body.metadata !== undefined && bound) {
+		const source = await getRevision(ctx.db, bound.id, body.expectedRevisionId)
+		let original: unknown
+		try {
+			original = JSON.parse(String(source?.payload.item?.metadata_json ?? '{}'))
+		} catch {
+			return json({ error: 'source_metadata_invalid', external_id: id }, 409)
+		}
+		const recorded = ContentMetadataSchema.safeParse(original)
+		if (!recorded.success) return json({ error: 'source_metadata_invalid', external_id: id }, 409)
+		const merged = ContentMetadataSchema.safeParse(
+			mergePinnedArticleMetadata(recorded.data, body.metadata),
+		)
+		if (!merged.success) return json({ error: 'source_metadata_invalid', external_id: id }, 409)
+		metadata = merged.data
+	}
 	const nativeBody = {
 		title: body.title,
 		slug: body.slug,
@@ -672,7 +773,7 @@ async function putV2(
 		...(body.desk !== undefined ? { primaryCategory: body.desk } : {}),
 		...(body.tags !== undefined ? { tags: body.tags } : {}),
 		...(body.visibility !== undefined ? { visibility: body.visibility } : {}),
-		...(body.metadata !== undefined ? { metadata: body.metadata } : {}),
+		...(metadata !== undefined ? { metadata } : {}),
 		content: { bodyMarkdown: body.body_html, bodyHtml: body.body_html },
 	}
 
@@ -681,7 +782,12 @@ async function putV2(
 		// Each write is a CAS on the status it was read in: a draft stays a
 		// draft write, and a published item is edited in place only while it is
 		// still published (its live revision changes only on POST /publish).
-		const writer = bound.status === 'published' ? handlers.published : handlers.draft
+		if (priorVersion === null) return json({ error: 'human_edit_pending', external_id: id }, 409)
+		const writer = createContentRoutes({
+			...machineConfig(config),
+			updateStatusConstraint: bound.status,
+			updateCanonicalVersionConstraint: priorVersion,
+		})
 		nativeResponse = await mapUpdateConflict(
 			await writer.update(nativeContext(ctx, 'PATCH', nativeBody, { id: bound.id })),
 			id,
@@ -698,6 +804,8 @@ async function putV2(
 			)
 		} catch (error) {
 			const raced = await findContentBySource(ctx, id)
+			if (body.createOnly && raced)
+				return json({ error: 'article_already_exists', external_id: id, content_id: raced.id }, 409)
 			if (raced?.type !== 'article') throw error
 			nativeResponse = await mapUpdateConflict(
 				await handlers.draft.update(nativeContext(ctx, 'PATCH', nativeBody, { id: raced.id })),

package/src/ui/editor/ContentForm.tsx

@@ -33,7 +33,7 @@ import {
 	applyMediaSourceReadiness,
 	buildContentCreatePayload,
 	buildContentUpdatePayload,
-	canCreateContentDraft,
+	contentDraftSaveError,
 	foundryDispatchSourceForDraft,
 	initialContentMetadata,
 	type MediaSourceReadinessPayload,
@@ -406,19 +406,14 @@ export function ContentForm({
 			const draft = currentForm
 
 			if (id === null) {
-				if (
-					!canCreateContentDraft(contentType, draft, {
-						requirePrimaryTopic: primaryTopicEnabled,
-					})
-				) {
-					const mediaSource = foundryDispatchSourceForDraft(contentType, draft)
-					const missingMediaDuration =
-						mediaSource && normalizeMediaDurationSeconds(draft.durationSeconds) === null
+				const saveError = contentDraftSaveError(contentType, draft, {
+					requirePrimaryTopic: primaryTopicEnabled,
+					primaryTopicLabel: primaryTopic?.label,
+				})
+				if (saveError) {
 					setForm((prev) => ({
 						...prev,
-						saveError: missingMediaDuration
-							? 'Enter the authoritative media duration in whole seconds before saving.'
-							: 'Add the required title and content before saving.',
+						saveError,
 					}))
 					return
 				}
@@ -543,7 +538,7 @@ export function ContentForm({
 				}
 			}
 		},
-		[contentType, onDocCreated, primaryTopicEnabled, queueFoundryProcessing],
+		[contentType, onDocCreated, primaryTopicEnabled, primaryTopic?.label, queueFoundryProcessing],
 	)
 
 	useEffect(() => {