create-ailk 0.27.0 → 0.28.1

package/dist/template-pages.js

@@ -0,0 +1,129 @@
+/**
+ * The templates route family's generated seeds (#10051 D10) — the /templates
+ * hub seed plus one placeholder TemplatePage per AILK template, derived from
+ * `TEMPLATE_MANIFESTS` so a new template never needs a hand-written seed.
+ * `add-route templates` writes them (`GENERATED_SEEDS` in `add-route.ts`);
+ * the site then edits or deletes them like any content.
+ *
+ * A seed never invents a fact: its copy is placeholder (`placeholder: true`,
+ * renderPage's replace-before-launch label), it has no thumbnail, and its Get
+ * it action is `/contact`. Only a template whose `templateDelivery` is
+ * `"free"` gets `price: 0` — a paid template's price is the site's to set.
+ *
+ * Pure (no fs). create-ailk has no YAML dependency by design, so every
+ * frontmatter value is written as `JSON.stringify(value)` — a JSON scalar,
+ * array or object is valid YAML flow syntax (the `derive-architecture.ts`
+ * precedent).
+ */
+import { RECOGNIZED_MODULES } from "./parse-args.js";
+import { TEMPLATE_MANIFESTS, templateDelivery, } from "./template-manifest.js";
+/** What every template carries whatever its modules: the base site. */
+export const BASE_INCLUDE = {
+    title: "The base site",
+    description: "Your pages with structured data on every one, plus an API and an MCP server agents can read.",
+};
+/** One row per module, typed exhaustively so a new module fails type-check. */
+export const MODULE_INCLUDES = {
+    marketing: {
+        title: "Marketing pages",
+        description: "The pages a marketing site needs, with lead capture.",
+    },
+    "docs-blog": {
+        title: "Docs and blog",
+        description: "A documentation section and a blog, written as content files.",
+    },
+    "multi-tenant": {
+        title: "Organizations and workspaces",
+        description: "Many customers on one deployment, each with their own members.",
+    },
+    workspace: {
+        title: "Admin",
+        description: "Your own signed-in area to edit pages, manage assets and review submissions.",
+    },
+    scheduling: {
+        title: "Scheduling",
+        description: "Booking pages visitors use to schedule time with you.",
+    },
+    "signal-collectors": {
+        title: "Quizzes and reports",
+        description: "Assessments and downloadable reports that capture interested visitors.",
+    },
+    commerce: {
+        title: "Checkout",
+        description: "Take payment through your own Stripe account.",
+    },
+};
+const HUB_SEED_PATH = "content/en/TemplatesList/templates.mdx";
+/** Words a naive capitalisation would mis-case in a template name. */
+const WORD_CASING = { saas: "SaaS" };
+/** `marketing-site-free` → `Marketing Site Free`; `saas-product` → `SaaS Product`. */
+function titleCase(name) {
+    return name
+        .split("-")
+        .map((word) => WORD_CASING[word] ?? word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}
+/** A seed file: a JSON-valued YAML frontmatter block and a placeholder body. */
+function mdx(frontmatter, body) {
+    const lines = Object.entries(frontmatter).map(([key, value]) => `${key}: ${JSON.stringify(value)}`);
+    return `---\n${lines.join("\n")}\n---\n\n${body}\n`;
+}
+function templateSeed(name, manifest) {
+    const title = titleCase(name);
+    const includes = [
+        BASE_INCLUDE,
+        ...RECOGNIZED_MODULES.filter((module) => manifest.requires.includes(module)).map((module) => MODULE_INCLUDES[module]),
+    ];
+    const free = templateDelivery(manifest) === "free";
+    return {
+        path: `content/en/TemplatePage/${name}.mdx`,
+        text: mdx({
+            type: "TemplatePage",
+            slug: name,
+            title,
+            description: `Replace with a one-sentence description of the ${title} template.`,
+            summary: `Replace with what a site built on ${title} gives a customer.`,
+            placeholder: true,
+            template: name,
+            categories: [...manifest.categories],
+            includes,
+            demoUrl: `https://${name}.salessmyth.com`,
+            getItUrl: "/contact",
+            ...(free && { price: 0, priceCurrency: "USD" }),
+        }, `{/* Placeholder: /templates/${name} renders its hero and "What's included" from the frontmatter above. Replace the copy, add a thumbnail and set getItUrl to your buy link before launch. */}`),
+    };
+}
+/**
+ * The hub seed, then one TemplatePage seed per manifest, sorted by name.
+ * `manifests` defaults to the frozen registry; a test may pass its own.
+ */
+export function templatePageSeeds(manifests = TEMPLATE_MANIFESTS) {
+    const description = "Replace with a one-sentence description of the templates you sell.";
+    const hub = {
+        path: HUB_SEED_PATH,
+        text: mdx({
+            type: "TemplatesList",
+            slug: "templates",
+            title: "Templates",
+            description,
+            placeholder: true,
+            // A tight hero keeps the first cards — the hub's actions — inside
+            // the first screen (design review round 1, B1).
+            sections: [
+                {
+                    id: "templates-hero",
+                    type: "hero",
+                    data: {
+                        headline: "Templates",
+                        subheadline: description,
+                        gapBelow: "tight",
+                    },
+                },
+            ],
+        }, "{/* Placeholder: /templates lists every TemplatePage automatically. Replace the description before launch. */}"),
+    };
+    const pages = Object.keys(manifests)
+        .sort()
+        .map((name) => templateSeed(name, manifests[name]));
+    return [hub, ...pages];
+}

package/dist/template-record.d.ts

@@ -49,14 +49,23 @@ export interface TemplateRecord {
 export declare class TemplateRecordError extends Error {
     constructor(message: string);
 }
+export interface ParseTemplateRecordOptions {
+    /**
+     * Called with each traversal-safe `files` key that is not a recordable path
+     * — a path a later create-ailk stopped recording, such as a generated file
+     * (#10173) — instead of refusing the record. The row is left out of the
+     * result. An unsafe key still refuses.
+     */
+    onUnrecordable?: (key: string) => void;
+}
 /**
  * Parse `.ailk-template-files.json` text, refusing — naming the field — on:
  * JSON that does not parse; `schema !== 1`; an unknown top-level key; an
- * empty `projectName`; a `files` key that is not a recordable path; a
- * `sha256` that is not 64 lowercase hex; a `version` that is not a semver
- * string (#8522 D1).
+ * empty `projectName`; a `files` key that is not a recordable path (unless
+ * `onUnrecordable` takes it); a `sha256` that is not 64 lowercase hex; a
+ * `version` that is not a semver string (#8522 D1).
  */
-export declare function parseTemplateRecord(text: string): TemplateRecord;
+export declare function parseTemplateRecord(text: string, opts?: ParseTemplateRecordOptions): TemplateRecord;
 /** `record` as `scaffold()` and `update` write it: sorted keys, trailing newline. */
 export declare function serializeTemplateRecord(record: TemplateRecord): string;
 export interface PlanTemplateRecordOptions {

package/dist/template-record.js

@@ -128,11 +128,11 @@ function isSafeRecordKey(key) {
 /**
  * Parse `.ailk-template-files.json` text, refusing — naming the field — on:
  * JSON that does not parse; `schema !== 1`; an unknown top-level key; an
- * empty `projectName`; a `files` key that is not a recordable path; a
- * `sha256` that is not 64 lowercase hex; a `version` that is not a semver
- * string (#8522 D1).
+ * empty `projectName`; a `files` key that is not a recordable path (unless
+ * `onUnrecordable` takes it); a `sha256` that is not 64 lowercase hex; a
+ * `version` that is not a semver string (#8522 D1).
  */
-export function parseTemplateRecord(text) {
+export function parseTemplateRecord(text, opts = {}) {
     let doc;
     try {
         doc = JSON.parse(text);
@@ -167,6 +167,10 @@ export function parseTemplateRecord(text) {
             throw new TemplateRecordError(`${TEMPLATE_RECORD_PATH} "files" has an unsafe key "${key}"`);
         }
         if (!isRecordable(key)) {
+            if (opts.onUnrecordable !== undefined) {
+                opts.onUnrecordable(key);
+                continue;
+            }
             throw new TemplateRecordError(`${TEMPLATE_RECORD_PATH} "files" has a key "${key}" that is not a recordable path`);
         }
         if (typeof value !== "object" || value === null) {

package/dist/topology.d.ts

@@ -32,7 +32,8 @@ export declare const SPOKE_EXCLUDED_MODULE_PATHS: readonly string[];
  * The `(authed)` seeds of the sign-in-through-the-hub mode (#7894 D9): the
  * whole `(authed)` group goes in the default mode; in the hub mode its account
  * area, layout and gate seam stay, and only these go — the operator surfaces,
- * the Better Auth gate and the suites that mock `auth.ts` by path.
+ * the Better Auth gate, the hub's own consent page (#9966 D2, a 404 on a
+ * spoke) and the suites that mock `auth.ts` by path.
  */
 export declare const HUB_MODE_AUTHED_SEEDS: readonly string[];
 /** The generated seam files (D5; #7874 D12). A seam is rewritten, never removed. */

package/dist/topology.js

@@ -86,11 +86,13 @@ export const SPOKE_EXCLUDED_MODULE_PATHS = [
  * The `(authed)` seeds of the sign-in-through-the-hub mode (#7894 D9): the
  * whole `(authed)` group goes in the default mode; in the hub mode its account
  * area, layout and gate seam stay, and only these go — the operator surfaces,
- * the Better Auth gate and the suites that mock `auth.ts` by path.
+ * the Better Auth gate, the hub's own consent page (#9966 D2, a 404 on a
+ * spoke) and the suites that mock `auth.ts` by path.
  */
 export const HUB_MODE_AUTHED_SEEDS = [
     "apps/web/app/[locale]/(authed)/__tests__",
     "apps/web/app/[locale]/(authed)/account/__tests__",
+    "apps/web/app/[locale]/(authed)/account/connect",
     "apps/web/app/[locale]/(authed)/admin",
     "apps/web/app/[locale]/(authed)/appointments",
     "apps/web/app/[locale]/(authed)/edit",
@@ -154,7 +156,7 @@ export function spokeRemovedRoots(opts) {
 }
 /**
  * The seeds that apply — an mcp seed is moot when `apps/mcp` itself goes; in
- * the hub sign-in mode the `(authed)` seed is replaced by eight (#7894 D9).
+ * the hub sign-in mode the `(authed)` seed is replaced by nine (#7894 D9).
  */
 function spokeSeeds(opts) {
     return modeSeeds(opts.signIn).filter((seed) => opts.mcp || !underPrefix(seed, SPOKE_MCP_ROOT));

package/dist/update.d.ts

@@ -40,16 +40,48 @@ export interface UpdateResult {
         path: string;
         reason: string;
     }>;
-    /** Per file left under review or skipped, the template tests importing it that stay at the site's version (#8704). */
+    /**
+     * Per file left under review or skipped — or a relative import the written
+     * code names that the site will not have (`missing`) — the template tests
+     * (#8704) and the other template files (`importers`, #10173) held with it
+     * — the files that import it, or, when it is a file staying at the site's
+     * version, the written files it imports — which keep the site's version so
+     * the tree never imports what it lacks.
+     */
     heldBack: Array<{
         file: string;
         tests: string[];
+        importers?: string[];
+        missing?: true;
     }>;
+    /** The `project.yaml` `env_contract` rows added for env vars the written files read (#10172). */
+    envRowsAdded?: string[];
+    /** Record rows dropped because the path is no longer recordable (#10173). */
+    droppedRows?: string[];
+    /** The mdx-body pages under `content/` given a `# ` heading this run (#7495). */
+    headingsAdded: string[];
     backfilled?: {
         version: string;
         files: number;
     };
 }
+/**
+ * The site's messages catalog with every key the template's copy has and it
+ * lacks (#10173): the site's values always win, nothing is removed, and the
+ * keys it gains follow its own. A key that is an object on one side and a
+ * value on the other is a conflict, and nothing is merged.
+ */
+export declare function mergeMessagesAdditively(ours: string, theirs: string): {
+    status: "merged";
+    text: string;
+    added: number;
+} | {
+    status: "conflict";
+    keys: string[];
+} | {
+    status: "invalid";
+    reason: string;
+};
 export declare function updateSite(opts: UpdateSiteOptions): Promise<UpdateResult>;
 /** The printed report (D9): one section per non-empty list, in order. */
 export declare function formatUpdateReport(result: UpdateResult): string;
@@ -57,6 +89,6 @@ export interface UpdateArgs {
     target: string | undefined;
     help: boolean;
 }
-export declare const UPDATE_HELP = "create-ailk update \u2014 bring template fixes into a site's copied app code.\n\nUsage:\n  create-ailk update [<target-dir>]\n\nArguments:\n  <target-dir>             The existing site. Defaults to the current dir.\n\nOptions:\n  --help, -h               Print this message.\n\nReads .ailk-template-files.json (written beside .ailk-site-manifest.json by\nevery template scaffold) to tell an untouched copy from an edit. An\nuntouched apps/web, apps/api or apps/mcp file, or a root tools/jest file the\napp jest configs require, whose template copy changed is overwritten. An\nedited file whose template copy also changed is three-way merged with\n`git` (git must be on PATH); a conflict leaves the file alone and is\nlisted under \"Needs review\". Every template test that imports a file\nleft under \"Needs review\" or \"Skipped\" (by a relative import) is held at the\nsite's version with it, its record entry is not advanced, and it is listed\nunder \"Held back with <file>\" \u2014 reconcile the file, then run update again to\nbring its tests forward. Every other file in the run still updates.\nA site with no record gets one on its first run, from the version its\n.ailk-site-manifest.json already records. A site scaffolded before\n@working-theory/mcp-server has its copied apps/mcp moved to the boot set:\nthe server and each module's paid MCP pack join apps/mcp/package.json, the\ncopied server files go, and apps/mcp/src/lib/paid-tools.generated.ts is\nrewritten on every run. A site scaffolded before @working-theory/api has its\ncopied apps/api moved to the boot file: the app becomes @working-theory/app-api,\nthe package and the six @working-theory/api-<module> packages join\napps/api/package.json, its bins and build:vercel delegate to the package, and\nthe copied server files go. Run `pnpm install` after either move, since the\napp's package.json gained dependencies. Commit before running, and review the\ndiff after.\n";
+export declare const UPDATE_HELP = "create-ailk update \u2014 bring template fixes into a site's copied app code.\n\nUsage:\n  create-ailk update [<target-dir>]\n\nArguments:\n  <target-dir>             The existing site. Defaults to the current dir.\n\nOptions:\n  --help, -h               Print this message.\n\nReads .ailk-template-files.json (written beside .ailk-site-manifest.json by\nevery template scaffold) to tell an untouched copy from an edit. An\nuntouched apps/web, apps/api or apps/mcp file, or a root tools/jest file the\napp jest configs require, whose template copy changed is overwritten. An\nedited file whose template copy also changed is three-way merged with\n`git` (git must be on PATH); a conflict leaves the file alone and is\nlisted under \"Needs review\"; an apps/web/messages catalog instead gains the\ntemplate's new keys and keeps every value it has, and is reviewed only when a\nkey is an object on one side and a value on the other. Every template file,\ntest or not, that imports a file left under \"Needs review\" or \"Skipped\" (by a\nrelative or @/ import, transitively) is held at the site's version with it,\nits record entry is not advanced, and it is listed under \"Held back with\n<file>\" \u2014 reconcile the file, then run update again to bring it forward. A\nwritten file whose import names a file the site will not have is held the\nsame way, under \"Held back with <file> (not in this site)\". Every other file\nin the run still updates. When project.yaml has an env_contract block, each\nenv var the written files read that has no row gains one; no row is edited.\nA record row at a path create-ailk no longer records is dropped and listed.\nA site with no record gets one on its first run, from the version its\n.ailk-site-manifest.json already records. A site scaffolded before\n@working-theory/mcp-server has its copied apps/mcp moved to the boot set:\nthe server and each module's paid MCP pack join apps/mcp/package.json, the\ncopied server files go, and apps/mcp/src/lib/paid-tools.generated.ts is\nrewritten on every run. A site scaffolded before @working-theory/api has its\ncopied apps/api moved to the boot file: the app becomes @working-theory/app-api,\nthe package and the six @working-theory/api-<module> packages join\napps/api/package.json, its bins and build:vercel delegate to the package, and\nthe copied server files go. Run `pnpm install` after either move, since the\napp's package.json gained dependencies. Each mdx-body page in content/ with no\n'# ' heading gets its title and description written into its body as its\nheading and intro, listed under \"Page heading added\"; a page with one heading\nis left as it is, and one with several, or one whose frontmatter it cannot\nread, is listed under \"Needs review\". Commit before running, and review the\ndiff after.\n";
 /** Parse the argv AFTER the `update` word. Strict `node:util` parseArgs, like `parseAdoptArgs`. */
 export declare function parseUpdateArgs(argv: string[]): UpdateArgs;