create-ailk 0.5.0 → 0.6.1

package/templates/apps/mcp/src/lib/stripe-tax-signal.ts

@@ -0,0 +1,59 @@
+/**
+ * stripe-tax-signal — reads `commerce.stripe_tax` from project.yaml (#5949 D4).
+ *
+ * The declaration the audit's `tax-code-when-stripe-tax` rule grades against:
+ * "this site's Stripe account has Stripe Tax enabled, so every priced page owes
+ * a `stripe.taxCode`". Declarative only — nothing here calls Stripe, and no
+ * license claim is read.
+ *
+ * The actual YAML read + field extraction delegates to `loadCommerceConfig`
+ * (`@working-theory/aeo`, exported from the package root since #6012) — this
+ * file's own job is the directory PROBE: apps run from their own dirs in
+ * dev/build (`apps/mcp/`) but from repo root in some test setups, mirroring
+ * `apps/mcp/src/lib/locales.ts`'s own project.yaml probe (the same three
+ * candidates it walks; `apps/*` may not import `apps/*`, so a shared probe
+ * helper isn't an option either — only the parse/extract logic was the
+ * duplicate #6012 removes).
+ *
+ * NEVER throws. An unreadable, absent, malformed or non-boolean value all
+ * resolve to `undefined` — the site declares no Stripe Tax posture, and the
+ * rule passes saying so.
+ */
+
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+import { loadCommerceConfig } from "@working-theory/aeo";
+
+/**
+ * Probe likely locations for project.yaml. Apps run from their own dirs in
+ * dev/build (`apps/mcp/`) but from repo root in some test setups — the same
+ * three candidates `locales.ts` walks.
+ */
+function resolveProjectYamlPath(cwd: string): string {
+  const candidates = [
+    join(cwd, "project.yaml"),
+    join(cwd, "..", "project.yaml"),
+    join(cwd, "..", "..", "project.yaml"),
+  ];
+  for (const candidate of candidates) {
+    try {
+      readFileSync(candidate, "utf8");
+      return candidate;
+    } catch {
+      // continue
+    }
+  }
+  return candidates[0] ?? join(cwd, "project.yaml");
+}
+
+/**
+ * `commerce.stripe_tax` at `projectRoot` (default: the process cwd), or
+ * `undefined` when the site declares none.
+ */
+export function readStripeTaxSignal(
+  projectRoot: string = process.cwd(),
+): boolean | undefined {
+  const resolvedPath = resolveProjectYamlPath(projectRoot);
+  return loadCommerceConfig(dirname(resolvedPath)).stripeTaxEnabled;
+}

package/templates/apps/mcp/src/server.ts

@@ -13,9 +13,13 @@
  */
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { getMcpToolRegistrations, OSS_DISABLED_TOOLS } from "@working-theory/metadata";
+import {
+  getMcpToolRegistrations,
+  OSS_DISABLED_TOOLS,
+} from "@working-theory/metadata";
 
 import { isModuleEnabled } from "./config/modules.js";
+import { mcpCommerceClaim } from "./lib/commerce-claim.js";
 import { ailkAudit } from "./tools/audit.js";
 import { ailkCaptureLead } from "./tools/capture_lead.js";
 import { ailkCreateProject } from "./tools/create_project.js";
@@ -107,14 +111,6 @@ const MODULE_TOOL_ENTRIES: Record<
     specifier: "./tools/create_booking.js",
     exportName: "ailkCreateBooking",
   },
-  // D14a Stage 1 Unit C (#55): Paid-tier content write surface. Handlers
-  // self-gate via requirePaidTier and return canonical error bodies (no throw)
-  // for license / validation / conflict / not-found cases — see
-  // apps/mcp/src/lib/errors.ts. Catalog entries carry tier: "pro" so agents
-  // see the gating before invoking via list_tools.
-  create_page: { specifier: "./tools/create_page.js", exportName: "ailkCreatePage" },
-  update_page: { specifier: "./tools/update_page.js", exportName: "ailkUpdatePage" },
-  delete_page: { specifier: "./tools/delete_page.js", exportName: "ailkDeletePage" },
   // D-48 signal-collectors — the flow engine's MCP twins of GET
   // /v1/flows/:slug and POST /v1/flows/:slug/steps. Anonymous, identity-blind;
   // free-anonymous status is now module-gated rather than unconditional.
