@webnumseoagent/next 0.5.0 → 0.7.0

package/README.md

@@ -93,8 +93,22 @@ Vercel и `git push`. **Проверь `git diff`** перед коммитом
    }
    ```
 
+## Блог (git-native)
+
+Блог рендерится **из файлов репозитория** — папка `content/blog` (формат blogfs v1).
+Статьи туда пишет платформа SEO Agent через git-доставку (коммит/PR); Supabase не нужен.
+
+- Роуты ставит `npx @webnumseoagent/next blog` (мультиязычный сайт → `/[locale]/blog`,
+  под layout сайта) или `init` (по умолчанию, `--no-blog` чтобы отключить).
+- Рендер **полностью статический** (`dynamic = "force-static"`, `dynamicParams = false`):
+  файлы читаются только на сборке, в рантайме ничего не запрашивается. Новый/изменённый
+  контент = git-коммит → редеплой пересобирает страницы.
+- Тема оформления (фирменный цвет) и канонический URL-префикс берутся из `content/blog/.blogfs.json`.
+- Sitemap блога добавляется автоматически (раздел `sitemap/blog.xml`).
+
 ## Гарантии
 - **Fail-safe:** при недоступности платформы адаптер возвращает твои дефолты и
   разрешающий robots — сайт не падает и не уходит в `noindex`.
+- **Блог без сети:** статьи читаются из файлов репо на сборке — ни Supabase, ни запросов к платформе.
 - **Защита от деиндекса:** `index:false` применяется только если он явно задан в конфиге.
 - **Generic:** ничего не завязано на конкретный сайт — только env + маршрут/локаль.

package/bin/cli.mjs

@@ -40,8 +40,8 @@ async function anyExistsRel(paths) {
   return false;
 }
 // Пишет НАШ генерируемый роут: создаёт, если нет; ПЕРЕЗАПИСЫВАЕТ, если файл уже наш (импортит наши
-// blog-компоненты) и содержимое изменилось (напр. старый init-роут без ?show → обновляем на актуальный
-// с пагинацией); НЕ трогает собственный блог сайта (файл без наших импортов).
+// blog-компоненты) и содержимое изменилось (напр. старый динамический роут с ?show → обновляем на
+// актуальный статический); НЕ трогает собственный блог сайта (файл без наших импортов).
 async function writeOurRoute(p, content) {
   const cur = await fs.readFile(p, "utf8").catch(() => null);
   if (cur === null) {
@@ -131,7 +131,7 @@ async function init() {
     // Вендор-файлы адаптера — генерируемые (их не правят руками): при повторном init ОБНОВЛЯЕМ,
     // если содержимое изменилось. Иначе апгрейд оставит старый client.ts без новых экспортов
     // (напр. seoMerchantFeedXml), а свежесозданный роут импортнёт несуществующий символ → build падёт.
-    for (const f of ["client.ts", "jsonld.tsx", "sitemap-xsl.ts", "sitemap-build.ts", "redirects.ts", "blog.tsx"]) {
+    for (const f of ["client.ts", "jsonld.tsx", "sitemap-xsl.ts", "sitemap-build.ts", "redirects.ts", "blog.tsx", "blog-fs.ts", "sanitize.ts"]) {
       const dest = path.join(vendor, f);
       const src = await fs.readFile(path.join(pkgRoot, f));
       const cur = await fs.readFile(dest).catch(() => null);
@@ -409,7 +409,7 @@ async function init() {
     const mdParam = ext === "ts" ? "{ params }: { params: { slug: string } }" : "{ params }";
     const madeIndex = await ensureFile(
       path.join(root, appDir, `blog/page.${jsxExt}`),
-      `import { SeoBlogIndex } from "${blogFor("blog/page.tsx")}";\nexport const revalidate = 300;\nexport default function BlogPage() {\n  return <SeoBlogIndex title="Блог" />;\n}\n`,
+      `import { SeoBlogIndex } from "${blogFor("blog/page.tsx")}";\nexport const dynamic = "force-static";\nexport default function BlogPage() {\n  return <SeoBlogIndex title="Блог" />;\n}\n`,
     );
     // У сайта уже может быть app/blog/[иной-сегмент] — Next не даёт два разных динамических имени
     // на один путь. Тогда наш /blog/[slug] не создаём (иначе билд упадёт), а печатаем ручную инструкцию.
@@ -426,11 +426,11 @@ async function init() {
     } else {
       madeArticle = await ensureFile(
         path.join(root, appDir, `blog/[slug]/page.${jsxExt}`),
-        `import { notFound } from "next/navigation";\nimport { seoBlogPost, SeoBlogArticle } from "${blogFor("blog/[slug]/page.tsx")}";\nexport const revalidate = 300;\n\nexport async function generateMetadata(${mdParam}) {\n  const post = await seoBlogPost(params.slug);\n  if (!post) return {};\n  return { title: post.title, description: post.excerpt, openGraph: { images: post.cover ? [post.cover] : [] } };\n}\n\nexport default async function BlogPostPage(${mdParam}) {\n  const post = await seoBlogPost(params.slug);\n  if (!post) notFound();\n  return <SeoBlogArticle post={post} />;\n}\n`,
+        `import { notFound } from "next/navigation";\nimport { seoBlogPost, seoBlogStaticParams, SeoBlogArticle } from "${blogFor("blog/[slug]/page.tsx")}";\nexport const dynamic = "force-static";\nexport const dynamicParams = false;\n\n// Полностью статический рендер: все статьи пре-рендерятся на сборке из файлов content/blog. Контент\n// меняется git-коммитом → редеплой. dynamicParams=false: неизвестный слаг → 404 (без рантайм-чтения).\nexport async function generateStaticParams() {\n  return seoBlogStaticParams();\n}\n\nexport async function generateMetadata(${mdParam}) {\n  const post = await seoBlogPost(params.slug);\n  if (!post) return {};\n  return { title: post.title, description: post.excerpt, openGraph: { images: post.cover ? [post.cover] : [] } };\n}\n\nexport default async function BlogPostPage(${mdParam}) {\n  const post = await seoBlogPost(params.slug);\n  if (!post) notFound();\n  return <SeoBlogArticle post={post} />;\n}\n`,
       );
     }
     if (madeIndex || madeArticle) {
-      log(`\n  \x1b[32m✓\x1b[0m Блог: роуты /blog (пакет-рендер) созданы. Настрой доставку + anon-ключ на платформе. (Отключить блог: \x1b[1m--no-blog\x1b[0m)`);
+      log(`\n  \x1b[32m✓\x1b[0m Блог: роуты /blog (статический рендер из файлов content/blog) созданы. Включи git-доставку блога на платформе. (Отключить блог: \x1b[1m--no-blog\x1b[0m)`);
     } else {
       log(`\n  \x1b[33mℹ\x1b[0m Блог: у сайта уже есть роуты /blog — не трогаю.`);
     }
