create-ailk 0.31.0 → 0.32.0

package/templates/apps/web/app/[locale]/about/__tests__/about-routes.test.tsx

@@ -45,6 +45,9 @@ import { createSitemapHandler } from "../../../sitemap.xml/route";
 import { createLlmsHandler } from "../../../llms.txt/route";
 import type { ContentAdapter } from "@working-theory/content-adapters";
 
+// #10704 — a fixture suite: its content is shaped for the mdx source, whatever the site serves from.
+process.env.CONTENT_ADAPTER = "mdx";
+
 type JsonLd = Record<string, unknown>;
 
 function jsonLdScripts(container: HTMLElement): JsonLd[] {

package/templates/apps/web/app/[locale]/careers/__tests__/page-renderer-migration.test.tsx

@@ -58,6 +58,9 @@ import CareersPage from "../page";
 import CareersSlugPage from "../[slug]/page";
 import * as pageRenderer from "@working-theory/page-renderer";
 
+// #10704 — a fixture suite: its content is shaped for the mdx source, whatever the site serves from.
+process.env.CONTENT_ADAPTER = "mdx";
+
 // ── Shared stubs ───────────────────────────────────────────────────────────────
 const getMdxSourceEmpty = jest.fn().mockResolvedValue(null);
 

package/templates/apps/web/app/[locale]/pricing/[slug]/__tests__/page.test.tsx

@@ -32,6 +32,9 @@ jest.mock("next/navigation", () => ({
 
 import OfferingPricingPage, { dynamic, generateMetadata } from "../page";
 
+// #10704 — a fixture suite: its content is shaped for the mdx source, whatever the site serves from.
+process.env.CONTENT_ADAPTER = "mdx";
+
 const SLUG = "website-rebuild";
 const SITE_EMAIL = "hello@example.com";
 

package/templates/apps/web/app/[locale]/pricing/__tests__/offerings.test.tsx

@@ -27,6 +27,9 @@ import {
 
 import PricingPage, { generateMetadata } from "../page";
 
+// #10704 — a fixture suite: its content is shaped for the mdx source, whatever the site serves from.
+process.env.CONTENT_ADAPTER = "mdx";
+
 const SITE_EMAIL = "hello@example.com";
 const HOSTILE = "</script><script>alert(1)</script>";
 

package/templates/apps/web/app/[locale]/pricing/__tests__/page.test.tsx

@@ -15,6 +15,9 @@ import { act, render, screen, within } from "@testing-library/react";
 
 import PricingPage from "../page";
 
+// #10704 — a fixture suite: its content is shaped for the mdx source, whatever the site serves from.
+process.env.CONTENT_ADAPTER = "mdx";
+
 const PLANS = [
   {
     key: "basic",

package/templates/apps/web/app/[locale]/pricing/__tests__/unconnected.test.tsx

@@ -27,6 +27,9 @@ import { TOPOLOGY } from "../../../../lib/topology.generated";
 import * as pricingPage from "../page";
 import PricingPage, { generateMetadata } from "../page";
 
+// #10704 — a fixture suite: its content is shaped for the mdx source, whatever the site serves from.
+process.env.CONTENT_ADAPTER = "mdx";
+
 const PLANS = [
   {
     key: "basic",

package/templates/apps/web/app/[locale]/projects/__tests__/page-renderer-migration.test.tsx

@@ -51,6 +51,9 @@ import { notFound } from "next/navigation";
 import ProjectsPage from "../page";
 import ProjectSlugPage from "../[slug]/page";
 
+// #10704 — a fixture suite: its content is shaped for the mdx source, whatever the site serves from.
+process.env.CONTENT_ADAPTER = "mdx";
+
 const mockNotFound = notFound as jest.MockedFunction<typeof notFound>;
 
 // ── Shared stub helpers ────────────────────────────────────────────────────────

package/templates/apps/web/app/[locale]/services/__tests__/page-renderer-migration.test.tsx

@@ -31,6 +31,9 @@ import ServicesPage from "../page";
 import ServiceSlugPage from "../[slug]/page";
 import * as pageRenderer from "@working-theory/page-renderer";
 
+// #10704 — a fixture suite: its content is shaped for the mdx source, whatever the site serves from.
+process.env.CONTENT_ADAPTER = "mdx";
+
 const mockNotFound = notFound as jest.MockedFunction<typeof notFound>;
 
 // ── Shared stub helpers ────────────────────────────────────────────────────────

package/templates/apps/web/app/[locale]/team/__tests__/team-routes.test.tsx

@@ -31,6 +31,9 @@ import TeamPage from "../page";
 import TeamMemberPage from "../[slug]/page";
 import * as pageRenderer from "@working-theory/page-renderer";
 
+// #10704 — a fixture suite: its content is shaped for the mdx source, whatever the site serves from.
+process.env.CONTENT_ADAPTER = "mdx";
+
 type JsonLd = Record<string, unknown>;
 
 function jsonLdScripts(container: HTMLElement): JsonLd[] {

package/templates/apps/web/lib/__tests__/page-chrome.test.ts

@@ -29,6 +29,9 @@ import {
 } from "../page-chrome";
 import type { SiteChrome } from "../site-chrome";
 
+// #10704 — a fixture suite: its content is shaped for the mdx source, whatever the site serves from.
+process.env.CONTENT_ADAPTER = "mdx";
+
 // ── AC-2 — the route families ────────────────────────────────────────────
 
 function camel(prefix: string): string {

package/templates/apps/web/lib/__tests__/structured-data.test.tsx

@@ -29,6 +29,16 @@
  * `tools/content-compile`, which the scaffold does not ship, and the adapter
  * reads the same files with the same frontmatter schema the manifest is
  * compiled from. See docs/internal/decisions/scaffold-structured-data-check.md.
+ *
+ * The pages come from the site's active content source (#10704):
+ * `resolvedAdapterKind()`, the resolver every page reads through. Under `mdx`
+ * (the default) they are the files under `content/`. Under `database` — a
+ * spoke that serves every page from its hub and may hold no page file — they
+ * are the hub's published pages as the build's last-good snapshot holds them
+ * (`.ailk/content-snapshot.json`, written by `pnpm --filter web build` under
+ * `CONTENT_ADAPTER=database`), read through the site's own content source
+ * with the API origin pinned to a refused loopback, so a test run reads no
+ * hub and needs no key.
  */
 import {
   copyFileSync,
@@ -51,8 +61,11 @@ import type {
 import {
   SCHEMA_ORG_TYPES,
   createMdxAdapter,
+  resolvedAdapterKind,
 } from "@working-theory/content-adapters";
 import {
+  getContentAdapter,
+  getMdxSource,
   getPageSections,
   pageToJsonLd,
   siteOrigin,
@@ -158,6 +171,94 @@ const adapter = createMdxAdapter({
   defaultLocale: DEFAULT_LOCALE,
 });
 
+// ── #10704 D2 — a site that serves its pages from its hub ──────────────────
+
+const SOURCE = resolvedAdapterKind();
+// page-renderer's `CONTENT_SNAPSHOT_PATH`, which this jest config maps no
+// subpath to read; create-ailk's structured-data-check suite pins the two
+// equal. Relative to cwd, as the content source reads it.
+const SNAPSHOT_REL = ".ailk/content-snapshot.json";
+
+// No read may reach a hub: every page and list read fails as unavailable and
+// the content source answers from the snapshot, the path a deployed spoke
+// takes while its hub is down.
+if (SOURCE === "database") process.env.AILK_API_URL = "http://127.0.0.1:9";
+
+/**
+ * Every page the snapshot holds, keyed by its cache tag
+ * (`content:<workspace>:<type>:<slug>:<locale>`, `cache-tags.ts`), or why it
+ * holds none. Read only under `database`.
+ */
+function readHubPages(): {
+  pages: Array<{ locale: string; type: string; slug: string }>;
+  problem: string | null;
+} {
+  const path = join(process.cwd(), SNAPSHOT_REL);
+  const build = "run `pnpm --filter web build` under CONTENT_ADAPTER=database to write it";
+  if (!existsSync(path)) {
+    return { pages: [], problem: `${path} does not exist — ${build}` };
+  }
+  let parsed: { version?: unknown; pages?: unknown; lists?: unknown } | null;
+  try {
+    parsed = JSON.parse(readFileSync(path, "utf8")) as typeof parsed;
+  } catch {
+    parsed = null;
+  }
+  if (
+    parsed === null ||
+    typeof parsed !== "object" ||
+    parsed.version !== 1 ||
+    typeof parsed.pages !== "object" ||
+    parsed.pages === null ||
+    typeof parsed.lists !== "object" ||
+    parsed.lists === null
+  ) {
+    return { pages: [], problem: `${path} is not a version-1 content snapshot — ${build}` };
+  }
+  const pages = Object.keys(parsed.pages).map((tag) => {
+    const parts = tag.split(":");
+    return {
+      type: parts[2] ?? "",
+      slug: parts.slice(3, -1).join(":"),
+      locale: parts[parts.length - 1] ?? "",
+    };
+  });
+  if (pages.length === 0) {
+    return { pages, problem: `${path} holds no page — ${build}` };
+  }
+  return { pages, problem: null };
+}
+
+const HUB = SOURCE === "database" ? readHubPages() : { pages: [], problem: null };
+
+/** The snapshot's (locale, type) pairs, in the shape the content walk takes. */
+function hubTypeDirs(): Array<{ locale: string; typeDir: string }> {
+  const seen = new Set<string>();
+  const out: Array<{ locale: string; typeDir: string }> = [];
+  for (const { locale, type } of HUB.pages) {
+    if (seen.has(`${locale}/${type}`)) continue;
+    seen.add(`${locale}/${type}`);
+    out.push({ locale, typeDir: type });
+  }
+  return out.sort((a, b) =>
+    `${a.locale}/${a.typeDir}`.localeCompare(`${b.locale}/${b.typeDir}`),
+  );
+}
+
+/** A type's pages in a locale, from the active source. */
+function listDetailFor(type: PageType, locale: string): Promise<ContentPage[]> {
+  return SOURCE === "database"
+    ? getContentAdapter().listDetail(type, locale)
+    : adapter.listDetail(type, locale);
+}
+
+/** One page's source, from the active source (`ContentAdapter` has no `getPageSource`). */
+function pageSourceFor(type: PageType, slug: string, locale: string) {
+  return SOURCE === "database"
+    ? getMdxSource(type, slug, locale)
+    : adapter.getPageSource(type, slug, locale);
+}
+
 // ── JSON-LD flatten + validate (the ten lines from tools/scrape-jsonld.ts) ──
 
 function flattenBlocks(parsed: unknown): JsonLdObject[] {
@@ -244,9 +345,21 @@ function identityFailure(blocks: JsonLdObject[], label: string): string | null {
 // ── 1. Content-driven: every content page builds valid JSON-LD ──────────────
 
 describe("structured data — every content page builds valid JSON-LD", () => {
-  const typeDirs = contentTypeDirs();
+  const typeDirs = SOURCE === "database" ? hubTypeDirs() : contentTypeDirs();
+  let hubPagesChecked = 0;
+
+  afterAll(() => {
+    if (SOURCE === "database") {
+      console.info(`structured-data: ${hubPagesChecked} hub page(s) checked from ${SNAPSHOT_REL}`);
+    }
+  });
 
   it("finds content to check", () => {
+    if (SOURCE === "database") {
+      // A hub-served site with no snapshot has nothing to check: misconfigured.
+      expect(HUB.problem).toBeNull();
+      return;
+    }
     // A site with no content directory at all is misconfigured, not clean.
     expect(existsSync(CONTENT_ROOT)).toBe(true);
     expect(typeDirs.length).toBeGreaterThan(0);
@@ -274,14 +387,17 @@ describe("structured data — every content page builds valid JSON-LD", () => {
       }
       const type = typeDir as PageType;
 
-      const pages: ContentPage[] = await adapter.listDetail(type, locale);
-      const dirPath = join(CONTENT_ROOT, locale, typeDir);
-      const mdxCount = readdirSync(dirPath).filter(
-        (n) => n.endsWith(".mdx") && !n.startsWith("_"),
-      ).length;
+      const pages: ContentPage[] = await listDetailFor(type, locale);
       // The adapter drops a page whose frontmatter fails the schema; that
       // page would render nothing, so count it here rather than lose it.
-      expect(pages.length).toBe(mdxCount);
+      // Under `database` the count is the pages the hub published (#10704).
+      const expected =
+        SOURCE === "database"
+          ? HUB.pages.filter((p) => p.locale === locale && p.type === type).length
+          : readdirSync(join(CONTENT_ROOT, locale, typeDir)).filter(
+              (n) => n.endsWith(".mdx") && !n.startsWith("_"),
+            ).length;
+      expect(pages.length).toBe(expected);
 
       const failures: string[] = [];
       for (const page of pages) {
@@ -295,6 +411,7 @@ describe("structured data — every content page builds valid JSON-LD", () => {
         if (failure !== null) failures.push(failure);
       }
       expect(failures).toEqual([]);
+      if (SOURCE === "database") hubPagesChecked += pages.length;
     },
   );
 });
@@ -674,14 +791,16 @@ describe("structured data — every route emits a valid JSON-LD script", () => {
     // #10043 D7 — a Service's category, for the nested route's params.
     const parents = new Map<string, string>();
     if (identity.slug !== null) {
-      const page = await adapter.getPageSource(
+      const page = await pageSourceFor(
         type,
         identity.slug,
         DEFAULT_LOCALE,
       );
       if (page === null) {
         throw new Error(
-          `${label}: renders ${type}/${identity.slug}, but content/${DEFAULT_LOCALE}/${type}/${identity.slug}.mdx does not exist — the route serves 404 in production.`,
+          SOURCE === "database"
+            ? `${label}: renders ${type}/${identity.slug}, but the hub serves no such page (${SNAPSHOT_REL}) — the route serves 404 in production.`
+            : `${label}: renders ${type}/${identity.slug}, but content/${DEFAULT_LOCALE}/${type}/${identity.slug}.mdx does not exist — the route serves 404 in production.`,
         );
       }
       slugs = [identity.slug];
@@ -689,7 +808,7 @@ describe("structured data — every route emits a valid JSON-LD script", () => {
       // The hub's own page shares this route's type but is served at the hub
       // (#10044 D13), so it is never rendered here.
       const hubSlug = hubOwnSlug(file, type);
-      const pages = (await adapter.listDetail(type, DEFAULT_LOCALE)).filter(
+      const pages = (await listDetailFor(type, DEFAULT_LOCALE)).filter(
         (p: ContentPage) => p.slug !== hubSlug,
       );
       for (const p of pages) if (p.parent !== undefined) parents.set(p.slug, p.parent);
@@ -772,6 +891,8 @@ describe("structured data — a hub's own page is not rendered at its detail rou
     async () => {
       const root = mkdtempSync(join(tmpdir(), "ailk-10044-sd-"));
       const prior = process.env.AILK_CONTENT_ROOT;
+      // #10704 D2 — the fixture is files, whatever source the site serves from.
+      const priorSource = process.env.CONTENT_ADAPTER;
       try {
         mkdirSync(join(root, DEFAULT_LOCALE, "Pricing"), { recursive: true });
         copyFileSync(join(CONTENT_ROOT, "_site.mdx"), join(root, "_site.mdx"));
@@ -784,6 +905,7 @@ describe("structured data — a hub's own page is not rendered at its detail rou
           '---\ntype: "Pricing"\nslug: "website-rebuild"\ntitle: "Website Rebuild"\ndescription: "What a rebuild costs."\nplans: ["ss-website-rebuild"]\n---\n',
         );
         process.env.AILK_CONTENT_ROOT = root;
+        process.env.CONTENT_ADAPTER = "mdx";
         const fixtureAdapter = createMdxAdapter({
           contentRoot: root,
           defaultLocale: DEFAULT_LOCALE,
@@ -807,6 +929,8 @@ describe("structured data — a hub's own page is not rendered at its detail rou
       } finally {
         if (prior === undefined) delete process.env.AILK_CONTENT_ROOT;
         else process.env.AILK_CONTENT_ROOT = prior;
+        if (priorSource === undefined) delete process.env.CONTENT_ADAPTER;
+        else process.env.CONTENT_ADAPTER = priorSource;
         rmSync(root, { recursive: true, force: true });
       }
     },

package/templates/apps/web/src/lib/routes.ts

@@ -39,9 +39,11 @@ export function resolveBaseUrl(): string {
  * `packages/templates/src/__tests__/routes-map.test.ts`'s table test and
  * `apps/web/__tests__/routes/routes-map-identity.test.ts`'s differential
  * test over the live content tree). The signature is annotated explicitly so
- * this stays the exact `(type: string, slug: string) => string` contract the
- * three call sites (`sitemap.xml`, `llms.txt`, `docs-blog/llms-route.ts`)
- * depend on, even though `routeFor`'s own `slug` parameter is optional.
+ * this stays the exact `(type: string, slug: string) => string` contract its
+ * callers depend on, even though `routeFor`'s own `slug` parameter is
+ * optional. `sitemap.xml`, `llms.txt` and, since #10775, the docs-blog
+ * module's `docs-blog/llms-route.ts` call `pagePathFor` instead; the export
+ * stays for a docs-blog site that installed the older copy of that route.
  */
 export const slugToPath: (type: string, slug: string) => string = routeFor;
 

package/templates/package.json

@@ -21,7 +21,8 @@
     "architecture": "tsx tools/lint-architecture.ts",
     "claude-md:check": "tsx tools/check-claude-md.ts",
     "content-source:check": "tsx tools/check-content-source.ts",
-    "preflight": "pnpm architecture && pnpm claude-md:check && pnpm content-source:check && pnpm type-check && pnpm lint && pnpm build"
+    "mdx-body:check": "tsx tools/check-mdx-body.ts",
+    "preflight": "pnpm architecture && pnpm claude-md:check && pnpm content-source:check && pnpm mdx-body:check && pnpm type-check && pnpm lint && pnpm build"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",