2 Commits

Author SHA1 Message Date
ki.sagidullin
0b76734652 fix(scripts): сборка UI через массив аргументов + UTF-8 BOM
- go build: -ldflags со пробелами передавались одним токеном и падали
  ("invalid value $ldflags for flag -ldflags"). Вместо этого собираем
  массив $goArgs и вызываем go через splatting - каждый аргумент отдельным
  токеном.
- Файл перекодирован в UTF-8 с BOM: PowerShell 5.1 без BOM читал .ps1 как
  ANSI (cp1251) и ломал парсинг кириллических строк.
- .gitignore: игнорировать companion-файлы публикации
  (ratatoskr-*.sha256 / ratatoskr-*.version).
2026-08-20 17:59:05 +05:00
ki.sagidullin
5e7fb58049 fix(ci): headless в CI, UI-бинарь собирается локально
CI (.gitea/workflows/ci.yaml):
- go 1.23 -> 1.25 (modernc.org/sqlite v1.56.0 требует go 1.25; старый CI падал
  на сборке ещё до тестов).
- CGO_ENABLED=0 на уровне workflow: CI собирает/тестирует только headless
  (ui_noui), не тянет Fyne/glfw и C-компилятор.
- timeout 120s -> 300s (worker один ~30-60s на быстрой машине).
- build-and-package: только linux/amd64 (headless). Windows-бинарь с UI — локально.

Локальная сборка UI + публикация:
- scripts/build-publish-ui.ps1: собирает ratatoskr-windows-amd64.exe (CGO_ENABLED=1,
  WinLibs gcc), вшивает commit-<sha7> + updateToken, пишет .version/.sha256 и
  публикует в Gitea Packages в ту же версию, что и CI; самопроверка (U4).
- scripts/.gitea-creds.example + .gitignore (scripts/.gitea-creds) — секреты не
  попадают в репозиторий.

README: CI=headless + публикация Windows-UI локальным скриптом; обновлён intro
(бинарь по умолчанию headless, окно — опционально с cgo).
2026-08-20 17:51:46 +05:00
27 changed files with 378 additions and 947 deletions

View File

@@ -14,6 +14,12 @@ concurrency:
group: ${{ gitea.workflow }}-${{ gitea.ref }}
cancel-in-progress: true
# CI собирает/тестирует ТОЛЬКО headless-вариант: приложение без графического окна
# (internal/app/ui_noui.go). UI (Fyne-окно) требует cgo и C-компилятора, поэтому
# собирается локально и публикуется скриптом scripts/build-publish-ui.ps1.
env:
CGO_ENABLED: '0'
jobs:
test:
runs-on: ubuntu-latest
@@ -22,11 +28,11 @@ jobs:
- uses: actions/setup-go@v5
with:
go-version: '1.23'
go-version: '1.25'
check-latest: true
- name: Run tests
run: go test ./... -v -count=1 -timeout 120s 2>&1
run: go test ./... -v -count=1 -timeout 300s 2>&1
- name: Vet
run: go vet ./...
@@ -34,27 +40,22 @@ jobs:
build-and-package:
if: always()
needs: test
strategy:
matrix:
goos: [linux, windows]
goarch: [amd64]
# Только linux: headless-бинарь для сервера. Windows-бинарь (с UI, cgo)
# публикуется локально через scripts/build-publish-ui.ps1.
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-go@v5
with:
go-version: '1.23'
go-version: '1.25'
check-latest: true
- name: Build binary
run: |
FILENAME="ratatoskr-${{ matrix.goos }}-${{ matrix.goarch }}"
if [ "${{ matrix.goos }}" = "windows" ]; then
FILENAME="${FILENAME}.exe"
fi
FILENAME="ratatoskr-linux-amd64"
VERSION="commit-$(echo '${{ gitea.sha }}' | cut -c1-7)"
GOOS=${{ matrix.goos }} GOARCH=${{ matrix.goarch }} \
GOOS=linux GOARCH=amd64 \
go build -ldflags="-s -w -X main.version=${VERSION} -X main.updateToken=${{ secrets.TC_UPDATE_TOKEN }}" -o "${FILENAME}" ./cmd/ratatoskr/
echo "FILENAME=${FILENAME}" >> "${GITEA_ENV}"
echo "VERSION=${VERSION}" >> "${GITEA_ENV}"

9
.gitignore vendored
View File

@@ -4,6 +4,12 @@
*.out
ratatoskr
# Publish companions (scripts/build-publish-ui.ps1)
ratatoskr-*.exe.sha256
ratatoskr-*.exe.version
ratatoskr-*.sha256
ratatoskr-*.version
# Go build/test artifacts
/testbin/
*.test
@@ -14,6 +20,9 @@ ratatoskr
!/.env.example
secrets/
# Local Gitea credentials for scripts/build-publish-ui.ps1
scripts/.gitea-creds
# Local config (not tracked — use config.yaml.example)
config.yaml

View File

