@work-graph/cli 0.2.7 → 0.2.9

package/README.md

@@ -4,11 +4,13 @@ Install **Work Graph** in any project via npm. No engine clone, no manual `engin
 
 Work Graph is a local, Git-friendly work system for AI-assisted development. It stores work items as BVC files, keeps project intent close to the codebase, and opens a local backlog UI for operators and agents.
 
+Website: [workgraph.ru/en](https://workgraph.ru/en/)
+
 Use it when you want:
 
 - a project-local backlog without SaaS lock-in;
 - BVC work contracts that can be reviewed in Git;
-- Cursor MCP configuration generated for the project;
+- optional MCP client configuration for the project (Cursor by default);
 - a local UI for task status, evidence and project navigation;
 - repeatable setup through `npx`, not a copied engine repository.
 
@@ -45,8 +47,8 @@ Typical output:
 | `.work-graph/config.json` | Project id, label and UI settings |
 | `intent/` | BVC intent tree for work items |
 | `intent/index.bvc` | Index of work item files |
-| `.cursor/mcp.json` | Cursor MCP server entry for Work Graph |
-| `.cursor/rules/work-graph-project.mdc` | Project rule that tells agents to use Work Graph |
+| `.cursor/mcp.json` | Optional: MCP server entry when using Cursor |
+| `.cursor/rules/work-graph-project.mdc` | Optional: project rule for agents in Cursor |
 | `package.json` | `workgraph:*` scripts and devDependencies |
 
 After `npm install`, the project owns its Work Graph runtime through `node_modules/@work-graph/cli` and `node_modules/@work-graph/mcp`.
@@ -55,7 +57,7 @@ After `npm install`, the project owns its Work Graph runtime through `node_modul
 
 | Command | Description |
 |---------|-------------|
-| `init [path]` | Scaffold Work Graph into a project: BVC intent tree, config, npm scripts, MCP config and Cursor rule |
+| `init [path]` | Scaffold Work Graph into a project: BVC intent tree, config, npm scripts, optional MCP/rule files |
 | `ui [path]` | Start the local backlog UI for the project |
 | `doctor [path]` | Verify that project config, package dependencies and runtime resolution are healthy |
 | `register [path]` | Optional: register a project in the shared multiproject host |
@@ -116,7 +118,7 @@ The CLI installs the runtime and UI. The BVC format itself is published separate
 | Symptom | Fix |
 |---|---|
 | `work-graph doctor` says dependencies are missing | Run `npm install` in the target project |
-| Cursor does not see Work Graph MCP tools | Re-run `npx @work-graph/cli init .` without `--no-mcp`, then reload Cursor MCP servers |
+| Agent does not see Work Graph MCP tools | Re-run `npx @work-graph/cli init .` without `--no-mcp`, then reload MCP servers in your IDE |
 | UI port is already in use | Run `npx @work-graph/cli ui . --port 4178` |
 | Existing package scripts were not updated | Re-run without `--no-package` or add the `workgraph:*` scripts manually |
 | You are hacking Work Graph itself | Use `WORKGRAPH_ENGINE_ROOT=.` or `--engine` from the monorepo, not in normal projects |
