katman-mcp 0.1.0

package/dist/tools/method/lib/framework.js

@@ -0,0 +1,525 @@
+import { t } from "./l10n.js";
+import { BUILDER_RENDERING } from "../data/evidence.js";
+export function fwKind(scan) {
+    const name = (scan?.framework.name ?? "unknown").toLowerCase();
+    const router = (scan?.framework.router ?? "").toLowerCase();
+    if (name === "next" || name.startsWith("next")) {
+        if (router === "pages")
+            return "next-pages";
+        if (router === "app")
+            return "next-app";
+        const files = (scan?.routes ?? []).map((r) => r.file ?? "");
+        if (files.some((f) => /(^|\/)pages\//.test(f)) && !files.some((f) => /(^|\/)app\//.test(f)))
+            return "next-pages";
+        return "next-app";
+    }
+    if (name.startsWith("vite") || name === "vite")
+        return "vite-spa";
+    const map = {
+        astro: "astro", sveltekit: "sveltekit", nuxt: "nuxt", remix: "remix", "react-router": "react-router", gatsby: "gatsby",
+        cra: "cra", angular: "angular", "solid-start": "solid-start", qwik: "qwik", hugo: "hugo", jekyll: "jekyll", eleventy: "eleventy",
+        "static-html": "static-html", "tanstack-start": "tanstack-start", "custom-server": "custom-server", vike: "vike", waku: "waku",
+        docusaurus: "docusaurus", vitepress: "vitepress", vuepress: "vuepress",
+    };
+    return map[name] ?? "unknown";
+}
+export function fwLabel(scan) {
+    if (!scan)
+        return "unknown (no scan yet)";
+    const f = scan.framework;
+    const bits = [f.name + (f.version ? ` ${f.version}` : ""), f.router ? `${f.router} router` : "", f.builder ? `built with ${f.builder}` : ""].filter(Boolean);
+    return `${bits.join(", ")} · rendering ${scan.rendering.verdict}`;
+}
+/** Public text rendered only in the browser? */
+export function isCsr(scan) {
+    if (!scan)
+        return false;
+    if (scan.rendering.verdict === "csr")
+        return true;
+    const k = fwKind(scan);
+    return (k === "vite-spa" || k === "cra") && scan.rendering.verdict === "unknown";
+}
+/** Detect "src/" (and a monorepo prefix such as "apps/web/") in front of app/, pages/ or routes/ from the scanned route files. */
+function srcPrefix(scan, dir) {
+    const files = (scan?.routes ?? []).map((r) => r.file ?? "");
+    for (const f of files) {
+        const i = f.indexOf(`src/${dir}/`);
+        if (i >= 0)
+            return f.slice(0, i) + "src/";
+    }
+    for (const f of files) {
+        const m = new RegExp(`^(.*?/)?${dir}/`).exec(f);
+        if (m)
+            return m[1] ?? "";
+    }
+    return "";
+}
+/** The server entry file of a custom server (the file serving "/"), when known. */
+function serverEntry(scan) {
+    const r = (scan?.routes ?? []).find((x) => x.path === "/" && x.file) ?? (scan?.routes ?? []).find((x) => x.file);
+    return r?.file?.replace(/:\d+.*$/, "");
+}
+function runtimeOf(scan) {
+    return scan?.framework.router || "server";
+}
+function pascal(slug) {
+    return slug
+        .split(/[-/]+/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join("") || "Page";
+}
+/** Where a new public page at `urlPath` goes in this framework. */
+export function pageLocation(scan, urlPath, staticDir = "") {
+    const slug = urlPath.replace(/^\/+|\/+$/g, "") || "index";
+    const k = fwKind(scan);
+    const files = [];
+    const notes = [];
+    switch (k) {
+        case "next-app": {
+            const p = srcPrefix(scan, "app");
+            files.push(`${p}app/${slug}/page.tsx`);
+            notes.push({
+                en: "Server component (no \"use client\" at the top); export `metadata` (or `generateMetadata`) reading from your single SEO source (e.g. src/seo/pages.ts). Add the URL to app/sitemap.ts.",
+                tr: "Sunucu bileşeni (en üstte \"use client\" yok); tek SEO kaynağınızdan (ör. src/seo/pages.ts) okuyan `metadata` (ya da `generateMetadata`) dışa aktarın. Adresi app/sitemap.ts’e ekleyin.",
+            });
+            break;
+        }
+        case "next-pages": {
+            const p = srcPrefix(scan, "pages");
+            files.push(`${p}pages/${slug}.tsx`);
+            notes.push({
+                en: "Use getStaticProps (SSG) so the text is in the HTML; set the head with next/head through your shared SEO component.",
+                tr: "Metin HTML’de olsun diye getStaticProps (SSG) kullanın; head’i ortak SEO bileşeninizle next/head üzerinden verin.",
+            });
+            break;
+        }
+        case "astro":
+            files.push(`src/pages/${slug}.astro`);
+            notes.push({
+                en: "Static by default. Pass title/description to your base layout's <head> from one SEO source; keep important text out of client:only islands. @astrojs/sitemap picks the page up if `site` is set in astro.config.",
+                tr: "Varsayılan olarak statik. title/açıklamayı tek SEO kaynağından temel layout’un <head>’ine geçirin; önemli metni client:only adalarına koymayın. astro.config’te `site` tanımlıysa @astrojs/sitemap sayfayı alır.",
+            });
+            break;
+        case "sveltekit":
+            files.push(`src/routes/${slug}/+page.svelte`, `src/routes/${slug}/+page.ts`);
+            notes.push({
+                en: "In +page.ts: `export const prerender = true;` (never `ssr = false` on public pages). Head tags in <svelte:head> from one SEO source.",
+                tr: "+page.ts içinde: `export const prerender = true;` (herkese açık sayfalarda asla `ssr = false`). Head etiketleri tek SEO kaynağından <svelte:head> içinde.",
+            });
+            break;
+        case "nuxt":
+            files.push(`pages/${slug}.vue`);
+            notes.push({
+                en: "Nuxt 4 uses app/pages/. Keep SSR on (no ssr: false / client-only for this route); prerender it with routeRules or `nuxi generate`; set tags with useSeoMeta().",
+                tr: "Nuxt 4 app/pages/ kullanır. SSR açık kalsın (bu yol için ssr: false / client-only yok); routeRules ya da `nuxi generate` ile ön-render edin; etiketleri useSeoMeta() ile verin.",
+            });
+            break;
+        case "remix":
+        case "react-router":
+            files.push(`app/routes/${slug}.tsx`);
+            notes.push({
+                en: "Export `meta` from the route; in React Router 7 register it in app/routes.ts and, for static pages, add the path to `prerender` in react-router.config.ts.",
+                tr: "Yoldan `meta` dışa aktarın; React Router 7’de app/routes.ts’e kaydedin ve statik sayfalar için yolu react-router.config.ts içindeki `prerender`’a ekleyin.",
+            });
+            break;
+        case "tanstack-start":
+            files.push(`src/routes/${slug}.tsx`);
+            notes.push({
+                en: "File-based route rendered on the server; set title/description with the route's `head()` from one SEO source.",
+                tr: "Sunucuda render edilen dosya tabanlı yol; title/açıklamayı tek SEO kaynağından yolun `head()` fonksiyonuyla verin.",
+            });
+            break;
+        case "gatsby":
+            files.push(`src/pages/${slug}.tsx`);
+            notes.push({
+                en: "Static by default; export the Gatsby Head API (`export const Head`) with title, description and canonical.",
+                tr: "Varsayılan olarak statik; title, açıklama ve canonical ile Gatsby Head API’yi (`export const Head`) dışa aktarın.",
+            });
+            break;
+        case "vite-spa":
+        case "cra":
+            files.push(`src/pages/${pascal(slug)}.tsx`, "src/App.tsx (add the <Route>)");
+            notes.push({
+                en: "WARNING: this is a single-page app. Without prerendering (P2) bots get an empty page and the new page won't count. Do P2 first, then add the route to the prerender list.",
+                tr: "UYARI: bu bir tek sayfa uygulama. Ön-render (P2) olmadan botlar boş sayfa görür ve yeni sayfa işe yaramaz. Önce P2’yi yapın, sonra yolu ön-render listesine ekleyin.",
+            });
+            break;
+        case "angular":
+            files.push(`src/app/pages/${slug}/${slug}.component.ts`, "src/app/app.routes.ts (add the route)");
+            notes.push({
+                en: "Use Angular SSR with prerendering (`ng add @angular/ssr`) so the route ships as HTML; set tags with the Title and Meta services.",
+                tr: "Yol HTML olarak gitsin diye ön-render’lı Angular SSR kullanın (`ng add @angular/ssr`); etiketleri Title ve Meta servisleriyle verin.",
+            });
+            break;
+        case "custom-server": {
+            const entry = serverEntry(scan);
+            const seo = scan?.files.headSource?.path;
+            files.push(entry ? `${entry} (add the route)` : `your ${runtimeOf(scan)} entry (add the route)`, seo ? `${seo} (title, description, canonical for the new path)` : "src/site/seo.js (one SEO module: path → title, description, canonical, og)", "src/site/pages.js (the page's text as data)");
+            notes.push({
+                en: `Custom ${runtimeOf(scan)}: add a route that returns server-rendered HTML built from one data module (the page's text), with the head tags from one SEO module (e.g. src/site/seo.js). Generate robots.txt, sitemap.xml and llms.txt in code from the same modules so they never disagree.`,
+                tr: `Özel ${runtimeOf(scan)}: sayfanın metnini tek bir veri modülünden kurup sunucuda render edilmiş HTML döndüren bir yol ekleyin; head etiketleri tek bir SEO modülünden (ör. src/site/seo.js) gelsin. robots.txt, sitemap.xml ve llms.txt’yi de aynı modüllerden kodla üretin ki hiç çelişmesinler.`,
+            });
+            break;
+        }
+        case "vike":
+            files.push(`pages/${slug}/+Page.tsx`, `pages/${slug}/+config.ts`);
+            notes.push({ en: "Set `title`/`description` (or a +Head) for the page and `prerender: true` for marketing pages.", tr: "Sayfa için `title`/`description` (ya da +Head) ve pazarlama sayfaları için `prerender: true` ayarlayın." });
+            break;
+        case "waku":
+            files.push(`src/pages/${slug}.tsx`);
+            notes.push({ en: "Export `getConfig` returning `{ render: 'static' }` so the page ships as HTML; set <title>/<meta> in the page.", tr: "Sayfa HTML olarak gitsin diye `{ render: 'static' }` döndüren `getConfig` dışa aktarın; <title>/<meta>’yı sayfada verin." });
+            break;
+        case "docusaurus":
+            files.push(`src/pages/${slug}.md`);
+            notes.push({ en: "Front matter: title, description; Docusaurus renders static HTML. Docs pages live under docs/.", tr: "Front matter: title, description; Docusaurus statik HTML üretir. Doküman sayfaları docs/ altında." });
+            break;
+        case "vitepress":
+        case "vuepress":
+            files.push(`docs/${slug}.md`);
+            notes.push({ en: "Front matter: title, description (and head for extra tags); the site is static HTML.", tr: "Front matter: title, description (ek etiketler için head); site statik HTML." });
+            break;
+        case "hugo":
+            files.push(`content/${slug}.md`);
+            notes.push({ en: "Front matter: title, description, lastmod (only when the words change).", tr: "Front matter: title, description, lastmod (yalnızca kelimeler değişince)." });
+            break;
+        case "jekyll":
+            files.push(`${slug}.md`);
+            notes.push({ en: `Front matter: title, description, permalink: /${slug}/ (jekyll-seo-tag renders the head).`, tr: `Front matter: title, description, permalink: /${slug}/ (head’i jekyll-seo-tag üretir).` });
+            break;
+        case "eleventy":
+            files.push(`src/${slug}.md`);
+            notes.push({ en: "Front matter: title, description, permalink; the base layout renders the head.", tr: "Front matter: title, description, permalink; head’i temel layout üretir." });
+            break;
+        case "static-html":
+            files.push(`${staticDir ? staticDir + "/" : ""}${slug}/index.html`);
+            notes.push({ en: "Plain HTML is already readable by every bot; copy the head block from an existing page and update it.", tr: "Düz HTML zaten her bot tarafından okunur; head bloğunu mevcut bir sayfadan kopyalayıp güncelleyin." });
+            break;
+        default:
+            files.push(`[FILL: the page file for ${urlPath} — run katman_scan_code so Katman knows the framework]`);
+    }
+    return { files, notes };
+}
+export function builderNote(scan) {
+    const b = (scan?.framework.builder ?? "").toLowerCase();
+    if (!b)
+        return undefined;
+    for (const key of Object.keys(BUILDER_RENDERING))
+        if (b.includes(key))
+            return BUILDER_RENDERING[key];
+    return undefined;
+}
+function p2Notes(scan) {
+    const k = fwKind(scan);
+    const notes = [];
+    const b = builderNote(scan);
+    if (b)
+        notes.push(b);
+    if (k === "vite-spa" || k === "cra" || scan.rendering.verdict === "csr") {
+        notes.push({
+            en: `Your public pages are rendered in the browser (${fwLabel(scan)}). Options, smallest change first:
+1. Prerender the public routes at build time and keep the app as a SPA: React Router 7 framework mode with \`ssr: false\` + \`prerender: ["/", "/pricing", …]\` in react-router.config.ts, or a prerender plugin (e.g. @prerenderer/rollup-plugin for Vite; react-snap for CRA). Build, then run the P2 curl command on every public route.
+2. Move the marketing pages to Astro on the same domain (the app stays React under /app/); Astro renders React components to HTML and ships JS only where you add client:*.
+3. Full SSR (Next.js, React Router 7 SSR, TanStack Start): the biggest change; worth it only if many public pages need live data.
+Never serve bots a different page than people (cloaking): prerender the exact same content.`,
+            tr: `Herkese açık sayfalarınız tarayıcıda render ediliyor (${fwLabel(scan)}). Seçenekler, en küçük değişiklik önce:
+1. Herkese açık yolları derleme anında ön-render edin, uygulamayı SPA olarak bırakın: React Router 7 framework modunda react-router.config.ts içinde \`ssr: false\` + \`prerender: ["/", "/pricing", …]\`, ya da bir ön-render eklentisi (Vite için ör. @prerenderer/rollup-plugin; CRA için react-snap). Derleyin, sonra P2’deki curl komutunu her herkese açık yolda çalıştırın.
+2. Pazarlama sayfalarını aynı alan adında Astro’ya taşıyın (uygulama /app/ altında React olarak kalır); Astro React bileşenlerini HTML’e çevirir, JS’i yalnızca client:* eklediğiniz yere gönderir.
+3. Tam SSR (Next.js, React Router 7 SSR, TanStack Start): en büyük değişiklik; yalnızca çok sayıda herkese açık sayfa canlı veri istiyorsa değer.
+Botlara insanlardan farklı sayfa göstermeyin (cloaking): tam olarak aynı içeriği ön-render edin.`,
+        });
+    }
+    else if (k === "next-app" || k === "next-pages") {
+        notes.push({
+            en: "Next.js renders on the server, but text fetched in a client component (\"use client\" + useEffect/SWR) is still missing from the HTML. Move page copy into server components or static props; use generateStaticParams for situation pages.",
+            tr: "Next.js sunucuda render eder, ama istemci bileşeninde çekilen metin (\"use client\" + useEffect/SWR) HTML’de yine yoktur. Sayfa metnini sunucu bileşenlerine ya da statik props’a taşıyın; durum sayfaları için generateStaticParams kullanın.",
+        });
+    }
+    else if (k === "custom-server") {
+        notes.push({
+            en: `Your ${runtimeOf(scan)} renders the HTML itself. Check that every public page's text is in the HTML response (not injected later by client JavaScript), and render pages from one data module so the text, the head tags, the sitemap and llms.txt come from the same source.`,
+            tr: `${runtimeOf(scan)} HTML’i kendisi üretiyor. Her herkese açık sayfanın metninin HTML yanıtında olduğunu (sonradan istemci JavaScript’iyle eklenmediğini) kontrol edin; sayfaları tek bir veri modülünden üretin ki metin, head etiketleri, sitemap ve llms.txt aynı kaynaktan gelsin.`,
+        });
+    }
+    else if (k === "tanstack-start") {
+        notes.push({ en: "TanStack Start renders on the server (new Lovable apps use it): keep SSR on for public routes (no `ssr: false`) and prerender static marketing pages if your host supports it.", tr: "TanStack Start sunucuda render eder (yeni Lovable uygulamaları bunu kullanır): herkese açık yollarda SSR açık kalsın (`ssr: false` yok), barındırma destekliyorsa statik pazarlama sayfalarını ön-render edin." });
+    }
+    else if (k === "vike" || k === "waku") {
+        notes.push({ en: k === "vike" ? "vike renders on the server; set `prerender: true` for marketing pages and never disable SSR on public routes." : "Waku: use static rendering (`getConfig` → render: 'static') for marketing pages.", tr: k === "vike" ? "vike sunucuda render eder; pazarlama sayfaları için `prerender: true` ayarlayın, herkese açık yollarda SSR’ı kapatmayın." : "Waku: pazarlama sayfaları için statik render (`getConfig` → render: 'static') kullanın." });
+    }
+    else if (k === "astro" || k === "hugo" || k === "jekyll" || k === "eleventy" || k === "static-html" || k === "gatsby" || k === "docusaurus" || k === "vitepress" || k === "vuepress") {
+        notes.push({
+            en: "This framework outputs static HTML already; check that no important text sits in client-only widgets (client:only islands, iframes, tabs filled by JS).",
+            tr: "Bu çatı zaten statik HTML üretiyor; önemli bir metnin yalnızca istemcide çalışan parçalarda (client:only adaları, iframe’ler, JS ile dolan sekmeler) olmadığını kontrol edin.",
+        });
+    }
+    else if (k === "nuxt") {
+        notes.push({ en: "Keep SSR on (the default); remove `ssr: false` and <ClientOnly> around public text; prerender marketing routes with routeRules.", tr: "SSR açık kalsın (varsayılan); herkese açık metnin etrafındaki `ssr: false` ve <ClientOnly>’yi kaldırın; pazarlama yollarını routeRules ile ön-render edin." });
+    }
+    else if (k === "sveltekit") {
+        notes.push({ en: "Remove `export const ssr = false` from public routes; add `export const prerender = true` to marketing pages.", tr: "Herkese açık yollardan `export const ssr = false`’u kaldırın; pazarlama sayfalarına `export const prerender = true` ekleyin." });
+    }
+    else if (k === "angular") {
+        notes.push({ en: "Add Angular SSR with prerendering (`ng add @angular/ssr`) and list the public routes to prerender.", tr: "Ön-render’lı Angular SSR ekleyin (`ng add @angular/ssr`) ve ön-render edilecek herkese açık yolları listeleyin." });
+    }
+    else if (k === "remix" || k === "react-router") {
+        notes.push({ en: "Server rendering is available; if the app runs in SPA mode (ssr: false), add the public paths to `prerender` in react-router.config.ts.", tr: "Sunucuda render mümkün; uygulama SPA modunda (ssr: false) çalışıyorsa herkese açık yolları react-router.config.ts içindeki `prerender`’a ekleyin." });
+    }
+    return notes;
+}
+function p3Notes(scan) {
+    switch (fwKind(scan)) {
+        case "next-app":
+            return [{ en: "App Router: one `src/seo/pages.ts` map (path → title, description, og). In each page `export const metadata` (or `generateMetadata`) reads from it; set `metadataBase` in the root layout so canonical and og:url are absolute; `alternates: { canonical, languages }` for hreflang.", tr: "App Router: tek bir `src/seo/pages.ts` haritası (yol → title, açıklama, og). Her sayfada `export const metadata` (ya da `generateMetadata`) oradan okur; canonical ve og:url mutlak olsun diye kök layout’ta `metadataBase` tanımlayın; hreflang için `alternates: { canonical, languages }`." }];
+        case "next-pages":
+            return [{ en: "Pages Router: a shared <Seo> component using next/head, fed from `src/seo/pages.ts`.", tr: "Pages Router: `src/seo/pages.ts`’ten beslenen, next/head kullanan ortak bir <Seo> bileşeni." }];
+        case "astro":
+            return [{ en: "A BaseHead.astro component in the layout, fed from `src/seo/pages.ts` (or page frontmatter).", tr: "Layout’ta `src/seo/pages.ts`’ten (ya da sayfa frontmatter’ından) beslenen bir BaseHead.astro bileşeni." }];
+        case "vite-spa":
+        case "cra":
+            return [{ en: "SPA: react-helmet-async tags only reach bots after prerendering (P2). Keep one `src/seo/pages.ts` map and make the prerender step write the head per route.", tr: "SPA: react-helmet-async etiketleri botlara ancak ön-render’dan (P2) sonra ulaşır. Tek bir `src/seo/pages.ts` haritası tutun ve ön-render adımı her yol için head’i yazsın." }];
+        case "nuxt":
+            return [{ en: "useSeoMeta() in each page (or app.vue) fed from one data file.", tr: "Her sayfada (ya da app.vue’da) tek veri dosyasından beslenen useSeoMeta()." }];
+        case "sveltekit":
+            return [{ en: "<svelte:head> in +layout.svelte reading page data from `src/lib/seo/pages.ts`.", tr: "+layout.svelte içinde `src/lib/seo/pages.ts`’ten sayfa verisi okuyan <svelte:head>." }];
+        case "remix":
+        case "react-router":
+            return [{ en: "Each route's `meta` export reads from one `app/seo/pages.ts` map.", tr: "Her yolun `meta` dışa aktarımı tek bir `app/seo/pages.ts` haritasından okur." }];
+        case "custom-server": {
+            const seo = scan.files.headSource?.path ?? "src/site/seo.js";
+            return [{ en: `Keep one SEO module (${seo}) that maps each path to title, description, canonical and og tags and renders <head>; every route handler calls it — no head tags written inline in handlers.`, tr: `Her yolu title, açıklama, canonical ve og etiketlerine eşleyip <head>’i üreten tek bir SEO modülü (${seo}) tutun; her yol işleyicisi onu çağırsın — işleyicilerde elle yazılmış head etiketi olmasın.` }];
+        }
+        case "tanstack-start":
+            return [{ en: "Each route's `head()` returns title/meta from one `src/seo/pages.ts` map.", tr: "Her yolun `head()` fonksiyonu title/meta’yı tek bir `src/seo/pages.ts` haritasından döndürür." }];
+        case "vike":
+            return [{ en: "`title`/`description` in each page's +config (or one +Head reading `src/seo/pages.ts`).", tr: "Her sayfanın +config’inde `title`/`description` (ya da `src/seo/pages.ts`’ten okuyan tek bir +Head)." }];
+        case "docusaurus":
+        case "vitepress":
+        case "vuepress":
+            return [{ en: "Front matter title/description per page; site-wide tags in the site config.", tr: "Sayfa başına front matter title/description; site geneli etiketler site yapılandırmasında." }];
+        default:
+            return [];
+    }
+}
+function p4Notes(scan, staticDir) {
+    const notes = [];
+    const k = fwKind(scan);
+    const sd = staticDir ? staticDir + "/" : "";
+    if (scan.files.robots.generated && scan.files.robots.path) {
+        notes.push({ en: `robots.txt is generated by ${scan.files.robots.path}: edit that file (a static ${sd}robots.txt would conflict).`, tr: `robots.txt ${scan.files.robots.path} tarafından üretiliyor: o dosyayı düzenleyin (statik ${sd}robots.txt çakışır).` });
+    }
+    if (k === "next-app")
+        notes.push({ en: "Next.js: app/robots.ts (MetadataRoute.Robots) and app/sitemap.ts (MetadataRoute.Sitemap) generated from the page list; lastmod from each page's content date.", tr: "Next.js: sayfa listesinden üretilen app/robots.ts (MetadataRoute.Robots) ve app/sitemap.ts (MetadataRoute.Sitemap); lastmod her sayfanın içerik tarihinden." });
+    else if (k === "astro")
+        notes.push({ en: `Astro: ${sd}robots.txt plus @astrojs/sitemap (it writes sitemap-index.xml — point the Sitemap: line at it).`, tr: `Astro: ${sd}robots.txt ve @astrojs/sitemap (sitemap-index.xml yazar — Sitemap: satırını ona yönlendirin).` });
+    else if (k === "sveltekit")
+        notes.push({ en: "SvelteKit: static/robots.txt and a prerendered src/routes/sitemap.xml/+server.ts.", tr: "SvelteKit: static/robots.txt ve ön-render edilen src/routes/sitemap.xml/+server.ts." });
+    else if (k === "nuxt")
+        notes.push({ en: "Nuxt: public/robots.txt (or @nuxtjs/robots) and @nuxtjs/sitemap.", tr: "Nuxt: public/robots.txt (ya da @nuxtjs/robots) ve @nuxtjs/sitemap." });
+    else if (k === "custom-server")
+        notes.push({ en: `Custom ${runtimeOf(scan)}: serve /robots.txt, /sitemap.xml and /llms.txt from routes generated from the same data/SEO modules as the pages (lastmod from each page's content date).`, tr: `Özel ${runtimeOf(scan)}: /robots.txt, /sitemap.xml ve /llms.txt’yi sayfalarla aynı veri/SEO modüllerinden üretilen yollardan sunun (lastmod her sayfanın içerik tarihinden).` });
+    else if (k === "vite-spa" || k === "cra")
+        notes.push({ en: `SPA: ${sd}robots.txt, and a small build script that writes ${sd}sitemap.xml from the same route list the prerender step uses.`, tr: `SPA: ${sd}robots.txt ve ön-render adımının kullandığı yol listesinden ${sd}sitemap.xml yazan küçük bir derleme betiği.` });
+    notes.push({ en: "`katman_generate {\"artifact\":\"robots.txt\"}` builds this project's file: one group per AI bot, app paths closed with trailing slashes, auth pages left to noindex.", tr: "`katman_generate {\"artifact\":\"robots.txt\"}` bu projenin dosyasını üretir: her yapay zekâ botuna bir grup, uygulama yolları sonda / ile kapalı, giriş sayfaları noindex’e bırakılmış." });
+    return notes;
+}
+function p5Notes(scan) {
+    switch (fwKind(scan)) {
+        case "next-app":
+        case "next-pages":
+            return [{ en: "Render `<script type=\"application/ld+json\" dangerouslySetInnerHTML={{ __html: JSON.stringify(data).replace(/</g, \"\\\\u003c\") }} />` inside the page (server-side), with data built from the same source as the visible text.", tr: "Sayfanın içinde (sunucu tarafında) görünen metinle aynı kaynaktan kurulan veriyle `<script type=\"application/ld+json\" dangerouslySetInnerHTML={{ __html: JSON.stringify(data).replace(/</g, \"\\\\u003c\") }} />` render edin." }];
+        case "astro":
+            return [{ en: "`<script type=\"application/ld+json\" set:html={JSON.stringify(data)} />` in the layout/page.", tr: "Layout/sayfada `<script type=\"application/ld+json\" set:html={JSON.stringify(data)} />`." }];
+        case "nuxt":
+            return [{ en: "useHead({ script: [{ type: 'application/ld+json', innerHTML: JSON.stringify(data) }] }).", tr: "useHead({ script: [{ type: 'application/ld+json', innerHTML: JSON.stringify(data) }] })." }];
+        case "vite-spa":
+        case "cra":
+            return [{ en: "SPA: JSON-LD added by JavaScript only reaches bots after prerendering (P2).", tr: "SPA: JavaScript ile eklenen JSON-LD botlara ancak ön-render’dan (P2) sonra ulaşır." }];
+        default:
+            return [];
+    }
+}
+function p8Notes(scan, staticDir) {
+    const sd = staticDir ? staticDir + "/" : "";
+    const notes = [];
+    if (scan.files.llms.exists)
+        notes.push({ en: `llms.txt already exists (${scan.files.llms.path ?? sd + "llms.txt"}): compare it with research instead of starting over.`, tr: `llms.txt zaten var (${scan.files.llms.path ?? sd + "llms.txt"}): baştan yazmak yerine araştırmayla karşılaştırın.` });
+    const k = fwKind(scan);
+    if (k === "next-app")
+        notes.push({ en: `Next.js: ${sd}llms.txt, or a route handler app/llms.txt/route.ts that builds the text from the same data file as the pages.`, tr: `Next.js: ${sd}llms.txt ya da metni sayfalarla aynı veri dosyasından kuran bir app/llms.txt/route.ts.` });
+    else if (k === "astro")
+        notes.push({ en: "Astro: an endpoint src/pages/llms.txt.ts (prerendered) built from the same data as the pages.", tr: "Astro: sayfalarla aynı veriden kurulan (ön-render edilen) bir src/pages/llms.txt.ts uç noktası." });
+    else if (k === "custom-server")
+        notes.push({ en: "Serve /llms.txt from a route that builds it from the same data module as the pages.", tr: "/llms.txt’yi sayfalarla aynı veri modülünden kuran bir yoldan sunun." });
+    notes.push({ en: "`katman_generate {\"artifact\":\"llms.txt\"}` drafts it from research (the one sentence, pricing, not-X, live situation pages).", tr: "`katman_generate {\"artifact\":\"llms.txt\"}` taslağı araştırmadan üretir (tek cümle, fiyat, “X değildir”, yayındaki durum sayfaları)." });
+    return notes;
+}
+function p9Notes(scan) {
+    switch (fwKind(scan)) {
+        case "next-app":
+        case "next-pages":
+            return [{ en: "Use next/image (width/height required, lazy by default; `priority` on the hero image).", tr: "next/image kullanın (width/height zorunlu, varsayılan lazy; ilk ekrandaki görselde `priority`)." }];
+        case "astro":
+            return [{ en: "Use <Image /> from astro:assets (sizes, formats and dimensions are generated).", tr: "astro:assets’ten <Image /> kullanın (boyutlar, formatlar ve ölçüler üretilir)." }];
+        case "nuxt":
+            return [{ en: "Use <NuxtImg> from @nuxt/image.", tr: "@nuxt/image’dan <NuxtImg> kullanın." }];
+        default:
+            return [];
+    }
+}
+function p10Notes(scan) {
+    const k = fwKind(scan);
+    const link = k.startsWith("next") ? "next/link <Link href>" : k === "vite-spa" || k === "cra" || k === "react-router" || k === "remix" ? "react-router <Link to> (renders <a href>)" : k === "nuxt" ? "<NuxtLink to>" : "<a href>";
+    return [{ en: `Navigate with ${link}; never a div/button with onClick + navigate(). Put the situation pages in the footer so every page links to them.`, tr: `${link} ile yönlendirin; asla onClick + navigate() olan div/button değil. Durum sayfalarını altbilgiye koyun ki her sayfa onlara link versin.` }];
+}
+function p11Notes(scan) {
+    const notes = [];
+    const host = (scan.hosting.provider ?? "").toLowerCase();
+    const k = fwKind(scan);
+    const spa = k === "vite-spa" || k === "cra" || scan.rendering.verdict === "csr";
+    if (host.includes("cloudflare"))
+        notes.push({ en: "Cloudflare Pages: without a top-level 404.html, Pages treats the project as a SPA and serves index.html with 200 for unknown URLs. Ship a real 404.html.", tr: "Cloudflare Pages: kökte 404.html yoksa Pages projeyi SPA sayar ve olmayan adreslere 200 ile index.html döner. Gerçek bir 404.html koyun." });
+    if (host.includes("netlify"))
+        notes.push({ en: "Netlify: a catch-all `/* /index.html 200` rule makes every unknown URL a soft 404. List the real routes instead and let the rest 404.", tr: "Netlify: `/* /index.html 200` kuralı her olmayan adresi sahte 404 yapar. Bunun yerine gerçek yolları listeleyin, gerisi 404 dönsün." });
+    if (host.includes("vercel"))
+        notes.push({ en: "Vercel: a rewrite of `/(.*)` to `/index.html` in vercel.json returns 200 for every URL. Rewrite only the real app routes; serve a 404 page for the rest.", tr: "Vercel: vercel.json’da `/(.*)` → `/index.html` yeniden yazması her adrese 200 döner. Yalnızca gerçek uygulama yollarını yeniden yazın; gerisine 404 sayfası verin." });
+    if (host.includes("github"))
+        notes.push({ en: "GitHub Pages: don't copy index.html to 404.html as an SPA trick — deep links then return 404 to bots. Prerender the real routes.", tr: "GitHub Pages: SPA hilesi olarak index.html’i 404.html’e kopyalamayın — derin linkler botlara 404 döner. Gerçek yolları ön-render edin." });
+    if (host.includes("firebase"))
+        notes.push({ en: "Firebase Hosting: a `\"source\": \"**\" → /index.html` rewrite makes soft 404s; rewrite only the app routes.", tr: "Firebase Hosting: `\"source\": \"**\" → /index.html` yeniden yazması sahte 404 üretir; yalnızca uygulama yollarını yeniden yazın." });
+    if (k === "next-app")
+        notes.push({ en: "Next.js: app/not-found.tsx + notFound() returns a real 404.", tr: "Next.js: app/not-found.tsx + notFound() gerçek 404 döner." });
+    if (k === "custom-server") {
+        notes.push({ en: `Custom ${runtimeOf(scan)}: unknown paths must get a real 404 status from the server; 301 the default host (e.g. *.workers.dev) to the main domain by checking the Host header — or turn it off (wrangler: workers_dev = false).`, tr: `Özel ${runtimeOf(scan)}: olmayan yollar sunucudan gerçek 404 almalı; varsayılan adresi (ör. *.workers.dev) Host başlığına bakarak asıl alan adına 301 ile yönlendirin — ya da kapatın (wrangler: workers_dev = false).` });
+    }
+    if (spa && !notes.length)
+        notes.push({ en: "SPA hosting usually serves index.html with 200 for every path. Serve real routes (prerendered files) and a 404.html with a 404 status for everything else.", tr: "SPA barındırma genelde her yola 200 ile index.html verir. Gerçek yolları (ön-render dosyaları) sunun, geri kalan her şeye 404 durumlu bir 404.html verin." });
+    if (scan.hosting.previewPatterns.length) {
+        notes.push({
+            en: `Preview hosts seen in this project: ${scan.hosting.previewPatterns.join(", ")}. 301 them to the main domain (middleware/edge rule checking the Host header), or send \`X-Robots-Tag: noindex\` on every non-production host, or keep them password-protected. robots.txt isn't enough.`,
+            tr: `Bu projede görülen önizleme adresleri: ${scan.hosting.previewPatterns.join(", ")}. Bunları asıl alan adına 301 ile yönlendirin (Host başlığına bakan middleware/edge kuralı), ya da üretim dışı her adreste \`X-Robots-Tag: noindex\` gönderin, ya da şifreli tutun. robots.txt yetmez.`,
+        });
+    }
+    return notes;
+}
+function p13Notes(scan) {
+    const notes = [];
+    const prov = scan.analytics.providers;
+    notes.push({
+        en: `Analytics in this project: ${prov.length ? prov.join(", ") : "none detected"}${scan.analytics.tracksAiChannel ? " (an AI channel is already tracked)" : ""}. \`katman_generate {"artifact":"analytics-channel-snippet"}\` adds the human filter and the AI channel rule and pushes them to your analytics.`,
+        tr: `Bu projedeki analitik: ${prov.length ? prov.join(", ") : "bulunamadı"}${scan.analytics.tracksAiChannel ? " (yapay zekâ kanalı zaten izleniyor)" : ""}. \`katman_generate {"artifact":"analytics-channel-snippet"}\` insan filtresini ve yapay zekâ kanal kuralını ekler ve analitiğinize gönderir.`,
+    });
+    notes.push({
+        en: `Bot counting: \`katman_generate {"artifact":"bot-counter-snippet","options":{"platform":"${suggestBotPlatform(scan)}"}}\`.`,
+        tr: `Bot sayımı: \`katman_generate {"artifact":"bot-counter-snippet","options":{"platform":"${suggestBotPlatform(scan)}"}}\`.`,
+    });
+    return notes;
+}
+export function suggestBotPlatform(scan) {
+    const host = (scan?.hosting.provider ?? "").toLowerCase();
+    const k = fwKind(scan);
+    if (k === "next-app" || k === "next-pages")
+        return "nextjs-middleware";
+    if (k === "sveltekit" && scan?.rendering.verdict !== "ssg")
+        return "sveltekit-hooks";
+    if (k === "astro" && (scan?.rendering.verdict === "ssr" || scan?.rendering.verdict === "hybrid"))
+        return "astro-middleware";
+    if (k === "custom-server")
+        return (scan?.framework.router ?? "").includes("express") || (scan?.framework.router ?? "").includes("node") ? "express" : "cloudflare-worker";
+    if (host.includes("cloudflare"))
+        return "cloudflare-worker";
+    if (host.includes("node") || host.includes("render") || host.includes("railway") || host.includes("fly"))
+        return "express";
+    return "cloudflare-worker";
+}
+/** Framework/host-aware notes for a prompt (empty when there's no scan). */
+export function frameworkNotes(id, scan, lang, staticDir = "") {
+    if (!scan)
+        return [];
+    let notes = [];
+    switch (id) {
+        case "P2":
+            notes = p2Notes(scan);
+            break;
+        case "P3":
+            notes = p3Notes(scan);
+            break;
+        case "P4":
+            notes = p4Notes(scan, staticDir);
+            break;
+        case "P5":
+            notes = p5Notes(scan);
+            break;
+        case "P8":
+            notes = p8Notes(scan, staticDir);
+            break;
+        case "P9":
+            notes = p9Notes(scan);
+            break;
+        case "P10":
+            notes = p10Notes(scan);
+            break;
+        case "P11":
+            notes = p11Notes(scan);
+            break;
+        case "P13":
+            notes = p13Notes(scan);
+            break;
+        case "P6": {
+            const loc = pageLocation(scan, "/your-situation-page", staticDir);
+            notes = [{ en: `New page file (${fwLabel(scan)}): ${loc.files.join(" + ")}.`, tr: `Yeni sayfa dosyası (${fwLabel(scan)}): ${loc.files.join(" + ")}.` }, ...loc.notes];
+            if (isCsr(scan))
+                notes.unshift({ en: "Do P2 first: on a client-rendered site a new situation page is empty for bots.", tr: "Önce P2: istemcide render edilen sitede yeni durum sayfası botlar için boştur." });
+            break;
+        }
+        case "P7": {
+            const loc = pageLocation(scan, "/guides/tools", staticDir);
+            notes = [{ en: `Guide page file: ${loc.files.join(" + ")}.`, tr: `Rehber sayfası dosyası: ${loc.files.join(" + ")}.` }];
+            break;
+        }
+        case "P14":
+            notes = [{ en: "Add to package.json: \"seo-check\": \"katman-mcp audit <your site URL> --strict\" (exits 2 on critical findings) and run it in CI after every deploy.", tr: "package.json’a ekleyin: \"seo-check\": \"katman-mcp audit <site adresiniz> --strict\" (kritik bulguda 2 ile çıkar) ve her yayından sonra CI’da çalıştırın." }];
+            break;
+        default:
+            notes = [];
+    }
+    return notes.map((n) => t(n, lang));
+}
+/** File hints for plan tasks. */
+export function fileHints(id, scan, staticDir) {
+    const sd = staticDir ? staticDir + "/" : "";
+    const k = fwKind(scan);
+    const head = scan?.files.headSource?.path;
+    const cfg = {
+        "next-app": "next.config.*", "next-pages": "next.config.*", astro: "astro.config.*", sveltekit: "svelte.config.js", nuxt: "nuxt.config.ts",
+        "vite-spa": "vite.config.ts", cra: "package.json", remix: "vite.config.ts", "react-router": "react-router.config.ts", angular: "angular.json",
+    };
+    if (k === "custom-server") {
+        const entry = serverEntry(scan) ?? "server entry";
+        if (id === "P2")
+            return [entry];
+        if (id === "P3" || id === "P5")
+            return [head ?? "src/site/seo.js (one SEO module)", entry];
+        if (id === "P4")
+            return [`${entry} (/robots.txt and /sitemap.xml routes)`];
+        if (id === "P8")
+            return [`${entry} (/llms.txt route)`];
+    }
+    switch (id) {
+        case "P2": return [cfg[k] ?? "framework config", k === "vite-spa" || k === "cra" ? "src/App.tsx (router)" : ""].filter(Boolean);
+        case "P3": return ["src/seo/pages.ts (new, single source)", head ?? "layout / head component"];
+        case "P4": return [scan?.files.robots.path ?? `${sd}robots.txt`, scan?.files.sitemap.path ?? `${sd}sitemap.xml (generated at build)`];
+        case "P5": return [head ?? "layout (Organization, WebSite)", "page templates (per-page types)"];
+        case "P8": return [scan?.files.llms.path ?? `${sd}llms.txt`];
+        case "P9": return ["components that render <img>", `${sd}images`];
+        case "P10": return ["header / footer / nav components"];
+        case "P11": {
+            const host = (scan?.hosting.provider ?? "").toLowerCase();
+            const hostFile = host.includes("vercel") ? "vercel.json" : host.includes("netlify") ? "netlify.toml or _redirects" : host.includes("cloudflare") ? `${sd}404.html / wrangler config` : "hosting config (redirects)";
+            return [hostFile, scan?.files.notFound.path ?? "404 page"];
+        }
+        case "P13": return ["analytics setup (layout/root)", suggestBotPlatform(scan) === "nextjs-middleware" ? "middleware.ts (proxy.ts on Next 16+)" : "server/edge entry"];
+        case "P14": return ["package.json (seo-check script)", "CI workflow"];
+        default: return [];
+    }
+}

package/dist/tools/method/lib/l10n.js

@@ -0,0 +1,17 @@
+export function t(v, lang) {
+    return lang === "tr" ? v.tr : v.en;
+}
+export function pick(v, lang) {
+    return lang === "tr" ? v.tr : v.en;
+}
+export function toLang(x, fallback = "en") {
+    return x === "tr" || x === "en" ? x : fallback;
+}
+export const STRENGTH_LABEL = {
+    strong: { en: "STRONG", tr: "GÜÇLÜ" },
+    "medium-strong": { en: "MEDIUM-STRONG", tr: "ORTA-GÜÇLÜ" },
+    medium: { en: "MEDIUM", tr: "ORTA" },
+    weak: { en: "WEAK", tr: "ZAYIF" },
+    lab: { en: "STRONG (LAB)", tr: "GÜÇLÜ (LABORATUVAR)" },
+    announcement: { en: "ANNOUNCEMENT", tr: "DUYURU" },
+};