create-ailk 0.8.0 → 0.10.0

package/site-templates/minimalism-site/content/en/Service/second-engagement.mdx

@@ -1,38 +0,0 @@
----
-type: "Service"
-slug: "second-engagement"
-title: "{Second engagement}"
-description: "{One line on what this engagement is and who it suits. Replace before you launch.}"
-schema:
-  serviceType: "{Second engagement}"
-  provider:
-    "@type": Organization
-    name: "Your Company"
----
-
-# {Second engagement}
-
-{Open with the situation a reader is in when they come looking for this. Two or
-three sentences, no more — the detail belongs under the headings below.}
-
-## What it covers
-
-- {The first thing you actually do}
-- {The second thing you actually do}
-- {The third thing you actually do}
-
-## How it runs
-
-{One paragraph on the shape of the engagement: how it starts, how long it runs,
-who is involved on both sides, and what a week looks like.}
-
-## What you end up with
-
-{One paragraph on the deliverable. Be concrete — name the artefact, not the
-feeling.}
-
-## What it costs
-
-{One line on the pricing shape — fixed fee, retainer, day rate — and what it
-excludes. Replace with your real numbers, or delete this section and let the
-call do it.}

package/site-templates/minimalism-site/content/en/Service/third-engagement.mdx

@@ -1,38 +0,0 @@
----
-type: "Service"
-slug: "third-engagement"
-title: "{Third engagement}"
-description: "{One line on what this engagement is and who it suits. Replace before you launch.}"
-schema:
-  serviceType: "{Third engagement}"
-  provider:
-    "@type": Organization
-    name: "Your Company"
----
-
-# {Third engagement}
-
-{Open with the situation a reader is in when they come looking for this. Two or
-three sentences, no more — the detail belongs under the headings below.}
-
-## What it covers
-
-- {The first thing you actually do}
-- {The second thing you actually do}
-- {The third thing you actually do}
-
-## How it runs
-
-{One paragraph on the shape of the engagement: how it starts, how long it runs,
-who is involved on both sides, and what a week looks like.}
-
-## What you end up with
-
-{One paragraph on the deliverable. Be concrete — name the artefact, not the
-feeling.}
-
-## What it costs
-
-{One line on the pricing shape — fixed fee, retainer, day rate — and what it
-excludes. Replace with your real numbers, or delete this section and let the
-call do it.}

package/site-templates/minimalism-site/content/en/ServicesList/services.mdx

@@ -1,73 +0,0 @@
----
-type: "ServicesList"
-slug: "services"
-title: "Services"
-description: "The three engagements {your company} offers. Placeholder copy — replace before you launch."
-sections:
-  [
-    {
-      "id": "hero",
-      "type": "hero",
-      "data":
-        {
-          "variant": "centered",
-          "eyebrow": "Services",
-          "headline": "Three ways to work together",
-          "subheadline": "{One line on how to choose between them. Name the question a reader is actually asking.}",
-        },
-    },
-    {
-      "id": "engagements",
-      "type": "items",
-      "data":
-        {
-          "headline": "Engagements",
-          "columns": 3,
-          "items":
-            [
-              {
-                "title": "{First engagement}",
-                "description": "{One line on what it is and who it suits.}",
-                "link":
-                  {
-                    "label": "Read more",
-                    "href": "/services/first-engagement",
-                  },
-              },
-              {
-                "title": "{Second engagement}",
-                "description": "{One line on what it is and who it suits.}",
-                "link":
-                  {
-                    "label": "Read more",
-                    "href": "/services/second-engagement",
-                  },
-              },
-              {
-                "title": "{Third engagement}",
-                "description": "{One line on what it is and who it suits.}",
-                "link":
-                  {
-                    "label": "Read more",
-                    "href": "/services/third-engagement",
-                  },
-              },
-            ],
-        },
-    },
-    {
-      "id": "closing",
-      "type": "cta",
-      "data":
-        {
-          "variant": "minimal",
-          "headline": "Not sure which one?",
-          "description": "{One line inviting the reader to book the call instead of guessing.}",
-          "primaryCta": { "label": "Hire me →", "href": "/meet" },
-        },
-    },
-  ]
----
-
-{/_ Placeholder copy. The three detail pages under `content/en/Service/` carry
-the long form; this page is the chooser. _/}

