@anthusai/papyrus 5.43.0-next.37 → 5.43.0-next.39

package/components/news-desk-taxonomy-client.ts

@@ -10,6 +10,7 @@ import { createLocalPreviewRealPublishedVersions, createLocalPreviewAssignments,
 import { generateClient } from "aws-amplify/data";
 import { testEditorOverrideAllowed } from "../lib/test-editor-override";
 import { downloadData, getUrl } from "aws-amplify/storage";
+import { fetchAuthSession } from "aws-amplify/auth";
 import type { Schema } from "../amplify/data/resource";
 import type { NewsDeskAppendix, NewsDeskCategoryTreeNode } from "../lib/content-types";
 import { createEmptyCategorySteeringDashboard } from "../lib/category-dashboard";
@@ -45,7 +46,19 @@ import type {
   SemanticRelationRecord,
   UserDirectoryEntry,
 } from "../lib/category-repository";
-import { relationTypeKey } from "../lib/semantic-graph";
+import { relationTypeKey, semanticStateKey, semanticVersionKey } from "../lib/semantic-graph";
+import {
+  CONVERSATION_FEED_KEY,
+  REFERENCE_CONVERSATION_KIND,
+  conversationAnchorKey,
+  conversationMessageId,
+  conversationThreadId,
+  conversationThreadKind,
+  createWithSequenceRetry,
+  findOrCreateThread,
+  type ConversationAnchor,
+  type ConversationMessage,
+} from "../lib/conversation";
 import { legacyStageKeysToLoad, type ContentItemVersionRecord } from "../lib/content-item-lifecycle";
 import { getContentItemStageDefinitions } from "../lib/site-brand";
 import { DOCTRINE_DEFINITIONS, getCategoryDoctrineDefinitions, type DoctrineCategory } from "../lib/doctrine";
@@ -103,6 +116,23 @@ const LIST_MESSAGE_THREADS_BY_KIND_AND_UPDATED_AT_QUERY = `
   }
 `;
 
+const LIST_MESSAGE_THREADS_BY_ANCHOR_AND_UPDATED_AT_QUERY = `
+  query ListMessageThreadsByAnchorAndUpdatedAt($primaryAnchorKey: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
+    listMessageThreadsByAnchorAndUpdatedAt(primaryAnchorKey: $primaryAnchorKey, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
+      items {
+        id threadKind status title summary primaryAnchorKind primaryAnchorId primaryAnchorLineageId primaryAnchorKey createdBySub createdByUserProfileId createdByLabel messageCount lastMessageId lastMessageAt contextDigest activeResponseMessageId responseLockOwner responseLockExpiresAt metadata createdAt updatedAt newsroomFeedKey
+      }
+      nextToken
+    }
+  }
+`;
+
+const CREATE_SEMANTIC_RELATION_MUTATION = `
+  mutation CreateSemanticRelation($input: CreateSemanticRelationInput!) {
+    createSemanticRelation(input: $input) { id }
+  }
+`;
+
 const LIST_MESSAGES_BY_THREAD_AND_SEQUENCE_QUERY = `
   query ListMessagesByThreadAndSequence($threadId: ID!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
     listMessagesByThreadAndSequence(threadId: $threadId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
@@ -1388,6 +1418,41 @@ export async function createSectionForumThreadRecord(input: {
   return { created: true, thread: normalizeThreadRecord(response.createMessageThread ?? thread) };
 }
 
+/**
+ * Appends one Message to a thread: the next sequence number, the Message, then the thread's count and last Message. The Message id
+ * derives from the sequence number, so a create that loses a race for the number collides and retries with the next one.
+ */
+async function appendMessageToThread(thread: MessageThreadRecord, build: (sequenceNumber: number, now: string) => MessageRecord): Promise<{ thread: MessageThreadRecord; message: MessageRecord }> {
+  const threadId = thread.id;
+  let now = new Date().toISOString();
+  let built: MessageRecord | null = null;
+  const { created } = await createWithSequenceRetry({
+    list: () => listMessagesByThreadId(threadId, 1000),
+    create: (sequenceNumber) => {
+      now = new Date().toISOString();
+      built = build(sequenceNumber, now);
+      return runGraphql<{ createMessage?: MessageRecord | null }>(CREATE_MESSAGE_MUTATION, { input: built });
+    },
+  });
+  const createdMessage = normalizeMessageRecord(created.createMessage ?? built!);
+  const updated = await runGraphql<{ updateMessageThread?: MessageThreadRecord | null }>(
+    UPDATE_MESSAGE_THREAD_MUTATION,
+    {
+      input: {
+        id: threadId,
+        messageCount: (thread.messageCount ?? 0) + 1,
+        lastMessageId: createdMessage.id,
+        lastMessageAt: createdMessage.createdAt,
+        updatedAt: now,
+      },
+    },
+  );
+  return {
+    thread: normalizeThreadRecord(updated.updateMessageThread ?? { ...thread, updatedAt: now }),
+    message: createdMessage,
+  };
+}
+
 export async function appendForumThreadMessageRecord(input: {
   threadId: string;
   summary: string;
@@ -1404,11 +1469,8 @@ export async function appendForumThreadMessageRecord(input: {
   if (!summary) throw new Error("summary is required");
   if (!content) throw new Error("content is required");
   const thread = await getMessageThreadRecord(threadId);
-  const existing = await listMessagesByThreadId(threadId, 1000);
-  const nextSequence = Math.max(0, ...existing.map((message) => Number(message.sequenceNumber || 0))) + 1;
-  const now = new Date().toISOString();
-  const message: MessageRecord = {
-    id: `message-forum-${safeForumId(threadId)}-${String(nextSequence).padStart(4, "0")}`,
+  return appendMessageToThread(thread, (sequenceNumber, now) => ({
+    id: `message-forum-${safeForumId(threadId)}-${String(sequenceNumber).padStart(4, "0")}`,
     messageKind: "forum_post",
     messageDomain: "edition_coordination",
     status: "active",
@@ -1417,7 +1479,7 @@ export async function appendForumThreadMessageRecord(input: {
     authorLabel: input.authorLabel?.trim() || "editor",
     threadId,
     parentMessageId: input.parentMessageId?.trim() || null,
-    sequenceNumber: nextSequence,
+    sequenceNumber,
     role: input.role || "human",
     messageType: "forum_message",
     content,
@@ -1425,30 +1487,184 @@ export async function appendForumThreadMessageRecord(input: {
     createdAt: now,
     updatedAt: now,
     newsroomFeedKey: "messages",
-  };
-  const created = await runGraphql<{ createMessage?: MessageRecord | null }>(
-    CREATE_MESSAGE_MUTATION,
-    { input: message },
-  );
-  const createdMessage = normalizeMessageRecord(created.createMessage ?? message);
-  const updated = await runGraphql<{ updateMessageThread?: MessageThreadRecord | null }>(
-    UPDATE_MESSAGE_THREAD_MUTATION,
-    {
-      input: {
-        id: threadId,
-        messageCount: (thread.messageCount ?? 0) + 1,
-        lastMessageId: createdMessage.id,
-        lastMessageAt: createdMessage.createdAt,
+  }));
+}
+
+type ConversationAuthor = { sub: string | null; label: string };
+
+async function currentConversationAuthor(): Promise<ConversationAuthor> {
+  const snapshot = await loadReaderSessionSnapshot();
+  let sub: string | null = null;
+  try {
+    const session = await fetchAuthSession();
+    const claim = session.tokens?.idToken?.payload?.sub ?? session.tokens?.accessToken?.payload?.sub;
+    sub = typeof claim === "string" && claim ? claim : null;
+  } catch {
+    sub = null;
+  }
+  return { sub, label: snapshot.auth.status === "signedIn" ? snapshot.auth.label : "editor" };
+}
+
+async function findConversationThread(anchorKey: string): Promise<MessageThreadRecord | null> {
+  type Response = { listMessageThreadsByAnchorAndUpdatedAt?: { items?: Array<MessageThreadRecord | null> | null } | null };
+  const response = await runGraphql<Response>(LIST_MESSAGE_THREADS_BY_ANCHOR_AND_UPDATED_AT_QUERY, {
+    primaryAnchorKey: anchorKey,
+    sortDirection: "DESC",
+    limit: 10,
+  });
+  const found = (response.listMessageThreadsByAnchorAndUpdatedAt?.items ?? []).filter(Boolean) as MessageThreadRecord[];
+  const thread = found.find((entry) => entry.status !== "deleted") ?? null;
+  return thread ? normalizeThreadRecord(thread) : null;
+}
+
+/** The one conversation for an anchor: found by its anchor key, created when there is none. Concurrent first posts share the thread. */
+export async function ensureConversationThread(anchor: ConversationAnchor, author?: ConversationAuthor): Promise<MessageThreadRecord> {
+  const anchorKey = conversationAnchorKey(anchor);
+  if (!anchorKey) throw new Error("An unattached conversation starts its own thread.");
+  return findOrCreateThread({
+    find: () => findConversationThread(anchorKey),
+    create: async () => {
+      const now = new Date().toISOString();
+      const lineageId = anchor.lineageId!.trim();
+      const thread: MessageThreadRecord = {
+        id: conversationThreadId(anchor),
+        threadKind: conversationThreadKind(anchor),
+        status: "active",
+        title: anchor.title?.trim() || lineageId,
+        primaryAnchorKind: anchor.kind,
+        primaryAnchorId: lineageId,
+        primaryAnchorLineageId: lineageId,
+        primaryAnchorKey: anchorKey,
+        createdBySub: author?.sub ?? null,
+        createdByLabel: author?.label ?? "editor",
+        messageCount: 0,
+        lastMessageId: null,
+        lastMessageAt: null,
+        metadata: JSON.stringify({ anchorKind: anchor.kind, anchorLineageId: lineageId }),
+        createdAt: now,
         updatedAt: now,
-      },
+        newsroomFeedKey: CONVERSATION_FEED_KEY,
+      };
+      const response = await runGraphql<{ createMessageThread?: MessageThreadRecord | null }>(CREATE_MESSAGE_THREAD_MUTATION, { input: thread });
+      return normalizeThreadRecord(response.createMessageThread ?? thread);
     },
-  );
+  });
+}
+
+function toConversationMessage(record: MessageRecord): ConversationMessage {
   return {
-    thread: normalizeThreadRecord(updated.updateMessageThread ?? { ...thread, updatedAt: now }),
-    message: createdMessage,
+    id: record.id,
+    parentMessageId: record.parentMessageId ?? null,
+    authorLabel: record.authorLabel ?? "",
+    content: record.content ?? record.body ?? "",
+    createdAt: record.createdAt,
+    sequenceNumber: Number(record.sequenceNumber ?? 0),
   };
 }
 
+/** Every Message in the anchor's conversation, oldest first. An anchor with no conversation yet has none. */
+export async function loadConversationMessages(anchor: ConversationAnchor): Promise<ConversationMessage[]> {
+  const anchorKey = conversationAnchorKey(anchor);
+  if (!anchorKey) return [];
+  const thread = await findConversationThread(anchorKey);
+  if (!thread) return [];
+  const records = await listMessagesByThreadId(thread.id, 500);
+  return records.filter((record) => record.status !== "deleted").map(toConversationMessage);
+}
+
+/** How many Messages each Reference has, from the Reference conversation threads alone (no query per card). Keyed by lineage id. */
+export async function loadReferenceConversationCounts(): Promise<Map<string, number>> {
+  const threads = await listMessageThreadsByKind(REFERENCE_CONVERSATION_KIND, 500);
+  const counts = new Map<string, number>();
+  for (const thread of threads) {
+    const lineageId = thread.primaryAnchorLineageId;
+    if (lineageId && thread.status !== "deleted" && (thread.messageCount ?? 0) > 0) counts.set(lineageId, thread.messageCount ?? 0);
+  }
+  return counts;
+}
+
+/**
+ * Writes a Message into the anchor's conversation (finding or creating the thread), and a `comment` relation from the Message to
+ * the Reference or Item so the thing's own detail can find it. The relation is secondary: if it fails the Message is still saved.
+ */
+export async function appendConversationMessage(input: {
+  anchor: ConversationAnchor;
+  body: string;
+  parentMessageId?: string | null;
+}): Promise<{ message: ConversationMessage; thread: MessageThreadRecord; relationError: string | null }> {
+  const content = String(input.body || "").trim();
+  if (!content) throw new Error("Write something to post.");
+  const author = await currentConversationAuthor();
+  const thread = await ensureConversationThread(input.anchor, author);
+  const result = await appendMessageToThread(thread, (sequenceNumber, now) => ({
+    id: conversationMessageId(thread.id, sequenceNumber),
+    messageKind: "comment",
+    messageDomain: "commentary",
+    status: "active",
+    summary: content.slice(0, 120),
+    source: "newsroom.conversation",
+    authorSub: author.sub,
+    authorLabel: author.label,
+    threadId: thread.id,
+    parentMessageId: input.parentMessageId?.trim() || null,
+    sequenceNumber,
+    role: "human",
+    messageType: "comment",
+    content,
+    metadata: JSON.stringify({ messageKind: "comment", anchorKey: conversationAnchorKey(input.anchor) }),
+    createdAt: now,
+    updatedAt: now,
+    newsroomFeedKey: CONVERSATION_FEED_KEY,
+  }));
+  let relationError: string | null = null;
+  if (input.anchor.kind !== "none") {
+    try {
+      await createCommentRelation(result.message, input.anchor);
+    } catch (error) {
+      relationError = error instanceof Error ? error.message : "The link to the Reference could not be saved.";
+    }
+  }
+  return { message: toConversationMessage(result.message), thread: result.thread, relationError };
+}
+
+async function createCommentRelation(message: MessageRecord, anchor: ConversationAnchor): Promise<void> {
+  if (anchor.kind === "none") return;
+  const lineageId = anchor.lineageId.trim();
+  const objectId = anchor.id?.trim() || lineageId;
+  const now = message.createdAt;
+  await runGraphql(CREATE_SEMANTIC_RELATION_MUTATION, {
+    input: {
+      id: `semantic-relation-${message.id}-comment`,
+      relationState: "current",
+      predicate: "comment",
+      relationTypeId: "semantic-relation-type-comment",
+      relationTypeKey: "comment",
+      relationDomain: "commentary",
+      subjectKind: "message",
+      subjectId: message.id,
+      subjectLineageId: message.id,
+      subjectVersionNumber: 1,
+      objectKind: anchor.kind,
+      objectId,
+      objectLineageId: lineageId,
+      subjectStateKey: semanticStateKey("message", message.id),
+      objectStateKey: semanticStateKey(anchor.kind, lineageId),
+      objectSubjectStateKey: `${semanticStateKey(anchor.kind, lineageId)}#message`,
+      predicateObjectStateKey: `comment#${semanticStateKey(anchor.kind, lineageId)}`,
+      subjectVersionKey: semanticVersionKey("message", message.id),
+      objectVersionKey: semanticVersionKey(anchor.kind, objectId),
+      score: 1,
+      rank: 1,
+      reviewRecommended: false,
+      importedAt: now,
+      createdAt: now,
+      updatedAt: now,
+      newsroomFeedKey: "semanticRelations",
+      metadata: JSON.stringify({ kind: "conversation.comment", messageKind: "comment" }),
+    },
+  });
+}
+
 export async function deleteForumThreadMessageRecord(input: {
   threadId: string;
   messageId: string;

package/components/newsroom-organizer.css

@@ -401,11 +401,29 @@ body:has(.newsroom-organizer)>[data-staging-banner]{flex-shrink:0}
   --feed-radius-lg: 10px;
   --feed-radius-md: 8px;
   --feed-radius-pill: 8px;
+  /* Verdict tones for the rating grid. Hue is never the only signal: the cell also carries a CircleCheck or
+     CircleX and the word Match or Miss. Named here, in the feed layer, because the component must not hold
+     literal palette values and because Tailwind's dark: variant (.dark *) never fires in this app. */
+  --feed-verdict-match-tint: #05966933;
+  --feed-verdict-match-ink: #064e3b;
+  --feed-verdict-match-fill: #059669;
+  --feed-verdict-miss-tint: #dc262633;
+  --feed-verdict-miss-ink: #7f1d1d;
+  --feed-verdict-miss-fill: #dc2626;
+  /* The quiet step for an unpredicted cell and a switched-off button. */
+  --feed-quiet: 0.6;
 }
 [data-kanbus-theme][data-color-mode="dark"] [data-feed-surface], [data-kanbus-theme][data-color-mode="dark"][data-feed-surface] {
   --feed-card: color-mix(in oklab, var(--kb-theme-paper) 94%, var(--kb-theme-ink));
   --feed-footer: color-mix(in oklab, var(--kb-theme-paper) 90%, var(--kb-theme-ink));
   --feed-control: color-mix(in oklab, var(--kb-theme-paper) 80%, var(--kb-theme-ink));
+  /* Dark verdicts lift toward the tint rather than down into it, so the ink reads on a dark card. */
+  --feed-verdict-match-tint: #34d39933;
+  --feed-verdict-match-ink: #d1fae5;
+  --feed-verdict-match-fill: #34d399;
+  --feed-verdict-miss-tint: #f8717133;
+  --feed-verdict-miss-ink: #fee2e2;
+  --feed-verdict-miss-fill: #f87171;
 }
 
 /* Borderless detail pane, Add panel and mobile sheet ([data-feed-flat]): no border, rule or box anywhere inside. Regions are told apart
@@ -426,6 +444,12 @@ body:has(.newsroom-organizer)>[data-staging-banner]{flex-shrink:0}
 }
 [data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat] [data-cyclotron-choice] { border-radius: var(--feed-radius-pill) !important; }
 [data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat] [data-review-queue-bar] { background: var(--feed-footer) !important; }
+/* The decision control keeps one corner across its segments and its reason field, and its predicted segment
+   keeps its tones apart: the flat rules above give every unpressed button the same control fill, which would
+   leave the predicted side and an untouched side looking identical. */
+[data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat] [data-decision-control] :is(button, textarea) { border-radius: var(--feed-radius-md) !important; }
+[data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat] [data-decision-control] [data-review-choice][data-state="idle"] { background: color-mix(in oklab, var(--feed-control) 45%, transparent) !important; }
+
 /* The rating grid keeps its own rounded rectangles in the borderless panes (not the pill shape the flat rules give other buttons). */
 [data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat][data-feed-flat] [data-rating-grid] :is(button, [data-cyclotron-choice]) { border-radius: var(--feed-radius-md) !important; }
 

package/components/newsroom-references-view.tsx

@@ -50,6 +50,8 @@ import { FEED_SURFACE_PROPS, FEED_SURFACE_STYLE, ReferenceFeed } from "./referen
 import { ReferenceCapturePanel } from "./reference-capture-panel";
 import { useReferenceCapture, type CorrectCaptureAction } from "./reference-capture-client";
 import { useRatingStore, type RatingController } from "./use-reference-ratings";
+import { ReferenceConversation } from "./reference-conversation";
+import { useReferenceMessageCounts } from "./use-conversation";
 import { captureStatusesByLineage } from "../lib/reference-capture";
 import { applyFeedOrderSnapshot, partitionReferenceFeed, takeFeedOrderSnapshot, type FeedOrderSnapshot, type ReferenceFeedTabKey } from "../lib/reference-feed-ranking";
 import { referenceDek, referencePreviewsByLineage, type ReferencePreview } from "../lib/reference-preview";
@@ -200,6 +202,7 @@ function ReferenceDetailPanel({
   decision,
   demo = false,
   disabled,
+  onMessageCount,
   onReview,
   predictionState = "ready",
   reviewReason,
@@ -223,6 +226,7 @@ function ReferenceDetailPanel({
   decision?: RelevanceDecisionView;
   demo?: boolean;
   disabled?: boolean;
+  onMessageCount?: (lineageId: string, count: number) => void;
   onRelevanceReview?: (curation: RelevanceCuration) => Promise<void> | void;
   onReview: (action: ReferenceCurationAction, options?: ReferenceReviewOptions) => Promise<void> | void;
   predictionState?: PredictionState;
@@ -308,6 +312,7 @@ function ReferenceDetailPanel({
             </details>
           ) : null}
           {delegated ? <DelegatedCurationNote delegated={delegated} referenceLineageId={lineageId} /> : countsAsTrainingLabel ? <CountsAsTrainingLabelNote referenceLineageId={lineageId} /> : null}
+          <ReferenceConversation disabledReason={disabled ? "Editor access is required to write messages." : null} lineageId={lineageId} onCount={onMessageCount} referenceId={reference.id} title={referenceDisplayTitle(reference)} />
         </ReviewCard>
 
         <Separator />
@@ -445,6 +450,7 @@ export function NewsroomReferencesView({
   const [view, setView] = useState<ReferenceView>("feed");
   const [addOpen, setAddOpen] = useState(false);
   const [feedTab, setFeedTab] = useState<ReferenceFeedTabKey>("feed");
+  const { counts: messageCounts, setCount: setMessageCount } = useReferenceMessageCounts(!loading);
   const [visitRated, setVisitRated] = useState<ReadonlySet<string>>(() => new Set());
   const [mountedAt] = useState(() => Date.now());
   const markVisitRated = useCallback((lineageId: string) => {
@@ -774,6 +780,7 @@ export function NewsroomReferencesView({
               <ReferenceFeed
                 disabledReason={feedDisabledReason}
                 loading={previewSkeleton || (loading && !references.length)}
+                messageCounts={messageCounts}
                 now={mountedAt}
                 onOpen={selectReference}
                 onRate={rateFromFeed}
@@ -909,6 +916,7 @@ export function NewsroomReferencesView({
               decision={decisions?.get(referenceLineageId(selectedReference))}
               demo={demo}
               disabled={disabled}
+              onMessageCount={setMessageCount}
               onRelevanceReview={onRelevanceReview ? (curation) => onRelevanceReview(selectedReference, curation) : undefined}
               onReview={runReview}
               sectionAgreement={sectionAgreement}
@@ -952,6 +960,7 @@ export function NewsroomReferencesView({
                   demo={demo}
                   disabled={disabled}
                   onClose={closeDetail}
+                  onMessageCount={setMessageCount}
                   onRelevanceReview={onRelevanceReview ? (curation) => onRelevanceReview(selectedReference, curation) : undefined}
                   onReview={runReview}
                   sectionAgreement={sectionAgreement}

package/components/notification-cards.tsx

@@ -9,7 +9,7 @@ import { cannotMoveReason, type DraftChoice } from "../lib/review-drafts";
 import { answerWords, formatWhen, modeLabel, nextText, steeringText, subjectHref, subjectLabel, type ReviewRequest } from "../lib/review-requests";
 import type { ReferencePreview } from "../lib/reference-preview";
 import { FEED_SURFACE_PROPS, FeedImage, PILL, SourceMark } from "./reference-feed";
-import { RatingGrid } from "./review-rating-grid";
+import { DecisionControl } from "./decision-control";
 
 /** What the editor typed with an answer. */
 export type DecisionExtras = { why: string; notThisKind: boolean };
@@ -109,9 +109,9 @@ function DecisionFooter({ busy, decision, disabledReason, error, kind, lockedNot
       {locked ? (
         <>
           <DecidedLine choice={decision.choice} notThisKind={decision.notThisKind} why={decision.why} />
-          <RatingGrid
+          <DecisionControl
             answer={decision.choice} disabled disabledReason={null} feedback={{ phase: "saved" }} onChoose={() => undefined}
-            prediction={{ state: "none" }} showPrediction={false} surface="footer"
+            prediction={{ state: "none" }} showPrediction={false} showReason={false} surface="footer"
           />
           <p className="text-xs text-muted-foreground" data-review-disabled-reason>{lockedNote}</p>
         </>
@@ -132,7 +132,7 @@ function DecisionFooter({ busy, decision, disabledReason, error, kind, lockedNot
             </button>
             <span className="text-xs text-muted-foreground">Optional. Counts if you reject.</span>
           </div>
-          <RatingGrid
+          <DecisionControl
             answer={busy ? pending : null}
             disabled={Boolean(disabledReason)}
             disabledReason={disabledReason}
@@ -140,6 +140,7 @@ function DecisionFooter({ busy, decision, disabledReason, error, kind, lockedNot
             onChoose={choose}
             prediction={{ state: "none" }}
             showPrediction={false}
+            showReason={false}
             surface="footer"
           />
         </>

package/components/reference-conversation.tsx

@@ -0,0 +1,43 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { ConversationThread } from "./conversation-thread";
+import { useConversation } from "./use-conversation";
+
+/**
+ * The Messages about one Reference, under its review card. Shows nothing where no conversation store is provided.
+ * `onCount` tells the feed how many Messages there are, so its card count follows what is written here.
+ */
+export function ReferenceConversation({ disabledReason = null, lineageId, onCount, referenceId, title }: {
+  disabledReason?: string | null;
+  lineageId: string;
+  onCount?: (lineageId: string, count: number) => void;
+  /** The Reference version's id, when it differs from the lineage id. */
+  referenceId?: string;
+  title?: string;
+}) {
+  const conversation = useConversation({ kind: "reference", lineageId, title, ...(referenceId ? { id: referenceId } : {}) });
+  const [now, setNow] = useState(() => Date.now());
+  useEffect(() => {
+    const timer = window.setInterval(() => setNow(Date.now()), 60000);
+    return () => window.clearInterval(timer);
+  }, []);
+  const settled = conversation.messages.filter((message) => !message.pending).length;
+  useEffect(() => {
+    if (conversation.state === "ready") onCount?.(lineageId, settled);
+  }, [conversation.state, lineageId, onCount, settled]);
+  if (!conversation.available) return null;
+  return (
+    <div data-reference-conversation={lineageId}>
+      <ConversationThread
+        disabledReason={disabledReason}
+        error={conversation.error}
+        messages={conversation.messages}
+        now={now}
+        onPost={conversation.post}
+        onRetry={conversation.retry}
+        state={conversation.state}
+      />
+    </div>
+  );
+}

package/components/reference-feed.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { InfoIcon, Loader2Icon } from "lucide-react";
+import { InfoIcon, Loader2Icon, MessageSquareIcon } from "lucide-react";
 import { useEffect, useId, useRef, useState, type CSSProperties, type ReactNode } from "react";
 import type { ReferenceRecord } from "../lib/category-repository";
 import { REFERENCE_REJECTION_REASON_CODES, isAutoAccepted, normalizeReferenceCurationStatus, type ReferenceRejectionReasonCode } from "../lib/reference-policy";
@@ -20,11 +20,12 @@ import { referenceDisplayTitle } from "../lib/newsroom-references";
 import type { RelevanceDecisionView } from "../lib/relevance-decisions";
 import { cn } from "../lib/utils";
 import { predictionFromDecision, type ReviewChoice } from "./reference-review-card";
-import { RatingGrid } from "./review-rating-grid";
+import { DecisionControl } from "./decision-control";
 import { CaptureBadge } from "./reference-capture-panel";
 import { AutoAcceptedBadge } from "./auto-accepted-badge";
 import { useRatingStore, type RatingController } from "./use-reference-ratings";
 import type { CaptureStatus } from "../lib/reference-capture";
+import { messageCountLabel } from "../lib/conversation";
 
 /**
  * Flat surfaces, no borders: the page tone, a card tone one step away from it, a footer tone, and a control tone for chips and
@@ -56,6 +57,8 @@ export type ReferenceFeedProps = {
   disabledReason?: string | null;
   /** True while the first read is in flight: cards are skeletons. */
   loading?: boolean;
+  /** How many Messages each Reference has, by lineage id. A card with none shows no count. */
+  messageCounts?: ReadonlyMap<string, number>;
   now: number;
   onOpen: (lineageId: string) => void;
   onRate: (reference: ReferenceRecord, choice: ReviewChoice, reasonCode: ReferenceRejectionReasonCode | null) => Promise<void> | void;
@@ -201,6 +204,7 @@ export function FeedImage({ host, lead, name, src }: { host: string | null; lead
 
 export function FeedCard({
   capture,
+  messageCount = 0,
   decision,
   disabledReason,
   item,
@@ -216,6 +220,8 @@ export function FeedCard({
 }: {
   /** Optional: the capture badge. */
   capture?: CaptureStatus | undefined;
+  /** Optional: how many Messages this Reference has. */
+  messageCount?: number;
   decision: RelevanceDecisionView | undefined;
   disabledReason: string | null;
   item: FeedItem;
@@ -294,37 +300,34 @@ export function FeedCard({
               {host}
             </span>
             {capture ? <CaptureBadge status={capture} /> : null}
+            {messageCount > 0 ? (
+              <span aria-label={messageCountLabel(messageCount)} className="inline-flex items-center gap-1 tabular-nums" data-feed-message-count={messageCount} role="img">
+                <MessageSquareIcon aria-hidden="true" className="size-3.5" />
+                {messageCount}
+              </span>
+            ) : null}
             {isAutoAccepted(reference) ? <AutoAcceptedBadge actor={reference.curationStatusUpdatedBy} reason={reference.curationStatusReason} /> : null}
           </span>
         </span>
       </button>
 
       <div className="relative bg-[var(--feed-footer)] px-4 pb-4 pt-3" data-feed-actions>
-        <RatingGrid
+        <DecisionControl
           answer={chosen}
           decided={answer}
           disabled={Boolean(disabledReason)}
           disabledReason={disabledReason}
           feedback={feedback}
+          needsReason={rating.askReason}
           note={reasonLabel ? `Reason: ${reasonLabel}` : null}
           onChoose={(choice) => { if (!disabledReason) store.choose(item.lineageId, choice); }}
+          onReasonChange={(text) => store.setNote(item.lineageId, text)}
+          onReasonCommit={() => { if (!disabledReason) store.commitNote(item.lineageId); }}
           prediction={decision ? predictionFromDecision(decision) : predictionLoading ? { state: "loading" } : { state: "none" }}
+          reason={rating.note ?? ""}
+          reasonRequiredFor="reject"
           statusOverlay
         />
-        {rating.askReason ? (
-          // Covers the footer rather than adding to it, so asking for a reason never pushes the cards below it down.
-          <div className="absolute inset-0 z-10 flex flex-col justify-center space-y-2 bg-[var(--feed-footer)] p-3" data-review-reasons>
-            <p className="text-xs font-medium">Reason for rejecting. Choose one to save your Reject.</p>
-            <div className="flex flex-wrap gap-1.5">
-              {REFERENCE_REJECTION_REASON_CODES.map((code) => (
-                <button className={cn(PILL, "min-h-8 bg-[var(--feed-control)] px-3 text-xs")} data-review-reason={code} key={code} onClick={() => store.setReason(item.lineageId, code)} type="button">
-                  {REASON_LABELS[code]}
-                </button>
-              ))}
-              <button className={cn(PILL, "min-h-8 px-3 text-xs text-muted-foreground")} onClick={() => store.cancelReason(item.lineageId)} type="button">Cancel</button>
-            </div>
-          </div>
-        ) : null}
       </div>
     </article>
   );
@@ -398,6 +401,7 @@ export function SectionHeading({ children, id }: { children: ReactNode; id: stri
 export function ReferenceFeed({
   disabledReason = null,
   loading = false,
+  messageCounts,
   now,
   onOpen,
   onRate,
@@ -426,6 +430,7 @@ export function ReferenceFeed({
       item={item}
       key={item.lineageId}
       lead={lead}
+      messageCount={messageCounts?.get(item.lineageId)}
       now={now}
       onOpen={() => onOpen(item.lineageId)}
       onRate={async (reference, choice, reasonCode) => { onVisitRated(item.lineageId); await onRate(reference, choice, reasonCode); }}