16.7 KB · updated 2026-05-19 · md

feature-map.ru.md

docs/i18n/feature-map.ru.md

Карта функций

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

Этот документ кратко описывает функции, которые сейчас реализованы в Tesserae, с их статусом, исходными файлами и местом в документации.

Легенда статуса: ✅ поставлено · ⚠ в работе / частично.

Редизайн фронтенда — апрель 2026

Иерархическая wiki, ориентированная на документы, заменяет прежний дамп графа. См. MD0 для обзора по маршрутам и MD1 для трехслойной модели.

Wiki-слой (L2 markdown)

Функция	Статус	Источник	Якорь документации
`WikiPageStore` (идемпотентные записи body-hash, парсер frontmatter)	✅	MD0	architecture.md § Карта модулей
`WikiLayerProjector` — одна md-страница на узел wiki-слоя	✅	MD0	architecture.md § Pipeline
Страницы `sources/`	✅	`wiki_projector.py`	frontend-redesign.md § Sources
Страницы `concepts/`	✅	`wiki_projector.py`	frontend-redesign.md § Concepts
Страницы `entities/`	✅	`wiki_projector.py`	frontend-redesign.md § Entities
Страницы `papers/`	✅	`wiki_projector.py`	frontend-redesign.md § Papers
Страницы `repos/`	✅	`wiki_projector.py`	frontend-redesign.md § Repos
Страницы `topics/`	✅	`wiki_projector.py`	frontend-redesign.md § Topics
Страницы `questions/` (открытые вопросы)	✅	`wiki_projector.py`	frontend-redesign.md § Questions
Страницы `syntheses/`	✅	MD0	frontend-redesign.md § Syntheses

Виды синтеза (L2 → производные)

SynthesisProjector создает семь детерминированных шаблонов и добавляет узлы Synthesis плюс ребра synthesizes / summarizes обратно в граф.

Вид	Статус	Источник	Примечания
`pulse` (один глобальный, питает `/`)	✅	`synthesis.py`	Пересобирается при каждом compile.
`daily_digest`	✅	`synthesis.py`	Один на `data/research/daily/<date>/`.
`weekly`	✅	`synthesis.py`	Один на `data/research/weekly/<iso-week>/`.
`topic`	✅	`synthesis.py`	Один на кластер `ResearchTopic` / `ApproachFamily` с ≥ 3 papers.
`comparison`	✅	`synthesis.py`	Один на пару `ApproachFamily`, конкурирующих в одной задаче.
`field_overview`	✅	`synthesis.py`	Один на `ResearchField`.
Сводки, улучшенные LLM (через env-флаг)	⚠	только hook	Эвристическая базовая версия поставляется; hook `TESSERAE_SYNTHESIS_LLM=1` оставлен как stub.

Маршруты статического сайта

Маршрут	Статус	Источник	Примечания
`/` (главная, hero pulse)	✅	MD0 `render_home`	Строка статистики + отобранные точки входа + недавняя активность.
`/sources/`, `/sources/<slug>.html`	✅	`pages.py::render_sources_index`, `render_source_detail`
`/concepts/`, `/concepts/<slug>.html`	✅	`pages.py::render_concepts_index`, `render_concept_detail`
`/entities/`, `/entities/<slug>.html`	✅	`pages.py::render_entities_index`, `render_entity_detail`
`/papers/`, `/papers/<slug>.html`	✅	`pages.py::render_papers_index`, `render_paper_detail`
`/repos/`, `/repos/<slug>.html`	✅	`pages.py::render_repos_index`, `render_repo_detail`
`/topics/`, `/topics/<slug>.html`	✅	`pages.py::render_topics_index`, `render_topic_detail`
`/syntheses/`, `/syntheses/<slug>.html`	✅	`pages.py::render_syntheses_index`, `render_synthesis_detail`
`/questions/`, `/questions/<slug>.html`	✅	`pages.py::render_questions_index`, `render_question_detail`
`/timeline/`	✅	`pages.py::render_timeline`	Тепловая карта + список дней + рельс synthesis.
`/timeline/<YYYY-MM-DD>.html` (детали по дню)	⚠	пока n/a	Ячейки тепловой карты временно ведут на исходную страницу `digest.md` соответствующего дня. Subagent P подключает дневные detail-страницы через `StaticSiteBuilder`.
`/graph/` (интерактивные 2D + 3D)	✅	`pages.py::render_graph_view` + `js.py`	3d-force-graph + Three.js, подсказки при наведении, подписи ребер, zoom с привязкой к курсору.
`/about.html`	✅	`pages.py::render_about`	Schema, информация о сборке.

