@anthusai/papyrus 2.0.0-next.9 → 2.0.0-next.90

package/components/newsroom-organizer.css

@@ -23,6 +23,8 @@ body:has(.newsroom-organizer)>[data-staging-banner]{flex-shrink:0}
 .organizer-sidebar-head{display:flex;align-items:flex-start;justify-content:space-between;gap:8px}.organizer-sidebar-head .organizer-brand{flex:1;min-width:0}
 .organizer-header-actions{display:flex;align-items:center;gap:8px;min-width:0;max-width:45%;overflow-x:auto}
 .organizer-main{min-width:0;min-height:0;overflow:auto;overscroll-behavior:contain;flex:1;padding:16px 0}
+.newsroom-overview-feed-frame{height:auto}
+@media(min-width:640px){.newsroom-overview-feed-frame{height:38rem;overflow-y:auto}}
 .organizer-main>[data-category-steering]{min-height:0}.organizer-demo-notice{font-size:11px;color:var(--org-muted);margin-bottom:12px}
 .organizer-account{display:flex;align-items:center;gap:10px;min-height:44px;flex-shrink:0;border:1px solid var(--org-line);padding:8px;text-align:left;border-radius:3px}
 .organizer-account span{min-width:0}.organizer-account strong{display:block;font:600 11px var(--kb-theme-ui-font);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.organizer-account small{display:block;font-size:9px;color:var(--org-muted);margin-top:2px}
@@ -313,3 +315,34 @@ body:has(.newsroom-organizer)>[data-staging-banner]{flex-shrink:0}
 .news-desk-columns--administration .news-desk-delegation-decision button:focus-visible{outline:2px solid var(--org-ink);outline-offset:2px}
 @container (max-width:640px){.news-desk-columns--administration .news-desk-delegation-pending-list li{grid-template-columns:minmax(0,1fr)}.news-desk-columns--administration .news-desk-delegation-code{font-size:28px}}
 @container (max-width:640px){.news-desk-columns--administration .news-desk-delegation-form{grid-template-columns:minmax(0,1fr)}.news-desk-columns--administration .news-desk-delegation-list li{grid-template-columns:minmax(0,1fr)}}
+.news-desk-columns--administration .news-desk-monitoring__scope{display:flex;flex-wrap:wrap;gap:8px}
+.news-desk-columns--administration .news-desk-monitoring__scope button{min-height:36px;padding:4px 12px;border:1px solid var(--org-line);background:transparent;color:var(--administration-strong);font:600 12px/1.2 var(--kb-theme-ui-font);letter-spacing:.05em;text-transform:uppercase;cursor:pointer}
+.news-desk-columns--administration .news-desk-monitoring__scope button[aria-pressed=true]{border-color:var(--org-ink);border-width:2px;text-decoration:underline;text-underline-offset:4px}
+.news-desk-columns--administration .news-desk-monitoring__list,.news-desk-columns--administration .news-desk-monitoring__queue,.news-desk-columns--administration .news-desk-monitoring__relevance{list-style:none;margin:0;padding:0;display:grid}
+.news-desk-columns--administration .news-desk-monitoring__list li{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr) minmax(0,2fr);gap:4px 16px;align-items:baseline;padding:10px 0;border-top:1px solid var(--org-line);min-width:0;overflow-wrap:anywhere}
+.news-desk-columns--administration .news-desk-monitoring__list li>div{display:grid;gap:2px}
+.news-desk-columns--administration .news-desk-monitoring__queue>li{display:grid;gap:6px;padding:12px 0;border-top:1px solid var(--org-line);min-width:0}
+.news-desk-columns--administration .news-desk-monitoring__queue>li>div{display:grid;gap:2px}
+.news-desk-columns--administration .news-desk-monitoring__queue>li>div>span,.news-desk-columns--administration .news-desk-monitoring__routing{margin:0;font:400 12px/1.4 var(--kb-theme-ui-font);color:var(--administration-quiet)}
+.news-desk-columns--administration .news-desk-monitoring__queue li[data-routing=error]{padding-left:12px;border-left:3px solid var(--org-ink)}
+.news-desk-columns--administration .news-desk-monitoring__relevance{gap:4px;padding-left:12px;border-left:1px solid var(--org-line)}
+.news-desk-columns--administration .news-desk-monitoring__relevance li{display:flex;flex-wrap:wrap;gap:4px 12px;font:400 13px/1.4 var(--kb-theme-ui-font)}
+.news-desk-columns--administration .news-desk-monitoring__relevance li[data-delivery=failed] span:last-child{font-weight:700}
+.news-desk-columns--administration .news-desk-monitoring__usage{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:12px 24px;margin:0}
+.news-desk-columns--administration .news-desk-monitoring__usage dt{font:600 11px/1.4 var(--kb-theme-ui-font);letter-spacing:.07em;text-transform:uppercase;color:var(--administration-quiet)}
+.news-desk-columns--administration .news-desk-monitoring__usage dd{margin:0;font:700 26px/1.1 var(--kb-theme-title-font);font-variant-numeric:tabular-nums}
+@container (max-width:640px){.news-desk-columns--administration .news-desk-monitoring__list li{grid-template-columns:minmax(0,1fr)}}
+
+/* Newsletter panel (components/newsletter-panel.tsx): reuses the administration card, row and button styles above. */
+.news-desk-columns--administration .news-desk-newsletter__quiet{font:400 12px/1.4 var(--kb-theme-ui-font);color:var(--administration-quiet)}
+.news-desk-columns--administration .news-desk-monitoring__usage>div{display:grid;gap:4px;align-content:start}
+.news-desk-columns--administration .news-desk-newsletter__links{display:flex;flex-wrap:wrap;gap:4px 8px}
+.news-desk-columns--administration .news-desk-newsletter__table{width:100%;border-collapse:collapse;font:400 13px/1.4 var(--kb-theme-ui-font)}
+.news-desk-columns--administration .news-desk-newsletter__table td:first-child{word-break:keep-all;overflow-wrap:break-word}
+.news-desk-columns--administration .news-desk-newsletter__table th{text-align:left;padding:6px 8px;border-bottom:2px solid var(--administration-strong);font:600 11px/1.4 var(--kb-theme-ui-font);letter-spacing:.07em;text-transform:uppercase;color:var(--administration-quiet)}
+.news-desk-columns--administration .news-desk-newsletter__table td{padding:8px;border-bottom:1px solid var(--org-line);vertical-align:top}
+.news-desk-columns--administration .news-desk-newsletter__drawer{grid-column:1/-1;display:grid;gap:12px;padding:12px 0 0;border-top:1px dashed var(--org-line);min-width:0}
+.news-desk-columns--administration .news-desk-newsletter__frame{width:100%;height:480px;border:1px solid var(--org-line);background:#fff}
+.news-desk-columns--administration .news-desk-newsletter__text{margin:0;padding:12px;max-height:280px;overflow:auto;border:1px solid var(--org-line);font:400 12px/1.5 ui-monospace,monospace;white-space:pre-wrap;overflow-wrap:anywhere}
+.news-desk-columns--administration .news-desk-newsletter__filters{display:flex;flex-wrap:wrap;gap:12px 24px}
+.news-desk-columns--administration .news-desk-newsletter__filters .news-desk-doctrine-card__field{min-width:180px}

package/components/newsroom-overview-skeleton.tsx

@@ -0,0 +1,25 @@
+"use client";
+
+import * as React from "react";
+
+/** Placeholder geometry for the overview while private records or access are unresolved. */
+export function NewsroomOverviewSkeleton() {
+  return (
+    <div aria-label="Loading newsroom overview" className="space-y-8 font-sans" data-newsroom-overview-skeleton role="status">
+      <section className="newsroom-overview-feed-frame space-y-4 overflow-hidden rounded-xl border bg-card p-4" aria-label="Notification Center">
+        <div className="h-6 w-48 rounded bg-muted" />
+        <div className="h-4 w-3/4 max-w-xl rounded bg-muted" />
+        <div className="h-4 w-2/3 max-w-lg rounded bg-muted" />
+        <div className="grid gap-3 sm:grid-cols-2">
+          {Array.from({ length: 4 }, (_, index) => <div className="h-28 rounded-xl border bg-card p-4" key={index}>
+            <div className="h-4 w-2/3 rounded bg-muted" /><div className="mt-4 h-3 w-1/2 rounded bg-muted" />
+          </div>)}
+        </div>
+      </section>
+      <section aria-label="Needs attention" className="space-y-3">
+        <div className="h-4 w-32 rounded bg-muted" />
+        <div className="h-16 rounded-xl border bg-card p-4"><div className="h-4 w-1/2 rounded bg-muted" /><div className="mt-2 h-3 w-1/3 rounded bg-muted" /></div>
+      </section>
+    </div>
+  );
+}

package/components/newsroom-references-view.tsx

@@ -1,8 +1,8 @@
 "use client";
 
 import type { PrimingPanelProps } from "cyclotron/components/priming-panel";
-import { ReferencePriming } from "./reference-priming";
-import { ReferenceCurationControls } from "./reference-curation-controls";
+import { ReferenceAddEntry } from "./reference-add-entry";
+import { ReferenceCurationControls, useReferenceImport } from "./reference-curation-controls";
 
 import {
   ArchiveIcon,
@@ -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,9 +62,16 @@ 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 { ReferenceCyclotronPriming, type PrimingFormInput } from "./reference-cyclotron-priming";
+import type { PrimingFormInput } from "./reference-cyclotron-priming";
 import { ReferenceCyclotronStatus, type ReviewRateChoice } from "./reference-cyclotron-status";
 import type { PrimingRequestView } from "../lib/relevance-status";
 import type { CyclotronStatus } from "cyclotron/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,
@@ -485,12 +603,14 @@ export function NewsroomReferencesView({
   references,
 }: NewsroomReferencesViewProps) {
   const pathname = usePathname();
+  const sessionImport = useReferenceImport(disabled);
+  const [importedCount, setImportedCount] = useState(0);
   const isMobileDetail = useMediaQuery("(max-width: 767px)");
   const pathnameLineageId = useMemo(
     () => parseReferenceLineageIdFromNewsroomPathname(pathname),
     [pathname],
   );
-  const routeLineageId = initialReferenceLineageId ?? pathnameLineageId ?? "";
+  const routeLineageId = pathname ? pathnameLineageId ?? "" : initialReferenceLineageId ?? "";
 
   const canonicalReferences = useMemo(() => selectCanonicalReferenceRecords(references), [references]);
   const statusCounts = useMemo(() => countReferencesByStatus(canonicalReferences), [canonicalReferences]);
@@ -529,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(() => {
@@ -569,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
@@ -589,23 +713,34 @@ export function NewsroomReferencesView({
             Review source intake before it becomes accepted evidence.
           </p>
         </div>
-        <ReferenceLiveAgreement agreement={shadowAgreement} />
-        <ReferenceCurationControls disabled={disabled} />
-        {priming && !disabled ? <ReferencePriming {...priming} /> : null}
-        {cyclotronPriming && !disabled ? (
-          <div className="shrink-0">
-            <ReferenceCyclotronPriming
-              labels={cyclotronPriming.labels}
-              onRequestPriming={cyclotronPriming.onRequest}
-              requests={cyclotronPriming.requests}
-            />
+        {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}
+          key={sessionImport?.sessionKey ?? "no-session"}
+          onImported={() => setImportedCount((count) => count + 1)}
+          url={cyclotronPriming && !disabled
+            ? { labels: cyclotronPriming.labels, onRequest: cyclotronPriming.onRequest, requests: cyclotronPriming.requests }
+            : null}
+        />
+        <ReferenceCurationControls disabled={disabled} refreshSignal={importedCount} />
         {cyclotronStatus ? (
           <div className="shrink-0">
             <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))}