@anthusai/papyrus 1.0.0-next.8 → 1.0.0

package/app/page.tsx

@@ -2,6 +2,7 @@ import { getSiteRenderer } from "../lib/site-renderer";
 import { contentRepository, getScenarioIdParam } from "../lib/content-repository";
 import type { EditionContent } from "../lib/content-types";
 import { createEditionSectionPlan } from "../lib/edition-sections";
+import { getCachedLatestPublishedEdition, loadCachedEditionContent } from "../lib/cached-content-repository";
 import { getEditionDatePath } from "../lib/edition-routes";
 import {
   EMPTY_EDITION_PLACEHOLDER_SLUG,
@@ -15,7 +16,10 @@ import {
 } from "../lib/public-placeholder-config";
 import type { PublicationItem } from "../lib/publication-items";
 import { SITE_BRAND, rootRoute } from "../lib/site-brand";
-import { redirect } from "next/navigation";
+import { notFound, redirect } from "next/navigation";
+import { getReaderBasePath } from "../lib/reader-base-path";
+import { buildRootRedirectTarget } from "../lib/root-route-redirect";
+import { NewsroomClientShell } from "../components/newsroom-client-shell";
 import NewsDeskRootPage, { type NewsDeskRootSearchParams } from "./newsroom/page";
 
 export const dynamic = "force-dynamic";
@@ -37,12 +41,22 @@ export default async function Home({ searchParams }: HomePageProps) {
   // co-hosts reader + CMS uses the default "reader" (render the publication
   // home page here). A CMS-only site points the root at the newsroom or
   // anywhere else. Preserve the scenario and OAuth-callback paths.
-  if (rootRoute.kind === "newsroom" && !scenarioId) {
-    return <NewsDeskRootPage searchParams={searchParams} />;
+  const publicationOwnsRoot = getReaderBasePath() !== "";
+
+  if (!publicationOwnsRoot && rootRoute.kind === "newsroom" && !scenarioId) {
+    return (
+      <NewsroomClientShell>
+        <NewsDeskRootPage searchParams={searchParams} />
+      </NewsroomClientShell>
+    );
+  }
+
+  if (!publicationOwnsRoot && rootRoute.kind === "redirect") {
+    redirect(buildRootRedirectTarget(rootRoute.destination, resolvedSearchParams));
   }
 
-  if (rootRoute.kind === "redirect" && !scenarioId && !hasOAuthRedirectParams(resolvedSearchParams)) {
-    redirect(rootRoute.destination);
+  if (SITE_BRAND.renderer.kind === "markus") {
+    notFound();
   }
 
   // Resolved only on the reader path: Markus brands (renderer "markus") have
@@ -64,7 +78,7 @@ export default async function Home({ searchParams }: HomePageProps) {
       );
     }
 
-    const latestEdition = await contentRepository.getLatestPublishedEdition();
+    const latestEdition = await getCachedLatestPublishedEdition();
     if (latestEdition) redirect(getEditionDatePath(latestEdition.editionDate));
     return <siteRenderer.renderEdition content={createEmptyGraphQLEdition()} />;
   }
@@ -75,9 +89,9 @@ export default async function Home({ searchParams }: HomePageProps) {
 }
 
 async function loadLatestGraphQLEdition(): Promise<EditionContent | null> {
-  const latestEdition = await contentRepository.getLatestPublishedEdition();
+  const latestEdition = await getCachedLatestPublishedEdition();
   if (!latestEdition) return null;
-  return contentRepository.loadEditionContent({ editionDate: latestEdition.editionDate });
+  return loadCachedEditionContent({ editionDate: latestEdition.editionDate });
 }
 
 async function loadFirstPublishedEditionPath(): Promise<string | undefined> {

package/app/robots.ts

@@ -1,11 +1,8 @@
 import type { MetadataRoute } from "next";
-import { isIndexable } from "../lib/site-env";
+import { buildRobots } from "../lib/robots-policy";
 
 export const dynamic = "force-dynamic";
 
 export default function robots(): MetadataRoute.Robots {
-  if (isIndexable()) {
-    return { rules: { userAgent: "*", allow: "/" } };
-  }
-  return { rules: { userAgent: "*", disallow: "/" } };
+  return buildRobots();
 }

package/app/tailwind.css

@@ -1,4 +1,5 @@
 @import "tailwindcss";
+@source "../../../cyclotron/trace-ui/src/**/*.{ts,tsx}";
 @source "../components/**/*.{ts,tsx}";
 @source "../app/**/*.{ts,tsx}";
 @source "../lib/**/*.{ts,tsx}";

package/bin/papyrus-infra.mjs

@@ -11,7 +11,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { createRequire } from "node:module";
 import { buildSpecFor } from "../infra/build-specs.js";
-import { parseSiteConfig } from "../infra/site-config.js";
+import { parseSiteConfig, resolveStackName } from "../infra/site-config.js";
 
 const USAGE = [
   "Usage: papyrus-infra synth --site infra/site.json [--out cdk.out] [--account A] [--region R]",
@@ -89,7 +89,7 @@ const { App } = createRequire(path.join(process.cwd(), "noop.js"))("aws-cdk-lib"
 const app = new App({ outdir: path.resolve(opt("out", "cdk.out")) });
 new AmplifyAppShellStack(app, `AmplifyAppShell-${config.siteId}`, config, {
   env: { account: opt("account", "335163751677"), region: opt("region", "us-east-1") },
-  stackName: `amplify-app-shell-${config.siteId}`,
+  stackName: resolveStackName(config),
 });
 app.synth();
-console.log(`synthesized amplify-app-shell-${config.siteId} -> ${path.resolve(opt("out", "cdk.out"))}`);
+console.log(`synthesized ${resolveStackName(config)} -> ${path.resolve(opt("out", "cdk.out"))}`);

package/components/amplify-client-provider.tsx

@@ -8,11 +8,14 @@ import { CookieStorage, Hub } from "aws-amplify/utils";
 import { useEffect } from "react";
 import { assertSandboxAmplifyOutputsForDev } from "../lib/amplify-outputs-guard";
 import amplifyOutputs from "papyrus-amplify-outputs";
+import { getPublicNewsroomBasePath } from "../lib/newsroom-base-path";
+import { prioritizeRedirectUrlsForOrigin } from "../lib/oauth-redirect-priority";
 
 let configured = false;
 
 export function configureAmplifyClient() {
   if (configured) return;
+  if (typeof window === "undefined") return;
   assertSandboxAmplifyOutputsForDev(amplifyOutputs as Record<string, unknown>);
   Amplify.configure(prioritizeCurrentOrigin(amplifyOutputs as ResourcesConfig), { ssr: true });
   applyClientTokenStorageForCurrentProtocol();
@@ -72,14 +75,10 @@ function prioritizeCurrentOrigin(config: ResourcesConfig): ResourcesConfig {
   const auth = (config as { auth?: { oauth?: Record<string, unknown> } }).auth;
   const oauth = auth?.oauth;
   if (!auth || !oauth) return config;
-  const origin = normalizeUrlOrigin(window.location.origin);
   const reorder = (urls: unknown) => {
     if (!Array.isArray(urls)) return urls;
-    const normalized = urls.filter((value): value is string => typeof value === "string");
-    const head = normalized.filter((value) => normalizeUrlOrigin(value) === origin);
-    if (!head.length) return normalized;
-    const tail = normalized.filter((value) => normalizeUrlOrigin(value) !== origin);
-    return [...head, ...tail];
+    const strings = urls.filter((value): value is string => typeof value === "string");
+    return prioritizeRedirectUrlsForOrigin(strings, window.location.origin, getPublicNewsroomBasePath());
   };
   return {
     ...config,
@@ -111,22 +110,6 @@ function redirectLoopbackToLocalhost(): void {
   window.location.replace(target);
 }
 
-function normalizeUrlOrigin(value: string): string {
-  const trimmed = value.replace(/\/+$/, "");
-  try {
-    const parsed = new URL(trimmed);
-    const hostname = normalizeLoopbackHostname(parsed.hostname);
-    return `${parsed.protocol}//${hostname}${parsed.port ? `:${parsed.port}` : ""}`;
-  } catch {
-    return trimmed;
-  }
-}
-
-function normalizeLoopbackHostname(hostname: string): string {
-  if (hostname === "127.0.0.1" || hostname === "::1") return "localhost";
-  return hostname;
-}
-
 function extractAuthFailureDetail(error: unknown): string | null {
   if (!error) return null;
   if (typeof error === "string") return error;

package/components/archive-shell.tsx

@@ -1,27 +1,14 @@
 "use client";
 
 import type { ReactNode } from "react";
-import { useEffect, useState } from "react";
+import { useRhythmOverlay } from "./use-rhythm-overlay";
 
 type ArchiveShellProps = {
   children: ReactNode;
 };
 
 export function ArchiveShell({ children }: ArchiveShellProps) {
-  const [showRhythmOverlay, setShowRhythmOverlay] = useState(false);
-
-  useEffect(() => {
-    const handleKeyDown = (event: KeyboardEvent) => {
-      if (isEditableEventTarget(event.target)) return;
-      if ((event.key === "=" || event.code === "Equal") && event.ctrlKey && !event.metaKey && !event.altKey) {
-        event.preventDefault();
-        setShowRhythmOverlay((current) => !current);
-      }
-    };
-
-    window.addEventListener("keydown", handleKeyDown);
-    return () => window.removeEventListener("keydown", handleKeyDown);
-  }, []);
+  const showRhythmOverlay = useRhythmOverlay();
 
   return (
     <main
@@ -32,10 +19,3 @@ export function ArchiveShell({ children }: ArchiveShellProps) {
     </main>
   );
 }
-
-function isEditableEventTarget(target: EventTarget | null): boolean {
-  if (!(target instanceof HTMLElement)) return false;
-  const tagName = target.tagName.toLowerCase();
-  if (tagName === "input" || tagName === "textarea" || tagName === "select") return true;
-  return target.isContentEditable || target.closest("[contenteditable='true']") !== null;
-}

package/components/article-video.tsx

@@ -1,11 +1,14 @@
 "use client";
 
-import { useCallback, useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useRef, useState, type CSSProperties } from "react";
+import { Pause, Play } from "lucide-react";
 import type { ArticleVideoAsset } from "../lib/articles";
 import { resolveThemedVideoSrc } from "../lib/themed-image";
 import { useResolvedPapyrusTheme } from "./use-resolved-papyrus-theme";
 import { getSiteBrand } from "../lib/site-brand";
 import { normalizeDevPreviewDsl, type VideoScriptRef } from "../lib/video-script";
+import { useNearViewport } from "./use-near-viewport";
+import { planVideoLoading, videoElementKey } from "../lib/video-loading";
 import { resolveVideoMode, resolveVideoModeFromEnv, type VideoMode } from "../lib/video-mode";
 
 type ArticleVideoFigureProps = {
@@ -17,6 +20,7 @@ type ArticleVideoFigureProps = {
 };
 
 const PREVIEW_STORAGE_PREFIX = "papyrus-video-preview:";
+const VIDEO_LOAD_ROOT_MARGIN = "200px 0px";
 
 export function ArticleVideoFigure({
   video,
@@ -32,6 +36,10 @@ export function ArticleVideoFigure({
   const [duration, setDuration] = useState(0);
   const [previewReady, setPreviewReady] = useState(false);
   const iframeRef = useRef<HTMLIFrameElement>(null);
+  const videoRef = useRef<HTMLVideoElement>(null);
+  const figureRef = useRef<HTMLElement>(null);
+  const isNearViewport = useNearViewport(figureRef, VIDEO_LOAD_ROOT_MARGIN);
+  const isFramed = getSiteBrand().videoPlayer === "framed";
 
   useEffect(() => {
     setHasHydrated(true);
@@ -41,6 +49,12 @@ export function ArticleVideoFigure({
   // Match SSR to the default dark MP4 in `video.src` until after hydration.
   const resolvedTheme = hasHydrated ? theme : "dark";
   const src = resolveThemedVideoSrc(video.src, video.themeVariants, resolvedTheme);
+  const loadingPlan = planVideoLoading({
+    hasHydrated,
+    isNearViewport,
+    hasPoster: Boolean(video.posterSrc),
+  });
+  const videoKey = videoElementKey(loadingPlan.attachSource, src);
   const usePreview = videoMode === "preview" && Boolean(videoScript?.dsl);
   const previewDsl = videoScript?.dsl
     ? normalizeDevPreviewDsl(videoScript.dsl, getSiteBrand().video?.sceneComponents)
@@ -91,6 +105,58 @@ export function ArticleVideoFigure({
     setCurrentTime(clamped);
   }, []);
 
+  const toggleNativePlayback = useCallback(() => {
+    const element = videoRef.current;
+    if (!element) return;
+    if (element.paused) void element.play().catch(() => setIsPlaying(false));
+    else element.pause();
+  }, []);
+
+  const seekNative = useCallback((nextTime: number) => {
+    const element = videoRef.current;
+    if (!element) return;
+    element.currentTime = Math.max(0, Number.isFinite(nextTime) ? nextTime : 0);
+    setCurrentTime(element.currentTime);
+  }, []);
+
+  const framedControls = (
+    <FramedVideoControls
+      currentTime={currentTime}
+      duration={duration}
+      isPlaying={isPlaying}
+      onSeek={usePreview ? seekPreview : seekNative}
+      onToggle={usePreview ? togglePreviewPlayback : toggleNativePlayback}
+    />
+  );
+
+  if (isFramed && usePreview) {
+    return (
+      <figure
+        className={`${figureClassName} article-video--framed article-video--preview`}
+        data-media-type="videoml-preview"
+        data-video-theme={resolvedTheme}
+        data-video-mode={videoMode}
+      >
+        <div className="article-video__media">
+          {hasHydrated ? (
+            <iframe
+              key={`${slug}-${resolvedTheme}-${src}`}
+              ref={iframeRef}
+              className="article-video__preview-frame"
+              src={previewSrc}
+              title={video.alt}
+              onLoad={() => setPreviewReady(true)}
+            />
+          ) : null}
+        </div>
+        {framedControls}
+        <span className="sr-only" data-video-slug={slug}>
+          {video.alt}
+        </span>
+      </figure>
+    );
+  }
+
   if (usePreview) {
     return (
       <figure
@@ -133,18 +199,56 @@ export function ArticleVideoFigure({
     );
   }
 
+  if (isFramed) {
+    return (
+      <figure
+        ref={figureRef}
+        className={`${figureClassName} article-video--framed`}
+        data-media-type="video"
+        data-video-theme={resolvedTheme}
+        data-video-mode={videoMode}
+      >
+        <div className="article-video__media">
+          <video
+            ref={videoRef}
+            playsInline
+            preload={loadingPlan.preload}
+            poster={video.posterSrc}
+            aria-label={video.alt}
+            className="article-video__player"
+            key={videoKey}
+            onPlay={() => setIsPlaying(true)}
+            onPause={() => setIsPlaying(false)}
+            onEnded={() => setIsPlaying(false)}
+            onTimeUpdate={(event) => setCurrentTime(event.currentTarget.currentTime)}
+            onDurationChange={(event) => {
+              const nextDuration = event.currentTarget.duration;
+              if (Number.isFinite(nextDuration) && nextDuration > 0) setDuration(nextDuration);
+            }}
+          >
+            {loadingPlan.attachSource ? <source src={src} type="video/mp4" /> : null}
+          </video>
+        </div>
+        {framedControls}
+        <span className="sr-only" data-video-slug={slug}>
+          {video.alt}
+        </span>
+      </figure>
+    );
+  }
+
   return (
-    <figure className={figureClassName} data-media-type="video" data-video-theme={resolvedTheme} data-video-mode={videoMode}>
+    <figure ref={figureRef} className={figureClassName} data-media-type="video" data-video-theme={resolvedTheme} data-video-mode={videoMode}>
       <video
         controls
         playsInline
-        preload="metadata"
+        preload={loadingPlan.preload}
         poster={video.posterSrc}
         aria-label={video.alt}
         className="article-video__player"
-        key={hasHydrated ? src : "ssr"}
+        key={videoKey}
       >
-        <source src={src} type="video/mp4" />
+        {loadingPlan.attachSource ? <source src={src} type="video/mp4" /> : null}
       </video>
       {video.caption ? <figcaption>{video.caption}</figcaption> : null}
       {video.credit ? <p className="article-video__credit">{video.credit}</p> : null}
@@ -154,3 +258,46 @@ export function ArticleVideoFigure({
     </figure>
   );
 }
+
+function FramedVideoControls({
+  currentTime,
+  duration,
+  isPlaying,
+  onSeek,
+  onToggle,
+}: {
+  currentTime: number;
+  duration: number;
+  isPlaying: boolean;
+  onSeek: (nextTime: number) => void;
+  onToggle: () => void;
+}) {
+  const seekProgress = duration > 0 ? (currentTime / duration) * 100 : 0;
+  return (
+    <div className="article-video__cta" data-playing={isPlaying ? "true" : "false"}>
+      <button type="button" className="article-video__cta-toggle" onClick={onToggle} aria-pressed={isPlaying}>
+        <span className="article-video__cta-label">
+          <span className="article-video__cta-label-sizer" aria-hidden="true">
+            Pause Video
+          </span>
+          <span className="article-video__cta-label-text">{isPlaying ? "Pause Video" : "Play Video"}</span>
+        </span>
+        <span className="article-video__cta-icon" aria-hidden="true">
+          {isPlaying ? <Pause /> : <Play />}
+        </span>
+      </button>
+      <input
+        className="article-video__cta-seek"
+        type="range"
+        min={0}
+        max={duration || 0}
+        step={0.1}
+        value={Math.min(currentTime, duration || 0)}
+        onChange={(event) => onSeek(Number(event.target.value))}
+        aria-label="Seek video"
+        disabled={!duration}
+        style={{ "--seek-progress": `${seekProgress}%` } as CSSProperties}
+      />
+    </div>
+  );
+}

package/components/blog-page-background.tsx

@@ -2,18 +2,35 @@
 
 import type { RefObject } from "react";
 
+/** A rectangle, in the background layer's own coordinates, that header text occupies. */
+export type BlogHeaderObstacle = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
+
+/** Vertical rhythm grid the rhythm blog layout is built on. */
+export type BlogBackgroundRhythm = {
+  rowHeight: number;
+  paintBuffer: number;
+  paintHeight: number;
+};
+
 export type BlogPageBackgroundProps = {
   pageRef: RefObject<HTMLElement | null>;
+  /** Rhythm blog layout only: header text boxes the artwork should keep clear of. */
+  headerObstacles?: BlogHeaderObstacle[];
+  /** Rhythm blog layout only: the rhythm grid, so artwork can align to it. */
+  rhythm?: BlogBackgroundRhythm;
 };
 
 /**
  * Default (no-op) blog page background for publications without a bespoke
- * backdrop. Threat Intelligence supplies its own animated defense-graph
- * background (publications/threat_intelligence/blog-defense/page-background.tsx);
- * every other publication gets no decorative background layer. This is what
- * `renderers/pretext` falls back to for any publication that isn't Threat
- * Intelligence, so the blog layout loads cleanly without depending on TI's
- * package.
+ * backdrop. A publication supplies header artwork through the
+ * `components.BlogPageBackground` brand slot; with the rhythm blog layout the
+ * slot also receives `headerObstacles` and `rhythm`. This is what
+ * `renderers/pretext` falls back to when no slot component is registered.
  */
 export function BlogPageBackground(_props: BlogPageBackgroundProps) {
   return null;

package/components/news-desk-page.tsx

@@ -1,3 +1,4 @@
+import { resolveNewsDeskTab } from "../lib/newsroom-section-routing";
 import { NewsDeskWorkspace, type NewsDeskTab } from "./topic-steering-workspace";
 import {
   createDemoCategorySteeringDashboard,
@@ -41,7 +42,8 @@ export type NewsDeskPageProps = {
 
 export async function NewsDeskPage({ section: routeSection, sectionPageId, selectionPath, searchParams }: NewsDeskPageProps) {
   const resolvedSearchParams = await searchParams;
-  const initialTab = parseNewsDeskTab(routeSection ?? getSearchParam(resolvedSearchParams, "section"), getSearchParam(resolvedSearchParams, "tab"));
+  const brand = resolveActiveSiteBrand();
+  const initialTab = resolveNewsDeskTab(routeSection ?? getSearchParam(resolvedSearchParams, "section"), getSearchParam(resolvedSearchParams, "tab"), brand.newsroomLayout === "organizer");
   const routeSelection = parseRouteSelection(initialTab, selectionPath);
   const initialSelection = {
     assignment: routeSelection.assignment ?? getFirstSearchParam(resolvedSearchParams, "assignment"),
@@ -63,7 +65,6 @@ export async function NewsDeskPage({ section: routeSection, sectionPageId, selec
     proposal: getFirstSearchParam(resolvedSearchParams, "proposal"),
   };
   const useDemoDashboard = getFirstSearchParam(resolvedSearchParams, "demo") === "1";
-  const brand = resolveActiveSiteBrand();
   const analysisProfiles = await loadAnalysisProfileSummaries(getBrandAnalysisProfilesPath(brand));
   const configuredCorpora = await loadConfiguredCorpusSummaries(getBrandSteeringConfigPath(brand));
   const dashboard = useDemoDashboard
@@ -77,6 +78,7 @@ function parseRouteSelection(tab: NewsDeskTab, selectionPath: string[] | null |
   if (!segments.length) return {};
   if (segments[0] === "forum" && segments[1]) return { forumThread: segments[1] };
   if (tab === "administration") return { panel: segments[0] ?? null };
+  if (tab === "desks") return { category: segments[0] ?? null };
   if (tab === "topics") return { category: segments[1] ?? segments[0] ?? null };
   if (tab === "references") return { reference: segments[0] ?? null };
   if (tab === "concepts") return { category: segments[0] ?? null };
@@ -101,16 +103,3 @@ function getFirstSearchParam(searchParams: unknown, key: string): string | null
   const first = Array.isArray(value) ? value[0] : value;
   return typeof first === "string" && first.trim() ? first.trim() : null;
 }
-
-function parseNewsDeskTab(sectionValue: string | string[] | null | undefined, legacyTabValue: string | string[] | null | undefined): NewsDeskTab {
-  const section = Array.isArray(sectionValue) ? sectionValue[0] : sectionValue;
-  const legacyTab = Array.isArray(legacyTabValue) ? legacyTabValue[0] : legacyTabValue;
-  const rawValue = section ?? (legacyTab === "categories" ? "topics" : legacyTab);
-  const value = rawValue === "users" || rawValue === "doctrine"
-    ? "administration"
-    : rawValue === "desks"
-      ? "topics"
-      : rawValue;
-  if (value === "administration" || value === "topics" || value === "concepts" || value === "references" || value === "insights" || value === "messages" || value === "assignments" || value === "search") return value;
-  return "overview";
-}

package/components/news-desk-taxonomy-client.ts

@@ -1,6 +1,7 @@
 "use client";
 
 import { generateClient } from "aws-amplify/data";
+import { testEditorOverrideAllowed } from "../lib/test-editor-override";
 import { downloadData, getUrl } from "aws-amplify/storage";
 import type { Schema } from "../amplify/data/resource";
 import type { NewsDeskAppendix, NewsDeskCategoryTreeNode } from "../lib/content-types";
@@ -38,6 +39,7 @@ import type {
   UserDirectoryEntry,
 } from "../lib/category-repository";
 import { relationTypeKey } from "../lib/semantic-graph";
+import { CONTENT_ITEM_STAGES, type ContentItemVersionRecord } from "../lib/content-item-lifecycle";
 import { DOCTRINE_DEFINITIONS, getCategoryDoctrineDefinitions, type DoctrineCategory } from "../lib/doctrine";
 import { configureAmplifyClient } from "./amplify-client-provider";
 import { isUnauthenticatedError, loadReaderSessionSnapshot, type ReaderAuthSnapshot } from "./reader-auth-state";
@@ -252,7 +254,7 @@ const UPDATE_MESSAGE_MUTATION = `
 const NEWSROOM_ASSIGNMENT_FEED_QUERY = `
   query ListAssignmentsByNewsroomFeedAndCreatedAt($newsroomFeedKey: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelAssignmentFilterInput) {
     listAssignmentsByNewsroomFeedAndCreatedAt(newsroomFeedKey: $newsroomFeedKey, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
-      items { id assignmentTypeKey queueKey queueStatusKey status priority title summary assigneeType assigneeId assigneeKey claimedAt claimExpiresAt completedAt canceledAt corpusId categorySetId classifierId sectionId sectionKey sectionType sectionStatusKey sectionQueueStatusKey primaryFocusCategoryKey topicScopeCategoryKeys sourceSnapshotId importRunId createdBy createdAt updatedAt newsroomFeedKey }
+      items { id assignmentTypeKey queueKey queueStatusKey status priority title summary assigneeType assigneeId assigneeKey claimedAt claimExpiresAt completedAt canceledAt corpusId categorySetId classifierId sectionId sectionKey sectionType sectionStatusKey sectionQueueStatusKey primaryFocusCategoryKey topicScopeCategoryKeys sourceSnapshotId importRunId createdBy createdAt updatedAt newsroomFeedKey itemLineageId }
       nextToken
     }
   }
@@ -2156,6 +2158,41 @@ export async function loadNewsroomAssignmentPage(options: NewsroomAssignmentPage
   });
 }
 
+const CONTENT_ITEMS_BY_STAGE_QUERY = `
+  query ListItemsByStageAndUpdatedAt($stage: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
+    listItemsByStageAndUpdatedAt(stage: $stage, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
+      items { id lineageId versionNumber stage type status title headline slug section updatedAt }
+      nextToken
+    }
+  }
+`;
+
+export async function loadNewsroomContentItemVersions(): Promise<ContentItemVersionRecord[]> {
+  configureAmplifyClient();
+  const client = generateClient<Schema>() as unknown as {
+    graphql: (options: Record<string, unknown>) => Promise<GraphQLConnectionResponse<ContentItemVersionRecord>>;
+  };
+  const field = "listItemsByStageAndUpdatedAt";
+  const versionsPerStage = await Promise.all(CONTENT_ITEM_STAGES.map(async (stage) => {
+    const versions: ContentItemVersionRecord[] = [];
+    let nextToken: string | null = null;
+    do {
+      const response: GraphQLConnectionResponse<ContentItemVersionRecord> = await client.graphql({
+        query: CONTENT_ITEMS_BY_STAGE_QUERY,
+        variables: { stage, sortDirection: "DESC", limit: NEWSROOM_PAGE_LIMIT, nextToken },
+        authMode: USER_POOL_AUTH_MODE,
+      });
+      assertNoGraphQLErrors(response.errors);
+      const connection = response.data?.[field];
+      if (!connection) throw new Error(`Missing GraphQL connection payload for ${field}.`);
+      versions.push(...((connection.items ?? []).filter(Boolean) as ContentItemVersionRecord[]));
+      nextToken = connection.nextToken ?? null;
+    } while (nextToken);
+    return versions;
+  }));
+  return versionsPerStage.flat();
+}
+
 export async function loadModelPayloadsForOwner(
   ownerKind: string,
   ownerId: string,
@@ -2569,8 +2606,7 @@ export async function runNewsroomKnowledgeQuery(input: Record<string, unknown>):
 
 export function hasTestEditorOverride(): boolean {
   if (typeof window === "undefined") return false;
-  const allowOverride = process.env.NODE_ENV === "test"
-    || process.env.NEXT_PUBLIC_ENABLE_TEST_EDITOR_OVERRIDE === "true";
+  const allowOverride = testEditorOverrideAllowed(process.env.NODE_ENV, process.env.NEXT_PUBLIC_ENABLE_TEST_EDITOR_OVERRIDE);
   if (!allowOverride) return false;
   return window.localStorage.getItem(TEST_EDITOR_STORAGE_KEY) === "true";
 }
@@ -3682,3 +3718,54 @@ function normalizeUnknownErrorMessage(error: unknown, fallback: string): string
     return fallback;
   }
 }
+
+const CREATE_KNOWLEDGE_RAW_PAYLOAD_MUTATION = `
+  mutation CreateKnowledgeRawPayload($input: CreateKnowledgeRawPayloadInput!) {
+    createKnowledgeRawPayload(input: $input) { id }
+  }
+`;
+
+const GET_KNOWLEDGE_RAW_PAYLOAD_QUERY = `
+  query GetKnowledgeRawPayload($id: ID!) {
+    getKnowledgeRawPayload(id: $id) { id }
+  }
+`;
+
+/** The relevance cyclotron's latest cyclotron-status/v1 snapshot, as the sweep recorded it. */
+export async function loadCyclotronStatus(cyclotronId: string): Promise<import("cyclotron/cyclotron-status").CyclotronStatus | null> {
+  const { cyclotronStatusPayloadId, latestCyclotronStatus } = await import("../lib/relevance-status");
+  const payloads = await loadModelPayloadsForOwner("knowledgeRawPayload", cyclotronStatusPayloadId(cyclotronId), ["raw_payload"]);
+  return latestCyclotronStatus(payloads.map((payload) => ({ json: payload.json, updatedAt: payload.attachment.updatedAt })));
+}
+
+/** Ask the next decide-relevance sweep to set or clear a manual review rate. */
+export async function requestCyclotronReviewRate(
+  cyclotronId: string,
+  request: import("../lib/relevance-status").ReviewRateRequest,
+): Promise<void> {
+  const { reviewRateRequestPayloadId, safeId } = await import("../lib/relevance-status");
+  const id = reviewRateRequestPayloadId(cyclotronId);
+  const existing = await runGraphql<{ getKnowledgeRawPayload?: { id: string } | null }>(GET_KNOWLEDGE_RAW_PAYLOAD_QUERY, { id });
+  if (!existing.getKnowledgeRawPayload) {
+    await runGraphql(CREATE_KNOWLEDGE_RAW_PAYLOAD_MUTATION, {
+      input: {
+        id,
+        ownerType: "cyclotron",
+        ownerId: safeId(cyclotronId),
+        payloadKind: "cyclotron-review-rate-request",
+        createdAt: request.requestedAt,
+        updatedAt: request.requestedAt,
+      },
+    });
+  }
+  await uploadModelPayloadForOwner({
+    ownerKind: "knowledgeRawPayload",
+    ownerId: id,
+    ownerLineageId: id,
+    role: "raw_payload",
+    sortKey: `review-rate-request-${request.requestedAt}`,
+    filename: "review-rate-request.json",
+    mediaType: "application/json",
+    content: JSON.stringify(request),
+  });
+}

package/components/newspaper.tsx

@@ -12,6 +12,8 @@ import { ARCHIVE_PREVIEW_HEIGHT, ARCHIVE_PREVIEW_WIDTH } from "../lib/archive-ty
 import type { EditionContent, NewsDeskAppendix, NewsDeskCategoryTreeNode } from "../lib/content-types";
 import { shouldBypassImageOptimization } from "../lib/image-url";
 import type { PublicationItem } from "../lib/publication-items";
+import { clearPretextMeasurementCache } from "../lib/pretext-layout";
+import { toPublicReaderPath } from "../lib/reader-base-path";
 import { SITE_BRAND } from "../lib/site-brand";
 import { resolveThemedImageSrc, type ResolvedTheme } from "../lib/themed-image";
 import { loadEditorCategoryTreeState } from "./news-desk-taxonomy-client";
@@ -130,7 +132,9 @@ export function Newspaper({
     if (!fonts) return;
     let cancelled = false;
     const refreshAfterFontLoad = () => {
-      if (!cancelled) setFontRevision((revision) => revision + 1);
+      if (cancelled) return;
+      clearPretextMeasurementCache();
+      setFontRevision((revision) => revision + 1);
     };
     fonts.ready.then(refreshAfterFontLoad).catch(() => undefined);
     fonts.addEventListener("loadingdone", refreshAfterFontLoad);
@@ -1877,7 +1881,7 @@ function getPageHref(pageNumber: number, editionBasePath?: string): string {
 }
 
 function getArticleHref(articleSlug: string, editionBasePath?: string): string {
-  return editionBasePath ? `${normalizePath(editionBasePath)}/${encodeURIComponent(articleSlug)}` : `/articles/${articleSlug}`;
+  return editionBasePath ? `${normalizePath(editionBasePath)}/${encodeURIComponent(articleSlug)}` : toPublicReaderPath(`/articles/${articleSlug}`);
 }
 
 function getItemAnchorHref(articleSlug: string, pageNumber: number, editionBasePath?: string): string {