@tokenoftrust/storefront-runner 2.4.23 → 2.4.24

package/apps/storefront/src/components/blog/BlogIndexView.astro

@@ -7,9 +7,9 @@ import Layout from "@/layouts/Layout.astro";
 import PostAccessBadge from "@/components/blog/PostAccessBadge.astro";
 import type { BlogPostSummary } from "@/lib/blog/types.js";
 import type { BlogIndexCopy } from "@/lib/blog/pagination.js";
-import { blogPagePath } from "@/lib/blog/pagination.js";
 import type { BlogPresentation } from "@/lib/blog/presentation.js";
 import { categorySlug } from "@/lib/blog/collection.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 interface Props {
   basePath: string;
@@ -23,17 +23,18 @@ interface Props {
 }
 
 const { basePath, canonicalBase, copy, presentation, tags, pagePosts, page, totalPages } = Astro.props;
+const blogPaths = collectionPathsV1(Astro.locals, "blog");
 const showTopics = presentation.topics && tags.length > 0;
 
 const href = (path: string) => `${basePath}${path}` || "/";
-const path = blogPagePath(page);
+const path = blogPaths.page(page);
 // Page 1 keeps the tenant's declared title verbatim (unchanged default copy); page
 // N>1 is distinguished in the <title> tag only — the on-page <h1> stays identical
 // across pages, matching how a reader experiences "the same blog, page 2".
 const documentTitle = page > 1 ? `${copy.title} — Page ${page}` : copy.title;
 const pagination = {
-  ...(page > 1 ? { prev: blogPagePath(page - 1) } : {}),
-  ...(page < totalPages ? { next: blogPagePath(page + 1) } : {}),
+  ...(page > 1 ? { prev: blogPaths.page(page - 1) } : {}),
+  ...(page < totalPages ? { next: blogPaths.page(page + 1) } : {}),
 };
 
 const itemList = {
@@ -44,7 +45,7 @@ const itemList = {
     "@type": "ListItem",
     position: index + 1,
     name: post.title,
-    url: new URL(`/blog/${post.slug}/`, canonicalBase + "/").toString(),
+    url: new URL(blogPaths.post(post.slug), canonicalBase + "/").toString(),
   })),
 };
 ---
@@ -70,7 +71,7 @@ const itemList = {
       <aside aria-label="Blog topics">
         <p class="filter-label">Explore topics</p>
         <div class="tag-list">
-          {tags.map((tag) => <a href={href(`/blog/tag/${categorySlug(tag)}/`)}>{tag}</a>)}
+          {tags.map((tag) => <a href={href(blogPaths.tag(categorySlug(tag)))}>{tag}</a>)}
         </div>
       </aside>
     )}