package/site-templates/minimalism-site/flows/referral.flow.json

@@ -1,71 +0,0 @@
-{
-  "slug": "referral",
-  "defaultLocale": "en",
-  "steps": [
-    {
-      "key": "introduction",
-      "type": "field",
-      "copy": {
-        "title": {
-          "en": "Who should we meet?"
-        }
-      },
-      "fields": [
-        {
-          "name": "referrer_name",
-          "inputType": "text",
-          "required": true,
-          "mapsTo": "name",
-          "copy": {
-            "label": {
-              "en": "Your name"
-            },
-            "help": {
-              "en": "So we can tell them who sent us."
-            }
-          }
-        },
-        {
-          "name": "referrer_email",
-          "inputType": "email",
-          "required": true,
-          "mapsTo": "email",
-          "copy": {
-            "label": {
-              "en": "Your email"
-            },
-            "help": {
-              "en": "Where we tell you how it went."
-            }
-          }
-        },
-        {
-          "name": "referral_details",
-          "inputType": "textarea",
-          "required": true,
-          "minLength": 20,
-          "copy": {
-            "label": {
-              "en": "Who are they, and why them?"
-            },
-            "placeholder": {
-              "en": "Their name, a way to reach them, and one line on why you thought of them."
-            }
-          }
-        }
-      ]
-    },
-    {
-      "key": "sent",
-      "type": "message",
-      "copy": {
-        "title": {
-          "en": "Thank you — the introduction is in"
-        },
-        "body": {
-          "en": "We will reach out within a few days and let you know either way. Placeholder copy: replace it with what you actually do."
-        }
-      }
-    }
-  ]
-}

package/site-templates/minimalism-site/provenance.json

@@ -1,4 +0,0 @@
-{
-  "template": "minimalism-site",
-  "requires": ["marketing", "scheduling", "signal-collectors"]
-}

package/templates/.claude/skills/add-page/templates/route.tsx.tmpl

@@ -1,28 +0,0 @@
-// Emitted by `add-page` at `app/{{SLUG}}/page.tsx`. Substitutions:
-//   {{SLUG}}     — page slug (e.g., "pricing")
-//   {{TYPE}}     — schema.org @type (e.g., "Service")
-//   {{BUILDER}}  — typed builder name (e.g., "buildService")
-//   {{TITLE}}    — page title (e.g., "Pricing")
-import { notFound } from "next/navigation";
-
-import { JsonLd } from "@working-theory/jsonld";
-import { {{BUILDER}} } from "@working-theory/schema";
-import { mdxAdapter } from "@/lib/content";
-
-export default async function {{TYPE}}Page() {
-  const page = await mdxAdapter.getPage("{{SLUG}}");
-  if (!page) return notFound();
-
-  const schema = {{BUILDER}}(page);
-
-  return (
-    <main className="mx-auto max-w-3xl px-6 py-12">
-      <JsonLd schema={schema} />
-      <article className="prose dark:prose-invert">
-        <h1>{page.title}</h1>
-        {page.description ? <p className="lead">{page.description}</p> : null}
-        {/* Render MDX body via your project's MDX renderer of choice. */}
-      </article>
-    </main>
-  );
-}

package/templates/.claude/skills/setup-deploy/references/env-vars-template.md

