create-ailk 0.2.0 → 0.4.0

package/templates/apps/web/app/[locale]/projects/apply/__tests__/ListingApplicationClient.test.tsx

@@ -1,96 +0,0 @@
-/**
- * #5048 — the reference mount.
- *
- * Two things are worth pinning here and nothing else is: that an emailed
- * resume link's query parameters reach the section as a resume, and that a
- * freshly-minted draft's id and token are written back into the URL rather
- * than into a cookie or browser storage. Everything else about the surface is
- * tested where it lives, in `packages/ui`.
- */
-import { render, screen } from "@testing-library/react";
-
-const replace = jest.fn();
-let searchParams = new URLSearchParams();
-
-jest.mock("next/navigation", () => ({
-  useRouter: () => ({ replace }),
-  useSearchParams: () => searchParams,
-}));
-
-// The section is the subject of its own tests; here it is a probe that records
-// what the mount handed it.
-const received: Record<string, unknown>[] = [];
-jest.mock("@working-theory/ui", () => ({
-  ListingApplicationFlow: (props: Record<string, unknown>) => {
-    received.push(props);
-    return <div data-testid="listing-application-flow" />;
-  },
-}));
-
-jest.mock("@working-theory/api-client", () => ({
-  projectListings: { start: jest.fn(), patchDraft: jest.fn(), submit: jest.fn() },
-}));
-
-// The import sits below the mocks deliberately: `jest.mock` calls are hoisted,
-// but the module under test must not be evaluated before they are registered.
-import { ListingApplicationClient } from "../ListingApplicationClient";
-
-const config = { slug: "apply", defaultLocale: "en", siteKey: "pk_test", steps: [] };
-const messages = {} as never;
-
-function mount() {
-  return render(
-    <ListingApplicationClient
-      config={config as never}
-      locale="en"
-      messages={messages}
-    />,
-  );
-}
-
-beforeEach(() => {
-  received.length = 0;
-  replace.mockClear();
-  searchParams = new URLSearchParams();
-});
-
-describe("ListingApplicationClient", () => {
-  it("passes no resume when the URL carries no link parameters", () => {
-    mount();
-    expect(screen.getByTestId("listing-application-flow")).toBeInTheDocument();
-    expect(received[0]).not.toHaveProperty("resume");
-  });
-
-  it("rehydrates a draft from an emailed resume link's query parameters", () => {
-    searchParams = new URLSearchParams("draft=listing_7&token=tok_from_the_email");
-    mount();
-    expect(received[0]!["resume"]).toEqual({
-      id: "listing_7",
-      resumeToken: "tok_from_the_email",
-    });
-  });
-
-  it("needs BOTH parameters — a half link is not a resume", () => {
-    searchParams = new URLSearchParams("draft=listing_7");
-    mount();
-    expect(received[0]).not.toHaveProperty("resume");
-  });
-
-  it("writes a newly minted draft back into the URL, not into a cookie", () => {
-    mount();
-    const onDraftStarted = received[0]!["onDraftStarted"] as (s: {
-      id: string;
-      resumeToken: string;
-    }) => void;
-    onDraftStarted({ id: "listing_9", resumeToken: "tok_new" });
-
-    expect(replace).toHaveBeenCalledWith(
-      "?draft=listing_9&token=tok_new",
-      { scroll: false },
-    );
-    // The token is caller-held by design (#5048 (a)) — an httpOnly cookie
-    // cannot travel in an emailed link and a non-browser caller cannot present
-    // one at all. Nothing here may quietly set one.
-    expect(document.cookie).toBe("");
-  });
-});

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

