@anthusai/papyrus 5.18.0 → 5.19.1

package/amplify/functions/editorial-checks/handler.py

@@ -4,11 +4,11 @@ from __future__ import annotations
 
 from typing import Any
 
-from papyrus_content.editorial_checks import GraphQLEditorialStore, Services, handle, load_provider_keys
+from papyrus_content.editorial_checks import GraphQLEditorialStore, Services, event_field_name, handle, load_provider_keys
 
 # Amplify passes secrets to Python functions as placeholders; resolve them once per cold start.
 load_provider_keys()
 
 
 def handler(event: dict[str, Any], _context: Any = None) -> dict[str, Any]:
-    return handle(event["info"]["fieldName"], event.get("arguments") or {}, Services(store=GraphQLEditorialStore()))
+    return handle(event_field_name(event), event.get("arguments") or {}, Services(store=GraphQLEditorialStore()))

package/amplify/publication/redirect-and-index.js

@@ -91,6 +91,22 @@ function markdownTwin(uri) {
   return uri.substring(0, uri.length - 5) + ".md";
 }
 
+// Directory-style sites keep a page's twin at /x/index.md, so a bare /x.md is rewritten there. The edge cannot test for
+// existence, hence the rule: a last segment <name>.md with a name other than index. A path prefix (a base path) is just
+// part of <path>. The flag is spliced in by redirect-rules.ts at deploy time from urls.style.
+const directoryTwins = /*PAPYRUS_DIRECTORY_TWINS*/false/*END_PAPYRUS_DIRECTORY_TWINS*/;
+
+function directoryTwin(uri) {
+  if (uri.length < 5 || uri.substring(uri.length - 3) !== ".md") {
+    return null;
+  }
+  const lastSegment = uri.substring(uri.lastIndexOf("/") + 1);
+  if (lastSegment === "index.md" || lastSegment === ".md") {
+    return null;
+  }
+  return uri.substring(0, uri.length - 3) + "/index.md";
+}
+
 async function handler(event) {
   const request = event.request;
   const redirectTarget = await lookUpRedirectTarget(request.uri);
@@ -110,6 +126,12 @@ async function handler(event) {
     };
   }
   request.uri = rewriteToIndexDocument(request.uri);
