@anthusai/papyrus 1.0.0-next.9 → 1.0.0

package/components/topic-steering-workspace.tsx

@@ -10,6 +10,9 @@ import Link from "next/link";
 import { usePathname, useRouter } from "next/navigation";
 import type { ReactNode, RefObject } from "react";
 import { useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useTransition } from "react";
+import amplifyOutputs from "papyrus-amplify-outputs";
+import { SignupEntriesPanel } from "./signup-entries-panel";
+import { pluginSettings, type PluginOutputs } from "../lib/plugin-settings";
 import { generateClient } from "aws-amplify/data";
 import type { Schema } from "../amplify/data/resource";
 import {
@@ -53,6 +56,8 @@ import {
   type ForumThreadWithMessages,
   type KnowledgeQueryResponse,
   type NewsroomRecordPage,
+  loadCyclotronStatus,
+  requestCyclotronReviewRate,
 } from "./news-desk-taxonomy-client";
 import { listConsoleThreads } from "../lib/console-chat-client";
 import {
@@ -76,6 +81,7 @@ import { buildNewsroomKnowledgeQueryInput, type NewsroomKnowledgeQueryAnchor as
 import { NewsroomConsoleProgressToggle, PapyrusConsoleChatIcon, usePapyrusConsole } from "./papyrus-console-shell";
 import { useResolvedPapyrusTheme } from "./use-resolved-papyrus-theme";
 import { SITE_BRAND } from "../lib/site-brand";
+import { browserPathToInternalNewsroomPath, toPublicNewsroomPath } from "../lib/newsroom-base-path";
 import { getNewsroomNavHref } from "../lib/newsroom-nav";
 import { cn } from "../lib/utils";
 import { useOptionalNewsDeskClient } from "./news-desk-client-provider";
@@ -150,9 +156,13 @@ import {
   type SemanticObjectSummary,
 } from "../lib/semantic-graph";
 import {
+  normalizeReferenceRejectionReasonCode,
   REFERENCE_REJECTION_REASON_CODES,
   referenceCurationStatusForAction,
 } from "../lib/reference-policy";
+import { currentRelevanceDecisions } from "../lib/relevance-decisions";
+import { buildReviewRateRequest, DEMO_CYCLOTRON_STATUS } from "../lib/relevance-status";
+import type { CyclotronStatus } from "cyclotron/cyclotron-status";
 import {
   referenceDisplaySummary,
   referenceMetadataField,
@@ -228,7 +238,7 @@ type AssignmentAction = "claim" | "release" | "complete" | "cancel" | "reopen" |
 type ReportingPacketReviewDecision = "select" | "merge" | "brief" | "hold" | "kill";
 type AssignmentDeskViewMode = "queue" | "budget";
 type UserRoleAction = "grant" | "revoke";
-type AdministrationPanel = "users" | "policies" | "sections" | "procedures";
+type AdministrationPanel = "users" | "policies" | "sections" | "procedures" | "signups";
 export type NewsDeskTab = "overview" | "desks" | "topics" | "concepts" | "references" | "insights" | "messages" | "assignments" | "administration" | "search";
 type LexicalRuleScope = "publication" | "corpus" | "classifier" | "category";
 type AnalysisReindexMode = "online-update" | "classifier-retrain" | "scoped-topic-rebuild" | "entity-graph-rebuild" | "generated-analysis-rebuild";
@@ -775,6 +785,24 @@ function NewsDeskDashboard({
   const [referenceAttachments, setReferenceAttachments] = useState(dashboard.referenceAttachments);
   const [messages, setMessages] = useState(dashboard.messages);
   const [semanticRelations, setSemanticRelations] = useState(dashboard.semanticRelations);
+  const relevanceDecisions = useMemo(() => currentRelevanceDecisions(semanticRelations), [semanticRelations]);
+  const relevanceCyclotronId = useMemo(
+    () => [...relevanceDecisions.values()].find((decision) => decision.cyclotronId)?.cyclotronId ?? null,
+    [relevanceDecisions],
+  );
+  const [cyclotronStatus, setCyclotronStatus] = useState<CyclotronStatus | null>(null);
+  useEffect(() => {
+    if (!relevanceCyclotronId) return;
+    if (dashboard.isDemo) {
+      setCyclotronStatus(DEMO_CYCLOTRON_STATUS);
+      return;
+    }
+    let cancelled = false;
+    loadCyclotronStatus(relevanceCyclotronId)
+      .then((status) => { if (!cancelled) setCyclotronStatus(status); })
+      .catch(() => { if (!cancelled) setCyclotronStatus(null); });
+    return () => { cancelled = true; };
+  }, [dashboard.isDemo, relevanceCyclotronId]);
   const [semanticNodes, setSemanticNodes] = useState(dashboard.semanticNodes);
   const [assignments, setAssignments] = useState(dashboard.assignments);
   const [assignmentEvents, setAssignmentEvents] = useState(dashboard.assignmentEvents);
@@ -1506,7 +1534,13 @@ function NewsDeskDashboard({
     });
   }
 
-  function runReferenceCurationAction(reference: ReferenceRecord, action: ReferenceCurationAction, note?: string, reasonCode?: ReferenceRejectionReasonCode | null) {
+  function runReferenceCurationAction(
+    reference: ReferenceRecord,
+    action: ReferenceCurationAction,
+    note?: string,
+    reasonCode?: ReferenceRejectionReasonCode | null,
+    relevance?: { decisionRelationId: string; shareable: boolean },
+  ) {
     const nextStatus = referenceCurationStatusForAction(action);
     setActionState({ id: reference.id, message: `${action} pending`, tone: "pending" });
     if (dashboard.isDemo) {
@@ -1534,6 +1568,7 @@ function NewsDeskDashboard({
           action,
           curationStatus: nextStatus,
           reasonCode: action === "reject" ? reasonCode ?? null : null,
+          ...(relevance ? { decisionRelationId: relevance.decisionRelationId, shareable: relevance.shareable } : {}),
         },
       }, ...current]);
       setSemanticRelations((current) => [{
@@ -1574,6 +1609,8 @@ function NewsDeskDashboard({
               actorLabel: authState.label,
               note: note?.trim() || undefined,
               reasonCode: action === "reject" ? reasonCode ?? undefined : undefined,
+              decisionRelationId: relevance?.decisionRelationId,
+              shareable: relevance ? relevance.shareable : undefined,
             },
             { authMode: USER_POOL_AUTH_MODE },
           );
@@ -3152,6 +3189,20 @@ function NewsDeskDashboard({
             demo={Boolean(dashboard.isDemo)}
             disabled={controlsDisabled}
             initialReferenceLineageId={initialSelection.reference ?? pathnameReferenceLineageId}
+            cyclotronStatus={cyclotronStatus}
+            decisions={relevanceDecisions}
+            onRequestReviewRate={relevanceCyclotronId ? async (choice) => {
+              const request = buildReviewRateRequest(choice, authState.label);
+              if (dashboard.isDemo) return;
+              await requestCyclotronReviewRate(relevanceCyclotronId, request);
+            } : undefined}
+            onRelevanceReview={(reference, curation) => runReferenceCurationAction(
+              reference,
+              curation.action,
+              curation.note ?? undefined,
+              normalizeReferenceRejectionReasonCode(curation.reasonCode),
+              { decisionRelationId: curation.decisionRelationId, shareable: curation.shareable },
+            )}
             onReview={(reference, action) => runReferenceCurationAction(reference, action)}
             referenceAttachments={referenceAttachments}
             references={references}
@@ -4404,8 +4455,20 @@ function AdministrationDeskView({
                 <strong>Procedures</strong>
                 <span>Procedure registry and versioned Tactus code</span>
               </Link>
+              {signupPluginEnabled() ? (
+                <Link
+                  href={administrationPanelHref("signups", isDemo)}
+                  data-news-desk-admin-nav="signups"
+                  data-active={administrationPanel === "signups" || undefined}
+                  onClick={() => onPanelChange("signups")}
+                >
+                  <strong>Signups</strong>
+                  <span>Addresses from the site&apos;s signup forms</span>
+                </Link>
+              ) : null}
             </nav>
             <div className="news-desk-settings-panel">
+              {administrationPanel === "signups" ? <SignupEntriesPanel /> : null}
               {administrationPanel === "users" ? (
                 <AdministrationUsersPanel
                   canManageUsers={canManageUsers}
@@ -13598,8 +13661,13 @@ function semanticVersionKey(kind: string, id: string): string {
   return `${kind}#${id}`;
 }
 
+function signupPluginEnabled(): boolean {
+  return pluginSettings(amplifyOutputs as PluginOutputs, "signup") !== null;
+}
+
 function normalizeAdministrationPanel(value: string | null | undefined): AdministrationPanel {
   if (value === "policies" || value === "sections" || value === "procedures") return value;
+  if (value === "signups" && signupPluginEnabled()) return value;
   return "users";
 }
 
@@ -14974,6 +15042,9 @@ function buildUiCopywritingAssignment({ actorLabel, assignment, decision, messag
   message: MessageRecord;
   now: string;
 }): AssignmentRecord {
+  if (!assignment.itemLineageId) {
+    throw new Error(`Assignment ${assignment.id} has no content item lineage; copywriting must continue the same content item.`);
+  }
   const type = decision === "brief" ? "brief" : "article";
   const assignmentTypeKey = type === "brief" ? "copywriting.brief-draft" : "copywriting.article-draft";
   const section = assignment.sectionKey ?? assignment.sectionId ?? "unsectioned";
@@ -15026,6 +15097,7 @@ function buildUiCopywritingAssignment({ actorLabel, assignment, decision, messag
     createdAt: now,
     updatedAt: now,
     newsroomFeedKey: "assignment#open",
+    itemLineageId: assignment.itemLineageId,
     metadata,
   };
 }
@@ -15187,14 +15259,14 @@ function normalizeKnowledgeQueryAnchorKind(value: string | null | undefined): Kn
 
 function normalizeNewsroomFromHref(value: string | null | undefined): string | null {
   if (!value) return null;
-  const trimmed = value.trim();
+  const trimmed = browserPathToInternalNewsroomPath(value.trim());
   if (!trimmed.startsWith("/newsroom")) return null;
-  return trimmed;
+  return toPublicNewsroomPath(trimmed);
 }
 
 function currentNewsroomOriginHref(fallback: string | null): string | null {
   if (typeof window === "undefined") return fallback;
-  const current = `${window.location.pathname}${window.location.search}`;
+  const current = browserPathToInternalNewsroomPath(`${window.location.pathname}${window.location.search}`);
   return current.startsWith("/newsroom/search") ? fallback : normalizeNewsroomFromHref(current);
 }
 
@@ -15228,7 +15300,7 @@ function buildNewsroomSearchHref(request: NewsroomSearchRequest, demo?: boolean)
   if (request.from) params.set("from", request.from);
   if (demo) params.set("demo", "1");
   const queryString = params.toString();
-  return queryString ? `/newsroom/search?${queryString}` : "/newsroom/search";
+  return toPublicNewsroomPath(queryString ? `/newsroom/search?${queryString}` : "/newsroom/search");
 }
 
 function focusNewsroomSearchForm() {

package/components/use-blog-header-obstacles.ts

@@ -0,0 +1,81 @@
+"use client";
+
+import { useEffect, useState, type RefObject } from "react";
+import type { BlogHeaderObstacle } from "./blog-page-background";
+
+const HEADER_OBSTACLE_SELECTORS = [
+  ".presentation-header__eyebrow",
+  ".presentation-header__word",
+  ".presentation-header__meta",
+  ".presentation-header__subtitle",
+  ".presentation-header__date",
+  ".presentation-header__tagline",
+  ".presentation-section-nav a",
+];
+
+function measureObstacleRect(element: HTMLElement): DOMRect {
+  const range = document.createRange();
+  range.selectNodeContents(element);
+  const contentRect = range.getBoundingClientRect();
+  range.detach();
+  if (contentRect.width > 0 && contentRect.height > 0) return contentRect;
+  return element.getBoundingClientRect();
+}
+
+/**
+ * Measures the rendered header text (eyebrow, masthead words, meta, tagline,
+ * section links) as rectangles in the coordinates of `.blog-page-background`,
+ * so a brand's background artwork can keep clear of them. Block-level header
+ * elements span the full page width even when their text ends mid-line, so
+ * the text range is measured instead of the element box.
+ */
+export function useBlogHeaderObstacles(
+  pageRef: RefObject<HTMLElement | null>,
+  paintBuffer: number,
+): BlogHeaderObstacle[] {
+  const [obstacles, setObstacles] = useState<BlogHeaderObstacle[]>([]);
+
+  useEffect(() => {
+    const page = pageRef.current;
+    if (!page) return;
+
+    const update = () => {
+      const background = page.querySelector<HTMLElement>(".blog-page-background");
+      const backgroundRect = background?.getBoundingClientRect();
+      if (!backgroundRect) return;
+
+      const next: BlogHeaderObstacle[] = [];
+      for (const selector of HEADER_OBSTACLE_SELECTORS) {
+        for (const element of Array.from(page.querySelectorAll<HTMLElement>(selector))) {
+          const rect = measureObstacleRect(element);
+          const intersectionTop = Math.max(rect.top, backgroundRect.top);
+          const intersectionBottom = Math.min(rect.bottom, backgroundRect.bottom);
+          const intersectionLeft = Math.max(rect.left, backgroundRect.left);
+          const intersectionRight = Math.min(rect.right, backgroundRect.right);
+          const width = intersectionRight - intersectionLeft;
+          const height = intersectionBottom - intersectionTop;
+          if (width <= 0 || height <= 0) continue;
+          next.push({
+            x: intersectionLeft - backgroundRect.left,
+            y: intersectionTop - backgroundRect.top,
+            width,
+            height: height + paintBuffer * 2,
+          });
+        }
+      }
+      setObstacles(next);
+    };
+
+    update();
+    const observer = new ResizeObserver(update);
+    observer.observe(page);
+    window.addEventListener("resize", update);
+    void document.fonts?.ready.then(update);
+    return () => {
+      observer.disconnect();
+      window.removeEventListener("resize", update);
+    };
+  }, [pageRef, paintBuffer]);
+
+  return obstacles;
+}

package/components/use-brand-fonts-ready.ts

@@ -0,0 +1,28 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { listBrandFontFamilies } from "../lib/brand-fonts";
+import { watchBrandFontsLoaded } from "../lib/brand-fonts-watch";
+import { clearPretextMeasurementCache } from "../lib/pretext-layout";
+import { SITE_BRAND } from "../lib/site-brand";
+
+/**
+ * Returns a number that increments each time the brand's declared font
+ * families finish loading. Pretext's width cache is cleared first, so
+ * measurements taken with fallback metrics are re-run with the real glyph
+ * widths. Stays 0 for brands without a font slot, and on the server.
+ */
+export function useBrandFontsReadyVersion(): number {
+  const [version, setVersion] = useState(0);
+
+  useEffect(() => {
+    return watchBrandFontsLoaded({
+      fontFaceSet: typeof document === "undefined" ? undefined : document.fonts,
+      families: listBrandFontFamilies(SITE_BRAND.fonts),
+      clearMeasurementCaches: clearPretextMeasurementCache,
+      onFontsSettled: () => setVersion((current) => current + 1),
+    });
+  }, []);
+
+  return version;
+}

package/components/use-near-viewport.ts

@@ -0,0 +1,30 @@
+"use client";
+
+import { useEffect, useState, type RefObject } from "react";
+
+export function useNearViewport(targetRef: RefObject<Element | null>, rootMargin: string): boolean {
+  const [isNearViewport, setIsNearViewport] = useState(false);
+
+  useEffect(() => {
+    if (isNearViewport) return;
+    const target = targetRef.current;
+    if (!target) return;
+    if (typeof IntersectionObserver === "undefined") {
+      setIsNearViewport(true);
+      return;
+    }
+    const observer = new IntersectionObserver(
+      (entries) => {
+        if (entries.some((entry) => entry.isIntersecting)) {
+          setIsNearViewport(true);
+          observer.disconnect();
+        }
+      },
+      { rootMargin },
+    );
+    observer.observe(target);
+    return () => observer.disconnect();
+  }, [isNearViewport, rootMargin, targetRef]);
+
+  return isNearViewport;
+}

package/components/use-rhythm-overlay.ts

@@ -0,0 +1,29 @@
+"use client";
+
+import { useEffect, useState } from "react";
+
+export function useRhythmOverlay(): boolean {
+  const [showRhythmOverlay, setShowRhythmOverlay] = useState(false);
+
+  useEffect(() => {
+    const handleKeyDown = (event: KeyboardEvent) => {
+      if (isEditableEventTarget(event.target)) return;
+      if ((event.key === "=" || event.code === "Equal") && event.ctrlKey && !event.metaKey && !event.altKey) {
+        event.preventDefault();
+        setShowRhythmOverlay((current) => !current);
+      }
+    };
+
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, []);
+
+  return showRhythmOverlay;
+}
+
+function isEditableEventTarget(target: EventTarget | null): boolean {
+  if (!(target instanceof HTMLElement)) return false;
+  const tagName = target.tagName.toLowerCase();
+  if (tagName === "input" || tagName === "textarea" || tagName === "select") return true;
+  return target.isContentEditable || target.closest("[contenteditable='true']") !== null;
+}