@@ -1,175 +0,0 @@
-# `.env.example` Template
-
-The structure the `setup-deploy` skill emits at the consumer's
-project root. Placeholder values only — the skill never echoes a
-real secret.
-
-When `@working-theory/env` ships a Zod schema (currently a placeholder
-package), this template should be revised to derive from that
-schema instead. Until then, this file is the source of truth for
-what env vars an AILK consumer site reads.
-
-## Template
-
-```bash
-# AI Launch Kit — environment template
-# Copy this file to `.env.local` (gitignored) and fill in values.
-# Production values live in your deploy platform's dashboard
-# (Vercel project settings → Environment Variables).
-
-# ── Marketing / canonical domain ─────────────────────────────────
-# Your site's canonical public domain (no protocol).
-AILK_PUBLIC_DOMAIN=your-domain.com
-
-# ── Content backend ──────────────────────────────────────────────
-# AILK's MDX adapter is the default. Other adapters ship as
-# additive PRs later.
-CONTENT_BACKEND=mdx
-# Override the content directory. Default is <repo-root>/content.
-# AILK_CONTENT_ROOT=
-
-# ── Lead delivery ────────────────────────────────────────────────
-# Where contact-form messages go (RUNBOOK.md § "Leads — where
-# messages go"). Set these on the API project.
-#
-# Lead inbox — set by the `setup-database` skill. With it, messages
-# land in /leads and newsletter signups are collected.
-# DATABASE_URL=postgres://user:pass@host:5432/db
-# DATABASE_URL_NON_POOLED=postgres://user:pass@host:5432/db
-#
-# Email (default) — with no database, each message is emailed to you.
-# All three are required; a key alone sends nothing.
-# RESEND_API_KEY=
-# AILK_LEAD_NOTIFICATION_TO=you@your-domain.com
-# AILK_LEAD_NOTIFICATION_FROM=leads@your-domain.com
-#
-# With neither, /contact shows your contact email (content/_site.mdx
-# `contactEmail`) instead of the form in production.
-
-# ── Auth — required env vars ─────────────────────────────────────
-# Set to "1" to require sign-in for protected routes; default is
-# auth-disabled / public.
-# AILK_AUTH_REQUIRED=1
-#
-# NextAuth secret — production must be set; generate with:
-#   openssl rand -base64 32
-# Local dev (next dev) auto-generates a session-only secret.
-# NEXTAUTH_SECRET=
-#
-# Production base URL for callback construction. Local dev defaults
-# to http://localhost:3000 if unset.
-# NEXTAUTH_URL=https://your-domain.com
-
-# ── Auth — magic-link (Resend) ───────────────────────────────────
-# Activated when both AUTH_EMAIL_SERVER and AUTH_EMAIL_FROM are set.
-# Get a Resend API key at https://resend.com/api-keys.
-# AUTH_EMAIL_SERVER=smtp://resend:re_yourkeyhere@smtp.resend.com:465
-# AUTH_EMAIL_FROM=onboarding@resend.dev
-
-# ── Auth — Google OAuth ──────────────────────────────────────────
-# Activated when both GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET set.
-# Set up at https://console.cloud.google.com/apis/credentials.
-# Production callback: https://your-domain.com/api/auth/callback/google
-# GOOGLE_CLIENT_ID=
-# GOOGLE_CLIENT_SECRET=
-
-# ── Auth — GitHub OAuth ──────────────────────────────────────────
-# Activated when both GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET set.
-# Set up at https://github.com/settings/developers.
-# Production callback: https://your-domain.com/api/auth/callback/github
-# GITHUB_CLIENT_ID=
-# GITHUB_CLIENT_SECRET=
-
-# ── Stripe (sandbox keys only — sk_test_* / pk_test_*) ───────────
-# AILK is sandbox-only at v1. Live keys (sk_live_*, pk_live_*) are
-# hook-blocked from appearing in source.
-# Get test keys at https://dashboard.stripe.com/test/apikeys.
-# STRIPE_SECRET_KEY=sk_test_...
-# NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...
-# Webhook signing secret — see Stripe Dashboard → Developers →
-# Webhooks → <endpoint> → Signing secret. Format: whsec_*.
-# STRIPE_WEBHOOK_SECRET=
-
-# ── Analytics — all off by default ───────────────────────────────
-# Each provider is independent. Set the env var(s) to enable.
-#
-# Vercel Analytics — built-in dashboard for Vercel deploys.
-# Requires Vercel hosting. Set to "true" to enable. Requires redeploy
-# after change (NEXT_PUBLIC_* values bake at build time).
-# NEXT_PUBLIC_VERCEL_ANALYTICS_ENABLED=
-#
-# Google Analytics 4 — gtag.js measurement. Requires consent in EU/UK/CA.
-# Get the measurement ID from analytics.google.com → Admin → Data Streams.
-# Format: G-XXXXXXXXXX. Requires redeploy after change.
-# NEXT_PUBLIC_GA_MEASUREMENT_ID=
-#
-# GA4 Measurement Protocol — server-side analytics secret.
-# Required alongside NEXT_PUBLIC_GA_MEASUREMENT_ID for server-side
-# lead/purchase events.
-# GA_API_SECRET=
-#
-# Google Search Console — verification meta tag. No script, no consent.
-# Get the token from search.google.com/search-console → Settings →
-# Ownership verification → HTML tag. Paste only the content="..." value.
-# GOOGLE_SITE_VERIFICATION=
-```
-
-## Categories the skill emits
-
-The template above groups vars into six categories. Every emitted
-`.env.example` should hit each category at least with its header
-comment, even if the consumer hasn't activated any vars in that
-category — the comment block tells future-them what's available.
-
-Categories:
-
-1. Marketing / canonical domain
-2. Content backend
-3. Lead delivery (database or email)
-4. Auth — required + per-provider
-5. Stripe (sandbox-only)
-6. Analytics
-
-## What the skill never includes
-
-- Real secret values. All values are placeholders or commented
-  examples.
-- Live Stripe keys. Sandbox-only at AILK v1.
-- Live Vercel deploy tokens. The Vercel CLI handles deploy auth via
-  `vercel login`.
-- Database connection strings with embedded passwords. Comments
-  show shape only.
-
-## Counting vars for validation
-
-The skill's Step 5 validation counts the declared (uncommented) vars
-the template emits and confirms the count is non-zero. Empty
-`.env.example` is a bug. Currently declared vars in the template:
-
-- `AILK_PUBLIC_DOMAIN`
-- `CONTENT_BACKEND`
-
-(All other entries are commented optional vars.) The skill should
-not require the consumer to set every commented var — they're
-opt-in. The two declared entries are the minimum the AILK scaffold
-needs to boot, even on a static-content-only site.
-
-## Merge logic
-
-If the consumer already has `.env.example`, the skill (per SKILL.md
-Step 3) offers merge / overwrite / skip. Merge logic:
-
-1. Read the existing file.
-2. For each line in this template that's not a comment-only line,
-   check whether the var name already appears anywhere in the
-   existing file (commented or uncommented).
-3. Vars **already present** are not modified — the consumer's
-   existing comments and value choices win.
-4. Vars **missing** are appended at the end of the existing file
-   under a new section:
-   ```
-   # ── Added by setup-deploy ────────────────────────────────
-   ```
-
-This avoids duplicating vars while still surfacing additions the
-template gained since the consumer's last run.

