@anthusai/papyrus 1.4.0-next.6 → 1.4.0-next.7

package/lib/local-preview-seed.ts

@@ -1,4 +1,5 @@
-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";
@@ -166,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/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/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",
@@ -368,7 +374,7 @@
       "optional": true
     }
   },
-  "version": "1.4.0-next.6",
+  "version": "1.4.0-next.7",
   "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.4.0-next.6",
+  "version": "1.4.0-next.7",
   "routes": [
     {
       "file": "app/%5F_preview/[[...path]]/route.ts",