create-ailk 0.10.0 → 0.11.1

package/templates/apps/web/app/.well-known/mcp.json/build-manifest.ts

@@ -14,10 +14,13 @@
  * endpoint when MCP_PUBLIC_HTTP_URL is configured.
  * Issue #4157 — `name` resolves from SITE_NAME (env → _site.mdx → neutral
  * default) instead of a hardcoded vendor-brand literal.
+ * Issue #7136 — the five `feature`-tagged tools are gated on the licence
+ * features the route passes in (`heldFeatures`), as registration is.
  */
 
 import {
   getMcpToolCatalog,
+  type McpCatalogOptions,
   type McpToolCatalogEntry,
 } from "@working-theory/metadata";
 
@@ -88,6 +91,16 @@ export interface BuildMcpManifestOptions {
    * claim and passes it in. Omitted ⇒ false, the fail-closed default.
    */
   commerceClaimed?: boolean;
+  /**
+   * The licence features this deployment holds (#7136). In refuse mode a
+   * `feature`-tagged tool is advertised only when its feature is held — the
+   * same gate the MCP server's registration applies. Injected, like
+   * `commerceClaimed`. Omitted ⇒ none, the fail-closed default.
+   */
+  heldFeatures?: readonly string[];
+  /** Overrides `MCP_FEATURE_GATE_MODE` — a test seam; `route.ts` never
+   * passes it. */
+  featureGate?: McpCatalogOptions["featureGate"];
 }
 
 /** Path the MCP server is mounted at, relative to baseUrl. */