package/templates/apps/api/.ailk/inbox/2026-09-20T14-57-31.552Z-fallback-1789916251590-037e9005.json

@@ -1,8 +0,0 @@
-{
-  "id": "fallback-1789916251590-037e9005",
-  "siteId": "site_1",
-  "source": "callback",
-  "email": "",
-  "payload": {},
-  "createdAt": "2026-09-20T14:57:31.552Z"
-}

package/templates/apps/api/.ailk/inbox/2026-09-20T14-57-33.840Z-fallback-1789916253842-b52659e9.json

@@ -1,12 +0,0 @@
-{
-  "id": "fallback-1789916253842-b52659e9",
-  "siteId": "wksp_00000000-0000-7000-8000-000000000001",
-  "source": "flow:get-a-quote",
-  "email": "abandoner@example.com",
-  "payload": {
-    "email": "abandoner@example.com",
-    "flowSlug": "get-a-quote",
-    "locale": "en"
-  },
-  "createdAt": "2026-09-20T14:57:33.840Z"
-}

package/templates/apps/api/.ailk/inbox/2026-09-20T14-57-33.844Z-fallback-1789916253845-6b266f8c.json

@@ -1,12 +0,0 @@
-{
-  "id": "fallback-1789916253845-6b266f8c",
-  "siteId": "default",
-  "source": "flow:get-a-quote",
-  "email": "abandoner@example.com",
-  "payload": {
-    "email": "abandoner@example.com",
-    "flowSlug": "get-a-quote",
-    "locale": "en"
-  },
-  "createdAt": "2026-09-20T14:57:33.844Z"
-}

