create-ailk 0.23.0 → 0.25.1

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

@@ -1,134 +0,0 @@
-/**
- * create_project — creates an AI Launch Kit starter project via create-ailk.
- *
- * Agent-only: no web Server Action equivalent. Scaffolding is an
- * orchestration-layer action that only makes sense for an agent driving a
- * project setup flow.
- *
- * Implementation: spawns the `create-ailk` CLI binary via Node's spawnSync.
- * `apps/mcp` does NOT import `create-ailk` directly — the package is not on
- * the apps/mcp allow-list in architecture.yaml (it is a standalone CLI, not a
- * side-effect-free read library per ADR 0011). Spawning the built CLI binary
- * is the architecturally correct delegation pattern.
- *
- * The CLI binary path defaults to `<cwd>/packages/create-ailk/dist/cli.js`.
- * The MCP server runs from the repo root (cwd = repo root), so this resolves
- * correctly in production and in integration tests.
- *
- * Input:  { targetDir, projectName, preset? }
- *   The tool builds the Free organization-product starter (`--shape
- *   organization-product`, #6754 D9); `preset` stays reserved. Always builds
- *   the Free module set (`--modules marketing`, #6759 D6, SEC-7): a licence
- *   key sitting in the MCP server's own environment never widens what an
- *   anonymous caller receives — the explicit keep list takes precedence over
- *   any key-derived level probe before the child process reads its env.
- *   targetDir   — absolute or relative path to scaffold into; must not exist
- *                 or must be empty (enforced by create-ailk ValidationError)
- *   projectName — project name used in README and package.json
- *   preset      — permissive string; reserved for Phase 3 U6 named starters
- *                 // TODO(U6): narrow to z.enum([...]) once named presets land
- *
- * Output: { targetDir, filesCreated }
- *   targetDir    — resolved absolute path that was scaffolded
- *   filesCreated — number of files written
- *
- * Session/scope: none — scaffolding is a write to the local filesystem
- * initiated by the agent; no auth required for the tool itself.
- */
-
-import { spawnSync } from "node:child_process";
-import { existsSync, readdirSync } from "node:fs";
-import { join, resolve } from "node:path";
-
-import {
-  scaffoldInputSchema,
-  scaffoldOutputSchema,
-  type ScaffoldInput,
-  type ScaffoldOutput,
-} from "@working-theory/validation";
-
-export { scaffoldInputSchema, scaffoldOutputSchema };
-export type { ScaffoldInput, ScaffoldOutput };
-
-/**
- * Resolve the path to the create-ailk CLI binary.
- *
- * Uses process.cwd() — the MCP server always starts from the repo root.
- * Accepts an override for tests.
- */
-function resolveCliBin(override?: string): string {
-  if (override) return override;
-  return join(process.cwd(), "packages/create-ailk/dist/cli.js");
-}
-
-/**
- * Count all files recursively under a directory.
- */
-function countFiles(dir: string): number {
-  if (!existsSync(dir)) return 0;
-  let count = 0;
-  const stack: string[] = [dir];
-  while (stack.length > 0) {
-    const current = stack.pop()!;
-    for (const entry of readdirSync(current, { withFileTypes: true })) {
-      if (entry.isDirectory()) {
-        stack.push(`${current}/${entry.name}`);
-      } else {
-        count++;
-      }
-    }
-  }
-  return count;
-}
-
-/**
- * ailkCreateProject handler.
- *
- * Spawns the create-ailk CLI binary to scaffold a starter project into
- * targetDir. The binary must be pre-built (`pnpm --filter create-ailk build`).
- *
- * Accepts an optional `cliBin` override for testing (mirrors the contentRoot
- * override pattern in ailkAudit).
- */
-export async function ailkCreateProject(
-  input: ScaffoldInput,
-  cliBin?: string,
-): Promise<ScaffoldOutput> {
-  scaffoldInputSchema.parse(input);
-
-  const bin = resolveCliBin(cliBin);
-  const targetAbs = resolve(input.targetDir);
-
-  // Spawn the CLI synchronously — no network, no async I/O needed.
-  // Hard-coded node invocation; only targetDir flows through user input. The
-  // CLI refuses a run naming no shape and no template, so the tool names one.
-  // `--modules marketing` is pinned explicitly (#6759 D6, SEC-7): an explicit
-  // keep list takes the keep branch and resolves before the child ever reads
-  // AILK_LICENSE_KEY, so a licence key in the server's own environment can
-  // never turn this anonymous call into the keyed level probe.
-  const result = spawnSync(
-    "node",
-    [bin, targetAbs, "--shape", "organization-product", "--modules", "marketing"],
-    {
-      stdio: ["ignore", "pipe", "pipe"],
-      shell: false,
-      encoding: "utf8",
-    },
-  );
-
-  if (result.status !== 0) {
-    // Extract the error message from stderr (CLI writes "[create-ailk] <msg>").
-    const stderr = (result.stderr ?? "").trim();
-    const msg = stderr.replace(/^\[create-ailk\]\s*/, "") || "scaffold failed";
-    throw new Error(msg);
-  }
-
-  const filesCreated = countFiles(targetAbs);
-
-  const output: ScaffoldOutput = {
-    targetDir: targetAbs,
-    filesCreated,
-  };
-
-  return scaffoldOutputSchema.parse(output);
-}

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