+  if (directoryTwins) {
+    const bareTwin = directoryTwin(request.uri);
+    if (bareTwin !== null) {
+      request.uri = bareTwin;
+    }
+  }
   if (negotiateMarkdown && prefersMarkdown(request)) {
     const twin = markdownTwin(request.uri);
     if (twin !== null) {

package/amplify/publication/redirect-rules.js

@@ -27,20 +27,34 @@ export function edgeRulesFromSettings(settings) {
 export function negotiatesMarkdown(settings) {
     return settings.site !== undefined && settings.agents?.markdown !== false;
 }
+/** A directory-style site keeps a page's Markdown twin at `/x/index.md`; the edge then serves a bare `/x.md` from there. */
+export function usesDirectoryTwins(settings) {
+    return negotiatesMarkdown(settings) && settings.urls?.style === "directory";
+}
 export function readEdgeConfig(staticDir, baseDirectory = process.cwd()) {
     if (staticDir === undefined)
-        return { rules: [], negotiateMarkdown: false };
+        return { rules: [], negotiateMarkdown: false, directoryTwins: false };
     const settingsPath = resolve(baseDirectory, staticDir, "projection.json");
     if (!existsSync(settingsPath))
-        return { rules: [], negotiateMarkdown: false };
+        return { rules: [], negotiateMarkdown: false, directoryTwins: false };
     const settings = JSON.parse(readFileSync(settingsPath, "utf8"));
-    return { rules: edgeRulesFromSettings(settings), negotiateMarkdown: negotiatesMarkdown(settings) };
+    return { rules: edgeRulesFromSettings(settings), negotiateMarkdown: negotiatesMarkdown(settings), directoryTwins: usesDirectoryTwins(settings) };
 }
 export function readEdgeRules(staticDir, baseDirectory = process.cwd()) {
     return readEdgeConfig(staticDir, baseDirectory).rules;
 }
 const NEGOTIATE_START = "/*PAPYRUS_NEGOTIATE_MARKDOWN*/";
 const NEGOTIATE_END = "/*END_PAPYRUS_NEGOTIATE_MARKDOWN*/";
+const TWINS_START = "/*PAPYRUS_DIRECTORY_TWINS*/";
+const TWINS_END = "/*END_PAPYRUS_DIRECTORY_TWINS*/";
+function spliceFlag(source, start, end, label) {
+    const from = source.indexOf(start);
+    const to = source.indexOf(end);
+    if (from === -1 || to === -1 || to < from) {
+        throw new Error(`redirect function source has no ${label} markers`);
+    }
+    return source.slice(0, from + start.length) + "true" + source.slice(to);
+}
 /** The CloudFront Function source with the site's pattern rules and Markdown negotiation flag spliced in. */
 export function compileRedirectFunctionSource(source, rules, options = {}) {
     const start = source.indexOf(START_MARKER);
@@ -50,12 +64,10 @@ export function compileRedirectFunctionSource(source, rules, options = {}) {
     }
     let compiled = rules.length === 0 ? source : source.slice(0, start + START_MARKER.length) + JSON.stringify(rules) + source.slice(end);
     if (options.negotiateMarkdown === true) {
-        const from = compiled.indexOf(NEGOTIATE_START);
-        const to = compiled.indexOf(NEGOTIATE_END);
-        if (from === -1 || to === -1 || to < from) {
-            throw new Error("redirect function source has no markdown negotiation markers");
-        }
-        compiled = compiled.slice(0, from + NEGOTIATE_START.length) + "true" + compiled.slice(to);
+        compiled = spliceFlag(compiled, NEGOTIATE_START, NEGOTIATE_END, "markdown negotiation");
+    }
+    if (options.directoryTwins === true) {
+        compiled = spliceFlag(compiled, TWINS_START, TWINS_END, "directory twin");
     }
     return compiled;
 }

package/amplify/publication/redirect-rules.ts

@@ -38,14 +38,19 @@ export function negotiatesMarkdown(settings: ProjectionSettings): boolean {
   return settings.site !== undefined && settings.agents?.markdown !== false;
 }
 
-export type EdgeConfig = { rules: EdgeRedirectRule[]; negotiateMarkdown: boolean };
+/** A directory-style site keeps a page's Markdown twin at `/x/index.md`; the edge then serves a bare `/x.md` from there. */
+export function usesDirectoryTwins(settings: ProjectionSettings): boolean {
+  return negotiatesMarkdown(settings) && settings.urls?.style === "directory";
+}
+
+export type EdgeConfig = { rules: EdgeRedirectRule[]; negotiateMarkdown: boolean; directoryTwins: boolean };
 
 export function readEdgeConfig(staticDir: string | undefined, baseDirectory: string = process.cwd()): EdgeConfig {
-  if (staticDir === undefined) return { rules: [], negotiateMarkdown: false };
+  if (staticDir === undefined) return { rules: [], negotiateMarkdown: false, directoryTwins: false };
   const settingsPath = resolve(baseDirectory, staticDir, "projection.json");
-  if (!existsSync(settingsPath)) return { rules: [], negotiateMarkdown: false };
+  if (!existsSync(settingsPath)) return { rules: [], negotiateMarkdown: false, directoryTwins: false };
   const settings = JSON.parse(readFileSync(settingsPath, "utf8")) as ProjectionSettings;
-  return { rules: edgeRulesFromSettings(settings), negotiateMarkdown: negotiatesMarkdown(settings) };
+  return { rules: edgeRulesFromSettings(settings), negotiateMarkdown: negotiatesMarkdown(settings), directoryTwins: usesDirectoryTwins(settings) };
 }
 
 export function readEdgeRules(staticDir: string | undefined, baseDirectory: string = process.cwd()): EdgeRedirectRule[] {
@@ -54,12 +59,23 @@ export function readEdgeRules(staticDir: string | undefined, baseDirectory: stri
 
 const NEGOTIATE_START = "/*PAPYRUS_NEGOTIATE_MARKDOWN*/";
 const NEGOTIATE_END = "/*END_PAPYRUS_NEGOTIATE_MARKDOWN*/";
+const TWINS_START = "/*PAPYRUS_DIRECTORY_TWINS*/";
+const TWINS_END = "/*END_PAPYRUS_DIRECTORY_TWINS*/";
+
+function spliceFlag(source: string, start: string, end: string, label: string): string {
+  const from = source.indexOf(start);
+  const to = source.indexOf(end);
+  if (from === -1 || to === -1 || to < from) {
+    throw new Error(`redirect function source has no ${label} markers`);
+  }
+  return source.slice(0, from + start.length) + "true" + source.slice(to);
+}
 
 /** The CloudFront Function source with the site's pattern rules and Markdown negotiation flag spliced in. */
 export function compileRedirectFunctionSource(
   source: string,
   rules: EdgeRedirectRule[],
-  options: { negotiateMarkdown?: boolean } = {},
+  options: { negotiateMarkdown?: boolean; directoryTwins?: boolean } = {},
 ): string {
   const start = source.indexOf(START_MARKER);
   const end = source.indexOf(END_MARKER);
@@ -68,12 +84,10 @@ export function compileRedirectFunctionSource(
   }
   let compiled = rules.length === 0 ? source : source.slice(0, start + START_MARKER.length) + JSON.stringify(rules) + source.slice(end);
   if (options.negotiateMarkdown === true) {
-    const from = compiled.indexOf(NEGOTIATE_START);
-    const to = compiled.indexOf(NEGOTIATE_END);
-    if (from === -1 || to === -1 || to < from) {
-      throw new Error("redirect function source has no markdown negotiation markers");
-    }
-    compiled = compiled.slice(0, from + NEGOTIATE_START.length) + "true" + compiled.slice(to);
+    compiled = spliceFlag(compiled, NEGOTIATE_START, NEGOTIATE_END, "markdown negotiation");
+  }
+  if (options.directoryTwins === true) {
+    compiled = spliceFlag(compiled, TWINS_START, TWINS_END, "directory twin");
   }
   return compiled;
 }

package/amplify/publication/s3-projection.js

@@ -70,10 +70,12 @@ export function addS3ProjectionPublication(scope, props, media) {
     assertValidPublicationConfig({ kind: "s3-projection", ...props });
     const bucket = createSiteBucket(scope, props.retainBucketOnDelete !== false);
     const keyValueStore = new cloudfront.KeyValueStore(scope, "RedirectsKeyValueStore");
+    const edgeConfig = readEdgeConfig(props.staticDir);
     const redirectFunction = new cloudfront.Function(scope, "RedirectAndIndexFunction", {
         runtime: cloudfront.FunctionRuntime.JS_2_0,
-        code: cloudfront.FunctionCode.fromInline(compileRedirectFunctionSource(readFileSync(redirectFunctionSourcePath, "utf8"), readEdgeConfig(props.staticDir).rules, {
-            negotiateMarkdown: readEdgeConfig(props.staticDir).negotiateMarkdown,
+        code: cloudfront.FunctionCode.fromInline(compileRedirectFunctionSource(readFileSync(redirectFunctionSourcePath, "utf8"), edgeConfig.rules, {
+            negotiateMarkdown: edgeConfig.negotiateMarkdown,
+            directoryTwins: edgeConfig.directoryTwins,
         })),
         keyValueStore,
     });

package/amplify/publication/s3-projection.ts

@@ -112,11 +112,13 @@ export function addS3ProjectionPublication(
   const bucket = createSiteBucket(scope, props.retainBucketOnDelete !== false);
 
   const keyValueStore = new cloudfront.KeyValueStore(scope, "RedirectsKeyValueStore");
+  const edgeConfig = readEdgeConfig(props.staticDir);
   const redirectFunction = new cloudfront.Function(scope, "RedirectAndIndexFunction", {
     runtime: cloudfront.FunctionRuntime.JS_2_0,
     code: cloudfront.FunctionCode.fromInline(
-      compileRedirectFunctionSource(readFileSync(redirectFunctionSourcePath, "utf8"), readEdgeConfig(props.staticDir).rules, {
-        negotiateMarkdown: readEdgeConfig(props.staticDir).negotiateMarkdown,
+      compileRedirectFunctionSource(readFileSync(redirectFunctionSourcePath, "utf8"), edgeConfig.rules, {
+        negotiateMarkdown: edgeConfig.negotiateMarkdown,
+        directoryTwins: edgeConfig.directoryTwins,
       }),
     ),
     keyValueStore,

package/bin/papyrus-infra.mjs

@@ -53,7 +53,7 @@ if (command === "compile-edge-function") {
   const { compileRedirectFunctionSource, readEdgeConfig } = await import("../amplify/publication/redirect-rules.js");
   const functionSource = fs.readFileSync(new URL("../amplify/publication/redirect-and-index.js", import.meta.url), "utf8");
   const config = readEdgeConfig(staticDir);
-  const compiled = compileRedirectFunctionSource(functionSource, config.rules, { negotiateMarkdown: config.negotiateMarkdown });
+  const compiled = compileRedirectFunctionSource(functionSource, config.rules, { negotiateMarkdown: config.negotiateMarkdown, directoryTwins: config.directoryTwins });
   const out = opt("out");
   if (out) fs.writeFileSync(path.resolve(out), compiled);
   else process.stdout.write(compiled);

package/components/publication-cyclotron-panel.tsx

@@ -5,6 +5,9 @@ import {ReviewControl,type ReviewControlReview} from 'cyclotron/components/revie
 import {CyclotronStatusView} from 'cyclotron/components/cyclotron-status';
 import {assertPublicationScope,publicationScopeKey,publicationReviewPayload,type PublicationStatus,type PublicationHistory,type PublicationHistoryRow,type PublicationReviewPayload} from '../lib/publication-cyclotron';
 
+/** Steering is offered only when the Cyclotron contract says so; absent means unknown, so off. */
+export function steeringAvailable(status:PublicationStatus):boolean{return status.features?.steering===true;}
+
 function requestId(){
  const bytes=crypto.getRandomValues(new Uint8Array(16));
  return Array.from(bytes,value=>value.toString(16).padStart(2,'0')).join('');
@@ -38,7 +41,9 @@ function PublicationControls({mode,status,history,onReview,onSteer}:PublicationP
   <header><h2 className="text-lg font-semibold">Suggestions · {status.publicationId}</h2><p className="text-sm text-muted-foreground">{mode==='embedded'?'Suggestions and reviews are kept by this site.':'Suggestions and reviews are kept by the shared review service.'}</p></header>
   {status.outputs.map(output=><section key={`${context}:${output.id}`} aria-label={output.question} className="space-y-3 rounded-md border p-3">
    <CyclotronStatusView status={status.classifiers[output.id]} classifierName={output.question} variant="card"/>
-   {onSteer?<button type="button" disabled={Boolean(busy)} onClick={()=>onSteer(output.id)}>Test a rule change</button>:null}
+   {onSteer?(steeringAvailable(status)
+    ?<button type="button" disabled={Boolean(busy)} onClick={()=>onSteer(output.id)}>Test a rule change</button>
+    :<div><button type="button" disabled aria-describedby={`steer-unavailable:${output.id}`}>Test a rule change · Not available yet</button><p id={`steer-unavailable:${output.id}`} className="text-sm text-muted-foreground">Rule changes cannot be tested on this service yet.</p></div>):null}
    {history.history.map(row=>{
     const prediction=row.decision.classifiers[output.id];if(!prediction)return null;
     const key=`${context}:${row.decision.decisionId}:${output.id}:${row.context?.contextId??'legacy'}`;const saved=row.reviews[output.id];const historical=Boolean(row.historicalContext||row.provenanceUnavailable||row.feedbackReconciliationRequired);

package/components/reference-curation-controls.tsx

@@ -73,7 +73,7 @@ function Controls({session,disabled,refreshSignal}:{session:CurationSession;disa
     {error?<p role="alert">{error}</p>:null}
     {snapshot?<PublicationCyclotronPanel mode={session.bootstrap.mode} status={snapshot.status} history={snapshot.history}
       onReview={canReview?async payload=>{await session.publication.review(payload);await refresh();}:undefined}
-      onSteer={canSteer&&snapshot.status.features?.steering&&session.bootstrap.bindingRef?classifier=>{setSteering(classifier);setRubric('');setExplanation('');setTrial(null);setSteeringMessage('');}:undefined}/>:null}
+      onSteer={canSteer&&session.bootstrap.bindingRef?classifier=>{setSteering(classifier);setRubric('');setExplanation('');setTrial(null);setSteeringMessage('');}:undefined}/>:null}
     {steering?<form aria-label="Rule change" className="space-y-3 rounded-md border p-3" onSubmit={event=>{event.preventDefault();void steer('evaluate');}}>
       <h4 className="font-semibold">Test a rule change</h4>
       <p className="text-sm">A change is tested before it is adopted. Opening this form does not change any existing suggestion.</p>

package/package.json

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

package/routes.manifest.json

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