@@ -121,6 +134,8 @@ export function buildMcpManifest(opts: BuildMcpManifestOptions): McpManifest {
     mcpEndpoint: `${opts.baseUrl}${MCP_ENDPOINT_PATH}`,
     tools: getMcpToolCatalog({
       addons: { commerce: opts.commerceClaimed === true },
+      features: opts.heldFeatures ?? [],
+      ...(opts.featureGate ? { featureGate: opts.featureGate } : {}),
     }),
     transport: {
       type: "http",

package/templates/apps/web/app/.well-known/mcp.json/route.ts

@@ -12,7 +12,9 @@
  * the deployments whose MCP server registers it. Without that, a KEYED site
  * would register `start_purchase` while hiding it from its own manifest —
  * the surface disagreement `apps/mcp/__tests__/catalog-drift.test.ts` exists
- * to make impossible.
+ * to make impossible. The same single read also yields the licence features
+ * the deployment holds (#7136), which gate the five `feature`-tagged tools
+ * here exactly as they gate registration on the MCP server.
  *
  * Mirrors /.well-known/ai-plugin.json conventions: Response.json with a
  * conservative cache-control header.
@@ -23,7 +25,10 @@
  */
 
 import packageJson from "../../../package.json";
-import { resolveCommerceClaim } from "../../../src/lib/commerce-claim";
+import {
+  COMMERCE_FEATURE,
+  resolveLicenceFeatures,
+} from "../../../src/lib/commerce-claim";
 import { resolveBaseUrl } from "../../../src/lib/routes";
 
 import { buildMcpManifest } from "./build-manifest";
@@ -46,11 +51,13 @@ export async function GET(): Promise<Response> {
   // (apps/mcp running in HTTP mode). When set, the manifest includes it
   // as an additional transport descriptor for discovering agents.
   const mcpHttpUrlEnv = process.env["MCP_PUBLIC_HTTP_URL"];
+  const heldFeatures = await resolveLicenceFeatures();
 
   const manifest = buildMcpManifest({
     baseUrl: resolveBaseUrl(),
     ailkVersion: packageJson.version,
-    commerceClaimed: await resolveCommerceClaim(),
+    commerceClaimed: heldFeatures.includes(COMMERCE_FEATURE),
+    heldFeatures,
     // Spread conditional to satisfy exactOptionalPropertyTypes: omit the key
     // entirely when the env var is not set rather than passing undefined.
     ...(mcpHttpUrlEnv ? { mcpHttpUrl: mcpHttpUrlEnv } : {}),

package/templates/apps/web/app/[locale]/careers/[slug]/page.tsx

@@ -3,7 +3,6 @@
 // Careers list at /careers links here; each job posting lives at /careers/<slug>.
 import {
   getMdxSource as defaultGetMdxSource,
-  getMdxSlugs,
   renderPage,
   renderPageMetadata,
 } from "@working-theory/page-renderer";
@@ -23,15 +22,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "JobPosting", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("JobPosting", params.locale);
-  return slugs.map((slug: string) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource = defaultGetMdxSource,

package/templates/apps/web/app/[locale]/case-studies/[slug]/page.tsx

@@ -2,7 +2,6 @@
 // next-mdx-remote/rsc, and emits a JSON-LD <script>. Unknown slugs trigger 404.
 import {
   getMdxSource as defaultGetMdxSource,
-  getMdxSlugs,
   renderPage,
   renderPageMetadata,
 } from "@working-theory/page-renderer";
@@ -22,15 +21,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "CaseStudy", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("CaseStudy", params.locale);
-  return slugs.map((slug: string) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource = defaultGetMdxSource,

package/templates/apps/web/app/[locale]/courses/[slug]/page.tsx

@@ -1,11 +1,7 @@
 // Course detail page. Reads the Course MDX for the given slug, renders via
 // @working-theory/page-renderer, and emits a JSON-LD <script>. Unknown slugs trigger 404.
 import type { getMdxSource as defaultGetMdxSource } from "@working-theory/page-renderer";
-import {
-  getMdxSlugs,
-  renderPage,
-  renderPageMetadata,
-} from "@working-theory/page-renderer";
+import { renderPage, renderPageMetadata } from "@working-theory/page-renderer";
 import type { Metadata } from "next";
 import type { ReactElement } from "react";
 
@@ -21,15 +17,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "Course", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("Course", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource,

package/templates/apps/web/app/[locale]/events/[slug]/page.tsx

@@ -4,7 +4,6 @@ import {
   renderPage,
   renderPageMetadata,
   getMdxSource as defaultGetMdxSource,
-  getMdxSlugs,
 } from "@working-theory/page-renderer";
 import type { Metadata } from "next";
 import { notFound } from "next/navigation";
@@ -22,15 +21,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "Event", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("Event", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource = defaultGetMdxSource,

package/templates/apps/web/app/[locale]/features/[slug]/page.tsx

@@ -7,7 +7,6 @@
 import type { getMdxSource as defaultGetMdxSource } from "@working-theory/page-renderer";
 import {
   getMdxSource as loadMdxSource,
-  getMdxSlugs,
   renderPage,
   renderPageMetadata,
 } from "@working-theory/page-renderer";
@@ -26,15 +25,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "Feature", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("Feature", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource,

package/templates/apps/web/app/[locale]/for/[slug]/page.tsx

@@ -7,7 +7,6 @@
 import type { getMdxSource as defaultGetMdxSource } from "@working-theory/page-renderer";
 import {
   getMdxSource as loadMdxSource,
-  getMdxSlugs,
   renderPage,
   renderPageMetadata,
 } from "@working-theory/page-renderer";
@@ -26,15 +25,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "UseCase", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("UseCase", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource,

package/templates/apps/web/app/[locale]/how-to/[slug]/page.tsx

@@ -1,11 +1,7 @@
 // HowTo detail page. Reads the HowTo MDX for the given slug, renders via
 // @working-theory/page-renderer, and emits a JSON-LD <script>. Unknown slugs trigger 404.
 import type { getMdxSource as defaultGetMdxSource } from "@working-theory/page-renderer";
-import {
-  getMdxSlugs,
-  renderPage,
-  renderPageMetadata,
-} from "@working-theory/page-renderer";
+import { renderPage, renderPageMetadata } from "@working-theory/page-renderer";
 import type { Metadata } from "next";
 import type { ReactElement } from "react";
 
@@ -21,15 +17,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "HowTo", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("HowTo", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource,

package/templates/apps/web/app/[locale]/integrations/[slug]/page.tsx

@@ -4,7 +4,6 @@ import {
   renderPage,
   renderPageMetadata,
   getMdxSource as defaultGetMdxSource,
-  getMdxSlugs,
 } from "@working-theory/page-renderer";
 import type { Metadata } from "next";
 import { notFound } from "next/navigation";
@@ -22,15 +21,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "Integration", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("Integration", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource = defaultGetMdxSource,

package/templates/apps/web/app/[locale]/partners/[slug]/page.tsx

@@ -2,7 +2,6 @@
 // next-mdx-remote/rsc, and emits a JSON-LD <script>. Unknown slugs trigger 404.
 import {
   getMdxSource as defaultGetMdxSource,
-  getMdxSlugs,
   renderPage,
   renderPageMetadata,
 } from "@working-theory/page-renderer";
@@ -22,15 +21,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "Partner", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("Partner", params.locale);
-  return slugs.map((slug: string) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource = defaultGetMdxSource,

package/templates/apps/web/app/[locale]/portfolio/[slug]/page.tsx

@@ -4,7 +4,6 @@
 // NO_HAND_IMPLEMENT_OK: /build-starter operator-directed live pass (#6687).
 import {
   getMdxSource as defaultGetMdxSource,
-  getMdxSlugs,
   renderPage,
   renderPageMetadata,
 } from "@working-theory/page-renderer";
@@ -24,15 +23,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "PortfolioItem", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("PortfolioItem", params.locale);
-  return slugs.map((slug: string) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource = defaultGetMdxSource,

package/templates/apps/web/app/[locale]/products/[slug]/page.tsx

@@ -4,7 +4,6 @@ import {
   renderPage,
   renderPageMetadata,
   getMdxSource as defaultGetMdxSource,
-  getMdxSlugs,
 } from "@working-theory/page-renderer";
 import type { Metadata } from "next";
 import { notFound } from "next/navigation";
@@ -22,15 +21,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "Product", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("Product", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource = defaultGetMdxSource,

package/templates/apps/web/app/[locale]/projects/[slug]/page.tsx

@@ -4,11 +4,7 @@ import type {
   getMdxSource as defaultGetMdxSource,
   getPageSections as defaultGetPageSections,
 } from "@working-theory/page-renderer";
-import {
-  getContentAdapter,
-  renderPage,
-  renderPageMetadata,
-} from "@working-theory/page-renderer";
+import { renderPage, renderPageMetadata } from "@working-theory/page-renderer";
 import type { Metadata } from "next";
 import type { ReactElement } from "react";
 
@@ -25,16 +21,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "Project", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const adapter = getContentAdapter();
-  const pages = await adapter.listDetail("Project", params.locale);
-  return pages.map((page) => ({ slug: page.slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource,

package/templates/apps/web/app/[locale]/resources/[slug]/page.tsx

@@ -4,7 +4,6 @@ import type {
   getMdxSource as defaultGetMdxSource,
 } from "@working-theory/page-renderer";
 import {
-  getMdxSlugs,
   getMdxSource as defaultGetMdxSourceImpl,
   renderPage,
   renderPageMetadata,
@@ -25,15 +24,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "ResourceDetail", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("ResourceDetail", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource = defaultGetMdxSourceImpl,

package/templates/apps/web/app/[locale]/services/[slug]/page.tsx

@@ -4,7 +4,6 @@ import {
   renderPage,
   renderPageMetadata,
   getMdxSource as defaultGetMdxSource,
-  getMdxSlugs,
 } from "@working-theory/page-renderer";
 import type { Metadata } from "next";
 import { notFound } from "next/navigation";
@@ -22,15 +21,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "Service", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("Service", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource = defaultGetMdxSource,

package/templates/apps/web/app/[locale]/software/[slug]/page.tsx

@@ -4,7 +4,6 @@
 // renders them; a prose-only page keeps the MDX-body render.
 import type { getMdxSource as defaultGetMdxSource } from "@working-theory/page-renderer";
 import {
-  getMdxSlugs,
   getMdxSource as loadMdxSource,
   renderPage,
   renderPageMetadata,
@@ -24,15 +23,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "SoftwareProduct", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("SoftwareProduct", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource,

package/templates/apps/web/app/[locale]/tech-articles/[slug]/page.tsx

@@ -1,11 +1,7 @@
 // TechArticle detail page. Reads the TechArticle MDX for the given slug, renders via
 // @working-theory/page-renderer, and emits a JSON-LD <script>. Unknown slugs trigger 404.
 import type { getMdxSource as defaultGetMdxSource } from "@working-theory/page-renderer";
-import {
-  getMdxSlugs,
-  renderPage,
-  renderPageMetadata,
-} from "@working-theory/page-renderer";
+import { renderPage, renderPageMetadata } from "@working-theory/page-renderer";
 import type { Metadata } from "next";
 import type { ReactElement } from "react";
 
@@ -21,15 +17,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "TechArticle", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("TechArticle", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource,

package/templates/apps/web/app/[locale]/thanks/[slug]/page.tsx

@@ -1,14 +1,11 @@
 // ThankYouPage detail page (#3960 D6) — the segment-keyed flow-completion
-// redirect target. Sections-mode renderPage (the ContactPage pattern) with
-// Whitepaper's dynamic-slug generateStaticParams pattern. Unknown slugs 404
+// redirect target. Sections-mode renderPage (the ContactPage pattern),
+// rendered on request under the cookie-reading locale layout; [slug]/page.tsx's
+// header says why there is no static-params export (#7379). Unknown slugs 404
 // via renderPage's own detail-route branch (no translationsNamespace passed
 // — renderPage calls notFound() itself when getMdxSource resolves null).
 import type { getMdxSource as defaultGetMdxSource } from "@working-theory/page-renderer";
-import {
-  getMdxSlugs,
-  renderPage,
-  renderPageMetadata,
-} from "@working-theory/page-renderer";
+import { renderPage, renderPageMetadata } from "@working-theory/page-renderer";
 import type { Metadata } from "next";
 import type { ReactElement } from "react";
 
@@ -24,15 +21,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "ThankYouPage", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("ThankYouPage", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource,

package/templates/apps/web/app/[locale]/vs/[slug]/__tests__/page.test.tsx

@@ -1,6 +1,6 @@
 /**
  * Tests for /vs/[slug] (#6878 D9) — the ComparisonPage detail route.
- * `renderPage`/`renderPageMetadata`/`getMdxSlugs` are mocked at the
+ * `renderPage`/`renderPageMetadata` are mocked at the
  * `@working-theory/page-renderer` boundary; `getMdxSource` is supplied
  * per-call through the route's DI prop.
  */
@@ -10,24 +10,19 @@
 // production, unaffected by this mock's loose type here.
 const mockRenderPage = jest.fn(async (..._args: unknown[]) => "<rendered/>");
 const mockRenderPageMetadata = jest.fn((..._args: unknown[]) => undefined);
-const mockGetMdxSlugs = jest.fn((..._args: unknown[]) => Promise.resolve<string[]>([]));
 
 jest.mock("@working-theory/page-renderer", () => ({
   __esModule: true,
-  getMdxSlugs: (...args: unknown[]) => mockGetMdxSlugs(...args),
   renderPage: (...args: unknown[]) => mockRenderPage(...args),
   renderPageMetadata: (...args: unknown[]) => mockRenderPageMetadata(...args),
   getMdxSource: jest.fn(),
 }));
 
-import ComparisonPage, {
-  generateMetadata,
-  generateStaticParams,
-} from "../page";
+import ComparisonPage, { generateMetadata } from "../page";
 
 beforeEach(() => jest.clearAllMocks());
 
-describe("ComparisonPage detail — metadata + static params", () => {
+describe("ComparisonPage detail — metadata", () => {
   it("resolves metadata for the given slug", async () => {
     await generateMetadata({
       params: Promise.resolve({ locale: "en", slug: "acme" }),
@@ -38,13 +33,6 @@ describe("ComparisonPage detail — metadata + static params", () => {
       locale: "en",
     });
   });
-
-  it("enumerates every ComparisonPage slug for static generation", async () => {
-    mockGetMdxSlugs.mockResolvedValue(["acme", "globex"]);
-    const params = await generateStaticParams({ params: { locale: "en" } });
-    expect(mockGetMdxSlugs).toHaveBeenCalledWith("ComparisonPage", "en");
-    expect(params).toEqual([{ slug: "acme" }, { slug: "globex" }]);
-  });
 });
 
 describe("ComparisonPage detail — sections vs mdx-body", () => {

package/templates/apps/web/app/[locale]/vs/[slug]/page.tsx

@@ -12,7 +12,6 @@
 import type { getMdxSource as defaultGetMdxSource } from "@working-theory/page-renderer";
 import {
   getMdxSource as loadMdxSource,
-  getMdxSlugs,
   renderPage,
   renderPageMetadata,
 } from "@working-theory/page-renderer";
@@ -31,15 +30,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "ComparisonPage", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("ComparisonPage", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource,

package/templates/apps/web/app/[locale]/whitepapers/[slug]/page.tsx

@@ -1,11 +1,7 @@
 // Whitepaper detail page. Reads the Whitepaper MDX for the given slug, renders via
 // @working-theory/page-renderer, and emits a JSON-LD <script>. Unknown slugs trigger 404.
 import type { getMdxSource as defaultGetMdxSource } from "@working-theory/page-renderer";
-import {
-  getMdxSlugs,
-  renderPage,
-  renderPageMetadata,
-} from "@working-theory/page-renderer";
+import { renderPage, renderPageMetadata } from "@working-theory/page-renderer";
 import type { Metadata } from "next";
 import type { ReactElement } from "react";
 
@@ -21,15 +17,6 @@ export async function generateMetadata({
   return renderPageMetadata({ type: "Whitepaper", slug, locale });
 }
 
-export async function generateStaticParams({
-  params,
-}: {
-  params: { locale: string };
-}): Promise<{ slug: string }[]> {
-  const slugs = await getMdxSlugs("Whitepaper", params.locale);
-  return slugs.map((slug) => ({ slug }));
-}
-
 export default async function Page({
   params,
   getMdxSource,

package/templates/apps/web/src/lib/commerce-claim.ts

@@ -15,19 +15,28 @@
  * unlike `apps/mcp/src/lib/commerce-claim.ts`'s boot-time memoisation — so a
  * site that buys commerce after its last deploy starts serving immediately
  * rather than waiting on a redeploy.
+ *
+ * {@link resolveLicenceFeatures} (#7136) is the same single read, returning
+ * every licence feature the deployment holds: `/.well-known/mcp.json` gates
+ * the five `feature`-tagged MCP tools on it, from one call per request.
  */
 import { checkLicense } from "@working-theory/license";
 
 /** The licence `features[]` claim that turns the commerce add-on on. */
-const COMMERCE_FEATURE = "commerce";
+export const COMMERCE_FEATURE = "commerce";
 
-export async function resolveCommerceClaim(): Promise<boolean> {
+/** The licence features this deployment positively holds — `[]` when the
+ * licence is revoked, carries no `features` array, or cannot be read. */
+export async function resolveLicenceFeatures(): Promise<readonly string[]> {
   try {
     const result = await checkLicense();
-    return (
-      result.revoked !== true && result.features.includes(COMMERCE_FEATURE)
-    );
+    if (result.revoked === true) return [];
+    return Array.isArray(result.features) ? result.features : [];
   } catch {
-    return false;
+    return [];
   }
 }
+
+export async function resolveCommerceClaim(): Promise<boolean> {
+  return (await resolveLicenceFeatures()).includes(COMMERCE_FEATURE);
+}