@anthusai/papyrus 1.11.0 → 1.13.0

package/lib/local-preview-seed.ts

@@ -1,14 +1,16 @@
-import type { AssignmentRecord, ReferenceRecord } from "./category-repository";
+import type { AssignmentRecord, MessageRecord, ReferenceRecord, SemanticRelationRecord } from "./category-repository";
+import { SHADOW_AGREEMENT_SCHEMA, type ShadowAgreement } from "./cyclotron-suggestions";
 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";
+import { LOCAL_PREVIEW_TENANTS, getLocalPreviewTenantId } from "./local-preview-tenant";
 
 const SEED_TIMESTAMP_BASE = Date.parse("2026-10-01T12:00:00.000Z");
 const ONE_HOUR_IN_MILLISECONDS = 60 * 60 * 1000;
 
-const SEED_CONTENT_ITEM_HEADLINES_BY_POSITION: readonly (readonly string[])[] = [
+const SEED_CONTENT_ITEM_HEADLINES_BY_POSITION_FOR_TENANT_ZERO: readonly (readonly string[])[] = [
   ["Three sources confirm the zoning reversal", "Reporting packet: school board redistricting"],
   ["Draft in progress: the last ferry crossing", "Draft in progress: neighborhood bakery profile"],
   ["Illustration brief: flooded streets, aerial view", "Illustration brief: the market at dawn"],
@@ -18,6 +20,24 @@ const SEED_CONTENT_ITEM_HEADLINES_BY_POSITION: readonly (readonly string[])[] =
   ["Spiked: the unconfirmed council rumor", "Spiked: the recycled press release"],
 ];
 
+const SEED_CONTENT_ITEM_HEADLINES_BY_POSITION_FOR_TENANT_ONE: readonly (readonly string[])[] = [
+  ["Field note: spore dispersal on a damp morning", "Field note: the dung beetle census"],
+  ["Draft in progress: why fungi throw their caps", "Draft in progress: the compost experiment"],
+  ["Illustration brief: a cap in flight, close up", "Illustration brief: the mycelium network"],
+  ["Layout pass: the monthly field guide", "Layout pass: the reader mailbag"],
+  ["Published: a season of mushroom sightings", "Published: how the forest floor recycles"],
+  ["Held for spring: the truffle hunt", "Evergreen: a beginner's guide to identification"],
+  ["Spiked: the unverified foraging claim", "Spiked: the duplicate field report"],
+];
+
+const SEED_CONTENT_ITEM_HEADLINES_BY_TENANT = [SEED_CONTENT_ITEM_HEADLINES_BY_POSITION_FOR_TENANT_ZERO, SEED_CONTENT_ITEM_HEADLINES_BY_POSITION_FOR_TENANT_ONE] as const;
+
+function headlinesForSelectedTenant(): readonly (readonly string[])[] {
+  const tenantId = getLocalPreviewTenantId();
+  const tenant = LOCAL_PREVIEW_TENANTS.find(candidate => candidate.accountId === tenantId) ?? LOCAL_PREVIEW_TENANTS[0];
+  return SEED_CONTENT_ITEM_HEADLINES_BY_TENANT[tenant.fixtureHeadlineSet] ?? SEED_CONTENT_ITEM_HEADLINES_BY_TENANT[0];
+}
+
 function isoTimestampHoursBeforeBase(hours: number): string {
   return new Date(SEED_TIMESTAMP_BASE - hours * ONE_HOUR_IN_MILLISECONDS).toISOString();
 }
@@ -29,7 +49,8 @@ function slugFromHeadline(headline: string): string {
 export function createLocalPreviewContentItemVersions(): ContentItemVersionRecord[] {
   const stageKeys = contentItemStageKeys(getContentItemStageDefinitions());
   return stageKeys.flatMap((stageKey, stageIndex) => {
-    const headlines = SEED_CONTENT_ITEM_HEADLINES_BY_POSITION[stageIndex % SEED_CONTENT_ITEM_HEADLINES_BY_POSITION.length];
+    const tenantHeadlines = headlinesForSelectedTenant();
+    const headlines = tenantHeadlines[stageIndex % tenantHeadlines.length];
     return headlines.map((headline, headlineIndex) => {
       const slug = slugFromHeadline(headline);
       return {
@@ -146,3 +167,120 @@ export function createLocalPreviewReportingTrail(lineageId: string): StoryReport
 export function createLocalPreviewMediaAssets(_itemId: string): MediaAssetRecord[] {
   return [];
 }
+
+type PreviewSuggestionPlan = {
+  label: "include" | "exclude";
+  confidence: number;
+  curation: "none" | "human" | "service" | "delegated";
+  provenance: boolean;
+};
+
+const PREVIEW_SUGGESTION_PLANS: readonly PreviewSuggestionPlan[] = [
+  { label: "include", confidence: 0.91, curation: "none", provenance: true },
+  { label: "include", confidence: 0.86, curation: "human", provenance: true },
+  { label: "exclude", confidence: 0.72, curation: "service", provenance: true },
+  { label: "exclude", confidence: 0.88, curation: "delegated", provenance: true },
+  { label: "exclude", confidence: 0.64, curation: "none", provenance: false },
+];
+
+const PREVIEW_CYCLOTRON_ID = "papyrus-relevance";
+
+/**
+ * Fixture data for reviewing the cyclotron suggestion UI without a backend:
+ * suggestions with provenance on the first references, a mix of human and
+ * non-human curation messages, and a live-agreement payload.
+ */
+export function createLocalPreviewCyclotronFixtures(references: ReferenceRecord[]): {
+  relations: SemanticRelationRecord[];
+  messages: MessageRecord[];
+  shadowAgreement: ShadowAgreement;
+} {
+  const relations: SemanticRelationRecord[] = [];
+  const messages: MessageRecord[] = [];
+  references.slice(0, PREVIEW_SUGGESTION_PLANS.length).forEach((reference, index) => {
+    const plan = PREVIEW_SUGGESTION_PLANS[index];
+    const lineageId = reference.lineageId ?? reference.id;
+    const decidedAt = isoTimestampHoursBeforeBase(40 - index);
+    relations.push({
+      id: `preview-relevance-relation-${index}`,
+      relationState: "current",
+      predicate: "relevance_decision_is",
+      subjectKind: "reference",
+      subjectId: reference.id,
+      subjectLineageId: lineageId,
+      objectKind: "semanticNode",
+      objectId: `semantic-node-relevance-${plan.label}-v1`,
+      objectLineageId: `semantic-node-relevance-${plan.label}`,
+      subjectStateKey: `reference#${lineageId}#current`,
+      objectStateKey: `semanticNode#semantic-node-relevance-${plan.label}#current`,
+      objectSubjectStateKey: `semanticNode#semantic-node-relevance-${plan.label}#current#reference`,
+      predicateObjectStateKey: `relevance_decision_is#semanticNode#semantic-node-relevance-${plan.label}#current`,
+      subjectVersionKey: `reference#${reference.id}`,
+      objectVersionKey: `semanticNode#semantic-node-relevance-${plan.label}-v1`,
+      confidence: plan.confidence,
+      modelVersion: "4",
+      reviewRecommended: false,
+      metadata: JSON.stringify({
+        decisionId: `preview-decision-${index}`,
+        label: plan.label,
+        probabilities: { include: plan.label === "include" ? plan.confidence : 1 - plan.confidence, exclude: plan.label === "exclude" ? plan.confidence : 1 - plan.confidence },
+        version: 4,
+        decidedAt,
+        labels: ["include", "exclude"],
+        positiveLabel: "include",
+        question: "Should this source be used as evidence for the publication?",
+        cyclotronId: PREVIEW_CYCLOTRON_ID,
+        ...(plan.provenance ? {
+          provenance: {
+            labelSet: ["include", "exclude"],
+            doctrineFingerprint: "3f9c2a71d80b46e5",
+            teachingFingerprint: "b71e04c9aa5d2f13",
+            teachingLabels: 37,
+            primingExamples: 6,
+          },
+        } : {}),
+      }),
+    } as SemanticRelationRecord);
+    if (plan.curation !== "none") {
+      const createdAt = isoTimestampHoursBeforeBase(30 - index);
+      messages.push({
+        id: `preview-curation-message-${index}`,
+        messageKind: "reference_curation",
+        messageDomain: "commentary",
+        status: "active",
+        summary: `${reference.title ?? lineageId}: curated`,
+        authorLabel: plan.curation === "delegated" ? "Maya Okafor" : null,
+        source: "newsroom",
+        createdAt,
+        updatedAt: createdAt,
+        metadata: JSON.stringify({
+          action: reference.curationStatus === "rejected" ? "reject" : "accept",
+          curationStatus: reference.curationStatus,
+          referenceLineageId: lineageId,
+          actorKind: plan.curation === "service" ? "service" : "human",
+          ...(plan.curation === "delegated" ? {
+            attestation: "delegated",
+            relayedBy: "newsroom-reporter",
+            delegationId: "curation-delegation-9b1f6c24-5d0e-4a7b-8c31-2e6f0a1d7b45",
+            instruction: "Reject that one, it duplicates the filing from Tuesday.",
+          } : {}),
+        }),
+      });
+    }
+  });
+  return {
+    relations,
+    messages,
+    shadowAgreement: {
+      schema: SHADOW_AGREEMENT_SCHEMA,
+      comparisons: 23,
+      agreement: 0.87,
+      precision: 0.9,
+      recall: 0.82,
+      confusion: { truePositive: 9, falsePositive: 1, falseNegative: 2, trueNegative: 11 },
+      computedAt: isoTimestampHoursBeforeBase(3),
+      positiveLabel: "include",
+      loop: { enabled: true, stoppedBecause: "daily decision cap", lastSweepAt: isoTimestampHoursBeforeBase(3), maxDecisionsPerDay: 50 },
+    },
+  };
+}

package/lib/local-preview-tenant.ts

@@ -0,0 +1,27 @@
+/**
+ * The local preview stands in for the multi-tenant newsroom: choosing a publishing account in the account menu
+ * switches which publication's content the preview shows. The choice is a cookie so server and browser agree.
+ */
+export const LOCAL_PREVIEW_TENANT_COOKIE = "papyrus-preview-tenant";
+export const LOCAL_PREVIEW_DEFAULT_TENANT_ID = "preview-papyrus";
+
+export type LocalPreviewTenant = { accountId: string; name: string; role: string; fixtureHeadlineSet: number };
+
+export const LOCAL_PREVIEW_TENANTS: readonly LocalPreviewTenant[] = [
+  { accountId: LOCAL_PREVIEW_DEFAULT_TENANT_ID, name: "Papyrus", role: "publisher", fixtureHeadlineSet: 0 },
+  { accountId: "preview-pilobolus", name: "Pilobolus", role: "editor", fixtureHeadlineSet: 1 },
+];
+
+export function previewTenantIdFromCookieHeader(cookieHeader: string | null | undefined): string {
+  const match = cookieHeader?.split(";").map(part => part.trim()).find(part => part.startsWith(`${LOCAL_PREVIEW_TENANT_COOKIE}=`));
+  const value = match ? decodeURIComponent(match.slice(LOCAL_PREVIEW_TENANT_COOKIE.length + 1)) : "";
+  return LOCAL_PREVIEW_TENANTS.some(tenant => tenant.accountId === value) ? value : LOCAL_PREVIEW_DEFAULT_TENANT_ID;
+}
+
+export function getLocalPreviewTenantId(): string {
+  return typeof document === "undefined" ? LOCAL_PREVIEW_DEFAULT_TENANT_ID : previewTenantIdFromCookieHeader(document.cookie);
+}
+
+export function setLocalPreviewTenantId(accountId: string): void {
+  document.cookie = `${LOCAL_PREVIEW_TENANT_COOKIE}=${encodeURIComponent(accountId)}; path=/; max-age=31536000; samesite=lax`;
+}

package/lib/prospectus-tenant.ts

@@ -0,0 +1,22 @@
+import {
+  PROSPECTUS_SESSION_COOKIE,
+  loadProspectusSessionSealingSecret,
+  openProspectusCookie,
+  type ProspectusSignedInSession,
+} from "./prospectus-session";
+import { tenantIdForProspectusAccount } from "./tenant-keys";
+
+type CookieReader = { get(name: string): { value: string } | undefined };
+
+/**
+ * The tenant of the publishing account the signed-in person selected, read from the sealed Prospectus session
+ * cookie. Returns undefined on a site without Prospectus, with no session, or with no account selected, so the
+ * caller falls back to the site's own tenant (PAPYRUS_TENANT_ID).
+ */
+export async function selectedTenantIdFromCookies(cookies: CookieReader, loadSecret: () => Promise<string | null> = loadProspectusSessionSealingSecret): Promise<string | undefined> {
+  const sealingSecret = await loadSecret();
+  if (!sealingSecret) return undefined;
+  const session = openProspectusCookie<ProspectusSignedInSession>(sealingSecret, PROSPECTUS_SESSION_COOKIE, cookies.get(PROSPECTUS_SESSION_COOKIE)?.value);
+  if (!session || session.accessTokenExpiresAt * 1000 <= Date.now()) return undefined;
+  return tenantIdForProspectusAccount(session.selectedAccountId);
+}

package/lib/relevance-decisions.ts

@@ -2,6 +2,15 @@ import type { SemanticRelationRecord } from "./category-repository";
 
 export const RELEVANCE_RELATION = "relevance_decision_is";
 
+/** What produced a suggestion beyond the model version, as the sweep recorded it. */
+export type RelevanceProvenance = {
+  labelSet: string[];
+  doctrineFingerprint: string | null;
+  teachingFingerprint: string | null;
+  teachingLabels: number;
+  primingExamples: number;
+};
+
 /** The relevance cyclotron's current decision about one reference, as the References tab shows it. */
 export type RelevanceDecisionView = {
   decisionRelationId: string;
@@ -19,6 +28,10 @@ export type RelevanceDecisionView = {
   /** Thumbs for a two-class decision with a positive label; per-class buttons otherwise. */
   reviewControl: "thumbs" | "labels";
   cyclotronId: string | null;
+  /** When the cyclotron made the suggestion, if the decision recorded it. */
+  decidedAt: string | null;
+  /** Null for decisions made before provenance was recorded. */
+  provenance: RelevanceProvenance | null;
 };
 
 /** What an editor submits from the review control. */
@@ -49,6 +62,20 @@ function parseMetadata(value: unknown): Record<string, unknown> {
   }
 }
 
+function parseProvenance(value: unknown): RelevanceProvenance | null {
+  const record = parseMetadata(value);
+  if (!Object.keys(record).length) return null;
+  const count = (entry: unknown) => (Number.isFinite(Number(entry)) ? Number(entry) : 0);
+  const text = (entry: unknown) => (typeof entry === "string" && entry ? entry : null);
+  return {
+    labelSet: Array.isArray(record.labelSet) ? record.labelSet.map(String) : [],
+    doctrineFingerprint: text(record.doctrineFingerprint),
+    teachingFingerprint: text(record.teachingFingerprint),
+    teachingLabels: count(record.teachingLabels),
+    primingExamples: count(record.primingExamples),
+  };
+}
+
 /**
  * Current decisions keyed by reference lineage, from relations the Newsroom
  * already loads: no extra request per row.
@@ -77,6 +104,8 @@ export function currentRelevanceDecisions(relations: SemanticRelationRecord[]):
       question: typeof metadata.question === "string" ? metadata.question : null,
       reviewControl: metadata.reviewControl === "thumbs" ? "thumbs" : "labels",
       cyclotronId: typeof metadata.cyclotronId === "string" ? metadata.cyclotronId : null,
+      decidedAt: typeof metadata.decidedAt === "string" ? metadata.decidedAt : null,
+      provenance: parseProvenance(metadata.provenance),
     });
   }
   return decisions;

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/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",
@@ -76,6 +77,7 @@
     "./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",
@@ -110,6 +112,8 @@
     "./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",
@@ -172,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",
@@ -192,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",
@@ -234,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",
@@ -267,6 +275,7 @@
     "./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",
@@ -365,7 +374,7 @@
       "optional": true
     }
   },
-  "version": "1.11.0",
+  "version": "1.13.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.11.0",
+  "version": "1.13.0",
   "routes": [
     {
       "file": "app/%5F_preview/[[...path]]/route.ts",