@anthusai/papyrus 1.9.0 → 1.11.0

package/lib/newsroom-assignments.ts

@@ -18,6 +18,19 @@ export type AssignmentMetrics = {
   canceled: number;
 };
 
+export const BOOKKEEPING_ASSIGNMENT_TYPE_KEYS: ReadonlySet<string> = new Set([
+  "analysis.reindex",
+  "curation.reference-intake",
+  "reference.corpus-accession",
+  "reference.identifier-backfill",
+  "reference.doi-backfill",
+  "reference.text-extraction",
+]);
+
+export function isEditorialWorkAssignment(assignment: Pick<AssignmentRecord, "assignmentTypeKey">): boolean {
+  return !BOOKKEEPING_ASSIGNMENT_TYPE_KEYS.has(assignment.assignmentTypeKey?.trim() ?? "");
+}
+
 export function assignmentTypeKeyForFilter(assignment: AssignmentRecord): string {
   return assignment.assignmentTypeKey?.trim() || "unknown";
 }

package/lib/newsroom-board.ts

@@ -9,6 +9,7 @@ import {
   latestVersionPerContentItem,
   type ContentItemVersionRecord,
 } from "./content-item-lifecycle";
+import { contentItemExcerpt } from "./front-matter-fields";
 import { assignmentStatusLabel } from "./newsroom-assignments";
 import { getContentItemName, getContentItemStageDefinitions } from "./site-brand";
 
@@ -18,6 +19,8 @@ export interface NativeBoardIssue extends KanbanIssue {
   nativeId: string;
   nativeStatus: string;
   href: string;
+  /** A few lines to show under the headline: the blurb, else the subtitle. */
+  excerpt?: string;
 }
 
 export function contentItemBoardPathSegment(): string {
@@ -57,6 +60,7 @@ export function projectContentItemBoard(records: {
       title: version.headline || version.title || version.slug, nativeStatus: stage, status: `${contentItemType}/${stage}`,
       priority: 2, description: workCount ? `${workCount} assignment${workCount === 1 ? "" : "s"} on this ${contentItemType}.` : undefined,
       updated_at: version.updatedAt ?? undefined, href: `/newsroom/articles/${encodeURIComponent(version.id)}`,
+      excerpt: contentItemExcerpt(version),
     };
   });
 }

package/lib/newsroom-forum-routes.ts

@@ -1,7 +1,6 @@
 import { toPublicNewsroomPath } from "./newsroom-base-path";
 
 export const FORUM_THREAD_ROUTE_PREFIX = "/newsroom/forum/";
