@anthusai/papyrus 2.0.0 → 2.0.2

package/amplify/functions/model-attachment-upload/handler.ts

@@ -49,6 +49,7 @@ const ALLOWED_ROLES = new Set([
   "graph_export",
   "raw_payload",
   "priming_outcome",
+  "priming_attempts",
 ]);
 const ALLOWED_MEDIA_TYPES = new Set([
   "application/json",

package/components/reference-cyclotron-priming.tsx

@@ -6,9 +6,8 @@ import { primingStateText, type PrimingRequestView } from "../lib/relevance-stat
 export type PrimingFormInput = { url: string; label: string; explanation: string };
 
 /**
- * A compact form that primes the running relevance cyclotron with a pasted
- * URL. The next sweep reads the page, adds it to the cyclotron's example list
- * and records the outcome, which this list shows beside each saved request.
+ * A compact "Add a reference" form for a pasted URL. The page is read in the
+ * background and the outcome is shown beside each added reference.
  */
 export function ReferenceCyclotronPriming({
   labels,
@@ -25,19 +24,19 @@ export function ReferenceCyclotronPriming({
   const [message, setMessage] = useState<string | null>(null);
 
   async function submit() {
-    setMessage("Saving…");
+    setMessage("Adding…");
     try {
       await onRequestPriming({ url, label, explanation });
       setUrl("");
       setExplanation("");
-      setMessage("Saved. The next sweep reads the page and adds it to the cyclotron.");
+      setMessage("Added. The page will be read shortly.");
     } catch (error) {
       setMessage(error instanceof Error ? error.message : String(error));
     }
   }
 
   return (
-    <section aria-label="Prime the relevance cyclotron" className="space-y-2 text-sm" data-reference-cyclotron-priming>
+    <section aria-label="Add a reference" className="space-y-2 text-sm" data-reference-cyclotron-priming>
       <form
         className="flex flex-wrap items-end gap-3"
         onSubmit={(event) => {
@@ -46,9 +45,9 @@ export function ReferenceCyclotronPriming({
         }}
       >
         <label className="flex min-w-64 flex-1 flex-col gap-1">
-          <span className="text-xs text-muted-foreground">Prime with a URL</span>
+          <span className="text-xs text-muted-foreground">Add a reference by URL</span>
           <input
-            aria-label="Priming URL"
+            aria-label="Reference URL"
             onChange={(event) => setUrl(event.target.value)}
             placeholder="https://"
             required
@@ -57,8 +56,8 @@ export function ReferenceCyclotronPriming({
           />
         </label>
         <label className="flex flex-col gap-1">
-          <span className="text-xs text-muted-foreground">Label</span>
-          <select aria-label="Priming label" onChange={(event) => setLabel(event.target.value)} value={label}>
+          <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>
             ))}
@@ -66,13 +65,13 @@ export function ReferenceCyclotronPriming({
         </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="Priming explanation" onChange={(event) => setExplanation(event.target.value)} type="text" value={explanation} />
+          <input aria-label="Reason" onChange={(event) => setExplanation(event.target.value)} type="text" value={explanation} />
         </label>
-        <button className="cyclotron-review-secondary" type="submit">Save</button>
+        <button className="cyclotron-review-secondary" type="submit">Add reference</button>
         {message ? <p className="basis-full text-xs" role="status">{message}</p> : null}
       </form>
       {requests.length ? (
-        <ul aria-label="Saved priming requests" className="space-y-1 text-xs text-muted-foreground">
+        <ul aria-label="Added references" className="space-y-1 text-xs text-muted-foreground">
           {requests.slice(0, 10).map((view) => (
             <li data-priming-request-state={view.outcome?.state ?? "waiting"} key={view.request.requestId}>
               <span className="font-medium">{view.request.label}</span> {view.request.url} · {primingStateText(view)}

package/components/reference-cyclotron-status.tsx

@@ -38,19 +38,19 @@ export function ReferenceCyclotronStatus({
     setMessage("Sending…");
     try {
       await onRequestRate(choice);
-      setMessage("The next sweep applies it and the status will show who set it.");
+      setMessage("Saved. The new rate takes effect shortly 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>
+    <section aria-label="Suggestion status" className="space-y-2" data-reference-cyclotron-status>
       <CyclotronStatusView status={status} />
       {stale ? (
         <p className="text-xs text-foreground" data-reference-cyclotron-status-stale>
           <span aria-hidden="true">⚠ </span>
-          Snapshot from {Math.round(ageHours)} hours ago; the next sweep refreshes it.
+          Status last updated {Math.round(ageHours)} hours ago; it refreshes automatically.
         </p>
       ) : null}
       <button
@@ -59,7 +59,7 @@ export function ReferenceCyclotronStatus({
         onClick={() => setOpen((value) => !value)}
         type="button"
       >
-        {open ? "Hide what the cyclotron is doing" : "What the cyclotron is doing"}
+        {open ? "Hide suggestion details" : "Suggestion details"}
       </button>
       {open ? (
         <div className="space-y-3">

package/components/reference-cyclotron-suggestion.tsx

@@ -101,12 +101,12 @@ export function ReferenceSuggestionProvenance({ decision }: { decision: Relevanc
         <ul className="mt-2 space-y-1">
           <li>{summary.teachingLabelsSentence}.</li>
           <li>{summary.primingExamplesSentence}.</li>
-          <li>Doctrine fingerprint {summary.doctrineShortHash ?? "not recorded"}.</li>
-          <li>Model {summary.modelVersion ?? "version not recorded"}.</li>
+          <li>Guidelines code {summary.doctrineShortHash ?? "not recorded"}.</li>
+          <li>Suggestion {summary.modelVersion ?? "revision not recorded"}.</li>
           <li>Decided {formatSuggestionTime(summary.decidedAt)}.</li>
         </ul>
       ) : (
-        <p className="mt-2">This suggestion was made before the cyclotron recorded how. Only its model version and confidence are known.</p>
+        <p className="mt-2">This suggestion was made before the details were recorded. Only its revision and confidence are known.</p>
       )}
     </details>
   );
@@ -116,7 +116,7 @@ export function ReferenceSuggestionProvenance({ decision }: { decision: Relevanc
 export function CountsAsTrainingLabelNote({ referenceLineageId }: { referenceLineageId: string }) {
   return (
     <p className="border-l-2 border-foreground pl-2 text-xs font-semibold text-foreground" data-reference-training-label={referenceLineageId}>
-      Counts as a training label: an editor made this decision, so the cyclotron learns from it.
+      Recorded as an editor&rsquo;s own decision.
     </p>
   );
 }
@@ -135,8 +135,8 @@ export function DelegatedCurationNote({ delegated, referenceLineageId }: { deleg
       <p className="text-xs">Delegation {delegated.delegationShortId || "id not recorded"}.</p>
       <p className="text-xs font-semibold" data-reference-training-label={referenceLineageId}>
         {delegated.countsAsTrainingLabel
-          ? `Counts as a training label: the record is stamped as ${delegated.person ?? "the person"}'s own decision, so the cyclotron learns from it.`
-          : "Does not count as a training label."}
+          ? `Recorded as ${delegated.person ?? "the person"}'s own decision.`
+          : "Not recorded as a person's own decision."}
       </p>
     </section>
   );

package/components/reference-live-agreement.tsx

@@ -12,10 +12,10 @@ import { formatSuggestionTime } from "./reference-cyclotron-suggestion";
 
 function MeasurementFigures({ measurement }: { measurement: AgreementStripMeasurement }) {
   const figures: Array<[string, string]> = [
-    ["Agreement", formatPercentage(measurement.agreement)],
-    ["Precision", formatPercentage(measurement.precision)],
-    ["Recall", formatPercentage(measurement.recall)],
-    ["Comparisons", String(measurement.comparisons)],
+    ["Matches editors", formatPercentage(measurement.agreement)],
+    ["Suggested includes editors kept", formatPercentage(measurement.precision)],
+    ["Editor includes suggested", formatPercentage(measurement.recall)],
+    ["Decisions compared", String(measurement.comparisons)],
   ];
   return (
     <dl className="flex flex-wrap gap-x-6 gap-y-1">
@@ -30,19 +30,19 @@ function MeasurementFigures({ measurement }: { measurement: AgreementStripMeasur
 }
 
 /**
- * Live agreement at the top of References: how often the cyclotron's
+ * Live agreement at the top of References: how often the
  * suggestions matched what editors then decided. Hidden without a payload.
  */
 export function ReferenceLiveAgreement({ agreement }: { agreement: ShadowAgreement | null }) {
   const state = agreementStripState(agreement);
   if (state.kind === "hidden") return null;
   return (
-    <section aria-label="Live agreement" className="shrink-0 space-y-2 border-y border-foreground py-3" data-reference-live-agreement={state.kind}>
-      <h3 className="text-xs font-semibold uppercase tracking-wide text-foreground">Live agreement</h3>
+    <section aria-label="Suggestion accuracy" className="shrink-0 space-y-2 border-y border-foreground py-3" data-reference-live-agreement={state.kind}>
+      <h3 className="text-xs font-semibold uppercase tracking-wide text-foreground">Suggestion accuracy</h3>
       {state.loop ? (
         <p className="text-sm text-foreground" data-reference-live-agreement-loop>
           <span className="font-semibold">{loopStateWords(state.loop)}</span>
-          {" · "}Last sweep {formatSuggestionTime(state.loop.lastSweepAt)}
+          {" · "}Last checked {formatSuggestionTime(state.loop.lastSweepAt)}
           {" · "}{dailyCapWords(state.loop)}
         </p>
       ) : null}
@@ -51,11 +51,11 @@ export function ReferenceLiveAgreement({ agreement }: { agreement: ShadowAgreeme
       ) : null}
       {state.kind === "not_enough" ? (
         <p className="text-sm text-foreground" data-reference-live-agreement-not-enough>
-          Not enough comparisons yet: {state.measurement.comparisons} of {state.needed} editor decisions have followed a suggestion. Figures appear at {state.needed}.
+          Not enough decisions yet: {state.measurement.comparisons} of {state.needed} editor decisions have followed a suggestion. Figures appear at {state.needed}.
         </p>
       ) : <MeasurementFigures measurement={state.measurement} />}
       <p className="text-xs text-foreground">
-        Suggestions compared with the decisions editors made afterwards. Computed {formatSuggestionTime(agreement?.computedAt ?? null)}.
+        Suggestions compared with the decisions editors made afterwards. Updated {formatSuggestionTime(agreement?.computedAt ?? null)}.
       </p>
     </section>
   );

package/components/reference-priming.tsx

@@ -10,7 +10,7 @@ export function ReferencePriming(props: PrimingPanelProps) {
   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)"}
+        {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>

package/components/reference-relevance-review.tsx

@@ -67,7 +67,7 @@ export function ReferenceRelevanceReview({
           onChange={(event) => setShareable(event.target.checked)}
           type="checkbox"
         />
-        My explanation may be quoted publicly (for the Cyclotron example page)
+        My explanation may be quoted publicly (on a public example page)
       </label>
       {error ? <p className="text-xs text-destructive" role="alert">{error}</p> : null}
     </section>

package/components/reference-section-suggestion.tsx

@@ -98,7 +98,7 @@ export function SectionPicker({
           </label>
         );
       })}
-      <p className="text-xs text-foreground">The Section you choose is a training label for the cyclotron.</p>
+      <p className="text-xs text-foreground">The Section you choose is saved with your decision.</p>
     </fieldset>
   );
 }

package/lib/cyclotron-suggestions.ts

@@ -92,13 +92,13 @@ export function latestShadowAgreement(payloads: Array<{ json: unknown; updatedAt
 }
 
 const STOP_REASON_WORDS: Record<string, string> = {
-  disabled: "The relevance cyclotron is switched off in the steering config, so it is making no suggestions.",
-  "daily decision cap": "The last sweep stopped at the daily decision cap, so some references have no suggestion yet.",
+  disabled: "Suggestions are switched off in the settings, so none are being made.",
+  "daily decision cap": "The last check reached the daily limit, so some references have no suggestion yet.",
 };
 
 /** The sentence an editor reads for a stop reason; unknown reasons are shown as given. */
 export function stopReasonSentence(reason: string): string {
-  return STOP_REASON_WORDS[reason] ?? `The last sweep stopped early: ${reason}.`;
+  return STOP_REASON_WORDS[reason] ?? `The last check stopped early: ${reason}.`;
 }
 
 /**
@@ -123,14 +123,14 @@ export function agreementStripState(agreement: ShadowAgreement | null): Agreemen
   };
 }
 
-/** "Loop on" or "Loop off", the word the strip leads with. */
+/** "Suggestions on" or "Suggestions off", the words the panel leads with. */
 export function loopStateWords(loop: CyclotronLoopState): string {
-  return loop.enabled ? "Loop on" : "Loop off";
+  return loop.enabled ? "Suggestions on" : "Suggestions off";
 }
 
 /** The daily cap in words; no cap is said plainly. */
 export function dailyCapWords(loop: CyclotronLoopState): string {
-  return loop.maxDecisionsPerDay === null ? "No daily decision cap" : `Daily cap ${loop.maxDecisionsPerDay} decisions`;
+  return loop.maxDecisionsPerDay === null ? "No daily limit" : `Daily limit ${loop.maxDecisionsPerDay} decisions`;
 }
 
 export function formatPercentage(fraction: number | null): string {
@@ -202,10 +202,10 @@ export function provenanceSummary(decision: RelevanceDecisionView): ProvenanceSu
   if (!provenance) return null;
   const plural = (count: number, singular: string) => `${count} ${singular}${count === 1 ? "" : "s"}`;
   return {
-    teachingLabelsSentence: `Taught by ${plural(provenance.teachingLabels, "label")} that editors set themselves`,
-    primingExamplesSentence: `${plural(provenance.primingExamples, "priming example")} supplied as starting examples`,
+    teachingLabelsSentence: `Based on ${plural(provenance.teachingLabels, "decision")} that editors made themselves`,
+    primingExamplesSentence: `${plural(provenance.primingExamples, "example reference")} supplied as starting examples`,
     doctrineShortHash: provenance.doctrineFingerprint ? provenance.doctrineFingerprint.slice(0, SHORT_HASH_LENGTH) : null,
-    modelVersion: decision.version === null ? null : `version ${decision.version}`,
+    modelVersion: decision.version === null ? null : `revision ${decision.version}`,
     decidedAt: decision.decidedAt,
   };
 }

package/lib/relevance-status.ts

@@ -127,10 +127,10 @@ export function isPrimingOutcome(value: unknown): value is PrimingOutcome {
     || (outcome.state === "failed" && typeof outcome.message === "string");
 }
 
-/** In words: waiting for the next sweep, applied as version N, or failed with the reason. */
+/** In plain words: Adding, Added, or Couldn't add with the reason. */
 export function primingStateText(view: PrimingRequestView): string {
-  if (!view.outcome) return "Waiting for the next sweep";
+  if (!view.outcome) return "Adding";
   return view.outcome.state === "applied"
-    ? `Applied as version ${view.outcome.version}`
-    : `Failed: ${view.outcome.message}`;
+    ? "Added"
+    : `Couldn't add: ${view.outcome.message}`;
 }

package/package.json

@@ -378,7 +378,7 @@
       "optional": true
     }
   },
-  "version": "2.0.0",
+  "version": "2.0.2",
   "dependencies": {
     "@aws-amplify/adapter-nextjs": "^1.7.3",
     "@aws-crypto/sha256-js": "5.2.0",

package/routes.manifest.json

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