@@ -691,16 +691,17 @@ async function blogPage() {
     blogDynConflict = names.some((n) => /^\[.*\]$/.test(n) && n !== "[slug]");
   }
 
-  // index-роут (список): в [locale] прокидываем locale + basePath; ?show= → пагинация по 20.
-  const idxSig = ext === "ts"
-    ? (param ? `{ params, searchParams }: { params: { ${param}: string }; searchParams: { show?: string } }` : `{ searchParams }: { searchParams: { show?: string } }`)
-    : (param ? "{ params, searchParams }" : "{ searchParams }");
+  // index-роут (список): в [locale] прокидываем locale + basePath. СТАТИЧЕСКИЙ (Фаза 1 git-native):
+  // без searchParams (иначе роут стал бы динамическим и в рантайме Vercel не увидел бы файлы content/blog).
+  const idxSig = param
+    ? (ext === "ts" ? `{ params }: { params: { ${param}: string } }` : "{ params }")
+    : "";
   const idxBody = param
-    ? `<SeoBlogIndex locale={params.${param}} basePath={\`/\${params.${param}}/blog\`} show={Number(searchParams?.show) || 20} />`
-    : `<SeoBlogIndex show={Number(searchParams?.show) || 20} />`;
+    ? `<SeoBlogIndex locale={params.${param}} basePath={\`/\${params.${param}}/blog\`} />`
+    : `<SeoBlogIndex />`;
   await writeOurRoute(
     path.join(root, appDir, under, `blog/page.${jsxExt}`),
-    `import { SeoBlogIndex } from "${blogFor(`${under}blog/page.tsx`)}";\nexport const revalidate = 300;\nexport default function BlogPage(${idxSig}) {\n  return ${idxBody};\n}\n`,
+    `import { SeoBlogIndex } from "${blogFor(`${under}blog/page.tsx`)}";\nexport const dynamic = "force-static";\nexport default function BlogPage(${idxSig}) {\n  return ${idxBody};\n}\n`,
   );
 
   if (blogDynConflict) {
@@ -713,11 +714,11 @@ async function blogPage() {
     const localeProp = param ? ` locale={params.${param}}` : "";
     await writeOurRoute(
       path.join(root, appDir, under, `blog/[slug]/page.${jsxExt}`),
-      `import { notFound } from "next/navigation";\nimport { seoBlogPost, SeoBlogArticle } from "${blogFor(`${under}blog/[slug]/page.tsx`)}";\nexport const revalidate = 300;\n\nexport async function generateMetadata(${artSig}) {\n  const post = await seoBlogPost(params.slug${localeArg});\n  if (!post) return {};\n  return { title: post.title, description: post.excerpt, openGraph: { images: post.cover ? [post.cover] : [] } };\n}\n\nexport default async function BlogPostPage(${artSig}) {\n  const post = await seoBlogPost(params.slug${localeArg});\n  if (!post) notFound();\n  return <SeoBlogArticle post={post}${localeProp} />;\n}\n`,
+      `import { notFound } from "next/navigation";\nimport { seoBlogPost, seoBlogStaticParams, SeoBlogArticle } from "${blogFor(`${under}blog/[slug]/page.tsx`)}";\nexport const dynamic = "force-static";\nexport const dynamicParams = false;\n\n// Полностью статический рендер: все статьи пре-рендерятся на сборке из файлов content/blog. Контент\n// меняется git-коммитом → редеплой. dynamicParams=false: неизвестный слаг → 404 (без рантайм-чтения).\nexport async function generateStaticParams() {\n  return seoBlogStaticParams();\n}\n\nexport async function generateMetadata(${artSig}) {\n  const post = await seoBlogPost(params.slug${localeArg});\n  if (!post) return {};\n  return { title: post.title, description: post.excerpt, openGraph: { images: post.cover ? [post.cover] : [] } };\n}\n\nexport default async function BlogPostPage(${artSig}) {\n  const post = await seoBlogPost(params.slug${localeArg});\n  if (!post) notFound();\n  return <SeoBlogArticle post={post}${localeProp} />;\n}\n`,
     );
   }
 
-  log(`\n  \x1b[32m✓\x1b[0m Готово. Проверь \x1b[36mgit diff\x1b[0m, затем commit + push. Блог: \x1b[1m${localeDir ? `/${param}/blog` : "/blog"}\x1b[0m — дизайн/шапка с сайта, список 4-в-ряд + «Показать больше».\n`);
+  log(`\n  \x1b[32m✓\x1b[0m Готово. Проверь \x1b[36mgit diff\x1b[0m, затем commit + push. Блог: \x1b[1m${localeDir ? `/${param}/blog` : "/blog"}\x1b[0m — дизайн/шапка с сайта, список 4-в-ряд, статический рендер из файлов.\n`);
 }
 
 if (cmd === "init") {

package/blog-fs.ts

@@ -0,0 +1,164 @@
+// Файловый источник блога (Фаза 4 blogfs): читает статьи из репозитория сайта (папка content/blog,
+// формат blogfs v1 — см. docs/blog-git-delivery/FORMAT.md) на СБОРКЕ, без сети и без Supabase.
+// Отдаёт те же формы, что и supabase-источник (SeoBlogSummary / SeoBlogPostFull) — blog.tsx роутит.
+// FAIL-SAFE: любая ошибка/битый файл → пропуск, сборка НИКОГДА не падает.
+import { readdirSync, readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { sanitizeDeliveryHtml } from "./sanitize";
+import type { SeoBlogSummary, SeoBlogPostFull, SeoBlogTheme } from "./blog";
+
+const BLOG_DIR = process.env.SEOAGENT_BLOG_DIR ?? "content/blog";
+const SUPPORTED_MAJOR = 1; // schema "seoagent.blog/v1"
+
+function root(): string {
+  return join(process.cwd(), BLOG_DIR);
+}
+
+interface LocaleEntry { title?: string; excerpt?: string | null; metaTitle?: string | null; body?: string }
+interface Meta {
+  schema?: string; slug?: string; status?: string; defaultLocale?: string; bodyFormat?: string;
+  coverImage?: string; publishedAt?: string | null; locales?: Record<string, LocaleEntry>; features?: string[];
+}
+// Возможности формата, которые НЕ меняют рендер тела (ридер v1 их спокойно поддерживает). Любую иную
+// запись в features[] версия-пиннутый ридер трактует как «не умею» → пропуск статьи (forward-compat).
+// source = лишь игнорируемый .tiptap.json сайдкар; local-assets = картинки лежат в public/ и уже
+// указаны в теле локальным URL — ридеру ничего делать не нужно (тоже body-нейтрально).
+const KNOWN_FEATURES = new Set(["source", "local-assets"]);
+
+// Мажор схемы из строки "seoagent.blog/vN" (или число). null — не наш формат.
+function schemaMajor(schema: unknown): number | null {
+  if (typeof schema === "number") return schema;
+  if (typeof schema === "string") { const m = schema.match(/\/v(\d+)$/); if (m) return parseInt(m[1], 10); }
+  return null;
+}
+
+function readDescriptor(): { defaultLocale?: string; locales?: string[]; schema?: string; urlPrefix?: string; theme?: SeoBlogTheme } | null {
+  try { return JSON.parse(readFileSync(join(root(), ".blogfs.json"), "utf8")); } catch { return null; }
+}
+
+// Тема оформления блога из дескриптора (git-режим, Фаза 3): ридер применяет её в --sa-* БЕЗ config-API.
+// Валиден только объект с строковым accent (иначе игнор → дефолтные --sa-*).
+export function fsTheme(): SeoBlogTheme | undefined {
+  const t = readDescriptor()?.theme;
+  return t && typeof t === "object" && typeof t.accent === "string" && t.accent ? t : undefined;
+}
+
+// Канонический префикс публичных URL блога. Приоритет — явный descriptor.urlPrefix (пишет платформа);
+// фолбэк для старых дескрипторов без него: <2 локалей → "" (одноязычный /blog), иначе "/<defaultLocale>".
+function urlPrefix(): string {
+  const d = readDescriptor();
+  if (!d) return "";
+  if (typeof d.urlPrefix === "string") return d.urlPrefix.replace(/\/+$/, "");
+  const locales = Array.isArray(d.locales) ? d.locales.map((l) => String(l).trim()).filter(Boolean) : [];
+  if (locales.length < 2) return "";
+  const dflt = (typeof d.defaultLocale === "string" && d.defaultLocale.trim()) || locales[0];
+  return dflt ? `/${dflt}` : "";
+}
+
+// Есть ли файловый блог в репо (наличие .blogfs.json = git-сайт с ≥1 доставкой). Сигнал авто-детекта.
+export function fsAvailable(): boolean {
+  return readDescriptor() !== null;
+}
+
+export function fsDefaultLocale(): string {
+  const d = readDescriptor()?.defaultLocale;
+  return typeof d === "string" ? d : ""; // битый дескриптор мог дать не-строку → не роняем split ниже
+}
+
+// Собрать meta.json всех статей (glob по папкам). Пропускает битые/незнакомые версии/черновики.
+function listMetas(): { dir: string; meta: Meta }[] {
+  const r = root();
+  let names: string[];
+  try { names = readdirSync(r, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name); }
+  catch { return []; }
+  const out: { dir: string; meta: Meta }[] = [];
+  for (const name of names) {
+    if (name.startsWith(".") || name.startsWith("_")) continue; // служебные (assets и т.п.)
+    let meta: Meta;
+    try { meta = JSON.parse(readFileSync(join(r, name, "meta.json"), "utf8")); }
+    catch { continue; } // нет meta.json / битый JSON → пропуск (не роняем сборку)
+    // Валидный JSON может быть null/массивом/примитивом — доступ к полям тогда бросит. Пропускаем.
+    if (!meta || typeof meta !== "object" || Array.isArray(meta)) continue;
+    const major = schemaMajor(meta.schema);
+    if (major === null || major > SUPPORTED_MAJOR) { // незнакомая/будущая версия → пропуск с предупреждением
+      try { console.warn(`[seoagent blogfs] пропуск ${name}: несовместимая версия схемы (${String(meta.schema)})`); } catch { /* noop */ }
+      continue;
+    }
+    // Незнакомая body-возможность (mdx/frontmatter/…) в том же мажоре → ридер её не умеет → пропуск.
+    if (Array.isArray(meta.features) && meta.features.some((f) => !KNOWN_FEATURES.has(f))) {
+      try { console.warn(`[seoagent blogfs] пропуск ${name}: неподдерживаемая возможность (${meta.features.join(",")})`); } catch { /* noop */ }
+      continue;
+    }
+    if (meta.status !== "published" || !meta.slug || !meta.locales) continue;
+    out.push({ dir: name, meta });
+  }
+  return out;
+}
+
+// Запись локали: точная → без региона (en-US→en) → defaultLocale → первая доступная.
+function pickLocale(meta: Meta, locale: string): LocaleEntry {
+  const locs = meta.locales ?? {};
+  const loc = typeof locale === "string" ? locale : ""; // на всякий случай — locale мог прийти не строкой
+  const base = loc ? loc.split("-")[0] : "";
+  return locs[loc] || (base && locs[base]) || (meta.defaultLocale ? locs[meta.defaultLocale] : undefined) || locs[Object.keys(locs)[0]] || {};
+}
+
+function summary(meta: Meta, locale: string): SeoBlogSummary {
+  const e = pickLocale(meta, locale);
+  return {
+    slug: meta.slug ?? "",
+    title: e.title ?? "",
+    excerpt: e.excerpt ?? "",
+    cover: meta.coverImage ?? null,
+    date: meta.publishedAt ?? null,
+  };
+}
+
+// Список статей для локали, по publishedAt убыв., до limit.
+export function fsBlogList(locale: string, limit: number): SeoBlogSummary[] {
+  const rows = listMetas().map(({ meta }) => summary(meta, locale)).filter((p) => p.slug && p.title);
+  rows.sort((a, b) => (b.date ?? "").localeCompare(a.date ?? "")); // publishedAt desc (ISO — код-юнит ок)
+  return rows.slice(0, Math.max(0, limit));
+}
+
+// Одна статья по slug (ищем по meta.slug — папка может быть по id при pathStrategy=id).
+export function fsBlogPost(slug: string, locale: string): SeoBlogPostFull | null {
+  const hit = listMetas().find((x) => x.meta.slug === slug);
+  if (!hit) return null;
+  const e = pickLocale(hit.meta, locale);
+  let bodyRaw = "";
+  // Имя файла тела берётся из meta.json репо — только безопасное имя (без "/" и ".."), защита от traversal.
+  if (e.body && /^[A-Za-z0-9._-]+$/.test(e.body)) { try { bodyRaw = readFileSync(join(root(), hit.dir, e.body), "utf8"); } catch { bodyRaw = ""; } }
+  const s = summary(hit.meta, locale);
+  return {
+    ...s,
+    // Тело уже санитайзено при доставке; чистим повторно (защита-в-глубину). bodyFormat="mdx" появится позже.
+    bodyHtml: sanitizeDeliveryHtml(bodyRaw),
+    theme: fsTheme(), // тема из .blogfs.json (Фаза 3) — фирменные цвета блога без запроса к платформе
+  };
+}
+
+// Есть ли вообще папка блога (для мягких проверок).
+export function fsDirExists(): boolean {
+  try { return existsSync(root()); } catch { return false; }
+}
+
+// Записи блога для sitemap (Фаза 2): страница списка + канонический URL каждой статьи, на СБОРКЕ из файлов.
+// loc = origin + urlPrefix + "/blog[/<slug>]"; lastmod = meta.publishedAt (ISO), если есть. Одна каноническая
+// ссылка на статью (префикс дефолтной локали) — как платформа пингует IndexNow; локали-альтернативы позже (hreflang).
+// Fail-safe: любая ошибка → []. origin — https://домен (без хвостового слэша), берётся из карты сайта.
+export function fsBlogSitemapEntries(origin: string): { loc: string; lastmod?: string }[] {
+  try {
+    const base = (origin || "").replace(/\/+$/, "");
+    const pref = urlPrefix();
+    const metas = listMetas();
+    if (!metas.length) return [];
+    const out: { loc: string; lastmod?: string }[] = [{ loc: `${base}${pref}/blog` }];
+    for (const { meta } of metas) {
+      if (!meta.slug) continue;
+      const lm = typeof meta.publishedAt === "string" && meta.publishedAt ? meta.publishedAt : undefined;
+      out.push({ loc: `${base}${pref}/blog/${meta.slug}`, lastmod: lm });
+    }
+    return out;
+  } catch { return []; }
+}

package/blog.tsx

@@ -1,235 +1,49 @@
-// @webnumseoagent/next/blog — рендер блога код-сайта (Фаза 3.1c).
-// Пакет тянет ПУБЛИЧНЫЙ конфиг блога с платформы (config-API /blog: supabaseUrl + anonKey +
-// таблица/формат/локали/маппинг), затем читает ОПУБЛИКОВАННЫЕ статьи прямо из Supabase клиента
-// (anon-ключ + public-read RLS) и рендерит обложку + заголовок + тело (картинки/таблицы/ссылки).
+// @webnumseoagent/next/blog — рендер блога код-сайта из ФАЙЛОВ репозитория (git-native, blogfs v1).
+// Статьи лежат в content/blog (формат blogfs — см. docs/blog-git-delivery/FORMAT.md). Ридер blog-fs.ts
+// читает их на СБОРКЕ через node:fs, БЕЗ сети и БЕЗ Supabase. Тема оформления — из .blogfs.json.
 //
-// Тело статьи уже САНИТАЙЗЕНО на стороне платформы при доставке (Фаза 3.1b), поэтому здесь оно
-// рендерится как HTML (dangerouslySetInnerHTML) — граница доверия проходит по доставке, не по рендеру.
+// Тело статьи уже САНИТАЙЗЕНО платформой при доставке, поэтому рендерится как HTML (dangerouslySetInnerHTML) —
+// граница доверия проходит по доставке, не по рендеру. Ридер санитайзит повторно (защита-в-глубину).
 //
-// Все функции FAIL-SAFE: при ошибке/таймауте возвращают пусто — блог просто не покажет контент,
+// Все функции FAIL-SAFE: при ошибке/отсутствии файлов возвращают пусто — блог не покажет контент,
 // сборка/рендер сайта НИКОГДА не падает.
 //
-// Использование (роуты ставит `npx @webnumseoagent/next init --blog`):
-//   app/blog/page.tsx:            export default () => <SeoBlogIndex title="Блог" />
-//   app/blog/[slug]/page.tsx:     const post = await seoBlogPost(params.slug); if(!post) notFound();
-//                                 return <SeoBlogArticle post={post} />
+// Роуты ставит `npx @webnumseoagent/next blog` (или init): статический рендер (dynamic="force-static").
+//   app/[locale]/blog/page.tsx:        <SeoBlogIndex locale={params.locale} basePath={`/${params.locale}/blog`} />
+//   app/[locale]/blog/[slug]/page.tsx: const post = await seoBlogPost(params.slug); if(!post) notFound(); <SeoBlogArticle post={post} />
 
 import type { CSSProperties } from "react";
 
-const API = process.env.SEOAGENT_API_BASE ?? "";
-const SITE = process.env.SEOAGENT_SITE_ID ?? "";
-const TOKEN = process.env.SEOAGENT_TOKEN ?? "";
-const REVALIDATE = 300;
+// Файловый ридер (node:fs) грузим лениво — только когда блог реально рендерится (на сборке).
+const blogfs = () => import("./blog-fs");
 
-export interface SeoBlogMapping {
-  title: string; excerpt?: string; body: string;
-  id?: string; image?: string; published?: string; publishedAt?: string;
-}
-// Тема блога от платформы (config-API): цвета/скругления как ВАЛИДНЫЕ CSS-значения, которые пакет
-// кладёт в свои переменные --sa-*. Сейчас платформа шлёт только accent (бренд-цвет владельца);
-// border/surface/muted/radius зарезервированы под будущий ИИ-профиль дизайна сайта.
+// Тема блога: цвета/скругления как ВАЛИДНЫЕ CSS-значения → пакет кладёт их в свои --sa-*. Приходит из
+// .blogfs.json (платформа пишет бренд-цвет владельца в accent + опц. токены оформления сайта).
 export interface SeoBlogTheme { accent?: string; border?: string; muted?: string; surface?: string; thBg?: string; radius?: string }
-export interface SeoBlogConfig {
-  supabaseUrl: string; anonKey: string; table: string;
-  format: "html" | "minimarkup"; locales: string[]; mapping: SeoBlogMapping; theme?: SeoBlogTheme;
-}
 export interface SeoBlogSummary { slug: string; title: string; excerpt: string; cover: string | null; date: string | null }
 export interface SeoBlogPostFull extends SeoBlogSummary { bodyHtml: string; theme?: SeoBlogTheme }
 
-function firstLocale(cfg: SeoBlogConfig): string {
-  return (cfg.locales ?? []).filter(Boolean)[0] ?? "";
-}
-
-// Публичный конфиг блога с платформы (кэш ISR + тег seo-<site> — сбрасывается ревалидацией).
-async function fetchBlogConfig(): Promise<SeoBlogConfig | null> {
-  if (!API || !SITE || !TOKEN) return null;
-  try {
-    const r = await fetch(`${API}/api/seo/${SITE}/blog`, {
-      headers: { "x-seo-agent-key": TOKEN },
-      next: { revalidate: REVALIDATE, tags: [`seo-${SITE}`, `seo-blog-${SITE}`] },
-      signal: AbortSignal.timeout(5000),
-    });
-    if (!r.ok) return null;
-    const d = (await r.json()) as { blog?: SeoBlogConfig | null };
-    const b = d?.blog ?? null;
-    if (!b?.supabaseUrl || !b?.anonKey || !b?.table || !b?.mapping?.title || !b?.mapping?.body) return null;
-    return b;
-  } catch {
-    return null;
-  }
-}
-
-// Запрос к REST API Supabase клиента (anon). Возвращает массив строк либо null.
-async function supaGet(cfg: SeoBlogConfig, url: string): Promise<Record<string, unknown>[] | null> {
-  try {
-    const r = await fetch(url, {
-      headers: { apikey: cfg.anonKey, Authorization: `Bearer ${cfg.anonKey}` },
-      next: { revalidate: REVALIDATE, tags: [`seo-blog-${SITE}`] },
-      signal: AbortSignal.timeout(6000),
-    });
-    if (!r.ok) return null;
-    const d = await r.json();
-    return Array.isArray(d) ? d : null;
-  } catch {
-    return null;
-  }
-}
-
-const S = (v: unknown): string => (v == null ? "" : String(v));
-const base = (cfg: SeoBlogConfig): string => cfg.supabaseUrl.replace(/\/+$/, "");
-
-async function fetchPosts(cfg: SeoBlogConfig, locale: string, limit: number): Promise<SeoBlogSummary[]> {
-  const m = cfg.mapping;
-  if (!m.id) return []; // без колонки id/slug ссылки на статьи не построить
-  const buildUrl = (suf: string) => {
-    const titleCol = m.title + suf;
-    const excerptCol = m.excerpt ? m.excerpt + suf : "";
-    const cols = [m.id, titleCol, excerptCol, m.image || "", m.publishedAt || ""].filter(Boolean).join(",");
-    let url = `${base(cfg)}/rest/v1/${encodeURIComponent(cfg.table)}?select=${cols}`;
-    if (m.published) url += `&${m.published}=eq.true`;
-    if (m.publishedAt) url += `&order=${m.publishedAt}.desc`;
-    url += `&limit=${limit}`;
-    return { url, titleCol, excerptCol };
-  };
-  const suf = locale ? `_${locale}` : "";
-  let q = buildUrl(suf);
-  let rows = await supaGet(cfg, q.url);
-  // Запрошенной локали нет среди колонок доставки (напр. языки блога не совпали с локалями сайта) →
-  // PostgREST вернул 400 (supaGet=null). Откатываемся на базовые колонки (оригинал), а не показываем пусто.
-  if (rows === null && suf) { q = buildUrl(""); rows = await supaGet(cfg, q.url); }
-  return (rows ?? [])
-    .map((r) => ({
-      slug: S(r[m.id!]),
-      title: S(r[q.titleCol]),
-      excerpt: q.excerptCol ? S(r[q.excerptCol]) : "",
-      cover: m.image ? (r[m.image] as string | null) ?? null : null,
-      date: m.publishedAt ? (r[m.publishedAt] as string | null) ?? null : null,
-    }))
-    .filter((p) => p.slug && p.title);
-}
-
-async function fetchPost(cfg: SeoBlogConfig, slug: string, locale: string): Promise<SeoBlogPostFull | null> {
-  const m = cfg.mapping;
-  if (!m.id) return null;
-  const suf = locale ? `_${locale}` : "";
-  let url = `${base(cfg)}/rest/v1/${encodeURIComponent(cfg.table)}?select=*&${m.id}=eq.${encodeURIComponent(slug)}`;
-  if (m.published) url += `&${m.published}=eq.true`;
-  url += `&limit=1`;
-  const rows = await supaGet(cfg, url);
-  const r = rows && rows[0];
-  if (!r) return null;
-  // Локаль-колонка пуста/отсутствует → берём базовую (оригинал). Так статья не выходит пустой, если
-  // перевода на запрошенную локаль нет (доставка тоже кладёт оригинал для непереведённых локалей).
-  const val = (colBase: string) => (suf ? S(r[colBase + suf]) : "") || S(r[colBase]);
-  const rawBody = val(m.body);
-  return {
-    slug: S(r[m.id]) || slug,
-    title: val(m.title),
-    excerpt: m.excerpt ? val(m.excerpt) : "",
-    cover: m.image ? (r[m.image] as string | null) ?? null : null,
-    date: m.publishedAt ? (r[m.publishedAt] as string | null) ?? null : null,
-    bodyHtml: cfg.format === "minimarkup" ? miniMarkupToHtml(rawBody) : sanitizeDeliveryHtml(rawBody),
-    theme: cfg.theme, // тему тащим с постом — чтобы SeoBlogArticle применил её без отдельного запроса
-  };
-}
-
-// ── Публичные data-функции (для generateMetadata / generateStaticParams) ──
+// ── Публичные data-функции (для generateMetadata / generateStaticParams) — читают файлы content/blog. ──
 export async function seoBlogList(opts?: { locale?: string; limit?: number }): Promise<SeoBlogSummary[]> {
-  const cfg = await fetchBlogConfig();
-  if (!cfg) return [];
-  return fetchPosts(cfg, opts?.locale ?? firstLocale(cfg), opts?.limit ?? 100);
+  const m = await blogfs();
+  return m.fsBlogList(opts?.locale ?? m.fsDefaultLocale(), opts?.limit ?? 1000);
 }
 export async function seoBlogPost(slug: string, opts?: { locale?: string }): Promise<SeoBlogPostFull | null> {
-  const cfg = await fetchBlogConfig();
-  if (!cfg) return null;
-  return fetchPost(cfg, slug, opts?.locale ?? firstLocale(cfg));
-}
-
-// ── Мини-разметка (## / - / **) → HTML (для legacy-формата; текст экранируем). ──
-function esc(s: string): string {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-function inlineMini(s: string): string {
-  return esc(s).replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
-}
-function miniMarkupToHtml(src: string): string {
-  const out: string[] = [];
-  for (const block of (src || "").split(/\n{2,}/)) {
-    const b = block.trim();
-    if (!b) continue;
-    const lines = b.split("\n");
-    if (lines.every((l) => l.startsWith("- "))) {
-      out.push("<ul>" + lines.map((l) => `<li>${inlineMini(l.slice(2))}</li>`).join("") + "</ul>");
-    } else if (b.startsWith("## ")) {
-      out.push(`<h2>${inlineMini(b.slice(3))}</h2>`);
-    } else {
-      out.push(`<p>${inlineMini(b)}</p>`);
-    }
-  }
-  return out.join("");
+  const m = await blogfs();
+  return m.fsBlogPost(slug, opts?.locale ?? m.fsDefaultLocale());
 }
 
-// ── Санитайзер HTML (защита-в-глубину перед dangerouslySetInnerHTML) — ЗЕРКАЛО доставки
-// (src/lib/blog/blog-delivery.ts + Edge blog-autopilot). Тело уже санитайзено при доставке, но
-// если у сайта не настроен RLS (провиженинг опционален) — это последний рубеж. ──
-const SANITIZE_ALLOWED_TAGS = new Set([
-  "h1", "h2", "h3", "h4", "h5", "h6", "p", "br", "hr", "strong", "b", "em", "i", "u", "s",
-  "ul", "ol", "li", "blockquote", "a", "img", "figure", "figcaption",
-  "table", "thead", "tbody", "tfoot", "tr", "th", "td", "caption", "code", "pre", "span", "div",
-]);
-const SANITIZE_ALLOWED_ATTRS = /^(href|src|alt|title|target|rel|width|height|loading|colspan|rowspan|scope|start|type)$/;
-const SANITIZE_VOID = new Set(["br", "hr", "img"]);
-function decodeSchemeEntities(v: string): string {
-  return v
-    .replace(/&#x([0-9a-fA-F]+);?/g, (_m, h) => { try { return String.fromCodePoint(parseInt(h, 16)); } catch { return ""; } })
-    .replace(/&#(\d+);?/g, (_m, d) => { try { return String.fromCodePoint(parseInt(d, 10)); } catch { return ""; } })
-    .replace(/&(colon|tab|newline|lf|cr|sol|amp);?/gi, (m) => {
-      const k = m.replace(/[&;]/g, "").toLowerCase();
-      return ({ colon: ":", sol: "/", amp: "&", tab: " ", newline: " ", lf: " ", cr: " " } as Record<string, string>)[k] ?? " ";
-    });
-}
-function safeUrl(val: string): boolean {
-  const v = decodeSchemeEntities(val).toLowerCase().replace(/\s/g, "");
-  if (!/^[a-z][a-z0-9+.-]*:/.test(v)) return true;
-  return /^(https?:|mailto:|tel:)/.test(v);
-}
-function sanitizeAttrs(tag: string, attrsRaw: string): string {
-  const out: string[] = [];
-  const re = /([a-zA-Z_:][-a-zA-Z0-9_:.]*)\s*=\s*("([^"]*)"|'([^']*)'|([^\s"'>]+))/g;
-  let m: RegExpExecArray | null;
-  let href = "";
-  while ((m = re.exec(attrsRaw))) {
-    const name = m[1].toLowerCase();
-    const val = m[3] ?? m[4] ?? m[5] ?? "";
-    if (name.startsWith("on") || name === "style" || name === "srcset") continue;
-    if ((name === "href" || name === "src") && !safeUrl(val)) continue;
-    if (!SANITIZE_ALLOWED_ATTRS.test(name)) continue;
-    if (name === "href") href = val;
-    out.push(`${name}="${val.replace(/"/g, "&quot;")}"`);
-  }
-  if (tag === "a" && !out.some((a) => a.startsWith("rel="))) {
-    if (/^(https?:)?\/\//i.test(href.trim())) out.push('rel="noopener nofollow"');
-  }
-  return out.length ? " " + out.join(" ") : "";
-}
-function sanitizeDeliveryHtml(html: string): string {
-  let s = html || "";
-  s = s.replace(/<(script|style|iframe|object|embed|form|noscript|template|svg|math)\b[\s\S]*?<\/\1\s*>/gi, "");
-  s = s.replace(/<!--[\s\S]*?-->/g, "");
-  s = s.replace(/<(\/?)([a-zA-Z][a-zA-Z0-9]*)\b((?:"[^"]*"|'[^']*'|[^>])*)>/g, (_full, slash, tag, attrs) => {
-    const t = tag.toLowerCase();
-    if (!SANITIZE_ALLOWED_TAGS.has(t)) return "";
-    if (slash) return `</${t}>`;
-    return `<${t}${sanitizeAttrs(t, attrs)}${SANITIZE_VOID.has(t) ? " /" : ""}>`;
-  });
-  return s.trim();
+// Параметры для generateStaticParams роута /blog/[slug]: пре-рендер ВСЕХ статей на сборке (SSG из файлов).
+export async function seoBlogStaticParams(opts?: { locale?: string }): Promise<{ slug: string }[]> {
+  const list = await seoBlogList({ locale: opts?.locale, limit: 100000 });
+  return list.map((p) => ({ slug: p.slug }));
 }
 
 // ── Компоненты (серверные) ──────────────────────────────────────────────────────────────────
 // Цвета/рамки/скругления — через СОБСТВЕННЫЕ переменные пакета (--sa-*) с нейтральным дефолтом.
 // НЕ ссылаемся на токены сайта напрямую: shadcn/Tailwind хранят их как сырые HSL-компоненты
 // (--primary: 222 47% 11%), в color/border это невалидно и ломает вид. Реальные цвета сайта
-// проставит платформа: config-API отдаст профиль, а хост-обёртка выставит --sa-* валидными цветами.
+// проставит платформа: .blogfs.json несёт тему, а хост-обёртка выставит --sa-* валидными цветами.
 // Шрифт и базовый цвет текста наследуются от layout сайта (color:inherit, без font-family).
 const BODY_CSS = `.seoagent-blog-body{color:inherit}
 .seoagent-blog-body img{max-width:100%;height:auto;border-radius:var(--sa-radius,8px);margin:1rem 0}
@@ -278,47 +92,38 @@ const GRID_CSS = `.sa-blog-wrap{max-width:1120px;margin:0 auto;padding:var(--sa-
 .sa-blog-empty{color:var(--sa-muted,#64748b)}`;
 
 const BLOG_TITLE: Record<string, string> = { ru: "Блог", uz: "Blog", en: "Blog", ar: "المدونة", tr: "Blog" };
-const MORE_LABEL: Record<string, string> = { ru: "Показать больше", uz: "Ko‘proq ko‘rsatish", en: "Show more", ar: "عرض المزيد" };
 const EMPTY_LABEL: Record<string, string> = { ru: "Пока нет статей.", uz: "Hozircha maqolalar yo‘q.", en: "No posts yet.", ar: "لا توجد مقالات بعد." };
 const L = (map: Record<string, string>, locale: string, fb: string) => map[locale] || map[locale?.split("-")[0]] || fb;
 
-// Список статей блога: H1 + карточки (по 4 в ряд на десктопе) + «Показать больше» (пагинация по 20
-// через ?show=, серверно — без клиентского JS, дружелюбно к SEO). Всегда рендерит H1 (даже пустой блог),
-// чтобы страница не была пустой. perPage — размер «страницы» (дефолт 20), show — сколько показать сейчас.
-export async function SeoBlogIndex(props: { locale?: string; basePath?: string; title?: string; show?: number; perPage?: number }) {
-  const cfg = await fetchBlogConfig();
-  const locale = props.locale ?? (cfg ? firstLocale(cfg) : "");
+// Список статей блога: H1 + карточки (по 4 в ряд на десктопе). Всегда рендерит H1 (даже пустой блог).
+// СТАТИЧЕСКИЙ (git-native): НЕ читает searchParams — иначе роут стал бы динамическим, а в рантайме Vercel
+// файлов content/blog в лямбде нет → список был бы пуст. Читаем ВСЕ статьи на сборке; контент меняется
+// git-коммитом → редеплой пересобирает страницу. limit — предохранитель (дефолт 1000).
+// show/perPage приняты для обратной совместимости со старым скаффолдом (?show=), но ИГНОРИРУЮТСЯ.
+export async function SeoBlogIndex(props: { locale?: string; basePath?: string; title?: string; limit?: number; show?: number; perPage?: number }) {
+  const m = await blogfs();
+  const locale = props.locale ?? m.fsDefaultLocale();
   const title = props.title ?? L(BLOG_TITLE, locale, "Blog");
-  const per = Math.max(1, Math.floor(props.perPage ?? 20));
-  const show = Math.max(per, Math.floor(Number(props.show) || per));
   const basePath = (props.basePath ?? "/blog").replace(/\/+$/, "");
-  // Тянем show+1, чтобы понять, есть ли ещё (для кнопки «Показать больше»).
-  const posts = cfg ? await fetchPosts(cfg, locale, show + 1) : [];
-  const hasMore = posts.length > show;
-  const visible = posts.slice(0, show);
+  const limit = Math.max(1, Math.floor(props.limit ?? 1000));
+  const posts = m.fsBlogList(locale, limit);
+  const theme = m.fsTheme(); // тема из .blogfs.json
   return (
-    <div className="sa-blog-wrap" style={themeStyle(cfg?.theme) as CSSProperties}>
+    <div className="sa-blog-wrap" style={themeStyle(theme) as CSSProperties}>
       <style dangerouslySetInnerHTML={{ __html: GRID_CSS }} />
       <h1 className="sa-blog-h1">{title}</h1>
-      {visible.length ? (
-        <>
-          <div className="sa-blog-grid">
-            {visible.map((p) => (
-              <a key={p.slug} className="sa-blog-card" href={`${basePath}/${p.slug}`}>
-                {p.cover ? <img src={p.cover} alt={p.title} loading="lazy" /> : null}
-                <div className="sa-cb">
-                  <h2>{p.title}</h2>
-                  {p.excerpt ? <p>{p.excerpt}</p> : null}
-                </div>
-              </a>
-            ))}
-          </div>
-          {hasMore ? (
-            <div className="sa-blog-more">
-              <a href={`${basePath}?show=${show + per}`} rel="nofollow">{L(MORE_LABEL, locale, "Show more")}</a>
-            </div>
-          ) : null}
-        </>
+      {posts.length ? (
+        <div className="sa-blog-grid">
+          {posts.map((p) => (
+            <a key={p.slug} className="sa-blog-card" href={`${basePath}/${p.slug}`}>
+              {p.cover ? <img src={p.cover} alt={p.title} loading="lazy" /> : null}
+              <div className="sa-cb">
+                <h2>{p.title}</h2>
+                {p.excerpt ? <p>{p.excerpt}</p> : null}
+              </div>
+            </a>
+          ))}
+        </div>
       ) : (
         <p className="sa-blog-empty">{L(EMPTY_LABEL, locale, "No posts yet.")}</p>
       )}
@@ -334,7 +139,7 @@ export function SeoBlogArticle({ post, locale }: { post: SeoBlogPostFull; locale
       {post.cover ? <img src={post.cover} alt={post.title} style={{ width: "100%", borderRadius: "var(--sa-radius, 12px)", marginBottom: "1.5rem" }} /> : null}
       <h1 style={{ fontSize: "2.2rem", lineHeight: 1.2, margin: "0 0 1rem" }}>{post.title}</h1>
       {post.date ? <p style={{ color: "var(--sa-muted, #94a3b8)", margin: "0 0 1.5rem" }}>{fmtDate(post.date, locale)}</p> : null}
-      {/* Тело уже санитайзено при доставке (Фаза 3.1b) — рендерим как HTML. */}
+      {/* Тело уже санитайзено при доставке — рендерим как HTML. */}
       <div className="seoagent-blog-body" dangerouslySetInnerHTML={{ __html: post.bodyHtml }} />
     </article>
   );