@@ -1,117 +0,0 @@
-// oss: false
-/**
- * Tests for the scheduling module's booking route (#4633).
- *
- * Two things matter here and nothing else does. The page must hand the booker
- * the event identifier and the module's own confirmation path, so a successful
- * booking lands on this site rather than on the provider's; and it must never
- * put a credential into the section data, because section data is exactly what
- * crosses into the client island.
- */
-import React from "react";
-import { render } from "@testing-library/react";
-
-jest.mock("next/navigation", () => ({
-  __esModule: true,
-  notFound: jest.fn(() => {
-    throw new Error("NEXT_NOT_FOUND");
-  }),
-}));
-
-jest.mock("next-intl/server", () => ({
-  __esModule: true,
-  // Echo the key back so an assertion names the message key, not the copy —
-  // the copy is the consuming site's to change.
-  getTranslations: jest.fn().mockResolvedValue((key: string) => key),
-}));
-
-// Capture what the page hands the catalog rather than rendering the real
-// booker: the island's own behaviour is covered in packages/ui, and mounting it
-// here would put a network stub between this test and the thing it asserts.
-const capturedSections: unknown[] = [];
-jest.mock("@working-theory/ui/sections", () => ({
-  __esModule: true,
-  SectionRenderer: ({ sections }: { sections: unknown[] }) => {
-    capturedSections.splice(0, capturedSections.length, ...sections);
-    return React.createElement("div", {
-      "data-testid": "section-renderer",
-      "data-section-count": String(sections.length),
-    });
-  },
-}));
-
-import { notFound } from "next/navigation";
-import SchedulePage from "../page";
-
-const mockNotFound = notFound as jest.MockedFunction<typeof notFound>;
-
-const CAL_LINK = "acme/intro-call";
-
-describe("SchedulePage — the module's booking route", () => {
-  const originalEnv = process.env["SCHEDULING_CAL_LINK"];
-
-  beforeEach(() => {
-    mockNotFound.mockClear();
-    capturedSections.length = 0;
-    process.env["SCHEDULING_CAL_LINK"] = CAL_LINK;
-  });
-
-  afterAll(() => {
-    if (originalEnv === undefined) delete process.env["SCHEDULING_CAL_LINK"];
-    else process.env["SCHEDULING_CAL_LINK"] = originalEnv;
-  });
-
-  it("renders one booker section from the catalog", async () => {
-    const element = await SchedulePage({
-      params: Promise.resolve({ locale: "en" }),
-    });
-    const { container } = render(element);
-
-    expect(
-      container.querySelector('[data-testid="section-renderer"]'),
-    ).not.toBeNull();
-    expect(capturedSections).toHaveLength(1);
-    expect((capturedSections[0] as { type: string }).type).toBe("booker");
-  });
-
-  it("sends a successful booking to the page this module owns", async () => {
-    render(await SchedulePage({ params: Promise.resolve({ locale: "en" }) }));
-    expect(capturedSections).toHaveLength(1);
-
-    const data = (capturedSections[0] as { data: Record<string, unknown> }).data;
-    expect(data["calLink"]).toBe(CAL_LINK);
-    expect(data["bookedRedirect"]).toBe("/schedule/confirmed");
-  });
-
-  it("puts no credential into the section data the client island receives", async () => {
-    render(await SchedulePage({ params: Promise.resolve({ locale: "en" }) }));
-    // Fixture self-guard: an empty capture would make every assertion below
-    // pass vacuously.
-    expect(capturedSections).toHaveLength(1);
-
-    // Whatever the page decides to pass, the SHAPE is fixed: the event
-    // identifier, page framing, and the redirect. Anything else appearing here
-    // is a value crossing into the browser that nobody decided to send.
-    const data = (capturedSections[0] as { data: Record<string, unknown> }).data;
-    expect(Object.keys(data).sort()).toEqual([
-      "bookedRedirect",
-      "calLink",
-      "eyebrow",
-      "headline",
-    ]);
-    // Belt and braces: no serialized value may contain a credential-shaped
-    // string, however the page came by it.
-    const serialized = JSON.stringify(data);
-    expect(serialized).not.toMatch(/api[_-]?key/i);
-    expect(serialized).not.toMatch(/\bcal_(live|test)_/);
-  });
-
-  it("404s when no event is configured", async () => {
-    delete process.env["SCHEDULING_CAL_LINK"];
-
-    await expect(
-      SchedulePage({ params: Promise.resolve({ locale: "en" }) }),
-    ).rejects.toThrow("NEXT_NOT_FOUND");
-    expect(mockNotFound).toHaveBeenCalled();
-  });
-});

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

