@anthusai/papyrus 1.2.0 → 1.3.0

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

@@ -39,7 +39,8 @@ import type {
   UserDirectoryEntry,
 } from "../lib/category-repository";
 import { relationTypeKey } from "../lib/semantic-graph";
-import { CONTENT_ITEM_STAGES, type ContentItemVersionRecord } from "../lib/content-item-lifecycle";
+import { contentItemStageKeys, type ContentItemVersionRecord } from "../lib/content-item-lifecycle";
+import { getContentItemStageDefinitions } from "../lib/site-brand";
 import { DOCTRINE_DEFINITIONS, getCategoryDoctrineDefinitions, type DoctrineCategory } from "../lib/doctrine";
 import { configureAmplifyClient } from "./amplify-client-provider";
 import { isUnauthenticatedError, loadReaderSessionSnapshot, type ReaderAuthSnapshot } from "./reader-auth-state";
@@ -2173,7 +2174,7 @@ export async function loadNewsroomContentItemVersions(): Promise<ContentItemVers
     graphql: (options: Record<string, unknown>) => Promise<GraphQLConnectionResponse<ContentItemVersionRecord>>;
   };
   const field = "listItemsByStageAndUpdatedAt";
-  const versionsPerStage = await Promise.all(CONTENT_ITEM_STAGES.map(async (stage) => {
+  const versionsPerStage = await Promise.all(contentItemStageKeys(getContentItemStageDefinitions()).map(async (stage) => {
     const versions: ContentItemVersionRecord[] = [];
     let nextToken: string | null = null;
     do {
@@ -2193,6 +2194,62 @@ export async function loadNewsroomContentItemVersions(): Promise<ContentItemVers
   return versionsPerStage.flat();
 }
 
+const PUBLISHED_ITEMS_QUERY = `
+  query ListPublishedItems($limit: Int, $nextToken: String) {
+    listPublishedItems(limit: $limit, nextToken: $nextToken) {
+      items { sourceItemId itemLineageId versionNumber type status title headline slug section publishedAt }
+      nextToken
+    }
+  }
+`;
+
+type PublishedItemBoardRow = {
+  sourceItemId: string;
+  itemLineageId: string;
+  versionNumber: number;
+  type: string;
+  status: string;
+  title?: string | null;
+  headline?: string | null;
+  slug: string;
+  section?: string | null;
+  publishedAt?: string | null;
+};
+
+export async function loadNewsroomPublishedContentItemVersions(): Promise<ContentItemVersionRecord[]> {
+  configureAmplifyClient();
+  const client = generateClient<Schema>() as unknown as {
+    graphql: (options: Record<string, unknown>) => Promise<GraphQLConnectionResponse<PublishedItemBoardRow>>;
+  };
+  const rows: PublishedItemBoardRow[] = [];
+  let nextToken: string | null = null;
+  do {
+    const response: GraphQLConnectionResponse<PublishedItemBoardRow> = await client.graphql({
+      query: PUBLISHED_ITEMS_QUERY,
+      variables: { limit: NEWSROOM_PAGE_LIMIT, nextToken },
+      authMode: USER_POOL_AUTH_MODE,
+    });
+    assertNoGraphQLErrors(response.errors);
+    const connection = response.data?.listPublishedItems;
+    if (!connection) throw new Error("Missing GraphQL connection payload for listPublishedItems.");
+    rows.push(...((connection.items ?? []).filter(Boolean) as PublishedItemBoardRow[]));
+    nextToken = connection.nextToken ?? null;
+  } while (nextToken);
+  return rows.map(row => ({
+    id: row.sourceItemId,
+    lineageId: row.itemLineageId,
+    versionNumber: row.versionNumber,
+    stage: "published",
+    type: row.type,
+    status: row.status,
+    title: row.title,
+    headline: row.headline,
+    slug: row.slug,
+    section: row.section,
+    updatedAt: row.publishedAt,
+  }));
+}
+
 export async function loadModelPayloadsForOwner(
   ownerKind: string,
   ownerId: string,

package/components/newsroom-board-view.tsx

@@ -6,9 +6,10 @@ import { IssueCollection, IssueDetailPanel, IssueTypeFilter, issueTypeFromFilter
 import "@kanbus/ui/styles/kanban.css";
 import "./newsroom-newsprint-board.css";
 import { canReadNewsroomBoard, contentItemBoardType, newsroomBoardConfig, projectNewsroomBoard, type NativeBoardIssue } from "../lib/newsroom-board";
+import type { AssignmentRecord } from "../lib/category-repository";
 import { getContentItemName, SITE_BRAND } from "../lib/site-brand";
 import { getNewsroomNavHref } from "../lib/newsroom-nav";
-import { loadNewsroomAssignmentPage, loadNewsroomContentItemVersions, loadNewsroomReferencePage } from "./news-desk-taxonomy-client";
+import { loadNewsroomAssignmentPage, loadNewsroomContentItemVersions, loadNewsroomPublishedContentItemVersions } from "./news-desk-taxonomy-client";
 import { useOptionalNewsDeskClient } from "./news-desk-client-provider";
 import { NewsDeskAccessGate } from "./newsroom-access-gate";
 import { NewsroomOpsShell, NewsroomOpsStatusBanner } from "./newsroom-ops-shell";
@@ -17,6 +18,17 @@ import { readLocalReaderSettings, subscribeReaderSettingsChanges } from "./reade
 
 const STATIC_MOTION = { mode: "static" } as const;
 
+async function loadEveryNewsroomAssignment() {
+  const assignments: AssignmentRecord[] = [];
+  let nextToken: string | null | undefined;
+  do {
+    const page = await loadNewsroomAssignmentPage({ limit: 100, nextToken });
+    assignments.push(...page.items);
+    nextToken = page.nextToken;
+  } while (nextToken);
+  return assignments;
+}
+
 /** Read-only shared board over authenticated CMS records; existing workspaces own every mutation. */
 export function NewsroomBoardView() {
   const session = useOptionalNewsDeskClient();
@@ -30,47 +42,27 @@ export function NewsroomBoardView() {
   const [selected, setSelected] = useState<string | null>(null);
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
-  const [tokens, setTokens] = useState<{ reference?: string | null; assignment?: string | null }>({});
   const generation = useRef(0);
-  const busy = useRef(false);
   useEffect(() => {
     setLowMotion(readLocalReaderSettings().motion === "low");
     return subscribeReaderSettingsChanges(settings => setLowMotion(settings.motion === "low"));
   }, []);
   useEffect(() => {
     const request = ++generation.current;
-    busy.current = false;
-    setIssues([]); setSelected(null); setTokens({}); setError(null);
+    setIssues([]); setSelected(null); setError(null);
     if (!allowed) { setLoading(false); return; }
-    setLoading(true); busy.current = true;
+    setLoading(true);
     Promise.all([
-      loadNewsroomContentItemVersions(),
-      loadNewsroomReferencePage({ limit: 50 }),
-      loadNewsroomAssignmentPage({ limit: 50 }),
-    ]).then(([contentItemVersions, references, assignments]) => {
+      Promise.all([loadNewsroomContentItemVersions(), loadNewsroomPublishedContentItemVersions()]).then(([workingVersions, publishedVersions]) => [...workingVersions, ...publishedVersions]),
+      loadEveryNewsroomAssignment(),
+    ]).then(([contentItemVersions, assignments]) => {
       if (generation.current !== request) return;
-      setIssues(projectNewsroomBoard({ contentItemVersions, references: references.items, assignments: assignments.items }));
-      setTokens({ reference: references.nextToken, assignment: assignments.nextToken });
+      setIssues(projectNewsroomBoard({ contentItemVersions, assignments }));
     }).catch((reason: unknown) => {
       if (generation.current === request) setError(reason instanceof Error ? reason.message : "Could not load newsroom records.");
-    }).finally(() => { if (generation.current === request) { setLoading(false); busy.current = false; } });
+    }).finally(() => { if (generation.current === request) { setLoading(false); } });
     return () => { generation.current = request + 1; };
   }, [allowed, revision]);
-  async function loadMore(kind: "reference" | "assignment") {
-    if (!allowed || busy.current || !tokens[kind]) return;
-    const request = generation.current;
-    busy.current = true; setLoading(true); setError(null);
-    try {
-      const added = kind === "reference"
-        ? await loadNewsroomReferencePage({ limit: 50, nextToken: tokens.reference }).then(page => ({ issues: projectNewsroomBoard({ references: page.items }), token: page.nextToken }))
-        : await loadNewsroomAssignmentPage({ limit: 50, nextToken: tokens.assignment }).then(page => ({ issues: projectNewsroomBoard({ assignments: page.items }), token: page.nextToken }));
-      if (generation.current !== request) return;
-      setIssues(current => [...new Map([...current, ...added.issues].map(issue => [issue.id, issue])).values()]);
-      setTokens(current => ({ ...current, [kind]: added.token }));
-    } catch (reason) {
-      if (generation.current === request) setError(reason instanceof Error ? reason.message : "Could not load more records.");
-    } finally { if (generation.current === request) { setLoading(false); busy.current = false; } }
-  }
   const config = useMemo(() => newsroomBoardConfig(issues), [issues]);
   const issue = issues.find(item => item.id === selected);
   if (!allowed) return <NewsDeskAccessGate shell={session?.shell ?? null} />;
@@ -82,7 +74,7 @@ export function NewsroomBoardView() {
       </div>
       <p className="organizer-board-note">{`Each ${getContentItemName().singular.toLowerCase()} appears once, in the column for its stage. Open a record to use its existing editor or workflow controls.`}</p>
       {error && <NewsroomOpsStatusBanner tone="error">{error}</NewsroomOpsStatusBanner>}
-      <p role="status" className="organizer-board-note">{loading ? "Loading records…" : `${issues.length} records loaded. References and assignments load in pages.`}</p>
+      <p role="status" className="organizer-board-note">{loading ? "Loading records…" : `${issues.length} records loaded.`}</p>
       <div className="organizer-board-body" data-detail-open={Boolean(issue)}>
         <IssueCollection issues={issues} config={config} query={{ type: issueTypeFromFilter(filter) }} view={view}
           motion={lowMotion ? STATIC_MOTION : undefined}
@@ -93,7 +85,6 @@ export function NewsroomBoardView() {
           <Link href={getNewsroomNavHref(issue.href)}>Open {issue.type}</Link>
         </IssueDetailPanel>}
       </div>
-      <div className="organizer-board-pages">{tokens.reference && <button disabled={loading} type="button" onClick={() => void loadMore("reference")}>Load more references</button>}{tokens.assignment && <button disabled={loading} type="button" onClick={() => void loadMore("assignment")}>Load more assignments</button>}</div>
     </div>
   </NewsroomOpsShell>;
 }

package/components/newsroom-organizer.css

@@ -37,8 +37,8 @@ body:has(.newsroom-organizer)>[data-staging-banner]{flex-shrink:0}
 .organizer-main:has(.organizer-native-board){display:flex;overflow:hidden}
 .organizer-native-board{display:flex;flex-direction:column;flex:1;min-height:0;min-width:0;gap:12px}
 .organizer-board-toolbar{display:flex;align-items:center;justify-content:space-between;gap:12px;min-width:0;flex-wrap:wrap}
-.organizer-board-toolbar [role=group],.organizer-board-pages{display:flex;gap:8px;flex-wrap:wrap}
-.organizer-board-toolbar button,.organizer-board-pages button{min-height:44px;padding:8px 12px;border:1px solid var(--org-line)}
+.organizer-board-toolbar [role=group]{display:flex;gap:8px;flex-wrap:wrap}
+.organizer-board-toolbar button{min-height:44px;padding:8px 12px;border:1px solid var(--org-line)}
 .organizer-board-toolbar button[aria-pressed=true]{background:var(--org-ink);color:var(--org-paper)}
 .organizer-board-note{font-size:11px;line-height:1.5;margin:0;color:var(--org-muted)}
 .organizer-board-body{position:relative;display:grid;grid-template-columns:minmax(0,1fr);flex:1;min-width:0;min-height:0;gap:16px}

package/lib/content-item-lifecycle.ts

@@ -1,36 +1,35 @@
 /**
  * One content item, one lifecycle: the stages an Item lineage moves through.
- * Mirrors CONTENT_ITEM_STAGES in src/papyrus_content/content_item_lifecycle.py.
+ * The default stages mirror CONTENT_ITEM_STAGES in src/papyrus_content/content_item_lifecycle.py;
+ * a publication overrides them with SiteBrand.contentItemStages.
  * See docs/content-item-lifecycle.md.
  */
-export const CONTENT_ITEM_STAGES = [
-  "idea",
-  "assignment",
-  "research",
-  "report",
-  "editor_select",
-  "copywriting",
-  "illustration",
-  "typesetting",
-  "published",
-] as const;
+export type ContentItemStageDefinition = {
+  key: string;
+  label: string;
+};
 
-export type ContentItemStage = (typeof CONTENT_ITEM_STAGES)[number];
+export const DEFAULT_CONTENT_ITEM_STAGE_DEFINITIONS: readonly ContentItemStageDefinition[] = [
+  { key: "idea", label: "Idea" },
+  { key: "assignment", label: "Assignment" },
+  { key: "research", label: "Research" },
+  { key: "report", label: "Report" },
+  { key: "editor_select", label: "Editor select" },
+  { key: "copywriting", label: "Copywriting" },
+  { key: "illustration", label: "Illustration" },
+  { key: "typesetting", label: "Typesetting" },
+  { key: "published", label: "Published" },
+];
 
-const CONTENT_ITEM_STAGE_LABELS: Record<ContentItemStage, string> = {
-  idea: "Idea",
-  assignment: "Assignment",
-  research: "Research",
-  report: "Report",
-  editor_select: "Editor select",
-  copywriting: "Copywriting",
-  illustration: "Illustration",
-  typesetting: "Typesetting",
-  published: "Published",
-};
+export function contentItemStageKeys(stageDefinitions: readonly ContentItemStageDefinition[]): string[] {
+  return stageDefinitions.map(definition => definition.key);
+}
 
-export function contentItemStageLabel(stage: string): string {
-  return (CONTENT_ITEM_STAGE_LABELS as Record<string, string>)[stage] ?? stage;
+export function contentItemStageLabel(
+  stage: string,
+  stageDefinitions: readonly ContentItemStageDefinition[] = DEFAULT_CONTENT_ITEM_STAGE_DEFINITIONS,
+): string {
+  return stageDefinitions.find(definition => definition.key === stage)?.label ?? stage;
 }
 
 export type ContentItemVersionRecord = {

package/lib/newsroom-board.ts

@@ -1,14 +1,14 @@
 import type { KanbanConfig, KanbanIssue } from "@kanbus/ui";
-import type { AssignmentRecord, ReferenceRecord } from "./category-repository";
+import type { AssignmentRecord } from "./category-repository";
 import {
-  CONTENT_ITEM_STAGES,
+  contentItemStageKeys,
   contentItemStageLabel,
   latestVersionPerContentItem,
   type ContentItemVersionRecord,
 } from "./content-item-lifecycle";
-import { getContentItemName } from "./site-brand";
+import { getContentItemName, getContentItemStageDefinitions } from "./site-brand";
 
-export type NativeBoardKind = "contentItem" | "reference" | "assignment";
+export type NativeBoardKind = "contentItem" | "assignment";
 export interface NativeBoardIssue extends KanbanIssue {
   kind: NativeBoardKind;
   nativeId: string;
@@ -26,12 +26,11 @@ function boardTypeForKind(kind: NativeBoardKind): string {
 
 /**
  * One card per content item, in the column for its lifecycle stage. Assignments that are work on a content item
- * are counted on that item's card rather than shown as separate cards. References and other work keep their own
- * identity and native status.
+ * are counted on that item's card rather than shown as separate cards. Other assignments keep their own identity and
+ * native status. References are not shown on the board.
  */
 export function projectNewsroomBoard(records: {
   contentItemVersions?: readonly ContentItemVersionRecord[];
-  references?: readonly ReferenceRecord[];
   assignments?: readonly AssignmentRecord[];
 }): NativeBoardIssue[] {
   const assignmentCountByContentItem = new Map<string, number>();
@@ -52,14 +51,6 @@ export function projectNewsroomBoard(records: {
         updated_at: version.updatedAt ?? undefined, href: `/newsroom/articles/${encodeURIComponent(version.id)}`,
       };
     }),
-    ...(records.references ?? []).filter(row => !row.versionState || row.versionState === "current").map(row => ({
-      id: `reference:${row.id}`, nativeId: row.id, kind: "reference" as const, type: "reference",
-      title: row.title || row.externalItemId || row.id,
-      nativeStatus: row.curationStatus || "pending", status: `reference/${row.curationStatus || "pending"}`,
-      priority: 2, description: row.curationStatusReason || undefined,
-      updated_at: row.updatedAt || row.importedAt || undefined,
-      href: `/newsroom/references/${encodeURIComponent(row.lineageId || row.id)}`,
-    })),
     ...(records.assignments ?? []).filter(row => !row.itemLineageId).map(row => ({
       id: `assignment:${row.id}`, nativeId: row.id, kind: "assignment" as const, type: "assignment",
       title: row.title, nativeStatus: row.status, status: `assignment/${row.status}`,
@@ -71,18 +62,21 @@ export function projectNewsroomBoard(records: {
   ];
 }
 
-export function contentItemColumnOrder(stagesPresentOnBoard: readonly string[]): string[] {
-  const lastStage = CONTENT_ITEM_STAGES[CONTENT_ITEM_STAGES.length - 1];
-  const unrecognizedStages = [...new Set(stagesPresentOnBoard)].filter(stage => !(CONTENT_ITEM_STAGES as readonly string[]).includes(stage));
-  return [...CONTENT_ITEM_STAGES.filter(stage => stage !== lastStage), ...unrecognizedStages, lastStage];
+export function contentItemColumnOrder(
+  stagesPresentOnBoard: readonly string[],
+  stageKeys: readonly string[] = contentItemStageKeys(getContentItemStageDefinitions()),
+): string[] {
+  const lastStage = stageKeys[stageKeys.length - 1];
+  const unrecognizedStages = [...new Set(stagesPresentOnBoard)].filter(stage => !stageKeys.includes(stage));
+  return [...stageKeys.filter(stage => stage !== lastStage), ...unrecognizedStages, lastStage];
 }
 
 /** Content items read left to right through the lifecycle with the final stage last; other record kinds follow it. */
 export function newsroomBoardConfig(issues: readonly NativeBoardIssue[]): KanbanConfig {
   const contentItemType = contentItemBoardType();
-  const kinds: NativeBoardKind[] = ["contentItem", "reference", "assignment"];
+  const kinds: NativeBoardKind[] = ["contentItem", "assignment"];
   const contentItemStatuses = contentItemColumnOrder(issues.filter(issue => issue.kind === "contentItem").map(issue => issue.nativeStatus))
-    .map(stage => ({ key: `${contentItemType}/${stage}`, name: contentItemStageLabel(stage), category: "native" }));
+    .map(stage => ({ key: `${contentItemType}/${stage}`, name: contentItemStageLabel(stage, getContentItemStageDefinitions()), category: "native" }));
   const otherStatuses = [...new Set(issues.filter(issue => issue.kind !== "contentItem").map(issue => issue.status))]
     .map(key => ({ key, name: key.replace("/", " · "), category: "native" }));
   const statuses = [...contentItemStatuses, ...otherStatuses];

package/lib/site-brand.ts

@@ -5,6 +5,7 @@ import type { BlogPageBackgroundProps } from "../components/blog-page-background
 import type { SiteBrandFont } from "./brand-fonts";
 import type { PictogramFigureProps } from "../components/pictogram-figure";
 import papyrusSite from "papyrus-site";
+import { DEFAULT_CONTENT_ITEM_STAGE_DEFINITIONS, type ContentItemStageDefinition } from "./content-item-lifecycle";
 import {
   DEFAULT_THEME_PACK_TOKENS,
   type HostingConfig,
@@ -92,6 +93,8 @@ export type SiteBrand = {
   articleTitleSuffix: string;
   /** Defaults to Story / Stories, the newsroom term. */
   contentItemName?: ContentItemName;
+  /** The lifecycle stages in board order, last one being publication. Defaults to the standard newsroom lifecycle. */
+  contentItemStages?: readonly ContentItemStageDefinition[];
   placeholderByline: string;
   defaultPresentation: EditionPresentationFormat;
   forcedPresentation?: EditionPresentationFormat;
@@ -223,6 +226,10 @@ export function getContentItemName(brand: SiteBrand = SITE_BRAND): ContentItemNa
   return brand.contentItemName ?? DEFAULT_CONTENT_ITEM_NAME;
 }
 
+export function getContentItemStageDefinitions(brand: SiteBrand = SITE_BRAND): readonly ContentItemStageDefinition[] {
+  return brand.contentItemStages?.length ? brand.contentItemStages : DEFAULT_CONTENT_ITEM_STAGE_DEFINITIONS;
+}
+
 /** Root-route config for a brand, defaulting to `{ kind: "reader" }`. */
 export function getRootRoute(brand: SiteBrand = SITE_BRAND): RootRouteConfig {
   return brand.rootRoute ?? { kind: "reader" };

package/package.json

@@ -339,7 +339,7 @@
       "optional": true
     }
   },
-  "version": "1.2.0",
+  "version": "1.3.0",
   "dependencies": {
     "@aws-amplify/adapter-nextjs": "^1.7.3",
     "@aws-crypto/sha256-js": "5.2.0",

package/routes.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.0",
+  "version": "1.3.0",
   "routes": [
     {
       "file": "app/%5F_preview/[[...path]]/route.ts",