6.7 KB · updated 2026-07-06 · md

publishing-checklist.ru.md

docs/i18n/publishing-checklist.ru.md

Чеклист публикации

<!-- translations:start -->

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

<!-- translations:end --> Используйте этот чеклист перед публичной презентацией Tesserae.

Гигиена репозитория

  • [ ] README объясняет, что это за проект и какую проблему он решает.
  • [ ] Команда установки работает из свежего shell.
  • [ ] Quickstart использует tesserae, а не python3 -m.
  • [ ] Документация по архитектуре объясняет raw evidence → graph → projections.
  • [ ] Карта функций перечисляет реализованные возможности без преувеличения будущей работы.
  • [ ] Документация по истории сессий объясняет явный импорт, проверку приватности, сгенерированные routes и transcript typography.
  • [ ] Демо Self-dogfood было запущено и задокументировано.
  • [ ] Сгенерированные артефакты воспроизводимы и либо игнорируются, либо намеренно публикуются.

Проверка

.venv/bin/pytest tests/ -x          # ПРЕРВАТЬ при любом сбое — никогда не выпускайте красную сборку
./scripts/install.sh --help
tesserae init --help
tesserae compile --help
tesserae context --help     # Компилятор контекста по запросу

Smoke-сборка демо (совпадает с CI-задачей build-demo)

И релизный поток, и CI компилируют Tesserae по его собственному дереву исходников с детерминированным экстрактором (без вызовов LLM, без API-ключей) и собирают сайт:

.venv/bin/python -m tesserae init --yes --source .
.venv/bin/python -m tesserae compile
.venv/bin/python -m tesserae export site

Релизный поток

Управляется навыком release (.claude/skills/release/SKILL.md). Последний тег — v0.5.0.

  • [ ] На main, рабочее дерево чистое, выполнить git pull --ff-only origin main.
  • [ ] Тесты + smoke-сборка демо (выше) проходят.
  • [ ] Поднять version = "X.Y.Z" в pyproject.toml (синхронизировать package.json, если есть); закоммитить release: vX.Y.Z с однопараграфным changelog из git log v<prev>..HEAD.
  • [ ] Тег git tag -a vX.Y.Z -m "vX.Y.Z"; запушить сначала коммит, затем тег.
  • [ ] Дождаться зелёного CI (gh run watch <run-id>) — не выпускать GitHub-релиз на красной сборке.
  • [ ] Опубликовать GitHub-релиз. Публикация в PyPI — опционально (когда будет готово).

GitHub Pages

Воркфлоу build-demo (push в main) всегда загружает скомпилированный dogfood-сайт как инспектируемый артефакт воркфлоу и также деплоит его в GitHub Pages, когда Pages включён. Шаги Pages помечены continue-on-error: дефолтный GITHUB_TOKEN не может создать сайт Pages, поэтому самый первый деплой требует однократного ручного переключения в Settings → Pages → Source: GitHub Actions. Пока этот тумблер не включён, сборка всё равно остаётся зелёной, а артефакт всё равно создаётся.

Self-dogfood

Подключения интеграций (Understand Anything, RAG-Anything, cognee) теперь являются интерактивными запросами мастера, а не CLI-флагами. Запустите мастер и ответьте на них:

tesserae init \
  --name tesserae_self \
  --source README.md \
  --source docs \
  --source tesserae \
  --source tests \
  --source scripts
# когда мастер спросит:
#   - включите Understand Anything (платформа: codex), установить: да
#   - включите RAG-Anything, установить: да, парсер: mineru, запустить после: да
#   - включите cognee, установить: да
tesserae compile
tesserae sessions list
tesserae export site
tesserae serve --port 8765

Для полностью неинтерактивного запуска используйте tesserae init --yes (все интеграции ВЫКЛЮЧЕНЫ), затем включите каждую интеграцию в .tesserae/config.json — мастер записывает их под ключами memory_backends (cognee) и external_tools (Understand Anything, RAG-Anything) — и выполните tesserae integrations refresh <name> для каждой перед компиляцией. Точные ключи конфигурации см. в документах по интеграциям.

Тезисы для демо

  • Tesserae — не универсальный граф именных фраз. Он использует контролируемую ontology.
  • Исследовательский и разработческий код используют общую инфраструктуру, но сохраняют разные schema.
  • Markdown и HTML — это проекции, а не авторитетные хранилища истины.
  • Путь по умолчанию локален и удобен без API key.
  • Агентские harness и MCP делают граф пригодным для coding agents.
  • Импортированные страницы сессий harness превращают предыдущую работу Claude Code/Codex в доступную для поиска память проекта, сохраняя обнаружение transcript явным.