promote: workshop/board-viewer brainstorm → concepts + 5 tasks

- concepts/board-viewer.md (design, promoted from .workshop)
- .tasks/STATUS.md + 5 per-task files:
  - board-viewer-pointers (pre-impl, status=ready)
  - board-viewer-gitea-reader (impl, TDD, status=ready)
  - board-viewer-html-render (impl, TDD, blocker=gitea-reader)
  - board-viewer-cron-deploy (impl, infra carve-out, blocker=html-render)
  - board-viewer-review (umbrella, status=blocked)

TDD-mode embedded in impl-tasks per follow tdd-criteria trigger in CLAUDE.md.
MCP write-side workaround per memory reference_projects_meta_resolveTarget_bug.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
vitya
2026-05-22 08:21:59 +03:00
parent d0dc686a65
commit 27465089b5
9 changed files with 414 additions and 15 deletions

View File

@@ -0,0 +1,59 @@
# board-viewer-gitea-reader
## Goal
Модуль, который через Gitea API читает `.tasks/STATUS.md` + per-task `<slug>.md` файлы из всех релевантных репо (`OpeItcLoc03/agenda` + per-project репо из `~/.config/projects-mcp/auth.toml::gitea_owners`) и нормализует в типизированную структуру для рендера.
Это первая импл-таска. Остальные импл-таски (`board-viewer-html-render`, `board-viewer-cron-deploy`) зависят от типов, которые этот модуль публикует.
**TDD-mode:** обязательно по `follow tdd-criteria` триггеру в `.wiki/CLAUDE.md`. Сначала тесты на нормализацию пар фикстур (STATUS.md + per-task.md) → потом реализация. Не модифицировать assert'ы во время реализации без `[test-modify: ...]` маркера в commit subject.
## Key files
- (TBD) `src/gitea-reader.{ts,py}` — main reader module
- (TBD) `src/types.{ts,py}` — exported task structure
- (TBD) `tests/fixtures/` — sample STATUS.md + per-task.md pairs from real repos
- (TBD) `tests/gitea-reader.test.{ts,py}` — TDD assertions
## Acceptance criteria
- **Output contract:** массив объектов с полями:
```
{
slug: string,
project: string, // repo name (e.g. "board-viewer", "books")
project_owner: string, // gitea owner (e.g. "OpeItcLoc03")
status: "open" | "in_progress" | "paused" | "blocked" | "done",
status_emoji: "⚪" | "🟡" | "🟣" | "🔴" | "🟢",
title: string, // from STATUS.md block H2 after slug
where_stopped: string | null,
next_action: string | null,
blocker: string | null,
branch: string | null,
last_commit_iso: string | null, // from Gitea API, latest commit touching the task file
raw_url: string, // Gitea raw URL to per-task <slug>.md for drawer lazy-fetch
}
```
- **Inputs:** список репо из конфига (env var или TOML).
- **Auth:** Gitea token из `~/.config/projects-mcp/auth.toml::gitea_token` (admin scope, читает любой репо).
- **Robustness:** репо без `.tasks/` → пропустить молча (не ошибка). `.tasks/STATUS.md` без emoji-блоков → пустой массив для этого проекта.
- **Tests:** фикстуры из ≥3 реальных репо (board-viewer, books, .workshop), assertions покрывают: нормальный case, status без per-task.md (только STATUS.md block), per-task без записи в STATUS.md (legacy), blocked-таски с `Blocker:` строкой.
- **Single language:** один из TS / Python. Выбор — за имплементером (TS легче переиспользует с HTML-рендером в одном процессе; Python проще читать конфиг).
## Decisions log
- 2026-05-22: task создан промоушеном; контракт фиксирован — это публичный API для html-render.
## Open questions
- [ ] TS or Python? (повлияет на структуру cron-deploy).
- [ ] Owner-фильтр: брать репо из `gitea_owners` целиком или whitelist? Возможно нужен `board_viewer_repos` отдельным полем в auth.toml.
- [ ] Кэшировать ответы Gitea API локально между cron-тиками? (опт.: rate-limit, hot-reload).
## Completed steps
- [ ] (фиксируется при выполнении)
## Notes
NB: исходный буфер упоминал `mcp__projects-meta__tasks_aggregate` как возможный источник — **это ложная развилка**, MCP недоступен HTTP-сервису. Только прямой Gitea API. См. `.wiki/concepts/board-viewer.md` секцию «Implementation note».