@growth-labs/cms 0.6.7 → 0.7.0

package/src/engine/published-content.ts

@@ -54,6 +54,16 @@ export interface PublishedContent {
 	type: ContentType
 	publishedAt: number
 	updatedAt: number
+	/**
+	 * Row creation time (unix seconds), from the published revision snapshot.
+	 *
+	 * Distinct from `publishedAt`, which is the date the article *claims* and is
+	 * deliberately backdated to the source video's date on the channel sites.
+	 * Consumers pass this to `resolveAdaptedArticleDates` as the `createdAt`
+	 * fallback for `datePublished`; without it that fallback is dead code.
+	 * `undefined` only for a revision snapshot predating the column.
+	 */
+	createdAt: number | undefined
 	payload: ContentRevisionPayload
 	metadata: ContentMetadata
 }
@@ -358,6 +368,9 @@ function decodePublishedContent(row: PublishedContentRow, requireBodies = true):
 		type: item.type as ContentType,
 		publishedAt: row.canonical_published_at,
 		updatedAt: item.updated_at as number,
+		// getContentSnapshot selects * from content_items, so created_at rides
+		// along in the revision payload; no extra column selection needed.
+		createdAt: Number.isSafeInteger(item.created_at) ? (item.created_at as number) : undefined,
 		payload,
 		metadata,
 	}

package/src/engine/publisher.ts

@@ -1464,16 +1464,129 @@ export async function assertContentBodyValidForPublish(
 	}
 }
 
