@anthusai/papyrus 5.57.0 → 5.59.0

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

@@ -49,8 +49,11 @@ import type {
 import { relationTypeKey, semanticStateKey, semanticVersionKey } from "../lib/semantic-graph";
 import {
   CONVERSATION_FEED_KEY,
+  GENERAL_CONVERSATION_KIND,
   REFERENCE_CONVERSATION_KIND,
   conversationAnchorKey,
+  conversationPreviewLine,
+  threadMetadataWithLastAuthor,
   conversationMessageId,
   conversationThreadId,
   conversationThreadKind,
@@ -58,12 +61,15 @@ import {
   findOrCreateThread,
   type ConversationAnchor,
   type ConversationMessage,
+  type ConversationViewer,
 } from "../lib/conversation";
+import { postMessageArguments, postMessageMutation } from "../lib/post-message";
 import { legacyStageKeysToLoad, type ContentItemVersionRecord } from "../lib/content-item-lifecycle";
 import { getContentItemStageDefinitions } from "../lib/site-brand";
 import { DOCTRINE_DEFINITIONS, getCategoryDoctrineDefinitions, type DoctrineCategory } from "../lib/doctrine";
 import { configureAmplifyClient } from "./amplify-client-provider";
 import { isUnauthenticatedError, loadReaderSessionSnapshot, type ReaderAuthSnapshot } from "./reader-auth-state";
+import { resolveReaderSettings } from "./reader-settings";
 
 const USER_POOL_AUTH_MODE = "userPool";
 const USER_POOL_LIST_LIMIT = 500;
@@ -77,7 +83,7 @@ const REFERENCE_STATUS_KEYS = ["pending", "accepted", "rejected", "archived"] as
 const NEWSROOM_MESSAGE_FEED_QUERY = `
   query ListMessagesByNewsroomFeedAndCreatedAt($newsroomFeedKey: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelMessageFilterInput) {
     listMessagesByNewsroomFeedAndCreatedAt(newsroomFeedKey: $newsroomFeedKey, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
-      items { id messageKind messageDomain status summary source importRunId authorSub authorUserProfileId authorLabel threadId parentMessageId sequenceNumber role messageType content semanticLayer searchVisibility responseTarget responseStatus responseOwner responseStartedAt responseCompletedAt responseError metadata createdAt updatedAt newsroomFeedKey }
+      items { id messageKind messageDomain status summary source importRunId authorSub authorUserProfileId authorLabel editedAt deletedAt deletedBySub threadId parentMessageId sequenceNumber role messageType content semanticLayer searchVisibility responseTarget responseStatus responseOwner responseStartedAt responseCompletedAt responseError metadata createdAt updatedAt newsroomFeedKey }
       nextToken
     }
   }
@@ -136,7 +142,7 @@ const CREATE_SEMANTIC_RELATION_MUTATION = `
 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) {
-      items { id messageKind messageDomain status summary source importRunId authorSub authorUserProfileId authorLabel threadId parentMessageId sequenceNumber role messageType content semanticLayer searchVisibility responseTarget responseStatus responseOwner responseStartedAt responseCompletedAt responseError metadata createdAt updatedAt newsroomFeedKey }
+      items { id messageKind messageDomain status summary source importRunId authorSub authorUserProfileId authorLabel editedAt deletedAt deletedBySub threadId parentMessageId sequenceNumber role messageType content semanticLayer searchVisibility responseTarget responseStatus responseOwner responseStartedAt responseCompletedAt responseError metadata createdAt updatedAt newsroomFeedKey }
       nextToken
     }
   }
@@ -145,7 +151,7 @@ const LIST_MESSAGES_BY_THREAD_AND_SEQUENCE_QUERY = `
 const LIST_MESSAGES_BY_KIND_AND_CREATED_AT_QUERY = `
   query ListMessagesByKindAndCreatedAt($messageKind: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
     listMessagesByKindAndCreatedAt(messageKind: $messageKind, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
-      items { id messageKind messageDomain status summary source importRunId authorSub authorUserProfileId authorLabel threadId parentMessageId sequenceNumber role messageType content semanticLayer searchVisibility responseTarget responseStatus responseOwner responseStartedAt responseCompletedAt responseError metadata createdAt updatedAt newsroomFeedKey }
+      items { id messageKind messageDomain status summary source importRunId authorSub authorUserProfileId authorLabel editedAt deletedAt deletedBySub threadId parentMessageId sequenceNumber role messageType content semanticLayer searchVisibility responseTarget responseStatus responseOwner responseStartedAt responseCompletedAt responseError metadata createdAt updatedAt newsroomFeedKey }
       nextToken
     }
   }