@@ -140,7 +136,10 @@ async function resolveHandler(name: string): Promise<ToolHandler> {
   if (!entry) {
     throw new Error(`MCP catalog drift: no handler for tool '${name}'`);
   }
-  const mod = (await import(entry.specifier)) as Record<string, ToolHandler | undefined>;
+  const mod = (await import(entry.specifier)) as Record<
+    string,
+    ToolHandler | undefined
+  >;
   const fn = mod[entry.exportName];
   if (!fn) {
     throw new Error(
@@ -163,47 +162,72 @@ export interface RegisteredToolDescriptor {
 
 /**
  * Whether a catalog registration entry should register on this build/boot —
- * the OSS-disabled filter (static per-name set) AND the module-presence
- * filter (S1, #5088): a tool tagged with `module` (e.g. `create_booking`
- * carrying `module: "scheduling"`) registers only when
- * {@link isModuleEnabled} says its module is present, the same way its
- * `apps/api` HTTP route is module-conditional in `server.ts` there — so a
- * tool and its route appear or vanish together, holding API↔MCP parity.
+ * three filters:
+ *
+ *  1. the OSS-disabled filter (static per-name set; empty since #5971);
+ *  2. the module-presence filter (S1, #5088): a tool tagged with `module`
+ *     (e.g. `create_booking` carrying `module: "scheduling"`) registers only
+ *     when {@link isModuleEnabled} says its module is present, the same way
+ *     its `apps/api` HTTP route is module-conditional in `server.ts` there —
+ *     so a tool and its route appear or vanish together, holding API↔MCP
+ *     parity;
+ *  3. the ADD-ON CLAIM filter (#5971): a tool tagged `addon: "commerce"`
+ *     registers only on a deployment that positively holds the `commerce`
+ *     licence claim. Deliberately NOT the module filter — D-64/#5796 moved
+ *     the commerce primitives off module gating precisely so that adding
+ *     commerce to a live site is a licence change that lands no files on its
+ *     repo, and "keyless site" / "keyed site" name the LICENCE, not an env
+ *     allowlist.
+ *
+ * The claim is the boot-memoised `mcpCommerceClaim()`, so this stays
+ * synchronous — see `lib/commerce-claim.ts`.
  */
-function shouldRegister(reg: { name: string; module?: string }): boolean {
+function shouldRegister(reg: {
+  name: string;
+  module?: string;
+  addon?: "commerce";
+}): boolean {
   if (OSS_DISABLED_TOOLS.has(reg.name)) return false;
   if (reg.module && !isModuleEnabled(reg.module)) return false;
+  if (reg.addon === "commerce" && mcpCommerceClaim() !== "claimed")
+    return false;
   return true;
 }
 
+/**
+ * The {@link McpCatalogOptions} this boot's claims imply — passed to
+ * `getMcpToolRegistrations()` so the upstream catalog filter and
+ * {@link shouldRegister} agree by construction rather than by coincidence.
+ */
+function catalogOptionsForThisBoot(): { addons: { commerce: boolean } } {
+  return { addons: { commerce: mcpCommerceClaim() === "claimed" } };
+}
+
 /**
  * Returns the list of tools that {@link createMcpServer} will register, after
- * the OSS catalog filter ({@link OSS_DISABLED_TOOLS}) and the module-presence
- * filter are applied. Pure — no server instance is constructed.
+ * the OSS catalog filter ({@link OSS_DISABLED_TOOLS}), the module-presence
+ * filter and the add-on claim filter are applied. Pure — no server instance
+ * is constructed.
  *
- * Consumed by `apps/mcp/__tests__/purchase-disabled.test.ts` to assert that
- * disabled tools are absent from the registered catalog. If a future change
- * removes a name from `OSS_DISABLED_TOOLS` without satisfying the Phase 3
- * re-enable criteria, that test fails RED.
+ * Consumed by `apps/mcp/__tests__/purchase-disabled.test.ts`, which drives
+ * both halves of the claim matrix: `start_purchase` absent on a keyless boot,
+ * present on a claimed one.
  */
 export function listRegisteredTools(): RegisteredToolDescriptor[] {
-  return getMcpToolRegistrations()
+  return getMcpToolRegistrations(catalogOptionsForThisBoot())
     .filter(shouldRegister)
     .map((reg) => ({ name: reg.name, description: reg.description }));
 }
 
 /**
  * Creates a configured McpServer with all AILK tools registered, less any
- * tool name in {@link OSS_DISABLED_TOOLS} and less any tool whose `module`
- * is not enabled on this build (S1, #5088; see {@link shouldRegister}). The
- * disabled filter is applied defensively here even though the upstream
- * `getMcpToolRegistrations()` already excludes them — a belt-and-braces
- * guard so a future regression in the metadata package can't accidentally
- * re-register a disabled tool.
- *
- * Re-enable criteria for each disabled tool live at
- * `docs/internal/roadmaps/phase-3-readiness.md`. S15a (issue #610) is the
- * source of the disabled-tool filter.
+ * tool name in {@link OSS_DISABLED_TOOLS}, less any tool whose `module` is
+ * not enabled on this build (S1, #5088), and less any `addon`-tagged tool
+ * whose claim this deployment does not hold (#5971) — see
+ * {@link shouldRegister}. Every filter is applied defensively here even
+ * though the upstream `getMcpToolRegistrations()` already excludes the same
+ * entries: a belt-and-braces guard so a regression in the metadata package
+ * can't accidentally register something this boot should not serve.
  */
 export function createMcpServer(): McpServer {
   const server = new McpServer({
@@ -211,7 +235,7 @@ export function createMcpServer(): McpServer {
     version: "0.1.0",
   });
 
-  for (const reg of getMcpToolRegistrations()) {
+  for (const reg of getMcpToolRegistrations(catalogOptionsForThisBoot())) {
     if (!shouldRegister(reg)) {
       continue;
     }

package/templates/apps/mcp/src/tools/audit.ts

@@ -26,7 +26,10 @@ import {
   entityMarkup,
   faqHowtoIncentive,
   jsonldValidity,
+  offerOnPricedPage,
+  policiesPresent,
   schemaCoverage,
+  taxCodeWhenStripeTax,
   type Rule,
 } from "@working-theory/aeo";
 import {
@@ -45,8 +48,21 @@ export { auditInputSchema, auditOutputSchema };
 export type { AuditInput, AuditOutput };
 
 /**
- * Canonical rule set — mirrors packages/aeo/src/cli/index.ts RULES array.
- * Imported from @working-theory/aeo public API; must not be re-implemented here.
+ * The MCP audit's rule set. Imported from the @working-theory/aeo public API;
+ * must not be re-implemented here.
+ *
+ * It is NOT identical to `packages/aeo/src/cli/index.ts`'s RULES array, and
+ * this comment used to claim it was. The two differ by exactly one member:
+ * the CLI carries `schemaCorrectness` (10 rules) and this set does not
+ * (9 rules). Everything else — including the two `always-*` example rules —
+ * is shared.
+ *
+ * The cause is mechanical, not a choice: `packages/aeo/src/index.ts` — the
+ * package's PUBLIC barrel — does not re-export `schemaCorrectness`, while
+ * `rules/index.ts` (the internal barrel the CLI imports from) exports all of
+ * them. A rule absent from the public barrel is unreachable from any app.
+ * Closing that gap would change this tool's `score` on every page, which is
+ * why #5949 left it alone; it is recorded as that spec's residual 1.
  */
 const RULES: Rule[] = [
   alwaysPasses,
@@ -55,6 +71,9 @@ const RULES: Rule[] = [
   jsonldValidity,
   faqHowtoIncentive,
   entityMarkup,
+  policiesPresent,
+  offerOnPricedPage,
+  taxCodeWhenStripeTax,
 ];
 
 /**
@@ -62,10 +81,14 @@ const RULES: Rule[] = [
  *
  * Accepts an optional `contentRoot` override for testing. When omitted,
  * resolves the content root relative to cwd (supports ESM runtime).
+ *
+ * `projectRoot` is the matching seam for the project.yaml the readiness rules'
+ * Stripe-Tax signal is read from (#5949 D9); it likewise defaults to cwd.
  */
 export async function ailkAudit(
   input: AuditInput,
   contentRoot?: string,
+  projectRoot?: string,
 ): Promise<AuditOutput> {
   auditInputSchema.parse(input);
 
@@ -75,6 +98,7 @@ export async function ailkAudit(
   const auditInput = await buildSinglePageAuditInput(
     input as unknown as SinglePageInput,
     contentRoot,
+    projectRoot,
   );
   const report = runAudit(auditInput, RULES);
 

package/templates/apps/mcp/src/tools/get_business_hours.ts

@@ -1,7 +1,8 @@
 /**
  * get_business_hours — returns business hours from LocalBusiness structured data.
  *
- * Pure read: imports the MDX adapter from @working-theory/content-adapters (ADR 0011).
+ * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
+ * resolver seam (#5805, ADR 0011), MDX by default.
  * Resolves a page by slug (default: "home") and extracts LocalBusiness schema.
  * Returns null when the page is not found or has no openingHoursSpecification.
  *
@@ -16,7 +17,6 @@
 
 import { join } from "node:path";
 
-import { createMdxAdapter } from "@working-theory/content-adapters";
 import {
   getBusinessHoursInputSchema,
   getBusinessHoursOutputSchema,
@@ -24,6 +24,7 @@ import {
   type GetBusinessHoursOutput,
 } from "@working-theory/validation";
 
+import { getMcpContentAdapter } from "../lib/content-adapter.js";
 import { resolveLocale } from "../lib/resolve-locale.js";
 
 export { getBusinessHoursInputSchema, getBusinessHoursOutputSchema };
@@ -45,7 +46,7 @@ export async function ailkGetBusinessHours(
 
   const root = contentRoot ?? join(process.cwd(), "content");
   const locale = resolveLocale(input.locale);
-  const adapter = createMdxAdapter({ contentRoot: root, defaultLocale: locale });
+  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
 
   const slug = input.slug ?? DEFAULT_SLUG;
   const data = await adapter.extractStructuredData("LocalBusiness", slug, locale);

package/templates/apps/mcp/src/tools/get_faq.ts

@@ -1,7 +1,8 @@
 /**
  * get_faq — returns FAQ question/answer pairs from FAQPage structured data.
  *
- * Pure read: imports the MDX adapter from @working-theory/content-adapters (ADR 0011).
+ * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
+ * resolver seam (#5805, ADR 0011), MDX by default.
  * Resolves a page by slug (default: "faq") and extracts FAQPage schema.
  * Returns null when the page is not found or has no mainEntity questions.
  *
@@ -16,7 +17,6 @@
 
 import { join } from "node:path";
 
-import { createMdxAdapter } from "@working-theory/content-adapters";
 import {
   getFaqInputSchema,
   getFaqOutputSchema,
@@ -24,6 +24,7 @@ import {
   type GetFaqOutput,
 } from "@working-theory/validation";
 
+import { getMcpContentAdapter } from "../lib/content-adapter.js";
 import { resolveLocale } from "../lib/resolve-locale.js";
 
 export { getFaqInputSchema, getFaqOutputSchema };
@@ -45,7 +46,7 @@ export async function ailkGetFaq(
 
   const root = contentRoot ?? join(process.cwd(), "content");
   const locale = resolveLocale(input.locale);
-  const adapter = createMdxAdapter({ contentRoot: root, defaultLocale: locale });
+  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
 
   const slug = input.slug ?? DEFAULT_SLUG;
   const data = await adapter.extractStructuredData("FAQPage", slug, locale);

package/templates/apps/mcp/src/tools/get_locations.ts

@@ -1,7 +1,8 @@
 /**
  * get_locations — returns all Place locations from structured data site-wide.
  *
- * Pure read: imports the MDX adapter from @working-theory/content-adapters (ADR 0011).
+ * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
+ * resolver seam (#5805, ADR 0011), MDX by default.
  * Lists all pages of type "Place" and extracts Place schema from each.
  * Returns an empty array when no Place pages exist.
  *
@@ -16,7 +17,7 @@
 
 import { join } from "node:path";
 
-import { createMdxAdapter, SCHEMA_ORG_TYPES } from "@working-theory/content-adapters";
+import { SCHEMA_ORG_TYPES } from "@working-theory/content-adapters";
 import {
   getLocationsInputSchema,
   getLocationsOutputSchema,
@@ -24,6 +25,7 @@ import {
   type GetLocationsOutput,
 } from "@working-theory/validation";
 
+import { getMcpContentAdapter } from "../lib/content-adapter.js";
 import { resolveLocale } from "../lib/resolve-locale.js";
 
 export { getLocationsInputSchema, getLocationsOutputSchema };
@@ -43,7 +45,7 @@ export async function ailkGetLocations(
 
   const root = contentRoot ?? join(process.cwd(), "content");
   const locale = resolveLocale(input.locale);
-  const adapter = createMdxAdapter({ contentRoot: root, defaultLocale: locale });
+  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
 
   // Place is not a page-level SchemaOrgType, so we iterate all types to find
   // pages whose schema field has Place structured data.

package/templates/apps/mcp/src/tools/get_offerings.ts

@@ -1,7 +1,8 @@
 /**
  * get_offerings — returns Services and/or Products as a unified offerings array.
  *
- * Pure read: imports the MDX adapter from @working-theory/content-adapters (ADR 0011).
+ * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
+ * resolver seam (#5805, ADR 0011), MDX by default.
  * Lists pages of type "Service" and/or "Product" and shapes them into a
  * unified offerings array. Optionally filtered by type.
  *
@@ -9,14 +10,20 @@
  * project's allowlist; invalid or unknown values silently fall back to the
  * default locale (AC-i18n-07). Lists are locale-scoped.
  *
+ * The offering fields (#5838) — `provider`, `categories`, `price` and
+ * `priceCurrency` — come off the page's own frontmatter, the same shape the
+ * listing card renders from. `price` and `priceCurrency` are `null` (never a
+ * fabricated zero) for a listing that declares no price, and `categories` is
+ * `[]` for one that is untagged.
+ *
  * Input:  { type?: 'service' | 'product', locale?: string }
- * Output: { offerings: Array<{ name, description, category?, image? }> }
+ * Output: { offerings: Array<{ name, description, category?, image?, provider, categories, price, priceCurrency }> }
  * Session/scope: none — read-only public content.
  */
 
 import { join } from "node:path";
 
-import { createMdxAdapter, type SchemaOrgType } from "@working-theory/content-adapters";
+import { type SchemaOrgType } from "@working-theory/content-adapters";
 import {
   getOfferingsInputSchema,
   getOfferingsOutputSchema,
@@ -24,6 +31,7 @@ import {
   type GetOfferingsOutput,
 } from "@working-theory/validation";
 
+import { getMcpContentAdapter } from "../lib/content-adapter.js";
 import { resolveLocale } from "../lib/resolve-locale.js";
 
 export { getOfferingsInputSchema, getOfferingsOutputSchema };
@@ -43,7 +51,7 @@ export async function ailkGetOfferings(
 
   const root = contentRoot ?? join(process.cwd(), "content");
   const locale = resolveLocale(input.locale);
-  const adapter = createMdxAdapter({ contentRoot: root, defaultLocale: locale });
+  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
 
   const typesToFetch: SchemaOrgType[] = [];
   if (!input.type || input.type === "service") typesToFetch.push("Service");
@@ -60,6 +68,10 @@ export async function ailkGetOfferings(
       description: page.description,
       category: page.schema?.["category"] as string | undefined,
       image: page.image,
+      provider: page.provider ?? null,
+      categories: page.categories ?? [],
+      price: page.price ?? null,
+      priceCurrency: page.priceCurrency ?? null,
     }));
 
   return getOfferingsOutputSchema.parse({ offerings });

package/templates/apps/mcp/src/tools/get_pricing.ts

@@ -1,7 +1,8 @@
 /**
  * get_pricing — returns pricing tiers from Offer structured data.
  *
- * Pure read: imports the MDX adapter from @working-theory/content-adapters (ADR 0011).
+ * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
+ * resolver seam (#5805, ADR 0011), MDX by default.
  * Resolves a page by slug (default: "pricing") and extracts Offer schema.
  * Returns null when the page is not found or has no offer data.
  *
@@ -9,6 +10,12 @@
  * project's allowlist; invalid or unknown values silently fall back to the
  * default locale (AC-i18n-07).
  *
+ * Fallback (#5838): when the page authors no `offers` in its `schema`, the
+ * offering fields on its own frontmatter answer instead — a listing that
+ * declares `price` + `priceCurrency` yields one tier named for the page. A
+ * listing with neither an authored offer nor a price still returns `null`: no
+ * price means no tier, never a fabricated zero.
+ *
  * Input:  { slug?: string, locale?: string }
  * Output: { tiers: Array<{ name, price, priceCurrency, description? }> } | null
  * Session/scope: none — read-only public content.
@@ -16,7 +23,6 @@
 
 import { join } from "node:path";
 
-import { createMdxAdapter } from "@working-theory/content-adapters";
 import {
   getPricingInputSchema,
   getPricingOutputSchema,
@@ -24,6 +30,7 @@ import {
   type GetPricingOutput,
 } from "@working-theory/validation";
 
+import { getMcpContentAdapter } from "../lib/content-adapter.js";
 import { resolveLocale } from "../lib/resolve-locale.js";
 
 export { getPricingInputSchema, getPricingOutputSchema };
@@ -45,13 +52,12 @@ export async function ailkGetPricing(
 
   const root = contentRoot ?? join(process.cwd(), "content");
   const locale = resolveLocale(input.locale);
-  const adapter = createMdxAdapter({ contentRoot: root, defaultLocale: locale });
+  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
 
   const slug = input.slug ?? DEFAULT_SLUG;
   const data = await adapter.extractStructuredData("Product", slug, locale);
-  if (!data) return null;
 
-  const schema = data as Record<string, unknown>;
+  const schema = (data ?? {}) as Record<string, unknown>;
 
   // Support both a top-level `offers` array and a single offer object.
   const offersRaw = schema["offers"];
@@ -61,7 +67,20 @@ export async function ailkGetPricing(
       ? [offersRaw as Record<string, unknown>]
       : [];
 
-  if (offersArr.length === 0) return null;
+  if (offersArr.length === 0) {
+    const page = await adapter.getPageBySlug("Product", slug, locale);
+    if (!page || page.price === undefined) return null;
+    return getPricingOutputSchema.parse({
+      tiers: [
+        {
+          name: page.title,
+          price: page.price,
+          priceCurrency: page.priceCurrency ?? "USD",
+          ...(page.summary !== undefined && { description: page.summary }),
+        },
+      ],
+    });
+  }
 
   const tiers = offersArr.map((offer) => ({
     name: (offer["name"] as string) ?? "",

package/templates/apps/mcp/src/tools/get_site_info.ts

@@ -1,7 +1,8 @@
 /**
  * get_site_info — returns structured site identity from the HomePage.
  *
- * Pure read: imports the MDX adapter from @working-theory/content-adapters (ADR 0011).
+ * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
+ * resolver seam (#5805, ADR 0011), MDX by default.
  * Resolves the HomePage by slug (default: "home") and extracts the `schema`
  * frontmatter field. Returns null when the page is not found or has no schema.
  *
@@ -16,7 +17,6 @@
 
 import { join } from "node:path";
 
-import { createMdxAdapter } from "@working-theory/content-adapters";
 import {
   getSiteInfoInputSchema,
   getSiteInfoOutputSchema,
@@ -24,6 +24,7 @@ import {
   type GetSiteInfoOutput,
 } from "@working-theory/validation";
 
+import { getMcpContentAdapter } from "../lib/content-adapter.js";
 import { resolveLocale } from "../lib/resolve-locale.js";
 
 export { getSiteInfoInputSchema, getSiteInfoOutputSchema };
@@ -45,7 +46,7 @@ export async function ailkGetSiteInfo(
 
   const root = contentRoot ?? join(process.cwd(), "content");
   const locale = resolveLocale(input.locale);
-  const adapter = createMdxAdapter({ contentRoot: root, defaultLocale: locale });
+  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
 
   const slug = input.slug ?? DEFAULT_SLUG;
   const data = await adapter.extractStructuredData("HomePage", slug, locale);

package/templates/apps/mcp/src/tools/index.ts

@@ -124,10 +124,12 @@ export {
   type ScaffoldOutput,
 } from "./create_project.js";
 
-// The scheduling tools (list_availability, get_event_meta, create_booking),
-// the content-write tools (create_page, update_page, delete_page), and the
-// signal-collectors flow tools (get_flow, submit_flow_step) are deliberately
-// NOT re-exported here. All three groups are module-conditional slice files
+// The scheduling tools (list_availability, get_event_meta, create_booking)
+// and the signal-collectors flow tools (get_flow, submit_flow_step) are
+// deliberately NOT re-exported here. (The content-write tools that used to sit
+// in this list — create_page, update_page, delete_page — no longer exist at
+// all: #5853 retired them with their HTTP twins.)
+// Both remaining groups are module-conditional slice files
 // (#5182): a re-export from this barrel is a static path into a file the OSS
 // strip removes, which reds the public tree's type-check. They are reached
 // only through `createMcpServer`'s per-module loader in ../server.ts.

package/templates/apps/mcp/src/tools/list_pages.ts

@@ -1,7 +1,8 @@
 /**
  * list_pages — returns published content pages, optionally filtered by type.
  *
- * Pure read: imports the MDX adapter from @working-theory/content-adapters (ADR 0011).
+ * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
+ * resolver seam (#5805, ADR 0011), MDX by default.
  * No auth, no side effects, no network. The adapter reads from the filesystem.
  *
  * Phase 3 S3: optional `locale` parameter. Validated against `readLocales()`
@@ -17,7 +18,6 @@
 import { join } from "node:path";
 
 import {
-  createMdxAdapter,
   SCHEMA_ORG_TYPES,
   type SchemaOrgType,
 } from "@working-theory/content-adapters";
@@ -28,6 +28,7 @@ import {
   type ListPagesOutput,
 } from "@working-theory/validation";
 
+import { getMcpContentAdapter } from "../lib/content-adapter.js";
 import { resolveLocale } from "../lib/resolve-locale.js";
 
 export { listPagesInputSchema, listPagesOutputSchema };
@@ -49,7 +50,7 @@ export async function ailkListPages(
   // Default: resolve content/ relative to cwd (works in ESM and jest/commonjs).
   const root = contentRoot ?? join(process.cwd(), "content");
   const locale = resolveLocale(input.locale);
-  const adapter = createMdxAdapter({ contentRoot: root, defaultLocale: locale });
+  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
 
   const types: readonly SchemaOrgType[] = input.type
     ? [input.type]