Экспорты, удобные для ИИ

Артефакт	Статус	Источник	Назначение
Соседний файл `<page>.txt` для каждой страницы	✅	MD0 `write_siblings`	Текстовый вид одной страницы (без навигации и стилей).
Соседний файл `<page>.json` для каждой страницы	✅	`exports.py::write_siblings`	`{title, kind, body, body_text, links, source_path, frontmatter}`.
`llms.txt`	✅	`exports.py::render_llms_txt`	Короткий индекс llmstxt.org.
`llms-full.txt`	✅	`exports.py::render_llms_full_txt`	Тело всех страниц, ограничено 5 MB.
`graph.jsonld`	✅	`exports.py::render_graph_jsonld`	schema.org `Dataset`, только узлы wiki-слоя.
`graph.json`	✅	`__init__.py::write_site`	Полный payload графа (вкл. code nodes для tooling).
`search-index.json`	✅	MD0	Палитра + поиск страниц; только типы wiki-слоя.
`sitemap.xml`	✅	`exports.py::render_sitemap_xml`	Все выпущенные маршруты, `lastmod` из frontmatter.
`rss.xml`	✅	`exports.py::render_rss_xml`	Последние 30 syntheses.
`robots.txt`	✅	`exports.py::render_robots_txt`	Разрешительный — crawl + index.
`ai-readme.md`	✅	`exports.py::render_ai_readme`	Машиночитаемая карта сайта.
`manifest.json`	✅	`__init__.py::_manifest`	sha256 + размер для каждого выпущенного файла (harness идемпотентности).

Визуальный дизайн + UX

Функция	Статус	Источник	Примечания
Design tokens (светлая + темная темы, терракотовый акцент)	✅	MD0	Один CSS bundle в `assets/style.css`.
Переключатель темы (сохраняется, без вспышки)	✅	MD0	`data-theme="dark"` в `localStorage`, применяется до отрисовки.
Поисковая палитра (`cmd+k` / `ctrl+k` / `/`)	✅	`js.py`	Нечеткое совпадение по `search-index.json`; список недавних страниц.
Липкий правый TOC	✅	`pages.py` + `tokens.py`	Только desktop; mobile drawer через `<details>`.
Тепловая карта активности с метками месяцев + дней недели	✅	`components.py::heatmap_svg`	SVG на 26 недель, ячейки ведут на дневной `digest.md`.
Sparkline (по concept/entity)	✅	`components.py::sparkline_svg`	Недельные счетчики упоминаний, последние 12 недель.
Mobile shell (drawer rail, bottom nav, fluid type)	✅	`tokens.py` + `pages.py`	Сенсорные цели ≥ 44 px.
Переходы страниц (opacity 120 ms, prefers-reduced-motion)	✅	`tokens.py`
3D + 2D вид графа (hover, подписи ребер, zoom с привязкой к курсору)	✅	`pages.py::render_graph_view` + `js.py`	3d-force-graph + Three.js, vendored как CDN snapshot.
Footer AI-соседей на странице	✅	`components.py::ai_siblings_footer`	Inline-ссылки на `.txt` и `.json` текущей страницы.
Страницы истории сессий harness	✅	MD0 + MD1	Явный импорт Claude Code/Codex; индекс `/sessions/` и detail-страницы с markdown turns, левым turn rail, свернутым tool use и search entries.

Pipeline + CLI

Функция	Статус	Источник	Примечания
`project compile` вызывает synthesis + wiki + site по порядку	✅	MD0	Фаза 3 плана редизайна.
`project build-site` standalone	✅	`project.py` + MD1	Читает `wiki/` + `graph.json`, пишет `site/`.
`project serve` локальный HTTP	✅	`cli.py`	Простой stdlib server.
`project deploy` → GitHub Pages	✅	MD0	Worktree push в `gh-pages`; опциональный `--enable-pages` через `gh` CLI. `--build`, `--dry-run`, `--branch`, `--remote`, `--force`.
`project sessions discover/import/list`	✅	MD0 + `cli.py`	Входящая история сессий для Claude Code/Codex; обнаружение явное и ограничено рабочим каталогом проекта.
`project watch` rebuild-on-change	⚠	MD0	Subagent R завершает polling watcher — поверхность аргументов `--interval`, `--debounce`, `--once`, `--paths`, `--quiet` готова; тело rebuild loop приземляется в этом раунде.

Ранее существовавшие функции (перенесены без изменений)