@@ -1,96 +0,0 @@
-// oss: false
-/**
- * Tests for the scheduling module's confirmation route (#4633).
- *
- * The page's whole claim is that it is finished but owns no design: it renders
- * real content from the site's own message catalog, through the site's own
- * catalog components, and contributes no styling of its own. Both halves are
- * asserted — that it renders a full page rather than a placeholder, and that
- * every string in it came from the `schedule` namespace rather than from this
- * file.
- */
-import React from "react";
-import { render } from "@testing-library/react";
-
-const requestedKeys: string[] = [];
-jest.mock("next-intl/server", () => ({
-  __esModule: true,
-  getTranslations: jest.fn().mockResolvedValue((key: string) => {
-    requestedKeys.push(key);
-    return `copy:${key}`;
-  }),
-}));
-
-const capturedSections: unknown[] = [];
-jest.mock("@working-theory/ui/sections", () => ({
-  __esModule: true,
-  SectionRenderer: ({ sections }: { sections: unknown[] }) => {
-    capturedSections.splice(0, capturedSections.length, ...sections);
-    return React.createElement("div", {
-      "data-testid": "section-renderer",
-      "data-section-count": String(sections.length),
-    });
-  },
-}));
-
-import ConfirmedPage, { generateMetadata } from "../page";
-
-describe("ConfirmedPage — the module-owned confirmation page", () => {
-  beforeEach(() => {
-    capturedSections.length = 0;
-    requestedKeys.length = 0;
-  });
-
-  it("renders a finished page, not a placeholder", async () => {
-    const element = await ConfirmedPage({
-      params: Promise.resolve({ locale: "en" }),
-    });
-    const { container } = render(element);
-
-    expect(
-      container.querySelector('[data-testid="section-renderer"]'),
-    ).not.toBeNull();
-    // Confirmation, what happens next, and a way onward — three sections, all
-    // populated. A stub would be one section or none.
-    expect(capturedSections.map((s) => (s as { type: string }).type)).toEqual([
-      "hero",
-      "content-block",
-      "cta",
-    ]);
-  });
-
-  it("takes every string from the site's own message catalog", async () => {
-    render(await ConfirmedPage({ params: Promise.resolve({ locale: "en" }) }));
-    expect(capturedSections).toHaveLength(3);
-
-    // Every rendered value resolved through getTranslations, so changing the
-    // copy is an edit to messages/<locale>.json — not a fork of this route.
-    const serialized = JSON.stringify(capturedSections);
-    for (const value of serialized.matchAll(/"(?:headline|subheadline|body|description|label)":"([^"]*)"/g)) {
-      expect(value[1]).toMatch(/^copy:confirmed\./);
-    }
-    expect(requestedKeys.length).toBeGreaterThan(0);
-    expect(requestedKeys.every((k) => k.startsWith("confirmed."))).toBe(true);
-  });
-
-  it("declares no styling of its own — the site's design system decides", async () => {
-    render(await ConfirmedPage({ params: Promise.resolve({ locale: "en" }) }));
-    // Fixture self-guard: an empty capture would make the assertion vacuous.
-    expect(capturedSections).toHaveLength(3);
-
-    // No className, no color, no spacing anywhere in what the page contributes.
-    // This is what lets a site with its own design system adopt the page
-    // without fighting it.
-    const serialized = JSON.stringify(capturedSections);
-    expect(serialized).not.toMatch(/className|style|#[0-9a-fA-F]{3,8}\b/);
-  });
-
-  it("is not indexable", async () => {
-    // Reachable only by having just booked; indexing it would surface a
-    // confirmation page to people who never made a booking.
-    const metadata = await generateMetadata({
-      params: Promise.resolve({ locale: "en" }),
-    });
-    expect(metadata.robots).toEqual({ index: false, follow: true });
-  });
-});

package/templates/apps/web/app/[locale]/schedule/confirmed/page.tsx

