diff --git a/.tasks/STATUS.md b/.tasks/STATUS.md index c923bec..8a40346 100644 --- a/.tasks/STATUS.md +++ b/.tasks/STATUS.md @@ -1,5 +1,5 @@ # Task Board -_Updated: 2026-05-20 (using-yt-tools cluster fully closed: 3 baseline 🟢; 3 finding fixes 🟢; skill-body-fill 🟢 [SKILL.md 0.2.0]; trigger-smoke-clean-session 🟢 [13/13]; review 🟢 by fresh-eyes subagent — Flow A/B/Failure-modes/NOT all PASS; all 3 nice-to-have findings 🟢 — empty-cache-dir-on-failure & warning-mojibake fixed in `common@fc400b7` [yt-tools 0.1.5]; frames-multiline-stdout spec-fixed in `claude-skills@b2c1a21` [SKILL.md 0.2.2])_ +_Updated: 2026-05-20 (using-yt-tools — 2 new ⚪ findings from concurrent-session observation: skill-body-venv-invocation, windows-powershell-path-doc-fix. Prior closure of cluster stands; surface gaps in env-bootstrap docs.)_ +## ⚪ [using-yt-tools-skill-body-venv-invocation] — SKILL.md не документирует venv-activation / full-path CLI invocation; concurrent сессия после `/reload-plugins` упёрлась в `command not found` на bare `yt-frames`. + +**Observed (2026-05-20):** в concurrent CC-сессии (после `/reload-plugins` + Skill(using-yt-tools)) агент попытался Flow B напрямую — `yt-frames URL --timestamps ...` через Bash. Результат: `bash: yt-frames: command not found`. Далее `Get-Command yt-frames` пусто. Агент попытался `python -m pip install -e ~/projects/.common/lib/yt-tools/` в **системный** Python — wrong path (ломает global env, дублирует уже-настроенный venv в `.common/lib/yt-tools/.venv/`). + +**Корень:** `pip install -e` в taзе `[yt-tools-impl]` положил entry-point'ы (`yt-transcript`, `yt-frames`, `yt-watch`, `yt-tools`) в `.venv/Scripts/` (Windows) / `.venv/bin/` (Linux/macOS), а не на user PATH. Без активации venv агент бинарь по имени не находит. SKILL.md body (Prereq / Inputs / Steps) этого требования не упоминает — обещает «вызови `yt-frames URL --timestamps T1,T2`», как будто на PATH. Имплементер в своей сессии случайно работал в активированном venv shell'е и проблему не увидел. + +**Acceptance:** +- SKILL.md Prereq явный block (≥1 из): + - (a) активация venv: `& ~/projects/.common/lib/yt-tools/.venv/Scripts/Activate.ps1` (Windows PS) / `source ~/projects/.common/lib/yt-tools/.venv/bin/activate` (Linux/macOS), + - (b) full-path invocation: `& ~/projects/.common/lib/yt-tools/.venv/Scripts/yt-frames.exe URL ...`, + - (c) обе альтернативы с trade-off-комментом. +- Steps-примеры (Flow A + Flow B) обновлены: либо активация в первом шаге, либо full-path в каждом вызове. Не оставлять bare `yt-frames` в Steps. +- bump `version: 0.2.2` → `0.2.3` (PATCH — docs-fix без поведенческих изменений). +- `scripts/install.ps1 -Names using-yt-tools` пройден, новая версия в `~/.claude/skills/using-yt-tools/`. + +**Status:** ready +**Where I stopped:** заведено по real-time observation в concurrent CC сессии (2026-05-20) +**Next action:** Edit SKILL.md Prereq + Steps; bump version; reinstall. +**Branch:** master + + +--- + +## ⚪ [using-yt-tools-windows-powershell-path-doc-fix] — README warn про restart-shell-after-winget покрывает только git-bash subshell CC, та же проблема симметрично у PowerShell-subshell. + +**Observed (2026-05-20):** в concurrent CC-сессии PowerShell-subshell не видел ffmpeg (`where.exe ffmpeg` → `INFO: Could not find files`), хотя ffmpeg уже установлен через `winget install Gyan.FFmpeg` на user PATH. Симметричная проблема: env унаследован от родительского shell процесса CC, до его рестарта новый user-PATH не подтягивается ни в bash-subshell, ни в PowerShell-subshell. + +**Корень:** `[using-yt-tools-windows-path-doc-fix]` (закрыта 2026-05-20, README warn добавлен про bash-subshell) формулировка пропустила PowerShell-кейс. Subshell-семантика Windows process-env одинакова для обоих shell flavors — нужно покрыть оба. + +**Acceptance:** +- README пакета `~/projects/.common/lib/yt-tools/README.md` warn-block расширен: явная пометка «restart CC требуется для **обоих** shell flavors внутри сессии — git-bash subshell И PowerShell subshell — потому что process-env унаследован от родительского CC-процесса». +- bump `~/projects/.common/lib/yt-tools/pyproject.toml` version `0.1.5` → `0.1.6` (PATCH — docs-only). +- commit в `.common`. + +**Status:** ready +**Where I stopped:** заведено по real-time observation в concurrent CC сессии (2026-05-20) +**Next action:** Edit README warn-block; bump pyproject; commit. +**Branch:** master + + +--- + ## 🟢 [using-yt-tools-install] — Install env deps (ffmpeg + python venv + 3 pip libs) for using-yt-tools on agent machine. **Этапы:**