@anthusai/papyrus 2.0.0-next.5 → 2.0.0-next.50

package/components/newsletter-sections.tsx

@@ -0,0 +1,163 @@
+import {
+  countsText,
+  formatInZone,
+  formatUtc,
+  issueEditorHref,
+  statusLabel,
+  statusMark,
+  type NewsletterDelivery,
+  type NewsletterEvent,
+  type NewsletterIssue,
+  type NewsletterOverview,
+  type NewsletterSubscriber,
+} from "../lib/newsletter-model";
+
+/** Presentation only: the panel fetches and holds state, these render what they are given, so every state is testable from fixtures. */
+
+export function ListsCard({ overview }: { overview: NewsletterOverview }) {
+  const { totals } = overview;
+  return (
+    <article className="news-desk-doctrine-card" data-newsletter-section="lists">
+      <div className="news-desk-doctrine-card__header">
+        <div><h3>Lists</h3><span>Subscribers per list. A person on two lists counts on each.</span></div>
+      </div>
+      {overview.lists.length ? (
+        <dl className="news-desk-monitoring__usage">
+          {overview.lists.map((list) => (
+            <div key={list.id} data-newsletter-list={list.id}>
+              <dt>{list.name} ({list.kind === "roundup" ? "roundup" : list.kind === "alert" ? "alerts" : list.kind})</dt>
+              <dd>{list.confirmed}</dd>
+              <span className="news-desk-newsletter__quiet">confirmed &middot; {list.pending} pending &middot; {list.unsubscribed} unsubscribed</span>
+            </div>
+          ))}
+        </dl>
+      ) : <p>No list is configured.</p>}
+      <p className="news-desk-delegation-note" data-newsletter-totals>
+        Across the site: {totals.confirmed} confirmed, {totals.pending} waiting to confirm, {totals.unsubscribed} unsubscribed.
+        {" "}{overview.suppressed} {overview.suppressed === 1 ? "address is" : "addresses are"} suppressed after a bounce or complaint.
+      </p>
+    </article>
+  );
+}
+
+export function SiteStatusCard({ paused, isAdmin, busy, onResume }: { paused: NewsletterOverview["paused"]; isAdmin: boolean; busy: boolean; onResume: () => void }) {
+  return (
+    <article className="news-desk-doctrine-card" data-newsletter-section="site-status">
+      <div className="news-desk-doctrine-card__header">
+        <div><h3>Site status</h3><span>Sending turns itself off when bounces or complaints run high</span></div>
+      </div>
+      {paused.paused ? (
+        <div className="category-steering-alert" role="alert" data-newsletter-paused>
+          <strong><span aria-hidden="true">■ </span>Sending is paused.</strong>{" "}
+          {paused.reason ? <>Reason: {paused.reason}. </> : null}
+          {paused.pausedAt ? <>Paused {formatUtc(paused.pausedAt)}. </> : null}
+          Issues due now are blocked until sending resumes; approve a blocked issue again afterwards.
+          <div className="news-desk-doctrine-card__actions">
+            {isAdmin ? (
+              <button type="button" disabled={busy} data-newsletter-resume onClick={onResume}>Resume sending</button>
+            ) : <span>An admin can resume sending.</span>}
+          </div>
+        </div>
+      ) : (
+        <p data-newsletter-running><span aria-hidden="true">✓ </span>Sending is on.{paused.resumedAt ? ` Resumed ${formatUtc(paused.resumedAt)}.` : ""}</p>
+      )}
+    </article>
+  );
+}
+
+/** What an issue row says about the issue; the buttons beside it belong to the panel. */
+export function IssueSummary({ issue, zone, demo }: { issue: NewsletterIssue; zone: string; demo: boolean }) {
+  return (
+    <>
+      <header>
+        <strong>{issue.subject || "(no subject)"}</strong>
+        <span data-newsletter-status={issue.status}><span aria-hidden="true">{statusMark(issue.status)} </span>{statusLabel(issue.status)}</span>
+      </header>
+      <p>{issue.listName ?? issue.listId}{issue.kind ? ` · ${issue.kind}` : ""}</p>
+      {issue.sendAt ? (
+        <p data-newsletter-send-at>
+          {issue.status === "sent" || issue.status === "sending" ? "Scheduled for " : "Send at "}
+          <time dateTime={issue.sendAt} title={formatUtc(issue.sendAt)}>{formatInZone(issue.sendAt, zone)}</time>
+          {issue.approvedBy ? ` · approved by ${issue.approvedBy}` : ""}
+        </p>
+      ) : null}
+      <p data-newsletter-counts>{countsText(issue.counts ?? {})}</p>
+      {issue.status === "blocked" ? (
+        <p className="category-steering-alert" data-newsletter-blocked>
+          Blocked: {issue.note ?? "see the issue"}. Fix the cause, then approve it again.
+        </p>
+      ) : issue.note ? <p data-newsletter-note>Note: {issue.note}</p> : null}
+      {issue.editedSinceApproval ? (
+        <p className="category-steering-alert" data-newsletter-edited>
+          Edited since approval. When it comes due it will go back to draft and send nothing. Approve it again to send this version.
+        </p>
+      ) : null}
+      <p className="news-desk-newsletter__links">
+        {issue.itemId ? <a href={issueEditorHref(issue.itemId, demo)} data-newsletter-editor-link>Open in the editor</a> : <span>No item</span>}
+        {issue.archiveUrl ? <> &middot; <a href={issue.archiveUrl} target="_blank" rel="noreferrer noopener" data-newsletter-archive-link>Archive page</a></> : null}
+      </p>
+    </>
+  );
+}
+
+export function DeliveriesCard({
+  issue, rows, events, hasMore, loading, isAdmin, onMore,
+}: {
+  issue: NewsletterIssue; rows: NewsletterDelivery[]; events: NewsletterEvent[]; hasMore: boolean; loading: boolean; isAdmin: boolean; onMore: () => void;
+}) {
+  return (
+    <article className="news-desk-doctrine-card" data-newsletter-section="deliveries" data-newsletter-deliveries-for={issue.issueId}>
+      <div className="news-desk-doctrine-card__header">
+        <div><h3>Delivery history</h3><span>{issue.subject} &middot; {countsText(issue.counts ?? {})}</span></div>
+      </div>
+      {!isAdmin ? <p className="news-desk-delegation-note">Addresses are masked for editors.</p> : null}
+      {rows.length ? (
+        <table className="news-desk-newsletter__table">
+          <thead><tr><th scope="col">Address</th><th scope="col">Result</th><th scope="col">Queued (UTC)</th><th scope="col">Last event (UTC)</th></tr></thead>
+          <tbody>
+            {rows.map((row, index) => (
+              <tr key={`${row.address}-${index}`} data-newsletter-delivery={row.status}>
+                <td>{row.address}</td>
+                <td>{row.status}{row.error ? ` (${row.error})` : ""}</td>
+                <td>{formatUtc(row.at)}</td>
+                <td>{row.eventAt ? formatUtc(row.eventAt) : "none yet"}</td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      ) : <p>{loading ? "Loading deliveries..." : "Nothing has been sent for this issue."}</p>}
+      {hasMore ? <div className="news-desk-doctrine-card__actions"><button type="button" disabled={loading} onClick={onMore}>Load more deliveries</button></div> : null}
+      <h4>Recent events for this issue</h4>
+      {events.length ? (
+        <ul className="news-desk-monitoring__list" data-newsletter-events>
+          {events.map((event, index) => (
+            <li key={`${event.at}-${index}`}>
+              <strong>{event.type}{event.detail ? ` (${event.detail})` : ""}</strong>
+              <span>{event.list ?? ""}</span>
+              <span>{formatUtc(event.at)}</span>
+            </li>
+          ))}
+        </ul>
+      ) : <p>No recent events for this issue. Events are kept for 90 days and the panel shows the latest 100 for the whole site.</p>}
+    </article>
+  );
+}
+
+export function SubscribersTable({ rows, zone }: { rows: NewsletterSubscriber[]; zone: string }) {
+  return (
+    <table className="news-desk-newsletter__table" data-newsletter-subscribers>
+      <thead><tr><th scope="col">Address</th><th scope="col">Status</th><th scope="col">Lists</th><th scope="col">Signed up</th><th scope="col">Confirmed</th></tr></thead>
+      <tbody>
+        {rows.map((row) => (
+          <tr key={row.email} data-newsletter-subscriber={row.status}>
+            <td>{row.email}</td>
+            <td>{row.status}</td>
+            <td>{row.lists.length ? row.lists.map((entry) => `${entry.id} (${entry.status})`).join(", ") : "none"}</td>
+            <td>{formatInZone(row.createdAt, zone)}</td>
+            <td>{row.confirmedAt ? formatInZone(row.confirmedAt, zone) : "not yet"}</td>
+          </tr>
+        ))}
+      </tbody>
+    </table>
+  );
+}

package/components/newsroom-article-editor.tsx

@@ -48,11 +48,9 @@ import {
 import { getNewsroomNavHref } from "../lib/newsroom-nav";
 import { SITE_BRAND } from "../lib/site-brand";
 import { cn } from "../lib/utils";
-import amplifyOutputs from "papyrus-amplify-outputs";
-import { applyReplacement, editorialChecksEnabled, inlineFindings, visibleFindings } from "../lib/editorial-checks";
+import { applyReplacement, inlineFindings, visibleFindings } from "../lib/editorial-checks";
 import { graphqlEditorialBackend } from "../lib/editorial-checks-client";
 import { demoEditorialBackend } from "../lib/editorial-checks-demo";
-import type { PluginOutputs } from "../lib/plugin-settings";
 import type { FindingActions } from "./editorial-finding-card";
 import { EditorialFindingsPanel } from "./editorial-findings-panel";
 import { EditorialPreviewPopover, type PreviewPopoverTarget } from "./editorial-preview-popover";
@@ -219,7 +217,7 @@ export function NewsroomArticleEditor({ articleId, demo, embedded = false }: { a
   const frontMatterYaml = editor?.frontMatterYaml ?? null;
   const bodyMarkus = editor?.bodyMarkus ?? null;
   const editorialBackend = useMemo(
-    () => (demo ? demoEditorialBackend : !previewMode && editorialChecksEnabled(amplifyOutputs as PluginOutputs) ? graphqlEditorialBackend : null),
+    () => (demo ? demoEditorialBackend : !previewMode ? graphqlEditorialBackend : null),
     [demo, previewMode],
   );
   const editorial = useEditorialChecks({

package/components/newsroom-board-view.tsx

@@ -3,7 +3,7 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import Link from "next/link";
 import { usePathname, useRouter, useSearchParams } from "next/navigation";
-import { IssueCollection, IssueDetailPanel, IssueTypeFilter, issueTypeFromFilter, useBoardColumnState } from "@kanbus/ui";
+import { IssueCollection, IssueDetailPanel, IssueIdFormatProvider, IssueTypeFilter, issueTypeFromFilter, useBoardColumnState } from "@kanbus/ui";
 import "./newsroom-theme";
 import { PlusIcon } from "lucide-react";
 import { newsroomHref } from "../lib/newsroom-base-path";
@@ -16,6 +16,7 @@ import {
   deskBoardConfig,
   deskContainsAssignment,
   deskContainsContentItem,
+  formatNativeIssueId,
   projectAssignmentBoard,
   projectContentItemBoard,
   type NativeBoardIssue,
@@ -168,6 +169,7 @@ export function NewsroomBoardView({ subject, deskId }: { subject: NewsroomBoardS
         </Link>
       )}
     </>}>
+    <IssueIdFormatProvider formatIssueId={formatNativeIssueId}>
     <div className="organizer-native-board">
       {error && <NewsroomOpsStatusBanner tone="error">{error}</NewsroomOpsStatusBanner>}
       {subject === "desk" && <IssueTypeFilter config={config} value={typeFilter} onChange={setTypeFilter} name="Record type" className="organizer-board-type-filter" />}
@@ -192,5 +194,6 @@ export function NewsroomBoardView({ subject, deskId }: { subject: NewsroomBoardS
         </IssueDetailPanel>}
       </div>
     </div>
+    </IssueIdFormatProvider>
   </NewsroomOpsShell>;
 }

package/components/newsroom-curation-bootstrap.tsx

@@ -0,0 +1,45 @@
+'use client';
+
+import {useEffect,useState,type ReactNode} from 'react';
+import {loadProspectusAccountState} from '../lib/prospectus-account-client';
+import type {CurationBootstrap} from '../lib/curation-client';
+import {NewsroomCurationProvider} from './newsroom-curation-provider';
+
+type Fetcher=(input:string,init?:RequestInit)=>Promise<Response>;
+const CONTEXT_PATH='/api/newsroom/curation/context';
+
+function validBootstrap(value:unknown):value is CurationBootstrap{
+  const body=value as Partial<CurationBootstrap>|null;
+  const scope=body?.scope;
+  return !!scope&&[scope.accountId,scope.publicationId,scope.bindingRevision].every(item=>typeof item==='string'&&item.trim()!=='')
+    &&(body!.mode==='embedded'||body!.mode==='remote')&&Array.isArray(body!.capabilities);
+}
+
+/**
+ * Ask the server for the curation bootstrap, or null. Only a signed-in person with a selected
+ * account causes a context read; every other outcome (no Prospectus, signed out, no selection,
+ * any refusal or failure) is null, so the released CMS is unchanged.
+ */
+export async function loadCurationBootstrap(returnPath:string,fetcher:Fetcher=fetch):Promise<CurationBootstrap|null>{
+  try{
+    const account=await loadProspectusAccountState(returnPath,fetcher);
+    if(account.status!=='signedIn'||!account.selectedAccountId)return null;
+    const response=await fetcher(CONTEXT_PATH,{credentials:'same-origin',cache:'no-store'});
+    if(!response.ok)return null;
+    const body=await response.json().catch(()=>null);
+    if(!validBootstrap(body)||body.scope.accountId!==account.selectedAccountId)return null;
+    return body;
+  }catch{return null;}
+}
+
+/** Mounts the curation provider for the References tab. Fails closed to no provider content. */
+export function NewsroomCurationBootstrap({enabled=true,children}:{enabled?:boolean;children:ReactNode}){
+  const [bootstrap,setBootstrap]=useState<CurationBootstrap|null>(null);
+  useEffect(()=>{
+    if(!enabled)return;
+    let current=true;
+    void loadCurationBootstrap(window.location.pathname).then(value=>{if(current)setBootstrap(value);});
+    return()=>{current=false;setBootstrap(null);};
+  },[enabled]);
+  return <NewsroomCurationProvider bootstrap={bootstrap}>{children}</NewsroomCurationProvider>;
+}

package/components/newsroom-organizer.css

@@ -313,3 +313,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-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,
@@ -63,7 +63,7 @@ import type { SectionSuggestion, SiteSectionAgreement } from "../lib/site-sectio
 /** What an editor adds to an accept: the Section the reference belongs in, which becomes a training label. */
 export type ReferenceReviewOptions = { sectionId?: string | null };
 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";
@@ -485,6 +485,8 @@ 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),
@@ -590,17 +592,15 @@ export function NewsroomReferencesView({
           </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}
-            />
-          </div>
-        ) : null}
+        <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} />

package/components/publication-cyclotron-panel.tsx

@@ -5,6 +5,9 @@ import {ReviewControl,type ReviewControlReview} from 'cyclotron/components/revie
 import {CyclotronStatusView} from 'cyclotron/components/cyclotron-status';
 import {assertPublicationScope,publicationScopeKey,publicationReviewPayload,type PublicationStatus,type PublicationHistory,type PublicationHistoryRow,type PublicationReviewPayload} from '../lib/publication-cyclotron';
 
+/** Steering is offered only when the Cyclotron contract says so; absent means unknown, so off. */
+export function steeringAvailable(status:PublicationStatus):boolean{return status.features?.steering===true;}
+
 function requestId(){
  const bytes=crypto.getRandomValues(new Uint8Array(16));
  return Array.from(bytes,value=>value.toString(16).padStart(2,'0')).join('');
@@ -28,28 +31,30 @@ function PublicationControls({mode,status,history,onReview,onSteer}:PublicationP
    const signature=JSON.stringify(review);const previous=requests.current[key];
    const id=previous?.signature===signature?previous.id:requestId();requests.current[key]={signature,id};
    const payload=publicationReviewPayload(status,row,classifier,review,id);
-   if(!onReview)throw new Error('This host has not enabled human review');
+   if(!onReview)throw new Error('Reviewing is not turned on here.');
    setBusy(key);setMessage(null);await onReview(payload);
-   if(current.current===context){setMessage({context,key,error:false,text:'Human label acknowledged.'});setEditing(old=>({...old,[key]:false}));}
-  }catch(error){if(current.current===context)setMessage({context,key,error:true,text:error instanceof Error?error.message:'Review failed; its outcome must be checked before retrying.'});}
+   if(current.current===context){setMessage({context,key,error:false,text:'Your choice was saved.'});setEditing(old=>({...old,[key]:false}));}
+  }catch(error){if(current.current===context)setMessage({context,key,error:true,text:error instanceof Error?error.message:'Your review may not have been saved; check before trying again.'});}
   finally{if(current.current===context)setBusy(null);}
  }
- return <section data-publication-scope={context} aria-label="Publication Cyclotron controls" className="space-y-4">
-  <header><h2 className="text-lg font-semibold">Cyclotron · {status.publicationId}</h2><p className="text-sm text-muted-foreground">{mode==='embedded'?'Classifier data owned by this deployment.':'Canonical classifier data owned by the shared remote lab.'}</p></header>
+ return <section data-publication-scope={context} aria-label="Suggestions and reviews" className="space-y-4">
+  <header><h2 className="text-lg font-semibold">Suggestions · {status.publicationId}</h2><p className="text-sm text-muted-foreground">{mode==='embedded'?'Suggestions and reviews are kept by this site.':'Suggestions and reviews are kept by the shared review service.'}</p></header>
   {status.outputs.map(output=><section key={`${context}:${output.id}`} aria-label={output.question} className="space-y-3 rounded-md border p-3">
    <CyclotronStatusView status={status.classifiers[output.id]} classifierName={output.question} variant="card"/>
-   {onSteer?<button type="button" disabled={Boolean(busy)} onClick={()=>onSteer(output.id)}>Evaluate classifier proposal</button>:null}
+   {onSteer?(steeringAvailable(status)
+    ?<button type="button" disabled={Boolean(busy)} onClick={()=>onSteer(output.id)}>Test a rule change</button>
+    :<div><button type="button" disabled aria-describedby={`steer-unavailable:${output.id}`}>Test a rule change · Not available yet</button><p id={`steer-unavailable:${output.id}`} className="text-sm text-muted-foreground">Rule changes cannot be tested on this service yet.</p></div>):null}
    {history.history.map(row=>{
     const prediction=row.decision.classifiers[output.id];if(!prediction)return null;
     const key=`${context}:${row.decision.decisionId}:${output.id}:${row.context?.contextId??'legacy'}`;const saved=row.reviews[output.id];const historical=Boolean(row.historicalContext||row.provenanceUnavailable||row.feedbackReconciliationRequired);
     return <article key={key} className="space-y-2 rounded-md border p-3">
-     {historical?<p className="text-sm">Historical source or binding revision · read-only</p>:null}{row.feedbackReconciliationRequired?<p role="status">Canonical feedback changed; provenance reconciliation is required before replay.</p>:null}<h3 className="font-medium">{String(row.item.title??row.decision.itemId)}</h3>
+     {historical?<p className="text-sm">An earlier copy of this source · read-only</p>:null}{row.feedbackReconciliationRequired?<p role="status">Earlier feedback changed; check this item before reviewing again.</p>:null}<h3 className="font-medium">{String(row.item.title??row.decision.itemId)}</h3>
      <p className="whitespace-pre-wrap text-sm">{String(row.item.abstract??row.item.text??'')}</p>
-     {!saved||editing[key]?<p className="text-sm" role="status">{historical?'This source revision is read-only.':!onReview?'Human review is unavailable in this session.':busy===key?'Submitting review… Your selection is preserved; wait for acknowledgement.':'Choose a label to enable Submit review. Explanation is optional.'}</p>:null}
+     {!saved||editing[key]?<p className="text-sm" role="status">{historical?'This earlier copy is read-only.':!onReview?'Reviewing is not available right now.':busy===key?'Saving your review… your choice is kept.':'Choose an option to enable Submit review. An explanation is optional.'}</p>:null}
      <ReviewControl key={`${key}:${Boolean(editing[key])}`} itemId={`${row.decision.itemId}:${Array.from(new TextEncoder().encode(context+':'+output.id+':'+(row.context?.contextId??'legacy')),byte=>byte.toString(16).padStart(2,'0')).join('')}`} decision={{decisionId:row.decision.decisionId,...prediction,classes:output.classes}} question={output.question} mode="labels" positiveLabel={output.positiveLabel??undefined} disabled={Boolean(busy)||!onReview||historical} value={saved&&!editing[key]?{label:saved.label,reasonCode:saved.reasonCode,explanation:saved.explanation}:undefined} onReview={review=>void submit(row,output.id,{...review,itemId:row.decision.itemId})}/>
      {message?.context===context&&message.key===key?<p role={message.error?'alert':'status'} className="text-sm">{message.text}</p>:null}
-     {saved&&onReview&&!historical&&!editing[key]?<button type="button" disabled={Boolean(busy)} onClick={()=>setEditing(old=>({...old,[key]:true}))}>Correct human label</button>:null}
-     <details><summary>Decision provenance and version</summary><pre className="max-h-64 overflow-auto whitespace-pre-wrap text-xs">{JSON.stringify({itemId:row.decision.itemId,source:row.item.source_uri,decisionId:row.decision.decisionId,prediction,bindingRevision:row.context?.binding.values.revision??status.bindingRevision,sourceRef:row.context?.sourceRef,contextId:row.context?.contextId},null,2)}</pre></details>
+     {saved&&onReview&&!historical&&!editing[key]?<button type="button" disabled={Boolean(busy)} onClick={()=>setEditing(old=>({...old,[key]:true}))}>Change my choice</button>:null}
+     <details><summary>Where this suggestion came from</summary><pre className="max-h-64 overflow-auto whitespace-pre-wrap text-xs">{JSON.stringify({itemId:row.decision.itemId,source:row.item.source_uri,decisionId:row.decision.decisionId,prediction,bindingRevision:row.context?.binding.values.revision??status.bindingRevision,sourceRef:row.context?.sourceRef,contextId:row.context?.contextId},null,2)}</pre></details>
     </article>;
    })}
   </section>)}

package/components/reference-add-entry.tsx

@@ -0,0 +1,75 @@
+"use client";
+
+import { useState } from "react";
+import type { PrimingPanelProps } from "cyclotron/components/priming-panel";
+import { ReferenceCyclotronPriming, type PrimingFormInput } from "./reference-cyclotron-priming";
+import { ReferencePriming } from "./reference-priming";
+import type { PrimingRequestView } from "../lib/relevance-status";
+import { Button } from "./ui/button";
+
+export type ReferenceUrlOption = {
+  labels: readonly string[];
+  requests: PrimingRequestView[];
+  onRequest: (input: PrimingFormInput) => Promise<void> | void;
+};
+
+type Option = "url" | "file";
+
+/**
+ * The one place an editor adds a reference. "Paste a URL" is always offered when
+ * the host can take one. "Import a file" appears only when a curation session
+ * (or the host) supplies the import transport, so without one it never renders.
+ */
+export function ReferenceAddEntry({
+  url,
+  importOptions,
+  onImported,
+}: {
+  url?: ReferenceUrlOption | null;
+  importOptions?: PrimingPanelProps | null;
+  /** Called after an import is saved, so the host can reload what depends on it. */
+  onImported?: () => void;
+}) {
+  const [chosen, setChosen] = useState<Option>("url");
+  const [fileOpened, setFileOpened] = useState(false);
+  const [saved, setSaved] = useState("");
+  if (!url && !importOptions) return null;
+
+  const option: Option = importOptions && (!url || chosen === "file") ? "file" : "url";
+  const choose = (next: Option) => {
+    setChosen(next);
+    if (next === "file") setFileOpened(true);
+  };
+
+  return (
+    <section aria-label="Add a reference" className="shrink-0 space-y-3" data-add-reference>
+      <div className="flex flex-wrap items-center justify-between gap-2">
+        <h3 className="font-semibold">Add a reference</h3>
+        {url && importOptions ? (
+          <div aria-label="How to add a reference" className="flex gap-2" role="group">
+            <Button aria-pressed={option === "url"} onClick={() => choose("url")} size="sm" type="button" variant={option === "url" ? "secondary" : "outline"}>Paste a URL</Button>
+            <Button aria-pressed={option === "file"} onClick={() => choose("file")} size="sm" type="button" variant={option === "file" ? "secondary" : "outline"}>Import a file</Button>
+          </div>
+        ) : null}
+      </div>
+      {url ? (
+        <div hidden={option !== "url"}>
+          <ReferenceCyclotronPriming labels={url.labels} onRequestPriming={url.onRequest} requests={url.requests} />
+        </div>
+      ) : null}
+      {importOptions && (fileOpened || !url) ? (
+        <div className="max-h-[55dvh] space-y-3 overflow-y-auto pr-1" hidden={option !== "file"}>
+          <ReferencePriming
+            {...importOptions}
+            onAccepted={(draft) => {
+              setSaved(`Added ${draft.rows.length} reference${draft.rows.length === 1 ? "" : "s"}.`);
+              importOptions.onAccepted?.(draft);
+              onImported?.();
+            }}
+          />
+          {saved ? <p role="status">{saved}</p> : null}
+        </div>
+      ) : null}
+    </section>
+  );
+}

package/components/reference-curation-controls.tsx

@@ -3,21 +3,31 @@
 import {useCallback,useEffect,useRef,useState} from 'react';
 import {useNewsroomCuration} from './newsroom-curation-provider';
 import {PublicationCyclotronPanel} from './publication-cyclotron-panel';
-import {ReferencePriming} from './reference-priming';
+import type {PrimingPanelProps} from 'cyclotron/components/priming-panel';
 import {Button} from './ui/button';
 import {publicationSteeringPayload,type PublicationHistory,type PublicationStatus} from '../lib/publication-cyclotron';
 import type {CurationSession} from '../lib/curation-client';
 
-export function ReferenceCurationControls({disabled=false}:{disabled?:boolean}){
+/** `refreshSignal` changes when references were just added, so the panel reloads by itself. */
+export function ReferenceCurationControls({disabled=false,refreshSignal=0}:{disabled?:boolean;refreshSignal?:number}){
   const session=useNewsroomCuration();
-  return session&&!disabled?<Controls key={session.key} session={session} disabled={disabled}/>:null;
+  return session&&!disabled?<Controls key={session.key} session={session} disabled={disabled} refreshSignal={refreshSignal}/>:null;
 }
 
-function Controls({session,disabled}:{session:CurationSession;disabled:boolean}){
+/**
+ * The import option of the Add a reference area, or null. Fail-closed: it exists
+ * only when a curation session supplies priming and the person may review.
+ */
+export function useReferenceImport(disabled=false):{panel:PrimingPanelProps;sessionKey:string}|null{
+  const session=useNewsroomCuration();
+  if(!session||disabled||!session.bootstrap.priming||!session.bootstrap.capabilities.includes('review'))return null;
+  return {sessionKey:session.key,panel:{client:session.priming,listId:session.bootstrap.priming.listId,classifiers:session.bootstrap.priming.classifiers}};
+}
+
+function Controls({session,disabled,refreshSignal}:{session:CurationSession;disabled:boolean;refreshSignal:number}){
   const [snapshot,setSnapshot]=useState<{status:PublicationStatus;history:PublicationHistory}|null>(null);
   const [error,setError]=useState('');
   const [loading,setLoading]=useState(true);
-  const [primingMessage,setPrimingMessage]=useState('');
   const [steering,setSteering]=useState<string|null>(null);
   const [rubric,setRubric]=useState('');
   const [explanation,setExplanation]=useState('');
@@ -30,14 +40,16 @@ function Controls({session,disabled}:{session:CurationSession;disabled:boolean})
   const refresh=useCallback(async()=>{
     setLoading(true);setError('');
     try{setSnapshot(await session.snapshot());}
-    catch(failure){setSnapshot(null);setError(failure instanceof Error?failure.message:'Curation status unavailable');}
+    catch(failure){setSnapshot(null);setError(failure instanceof Error?failure.message:'Suggestions are unavailable right now.');}
     finally{setLoading(false);}
   },[session]);
   useEffect(()=>{
     let active=true;
-    void session.snapshot().then(value=>{if(active){setSnapshot(value);setError('');}}).catch(failure=>{if(active){setSnapshot(null);setError(failure instanceof Error?failure.message:'Curation status unavailable');}}).finally(()=>{if(active)setLoading(false);});
+    void session.snapshot().then(value=>{if(active){setSnapshot(value);setError('');}}).catch(failure=>{if(active){setSnapshot(null);setError(failure instanceof Error?failure.message:'Suggestions are unavailable right now.');}}).finally(()=>{if(active)setLoading(false);});
     return()=>{active=false;};
   },[session]);
+  const lastSignal=useRef(refreshSignal);
+  useEffect(()=>{if(lastSignal.current!==refreshSignal){lastSignal.current=refreshSignal;void refresh();}},[refreshSignal,refresh]);
   async function steer(action:'evaluate'|'promote'){
     if(!snapshot||!steering||!session.bootstrap.bindingRef)return;
     setBusy(true);setSteeringMessage('');
@@ -49,29 +61,26 @@ function Controls({session,disabled}:{session:CurationSession;disabled:boolean})
       const receipt=await session.publication.steer(payload);
       const result=(receipt.steering as {result?:{trial_fingerprint?:string;improved?:boolean;promoted?:boolean}}|undefined)?.result;
       if(action==='evaluate')setTrial(result?.trial_fingerprint?{fingerprint:result.trial_fingerprint,improved:result.improved===true}:null);
-      setSteeringMessage(action==='promote'?'Evaluated proposal promoted.':result?.improved?'Evaluation complete: the candidate improved the measured result.':'Evaluation complete: no improvement was reported.');
+      setSteeringMessage(action==='promote'?'The tested change is now in use.':result?.improved?'Test finished: the change improved the results.':'Test finished: no improvement was found.');
       await refresh();
-    }catch(failure){setSteeringMessage(failure instanceof Error?failure.message:'Proposal outcome unavailable; check before retrying');}
+    }catch(failure){setSteeringMessage(failure instanceof Error?failure.message:'The result is unknown; check before trying again.');}
     finally{setBusy(false);}
   }
-  return <section aria-label="Publication curation" className="max-h-[55dvh] min-h-0 shrink-0 space-y-3 overflow-y-auto rounded-md border p-3" data-curation-mode={session.bootstrap.mode}>
-    <div className="flex items-center justify-between gap-3"><h3 className="font-semibold">Publication curation</h3><Button variant="outline" size="sm" disabled={loading||busy} onClick={()=>void refresh()}>Refresh curation</Button></div>
-    <p className="text-xs text-muted-foreground">{session.bootstrap.mode==='remote'?'Remote workspace':'Embedded workspace'} · {session.bootstrap.scope.publicationId}</p>
-    {loading?<p role="status">Loading publication monitoring…</p>:null}
+  return <section aria-label="Suggestions for this publication" className="max-h-[55dvh] min-h-0 shrink-0 space-y-3 overflow-y-auto rounded-md border p-3" data-curation-mode={session.bootstrap.mode}>
+    <div className="flex items-center justify-between gap-3"><h3 className="font-semibold">Suggestions for this publication</h3><Button variant="outline" size="sm" disabled={loading||busy} onClick={()=>void refresh()}>Refresh</Button></div>
+    <p className="text-xs text-muted-foreground">{session.bootstrap.mode==='remote'?'Shared review service':'This site'} · {session.bootstrap.scope.publicationId}</p>
+    {loading?<p role="status">Loading suggestions…</p>:null}
     {error?<p role="alert">{error}</p>:null}
     {snapshot?<PublicationCyclotronPanel mode={session.bootstrap.mode} status={snapshot.status} history={snapshot.history}
       onReview={canReview?async payload=>{await session.publication.review(payload);await refresh();}:undefined}
-      onSteer={canSteer&&snapshot.status.features?.steering&&session.bootstrap.bindingRef?classifier=>{setSteering(classifier);setRubric('');setExplanation('');setTrial(null);setSteeringMessage('');}:undefined}/>:null}
-    {steering?<form aria-label="Classifier proposal" className="space-y-3 rounded-md border p-3" onSubmit={event=>{event.preventDefault();void steer('evaluate');}}>
-      <h4 className="font-semibold">Evaluate classifier proposal</h4>
-      <p className="text-sm">A proposal is evaluated before an explicit promotion. Existing classifications are not relabeled by opening this form.</p>
-      <label className="block text-sm">Proposed instructions<textarea className="mt-1 block min-h-24 w-full rounded border bg-background p-2" required value={rubric} onChange={event=>{setRubric(event.target.value);setTrial(null);}}/></label>
+      onSteer={canSteer&&session.bootstrap.bindingRef?classifier=>{setSteering(classifier);setRubric('');setExplanation('');setTrial(null);setSteeringMessage('');}:undefined}/>:null}
+    {steering?<form aria-label="Rule change" className="space-y-3 rounded-md border p-3" onSubmit={event=>{event.preventDefault();void steer('evaluate');}}>
+      <h4 className="font-semibold">Test a rule change</h4>
+      <p className="text-sm">A change is tested before it is adopted. Opening this form does not change any existing suggestion.</p>
+      <label className="block text-sm">Proposed rule<textarea className="mt-1 block min-h-24 w-full rounded border bg-background p-2" required value={rubric} onChange={event=>{setRubric(event.target.value);setTrial(null);}}/></label>
       <label className="block text-sm">Why make this change?<textarea className="mt-1 block min-h-20 w-full rounded border bg-background p-2" required value={explanation} onChange={event=>setExplanation(event.target.value)}/></label>
-      <div className="flex flex-wrap gap-2"><Button type="submit" disabled={busy||!canSteer||!rubric.trim()||!explanation.trim()}>Evaluate proposal</Button><Button type="button" variant="outline" disabled={busy||!canSteer||!trial?.improved||!explanation.trim()} onClick={()=>void steer('promote')}>Promote evaluated proposal</Button><Button type="button" variant="ghost" disabled={busy} onClick={()=>setSteering(null)}>Close proposal</Button></div>
+      <div className="flex flex-wrap gap-2"><Button type="submit" disabled={busy||!canSteer||!rubric.trim()||!explanation.trim()}>Test change</Button><Button type="button" variant="outline" disabled={busy||!canSteer||!trial?.improved||!explanation.trim()} onClick={()=>void steer('promote')}>Adopt tested change</Button><Button type="button" variant="ghost" disabled={busy} onClick={()=>setSteering(null)}>Close</Button></div>
       {steeringMessage?<p role="status">{steeringMessage}</p>:null}
     </form>:null}
-    {session.bootstrap.priming&&canReview?<ReferencePriming client={session.priming} listId={session.bootstrap.priming.listId} classifiers={session.bootstrap.priming.classifiers}
-      onAccepted={draft=>{setPrimingMessage(`Accepted ${draft.rows.length} example item${draft.rows.length===1?'':'s'} for this pinned publication. Operation remains available without priming.`);void refresh();}}/>:null}
-    {primingMessage?<p role="status">{primingMessage}</p>:null}
   </section>;
 }