create-ailk 0.27.0 → 0.28.0

package/dist/lib/env-catalog.js

@@ -23,6 +23,14 @@ export const ENV_CATALOG = {
         description: "This site's public origin as the MCP server sees it: the same-origin check for audits and the purchase return URLs.",
         secret: false,
     },
+    AILK_BOOKING_BOT_CHECK: {
+        description: 'Set to "off" to turn off the booking relay\'s Vercel BotID check (#9889) — the booking alone; AILK_BOT_CHECK=off turns every check off. It runs only on Vercel; unset, empty or any other value leaves it on.',
+        secret: false,
+    },
+    AILK_BOT_CHECK: {
+        description: 'Set to "off" to turn off the site\'s Vercel BotID check on its public writes — lead, newsletter, callback, flow, checkout and booking (#9255). On by default; it runs only on Vercel.',
+        secret: false,
+    },
     AILK_CONTENT_ROOT: {
         description: "Overrides the on-disk content root (absolute, or relative to the working directory). Unset, the MCP server tries <cwd>/content, then <cwd>/../../content; the web app defaults to <repo-root>/content.",
         secret: false,
@@ -107,6 +115,10 @@ export const ENV_CATALOG = {
         description: "Better Stack heartbeat URL pinged on cron and startup; unset turns the heartbeat off.",
         secret: true,
     },
+    CONTENT_ADAPTER: {
+        description: 'Where pages are read from: unset reads the MDX files under content/; "database" reads the database. The build checks Service categories (parent:) only for MDX content.',
+        secret: false,
+    },
     CONTENT_REVALIDATE_SECRET: {
         description: "The shared secret /api/revalidate checks the API's publish webhook against; the same value as the API's.",
         secret: true,
@@ -163,6 +175,14 @@ export const ENV_CATALOG = {
         description: "The API origin the browser reads on a hub. A spoke never sets it: its hub origin is server-only (AILK_API_URL).",
         secret: false,
     },
+    NEXT_PUBLIC_AILK_DOCS_PATH: {
+        description: "The docs' public path, baked at build from content/_site.mdx's docsPath; do not set by hand.",
+        secret: false,
+    },
+    NEXT_PUBLIC_AILK_SERVICES_PATH: {
+        description: "The services' public base, baked at build from content/_site.mdx's services.path; do not set by hand.",
+        secret: false,
+    },
     NEXT_PUBLIC_AILK_LISTING_SITE_KEY: {
         description: "The site's public listing key, inlined at build; it switches the listicle directory on. Public by design.",
         secret: false,

package/dist/lib/site-modules.d.ts

@@ -0,0 +1,8 @@
+/** `.ailk-site-manifest.json`'s `modules`, or undefined when the site has no manifest or it records none. */
+export declare function readSiteManifestModules(targetDir: string): string[] | undefined;
+/**
+ * Whether the site has dropped the `marketing` module: its manifest records a
+ * module list without it. A site with no manifest, or whose manifest records
+ * no list, keeps its public tree (today's behaviour).
+ */
+export declare function publicTreeRemoved(targetDir: string): boolean;

package/dist/lib/site-modules.js

@@ -0,0 +1,34 @@
+/**
+ * The site's own module list, as `.ailk-site-manifest.json` records it
+ * (#10040 D10). The one reader `sync-routes`, `update`, the module flags and
+ * the roster check share to answer "has this site dropped the marketing
+ * module?" — never the architecture header alone, because a bare
+ * `--modules <paid>` keep run writes a header without `marketing` while its
+ * public pages are all on disk, and such a site has no manifest.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** `.ailk-site-manifest.json`'s `modules`, or undefined when the site has no manifest or it records none. */
+export function readSiteManifestModules(targetDir) {
+    const path = join(targetDir, ".ailk-site-manifest.json");
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const doc = JSON.parse(readFileSync(path, "utf8"));
+        return Array.isArray(doc.modules) && doc.modules.every((m) => typeof m === "string")
+            ? doc.modules
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Whether the site has dropped the `marketing` module: its manifest records a
+ * module list without it. A site with no manifest, or whose manifest records
+ * no list, keeps its public tree (today's behaviour).
+ */
+export function publicTreeRemoved(targetDir) {
+    const modules = readSiteManifestModules(targetDir);
+    return modules !== undefined && !modules.includes("marketing");
+}

package/dist/module-architecture.js

@@ -1362,16 +1362,15 @@ export const MODULE_SLICES = {
         // routes, named exactly as `surfaces.ts`'s ROUTE_SINCE keys name them.
         // ROWS AND SEED ONLY: unlike docs-blog and scheduling above, this module's
         // route code is deliberately NOT in `ownedFiles` (see the comment inside
-        // that array). The first two rows' code reaches a scaffold from the
-        // `templates/` snapshot, retained because the `flows` surface is enabled;
-        // the results row's code is `commerce`'s (`commerce.ownedFiles` carries
-        // `results/[payload]/page.tsx` + its two client files below, and
-        // `paidModuleTemplateExclusions` strips every paid module's owned files
-        // from the snapshot unconditionally), so that one row rides a DIFFERENT
-        // module's bundle — recorded in spec 5478 § 8 item 1, whose delivery
-        // consequence is #5481's and #5464's. Declaring the rows here changes none
-        // of it: a contribution is data, and which delivery shape carries the code
-        // is a property of the module, not of the contribution.
+        // that array). All three rows' code reaches a scaffold from the
+        // `templates/` snapshot, retained because the `flows` surface is enabled.
+        // The results row's code was `commerce`'s until #6786, so a Pro scaffold
+        // without commerce 404'd a finished recommending flow; it now ships here,
+        // and commerce's bundle adds only the checkout half
+        // (`commerce.ownedFiles`: `results/[payload]/layout.tsx` and
+        // `checkout.actions.ts`). Declaring the rows here changes none of it: a
+        // contribution is data, and which delivery shape carries the code is a
+        // property of the module, not of the contribution.
         pageContributions: [
             { route: "/flows/[slug]" },
             { route: "/flows/[slug]/start" },
@@ -1500,7 +1499,8 @@ export const MODULE_SLICES = {
         // filter (`isSpokeExcluded`), which drops every destination under
         // apps/api or database and the web files that call the hub's own
         // checkout (`SPOKE_HUB_CHECKOUT_SEEDS`: flows/[slug]/checkout.actions.ts,
-        // the flow results pages, dev/purchase — spoke-intake Rule 3). What lands
+        // the flow results directory — the results layout among it — and
+        // dev/purchase, spoke-intake Rule 3). What lands
         // is the scaffold-commerce skill, the commerce-boundary rule and the
         // @working-theory/ui-commerce dependency (`patches` below). A spoke sells
         // through its hub's Offerings buy route (#9142); its remaining checkout
@@ -1583,10 +1583,13 @@ export const MODULE_SLICES = {
             // + the slice's own re-export entry point) moved to
             // packages-paid/ui-commerce; the package is delivered to a keyed
             // scaffold via `patches` below, not via `ownedFiles`/`installMap` (D5).
+            // #6786 — the flow results page is signal-collectors' (it rides the
+            // `flows` surface's directory, see that slice); commerce owns only its
+            // checkout half: Pay's action and the results layout that provides the
+            // price card + Pay through the base tree's `checkout-seam.ts`. Without
+            // them the page renders, offering Book a Call for every fit.
             "apps/web/app/[locale]/flows/[slug]/checkout.actions.ts",
-            "apps/web/app/[locale]/flows/[slug]/results/[payload]/page.tsx",
-            "apps/web/app/[locale]/flows/[slug]/results/[payload]/ResultsClient.tsx",
-            "apps/web/app/[locale]/flows/[slug]/results/[payload]/ResultsEmailStep.tsx",
+            "apps/web/app/[locale]/flows/[slug]/results/[payload]/layout.tsx",
             "apps/web/app/[locale]/dev/purchase/page.tsx",
             "apps/web/app/[locale]/dev/purchase/error.tsx",
             "apps/web/app/[locale]/dev/purchase/purchase.actions.ts",
@@ -1823,6 +1826,11 @@ export function coOwnedModuleDestinations() {
 //     named by one file. A scaffold is not a git repository. Only those two
 //     cases moved there; `connection.test.ts` and
 //     `checkout-session-record.test.ts` keep the stores' coverage and ship.
+//   - the content hubs' `lib/__tests__/hub-children.test.tsx` (#10121) — it
+//     imports the hub page of thirteen route families across surfaces, and a
+//     scaffold carries only the families its surfaces select, so a gated
+//     scaffold would ship it with dangling imports. Its coverage of the
+//     generated child cards runs in this monorepo only.
 export const EXCLUDE_TEMPLATE_DIRS = [
     "apps/web/__tests__",
     "apps/web/app/__tests__",
@@ -1847,6 +1855,7 @@ export const EXCLUDE_TEMPLATE_DIRS = [
     "apps/mcp/__tests__/parity.test.ts",
     "apps/web/app/[locale]/pricing/__tests__/monorepo-only.test.tsx",
     "apps/web/app/[locale]/pricing/__tests__/__snapshots__/monorepo-only.test.tsx.snap",
+    "apps/web/lib/__tests__/hub-children.test.tsx",
 ];
 export function paidModuleTemplateExclusions(snapshotRoots, repoRoot) {
     const roots = new Set(snapshotRoots);

package/dist/paid-sections.d.ts

@@ -26,7 +26,24 @@ export declare function renderPaidSections(present: ReadonlySet<string>): string
  */
 export declare function renderModuleFlags(flags: {
     schedulingPages: boolean;
+    /** The `marketing` module is in the architecture header (#10040 D6). Absent → `true`. */
+    marketingPages?: boolean;
+    /** The `docs-blog` module is in the architecture header (#10040 D6). Absent → `false`. */
+    docsBlogPages?: boolean;
 }): string;
+/**
+ * The `marketing` / `docs-blog` presence the flags render (#10040 D6).
+ * `marketing` is read from the site's manifest (`lib/site-modules.ts`): a
+ * site with no manifest keeps its public tree, whatever its header says — a
+ * bare `--modules <paid>` keep run writes a header without `marketing` while
+ * every public page is on disk. `docs-blog` is read from the architecture
+ * header, which lists it on every site that carries it; an unreadable header
+ * reads as absent.
+ */
+export declare function readPublicPageFlags(targetDir: string): {
+    marketingPages: boolean;
+    docsBlogPages: boolean;
+};
 /**
  * Write the module-presence flags into a scaffold from its own
  * `apps/web/package.json` (#8843 D10) — never copied from a template, so a

package/dist/paid-sections.js

@@ -25,6 +25,8 @@
  */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { readArchitectureHeader } from "./add-module-core.js";
+import { readSiteManifestModules } from "./lib/site-modules.js";
 import { MODULE_SLICES } from "./module-architecture.js";
 import { RECOGNIZED_MODULES } from "./parse-args.js";
 /** Scaffold-relative path of the generated registry. */
@@ -119,15 +121,51 @@ const MODULE_FLAGS_HEADER = `// modules.generated.ts — which module pages this
  * tree does not carry.
  */
 export function renderModuleFlags(flags) {
+    const marketingPages = flags.marketingPages ?? true;
+    const docsBlogPages = flags.docsBlogPages ?? false;
     const lines = [];
+    // The line-1 marker stays keyed on the scheduling pages alone (#10040 D6).
     if (flags.schedulingPages)
         lines.push("// oss: false");
     lines.push(MODULE_FLAGS_HEADER.trimEnd());
     lines.push("");
     lines.push("/** The scheduling module's booking pages (/meet, /private) exist. */");
     lines.push(`export const SCHEDULING_PAGES: boolean = ${String(flags.schedulingPages)};`);
+    lines.push("");
+    lines.push("/** The marketing module's public pages exist (#10040): false on a hub. */");
+    lines.push(`export const MARKETING_PAGES: boolean = ${String(marketingPages)};`);
+    lines.push("");
+    lines.push("/** The docs-blog module's /docs and /blog pages exist (#10040). */");
+    lines.push(`export const DOCS_BLOG_PAGES: boolean = ${String(docsBlogPages)};`);
+    lines.push("");
+    lines.push("/** Any public page exists: robots, sitemap, llms.txt and the noindex header read this (#10040 D6/D7). */");
+    lines.push(`export const PUBLIC_PAGES: boolean = ${String(marketingPages || docsBlogPages)};`);
     return `${lines.join("\n")}\n`;
 }
+/**
+ * The `marketing` / `docs-blog` presence the flags render (#10040 D6).
+ * `marketing` is read from the site's manifest (`lib/site-modules.ts`): a
+ * site with no manifest keeps its public tree, whatever its header says — a
+ * bare `--modules <paid>` keep run writes a header without `marketing` while
+ * every public page is on disk. `docs-blog` is read from the architecture
+ * header, which lists it on every site that carries it; an unreadable header
+ * reads as absent.
+ */
+export function readPublicPageFlags(targetDir) {
+    const siteModules = readSiteManifestModules(targetDir);
+    const marketingPages = siteModules === undefined || siteModules.includes("marketing");
+    const archPath = join(targetDir, "architecture.yaml");
+    let docsBlogPages = false;
+    if (existsSync(archPath)) {
+        try {
+            docsBlogPages = readArchitectureHeader(readFileSync(archPath, "utf8")).modules.includes("docs-blog");
+        }
+        catch {
+            docsBlogPages = false;
+        }
+    }
+    return { marketingPages, docsBlogPages };
+}
 /** The web app's `dependencies`, or `undefined` for a scaffold with no web app. */
 function webDependencies(targetDir, writing) {
     const pkgPath = join(targetDir, "apps/web/package.json");
@@ -158,6 +196,7 @@ export function writeModuleFlags(targetDir) {
     const before = existsSync(path) ? readFileSync(path, "utf8") : undefined;
     const next = renderModuleFlags({
         schedulingPages: Object.hasOwn(deps, SCHEDULING_PAGES_PACKAGE),
+        ...readPublicPageFlags(targetDir),
     });
     if (before === next)
         return "unchanged";

package/dist/programmatic.d.ts

@@ -19,6 +19,7 @@ import { type AddModuleResult } from "./add-module.js";
 import { type SyncClaudeMdResult } from "./claude-md.js";
 import { CATALOG_TARGET_PATH } from "./component-catalog.js";
 import { type ModuleName } from "./parse-args.js";
+import { type RemoveModuleResult } from "./remove-module.js";
 import { type TemplateLayout } from "./site-chrome.js";
 import { type SyncRoutesResult } from "./sync-routes.js";
 import { type StarterShape } from "./template-manifest.js";
@@ -367,6 +368,21 @@ export interface AddModuleOptions {
  *   4. the fetched bundle is merged under the plus-config policy.
  */
 export declare function addModule(opts: AddModuleOptions): Promise<AddModuleResult>;
+export interface RemoveModuleCliOptions {
+    /** The already-scaffolded site (absolute or relative). */
+    targetDir: string;
+    /** The module to remove (validated upstream by `parseRemoveModuleArgs`). */
+    moduleName: ModuleName;
+    /** Delete the site's own edits in the removal set too. */
+    force?: boolean;
+}
+/**
+ * Take a module's public pages off an already-scaffolded site in place
+ * (`create-ailk remove-module`, #10040) — the thin package-rooted wrapper
+ * around `remove-module.ts`'s `removeModuleFromScaffold`, the `addModule`
+ * split. Every refusal is the core's and throws before the first write.
+ */
+export declare function removeModule(opts: RemoveModuleCliOptions): RemoveModuleResult;
 /** Re-exported so the CLI can name the file it wrote without duplicating it. */
 export { CATALOG_TARGET_PATH };
 /**

package/dist/programmatic.js

@@ -39,6 +39,7 @@ import { classifyModules, isAddition } from "./lib/module-tier.js";
 import { normalizeModules } from "./module-architecture.js";
 import { writePaidSections } from "./paid-sections.js";
 import { RECOGNIZED_SHAPES, RESERVED_SHAPES, } from "./parse-args.js";
+import { RemoveModuleRefusedError, removeModuleFromScaffold, } from "./remove-module.js";
 import { writeSpokeFlowsReadme } from "./seed-flows.js";
 import { SITE_CHROME_PATH, renderSiteChrome, resolveSiteChrome, } from "./site-chrome.js";
 import { SITE_FONTS_PATH, renderSiteFonts } from "./site-fonts.js";
@@ -47,7 +48,7 @@ import { SITE_ROSTER_PATH, planHomeRecord, planSiteManifestDesign, readSiteRoste
 import { SPOKE_CHECKOUT_TEMPLATE_PATHS, dropSpokeCheckoutDependency, spokeCheckoutSite, spokeEnvRowOptions, writeSpokeCheckoutSlice, } from "./spoke-checkout.js";
 import { GATEABLE_SURFACES, MODULE_SURFACES, NAV_CONFIG_PATH, excludedRoutePaths, isUnservedSurfaceContent, renderNavConfig, resolveSurfaces, } from "./surfaces.js";
 import { syncRoutes } from "./sync-routes.js";
-import { BASE_LAYER_DIR, SHAPE_STARTERS, TEMPLATE_MANIFESTS, TemplateError, mergeRoster, resolveTemplate, resolveTemplateLineage, rosterDeclares, templateDelivery, templateTreeDir, } from "./template-manifest.js";
+import { BASE_LAYER_DIR, SHAPE_STARTERS, isOwnTree, shippedManifestPath, TEMPLATE_MANIFESTS, TemplateError, mergeRoster, resolveTemplate, resolveTemplateLineage, rosterDeclares, templateDelivery, templateTreeDir, } from "./template-manifest.js";
 import { TEMPLATE_RECORD_PATH, isRecordable, planTemplateRecord, serializeTemplateRecord, sha256Hex, } from "./template-record.js";
 import { SPOKE_ONLY_FILES, TopologyError, applySpokeTransforms, isSpokeExcluded, normalizeHubSignInUrl, normalizeHubUrl, readSiteTopology, spokeExclusions, spokeDestination, spokeModuleRefusal, spokeModules, writeHubOriginEnv, writeHubSignInEnv, } from "./topology.js";
 import { validateTarget } from "./validate.js";
@@ -134,7 +135,9 @@ function resolveShapeTemplate(shape) {
         ...Object.values(TEMPLATE_MANIFESTS),
         ...Object.values(SHAPE_STARTERS),
     ].filter((manifest) => manifest.shape === shape);
-    const free = ofShape.filter((manifest) => templateDelivery(manifest) === "free");
+    // #10040 D8 — a shape's Free starter is its public site: an alias with no
+    // `marketing` in `requires` (the hub starter) is never a shape's starter.
+    const free = ofShape.filter((manifest) => templateDelivery(manifest) === "free" && manifest.requires.includes("marketing"));
     if (free.length === 0) {
         const names = ofShape.map((manifest) => manifest.name).join(", ");
         throw new TemplateError(`shape "${shape}" has no Free starter yet — its page list lands with #6743. Templates built on this shape: ${names || "none"}.`);
@@ -373,9 +376,12 @@ export async function scaffold(opts) {
     if (opts.template !== undefined) {
         // Alias run — untouched (NFR-4): the union line and its
         // resolvePaidModules({ …, templateName }) call stay exactly as they were.
+        // #10040 D8 — the template's `requires` is unioned in, so the only
+        // alias a `["marketing"]` default changed was one that deliberately
+        // lacks it (the hub starter); every existing alias lists `marketing`.
         modules = normalizeModules([
             ...(template?.requires ?? []),
-            ...(opts.modules ?? ["marketing"]),
+            ...(opts.modules ?? []),
         ]);
         const { paid } = classifyModules(modules);
         bundles = await resolvePaidModules({
@@ -656,7 +662,11 @@ export async function scaffold(opts) {
                     sourceRoot,
                     targetDir: result.targetDir,
                     name: template.name,
-                    templateRequires: template.requires,
+                    // #10040 D8 — a treeless alias installs its SHAPE's tree, whose
+                    // ailk-template.json declares the shape starter's requires.
+                    templateRequires: isOwnTree(template.name)
+                        ? template.requires
+                        : (SHAPE_STARTERS[template.shape]?.requires ?? template.requires),
                     templateExtends: template.extends,
                     versions,
                     markers,
@@ -698,6 +708,13 @@ export async function scaffold(opts) {
         // #6939 — the scaffold's DESIGN.md is the design it wears, not the one
         // its template layer shipped; the site's own header lines are kept.
         writeFileSync(join(result.targetDir, "DESIGN.md"), planDesignMd(resolvedDesign.dir, result.targetDir));
+        // #10040 D8 — a treeless alias (`ownTree: false`) ships no DESIGN.md of
+        // its own, so the kept line would still name the overlay's `_base`;
+        // the scaffold's provenance is the alias.
+        if (template !== undefined && !isOwnTree(template.name)) {
+            const designPath = join(result.targetDir, "DESIGN.md");
+            writeFileSync(designPath, readFileSync(designPath, "utf8").replace(/^([ \t]*)Source template:.*$/m, (_m, indent) => `${indent}Source template: ${template.name}`));
+        }
         // #7720 D4.1 — the faces the design sources, beside site-chrome.ts. A
         // design that sources none renders the overlay's committed default, so
         // the file is left as the template tree wrote it.
@@ -828,6 +845,11 @@ export async function scaffold(opts) {
     // plain alias or `--modules`-keep run, and is never inferred from `modules`.
     // A scaffold with no manifest (the bare overlay, `saas-product`) writes none.
     if (template !== undefined) {
+        // #10040 D8 — a treeless alias installed its SHAPE's tree, whose record
+        // names the shape; the site's roster of record is the alias's own.
+        if (!isOwnTree(template.name)) {
+            writeFileSync(join(result.targetDir, SITE_ROSTER_PATH), readFileSync(join(SITE_TEMPLATES_DIR, shippedManifestPath(template.name)), "utf8"));
+        }
         const roster = readSiteRoster(result.targetDir);
         if (roster !== undefined) {
             writeFileSync(join(result.targetDir, roster.path), planSiteManifest({
@@ -858,6 +880,23 @@ export async function scaffold(opts) {
     // #7536 D3 — the registry follows `apps/web/package.json`, which a module
     // bundle's `patches` (and the template layer) just finished editing.
     writePaidSections(result.targetDir);
+    // #10040 D8 — a template whose resolved module set lacks `marketing` (the
+    // hub starter) is the same scaffold with the public tree removed: one code
+    // path, the command's. Runs after the record and the manifest are written,
+    // so the removed paths retire exactly as they would on a live site.
+    if (template !== undefined && !modules.includes("marketing")) {
+        removeModuleFromScaffold({
+            targetDir: result.targetDir,
+            moduleName: "marketing",
+            force: true,
+            fromScaffold: true,
+            templatesDir: TEMPLATES_DIR,
+            siteTemplatesDir: SITE_TEMPLATES_DIR,
+            versions,
+            markers,
+            version: markers["CREATE_AILK_VERSION"] ?? "",
+        });
+    }
     // #7874 D9 — a spoke's rows again, now the module bundles and the template
     // layer are in the scan; it appends only what those layers added. A
     // commerce spoke also declares what the checkout package reads (#7838 D9).
@@ -1234,6 +1273,36 @@ export async function addModule(opts) {
         siteTemplatesDir: SITE_TEMPLATES_DIR,
     });
 }
+/**
+ * Take a module's public pages off an already-scaffolded site in place
+ * (`create-ailk remove-module`, #10040) — the thin package-rooted wrapper
+ * around `remove-module.ts`'s `removeModuleFromScaffold`, the `addModule`
+ * split. Every refusal is the core's and throws before the first write.
+ */
+export function removeModule(opts) {
+    const targetAbs = resolve(opts.targetDir);
+    if (!existsSync(targetAbs)) {
+        throw new Error(`remove-module target does not exist: ${targetAbs}. Point remove-module at an already-scaffolded repo.`);
+    }
+    if (!statSync(targetAbs).isDirectory()) {
+        throw new Error(`remove-module target is not a directory: ${targetAbs}`);
+    }
+    const markers = buildScaffoldMarkers(basename(targetAbs));
+    const version = markers["CREATE_AILK_VERSION"];
+    if (version === undefined || version === "") {
+        throw new RemoveModuleRefusedError("CREATE_AILK_VERSION is unset: a retired record row needs the running version.");
+    }
+    return removeModuleFromScaffold({
+        targetDir: targetAbs,
+        moduleName: opts.moduleName,
+        ...(opts.force !== undefined ? { force: opts.force } : {}),
+        templatesDir: TEMPLATES_DIR,
+        siteTemplatesDir: SITE_TEMPLATES_DIR,
+        versions: readVersionMap(),
+        markers,
+        version,
+    });
+}
 /** Re-exported so the CLI can name the file it wrote without duplicating it. */
 export { CATALOG_TARGET_PATH };
 /**

package/dist/remove-module.d.ts

@@ -0,0 +1,98 @@
+import type { InstallReportRow } from "./lib/extract-module-bundle.js";
+import { type ModuleName } from "./parse-args.js";
+import type { MarkerMap, WorkspaceVersionMap } from "./substitute.js";
+/** The modules `remove-module` takes (decision 6). */
+export declare const REMOVABLE_MODULES: readonly ModuleName[];
+/**
+ * The `content/<locale>/<type>/` directories a site keeps when it drops
+ * `marketing`: the seeds of the kept legal pages (`HUB_KEPT_ROUTES`).
+ */
+export declare const HUB_KEPT_CONTENT_TYPES: readonly string[];
+/** A refusal the CLI exits 2 on — the same shape `add-module` throws. */
+export declare class RemoveModuleRefusedError extends Error {
+    readonly exitCode = 2;
+    constructor(message: string);
+}
+export interface RemoveModuleOptions {
+    /** The already-scaffolded site. */
+    targetDir: string;
+    moduleName: ModuleName;
+    /** Delete the site's own edits too (decision 5). */
+    force?: boolean;
+    /** The package's `templates/` snapshot — the record's template copies and the overlay seeds. */
+    templatesDir: string;
+    /** The package's `site-templates/` dir — the base layer and the template tree's seeds. */
+    siteTemplatesDir: string;
+    /** Workspace version map, for rendering a template copy the way `copyTemplate` did. */
+    versions: WorkspaceVersionMap;
+    /** The scaffold's marker map (`buildScaffoldMarkers`). */
+    markers: MarkerMap;
+    /** The running create-ailk version — the `version` a new record row carries. */
+    version: string;
+    /**
+     * `scaffold()`'s own call (#10040 D8): the header already lacks the module
+     * because the resolved set never had it, so the carry check is skipped.
+     */
+    fromScaffold?: boolean;
+}
+export interface RemoveModuleResult {
+    targetDir: string;
+    moduleName: ModuleName;
+    /** The module set `architecture.yaml` now declares. */
+    modules: ModuleName[];
+    /** Every path deleted, site-relative, sorted. */
+    removed: string[];
+    /** The deleted paths now carried as retired rows in the record (D1). */
+    retired: string[];
+    /** The site's own files the run deleted under `--force`. */
+    forced: string[];
+    /** Removal-set files kept because a kept file imports them, with the importer. */
+    keptImports: Array<{
+        path: string;
+        importedBy: string;
+    }>;
+    /** Config patches a removed module left in place, for the owner to reverse by hand (D7). */
+    review: Array<{
+        path: string;
+        reason: string;
+    }>;
+    /** Generated files rewritten (nav, flags, registries) or left for review (an edited nav). */
+    report: InstallReportRow[];
+    roster: {
+        state: "trimmed" | "unchanged" | "none";
+        dropped: string[];
+        path: string;
+    };
+}
+/** The directories `remove-module marketing` removes: the public route tree and the non-legal seeds. */
+export declare function marketingRemovalDirs(targetDir: string): string[];
+/**
+ * The removal-set files a KEPT file imports — kept with their own imports,
+ * to a fixed point (#10040). `apps/web/app/[locale]/contact/` holds helpers
+ * the locale layout and `lib/in-page-magnet.ts` import beside its page;
+ * deleting them with the page breaks the kept tree's type-check. Only
+ * `apps/web` code is scanned; a kept file is any `.ts`/`.tsx` outside the
+ * removal set (node_modules, .next and dist excluded).
+ */
+export declare function importedByKept(targetDir: string, removal: string[]): Map<string, string>;
+/** The paths a module's removal deletes, site-relative, only those on disk. */
+export declare function removalSet(targetDir: string, moduleName: ModuleName): string[];
+/**
+ * Removes one module from a scaffolded site. Every refusal is raised before
+ * the first write; the writes that follow (delete → record → architecture →
+ * manifest → generated files) are not atomic, but each is idempotent on its
+ * own inputs, so a run interrupted mid-way converges on the next invocation —
+ * `--force` is then needed only if the first run needed it.
+ */
+export declare function removeModuleFromScaffold(opts: RemoveModuleOptions): RemoveModuleResult;
+/** The report `remove-module` prints. */
+export declare function formatRemoveModuleReport(result: RemoveModuleResult): string;
+export interface RemoveModuleArgs {
+    module: ModuleName | undefined;
+    target: string | undefined;
+    force: boolean;
+    help: boolean;
+}
+export declare const REMOVE_MODULE_HELP = "create-ailk remove-module \u2014 take a module's public pages off an existing site.\n\nUsage:\n  create-ailk remove-module <module> [<target-dir>] [--force]\n\nArguments:\n  <module>                 marketing or docs-blog. Nothing else can be removed.\n  <target-dir>             An already-scaffolded repo (contains\n                           architecture.yaml). Defaults to the current dir.\n\nOptions:\n  --force                  Also delete files the site has edited or authored\n                           inside the module's pages. Without it, such files\n                           are listed and nothing is removed.\n  --help, -h               Print this message.\n\nDeletes the module's route directories and seed content, drops the module\nfrom .ailk-site-manifest.json and architecture.yaml, and records every removed\napp file as retired in .ailk-template-files.json, so create-ailk update and\nsync-routes never bring it back. A site without marketing redirects / to\n/account, serves robots.txt disallowing everything, sends noindex on every page\nand answers 404 at sitemap.xml and llms.txt. Removing marketing while docs-blog\nis installed is refused: remove docs-blog first.\n";
+/** Parse the argv AFTER the `remove-module` word, the `parseAddModuleArgs` shape. */
+export declare function parseRemoveModuleArgs(argv: string[]): RemoveModuleArgs;