@@ -154,7 +160,7 @@ const LIST_MESSAGES_BY_KIND_AND_CREATED_AT_QUERY = `
 const GET_MESSAGE_QUERY = `
   query GetMessage($id: ID!) {
     getMessage(id: $id) {
-      id messageKind messageDomain status summary source importRunId authorSub authorUserProfileId authorLabel threadId parentMessageId sequenceNumber role messageType content semanticLayer searchVisibility responseTarget responseStatus responseOwner responseStartedAt responseCompletedAt responseError metadata createdAt updatedAt newsroomFeedKey
+      id messageKind messageDomain status summary source importRunId authorSub authorUserProfileId authorLabel editedAt deletedAt deletedBySub threadId parentMessageId sequenceNumber role messageType content semanticLayer searchVisibility responseTarget responseStatus responseOwner responseStartedAt responseCompletedAt responseError metadata createdAt updatedAt newsroomFeedKey
     }
   }
 `;
@@ -219,40 +225,7 @@ const UPDATE_MESSAGE_THREAD_MUTATION = `
   }
 `;
 
-const CREATE_MESSAGE_MUTATION = `
-  mutation CreateMessage($input: CreateMessageInput!) {
-    createMessage(input: $input) {
-      id
-      messageKind
-      messageDomain
-      status
-      summary
-      source
-      importRunId
-      authorSub
-      authorUserProfileId
-      authorLabel
-      threadId
-      parentMessageId
-      sequenceNumber
-      role
-      messageType
-      content
-      semanticLayer
-      searchVisibility
-      responseTarget
-      responseStatus
-      responseOwner
-      responseStartedAt
-      responseCompletedAt
-      responseError
-      metadata
-      createdAt
-      updatedAt
-      newsroomFeedKey
-    }
-  }
-`;
+const POST_MESSAGE_SELECTION = "id messageKind messageDomain status summary source importRunId authorSub authorUserProfileId authorLabel editedAt deletedAt deletedBySub threadId parentMessageId sequenceNumber role messageType content semanticLayer searchVisibility responseTarget responseStatus responseOwner responseStartedAt responseCompletedAt responseError metadata createdAt updatedAt newsroomFeedKey";
 
 const UPDATE_MESSAGE_MUTATION = `
   mutation UpdateMessage($input: UpdateMessageInput!) {
@@ -267,6 +240,9 @@ const UPDATE_MESSAGE_MUTATION = `
       authorSub
       authorUserProfileId
       authorLabel
+      editedAt
+      deletedAt
+      deletedBySub
       threadId
       parentMessageId
       sequenceNumber
@@ -301,7 +277,7 @@ const NEWSROOM_ASSIGNMENT_FEED_QUERY = `
 const NEWSROOM_REFERENCE_FEED_QUERY = `
   query ListReferencesByNewsroomFeedAndCreatedAt($newsroomFeedKey: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelReferenceFilterInput) {
     listReferencesByNewsroomFeedAndCreatedAt(newsroomFeedKey: $newsroomFeedKey, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
-      items { id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason newsroomFeedKey reviewedFeedKey updatedAt }
+      items { id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason curationReasonCode curationActorKind curationSectionId curationShareable curationDelegation curationDecisionRelationId newsroomFeedKey reviewedFeedKey discoveredByMonitorId updatedAt }
       nextToken
     }
   }
@@ -310,7 +286,7 @@ const NEWSROOM_REFERENCE_FEED_QUERY = `
 const NEWSROOM_REFERENCE_IMPORTED_FEED_QUERY = `
   query ListReferencesByNewsroomFeedAndImportedAt($newsroomFeedKey: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelReferenceFilterInput) {
     listReferencesByNewsroomFeedAndImportedAt(newsroomFeedKey: $newsroomFeedKey, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
-      items { id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason newsroomFeedKey reviewedFeedKey updatedAt }
+      items { id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason curationReasonCode curationActorKind curationSectionId curationShareable curationDelegation curationDecisionRelationId newsroomFeedKey reviewedFeedKey discoveredByMonitorId updatedAt }
       nextToken
     }
   }
@@ -319,7 +295,7 @@ const NEWSROOM_REFERENCE_IMPORTED_FEED_QUERY = `
 const LIST_REFERENCES_BY_CURATION_STATUS_AND_UPDATED_AT_QUERY = `
   query ListReferencesByCurationStatusAndUpdatedAt($curationStatus: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelReferenceFilterInput) {
     listReferencesByCurationStatusAndUpdatedAt(curationStatus: $curationStatus, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
-      items { id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason newsroomFeedKey reviewedFeedKey updatedAt }
+      items { id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason curationReasonCode curationActorKind curationSectionId curationShareable curationDelegation curationDecisionRelationId newsroomFeedKey reviewedFeedKey discoveredByMonitorId updatedAt }
       nextToken
     }
   }
@@ -328,7 +304,7 @@ const LIST_REFERENCES_BY_CURATION_STATUS_AND_UPDATED_AT_QUERY = `
 const LIST_REFERENCES_BY_REVIEWED_FEED_AND_UPDATED_AT_QUERY = `
   query ListReferencesByReviewedFeedAndUpdatedAt($reviewedFeedKey: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelReferenceFilterInput) {
     listReferencesByReviewedFeedAndUpdatedAt(reviewedFeedKey: $reviewedFeedKey, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
-      items { id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason newsroomFeedKey reviewedFeedKey updatedAt }
+      items { id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason curationReasonCode curationActorKind curationSectionId curationShareable curationDelegation curationDecisionRelationId newsroomFeedKey reviewedFeedKey discoveredByMonitorId updatedAt }
       nextToken
     }
   }
@@ -337,7 +313,7 @@ const LIST_REFERENCES_BY_REVIEWED_FEED_AND_UPDATED_AT_QUERY = `
 const LIST_REFERENCES_FALLBACK_QUERY = `
   query ListReferencesFallback($limit: Int, $nextToken: String) {
     listReferences(limit: $limit, nextToken: $nextToken) {
-      items { id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason newsroomFeedKey reviewedFeedKey updatedAt }
+      items { id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason curationReasonCode curationActorKind curationSectionId curationShareable curationDelegation curationDecisionRelationId newsroomFeedKey reviewedFeedKey discoveredByMonitorId updatedAt }
       nextToken
     }
   }
@@ -470,7 +446,7 @@ const MODEL_ATTACHMENTS_BY_OWNER_QUERY = `
 
 /** Matches Reference model fields in amplify/data/resource.ts (no metadata on Reference). */
 const REFERENCE_RECORD_GRAPHQL_FIELDS =
-  "id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason newsroomFeedKey reviewedFeedKey updatedAt";
+  "id lineageId versionNumber previousVersionId versionState versionCreatedAt versionCreatedBy changeReason contentHash corpusId externalItemId title authors sourceUri storagePath mediaType byteSize sha256 sourcePublishedAt sourceUpdatedAt retrievedAt inboundCitationCount outboundCitationCount importRunId importedAt createdAt curationStatus curationStatusKey curationStatusUpdatedAt curationStatusUpdatedBy curationStatusReason curationReasonCode curationActorKind curationSectionId curationShareable curationDelegation curationDecisionRelationId newsroomFeedKey reviewedFeedKey discoveredByMonitorId updatedAt";
 
 const LIST_REFERENCES_BY_LINEAGE_AND_VERSION_QUERY = `
   query ListReferencesByLineageAndVersion($lineageId: ID!, $limit: Int, $nextToken: String) {
@@ -1422,7 +1398,7 @@ export async function createSectionForumThreadRecord(input: {
  * 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 }> {
+async function appendMessageToThread(thread: MessageThreadRecord, build: (sequenceNumber: number, now: string) => MessageRecord, threadFields: { summary?: string; metadata?: string } = {}): Promise<{ thread: MessageThreadRecord; message: MessageRecord }> {
   const threadId = thread.id;
   let now = new Date().toISOString();
   let built: MessageRecord | null = null;
@@ -1430,11 +1406,15 @@ async function appendMessageToThread(thread: MessageThreadRecord, build: (sequen
     list: () => listMessagesByThreadId(threadId, 1000),
     create: (sequenceNumber) => {
       now = new Date().toISOString();
-      built = build(sequenceNumber, now);
-      return runGraphql<{ createMessage?: MessageRecord | null }>(CREATE_MESSAGE_MUTATION, { input: built });
+      // `createdAt` is part of the composite sort key of messagesByResponseTargetStatusCreatedAt, so AppSync refuses a Message that
+      // sets it without `responseStatus`. A person's message waits on no responder: COMPLETED, as the Python message contract writes.
+      built = { responseStatus: "COMPLETED", ...build(sequenceNumber, now) };
+      // The backend stamps the author from the signed-in identity (postMessage); nothing here names one.
+      const args = postMessageArguments(built as unknown as Record<string, unknown>);
+      return runGraphql<{ postMessage?: MessageRecord | null }>(postMessageMutation(args, POST_MESSAGE_SELECTION), args);
     },
   });
-  const createdMessage = normalizeMessageRecord(created.createMessage ?? built!);
+  const createdMessage = normalizeMessageRecord(created.postMessage ?? built!);
   const updated = await runGraphql<{ updateMessageThread?: MessageThreadRecord | null }>(
     UPDATE_MESSAGE_THREAD_MUTATION,
     {
@@ -1444,11 +1424,12 @@ async function appendMessageToThread(thread: MessageThreadRecord, build: (sequen
         lastMessageId: createdMessage.id,
         lastMessageAt: createdMessage.createdAt,
         updatedAt: now,
+        ...threadFields,
       },
     },
   );
   return {
-    thread: normalizeThreadRecord(updated.updateMessageThread ?? { ...thread, updatedAt: now }),
+    thread: normalizeThreadRecord(updated.updateMessageThread ?? { ...thread, ...threadFields, updatedAt: now }),
     message: createdMessage,
   };
 }
@@ -1490,7 +1471,7 @@ export async function appendForumThreadMessageRecord(input: {
   }));
 }
 
-type ConversationAuthor = { sub: string | null; label: string };
+type ConversationAuthor = { sub: string | null; label: string; userProfileId: string | null; isAdmin: boolean };
 
 async function currentConversationAuthor(): Promise<ConversationAuthor> {
   const snapshot = await loadReaderSessionSnapshot();
@@ -1502,7 +1483,50 @@ async function currentConversationAuthor(): Promise<ConversationAuthor> {
   } catch {
     sub = null;
   }
-  return { sub, label: snapshot.auth.status === "signedIn" ? snapshot.auth.label : "editor" };
+  const profile = await currentUserProfile();
+  // The author's name travels on the message (other editors cannot read profiles): their display name, else the session's label.
+  const sessionLabel = snapshot.auth.status === "signedIn" ? snapshot.auth.label : "editor";
+  return { sub, label: profile.displayName || sessionLabel, userProfileId: profile.id, isAdmin: snapshot.groups.some((group) => group.trim().toLowerCase() === "admin") };
+}
+
+let userProfileLookup: Promise<{ id: string | null; displayName: string | null }> | null = null;
+/** The signed-in person's profile id and display name (their own profile is readable by them), read once per page load. A failed read is not kept, and does not stop a post. */
+function currentUserProfile(): Promise<{ id: string | null; displayName: string | null }> {
+  userProfileLookup ??= (async () => {
+    const resolution = await resolveReaderSettings();
+    const id = resolution.userProfileId ?? null;
+    if (!id) return { id: null, displayName: null };
+    const names = await loadUserProfileNames([id]);
+    return { id, displayName: names.get(id) ?? null };
+  })().catch(() => { userProfileLookup = null; return { id: null, displayName: null }; });
+  return userProfileLookup;
+}
+
+/** Who is looking at a conversation: their sub, and whether they are an admin. Decided from the session, never from a Message. */
+export async function loadConversationViewer(): Promise<ConversationViewer> {
+  const author = await currentConversationAuthor();
+  return { sub: author.sub, isAdmin: author.isAdmin };
+}
+
+/** Display names by profile id, in one request. A profile this person may not read is left out and its Messages keep the saved label. */
+export async function loadUserProfileNames(profileIds: string[]): Promise<Map<string, string>> {
+  const ids = [...new Set(profileIds.filter(Boolean))];
+  const names = new Map<string, string>();
+  if (!ids.length) return names;
+  const query = `query UserProfileNames { ${ids.map((id, index) => `p${index}: getUserProfile(id: ${JSON.stringify(id)}) { id displayName }`).join(" ")} }`;
+  configureAmplifyClient();
+  const client = generateClient<Schema>() as unknown as { graphql: (options: Record<string, unknown>) => Promise<{ data?: Record<string, { id?: string; displayName?: string | null } | null> | null }> };
+  let data: Record<string, { id?: string; displayName?: string | null } | null> | null | undefined;
+  try {
+    data = (await client.graphql({ query, authMode: USER_POOL_AUTH_MODE })).data;
+  } catch (failure) {
+    // Some of the profiles are refused: the rest of the answer is still good.
+    data = (failure as { data?: typeof data } | null)?.data;
+  }
+  for (const profile of Object.values(data ?? {})) {
+    if (profile?.id && profile.displayName?.trim()) names.set(profile.id, profile.displayName.trim());
+  }
+  return names;
 }
 
 async function findConversationThread(anchorKey: string): Promise<MessageThreadRecord | null> {
@@ -1536,6 +1560,7 @@ export async function ensureConversationThread(anchor: ConversationAnchor, autho
         primaryAnchorLineageId: lineageId,
         primaryAnchorKey: anchorKey,
         createdBySub: author?.sub ?? null,
+        createdByUserProfileId: author?.userProfileId ?? null,
         createdByLabel: author?.label ?? "editor",
         messageCount: 0,
         lastMessageId: null,
@@ -1556,9 +1581,14 @@ function toConversationMessage(record: MessageRecord): ConversationMessage {
     id: record.id,
     parentMessageId: record.parentMessageId ?? null,
     authorLabel: record.authorLabel ?? "",
-    content: record.content ?? record.body ?? "",
+    authorSub: record.authorSub ?? null,
+    authorUserProfileId: record.authorUserProfileId ?? null,
+    content: record.status === "deleted" ? "" : record.content ?? record.body ?? "",
     createdAt: record.createdAt,
     sequenceNumber: Number(record.sequenceNumber ?? 0),
+    editedAt: record.editedAt ?? null,
+    deleted: record.status === "deleted",
+    deletedAt: record.deletedAt ?? null,
   };
 }
 
@@ -1569,7 +1599,7 @@ export async function loadConversationMessages(anchor: ConversationAnchor): Prom
   const thread = await findConversationThread(anchorKey);
   if (!thread) return [];
   const records = await listMessagesByThreadId(thread.id, 500);
-  return records.filter((record) => record.status !== "deleted").map(toConversationMessage);
+  return records.map(toConversationMessage);
 }
 
 /** How many Messages each Reference has, from the Reference conversation threads alone (no query per card). Keyed by lineage id. */
@@ -1591,11 +1621,13 @@ export async function appendConversationMessage(input: {
   anchor: ConversationAnchor;
   body: string;
   parentMessageId?: string | null;
+  /** The conversation to write into, when the caller already holds it (the Messages page). Without it the anchor finds or creates it. */
+  thread?: MessageThreadRecord;
 }): 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 thread = input.thread ?? await ensureConversationThread(input.anchor, author);
   const result = await appendMessageToThread(thread, (sequenceNumber, now) => ({
     id: conversationMessageId(thread.id, sequenceNumber),
     messageKind: "comment",
@@ -1603,7 +1635,6 @@ export async function appendConversationMessage(input: {
     status: "active",
     summary: content.slice(0, 120),
     source: "newsroom.conversation",
-    authorSub: author.sub,
     authorLabel: author.label,
     threadId: thread.id,
     parentMessageId: input.parentMessageId?.trim() || null,
@@ -1615,7 +1646,7 @@ export async function appendConversationMessage(input: {
     createdAt: now,
     updatedAt: now,
     newsroomFeedKey: CONVERSATION_FEED_KEY,
-  }));
+  }), { summary: conversationPreviewLine(content), metadata: threadMetadataWithLastAuthor(thread.metadata, author.label) });
   let relationError: string | null = null;
   if (input.anchor.kind !== "none") {
     try {
@@ -1627,6 +1658,124 @@ export async function appendConversationMessage(input: {
   return { message: toConversationMessage(result.message), thread: result.thread, relationError };
 }
 
+/** One page of conversation threads of a kind, newest activity first. */
+export async function loadConversationThreadPage(threadKind: string, nextToken: string | null, limit = 20): Promise<{ items: MessageThreadRecord[]; nextToken: string | null }> {
+  type ThreadConnectionResponse = { listMessageThreadsByKindAndUpdatedAt?: { items?: Array<MessageThreadRecord | null> | null; nextToken?: string | null } | null };
+  const response = await runGraphql<ThreadConnectionResponse>(LIST_MESSAGE_THREADS_BY_KIND_AND_UPDATED_AT_QUERY, { threadKind, sortDirection: "DESC", limit, nextToken });
+  const connection = response.listMessageThreadsByKindAndUpdatedAt;
+  const items = ((connection?.items ?? []).filter(Boolean) as MessageThreadRecord[]).map(normalizeThreadRecord).filter((thread) => thread.status !== "deleted");
+  return { items, nextToken: connection?.nextToken ?? null };
+}
+
+/** Every Message in a conversation thread, oldest first. */
+export async function loadConversationThreadMessages(threadId: string): Promise<ConversationMessage[]> {
+  const records = await listMessagesByThreadId(threadId, 500);
+  return records.map(toConversationMessage);
+}
+
+/** Starts a conversation about nothing but itself: its own thread, and its first Message. */
+export async function startUnattachedConversation(title: string, body: string): Promise<{ message: ConversationMessage; thread: MessageThreadRecord }> {
+  const content = String(body || "").trim();
+  const heading = String(title || "").trim();
+  if (!heading) throw new Error("Give the conversation a title.");
+  if (!content) throw new Error("Write something to post.");
+  const author = await currentConversationAuthor();
+  const now = new Date().toISOString();
+  const id = `message-thread-conversation-new-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+  const thread: MessageThreadRecord = {
+    id,
+    threadKind: GENERAL_CONVERSATION_KIND,
+    status: "active",
+    title: heading.slice(0, 120),
+    createdBySub: author.sub,
+    createdByUserProfileId: author.userProfileId,
+    createdByLabel: author.label,
+    messageCount: 0,
+    lastMessageId: null,
+    lastMessageAt: null,
+    metadata: JSON.stringify({ anchorKind: "none" }),
+    createdAt: now,
+    updatedAt: now,
+    newsroomFeedKey: CONVERSATION_FEED_KEY,
+  };
+  const created = await runGraphql<{ createMessageThread?: MessageThreadRecord | null }>(CREATE_MESSAGE_THREAD_MUTATION, { input: thread });
+  const saved = normalizeThreadRecord(created.createMessageThread ?? thread);
+  const result = await appendConversationMessage({ anchor: { kind: "none" }, body: content, thread: saved });
+  return { message: result.message, thread: result.thread };
+}
+
+const GET_MESSAGE_THREAD_QUERY = `
+  query GetMessageThread($id: ID!) {
+    getMessageThread(id: $id) {
+      id threadKind status title summary primaryAnchorKind primaryAnchorId primaryAnchorLineageId primaryAnchorKey createdBySub createdByUserProfileId createdByLabel messageCount lastMessageId lastMessageAt contextDigest activeResponseMessageId responseLockOwner responseLockExpiresAt metadata createdAt updatedAt newsroomFeedKey
+    }
+  }
+`;
+
+const MESSAGE_ACTION_SELECTION = "id messageKind messageDomain status summary source importRunId authorSub authorUserProfileId authorLabel editedAt deletedAt deletedBySub threadId parentMessageId sequenceNumber role messageType content semanticLayer searchVisibility responseTarget responseStatus responseOwner responseStartedAt responseCompletedAt responseError metadata createdAt updatedAt newsroomFeedKey";
+
+/** The author changes the text of their own Message. The backend (editMessage) checks the stored author against the signed-in user and records when. */
+export async function editConversationMessage(messageId: string, body: string): Promise<ConversationMessage> {
+  const content = String(body || "").trim();
+  if (!content) throw new Error("A message cannot be empty.");
+  const updated = await runGraphql<{ editMessage?: MessageRecord | null }>(
+    `mutation EditMessage($id: ID!, $content: String!, $summary: String) { editMessage(id: $id, content: $content, summary: $summary) { ${MESSAGE_ACTION_SELECTION} } }`,
+    { id: messageId, content, summary: content.slice(0, 120) },
+  );
+  if (!updated.editMessage) throw new Error("The message was not saved.");
+  return toConversationMessage(normalizeMessageRecord(updated.editMessage));
+}
+
+/**
+ * Deletes a Message softly: it stays (so its replies keep their place) marked deleted, with when and by whom. Nothing is removed.
+ * An author deletes their own (deleteOwnMessage); an admin deleting someone else's moderates it (moderateMessage). The backend decides.
+ */
+export async function deleteConversationMessage(messageId: string, moderate = false): Promise<ConversationMessage> {
+  const field = moderate ? "moderateMessage" : "deleteOwnMessage";
+  const updated = await runGraphql<Record<string, MessageRecord | null | undefined>>(
+    `mutation DeleteMessage($id: ID!) { ${field}(id: $id) { ${MESSAGE_ACTION_SELECTION} } }`,
+    { id: messageId },
+  );
+  const record = updated[field];
+  if (!record) throw new Error("The message was not deleted.");
+  return toConversationMessage(normalizeMessageRecord(record));
+}
+
+/** One conversation thread by id (a linked address), or null when there is none or it was removed. */
+export async function loadConversationThread(threadId: string): Promise<MessageThreadRecord | null> {
+  const response = await runGraphql<{ getMessageThread?: MessageThreadRecord | null }>(GET_MESSAGE_THREAD_QUERY, { id: threadId });
+  const thread = response.getMessageThread ? normalizeThreadRecord(response.getMessageThread) : null;
+  return thread && thread.status !== "deleted" ? thread : null;
+}
+
+/** Gives a conversation a new title. Nothing else about the thread changes. */
+export async function renameConversationThread(thread: MessageThreadRecord, title: string): Promise<MessageThreadRecord> {
+  const next = String(title || "").trim();
+  if (!next) throw new Error("A title cannot be empty.");
+  // renameThread (the backend): only the person who started the conversation, or an admin.
+  const updated = await runGraphql<{ renameThread?: MessageThreadRecord | null }>(
+    `mutation RenameThread($id: ID!, $title: String!) { renameThread(id: $id, title: $title) { id threadKind status title summary primaryAnchorKind primaryAnchorId primaryAnchorLineageId primaryAnchorKey createdBySub createdByUserProfileId createdByLabel messageCount lastMessageId lastMessageAt contextDigest activeResponseMessageId responseLockOwner responseLockExpiresAt metadata createdAt updatedAt newsroomFeedKey } }`,
+    { id: thread.id, title: next.slice(0, 120) },
+  );
+  return normalizeThreadRecord(updated.renameThread ?? { ...thread, title: next.slice(0, 120) });
+}
+
+/** The title and editorial stage of each Story, by lineage id. A Story that cannot be read has no entry. */
+export async function loadStoryHeaders(lineageIds: string[]): Promise<Map<string, { title: string; stage: string | null }>> {
+  const headers = new Map<string, { title: string; stage: string | null }>();
+  await Promise.all([...new Set(lineageIds)].map(async (lineageId) => {
+    try {
+      type Response = { listItemsByLineageAndVersion?: { items?: Array<{ versionNumber?: number | null; headline?: string | null; title?: string | null; stage?: string | null } | null> | null } | null };
+      const response = await runGraphql<Response>(`query StoryHeader($lineageId: ID!) { listItemsByLineageAndVersion(lineageId: $lineageId, limit: 50) { items { versionNumber headline title stage } } }`, { lineageId });
+      const items = (response.listItemsByLineageAndVersion?.items ?? []).filter(Boolean) as Array<{ versionNumber?: number | null; headline?: string | null; title?: string | null; stage?: string | null }>;
+      const newest = items.sort((left, right) => (right.versionNumber ?? 0) - (left.versionNumber ?? 0))[0];
+      const title = newest?.headline || newest?.title;
+      if (title) headers.set(lineageId, { title, stage: newest?.stage ?? null });
+    } catch { /* a Story that cannot be read keeps the title the thread was started with */ }
+  }));
+  return headers;
+}
+
 async function createCommentRelation(message: MessageRecord, anchor: ConversationAnchor): Promise<void> {
   if (anchor.kind === "none") return;
   const lineageId = anchor.lineageId.trim();
@@ -1843,10 +1992,17 @@ async function runGraphql<T extends Record<string, unknown>>(
   const client = generateClient<Schema>() as unknown as {
     graphql: (options: Record<string, unknown>) => Promise<{ data?: T | null; errors?: unknown[] | null }>;
   };
+  // The Amplify client rejects with the raw `{ data, errors }` response when the API returns errors; turn that into an
+  // Error carrying the API's own words, so a refusal is said in words instead of as an unknown failure.
   const response = await client.graphql({
     query,
     variables,
     authMode: USER_POOL_AUTH_MODE,
+  }).catch((failure: unknown) => {
+    if (failure && typeof failure === "object" && Array.isArray((failure as { errors?: unknown }).errors)) {
+      assertNoGraphQLErrors((failure as { errors: unknown[] }).errors);
+    }
+    throw failure;
   });
   assertNoGraphQLErrors(response.errors);
   return (response.data ?? {}) as T;
@@ -2082,17 +2238,15 @@ export async function loadEditorReferenceReviewDetails(lineageId: string) {
   configureAmplifyClient();
   const testMock = getTestEditorNewsroomMock();
   return loadReferenceReviewDetails(lineageId, {
-    relations: async (direction) => {
+    relations: async () => {
       if (testMock?.semanticRelations) return testMock.semanticRelations;
       return loadSemanticRelationsByState({
-        field: direction === "outgoing" ? "listSemanticRelationsBySubjectState" : "listSemanticRelationsByObjectState",
-        keyName: direction === "outgoing" ? "subjectStateKey" : "objectStateKey",
+        field: "listSemanticRelationsBySubjectState",
+        keyName: "subjectStateKey",
         keyValue: `reference#${lineageId}#current`,
-        query: direction === "outgoing" ? LIST_SEMANTIC_RELATIONS_BY_SUBJECT_STATE_QUERY : LIST_SEMANTIC_RELATIONS_BY_OBJECT_STATE_QUERY,
+        query: LIST_SEMANTIC_RELATIONS_BY_SUBJECT_STATE_QUERY,
       });
     },
-    message: async (id) => testMock?.messages ? testMock.messages.find((message) => message.id === id) ?? null : getMessageRecordById(id),
-    payloads: (id) => loadModelPayloadsForOwner("message", id, ["metadata"]),
   });
 }
 

package/components/newsroom-article-editor.tsx

@@ -513,10 +513,15 @@ export function NewsroomArticleEditor({ articleId, demo, embedded = false }: { a
     }
     if (!editor) {
       return (
-        <div aria-label="Loading article" className="space-y-5" role="status">
-          <div className="h-8 w-2/3 rounded bg-muted" />
-          <div className="grid gap-4 sm:grid-cols-2"><div className="h-12 rounded bg-muted" /><div className="h-12 rounded bg-muted" /></div>
-          <div className="h-64 rounded-xl border bg-card p-4"><div className="h-4 w-5/6 rounded bg-muted" /><div className="mt-3 h-4 w-3/4 rounded bg-muted" /></div>
+        // The same blocks, in the same order and heights, as the loaded editor (toolbar, then fields, tabs and the preview card),
+        // so nothing moves when the article arrives. The heights live in newsroom-organizer.css (data-skeleton-*).
+        <div aria-label="Loading article" aria-busy="true" className="space-y-4" data-newsroom-article-skeleton role="status">
+          <div className="rounded-md bg-muted" data-skeleton-toolbar />
+          <div className="grid gap-6">
+            <div className="rounded-md bg-muted" data-skeleton-fields />
+            <div className="h-10 w-72 max-w-full rounded-md bg-muted" data-skeleton-tabs />
+            <div className="rounded-xl bg-muted" data-skeleton-preview />
+          </div>
         </div>
       );
     }
@@ -568,6 +573,7 @@ export function NewsroomArticleEditor({ articleId, demo, embedded = false }: { a
               <Badge data-newsroom-article-version variant="outline">{`Version ${editor.versionNumber}`}</Badge>
             ) : null}
             <Badge
+              className="min-w-[8.5rem] justify-center"
               data-newsroom-article-validity={validation.status}
               variant={validation.status === "valid" ? "secondary" : invalid ? "outline" : "muted"}
             >

package/components/newsroom-organizer.css

@@ -54,7 +54,16 @@ body:has(.newsroom-organizer)>[data-staging-banner]{flex-shrink:0}
 .organizer-board-body{position:relative;display:grid;grid-template-columns:minmax(0,1fr);flex:1;min-width:0;min-height:0;gap:16px}
 .organizer-board-body[data-detail-open=true]{grid-template-columns:minmax(0,1fr) clamp(320px,34vw,1000px)}
 .organizer-board-body>.kb-issue-collection{height:100%;min-height:0;overflow:auto}
-.organizer-board-body>.kb-issue-detail{overflow:auto;min-height:0}
+/* The detail view is a solid surface from its first frame: the theme's panel token (opaque), with the card token as a fallback if
+   a theme has not defined it yet, and never any opacity animation, so the board never shows through it while it loads. */
+.organizer-board-body>.kb-issue-detail{overflow:auto;min-height:0;position:relative;z-index:2;opacity:1;background-color:var(--kb-theme-panel,var(--card,Canvas));isolation:isolate}
+/* One stable shape while an article loads and after: the preview card (and its skeleton) reserve the same height, so the page below it does not move. */
+.newsroom-embedded-article :is([data-newsroom-article-preview],[data-skeleton-preview]){min-height:min(28rem,55dvh)}
+/* The loading skeleton is the loaded editor's size block for block: the toolbar wraps onto more rows as the panel narrows (a container query,
+   because the panel's width, not the window's, decides), and the three fields stack when it is narrow. */
+[data-skeleton-toolbar]{height:44px}[data-skeleton-fields]{height:76px}[data-skeleton-preview]{height:min(28rem,55dvh)}
+@container (max-width:719px){[data-skeleton-toolbar]{height:80px}}
+@container (max-width:399px){[data-skeleton-toolbar]{height:116px}[data-skeleton-fields]{height:208px}}
 .organizer-board-body .kb-issue-detail a:not(.organizer-header-button){display:block;min-height:44px;text-decoration:underline;padding:12px 0}
 .organizer-menu{height:min(85dvh,760px);max-height:85dvh;display:flex;flex-direction:column;padding:16px;border-radius:24px 24px 0 0;gap:20px}
 .organizer-menu .organizer-destinations{overflow-y:auto}.organizer-menu .organizer-destinations section{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}.organizer-menu .organizer-destinations h3{grid-column:1/-1;font-size:12px;text-transform:none;margin:0 0 4px}
@@ -401,11 +410,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 +453,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; }