+/**
+ * Publish-time date stamping on `content_items.metadata_json`.
+ *
+ * Adapted articles (an article written from a YouTube video script) need two
+ * dates the row did not previously carry:
+ *
+ * - `adaptedAt` — the date the article first went live **on the site**. This is
+ *   what `@growth-labs/seo`'s `resolveAdaptedArticleDates` turns into JSON-LD
+ *   `datePublished`.
+ * - `updatedAt` — the date of the most recent re-publish, which becomes
+ *   `dateModified`.
+ *
+ * ## The distinction that matters: claimed date vs. wall clock
+ *
+ * `published_at` is the date the article *claims*, and on all ten channel sites
+ * it is deliberately backdated to the **YouTube video's** publish date — that is
+ * the whole reason these two keys exist. `adaptedAt` and `updatedAt` are the
+ * opposite: the wall-clock moment the publish transition actually committed.
+ *
+ * Deriving either of them from the publish timestamp would collapse
+ * `datePublished` straight back onto the video date and make the feature a
+ * no-op for every future article. So the stamp takes its own `now` value,
+ * distinct from `publishedAt`, at every call site.
+ *
+ * Invariants:
+ * - `adaptedAt` is written once and **never rewritten**. It is the article's
+ *   identity date; rewriting it would walk `datePublished` forward on every edit.
+ * - A re-publish stamps `updatedAt` at wall clock. A first publish does not —
+ *   `dateModified` defaults to `datePublished` in the consumer. Wall clock also
+ *   means a backdated re-publish cannot emit a `dateModified` before
+ *   `datePublished`, and a scheduled forward-dated publish cannot emit a
+ *   *future* `dateModified` (a Discover quality signal problem that the seo
+ *   helper's clamp does not catch).
+ * - A row already published before this shipped has no `adaptedAt`. It is
+ *   backfilled from `COALESCE(created_at, published_at)` — `created_at` is the
+ *   real row-creation moment, whereas `published_at` is the claimed (possibly
+ *   backdated) date. The two are equal on exactly the rows that need the
+ *   backfill, so this is a no-op on current data and correct by construction
+ *   rather than by coincidence. `content_items.created_at` is NOT NULL, so the
+ *   `published_at` arm of that COALESCE is unreachable by schema and kept only
+ *   as defence in depth — there is deliberately no test for it, because no test
+ *   can construct the state.
+ *
+ * Expressed as SQL rather than read-modify-write so the stamp lands in the same
+ * atomic statement as the publish transition. A separate UPDATE would open a
+ * window where an item is published but unstamped, and in the 2PC kernel it
+ * would not be covered by the pointer CAS. In SQLite the right-hand side of a
+ * SET clause sees the row's **pre-update** values, so `published_at` and
+ * `created_at` below are the previous values, which is what the backfill needs.
+ *
+ * Malformed or absent `metadata_json` degrades to `{}` rather than failing the
+ * publish; `json_set` on invalid JSON would otherwise throw and block the item.
+ */
+const METADATA_OBJECT_SQL = `CASE
+	WHEN metadata_json IS NOT NULL AND json_valid(metadata_json) AND json_type(metadata_json) = 'object'
+	THEN metadata_json
+	ELSE '{}'
+END`
+
+/**
+ * `metadata_json` with `adaptedAt` resolved:
+ * already set → untouched; previously published → backfilled from the row's own
+ * creation time; otherwise a genuine first publish → the wall clock `?`.
+ */
+const METADATA_WITH_ADAPTED_AT_SQL = `CASE
+	WHEN json_extract(${METADATA_OBJECT_SQL}, '$.adaptedAt') IS NOT NULL
+	THEN ${METADATA_OBJECT_SQL}
+	WHEN published_at IS NOT NULL
+	THEN json_set(${METADATA_OBJECT_SQL}, '$.adaptedAt', date(COALESCE(created_at, published_at), 'unixepoch'))
+	ELSE json_set(${METADATA_OBJECT_SQL}, '$.adaptedAt', date(?, 'unixepoch'))
+END`
+
+/**
+ * The full `metadata_json = ...` assignment. Append to a publish UPDATE's SET
+ * clause and bind with {@link publishMetadataStampBinds}.
+ *
+ * "Already published" is `published_at IS NOT NULL OR adaptedAt IS NOT NULL` —
+ * the second disjunct keeps unpublish→republish correct, since `unpublishContent`
+ * clears `published_at` but the article did go live once.
+ */
+export const PUBLISH_METADATA_STAMP_SQL = `metadata_json = CASE
+	WHEN published_at IS NOT NULL
+		OR json_extract(${METADATA_OBJECT_SQL}, '$.adaptedAt') IS NOT NULL
+	THEN json_set(${METADATA_WITH_ADAPTED_AT_SQL}, '$.updatedAt', date(?, 'unixepoch'))
+	ELSE ${METADATA_WITH_ADAPTED_AT_SQL}
+END`
+
+/** Placeholder count in {@link PUBLISH_METADATA_STAMP_SQL}, derived so it cannot drift. */
+const PUBLISH_METADATA_STAMP_PLACEHOLDERS = (PUBLISH_METADATA_STAMP_SQL.match(/\?/g) ?? []).length
+
+/** Wall-clock unix seconds — the moment a publish transition commits. */
+export function nowSeconds(): number {
+	return Math.floor(Date.now() / 1000)
+}
+
+/**
+ * Binds for {@link PUBLISH_METADATA_STAMP_SQL}. Every placeholder is the same
+ * wall-clock `now` (unix seconds) — deliberately NOT the publish timestamp,
+ * which is routinely backdated. The count is derived from the SQL itself so
+ * editing the expression cannot silently desynchronize the bind list.
+ */
+export function publishMetadataStampBinds(now: number): number[] {
+	return new Array(PUBLISH_METADATA_STAMP_PLACEHOLDERS).fill(now)
+}
+
+/**
+ * @param publishedAt the date the article claims — may be deliberately backdated.
+ * @param now wall-clock unix seconds for the date stamps; defaults to real now.
+ *   Kept separate from `publishedAt` on purpose (see PUBLISH_METADATA_STAMP_SQL)
+ *   and injectable so tests stay deterministic.
+ */
 export async function publishContent(
 	db: D1Database,
 	id: string,
 	publishedAt: number,
+	now: number = nowSeconds(),
 ): Promise<void> {
 	await db
 		.prepare(
-			`UPDATE content_items SET status = 'published', published_at = ?, publish_at = NULL, updated_at = unixepoch() WHERE id = ?`,
+			`UPDATE content_items SET status = 'published', published_at = ?, publish_at = NULL, updated_at = unixepoch(),
+			 ${PUBLISH_METADATA_STAMP_SQL} WHERE id = ?`,
 		)
-		.bind(publishedAt, id)
+		.bind(publishedAt, ...publishMetadataStampBinds(now), id)
 		.run()
 }
 
