chore: onboard Serena — add .serena with project memories
Сохраняем онбоардинг-память проекта (core, tech_stack, conventions, suggested_commands, task_completion) в .serena и коммитим служебную директорию, чтобы она была доступна на сервере. Директория НЕ исключена в .gitignore (локально исключаются только cache и project.local.yml).
This commit is contained in:
51
.serena/memories/core.md
Normal file
51
.serena/memories/core.md
Normal file
@@ -0,0 +1,51 @@
|
||||
# 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`.
|
||||
Reference in New Issue
Block a user