create-ailk 0.2.0 → 0.4.0

package/templates/apps/web/app/[locale]/(authed)/waitlist/page.tsx

@@ -1,179 +0,0 @@
-/**
- * /[locale]/waitlist — the operator dashboard's list + rollup view
- * (#4665 D10, AC1).
- *
- * RSC: reads `GET /v1/waitlist-experiments` through
- * `@working-theory/api-client`'s `waitlistExperiments.list`, forwarding the
- * caller's cookie session (`../../../../lib/server-api.js`, D9). A 401/403
- * renders `ForbiddenState` (no leak of why — §2.2 Security); every other
- * error rethrows to the route's error boundary.
- */
-
-import { waitlistExperiments } from "@working-theory/api-client";
-import { PageHeader } from "@working-theory/ui/blocks";
-import { Container, Heading, Text } from "@working-theory/ui/primitives";
-import type { WaitlistMode, WaitlistStatus } from "@working-theory/validation";
-import type { Metadata } from "next";
-import { getTranslations } from "next-intl/server";
-import type { ReactElement } from "react";
-
-import { ApiError, forwardedCookieInit, unwrapApiResult } from "../../../../lib/server-api";
-
-import { ExperimentsTable } from "./components/ExperimentsTable";
-import { ForbiddenState } from "./components/ForbiddenState";
-import { OfferFunnelTable } from "./components/OfferFunnelTable";
-import { RollupTicker } from "./components/RollupTicker";
-import { formatCount, formatDateTime, formatRate } from "./format";
-
-interface Props {
-  params: Promise<{ locale: string }>;
-}
-
-export async function generateMetadata({ params }: Props): Promise<Metadata> {
-  const { locale } = await params;
-  const t = await getTranslations({ locale, namespace: "waitlistDashboard.list" });
-  return { title: t("title"), description: t("description") };
-}
-
-export default async function WaitlistListPage({ params }: Props): Promise<ReactElement> {
-  const { locale } = await params;
-  const t = await getTranslations({ locale, namespace: "waitlistDashboard" });
-
-  let data;
-  try {
-    data = await unwrapApiResult(waitlistExperiments.list(await forwardedCookieInit()));
-  } catch (err) {
-    if (err instanceof ApiError && (err.status === 401 || err.status === 403)) {
-      return (
-        <ForbiddenState
-          headline={t("common.forbiddenHeadline")}
-          description={t("common.forbiddenDescription")}
-        />
-      );
-    }
-    throw err;
-  }
-
-  const statusLabels: Record<WaitlistStatus, string> = {
-    live: t("status.live"),
-    closed: t("status.closed"),
-    draft: t("status.draft"),
-  };
-  const modeLabels: Record<WaitlistMode, string> = {
-    "lead-capture": t("mode.lead-capture"),
-    qualifying: t("mode.qualifying"),
-    paid: t("mode.paid"),
-    // #4767 — the register's fourth mode; the engine/UI that reads it are
-    // sibling children of Epic #4758 (out of scope here). A placeholder
-    // label only, so `Record<WaitlistMode, …>` stays exhaustive.
-    recommending: t("mode.recommending"),
-  };
-
-  const rows = data.experiments.map((experiment) => ({
-    experiment,
-    raw: formatCount(experiment.counts.raw, locale),
-    qualified:
-      experiment.counts.qualified === null
-        ? t("common.unavailable")
-        : formatCount(experiment.counts.qualified, locale),
-    rate: formatRate(experiment.counts.qualificationRate, locale),
-    updated: formatDateTime(experiment.updatedAt, locale),
-  }));
-
-  // #4839 — one per-offer funnel per recommending experiment (the register's
-  // `offers[]` order), rendered under the experiments table.
-  const offerFunnels = data.experiments.flatMap((experiment) =>
-    experiment.counts.offers
-      ? [
-          {
-            experimentId: experiment.id,
-            experimentKey: experiment.key,
-            rows: experiment.counts.offers.map((offer) => ({
-              offerKey: offer.offerKey,
-              recommended: formatCount(offer.recommended, locale),
-              saved: formatCount(offer.saved, locale),
-              checkedOut: formatCount(offer.checkedOut, locale),
-            })),
-          },
-        ]
-      : [],
-  );
-  const offerLabels = {
-    captionPrefix: t("list.offers.captionPrefix"),
-    columnOffer: t("list.offers.columnOffer"),
-    columnRecommended: t("list.offers.columnRecommended"),
-    columnSaved: t("list.offers.columnSaved"),
-    columnCheckedOut: t("list.offers.columnCheckedOut"),
-  };
-
-  return (
-    <main className="min-h-screen bg-surface text-fg" data-testid="waitlist-list-page">
-      <PageHeader />
-      <Container className="flex flex-col gap-6 py-section">
-        <div>
-          <Heading level={1}>{t("list.title")}</Heading>
-          <Text as="p" variant="body-sm" tone="muted" className="mt-1">
-            {t("list.description")}
-          </Text>
-        </div>
-
-        <RollupTicker
-          ariaLabel={t("list.rollupAriaLabel")}
-          labels={{
-            live: t("list.rollup.live"),
-            closed: t("list.rollup.closed"),
-            draft: t("list.rollup.draft"),
-            raw: t("list.rollup.raw"),
-            qualified: t("list.rollup.qualified"),
-            rate: t("list.rollup.rate"),
-            sites: t("list.rollup.sites"),
-          }}
-          values={{
-            live: formatCount(data.rollup.experiments.live, locale),
-            closed: formatCount(data.rollup.experiments.closed, locale),
-            draft: formatCount(data.rollup.experiments.draft, locale),
-            raw: formatCount(data.rollup.raw, locale),
-            qualified:
-              data.rollup.qualified === null
-                ? t("common.unavailable")
-                : formatCount(data.rollup.qualified, locale),
-            rate: formatRate(data.rollup.qualificationRate, locale),
-            ...(data.scope === "all"
-              ? { sites: formatCount(data.rollup.sites, locale) }
-              : {}),
-          }}
-        />
-
-        <ExperimentsTable
-          locale={locale}
-          rows={rows}
-          labels={{
-            caption: t("list.table.caption"),
-            columnKey: t("list.table.columnKey"),
-            columnMode: t("list.table.columnMode"),
-            columnStatus: t("list.table.columnStatus"),
-            columnWaitlists: t("list.table.columnWaitlists"),
-            columnRaw: t("list.table.columnRaw"),
-            columnQualified: t("list.table.columnQualified"),
-            columnRate: t("list.table.columnRate"),
-            columnUpdated: t("list.table.columnUpdated"),
-            emptyHeadline: t("list.table.emptyHeadline"),
-            emptyDescription: t("list.table.emptyDescription"),
-            statusLabel: (status) => statusLabels[status as WaitlistStatus],
-            modeLabel: (mode) => modeLabels[mode as WaitlistMode],
-          }}
-        />
-
-        {offerFunnels.map((funnel) => (
-          <OfferFunnelTable
-            key={funnel.experimentId}
-            experimentId={funnel.experimentId}
-            experimentKey={funnel.experimentKey}
-            rows={funnel.rows}
-            labels={offerLabels}
-          />
-        ))}
-      </Container>
-    </main>
-  );
-}

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

