katman-mcp 0.2.0 → 0.3.0

package/dist/tools/account/account.js

@@ -1,9 +1,9 @@
-// katman_account (always open, even without a key): the Katman plan behind KATMAN_KEY (none, Audit Week with the
-// days left, or Katman Pro), the tools it unlocks, the masked account email, the last check, and how to get a key
-// or upgrade. Never shows the key.
+// katman_account (always open, even without a key): the Katman plan behind KATMAN_KEY (none, Katman Pro with this
+// month's audits and sites, or an Audit Week bought earlier with the days left), the tools it unlocks, the masked
+// account email, the last check, and how to get a key or upgrade. Never shows the key.
 import { OPEN_TOOLS, TOOL_FEATURES, allows, toolsOf } from "../../license.js";
-import { APP_URL, BILLING_URL, KEYS_URL, PRICING_URL, PRO_PRICE_NOTE } from "../../meta.js";
-import { NO_KEY_TEXT, endedPhrase, fmtDay, fmtWhen, howToText, planDaysLeft, reasonText } from "./upsell.js";
+import { APP_URL, AUDIT_COUNT_NOTE, BILLING_URL, BUY_PRO_3_URL, KEYS_URL, PRICING_URL, PRO_PRICE_NOTE } from "../../meta.js";
+import { NO_KEY_TEXT, endedPhrase, fmtDay, fmtWhen, howToText, planDaysLeft, proPlanName, reasonText, usageText } from "./upsell.js";
 function planCell(s, left) {
     if (s.state === "no_key")
         return s.hint ? "None (KATMAN_KEY placeholder not filled)" : "None (no KATMAN_KEY)";
@@ -12,7 +12,7 @@ function planCell(s, left) {
     if (s.plan === "audit")
         return `Audit Week: ${left ?? "?"} day${left === 1 ? "" : "s"} left (ends ${fmtDay(s.planEndsAt)}; no auto-renewal)`;
     if (s.plan === "pro")
-        return "Katman Pro";
+        return proPlanName(s.limits);
     return `No active plan${s.planEnded ? ` (${endedPhrase(s)})` : s.auditWeekUsed ? " (Audit Week used)" : ""}`;
 }
 /** "on", "3 of 10 on" or "off". */
@@ -35,19 +35,25 @@ export async function runAccount(provider, opts = {}) {
         ["Features", s.features.length ? s.features.join(", ") : "none"],
         ["Last check", s.checkedAt ? `${fmtWhen(s.checkedAt)} (${source}${s.nextCheckAt && s.source !== "offline-grace" ? `; next check after ${fmtWhen(s.nextCheckAt)}` : ""})` : `– (${source})`],
     ];
+    if (s.state === "valid" && s.plan === "pro" && s.limits)
+        rows.splice(1, 0, ["Usage", usageText(s.limits, s.usage)]);
+    if (s.state === "valid" && s.updateMcpTo)
+        rows.push(["Update", `katman-mcp ${s.updateMcpTo} or newer is needed to count audits against this plan (audits are off until then): npx -y katman-mcp@latest, restart the MCP server, then katman_account with refresh: true`]);
     if (s.error)
         rows.push(["Connection", `couldn't reach katman.pro: ${s.error}`]);
     const L = ["# Katman account", rows.map(([k, v]) => `- **${k}:** ${v}`).join("\n")];
     L.push([
-        `**Audit Week tools** (${onText(auditTools, s)}; Audit Week or Pro): ${auditTools.join(", ")}.`,
-        `**Katman Pro tools** (${onText(proTools, s)}; Pro only): ${proTools.join(", ")}.`,
+        `**Audit tools** (${onText(auditTools, s)}; Katman Pro): ${auditTools.join(", ")}.`,
+        `**Page-building tools** (${onText(proTools, s)}; Katman Pro): ${proTools.join(", ")}.`,
         `**Always open:** ${OPEN_TOOLS.join(", ")}.`,
     ].join("\n"));
     if (s.state === "valid" && s.plan === "pro") {
+        if (s.limits)
+            L.push(`${AUDIT_COUNT_NOTE}${s.limits.auditsPerMonth === 5 ? ` Katman Pro, 3 sites allows 3 sites and 30 audits a month: ${BUY_PRO_3_URL}.` : ""}`);
         L.push(`Manage the subscription and invoices at ${BILLING_URL}.`);
     }
     else if (s.state === "valid" && s.plan === "audit") {
-        L.push(`Your Audit Week ends on ${fmtDay(s.planEndsAt)} and doesn't renew. Katman Pro builds the pages (the P0–P14 prompts, page briefs, file generation, IndexNow, monitoring and the dashboard sync): ${PRO_PRICE_NOTE}, at ${BILLING_URL}. The key stays the same.`);
+        L.push(`Your Audit Week ends on ${fmtDay(s.planEndsAt)} and doesn't renew. Katman Pro builds the pages (the P0–P14 prompts, page briefs, file generation, IndexNow, monitoring and the dashboard sync): ${PRO_PRICE_NOTE}. Upgrade at ${BILLING_URL}; the key stays the same.`);
     }
     else {
         if (s.state === "no_key" && !s.hint)
@@ -56,7 +62,7 @@ export async function runAccount(provider, opts = {}) {
             L.push(`**Why the tools are off:** ${reasonText(s)}`);
         L.push(howToText(s));
     }
-    L.push(`Network: Katman contacts katman.pro only to check this key (at most once a day and when a plan ends, only when KATMAN_KEY is set) and when you call katman_sync. The key is never shown or written to disk; the cache (~/.katman/license.json) stores its SHA-256 hash. Plans: ${PRICING_URL} · account and keys: ${APP_URL}.`);
+    L.push(`Network: Katman contacts katman.pro only to check this key (at most once a day and when a plan ends, only when KATMAN_KEY is set), to count an audit (right before each katman_audit_site run; it sends the domain being audited) and when you call katman_sync. The key is never shown or written to disk; the cache (~/.katman/license.json) stores its SHA-256 hash. Plans: ${PRICING_URL} · account and keys: ${APP_URL}.`);
     return {
         text: L.join("\n\n"),
         structured: {
@@ -67,6 +73,9 @@ export async function runAccount(provider, opts = {}) {
             planEnded: !!s.planEnded,
             endedPlan: s.endedPlan ?? null,
             auditWeekUsed: !!s.auditWeekUsed,
+            limits: s.limits ?? null,
+            usage: s.usage ?? null,
+            updateMcpTo: s.updateMcpTo ?? null,
             features: s.features,
             account: { emailMasked: s.emailMasked ?? null },
             checkedAt: s.checkedAt ?? null,

package/dist/tools/account/cli.js

@@ -16,8 +16,9 @@ export const commands = {
     },
 };
 export const help = [
-    "  katman-mcp account [--refresh]  your Katman plan (none / Audit Week / Pro), days left, and how to get a key or upgrade",
+    "  katman-mcp account [--refresh]  your Katman plan (none / Katman Pro / an older Audit Week), this month's audits and sites, and how to get a key or upgrade",
     "",
-    "Every command except account, --help and --version needs KATMAN_KEY with an active plan: Audit Week or Katman Pro",
-    "(indexnow: Katman Pro only). Without it a command explains the plans and exits with code 4. Plans: https://katman.pro/pricing",
+    "Every command except account, --help and --version needs KATMAN_KEY with an active Katman Pro plan (1 site $49/month: 5 audits a month;",
+    "3 sites $88/month: 30 audits a month; every command is included). Without it, or when this month's audits or sites are used, a command",
+    "explains why and exits with code 4. `audit` counts as one audit; every other command is not counted. Plans: https://katman.pro/pricing",
 ];

package/dist/tools/account/index.js

@@ -9,7 +9,7 @@ import { runSync } from "./sync.js";
 export function registerAccountTools(server, ctx) {
     server.registerTool("katman_account", {
         title: "Katman account and plan",
-        description: "Always works, even without a key. Shows the Katman plan behind KATMAN_KEY (none, Audit Week with the days left, or Katman Pro), the tools it unlocks, the account email (masked), when the key was last checked, and how to get a key or upgrade (the plans at katman.pro/pricing, with the exact MCP config snippet per editor). Checks the key with katman.pro at most once a day; refresh: true re-checks now (e.g. right after buying). Never shows the key.",
+        description: "Always works, even without a key. Shows the Katman plan behind KATMAN_KEY (none, Katman Pro 1 site or 3 sites with this month's audits and sites used, or an older Audit Week with the days left), the tools it unlocks, the account email (masked), when the key was last checked, and how to get a key or upgrade (the plans at katman.pro/pricing, with the exact MCP config snippet per editor). Checks the key with katman.pro at most once a day; refresh: true re-checks now (e.g. right after buying). Never shows the key.",
         inputSchema: {
             refresh: z.boolean().optional().describe("Re-check the key with katman.pro now instead of using today's cached answer (e.g. right after buying or upgrading)."),
         },

package/dist/tools/account/upsell.js

@@ -4,7 +4,7 @@
 // Only type imports from license.ts (license.ts imports this module); the plans come from plans.ts.
 import os from "node:os";
 import path from "node:path";
-import { AUDIT_PRICE_NOTE, BILLING_URL, KEYS_URL, KEY_DOCS_URL, PRICING_URL, PRO_PRICE_NOTE } from "../../meta.js";
+import { AUDIT_COUNT_NOTE, AUDIT_COUNT_NOTE_TR, BILLING_URL, BUY_PRO_1_URL, BUY_PRO_3_URL, KEYS_URL, KEY_DOCS_URL, PRICING_URL, PRO_3_NOTE, PRO_PRICE_NOTE, PRO_PRICE_NOTE_TR, VERSION, } from "../../meta.js";
 import { isProOnly } from "../../plans.js";
 import { listFiles } from "../../state.js";
 import { domainOf, mdTable, sortFindings, truncate } from "../../util.js";
@@ -12,9 +12,10 @@ import { GATES, STEPS } from "../method/data/method.js";
 import { t } from "../method/lib/l10n.js";
 import { loadConfigSafe, loadLatestAudit, loadResearchSafe, loadScan } from "../method/lib/state.js";
 /** Without a key: the two plans, where to get a key and where it goes. */
-export const NO_KEY_TEXT = `Katman needs a licence key (KATMAN_KEY). Audit Week — $3 for 7 days: audit, research, plan and AI-visibility checks; it doesn't build pages. Katman Pro — $29/month founding price ($290/year): everything, including the P0–P14 prompts, page briefs and file generation. Get a key at ${PRICING_URL}, then add KATMAN_KEY to your MCP config (${KEY_DOCS_URL}).`;
+export const NO_KEY_TEXT = `Katman needs a licence key (KATMAN_KEY). ${PRO_PRICE_NOTE}: audit, research, plan and AI-visibility checks, the P0–P14 prompts, page briefs and file generation. Get a key at ${PRICING_URL}, then add KATMAN_KEY to your MCP config (${KEY_DOCS_URL}).`;
+/** For an account that bought an Audit Week earlier (no longer sold): what it covers and the way up. */
 const AUDIT_COVERS = `Your Audit Week covers audit and recommendations; Pro builds the pages. Upgrade: ${BILLING_URL}`;
-/** Audit Week calling a Pro-only tool or command. */
+/** An Audit Week (bought earlier) calling a Pro-only tool or command. */
 function proToolText(name, kind) {
     return `${name} is a Katman Pro ${kind}. ${AUDIT_COVERS}`;
 }
@@ -119,6 +120,25 @@ function doneText(f) {
 // Status texts
 const day = (iso) => (iso ? iso.slice(0, 10) : "?");
 const when = (iso) => (iso ? `${iso.slice(0, 10)} ${iso.slice(11, 16)} UTC` : "–");
+/** "Katman Pro, 1 site" / "Katman Pro, 3 sites" from the plan's limits; "Katman Pro" when there are none (older plans). */
+export function proPlanName(limits) {
+    if (limits?.sites === 1 && limits.auditsPerMonth === 5)
+        return "Katman Pro, 1 site";
+    if (limits?.sites === 3 && limits.auditsPerMonth === 30)
+        return "Katman Pro, 3 sites";
+    return "Katman Pro";
+}
+const countOf = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+/** "3 of 5 audits, 1 of 1 site used this month (counts start again 2026-11-01)"; without counts: "5 audits and 1 site a month". */
+export function usageText(limits, usage) {
+    if (!usage)
+        return `${countOf(limits.auditsPerMonth, "audit", "audits")} and ${countOf(limits.sites, "site", "sites")} a month`;
+    return `${usage.audits} of ${countOf(limits.auditsPerMonth, "audit", "audits")}, ${usage.sites} of ${countOf(limits.sites, "site", "sites")} used this month (counts start again ${day(usage.resetsAt)})`;
+}
+/** The update notice for a katman-mcp too old to be counted (katman.pro's updateMcpTo). */
+function updateText(s) {
+    return `This katman-mcp (${VERSION}) can't count audits against your plan, so the audit is off until you update to ${s.updateMcpTo} or newer: run npx -y katman-mcp@latest, restart the MCP server (or reload the editor window), then call katman_account with refresh: true.`;
+}
 /** Days left in a running Audit Week (7 right after it starts, 1 on its last day). */
 export function planDaysLeft(s, now = new Date()) {
     if (s.plan !== "audit" || !s.planEndsAt)
@@ -174,10 +194,15 @@ export function reasonText(s, o = {}) {
                     return endedText(s, o.lang);
                 if (s.auditWeekUsed)
                     return tr ? "Bu hesabın etkin bir planı yok: tek Denetim Haftası kullanıldı." : "This account has no active plan: its one Audit Week has been used.";
-                return tr ? "Bu hesabın henüz etkin bir planı yok (Denetim Haftası ya da Katman Pro)." : "This account has no active plan yet (no Audit Week or Katman Pro).";
+                return tr ? "Bu hesabın henüz etkin bir Katman Pro planı yok." : "This account has no active Katman Pro plan yet.";
             }
             if (s.plan === "audit" && o.feature && isProOnly(o.feature))
                 return proToolText(o.name ?? "This tool", o.surface === "cli" ? "command" : "tool");
+            if (s.updateMcpTo) {
+                return tr
+                    ? `Bu katman-mcp (${VERSION}) planınızdaki denetimleri sayamıyor; ${s.updateMcpTo} ya da daha yeni bir sürüme güncelleyene kadar denetim kapalı: npx -y katman-mcp@latest çalıştırın, MCP sunucusunu yeniden başlatın, sonra katman_account aracını refresh: true ile çağırın.`
+                    : updateText(s);
+            }
             return tr
                 ? `Planınız katman.pro’ya göre “${o.feature ?? "bu özellik"}” özelliğini içermiyor.`
                 : `Your ${s.plan === "pro" ? "Katman Pro" : "Audit Week"} plan doesn't include "${o.feature ?? "this feature"}" according to katman.pro.`;
@@ -196,14 +221,17 @@ export function statusLine(s, now = new Date()) {
             return `**Katman plan:** not verified · couldn't reach katman.pro to check KATMAN_KEY (${s.error ?? "network error"}) · Katman's tools are off until a check succeeds`;
         case "valid": {
             const who = s.emailMasked ? ` · ${s.emailMasked}` : "";
-            if (s.plan === "pro")
-                return `**Katman plan:** Katman Pro · every tool on${who}${offlineText(s)}`;
+            if (s.plan === "pro") {
+                const used = s.limits ? ` · ${usageText(s.limits, s.usage)}` : "";
+                const update = s.updateMcpTo ? ` · update katman-mcp to ${s.updateMcpTo} (npx -y katman-mcp@latest): audits are off until then` : "";
+                return `**Katman plan:** ${proPlanName(s.limits)} · every tool on${used}${update}${who}${offlineText(s)}`;
+            }
             if (s.plan === "audit") {
                 const left = planDaysLeft(s, now);
                 return `**Katman plan:** Audit Week · ${left === undefined ? "" : `${left} day${left === 1 ? "" : "s"} left (until ${day(s.planEndsAt)}) · `}audit and recommendation tools on; the page-building tools need Katman Pro (${BILLING_URL})${who}${offlineText(s)}`;
             }
             const note = s.planEnded ? ` (${endedPhrase(s)})` : s.auditWeekUsed ? " (Audit Week used)" : "";
-            const next = s.endedPlan === "pro" ? "renew Katman Pro" : onlyPro(s) ? "upgrade to Katman Pro" : "Audit Week ($3 for 7 days) or Katman Pro";
+            const next = s.endedPlan === "pro" ? "renew Katman Pro" : onlyPro(s) ? "upgrade to Katman Pro" : "choose Katman Pro (1 site $49/month, 3 sites $88/month)";
             return `**Katman plan:** none${note} · ${next} at ${BILLING_URL}${who}`;
         }
     }
@@ -220,17 +248,17 @@ function nextStepLine(s, feature) {
             return "Check the internet connection, then call katman_account with refresh: true.";
         case "valid":
             if (s.plan === "none") {
-                return onlyPro(s) || (feature && isProOnly(feature))
-                    ? `${s.endedPlan === "pro" ? "Renew" : "Upgrade to"} Katman Pro at ${BILLING_URL}: ${PRO_PRICE_NOTE}. Then call katman_account with refresh: true.`
-                    : `Choose the Audit Week ($3 for 7 days) or Katman Pro at ${BILLING_URL}, then call katman_account with refresh: true.`;
+                return `${s.endedPlan === "pro" ? "Renew" : onlyPro(s) ? "Upgrade to" : "Choose"} Katman Pro at ${BILLING_URL}: ${PRO_PRICE_NOTE}. Then call katman_account with refresh: true.`;
             }
+            if (s.updateMcpTo)
+                return "Run the latest katman-mcp (npx -y katman-mcp@latest), restart the MCP server, then call katman_account with refresh: true.";
             return "Call katman_account with refresh: true; if it persists, run the latest Katman (npx -y katman-mcp@latest).";
     }
 }
 /** katman_start: the recommended next tool isn't in the plan. */
 export function planNotice(tool, feature, s) {
     if (s.state === "valid" && s.plan === "audit" && isProOnly(feature)) {
-        return `> **Needs Katman Pro:** ${proToolText(`\`${tool}\``, "tool")}\n> Katman Pro: ${PRO_PRICE_NOTE}; the key stays the same. After upgrading, call katman_account with refresh: true. Tell the user; the Audit Week tools keep working${s.planEndsAt ? ` until ${day(s.planEndsAt)}` : ""}.`;
+        return `> **Needs Katman Pro:** ${proToolText(`\`${tool}\``, "tool")}\n> ${PRO_PRICE_NOTE}. The key stays the same. After upgrading, call katman_account with refresh: true. Tell the user; the Audit Week tools keep working${s.planEndsAt ? ` until ${day(s.planEndsAt)}` : ""}.`;
     }
     return `> **Not in your plan:** \`${tool}\` won't run: ${reasonText(s, { feature, name: tool })} ${nextStepLine(s, feature)} Tell the user.`;
 }
@@ -303,16 +331,13 @@ export function howToText(s, o = {}) {
         case "valid":
             if (s.plan === "none" && s.endedPlan === "pro") {
                 return tr
-                    ? `### Katman Pro’yu yenileyin\nAnahtarınız aynı kalır: ${BILLING_URL} adresinden yeniden abone olun (kurucu fiyatıyla ayda 29 $ ya da yılda 290 $). Yeniden abone oldunuz mu? ${refresh}`
-                    : `### Renew Katman Pro\nThe key stays the same: resubscribe at ${BILLING_URL}. Katman Pro: ${PRO_PRICE_NOTE}. Already renewed? ${Refresh}`;
+                    ? `### Katman Pro’yu yenileyin\nAnahtarınız aynı kalır: ${BILLING_URL} adresinden yeniden abone olun (${PRO_PRICE_NOTE_TR}). Yeniden abone oldunuz mu? ${refresh}`
+                    : `### Renew Katman Pro\nThe key stays the same: resubscribe at ${BILLING_URL}. ${PRO_PRICE_NOTE}. Already renewed? ${Refresh}`;
             }
-            if (s.plan === "none" && (onlyPro(s) || (o.feature && isProOnly(o.feature)))) {
-                const why = onlyPro(s)
-                    ? tr ? "Her hesabın tek bir Denetim Haftası var; devam etmek için Katman Pro" : "Each account gets one Audit Week, so Katman Pro is the way to continue"
-                    : tr ? "Bu araç Katman Pro’da; Denetim Haftası yalnızca denetim araçlarını kapsar" : "This tool is in Katman Pro; the Audit Week covers only the audit tools";
+            if (s.plan === "none" && onlyPro(s)) {
                 return tr
-                    ? `### Katman Pro’ya geçin\n${why}: kurucu fiyatıyla ayda 29 $ (ilk 100 müşteri; abonelik sürdükçe değişmez, sonrasında 49 $) ya da yılda 290 $, ${BILLING_URL}. Anahtar aynı kalır. Geçtiniz mi? ${refresh}`
-                    : `### Upgrade to Katman Pro\n${why}: ${PRO_PRICE_NOTE}, at ${BILLING_URL}. The key stays the same. Already upgraded? ${Refresh}`;
+                    ? `### Katman Pro’ya geçin\n${PRO_PRICE_NOTE_TR}: ${BILLING_URL}. Anahtar aynı kalır. Geçtiniz mi? ${refresh}`
+                    : `### Upgrade to Katman Pro\n${PRO_PRICE_NOTE}. Upgrade at ${BILLING_URL}; the key stays the same. Already upgraded? ${Refresh}`;
             }
             if (s.plan === "none") {
                 return tr
@@ -320,7 +345,12 @@ export function howToText(s, o = {}) {
                     : `### Choose a plan\n${plansList("en")}\n\nBuy at ${BILLING_URL}; the key stays the same. Then ${refresh}`;
             }
             if (s.plan === "audit" && o.feature && isProOnly(o.feature)) {
-                return `### Upgrade to Katman Pro\nKatman Pro: ${PRO_PRICE_NOTE}; the key stays the same. Your Audit Week tools keep working${s.planEndsAt ? ` until ${day(s.planEndsAt)}` : ""}. Already upgraded? ${Refresh}`;
+                return `### Upgrade to Katman Pro\n${PRO_PRICE_NOTE}. Upgrade at ${BILLING_URL}; the key stays the same. Your Audit Week tools keep working${s.planEndsAt ? ` until ${day(s.planEndsAt)}` : ""}. Already upgraded? ${Refresh}`;
+            }
+            if (s.updateMcpTo) {
+                return tr
+                    ? `### Katman’ı güncelleyin\nBu sürüm planınızdaki denetimleri sayamıyor. En son sürümü çalıştırın (npx -y katman-mcp@latest), MCP sunucusunu yeniden başlatın ve ${refresh}`
+                    : `### Update Katman\nThis version can't count audits against your plan. Run the latest version (npx -y katman-mcp@latest), restart the MCP server (or reload the editor window), then ${refresh}`;
             }
             return tr
                 ? `### Katman’ı güncelleyin\nEn son sürümü çalıştırın (npx -y katman-mcp@latest) ve ${refresh} Sorun sürerse hello@katman.pro adresine yazın.`
@@ -331,24 +361,28 @@ export function howToText(s, o = {}) {
 function plansList(lang) {
     return lang === "tr"
         ? [
-            "- **Denetim Haftası**: 7 gün için 3 $, tek seferlik (kendiliğinden yenilenmez, hesap başına bir kez). Denetim, araştırma, plan ve yapay zekâ görünürlük ölçümleri; sayfa yapmaz, site dosyası yazmaz.",
-            "- **Katman Pro**: kurucu fiyatıyla ayda 29 $ (ilk 100 müşteri; abonelik sürdükçe değişmez, sonrasında 49 $) ya da yılda 290 $. Her şey: P0–P14 prompt’ları, sayfa brief’leri ve dosya üretimi dâhil.",
+            "- **Katman Pro, 1 site**: ayda 49 $. 1 site, ayda 5 denetim. Tüm araçlar: P0–P14 prompt’ları, sayfa brief’leri ve dosya üretimi dâhil.",
+            "- **Katman Pro, 3 site**: ayda 88 $. 3 site, ayda 30 denetim. Tüm araçlar, 1 siteli plandakiyle aynı.",
+            "",
+            AUDIT_COUNT_NOTE_TR,
         ].join("\n")
         : [
-            `- **Audit Week**: ${AUDIT_PRICE_NOTE}. Audit, research, plan and AI-visibility checks; it doesn't build pages or write site files.`,
-            `- **Katman Pro**: ${PRO_PRICE_NOTE}. Everything, including the P0–P14 prompts, page briefs and file generation.`,
+            "- **Katman Pro, 1 site**: $49/month. 1 site, 5 audits a month. Every tool, including the P0–P14 prompts, page briefs and file generation.",
+            "- **Katman Pro, 3 sites**: $88/month. 3 sites, 30 audits a month. Every tool, the same as the 1-site plan.",
+            "",
+            AUDIT_COUNT_NOTE,
         ].join("\n");
 }
 /** The two plans as a table (katman_start without a plan). */
 function plansTable(lang) {
     return lang === "tr"
         ? mdTable(["Plan", "Fiyat", "Kapsadığı"], [
-            ["**Denetim Haftası**", "7 gün için 3 $, tek seferlik (kendiliğinden yenilenmez, hesap başına bir kez)", "Denetim ve öneriler: katman_start, araştırma, kod taraması, canlı site denetimi, anahtar kelimeler, plan, içerik kontrolü, yapay zekâ görünürlük ölçümleri, elle kontroller ve rapor. Sayfa yapmaz, site dosyası yazmaz."],
-            ["**Katman Pro**", "Kurucu fiyatıyla ayda 29 $ (ilk 100 müşteri; abonelik sürdükçe değişmez, sonrasında 49 $) ya da yılda 290 $", "Her şey: P0–P14 prompt’ları, sayfa brief’leri, dosya üretimi (robots.txt, llms.txt, JSON-LD), IndexNow, zamanlanmış izleme ve katman.pro paneli dâhil."],
+            ["**Katman Pro, 1 site**", "Ayda 49 $", "1 site, ayda 5 denetim. Tüm araçlar: P0–P14 prompt’ları, sayfa brief’leri, dosya üretimi (robots.txt, llms.txt, JSON-LD), IndexNow, zamanlanmış izleme ve katman.pro paneli dâhil."],
+            ["**Katman Pro, 3 site**", "Ayda 88 $", "3 site, ayda 30 denetim. Tüm araçlar, 1 siteli plandakiyle aynı."],
         ])
         : mdTable(["Plan", "Price", "What it covers"], [
-            ["**Audit Week**", AUDIT_PRICE_NOTE, "Audit and recommendations: katman_start, research, code scan, live audit, keywords, plan, content lint, AI-visibility runs, manual checks and the report. It doesn't build pages or write site files."],
-            ["**Katman Pro**", PRO_PRICE_NOTE, "Everything, including the P0–P14 prompts, page briefs, file generation (robots.txt, llms.txt, JSON-LD), IndexNow, scheduled monitoring and the katman.pro dashboard."],
+            ["**Katman Pro, 1 site**", "$49/month", "1 site, 5 audits a month. Every tool, including the P0–P14 prompts, page briefs, file generation (robots.txt, llms.txt, JSON-LD), IndexNow, scheduled monitoring and the katman.pro dashboard."],
+            ["**Katman Pro, 3 sites**", "$88/month", "3 sites, 30 audits a month. Every tool, the same as the 1-site plan."],
         ]);
 }
 function headline(name, feature, s) {
@@ -371,13 +405,12 @@ export function renderUpsell(o) {
         return renderCliUpsell(o);
     const where = o.facts?.brand ?? o.facts?.domain;
     const done = doneText(o.facts);
-    const proOnly = isProOnly(o.feature) ? ` ${o.tool} is in Katman Pro; the Audit Week doesn't include it.` : "";
     return [
         `## ${headline(o.tool, o.feature, o.status)}`,
         `**What it would do${where ? ` for ${where}` : ""}:** ${upperFirst(pitch(o.tool, o.args ?? {}, o.facts))}`,
         ...(done ? [done] : []),
         `**Why it didn't run:** ${reasonText(o.status, { feature: o.feature, name: o.tool })}`,
-        ...(o.status.state === "no_key" ? [NO_KEY_TEXT + proOnly] : []),
+        ...(o.status.state === "no_key" ? [NO_KEY_TEXT] : []),
         howToText(o.status, { rerun: o.tool, feature: o.feature }),
         "Tell the user this in your own words. Don't try to work around it (no editing Katman's code or cache, no made-up keys); katman_account always works.",
     ].join("\n\n");
@@ -392,16 +425,13 @@ function renderCliUpsell(o) {
     ];
     if (s.state === "valid") {
         if (s.plan === "audit" && isProOnly(o.feature)) {
-            L.push(`Katman Pro: ${PRO_PRICE_NOTE}; the key stays the same. Already upgraded? Run: katman-mcp account --refresh`);
+            L.push(`Upgrade to Katman Pro at ${BILLING_URL}: ${PRO_PRICE_NOTE}. The key stays the same. Already upgraded? Run: katman-mcp account --refresh`);
         }
         else if (s.plan === "none" && s.endedPlan === "pro") {
-            L.push(`Renew Katman Pro at ${BILLING_URL}: ${PRO_PRICE_NOTE}; the key stays the same. Already renewed? Run: katman-mcp account --refresh`);
-        }
-        else if (s.plan === "none" && (onlyPro(s) || isProOnly(o.feature))) {
-            L.push(`Upgrade to Katman Pro at ${BILLING_URL}: ${PRO_PRICE_NOTE}${onlyPro(s) ? " (each account gets one Audit Week)" : ""}. The key stays the same. Already upgraded? Run: katman-mcp account --refresh`);
+            L.push(`Renew Katman Pro at ${BILLING_URL}: ${PRO_PRICE_NOTE}. The key stays the same. Already renewed? Run: katman-mcp account --refresh`);
         }
         else if (s.plan === "none") {
-            L.push(`Choose a plan at ${BILLING_URL}. Audit Week: ${AUDIT_PRICE_NOTE}. Katman Pro: ${PRO_PRICE_NOTE}. The key stays the same. Already bought? Run: katman-mcp account --refresh`);
+            L.push(`${onlyPro(s) ? "Upgrade to" : "Choose"} Katman Pro at ${BILLING_URL}: ${PRO_PRICE_NOTE}. The key stays the same. Already ${onlyPro(s) ? "upgraded" : "bought"}? Run: katman-mcp account --refresh`);
         }
         else {
             L.push("Run the latest version (npx -y katman-mcp@latest), then: katman-mcp account --refresh. If it persists, write to hello@katman.pro.");
@@ -418,14 +448,20 @@ function renderCliUpsell(o) {
     L.push("", "Without a key: katman-mcp account, --help and --version.");
     return L.join("\n");
 }
+/** The two plans on sale, for structuredContent (no secrets). */
+const PLANS_STRUCTURED = [
+    { id: "pro_1", name: "Katman Pro, 1 site", price: "$49/month", sites: 1, auditsPerMonth: 5, url: BUY_PRO_1_URL },
+    { id: "pro_3", name: "Katman Pro, 3 sites", price: "$88/month", sites: 3, auditsPerMonth: 30, url: BUY_PRO_3_URL },
+];
 /** structuredContent of a tool that didn't run for lack of a plan (no secrets). */
 export function upsellStructured(tool, feature, s) {
     return {
         licensed: false,
         tool,
         feature,
-        /** The cheapest plan that includes the feature. */
-        requiredPlan: isProOnly(feature) ? "pro" : "audit",
+        /** The plan to buy: every tool is in both Katman Pro plans (the Audit Week is no longer sold). */
+        requiredPlan: "pro",
+        plans: PLANS_STRUCTURED,
         license: {
             state: s.state,
             plan: s.plan,
@@ -461,7 +497,7 @@ export function startIntro(s, lang = "en") {
         L(`**4 steps:** ${steps}, then re-measure every 14 days.`, `**4 adım:** ${steps}; sonra 14 günde bir yeniden ölçüm.`),
         `## ${heading}`,
         ...(why ? [`**${L("Why nothing ran", "Neden çalışmadı")}:** ${why}`] : []),
-        ...(s.state === "unreachable" ? [] : [plansTable(lang)]),
+        ...(s.state === "unreachable" ? [] : [plansTable(lang), lang === "tr" ? AUDIT_COUNT_NOTE_TR : AUDIT_COUNT_NOTE]),
         howToText(s, { rerun: "katman_start", feature: "start", lang }),
         "Tell the user this in your own words, then stop: nothing else in Katman runs until KATMAN_KEY has an active plan. katman_account shows the plan at any time.",
     ].join("\n\n");
@@ -475,4 +511,85 @@ export function resourcePaywall(title, feature, s, then) {
             : `${reasonText(s, { feature })} ${nextStepLine(s, feature)}`;
     return `# ${title}\n\n${why}\n\n${then}`;
 }
+/** The status the no-plan / rejected-key answer of the audit check stands for, so the usual upsell can explain it. */
+function refusedStatus(o) {
+    const { use, status } = o;
+    if (use.reason === "invalid_key" || use.reason === "revoked") {
+        return { state: use.reason === "revoked" ? "revoked" : "invalid", plan: "none", features: [], source: "network", ...(status.keyHint ? { keyHint: status.keyHint } : {}) };
+    }
+    return { ...status, state: "valid", plan: "none", features: [] };
+}
+const onePro = (l) => l?.auditsPerMonth === 5;
+/** Why this month's allowance doesn't cover the audit (audit_limit / site_limit): one text for the MCP tool and the CLI. */
+function limitLines(o) {
+    const { use, domain } = o;
+    const lim = use.limits ?? undefined;
+    const usage = use.usage;
+    const resets = usage ? `Counts start again on ${day(usage.resetsAt)}.` : "Counts start again on the 1st of next month (UTC).";
+    const plan = proPlanName(lim);
+    const lines = [];
+    if (use.reason === "audit_limit") {
+        lines.push(lim
+            ? `All ${lim.auditsPerMonth} audits of this month are used (${plan}), so Katman didn't audit ${domain}. ${resets}`
+            : `This month's audits are used, so Katman didn't audit ${domain}. ${resets}`);
+    }
+    else {
+        const left = lim && usage ? Math.max(0, lim.auditsPerMonth - usage.audits) : undefined;
+        lines.push(lim
+            ? `${plan} covers ${countOf(lim.sites, "site", "sites")} a month and you already audited ${usage ? usage.sites : lim.sites} this month, so Katman didn't audit ${domain}, a new site. ${resets}`
+            : `This plan's sites for this month are used, so Katman didn't audit ${domain}. ${resets}`);
+        lines.push(`Audits of a site you already audited this month still work${left !== undefined ? ` (${countOf(left, "audit", "audits")} left)` : ""}.`);
+    }
+    if (onePro(lim))
+        lines.push(`To audit more now: upgrade to ${PRO_3_NOTE} at ${BUY_PRO_3_URL}; the key stays the same. Already upgraded? Call katman_account with refresh: true.`);
+    lines.push("Re-reading earlier results doesn't use an audit: the last audit of this project is in .katman/audit.md. Every other tool keeps working.");
+    return lines;
+}
+/** An audit that didn't run: this month's audits or sites are used up (explained), or the plan or key isn't valid (the usual upsell). */
+export function renderAuditRefusal(o) {
+    const { use } = o;
+    if (use.reason !== "audit_limit" && use.reason !== "site_limit") {
+        return renderUpsell({ tool: "katman_audit_site", feature: "audit", status: refusedStatus(o), facts: o.facts, args: { site_url: o.domain }, surface: o.surface, command: o.command, example: o.example });
+    }
+    const lines = limitLines(o);
+    if (o.surface === "cli") {
+        return [`${o.command ?? "katman-mcp audit"} didn't run: ${use.reason === "audit_limit" ? "this month's audits are used" : "this month's sites are used"}.`, "", ...lines, "", "This month's counts: katman-mcp account"].join("\n");
+    }
+    return [
+        `## katman_audit_site didn't run: ${use.reason === "audit_limit" ? "this month's audits are used" : "this month's sites are used"}`,
+        lines.join("\n\n"),
+        "Tell the user this in your own words. Don't try to work around it (no editing Katman's code or cache, no made-up keys); katman_account shows this month's counts.",
+    ].join("\n\n");
+}
+/** structuredContent of an audit that didn't run for lack of audits or sites this month (no secrets). */
+export function auditRefusalStructured(o) {
+    const { use } = o;
+    if (use.reason !== "audit_limit" && use.reason !== "site_limit")
+        return upsellStructured("katman_audit_site", "audit", refusedStatus(o));
+    return {
+        ran: false,
+        tool: "katman_audit_site",
+        reason: use.reason,
+        domain: o.domain,
+        ...(use.plan ? { plan: use.plan } : {}),
+        ...(use.limits ? { limits: use.limits } : {}),
+        ...(use.usage ? { usage: use.usage } : {}),
+        upgradeUrl: onePro(use.limits) ? BUY_PRO_3_URL : BILLING_URL,
+    };
+}
+/** After an audit that ran: this month's count on a plan with limits, or the note that the count couldn't be checked. */
+export function auditCountLine(use) {
+    if (use.unchecked)
+        return `> **Audit count not checked:** couldn't reach katman.pro (${use.error ?? "no answer"}), so this audit ran without being counted.`;
+    return use.limits ? `**${proPlanName(use.limits)}:** ${usageText(use.limits, use.usage)}.` : undefined;
+}
+/** structuredContent.auditCount of an audit that ran. */
+export function auditCountStructured(use) {
+    return {
+        counted: !use.unchecked,
+        ...(use.unchecked ? { error: use.error ?? "no answer" } : {}),
+        ...(use.limits ? { limits: use.limits } : {}),
+        ...(use.usage ? { usage: use.usage } : {}),
+    };
+}
 export { when as fmtWhen, day as fmtDay };

package/dist/tools/crawl/audit/report.js

@@ -21,7 +21,7 @@ export function auditMarkdown(ctx, result, findings, opts = {}) {
     // Gates
     L.push("## Gates");
     L.push(mdTable(["Gate", "Pass", "Main reasons"], ["read", "quote", "fit"].map((k) => [
-        k === "read" ? "Read (Okunmak)" : k === "quote" ? "Quote (Alıntılanmak)" : "Fit (Soruya uymak)",
+        k === "read" ? "Read" : k === "quote" ? "Quote" : "Fit",
         g[k].total ? `${g[k].pass}/${g[k].total}` : "–",
         g[k].notes.slice(1, 4).join("; ") || (g[k].total ? "all pass" : ""),
     ])));
@@ -171,7 +171,7 @@ function nineCommands(ctx) {
         "3",
         "Title, description, canonical, robots, og:image",
         h
-            ? `title ${h.title ? `${h.title.length} chars ${Y}` : N} · description ${h.description ? `${h.description.length} chars ${Y}` : N} · canonical ${canon === undefined ? N : canon ? `self ${Y}` : `→ ${h.canonical} ${N}`} · robots ${h.metaRobots ?? "none"} ${home.noindex ? N : Y} · og:image ${h.og.image ? Y : N}`
+            ? `title ${h.title ? `${h.title.length} chars ${Y}` : N} · description ${h.description ? `${h.description.length} chars ${h.description.length >= 70 && h.description.length <= 160 ? Y : `${N} (aim for 70–160)`}` : N} · canonical ${canon === undefined ? N : canon ? `self ${Y}` : `→ ${h.canonical} ${N}`} · robots ${h.metaRobots ?? "none"} ${home.noindex ? N : Y} · og:image ${h.og.image ? Y : N}`
             : "—",
         `curl -s ${o}/ | grep -oiE '<title>[^<]*|name="description" content="[^"]*|rel="canonical" href="[^"]*|name="robots" content="[^"]*|og:image" content="[^"]*'`,
     ]);

package/dist/tools/crawl/cli.js

@@ -2,7 +2,9 @@
 import path from "node:path";
 import { parseArgs } from "../../cli.js";
 import { loadConfig, loadResearch, logEvent, readJson, saveResearch } from "../../state.js";
-import { auditAndSave, scanAndSave } from "./index.js";
+import { EXIT_NEEDS_PLAN, defaultLicense, meterAudit, statusOf } from "../../license.js";
+import { auditCountLine, renderAuditRefusal } from "../account/upsell.js";
+import { AuditRefused, auditAndSave, scanAndSave } from "./index.js";
 import { indexNowMarkdown, runIndexNow } from "./indexnow.js";
 import { keywordsMarkdown, mergeKeywords, runKeywords, termsToSave } from "./keywords.js";
 const str = (v) => (typeof v === "string" ? v : undefined);
@@ -25,20 +27,25 @@ export const commands = {
             return fail(`scan failed: ${e instanceof Error ? e.message : String(e)}`);
         }
     },
-    async audit(args) {
+    async audit(args, deps) {
         const a = parseArgs(args);
         const root = path.resolve(str(a.flags.root) ?? process.cwd());
         const max = Number(str(a.flags.max) ?? NaN);
+        const provider = deps?.license ?? defaultLicense();
         try {
-            const { run, markdown } = await auditAndSave(root, {
+            // The plan check has passed (runCli); the audit is counted right before it runs.
+            const { run, markdown, use } = await auditAndSave(root, {
                 site_url: a._[0] ?? str(a.flags.site),
                 max_urls: Number.isFinite(max) ? max : undefined,
                 urls: list(a.flags.urls),
                 include_bot_test: a.flags["no-bots"] ? false : undefined,
                 preview_urls: list(a.flags.preview),
-            }, (done, total, message) => process.stderr.write(`\r[${done}/${total}] ${message}                    `), !a.flags["no-save"]);
+            }, (done, total, message) => process.stderr.write(`\r[${done}/${total}] ${message}                    `), !a.flags["no-save"], (domain) => meterAudit(provider, domain));
             process.stderr.write("\n");
             console.log(markdown);
+            const count = use ? auditCountLine(use) : undefined;
+            if (count)
+                console.error(count.replace(/^> /, "").replace(/\*\*/g, ""));
             // --strict: non-zero exit when critical findings exist (for CI / a pre-publish script, book P14)
             if (a.flags.strict && run.findings.some((f) => f.severity === "critical"))
                 return 2;
@@ -46,6 +53,11 @@ export const commands = {
         }
         catch (e) {
             process.stderr.write("\n");
+            if (e instanceof AuditRefused) {
+                const status = await statusOf(provider);
+                console.error(renderAuditRefusal({ use: e.use, status, domain: e.domain, surface: "cli", command: "katman-mcp audit", example: ["katman-mcp", "audit", ...args].join(" ") }));
+                return EXIT_NEEDS_PLAN;
+            }
             return fail(`audit failed: ${e instanceof Error ? e.message : String(e)}`);
         }
     },
@@ -98,9 +110,9 @@ export const commands = {
 export const help = [
     "  katman-mcp scan [path] [--no-save]          scan the codebase → .katman/scan.json",
     "  katman-mcp audit <url> [--max 50] [--root .] [--urls u1,u2] [--preview u1] [--no-bots] [--strict] [--no-save]",
-    "                                              audit the live site like AI crawlers see it (--strict: exit 2 on critical)",
+    "                                              audit the live site like AI crawlers see it (--strict: exit 2 on critical); counts as one audit of the month",
     "  katman-mcp indexnow [--root .] [--site url] [--urls u1,u2] [--submit]",
-    "                                              IndexNow key check + new/changed URLs (dry run unless --submit; Katman Pro)",
+    "                                              IndexNow key check + new/changed URLs (dry run unless --submit)",
     '  katman-mcp keywords "<seed>" [--lang en] [--country us] [--no-expand] [--save]',
     "                                              Google autocomplete ideas (≤40 requests)",
 ];