package/templates/apps/web/app/[locale]/book-a-call/page.tsx

@@ -1,50 +0,0 @@
-// Book-a-call page (#6658 D5) — a BookCall at /book-a-call, reading the
-// fixed slug `book-call` (the monorepo's own content already uses it). Its
-// CTA points at /contact, or at /meet where a template carries scheduling. A
-// module-less surface a template enables by naming it in its roster; with no
-// content the route 404s. Mirrors use-cases/page.tsx: a sections-composed page
-// renders its sections, a prose-only page its MDX body.
-import type { getMdxSource as defaultGetMdxSource } from "@working-theory/page-renderer";
-import {
-  getMdxSource as loadMdxSource,
-  renderPage,
-  renderPageMetadata,
-} from "@working-theory/page-renderer";
-import type { Metadata } from "next";
-import type { ReactElement } from "react";
-
-interface Props {
-  params: Promise<{ locale: string }>;
-  getMdxSource?: typeof defaultGetMdxSource;
-}
-
-export async function generateMetadata({
-  params,
-}: Pick<Props, "params">): Promise<Metadata> {
-  const { locale } = await params;
-  return renderPageMetadata({
-    type: "BookCall",
-    slug: "book-call",
-    locale,
-  });
-}
-
-export default async function Page({
-  params,
-  getMdxSource,
-}: Props): Promise<ReactElement> {
-  const { locale } = await params;
-  const source = await (getMdxSource ?? loadMdxSource)("BookCall", "book-call", locale);
-  const composed =
-    source !== null &&
-    Array.isArray((source.frontmatter as { sections?: unknown[] }).sections) &&
-    ((source.frontmatter as { sections?: unknown[] }).sections?.length ?? 0) >
-      0;
-  return renderPage({
-    type: "BookCall",
-    slug: "book-call",
-    locale,
-    ...(composed ? {} : { bodyMode: "mdx-body" as const }),
-    ...(getMdxSource !== undefined && { getMdxSource }),
-  });
-}

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

