@anthusai/papyrus 5.42.0-next.2 → 5.42.0-next.3

package/components/proposals-view.tsx

@@ -0,0 +1,93 @@
+import { useMemo } from "react";
+import {
+  countProposals,
+  filterProposals,
+  kindLabel,
+  proposalMoves,
+  proposerLabel,
+  sortProposals,
+  stateLabel,
+  type ProposalFilter,
+  type ProposalMove,
+  type ProposalRow,
+} from "../lib/proposals-admin";
+
+const FILTERS: Array<{ key: ProposalFilter; label: string }> = [
+  { key: "open", label: "Open" },
+  { key: "draft", label: "Drafts" },
+  { key: "in_steering", label: "In steering" },
+  { key: "editor_review", label: "Editor review" },
+  { key: "decided", label: "Decided" },
+];
+
+export type ProposalsViewProps = {
+  rows: ProposalRow[];
+  /** True when the site has the reader-steering plugin; without it nothing reader-facing is shown. */
+  readers: boolean;
+  filter: ProposalFilter;
+  busy: boolean;
+  status: string;
+  reason: string;
+  onFilter: (filter: ProposalFilter) => void;
+  onReason: (reason: string) => void;
+  onMove: (proposalId: string, move: ProposalMove) => void;
+  onRefresh: () => void;
+};
+
+export function ProposalsView(props: ProposalsViewProps) {
+  const sorted = useMemo(() => sortProposals(props.rows), [props.rows]);
+  const counts = useMemo(() => countProposals(sorted), [sorted]);
+  const shown = filterProposals(sorted, props.filter);
+  return (
+    <section aria-labelledby="newsroom-proposals-title" data-news-desk-admin-panel="proposals">
+      <h3 id="newsroom-proposals-title">Proposals</h3>
+      <p>Story drafts and other changes that AI proposes. Editors pin, hold and decide them. Only editors and admins can see this.</p>
+      <p role="tablist" aria-label="Proposal views">
+        {FILTERS.filter((entry) => props.readers || entry.key !== "in_steering").map((entry) => (
+          <span key={entry.key}>
+            <button type="button" role="tab" aria-selected={props.filter === entry.key} onClick={() => props.onFilter(entry.key)}>
+              {entry.label} ({counts[entry.key]})
+            </button>{" "}
+          </span>
+        ))}
+        <button type="button" onClick={props.onRefresh} disabled={props.busy}>Refresh</button>
+      </p>
+      <label>
+        Reason for the next move (optional){" "}
+        <input type="text" value={props.reason} maxLength={500} onChange={(event) => props.onReason(event.target.value)} />
+      </label>
+      <p role="status" aria-live="polite">{props.status}</p>
+      {shown.length === 0 ? (
+        <p>Nothing here.</p>
+      ) : (
+        <ul>
+          {shown.map((row) => (
+            <li key={row.id} data-proposal-row={row.id}>
+              <article aria-label={row.title}>
+                <p>
+                  <strong>{kindLabel(row.kind)}</strong>: {row.title} ({stateLabel(row.state, props.readers)}
+                  {row.held ? ", on hold" : ""}) from {proposerLabel(row.proposer)} <time dateTime={row.createdAt}>{row.createdAt}</time>
+                </p>
+                {row.summary ? <p>{row.summary}</p> : null}
+                {row.body ? (
+                  <details>
+                    <summary>Read the draft</summary>
+                    <pre style={{ whiteSpace: "pre-wrap", overflowWrap: "anywhere" }}>{row.body}</pre>
+                  </details>
+                ) : null}
+                <p>
+                  {proposalMoves(row, props.readers).map((move) => (
+                    <span key={move.label}>
+                      <button type="button" disabled={props.busy} onClick={() => props.onMove(row.id, move)}>{move.label}</button>{" "}
+                    </span>
+                  ))}
+                </p>
+              </article>
+            </li>
+          ))}
+        </ul>
+      )}
+    </section>
+  );
+}
+

package/components/topic-steering-workspace.tsx

@@ -17,6 +17,7 @@ import { EditorialChecksAdminPanel } from "./editorial-checks-admin-panel";
 import { AutomationPanel } from "./automation-panel";
 import { MonitoringPanel } from "./monitoring-panel";
 import { ModerationPanel } from "./moderation-panel";
