npm - create-ailk - Versions diffs - 0.1.0 → 0.2.0 - Mend

create-ailk 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (620) hide show

package/templates/apps/web/app/[locale]/__tests__/layout.test.tsx DELETED Viewed

@@ -1,120 +0,0 @@
-/**
- * Tests for LocaleLayout — verifies the <html dir> attribute is set
- * correctly based on the active locale.
- *
- * The layout is an async server component; jest renders it by awaiting
- * the returned ReactElement promise. Heavy Next.js/next-intl deps are
- * mocked so the test focuses on the dir attribute wiring only.
- */
-import React from "react";
-import { render } from "@testing-library/react";
-// ── Mock heavy/Next.js-specific dependencies ──────────────────────────
-jest.mock("next/navigation", () => ({
-  usePathname: jest.fn().mockReturnValue("/en/"),
-}));
-jest.mock("next/headers", () => ({
-  headers: jest.fn().mockResolvedValue({
-    get: jest.fn().mockReturnValue("/"),
-  }),
-}));
-jest.mock("next-intl/server", () => ({
-  getMessages: jest.fn().mockResolvedValue({}),
-  getTranslations: jest.fn().mockImplementation(({ namespace }: { namespace: string }) => {
-    if (namespace === "nav") {
-      const t = (key: string) => key;
-      return Promise.resolve(t);
-    }
-    const t = (key: string) => key;
-    return Promise.resolve(t);
-  }),
-}));
-jest.mock("next-intl", () => ({
-  NextIntlClientProvider: ({ children }: { children: React.ReactNode }) => (
-    <>{children}</>
-  ),
-}));
-jest.mock("@working-theory/web-i18n", () => ({
-  readLocales: jest.fn().mockReturnValue(["en"]),
-  buildHreflangAlternates: jest.fn().mockReturnValue({}),
-  getStealthRobots: jest.fn().mockReturnValue({}),
-}));
-jest.mock("@working-theory/analytics", () => ({
-  Telemetry: () => null,
-  VerificationMeta: () => null,
-}));
-// ── Import subject under test ──────────────────────────────────────────
-import LocaleLayout, { generateMetadata } from "../layout";
-async function renderLayout(locale: string): Promise<void> {
-  const element = LocaleLayout({
-    children: <span data-testid="child">content</span>,
-    params: Promise.resolve({ locale }),
-  });
-  const resolved = await element;
-  render(resolved);
-}
-describe("generateMetadata()", () => {
-  it("returns a title and description", async () => {
-    const metadata = await generateMetadata();
-    expect(metadata.title).toBe("AI Launch Kit");
-    expect(metadata.description).toMatch(/OSS/);
-  });
-  it("includes alternates.languages from buildHreflangAlternates", async () => {
-    const metadata = await generateMetadata();
-    expect(metadata.alternates).toBeDefined();
-    expect(metadata.alternates?.languages).toBeDefined();
-  });
-});
-describe("LocaleLayout — chrome smoke (#1451)", () => {
-  it("renders Nav with aria-label=Primary", async () => {
-    await renderLayout("en");
-    expect(document.querySelector("nav[aria-label='Primary']")).toBeInTheDocument();
-  });
-  it("renders Footer element", async () => {
-    await renderLayout("en");
-    expect(document.querySelector("footer")).toBeInTheDocument();
-  });
-  it("renders nav logo link pointing to locale home", async () => {
-    await renderLayout("en");
-    const logoLink = document.querySelector("[data-testid='brand-logo-link']");
-    expect(logoLink).toBeInTheDocument();
-    // as-needed dialect (#3450): bare for the default locale.
-    expect(logoLink?.getAttribute("href")).toBe("/");
-  });
-});
-describe("LocaleLayout — <html dir> attribute", () => {
-  // React 19 + jsdom: <html> is a singleton (document.documentElement);
-  // RTL merges the rendered <html> attributes onto the live document root.
-  it('renders dir="ltr" for locale "en"', async () => {
-    await renderLayout("en");
-    expect(document.documentElement.getAttribute("dir")).toBe("ltr");
-  });
-  it('renders dir="rtl" for locale "ar"', async () => {
-    await renderLayout("ar");
-    expect(document.documentElement.getAttribute("dir")).toBe("rtl");
-  });
-  it('preserves lang attribute for locale "en"', async () => {
-    await renderLayout("en");
-    expect(document.documentElement.getAttribute("lang")).toBe("en");
-  });
-  it('preserves lang attribute for locale "ar"', async () => {
-    await renderLayout("ar");
-    expect(document.documentElement.getAttribute("lang")).toBe("ar");
-  });
-});

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