@@ -1,178 +0,0 @@
-/**
- * /blog catch-all route. With `content/blog/` empty, the index renders the
- * BLOG_EMPTY_SENTINEL placeholder (testable contract).
- *
- * Q5 deferred post-MVP: no `/docs` companion ships in Phase 0 — only the
- * `docsPageJsonLd` builder is exported from `@working-theory/fumadocs-schema`.
- */
-import { blogListJsonLd, blogPostingJsonLd } from "@working-theory/fumadocs-schema";
-import { JsonLdScript, emptyStateVisible } from "@working-theory/page-renderer";
-import { BlogList, BlogPost } from "@working-theory/ui";
-import type { Metadata } from "next";
-import { notFound } from "next/navigation";
-import { getTranslations } from "next-intl/server";
-import type { ComponentType, ReactElement } from "react";
-
-import { toBlogListData } from "../../../../lib/blog-list-data";
-import { toBlogPostData } from "../../../../lib/blog-post-data";
-import { getOgImageUrl } from "../../../../lib/og";
-import { blogSource as defaultBlogSource } from "../../../../lib/source";
-
-/**
- * Sentinel string the empty-state placeholder must contain. Tests assert
- * on this exact value to detect the empty-blog branch without coupling to
- * copy. Exported so the integration test can import it directly.
- */
-export const BLOG_EMPTY_SENTINEL = "ailk-blog-empty-placeholder";
-
-/**
- * Frontmatter contract — must match `source.config.ts` `defineDocs.docs.schema`.
- */
-interface BlogFrontmatter {
-  title: string;
-  description: string;
-  date?: string;
-  updated?: string;
-  image?: string;
-  author?: { name: string; avatar?: string };
-  tags?: string[];
-}
-
-/**
- * Post `page.data`: frontmatter plus the Fumadocs-generated `body` (compiled
- * MDX component) and `toc` (table of contents). The body renders through the
- * `BlogPost` section's `children` slot (issue #2714).
- */
-interface BlogPostPageData extends BlogFrontmatter {
-  body?: ComponentType;
-  toc?: Array<{ title: unknown; url: string; depth: number }>;
-}
-
-/**
- * Minimal blog-source interface covering the subset consumed by this route.
- * Tests inject a stub without mocking lib/source at the module level.
- */
-interface BlogSource {
-  getPages: () => Array<{ url: string; data: unknown }>;
-  getPage: (slug: string[]) => { data: unknown } | undefined;
-}
-
-interface BlogRouteProps {
-  params: Promise<{ locale: string; slug?: string[] }>;
-  /**
-   * Blog source override for testing. Defaults to the real Fumadocs blogSource.
-   * Inject a stub to avoid mocking lib/source at the module level.
-   */
-  blogSource?: BlogSource;
-}
-
-export async function generateMetadata(
-  props: BlogRouteProps,
-): Promise<Metadata> {
-  const { slug } = await props.params;
-  const source = props.blogSource ?? defaultBlogSource;
-
-  if (slug && slug.length > 0) {
-    const page = source.getPage(slug);
-    if (page) {
-      const data = page.data as unknown as BlogFrontmatter;
-      const ogImageUrl = getOgImageUrl({
-        title: data.title,
-        schemaType: "BlogPosting",
-      });
-      return {
-        openGraph: { images: [ogImageUrl] },
-        twitter: { images: [ogImageUrl] },
-      };
-    }
-  }
-
-  const ogImageUrl = getOgImageUrl({ title: "Blog", schemaType: "BlogPosting" });
-  return {
-    openGraph: { images: [ogImageUrl] },
-    twitter: { images: [ogImageUrl] },
-  };
-}
-
-export default async function BlogRoute(
-  props: BlogRouteProps,
-): Promise<ReactElement> {
-  const { locale, slug } = await props.params;
-  const t = await getTranslations("blog");
-  const source = props.blogSource ?? defaultBlogSource;
-
-  if (slug && slug.length > 0) {
-    const page = source.getPage(slug);
-    if (!page) notFound();
-
-    // Fumadocs' `PageData` is opaque; the frontmatter contract is enforced
-    // by the `defineDocs` schema in source.config.ts at build time.
-    const data = page.data as unknown as BlogPostPageData;
-    const jsonLd = blogPostingJsonLd({
-      slug: slug.join("/"),
-      title: data.title,
-      description: data.description,
-      locale,
-      ...(data.date !== undefined && { publishedAt: data.date }),
-      ...(data.updated !== undefined && { updatedAt: data.updated }),
-      ...(data.image !== undefined && { image: data.image }),
-    });
-
-    // The compiled MDX body renders through the section's `children` slot so it
-    // keeps full formatting; the section maps the rest of the post (#2714).
-    const MDXBody = data.body;
-
-    return (
-      <>
-        <JsonLdScript data={jsonLd} />
-        <main>
-          <BlogPost sectionName="blog-post" data={toBlogPostData(data)}>
-            {MDXBody ? <MDXBody /> : null}
-          </BlogPost>
-        </main>
-      </>
-    );
-  }
-
-  const pages = source.getPages();
-
-  const indexJsonLd = blogListJsonLd({
-    slug: "blog",
-    title: "Blog",
-    description: "Writing on AEO and AX-first software.",
-    locale,
-  });
-
-  if (pages.length === 0) {
-    // #4154: uniform with every other contentless surface — the empty-blog
-    // placeholder is an authoring affordance, so it renders outside production
-    // and 404s inside it rather than serving a stock page to a visitor.
-    if (!emptyStateVisible()) notFound();
-
-    return (
-      <>
-        <JsonLdScript data={indexJsonLd} />
-        <main>
-          <h1>{t("heading")}</h1>
-          <p
-            data-testid="blog-empty-placeholder"
-            data-sentinel={BLOG_EMPTY_SENTINEL}
-          >
-            {t("emptyState")} <code>{"content/blog/"}</code>{" "}
-            {t("emptyStateTrailing")}
-          </p>
-        </main>
-      </>
-    );
-  }
-
-  return (
-    <>
-      <JsonLdScript data={indexJsonLd} />
-      <main>
-        <h1>{t("heading")}</h1>
-        <BlogList sectionName="blog-list" data={toBlogListData(pages)} />
-      </main>
-    </>
-  );
-}