@@ -1493,14 +1606,16 @@ export async function claimScheduledForPublish(
 	db: D1Database,
 	id: string,
 	publishedAt: number,
+	now: number = nowSeconds(),
 ): Promise<boolean> {
 	const res = await db
 		.prepare(
 			`UPDATE content_items
-			 SET status = 'published', published_at = ?, publish_at = NULL, updated_at = unixepoch()
+			 SET status = 'published', published_at = ?, publish_at = NULL, updated_at = unixepoch(),
+			     ${PUBLISH_METADATA_STAMP_SQL}
 			 WHERE id = ? AND status = 'scheduled'`,
 		)
-		.bind(publishedAt, id)
+		.bind(publishedAt, ...publishMetadataStampBinds(now), id)
 		.run()
 	const changes = (res.meta as { changes?: number } | undefined)?.changes ?? 0
 	return changes > 0

package/src/integration/options.ts

@@ -13,6 +13,28 @@ const primaryCategorySchema = z.object({
 	label: z.string().min(1),
 })
 
+const contentTypeSchema = z.enum(['article', 'video', 'podcast', 'newsletter', 'page'])
+
+const primaryTopicControlSchema = z
+	.object({
+		label: z.string().trim().min(1).max(100),
+		contentTypes: z.array(contentTypeSchema).min(1),
+		options: z.array(primaryCategorySchema).min(1),
+	})
+	.strict()
+	.superRefine((control, ctx) => {
+		const slugs = control.options.map(({ slug }) => slug)
+		if (new Set(slugs).size !== slugs.length) {
+			ctx.addIssue({
+				code: 'custom',
+				path: ['options'],
+				message: 'primary topic option slugs must be unique',
+			})
+		}
+	})
+
+export type PrimaryTopicControl = z.output<typeof primaryTopicControlSchema>
+
 const contentMetadataKeySchema = z
 	.string()
 	.regex(/^[a-z][a-z0-9_]{0,63}$/, 'metadata keys must be lowercase snake_case')
@@ -106,6 +128,7 @@ export const cmsIntegrationOptionsSchema = z
 	.object({
 		workspaces: z.array(workspaceSchema).min(1, 'at least one workspace is required'),
 		primaryCategories: z.array(primaryCategorySchema).default([]),
+		primaryTopic: primaryTopicControlSchema.optional(),
 		contentMetadataSelects: contentMetadataSelectsSchema,
 		activeWorkspaceId: z.string().optional(),
 		adminBasePath: z.string().default('/admin'),

package/src/routes/config.ts

@@ -6,6 +6,7 @@
 import type { OgImageRenderer } from '../engine/og-render.js'
 import { nullProviders } from '../providers/null.js'
 import type { CmsProviders, FoundryDispatch, LlmDispatch } from '../providers/types.js'
+import type { ContentType } from '../schema/types.js'
 import type { Authz } from './context.js'
 
 /**
@@ -35,6 +36,8 @@ export interface CmsRouteConfig {
 	primaryTopicSlugs?: readonly [string, ...string[]]
 	/** Default primary topic for create (Fronts: 'global'). */
 	defaultPrimaryTopic?: string
+	/** Content types for which `primaryTopic` is required on create. */
+	requiredPrimaryTopicContentTypes?: readonly ContentType[]
 
 	/** R2 binding name recorded on media rows. Fronts default: 'PUBLIC_MEDIA'. */
 	mediaR2Binding?: string
@@ -66,6 +69,7 @@ export interface ResolvedCmsRouteConfig {
 	defaultPrimaryCategory: string
 	primaryTopicSlugs: readonly string[] | null
 	defaultPrimaryTopic: string
+	requiredPrimaryTopicContentTypes: readonly ContentType[]
 	mediaR2Binding: string
 	mediaSiteId: string
 	mediaPublicDomain: string
@@ -88,6 +92,7 @@ export function resolveConfig(config: CmsRouteConfig): ResolvedCmsRouteConfig {
 		defaultPrimaryCategory: config.defaultPrimaryCategory ?? 'analysis',
 		primaryTopicSlugs: config.primaryTopicSlugs ?? null,
 		defaultPrimaryTopic: config.defaultPrimaryTopic ?? 'global',
+		requiredPrimaryTopicContentTypes: config.requiredPrimaryTopicContentTypes ?? [],
 		mediaR2Binding: config.mediaR2Binding ?? 'PUBLIC_MEDIA',
 		mediaSiteId: config.mediaSiteId ?? 'fronts',
 		mediaPublicDomain: config.mediaPublicDomain ?? 'media.fronts.co',

package/src/routes/content.ts

@@ -392,13 +392,16 @@ function buildSchemas(resolved: ReturnType<typeof resolveConfig>) {
 		tags: z.array(z.string()).optional(),
 		metadata: ContentMetadataSchema.optional(),
 	})
+	const requiredTopicTypes = new Set(resolved.requiredPrimaryTopicContentTypes)
+	const baseSchemaFor = (type: ContentType) =>
+		requiredTopicTypes.has(type) ? BaseSchema.extend({ primaryTopic: topic }) : BaseSchema
 
 	const CreateSchema = z.discriminatedUnion('type', [
-		BaseSchema.extend({
+		baseSchemaFor('article').extend({
 			type: z.literal('article'),
 			content: BodyContentCreateSchema,
 		}),
-		BaseSchema.extend({
+		baseSchemaFor('video').extend({
 			type: z.literal('video'),
 			content: z.object({
 				script: z.string().default(''),
@@ -409,7 +412,7 @@ function buildSchemas(resolved: ReturnType<typeof resolveConfig>) {
 				processingSourceKind: z.string().min(1).optional().nullable(),
 			}),
 		}),
-		BaseSchema.extend({
+		baseSchemaFor('podcast').extend({
 			type: z.literal('podcast'),
 			content: z.object({
 				// Empty allowed: a podcast is created as a draft with audio uploaded
@@ -429,11 +432,11 @@ function buildSchemas(resolved: ReturnType<typeof resolveConfig>) {
 				processingSourceKind: z.string().min(1).optional().nullable(),
 			}),
 		}),
-		BaseSchema.extend({
+		baseSchemaFor('newsletter').extend({
 			type: z.literal('newsletter'),
 			content: BodyContentCreateSchema,
 		}),
-		BaseSchema.extend({
+		baseSchemaFor('page').extend({
 			type: z.literal('page'),
 			content: BodyContentCreateSchema,
 		}),

package/src/ui/api/_content-config.ts

@@ -1,6 +1,7 @@
 // src/ui/api/_content-config.ts — shared helpers for content + tag Astro endpoint adapters.
 // Builds a RouteContext and a ContentRouteConfig from an APIContext at request time.
 
+import { config } from 'virtual:growth-labs/cms/config'
 import type { APIContext } from 'astro'
 import type {
 	ContentRouteConfig,
@@ -62,8 +63,16 @@ export function toContentCtx(c: APIContext, params?: Record<string, string>): Ro
 export function toContentConfig(c: APIContext): ContentRouteConfig {
 	const locals = c.locals as { cmsHooks?: CmsHooksLocals }
 	const hooks = locals.cmsHooks ?? {}
+	const primaryTopicSlugs = config.primaryTopic?.options.map(
+		(option: { slug: string }) => option.slug,
+	)
 	return {
 		authz: buildSiteAuthz(c),
+		primaryTopicSlugs:
+			primaryTopicSlugs && primaryTopicSlugs.length > 0
+				? (primaryTopicSlugs as [string, ...string[]])
+				: undefined,
+		requiredPrimaryTopicContentTypes: config.primaryTopic?.contentTypes,
 		activeWorkspaceId: hooks.activeWorkspaceId,
 		hooks: {
 			llm: hooks.llm,

package/src/ui/client/mount.tsx

@@ -39,6 +39,7 @@ export async function mount(elementId = 'masthead-root') {
 	const screens = createCmsScreens({
 		allowInlineAuthorCreation: config.socialSharing.allowInlineAuthorCreation,
 		primaryCategories: config.primaryCategories,
+		primaryTopic: config.primaryTopic,
 		contentMetadataSelects: config.contentMetadataSelects,
 		surveyId: config.surveyResults?.surveyId,
 	})

package/src/ui/editor/ContentForm.tsx

@@ -21,7 +21,7 @@
 import { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react'
 import { type ContentMetadata, parseContentMetadata } from '../../engine/content-metadata.js'
 import { countWords, estimateReadTime } from '../../engine/publisher.js'
-import type { ContentMetadataSelectField } from '../../integration/options.js'
+import type { ContentMetadataSelectField, PrimaryTopicControl } from '../../integration/options.js'
 import type { ContentStatus, ContentType, FrontsPublishStatus } from '../../schema/types.js'
 import { Icon } from '../icons.js'
 import { uploadMediaAsset } from '../screens/media-upload.js'
@@ -76,6 +76,7 @@ export interface ContentFormProps {
 	/** Called when save state changes so editor chrome can show a real save action. */
 	onSaveStateChange?: (state: ContentSaveState) => void
 	primaryCategories?: Array<{ slug: string; label: string }>
+	primaryTopic?: PrimaryTopicControl
 	contentMetadataSelects?: ContentMetadataSelectField[]
 }
 
@@ -117,6 +118,7 @@ interface ExistingContentItem {
 	author_name?: string | null
 	author_slug?: string | null
 	channel?: string | null
+	primary_topic?: string | null
 	published_at?: number | null
 	hero_image_id?: string | null
 	hero_image_url?: string | null
@@ -165,6 +167,7 @@ interface FormState {
 	publishedAt: string | null
 	premium: boolean
 	channel: string | null
+	primaryTopic: string | null | undefined
 	metadata: ContentMetadata
 	heroImageId: string
 	heroImageUrl: string | null
@@ -224,6 +227,7 @@ function createEmptyFormState(docId: string | null, metadata: ContentMetadata =
 		publishedAt: null,
 		premium: false,
 		channel: null,
+		primaryTopic: undefined,
 		metadata,
 		heroImageId: '',
 		heroImageUrl: null,
@@ -270,8 +274,10 @@ export function ContentForm({
 	onFrontsPublishStatusChange,
 	onSaveStateChange,
 	primaryCategories = [],
+	primaryTopic,
 	contentMetadataSelects = EMPTY_CONTENT_METADATA_SELECTS,
 }: ContentFormProps) {
+	const primaryTopicEnabled = primaryTopic?.contentTypes.includes(contentType) ?? false
 	const metadataFields = useMemo(
 		() => contentMetadataSelects.filter((field) => field.contentTypes.includes(contentType)),
 		[contentMetadataSelects, contentType],
@@ -314,6 +320,7 @@ export function ContentForm({
 			}
 			const data = (await res.json()) as ExistingContentResponse
 			const next = contentResponseToFormState(data, contentType, docId)
+			if (!primaryTopicEnabled) next.primaryTopic = undefined
 			setForm((prev) => ({
 				...next,
 				aiOpen: prev.aiOpen,
@@ -334,6 +341,7 @@ export function ContentForm({
 		metadataFields,
 		onStatusChange,
 		onFrontsPublishStatusChange,
+		primaryTopicEnabled,
 		publishDraft,
 	])
 
@@ -402,7 +410,11 @@ export function ContentForm({
 			const draft: ContentDraftFields = currentForm
 
 			if (id === null) {
-				if (!canCreateContentDraft(contentType, draft)) {
+				if (
+					!canCreateContentDraft(contentType, draft, {
+						requirePrimaryTopic: primaryTopicEnabled,
+					})
+				) {
 					const mediaSource = foundryDispatchSourceForDraft(contentType, draft)
 					const missingMediaDuration =
 						mediaSource && normalizeMediaDurationSeconds(draft.durationSeconds) === null
@@ -537,7 +549,7 @@ export function ContentForm({
 				}
 			}
 		},
-		[contentType, onDocCreated, queueFoundryProcessing],
+		[contentType, onDocCreated, primaryTopicEnabled, queueFoundryProcessing],
 	)
 
 	useEffect(() => {
@@ -603,6 +615,13 @@ export function ContentForm({
 		scheduleAutosave(next)
 	}
 
+	function handlePrimaryTopicChange(value: string) {
+		const next = { ...latestForm.current, primaryTopic: value || null }
+		setForm(next)
+		publishDraft(next)
+		scheduleAutosave(next)
+	}
+
 	function handleMetadataSelectChange(field: ContentMetadataSelectField, value: string) {
 		const next = {
 			...latestForm.current,
@@ -999,6 +1018,28 @@ export function ContentForm({
 				</div>
 			)}
 
+			{primaryTopicEnabled && primaryTopic && (
+				<div style={fieldGroup}>
+					<label style={{ display: 'grid', gap: 6, fontSize: 12, color: 'var(--ink-muted)' }}>
+						{primaryTopic.label}
+						<select
+							value={form.primaryTopic ?? ''}
+							onChange={(event) => handlePrimaryTopicChange(event.currentTarget.value)}
+							aria-label={primaryTopic.label}
+							required
+							style={urlInput}
+						>
+							<option value="">Select {primaryTopic.label.toLowerCase()}…</option>
+							{primaryTopic.options.map((option) => (
+								<option key={option.slug} value={option.slug}>
+									{option.label}
+								</option>
+							))}
+						</select>
+					</label>
+				</div>
+			)}
+
 			{metadataFields.map((field) => {
 				const storedValue = form.metadata[field.key]
 				const value = typeof storedValue === 'string' ? storedValue : ''
@@ -1645,6 +1686,7 @@ function contentResponseToFormState(
 	next.publishedAt = unixSecondsToIso(item.published_at)
 	next.premium = item.visibility === 'premium'
 	next.channel = toNullableString(item.channel)
+	next.primaryTopic = toNullableString(item.primary_topic)
 	next.metadata = storedContentMetadata(item.metadata_json)
 	next.heroImageId = heroImageId
 	next.heroImageUrl = heroImageUrl || (heroImageId ? mediaUrlFromId(heroImageId) : null)

package/src/ui/editor/content-payload.ts

@@ -21,6 +21,7 @@ export interface ContentDraftFields {
 	podcastSourceKind?: string | null
 	durationSeconds: number | null
 	channel?: string | null
+	primaryTopic?: string | null
 	metadata?: ContentMetadata
 }
 
@@ -116,8 +117,10 @@ export function slugifyTitle(title: string): string {
 export function canCreateContentDraft(
 	contentType: ContentType,
 	draft: ContentDraftFields,
+	requirements: { requirePrimaryTopic?: boolean } = {},
 ): boolean {
 	if (draft.title.trim().length < 3) return false
+	if (requirements.requirePrimaryTopic && !draft.primaryTopic?.trim()) return false
 	if (contentType === 'article' || contentType === 'newsletter' || contentType === 'page') {
 		return draft.body.trim().length > 0
 	}
@@ -181,6 +184,10 @@ export function buildContentUpdatePayload(
 	if (draft.metadata !== undefined) payload.metadata = draft.metadata
 	const channel = draft.channel?.trim()
 	payload.primaryCategory = channel || null
+	if (draft.primaryTopic !== undefined) {
+		const primaryTopic = draft.primaryTopic?.trim()
+		payload.primaryTopic = primaryTopic || null
+	}
 	const heroImageId = draft.heroImageId?.trim()
 	if (heroImageId) {
 		payload.heroImageId = heroImageId
@@ -249,5 +256,6 @@ export function buildContentCreatePayload(
 		...buildContentUpdatePayload(contentType, draft),
 	}
 	if (payload.primaryCategory === null) delete payload.primaryCategory
+	if (payload.primaryTopic === null) delete payload.primaryTopic
 	return payload
 }

package/src/ui/screens/ContentRoute.tsx

@@ -8,7 +8,7 @@
 // This file creates thin stubs so the registry can compile now (Task 10).
 
 import { useReducer } from 'react'
-import type { ContentMetadataSelectField } from '../../integration/options.js'
+import type { ContentMetadataSelectField, PrimaryTopicControl } from '../../integration/options.js'
 import { type ContentType, contentViewReducer, initialContentView } from './content-view.js'
 import { EditorScreen } from './EditorScreen.js'
 import { LibraryScreen } from './LibraryScreen.js'
@@ -16,10 +16,12 @@ import { LibraryScreen } from './LibraryScreen.js'
 export function ContentRoute({
 	allowInlineAuthorCreation = true,
 	primaryCategories = [],
+	primaryTopic,
 	contentMetadataSelects = [],
 }: {
 	allowInlineAuthorCreation?: boolean
 	primaryCategories?: Array<{ slug: string; label: string }>
+	primaryTopic?: PrimaryTopicControl
 	contentMetadataSelects?: ContentMetadataSelectField[]
 }) {
 	const [view, dispatch] = useReducer(contentViewReducer, initialContentView)
@@ -52,6 +54,7 @@ export function ContentRoute({
 			onClose={handleClose}
 			allowInlineAuthorCreation={allowInlineAuthorCreation}
 			primaryCategories={primaryCategories}
+			primaryTopic={primaryTopic}
 			contentMetadataSelects={contentMetadataSelects}
 		/>
 	)

package/src/ui/screens/EditorScreen.tsx

@@ -17,7 +17,7 @@
 // is Playwright-smoked only.
 
 import { useCallback, useState } from 'react'
-import type { ContentMetadataSelectField } from '../../integration/options.js'
+import type { ContentMetadataSelectField, PrimaryTopicControl } from '../../integration/options.js'
 import type { ContentStatus, ContentType, FrontsPublishStatus } from '../../schema/types.js'
 import { buildSharePrefill, ShareModal } from '../components/ShareModal.js'
 import {
@@ -41,6 +41,7 @@ export interface EditorScreenProps {
 	onClose: () => void
 	allowInlineAuthorCreation?: boolean
 	primaryCategories?: Array<{ slug: string; label: string }>
+	primaryTopic?: PrimaryTopicControl
 	contentMetadataSelects?: ContentMetadataSelectField[]
 }
 
@@ -101,6 +102,7 @@ export function EditorScreen({
 	onClose,
 	allowInlineAuthorCreation = true,
 	primaryCategories = [],
+	primaryTopic,
 	contentMetadataSelects = [],
 }: EditorScreenProps) {
 	const contentType: ContentType = (docRef.contentType as ContentType | undefined) ?? 'article'
@@ -410,6 +412,7 @@ export function EditorScreen({
 								onFrontsPublishStatusChange={setFrontsPublishStatus}
 								onSaveStateChange={handleSaveStateChange}
 								primaryCategories={primaryCategories}
+								primaryTopic={primaryTopic}
 								contentMetadataSelects={contentMetadataSelects}
 							/>
 						</div>

package/src/ui/screens/registry.tsx

@@ -11,7 +11,7 @@
 // internal router state (which is not exported). The ContentRoute itself owns
 // the full open-doc reducer (which doc is open, new vs existing).
 
-import type { ContentMetadataSelectField } from '../../integration/options.js'
+import type { ContentMetadataSelectField, PrimaryTopicControl } from '../../integration/options.js'
 import type { ScreenRegistry } from '../components/CmsApp.js'
 import { useHashRouter } from '../use-hash-router.js'
 import { AnalyticsScreen } from './AnalyticsScreen.js'
@@ -43,11 +43,13 @@ function CalendarRoute() {
 export function createCmsScreens({
 	allowInlineAuthorCreation = true,
 	primaryCategories = [],
+	primaryTopic,
 	contentMetadataSelects = [],
 	surveyId,
 }: {
 	allowInlineAuthorCreation?: boolean
 	primaryCategories?: Array<{ slug: string; label: string }>
+	primaryTopic?: PrimaryTopicControl
 	contentMetadataSelects?: ContentMetadataSelectField[]
 	surveyId?: string
 } = {}): ScreenRegistry {
@@ -56,6 +58,7 @@ export function createCmsScreens({
 			<ContentRoute
 				allowInlineAuthorCreation={allowInlineAuthorCreation}
 				primaryCategories={primaryCategories}
+				primaryTopic={primaryTopic}
 				contentMetadataSelects={contentMetadataSelects}
 			/>
 		),