7c7afa6875
Сохраняем онбоардинг-память проекта (core, tech_stack, conventions, suggested_commands, task_completion) в .serena и коммитим служебную директорию, чтобы она была доступна на сервере. Директория НЕ исключена в .gitignore (локально исключаются только cache и project.local.yml).
51 lines
4.0 KiB
Markdown
51 lines
4.0 KiB
Markdown
# core
|
||
|
||
Ratatoskr-go — оркестратор конвейера Ratatoskr (порт с Python на Go) в единый
|
||
статический бинарь (CGO_ENABLED=0). Субагенты запускаются через внешний процесс
|
||
[opencode](https://opencode.ai). Взаимодействие — Telegram-бот.
|
||
|
||
## Структура (модули internal/)
|
||
|
||
```
|
||
cmd/ratatoskr/ точка входа, сборка бинаря; main.version и main.updateToken вшиваются ldflag'ом
|
||
internal/
|
||
app/ composition root/DI: App.New -> config.Load+Validate, ResolveExePaths, storage, Runner, Analyst, Core, Worker, Updater. packageOwner="kamelion", Version="0.1.0"
|
||
config/ YAML+env загрузка (${VAR:-default}), defaults, validate C1-C4
|
||
chat/ мультиканальный Router; telegram — long-poll канал. Коды M1-M5
|
||
core/ state-machine задач + Decider/analyst интерфейс. Коды D3/D4
|
||
analyst/ аналитик: промпт + разбор JSON-вердикта (opencode agent). Коды A1-A4
|
||
worker/ polling-планировщик + dev/reviewer-конвейер + gitops. Коды W*, E*, R*
|
||
agents/ встроенные opencode-агенты (analyst.md, dev.md, reviewer.md) через go:embed
|
||
opencode/ обёртка запуска opencode, LiveRegistry, парсинг вердикта. Коды O1-O4
|
||
storage/ SQLite (modernc.org/sqlite, без CGO): tasks, traces, task_history. Коды S1-S5
|
||
update/ автообновление из Gitea Packages. Коды U1-U6
|
||
```
|
||
|
||
## Ключевые инварианты
|
||
|
||
- **Команды/ядро:** Core.ProcessTurn — state-machine поверх storage. Команды:
|
||
/start /cancel /skip /retry N /status N /continue N. Активная задача — одна на чат.
|
||
- **Фазы аналитика (Decision.Phase):** `ask` (уточняющие вопросы), `propose` (правки
|
||
черновика), `ready` (черновик полон как есть), `abort` (тема вне проекта). propose и ready
|
||
в core обрабатываются одинаково.
|
||
- **Статусы задач:** draft→collecting→ready→approved→running→success/failed/timeout,
|
||
плюс cancelled/aborted/closed. approved — финальное одобрение («создавай»), после чего
|
||
воркер берёт задачу. IsValidTransition/IsTerminal в storage/models.go.
|
||
- **Decider/Worker/Analyst/Reviewer:** Decider=analyst интерфейс (analyst пакет реализует);
|
||
Worker — polling-планировщик dev-агента; Reviewer проверяет diff dev-ветки (R1-R6),
|
||
вердикт JSON {passed, critical_issues, solid_violations, comments}.
|
||
- **gitops (worker):** worker работает с worktrees; feature-ветка = `feat/<taskTag>` от
|
||
origin/main; ensureBranch (reset --hard + clean -fd + checkout -B), branchDiff
|
||
(`origin/main...<branch>`), push через http.extraHeader, токен как Bearer.
|
||
- **Пути «всё рядом с .exe»:** относительные db/worktree резолвятся от каталога бинаря
|
||
(ExeDir), не от cwd. config.yaml ищутся рядом с бинарём, фоллбэк cwd.
|
||
- **Автообновление:** авто = только Check+уведомление; замена — по /update. Версии в
|
||
Gitea Packages `commit-<sha7>/` (не `latest/`). Вердикты агентов — строгий JSON.
|
||
|
||
## Контракты (не ломать)
|
||
|
||
- `App.New(configPath, version, updateToken string)` — сигнатура.
|
||
- `packageOwner` — константа "kamelion" (не плодить vars/ldflag/конфиг).
|
||
- `update.Updater` — создаётся структурой `&update.Updater{...}`, конструктора нет.
|
||
|
||
См. также `mem:tech_stack`, `mem:conventions`, `mem:task_completion`, `mem:suggested_commands`. |