create-ailk 0.31.0 → 0.32.0

package/dist/mdx-braces.js

@@ -0,0 +1,285 @@
+/**
+ * Bare `{…}` braces on mdx-body pages (#10773, spec
+ * docs/specs/10773-update-never-refreshes-0-19-spec.md D3, D4).
+ *
+ * MDX reads every `{` in body text as the start of a JavaScript expression.
+ * Under the renderer's `next-mdx-remote` defaults (`blockJS`), an expression
+ * that does not parse fails the page, and one that parses is deleted — so on
+ * an mdx-body page every `{` in text other than a `{/* … *\/}` comment is a
+ * defect. This module is the one lexical rule for that brace:
+ *
+ * - `findBareBraces` names every bare brace in a body, by offset, line and
+ *   column, in one left-to-right pass;
+ * - `escapeBareBraces` inserts one `\` before each, and keeps the result only
+ *   when the site's own MDX parser reads it with no expression left but
+ *   comments — the lexer proposes, the parser disposes.
+ *
+ * Used by `create-ailk update` and, through a byte-identical copy in the
+ * scaffold's `tools/`, by `pnpm mdx-body:check`. Pure: no filesystem and no
+ * imports. It must never contain a double open brace, which the scaffold copy
+ * substitutes as a marker.
+ */
+const ESM_RE = /^(?:import|export)[ {*]/;
+// MDX has no indented code, so a fence opens at any indentation — and inside
+// a list item or a blockquote, after its markers.
+const FENCE_RE = /^[ \t]*(?:(?:>|[-*+]|\d{1,9}[.)])[ \t]*)*(`{3,}|~{3,})/;
+const COMMENT_CLOSE_RE = /\*\/\s*\}/g;
+const WHITESPACE_RE = /\s/;
+const TAG_START_RE = /[A-Za-z/>]/;
+const isBlank = (line) => line.trim() === "";
+/**
+ * Every bare `{` in an MDX body. Skips, in this order of precedence: fenced
+ * code, ESM blocks, backslash escapes, inline code, JSX tags (attribute
+ * expressions included) and `{/* … *\/}` comments. Linear in the body.
+ */
+export function findBareBraces(body) {
+    const found = [];
+    const lineEnd = (from) => {
+        const end = body.indexOf("\n", from);
+        return end === -1 ? body.length : end;
+    };
+    // A code span or a tag never crosses a blank line: true at a `\n` that ends
+    // the body or starts a blank line.
+    const paragraphBreak = (at) => {
+        let j = at + 1;
+        while (body[j] === " " || body[j] === "\t" || body[j] === "\r")
+            j += 1;
+        return j >= body.length || body[j] === "\n";
+    };
+    // Memo so a failed search is never repeated over the same text.
+    const spanFailedUntil = new Map();
+    let tagFailedUntil = -1;
+    let commentClose;
+    let i = 0;
+    while (i < body.length) {
+        if (i === 0 || body[i - 1] === "\n") {
+            const end = lineEnd(i);
+            const line = body.slice(i, end);
+            const fence = FENCE_RE.exec(line)?.[1];
+            if (fence !== undefined) {
+                // Skip to after the closing fence line, or to the end of the body.
+                let at = end;
+                while (at < body.length) {
+                    const next = lineEnd(at + 1);
+                    const candidate = body.slice(at + 1, next);
+                    const run = FENCE_RE.exec(candidate);
+                    at = next;
+                    if (run !== null &&
+                        run[1][0] === fence[0] &&
+                        run[1].length >= fence.length &&
+                        candidate.slice(run[0].length).trim() === "") {
+                        break;
+                    }
+                }
+                i = at + 1;
+                continue;
+            }
+            if (ESM_RE.test(line)) {
+                let at = end;
+                while (at < body.length) {
+                    const next = lineEnd(at + 1);
+                    if (isBlank(body.slice(at + 1, next)))
+                        break;
+                    at = next;
+                }
+                i = at + 1;
+                continue;
+            }
+        }
+        const char = body[i];
+        if (char === "\\") {
+            // A backslash before a line break is a hard break; the next line is read as a line.
+            i += body[i + 1] === "\n" ? 1 : 2;
+            continue;
+        }
+        if (char === "`") {
+            let run = 1;
+            while (body[i + run] === "`")
+                run += 1;
+            const close = spanFailedUntil.get(run) ?? -1;
+            let closed = -1;
+            if (close < i) {
+                let at = i + run;
+                for (; at < body.length; at += 1) {
+                    if (body[at] === "\n" && (paragraphBreak(at) || FENCE_RE.test(body.slice(at + 1, lineEnd(at + 1)))))
+                        break;
+                    if (body[at] !== "`")
+                        continue;
+                    let length = 1;
+                    while (body[at + length] === "`")
+                        length += 1;
+                    if (length === run) {
+                        closed = at + length;
+                        break;
+                    }
+                    at += length - 1;
+                }
+                if (closed === -1)
+                    spanFailedUntil.set(run, at);
+            }
+            i = closed === -1 ? i + run : closed;
+            continue;
+        }
+        if (char === "<" && TAG_START_RE.test(body[i + 1] ?? "") && i >= tagFailedUntil) {
+            let depth = 0;
+            let quote = "";
+            let closed = -1;
+            let at = i + 1;
+            for (; at < body.length; at += 1) {
+                const c = body[at];
+                if (c === "\n" && paragraphBreak(at))
+                    break;
+                if (quote !== "") {
+                    if (c === quote)
+                        quote = "";
+                }
+                else if (depth > 0) {
+                    if (c === "{")
+                        depth += 1;
+                    else if (c === "}")
+                        depth -= 1;
+                }
+                else if (c === '"' || c === "'") {
+                    quote = c;
+                }
+                else if (c === "{") {
+                    depth = 1;
+                }
+                else if (c === ">") {
+                    closed = at + 1;
+                    break;
+                }
+            }
+            if (closed !== -1) {
+                i = closed;
+                continue;
+            }
+            // An unclosed tag already breaks the page; no later `<` before `at` is
+            // read as a tag, which keeps the scan linear.
+            tagFailedUntil = at;
+            i += 1;
+            continue;
+        }
+        if (char === "{") {
+            let next = i + 1;
+            while (next < body.length && WHITESPACE_RE.test(body[next]))
+                next += 1;
+            if (body[next] === "/" && body[next + 1] === "*") {
+                if (commentClose === undefined || commentClose.from > i || (commentClose.at !== -1 && commentClose.at < i)) {
+                    COMMENT_CLOSE_RE.lastIndex = next + 2;
+                    const match = COMMENT_CLOSE_RE.exec(body);
+                    commentClose = { from: i, at: match === null ? -1 : match.index + match[0].length };
+                }
+                if (commentClose.at !== -1) {
+                    i = commentClose.at;
+                    continue;
+                }
+            }
+            found.push({ offset: i, kind: body[next] === "/" ? "comment-like" : "placeholder" });
+        }
+        i += 1;
+    }
+    // Offsets to 1-based line and column, in one pass.
+    const braces = [];
+    let line = 1;
+    let lineStart = 0;
+    let scanned = 0;
+    for (const brace of found) {
+        for (; scanned < brace.offset; scanned += 1) {
+            if (body[scanned] === "\n") {
+                line += 1;
+                lineStart = scanned + 1;
+            }
+        }
+        braces.push({ ...brace, line, column: brace.offset - lineStart + 1 });
+    }
+    return braces;
+}
+const COMMENT_VALUE_RE = /^\s*\/\*[\s\S]*\*\/\s*$/;
+/** The first expression node left in the tree that is not a comment. */
+export function firstExpression(node) {
+    if ((node.type === "mdxFlowExpression" || node.type === "mdxTextExpression") &&
+        !(typeof node.value === "string" && COMMENT_VALUE_RE.test(node.value))) {
+        return node;
+    }
+    for (const child of node.children ?? []) {
+        const hit = firstExpression(child);
+        if (hit !== undefined)
+            return hit;
+    }
+    return undefined;
+}
+/** The first `code` or `inlineCode` node whose span holds one of `offsets` (sorted). */
+function codeNodeHolding(node, offsets) {
+    if (node.type === "code" || node.type === "inlineCode") {
+        const start = node.position?.start?.offset;
+        const end = node.position?.end?.offset;
+        if (typeof start === "number" && typeof end === "number") {
+            let lo = 0;
+            let hi = offsets.length;
+            while (lo < hi) {
+                const mid = (lo + hi) >> 1;
+                if (offsets[mid] < start)
+                    lo = mid + 1;
+                else
+                    hi = mid;
+            }
+            if (lo < offsets.length && offsets[lo] < end)
+                return node;
+        }
+    }
+    for (const child of node.children ?? []) {
+        const hit = codeNodeHolding(child, offsets);
+        if (hit !== undefined)
+            return hit;
+    }
+    return undefined;
+}
+/**
+ * Escape every bare brace in `body`, all or nothing: `clean` when there is
+ * none (`parse` is not called), `refused` when a brace is a mangled comment,
+ * the escaped text does not parse, or an expression the escape did not reach
+ * remains; otherwise `escaped`.
+ */
+export function escapeBareBraces(body, parse) {
+    const braces = findBareBraces(body);
+    if (braces.length === 0)
+        return { kind: "clean" };
+    const mangled = braces.find((brace) => brace.kind === "comment-like");
+    if (mangled !== undefined) {
+        return { kind: "refused", reason: `{/ at line ${mangled.line} is not a {/* … */} comment` };
+    }
+    const parts = [];
+    let from = 0;
+    for (const { offset } of braces) {
+        parts.push(body.slice(from, offset), "\\");
+        from = offset;
+    }
+    parts.push(body.slice(from));
+    const text = parts.join("");
+    let tree;
+    try {
+        tree = parse(text);
+    }
+    catch (err) {
+        const { line, reason } = (err ?? {});
+        const why = typeof reason === "string" ? reason : err instanceof Error ? err.message : String(err);
+        return { kind: "refused", reason: `line ${typeof line === "number" ? line : "?"}: ${why}` };
+    }
+    const escapes = braces.map((brace, k) => brace.offset + k);
+    const inCode = codeNodeHolding(tree, escapes);
+    if (inCode !== undefined) {
+        return {
+            kind: "refused",
+            reason: `a brace at line ${inCode.position?.start?.line ?? "?"} is inside code the lexer did not see`,
+        };
+    }
+    const left = firstExpression(tree);
+    if (left !== undefined) {
+        return {
+            kind: "refused",
+            reason: `an expression at line ${left.position?.start?.line ?? "?"} the escape did not reach`,
+        };
+    }
+    return { kind: "escaped", text, count: braces.length };
+}

package/dist/migrate-content.d.ts

@@ -45,5 +45,5 @@ export interface MigrateContentArgs {
     workspaceId: string | undefined;
     help: boolean;
 }
-export declare const MIGRATE_CONTENT_HELP = "create-ailk migrate-content \u2014 import an existing site's pages into its workspace.\n\nUsage:\n  AILK_AGENT_KEY=<key> create-ailk migrate-content [<dir>] [--apply] [--api-url <origin>] [--workspace <wksp_id>]\n\nArguments:\n  <dir>                    The site. Defaults to the current dir.\n\nOptions:\n  --apply                  Write the pages. Without it the command reads the\n                           workspace, prints what it would do, and writes\n                           nothing.\n  --api-url <origin>       The API origin that holds the workspace \u2014 on a\n                           spoke, its hub's. Else AILK_API_URL. https: only\n                           (http: on localhost or 127.0.0.1).\n  --workspace <wksp_id>    The workspace the pages are written to. Else\n                           AILK_WORKSPACE_ID.\n  -h, --help               Show this help.\n\nEach content/en/<Type>/<slug>.mdx page (and each legacy\ncontent/<Type>/<slug>.mdx) is written to the workspace as a draft through\nthe API's content routes, with the agent key, which is read from\nAILK_AGENT_KEY only and needs the content-edit grant. Nothing is published,\nso the live site does not change. The site needs no .ailk-site-manifest.json\nand may be a spoke; its dependencies must be installed. A page whose\nfrontmatter carries sections is converted: its words are written to the\npage's Markdown and its sections to its layout.\n\nEach FAQ item and glossary-index term becomes one Language item of its kind,\nset Live when the run creates it, and its section pins the items in the\norder the file lists them. A question on several pages is one item, with\nthe FAQ page's words (the glossary page's, for a term). Lines prefixed\nlanguage: report each item, and each page the database read will not show\nas its file does. An API with no Language collection leaves them inline.\n\nWhen the site has apps/web/content, each blog post and docs page in it is\nwritten too: apps/web/content/en/blog/<slug>.mdx (or <slug>/index.mdx) as a\nBlogPosting, the same under docs as a DocsDetail, and each directory's own\nindex.mdx as its BlogList or DocsList index. Their lines are prefixed\neditorial: \u2014 each outcome's root is content or editorial.\n\nA dry run prints create, update, unchanged, skipped or failed per page. It\ncannot see a write the API would refuse at --apply (a conflict or a server\nerror), nor a layout change on a page whose words did not change, and a\npage whose content fails its page type is planned and saved\nwith errors the editor shows, not failed. --apply prints created, updated,\nunchanged, skipped or failed per page, so a re-run is safe. Exit 0 when no\npage failed, 1 when any did, 2 on a refusal (nothing is sent).\n";
+export declare const MIGRATE_CONTENT_HELP = "create-ailk migrate-content \u2014 import an existing site's pages into its workspace.\n\nUsage:\n  AILK_AGENT_KEY=<key> create-ailk migrate-content [<dir>] [--apply] [--api-url <origin>] [--workspace <wksp_id>]\n\nArguments:\n  <dir>                    The site. Defaults to the current dir.\n\nOptions:\n  --apply                  Write the pages. Without it the command reads the\n                           workspace, prints what it would do, and writes\n                           nothing.\n  --api-url <origin>       The API origin that holds the workspace \u2014 on a\n                           spoke, its hub's. Else AILK_API_URL. https: only\n                           (http: on localhost or 127.0.0.1).\n  --workspace <wksp_id>    The workspace the pages are written to. Else\n                           AILK_WORKSPACE_ID.\n  -h, --help               Show this help.\n\nEach content/en/<Type>/<slug>.mdx page (and each legacy\ncontent/<Type>/<slug>.mdx) is written to the workspace as a draft through\nthe API's content routes, with the agent key, which is read from\nAILK_AGENT_KEY only and needs the content-edit grant. Nothing is published,\nso the live site does not change. The site needs no .ailk-site-manifest.json\nand may be a spoke; its dependencies must be installed. A page whose\nfrontmatter carries sections is converted: its words are written to the\npage's Markdown and its sections to its layout.\n\nEach FAQ item and glossary-index term becomes one Language item of its kind,\nset Live when the run creates it, and its section pins the items in the\norder the file lists them. A question on several pages is one item, with\nthe FAQ page's words (the glossary page's, for a term). Lines prefixed\nlanguage: report each item, and each page the database read will not show\nas its file does. An API with no Language collection leaves them inline.\n\nWhen the site has apps/web/content, each blog post and docs page in it is\nwritten too: apps/web/content/en/blog/<slug>.mdx (or <slug>/index.mdx) as a\nBlogPosting, or one series down, blog/<series>/<post>.mdx, as a BlogPosting\nwhose parent is the series; the same under docs as a DocsDetail, and each\ndirectory's own index.mdx as its BlogList or DocsList index. A file the walk\nskips is listed with the rule it failed. Their lines are prefixed\neditorial: \u2014 each outcome's root is content or editorial.\n\nA dry run prints create, update, unchanged, skipped or failed per page. It\ncannot see a write the API would refuse at --apply (a conflict or a server\nerror), nor a layout change on a page whose words did not change, and a\npage whose content fails its page type is planned and saved\nwith errors the editor shows, not failed. --apply prints created, updated,\nunchanged, skipped or failed per page, so a re-run is safe. Exit 0 when no\npage failed, 1 when any did, 2 on a refusal (nothing is sent).\n";
 export declare function parseMigrateContentArgs(argv: string[]): MigrateContentArgs;

package/dist/migrate-content.js

@@ -217,8 +217,10 @@ as its file does. An API with no Language collection leaves them inline.
 
 When the site has apps/web/content, each blog post and docs page in it is
 written too: apps/web/content/en/blog/<slug>.mdx (or <slug>/index.mdx) as a
-BlogPosting, the same under docs as a DocsDetail, and each directory's own
-index.mdx as its BlogList or DocsList index. Their lines are prefixed
+BlogPosting, or one series down, blog/<series>/<post>.mdx, as a BlogPosting
+whose parent is the series; the same under docs as a DocsDetail, and each
+directory's own index.mdx as its BlogList or DocsList index. A file the walk
+skips is listed with the rule it failed. Their lines are prefixed
 editorial: — each outcome's root is content or editorial.
 
 A dry run prints create, update, unchanged, skipped or failed per page. It

package/dist/programmatic.js

@@ -46,7 +46,7 @@ import { SITE_FONTS_PATH, renderSiteFonts } from "./site-fonts.js";
 import { planSiteManifest } from "./site-manifest.js";
 import { SITE_ROSTER_PATH, planHomeRecord, planSiteManifestDesign, readSiteRoster, withMeetPlaceholderSeeds, } from "./site-roster.js";
 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 { GATEABLE_SURFACES, NAV_CONFIG_PATH, excludedRoutePaths, isUnservedSurfaceContent, renderNavConfig, resolveSurfaces, surfacesNamedByRoutes, } from "./surfaces.js";
 import { syncRoutes } from "./sync-routes.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";
@@ -1075,13 +1075,7 @@ function pruneUnrosteredSeeds(targetDir, roster, surfaces, ownership) {
  * path segment is the surface's top-level route directory.
  */
 function rosterSurfaces(template) {
-    const routeRoot = "apps/web/app/[locale]";
-    const moduleOwned = new Set(Object.values(MODULE_SURFACES).flat());
-    const topSegments = new Set(mergeRoster(template, template.requires)
-        .map((row) => row.route.split("/").filter(Boolean)[0])
-        .filter((segment) => segment !== undefined));
-    return GATEABLE_SURFACES.filter((surface) => !moduleOwned.has(surface.id) &&
-        surface.routes.some((dir) => topSegments.has(dir.slice(routeRoot.length + 1)))).map((surface) => surface.id);
+    return surfacesNamedByRoutes(mergeRoster(template, template.requires).map((row) => row.route));
 }
 // Re-exported so a consumer of the async `scaffold()` above can type its own
 // wrapper (e.g. the MCP scaffold-site tool) without reaching into `lib/`.

package/dist/site-manifest.js

@@ -38,13 +38,10 @@ import { join, relative, sep } from "node:path";
 import { isDeepStrictEqual } from "node:util";
 import { AddModuleRefusedError } from "./add-module-core.js";
 import { MODULE_SLICES, normalizeModules } from "./module-architecture.js";
-import { SITE_ROSTER_PATH, moduleRosterRows, parseSiteRoster, planRosterAppend, resolveRosterTemplate, } from "./site-roster.js";
+import { SITE_ROSTER_PATH, moduleRosterRows, parseRosterFile, parseSiteRoster, planRosterAppend, resolveRosterTemplate, servedRoutes, withoutUnservedRouteRows, } from "./site-roster.js";
 import { TEMPLATE_MANIFESTS, rosterDeclares, templateTreeDir, } from "./template-manifest.js";
 /** Prettier's default print width — the generator formats the manifest with it. */
 const PRINT_WIDTH = 80;
-/** Where the site's App Router pages live. */
-const ROUTE_ROOT = join("apps", "web", "app", "[locale]");
-const PAGE_FILE = /^page\.(tsx|ts|jsx|js|mdx)$/;
 /**
  * The generator's row for a content-less route (`build-template-manifest.mjs`:
  * every row renders under the locale layout's MarketingShell, chrome on).
@@ -89,7 +86,10 @@ export function planSiteManifest(opts) {
         templatesDir: opts.templatesDir,
         markers: opts.markers,
     });
-    const appended = plan.next ?? roster.text;
+    // #10774 D4.2 — the template's own code-route rows a spoke does not serve
+    // (`/sign-in`, `/sign-up`) leave with the files the spoke filter dropped.
+    const planned = plan.next ?? roster.text;
+    const appended = withoutUnservedRouteRows(parseRosterFile(planned, roster.path), opts.targetDir).next ?? planned;
     const declared = new Set(JSON.parse(appended).rows.map((row) => row["route"]));
     const extra = [
         ...sampleRows(opts, declared),
@@ -226,42 +226,10 @@ function sampleRows(opts, declared) {
 }
 /** A code-route row for every page route on disk that `declared` does not name. */
 function codeRouteRows(targetDir, declared) {
-    return routesOnDisk(targetDir)
+    return servedRoutes(targetDir)
         .filter((route) => !declared.has(route))
         .map((route) => ({ route, ...CODE_ROUTE_ROW }));
 }
-/**
- * Every route the site's App Router serves from a page file, sorted: route
- * groups `(x)` dropped, a trailing optional catch-all `[[...x]]` folded into
- * its parent (docs-blog's `/blog/[[...slug]]` serves `/blog`). The root
- * content renderers (`/[slug]`, `/[slug]/[detail]`) are not routes of their
- * own — they are how the content rows render — so they are left out.
- */
-function routesOnDisk(targetDir) {
-    const root = join(targetDir, ROUTE_ROOT);
-    const routes = new Set();
-    const stack = existsSync(root) ? [root] : [];
-    for (let cur = stack.pop(); cur !== undefined; cur = stack.pop()) {
-        const entries = readdirSync(cur, { withFileTypes: true });
-        for (const entry of entries) {
-            if (entry.isDirectory())
-                stack.push(join(cur, entry.name));
-        }
-        if (!entries.some((entry) => entry.isFile() && PAGE_FILE.test(entry.name))) {
-            continue;
-        }
-        const segments = relative(root, cur)
-            .split(sep)
-            .filter((segment) => segment !== "" && !/^\(.+\)$/.test(segment));
-        const last = segments[segments.length - 1];
-        if (last !== undefined && /^\[\[\.\.\..+\]\]$/.test(last))
-            segments.pop();
-        if (segments[0]?.startsWith("["))
-            continue;
-        routes.add(`/${segments.join("/")}`);
-    }
-    return [...routes].sort();
-}
 /** Every `.mdx` under `dir`, as sorted `/`-separated paths relative to `base`. */
 function listMdx(dir, base) {
     const out = [];

package/dist/site-roster.d.ts

@@ -20,7 +20,7 @@ export interface RosterRowSlice {
     text: string;
 }
 /** A parsed manifest file, with the `rows` array located in its text. */
-interface RosterFile {
+export interface RosterFile {
     doc: Record<string, unknown>;
     text: string;
     rows: RosterRowSlice[];
@@ -52,6 +52,12 @@ export interface ModuleRosterRow {
     /** A `contentDir` contribution's seeded page form. */
     seeded?: RosterRowSlice;
 }
+/**
+ * Parse a manifest file and locate its `rows` array in the text. The element
+ * spans are cross-checked against `JSON.parse`, so a splice can only ever
+ * move bytes the parser agrees are those rows.
+ */
+export declare function parseRosterFile(text: string, label: string): RosterFile;
 /**
  * The site's roster of record, or `undefined` when the site has none (a
  * scaffold that named no template installs no manifest). A file that is not
@@ -176,6 +182,42 @@ export interface PlanRosterAppendOptions {
  * other row on a contributed route is the site's own and is kept as is.
  */
 export declare function planRosterAppend(opts: PlanRosterAppendOptions): RosterAppendPlan;
+/**
+ * Every route the site's App Router serves from a page file, sorted: route
+ * groups `(x)` dropped, a trailing optional catch-all `[[...x]]` folded into
+ * its parent (docs-blog's `/blog/[[...slug]]` serves `/blog`). The root
+ * content renderers (`/[slug]`, `/[slug]/[detail]`) are not routes of their
+ * own — they are how the content rows render — so they are left out.
+ */
+export declare function servedRoutes(targetDir: string): string[];
+/**
+ * `file`'s next text with its unserved code-route rows removed — every other
+ * byte verbatim — and the dropped routes in file order; `next` is undefined
+ * when none is dropped.
+ */
+export declare function withoutUnservedRouteRows(file: RosterFile, targetDir: string): {
+    next: string | undefined;
+    dropped: string[];
+};
+/**
+ * The routes of the site roster's page rows — the rows that carry content —
+ * or undefined when it has none. A code-route row is left out: it records a
+ * route already on disk (signal-collectors' `/careers/apply` walk under the
+ * unrelated careers segment), never a surface the site serves. The template
+ * is not resolved, so a retired template name reads as any other.
+ * @throws AddModuleRefusedError when the file's `rows` cannot be located.
+ */
+export declare function readRosterPageRoutes(targetDir: string): string[] | undefined;
+/**
+ * The site roster with its unserved code-route rows removed, or undefined
+ * when the site has no roster.
+ * @throws AddModuleRefusedError when the file's `rows` cannot be located.
+ */
+export declare function planServedRoster(targetDir: string): {
+    path: string;
+    next: string | undefined;
+    dropped: string[];
+} | undefined;
 export interface SiteRosterCheckOptions {
     targetDir: string;
     siteTemplatesDir: string;
@@ -191,9 +233,10 @@ export interface SiteRosterCheckOptions {
  *      the shipped reference row;
  *   3. an installed seed — one some layer lands, present in the site — that
  *      the effective roster does not declare. A page the customer wrote is
- *      installed by no layer and is never reported.
+ *      installed by no layer and is never reported;
+ *   4. a code-route row no page file serves (#10774). A module contribution
+ *      whose page file the site lacks is not expected under 2.
  *
  * A site with no roster (a template-less scaffold) has no problems.
  */
 export declare function siteRosterProblems(opts: SiteRosterCheckOptions): string[];
-export {};