-export const INSIGHT_THREAD_ROUTE_PREFIX = "/newsroom/insights/";
 export const FORUM_MESSAGE_HASH_PREFIX = "message-";
 
 export function isForumThreadId(id: string | null | undefined): boolean {
@@ -9,11 +8,6 @@ export function isForumThreadId(id: string | null | undefined): boolean {
   return value.startsWith("message-thread-");
 }
 
-export function isInsightThreadId(id: string | null | undefined): boolean {
-  const value = String(id ?? "").trim();
-  return Boolean(value) && !isForumThreadId(value);
-}
-
 export function getForumMessageAnchorId(messageId: string): string {
   return `${FORUM_MESSAGE_HASH_PREFIX}${encodeURIComponent(messageId.trim())}`;
 }
@@ -33,7 +27,7 @@ export function parseForumMessageAnchorFromHash(hash: string | null | undefined)
 export type ParsedNewsroomForumRoute = {
   threadId: string | null;
   messageId: string | null;
-  surface: "edition_forum" | "insight_forum" | null;
+  surface: "edition_forum" | null;
 };
 
 export function parseNewsroomForumRoute(pathname: string, hash?: string | null): ParsedNewsroomForumRoute {
@@ -43,13 +37,6 @@ export function parseNewsroomForumRoute(pathname: string, hash?: string | null):
     return { threadId: null, messageId: parseForumMessageAnchorFromHash(hash), surface: null };
   }
   const tail = segments.slice(newsroomIndex + 1);
-  if (tail[0] === "insights" && tail[1]) {
-    return {
-      threadId: decodeURIComponent(tail[1]),
-      messageId: parseForumMessageAnchorFromHash(hash),
-      surface: "insight_forum",
-    };
-  }
   if (tail[0] === "forum" && tail[1]) {
     return {
       threadId: decodeURIComponent(tail[1]),
@@ -86,24 +73,11 @@ export function buildForumThreadUrl(
   return toPublicNewsroomPath(`/newsroom/forum/${encodedThreadId}${query ? `?${query}` : ""}${hash ? `#${hash}` : ""}`);
 }
 
-export function buildInsightThreadUrl(
-  threadId: string,
-  options?: { messageId?: string | null; demo?: boolean },
-): string {
-  const encodedThreadId = encodeURIComponent(threadId.trim());
-  const params = new URLSearchParams();
-  if (options?.demo) params.set("demo", "1");
-  const query = params.toString();
-  const hash = options?.messageId ? getForumMessageAnchorId(options.messageId) : "";
-  return toPublicNewsroomPath(`${INSIGHT_THREAD_ROUTE_PREFIX}${encodedThreadId}${query ? `?${query}` : ""}${hash ? `#${hash}` : ""}`);
-}
-
 export function buildThreadUrlForSurface(
   surface: ParsedNewsroomForumRoute["surface"],
   threadId: string,
   options?: { messageId?: string | null; demo?: boolean },
 ): string {
-  if (surface === "insight_forum") return buildInsightThreadUrl(threadId, options);
   return buildForumThreadUrl(threadId, options);
 }
 
@@ -122,7 +96,7 @@ export function pushForumThreadUrl(
   const surface = options?.surface ?? readCurrentForumRoute().surface;
   const url = threadId
     ? buildThreadUrlForSurface(surface, threadId, options)
-    : (surface === "insight_forum" ? buildNewsroomInsightsIndexUrl(options?.demo) : buildNewsroomForumIndexUrl(options?.demo));
+    : buildNewsroomForumIndexUrl(options?.demo);
   const current = `${window.location.pathname}${window.location.search}${window.location.hash}`;
   if (current === url) return;
   if (options?.replace) {
@@ -132,24 +106,9 @@ export function pushForumThreadUrl(
   }
 }
 
-export function pushInsightThreadUrl(
-  threadId: string | null,
-  options?: { messageId?: string | null; demo?: boolean; replace?: boolean },
-) {
-  pushForumThreadUrl(threadId, { ...options, surface: "insight_forum" });
-}
-
 export function buildNewsroomForumIndexUrl(demo?: boolean): string {
   const params = new URLSearchParams();
   if (demo) params.set("demo", "1");
   const query = params.toString();
   return toPublicNewsroomPath(query ? `/newsroom?${query}` : "/newsroom");
 }
-
-export function buildNewsroomInsightsIndexUrl(demo?: boolean, domain?: string): string {
-  const params = new URLSearchParams();
-  if (demo) params.set("demo", "1");
-  if (domain?.trim()) params.set("domain", domain.trim());
-  const query = params.toString();
-  return toPublicNewsroomPath(query ? `/newsroom/insights?${query}` : "/newsroom/insights");
-}

package/lib/newsroom-index-filters.ts

@@ -1,12 +1,11 @@
 import { browserPathToInternalNewsroomPath, toPublicNewsroomPath } from "./newsroom-base-path";
-export type NewsroomIndexTab = "references" | "messages" | "assignments" | "insights";
+export type NewsroomIndexTab = "references" | "messages" | "assignments";
 
 export type ReferenceIndexOrder = "published" | "imported";
 
 export type ReferencesIndexFilters = { status: string; processing: string; order: ReferenceIndexOrder };
 export type MessagesIndexFilters = { kind: string; domain: string };
 export type AssignmentsIndexFilters = { status: string; type: string; view: string };
-export type InsightsIndexFilters = { domain: string };
 
 export const DEFAULT_REFERENCES_INDEX_FILTERS: ReferencesIndexFilters = {
   status: "exclude-pending",
@@ -25,10 +24,6 @@ export const DEFAULT_ASSIGNMENTS_INDEX_FILTERS: AssignmentsIndexFilters = {
   view: "queue",
 };
 
-export const DEFAULT_INSIGHTS_INDEX_FILTERS: InsightsIndexFilters = {
-  domain: "",
-};
-
 export function referencesStatusFromUrl(value: string): string {
   return value === "exclude-pending" ? "__exclude_pending" : value;
 }
@@ -72,12 +67,6 @@ export function effectiveAssignmentsIndexFilters(partial?: Partial<AssignmentsIn
   };
 }
 
-export function effectiveInsightsIndexFilters(partial?: Partial<InsightsIndexFilters>): InsightsIndexFilters {
-  return {
-    domain: partial?.domain?.trim() ?? DEFAULT_INSIGHTS_INDEX_FILTERS.domain,
-  };
-}
-
 export function readReferencesIndexFilters(searchParams: URLSearchParams): ReferencesIndexFilters {
   const statusParam = searchParams.get("status")?.trim() ?? "";
   const orderParam = searchParams.get("order")?.trim();
@@ -103,12 +92,6 @@ export function readAssignmentsIndexFilters(searchParams: URLSearchParams): Assi
   });
 }
 
-export function readInsightsIndexFilters(searchParams: URLSearchParams): InsightsIndexFilters {
-  return effectiveInsightsIndexFilters({
-    domain: searchParams.get("domain")?.trim() ?? undefined,
-  });
-}
-
 export function buildReferencesIndexQuery(filters: ReferencesIndexFilters): string {
   const params = new URLSearchParams();
   if (filters.status && filters.status !== DEFAULT_REFERENCES_INDEX_FILTERS.status) {
@@ -137,26 +120,18 @@ export function buildAssignmentsIndexQuery(filters: AssignmentsIndexFilters): st
   return query ? `?${query}` : "";
 }
 
-export function buildInsightsIndexQuery(filters: InsightsIndexFilters): string {
-  const params = new URLSearchParams();
-  if (filters.domain.trim()) params.set("domain", filters.domain.trim());
-  const query = params.toString();
-  return query ? `?${query}` : "";
-}
-
 export function buildNewsroomIndexWebPath(
   tab: NewsroomIndexTab,
-  filters: ReferencesIndexFilters | MessagesIndexFilters | AssignmentsIndexFilters | InsightsIndexFilters,
+  filters: ReferencesIndexFilters | MessagesIndexFilters | AssignmentsIndexFilters,
 ): string {
   if (tab === "references") return toPublicNewsroomPath(`/newsroom/references${buildReferencesIndexQuery(filters as ReferencesIndexFilters)}`);
   if (tab === "messages") return toPublicNewsroomPath(`/newsroom/messages${buildMessagesIndexQuery(filters as MessagesIndexFilters)}`);
-  if (tab === "insights") return toPublicNewsroomPath(`/newsroom/insights${buildInsightsIndexQuery(filters as InsightsIndexFilters)}`);
   return toPublicNewsroomPath(`/newsroom/assignments${buildAssignmentsIndexQuery(filters as AssignmentsIndexFilters)}`);
 }
 
 export function syncBrowserNewsroomIndexUrl(
   tab: NewsroomIndexTab,
-  filters: ReferencesIndexFilters | MessagesIndexFilters | AssignmentsIndexFilters | InsightsIndexFilters,
+  filters: ReferencesIndexFilters | MessagesIndexFilters | AssignmentsIndexFilters,
   options?: { replace?: boolean },
 ) {
   if (typeof window === "undefined") return;
@@ -192,15 +167,3 @@ export function parseAssignmentIdFromNewsroomPathname(pathname: string | null |
     return segment;
   }
 }
-
-export function parseInsightThreadIdFromNewsroomPathname(pathname: string | null | undefined): string | null {
-  const internalPathname = pathname ? browserPathToInternalNewsroomPath(pathname) : null;
-  if (!internalPathname?.startsWith("/newsroom/insights/")) return null;
-  const segment = internalPathname.slice("/newsroom/insights/".length).split("/")[0]?.trim() ?? "";
-  if (!segment) return null;
-  try {
-    return decodeURIComponent(segment);
-  } catch {
-    return segment;
-  }
-}

package/lib/newsroom-media-backend.ts

@@ -1,6 +1,8 @@
 import { generateClient } from "aws-amplify/data";
 import { getUrl, uploadData } from "aws-amplify/storage";
 import type { Schema } from "../amplify/data/resource";
+import { isLocalPreviewEnabled } from "./local-preview";
+import { createLocalPreviewMediaAssets } from "./local-preview-seed";
 import type { MediaAssetFields, MediaAssetRecord, NewsroomMediaBackend } from "./newsroom-media";
 
 type MediaListPage = {
@@ -113,6 +115,8 @@ export function createDemoMediaBackend(): NewsroomMediaBackend {
       rows.set(fields.itemId, [...(rows.get(fields.itemId) ?? []), fields]);
     },
     async listMediaAssets(itemId) {
+      const previewRows = createLocalPreviewMediaAssets(itemId);
+      if (previewRows.length) return previewRows;
       return (rows.get(itemId) ?? []).map((fields) => ({
         id: fields.id,
         sortKey: fields.sortKey,
@@ -122,6 +126,7 @@ export function createDemoMediaBackend(): NewsroomMediaBackend {
       }));
     },
     async imageUrl(storagePath) {
+      if (isLocalPreviewEnabled() && storagePath.startsWith("media/")) return `/api/local-preview/media?key=${encodeURIComponent(storagePath)}`;
       const object = objects.get(storagePath);
       if (!object) throw new Error(`No demo object at ${storagePath}.`);
       return URL.createObjectURL(object);

package/lib/newsroom-nav.ts

@@ -5,7 +5,6 @@ export type NewsroomNavTabId =
   | "overview"
   | "articles"
   | "messages"
-  | "insights"
   | "assignments"
   | "references"
   | "topics"
@@ -28,9 +27,8 @@ export const NEWSROOM_OPS_NAV: NewsroomNavItem[] = [
   { id: "assignments", label: "Assignments", detail: "Work queue", href: newsroomHref("assignments"), mobilePrimary: true },
   { id: "references", label: "References", detail: "Knowledge base", href: newsroomHref("references"), mobilePrimary: true },
   { id: "messages", label: "Messages", detail: "Forum", href: newsroomHref("messages") },
-  { id: "insights", label: "Insights", detail: "Research threads", href: newsroomHref("insights") },
   { id: "topics", label: "Topics", detail: "Taxonomy", href: newsroomHref("topics"), mobilePrimary: true },
-  { id: "concepts", label: "Concepts", detail: "Ontology", href: newsroomHref("concepts") },
+  { id: "concepts", label: "Concept wiki", detail: "Knowledge graph", href: newsroomHref("concepts") },
   { id: "search", label: "Search", detail: "Knowledge base", href: newsroomHref("search") },
   { id: "administration", label: "Administration", detail: "Users & policies", href: newsroomHref("administration") },
 ];

package/lib/newsroom-organizer-nav.ts

@@ -8,29 +8,22 @@ export type OrganizerDestination = {
 };
 export const ORGANIZER_NAV_GROUPS: readonly { title: string; items: readonly OrganizerDestination[] }[] = [
   { title: "Editorial work", items: [
-    { key: "overview", label: "Overview", description: "See the desk and choose where to begin.", path: "/newsroom", primary: true },
     { key: "articles", label: getContentItemName().plural, description: `Follow ${contentItemPluralLowercase} across their stages and open one to write or revise it.`, path: `/newsroom/${contentItemBoardPathSegment()}`, alsoActiveOnPaths: ["/newsroom/articles"], primary: true },
     { key: "assignments", label: "Assignments", description: "Follow research and reporting work across its statuses and claim it.", path: "/newsroom/assignments" },
     { key: "messages", label: "Messages", description: "Read and reply to newsroom conversations.", path: "/newsroom/messages", primary: true },
-    { key: "insights", label: "Insights", description: "Discuss findings and research threads.", path: "/newsroom/insights" },
   ] },
   { title: "Research & knowledge", items: [
     { key: "references", label: "References", description: "Inspect sources and make editorial inclusion decisions.", path: "/newsroom/references", primary: true },
-    { key: "desks", label: "Taxonomy", description: "Maintain topic sets and category versions.", path: "/newsroom/desks" },
-    { key: "topics", label: "Topic proposals", description: "Review suggested changes to coverage.", path: "/newsroom/topics" },
-    { key: "concepts", label: "Concepts", description: "Explore knowledge entities and relationships.", path: "/newsroom/concepts" },
-    { key: "search", label: "Knowledge search", description: "Find evidence across the knowledge base.", path: "/newsroom/search" },
+    { key: "concepts", label: "Concepts", description: "A wiki of the entities in the knowledge graph.", path: "/newsroom/concepts" },
+    { key: "sections", label: "Sections", description: "Organize the publication’s sections and its ontology.", path: "/newsroom/administration/sections" },
+    { key: "desks", label: "Taxonomy", description: "Maintain topic sets and category versions, and review topic proposals.", path: "/newsroom/desks", alsoActiveOnPaths: ["/newsroom/topics"] },
   ] },
   { title: "Administration", items: [
-    { key: "policies", label: "Policies", description: "Set publication and category guidance.", path: "/newsroom/administration/policies" },
-    { key: "sections", label: "Sections", description: "Organize the publication’s sections.", path: "/newsroom/administration/sections" },
-    { key: "procedures", label: "Procedures", description: "Manage procedure definitions and versions.", path: "/newsroom/administration/procedures", access: "admin" },
-    { key: "users", label: "Users & identity merging", description: "Review people, roles and identity merges.", path: "/newsroom/administration/users", access: "admin" },
-    { key: "administration", label: "Administration", description: "Open the existing CMS settings workspace.", path: "/newsroom/administration" },
+    { key: "administration", label: "Administration", description: "Policies, procedures, users and settings.", path: "/newsroom/administration", alsoActiveOnPaths: ["/newsroom/administration/policies", "/newsroom/administration/procedures", "/newsroom/administration/users"] },
   ] },
 ];
 const all = ORGANIZER_NAV_GROUPS.flatMap(group => group.items);
-export const ORGANIZER_PRIMARY_NAV = ["overview", "articles", "references", "messages"].map(key => all.find(item => item.key === key)!);
+export const ORGANIZER_PRIMARY_NAV = ["articles", "references", "messages"].map(key => all.find(item => item.key === key)!);
 
 export const ORGANIZER_SETTINGS_DESTINATION = {
   label: "Settings", path: "/newsroom/settings", description: "Theme, motion and interface preferences.",

package/lib/newsroom-section-routing.ts

@@ -13,7 +13,7 @@ export function resolveNewsDeskTab(
     : raw === "desks" && !organizer ? "topics" : raw;
   switch (value) {
     case "desks": case "administration": case "topics": case "concepts":
-    case "references": case "insights": case "messages": case "assignments": case "search":
+    case "references": case "messages": case "assignments": case "search":
       return value;
     default: return "overview";
   }

package/lib/newsroom-sections.ts

@@ -50,3 +50,15 @@ export function displayNewsroomSectionShortTitle(section: NewsroomSectionRecord)
 export function buildNewsroomSectionHref(sectionId: string, demo?: boolean): string {
   return getNewsroomNavHref(`/newsroom/sections/${encodeURIComponent(sectionId)}`, demo);
 }
+
+export type NewsroomDeskKind = "core" | "rotating";
+export type NewsroomDeskOption = { value: string; label: string; kind: NewsroomDeskKind };
+
+export function newsroomDeskKind(section: NewsroomSectionRecord): NewsroomDeskKind {
+  return normalizeNewsroomSectionType(section.type) === "canonical" ? "core" : "rotating";
+}
+
+/** The desks a story or assignment can be placed on: the same enabled, ordered desks the Overview page lists. */
+export function newsroomDeskOptions(sections: NewsroomSectionRecord[]): NewsroomDeskOption[] {
+  return sortNewsroomSections(sections).filter(isEnabledNewsroomSection).map(section => ({ value: section.id, label: section.title, kind: newsroomDeskKind(section) }));
+}

package/lib/papyrus-web-locations.ts

@@ -3,12 +3,10 @@ import { PAPYRUS_OBJECT_KINDS, type PapyrusObjectKind } from "./papyrus-object-k
 import {
   buildNewsroomIndexWebPath,
   effectiveAssignmentsIndexFilters,
-  effectiveInsightsIndexFilters,
   effectiveMessagesIndexFilters,
   effectiveReferencesIndexFilters,
   normalizeReferenceIndexOrder,
   type AssignmentsIndexFilters,
-  type InsightsIndexFilters,
   type MessagesIndexFilters,
   type NewsroomIndexTab,
   type ReferencesIndexFilters,
@@ -27,7 +25,6 @@ export type PapyrusWebUiContext = {
 const NEWSROOM_TAB_IDS = new Set([
   "overview",
   "messages",
-  "insights",
   "assignments",
   "references",
   "topics",
@@ -123,21 +120,10 @@ export function webPathToPapyrusLocation(webPath: string): PapyrusWebUiContext {
     });
   }
 
-  if ((tab === "references" || tab === "messages" || tab === "assignments" || tab === "insights") && segments.length === 2) {
+  if ((tab === "references" || tab === "messages" || tab === "assignments") && segments.length === 2) {
     return newsroomIndexLocation(tab as NewsroomIndexTab, normalized, url.searchParams);
   }
 
-  if (tab === "insights" && segments[2]) {
-    const threadId = decodeURIComponent(segments[2]);
-    const objectUri = `papyrus://message/${encodeURIComponent(threadId)}`;
-    return location(objectUri, normalized, {
-      papyrusObjectUri: objectUri,
-      newsroomTab: "insights",
-      viewMode: "detail",
-      label: `Insight thread ${threadId}`,
-    });
-  }
-
   if ((tab === "references" || tab === "messages" || tab === "assignments") && segments[2]) {
     const objectId = decodeURIComponent(segments[2]);
     const kind = tab === "references" ? "reference" : tab === "messages" ? "message" : "assignment";
@@ -277,7 +263,7 @@ export function papyrusUriToWebPath(uri: string): PapyrusUriToWebPathResult {
   }
 
   if (NEWSROOM_TAB_IDS.has(id)) {
-    if (id === "references" || id === "messages" || id === "assignments" || id === "insights") {
+    if (id === "references" || id === "messages" || id === "assignments") {
       const mapped = newsroomIndexUriToWebPath(raw, `${id}/index`);
       if (mapped) return mapped;
     }
@@ -347,9 +333,6 @@ function readIndexFiltersFromSearchParams(tab: NewsroomIndexTab, searchParams: U
     kind: searchParams.get("kind")?.trim() ?? undefined,
     domain: searchParams.get("domain")?.trim() ?? undefined,
   });
-  if (tab === "insights") return effectiveInsightsIndexFilters({
-    domain: searchParams.get("domain")?.trim() ?? undefined,
-  });
   return effectiveAssignmentsIndexFilters({
     status: searchParams.get("status")?.trim() ?? undefined,
     type: searchParams.get("type")?.trim() ?? undefined,
@@ -368,9 +351,6 @@ function buildNewsroomIndexLocationUri(tab: NewsroomIndexTab, filters: Record<st
     const normalized = filters as MessagesIndexFilters;
     if (normalized.kind?.trim()) segments.push("kind", normalized.kind.trim());
     if (normalized.domain?.trim()) segments.push("domain", normalized.domain.trim());
-  } else if (tab === "insights") {
-    const normalized = filters as InsightsIndexFilters;
-    if (normalized.domain?.trim()) segments.push("domain", normalized.domain.trim());
   } else {
     const normalized = filters as AssignmentsIndexFilters;
     if (normalized.status?.trim()) segments.push("status", normalized.status.trim());
@@ -400,7 +380,7 @@ function parseIndexUriTail(objectId: string): { tab: NewsroomIndexTab; filters:
   const segments = objectId.split("/").filter(Boolean);
   if (!segments.length) return null;
   const tab = segments[0];
-  if (tab !== "references" && tab !== "messages" && tab !== "assignments" && tab !== "insights") return null;
+  if (tab !== "references" && tab !== "messages" && tab !== "assignments") return null;
   if (segments.length === 1) {
     return { tab, filters: readIndexFiltersFromSearchParams(tab, new URLSearchParams()) };
   }
@@ -414,7 +394,6 @@ function parseIndexUriTail(objectId: string): { tab: NewsroomIndexTab; filters:
   }
   if (tab === "references") return { tab, filters: effectiveReferencesIndexFilters(filters) };
   if (tab === "messages") return { tab, filters: effectiveMessagesIndexFilters(filters) };
-  if (tab === "insights") return { tab, filters: effectiveInsightsIndexFilters(filters) };
   return { tab, filters: effectiveAssignmentsIndexFilters(filters) };
 }
 

package/lib/priming-proof-report.ts

@@ -36,6 +36,7 @@ export const primingProofReportSchema = z.object({
     fingerprint: z.string().min(1),
     frozenAt: z.string().min(1),
     source: z.string().min(1),
+    design: z.string().min(1).optional(),
   }),
   priming: z.object({
     acceptedExamples: z.number().int().min(0),

package/lib/semantic-graph.ts

@@ -41,7 +41,7 @@ export type SemanticPredicateId =
   | "has_editorial_form"
   | "about"
   | "comment"
-  | "insight_about"
+  | "note_about"
   | "ingestion_rationale"
   | "uses_evidence"
   | "uses_signal"
@@ -77,7 +77,7 @@ export const SEMANTIC_PREDICATES: SemanticPredicateDefinition[] = [
   { id: "reference_summary_1000_tokens", label: "1000-token reference summary", group: "summarization", inverseLabel: "1000-token summary for", contextPackTags: ["reference_curation", "research", "context_ranking"] },
   { id: "mentions", label: "mentions", group: "ontology", inverseLabel: "mentioned by" },
   { id: "has_editorial_form", label: "has editorial form", group: "editorial", inverseLabel: "items by editorial form", contextPackTags: ["editing", "publication", "assignment_context"] },
-  { id: "insight_about", label: "insight about", group: "knowledge", inverseLabel: "insights", contextPackTags: ["research", "reference_graph", "editing"] },
+  { id: "note_about", label: "note about", group: "knowledge", inverseLabel: "notes", contextPackTags: ["research", "reference_graph", "editing"] },
   { id: "about", label: "about", group: "commentary", inverseLabel: "commentary" },
   { id: "comment", label: "comments on", group: "commentary", inverseLabel: "commented on by", contextPackTags: ["reference_curation", "editing", "research", "assignment_context"] },
   { id: "ingestion_rationale", label: "ingestion rationale for", group: "commentary", inverseLabel: "ingestion rationale", contextPackTags: ["reference_curation", "editing", "research", "assignment_context"] },
@@ -317,13 +317,13 @@ export class SemanticGraphSnapshot {
     return ranked.map((entry) => entry.message);
   }
 
-  insightsFor(kind: string, lineageId: string): MessageRecord[] {
+  notesFor(kind: string, lineageId: string): MessageRecord[] {
     return this.incoming(kind, lineageId)
       .filter((relation) => relation.subjectKind === "message")
-      .filter((relation) => relationTypeKey(relation) === "insight_about" || relation.predicate === "insight_about")
+      .filter((relation) => relationTypeKey(relation) === "note_about" || relation.predicate === "note_about")
       .map((relation) => this.messagesById.get(relation.subjectId))
       .filter((message): message is MessageRecord => Boolean(message))
-      .filter((message) => message.messageKind === "insight" && message.messageDomain === "knowledge")
+      .filter((message) => message.messageKind === "note" && message.messageDomain === "knowledge")
       .sort((left, right) => right.createdAt.localeCompare(left.createdAt));
   }
 

package/lib/site-brand.ts

@@ -23,6 +23,8 @@ export type SiteBrandId = string;
 
 /** Brand-specific replacements for generic Pretext components. */
 export type SiteBrandComponents = {
+  /** The mark shown at the top of the newsroom CMS sidebar in place of the app title. */
+  NewsroomLogo?: ComponentType<{ className?: string }>;
   PictogramFigure?: ComponentType<PictogramFigureProps>;
   BlogPageBackground?: ComponentType<BlogPageBackgroundProps>;
 };
@@ -79,8 +81,15 @@ export type ContentItemName = {
 
 export const DEFAULT_CONTENT_ITEM_NAME: ContentItemName = { singular: "Story", plural: "Stories" };
 
+/** Browser-tab icon files under `public/`, as site-root paths. The dark variant defaults to the light one. */
+export type SiteBrandIcons = { light: string; dark?: string; appleTouch?: string };
+
+export const DEFAULT_SITE_BRAND_ICONS: Required<Pick<SiteBrandIcons, "light" | "dark">> & { fallback: string } = { light: "/icon-light.png", dark: "/icon-dark.png", fallback: "/icon.png" };
+
 export type SiteBrand = {
   id: SiteBrandId;
+  /** The browser-tab icon. Omit to use the Papyrus plant. */
+  icons?: SiteBrandIcons;
   appTitle: string;
   appDescription: string;
   mastheadTitle: string;

package/lib/story-reporting-trail.ts

@@ -0,0 +1,106 @@
+/**
+ * Everything the reporting process recorded about one story, gathered by the story's lineage id:
+ * the draft versions of the copy, the research, reporting and copywriting assignments with their events,
+ * the notes and packets in the threads anchored to the story or its assignments, the references it draws on,
+ * and attached files. See docs/content-item-lifecycle.md for how these records join.
+ */
+export type TrailVersion = {
+  id: string;
+  versionNumber: number;
+  versionState: string | null;
+  status: string | null;
+  stage: string | null;
+  headline: string | null;
+  changeReason: string | null;
+  versionCreatedBy: string | null;
+  versionCreatedAt: string | null;
+  updatedAt: string | null;
+};
+
+export type TrailAssignmentEvent = {
+  id: string;
+  eventType: string;
+  fromStatus: string | null;
+  toStatus: string | null;
+  actorLabel: string | null;
+  note: string | null;
+  createdAt: string;
+};
+
+export type TrailAssignment = {
+  id: string;
+  title: string;
+  assignmentTypeKey: string;
+  status: string;
+  assigneeKey: string | null;
+  summary: string | null;
+  createdAt: string;
+  events: TrailAssignmentEvent[];
+};
+
+export type TrailMessage = {
+  id: string;
+  sequenceNumber?: number | null;
+  messageKind: string | null;
+  authorLabel: string | null;
+  summary: string | null;
+  content: string | null;
+  createdAt: string;
+};
+
+export type TrailThread = {
+  id: string;
+  title: string | null;
+  threadKind: string | null;
+  summary: string | null;
+  messages: TrailMessage[];
+};
+
+export type TrailReference = {
+  relationId: string;
+  predicate: string;
+  referenceId: string;
+  referenceLineageId: string | null;
+  title: string | null;
+  sourceUri: string | null;
+  /** consulted: read during reporting; cited: a citation in the article. */
+  role: "consulted" | "cited";
+  note: string | null;
+  citationKey: string | null;
+  addedBy: string | null;
+  addedAt: string | null;
+};
+
+export type TrailAttachment = {
+  id: string;
+  role: string | null;
+  filename: string | null;
+  mediaType: string | null;
+  byteSize: number | null;
+};
+
+export type StoryReportingTrail = {
+  versions: TrailVersion[];
+  assignments: TrailAssignment[];
+  threads: TrailThread[];
+  references: TrailReference[];
+  attachments: TrailAttachment[];
+};
+
+export const EMPTY_STORY_REPORTING_TRAIL: StoryReportingTrail = { versions: [], assignments: [], threads: [], references: [], attachments: [] };
+
+export function storyReportingTrailIsEmpty(trail: StoryReportingTrail): boolean {
+  return trail.assignments.length === 0 && trail.threads.length === 0 && trail.references.length === 0 && trail.attachments.length === 0 && trail.versions.length <= 1;
+}
+
+export type StoryFeedEntry =
+  | ({ entryKind: "message"; threadTitle: string | null } & TrailMessage)
+  | { entryKind: "reference"; id: string; createdAt: string; reference: TrailReference };
+
+/** Every message of the story's threads and every reference found for it in one chronological feed, newest first. */
+export function storyMessageFeed(trail: StoryReportingTrail): StoryFeedEntry[] {
+  const messages: StoryFeedEntry[] = trail.threads.flatMap(thread => thread.messages.map(message => ({ ...message, entryKind: "message" as const, threadTitle: thread.title })));
+  const references: StoryFeedEntry[] = trail.references.filter(reference => reference.addedAt).map(reference => ({ entryKind: "reference" as const, id: `reference-${reference.relationId}`, createdAt: reference.addedAt as string, reference }));
+  const sequenceOf = (entry: StoryFeedEntry) => (entry.entryKind === "message" ? entry.sequenceNumber ?? 0 : 0);
+  return [...messages, ...references].sort((left, right) => right.createdAt.localeCompare(left.createdAt) || sequenceOf(right) - sequenceOf(left));
+}