@anthusai/papyrus 1.10.0 → 1.12.0

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/tenant-keys.ts

@@ -0,0 +1,32 @@
+export const TENANT_ID_ENVIRONMENT_VARIABLE = "PAPYRUS_TENANT_ID";
+const TENANT_KEY_SEPARATOR = "#";
+const TENANT_ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,62}$/;
+
+export function validateTenantId(tenantId: string): string {
+  if (!TENANT_ID_PATTERN.test(tenantId)) {
+    throw new Error(`Tenant id "${tenantId}" must be lowercase letters, digits and hyphens, starting with a letter or digit.`);
+  }
+  return tenantId;
+}
+
+export function tenantIdFromEnvironment(environment: NodeJS.ProcessEnv = process.env): string | undefined {
+  const configured = environment[TENANT_ID_ENVIRONMENT_VARIABLE]?.trim();
+  return configured ? validateTenantId(configured) : undefined;
+}
+
+export function tenantScopedValue(tenantId: string | undefined, value: string): string {
+  if (!tenantId) return value;
+  const prefix = `${tenantId}${TENANT_KEY_SEPARATOR}`;
+  return value.startsWith(prefix) ? value : `${prefix}${value}`;
+}
+
+export function rowBelongsToTenant(tenantId: string | undefined, row: { tenantId?: string | null } | null | undefined): boolean {
+  if (!tenantId || !row) return true;
+  return row.tenantId === tenantId;
+}
+
+/** The tenant a Prospectus publishing account maps to: its id as lowercase letters, digits and hyphens. */
+export function tenantIdForProspectusAccount(accountId: string | null | undefined): string | undefined {
+  const normalized = (accountId ?? "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 63);
+  return normalized ? validateTenantId(normalized) : undefined;
+}

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

@@ -64,6 +64,7 @@
       "types": "./infra/amplify-app-shell.ts",
       "default": "./infra/index.js"
     },
+    "./components/administration-delegations-panel": "./components/administration-delegations-panel.tsx",
     "./components/ai-elements/conversation": "./components/ai-elements/conversation.tsx",
     "./components/ai-elements/model-selector": "./components/ai-elements/model-selector.tsx",
     "./components/ai-elements/prompt-input": "./components/ai-elements/prompt-input.tsx",
@@ -75,6 +76,8 @@
     "./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/curation-delegation-client": "./components/curation-delegation-client.ts",
     "./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 +103,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",
@@ -108,12 +112,16 @@
     "./components/reference-curation-controls": "./components/reference-curation-controls.tsx",
     "./components/reference-cyclotron-priming": "./components/reference-cyclotron-priming.tsx",
     "./components/reference-cyclotron-status": "./components/reference-cyclotron-status.tsx",
+    "./components/reference-cyclotron-suggestion": "./components/reference-cyclotron-suggestion.tsx",
+    "./components/reference-live-agreement": "./components/reference-live-agreement.tsx",
     "./components/reference-priming": "./components/reference-priming.tsx",
     "./components/reference-relevance-review": "./components/reference-relevance-review.tsx",
     "./components/reference-source-preview": "./components/reference-source-preview.tsx",
     "./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 +147,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",
@@ -166,6 +176,8 @@
     "./lib/content-source-context": "./lib/content-source-context.ts",
     "./lib/content-types": "./lib/content-types.ts",
     "./lib/curation-client": "./lib/curation-client.ts",
+    "./lib/curation-delegation-helpers": "./lib/curation-delegation-helpers.ts",
+    "./lib/cyclotron-suggestions": "./lib/cyclotron-suggestions.ts",
     "./lib/define-site": "./lib/define-site.ts",
     "./lib/demo-amplify-outputs": "./lib/demo-amplify-outputs.ts",
     "./lib/dev-sandbox-editor-auth": "./lib/dev-sandbox-editor-auth.ts",
@@ -174,6 +186,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",
@@ -185,6 +198,7 @@
     "./lib/layout-types": "./lib/layout-types.ts",
     "./lib/layout-warnings": "./lib/layout-warnings.ts",
     "./lib/local-preview-seed": "./lib/local-preview-seed.ts",
+    "./lib/local-preview-tenant": "./lib/local-preview-tenant.ts",
     "./lib/local-preview": "./lib/local-preview.ts",
     "./lib/markus-body": "./lib/markus-body.ts",
     "./lib/markus-ir": "./lib/markus-ir.ts",
@@ -227,6 +241,7 @@
     "./lib/prospectus-session": "./lib/prospectus-session.ts",
     "./lib/prospectus-sign-in-routes": "./lib/prospectus-sign-in-routes.ts",
     "./lib/prospectus-site-identity": "./lib/prospectus-site-identity.ts",
+    "./lib/prospectus-tenant": "./lib/prospectus-tenant.ts",
     "./lib/public-placeholder-config": "./lib/public-placeholder-config.ts",
     "./lib/publication-cyclotron": "./lib/publication-cyclotron.ts",
     "./lib/publication-items": "./lib/publication-items.ts",
@@ -259,6 +274,8 @@
     "./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/tenant-keys": "./lib/tenant-keys.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 +283,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 +306,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 +374,7 @@
       "optional": true
     }
   },
-  "version": "1.10.0",
+  "version": "1.12.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.10.0",
+  "version": "1.12.0",
   "routes": [
     {
       "file": "app/%5F_preview/[[...path]]/route.ts",
@@ -129,6 +129,26 @@
       ],
       "config": {}
     },
+    {
+      "file": "app/api/local-preview/derive/route.ts",
+      "hasDefault": false,
+      "exports": [
+        "POST"
+      ],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/api/local-preview/media/route.ts",
+      "hasDefault": false,
+      "exports": [
+        "GET"
+      ],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
     {
       "file": "app/api/media/[...path]/route.ts",
       "hasDefault": false,
@@ -230,17 +250,13 @@
       "file": "app/newsroom/insights/[threadId]/page.tsx",
       "hasDefault": true,
       "exports": [],
-      "config": {
-        "dynamic": "\"force-dynamic\""
-      }
+      "config": {}
     },
     {
       "file": "app/newsroom/insights/page.tsx",
       "hasDefault": true,
       "exports": [],
-      "config": {
-        "dynamic": "\"force-dynamic\""
-      }
+      "config": {}
     },
     {
       "file": "app/newsroom/layout.tsx",