@growth-labs/cms 0.6.6 → 0.6.8

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

@@ -197,6 +197,8 @@ export interface ContentRouteConfig extends CmsRouteConfig {
 	dispatchFaq?: DispatchFaqHook
 	/** Optional host-specific readiness guard. A not-ready result blocks publish. */
 	publishReadiness?: PublishReadinessHook
+	/** Host's existing production rollback control; omitted means enabled. */
+	podcastSourceProductionEnabled?: boolean
 	/** Internal machine-route constraint: atomically update only in this status. */
 	updateStatusConstraint?: ContentStatus
 	/**
@@ -390,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(''),
@@ -407,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
@@ -427,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,
 		}),
@@ -1890,7 +1895,7 @@ export function createContentRoutes(config: ContentRouteConfig): ContentRouteHan
 			if (action === 'archive') {
 				await ctx.db
 					.prepare(
-						"UPDATE content_items SET status = 'archived', updated_at = unixepoch() WHERE id = ?",
+						"UPDATE content_items SET status = 'archived', updated_at = unixepoch(), canonical_version = canonical_version + 1 WHERE id = ? AND status <> 'archived'",
 					)
 					.bind(id)
 					.run()

package/src/routes/fronts-publish.ts

@@ -29,9 +29,13 @@ import {
 	isFrontsPublishEnabled,
 	listFrontsPublishSchedule,
 } from '../engine/fronts-publish.js'
-import { hydrateFrontsPublishIntents } from '../engine/fronts-publish-intent.js'
+import {
+	FrontsScheduleOverflowError,
+	hydrateFrontsPublishIntents,
+} from '../engine/fronts-publish-intent.js'
 import { publicUrlFor } from '../ui/screens/public-url.js'
-import { type CmsRouteConfig, resolveConfig } from './config.js'
+import { resolveConfig } from './config.js'
+import type { ContentRouteConfig } from './content.js'
 import { json, type RouteContext } from './context.js'
 
 /**
@@ -112,6 +116,7 @@ const CallbackSchema = z
 		intent_id: z.string().min(1).nullish(),
 		content_id: z.string().min(1),
 		version: z.number().int().nullish(),
+		publish_at: z.number().int().positive().nullish(),
 		correlation_id: z.string().min(1).nullish(),
 		status: z.enum(['queued', 'publishing', 'live', 'late', 'failed']),
 		occurred_at: z.union([z.string(), z.number()]).nullish(),
@@ -151,7 +156,7 @@ function parseWindow(
 	return { fromSeconds, toSeconds }
 }
 
-export function createFrontsPublishRoutes(config: CmsRouteConfig): FrontsPublishRouteHandlers {
+export function createFrontsPublishRoutes(config: ContentRouteConfig): FrontsPublishRouteHandlers {
 	const resolved = resolveConfig(config)
 	return {
 		async schedule(ctx) {
@@ -184,28 +189,37 @@ export function createFrontsPublishRoutes(config: CmsRouteConfig): FrontsPublish
 			// predicate, and `incomplete` names every due item that cannot form a
 			// complete intent, so a missing canonical field is an explicit, visible
 			// contract error rather than a silently short `intents` array.
-			const items = await listFrontsPublishSchedule(ctx.db, {
-				toSeconds: window.toSeconds,
-				nowSeconds: now,
-			})
-			const hydrated = await hydrateFrontsPublishIntents(ctx.db, {
-				toSeconds: window.toSeconds,
-				nowSeconds: now,
-				mediaPublicDomain: resolved.mediaPublicDomain,
-				// Site-RELATIVE paths: the CMS does not know the site origin, and the
-				// consumer joins its own trusted configured origin. A host-supplied
-				// origin is deliberately deferred (packages-docs/cms.md).
-				resolveContentUrl: (row) => publicUrlFor(row),
-			})
-			return json({
-				ok: true,
-				now,
-				window: { from: window.fromSeconds, to: window.toSeconds },
-				count: items.length,
-				items,
-				intents: hydrated.intents,
-				incomplete: hydrated.incomplete,
-			})
+			try {
+				const items = await listFrontsPublishSchedule(ctx.db, {
+					toSeconds: window.toSeconds,
+					nowSeconds: now,
+				})
+				const hydrated = await hydrateFrontsPublishIntents(ctx.db, {
+					toSeconds: window.toSeconds,
+					nowSeconds: now,
+					mediaPublicDomain: resolved.mediaPublicDomain,
+					podcastSourceProductionEnabled: config.podcastSourceProductionEnabled,
+					// Site-RELATIVE paths: the CMS does not know the site origin, and the
+					// consumer joins its own trusted configured origin. A host-supplied
+					// origin is deliberately deferred (packages-docs/cms.md).
+					resolveContentUrl: (row) => publicUrlFor(row),
+				})
+				return json({
+					ok: true,
+					now,
+					window: { from: window.fromSeconds, to: window.toSeconds },
+					count: items.length,
+					items,
+					intents: hydrated.intents,
+					incomplete: hydrated.incomplete,
+				})
+			} catch (error) {
+				if (error instanceof FrontsScheduleOverflowError) {
+					console.error(`[cms] fronts/schedule unavailable: ${error.message}`)
+					return json({ ok: false, error: 'schedule_overflow', message: error.message }, 503)
+				}
+				throw error
+			}
 		},
 
 		async publishCallback(ctx) {
@@ -253,16 +267,40 @@ export function createFrontsPublishRoutes(config: CmsRouteConfig): FrontsPublish
 				intentId: parsed.data.intent_id ?? null,
 				contentId: parsed.data.content_id,
 				version: parsed.data.version ?? null,
+				publishAt: parsed.data.publish_at ?? null,
 				correlationId: parsed.data.correlation_id ?? null,
 				status: parsed.data.status,
 				occurredAt: parsed.data.occurred_at ?? null,
 				receipt: parsed.data.receipt ?? null,
 				error: parsed.data.error ?? null,
+				checkReadiness: config.publishReadiness
+					? (item) =>
+							config.publishReadiness!({
+								ctx,
+								contentId: item.id,
+								type: item.type,
+								status: item.status,
+							})
+					: undefined,
 			})
 
 			if (!result.contentFound) {
 				return json({ error: 'content_not_found', contentId: parsed.data.content_id }, 404)
 			}
+			if (result.rejection) {
+				console.warn(
+					`[cms] fronts/publish-callback rejected for content ${parsed.data.content_id}: ${result.rejection.code}`,
+				)
+				return json(
+					{
+						ok: false,
+						error: result.rejection.code,
+						message: result.rejection.message,
+						...(result.rejection.blockers ? { blockers: result.rejection.blockers } : {}),
+					},
+					result.rejection.status,
+				)
+			}
 			if (result.ledgerError) {
 				// A confirmed `live` that could not be committed through the ledger is a
 				// hard, loud failure — never a silent zero.

package/src/routes/index.ts

@@ -312,7 +312,7 @@ export function createCmsRoutes(
 			authz: config.authz,
 			activeWorkspaceId: config.activeWorkspaceId,
 		}),
-		frontsPublish: createFrontsPublishRoutes(base),
+		frontsPublish: createFrontsPublishRoutes(config),
 		foundryPublish: createFoundryPublishRoutes(config),
 	}
 }

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,
@@ -24,6 +25,7 @@ type CmsHooksLocals = ContentRouteConfig['hooks'] & {
 	dispatchFaq?: DispatchFaqHook
 	dispatchWebhook?: DispatchWebhookHook
 	publishReadiness?: PublishReadinessHook
+	podcastSourceProductionEnabled?: boolean
 }
 
 /**
@@ -61,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,
@@ -73,5 +83,6 @@ export function toContentConfig(c: APIContext): ContentRouteConfig {
 		dispatchFaq: hooks.dispatchFaq,
 		dispatchWebhook: hooks.dispatchWebhook,
 		publishReadiness: hooks.publishReadiness,
+		podcastSourceProductionEnabled: hooks.podcastSourceProductionEnabled,
 	}
 }

package/src/ui/api/fronts/publish-callback.ts

@@ -5,14 +5,8 @@
 // content_publication_attempts 2PC ledger. HMAC-SHA256 (X-Foundry-Signature vs
 // env.FOUNDRY_HMAC_SECRET) only — NOT behind requirePublisher.
 import type { APIContext } from 'astro'
-import type { RouteContext } from '../../../routes/context.js'
 import { createFrontsPublishRoutes } from '../../../routes/fronts-publish.js'
-import { buildSiteAuthz } from '../_authz.js'
-
-function toCtx(c: APIContext): RouteContext {
-	const env = (c.locals as { cmsEnv?: Record<string, unknown> }).cmsEnv ?? {}
-	return { request: c.request, params: {}, db: env.SITE_DB as RouteContext['db'], env }
-}
+import { toContentConfig, toContentCtx } from '../_content-config.js'
 
 export const POST = (c: APIContext) =>
-	createFrontsPublishRoutes({ authz: buildSiteAuthz(c) }).publishCallback(toCtx(c))
+	createFrontsPublishRoutes(toContentConfig(c)).publishCallback(toContentCtx(c, {}))

package/src/ui/api/fronts/schedule.ts

@@ -5,14 +5,8 @@
 // env.FOUNDRY_HMAC_SECRET) only — NOT behind requirePublisher. Sibling of the
 // content foundry-callback / insights-ingest M2M routes.
 import type { APIContext } from 'astro'
-import type { RouteContext } from '../../../routes/context.js'
 import { createFrontsPublishRoutes } from '../../../routes/fronts-publish.js'
-import { buildSiteAuthz } from '../_authz.js'
-
-function toCtx(c: APIContext): RouteContext {
-	const env = (c.locals as { cmsEnv?: Record<string, unknown> }).cmsEnv ?? {}
-	return { request: c.request, params: {}, db: env.SITE_DB as RouteContext['db'], env }
-}
+import { toContentConfig, toContentCtx } from '../_content-config.js'
 
 export const GET = (c: APIContext) =>
-	createFrontsPublishRoutes({ authz: buildSiteAuthz(c) }).schedule(toCtx(c))
+	createFrontsPublishRoutes(toContentConfig(c)).schedule(toContentCtx(c, {}))

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}
 			/>
 		),