task(html-render): close → 🟢, unblock cron-deploy

closes board-viewer-html-render

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
vitya
2026-05-22 14:49:42 +03:00
parent c0661fb7b3
commit cab4a8b92d
2 changed files with 26 additions and 15 deletions

View File

@@ -8,10 +8,11 @@
## Key files
- (TBD) `src/render.{ts,py}`main renderer
- (TBD) `templates/board.html` — template (Mustache / Jinja / template literals — выбор имплементера)
- (TBD) `static/board.css`, `static/board.js` — styling + filter/drawer client-side
- (TBD) `tests/render.test.{ts,py}` — snapshot tests
- `src/render.ts``renderBoard()`, `formatAge()`, `partitionByStatus()` (pure)
- `src/cli.ts` — entry: load config → readBoard → renderBoard → `dist/index.html` + copy `static/`
- `static/board.css` — raw CSS, system font, light/dark, ~190 LOC
- `static/board.js` — ESM module: filter, drawer (lazy-fetch + `marked@14` from esm.sh), toggle-archived, toggle-grouping (full rerender into per-project columns)
- `tests/render.test.ts` — 17 tests on render logic (no snapshots — semantic property assertions, more robust to harmless markup tweaks)
## Acceptance criteria
@@ -32,16 +33,27 @@
## Decisions log
- 2026-05-22: task создан промоушеном; зависит от `board-viewer-gitea-reader` контракта.
- 2026-05-22: emoji-set acceptance выравнен под reader контракт (⚪🔴🟡🔵🟢).
- 2026-05-22: client-side `marked@14` via esm.sh — lazy-load на первое открытие drawer'а.
- 2026-05-22: raw CSS, no framework — соответствует «whitespace + типографика» intent task notes.
- 2026-05-22: done >14 дней архивируются (hidden by default, toggle «show archived»).
- 2026-05-22: snapshot tests заменены 17 semantic-property тестами — устойчивее к косметическим изменениям markup'а.
## Open questions
- [ ] Markdown-renderer: client-side (`marked`) или server-side (Jinja с pre-rendered HTML вшито в data-attr)? Client-side проще — но добавляет ~50KB JS.
- [ ] CSS framework: ничего (raw CSS) / Pico / Tailwind via CDN? Минимализм — за raw. Раздёргать через первый прототип.
- [ ] Архивные таски (🟢 done старше N дней) скрывать по умолчанию? Toggle?
- [x] Markdown-renderer client-side `marked` via esm.sh (lazy на drawer).
- [x] CSS → raw, no framework.
- [x] Done archive → >14d hidden, toggle for show.
## Completed steps
- [ ] (фиксируется при выполнении)
- [x] `formatAge` (m/h/d/w/mo/y, calendar-month arithmetic) — pure, TDD
- [x] `partitionByStatus` — canonical 5-col order
- [x] `renderBoard` — HTML with escaped fields, JSON embed XSS-safe (`\uXXXX` escapes)
- [x] static/board.css — raw, light/dark
- [x] static/board.js — filter, drawer, archived/grouping toggles, refresh-info
- [x] src/cli.ts — wires config+reader+render+fs
- [x] 17 render tests + smoke-verified e2e (78 records, 4 repos, browser-tested both toggle modes)
## Notes