@@ -78,7 +79,7 @@ const itemList = {
     <section class="post-grid" aria-label="Blog posts" id="blog-posts">
       {pagePosts.map((post, index) => (
         <article class="post-card">
-          <a href={href(`/blog/${post.slug}/`)} aria-label={`Read ${post.title}`}>
+          <a href={href(blogPaths.post(post.slug))} aria-label={`Read ${post.title}`}>
             {post.featuredImage ? (
               <img
                 src={post.featuredImage.src}
@@ -105,11 +106,11 @@ const itemList = {
   {totalPages > 1 && (
     <nav class="blog-shell blog-pagination" aria-label="Blog pagination">
       {page > 1
-        ? <a class="blog-pagination-link" rel="prev" href={href(blogPagePath(page - 1))}>← Newer posts</a>
+        ? <a class="blog-pagination-link" rel="prev" href={href(blogPaths.page(page - 1))}>← Newer posts</a>
         : <span />}
       <span class="blog-pagination-status">Page {page} of {totalPages}</span>
       {page < totalPages
-        ? <a class="blog-pagination-link" rel="next" href={href(blogPagePath(page + 1))}>Older posts →</a>
+        ? <a class="blog-pagination-link" rel="next" href={href(blogPaths.page(page + 1))}>Older posts →</a>
         : <span />}
     </nav>
   )}

package/apps/storefront/src/components/blog/PostGrid.astro

@@ -1,24 +1,25 @@
 ---
 // Reader-facing card grid for a list of blog posts, shared by the collection's
-// category and tag index pages. `base` is the collection route base (e.g.
-// "/blog"); `basePath` is the tenant/preview path prefix from Astro.locals.
+// category and tag index pages. `paths` are the collection's URLs for the space that serves
+// the page (collectionPathsV1); `basePath` is the tenant/preview path prefix from Astro.locals.
 import type { BlogPostSummary } from "@/lib/blog/types.js";
+import type { CollectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 import PostAccessBadge from "@/components/blog/PostAccessBadge.astro";
 
 interface Props {
   posts: BlogPostSummary[];
   basePath: string;
-  base: string;
+  paths: CollectionPathsV1;
 }
 
-const { posts, basePath, base } = Astro.props;
+const { posts, basePath, paths } = Astro.props;
 const href = (path: string) => `${basePath}${path}` || "/";
 ---
 
 <section class="post-grid" aria-label="Posts">
   {posts.map((post, index) => (
     <article class="post-card">
-      <a href={href(`${base}/${post.slug}/`)} aria-label={`Read ${post.title}`}>
+      <a href={href(paths.post(post.slug))} aria-label={`Read ${post.title}`}>
         {post.featuredImage ? (
           <img
             src={post.featuredImage.src}

package/apps/storefront/src/components/the-build/TheBuildIndexView.astro

@@ -9,7 +9,7 @@ import PostAccessBadge from "@/components/blog/PostAccessBadge.astro";
 import type { BlogPostSummary } from "@/lib/blog/types.js";
 import type { TheBuildIndexCopy } from "@/lib/the-build/pagination.js";
 import type { BlogPresentation } from "@/lib/blog/presentation.js";
-import { theBuildPagePath } from "@/lib/the-build/pagination.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 interface Props {
   basePath: string;
@@ -22,15 +22,16 @@ interface Props {
 }
 
 const { basePath, canonicalBase, copy, presentation, pagePosts, page, totalPages } = Astro.props;
+const buildPaths = collectionPathsV1(Astro.locals, "the-build");
 
 const href = (path: string) => `${basePath}${path}` || "/";
-const path = theBuildPagePath(page);
+const path = buildPaths.page(page);
 // Page 1 keeps the tenant's declared title verbatim; page N>1 is distinguished
 // in the <title> tag only — the on-page <h1> stays identical across pages.
 const documentTitle = page > 1 ? `${copy.title} — Page ${page}` : copy.title;
 const pagination = {
-  ...(page > 1 ? { prev: theBuildPagePath(page - 1) } : {}),
-  ...(page < totalPages ? { next: theBuildPagePath(page + 1) } : {}),
+  ...(page > 1 ? { prev: buildPaths.page(page - 1) } : {}),
+  ...(page < totalPages ? { next: buildPaths.page(page + 1) } : {}),
 };
 
 const itemList = {
@@ -41,7 +42,7 @@ const itemList = {
     "@type": "ListItem",
     position: index + 1,
     name: post.title,
-    url: new URL(`/the-build/${post.slug}/`, canonicalBase + "/").toString(),
+    url: new URL(buildPaths.post(post.slug), canonicalBase + "/").toString(),
   })),
 };
 ---
@@ -66,7 +67,7 @@ const itemList = {
     <section class="post-grid" aria-label="The Build posts" id="the-build-posts">
       {pagePosts.map((post, index) => (
         <article class="post-card">
-          <a href={href(`/the-build/${post.slug}/`)} aria-label={`Read ${post.title}`}>
+          <a href={href(buildPaths.post(post.slug))} aria-label={`Read ${post.title}`}>
             {post.featuredImage ? (
               <img
                 src={post.featuredImage.src}
@@ -92,11 +93,11 @@ const itemList = {
     {totalPages > 1 && (
       <nav class="blog-pagination" aria-label="The Build pagination">
         {page > 1
-          ? <a class="blog-pagination-link" rel="prev" href={href(theBuildPagePath(page - 1))}>← Newer posts</a>
+          ? <a class="blog-pagination-link" rel="prev" href={href(buildPaths.page(page - 1))}>← Newer posts</a>
           : <span />}
         <span class="blog-pagination-status">Page {page} of {totalPages}</span>
         {page < totalPages
-          ? <a class="blog-pagination-link" rel="next" href={href(theBuildPagePath(page + 1))}>Older posts →</a>
+          ? <a class="blog-pagination-link" rel="next" href={href(buildPaths.page(page + 1))}>Older posts →</a>
           : <span />}
       </nav>
     )}

package/apps/storefront/src/config/publicationSpaceConfig.ts

@@ -51,6 +51,7 @@ export function mountedPublicationSpaceConfig(
   mount: string,
   visibility: PublicationSpaceVisibilityV1 = "public",
   aliases: readonly PublicationSpaceAliasV1[] = [],
+  collections?: PublicationSpaceManifestV1["routes"]["collections"],
 ): PublicationSpaceManifestV1 {
   const internal = visibility === "internal";
   return {
@@ -58,7 +59,11 @@ export function mountedPublicationSpaceConfig(
     id,
     tenant,
     source,
-    routes: aliases.length ? { canonicalMount: mount, aliases: [...aliases] } : { canonicalMount: mount },
+    routes: {
+      canonicalMount: mount,
+      ...(aliases.length ? { aliases: [...aliases] } : {}),
+      ...(collections && Object.keys(collections).length ? { collections: { ...collections } } : {}),
+    },
     visibility,
     authorization: internal ? { policy: "capability", capability: "internal-content-reader" } : { policy: "public" },
     discovery: internal

package/apps/storefront/src/config/publicationSpaceRegistry.ts

@@ -33,6 +33,7 @@ export function publicationSpacesFromTopology(
         mounted.mount,
         mounted.visibility ?? "public",
         mounted.aliases ?? [],
+        mounted.collections,
       )),
   ];
   const foreign = spaces.find((space) => !sourceBelongsToTenant(tenant, space.source));

package/apps/storefront/src/config/publicationSpaceTopology.ts

@@ -1,4 +1,9 @@
-import type { PublicationSpaceAliasV1, PublicationSpaceSourceV1, PublicationSpaceVisibilityV1 } from "@tot/public-runtime";
+import type {
+  PublicationSpaceAliasV1,
+  PublicationSpaceManifestV1,
+  PublicationSpaceSourceV1,
+  PublicationSpaceVisibilityV1,
+} from "@tot/public-runtime";
 
 /**
  * One declared non-root publication space: a mount, its source, and its
@@ -11,6 +16,8 @@ export interface MountedPublicationSpaceDeclarationV1 {
   mount: string;
   visibility?: PublicationSpaceVisibilityV1;
   aliases?: readonly PublicationSpaceAliasV1[];
+  /** Collection base paths inside the mount; `""` serves the collection at the mount root. */
+  collections?: PublicationSpaceManifestV1["routes"]["collections"];
 }
 
 /** A tenant's complete declared publication topology: exactly one root, plus any mounted spaces. */
@@ -38,6 +45,8 @@ export const PUBLICATION_SPACE_TOPOLOGY: Readonly<Record<string, PublicationTopo
         source: { forge: "gitea", repo: "tokenoftrust.com-publications", defaultBranch: "main" },
         mount: "/blog",
         visibility: "public",
+        // Decision m1b-mount-layout-2026-10-12: posts, index and archives at /blog/..., as today.
+        collections: { blog: "" },
       },
     ],
   },
@@ -70,6 +79,12 @@ export const PUBLICATION_SPACE_TOPOLOGY: Readonly<Record<string, PublicationTopo
         mount: "/internal-docs",
         visibility: "internal",
       },
+      {
+        id: "fixture-articles",
+        source: { forge: "fixture", repo: "fixture.e2e.test-articles", defaultBranch: "main" },
+        mount: "/blog",
+        collections: { blog: "" },
+      },
     ],
   },
   // The same three-space shape, served by CloudFront: certifies the s3-overwrite publication path.
@@ -88,6 +103,12 @@ export const PUBLICATION_SPACE_TOPOLOGY: Readonly<Record<string, PublicationTopo
         mount: "/internal-docs",
         visibility: "internal",
       },
+      {
+        id: "fixture-cloudfront-articles",
+        source: { forge: "fixture", repo: "fixture-cloudfront.e2e.test-articles", defaultBranch: "main" },
+        mount: "/blog",
+        collections: { blog: "" },
+      },
     ],
   },
   "chrome.e2e.test": {

package/apps/storefront/src/lib/blog/collectionPaths.ts

@@ -0,0 +1,46 @@
+/**
+ * The collection URLs a page renders, for the publication space that serves it. Every one comes
+ * from `publicationCollectionPathV1`, the one constructor the route builders and the discovery
+ * emitter use, with the space's mount and its declared collection base: a space mounted at
+ * `/blog` whose blog collection sits at the mount root links its posts as `/blog/<slug>/`, and
+ * the root space keeps `/blog/<slug>/`. Paths are tenant-relative (no preview base path).
+ */
+import {
+  publicationCollectionBaseV1,
+  publicationCollectionPathV1,
+  type PublicationCollectionV1,
+  type PublicationRoutePlanV1,
+} from "@tot/public-runtime";
+
+export interface CollectionPathsV1 {
+  /** The collection index, page 1. */
+  index: string;
+  page(page: number): string;
+  post(slug: string): string;
+  author(slug: string): string;
+  category(slug: string): string;
+  tag(slug: string): string;
+  rss: string;
+}
+
+/** The collection paths for the space the request resolved to (the root space otherwise). */
+export function collectionPathsV1(
+  locals: { publicationRoute?: PublicationRoutePlanV1 },
+  collection: PublicationCollectionV1,
+): CollectionPathsV1 {
+  const plan = locals.publicationRoute;
+  const manifest = plan && plan.action === "render" ? plan.manifest : null;
+  const mount = manifest?.routes.canonicalMount ?? "/";
+  const base = publicationCollectionBaseV1(manifest, collection);
+  const path = (route: Parameters<typeof publicationCollectionPathV1>[2]) =>
+    publicationCollectionPathV1(mount, base, route);
+  return {
+    index: path({ kind: "index" }),
+    page: (page) => path({ kind: "page", page }),
+    post: (slug) => path({ kind: "post", slug }),
+    author: (slug) => path({ kind: "author", slug }),
+    category: (slug) => path({ kind: "category", slug }),
+    tag: (slug) => path({ kind: "tag", slug }),
+    rss: path({ kind: "rss" }),
+  };
+}

package/apps/storefront/src/lib/blog/pagination.ts

@@ -1,7 +1,11 @@
+import { DEFAULT_COLLECTION_PAGE_SIZE_V1 } from "@tot/public-runtime";
 import type { BlogSettings } from "./types.js";
 
-/** Posts per `/blog/` page when a tenant declares no `pageSize` (or an invalid one). */
-export const DEFAULT_BLOG_PAGE_SIZE = 12;
+/**
+ * Posts per blog index page when a tenant declares no `pageSize` (or an invalid one). The route
+ * builders count index pages with the same default, so a page the renderer serves is a page they list.
+ */
+export const DEFAULT_BLOG_PAGE_SIZE = DEFAULT_COLLECTION_PAGE_SIZE_V1;
 
 /**
  * Resolved `/blog/` index copy + page size. A declared `BlogSettings` field wins;
@@ -91,20 +95,6 @@ export function paginateBlogPosts<T>(
   return { posts: posts.slice(start, start + pageSize), page, totalPages };
 }
 
-/**
- * Generic engine behind `blogPagePath` and every other collection's page path
- * (e.g. `theBuildPagePath`): page 1 is the bare index; page N≥2 is
- * `<basePath>/page/<n>/`. `basePath` carries no trailing slash (e.g. `/blog`).
- */
-export function pagedRoutePath(basePath: string, page: number): string {
-  return page <= 1 ? `${basePath}/` : `${basePath}/page/${page}/`;
-}
-
-/** `/blog/` is page 1; `/blog/page/<n>/` is page N for N≥2. */
-export function blogPagePath(page: number): string {
-  return pagedRoutePath("/blog", page);
-}
-
 /**
  * Generic engine behind `parseBlogPageParam` and every other collection's
  * `page/[n]` route param: not a bare positive-integer string (rejects "01",

package/apps/storefront/src/lib/publication/mountedDiscovery.ts

@@ -195,7 +195,10 @@ export async function readMountedPublicationDiscoveryV1(input: {
 export function mountedDiscoveryUrlV1(canonicalBase: string, entry: Pick<MountedDiscoveryEntryV1,
   "canonicalPath" | "kind">): string {
   if (entry.kind === "raw-html") return rawPageCanonicalUrl(canonicalBase, entry.canonicalPath.slice(1));
-  return `${canonicalBase.replace(/\/$/, "")}${entry.canonicalPath}`;
+  // Collection posts and archives declare the constructor's form (publicationCollectionPathV1):
+  // the route with its trailing slash.
+  const slash = entry.kind === "post" || entry.kind === "archive" ? "/" : "";
+  return `${canonicalBase.replace(/\/$/, "")}${entry.canonicalPath}${slash}`;
 }
 
 /** An RFC 3339 instant for a feed, or undefined when the value is not a date. */

package/apps/storefront/src/lib/publication/rootDiscovery.ts

@@ -8,6 +8,7 @@ import type { APIContext } from "astro";
 import { listBlogPosts } from "@/lib/blog/provider.js";
 import { listBuildPosts } from "@/lib/the-build/provider.js";
 import { isIndexableHtml, rawPageCanonicalUrl } from "@/lib/rawMarketingHtml.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 export interface RootDiscoveryDocumentV1 {
   kind: "home" | "page" | "post";
@@ -36,14 +37,16 @@ export async function rootPostDocumentsV1(locals: APIContext["locals"]): Promise
     listBlogPosts(tenant.tenant_id, content, publicationTimestamp),
     listBuildPosts(tenant.tenant_id, { content, now: publicationTimestamp }),
   ]);
+  const blogPaths = collectionPathsV1(locals, "blog");
+  const buildPaths = collectionPathsV1(locals, "the-build");
   return [
-    ...blogPosts.map((post) => ({ post, base: "/blog" })),
-    ...buildPosts.map((post) => ({ post, base: "/the-build" })),
-  ].map(({ post, base }) => {
+    ...blogPosts.map((post) => ({ post, paths: blogPaths })),
+    ...buildPosts.map((post) => ({ post, paths: buildPaths })),
+  ].map(({ post, paths }) => {
     const summary = plain(post.description || post.excerpt);
     return {
       kind: "post" as const,
-      path: `${base}/${post.slug}/`,
+      path: paths.post(post.slug),
       title: plain(post.title) || post.slug,
       summary,
       searchText: [plain(post.title), summary].filter(Boolean).join(" "),

package/apps/storefront/src/lib/the-build/pagination.ts

@@ -3,15 +3,15 @@
 // drift from it (fb-1791301493691-brzl6f's sibling: /the-build hardcoded
 // Token of Trust's own branding and never paginated, exactly like /blog did).
 import type { BlogSettings } from "../blog/types.js";
+import { DEFAULT_COLLECTION_PAGE_SIZE_V1 } from "@tot/public-runtime";
 import {
   type BlogIndexCopy,
-  pagedRoutePath,
   parsePagedRouteParam,
   resolveIndexCopy,
 } from "../blog/pagination.js";
 
-/** Posts per `/the-build/` page when a tenant declares no `pageSize` (or an invalid one). */
-export const DEFAULT_THE_BUILD_PAGE_SIZE = 12;
+/** Posts per the-build index page when a tenant declares no `pageSize` (or an invalid one). */
+export const DEFAULT_THE_BUILD_PAGE_SIZE = DEFAULT_COLLECTION_PAGE_SIZE_V1;
 
 export type TheBuildIndexCopy = BlogIndexCopy;
 
@@ -32,11 +32,6 @@ export function resolveTheBuildIndexCopy(
   );
 }
 
-/** `/the-build/` is page 1; `/the-build/page/<n>/` is page N for N≥2. */
-export function theBuildPagePath(page: number): string {
-  return pagedRoutePath("/the-build", page);
-}
-
 /**
  * Parse a `/the-build/page/<n>/` route param into a page number, or null when it
  * is not a valid page-N route (see `parsePagedRouteParam`).

package/apps/storefront/src/middleware/index.ts

@@ -237,10 +237,11 @@ async function serveRequest(
   }
 
   // A render alias dispatches the same existing Astro route as its canonical
-  // mount. Content lookup keeps its separate mount-relative `contentPath` on the
-  // plan; no downstream layer decodes or strips the request again.
+  // mount, and a collection path dispatches its platform collection route
+  // (`renderPath`). Content lookup keeps its separate mount-relative
+  // `contentPath` on the plan; no downstream layer decodes or strips the request again.
   const publicationRenderPath = publication.action === "render"
-    ? publication.canonicalPath
+    ? publication.renderPath
     : renderPath;
 
   // Workers Cache API: backs the full-page edge cache in the render chain, and

package/apps/storefront/src/pages/blog/[slug].astro

@@ -14,6 +14,7 @@ import { readViewerSession, safeNext } from "@/lib/auth/route.js";
 import { buildAlternates } from "@/lib/seo/alternates.js";
 import { languageLabel } from "@/lib/i18n.js";
 import { breadcrumbLd, blogPostingLd } from "@/lib/jsonld.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 // These redirects also exist in the published artifact: the publication composition lifts this
 // file into the space's `routes.aliases`, which reach the CDN plane through the live pointer. The
@@ -24,13 +25,14 @@ import { breadcrumbLd, blogPostingLd } from "@/lib/jsonld.js";
 export const MATERIALIZED_REDIRECT_SOURCE = "content/blog/redirects.json";
 
 const { tenant, canonicalBase, basePath, content, publicationTimestamp } = Astro.locals;
+const blogPaths = collectionPathsV1(Astro.locals, "blog");
 const slug = Astro.params.slug ?? "";
 const post = await getBlogPost(tenant.tenant_id, slug, content, publicationTimestamp);
 if (!post) {
   const redirect = await resolveBlogRedirect(tenant.tenant_id, slug, content);
   // 308, matching the `redirect-308` alias contract the published plane serves, so a renamed slug
   // behaves identically on both substrates.
-  if (redirect) return Astro.redirect(`${basePath}/blog/${redirect}/`, 308);
+  if (redirect) return Astro.redirect(`${basePath}${blogPaths.post(redirect)}`, 308);
   return new Response(null, { status: 404 });
 }
 
@@ -41,10 +43,10 @@ const viewer = await readViewerSession(Astro);
 const gated = (post.access ?? "public") !== "public";
 const unlock = viewerHasBlogAccess(viewer, post);
 const bodyHtml = articleBodyHtml(post.contentHtml, { gated, unlock });
-const next = safeNext(`${basePath}/blog/${post.slug}/`);
+const next = safeNext(`${basePath}${blogPaths.post(post.slug)}`);
 const loginHref = `/auth/login?next=${encodeURIComponent(next)}`;
 
-const canonical = new URL(`/blog/${post.slug}/`, canonicalBase + "/").toString();
+const canonical = new URL(blogPaths.post(post.slug), canonicalBase + "/").toString();
 const presentation = resolveBlogPresentation(await getBlogSettings(tenant.tenant_id, content));
 // A post that names no author has no byline: never attribute it to anyone (the blog's title, the
 // store) its content does not name.
@@ -64,10 +66,10 @@ const authorHasArchive = authorArchiveSlug !== "" && listed.some(
 const archivedTags = new Set(listed.flatMap((p) => p.tags.map(categorySlug)));
 const tagLinks = post.tags.map((tag) => {
   const slug = categorySlug(tag);
-  return { label: tag, href: slug && archivedTags.has(slug) ? `${basePath}/blog/tag/${slug}/` : null };
+  return { label: tag, href: slug && archivedTags.has(slug) ? `${basePath}${blogPaths.tag(slug)}` : null };
 });
 const authorUrl = authorHasArchive
-  ? new URL(`/blog/author/${authorArchiveSlug}/`, canonicalBase + "/").toString()
+  ? new URL(blogPaths.author(authorArchiveSlug), canonicalBase + "/").toString()
   : undefined;
 const articleLd = blogPostingLd(post, {
   url: canonical,
@@ -77,13 +79,13 @@ const articleLd = blogPostingLd(post, {
 });
 const trail = siteTrail(
   homeCrumbLabel(await content.getChrome()),
-  { label: "Blog", href: "/blog/" },
-  { label: post.title, href: `/blog/${post.slug}/` },
+  { label: "Blog", href: blogPaths.index },
+  { label: post.title, href: blogPaths.post(post.slug) },
 );
 const crumbs = breadcrumbLd(trail, canonicalBase);
-const blogHref = `${basePath}/blog/`;
+const blogHref = `${basePath}${blogPaths.index}`;
 const authorHref = authorHasArchive
-  ? `${basePath}/blog/author/${authorArchiveSlug}/`
+  ? `${basePath}${blogPaths.author(authorArchiveSlug)}`
   : null;
 const share = shareLinks(presentation.share, {
   url: canonical,
@@ -97,7 +99,7 @@ const translations = post.translationGroupId
   ? await getTranslations(tenant.tenant_id, "blog", post.slug, { content, now: publicationTimestamp })
   : [];
 const alternates = buildAlternates(translations, (s) =>
-  new URL(`/blog/${s}/`, canonicalBase + "/").toString(),
+  new URL(blogPaths.post(s), canonicalBase + "/").toString(),
 );
 const lang = alternates.length ? (post.inLanguage ?? "en") : undefined;
 ---
@@ -105,7 +107,7 @@ const lang = alternates.length ? (post.inLanguage ?? "en") : undefined;
 <Layout
   title={post.seoTitle || post.title}
   description={post.description}
-  path={`/blog/${post.slug}/`}
+  path={blogPaths.post(post.slug)}
   ogType="article"
   ogImage={post.featuredImage?.src}
   noindex={post.status === "unlisted"}
@@ -145,7 +147,7 @@ const lang = alternates.length ? (post.inLanguage ?? "en") : undefined;
             return (
               <a
                 hreflang={code}
-                href={`${basePath}/blog/${variant.slug}/`}
+                href={`${basePath}${blogPaths.post(variant.slug)}`}
                 aria-current={current ? "true" : undefined}
               >{languageLabel(code)}</a>
             );

package/apps/storefront/src/pages/blog/author/[author].astro

@@ -7,11 +7,13 @@ import { resolveBlogPresentation } from "@/lib/blog/presentation.js";
 import { homeCrumbLabel, siteTrail } from "@/lib/breadcrumbs.js";
 import { authorSlug, getAuthors } from "@/lib/blog/collection.js";
 import { breadcrumbLd } from "@/lib/jsonld.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 // Author archive for the `/blog` collection. Lists exactly the posts whose
 // bylines link here (same source as /blog/index.astro + /blog/[slug].astro),
 // so a byline never points at a page missing its post.
 const { tenant, basePath, canonicalBase, content, publicationTimestamp } = Astro.locals;
+const blogPaths = collectionPathsV1(Astro.locals, "blog");
 const slug = Astro.params.author ?? "";
 
 const allPosts = await listBlogPosts(tenant.tenant_id, content, publicationTimestamp);
@@ -22,7 +24,7 @@ const authorName = posts[0]!.author;
 const bio = (await getAuthors(tenant.tenant_id, "blog", content))[slug];
 
 const href = (path: string) => `${basePath}${path}` || "/";
-const canonical = new URL(`/blog/author/${slug}/`, canonicalBase + "/").toString();
+const canonical = new URL(blogPaths.author(slug), canonicalBase + "/").toString();
 const avatarUrl = bio?.avatar ? new URL(bio.avatar, canonicalBase + "/").toString() : undefined;
 
 const personLd = {
@@ -49,14 +51,14 @@ const itemListLd = {
     "@type": "ListItem",
     position: index + 1,
     name: post.title,
-    url: new URL(`/blog/${post.slug}/`, canonicalBase + "/").toString(),
+    url: new URL(blogPaths.post(post.slug), canonicalBase + "/").toString(),
   })),
 };
 const presentation = resolveBlogPresentation(await getBlogSettings(tenant.tenant_id, content));
 const trail = siteTrail(
   homeCrumbLabel(await content.getChrome()),
-  { label: "Blog", href: "/blog/" },
-  { label: authorName, href: `/blog/author/${slug}/` },
+  { label: "Blog", href: blogPaths.index },
+  { label: authorName, href: blogPaths.author(slug) },
 );
 const crumbs = breadcrumbLd(trail, canonicalBase);
 ---
@@ -64,7 +66,7 @@ const crumbs = breadcrumbLd(trail, canonicalBase);
 <Layout
   title={`${authorName} — Blog`}
   description={bio?.bio ?? `Articles by ${authorName}.`}
-  path={`/blog/author/${slug}/`}
+  path={blogPaths.author(slug)}
   fullBleed
   jsonLd={[crumbs, profileLd, itemListLd]}
 >
@@ -92,7 +94,7 @@ const crumbs = breadcrumbLd(trail, canonicalBase);
     <section class="post-grid" aria-label={`Posts by ${authorName}`}>
       {posts.map((post, index) => (
         <article class="post-card">
-          <a href={href(`/blog/${post.slug}/`)} aria-label={`Read ${post.title}`}>
+          <a href={href(blogPaths.post(post.slug))} aria-label={`Read ${post.title}`}>
             {post.featuredImage ? (
               <img
                 src={post.featuredImage.src}

package/apps/storefront/src/pages/blog/category/[category].astro

@@ -7,8 +7,10 @@ import { collectPostsByTerm } from "@/lib/blog/collection.js";
 import { resolveBlogPresentation } from "@/lib/blog/presentation.js";
 import { homeCrumbLabel, siteTrail } from "@/lib/breadcrumbs.js";
 import { breadcrumbLd } from "@/lib/jsonld.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 const { tenant, basePath, canonicalBase, content, publicationTimestamp } = Astro.locals;
+const blogPaths = collectionPathsV1(Astro.locals, "blog");
 const param = Astro.params.category ?? "";
 
 // Same source as the /blog index (the collection's curated list), filtered to
@@ -19,7 +21,7 @@ if (!match) return new Response(null, { status: 404 });
 const { label, posts } = match;
 const presentation = resolveBlogPresentation(await getBlogSettings(tenant.tenant_id, content));
 
-const path = `/blog/category/${param}/`;
+const path = blogPaths.category(param);
 const itemList = {
   "@context": "https://schema.org",
   "@type": "ItemList",
@@ -28,12 +30,12 @@ const itemList = {
     "@type": "ListItem",
     position: index + 1,
     name: post.title,
-    url: new URL(`/blog/${post.slug}/`, canonicalBase + "/").toString(),
+    url: new URL(blogPaths.post(post.slug), canonicalBase + "/").toString(),
   })),
 };
 const trail = siteTrail(
   homeCrumbLabel(await content.getChrome()),
-  { label: "Blog", href: "/blog/" },
+  { label: "Blog", href: blogPaths.index },
   { label, href: path },
 );
 const crumbs = breadcrumbLd(trail, canonicalBase);
@@ -56,7 +58,7 @@ const crumbs = breadcrumbLd(trail, canonicalBase);
   </header>
 
   <div class="blog-shell blog-layout">
-    <PostGrid posts={posts} basePath={basePath} base="/blog" />
+    <PostGrid posts={posts} basePath={basePath} paths={blogPaths} />
   </div>
 </Layout>
 

package/apps/storefront/src/pages/blog/tag/[tag].astro

@@ -7,8 +7,10 @@ import { collectPostsByTerm } from "@/lib/blog/collection.js";
 import { resolveBlogPresentation } from "@/lib/blog/presentation.js";
 import { homeCrumbLabel, siteTrail } from "@/lib/breadcrumbs.js";
 import { breadcrumbLd } from "@/lib/jsonld.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 const { tenant, basePath, canonicalBase, content, publicationTimestamp } = Astro.locals;
+const blogPaths = collectionPathsV1(Astro.locals, "blog");
 const param = Astro.params.tag ?? "";
 
 const all = await listBlogPosts(tenant.tenant_id, content, publicationTimestamp);
@@ -17,7 +19,7 @@ if (!match) return new Response(null, { status: 404 });
 const { label, posts } = match;
 const presentation = resolveBlogPresentation(await getBlogSettings(tenant.tenant_id, content));
 
-const path = `/blog/tag/${param}/`;
+const path = blogPaths.tag(param);
 const itemList = {
   "@context": "https://schema.org",
   "@type": "ItemList",
@@ -26,12 +28,12 @@ const itemList = {
     "@type": "ListItem",
     position: index + 1,
     name: post.title,
-    url: new URL(`/blog/${post.slug}/`, canonicalBase + "/").toString(),
+    url: new URL(blogPaths.post(post.slug), canonicalBase + "/").toString(),
   })),
 };
 const trail = siteTrail(
   homeCrumbLabel(await content.getChrome()),
-  { label: "Blog", href: "/blog/" },
+  { label: "Blog", href: blogPaths.index },
   { label: `#${label}`, href: path },
 );
 const crumbs = breadcrumbLd(trail, canonicalBase);
@@ -54,7 +56,7 @@ const crumbs = breadcrumbLd(trail, canonicalBase);
   </header>
 
   <div class="blog-shell blog-layout">
-    <PostGrid posts={posts} basePath={basePath} base="/blog" />
+    <PostGrid posts={posts} basePath={basePath} paths={blogPaths} />
   </div>
 </Layout>
 

package/apps/storefront/src/pages/llms.txt.ts

@@ -20,6 +20,7 @@ import {
   readMountedPublicationDiscoveryV1,
   rootOwnsDiscoveryPathV1,
 } from "@/lib/publication/mountedDiscovery.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 /** Collapse HTML/whitespace to a single trimmed line for a link description. */
 function oneLine(s: string | undefined, max = 140): string | undefined {
@@ -31,6 +32,7 @@ function oneLine(s: string | undefined, max = 140): string | undefined {
 
 export async function GET(context: APIContext): Promise<Response> {
   const { tot, tenant, canonicalBase, content, publicationTimestamp } = context.locals;
+  const blogPaths = collectionPathsV1(context.locals, "blog");
   const base = canonicalBase.replace(/\/$/, "");
 
   // Use the request-resolved ContentProvider (locals.content) so any published /
@@ -54,9 +56,9 @@ export async function GET(context: APIContext): Promise<Response> {
   const pages = index
     ? rootPages.filter((pg) => rootOwnsDiscoveryPathV1(index, `/${pg.slug}`))
     : rootPages;
-  const rootOwnsBlogIndex = !index || rootOwnsDiscoveryPathV1(index, "/blog/");
+  const rootOwnsBlogIndex = !index || rootOwnsDiscoveryPathV1(index, blogPaths.index);
   const blogPosts = index
-    ? rootBlogPosts.filter((post) => rootOwnsDiscoveryPathV1(index, `/blog/${post.slug}/`))
+    ? rootBlogPosts.filter((post) => rootOwnsDiscoveryPathV1(index, blogPaths.post(post.slug)))
     : rootBlogPosts;
   const mounted = index
     ? (await readMountedPublicationDiscoveryV1({ tenant, store: await readKv("TENANT_CACHE"), index }))
@@ -108,10 +110,10 @@ export async function GET(context: APIContext): Promise<Response> {
 
   if (blogPosts.length) {
     lines.push("## Blog");
-    if (rootOwnsBlogIndex) lines.push(`- [All articles](${base}/blog/)`);
+    if (rootOwnsBlogIndex) lines.push(`- [All articles](${base}${blogPaths.index})`);
     for (const post of blogPosts) {
       const desc = oneLine(post.description || post.excerpt);
-      lines.push(`- [${post.title}](${base}/blog/${post.slug}/)${desc ? `: ${desc}` : ""}`);
+      lines.push(`- [${post.title}](${base}${blogPaths.post(post.slug)})${desc ? `: ${desc}` : ""}`);
     }
     lines.push("");
   }

package/apps/storefront/src/pages/sitemap.xml.ts

@@ -24,6 +24,7 @@ import {
   readMountedPublicationDiscoveryV1,
   rootOwnsDiscoveryPathV1,
 } from "@/lib/publication/mountedDiscovery.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 interface SitemapUrl {
   loc: string;
@@ -43,6 +44,8 @@ function escapeXml(value: string): string {
 export async function GET(context: APIContext): Promise<Response> {
   const { tot, tenant, canonicalBase, content, features, publicationTimestamp } = context.locals;
   const base = canonicalBase.replace(/\/$/, "");
+  const blogPaths = collectionPathsV1(context.locals, "blog");
+  const buildPaths = collectionPathsV1(context.locals, "the-build");
 
   const urls: SitemapUrl[] = [{ loc: `${base}/` }];
 
@@ -85,7 +88,7 @@ export async function GET(context: APIContext): Promise<Response> {
 
   const blogPosts = await listBlogPosts(tenant.tenant_id, content, publicationTimestamp);
   if (blogPosts.length > 0) {
-    urls.push({ loc: `${base}/blog/` });
+    urls.push({ loc: `${base}${blogPaths.index}` });
     // Paginated pages (N≥2) — the static materializer discovers these new routes
     // straight off this list (withSitemapRoutes in scripts/publish/lib/routes.mjs),
     // so listing them here is what makes /blog/page/N/ exist in BOTH serving
@@ -93,9 +96,9 @@ export async function GET(context: APIContext): Promise<Response> {
     const blogSettings = await getBlogSettings(tenant.tenant_id, content);
     const { pageSize } = resolveBlogIndexCopy(blogSettings, tenant.displayName);
     const totalBlogPages = Math.max(1, Math.ceil(blogPosts.length / pageSize));
-    for (let n = 2; n <= totalBlogPages; n++) urls.push({ loc: `${base}/blog/page/${n}/` });
+    for (let n = 2; n <= totalBlogPages; n++) urls.push({ loc: `${base}${blogPaths.page(n)}` });
     for (const post of blogPosts) {
-      urls.push({ loc: `${base}/blog/${post.slug}/`, lastmod: post.modifiedAt || post.publishedAt });
+      urls.push({ loc: `${base}${blogPaths.post(post.slug)}`, lastmod: post.modifiedAt || post.publishedAt });
     }
     // Author archives (blog/author/[author].astro): one per distinct byline,
     // same source as the pages themselves so the sitemap never lists an
@@ -105,25 +108,25 @@ export async function GET(context: APIContext): Promise<Response> {
       ...new Set(blogPosts.map((post) => authorSlug(post.author)).filter(Boolean)),
     ].sort();
     for (const slug of authorSlugs) {
-      urls.push({ loc: `${base}/blog/author/${slug}/` });
+      urls.push({ loc: `${base}${blogPaths.author(slug)}` });
     }
     const categorySlugs = [...new Set(blogPosts.flatMap((post) => post.categories.map(categorySlug)).filter(Boolean))].sort();
     const tagSlugs = [...new Set(blogPosts.flatMap((post) => post.tags.map(categorySlug)).filter(Boolean))].sort();
-    for (const slug of categorySlugs) urls.push({ loc: `${base}/blog/category/${slug}/` });
-    for (const slug of tagSlugs) urls.push({ loc: `${base}/blog/tag/${slug}/` });
+    for (const slug of categorySlugs) urls.push({ loc: `${base}${blogPaths.category(slug)}` });
+    for (const slug of tagSlugs) urls.push({ loc: `${base}${blogPaths.tag(slug)}` });
   }
 
   const buildPosts = await listBuildPosts(tenant.tenant_id, { content, now: publicationTimestamp });
   if (buildPosts.length > 0) {
-    urls.push({ loc: `${base}/the-build/` });
+    urls.push({ loc: `${base}${buildPaths.index}` });
     // Paginated pages (N≥2), same reasoning as /blog/page/N/ above: the static
     // materializer discovers these new routes straight off this list.
     const buildSettings = await getTheBuildSettings(tenant.tenant_id, content);
     const { pageSize } = resolveTheBuildIndexCopy(buildSettings, tenant.displayName);
     const totalBuildPages = Math.max(1, Math.ceil(buildPosts.length / pageSize));
-    for (let n = 2; n <= totalBuildPages; n++) urls.push({ loc: `${base}/the-build/page/${n}/` });
+    for (let n = 2; n <= totalBuildPages; n++) urls.push({ loc: `${base}${buildPaths.page(n)}` });
     for (const post of buildPosts) {
-      urls.push({ loc: `${base}/the-build/${post.slug}/`, lastmod: post.modifiedAt || post.publishedAt });
+      urls.push({ loc: `${base}${buildPaths.post(post.slug)}`, lastmod: post.modifiedAt || post.publishedAt });
     }
   }
 

package/apps/storefront/src/pages/the-build/[slug].astro

@@ -14,6 +14,7 @@ import { homeCrumbLabel, siteTrail } from "@/lib/breadcrumbs.js";
 import { getTranslations } from "@/lib/blog/collection.js";
 import { buildAlternates } from "@/lib/seo/alternates.js";
 import { breadcrumbLd } from "@/lib/jsonld.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 // Same contract as blog/[slug].astro: the publication composition lifts this file into the space's
 // `routes.aliases`, so these redirects reach the CDN plane through the live pointer. The redirect
@@ -21,16 +22,17 @@ import { breadcrumbLd } from "@/lib/jsonld.js";
 export const MATERIALIZED_REDIRECT_SOURCE = "content/the-build/redirects.json";
 
 const { tenant, canonicalBase, basePath, content, publicationTimestamp } = Astro.locals;
+const buildPaths = collectionPathsV1(Astro.locals, "the-build");
 const slug = Astro.params.slug ?? "";
 const post = await getBuildPost(tenant.tenant_id, slug, { content, now: publicationTimestamp });
 if (!post) {
   const redirect = await resolveBuildRedirect(tenant.tenant_id, slug, content);
   // 308, matching the `redirect-308` alias contract the published plane serves.
-  if (redirect) return Astro.redirect(`${basePath}/the-build/${redirect}/`, 308);
+  if (redirect) return Astro.redirect(`${basePath}${buildPaths.post(redirect)}`, 308);
   return new Response(null, { status: 404 });
 }
 
-const canonical = new URL(`/the-build/${post.slug}/`, canonicalBase + "/").toString();
+const canonical = new URL(buildPaths.post(post.slug), canonicalBase + "/").toString();
 const presentation = resolveBlogPresentation(await getTheBuildSettings(tenant.tenant_id, content));
 // A post that names no author has no byline and no structured-data author.
 const author = bylineAuthor(post.author);
@@ -49,8 +51,8 @@ const articleLd = {
 };
 const trail = siteTrail(
   homeCrumbLabel(await content.getChrome()),
-  { label: "The Build", href: "/the-build/" },
-  { label: post.title, href: `/the-build/${post.slug}/` },
+  { label: "The Build", href: buildPaths.index },
+  { label: post.title, href: buildPaths.post(post.slug) },
 );
 const crumbs = breadcrumbLd(trail, canonicalBase);
 const share = shareLinks(presentation.share, {
@@ -58,7 +60,7 @@ const share = shareLinks(presentation.share, {
   title: post.title,
   image: post.featuredImage ? new URL(post.featuredImage.src, canonicalBase + "/").toString() : undefined,
 });
-const buildHref = `${basePath}/the-build/`;
+const buildHref = `${basePath}${buildPaths.index}`;
 
 // I2 — hreflang alternates + per-variant <html lang>. `getTranslations` returns
 // the live-visible variant set (self + siblings); `buildAlternates` yields [] for
@@ -69,7 +71,7 @@ const translations = await getTranslations(tenant.tenant_id, THE_BUILD.id, post.
   now: publicationTimestamp,
 });
 const alternates = buildAlternates(translations, (s) =>
-  new URL(`/the-build/${s}/`, canonicalBase + "/").toString(),
+  new URL(buildPaths.post(s), canonicalBase + "/").toString(),
 );
 const lang = alternates.length ? (post.inLanguage ?? "en") : undefined;
 ---
@@ -77,7 +79,7 @@ const lang = alternates.length ? (post.inLanguage ?? "en") : undefined;
 <Layout
   title={post.seoTitle || post.title}
   description={post.description}
-  path={`/the-build/${post.slug}/`}
+  path={buildPaths.post(post.slug)}
   ogType="article"
   ogImage={post.featuredImage?.src}
   noindex={post.status === "unlisted"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenoftrust/storefront-runner",
-  "version": "2.4.23",
+  "version": "2.4.24",
   "license": "SEE LICENSE IN LICENSE",
   "description": "World-shareable storefront runner: multi-tenant renderer on Astro/Cloudflare. No control plane.",
   "packageManager": "pnpm@11.9.0",

package/packages/public-runtime/schemas/publication-space/v1/manifest.schema.json

@@ -77,6 +77,14 @@
               }
             ]
           }
+        },
+        "collections": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "blog": { "$ref": "#/$defs/collectionBase" },
+            "the-build": { "$ref": "#/$defs/collectionBase" }
+          }
         }
       }
     },
@@ -167,6 +175,10 @@
     }
   ],
   "$defs": {
+    "collectionBase": {
+      "type": "string",
+      "pattern": "^(?:[a-z0-9]+(?:-[a-z0-9]+)*(?:/[a-z0-9]+(?:-[a-z0-9]+)*)*)?$"
+    },
     "identifier": {
       "type": "string",
       "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,126}[a-z0-9])?$"

package/packages/public-runtime/src/blog-visibility.d.mts

@@ -7,3 +7,23 @@ export declare function exactPublicationTimestamp(value: unknown): string | null
 export declare function publicationAggregateClockV1(spaces: unknown): string | null;
 export declare function isBlogPostVisibleOnLive(post: BlogVisibilityInput, now?: string | null): boolean;
 export declare function isBlogPostListableOnLive(post: BlogVisibilityInput, now?: string | null): boolean;
+
+export type PublicationCollectionV1 = "blog" | "the-build";
+export declare const PUBLICATION_COLLECTIONS_V1: readonly PublicationCollectionV1[];
+export declare const DEFAULT_COLLECTION_PAGE_SIZE_V1: number;
+export type PublicationCollectionRouteV1 =
+  | { kind: "index" }
+  | { kind: "page"; page: number }
+  | { kind: "post"; slug: string }
+  | { kind: "author" | "category" | "tag"; slug: string }
+  | { kind: "rss" };
+export declare function publicationCollectionBaseV1(
+  manifest: { routes?: { collections?: Partial<Record<PublicationCollectionV1, string>> } } | null | undefined,
+  collection: PublicationCollectionV1,
+): string;
+export declare function publicationCollectionPathV1(mount: string, base: string, route: PublicationCollectionRouteV1): string;
+export declare function publicationCollectionOfV1(
+  manifest: { routes?: { collections?: Partial<Record<PublicationCollectionV1, string>> } } | null | undefined,
+  contentPath: string,
+): { collection: PublicationCollectionV1; rest: string } | null;
+export declare function isPublicationCollectionBaseV1(value: unknown): value is string;

package/packages/public-runtime/src/blog-visibility.mjs

@@ -47,3 +47,90 @@ export function isBlogPostListableOnLive(post, now) {
   const status = post.status ?? "published";
   return status === "published" || scheduledIsDue({ ...post, status }, now);
 }
+
+/**
+ * A space's post collections: `blog` and `the-build`. Each serves at a base path inside its
+ * space's mount. The base defaults to the collection's own name; a space may declare another,
+ * or `""` for the mount root (`routes.collections` on the publication-space manifest).
+ */
+export const PUBLICATION_COLLECTIONS_V1 = Object.freeze(/** @type {const} */ (["blog", "the-build"]));
+
+/** Posts per collection index page when a collection declares no valid `pageSize`. */
+export const DEFAULT_COLLECTION_PAGE_SIZE_V1 = 12;
+
+const SEGMENT = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+
+/** @param {string} value */
+function segments(value) {
+  return value.split("/").filter(Boolean);
+}
+
+/**
+ * The base path a space declares for `collection`, or the collection's default.
+ * @param {{routes?: {collections?: Record<string, string>}} | null | undefined} manifest
+ * @param {"blog" | "the-build"} collection
+ * @returns {string}
+ */
+export function publicationCollectionBaseV1(manifest, collection) {
+  const declared = manifest?.routes?.collections?.[collection];
+  return typeof declared === "string" ? declared : collection;
+}
+
+/**
+ * THE constructor of every collection URL: a tenant-relative canonical path, with the trailing
+ * slash the collection pages declare as their canonical (`rss` excepted). Every route builder,
+ * discovery emitter and renderer builds collection paths only through this.
+ * @param {string} mount the space's canonical mount (`/` for the root space)
+ * @param {string} base the collection's base path inside the mount (`""` for the mount root)
+ * @param {{kind: "index"} | {kind: "page", page: number} | {kind: "post", slug: string} |
+ *   {kind: "author" | "category" | "tag", slug: string} | {kind: "rss"}} route
+ * @returns {string}
+ */
+export function publicationCollectionPathV1(mount, base, route) {
+  const parts = [...segments(mount), ...segments(base)];
+  if (route.kind === "page") {
+    if (!Number.isSafeInteger(route.page) || route.page < 1) throw new Error("collection page is malformed");
+    if (route.page > 1) parts.push("page", String(route.page));
+  } else if (route.kind === "post" || route.kind === "author" || route.kind === "category" || route.kind === "tag") {
+    if (typeof route.slug !== "string" || !route.slug || route.slug.includes("/") || route.slug.includes("..")) {
+      throw new Error("collection slug is malformed");
+    }
+    if (route.kind !== "post") parts.push(route.kind);
+    parts.push(route.slug);
+  } else if (route.kind === "rss") {
+    return `/${[...parts, "rss.xml"].join("/")}`;
+  } else if (route.kind !== "index") {
+    throw new Error("collection route kind is unknown");
+  }
+  return parts.length ? `/${parts.join("/")}/` : "/";
+}
+
+/**
+ * Which collection a mount-relative content path belongs to, and the path inside it: the
+ * declared base with the longest match wins, so a collection at the mount root (`""`) owns only
+ * what no other collection claims. Null when the path is in no collection.
+ * @param {{routes?: {collections?: Record<string, string>}} | null | undefined} manifest
+ * @param {string} contentPath mount-relative, starting with `/`
+ * @returns {{collection: "blog" | "the-build", rest: string} | null}
+ */
+export function publicationCollectionOfV1(manifest, contentPath) {
+  const path = segments(contentPath);
+  /** @type {{collection: "blog" | "the-build", rest: string, depth: number} | null} */
+  let best = null;
+  for (const collection of PUBLICATION_COLLECTIONS_V1) {
+    const base = segments(publicationCollectionBaseV1(manifest, collection));
+    if (base.length > path.length || base.some((part, index) => part !== path[index])) continue;
+    if (!best || base.length > best.depth) {
+      best = { collection, rest: path.slice(base.length).map((part) => `/${part}`).join(""), depth: base.length };
+    }
+  }
+  return best ? { collection: best.collection, rest: best.rest } : null;
+}
+
+/**
+ * Validate a declared collection base: `""` (the mount root) or `/`-separated lowercase segments.
+ * @param {unknown} value
+ */
+export function isPublicationCollectionBaseV1(value) {
+  return typeof value === "string" && (value === "" || value.split("/").every((part) => SEGMENT.test(part)));
+}

package/packages/public-runtime/src/publication-routing.ts

@@ -22,6 +22,7 @@ import {
   type RouteTierIndexV1,
 } from "./route-tier.js";
 import type { PublicationSpaceManifestV1 } from "./publication-space.js";
+import { publicationCollectionOfV1 } from "./blog-visibility.mjs";
 
 export const PUBLICATION_ROUTE_PLAN_VERSION = 1 as const;
 
@@ -42,8 +43,14 @@ export interface PublicationRouteRenderPlanV1 {
   requestPath: string;
   /** Route relative to the selected publication source. Always absolute. */
   contentPath: string;
-  /** Canonical tenant-relative route used by links and Astro dispatch. */
+  /** Canonical tenant-relative route used by links. */
   canonicalPath: string;
+  /**
+   * The platform route Astro dispatches: a path in one of the space's declared collections maps
+   * to that collection's platform route (`/blog/...`, `/the-build/...`), whatever its base inside
+   * the mount; any other path dispatches at its canonical path.
+   */
+  renderPath: string;
   assetNamespace: string;
 }
 
@@ -91,6 +98,12 @@ function appendSuffix(mount: string, suffix: string): string {
   return `${mount}${suffix}`;
 }
 
+/** The platform collection route for a mount-relative path, or null when it is in no collection. */
+function collectionRenderPath(manifest: PublicationSpaceManifestV1, contentPath: string): string | null {
+  const match = publicationCollectionOfV1(manifest, contentPath);
+  return match ? `/${match.collection}${match.rest}` : null;
+}
+
 /** Resolve one request through the already-compiled tenant mount authority. */
 export function resolvePublicationRoutePlanV1(
   index: RouteTierIndexV1,
@@ -143,6 +156,7 @@ export function resolvePublicationRoutePlanV1(
     requestPath: route.path,
     contentPath: suffix || "/",
     canonicalPath: appendSuffix(mount.canonicalMount, suffix),
+    renderPath: collectionRenderPath(manifest, suffix || "/") ?? appendSuffix(mount.canonicalMount, suffix),
     assetNamespace: manifest.assets.namespace,
   };
 }

package/packages/public-runtime/src/publication-space.ts

@@ -6,6 +6,12 @@
  * normalized mounts emitted here rather than decode or canonicalize paths again.
  */
 import type { TenantConfig } from "./tenant.js";
+import {
+  isPublicationCollectionBaseV1,
+  PUBLICATION_COLLECTIONS_V1,
+  publicationCollectionBaseV1,
+  type PublicationCollectionV1,
+} from "./blog-visibility.mjs";
 import {
   ANNOTATION_KEYS,
   type ContractResult,
@@ -115,6 +121,12 @@ export interface PublicationSpaceManifestV1 {
   routes: {
     canonicalMount: string;
     aliases?: PublicationSpaceAliasV1[];
+    /**
+     * Base path of each post collection inside the mount. Absent means the collection's own name
+     * (`blog`, `the-build`); `""` serves it at the mount root. Every collection URL is built from
+     * it by `publicationCollectionPathV1`.
+     */
+    collections?: Partial<Record<PublicationCollectionV1, string>>;
   };
   visibility: PublicationSpaceVisibilityV1;
   authorization:
@@ -450,6 +462,44 @@ function validateRenderer(
   return contractVersion && themeContractVersion ? { contractVersion, themeContractVersion } : undefined;
 }
 
+/**
+ * A space's declared collection bases: known collections only, each `""` or lowercase segments,
+ * no two collections sharing a base, and none at the site root (the root space's home owns `/`).
+ */
+function validateCollections(
+  raw: unknown,
+  canonicalMount: string | undefined,
+  v: Violations,
+  path: string,
+): PublicationSpaceManifestV1["routes"]["collections"] {
+  if (raw === undefined) return undefined;
+  const collections = reqObject(raw, v, path);
+  if (!collections) return undefined;
+  rejectPublicationUnknownKeys(collections, [...PUBLICATION_COLLECTIONS_V1], v, path);
+  const out: Partial<Record<PublicationCollectionV1, string>> = {};
+  for (const collection of PUBLICATION_COLLECTIONS_V1) {
+    const value = collections[collection];
+    if (value === undefined) continue;
+    if (!isPublicationCollectionBaseV1(value)) {
+      v.add(`${path}.${collection}`, "publication_collection_base_malformed",
+        "A collection base is empty (the mount root) or lowercase path segments.");
+      continue;
+    }
+    if (value === "" && canonicalMount === "/") {
+      v.add(`${path}.${collection}`, "publication_collection_at_site_root",
+        "A collection cannot take the site root; the root space's home serves it.");
+      continue;
+    }
+    out[collection] = value;
+  }
+  const bases = PUBLICATION_COLLECTIONS_V1.map((collection) => publicationCollectionBaseV1({ routes: { collections: out } },
+    collection));
+  if (new Set(bases).size !== bases.length) {
+    v.add(path, "publication_collection_base_conflict", "Two collections cannot share a base path.");
+  }
+  return Object.keys(out).length ? out : undefined;
+}
+
 /** Validate, close, and normalize one serialized publication-space manifest. */
 export function validatePublicationSpaceManifestV1(raw: unknown): ContractResult<PublicationSpaceManifestV1> {
   const v = new Violations();
@@ -468,8 +518,9 @@ export function validatePublicationSpaceManifestV1(raw: unknown): ContractResult
   const routes = reqObject(root["routes"], v, "routes");
   let canonicalMount: string | undefined;
   let aliases: PublicationSpaceAliasV1[] | undefined;
+  let collections: PublicationSpaceManifestV1["routes"]["collections"];
   if (routes) {
-    rejectPublicationUnknownKeys(routes, ["canonicalMount", "aliases"], v, "routes");
+    rejectPublicationUnknownKeys(routes, ["canonicalMount", "aliases", "collections"], v, "routes");
     const rawMount = reqString(routes, "canonicalMount", v, "routes");
     canonicalMount = rawMount
       ? append(v, "routes.canonicalMount", normalizePublicationPath(rawMount, { mode: "mount" }))
@@ -478,6 +529,7 @@ export function validatePublicationSpaceManifestV1(raw: unknown): ContractResult
       v.add("routes.canonicalMount", "publication_reserved_mount", "Canonical mount is platform-reserved.");
     }
     aliases = validateAliases(routes["aliases"], canonicalMount, v, "routes.aliases");
+    collections = validateCollections(routes["collections"], canonicalMount, v, "routes.collections");
   }
   const visibility = reqEnum<PublicationSpaceVisibilityV1>(root, "visibility", ["public", "internal"], v, "");
   const authorization = validateAuthorization(root["authorization"], v, "authorization");
@@ -525,7 +577,11 @@ export function validatePublicationSpaceManifestV1(raw: unknown): ContractResult
       id,
       tenant,
       source,
-      routes: aliases === undefined ? { canonicalMount } : { canonicalMount, aliases },
+      routes: {
+        canonicalMount,
+        ...(aliases === undefined ? {} : { aliases }),
+        ...(collections === undefined ? {} : { collections }),
+      },
       visibility,
       authorization,
       discovery,
@@ -787,6 +843,18 @@ export function validatePublicationSpaceRegistryV1(
       );
     }
   }
+  // Precedence: a mount owns every path under it. An alias one space declares inside ANOTHER
+  // space's mount (the root's `/blog/page` once a space is mounted at `/blog`) is refused, so no
+  // route-tier or edge redirect can shadow the mounted space's own pages.
+  for (const alias of entries.filter((entry) => entry.kind === "alias")) {
+    const owner = entries.find((entry) => entry.kind === "canonical" && entry.tenant === alias.tenant &&
+      entry.spaceId !== alias.spaceId && entry.mount !== "/" &&
+      (alias.mount === entry.mount || alias.mount.startsWith(`${entry.mount}/`)));
+    if (owner) {
+      addRegistryViolation(violations, `spaces.${alias.spaceId}.routes.aliases`, "publication_alias_under_mount",
+        `Alias ${alias.mount} lies under the mount ${owner.mount} that space ${owner.spaceId} owns.`);
+    }
+  }
   detectAliasLoops(entries, violations);
   if (violations.length > 0) return { ok: false, violations };