@anthusai/papyrus 1.10.0 → 1.11.0

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));
+}

package/lib/wiki.ts

@@ -0,0 +1,56 @@
+import type { SemanticNodeRecord } from "./category-repository";
+
+/** The wiki's front page is an ordinary content item with this slug; its Markus body holds the dynamic components. */
+export const WIKI_INDEX_SLUG = "wiki-index";
+export const WIKI_PAGE_ITEM_TYPE = "wiki_page";
+export const WIKI_CONCEPT_LINK_SCHEME = "concept:";
+
+export const DEFAULT_WIKI_INDEX_MARKUS = `# Concept wiki
+
+Every page in this wiki is a concept: an entity in the knowledge graph that the newsroom has reported on, researched or cited. Open one to see what it is, what it connects to, and the references behind it.
+
+## Recently edited
+
+::recent-concepts{limit=10}
+
+## Browse all concepts
+
+::concept-list
+`;
+
+export function conceptEditedAt(node: SemanticNodeRecord): string {
+  return node.updatedAt ?? node.versionCreatedAt ?? node.createdAt ?? "";
+}
+
+export function conceptTitle(node: SemanticNodeRecord): string {
+  return node.displayName?.trim() || node.nodeKey;
+}
+
+export function conceptId(node: SemanticNodeRecord): string {
+  return node.lineageId ?? node.id;
+}
+
+export function recentlyEditedConcepts(nodes: readonly SemanticNodeRecord[], options: { limit?: number; kind?: string | null } = {}): SemanticNodeRecord[] {
+  const { limit = 10, kind = null } = options;
+  return nodes
+    .filter(node => !kind || node.nodeKind === kind)
+    .slice()
+    .sort((left, right) => conceptEditedAt(right).localeCompare(conceptEditedAt(left)) || conceptTitle(left).localeCompare(conceptTitle(right)))
+    .slice(0, limit);
+}
+
+export function conceptsByTitle(nodes: readonly SemanticNodeRecord[], options: { kind?: string | null; limit?: number | null } = {}): SemanticNodeRecord[] {
+  const filtered = nodes.filter(node => !options.kind || node.nodeKind === options.kind).slice().sort((left, right) => conceptTitle(left).localeCompare(conceptTitle(right)));
+  return options.limit ? filtered.slice(0, options.limit) : filtered;
+}
+
+/** Finds the concept a `concept:<key>` wiki link names, by lineage id, node key or title. */
+export function resolveConceptLink(href: string, nodes: readonly SemanticNodeRecord[]): SemanticNodeRecord | null {
+  if (!href.startsWith(WIKI_CONCEPT_LINK_SCHEME)) return null;
+  const reference = decodeURIComponent(href.slice(WIKI_CONCEPT_LINK_SCHEME.length)).trim().toLowerCase();
+  return nodes.find(node => conceptId(node).toLowerCase() === reference || node.nodeKey.toLowerCase() === reference || conceptTitle(node).toLowerCase() === reference) ?? null;
+}
+
+export function conceptWikiPath(node: SemanticNodeRecord): string {
+  return `/newsroom/concepts/${encodeURIComponent(conceptId(node))}`;
+}

package/package.json

@@ -75,6 +75,7 @@
     "./components/archive-shell": "./components/archive-shell.tsx",
     "./components/article-video": "./components/article-video.tsx",
     "./components/blog-page-background": "./components/blog-page-background.tsx",
+    "./components/board-card-excerpts": "./components/board-card-excerpts.tsx",
     "./components/dev-sandbox-editor-sign-in": "./components/dev-sandbox-editor-sign-in.tsx",
     "./components/markus-ir-preview": "./components/markus-ir-preview.tsx",
     "./components/news-desk-client-provider": "./components/news-desk-client-provider.tsx",
@@ -100,6 +101,7 @@
     "./components/presentation-header": "./components/presentation-header.tsx",
     "./components/presentation-rhythm-hrule": "./components/presentation-rhythm-hrule.tsx",
     "./components/priming-proof-page": "./components/priming-proof-page.tsx",
+    "./components/prospectus-account-chooser": "./components/prospectus-account-chooser.tsx",
     "./components/publication-cyclotron-panel": "./components/publication-cyclotron-panel.tsx",
     "./components/reader-auth-control": "./components/reader-auth-control.tsx",
     "./components/reader-auth-state": "./components/reader-auth-state.ts",