@@ -132,6 +134,7 @@ See [CONTRIBUTING.md](https://github.com/bvc-lang/work-graph/blob/main/CONTRIBUT
 
 ## Links
 
+- Website: https://workgraph.ru/en/
 - CLI mirror: https://github.com/bvc-lang/work-graph-cli
 - Work Graph monorepo: https://github.com/bvc-lang/work-graph
 - BVC spec: https://github.com/bvc-lang/spec

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@work-graph/cli",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Work Graph CLI — install local agent work tracking, BVC work items and backlog UI in any project",
   "type": "module",
   "bin": {
@@ -22,7 +22,7 @@
     "type": "git",
     "url": "git+https://github.com/bvc-lang/work-graph-cli.git"
   },
-  "homepage": "https://github.com/bvc-lang/work-graph-cli#readme",
+  "homepage": "https://workgraph.ru/en/",
   "keywords": [
     "work-graph",
     "backlog",

package/vendor/packages/workgraph-mcp/README.md

@@ -2,9 +2,13 @@
 
 [MCP](https://modelcontextprotocol.io) server for Work Graph — list, create, and update work items in `intent/**/*.work.bvc`.
 
-## Cursor
+Website: [workgraph.ru/en](https://workgraph.ru/en/)
 
-After `npx @work-graph/cli init .`, `.cursor/mcp.json` includes:
+Works with any MCP-capable agent client (Cursor, Claude Desktop, Claude Code, and others).
+
+## After `work-graph init`
+
+`npx @work-graph/cli init .` writes `.cursor/mcp.json` when you use Cursor. The entry looks like:
 
 ```json
 {
@@ -21,7 +25,7 @@ After `npx @work-graph/cli init .`, `.cursor/mcp.json` includes:
 }
 ```
 
-Reload MCP in Cursor after init.
+Reload MCP in your IDE after init. For Claude Desktop / Claude Code and other clients, use the same command and env — see [workgraph-mcp-clients.md](https://github.com/bvc-lang/work-graph/blob/main/docs/workgraph-mcp-clients.md) in the monorepo.
 
 ## Standalone
 
@@ -44,3 +48,9 @@ Requires a project with `.work-graph/config.json` (run `npx @work-graph/cli init
 Resource: `workgraph://contract/{workId}`
 
 Recommended agent flow: `get_work_contract` → run checks → `validate_evidence` → `assert_task_ready_for_done` → `complete_work_item`.
+
+## Links
+
+- Website: https://workgraph.ru/en/
+- npm: https://www.npmjs.com/package/@work-graph/mcp
+- Monorepo: https://github.com/bvc-lang/work-graph

package/vendor/packages/workgraph-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@work-graph/mcp",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "MCP server for Work Graph — work items in intent/**/*.work.bvc",
   "type": "module",
   "bin": {
@@ -16,11 +16,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@work-graph/cli": "^0.2.4",
+    "@work-graph/cli": "^0.2.9",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.76"
   },
   "license": "Apache-2.0",
+  "homepage": "https://workgraph.ru/en/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/bvc-lang/work-graph.git",

package/vendor/packages/workgraph-mcp/src/index.mjs

@@ -340,10 +340,10 @@ server.tool(
 
 server.tool(
   'record_work_item_analysis',
-  'Write pre-execution feasibility analysis into WorkItem «Анализ» (стоит ли делать; not post-factum review). Text must come from Cursor LLM — server does not call models.',
+  'Write pre-execution feasibility analysis into WorkItem «Анализ» (стоит ли делать; not post-factum review). Text must come from the connected agent LLM — server does not call models.',
   {
     workId: z.string().describe('WorkItem id'),
-    analysis: z.string().describe('Full analysis text produced in Cursor'),
+    analysis: z.string().describe('Full analysis text produced by the connected agent'),
   },
   async (args) => jsonText(await recordWorkItemAnalysisFromMcp(args, rootOptions())),
 );

package/vendor/packages/workgraph-mcp/src/prompts.mjs

@@ -8,7 +8,7 @@ const TOOL_RULES = [
   'New WorkItem prose (Базис/Вектор/Цель/Проверки/title): Russian, min lengths per work-item-bvc-quality; forbidden jargon: closing analysis, Canon:, evidence, upstream, Track A, feeds_epics, depends_on=, «Стоит завести «…» в бэклог».',
   'Analysis is pre-execution only: feasibility (стоит ли делать), scope, deps, risks, alternatives — NOT a post-factum report of what was built, tests run, or evidence already in the atom.',
   'Write analysis in present/decision tense («Стоит брать», «Не стоит», «Можно стартовать»), never past retrospective («было оправдано», «можно было») even if work.status is done.',
-  'Analysis and decision are written only from Cursor: you (connected LLM) read the task, reason, then call record_work_item_analysis / record_work_item_decision. WorkGraph server never calls LLM.',
+  'Analysis and decision are written only from the connected agent (MCP client LLM): you read the task, reason, then call record_work_item_analysis / record_work_item_decision. WorkGraph server never calls LLM.',
   'Do not mark a WorkItem done without concrete evidence.',
   'Keep dashboard/kanban work in WorkGraph UI; MCP is the agent client bridge.',
 ].join('\n');
@@ -26,7 +26,7 @@ export const workgraphPrompts = {
   analyze_work_item: {
     description: 'Pre-execution feasibility analysis for a WorkItem (not post-factum review).',
     argsSchema: { workId: 'WorkItem id to analyze' },
-    text: ({ workId }) => `Analyze WorkGraph item ${workId || '<workId>'} in Cursor — **before execution**.
+    text: ({ workId }) => `Analyze WorkGraph item ${workId || '<workId>'} — **before execution** (pre-execution feasibility, not a post-mortem).
 
 This is a feasibility review (стоит ли делать), NOT a summary of work already done. Do NOT list implemented files, passing tests, or evidence from «Свидетельства» unless you judge future verification risk.
 

package/vendor/public/assets/favicon.svg

@@ -1,4 +1,3 @@
 <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-<rect width="16" height="16" fill="white"/>
 <path d="M3.33333 12.622L0 3.31055H3.33333L7.4 7.15081H8.52402L12.6667 3.31055H16L12.6667 12.622H10L8.52402 9.59728H7.4L6 12.622H3.33333Z" fill="#0065FF"/>
 </svg>

package/vendor/src/codeSyntaxHighlight.mjs

@@ -122,3 +122,66 @@ export function highlightCodeBlock(source, language) {
       return escapeHtml(source);
   }
 }
+
+const BVC_SECTION_RE = /^(Базис|Вектор|Цель|Метки|Checks|Basis|Vector|Goal|Labels):/u;
+
+function normalizePublicSiteCodeText(source) {
+  return String(source ?? '').replace(/\\n/g, '\n');
+}
+
+export function highlightBvcBlock(source) {
+  const text = normalizePublicSiteCodeText(source);
+  return text.split('\n').map((line) => {
+    const trimmed = line.trimEnd();
+    const header = trimmed.match(/^(#\w+)@(\w+)(<\[)?$/u);
+    if (header) {
+      const open = header[3] ? '<span class="code-hl-punct">&lt;[</span>' : '';
+      return `<span class="code-hl-keyword">${escapeHtml(header[1])}</span><span class="code-hl-punct">@</span><span class="code-hl-number">${escapeHtml(header[2])}</span>${open}`;
+    }
+    if (/^\]>$/.test(trimmed)) {
+      return '<span class="code-hl-punct">]&gt;</span>';
+    }
+    if (BVC_SECTION_RE.test(trimmed)) {
+      const match = trimmed.match(/^([^:]+):(.*)$/u);
+      const rest = match[2] ? highlightStructuredTokens(match[2]) : '';
+      return `<span class="code-hl-key">${escapeHtml(match[1])}</span><span class="code-hl-punct">:</span>${rest}`;
+    }
+    const kv = line.match(/^(\s+)([\w.*-]+):\s*(.*)$/u);
+    if (kv) {
+      return `${escapeHtml(kv[1])}<span class="code-hl-key">${escapeHtml(kv[2])}</span><span class="code-hl-punct">:</span> <span class="code-hl-string">${escapeHtml(kv[3])}</span>`;
+    }
+    if (/^\s+\S/u.test(line)) {
+      return `<span class="code-hl-comment">${escapeHtml(line)}</span>`;
+    }
+    return highlightStructuredTokens(line);
+  }).join('\n');
+}
+
+export function highlightMcpFlow(source) {
+  const text = normalizePublicSiteCodeText(source);
+  return text.split('\n').map((line) => {
+    let rest = line.trim();
+    let prefix = '';
+    if (/^→\s/u.test(rest)) {
+      prefix = '<span class="code-hl-punct">→</span> ';
+      rest = rest.replace(/^→\s/u, '');
+    }
+    const fnMatch = rest.match(/^([\w]+)(\(([^)]*)\))?(\s*\+\s*(\w+))?$/u);
+    if (fnMatch) {
+      const [, fn, parenGroup, args = '', plusSuffix, plusWord] = fnMatch;
+      let html = `${prefix}<span class="code-hl-key">${escapeHtml(fn)}</span>`;
+      if (parenGroup) {
+        html += `<span class="code-hl-punct">(</span><span class="code-hl-string">${escapeHtml(args)}</span><span class="code-hl-punct">)</span>`;
+      }
+      if (plusSuffix) {
+        html += `<span class="code-hl-punct"> + </span><span class="code-hl-keyword">${escapeHtml(plusWord)}</span>`;
+      }
+      return html;
+    }
+    const verbMatch = rest.match(/^([\w]+)\s+(.+)$/u);
+    if (verbMatch) {
+      return `${prefix}<span class="code-hl-key">${escapeHtml(verbMatch[1])}</span> <span class="code-hl-string">${escapeHtml(verbMatch[2])}</span>`;
+    }
+    return prefix + highlightStructuredTokens(rest);
+  }).join('\n');
+}

package/vendor/src/publicSiteContent.mjs

@@ -1,3 +1,5 @@
+import { getPublicSitePageBlocks, getPublicSitePageMeta } from './publicSitePageContent.mjs';
+
 export const PUBLIC_SITE_DEFAULT_LOCALE = 'en';
 export const PUBLIC_SITE_LOCALES = ['en', 'ru'];
 export const PUBLIC_SITE_THEMES = ['light', 'dark'];
@@ -7,13 +9,23 @@ const FLOW_RU = ['Решение (AN)', 'Контракт задачи (.bvc)',
 
 const COMPETITORS = [
   ['Cursor / Claude Code', 'Writes code and runs tools', 'partial', 'Execution layer; WG is the evidence ledger above it'],
+  ['GitHub Copilot', 'IDE completions and agent sessions', 'partial', 'Execution layer; WG scopes work.id and proof per change'],
+  ['Windsurf / Cline', 'Open IDE agents and edits', 'partial', 'Same as Cursor; WG supplies backlog and gates in git'],
   ['Linear / Jira', 'Plans and tracks issues', 'no', 'PM layer; WG keeps local BVC contracts and proof'],
+  ['Asana / ClickUp', 'Team tasks and project tracking', 'no', 'PM layer; no machine-readable contract per task'],
+  ['Notion / Confluence', 'Docs and informal task lists', 'no', 'Knowledge layer; WG links decisions to executable work items'],
+  ['Langfuse / LangSmith', 'LLM traces and experiment logs', 'partial', 'Observability; WG ties traces to BVC checks and done'],
   ['Mem0', 'Stores agent memory', 'no', 'Memory layer; WG stores accountable work records'],
   ['Devin', 'Autonomous ticket-to-PR sessions', 'partial', 'Cloud execution; WG defines acceptance and evidence'],
 ];
 const COMPETITORS_RU = [
   ['Cursor / Claude Code', 'Пишут код и вызывают инструменты', 'частично', 'Слой исполнения; WG ведёт журнал доказательств над ним'],
+  ['GitHub Copilot', 'Подсказки и агентские сессии в IDE', 'частично', 'Слой исполнения; WG задаёт work.id и proof на изменение'],
+  ['Windsurf / Cline', 'Открытые IDE-агенты и правки', 'частично', 'Как Cursor; WG даёт бэклог и гейты в git'],
   ['Linear / Jira', 'Планируют и ведут задачи', 'нет', 'PM-слой; WG хранит локальные BVC-контракты и доказательства'],
+  ['Asana / ClickUp', 'Командные задачи и проекты', 'нет', 'PM-слой; нет машиночитаемого контракта на задачу'],
+  ['Notion / Confluence', 'Документы и неформальные списки', 'нет', 'Слой знаний; WG связывает решения с исполняемой работой'],
+  ['Langfuse / LangSmith', 'Трассы LLM и логи экспериментов', 'частично', 'Наблюдаемость; WG привязывает трассы к BVC-проверкам и done'],
   ['Mem0', 'Хранит память агента', 'нет', 'Слой памяти; WG хранит ответственные записи работ'],
   ['Devin', 'Автономные сессии тикет→PR', 'частично', 'Облачное исполнение; WG задаёт acceptance и evidence'],
 ];
@@ -52,8 +64,8 @@ export const FAQ_ENTRIES = [
       {
         question: { en: 'Is Work Graph a task tracker?', ru: 'Work Graph — это тасктрекер?' },
         answer: {
-          en: 'No. Unlike Linear or Jira, which track statuses and comments, Work Graph tracks contracts and evidence. A WG task is a .bvc structure linked to repository files and cannot be closed until the agent submits machine-readable proof such as npm test with exit_code: 0.',
-          ru: 'Нет. Обычные трекеры вроде Linear и Jira хранят статусы и комментарии. Work Graph хранит контракты и доказательства. Задача в WG — это структура .bvc, привязанная к файлам репозитория, и она не может быть закрыта, пока агент не предоставит машиночитаемое свидетельство выполнения, например npm test с exit_code: 0.',
+          en: 'Yes — a local one in your git repo, with a kanban board and statuses. Unlike Jira or Linear, each item is a BVC contract with evidence gates, not just status and comments. A task cannot close until machine-readable proof is attached, for example npm test with exit_code: 0.',
+          ru: 'Да — локальный, в git-репозитории, с доской и статусами. В отличие от Linear и Jira, единица работы — BVC-контракт с гейтами evidence, а не только статус и комментарии. Задача не закрывается, пока не приложено машиночитаемое свидетельство, например npm test с exit_code: 0.',
         },
       },
       {
@@ -152,13 +164,15 @@ const COPY = {
       evidence: 'Evidence ledger',
       compare: 'Compare',
       docs: 'Docs',
+      menuOpen: 'Open menu',
+      menuClose: 'Close menu',
     },
     theme: { light: 'Light', dark: 'Dark' },
     localeLabel: 'Language',
     hero: {
-      eyebrow: 'Local-first · Git · MCP · Agents',
-      title: 'Contract platform for AI-driven development',
-      body: 'Work Graph links intent, execution and memory into one machine-readable loop. Not an AI chat, but a graph of work with trace: from research to proof of readiness.',
+      title: 'Your navigator for AI development — turns goals into an executable graph',
+      documentTitle: 'Work Graph — contract platform for AI-driven development',
+      body: 'Work Graph links intent, execution and memory into one loop. The path from idea to outcome becomes a manageable project map.',
       primary: 'How to install',
       secondary: 'Read llms.txt',
     },
@@ -201,13 +215,15 @@ const COPY = {
       evidence: 'Журнал доказательств',
       compare: 'Сравнение',
       docs: 'Документация',
+      menuOpen: 'Открыть меню',
+      menuClose: 'Закрыть меню',
     },
     theme: { light: 'Светлая', dark: 'Тёмная' },
     localeLabel: 'Язык',
     hero: {
-      eyebrow: 'Local-first · Git · MCP · Агенты',
-      title: 'Work Graph — контрактная платформа для разработки с ИИ',
-      body: 'Work Graph связывает намерение, исполнение и память в единый машиночитаемый контур. Не чат с ИИ, а граф работ со следом: от исследования до доказательства готовности.',
+      title: 'Ваш навигатор для AI-разработки, переводит цели в исполняемый граф',
+      documentTitle: 'Work Graph — контрактная платформа для разработки с ИИ',
+      body: 'Work Graph связывает намерение, исполнение и память в единый контур. Путь от идеи до результата превращается в управляемую карту проекта.',
       primary: 'Как установить',
       secondary: 'Открыть llms.txt',
     },
@@ -296,7 +312,6 @@ export const PUBLIC_SITE_ROUTES = [
   '/product',
   '/evidence-ledger',
   '/compare',
-  '/faq',
   '/docs',
   ...PUBLIC_DOCS.map((doc) => `/docs/${doc.slug}`),
 ];
@@ -352,8 +367,13 @@ export function buildFaqJsonLd(locale = PUBLIC_SITE_DEFAULT_LOCALE) {
   };
 }
 
+export function getPublicSiteCompetitors(locale) {
+  return locale === 'ru' ? COMPETITORS_RU : COMPETITORS;
+}
+
 export function getPublicSitePage(pathname, locale = PUBLIC_SITE_DEFAULT_LOCALE) {
   const copy = getPublicSiteCopy(locale);
+  const pageMeta = getPublicSitePageMeta(locale);
   const path = pathname === '/index.html' ? '/' : pathname;
   const docsMatch = path.match(/^\/docs\/([^/.]+)$/u);
   if (docsMatch) {
@@ -377,44 +397,33 @@ export function getPublicSitePage(pathname, locale = PUBLIC_SITE_DEFAULT_LOCALE)
   const routes = {
     '/': {
       title: copy.hero.title,
+      documentTitle: copy.hero.documentTitle,
       description: copy.hero.body,
       kind: 'home',
       sections: [
-        { title: copy.sections.flowTitle, body: copy.sections.flowBody, items: locale === 'ru' ? FLOW_RU : FLOW, icon: 'git-branch', badges: [{ label: 'BVC', tone: 'accent' }, { label: locale === 'ru' ? 'ЛОКАЛЬНО' : 'LOCAL', tone: 'ok' }] },
-        { title: copy.sections.evidenceTitle, body: copy.sections.evidenceBody, icon: 'shield-check', badges: [{ label: locale === 'ru' ? 'ДОКАЗАТЕЛЬСТВА' : 'EVIDENCE', tone: 'warning' }, { label: locale === 'ru' ? 'ПРОВЕРКА' : 'VERIFY', tone: 'accent' }] },
-        { title: copy.sections.compareTitle, body: locale === 'ru' ? 'IDE выполняет команды, трекер ведёт задачи, память хранит факты. Work Graph связывает намерение, контракт работы и доказательство результата.' : 'The IDE runs commands, the tracker manages tasks and memory stores facts. Work Graph connects intent, work contract and proof of outcome.', icon: 'scales', badges: [{ label: locale === 'ru' ? 'ГРАФ НАМЕРЕНИЙ' : 'INTENT GRAPH', tone: 'accent' }, { label: locale === 'ru' ? 'ДОКАЗАТЕЛЬСТВА' : 'EVIDENCE', tone: 'warning' }] },
-        { title: copy.sections.docsTitle, body: copy.sections.docsBody, icon: 'robot', badges: [{ label: 'LLMS.TXT', tone: 'accent' }, { label: 'MCP', tone: 'ok' }] },
+        { title: copy.sections.flowTitle, body: copy.sections.flowBody, badges: [{ label: 'BVC', tone: 'accent' }, { label: locale === 'ru' ? 'ЛОКАЛЬНО' : 'LOCAL', tone: 'ok' }] },
+        { title: copy.sections.evidenceTitle, body: copy.sections.evidenceBody, badges: [{ label: locale === 'ru' ? 'ДОКАЗАТЕЛЬСТВА' : 'EVIDENCE', tone: 'warning' }, { label: locale === 'ru' ? 'ПРОВЕРКА' : 'VERIFY', tone: 'accent' }] },
+        { title: copy.sections.docsTitle, body: copy.sections.docsBody, badges: [{ label: 'LLMS.TXT', tone: 'accent' }, { label: 'MCP', tone: 'ok' }] },
+        { title: copy.sections.compareTitle, body: locale === 'ru' ? 'IDE выполняет команды, трекер ведёт задачи, память хранит факты. Work Graph связывает намерение, контракт работы и доказательство результата.' : 'The IDE runs commands, the tracker manages tasks and memory stores facts. Work Graph connects intent, work contract and proof of outcome.', badges: [{ label: locale === 'ru' ? 'ГРАФ НАМЕРЕНИЙ' : 'INTENT GRAPH', tone: 'accent' }, { label: locale === 'ru' ? 'ДОКАЗАТЕЛЬСТВА' : 'EVIDENCE', tone: 'warning' }] },
       ],
     },
     '/product': {
-      title: copy.sections.productTitle,
-      description: copy.sections.productBody,
+      ...pageMeta.product,
       kind: 'product',
-      sections: [
-        { title: copy.labels.analytics, body: locale === 'ru' ? 'Решения и аргументация становятся долговечными AN-записями до попадания работы в бэклог.' : 'Decisions and reasoning become durable AN records before work enters the backlog.', icon: 'chart-bar', badges: [{ label: 'AN', tone: 'accent' }] },
-        { title: copy.labels.workItems, body: locale === 'ru' ? 'BVC-атомы фиксируют Базис, Вектор и Цель, чтобы бэклог не превращался в список дел из чата.' : 'BVC atoms define Basis, Vector and Goal so the backlog is not a chat todo list.', icon: 'clipboard-text', badges: [{ label: '.WORK.BVC', tone: 'ok' }] },
-        { title: copy.labels.board, body: locale === 'ru' ? 'Текущее движение видно людям и агентам через состояния: готово, захвачено, выполняется и на проверке.' : 'Current motion is visible for humans and agents through ready, claimed, doing and verify states.', icon: 'kanban', badges: [{ label: locale === 'ru' ? 'ПОТОК' : 'FLOW', tone: 'warning' }] },
-        { title: copy.labels.verification, body: locale === 'ru' ? 'Доказательства и проверки решают готовность; done — это вердикт контракта, а не сообщение.' : 'Evidence and checks decide readiness; done is a contract verdict, not a message.', icon: 'shield-check', badges: [{ label: locale === 'ru' ? 'ГОТОВО' : 'READY', tone: 'accent' }] },
-        { title: copy.labels.memory, body: locale === 'ru' ? 'Проверенные результаты становятся памятью проекта с исходными задачами и связанными файлами.' : 'Verified outcomes become project memory with source work items and related files.', icon: 'brain', badges: [{ label: locale === 'ru' ? 'ПАМЯТЬ' : 'MEMORY', tone: 'ok' }] },
-      ],
+      blocks: getPublicSitePageBlocks(locale, 'product'),
+      sections: [],
     },
     '/evidence-ledger': {
-      title: copy.sections.evidenceTitle,
-      description: copy.sections.evidenceBody,
+      ...pageMeta.evidence,
       kind: 'evidence',
-      sections: [
-        { title: copy.labels.readyForDone, body: locale === 'ru' ? 'Завершение требует доказательств, проверок и трассируемого контракта работы. Гейт объясняет, чего именно не хватает.' : 'Done requires evidence, checks and a traceable work contract. The gate can explain exactly what is missing.', icon: 'check-circle', badges: [{ label: locale === 'ru' ? 'ГЕЙТ' : 'GATE', tone: 'accent' }] },
-        { title: copy.labels.evidenceRecords, body: locale === 'ru' ? 'Строки и структурированные записи доказательств связывают команды, файлы, трассы и результаты проверки с work.id.' : 'Evidence lines and structured records link commands, files, traces and verification outcomes to a work.id.', icon: 'list-checks', badges: [{ label: locale === 'ru' ? 'ТРАССА' : 'TRACE', tone: 'warning' }] },
-        { title: copy.labels.localByDefault, body: locale === 'ru' ? 'Журнал живёт в репозитории, а не в отдельной SaaS-базе, поэтому review и аудит следуют за git.' : 'The ledger lives in the repository, not in a separate SaaS database, so review and audit follow git.', icon: 'hard-drives', badges: [{ label: 'GIT', tone: 'ok' }] },
-      ],
+      blocks: getPublicSitePageBlocks(locale, 'evidence'),
+      sections: [],
     },
     '/compare': {
-      title: copy.sections.compareTitle,
-      description: locale === 'ru' ? 'Сравнение с Cursor, Claude Code, Linear, Devin и Mem0.' : 'Comparison with Cursor, Claude Code, Linear, Devin and Mem0.',
+      ...pageMeta.compare,
       kind: 'compare',
-      sections: [
-        { title: copy.labels.competitorMatrix, body: locale === 'ru' ? 'Work Graph занимает слой графа намерений: связывает цели, решения, задачи, evidence и память.' : 'Work Graph is the intent-graph layer: it links goals, decisions, work items, evidence and memory.', competitors: locale === 'ru' ? COMPETITORS_RU : COMPETITORS, icon: 'strategy', badges: [{ label: 'AN-44', tone: 'muted' }, { label: 'AN-64', tone: 'accent' }] },
-      ],
+      blocks: getPublicSitePageBlocks(locale, 'compare'),
+      sections: [],
     },
     '/docs': {
       title: copy.sections.docsTitle,
@@ -424,14 +433,6 @@ export function getPublicSitePage(pathname, locale = PUBLIC_SITE_DEFAULT_LOCALE)
         { title: copy.labels.docsIndex, body: locale === 'ru' ? 'BVC, MCP-инструменты, проверки и ошибки выполнения.' : 'BVC, MCP tools, verification and runtime errors.', docs: PUBLIC_DOCS.map((doc) => localizePublicDoc(doc, locale)), icon: 'book-open-text', badges: [{ label: 'MARKDOWN', tone: 'accent' }, { label: 'JSON-LD', tone: 'ok' }] },
       ],
     },
-    '/faq': {
-      title: locale === 'ru' ? 'Вопрос-ответ (FAQ) — Work Graph' : 'FAQ — Work Graph',
-      description: locale === 'ru'
-        ? 'Быстрые ответы о контрактной платформе, BVC, MCP, локальном хранении, evidence и гейтах.'
-        : 'Quick answers about the contract platform, BVC, MCP, local storage, evidence and gates.',
-      kind: 'faq',
-      sections: [],
-    },
   };
 
   return routes[path] ? { route: path, ...routes[path] } : null;
@@ -446,7 +447,7 @@ export function buildLlmsTxt() {
 - /product - Workflow: Analytics -> Work Items -> Board -> Verification -> Memory
 - /evidence-ledger - Evidence and ready-for-done contract
 - /compare - Comparison with Cursor, Claude Code, Linear, Devin and Mem0
-- /faq - Human and LLM-readable FAQ
+- /#faq - FAQ on the home page (structured JSON at /faq.json)
 - /docs/bvc-spec - BVC atom specification
 - /docs/mcp-tools - MCP tool contracts
 - /docs/verification-matrix - Tier A/B/C verification rules