@@ -1,202 +0,0 @@
-/**
- * HTML snapshot regression tests for the apps/web → @working-theory/page-renderer migration.
- *
- * Node version: captured against Node 22.x (same as CI).
- * MDX seed content: DI-injected stub — no fs reads, deterministic across environments.
- *
- * Two-commit strategy (per spec §8 Open Questions):
- *   Commit 1: this file added; snapshots captured against pre-migration routes (RED-passing).
- *   Commit 2: routes migrated; same snapshots verify diff=0 (GREEN).
- *
- * Each of the four routes is tested in two states:
- *   - empty: getMdxSource returns null → empty-state branch
- *   - populated: getMdxSource returns a minimal MdxPageSource → full render
- *
- * Failure = snapshot diff > 0 bytes. DO NOT regenerate snapshots to pass.
- * A non-zero diff indicates a behavior regression in the migration. Escalate.
- */
-import React from "react";
-import { render } from "@testing-library/react";
-import { stripJsonLd } from "@working-theory/page-renderer/testing";
-// ── @working-theory/ui mock ─────────────────────────────────────────────────────────────
-// SectionRenderer renders a predictable deterministic div so the snapshot is
-// stable across section-component implementations.
-jest.mock("@working-theory/ui", () => ({
-  SectionRenderer: ({ sections }: { sections: unknown[] }) =>
-    React.createElement("div", {
-      "data-testid": "section-renderer",
-      "data-section-count": String(sections.length),
-    }),
-}));
-// ── Import page components ─────────────────────────────────────────────────────
-import HomePage from "../page";
-import AboutPage from "../about/page";
-import FAQPage from "../faq/page";
-import LaunchServicePage from "../launch-service/page";
-// ── Shared stubs ───────────────────────────────────────────────────────────────
-function makeSource(
-  type: string,
-  slug: string,
-  title: string,
-  description: string,
-) {
-  return {
-    frontmatter: {
-      type: type as "HomePage",
-      slug,
-      title,
-      description,
-    },
-    body: "",
-  };
-}
-const getMdxSourceEmpty = jest.fn().mockResolvedValue(null);
-const getPageSectionsEmpty = jest.fn().mockResolvedValue([]);
-// ── HomePage ───────────────────────────────────────────────────────────────────
-describe("HomePage — snapshot regression", () => {
-  it("empty state renders deterministic HTML", async () => {
-    const element = await HomePage({
-      params: Promise.resolve({ locale: "en" }),
-      getMdxSource: getMdxSourceEmpty,
-      getPageSections: getPageSectionsEmpty,
-    });
-    const { container } = render(element);
-    expect(stripJsonLd(container.innerHTML)).toMatchInlineSnapshot(
-      `"<main><h1>AI Launch Kit</h1><p data-testid="home-description">AX-first OSS template for shipping software with API + MCP as canonical surfaces.</p></main>"`,
-    );
-  });
-  it("populated state renders deterministic HTML", async () => {
-    const source = makeSource(
-      "HomePage",
-      "home",
-      "AI Launch Kit",
-      "AX-first OSS template for shipping software with API + MCP as canonical surfaces.",
-    );
-    const getMdxSourcePopulated = jest.fn().mockResolvedValue(source);
-    const getPageSectionsPopulated = jest.fn().mockResolvedValue([]);
-    const element = await HomePage({
-      params: Promise.resolve({ locale: "en" }),
-      getMdxSource: getMdxSourcePopulated,
-      getPageSections: getPageSectionsPopulated,
-    });
-    const { container } = render(element);
-    expect(stripJsonLd(container.innerHTML)).toMatchInlineSnapshot(
-      `"<main><h1>AI Launch Kit</h1><p data-testid="home-description">AX-first OSS template for shipping software with API + MCP as canonical surfaces.</p><div data-testid="section-renderer" data-section-count="0"></div></main>"`,
-    );
-  });
-});
-// ── AboutPage ──────────────────────────────────────────────────────────────────
-describe("AboutPage — snapshot regression", () => {
-  it("empty state renders deterministic HTML", async () => {
-    const element = await AboutPage({
-      params: Promise.resolve({ locale: "en" }),
-      getMdxSource: getMdxSourceEmpty,
-      getPageSections: getPageSectionsEmpty,
-    });
-    const { container } = render(element);
-    expect(stripJsonLd(container.innerHTML)).toMatchInlineSnapshot(
-      `"<main><h1>About</h1><p data-testid="section-empty-state">About page content coming soon.</p></main>"`,
-    );
-  });
-  it("populated state renders deterministic HTML", async () => {
-    const source = makeSource("AboutPage", "about", "About Us", "Who we are.");
-    const getMdxSourcePopulated = jest.fn().mockResolvedValue(source);
-    const getPageSectionsPopulated = jest.fn().mockResolvedValue([]);
-    const element = await AboutPage({
-      params: Promise.resolve({ locale: "en" }),
-      getMdxSource: getMdxSourcePopulated,
-      getPageSections: getPageSectionsPopulated,
-    });
-    const { container } = render(element);
-    expect(stripJsonLd(container.innerHTML)).toMatchInlineSnapshot(
-      `"<main><h1>About Us</h1><p data-testid="about-description">Who we are.</p><div data-testid="section-renderer" data-section-count="0"></div></main>"`,
-    );
-  });
-});
-// ── FAQPage ────────────────────────────────────────────────────────────────────
-describe("FAQPage — snapshot regression", () => {
-  it("empty state renders deterministic HTML (with scaffold JSON-LD)", async () => {
-    const element = await FAQPage({
-      params: Promise.resolve({ locale: "en" }),
-      getMdxSource: getMdxSourceEmpty,
-      getPageSections: getPageSectionsEmpty,
-    });
-    const { container } = render(element);
-    expect(stripJsonLd(container.innerHTML)).toMatchInlineSnapshot(
-      `"<main><h1>FAQ</h1><p data-testid="section-empty-state">Frequently asked questions content coming soon.</p></main>"`,
-    );
-  });
-  it("populated state renders deterministic HTML", async () => {
-    const source = makeSource(
-      "FAQPage",
-      "faq",
-      "FAQ",
-      "Frequently asked questions.",
-    );
-    const getMdxSourcePopulated = jest.fn().mockResolvedValue(source);
-    const getPageSectionsPopulated = jest.fn().mockResolvedValue([]);
-    const element = await FAQPage({
-      params: Promise.resolve({ locale: "en" }),
-      getMdxSource: getMdxSourcePopulated,
-      getPageSections: getPageSectionsPopulated,
-    });
-    const { container } = render(element);
-    expect(stripJsonLd(container.innerHTML)).toMatchInlineSnapshot(
-      `"<main><h1>FAQ</h1><p data-testid="faq-description">Frequently asked questions.</p><div data-testid="section-renderer" data-section-count="0"></div></main>"`,
-    );
-  });
-});
-// ── LaunchServicePage ──────────────────────────────────────────────────────────
-describe("LaunchServicePage — snapshot regression", () => {
-  it("empty state renders deterministic HTML", async () => {
-    const element = await LaunchServicePage({
-      params: Promise.resolve({ locale: "en" }),
-      getMdxSource: getMdxSourceEmpty,
-      getPageSections: getPageSectionsEmpty,
-    });
-    const { container } = render(element);
-    expect(stripJsonLd(container.innerHTML)).toMatchInlineSnapshot(
-      `"<main><h1>Launch Service</h1><p data-testid="section-empty-state">Launch Service page content coming soon.</p></main>"`,
-    );
-  });
-  it("populated state renders deterministic HTML", async () => {
-    const source = makeSource(
-      "Service",
-      "launch-service",
-      "Launch Service",
-      "Our launch service offering.",
-    );
-    const getMdxSourcePopulated = jest.fn().mockResolvedValue(source);
-    const getPageSectionsPopulated = jest.fn().mockResolvedValue([]);
-    const element = await LaunchServicePage({
-      params: Promise.resolve({ locale: "en" }),
-      getMdxSource: getMdxSourcePopulated,
-      getPageSections: getPageSectionsPopulated,
-    });
-    const { container } = render(element);
-    expect(stripJsonLd(container.innerHTML)).toMatchInlineSnapshot(
-      `"<main><h1>Launch Service</h1><p data-testid="launch-service-description">Our launch service offering.</p><div data-testid="section-renderer" data-section-count="0"></div></main>"`,
-    );
-  });
-});