package/templates/apps/web/app/[locale]/dev/purchase/__tests__/actions.test.ts

@@ -1,160 +0,0 @@
-/**
- * Tests for purchaseAction Server Action.
- *
- * Acceptance criteria verified here:
- * - purchaseAction(validInput) returns { url: string } on success
- * - purchaseAction(invalidInput) returns Zod validation errors
- * - purchaseAction calls @working-theory/api-client checkout helper
- * - Parity shape: purchaseAction returns the same response shape as ailkPurchase
- */
-
-import { purchaseAction } from "../purchase.actions.js";
-
-// Mock @working-theory/api-client
-jest.mock("@working-theory/api-client", () => ({
-  checkout: {
-    createSession: jest.fn(),
-  },
-}));
-
-import { checkout } from "@working-theory/api-client";
-const mockCreateSession = checkout.createSession as jest.Mock;
-
-afterEach(() => {
-  jest.clearAllMocks();
-});
-
-describe("purchaseAction — valid input", () => {
-  it("returns { url } on success", async () => {
-    mockCreateSession.mockResolvedValueOnce({
-      ok: true,
-      body: {
-        sessionId: "cs_test_abc123",
-        url: "https://checkout.stripe.com/pay/cs_test_abc123",
-      },
-    });
-
-    const result = await purchaseAction({
-      priceId: "price_test_123",
-      quantity: 1,
-      successUrl: "https://example.com/success",
-      cancelUrl: "https://example.com/cancel",
-    });
-
-    expect(result).toEqual({
-      url: "https://checkout.stripe.com/pay/cs_test_abc123",
-    });
-  });
-
-  it("returns { url } when quantity is omitted", async () => {
-    mockCreateSession.mockResolvedValueOnce({
-      ok: true,
-      body: {
-        sessionId: "cs_test_xyz",
-        url: "https://checkout.stripe.com/pay/cs_test_xyz",
-      },
-    });
-
-    const result = await purchaseAction({
-      priceId: "price_test_abc",
-      successUrl: "https://example.com/success",
-      cancelUrl: "https://example.com/cancel",
-    });
-
-    expect(result).toEqual({
-      url: "https://checkout.stripe.com/pay/cs_test_xyz",
-    });
-  });
-
-  it("calls checkout.createSession with mapped payload", async () => {
-    mockCreateSession.mockResolvedValueOnce({
-      ok: true,
-      body: {
-        sessionId: "cs_test_def",
-        url: "https://checkout.stripe.com/pay/cs_test_def",
-      },
-    });
-
-    await purchaseAction({
-      priceId: "price_plan_pro",
-      quantity: 2,
-      successUrl: "https://example.com/success",
-      cancelUrl: "https://example.com/cancel",
-    });
-
-    expect(mockCreateSession).toHaveBeenCalledWith({
-      productCode: "price_plan_pro",
-      quantity: 2,
-      successUrl: "https://example.com/success",
-      cancelUrl: "https://example.com/cancel",
-    });
-  });
-});
-
-describe("purchaseAction — invalid input (Zod errors)", () => {
-  it("returns validation errors when priceId is missing", async () => {
-    const result = await purchaseAction({
-      successUrl: "https://example.com/success",
-      cancelUrl: "https://example.com/cancel",
-    } as never);
-
-    expect(result).toHaveProperty("errors");
-    expect(mockCreateSession).not.toHaveBeenCalled();
-  });
-
-  it("returns validation errors when priceId is empty", async () => {
-    const result = await purchaseAction({
-      priceId: "",
-      successUrl: "https://example.com/success",
-      cancelUrl: "https://example.com/cancel",
-    });
-
-    expect(result).toHaveProperty("errors");
-    expect(mockCreateSession).not.toHaveBeenCalled();
-  });
-
-  it("returns validation errors when priceId contains invalid characters", async () => {
-    // priceId must be min length 1; test with a non-string
-    const result = await purchaseAction({
-      // eslint-disable-next-line no-restricted-syntax -- Phase 2/3 follow-up: pre-existing test-hygiene violation
-      priceId: 12345 as unknown as string,
-      successUrl: "https://example.com/success",
-      cancelUrl: "https://example.com/cancel",
-    });
-
-    expect(result).toHaveProperty("errors");
-    expect(mockCreateSession).not.toHaveBeenCalled();
-  });
-
-  it("returns validation errors when quantity is not a positive integer", async () => {
-    const result = await purchaseAction({
-      priceId: "price_test",
-      quantity: 0,
-      successUrl: "https://example.com/success",
-      cancelUrl: "https://example.com/cancel",
-    });
-
-    expect(result).toHaveProperty("errors");
-    expect(mockCreateSession).not.toHaveBeenCalled();
-  });
-});
-
-describe("purchaseAction — parity shape with ailkPurchase", () => {
-  it("success shape matches ailkPurchase success shape: { url: string }", async () => {
-    mockCreateSession.mockResolvedValueOnce({
-      ok: true,
-      body: {
-        sessionId: "cs_test_parity",
-        url: "https://checkout.stripe.com/pay/cs_test_parity",
-      },
-    });
-
-    const result = await purchaseAction({
-      priceId: "price_parity",
-      successUrl: "https://example.com/success",
-      cancelUrl: "https://example.com/cancel",
-    });
-
-    expect(typeof (result as { url: string }).url).toBe("string");
-  });
-});

