@anthusai/papyrus 1.0.0-next.9 → 1.1.0

package/components/priming-proof-page.tsx

@@ -0,0 +1,94 @@
+import {
+  formatProofPercentage,
+  primingProofHeadline,
+  type PrimingProofReport,
+} from "../lib/priming-proof-report";
+
+function ProofMethod({ heldOutSize, teachingSource }: { heldOutSize: number | null; teachingSource: string | null }) {
+  return (
+    <section aria-labelledby="priming-proof-method" className="space-y-2 text-sm leading-relaxed">
+      <h2 id="priming-proof-method" className="text-base font-semibold uppercase tracking-wide">How the number is made</h2>
+      <p>
+        Editors already decided which candidate sources belong in this publication. A fixed, balanced sample of those
+        decisions{heldOutSize === null ? "" : ` (${heldOutSize} sources)`} is frozen as the held-out set and never used
+        for teaching. A classifier that always gives the same answer agrees on half of it.
+      </p>
+      <p>
+        Editors teach the classifier with labels: their other reviews of candidate sources, and sources they paste,
+        check after Papyrus extracts them, and mark publish or reject.
+        {teachingSource === null ? "" : ` This run taught from ${teachingSource}.`} Each point below starts a fresh
+        classifier that sees only the first N of those labels, then decides
+        every held-out source once. Nothing else changes between points: the same decision model, the publication&apos;s
+        mission and policies as the only rubric, and no automatic rubric rewriting.
+      </p>
+    </section>
+  );
+}
+
+export function PrimingProofPage({ report }: { report: PrimingProofReport | null }) {
+  if (report === null) {
+    return (
+      <main className="mx-auto max-w-3xl space-y-6 px-4 py-10" data-priming-proof="pending">
+        <header className="space-y-2 border-b pb-4">
+          <h1 className="text-3xl font-bold">Does teaching the classifier work?</h1>
+          <p className="text-muted-foreground">No approved proof run has been published for this publication yet.</p>
+        </header>
+        <ProofMethod heldOutSize={null} teachingSource={null} />
+      </main>
+    );
+  }
+  const { baseline, latest, agreementChangeInPoints } = primingProofHeadline(report);
+  const [positiveLabel, negativeLabel] = [report.positiveLabel, report.labels.find((label) => label !== report.positiveLabel)];
+  return (
+    <main className="mx-auto max-w-3xl space-y-8 px-4 py-10" data-priming-proof="published">
+      <header className="space-y-3 border-b pb-4">
+        <h1 className="text-3xl font-bold">Does teaching the classifier work?</h1>
+        <p className="text-lg" data-priming-proof-headline>
+          Agreement with editors went from <strong>{formatProofPercentage(baseline.agreement)}</strong> with no labels to{" "}
+          <strong>{formatProofPercentage(latest.agreement)}</strong> after {latest.labels} labels
+          {agreementChangeInPoints === null ? "" : ` (${agreementChangeInPoints >= 0 ? "+" : ""}${agreementChangeInPoints} points)`}.
+        </p>
+        <p className="text-sm text-muted-foreground">
+          {report.publication} · question: “{report.question}” · held-out set of {report.heldOut.size} sources frozen{" "}
+          {report.heldOut.frozenAt.slice(0, 10)} · run {report.ranAt.slice(0, 10)}
+          {report.decisionModel ? ` · decision model ${report.decisionModel}` : ""}
+        </p>
+      </header>
+      <section aria-labelledby="priming-proof-points" className="space-y-2">
+        <h2 id="priming-proof-points" className="text-base font-semibold uppercase tracking-wide">Before and after</h2>
+        <div className="overflow-x-auto">
+          <table className="w-full text-left text-sm tabular-nums">
+            <thead>
+              <tr className="border-b">
+                <th scope="col" className="py-2 pr-4">Editor labels</th>
+                <th scope="col" className="py-2 pr-4">Agreement</th>
+                <th scope="col" className="py-2 pr-4">Precision ({positiveLabel})</th>
+                <th scope="col" className="py-2 pr-4">Recall ({positiveLabel})</th>
+                <th scope="col" className="py-2">Labels used</th>
+              </tr>
+            </thead>
+            <tbody>
+              {report.points.map((point) => (
+                <tr key={point.labels} className="border-b" data-priming-proof-point={point.labels}>
+                  <td className="py-2 pr-4">{point.labels}</td>
+                  <td className="py-2 pr-4">{formatProofPercentage(point.agreement)}</td>
+                  <td className="py-2 pr-4">{formatProofPercentage(point.precision)}</td>
+                  <td className="py-2 pr-4">{formatProofPercentage(point.recall)}</td>
+                  <td className="py-2">
+                    {point.labelsByClass[positiveLabel] ?? 0} {positiveLabel}
+                    {negativeLabel ? `, ${point.labelsByClass[negativeLabel] ?? 0} ${negativeLabel}` : ""}
+                  </td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      </section>
+      <ProofMethod heldOutSize={report.heldOut.size} teachingSource={report.priming.source} />
+      <p className="break-all text-xs text-muted-foreground">
+        Held-out fingerprint {report.heldOut.fingerprint}
+        {report.priming.fingerprint ? ` · labels fingerprint ${report.priming.fingerprint}` : ""}
+      </p>
+    </main>
+  );
+}

package/components/publication-cyclotron-panel.tsx

@@ -0,0 +1,57 @@
+'use client';
+
+import {useRef,useState} from 'react';
+import {ReviewControl,type ReviewControlReview} from 'cyclotron/components/review-control';
+import {CyclotronStatusView} from 'cyclotron/components/cyclotron-status';
+import {assertPublicationScope,publicationScopeKey,publicationReviewPayload,type PublicationStatus,type PublicationHistory,type PublicationHistoryRow,type PublicationReviewPayload} from '../lib/publication-cyclotron';
+
+function requestId(){
+ const bytes=crypto.getRandomValues(new Uint8Array(16));
+ return Array.from(bytes,value=>value.toString(16).padStart(2,'0')).join('');
+}
+
+/** Data-only shared operator panel. The authorized host owns reads, writes and refresh. */
+type PublicationPanelProps={mode:'embedded'|'remote';status:PublicationStatus;history:PublicationHistory;onReview?:(payload:PublicationReviewPayload)=>Promise<void>;onSteer?:(classifier:string)=>void};
+export function PublicationCyclotronPanel(props:PublicationPanelProps){
+ assertPublicationScope(props.status,props.history);
+ // Remount all drafts, retry identities, pending messages and busy state on scope change.
+ return <PublicationControls key={publicationScopeKey(props.status)} {...props}/>;
+}
+function PublicationControls({mode,status,history,onReview,onSteer}:PublicationPanelProps){
+ assertPublicationScope(status,history);
+ const context=publicationScopeKey(status);const current=useRef(context);current.current=context;
+ const [message,setMessage]=useState<{context:string;key:string;error:boolean;text:string}|null>(null);const [busy,setBusy]=useState<string|null>(null);
+ const [editing,setEditing]=useState<Record<string,boolean>>({});const requests=useRef<Record<string,{signature:string;id:string}>>({});
+ async function submit(row:PublicationHistoryRow,classifier:string,review:ReviewControlReview){
+  const key=`${context}:${row.decision.decisionId}:${classifier}:${row.context?.contextId??'legacy'}`;
+  try{
+   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');
+   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.'});}
+  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>
+  {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}
+   {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>
+     <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}
+     <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>
+    </article>;
+   })}
+  </section>)}
+ </section>;
+}

