create-ailk 0.21.0 → 0.23.0

package/dist/seed-flows.js

@@ -49,6 +49,22 @@ export class SeedFlowsRefusedError extends Error {
         this.name = "SeedFlowsRefusedError";
     }
 }
+/** A starter placeholder string: one `{…}` brace pair and nothing else. */
+const PLACEHOLDER_STRING = /^\{[^{}]+\}$/;
+/**
+ * Whether a flow config carries the starter's placeholder copy (#8850 D6):
+ * some string value anywhere in it is a whole `{brace}` placeholder.
+ */
+function isPlaceholderFlow(config) {
+    if (typeof config === "string")
+        return PLACEHOLDER_STRING.test(config);
+    if (Array.isArray(config))
+        return config.some(isPlaceholderFlow);
+    if (config !== null && typeof config === "object") {
+        return Object.values(config).some(isPlaceholderFlow);
+    }
+    return false;
+}
 function readDeclaredFlows(flowsDir) {
     if (!existsSync(flowsDir))
         return [];
@@ -78,7 +94,12 @@ function readDeclaredFlows(flowsDir) {
         if (slug !== expected) {
             throw new SeedFlowsRefusedError(`seed-flows: flows/${file} declares slug "${slug}"; a declared flow's file is named <slug>.json. Nothing was sent.`);
         }
-        return { slug, file, config: config };
+        return {
+            slug,
+            file,
+            config: config,
+            placeholder: isPlaceholderFlow(config),
+        };
     });
 }
 // ── The hub origin ──────────────────────────────────────────────────────────
@@ -158,6 +179,7 @@ async function sendFlow(fetchImpl, origin, key, flow) {
                 ok: true,
                 result,
                 status: safeCode(envelope.data?.status),
+                ...(flow.placeholder && { placeholder: true }),
             };
         }
         return { slug: flow.slug, ok: false, failure: "200 unknown" };
