katman-mcp 0.2.0 → 0.3.0

package/dist/tools/crawl/index.js

@@ -1,4 +1,5 @@
-// Crawl module: katman_scan_code, katman_audit_site, katman_keywords (Audit Week or Pro) and katman_indexnow (Pro).
+// Crawl module: katman_scan_code, katman_audit_site, katman_keywords and katman_indexnow (Katman Pro). katman_audit_site is
+// counted: it asks katman.pro right before the audit runs (license.ts meterAudit); see auditAndSave().
 // Registration only; the engines live in scan/, audit/, indexnow.ts and keywords.ts (pure or fetcher-injected).
 import { stat } from "node:fs/promises";
 import os from "node:os";
@@ -6,8 +7,9 @@ import path from "node:path";
 import { z } from "zod";
 import { resolveRoot, rootWarning } from "../../context.js";
 import { loadConfig, loadResearch, logEvent, readJson, saveConfig, saveResearch, stamp, writeJson, writeText } from "../../state.js";
-import { fail, ok } from "../../util.js";
-import { tierNote, withPlan } from "../../license.js";
+import { domainOf, fail, normalizeSiteUrl, ok } from "../../util.js";
+import { licenseOf, meterAudit, statusOf, tierNote, withPlan } from "../../license.js";
+import { auditCountLine, auditCountStructured, auditRefusalStructured, renderAuditRefusal } from "../account/upsell.js";
 import { topIssues, auditMarkdown } from "./audit/report.js";
 import { runAudit } from "./audit/index.js";
 import { countBySeverity } from "./common/findings.js";
@@ -35,7 +37,22 @@ export async function scanAndSave(root, maxFiles, save = true) {
     const markdown = scanMarkdown(run, { savedTo: save ? ".katman/scan.json" : undefined, warning });
     return { run, markdown };
 }