@@ -1,92 +0,0 @@
-// oss: false
-/**
- * /[locale]/schedule/confirmed — the scheduling module's confirmation page
- * (#4633). The destination `BookerIsland` navigates to the moment the booking
- * POST resolves (its `bookedRedirect` prop), so the visitor never leaves this
- * site to find out the booking worked.
- *
- * The module OWNS this page. It is not a marketing page that happens to follow
- * a booker: it ships with the module, it is gated with the module, and a
- * scaffold without the module has no such route. That is why it lives under
- * `schedule/` rather than at `/thanks/<slug>` — `/thanks` is a core marketing
- * surface every scaffold carries, and a page in it would outlive the module
- * that gave it a reason to exist.
- *
- * FINISHED, NOT A STUB — and it owns no design of its own. Every visual
- * decision resolves through the consuming site's theme tokens and its
- * `SectionRenderer` catalog; this file contributes a section list and nothing
- * else. The copy is read from the site's own `schedule` message namespace,
- * so customizing the page is an edit to `messages/<locale>.json` — the same
- * surface the site already edits for every other page — not a fork of this
- * route. A site whose design system differs has nothing here to fight.
- *
- * Carries no booking detail because it receives none: the redirect is a
- * client-side `router.push` with no state, and re-reading the booking would
- * mean a second provider call to tell the visitor something the confirmation
- * email already carries. It confirms, and it says what happens next.
- *
- * `noindex`: a booking confirmation is reachable only by having just booked.
- */
-import { SectionRenderer } from "@working-theory/ui/sections";
-import type { PageSection } from "@working-theory/validation";
-import type { Metadata } from "next";
-import { getTranslations } from "next-intl/server";
-import type { ReactElement } from "react";
-
-interface Props {
-  params: Promise<{ locale: string }>;
-}
-
-export async function generateMetadata({ params }: Props): Promise<Metadata> {
-  const { locale } = await params;
-  const t = await getTranslations({ locale, namespace: "schedule" });
-  return {
-    title: t("confirmed.title"),
-    description: t("confirmed.description"),
-    robots: { index: false, follow: true },
-  };
-}
-
-export default async function Page({ params }: Props): Promise<ReactElement> {
-  const { locale } = await params;
-  const t = await getTranslations({ locale, namespace: "schedule" });
-
-  const sections: PageSection[] = [
-    {
-      id: "schedule-confirmed-hero",
-      type: "hero",
-      data: {
-        headline: t("confirmed.headline"),
-        subheadline: t("confirmed.subheadline"),
-      },
-    },
-    {
-      id: "schedule-confirmed-prepare",
-      type: "content-block",
-      data: {
-        headline: t("confirmed.prepareHeadline"),
-        body: t("confirmed.prepareBody"),
-      },
-    },
-    {
-      id: "schedule-confirmed-cta",
-      type: "cta",
-      data: {
-        headline: t("confirmed.ctaHeadline"),
-        description: t("confirmed.ctaDescription"),
-        primaryCta: { label: t("confirmed.ctaPrimaryLabel"), href: "/" },
-        secondaryCta: {
-          label: t("confirmed.ctaSecondaryLabel"),
-          href: "/contact",
-          variant: "ghost",
-        },
-      },
-    },
-  ];
-
-  return (
-    <main>
-      <SectionRenderer sections={sections} locale={locale} />
-    </main>
-  );
-}

package/templates/apps/web/app/[locale]/schedule/page.tsx