+import { ProposalsPanel } from "./proposals-panel";
 import { NewsletterPanel } from "./newsletter-panel";
 import { SignupEntriesPanel } from "./signup-entries-panel";
 import { pluginSettings, type PluginOutputs } from "../lib/plugin-settings";
@@ -256,7 +257,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" | "automations" | "delegations" | "signups" | "newsletter" | "moderation" | "editorial-checks" | "monitoring";
+type AdministrationPanel = "users" | "policies" | "sections" | "procedures" | "automations" | "delegations" | "signups" | "newsletter" | "moderation" | "proposals" | "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";
@@ -4398,6 +4399,15 @@ function AdministrationDeskView({
                   <span>Subscribers, issues and delivery for the site&apos;s email</span>
                 </Link>
               ) : null}
+              <Link
+                href={administrationPanelHref("proposals", isDemo)}
+                data-news-desk-admin-nav="proposals"
+                data-active={administrationPanel === "proposals" || undefined}
+                onClick={() => onPanelChange("proposals")}
+              >
+                <strong>Proposals</strong>
+                <span>Story drafts and changes that AI proposes</span>
+              </Link>
               {readerPluginEnabled() ? (
                 <Link
                   href={administrationPanelHref("moderation", isDemo)}
@@ -4413,6 +4423,7 @@ function AdministrationDeskView({
             <div className="news-desk-settings-panel">
               {administrationPanel === "signups" ? <SignupEntriesPanel /> : null}
               {administrationPanel === "newsletter" ? <NewsletterPanel isAdmin={canManageUsers} isDemo={isDemo} /> : null}
+              {administrationPanel === "proposals" ? <ProposalsPanel /> : null}
               {administrationPanel === "moderation" ? <ModerationPanel /> : null}
               {administrationPanel === "editorial-checks" ? <EditorialChecksAdminPanel /> : null}
               {administrationPanel === "automations" ? <AutomationPanel isDemo={isDemo} /> : null}
@@ -12890,7 +12901,7 @@ function readerPluginEnabled(): boolean {
 }
 
 function normalizeAdministrationPanel(value: string | null | undefined, demo = false): AdministrationPanel {
-  if (value === "policies" || value === "sections" || value === "procedures" || value === "automations" || value === "delegations" || value === "editorial-checks" || value === "monitoring") return value;
+  if (value === "policies" || value === "sections" || value === "procedures" || value === "automations" || value === "delegations" || value === "editorial-checks" || value === "monitoring" || value === "proposals") return value;
   if (value === "signups" && signupPluginEnabled()) return value;
   if (value === "newsletter" && newsletterPluginEnabled(demo)) return value;
   if (value === "moderation" && readerPluginEnabled()) return value;

package/lib/monitoring-client.ts

@@ -10,7 +10,7 @@ import type {
   MonitoringResult,
 } from "./monitoring-overview";
 
-type QueryField = "monitoringOverview" | "monitoringEmailSubmission" | "monitoringResolveEmailArticleLink" | "intakeEmailSubmissionReferences";
+type QueryField = "monitoringOverview" | "monitoringEmailSubmission" | "monitoringResolveEmailArticleLink" | "intakeEmailSubmissionReferences" | "monitoringQueueEmailReference";
 type GraphQLResult = { data?: Partial<Record<QueryField, unknown>>; errors?: { message?: string; errorType?: string }[] };
 
 async function query<T>(field: QueryField, queryText: string, variables: Record<string, string | number>): Promise<T | { error: "forbidden" } | { state: "unavailable" }> {
@@ -74,10 +74,19 @@ export async function importMonitoringEmailCandidates(
     } catch {
       return { imported: references.length, references, error: "The import response could not be read. Completed links are safe to retry." };
     }
-    if (!response?.ok || !Array.isArray(response.references)) {
+    if (!response?.ok || !Array.isArray(response.references) || response.references.length !== batch.length) {
       return { imported: references.length, references, error: "The import was not accepted. Check your editor access and retry." };
     }
     references.push(...response.references);
+    for (const [index, reference] of response.references.entries()) {
+      const queued = await query<{ queued: boolean }>("monitoringQueueEmailReference",
+        `mutation MonitoringQueueEmailReference($input: AWSJSON!) { monitoringQueueEmailReference(input: $input) }`,
+        { input: JSON.stringify({ receiptId, ...batch[index], referenceId: reference.id }) });
+      if (!("queued" in queued) || !queued.queued) {
+        return { imported: references.length, references,
+          error: "References were registered, but predictions could not be queued. Retry these selected links safely." };
+      }
+    }
   }
   return { imported: references.length, references };
 }

package/lib/proposals-admin.ts

@@ -0,0 +1,115 @@
+/**
+ * The data side of the Administration "Proposals" panel, which every site has (the queue is core; the reader-steering
+ * plugin only adds reader votes). Rows come from the staff-readable `Proposal` model; an editor moves one with the
+ * `transitionProposal` mutation. Pure functions, no network, so the rules the panel shows can be tested.
+ */
+
+export type ProposalRow = {
+  id: string;
+  kind: string;
+  title: string;
+  summary?: string | null;
+  body?: string | null;
+  state: string;
+  proposer?: string | null;
+  held?: boolean | null;
+  pinned?: boolean | null;
+  createdAt: string;
+};
+
+export type ProposalFilter = "open" | "draft" | "in_steering" | "editor_review" | "decided";
+/** A button: the states it moves through in order (one call each) or, for pin and hold, the `editProposal` action it runs. */
+export type ProposalMove = { label: string; path?: string[]; edit?: "pin" | "unpin" | "hold" | "release"; state?: string };
+
+const STATE_LABELS: Record<string, string> = {
+  draft: "Draft",
+  in_steering: "In steering",
+  editor_review: "Editor review",
+  approved: "Approved",
+  declined: "Declined",
+  overridden_by_editor: "Decided by an editor",
+};
+
+const KIND_LABELS: Record<string, string> = {
+  story_draft: "Story draft",
+  new_concept: "New concept",
+  rename: "Rename",
+  merge: "Merge",
+  split: "Split",
+  new_column: "New column",
+  element_symbol: "Element symbol",
+};
+
+const DECIDED = new Set(["approved", "declined", "overridden_by_editor"]);
+
+/**
+ * What an editor may do next; the function enforces the same table (overriding the community needs a reason and is not offered
+ * here). On a site without reader-steering nobody steers, so a draft goes straight to editor review (two moves) and the
+ * "in steering" wording never shows.
+ */
+function stateMoves(state: string, readers: boolean): ProposalMove[] {
+  if (state === "draft") {
+    return readers
+      ? [{ label: "Send to steering", path: ["in_steering"] }, { label: "Decline", path: ["declined"] }]
+      : [{ label: "Move to editor review", path: ["in_steering", "editor_review"] }, { label: "Decline", path: ["declined"] }];
+  }
+  if (state === "in_steering") return [{ label: "Move to editor review", path: ["editor_review"] }];
+  if (state === "editor_review") return [{ label: "Approve", path: ["approved"] }, { label: "Decline", path: ["declined"] }];
+  return [];
+}
+
+export const PROPOSAL_FIELDS = "id kind title summary body state proposer held pinned createdAt";
+export const LIST_PROPOSALS = `query Proposals($nextToken: String) { listProposals(limit: 500, nextToken: $nextToken) { items { ${PROPOSAL_FIELDS} } nextToken } }`;
+export const EDIT_PROPOSAL = `mutation Edit($proposalId: String!, $action: String!) { editProposal(proposalId: $proposalId, action: $action) { status id error message } }`;
+export const TRANSITION_PROPOSAL = `mutation Move($proposalId: String!, $state: String!, $reason: String) { transitionProposal(proposalId: $proposalId, state: $state, reason: $reason) { status id error message } }`;
+
+export function stateLabel(state: string, readers = true): string {
+  if (!readers && state === "in_steering") return "Waiting for review";
+  return STATE_LABELS[state] ?? state;
+}
+
+export function kindLabel(kind: string): string {
+  return KIND_LABELS[kind] ?? kind;
+}
+
+/** AI-filed proposals say "AI"; a reader's proposal says "Reader" (their id is never shown). */
+export function proposerLabel(proposer: string | null | undefined): string {
+  return proposer === "ai" ? "AI" : proposer ? "Reader" : "Unknown";
+}
+
+export function proposalMoves(row: Pick<ProposalRow, "state" | "held" | "pinned">, readers = true): ProposalMove[] {
+  const edits: ProposalMove[] = [
+    { label: row.pinned ? "Unpin" : "Pin", edit: row.pinned ? "unpin" : "pin" },
+    ...(DECIDED.has(row.state) && !row.held ? [] : [{ label: row.held ? "Release hold" : "Hold", edit: (row.held ? "release" : "hold") as "release" | "hold" }]),
+  ];
+  // A proposal on hold refuses every state change until it is released.
+  return [...(row.held ? [] : stateMoves(row.state, readers)), ...edits];
+}
+
+export function sortProposals(rows: ProposalRow[]): ProposalRow[] {
+  return [...rows].sort((left, right) => right.createdAt.localeCompare(left.createdAt) || right.id.localeCompare(left.id));
+}
+
+export function filterProposals(rows: ProposalRow[], filter: ProposalFilter): ProposalRow[] {
+  if (filter === "open") return rows.filter((row) => !DECIDED.has(row.state));
+  if (filter === "decided") return rows.filter((row) => DECIDED.has(row.state));
+  return rows.filter((row) => row.state === filter);
+}
+
+export function countProposals(rows: ProposalRow[]): Record<ProposalFilter, number> {
+  return {
+    open: filterProposals(rows, "open").length,
+    draft: filterProposals(rows, "draft").length,
+    in_steering: filterProposals(rows, "in_steering").length,
+    editor_review: filterProposals(rows, "editor_review").length,
+    decided: filterProposals(rows, "decided").length,
+  };
+}
+
+export type ProposalReceipt = { status?: string | null; id?: string | null; error?: string | null; message?: string | null };
+
+export function proposalReceiptMessage(receipt: ProposalReceipt | null | undefined): string {
+  if (!receipt) return "The action did not answer.";
+  if (receipt.status === "ok") return "Done.";
+  return receipt.message || receipt.error || "The action was refused.";
+}

package/lib/relevance-decisions.ts

@@ -1,4 +1,5 @@
 import type { SemanticRelationRecord } from "./category-repository";
+import { normalizeReferenceCurationStatus } from "./reference-policy";
 
 export const RELEVANCE_RELATION = "relevance_decision_is";
 
@@ -162,3 +163,11 @@ export function curationForRelevanceReview(decision: RelevanceDecisionView, revi
     shareable: review.shareable,
   };
 }
+
+/**
+ * A pending reference with a current cyclotron suggestion is waiting for an editor's answer,
+ * whether or not the cyclotron flagged the decision itself for review.
+ */
+export function awaitsEditorReview(curationStatus: unknown, decision: RelevanceDecisionView | undefined): boolean {
+  return Boolean(decision) && normalizeReferenceCurationStatus(curationStatus) === "pending";
+}

package/package.json

@@ -127,6 +127,8 @@
     "./components/presentation-header": "./components/presentation-header.tsx",
     "./components/presentation-rhythm-hrule": "./components/presentation-rhythm-hrule.tsx",
     "./components/priming-proof-page": "./components/priming-proof-page.tsx",
+    "./components/proposals-panel": "./components/proposals-panel.tsx",
+    "./components/proposals-view": "./components/proposals-view.tsx",
     "./components/prospectus-account-chooser": "./components/prospectus-account-chooser.tsx",
     "./components/publication-cyclotron-panel": "./components/publication-cyclotron-panel.tsx",
     "./components/reader-auth-control": "./components/reader-auth-control.tsx",
@@ -289,6 +291,7 @@
     "./lib/presentation-footer": "./lib/presentation-footer.ts",
     "./lib/pretext-layout": "./lib/pretext-layout.ts",
     "./lib/priming-proof-report": "./lib/priming-proof-report.ts",
+    "./lib/proposals-admin": "./lib/proposals-admin.ts",
     "./lib/prospectus-account-client": "./lib/prospectus-account-client.ts",
     "./lib/prospectus-publication-access": "./lib/prospectus-publication-access.ts",
     "./lib/prospectus-session": "./lib/prospectus-session.ts",
@@ -463,7 +466,7 @@
       "optional": true
     }
   },
-  "version": "5.42.0-next.2",
+  "version": "5.42.0-next.3",
   "dependencies": {
     "@aws-amplify/adapter-nextjs": "^1.7.3",
     "@aws-crypto/sha256-js": "5.2.0",

package/routes.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.42.0-next.2",
+  "version": "5.42.0-next.3",
   "routes": [
     {
       "file": "app/%5F_preview/[[...path]]/route.ts",