-export async function auditAndSave(root, a, onProgress, save = true) {
+/** The audit was not run: this month's audits or sites are used up, or the plan or key stopped being valid. */
+export class AuditRefused extends Error {
+    use;
+    domain;
+    constructor(use, domain) {
+        super(`audit refused for ${domain}: ${use.reason ?? "not allowed"}`);
+        this.use = use;
+        this.domain = domain;
+    }
+}
+/**
+ * Audit the live site and save the result. With a `meter` (the real tools and the CLI pass one) the audit is counted
+ * first, right before it runs and only once the URL is valid; a refusal throws AuditRefused and nothing is fetched.
+ * `use` in the result is the meter's answer (the count, or "couldn't be checked").
+ */
+export async function auditAndSave(root, a, onProgress, save = true, meter) {
     const writable = save && !unsafeRoot(root);
     const readable = !unsafeRoot(root);
     const config = readable ? await loadConfig(root) : {};
@@ -44,6 +61,14 @@ export async function auditAndSave(root, a, onProgress, save = true) {
     const siteUrl = a.site_url?.trim() || config.siteUrl || research?.site?.url;
     if (!siteUrl)
         throw new Error("No site URL: pass site_url (e.g. https://example.com), or save it first with katman_start { site_url }.");
+    let use;
+    if (meter) {
+        // An invalid URL throws here, before anything is counted.
+        const domain = domainOf(normalizeSiteUrl(siteUrl));
+        use = await meter(domain);
+        if (!use.allowed)
+            throw new AuditRefused(use, domain);
+    }
     const run = await runAudit({
         siteUrl,
         maxUrls: a.max_urls ?? config.maxUrls ?? 50,
@@ -70,7 +95,7 @@ export async function auditAndSave(root, a, onProgress, save = true) {
         await logEvent(root, `katman_audit_site ${run.ctx.origin}: ${run.ctx.pages.length} URLs · read ${g.read.pass}/${g.read.total} · quote ${g.quote.pass}/${g.quote.total} · fit ${g.fit.pass}/${g.fit.total} · ${run.findings.length} findings`);
     }
     const markdown = auditMarkdown(run.ctx, run.result, run.findings, { full: false, jsonPath, mdPath });
-    return { run, markdown, jsonPath, writable };
+    return { run, markdown, jsonPath, writable, use };
 }
 function auditSummary(result, top, jsonPath) {
     return {
@@ -119,7 +144,7 @@ export function registerCrawlTools(server, ctx) {
     }));
     server.registerTool("katman_audit_site", {
         title: "Audit the live site like AI crawlers see it",
-        description: "Fetches the live site without JavaScript, like AI crawlers: robots.txt, sitemap, http→https, www/apex, HSTS, compression, soft 404, llms.txt, AI-bot access through the CDN/firewall (GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot…), and per page: status, noindex, title/description, canonical, H1, JS-off words and first paragraph, JSON-LD, og:image, hreflang, internal links. Returns gates, top-10 issues (P-codes + acceptance criteria) and the P14 table. Network: the site only, ≤4 requests at a time. Pass urls to re-verify a fix. Writes .katman/audits/<stamp>.json + .katman/audit.md." +
+        description: "Fetches the live site without JavaScript, like AI crawlers: robots.txt, sitemap, http→https, www/apex, HSTS, compression, soft 404, llms.txt, AI-bot access through the CDN/firewall (GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot…), and per page: status, noindex, title/description, canonical, H1, JS-off words and first paragraph, JSON-LD, og:image, hreflang, internal links. Returns gates, top-10 issues (P-codes + acceptance criteria) and the P14 table. Network: the site only, ≤4 requests at a time. Pass urls to re-verify a fix. Writes .katman/audits/<stamp>.json + .katman/audit.md. Each run counts as one of the plan's audits for the calendar month (Katman Pro, 1 site: 5 audits and 1 site; 3 sites: 30 audits and 3 sites; katman.pro counts them); re-reading .katman/audit.md and every other tool don't count, so don't re-run it without a reason." +
             tierNote("audit"),
         inputSchema: {
             site_url: z.string().optional().describe("Site to audit, e.g. https://example.com (default: .katman/config.json siteUrl or research site.url)."),
@@ -139,11 +164,17 @@ export function registerCrawlTools(server, ctx) {
                     void extra.sendNotification({ method: "notifications/progress", params: { progressToken: token, progress: done, total, message } }).catch(() => undefined);
                 }
                 : undefined;
-            const { run, markdown, jsonPath, writable } = await auditAndSave(root, args, onProgress);
+            const provider = licenseOf(ctx);
+            const { run, markdown, jsonPath, writable, use } = await auditAndSave(root, args, onProgress, true, (domain) => meterAudit(provider, domain));
             const note = writable ? "" : `\n\n> Not saved: ${root} is not a project folder (pass project_root to keep the audit in .katman/).`;
-            return ok(markdown + note, auditSummary(run.result, topIssues(run.ctx, run.findings), jsonPath));
+            const count = use ? auditCountLine(use) : undefined;
+            return ok(markdown + note + (count ? `\n\n${count}` : ""), { ...auditSummary(run.result, topIssues(run.ctx, run.findings), jsonPath), ...(use ? { auditCount: auditCountStructured(use) } : {}) });
         }
         catch (e) {
+            if (e instanceof AuditRefused) {
+                const input = { use: e.use, status: await statusOf(licenseOf(ctx)), domain: e.domain, surface: "mcp" };
+                return ok(renderAuditRefusal(input), auditRefusalStructured(input));
+            }
             return fail(`katman_audit_site failed: ${errText(e)}`);
         }
     }));

package/dist/tools/crawl/scan/framework.js

@@ -593,7 +593,10 @@ function detectHosting(p, pkg, builder, wr, findings) {
 }
 function staticDirFor(framework, appDir, assetsDir, p) {
     const pre = appDir ? `${appDir}/` : "";
-    if (assetsDir)
+    // A Worker's assets directory is the folder that gets deployed. Without a build step it is the source folder; with a
+    // framework it is the build output (dist/, build/, Hugo's public/…), which the next build wipes, so files go to the
+    // framework's own static folder instead.
+    if (assetsDir && (framework === "custom-server" || framework === "static-html" || framework === "unknown"))
         return assetsDir;
     switch (framework) {
         case "sveltekit":

package/dist/tools/method/core/lint.js

@@ -19,6 +19,7 @@ const SOURCE_MARK_RE = /(source|according to|survey|study|report|data from|measu
 const CLAIM_NUM_RE = /(\d+(?:[.,]\d+)?\s?%|%\s?\d+|\b\d+(?:[.,]\d+)?\s?[x×]\b|\b\d{1,3}(?:[.,]\d{3})+\+?|\b\d+\+?\s+(?:users|customers|people|visitors|downloads|companies|teams|businesses|orders|sites|reviews|clients|installs|creators|members|kullanıcı|müşteri|kişi|ziyaretçi|şirket|indirme|yorum|site|üye))/i;
 const FREE_RE = /\b(free|for free|free of charge)\b|ücretsiz|bedava|\bgratis\b|kostenlos|gratuit/gi;
 const CURRENCY_NEAR = /[$€£₺]|\b(usd|eur|gbp|try|tl)\b/i;
+const OFFER_LIMIT_BEFORE = /(?:\b(?:first|next|up to|limited to|max(?:imum)?|only|at most)|\bilk|\ben fazla|\bsadece)\s*$/i;
 function stripQuotes(s) {
     return s.replace(/“[^”]*”|"[^"]*"|«[^»]*»|„[^“]*“/g, " ");
 }
@@ -227,6 +228,9 @@ export function lintPage(x, c) {
                     continue;
                 if (CURRENCY_NEAR.test(s.slice(Math.max(0, (m.index ?? 0) - 3), (m.index ?? 0) + m[0].length + 3)))
                     continue;
+                // An offer's limit ("the first 100 customers", "up to 3 sites") is a condition, not a claim that needs a source.
+                if (OFFER_LIMIT_BEFORE.test(s.slice(Math.max(0, (m.index ?? 0) - 20), m.index ?? 0)))
+                    continue;
                 if (SOURCE_MARK_RE.test(s) || (ss[i + 1] && SOURCE_MARK_RE.test(ss[i + 1])))
                     continue;
                 unsourced.push(`“${s.length > 140 ? s.slice(0, 137) + "…" : s}”`);
@@ -270,12 +274,22 @@ export function lintPage(x, c) {
             // "free" next to a tool/resource word (free VAT calculator, free checker, free guide, ücretsiz araç) is a
             // genuinely free side offer, which the method recommends (free tools are link magnets): not a violation.
             const FREE_SIDE_OFFER = /^\W{0,3}(?:\p{L}+[\s-]+){0,3}?(?:tool|tools|finder|checker|calculator|counter|generator|guide|book|ebook|pdf|template|templates|course|webinar|audit|test|trial|plan|tier|version|download|araç|araçlar|araci|aracı|bulucu|hesaplayıcı|sayacı|rehber|kitap|şablon|deneme|sürüm|plan)\b/iu;
+            // The same side offer named before the word ("the checker and the guides are free", "AI crawler checker — Free",
+            // "check your site first, free"), in the same clause and without a contrast ("our tools are paid, but setup is free").
+            const FREE_SIDE_OFFER_BEFORE = /\b(?:tool|tools|finder|checker|checkers|check|calculator|calculators|counter|generator|guide|guides|template|templates|resource|resources|araç|araçlar|araci|aracı|bulucu|hesaplayıcı|sayacı|rehber|rehberler|şablon|kontrol)\b(?:(?!\b(?:but|however|while|whereas|although|except|ama|fakat|ancak)\b)[^.!?;])*$/iu;
             const hits = [];
             for (const seg of [...segments, stripQuotes(x.description ?? "")]) {
                 for (const m of seg.matchAll(FREE_RE)) {
-                    const after = seg.slice((m.index ?? 0) + m[0].length, (m.index ?? 0) + m[0].length + 60);
+                    const at = m.index ?? 0;
+                    const after = seg.slice(at + m[0].length, at + m[0].length + 60);
                     if (FREE_SIDE_OFFER.test(after))
                         continue;
+                    if (FREE_SIDE_OFFER_BEFORE.test(seg.slice(Math.max(0, at - 50), at)))
+                        continue;
+                    // A question ("Is it free?") asks, it doesn't promise; the answer is checked on its own.
+                    const end = seg.slice(at).search(/[.!?](?:\s|$)/);
+                    if (end >= 0 && seg[at + end] === "?")
+                        continue;
                     if (hits.length < 4)
                         hits.push(snippet(seg, m.index ?? 0, m[0].length));
                 }

package/dist/tools/method/core/prompt.js

@@ -5,7 +5,8 @@ import { t } from "../lib/l10n.js";
 import { appPathsText, knownPublicPaths, pathKnown } from "../lib/routes.js";
 import { loadConfigSafe, loadLatestAudit, loadResearchSafe, loadScan, staticDirFor } from "../lib/state.js";
 import { brandSentence, codeBlock, fillTemplate, hasNotX, isFilled, slugify } from "../lib/text.js";
-import { PLACEHOLDERS, PROMPTS, getPrompt, promptPlaceholders } from "../data/prompts.js";
+import { PLACEHOLDERS, PROMPTS } from "../data/prompts.js";
+import { getPrompt, promptPlaceholders } from "../lib/prompt-lookup.js";
 import { detectLang } from "./questions.js";
 export function siteUrlOf(r, cfg) {
     if (r && isFilled(r.site.url) && /^https?:\/\//i.test(r.site.url))

package/dist/tools/method/data/_store.js

@@ -0,0 +1,17 @@
+// Where the method data comes from at run time.
+// In the source tree (tests, `npm run dev`) every data module holds the method inline and METHOD_INLINE is true.
+// The published package carries no method text: scripts/postbuild.mjs replaces each data module in dist/ with a stub
+// that exports the same names, empty until katman.pro sends the data for a paid key (POST /api/web/mcp/method, see
+// src/license.ts loadMethod), and sets METHOD_INLINE to false. ES module bindings are live, so every importer sees
+// the values once applyMethod has run.
+export const METHOD_INLINE = false;
+const setters = [];
+/** Called by each stub module to receive its exports. */
+export function onMethod(set) {
+    setters.push(set);
+}
+/** Fills every stub module from the data katman.pro sent. */
+export function applyMethod(data) {
+    for (const set of setters)
+        set(data);
+}

package/dist/tools/method/data/anatomy.js

@@ -1,141 +1,12 @@
-export const ANATOMY_INTRO = {
-    en: "A page is written for two readers at once: Google and the assistant. The invoice example below is invented; its structure is the same as the sample site's situation pages. Blocks tagged SEO are for the search engine, GEO blocks are for the assistant to quote you. Most serve both.",
-    tr: "Bir sayfa iki okuyucuya birden yazılır: Google’a ve asistana. Aşağıdaki fatura örneği uydurmadır; yapı, örnek sitenin durum sayfalarıyla aynı. SEO etiketli bloklar arama motoru için, GEO etiketliler asistanın sizi alıntılaması için. Çoğu ikisine birden yarıyor.",
-};
-export const ANATOMY = [
-    {
-        n: 1,
-        tags: ["SEO", "GEO"],
-        name: { en: "<title> · meta description · canonical · og:image", tr: "<title> · meta description · canonical · og:image" },
-        example: { en: "yoursite.com/import-pdf-invoices", tr: "siteniz.com/faturami-muhasebeye-aktar" },
-        rule: {
-            en: "Title: the situation first, then the brand, about 60 characters. Meta description: the sentence you want the assistant to say; Google mostly builds the snippet from the page text, so the same sentence must also be in block 3.",
-            tr: "Title önce durum, sonra marka, yaklaşık 60 karakter. Meta açıklama asistanın söylemesini istediğiniz cümle; Google snippet’i çoğunlukla sayfa metninden kurar, bu yüzden aynı cümle 3. blokta da olmalı.",
-        },
-    },
-    {
-        n: 2,
-        tags: ["SEO", "GEO"],
-        name: { en: "H1", tr: "H1" },
-        example: { en: "I type my invoices in by hand and it takes hours", tr: "Faturalarımı elle giriyorum, saatlerimi alıyor" },
-        rule: { en: "The H1 is the customer's own sentence. The URL uses the same words.", tr: "H1 müşterinin kendi cümlesi. Adres de aynı kelimelerle." },
-    },
-    {
-        n: 3,
-        tags: ["GEO"],
-        name: { en: "The first 1–3 sentences", tr: "İlk 1–3 cümle" },
-        example: {
-            en: "Upload your invoice. We move the line items into your accounting software in 30 seconds and flag the ones that don't match. Your document is never stored.",
-            tr: "Faturanı yükle. Kalemleri 30 saniyede muhasebe programına aktarırız, eşleşmeyenleri işaretleriz. Belgen saklanmaz.",
-        },
-        rule: {
-            en: "The most important block. The assistant takes a sentence for its answer from here: short, concrete, understandable on its own. ChatGPT repeated the sample site's sentence almost word for word. Keep the key claim within the H1 and the first ~200 characters.",
-            tr: "Sayfanın en önemli bloğu. Asistan cevabına buradan bir cümle alır: kısa, somut, tek başına anlaşılır. Örnek sitenin cümlesini ChatGPT neredeyse kelimesi kelimesine tekrar etti. Asıl iddiayı H1’de ve ilk ~200 karakterde tutun.",
-        },
-    },
-    {
-        n: 4,
-        tags: [],
-        name: { en: "Try it now / one clear action", tr: "Hemen deneme / tek net eylem" },
-        example: { en: "Drop your invoice · try it free", tr: "Faturanı bırak · ücretsiz dene" },
-        rule: {
-            en: "The visitor arrives with the situation they told ChatGPT. On the sample site we put a file drop box on the two pages ChatGPT sent people to; 52 of the first 68 generations in week one used the visitor's own file.",
-            tr: "Ziyaretçi ChatGPT’ye anlattığı durumla gelir. Örnek sitede ChatGPT’nin gönderdiği iki sayfaya dosya kutusu koyduk; ilk haftadaki 68 ilk üretimin 52’si ziyaretçinin kendi dosyasıyla yapıldı.",
-        },
-    },
-    {
-        n: 5,
-        tags: ["GEO"],
-        name: { en: "Proof: number + date", tr: "Kanıt: sayı + tarih" },
-        example: { en: "A verifiable number with its date", tr: "Doğrulanabilir sayı, tarihiyle" },
-        rule: {
-            en: "A verifiable number, with its date. Don't claim more than your proof: the assistant repeats it and a competitor refutes it.",
-            tr: "Doğrulanabilir sayı, tarihiyle. Kanıtından büyük iddia yazmayın; asistan tekrar eder, rakip çürütür.",
-        },
-    },
-    {
-        n: 6,
-        tags: ["SEO", "GEO"],
-        name: { en: "How it works: 3–5 steps", tr: "Nasıl çalışır: 3–5 adım" },
-        example: { en: "3–5 plain-text steps", tr: "3–5 düz metin adım" },
-        rule: {
-            en: "Plain HTML text; a demo drawn with JavaScript is an empty page to a bot.",
-            tr: "Düz HTML metin; JavaScript ile çizilen bir demo bot için boş sayfadır.",
-        },
-    },
-    {
-        n: 7,
-        tags: ["GEO"],
-        name: { en: "Who it's not for", tr: "Kimler için değil" },
-        example: { en: "2–3 bullets", tr: "2–3 madde" },
-        rule: {
-            en: "Saying who it's not for and naming competitors honestly builds trust; assistants quote one-sided pages less.",
-            tr: "“Kime uygun değil” ve rakipleri dürüstçe saymak güven verir; asistan tek taraflı sayfayı daha az alıntılar.",
-        },
-    },
-    {
-        n: 8,
-        tags: ["GEO"],
-        name: { en: "Alternatives, honestly", tr: "Alternatifler, dürüstçe" },
-        example: { en: "Competitor: who it fits", tr: "Rakip: kime uygun" },
-        rule: {
-            en: "Name the alternatives and say whom each one fits; take competitor facts only from their own pages, with a date.",
-            tr: "Alternatifleri sayın, hangisinin kime uygun olduğunu yazın; rakip bilgisini yalnızca kendi sayfasından, tarihiyle alın.",
-        },
-    },
-    {
-        n: 9,
-        tags: ["GEO"],
-        name: { en: "FAQ: 5–8 questions", tr: "SSS: 5–8 soru" },
-        example: { en: "Questions in the customer's words", tr: "Müşterinin ağzından sorular" },
-        rule: {
-            en: "Questions in the customer's words, answers whose first sentence is the answer. Google no longer shows an FAQ rich result; this block is for the assistant.",
-            tr: "Müşterinin ağzından sorular, ilk cümlesi cevap olan yanıtlar. Google’da SSS zengin sonucu yok; bu blok asistan için.",
-        },
-    },
-    {
-        n: 10,
-        tags: ["SEO"],
-        name: { en: "Related pages", tr: "İlgili sayfalar" },
-        example: { en: "3–5 text links", tr: "3–5 metinli link" },
-        rule: {
-            en: "Internal links with descriptive text; every page gets a link from somewhere.",
-            tr: "Metinli iç linkler; her sayfa en az bir yerden link alsın.",
-        },
-    },
-    {
-        n: 11,
-        tags: ["SEO", "GEO"],
-        name: { en: "Updated date · author · JSON-LD", tr: "Güncellendi · yazar · JSON-LD" },
-        example: { en: "Updated: 29 Sep 2026 · Author · JSON-LD", tr: "Güncellendi: 29.09.2026 · Yazar · JSON-LD" },
-        rule: {
-            en: "A real update date (changed only when the text changes), the author, valid JSON-LD. In the sample site's first version all 85 pages carried the launch date; we fixed it.",
-            tr: "Gerçek güncelleme tarihi (yalnızca metin değişince), yazar, geçerli JSON-LD. Örnek sitede ilk sürümde 85 sayfanın hepsi yayın tarihini taşıyordu; düzelttik.",
-        },
-    },
-];
-/** The page brief the book tells you to start P6 with. */
-export const PAGE_BRIEF_TEMPLATE = {
-    en: `Situation: [the customer's sentence]
-URL: /[words]                               Title: [situation] — [brand]
-First sentence: [brings] → [we do] → [they get]. [fear is unnecessary].
-Action: [file drop / trial / pricing]
-Proof: [number, source, date]
-Not for: [2–3 bullets]
-Alternatives: [competitor: who it fits]
-FAQ: [5–8 questions, in the customer's words]
-Related pages: [3–5 URLs]`,
-    tr: `Durum: [müşterinin cümlesi]
-Adres: /[kelimeler]                               Title: [durum] — [marka]
-İlk cümle: [getirir] → [yaparız] → [eline geçer]. [korku gereksiz].
-Eylem: [dosya kutusu / deneme / fiyat]
-Kanıt: [sayı, kaynak, tarih]
-Kimler için değil: [2-3 madde]
-Alternatifler: [rakip: kime uygun]
-SSS: [5-8 soru, müşterinin ağzından]
-İlgili sayfalar: [3-5 adres]`,
-};
-export const ANATOMY_EXERCISE = {
-    en: "Write your own four-part sentence (brings → we do → gets → fear is unnecessary). Put the same sentence in three places: the first paragraph of your most important page, that page's meta description, and llms.txt.",
-    tr: "Kendi dört parçalı cümlenizi yazın (getirir → yaparız → eline geçer → korku gereksiz). Aynı cümleyi üç yere koyun: en önemli sayfanın ilk paragrafı, o sayfanın meta açıklaması, llms.txt.",
-};
+// Filled from katman.pro at run time for a paid key (see _store.js); the package carries no method text.
+import { onMethod } from "./_store.js";
+export let ANATOMY = [];
+export let ANATOMY_EXERCISE = {};
+export let ANATOMY_INTRO = {};
+export let PAGE_BRIEF_TEMPLATE = {};
+onMethod((d) => {
+  if (d.ANATOMY !== undefined) ANATOMY = d.ANATOMY;
+  if (d.ANATOMY_EXERCISE !== undefined) ANATOMY_EXERCISE = d.ANATOMY_EXERCISE;
+  if (d.ANATOMY_INTRO !== undefined) ANATOMY_INTRO = d.ANATOMY_INTRO;
+  if (d.PAGE_BRIEF_TEMPLATE !== undefined) PAGE_BRIEF_TEMPLATE = d.PAGE_BRIEF_TEMPLATE;
+});

package/dist/tools/method/data/appendices.js

@@ -1,202 +1,22 @@
-/** Appendix A — the sample robots.txt (katman_generate builds the project-specific version). */
-export const APPENDIX_A_ROBOTS = {
-    en: `# Open to search engines, AI assistants and crawlers.
-# Content signals: search=yes, ai-input=yes, ai-train=yes
-# (Written as a comment: as a rule line, Lighthouse reported "robots.txt is not valid".)
-
-User-agent: *
-Allow: /
-Disallow: /app/
-Disallow: /admin/
-Disallow: /api/
-
-User-agent: OAI-SearchBot
-Allow: /
-Disallow: /app/
-Disallow: /admin/
-Disallow: /api/
-
-# The same group is repeated for: ChatGPT-User, GPTBot, Claude-SearchBot,
-# Claude-User, ClaudeBot, PerplexityBot, Perplexity-User, Google-Extended,
-# Applebot, Applebot-Extended, Bingbot, DuckAssistBot, Meta-ExternalAgent, Amazonbot
-
-Sitemap: https://yourdomain.com/sitemap.xml
-# For assistants: https://yourdomain.com/llms.txt`,
-    tr: `# Arama motorlarına, yapay zekâ asistanlarına ve tarayıcılara açığız.
-# Content signals: search=yes, ai-input=yes, ai-train=yes
-# (Yorum olarak yazıldı: kural olarak yazılınca Lighthouse "robots.txt geçersiz" dedi.)
-
-User-agent: *
-Allow: /
-Disallow: /app/
-Disallow: /admin/
-Disallow: /api/
-
-User-agent: OAI-SearchBot
-Allow: /
-Disallow: /app/
-Disallow: /admin/
-Disallow: /api/
-
-# Aynı grup şunlar için de tekrarlanır: ChatGPT-User, GPTBot, Claude-SearchBot,
-# Claude-User, ClaudeBot, PerplexityBot, Perplexity-User, Google-Extended,
-# Applebot, Applebot-Extended, Bingbot, DuckAssistBot, Meta-ExternalAgent, Amazonbot
-
-Sitemap: https://alanadiniz.com/sitemap.xml
-# Asistanlar için: https://alanadiniz.com/llms.txt`,
-};
-export const APPENDIX_A_NOTE = {
-    en: "A bot that has a group with its own name doesn't read the * group, so repeat the closed paths in every group. Don't write bare prefixes: Disallow: /t closes both /tr and /tools; write /t/. Have your coding tool generate this file with P4.",
-    tr: "Bir bot için adıyla yazılmış grup varsa o bot * grubunu okumaz; bu yüzden kapalı yolları her grupta tekrar yazın. Çıplak önek yazmayın: Disallow: /t hem /tr’yi hem /tools’u kapatır, /t/ yazın. Kod aracınıza bu dosyayı P4 ile ürettirin.",
-};
-/** Appendix B — llms.txt skeleton. */
-export const APPENDIX_B_LLMS = {
-    en: `# [Brand] [category word]
-
-> [Brand] is a [product type] that turns [input] into [output]. [The most important difference, one sentence].
-> Operated by [company name] ([country]).
-
-Key facts: [pricing model, lowest price, trial], [cancellation], [usage limits].
-Not to be confused with: [Brand] is not [similarly named product]; it is not a [big company] product.
-Limits of the evidence: [the test behind the claim and its size, stated plainly].
-
-## Product
-- [Home](https://yourdomain.com/): what it is
-- [Pricing](https://yourdomain.com/pricing): plans
-- [Situation page](https://yourdomain.com/...): [the four-part sentence]
-
-## Guides
-## Comparisons
-## Optional
-- [Terms](...), [Privacy](...)`,
-    tr: `# [Marka] [kategori kelimesi]
-
-> [Marka], [girdi]yi [çıktı]ya dönüştüren bir [ürün tipi]. [En önemli fark, tek cümle].
-> [Şirket adı] tarafından işletilir ([ülke]).
-
-Temel bilgiler: [fiyat modeli, en düşük fiyat, deneme], [iptal], [kullanım sınırları].
-Karıştırılmasın: [Marka], [benzer adlı ürün] değildir; [büyük şirket]in ürünü değildir.
-Kanıtın sınırı: [iddianın dayandığı test ve büyüklüğü, açıkça].
-
-## Ürün
-- [Ana sayfa](https://alanadiniz.com/): ne olduğu
-- [Fiyatlar](https://alanadiniz.com/fiyatlandirma): planlar
-- [Durum sayfası](https://alanadiniz.com/...): [dört parçalı cümle]
-
-## Rehberler
-## Karşılaştırmalar
-## Optional
-- [Şartlar](...), [Gizlilik](...)`,
-};
-export const APPENDIX_B_NOTE = {
-    en: "Keep it short: the sample site's llms.txt grew to 65 KB and is being trimmed. Every figure should come from the same source as the pages.",
-    tr: "Kısa tutun: örnek sitenin llms.txt’si 65 KB’a çıktı, inceltilecek. Her rakam sayfalarla aynı kaynaktan gelsin.",
-};
-/** Appendix C — Organization JSON-LD with the not-X note. */
-export const APPENDIX_C_ORG = `{
-  "@context": "https://schema.org",
-  "@type": "Organization",
-  "@id": "https://yourdomain.com/#org",
-  "name": "[Brand] [Category]",
-  "alternateName": ["[Brand]"],
-  "disambiguatingDescription": "A [category] product. Not [similarly named product]; not a [big company] product.",
-  "url": "https://yourdomain.com",
-  "logo": "https://yourdomain.com/img/logo-512.png",
-  "sameAs": ["https://www.youtube.com/@[channel]", "https://www.instagram.com/[account]"],
-  "address": { "@type": "PostalAddress", "addressCountry": "TR" }
-}`;
-export const APPENDIX_C_NOTE = {
-    en: "On every page also WebSite, BreadcrumbList and, by page type, Article (datePublished, dateModified, author), FAQPage (the real questions and answers on the page), VideoObject (if a video is embedded). Everything in the schema must also be visible on the page.",
-    tr: "Her sayfada ayrıca WebSite, BreadcrumbList ve sayfa tipine göre Article (datePublished, dateModified, author), FAQPage (sayfadaki gerçek soru-cevaplar), VideoObject (gömülü video varsa). Schema’daki her bilgi sayfada da görünmeli.",
-};
-/** Appendix D — content rules (+ the 2026 additions). */
-export const CONTENT_RULES = [
-    { en: "The first 1–3 sentences answer the question and can be quoted on their own.", tr: "İlk 1–3 cümle soruyu cevaplar ve tek başına alıntılanabilir." },
-    { en: "Every claim's proof is on the page; if the proof is small, say it's small.", tr: "Her iddianın kanıtı sayfada; kanıt küçükse küçük olduğunu yazın." },
-    { en: "About competitors, write only what their own pages say, with the date.", tr: "Rakipler hakkında yalnızca kendi sayfalarında yazanı, tarihiyle yazın." },
-    { en: "Prices and features come from one source; no two pages contradict each other.", tr: "Fiyat ve özellik tek kaynaktan; iki sayfa birbiriyle çelişmesin." },
-    { en: "Don't call a paid product “free”; don't write headlines that imply another brand's endorsement.", tr: "Ücretli ürüne “ücretsiz” demeyin; başka markanın onayını ima eden başlık yazmayın." },
-    {
-        en: "Let AI write the draft, but don't publish until it passes a rule script (no made-up numbers, no “best / perfect”, no real people's names) and a human read. katman_lint_content is that rule script.",
-        tr: "Taslağı yapay zekâya yazdırın, ama bir kural betiğinden (uydurma sayı, “en iyi / mükemmel”, gerçek kişi adı yok) ve bir insan okumasından geçmeden yayınlamayın. katman_lint_content bu kural betiğidir.",
-    },
-    {
-        en: "Question sources: Google autocomplete (seed keyword + letter by letter), situation sentences people really ask the assistant, the pages the assistant sends people to in your analytics.",
-        tr: "Soru kaynağı: Google’ın otomatik tamamlaması (tohum kelime + harf harf), asistana gerçekten sorulan durum cümleleri, analitikte asistanın indirdiği sayfalar.",
-    },
-    {
-        en: "Watch the page mix: Perplexity took the sample site for a “template and education site” because it had ~110 template pages against 10 product pages. The mix of your pages decides what the assistant thinks you are.",
-        tr: "Sayfa karışımına dikkat: Perplexity örnek sitemizi “şablon ve eğitim sitesi” sandı, çünkü yaklaşık 110 şablon sayfasına karşı 10 ürün sayfası vardı. Sayfalarınızın dağılımı asistanın sizi ne sandığını belirler.",
-    },
-    {
-        en: "On a new domain, 5–10 pages a week. Don't grow a template whose “crawled – not indexed” rate passes 30%.",
-        tr: "Yeni alan adında haftada 5–10 sayfa. “Tarandı, dizine eklenmedi” oranı %30’u geçen şablonu büyütmeyin.",
-    },
-    {
-        en: "Put the key claim in the H1 and the first ~200 characters. Don't keyword-stuff: keyword-heavy titles and URLs get cited less.",
-        tr: "Asıl iddiayı H1’e ve ilk ~200 karaktere koyun. Anahtar kelime doldurmayın: anahtar kelime yüklü başlıklar ve adresler daha az alıntılanıyor.",
-    },
-    {
-        en: "Never show bots different content than people (cloaking), never hide instructions for AI in the page (prompt injection): Google's spam policy covers both since May 2026.",
-        tr: "Botlara insanlardan farklı içerik göstermeyin (cloaking), sayfaya yapay zekâ için gizli talimat koymayın (prompt enjeksiyonu): Google’ın spam politikası Mayıs 2026’dan beri ikisini de kapsıyor.",
-    },
-    {
-        en: "Real freshness only: update the facts and show the date; faking dates is manipulation.",
-        tr: "Yalnızca gerçek tazelik: bilgiyi güncelleyin, tarihi gösterin; tarih uydurmak manipülasyondur.",
-    },
-];
-/** Appendix E — the full site audit checklist (what the crawl script checks). */
-export const SITE_AUDIT_CHECKLIST = {
-    perUrl: [
-        { en: "Status 200 (no redirect), content-type text/html", tr: "Durum 200 (yönlendirme yok), content-type text/html" },
-        { en: "No noindex in meta robots or X-Robots-Tag (special pages should have it)", tr: "meta robots’ta ve X-Robots-Tag’de noindex yok (özel sayfalarda olmalı)" },
-        { en: "<title> present, unique, not longer than 60–65 characters", tr: "<title> var, benzersiz, 60–65 karakteri geçmiyor" },
-        { en: "Meta description present, unique, 70–160 characters", tr: "Meta açıklama var, benzersiz, 70–160 karakter" },
-        { en: "One H1, no heading level skips (h1 → h2 → h3)", tr: "Tek H1, başlık seviyesi atlaması yok (h1 → h2 → h3)" },
-        { en: "One absolute, self-referencing canonical", tr: "Tek, mutlak, kendini gösteren canonical" },
-        { en: "Reciprocal hreflang pairs, an x-default, a correct <html lang>", tr: "hreflang çiftleri karşılıklı, x-default var, <html lang> doğru" },
-        { en: "JSON-LD parses; the expected types are there", tr: "JSON-LD ayrıştırılabiliyor, beklenen tipler var" },
-        { en: "og:title, og:description, og:image (with width, height, alt), og:url, og:locale, twitter:card", tr: "og:title, og:description, og:image (width, height, alt ile), og:url, og:locale, twitter:card" },
-        { en: "Every <img> has alt, width and height; lazy below the fold; a modern format", tr: "Bütün <img>’lerde alt, width ve height; ekranın altındaysa lazy; modern format" },
-        { en: "No http:// resources (mixed content)", tr: "http:// kaynak yok (karışık içerik)" },
-        { en: "URL: lowercase, hyphens, ASCII, short, no trailing /", tr: "URL: küçük harf, tire, ASCII, kısa, sonda / yok" },
-        { en: "At least 3 internal links point to the page (no orphans)", tr: "Sayfaya gelen iç link en az 3 (yetim yok)" },
-        { en: "Every internal and external link on the page is 200 or a deliberate redirect", tr: "Sayfadaki bütün iç ve dış linkler 200 ya da bilinçli yönlendirme" },
-        { en: "Content is visible with JavaScript off (a sensible word count)", tr: "JavaScript kapalıyken içerik görünüyor (kelime sayısı makul)" },
-    ],
-    siteWide: [
-        { en: "http → https 301, www → bare domain 301, HSTS", tr: "http → https 301, www → yalın alan adı 301, HSTS" },
-        { en: "HTML, CSS and JS compressed (Content-Encoding: br or gzip)", tr: "HTML, CSS ve JS sıkıştırılmış (Content-Encoding: br ya da gzip)" },
-        { en: "Long caching and versioning for static files", tr: "Statik dosyalarda uzun önbellek ve sürümleme" },
-        { en: "robots.txt valid, with a sitemap line", tr: "robots.txt geçerli, sitemap satırı var" },
-        { en: "A missing page returns a real 404", tr: "Olmayan sayfa gerçek 404" },
-        { en: "Lighthouse mobile, 5 pages: performance ≥ 90, the others 100", tr: "Lighthouse mobil, 5 sayfa: performans ≥ 90, diğerleri 100" },
-        { en: "Search Console and Bing Webmaster verified, sitemap submitted, IndexNow working", tr: "Search Console ve Bing Webmaster doğrulandı, sitemap gönderildi, IndexNow çalışıyor" },
-        { en: "AI bots get 200 through the CDN (ch. 6)", tr: "CDN’de yapay zekâ botları 200 alıyor (06. bölüm)" },
-    ],
-};
-/** Appendix F — glossary. Terms as used in English by Katman. */
-export const GLOSSARY = [
-    { term: { en: "GEO", tr: "GEO" }, def: { en: "Generative engine optimisation: visibility in generative engines (assistants).", tr: "Üretken motorlarda (asistanlarda) görünürlük optimizasyonu." } },
-    { term: { en: "AEO", tr: "AEO" }, def: { en: "Answer engine optimisation: quotable answers for direct-answer boxes and AI Overviews.", tr: "Cevap motoru optimizasyonu; doğrudan cevap kutuları ve AI Overviews için alıntılanabilir cevap." } },
-    { term: { en: "Read / Quote / Fit", tr: "Okunmak / Alıntılanmak / Soruya uymak" }, def: { en: "The three gates every public page must pass: bots can read it, the assistant can quote its first sentences, and it fits the situation the customer describes.", tr: "Her herkese açık sayfanın geçmesi gereken üç kapı: botlar okuyabilir, asistan ilk cümlelerini alıntılayabilir, sayfa müşterinin anlattığı duruma uyar." } },
-    { term: { en: "Situation page", tr: "Durum sayfası" }, def: { en: "A page written for one concrete situation a user describes to the assistant, answering in the first sentence.", tr: "Kullanıcının asistana anlattığı somut bir duruma yazılmış, ilk cümlede cevap veren sayfa." } },
-    { term: { en: "The one sentence", tr: "Tek cümle" }, def: { en: "The brand's four-part description (brings → we do → gets → fear is unnecessary), word for word the same on the page, in the meta description and in llms.txt.", tr: "Markanın dört parçalı tanımı (getirir → yaparız → eline geçer → korku gereksiz); sayfada, meta açıklamada ve llms.txt’de kelimesi kelimesine aynı." } },
-    { term: { en: "Not-X note", tr: "“X değildir” notu" }, def: { en: "A plain statement of what the brand is not confused with (llms.txt, About, FAQ, Organization disambiguatingDescription).", tr: "Markanın neyle karıştırılmaması gerektiğini açıkça söyleyen cümle (llms.txt, Hakkımızda, SSS, Organization disambiguatingDescription)." } },
-    { term: { en: "Question set", tr: "Soru seti" }, def: { en: "12 unbranded questions + 2 diagnostic ones, asked the same way every 14 days.", tr: "12 markasız soru + 2 teşhis sorusu; 14 günde bir aynı şekilde sorulur." } },
-    { term: { en: "OAI-SearchBot", tr: "OAI-SearchBot" }, def: { en: "The bot that fills ChatGPT's search index (doesn't run JavaScript).", tr: "ChatGPT’nin arama dizinini dolduran bot (JavaScript çalıştırmaz)." } },
-    { term: { en: "GPTBot", tr: "GPTBot" }, def: { en: "OpenAI's training-data bot.", tr: "OpenAI’ın eğitim verisi botu." } },
-    { term: { en: "ChatGPT-User, Claude-User", tr: "ChatGPT-User, Claude-User" }, def: { en: "Agents that open a page on the user's behalf during a chat.", tr: "Sohbet sırasında kullanıcı adına sayfa açan ajan." } },
-    { term: { en: "ClaudeBot, Claude-SearchBot", tr: "ClaudeBot, Claude-SearchBot" }, def: { en: "Anthropic's training bot and search bot.", tr: "Anthropic’in eğitim botu ve arama botu." } },
-    { term: { en: "llms.txt", tr: "llms.txt" }, def: { en: "A short Markdown summary of the site for language models (llmstxt.org).", tr: "Sitenin dil modelleri için kısa Markdown özeti (llmstxt.org)." } },
-    { term: { en: "IndexNow", tr: "IndexNow" }, def: { en: "A protocol that tells search engines about changed URLs instantly.", tr: "Değişen adresleri arama motorlarına anında bildiren protokol." } },
-    { term: { en: "hreflang", tr: "hreflang" }, def: { en: "The tag linking a page's language and region versions.", tr: "Bir sayfanın dil ve bölge sürümlerini birbirine bağlayan etiket." } },
-    { term: { en: "Canonical", tr: "Canonical" }, def: { en: "The preferred URL of a piece of content.", tr: "Bir içeriğin tercih edilen adresi." } },
-    { term: { en: "lastmod", tr: "lastmod" }, def: { en: "A page's last real change date in the sitemap.", tr: "Sitemap’te sayfanın son gerçek değişiklik tarihi." } },
-    { term: { en: "Entity", tr: "Varlık (entity)" }, def: { en: "What search engines and models recognise as “who/what is this”: name, definition, distinction.", tr: "Arama motorunun ve modellerin “bu kim, ne” diye tanıdığı şey: ad, tanım, ayrım." } },
-    { term: { en: "Human filter", tr: "İnsan filtresi" }, def: { en: "A behaviour rule that separates bots from people in analytics.", tr: "Botları analitikten ayıran davranış kuralı." } },
-    { term: { en: "Facade", tr: "Kapak (facade)" }, def: { en: "An embed that is just an image until clicked, then loads the real player.", tr: "Tıklanana kadar yalnızca resim olan, tıklanınca gerçek oynatıcıyı yükleyen gömme." } },
-    { term: { en: "CWV", tr: "CWV" }, def: { en: "Core Web Vitals: LCP (largest content), CLS (shift), INP (interaction).", tr: "Core Web Vitals: LCP (en büyük içerik), CLS (kayma), INP (etkileşim)." } },
-    { term: { en: "Soft 404", tr: "Sahte 404 (soft 404)" }, def: { en: "A page that says “page not found” but returns a 200 status code.", tr: "“Sayfa yok” diyen ama 200 durum kodu dönen sayfa." } },
-    { term: { en: "Training / search / user bot", tr: "Eğitim / arama / kullanıcı botu" }, def: { en: "Bots that collect pages to train models, fill an assistant's search index, and open pages during a chat (ch. 6).", tr: "Model eğitmek için toplayan, asistanın arama dizinini dolduran ve sohbet sırasında sayfa açan botlar (06. bölüm)." } },
-];
+// Filled from katman.pro at run time for a paid key (see _store.js); the package carries no method text.
+import { onMethod } from "./_store.js";
+export let APPENDIX_A_NOTE = {};
+export let APPENDIX_A_ROBOTS = {};
+export let APPENDIX_B_LLMS = {};
+export let APPENDIX_B_NOTE = {};
+export let APPENDIX_C_NOTE = {};
+export let APPENDIX_C_ORG = "";
+export let CONTENT_RULES = [];
+export let GLOSSARY = [];
+export let SITE_AUDIT_CHECKLIST = {};
+onMethod((d) => {
+  if (d.APPENDIX_A_NOTE !== undefined) APPENDIX_A_NOTE = d.APPENDIX_A_NOTE;
+  if (d.APPENDIX_A_ROBOTS !== undefined) APPENDIX_A_ROBOTS = d.APPENDIX_A_ROBOTS;
+  if (d.APPENDIX_B_LLMS !== undefined) APPENDIX_B_LLMS = d.APPENDIX_B_LLMS;
+  if (d.APPENDIX_B_NOTE !== undefined) APPENDIX_B_NOTE = d.APPENDIX_B_NOTE;
+  if (d.APPENDIX_C_NOTE !== undefined) APPENDIX_C_NOTE = d.APPENDIX_C_NOTE;
+  if (d.APPENDIX_C_ORG !== undefined) APPENDIX_C_ORG = d.APPENDIX_C_ORG;
+  if (d.CONTENT_RULES !== undefined) CONTENT_RULES = d.CONTENT_RULES;
+  if (d.GLOSSARY !== undefined) GLOSSARY = d.GLOSSARY;
+  if (d.SITE_AUDIT_CHECKLIST !== undefined) SITE_AUDIT_CHECKLIST = d.SITE_AUDIT_CHECKLIST;
+});