@@ -1,82 +0,0 @@
-// oss: false
-/**
- * /[locale]/schedule — the scheduling module's booking page (#4633).
- *
- * Exists only because the `scheduling` module is installed: `create-ailk
- * --modules marketing,scheduling` copies this directory, and a scaffold
- * without the module never receives it (packages/create-ailk/src/surfaces.ts,
- * the `schedule` gateable surface).
- *
- * API-backed rather than MDX-backed, the same shape as the `flows` surface:
- * everything the page shows about the event — its title, its duration, its
- * meeting type, its open slots — is DERIVED by the `booker` section from
- * apps/api's `/v1/schedule/availability`, so there is no content file that
- * could disagree with the calendar. The one thing the scaffolder cannot know
- * is WHICH event to book, so that arrives as configuration.
- *
- * CREDENTIALS. `SCHEDULING_CAL_LINK` is read here, on the server, and it is
- * not the API key — the key lives in apps/api's scheduling service and is
- * never read by this app at all. `calLink` is a public identifier (it is the
- * provider's own public booking-page path) and reaching the browser is its
- * job: the booker sends it back to `/v1/schedule/*` to name the event. It is
- * deliberately NOT a `NEXT_PUBLIC_` variable so that the whole scheduling
- * config surface stays server-read, which is the rule architecture.yaml's
- * scheduling block enforces.
- *
- * Unconfigured is a 404, not an error page — the flows precedent: to a
- * visitor, a booking page for an event the operator never named is
- * indistinguishable from a page that does not exist.
- */
-import { SectionRenderer } from "@working-theory/ui/sections";
-import { registerSchedulingSections } from "@working-theory/ui/slices/scheduling";
-import type { PageSection } from "@working-theory/validation";
-import type { Metadata } from "next";
-import { notFound } from "next/navigation";
-import { getTranslations } from "next-intl/server";
-import type { ReactElement } from "react";
-
-// `SectionRenderer`'s oss dispatch maps `booker` to a placeholder, because the
-// real component strips with this slice; this call contributes the real one and
-// must stay an explicit statement, not a bare side-effect import (#5214 D4).
-registerSchedulingSections();
-
-/** Site-relative path of the confirmation page this module also owns. */
-const BOOKED_REDIRECT = "/schedule/confirmed";
-
-interface Props {
-  params: Promise<{ locale: string }>;
-}
-
-export async function generateMetadata({ params }: Props): Promise<Metadata> {
-  const { locale } = await params;
-  const t = await getTranslations({ locale, namespace: "schedule" });
-  return { title: t("title"), description: t("description") };
-}
-
-export default async function Page({ params }: Props): Promise<ReactElement> {
-  const { locale } = await params;
-  const calLink = process.env["SCHEDULING_CAL_LINK"];
-  if (!calLink) {
-    notFound();
-  }
-
-  const t = await getTranslations({ locale, namespace: "schedule" });
-  const sections: PageSection[] = [
-    {
-      id: "schedule-booker",
-      type: "booker",
-      data: {
-        calLink,
-        eyebrow: t("eyebrow"),
-        headline: t("headline"),
-        bookedRedirect: BOOKED_REDIRECT,
-      },
-    },
-  ];
-
-  return (
-    <main>
-      <SectionRenderer sections={sections} locale={locale} />
-    </main>
-  );
-}

package/templates/apps/web/content/en/blog/README.txt

@@ -1,25 +0,0 @@
-Blog posts live here — one .mdx file per post.
-
-The /blog route is OFF by default. Turn it on by scaffolding the blog surface:
-
-    npx create-ailk --sync-architecture marketing --surfaces blog .
-
-then add the route with the `scaffold-page` skill, or re-scaffold with
-`--surfaces blog`.
-
-Frontmatter contract (enforced at build time by source.config.ts):
-
-    ---
-    title: string          # required
-    description: string    # required
-    date: 2026-01-31       # optional, ISO date — datePublished
-    updated: 2026-02-14    # optional, ISO date — dateModified
-    image: /og/my-post.png # optional
-    author:                # optional
-      name: Jane Doe
-      avatar: /avatars/jane.png
-    tags: [launch, notes]  # optional
-    ---
-
-This file is a placeholder so the directory survives packaging. Delete it once
-you have posts — it is not read by anything (the loader globs *.mdx only).

package/templates/apps/web/content/en/docs/index.mdx

@@ -1,28 +0,0 @@
----
-title: Documentation
-description: Documentation for {{COMPANY_NAME}}. Replace this page with your own getting-started guide.
----
-
-# Documentation
-
-This is the docs landing page. Replace it with whatever a new reader of your
-documentation needs first.
-
-## Adding a page
-
-Every `.mdx` file in this directory becomes a page under `/docs`. The filename
-is the URL segment; `index.mdx` is the section root. Two frontmatter fields are
-required:
-
-```yaml
----
-title: string
-description: string
----
-```
-
-## Turning docs off
-
-The `/docs` route is part of the `docs` surface. If your site does not need
-documentation, re-scaffold without it and the route will not exist — an absent
-route is better than one serving an empty page.

package/templates/apps/web/lib/__mocks__/source-server.js

