@anthusai/papyrus 2.0.0-next.77 → 2.0.0-next.78

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

@@ -1,5 +1,7 @@
 "use client";
 
+import { loadReferenceReviewDetails } from "../lib/reference-review-details";
+
 import { isEditorialWorkAssignment } from "../lib/newsroom-assignments";
 import { isLocalPreviewEnabled } from "../lib/local-preview";
 import { createLocalPreviewRealPublishedVersions, createLocalPreviewAssignments, createLocalPreviewContentItemVersions, createLocalPreviewReferences } from "../lib/local-preview-seed";
@@ -1852,9 +1854,29 @@ export async function loadEditorSemanticRelationsData(): Promise<SemanticRelatio
     pageCount += 1;
   } while (nextToken && pageCount < 40);
 
+  if (nextToken) throw new Error("The activity feed is incomplete. Select a reference to load its prediction directly.");
   return rows;
 }
 
+/** Selected-reference details use indexes, not the bounded global activity feed. */
+export async function loadEditorReferenceReviewDetails(lineageId: string) {
+  configureAmplifyClient();
+  const testMock = getTestEditorNewsroomMock();
+  return loadReferenceReviewDetails(lineageId, {
+    relations: async (direction) => {
+      if (testMock?.semanticRelations) return testMock.semanticRelations;
+      return loadSemanticRelationsByState({
+        field: direction === "outgoing" ? "listSemanticRelationsBySubjectState" : "listSemanticRelationsByObjectState",
+        keyName: direction === "outgoing" ? "subjectStateKey" : "objectStateKey",
+        keyValue: `reference#${lineageId}#current`,
+        query: direction === "outgoing" ? LIST_SEMANTIC_RELATIONS_BY_SUBJECT_STATE_QUERY : LIST_SEMANTIC_RELATIONS_BY_OBJECT_STATE_QUERY,
+      });
+    },
+    message: async (id) => testMock?.messages ? testMock.messages.find((message) => message.id === id) ?? null : getMessageRecordById(id),
+    payloads: (id) => loadModelPayloadsForOwner("message", id, ["metadata"]),
+  });
+}
+
 export async function loadNewsroomSemanticRelationPage(options: NewsroomSemanticRelationPageOptions = {}): Promise<NewsroomRecordPage<SemanticRelationRecord>> {
   return loadNewsroomFeedPage<SemanticRelationRecord>({
     query: NEWSROOM_SEMANTIC_RELATION_FEED_QUERY,
@@ -3134,7 +3156,7 @@ async function loadSemanticRelationsByState({
     });
     assertNoGraphQLErrors(response.errors);
     const connection = response.data?.[field];
-    if (!connection) break;
+    if (!connection) throw new Error(`Missing GraphQL connection payload for ${field}.`);
     for (const item of (connection.items ?? []).filter(Boolean) as SemanticRelationRecord[]) {
       if (!item.id || seenIds.has(item.id)) continue;
       seenIds.add(item.id);
@@ -3142,6 +3164,7 @@ async function loadSemanticRelationsByState({
     }
     nextToken = connection.nextToken ?? null;
   } while (nextToken && pageCount < 200);
+  if (nextToken) throw new Error("Reference details are incomplete. Try again before reviewing its prediction.");
   return rows;
 }
 

package/components/newsroom-references-view.tsx

@@ -13,7 +13,7 @@ import {
   ThumbsUpIcon,
 } from "lucide-react";
 import { usePathname } from "next/navigation";
-import { useCallback, useEffect, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Badge } from "./ui/badge";
 import { Button } from "./ui/button";
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "./ui/card";
@@ -28,6 +28,7 @@ import {
 import { Tabs, TabsList, TabsTrigger } from "./ui/tabs";
 import type { ReferenceAttachmentRecord, ReferenceRecord } from "../lib/category-repository";
 import {
+  buildReferencesIndexQuery,
   parseReferenceLineageIdFromNewsroomPathname,
   syncBrowserNewsroomIndexUrl,
 } from "../lib/newsroom-index-filters";
@@ -45,7 +46,7 @@ import {
   type ReferenceCurationAction,
   type ReferenceStatusFilter,
 } from "../lib/newsroom-references";
-import { normalizeReferenceCurationStatus } from "../lib/reference-policy";
+import { normalizeReferenceCurationStatus, referenceReasonCode, REFERENCE_REJECTION_REASON_CODES, type ReferenceRejectionReasonCode } from "../lib/reference-policy";
 import { newsroomListRowClassName } from "../lib/newsroom-list-selection";
 import { ReferenceSourcePreview } from "./reference-source-preview";
 import { ReferenceRelevanceReview } from "./reference-relevance-review";
@@ -61,7 +62,14 @@ import { SectionPicker, SectionSuggestionBlock, type SectionChoice } from "./ref
 import type { SectionSuggestion, SiteSectionAgreement } from "../lib/site-section-suggestions";
 
 /** What an editor adds to an accept: the Section the reference belongs in, which becomes a training label. */
-export type ReferenceReviewOptions = { sectionId?: string | null };
+export type ReferenceReviewOptions = {
+  sectionId?: string | null;
+  note?: string;
+  reasonCode?: ReferenceRejectionReasonCode | null;
+  decisionRelationId?: string;
+  shareable?: boolean;
+};
+type PredictionState = "loading" | "ready" | "error";
 import type { DelegatedCuration, ShadowAgreement } from "../lib/cyclotron-suggestions";
 import type { PrimingFormInput } from "./reference-cyclotron-priming";
 import { ReferenceCyclotronStatus, type ReviewRateChoice } from "./reference-cyclotron-status";
@@ -102,9 +110,14 @@ type NewsroomReferencesViewProps = {
   sectionSuggestions?: Map<string, SectionSuggestion>;
   /** How often the Section suggestions matched later editor decisions. */
   sectionAgreement?: SiteSectionAgreement | null;
-  onRelevanceReview?: (reference: ReferenceRecord, curation: RelevanceCuration) => void;
+  reviewReasons?: Map<string, ReferenceRejectionReasonCode>;
+  reviewSectionIds?: Map<string, string>;
+  predictionState?: PredictionState;
+  predictionError?: string | null;
+  onRetryPredictions?: () => void;
+  onRelevanceReview?: (reference: ReferenceRecord, curation: RelevanceCuration) => Promise<void> | void;
   initialReferenceLineageId?: string | null;
-  onReview: (reference: ReferenceRecord, action: ReferenceCurationAction, options?: ReferenceReviewOptions) => void;
+  onReview: (reference: ReferenceRecord, action: ReferenceCurationAction, options?: ReferenceReviewOptions) => Promise<void> | void;
   referenceAttachments?: ReferenceAttachmentRecord[];
   references: ReferenceRecord[];
 };
@@ -251,6 +264,9 @@ function ReferenceDetailPanel({
   disabled,
   onRelevanceReview,
   onReview,
+  predictionState = "ready",
+  reviewReason,
+  reviewSectionId,
   previewAttachments,
   reference,
   onClose,
@@ -263,8 +279,11 @@ function ReferenceDetailPanel({
   decision?: RelevanceDecisionView;
   demo?: boolean;
   disabled?: boolean;
-  onRelevanceReview?: (curation: RelevanceCuration) => void;
-  onReview: (action: ReferenceCurationAction, options?: ReferenceReviewOptions) => void;
+  onRelevanceReview?: (curation: RelevanceCuration) => Promise<void> | void;
+  onReview: (action: ReferenceCurationAction, options?: ReferenceReviewOptions) => Promise<void> | void;
+  predictionState?: PredictionState;
+  reviewReason?: ReferenceRejectionReasonCode;
+  reviewSectionId?: string;
   sectionAgreement?: SiteSectionAgreement | null;
   sectionSuggestion?: SectionSuggestion;
   sections?: SectionChoice[];
@@ -273,13 +292,77 @@ function ReferenceDetailPanel({
   onClose?: () => void;
 }) {
   const lineageId = referenceLineageId(reference);
-  const [chosenSectionId, setChosenSectionId] = useState<string | null>(null);
-  useEffect(() => { setChosenSectionId(null); }, [lineageId]);
+  const sourceNote = normalizeReferenceCurationStatus(reference.curationStatus) === "pending" ? "" : reference.curationStatusReason ?? "";
+  const sourceReason = reviewReason ?? referenceReasonCode(reference) ?? "";
+  const [note, setNote] = useState(sourceNote);
+  const [reasonCode, setReasonCode] = useState<ReferenceRejectionReasonCode | "">(sourceReason);
+  const [savedNote, setSavedNote] = useState(sourceNote);
+  const [savedReason, setSavedReason] = useState<ReferenceRejectionReasonCode | "">(sourceReason);
+  const [busy, setBusy] = useState(false);
+  const [reviewError, setReviewError] = useState<string | null>(null);
+  const [saved, setSaved] = useState(false);
+  const saving = useRef(false);
+  const noteEdited = useRef(false);
+  const reasonEdited = useRef(false);
+  useEffect(() => {
+    setSavedNote(sourceNote);
+    if (!noteEdited.current) setNote(sourceNote);
+  }, [sourceNote]);
+  useEffect(() => {
+    setSavedReason(sourceReason);
+    if (!reasonEdited.current) setReasonCode(sourceReason);
+  }, [sourceReason]);
+  const [chosenSectionId, setChosenSectionId] = useState<string | null>(reviewSectionId ?? null);
+  const [savedSectionId, setSavedSectionId] = useState<string | null>(reviewSectionId ?? null);
+  const sectionEdited = useRef(false);
+  useEffect(() => {
+    setSavedSectionId(reviewSectionId ?? null);
+    if (!sectionEdited.current) setChosenSectionId(reviewSectionId ?? null);
+  }, [reviewSectionId]);
   const status = normalizeReferenceCurationStatus(reference.curationStatus);
   const url = referenceUrl(reference);
-  const acceptDisabled = disabled || status === "accepted";
-  const rejectDisabled = disabled || status === "rejected";
-  const archiveDisabled = disabled || status === "archived";
+  const locked = disabled || busy;
+  const acceptDisabled = locked || status === "accepted";
+  const rejectDisabled = locked || status === "rejected";
+  const archiveDisabled = locked || status === "archived";
+
+  async function save(action: ReferenceCurationAction, review?: RelevanceCuration) {
+    if (disabled || saving.current) return;
+    const rejectionReason = review?.reasonCode ?? reasonCode;
+    if (action === "reject" && !rejectionReason) {
+      setReviewError("Choose a rejection reason before saving. An explanation is optional.");
+      return;
+    }
+    saving.current = true;
+    setBusy(true);
+    setSaved(false);
+    setReviewError(null);
+    try {
+      if (review && onRelevanceReview) await onRelevanceReview({ ...review, ...(action === "accept" && chosenSectionId ? { sectionId: chosenSectionId } : {}) });
+      else await onReview(action, {
+        note: note.trim(),
+        reasonCode: action === "reject" ? reasonCode || null : null,
+        ...(action === "accept" && chosenSectionId ? { sectionId: chosenSectionId } : {}),
+        ...(decision ? { decisionRelationId: decision.decisionRelationId, shareable: false } : {}),
+      });
+      if (review) {
+        setNote(review.note ?? "");
+        setReasonCode((review.reasonCode as ReferenceRejectionReasonCode) ?? "");
+      }
+      setSavedNote(review ? review.note ?? "" : note.trim());
+      setSavedReason(action === "reject" ? rejectionReason as ReferenceRejectionReasonCode : "");
+      setSavedSectionId(action === "accept" ? chosenSectionId : null);
+      noteEdited.current = false;
+      reasonEdited.current = false;
+      sectionEdited.current = false;
+      setSaved(true);
+    } catch (error) {
+      setReviewError(error instanceof Error ? error.message : "Review could not be saved. Try again.");
+    } finally {
+      saving.current = false;
+      setBusy(false);
+    }
+  }
 
   return (
     <div
@@ -304,8 +387,8 @@ function ReferenceDetailPanel({
           <div className="space-y-3" data-reference-relevance-decision={lineageId}>
             <ReferenceSuggestionBlock
               decision={decision}
-              disabled={disabled}
-              onCurate={onRelevanceReview}
+              disabled={locked}
+              onCurate={onRelevanceReview ? (review) => { void save(review.action, { ...review, note: note.trim() || null, reasonCode: review.action === "reject" ? reasonCode || null : null }); } : undefined}
               referenceLineageId={lineageId}
               settled={status !== "pending"}
               statusLabel={referenceStatusLabel(status)}
@@ -317,31 +400,54 @@ function ReferenceDetailPanel({
                 <div className="mt-2">
                   <ReferenceRelevanceReview
                     decision={decision}
-                    disabled={disabled}
-                    onCurate={onRelevanceReview}
+                    disabled={locked}
+                    onCurate={(review) => save(review.action, review)}
                     referenceLineageId={lineageId}
                   />
                 </div>
               </details>
             ) : null}
           </div>
+        ) : predictionState === "ready" ? (
+          <section aria-label="Publication prediction" className="space-y-1 rounded-md border p-3">
+            <h3 className="text-sm font-semibold">No prediction recorded</h3>
+            <p className="text-sm text-muted-foreground">No publication relevance prediction was returned for this reference. You can still review it. Pending is its editorial status, not a prediction status.</p>
+          </section>
         ) : null}
-        {status === "pending" && sectionSuggestion ? (
-          <SectionSuggestionBlock agreement={sectionAgreement} referenceLineageId={lineageId} sections={sections} suggestion={sectionSuggestion} />
-        ) : null}
-        {status === "pending" && sections.length ? (
-          <SectionPicker
+        {sectionSuggestion || ((status === "pending" || status === "accepted") && sections.length) ? (
+          <details className="rounded-md border p-3 text-sm">
+            <summary className="cursor-pointer font-semibold">Section placement (optional)</summary>
+            <div className="mt-3 space-y-3">
+            {sectionSuggestion ? <SectionSuggestionBlock agreement={sectionAgreement} referenceLineageId={lineageId} sections={sections} suggestion={sectionSuggestion} /> : null}
+            {(status === "pending" || status === "accepted") && sections.length ? <SectionPicker
             agreement={sectionAgreement}
             chosenSectionId={chosenSectionId}
-            disabled={disabled}
-            onChoose={setChosenSectionId}
+            disabled={locked}
+            onChoose={(sectionId) => { setChosenSectionId(sectionId); sectionEdited.current = true; setSaved(false); }}
             referenceLineageId={lineageId}
             sections={sections}
             suggestedSectionId={sectionSuggestion?.sectionId ?? null}
-          />
+            /> : null}
+            </div>
+          </details>
         ) : null}
         {delegated ? <DelegatedCurationNote delegated={delegated} referenceLineageId={lineageId} /> : countsAsTrainingLabel ? <CountsAsTrainingLabelNote referenceLineageId={lineageId} /> : null}
 
+        <section aria-label="Editor feedback" className="space-y-3">
+          <h3 className="text-sm font-semibold">Editor feedback</h3>
+          {disabled ? <p className="text-sm text-muted-foreground">Editor access is required to change this reference.</p> : null}
+          <label className="block text-sm">
+            Review explanation (optional)
+            <textarea aria-label="Review explanation (optional)" className="mt-1 block min-h-20 w-full rounded-md border bg-background p-2" disabled={locked} value={note} onChange={(event) => { setNote(event.target.value); noteEdited.current = true; setSaved(false); }} />
+          </label>
+          <label className="block text-sm">
+            Rejection reason
+            <select aria-label="Rejection reason" className="mt-1 block w-full rounded-md border bg-background p-2" disabled={locked} value={reasonCode} onChange={(event) => { setReasonCode(event.target.value as ReferenceRejectionReasonCode | ""); reasonEdited.current = true; setSaved(false); }}>
+              <option value="">Choose a reason when rejecting</option>
+              {REFERENCE_REJECTION_REASON_CODES.map((code) => <option key={code} value={code}>{code.charAt(0).toUpperCase() + code.slice(1).replaceAll("_", " ")}</option>)}
+            </select>
+          </label>
+          <p className="text-xs text-muted-foreground">Only out of scope and policy exclusion are negative relevance labels. Other rejection reasons do not teach relevance.</p>
         <div
           className="flex flex-wrap items-center gap-2"
           data-news-desk-reference-curation-cluster
@@ -352,7 +458,7 @@ function ReferenceDetailPanel({
             aria-pressed={status === "accepted"}
             data-news-desk-reference-accept
             disabled={acceptDisabled}
-            onClick={() => onReview("accept", chosenSectionId ? { sectionId: chosenSectionId } : undefined)}
+            onClick={() => { void save("accept"); }}
             size="sm"
             type="button"
             variant={status === "accepted" ? "default" : "outline"}
@@ -365,7 +471,7 @@ function ReferenceDetailPanel({
             aria-pressed={status === "rejected"}
             data-news-desk-reference-reject
             disabled={rejectDisabled}
-            onClick={() => onReview("reject")}
+            onClick={() => { void save("reject"); }}
             size="sm"
             type="button"
             variant={status === "rejected" ? "destructive" : "outline"}
@@ -376,7 +482,7 @@ function ReferenceDetailPanel({
           <Button
             aria-label="Archive reference"
             disabled={archiveDisabled}
-            onClick={() => onReview("archive")}
+            onClick={() => { void save("archive"); }}
             size="sm"
             type="button"
             variant="outline"
@@ -384,7 +490,14 @@ function ReferenceDetailPanel({
             <ArchiveIcon className="size-4" />
             Archive
           </Button>
+          {status === "accepted" || status === "rejected" ? (
+            <Button disabled={locked || predictionState !== "ready" || (note.trim() === savedNote.trim() && (status !== "rejected" || reasonCode === savedReason) && (status !== "accepted" || chosenSectionId === savedSectionId))} onClick={() => { void save(status === "accepted" ? "accept" : "reject"); }} size="sm" type="button" variant="outline">Save feedback</Button>
+          ) : null}
         </div>
+        {status !== "pending" && predictionState !== "ready" ? <p className="text-sm text-muted-foreground">Load the review details before revising saved feedback.</p> : null}
+        {busy ? <p role="status" className="text-sm">Saving review…</p> : saved ? <p role="status" className="text-sm">Review saved.</p> : null}
+        {reviewError ? <p role="alert" className="text-sm text-destructive">{reviewError}</p> : null}
+        </section>
 
         <Separator />
 
@@ -398,7 +511,7 @@ function ReferenceDetailPanel({
             <dt className="text-xs font-medium uppercase tracking-wide text-muted-foreground">Why</dt>
             <dd className="mt-1 text-foreground">
               {reference.curationStatusReason?.trim()
-                || "Private corpus item awaiting editorial review for evidence use."}
+                || "No explanation recorded."}
             </dd>
           </div>
           {url ? (
@@ -476,6 +589,11 @@ export function NewsroomReferencesView({
   demo = false,
   disabled = false,
   onRelevanceReview,
+  predictionState = "ready",
+  predictionError,
+  reviewReasons,
+  reviewSectionIds,
+  onRetryPredictions,
   sections = [],
   sectionSuggestions,
   sectionAgreement = null,
@@ -492,7 +610,7 @@ export function NewsroomReferencesView({
     () => parseReferenceLineageIdFromNewsroomPathname(pathname),
     [pathname],
   );
-  const routeLineageId = initialReferenceLineageId ?? pathnameLineageId ?? "";
+  const routeLineageId = pathname ? pathnameLineageId ?? "" : initialReferenceLineageId ?? "";
 
   const canonicalReferences = useMemo(() => selectCanonicalReferenceRecords(references), [references]);
   const statusCounts = useMemo(() => countReferencesByStatus(canonicalReferences), [canonicalReferences]);
@@ -531,17 +649,21 @@ export function NewsroomReferencesView({
 
   const syncStatusUrl = useCallback((nextStatus: ReferenceListFilter) => {
     if (demo) return;
-    syncBrowserNewsroomIndexUrl("references", {
+    const filters = {
       status: nextStatus === "all" ? "" : nextStatus,
       processing: "",
-      order: "published",
-    }, { replace: true });
-  }, [demo]);
+      order: "published" as const,
+    };
+    if (selectedLineageId && typeof window !== "undefined") {
+      window.history.replaceState(null, "", `${buildReferenceDetailPath(selectedLineageId)}${buildReferencesIndexQuery(filters)}`);
+    } else {
+      syncBrowserNewsroomIndexUrl("references", filters, { replace: true });
+    }
+  }, [demo, selectedLineageId]);
 
   useEffect(() => {
-    if (!routeLineageId) return;
     setSelectedLineageId(routeLineageId);
-    if (isMobileDetail) setMobileDetailOpen(true);
+    if (isMobileDetail) setMobileDetailOpen(Boolean(routeLineageId));
   }, [isMobileDetail, routeLineageId]);
 
   useEffect(() => {
@@ -571,7 +693,7 @@ export function NewsroomReferencesView({
 
   const runReview = (action: ReferenceCurationAction, options?: ReferenceReviewOptions) => {
     if (!selectedReference) return;
-    onReview(selectedReference, action, options);
+    return onReview(selectedReference, action, options);
   };
 
   const emptyLabel = canonicalReferences.length
@@ -591,6 +713,17 @@ export function NewsroomReferencesView({
             Review source intake before it becomes accepted evidence.
           </p>
         </div>
+        {predictionState === "loading" ? <p role="status">Loading predictions…</p> : null}
+        {predictionState === "error" ? (
+          <div role="alert" className="space-y-2 rounded-md border p-3">
+            <p>Predictions unavailable. {predictionError}</p>
+            <p className="text-sm">You can still review references. Existing suggestions may be out of date.</p>
+            {onRetryPredictions ? <Button onClick={onRetryPredictions} size="sm" type="button" variant="outline">Retry predictions</Button> : null}
+          </div>
+        ) : null}
+        <details className="shrink-0 overflow-y-auto rounded-md border p-3 text-sm" style={{ maxHeight: "35dvh" }}>
+          <summary className="cursor-pointer font-semibold">Add a reference and prediction activity</summary>
+          <div className="mt-3 space-y-4">
         <ReferenceLiveAgreement agreement={shadowAgreement} />
         <ReferenceAddEntry
           importOptions={disabled ? null : priming ?? sessionImport?.panel}
@@ -606,6 +739,8 @@ export function NewsroomReferencesView({
             <ReferenceCyclotronStatus onRequestRate={disabled ? undefined : onRequestReviewRate} status={cyclotronStatus} />
           </div>
         ) : null}
+          </div>
+        </details>
 
         <Tabs
           className="shrink-0"
@@ -717,6 +852,10 @@ export function NewsroomReferencesView({
         <ScrollArea className="min-h-0 flex-1">
           {selectedReference ? (
             <ReferenceDetailPanel
+              key={referenceLineageId(selectedReference)}
+              predictionState={predictionState}
+              reviewReason={reviewReasons?.get(referenceLineageId(selectedReference))}
+              reviewSectionId={reviewSectionIds?.get(referenceLineageId(selectedReference))}
               countsAsTrainingLabel={humanCuratedReferenceLineageIds?.has(referenceLineageId(selectedReference))}
               delegated={delegatedCurations?.get(referenceLineageId(selectedReference))}
               decision={decisions?.get(referenceLineageId(selectedReference))}
@@ -753,6 +892,10 @@ export function NewsroomReferencesView({
             {selectedReference ? (
               <ScrollArea className="max-h-[75dvh]">
                 <ReferenceDetailPanel
+                  key={referenceLineageId(selectedReference)}
+                  predictionState={predictionState}
+              reviewReason={reviewReasons?.get(referenceLineageId(selectedReference))}
+              reviewSectionId={reviewSectionIds?.get(referenceLineageId(selectedReference))}
                   countsAsTrainingLabel={humanCuratedReferenceLineageIds?.has(referenceLineageId(selectedReference))}
               delegated={delegatedCurations?.get(referenceLineageId(selectedReference))}
                   decision={decisions?.get(referenceLineageId(selectedReference))}

package/components/reference-cyclotron-suggestion.tsx

@@ -57,11 +57,12 @@ export function ReferenceSuggestionBlock({
   const choose = (choice: SuggestionChoice) => onCurate?.(curationForSuggestionChoice(decision, choice));
   const suggestsAccept = decision.positiveLabel !== null && decision.label === decision.positiveLabel;
   return (
-    <section aria-label="Suggestion" className="space-y-2 border-y border-foreground py-3" data-reference-suggestion={referenceLineageId}>
-      <h3 className="text-xs font-semibold uppercase tracking-wide text-foreground">Suggestion</h3>
+    <section aria-label="Publication prediction" className="space-y-2 border-y border-foreground py-3" data-reference-suggestion={referenceLineageId}>
+      <h3 className="text-xs font-semibold uppercase tracking-wide text-foreground">Publication prediction</h3>
       <p className="text-sm text-foreground">
         Papyrus suggests <span className="font-semibold">{decision.label}</span> ({suggestionConfidenceWords(decision)}).
       </p>
+      {decision.reviewDetail ? <p className="text-xs text-foreground">Why review was requested: {decision.reviewDetail}</p> : null}
       <p className="text-xs text-foreground" data-reference-suggestion-notice>
         A suggestion never changes the status until an editor acts. This reference is {statusLabel.toLowerCase()}.
       </p>
@@ -99,14 +100,17 @@ export function ReferenceSuggestionProvenance({ decision }: { decision: Relevanc
       <summary className="cursor-pointer font-semibold underline-offset-4 hover:underline">How this suggestion was made</summary>
       {summary ? (
         <ul className="mt-2 space-y-1">
-          <li>{summary.teachingLabelsSentence}.</li>
-          <li>{summary.primingExamplesSentence}.</li>
+          {summary.teachingLabelsSentence ? <li>{summary.teachingLabelsSentence}.</li> : null}
+          {summary.primingExamplesSentence ? <li>{summary.primingExamplesSentence}.</li> : null}
+          {decision.provenance?.system ? <li>Source: {decision.provenance.system === "cyclotron-lab" ? "Shared publication classifier" : decision.provenance.system}.</li> : null}
+          {decision.provenance?.output ? <li>Publication output: {decision.provenance.output}.</li> : null}
+          {decision.classifierId ? <li>Classifier: {decision.classifierId}.</li> : null}
           <li>Guidelines code {summary.doctrineShortHash ?? "not recorded"}.</li>
           <li>Suggestion {summary.modelVersion ?? "revision not recorded"}.</li>
           <li>Decided {formatSuggestionTime(summary.decidedAt)}.</li>
         </ul>
       ) : (
-        <p className="mt-2">This suggestion was made before the details were recorded. Only its revision and confidence are known.</p>
+        <p className="mt-2">Additional provenance was not recorded for this prediction.</p>
       )}
     </details>
   );

package/components/reference-relevance-review.tsx

@@ -28,7 +28,7 @@ export function ReferenceRelevanceReview({
 }: {
   disabled?: boolean;
   decision: RelevanceDecisionView;
-  onCurate: (curation: RelevanceCuration) => void;
+  onCurate: (curation: RelevanceCuration) => Promise<void> | void;
   referenceLineageId: string;
 }) {
   const [shareable, setShareable] = useState(false);
@@ -47,10 +47,10 @@ export function ReferenceRelevanceReview({
         disabled={disabled}
         itemId={referenceLineageId}
         mode={decision.reviewControl === "thumbs" && classes.length === 2 ? "thumbs" : "labels"}
-        onReview={(review) => {
+        onReview={async (review) => {
           try {
             setError(null);
-            onCurate(curationForRelevanceReview(decision, { ...review, shareable }));
+            await onCurate(curationForRelevanceReview(decision, { ...review, shareable }));
           } catch (failure) {
             setError(failure instanceof Error ? failure.message : String(failure));
           }

package/components/topic-steering-workspace.tsx

@@ -40,6 +40,7 @@ import {
   loadEditorReferencesData,
   loadEditorProcedureData,
   loadEditorSemanticRelationsData,
+  loadEditorReferenceReviewDetails,
   loadEditionForumThreads,
   loadNewsroomAssignmentPage,
   loadNewsroomMessagePage,
@@ -167,6 +168,9 @@ import {
 } from "../lib/reference-policy";
 import { isLocalPreviewEnabled } from "../lib/local-preview";
 import { currentRelevanceDecisions } from "../lib/relevance-decisions";
+import { runReferenceReviewRequest } from "../lib/reference-review-request";
+import { useReferenceReviewData } from "../lib/use-reference-review-data";
+import { latestReferenceReviewReasons, latestReferenceReviewSections } from "../lib/reference-review-details";
 import { delegatedCurationsByReference, referencesWithHumanLatestCuration, type ShadowAgreement } from "../lib/cyclotron-suggestions";
 import { createLocalPreviewCyclotronFixtures } from "../lib/local-preview-seed";
 import { createLocalPreviewSectionFixtures } from "../lib/local-preview-section-fixtures";
@@ -902,6 +906,11 @@ function NewsDeskDashboard({
   const [referencesRealtimeStatus, setReferencesRealtimeStatus] = useState<RealtimeSubscriptionStatus>("idle");
   const [referencesRealtimeError, setReferencesRealtimeError] = useState<string | null>(null);
   const referencesRef = useRef(references);
+  const referenceReviewsPending = useRef(new Map<string, Promise<void>>());
+  const [selectedReviewRead, setSelectedReviewRead] = useState<{ lineageId: string; state: "loading" | "ready" | "error"; error: string | null }>({ lineageId: "", state: "ready", error: null });
+  const [selectedReviewAttempt, setSelectedReviewAttempt] = useState(0);
+  const reviewReasons = useMemo(() => latestReferenceReviewReasons(messages), [messages]);
+  const reviewSectionIds = useMemo(() => latestReferenceReviewSections(messages), [messages]);
 
   useEffect(() => {
     referencesRef.current = references;
@@ -1231,17 +1240,6 @@ function NewsDeskDashboard({
     if (dashboard.isDemo) return;
     let active = true;
 
-    if (activeTab === "messages" && !loadedSections.messages) {
-      setLoadedSections((current) => ({ ...current, messages: true }));
-      void loadEditorMessagesData()
-        .then((nextMessages) => {
-          if (active) setMessages(nextMessages);
-        })
-        .catch((error) => {
-          if (active) setActionState({ id: "messages-load", message: error instanceof Error ? error.message : "messages load failed", tone: "error" });
-        });
-    }
-
     if (activeTab === "assignments" && !loadedSections.assignments) {
       setLoadedSections((current) => ({ ...current, assignments: true }));
       void loadEditorAssignmentsData()
@@ -1269,23 +1267,6 @@ function NewsDeskDashboard({
         });
     }
 
-    if ((activeTab === "assignments" || activeTab === "references" || activeTab === "messages") && !loadedSections.semanticRelations) {
-      setLoadedSections((current) => ({ ...current, semanticRelations: true }));
-      void loadEditorSemanticRelationsData()
-        .then((relations) => {
-          if (active) setSemanticRelations(relations);
-        })
-        .catch(() => {
-          if (active) setSemanticRelations([]);
-        });
-      if (!loadedSections.messages) {
-        setLoadedSections((current) => ({ ...current, messages: true }));
-        void loadEditorMessagesData().then((nextMessages) => {
-          if (active) setMessages(nextMessages);
-        }).catch(() => undefined);
-      }
-    }
-
     if ((activeTab === "topics" || activeTab === "desks" || activeTab === "concepts" || activeTab === "administration") && !loadedSections.fullDashboard) {
       setLoadedSections((current) => ({ ...current, fullDashboard: true }));
       void loadEditorFullNewsDeskDashboard({ isAdmin: Boolean(dashboard.canManageUsers) })
@@ -1340,6 +1321,37 @@ function NewsDeskDashboard({
     refreshNewsroomSections,
   ]);
 
+  const needsReferenceReviewData = activeTab === "references" || activeTab === "assignments" || activeTab === "messages";
+  const selectedReviewLineageId = pathname ? pathnameReferenceLineageId ?? "" : initialSelection.reference ?? "";
+  const referenceReviewData = useReferenceReviewData({
+    enabled: canLoadPrivateCorpus && needsReferenceReviewData && !(activeTab === "references" && selectedReviewLineageId),
+    loadRelations: loadEditorSemanticRelationsData,
+    loadMessages: loadEditorMessagesData,
+    onRelations: setSemanticRelations,
+    onMessages: setMessages,
+  });
+
+  useEffect(() => {
+    if (!canLoadPrivateCorpus || activeTab !== "references" || !selectedReviewLineageId) return;
+    let active = true;
+    setSelectedReviewRead({ lineageId: selectedReviewLineageId, state: "loading", error: null });
+    void loadEditorReferenceReviewDetails(selectedReviewLineageId).then(({ relations, messages: history }) => {
+      if (!active) return;
+      setSemanticRelations((current) => [...current.filter((relation) => relation.subjectLineageId !== selectedReviewLineageId || relation.subjectKind !== "reference"), ...relations]);
+      setMessages((current) => [...current.filter((message) => !history.some((entry) => entry.id === message.id)), ...history]);
+      setSelectedReviewRead({ lineageId: selectedReviewLineageId, state: "ready", error: null });
+    }).catch((error) => {
+      if (active) setSelectedReviewRead({ lineageId: selectedReviewLineageId, state: "error", error: error instanceof Error ? error.message : "Reference review details could not be loaded." });
+    });
+    return () => { active = false; };
+  }, [activeTab, canLoadPrivateCorpus, selectedReviewLineageId, selectedReviewAttempt]);
+  const selectedReviewIsCurrent = selectedReviewLineageId && !dashboard.isDemo;
+  const predictionState = selectedReviewIsCurrent
+    ? selectedReviewRead.lineageId === selectedReviewLineageId ? selectedReviewRead.state : "loading"
+    : referenceReviewData.state;
+  const predictionError = selectedReviewIsCurrent ? selectedReviewRead.error : referenceReviewData.error;
+  const retryReferenceReviewData = () => { referenceReviewData.retry(); setSelectedReviewAttempt((current) => current + 1); };
+
   const applyReferenceRecord = useCallback((nextReference: ReferenceRecord) => {
     const { nextRecords, nextRecord, previousRecord } = upsertReferenceRecords(referencesRef.current, nextReference);
     referencesRef.current = nextRecords;
@@ -1594,96 +1606,98 @@ function NewsDeskDashboard({
     reasonCode?: ReferenceRejectionReasonCode | null,
     relevance?: { decisionRelationId: string; shareable: boolean },
     sectionId?: string | null,
-  ) {
-    const nextStatus = referenceCurationStatusForAction(action);
-    setActionState({ id: reference.id, message: `${action} pending`, tone: "pending" });
-    if (dashboard.isDemo) {
-      const now = new Date().toISOString();
-      const messageId = `message-demo-${reference.id}-${action}-${now.replace(/[^0-9]/g, "")}`;
-      const relationId = `semantic-relation-demo-${messageId}`;
-      applyReferenceRecord(buildReviewedReferenceRecord(referencesRef.current, reference, {
-        actorLabel: authState.label,
-        nextStatus,
-        note: note ?? null,
-        now,
-      }));
-      setMessages((current) => [{
-        id: messageId,
-        messageKind: "reference_curation",
-        messageDomain: "commentary",
-        status: "active",
-        body: note?.trim() || `${authState.label} marked this reference ${nextStatus}.`,
-        summary: `${reference.title ?? reference.externalItemId}: ${nextStatus}`,
-        source: "newsroom",
-        authorLabel: authState.label,
-        createdAt: now,
-        updatedAt: now,
-        metadata: {
-          action,
-          curationStatus: nextStatus,
-          reasonCode: action === "reject" ? reasonCode ?? null : null,
-          ...(relevance ? { decisionRelationId: relevance.decisionRelationId, shareable: relevance.shareable } : {}),
-          ...(action === "accept" && sectionId ? { sectionId } : {}),
-        },
-      }, ...current]);
-      setSemanticRelations((current) => [{
-        id: relationId,
-        relationState: "current",
-        predicate: "comment",
-        relationTypeId: "semantic-relation-type-comment",
-        relationTypeKey: "comment",
-        relationDomain: "commentary",
-        subjectKind: "message",
-        subjectId: messageId,
-        subjectLineageId: messageId,
-        subjectVersionNumber: 1,
-        objectKind: "reference",
-        objectId: reference.id,
-        objectLineageId: reference.lineageId ?? reference.id,
-        objectVersionNumber: reference.versionNumber ?? null,
-        subjectStateKey: `message#${messageId}#current`,
-        objectStateKey: `reference#${reference.lineageId ?? reference.id}#current`,
-        objectSubjectStateKey: `reference#${reference.lineageId ?? reference.id}#current#message`,
-        predicateObjectStateKey: `comment#reference#${reference.lineageId ?? reference.id}#current`,
-        subjectVersionKey: `message#${messageId}`,
-        objectVersionKey: `reference#${reference.id}`,
-        rank: 1,
-        reviewRecommended: false,
-        importedAt: now,
-      }, ...current]);
-      setActionState({ id: reference.id, message: `${action} saved`, tone: "ok" });
-      return;
-    }
-    startTransition(() => {
-      void (async () => {
-        try {
-          const response = await dataClient.mutations.reviewReferenceCuration(
-            {
-              referenceId: reference.id,
-              action,
-              actorLabel: authState.label,
-              note: note?.trim() || undefined,
-              reasonCode: action === "reject" ? reasonCode ?? undefined : undefined,
-              decisionRelationId: relevance?.decisionRelationId,
-              shareable: relevance ? relevance.shareable : undefined,
-              sectionId: action === "accept" ? sectionId ?? undefined : undefined,
-            },
-            { authMode: USER_POOL_AUTH_MODE },
-          );
-          const review = assertReferenceReviewMutationSucceeded(response, reference.id);
-          const status = review.status ?? nextStatus;
-          const now = new Date().toISOString();
-          applyReferenceRecord(buildReviewedReferenceRecord(referencesRef.current, reference, {
+  ): Promise<void> {
+    return runReferenceReviewRequest(referenceReviewsPending.current, reference.lineageId ?? reference.id, async () => {
+      if (!canEdit) throw new Error("Your session does not have permission to review references.");
+      const nextStatus = referenceCurationStatusForAction(action);
+      setActionState({ id: reference.id, message: `${action} pending`, tone: "pending" });
+      if (dashboard.isDemo) {
+        const now = new Date().toISOString();
+        const messageId = `message-demo-${reference.id}-${action}-${now.replace(/[^0-9]/g, "")}`;
+        const relationId = `semantic-relation-demo-${messageId}`;
+        applyReferenceRecord(buildReviewedReferenceRecord(referencesRef.current, reference, {
+          actorLabel: authState.label,
+          nextStatus,
+          note: note ?? null,
+          now,
+        }));
+        setMessages((current) => [{
+          id: messageId,
+          messageKind: "reference_curation",
+          messageDomain: "commentary",
+          status: "active",
+          body: note?.trim() || `${authState.label} marked this reference ${nextStatus}.`,
+          summary: `${reference.title ?? reference.externalItemId}: ${nextStatus}`,
+          source: "newsroom",
+          authorLabel: authState.label,
+          createdAt: now,
+          updatedAt: now,
+          metadata: {
+            referenceLineageId: reference.lineageId ?? reference.id,
+            action,
+            curationStatus: nextStatus,
+            reasonCode: action === "reject" ? reasonCode ?? null : null,
+            ...(relevance ? { decisionRelationId: relevance.decisionRelationId, shareable: relevance.shareable } : {}),
+            ...(action === "accept" && sectionId ? { sectionId } : {}),
+          },
+        }, ...current]);
+        setSemanticRelations((current) => [{
+          id: relationId,
+          relationState: "current",
+          predicate: "comment",
+          relationTypeId: "semantic-relation-type-comment",
+          relationTypeKey: "comment",
+          relationDomain: "commentary",
+          subjectKind: "message",
+          subjectId: messageId,
+          subjectLineageId: messageId,
+          subjectVersionNumber: 1,
+          objectKind: "reference",
+          objectId: reference.id,
+          objectLineageId: reference.lineageId ?? reference.id,
+          objectVersionNumber: reference.versionNumber ?? null,
+          subjectStateKey: `message#${messageId}#current`,
+          objectStateKey: `reference#${reference.lineageId ?? reference.id}#current`,
+          objectSubjectStateKey: `reference#${reference.lineageId ?? reference.id}#current#message`,
+          predicateObjectStateKey: `comment#reference#${reference.lineageId ?? reference.id}#current`,
+          subjectVersionKey: `message#${messageId}`,
+          objectVersionKey: `reference#${reference.id}`,
+          rank: 1,
+          reviewRecommended: false,
+          importedAt: now,
+        }, ...current]);
+        setActionState({ id: reference.id, message: `${action} saved`, tone: "ok" });
+        return;
+      }
+      try {
+        const response = await dataClient.mutations.reviewReferenceCuration(
+          {
+            referenceId: reference.id,
+            action,
             actorLabel: authState.label,
-            nextStatus: status,
-            note: note?.trim() || null,
-            now,
-          }));
-          setActionState({ id: reference.id, message: `${action} saved`, tone: "ok" });
-        } catch (error) {
-          setActionState({ id: reference.id, message: error instanceof Error ? error.message : `${action} failed`, tone: "error" });
-        }
-      })();
+            note: note?.trim() || undefined,
+            reasonCode: action === "reject" ? reasonCode ?? undefined : undefined,
+            decisionRelationId: relevance?.decisionRelationId,
+            shareable: relevance ? relevance.shareable : undefined,
+            sectionId: action === "accept" ? sectionId ?? undefined : undefined,
+          },
+          { authMode: USER_POOL_AUTH_MODE },
+        );
+        const review = assertReferenceReviewMutationSucceeded(response, reference.id);
+        const status = review.status ?? nextStatus;
+        const now = new Date().toISOString();
+        applyReferenceRecord(buildReviewedReferenceRecord(referencesRef.current, reference, {
+          actorLabel: authState.label,
+          nextStatus: status,
+          note: note?.trim() || null,
+          now,
+        }));
+        setActionState({ id: reference.id, message: `${action} saved`, tone: "ok" });
+        retryReferenceReviewData();
+      } catch (error) {
+        setActionState({ id: reference.id, message: error instanceof Error ? error.message : `${action} failed`, tone: "error" });
+        throw error;
+      }
     });
   }
 
@@ -3127,7 +3141,7 @@ function NewsDeskDashboard({
           <NewsroomReferencesView
             demo={Boolean(dashboard.isDemo)}
             disabled={controlsDisabled}
-            initialReferenceLineageId={initialSelection.reference ?? pathnameReferenceLineageId}
+            initialReferenceLineageId={selectedReviewLineageId}
             cyclotronStatus={cyclotronStatus}
             cyclotronPriming={{
               labels: primingLabels,
@@ -3139,8 +3153,8 @@ function NewsDeskDashboard({
               },
             }}
             decisions={relevanceDecisions}
-            humanCuratedReferenceLineageIds={humanCuratedReferenceLineageIds}
-            delegatedCurations={delegatedCurations}
+            humanCuratedReferenceLineageIds={selectedReviewIsCurrent && predictionState !== "ready" ? undefined : humanCuratedReferenceLineageIds}
+            delegatedCurations={selectedReviewIsCurrent && predictionState !== "ready" ? undefined : delegatedCurations}
             shadowAgreement={shadowAgreement}
             onRequestReviewRate={relevanceCyclotronId ? async (choice) => {
               const request = buildReviewRateRequest(choice, authState.label);
@@ -3153,11 +3167,19 @@ function NewsDeskDashboard({
               curation.note ?? undefined,
               normalizeReferenceRejectionReasonCode(curation.reasonCode),
               { decisionRelationId: curation.decisionRelationId, shareable: curation.shareable },
+              curation.sectionId,
             )}
             sections={sectionChoices}
             sectionSuggestions={sectionSuggestions}
             sectionAgreement={siteSectionAgreement}
-            onReview={(reference, action, options) => runReferenceCurationAction(reference, action, undefined, undefined, undefined, options?.sectionId)}
+            predictionState={predictionState}
+            predictionError={predictionError}
+            onRetryPredictions={retryReferenceReviewData}
+            reviewReasons={reviewReasons}
+            reviewSectionIds={reviewSectionIds}
+            onReview={(reference, action, options) => runReferenceCurationAction(reference, action, options?.note, options?.reasonCode,
+              options?.decisionRelationId ? { decisionRelationId: options.decisionRelationId, shareable: options.shareable === true } : undefined,
+              options?.sectionId)}
             referenceAttachments={referenceAttachments}
             references={references}
           />

package/lib/cyclotron-suggestions.ts

@@ -187,8 +187,8 @@ export function curationForSuggestionChoice(decision: RelevanceDecisionView, cho
 }
 
 export type ProvenanceSummary = {
-  teachingLabelsSentence: string;
-  primingExamplesSentence: string;
+  teachingLabelsSentence: string | null;
+  primingExamplesSentence: string | null;
   doctrineShortHash: string | null;
   modelVersion: string | null;
   decidedAt: string | null;
@@ -202,8 +202,8 @@ export function provenanceSummary(decision: RelevanceDecisionView): ProvenanceSu
   if (!provenance) return null;
   const plural = (count: number, singular: string) => `${count} ${singular}${count === 1 ? "" : "s"}`;
   return {
-    teachingLabelsSentence: `Based on ${plural(provenance.teachingLabels, "decision")} that editors made themselves`,
-    primingExamplesSentence: `${plural(provenance.primingExamples, "example reference")} supplied as starting examples`,
+    teachingLabelsSentence: provenance.teachingLabels === null ? null : `Based on ${plural(provenance.teachingLabels, "decision")} that editors made themselves`,
+    primingExamplesSentence: provenance.primingExamples === null ? null : `${plural(provenance.primingExamples, "example reference")} supplied as starting examples`,
     doctrineShortHash: provenance.doctrineFingerprint ? provenance.doctrineFingerprint.slice(0, SHORT_HASH_LENGTH) : null,
     modelVersion: decision.version === null ? null : `revision ${decision.version}`,
     decidedAt: decision.decidedAt,

package/lib/reference-review-details.ts

@@ -0,0 +1,71 @@
+import type { HydratedModelPayload, MessageRecord, SemanticRelationRecord } from "./category-repository";
+import { normalizeReferenceRejectionReasonCode, type ReferenceRejectionReasonCode } from "./reference-policy";
+
+function metadataRecord(value: unknown): Record<string, unknown> {
+  if (typeof value === "string") {
+    try { return metadataRecord(JSON.parse(value)); } catch { return {}; }
+  }
+  return value && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : {};
+}
+
+/** The selected Reference's index is authoritative even when the global feed is truncated. */
+export async function loadReferenceReviewDetails(lineageId: string, read: {
+  relations: (direction: "incoming" | "outgoing") => Promise<SemanticRelationRecord[]>;
+  message: (id: string) => Promise<MessageRecord | null>;
+  payloads: (id: string) => Promise<HydratedModelPayload[]>;
+}): Promise<{ relations: SemanticRelationRecord[]; messages: MessageRecord[] }> {
+  const [outgoing, incoming] = await Promise.all([read.relations("outgoing"), read.relations("incoming")]);
+  const relations = outgoing.filter((relation) => relation.subjectKind === "reference" && relation.subjectLineageId === lineageId);
+  const latest = incoming.filter((relation) => relation.predicate === "comment" && relation.relationState === "current"
+    && relation.subjectKind === "message" && relation.objectKind === "reference" && relation.objectLineageId === lineageId
+    && metadataRecord(relation.metadata).messageKind === "reference_curation")
+    .sort((a, b) => String(b.createdAt ?? b.importedAt ?? "").localeCompare(String(a.createdAt ?? a.importedAt ?? "")))[0];
+  if (!latest) return { relations, messages: [] };
+  const message = await read.message(latest.subjectId);
+  if (!message || message.messageKind !== "reference_curation") throw new Error("The latest reference review could not be loaded.");
+  const payload = (await read.payloads(message.id))
+    .filter((entry) => entry.attachment.role === "metadata" && entry.attachment.ownerKind === "message" && entry.attachment.ownerId === message.id)
+    .sort((a, b) => String(b.attachment.updatedAt ?? "").localeCompare(String(a.attachment.updatedAt ?? "")))[0];
+  if (!payload) throw new Error("The latest reference review metadata could not be loaded.");
+  if (payload.error) throw new Error(payload.error);
+  if (!payload.json || typeof payload.json !== "object" || Array.isArray(payload.json)) {
+    throw new Error("The latest reference review metadata is invalid.");
+  }
+  const hydrated = { ...message, metadata: payload.json };
+  const recordedLineage = metadataRecord(hydrated.metadata).referenceLineageId;
+  if (recordedLineage !== lineageId) throw new Error("The latest review metadata does not match this reference lineage.");
+  return { relations, messages: [hydrated] };
+}
+
+function latestReferenceReviews(messages: MessageRecord[]): Map<string, MessageRecord> {
+  const latest = new Map<string, MessageRecord>();
+  for (const message of messages) {
+    if (message.messageKind !== "reference_curation") continue;
+    const lineage = metadataRecord(message.metadata).referenceLineageId;
+    if (typeof lineage !== "string" || !lineage) continue;
+    if (!latest.has(lineage) || String(message.createdAt).localeCompare(String(latest.get(lineage)!.createdAt)) > 0) latest.set(lineage, message);
+  }
+  return latest;
+}
+
+/** A later acceptance or archive clears any earlier rejection reason. */
+export function latestReferenceReviewReasons(messages: MessageRecord[]): Map<string, ReferenceRejectionReasonCode> {
+  const reasons = new Map<string, ReferenceRejectionReasonCode>();
+  for (const [lineage, message] of latestReferenceReviews(messages)) {
+    const metadata = metadataRecord(message.metadata);
+    const reason = metadata.action === "reject" ? normalizeReferenceRejectionReasonCode(metadata.reasonCode) : null;
+    if (reason) reasons.set(lineage, reason);
+  }
+  return reasons;
+}
+
+/** Preserve only a Section explicitly recorded on the newest acceptance, never a prediction. */
+export function latestReferenceReviewSections(messages: MessageRecord[]): Map<string, string> {
+  const sections = new Map<string, string>();
+  for (const [lineage, message] of latestReferenceReviews(messages)) {
+    const metadata = metadataRecord(message.metadata);
+    const sectionId = metadata.action === "accept" && typeof metadata.sectionId === "string" ? metadata.sectionId.trim() : "";
+    if (sectionId) sections.set(lineage, sectionId);
+  }
+  return sections;
+}

package/lib/reference-review-request.ts

@@ -0,0 +1,14 @@
+/** Hold the lock before invoking a save, including before React can rerender. */
+export function runReferenceReviewRequest(
+  pending: Map<string, Promise<void>>,
+  lineageId: string,
+  save: () => Promise<void>,
+): Promise<void> {
+  const existing = pending.get(lineageId);
+  if (existing) return existing;
+  const request = Promise.resolve().then(save).finally(() => {
+    if (pending.get(lineageId) === request) pending.delete(lineageId);
+  });
+  pending.set(lineageId, request);
+  return request;
+}

package/lib/relevance-decisions.ts

@@ -7,8 +7,12 @@ export type RelevanceProvenance = {
   labelSet: string[];
   doctrineFingerprint: string | null;
   teachingFingerprint: string | null;
-  teachingLabels: number;
-  primingExamples: number;
+  teachingLabels: number | null;
+  primingExamples: number | null;
+  /** Recorded by the shared monitoring router, absent on local sweep provenance. */
+  system?: string;
+  publicationId?: string;
+  output?: string;
 };
 
 /** The relevance cyclotron's current decision about one reference, as the References tab shows it. */
@@ -28,6 +32,7 @@ export type RelevanceDecisionView = {
   /** Thumbs for a two-class decision with a positive label; per-class buttons otherwise. */
   reviewControl: "thumbs" | "labels";
   cyclotronId: string | null;
+  classifierId?: string;
   /** When the cyclotron made the suggestion, if the decision recorded it. */
   decidedAt: string | null;
   /** Null for decisions made before provenance was recorded. */
@@ -44,6 +49,7 @@ export type RelevanceReview = {
 
 /** The existing curation action an editor's review becomes. */
 export type RelevanceCuration = {
+  sectionId?: string | null;
   action: "accept" | "reject";
   reasonCode: string | null;
   note: string | null;
@@ -65,7 +71,7 @@ function parseMetadata(value: unknown): Record<string, unknown> {
 function parseProvenance(value: unknown): RelevanceProvenance | null {
   const record = parseMetadata(value);
   if (!Object.keys(record).length) return null;
-  const count = (entry: unknown) => (Number.isFinite(Number(entry)) ? Number(entry) : 0);
+  const count = (entry: unknown) => typeof entry === "number" && Number.isInteger(entry) && entry >= 0 ? entry : null;
   const text = (entry: unknown) => (typeof entry === "string" && entry ? entry : null);
   return {
     labelSet: Array.isArray(record.labelSet) ? record.labelSet.map(String) : [],
@@ -73,27 +79,52 @@ function parseProvenance(value: unknown): RelevanceProvenance | null {
     teachingFingerprint: text(record.teachingFingerprint),
     teachingLabels: count(record.teachingLabels),
     primingExamples: count(record.primingExamples),
+    ...(text(record.system) ? { system: text(record.system)! } : {}),
+    ...(text(record.publicationId) ? { publicationId: text(record.publicationId)! } : {}),
+    ...(text(record.output) ? { output: text(record.output)! } : {}),
   };
 }
 
+function recordedVersion(value: unknown): number | null {
+  if ((typeof value !== "number" && typeof value !== "string") || String(value).trim() === "") return null;
+  const version = Number(value);
+  return Number.isInteger(version) && version >= 0 ? version : null;
+}
+
+function decisionTime(relation: SemanticRelationRecord): number {
+  const metadata = parseMetadata(relation.metadata);
+  for (const value of [metadata.decidedAt, relation.importedAt, relation.createdAt]) {
+    if (typeof value !== "string") continue;
+    const timestamp = Date.parse(value);
+    if (Number.isFinite(timestamp)) return timestamp;
+  }
+  return 0;
+}
+
 /**
  * Current decisions keyed by reference lineage, from relations the Newsroom
  * already loads: no extra request per row.
  */
 export function currentRelevanceDecisions(relations: SemanticRelationRecord[]): Map<string, RelevanceDecisionView> {
   const decisions = new Map<string, RelevanceDecisionView>();
-  for (const relation of relations) {
-    if (relation.predicate !== RELEVANCE_RELATION || relation.relationState !== "current") continue;
+  // Realtime events can briefly expose both sides of a superseding write. The
+  // result must not depend on list pagination or subscription arrival order.
+  const ordered = [...relations].sort((left, right) => decisionTime(left) - decisionTime(right) || left.id.localeCompare(right.id));
+  for (const relation of ordered) {
+    if (relation.predicate !== RELEVANCE_RELATION || relation.relationState !== "current" || relation.subjectKind !== "reference") continue;
     const metadata = parseMetadata(relation.metadata);
+    if (!relation.subjectLineageId || typeof metadata.label !== "string" || !metadata.label.trim()
+      || typeof metadata.decisionId !== "string" || !metadata.decisionId.trim()) continue;
     const probabilities = parseMetadata(metadata.probabilities);
     const reason = metadata.reviewReason === "program" || metadata.reviewReason === "audit" ? metadata.reviewReason : null;
-    const version = Number(relation.modelVersion ?? metadata.version);
+    const version = recordedVersion(relation.modelVersion ?? metadata.version);
     decisions.set(relation.subjectLineageId, {
       decisionRelationId: relation.id,
-      decisionId: String(metadata.decisionId ?? ""),
-      label: String(metadata.label ?? ""),
-      confidence: typeof relation.confidence === "number" ? relation.confidence : null,
-      version: Number.isFinite(version) ? version : null,
+      decisionId: metadata.decisionId,
+      label: metadata.label,
+      confidence: typeof relation.confidence === "number" && Number.isFinite(relation.confidence)
+        && relation.confidence >= 0 && relation.confidence <= 1 ? relation.confidence : null,
+      version,
       reviewRecommended: Boolean(relation.reviewRecommended),
       reviewReason: reason,
       reviewDetail: typeof metadata.reviewDetail === "string" ? metadata.reviewDetail : null,
@@ -104,6 +135,7 @@ export function currentRelevanceDecisions(relations: SemanticRelationRecord[]):
       question: typeof metadata.question === "string" ? metadata.question : null,
       reviewControl: metadata.reviewControl === "thumbs" ? "thumbs" : "labels",
       cyclotronId: typeof metadata.cyclotronId === "string" ? metadata.cyclotronId : null,
+      ...(relation.classifierId ? { classifierId: relation.classifierId } : {}),
       decidedAt: typeof metadata.decidedAt === "string" ? metadata.decidedAt : null,
       provenance: parseProvenance(metadata.provenance),
     });

package/lib/use-reference-review-data.ts

@@ -0,0 +1,44 @@
+"use client";
+
+import { useCallback, useEffect, useState } from "react";
+
+/** Load persisted predictions and attributed review history without cancelling on a loading rerender. */
+export function useReferenceReviewData<Relation, Message>({
+  enabled,
+  loadRelations,
+  loadMessages,
+  onRelations,
+  onMessages,
+}: {
+  enabled: boolean;
+  loadRelations: () => Promise<Relation[]>;
+  loadMessages: () => Promise<Message[]>;
+  onRelations: (relations: Relation[]) => void;
+  onMessages: (messages: Message[]) => void;
+}) {
+  const [state, setState] = useState<"loading" | "ready" | "error">(enabled ? "loading" : "ready");
+  const [error, setError] = useState<string | null>(null);
+  const [attempt, setAttempt] = useState(0);
+  const retry = useCallback(() => setAttempt((current) => current + 1), []);
+  useEffect(() => {
+    if (!enabled) return;
+    let active = true;
+    setState("loading");
+    setError(null);
+    void Promise.allSettled([loadRelations(), loadMessages()]).then(([relations, history]) => {
+      if (!active) return;
+      if (relations.status === "fulfilled") onRelations(relations.value);
+      if (history.status === "fulfilled") onMessages(history.value);
+      const failure = relations.status === "rejected" ? relations.reason : history.status === "rejected" ? history.reason : null;
+      if (failure) {
+        const subject = relations.status === "rejected" ? "Predictions" : "Review history";
+        setError(`${subject} could not be loaded. ${failure instanceof Error ? failure.message : "Try again."}`);
+        setState("error");
+      } else {
+        setState("ready");
+      }
+    });
+    return () => { active = false; };
+  }, [enabled, loadRelations, loadMessages, onRelations, onMessages, attempt]);
+  return { state, error, retry };
+}

package/package.json

@@ -298,6 +298,8 @@
     "./lib/reader-subject": "./lib/reader-subject.ts",
     "./lib/reference-display": "./lib/reference-display.ts",
     "./lib/reference-policy": "./lib/reference-policy.ts",
+    "./lib/reference-review-details": "./lib/reference-review-details.ts",
+    "./lib/reference-review-request": "./lib/reference-review-request.ts",
     "./lib/reference-source-preview": "./lib/reference-source-preview.ts",
     "./lib/relevance-decisions": "./lib/relevance-decisions.ts",
     "./lib/relevance-status": "./lib/relevance-status.ts",
@@ -329,6 +331,7 @@
     "./lib/test-editor-override": "./lib/test-editor-override.ts",
     "./lib/text-columns": "./lib/text-columns.ts",
     "./lib/themed-image": "./lib/themed-image.ts",
+    "./lib/use-reference-review-data": "./lib/use-reference-review-data.ts",
     "./lib/utils": "./lib/utils.ts",
     "./lib/video-loading": "./lib/video-loading.ts",
     "./lib/video-mode": "./lib/video-mode.ts",
@@ -444,7 +447,7 @@
       "optional": true
     }
   },
-  "version": "2.0.0-next.77",
+  "version": "2.0.0-next.78",
   "dependencies": {
     "@aws-amplify/adapter-nextjs": "^1.7.3",
     "@aws-crypto/sha256-js": "5.2.0",

package/routes.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.0.0-next.77",
+  "version": "2.0.0-next.78",
   "routes": [
     {
       "file": "app/%5F_preview/[[...path]]/route.ts",