package/templates/apps/web/app/__tests__/error-boundaries.test.tsx DELETED Viewed

@@ -1,152 +0,0 @@
-import React from "react";
-import { render, screen, fireEvent } from "@testing-library/react";
-import "@testing-library/jest-dom";
-import RootError from "../error";
-import NotFound from "../not-found";
-import ContactError from "../[locale]/contact/error";
-import PurchaseError from "../[locale]/dev/purchase/error";
-function buildError(message = "Test error"): Error & { digest?: string } {
-  const err = new Error(message) as Error & { digest?: string };
-  err.digest = "test-digest-1";
-  return err;
-}
-describe("RootError", () => {
-  beforeEach(() => {
-    jest.spyOn(console, "error").mockImplementation(() => {});
-  });
-  afterEach(() => {
-    (console.error as jest.Mock).mockRestore();
-  });
-  it("renders a fallback heading when an error is provided", () => {
-    const err = buildError("Something bad");
-    const reset = jest.fn();
-    render(<RootError error={err} reset={reset} />);
-    expect(screen.getByRole("heading", { level: 1 })).toBeInTheDocument();
-  });
-  it("renders a Try again button", () => {
-    const err = buildError();
-    const reset = jest.fn();
-    render(<RootError error={err} reset={reset} />);
-    expect(
-      screen.getByRole("button", { name: /try again/i }),
-    ).toBeInTheDocument();
-  });
-  it("calls reset when Try again is clicked", () => {
-    const err = buildError();
-    const reset = jest.fn();
-    render(<RootError error={err} reset={reset} />);
-    fireEvent.click(screen.getByRole("button", { name: /try again/i }));
-    expect(reset).toHaveBeenCalledTimes(1);
-  });
-  it("calls console.error with the error on mount", () => {
-    const err = buildError("logged error");
-    const reset = jest.fn();
-    render(<RootError error={err} reset={reset} />);
-    expect(console.error).toHaveBeenCalledWith(err);
-  });
-});
-describe("NotFound", () => {
-  it("renders a 404 heading", () => {
-    render(<NotFound />);
-    expect(screen.getByRole("heading", { level: 1 })).toBeInTheDocument();
-  });
-  it("renders a link back to the home page", () => {
-    render(<NotFound />);
-    const link = screen.getByRole("link");
-    expect(link).toHaveAttribute("href", "/");
-  });
-});
-describe("ContactError", () => {
-  beforeEach(() => {
-    jest.spyOn(console, "error").mockImplementation(() => {});
-  });
-  afterEach(() => {
-    (console.error as jest.Mock).mockRestore();
-  });
-  it("renders a heading specific to the lead-capture flow (message/contact)", () => {
-    const err = buildError("Contact error");
-    const reset = jest.fn();
-    render(<ContactError error={err} reset={reset} />);
-    const heading = screen.getByRole("heading", { level: 1 });
-    expect(heading.textContent?.toLowerCase()).toMatch(/message|contact/);
-  });
-  it("does NOT render generic 'something went wrong' as the heading", () => {
-    const err = buildError();
-    const reset = jest.fn();
-    render(<ContactError error={err} reset={reset} />);
-    const heading = screen.getByRole("heading", { level: 1 });
-    expect(heading.textContent?.toLowerCase()).not.toBe("something went wrong");
-  });
-  it("renders a Try again button that calls reset", () => {
-    const err = buildError();
-    const reset = jest.fn();
-    render(<ContactError error={err} reset={reset} />);
-    fireEvent.click(screen.getByRole("button", { name: /try again/i }));
-    expect(reset).toHaveBeenCalledTimes(1);
-  });
-  it("calls console.error with the error on mount", () => {
-    const err = buildError("contact logged");
-    const reset = jest.fn();
-    render(<ContactError error={err} reset={reset} />);
-    expect(console.error).toHaveBeenCalledWith(err);
-  });
-});
-describe("PurchaseError", () => {
-  beforeEach(() => {
-    jest.spyOn(console, "error").mockImplementation(() => {});
-  });
-  afterEach(() => {
-    (console.error as jest.Mock).mockRestore();
-  });
-  it("renders a heading specific to the checkout flow (checkout/purchase)", () => {
-    const err = buildError("Purchase error");
-    const reset = jest.fn();
-    render(<PurchaseError error={err} reset={reset} />);
-    const heading = screen.getByRole("heading", { level: 1 });
-    expect(heading.textContent?.toLowerCase()).toMatch(/checkout|purchase/);
-  });
-  it("does NOT claim payment was or was not processed in the heading", () => {
-    const err = buildError();
-    const reset = jest.fn();
-    render(<PurchaseError error={err} reset={reset} />);
-    const heading = screen.getByRole("heading", { level: 1 });
-    expect(heading.textContent?.toLowerCase()).not.toMatch(
-      /payment (was|not|failed|charged)/,
-    );
-  });
-  it("renders a Try again button that calls reset", () => {
-    const err = buildError();
-    const reset = jest.fn();
-    render(<PurchaseError error={err} reset={reset} />);
-    fireEvent.click(screen.getByRole("button", { name: /try again/i }));
-    expect(reset).toHaveBeenCalledTimes(1);
-  });
-  it("calls console.error with the error on mount", () => {
-    const err = buildError("purchase logged");
-    const reset = jest.fn();
-    render(<PurchaseError error={err} reset={reset} />);
-    expect(console.error).toHaveBeenCalledWith(err);
-  });
-});

