@anthusai/papyrus 0.0.0 → 1.0.0-next.2

package/scripts/fixtures/pilobol-sample.ast.json

@@ -0,0 +1,234 @@
+{
+  "type": "document",
+  "schema_version": 1,
+  "front_matter": {
+    "title": "Agents work better with less freedom",
+    "authors": [
+      "Ada Lovelace"
+    ],
+    "date": "2026-09-06"
+  },
+  "children": [
+    {
+      "type": "paragraph",
+      "inline": [
+        {
+          "type": "text",
+          "text": "Developers are learning that reliable agents need less freedom, not more."
+        }
+      ],
+      "line": 8
+    },
+    {
+      "type": "paragraph",
+      "inline": [
+        {
+          "type": "text",
+          "text": "Across demos and tool launches, builders kept circling the same answer."
+        }
+      ],
+      "line": 10
+    },
+    {
+      "type": "directive",
+      "name": "pull-quote",
+      "attributes": {
+        "id": null,
+        "attribution": "Editorial principle",
+        "source": null,
+        "tone": "default",
+        "align": "inline"
+      },
+      "leaf": false,
+      "line": 12,
+      "children": [
+        {
+          "type": "paragraph",
+          "inline": [
+            {
+              "type": "text",
+              "text": "The practical breakthrough is not giving agents a bigger sandbox."
+            }
+          ],
+          "line": 13
+        }
+      ]
+    },
+    {
+      "type": "heading",
+      "level": 2,
+      "inline": [
+        {
+          "type": "text",
+          "text": "Planning state"
+        }
+      ],
+      "line": 16
+    },
+    {
+      "type": "paragraph",
+      "inline": [
+        {
+          "type": "text",
+          "text": "Read-only tools. An inline "
+        },
+        {
+          "type": "code_span",
+          "code": "code_span"
+        },
+        {
+          "type": "text",
+          "text": " should not be confused with a block."
+        }
+      ],
+      "line": 18
+    },
+    {
+      "type": "code",
+      "lang": "python",
+      "value": "def plan():\n    return \"read only\"\n",
+      "line": 20
+    },
+    {
+      "type": "directive",
+      "name": "card-grid",
+      "attributes": {
+        "id": null,
+        "label": null,
+        "columns": 2
+      },
+      "leaf": false,
+      "line": 25,
+      "children": [
+        {
+          "type": "directive",
+          "name": "card",
+          "attributes": {
+            "id": null,
+            "icon": null,
+            "title": "Read",
+            "span": null
+          },
+          "leaf": false,
+          "line": 26,
+          "children": [
+            {
+              "type": "paragraph",
+              "inline": [
+                {
+                  "type": "text",
+                  "text": "Look before you leap."
+                }
+              ],
+              "line": 27
+            }
+          ]
+        },
+        {
+          "type": "directive",
+          "name": "card",
+          "attributes": {
+            "id": null,
+            "icon": null,
+            "title": "Write",
+            "span": null
+          },
+          "leaf": false,
+          "line": 29,
+          "children": [
+            {
+              "type": "paragraph",
+              "inline": [
+                {
+                  "type": "text",
+                  "text": "Only after planning."
+                }
+              ],
+              "line": 30
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "type": "directive",
+      "name": "two-up",
+      "attributes": {
+        "id": null,
+        "ratio": "1:1",
+        "align": "start"
+      },
+      "leaf": false,
+      "line": 34,
+      "children": [
+        {
+          "type": "directive",
+          "name": "column",
+          "attributes": {
+            "id": null
+          },
+          "leaf": false,
+          "line": 35,
+          "children": [
+            {
+              "type": "paragraph",
+              "inline": [
+                {
+                  "type": "text",
+                  "text": "Planning state keeps risk low."
+                }
+              ],
+              "line": 36
+            }
+          ]
+        },
+        {
+          "type": "directive",
+          "name": "column",
+          "attributes": {
+            "id": null
+          },
+          "leaf": false,
+          "line": 38,
+          "children": [
+            {
+              "type": "paragraph",
+              "inline": [
+                {
+                  "type": "text",
+                  "text": "Implementation state is where damage happens."
+                }
+              ],
+              "line": 39
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "type": "directive",
+      "name": "figure",
+      "attributes": {
+        "id": null,
+        "src": "../assets/state-diagram.svg",
+        "alt": "State diagram",
+        "credit": null,
+        "caption": "Two states, one agent"
+      },
+      "leaf": false,
+      "line": 43,
+      "children": []
+    },
+    {
+      "type": "paragraph",
+      "inline": [
+        {
+          "type": "text",
+          "text": "The lesson is not that agents are over."
+        }
+      ],
+      "line": 46
+    }
+  ],
+  "_papyrus_source_sha256": "cf899c47590d54b39b60824dc8718131a3ba8a77b073cc66947d70d2f6145757"
+}

package/src/backend.js

@@ -0,0 +1 @@
+export { defineSiteBackend } from "../amplify/site-backend.js";

package/src/backend.ts

@@ -0,0 +1,3 @@
+export { defineSiteBackend } from "../amplify/site-backend";
+export type { PapyrusSite } from "../lib/define-site";
+export type { PapyrusSiteBackendConfig, PapyrusAuthConfig } from "../amplify/site-backend-config";

package/src/sync.mjs

@@ -0,0 +1,87 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+/**
+ * `papyrus-app sync`: write one-line route shims for Papyrus's routes into the
+ * publication repo (SPIKE, PPY-82be6c). Output is generated and gitignored;
+ * a site-owned file at the same path (no GENERATED header) always wins.
+ */
+const MARKER = "// GENERATED by `papyrus-app sync` from @anthusai/papyrus. Do not edit; add a site-owned file at this path to override.";
+const NEXT_EXPORTS = new Set([
+  "generateMetadata", "metadata", "generateStaticParams", "generateViewport", "viewport",
+  "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS",
+]);
+const GITIGNORE_BEGIN = "# >>> papyrus-app sync (generated route shims)";
+const GITIGNORE_END = "# <<< papyrus-app sync";
+
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const PKG = "@anthusai/papyrus";
+
+function isGenerated(file) {
+  try {
+    return fs.readFileSync(file, "utf8").startsWith(MARKER);
+  } catch {
+    return false;
+  }
+}
+
+function shimFor(route) {
+  const spec = `${PKG}/${route.file.replace(/\.(tsx|ts)$/, "")}`;
+  const lines = [MARKER];
+  const named = route.exports.filter((n) => NEXT_EXPORTS.has(n));
+  if (route.hasDefault) lines.push(`export { default${named.length ? ", " + named.join(", ") : ""} } from "${spec}";`);
+  else if (named.length) lines.push(`export { ${named.join(", ")} } from "${spec}";`);
+  // Route-segment config must be a literal in the route file itself.
+  for (const [name, literal] of Object.entries(route.config)) lines.push(`export const ${name} = ${literal};`);
+  return lines.join("\n") + "\n";
+}
+
+function middlewareShim(manifest) {
+  const matcher = manifest.middleware.matcher ?? '["/((?!_next/static|_next/image|favicon.ico|icon).*)"]';
+  return [
+    MARKER,
+    `export { middleware } from "${PKG}/middleware";`,
+    `export const config = { matcher: ${matcher} };`,
+    "",
+  ].join("\n");
+}
+
+export function sync({ root = process.cwd(), log = console.log } = {}) {
+  const manifest = JSON.parse(fs.readFileSync(path.join(pkgRoot, "routes.manifest.json"), "utf8"));
+  const generated = [];
+  const skipped = [];
+  const write = (relPath, content) => {
+    const dest = path.join(root, relPath);
+    if (fs.existsSync(dest) && !isGenerated(dest)) {
+      skipped.push(relPath);
+      return;
+    }
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, content);
+    generated.push(relPath);
+  };
+  for (const route of manifest.routes) write(route.file, shimFor(route));
+  write("middleware.ts", middlewareShim(manifest));
+
+  // Remove shims that are no longer in the manifest (e.g. after an upgrade).
+  const stateFile = path.join(root, ".papyrus", "generated.json");
+  let previous = [];
+  try { previous = JSON.parse(fs.readFileSync(stateFile, "utf8")); } catch { /* first run */ }
+  for (const rel of previous) {
+    if (!generated.includes(rel) && isGenerated(path.join(root, rel))) fs.rmSync(path.join(root, rel));
+  }
+  fs.mkdirSync(path.dirname(stateFile), { recursive: true });
+  fs.writeFileSync(stateFile, JSON.stringify(generated, null, 2) + "\n");
+
+  // Keep generated shims out of git.
+  const giFile = path.join(root, ".gitignore");
+  const gi = fs.existsSync(giFile) ? fs.readFileSync(giFile, "utf8") : "";
+  const block = [GITIGNORE_BEGIN, ...generated.map((g) => "/" + g), "/.papyrus/", GITIGNORE_END].join("\n");
+  const re = new RegExp(`${GITIGNORE_BEGIN.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${GITIGNORE_END}`);
+  fs.writeFileSync(giFile, re.test(gi) ? gi.replace(re, block) : `${gi}${gi.endsWith("\n") || !gi ? "" : "\n"}${block}\n`);
+
+  log(`papyrus-app sync: ${generated.length} shim(s) written, ${skipped.length} site-owned file(s) kept (${PKG}@${manifest.version})`);
+  for (const rel of skipped) log(`  site-owned: ${rel}`);
+  return { generated, skipped };
+}

package/src/with-papyrus.d.mts

@@ -0,0 +1,2 @@
+import type { NextConfig } from "next";
+export function withPapyrus(nextConfig?: NextConfig, options?: { root?: string }): NextConfig;

package/src/with-papyrus.mjs

@@ -0,0 +1,47 @@
+import path from "node:path";
+
+/**
+ * Wrap a publication repo's Next config for Papyrus (SPIKE, PPY-82be6c).
+ * - transpile the package (it ships TypeScript source),
+ * - alias `papyrus-site` -> ./papyrus.config.ts and
+ *   `papyrus-amplify-outputs` -> ./amplify_outputs.json (both webpack and turbopack),
+ * - carry Papyrus's own server-external packages and image settings.
+ */
+const SERVER_EXTERNAL = [
+  "aws-amplify",
+  "@aws-amplify/adapter-nextjs",
+  "@aws-amplify/core",
+  "@aws-amplify/api",
+  "@aws-amplify/api-graphql",
+  "@aws-amplify/auth",
+  "@aws-amplify/storage",
+  "@aws-amplify/data-schema",
+];
+
+export function withPapyrus(nextConfig = {}, options = {}) {
+  const root = options.root ?? process.cwd();
+  const aliases = {
+    "papyrus-site": path.join(root, "papyrus.config.ts"),
+    "papyrus-amplify-outputs": path.join(root, "amplify_outputs.json"),
+  };
+  return {
+    distDir: process.env.NEXT_DIST_DIR || ".next",
+    ...nextConfig,
+    transpilePackages: [...new Set([...(nextConfig.transpilePackages ?? []), "@anthusai/papyrus"])],
+    serverExternalPackages: [...new Set([...(nextConfig.serverExternalPackages ?? []), ...SERVER_EXTERNAL])],
+    images: nextConfig.images ?? { remotePatterns: [{ protocol: "https", hostname: "**" }] },
+    experimental: { devtoolSegmentExplorer: false, ...nextConfig.experimental },
+    turbopack: {
+      ...nextConfig.turbopack,
+      resolveAlias: {
+        ...nextConfig.turbopack?.resolveAlias,
+        "papyrus-site": "./papyrus.config.ts",
+        "papyrus-amplify-outputs": "./amplify_outputs.json",
+      },
+    },
+    webpack(config, context) {
+      config.resolve.alias = { ...config.resolve.alias, ...aliases };
+      return typeof nextConfig.webpack === "function" ? nextConfig.webpack(config, context) : config;
+    },
+  };
+}