papayu/docs/RUNBOOK.md
Yuriy 65e95a458d feat: мульти-провайдер LLM, тренды дизайна, Snyk/Documatic sync, личная автоматизация
- Мульти-провайдер: PAPAYU_LLM_PROVIDERS — сбор планов от нескольких ИИ (Claude, OpenAI), агрегация
- Тренды дизайна и иконок: вкладка в модалке, поиск по безопасным доменам (Tavily include_domains)
- Snyk Code: PAPAYU_SNYK_SYNC, REST API issues → snyk_findings в agent-sync
- Documatic: architecture_summary из .papa-yu/architecture.md в agent-sync
- Личная автоматизация: capability personal-automation (терминал git/npm/cargo, открытие URL)
- agent_sync расширен: snyk_findings, architecture_summary; analyze_project_cmd и run_batch пишут sync
- Документация: SNYK_AND_DOCUMATIC_SYNC.md, SECURITY_AND_PERSONAL_AUTOMATION.md, обновлён CLAUDE_AND_AGENT_SYNC

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-10 15:05:39 +03:00

2.9 KiB
Raw Blame History

Runbook — papa-yu

Build

Requirements

  • Node.js 18+
  • Rust 1.70+
  • npm

One-command build

cd papa-yu
npm install
npm run tauri build

Из корня: cd src-tauri && cargo build --release (только бэкенд).


Run

Development

npm run tauri dev

Поднимает Vite и Tauri. Интерфейс доступен в окне приложения.

Важно: не открывать скомпилированный .app без dev-сервера — фронт не загрузится.

Production

Собранный бинарник: src-tauri/target/release/ (или через npm run tauri build).


Where logs are

  • Traces: .papa-yu/traces/*.json (при PAPAYU_TRACE=1)
  • Stderr: события LLM, apply, fallback — в консоль/терминал
  • Weekly report: агрегация из traces

Common issues

Golden traces mismatch

Симптом: cargo test golden_traces падает с ошибкой schema_hash.

Причина: изменён llm_response_schema_v*.json.

Действие: пересчитать SHA256 схемы, обновить schema_hash во всех фикстурах в docs/golden_traces/v*/*.json.


LLM planner instability

Симптом: невалидный JSON, ERR_SCHEMA_VALIDATION, частые repair.

Причина: модель не держит strict JSON, или промпт перегружен.

Действие: включить PAPAYU_LLM_STRICT_JSON=1 (если провайдер поддерживает); уменьшить контекст; проверить PAPAYU_CONTEXT_MAX_*.


PATCH/EDIT conflicts

Симптом: ERR_EDIT_ANCHOR_NOT_FOUND, ERR_EDIT_BEFORE_NOT_FOUND, ERR_EDIT_AMBIGUOUS.

Причина: anchor/before не соответствуют текущему содержимому файла.

Действие: см. docs/EDIT_FILE_DEBUG.md. Убедиться, что FILE-блоки в контексте включают sha256 (v2/v3).


"Could not fetch a valid…" (UI)

Симптом: пустое окно при запуске.

Причина: фронт не загрузился (Vite не поднят).

Действие: запускать только npm run tauri dev, не открывать .app напрямую.


Diagnostics

  • Проверить протокол: PAPAYU_PROTOCOL_VERSION=3 для EDIT_FILE.
  • Воспроизведение: включить PAPAYU_TRACE=1, выполнить сценарий, смотреть .papa-yu/traces/.
  • Тесты: cd src-tauri && cargo test — полный прогон.
  • CI: cargo fmt --check, cargo clippy, cargo audit, cargo test.