@@ -1,68 +0,0 @@
-/**
- * get_business_hours — returns business hours from LocalBusiness structured data.
- *
- * 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.
- *
- * Phase 3 S3: optional `locale` parameter (BCP-47). Validated against the
- * project's allowlist; invalid or unknown values silently fall back to the
- * default locale (AC-i18n-07).
- *
- * Input:  { slug?: string, locale?: string }
- * Output: Array<{ dayOfWeek, opens, closes, validFrom?, validThrough? }> | null
- * Session/scope: none — read-only public content.
- */
-
-import {
-  getBusinessHoursInputSchema,
-  getBusinessHoursOutputSchema,
-  type GetBusinessHoursInput,
-  type GetBusinessHoursOutput,
-} from "@working-theory/validation";
-
-import {
-  getMcpContentAdapter,
-  mcpContentRoot,
-} from "../lib/content-adapter.js";
-import { resolveLocale } from "../lib/resolve-locale.js";
-
-export { getBusinessHoursInputSchema, getBusinessHoursOutputSchema };
-export type { GetBusinessHoursInput, GetBusinessHoursOutput };
-
-const DEFAULT_SLUG = "home";
-
-/**
- * get_business_hours handler.
- *
- * Accepts an optional `contentRoot` override for testing. When omitted,
- * resolves it through `mcpContentRoot()` (#8070 D3).
- */
-export async function ailkGetBusinessHours(
-  input: GetBusinessHoursInput,
-  contentRoot?: string,
-): Promise<GetBusinessHoursOutput> {
-  getBusinessHoursInputSchema.parse(input);
-
-  const root = contentRoot ?? mcpContentRoot();
-  const locale = resolveLocale(input.locale);
-  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
-
-  const slug = input.slug ?? DEFAULT_SLUG;
-  const data = await adapter.extractStructuredData("LocalBusiness", slug, locale);
-  if (!data) return null;
-
-  const hours = data.openingHoursSpecification;
-  if (!Array.isArray(hours) || hours.length === 0) return null;
-
-  return getBusinessHoursOutputSchema.parse(
-    (hours as Record<string, unknown>[]).map((h) => ({
-      dayOfWeek: h["dayOfWeek"] as string,
-      opens: h["opens"] as string,
-      closes: h["closes"] as string,
-      validFrom: h["validFrom"] as string | undefined,
-      validThrough: h["validThrough"] as string | undefined,
-    })),
-  );
-}

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

@@ -1,71 +0,0 @@
-/**
- * get_faq — returns FAQ question/answer pairs from FAQPage structured data.
- *
- * 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.
- *
- * Phase 3 S3: optional `locale` parameter (BCP-47). Validated against the
- * project's allowlist; invalid or unknown values silently fall back to the
- * default locale (AC-i18n-07).
- *
- * Input:  { slug?: string, locale?: string }
- * Output: { questions: Array<{ question, answer }> } | null
- * Session/scope: none — read-only public content.
- */
-
-import {
-  getFaqInputSchema,
-  getFaqOutputSchema,
-  type GetFaqInput,
-  type GetFaqOutput,
-} from "@working-theory/validation";
-
-import {
-  getMcpContentAdapter,
-  mcpContentRoot,
-} from "../lib/content-adapter.js";
-import { resolveLocale } from "../lib/resolve-locale.js";
-
-export { getFaqInputSchema, getFaqOutputSchema };
-export type { GetFaqInput, GetFaqOutput };
-
-const DEFAULT_SLUG = "faq";
-
-/**
- * get_faq handler.
- *
- * Accepts an optional `contentRoot` override for testing. When omitted,
- * resolves it through `mcpContentRoot()` (#8070 D3).
- */
-export async function ailkGetFaq(
-  input: GetFaqInput,
-  contentRoot?: string,
-): Promise<GetFaqOutput> {
-  getFaqInputSchema.parse(input);
-
-  const root = contentRoot ?? mcpContentRoot();
-  const locale = resolveLocale(input.locale);
-  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
-
-  const slug = input.slug ?? DEFAULT_SLUG;
-  const data = await adapter.extractStructuredData("FAQPage", slug, locale);
-  if (!data) return null;
-
-  const entities = data.mainEntity;
-  if (!Array.isArray(entities) || entities.length === 0) return null;
-
-  const questions = (entities as Record<string, unknown>[]).map((item) => ({
-    question: (item["name"] as string) ?? "",
-    answer:
-      typeof item["acceptedAnswer"] === "object" &&
-      item["acceptedAnswer"] !== null
-        ? (((item["acceptedAnswer"] as Record<string, unknown>)[
-            "text"
-          ] as string) ?? "")
-        : ((item["acceptedAnswer"] as string) ?? ""),
-  }));
-
-  return getFaqOutputSchema.parse({ questions });
-}

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