CLI и установка

✅ Устанавливаемый Python package через pyproject.toml.
✅ Console commands: tesserae, tesserae, tesserae_mcp.
✅ scripts/install.sh для установки curl | bash.
✅ Editable installs по умолчанию для быстрой локальной разработки.

Извлечение

✅ Детерминированный extractor исследовательских заметок с контролируемыми словарями nodes/edges.
✅ Claude CLI/OAuth extractor для более качественного структурированного извлечения без API keys.
✅ Выборочная маршрутизация Claude по glob и budget limit.
✅ Детерминированный extractor development-code для Python проектов.
✅ Batch ingest с content hashing и поддержкой --changed-only.
✅ Чтение источников с терпимостью к некорректному UTF-8.

Управление графом

✅ Контролируемый список ResearchNodeType — теперь включает SYNTHESIS.
✅ Контролируемый whitelist edge types — теперь включает synthesizes, summarizes.
✅ Валидация для отклонения schema drift.
✅ Каноникализация alias.
✅ Review queue для неоднозначных почти-дубликатов nodes.
✅ Шаблон review decisions и workflow merge/keep-separate.
✅ Сводка трендов корпуса из графов по файлам.

Персистентность и отчеты

✅ Экспорт Graph JSON.
✅ SQLite graph store.
✅ Опциональный Kuzu graph store.
✅ Graph report с counts, evidence coverage, orphan nodes, date buckets, alias-heavy nodes.
✅ Competitive report с описанием идей, заимствованных из MegaMem, Graphiti/Zep, MCP graph servers, agentic RAG.

Project-local workflow

✅ tesserae project init
✅ tesserae project ingest
✅ tesserae project compile
✅ tesserae project mcp-config
✅ tesserae project build-site
✅ tesserae project serve
✅ tesserae project deploy (новое — GitHub Pages)
✅ tesserae project sessions discover/import/list (явный импорт локальной agent-history)
⚠ tesserae project watch (в работе)
✅ tesserae project export-agent-harness
✅ tesserae project export-obsidian
✅ tesserae project export-graphiti
✅ tesserae project sync-graphiti

Obsidian

✅ Готовый к открытию vault export.
✅ .obsidian/app.json и настройки графа.
✅ Markdown projection.
✅ Структура raw/assets/.
✅ _meta/dashboard.md с Dataview query.

Agent harnesses

Создаваемые target files для:

✅ Claude Code: CLAUDE.md, .claude/settings.json
✅ Codex: AGENTS.md, mcp.toml
✅ Gemini: GEMINI.md, .gemini/settings.json
✅ Kiro: steering and MCP settings
✅ Cursor: project rules and MCP config
✅ OpenCode: AGENTS.md, opencode.json

Graphiti / temporal facts

✅ Проекция temporal facts с полями provenance, currentness, confidence и invalidation.
✅ Dependency-free экспорт Graphiti episode JSONL.
✅ Smoke sync-graphiti --dry-run без установленного Graphiti.
✅ Опциональная live sync с graphiti_core и Neo4j.

Cognee

✅ Cognee JSONL bundle (nodes.jsonl, edges.jsonl, manifest.json).
✅ Опциональный add-only direct import.
✅ Опциональный Cognee cognify adapter на базе Codex CLI/OAuth.
✅ Детерминированный и Ollama embedding adapter paths для no-API-key smoke/quality workflows.

MCP server

✅ tesserae_mcp / python3 -m tesserae.mcp_server поверх stdio JSON-RPC.
✅ Tools: schema, graph_summary, search_nodes, node_context, search_facts, timeline.
✅ Multi-project registry.

Тесты

Текущий набор покрывает:

✅ ontology guardrails (вкл. новый узел Synthesis + ребра synthesizes / summarizes);
✅ deterministic extraction;
✅ parsing/validation обертки Claude CLI;
✅ selective Claude routing;
✅ workflow canonicalization/review;
✅ batch ingest;
✅ reports;
✅ SQLite/Kuzu persistence;
✅ Cognee bundles/import patches;
✅ Graphiti export/sync dry-run;
✅ project CLI workflow;
✅ agent harness export;
✅ Obsidian export;
✅ frontend generation + link integrity (без nodes/codeclass-*.html);
✅ wiki store idempotence;
✅ synthesis projector golden + idempotence;
✅ site components, pages, exports, relevance;
✅ форма AI-sibling (.txt + .json на страницу);
✅ end-to-end compile-twice idempotence;
✅ package install и installer contract.