package/templates/apps/web/content/en/blog/index.mdx DELETED Viewed

@@ -1,15 +0,0 @@
----
-title: Blog
-description: Writing on AEO, answer-engine citation readiness, and what it means to ship software with three peers — UX, API, and MCP.
-author:
-  name: The AI Launch Kit Team
-tags:
-  - AEO
-  - AX
----
-# Blog
-This is where we think out loud. The topics stay close to the work: schema.org implementation details, how LLMs decide what to cite, and what AX-first looks like in practice.
-The posts are opinionated because vague advice isn't useful. If something here turns out to be wrong, we'll update it and say so.

package/templates/apps/web/content/en/blog/launching-ailk.mdx DELETED Viewed

@@ -1,20 +0,0 @@
----
-title: Launching AI Launch Kit
-description: A short note on why we built an AX-first OSS template and what ships in v1.
-date: "2026-05-06"
-author:
-  name: The AI Launch Kit Team
-tags:
-  - Announcements
-  - AX
----
-# Launching AI Launch Kit
-We're shipping the first public version today. The template gives you three
-peer apps (web, api, mcp), a content-adapter contract with MDX as the default
-backend, and a JSON-LD pipeline for SEO that doesn't require manual schema.org
-authoring.
-The goal is clone-to-shipping in under an hour. If you hit friction, the
-README's standalone test should catch it before you do.