@@ -1,88 +0,0 @@
-/**
- * get_locations — returns all Place locations from structured data site-wide.
- *
- * 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.
- *
- * Phase 3 S3: optional `locale` parameter (BCP-47). Validated against the
- * project's allowlist; invalid or unknown values silently fall back to the
- * default locale (AC-i18n-07). Page enumeration is locale-scoped.
- *
- * Input:  { locale?: string }
- * Output: { locations: Array<{ name, address, geo?, telephone? }> }
- * Session/scope: none — read-only public content.
- */
-
-import { SCHEMA_ORG_TYPES } from "@working-theory/content-adapters";
-import {
-  getLocationsInputSchema,
-  getLocationsOutputSchema,
-  type GetLocationsInput,
-  type GetLocationsOutput,
-} from "@working-theory/validation";
-
-import {
-  getMcpContentAdapter,
-  mcpContentRoot,
-} from "../lib/content-adapter.js";
-import { resolveLocale } from "../lib/resolve-locale.js";
-
-export { getLocationsInputSchema, getLocationsOutputSchema };
-export type { GetLocationsInput, GetLocationsOutput };
-
-/**
- * get_locations handler.
- *
- * Accepts an optional `contentRoot` override for testing. When omitted,
- * resolves it through `mcpContentRoot()` (#8070 D3).
- */
-export async function ailkGetLocations(
-  input: GetLocationsInput,
-  contentRoot?: string,
-): Promise<GetLocationsOutput> {
-  getLocationsInputSchema.parse(input);
-
-  const root = contentRoot ?? mcpContentRoot();
-  const locale = resolveLocale(input.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.
-  const allPages = await Promise.all(
-    SCHEMA_ORG_TYPES.map((type) => adapter.listPages(type, locale)),
-  );
-
-  // Deduplicate slugs before extracting — a slug can appear in multiple types.
-  const slugsSeen = new Set<string>();
-  const uniquePages = allPages.flat().filter((page) => {
-    if (slugsSeen.has(page.slug)) return false;
-    slugsSeen.add(page.slug);
-    return true;
-  });
-
-  // Parallelize extraction — each call is an independent fs read.
-  const extracted = await Promise.all(
-    uniquePages.map(async (page) => ({
-      page,
-      data: await adapter.extractStructuredData("Place", page.slug, locale),
-    })),
-  );
-
-  const locations: GetLocationsOutput["locations"] = [];
-  for (const { page, data } of extracted) {
-    if (!data) continue;
-    const place = data as Record<string, unknown>;
-    const address = place["address"] as Record<string, unknown> | undefined;
-    if (!address) continue;
-    locations.push({
-      name: page.title,
-      address,
-      geo: place["geo"] as Record<string, unknown> | undefined,
-      telephone: place["telephone"] as string | undefined,
-    });
-  }
-
-  return getLocationsOutputSchema.parse({ locations });
-}

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

@@ -1,96 +0,0 @@
-/**
- * get_offerings — returns Services and/or Products as a unified offerings array.
- *
- * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
- * resolver seam (#5805, ADR 0011), MDX by default — and answers through
- * `listOfferings` (`@working-theory/content-adapters`), which lists pages of
- * type "Service" and/or "Product" and shapes them into a unified offerings
- * array. Optionally filtered by type.
- *
- * HTTP twin (#7177): `GET /v1/content/offerings` in `apps/api` takes the same
- * arguments and answers through the same `listOfferings` — the shared seam
- * the pair proves parity at. The tool still reads content locally, so it
- * needs no API to answer.
- *
- * Phase 3 S3: optional `locale` parameter (BCP-47). Validated against the
- * 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; `listOfferings`
- * documents the mapping.
- *
- * Offerings (#8933, spec D8): when the site sells through its connected
- * Stripe catalog and `type` is not `service`, the tool answers the Service
- * pages followed by the workspace's Offerings shown set, in place of the
- * Product pages — read over HTTP by `lib/shown-offerings.ts` (D6: only on a
- * `claimed` host, at most `MCP_SHOWN_SET_BUDGET_MS`) and mapped by
- * `listOfferingsWithShownSet`, the function the twin route answers through
- * too, so each shown product also carries `prices` (every price with its
- * interval and full lookup key). Names, descriptions and prices are
- * seller-provided data returned as plain JSON values (T5). `type: "service"`,
- * an unclaimed host, a workspace with no current set, a failed read or a
- * mapping that throws answers the page content below, unchanged.
- *
- * Input:  { type?: 'service' | 'product', locale?: string }
- * Output: { offerings: Array<{ name, description, category?, image?, provider, categories, price, priceCurrency, prices? }> }
- * Session/scope: none — read-only public content.
- */
-
-import {
-  listOfferings,
-  listOfferingsWithShownSet,
-} from "@working-theory/content-adapters";
-import {
-  getOfferingsInputSchema,
-  getOfferingsOutputSchema,
-  type GetOfferingsInput,
-  type GetOfferingsOutput,
-} from "@working-theory/validation";
-
-import {
-  getMcpContentAdapter,
-  mcpContentRoot,
-} from "../lib/content-adapter.js";
-import { resolveLocale } from "../lib/resolve-locale.js";
-import {
-  mcpCurrentShownSet,
-  reportMappingFailure,
-} from "../lib/shown-offerings.js";
-
-export { getOfferingsInputSchema, getOfferingsOutputSchema };
-export type { GetOfferingsInput, GetOfferingsOutput };
-
-/**
- * get_offerings handler.
- *
- * Accepts an optional `contentRoot` override for testing. When omitted,
- * resolves it through `mcpContentRoot()` (#8070 D3).
- */
-export async function ailkGetOfferings(
-  input: GetOfferingsInput,
-  contentRoot?: string,
-): Promise<GetOfferingsOutput> {
-  getOfferingsInputSchema.parse(input);
-
-  const root = contentRoot ?? mcpContentRoot();
-  const locale = resolveLocale(input.locale);
-  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
-
-  if (input.type !== "service") {
-    const shownSet = await mcpCurrentShownSet();
-    if (shownSet !== null) {
-      try {
-        return await listOfferingsWithShownSet(
-          adapter,
-          { type: input.type, locale },
-          shownSet,
-        );
-      } catch (err) {
-        reportMappingFailure(err);
-      }
-    }
-  }
-
-  return listOfferings(adapter, { type: input.type, locale });
-}

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

@@ -1,94 +0,0 @@
-/**
- * get_pricing — returns pricing tiers from Offer structured data.
- *
- * 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.
- *
- * Phase 3 S3: optional `locale` parameter (BCP-47). Validated against the
- * 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. `getPricingTiers`
- * (`@working-theory/content-adapters`) documents the mapping.
- *
- * HTTP twin (#7178): `GET /v1/content/pricing` in `apps/api` takes the same
- * arguments and answers through the same `getPricingTiers` — the shared seam
- * the pair proves parity at. The tool still reads content locally, so it
- * needs no API to answer.
- *
- * Offerings (#8933, spec D8): when the site sells through its connected
- * Stripe catalog and `slug` is omitted or `pricing`, the tool answers the
- * workspace's Offerings shown set instead — read over HTTP by
- * `lib/shown-offerings.ts` (D6: only on a `claimed` host, at most
- * `MCP_SHOWN_SET_BUDGET_MS`) and mapped by `pricingTiersFromShownSet`, the
- * function the twin route answers through too, so each tier also carries
- * `interval` and the full `lookupKey`. Names, descriptions and prices are
- * seller-provided data returned as plain JSON values (T5). Any other slug, an
- * unclaimed host, a workspace with no current set, a failed read or a mapping
- * that throws answers the page content below, unchanged.
- *
- * Input:  { slug?: string, locale?: string }
- * Output: { tiers: Array<{ name, price, priceCurrency, description?, interval?, lookupKey? }> } | null
- * Session/scope: none — read-only public content.
- */
-
-import {
-  getPricingTiers,
-  pricingTiersFromShownSet,
-  shownSetAnswersPricing,
-} from "@working-theory/content-adapters";
-import {
-  getPricingInputSchema,
-  getPricingOutputSchema,
-  type GetPricingInput,
-  type GetPricingOutput,
-} from "@working-theory/validation";
-
-import {
-  getMcpContentAdapter,
-  mcpContentRoot,
-} from "../lib/content-adapter.js";
-import { resolveLocale } from "../lib/resolve-locale.js";
-import {
-  mcpCurrentShownSet,
-  reportMappingFailure,
-} from "../lib/shown-offerings.js";
-
-export { getPricingInputSchema, getPricingOutputSchema };
-export type { GetPricingInput, GetPricingOutput };
-
-/**
- * get_pricing handler.
- *
- * Accepts an optional `contentRoot` override for testing. When omitted,
- * resolves it through `mcpContentRoot()` (#8070 D3).
- */
-export async function ailkGetPricing(
-  input: GetPricingInput,
-  contentRoot?: string,
-): Promise<GetPricingOutput> {
-  getPricingInputSchema.parse(input);
-
-  if (shownSetAnswersPricing(input.slug)) {
-    const shownSet = await mcpCurrentShownSet();
-    if (shownSet !== null) {
-      try {
-        return pricingTiersFromShownSet(shownSet);
-      } catch (err) {
-        reportMappingFailure(err);
-      }
-    }
-  }
-
-  const root = contentRoot ?? mcpContentRoot();
-  const locale = resolveLocale(input.locale);
-  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
-
-  return getPricingTiers(adapter, { slug: input.slug, locale });
-}

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

@@ -1,86 +0,0 @@
-/**
- * get_site_info — returns structured site identity from the HomePage.
- *
- * 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.
- *
- * Phase 3 S3: optional `locale` parameter (BCP-47). Validated against the
- * project's allowlist; invalid or unknown values silently fall back to the
- * default locale (AC-i18n-07).
- *
- * Input:  { slug?: string, locale?: string }
- * Output: { name, description, contact?, brandColors?, socialHandles? } | null
- * Session/scope: none — read-only public content.
- */
-
-import {
-  getSiteInfoInputSchema,
-  getSiteInfoOutputSchema,
-  type GetSiteInfoInput,
-  type GetSiteInfoOutput,
-} from "@working-theory/validation";
-
-import {
-  getMcpContentAdapter,
-  mcpContentRoot,
-} from "../lib/content-adapter.js";
-import { resolveLocale } from "../lib/resolve-locale.js";
-
-export { getSiteInfoInputSchema, getSiteInfoOutputSchema };
-export type { GetSiteInfoInput, GetSiteInfoOutput };
-
-const DEFAULT_SLUG = "home";
-
-/**
- * get_site_info handler.
- *
- * Accepts an optional `contentRoot` override for testing. When omitted,
- * resolves it through `mcpContentRoot()` (#8070 D3).
- */
-export async function ailkGetSiteInfo(
-  input: GetSiteInfoInput,
-  contentRoot?: string,
-): Promise<GetSiteInfoOutput> {
-  getSiteInfoInputSchema.parse(input);
-
-  const root = contentRoot ?? mcpContentRoot();
-  const locale = resolveLocale(input.locale);
-  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
-
-  const slug = input.slug ?? DEFAULT_SLUG;
-  const data = await adapter.extractStructuredData("HomePage", slug, locale);
-  if (!data) return null;
-
-  const schema = data as Record<string, unknown>;
-
-  const contactRaw = schema["contactPoint"] as
-    | Record<string, unknown>
-    | undefined;
-  const contact =
-    contactRaw !== undefined
-      ? {
-          email: contactRaw["email"] as string | undefined,
-          phone: contactRaw["telephone"] as string | undefined,
-        }
-      : undefined;
-
-  const colorsRaw = schema["brandColors"];
-  const brandColors = Array.isArray(colorsRaw)
-    ? (colorsRaw as string[])
-    : undefined;
-
-  const socialsRaw = schema["sameAs"];
-  const socialHandles = Array.isArray(socialsRaw)
-    ? (socialsRaw as string[])
-    : undefined;
-
-  return getSiteInfoOutputSchema.parse({
-    name: (schema["name"] as string) ?? "",
-    description: (schema["description"] as string) ?? "",
-    contact,
-    brandColors,
-    socialHandles,
-  });
-}