@@ -114,6 +116,8 @@
     "./components/settings-page": "./components/settings-page.tsx",
     "./components/signup-entries-panel": "./components/signup-entries-panel.tsx",
     "./components/staging-banner": "./components/staging-banner.tsx",
+    "./components/story-reporting-trail-client": "./components/story-reporting-trail-client.ts",
+    "./components/story-reporting-trail": "./components/story-reporting-trail.tsx",
     "./components/topic-steering-workspace": "./components/topic-steering-workspace.tsx",
     "./components/ui/badge": "./components/ui/badge.tsx",
     "./components/ui/button-group": "./components/ui/button-group.tsx",
@@ -139,6 +143,8 @@
     "./components/use-paged-content-item-versions": "./components/use-paged-content-item-versions.ts",
     "./components/use-resolved-papyrus-theme": "./components/use-resolved-papyrus-theme.ts",
     "./components/use-rhythm-overlay": "./components/use-rhythm-overlay.ts",
+    "./components/wiki-concepts-view": "./components/wiki-concepts-view.tsx",
+    "./components/wiki-index-client": "./components/wiki-index-client.ts",
     "./lib/amplify-outputs-guard": "./lib/amplify-outputs-guard.ts",
     "./lib/amplify-outputs-path": "./lib/amplify-outputs-path.ts",
     "./lib/amplify-server-runtime": "./lib/amplify-server-runtime.ts",
@@ -174,6 +180,7 @@
     "./lib/edition-sections": "./lib/edition-sections.ts",
     "./lib/empty-edition-layout-plan": "./lib/empty-edition-layout-plan.ts",
     "./lib/excerpts": "./lib/excerpts.ts",
+    "./lib/front-matter-fields": "./lib/front-matter-fields.ts",
     "./lib/front-mosaic": "./lib/front-mosaic.ts",
     "./lib/furniture": "./lib/furniture.ts",
     "./lib/graphql-content-repository": "./lib/graphql-content-repository.ts",
@@ -259,6 +266,7 @@
     "./lib/staging-gate": "./lib/staging-gate.ts",
     "./lib/staging-gated-path": "./lib/staging-gated-path.ts",
     "./lib/staging-preview-object": "./lib/staging-preview-object.ts",
+    "./lib/story-reporting-trail": "./lib/story-reporting-trail.ts",
     "./lib/test-editor-override": "./lib/test-editor-override.ts",
     "./lib/text-columns": "./lib/text-columns.ts",
     "./lib/themed-image": "./lib/themed-image.ts",
@@ -266,6 +274,7 @@
     "./lib/video-loading": "./lib/video-loading.ts",
     "./lib/video-mode": "./lib/video-mode.ts",
     "./lib/video-script": "./lib/video-script.ts",
+    "./lib/wiki": "./lib/wiki.ts",
     "./renderers/markus/index": "./renderers/markus/index.ts",
     "./renderers/markus/stubs": "./renderers/markus/stubs.tsx",
     "./renderers/pretext/article-page": "./renderers/pretext/article-page.tsx",
@@ -288,6 +297,8 @@
     "./app/api/auth/prospectus/sign-in/route": "./app/api/auth/prospectus/sign-in/route.ts",
     "./app/api/auth/prospectus/sign-out/route": "./app/api/auth/prospectus/sign-out/route.ts",
     "./app/api/cyclotron/priming-proof/route": "./app/api/cyclotron/priming-proof/route.ts",
+    "./app/api/local-preview/derive/route": "./app/api/local-preview/derive/route.ts",
+    "./app/api/local-preview/media/route": "./app/api/local-preview/media/route.ts",
     "./app/api/media/[...path]/route": "./app/api/media/[...path]/route.ts",
     "./app/api/revalidate/route": "./app/api/revalidate/route.ts",
     "./app/archive/page": "./app/archive/page.tsx",
@@ -354,7 +365,7 @@
       "optional": true
     }
   },
-  "version": "1.10.0",
+  "version": "1.11.0",
   "dependencies": {
     "@aws-amplify/adapter-nextjs": "^1.7.3",
     "@aws-crypto/sha256-js": "5.2.0",