@anthusai/papyrus 1.4.0-next.3 → 1.4.0-next.5

package/components/ui/sheet.tsx

@@ -11,9 +11,9 @@ type SheetSide = "bottom" | "left" | "right";
 
 const sideClasses: Record<SheetSide, string> = {
   bottom:
-    "inset-x-0 bottom-0 top-auto max-h-[85dvh] w-full rounded-t-2xl border-t data-open:slide-in-from-bottom data-closed:slide-out-to-bottom",
-  left: "inset-y-0 left-0 h-full w-[min(100vw,20rem)] rounded-r-2xl border-r data-open:slide-in-from-left data-closed:slide-out-to-left",
-  right: "inset-y-0 right-0 h-full w-[min(100vw,20rem)] rounded-l-2xl border-l data-open:slide-in-from-right data-closed:slide-out-to-right",
+    "inset-x-0 bottom-0 top-auto max-h-[85dvh] w-full border-t data-open:slide-in-from-bottom data-closed:slide-out-to-bottom",
+  left: "inset-y-0 left-0 h-full w-[min(100vw,20rem)] border-r data-open:slide-in-from-left data-closed:slide-out-to-left",
+  right: "inset-y-0 right-0 h-full w-[min(100vw,20rem)] border-l data-open:slide-in-from-right data-closed:slide-out-to-right",
 };
 
 function Sheet({ ...props }: DialogPrimitive.Root.Props) {
@@ -31,17 +31,23 @@ function SheetClose({ ...props }: DialogPrimitive.Close.Props) {
 function SheetContent({
   children,
   className,
+  backdropClassName,
   showCloseButton = true,
   side = "bottom",
   ...props
 }: DialogPrimitive.Popup.Props & {
+  backdropClassName?: string;
   showCloseButton?: boolean;
   side?: SheetSide;
 }) {
   return (
     <DialogPrimitive.Portal>
       <DialogPrimitive.Backdrop
-        className="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"
+        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,
+        )}
       />
       <DialogPrimitive.Popup
         className={cn(

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/approved-priming-proof-reports.ts

@@ -1,6 +1,9 @@
+import approvedReport0 from "./approved-priming-proofs/papyrus.json";
+
 /**
  * Priming proof reports a publication owner approved for visitors, keyed by site brand id.
- * A report reaches this map only through a reviewed commit of its
- * `publications/priming-proofs/<brand id>.json` file; see docs/cyclotron-priming.md.
+ * A report reaches this map only through a reviewed commit made by scripts/approve-priming-proof-report.ts.
  */
-export const APPROVED_PRIMING_PROOF_REPORTS: Record<string, unknown> = {};
+export const APPROVED_PRIMING_PROOF_REPORTS: Record<string, unknown> = {
+  "papyrus": approvedReport0,
+};

package/lib/approved-priming-proofs/papyrus.json

@@ -0,0 +1,90 @@
+{
+  "version": "cyclotron-priming-proof/v1",
+  "proofId": "ti-2026-10",
+  "publication": "Anthus Threat Intelligence",
+  "cyclotronId": "papyrus-relevance",
+  "question": "Should this candidate source become a reference for this publication?",
+  "labels": [
+    "include",
+    "exclude"
+  ],
+  "positiveLabel": "include",
+  "decisionModel": "jev:jev-1.13.0",
+  "ranAt": "2026-10-18T13:34:13.426310Z",
+  "heldOut": {
+    "size": 10,
+    "byLabel": {
+      "include": 5,
+      "exclude": 5
+    },
+    "fingerprint": "b12fe63012c925bd6def343a13b94ccedafd5184ddb93c8312998486045da779",
+    "frozenAt": "2026-10-18T13:02:20.090030Z",
+    "source": "References editors reviewed in the Newsroom, labeled by the scope-training rule"
+  },
+  "priming": {
+    "acceptedExamples": 13,
+    "excludedBecauseInHeldOut": 0,
+    "fingerprint": null,
+    "source": "editor reviews of References",
+    "order": "reviews in review order, then priming examples in acceptance order"
+  },
+  "conditions": {
+    "freshStorePerPoint": true,
+    "rubric": "publication doctrine seed",
+    "optimizer": false,
+    "reviewProgram": false
+  },
+  "points": [
+    {
+      "labels": 0,
+      "labelsByClass": {
+        "include": 0,
+        "exclude": 0
+      },
+      "decided": 10,
+      "agreement": 1,
+      "precision": 1,
+      "recall": 1,
+      "confusion": {
+        "truePositives": 5,
+        "falsePositives": 0,
+        "trueNegatives": 5,
+        "falseNegatives": 0
+      }
+    },
+    {
+      "labels": 5,
+      "labelsByClass": {
+        "include": 4,
+        "exclude": 1
+      },
+      "decided": 10,
+      "agreement": 1,
+      "precision": 1,
+      "recall": 1,
+      "confusion": {
+        "truePositives": 5,
+        "falsePositives": 0,
+        "trueNegatives": 5,
+        "falseNegatives": 0
+      }
+    },
+    {
+      "labels": 13,
+      "labelsByClass": {
+        "include": 4,
+        "exclude": 9
+      },
+      "decided": 10,
+      "agreement": 0.9,
+      "precision": 1,
+      "recall": 0.8,
+      "confusion": {
+        "truePositives": 4,
+        "falsePositives": 0,
+        "trueNegatives": 5,
+        "falseNegatives": 1
+      }
+    }
+  ]
+}

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,6 +13,7 @@ import {
   demoContentHash,
   type DemoArticleRecord,
 } from "./newsroom-demo-articles";
+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 {
@@ -29,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
@@ -73,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) {
@@ -90,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 },
@@ -119,6 +159,7 @@ export function createDemoArticlesBackend(): ArticlesBackend {
           updatedAt: new Date().toISOString(),
         };
         records.set(id, record);
+        recordLocalPreviewDesk(id, record.section);
         return {
           ok: true,
           item: {
@@ -171,9 +212,23 @@ export function createDemoArticlesBackend(): ArticlesBackend {
         .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
     },
     async loadArticle(id: string): Promise<EditableArticle> {
+      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/front-mosaic.ts

@@ -1,3 +1,4 @@
+import { warnAboutMissingMedia } from "./layout-warnings";
 import {
   type ArticleFrameBlockSpec,
   type ArticleFrameCompositionSlotSpec,
@@ -605,7 +606,7 @@ function solveComposedFrontArticleFrame(
         flow.usedImageAssetIds,
       );
       if (!image) {
-        if (mediaSpec?.required) throw new Error(`${blockSpec.id} requires media slot ${slot.mediaIndex ?? 0} but no image could be solved`);
+        if (mediaSpec?.required) warnAboutMissingMedia(`${blockSpec.id} requires media slot ${slot.mediaIndex ?? 0} but no image could be solved and renders without it`);
         continue;
       }
       const stackTop = getOccupiedColumnBottom(columnBottoms, image.columnStart, image.columnSpan);

package/lib/layout-plan.ts

@@ -1,3 +1,4 @@
+import { warnAboutMissingMedia } from "./layout-warnings";
 import { z } from "zod";
 import {
   type PublicationItem,
@@ -894,7 +895,7 @@ function validateBlock(
   if (block.type === "mediaCluster") {
     const assets = findAssetsByRole(item, block.assetRole);
     if (block.required && assets.length < block.count.min) {
-      throw new Error(`${label}.${block.id} requires at least ${block.count.min} media assets`);
+      warnAboutMissingMedia(`${label}.${block.id} requires at least ${block.count.min} media assets`);
     }
   }
 }
@@ -902,7 +903,7 @@ function validateBlock(
 function validateMediaSpec(item: PublicationItem, media: LayoutMediaSpec, label: string): void {
   const matchingAssets = findAssetsByRole(item, media.assetRole);
   if (media.required && matchingAssets.length === 0) {
-    throw new Error(`${label} requires an image asset${media.assetRole ? ` with role ${media.assetRole}` : ""}`);
+    warnAboutMissingMedia(`${label} requires an image asset${media.assetRole ? ` with role ${media.assetRole}` : ""} and renders without it`);
   }
 }
 

package/lib/layout-warnings.ts

@@ -0,0 +1,8 @@
+const missingMediaWarningsAlreadyLogged = new Set<string>();
+
+/** A story without its lead image must still publish; the layout renders without the slot. */
+export function warnAboutMissingMedia(message: string): void {
+  if (missingMediaWarningsAlreadyLogged.has(message)) return;
+  missingMediaWarningsAlreadyLogged.add(message);
+  console.warn(`[layout-plan] ${message}`);
+}

package/lib/local-preview-seed.ts

@@ -1,4 +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";
 
@@ -93,3 +96,53 @@ 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,
+    frontMatterYaml: `title: ${headline}\nsection: ${version.section ?? ""}`,
+    bodyMarkus: `# ${headline}\n\nThe local preview shows this story's record. Its full body text is loaded from the live backend.`,
+    contentHash: null,
+    status: version.status === "published" ? "published" : "draft",
+    versionNumber: version.versionNumber,
+    aliases: [],
+    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),