@anthusai/papyrus 2.0.0-next.4 → 2.0.0-next.41

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>;
 }

package/components/reference-cyclotron-priming.tsx

@@ -1,12 +1,12 @@
 "use client";
 
-import { useState } from "react";
+import { useId, useRef, useState, type KeyboardEvent } from "react";
 import { primingStateText, type PrimingRequestView } from "../lib/relevance-status";
 
 export type PrimingFormInput = { url: string; label: string; explanation: string };
 
 /**
- * A compact "Add a reference" form for a pasted URL. The page is read in the
+ * The "Paste a URL" option of the Add a reference area. The page is read in the
  * background and the outcome is shown beside each added reference.
  */
 export function ReferenceCyclotronPriming({
@@ -23,6 +23,19 @@ export function ReferenceCyclotronPriming({
   const [explanation, setExplanation] = useState("");
   const [message, setMessage] = useState<string | null>(null);
 
+  const ratingLabelId = useId();
+  const buttons = useRef<Array<HTMLButtonElement | null>>([]);
+
+  function moveSelection(event: KeyboardEvent<HTMLButtonElement>, index: number) {
+    const forward = event.key === "ArrowRight" || event.key === "ArrowDown";
+    const backward = event.key === "ArrowLeft" || event.key === "ArrowUp";
+    if (!forward && !backward) return;
+    event.preventDefault();
+    const next = (index + (forward ? 1 : -1) + labels.length) % labels.length;
+    setLabel(labels[next]);
+    buttons.current[next]?.focus();
+  }
+
   async function submit() {
     setMessage("Adding…");
     try {
@@ -36,16 +49,16 @@ export function ReferenceCyclotronPriming({
   }
 
   return (
-    <section aria-label="Add a reference" className="space-y-2 text-sm" data-reference-cyclotron-priming>
+    <div className="space-y-2 text-sm" data-reference-cyclotron-priming>
       <form
-        className="flex flex-wrap items-end gap-3"
+        className="flex flex-col gap-3"
         onSubmit={(event) => {
           event.preventDefault();
           void submit();
         }}
       >
-        <label className="flex min-w-64 flex-1 flex-col gap-1">
-          <span className="text-xs text-muted-foreground">Add a reference by URL</span>
+        <label className="flex flex-col gap-1">
+          <span className="text-xs text-muted-foreground">Web page address</span>
           <input
             aria-label="Reference URL"
             onChange={(event) => setUrl(event.target.value)}
@@ -55,20 +68,46 @@ export function ReferenceCyclotronPriming({
             value={url}
           />
         </label>
+        <div className="flex flex-col gap-1">
+          <span className="text-xs text-muted-foreground" id={ratingLabelId}>Should Papyrus include or exclude pages like this?</span>
+          <div aria-labelledby={ratingLabelId} className="flex flex-wrap gap-2" role="radiogroup">
+            {labels.map((choice, index) => {
+              const checked = choice === label;
+              return (
+                <button
+                  aria-checked={checked}
+                  className={`min-w-32 flex-1 rounded border px-4 py-3 text-base font-semibold capitalize ${checked ? "border-foreground bg-foreground text-background" : "border-border bg-transparent"}`}
+                  data-rating-choice={choice}
+                  key={choice}
+                  onClick={() => setLabel(choice)}
+                  onKeyDown={(event) => moveSelection(event, index)}
+                  ref={(node) => { buttons.current[index] = node; }}
+                  role="radio"
+                  tabIndex={checked || (!labels.includes(label) && index === 0) ? 0 : -1}
+                  type="button"
+                >
+                  {choice}
+                </button>
+              );
+            })}
+          </div>
+        </div>
         <label className="flex flex-col gap-1">
-          <span className="text-xs text-muted-foreground">Include or exclude</span>
-          <select aria-label="Include or exclude" onChange={(event) => setLabel(event.target.value)} value={label}>
-            {labels.map((choice) => (
-              <option key={choice} value={choice}>{choice}</option>
-            ))}
-          </select>
-        </label>
-        <label className="flex min-w-48 flex-1 flex-col gap-1">
-          <span className="text-xs text-muted-foreground">Why (optional)</span>
-          <input aria-label="Reason" onChange={(event) => setExplanation(event.target.value)} type="text" value={explanation} />
+          <span className="text-sm font-medium">Why?</span>
+          <textarea
+            aria-label="Reason"
+            className="w-full"
+            onChange={(event) => setExplanation(event.target.value)}
+            placeholder="Why? A sentence or two helps Papyrus learn what you want."
+            rows={4}
+            value={explanation}
+          />
+          <span className="text-xs text-muted-foreground">Optional, but a short reason helps Papyrus learn what you want.</span>
         </label>
-        <button className="cyclotron-review-secondary" type="submit">Add reference</button>
-        {message ? <p className="basis-full text-xs" role="status">{message}</p> : null}
+        <div>
+          <button className="cyclotron-review-secondary" type="submit">Add reference</button>
+        </div>
+        {message ? <p className="text-xs" role="status">{message}</p> : null}
       </form>
       {requests.length ? (
         <ul aria-label="Added references" className="space-y-1 text-xs text-muted-foreground">
@@ -79,6 +118,6 @@ export function ReferenceCyclotronPriming({
           ))}
         </ul>
       ) : null}
-    </section>
+    </div>
   );
 }

package/components/reference-cyclotron-suggestion.tsx

@@ -60,7 +60,7 @@ export function ReferenceSuggestionBlock({
     <section aria-label="Suggestion" className="space-y-2 border-y border-foreground py-3" data-reference-suggestion={referenceLineageId}>
       <h3 className="text-xs font-semibold uppercase tracking-wide text-foreground">Suggestion</h3>
       <p className="text-sm text-foreground">
-        The cyclotron suggests <span className="font-semibold">{decision.label}</span> ({suggestionConfidenceWords(decision)}).
+        Papyrus suggests <span className="font-semibold">{decision.label}</span> ({suggestionConfidenceWords(decision)}).
       </p>
       <p className="text-xs text-foreground" data-reference-suggestion-notice>
         A suggestion never changes the status until an editor acts. This reference is {statusLabel.toLowerCase()}.

package/components/reference-priming.tsx

@@ -1,18 +1,22 @@
 "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. */
+/**
+ * The "Import a file" option of the Add a reference area. Papyrus supplies the
+ * transport and configuration; Cyclotron owns the preview and label controls.
+ * It is only rendered by `ReferenceAddEntry`, never as a section of its own.
+ */
 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 references" : "Add example references (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>
+    <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>
+      ))}
+    />
   );
 }

package/components/reference-section-suggestion.tsx

@@ -40,7 +40,7 @@ export function SectionSuggestionBlock({
     <section aria-label="Suggested Section" className="space-y-2 border-y border-foreground py-3" data-reference-section-suggestion={referenceLineageId}>
       <h3 className="text-xs font-semibold uppercase tracking-wide text-foreground">Suggested Section</h3>
       <p className="text-sm text-foreground">
-        The cyclotron suggests <span className="font-semibold">{titleOf(sections, suggestion.sectionId)}</span>
+        Papyrus suggests <span className="font-semibold">{titleOf(sections, suggestion.sectionId)}</span>
         {suggestion.confidence !== null ? ` (${formatPercentage(suggestion.confidence)})` : ""}.
       </p>
       {others.length ? (

package/components/topic-steering-workspace.tsx

@@ -13,6 +13,8 @@ import { usePathname, useRouter } from "next/navigation";
 import type { ReactNode, RefObject } from "react";
 import { useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useTransition } from "react";
 import amplifyOutputs from "papyrus-amplify-outputs";
+import { EditorialChecksAdminPanel } from "./editorial-checks-admin-panel";
+import { MonitoringPanel } from "./monitoring-panel";
 import { SignupEntriesPanel } from "./signup-entries-panel";
 import { pluginSettings, type PluginOutputs } from "../lib/plugin-settings";
 import { generateClient } from "aws-amplify/data";
@@ -88,6 +90,7 @@ import { ReferenceSourcePreview } from "./reference-source-preview";
 import type { ReaderAuthSnapshot } from "./reader-auth-state";
 import { NewsDeskAccessGate } from "./newsroom-access-gate";
 import { NewsroomOpsOverview } from "./newsroom-ops-overview";
+import { NewsroomCurationBootstrap } from "./newsroom-curation-bootstrap";
 import { NewsroomReferencesView } from "./newsroom-references-view";
 import { NewsroomAssignmentsView } from "./newsroom-assignments-view";
 import { NewsroomTopicsView } from "./newsroom-topics-view";
@@ -246,7 +249,7 @@ type AssignmentAction = "claim" | "release" | "complete" | "cancel" | "reopen" |
 type ReportingPacketReviewDecision = "select" | "merge" | "brief" | "hold" | "kill";
 type AssignmentDeskViewMode = "queue" | "budget";
 type UserRoleAction = "grant" | "revoke";
-type AdministrationPanel = "users" | "policies" | "sections" | "procedures" | "delegations" | "signups";
+type AdministrationPanel = "users" | "policies" | "sections" | "procedures" | "delegations" | "signups" | "editorial-checks" | "monitoring";
 export type NewsDeskTab = "overview" | "desks" | "topics" | "concepts" | "references" | "messages" | "assignments" | "administration" | "search";
 type LexicalRuleScope = "publication" | "corpus" | "classifier" | "category";
 type AnalysisReindexMode = "online-update" | "classifier-retrain" | "scoped-topic-rebuild" | "entity-graph-rebuild" | "generated-analysis-rebuild";
@@ -3114,6 +3117,7 @@ function NewsDeskDashboard({
           />
         ) : null}
         {activeTab === "references" ? (
+          <NewsroomCurationBootstrap enabled={!dashboard.isDemo}>
           <NewsroomReferencesView
             demo={Boolean(dashboard.isDemo)}
             disabled={controlsDisabled}
@@ -3151,6 +3155,7 @@ function NewsDeskDashboard({
             referenceAttachments={referenceAttachments}
             references={references}
           />
+          </NewsroomCurationBootstrap>
         ) : null}
         {activeTab === "messages" ? (
           <MessagesDeskView
@@ -4317,6 +4322,24 @@ function AdministrationDeskView({
                 <strong>Agent delegations</strong>
                 <span>Let an agent curate References for you</span>
               </Link>
+              <Link
+                href={administrationPanelHref("editorial-checks", isDemo)}
+                data-news-desk-admin-nav="editorial-checks"
+                data-active={administrationPanel === "editorial-checks" || undefined}
+                onClick={() => onPanelChange("editorial-checks")}
+              >
+                <strong>Editorial checks</strong>
+                <span>Policies the article editor checks drafts against</span>
+              </Link>
+              <Link
+                href={administrationPanelHref("monitoring", isDemo)}
+                data-news-desk-admin-nav="monitoring"
+                data-active={administrationPanel === "monitoring" || undefined}
+                onClick={() => onPanelChange("monitoring")}
+              >
+                <strong>Monitoring</strong>
+                <span>The automated research pipeline, read only</span>
+              </Link>
               {signupPluginEnabled() ? (
                 <Link
                   href={administrationPanelHref("signups", isDemo)}
@@ -4331,6 +4354,8 @@ function AdministrationDeskView({
             </nav>}
             <div className="news-desk-settings-panel">
               {administrationPanel === "signups" ? <SignupEntriesPanel /> : null}
+              {administrationPanel === "editorial-checks" ? <EditorialChecksAdminPanel /> : null}
+              {administrationPanel === "monitoring" ? <MonitoringPanel isAdmin={canManageUsers} isDemo={isDemo} /> : null}
               {administrationPanel === "delegations" ? <AdministrationDelegationsPanel disabled={disabled} /> : null}
               {administrationPanel === "users" ? (
                 <AdministrationUsersPanel
@@ -12795,7 +12820,7 @@ function signupPluginEnabled(): boolean {
 }
 
 function normalizeAdministrationPanel(value: string | null | undefined): AdministrationPanel {
-  if (value === "policies" || value === "sections" || value === "procedures" || value === "delegations") return value;
+  if (value === "policies" || value === "sections" || value === "procedures" || value === "delegations" || value === "editorial-checks" || value === "monitoring") return value;
   if (value === "signups" && signupPluginEnabled()) return value;
   return "users";
 }

package/components/use-editorial-checks.ts

@@ -0,0 +1,133 @@
+"use client";
+
+import { useCallback, useEffect, useRef, useState } from "react";
+import {
+  feedbackFor,
+  publishWarnings,
+  type EditorialCheckResult,
+  type EditorialFinding,
+  type FeedbackDecision,
+  type RewriteResult,
+  type Span,
+} from "../lib/editorial-checks";
+import type { EditorialChecksBackend } from "../lib/editorial-checks-backend";
+import { DEFAULT_EDITORIAL_SETTINGS, type EditorialSettings } from "../lib/editorial-checks-settings";
+import type { CheckStatus } from "./editorial-findings-panel";
+
+const CHECK_PAUSE_MS = 2000;
+
+/**
+ * Editorial checks for one article body. A result only applies to the exact body
+ * it was computed for: if the editor typed while the check ran, the result is
+ * dropped and the next pause checks again.
+ */
+export function useEditorialChecks({
+  backend,
+  body,
+  section,
+  itemId,
+}: {
+  /** null when there is no backend to check against (a preview). Whether a publication runs checks is its stored setting. */
+  backend: EditorialChecksBackend | null;
+  body: string | null;
+  section: string;
+  itemId: string | null;
+}) {
+  const available = backend !== null;
+  const [settings, setSettings] = useState<EditorialSettings>(DEFAULT_EDITORIAL_SETTINGS);
+  const [settingsLoaded, setSettingsLoaded] = useState(false);
+  const enabled = available && settings.enabled;
+  const [result, setResult] = useState<EditorialCheckResult | null>(null);
+  const [checkedBody, setCheckedBody] = useState<string | null>(null);
+  const [status, setStatus] = useState<CheckStatus>({ state: "idle" });
+  const [dismissed, setDismissed] = useState<Set<string>>(() => new Set());
+  const [activeFindingId, setActiveFindingId] = useState<string | null>(null);
+  const [selection, setSelection] = useState<Span>({ start: 0, end: 0 });
+  const latestBody = useRef(body);
+  latestBody.current = body;
+  const sequence = useRef(0);
+
+  useEffect(() => {
+    if (!available) return;
+    backend?.loadSettings().then(({ settings: loaded }) => setSettings(loaded)).catch(() => undefined).finally(() => setSettingsLoaded(true));
+  }, [available, backend]);
+
+  useEffect(() => {
+    if (!enabled || !itemId) return;
+    backend?.dismissedFindingIds(itemId).then(setDismissed).catch(() => undefined);
+  }, [backend, enabled, itemId]);
+
+  const check = useCallback(async () => {
+    const text = latestBody.current;
+    if (!backend || !enabled || text === null || !text.trim()) return;
+    const run = ++sequence.current;
+    setStatus({ state: "checking" });
+    try {
+      const checked = await backend.check(text, section.trim() || null);
+      if (run !== sequence.current) return;
+      if (latestBody.current !== text) {
+        setStatus({ state: "idle" });
+        return;
+      }
+      setResult(checked);
+      setCheckedBody(text);
+      setStatus({ state: "idle" });
+    } catch (error) {
+      if (run === sequence.current) setStatus({ state: "error", message: error instanceof Error ? error.message : "The check failed." });
+    }
+  }, [backend, enabled, section]);
+
+  useEffect(() => {
+    if (!enabled || !settingsLoaded || !settings.checkWhileTyping || body === null || body === checkedBody) return;
+    const timer = window.setTimeout(() => void check(), CHECK_PAUSE_MS);
+    return () => window.clearTimeout(timer);
+  }, [body, check, checkedBody, enabled, settings.checkWhileTyping, settingsLoaded]);
+
+  const record = useCallback(
+    (finding: EditorialFinding, decision: FeedbackDecision, reason: string | null = null) => {
+      if (!result || checkedBody === null) return;
+      void backend?.recordFeedback(feedbackFor(result, checkedBody, finding, decision, itemId, reason)).catch(() => undefined);
+    },
+    [backend, checkedBody, itemId, result],
+  );
+
+  const dismiss = useCallback(
+    (finding: EditorialFinding, reason: string) => {
+      record(finding, "dismissed", reason);
+      setDismissed((current) => new Set(current).add(finding.id));
+    },
+    [record],
+  );
+
+  const suggest = useCallback(
+    (target: { finding: EditorialFinding } | { selection: Span }, note: string | null): Promise<RewriteResult> =>
+      backend
+        ? backend.suggest(latestBody.current ?? "", section.trim() || null, target, note)
+        : Promise.reject(new Error("Editorial checks are off.")),
+    [backend, section],
+  );
+
+  const current = enabled && result && checkedBody === body;
+  return {
+    enabled,
+    settings,
+    result,
+    /** Findings whose spans still match the body on screen. */
+    inlineResult: current ? result : null,
+    status,
+    dismissed,
+    activeFindingId,
+    setActiveFindingId,
+    selection,
+    setSelection,
+    check,
+    suggest,
+    dismiss,
+    accept: (finding: EditorialFinding) => record(finding, "accepted"),
+    fixed: (finding: EditorialFinding) => {
+      record(finding, "fixed");
+      setDismissed((current) => new Set(current).add(finding.id));
+    },
+    openWarnings: enabled && settings.publishWarning && result ? publishWarnings(result.findings, dismissed) : [],
+  };
+}