package/components/reader-auth-control.tsx

@@ -2,7 +2,7 @@
 
 import { signInWithRedirect, signOut } from "aws-amplify/auth";
 import { Hub } from "aws-amplify/utils";
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useState, type ReactNode } from "react";
 import { configureAmplifyClient } from "./amplify-client-provider";
 import { loadReaderSessionSnapshot, type ReaderAuthSnapshot } from "./reader-auth-state";
 
@@ -12,6 +12,7 @@ type ReaderAuthControlProps = {
   postAuthPath?: string;
   showIdentity?: boolean;
   authState?: ReaderAuthSnapshot;
+  renderAction?: (action: { disabled: boolean; onClick: () => void; signedIn: boolean }) => ReactNode;
 };
 
 const POST_AUTH_PATH_KEY = "papyrus:reader-auth:post-auth-path";
@@ -22,6 +23,7 @@ export function ReaderAuthControl({
   postAuthPath,
   showIdentity = false,
   authState: externalAuthState,
+  renderAction,
 }: ReaderAuthControlProps) {
   const [authState, setAuthState] = useState<ReaderAuthSnapshot>(externalAuthState ?? { status: "loading", label: "Checking sign-in" });
   const [busy, setBusy] = useState(false);
@@ -124,19 +126,20 @@ export function ReaderAuthControl({
 
   const signedIn = authState.status === "signedIn";
   const actionLabel = signedIn ? "LOGOUT" : "LOGIN";
+  const Container = renderAction ? "div" : "span";
   return (
-    <span className={className ? `reader-auth ${className}` : "reader-auth"} aria-live="polite" data-footer-utility={dataFooterUtility}>
+    <Container className={className ? `reader-auth ${className}` : "reader-auth"} aria-live="polite" data-footer-utility={dataFooterUtility}>
       {signedIn && showIdentity ? <span className="reader-auth__identity">{authState.label}</span> : null}
       {error ? <span className="reader-auth__error">{error}</span> : null}
-      <button
+      {renderAction ? renderAction({ disabled: authState.status === "loading" || busy, onClick: signedIn ? signOutCurrentUser : signIn, signedIn }) : <button
         className="reader-auth__button"
         disabled={authState.status === "loading" || busy}
         onClick={signedIn ? signOutCurrentUser : signIn}
         type="button"
       >
         {actionLabel}
-      </button>
-    </span>
+      </button>}
+    </Container>
   );
 }
 

package/components/reference-curation-controls.tsx

@@ -0,0 +1,77 @@
+'use client';
+
+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 {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}){
+  const session=useNewsroomCuration();
+  return session&&!disabled?<Controls key={session.key} session={session} disabled={disabled}/>:null;
+}
+
+function Controls({session,disabled}:{session:CurationSession;disabled:boolean}){
+  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('');
+  const [busy,setBusy]=useState(false);
+  const [trial,setTrial]=useState<{fingerprint:string;improved:boolean}|null>(null);
+  const [steeringMessage,setSteeringMessage]=useState('');
+  const steeringRequests=useRef<Record<string,string>>({});
+  const canReview=!disabled&&session.bootstrap.capabilities.includes('review');
+  const canSteer=!disabled&&session.bootstrap.capabilities.includes('steer');
+  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');}
+    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);});
+    return()=>{active=false;};
+  },[session]);
+  async function steer(action:'evaluate'|'promote'){
+    if(!snapshot||!steering||!session.bootstrap.bindingRef)return;
+    setBusy(true);setSteeringMessage('');
+    try{
+      const identity=JSON.stringify([action,steering,rubric.trim(),explanation.trim(),trial?.fingerprint??'',snapshot.status.classifiers[steering].cyclotron.fingerprint]);
+      const requestId=steeringRequests.current[identity]??=crypto.randomUUID();
+      const command=action==='evaluate'?{action,proposal:{rubric:rubric.trim()},explanation,requestId} as const:{action,trialFingerprint:trial?.fingerprint??'',explanation,requestId} as const;
+      const payload=publicationSteeringPayload(snapshot.status,steering,session.bootstrap.bindingRef,command);
+      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.');
+      await refresh();
+    }catch(failure){setSteeringMessage(failure instanceof Error?failure.message:'Proposal outcome unavailable; check before retrying');}
+    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}
+    {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>
+      <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>
+      {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>;
+}

package/components/reference-cyclotron-status.tsx

@@ -0,0 +1,109 @@
+"use client";
+
+import { useState } from "react";
+import { CyclotronStatusView } from "cyclotron/components/cyclotron-status";
+import type { CyclotronStatus } from "cyclotron/cyclotron-status";
+
+const RATE_CHOICES = [1, 0.5, 0.25, 0.1, 0];
+const DAY_CHOICES = [1, 7, 14, 30];
+
+export type ReviewRateChoice = { rate: number; days: number } | { clear: true };
+
+/**
+ * The relevance cyclotron's status above the References list: a strip, the
+ * detail card on demand, and, for editors who may change it, a form that asks
+ * the next sweep for a manual review rate.
+ */
+export function ReferenceCyclotronStatus({
+  onRequestRate,
+  status,
+  staleAfterHours = 24,
+  now = new Date(),
+}: {
+  onRequestRate?: (choice: ReviewRateChoice) => Promise<void> | void;
+  status: CyclotronStatus;
+  staleAfterHours?: number;
+  now?: Date;
+}) {
+  const [open, setOpen] = useState(false);
+  const [rate, setRate] = useState(0.5);
+  const [days, setDays] = useState(7);
+  const [message, setMessage] = useState<string | null>(null);
+  const ageHours = Math.max(0, (now.getTime() - Date.parse(status.asOf)) / 3_600_000);
+  const stale = Number.isFinite(ageHours) && ageHours > staleAfterHours;
+  const override = status.reviewRate.override;
+
+  async function submit(choice: ReviewRateChoice) {
+    if (!onRequestRate) return;
+    setMessage("Sending…");
+    try {
+      await onRequestRate(choice);
+      setMessage("The next sweep applies it and the status will show who set it.");
+    } catch (error) {
+      setMessage(error instanceof Error ? error.message : String(error));
+    }
+  }
+
+  return (
+    <section aria-label="Relevance cyclotron" className="space-y-2" data-reference-cyclotron-status>
+      <CyclotronStatusView status={status} />
+      {stale ? (
+        <p className="text-xs text-muted-foreground" data-reference-cyclotron-status-stale>
+          <span aria-hidden="true">⚠ </span>
+          Snapshot from {Math.round(ageHours)} hours ago; the next sweep refreshes it.
+        </p>
+      ) : null}
+      <button
+        aria-expanded={open}
+        className="text-xs text-muted-foreground underline underline-offset-4"
+        onClick={() => setOpen((value) => !value)}
+        type="button"
+      >
+        {open ? "Hide what the cyclotron is doing" : "What the cyclotron is doing"}
+      </button>
+      {open ? (
+        <div className="space-y-3">
+          <CyclotronStatusView classifierName="Relevant to this publication" status={status} variant="card" />
+          {onRequestRate ? (
+            <form
+              aria-label="Manual review rate"
+              className="flex flex-wrap items-end gap-3 text-sm"
+              data-reference-review-rate-form
+              onSubmit={(event) => {
+                event.preventDefault();
+                void submit({ rate, days });
+              }}
+            >
+              <label className="flex flex-col gap-1">
+                <span className="text-xs text-muted-foreground">Review rate for confident decisions</span>
+                <select aria-label="Manual review rate" onChange={(event) => setRate(Number(event.target.value))} value={rate}>
+                  {RATE_CHOICES.map((choice) => (
+                    <option key={choice} value={choice}>{Math.round(choice * 100)}%</option>
+                  ))}
+                </select>
+              </label>
+              <label className="flex flex-col gap-1">
+                <span className="text-xs text-muted-foreground">For</span>
+                <select aria-label="How long the manual rate lasts" onChange={(event) => setDays(Number(event.target.value))} value={days}>
+                  {DAY_CHOICES.map((choice) => (
+                    <option key={choice} value={choice}>{choice} day{choice === 1 ? "" : "s"}</option>
+                  ))}
+                </select>
+              </label>
+              <button className="cyclotron-review-secondary" type="submit">Set manual rate</button>
+              {override ? (
+                <button className="cyclotron-review-secondary" onClick={() => void submit({ clear: true })} type="button">
+                  Clear manual rate
+                </button>
+              ) : null}
+              <p className="basis-full text-xs text-muted-foreground">
+                Low-confidence decisions and the random audit share are always reviewed.
+              </p>
+              {message ? <p className="basis-full text-xs" role="status">{message}</p> : null}
+            </form>
+          ) : null}
+        </div>
+      ) : null}
+    </section>
+  );
+}

package/components/reference-priming.tsx

@@ -0,0 +1,18 @@
+"use client";
+
+import { useState } from "react";
+import { PrimingPanel, type PrimingPanelProps } from "cyclotron/components/priming-panel";
+import { Button } from "./ui/button";
+
+/** Papyrus supplies its transport/configuration; Cyclotron owns preview and labels. */
+export function ReferencePriming(props: PrimingPanelProps) {
+  const [open, setOpen] = useState(false);
+  return (
+    <section className="shrink-0 space-y-3" aria-label="Representative reference examples">
+      <Button aria-expanded={open} onClick={() => setOpen((value) => !value)} variant="outline">
+        {open ? "Hide example priming" : "Curate reference examples (optional)"}
+      </Button>
+      {open ? <div className="max-h-[55dvh] space-y-3 overflow-y-auto pr-1"><p className="text-sm text-muted-foreground">Corrections to extracted content: describe what needs fixing, then enter the corrected title and abstract or summary. The note is saved with your correction; it does not automatically regenerate the content. Choose Publish / Not publish separately. An explanation of that judgment is optional.</p><PrimingPanel {...props} renderItem={props.renderItem ?? ((item) => <div className="space-y-2"><p className="whitespace-pre-wrap text-sm">{String(item.values.abstract ?? item.values.text ?? "")}</p><p className="break-all text-xs text-muted-foreground">{String(item.values.source_uri ?? "")}</p></div>)} /></div> : null}
+    </section>
+  );
+}

package/components/reference-relevance-review.tsx

@@ -0,0 +1,75 @@
+"use client";
+
+import { useState } from "react";
+import { ReviewControl, type ReviewReason } from "cyclotron/components/review-control";
+import { isScopeTrainingNegativeReason, REFERENCE_REJECTION_REASON_CODES } from "../lib/reference-policy";
+import {
+  curationForRelevanceReview,
+  type RelevanceCuration,
+  type RelevanceDecisionView,
+} from "../lib/relevance-decisions";
+
+/**
+ * Papyrus's existing rejection reasons, unchanged. Reasons that are not about
+ * relevance (a duplicate, an unavailable source) close the review without
+ * teaching the cyclotron.
+ */
+export const RELEVANCE_REVIEW_REASONS: ReviewReason[] = REFERENCE_REJECTION_REASON_CODES.map((code) => ({
+  code,
+  text: code.charAt(0).toUpperCase() + code.slice(1).replaceAll("_", " "),
+  ...(isScopeTrainingNegativeReason(code) ? {} : { noLabel: true }),
+}));
+
+export function ReferenceRelevanceReview({
+  disabled,
+  decision,
+  onCurate,
+  referenceLineageId,
+}: {
+  disabled?: boolean;
+  decision: RelevanceDecisionView;
+  onCurate: (curation: RelevanceCuration) => void;
+  referenceLineageId: string;
+}) {
+  const [shareable, setShareable] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const classes = decision.classes.length ? decision.classes : [decision.label];
+  return (
+    <section aria-label="Relevance review" className="space-y-2" data-reference-relevance-review={referenceLineageId}>
+      <ReviewControl
+        decision={{
+          decisionId: decision.decisionId,
+          label: decision.label,
+          confidence: decision.confidence,
+          classes,
+          version: decision.version ?? undefined,
+        }}
+        disabled={disabled}
+        itemId={referenceLineageId}
+        mode={decision.reviewControl === "thumbs" && classes.length === 2 ? "thumbs" : "labels"}
+        onReview={(review) => {
+          try {
+            setError(null);
+            onCurate(curationForRelevanceReview(decision, { ...review, shareable }));
+          } catch (failure) {
+            setError(failure instanceof Error ? failure.message : String(failure));
+          }
+        }}
+        positiveLabel={decision.positiveLabel ?? undefined}
+        question={decision.question ?? undefined}
+        reasons={RELEVANCE_REVIEW_REASONS}
+        reviewReason={decision.reviewRecommended ? decision.reviewDetail ?? undefined : undefined}
+      />
+      <label className="flex items-center gap-2 text-xs text-muted-foreground">
+        <input
+          checked={shareable}
+          disabled={disabled}
+          onChange={(event) => setShareable(event.target.checked)}
+          type="checkbox"
+        />
+        My explanation may be quoted publicly (for the Cyclotron example page)
+      </label>
+      {error ? <p className="text-xs text-destructive" role="alert">{error}</p> : null}
+    </section>
+  );
+}

package/components/settings-page.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import { toPublicReaderPath } from "../lib/reader-base-path";
 import { signOut } from "aws-amplify/auth";
 import Link from "next/link";
 import { useCallback, useEffect, useRef, useState } from "react";
@@ -114,7 +115,7 @@ export function SettingsPage() {
   return (
     <main className="settings-page">
       <nav className="edition-progress edition-progress--newsroom settings-progress" aria-label="Settings navigation">
-        <Link className="edition-progress__button edition-progress__button--previous" href="/">
+        <Link className="edition-progress__button edition-progress__button--previous" href={toPublicReaderPath("/")}>
           <svg aria-hidden="true" className="edition-progress__icon" focusable="false" viewBox="0 0 10 10">
             <path d="M7.5 1 2.5 5 7.5 9Z" fill="currentColor" />
           </svg>

package/components/signup-entries-panel.tsx

@@ -0,0 +1,94 @@
+"use client";
+
+import { generateClient } from "aws-amplify/data";
+import amplifyOutputs from "papyrus-amplify-outputs";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { signupForms, type PluginOutputs } from "../lib/plugin-settings";
+import { signupEntriesToCsv, type SignupEntryRecord } from "../lib/signup-csv";
+
+const LIST_QUERY = `query ListSignupEntries($form: String!, $nextToken: String) {
+  listSignupEntriesByFormAndSubmittedAt(form: $form, sortDirection: DESC, limit: 200, nextToken: $nextToken) {
+    items { id form value submittedAt }
+    nextToken
+  }
+}`;
+
+type ListResult = { data?: { listSignupEntriesByFormAndSubmittedAt?: { items: SignupEntryRecord[]; nextToken?: string | null } }; errors?: { message?: string }[] };
+
+async function loadAllEntries(form: string): Promise<SignupEntryRecord[]> {
+  const client = generateClient({ authMode: "userPool" });
+  const entries: SignupEntryRecord[] = [];
+  let nextToken: string | null | undefined;
+  do {
+    const result = (await client.graphql({ query: LIST_QUERY, variables: { form, nextToken } })) as ListResult;
+    if (result.errors?.length) throw new Error(result.errors[0]?.message ?? "Could not load signups.");
+    const page = result.data?.listSignupEntriesByFormAndSubmittedAt;
+    entries.push(...(page?.items ?? []));
+    nextToken = page?.nextToken;
+  } while (nextToken);
+  return entries;
+}
+
+export function SignupEntriesPanel() {
+  const forms = useMemo(() => signupForms(amplifyOutputs as PluginOutputs), []);
+  const [form, setForm] = useState(forms[0] ?? "");
+  const [entries, setEntries] = useState<SignupEntryRecord[] | null>(null);
+  const [problem, setProblem] = useState<string | null>(null);
+
+  const refresh = useCallback(async () => {
+    if (!form) return;
+    setEntries(null);
+    setProblem(null);
+    try {
+      setEntries(await loadAllEntries(form));
+    } catch (error) {
+      setProblem(error instanceof Error ? error.message : "Could not load signups.");
+    }
+  }, [form]);
+
+  useEffect(() => {
+    void refresh();
+  }, [refresh]);
+
+  const exportCsv = () => {
+    if (!entries) return;
+    const url = URL.createObjectURL(new Blob([signupEntriesToCsv(entries)], { type: "text/csv;charset=utf-8" }));
+    const link = document.createElement("a");
+    link.href = url;
+    link.download = `signups-${form}.csv`;
+    link.click();
+    URL.revokeObjectURL(url);
+  };
+
+  return (
+    <section aria-labelledby="newsroom-signups-title" data-news-desk-admin-panel="signups">
+      <h3 id="newsroom-signups-title">Signups</h3>
+      <p>Addresses people entered in the site&apos;s signup forms. Only editors and admins can see them.</p>
+      <label>
+        Form{" "}
+        <select value={form} onChange={(event) => setForm(event.target.value)} disabled={forms.length < 2}>
+          {forms.map((name) => (
+            <option key={name} value={name}>{name}</option>
+          ))}
+        </select>
+      </label>{" "}
+      <button type="button" onClick={() => void refresh()}>Refresh</button>{" "}
+      <button type="button" onClick={exportCsv} disabled={!entries || entries.length === 0}>Export CSV</button>
+      <p role="status" aria-live="polite">
+        {problem ? `Error: ${problem}` : entries === null ? "Loading..." : `${entries.length} ${entries.length === 1 ? "entry" : "entries"}`}
+      </p>
+      {entries && entries.length > 0 ? (
+        <table>
+          <thead>
+            <tr><th scope="col">Submitted</th><th scope="col">Address</th></tr>
+          </thead>
+          <tbody>
+            {entries.map((entry) => (
+              <tr key={entry.id}><td>{entry.submittedAt}</td><td>{entry.value}</td></tr>
+            ))}
+          </tbody>
+        </table>
+      ) : null}
+    </section>
+  );
+}