@anthusai/papyrus 1.10.0 → 1.11.0

package/components/ui/sheet.tsx

@@ -45,6 +45,7 @@ function SheetContent({
       <DialogPrimitive.Backdrop
         className={cn(
           "fixed inset-0 z-50 bg-black/40 data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0",
+          typeof className === "string" && className.includes("md:hidden") && "md:hidden",
           backdropClassName,
         )}
       />

package/components/wiki-concepts-view.tsx

@@ -0,0 +1,153 @@
+"use client";
+
+import Link from "next/link";
+import { useEffect, useMemo, useState, type ReactNode } from "react";
+import type { SemanticNodeRecord } from "../lib/category-repository";
+import { isLocalPreviewEnabled } from "../lib/local-preview";
+import { getNewsroomNavHref } from "../lib/newsroom-nav";
+import type { createSemanticGraphSnapshot } from "../lib/semantic-graph";
+import {
+  conceptEditedAt, conceptId, conceptTitle, conceptWikiPath, conceptsByTitle, recentlyEditedConcepts, resolveConceptLink,
+} from "../lib/wiki";
+import { MarkusIrPreview } from "./markus-ir-preview";
+import { createWikiIndexPage, loadWikiIndexPage, type WikiIndexPage } from "./wiki-index-client";
+
+type SemanticGraph = ReturnType<typeof createSemanticGraphSnapshot>;
+
+const editedFormat = new Intl.DateTimeFormat(undefined, { dateStyle: "medium" });
+
+function formatEdited(value: string): string {
+  const parsed = new Date(value);
+  return value && !Number.isNaN(parsed.getTime()) ? editedFormat.format(parsed) : "";
+}
+
+function kindLabel(kind: string): string {
+  return kind.replace(/_/g, " ");
+}
+
+function ConceptLink({ children, demo, node, onOpen }: { children?: ReactNode; demo: boolean; node: SemanticNodeRecord; onOpen: (lineageId: string) => void }) {
+  return <a className="wiki-link" data-wiki-concept-link={conceptId(node)} href={getNewsroomNavHref(conceptWikiPath(node), demo)} onClick={event => { if (event.metaKey || event.ctrlKey || event.shiftKey) return; event.preventDefault(); onOpen(conceptId(node)); }}>{children ?? conceptTitle(node)}</a>;
+}
+
+function ConceptRows({ demo, nodes, onOpen, showEdited }: { demo: boolean; nodes: SemanticNodeRecord[]; onOpen: (lineageId: string) => void; showEdited?: boolean }) {
+  if (!nodes.length) return <p className="wiki-empty">No concepts to show.</p>;
+  return <ul className="wiki-concept-list">
+    {nodes.map(node => <li key={conceptId(node)}>
+      <ConceptLink demo={demo} node={node} onOpen={onOpen} />
+      <span className="wiki-chip">{kindLabel(node.nodeKind)}</span>
+      {showEdited && conceptEditedAt(node) && <span className="wiki-meta">edited {formatEdited(conceptEditedAt(node))}</span>}
+    </li>)}
+  </ul>;
+}
+
+function WikiIndexPageView({ demo, nodes, onOpen }: { demo: boolean; nodes: SemanticNodeRecord[]; onOpen: (lineageId: string) => void }) {
+  const [page, setPage] = useState<WikiIndexPage | null>(null);
+  const [error, setError] = useState<string | null>(null);
+  const [saving, setSaving] = useState(false);
+  useEffect(() => {
+    let cancelled = false;
+    loadWikiIndexPage(demo || isLocalPreviewEnabled()).then(loaded => { if (!cancelled) setPage(loaded); }).catch((reason: unknown) => { if (!cancelled) setError(reason instanceof Error ? reason.message : "Could not load the wiki index."); });
+    return () => { cancelled = true; };
+  }, [demo]);
+  const dynamicDirectives = useMemo(() => ({
+    "recent-concepts": (attributes: Record<string, unknown>) => <ConceptRows demo={demo} nodes={recentlyEditedConcepts(nodes, { kind: typeof attributes.kind === "string" ? attributes.kind : null, limit: Number(attributes.limit) || 10 })} onOpen={onOpen} showEdited />,
+    "concept-list": (attributes: Record<string, unknown>) => <ConceptRows demo={demo} nodes={conceptsByTitle(nodes, { kind: typeof attributes.kind === "string" ? attributes.kind : null, limit: Number(attributes.limit) || null })} onOpen={onOpen} />,
+    "concept-count": (attributes: Record<string, unknown>) => <strong>{nodes.filter(node => !attributes.kind || node.nodeKind === attributes.kind).length}</strong>,
+  }), [demo, nodes, onOpen]);
+  const renderLink = (href: string, children: ReactNode) => {
+    const node = resolveConceptLink(href, nodes);
+    return node ? <ConceptLink demo={demo} node={node} onOpen={onOpen}>{children}</ConceptLink> : null;
+  };
+  if (error) return <p className="wiki-empty" role="alert">{error}</p>;
+  if (!page) return <p className="wiki-empty">Loading the wiki…</p>;
+  return <article className="wiki-page" data-wiki-index>
+    <div className="wiki-page-tools">
+      {page.itemId
+        ? <Link className="wiki-tool-link" href={getNewsroomNavHref(`/newsroom/articles/${encodeURIComponent(page.itemId)}`, demo)}>Edit this page</Link>
+        : <button className="wiki-tool-link" disabled={saving} onClick={() => { setSaving(true); createWikiIndexPage(demo || isLocalPreviewEnabled()).then(setPage).catch((reason: unknown) => setError(reason instanceof Error ? reason.message : "Could not save the index.")).finally(() => setSaving(false)); }} type="button">{saving ? "Saving…" : "Save this page so it can be edited"}</button>}
+    </div>
+    <MarkusIrPreview bodyIr={page.bodyIr} dynamicDirectives={dynamicDirectives} renderLink={renderLink} />
+  </article>;
+}
+
+function ConceptPageView({ demo, graph, node, nodes, onOpen }: { demo: boolean; graph: SemanticGraph; node: SemanticNodeRecord; nodes: SemanticNodeRecord[]; onOpen: (lineageId: string) => void }) {
+  const lineage = conceptId(node);
+  const groups = graph.neighbors("semanticNode", lineage);
+  const references = graph.referencesForSemanticNode(lineage);
+  const byLineage = new Map(nodes.map(candidate => [conceptId(candidate), candidate]));
+  const aliases = (node.aliases ?? []).filter(Boolean) as string[];
+  return <article className="wiki-page" data-wiki-concept={lineage}>
+    <h1>{conceptTitle(node)}</h1>
+    <p className="wiki-meta"><span className="wiki-chip">{kindLabel(node.nodeKind)}</span> {node.status !== "current" && <span className="wiki-chip">{node.status}</span>} {conceptEditedAt(node) && <>Last edited {formatEdited(conceptEditedAt(node))}</>}{node.versionCreatedBy ? ` by ${node.versionCreatedBy}` : ""}</p>
+    {aliases.length > 0 && <p className="wiki-meta">Also known as {aliases.join(", ")}</p>}
+    {node.description ? node.description.split(/\n{2,}/).map((paragraph, index) => <p key={index}>{paragraph}</p>) : <p className="wiki-empty">This concept has no description yet.</p>}
+    <section data-wiki-section="connections">
+      <h2>Connections</h2>
+      {groups.length ? groups.map(group => <div className="wiki-connection-group" key={`${group.direction}-${group.predicate}`}>
+        <h3>{group.label}</h3>
+        <ul className="wiki-concept-list">
+          {group.objects.map(object => {
+            const target = object.kind === "semanticNode" ? byLineage.get(object.lineageId) : undefined;
+            return <li key={`${object.kind}-${object.lineageId}`}>{target ? <ConceptLink demo={demo} node={target} onOpen={onOpen} /> : <span>{object.label}</span>}<span className="wiki-chip">{target ? kindLabel(target.nodeKind) : object.kind}</span></li>;
+          })}
+        </ul>
+      </div>) : <p className="wiki-empty">No connections recorded.</p>}
+    </section>
+    <section data-wiki-section="references">
+      <h2>References</h2>
+      {references.length ? <ul className="wiki-concept-list">
+        {references.map(reference => <li key={reference.lineageId}><Link href={getNewsroomNavHref(`/newsroom/references/${encodeURIComponent(reference.lineageId)}`, demo)}>{reference.label}</Link></li>)}
+      </ul> : <p className="wiki-empty">No references recorded.</p>}
+    </section>
+  </article>;
+}
+
+/**
+ * The concept wiki: the front page is a content item whose Markus body can hold live components
+ * (recently edited concepts, concept lists), and every concept in the knowledge graph is a page
+ * linked to the concepts and references it connects to.
+ */
+export function WikiConceptsView({ demo = false, graph, initialNodeLineageId, nodes }: { demo?: boolean; graph: SemanticGraph; initialNodeLineageId?: string | null; nodes: SemanticNodeRecord[] }) {
+  const [selected, setSelected] = useState<string | null>(initialNodeLineageId ?? null);
+  const [search, setSearch] = useState("");
+  const [kind, setKind] = useState("");
+  useEffect(() => { setSelected(initialNodeLineageId ?? null); }, [initialNodeLineageId]);
+  useEffect(() => {
+    const onPop = () => {
+      const match = window.location.pathname.match(/\/concepts\/([^/?#]+)/);
+      setSelected(match ? decodeURIComponent(match[1]) : null);
+    };
+    window.addEventListener("popstate", onPop);
+    return () => window.removeEventListener("popstate", onPop);
+  }, []);
+  const open = (lineageId: string | null) => {
+    setSelected(lineageId);
+    const target = getNewsroomNavHref(lineageId ? `/newsroom/concepts/${encodeURIComponent(lineageId)}` : "/newsroom/concepts", demo);
+    if (`${window.location.pathname}${window.location.search}` !== target) window.history.pushState(null, "", target);
+  };
+  const node = selected ? nodes.find(candidate => conceptId(candidate) === selected || candidate.id === selected) ?? null : null;
+  const kinds = useMemo(() => Array.from(new Set(nodes.map(candidate => candidate.nodeKind))).sort(), [nodes]);
+  const matches = useMemo(() => {
+    const needle = search.trim().toLowerCase();
+    return conceptsByTitle(nodes, { kind: kind || null }).filter(candidate => !needle || conceptTitle(candidate).toLowerCase().includes(needle) || (candidate.aliases ?? []).some(alias => alias?.toLowerCase().includes(needle)));
+  }, [kind, nodes, search]);
+  return <div className="wiki" data-wiki>
+    <nav aria-label="Wiki" className="wiki-sidebar">
+      <button className="wiki-home" data-wiki-home aria-current={node ? undefined : "page"} onClick={() => open(null)} type="button">Wiki home</button>
+      <input aria-label="Search concepts" className="wiki-search" onChange={event => setSearch(event.target.value)} placeholder="Search concepts" value={search} />
+      {kinds.length > 1 && <select aria-label="Concept kind" className="wiki-kind" onChange={event => setKind(event.target.value)} value={kind}>
+        <option value="">All kinds</option>
+        {kinds.map(option => <option key={option} value={option}>{kindLabel(option)}</option>)}
+      </select>}
+      <ul className="wiki-sidebar-list">
+        {matches.map(candidate => <li key={conceptId(candidate)}><a aria-current={node && conceptId(node) === conceptId(candidate) ? "page" : undefined} href={getNewsroomNavHref(conceptWikiPath(candidate), demo)} onClick={event => { if (event.metaKey || event.ctrlKey || event.shiftKey) return; event.preventDefault(); open(conceptId(candidate)); }}>{conceptTitle(candidate)}</a></li>)}
+      </ul>
+    </nav>
+    <div className="wiki-main">
+      {node
+        ? <ConceptPageView demo={demo} graph={graph} node={node} nodes={nodes} onOpen={open} />
+        : selected ? <p className="wiki-empty" role="alert">That concept page was not found.</p>
+        : <WikiIndexPageView demo={demo} nodes={nodes} onOpen={open} />}
+    </div>
+  </div>;
+}

package/components/wiki-index-client.ts

@@ -0,0 +1,51 @@
+"use client";
+
+import { generateClient } from "aws-amplify/data";
+import type { Schema } from "../amplify/data/resource";
+import { resolveArticlesBackend } from "../lib/newsroom-articles";
+import { isLocalPreviewEnabled } from "../lib/local-preview";
+import { DEFAULT_WIKI_INDEX_MARKUS, WIKI_INDEX_SLUG, WIKI_PAGE_ITEM_TYPE } from "../lib/wiki";
+import { configureAmplifyClient } from "./amplify-client-provider";
+
+export type WikiIndexPage = {
+  /** The id of the stored content item, or null while the wiki still shows the built-in starter content. */
+  itemId: string | null;
+  bodyMarkus: string;
+  bodyIr: unknown;
+};
+
+type GraphqlResponse = { data?: { itemBySlug?: { items?: Record<string, unknown>[] | null } | null } | null; errors?: { message?: string }[] | null };
+
+async function storedIndexRow(preview: boolean): Promise<Record<string, unknown> | null> {
+  if (preview || isLocalPreviewEnabled()) return null;
+  configureAmplifyClient();
+  const client = generateClient<Schema>() as unknown as { graphql: (options: Record<string, unknown>) => Promise<GraphqlResponse> };
+  const response = await client.graphql({
+    query: "query ($slug: String!) { itemBySlug(slug: $slug) { items { id versionNumber versionState bodyMarkus bodyIr } } }",
+    variables: { slug: WIKI_INDEX_SLUG },
+    authMode: "userPool",
+  });
+  if (response.errors?.length) throw new Error(response.errors.map(error => error.message ?? "GraphQL error").join("; "));
+  const rows = (response.data?.itemBySlug?.items ?? []).filter(Boolean) as Record<string, unknown>[];
+  const ranked = rows.sort((left, right) => Number(right.versionNumber ?? 0) - Number(left.versionNumber ?? 0));
+  return ranked.find(row => row.versionState === "current") ?? ranked[0] ?? null;
+}
+
+async function derive(bodyMarkus: string, preview: boolean): Promise<unknown> {
+  const result = await resolveArticlesBackend(preview).actions.deriveMarkus({ frontMatterYaml: null, bodyMarkus, includeIr: true });
+  return result.bodyIr ?? null;
+}
+
+/** Loads the wiki's front page content item, falling back to the starter content until one is saved. */
+export async function loadWikiIndexPage(preview: boolean): Promise<WikiIndexPage> {
+  const row = await storedIndexRow(preview);
+  const bodyMarkus = typeof row?.bodyMarkus === "string" && row.bodyMarkus.trim() ? row.bodyMarkus : DEFAULT_WIKI_INDEX_MARKUS;
+  const storedIr = row?.bodyIr;
+  return { itemId: row ? String(row.id) : null, bodyMarkus, bodyIr: storedIr ?? await derive(bodyMarkus, preview) };
+}
+
+/** Saves the starter index as the wiki-index content item so editors can change it like any other page. */
+export async function createWikiIndexPage(preview: boolean): Promise<WikiIndexPage> {
+  const saved = await resolveArticlesBackend(preview).actions.saveItemDraft({ id: null, type: WIKI_PAGE_ITEM_TYPE, slug: WIKI_INDEX_SLUG, section: null, frontMatterYaml: `title: Concept wiki\n`, bodyMarkus: DEFAULT_WIKI_INDEX_MARKUS, aliases: [], expectedContentHash: null });
+  return { itemId: saved.item.id, bodyMarkus: DEFAULT_WIKI_INDEX_MARKUS, bodyIr: await derive(DEFAULT_WIKI_INDEX_MARKUS, preview) };
+}

package/lib/content-actions-client.ts

@@ -13,6 +13,9 @@ export type SaveItemDraftInput = {
   bodyMarkus: string;
   aliases: string[];
   expectedContentHash: string | null;
+  /** Records a new draft version of the story instead of correcting the current one in place. */
+  newVersion?: boolean;
+  changeReason?: string | null;
 };
 
 export type DeriveMarkusResult = { ok: true; bodyIrBytes: number; bodyIr?: unknown; errors: [] };

package/lib/content-actions-demo.ts

@@ -1,4 +1,5 @@
 import { ContentActionFailure } from "./content-actions-client";
+import { isLocalPreviewEnabled } from "./local-preview";
 import type {
   DeriveMarkusInput,
   DeriveMarkusResult,
@@ -12,7 +13,7 @@ import {
   demoContentHash,
   type DemoArticleRecord,
 } from "./newsroom-demo-articles";
-import { createLocalPreviewEditableArticle } from "./local-preview-seed";
+import { createLocalPreviewEditableArticle, lineageForPreviewVersion, recordLocalPreviewDesk, recordLocalPreviewVersion } from "./local-preview-seed";
 import { sourceLineOffset, type ArticlesBackend, type EditableArticle, type NewsroomArticleRow } from "./newsroom-articles";
 
 function titleFromYaml(frontMatterYaml: string | null, fallback: string): string {
@@ -30,6 +31,18 @@ function demoAttribute(attributes: string, name: string): string {
   return match ? match[1] : "";
 }
 
+async function deriveThroughPreviewMarkusEngine(input: DeriveMarkusInput): Promise<DeriveMarkusResult | null> {
+  try {
+    const response = await fetch("/api/local-preview/derive", { method: "POST", body: JSON.stringify({ frontMatterYaml: input.frontMatterYaml, bodyMarkus: input.bodyMarkus }) });
+    if (!response.ok) return null;
+    const result = await response.json() as DeriveMarkusResult & { error?: string };
+    if (result.error) return null;
+    return input.includeIr ? result : { ...result, bodyIr: undefined };
+  } catch {
+    return null;
+  }
+}
+
 function demoEnvelope(bodyMarkus: string) {
   const images: Record<string, Record<string, unknown>> = {};
   const children = bodyMarkus
@@ -74,6 +87,10 @@ export function createDemoArticlesBackend(): ArticlesBackend {
   return {
     actions: {
       async deriveMarkus(input: DeriveMarkusInput): Promise<DeriveMarkusResult> {
+        if (isLocalPreviewEnabled()) {
+          const derived = await deriveThroughPreviewMarkusEngine(input);
+          if (derived) return derived;
+        }
         const lines = input.bodyMarkus.split("\n");
         const invalidIndex = lines.findIndex((line) => line.includes(":::nope"));
         if (invalidIndex >= 0) {
@@ -91,6 +108,28 @@ export function createDemoArticlesBackend(): ArticlesBackend {
       },
       async saveItemDraft(input: SaveItemDraftInput): Promise<SaveItemDraftResult> {
         const existing = input.id ? requireRecord(input.id) : null;
+        if (input.newVersion && existing) {
+          const lineageId = createLocalPreviewEditableArticle(existing.id)?.lineageId ?? existing.id;
+          const versionNumber = (existing.versionNumber ?? 1) + 1;
+          const id = `${lineageId}-v${versionNumber}`;
+          const frontMatterYaml = input.frontMatterYaml ?? "";
+          const record: DemoArticleRecord = {
+            ...existing,
+            id,
+            slug: existing.slug,
+            section: input.section,
+            title: titleFromYaml(input.frontMatterYaml, existing.slug),
+            status: "draft",
+            frontMatterYaml,
+            bodyMarkus: input.bodyMarkus,
+            contentHash: demoContentHash(frontMatterYaml, input.bodyMarkus),
+            versionNumber,
+            updatedAt: new Date().toISOString(),
+          };
+          records.set(id, record);
+          recordLocalPreviewVersion(lineageId, { id, versionNumber, versionState: "current", status: "draft", stage: null, headline: record.title, changeReason: input.changeReason ?? null, versionCreatedBy: "You", versionCreatedAt: record.updatedAt, updatedAt: record.updatedAt });
+          return { ok: true, item: { id, contentHash: record.contentHash, status: "draft", slug: record.slug, versionNumber } };
+        }
         if (existing && input.expectedContentHash !== null && input.expectedContentHash !== existing.contentHash) {
           throw new ContentActionFailure([
             { code: "conflict", message: "The item changed since it was loaded.", line: null },
@@ -120,6 +159,7 @@ export function createDemoArticlesBackend(): ArticlesBackend {
           updatedAt: new Date().toISOString(),
         };
         records.set(id, record);
+        recordLocalPreviewDesk(id, record.section);
         return {
           ok: true,
           item: {
@@ -172,11 +212,23 @@ export function createDemoArticlesBackend(): ArticlesBackend {
         .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
     },
     async loadArticle(id: string): Promise<EditableArticle> {
-      const previewRecord = records.get(id) ? null : createLocalPreviewEditableArticle(id);
-      if (previewRecord) return previewRecord;
+      if (!records.has(id)) {
+        const previewRecord = createLocalPreviewEditableArticle(id);
+        if (previewRecord) {
+          records.set(id, {
+            ...previewRecord,
+            title: titleFromYaml(previewRecord.frontMatterYaml, previewRecord.slug),
+            status: previewRecord.status === "published" ? "published" : "draft",
+            contentHash: demoContentHash(previewRecord.frontMatterYaml, previewRecord.bodyMarkus),
+            publishedContentHash: previewRecord.status === "published" ? demoContentHash(previewRecord.frontMatterYaml, previewRecord.bodyMarkus) : null,
+            updatedAt: new Date().toISOString(),
+          });
+        }
+      }
       const record = requireRecord(id);
       return {
         id: record.id,
+        lineageId: createLocalPreviewEditableArticle(record.id)?.lineageId ?? lineageForPreviewVersion(record.id),
         type: record.type,
         section: record.section,
         slug: record.slug,

package/lib/content-item-lifecycle.ts

@@ -28,9 +28,9 @@ export const DEFAULT_CONTENT_ITEM_STAGE_DEFINITIONS: readonly ContentItemStageDe
   { key: "copywriting", label: "Copywriting" },
   { key: "illustration", label: "Illustration" },
   { key: "typesetting", label: "Typesetting" },
-  { key: "published", label: "Published" },
-  { key: "held", label: "Held" },
   { key: "spiked", label: "Spiked", collapsedUntilOpened: true },
+  { key: "held", label: "Held" },
+  { key: "published", label: "Published" },
 ];
 
 export function contentItemStageKeys(stageDefinitions: readonly ContentItemStageDefinition[]): string[] {
@@ -68,6 +68,8 @@ export type ContentItemVersionRecord = {
   status: string;
   title?: string | null;
   headline?: string | null;
+  deck?: string | null;
+  metadata?: unknown;
   slug: string;
   section?: string | null;
   updatedAt?: string | null;

package/lib/front-matter-fields.ts

@@ -0,0 +1,42 @@
+import { parseDocument } from "yaml";
+import type { ContentItemVersionRecord } from "./content-item-lifecycle";
+
+/** Front matter keys the editor shows as form fields instead of raw YAML. */
+export const FRONT_MATTER_TITLE_KEY = "title";
+export const FRONT_MATTER_SUBTITLE_KEY = "deck";
+export const FRONT_MATTER_BLURB_KEY = "blurb";
+
+/** Reads one text field from front matter YAML; invalid YAML or a non-text value reads as empty. */
+export function readFrontMatterText(frontMatterYaml: string | null | undefined, key: string): string {
+  if (!frontMatterYaml?.trim()) return "";
+  const document = parseDocument(frontMatterYaml);
+  if (document.errors.length) return "";
+  const value = document.get(key);
+  return typeof value === "string" ? value : "";
+}
+
+/** Sets or removes one text field in front matter YAML, keeping every other line and comment as written. */
+export function writeFrontMatterText(frontMatterYaml: string | null | undefined, key: string, value: string): string {
+  const document = parseDocument(frontMatterYaml?.trim() ? frontMatterYaml : "{}\n");
+  if (document.errors.length) return frontMatterYaml ?? "";
+  if (value.trim()) document.set(key, value);
+  else document.delete(key);
+  const text = document.toString();
+  return text.trim() === "{}" ? "" : text;
+}
+
+function metadataFrontMatterYaml(metadata: unknown): string {
+  const parsed = typeof metadata === "string" ? safeJson(metadata) : metadata;
+  const text = (parsed as { frontMatterYaml?: unknown } | null)?.frontMatterYaml;
+  return typeof text === "string" ? text : "";
+}
+
+function safeJson(text: string): unknown {
+  try { return JSON.parse(text); } catch { return null; }
+}
+
+/** A few lines for a board card: the blurb when one is recorded, else the subtitle. */
+export function contentItemExcerpt(version: Pick<ContentItemVersionRecord, "deck" | "metadata">): string | undefined {
+  const blurb = readFrontMatterText(metadataFrontMatterYaml(version.metadata), FRONT_MATTER_BLURB_KEY).trim();
+  return blurb || version.deck?.trim() || undefined;
+}

package/lib/local-preview-seed.ts

@@ -1,5 +1,7 @@
 import type { AssignmentRecord, ReferenceRecord } from "./category-repository";
 import type { EditableArticle } from "./newsroom-articles";
+import type { MediaAssetRecord } from "./newsroom-media";
+import { EMPTY_STORY_REPORTING_TRAIL, type StoryReportingTrail, type TrailVersion } from "./story-reporting-trail";
 import { contentItemStageKeys, type ContentItemVersionRecord } from "./content-item-lifecycle";
 import { getContentItemStageDefinitions } from "./site-brand";
 
@@ -95,12 +97,17 @@ export function createLocalPreviewAssignments(): AssignmentRecord[] {
   return [...assignmentsOnContentItems, ...assignmentsWithoutContentItem];
 }
 
+export function createLocalPreviewRealPublishedVersions(): ContentItemVersionRecord[] {
+  return [];
+}
+
 export function createLocalPreviewEditableArticle(id: string): EditableArticle | null {
   const version = createLocalPreviewContentItemVersions().find(candidate => candidate.id === id);
   if (!version) return null;
   const headline = version.headline || version.title || version.slug;
   return {
     id: version.id,
+    lineageId: version.lineageId,
     type: version.type,
     section: version.section ?? null,
     slug: version.slug,
@@ -113,3 +120,29 @@ export function createLocalPreviewEditableArticle(id: string): EditableArticle |
     everPublished: version.status === "published",
   };
 }
+
+export function recordLocalPreviewDesk(articleId: string, deskId: string | null): void {
+  const version = createLocalPreviewContentItemVersions().find(candidate => candidate.id === articleId);
+  if (version) version.section = deskId;
+}
+
+const previewSavedVersions = new Map<string, TrailVersion[]>();
+const previewLineageByVersionId = new Map<string, string>();
+
+export function recordLocalPreviewVersion(lineageId: string, version: TrailVersion): void {
+  previewSavedVersions.set(lineageId, [version, ...(previewSavedVersions.get(lineageId) ?? [])]);
+  previewLineageByVersionId.set(version.id, lineageId);
+}
+
+export function lineageForPreviewVersion(versionId: string): string | null {
+  return previewLineageByVersionId.get(versionId) ?? null;
+}
+
+export function createLocalPreviewReportingTrail(lineageId: string): StoryReportingTrail {
+  const saved = previewSavedVersions.get(lineageId) ?? [];
+  return { ...EMPTY_STORY_REPORTING_TRAIL, versions: saved };
+}
+
+export function createLocalPreviewMediaAssets(_itemId: string): MediaAssetRecord[] {
+  return [];
+}

package/lib/newsroom-articles.ts

@@ -59,6 +59,7 @@ export type NewsroomArticleEditorState = {
 
 export type EditableArticle = {
   id: string;
+  lineageId?: string | null;
   type: string;
   section: string | null;
   slug: string;
@@ -267,6 +268,7 @@ export async function loadEditableArticle(client: ArticlesDataClient, id: string
   const status: ArticleStatus = record.status === "published" ? "published" : "draft";
   return {
     id: String(record.id),
+    lineageId: typeof record.lineageId === "string" ? record.lineageId : null,
     type: String(record.type),
     section: typeof record.section === "string" ? record.section : null,
     slug: String(record.slug),

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