@@ -1,72 +0,0 @@
-/**
- * HTML snapshot regression tests for use-cases/page.tsx → @working-theory/page-renderer migration.
- *
- * Two-commit strategy:
- *   Commit 1: this file added; snapshots captured against pre-migration route (RED-passing).
- *   Commit 2: route migrated; same snapshots verify diff=0 (GREEN).
- *
- * Two states tested:
- *   - 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.
- */
-import React from "react";
-import { render } from "@testing-library/react";
-
-// ── @working-theory/ui mock ─────────────────────────────────────────────────────────────
-jest.mock("@working-theory/ui", () => ({
-  // #4446/#4447: renderPage's own fallback/empty-state title now composes
-  // Heading (mobile type-budget classes, #4417) instead of a bare <h1>.
-  Heading: ({
-    children,
-    level,
-  }: {
-    children: React.ReactNode;
-    level: number;
-  }): React.ReactElement => React.createElement(`h${level}`, null, children),
-  SectionRenderer: ({ sections }: { sections: unknown[] }) =>
-    React.createElement("div", {
-      "data-testid": "section-renderer",
-      "data-section-count": String(sections.length),
-    }),
-}));
-
-import UseCasesPage from "../page";
-
-const getMdxSourceEmpty = jest.fn().mockResolvedValue(null);
-
-describe("UseCasesPage — snapshot regression", () => {
-  it("empty state renders deterministic HTML", async () => {
-    const element = await UseCasesPage({
-      params: Promise.resolve({ locale: "en" }),
-      getMdxSource: getMdxSourceEmpty,
-    });
-    const { container } = render(element);
-    expect(container.innerHTML).toMatchInlineSnapshot(
-      `"<main id="main"><h1>Use Cases</h1><p data-testid="section-empty-state">Use cases listing coming soon.</p></main>"`,
-    );
-  });
-
-  it("populated state renders deterministic HTML", async () => {
-    const source = {
-      frontmatter: {
-        type: "UseCasesList" as const,
-        slug: "use-cases",
-        title: "Use Cases",
-        description: "How teams use our platform.",
-      },
-      body: "",
-    };
-    const getMdxSourcePopulated = jest.fn().mockResolvedValue(source);
-
-    const element = await UseCasesPage({
-      params: Promise.resolve({ locale: "en" }),
-      getMdxSource: getMdxSourcePopulated,
-    });
-    const { container } = render(element);
-    expect(container.innerHTML).toMatchInlineSnapshot(
-      `"<script type="application/ld+json" data-testid="json-ld">{"@context":"https://schema.org","@type":"CollectionPage","inLanguage":"en","name":"Use Cases","description":"How teams use our platform.","mainEntity":{"@type":"ItemList","itemListElement":[{"@type":"Article"}]}}</script><main id="main"><h1>Use Cases</h1><p data-testid="use-cases-description">How teams use our platform.</p><div data-testid="markdown-view-toggle" class="ailk-markdown-view-toggle"><div class="flex justify-end mb-3"><div role="radiogroup" aria-label="Page view" data-testid="markdown-view-toggle" class="inline-flex items-center gap-0.5 rounded-lg p-1 bg-(--color-surface-secondary)"><button class="inline-flex items-center justify-center gap-2 font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 disabled:cursor-not-allowed disabled:opacity-50 [&amp;>svg]:shrink-0 text-(--color-fg) hover:bg-(--color-surface-secondary) active:bg-gray-200 rounded-control px-control-x h-(--control-height-thin) text-caption leading-none rounded-md px-3 text-body-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 min-w-(--control-height-thin) min-h-(--control-height-big) bg-(--color-bg) text-(--color-fg) shadow-sm" type="button" role="radio" aria-checked="true" aria-label="Rendered" tabindex="0" data-testid="markdown-view-toggle-rendered">Rendered</button><button class="inline-flex items-center justify-center gap-2 font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 disabled:cursor-not-allowed disabled:opacity-50 [&amp;>svg]:shrink-0 text-(--color-fg) hover:bg-(--color-surface-secondary) active:bg-gray-200 rounded-control px-control-x h-(--control-height-thin) text-caption leading-none rounded-md px-3 text-body-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-(--color-accent) focus-visible:ring-offset-1 min-w-(--control-height-thin) min-h-(--control-height-big) text-(--color-text-muted) hover:text-(--color-fg)" type="button" role="radio" aria-checked="false" aria-label="Markdown" tabindex="-1" data-testid="markdown-view-toggle-markdown">Markdown</button></div></div><div role="status" aria-live="polite" aria-atomic="true" class="sr-only" data-testid="markdown-view-toggle-status">Showing Rendered view</div><div data-testid="markdown-view-rendered"><article data-testid="mdx-body"><div data-testid="mdx-remote" data-source=""></div></article></div></div></main>"`,
-    );
-  });
-});