From ce4e7aafe2c639dc3658e956bba46de7b124013a Mon Sep 17 00:00:00 2001 From: vitya Date: Tue, 25 Aug 2026 22:06:20 +0300 Subject: [PATCH] =?UTF-8?q?chore(meta):=20file-based=20meta=20channel=20cl?= =?UTF-8?q?osed=20(canon=3Dmappa)=20=E2=80=94=20stubs=20.wiki/.tasks/.agen?= =?UTF-8?q?ts-inbox=20+=20AGENTS.md=20cleanup=20(2026-08-25)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .tasks/STATUS.md | 169 +--------------------------------------------- .wiki/CLAUDE.md | 37 +--------- .wiki/index.md | 25 +------ .wiki/log.md | 17 +---- .wiki/overview.md | 10 +-- 5 files changed, 10 insertions(+), 248 deletions(-) diff --git a/.tasks/STATUS.md b/.tasks/STATUS.md index 893ec5e..8cf6645 100644 --- a/.tasks/STATUS.md +++ b/.tasks/STATUS.md @@ -1,168 +1,3 @@ -# Task Board -_Updated: 2026-05-22_ +# ⛔ Файловая доска закрыта -## 🟢 [#203 board-viewer-pointers] — pre-impl: fill Domain conventions with design-context pointers -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** pointer-блок вставлен в `.wiki/CLAUDE.md` Domain conventions; коммит готов, ждёт push. -**Next action:** push после approval; затем разблокировать `board-viewer-gitea-reader`. -**Branch:** master - ---- - -## 🟢 [#201 board-viewer-gitea-reader] — Gitea API reader → normalized task structure -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** TaskRecord контракт реализован (parser+gitea+reader+config); 25 тестов; typecheck clean. Тесты используют 3 реальных STATUS.md fixture'а. -**Next action:** разблокировать html-render — потребляет `readBoard(client, repos) → TaskRecord[]`. -**Branch:** master - ---- - -## 🟢 [#202 board-viewer-html-render] — render 5-col kanban from normalized structure -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** render+cli+static готовы; 17 render тестов; smoke-verified против real Gitea (78 records, 4 repos), both toggle modes работают, drawer lazy-fetch'ит markdown. -**Next action:** разблокировать cron-deploy — артефакт `dist/index.html + dist/static/` готов для systemd+traefik. -**Branch:** master - ---- - -## 🟢 [#199 board-viewer-cron-deploy] — docker-compose stack on VDS (board.kzntsv.site) -**Status:** done (code-complete; ops-ownership transferred) -**Created:** 2026-05-22 -**Where I stopped:** deploy/ полностью написан (compose + Dockerfile.build + nginx.conf + auth.toml.example + .env.example + README). Compose syntax валидируется. Изменён mechanism: docker stack вместо systemd timer (user choice). -**Next action:** — -**Branch:** master - - ---- - -## 🟢 [#206 board-viewer-review] — review checkpoint (umbrella) -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** independent review выполнен subagent'ом (clean context, не имплементер). 43/43 тестов pass, secret hygiene clean, TDD-immutability чисто. 2 Major + 6 minor/nitpick findings зафайлены как follow-up таски ниже. -**Next action:** взять одну из ⚪ fix-тасок (readme-emoji или card-meta). -**Branch:** master - ---- - -## 🟢 [#205 board-viewer-readme-emoji-fix] — fix stale emoji legend in README.md -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** README обновлён: правильный emoji-словарь + Quick start заполнен + добавлены Deploy/Architecture секции. -**Next action:** — -**Branch:** master - ---- - -## 🟢 [#198 board-viewer-card-meta-fix] — add owner pill + last-commit-marker to cards -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** owner pill + short ISO date (`YYYY-MM-DD` + tooltip с full ISO) рендерятся в обеих ветках (`render.ts` + `board.js`). 4 новых TDD-теста; smoke-verified. -**Next action:** — -**Branch:** master - ---- - -## 🟢 [#204 board-viewer-polish] — bundle of 6 minor/nitpick findings from review -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** все 6 items закрыты в одной сессии. 49 тестов pass (+2 от polish: M2 future-ts, M4 status-filter markup). Smoke-verified: status pill click фильтрует cards. -**Next action:** — -**Branch:** master - ---- - -## 🟢 [#200 board-viewer-drawer-bundle-md] — fix `Failed to fetch` в drawer: bundle md-content в build-time -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** TaskRecord.md_content bundled в build-time через `client.getFile(.tasks/.md)`. Drawer читает `recordsBySlug.get(slug).md_content` вместо fetch — 0 runtime запросов к git.kzntsv.site/raw. Fallback на status-block dl когда md=null. 3 новых reader-теста + 1 render-тест. -**Next action:** ops redeploy на VDS (см. .admin/[board-viewer-redeploy-ux-round1]). -**Branch:** master - - ---- - -## 🟢 [#211 board-viewer-ux-show-slug] — показать slug на карточке (сейчас только в data-attr) -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** `{slug}` рендерится в обеих ветках (`render.ts` + `static/board.js`). CSS — monospace, dim, под `card-title`. 1 новый render-тест. -**Next action:** ops redeploy. -**Branch:** master - - ---- - -## 🟢 [#208 board-viewer-ux-full-datetime] — дата + время в явном формате (не только дата) -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** `formatMskDateTime` (UTC+3, no-DST) в `render.ts` + `static/board.js`. Карточка показывает `YYYY-MM-DD HH:MM МСК`. Tooltip с full ISO. Relative age оставлен в card-meta (тоненькая строка). 2 новых теста (basic + midnight rollover). -**Next action:** ops redeploy. -**Branch:** master - - ---- - -## 🟢 [#209 board-viewer-ux-owner-conditional] — скрывать owner-pill когда все таски одного owner'а -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** `distinctOwner(records)` pre-scan: единственный owner → pill убирается со всех карточек, в header добавляется `Owner: X`; 2+ owners → pill возвращается на карточки. Поведение симметрично в `render.ts` и `static/board.js` (через `SOLO_OWNER` constant). 4 новых render-теста (mono / multi / mono-summary / multi-omits-summary). -**Next action:** ops redeploy + verify auth.toml whitelist на VDS. -**Branch:** master - - ---- - -## 🟡 [#212 board-viewer-ux-task-numbers] — shorthand numbering (BV-12) на карточке - -**Status:** paused (cross-repo migration outside autonomous scope) -**Created:** 2026-05-22 -**Where I stopped:** (paused 2026-05-22 — user choice: defer до отдельной сессии. 4 design-вопроса остаются: scope per-repo/global, source-of-truth `` vs auto-derive, format BV-12 vs T-001, ретроактивно или нет. Recommendations в `board-viewer-ux-task-numbers.md` — все 4 имеют preferred answer.) -**Next action:** Возобновить в отдельной user-session. Decision-tree: либо «board-viewer-impl-only» (TDD parser+render+badge, ретроактивная нумерация — отдельная chore-таска), либо «full cross-repo» (impl + 5 whitelisted repos retro-numbering, отдельные commit'ы per-repo). -**Branch:** master - - ---- - -## 🟢 [#207 board-viewer-ux-done-cutoff] — фильтр / cutoff длинного done-tail -**Status:** done -**Created:** 2026-05-22 -**Where I stopped:** source неизменен (✓). Render-side cutoff: done column sort'ится by `last_commit_iso desc`, первые 10 видимы, rest `data-overflow="true"` (CSS hides), внизу column'а button ``. Click → toggle `col.show-overflow` + button text `collapse`. Non-done колонки не trozhуются. 4 новых render-теста (overflow attr / expander / no-expander / non-done). -**Next action:** ops redeploy. -**Branch:** master - - ---- - -## ⚪ [#213 board-viewer-whitelist-auto-discovery] — auto-discover репо из namespace-list (zero-maintenance whitelist) - -**Status:** ready (design-first, round2 candidate — не блокер round1 review) -**Created:** 2026-05-22 -**Where I stopped:** (not started — 6 design-вопроса: schema mergeable namespaces+repos, filter `.tasks/STATUS.md` HEAD-probe, API endpoint org-vs-user fallback, pagination, error handling, exclusions defer'нуть. Recommendations внутри `board-viewer-whitelist-auto-discovery.md`.) -**Next action:** Quick-win параллельно — `~/projects/.admin/.tasks/board-viewer-expand-whitelist.md` (ручное расширение auth.toml на VDS, no code-change). Эта код-таска — long-term для zero-maintenance. Resolve 6 design-вопросов (single user-session) → TDD impl `gitea.ts listOrgRepos/hasStatusMd` + `config.ts namespaces+repos merge` + `reader.ts pre-resolve repo-list`. Если дилемма — `.workshop/.brainstorm/board-viewer-whitelist-auto-discovery.md`. -**Branch:** master - - ---- - -## 🔵 [#210 board-viewer-ux-round1-review] — review umbrella для 6 UX-fixes round1 - -**Status:** blocked -**Created:** 2026-05-22 -**Blocker:** board-viewer-ux-task-numbers (1/6 round1-fixes paused — cross-repo migration требует user-decision) -**Where I stopped:** (not started — открывать когда все 6 импл-таск 🟢) -**Next action:** Independent review subagent'ом (clean context, не имплементер) — TDD-immutability (тесты не переписаны под impl), output-correctness (smoke на live board.kzntsv.site после redeploy), regression check (49 существующих тестов остаются pass). -**Branch:** master - - ---- - - +**Не читать. Не править.** Канон — mappa (`mcp__mappa__task_*`): task-сущности проекта. Скил: `mappa-task-work`. diff --git a/.wiki/CLAUDE.md b/.wiki/CLAUDE.md index ce90598..21695bc 100644 --- a/.wiki/CLAUDE.md +++ b/.wiki/CLAUDE.md @@ -1,36 +1,3 @@ -# Wiki Schema — board-viewer +# ⛔ Файловый канал закрыт -Project-specific wiki conventions. Read this before any wiki operation. - -This wiki follows Karpathy's LLM Wiki pattern: -**https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f** - -The `using-wiki` skill enforces the workflow and file formats. This file overrides the skill where they conflict. - -## Page types - -- `entities/` — discrete things this project tracks (people, services, modules). -- `concepts/` — recurring ideas, design decisions, gotchas. -- `packages/` — code packages this project produces or consumes. -- `summaries/` — one summary page per ingested external doc; carries `ingested:` and `raw_path:`. -- `overview.md` — single project-wide overview. - -## Naming - -- `kebab-case.md`, **Latin only**. Transliterate Cyrillic in filenames; keep the original title in the H1 + frontmatter. - -## Domain conventions - -### Mandatory: read design context before implementation - -Before picking up any task in `.tasks/`, load the full design context. It does **not** live in this repo fully — only pointers do. Sources, in order: - -1. **Canonical design:** `.wiki/concepts/board-viewer.md`. Architecture decisions, scope, MVP feature list, anti-patterns (hermes-style, Gitea Projects), trade-offs. -2. **Brainstorm process trace (rationale):** `~/projects/.workshop/.archive/2026-05-22-board-viewer.md`. Why each decision was made, what was rejected and why, clarifying note that `mcp__projects-meta__*` is not callable from HTTP service. -3. **Local `overview.md`** — quick orientation summary; never source of truth. - -Do **not** invent thresholds, taxonomies, container topology, or pipeline stages from task `where_stopped` lines alone — those are pointers, not specifications. - -### TDD posture - -Per `follow tdd-criteria` trigger in this CLAUDE.md: impl-tasks `board-viewer-gitea-reader` and `board-viewer-html-render` are TDD. `board-viewer-cron-deploy` falls under the infrastructure carve-out (declarative systemd / traefik / DNS — verify by deploy + curl, not unit tests). Mark each impl commit accordingly. +**Не читать. Не править.** Канон — mappa (`mcp__mappa__*`): wiki-сущности проекта, конвенции — AGENTS-сущность. Скил: `mappa-knowledge`. diff --git a/.wiki/index.md b/.wiki/index.md index 5386f28..21695bc 100644 --- a/.wiki/index.md +++ b/.wiki/index.md @@ -1,24 +1,3 @@ -# Wiki Index +# ⛔ Файловый канал закрыт -Catalog of all wiki pages. One line per page, organized by type. Updated on every ingest / new page. - -## Overview - -- [overview.md](overview.md) — project overview - -## Entities - - - -## Concepts - -- [board-viewer.md](concepts/board-viewer.md) — design: read-only HTML kanban-viewer over Gitea API -- [bootstrap-manifest.md](concepts/bootstrap-manifest.md) — skill versions used to bootstrap layout - -## Packages - - - -## Sources - - +**Не читать. Не править.** Канон — mappa (`mcp__mappa__*`): wiki-сущности проекта, конвенции — AGENTS-сущность. Скил: `mappa-knowledge`. diff --git a/.wiki/log.md b/.wiki/log.md index 58f8afb..21695bc 100644 --- a/.wiki/log.md +++ b/.wiki/log.md @@ -1,16 +1,3 @@ -# Wiki Log +# ⛔ Файловый канал закрыт -Append-only operation log. Format: - -``` -## [YYYY-MM-DD] | -``` - -Operations: `init`, `ingest`, `query`, `lint`, `refactor`, `decision`. - -Parseable: `grep "^## \[" .wiki/log.md | tail -20`. - ---- - -## [2026-05-22] init | wiki bootstrapped via setup-wiki@1.0.0 -## [2026-05-22] ingest | promoted .workshop/.brainstorm/board-viewer.md → concepts/board-viewer.md +**Не читать. Не править.** Канон — mappa (`mcp__mappa__*`): wiki-сущности проекта, конвенции — AGENTS-сущность. Скил: `mappa-knowledge`. diff --git a/.wiki/overview.md b/.wiki/overview.md index fd5a8a6..21695bc 100644 --- a/.wiki/overview.md +++ b/.wiki/overview.md @@ -1,9 +1,3 @@ ---- -title: board-viewer overview -type: overview -updated: 2026-05-22 ---- +# ⛔ Файловый канал закрыт -# board-viewer — overview - - +**Не читать. Не править.** Канон — mappa (`mcp__mappa__*`): wiki-сущности проекта, конвенции — AGENTS-сущность. Скил: `mappa-knowledge`.