@@ -175,12 +197,15 @@ function hubLine(hub) {
         : `hub: ${hub.origin} (from ${hub.source})`;
 }
 function flowLine(outcome) {
-    if (outcome.ok === "dry-run")
-        return `${outcome.slug}: would send`;
     if (outcome.ok === false)
         return `${outcome.slug}: failed — ${outcome.failure}`;
+    const placeholder = outcome.placeholder === true
+        ? ` — placeholder copy: replace every {brace} in flows/${outcome.slug}.json`
+        : "";
+    if (outcome.ok === "dry-run")
+        return `${outcome.slug}: would send${placeholder}`;
     const draft = outcome.status === "draft" ? " (status draft — not shown to visitors)" : "";
-    return `${outcome.slug}: ${outcome.result}${draft}`;
+    return `${outcome.slug}: ${outcome.result}${draft}${placeholder}`;
 }
 /** The whole report, one line per row — what `seedFlows` printed as it went. */
 export function formatSeedFlowsReport(result) {
@@ -224,6 +249,7 @@ export async function seedFlows(opts) {
         const outcomes = flows.map((flow) => ({
             slug: flow.slug,
             ok: "dry-run",
+            ...(flow.placeholder && { placeholder: true }),
         }));
         onLine(hubLine(hub));
         outcomes.forEach((outcome) => onLine(flowLine(outcome)));
@@ -282,6 +308,26 @@ The hub's operator must first turn seeding on (\`AILK_SPOKE_FLOW_SEED=true\`
 on the hub). Until it is on and this command has run, links to these flows
 (\`/flows/<slug>\`) reach no flow.
 
+## The starter's placeholder flows
+
+The \`signal-collectors\` module ships two declared flows here:
+\`flows/diagnostic.json\` (an email step, then two questions) and
+\`flows/join-waitlist.json\` (an email and an optional name). Every visible
+string in both is a \`{brace}\` placeholder: replace each one with your own
+copy. Both go live on the hub with the first seed, so each line this command
+prints for them says they still carry placeholder copy.
+
+A flow is reached at \`/flows/<slug>\`. To give one its own page pair, run:
+
+    npx create-ailk add-route magnet --path /diagnostic --flow diagnostic
+    npx create-ailk add-route magnet --path /waitlist --flow join-waitlist
+
+A job application comes with the \`careers\` surface. Contact, newsletter and
+job application are the hub's own standard magnets: the hub seeds them in
+every workspace and refuses a spoke's copy of each, so they need no file
+here. If the hub's Admin already owns a magnet under one of these two slugs,
+the hub refuses the seed (\`slug_owned\`); rename the file and its \`slug\`.
+
 ## Who owns what
 
 The next seed that differs overwrites the hub's copy of a flow's config, so

package/dist/site-chrome.d.ts

@@ -41,6 +41,10 @@ export type SiteChromeHome = "default" | "deck";
 /** The `innerPages` knob's vocabulary (#7721). `bare` → every non-home page
  *  gets the bare header and the one-bar footer. */
 export type SiteChromeInnerPages = "default" | "bare";
+/** The `deckAnchors` knob's vocabulary (#8773). `bare` → the deck home names
+ *  its slides `#<id>` instead of `#slide-<id>`, keeping the `slide-` name only
+ *  where the bare id would collide (the page renderer's `deckSlideAnchors`). */
+export type SiteChromeDeckAnchors = "prefixed" | "bare";
 /** The `colorMode` knob's vocabulary (#7742). `light` pins the site to light
  *  and removes every theme switch; dark then appears only as a deck ground. */
 export type SiteChromeColorMode = "user" | "light";
@@ -72,6 +76,8 @@ export interface TemplateLayout {
     innerPages?: SiteChromeInnerPages;
     /** #7740 D1 — `true`: the deck home presents slide by slide (a deck home only). */
     deckPresentation?: boolean;
+    /** #8773 — `bare`: a presenting deck names its slides `#<id>` (a presenting deck home only). */
+    deckAnchors?: SiteChromeDeckAnchors;
     /** #7742 D1 — `light`: the site is pinned to light, with no theme switch. */
     colorMode?: SiteChromeColorMode;
     /** #7742 D1 — `minimal`: the minimal closing slide, consent bar and themed 404. */
@@ -91,6 +97,8 @@ export interface ResolvedSiteChrome {
     innerPages?: "bare";
     /** Present only when it resolves to `true` AND `home` is `deck` (#7740 D1) — never `false`. */
     deckPresentation?: true;
+    /** Present only when it resolves to "bare" on a presenting deck home (#8773) — never "prefixed". */
+    deckAnchors?: "bare";
     /** Present only when it resolves to "light" — never "user" (#7742 D1). */
     colorMode?: "light";
     /** Present only when it resolves to "minimal" — never "default" (#7742 D1). */

package/dist/site-chrome.js

@@ -64,6 +64,7 @@ const NAV_VALUES = ["full", "mark-only"];
 const FOOTER_VALUES = ["columns", "centered"];
 const HOME_VALUES = ["default", "deck"];
 const INNER_PAGES_VALUES = ["default", "bare"];
+const DECK_ANCHORS_VALUES = ["prefixed", "bare"];
 const COLOR_MODE_VALUES = ["user", "light"];
 const CHROME_STYLE_VALUES = ["default", "minimal"];
 /**
@@ -140,6 +141,12 @@ export function validateTemplateLayout(value, subject) {
         }
         result.deckPresentation = raw.deckPresentation;
     }
+    if ("deckAnchors" in raw && raw.deckAnchors !== undefined) {
+        if (!DECK_ANCHORS_VALUES.includes(raw.deckAnchors)) {
+            throw new TemplateLayoutError(`${subject}: layout.deckAnchors must be one of ${DECK_ANCHORS_VALUES.join(", ")} — got ${JSON.stringify(raw.deckAnchors)}`);
+        }
+        result.deckAnchors = raw.deckAnchors;
+    }
     if ("colorMode" in raw && raw.colorMode !== undefined) {
         if (!COLOR_MODE_VALUES.includes(raw.colorMode)) {
             throw new TemplateLayoutError(`${subject}: layout.colorMode must be one of ${COLOR_MODE_VALUES.join(", ")} — got ${JSON.stringify(raw.colorMode)}`);
@@ -206,6 +213,11 @@ export function resolveSiteChrome(layout, designLayout) {
     if ((layout?.deckPresentation ?? fromDesign.deckPresentation) === true && resolved.home === "deck") {
         resolved.deckPresentation = true;
     }
+    // #8773 — only "bare" is ever a key, and only where the deck presents: the
+    // slide anchors it names exist only under the presentation dial.
+    if ((layout?.deckAnchors ?? fromDesign.deckAnchors) === "bare" && resolved.deckPresentation === true) {
+        resolved.deckAnchors = "bare";
+    }
     // #7742 D1 — as with `innerPages`, only the opt-in value is ever a key.
     if ((layout?.colorMode ?? fromDesign.colorMode) === "light") {
         resolved.colorMode = "light";
@@ -245,6 +257,8 @@ export function renderSiteChrome(resolved) {
     // #7740 D1 — `innerPages`' form: the member and bullet always, the value
     // line only when the chrome presents.
     const presentationValue = resolved.deckPresentation === true ? "\n  deckPresentation: true," : "";
+    // #8773 — the same form: member and bullet always, the value line only for "bare".
+    const deckAnchorsValue = resolved.deckAnchors === "bare" ? '\n  deckAnchors: "bare",' : "";
     // #7742 D1 — the same form again: member and bullet always, value lines
     // only for the opt-in values.
     const colorModeValue = resolved.colorMode === "light" ? '\n  colorMode: "light",' : "";
@@ -271,6 +285,7 @@ export function renderSiteChrome(resolved) {
 //   - innerPages: "bare" → every non-home page renders the bare header and
 //     the one-bar footer.
 //   - deckPresentation → the deck home presents slide by slide: fitted slides, slide anchors, the mark follows the ground
+//   - deckAnchors: "bare" → the presenting deck names its slides #<id> instead of #slide-<id>
 //   - colorMode: "light" → the site is pinned to light and shows no theme
 //     switch; dark appears only as a deck ground.
 //   - chromeStyle: "minimal" → the deck's closing slide is the wordmark,
@@ -286,6 +301,7 @@ export interface SiteChrome {
   home: "default" | "deck";
   innerPages?: "bare";
   deckPresentation?: true;
+  deckAnchors?: "bare";
   colorMode?: "light";
   chromeStyle?: "minimal";
   closingFooterPaths?: readonly string[];${groundsMember}
@@ -295,7 +311,7 @@ export const siteChrome: SiteChrome = {
   nav: ${JSON.stringify(resolved.nav)},
   footer: ${JSON.stringify(resolved.footer)},
   announcementBanner: ${JSON.stringify(resolved.announcementBanner)},
-  home: ${JSON.stringify(resolved.home)},${groundsValue}${innerPagesValue}${presentationValue}${colorModeValue}${chromeStyleValue}${closingFooterPathsValue}
+  home: ${JSON.stringify(resolved.home)},${groundsValue}${innerPagesValue}${presentationValue}${deckAnchorsValue}${colorModeValue}${chromeStyleValue}${closingFooterPathsValue}
 };
 `;
 }

package/dist/spoke-checkout.d.ts

@@ -2,26 +2,26 @@ import type { EnvCatalogEntry, PlanEnvRowsOptions } from "./lib/declared-env.js"
 import { type InstallReportRow } from "./lib/extract-module-bundle.js";
 import { type WorkspaceVersionMap } from "./substitute.js";
 import { type SignInMode } from "./topology.js";
-/** The checkout package a spoke's two route files import. */
+/** The checkout package a spoke's billing action and thank-you page import. */
 export declare const SPOKE_CHECKOUT_PACKAGE = "@working-theory/spoke-checkout";
-/** The site's checkout data — written once, the site's from then on. */
+/** The site's checkout stamp — written once, the site's from then on (#8748 D2). */
 export declare const SPOKE_CHECKOUT_CONFIG_PATH = "apps/web/lib/checkout-config.ts";
-/** The two return pages: Stripe's success URL and every refused buy's target. */
+/** The two return pages a commerce spoke still carries (#8748 D5). */
 export declare const SPOKE_CHECKOUT_PAGE_FILES: readonly string[];
 /**
- * The marker `renderPage()` stamps into both generated return pages' header
- * comment (D3). `apps/web`'s structured-data test cannot import create-ailk
- * (the import boundary), so it carries this text as a literal, kept in sync
- * by `packages/create-ailk/__tests__/spoke-checkout.test.ts` (#8513 AC-5).
+ * The spoke checkout's template paths, scaffold-relative (#8748 D3). A
+ * directory entry covers every file under it, so the tests that sit beside
+ * the pages travel with them. `copyTemplate` skips all of them for every
+ * scaffold; `writeSpokeCheckoutSlice` copies them into a commerce spoke.
  */
-export declare const SPOKE_CHECKOUT_PAGE_MARKER = "GENERATED by create-ailk (#7838)";
-/** The variables a commerce spoke depends on (D9). The package reads three of them. */
+export declare const SPOKE_CHECKOUT_TEMPLATE_PATHS: readonly string[];
+/** The variables a commerce spoke depends on (D9): the package reads both. */
 export declare const SPOKE_CHECKOUT_ENV_CATALOG: Readonly<Record<string, EnvCatalogEntry>>;
 /** The names a commerce spoke declares although only the package reads them (D9). */
 export declare const SPOKE_CHECKOUT_DECLARED_ENV: readonly string[];
 /**
  * The catalog (and declared names) a spoke's `appendEnvRows` call passes: a
- * commerce spoke adds the checkout's four rows (D9). `ENV_CATALOG` itself is
+ * commerce spoke adds the package's two rows (D9). `ENV_CATALOG` itself is
  * unchanged — its test fails on an entry the monorepo's apps never read.
  */
 export declare function spokeEnvRowOptions(commerce: boolean): Pick<PlanEnvRowsOptions, "catalog" | "declare">;
@@ -32,51 +32,75 @@ export declare function spokeEnvRowOptions(commerce: boolean): Pick<PlanEnvRowsO
  * `site-` and the first 8 hex characters of its SHA-256. Never `AILK_SITE_ID`.
  */
 export declare function spokeCheckoutSite(projectName: string): string;
-/** Where a commerce spoke's end-to-end checkout workflow lives. */
-export declare const SPOKE_CHECKOUT_E2E_WORKFLOW_PATH = ".github/workflows/checkout-e2e.yml";
+/** The billing action's first line, which marks the file as create-ailk's to rewrite. */
+export declare const BILLING_ACTION_MARKER = "// The spoke billing action \u2014 GENERATED by create-ailk (#8217). Do not edit:";
 /**
- * The Stripe CLI release the workflow installs, and the SHA-256 of its
- * `stripe_<v>_linux_x86_64.tar.gz` from that release's own
- * `stripe-linux-checksums.txt`. Never bump one without re-reading the other.
+ * The spoke billing action (#8217 D6): wiring only, byte-identical across
+ * sites, so every guarantee arrives by a package bump. A plain server module
+ * (C2): its two exports take no argument, and the hub's read is its only
+ * source of customer ids. It builds its config from the site's stamp and the
+ * site's own origin (#9142: no longer from `lib/checkout.ts`).
  */
-export declare const STRIPE_CLI_VERSION = "1.51.1";
-export declare const STRIPE_CLI_LINUX_X64_SHA256 = "38c8de73a8cab810a4aab8a4015cd4e3398b7b87aa42b6944d09d89ed524ac53";
-/** The Playwright the workflow installs — the monorepo's own pinned version. */
-export declare const E2E_PLAYWRIGHT_VERSION = "1.61.1";
+export declare const BILLING_ACTION: string;
 /**
- * Every action the workflow uses, pinned to the commit its `v4` tag named
- * when this was written (SEC-7839-2): `gh api repos/<action>/commits/v4`.
- */
-export declare const E2E_ACTION_PINS: Readonly<Record<string, string>>;
-/**
- * The workflow text (D8). Identical for every spoke at one create-ailk
- * version. Every `${{ … }}` sits in an env-style value, never in a script.
- */
-export declare const CHECKOUT_E2E_WORKFLOW: string;
-/**
- * The slice for `site`, in order: the two route files, the config, the two
- * pages (D3), then the checkout e2e workflow (#7839 D8), which does not
- * depend on `site`. With `signIn: "hub"` the billing action is the third
- * pair, so the first three paths are `SPOKE_CHECKOUT_ROUTE_FILES` (#8217 D8).
- * Throws `TopologyError` for an invalid stamp (SEC-7838-10).
+ * The rendered part of the slice for `site` (#8748 D3): with `signIn: "hub"`
+ * the billing action (#8217 D8), else nothing. It does not depend on `site`.
+ * The rest of the slice is template source, copied by
+ * `writeSpokeCheckoutSlice`. Throws `TopologyError` for an invalid stamp
+ * (SEC-7838-10).
  */
 export declare function renderSpokeCheckoutFiles(site: string, opts?: {
     signIn?: SignInMode | undefined;
 }): [string, string][];
 /**
- * Write the slice into `targetDir` (D3). A file that already exists is left
- * byte-for-byte and reported `skipped` — the config is the site's once
+ * Write the slice into `targetDir` (#7838 D3, #8748 D3). The standard's
+ * template files (`SPOKE_CHECKOUT_TEMPLATE_PATHS`) are copied from
+ * `templatesDir`, each rendered with `copyTemplate`'s own renderer and
+ * markers, so a recorded hash equals what `create-ailk update` renders; the
+ * config's one `const SITE` line is stamped with `site`. `onWrite` is called
+ * once per template file written, as `copyTemplate` calls it. Then come the
+ * rendered files (`renderSpokeCheckoutFiles`). A file that already exists is
+ * left byte-for-byte and reported `skipped` — the config is the site's once
  * written. With `signIn: "hub"` (#8217 D8) the slice carries the billing
  * action, and the web seam — generated, so always rewritten — becomes the
- * billing render: reported `patched` when it changed, not at all when equal. Adds the package to `apps/web/package.json` when absent, and
- * raises a plain pin older than the one it writes (#7839): the generated
- * checkout e2e workflow runs a command a `^0.2.0` pin never reaches. Any
- * other range — newer, `workspace:`, a tag — is the site's and is kept.
+ * billing render: reported `patched` when it changed, not at all when equal.
+ * Adds the package to `apps/web/package.json` when absent, and raises a plain
+ * pin older than the one it writes (#7839): the rendered billing action
+ * calls the package's current `createSpokeCheckout` shape, which an older
+ * pin does not take (#9142). Any other range — newer, `workspace:`, a tag —
+ * is the site's and is kept.
  * Every refusal (an invalid stamp, a version map without the package, a
- * missing or malformed `apps/web/package.json`) throws before the first write.
+ * missing or malformed `apps/web/package.json`, a template missing any
+ * `SPOKE_CHECKOUT_TEMPLATE_PATHS` entry, a template config without exactly
+ * one `const SITE` line, a destination to write that resolves outside
+ * `targetDir`) throws before the first write.
  */
 export declare function writeSpokeCheckoutSlice(targetDir: string, opts: {
     site: string;
+    projectName: string;
     versions: WorkspaceVersionMap;
+    templatesDir: string;
     signIn?: SignInMode | undefined;
+    onWrite?: (relPath: string, bytes: Uint8Array) => void;
 }): InstallReportRow[];
+/**
+ * Drop the checkout package from a scaffold that does not get the slice — a
+ * hub, or a spoke without `commerce` (#8748 D3). The template's
+ * `apps/web/package.json` depends on it because the monorepo's `apps/web`
+ * carries the standard. Every other key is kept in place; a site without the
+ * dependency, or without `apps/web/package.json`, is left as it is.
+ */
+export declare function dropSpokeCheckoutDependency(targetDir: string): void;
+/**
+ * What the legacy env-key checkout left in a spoke, scaffold-relative: the
+ * buy route and the Stripe webhook route (a directory entry covers the tests
+ * beside each), `lib/checkout.ts` (the fulfilment) and its test. Each was a
+ * template copy create-ailk recorded in `.ailk-template-files.json`;
+ * `create-ailk sync-routes --apply` removes the ones still byte-identical to
+ * that record.
+ */
+export declare const RETIRED_SPOKE_CHECKOUT_PATHS: readonly string[];
+/** The retired checkout e2e workflow — rendered, never recorded (#7839 D8). */
+export declare const RETIRED_CHECKOUT_E2E_WORKFLOW_PATH = ".github/workflows/checkout-e2e.yml";
+/** The workflow's first line, which marks it as create-ailk's to remove. */
+export declare const RETIRED_CHECKOUT_E2E_MARKER = "# Checkout e2e \u2014 GENERATED by create-ailk (#7839). Do not edit: it changes";