package/templates/apps/web/app/[locale]/dev/purchase/error.tsx

@@ -1,25 +0,0 @@
-"use client";
-// Per-segment error boundary for the /dev/purchase (checkout) route.
-// Does not make any claim about whether payment was processed.
-import type { ReactElement } from "react";
-
-import { ErrorFallback } from "../../../error-fallback";
-
-interface ErrorProps {
-  error: Error & { digest?: string };
-  reset: () => void;
-}
-
-export default function PurchaseError({
-  error,
-  reset,
-}: ErrorProps): ReactElement {
-  return (
-    <ErrorFallback
-      error={error}
-      reset={reset}
-      heading="Checkout couldn't complete"
-      body="Something interrupted your purchase attempt. Please try again to continue."
-    />
-  );
-}

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

@@ -1,117 +0,0 @@
-/* eslint-disable no-restricted-syntax -- i18n-allow: dev-only route, not in customer navigation (ADR 0019) */
-"use client";
-
-/**
- * /dev/purchase — demo route for the purchaseAction Server Action.
- *
- * SD-3d: /dev/-prefixed routes are not in customer-visible navigation.
- * This page exists to exercise the Server Action / MCP tool parity pair
- * in a browser context during Phase 3 development.
- */
-
-import { useState } from "react";
-
-import { purchaseAction } from "./purchase.actions";
-import type { PurchaseActionResult } from "./purchase.actions";
-
-export default function DevPurchasePage() {
-  const [priceId, setPriceId] = useState("price_test_123");
-  const [result, setResult] = useState<PurchaseActionResult | null>(null);
-  const [pending, setPending] = useState(false);
-
-  async function handleSubmit(e: React.FormEvent<HTMLFormElement>) {
-    e.preventDefault();
-    setPending(true);
-    setResult(null);
-    try {
-      const res = await purchaseAction({ priceId });
-      setResult(res);
-      if ("url" in res) {
-        window.location.href = res.url;
-      }
-    } finally {
-      setPending(false);
-    }
-  }
-
-  return (
-    <main style={{ padding: "2rem", maxWidth: 480 }}>
-      <h1>Dev: Purchase (Server Action smoke test)</h1>
-      <p style={{ fontSize: "0.875rem", color: "#666" }}>
-        /dev/ — not in customer navigation
-      </p>
-
-      <form
-        onSubmit={(e) => void handleSubmit(e)}
-        style={{
-          display: "flex",
-          flexDirection: "column",
-          gap: "1rem",
-          marginTop: "1.5rem",
-        }}
-      >
-        <label>
-          <span
-            style={{
-              display: "block",
-              marginBottom: "0.25rem",
-              fontWeight: 500,
-            }}
-          >
-            Price ID
-          </span>
-          <input
-            type="text"
-            value={priceId}
-            onChange={(e) => setPriceId(e.target.value)}
-            placeholder="price_test_..."
-            required
-            style={{
-              width: "100%",
-              padding: "0.5rem",
-              border: "1px solid #ccc",
-              borderRadius: 4,
-            }}
-          />
-        </label>
-
-        <button
-          type="submit"
-          disabled={pending}
-          style={{
-            padding: "0.5rem 1rem",
-            background: "#0070f3",
-            color: "#fff",
-            border: "none",
-            borderRadius: 4,
-            cursor: pending ? "not-allowed" : "pointer",
-          }}
-        >
-          {pending ? "Creating session…" : "Start checkout"}
-        </button>
-      </form>
-
-      {result && (
-        <div style={{ marginTop: "1.5rem" }}>
-          {"errors" in result ? (
-            <div>
-              <strong>Validation errors:</strong>
-              <ul>
-                {result.errors.map((e, i) => (
-                  <li key={i}>
-                    {e.path.join(".") || "input"}: {e.message}
-                  </li>
-                ))}
-              </ul>
-            </div>
-          ) : (
-            <div>
-              <strong>Checkout URL:</strong>{" "}
-              <a href={result.url}>{result.url}</a>
-            </div>
-          )}
-        </div>
-      )}
-    </main>
-  );
-}