@@ -1,31 +0,0 @@
-/**
- * Jest stub for @/.source/server — the fumadocs-mdx codegen output.
- *
- * The real .source/server.ts uses top-level await and ESM-only imports from
- * fumadocs-mdx/runtime/server, which ts-jest cannot load in CJS mode.
- * This stub provides the minimal shape needed by lib/source.ts so that
- * the loader() call in that file does not throw at import time.
- *
- * Tests that exercise the blog/docs/llms routes inject their own source
- * stubs via props, so the loader's output is never used in test execution.
- *
- * Referenced by: apps/web/jest.config.cjs moduleNameMapper '^@/\\.source/server$'
- * Added: issue #1077 — fumadocs-core ESM + .source/server CJS compatibility
- * Updated: issue #1459 — added docs collection stub alongside blog
- *
- * @note The real .source/ directory is gitignored (codegen output).
- *       This committed stub lives in lib/__mocks__/ so it is tracked by git.
- */
-"use strict";
-
-exports.blog = {
-  toFumadocsSource: function () {
-    return { files: [] };
-  },
-};
-
-exports.docs = {
-  toFumadocsSource: function () {
-    return { files: [] };
-  },
-};

package/templates/apps/web/lib/blog-list-data.ts

@@ -1,95 +0,0 @@
-/**
- * Adapter: Fumadocs blog source → `BlogListDataSchema` (issue #2713).
- *
- * The `@working-theory/ui` `BlogList` section is presentational (ADR-0027): it renders,
- * the app maps source → data. This adapter turns `blogSource.getPages()` into
- * the section's `data` prop, applying the field mapping from the issue:
- *
- *   title       ← frontmatter.title
- *   slug        ← page.url (with the `/blog/` baseUrl prefix stripped, since
- *                 the section re-prepends it: `href={`/blog/${slug}`}`)
- *   excerpt     ← frontmatter.description
- *   publishedAt ← frontmatter.date
- *   coverImage  ← frontmatter.image
- *   author      ← frontmatter.author
- *   categories  ← frontmatter.tags
- *
- * Locale-aware: the locale is threaded so callers can pass a locale-prefixed
- * baseUrl for pagination when the route paginates (>1 page).
- */
-import type { BlogListData } from "@working-theory/validation";
-
-/** Frontmatter shape consumed here — must match `source.config.ts` blog schema. */
-interface BlogFrontmatter {
-  title: string;
-  description: string;
-  date?: string;
-  updated?: string;
-  image?: string;
-  author?: { name: string; avatar?: string };
-  tags?: string[];
-}
-
-/** The subset of a Fumadocs page entry this adapter reads. */
-interface BlogPageEntry {
-  url: string;
-  data: unknown;
-}
-
-/** Optional pagination inputs; pagination is emitted only when totalPages > 1. */
-interface BlogListPagination {
-  page: number;
-  totalPages: number;
-  baseUrl: string;
-}
-
-type BlogPostPreview = BlogListData["posts"][number];
-
-/**
- * Strip the `/blog/` baseUrl prefix the section re-prepends when linking
- * (`href={`/blog/${slug}`}`). The bare baseUrl (`/blog`, the index page that
- * `getPages()` also returns) maps to an empty slug so the link stays `/blog/`
- * rather than doubling the prefix.
- */
-function toSlug(url: string): string {
-  if (url === "/blog") return "";
-  return url.replace(/^\/blog\//, "");
-}
-
-function toPreview(entry: BlogPageEntry): BlogPostPreview {
-  const fm = entry.data as BlogFrontmatter;
-  return {
-    title: fm.title,
-    slug: toSlug(entry.url),
-    excerpt: fm.description,
-    publishedAt: fm.date ?? "",
-    ...(fm.image ? { coverImage: { src: fm.image, alt: fm.title } } : {}),
-    ...(fm.author
-      ? {
-          author: {
-            name: fm.author.name,
-            ...(fm.author.avatar
-              ? { avatar: { src: fm.author.avatar, alt: fm.author.name } }
-              : {}),
-          },
-        }
-      : {}),
-    ...(fm.tags && fm.tags.length > 0 ? { categories: fm.tags } : {}),
-  };
-}
-
-/**
- * Map Fumadocs blog pages to `BlogList` section data.
- *
- * @param pages      blog source entries (`blogSource.getPages()`).
- * @param pagination optional pagination; emitted only when `totalPages > 1`.
- */
-export function toBlogListData(
-  pages: BlogPageEntry[],
-  pagination?: BlogListPagination,
-): BlogListData {
-  return {
-    posts: pages.map(toPreview),
-    ...(pagination && pagination.totalPages > 1 ? { pagination } : {}),
-  };
-}