create-ailk 0.8.0 → 0.9.0

package/dist/surfaces.js

@@ -31,6 +31,7 @@
  * `MODULE_SURFACES`, and `__tests__/surface-gating.test.ts` asserts those keys
  * equal `RECOGNIZED_MODULES` so the two cannot drift.
  */
+import { createHash } from "node:crypto";
 /** Template-relative prefix every `apps/web` route directory sits under. */
 const ROUTE_ROOT = "apps/web/app/[locale]";
 /**
@@ -114,19 +115,22 @@ export const NON_ROUTE_DIRS = new Set([
  * byte-deterministic).
  */
 export const GATEABLE_SURFACES = [
+    {
+        // #6878 D9 — the comparison hub/spoke pair (`ComparisonsList` at
+        // /alternatives, `ComparisonPage` at /vs/<slug>). No `navLabelKey`: no
+        // roster names it by default, so it excludes at scaffold time exactly
+        // like any other gateable surface a roster leaves off. `add-page`
+        // installs it (D11) the first time a site adds a comparison.
+        id: "alternatives",
+        routes: [`${ROUTE_ROOT}/alternatives`, `${ROUTE_ROOT}/vs`],
+        content: ["content/<locale>/ComparisonsList", "content/<locale>/ComparisonPage"],
+    },
     {
         id: "blog",
         routes: [`${ROUTE_ROOT}/blog`],
         content: ["apps/web/content/<locale>/blog"],
         navLabelKey: "blog",
     },
-    {
-        // Module-less (#6658 D5), like `pricing`: every starter's roster names
-        // it. No `navLabelKey` — the footer links it, gated on this surface.
-        id: "book-a-call",
-        routes: [`${ROUTE_ROOT}/book-a-call`],
-        content: ["content/<locale>/BookCall"],
-    },
     {
         id: "careers",
         routes: [`${ROUTE_ROOT}/careers`],
@@ -186,6 +190,14 @@ export const GATEABLE_SURFACES = [
         routes: [`${ROUTE_ROOT}/flows`],
         content: [],
     },
+    {
+        // #6878 D3 — the persona hub, renamed from `use-cases` (route-naming
+        // convention #3450: /for/{persona} spokes under a /for hub). Every shape
+        // roster carries it now (D7), service shapes included.
+        id: "for",
+        routes: [`${ROUTE_ROOT}/for`],
+        content: ["content/<locale>/UseCasesList", "content/<locale>/UseCase"],
+    },
     {
         // Module-less (#6658 D5) — see `book-a-call`.
         id: "glossary",
@@ -303,11 +315,6 @@ export const GATEABLE_SURFACES = [
         routes: [`${ROUTE_ROOT}/testimonials`],
         content: ["content/<locale>/TestimonialsList"],
     },
-    {
-        id: "use-cases",
-        routes: [`${ROUTE_ROOT}/use-cases`],
-        content: ["content/<locale>/UseCasesList", "content/<locale>/UseCase"],
-    },
     {
         id: "whitepapers",
         routes: [`${ROUTE_ROOT}/whitepapers`],
@@ -323,6 +330,9 @@ export const RECOGNIZED_SURFACES = GATEABLE_SURFACES.map((s) => s.id);
  */
 export const SURFACE_ALIASES = {
     schedule: "meet",
+    // #6878 D3 — one-release alias for the /use-cases -> /for rename, same
+    // removal trigger as `schedule` above.
+    "use-cases": "for",
 };
 /**
  * Surface ids that became core routes (#6658 D3: `software` — the product's
@@ -507,10 +517,6 @@ export function excludedContentPaths(enabled) {
 export const ROUTE_SINCE = {
     about: "0.0.0",
     "blog/[[...slug]]": "0.0.0",
-    // #6658 — four genuinely new route directories (D4, D5), attaching at
-    // today's fixed-group version, the same "attach at today's version" rule
-    // #6084, #5977, #5678, #5479, #5371 and #5048 applied.
-    "book-a-call": "0.26.0",
     careers: "0.0.0",
     "careers/[slug]": "0.0.0",
     "case-studies": "0.0.0",
@@ -531,6 +537,10 @@ export const ROUTE_SINCE = {
     "flows/[slug]": "0.0.0",
     "flows/[slug]/results/[payload]": "0.14.0",
     "flows/[slug]/start": "0.18.0",
+    // #6658 — genuinely new route directories (D4, D5), attaching at today's
+    // fixed-group version, the same "attach at today's version" rule #6084,
+    // #5977, #5678, #5479, #5371 and #5048 applied. `book-a-call` was a third
+    // such entry, retired by #6897 D10.
     glossary: "0.26.0",
     "how-to": "0.0.0",
     "how-to/[slug]": "0.0.0",
@@ -579,8 +589,14 @@ export const ROUTE_SINCE = {
     terms: "0.22.0",
     testimonials: "0.0.0",
     "thanks/[slug]": "0.14.0",
-    "use-cases": "0.0.0",
-    "use-cases/[slug]": "0.26.0",
+    // #6878 — the persona family, renamed from `use-cases`/`use-cases/[slug]`.
+    // Attaches at today's fixed-group version, the same "attach at today's
+    // version" rule #6084, #5977, #5678, #5479, #5371 and #5048 applied.
+    for: "0.28.0",
+    "for/[slug]": "0.28.0",
+    // #6878 D9 — the comparison hub/spoke pair.
+    alternatives: "0.28.0",
+    "vs/[slug]": "0.28.0",
     whitepapers: "0.0.0",
     "whitepapers/[slug]": "0.0.0",
     // #5014 — the (authed) route GROUP: layout.tsx + sign-in-gate.tsx sit
@@ -645,6 +661,10 @@ export const ROUTE_SINCE = {
     // directory, so it attaches at today's fixed-group version, the same rule
     // #5479, #5371 and #5048 applied.
     "[slug]": "0.23.0",
+    // #6897 D2 — the Free /meet/<slug> placeholder detail route. A genuinely
+    // new route directory, so it attaches at today's fixed-group version, the
+    // same rule applied above.
+    "[slug]/[detail]": "0.28.0",
 };
 /**
  * Surface id of the registry that owns `routeDir` (ROUTE_ROOT-relative): the
@@ -680,12 +700,18 @@ export function surfaceForRouteDir(routeDir) {
  */
 export const ROUTE_DEPENDENCIES = {
     // #5963 — the (auth) group's layout renders the brand mark through
-    // `siteLogo()`, and the LOCALE layout above it branches on
-    // `isAuthPath()` to drop the marketing chrome for these five paths: without
-    // `auth-routes.ts` a synced group renders inside the Nav + Footer it exists
-    // to replace. The sign-in page no longer imports `site-brand` — the mark is
-    // the shell's since #5963 — so its own list is just the env reader.
-    "(auth)": ["apps/web/lib/site-brand.tsx", "apps/web/lib/auth-routes.ts"],
+    // `siteLogo()` — which lives in `site-logo.tsx` since #6820 and reads the
+    // raw mark + name from `site-brand.tsx`, so BOTH files travel with the
+    // group — and the LOCALE layout above it branches on `isAuthPath()` to drop
+    // the marketing chrome for these five paths: without `auth-routes.ts` a
+    // synced group renders inside the Nav + Footer it exists to replace. The
+    // sign-in page no longer imports `site-brand` — the mark is the shell's
+    // since #5963 — so its own list is just the env reader.
+    "(auth)": [
+        "apps/web/lib/site-brand.tsx",
+        "apps/web/lib/site-logo.tsx",
+        "apps/web/lib/auth-routes.ts",
+    ],
     "(auth)/sign-in": ["apps/web/lib/auth-env.ts"],
     "(auth)/sign-up": ["apps/web/lib/auth-env.ts"],
     "(auth)/forgot-password": ["apps/web/lib/auth-env.ts"],
@@ -760,6 +786,46 @@ export const ROUTE_MESSAGE_NAMESPACES = {
 };
 /** Template-relative path of the generated site-nav registry. */
 export const NAV_CONFIG_PATH = "apps/web/lib/nav-config.ts";
+/**
+ * `renderNavConfig`'s first-line stamp (#6908 D1): `// ailk:generated
+ * sha256=<64 lowercase hex>`, recognised whether it ends in `\n` or `\r\n`.
+ * `<hex>` is the SHA-256 of every byte after the stamp line's terminator,
+ * CRLF folded to LF first — the same fold-and-hash rule `claude-md.ts`
+ * `hashBody` uses for the scaffold's `CLAUDE.md` regions (#6904), given its
+ * own definition here (N1) rather than an import, since the two files hash
+ * unrelated bodies.
+ */
+const NAV_STAMP_RE = /^\/\/ ailk:generated sha256=([0-9a-f]{64})\r?\n/;
+/** SHA-256, lowercase hex, of a nav body with every CRLF folded to LF (D1, N1). */
+function hashNavBody(body) {
+    return createHash("sha256")
+        .update(body.replace(/\r\n/g, "\n"), "utf8")
+        .digest("hex");
+}
+/**
+ * Verify a rendered nav's self-hashing stamp (#6908 D1/F1–F2): `"valid"` when
+ * the first line's hash matches every byte after it, `"invalid"` when a
+ * stamp line is present but the hash fails (an edited, still-stamped nav),
+ * `"absent"` when there is no stamp line at all. A stamp that verifies proves
+ * the file unedited whatever generator wrote it — the check needs only the
+ * file, never the generator's code.
+ */
+export function readNavConfigStamp(text) {
+    const match = NAV_STAMP_RE.exec(text);
+    if (match === null)
+        return "absent";
+    const body = text.slice(match[0].length);
+    return match[1] === hashNavBody(body) ? "valid" : "invalid";
+}
+/**
+ * Every byte after a nav's stamp line, or `text` unchanged when it carries
+ * none. The one place the D1 stamp-line shape is matched outside
+ * `readNavConfigStamp` itself, so a test simulating an edit below the stamp
+ * (or a bare pre-D1 body) never re-derives `NAV_STAMP_RE`'s pattern by hand.
+ */
+export function stripNavConfigStamp(text) {
+    return text.replace(NAV_STAMP_RE, "");
+}
 /**
  * Render `apps/web/lib/nav-config.ts` for an enabled surface set.
  *
@@ -770,14 +836,19 @@ export const NAV_CONFIG_PATH = "apps/web/lib/nav-config.ts";
  * surface set for the same reason the route tree does.
  *
  * The base items are the Free marketing-site chrome (#5469 D5, the approved
- * chrome diff recorded on that card, re-pointed by #6658 D8):
- * a Product flyout in two columns (Features · Use Cases, #6721), then Blog,
- * Pricing and About. The feature and use-case links ride the `features` and
- * `use-cases` surfaces; `/blog` is always linked (the teaser or the docs-blog
- * module serves it). Pricing is gateable
- * surfaces: each item is emitted only when its surface is enabled (a template
- * roster enables it, #5469 D10), so the nav still never links a page the
- * scaffold does not carry.
+ * chrome diff recorded on that card, re-pointed by #6658 D8, then by #6878 D6):
+ * ONE flyout rule for every shape — an offering column (Features on product
+ * shapes, Services on service shapes) beside a Customers column linking the
+ * /for persona pages — then Blog, Pricing and About. `/blog` is always linked
+ * (the teaser or the docs-blog module serves it). Pricing and every other
+ * gateable surface: each item is emitted only when its surface is enabled (a
+ * template roster enables it, #5469 D10), so the nav still never links a page
+ * the scaffold does not carry. Portfolio is never a flyout link (D6): on a
+ * service shape it is a plain top-level link directly after the Services
+ * flyout, and every shape's footer Site pages column links it (#6895), both
+ * under the `portfolio` surface's gate. No empty flyout is ever emitted: with
+ * neither column non-empty, no flyout item is emitted at all (closes #6766's
+ * AC-1).
  *
  * Only gateable surfaces carrying a `navLabelKey` are linked after the base
  * items, because a nav entry needs a translated label. Emitting an entry whose
@@ -791,23 +862,20 @@ export const NAV_CONFIG_PATH = "apps/web/lib/nav-config.ts";
  * Deterministic: gateable entries follow GATEABLE_SURFACES order (alphabetical
  * by id), after the fixed base items.
  */
-export function renderNavConfig(enabled) {
+export function renderNavConfig(enabled, options) {
     const on = new Set(enabled);
     // `blog` is linked unconditionally below (operator ruling 2026-09-23), so
-    // it is excluded here; `use-cases` is the Free roster's own page (a
-    // module-less surface the roster enables, like `pricing`), linked in its
-    // fixed positions below rather than appended.
-    const linked = GATEABLE_SURFACES.filter((s) => s.navLabelKey !== undefined &&
-        on.has(s.id) &&
-        s.id !== "blog" &&
-        s.id !== "use-cases");
-    const useCases = on.has("use-cases");
+    // it is excluded here; `for` is the Customers flyout/footer column below,
+    // linked in its own fixed positions rather than appended.
+    const linked = GATEABLE_SURFACES.filter((s) => s.navLabelKey !== undefined && on.has(s.id) && s.id !== "blog");
     const features = on.has("features");
-    // #6721 (operator ruling 2026-09-25): the Product flyout is two columns —
-    // Features and Use Cases — each a heading over three label-only links. The
-    // `groups` render the desktop panel; `features` carries the same links for
-    // the mobile disclosure and the active-path match. "Use cases" left the top
-    // nav (it lives in the flyout and its own footer column).
+    const services = on.has("services");
+    const forEnabled = on.has("for");
+    const portfolio = on.has("portfolio");
+    const serviceSlugs = [...(options?.serviceSlugs ?? [])].sort().slice(0, 3);
+    // #6878 D6 (operator ruling 2026-09-27): one flyout rule for every shape.
+    // The `groups` render the desktop panel; `features` carries the same links
+    // for the mobile disclosure and the active-path match.
     const featureLinks = features
         ? [
             '        { labelKey: "feature1", path: "/features/feature-1" },',
@@ -815,11 +883,14 @@ export function renderNavConfig(enabled) {
             '        { labelKey: "feature3", path: "/features/feature-3" },',
         ]
         : [];
-    const useCaseLinks = useCases
+    const serviceLinks = !features && services
+        ? serviceSlugs.map((slug, i) => `        { labelKey: "service${i + 1}", path: "/services/${slug}" },`)
+        : [];
+    const customerLinks = forEnabled
         ? [
-            '        { labelKey: "useCase1", path: "/use-cases/persona-1" },',
-            '        { labelKey: "useCase2", path: "/use-cases/persona-2" },',
-            '        { labelKey: "useCase3", path: "/use-cases/persona-3" },',
+            '        { labelKey: "customer1", path: "/for/persona-1" },',
+            '        { labelKey: "customer2", path: "/for/persona-2" },',
+            '        { labelKey: "customer3", path: "/for/persona-3" },',
         ]
         : [];
     const indent = (line) => `    ${line}`;
@@ -833,24 +904,56 @@ export function renderNavConfig(enabled) {
             "          ],",
             "        },",
         ];
+    // Offering column: Features on a product shape, Services on a service
+    // shape. `features` wins when both surfaces are somehow on at once — the
+    // Free roster never enables both.
+    const offeringLinks = features ? featureLinks : serviceLinks;
+    const offeringLabelKey = features ? "product" : "services";
+    const offeringHeadingKey = features
+        ? "flyoutFeaturesHeading"
+        : "flyoutServicesHeading";
+    const flyoutGroups = [
+        ...group(offeringHeadingKey, offeringLinks),
+        ...group("flyoutCustomersHeading", customerLinks),
+    ];
+    // #6942 — the Services flyout's action bar links the /services hub. The
+    // hub rides the `services` surface's gate: its route directory serves both
+    // /services and /services/[slug], so every roster that enables the surface
+    // carries the hub. Emitted only inside a flyout that has a column (never
+    // an action-only flyout). A flyout action requires an icon
+    // (`NavFlyoutAction`), imported below only when this link is emitted.
+    const servicesHub = !features && services && flyoutGroups.length > 0;
     const entries = [
-        "  {",
-        '    labelKey: "product",',
-        "    flyout: {",
-        // SOFT_LOCK_OK: #6508 — width "panel" (D4/D5): a fixed 640px panel.
-        '      width: "panel",',
-        "      features: [",
-        ...featureLinks,
-        ...useCaseLinks,
-        "      ],",
-        "      groups: [",
-        ...group("flyoutFeaturesHeading", featureLinks),
-        ...group("flyoutUseCasesHeading", useCaseLinks),
-        "      ],",
-        "      actions: [],",
-        "    },",
-        "  },",
-        // Operator ruling 2026-09-25: Product · Blog · Pricing · About.
+        // No empty flyout (D6): emitted only when at least one column has links.
+        ...(flyoutGroups.length === 0
+            ? []
+            : [
+                "  {",
+                `    labelKey: "${offeringLabelKey}",`,
+                "    flyout: {",
+                // SOFT_LOCK_OK: #6508 — width "panel" (D4/D5): a fixed 640px panel.
+                '      width: "panel",',
+                "      features: [",
+                ...offeringLinks,
+                ...customerLinks,
+                "      ],",
+                "      groups: [",
+                ...flyoutGroups,
+                "      ],",
+                servicesHub
+                    ? '      actions: [{ labelKey: "services", icon: ArrowRight, path: "/services" }],'
+                    : "      actions: [],",
+                "    },",
+                "  },",
+            ]),
+        // #6895 (operator decision 2026-09-27): a service shape's header reads
+        // Services ▾ · Portfolio · Blog · About — Portfolio a plain top-level
+        // link, never a flyout link (D6), and the first item when no flyout is
+        // emitted. Product shapes keep their header.
+        ...(!features && services && portfolio
+            ? ['  { labelKey: "portfolio", path: "/portfolio" },']
+            : []),
+        // Operator ruling 2026-09-25: [flyout ·] Blog · Pricing · About.
         // `/blog` is always linked — the `blog` surface serves the real route, and
         // with it off the `[slug]` route serves the overlay's module page.
         '  { labelKey: "blog", path: "/blog" },',
@@ -858,13 +961,17 @@ export function renderNavConfig(enabled) {
         '  { labelKey: "about", path: "/about" },',
         ...linked.map((s) => `  { labelKey: "${s.navLabelKey}", path: "/${s.id}" },`),
     ];
-    // The footer's column groups (operator rulings 2026-09-23 + 2026-09-25):
-    // Site pages, Features, Use Cases, Resources. Pricing rides the same
-    // `pricing` gate as the header item; `/blog` is always linked (above). The
-    // Features column links the three feature pages and the /features hub; the
-    // Use Cases column the three use cases and the /use-cases hub — each rides
-    // its surface's gate. Book a call, Glossary and Newsletter (#6658 D8) each
-    // ride their own surface's gate.
+    // The footer's column groups (operator rulings 2026-09-23 + 2026-09-25,
+    // #6878 D6). Site pages, Features, Customers, Resources. Pricing rides the
+    // same `pricing` gate as the header item; `/blog` is always linked (above).
+    // The Features column links the three feature pages and the /features hub;
+    // the Customers column the three personas and the /for hub — each rides its
+    // surface's gate. Glossary and Newsletter (#6658 D8) each ride their own
+    // surface's gate. Book a call is always linked (#6897 D9), the same /blog
+    // precedent above: it retargets to /meet/book-a-call, served as a Free
+    // placeholder or the live scheduling page depending on what the site
+    // carries. No other footer column changes (D6) — there is deliberately no
+    // footer Services column.
     const footerEntries = [
         "  {",
         '    headingKey: "footerSitePagesHeading",',
@@ -873,11 +980,13 @@ export function renderNavConfig(enabled) {
         ...(on.has("pricing")
             ? ['      { labelKey: "pricing", path: "/pricing" },']
             : []),
+        // #6895 — every shape's Site pages column links Portfolio, gated.
+        ...(portfolio
+            ? ['      { labelKey: "portfolio", path: "/portfolio" },']
+            : []),
         '      { labelKey: "about", path: "/about" },',
         '      { labelKey: "contact", path: "/contact" },',
-        ...(on.has("book-a-call")
-            ? ['      { labelKey: "bookACall", path: "/book-a-call" },']
-            : []),
+        '      { labelKey: "bookACall", path: "/meet/book-a-call" },',
         "    ],",
         "  },",
         ...(features
@@ -891,13 +1000,13 @@ export function renderNavConfig(enabled) {
                 "  },",
             ]
             : []),
-        ...(useCases
+        ...(forEnabled
             ? [
                 "  {",
-                '    headingKey: "footerUseCasesHeading",',
+                '    headingKey: "footerCustomersHeading",',
                 "    items: [",
-                ...useCaseLinks.map((l) => l.slice(2)),
-                '      { labelKey: "allUseCases", path: "/use-cases" },',
+                ...customerLinks.map((l) => l.slice(2)),
+                '      { labelKey: "allCustomers", path: "/for" },',
                 "    ],",
                 "  },",
             ]
@@ -927,18 +1036,23 @@ export function renderNavConfig(enabled) {
         "from ",
         '"@working-theory/ui";',
     ].join("");
-    return `// nav-config.ts — site-nav registry.
+    const body = `// nav-config.ts — site-nav registry.
 //
 // GENERATED by create-ailk from the declared route surfaces. Every entry here
 // points at a route this site actually carries — the nav is regenerated with
 // the surface set so it can never link a page that was not scaffolded.
 //
+// The first line hashes the rest of this file: while it matches, \`create-ailk
+// add-module\` regenerates this nav when a module adds pages; once you edit
+// below it, the nav is yours and add-module reports the change it wanted
+// instead.
+//
 // Adding a link: scaffold the page (the \`add-page\` skill), then add an
 // entry below with a \`labelKey\` that exists in the \`nav\` namespace of
 // \`apps/web/messages/<locale>.json\`. Paths are locale-agnostic — Nav prefixes
 // them with the active locale at render.
 ${navItemImport}
-
+${servicesHub ? 'import { ArrowRight } from "lucide-react";\n' : ""}
 export const navItems: NavItem[] = [
 ${entries.join("\n")}
 ];
@@ -954,4 +1068,7 @@ export const footerColumns: FooterColumnConfig[] = [
 ${footerEntries.join("\n")}
 ];
 `;
+    // D1 — a first-line stamp holding the SHA-256 of the rest of the file
+    // (`body`), so an unedited nav proves itself whatever generator wrote it.
+    return `// ailk:generated sha256=${hashNavBody(body)}\n${body}`;
 }

package/dist/template-manifest.d.ts

@@ -31,21 +31,14 @@ export declare const STARTER_SHAPES: readonly ["organization-product", "organiza
 export type StarterShape = (typeof STARTER_SHAPES)[number];
 /**
  * The closed **design** enum (same contract section) — the look applied to
- * any shape; orthogonal to it by construction.
+ * any shape; orthogonal to it by construction. Each name RESOLVES to a
+ * package at `site-templates/designs/<name>/` (#6813 D2/D3, D11 pins this set
+ * equal to that directory listing): `resolveDesign` (`design-scaffold.ts`)
+ * reads the package's own `layout`, `colors` and treatments — no design fact
+ * lives in this module, or anywhere in `packages/create-ailk/src`, any more.
  */
 export declare const STARTER_DESIGNS: readonly ["standard", "minimalism"];
 export type StarterDesign = (typeof STARTER_DESIGNS)[number];
-/**
- * Each design's layout knobs (#6638) — the part of a design that is chrome,
- * so a template names `design:` instead of re-typing a `layout` block, and any
- * shape can wear any design. `resolveSiteChrome(layout, design)` reads it:
- * an explicit `TemplateManifest.layout` wins field by field, then this, then
- * `DEFAULT_SITE_CHROME`. `standard` declares nothing — it IS the defaults, so
- * spelling them out here would be a second copy of them to drift. A plain
- * object, not a file: this module touches no disk. The design's documented
- * look lives in `site-templates/designs/<design>/DESIGN.md`.
- */
-export declare const DESIGN_LAYOUTS: Readonly<Record<StarterDesign, TemplateLayout>>;
 /**
  * One site template: its fixed module list and the page rows it brings itself.
  *
@@ -182,9 +175,33 @@ export declare const SHAPE_STARTERS: Readonly<Partial<Record<BuildableShape, Tem
  * Where a starter's files live under `site-templates/` (#6757 D5) — the one
  * place that says so. A `SHAPE_STARTERS` key (a bare-shape starter with no
  * `--template` alias) lives at `shapes/<name>`, out of the template showcase
- * (§ 1.6); every other name (a declared `--template` alias) is unchanged.
+ * (§ 1.6). A declared `--template` alias whose `ownTree` is `false` (spec
+ * 6892 D1) ships no directory of its own: its seed layer is its shape's tree.
+ * Every other name (a declared alias with its own tree) is unchanged.
  */
 export declare function templateTreeDir(name: string): string;
+/**
+ * Whether `name` ships its own `site-templates/<name>/` directory (spec 6892
+ * D1) — `false` only for a declared `--template` alias whose `ownTree` is
+ * `false` (`minimalism-site` today). A `SHAPE_STARTERS` key owns its
+ * `shapes/<name>` tree outright, so it is never treeless by this predicate
+ * even though `templateTreeDir` also renames its directory.
+ *
+ * The one place a caller outside this module (or `template-names.ts`) asks
+ * "does this name have its own tree" without needing `ALIASES` itself —
+ * `starter-grid.ts`'s own header restricts its importers to this file and
+ * `template-names.ts`, so a producer script asking this question goes
+ * through this predicate rather than importing `ALIASES` directly.
+ */
+export declare function isOwnTree(name: string): boolean;
+/**
+ * Where a starter's GENERATED roster record lives (spec 6892 D1) — the
+ * companion to {@link templateTreeDir}. A treeless alias (`ownTree: false`)
+ * has no directory of its own to hold one, so its record lives under
+ * `site-templates/aliases/` instead, keyed by its name; every other name's
+ * record lives beside its tree, as it always has.
+ */
+export declare function shippedManifestPath(name: string): string;
 /**
  * Look up a declared template — the one exported function that yields a
  * template's roster (#6753 AC-1); `TEMPLATE_MANIFESTS`, the frozen record it

package/dist/template-manifest.js

@@ -19,28 +19,13 @@ export const STARTER_SHAPES = [
 ];
 /**
  * The closed **design** enum (same contract section) — the look applied to
- * any shape; orthogonal to it by construction.
+ * any shape; orthogonal to it by construction. Each name RESOLVES to a
+ * package at `site-templates/designs/<name>/` (#6813 D2/D3, D11 pins this set
+ * equal to that directory listing): `resolveDesign` (`design-scaffold.ts`)
+ * reads the package's own `layout`, `colors` and treatments — no design fact
+ * lives in this module, or anywhere in `packages/create-ailk/src`, any more.
  */
 export const STARTER_DESIGNS = ["standard", "minimalism"];
-/**
- * Each design's layout knobs (#6638) — the part of a design that is chrome,
- * so a template names `design:` instead of re-typing a `layout` block, and any
- * shape can wear any design. `resolveSiteChrome(layout, design)` reads it:
- * an explicit `TemplateManifest.layout` wins field by field, then this, then
- * `DEFAULT_SITE_CHROME`. `standard` declares nothing — it IS the defaults, so
- * spelling them out here would be a second copy of them to drift. A plain
- * object, not a file: this module touches no disk. The design's documented
- * look lives in `site-templates/designs/<design>/DESIGN.md`.
- */
-export const DESIGN_LAYOUTS = {
-    standard: {},
-    minimalism: {
-        nav: "mark-only",
-        footer: "centered",
-        announcementBanner: false,
-        home: "deck",
-    },
-};
 /**
  * The base layer's directory under `site-templates/` (#5618 D1) — the seed
  * files every template reaches by declaring `extends`, installed by
@@ -176,12 +161,52 @@ export const SHAPE_STARTERS = Object.freeze(Object.fromEntries(Object.entries(SH
  * Where a starter's files live under `site-templates/` (#6757 D5) — the one
  * place that says so. A `SHAPE_STARTERS` key (a bare-shape starter with no
  * `--template` alias) lives at `shapes/<name>`, out of the template showcase
- * (§ 1.6); every other name (a declared `--template` alias) is unchanged.
+ * (§ 1.6). A declared `--template` alias whose `ownTree` is `false` (spec
+ * 6892 D1) ships no directory of its own: its seed layer is its shape's tree.
+ * Every other name (a declared alias with its own tree) is unchanged.
  */
 export function templateTreeDir(name) {
-    return Object.prototype.hasOwnProperty.call(SHAPE_STARTERS, name)
-        ? `shapes/${name}`
-        : name;
+    if (Object.prototype.hasOwnProperty.call(SHAPE_STARTERS, name)) {
+        return `shapes/${name}`;
+    }
+    const alias = ALIASES[name];
+    if (alias?.ownTree === false) {
+        return `shapes/${alias.shape}`;
+    }
+    return name;
+}
+/**
+ * Whether `name` ships its own `site-templates/<name>/` directory (spec 6892
+ * D1) — `false` only for a declared `--template` alias whose `ownTree` is
+ * `false` (`minimalism-site` today). A `SHAPE_STARTERS` key owns its
+ * `shapes/<name>` tree outright, so it is never treeless by this predicate
+ * even though `templateTreeDir` also renames its directory.
+ *
+ * The one place a caller outside this module (or `template-names.ts`) asks
+ * "does this name have its own tree" without needing `ALIASES` itself —
+ * `starter-grid.ts`'s own header restricts its importers to this file and
+ * `template-names.ts`, so a producer script asking this question goes
+ * through this predicate rather than importing `ALIASES` directly.
+ */
+export function isOwnTree(name) {
+    if (Object.prototype.hasOwnProperty.call(SHAPE_STARTERS, name))
+        return true;
+    const alias = ALIASES[name];
+    return alias?.ownTree !== false;
+}
+/**
+ * Where a starter's GENERATED roster record lives (spec 6892 D1) — the
+ * companion to {@link templateTreeDir}. A treeless alias (`ownTree: false`)
+ * has no directory of its own to hold one, so its record lives under
+ * `site-templates/aliases/` instead, keyed by its name; every other name's
+ * record lives beside its tree, as it always has.
+ */
+export function shippedManifestPath(name) {
+    const alias = ALIASES[name];
+    if (alias?.ownTree === false) {
+        return `aliases/${name}.TEMPLATE-MANIFEST.json`;
+    }
+    return `${templateTreeDir(name)}/TEMPLATE-MANIFEST.json`;
 }
 /**
  * Look up a declared template — the one exported function that yields a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ailk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Scaffolder for AI Launch Kit — `pnpm create ailk@latest <dir>` produces a starter repo consuming @working-theory/* from npm (per ADR 0007).",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,8 +25,8 @@
     "tar": "^7.5.21"
   },
   "devDependencies": {
-    "@working-theory/templates": "0.28.0",
-    "@working-theory/schema": "0.28.0"
+    "@working-theory/schema": "0.29.0",
+    "@working-theory/templates": "0.29.0"
   },
   "repository": {
     "type": "git",
@@ -58,7 +58,8 @@
     "build-catalog": "node scripts/build-component-catalog.mjs",
     "check-catalog": "node scripts/build-component-catalog.mjs --check",
     "manifest:build": "node scripts/build-template-manifest.mjs --template marketing-site-free",
-    "manifest:check": "node scripts/build-template-manifest.mjs --template marketing-site-free --check && node scripts/build-template-manifest.mjs --template marketing-site --check",
+    "manifest:check": "node scripts/build-template-manifest.mjs --template marketing-site-free --check && node scripts/build-template-manifest.mjs --template marketing-site --check && node scripts/build-template-manifest.mjs --template minimalism-site --check",
+    "design:gen": "tsc -b && node scripts/build-design-md.mjs",
     "page-types:build": "tsx scripts/generate-page-types-reference.ts",
     "page-types:check": "tsx scripts/generate-page-types-reference.ts --check"
   }