Files

vitya 27465089b5 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>

2026-05-22 08:21:59 +03:00

4.0 KiB

Raw Blame History

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».

4.0 KiB Raw Blame History Unescape Escape