create-ailk 0.10.0 → 0.11.1

package/templates/.claude/skills/upgrade-plan/SKILL.md

@@ -1,121 +0,0 @@
----
-name: upgrade-plan
-description: Explain the AI Launch Kit options — Free, Pro, Pro Plus, Agency and the commerce add-on's three rungs (Commerce, SaaS, SaaS with Usage) — side by side, with the prices the public pricing page publishes right now, read this site's own modules and shape, and recommend exactly one option with a reason. Use when the user asks "what does Pro get me?", "should I upgrade?", "compare plans", "which plan do I need?", "how much is commerce?", or types /upgrade-plan. The skill reads and explains only — it never buys, never installs, and never states a price from memory.
----
-
-# upgrade-plan
-
-Answer "what does a paid level get me, and which one should I buy?" from two
-live sources: the public pricing page (for prices) and this repository (for
-what the site actually uses). A bundled helper does the reading and the
-choosing; this skill runs it and explains the result in plain words.
-
-## When to use
-
-- "what does Pro get me?" / "what's in Pro Plus?"
-- "should I upgrade?" / "which plan do I need?"
-- "compare the plans" / "how does Agency work?"
-- "can I sell things on my site?" / "how much is the commerce add-on?"
-- `/upgrade-plan`
-
-Skip this skill when the user wants to actually buy or install something —
-this skill explains and recommends; the purchase happens on the pricing
-page, and installing a module is a separate step (see "What happens next").
-
-## The mechanic
-
-### Step 1 — Map the user's stated need (optional)
-
-If the user said what they want to do, map it to one `--need` value:
-
-| The user says…                                    | `--need`       |
-| ------------------------------------------------- | -------------- |
-| "I build sites for clients"                        | `agency`       |
-| "I want to sell / take payments"                   | `sell`         |
-| "my product bills its own customers on plans"      | `saas`         |
-| "I bill my customers by usage / credits"           | `usage`        |
-| "I need docs or a blog"                            | `docs`         |
-| "I need booking / scheduling"                      | `scheduling`   |
-| "I need organizations / teams / many workspaces"   | `multi-tenant` |
-
-If the need maps to none of these, omit `--need`, and tell the user which
-need you could not map — the recommendation then comes from the site alone.
-
-### Step 2 — Run the helper
-
-From the project root:
-
-```bash
-pnpm exec tsx .claude/skills/upgrade-plan/scripts/upgrade-plan.ts [--need <value>]
-```
-
-It prints one JSON object:
-
-- `pricing.status` — `ok` (the page published prices), `unpublished` (the
-  page loaded but carries no machine-readable offers) or `unreachable`
-  (network error, timeout or error status). `pricing.url` is the link to give
-  the user.
-- `options[]` — the seven options, always all seven, each with `adds`,
-  `requires`, and `prices[]` (empty, with `status: "not published on the
-  pricing page"`, when the page does not price it).
-- `alsoPublished[]` — other offers on the pricing page that are none of the
-  seven (for example a one-off service), with their published price.
-- `site` — this site's `modules`, `template`, `shape`, `design`, whether it
-  already prices something (`sellsSomething`), whether commerce is installed,
-  and whether `AILK_LICENSE_KEY` is set in this shell (`licenseKeySet` —
-  presence only, never the value).
-- `recommendation` — one `option`, its `reason`, and its `link`.
-
-Exit status 0 in all three pricing states. Exit 2 is a usage error — re-run
-without the argument it names.
-
-### Step 3 — Explain it
-
-Answer in this order, in plain words:
-
-1. **Your site.** State the shape and the modules from `site`, the template
-   and design when recorded, whether it already prices anything, and whether
-   a licence key is set in this shell. A `null` field is "not recorded —
-   scaffolded without `--template`"; never guess a shape. If the key is not
-   set, say "not set in this shell" (a key kept only in `.env` reads that way).
-2. **The options, side by side.** A table of all seven options: name, what it
-   adds, what it requires, and its price exactly as `prices[]` gives it
-   (figure, currency and unit text). An option with no price reads
-   "not published on the pricing page — see https://ailaunchkit.ai/pricing".
-   Then list `alsoPublished` under "Also on the pricing page".
-3. **The recommendation.** Exactly one option — `recommendation.option` —
-   with its reason, naming the module or need that decided it. Do not offer a
-   second recommendation; you may say what would change it (for example "if
-   you add multi-tenant later, that moves you to Pro Plus").
-4. **What happens next.** Link `recommendation.link`. After purchase the
-   licence key arrives by email. To install a paid module into this site
-   in place, run `AILK_LICENSE_KEY=<key> pnpm create ailk@latest
-   add-module <module>` in the site root, once per module; it leaves
-   every file the site already has as-is except `package.json`
-   dependency/script keys, `next.config.*` and `jest.config.*`, which it
-   patches. `pnpm create ailk@latest license set -` (key on stdin) keeps
-   the key with the site (and, on a site linked to Vercel, sets it there
-   and redeploys). A different design is
-   `pnpm create ailk@latest apply-design <name|path>`.
-
-## Hard rules
-
-- **Never state a price that is not in the helper's output for this run.**
-  Not from memory, not from an earlier run, not from another page, not as an
-  estimate or a range. A price appears in your answer only if it appears in
-  this run's `options[].prices` or `alsoPublished`.
-- **Unreachable means no prices.** When `pricing.status` is `unreachable`,
-  say the pricing page could not be reached, give no price for any option,
-  and link https://ailaunchkit.ai/pricing. Still show the site and the
-  recommendation — neither depends on a price.
-- **Unpublished means no prices.** When `pricing.status` is `unpublished`,
-  say the pricing page does not publish machine-readable prices yet and link
-  https://ailaunchkit.ai/pricing.
-- **Read-only.** Write no file and install nothing. The helper is the only
-  command you run; `add-module`, `license set` and `apply-design` are named
-  for the owner to run, never run by you.
-- **Never print the licence key.** Report only whether it is set.
-
-## References
-
-- `references/options.md` — the seven options in plain words.

package/templates/.claude/skills/upgrade-plan/references/options.md

@@ -1,24 +0,0 @@
-# The options
-
-What each option adds and what it requires, in plain words. Names and
-structure only — prices come from https://ailaunchkit.ai/pricing at run time,
-never from this file.
-
-Source: the AI Launch Kit product vocabulary (Commerce; Packaging and
-delivery). Levels are Free, Pro and Pro Plus; Agency is an agreement, not a
-level; Commerce, SaaS and SaaS with Usage are the three rungs of the one
-commerce add-on, bought on top of a level.
-
-| Option              | What it adds                                                                                                                         | Requires                                  |
-| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- |
-| **Free**            | The open-source base: the website, its API and MCP server, and the marketing module. Every site is agent-discoverable at this level. | Nothing — no licence key                  |
-| **Pro**             | The paid modules for one site — docs and blog, scheduling, signal collectors, the Admin app — kept current.                    | A licence key for the site                |
-| **Pro Plus**        | Everything in Pro, plus the multi-tenant module: organizations, workspaces and members.                                              | A licence key for the site                |
-| **Agency**          | A reseller agreement for building sites for clients. Not a bigger level.                                                             | Each client site is licensed Pro or Pro Plus |
-| **Commerce**        | Checkout, payment links, hosted invoices, subscriptions and the customer portal, through your own Stripe account.                    | Any paid level (Pro or Pro Plus)          |
-| **SaaS**            | Commerce plus plans, trials, coupons and entitlements mapped to feature flags — for a product that bills its tenants.                | Pro Plus                                  |
-| **SaaS with Usage** | SaaS plus usage metering, prepaid credits, overage and spend limits.                                                                  | Pro Plus                                  |
-
-Payment always happens on a Stripe-hosted page; the site never renders a card
-form. Paid bookings (deposits, no-show holds) belong to the scheduling module,
-not to Commerce.

package/templates/.claude/skills/upgrade-plan/scripts/upgrade-plan.ts

@@ -1,527 +0,0 @@
-/**
- * upgrade-plan — the helper behind the `/upgrade-plan` skill.
- *
- * Reads the paid options' prices from ONE public surface — the schema.org
- * `Offer` JSON-LD on https://ailaunchkit.ai/pricing — at run time, reads this
- * site's own modules / template / shape / design from files the scaffold
- * already carries, and recommends exactly one option from a price-free rule
- * table (levels per the AI Launch Kit product vocabulary). It holds no price of
- * its own, caches nothing, and writes nothing.
- *
- * Run from the project root:
- *
- *   pnpm exec tsx .claude/skills/upgrade-plan/scripts/upgrade-plan.ts [--need X] [--url U | --html-file F] [--root R]
- *
- * Prints one JSON object. Exit 0 whether the page was priced, unpriced or
- * unreachable (each is a reported state); exit 2 on a usage error.
- */
-import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { join } from "node:path";
-
-export const PRICING_URL = "https://ailaunchkit.ai/pricing";
-const DEFAULT_TIMEOUT_MS = 10_000;
-
-export type OptionId = "free" | "pro" | "pro-plus" | "agency" | "commerce" | "saas" | "saas-usage";
-
-export interface OptionInfo {
-  id: OptionId;
-  name: string;
-  adds: string;
-  requires: string;
-  /** Normalized names (see `normalizeName`) an `Offer` may carry for this option. */
-  aliases: string[];
-}
-
-/** The seven options, always listed, in this order. Names and structure only — no figure. */
-export const OPTIONS: readonly OptionInfo[] = [
-  {
-    id: "free",
-    name: "Free",
-    adds: "The open-source base: the website, its API and MCP server, and the marketing module.",
-    requires: "Nothing — no licence key.",
-    aliases: ["free", "oss"],
-  },
-  {
-    id: "pro",
-    name: "Pro",
-    adds: "The paid modules for one site — docs and blog, scheduling, signal collectors and the Admin app — kept current.",
-    requires: "A licence key for the site.",
-    aliases: ["pro"],
-  },
-  {
-    id: "pro-plus",
-    name: "Pro Plus",
-    adds: "Everything in Pro, plus the multi-tenant module (organizations, workspaces, members).",
-    requires: "A licence key for the site.",
-    aliases: ["pro plus"],
-  },
-  {
-    id: "agency",
-    name: "Agency",
-    adds: "A reseller agreement for building sites for clients — not a bigger level.",
-    requires: "Each client site is then licensed at Pro or Pro Plus.",
-    aliases: ["agency"],
-  },
-  {
-    id: "commerce",
-    name: "Commerce",
-    adds: "The commerce add-on: checkout, payment links, hosted invoices, subscriptions and the customer portal, through your own Stripe account.",
-    requires: "Any paid level (Pro or Pro Plus).",
-    aliases: ["commerce", "commerce add-on"],
-  },
-  {
-    id: "saas",
-    name: "SaaS",
-    adds: "Commerce plus plans, trials, coupons and entitlements mapped to feature flags — for a product that bills its tenants.",
-    requires: "Pro Plus.",
-    aliases: ["saas"],
-  },
-  {
-    id: "saas-usage",
-    name: "SaaS with Usage",
-    adds: "SaaS plus usage metering, prepaid credits, overage and spend limits.",
-    requires: "Pro Plus.",
-    aliases: ["saas with usage", "saas-usage"],
-  },
-];
-
-export const NEEDS = ["agency", "sell", "saas", "usage", "docs", "scheduling", "multi-tenant"] as const;
-export type Need = (typeof NEEDS)[number];
-
-export interface Offer {
-  name: string;
-  price?: string;
-  priceCurrency?: string;
-  unitText?: string;
-  url?: string;
-}
-
-export interface Price {
-  price: string;
-  priceCurrency?: string;
-  unitText?: string;
-  url?: string;
-}
-
-export interface Site {
-  modules: string[];
-  template: string | null;
-  shape: string | null;
-  design: string | null;
-  sellsSomething: boolean;
-  commerceInstalled: boolean;
-  licenseKeySet: boolean;
-}
-
-export interface Recommendation {
-  rule: "R1" | "R2" | "R3" | "R4" | "R5" | "R6" | "R7";
-  option: string;
-  parts: OptionId[];
-  reason: string;
-}
-
-export interface PlanOption {
-  id: OptionId;
-  name: string;
-  adds: string;
-  requires: string;
-  prices: Price[];
-  status: "published" | "not published on the pricing page";
-}
-
-export interface Plan {
-  pricing: {
-    status: "ok" | "unreachable" | "unpublished";
-    /** The link shown to the human — always the public pricing page. */
-    url: string;
-    /** The URL actually fetched (differs only under `--url`). */
-    fetchedUrl: string;
-    reason?: string;
-  };
-  options: PlanOption[];
-  alsoPublished: Offer[];
-  site: Site;
-  recommendation: Recommendation & { link: string };
-}
-
-// ── Offers ────────────────────────────────────────────────────────────────
-
-const LD_JSON_BLOCK = /<script[^>]*type\s*=\s*["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi;
-
-function str(v: unknown): string | undefined {
-  if (typeof v === "string" && v.length > 0) return v;
-  if (typeof v === "number" && Number.isFinite(v)) return String(v);
-  return undefined;
-}
-
-function isOffer(node: Record<string, unknown>): boolean {
-  const t = node["@type"];
-  return t === "Offer" || (Array.isArray(t) && t.includes("Offer"));
-}
-
-function toOffer(node: Record<string, unknown>, parentName: string | undefined): Offer | null {
-  const name = str(node.name) ?? parentName;
-  if (name === undefined) return null;
-  const specs = Array.isArray(node.priceSpecification) ? node.priceSpecification : [node.priceSpecification];
-  const spec = specs.find((s): s is Record<string, unknown> => typeof s === "object" && s !== null);
-  const offer: Offer = { name };
-  const price = str(node.price) ?? str(spec?.price);
-  const priceCurrency = str(node.priceCurrency) ?? str(spec?.priceCurrency);
-  const unitText = str(spec?.unitText);
-  const url = str(node.url);
-  if (price !== undefined) offer.price = price;
-  if (priceCurrency !== undefined) offer.priceCurrency = priceCurrency;
-  if (unitText !== undefined) offer.unitText = unitText;
-  if (url !== undefined) offer.url = url;
-  return offer;
-}
-
-function collectOffers(node: unknown, parentName: string | undefined, out: Offer[]): void {
-  if (Array.isArray(node)) {
-    for (const item of node) collectOffers(item, parentName, out);
-    return;
-  }
-  if (typeof node !== "object" || node === null) return;
-  const obj = node as Record<string, unknown>;
-  if (isOffer(obj)) {
-    const offer = toOffer(obj, parentName);
-    if (offer !== null) out.push(offer);
-    // An offer may carry others (an `addOn`, an `itemOffered` chain) — walk them too.
-    for (const value of Object.values(obj)) collectOffers(value, offer?.name ?? parentName, out);
-    return;
-  }
-  const ownName = str(obj.name) ?? parentName;
-  for (const value of Object.values(obj)) collectOffers(value, ownName, out);
-}
-
-/** Every `Offer` node in the page's `application/ld+json` blocks, in document order. */
-export function parseOffers(html: string): Offer[] {
-  const out: Offer[] = [];
-  for (const match of html.matchAll(LD_JSON_BLOCK)) {
-    let data: unknown;
-    try {
-      data = JSON.parse(match[1] ?? "");
-    } catch {
-      continue; // a block that fails to parse is skipped, not fatal
-    }
-    collectOffers(data, undefined, out);
-  }
-  return out;
-}
-
-/** Lower-case, drop a parenthetical and a product prefix, collapse whitespace. */
-export function normalizeName(name: string): string {
-  return name
-    .toLowerCase()
-    .replace(/\([^)]*\)/g, " ")
-    .replace(/\s+/g, " ")
-    .trim()
-    .replace(/^(ailk|ai launch kit) /, "");
-}
-
-function matchOption(offer: Offer): OptionInfo | undefined {
-  const n = normalizeName(offer.name);
-  return OPTIONS.find((o) => o.aliases.includes(n));
-}
-
-// ── The site ──────────────────────────────────────────────────────────────
-
-function readText(path: string): string | null {
-  try {
-    return readFileSync(path, "utf8");
-  } catch {
-    return null;
-  }
-}
-
-function readJson(path: string): Record<string, unknown> | null {
-  const text = readText(path);
-  if (text === null) return null;
-  try {
-    const data: unknown = JSON.parse(text);
-    return typeof data === "object" && data !== null ? (data as Record<string, unknown>) : null;
-  } catch {
-    return null;
-  }
-}
-
-function listMdx(dir: string): string[] {
-  if (!existsSync(dir)) return [];
-  const out: string[] = [];
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    const full = join(dir, entry.name);
-    if (entry.isDirectory()) out.push(...listMdx(full));
-    else if (entry.isFile() && entry.name.endsWith(".mdx")) out.push(full);
-  }
-  return out;
-}
-
-/** True when the file's frontmatter carries a TOP-LEVEL `price:` that is a real figure. */
-function hasTopLevelPrice(mdx: string): boolean {
-  const fm = /^---\r?\n([\s\S]*?)\r?\n---/.exec(mdx);
-  if (fm === null) return false;
-  const line = /^price:[ \t]*(.*)$/m.exec(fm[1] ?? "");
-  if (line === null) return false;
-  const value = (line[1] ?? "").trim().replace(/^["']|["']$/g, "");
-  return !value.includes("{") && /^\d+(\.\d+)?$/.test(value);
-}
-
-/** What this scaffold records about itself. Each field from its own source; nothing inferred. */
-export function readSite(root: string, env: Record<string, string | undefined> = process.env): Site {
-  const arch = readText(join(root, "architecture.yaml"));
-  const modulesLine = arch === null ? null : /^# Modules:[ \t]*(.*)$/m.exec(arch);
-  const modules =
-    modulesLine === null
-      ? []
-      : (modulesLine[1] ?? "")
-          .split(",")
-          .map((m) => m.trim())
-          .filter((m) => m.length > 0);
-
-  let template: string | null = null;
-  const provenance = readJson(join(root, ".ailk-template.json"));
-  if (provenance !== null) {
-    template = str(provenance.template) ?? null;
-  } else {
-    const design = readText(join(root, "DESIGN.md"));
-    const source = design === null ? null : /Source template:[ \t]*(\S+)/.exec(design);
-    const value = source?.[1];
-    if (value !== undefined && !value.startsWith("_base")) template = value;
-  }
-
-  // The scaffold's roster of record (#6658 D7); a scaffold from before it
-  // carries the same JSON at its root under the template's own file name.
-  const manifest =
-    readJson(join(root, ".ailk-site-manifest.json")) ?? readJson(join(root, "TEMPLATE-MANIFEST.json"));
-  const shape = str(manifest?.shape) ?? null;
-  const designName = str(manifest?.design) ?? null;
-
-  const sellsSomething = listMdx(join(root, "content")).some((f) => hasTopLevelPrice(readText(f) ?? ""));
-  const commerceInstalled = existsSync(join(root, ".claude", "skills", "scaffold-commerce"));
-  // Presence only: the value is reduced to a boolean here and never kept.
-  const key = env.AILK_LICENSE_KEY;
-  const licenseKeySet = typeof key === "string" && key.length > 0;
-
-  return { modules, template, shape, design: designName, sellsSomething, commerceInstalled, licenseKeySet };
-}
-
-// ── The recommendation ────────────────────────────────────────────────────
-
-const PRO_MODULES = ["docs-blog", "scheduling", "signal-collectors", "workspace"];
-
-/** One recommendation from a price-free rule table; the first matching rule wins. */
-export function recommend(site: Site, need?: Need): Recommendation {
-  const has = (m: string): boolean => site.modules.includes(m);
-  const multiTenant = has("multi-tenant") || need === "multi-tenant";
-
-  if (need === "agency") {
-    return {
-      rule: "R1",
-      option: "Agency",
-      parts: ["agency"],
-      reason: "You build sites for clients; each client site is then Pro or Pro Plus.",
-    };
-  }
-  if (need === "usage") {
-    return {
-      rule: "R2",
-      option: "Pro Plus + SaaS with Usage",
-      parts: ["pro-plus", "saas-usage"],
-      reason: "You want to meter your own product's usage; SaaS with Usage requires Pro Plus.",
-    };
-  }
-  if (need === "saas") {
-    return {
-      rule: "R3",
-      option: "Pro Plus + SaaS",
-      parts: ["pro-plus", "saas"],
-      reason: "You want to bill your own tenants on plans; SaaS requires Pro Plus.",
-    };
-  }
-  if (multiTenant && !sells(site, need)) {
-    return {
-      rule: "R4",
-      option: "Pro Plus",
-      parts: ["pro-plus"],
-      reason: has("multi-tenant")
-        ? "This site uses the multi-tenant module, which needs Pro Plus."
-        : "You need multi-tenant (organizations and workspaces), which needs Pro Plus.",
-    };
-  }
-  if (sells(site, need)) {
-    const why = has("commerce")
-      ? "This site uses the commerce module"
-      : site.commerceInstalled
-        ? "This site has the commerce skill installed"
-        : site.sellsSomething
-          ? "This site already has priced pages but no commerce module"
-          : "You want to take payments on this site";
-    return multiTenant
-      ? {
-          rule: "R5",
-          option: "Pro Plus + Commerce",
-          parts: ["pro-plus", "commerce"],
-          reason: `${why}; the Commerce add-on sits on a paid level, and multi-tenant needs Pro Plus.`,
-        }
-      : {
-          rule: "R5",
-          option: "Pro + Commerce",
-          parts: ["pro", "commerce"],
-          reason: `${why}; the Commerce add-on sits on a paid level, and Pro is the first one.`,
-        };
-  }
-  const proModules = site.modules.filter((m) => PRO_MODULES.includes(m));
-  if (proModules.length > 0 || need === "docs" || need === "scheduling") {
-    const named = proModules.length > 0 ? proModules.join(", ") : need === "docs" ? "docs-blog" : "scheduling";
-    return {
-      rule: "R6",
-      option: "Pro",
-      parts: ["pro"],
-      reason: `${proModules.length > 0 ? "This site uses" : "You want"} ${named}, which Pro covers.`,
-    };
-  }
-  return {
-    rule: "R7",
-    option: "Free",
-    parts: ["free"],
-    reason:
-      "This site is marketing only with nothing priced, so what it uses today is covered by Free; Pro adds a kept-current foundation and the paid modules.",
-  };
-}
-
-function sells(site: Site, need?: Need): boolean {
-  return site.modules.includes("commerce") || site.commerceInstalled || need === "sell" || site.sellsSomething;
-}
-
-// ── The plan ──────────────────────────────────────────────────────────────
-
-async function fetchPage(
-  url: string,
-  fetchImpl: typeof fetch,
-  timeoutMs: number,
-): Promise<{ html: string } | { error: string }> {
-  const controller = new AbortController();
-  let timer: ReturnType<typeof setTimeout> | undefined;
-  const timeout = new Promise<{ error: string }>((resolve) => {
-    timer = setTimeout(() => {
-      controller.abort();
-      resolve({ error: `timed out after ${timeoutMs} ms` });
-    }, timeoutMs);
-  });
-  const attempt = (async (): Promise<{ html: string } | { error: string }> => {
-    try {
-      const res = await fetchImpl(url, { signal: controller.signal, redirect: "follow" });
-      if (!res.ok) return { error: `HTTP status ${res.status}` };
-      return { html: await res.text() };
-    } catch (err) {
-      return { error: err instanceof Error ? err.message : String(err) };
-    }
-  })();
-  try {
-    return await Promise.race([attempt, timeout]);
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-export async function buildPlan(opts: {
-  root: string;
-  need?: Need;
-  url?: string;
-  html?: string;
-  fetch?: typeof fetch;
-  timeoutMs?: number;
-}): Promise<Plan> {
-  const fetchedUrl = opts.url ?? PRICING_URL;
-  let html: string | undefined = opts.html;
-  let reason: string | undefined;
-  if (html === undefined) {
-    const page = await fetchPage(fetchedUrl, opts.fetch ?? fetch, opts.timeoutMs ?? DEFAULT_TIMEOUT_MS);
-    if ("html" in page) html = page.html;
-    else reason = page.error;
-  }
-
-  const offers = html === undefined ? [] : parseOffers(html);
-  const prices = new Map<OptionId, Price[]>(OPTIONS.map((o) => [o.id, []]));
-  const alsoPublished: Offer[] = [];
-  for (const offer of offers) {
-    const option = matchOption(offer);
-    if (option === undefined || offer.price === undefined) {
-      if (option === undefined) alsoPublished.push(offer);
-      continue;
-    }
-    const { name: _name, ...price } = offer;
-    prices.get(option.id)?.push({ ...price, price: offer.price });
-  }
-
-  const options: PlanOption[] = OPTIONS.map((o) => {
-    const p = prices.get(o.id) ?? [];
-    return {
-      id: o.id,
-      name: o.name,
-      adds: o.adds,
-      requires: o.requires,
-      prices: p,
-      status: p.length > 0 ? "published" : "not published on the pricing page",
-    };
-  });
-
-  const site = readSite(opts.root);
-  const rec = recommend(site, opts.need);
-  const link = prices.get(rec.parts[0] ?? "free")?.find((p) => p.url !== undefined)?.url ?? PRICING_URL;
-
-  const priced = options.some((o) => o.prices.length > 0) || alsoPublished.some((o) => o.price !== undefined);
-  const status = html === undefined ? "unreachable" : priced ? "ok" : "unpublished";
-  return {
-    pricing: { status, url: PRICING_URL, fetchedUrl, ...(reason !== undefined ? { reason } : {}) },
-    options,
-    alsoPublished,
-    site,
-    recommendation: { ...rec, link },
-  };
-}
-
-// ── CLI ───────────────────────────────────────────────────────────────────
-
-const USAGE =
-  "usage: upgrade-plan.ts [--need agency|sell|saas|usage|docs|scheduling|multi-tenant] [--url U | --html-file F] [--root R]";
-
-function usageError(message: string): never {
-  process.stderr.write(`${message}\n${USAGE}\n`);
-  process.exit(2);
-}
-
-async function main(argv: string[]): Promise<void> {
-  const opts: { root: string; need?: Need; url?: string; html?: string } = { root: process.cwd() };
-  for (let i = 0; i < argv.length; i++) {
-    const flag = argv[i];
-    const value = argv[i + 1];
-    if (flag !== "--need" && flag !== "--url" && flag !== "--html-file" && flag !== "--root") {
-      usageError(`unknown argument: ${flag}`);
-    }
-    if (value === undefined || value.startsWith("--")) usageError(`${flag} needs a value`);
-    i++;
-    if (flag === "--need") {
-      if (!(NEEDS as readonly string[]).includes(value)) usageError(`unknown need: ${value}`);
-      opts.need = value as Need;
-    } else if (flag === "--url") {
-      opts.url = value;
-    } else if (flag === "--html-file") {
-      const text = readText(value);
-      if (text === null) usageError(`cannot read ${value}`);
-      opts.html = text;
-    } else {
-      opts.root = value;
-    }
-  }
-  if (opts.url !== undefined && opts.html !== undefined) usageError("--url and --html-file are exclusive");
-  const plan = await buildPlan(opts);
-  process.stdout.write(`${JSON.stringify(plan, null, 2)}\n`);
-}
-
-if (/upgrade-plan\.ts$/.test(process.argv[1] ?? "")) {
-  main(process.argv.slice(2)).catch((err: unknown) => {
-    process.stderr.write(`upgrade-plan: ${err instanceof Error ? err.message : String(err)}\n`);
-    process.exit(1);
-  });
-}