package/templates/apps/web/content/en/docs/getting-started.mdx DELETED Viewed

@@ -1,30 +0,0 @@
----
-title: Getting Started
-description: Everything you need to know to get your AI Launch Kit project running.
----
-# Getting Started
-Welcome to AI Launch Kit. This guide walks you through the first steps after cloning the template.
-## Prerequisites
-- Node.js 20+
-- pnpm 9+
-## Quick start
-```bash
-pnpm install
-pnpm dev
-```
-The dev server starts three apps in parallel:
-- **web** (`localhost:3000`) — the Next.js UX surface
-- **api** (`localhost:3001`) — the Fastify REST API
-- **mcp** — the MCP server (stdio transport)
-## Next steps
-Replace the seed content in `apps/web/content/en/` with your own pages, blog posts, and docs. Each MDX file maps to a route automatically via Fumadocs.

package/templates/content/.gitkeep DELETED Viewed

File without changes

package/templates/content/CLAUDE.md DELETED Viewed

@@ -1,85 +0,0 @@
-# content/ — MDX Content Authoring
-Inherits root `CLAUDE.md`. This file owns content-authoring rules.
-## What lives here
-File-based MDX content, one file per page, organized by page type:
-content/
-├── HomePage/home.mdx
-├── ServicesList/services.mdx
-├── Service/<slug>.mdx
-├── BlogList/blog.mdx
-├── BlogPosting/<slug>.mdx
-└── ...
-For the full list of supported page types and what each emits, see `packages/schema/README.md`. It's the source of truth. For per-page-type component guidance (which `@working-theory/ui` components are idiomatic for each family), see `packages/schema/CLAUDE.md` § `@working-theory/ui` component map.
-## Frontmatter contract (hard rule)
-Every MDX file has frontmatter validated at build time against `@working-theory/schema`. Required:
-- `type` — must match a `SchemaOrgType` key from the schema README
-- `slug` — URL slug, no leading slash
-- `title` — visible page title
-- `description` — meta description and JSON-LD `description`
-Optional:
-- `locale` — defaults to `'en'`. Emitted as `inLanguage`.
-- `publishedAt`, `updatedAt`, `image`
-- `schema` — escape hatch (see below)
-Build fails on missing/invalid frontmatter. Fix the frontmatter, not the validator.
-## The `schema` field (escape hatch)
-`schema` is a shallow-merged record. Frontmatter wins on conflicts with the builder. Use it to:
-- Add structured sub-entities (`author`, `mainEntity`, `step`)
-- Enrich page types whose schema.org default is generic (e.g. Integration → `mainEntity: SoftwareApplication`)
-- Override a derived field (rare)
-Some types (JobPosting in particular) REQUIRE programmatic overrides for full coverage — frontmatter alone can't express `baseSalary`, `employmentType`. See `packages/schema/README.md` for which types need code-level overrides.
-After using `schema`, run `ailk audit` — a malformed override produces invalid JSON-LD and tanks AEO scoring.
-## Component vocabulary (universal — page type doesn't change this)
-These components are available on any page. Choice depends on content, not page type. An FAQ block belongs in `<FAQ>` whether it's on a HomePage, ServicePage, or FAQPage.
-- `<Hero>` — top-of-page hero. One per page max.
-- `<FAQ>` — FAQ entry. **One question per block** (see AEO rules below).
-- `<CTA>` — call-to-action card. Use sparingly.
-- `<Testimonial>` — single testimonial. Multiple = multiple blocks.
-- `<PriceTable>` — pricing display.
-- `<FeatureGrid>` — feature/benefit grid.
-- `<Locations>` — physical locations.
-- `<BusinessHours>` — hours of operation.
-For the per-page-type editorial map (which family of pages typically uses which components), see `packages/schema/CLAUDE.md` § `@working-theory/ui` component map.
-Don't use raw HTML where a component exists. Components carry schema and styling guarantees; `<div>` soup throws both away.
-## AEO editorial craft (universal — this is the wedge)
-**Lead with the answer.** First 60 words of body content state the answer to the page's implicit question. LLM citation extractors read top-down and bail early. Backstory comes after.
-**One question per `<FAQ>` block.** Don't cram multiple Q&As into one block. Each block becomes one `Question` entity in JSON-LD — separation drives citability.
-**Entity clarity in the first paragraph.** Name the company, product, location, or person explicitly. "We" and "our service" are entity-opaque. AEO rewards unambiguous attribution.
-**Concrete claims over adjectives.** "Ships in 48 hours" beats "fast turnaround." Specifics get cited; vagueness gets skipped.
-**Headings as questions when natural.** H2/H3 phrased as questions (when the content actually answers one) align with passage extraction.
-**Don't pad for length.** A 400-word page that answers cleanly outperforms a 1,500-word page that buries the answer.
-## What NOT to do
-- Don't hand-roll JSON-LD in MDX body. Ever.
-- Don't use `<script type="application/ld+json">` inside content.
-- Don't bypass the frontmatter validator.
-- Don't write `type: WebPage` to silence a validator error — pick the right type.
-- Don't use raw `<h1>` in body. The page template emits the H1 from `title`.