@@ -1,12 +1,10 @@
# conventions
## Стиль / кодстайл
- Стандартный Go-стиль; `gofmt`/`go fmt ./...`. Документация-комментарии и
package-doc на русском языке.
- Типизация: строгие типы, интерфейсы для абстракций (Decider, ui.Store, events.Event, chat.Channel).
- Стандартный Go-стиль; гофм `gofmt`/`go fmt ./...`. Документация-комментарии и
package-doc на русском языке (в START-комментариях файлов и doc-комментариях).
- Типизация: строгие типы, интерфейсы для абстракций (Decider, LiveProber).
- Свой тип `config.Duration` для времени (YAML-строки "5s"/"10m"), метод `.Duration()`.
- UI: uni-directional data flow — UI читает снапшоты (копии, `ui.Store`), не мутирует storage/core.
Ядро публикует события в `events.Bus`, UI подписывается `events.Hub` → колбэки в UI-поток через `fyne.Do`.
## Обработка ошибок
- Ошибки классифицируются по идентификаторам классов в исходниках (см. ниже).
@@ -17,10 +15,9 @@
| Блок | Коды | Где |
|---|---|---|
| C | C1C4 | internal/config |
| A | A1A4 | internal/analyst; A (app): A1A4 в internal/app |
| A | A1A4 | internal/analyst |
| M | M1M5 | internal/chat |
| D | D1D5 | internal/core (ErrDecideFailed, ErrMaxTurns, ErrCommandUnknown…) |
| O | O1O5 | internal/opencode |
| O | O1O4 | internal/opencode |
| S | S1S5 | internal/storage |
| W | W1W5 | internal/worker |
| E | E1E4 | internal/worker (репозитории) |
@@ -28,16 +25,15 @@
| U | U1U6 | internal/update |
## Архитектурные конвенции
- **Composition root** — internal/app; подсистемы собираются там. UI-окно создаётся через
`newUIWindow(store)` (build-tag: cgo → desktop.New, !cgo → nil/headless). Флаг `--noui` выключает окно.
- **Слои:** model (домен) ← storage/events/UI зависят только от model; core не знает про UI.
- **Агенты** (analyst.md/dev.md/reviewer.md) — markdown-промпты, go:embed, распаковка в config_dir.
Вердикт — строгий JSON.
- **Composition root** — internal/app; подсистемы собираются там, лимиты Core
(MaxTurns=15, MaxConfirmCycles=3, MaxQuestionsPerTurn=5) в core.New.
- **Агенты** (analyst.md/dev.md/reviewer.md) — markdown-промпты, встроены через go:embed
(internal/agents/*.md + embed.go), распаковываются в config_dir. Вердикт — строгий JSON.
- Репо-клонирование/воркеры — через gitops; ветки задач `feat/<taskTag>` (см. mem:core).
- Обратная совместимость: поле `Repo` (одиночный) и `Repos` (список); EffectiveRepos/
SetReposFromDB/ReposJoined в storage/models.go.
## Версии
- `app.Version` — семантическая major.minor.patch (ручной инкремент: patch=фиксы,
minor=новая обратно-совместимая функциональность, major=несовместимые изменения). Сейчас 0.2.2.
minor=новая обратно-совместимая функциональность, major=несовместимые изменения).
- `main.version` (ldflag) — build-идентификатор `commit-<sha7>`, отдельно от app.Version.

View File

@@ -1,57 +1,70 @@
# core
Ratatoskr-go — оркестратор конвейера Ratatoskr (порт с Python на Go) в единый
бинарь. Субагенты (analyst/dev/reviewer) запускаются через внешний процесс
[opencode](https://opencode.ai) (v2 HTTP API). Интерфейсы: Telegram-бот + Fyne UI.
Linux — статический headless-бинарь (CGO_ENABLED=0); Windows — с Fyne-окном (cgo).
статический бинарь (CGO_ENABLED=0). Субагенты запускаются через внешний процесс
[opencode](https://opencode.ai). Взаимодействие — Telegram-бот.
## Структура (модули internal/)
```
cmd/ratatoskr/ точка входа; флаги: -config, -version, -noui (headless). main.version/updateToken вшиваются ldflag'ом
cmd/ratatoskr/ точка входа, сборка бинаря; main.version и main.updateToken вшиваются ldflag'ом
internal/
app/ composition root/DI: App.New -> config.Load+Validate, ResolveExePaths, storage, Runner, Analyst, Core, Worker, Updater, UI. packageOwner="kamelion", Version="0.2.2"
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
model/ доменные типы/контракты: Status + validTransitions (IsValidTransition/IsTerminal), TraceStatus. Нижний слой — не зависит от storage/events
chat/ мультиканальный Router; telegram — long-poll канал. Коды M1-M5
core/ state-machine задач + Decider/analyst интерфейс. Коды D3/D4
analyst/ аналитик: промпт + разбор JSON-вердикта (opencode agent). Коды A1-A4
events/ шина событий UI: Bus (buffered Sub/Pub), типизированный Hub, события TaskCreated/TaskStatusChanged/HistoryAppended/TraceAppended/AgentActivity, LogBus (панель «Логи»)
worker/ polling-планировщик + dev/reviewer-конвейер + gitops. Коды W*, E*, R*
agents/ встроенные opencode-агенты (analyst.md, dev.md, reviewer.md) через go:embed
opencode/ HTTP-клиент v2 API opencode serve, поллинг вердикта, LiveRegistry. Коды O1-O5
storage/ SQLite (modernc.org/sqlite, без CGO): tasks, traces, task_history. Коды S1-S5
update/ автообновление из Gitea Packages. Коды U1-U6
ui/ desktop-оболочка: Store-абстракция (копии), Commands (UI->Core), Controller (шины->View), View/Window интерфейсы
ui/desktop/ Fyne-реализация окна (build-tag cgo, --noui / нет cgo → headless)
scripts/ build-publish-ui.ps1 — локальная Windows-сборка Fyne-бинаря + публикация в Gitea
docs/ ui-spec.md — спека Fyne UI (слои, event-bus, fyne.Do/снапшоты)
```
## Ключевые инварианты
- **App.New-сигнатура:** `App.New(configPath, version, updateToken string, noUI bool)` (4-й параметр — headless; cgo-вариант собирается только при наличии C-компилятора).
- **UI:** окно — ещё одна реализация `chat.Channel` (присоединяется в Router). Core не трогает UI; обмен — событийная шина (events). Кнопка «Завершить» = полный выход (SetOnQuit→cancel→UI.Run возвращается); закрытие крестиком = сворачивание, Core живёт. UI собирается с `--noui`/без cgo.
- **Фазы аналитика (Decision.Phase):** `ask`, `propose`, `ready` (два последних обрабатываются одинаково в core), `abort`. Требования валидатора: ask — chat_reply/questions; propose — хотя бы одно изменённое поле; ready — без изменённых полей.
- **Статусы задач (internal/model):** draft→collecting→ready→approved→running→success/failed/timeout + cancelled/aborted/closed (терминальные). UserID — chat.ID (одна активная задача на чат).
- **Decider/Worker/Analyst/Reviewer:** Decider=analyst интерфейс; Worker — polling-планировщик; Reviewer проверяет diff dev-ветки (R1-R6), вердикт JSON {passed, critical_issues, solid_violations, comments}.
- **gitops (worker):** worktree-режим; feature-ветка `feat/<taskTag>` от origin/main; push через http.extraHeader, токен Bearer.
- **Пути «всё рядом с .exe»:** db/worktree резолвятся от ExeDir; config.yaml — рядом с бинарём, фоллбэк cwd.
- **Автообновление:** авто = только Check+уведомление; замена — по /update; версии в `commit-<sha7>/` (не `latest/`); Verify сверяет предprod-версию (binary+в.в) .
- **Команды/ядро:** 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.
## opencode (v2 HTTP API, >= 1.18.18)
- Интеграция с субагентами — через headless `opencode serve`, **v2 API** (`/api/*`). Версия opencode >= 1.18.18.
- **Хардпин модели:** при создании сессии читается top-level `model` из конфига opencode (`internal/opencode/config.go`, JSONC-стрип) и передаётся в `POST /api/session` как `{"model":{providerID,id}}`.
- **О5 WARN (устойчивость к v1-конфигу):** конфиг по старой схеме молча игнорируется v2; провайдер без api → unsupported модели → fallback. Ratatoskr не чинит сам, но логирует warning; фактическая модель ответа сравнивается с ожидаемой. Правильный v2-вид: `api:{type:"aisdk",package,url}`, `request.headers` вместо `options.headers`.
- **Поллинг вердикта:** `POST /api/session/:id/prompt` (durable admit) → `GET /api/session/:id/message?order=desc&limit=200` (новые assistant-сообщения, текст в `content[].type=="text"`) → завершение = `GET /api/session/active` без сессии + финальное assistant-сообщение, стабильное `settlePolls=2` опроса. `POST .../interrupt` вместо abort.
- Интеграция с субагентами — через headless `opencode serve`, **v2 API** (префикс `/api/*`).
Минимальная версия opencode **>= 1.18.18** (старый бинарь — только `/global/health`, не годится;
healthcheck падает с понятной ошибкой, класс O1).
- **Хардпин модели:** при создании сессии читается top-level `"model"` из конфига opencode
(`internal/opencode/config.go`, JSONC-стрип `//`/`/* */`/trailing-запятых) и передаётся в
`POST /api/session` как `{"model":{providerID,id}}` (разбор `provider/id` по первому `/`).
- **Класс O5 WARN (устойчивость к v1-конфигу):** конфиг по старой v1-схеме
(`provider.X.npm`/`options`) молча игнорируется v2 → провайдер без api → модель unsupported →
fallback. Раtatoskr не чинит это сам, но логирует warning: конфиг не читается/нет `model`,
и/или фактическая модель ответа (из assistant-сообщения) ≠ ожидаемой. Правильный v2-вид:
`api:{type:"aisdk",package,url}` и `request.headers` вместо `options.headers`.
- **Поллинг вердикта:** `POST /api/session/:id/prompt` (durable admit, неблокирующий) →
`GET /api/session/:id/message?order=desc&limit=200` (новые assistant-сообщения, текст в
`content[].type=="text"`) → завершение = `GET /api/session/active` без сессии + финальное
assistant-сообщение, стабильное `settlePolls=2` опроса. `POST .../interrupt` вместо abort.
- `ModelRef{ProviderID,ID,Variant}` — аналог v2 Model.Ref; `MinVersion="1.18.18"` в server.go.
## Контракты (не ломать)
- `App.New(configPath, version, updateToken string, noUI bool)` — сигнатура.
- `App.New(configPath, version, updateToken string)` — сигнатура.
- `packageOwner` — константа "kamelion" (не плодить vars/ldflag/конфиг).
- `update.Updater` — создаётся структурой `&update.Updater{...}`, конструктора нет.
- `ui.Store` — чтение-модель для UI: ListTasks/GetTask/GetHistory/GetTraces (копии, без ссылок на storage).
- `events.Bus`/`events.LogBus` — шина UI (см. internal/events). publisher-интерфейсы подключаются к Core/Worker.
см. также `mem:tech_stack`, `mem:conventions`, `mem:task_completion`, `mem:suggested_commands`.
См. также `mem:tech_stack`, `mem:conventions`, `mem:task_completion`, `mem:suggested_commands`.

View File

@@ -6,27 +6,22 @@
- `go fmt ./...` (или `make fmt`).
- `go build -o ratatoskr ./cmd/ratatoskr/` (или `make build`).
- `./ratatoskr -config config.yaml` (или `make run`).
- `./ratatoskr -version` — версия бинаря; `./ratatoskr -noui` — headless (без окна).
- Кросс-сборка: `make cross` (linux/amd64 + windows/amd64, headless).
## Windows / UI (Fyne)
- Сборка с UI (cgo): `powershell -ExecutionPolicy Bypass -File scripts/build-publish-ui.ps1`.
Требует `scripts/.gitea-creds` (не коммитить) и MinGW/gcc в PATH. См. `mem:toolchain/cgo-winlibs-gcc`.
- Обычная headless-сборка на Windows без cgo: `go build -o ratatoskr.exe ./cmd/ratatoskr/`.
- `./ratatoskr -version` показать версию бинаря.
- Кросс-сборка: `make cross` (linux/amd64 + windows/amd64).
## Go-тулчейн
Хост без `go` в PATH — экспорт вручную:
```
export PATH=/opt/data/.local/go/bin:$PATH
```
На машине разработки (Windows) — обычный system Go.
На машине разработки (Windows, cmd) — обычный system Go.
## git (worktree-процесс Ratatoskr)
- Feature-ветка: `feat/<taskTag>`, база — `origin/main`. Проверка diff всей ветки:
- Feature-ветка: `feat/<taskTag>`, база — `origin/main`. Пример проверки diff всей ветки:
`git diff origin/main...HEAD`.
- Проверить состав отслеживаемых файлов (например наличие .serena): `git ls-files`.
- Статус: `git status`. Лог: `git log --oneline -10`.
## Замечания про среду
- ОС Windows + PowerShell 5.1 (shell: powershell) — нет `&&`; использовать `;`/`if ($?) {}`;
`&` для вызова путей с пробелами. Для серенных файлов лучше отдельная команда `serena memories check`.
- ОС Windows + PowerShell 5.1 (shell: powershell) — команды собирать/запускать с учётом
этом (нет `&&`; использовать `;`/`if ($?) {}`; & для путей с пробелами).

View File

@@ -6,10 +6,9 @@
2. **Тесты:** `go test ./... -v -count=1 -timeout 120s` — все проходят (`make test`).
3. **Статический анализ:** `go vet ./...` — чисто (`make vet`).
4. **Сборка:** `go build -o ratatoskr ./cmd/ratatoskr/` (`make build`) — компилируется.
- UI-сборка (cgo+Fyne) проверяется отдельно (`scripts/build-publish-ui.ps1` или `go build` с MinGW);
headless-сборка cgo-пакетов (`internal/ui/desktop`) — только typecheck.
(Кросс-сборка `make cross` — только при необходимости.)
5. **Пересмотр контрактов:** если менялась сигнатура `App.New(configPath, version,
updateToken string, noUI bool)` — обновить все вызовы (app_test.go, main.go).
updateToken string)` — обновить вызовы в `internal/app/app_test.go` (иначе go vet падает).
6. Коммит осмысленными атомарными коммитами в feature-ветку `feat/<taskTag>` от origin/main.
Рабочий процесс Ratatoskr (агент dev в этом конвейере): изучить код, реализовать так, чтобы

View File

@@ -1,32 +1,32 @@
# tech_stack
## Язык / рантайм
- Go **1.25.0** (go.mod `go 1.25.0`, module `github.com/kamelion/ratatoskr-go`).
- Headless-сборка статический бинарь `CGO_ENABLED=0`. Windows-сборка с UI — cgo (Fyne/GLFW) + MinGW-w64/gcc.
- Локальный Go-тулчейн на хосте: `export PATH=/opt/data/.local/go/bin:$PATH` (go1.25.0 linux/amd64). На Windows — обычный system Go.
- Go **1.25.0** (go.mod `go 1.25.0`). Модуль `github.com/kamelion/ratatoskr-go`.
- Сборка: статический бинарь, `CGO_ENABLED=0`. Локальный Go-тулчейн на хосте:
`export PATH=/opt/data/.local/go/bin:$PATH` (go1.25.0 linux/amd64).
## Основные зависимости (go.mod)
- `fyne.io/fyne/v2 v2.6.0` — desktop UI (cgo/GLFW; платформа Windows + Linux). Не собирается в CI (headless).
- `gopkg.in/yaml.v3 v3.0.1` — парсинг config.yaml.
- `modernc.org/sqlite v1.56.0` — SQLite без CGO (чистый Go).
- (indirect) google/uuid, go-humanize, go-text/typesetting, x/sys, x/net, modernc.org/libc и пр.
- (indirect) google/uuid, go-humanize, mattn/go-isatty, x/sys, modernc.org/libc/mathutil/memory.
## Внешние процессы
- **opencode** (opencode.ai) — субагенты (analyst/dev/reviewer). Управляется через internal/opencode (Runner, Pool, LiveRegistry). Требуемая версия **>= 1.18.18** (v2 HTTP API `/api/*`).
- Настройки в конфиге: `opencode.bin / config / config_dir / hard_timeout / idle_timeout / poll_ms` + `opencode.server` (hostname, port, password).
- Подробно — `mem:core`.
- **opencode** (opencode.ai) — внешний процесс для субагентов (analyst/dev/reviewer).
Управляется через internal/opencode (Runner, LiveRegistry). Настраивается в конфиге
(opencode.bin / config / config_dir / hard_timeout / idle_timeout / poll_ms).
Требуемая версия opencode: **>= 1.18.18** (v2 HTTP API `/api/*`; хардпин model из конфига —
`internal/opencode/config.go`, классы O1/O5). Подробно — `mem:core`.
## Сборка / Makefile
- `make build` — go build `-ldflags="-s -w -X main.version=commit-<sha7> -X main.updateToken=..." -o ratatoskr ./cmd/ratatoskr/`.
- `make test``go test ./... -v -count=1 -timeout 120s`.
- `make vet``go vet ./...`; `make fmt``go fmt ./...`.
- `make run` — build + `./ratatoskr -config config.yaml`.
- `make cross` — linux/amd64 + windows/amd64 (headless, БЕЗ Fyne-UI; для UI нужен cgo).
- **Fyne-UI (Windows) собирается вручную** на машине с MinGW:
`scripts/build-publish-ui.ps1` (cgo) — сборка + публикация в Gitea в версию `commit-<sha7>`.
Требует `scripts/.gitea-creds` (git-ignored) и gcc в PATH. См. `mem:toolchain/cgo-winlibs-gcc`.
- `make build` — go build -ldflags="-s -w -X main.version=commit-<sha7> -X main.updateToken=..." -o ratatoskr ./cmd/ratatoskr/.
- `make test` — go test ./... -v -count=1 -timeout 120s.
- `make vet` — go vet ./... `make fmt` — go fmt ./...
- `make run` — build + ./ratatoskr -config config.yaml.
- `make cross` кросс-сборка linux/amd64 + windows/amd64 (ratatoskr-windows-amd64.exe — Windows-машина Камиля).
- GIT_SHA вшивается в main.version; UPDATE_TOKEN — в main.updateToken (секрет только у CI).
## CI (.gitea/workflows/ci.yaml)
- Job `test`: `go test ./...` + `go vet ./...` (setup-go '1.23', check-latest).
- Job `build-and-package` (matrix linux/amd64 + windows/amd64): собирает headless-бинарь с ldflag update_token, публикует на `main` в версию `commit-<sha7>/` (+ companion `.version`/`.sha256`).
- Секреты: `TC_GITEA_TOKEN` (write:packages), `TC_UPDATE_TOKEN` (read:package), vars `GIT_MAIN_URL`.
- Job `test`: go test ./... + go vet ./....
- Job `build-and-package` (matrix linux/amd64+windows/amd64): собирает и публикует в
Gitea Packages на `main` в версию `commit-<sha7>/` + companion-файлы `.version`/`.sha256`.
- Секреты: TC_GITEA_TOKEN (write:packages), TC_UPDATE_TOKEN (read:package), GIT_MAIN_URL.

View File

@@ -1,13 +1,23 @@
# cgo/winlibs-gcc
# C-тулчейн для cgo-сборки (Fyne/GLFW) на этой машине
## MinGW/WinLibs для Fyne-сборки на Windows
- UI (internal/ui/desktop, fyne.io/fyne/v2) требует cgo + C-компилятор для GLFW.
- Используется **WinLibs** (mingw64) gcc. Bin каталог нужно добавить в PATH перед
`scripts/build-publish-ui.ps1`:
```powershell
$p = "<...>\mingw64\bin"; $env:Path = "$p;$env:Path"
```
- Проверка: `gcc --version`; также убедиться, что `CGO_ENABLED` не = "0".
- Care: не использовать Cygwin/MSYS-сборки gcc — только native MinGW-w64 (WinLibs).
- Сборка UI выполняется локально на Windows-машине, публикуется в Gitea Packages
в в версию `commit-<sha7>` со companion-.version/.sha256 (контракт U4) — см. скрипт и `mem:tech_stack`.
WinLibs (BrechtSanders.WinLibs.POSIX.UCRT) установлен через winget как
portable (zip) в:
`C:\Users\darkg\AppData\Local\Microsoft\WinGet\Packages\BrechtSanders.WinLibs.POSIX.UCRT_Microsoft.Winget.Source_8wekyb3d8bbwe\mingw64\bin`
- gcc 16.1.0, target `x86_64-w64-mingw32`, рантайм `x86_64-ucrt-posix-seh`.
- Установлен портативно — НЕ регистрируется в PATH автоматически.
- PATH добавлен в `HKCU\Environment` (WinLibs bin первым), но в новых
PowerShell-процессах opencode окружение НЕ перечитывается, поэтому в каждой
команде, где нужен cgo, добавлять вручную:
$p = "...\mingw64\bin"; $env:Path = "$p;$env:Path"; $env:CGO_ENABLED = "1"
Важно: на машине есть clang-msvc/i686 (D:\Program Files\LLVM, D:\Program
Files (x86)\LLVM) — он НЕ подходит для cgo (msvc-таргет + 32bit). Поэтому
gcc должен идти первым в PATH.
Для сборки окна: `CGO_ENABLED=1 go build ./...` (компилирует ui_cgo.go и
internal/ui/desktop). Без cgo окно не собирается — приложение headless
(ui_noui.go), флаг `--noui` в cmd/ratatoskr/main.go.
Для запуска GUI нужен реальный TG-конфиг (telegram.token/chat_id), иначе app
падает на init.

View File

@@ -3,7 +3,9 @@
Ratatoskr на Go — **оркестратор в единый статический бинарь** + субагенты через
[opencode](https://opencode.ai) как внешний процесс. Переезд с Python-версии:
все подсистемы (диалог, воркер, автообновление) собраны в один исполняемый
файл без runtime-зависимостей (`CGO_ENABLED=0`), что упрощает доставку и деплой.
файл, что упрощает доставку и деплой. Бинарь по умолчанию headless
(`CGO_ENABLED=0`); графическое окно (Fyne) — опционально, собирается с cgo
(только локально, см. «Локальная сборка UI-бинаря»).
## Структура
@@ -58,10 +60,40 @@ GOFLAGS ?= -ldflags="-s -w -X main.version=commit-$(GIT_SHA) -X main.updateToken
- `main.updateToken` = токен read:package для автообновления (см. ниже). Если не задан
(`UPDATE_TOKEN ?= ""`) — пустая встройка, тогда обновление берёт `update.token` из конфига.
**Обычный `make build`/`make cross` окно НЕ включает** — Fyne-окно требует cgo и
C-компилятора. Headless-бинарь (без окна) собирается и в CI, и локально; UI-бинарь
с окном — только локально (см. ниже).
### Локальная сборка UI-бинаря (Windows, Fyne-окно) + публикация в Gitea
CI headless: `CGO_ENABLED=0` и публикует только `ratatoskr-linux-amd64`
(см. `.gitea/workflows/ci.yaml`). Windows-бинарь с окном собирается на Windows-машине
и публикуется скриптом:
```bash
# 1) Секреты (git-ignored): скопировать и заполнить
cp scripts/.gitea-creds.example scripts/.gitea-creds
# GITEA_TOKEN=write:packages-токен
# UPDATE_TOKEN=read:package-токен
# GIT_MAIN_URL=http://gitea.hal9000.home
# 2) Убедиться, что gcc (MinGW) в PATH и CGO_ENABLED=1 — см. память
# `mem:toolchain/cgo-winlibs-gcc`
# 3) Запустить (HEAD должен быть тем коммитом, что в main):
powershell -ExecutionPolicy Bypass -File scripts/build-publish-ui.ps1
```
Скрипт собирает `ratatoskr-windows-amd64.exe` с `-X main.version=commit-<sha7>` и
`-X main.updateToken=...`, пишет companion-файлы `.version`/`.sha256` и публикует все
три в `.../generic/ratatoskr/commit-<sha7>/`. В конце сам перечитывает `.sha256`/`.version`
из Gitea и сверяет (контракт U4) — как проверка в разделе «Валидация опубликованной версии».
**Как на самом деле публикуется рабочий бинарь:** локальный `go build` токен НЕ вшивает
(значение секрета есть только у CI). Запушь `main` CI (см. ниже) сам соберёт оба бинаря
со вшитым `TC_UPDATE_TOKEN` и загрузит их в Gitea Packages. Так соблюдён least-privilege:
read-токен не светится на хосте разработки.
(значение секрета есть только у CI и в git-ignored `scripts/.gitea-creds`). Запушь `main`
CI сам соберёт headless-linux со вшитым `TC_UPDATE_TOKEN` и загрузит его в Gitea Packages;
Windows-бинарь с UI публикуется локальным скриптом (токен read:package в `scripts/.gitea-creds`).
Так соблюдён least-privilege: read-токен не светится в репозитории/на хосте CI.
### Проверки перед сборкой
@@ -78,13 +110,17 @@ make run # build + ./ratatoskr -config config.yaml
## CI (.gitea/workflows/ci.yaml)
- **Job `test`**: checkout → setup-go → `go test ./...``go vet ./...`.
- **Job `build-and-package`** (matrix linux/amd64 + windows/amd64, без артефактов):
собирает бинарь со вшитым `-X main.updateToken=${secrets.TC_UPDATE_TOKEN}` и
- **Job `test`**: checkout → setup-go 1.25 `go test ./...``go vet ./...`.
Работает в headless-режиме (`CGO_ENABLED=0`, без Fyne/glfw).
- **Job `build-and-package`** (linux/amd64, без артефактов): собирает **headless**-бинарь
`ratatoskr-linux-amd64` со вшитым `-X main.updateToken=${secrets.TC_UPDATE_TOKEN}` и
**публикует в Gitea Packages** — только на `main`, сразу в версию `commit-<sha7>/`
(псевдо-версия `latest` НЕ используется — см. автообновление). Плюс companion-файлы
`<file>.version` и `<file>.sha256`.
**Windows-бинарь с UI в CI НЕ собирается** (нужен cgo + C-компилятор). Он собирается
и публикуется локально скриптом `scripts/build-publish-ui.ps1` (см. «Локальная сборка UI-бинаря»).
Секреты/vars: `TC_GITEA_TOKEN` (write:packages), `TC_UPDATE_TOKEN` (read:package),
`GIT_MAIN_URL`.
@@ -199,9 +235,12 @@ update:
### Как опубликовать новую версию
1. Внеси правки, коммитни, запуши в `main`.
2. CI соберёт оба бинаря со вшитым `TC_UPDATE_TOKEN` и опубликует в
2. CI соберёт `ratatoskr-linux-amd64` (headless) со вшитым `TC_UPDATE_TOKEN` и опубликует в
`.../generic/ratatoskr/commit-<sha7>/` (бинарь + `.version` + `.sha256`).
3. На обновляемой машине: бот сам уведомит о новой версии → `/update`.
3. Если в этой версии есть изменения UI — дополнительно собрать и опубликовать
Windows-бинарь с окном: `scripts/build-publish-ui.ps1` (добавит
`ratatoskr-windows-amd64.exe` в ту же версию).
4. На обновляемой машине: бот сам уведомит о новой версии → `/update`.
Проверку автообновления после публикации гоняет владелец на своей
Windows-машине (не прогоняется агентом).

View File

@@ -157,83 +157,6 @@
приложение работает headless (UI=nil). Реальное окно полноценно проверяется
на машине с MinGW-w64/gcc (`go build -ldflags ...`), здесь — только typecheck.
### 12.8. Структура UI-кода: компоненты-виджеты (рефакторинг)
`internal/ui` (без Fyne) — контракты + Nil-реализации + юнит-тесты. Fyne-код —
только в `internal/ui/desktop/*`, один файл — одна панель. `desktop/window.go`
становится чистой компоновкой.
Каждый компонент:
- **интерфейс** в `internal/ui/<panel>.go` (контракт для тестов/headless);
- **Nil-реализация** в том же файле (headless/тесты);
- **Fyne-реализация** в `internal/ui/desktop/<panel>.go`.
### 12.9. Контракт виджета «Логи» (LogPanel)
Панель «Логи» — поток системных логов (сырые строки из `events.LogLine`).
- `Append(text)` — добавить строку лога; при превышении лимита старые строки
отбрасываются (буфер ограничен, не расти бесконечно).
- Контейнер виджета — отдаётся окну для встраивания в таб «Логи» (Scroll).
- Обновление содержимого — на потоке Fyne (внутри панели `fyne.Do`), не из
горутины Hub.
### 12.10. Контракт виджета «Список задач» (TaskListPanel)
Список задач — левая панель окна: все задачи (`storage.Task`) строками.
- `SetTasks(tasks)` — заменить снимок списка и перерисовать виджет. Данные —
копии из Store (спец 12.5).
- `OnSelect(fn)` — колбэк клика по строке; окно грузит детали выбранной задачи
(это `task_detail`, отдельный компонент). Состояние выбора живёт в окне.
- Выбранная строка подсвечивается (`Select`/`Unselect`), окно управляет ею.
- Строка = `taskTitle(t)` (pure-функция, тестируется без Fyne).
- Обновление — на потоке Fyne; вызывающий уже внутри `fyne.Do`, панель сама
виджет не трогает из горутин Hub.
### 12.11. Контракт виджета «Детали задачи» (TaskDetailPanel)
Детали выбранной задачи — верх `right`-сплита: заголовок, статус, детали
(цель + репозитории).
- `ShowTask(t)` — рендер из снимка `storage.Task`: заголовок (bold), статус
(italic), детали = `TaskDetailText(t)`.
- `ShowEmpty()`сброс к placeholder («—» / пусто) при недоступной задаче.
- Строка деталей = pure `TaskDetailText(t)` (цель + репо), тестируется без Fyne.
- Обновление — на потоке Fyne; вызывающий уже внутри `fyne.Do`.
- Диалог и «Состояние» — отдельные панели (chat_panel, state_panel), здесь
не участвуют; окно оркестрирует загрузку всех панелей по выбору задачи.
### 12.12. Контракт виджета «Диалог» (ChatPanel)
Диалог — транскрипт общения с выбранной задачей + композитор (поле ввода и
кнопки команд).
- Транскрипт:
- `SetTranscript(text)` — полный рендер истории выбранной задачи;
- `Append(text)` — добавить строку; при превышении лимита старые строки
отбрасываются (буфер ограничен);
- `Clear()` — очистить при недоступной задаче.
- Композитор: поле ввода + кнопки команд, подключённые к `ui.Commands` через
`SetCommands(c)` (ввод → `SendText`, кнопки → Start/Approve/Skip/Cancel).
- Доставка: окно (как chat.Channel) рендерит `Send`/`Ask`/историю через
`Append`; строка роли = pure `FormatRole(role)` (👤/🤖).
- Обновление — на потоке Fyne; вызывающий уже внутри `fyne.Do`.
### 12.13. Контракт виджета «Состояние» (StatePanel)
Панель «Состояние» — агенты + трейсы выбранной задачи: снимок и live-строки.
- `SetText(text)` — полный рендер снимка трасс выбранной задачи.
- `Append(text)` — добавить строку; при превышении лимита старые строки
отбрасываются (буфер ограничен).
- Строка снимка = pure `StateText(traces)` (агент: статус, session).
- Live-строки (чистые хелперы, окно зовёт `Append` с готовой строкой):
- `TraceLine(agent, status)` — добавлен/обновлён трейс субагента;
- `ActivityLine(agent, stage)` — смена этапа агента;
- `TaskStatusText(e)` — изменение статуса задачи (бейдж + ID).
- Обновление — на потоке Fyne; вызывающий уже внутри `fyne.Do`.
---
## Открытые пункты (TODO)

View File

@@ -1,39 +0,0 @@
package ui
// ChatPanel — панель «Диалог» (спец 12.12): транскрипт диалога выбранной
// задачи + композитор (поле ввода и кнопки команд).
//
// Транскрипт — буфер ограниченного размера; при превышении лимита старые
// строки отбрасываются. Композитор подключается к ui.Commands через
// SetCommands. Обновление — на потоке Fyne; вызывающий уже внутри fyne.Do.
type ChatPanel interface {
// SetTranscript заменяет содержимое диалога полным рендером.
SetTranscript(text string)
// Append добавляет строку в диалог (буфер ограничен).
Append(text string)
// Clear очищает диалог (задача недоступна/не выбрана).
Clear()
// SetCommands подключает команды к композитору (ввод + кнопки).
SetCommands(c *Commands)
}
// NilChatPanel — no-op реализация ChatPanel для headless-режима и тестов.
type NilChatPanel struct{}
// NewNilChatPanel создаёт NilChatPanel.
func NewNilChatPanel() *NilChatPanel { return &NilChatPanel{} }
func (NilChatPanel) SetTranscript(string) {}
func (NilChatPanel) Append(string) {}
func (NilChatPanel) Clear() {}
func (NilChatPanel) SetCommands(*Commands) {}
// FormatRole — строка роли в диалоге (pure-функция, спец 12.12).
func FormatRole(role string) string {
switch role {
case "user":
return "👤 "
default:
return "🤖 "
}
}

View File

@@ -1,26 +0,0 @@
package ui
import "testing"
// FormatRole — строка роли в диалоге (спец 12.12), pure-функция без Fyne.
func TestFormatRole(t *testing.T) {
if FormatRole("user") != "👤 " {
t.Errorf("user: got %q, want «👤 »", FormatRole("user"))
}
if FormatRole("assistant") != "🤖 " {
t.Errorf("assistant: got %q, want «🤖 »", FormatRole("assistant"))
}
if FormatRole("") != "🤖 " {
t.Errorf("default: got %q, want «🤖 »", FormatRole(""))
}
}
// NilChatPanel — no-op контракт (спец 12.8): безопасно для headless/тестов.
func TestNilChatPanelNoop(t *testing.T) {
p := NewNilChatPanel()
c := NewCommands(nil)
p.SetTranscript("история")
p.Append("строка")
p.Clear()
p.SetCommands(c)
}

View File

@@ -1,87 +0,0 @@
//go:build cgo
package desktop
import (
"strings"
"fyne.io/fyne/v2"
"fyne.io/fyne/v2/container"
"fyne.io/fyne/v2/widget"
"github.com/kamelion/ratatoskr-go/internal/ui"
)
// chatLimit — обрезка буфера транскрипта диалога (спец 12.12).
const chatLimit = 200_000
// ChatPanel — Fyne-реализация ui.ChatPanel (спец 12.8, 12.12): транскрипт
// диалога + композитор (поле ввода и кнопки команд).
type ChatPanel struct {
convLbl *widget.Label
input *widget.Entry
commands *ui.Commands
}
// NewChatPanel создаёт ChatPanel.
func NewChatPanel() *ChatPanel {
p := &ChatPanel{}
p.convLbl = widget.NewLabel("Выберите задачу.")
p.convLbl.Wrapping = fyne.TextWrapWord
p.input = widget.NewEntry()
p.input.SetPlaceHolder("Сообщение… (Enter — отправить)")
return p
}
// Transcript возвращает виджет транскрипта (Scroll) для встраивания в окно.
func (p *ChatPanel) Transcript() fyne.CanvasObject {
return container.NewScroll(p.convLbl)
}
// Composer возвращает виджет композитора (ввод + кнопки команд).
func (p *ChatPanel) Composer() fyne.CanvasObject {
cmdBar := container.NewHBox(
widget.NewButton("Новая", func() { if p.commands != nil { p.commands.Start() } }),
widget.NewButton("Создавай", func() { if p.commands != nil { p.commands.Approve() } }),
widget.NewButton("Пропустить", func() { if p.commands != nil { p.commands.Skip() } }),
widget.NewButton("Отмена", func() { if p.commands != nil { p.commands.Cancel() } }),
)
return container.NewBorder(nil, nil, cmdBar, p.input, nil)
}
// SetTranscript заменяет содержимое диалога (спец 12.12).
func (p *ChatPanel) SetTranscript(text string) {
p.convLbl.SetText(text)
}
// Append добавляет строку в диалог (буфер ограничен).
func (p *ChatPanel) Append(text string) {
s := p.convLbl.Text + text + "\n\n"
if len(s) > chatLimit {
s = s[len(s)-chatLimit:]
}
p.convLbl.SetText(s)
}
// Clear очищает диалог.
func (p *ChatPanel) Clear() {
p.convLbl.SetText("")
}
// SetCommands подключает команды к композитору.
func (p *ChatPanel) SetCommands(c *ui.Commands) {
p.commands = c
p.input.OnSubmitted = func(s string) {
s = strings.TrimSpace(s)
if s == "" {
return
}
p.input.SetText("")
if c != nil {
c.SendText(s)
}
}
}
// compile-time проверка реализации контракта.
var _ ui.ChatPanel = (*ChatPanel)(nil)

View File

@@ -1,49 +0,0 @@
//go:build cgo
package desktop
import (
"fyne.io/fyne/v2"
"fyne.io/fyne/v2/container"
"fyne.io/fyne/v2/widget"
"github.com/kamelion/ratatoskr-go/internal/ui"
)
// LogPanel — Fyne-реализация ui.LogPanel (спец 12.8, 12.9): поток системных логов.
//
// Внутри — widget.Label с ограниченным буфером (maxLogLen); Append обрезает
// строку до лимита. Вызовы Append приходят из горутин Hub, поэтому обновление
// виджета выполняется через fyne.Do (на потоке Fyne).
type LogPanel struct {
label *widget.Label
}
// maxLogLen — обрезка буфера панели «Логи», чтобы не расти бесконечно.
const maxLogLen = 200_000
// NewLogPanel создаёт LogPanel.
func NewLogPanel() *LogPanel {
l := widget.NewLabel("")
l.Wrapping = fyne.TextWrapWord
return &LogPanel{label: l}
}
// Widget возвращает контейнер панели для встраивания в окно (таб «Логи»).
func (p *LogPanel) Widget() fyne.CanvasObject {
return container.NewScroll(p.label)
}
// Append добавляет строку лога (спец 12.9), с ограничением буфера.
func (p *LogPanel) Append(text string) {
fyne.Do(func() {
s := p.label.Text + text + "\n"
if len(s) > maxLogLen {
s = s[len(s)-maxLogLen:]
}
p.label.SetText(s)
})
}
// compile-time проверка реализации контракта.
var _ ui.LogPanel = (*LogPanel)(nil)

View File

@@ -1,50 +0,0 @@
//go:build cgo
package desktop
import (
"fyne.io/fyne/v2"
"fyne.io/fyne/v2/container"
"fyne.io/fyne/v2/widget"
"github.com/kamelion/ratatoskr-go/internal/ui"
)
// stateLimit — обрезка буфера панели «Состояние» (спец 12.13).
const stateLimit = 200_000
// StatePanel — Fyne-реализация ui.StatePanel (спец 12.8, 12.13): агенты и
// трейсы выбранной задачи (таб «Состояние»).
type StatePanel struct {
stateLbl *widget.Label
}
// NewStatePanel создаёт StatePanel.
func NewStatePanel() *StatePanel {
p := &StatePanel{}
p.stateLbl = widget.NewLabel("")
p.stateLbl.Wrapping = fyne.TextWrapWord
return p
}
// Widget возвращает контейнер панели для встраивания в таб «Состояние».
func (p *StatePanel) Widget() fyne.CanvasObject {
return container.NewScroll(p.stateLbl)
}
// SetText заменяет содержимое снимком трасс (спец 12.13).
func (p *StatePanel) SetText(text string) {
p.stateLbl.SetText(text)
}
// Append добавляет live-строку (буфер ограничен).
func (p *StatePanel) Append(text string) {
s := p.stateLbl.Text + text + "\n"
if len(s) > stateLimit {
s = s[len(s)-stateLimit:]
}
p.stateLbl.SetText(s)
}
// compile-time проверка реализации контракта.
var _ ui.StatePanel = (*StatePanel)(nil)

View File

@@ -1,54 +0,0 @@
//go:build cgo
package desktop
import (
"fyne.io/fyne/v2"
"fyne.io/fyne/v2/container"
"fyne.io/fyne/v2/widget"
"github.com/kamelion/ratatoskr-go/internal/storage"
"github.com/kamelion/ratatoskr-go/internal/ui"
)
// TaskDetailPanel — Fyne-реализация ui.TaskDetailPanel (спец 12.8, 12.11):
// детали выбранной задачи (заголовок, статус, детали) — верх right-сплита.
type TaskDetailPanel struct {
titleLbl *widget.Label
statusLbl *widget.Label
detailLbl *widget.Label
}
// NewTaskDetailPanel создаёт TaskDetailPanel.
func NewTaskDetailPanel() *TaskDetailPanel {
p := &TaskDetailPanel{}
p.titleLbl = widget.NewLabel("—")
p.titleLbl.TextStyle = fyne.TextStyle{Bold: true}
p.statusLbl = widget.NewLabel("")
p.statusLbl.TextStyle = fyne.TextStyle{Italic: true}
p.detailLbl = widget.NewLabel("")
p.detailLbl.Wrapping = fyne.TextWrapWord
return p
}
// Widget возвращает контейнер панели для встраивания в окно (верх right-сплита).
func (p *TaskDetailPanel) Widget() fyne.CanvasObject {
return container.NewVBox(p.titleLbl, p.statusLbl, p.detailLbl)
}
// ShowTask рендерит детали из снимка задачи (спец 12.11).
func (p *TaskDetailPanel) ShowTask(t storage.Task) {
p.titleLbl.SetText(t.Title)
p.statusLbl.SetText(string(t.Status))
p.detailLbl.SetText(ui.TaskDetailText(t))
}
// ShowEmpty сбрасывает к placeholder при недоступной задаче.
func (p *TaskDetailPanel) ShowEmpty() {
p.titleLbl.SetText("—")
p.statusLbl.SetText("")
p.detailLbl.SetText("")
}
// compile-time проверка реализации контракта.
var _ ui.TaskDetailPanel = (*TaskDetailPanel)(nil)

View File

@@ -1,78 +0,0 @@
//go:build cgo
package desktop
import (
"fyne.io/fyne/v2"
"fyne.io/fyne/v2/widget"
"github.com/kamelion/ratatoskr-go/internal/storage"
"github.com/kamelion/ratatoskr-go/internal/ui"
)
// TaskListPanel — Fyne-реализация ui.TaskListPanel (спец 12.8, 12.10): список
// задач (левая панель окна).
//
// Внутри — widget.List над собственным буфером []storage.Task (снимки из Store).
// Состояние выбора живёт в окне: окно зовёт Select, чтобы подсветить строку.
type TaskListPanel struct {
list *widget.List
tasks []storage.Task
}
// NewTaskListPanel создаёт TaskListPanel.
func NewTaskListPanel() *TaskListPanel {
p := &TaskListPanel{}
p.list = widget.NewList(
func() int { return len(p.tasks) },
func() fyne.CanvasObject {
return widget.NewLabel("loading…")
},
func(id widget.ListItemID, o fyne.CanvasObject) {
if id < 0 || id >= len(p.tasks) {
return
}
o.(*widget.Label).SetText(ui.TaskTitle(p.tasks[id]))
},
)
return p
}
// Widget возвращает виджет списка для встраивания в окно (левая панель).
func (p *TaskListPanel) Widget() fyne.CanvasObject {
return p.list
}
// SetTasks заменяет снимок списка и перерисовывает виджет (спец 12.10).
func (p *TaskListPanel) SetTasks(tasks []storage.Task) {
p.tasks = tasks
p.list.Refresh()
}
// Select подсвечивает строку задачи id; если её нет — снимает выделение.
func (p *TaskListPanel) Select(id int64) {
idx := -1
for i, t := range p.tasks {
if t.ID == id {
idx = i
break
}
}
if idx < 0 {
p.list.UnselectAll()
return
}
p.list.Select(widget.ListItemID(idx))
}
// OnSelect регистрирует колбэк клика по строке (спец 12.10).
func (p *TaskListPanel) OnSelect(fn func(id int64)) {
p.list.OnSelected = func(id widget.ListItemID) {
if fn != nil && id >= 0 && id < len(p.tasks) {
fn(p.tasks[id].ID)
}
}
}
// compile-time проверка реализации контракта.
var _ ui.TaskListPanel = (*TaskListPanel)(nil)

View File

@@ -10,6 +10,7 @@ import (
"context"
"log"
"strings"
"sync"
"fyne.io/fyne/v2"
"fyne.io/fyne/v2/app"
@@ -19,10 +20,13 @@ import (
"github.com/kamelion/ratatoskr-go/internal/chat"
"github.com/kamelion/ratatoskr-go/internal/events"
"github.com/kamelion/ratatoskr-go/internal/model"
"github.com/kamelion/ratatoskr-go/internal/storage"
"github.com/kamelion/ratatoskr-go/internal/ui"
)
const (
maxLogLen = 200_000 // обрезка буферов панелей, чтобы не расти бесконечно
selectedPref = "task.selected"
splitHPref = "split.h"
splitVPref = "split.v"
@@ -37,15 +41,20 @@ type Window struct {
handler chat.Handler
// состояние выбора (живёт в окне, спец 12.10)
// состояние списка
mu sync.Mutex // защищает tasks
tasks []storage.Task
selected int64
// виджеты
taskList *TaskListPanel
detail *TaskDetailPanel
chat *ChatPanel
state *StatePanel
logs *LogPanel
list *widget.List
titleLbl *widget.Label
statusLbl *widget.Label
detailLbl *widget.Label
convLbl *widget.Label
logsLbl *widget.Label
stateLbl *widget.Label
input *widget.Entry
hsplit *container.Split
vsplit *container.Split
@@ -78,18 +87,48 @@ func (w *Window) SetOnQuit(fn func()) { w.onQuit = fn }
// build собирает виджеты и раскладку.
func (w *Window) build() {
w.detail = NewTaskDetailPanel()
w.titleLbl = widget.NewLabel("—")
w.titleLbl.TextStyle = fyne.TextStyle{Bold: true}
w.statusLbl = widget.NewLabel("")
w.statusLbl.TextStyle = fyne.TextStyle{Italic: true}
w.detailLbl = widget.NewLabel("")
w.detailLbl.Wrapping = fyne.TextWrapWord
w.chat = NewChatPanel()
w.chat.SetCommands(w.commands)
w.convLbl = widget.NewLabel("Выберите задачу.")
w.convLbl.Wrapping = fyne.TextWrapWord
w.state = NewStatePanel()
w.logsLbl = widget.NewLabel("")
w.logsLbl.Wrapping = fyne.TextWrapWord
w.logs = NewLogPanel()
w.stateLbl = widget.NewLabel("")
w.stateLbl.Wrapping = fyne.TextWrapWord
// Список задач (слева)
w.taskList = NewTaskListPanel()
w.taskList.OnSelect(func(id int64) { w.selectTask(id) })
w.list = widget.NewList(
func() int { w.mu.Lock(); defer w.mu.Unlock(); return len(w.tasks) },
func() fyne.CanvasObject {
return widget.NewLabel("loading…")
},
func(id widget.ListItemID, o fyne.CanvasObject) {
w.mu.Lock()
defer w.mu.Unlock()
if id < 0 || id >= len(w.tasks) {
return
}
t := w.tasks[id]
o.(*widget.Label).SetText(taskTitle(t))
},
)
w.list.OnSelected = func(id widget.ListItemID) {
w.mu.Lock()
if id < 0 || id >= len(w.tasks) {
w.mu.Unlock()
return
}
t := w.tasks[id]
w.mu.Unlock()
w.selectTask(t.ID)
}
quitBtn := widget.NewButtonWithIcon("Завершить", theme.LogoutIcon(), func() {
w.saveLayout()
@@ -97,23 +136,42 @@ func (w *Window) build() {
w.onQuit()
}
})
left := container.NewBorder(nil, quitBtn, nil, nil, w.taskList.Widget())
left := container.NewBorder(nil, quitBtn, nil, nil, w.list)
// Рабочая область: детали сверху, диалог снизу (сплит 2×2 в плане).
details := w.detail.Widget()
details := container.NewVBox(w.titleLbl, w.statusLbl, w.detailLbl)
convScroll := container.NewScroll(w.convLbl)
right := container.NewVSplit(
container.NewScroll(details),
w.chat.Transcript(),
convScroll,
)
w.vsplit = right
// Нижняя панель: вкладки «Логи» + «Состояние».
bottomTabs := container.NewAppTabs(
container.NewTabItem("Логи", w.logs.Widget()),
container.NewTabItem("Состояние", w.state.Widget()),
container.NewTabItem("Логи", container.NewScroll(w.logsLbl)),
container.NewTabItem("Состояние", container.NewScroll(w.stateLbl)),
)
bottom := container.NewBorder(nil, w.chat.Composer(), nil, nil, bottomTabs)
// Ввод + кнопки команд
w.input = widget.NewEntry()
w.input.SetPlaceHolder("Сообщение… (Enter — отправить)")
w.input.OnSubmitted = func(s string) {
s = strings.TrimSpace(s)
if s == "" {
return
}
w.input.SetText("")
w.commands.SendText(s)
}
cmdBar := container.NewHBox(
widget.NewButton("Новая", func() { w.commands.Start() }),
widget.NewButton("Создавай", func() { w.commands.Approve() }),
widget.NewButton("Пропустить", func() { w.commands.Skip() }),
widget.NewButton("Отмена", func() { w.commands.Cancel() }),
)
inputRow := container.NewBorder(nil, nil, cmdBar, w.input, nil)
bottom := container.NewBorder(nil, inputRow, nil, nil, bottomTabs)
w.hsplit = container.NewHSplit(left, right)
@@ -137,20 +195,36 @@ func (w *Window) saveLayout() {
pref.SetFloat(splitVPref, w.vsplit.Offset)
}
// taskTitle — строка в списке задач.
func taskTitle(t storage.Task) string {
title := t.Title
if title == "" {
title = "(без названия)"
}
return title + "\n" + string(t.Status)
}
// selectTask загружает детали выбранной задачи (снимки из Store).
func (w *Window) selectTask(id int64) {
w.selected = id
w.taskList.Select(id)
w.fyneApp.Preferences().SetInt(selectedPref, int(id))
ctx := context.Background()
t, err := w.store.GetTask(ctx, id)
if err != nil {
w.detail.ShowEmpty()
w.chat.Clear()
w.titleLbl.SetText("—")
w.statusLbl.SetText("")
w.detailLbl.SetText("")
w.convLbl.SetText("")
return
}
w.detail.ShowTask(t)
w.titleLbl.SetText(t.Title)
w.statusLbl.SetText(string(t.Status))
detail := "Цель: " + t.Goal
if len(t.Repos) > 0 {
detail += "\nРепозитории: " + strings.Join(t.Repos, ", ")
}
w.detailLbl.SetText(detail)
// Диалог: история + краткие трассы.
hist, err := w.store.GetHistory(ctx, id)
@@ -159,7 +233,7 @@ func (w *Window) selectTask(id int64) {
}
var b strings.Builder
for _, h := range hist {
b.WriteString(ui.FormatRole(h.Role))
b.WriteString(formatRole(h.Role))
b.WriteString(h.Content)
b.WriteString("\n\n")
}
@@ -172,19 +246,39 @@ func (w *Window) selectTask(id int64) {
if b.Len() == 0 {
b.WriteString("Нет сообщений. /start — начать задачу.")
}
w.chat.SetTranscript(b.String())
w.convLbl.SetText(b.String())
// Состояние: сброс к снимку задач.
w.refreshState(ctx, id)
}
func formatRole(role string) string {
switch role {
case "user":
return "👤 "
default:
return "🤖 "
}
}
// refreshState — снимок «Состояния» выбранной задачи (агенты + трейсы).
func (w *Window) refreshState(ctx context.Context, id int64) {
traces, err := w.store.GetTraces(ctx, id)
if err != nil {
return
}
w.state.SetText(ui.StateText(traces))
var b strings.Builder
for _, tr := range traces {
b.WriteString(strings.ToUpper(tr.Agent) + ": " + string(tr.Status))
if tr.SessionID != "" {
b.WriteString(" (session " + tr.SessionID + ")")
}
b.WriteString("\n")
}
if b.Len() == 0 {
b.WriteString("Нет активных агентов.")
}
w.stateLbl.SetText(b.String())
}
// refreshList перечитывает список задач из Store (снимок).
@@ -195,13 +289,42 @@ func (w *Window) refreshList() {
log.Printf("ui: list tasks: %v", err)
return
}
w.taskList.SetTasks(tasks)
w.taskList.Select(w.selected)
w.mu.Lock()
w.tasks = tasks
selected := w.selected
w.mu.Unlock()
if w.list != nil {
w.list.Refresh()
}
_ = selected
}
// appendLog добавляет строку в панель «Логи» (делегирует в LogPanel).
// appendConv добавляет строку в диалог (буфер ограничен).
func (w *Window) appendConv(text string) {
s := w.convLbl.Text + text + "\n\n"
if len(s) > maxLogLen {
s = s[len(s)-maxLogLen:]
}
w.convLbl.SetText(s)
}
// appendLog добавляет строку в панель «Логи».
func (w *Window) appendLog(text string) {
w.logs.Append(text)
s := w.logsLbl.Text + text + "\n"
if len(s) > maxLogLen {
s = s[len(s)-maxLogLen:]
}
w.logsLbl.SetText(s)
}
// appendState добавляет строку в панель «Состояние».
func (w *Window) appendState(text string) {
s := w.stateLbl.Text + text + "\n"
if len(s) > maxLogLen {
s = s[len(s)-maxLogLen:]
}
w.stateLbl.SetText(s)
}
// submitText отправляет ввод пользователя в Router.
@@ -245,7 +368,7 @@ func (w *Window) Send(_ context.Context, _ chat.Address, m chat.Message) error {
}
text = sb.String()
}
fyne.Do(func() { w.chat.Append("🤖 " + text) })
fyne.Do(func() { w.appendConv("🤖 " + text) })
return nil
}
@@ -255,7 +378,7 @@ func (w *Window) Ask(_ context.Context, _ chat.Address, m chat.Message) error {
for _, opt := range m.Options {
text += "\n" + opt.Label
}
fyne.Do(func() { w.chat.Append("❓ " + text) })
fyne.Do(func() { w.appendConv("❓ " + text) })
return nil
}
@@ -302,30 +425,73 @@ func (w *Window) OnTaskStatusChanged(e events.TaskStatusChanged) {
if w.selected == e.ID {
w.selectTask(e.ID)
}
w.state.Append(ui.TaskStatusText(e))
w.appendState(taskStatusLine(e))
})
}
func (w *Window) OnHistoryAppended(e events.HistoryAppended) {
fyne.Do(func() {
if w.selected == e.TaskID {
w.chat.Append(ui.FormatRole(e.Role) + e.Content)
w.appendConv(formatRole(e.Role) + e.Content)
}
})
}
func (w *Window) OnTraceAppended(e events.TraceAppended) {
fyne.Do(func() {
w.state.Append(ui.TraceLine(e.Agent, e.Status))
w.appendState(strings.ToUpper(e.Agent) + ": " + string(e.Status))
})
}
func (w *Window) OnAgentActivity(e events.AgentActivity) {
fyne.Do(func() {
w.state.Append(ui.ActivityLine(e.Agent, e.Stage))
w.appendState(strings.ToUpper(e.Agent) + " → " + e.Stage)
})
}
func (w *Window) OnLog(e events.LogLine) {
w.appendLog(e.Text)
fyne.Do(func() { w.appendLog(e.Text) })
}
func taskStatusLine(e events.TaskStatusChanged) string {
return statusBadge(e.To) + " #" + itoa(e.ID) + ": " + string(e.From) + " → " + string(e.To)
}
func statusBadge(s model.Status) string {
switch s {
case model.StatusSuccess:
return "✅"
case model.StatusFailed, model.StatusAborted:
return "❌"
case model.StatusRunning, model.StatusCollecting:
return "⏳"
case model.StatusReady, model.StatusApproved:
return "🟡"
case model.StatusCancelled:
return "🚫"
default:
return "•"
}
}
func itoa(v int64) string {
if v == 0 {
return "0"
}
neg := v < 0
if neg {
v = -v
}
var b [24]byte
i := len(b)
for v > 0 {
i--
b[i] = byte('0' + v%10)
v /= 10
}
if neg {
i--
b[i] = '-'
}
return string(b[i:])
}

View File

@@ -1,29 +0,0 @@
// Package ui — контроллер и представления десктопного интерфейса (Fyne).
//
// Слой обмена с ядром: однонаправленный поток (спец 12.212.5).
// - Core мутирует состояние; UI только читает снимки и реагирует на события.
// - Действия UI = команды (CreateTask/ApproveTask/...), которые зовут Core.
// - Подписчик шины (Controller) получает события и перекладывает их в View
// (реализация Fyne) через fyne.Do — никаких прямых вызовов Fyne из core.
//
// Контракты компонентов-виджетов (спец 12.8): интерфейс + Nil-реализация.
package ui
// LogPanel — панель «Логи» (спец 12.9): поток системных логов (сырые строки).
//
// Содержит строки лога в буфере ограниченного размера; при превышении лимита
// старые строки отбрасываются. Контейнер виджета отдаётся окну для встраивания
// в таб «Логи» — реализация (Fyne) сама владеет своим виджетом.
type LogPanel interface {
// Append добавляет строку лога. Реализация обязана перекладывать работу
// на поток Fyne (fyne.Do / fyne.DoAndWait), т.к. вызывается из горутин Hub.
Append(text string)
}
// NilLogPanel — no-op реализация LogPanel для headless-режима и тестов.
type NilLogPanel struct{}
// NewNilLogPanel создаёт NilLogPanel.
func NewNilLogPanel() *NilLogPanel { return &NilLogPanel{} }
func (NilLogPanel) Append(string) {}

View File

@@ -1,12 +0,0 @@
package ui
import "testing"
// NilLogPanel — no-op контракт (спец 12.8): Append ничего не делает, безопасно
// вызывается из горутин Hub и из тестов без Fyne.
func TestNilLogPanelAppendNoop(t *testing.T) {
p := NewNilLogPanel()
p.Append("line 1")
p.Append("")
p.Append("line 3")
}

View File

@@ -1,99 +0,0 @@
package ui
import (
"strings"
"github.com/kamelion/ratatoskr-go/internal/events"
"github.com/kamelion/ratatoskr-go/internal/model"
"github.com/kamelion/ratatoskr-go/internal/storage"
)
// StatePanel — панель «Состояние» (спец 12.13): агенты и трейсы выбранной
// задачи. Снимок (SetText) + live-строки (Append), буфер ограничен.
type StatePanel interface {
// SetText заменяет содержимое снимком трасс.
SetText(text string)
// Append добавляет live-строку (буфер ограничен).
Append(text string)
}
// NilStatePanel — no-op реализация StatePanel для headless-режима и тестов.
type NilStatePanel struct{}
// NewNilStatePanel создаёт NilStatePanel.
func NewNilStatePanel() *NilStatePanel { return &NilStatePanel{} }
func (NilStatePanel) SetText(string) {}
func (NilStatePanel) Append(string) {}
// StateText — снимок трасс задачи (pure-функция, спец 12.13).
func StateText(traces []storage.Trace) string {
var b strings.Builder
for _, tr := range traces {
b.WriteString(strings.ToUpper(tr.Agent) + ": " + string(tr.Status))
if tr.SessionID != "" {
b.WriteString(" (session " + tr.SessionID + ")")
}
b.WriteString("\n")
}
if b.Len() == 0 {
b.WriteString("Нет активных агентов.")
}
return b.String()
}
// TraceLine — строка добавленного/обновлённого трейса субагента.
func TraceLine(agent string, status model.TraceStatus) string {
return strings.ToUpper(agent) + ": " + string(status)
}
// ActivityLine — строка смены этапа агента.
func ActivityLine(agent, stage string) string {
return strings.ToUpper(agent) + " → " + stage
}
// TaskStatusText — строка изменения статуса задачи (бейдж + ID).
func TaskStatusText(e events.TaskStatusChanged) string {
return StatusBadge(e.To) + " #" + Itoa(e.ID) + ": " + string(e.From) + " → " + string(e.To)
}
// StatusBadge — эмодзи-бейдж статуса задачи.
func StatusBadge(s model.Status) string {
switch s {
case model.StatusSuccess:
return "✅"
case model.StatusFailed, model.StatusAborted:
return "❌"
case model.StatusRunning, model.StatusCollecting:
return "⏳"
case model.StatusReady, model.StatusApproved:
return "🟡"
case model.StatusCancelled:
return "🚫"
default:
return "•"
}
}
// Itoa — int64 в строку без зависимостей.
func Itoa(v int64) string {
if v == 0 {
return "0"
}
neg := v < 0
if neg {
v = -v
}
var b [24]byte
i := len(b)
for v > 0 {
i--
b[i] = byte('0' + v%10)
v /= 10
}
if neg {
i--
b[i] = '-'
}
return string(b[i:])
}

View File

@@ -1,50 +0,0 @@
package ui
import (
"strings"
"testing"
"github.com/kamelion/ratatoskr-go/internal/events"
"github.com/kamelion/ratatoskr-go/internal/model"
"github.com/kamelion/ratatoskr-go/internal/storage"
)
// StateText — снимок трасс (спец 12.13), pure-функция без Fyne.
func TestStateText(t *testing.T) {
got := StateText(nil)
if !strings.Contains(got, "Нет активных агентов.") {
t.Errorf("пусто: got %q", got)
}
tr := storage.Trace{Agent: "analyst", Status: model.TraceRunning, SessionID: "s1"}
got = StateText([]storage.Trace{tr})
if !strings.Contains(got, "ANALYST: running") {
t.Errorf("агент/статус не попали: %q", got)
}
if !strings.Contains(got, "session s1") {
t.Errorf("session не попала: %q", got)
}
}
// Live-строки — чистые хелперы.
func TestStateLines(t *testing.T) {
if TraceLine("analyst", model.TraceRunning) != "ANALYST: running" {
t.Errorf("TraceLine: %q", TraceLine("analyst", model.TraceRunning))
}
if ActivityLine("dev", "review") != "DEV → review" {
t.Errorf("ActivityLine: %q", ActivityLine("dev", "review"))
}
e := events.TaskStatusChanged{ID: 7, From: model.StatusRunning, To: model.StatusSuccess}
got := TaskStatusText(e)
if !strings.Contains(got, "✅") || !strings.Contains(got, "#7") {
t.Errorf("TaskStatusText: %q", got)
}
}
// NilStatePanel — no-op контракт (спец 12.8): безопасно для headless/тестов.
func TestNilStatePanelNoop(t *testing.T) {
p := NewNilStatePanel()
p.SetText("снимок")
p.Append("строка")
}

View File

@@ -1,37 +0,0 @@
package ui
import (
"strings"
"github.com/kamelion/ratatoskr-go/internal/storage"
)
// TaskDetailPanel — панель «Детали задачи» (спец 12.11): заголовок, статус,
// детали (цель + репозитории) выбранной задачи.
//
// Данные — снимки-копии из Store (спец 12.5). Обновление — на потоке Fyne;
// вызывающий уже внутри fyne.Do. Диалог и «Состояние» — отдельные панели.
type TaskDetailPanel interface {
// ShowTask рендерит детали из снимка задачи.
ShowTask(t storage.Task)
// ShowEmpty сбрасывает к placeholder («—» / пусто) при недоступной задаче.
ShowEmpty()
}
// NilTaskDetailPanel — no-op реализация TaskDetailPanel для headless-режима и тестов.
type NilTaskDetailPanel struct{}
// NewNilTaskDetailPanel создаёт NilTaskDetailPanel.
func NewNilTaskDetailPanel() *NilTaskDetailPanel { return &NilTaskDetailPanel{} }
func (NilTaskDetailPanel) ShowTask(storage.Task) {}
func (NilTaskDetailPanel) ShowEmpty() {}
// TaskDetailText — строка деталей задачи (pure-функция, спец 12.11).
func TaskDetailText(t storage.Task) string {
detail := "Цель: " + t.Goal
if len(t.Repos) > 0 {
detail += "\nРепозитории: " + strings.Join(t.Repos, ", ")
}
return detail
}

View File

@@ -1,36 +0,0 @@
package ui
import (
"strings"
"testing"
"github.com/kamelion/ratatoskr-go/internal/storage"
)
// TaskDetailText — строка деталей задачи (спец 12.11), pure-функция без Fyne.
func TestTaskDetailText(t *testing.T) {
noRepos := storage.Task{Goal: "Понять код"}
got := TaskDetailText(noRepos)
if got != "Цель: Понять код" {
t.Errorf("без repos: got %q", got)
}
if strings.Contains(got, "Репозитории") {
t.Errorf("без repos не должно быть репозиториев: %q", got)
}
withRepos := storage.Task{Goal: "Рефакторинг", Repos: []string{"a", "b"}}
got = TaskDetailText(withRepos)
if !strings.Contains(got, "Цель: Рефакторинг") {
t.Errorf("цель не попала: %q", got)
}
if !strings.Contains(got, "Репозитории: a, b") {
t.Errorf("репозитории не попали: %q", got)
}
}
// NilTaskDetailPanel — no-op контракт (спец 12.8): безопасно для headless/тестов.
func TestNilTaskDetailPanelNoop(t *testing.T) {
p := NewNilTaskDetailPanel()
p.ShowTask(storage.Task{ID: 1, Goal: "x"})
p.ShowEmpty()
}

View File

@@ -1,40 +0,0 @@
package ui
import (
"github.com/kamelion/ratatoskr-go/internal/storage"
)
// TaskListPanel — панель «Список задач» (спец 12.10): все задачи строками.
//
// Данные — снимки-копии из Store (спец 12.5), заменяются через SetTasks.
// Состояние выбора живёт в окне: окно зовёт Select, чтобы подсветить строку.
// Контейнер виджета отдаётся окну — реализация (Fyne) сама владеет виджетом.
type TaskListPanel interface {
// SetTasks заменяет снимок списка и перерисовывает виджет.
SetTasks(tasks []storage.Task)
// Select подсвечивает строку задачи id (управляется окном).
Select(id int64)
// OnSelect регистрирует колбэк клика по строке (окно грузит детали).
OnSelect(fn func(id int64))
}
// NilTaskListPanel — no-op реализация TaskListPanel для headless-режима и тестов.
type NilTaskListPanel struct {
onSelect func(id int64)
}
// NewNilTaskListPanel создаёт NilTaskListPanel.
func NewNilTaskListPanel() *NilTaskListPanel { return &NilTaskListPanel{} }
func (p *NilTaskListPanel) SetTasks([]storage.Task) {}
func (p *NilTaskListPanel) Select(int64) {}
func (p *NilTaskListPanel) OnSelect(fn func(int64)) { p.onSelect = fn }
// TaskTitle — строка задачи в списке (pure-функция, спец 12.10).
func TaskTitle(t storage.Task) string {
title := t.Title
if title == "" {
title = "(без названия)"
}
return title + "\n" + string(t.Status)
}

View File

@@ -1,40 +0,0 @@
package ui
import (
"strings"
"testing"
"github.com/kamelion/ratatoskr-go/internal/storage"
)
// TaskTitle — строка в списке задач (спец 12.10), pure-функция без Fyne.
func TestTaskTitle(t *testing.T) {
empty := storage.Task{Status: storage.StatusReady}
got := TaskTitle(empty)
if !strings.Contains(got, "(без названия)") {
t.Errorf("пустое название: got %q, want «(без названия)»", got)
}
if !strings.Contains(got, string(storage.StatusReady)) {
t.Errorf("строка должна содержать статус, got %q", got)
}
named := storage.Task{Title: "Тест", Status: storage.StatusRunning}
got = TaskTitle(named)
if !strings.Contains(got, "Тест") {
t.Errorf("название не попало в строку: %q", got)
}
if !strings.Contains(got, string(storage.StatusRunning)) {
t.Errorf("статус не попал в строку: %q", got)
}
}
// NilTaskListPanel — no-op контракт (спец 12.8): безопасно для headless/тестов.
func TestNilTaskListPanelNoop(t *testing.T) {
p := NewNilTaskListPanel()
p.SetTasks([]storage.Task{{ID: 1}})
p.Select(1)
var got []int64
p.OnSelect(func(id int64) { got = append(got, id) })
// Nil не вызывает колбэки — нет виджета, но вызовы безопасны.
}

View File

@@ -0,0 +1,6 @@
# Секреты для scripts/build-publish-ui.ps1 — НЕ коммитить (git-ignored).
# Скопируйте этот файл в scripts/.gitea-creds и заполните реальные значения.
# Формат: по одной `ключ=значение` на строку, строки с # — комментарии.
GITEA_TOKEN=write:packages-токен
UPDATE_TOKEN=read:package-токен
GIT_MAIN_URL=http://gitea.hal9000.home