diff --git a/.gitattributes b/.gitattributes index 899c169..7080bb5 100644 --- a/.gitattributes +++ b/.gitattributes @@ -5,3 +5,6 @@ # Surowe wyniki CLI zachowują końcowe spacje ramek i skali intensywności. docs/examples/coaching-terminal/[0-9]*.txt text eol=lf whitespace=-blank-at-eol docs/examples/x-thread-2026-11-04/source/*.txt text eol=lf whitespace=-blank-at-eol +# Migawki plików (toMatchFileSnapshot) porównywane bajt w bajt — CRLF po +# checkoucie na Windows dałby różnicę w każdym wierszu. +**/__snapshots__/*.txt text eol=lf diff --git a/CHANGELOG.md b/CHANGELOG.md index 2a263b3..c551e56 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,48 @@ change between minor versions — a regenerated plan can differ. ## [Unreleased] +### Added + +- `trainctl rules E-3` lists the engine's fixed values that have no source + (easy-run cap, accent share, phase split, recoveries, race-week sessions), + each marked in code for review. +- Season shape checks in the engine (`seasonProfile`, `seasonShapeIssues`): + long run not the longest, deload not lighter, one session carrying the week, + heavy accent after the race, repeated blocks, long run below the distance + threshold. In this release they run only in the test matrix of 576 + synthetic profiles; `check` will use them once the engine changes. +- FOUNDATIONS §10.15: corpus measurements of run count, volume and long-run + trajectory, accent dose and weekend order, with rules S-9b–S-12, P-12, + J-8–J-10 and the return-after-break heuristic R-11. + +### Fixed + +- `review`: the day-by-day execution table is headed Plan / Actual / Status + instead of reusing the before/after labels of plan changes; the days-to-race + line no longer repeats its label. +- Decimal numbers follow the output language (`21,1 km` and `VDOT 47,7` in + Polish, `21.1 km` in English) instead of raw values such as `21.0975`. The + change history in PLAN.md quotes entries as recorded in plan.yaml. +- Journal statuses are words from the catalogue (`wykonany`, `opuszczony`, + `zmieniony` in Polish); `--json` and MCP data keep the raw enum. +- A one-week phase reads `taper: week 22`, not `weeks 22–22`. +- Wrapping keeps URLs and file paths whole on their own line, so links stay + clickable. +- `why` counts the age of each race result from today, like `status`, names + the date the plan's zones were calibrated, and says when `trainctl plan` + would now calibrate them from a different result or from none. +- `trainctl log` reads numbers with one rule for `--km`, `--rpe`, `--minutes` + and the interactive prompt: a decimal comma (`8,5`) is accepted, hex and + exponent forms are not, and the distance is stored to 0.1 m and echoed as + stored. +- Hand-edited `log.jsonl` values are read with the limits `trainctl log` + applies: numbers written as text or with a comma are accepted, values the + CLI would reject are ignored, and a missing final newline no longer merges + the next entry into the last one. A line that is not a JSON object is + skipped instead of stopping every command; `status` lists the ignored lines + and values. +- `week` prints one volume when the target equals the planned total. + ## [0.6.0] — 2026-11-04 ### Fixed diff --git a/CLAUDE.md b/CLAUDE.md index f0b98aa..71cd946 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -3,7 +3,8 @@ Read [CONTRIBUTING.md](CONTRIBUTING.md) first; decisions live in the ADR table of [SPEC.md](SPEC.md) §10–§11, rule IDs in [docs/science/FOUNDATIONS.md](docs/science/FOUNDATIONS.md) §10. The current -work plan is [docs/PLAN-v0.4.md](docs/PLAN-v0.4.md). +work plan is [docs/PLAN-v0.7.md](docs/PLAN-v0.7.md); the completed one is +[docs/PLAN-v0.4.md](docs/PLAN-v0.4.md). Gate before every commit: `pnpm check` (typecheck of all packages + vitest). diff --git a/SPEC.md b/SPEC.md index e833fba..e91bccc 100644 --- a/SPEC.md +++ b/SPEC.md @@ -360,3 +360,4 @@ Kontrakt i przykłady: [MULTISPORT](docs/MULTISPORT.md). Wyniki: [weryfikacja](d | 044 | 2026-11-03 | Wykonanie używa klucza źródło + externalId, zachowuje części i rozpoznaje konserwatywnie kopie; kilka aktywności może być jawnie przypisanych do sesji. | Kopie z huba/pliku nie mogą podwajać wykonania; nieznane lub odgadnięte dane nie są automatycznie pominięciem ani wykonaniem. | | 045 | 2026-11-03 | Cofnięcie zamiany odtwarza zapisany poprzednik pod nowym ID i ponownie sprawdza kalendarz. Spontaniczne wykonanie innego sportu zapisuje actual/planned sport w dzienniku bez zmiany historycznego planu. Intensywność jest podziałem czasu według ról kroków, z osobnymi przerwami i kategorią unknown. | Odwrotna zamiana nie jest odtworzeniem oryginału; wykonany rower nie zalicza biegu. RPE/notatki nadal są wyłącznie cytowane (ADR-027). T1/T2 i wyjątki dat są deklaracjami kalendarza, nie modelem obciążenia. | | 046 | 2026-11-03 | Wycofane przez regenerację sesje pozostają w archiwum z `retiredSessionIds`; mogą wrócić pod tym samym ID. Oryginały zamian nie podlegają reaktywacji generatora. Eksport ICS utrzymuje odciski treści, SEQUENCE i czas zmiany w `plan/calendar.json`, zapisywanym transakcyjnie razem z ICS. | Usunięcie sesji z aktywnego planu nie może zgubić jej tożsamości przed sprzątaniem kalendarza. Liczba zatwierdzonych propozycji nie wersjonuje rekalibracji ani ręcznych edycji YAML; odcisk eksportowanego zdarzenia obejmuje obie ścieżki bez modyfikowania planu podczas eksportu. | +| 047 | 2026-11-11 | Kształt sezonu jest kontraktem: `seasonProfile` i linty kształtu (`seasonShapeIssues`) liczone na macierzy 576 profili syntetycznych, z migawką w repo. Stałe generatora bez źródła mają regułę E-3. | 1076 testów przechodziło przy planie, w którym tydzień ładowania powtarza się 12 razy bez zmiany dawki: testy pilnowały reguł tygodnia, a nie sezonu. Migawka pokazuje zmianę kształtu w przeglądzie kodu (PLAN-v0.7, B0). | diff --git a/docs/PLAN-v0.7.md b/docs/PLAN-v0.7.md new file mode 100644 index 0000000..ed41bc8 --- /dev/null +++ b/docs/PLAN-v0.7.md @@ -0,0 +1,980 @@ +# Plan rozwoju po 0.6.0: treść planu biegowego, jedna warstwa prezentacji, ocena wykonania + +Samowystarczalny plan dla sesji Claude Code, w konwencji +[PLAN-v0.4.md](PLAN-v0.4.md). Kontekst produktu: [SPEC.md](../SPEC.md). +Warstwa naukowa: [docs/science/FOUNDATIONS.md](science/FOUNDATIONS.md) +i [docs/science/MULTISPORT.md](science/MULTISPORT.md). Granice potwierdzenia +wydania 0.6.0: [COACHING-VALIDATION.md](COACHING-VALIDATION.md). + +**Stan wyjściowy (2026-11-11):** `main` na `e6c922e`, wydanie 0.6.0 w sześciu +paczkach npm, 1076 testów w 75 plikach, typecheck czysty, 22 narzędzia MCP. +Etapy A–E z PLAN-v0.4 wyszły w 0.4.0. Wydanie 0.5.0 dodało rower, pływanie +i schemat sesji v2, wydanie 0.6.0 karty jednostek ze strukturą i skalą RPE. + +**Źródła planu:** + +- przegląd z 2026-11-11: cztery profile uruchomione prawdziwym CLI z + `TRAINCTL_TODAY`, opisane w §1 (ten dokument jest zapisem przeglądu); +- lektura `engine/macrocycle.ts`, `engine/microcycle.ts`, `engine/house-style.ts`, + `planfile.ts`, `commands.ts`, `sports-commands.ts`, `ui/blocks.ts`, + `ui/training.ts`, `execution.ts`, `ports/sync.ts`; +- PLAN-v0.4 §8: pozycja „repertuar zależny od celu i doświadczenia" odłożona + do czasu pomiaru w korpusie. Pomiar jest częścią etapu 1; +- COACHING-VALIDATION „Granice potwierdzenia": brak przeglądu trenerskiego + i próby na pełnym sezonie. + +**Zasada doboru zakresu.** Największe braki dotyczą treści planu biegowego, +dlatego silnik idzie przed wyglądem. Każda zmiana silnika zaczyna się od pomiaru +w korpusie albo od reguły w FOUNDATIONS. Prezentacja dostaje jedną notację +i jeden model wiersza dla biegu i multisportu. Ocena wykonania pozostaje opisem +faktów, bez automatycznych wniosków (ADR-011, ADR-027). + +**Decyzje właściciela** z §10 zostały przyjęte 2026-11-11 zgodnie +z rekomendacjami. Po etapie 1, tego samego dnia, plan dostał pięć dodatków: +przerwę w trakcie planu (B11), tętno jako drugą miarę celu (C8), mile (C9), +skróty klubowe jako opcję (C10) i pakiet terenowy (G). **Realizacja** ma cztery +etapy (§2), pakiet G startuje po nich. Praca jest opisana w pakietach A–G +(§3–§9). Po każdym etapie są testy i `/code-review` w zakresie etapu (§0). + +--- + +## 0. Reguły wykonania + +Obowiązuje w całości [PLAN-v0.4 §0](PLAN-v0.4.md): higiena sesji (`pnpm check`, +`pnpm build`, próba instalacji z tarballi, CHANGELOG na bieżąco, SPEC i oba +README razem, jeden commit na punkt pakietu) oraz twarde ograniczenia kodu (importy +`.ts`, bloki zamiast kolorów, oba języki, stałe z ID reguły, adaptacja +proponuje, sekrety i dane osobowe poza repo). + +Dodatkowo w tym planie: + +- **Najpierw nauka, potem kod.** Każdy punkt silnika zaczyna się od skryptu + w `tools/corpus/` i wpisu w FOUNDATIONS §10. Do repo trafiają wyłącznie + agregaty, tak jak w `house-style.ts`. Katalog `corpus/` jest lokalny i zostaje + poza repo. +- **Kształt planu jest testowany.** Od B0 każda zmiana silnika przechodzi przez + macierz profili syntetycznych i migawkę kształtu sezonu. Licznik testów + rośnie (dziś 1076). +- **Zmiana silnika podnosi wersję silnika** i jest widoczna przez + `compatibilityNotes`. Pierwsza regeneracja po aktualizacji zmienia przyszłe + dni. Dni przeszłe, zalogowane, przypięte i edytowane ręcznie zostają + (ADR-033). Wpis „Changed" w CHANGELOG jest obowiązkowy. +- **Backtest** (`backtest.test.ts`, lokalny korpus) zostaje w progach albo progi + są zmieniane jawnie, z uzasadnieniem w commicie. +- `docs/karuzela/` pozostaje nieśledzony. + +**Gałęzie.** Każdy etap ma własną gałąź od aktualnego `main`: +`plan-0.7/etap-1` do `plan-0.7/etap-4`. Commity po polsku, jeden na punkt +pakietu albo na spójną grupę punktów. Następny etap startuje po scaleniu +poprzedniego. + +**Zamknięcie każdego etapu**, w tej kolejności: + +1. `pnpm check` zielone. Licznik testów nie maleje. +2. `pnpm build` i próba instalacji z tarballi poza repo. +3. Testy własne etapu z tabeli w §2. +4. `/code-review high` z celem ustawionym na gałąź etapu, czyli na różnicę + względem `main`. Zakres przeglądu to zakres etapu. +5. Każde potwierdzone znalezisko w zakresie etapu dostaje poprawkę i test, + który bez poprawki zawodzi. Po poprawkach wracają kroki 1–4. Przegląd + kończy się na pierwszej rundzie bez błędu, który użytkownik może spotkać. + Błąd to zły wynik, awaria albo utrata danych w komendzie, w MCP albo przy + pliku, który użytkownik edytuje. Sugestie porządkowe (nazwy, powtórzony + kod, komentarze, styl) trafiają do rejestru w §14. Mogą wejść razem + z poprawkami błędów, ale same nie otwierają kolejnej rundy. Warunek + obowiązuje od etapu 2. Etap 1 miał warunek „zero potwierdzonych znalezisk" + i nie zbiegł po 24 rundach. +6. Znalezisko spoza zakresu etapu trafia do rejestru w §14 i nie jest naprawiane + w tym etapie. +7. CHANGELOG, SPEC z nowymi ADR-ami, oba README. +8. Scalenie gałęzi i wydanie to działania właściciela. + +--- + +## 1. Dowody z przeglądu + +Profile P1–P3: start `Półmaraton` 2027-03-28, wynik 10 km 43:00 +z 2026-09-27, dni `tue, wed, thu, sat, sun`, plan wygenerowany 2026-10-22, +25 tygodni. P4 to osobny katalog w schemacie v2. Zapis tygodnia: I interwały, +T akcent ciągły, E spokojne, L długie, TT sprawdzian, liczba to kilometry. + +| Profil | Różnica | Wynik | +|---|---|---| +| P1 | 45 km/tydz., siła | tydz. 1: 49 km, tyg. 2–21: 52 km, odciążenia 36 km | +| P2 | 12 km/tydz., `peakWeeklyKm: 50`, siła | wzrost z 13 do 38 km, trzy biegi w tygodniu, cztery tylko w tygodniach sprawdzianu | +| P2b | 12 km/tydz. bez `peakWeeklyKm` | szczyt 17 km, długie 6 km, jedno ostrzeżenie | +| P3 | jak P1 + `time.weeklyMinutes: 240` | tydzień ładowania 16 km, odciążenie 24 km, taper 29 km | +| P4 | v2: bieg, rower, pływanie po 2×45 min, cel bazowy | `week` 173 wiersze, `today` 69, `plan` 3 | + +**P1, tygodnie ładowania 2–21 (bez odciążeń i sprawdzianów):** + +``` +wt I8 3 km + 4×1 km @4:32, przerwy 2 min marsz + 1 km (tyg. 2–17) + 3 km + 4×1 km @4:04, przerwy 3 min trucht + 1 km (tyg. 18–21) +cz E17 +sb L19 +nd T8 3 km + 4 km narastająco 5:01 do 4:32 + 1 km (tyg. 2–17) + 3 km + 4 km zmiennie 4:25 / 5:05 + 1 km (tyg. 18–21) +``` + +Pozostałe tygodnie P1: odciążenie `wt I8, sb L13, nd E15`; tydzień sprawdzianu +(5, 11, 17) `wt E6, śr E6, cz podbiegi 12, sb TT9, nd L19`; taper +`wt I8, śr E10, cz E10, nd T8`; drugi tydzień po starcie `wt I10` z 6×1 km @4:32. + +**Obserwacje i mechanizm:** + +1. **Brak progresji.** Dawka akcentu to funkcja kilometrażu tygodnia + (`microcycle.ts:462`), a kilometraż osiąga szczyt w drugim tygodniu + (`macrocycle.ts:155–165`, `:240`). W tygodniach 2–21 plan ma trzy szablony: + ładowanie, odciążenie i sprawdzian. Tydzień ładowania powtarza się 12 razy + bez zmiany dawki. Baza i budowanie są identyczne, szczyt zmienia tempo + interwałów i typ drugiego akcentu. +2. **Długie nie rośnie i nie osiąga progu.** `longKm = min(round(0,356 × cel), 35)` + (`microcycle.ts:461`) daje 19 km. J-2 i P-7 podają dla półmaratonu >21 km. +3. **Brak pracy w tempie startowym.** `zones.marathon` służy tylko jako początek + biegu narastającego. +4. **Liczba biegów nie idzie za dostępnymi dniami.** + `ceil(km / typicalKmPerSession)` z `typicalKmPerSession: 14` + (`microcycle.ts:411–414`) daje 4 biegi przy 52 km i 3 biegi do 42 km. Stała + pochodzi z korpusu o medianie 64 km/tydz. +5. **Dzień podbiegów znika po cichu.** Gdy tydzień nie ma wolnego slotu + spokojnego, kod zamienia ostatni akcent ciągły albo podbiegi na bieg spokojny + i dokłada do niego całą resztę kilometrów (`microcycle.ts:531–535`). Stąd + czwartek 17 km w P1 i niedziela 16 km przy długim 14 km w P2. +6. **Długie nie jest najdłuższym biegiem tygodnia** w każdym odciążeniu P1 + (L13, E15) i w tygodniach 17, 18, 19 i 21 P2 (L12–L14, E13–E16). +7. **Liczba akcentów zależy od liczby dostępnych dni, a nie od liczby biegów.** + `qualityPerWeek` (`macrocycle.ts:177`) daje 2 akcenty przy ≥4 dniach, także + gdy tydzień ma 3 biegi. Pomiar z etapu 1 (S-12) pokazał, że trener robi tak + samo, więc to zostaje. +8. **Stała rama 3 km + 1 km i minimum 4 powtórzeń** (`microcycle.ts:168`) dają + sesję 8 km przy każdej objętości. W P2 to połowa tygodnia 16 km, a obok + powstaje bieg 2 km. +9. **Największa sesja interwałowa planu wypada 9 dni po starcie** (6×1 km wobec + 4×1 km w całym przygotowaniu). W tygodniu przejściowym nie ma drugiego + akcentu ani podbiegów, więc pętla I-5 nie przycina dawki. +10. **Pętla I-5 liczy udział spokojnego biegania przed rozdaniem reszty + kilometrów** (`microcycle.ts:489–504`), więc przycina akcenty mocniej, niż + wymaga reguła. Tydzień ładowania P1 kończy z 85% spokojnego biegania przy + progu 75%. +11. **Akcent wypada w niedzielę, dzień po długim.** Pomiar z etapu 1 pokazał, + że w korpusie to równie częsty układ jak odwrotny (S-9b). To nie jest + usterka, brakuje tylko wyjaśnienia w `why`. +12. **Budżet czasu odwraca strukturę.** `fitTimeBudget` (`planfile.ts:270–324`) + przycina każdy tydzień osobno do limitu minut, a minuty siły są stałe: + 2 sesje w tygodniu ładowania, 1 w odciążeniu, 0 w taperze. Im mniej siły, + tym więcej kilometrów. `check` zgłasza taper (T-4), odciążenia nie zgłasza. +13. **Mała baza kończy się ostrzeżeniem.** Bez `peakWeeklyKm` sufit to + `start × 1,4` (`macrocycle.ts:156`). Plan do półmaratonu rośnie z 12 do + 17 km z długim 6 km. FOUNDATIONS nie ma reguły powrotu po przerwie, a R-5 + się na nią powołuje. +14. **Dwa style widoków.** Plan biegowy: tabela z opisem słownym, który zawija + się do trzech wierszy, tempo biegu spokojnego dopiero w `why`. Plan v2: + pełna karta na sesję także w widoku tygodnia. +15. **Wykonanie porównywane tylko po dystansie** (`execution.ts:20–41`). + `SyncedActivity` nie ma okrążeń. + +--- + +## 2. Etapy realizacji + +Cztery etapy to minimum. Etap 1 musi być osobny, bo pomiar w korpusie +rozstrzyga, co zmienia się w silniku. Etap 4 musi być osobny, bo zmiana modelu +danych w jednym przeglądzie ze zmianą silnika nie dałaby się ocenić. + +| Etap | Wydanie | Zakres | Testy własne etapu | +|---|---|---|---| +| **1. Fundament** | 0.6.1 | pakiet A; B0; B9; wszystkie pomiary (`tools/corpus/season_profile.py`) i wpisy FOUNDATIONS z punktów „Nauka" w B1–B8; wskaźnik bieżącego planu w `CLAUDE.md` | migawka macierzy utworzona na niezmienionym silniku i bez różnic na końcu etapu; `tools/corpus/test_parse_plans.py` | +| **2. Silnik biegowy** | 0.7.0 | B1–B8, B10, B11; pola segmentu i poprawki zapisu z C1; linty kształtu podpięte do `check` | macierz bez pięciu lintów kształtu; DoD pakietu B na P1–P3; `regenerate.test.ts`, `cycle.test.ts`, `engine-060.test.ts`, `time-budgets.test.ts`; przerwa w trakcie planu w `adapt.test.ts` i `adapt-desk.test.ts`; backtest lokalnie; `pnpm simulate:coaching`, `pnpm simulate:multisport` | +| **3. Widoki i wykonanie** | 0.8.0 | C1–C10, D1–D5, F3 | migawki przy 60, 80, 100, 120 kolumnach w PL, EN i ASCII, także w milach; budżety wierszy z C2; pułap tętna według Z-2; MCP bez ANSI; syntetyczne FIT i TCX; `pnpm plugin:build` i `scripts/verify-plugin.mjs` | +| **4. Jeden model danych** | 0.9.0 | pakiet E | ten sam kształt sezonu w v1 i v2 na macierzy; lista parytetu; migracja; `pnpm simulate:multisport --artifacts`; weryfikacja pluginu | + +**Stan (2026-11-11):** etap 1 zrealizowany na gałęzi `plan-0.7/etap-1`, +scalenie zatwierdzone przez właściciela. Bramka: `pnpm check` 1204 testy, +`pnpm build`, `verify:distribution` PASS, testy korpusu. Przegląd +`/code-review high`: 24 rundy, każde przyjęte znalezisko z testem sprawdzonym +mutacją. Rundy nie zbiegły do zera. Późne rundy dawały pojedyncze przypadki +brzegowe (głównie odczyt ręcznie edytowanego `log.jsonl`) i sugestie +porządkowe. Odrzucone sugestie są w §14. Po etapie 1 zmienił się warunek końca +przeglądu (§0, krok 5) i doszły punkty B11, C8–C10 oraz pakiet G. + +**Etap 1** nie zmienia żadnej liczby w silniku ani zapisanych planów. Pierwszy +commit tworzy migawkę macierzy na silniku z 0.6.0. Linty kształtu działają +w tym etapie tylko w teście macierzy. Do `check` trafiają w etapie 2, żeby +`check --strict` w CI użytkowników nie zaczął zawodzić w wydaniu poprawkowym. +Wynik etapu to lista odpaleń lintów na macierzy i tabela pomiarów +w FOUNDATIONS. Jeśli pomiar przeczy propozycji z pakietu B, punkt jest +korygowany w tym dokumencie przed startem etapu 2. + +**Etap 2**, kolejność commitów: B1 z B2, B3, B4, B5, B6, B8, B11, B7, B10. +B11 idzie po B8, bo korzysta z tego samego protokołu powrotu. B7 jest na końcu, +bo budżet przycina gotowy kształt. Etap ma jedną zmianę wersji +silnika i jedną zmianę przyszłych dni przy regeneracji, dlatego obejmuje też +nowe pola segmentu i poprawki zapisu opisów (decyzja 4). + +**Etap 3**, kolejność commitów: C1, C2, C3 z C4, C5 z C6, C8, C9, D1, D2 z D3, +D4 z D5, C10, C7 z F3. C8 rozszerza notację z C1 i karty z C5. C9 idzie przed +pakietem D, żeby tabela `review` od razu znała mile. C10 jest ostatni przed +dokumentacją. Jeśli etap urośnie, C10 przechodzi do następnego planu jako +pierwszy. + +**Etap 4**: kroki 1–4 pakietu E w podanej kolejności. + +**Poza etapami**, działania właściciela: wydanie po każdym etapie; F1 po +etapie 2, z wynikiem przed startem etapu 4; F2 przez cały sezon. Pakiet G (§9) +startuje po etapie 4, od pomiaru. + +--- + +## 3. Pakiet A: poprawki tekstu i etykiet (etap 1) + +Każdy punkt: objaw, miejsce, zmiana, test. Żaden nie zmienia zapisanego planu. + +### A1. `review`: tabela wykonania ma nagłówki z tabeli zmian + +- **Objaw:** „Wykonanie dzień po dniu" ma kolumny „Przed zmianą", „Po zmianie", + „Dane wykonania" dla planu, wykonania i statusu. +- **Miejsce:** `commands.ts:1455` używa `ui().improve.before/after/data` + (`improve-pl.ts:29`, `:45`). +- **Zmiana:** osobne klucze `review.columns.planned/actual/status` + („Plan", „Wykonanie", „Status") w obu językach. +- **Test:** `review.test.ts`: nagłówki w PL i EN; `cli-i18n.test.ts`. + +### A2. `review`: „Do startu: do startu: 150 dni" + +- **Miejsce:** `commands.ts:1531` łączy etykietę `review.toRace` z + `raceDistanceLine`, które samo zaczyna się od „do startu:" (`cli-pl.ts:238`). +- **Zmiana:** rozdzielić wartość („150 dni") od zdania z etykietą. `today` + i `status` biorą tę samą wartość. +- **Test:** `review.test.ts`: brak powtórzonej etykiety w obu językach. + +### A3. Liczby dziesiętne w jednym formacie na język + +- **Objaw:** „21.0975 km" w `plan` i `why`, a „21,1 km" w ostrzeżeniu tego + samego `plan`; „VDOT 47.7" w `plan` i `why`, „47,7" w `status` i `PLAN.md`. +- **Miejsce:** `commands.ts:396`, `:404`; ręczne interpolacje liczb. +- **Zmiana:** funkcje `fmtKm` i `fmtDecimal` w `core/i18n/locale.ts`: przecinek + w PL, kropka w EN, dystans startu do jednego miejsca („21,1 km"). Wszystkie + widoki i `PLAN.md` przechodzą przez nie. +- **Test:** `no-leaks.test.ts`: brak wzorca `\d\.\d` w polskim wyjściu `plan`, + `why`, `status`, `week`; test jednostkowy formatowania. + +### A4. „taper: tyg. 22–22" + +- **Miejsce:** `phaseSpan` w `cli-pl.ts:194` i odpowiednik EN. +- **Zmiana:** jeden tydzień drukowany jako „tyg. 22". +- **Test:** `commands.test.ts` dla planu z jednotygodniowym taperem. + +### A5. Status z dziennika po angielsku w polskim wyjściu + +- **Objaw:** `[done]` w `week` (`commands.ts:615`), „ostatni 2026-10-27 (done)" + w `status`. +- **Zmiana:** słowo z katalogu („wykonany", „opuszczony", „częściowo"). + `data.status` zostaje surowym enumem dla MCP i `--json`. +- **Test:** `no-leaks.test.ts` w obu kierunkach; `--json` bez zmian. + +### A6. Zawijanie rozcina adresy i ścieżki + +- **Objaw:** „FOUNDATION / S.md" w `why`, ścieżka katalogu w `status`. +- **Miejsce:** `wrap()` w `ui/blocks.ts:69–76` tnie słowo dłuższe niż wiersz po + grafemach. +- **Zmiana:** token zaczynający się od `http://`, `https://` albo wyglądający na + ścieżkę trafia do osobnego wiersza w całości. Terminal zawinie go sam, a link + zostaje klikalny. +- **Test:** test `wrap` przy szerokościach 40, 60 i 80. + +### A7. Wiek wyniku kalibracyjnego liczony od dwóch dat + +- **Objaw:** `status` „sprzed 32 dni" (od dziś), `why` „sprzed 25 dni" (od daty + kalibracji planu) dla tego samego wyniku. +- **Miejsce:** `status.ts:94`, `calibration.ts:16`. +- **Zmiana:** oba widoki podają wiek od dziś. `why` dodaje datę kalibracji + osobnym polem. +- **Test:** `coach-flows.test.ts` z `TRAINCTL_TODAY` późniejszym niż plan. + +### A8. „cel 52 km · zaplanowano 52 km" + +- **Zmiana:** gdy obie liczby są równe, `week` drukuje jedną. Różnica zostaje + widoczna jak dziś. +- **Test:** `commands.test.ts`. + +### A9. Zamknięcie pakietu + +CHANGELOG „Fixed", bez zmian w silniku i w `plan.yaml`. + +--- + +## 4. Pakiet B: silnik biegowy (etapy 1 i 2) + +B0, B9 i pomiary z punktów „Nauka" należą do etapu 1. B1–B8, B10 i B11 to etap 2, +w jednym wydaniu 0.7.0. Wartości oznaczone „inż." to propozycje do potwierdzenia pomiarem. Bez pomiaru +zostają w kodzie z komentarzem „inż." i wpisem w FOUNDATIONS. + +### B0. Narzędzie pomiaru: profil sezonu, macierz profili, linty kształtu + +- **Nowa funkcja:** `seasonProfile(plan): SeasonRow[]` w + `packages/core/src/engine/season.ts`. Wiersz tygodnia: indeks, data, faza, + odciążenie, km, liczba biegów, km długiego, lista akcentów z dawką części + głównej (powtórzenia, długość, tempo), liczba sesji siły, flagi. +- **Macierz profili syntetycznych** w `plan-shape.test.ts`: baza 12, 25, 45, + 70 km × dni 3, 4, 5, 6 × cel 10 km, półmaraton, maraton, baza × horyzont 8, + 16, 24 tygodnie × budżet brak, 240, 360 min. Migawka tekstowa kształtu sezonu + w repo. Profile bez danych osobowych. +- **Nowe ostrzeżenia w `validate.ts`** (`warn`, opisy w obu językach przez + `describeIssue`): + - `longNotLongest`: bieg spokojny dłuższy niż długie w tym samym tygodniu; + - `deloadNotLighter`: tydzień odciążenia ≥ lżejszy z sąsiednich tygodni + ładowania (P-2); + - `sessionShareHigh`: jednostka inna niż długie, start i sprawdzian ponad + 35% kilometrów tygodnia (inż.); + - `postRaceAccentHeavy`: akcent w bloku przejściowym większy niż mediana + akcentów ostatniego bloku budowania (R-8); + - `staleProgression`: dwa kolejne bloki ładowania w fazie budowania albo + szczytu z identyczną dawką obu akcentów i długiego (P-1, inż.); + - `longBelowGoal`: najdłuższy bieg planu poniżej progu J-2 albo P-8. To + ostrzeżenie wykonalności w `plan`, a nie lint tygodnia. +- **Podpięcie:** w etapie 1 linty kształtu działają tylko w teście macierzy. + Do `check` i `trainctl_check` trafiają w etapie 2. +- **Stan oczekiwany po B0:** ostrzeżenia odpalają się na P1–P3. Lista tych + odpaleń jest definicją ukończenia B1–B8: na macierzy ma ich nie być albo mają + być zastąpione jawnym ostrzeżeniem wykonalności. +- **Test:** `validate.test.ts` po jednym przypadku na kod; `check.test.ts`. + +### B1. Liczba biegów i układ tygodnia + +- **Objaw:** obserwacje 4, 5, 6, 7 z §1. +- **Nauka (wykonana w etapie 1, FOUNDATIONS §10.15):** S-10 — najdłuższy + inny bieg spokojny to mediana 0,60–0,83 i P90 0,67–0,91 długiego (130 + tygodni). Że długie jest najdłuższe, wynika z definicji jednostki (J-1, S-2). S-11 — liczba biegów rośnie z objętością tak, jak liczy + `typicalKmPerSession` 14, od 30 km w górę. S-12 — przy trzech biegach trener + daje dwa akcenty. +- **Zmiana (po pomiarze):** + 1. sufit biegu spokojnego `min(EASY_RUN_CAP_KM, 0,9 × długie)` (S-10, P90). Gdy reszta + kilometrów go przekracza i jest wolny dostępny dzień, dochodzi bieg (S-11); + 2. liczba akcentów bez zmian. Propozycja ograniczenia akcentów przy trzech + biegach odpada (S-12); + 3. gałąź `microcycle.ts:531–535` respektuje sufit biegu spokojnego. Reszta + kilometrów, której nie da się rozdać, obniża `totalKm` i zostawia flagę + w szkielecie; + 4. usunięcie dnia podbiegów zapisuje flagę widoczną w `why`. +- **Test:** macierz B0 bez `longNotLongest`; `microcycle.test.ts` dla 3, 4, 5 + dni przy 30, 45, 60 km; backtest w progach. + +### B2. Rama i minimalna dawka przy małej objętości + +- **Objaw:** obserwacja 8. Sprawdzian 9 km w tygodniu 21 km w P2. +- **Zmiana:** + 1. gdy akcent przekroczyłby 35% tygodnia (inż.), rozgrzewka schodzi do 2 km, + a minimum powtórzeń do 3. Jeśli to nie wystarcza, tydzień dostaje bieg + spokojny z przebieżkami (J-6, opisane jako praktyka) w miejsce akcentu; + 2. minimalny bieg spokojny 3 km (inż.). Krótsza reszta dolicza się do innego + biegu; + 3. warunek sprawdzianu (`macrocycle.ts:269`) liczy całą jednostkę z ramą. +- **Test:** macierz B0 bez `sessionShareHigh`; `microcycle.test.ts` dla 12, 16, + 20 km. + +### B3. Trajektoria objętości + +- **Objaw:** obserwacja 1. +- **Nauka (wykonana, §10.15):** P-12 — szczyt 5–7 tygodni przed startem ≥ HM, + około 0,6 szczytu 13–15 tygodni przed (n = 3). T-7 podaje około 4 tygodnie. + Silnik trzyma się T-7 i P-12 razem: szczyt w ostatnim bloku ładowania przed + taperem. +- **Zmiana:** + 1. wzrost od `recentWeeklyKm` do szczytu rozłożony na bloki ładowania tak, by + szczyt wypadł w ostatnim bloku przed taperem. Biegacz już na szczycie + zaczyna od około 0,7 szczytu (P-12, inż. dla dokładnej wartości). Tempo wzrostu to mniejsza z wartości P-3 + i potrzebnej; + 2. fala w bloku: trzy tygodnie ładowania rosną, np. 0,94, 0,97, 1,00 poziomu + bloku (inż.), czwarty to odciążenie; + 3. biegacz, który jest już na docelowym szczycie, dostaje tę samą falę wokół + plateau; + 4. `start × 1,4` i `start × 1,15` dostają ID reguły albo etykietę „inż." + (patrz B9). +- **Test:** `macrocycle.test.ts`: tydzień szczytu względem startu, monotonia + bloków, taper bez zmian (T-4, T-5); macierz B0 bez `staleProgression` dla + objętości. + +### B4. Długie wybieganie + +- **Objaw:** obserwacja 2. +- **Nauka (wykonana, §10.15):** J-10 — długie rośnie z ~15 km 15 tygodni przed + startem do 23–25 km 2–7 tygodni przed (n = 3). Udział długiego w tygodniu + 0,29–0,41 według objętości. +- **Zmiana:** + 1. osobny tor długiego: cel zależny od dystansu (półmaraton 22 km, maraton + 30–32 km, krócej według udziału), osiągany w bloku szczytowym; + 2. krok do 2 km na tydzień ładowania (inż.), spadek w odciążeniu, sufit + udziału w tygodniu według P90 z korpusu; + 3. gdy objętość nie uniesie progu, `plan` pokazuje `longBelowGoal` + z liczbami; + 4. długie z odcinkami w tempie startowym dopiero po pomiarze. PLAN-v0.4 §8 + odnotował, że w korpusie to krótszy wzorzec, a nie długie z dodatkiem. +- **Test:** macierz B0: P1 osiąga >21 km przed taperem; maraton nie przekracza + 35 km (N-19); `validate.test.ts` `longOverCap` bez zmian. + +### B5. Progresja akcentów i repertuar + +- **Objaw:** obserwacje 1, 3, 9, 10. +- **Nauka (wykonana, §10.15):** J-8 — km poza Z1 na sesję rosną ~3 → 7,5 → 9 + → 10 w kolejnych pasmach czterotygodniowych przed startem. J-9 — praca + ciągła wydłuża się z 7 do 12–15 km. Tempa startowego korpus nie potwierdza + (§11.2 p. 12), więc jednostek „w tempie startowym" nie dodajemy. J-4 + (drabinki 1000/400/200 m) jest zapisana, a kod jej nie realizuje. +- **Zmiana:** + 1. pętla I-5 liczy udział po rozdaniu reszty kilometrów; + 2. dawka = dawka bazowa z kilometrażu + krok za tydzień w bloku, ograniczona + przez I-5, udział mocnych kilometrów 25% i sufit jednostki. Po odciążeniu + blok startuje z poziomu drugiego tygodnia poprzedniego bloku (inż.); + 3. biblioteka jednostek według fazy: drabinka J-4 w szczycie, wydłużany + blok ciągły w budowaniu (J-9), bez jednostek w tempie startowym; + 4. akcent w drugim tygodniu po starcie nie większy niż najmniejszy akcent + ostatniego bloku budowania. +- **Test:** macierz B0 bez `staleProgression` i `postRaceAccentHeavy`; + `microcycle.test.ts` dla kroku w bloku; `easyShareLow` nie pojawia się na + świeżym planie; backtest: liczba akcentów bez zmian. + +### B6. Kolejność weekendu + +- **Objaw:** obserwacja 11. Sprawdzian w sobotę i 19 km w niedzielę. +- **Nauka (wykonana, §10.15):** S-9b — „długie→akcent" 52 razy, + „akcent→długie" 53 razy; dzień po długim to wolne 82 razy i akcent 72 razy + (na 160). + Po sobotnim starcie niedzielny bieg ma medianę 25 km (n = 15, T-11). +- **Zmiana (po pomiarze):** układ zostaje. `why` dla akcentu dzień po długim + i dla długiego dzień po sprawdzianie cytuje S-9b albo T-11. +- **Test:** `coach-flows.test.ts`: zdanie z S-9b w `why`; `validate.test.ts` + `accentGap` bez zmian. + +### B7. Budżet czasu zachowuje kształt makrocyklu + +- **Objaw:** obserwacja 12. +- **Zmiana:** + 1. z budżetu tygodnia wyliczyć sufit kilometrów dla tygodnia ładowania + (z siłą taką, jaka w nim wypada) i podać go planerowi makrocyklu jako + ograniczenie szczytu. Odciążenie i taper liczą się od tego szczytu; + 2. przycinanie tydzień po tygodniu w `fitTimeBudget` zostaje jako + zabezpieczenie i nie może podnieść tygodnia ponad sąsiednie tygodnie + ładowania; + 3. gdy sufit spycha szczyt poniżej P-7 albo P-8, ostrzeżenie podaje dwie + jawne możliwości: jedna sesja siły tygodniowo (F-14) albo większy budżet. + Silnik niczego nie zmienia sam; + 4. opis E-2 w FOUNDATIONS §10.14 zaktualizowany. +- **Uwaga:** ten obszar miał najwięcej regresji w 0.4.0. Zmiany dotykają + `scaleToBaseline`, `uncappedKm`, `timeCappedKm` i `budgetWarnings`. +- **Test:** P3: odciążenie poniżej ładowania, taper nie większy niż ostatni + tydzień ładowania, `check` bez T-4; pełne `regenerate.test.ts`, + `cycle.test.ts`, `engine-060.test.ts`, `time-budgets.test.ts`; nowe przypadki + weryfikowane mutacją. + +### B8. Mała baza i powrót po przerwie + +- **Objaw:** obserwacja 13. +- **Nauka (wykonana, §10.15):** R-11 jako wartość inżynierska: start z ~50–60% + objętości sprzed przerwy, pierwszy blok spokojnie, wzrost w granicach P-3. + RCT dotyczącego progresji powrotu nie znaleziono (§11.2 p. 11). +- **Zmiana:** + 1. profil: `athlete.returning: { since, previousWeeklyKm }` z walidacją + w `config.ts`. Kreator `init` pyta o przerwę. `init --from-intervals` + proponuje wartości z historii (`infer-profile.ts`); + 2. silnik: pierwszy blok wyłącznie spokojny, wzrost w stronę poprzedniej + objętości w granicach R-11, bez sprawdzianu w pierwszym bloku; + 3. werdykt wykonalności w `plan`: jeden blok z trzema liczbami (szczyt planu, + próg dla dystansu, najdłuższy bieg) i trzema wyjściami: data, od której + próg jest osiągalny, podanie `peakWeeklyKm` z historii, cel bazowy + (`goal.kind: base`). +- **Test:** `macrocycle.test.ts` dla 12 km z przerwą i bez; `commands.test.ts` + dla werdyktu; `interactive.test.ts` dla kreatora. + +### B9. Stałe silnika bez ID reguły i bez etykiety „inż." + +Reguła 4 z `CLAUDE.md`. Do oznaczenia albo podparcia regułą: + +| Miejsce | Stała | +|---|---| +| `macrocycle.ts:156` | sufit `start × 1,4` bez `peakWeeklyKm` | +| `macrocycle.ts:164` | wzrost `start × 1,15` dla planu ze startem | +| `macrocycle.ts:173–174` | podział faz 0,4 i 0,2 | +| `microcycle.ts:462` | część główna akcentu `0,22 × km` | +| `microcycle.ts:464` | odcinek spokojny przed podbiegami 5–8 km, `0,1 × km` | +| `microcycle.ts:482`, `:526`, `:534`, `:540` | sufit biegu spokojnego 18 km | +| `microcycle.ts:513` | udział mocnych kilometrów 25% | +| `microcycle.ts:150`, `:164`, `:175` | przerwy 120 i 180 s | +| `microcycle.ts:225–226` | przedstartowe 5×300 m | +| `microcycle.ts:393–394` | tydzień startowy: `(sessionCount ?? 4) − 1`, biegi po 5 km | + +- **Test:** `cmdRules` pokazuje nowe wpisy; przegląd ręczny z listą w opisie PR. + +### B10. Zamknięcie pakietu + +FOUNDATIONS §10 (J-8, J-9, R-11, zmiany E-2, etykiety z B9) i §11; SPEC: nowe +ADR-y z §11 tego planu, „znane uproszczenia silnika"; oba README (pole +`athlete.returning`, zapis przerwy w `log`); CHANGELOG „Changed" z opisem, co zmieni pierwsza +regeneracja; `backtest` uruchomiony lokalnie, wynik w opisie PR. + +### B11. Przerwa w trakcie planu + +Punkt dopisany po etapie 1 (decyzja 9 z §10). + +- **Objaw:** choroba albo wyjazd w środku planu nie mają ścieżki. `adapt` + rozpoznaje przerwę od 10 dni (`adapt.ts:74`) i podaje objętość restartu + ×0,55 (R-5), ale tej propozycji nie da się przyjąć (`proposals.ts:126`, + `manualRecovery`). Przerwy nie da się zapisać z przyczyną ani z góry. Plan po + powrocie pokazuje tygodnie sprzed przerwy. +- **Nauka:** R-5 (po chorobie objętość ×0,5–0,6 i zero Z3 przez 5–7 dni), + R-11 z B8 (przerwa bez choroby), R-6 i R-7 (objawy do lekarza, bez porad + medycznych). R-5 to ekstrapolacja, R-11 wartość inżynierska. Propozycja + zachowuje dzisiejsze ostrzeżenie `restartExtrapolated`. +- **Zmiana:** + 1. zapis przerwy w dzienniku: `log` przyjmuje zakres dni (`--date` z `--to`) + i przyczynę (`--reason illness|injury|travel|other`). Każdy dzień dostaje + wpis `skipped` z przyczyną. Zapis z góry, np. przed wyjazdem, działa tak + samo. Te same pola przyjmują kreator dziennika i `trainctl_log` w MCP; + 2. `adapt` po zapisanej albo wykrytej przerwie proponuje blok powrotu do + przyjęcia. Choroba: R-5. Inna przyczyna: R-11. Wzrost w granicach P-3 do + objętości sprzed przerwy, potem plan wraca do swojego kształtu; + 3. przyczyna `injury` nie dostaje propozycji objętości. `adapt` podaje R-6 + i R-7: powrót ustala specjalista; + 4. po przyjęciu regeneracja przebudowuje dni od powrotu. Dni przeszłe, + zalogowane, przypięte i edytowane ręcznie zostają (ADR-033). Silnik + niczego nie zmienia bez zgody (ADR-011, ADR-029); + 5. gdy blok powrotu spycha szczyt poniżej progu dystansu, `plan` pokazuje + werdykt wykonalności z B8 liczony od dnia powrotu. +- **Test:** `adapt.test.ts`: przerwa z chorobą i bez, `injury` bez objętości; + `adapt-desk.test.ts`: przyjęcie propozycji, dni przeszłe bez zmian, pierwszy + tydzień bez Z3 po chorobie; `log` z zakresem i przyczyną, także w MCP; + macierz B0 bez nowych odpaleń lintów po bloku powrotu. + +**DoD pakietu B (etap 2):** macierz B0 bez `longNotLongest`, `deloadNotLighter`, +`sessionShareHigh`, `postRaceAccentHeavy`, `staleProgression`; P1 osiąga +długie >21 km; P3 zachowuje kształt; P2b dostaje werdykt wykonalności +z wyjściami; przerwa zapisana w środku planu daje propozycję `adapt`, którą +można przyjąć, a bez zgody plan się nie zmienia; każda nowa i stara stała ma +ID albo etykietę. + +--- + +## 5. Pakiet C: jedna warstwa prezentacji (etap 3) + +### C1. Notacja jednostki generowana ze struktury + +- **Dziś:** widoki drukują `segments[].description`, czyli zdania w stylu + korpusu (`core-pl.ts:77–98`). Rodzaj przerwy (marsz albo trucht) i przerwa + w połowie serii istnieją tylko w tekście. +- **Zmiana:** + 1. `PlannedSegment` dostaje opcjonalne pola `recoveryMode: 'walk' | 'jog'` + i `setBreak: { afterRep, sec, mode }`. Stare plany bez tych pól działają: + notacja pomija rodzaj przerwy; + 2. czysta funkcja `sessionLine(workout | session, locale)` w core, bez ANSI, + wspólna dla `PlannedWorkout` i kroków v2; + 3. opis słowny zostaje w `plan.yaml` i w `why`. Dwie poprawki zapisu: + „2-minutowe" zamiast „2 minutowe" (`core-pl.ts:22–23`) i `×` zamiast `*`. + To zmienia tekst przyszłych dni przy regeneracji (patrz §13). + Punkty 1 i 3 wchodzą w etapie 2 razem ze zmianą silnika, żeby przyszłe dni + zmieniły się raz. Punkt 2 to etap 3. +- **Specyfikacja notacji:** + + | Element | PL | EN | Bez Unicode | + |---|---|---|---| + | powtórzenia | `4×1 km` | `4×1 km` | `4x1 km` | + | tempo | `@4:32`, zakres `@5:05–6:05` | to samo | `@5:05-6:05` | + | narastanie | `5:01→4:32` | to samo | `5:01->4:32` | + | zmienny | `1 km @4:25 / 1 km @5:05` | to samo | to samo | + | przerwa | `p. 2' marsz`, `p. 3' trucht` | `r. 2' walk`, `r. 3' jog` | to samo | + | rama | `RG 3 km`, `SCH 1 km` | `WU 3 km`, `CD 1 km` | to samo | + | czas | `2'` minuty, `30"` sekundy | to samo | to samo | + + Jednostka tempa (min/km) i skróty są objaśnione w jednym wierszu legendy pod + widokiem oraz w `help`. +- **Test:** test jednostkowy na każdy typ segmentu i kroku v2 w obu językach + i w ASCII; brak `\x1b[`; `no-leaks.test.ts`. + +### C2. Trzy poziomy szczegółowości + +Wspólny model wiersza `SessionRow { date, weekday, sport, kind, km, minutes, +line, status }` budowany z planu v1 i z planu v2. Handlery zwracają bloki. +Blok `table` dostaje opcjonalny wiersz sumy (`foot`). To jedyna zmiana w +`ui/blocks.ts`. + +**Sezon** (`trainctl season`, nowa komenda tylko do odczytu, oraz ta sama +siatka w wyjściu `plan`). Makieta z liczb P1: + +``` +tydz od faza km akcenty długie + 1 19.10 baza 49 4×1 km @4:32 · 4 km 5:01→4:32 17 + 2 26.10 baza 52 4×1 km @4:32 · 4 km 5:01→4:32 19 + 4 09.11 baza ↓ 36 4×1 km @4:32 13 + 5 16.11 baza 52 podbiegi · sprawdzian 5 km 19 + 18 15.02 szczyt 52 4×1 km @4:04 · zmienny 4 km 19 + 23 22.03 start 16 5×300 m @4:04 START +``` + +**Tydzień** (`week`): jeden wiersz na jednostkę, suma, znacznik dnia. +Makieta z tygodnia 2 P1: + +``` +Tydzień 2/25 · baza · 26.10–1.11 · 52 km · 4 biegi · 2 siły + + dz typ km czas rozpiska + pn wolne + ✓ wt interwały 8 1:06 RG 3 km · 4×1 km @4:32 p. 2' marsz · SCH 1 km + śr siła 0:35 + ▸ cz spokojne 17 1:59 17 km @5:05–6:05 + pt siła 0:35 + sb długie 19 2:21 19 km @6:05–6:35 + nd narastające 8 1:00 RG 3 km · 4 km 5:01→4:32 · SCH 1 km + ── ──── + 52 7:36 +``` + +**Dzień** (`today`): struktura z celami, czas, następna jednostka. + +``` +wt 27.10 · interwały · 8 km · około 66 min · tydz. 2/25 baza + + rozgrzewka 3 km 5:05–6:05 + główna 4×1 km 4:25–4:38 przerwa 2' marsz + schłodzenie 1 km trucht +``` + +- **Zasady:** + - stałe kolumny typu, dystansu, czasu i rozpiski we wszystkich widokach; + - tempo biegu spokojnego i długiego widoczne w `week` i `today`, a nie + dopiero w `why`; + - status słowem w wyjściu tekstowym i MCP, symbolem dodatkowo w terminalu; + - pełne karty (cel, uzasadnienie, wskazówki, skala RPE) w `why` i pod flagą + `--full`. Skala RPE drukowana raz na widok; + - plan v2: kilka sesji dziennie to kilka wierszy z jednym oznaczeniem dnia + i kolumną sportu. +- **Budżety wierszy przy 80 kolumnach (DoD):** `week` biegowy do 14 wierszy, + `week` v2 do liczby sesji + 9 (dziś 173 dla sześciu sesji), `today` do 18 + (dziś 69 w v2), `season` do liczby tygodni + 10. +- **Miejsce:** `cmdWeek` `commands.ts:599–643`, `cmdToday` `:521–597`, szkic + faz w `planImpl` `:438–451`, gałąź `today/week/why/status` w + `sports-commands.ts:129–162`, `trainingCard` w `ui/training.ts`. +- **Test:** migawki przy 60, 80, 100, 120 kolumnach, `NO_COLOR`, ASCII, PL i EN; + test MCP: te same dane w `structuredContent`; `bin.test.ts`; uzupełnienia + powłoki i `help season`. + +### C3. `PLAN.md` w tym samym układzie + +- **Dziś:** `renderMarkdown` (`planfile.ts:570–624`) drukuje 25 tabel z opisem + słownym. +- **Zmiana:** na górze siatka sezonu, niżej tygodnie w układzie wiersza z C2. + Eksporty `print` i `mobile` (`packages/export`) korzystają z tej samej + funkcji wiersza. +- **Test:** `docs.test.ts` i testy eksportu; plan v1 i v2. + +### C4. `plan` w katalogu v2 + +- **Objaw:** P4: `plan` drukuje „Plan jest aktualny" i ostrzeżenie MS-1. +- **Zmiana:** nagłówek jak w planie biegowym (cel, horyzont, czas tygodniowy na + sport) i siatka sezonu. +- **Test:** test `sportsCommand('plan')` dla planu aktualnego i zmienionego. + +### C5. Wskazówka wysiłku dla jednostek biegowych + +- **Dziś:** bieg w planie v2 niesie `legacyWorkout` z jednym krokiem + `target: open` (`sports-running.ts:25`). Karta pisze „Nie określono zakresu + RPE". +- **Zmiana:** planowana wskazówka RPE dla typu segmentu biegowego, tą samą + drogą co w rowerze i pływaniu (MS-6, „inż."). To opis zamiaru. Nie służy do + kalibracji stref (Z-4) ani do oceny wykonania (ADR-027). +- **Test:** karta biegu ma zakres RPE; `adapt` i `review` nie czytają tej + wartości. + +### C6. Teksty poza katalogami + +- **Dziś:** `getLocale() === 'pl' ? pl : en` w `ui/training.ts`, + `sports-transaction.ts`, `core/sports/coaching.ts`. Strażnicy katalogów tych + tekstów nie widzą. +- **Zmiana:** przenieść do katalogów (`cli-en.ts` jako źródło typu, teksty + domenowe w `core/i18n`). `cli-i18n.test.ts` i `no-leaks.test.ts` obejmują + wyjście v2. +- **Test:** strażnicy; brak wzorca `getLocale() ===` poza `i18n/`. + +### C7. Dokumentacja + +Oba README, `docs/MULTISPORT.md`, `docs/REVIEWED-ADAPTATION.md`, generator +`AGENTS.md` (`agents-md.ts`) i skille pluginu (`plugin-skills.ts`), jeśli +cytują stare wyjście. ADR dla komendy `season` i notacji. Pola profilu z C8–C10 +(`athlete.hrMax`, `units`, `notation`) w obu README. + +### C8. Tętno jako druga miara celu + +Punkty C8–C10 dopisane po etapie 1 (decyzje 2, 7 i 10 z §10). + +- **Dziś:** cele biegowe są w tempie. Profil nie ma tętna maksymalnego. Część + biegaczy trenuje po tętnie, a tempo zawodzi w terenie i w upale. +- **Nauka:** Z-3 (tempo dokładniejsze od tętna, zostaje celem głównym), Z-2 + (LT1 przy 78,9% HRmax u mężczyzn i 83,6% u kobiet), N-13 (bez wspólnego + %HRmax dla obu płci), Z-5 (ostrzeżenie przy HRmax szacowanym), Z-6 (bez + progów z zegarka). +- **Zmiana:** + 1. profil: opcjonalne `athlete.hrMax: { bpm, measured }` z walidacją + w `config.ts`. Kreator `init` pyta o nie. `init --from-intervals` może + zaproponować najwyższe tętno z historii jako wartość szacowaną; + 2. biegi spokojne i długie dostają pułap tętna z Z-2 według `athlete.sex`. + Tempo zostaje celem głównym, pułap jest dopisany do wiersza i karty. Bez + płci w profilu pułapu nie ma (N-13), a `why` mówi dlaczego; + 3. przy `measured: false` widok z pułapem pokazuje raz ostrzeżenie Z-5; + 4. akcenty zostają przy tempie. `review` i `adapt` nie oceniają tętna (D3); + 5. eksport do intervals.icu: sprawdzić w składni treningu, czy krok przyjmuje + drugi cel. Jeśli nie, pułap trafia do opisu kroku. +- **Test:** pułap dla obu płci z Z-2; brak pułapu bez płci; ostrzeżenie Z-5; + akcent bez pułapu; `review` bez oceny tętna; eksport. + +### C9. Mile i tempo na milę + +- **Dziś:** wyjście zna tylko kilometry i tempo na kilometr, także po + angielsku. +- **Zmiana:** + 1. `units: metric | imperial` w `trainctl.yaml` i flaga globalna `--units`. + Domyślnie `metric`. Jednostka nie zależy od języka; + 2. przeliczenie tylko w warstwie widoku: `kmLabel`, tempo, notacja z C1, + wiersz z C2, `PLAN.md` oraz eksporty `print` i `mobile`; + 3. `plan.yaml`, `log.jsonl`, `--json`, `structuredContent` i synchronizacja + zostają w kilometrach; + 4. dystans wpisywany w `log` i w kreatorze jest w jednostce z profilu, + a zapis w kilometrach. +- **Test:** migawki `week`, `today` i `season` w milach po polsku i po + angielsku; `log` w milach zapisuje kilometry; `--json` bez zmian; brak „km" + w wyjściu tekstowym przy `imperial`. + +### C10. Skróty klubowe jako opcja notacji + +- **Dziś:** notacja z C1 używa skrótów neutralnych (`RG`, `SCH`, `p.`), + zgodnie z decyzją 2. +- **Zmiana:** + 1. `notation: neutral | club` w `trainctl.yaml`, domyślnie `neutral`; + 2. `club` drukuje kody znane z polskich planów klubowych (np. OWB1, BC1–BC3, + BNP, WT, RT) przypisane do typów jednostek i stref silnika. Szkoły różnią + się definicjami, więc przypisanie ma etykietę „inż.", wpis w FOUNDATIONS + i legendę pod widokiem; + 3. kody tylko w wyjściu polskim. Po angielsku `club` daje notację neutralną; + 4. dane się nie zmieniają: `plan.yaml`, `--json` i eksport do intervals.icu + zostają przy strukturze. +- **Test:** notacja `club` dla każdego typu segmentu; legenda; `neutral` bez + zmian; angielskie wyjście bez kodów klubowych. + +**DoD pakietu C:** jeden model wiersza obsługuje plan v1 i v2; budżety wierszy +z C2 spełnione; MCP dostaje krótszy tekst i te same dane; `PLAN.md` i eksporty +w tym samym układzie; mile i skróty klubowe zmieniają tylko tekst, a `--json` +zostaje bez zmian; pułap tętna tylko przy biegach spokojnych i długich. + +--- + +## 6. Pakiet D: wykonanie nie tylko w kilometrach (etap 3) + +### D1. Okrążenia w porcie sync + +- **Zmiana:** `SyncedActivity.laps?: { distanceKm, movingTimeSec, avgHr? }[]` + w `ports/sync.ts`. Źródła: komunikaty `lap` w FIT (`sync-files/fit.ts` czyta + dziś `session` i `record`), elementy `` w TCX, interwały aktywności + w intervals.icu. GPX okrążeń nie ma. +- **Przed kodem:** sprawdzić w dokumentacji API intervals.icu punkt końcowy + interwałów aktywności i dopisać wynik do `docs/integrations/intervalsicu.md`. +- **Test:** `fit.test.ts`, `tcx.test.ts` na syntetycznych plikach + (`fit-fixture.ts`); adapter intervals.icu na zapisanych odpowiedziach bez + danych osobowych. + +### D2. Opisowe porównanie akcentu z celem + +- **Zmiana:** dla jednostek z powtórzeniami dopasować okrążenia robocze do + planu (liczba, dystans z tolerancją). `ExecutionRecord.intervals` podaje + liczbę zaplanowanych i dopasowanych odcinków, tempa i liczbę odcinków + w zakresie. Automatyczne okrążenia co kilometr nie pasują do struktury i dają + „brak okrążeń pasujących do planu", bez zgadywania. +- **Granica:** to fakty w `review`. Nie zmieniają objętości ani stref + (ADR-011, ADR-027). +- **Test:** `review.test.ts`: komplet odcinków, część odcinków, autolap. + +### D3. Tempo biegów spokojnych i długich + +- **Zmiana:** `review` zestawia średnie tempo (`avgPaceSecPerKm`) z zakresem + strefy spokojnej. Bez oceny po tętnie (Z-3, Z-6). +- **Test:** `review.test.ts`. + +### D4. Tabela `review` + +Kolumny „Plan", „Wykonanie", „Status" z A1 w układzie wiersza z C2, z kolumną +tempa tam, gdzie są dane. + +### D5. Podpowiedź kalibracji + +- **Zmiana:** gdy odcinki w kolejnych akcentach są stale szybsze od górnej + granicy celu, `review` proponuje dodanie wyniku albo sprawdzian (W-12, W-13). + To propozycja tekstowa, bez zmiany planu. +- **Test:** `review.test.ts`, `coach-flows.test.ts`. + +**DoD pakietu D:** plik FIT z interwałami daje w `review` wiersz z liczbą +odcinków i tempami wobec celu; brak okrążeń jest nazwany wprost. + +--- + +## 7. Pakiet E: jeden model danych (etap 4) + +- **Dziś:** plan biegowy v1 ma strefy z wyniku, reguły ze źródłami, solver, + adaptację, pakiet startowy i backtest. Plan v2 ma trwałe ID sesji, kroki, + karty i trzy sporty, a bieganie owija przez `legacyWorkout` (ADR-041). Dwie + ścieżki komend (`commands.ts`, `sports-commands.ts`), dwa walidatory, dwa + zestawy tekstów. +- **Kroki** (decyzja 5 z §10: v2 jedynym modelem po osiągnięciu parytetu): + 1. segmenty biegowe generują kroki v2 z celem tempa, tak by karty i eksporty + nie potrzebowały `legacyWorkout`; + 2. lista parytetu v2 wobec v1: `reschedule`, `adapt`, `desk`, `shorten`, + pakiet startowy, korekta cieplna, predykcja, backtest; + 3. po osiągnięciu parytetu `init` zakłada v2 domyślnie. Czytniki v1 i + `migrate` zostają; + 4. jedna ścieżka komend nad modelem wiersza z C2. +- **Test:** macierz B0 daje ten sam kształt sezonu dla profilu biegowego w v1 + i w v2. + +--- + +## 8. Pakiet F: walidacja i produkt (poza etapami, F3 w etapie 3) + +- **F1. Przegląd trenerski.** Macierz z B0 wydrukowana eksportem `print` dla + kilku profili i przekazana trenerowi z listą pytań: liczba biegów, kolejność + weekendu, progresja akcentów, długie, powrót po przerwie. Wynik jako + `docs/COACH-REVIEW-.md`. Bez kodu. Termin: po etapie 2, wynik przed + startem etapu 4. +- **F2. Pełny sezon.** Dziennik użycia na własnym planie: co tydzień jedna + linia, co było zmieniane ręcznie i dlaczego. Ręczne zmiany są wejściem do + kolejnych pomiarów. +- **F3. Świeżość danych.** Hook pluginu przy starcie sesji dopisuje do + kontekstu wiek `sync.json` ze `status`. Bez pobierania w tle. +- **F4. Dostęp poza terminalem.** Rozstrzygnięty decyzją 6 z §10. README + opisuje ścieżkę telefonu w etapie 3. Tętno przeszło do C8 (decyzja 7). + +--- + +## 9. Pakiet G: teren i ultra (po etapie 4) + +Pakiet dopisany po etapie 1 (decyzja 11 z §10). Nie jest piątym etapem tego +planu. + +- **Dziś:** pole `terrain` wyniku zmienia tylko kalibrację: wynik z terenu nie + ustala stref dla celu szosowego. Treść planu do startu terenowego i do ultra + zostaje szosowa: jednostki w tempie i kilometrach, długie z sufitem N-19, + blok po ultra bez źródła (R-3). +- **Dlaczego po etapie 4:** jednostki terenowe trzeba rozpisywać czasem + i wysiłkiem, a nie tempem i dystansem. Kroki v2 to potrafią, a po etapie 4 + v2 jest jedynym modelem. +- **Najpierw pomiar:** własne starty terenowe z F2 i starty górskie z korpusu, + jeśli są: czas długiego, przewyższenie, udział marszu, taper przed ultra. Bez + pomiaru pakiet nie zmienia silnika (§0, „Najpierw nauka, potem kod"). +- **Zakres wstępny:** + 1. cel z przewyższeniem i terenem; + 2. długie i akcenty rozpisane czasem i wysiłkiem, z podbiegami i zbiegami; + 3. taper i blok po starcie dla ultra; + 4. predykcja wyniku w terenie wyłączona do czasu pomiaru. +- **Realizacja:** po pomiarze pakiet dostaje własną gałąź i tę samą procedurę + zamknięcia (§0) albo przechodzi do następnego planu. + +--- + +## 10. Decyzje właściciela (przyjęte 2026-11-11) + +Decyzje 9–12 i zmiany decyzji 2 i 7 przyjęto po etapie 1, tego samego dnia. + +| # | Decyzja | Skutek w planie | +|---|---|---| +| 1 | Wzorzec korpusu obowiązuje w zakresie objętości, który korpus pokrywa. Poniżej tego zakresu silnik używa wartości „inż." z jawną etykietą | B1, B2, ADR-049 | +| 2 | Notacja domyślnie używa skrótów neutralnych (`RG`, `SCH`, `p.`). Skróty klubowe (OWB1, BC2, BNP, WT) są opcją profilu z przypisaniem „inż." i legendą | C1, C10, ADR-057 | +| 3 | Widok sezonu to nowa komenda `season`, tylko do odczytu | C2, ADR-052 | +| 4 | Opisy słowne dostają poprawki zapisu („2-minutowe", `×`) razem ze zmianą silnika | etap 2 | +| 5 | Schemat v2 zostaje jedynym modelem po osiągnięciu parytetu z planem biegowym | etap 4, po etapach 2 i 3 | +| 6 | Bez hostingu i zdalnego MCP. Telefon obsługują kalendarz intervals.icu, zegarek i `export --what mobile` | §12, README w etapie 3 | +| 7 | Tempo zostaje celem głównym (Z-3). Tętno to pułap biegów spokojnych i długich z pola profilu, z ostrzeżeniem Z-5 przy wartości szacowanej | C8, ADR-056 | +| 8 | Przy ciasnym budżecie ostrzeżenie pyta o wybór między bieganiem a siłą. Silnik nie tnie siły sam | B7 | +| 9 | Przerwa w trakcie planu: zapis w dzienniku i blok powrotu jako propozycja `adapt` do przyjęcia | B11, ADR-055 | +| 10 | Mile i tempo na milę jako opcja widoku. Dane zostają w kilometrach | C9, ADR-057 | +| 11 | Teren i ultra jako pakiet po etapie 4, od pomiaru | §9 | +| 12 | Przegląd etapu kończy się na pierwszej rundzie bez błędu, który użytkownik może spotkać. Sugestie porządkowe trafiają do rejestru | §0, krok 5 | + +--- + +## 11. Kandydaci ADR (047 wpisany w etapie 1, następny wolny numer: 048) + +| # | Decyzja (skrót) | Sedno uzasadnienia | +|---|---|---| +| 047 | Kształt sezonu jest kontraktem testowanym na macierzy profili i lintami kształtu | 1076 testów przechodzi przy planie, w którym tydzień ładowania powtarza się 12 razy bez zmiany dawki; testy sprawdzają reguły tygodnia, a nie sezon | +| 048 | Dawka akcentu i długie zależą od pozycji w bloku i fazie, nie tylko od kilometrażu tygodnia | przy stałym kilometrażu funkcja kilometrażu daje stały plan | +| 049 | Wzorzec korpusu obowiązuje w zakresie objętości, który korpus pokrywa; poza nim wartości inżynierskie z etykietą | mediana korpusu to 64 km/tydz.; ta sama rama przy 16 km daje sesję wielkości połowy tygodnia | +| 050 | Budżet czasu ogranicza szczyt, a proporcje makrocyklu zostają | przycinanie tygodni osobno odwraca odciążenie i taper | +| 051 | Notacja jednostki powstaje ze struktury; opis słowny jest dodatkiem | jeden zapis dla terminala, MCP, `PLAN.md` i eksportów; tekstu nie da się parsować między językami | +| 052 | Trzy poziomy szczegółowości i wspólny model wiersza dla v1 i v2; komenda `season` | dwa style widoków i 173 wiersze tygodnia w v2 | +| 053 | Okrążenia w porcie sync; porównanie akcentów jest opisem, nie wnioskiem | dystans nie mówi, czy akcent został wykonany; ADR-011 i ADR-027 zostają | +| 054 | Powrót po przerwie jako pole profilu i reguła R-11 | dziś mała baza kończy się ostrzeżeniem bez wyjścia | +| 055 | Przerwa w trakcie planu to zapis w dzienniku i propozycja `adapt` do przyjęcia (R-5, R-11) | dziś `adapt` widzi przerwę, ale propozycji nie da się przyjąć, a plan po chorobie pokazuje tygodnie sprzed przerwy | +| 056 | Tętno jest pułapem pomocniczym biegów spokojnych i długich, tempo zostaje celem głównym | Z-3: tempo dokładniejsze; Z-2 i N-13: kotwice według płci; Z-5: błąd przy szacowanym HRmax | +| 057 | Mile i skróty klubowe to opcje widoku; dane zostają w kilometrach i w strukturze | MCP, synchronizacja i eksporty czytają jeden model; przeliczenie w widoku nie dotyka planu | + +--- + +## 12. Poza zakresem + +- Zdalny serwer MCP, REST API i hosting (PLAN-v0.4 §8, bez zmian). +- Pozycje odrzucone na stałe w PLAN-v0.4 §8: autopilot HRV, gamifikacja, pogoda + z sieci, metryki ryzyka urazu, zamiana odczuć na liczby. +- Kalibracja stref z okrążeń (D zostaje przy opisie). +- Nowa metodyka roweru i pływania. Pakiet E ujednolica model, a biblioteka + jednostek v2 czeka na przegląd trenerski (F1). +- Double threshold (J-7, N-16). +- Cele tętna dla akcentów i ocena wykonania po tętnie (C8, Z-3, Z-6). +- Teren i ultra w etapach 1–4 (pakiet G po etapie 4). + +--- + +## 13. Ryzyka + +- **Regeneracja po etapie 2 zmienia wszystkie przyszłe dni.** Mitygacja: jedna + zmiana wersji silnika w całym planie, wpis „Changed", komunikat w `plan` przez + jedno wydanie, ochrona przeszłości z ADR-033 bez zmian. +- **Pomiar w korpusie może nie potwierdzić propozycji** (kolejność weekendu, + liczba sesji). Wtedy obecne zachowanie zostaje i dostaje ID reguły oraz + zdanie w `why`. To też jest wynik. +- **Korpus to jeden trener i biegacze o wyższej objętości.** Wartości dla małej + objętości są inżynierskie do czasu F1. +- **Budżet czasu ma historię regresji** (dziesięć rund przeglądu w 0.4.0). + Mitygacja: B7 jako osobny commit na końcu etapu 2, pełny zestaw testów + regeneracji, nowe testy weryfikowane mutacją. +- **Zmiana widoków łamie skrypty czytające tekst.** Mitygacja: `--json` + i `structuredContent` bez zmian, flaga `--full` dla starego układu kart, + wpis w CHANGELOG. +- **Etap 2 jest duży i ma jeden przegląd.** Mitygacja: stała kolejność commitów + z §2, testy macierzy po każdym commicie, przegląd na całej różnicy gałęzi. + Poprawka po przeglądzie dostaje test, który bez niej zawodzi, żeby runda + poprawek nie wprowadzała regresji jak w 0.4.0. +- **Przegląd wychodzi poza zakres etapu.** Mitygacja: rejestr w §14. Znalezisko + spoza różnicy gałęzi nie blokuje zamknięcia etapu. +- **Opcje mnożą warianty planu, których nikt nie ocenił** (tętno, mile, skróty + klubowe). Mitygacja: opcje zmieniają widok albo dopisują pułap, a kształt + sezonu zostaje ten sam. Macierz B0 biegnie bez opcji, a migawki widoków + obejmują każdą opcję osobno. +- **Przerwa w trakcie planu przebudowuje przyszłe dni.** Mitygacja: istniejąca + ścieżka propozycji z przyjęciem, ochrona dni z ADR-033, testy weryfikowane + mutacją. +- **Backtest działa tylko lokalnie.** Zmiany silnika wymagają uruchomienia na + maszynie z korpusem przed wydaniem; wynik trafia do opisu PR. + +--- + +## 14. Rejestr znalezisk spoza zakresu etapu + +Wypełniany w trakcie realizacji przez krok 6 zamknięcia etapu. + +| Data | Etap | Plik | Znalezisko | Decyzja | +|---|---|---|---|---| +| 2026-11-11 | 1 | `packages/cli/src/sports-calendar.test.ts` | test „updates only changed events … repeats byte-identically" raz zawiódł przy pełnym przebiegu pod obciążeniem, przechodzi osobno i w powtórce | do zbadania osobno (zależność od zegara?), poza zakresem etapu | +| 2026-11-11 | 1 | `packages/cli/src/sports-store.ts:120` | migracja do v2 czyta log.jsonl bez normalizacji z `logfile.ts` | etap 4 (jeden model danych): wspólny odczyt dziennika | +| 2026-11-11 | 1 | `packages/cli/src/status.ts:85` | `status` po starcie pisze „Do startu: 5 dni temu", `review` już „Od startu" | etap 3 (spójne widoki) | +| 2026-11-11 | 1 | `packages/cli/src/commands.ts:684` | `log --km 8,5` odrzucone, a odczyt dziennika i kreator przyjmują przecinek; trzy parsery km | naprawione w etapie 1 (11. runda): `parseDecimal` i `LOG_LIMITS` wspólne dla `log`, kreatora i odczytu log.jsonl | +| 2026-11-11 | 1 | `packages/cli/src/interactive.ts:157` | domyślna wartość km w kreatorze dziennika to surowe `21.0975` | naprawione w etapie 1 (12. runda): `plannedKmDefault` w formacie języka | +| 2026-11-11 | 1 | `packages/core/src/engine/microcycle.ts` | pętla I-5 i `weekTotals` liczą Z1 osobno, obok `hardKmOf` | etap 2 (B5 zmienia pętlę I-5) | +| 2026-11-11 | 1 | `packages/cli/src/commands.ts` (`raceCountdown`) | sugestia połączenia z `raceDistanceLine` (rundy 13–21) | odrzucone: dwie formy tej samej informacji (etykieta z wartością, zdanie); wspólne jest tylko porównanie znaku | +| 2026-11-11 | 1 | `packages/core/src/engine/season.ts` | definicja bieżącego cyklu w lintach różna od `cycleWeeksOf` w CLI | odrzucone: CLI bez `cycleStart` pokazuje cały plan, linty potrzebują jednego cyklu | +| 2026-11-11 | 1 | `packages/cli/src/plan-shape.test.ts` | pełna macierz 576 profili w bramce | odrzucone: ~1,6 s; do ponownej oceny, gdy silnik zwolni | +| 2026-11-11 | 1 | `season.ts`, `planfile.ts`, `calibration.ts` | trzy zaokrąglenia do 0,1 | odrzucone: różne paczki i znaczenia (km lintów, km planu, VDOT) | +| 2026-11-11 | 1 | `packages/cli/src/bin.test.ts` | testy uruchamiające binarkę przekraczają 30 s przy obciążonej maszynie | do rozważenia: osobny limit czasu dla tych testów | diff --git a/docs/science/FOUNDATIONS.md b/docs/science/FOUNDATIONS.md index 4648cd7..820cc9e 100644 --- a/docs/science/FOUNDATIONS.md +++ b/docs/science/FOUNDATIONS.md @@ -1858,6 +1858,86 @@ Przygotowanie 15 minut jak w E-1. Startów i sprawdzianów nie skracamy. Gdy bud ogranicza szczyt poniżej progu dla dystansu (P-7/P-8), plan mówi o tym wprost. To wybór inżynierski: żadne badanie nie mówi, jak przeliczać minuty na bodziec. +**E-3** — stałe generatora planu biegowego bez źródła. Każda jest oznaczona +w kodzie komentarzem „E-3 (inż.)". Lista służy przeglądowi trenerskiemu +(PLAN-v0.7, F1) i pomiarom w korpusie (§10.15): + +| Stała | Wartość | Miejsce | +|---|---|---| +| sufit bez `peakWeeklyKm` | bieżąca objętość × 1,4 | `macrocycle.ts` | +| cel szczytu w planie ze startem | bieżąca objętość × 1,15, nie mniej niż rekomendacja P-7/P-8 | `macrocycle.ts` | +| podział faz przed taperem | 40% baza, 20% szczyt, reszta budowanie | `macrocycle.ts` | +| część główna akcentu | 22% tygodnia minus rozgrzewka i schłodzenie, co najmniej 3 km | `microcycle.ts` | +| spokojne przed podbiegami | 5–8 km, ~10% tygodnia | `microcycle.ts` | +| bieg spokojny | wstępnie co najmniej 5 km, najwyżej 18 km | `microcycle.ts` (`EASY_RUN_CAP_KM`) | +| kilometry poza Z1 | najwyżej 25% tygodnia | `microcycle.ts` | +| przerwy w interwałach | 2' marsz (@T, 1 km), 3' trucht (@T 3 km, @I) | `microcycle.ts` | +| akcent tygodnia startowego | 5×300 m @I, p. 1' | `microcycle.ts` | +| tydzień startowy | 4 sesje bez danych ze szkieletu, biegi po 5 km | `microcycle.ts` | +| udział jednej jednostki (lint) | najwyżej 35% tygodnia | `season.ts` | + +### 10.15 Pomiary sezonu w korpusie (2026-11-11, PLAN-v0.7 etap 1) + +Skrypt `tools/corpus/season_profile.py`, agregaty bez PII. Korpus to jeden +trener i jeden biegacz z historią startów szosowych, trailowych i ultra. +Tygodnie pełne (7 dni w korpusie), bez startów, po deduplikacji dat. + +**Liczba biegów i długie według objętości tygodnia:** + +| km/tydz. | tygodnie | mediana biegów | mediana akcentów | inny bieg spokojny / długie: mediana | P90 | udział długiego | P90 udziału innej jednostki | +|---|---|---|---|---|---|---|---| +| <30 | 6 | 2 | 1 | 0,83 | 0,83 | 0,78 | 0,38 | +| 30–40 | 9 | 3 | 2 | 0,67 | 0,67 | 0,41 | 0,36 | +| 40–50 | 17 | 4 | 3 | 0,79 | 0,80 | 0,40 | 0,33 | +| 50–60 | 29 | 4 | 3 | 0,79 | 0,86 | 0,36 | 0,30 | +| 60–70 | 28 | 4 | 3 | 0,64 | 0,83 | 0,32 | 0,29 | +| ≥70 | 41 | 5 | 3 | 0,60 | 0,91 | 0,29 | 0,27 | + +Długie w pomiarze to najdłuższy bieg tygodnia bez pracy odcinkowej (≥ 12 km), +więc inny bieg spokojny nie może być dłuższy z definicji. Pomiar mówi, jak +daleko pod długim zostaje najdłuższy inny bieg spokojny. Razem 130 tygodni. + +Akcent w korpusie to dzień oznaczony jako jakościowy przez parser, razem +z podbiegami. Poniżej 30 km korpus ma 6 tygodni, wnioski tam są słabe. + +**Przed startem ≥ 21 km** (n = 3 starty z co najmniej 10 pełnymi tygodniami +przed; tydzień startu = 0): + +| Tygodnie do startu | 15 | 13 | 11 | 9 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | +|---|---|---|---|---|---|---|---|---|---|---|---| +| objętość / szczyt (mediana) | 0,67 | 0,58 | 0,78 | 0,73 | 0,76 | 0,93 | 0,44 | 0,90 | 0,91 | 0,78 | 0,87 | +| długie [km] (mediana) | 15 | 17 | 19,5 | 17,5 | 23,5 | 25 | 23,5 | 20 | 22,5 | 25 | 19 | + +Szczyt objętości wypadł 5, 6 i 7 tygodni przed startem. + +**Dawka akcentu** (kilometry poza Z1 w jednej sesji; ciągłe odcinki +`steady` i narastające ≥ 5 km): + +| Tygodnie do startu | sesje | mediana km poza Z1 | bloki ciągłe ≥ 5 km | mediana bloku | +|---|---|---|---|---| +| 13–16 | 15 | 3,0 | 4 | 7 km | +| 9–12 | 21 | 7,5 | 7 | 12 km | +| 5–8 | 26 | 9,0 | 9 | 15 km | +| 1–4 | 30 | 10,0 | 9 | 12 km | + +**Weekend:** sobota→niedziela „akcent→długie" 53 razy, „długie→akcent" +52 razy, „start→długie" 14 razy. Dzień po długim (z poniedziałkiem po +niedzielnym długim): wolne 82, akcent 72, spokojne 5, długie 1. Bieg w niedzielę po sobotnim starcie: n = 15, mediana 25 km. + +**Reguły wynikające z pomiaru:** + +| # | Reguła | Wartości / parametry | Źródło | Siła | +|---|--------|----------------------|--------|------| +| S-10 | Najdłuższy inny bieg spokojny zostaje **wyraźnie pod długim** | mediana 0,60–0,83, P90 0,67–0,91 długiego; że długie jest najdłuższym biegiem tygodnia, to definicja jednostki (J-1, S-2), nie wynik pomiaru | korpus (130 tygodni) | **korpus** | +| S-11 | Liczba biegów rośnie z objętością: 3 przy 30–40 km, 4 przy 40–70 km, 5 powyżej | potwierdza `typicalKmPerSession` 14 od 30 km; poniżej 30 km brak danych | korpus | **korpus** | +| S-12 | Dwa akcenty także przy trzech biegach w tygodniu | 30–40 km: mediana 3 biegi, 2 akcenty | korpus; uzupełnia I-8 | **korpus** | +| S-9b | Kolejność weekendu dowolna: „długie→akcent" tak częste jak „akcent→długie" | 52 vs 53 | korpus; spójne z S-9a | **korpus** | +| P-12 | Objętość rośnie do szczytu 5–7 tygodni przed startem ≥ HM, z ok. 0,6 szczytu 13–15 tygodni przed | n = 3 starty | korpus; T-7 (Knopp 2024) podaje ~4 tygodnie | **korpus (n=3)** | +| J-8 | **Dawka akcentu rośnie w sezonie**: km poza Z1 na sesję ~3 → 7,5 → 9 → 10 w kolejnych czterotygodniowych pasmach przed startem | 92 sesje | korpus; spójne z P-1 | **korpus** | +| J-9 | Praca ciągła (`steady`, narastające) wydłuża się przed startem: blok ≥ 5 km z 7 do 12–15 km | 29 bloków | korpus; **tempo startowe niepotwierdzone** — korpus nie ma wyników, do których dałoby się je odnieść | **korpus** | +| J-10 | Długie rośnie przed startem ≥ HM: ~15 km 15 tygodni przed, 23–25 km 2–7 tygodni przed | n = 3 starty | korpus; spójne z J-2, P-7, P-8 | **korpus (n=3)** | +| R-11 | **Powrót po przerwie** (≥ 2 tygodnie bez biegania): start z ~50–60% objętości sprzed przerwy, pierwszy blok wyłącznie spokojnie, wzrost do poprzedniej objętości w granicach P-3 (twardy limit 25–30%/tydz.) | VO₂max −4–14% po ≤ 4 tygodniach przerwy, −6–20% po dłuższej (Mujika & Padilla 2000, opis wtórny); brak RCT dotyczącego progresji powrotu; GRONORUN (Buist 2008, N-2) nie znalazł różnicy urazów między progresją 10% a szybszą | **brak źródła dla parametrów** (inż.); spójne z R-5 i P-3 | **—** | + ## 11. DO WERYFIKACJI Rzeczy, których **nie** potwierdzono z pierwszej ręki. Nic z tej listy nie powinno @@ -1924,6 +2004,13 @@ Te muszą być oznaczone w kodzie jako heurystyki, nie jako reguły oparte na do odkłada wyniki z trailu zamiast je przeliczać. 10. **Kształt powrotu po starcie.** Poza R-1/R-2 (48 h po maratonie) brak badań nad objętością kolejnych tygodni; R-8 opiera się na trzech startach z korpusu. +11. **Progresja objętości przy powrocie po przerwie.** Przeszukanie 2026-11-11 nie + znalazło RCT. Dane o roztrenowaniu (Mujika & Padilla 2000) pochodzą z opisu + wtórnego — oryginał nieotwarty. R-11 to heurystyka. +12. **Tempo startowe w akcentach przed półmaratonem i maratonem.** Korpus pokazuje + wydłużanie pracy ciągłej (J-9), ale bez wyników biegacza nie da się ustalić, + czy to tempo startowe. Silnik nie dodaje jednostek „w tempie startowym" bez + dodatkowego źródła. ### 11.3 Znane niespójności w źródłach (do rozstrzygnięcia lub udokumentowania) diff --git a/packages/cli/package.json b/packages/cli/package.json index 5b4fb2b..d8de77e 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -35,6 +35,7 @@ "dist", "src/**/*.ts", "!src/**/*.test.ts", + "!src/**/*.fixture.ts", "README.md", "LICENSE" ], diff --git a/packages/cli/src/__snapshots__/plan-shape-matrix.txt b/packages/cli/src/__snapshots__/plan-shape-matrix.txt new file mode 100644 index 0000000..fd5cd45 --- /dev/null +++ b/packages/cli/src/__snapshots__/plan-shape-matrix.txt @@ -0,0 +1,577 @@ +# id | peak | longest long | validate errors | longNotLongest deloadNotLighter sessionShareHigh postRaceAccentHeavy staleProgression longBelowGoal +12km-3d-10k-8w | peak 17 | long 6 | err 0 | 0 0 0 0 0 0 +12km-3d-10k-8w-240min | peak 17 | long 6 | err 0 | 0 0 0 0 0 0 +12km-3d-10k-8w-360min | peak 17 | long 6 | err 0 | 0 0 0 0 0 0 +12km-3d-10k-16w | peak 17 | long 6 | err 0 | 0 0 0 0 2 0 +12km-3d-10k-16w-240min | peak 17 | long 6 | err 0 | 0 0 0 0 2 0 +12km-3d-10k-16w-360min | peak 17 | long 6 | err 0 | 0 0 0 0 2 0 +12km-3d-10k-24w | peak 17 | long 6 | err 0 | 0 0 0 0 3 0 +12km-3d-10k-24w-240min | peak 17 | long 6 | err 0 | 0 0 0 0 3 0 +12km-3d-10k-24w-360min | peak 17 | long 6 | err 0 | 0 0 0 0 3 0 +12km-3d-hm-8w | peak 16 | long 6 | err 0 | 0 0 0 0 0 1 +12km-3d-hm-8w-240min | peak 16 | long 6 | err 0 | 0 0 0 0 0 1 +12km-3d-hm-8w-360min | peak 16 | long 6 | err 0 | 0 0 0 0 0 1 +12km-3d-hm-16w | peak 17 | long 6 | err 0 | 0 0 0 0 2 1 +12km-3d-hm-16w-240min | peak 17 | long 6 | err 0 | 0 0 0 0 2 1 +12km-3d-hm-16w-360min | peak 17 | long 6 | err 0 | 0 0 0 0 2 1 +12km-3d-hm-24w | peak 17 | long 6 | err 0 | 0 0 0 0 3 1 +12km-3d-hm-24w-240min | peak 17 | long 6 | err 0 | 0 0 0 0 3 1 +12km-3d-hm-24w-360min | peak 17 | long 6 | err 0 | 0 0 0 0 3 1 +12km-3d-m-8w | peak 15 | long 5 | err 0 | 0 0 2 0 1 1 +12km-3d-m-8w-240min | peak 15 | long 5 | err 0 | 0 0 2 0 1 1 +12km-3d-m-8w-360min | peak 15 | long 5 | err 0 | 0 0 2 0 1 1 +12km-3d-m-16w | peak 17 | long 6 | err 0 | 0 0 2 0 2 1 +12km-3d-m-16w-240min | peak 17 | long 6 | err 0 | 0 0 2 0 2 1 +12km-3d-m-16w-360min | peak 17 | long 6 | err 0 | 0 0 2 0 2 1 +12km-3d-m-24w | peak 17 | long 6 | err 0 | 0 0 2 0 3 1 +12km-3d-m-24w-240min | peak 17 | long 6 | err 0 | 0 0 2 0 3 1 +12km-3d-m-24w-360min | peak 17 | long 6 | err 0 | 0 0 2 0 3 1 +12km-3d-base-8w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-3d-base-8w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-3d-base-8w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-3d-base-16w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-3d-base-16w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-3d-base-16w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-3d-base-24w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-3d-base-24w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-3d-base-24w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-4d-10k-8w | peak 17 | long 6 | err 0 | 2 0 2 0 0 0 +12km-4d-10k-8w-240min | peak 17 | long 6 | err 0 | 2 0 2 0 0 0 +12km-4d-10k-8w-360min | peak 17 | long 6 | err 0 | 2 0 2 0 0 0 +12km-4d-10k-16w | peak 17 | long 6 | err 0 | 7 0 7 0 1 0 +12km-4d-10k-16w-240min | peak 17 | long 6 | err 0 | 7 0 7 0 1 0 +12km-4d-10k-16w-360min | peak 17 | long 6 | err 0 | 7 0 7 0 1 0 +12km-4d-10k-24w | peak 17 | long 6 | err 0 | 12 0 12 0 2 0 +12km-4d-10k-24w-240min | peak 17 | long 6 | err 0 | 12 0 12 0 2 0 +12km-4d-10k-24w-360min | peak 17 | long 6 | err 0 | 12 0 12 0 2 0 +12km-4d-hm-8w | peak 16 | long 6 | err 0 | 2 0 2 0 0 1 +12km-4d-hm-8w-240min | peak 16 | long 6 | err 0 | 2 0 2 0 0 1 +12km-4d-hm-8w-360min | peak 16 | long 6 | err 0 | 2 0 2 0 0 1 +12km-4d-hm-16w | peak 17 | long 6 | err 0 | 8 0 8 0 1 1 +12km-4d-hm-16w-240min | peak 17 | long 6 | err 0 | 8 0 8 0 1 1 +12km-4d-hm-16w-360min | peak 17 | long 6 | err 0 | 8 0 8 0 1 1 +12km-4d-hm-24w | peak 17 | long 6 | err 0 | 14 0 14 0 2 1 +12km-4d-hm-24w-240min | peak 17 | long 6 | err 0 | 14 0 14 0 2 1 +12km-4d-hm-24w-360min | peak 17 | long 6 | err 0 | 14 0 14 0 2 1 +12km-4d-m-8w | peak 15 | long 5 | err 0 | 0 0 0 0 1 1 +12km-4d-m-8w-240min | peak 15 | long 5 | err 0 | 0 0 0 0 1 1 +12km-4d-m-8w-360min | peak 15 | long 5 | err 0 | 0 0 0 0 1 1 +12km-4d-m-16w | peak 17 | long 6 | err 0 | 7 0 7 0 1 1 +12km-4d-m-16w-240min | peak 17 | long 6 | err 0 | 7 0 7 0 1 1 +12km-4d-m-16w-360min | peak 17 | long 6 | err 0 | 7 0 7 0 1 1 +12km-4d-m-24w | peak 17 | long 6 | err 0 | 13 0 13 0 2 1 +12km-4d-m-24w-240min | peak 17 | long 6 | err 0 | 13 0 13 0 2 1 +12km-4d-m-24w-360min | peak 17 | long 6 | err 0 | 13 0 13 0 2 1 +12km-4d-base-8w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-4d-base-8w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-4d-base-8w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-4d-base-16w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-4d-base-16w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-4d-base-16w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-4d-base-24w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-4d-base-24w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-4d-base-24w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-5d-10k-8w | peak 17 | long 6 | err 0 | 2 0 2 0 0 0 +12km-5d-10k-8w-240min | peak 17 | long 6 | err 0 | 2 0 2 0 0 0 +12km-5d-10k-8w-360min | peak 17 | long 6 | err 0 | 2 0 2 0 0 0 +12km-5d-10k-16w | peak 17 | long 6 | err 0 | 7 0 7 0 1 0 +12km-5d-10k-16w-240min | peak 17 | long 6 | err 0 | 7 0 7 0 1 0 +12km-5d-10k-16w-360min | peak 17 | long 6 | err 0 | 7 0 7 0 1 0 +12km-5d-10k-24w | peak 17 | long 6 | err 0 | 12 0 12 0 2 0 +12km-5d-10k-24w-240min | peak 17 | long 6 | err 0 | 12 0 12 0 2 0 +12km-5d-10k-24w-360min | peak 17 | long 6 | err 0 | 12 0 12 0 2 0 +12km-5d-hm-8w | peak 16 | long 6 | err 0 | 2 0 2 0 0 1 +12km-5d-hm-8w-240min | peak 16 | long 6 | err 0 | 2 0 2 0 0 1 +12km-5d-hm-8w-360min | peak 16 | long 6 | err 0 | 2 0 2 0 0 1 +12km-5d-hm-16w | peak 17 | long 6 | err 0 | 8 0 8 0 1 1 +12km-5d-hm-16w-240min | peak 17 | long 6 | err 0 | 8 0 8 0 1 1 +12km-5d-hm-16w-360min | peak 17 | long 6 | err 0 | 8 0 8 0 1 1 +12km-5d-hm-24w | peak 17 | long 6 | err 0 | 14 0 14 0 2 1 +12km-5d-hm-24w-240min | peak 17 | long 6 | err 0 | 14 0 14 0 2 1 +12km-5d-hm-24w-360min | peak 17 | long 6 | err 0 | 14 0 14 0 2 1 +12km-5d-m-8w | peak 15 | long 5 | err 0 | 0 0 0 0 1 1 +12km-5d-m-8w-240min | peak 15 | long 5 | err 0 | 0 0 0 0 1 1 +12km-5d-m-8w-360min | peak 15 | long 5 | err 0 | 0 0 0 0 1 1 +12km-5d-m-16w | peak 17 | long 6 | err 0 | 7 0 7 0 1 1 +12km-5d-m-16w-240min | peak 17 | long 6 | err 0 | 7 0 7 0 1 1 +12km-5d-m-16w-360min | peak 17 | long 6 | err 0 | 7 0 7 0 1 1 +12km-5d-m-24w | peak 17 | long 6 | err 0 | 13 0 13 0 2 1 +12km-5d-m-24w-240min | peak 17 | long 6 | err 0 | 13 0 13 0 2 1 +12km-5d-m-24w-360min | peak 17 | long 6 | err 0 | 13 0 13 0 2 1 +12km-5d-base-8w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-5d-base-8w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-5d-base-8w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-5d-base-16w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-5d-base-16w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-5d-base-16w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-5d-base-24w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-5d-base-24w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-5d-base-24w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-6d-10k-8w | peak 17 | long 6 | err 0 | 2 0 2 0 0 0 +12km-6d-10k-8w-240min | peak 17 | long 6 | err 0 | 2 0 2 0 0 0 +12km-6d-10k-8w-360min | peak 17 | long 6 | err 0 | 2 0 2 0 0 0 +12km-6d-10k-16w | peak 17 | long 6 | err 0 | 7 0 7 0 1 0 +12km-6d-10k-16w-240min | peak 17 | long 6 | err 0 | 7 0 7 0 1 0 +12km-6d-10k-16w-360min | peak 17 | long 6 | err 0 | 7 0 7 0 1 0 +12km-6d-10k-24w | peak 17 | long 6 | err 0 | 12 0 12 0 2 0 +12km-6d-10k-24w-240min | peak 17 | long 6 | err 0 | 12 0 12 0 2 0 +12km-6d-10k-24w-360min | peak 17 | long 6 | err 0 | 12 0 12 0 2 0 +12km-6d-hm-8w | peak 16 | long 6 | err 0 | 2 0 2 0 0 1 +12km-6d-hm-8w-240min | peak 16 | long 6 | err 0 | 2 0 2 0 0 1 +12km-6d-hm-8w-360min | peak 16 | long 6 | err 0 | 2 0 2 0 0 1 +12km-6d-hm-16w | peak 17 | long 6 | err 0 | 8 0 8 0 1 1 +12km-6d-hm-16w-240min | peak 17 | long 6 | err 0 | 8 0 8 0 1 1 +12km-6d-hm-16w-360min | peak 17 | long 6 | err 0 | 8 0 8 0 1 1 +12km-6d-hm-24w | peak 17 | long 6 | err 0 | 14 0 14 0 2 1 +12km-6d-hm-24w-240min | peak 17 | long 6 | err 0 | 14 0 14 0 2 1 +12km-6d-hm-24w-360min | peak 17 | long 6 | err 0 | 14 0 14 0 2 1 +12km-6d-m-8w | peak 15 | long 5 | err 0 | 0 0 0 0 1 1 +12km-6d-m-8w-240min | peak 15 | long 5 | err 0 | 0 0 0 0 1 1 +12km-6d-m-8w-360min | peak 15 | long 5 | err 0 | 0 0 0 0 1 1 +12km-6d-m-16w | peak 17 | long 6 | err 0 | 7 0 7 0 1 1 +12km-6d-m-16w-240min | peak 17 | long 6 | err 0 | 7 0 7 0 1 1 +12km-6d-m-16w-360min | peak 17 | long 6 | err 0 | 7 0 7 0 1 1 +12km-6d-m-24w | peak 17 | long 6 | err 0 | 13 0 13 0 2 1 +12km-6d-m-24w-240min | peak 17 | long 6 | err 0 | 13 0 13 0 2 1 +12km-6d-m-24w-360min | peak 17 | long 6 | err 0 | 13 0 13 0 2 1 +12km-6d-base-8w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-6d-base-8w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-6d-base-8w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-6d-base-16w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-6d-base-16w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-6d-base-16w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-6d-base-24w | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-6d-base-24w-240min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +12km-6d-base-24w-360min | peak 14 | long 5 | err 0 | 0 0 0 0 0 0 +25km-3d-10k-8w | peak 35 | long 12 | err 0 | 6 0 6 0 0 0 +25km-3d-10k-8w-240min | peak 30 | long 12 | err 0 | 6 0 6 0 0 0 +25km-3d-10k-8w-360min | peak 35 | long 12 | err 0 | 6 0 6 0 0 0 +25km-3d-10k-16w | peak 35 | long 12 | err 0 | 13 0 13 0 1 0 +25km-3d-10k-16w-240min | peak 30 | long 12 | err 0 | 13 0 13 0 2 0 +25km-3d-10k-16w-360min | peak 35 | long 12 | err 0 | 13 0 13 0 1 0 +25km-3d-10k-24w | peak 35 | long 12 | err 0 | 20 0 20 0 2 0 +25km-3d-10k-24w-240min | peak 30 | long 12 | err 0 | 20 0 20 0 3 0 +25km-3d-10k-24w-360min | peak 35 | long 12 | err 0 | 20 0 20 0 2 0 +25km-3d-hm-8w | peak 34 | long 12 | err 0 | 7 0 7 0 0 1 +25km-3d-hm-8w-240min | peak 30 | long 11 | err 0 | 6 0 6 0 1 1 +25km-3d-hm-8w-360min | peak 34 | long 12 | err 0 | 7 0 7 0 0 1 +25km-3d-hm-16w | peak 35 | long 12 | err 0 | 14 0 15 0 1 1 +25km-3d-hm-16w-240min | peak 30 | long 11 | err 0 | 12 0 13 0 2 1 +25km-3d-hm-16w-360min | peak 35 | long 12 | err 0 | 14 0 15 0 1 1 +25km-3d-hm-24w | peak 35 | long 12 | err 0 | 22 0 23 0 2 1 +25km-3d-hm-24w-240min | peak 30 | long 11 | err 0 | 19 0 20 0 3 1 +25km-3d-hm-24w-360min | peak 35 | long 12 | err 0 | 22 0 23 0 2 1 +25km-3d-m-8w | peak 31 | long 11 | err 0 | 4 0 7 0 0 1 +25km-3d-m-8w-240min | peak 31 | long 11 | err 0 | 4 0 7 0 0 1 +25km-3d-m-8w-360min | peak 31 | long 11 | err 0 | 4 0 7 0 0 1 +25km-3d-m-16w | peak 35 | long 12 | err 0 | 13 0 15 0 1 1 +25km-3d-m-16w-240min | peak 30 | long 11 | err 0 | 11 0 13 0 2 1 +25km-3d-m-16w-360min | peak 35 | long 12 | err 0 | 13 0 15 0 1 1 +25km-3d-m-24w | peak 35 | long 12 | err 0 | 21 0 23 0 2 1 +25km-3d-m-24w-240min | peak 30 | long 11 | err 0 | 18 0 20 0 3 1 +25km-3d-m-24w-360min | peak 35 | long 12 | err 0 | 21 0 23 0 2 1 +25km-3d-base-8w | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-3d-base-8w-240min | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-3d-base-8w-360min | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-3d-base-16w | peak 29 | long 10 | err 0 | 14 0 14 0 0 0 +25km-3d-base-16w-240min | peak 29 | long 10 | err 0 | 14 0 14 0 0 0 +25km-3d-base-16w-360min | peak 29 | long 10 | err 0 | 14 0 14 0 0 0 +25km-3d-base-24w | peak 29 | long 10 | err 0 | 21 0 21 0 0 0 +25km-3d-base-24w-240min | peak 29 | long 10 | err 0 | 21 0 21 0 0 0 +25km-3d-base-24w-360min | peak 29 | long 10 | err 0 | 21 0 21 0 0 0 +25km-4d-10k-8w | peak 35 | long 12 | err 0 | 4 0 6 0 0 0 +25km-4d-10k-8w-240min | peak 30 | long 11 | err 0 | 1 0 5 0 0 0 +25km-4d-10k-8w-360min | peak 35 | long 12 | err 0 | 4 0 6 0 0 0 +25km-4d-10k-16w | peak 35 | long 12 | err 0 | 9 0 11 0 1 0 +25km-4d-10k-16w-240min | peak 30 | long 11 | err 0 | 1 0 10 0 1 0 +25km-4d-10k-16w-360min | peak 35 | long 12 | err 0 | 9 0 11 0 1 0 +25km-4d-10k-24w | peak 35 | long 12 | err 0 | 14 0 16 0 2 0 +25km-4d-10k-24w-240min | peak 30 | long 11 | err 0 | 1 0 15 0 2 0 +25km-4d-10k-24w-360min | peak 35 | long 12 | err 0 | 14 0 16 0 2 0 +25km-4d-hm-8w | peak 34 | long 12 | err 0 | 4 0 6 0 0 1 +25km-4d-hm-8w-240min | peak 30 | long 11 | err 0 | 2 0 5 0 0 1 +25km-4d-hm-8w-360min | peak 34 | long 12 | err 0 | 4 0 6 0 0 1 +25km-4d-hm-16w | peak 35 | long 12 | err 0 | 8 0 11 0 1 1 +25km-4d-hm-16w-240min | peak 30 | long 11 | err 0 | 1 0 10 0 1 1 +25km-4d-hm-16w-360min | peak 35 | long 12 | err 0 | 8 0 11 0 1 1 +25km-4d-hm-24w | peak 35 | long 12 | err 0 | 13 0 16 0 2 1 +25km-4d-hm-24w-240min | peak 30 | long 11 | err 0 | 1 0 15 0 2 1 +25km-4d-hm-24w-360min | peak 35 | long 12 | err 0 | 13 0 16 0 2 1 +25km-4d-m-8w | peak 31 | long 11 | err 0 | 2 0 4 0 0 1 +25km-4d-m-8w-240min | peak 30 | long 11 | err 0 | 1 0 4 0 0 1 +25km-4d-m-8w-360min | peak 31 | long 11 | err 0 | 2 0 4 0 0 1 +25km-4d-m-16w | peak 35 | long 12 | err 0 | 7 0 10 0 1 1 +25km-4d-m-16w-240min | peak 30 | long 11 | err 0 | 1 0 9 0 1 1 +25km-4d-m-16w-360min | peak 35 | long 12 | err 0 | 7 0 10 0 1 1 +25km-4d-m-24w | peak 35 | long 12 | err 0 | 12 0 15 0 2 1 +25km-4d-m-24w-240min | peak 30 | long 11 | err 0 | 1 0 14 0 2 1 +25km-4d-m-24w-360min | peak 35 | long 12 | err 0 | 12 0 15 0 2 1 +25km-4d-base-8w | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-4d-base-8w-240min | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-4d-base-8w-360min | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-4d-base-16w | peak 29 | long 10 | err 0 | 15 0 15 0 0 0 +25km-4d-base-16w-240min | peak 29 | long 10 | err 0 | 15 0 15 0 0 0 +25km-4d-base-16w-360min | peak 29 | long 10 | err 0 | 15 0 15 0 0 0 +25km-4d-base-24w | peak 29 | long 10 | err 0 | 23 0 23 0 0 0 +25km-4d-base-24w-240min | peak 29 | long 10 | err 0 | 23 0 23 0 0 0 +25km-4d-base-24w-360min | peak 29 | long 10 | err 0 | 23 0 23 0 0 0 +25km-5d-10k-8w | peak 35 | long 12 | err 0 | 4 0 6 0 0 0 +25km-5d-10k-8w-240min | peak 30 | long 11 | err 0 | 1 0 5 0 0 0 +25km-5d-10k-8w-360min | peak 35 | long 12 | err 0 | 4 0 6 0 0 0 +25km-5d-10k-16w | peak 35 | long 12 | err 0 | 9 0 11 0 1 0 +25km-5d-10k-16w-240min | peak 30 | long 11 | err 0 | 1 0 10 0 1 0 +25km-5d-10k-16w-360min | peak 35 | long 12 | err 0 | 9 0 11 0 1 0 +25km-5d-10k-24w | peak 35 | long 12 | err 0 | 14 0 16 0 2 0 +25km-5d-10k-24w-240min | peak 30 | long 11 | err 0 | 1 0 15 0 2 0 +25km-5d-10k-24w-360min | peak 35 | long 12 | err 0 | 14 0 16 0 2 0 +25km-5d-hm-8w | peak 34 | long 12 | err 0 | 4 0 6 0 0 1 +25km-5d-hm-8w-240min | peak 30 | long 11 | err 0 | 2 0 5 0 0 1 +25km-5d-hm-8w-360min | peak 34 | long 12 | err 0 | 4 0 6 0 0 1 +25km-5d-hm-16w | peak 35 | long 12 | err 0 | 8 0 11 0 1 1 +25km-5d-hm-16w-240min | peak 30 | long 11 | err 0 | 1 0 10 0 1 1 +25km-5d-hm-16w-360min | peak 35 | long 12 | err 0 | 8 0 11 0 1 1 +25km-5d-hm-24w | peak 35 | long 12 | err 0 | 13 0 16 0 2 1 +25km-5d-hm-24w-240min | peak 30 | long 11 | err 0 | 1 0 15 0 2 1 +25km-5d-hm-24w-360min | peak 35 | long 12 | err 0 | 13 0 16 0 2 1 +25km-5d-m-8w | peak 31 | long 11 | err 0 | 2 0 4 0 0 1 +25km-5d-m-8w-240min | peak 30 | long 11 | err 0 | 1 0 4 0 0 1 +25km-5d-m-8w-360min | peak 31 | long 11 | err 0 | 2 0 4 0 0 1 +25km-5d-m-16w | peak 35 | long 12 | err 0 | 7 0 10 0 1 1 +25km-5d-m-16w-240min | peak 30 | long 11 | err 0 | 1 0 9 0 1 1 +25km-5d-m-16w-360min | peak 35 | long 12 | err 0 | 7 0 10 0 1 1 +25km-5d-m-24w | peak 35 | long 12 | err 0 | 12 0 15 0 2 1 +25km-5d-m-24w-240min | peak 30 | long 11 | err 0 | 1 0 14 0 2 1 +25km-5d-m-24w-360min | peak 35 | long 12 | err 0 | 12 0 15 0 2 1 +25km-5d-base-8w | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-5d-base-8w-240min | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-5d-base-8w-360min | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-5d-base-16w | peak 29 | long 10 | err 0 | 15 0 15 0 0 0 +25km-5d-base-16w-240min | peak 29 | long 10 | err 0 | 15 0 15 0 0 0 +25km-5d-base-16w-360min | peak 29 | long 10 | err 0 | 15 0 15 0 0 0 +25km-5d-base-24w | peak 29 | long 10 | err 0 | 23 0 23 0 0 0 +25km-5d-base-24w-240min | peak 29 | long 10 | err 0 | 23 0 23 0 0 0 +25km-5d-base-24w-360min | peak 29 | long 10 | err 0 | 23 0 23 0 0 0 +25km-6d-10k-8w | peak 35 | long 12 | err 0 | 4 0 6 0 0 0 +25km-6d-10k-8w-240min | peak 30 | long 11 | err 0 | 1 0 5 0 0 0 +25km-6d-10k-8w-360min | peak 35 | long 12 | err 0 | 4 0 6 0 0 0 +25km-6d-10k-16w | peak 35 | long 12 | err 0 | 9 0 11 0 1 0 +25km-6d-10k-16w-240min | peak 30 | long 11 | err 0 | 1 0 10 0 1 0 +25km-6d-10k-16w-360min | peak 35 | long 12 | err 0 | 9 0 11 0 1 0 +25km-6d-10k-24w | peak 35 | long 12 | err 0 | 14 0 16 0 2 0 +25km-6d-10k-24w-240min | peak 30 | long 11 | err 0 | 1 0 15 0 2 0 +25km-6d-10k-24w-360min | peak 35 | long 12 | err 0 | 14 0 16 0 2 0 +25km-6d-hm-8w | peak 34 | long 12 | err 0 | 4 0 6 0 0 1 +25km-6d-hm-8w-240min | peak 30 | long 11 | err 0 | 2 0 5 0 0 1 +25km-6d-hm-8w-360min | peak 34 | long 12 | err 0 | 4 0 6 0 0 1 +25km-6d-hm-16w | peak 35 | long 12 | err 0 | 8 0 11 0 1 1 +25km-6d-hm-16w-240min | peak 30 | long 11 | err 0 | 1 0 10 0 1 1 +25km-6d-hm-16w-360min | peak 35 | long 12 | err 0 | 8 0 11 0 1 1 +25km-6d-hm-24w | peak 35 | long 12 | err 0 | 13 0 16 0 2 1 +25km-6d-hm-24w-240min | peak 30 | long 11 | err 0 | 1 0 15 0 2 1 +25km-6d-hm-24w-360min | peak 35 | long 12 | err 0 | 13 0 16 0 2 1 +25km-6d-m-8w | peak 31 | long 11 | err 0 | 2 0 4 0 0 1 +25km-6d-m-8w-240min | peak 30 | long 11 | err 0 | 1 0 4 0 0 1 +25km-6d-m-8w-360min | peak 31 | long 11 | err 0 | 2 0 4 0 0 1 +25km-6d-m-16w | peak 35 | long 12 | err 0 | 7 0 10 0 1 1 +25km-6d-m-16w-240min | peak 30 | long 11 | err 0 | 1 0 9 0 1 1 +25km-6d-m-16w-360min | peak 35 | long 12 | err 0 | 7 0 10 0 1 1 +25km-6d-m-24w | peak 35 | long 12 | err 0 | 12 0 15 0 2 1 +25km-6d-m-24w-240min | peak 30 | long 11 | err 0 | 1 0 14 0 2 1 +25km-6d-m-24w-360min | peak 35 | long 12 | err 0 | 12 0 15 0 2 1 +25km-6d-base-8w | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-6d-base-8w-240min | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-6d-base-8w-360min | peak 29 | long 10 | err 0 | 7 0 7 0 0 0 +25km-6d-base-16w | peak 29 | long 10 | err 0 | 15 0 15 0 0 0 +25km-6d-base-16w-240min | peak 29 | long 10 | err 0 | 15 0 15 0 0 0 +25km-6d-base-16w-360min | peak 29 | long 10 | err 0 | 15 0 15 0 0 0 +25km-6d-base-24w | peak 29 | long 10 | err 0 | 23 0 23 0 0 0 +25km-6d-base-24w-240min | peak 29 | long 10 | err 0 | 23 0 23 0 0 0 +25km-6d-base-24w-360min | peak 29 | long 10 | err 0 | 23 0 23 0 0 0 +45km-3d-10k-8w | peak 52 | long 19 | err 0 | 2 1 6 0 0 0 +45km-3d-10k-8w-240min | peak 31.000000000000004 | long 11 | err 0 | 6 1 6 0 0 0 +45km-3d-10k-8w-360min | peak 48 | long 19 | err 0 | 2 1 6 0 0 0 +45km-3d-10k-16w | peak 52 | long 19 | err 0 | 4 2 13 0 1 0 +45km-3d-10k-16w-240min | peak 31.000000000000004 | long 11 | err 0 | 13 3 13 0 2 0 +45km-3d-10k-16w-360min | peak 48 | long 19 | err 0 | 4 2 13 0 1 0 +45km-3d-10k-24w | peak 52 | long 19 | err 0 | 6 3 20 0 2 0 +45km-3d-10k-24w-240min | peak 31.000000000000004 | long 11 | err 0 | 20 5 20 0 3 0 +45km-3d-10k-24w-360min | peak 48 | long 19 | err 0 | 6 3 20 0 2 0 +45km-3d-hm-8w | peak 52 | long 19 | err 0 | 3 1 8 0 0 1 +45km-3d-hm-8w-240min | peak 31.000000000000004 | long 11 | err 0 | 6 1 6 0 1 1 +45km-3d-hm-8w-360min | peak 48 | long 19 | err 0 | 3 1 8 0 0 1 +45km-3d-hm-16w | peak 52 | long 19 | err 0 | 5 2 15 0 1 1 +45km-3d-hm-16w-240min | peak 31.000000000000004 | long 11 | err 0 | 13 3 13 0 2 1 +45km-3d-hm-16w-360min | peak 48 | long 19 | err 0 | 5 2 15 0 1 1 +45km-3d-hm-24w | peak 52 | long 19 | err 0 | 7 3 22 0 2 1 +45km-3d-hm-24w-240min | peak 31.000000000000004 | long 11 | err 0 | 20 5 20 0 3 1 +45km-3d-hm-24w-360min | peak 48 | long 19 | err 0 | 7 3 22 0 2 1 +45km-3d-m-8w | peak 57 | long 20 | err 0 | 3 1 11 0 0 1 +45km-3d-m-8w-240min | peak 31.000000000000004 | long 11 | err 0 | 5 1 7 0 0 1 +45km-3d-m-8w-360min | peak 48 | long 20 | err 0 | 4 1 11 0 0 1 +45km-3d-m-16w | peak 63 | long 22 | err 0 | 5 2 13 0 1 1 +45km-3d-m-16w-240min | peak 31.000000000000004 | long 11 | err 0 | 12 2 16 0 1 1 +45km-3d-m-16w-360min | peak 48 | long 22 | err 0 | 7 2 18 0 1 1 +45km-3d-m-24w | peak 63 | long 22 | err 0 | 7 3 15 0 2 1 +45km-3d-m-24w-240min | peak 31.000000000000004 | long 11 | err 0 | 19 4 23 0 2 1 +45km-3d-m-24w-360min | peak 48 | long 22 | err 0 | 11 3 25 0 2 1 +45km-3d-base-8w | peak 52 | long 19 | err 0 | 2 1 7 0 0 0 +45km-3d-base-8w-240min | peak 30 | long 11 | err 0 | 7 1 7 0 0 0 +45km-3d-base-8w-360min | peak 48 | long 19 | err 0 | 2 1 7 0 0 0 +45km-3d-base-16w | peak 52 | long 19 | err 0 | 4 2 14 0 0 0 +45km-3d-base-16w-240min | peak 30 | long 11 | err 0 | 14 3 14 0 0 0 +45km-3d-base-16w-360min | peak 48 | long 19 | err 0 | 4 2 14 0 0 0 +45km-3d-base-24w | peak 52 | long 19 | err 0 | 6 3 21 0 0 0 +45km-3d-base-24w-240min | peak 30 | long 11 | err 0 | 21 5 21 0 0 0 +45km-3d-base-24w-360min | peak 48 | long 19 | err 0 | 6 3 21 0 0 0 +45km-4d-10k-8w | peak 52 | long 19 | err 0 | 1 0 1 0 0 0 +45km-4d-10k-8w-240min | peak 31.000000000000004 | long 11 | err 0 | 0 1 5 0 0 0 +45km-4d-10k-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 0 0 0 +45km-4d-10k-16w | peak 52 | long 19 | err 0 | 3 0 3 0 1 0 +45km-4d-10k-16w-240min | peak 31.000000000000004 | long 11 | err 0 | 0 3 10 0 1 0 +45km-4d-10k-16w-360min | peak 48 | long 17 | err 0 | 3 0 3 0 1 0 +45km-4d-10k-24w | peak 52 | long 19 | err 0 | 5 0 5 0 2 0 +45km-4d-10k-24w-240min | peak 31.000000000000004 | long 11 | err 0 | 0 5 16 0 2 0 +45km-4d-10k-24w-360min | peak 48 | long 17 | err 0 | 5 0 5 0 2 0 +45km-4d-hm-8w | peak 52 | long 19 | err 0 | 1 0 1 1 0 1 +45km-4d-hm-8w-240min | peak 30 | long 11 | err 0 | 0 1 4 0 0 1 +45km-4d-hm-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 1 0 1 +45km-4d-hm-16w | peak 52 | long 19 | err 0 | 3 0 3 1 1 1 +45km-4d-hm-16w-240min | peak 30 | long 11 | err 0 | 0 3 10 0 1 1 +45km-4d-hm-16w-360min | peak 48 | long 17 | err 0 | 3 0 3 1 1 1 +45km-4d-hm-24w | peak 52 | long 19 | err 0 | 5 0 5 1 2 1 +45km-4d-hm-24w-240min | peak 30 | long 11 | err 0 | 0 5 16 0 2 1 +45km-4d-hm-24w-360min | peak 48 | long 17 | err 0 | 5 0 5 1 2 1 +45km-4d-m-8w | peak 57 | long 20 | err 0 | 1 0 1 1 0 1 +45km-4d-m-8w-240min | peak 30 | long 11 | err 0 | 0 1 4 0 0 1 +45km-4d-m-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 1 0 1 +45km-4d-m-16w | peak 63 | long 22 | err 0 | 1 0 1 1 1 1 +45km-4d-m-16w-240min | peak 30 | long 11 | err 0 | 0 3 6 0 1 1 +45km-4d-m-16w-360min | peak 48 | long 17 | err 0 | 1 0 1 1 1 1 +45km-4d-m-24w | peak 63 | long 22 | err 0 | 1 0 1 1 2 1 +45km-4d-m-24w-240min | peak 30 | long 11 | err 0 | 0 5 8 0 2 1 +45km-4d-m-24w-360min | peak 48 | long 17 | err 0 | 1 0 1 1 2 1 +45km-4d-base-8w | peak 52 | long 19 | err 0 | 1 0 1 0 0 0 +45km-4d-base-8w-240min | peak 30 | long 11 | err 0 | 0 1 7 0 0 0 +45km-4d-base-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 0 0 0 +45km-4d-base-16w | peak 52 | long 19 | err 0 | 3 0 3 0 0 0 +45km-4d-base-16w-240min | peak 30 | long 11 | err 0 | 0 3 14 0 0 0 +45km-4d-base-16w-360min | peak 48 | long 17 | err 0 | 3 0 3 0 0 0 +45km-4d-base-24w | peak 52 | long 19 | err 0 | 5 0 5 0 0 0 +45km-4d-base-24w-240min | peak 30 | long 11 | err 0 | 0 5 21 0 0 0 +45km-4d-base-24w-360min | peak 48 | long 17 | err 0 | 5 0 5 0 0 0 +45km-5d-10k-8w | peak 52 | long 19 | err 0 | 1 0 1 0 0 0 +45km-5d-10k-8w-240min | peak 31.000000000000004 | long 11 | err 0 | 0 1 5 0 0 0 +45km-5d-10k-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 0 0 0 +45km-5d-10k-16w | peak 52 | long 19 | err 0 | 3 0 3 0 1 0 +45km-5d-10k-16w-240min | peak 31.000000000000004 | long 11 | err 0 | 0 3 10 0 1 0 +45km-5d-10k-16w-360min | peak 48 | long 17 | err 0 | 3 0 3 0 1 0 +45km-5d-10k-24w | peak 52 | long 19 | err 0 | 5 0 5 0 2 0 +45km-5d-10k-24w-240min | peak 31.000000000000004 | long 11 | err 0 | 0 5 16 0 2 0 +45km-5d-10k-24w-360min | peak 48 | long 17 | err 0 | 5 0 5 0 2 0 +45km-5d-hm-8w | peak 52 | long 19 | err 0 | 1 0 1 1 0 1 +45km-5d-hm-8w-240min | peak 30 | long 11 | err 0 | 0 1 4 0 0 1 +45km-5d-hm-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 1 0 1 +45km-5d-hm-16w | peak 52 | long 19 | err 0 | 3 0 3 1 1 1 +45km-5d-hm-16w-240min | peak 30 | long 11 | err 0 | 0 3 10 0 1 1 +45km-5d-hm-16w-360min | peak 48 | long 17 | err 0 | 3 0 3 1 1 1 +45km-5d-hm-24w | peak 52 | long 19 | err 0 | 5 0 5 1 2 1 +45km-5d-hm-24w-240min | peak 30 | long 11 | err 0 | 0 5 16 0 2 1 +45km-5d-hm-24w-360min | peak 48 | long 17 | err 0 | 5 0 5 1 2 1 +45km-5d-m-8w | peak 57 | long 20 | err 0 | 1 0 1 1 0 1 +45km-5d-m-8w-240min | peak 30 | long 11 | err 0 | 0 1 3 0 0 1 +45km-5d-m-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 1 0 1 +45km-5d-m-16w | peak 63 | long 22 | err 0 | 1 0 1 1 1 1 +45km-5d-m-16w-240min | peak 30 | long 11 | err 0 | 0 3 5 0 1 1 +45km-5d-m-16w-360min | peak 48 | long 17 | err 0 | 1 1 1 1 1 1 +45km-5d-m-24w | peak 63 | long 22 | err 0 | 1 0 1 1 2 1 +45km-5d-m-24w-240min | peak 30 | long 11 | err 0 | 0 5 7 0 2 1 +45km-5d-m-24w-360min | peak 48 | long 17 | err 0 | 1 3 1 1 2 1 +45km-5d-base-8w | peak 52 | long 19 | err 0 | 1 0 1 0 0 0 +45km-5d-base-8w-240min | peak 30 | long 11 | err 0 | 0 1 7 0 0 0 +45km-5d-base-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 0 0 0 +45km-5d-base-16w | peak 52 | long 19 | err 0 | 3 0 3 0 0 0 +45km-5d-base-16w-240min | peak 30 | long 11 | err 0 | 0 3 14 0 0 0 +45km-5d-base-16w-360min | peak 48 | long 17 | err 0 | 3 0 3 0 0 0 +45km-5d-base-24w | peak 52 | long 19 | err 0 | 5 0 5 0 0 0 +45km-5d-base-24w-240min | peak 30 | long 11 | err 0 | 0 5 21 0 0 0 +45km-5d-base-24w-360min | peak 48 | long 17 | err 0 | 5 0 5 0 0 0 +45km-6d-10k-8w | peak 52 | long 19 | err 0 | 1 0 1 0 0 0 +45km-6d-10k-8w-240min | peak 31.000000000000004 | long 11 | err 0 | 0 1 5 0 0 0 +45km-6d-10k-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 0 0 0 +45km-6d-10k-16w | peak 52 | long 19 | err 0 | 3 0 3 0 1 0 +45km-6d-10k-16w-240min | peak 31.000000000000004 | long 11 | err 0 | 0 3 10 0 1 0 +45km-6d-10k-16w-360min | peak 48 | long 17 | err 0 | 3 0 3 0 1 0 +45km-6d-10k-24w | peak 52 | long 19 | err 0 | 5 0 5 0 2 0 +45km-6d-10k-24w-240min | peak 31.000000000000004 | long 11 | err 0 | 0 5 16 0 2 0 +45km-6d-10k-24w-360min | peak 48 | long 17 | err 0 | 5 0 5 0 2 0 +45km-6d-hm-8w | peak 52 | long 19 | err 0 | 1 0 1 1 0 1 +45km-6d-hm-8w-240min | peak 30 | long 11 | err 0 | 0 1 4 0 0 1 +45km-6d-hm-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 1 0 1 +45km-6d-hm-16w | peak 52 | long 19 | err 0 | 3 0 3 1 1 1 +45km-6d-hm-16w-240min | peak 30 | long 11 | err 0 | 0 3 10 0 1 1 +45km-6d-hm-16w-360min | peak 48 | long 17 | err 0 | 3 0 3 1 1 1 +45km-6d-hm-24w | peak 52 | long 19 | err 0 | 5 0 5 1 2 1 +45km-6d-hm-24w-240min | peak 30 | long 11 | err 0 | 0 5 16 0 2 1 +45km-6d-hm-24w-360min | peak 48 | long 17 | err 0 | 5 0 5 1 2 1 +45km-6d-m-8w | peak 57 | long 20 | err 0 | 1 0 1 1 0 1 +45km-6d-m-8w-240min | peak 30 | long 11 | err 0 | 0 1 3 0 0 1 +45km-6d-m-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 1 0 1 +45km-6d-m-16w | peak 63 | long 22 | err 0 | 1 0 1 1 1 1 +45km-6d-m-16w-240min | peak 30 | long 11 | err 0 | 0 3 5 0 1 1 +45km-6d-m-16w-360min | peak 48 | long 17 | err 0 | 1 1 1 1 1 1 +45km-6d-m-24w | peak 63 | long 22 | err 0 | 1 0 1 1 2 1 +45km-6d-m-24w-240min | peak 30 | long 11 | err 0 | 0 5 7 0 2 1 +45km-6d-m-24w-360min | peak 48 | long 17 | err 0 | 1 3 1 1 2 1 +45km-6d-base-8w | peak 52 | long 19 | err 0 | 1 0 1 0 0 0 +45km-6d-base-8w-240min | peak 30 | long 11 | err 0 | 0 1 7 0 0 0 +45km-6d-base-8w-360min | peak 48 | long 17 | err 0 | 1 0 1 0 0 0 +45km-6d-base-16w | peak 52 | long 19 | err 0 | 3 0 3 0 0 0 +45km-6d-base-16w-240min | peak 30 | long 11 | err 0 | 0 3 14 0 0 0 +45km-6d-base-16w-360min | peak 48 | long 17 | err 0 | 3 0 3 0 0 0 +45km-6d-base-24w | peak 52 | long 19 | err 0 | 5 0 5 0 0 0 +45km-6d-base-24w-240min | peak 30 | long 11 | err 0 | 0 5 21 0 0 0 +45km-6d-base-24w-360min | peak 48 | long 17 | err 0 | 5 0 5 0 0 0 +70km-3d-10k-8w | peak 81 | long 29 | err 0 | 0 1 1 0 0 0 +70km-3d-10k-8w-240min | peak 31.000000000000004 | long 11 | err 0 | 6 1 6 0 0 0 +70km-3d-10k-8w-360min | peak 51 | long 29 | err 0 | 2 0 6 0 0 0 +70km-3d-10k-16w | peak 81 | long 29 | err 0 | 0 2 3 0 1 0 +70km-3d-10k-16w-240min | peak 31.000000000000004 | long 11 | err 0 | 13 2 13 0 1 0 +70km-3d-10k-16w-360min | peak 51 | long 29 | err 0 | 6 1 13 0 1 0 +70km-3d-10k-24w | peak 81 | long 29 | err 0 | 0 3 5 0 2 0 +70km-3d-10k-24w-240min | peak 31.000000000000004 | long 11 | err 0 | 20 4 20 0 2 0 +70km-3d-10k-24w-360min | peak 51 | long 29 | err 0 | 9 1 20 0 2 0 +70km-3d-hm-8w | peak 81 | long 29 | err 0 | 0 1 3 0 0 0 +70km-3d-hm-8w-240min | peak 31.000000000000004 | long 11 | err 0 | 5 1 8 0 0 1 +70km-3d-hm-8w-360min | peak 49 | long 18 | err 0 | 2 1 8 0 0 1 +70km-3d-hm-16w | peak 81 | long 29 | err 0 | 0 2 5 0 1 0 +70km-3d-hm-16w-240min | peak 31.000000000000004 | long 11 | err 0 | 12 2 15 0 1 1 +70km-3d-hm-16w-360min | peak 49 | long 18 | err 0 | 5 2 15 0 1 1 +70km-3d-hm-24w | peak 81 | long 29 | err 0 | 0 3 7 0 2 0 +70km-3d-hm-24w-240min | peak 31.000000000000004 | long 11 | err 0 | 19 4 22 0 2 1 +70km-3d-hm-24w-360min | peak 49 | long 18 | err 0 | 8 4 22 0 2 1 +70km-3d-m-8w | peak 81 | long 29 | err 0 | 0 1 7 0 0 0 +70km-3d-m-8w-240min | peak 31 | long 11 | err 0 | 4 1 11 0 0 1 +70km-3d-m-8w-360min | peak 49 | long 18 | err 0 | 1 1 11 0 0 1 +70km-3d-m-16w | peak 81 | long 29 | err 0 | 0 2 9 0 1 0 +70km-3d-m-16w-240min | peak 31 | long 11 | err 0 | 11 2 18 0 1 1 +70km-3d-m-16w-360min | peak 49 | long 18 | err 0 | 4 2 18 0 1 1 +70km-3d-m-24w | peak 81 | long 29 | err 0 | 0 3 11 0 2 0 +70km-3d-m-24w-240min | peak 31 | long 11 | err 0 | 18 4 25 0 2 1 +70km-3d-m-24w-360min | peak 49 | long 18 | err 0 | 8 4 25 0 2 1 +70km-3d-base-8w | peak 81 | long 29 | err 0 | 0 1 1 0 0 0 +70km-3d-base-8w-240min | peak 30 | long 11 | err 0 | 7 1 7 0 0 0 +70km-3d-base-8w-360min | peak 49 | long 29 | err 0 | 1 0 7 0 0 0 +70km-3d-base-16w | peak 81 | long 29 | err 0 | 0 2 3 0 0 0 +70km-3d-base-16w-240min | peak 30 | long 11 | err 0 | 14 2 14 0 0 0 +70km-3d-base-16w-360min | peak 49 | long 29 | err 0 | 3 0 14 0 0 0 +70km-3d-base-24w | peak 81 | long 29 | err 0 | 0 3 5 0 0 0 +70km-3d-base-24w-240min | peak 30 | long 11 | err 0 | 21 3 21 0 0 0 +70km-3d-base-24w-360min | peak 49 | long 29 | err 0 | 5 0 21 0 0 0 +70km-4d-10k-8w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-4d-10k-8w-240min | peak 29 | long 10 | err 0 | 0 1 1 0 0 0 +70km-4d-10k-8w-360min | peak 49 | long 17 | err 0 | 0 1 0 0 0 0 +70km-4d-10k-16w | peak 81 | long 29 | err 0 | 0 0 0 0 1 0 +70km-4d-10k-16w-240min | peak 29 | long 10 | err 0 | 0 3 3 0 1 0 +70km-4d-10k-16w-360min | peak 49 | long 17 | err 0 | 0 3 0 0 1 0 +70km-4d-10k-24w | peak 81 | long 29 | err 0 | 0 0 0 0 2 0 +70km-4d-10k-24w-240min | peak 29 | long 10 | err 0 | 0 5 4 0 2 0 +70km-4d-10k-24w-360min | peak 49 | long 17 | err 0 | 0 5 0 0 2 0 +70km-4d-hm-8w | peak 81 | long 29 | err 0 | 0 0 0 1 0 0 +70km-4d-hm-8w-240min | peak 31.000000000000004 | long 10 | err 0 | 0 1 2 0 0 1 +70km-4d-hm-8w-360min | peak 47 | long 17 | err 0 | 0 1 0 1 0 1 +70km-4d-hm-16w | peak 81 | long 29 | err 0 | 0 0 0 1 1 0 +70km-4d-hm-16w-240min | peak 31.000000000000004 | long 10 | err 0 | 0 3 3 0 1 1 +70km-4d-hm-16w-360min | peak 47 | long 17 | err 0 | 0 3 0 1 1 1 +70km-4d-hm-24w | peak 81 | long 29 | err 0 | 0 0 0 1 2 0 +70km-4d-hm-24w-240min | peak 31.000000000000004 | long 10 | err 0 | 0 5 5 0 2 1 +70km-4d-hm-24w-360min | peak 47 | long 17 | err 0 | 0 5 0 1 2 1 +70km-4d-m-8w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-4d-m-8w-240min | peak 31.000000000000004 | long 10 | err 0 | 0 1 1 0 0 1 +70km-4d-m-8w-360min | peak 48 | long 17 | err 0 | 0 1 0 1 0 1 +70km-4d-m-16w | peak 81 | long 29 | err 0 | 0 0 0 0 1 0 +70km-4d-m-16w-240min | peak 31.000000000000004 | long 10 | err 0 | 0 3 2 0 1 1 +70km-4d-m-16w-360min | peak 48 | long 17 | err 0 | 0 3 0 1 1 1 +70km-4d-m-24w | peak 81 | long 29 | err 0 | 0 0 0 0 2 0 +70km-4d-m-24w-240min | peak 31.000000000000004 | long 10 | err 0 | 0 5 4 0 2 1 +70km-4d-m-24w-360min | peak 48 | long 17 | err 0 | 0 5 0 1 2 1 +70km-4d-base-8w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-4d-base-8w-240min | peak 28 | long 10 | err 0 | 0 1 1 0 0 0 +70km-4d-base-8w-360min | peak 47 | long 17 | err 0 | 0 1 0 0 0 0 +70km-4d-base-16w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-4d-base-16w-240min | peak 28 | long 10 | err 0 | 0 3 3 0 0 0 +70km-4d-base-16w-360min | peak 47 | long 17 | err 0 | 0 3 0 0 0 0 +70km-4d-base-24w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-4d-base-24w-240min | peak 28 | long 10 | err 0 | 0 5 5 0 0 0 +70km-4d-base-24w-360min | peak 47 | long 17 | err 0 | 0 5 0 0 0 0 +70km-5d-10k-8w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-5d-10k-8w-240min | peak 29 | long 9 | err 0 | 0 1 0 0 0 0 +70km-5d-10k-8w-360min | peak 49 | long 16 | err 0 | 0 1 0 0 0 0 +70km-5d-10k-16w | peak 81 | long 29 | err 0 | 0 0 0 0 1 0 +70km-5d-10k-16w-240min | peak 29 | long 9 | err 0 | 0 3 0 0 1 0 +70km-5d-10k-16w-360min | peak 49 | long 16 | err 0 | 0 3 0 0 1 0 +70km-5d-10k-24w | peak 81 | long 29 | err 0 | 0 0 0 0 2 0 +70km-5d-10k-24w-240min | peak 29 | long 9 | err 0 | 0 5 0 0 2 0 +70km-5d-10k-24w-360min | peak 49 | long 16 | err 0 | 0 5 0 0 2 0 +70km-5d-hm-8w | peak 81 | long 29 | err 0 | 0 0 0 1 0 0 +70km-5d-hm-8w-240min | peak 31.000000000000004 | long 9 | err 0 | 0 1 0 0 0 1 +70km-5d-hm-8w-360min | peak 45 | long 16 | err 0 | 0 1 0 0 0 1 +70km-5d-hm-16w | peak 81 | long 29 | err 0 | 0 0 0 1 1 0 +70km-5d-hm-16w-240min | peak 31.000000000000004 | long 9 | err 0 | 0 3 0 0 1 1 +70km-5d-hm-16w-360min | peak 45 | long 16 | err 0 | 0 3 0 0 1 1 +70km-5d-hm-24w | peak 81 | long 29 | err 0 | 0 0 0 1 2 0 +70km-5d-hm-24w-240min | peak 31.000000000000004 | long 9 | err 0 | 0 5 0 0 2 1 +70km-5d-hm-24w-360min | peak 45 | long 16 | err 0 | 0 5 0 0 2 1 +70km-5d-m-8w | peak 81 | long 29 | err 0 | 0 0 0 1 0 0 +70km-5d-m-8w-240min | peak 31.000000000000004 | long 9 | err 0 | 0 1 0 0 0 1 +70km-5d-m-8w-360min | peak 46 | long 16 | err 0 | 0 1 0 0 0 1 +70km-5d-m-16w | peak 81 | long 29 | err 0 | 0 0 0 1 1 0 +70km-5d-m-16w-240min | peak 31.000000000000004 | long 9 | err 0 | 0 3 0 0 1 1 +70km-5d-m-16w-360min | peak 46 | long 16 | err 0 | 0 3 0 0 1 1 +70km-5d-m-24w | peak 81 | long 29 | err 0 | 0 0 0 1 2 0 +70km-5d-m-24w-240min | peak 31.000000000000004 | long 9 | err 0 | 0 5 0 0 2 1 +70km-5d-m-24w-360min | peak 46 | long 16 | err 0 | 0 5 0 0 2 1 +70km-5d-base-8w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-5d-base-8w-240min | peak 25 | long 9 | err 0 | 0 1 0 0 0 0 +70km-5d-base-8w-360min | peak 45 | long 16 | err 0 | 0 1 0 0 0 0 +70km-5d-base-16w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-5d-base-16w-240min | peak 25 | long 9 | err 0 | 0 3 0 0 0 0 +70km-5d-base-16w-360min | peak 45 | long 16 | err 0 | 0 3 0 0 0 0 +70km-5d-base-24w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-5d-base-24w-240min | peak 25 | long 9 | err 0 | 0 5 0 0 0 0 +70km-5d-base-24w-360min | peak 45 | long 16 | err 0 | 0 5 0 0 0 0 +70km-6d-10k-8w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-6d-10k-8w-240min | peak 29 | long 9 | err 0 | 4 1 5 0 0 0 +70km-6d-10k-8w-360min | peak 49 | long 16 | err 0 | 5 1 5 0 0 0 +70km-6d-10k-16w | peak 81 | long 29 | err 0 | 0 0 0 0 1 0 +70km-6d-10k-16w-240min | peak 29 | long 9 | err 0 | 9 3 10 0 1 0 +70km-6d-10k-16w-360min | peak 49 | long 16 | err 0 | 10 3 10 0 1 0 +70km-6d-10k-24w | peak 81 | long 29 | err 0 | 0 0 0 0 2 0 +70km-6d-10k-24w-240min | peak 29 | long 9 | err 0 | 14 5 15 0 2 0 +70km-6d-10k-24w-360min | peak 49 | long 16 | err 0 | 15 5 15 0 2 0 +70km-6d-hm-8w | peak 81 | long 29 | err 0 | 0 0 0 1 0 0 +70km-6d-hm-8w-240min | peak 31.000000000000004 | long 9 | err 0 | 3 1 4 0 0 1 +70km-6d-hm-8w-360min | peak 45 | long 16 | err 0 | 4 1 4 0 0 1 +70km-6d-hm-16w | peak 81 | long 29 | err 0 | 0 0 0 1 1 0 +70km-6d-hm-16w-240min | peak 31.000000000000004 | long 9 | err 0 | 8 3 9 0 1 1 +70km-6d-hm-16w-360min | peak 45 | long 16 | err 0 | 9 3 9 0 1 1 +70km-6d-hm-24w | peak 81 | long 29 | err 0 | 0 0 0 1 2 0 +70km-6d-hm-24w-240min | peak 31.000000000000004 | long 9 | err 0 | 13 5 14 0 2 1 +70km-6d-hm-24w-360min | peak 45 | long 16 | err 0 | 14 5 14 0 2 1 +70km-6d-m-8w | peak 81 | long 29 | err 0 | 0 0 0 1 0 0 +70km-6d-m-8w-240min | peak 31.000000000000004 | long 9 | err 0 | 2 1 3 0 0 1 +70km-6d-m-8w-360min | peak 46 | long 16 | err 0 | 3 1 3 0 0 1 +70km-6d-m-16w | peak 81 | long 29 | err 0 | 0 0 0 1 1 0 +70km-6d-m-16w-240min | peak 31.000000000000004 | long 9 | err 0 | 7 3 8 0 1 1 +70km-6d-m-16w-360min | peak 45 | long 16 | err 0 | 8 3 8 0 1 1 +70km-6d-m-24w | peak 81 | long 29 | err 0 | 0 0 0 1 2 0 +70km-6d-m-24w-240min | peak 31.000000000000004 | long 9 | err 0 | 12 5 13 0 2 1 +70km-6d-m-24w-360min | peak 45 | long 16 | err 0 | 13 5 13 0 2 1 +70km-6d-base-8w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-6d-base-8w-240min | peak 25 | long 9 | err 0 | 5 1 6 0 0 0 +70km-6d-base-8w-360min | peak 45 | long 16 | err 0 | 6 1 6 0 0 0 +70km-6d-base-16w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-6d-base-16w-240min | peak 25 | long 9 | err 0 | 10 3 11 0 0 0 +70km-6d-base-16w-360min | peak 45 | long 16 | err 0 | 11 3 11 0 0 0 +70km-6d-base-24w | peak 81 | long 29 | err 0 | 0 0 0 0 0 0 +70km-6d-base-24w-240min | peak 25 | long 9 | err 0 | 15 5 16 0 0 0 +70km-6d-base-24w-360min | peak 45 | long 16 | err 0 | 16 5 16 0 0 0 diff --git a/packages/cli/src/__snapshots__/plan-shape-review.txt b/packages/cli/src/__snapshots__/plan-shape-review.txt new file mode 100644 index 0000000..de39884 --- /dev/null +++ b/packages/cli/src/__snapshots__/plan-shape-review.txt @@ -0,0 +1,210 @@ +## P1 + 1 2026-10-19 base 49 4b L17 S2 quality_intervals:4×1000@4:32 | quality_continuous:4 km 5:01→4:32 + 2 2026-10-26 base 52 4b L19 S2 quality_intervals:4×1000@4:32 | quality_continuous:4 km 5:01→4:32 + 3 2026-11-02 base 52 4b L19 S2 quality_intervals:4×1000@4:32 | quality_continuous:4 km 5:01→4:32 + 4 2026-11-09 base↓ 36 3b L13 S1 quality_intervals:4×1000@4:32 + 5 2026-11-16 base 52 5b L19 S2 [test] easy_hills:15×200 | test:5 km + 6 2026-11-23 base 52 4b L19 S2 quality_intervals:4×1000@4:32 | quality_continuous:4 km 5:01→4:32 + 7 2026-11-30 base 52 4b L19 S2 quality_intervals:4×1000@4:32 | quality_continuous:4 km 5:01→4:32 + 8 2026-12-07 base↓ 36 3b L13 S1 quality_intervals:4×1000@4:32 + 9 2026-12-14 build 52 4b L19 S2 quality_intervals:4×1000@4:32 | quality_continuous:4 km 5:01→4:32 +10 2026-12-21 build 52 4b L19 S2 quality_intervals:4×1000@4:32 | quality_continuous:4 km 5:01→4:32 +11 2026-12-28 build 52 5b L19 S2 [test] easy_hills:15×200 | test:5 km +12 2027-01-04 build↓ 36 3b L13 S1 quality_intervals:4×1000@4:32 +13 2027-01-11 build 52 4b L19 S2 quality_intervals:4×1000@4:32 | quality_continuous:4 km 5:01→4:32 +14 2027-01-18 build 52 4b L19 S2 quality_intervals:4×1000@4:32 | quality_continuous:4 km 5:01→4:32 +15 2027-01-25 build 52 4b L19 S2 quality_intervals:4×1000@4:32 | quality_continuous:4 km 5:01→4:32 +16 2027-02-01 build↓ 36 3b L13 S1 quality_intervals:4×1000@4:32 +17 2027-02-08 build 52 5b L19 S2 [test] easy_hills:15×200 | test:5 km +18 2027-02-15 peak 52 4b L19 S1 quality_intervals:4×1000@4:04 | quality_continuous:4 km 4:25/5:05 +19 2027-02-22 peak 52 4b L19 S1 quality_intervals:4×1000@4:04 | quality_continuous:4 km 4:25/5:05 +20 2027-03-01 peak↓ 36 3b L13 S1 quality_intervals:4×1000@4:04 +21 2027-03-08 peak 52 4b L19 S1 quality_intervals:4×1000@4:04 | quality_continuous:4 km 4:25/5:05 +22 2027-03-15 taper 36 4b L0 S0 quality_intervals:4×1000@4:04 | quality_continuous:4 km 4:25/5:05 +23 2027-03-22 race 16 3b L0 S0 [race] sharpener:5×300@4:04 +24 2027-03-29 transition 22 3b L0 S0 +25 2027-04-05 transition 44 4b L16 S1 quality_intervals:6×1000@4:32 + +longNotLongest 2026-11-09 13/15 [S-2,J-1] +sessionShareHigh 2026-11-15 15/36 [E-3] +longNotLongest 2026-12-07 13/15 [S-2,J-1] +sessionShareHigh 2026-12-13 15/36 [E-3] +longNotLongest 2027-01-04 13/15 [S-2,J-1] +sessionShareHigh 2027-01-10 15/36 [E-3] +longNotLongest 2027-02-01 13/15 [S-2,J-1] +sessionShareHigh 2027-02-07 15/36 [E-3] +longNotLongest 2027-03-01 13/15 [S-2,J-1] +sessionShareHigh 2027-03-07 15/36 [E-3] +postRaceAccentHeavy 2027-04-05 6/4 [R-8] +staleProgression 2027-01-25 10/15 [P-1] +staleProgression 2027-03-08 19/21 [P-1] +longBelowGoal 19/21 [J-2,P-7] + +## P2 + 1 2026-10-19 base 13 3b L5 S2 + 2 2026-10-26 base 14 3b L5 S2 + 3 2026-11-02 base 15 3b L5 S2 + 4 2026-11-09 base↓ 11 3b L4 S1 + 5 2026-11-16 base 16 3b L6 S2 quality_intervals:4×1000@4:32 + 6 2026-11-23 base 18 3b L6 S2 quality_intervals:4×1000@4:32 + 7 2026-11-30 base 19 3b L7 S2 quality_intervals:4×1000@4:32 + 8 2026-12-07 base↓ 13 3b L5 S1 + 9 2026-12-14 build 21 4b L7 S2 [test] test:5 km +10 2026-12-21 build 22 3b L8 S2 quality_intervals:4×1000@4:32 +11 2026-12-28 build 24 3b L9 S2 quality_intervals:4×1000@4:32 +12 2027-01-04 build↓ 17 3b L6 S1 quality_intervals:4×1000@4:32 +13 2027-01-11 build 26 3b L9 S2 quality_intervals:4×1000@4:32 +14 2027-01-18 build 28 3b L10 S2 quality_intervals:4×1000@4:32 +15 2027-01-25 build 30 4b L11 S2 [test] test:5 km +16 2027-02-01 build↓ 21 3b L7 S1 quality_intervals:4×1000@4:32 +17 2027-02-08 build 33 3b L12 S2 quality_intervals:4×1000@4:32 +18 2027-02-15 peak 35 3b L12 S1 quality_intervals:4×1000@4:04 +19 2027-02-22 peak 38 3b L14 S1 quality_intervals:4×1000@4:04 +20 2027-03-01 peak↓ 27 3b L10 S1 quality_intervals:4×1000@4:04 +21 2027-03-08 peak 38 3b L14 S1 quality_intervals:4×1000@4:04 +22 2027-03-15 taper 27 3b L0 S0 quality_intervals:4×1000@4:04 +23 2027-03-22 race 10 2b L0 S0 [race] +24 2027-03-29 transition 16 3b L0 S0 +25 2027-04-05 transition 33 3b L12 S1 quality_intervals:4×1000@4:32 + +longNotLongest 2026-11-16 6/8 [S-2,J-1] +sessionShareHigh 2026-11-17 8/16 [E-3] +longNotLongest 2026-11-23 6/8 [S-2,J-1] +sessionShareHigh 2026-11-24 8/18 [E-3] +longNotLongest 2026-11-30 7/8 [S-2,J-1] +sessionShareHigh 2026-12-01 8/19 [E-3] +sessionShareHigh 2026-12-22 8/22 [E-3] +longNotLongest 2027-01-04 6/8 [S-2,J-1] +sessionShareHigh 2027-01-05 8/17 [E-3] +sessionShareHigh 2027-01-24 10/28 [E-3] +longNotLongest 2027-02-01 7/8 [S-2,J-1] +sessionShareHigh 2027-02-02 8/21 [E-3] +longNotLongest 2027-02-08 12/13 [S-2,J-1] +sessionShareHigh 2027-02-14 13/33 [E-3] +longNotLongest 2027-02-15 12/15 [S-2,J-1] +sessionShareHigh 2027-02-21 15/35 [E-3] +longNotLongest 2027-02-22 14/16 [S-2,J-1] +sessionShareHigh 2027-02-28 16/38 [E-3] +longNotLongest 2027-03-08 14/16 [S-2,J-1] +sessionShareHigh 2027-03-14 16/38 [E-3] +sessionShareHigh 2027-03-17 9.5/27 [E-3] +sessionShareHigh 2027-03-21 9.5/27 [E-3] +longNotLongest 2027-04-05 12/13 [S-2,J-1] +sessionShareHigh 2027-04-07 13/33 [E-3] +staleProgression 2027-03-08 19/21 [P-1] +longBelowGoal 14/21 [J-2,P-7] + +## P2b + 1 2026-10-19 base 13 3b L5 S2 + 2 2026-10-26 base 14 3b L5 S2 + 3 2026-11-02 base 15 3b L5 S2 + 4 2026-11-09 base↓ 11 3b L4 S1 + 5 2026-11-16 base 16 3b L6 S2 quality_intervals:4×1000@4:32 + 6 2026-11-23 base 17 3b L6 S2 quality_intervals:4×1000@4:32 + 7 2026-11-30 base 17 3b L6 S2 quality_intervals:4×1000@4:32 + 8 2026-12-07 base↓ 12 3b L4 S1 + 9 2026-12-14 build 17 3b L6 S2 quality_intervals:4×1000@4:32 +10 2026-12-21 build 17 3b L6 S2 quality_intervals:4×1000@4:32 +11 2026-12-28 build 17 3b L6 S2 quality_intervals:4×1000@4:32 +12 2027-01-04 build↓ 12 3b L4 S1 +13 2027-01-11 build 17 3b L6 S2 quality_intervals:4×1000@4:32 +14 2027-01-18 build 17 3b L6 S2 quality_intervals:4×1000@4:32 +15 2027-01-25 build 17 3b L6 S2 quality_intervals:4×1000@4:32 +16 2027-02-01 build↓ 12 3b L4 S1 +17 2027-02-08 build 17 3b L6 S2 quality_intervals:4×1000@4:32 +18 2027-02-15 peak 17 3b L6 S1 quality_intervals:4×1000@4:04 +19 2027-02-22 peak 17 3b L6 S1 quality_intervals:4×1000@4:04 +20 2027-03-01 peak↓ 12 3b L4 S1 +21 2027-03-08 peak 17 3b L6 S1 quality_intervals:4×1000@4:04 +22 2027-03-15 taper 12 3b L0 S0 +23 2027-03-22 race 10 2b L0 S0 [race] +24 2027-03-29 transition 7 3b L0 S0 +25 2027-04-05 transition 15 3b L5 S1 + +longNotLongest 2026-11-16 6/8 [S-2,J-1] +sessionShareHigh 2026-11-17 8/16 [E-3] +longNotLongest 2026-11-23 6/8 [S-2,J-1] +sessionShareHigh 2026-11-24 8/17 [E-3] +longNotLongest 2026-11-30 6/8 [S-2,J-1] +sessionShareHigh 2026-12-01 8/17 [E-3] +longNotLongest 2026-12-14 6/8 [S-2,J-1] +sessionShareHigh 2026-12-15 8/17 [E-3] +longNotLongest 2026-12-21 6/8 [S-2,J-1] +sessionShareHigh 2026-12-22 8/17 [E-3] +longNotLongest 2026-12-28 6/8 [S-2,J-1] +sessionShareHigh 2026-12-29 8/17 [E-3] +longNotLongest 2027-01-11 6/8 [S-2,J-1] +sessionShareHigh 2027-01-12 8/17 [E-3] +longNotLongest 2027-01-18 6/8 [S-2,J-1] +sessionShareHigh 2027-01-19 8/17 [E-3] +longNotLongest 2027-01-25 6/8 [S-2,J-1] +sessionShareHigh 2027-01-26 8/17 [E-3] +longNotLongest 2027-02-08 6/8 [S-2,J-1] +sessionShareHigh 2027-02-09 8/17 [E-3] +longNotLongest 2027-02-15 6/8 [S-2,J-1] +sessionShareHigh 2027-02-16 8/17 [E-3] +longNotLongest 2027-02-22 6/8 [S-2,J-1] +sessionShareHigh 2027-02-23 8/17 [E-3] +longNotLongest 2027-03-08 6/8 [S-2,J-1] +sessionShareHigh 2027-03-09 8/17 [E-3] +staleProgression 2027-01-25 11/15 [P-1] +staleProgression 2027-03-08 19/21 [P-1] +longBelowGoal 6/21 [J-2,P-7] + +## P3 + 1 2026-10-19 base 16 3b L6 S2 quality_intervals:4×1000@4:32 + 2 2026-10-26 base 16 3b L6 S2 quality_intervals:4×1000@4:32 + 3 2026-11-02 base 16 3b L6 S2 quality_intervals:4×1000@4:32 + 4 2026-11-09 base↓ 24 3b L9 S1 quality_intervals:4×1000@4:32 + 5 2026-11-16 base 14 2b L5 S2 [test] test:5 km + 6 2026-11-23 base 16 3b L6 S2 quality_intervals:4×1000@4:32 + 7 2026-11-30 base 16 3b L6 S2 quality_intervals:4×1000@4:32 + 8 2026-12-07 base↓ 24 3b L9 S1 quality_intervals:4×1000@4:32 + 9 2026-12-14 build 16 3b L6 S2 quality_intervals:4×1000@4:32 +10 2026-12-21 build 16 3b L6 S2 quality_intervals:4×1000@4:32 +11 2026-12-28 build 14 2b L5 S2 [test] test:5 km +12 2027-01-04 build↓ 24 3b L9 S1 quality_intervals:4×1000@4:32 +13 2027-01-11 build 16 3b L6 S2 quality_intervals:4×1000@4:32 +14 2027-01-18 build 16 3b L6 S2 quality_intervals:4×1000@4:32 +15 2027-01-25 build 16 3b L6 S2 quality_intervals:4×1000@4:32 +16 2027-02-01 build↓ 24 3b L9 S1 quality_intervals:4×1000@4:32 +17 2027-02-08 build 14 2b L5 S2 [test] test:5 km +18 2027-02-15 peak 23 3b L8 S1 quality_intervals:4×1000@4:04 +19 2027-02-22 peak 23 3b L8 S1 quality_intervals:4×1000@4:04 +20 2027-03-01 peak↓ 25 3b L9 S1 quality_intervals:4×1000@4:04 +21 2027-03-08 peak 23 3b L8 S1 quality_intervals:4×1000@4:04 +22 2027-03-15 taper 29 4b L0 S0 quality_intervals:4×1000@4:04 | quality_continuous:3 km 4:25/5:05 +23 2027-03-22 race 16 3b L0 S0 [race] sharpener:5×300@4:04 +24 2027-03-29 transition 22 3b L0 S0 +25 2027-04-05 transition 21 3b L7 S1 quality_intervals:4×1000@4:32 + +longNotLongest 2026-10-19 6/8 [S-2,J-1] +sessionShareHigh 2026-10-20 8/16 [E-3] +longNotLongest 2026-10-26 6/8 [S-2,J-1] +sessionShareHigh 2026-10-27 8/16 [E-3] +longNotLongest 2026-11-02 6/8 [S-2,J-1] +sessionShareHigh 2026-11-03 8/16 [E-3] +longNotLongest 2026-11-23 6/8 [S-2,J-1] +sessionShareHigh 2026-11-24 8/16 [E-3] +longNotLongest 2026-11-30 6/8 [S-2,J-1] +sessionShareHigh 2026-12-01 8/16 [E-3] +longNotLongest 2026-12-14 6/8 [S-2,J-1] +sessionShareHigh 2026-12-15 8/16 [E-3] +longNotLongest 2026-12-21 6/8 [S-2,J-1] +sessionShareHigh 2026-12-22 8/16 [E-3] +longNotLongest 2027-01-11 6/8 [S-2,J-1] +sessionShareHigh 2027-01-12 8/16 [E-3] +longNotLongest 2027-01-18 6/8 [S-2,J-1] +sessionShareHigh 2027-01-19 8/16 [E-3] +longNotLongest 2027-01-25 6/8 [S-2,J-1] +sessionShareHigh 2027-01-26 8/16 [E-3] +longNotLongest 2027-04-05 7/8 [S-2,J-1] +sessionShareHigh 2027-04-06 8/21 [E-3] +deloadNotLighter 2026-11-09 24/14 [P-2] +deloadNotLighter 2026-12-07 24/16 [P-2] +deloadNotLighter 2027-01-04 24/14 [P-2] +deloadNotLighter 2027-02-01 24/14 [P-2] +deloadNotLighter 2027-03-01 25/23 [P-2] +staleProgression 2027-01-25 10/15 [P-1] +staleProgression 2027-03-08 19/21 [P-1] +longBelowGoal 9/21 [J-2,P-7] diff --git a/packages/cli/src/calibration.ts b/packages/cli/src/calibration.ts index e077ecc..e3eb154 100644 --- a/packages/cli/src/calibration.ts +++ b/packages/cli/src/calibration.ts @@ -11,6 +11,67 @@ export interface Calibration { candidates: { result: RaceResult; ageDays: number; vdot: number; reason: 'selected' | 'lower-vdot' | 'excluded' | 'future' | 'stale' | 'terrain' }[] } +/** Z-10: cel szosowy (bez `terrain` albo `road`) — tylko wtedy trail ustępuje szosie. */ +export const isRoadGoal = (goal: { terrain?: string | undefined }): boolean => goal.terrain !== 'trail' && goal.terrain !== 'ultra' + +/** + * Ten sam wybrany wynik — jedna definicja dla regeneracji i podpowiedzi `why`: + * data, dystans, czas, teren i wykluczenie (resultKey), bez nazwy. Zmiana terenu + * nie zmienia stref, ale zmienia ostrzeżenie Z-10 w planie, więc plan trzeba zapisać. + */ +export const sameSelection = (a: RaceResult | undefined, b: RaceResult | undefined): boolean => + a === undefined || b === undefined ? a === b : resultKey(a) === resultKey(b) + +/** + * Co zrobiłby dziś `trainctl plan` z kalibracją stref. Regeneracja kalibruje z datą + * dnia regeneracji, więc liczymy dokładnie to samo: `inspectCalibration` na wynikach + * z dzisiejszego trainctl.yaml. `changed` — strefy przyszłych dni powstałyby z innego + * wyniku albo bez wyniku. Opisy zapisanych wyników w `why` zostają decyzjami z dnia + * kalibracji; ta jedna odpowiedź mówi, co się od tego czasu zmieniło. + */ +export function recalibrationToday( + plan: { calibration: Calibration; vdot: number; vdotSource: string }, + results: RaceResult[], today: string, goal: GoalForZones, +): { selected: RaceResult | null; source: ZoneSource; changed: boolean } { + const selected = inspectCalibration(results, today, isRoadGoal(goal)).selected ?? null + const zones = zoneCalibration(selected ?? undefined, goal) + const changed = !sameSelection(selected ?? undefined, plan.calibration.selected) || zones.source !== plan.vdotSource || + (zones.source !== 'none' && roundVdot(zones.vdot) !== plan.vdot) + return { selected, source: zones.source, changed } +} + +type GoalForZones = { kind?: string | undefined; terrain?: string | undefined; targetTimeSec?: number | undefined; distanceKm: number } + +/** Ten sam zbiór wyników (bez kolejności i nazw) — regeneracja zapisuje plan, gdy się zmienił. */ +export const sameResults = (a: RaceResult[] | undefined, b: RaceResult[] | undefined): boolean => + JSON.stringify((a ?? []).map(resultKey).sort()) === JSON.stringify((b ?? []).map(resultKey).sort()) +export type ZoneSource = 'result' | 'goal-target' | 'none' + +/** + * Źródło i VDOT stref (VDOT bez zaokrąglenia — strefy idą z pełnej wartości): z wybranego + * wyniku albo z czasu docelowego; `none`, gdy plan nie ma z czego liczyć. Jedna funkcja + * dla computePlan i podpowiedzi `why`. + */ +export function zoneCalibration(selected: RaceResult | undefined, goal: GoalForZones): + { source: 'result' | 'goal-target'; vdot: number } | { source: 'none' } { + const source = zoneSource(selected, goal) + if (source === 'result') return { source, vdot: vdotFromRace(selected!.distanceKm, selected!.timeSec) } + if (source === 'goal-target') return { source, vdot: vdotFromRace(goal.distanceKm, goal.targetTimeSec!) } + return { source } +} + +/** VDOT zapisywany w planie: jedno miejsce po przecinku. */ +export const roundVdot = (vdot: number): number => Math.round(vdot * 10) / 10 + +/** + * Skąd plan weźmie strefy: z wybranego wyniku, z czasu docelowego (cel ze startem + * i `targetTimeSec`) albo znikąd — wtedy `trainctl plan` zatrzymuje się błędem. + */ +export function zoneSource(selected: RaceResult | undefined, goal: Pick): ZoneSource { + if (selected) return 'result' + return goal.targetTimeSec && goal.kind !== 'base' ? 'goal-target' : 'none' +} + export function inspectCalibration(results: RaceResult[], today: string, roadGoal = true): Calibration { const candidates: Calibration['candidates'] = results.map((result) => { const ageDays = diffDays(result.date, today) diff --git a/packages/cli/src/cli-040.test.ts b/packages/cli/src/cli-040.test.ts index f257281..cfd4334 100644 --- a/packages/cli/src/cli-040.test.ts +++ b/packages/cli/src/cli-040.test.ts @@ -182,8 +182,9 @@ describe('status', () => { cmdPlan(dir, { date: '2026-08-08' }) writeFileSync(join(dir, 'log.jsonl'), '{"date":"2026-08-11"\n', 'utf-8') const r = cmdStatus(dir) - expect(r.code).toBe(1) - expect(r.data).toMatchObject({ error: expect.any(String) }) + // od 0.6.1 uszkodzony wiersz jest pomijany, a status nazywa go w ostrzeżeniu + expect(r.code).toBe(0) + expect(r.output).toContain('line 1') }) it('podpowiedź commita wymienia tylko pliki treningowe, nigdy git add -A', () => { cmdPlan(dir, { date: '2026-08-08' }) @@ -344,7 +345,7 @@ describe('today i interaktywny log', () => { }) it('lista wyboru: ostatnie siedem dni od dziś wstecz, ze statusem z dziennika', () => { cmdPlan(dir, { date: '2026-08-08' }) - const choices = logChoices(loadPlan(dir), '2026-08-13', new Map([['2026-08-11', 'done']])) + const choices = logChoices(loadPlan(dir), '2026-08-13', new Map([['2026-08-11', { status: 'done' }]])) expect(choices.map((c) => c.value)).toEqual(['2026-08-13', '2026-08-12', '2026-08-11', '2026-08-10', '2026-08-09', '2026-08-08', '2026-08-07']) expect(choices.find((c) => c.value === '2026-08-11')!.hint).toContain('[logged: done]') }) diff --git a/packages/cli/src/cli-061.test.ts b/packages/cli/src/cli-061.test.ts new file mode 100644 index 0000000..e0776f7 --- /dev/null +++ b/packages/cli/src/cli-061.test.ts @@ -0,0 +1,870 @@ +/** + * Pakiet A (docs/PLAN-v0.7.md, etap 1): etykiety i formaty wyjścia bez zmian + * w silniku — nagłówki tabeli wykonania, „do startu" bez powtórzenia, liczby + * dziesiętne w formacie języka, status dziennika słowem z katalogu, adresy + * nie cięte przy zawijaniu, wiek wyniku liczony od dziś. + */ +import { appendFileSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs' +import { tmpdir } from 'node:os' +import { join } from 'node:path' +import { afterEach, beforeEach, describe, expect, it } from 'vitest' +import { distanceClass, goalClass, setLocale, vdotFromRace } from 'trainctl-core' +import { cmdAdapt, cmdDesk, cmdLog, cmdPlan, cmdReschedule, cmdReview, cmdRules, cmdShift, cmdStatus, cmdToday, cmdWeek, cmdWhy } from './commands.ts' +import { ruleEvidence } from './rules-explain.ts' +import { logChoices, parseKmText, parseRpeText, plannedKmDefault } from './interactive.ts' +import { recalibrationToday, roundVdot, zoneCalibration, zoneSource } from './calibration.ts' +import { kmLabel, logStatusText, parseDecimal, shownKm, workoutKm } from './format.ts' +import { loadPlan, writePlan } from './planfile.ts' +import { appendLog, latestByDate, lineSeparator, LOG_LIMITS, readLog, readStrengthLog } from './logfile.ts' +import { helpItem } from './ui/help.ts' +import { improveEn } from './i18n/improve-en.ts' +import { improvePl } from './i18n/improve-pl.ts' +import { coachEn } from './i18n/coach-en.ts' +import { coachPl } from './i18n/coach-pl.ts' +import { shortenDetail } from './proposals.ts' +import { renderAnsi, wrap, wrapText } from './ui/blocks.ts' +import { parseDistanceInput } from './ui/wizard.ts' +import { renderChoices } from './ui/select.ts' +import { Theme, visibleLength } from './ui/theme.ts' + +const CONFIG = `athlete: + recentWeeklyKm: 45 + daysAvailable: [tue, wed, thu, sat, sun] + results: + - { date: "2026-09-27", distanceKm: 10, timeSec: 2580 } +goal: + name: "Half" + date: "2027-03-28" + distanceKm: 21.0975 + priority: A +` + +let dir: string +beforeEach(() => { + dir = mkdtempSync(join(tmpdir(), 'trainctl-061-')) + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG, 'utf-8') + process.env['TRAINCTL_TODAY'] = '2026-10-22' + cmdPlan(dir) +}) +afterEach(() => { + delete process.env['TRAINCTL_TODAY'] + setLocale('en') + rmSync(dir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 }) +}) + +describe.each(['pl', 'en'] as const)('pakiet A · %s', (lang) => { + beforeEach(() => setLocale(lang)) + + it('A1: tabela wykonania w review ma kolumny planu, wykonania i statusu', async () => { + process.env['TRAINCTL_TODAY'] = '2026-10-29' + cmdLog(dir, { date: '2026-10-27', status: 'done', km: '8' }) + const out = (await cmdReview(dir, {})).output + expect(out).toContain(lang === 'pl' ? 'Plan | Wykonanie | Status' : 'Plan | Actual | Status') + expect(out).not.toMatch(/Przed zmianą|Before the change/) + }) + + it('A2: „do startu" nie powtarza etykiety', async () => { + process.env['TRAINCTL_TODAY'] = '2026-10-29' + const out = (await cmdReview(dir, {})).output + expect(out).not.toMatch(/do startu: do startu|To race day: \d+ days to race/i) + expect(out).toMatch(lang === 'pl' ? /Do startu: 150 dni/ : /To race day: 150 days/) + }) + + it('A3: liczby dziesiętne w formacie języka', () => { + const plan = cmdPlan(dir).output + const why = cmdWhy(dir, { date: '2026-10-27' }).output + if (lang === 'pl') { + for (const out of [plan, why]) expect(out.replace(/https?:\/\/\S+/g, '')).not.toMatch(/\d\.\d/) + expect(plan).toContain('21,1 km') + expect(plan).toContain('47,7') + } else { + expect(plan).toContain('21.1 km') + expect(plan).not.toContain('21.0975') + } + }) + + it('A4: faza jednotygodniowa bez zakresu', () => { + const out = cmdPlan(dir).output + expect(out).not.toMatch(/(\d+)–\1\b/) + expect(out).toMatch(lang === 'pl' ? /taper: tyg\. 22\b/ : /taper: week 22\b/) + }) + + it('A5: status dziennika słowem z katalogu, surowy enum w danych', () => { + process.env['TRAINCTL_TODAY'] = '2026-10-27' + cmdLog(dir, { date: '2026-10-27', status: 'done' }) + const word = lang === 'pl' ? 'wykonany' : 'done' + expect(cmdWeek(dir).output).toContain(`[${word}]`) + expect(cmdStatus(dir).output).toContain(`(${word})`) + const today = cmdToday(dir) + expect(today.output).toContain(word) + expect(today.data).toMatchObject({ log: { status: 'done' } }) + if (lang === 'pl') expect(cmdWeek(dir).output).not.toContain('[done]') + }) + + it('A7: wiek wyniku w why liczony od dziś, data kalibracji osobno', () => { + process.env['TRAINCTL_TODAY'] = '2026-10-29' + const out = cmdWhy(dir, { date: '2026-10-27' }).output + expect(out).toMatch(lang === 'pl' ? /sprzed 32 dni/ : /32 days/) + expect(out).toContain('2026-10-22') + }) + + it('A8: tydzień z celem równym sumie pokazuje jedną liczbę', () => { + process.env['TRAINCTL_TODAY'] = '2026-10-27' + const out = cmdWeek(dir).output + expect(out).not.toMatch(/zaplanowano|planned/) + expect(out).toContain('52 km') + }) +}) + +describe('A6: zawijanie nie tnie adresów ani ścieżek', () => { + const url = 'https://github.com/dithiothreitol/trainctl/blob/v0.6.0/docs/science/FOUNDATIONS.md' + it.each([40, 60, 80])('szerokość %i', (width) => { + const lines = wrapText(`źródła i parametry: ${url} §10`, width) + expect(lines.some((line) => line.trim() === url)).toBe(true) + }) + it('ścieżka Windows zostaje w całości', () => { + const path = 'C:\\Users\\someone\\AppData\\Local\\Temp\\very\\long\\training\\directory' + expect(wrapText(path, 40)).toEqual([path]) + }) + it('zwykłe długie słowo nadal dzielone', () => { + expect(wrap('x'.repeat(50), 20).every((line) => line.length <= 20)).toBe(true) + }) +}) + +describe('B9: stałe silnika bez źródła mają regułę E-3', () => { + it.each(['pl', 'en'] as const)('rules E-3 · %s', (lang) => { + setLocale(lang) + expect(cmdRules({ id: 'E-3' }).output).toContain('18 km') + expect(cmdRules({}).output).toContain('E-3') + expect(ruleEvidence('E-3')).toBe('engineering') + }) +}) + +describe('poprawki po przeglądzie etapu 1', () => { + it('today pokazuje zalogowane km w formacie języka; 0 km to brak dystansu, echo log je pokazuje', () => { + setLocale('pl') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + cmdLog(dir, { date: '2026-10-27', status: 'modified', km: '8.5' }) + expect(cmdToday(dir).output).toContain('8,5 km') + expect(cmdLog(dir, { date: '2026-10-27', status: 'modified', km: '0' }).output).toContain('0 km') + expect(cmdToday(dir).output).not.toContain('0 km') + cmdLog(dir, { date: '2026-10-27', status: 'skipped', km: '0' }) + expect(cmdToday(dir).output).not.toContain('0 km') + }) + + it('komórka tabeli z długą ścieżką trzyma szerokość kolumny', () => { + const theme = new Theme({ color: false, unicode: true, width: 40 }) + const out = renderAnsi([{ t: 'table', head: ['a', 'b'], rows: [['x', 'https://github.com/dithiothreitol/trainctl/blob/v0.6.0/docs/science/FOUNDATIONS.md']] }], theme) + for (const line of out.split('\n')) expect(visibleLength(line)).toBeLessThanOrEqual(40) + }) + + it('kv z adresem dłuższym niż kolumna wartości przechodzi w układ piętrowy, adres w całości', () => { + const url = 'https://github.com/dithiothreitol/trainctl/blob/v0.6.0/docs/science/FOUNDATIONS.md' + const out = renderAnsi([{ t: 'kv', pairs: [['Source', url]] }], new Theme({ color: false, unicode: true, width: 60 })) + expect(out.split('\n').some((line) => line.trim() === url)).toBe(true) + }) + + it('kod CLI nie wstawia surowych kilometrów (format języka przez kmLabel albo n())', () => { + const files = readdirSync(import.meta.dirname, { recursive: true, encoding: 'utf-8' }) + .filter((f) => f.endsWith('.ts') && !f.endsWith('.test.ts')) + for (const f of files) { + const src = readFileSync(join(import.meta.dirname, f), 'utf-8') + // każda wartość przed „ km" przechodzi przez n(), kmLabel() albo formatNumber(); + // wyjątki: sam kmLabel i historia zmian w plan.yaml (dane, nie widok) + const raw = src.split('\n').filter((line) => /\$\{(?!n2?\(|kmLabel\(|formatNumber\()[^}]*\} km/.test(line)) + .filter((line) => !line.includes('String(km)} km') && !line.includes('${from} → ${to} km')) + expect(raw, f).toEqual([]) + expect(src, f).not.toContain('String(w.totalKm)') + } + }) + + it('podtytuł tygodnia: bez planowanej sumy jedna liczba', () => { + setLocale('en') + expect(cmdWeek(dir).output).toMatch(/\(pyramidal\) · \d+ km/) + }) +}) + +describe('poprawki po drugiej rundzie przeglądu etapu 1', () => { + it('review po starcie mówi „po starcie", nie „temu"', async () => { + process.env['TRAINCTL_TODAY'] = '2027-04-02' + setLocale('pl') + expect((await cmdReview(dir, {})).output).toContain('Od startu: 5 dni') + setLocale('en') + const out = (await cmdReview(dir, {})).output + expect(out).toContain('Since the race: 5 days') + expect(out).not.toContain('To race day') + }) + + it('siła w dzienniku po polsku w rodzaju żeńskim', () => { + setLocale('pl') + process.env['TRAINCTL_TODAY'] = '2026-10-28' + const saved = cmdLog(dir, { date: '2026-10-28', strength: 'done' }).output + expect(saved).toContain('wykonana') + expect(cmdToday(dir).output).toContain('Siła zalogowana: wykonana') + }) + + it('nieznany status w log.jsonl pokazany bez zmian, nie „undefined"', () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + appendFileSync(join(dir, 'log.jsonl'), JSON.stringify({ date: '2026-10-27', status: 'partial', loggedAt: '2026-10-27T10:00:00Z' }) + '\n') + for (const out of [cmdWeek(dir).output, cmdToday(dir).output, cmdStatus(dir).output]) { + expect(out).toContain('partial') + expect(out).not.toContain('undefined') + } + }) +}) + +describe('poprawki po trzeciej rundzie przeglądu etapu 1', () => { + it('why w dniu startu: dystans segmentu w formacie języka', () => { + setLocale('pl') + const out = cmdWhy(dir, { date: '2027-03-28' }).output + expect(out).toContain('21,1 km') + expect(out).not.toContain('21.0975') + }) + + it('PLAN.md: objętość tygodnia w formacie języka', () => { + setLocale('pl') + cmdPlan(dir, { fresh: true }) + const md = readFileSync(join(dir, 'plan', 'PLAN.md'), 'utf-8') + expect(md).not.toMatch(/\d\.\d+ km/) + }) + + it('today nie pada na km spoza liczb w ręcznie edytowanym log.jsonl', () => { + process.env['TRAINCTL_TODAY'] = '2026-10-27' + appendFileSync(join(dir, 'log.jsonl'), JSON.stringify({ date: '2026-10-27', status: 'done', km: null, loggedAt: '2026-10-27T10:00:00Z' }) + '\n') + const today = cmdToday(dir) + expect(today.code).toBe(0) + expect(today.output).not.toContain('null') + }) + + it('status równy kluczowi Object.prototype nie zwraca funkcji', () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + appendFileSync(join(dir, 'log.jsonl'), JSON.stringify({ date: '2026-10-27', status: 'constructor', loggedAt: '2026-10-27T10:00:00Z' }) + '\n') + const out = cmdWeek(dir).output + expect(out).toContain('[constructor]') + expect(out).not.toContain('native code') + }) + + it('macierz profili nie trafia do paczki npm', () => { + const pkg = JSON.parse(readFileSync(join(import.meta.dirname, '..', 'package.json'), 'utf-8')) as { files: string[] } + const build = JSON.parse(readFileSync(join(import.meta.dirname, '..', 'tsconfig.build.json'), 'utf-8')) as { exclude: string[] } + expect(pkg.files).toContain('!src/**/*.fixture.ts') + expect(build.exclude).toContain('src/**/*.fixture.ts') + }) +}) + +describe('poprawki po czwartej rundzie przeglądu etapu 1', () => { + it('wybór dnia w interaktywnym log: status i dystans w języku', () => { + setLocale('pl') + const choices = logChoices(loadPlan(dir), '2027-03-29', new Map([['2027-03-28', { status: 'done' }]])) + const race = choices.find((c) => c.value === '2027-03-28')! + expect(race.hint).toContain('21,1 km') + expect(race.hint).toContain('wykonany') + expect(race.hint).not.toContain('done') + }) + + it('review dzień przed startem: „1 day"', async () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2027-03-27' + expect((await cmdReview(dir, {})).output).toContain('To race day: 1 day\n') + }) + + it('review nie pada na km zapisane tekstem w log.jsonl', async () => { + process.env['TRAINCTL_TODAY'] = '2026-10-29' + appendFileSync(join(dir, 'log.jsonl'), JSON.stringify({ date: '2026-10-27', status: 'done', km: '8', loggedAt: '2026-10-27T10:00:00Z' }) + '\n') + const out = await cmdReview(dir, {}) + expect(out.code).toBe(0) + expect(out.output).toContain('8 km') + }) + + it('historia skrócenia w plan.yaml nie zależy od języka CLI', () => { + setLocale('pl') + expect(shortenDetail('2026-10-27', 10.25, 8, 40, 'shortened')).toBe('2026-10-27: 10.25 → 8 km; 40 min; shortened') + }) +}) + +describe('poprawki po piątej rundzie przeglądu etapu 1', () => { + it('desk w dniu startu pokazuje dystans startu, nie 0 km', () => { + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG + 'desk:\n workStart: "09:00"\n workEnd: "17:30"\n lunchMinutes: 45\n prefer: evening\n', 'utf-8') + setLocale('pl') + process.env['TRAINCTL_TODAY'] = '2027-03-28' + const out = cmdDesk(dir, { date: '2027-03-28' }).output + expect(out).toContain('21,1 km') + expect(out).not.toMatch(/· 0 km/) + }) + + it('ostrzeżenie o celu tygodnia formatuje kilometry', () => { + expect(improvePl.targetMismatch('2026-10-26', 52.3, 50.8)).toContain('52,3 km') + expect(improveEn.targetMismatch('2026-10-26', 52.3, 50.8)).toContain('50.8 km') + }) + + it('log.jsonl: liczby tekstem zamienione, wartości spoza liczb pominięte przy odczycie', () => { + appendFileSync(join(dir, 'log.jsonl'), [ + JSON.stringify({ date: '2026-10-27', status: 'done', km: '8', rpe: '6', loggedAt: 'x' }), + JSON.stringify({ date: '2026-10-28', status: 'done', km: null, timeSec: 'abc', loggedAt: 'x' }), + ].join('\n') + '\n') + const [a, b] = readLog(dir) + expect(a).toMatchObject({ km: 8, rpe: 6 }) + expect(b).not.toHaveProperty('km') + expect(b).not.toHaveProperty('timeSec') + }) + + it('pomoc w dwóch kolumnach trzyma szerokość także z adresem w opisie', () => { + const theme = new Theme({ color: false, unicode: true, width: 60 }) + const out = helpItem('rules', 10, 'see https://github.com/dithiothreitol/trainctl/blob/v0.6.0/docs/science/FOUNDATIONS.md', theme) + for (const line of out.split('\n')) expect(visibleLength(line)).toBeLessThanOrEqual(60) + }) +}) + + +describe('poprawki po siódmej rundzie przeglądu etapu 1', () => { + it('log.jsonl: dystans z przecinkiem odczytany jako liczba', () => { + appendFileSync(join(dir, 'log.jsonl'), JSON.stringify({ date: '2026-10-27', status: 'done', km: '8,5', loggedAt: 'x' }) + '\n') + expect(readLog(dir)[0]).toMatchObject({ km: 8.5 }) + }) + + it('opuszczona sesja nie zapisuje 0 km', () => { + process.env['TRAINCTL_TODAY'] = '2026-10-27' + cmdLog(dir, { date: '2026-10-27', status: 'skipped', km: '0' }) + const raw = readFileSync(join(dir, 'log.jsonl'), 'utf-8') + expect(raw).not.toContain('"km"') + }) +}) + +describe('poprawki po ósmej rundzie przeglądu etapu 1', () => { + + it('wpis dziennika bez statusu nie pokazuje „undefined"', () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + appendFileSync(join(dir, 'log.jsonl'), JSON.stringify({ date: '2026-10-27', km: 8, loggedAt: 'x' }) + '\n') + for (const out of [cmdWeek(dir).output, cmdToday(dir).output, cmdStatus(dir).output]) expect(out).not.toContain('undefined') + }) + + it('shownKm: start pokazuje dystans startu', () => { + expect(shownKm({ distanceKm: 0, raceDistanceKm: 21.0975 })).toBe(21.0975) + expect(shownKm({ distanceKm: 8 })).toBe(8) + }) +}) + +describe('poprawki po dziewiątej rundzie przeglądu etapu 1', () => { + it('dopisanie do log.jsonl bez końcowej nowej linii nie skleja wpisów', () => { + writeFileSync(join(dir, 'log.jsonl'), JSON.stringify({ date: '2026-10-26', status: 'done', loggedAt: 'x' }), 'utf-8') + appendLog(dir, { date: '2026-10-27', status: 'done', loggedAt: 'y' }) + expect(readLog(dir).map((e) => e.date)).toEqual(['2026-10-26', '2026-10-27']) + }) + + it('log.jsonl: wartości, których CLI nie przyjmuje, pominięte przy odczycie', () => { + appendFileSync(join(dir, 'log.jsonl'), [ + JSON.stringify({ date: '2026-10-27', status: 'done', rpe: 15, km: -5, loggedAt: 'x' }), + JSON.stringify({ date: '2026-10-28', status: 'done', rpe: 7.5, km: '0x10', timeSec: '1e3', loggedAt: 'x' }), + ].join('\n') + '\n') + for (const e of readLog(dir)) { + expect(e).not.toHaveProperty('rpe') + expect(e).not.toHaveProperty('km') + expect(e).not.toHaveProperty('timeSec') + } + }) + + it('E-3 wymienia wszystkie oznaczone stałe', () => { + setLocale('en') + const out = cmdRules({ id: 'E-3' }).output + for (const value of ['+40%', '+15%', '5–8 km', '3 km', '35%']) expect(out).toContain(value) + }) +}) + +describe('poprawki po dziesiątej rundzie przeglądu etapu 1', () => { + + it('log.jsonl: minuty siły w granicach `log --strength` (całkowite 1–300)', () => { + appendFileSync(join(dir, 'log.jsonl'), [ + JSON.stringify({ date: '2026-10-27', activity: 'strength', status: 'done', minutes: '0,5', loggedAt: 'x' }), + JSON.stringify({ date: '2026-10-28', activity: 'strength', status: 'done', minutes: 5000, loggedAt: 'x' }), + JSON.stringify({ date: '2026-10-29', activity: 'strength', status: 'done', minutes: '45', loggedAt: 'x' }), + ].join('\n') + '\n') + expect(readStrengthLog(dir).map((e) => e.minutes)).toEqual([undefined, undefined, 45]) + }) +}) + +describe('why: kalibracja stref — decyzje z dnia kalibracji i podpowiedź na dziś', () => { + const RESULT = ' - { date: "2026-09-27", distanceKm: 10, timeSec: 2580 }' + /** Plan wygenerowany 2026-10-22 z podanymi wynikami (i opcjonalnie innym celem). */ + const planWith = (results: string, goalExtra = '') => { + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG.replace(RESULT, results).replace(' priority: A\n', ` priority: A\n${goalExtra}`), 'utf-8') + cmdPlan(dir, { fresh: true }) + setLocale('en') + } + const profile = (results: string) => writeFileSync(join(dir, 'trainctl.yaml'), CONFIG.replace(RESULT, results), 'utf-8') + const whyOn = (today: string, date: string) => { + process.env['TRAINCTL_TODAY'] = today + return cmdWhy(dir, { date }) + } + + it('opis wyniku to decyzja z dnia kalibracji, wiek liczony od dziś, bez ujemnego wieku', () => { + planWith(`${RESULT}\n - { date: "2026-10-25", distanceKm: 5, timeSec: 1200 }`) + const why = whyOn('2026-10-29', '2026-10-27') + expect(why.output).toMatch(/2026-10-25 · 5 km · VDOT [\d.]+ · After the calibration date · 4 days old/) + expect(why.output).toMatch(/2026-09-27 · 10 km · VDOT [\d.]+ · Used for zones · 32 days old/) + expect(why.output).not.toMatch(/-\d+ days/) + // lepszy wynik po dniu kalibracji: dziś plan skalibrowałby strefy z niego + expect(why.output).toContain('would calibrate the zones from the 2026-10-25 result (5 km)') + expect(why.data).toMatchObject({ recalibration: { changed: true, selected: { date: '2026-10-25' } } }) + }) + + it('wynik użyty do stref, dziś starszy niż 540 dni, bez następcy: podpowiedź o świeżym wyniku', () => { + planWith(' - { date: "2025-06-09", distanceKm: 10, timeSec: 2580 }') + const why = whyOn('2026-12-21', '2026-12-22') + expect(why.output).toMatch(/2025-06-09 · 10 km · VDOT [\d.]+ · Used for zones · 560 days old/) + expect(why.output).toContain('No result meets the policy today') + expect(why.data).toMatchObject({ recalibration: { changed: true, selected: null } }) + }) + + it('świeży wynik dopisany do trainctl.yaml bez regeneracji: podpowiedź z jego datą', () => { + planWith(' - { date: "2025-06-09", distanceKm: 10, timeSec: 2580 }') + profile(' - { date: "2025-06-09", distanceKm: 10, timeSec: 2580 }\n - { date: "2026-12-01", distanceKm: 10, timeSec: 2600 }') + const why = whyOn('2026-12-21', '2026-12-22') + expect(why.output).toContain('would calibrate the zones from the 2026-12-01 result') + expect(why.output).not.toContain('No result meets the policy today') + }) + + it('wynik wykluczony w trainctl.yaml: decyzja zostaje, podpowiedź mówi o zmianie', () => { + planWith(RESULT) + profile(' - { date: "2026-09-27", distanceKm: 10, timeSec: 2580, excluded: true, exclusionReason: "injury" }') + const why = whyOn('2026-10-29', '2026-10-27') + expect(why.output).toMatch(/2026-09-27 · 10 km · VDOT [\d.]+ · Used for zones/) + expect(why.output).toContain('No result meets the policy today') + }) + + it('nowa nazwa wyniku w trainctl.yaml to ten sam wynik: bez podpowiedzi', () => { + planWith(RESULT) + profile(' - { date: "2026-09-27", distanceKm: 10, timeSec: 2580, name: "Parkrun" }') + expect(whyOn('2026-10-29', '2026-10-27').data).toMatchObject({ recalibration: { changed: false } }) + }) + + it('trail przy wyniku szosowym (Z-10): wybór się nie zmienia, bez podpowiedzi', () => { + planWith(`${RESULT}\n - { date: "2026-10-25", distanceKm: 21.1, timeSec: 7200, terrain: trail }`) + const why = whyOn('2026-10-29', '2026-10-27') + expect(why.output).toMatch(/2026-10-25 · 21\.1 km · VDOT [\d.]+ · After the calibration date/) + expect(why.output).not.toContain('would calibrate') + expect(why.data).toMatchObject({ recalibration: { changed: false } }) + }) + + it('cel trailowy: wynik z trailu, który ustawił strefy, jest „użyty"', () => { + planWith(' - { date: "2026-09-27", distanceKm: 10, timeSec: 2700 }\n - { date: "2026-09-20", distanceKm: 21.1, timeSec: 5400, terrain: trail }', ' terrain: trail\n') + const why = whyOn('2026-10-29', '2026-10-27') + expect(why.output).toMatch(/2026-09-20 · 21\.1 km · VDOT [\d.]+ · Used for zones/) + expect(why.output).not.toContain('would calibrate') + }) + + it('przeterminowany wynik szosowy: trail, który ustawił strefy, jest „użyty", szosa „starsza niż 540 dni"', () => { + planWith(' - { date: "2025-01-10", distanceKm: 10, timeSec: 2580 }\n - { date: "2026-09-20", distanceKm: 21.1, timeSec: 6000, terrain: trail }') + const why = whyOn('2026-10-29', '2026-10-27') + expect(why.output).toMatch(/2026-09-20 · 21\.1 km · VDOT [\d.]+ · Used for zones/) + expect(why.output).toMatch(/2025-01-10 · 10 km · VDOT [\d.]+ · Older than 540 days on the calibration date/) + expect(why.output).not.toContain('Trail result') + }) + + it('bez czytelnego trainctl.yaml why działa, bez podpowiedzi', () => { + writeFileSync(join(dir, 'trainctl.yaml'), 'athlete: [', 'utf-8') + const why = whyOn('2026-10-29', '2026-10-27') + expect(why.code).toBe(0) + expect(why.data).toMatchObject({ recalibration: null }) + expect(why.output).toContain('trainctl.yaml cannot be read') + }) + + it('recalibrationToday: ten sam wynik, inny wynik, brak wyniku, zmiana czasu docelowego', () => { + const a = { date: '2026-09-27', distanceKm: 10, timeSec: 2580 } + const b = { date: '2026-10-25', distanceKm: 5, timeSec: 1200 } + const goal = { kind: 'race', distanceKm: 21.0975 } + const calibration = { evaluatedAt: '2026-10-22', policy: 'best-vdot-540-days' as const, results: [a], selected: a, candidates: [] } + const fromResult = { calibration, vdot: Math.round(vdotFromRace(10, 2580) * 10) / 10, vdotSource: 'result' } + expect(recalibrationToday(fromResult, [a], '2026-10-29', goal)).toEqual({ selected: a, source: 'result', changed: false }) + expect(recalibrationToday(fromResult, [a, b], '2026-10-29', goal)).toMatchObject({ selected: b, changed: true }) + expect(recalibrationToday(fromResult, [{ ...a, excluded: true }], '2026-10-29', goal)).toEqual({ selected: null, source: 'none', changed: true }) + // plan z czasu docelowego: bez wyniku nic się nie zmienia, póki ten sam czas; inny czas albo brak — zmiana + const { selected: _, ...noResult } = calibration + const fromGoal = { calibration: noResult, vdot: Math.round(vdotFromRace(21.0975, 5700) * 10) / 10, vdotSource: 'goal-target' } + expect(recalibrationToday(fromGoal, [], '2026-10-29', { ...goal, targetTimeSec: 5700 })).toMatchObject({ source: 'goal-target', changed: false }) + expect(recalibrationToday(fromGoal, [], '2026-10-29', { ...goal, targetTimeSec: 5400 })).toMatchObject({ source: 'goal-target', changed: true }) + expect(recalibrationToday(fromGoal, [], '2026-10-29', goal)).toMatchObject({ source: 'none', changed: true }) + }) +}) + +describe('liczby wpisywane przez człowieka', () => { + it('log --km przyjmuje przecinek, jak polskie wyjście', () => { + process.env['TRAINCTL_TODAY'] = '2026-10-27' + expect(cmdLog(dir, { date: '2026-10-27', status: 'done', km: '8,5' }).code).toBe(0) + expect(readLog(dir).at(-1)).toMatchObject({ km: 8.5 }) + }) + + it('parseDecimal: zwykły zapis dziesiętny, nic więcej', () => { + expect(parseDecimal('8,5')).toBe(8.5) + expect(parseDecimal(' 8.25 ')).toBe(8.25) + for (const bad of ['0x10', '1e3', '-5', '', 'osiem']) expect(parseDecimal(bad)).toBeNaN() + }) + + it('zapis w log i today pokazują dystans tak, jak go wpisano', () => { + setLocale('pl') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + expect(cmdLog(dir, { date: '2026-10-27', status: 'done', km: '8.25' }).output).toContain('8,25 km') + expect(cmdToday(dir).output).toContain('8,25 km') + }) + + it('granice dziennika jedne dla log i odczytu log.jsonl', () => { + expect(LOG_LIMITS.rpe(10)).toBe(true) + expect(LOG_LIMITS.rpe(11)).toBe(false) + expect(LOG_LIMITS.minutes(300)).toBe(true) + expect(LOG_LIMITS.minutes(301)).toBe(false) + process.env['TRAINCTL_TODAY'] = '2026-10-27' + expect(cmdLog(dir, { date: '2026-10-27', strength: 'done', minutes: 301 }).code).not.toBe(0) + expect(cmdLog(dir, { date: '2026-10-27', status: 'done', km: '-5' }).code).not.toBe(0) + }) + + it('log.jsonl: czas „58:30" wpisany ręcznie zostaje odczytany', () => { + appendFileSync(join(dir, 'log.jsonl'), JSON.stringify({ date: '2026-10-27', status: 'done', timeSec: '58:30', loggedAt: 'x' }) + '\n') + expect(readLog(dir)[0]).toMatchObject({ timeSec: 3510 }) + }) +}) + +describe('dziennik: jedna reguła liczb i wpisów', () => { + it('RPE i minuty siły przez ten sam parser co km: przecinek tak, zapis szesnastkowy i wykładniczy nie', () => { + process.env['TRAINCTL_TODAY'] = '2026-10-27' + expect(cmdLog(dir, { date: '2026-10-27', status: 'done', rpe: '0xA' }).code).not.toBe(0) + expect(cmdLog(dir, { date: '2026-10-27', status: 'done', rpe: '7,0' }).code).toBe(0) + expect(readLog(dir).at(-1)).toMatchObject({ rpe: 7 }) + expect(cmdLog(dir, { date: '2026-10-28', strength: 'done', minutes: '1e2' }).code).not.toBe(0) + expect(cmdLog(dir, { date: '2026-10-28', strength: 'done', minutes: '45' }).code).toBe(0) + }) + + it('parseDecimal przyjmuje „.5", „5." i „,5"', () => { + expect(parseDecimal('.5')).toBe(0.5) + expect(parseDecimal('5.')).toBe(5) + expect(parseDecimal(',5')).toBe(0.5) + expect(parseDecimal('.')).toBeNaN() + }) + + it('kreator dziennika podpowiada dystans w formacie języka z pełną dokładnością', () => { + const race = loadPlan(dir).weeks.flatMap((w) => w.days).find((d) => d.date === '2027-03-28')! + setLocale('pl') + expect(plannedKmDefault(race)).toBe('21,0975') + expect(parseDecimal(plannedKmDefault(race)!)).toBe(21.0975) + setLocale('en') + expect(plannedKmDefault(race)).toBe('21.0975') + const rest = loadPlan(dir).weeks[0]!.days.find((d) => !d.workout)! + expect(plannedKmDefault(rest)).toBeUndefined() + }) + + it('latestByDate: późniejszy wpis daty wygrywa', () => { + const map = latestByDate([{ date: 'a', n: 1 }, { date: 'b', n: 2 }, { date: 'a', n: 3 }]) + expect(map.get('a')).toMatchObject({ n: 3 }) + expect(map.size).toBe(2) + }) + + it('lineSeparator: nowa linia tylko po niepustym tekście bez końcowego znaku nowej linii', () => { + expect(lineSeparator('')).toBe('') + expect(lineSeparator('{}\n')).toBe('') + expect(lineSeparator('{}')).toBe('\n') + }) + + it('PLAN.md cytuje historię zmian tak, jak zapisano ją w plan.yaml', () => { + setLocale('pl') + const plan = loadPlan(dir) + plan.changes.push({ at: '2026-10-27', action: 'shorten', detail: '2026-10-27: 8.5 → 6 km; 40 min; shortened' }) + writePlan(dir, plan) + expect(readFileSync(join(dir, 'plan', 'PLAN.md'), 'utf-8')).toContain('2026-10-27: 8.5 → 6 km; 40 min; shortened') + }) +}) + +describe('regeneracja zapisuje zmianę wyniku, z którego liczone są strefy', () => { + it('nowy wynik z tym samym VDOT: podpowiedź w why znika po trainctl plan', () => { + const r1 = ' - { date: "2026-09-27", distanceKm: 10, timeSec: 2580 }' + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG.replace(r1, `${r1}\n - { date: "2026-10-10", distanceKm: 10, timeSec: 2580 }`), 'utf-8') + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-29' + expect(cmdWhy(dir, { date: '2026-10-27' }).output).toContain('would calibrate the zones from the 2026-10-10 result') + expect(cmdPlan(dir).data).toMatchObject({ regeneration: { upToDate: false } }) + const why = cmdWhy(dir, { date: '2026-10-27' }) + expect(why.output).not.toContain('would calibrate') + expect(why.data).toMatchObject({ recalibration: { changed: false } }) + // ten sam profil drugi raz: nic do zapisania + expect(cmdPlan(dir).data).toMatchObject({ regeneration: { upToDate: true } }) + }) + + it('echo zapisu pokazuje dystans z podpowiedzi kreatora bez zaokrąglenia', () => { + setLocale('pl') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + expect(cmdLog(dir, { date: '2026-10-27', status: 'modified', km: '21,0975' }).output).toContain('21,0975 km') + }) + + it('adres w nawiasie zostaje w całości', () => { + const url = 'https://github.com/dithiothreitol/trainctl/blob/v0.6.0/docs/science/FOUNDATIONS.md' + expect(wrapText(`pliki aktywności (${url})`, 40).some((line) => line.trim() === `(${url})`)).toBe(true) + }) +}) + +describe('regeneracja i teren wyniku (Z-10)', () => { + it('zmiana terenu jedynego wyniku zapisuje plan i zdejmuje ostrzeżenie o kalibracji z trailu', () => { + const road = ' - { date: "2026-09-27", distanceKm: 10, timeSec: 2580 }' + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG.replace(road, ' - { date: "2026-09-27", distanceKm: 10, timeSec: 2580, terrain: trail }'), 'utf-8') + setLocale('en') + cmdPlan(dir, { fresh: true }) + expect(loadPlan(dir).feasibilityWarnings.join(' ')).toContain('trail result') + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG, 'utf-8') + expect(cmdPlan(dir).data).toMatchObject({ regeneration: { upToDate: false } }) + expect(loadPlan(dir).feasibilityWarnings.join(' ')).not.toContain('trail result') + }) +}) + +describe('piętnasta runda: zawijanie, komunikat bez wyniku, teren w podpowiedzi', () => { + it('wrap domyślnie trzyma szerokość także dla adresu; wrapText zostawia go w całości', () => { + const url = 'https://github.com/dithiothreitol/trainctl/blob/v0.6.0/docs/science/FOUNDATIONS.md' + expect(wrap(url, 30).every((line) => line.length <= 30)).toBe(true) + expect(wrapText(url, 30)).toEqual([url]) + }) + + it('bez wyniku z czasem docelowym: podpowiedź mówi o kalibracji z czasu docelowego', () => { + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG.replace(' priority: A\n', ' priority: A\n targetTimeSec: 5700\n'), 'utf-8') + cmdPlan(dir, { fresh: true }) + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG.replace(/ results:\n.*\n/, ' results: []\n').replace(' priority: A\n', ' priority: A\n targetTimeSec: 5700\n'), 'utf-8') + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-29' + expect(cmdWhy(dir, { date: '2026-10-27' }).output).toContain('would calibrate the zones from the goal time 1:35:00') + }) + + it('zmiana terenu wybranego wyniku: why podpowiada trainctl plan, jak regeneracja', () => { + const road = ' - { date: "2026-09-27", distanceKm: 10, timeSec: 2580 }' + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG.replace(road, ' - { date: "2026-09-27", distanceKm: 10, timeSec: 2580, terrain: trail }'), 'utf-8') + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-29' + expect(cmdWhy(dir, { date: '2026-10-27' }).data).toMatchObject({ recalibration: { changed: true } }) + expect(cmdPlan(dir).data).toMatchObject({ regeneration: { upToDate: false } }) + expect(cmdWhy(dir, { date: '2026-10-27' }).data).toMatchObject({ recalibration: { changed: false } }) + }) +}) + +describe('szesnasta runda: źródło stref, siła „zmieniona", kreator init', () => { + it('zoneSource: wynik, czas docelowy przy celu ze startem, inaczej brak', () => { + const r = { date: '2026-09-27', distanceKm: 10, timeSec: 2580 } + expect(zoneSource(r, { kind: 'race' })).toBe('result') + expect(zoneSource(undefined, { kind: 'race', targetTimeSec: 5700 })).toBe('goal-target') + expect(zoneSource(undefined, { kind: 'base', targetTimeSec: 5700 })).toBe('none') + expect(zoneSource(undefined, { kind: 'race' })).toBe('none') + }) + + it('siła „zmieniona" po polsku słowem z katalogu', () => { + setLocale('pl') + expect(logStatusText('modified', true)).toBe('zmieniona') + setLocale('en') + expect(logStatusText('modified', true)).toBe('modified') + }) + + it('kreator init czyta dystans tym samym parserem: przecinek tak, „0x10" nie', () => { + expect(parseDistanceInput('21,1')).toBe(21.1) + expect(() => parseDistanceInput('0x10')).toThrow() + expect(() => parseDistanceInput('1e2')).toThrow() + }) +}) + +describe('siedemnasta runda: dni do startu, zbiór wyników, granice dziennika', () => { + it('today po angielsku: „1 day to race"', () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2027-03-27' + expect(cmdToday(dir).output).toContain('1 day to race') + }) + + it('nowy, słabszy wynik w trainctl.yaml: plan zapisany, why pokazuje go na liście', () => { + const r1 = ' - { date: "2026-09-27", distanceKm: 10, timeSec: 2580 }' + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG.replace(r1, `${r1}\n - { date: "2026-10-15", distanceKm: 5, timeSec: 1500 }`), 'utf-8') + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-29' + expect(cmdPlan(dir).data).toMatchObject({ regeneration: { upToDate: false } }) + expect(cmdWhy(dir, { date: '2026-10-29' }).output).toMatch(/2026-10-15 · 5 km · VDOT [\d.]+ · Lower VDOT/) + expect(cmdPlan(dir).data).toMatchObject({ regeneration: { upToDate: true } }) + }) + + it('log: dystans ponad 500 km odrzucony, zapis z dokładnością 0,1 m', () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + expect(cmdLog(dir, { date: '2026-10-27', status: 'done', km: '8500' }).code).not.toBe(0) + const saved = cmdLog(dir, { date: '2026-10-27', status: 'done', km: '8.123456' }) + expect(readLog(dir).at(-1)).toMatchObject({ km: 8.1235 }) + expect(saved.output).toContain('8.1235 km') + }) +}) + +describe('osiemnasta runda: kreator, pominięte wartości dziennika', () => { + it('kreator przekazuje tekst, który przyjął (bez zapisu wykładniczego)', () => { + expect(parseKmText('0.0000001')).toBe('0.0000001') + expect(parseKmText(' 8,5 ')).toBe('8,5') + expect(parseRpeText('7')).toBe('7') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + // tak mała wartość znikłaby przy zapisie z dokładnością 0,1 m — błąd z własnym komunikatem, nie cichy zapis 0 km + setLocale('en') + const tiny = cmdLog(dir, { date: '2026-10-27', status: 'done', km: parseKmText('0.0000001') }) + expect(tiny.code).not.toBe(0) + expect(tiny.output).toContain('below 0.1 m cannot be recorded') + }) + + it('status mówi o wartościach dziennika pominiętych przy odczycie', () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + appendFileSync(join(dir, 'log.jsonl'), JSON.stringify({ date: '2026-10-27', status: 'done', km: '8500', loggedAt: 'x' }) + '\n') + const out = cmdStatus(dir).output + expect(out).toContain('values outside the limits of trainctl log were ignored (2026-10-27 km)') + }) +}) + +describe('dziewiętnasta runda: VDOT stref z jednej funkcji', () => { + it('zoneCalibration: wynik, czas docelowy, brak; roundVdot jak w planie', () => { + const r = { date: '2026-09-27', distanceKm: 10, timeSec: 2580 } + expect(zoneCalibration(r, { kind: 'race', distanceKm: 21.0975 })).toEqual({ source: 'result', vdot: vdotFromRace(10, 2580) }) + expect(zoneCalibration(undefined, { kind: 'race', distanceKm: 21.0975, targetTimeSec: 5700 })).toEqual({ source: 'goal-target', vdot: vdotFromRace(21.0975, 5700) }) + expect(zoneCalibration(undefined, { kind: 'race', distanceKm: 21.0975 })).toEqual({ source: 'none' }) + expect(roundVdot(47.66)).toBe(47.7) + expect(loadPlan(dir).vdot).toBe(roundVdot(vdotFromRace(10, 2580))) + }) +}) + +describe('dwudziesta runda: wybór, uszkodzone wiersze dziennika, przecinek', () => { + it('lista wyboru trzyma szerokość terminala także z adresem we wskazówce', () => { + const theme = new Theme({ color: false, unicode: true, width: 40 }) + const url = 'https://github.com/dithiothreitol/trainctl/blob/v0.6.0/docs/science/FOUNDATIONS.md' + const lines = renderChoices([{ label: 'jeden', value: 1, hint: `źródło ${url} i długa wskazówka, która nie mieści się w jednym wierszu` }], 0, theme) + for (const line of lines) expect(visibleLength(line)).toBeLessThanOrEqual(40) + }) + + it('log.jsonl: wiersz, który nie jest obiektem JSON, pominięty i zgłoszony, reszta działa', () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + appendFileSync(join(dir, 'log.jsonl'), [ + JSON.stringify({ date: '2026-10-26', status: 'done', loggedAt: 'x' }), + '{"date": "2026-10-27", "status": "done",', + '"abc"', + JSON.stringify({ date: '2026-10-27', status: 'done', km: 8, loggedAt: 'y' }), + ].join('\n') + '\n') + expect(readLog(dir).map((e) => e.date)).toEqual(['2026-10-26', '2026-10-27']) + expect(cmdToday(dir).code).toBe(0) + expect(cmdStatus(dir).output).toContain('line 2, line 3') + }) + + it('parseDecimal bez przecinka: „1,500" to nie 1,5', () => { + expect(parseDecimal('1,500', false)).toBeNaN() + expect(parseDecimal('1.5', false)).toBe(1.5) + expect(parseDecimal('1,5')).toBe(1.5) + }) +}) + +describe('dwudziesta pierwsza runda: ochrona dni przy uszkodzonym dzienniku, dokładna dawka', () => { + it('uszkodzony wiersz log.jsonl: widoki działają, zmiana planu czeka na poprawkę pliku', () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + cmdLog(dir, { date: '2026-10-27', status: 'done', km: '8' }) + const before = readFileSync(join(dir, 'plan', 'plan.yaml'), 'utf-8') + appendFileSync(join(dir, 'log.jsonl'), '{"date": "2026-10-28", "status": "done",\n') + expect(cmdToday(dir).code).toBe(0) + writeFileSync(join(dir, 'trainctl.yaml'), CONFIG.replace('recentWeeklyKm: 45', 'recentWeeklyKm: 50'), 'utf-8') + const plan = cmdPlan(dir) + expect(plan.code).not.toBe(0) + expect(plan.output).toContain('cannot read line 2') + expect(readFileSync(join(dir, 'plan', 'plan.yaml'), 'utf-8')).toBe(before) + }) + + it('dawka w why z dokładnością do 0,01 km', () => { + expect(coachEn.segment('strides', 1.25, '')).toContain('1.25 km') + expect(coachPl.segment('przebieżki', 1.25, '')).toContain('1,25 km') + expect(coachEn.adjusted('easy', 10.25, 40)).toContain('10.25 km') + }) +}) + +describe('dwudziesta druga runda: shift i reschedule przy uszkodzonym dzienniku', () => { + const breakLog = () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + cmdLog(dir, { date: '2026-10-27', status: 'done', km: '8' }) + appendFileSync(join(dir, 'log.jsonl'), '{"date": "2026-10-27", "status": "done", "km": 8\n') + return readFileSync(join(dir, 'plan', 'plan.yaml'), 'utf-8') + } + + it('shift czeka na poprawkę dziennika', () => { + const before = breakLog() + const r = cmdShift(dir, { from: '2026-10-27', to: '2026-10-28' }) + expect(r.code).not.toBe(0) + expect(r.output).toContain('cannot read line 2') + expect(readFileSync(join(dir, 'plan', 'plan.yaml'), 'utf-8')).toBe(before) + }) + + it('reschedule czeka na poprawkę dziennika', () => { + const before = breakLog() + const r = cmdReschedule(dir, { block: ['2026-10-29'], date: '2026-10-27', apply: true }) + expect(r.code).not.toBe(0) + expect(r.output).toContain('cannot read line 2') + expect(readFileSync(join(dir, 'plan', 'plan.yaml'), 'utf-8')).toBe(before) + }) + + it('status nazywa uszkodzony wiersz komunikatem o zmianie planu', () => { + breakLog() + expect(cmdStatus(dir).output).toContain('Fix the file before changing the plan') + }) + + it('opuszczona sesja z czasem: komunikat o opuszczonej sesji, nie o zapisie czasu', () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-27' + expect(cmdLog(dir, { date: '2026-10-27', status: 'skipped', time: '5km' }).output).toContain('A skipped session cannot have a distance or duration.') + }) + + it('workoutKm: start z jednym miejscem, sesja do dwóch', () => { + setLocale('en') + expect(workoutKm({ distanceKm: 0, raceDistanceKm: 42.195 })).toBe('42.2 km') + expect(workoutKm({ distanceKm: 10.25 })).toBe('10.25 km') + }) +}) + +describe('dwudziesta trzecia runda: adapt i review przy uszkodzonym dzienniku, klasa dystansu', () => { + const breakLog = () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2026-10-29' + cmdLog(dir, { date: '2026-10-27', status: 'done', km: '8' }) + appendFileSync(join(dir, 'log.jsonl'), '{"date": "2026-10-28", "status": "done",\n') + } + + it('adapt nie stawia diagnozy z niepełnego dziennika', () => { + breakLog() + const r = cmdAdapt(dir, {}) + expect(r.code).not.toBe(0) + expect(r.output).toContain('cannot read line 2') + }) + + it('review ostrzega, że dziennik jest niepełny', async () => { + breakLog() + const r = await cmdReview(dir, {}) + expect(r.code).toBe(0) + expect(r.output).toContain('cannot read line 2') + }) + + it('distanceClass: te same granice co goalClass', () => { + expect(distanceClass(42.195)).toBe('marathon') + expect(distanceClass(50)).toBe('ultra') + expect(distanceClass(21.0975)).toBe('half') + expect(distanceClass(10)).toBe('short') + expect(goalClass({ kind: 'base', distanceKm: 0 })).toBe('base') + }) +}) + +describe('dwudziesta czwarta runda: jedna dokładność dystansu', () => { + it('kmLabel: do dwóch miejsc w każdym widoku, start bez artefaktu zapisu binarnego', () => { + setLocale('en') + expect(kmLabel(42.195)).toBe('42.2 km') + expect(kmLabel(21.0975)).toBe('21.1 km') + expect(kmLabel(10.25)).toBe('10.25 km') + expect(kmLabel(8.123)).toBe('8.12 km') + expect(kmLabel(1.005)).toBe('1.01 km') + expect(kmLabel(21.0975, 4)).toBe('21.0975 km') + setLocale('pl') + expect(kmLabel(10.25)).toBe('10,25 km') + }) + + it('today: „następny" ma tę samą dokładność co panel dnia', () => { + setLocale('en') + process.env['TRAINCTL_TODAY'] = '2027-03-26' + expect(cmdToday(dir).output).toMatch(/next: .* · 21\.1 km/) + }) +}) diff --git a/packages/cli/src/commands.test.ts b/packages/cli/src/commands.test.ts index e0da917..97e46e9 100644 --- a/packages/cli/src/commands.test.ts +++ b/packages/cli/src/commands.test.ts @@ -110,7 +110,7 @@ describe('trainctl log', () => { const r = cmdLog(dir, { date: '2026-08-04', status: 'done', time: '58:30', note: 'dobre czucie' }) expect(r.code).toBe(0) const today = cmdToday(dir, { date: '2026-08-04' }) - expect(today.output).toContain('Zalogowano: done') + expect(today.output).toContain('Zalogowano: wykonany') expect(today.output).toContain('dobre czucie') }) diff --git a/packages/cli/src/commands.ts b/packages/cli/src/commands.ts index ad91080..323d2fb 100644 --- a/packages/cli/src/commands.ts +++ b/packages/cli/src/commands.ts @@ -35,8 +35,9 @@ import { import { AGENTS_FILE, agentsTemplate } from './agents-md.ts' import { ENV_FILE } from './env-file.ts' import { ui } from './i18n/index.ts' +import { kmLabel, logStatusText, parseDecimal, shownKm, workoutKm } from './format.ts' import { inferredConfigYaml, loadConfig, writeConfigTemplate, CONFIG_FILE } from './config.ts' -import { appendLog, logFor, parseTime, readLog, readStrengthLog, type LogEntry, type StrengthLogEntry } from './logfile.ts' +import { appendLog, latestByDate, LOG_LIMITS, parseTime, readJournal, readLog, readLogForChanges, type LogEntry, type StrengthLogEntry } from './logfile.ts' import { computePlan, cycleWeeksOf, @@ -75,7 +76,7 @@ import { runExport, EXPORT_DIR, type ExportWhat } from './export.ts' import { b, renderPlain, type Block } from './ui/blocks.ts' import type { ColorName } from './ui/theme.ts' import { buildExecution, isRunningActivity } from './execution.ts' -import { resultKey } from './calibration.ts' +import { recalibrationToday, resultKey, sameResults } from './calibration.ts' import { applyProposal, prepareProposal, prepareShortening, raceDayKm, recordedDates, type PlanProposal } from './proposals.ts' import { explainSession } from './explain-session.ts' export { buildExecution } from './execution.ts' @@ -240,7 +241,7 @@ export async function cmdInitFromIntervals( : []), [ui().init.trainingDays, p.daysAvailable.join(', ')], ...(p.longRunDay ? ([[ui().init.longRunDay, p.longRunDay]] as [string, string][]) : []), - [ui().init.lastFourWeeks, recent4.map((km) => `${km} km`).join(' · ')], + [ui().init.lastFourWeeks, recent4.map((km) => kmLabel(km)).join(' · ')], ]), ] for (const c of p.caveats) blocks.push(b.warn(c)) @@ -250,7 +251,7 @@ export async function cmdInitFromIntervals( b.bullets( p.raceCandidates.slice(0, 5).map( (c) => - `${c.date} · ${c.name ?? ui().init.unnamed} · ${c.distanceKm} km — ` + + `${c.date} · ${c.name ?? ui().init.unnamed} · ${kmLabel(c.distanceKm)} — ` + `${fmtClock(c.timeSec)} (${c.reason})` + ` → results: { date: "${c.date}", distanceKm: ${c.distanceKm}, timeSec: ${c.timeSec} }`, ), @@ -393,7 +394,7 @@ function planImpl(cwd: string, opts: { date?: string | undefined; fresh?: boolea const weeksToRace = cycle.length const blocks: Block[] = [ b.title( - plan.goal.kind === 'base' ? plan.goal.name : `${plan.goal.name} · ${plan.goal.distanceKm} km`, + plan.goal.kind === 'base' ? plan.goal.name : `${plan.goal.name} · ${kmLabel(plan.goal.distanceKm)}`, `${plan.goal.kind === 'base' ? ui().plan.baseUntil(plan.goal.date) : plan.goal.date} · ${ui().plan.weeksOfPlan(weeksToRace)}`, ), b.kv([ @@ -401,7 +402,7 @@ function planImpl(cwd: string, opts: { date?: string | undefined; fresh?: boolea ...(plan.peakKmRecommended > 0 ? ([[ui().plan.recommendedForDistance, messages().units.kmPerWeek(plan.peakKmRecommended)]] as [string, string][]) : []), [ ui().plan.vdot, - `${plan.vdot} (${plan.vdotSource === 'result' ? ui().plan.vdotFromResult : ui().plan.vdotFromGoal})`, + `${formatNumber(getLocale(), plan.vdot)} (${plan.vdotSource === 'result' ? ui().plan.vdotFromResult : ui().plan.vdotFromGoal})`, ], ]), ] @@ -548,7 +549,7 @@ export function cmdToday(cwd: string, opts: { session?: string | undefined; spor const w = day.workout blocks.push( b.panel( - `${kindLabel(w.kind)} · ${w.raceDistanceKm ?? w.distanceKm} km`, + `${kindLabel(w.kind)} · ${workoutKm(w)}`, [workoutText(day)], KIND_COLOR[w.kind] ?? 'accent', ), @@ -569,28 +570,31 @@ export function cmdToday(cwd: string, opts: { session?: string | undefined; spor kind && !['easy', 'long'].includes(kind) ? b.warn(advice) : b.text(advice, 'muted'), ) } - const entry = logFor(cwd, date) + // dziennik czytany raz: wpis biegu i wpis siły tego dnia (ostatni wygrywa) + const journal = readJournal(cwd) + const entry = latestByDate(journal.runs).get(date) if (entry) { blocks.push( b.success( - ui().today.logged(entry.status) + - (entry.km ? `, ${entry.km} km` : '') + + ui().today.logged(logStatusText(entry.status)) + + // 0 km w podsumowaniu dnia to brak dystansu; echo `log` pokazuje to, co zapisano + (entry.km !== undefined && entry.km > 0 ? `, ${kmLabel(entry.km, 4)}` : '') + (entry.rpe !== undefined ? `, RPE ${entry.rpe}` : '') + (entry.note ? ` — ${entry.note}` : ''), ), ) } - const strengthEntry = readStrengthLog(cwd).filter((e) => e.date === date).at(-1) - if (strengthEntry) blocks.push(b.success(ui().today.strengthLogged(strengthEntry.status))) + const strengthEntry = latestByDate(journal.strength).get(date) + if (strengthEntry) blocks.push(b.success(ui().today.strengthLogged(logStatusText(strengthEntry.status, true)))) const estimatedMinutes = (day.workout ? estimateWorkoutMinutes(day.workout, plan.preparationMinutes ?? 15) : 0) + (day.strength?.durationMin ?? 0) // Dla biegacza zza biurka dwie najważniejsze liczby dnia: ile to potrwa i co dalej. if ((day.workout || day.strength) && Number.isFinite(estimatedMinutes)) blocks.push(b.text(ui().today.estimate(estimatedMinutes), 'muted')) const next = plan.weeks.flatMap((w) => w.days).find((d) => d.date > date && d.workout) if (next?.workout) { - blocks.push(b.text(ui().today.next(next.date, weekdayName(next.weekday), kindLabel(next.workout.kind), next.workout.raceDistanceKm ?? next.workout.distanceKm), 'muted')) + blocks.push(b.text(ui().today.next(next.date, weekdayName(next.weekday), kindLabel(next.workout.kind), workoutKm(next.workout)), 'muted')) } if (day.workout) blocks.push(b.hint(ui().today.whyHint(date))) - return okDoc(blocks, { date, day, week: { weekStart: week.weekStart, phase: sk.phase }, log: entry ?? null, calibration: plan.calibration ?? null, estimatedMinutes: Number.isFinite(estimatedMinutes) ? estimatedMinutes : null, next: next ? { date: next.date, kind: next.workout!.kind, distanceKm: next.workout!.raceDistanceKm ?? next.workout!.distanceKm } : null }) + return okDoc(blocks, { date, day, week: { weekStart: week.weekStart, phase: sk.phase }, log: entry ?? null, calibration: plan.calibration ?? null, estimatedMinutes: Number.isFinite(estimatedMinutes) ? estimatedMinutes : null, next: next ? { date: next.date, kind: next.workout!.kind, distanceKm: shownKm(next.workout!) } : null }) } catch (e) { return fail(e) } @@ -609,16 +613,19 @@ export function cmdWeek(cwd: string, opts: { session?: string | undefined; sport const model = messages().intensityModel[sk.intensityModel] const rows: string[][] = [] const accents: (ColorName | undefined)[] = [] + // dziennik czytany raz; ostatni wpis daty wygrywa, jak w logFor + const logs = readLog(cwd) + const lastByDate = latestByDate(logs) for (const day of week.days) { - const entry = logFor(cwd, day.date) + const entry = lastByDate.get(day.date) // status słowem, nie symbolem: to samo wyjście czyta agent przez MCP - const mark = entry ? ` [${entry.status}]` : '' + const mark = entry ? ` [${logStatusText(entry.status)}]` : '' const kind = day.workout?.kind const strength = day.strength ? ` ${ui().week.strengthTag(day.strength.durationMin)}` : '' rows.push([ weekdayShort(day.weekday), day.date.slice(5), - day.workout ? `${day.workout.raceDistanceKm ?? day.workout.distanceKm} km` : '—', + day.workout ? workoutKm(day.workout) : '—', day.workout ? `${workoutText(day)}${strength}${mark}` : `${ui().week.rest}${strength}`, ]) accents.push(kind ? KIND_COLOR[kind] : 'muted') @@ -626,7 +633,7 @@ export function cmdWeek(cwd: string, opts: { session?: string | undefined; sport const blocks: Block[] = [ b.title( ui().week.title(weekPosition(plan, week).index + 1, weekPosition(plan, week).total, week.weekStart), - ui().week.subtitle(phaseLabel(sk.phase), model, plannedWeekKm(sk), week.totalKm) + + ui().week.subtitle(phaseLabel(sk.phase), model, plannedWeekKm(sk), kmDiffers(week.totalKm, plannedWeekKm(sk)) ? week.totalKm : undefined) + (sk.deload ? ` · ${ui().week.deloadUpper}` : ''), ), ...compatibilityNotes(plan), @@ -636,7 +643,7 @@ export function cmdWeek(cwd: string, opts: { session?: string | undefined; sport if (sk.keepIntensity) { blocks.push(b.info(ui().week.taperNote)) } - return okDoc(blocks, { week, execution: buildExecution(plan, readSnapshot(cwd)?.activities ?? [], readLog(cwd), date).filter((e) => week.days.some((d) => d.date === e.date)) }) + return okDoc(blocks, { week, execution: buildExecution(plan, readSnapshot(cwd)?.activities ?? [], logs, date).filter((e) => week.days.some((d) => d.date === e.date)) }) } catch (e) { return fail(e) } @@ -676,20 +683,30 @@ function logImpl(cwd: string, opts: LogOptions): CmdResult { } // CR-10 bez zera: wpis dotyczy odbytej sesji, a 0 znaczy „brak wysiłku" — // dolna granica 1 to wybór inżynierski, sama skala z P-6 (Foster). - const rpe = opts.rpe === undefined ? undefined : Number(opts.rpe) - if (rpe !== undefined && (!Number.isInteger(rpe) || rpe < 1 || rpe > 10)) { + const rpe = opts.rpe === undefined ? undefined : parseDecimal(String(opts.rpe)) + if (rpe !== undefined && !LOG_LIMITS.rpe(rpe)) { return fail(new Error(ui().log.badRpe(String(opts.rpe)))) } - if (opts.km !== undefined && (!opts.km.trim() || !Number.isFinite(Number(opts.km)) || Number(opts.km) < 0)) throw new Error(ui().improve.badDistance) + // przecinek jak w polskim wyjściu („8,5"); ta sama reguła co kreator i odczyt log.jsonl + const typed = opts.km === undefined ? undefined : parseDecimal(String(opts.km)) + // zapis z dokładnością 0,1 m (4 miejsca); wartość dodatnia, która by przy tym znikła, to błąd + const km = typed === undefined ? undefined : Math.round(typed * 1e4) / 1e4 + if (km !== undefined && !LOG_LIMITS.km(km)) throw new Error(ui().improve.badDistance) + if (typed !== undefined && typed > 0 && km === 0) throw new Error(ui().improve.distanceTooSmall) + // opuszczona sesja nie ma ani dystansu, ani czasu — ten komunikat przed oceną zapisu czasu + if (status === 'skipped' && ((km ?? 0) > 0 || opts.time !== undefined)) throw new Error(ui().improve.skippedMetrics) + // parseTime odrzuca czas zerowy i błędny zapis — to ta sama granica co LOG_LIMITS przy odczycie + const timeSec = opts.time ? parseTime(opts.time) : undefined const testTimeSec = opts.testTime === undefined ? undefined : parseTime(opts.testTime) if (testTimeSec !== undefined && (status === 'skipped' || !['test', 'race'].includes(findDay(plan, date)?.day.workout?.kind ?? ''))) throw new Error(ui().improve.testTimeOnly) - if (status === 'skipped' && ((Number(opts.km) || 0) > 0 || opts.time !== undefined)) throw new Error(ui().improve.skippedMetrics) - if (testTimeSec !== undefined && opts.time && testTimeSec > parseTime(opts.time)) throw new Error(ui().improve.testTimeOnly) + if (testTimeSec !== undefined && timeSec !== undefined && testTimeSec > timeSec) throw new Error(ui().improve.testTimeOnly) const entry: LogEntry = { date, status, - ...(opts.km ? { km: Number(opts.km) } : {}), - ...(opts.time ? { timeSec: parseTime(opts.time) } : {}), + // opuszczona sesja nie ma dystansu (0 km to brak informacji, nie wynik) + // echo i today pokazują dokładnie to, co zapisano (km już zaokrąglone do 0,1 m) + ...(km !== undefined && status !== 'skipped' ? { km } : {}), + ...(timeSec !== undefined ? { timeSec } : {}), ...(testTimeSec !== undefined ? { testTimeSec } : {}), ...(rpe !== undefined ? { rpe } : {}), ...(opts.note ? { note: opts.note } : {}), @@ -702,25 +719,26 @@ function logImpl(cwd: string, opts: LogOptions): CmdResult { const minutes = workout ? estimateWorkoutMinutes(workout, plan.preparationMinutes ?? 15) : undefined const knownMinutes = minutes !== undefined && Number.isFinite(minutes) ? minutes : null const planned = workout - ? [kindLabel(workout.kind), `${formatNumber(getLocale(), workout.raceDistanceKm ?? workout.distanceKm)} km`, ...(knownMinutes !== null ? [`~${knownMinutes} min`] : [])].join(' · ') + ? [kindLabel(workout.kind), workoutKm(workout), ...(knownMinutes !== null ? [`~${knownMinutes} min`] : [])].join(' · ') : ui().week.rest const recorded = [ - entry.status, - ...(entry.km !== undefined ? [`${formatNumber(getLocale(), entry.km)} km`] : []), + logStatusText(entry.status), + // echo zapisu: dokładnie to, co zapisano (podpowiedź kreatora ma 4 miejsca) + ...(entry.km !== undefined ? [kmLabel(entry.km, 4)] : []), ...(entry.timeSec !== undefined ? [fmtTime(entry.timeSec)] : []), ...(entry.testTimeSec !== undefined ? [ui().log.testTime(fmtTime(entry.testTimeSec))] : []), ...(entry.rpe !== undefined ? [`RPE ${entry.rpe}`] : []), ...(entry.note ? [`“${entry.note}”`] : []), ].join(' · ') const blocks: Block[] = [ - b.success(ui().log.saved(date, status)), + b.success(ui().log.saved(date, logStatusText(status))), b.kv([[ui().log.planned, planned], [ui().log.recorded, recorded]]), ] if (!workout && status !== 'skipped') blocks.push(b.info(ui().log.unplanned)) blocks.push(b.hint(ui().shift.weekHint(date))) return okDoc(blocks, { entry, - planned: workout ? { kind: workout.kind, distanceKm: workout.raceDistanceKm ?? workout.distanceKm, estimatedMinutes: knownMinutes } : null, + planned: workout ? { kind: workout.kind, distanceKm: shownKm(workout), estimatedMinutes: knownMinutes } : null, }) } catch (e) { return fail(e) @@ -735,8 +753,8 @@ function logStrength(cwd: string, plan: StoredPlan, date: string, opts: LogOptio const t = ui().log if (opts.strength !== 'done' && opts.strength !== 'skipped') throw new Error(t.strengthStatus(String(opts.strength))) if ([opts.km, opts.time, opts.testTime, opts.rpe].some((v) => v !== undefined)) throw new Error(t.strengthOnly) - const minutes = opts.minutes === undefined ? undefined : Number(opts.minutes) - if (minutes !== undefined && (!Number.isInteger(minutes) || minutes < 1 || minutes > 300)) throw new Error(t.strengthMinutes) + const minutes = opts.minutes === undefined ? undefined : parseDecimal(String(opts.minutes)) + if (minutes !== undefined && !LOG_LIMITS.minutes(minutes)) throw new Error(t.strengthMinutes) const entry: StrengthLogEntry = { date, activity: 'strength', @@ -748,7 +766,7 @@ function logStrength(cwd: string, plan: StoredPlan, date: string, opts: LogOptio appendLog(cwd, entry) const planned = findDay(plan, date)!.day.strength const blocks: Block[] = [ - b.success(t.strengthSaved(date, entry.status)), + b.success(t.strengthSaved(date, logStatusText(entry.status, true))), b.kv([[t.planned, planned ? ui().today.strengthTitle(planned.durationMin) : ui().week.rest]]), ] if (!planned && entry.status === 'done') blocks.push(b.info(t.strengthUnplanned)) @@ -765,7 +783,7 @@ function shiftImpl(cwd: string, opts: { from: string; to: string }): CmdResult { try { if (opts.from < localToday() || opts.to < localToday()) throw new Error(ui().improve.pastWrite) const plan = loadPlan(cwd) - const recorded = new Set(readLog(cwd).map(l => l.date)) + const recorded = new Set(readLogForChanges(cwd).map(l => l.date)) for (const a of readSnapshot(cwd)?.activities ?? []) if (isRunningActivity(a) && (a.distanceKm ?? 0) > 0) recorded.add(a.date) if (recorded.has(opts.from) || recorded.has(opts.to)) throw new Error(ui().improve.pastWrite) const { warnings } = shiftWorkout(plan, opts.from, opts.to) @@ -822,9 +840,25 @@ export function cmdWhy(cwd: string, opts: { session?: string | undefined; sport? } if (!day.workout && !day.strength) blocks.push(b.text(ui().why.restDay)) blocks.push(b.section(ui().improve.calibration)) + // Opisy wyników to decyzje z dnia kalibracji (zapis w planie), wiek liczony od dziś. + // Co zrobiłby dziś `trainctl plan`, mówi jedna podpowiedź liczona tak jak przy + // regeneracji, z dzisiejszego trainctl.yaml; bez czytelnego profilu jej nie ma. + const now = localToday() + const config = plan.calibration ? (() => { try { return loadConfig(cwd) } catch { return undefined } })() : undefined + const recalibration = plan.calibration && config + ? recalibrationToday({ calibration: plan.calibration, vdot: plan.vdot, vdotSource: plan.vdotSource }, config.athlete.results, now, config.goal) : null if (plan.calibration) { - blocks.push(b.text(ui().improve.calibrationPolicy), b.bullets(plan.calibration.candidates.map((c) => - [c.result.date, c.result.name ?? String(c.result.distanceKm) + ' km', 'VDOT ' + c.vdot.toFixed(1), ui().improve[c.reason], ui().improve.age(c.ageDays), c.result.exclusionReason ?? ''].filter(Boolean).join(' · ')))) + blocks.push(b.text(ui().improve.calibrationPolicy), b.text(ui().improve.calibratedOn(plan.calibration.evaluatedAt), 'muted'), b.bullets(plan.calibration.candidates.map((c) => { + const age = diffDays(c.result.date, now) + return [c.result.date, c.result.name ?? kmLabel(c.result.distanceKm), 'VDOT ' + formatNumber(getLocale(), c.vdot), ui().improve[c.reason], ...(age >= 0 ? [ui().improve.age(age)] : []), c.result.exclusionReason ?? ''].filter(Boolean).join(' · ') + }))) + if (!config) blocks.push(b.text(ui().improve.recalibrateUnknown, 'muted')) + if (recalibration?.changed) { + const next = recalibration.selected + // bez wyniku plan liczy strefy z czasu docelowego, a bez niego się zatrzyma (zoneSource) + blocks.push(b.info(next ? ui().improve.recalibrateTo(next.date, kmLabel(next.distanceKm)) + : recalibration.source === 'goal-target' ? ui().improve.recalibrateGoal(fmtTime(config!.goal.targetTimeSec!)) : ui().improve.recalibrateNone)) + } } else blocks.push(b.info(ui().improve.calibrationMissing)) const evidence = [...new Set([...(day.workout?.ruleRefs ?? []), ...sk.ruleRefs, ...(day.strength?.ruleRefs ?? [])])].map((id) => ({ id, origin: ruleEvidence(id), explanation: ruleExplain(id) ?? id })) // Jedna lista reguł: ID, treść i pochodzenie razem. Wcześniej te same ID stały @@ -833,7 +867,7 @@ export function cmdWhy(cwd: string, opts: { session?: string | undefined; sport? blocks.push(b.section(ui().why.rules), b.bullets(evidence.map((e) => ui().why.ruleLine(e.id, ruleExplain(e.id), ui().improve[e.origin])))) } blocks.push(b.blank(), b.hint(ui().why.sourcesHint(foundationsUrl(), day.workout || !day.strength ? '§10' : '§10.8'))) - return okDoc(blocks, { day, explanation, calibration: plan.calibration ?? null, evidence }) + return okDoc(blocks, { day, explanation, calibration: plan.calibration ?? null, recalibration, evidence }) } catch (e) { return fail(e) } @@ -949,8 +983,8 @@ export async function cmdPull( [ui().pull.columns.date, ui().pull.columns.planned, ui().pull.columns.actual, ui().pull.columns.status], rows.slice(-10).map((r) => [ r.date, - `${r.plannedKm} km`, - r.actualKm === undefined ? '—' : `${r.actualKm} km`, + kmLabel(r.plannedKm), + r.actualKm === undefined ? '—' : kmLabel(r.actualKm), ui().compare[r.status], ]), rows.slice(-10).map((r) => (r.status === 'missed' ? 'warn' : 'muted')), @@ -976,7 +1010,8 @@ function analyzeAdapt(cwd: string, opts: { date?: string | undefined } = {}): Cm const plan = loadPlan(cwd) const config = loadConfig(cwd) const snapshot = readSnapshot(cwd) - const logs = readLog(cwd) + // diagnoza prowadzi do zmiany planu — z niepełnego dziennika byłaby błędna + const logs = readLogForChanges(cwd) const execution = buildExecution(plan, snapshot?.activities ?? [], logs, today) const currentWeek = plan.weeks.find((w) => w.days.some((d) => d.date === today)) @@ -1024,7 +1059,7 @@ function analyzeAdapt(cwd: string, opts: { date?: string | undefined } = {}): Cm execution, currentWeeklyKm, ...(newResults.length ? { newResults } : {}), - calibrationChanged: plan.calibration !== undefined && JSON.stringify(config.athlete.results.map(resultKey).sort()) !== JSON.stringify(plan.calibration.results.map(resultKey).sort()), + calibrationChanged: plan.calibration !== undefined && !sameResults(config.athlete.results, plan.calibration.results), ...(lastRaceDay ? { lastRace: { date: lastRaceDay.date, distanceKm: tuneUpByDate.get(lastRaceDay.date) ?? plan.goal.distanceKm } } : {}), ...(uncalibratedTests.length ? { uncalibratedTests } : {}), }) @@ -1091,10 +1126,10 @@ function adaptImpl(cwd: string, opts: { date?: string | undefined; prepare?: boo function proposalBlocks(saved: PlanProposal): Block[] { return [ b.section(ui().improve.changedDays), - b.kv([[ui().plan.vdot, `${saved.vdotBefore} → ${saved.plan.vdot}`]]), + b.kv([[ui().plan.vdot, `${formatNumber(getLocale(), saved.vdotBefore)} → ${formatNumber(getLocale(), saved.plan.vdot)}`]]), b.table([ui().improve.date, ui().improve.before, ui().improve.after], saved.changes.map((c) => [c.date, c.before, c.after])), b.info(ui().improve.protected), b.info(ui().improve.changedConfig), - b.table([ui().improve.date, ui().week.columns.km], saved.plan.weeks.filter((w) => w.days.some((d) => saved.changes.some((c) => c.date === d.date))).map((w) => [w.weekStart, String(w.totalKm)])), + b.table([ui().improve.date, ui().week.columns.km], saved.plan.weeks.filter((w) => w.days.some((d) => saved.changes.some((c) => c.date === d.date))).map((w) => [w.weekStart, formatNumber(getLocale(), w.totalKm)])), ...validatePlan(saved.plan).map((issue) => b.warn(describeIssue(issue))), b.hint(ui().coach.applyHint(saved.id)), ] @@ -1150,7 +1185,7 @@ export function cmdDesk( if (workout) { blocks.push( b.panel( - `${kindLabel(workout.kind)} · ${workout.distanceKm} km`, + `${kindLabel(workout.kind)} · ${workoutKm(workout)}`, day.recommended ? [ui().desk.proposedWindow(day.recommended.label, day.recommended.from, day.recommended.to)] : [ui().desk.noWindowFits], @@ -1239,7 +1274,7 @@ function rescheduleImpl(cwd: string, opts: RescheduleOptions): CmdResult { pinnedDates: opts.pin ?? [], fixedDates: [...new Set([ ...week.days.filter((d) => d.date < date || d.date < localToday()).map((d) => d.date), - ...readLog(cwd).filter((l) => week.days.some((d) => d.date === l.date)).map((l) => l.date), + ...readLogForChanges(cwd).filter((l) => week.days.some((d) => d.date === l.date)).map((l) => l.date), ...(readSnapshot(cwd)?.activities ?? []).filter((a) => isRunningActivity(a) && (a.distanceKm ?? 0) > 0 && week.days.some((d) => d.date === a.date)).map((a) => a.date), ])], strategy: (opts.strategy ?? 'long') as 'long' | 'quality', @@ -1423,7 +1458,8 @@ export async function cmdReview( } const snapshot = readSnapshot(cwd) - const logs = readLog(cwd) + const journal = readJournal(cwd) + const logs = journal.runs const blocks: Block[] = [ b.title( ui().review.title, @@ -1442,18 +1478,19 @@ export async function cmdReview( const done = execution.filter(e => e.status === 'done').length const missed = rows.filter((r) => r.status === 'missed') blocks.push( + ...(journal.broken.length ? [b.warn(ui().common.logBroken(LOG_FILE, journal.broken.join(', ')))] : []), b.section(ui().review.pastWeek), b.kv([ [ui().review.volume, ui().review.volumeValue(Math.round(actualKm), Math.round(plannedKm))], [ui().review.doneSessions, `${done}/${rows.filter((r) => r.plannedKm > 0).length}`], - ...strengthRow(plan, readStrengthLog(cwd), from, today), + ...strengthRow(plan, journal.strength, from, today), ...(missed.length ? ([[ui().compare.missed, missed.map((r) => r.date.slice(5)).join(', ')]] as [string, string][]) : []), ]), ) - blocks.push(b.section(ui().coach.reviewFacts), b.table([ui().improve.date, ui().improve.before, ui().improve.after, ui().improve.data], - execution.filter(e => e.kind || e.status === 'unplanned').map(e => [e.date, `${e.plannedKm} km`, e.actualKm === undefined ? ui().compare.unknown : `${e.actualKm} km`, ui().coach.status[e.status]]))) + blocks.push(b.section(ui().coach.reviewFacts), b.table([ui().improve.date, ui().review.columns.planned, ui().review.columns.actual, ui().review.columns.status], + execution.filter(e => e.kind || e.status === 'unplanned').map(e => [e.date, kmLabel(e.plannedKm), e.actualKm === undefined ? ui().compare.unknown : kmLabel(e.actualKm), ui().coach.status[e.status]]))) const unknown = execution.filter(e => e.status === 'unknown').map(e => e.date) if (unknown.length) blocks.push(b.warn(ui().coach.reviewUnknown(unknown.join(', ')))) @@ -1461,15 +1498,14 @@ export async function cmdReview( // datę (późniejszy nadpisuje wcześniejszy, jak w logFor). Żadnej agregacji // ani progów: interpretacja odczuć należy do rozmowy z trenerem-agentem, // silnik z RPE niczego nie liczy (ADR-027, Z-4). - const latestByDate = new Map() - for (const l of logs) if (l.date >= from && l.date <= today) latestByDate.set(l.date, l) - const feel = [...latestByDate.values()] + const latestLog = latestByDate(logs.filter((l) => l.date >= from && l.date <= today)) + const feel = [...latestLog.values()] .filter((l) => l.rpe !== undefined || l.note) .sort((a, z) => a.date.localeCompare(z.date)) // RPE wpisane w hubie (zegarek, aplikacja) — tylko tam, gdzie dziennik go nie ma: // własny wpis biegacza ma pierwszeństwo, a źródło jest nazwane wprost. const hubFeel = (snapshot?.activities ?? []) - .filter((a) => a.rpe !== undefined && a.date >= from && a.date <= today && isRunningActivity(a) && latestByDate.get(a.date)?.rpe === undefined) + .filter((a) => a.rpe !== undefined && a.date >= from && a.date <= today && isRunningActivity(a) && latestLog.get(a.date)?.rpe === undefined) .sort((a, z) => a.date.localeCompare(z.date)) if (feel.length || hubFeel.length) { const lines = [ @@ -1491,15 +1527,17 @@ export async function cmdReview( if (wellnessLines.length) blocks.push(b.section(ui().review.wellness), b.bullets(wellnessLines)) // 3) sygnały adaptacji — sekcja pojawia się tylko wtedy, gdy jest co powiedzieć - const adapt = cmdAdapt(cwd, { date: today }) - if (adapt.code !== 0) return adapt - const adaptation = adapt.data?.proposal as ReturnType | undefined + // Przy uszkodzonym dzienniku (ostrzeżenie na górze) sygnałów nie liczymy: diagnoza + // z niepełnego zapisu byłaby błędna, a przegląd faktów ma się dalej pokazać. + const adapt = journal.broken.length ? undefined : cmdAdapt(cwd, { date: today }) + if (adapt && adapt.code !== 0) return adapt + const adaptation = adapt?.data?.proposal as ReturnType | undefined const meaningful = adaptation?.actions.some((a) => a.type !== 'hold-course') === true - if (adapt.code === 0 && meaningful) { + if (adapt && meaningful) { blocks.push(b.section(ui().review.signals)) const lines = adaptation?.actions.filter((a) => a.type !== 'hold-course').map((a) => a.detail) ?? [] blocks.push(b.bullets(lines.length ? lines : [ui().review.seeAdapt])) - } else { + } else if (adapt) { blocks.push(adaptation?.dataStatus === 'complete' ? b.success(ui().review.noSignals) : b.warn(messages().adapt.incompleteData)) } @@ -1528,7 +1566,7 @@ export async function cmdReview( [ui().review.volume, ui().review.volumeAhead(Math.round(upcoming.reduce((s, d) => s + (d.workout?.distanceKm ?? 0), 0) * 10) / 10, week.totalKm, upcoming.length)], ...(plan.goal.kind === 'base' ? ([[ui().review.baseEnd, plan.goal.date]] as [string, string][]) - : ([[ui().review.toRace, raceDistanceLine(plan, diffDays(today, plan.goal.date))]] as [string, string][])), + : raceCountdown(daysToRace(plan, today))), ]), ) const race = upcoming.find((d) => d.workout?.kind === 'race') @@ -1562,7 +1600,7 @@ export async function cmdReview( const nextRace = (config.athlete.tuneUpRaces ?? []).find((r) => r.date > today) if (nextRace) { todo.push( - ui().review.todoNextRace(nextRace.date, nextRace.name ?? `${nextRace.distanceKm} km`), + ui().review.todoNextRace(nextRace.date, nextRace.name ?? kmLabel(nextRace.distanceKm)), ) } blocks.push(b.section(ui().review.todo), b.bullets(todo)) @@ -1916,14 +1954,22 @@ export function cmdDiff(cwd: string, opts: { plan?: string | undefined } = {}): */ function strengthRow(plan: StoredPlan, entries: StrengthLogEntry[], from: string, to: string): [string, string][] { const planned = plan.weeks.flatMap((w) => w.days).filter((d) => d.strength && d.date >= from && d.date <= to).length - const latest = new Map() - for (const e of entries) if (e.date >= from && e.date <= to) latest.set(e.date, e) + const latest = latestByDate(entries.filter((e) => e.date >= from && e.date <= to)) if (!planned && !latest.size) return [] const done = [...latest.values()].filter((e) => e.status === 'done').length const skipped = [...latest.values()].filter((e) => e.status === 'skipped').length return [[ui().review.strength, ui().review.strengthValue(done, planned, skipped)]] } +/** + * Wiersz przeglądu: „Do startu: N dni" przed startem, „Od startu: N dni" po nim. + * Liczba dni z neutralnego `common.dayCount`. Podtytuł `today` to zdanie, nie + * etykieta z wartością, dlatego ma własną funkcję (raceDistanceLine). + */ +function raceCountdown(toRace: number): [string, string][] { + return toRace >= 0 ? [[ui().review.toRace, ui().common.dayCount(toRace)]] : [[ui().review.sinceRace, ui().common.dayCount(-toRace)]] +} + /** „N dni do startu", „N dni po starcie" albo koniec planu bazowego (P-11). */ function raceDistanceLine(plan: StoredPlan, toRace: number): string { if (plan.goal.kind === 'base') return ui().plan.baseUntil(plan.goal.date) diff --git a/packages/cli/src/engine-060.test.ts b/packages/cli/src/engine-060.test.ts index 449e01e..15fb91e 100644 --- a/packages/cli/src/engine-060.test.ts +++ b/packages/cli/src/engine-060.test.ts @@ -144,8 +144,9 @@ describe('E-2 · budżet czasu z profilu', () => { const capped = plan(`${BASE}time:\n weeklyMinutes: 200\n`) const week = capped.weeks.find((w) => w.skeleton.timeCappedKm !== undefined && w.skeleton.timeCappedKm < w.skeleton.targetKm - 5)! const out = cmdWeek(dir, { date: week.days[0]!.date }).output - expect(out).toContain('target ') - expect(out).not.toContain(`target ${week.skeleton.targetKm} km`) + // cel po budżecie równy rozpisanej sumie — jedna liczba, bez zamiaru makrocyklu + expect(out).toContain(`${week.skeleton.timeCappedKm} km`) + expect(out).not.toContain(`${week.skeleton.targetKm} km`) }) it('plan z budżetem wygenerowany drugi raz bez zmian na wejściu jest „aktualny"', () => { plan(`${BASE}time:\n weeklyMinutes: 240\n weekdayMinutes: 50\n`) diff --git a/packages/cli/src/export.ts b/packages/cli/src/export.ts index 8191e22..6a504ad 100644 --- a/packages/cli/src/export.ts +++ b/packages/cli/src/export.ts @@ -19,6 +19,7 @@ import { type RaceScenario, } from 'trainctl-export' import { ui } from './i18n/index.ts' +import { kmLabel, shownKm, workoutKm } from './format.ts' import { cycleWeeksOf, findDay, loadPlan, weekPosition, workoutText, type StoredPlan } from './planfile.ts' import { kindPurpose, ruleExplain, ruleEvidence } from './rules-explain.ts' @@ -110,7 +111,7 @@ function fitFor(plan: StoredPlan, day: PlannedDay, dir: string): ExportedFile | return { path: file, bytes: bytes.length, - description: `${name} · ${day.workout.distanceKm} km`, + description: `${name} · ${workoutKm(day.workout)}`, } } @@ -130,7 +131,7 @@ export function runExport(cwd: string, req: ExportRequest): ExportedFile[] { const html = toMobileHtml({ lang: getLocale(), title: labels.mobile, date: day.date, goal: plan.goal.name, kind: day.workout ? kindLabel(day.workout.kind) : labels.mobileRest, - distance: day.workout ? messages().units.km(day.workout.raceDistanceKm ?? day.workout.distanceKm) : '', + distance: day.workout ? messages().units.km(shownKm(day.workout)) : '', duration: Number.isFinite(minutes) ? labels.minuteEstimate(minutes) : labels.unknownDuration, purpose: day.workout ? kindPurpose(day.workout.kind) : ui().today.restDayBody, steps: day.workout?.segments.map((s) => s.description) ?? [ui().today.restDayBody], @@ -174,7 +175,7 @@ export function runExport(cwd: string, req: ExportRequest): ExportedFile[] { .map((day) => { const runLabel = day.workout ? `${kindLabel(day.workout.kind)}${ - day.workout.distanceKm ? ` ${day.workout.distanceKm} km` : '' + shownKm(day.workout) ? ` ${workoutKm(day.workout)}` : '' }` : undefined const strengthLabel = day.strength @@ -234,7 +235,7 @@ export function runExport(cwd: string, req: ExportRequest): ExportedFile[] { days: w.days.map((d) => ({ weekday: core.weekdayShort[d.weekday], date: d.date.slice(5).replace('-', '.'), - km: d.workout?.distanceKm ? `${d.workout.distanceKm} km` : '', + km: d.workout && shownKm(d.workout) ? workoutKm(d.workout) : '', rest: !d.workout, text: (d.workout ? workoutText(d) : p.rest) + diff --git a/packages/cli/src/format.ts b/packages/cli/src/format.ts new file mode 100644 index 0000000..79b1243 --- /dev/null +++ b/packages/cli/src/format.ts @@ -0,0 +1,47 @@ +/** Drobne formaty wyjścia wspólne dla komend (bez kolorów, ADR-013). */ +import { formatNumber, getLocale } from 'trainctl-core' +import { ui } from './i18n/index.ts' + +/** + * Dystans skrótem „km" w formacie języka: „21,1 km" po polsku, „21.1 km" po + * angielsku — do tabel i wierszy. Forma słowna („8 kilometrów") to osobny + * `messages().units.km` z core. Domyślnie do dwóch miejsc po przecinku, ta sama + * dokładność w każdym widoku: sesja po skróceniu „10,25 km", start „21,1 km" + * i „42,2 km". Poprawka 1e-9 zaokrągla połówki w górę także tam, gdzie zapis binarny + * jest odrobinę mniejszy (1,005 × 100 = 100,4999… dałoby „1 km" zamiast „1,01 km"). + * Wpis biegacza (`decimals` 4, jak podpowiedź kreatora) + * wraca tak, jak go zapisano: „21,0975 km". + * Ręcznie edytowany log.jsonl normalizuje readAll — tu trafiają już liczby. + */ +export const kmLabel = (km: number, decimals = 2): string => { + const scale = 10 ** decimals + return `${formatNumber(getLocale(), Math.round((km + 1e-9) * scale) / scale, decimals)} km` +} + +/** + * Liczba wpisana przez człowieka: „8", „8.5", „8,5", „.5" albo „5." (przecinek jak + * w polskim wyjściu). Tylko zwykły zapis dziesiętny — bez „0x10" i „1e3", które + * Number() też przyjmuje; wszystko inne to NaN. Jedna reguła dla wszystkich liczb + * dziennika: `log` (km, RPE, minuty siły), kreator i odczyt log.jsonl. `comma` false: + * metry i minuty w ścieżce v2, gdzie „1,500" to raczej separator tysięcy niż 1,5. + */ +export function parseDecimal(text: string, comma = true): number { + const value = text.trim() + const pattern = comma ? /^(?:\d+(?:[.,]\d*)?|[.,]\d+)$/ : /^(?:\d+(?:\.\d*)?|\.\d+)$/ + return pattern.test(value) ? Number(value.replace(',', '.')) : NaN +} + +/** Dystans jednostki jako tekst: dystans startu dla startu, inaczej dystans sesji. */ +export const workoutKm = (workout: { raceDistanceKm?: number | undefined; distanceKm: number }): string => + kmLabel(shownKm(workout)) + +/** Dystans jednostki do pokazania: dystans startu dla startu (jego `distanceKm` to 0 km objętości). */ +export const shownKm = (workout: { raceDistanceKm?: number | undefined; distanceKm: number }): number => + workout.raceDistanceKm ?? workout.distanceKm + +/** Status wpisu dziennika słowem z katalogu; nieznany status (ręczna edycja log.jsonl) bez zmian. */ +export function logStatusText(status: unknown, strength = false): string { + const words: Record = strength ? ui().log.strengthStatusWord : ui().log.statusWord + if (typeof status !== 'string' || !status) return '?' + return Object.hasOwn(words, status) ? words[status]! : status +} diff --git a/packages/cli/src/i18n/cli-en.ts b/packages/cli/src/i18n/cli-en.ts index 703fe0e..43766cf 100644 --- a/packages/cli/src/i18n/cli-en.ts +++ b/packages/cli/src/i18n/cli-en.ts @@ -4,11 +4,14 @@ * tutaj jest wyłącznie to, co należy do warstwy CLI/MCP: nazwy komend, * nagłówki, podpowiedzi, komunikaty błędów i opisy narzędzi agenta. */ -import { formatNumber, pluralEn } from 'trainctl-core' +import { pluralEn } from 'trainctl-core' +import { numberIn } from './numbers.ts' import { improveEn } from './improve-en.ts' import { coachEn } from './coach-en.ts' -const n = (value: number) => formatNumber('en', value) +const n = numberIn('en') +/** „N days" — jedna odmiana dla status i review. */ +const dayCount = (days: number) => `${days} ${pluralEn(days, { one: 'day', other: 'days' })}` export const cliEn = { coach: coachEn, @@ -99,6 +102,11 @@ export const cliEn = { }, common: { + /** „N days" — liczba dni jako wartość pod etykietą (review). */ + dayCount, + /** Wiersz log.jsonl, którego nie da się odczytać. */ + logLine: (line: number) => `line ${line}`, + logBroken: (file: string, lines: string) => `${file}: cannot read ${lines}. Fix the file before changing the plan, so logged days stay protected.`, nextStep: (command: string) => `next step: ${command}`, saved: (what: string) => `Saved ${what}`, outsidePlan: (date: string, from: string, to: string) => @@ -178,7 +186,7 @@ export const cliEn = { goalConservative: (target: string) => `The goal of ${target} is conservative against the prediction.`, goalInRange: (target: string) => `The goal of ${target} sits inside the predicted range.`, structure: 'Structure', - phaseSpan: (phase: string, from: number, to: number) => `${phase}: weeks ${from}–${to}`, + phaseSpan: (phase: string, from: number, to: number) => from === to ? `${phase}: week ${from}` : `${phase}: weeks ${from}–${to}`, regenSection: 'What the regeneration changes', sameCycle: (start: string) => `Same training cycle: phases stay anchored to ${start}; future days follow trainctl.yaml.`, @@ -222,8 +230,8 @@ export const cliEn = { }, today: { - daysToRace: (days: number) => `${days} days to race`, - daysAfterRace: (days: number) => `${days} ${pluralEn(days, { one: 'day', other: 'days' })} after the race`, + daysToRace: (days: number) => `${dayCount(days)} to race`, + daysAfterRace: (days: number) => `${dayCount(days)} after the race`, weekOf: (index: number, total: number) => `week ${index}/${total}`, deload: 'deload', restDayTitle: 'Rest day', @@ -232,7 +240,8 @@ export const cliEn = { whyHint: (date: string) => `why this session: trainctl why --date ${date}`, strengthLogged: (status: string) => `Strength logged: ${status}`, estimate: (minutes: number) => `about ${minutes} min including preparation`, - next: (date: string, weekday: string, kind: string, km: number) => `next: ${weekday} ${date} · ${kind} · ${n(km)} km`, + /** `distance` już sformatowany (workoutKm): ta sama dokładność co w panelu dnia. */ + next: (date: string, weekday: string, kind: string, distance: string) => `next: ${weekday} ${date} · ${kind} · ${distance}`, strengthTitle: (minutes: number) => `Strength · ~${n(minutes)} min`, strengthAloneDay: 'No running today — a clean day for the gym (no clash with running).', strengthWithEasy: @@ -249,8 +258,9 @@ export const cliEn = { week: { title: (index: number, total: number, weekStart: string) => `Week ${index}/${total} · from ${weekStart}`, - subtitle: (phase: string, model: string, targetKm: number, plannedKm: number) => - `${phase} (${model}) · target ${n(targetKm)} km · planned ${n(plannedKm)} km`, + /** `plannedKm` pominięte, gdy suma dni równa się celowi — wtedy jedna liczba. */ + subtitle: (phase: string, model: string, targetKm: number, plannedKm?: number) => + plannedKm === undefined ? `${phase} (${model}) · ${n(targetKm)} km` : `${phase} (${model}) · target ${n(targetKm)} km · planned ${n(plannedKm)} km`, deloadUpper: 'DELOAD', columns: { day: 'day', date: 'date', km: 'km', workout: 'workout' }, rest: 'rest', @@ -265,6 +275,9 @@ export const cliEn = { badRpe: (rpe: string) => `RPE "${rpe}" is off the scale — use a whole number 1–10 (10 = maximal effort).`, saved: (date: string, status: string) => `Logged ${date}: ${status}.`, + statusWord: { done: 'done', skipped: 'skipped', modified: 'modified' } as Record<'done' | 'skipped' | 'modified', string>, + /** Siła ma własną odmianę (w polskim rodzaj żeński). */ + strengthStatusWord: { done: 'done', skipped: 'skipped', modified: 'modified' } as Record<'done' | 'skipped' | 'modified', string>, planned: 'Planned', recorded: 'Recorded', testTime: (time: string) => `test segment ${time}`, @@ -613,7 +626,8 @@ export const cliEn = { return remainingKm === totalKm ? `${n(totalKm)} km ${across}` : `${n(remainingKm)} of ${n(totalKm)} km left ${across}` }, toRace: 'To race day', - toRaceValue: (days: number) => `${days} days`, + sinceRace: 'Since the race', + columns: { planned: 'Plan', actual: 'Actual', status: 'Status' }, baseEnd: 'Base plan until', raceThisWeek: (date: string) => `Race this week: ${date} — the day before stays clear (T-10).`, @@ -772,7 +786,7 @@ export const cliEn = { plan: 'Plan', goal: 'Goal', toRace: 'To race day', - daysToRace: (days: number) => (days >= 0 ? `${days} ${pluralEn(days, { one: 'day', other: 'days' })}` : `${-days} ${pluralEn(-days, { one: 'day', other: 'days' })} ago`), + daysToRace: (days: number) => (days >= 0 ? dayCount(days) : `${dayCount(-days)} ago`), weeks: 'This cycle', weeksSessions: (weeks: number, sessions: number) => `${weeks} ${pluralEn(weeks, { one: 'week', other: 'weeks' })}, ${sessions} ${pluralEn(sessions, { one: 'session', other: 'sessions' })}`, generated: 'Phases anchored to', @@ -801,6 +815,7 @@ export const cliEn = { logValue: (entries: number, date: string, status: string) => `${entries} ${pluralEn(entries, { one: 'entry', other: 'entries' })}, last ${date} (${status})`, unconfirmed: (dates: string) => `Unconfirmed sessions this week: ${dates} — trainctl log or trainctl pull.`, + logDropped: (file: string, items: string) => `${file}: values outside the limits of trainctl log were ignored (${items}). Fix the line or log the session again.`, proposals: 'Proposals', columns: { id: 'id', kind: 'kind', for: 'for', state: 'state', changes: 'changes' }, state: { @@ -1021,6 +1036,7 @@ export const cliEn = { 'R-9': 'strength returns in the second week after the race, one lighter session — an engineering choice, no source', 'R-10': 'after a shorter goal race, one transition week at ~70% — an engineering choice; no data behind it', 'P-11': 'a plan without a race grows to your documented peak (or +15%) and levels off there, deload every fourth week — an engineering choice', + 'E-3': 'fixed engine values without a source: peak cap +40% without peakWeeklyKm, race-plan peak +15%, phase split 40/20%, accent main set ~22% of the week and at least 3 km, easy run 5–18 km, 5–8 km easy before hills, hard km ≤25%, recoveries 2–3 min, race-week sessions, one session ≤35% of the week (shape check) — engineering choices to confirm by measurement or coach review', 'E-2': 'the time budget from trainctl.yaml caps weekly volume and shortens sessions with the same rules as E-1 — an engineering choice, no source', 'Z-10': 'a trail result does not calibrate road zones while a road result exists — an engineering choice; VDOT tables come from road and track', }, diff --git a/packages/cli/src/i18n/cli-i18n.test.ts b/packages/cli/src/i18n/cli-i18n.test.ts index fa71065..c9acd17 100644 --- a/packages/cli/src/i18n/cli-i18n.test.ts +++ b/packages/cli/src/i18n/cli-i18n.test.ts @@ -100,6 +100,8 @@ describe('polski nie jest kalką', () => { 'status.columns.id', 'status.git', 'status.plan', + 'review.columns.planned', + 'review.columns.status', ].sort(), ) }) @@ -139,7 +141,7 @@ describe('reguły i cele jednostek', () => { it('każde objaśnienie cytuje źródło albo korpus', () => { // Reguły inżynierskie bez bezpośredniego źródła — wymienione jawnie, żeby // dopisanie kolejnej wymagało świadomej decyzji, nie przeoczenia. - const withoutSource = ['T-9', 'T-12', 'W-13', 'F-18', 'Z-10', 'E-2', 'R-9', 'R-10', 'P-11'] + const withoutSource = ['T-9', 'T-12', 'W-13', 'F-18', 'Z-10', 'E-2', 'E-3', 'R-9', 'R-10', 'P-11'] // rok publikacji, odwołanie do korpusu albo nazwisko (Daniels & Gilbert, bez roku) const cites = /(19|20)\d{2}|korpus|corpus|Daniels/ for (const catalog of [cliEn.rules, cliPl.rules]) { diff --git a/packages/cli/src/i18n/cli-pl.ts b/packages/cli/src/i18n/cli-pl.ts index 23ada83..9455fcb 100644 --- a/packages/cli/src/i18n/cli-pl.ts +++ b/packages/cli/src/i18n/cli-pl.ts @@ -7,10 +7,11 @@ * - cudzysłowy drukarskie „…", półpauza — w zdaniu, dywiz w złożeniach, * - tryb rozkazujący w podpowiedziach („uruchom", „dopisz"), bo tak mówi trener. */ -import { formatNumber, pluralPl } from 'trainctl-core' +import { pluralPl } from 'trainctl-core' +import { numberIn } from './numbers.ts' import type { CliMessages } from './cli-en.ts' -const n = (value: number) => formatNumber('pl', value) +const n = numberIn('pl') const plik = (count: number) => `${count} ${pluralPl(count, { one: 'plik', few: 'pliki', other: 'plików' })}` const dni = (count: number) => @@ -113,6 +114,9 @@ export const cliPl: CliMessages = { }, common: { + dayCount: dni, + logLine: (line: number) => `wiersz ${line}`, + logBroken: (file: string, lines: string) => `${file}: nie da się odczytać (${lines}). Popraw plik przed zmianą planu, żeby zalogowane dni zostały chronione.`, nextStep: (command: string) => `następny krok: ${command}`, saved: (what: string) => `Zapisano ${what}`, outsidePlan: (date: string, from: string, to: string) => @@ -191,7 +195,7 @@ export const cliPl: CliMessages = { goalConservative: (target: string) => `Cel ${target} jest zachowawczy względem predykcji.`, goalInRange: (target: string) => `Cel ${target} mieści się w przedziale predykcji.`, structure: 'Struktura', - phaseSpan: (phase: string, from: number, to: number) => `${phase}: tyg. ${from}–${to}`, + phaseSpan: (phase: string, from: number, to: number) => from === to ? `${phase}: tyg. ${from}` : `${phase}: tyg. ${from}–${to}`, regenSection: 'Co zmienia regeneracja', sameCycle: (start: string) => `Ten sam cykl treningowy: fazy zostają zakotwiczone w ${start}; przyszłe dni idą za trainctl.yaml.`, @@ -245,7 +249,7 @@ export const cliPl: CliMessages = { whyHint: (date: string) => `dlaczego ten trening: trainctl why --date ${date}`, strengthLogged: (status: string) => `Siła zalogowana: ${status}`, estimate: (minutes: number) => `około ${minutes} min razem z przygotowaniem`, - next: (date: string, weekday: string, kind: string, km: number) => `następny: ${weekday} ${date} · ${kind} · ${n(km)} km`, + next: (date: string, weekday: string, kind: string, distance: string) => `następny: ${weekday} ${date} · ${kind} · ${distance}`, strengthTitle: (minutes: number) => `Siła · ~${n(minutes)} min`, strengthAloneDay: 'Dzień bez biegania — idealny na siłownię (zero konfliktu z sesjami biegowymi).', strengthWithEasy: @@ -262,8 +266,8 @@ export const cliPl: CliMessages = { week: { title: (index: number, total: number, weekStart: string) => `Tydzień ${index}/${total} · od ${weekStart}`, - subtitle: (phase: string, model: string, targetKm: number, plannedKm: number) => - `${phase} (${model}) · cel ${n(targetKm)} km · zaplanowano ${n(plannedKm)} km`, + subtitle: (phase: string, model: string, targetKm: number, plannedKm?: number) => + plannedKm === undefined ? `${phase} (${model}) · ${n(targetKm)} km` : `${phase} (${model}) · cel ${n(targetKm)} km · zaplanowano ${n(plannedKm)} km`, deloadUpper: 'ODCIĄŻENIE', columns: { day: 'dzień', date: 'data', km: 'km', workout: 'trening' }, rest: 'wolne', @@ -278,6 +282,8 @@ export const cliPl: CliMessages = { badRpe: (rpe: string) => `RPE „${rpe}” wypada poza skalę — podaj liczbę całkowitą 1–10 (10 = wysiłek maksymalny).`, saved: (date: string, status: string) => `Zalogowano ${date}: ${status}.`, + statusWord: { done: 'wykonany', skipped: 'opuszczony', modified: 'zmieniony' }, + strengthStatusWord: { done: 'wykonana', skipped: 'opuszczona', modified: 'zmieniona' }, planned: 'W planie', recorded: 'Zapis', testTime: (time: string) => `odcinek pomiarowy ${time}`, @@ -633,9 +639,9 @@ export const cliPl: CliMessages = { return remainingKm === totalKm ? `${n(totalKm)} km ${w}` : `zostało ${n(remainingKm)} z ${n(totalKm)} km ${w}` }, toRace: 'Do startu', + sinceRace: 'Od startu', + columns: { planned: 'Plan', actual: 'Wykonanie', status: 'Status' }, baseEnd: 'Plan bazowy do', - toRaceValue: (days: number) => - `${days} ${pluralPl(days, { one: 'dzień', few: 'dni', other: 'dni' })}`, raceThisWeek: (date: string) => `Start w tym tygodniu: ${date} — dzień przed zostaje wolny (T-10).`, timeTrialThisWeek: (date: string) => @@ -825,6 +831,7 @@ export const cliPl: CliMessages = { logValue: (entries: number, date: string, status: string) => `${entries} ${pluralPl(entries, { one: 'wpis', few: 'wpisy', other: 'wpisów' })}, ostatni ${date} (${status})`, unconfirmed: (dates: string) => `Niepotwierdzone sesje w tym tygodniu: ${dates} — trainctl log albo trainctl pull.`, + logDropped: (file: string, items: string) => `${file}: pominięto wartości spoza granic trainctl log (${items}). Popraw wiersz albo zaloguj sesję ponownie.`, proposals: 'Propozycje', columns: { id: 'id', kind: 'rodzaj', for: 'dla', state: 'stan', changes: 'zmiany' }, state: { @@ -1041,6 +1048,7 @@ export const cliPl: CliMessages = { 'R-9': 'siła wraca w drugim tygodniu po starcie, jedną lżejszą sesją — wybór inżynierski, bez źródła', 'R-10': 'po krótszym starcie docelowym jeden tydzień przejściowy ~70% — wybór inżynierski; brak danych', 'P-11': 'plan bez startu rośnie do udokumentowanego szczytu (albo +15%) i tam się wypłaszcza, odciążenie co czwarty tydzień — wybór inżynierski', + 'E-3': 'stałe silnika bez źródła: sufit +40% bez peakWeeklyKm, szczyt planu ze startem +15%, podział faz 40/20%, część główna akcentu ~22% tygodnia i co najmniej 3 km, bieg spokojny 5–18 km, 5–8 km spokojnie przed podbiegami, mocne km ≤25%, przerwy 2–3 min, sesje tygodnia startowego, jedna jednostka ≤35% tygodnia (lint kształtu) — wybory inżynierskie do potwierdzenia pomiarem albo przeglądem trenerskim', 'E-2': 'budżet czasu z trainctl.yaml ogranicza objętość tygodnia i skraca jednostki według zasad E-1 — wybór inżynierski, bez źródła', 'Z-10': 'wynik z trailu nie kalibruje stref szosowych, dopóki jest wynik szosowy — wybór inżynierski; tabele VDOT pochodzą z szosy i bieżni', 'S-5': 'ciężka siła nie później niż 24 h przed sesją jakościową — deficyt siły trwa do 48 h (de Carvalho e Silva 2022)', diff --git a/packages/cli/src/i18n/coach-en.ts b/packages/cli/src/i18n/coach-en.ts index d8ecad4..702b4ac 100644 --- a/packages/cli/src/i18n/coach-en.ts +++ b/packages/cli/src/i18n/coach-en.ts @@ -1,3 +1,9 @@ +import { numberIn } from './numbers.ts' + +const n = numberIn('en') +/** Dawka jednostki dokładnie (0,25 km przebieżek, 10,25 km przed skróceniem): do 2 miejsc. */ +const n2 = numberIn('en', 2) + export const coachEn = { shorten: 'fit a session into your available time; save a proposal for approval', shortenMcp: 'Use when the runner has limited time, e.g. 40 minutes today. Call with minutes and optional date to save a proposal without changing the plan. Show the before/after, time accounting, lost purpose and warnings. After approval call trainctl_adapt with apply=the saved ID. Do not regenerate or sync between preview and approval.', @@ -17,21 +23,21 @@ export const coachEn = { applyHint: (id: string) => `Review this proposal, then approve exactly these changes: trainctl adapt --apply ${id}`, heuristic: 'E-1: engineering choices: retain at least half of quality work, 60% of a long run, the original preparation before hills, and at least 15 min for an easy replacement. These cutoffs do not establish physiological equivalence.', context: 'How this session fits your plan', - goal: (name: string, distance: number, date: string, days: number) => `Goal: ${name}, ${distance} km on ${date}; ${days} days from this session.`, - goalBehind: (name: string, distance: number, date: string, days: number) => `Goal behind you: ${name}, ${distance} km on ${date}; this session is ${days} days after it.`, + goal: (name: string, distance: number, date: string, days: number) => `Goal: ${name}, ${n(distance)} km on ${date}; ${days} days from this session.`, + goalBehind: (name: string, distance: number, date: string, days: number) => `Goal behind you: ${name}, ${n(distance)} km on ${date}; this session is ${days} days after it.`, goalBase: (name: string, date: string) => `Goal: ${name} — base training without a race, until ${date} (P-11).`, - weekContext: (phase: string, actual: number, target: number, share: number) => `Phase: ${phase}. Week: ${actual} km against a ${target} km target; ${share}% easy running.`, + weekContext: (phase: string, actual: number, target: number, share: number) => `Phase: ${phase}. Week: ${n(actual)} km against a ${n(target)} km target; ${share}% easy running.`, deload: 'This is a reduced-volume week in the stored plan.', taper: 'The stored taper reduces volume while aiming to retain intensity and session frequency.', dose: 'The actual prescription', - segment: (description: string, km: number, pace: string) => `${description} · ${km} km${pace ? ` · ${pace}/km` : ''}`, + segment: (description: string, km: number, pace: string) => `${description} · ${n2(km)} km${pace ? ` · ${pace}/km` : ''}`, previous: (date: string, kind: string, days: number) => `Previous demanding session: ${date}, ${kind}, ${days} calendar days earlier.`, next: (date: string, kind: string, days: number) => `Next demanding session: ${date}, ${kind}, ${days} calendar days later.`, tightSpacing: 'Demanding sessions are on adjacent dates. Review the spacing; exact hours are not stored.', noNeighbors: 'No other demanding session appears in the stored plan around this date.', restPurpose: 'There is no run on this date; the calendar leaves room between training sessions.', changedManually: 'This day differs from its generated version. The explanation describes its current role; it cannot reconstruct the reason for a manual edit.', - adjusted: (kind: string, km: number, minutes: number) => `Approved time adjustment from ${kind}, ${km} km; original time budget: ${minutes} min.`, + adjusted: (kind: string, km: number, minutes: number) => `Approved time adjustment from ${kind}, ${n2(km)} km; original time budget: ${minutes} min.`, execution: (status: string) => `Recorded execution: ${status}.`, status: { done: 'completed', missed: 'explicitly skipped', unknown: 'unconfirmed', rest: 'rest', unplanned: 'unplanned run', planned: 'planned' }, reviewPrepare: 'include a concrete plan proposal for approval; keep the current plan unchanged', diff --git a/packages/cli/src/i18n/coach-pl.ts b/packages/cli/src/i18n/coach-pl.ts index f843177..c88ec5f 100644 --- a/packages/cli/src/i18n/coach-pl.ts +++ b/packages/cli/src/i18n/coach-pl.ts @@ -1,4 +1,9 @@ +import { numberIn } from './numbers.ts' import type { coachEn } from './coach-en.ts' + +const n = numberIn('pl') +/** Dawka jednostki dokładnie (0,25 km przebieżek, 10,25 km przed skróceniem): do 2 miejsc. */ +const n2 = numberIn('pl', 2) export const coachPl: typeof coachEn = { shorten: 'dopasuj trening do dostępnego czasu; zapisz propozycję do zatwierdzenia', shortenMcp: 'Użyj, gdy biegacz ma mało czasu, np. dziś tylko 40 minut. Wywołaj z minutes i opcjonalnym date, aby zapisać propozycję bez zmiany planu. Pokaż przed/po, podział czasu, utracony cel i ostrzeżenia. Po zatwierdzeniu wywołaj trainctl_adapt z apply równym zapisanemu ID. Nie regeneruj ani nie synchronizuj między podglądem a zatwierdzeniem.', @@ -18,21 +23,21 @@ export const coachPl: typeof coachEn = { applyHint: (id: string) => `Przejrzyj propozycję, następnie zatwierdź dokładnie te zmiany: trainctl adapt --apply ${id}`, heuristic: 'E-1: wybory inżynierskie: zachowujemy co najmniej połowę pracy jakościowej, 60% długiego biegu, pierwotne wprowadzenie przed podbiegami i co najmniej 15 min spokojnego zamiennika. Te progi nie dowodzą równoważności fizjologicznej.', context: 'Miejsce tej jednostki w Twoim planie', - goalBehind: (name: string, distance: number, date: string, days: number) => `Cel za Tobą: ${name}, ${distance} km dnia ${date}; ta jednostka wypada ${days} dni po nim.`, + goalBehind: (name: string, distance: number, date: string, days: number) => `Cel za Tobą: ${name}, ${n(distance)} km dnia ${date}; ta jednostka wypada ${days} dni po nim.`, goalBase: (name: string, date: string) => `Cel: ${name} — budowanie bazy bez startu, do ${date} (P-11).`, - goal: (name: string, distance: number, date: string, days: number) => `Cel: ${name}, ${distance} km, ${date}; od tej jednostki pozostaje ${days} dni.`, - weekContext: (phase: string, actual: number, target: number, share: number) => `Faza: ${phase}. Tydzień: ${actual} km przy celu ${target} km; ${share}% spokojnego biegania.`, + goal: (name: string, distance: number, date: string, days: number) => `Cel: ${name}, ${n(distance)} km, ${date}; od tej jednostki pozostaje ${days} dni.`, + weekContext: (phase: string, actual: number, target: number, share: number) => `Faza: ${phase}. Tydzień: ${n(actual)} km przy celu ${n(target)} km; ${share}% spokojnego biegania.`, deload: 'W zapisanym planie ten tydzień ma obniżoną objętość.', taper: 'Zapisany taper zmniejsza objętość przy założeniu utrzymania intensywności i częstotliwości sesji.', dose: 'Konkretna dawka treningu', - segment: (description: string, km: number, pace: string) => `${description} · ${km} km${pace ? ` · ${pace}/km` : ''}`, + segment: (description: string, km: number, pace: string) => `${description} · ${n2(km)} km${pace ? ` · ${pace}/km` : ''}`, previous: (date: string, kind: string, days: number) => `Poprzednia wymagająca jednostka: ${date}, ${kind}, ${days} dni kalendarzowych wcześniej.`, next: (date: string, kind: string, days: number) => `Następna wymagająca jednostka: ${date}, ${kind}, ${days} dni kalendarzowych później.`, tightSpacing: 'Wymagające jednostki przypadają dzień po dniu. Sprawdź odstęp; dokładne godziny nie są zapisane.', noNeighbors: 'W otoczeniu tej daty nie ma innych wymagających jednostek w zapisanym planie.', restPurpose: 'Tego dnia nie ma biegu; kalendarz pozostawia odstęp pomiędzy jednostkami treningowymi.', changedManually: 'Ten dzień różni się od wersji wygenerowanej. Wyjaśnienie opisuje jego obecną rolę; nie odtwarza powodu ręcznej edycji.', - adjusted: (kind: string, km: number, minutes: number) => `Zatwierdzona zmiana czasu: pierwotnie ${kind}, ${km} km; pierwotny budżet czasu: ${minutes} min.`, + adjusted: (kind: string, km: number, minutes: number) => `Zatwierdzona zmiana czasu: pierwotnie ${kind}, ${n2(km)} km; pierwotny budżet czasu: ${minutes} min.`, execution: (status: string) => `Zapis wykonania: ${status}.`, status: { done: 'wykonany', missed: 'jawnie opuszczony', unknown: 'niepotwierdzony', rest: 'odpoczynek', unplanned: 'bieg poza planem', planned: 'zaplanowany' }, reviewPrepare: 'dołącz konkretną propozycję zmian do zatwierdzenia; zachowaj obecny plan', diff --git a/packages/cli/src/i18n/improve-en.ts b/packages/cli/src/i18n/improve-en.ts index b74f2af..a3f2dc4 100644 --- a/packages/cli/src/i18n/improve-en.ts +++ b/packages/cli/src/i18n/improve-en.ts @@ -1,13 +1,18 @@ +import { numberIn } from './numbers.ts' + +const n = numberIn('en') + export const improveEn = { expiredProposal: 'This proposal has expired. Prepare and review a new proposal today.', pastWrite: 'Past or recorded days cannot be changed.', pinnedShift: 'Unpin the day explicitly before moving its workout.', badDistance: 'Distance must be a finite, non-negative number.', + distanceTooSmall: 'A distance below 0.1 m cannot be recorded. Enter at least 0.0001 km, or 0.', skippedMetrics: 'A skipped session cannot have a distance or duration.', testTime: 'time of the measured test/race segment, excluding warmup and cooldown', testTimeOnly: 'Record a test time only for a completed test or race; it cannot exceed session time.', unknownDuration: 'Race duration is unknown; set a target time to estimate it.', - targetMismatch: (date: string, expected: number, actual: number) => `Week ${date}: target ${expected} km, scheduled ${actual} km.`, + targetMismatch: (date: string, expected: number, actual: number) => `Week ${date}: target ${n(expected)} km, scheduled ${n(actual)} km.`, frequencyMismatch: (date: string, expected: number, actual: number) => `${date}: requested frequency ${expected}, scheduled sessions ${actual}.`, diagnosis: 'Diagnosis', proposals: 'Proposals', prepare: 'save a concrete adaptation proposal for review', @@ -29,7 +34,12 @@ export const improveEn = { calibration: 'Zone calibration', calibrationPolicy: 'Policy: highest VDOT among non-excluded results from the past 540 days. This is a selection heuristic, not a measure of confidence.', calibrationMissing: 'This older plan does not record which results calibrated its zones.', - selected: 'Used for zones', 'lower-vdot': 'Lower VDOT', excluded: 'Excluded by you', future: 'Future result', stale: 'Older than 540 days', + selected: 'Used for zones', 'lower-vdot': 'Lower VDOT', excluded: 'Excluded by you', future: 'After the calibration date', stale: 'Older than 540 days on the calibration date', + calibratedOn: (date: string) => `Plan zones calibrated on ${date}: the notes below are that day's decisions; ages count from today.`, + recalibrateTo: (date: string, km: string) => `Today trainctl plan would calibrate the zones from the ${date} result (${km}). Run trainctl plan to update the plan.`, + recalibrateUnknown: 'trainctl.yaml cannot be read, so there is no check whether trainctl plan would recalibrate the zones (see trainctl status).', + recalibrateGoal: (time: string) => `No result meets the policy today, so trainctl plan would calibrate the zones from the goal time ${time}. Add a recent result to athlete.results.`, + recalibrateNone: 'No result meets the policy today and the goal has no target time, so trainctl plan would stop until a result is added to athlete.results.', age: (days: number) => `${days} days old`, unclassified: 'See the source rule; provenance not classified', terrain: 'Trail result — not used for road zones (Z-10)', @@ -41,7 +51,6 @@ export const improveEn = { mobilePurpose: 'Purpose', mobileSteps: 'Your session', mobileWhy: 'Why this session', mobileSnapshot: 'Saved snapshot of the plan. Export again after changing it.', mobileRest: 'Rest day', mobileStrength: 'Strength', - data: 'Execution data', dataStatus: (status: string, unknown: number) => `Coverage: ${status}; sessions without records: ${unknown}.`, syncedAt: (date: string) => `Last synchronization: ${date}. Missing records remain unconfirmed.`, proposalOptions: 'Use either --prepare or --apply ID.', diff --git a/packages/cli/src/i18n/improve-pl.ts b/packages/cli/src/i18n/improve-pl.ts index b19a4fa..1b8f121 100644 --- a/packages/cli/src/i18n/improve-pl.ts +++ b/packages/cli/src/i18n/improve-pl.ts @@ -1,14 +1,18 @@ +import { numberIn } from './numbers.ts' import type { improveEn } from './improve-en.ts' + +const n = numberIn('pl') export const improvePl: typeof improveEn = { expiredProposal: 'Propozycja wygasła. Przygotuj i przejrzyj nową propozycję dzisiaj.', pastWrite: 'Nie można zmieniać dni przeszłych lub zapisanych w dzienniku.', pinnedShift: 'Przed przesunięciem jawnie odblokuj przypięty dzień.', badDistance: 'Dystans musi być skończoną liczbą nieujemną.', + distanceTooSmall: 'Dystansu poniżej 0,1 m nie da się zapisać. Podaj co najmniej 0,0001 km albo 0.', skippedMetrics: 'Opuszczony trening nie może mieć dystansu ani czasu wykonania.', testTime: 'czas samego sprawdzianu lub startu, bez rozgrzewki i schłodzenia', testTimeOnly: 'Czas pomiaru dotyczy wykonanego testu lub startu i nie może przekraczać czasu całej sesji.', unknownDuration: 'Czas startu nieznany; podaj cel czasowy, aby uzyskać szacunek.', - targetMismatch: (date: string, expected: number, actual: number) => `Tydzień ${date}: cel ${expected} km, rozpisano ${actual} km.`, + targetMismatch: (date: string, expected: number, actual: number) => `Tydzień ${date}: cel ${n(expected)} km, rozpisano ${n(actual)} km.`, frequencyMismatch: (date: string, expected: number, actual: number) => `${date}: zadana częstotliwość ${expected}, rozpisane sesje ${actual}.`, diagnosis: 'Diagnoza', proposals: 'Propozycje', prepare: 'zapisz konkretną propozycję adaptacji do przejrzenia', @@ -30,7 +34,12 @@ export const improvePl: typeof improveEn = { calibration: 'Kalibracja stref', calibrationPolicy: 'Zasada: najwyższy VDOT z niewykluczonych wyników z ostatnich 540 dni. To heurystyka wyboru, nie miara pewności.', calibrationMissing: 'Ten starszy plan nie zapisuje wyników użytych do kalibracji stref.', - selected: 'Użyty do stref', 'lower-vdot': 'Niższy VDOT', excluded: 'Wykluczony przez Ciebie', future: 'Wynik z przyszłości', stale: 'Starszy niż 540 dni', + selected: 'Użyty do stref', 'lower-vdot': 'Niższy VDOT', excluded: 'Wykluczony przez Ciebie', future: 'Późniejszy niż dzień kalibracji', stale: 'Starszy niż 540 dni w dniu kalibracji', + calibratedOn: (date: string) => `Strefy planu skalibrowano ${date}: opisy poniżej to decyzje z tego dnia, wiek liczony od dziś.`, + recalibrateTo: (date: string, km: string) => `Dziś trainctl plan skalibrowałby strefy z wyniku z ${date} (${km}). Uruchom trainctl plan, aby zaktualizować plan.`, + recalibrateUnknown: 'Nie da się odczytać trainctl.yaml, więc nie wiadomo, czy trainctl plan skalibrowałby strefy inaczej (zobacz trainctl status).', + recalibrateGoal: (time: string) => `Dziś żaden wynik nie spełnia zasady wyboru, więc trainctl plan skalibrowałby strefy z czasu docelowego ${time}. Dopisz świeży wynik do athlete.results.`, + recalibrateNone: 'Dziś żaden wynik nie spełnia zasady wyboru, a cel nie ma czasu docelowego — trainctl plan zatrzyma się, dopóki nie dopiszesz wyniku do athlete.results.', age: (days: number) => `sprzed ${days} dni`, unclassified: 'Sprawdź regułę źródłową; pochodzenie niesklasyfikowane', terrain: 'Wynik z trailu — nie kalibruje stref szosowych (Z-10)', @@ -42,7 +51,6 @@ export const improvePl: typeof improveEn = { mobilePurpose: 'Cel', mobileSteps: 'Twój trening', mobileWhy: 'Dlaczego ta jednostka', mobileSnapshot: 'Zapisana kopia planu. Po zmianach wyeksportuj ponownie.', mobileRest: 'Dzień wolny', mobileStrength: 'Siła', - data: 'Dane wykonania', dataStatus: (status: string, unknown: number) => 'Kompletność: ' + (({ complete: 'pełne', incomplete: 'niepełne', empty: 'brak danych' } as Record)[status] ?? status) + '; sesje bez danych: ' + unknown + '.', syncedAt: (date: string) => `Ostatnia synchronizacja: ${date}. Brakujące wpisy pozostają niepotwierdzone.`, proposalOptions: 'Użyj albo --prepare, albo --apply ID.', diff --git a/packages/cli/src/i18n/numbers.ts b/packages/cli/src/i18n/numbers.ts new file mode 100644 index 0000000..f4cd61d --- /dev/null +++ b/packages/cli/src/i18n/numbers.ts @@ -0,0 +1,4 @@ +import { formatNumber, type Locale } from 'trainctl-core' + +/** Liczby w katalogach tekstów: jeden format na język (przecinek po polsku), jedna definicja. */ +export const numberIn = (locale: Locale, maxDecimals = 1) => (value: number): string => formatNumber(locale, value, maxDecimals) diff --git a/packages/cli/src/interactive.ts b/packages/cli/src/interactive.ts index 8ee1fdf..242ecdb 100644 --- a/packages/cli/src/interactive.ts +++ b/packages/cli/src/interactive.ts @@ -5,10 +5,11 @@ */ import { emitKeypressEvents } from 'node:readline' import { createInterface } from 'node:readline/promises' -import { addDays, messages, type Microcycle, type PlannedDay } from 'trainctl-core' +import { addDays, formatNumber, getLocale, messages, type Microcycle, type PlannedDay } from 'trainctl-core' import { cmdLog, cmdShift, cmdWeek, kindLabel } from './commands.ts' import { ui } from './i18n/index.ts' -import { parseTime, readLog } from './logfile.ts' +import { kmLabel, logStatusText, parseDecimal, shownKm, workoutKm } from './format.ts' +import { latestByDate, LOG_LIMITS, parseTime, readLog } from './logfile.ts' import { findDay, loadPlan, workoutText, type StoredPlan } from './planfile.ts' import { renderAnsi } from './ui/blocks.ts' import { clampIndex, keyAction, type KeyEvent } from './ui/keys.ts' @@ -24,7 +25,7 @@ export function dayChoices(week: Microcycle, exclude?: string): Choice[] const isRace = day.workout?.kind === 'race' const label = `${messages().weekdayShort[day.weekday]} ${day.date.slice(5)}` const what = day.workout - ? `${day.workout.distanceKm} km · ${workoutText(day)}` + ? `${workoutKm(day.workout)} · ${workoutText(day)}` : ui().week.rest return { label, @@ -87,7 +88,7 @@ export async function runShiftPicker( } /** Ostatnie siedem dni planu, od dziś wstecz — wybór przy `trainctl log` bez flag. */ -export function logChoices(plan: StoredPlan, today: string, logged: Map): Choice[] { +export function logChoices(plan: StoredPlan, today: string, logged: Map): Choice[] { const from = addDays(today, -6) return plan.weeks .flatMap((w) => w.days) @@ -97,8 +98,8 @@ export function logChoices(plan: StoredPlan, today: string, logged: Map { - const value = Number(text.trim().replace(',', '.')) - if (!Number.isFinite(value) || value < 0) throw new Error(ui().improve.badDistance) - return String(value) +export const parseKmText = (text: string): string => { + const value = parseDecimal(text) + if (!LOG_LIMITS.km(value)) throw new Error(ui().improve.badDistance) + // tekst, nie String(value): bardzo mała liczba dałaby „1e-7", którego parser nie przyjmie + return text.trim() } const parseTimeText = (text: string): string => { parseTime(text.trim()) return text.trim() } -const parseRpeText = (text: string): string => { - const value = Number(text.trim()) - if (!Number.isInteger(value) || value < 1 || value > 10) throw new Error(ui().log.badRpe(text)) - return String(value) +export const parseRpeText = (text: string): string => { + const value = parseDecimal(text) + if (!LOG_LIMITS.rpe(value)) throw new Error(ui().log.badRpe(text)) + return text.trim() } +/** + * Podpowiadany dystans w kreatorze dziennika: dystans jednostki (startu dla startu) + * w formacie języka, z pełną dokładnością („21,0975"), żeby Enter zapisał dokładnie + * zaplanowaną wartość — parseDecimal przyjmuje przecinek. + */ +export const plannedKmDefault = (day: PlannedDay): string | undefined => + day.workout ? formatNumber(getLocale(), shownKm(day.workout), 4) : undefined + /** * `trainctl log` bez flag w terminalu: wybierz trening z ostatniego tygodnia * i odpowiedz na kilka pytań (Enter = wartość z planu albo pominięcie). @@ -141,7 +151,7 @@ export async function runLogPrompt(cwd: string, today: string, theme = new Theme return { code: 1, output: e instanceof Error ? e.message : String(e) } } const q = ui().log.prompt - const logged = new Map(readLog(cwd).map((e) => [e.date, e.status] as const)) + const logged = latestByDate(readLog(cwd)) const choices = logChoices(plan, today, logged) if (choices.length === 0) return { code: 1, output: ui().log.outsidePlan(today) } const date = await select(q.which, choices, theme) @@ -153,7 +163,7 @@ export async function runLogPrompt(cwd: string, today: string, theme = new Theme const status = await ask(rl, theme, q.status, parseLogStatus, { hint: q.statusHint, default: 'done' }) opts.status = status ?? 'done' if (opts.status !== 'skipped') { - const planned = day.workout ? String(day.workout.raceDistanceKm ?? day.workout.distanceKm) : undefined + const planned = plannedKmDefault(day) opts.km = await ask(rl, theme, q.km, parseKmText, planned ? { default: planned } : { optional: true }) opts.time = await ask(rl, theme, q.time, parseTimeText, { hint: q.timeHint, optional: true }) if (['test', 'race'].includes(day.workout?.kind ?? '')) { diff --git a/packages/cli/src/logfile.ts b/packages/cli/src/logfile.ts index c2f0626..b42543f 100644 --- a/packages/cli/src/logfile.ts +++ b/packages/cli/src/logfile.ts @@ -1,7 +1,8 @@ /** Dziennik wykonania: log.jsonl — jedna linia JSON na wpis (append-only). */ -import { appendFileSync, existsSync, readFileSync } from 'node:fs' +import { appendFileSync, closeSync, existsSync, openSync, readFileSync, readSync, statSync } from 'node:fs' import { join } from 'node:path' import { ui } from './i18n/index.ts' +import { parseDecimal } from './format.ts' export const LOG_FILE = 'log.jsonl' @@ -35,36 +36,148 @@ export interface StrengthLogEntry { loggedAt: string } +/** + * Separator przed nowym wierszem JSONL: ręczna edycja bez końcowego znaku nowej + * linii skleiłaby nowy wpis z ostatnim. Jedna reguła dla obu zapisów dziennika + * (`appendLog` tutaj, wpisy sesji v2 w sports-commands.ts). + */ +export const lineSeparator = (tail: string): string => (tail !== '' && !tail.endsWith('\n') ? '\n' : '') + export function appendLog(cwd: string, entry: LogEntry | StrengthLogEntry): void { - appendFileSync(join(cwd, LOG_FILE), JSON.stringify(entry) + '\n', 'utf-8') + const path = join(cwd, LOG_FILE) + appendFileSync(path, lineSeparator(lastChar(path)) + JSON.stringify(entry) + '\n', 'utf-8') +} + +/** Ostatni znak pliku bez czytania całości (dziennik rośnie); brak pliku to ''. */ +function lastChar(path: string): string { + try { + const size = statSync(path).size + if (size === 0) return '' + const fd = openSync(path, 'r') + try { + const last = Buffer.alloc(1) + readSync(fd, last, 0, 1, size - 1) + return last.toString('latin1') + } finally { closeSync(fd) } + } catch { + return '' + } +} + +/** Ostatni wpis każdej daty — późniejszy nadpisuje wcześniejszy; jedna reguła dla wszystkich widoków. */ +export function latestByDate(entries: T[]): Map { + return new Map(entries.map((e) => [e.date, e])) } -function readAll(cwd: string): (LogEntry | StrengthLogEntry)[] { +function readAll(cwd: string, dropped: string[] = [], broken: string[] = []): (LogEntry | StrengthLogEntry)[] { const path = join(cwd, LOG_FILE) if (!existsSync(path)) return [] - return readFileSync(path, 'utf-8') - .split('\n') - .filter((l) => l.trim()) - .map((l) => JSON.parse(l) as LogEntry | StrengthLogEntry) + // Ręczna edycja bywa niedokończona: wiersz, który nie jest obiektem JSON, pomijamy + // i zgłaszamy („wiersz N"), zamiast wywracać każdą komendę czytającą dziennik. + return readFileSync(path, 'utf-8').split('\n').flatMap((line, index) => { + if (!line.trim()) return [] + const parsed = parseLine(line) + if (!parsed) { broken.push(ui().common.logLine(index + 1)); return [] } + return [normalize(parsed, dropped)] + }) +} + +function parseLine(line: string): Record | undefined { + try { + const value: unknown = JSON.parse(line) + return value !== null && typeof value === 'object' && !Array.isArray(value) && typeof (value as { date?: unknown }).date === 'string' + ? value as Record : undefined + } catch { + return undefined + } +} + +/** Czas wpisany tak, jak przyjmuje go CLI („58:30"), albo liczba tekstem, także z przecinkiem („8,5"). */ +function fromText(key: string, text: string): number { + if (key.endsWith('Sec') && text.includes(':')) { + try { return parseTime(text.trim()) } catch { return NaN } + } + return parseDecimal(text) +} + +/** + * Granice wartości dziennika — jedne dla `trainctl log` (walidacja wejścia) i dla + * odczytu ręcznie edytowanego log.jsonl. RPE całkowite 1–10 (CR-10 bez zera, P-6), + * minuty siły całkowite 1–300, dystans 0–500 km, czasy dodatnie. + */ +const positiveSeconds = (v: number): boolean => Number.isFinite(v) && v > 0 +/** 500 km (inż.): sufit literówki („8500" zamiast „8.5"), z zapasem dla ultra. */ +export const LOG_KM_MAX = 500 + +export const LOG_LIMITS = { + km: (v: number): boolean => Number.isFinite(v) && v >= 0 && v <= LOG_KM_MAX, + timeSec: positiveSeconds, + testTimeSec: positiveSeconds, + rpe: (v: number): boolean => Number.isInteger(v) && v >= 1 && v <= 10, + minutes: (v: number): boolean => Number.isInteger(v) && v >= 1 && v <= 300, +} + +/** + * log.jsonl bywa edytowany ręcznie. Liczby zapisane tekstem („8") zamieniamy na + * liczby, wartości spoza liczb (null, „osiem") pomijamy — raz, przy odczycie, + * zamiast osobnej ochrony w każdej komendzie. Status zostaje, jak jest: widok + * pokazuje nieznany status bez zmian (logStatusText). 0 km przy opuszczonej + * sesji to brak dystansu, nie informacja. + */ +function normalize(raw: Record, dropped: string[] = []): LogEntry | StrengthLogEntry { + const entry = { ...raw } + for (const key of ['km', 'timeSec', 'testTimeSec', 'rpe', 'minutes'] as const) { + if (!(key in entry)) continue + const value = typeof entry[key] === 'string' && (entry[key] as string).trim() ? fromText(key, entry[key] as string) : entry[key] + if (typeof value === 'number' && LOG_LIMITS[key](value)) entry[key] = value + else { + dropped.push(`${String(entry['date'] ?? '?')} ${key}`) + delete entry[key] + } + } + if (entry['status'] === 'skipped' && entry['km'] === 0) delete entry['km'] + return entry as unknown as LogEntry | StrengthLogEntry } const isStrength = (e: LogEntry | StrengthLogEntry): e is StrengthLogEntry => (e as StrengthLogEntry).activity === 'strength' +/** + * Dziennik do zmiany planu: uszkodzony wiersz mógł być wpisem dnia, który trzeba + * chronić, więc każda ścieżka zmieniająca plan albo doradzająca zmianę (regeneracja, + * propozycje, `shift`, `reschedule`, diagnoza `adapt`) najpierw czeka, aż plik zostanie + * poprawiony. Widoki (`today`, `week`, `review`, `status`) tylko go pomijają i ostrzegają. + */ +export function readLogForChanges(cwd: string): LogEntry[] { + const journal = readJournal(cwd) + if (journal.broken.length) throw new Error(ui().common.logBroken(LOG_FILE, journal.broken.join(', '))) + return journal.runs +} + +/** + * Cały dziennik jednym odczytem: wpisy biegowe i siłowe osobno, wartości pominięte + * przy odczycie (poza granicami LOG_LIMITS albo nie liczby, „data pole") i wiersze, + * których nie da się odczytać („wiersz N"). Widoki je pomijają, `status` je wymienia, + * a zmiana planu (recordedDates) czeka, aż plik zostanie poprawiony. + */ +export function readJournal(cwd: string): { runs: LogEntry[]; strength: StrengthLogEntry[]; dropped: string[]; broken: string[] } { + const dropped: string[] = [], broken: string[] = [] + const all = readAll(cwd, dropped, broken) + return { runs: all.filter((e): e is LogEntry => !isStrength(e)), strength: all.filter(isStrength), dropped, broken } +} + /** Wpisy biegowe — to, z czego liczy się wykonanie planu. */ export function readLog(cwd: string): LogEntry[] { - return readAll(cwd).filter((e): e is LogEntry => !isStrength(e)) + return readJournal(cwd).runs } /** Wpisy siły; ostatni wpis dnia wygrywa, jak w dzienniku biegów. */ export function readStrengthLog(cwd: string): StrengthLogEntry[] { - return readAll(cwd).filter(isStrength) + return readJournal(cwd).strength } /** Ostatni wpis dla daty (późniejszy nadpisuje wcześniejszy w interpretacji). */ export function logFor(cwd: string, date: string): LogEntry | undefined { - return readLog(cwd) - .filter((e) => e.date === date) - .at(-1) + return latestByDate(readLog(cwd)).get(date) } /** "MM:SS" lub "HH:MM:SS" → sekundy. */ diff --git a/packages/cli/src/plan-shape.fixture.ts b/packages/cli/src/plan-shape.fixture.ts new file mode 100644 index 0000000..57d8774 --- /dev/null +++ b/packages/cli/src/plan-shape.fixture.ts @@ -0,0 +1,83 @@ +/** + * Macierz profili syntetycznych do testów kształtu sezonu (docs/PLAN-v0.7.md, B0). + * Bez danych osobowych: wynik 10 km 43:00, dni z korpusowego wzorca tygodnia. + * Używa jej `plan-shape.test.ts`; te same profile mają posłużyć wydrukom do przeglądu + * trenerskiego (F1). Plik `.fixture.ts` nie trafia do paczki npm (package.json + * `files`, tsconfig.build). + */ +import { addDays, seasonLine, seasonProfile, seasonShapeIssues, type SeasonRow, type ShapeIssue, type Weekday } from 'trainctl-core' +import type { TrainctlConfig } from './config.ts' +import { computePlan, type StoredPlan } from './planfile.ts' + +export const MATRIX_TODAY = '2026-10-22' + +const DAYS: Record = { + 3: ['tue', 'thu', 'sat'], + 4: ['tue', 'thu', 'sat', 'sun'], + 5: ['tue', 'wed', 'thu', 'sat', 'sun'], + 6: ['tue', 'wed', 'thu', 'fri', 'sat', 'sun'], +} +const GOALS = { + '10k': { kind: 'race', distanceKm: 10, name: '10K' }, + hm: { kind: 'race', distanceKm: 21.0975, name: 'HM' }, + m: { kind: 'race', distanceKm: 42.195, name: 'M' }, + base: { kind: 'base', distanceKm: 0, name: 'Base' }, +} as const +export type MatrixGoal = keyof typeof GOALS + +export interface MatrixProfile { + id: string + baseKm: number + days: number + goal: MatrixGoal + weeks: number + budget?: number + strength?: boolean + peakKm?: number +} + +/** Data celu: niedziela tygodnia, który jest `weeks`-tym tygodniem planu. */ +export function matrixConfig(p: MatrixProfile): TrainctlConfig { + const goal = GOALS[p.goal] + // 2026-10-22 to czwartek; poniedziałek tygodnia to 2026-10-19 + const date = addDays('2026-10-19', 7 * (p.weeks - 1) + 6) + return { + language: 'en', + athlete: { + recentWeeklyKm: p.baseKm, + ...(p.peakKm ? { peakWeeklyKm: p.peakKm } : {}), + daysAvailable: DAYS[p.days]!, + results: [{ date: '2026-09-27', distanceKm: 10, timeSec: 2580 }], + }, + goal: { kind: goal.kind, name: goal.name, date, distanceKm: goal.distanceKm, priority: 'A' }, + ...(p.strength ? { strength: { enabled: true } } : {}), + ...(p.budget ? { time: { weeklyMinutes: p.budget } } : {}), + } as TrainctlConfig +} + +/** Pełna macierz z planu: baza × dni × cel × horyzont × budżet. */ +export function fullMatrix(): MatrixProfile[] { + const out: MatrixProfile[] = [] + for (const baseKm of [12, 25, 45, 70]) for (const days of [3, 4, 5, 6]) for (const goal of Object.keys(GOALS) as MatrixGoal[]) + for (const weeks of [8, 16, 24]) for (const budget of [undefined, 240, 360]) { + out.push({ id: `${baseKm}km-${days}d-${goal}-${weeks}w${budget ? `-${budget}min` : ''}`, baseKm, days, goal, weeks, ...(budget ? { budget } : {}) }) + } + return out +} + +/** Profile z przeglądu 2026-11-11 (PLAN-v0.7 §1), na horyzoncie 23 tygodni do startu. */ +export const REVIEW_PROFILES: MatrixProfile[] = [ + { id: 'P1', baseKm: 45, days: 5, goal: 'hm', weeks: 23, strength: true }, + { id: 'P2', baseKm: 12, days: 5, goal: 'hm', weeks: 23, strength: true, peakKm: 50 }, + { id: 'P2b', baseKm: 12, days: 5, goal: 'hm', weeks: 23, strength: true }, + { id: 'P3', baseKm: 45, days: 5, goal: 'hm', weeks: 23, strength: true, budget: 240 }, +] + +export function matrixPlan(p: MatrixProfile): StoredPlan { + return computePlan(matrixConfig(p), MATRIX_TODAY) +} + +export function shapeReport(p: MatrixProfile, plan = matrixPlan(p)): { lines: string[]; issues: ShapeIssue[]; rows: SeasonRow[] } { + const rows = seasonProfile(plan.weeks) + return { lines: rows.map(seasonLine), issues: seasonShapeIssues(plan, rows), rows } +} diff --git a/packages/cli/src/plan-shape.test.ts b/packages/cli/src/plan-shape.test.ts new file mode 100644 index 0000000..68b119f --- /dev/null +++ b/packages/cli/src/plan-shape.test.ts @@ -0,0 +1,59 @@ +/** + * Kształt sezonu jako kontrakt (docs/PLAN-v0.7.md, B0, kandydat ADR-047). + * + * Migawka `__snapshots__/plan-shape-*.txt` zapisuje sezon profili z przeglądu + * i podsumowanie lintów kształtu dla pełnej macierzy 576 profili. Zmiana + * silnika zmienia migawkę — to zamierzone: różnica idzie do przeglądu kodu + * razem ze zmianą, zamiast przejść niezauważona przez testy reguł tygodnia. + */ +import { describe, expect, it } from 'vitest' +import { SHAPE_CODES, setLocale, validatePlan } from 'trainctl-core' +import { REVIEW_PROFILES, fullMatrix, matrixPlan, shapeReport, type MatrixProfile } from './plan-shape.fixture.ts' + +setLocale('en') + +function summary(p: MatrixProfile): string { + const plan = matrixPlan(p) + const { issues, rows } = shapeReport(p, plan) + const errors = validatePlan(plan).filter((i) => i.severity === 'error').length + const counts = SHAPE_CODES.map((c) => issues.filter((i) => i.code === c).length) + const longest = Math.max(0, ...rows.map((r) => r.longKm)) + return [p.id.padEnd(26), `peak ${plan.peakKmPlanned}`.padEnd(8), `long ${longest}`.padEnd(8), `err ${errors}`, counts.join(' ')].join(' | ') +} + +describe('kształt sezonu', () => { + it('profile z przeglądu 2026-11-11', async () => { + const text = REVIEW_PROFILES.map((p) => { + const { lines, issues } = shapeReport(p) + return [`## ${p.id}`, ...lines, '', ...issues.map((i) => `${i.code} ${i.date} ${i.values.join('/')} [${i.ruleRefs.join(',')}]`)].join('\n') + }).join('\n\n') + await expect(text + '\n').toMatchFileSnapshot('./__snapshots__/plan-shape-review.txt') + }) + + it('pełna macierz: każdy profil generuje plan bez błędów, podsumowanie lintów', async () => { + const lines = fullMatrix().map(summary) + expect(lines).toHaveLength(576) + expect(lines.filter((l) => !l.includes('| err 0 |'))).toEqual([]) + const header = `# id | peak | longest long | validate errors | ${SHAPE_CODES.join(' ')}` + await expect([header, ...lines].join('\n') + '\n').toMatchFileSnapshot('./__snapshots__/plan-shape-matrix.txt') + }) +}) + +describe('linty kształtu wykrywają usterki opisane w §1', () => { + const codes = (id: string) => new Set(shapeReport(REVIEW_PROFILES.find((p) => p.id === id)!).issues.map((i) => i.code)) + it('P1: długie krótsze od spokojnego w odciążeniu, brak progresji, ciężki akcent po starcie, długie poniżej progu', () => { + expect([...codes('P1')]).toEqual(expect.arrayContaining(['longNotLongest', 'staleProgression', 'postRaceAccentHeavy', 'longBelowGoal'])) + }) + it('P2b: akcent dźwiga tydzień przy małej objętości', () => { + expect(codes('P2b').has('sessionShareHigh')).toBe(true) + }) + it('P3: budżet czasu robi odciążenie cięższym od ładowania', () => { + expect(codes('P3').has('deloadNotLighter')).toBe(true) + }) + it('cel bazowy i 10 km nie mają progu długiego', () => { + for (const goal of ['base', '10k'] as const) { + const p: MatrixProfile = { id: goal, baseKm: 45, days: 5, goal, weeks: 16 } + expect(shapeReport(p).issues.some((i) => i.code === 'longBelowGoal')).toBe(false) + } + }) +}) diff --git a/packages/cli/src/planfile.ts b/packages/cli/src/planfile.ts index 2939ea0..55f8759 100644 --- a/packages/cli/src/planfile.ts +++ b/packages/cli/src/planfile.ts @@ -17,7 +17,6 @@ import { planStrengthWeek, predictRace, testDistanceKm, - vdotFromRace, type Microcycle, type PlannedDay, type RaceGoal, @@ -25,7 +24,8 @@ import { } from 'trainctl-core' import { CONFIG_FILE, type StrengthConfig, type TrainctlConfig } from './config.ts' import { ui } from './i18n/index.ts' -import { inspectCalibration, type Calibration } from './calibration.ts' +import { kmLabel } from './format.ts' +import { inspectCalibration, isRoadGoal, roundVdot, zoneCalibration, type Calibration } from './calibration.ts' import { packageVersion } from './version.ts' export const PLAN_DIR = 'plan' @@ -122,26 +122,20 @@ export function settleMixedWeek(week: Microcycle): void { export function computePlan(config: TrainctlConfig, today: string, calibrationDate = today, opts: ComputePlanOptions = {}): StoredPlan { const { athlete, goal } = config - const recent = athlete.results.filter( - (r) => !r.excluded && r.date <= calibrationDate && diffDays(r.date, calibrationDate) <= 540, - ) + // Wybór wyniku (540 dni, wykluczenia, Z-10) ma jedną implementację — inspectCalibration; + // z niej korzysta też `why`, żeby podpowiedź o rekalibracji mówiła to, co zrobi plan. // Z-10 (inż.): wynik z trailu nie kalibruje stref szosowych — czas w terenie mówi // o terenie tak samo jak o formie. Gdy innych wyników brak, używamy go z ostrzeżeniem. - const roadGoal = goal.terrain !== 'trail' && goal.terrain !== 'ultra' - const road = roadGoal ? recent.filter((r) => r.terrain !== 'trail') : recent - const usable = road.length ? road : recent - const trailOnly = roadGoal && road.length === 0 && recent.length > 0 - let vdot: number - let vdotSource: StoredPlan['vdotSource'] - if (usable.length > 0) { - vdot = Math.max(...usable.map((r) => vdotFromRace(r.distanceKm, r.timeSec))) - vdotSource = 'result' - } else if (goal.targetTimeSec && goal.kind !== 'base') { - vdot = vdotFromRace(goal.distanceKm, goal.targetTimeSec) - vdotSource = 'goal-target' - } else { - throw new Error(ui().planMd.noCalibration) - } + const roadGoal = isRoadGoal(goal) + const calibration = inspectCalibration(athlete.results, calibrationDate, roadGoal) + const selected = calibration.selected + // wyniki, które przeszły zasadę wyboru (z wybranym) — z nich liczy się też predykcja + const usable = calibration.candidates.filter((c) => c.reason === 'selected' || c.reason === 'lower-vdot').map((c) => c.result) + const trailOnly = roadGoal && selected?.terrain === 'trail' + // źródło stref i VDOT — ta sama funkcja co podpowiedź `why` (zoneCalibration) + const zoneFrom = zoneCalibration(selected, goal) + if (zoneFrom.source === 'none') throw new Error(ui().planMd.noCalibration) + const { source: vdotSource, vdot } = zoneFrom const zones = paceZones(vdot) const macro = planMacrocycle({ today, goal, athlete }) let previousFrequency: number | undefined @@ -155,10 +149,10 @@ export function computePlan(config: TrainctlConfig, today: string, calibrationDa const plan: StoredPlan = { schemaVersion: PLAN_SCHEMA_VERSION, engineVersion: packageVersion(), - calibration: inspectCalibration(athlete.results, calibrationDate, roadGoal), + calibration, generatedAt: today, locale: getLocale(), - vdot: Math.round(vdot * 10) / 10, + vdot: roundVdot(vdot), vdotSource, goal, peakKmPlanned: macro.peakKmPlanned, @@ -598,7 +592,7 @@ export function renderMarkdown(plan: StoredPlan): string { const label = [ core.phase[sk.phase] ?? sk.phase, core.intensityModel[sk.intensityModel], - `${week.totalKm} km`, + kmLabel(week.totalKm), ...(sk.deload ? [m.deload] : []), ].join(' · ') lines.push('', `## ${m.weekHeading(weekPosition(plan, week).index + 1, week.weekStart, label)}`, '') @@ -617,6 +611,9 @@ export function renderMarkdown(plan: StoredPlan): string { } if (plan.changes.length) { lines.push('', `## ${m.changes}`, '') + // Historia zmian to zapis z plan.yaml w brzmieniu z chwili zmiany (język CLI z tamtej + // chwili, surowe liczby). PLAN.md cytuje ją bez przeróbek: zamiana samych liczb + // w tekście pisanym w innym języku dawałaby pół-tłumaczenie. for (const c of plan.changes) lines.push(`- ${m.changeLine(c.at, c.action, c.detail)}`) } lines.push('') diff --git a/packages/cli/src/proposals.ts b/packages/cli/src/proposals.ts index 8d6beca..cbb5c3c 100644 --- a/packages/cli/src/proposals.ts +++ b/packages/cli/src/proposals.ts @@ -3,13 +3,13 @@ import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from import { join } from 'node:path' import { addDays, estimateWorkoutMinutes, mondayOf, validatePlan, weekTotals, withLocale, paceZones, recalibrateWorkout, parseIso, shortenWorkout, type ShortenedWorkout, type AdaptationProposal, type PlannedDay } from 'trainctl-core' import { CONFIG_FILE, loadConfig } from './config.ts' -import { logFor, readLog, LOG_FILE } from './logfile.ts' +import { logFor, readLogForChanges, LOG_FILE } from './logfile.ts' import { budgetWarnings, computePlan, cycleWeeksOf, dayFingerprint, loadPlan, planEnd, scaleToBaseline, settleMixedWeek, PLAN_YAML, writePlan, workoutText, type StoredPlan } from './planfile.ts' import { ui } from './i18n/index.ts' import { readSnapshot } from './sync.ts' import { runningKmByDate } from './execution.ts' import { clockToday } from './clock.ts' -import { resultKey } from './calibration.ts' +import { sameResults } from './calibration.ts' export interface PlanProposal { /** Actual local date of creation; historical analysis does not authorize historical writes. */ @@ -30,6 +30,15 @@ export interface PlanProposal { const hash = (text: string): string => createHash('sha256').update(text).digest('hex') /** Prawdziwy (albo jawnie symulowany) dzień kalendarzowy — granica ochrony przeszłości. */ export const calendarToday = (): string => clockToday() + +/** + * Wpis historii zmian w plan.yaml: dane, nie widok — surowe liczby i enum, + * niezależne od języka CLI, którym zatwierdzono zmianę. + */ +export function shortenDetail(date: string, from: number, to: number, budget: number, status: string): string { + return `${date}: ${from} → ${to} km; ${budget} min; ${status}` +} + export function workspaceHash(cwd: string): string { return hash(JSON.stringify([PLAN_YAML, CONFIG_FILE, LOG_FILE, 'sync.json'].map((name) => { const path = join(cwd, name) @@ -49,7 +58,8 @@ function saveProposal(cwd: string, body: Omit): PlanProposal /** Daty z zapisem wykonania (dziennik albo bieg z synchronizacji) — nienaruszalne dla zmian planu. */ export function recordedDates(cwd: string): Set { - const dates = new Set(readLog(cwd).map(entry => entry.date)) + // uszkodzony wiersz dziennika zatrzymuje zmianę planu (readLogForChanges) + const dates = new Set(readLogForChanges(cwd).map(entry => entry.date)) for (const date of runningKmByDate(readSnapshot(cwd)?.activities ?? []).keys()) dates.add(date) return dates } @@ -99,7 +109,7 @@ export function prepareShortening(cwd: string, date: string, minutes: number): { // Keep the generation fingerprint: an approved exception must survive adaptation. Object.assign(week!, weekTotals(week!.days)) plan.peakKmPlanned = Math.max(...cycleWeeksOf(plan).map(w => w.totalKm)) - plan.changes.push({ at: calendarToday(), action: 'shorten', detail: `${date}: ${before.workout!.distanceKm} → ${day.workout.distanceKm} km; ${budget} min; ${adjustment.status}` }) + plan.changes.push({ at: calendarToday(), action: 'shorten', detail: shortenDetail(date, before.workout!.distanceKm, day.workout.distanceKm, budget, adjustment.status) }) const proposal = saveProposal(cwd, { schemaVersion: 1, kind: 'shorten', preparedOn: calendarToday(), createdFor: date, baseHash, adjustment, vdotBefore: plan.vdot, plan, changes: [{ date, before: describeDay(before), after: describeDay(day), beforeKm: before.workout!.distanceKm, afterKm: day.workout.distanceKm }], @@ -121,7 +131,7 @@ export function prepareProposal(cwd: string, today: string, analysis: Adaptation if (JSON.stringify(config.goal) !== JSON.stringify(plan.goal)) throw new Error(ui().improve.changedGoal) // A completed time trial with no result in the profile is a request for data, // not permission to rewrite calibration timestamps and call that a plan change. - if (!volume && JSON.stringify(config.athlete.results.map(resultKey).sort()) === JSON.stringify(plan.calibration.results.map(resultKey).sort())) + if (!volume && sameResults(config.athlete.results, plan.calibration.results)) throw new Error(ui().improve.noPatch) const nextConfig = structuredClone(config) const candidate = withLocale(plan.locale === 'pl' ? 'pl' : 'en', () => computePlan(nextConfig, plan.generatedAt, today, { diff --git a/packages/cli/src/regenerate.ts b/packages/cli/src/regenerate.ts index 62650d6..d5a44cd 100644 --- a/packages/cli/src/regenerate.ts +++ b/packages/cli/src/regenerate.ts @@ -31,6 +31,7 @@ import { type PlannedDay, } from 'trainctl-core' import type { TrainctlConfig } from './config.ts' +import { sameResults, sameSelection } from './calibration.ts' import { budgetWarnings, computePlan, dayFingerprint, scaleToBaseline, settleMixedWeek, type StoredPlan } from './planfile.ts' import { clockToday } from './clock.ts' @@ -224,6 +225,11 @@ export function rebuildPlan( droppedWeeks.length === 0 && sameWeeks && plan.vdot === existing.vdot && + // wynik, z którego policzono strefy, to też treść planu: `why` porównuje go + // z dzisiejszym profilem — bez zapisu podpowiedź „uruchom trainctl plan" by nie znikła + sameSelection(plan.calibration?.selected, existing.calibration?.selected) && + // nowy wynik bez zmiany wyboru: lista wyników w `why` też ma być aktualna + sameResults(plan.calibration?.results, existing.calibration?.results) && JSON.stringify(plan.goal) === JSON.stringify(existing.goal) && plan.locale === existing.locale && plan.engineVersion === existing.engineVersion && diff --git a/packages/cli/src/rules-explain.ts b/packages/cli/src/rules-explain.ts index b7372d7..2a0ffb1 100644 --- a/packages/cli/src/rules-explain.ts +++ b/packages/cli/src/rules-explain.ts @@ -29,7 +29,7 @@ export const kindPurpose = (kind: WorkoutKind): string => ui().kindPurpose[kind] /** Labels describe provenance, never numerical certainty or evidence grades. */ export function ruleEvidence(id: string): 'research' | 'corpus' | 'engineering' | 'unclassified' { - if (['MS-1', 'MS-2', 'MS-3', 'MS-4', 'MS-5', 'MS-6', 'E-1', 'T-9', 'T-12', 'W-13', 'R-5', 'P-3', 'F-18', 'Z-10', 'E-2', 'R-9', 'R-10', 'P-11'].includes(id)) return 'engineering' + if (['MS-1', 'MS-2', 'MS-3', 'MS-4', 'MS-5', 'MS-6', 'E-1', 'T-9', 'T-12', 'W-13', 'R-5', 'P-3', 'F-18', 'Z-10', 'E-2', 'E-3', 'R-9', 'R-10', 'P-11'].includes(id)) return 'engineering' if (['T-10', 'T-11', 'W-12', 'S-9a', 'R-8'].includes(id)) return 'corpus' return ruleExplain(id) ? 'research' : 'unclassified' } diff --git a/packages/cli/src/sports-commands.ts b/packages/cli/src/sports-commands.ts index 6066936..58d913c 100644 --- a/packages/cli/src/sports-commands.ts +++ b/packages/cli/src/sports-commands.ts @@ -13,7 +13,8 @@ import { ui } from './i18n/index.ts' import { clockToday } from './clock.ts' import { packageVersion } from './version.ts' import { CONFIG_FILE } from './config.ts' -import { LOG_FILE, parseTime } from './logfile.ts' +import { lineSeparator, LOG_FILE, LOG_KM_MAX, LOG_LIMITS, parseTime } from './logfile.ts' +import { logStatusText, parseDecimal } from './format.ts' import { PLAN_MD, PLAN_YAML } from './planfile.ts' import { commitFiles } from './git.ts' import { readSnapshot, SYNC_FILE } from './sync.ts' @@ -38,7 +39,10 @@ export interface SportsOptions { export interface SportsResult { output: string; code: number; blocks: Block[]; data: Record } export const sportsResult = (blocks: Block[], data: Record = {}, code = 0): SportsResult => ({ output: renderPlain(blocks), blocks, data, code }) export const sportsFailure = (e: unknown): SportsResult => sportsResult([b.error(e instanceof Error ? e.message : String(e))], { error: e instanceof Error ? e.message : String(e) }, 1) -const number = (v: unknown, min = 0, max = 10080): number => { const n = Number(v); if (v === '' || v === undefined || !Number.isFinite(n) || n < min || n > max) throw new Error(msg().invalid); return n } +// liczby z opcji: ten sam parser co dziennik biegów (parseDecimal — bez „0x10" i „1e3"); +// przecinek dziesiętny tylko w km („8,5"), w metrach i minutach „1,500" to nie 1,5. +// Granice zależą od sportu — bieg jak w dzienniku biegów (LOG_KM_MAX), rower i pływanie szerzej. +const number = (v: unknown, min = 0, max = 10080, comma = false): number => { const n = typeof v === 'number' ? v : parseDecimal(String(v ?? ''), comma); if (!Number.isFinite(n) || n < min || n > max) throw new Error(msg().invalid); return n } function select(p: SportsPlan, o: SportsOptions): TrainingSession { const list = p.sessions.filter(s => o.session ? s.id === o.session : s.date === (o.date ?? o.from ?? clockToday()) && (!o.sport || s.sport === o.sport) && (!o.strength || s.sport === 'strength')) if (!list.length) throw new Error(msg().noSession) @@ -167,11 +171,11 @@ export function sportsCommand(cwd: string, action: string, o: SportsOptions = {} if ((o.actualSport !== undefined && !ENDURANCE_SPORTS.includes(actualSport as EnduranceSport)) || (spontaneous && (s.sport === 'strength' || status === 'skipped'))) throw new Error(t.invalid) if (!['done', 'skipped', 'modified'].includes(status) || (o.km !== undefined && o.meters !== undefined) || (o.minutes !== undefined && o.time !== undefined)) throw new Error(t.invalid) const durationSec = typeof o.time === 'string' ? parseTime(o.time) : o.minutes !== undefined ? number(o.minutes, 0, 3000) * 60 : undefined - const distanceM = o.meters !== undefined ? number(o.meters, 0, 2e6) : o.km !== undefined ? number(o.km, 0, 2000) * 1000 : undefined + const distanceM = o.meters !== undefined ? number(o.meters, 0, actualSport === 'run' ? LOG_KM_MAX * 1000 : 2e6) : o.km !== undefined ? number(o.km, 0, actualSport === 'run' ? LOG_KM_MAX : 2000, true) * 1000 : undefined const testTimeSec = o.testTime === undefined ? undefined : parseTime(o.testTime) if (testTimeSec !== undefined && (s.sport !== 'run' || spontaneous || status === 'skipped' || !(s.purpose === 'race' || s.legacyWorkout?.kind === 'test') || (durationSec !== undefined && testTimeSec > durationSec))) throw new Error(t.invalid) const rpe = o.rpe === undefined ? undefined : number(o.rpe, 1, 10) - if ((rpe !== undefined && !Number.isInteger(rpe)) || (status === 'skipped' && ((durationSec ?? 0) > 0 || (distanceM ?? 0) > 0))) throw new Error(t.invalid) + if ((rpe !== undefined && !LOG_LIMITS.rpe(rpe)) || (status === 'skipped' && ((durationSec ?? 0) > 0 || (distanceM ?? 0) > 0))) throw new Error(t.invalid) const activityIds = o.activity?.split(',').map(id=>id.trim()).filter(Boolean) const completedRepeats = o.sets === undefined ? undefined : o.sets.split(',').map(value=>{ const match=/^(\d+)=(\d+)$/.exec(value.trim()) @@ -198,8 +202,8 @@ export function sportsCommand(cwd: string, action: string, o: SportsOptions = {} const entry: SessionLog = { schemaVersion: 2, sessionId: s.id, date: s.date, sport: actualSport as SessionLog['sport'], ...(spontaneous ? {plannedSport:s.sport} : {}), status: status as SessionLog['status'], loggedAt: new Date().toISOString(), ...(durationSec !== undefined ? { durationSec } : {}), ...(distanceM !== undefined ? { distanceM } : {}), ...(testTimeSec !== undefined ? { testTimeSec } : {}), ...(rpe !== undefined ? { rpe } : {}), ...(o.note ? { note: o.note } : {}), ...(activityIds?.length ? { activityIds } : {}) } if (completedRepeats) entry.completedRepeats = completedRepeats const before = readOptional(cwd, LOG_FILE) ?? '' - writeTransaction(cwd, { [LOG_FILE]: before + (before && !before.endsWith('\n') ? '\n' : '') + JSON.stringify(entry) + '\n' }) - return commitResult(cwd, o, sportsResult([b.success(t.logged), b.text(`${s.id}: ${status}`), ...(spontaneous ? [b.info(t.spontaneous)] : [])], { entry, applied: true }), [LOG_FILE], action) + writeTransaction(cwd, { [LOG_FILE]: before + lineSeparator(before) + JSON.stringify(entry) + '\n' }) + return commitResult(cwd, o, sportsResult([b.success(t.logged), b.text(`${s.id}: ${logStatusText(status, s.sport === 'strength')}`), ...(spontaneous ? [b.info(t.spontaneous)] : [])], { entry, applied: true }), [LOG_FILE], action) } if (action === 'replace') { const s = select(plan, o); editable(cwd, plan, s) diff --git a/packages/cli/src/sports-running.ts b/packages/cli/src/sports-running.ts index 4badd1e..9f63637 100644 --- a/packages/cli/src/sports-running.ts +++ b/packages/cli/src/sports-running.ts @@ -3,6 +3,7 @@ import { attachRunningCoaching, estimateWorkoutMinutes, predictTimeSec, type Pla import { computePlan, dayFingerprint, workoutText, type StoredPlan } from './planfile.ts' import type { TrainctlConfig } from './config.ts' import { rebuildPlan } from './regenerate.ts' +import { shownKm } from './format.ts' export function runningDurationMinutes(plan: StoredPlan, workout: PlannedWorkout, date: string): number { const explicit = estimateWorkoutMinutes(workout, 0) @@ -10,7 +11,7 @@ export function runningDurationMinutes(plan: StoredPlan, workout: PlannedWorkout const seconds = date === plan.goal.date ? plan.goal.targetTimeSec ?? plan.prediction?.hiSec : undefined // Legacy races may lack an estimate. Use only the existing running calibration, // retaining the original workout unchanged and labelling the estimate's source. - return Math.ceil((seconds ?? predictTimeSec(workout.raceDistanceKm ?? workout.distanceKm, plan.vdot)) / 60) + return Math.ceil((seconds ?? predictTimeSec(shownKm(workout), plan.vdot)) / 60) } export function runningSessions(plan: StoredPlan, cycleId: string): TrainingSession[] { @@ -26,7 +27,7 @@ export function runningSessions(plan: StoredPlan, cycleId: string): TrainingSess ruleRefs: sport === 'run' ? workout!.ruleRefs : strength!.ruleRefs, ...(sport === 'run' && !Number.isFinite(estimateWorkoutMinutes(workout!,0)) ? {durationSource:'running-prediction'} : {}), ...(approved ? { approved: true } : {}), ...(d.pinned ? { pinned: true } : {}), - ...(sport === 'run' ? { legacyWorkout: workout!, distanceM: (workout!.raceDistanceKm ?? workout!.distanceKm) * 1000, description: workoutText(d), externalId: `trainctl-${d.date}` } : { description: strength!.description, externalId: `trainctl-${d.date}-strength` }), + ...(sport === 'run' ? { legacyWorkout: workout!, distanceM: shownKm(workout!) * 1000, description: workoutText(d), externalId: `trainctl-${d.date}` } : { description: strength!.description, externalId: `trainctl-${d.date}-strength` }), } as TrainingSession, {phase:w.skeleton.deload?'deload':w.skeleton.phase==='transition'?'recovery':w.skeleton.phase==='peak'?'build':w.skeleton.phase,weekIndex:w.skeleton.index,goal:{kind:plan.goal.kind==='base'?'base':'race',name:plan.goal.name,date:plan.goal.date,sport:'run',distanceM:plan.goal.distanceKm*1000}})] }))) } diff --git a/packages/cli/src/sports.test.ts b/packages/cli/src/sports.test.ts index 5c9865e..4b0f9b1 100644 --- a/packages/cli/src/sports.test.ts +++ b/packages/cli/src/sports.test.ts @@ -4,7 +4,7 @@ import { join } from 'node:path' import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest' import { parse, stringify } from 'yaml' import ICAL from 'ical.js' -import { buildSportSession, type SportsPlan, type SportsConfig, type SyncProvider, type PushableWorkout } from 'trainctl-core' +import { buildSportSession, setLocale, type SportsPlan, type SportsConfig, type SyncProvider, type PushableWorkout } from 'trainctl-core' import { cmdInit, cmdPlan, cmdReplace, cmdMigrate, cmdLog, cmdCheck, cmdWeek, cmdToday, cmdShorten, cmdShift, cmdExport, cmdPush, cmdPull, cmdAdapt, cmdDiff, cmdReview, cmdWhy, cmdReschedule } from './commands.ts' import { loadSportsPlan, sportsTemplate } from './sports-store.ts' import { pushableSession, sessionExternalId } from './sports-sync.ts' @@ -93,6 +93,52 @@ describe('multisport CLI workflows',()=>{ expect(existsSync(join(dir,'export'))).toBe(false) expect(cmdLog(dir,{date:day,status:'done'}).code).toBe(0) }) + it('potwierdzenie wpisu sesji podaje status słowem z katalogu', () => { + const plan = init(), first = [...plan.sessions].sort((a, z) => a.date.localeCompare(z.date))[0]! + setLocale('pl') + try { + const saved = cmdLog(dir, { session: first.id, status: 'done' }) + expect(saved.code, saved.output).toBe(0) + expect(saved.output).toContain(`${first.id}: wykonany`) + } finally { setLocale('en') } + }) + it('wpis sesji v2: dystans z przecinkiem, bez zapisu szesnastkowego; siła w rodzaju żeńskim', () => { + const plan = init(), sorted = [...plan.sessions].sort((a, z) => a.date.localeCompare(z.date)) + const run = sorted.find((s) => s.sport === 'run')! + expect(cmdLog(dir, { session: run.id, status: 'done', km: '0x10' }).code).toBe(1) + expect(cmdLog(dir, { session: run.id, status: 'done', km: '800' }).code).toBe(1) + expect(cmdLog(dir, { session: run.id, status: 'done', meters: '1,500' }).code).toBe(1) + expect(cmdLog(dir, { session: run.id, status: 'done', meters: '800000' }).code).toBe(1) + expect(cmdLog(dir, { session: run.id, status: 'done', rpe: '7.5' }).code).toBe(1) + const ok = cmdLog(dir, { session: run.id, status: 'done', km: '8,5' }) + expect(ok.code, ok.output).toBe(0) + expect(ok.data!.entry).toMatchObject({ distanceM: 8500 }) + }) + it('potwierdzenie wpisu siły v2 w rodzaju żeńskim (siła z migracji planu biegowego)', () => { + const legacy = `athlete: + recentWeeklyKm: 35 + daysAvailable: [tue, thu, sat, sun] + results: + - { date: '2026-09-01', distanceKm: 10, timeSec: 3000 } +strength: + enabled: true +goal: + kind: base + name: Base + date: '2026-12-27' + distanceKm: 0 + priority: A +` + expect(cmdInit(dir, legacy).code).toBe(0); expect(cmdPlan(dir).code).toBe(0) + expect(cmdMigrate(dir, { apply: proposalId(cmdMigrate(dir)) }).code).toBe(0) + const strength = [...loadSportsPlan(dir).sessions].sort((a, z) => a.date.localeCompare(z.date)).find((s) => s.sport === 'strength')! + setLocale('pl') + try { + const saved = cmdLog(dir, { session: strength.id, status: 'done' }) + expect(saved.code, saved.output).toBe(0) + expect(saved.output).toContain(`${strength.id}: wykonana`) + } finally { setLocale('en') } + }) it('records actual swimming repetitions without inferring full duration or distance',async()=>{ const plan=init(), swim=plan.sessions.find(s=>s.sport==='swim')!, run=plan.sessions.find(s=>s.sport==='run')! expect(cmdLog(dir,{session:run.id,sets:'1=3'}).code).toBe(1) diff --git a/packages/cli/src/status.ts b/packages/cli/src/status.ts index 02733c7..156880f 100644 --- a/packages/cli/src/status.ts +++ b/packages/cli/src/status.ts @@ -16,7 +16,8 @@ import { ENV_FILE, inspectEnvFile } from './env-file.ts' import { buildExecution } from './execution.ts' import { uncommitted } from './git.ts' import { ui } from './i18n/index.ts' -import { LOG_FILE, readLog } from './logfile.ts' +import { logStatusText } from './format.ts' +import { LOG_FILE, readJournal } from './logfile.ts' import { cycleWeeksOf, readExistingPlan, unusablePlanMessage, PLAN_DIR, type StoredPlan } from './planfile.ts' import { listProposals } from './proposals.ts' import { API_KEY_ENV, apiKeySource, readSnapshot, SYNC_FILE } from './sync.ts' @@ -105,7 +106,8 @@ function statusImpl(cwd: string): StatusResult { const source = apiKeySource(cwd, env) const keySource = source === 'environment' ? t.keyFromEnv : source const snapshot = readSnapshot(cwd) - const logs = readLog(cwd) + const journal = readJournal(cwd) + const logs = journal.runs const last = logs.at(-1) const weekStart = mondayOf(today) const unconfirmed = plan @@ -118,9 +120,11 @@ function statusImpl(cwd: string): StatusResult { [SYNC_FILE, snapshot ? t.syncValue(snapshot.pulledAt, snapshot.activities.length, snapshot.activities.filter((a) => a.dataWithheld).length) : t.never], - [LOG_FILE, last ? t.logValue(logs.length, last.date, last.status) : t.empty], + [LOG_FILE, last ? t.logValue(logs.length, last.date, logStatusText(last.status)) : t.empty], ])) if (env.unprotected) blocks.push(b.warn(ui().envFile.unprotected(ENV_FILE, '.gitignore'))) + if (journal.broken.length) blocks.push(b.warn(ui().common.logBroken(LOG_FILE, journal.broken.join(', ')))) + if (journal.dropped.length) blocks.push(b.warn(t.logDropped(LOG_FILE, journal.dropped.join(', ')))) if (unconfirmed.length) blocks.push(b.info(t.unconfirmed(unconfirmed.join(', ')))) // propozycje diff --git a/packages/cli/src/ui/blocks.ts b/packages/cli/src/ui/blocks.ts index 9b34035..9316971 100644 --- a/packages/cli/src/ui/blocks.ts +++ b/packages/cli/src/ui/blocks.ts @@ -54,8 +54,21 @@ export const b = { hint: (text: string): Block => ({ t: 'hint', text }), } -/** Zawijanie tekstu do szerokości, po słowach. */ -export function wrap(text: string, width: number, indent = ''): string[] { +/** URL albo ścieżka (Windows, POSIX, względna) — tokeny, których nie tniemy. */ +const UNBREAKABLE = /^[(\[{"'„«]*(?:[a-z][a-z0-9+.-]*:\/\/|[A-Za-z]:[\\/]|\.{0,2}[\\/]|~[\\/])\S+$/i + +/** + * Akapit: URL-e i ścieżki zostają w całości we własnym wierszu (bywa szerszy niż + * `width`), żeby link był klikalny i dał się skopiować. Do tekstu, nie do kolumn. + */ +export const wrapText = (text: string, width: number, indent = ''): string[] => wrap(text, width, indent, true) + +/** + * Zawijanie tekstu do szerokości, po słowach. Domyślnie żaden wiersz nie jest + * szerszy niż `width` (kolumny tabel, pomoc, wybór) — dłuższe słowo dzielimy; + * akapity wołają wrapText, który zostawia adresy i ścieżki w całości. + */ +export function wrap(text: string, width: number, indent = '', keepTokens = false): string[] { const available = Math.max(1, width - visibleLength(indent)) const lines: string[] = [] // Preserve explicit line breaks (errors, lists and multi-step workouts). @@ -66,7 +79,11 @@ export function wrap(text: string, width: number, indent = ''): string[] { lines.push(indent + line) line = '' } - if (visibleLength(word) > available) { + if (keepTokens && visibleLength(word) > available && UNBREAKABLE.test(word)) { + // Adres albo ścieżka w całości, we własnym wierszu (poprzedni wiersz został + // już zamknięty wyżej): pocięte po znakach przestają być klikalne. + line = word + } else if (visibleLength(word) > available) { for (const part of graphemes(word)) { if (line && visibleLength(line + part) > available) { lines.push(indent + line) @@ -86,8 +103,10 @@ export function wrap(text: string, width: number, indent = ''): string[] { function keyValues(pairs: [string, string][], theme: Theme, width: number): string[] { const keyWidth = Math.min(Math.max(0, ...pairs.map(([key]) => visibleLength(key) + 1)), Math.floor(width / 2)) return pairs.flatMap(([key, value]) => { - if (visibleLength(key) + 1 > keyWidth || width - keyWidth < 16) { - return [...wrap(`${key}:`, width).map(line => theme.dim(line)), ...wrap(value, width, ' ')] + // Adres albo ścieżka dłuższa niż kolumna wartości: układ piętrowy, pełna szerokość. + const tokenTooWide = value.split(/\s+/).some((word) => UNBREAKABLE.test(word) && visibleLength(word) > width - keyWidth - 2) + if (visibleLength(key) + 1 > keyWidth || width - keyWidth < 16 || tokenTooWide) { + return [...wrap(`${key}:`, width).map(line => theme.dim(line)), ...wrapText(value, width, ' ')] } const lines = wrap(value, width - keyWidth - 2) const numeric = /^\d+(?:[.,]\d+)?(?:\s*(?:%|km|m|min|h|s|W))?$/.test(value) @@ -108,7 +127,7 @@ function table(block: Extract, theme: Theme): string[] { if (cols > Math.max(3, Math.floor(width / 16)) || minimum.reduce((sum, n) => sum + n, gap) > width) { return block.rows.flatMap((row, index) => { const first = `${block.head[0]}: ${row[0] ?? ''}` - const heading = wrap(first, width).map(line => theme.bold(theme.color(line, block.accent?.[index] ?? 'accent'))) + const heading = wrapText(first, width).map(line => theme.bold(theme.color(line, block.accent?.[index] ?? 'accent'))) return [ ...(index ? [''] : []), ...heading, ...keyValues(block.head.slice(1).map((head, i) => [head, row[i + 1] ?? '']), theme, width) ] }) @@ -181,16 +200,16 @@ export function renderAnsi(blocks: Block[], theme = new Theme()): string { switch (block.t) { case 'title': { if (out.length) out.push('') - out.push(...wrap(block.text, width).map(line => theme.bold(theme.color(line, 'brand')))) - if (block.sub) out.push(...wrap(block.sub, width).map(line => theme.dim(line))) + out.push(...wrapText(block.text, width).map(line => theme.bold(theme.color(line, 'brand')))) + if (block.sub) out.push(...wrapText(block.sub, width).map(line => theme.dim(line))) out.push(theme.dim(s.horizontal.repeat(Math.min(width, 64))), '') break } case 'section': - out.push('', ...wrap(block.text, width).map(line => theme.bold(theme.color(line, block.accent ?? 'accent'))), '') + out.push('', ...wrapText(block.text, width).map(line => theme.bold(theme.color(line, block.accent ?? 'accent'))), '') break case 'text': - out.push(...wrap(block.text, width).map((l) => (block.tone === 'muted' ? theme.dim(l) : l))) + out.push(...wrapText(block.text, width).map((l) => (block.tone === 'muted' ? theme.dim(l) : l))) break case 'kv': { out.push(...keyValues(block.pairs, theme, width)) @@ -198,7 +217,7 @@ export function renderAnsi(blocks: Block[], theme = new Theme()): string { } case 'bullets': for (const item of block.items) { - const lines = wrap(item, width - 2, '') + const lines = wrapText(item, width - 2, '') const first = `${theme.color(s.bullet, 'accent')} ${lines[0]}` out.push(block.tone === 'muted' ? theme.dim(first) : first) for (const rest of lines.slice(1)) { @@ -219,7 +238,7 @@ export function renderAnsi(blocks: Block[], theme = new Theme()): string { } as const const [symbol, color] = map[block.kind] const prefixWidth = visibleLength(symbol) + 1 - const lines = wrap(block.text, width - prefixWidth) + const lines = wrapText(block.text, width - prefixWidth) out.push(`${theme.color(symbol, color)} ${lines[0]}`) for (const rest of lines.slice(1)) out.push(`${' '.repeat(prefixWidth)}${rest}`) break @@ -232,32 +251,32 @@ export function renderAnsi(blocks: Block[], theme = new Theme()): string { const inner = Math.max(1, width - inset) const nested = new Theme({ ...theme.caps, width: inner }) out.push('') - for (const [index, title] of wrap(block.title, inner).entries()) { + for (const [index, title] of wrapText(block.title, inner).entries()) { out.push((inset ? theme.color(index ? s.vertical : s.topLeft, block.accent) + ' ' : '') + theme.bold(theme.color(title, block.accent))) } const content = renderAnsi(block.body, nested).split('\n') - if (block.meta.length) content.push('', ...block.meta.flatMap(text => wrap(text, inner).map(line => theme.dim(line)))) + if (block.meta.length) content.push('', ...block.meta.flatMap(text => wrapText(text, inner).map(line => theme.dim(line)))) for (const line of content) out.push((inset ? theme.color(s.vertical, block.accent) + ' ' : '') + line) out.push(theme.color(s.bottomLeft + s.horizontal.repeat(Math.max(0, Math.min(width - 1, 63))), block.accent), '') break } case 'panel': { const inner = Math.max(1, width - 2) - const lines = block.lines.flatMap((l) => wrap(l, inner)) + const lines = block.lines.flatMap((l) => wrapText(l, inner)) const accent = block.accent ?? 'accent' out.push('') - for (const [index, title] of wrap(block.title, inner).entries()) { + for (const [index, title] of wrapText(block.title, inner).entries()) { out.push(`${theme.color(index ? s.vertical : s.topLeft, accent)} ${theme.bold(theme.color(title, accent))}`) } for (const line of lines) out.push(`${theme.color(s.vertical, accent)} ${line}`) - for (const line of (block.meta ?? []).flatMap(text => wrap(text, inner))) { + for (const line of (block.meta ?? []).flatMap(text => wrapText(text, inner))) { out.push(`${theme.color(s.vertical, accent)} ${theme.dim(line)}`) } out.push(theme.color(s.bottomLeft + s.horizontal.repeat(Math.min(width - 1, 23)), accent), '') break } case 'hint': - out.push('', ...wrap(block.text, width - visibleLength(s.arrow) - 1).map((line, i) => + out.push('', ...wrapText(block.text, width - visibleLength(s.arrow) - 1).map((line, i) => `${i ? ' '.repeat(visibleLength(s.arrow)) : theme.color(s.arrow, 'accent')} ${theme.color(line, 'brand')}`)) break case 'blank': diff --git a/packages/cli/src/ui/help.ts b/packages/cli/src/ui/help.ts index 3d9e573..8d9f475 100644 --- a/packages/cli/src/ui/help.ts +++ b/packages/cli/src/ui/help.ts @@ -1,4 +1,4 @@ -import { wrap } from './blocks.ts' +import { wrap, wrapText } from './blocks.ts' import { Theme, padVisible, stripAnsi } from './theme.ts' /** Commander keeps its command tree; only the layout of each help item changes. */ @@ -8,10 +8,11 @@ export function helpItem(term: string, termWidth: number, description: string, t const detail = stripAnsi(description) if (!detail || width - termWidth - 4 < 26) { return [ - ...wrap(name, width, ' ').map(line => theme.color(line, 'brand')), - ...(detail ? wrap(detail, width, ' ') : []), + ...wrapText(name, width, ' ').map(line => theme.color(line, 'brand')), + ...(detail ? wrapText(detail, width, ' ') : []), ].join('\n') } + // kolumna opisu trzyma szerokość — adres w opisie dzielimy jak zwykłe słowo const lines = wrap(detail, width - termWidth - 4) return lines.map((line, index) => `${index ? ' '.repeat(termWidth + 4) : ` ${theme.color(padVisible(name, termWidth), 'brand')} `}${line}`).join('\n') } diff --git a/packages/cli/src/ui/select.ts b/packages/cli/src/ui/select.ts index 90b2c76..4c6895a 100644 --- a/packages/cli/src/ui/select.ts +++ b/packages/cli/src/ui/select.ts @@ -35,6 +35,7 @@ export function renderChoices( const inline = choice.hint && labels.length === 1 && indent + visibleLength(choice.label) + 2 + visibleLength(choice.hint) <= theme.caps.width return [ ...labels.map((line, index) => `${index ? ' '.repeat(indent) : prefix}${choice.disabled ? theme.dim(line) : i === active ? theme.bold(line) : line}${inline ? theme.dim(` ${choice.hint}`) : ''}`), + // wiersz szerszy od terminala zawinąłby się i rozjechał przerysowanie listy (draw liczy wiersze) ...(choice.hint && !inline ? wrap(choice.hint, theme.caps.width, ' '.repeat(indent)).map(line => theme.dim(line)) : []), ] }) diff --git a/packages/cli/src/ui/wizard.ts b/packages/cli/src/ui/wizard.ts index 7977d75..e4d73fd 100644 --- a/packages/cli/src/ui/wizard.ts +++ b/packages/cli/src/ui/wizard.ts @@ -6,6 +6,7 @@ import { createInterface, type Interface } from 'node:readline/promises' import type { InferenceOutcome, InferredProfile } from 'trainctl-core' import { ui } from '../i18n/index.ts' +import { kmLabel, parseDecimal } from '../format.ts' import { sparkline, Theme } from './theme.ts' export interface WizardAnswers { @@ -72,7 +73,7 @@ export function parseTimeInput(text: string): number { export function parseDistanceInput(text: string): number { const key = text.trim().toLowerCase() if (DISTANCES[key]) return DISTANCES[key]! - const num = Number(key.replace(',', '.')) + const num = parseDecimal(key) if (Number.isFinite(num) && num > 0) return num throw new Error(ui().wizard.errDistance) } @@ -236,7 +237,7 @@ export async function runWizard( console.log(theme.bold(`\n${w.yourRunning}`)) const parseKm = (t: string) => { - const n = Number(t.replace(',', '.')) + const n = parseDecimal(t) if (!Number.isFinite(n) || n <= 0) throw new Error(w.errKm) return n } @@ -264,7 +265,7 @@ export async function runWizard( if (candidate) { const label = `${candidate.date} · ${candidate.name ?? ui().init.unnamed} · ` + - `${candidate.distanceKm} km — ${fmtClock(candidate.timeSec)}` + `${kmLabel(candidate.distanceKm)} — ${fmtClock(candidate.timeSec)}` console.log(theme.dim(` ${w.raceLooksLike(label, candidate.reason)}`)) if (await askYesNo(rl, theme, w.useThisResult)) { resultDate = candidate.date diff --git a/packages/cli/tsconfig.build.json b/packages/cli/tsconfig.build.json index adde9d3..5c16a92 100644 --- a/packages/cli/tsconfig.build.json +++ b/packages/cli/tsconfig.build.json @@ -10,5 +10,5 @@ "rewriteRelativeImportExtensions": true }, "include": ["src"], - "exclude": ["src/**/*.test.ts"] + "exclude": ["src/**/*.test.ts", "src/**/*.fixture.ts"] } diff --git a/packages/core/src/domain/goal-class.ts b/packages/core/src/domain/goal-class.ts new file mode 100644 index 0000000..9d7cd1a --- /dev/null +++ b/packages/core/src/domain/goal-class.ts @@ -0,0 +1,21 @@ +/** + * Klasa dystansu celu — jedno miejsce granic dla taperu (T-5), szczytu (P-7/P-8), + * bloku po starcie (R-1, R-8), predykcji (W-2, W-7) i lintów sezonu. + * Granice: ultra >42,5 km, maraton ≥42 km, HM ≥20,9 km. Warstwa domeny, żeby + * strefy (zones/) i silnik (engine/) korzystały z niej bez zależności od planera. + */ +import type { RaceGoal } from './types.ts' + +export type GoalClass = 'base' | 'ultra' | 'marathon' | 'half' | 'short' + +/** Klasa samego dystansu startu (bez celu bazowego). */ +export function distanceClass(km: number): Exclude { + if (km > 42.5) return 'ultra' + if (km >= 42.0) return 'marathon' + if (km >= 20.9) return 'half' + return 'short' +} + +export function goalClass(goal: Pick): GoalClass { + return goal.kind === 'base' ? 'base' : distanceClass(goal.distanceKm) +} diff --git a/packages/core/src/engine/adapt.ts b/packages/core/src/engine/adapt.ts index 0f7d281..a8aab0e 100644 --- a/packages/core/src/engine/adapt.ts +++ b/packages/core/src/engine/adapt.ts @@ -15,6 +15,7 @@ import type { RaceResult, WorkoutKind } from '../domain/types.ts' import { messages } from '../i18n/index.ts' import { diffDays } from '../util/dates.ts' +import { distanceClass } from '../domain/goal-class.ts' export interface ExecutionRecord { date: string @@ -120,7 +121,7 @@ export function analyzeExecution(input: AdaptationInput): AdaptationProposal { if (input.lastRace) { const sinceRace = diffDays(input.lastRace.date, input.today) if (sinceRace >= 0 && sinceRace <= 6) { - const ultra = input.lastRace.distanceKm > 42.5 + const ultra = distanceClass(input.lastRace.distanceKm) === 'ultra' diagnosis.push(m.adapt.postRaceDiagnosis(sinceRace, input.lastRace.distanceKm)) actions.push({ type: 'post-race-recovery', diff --git a/packages/core/src/engine/infer-profile.ts b/packages/core/src/engine/infer-profile.ts index 9e09fbd..6c1d7d7 100644 --- a/packages/core/src/engine/infer-profile.ts +++ b/packages/core/src/engine/infer-profile.ts @@ -9,6 +9,7 @@ import type { Weekday } from '../domain/types.ts' import type { SyncedActivity } from '../ports/sync.ts' import { messages } from '../i18n/index.ts' import { addDays, diffDays, mondayOf, parseIso } from '../util/dates.ts' +import { median } from '../util/stats.ts' /** Okno analizy w pełnych tygodniach (wartość inżynierska — ~3 miesiące formy). */ export const INFER_WINDOW_WEEKS = 16 @@ -55,12 +56,6 @@ const RACE_NAME_RE = /\b(bieg|maraton|półmaraton|polmaraton|parkrun|race|run|m const isRun = (a: SyncedActivity): boolean => /run/i.test(a.type) -function median(values: number[]): number { - const sorted = [...values].sort((a, b) => a - b) - const mid = Math.floor(sorted.length / 2) - return sorted.length % 2 ? sorted[mid]! : (sorted[mid - 1]! + sorted[mid]!) / 2 -} - function weekdayOf(iso: string): Weekday { const dow = parseIso(iso).getUTCDay() // 0 = niedziela return WEEKDAYS[(dow + 6) % 7]! diff --git a/packages/core/src/engine/macrocycle.ts b/packages/core/src/engine/macrocycle.ts index 8c338b3..ea53851 100644 --- a/packages/core/src/engine/macrocycle.ts +++ b/packages/core/src/engine/macrocycle.ts @@ -16,6 +16,7 @@ import type { import { addDays, diffDays, mondayOf } from '../util/dates.ts' import { messages } from '../i18n/index.ts' import { COACH_STYLE } from './house-style.ts' +import { goalClass, type GoalClass } from '../domain/goal-class.ts' /** P-2: tydzień odciążenia po 3 tygodniach ładowania. Współczynnik 0,7 — inż. */ const DELOAD_EVERY = 4 @@ -33,11 +34,13 @@ const TAPER_MULTIPLIERS: Record = { } export function taperWeeksFor(goal: RaceGoal): { weeks: number; flags: string[] } { - if (goal.kind === 'base') return { weeks: 0, flags: [] } // P-11: plan bez zawodów nie ma taperu - if (goal.distanceKm > 42.5) return { weeks: 3, flags: [messages().macro.ultraTaperExtrapolated] } - if (goal.distanceKm >= 42.0) return { weeks: 3, flags: [] } // maraton: 14–21 dni - if (goal.distanceKm >= 20.9) return { weeks: 2, flags: [] } // HM: 10–14 dni - return { weeks: 1, flags: [] } // 5–10 km: 7–10 dni + switch (goalClass(goal)) { + case 'base': return { weeks: 0, flags: [] } // P-11: plan bez zawodów nie ma taperu + case 'ultra': return { weeks: 3, flags: [messages().macro.ultraTaperExtrapolated] } + case 'marathon': return { weeks: 3, flags: [] } // maraton: 14–21 dni + case 'half': return { weeks: 2, flags: [] } // HM: 10–14 dni + case 'short': return { weeks: 1, flags: [] } // 5–10 km: 7–10 dni + } } /** T-9: mini-taper przed startem B — objętość tygodnia w dół o ~20%, makrocykl bez zmian. */ @@ -63,11 +66,13 @@ export function testDistanceKm(goal: RaceGoal): number { /** P-7/P-8: rekomendowana objętość szczytowa dla dystansu docelowego. */ export function recommendedPeakKm(goal: RaceGoal): number { - if (goal.kind === 'base') return 0 // bez dystansu docelowego nie ma progu P-7/P-8 - if (goal.distanceKm > 42.5) return 70 // inż. — brak źródła dla ultra (T-8) - if (goal.distanceKm >= 42.0) return 65 // P-8: >65 km/tydz. → −14 min - if (goal.distanceKm >= 20.9) return 42 // P-7: >32 km/tydz. + długi >21 km; inż. margines - return 35 // inż. dla 5–10 km + switch (goalClass(goal)) { + case 'base': return 0 // bez dystansu docelowego nie ma progu P-7/P-8 + case 'ultra': return 70 // inż. — brak źródła dla ultra (T-8) + case 'marathon': return 65 // P-8: >65 km/tydz. → −14 min + case 'half': return 42 // P-7: >32 km/tydz. + długi >21 km; inż. margines + case 'short': return 35 // inż. dla 5–10 km + } } export interface MacrocycleInput { @@ -85,7 +90,7 @@ export interface MacrocycleInput { const TRANSITION_FACTORS_LONG = [0.5, 1.0] const TRANSITION_FACTORS_SHORT = [0.7] /** R-1: 48 h ciszy po maratonie → pierwszy bieg 3. dnia; po HM 2. dnia, po krótszym nazajutrz (inż.). */ -const firstRunOffset = (km: number) => (km >= 42 ? 3 : km >= 20.9 ? 2 : 1) +const firstRunOffset = (cls: GoalClass) => (cls === 'marathon' || cls === 'ultra' ? 3 : cls === 'half' ? 2 : 1) /** * P-11 (inż.): plan bez zawodów rośnie do udokumentowanego szczytu * (`peakWeeklyKm`) albo +15% bieżącej objętości i tam się wypłaszcza. @@ -98,9 +103,10 @@ function transitionWeeks(goal: RaceGoal, weeks: WeekSkeleton[]): WeekSkeleton[] if (!raceWeek) return [] const before = weeks.slice(-5, -1) const base = before.length ? before.reduce((s, w) => s + w.targetKm, 0) / before.length : raceWeek.targetKm - const long = goal.distanceKm >= 20.9 + const cls = goalClass(goal) + const long = cls === 'half' || cls === 'marathon' || cls === 'ultra' const factors = long ? TRANSITION_FACTORS_LONG : TRANSITION_FACTORS_SHORT - const earliestRun = addDays(goal.date, firstRunOffset(goal.distanceKm)) + const earliestRun = addDays(goal.date, firstRunOffset(cls)) return factors.map((factor, j): WeekSkeleton => { const weekStart = addDays(raceWeek.weekStart, 7 * (j + 1)) return { @@ -153,12 +159,14 @@ export function planMacrocycle(input: MacrocycleInput): MacrocyclePlan { // Objętość: ramp od recentWeeklyKm do osiągalnego szczytu (P-3), sufit z historii const start = athlete.recentWeeklyKm + // E-3 (inż.): bez `peakWeeklyKm` sufit to bieżąca objętość +40% — brak źródła const cap = Math.min(athlete.peakWeeklyKm ?? start * 1.4, SANITY_CAP_KM) const recommended = recommendedPeakKm(goal) const loadOnly = Math.max(0, loadWeeks - Math.floor(loadWeeks / DELOAD_EVERY)) const reachable = start * Math.pow(RAMP_PER_LOAD_WEEK, Math.max(0, loadOnly - 1)) // P-7/P-8 to podłoga dla niedotrenowanych, nie sufit: atlecie z bazą powyżej // rekomendacji utrzymujemy (lekko rozwijamy) jego wolumen zamiast go ciąć. + // E-3 (inż.): plan ze startem celuje w bieżącą objętość +15% (sufit `cap`), nie niżej niż rekomendacja P-7/P-8 const targetPeak = baseOnly ? Math.min(athlete.peakWeeklyKm ?? start * BASE_GROWTH, cap) : Math.max(recommended, Math.min(start * 1.15, cap)) @@ -169,7 +177,8 @@ export function planMacrocycle(input: MacrocycleInput): MacrocyclePlan { ) } - // Fazy przed taperem: base/build piramidalnie (I-1), peak polaryzacja (I-2) + // Fazy przed taperem: base/build piramidalnie (I-1), peak polaryzacja (I-2). + // Podział 40% bazy i 20% szczytu to E-3 (inż.) — źródła podają kolejność faz, nie proporcje. const baseWeeks = Math.max(0, Math.round(loadWeeks * 0.4)) const peakWeeks = Math.max(loadWeeks >= 3 ? 1 : 0, Math.round(loadWeeks * 0.2)) const buildWeeks = Math.max(0, loadWeeks - baseWeeks - peakWeeks) diff --git a/packages/core/src/engine/microcycle.ts b/packages/core/src/engine/microcycle.ts index 785e8fb..0a87990 100644 --- a/packages/core/src/engine/microcycle.ts +++ b/packages/core/src/engine/microcycle.ts @@ -27,7 +27,18 @@ export function fmtPace(secPerKm: number): string { return `${m}:${String(s).padStart(2, '0')}` } -const mid = (r: { loSecPerKm: number; hiSecPerKm: number }) => +/** + * E-3 (inż.): sufit pojedynczego biegu spokojnego. Korpus nie ma reguły — to + * granica, przy której reszta kilometrów przestaje być „spokojną uzupełniającą". + */ +const EASY_RUN_CAP_KM = 18 +/** E-3 (inż.): część główna akcentu ≈ 22% tygodnia przed odjęciem rozgrzewki i schłodzenia. */ +const QUALITY_MAIN_SHARE = 0.22 +/** E-3 (inż.): kilometry poza Z1 najwyżej 25% tygodnia — margines pod I-5 (≥75% Z1). */ +const HARD_SHARE_MAX = 0.25 + +/** Środek zakresu tempa — tempo wpisywane w opis odcinka. */ +export const paceMid = (r: { loSecPerKm: number; hiSecPerKm: number }): number => Math.round((r.loSecPerKm + r.hiSecPerKm) / 2) /** @@ -45,9 +56,9 @@ export function recalibrateWorkout(workout: PlannedWorkout, zones: PaceZones, po ? { loSecPerKm: zones.easy.hiSecPerKm, hiSecPerKm: zones.easy.hiSecPerKm + 30 } : { ...zones.easy } } else if (s.type === 'intervals') { s.pace = { ...(polarized || workout.kind === 'sharpener' ? zones.interval : zones.threshold) } - s.description = s.description.replace(/\d+:\d{2}/g, fmtPace(mid(s.pace))) + s.description = s.description.replace(/\d+:\d{2}/g, fmtPace(paceMid(s.pace))) } else if (s.type === 'progression') { - s.pace = { loSecPerKm: mid(zones.threshold), hiSecPerKm: zones.marathon.hiSecPerKm } + s.pace = { loSecPerKm: paceMid(zones.threshold), hiSecPerKm: zones.marathon.hiSecPerKm } s.description = messages().workout.progression(s.distanceKm ?? 0, fmtPace(s.pace.hiSecPerKm), fmtPace(s.pace.loSecPerKm)) } else if (s.type === 'alternating') { s.pace = { loSecPerKm: zones.threshold.loSecPerKm, hiSecPerKm: zones.easy.loSecPerKm } @@ -147,9 +158,9 @@ function buildQualityIntervals( repM: 1000, distanceKm: reps, pace: z.interval, - recoverySec: 180, + recoverySec: 180, // E-3 (inż.): przerwy 3' trucht przy odcinkach @I, z korpusu bez reguły description: messages().workout.intervalsVo2( - reps, fmtPace(mid(z.interval)), 3, Math.ceil(reps / 2), 4, + reps, fmtPace(paceMid(z.interval)), 3, Math.ceil(reps / 2), 4, ), } } else if (mainKm >= 9) { @@ -161,8 +172,8 @@ function buildQualityIntervals( repM: 3000, distanceKm: reps * 3, pace: z.threshold, - recoverySec: 180, - description: messages().workout.intervals3Km(reps, fmtPace(mid(z.threshold)), 3), + recoverySec: 180, // E-3 (inż.) + description: messages().workout.intervals3Km(reps, fmtPace(paceMid(z.threshold)), 3), } } else { const reps = Math.max(4, Math.round(mainKm)) @@ -172,8 +183,8 @@ function buildQualityIntervals( repM: 1000, distanceKm: reps, pace: z.threshold, - recoverySec: 120, - description: messages().workout.intervalsKm(reps, fmtPace(mid(z.threshold)), 2), + recoverySec: 120, // E-3 (inż.): 2' marsz — zapis korpusu, bez reguły w FOUNDATIONS + description: messages().workout.intervalsKm(reps, fmtPace(paceMid(z.threshold)), 2), } } segments.push(main, segCooldown(style.cooldownKm)) @@ -204,7 +215,7 @@ function buildQualityContinuous( } } else { const from = z.marathon.hiSecPerKm - const to = mid(z.threshold) + const to = paceMid(z.threshold) main = { type: 'progression', distanceKm: mainKm, @@ -221,6 +232,7 @@ function buildQualityContinuous( } } +/** E-3 (inż.): przedstartowe 5×300 m @I — utrzymanie intensywności w tygodniu startu (T-1). */ function buildSharpener(style: HouseStyle, z: PaceZones): PlannedWorkout { const reps = 5 const repM = 300 @@ -237,7 +249,7 @@ function buildSharpener(style: HouseStyle, z: PaceZones): PlannedWorkout { distanceKm: (reps * repM) / 1000, pace: z.interval, recoverySec: 60, - description: messages().workout.intervalsShort(reps, repM, fmtPace(mid(z.interval)), 1), + description: messages().workout.intervalsShort(reps, repM, fmtPace(paceMid(z.interval)), 1), }, segCooldown(style.cooldownKm), ], @@ -345,6 +357,16 @@ export function generateMicrocycle(input: MicrocycleInput): Microcycle { export const plannedWeekKm = (skeleton: Pick): number => skeleton.timeCappedKm ?? skeleton.targetKm +/** + * Kilometry poza Z1 jednej jednostki: wszystko poza rozgrzewką, schłodzeniem + * i biegiem spokojnym; podbiegi w połowie, bo `distanceKm` liczy też zbieg. + * Jedna definicja dla generatora (sufit mocnych km) i lintów sezonu. + */ +export function hardKmOf(workout: PlannedWorkout): number { + return workout.segments.reduce((a, s) => + a + (['easy', 'warmup', 'cooldown'].includes(s.type) ? 0 : s.type === 'hills' ? (s.distanceKm ?? 0) / 2 : s.distanceKm ?? 0), 0) +} + /** * Sumy tygodnia liczone z dni — jedno źródło dla generatora, walidatora * (`trainctl check`) i `reschedule --apply`, który po przestawieniu tygodnia @@ -390,6 +412,7 @@ function planRaceWeek( Math.abs(raceIdx - 3 - WEEKDAY_ORDER.indexOf(a)) - Math.abs(raceIdx - 3 - WEEKDAY_ORDER.indexOf(b)), )[0] + // E-3 (inż.): bez liczby sesji ze szkieletu cztery; biegi spokojne po 5 km for (const wd of before.slice(0, Math.max(0, (sessionCount ?? 4) - 1))) { plan.set(wd, wd === sharpenerWd ? buildSharpener(style, zones) : buildEasy(5, zones)) } @@ -459,8 +482,10 @@ function planNormalWeek( // objętość const longKm = longWd ? Math.min(Math.round(style.longRunShare * target), style.longRunCapKm) : 0 - let qualityMainKm = Math.max(3, Math.round(0.22 * target) - style.warmupKm - style.cooldownKm) + // E-3 (inż.): część główna akcentu co najmniej 3 km + let qualityMainKm = Math.max(3, Math.round(QUALITY_MAIN_SHARE * target) - style.warmupKm - style.cooldownKm) const hillsRepsKm = (style.hillsReps * style.hillsRepM) / 1000 + // E-3 (inż.): spokojne wprowadzenie przed podbiegami 5–8 km, ~10% tygodnia const hillsEasyKm = hillsWd ? Math.min(8, Math.max(5, Math.round(0.1 * target))) : 0 const buildAll = () => { @@ -478,8 +503,9 @@ function planNormalWeek( const usedKm = [...plan.values()].reduce((s, w) => s + w.distanceKm, 0) const remaining = Math.max(0, target - usedKm) + // E-3 (inż.): wstępny przydział biegu spokojnego co najmniej 5 km const perEasy = easyWds.length - ? Math.min(18, Math.max(5, Math.round(remaining / easyWds.length))) + ? Math.min(EASY_RUN_CAP_KM, Math.max(5, Math.round(remaining / easyWds.length))) : 0 for (const wd of easyWds) plan.set(wd, buildEasy(perEasy, zones)) } @@ -506,11 +532,10 @@ function planNormalWeek( // Reconcile actual sessions with the macro budget. Minimum-sized accents are // optional; they must never force an unrequested increase in weekly distance. const total = () => [...plan.values()].reduce((n, w) => n + w.distanceKm, 0) - const hardKm = () => [...plan.values()].filter(w => w.kind !== 'race').reduce((n, w) => n + w.segments.reduce((a, s) => - a + (['easy', 'warmup', 'cooldown'].includes(s.type) ? 0 : s.type === 'hills' ? (s.distanceKm ?? 0) / 2 : s.distanceKm ?? 0), 0), 0) + const hardKm = () => [...plan.values()].filter(w => w.kind !== 'race').reduce((n, w) => n + hardKmOf(w), 0) for (const kind of ['quality_continuous', 'quality_intervals', 'easy_hills'] as const) { for (const [wd, workout] of plan) { - if (total() <= target && hardKm() <= target * 0.25) break + if (total() <= target && hardKm() <= target * HARD_SHARE_MAX) break if (workout.kind === kind) plan.set(wd, buildEasy(0, zones)) } } @@ -523,7 +548,7 @@ function planNormalWeek( } let remaining = Math.max(0, target - total()) for (const [i, wd] of easySlots.entries()) { - const km = Math.min(18, Math.round(remaining / (easySlots.length - i) * 10) / 10) + const km = Math.min(EASY_RUN_CAP_KM, Math.round(remaining / (easySlots.length - i) * 10) / 10) if (km > 0) plan.set(wd, buildEasy(km, zones)) else plan.delete(wd) remaining = Math.max(0, remaining - km) @@ -531,13 +556,13 @@ function planNormalWeek( // An all-quality template can leave no easy slot: release its smallest accent. if (remaining > 0.5 && !easySlots.length) { const replace = [...plan].reverse().find(([, w]) => w.kind === 'quality_continuous' || w.kind === 'easy_hills') - if (replace) plan.set(replace[0], buildEasy(Math.min(18, replace[1].distanceKm + remaining), zones)) + if (replace) plan.set(replace[0], buildEasy(Math.min(EASY_RUN_CAP_KM, replace[1].distanceKm + remaining), zones)) } remaining = Math.max(0, target - total()) for (const wd of free) { if (remaining <= 0.05) break if (plan.has(wd)) continue - const km = Math.min(18, Math.round(remaining * 10) / 10) + const km = Math.min(EASY_RUN_CAP_KM, Math.round(remaining * 10) / 10) plan.set(wd, buildEasy(km, zones)) remaining -= km } diff --git a/packages/core/src/engine/season.test.ts b/packages/core/src/engine/season.test.ts new file mode 100644 index 0000000..9575dbb --- /dev/null +++ b/packages/core/src/engine/season.test.ts @@ -0,0 +1,231 @@ +import { describe, expect, it } from 'vitest' +import type { Microcycle, PlannedWorkout, RaceGoal, Weekday } from '../domain/types.ts' +import { addDays } from '../util/dates.ts' +import { longRunThreshold, seasonLine, seasonProfile, seasonShapeIssues } from './season.ts' + +const WD: Weekday[] = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'] + +function week(start: string, workouts: Partial>, phase: Microcycle['skeleton']['phase'] = 'build'): Microcycle { + const days = WD.map((weekday, i) => ({ date: addDays(start, i), weekday, ...(workouts[weekday] ? { workout: workouts[weekday] } : {}) })) + const totalKm = days.reduce((s, d) => s + (d.workout?.distanceKm ?? 0), 0) + return { + weekStart: start, days, totalKm, easyShare: 1, + skeleton: { weekStart: start, index: 0, phase, intensityModel: 'pyramidal', targetKm: totalKm, deload: false, keepIntensity: false, keepFrequency: false, qualitySessions: 1, flags: [], ruleRefs: [] }, + } +} +const easy = (km: number): PlannedWorkout => ({ kind: 'easy', distanceKm: km, ruleRefs: [], segments: [{ type: 'easy', distanceKm: km, description: '' }] }) +const long = (km: number): PlannedWorkout => ({ ...easy(km), kind: 'long' }) +const marathon: RaceGoal = { kind: 'race', name: 'M', date: '2027-04-25', distanceKm: 42.195, priority: 'A' } +const half: RaceGoal = { ...marathon, distanceKm: 21.0975 } + +describe('longBelowGoal', () => { + it('maraton: 25 km spełnia P-8 („najdłuższy <25 km" jest karany)', () => { + const weeks = [week('2027-01-04', { tue: easy(10), sat: long(25) })] + expect(seasonShapeIssues({ goal: marathon, weeks }).some((i) => i.code === 'longBelowGoal')).toBe(false) + const short = [week('2027-01-04', { tue: easy(10), sat: long(24.9) })] + expect(seasonShapeIssues({ goal: marathon, weeks: short }).some((i) => i.code === 'longBelowGoal')).toBe(true) + }) + it('półmaraton: 21 km nie spełnia J-2 (wymaga >21 km)', () => { + const weeks = [week('2027-01-04', { tue: easy(10), sat: long(21) })] + expect(seasonShapeIssues({ goal: half, weeks }).some((i) => i.code === 'longBelowGoal')).toBe(true) + }) +}) + +describe('akcenty w profilu sezonu', () => { + const steady: PlannedWorkout = { + kind: 'quality_continuous', distanceKm: 10, ruleRefs: [], + segments: [ + { type: 'warmup', distanceKm: 3, description: '' }, + { type: 'steady', distanceKm: 6, description: '' }, + { type: 'cooldown', distanceKm: 1, description: '' }, + ], + } + const hills: PlannedWorkout = { + kind: 'easy_hills', distanceKm: 13, ruleRefs: [], + segments: [ + { type: 'easy', distanceKm: 6, description: '' }, + { type: 'hills', reps: 15, repM: 200, distanceKm: 6, description: '' }, + { type: 'cooldown', distanceKm: 1, description: '' }, + ], + } + it('odcinek steady liczy się jako praca poza Z1, podbiegi w połowie', () => { + const [row] = seasonProfile([week('2027-01-04', { tue: steady, thu: hills, sat: long(18) })]) + expect(row!.accents.map((a) => a.hardKm)).toEqual([6, 3]) + }) + it('dawka bez słów w żadnym języku', () => { + const line = seasonLine(seasonProfile([week('2027-01-04', { tue: steady, thu: hills, sat: long(18) })])[0]!) + expect(line.replace(/quality_continuous|easy_hills|build/g, '').replace(/\bkm\b/g, '')).not.toMatch(/[a-ząćęłńóśźż]{3,}/i) + }) +}) + +describe('postRaceAccentHeavy', () => { + const intervals = (reps: number): PlannedWorkout => ({ + kind: 'quality_intervals', distanceKm: 4 + reps, ruleRefs: [], + segments: [ + { type: 'warmup', distanceKm: 3, description: '' }, + { type: 'intervals', reps, repM: 1000, distanceKm: reps, description: '' }, + { type: 'cooldown', distanceKm: 1, description: '' }, + ], + }) + it('sufit to ostatni blok budowania, nie najlżejszy tydzień całego budowania', () => { + const deload = week('2027-01-11', { tue: easy(8), sat: long(12) }) + deload.skeleton.deload = true + const weeks = [ + week('2027-01-04', { tue: intervals(2), sat: long(16) }), + deload, + week('2027-01-18', { tue: intervals(4), sat: long(18) }), + week('2027-01-25', { tue: intervals(3), sat: long(8) }, 'transition'), + ] + expect(seasonShapeIssues({ goal: half, weeks }).some((i) => i.code === 'postRaceAccentHeavy')).toBe(false) + weeks[3] = week('2027-01-25', { tue: intervals(5), sat: long(8) }, 'transition') + expect(seasonShapeIssues({ goal: half, weeks }).some((i) => i.code === 'postRaceAccentHeavy')).toBe(true) + }) +}) + +describe('postRaceAccentHeavy: sufit odporny na jedną krótką jednostkę', () => { + const accent = (main: number): PlannedWorkout => ({ + kind: 'quality_intervals', distanceKm: 4 + main, ruleRefs: [], + segments: [ + { type: 'warmup', distanceKm: 3, description: '' }, + { type: 'intervals', reps: main, repM: 1000, distanceKm: main, description: '' }, + { type: 'cooldown', distanceKm: 1, description: '' }, + ], + }) + it('jeden akcent 1 km w bloku nie zbija sufitu do 1 km', () => { + const weeks = [ + week('2027-01-04', { tue: accent(6), sun: accent(1), sat: long(18) }), + week('2027-01-11', { tue: accent(6), sun: accent(5), sat: long(18) }), + week('2027-01-18', { tue: accent(5), sat: long(8) }, 'transition'), + ] + expect(seasonShapeIssues({ goal: half, weeks }).some((i) => i.code === 'postRaceAccentHeavy')).toBe(false) + }) +}) + +describe('longRunThreshold: klasa dystansu jak w recommendedPeakKm', () => { + it('maraton, półmaraton, 10 km, ultra', () => { + expect(longRunThreshold({ kind: 'race', distanceKm: 42.195 })).toMatchObject({ km: 25, ruleRefs: ['P-8', 'J-1'] }) + expect(longRunThreshold({ kind: 'race', distanceKm: 21.0975 })).toMatchObject({ km: 21, ruleRefs: ['J-2', 'P-7'] }) + expect(longRunThreshold({ kind: 'race', distanceKm: 10 })).toBeUndefined() + // ultra nie ma progu w źródłach (T-8) — lint się nie wypowiada + expect(longRunThreshold({ kind: 'race', distanceKm: 50 })).toBeUndefined() + }) +}) + +describe('postRaceAccentHeavy: mediana i kolejność cykli', () => { + const accent = (main: number): PlannedWorkout => ({ + kind: 'quality_intervals', distanceKm: 4 + main, ruleRefs: [], + segments: [ + { type: 'warmup', distanceKm: 3, description: '' }, + { type: 'intervals', reps: main, repM: 1000, distanceKm: main, description: '' }, + { type: 'cooldown', distanceKm: 1, description: '' }, + ], + }) + const flagged = (weeks: Microcycle[]) => seasonShapeIssues({ goal: half, weeks }).filter((i) => i.code === 'postRaceAccentHeavy').map((i) => i.date) + + it('parzysta liczba akcentów: średnia dwóch środkowych (1 i 6 km → 3,5 km)', () => { + const weeks = [ + week('2027-01-04', { tue: accent(1), sun: accent(6), sat: long(18) }), + week('2027-01-11', { tue: accent(3), sat: long(8) }, 'transition'), + ] + expect(flagged(weeks)).toEqual([]) + weeks[1] = week('2027-01-11', { tue: accent(4), sat: long(8) }, 'transition') + expect(flagged(weeks)).toEqual(['2027-01-11']) + }) + + it('kilka cykli: tydzień przejściowy porównany z budowaniem przed nim, nie z następnym cyklem', () => { + const weeks = [ + week('2027-01-04', { tue: accent(4), sat: long(18) }), + week('2027-01-11', { tue: accent(4), sat: long(8) }, 'transition'), + week('2027-01-18', { tue: easy(8), sat: long(12) }, 'base'), + week('2027-01-25', { tue: accent(2), sat: long(14) }), + ] + expect(flagged(weeks)).toEqual([]) + }) +}) + +describe('linty oceniają bieżący cykl', () => { + it('długie 30 km z poprzedniego cyklu nie spełnia progu nowego półmaratonu', () => { + const weeks = [ + week('2026-12-07', { tue: easy(10), sat: long(30) }), + week('2027-01-04', { tue: easy(10), sat: long(18) }), + ] + const codes = (cycleStart?: string) => seasonShapeIssues({ goal: half, weeks, ...(cycleStart ? { cycleStart } : {}) }).map((i) => i.code) + expect(codes()).not.toContain('longBelowGoal') + expect(codes('2027-01-04')).toContain('longBelowGoal') + }) +}) + +describe('siedemnasta runda: długie wobec akcentów, R-8 bez budowania', () => { + const continuous = (main: number): PlannedWorkout => ({ + kind: 'quality_continuous', distanceKm: 4 + main, ruleRefs: [], + segments: [ + { type: 'warmup', distanceKm: 3, description: '' }, + { type: 'steady', distanceKm: main, description: '' }, + { type: 'cooldown', distanceKm: 1, description: '' }, + ], + }) + it('akcent dłuższy od długiego to longNotLongest (J-1, S-2)', () => { + const weeks = [week('2027-01-04', { tue: continuous(8), sat: long(10) })] + expect(seasonShapeIssues({ goal: half, weeks }).some((i) => i.code === 'longNotLongest')).toBe(true) + }) + it('plan bez budowania: R-8 z ostatniego bloku ładowania (szczyt)', () => { + const weeks = [ + week('2027-01-04', { tue: continuous(3), sat: long(16) }, 'peak'), + week('2027-01-11', { tue: continuous(6), sat: long(8) }, 'transition'), + ] + expect(seasonShapeIssues({ goal: half, weeks }).some((i) => i.code === 'postRaceAccentHeavy')).toBe(true) + }) +}) + +describe('osiemnasta runda: dwa długie w tygodniu, R-8 w kolejnym cyklu', () => { + const continuous = (main: number): PlannedWorkout => ({ + kind: 'quality_continuous', distanceKm: 4 + main, ruleRefs: [], + segments: [ + { type: 'warmup', distanceKm: 3, description: '' }, + { type: 'steady', distanceKm: main, description: '' }, + { type: 'cooldown', distanceKm: 1, description: '' }, + ], + }) + it('dwa długie: porównujemy najdłuższe z nich z resztą tygodnia', () => { + const weeks = [week('2027-01-04', { tue: easy(14), sat: long(12), sun: long(16) })] + expect(seasonShapeIssues({ goal: half, weeks }).some((i) => i.code === 'longNotLongest')).toBe(false) + }) + it('drugi cykl bez budowania: sufit z jego bloku ładowania, nie z budowania poprzedniego cyklu', () => { + const weeks = [ + week('2027-01-04', { tue: continuous(6), sat: long(18) }), + week('2027-01-11', { tue: easy(6), sat: long(8) }, 'transition'), + week('2027-01-18', { tue: continuous(3), sat: long(14) }, 'base'), + week('2027-01-25', { tue: continuous(5), sat: long(8) }, 'transition'), + ] + expect(seasonShapeIssues({ goal: half, weeks }).filter((i) => i.code === 'postRaceAccentHeavy').map((i) => i.date)).toEqual(['2027-01-25']) + }) +}) + +describe('dziewiętnasta runda: bieżący cykl bez cycleStart', () => { + it('plan z historią bez cycleStart: linty od pierwszego tygodnia ładowania po bloku przejściowym', () => { + const weeks = [ + week('2026-12-07', { tue: easy(10), sat: long(30) }), + week('2026-12-14', { tue: easy(6), sat: long(8) }, 'transition'), + week('2026-12-21', { tue: easy(10), sat: long(18) }), + ] + expect(seasonShapeIssues({ goal: half, weeks }).map((i) => i.code)).toContain('longBelowGoal') + }) +}) + +describe('dwudziesta pierwsza runda: cykl bez tygodni ładowania', () => { + it('cykl z samym taperem i startem: bez longBelowGoal', () => { + const weeks = [week('2027-01-04', { tue: easy(8), sat: easy(6) }, 'taper'), week('2027-01-11', { tue: easy(5) }, 'race')] + expect(seasonShapeIssues({ goal: half, weeks }).map((i) => i.code)).not.toContain('longBelowGoal') + }) + it('nowy cykl zaczęty taperem po bloku przejściowym: linty nie sięgają do poprzedniego cyklu', () => { + const deload = week('2026-12-07', { tue: easy(15), sat: long(13) }) + deload.skeleton.deload = true + const weeks = [ + deload, + week('2026-12-14', { tue: easy(6), sat: long(8) }, 'transition'), + week('2026-12-21', { tue: easy(8), sat: easy(6) }, 'taper'), + week('2026-12-28', { tue: easy(5) }, 'race'), + ] + expect(seasonShapeIssues({ goal: half, weeks }).map((i) => i.code)).not.toContain('longNotLongest') + }) +}) diff --git a/packages/core/src/engine/season.ts b/packages/core/src/engine/season.ts new file mode 100644 index 0000000..a4b318c --- /dev/null +++ b/packages/core/src/engine/season.ts @@ -0,0 +1,237 @@ +/** + * Profil sezonu i linty kształtu (docs/PLAN-v0.7.md, B0). + * + * `validatePlan` pilnuje reguł pojedynczego tygodnia; tutaj patrzymy na sezon: + * czy długie jest najdłuższe, czy odciążenie jest lżejsze, czy dawka rośnie. + * Wynik służy testom macierzy profili i (od etapu 2) komendzie `check`. + * Progi oznaczone „inż." są wyborem inżynierskim (E-3), nie wynikiem badań. + */ +import type { MacroPhase, Microcycle, PlannedWorkout, RaceGoal } from '../domain/types.ts' +import { goalClass } from '../domain/goal-class.ts' +import { median } from '../util/stats.ts' +import { fmtPace, hardKmOf, paceMid } from './microcycle.ts' + +export interface SeasonAccent { + kind: PlannedWorkout['kind'] + /** Kilometry poza Z1 (część główna akcentu, odcinki podbiegów, pomiar). */ + hardKm: number + /** Dawka części głównej bez słów (język neutralny): `4×1000@4:32`, `4 km 5:01→4:32`, `15×200`. */ + dose: string +} + +export interface SeasonRow { + index: number + weekStart: string + phase: MacroPhase + deload: boolean + km: number + runs: number + longKm: number + accents: SeasonAccent[] + strength: number + flags: ('test' | 'tuneUp' | 'race')[] +} + +const QUALITY = new Set(['quality_intervals', 'quality_continuous', 'easy_hills', 'sharpener', 'test']) +const round1 = (n: number) => Math.round(n * 10) / 10 + +function accentOf(w: PlannedWorkout): SeasonAccent { + const parts: string[] = [] + for (const s of w.segments) { + if (s.type === 'intervals') { + parts.push(`${s.reps ?? 1}×${s.repM ?? 0}${s.pace ? '@' + fmtPace(paceMid(s.pace)) : ''}`) + } else if (s.type === 'progression') { + parts.push(`${s.distanceKm} km${s.pace ? ` ${fmtPace(s.pace.hiSecPerKm)}→${fmtPace(s.pace.loSecPerKm)}` : ''}`) + } else if (s.type === 'alternating') { + parts.push(`${s.distanceKm} km${s.pace ? ` ${fmtPace(s.pace.loSecPerKm)}/${fmtPace(s.pace.hiSecPerKm)}` : ''}`) + } else if (s.type === 'steady') { + parts.push(`${s.distanceKm} km${s.pace ? '@' + fmtPace(s.pace.loSecPerKm) : ''}`) + } else if (s.type === 'hills') { + parts.push(`${s.reps ?? 1}×${s.repM ?? 0}`) + } else if (s.type === 'race') { + parts.push(`${s.distanceKm} km`) + } + } + return { kind: w.kind, hardKm: round1(hardKmOf(w)), dose: parts.join(' + ') } +} + +/** Jeden wiersz na tydzień: to, co trener ogląda, przeglądając sezon. */ +export function seasonProfile(weeks: Microcycle[]): SeasonRow[] { + return weeks.map((week, index) => { + const runs = week.days.flatMap((d) => (d.workout && d.workout.kind !== 'race' ? [d.workout] : [])) + const sk = week.skeleton + return { + index, + weekStart: week.weekStart, + phase: sk.phase, + deload: sk.deload, + km: round1(week.totalKm), + runs: runs.length, + longKm: Math.max(0, ...runs.filter((w) => w.kind === 'long').map((w) => w.distanceKm)), + accents: runs.filter((w) => QUALITY.has(w.kind)).map(accentOf), + strength: week.days.filter((d) => d.strength).length, + flags: [ + ...(sk.testPlanned ? (['test'] as const) : []), + ...(sk.tuneUp ? (['tuneUp'] as const) : []), + ...(sk.raceDate ? (['race'] as const) : []), + ], + } + }) +} + +/** Jeden wiersz tekstu na tydzień — format migawki testów i przeglądu trenerskiego. */ +export function seasonLine(r: SeasonRow): string { + const accents = r.accents.map((a) => `${a.kind}:${a.dose}`).join(' | ') + return [ + String(r.index + 1).padStart(2), + r.weekStart, + (r.phase + (r.deload ? '↓' : '')).padEnd(11), + String(r.km).padStart(5), + `${r.runs}b`, + `L${r.longKm}`, + `S${r.strength}`, + ...(r.flags.length ? [`[${r.flags.join(',')}]`] : []), + accents, + ].join(' ').trimEnd() +} + +/** Wszystkie kody lintów kształtu — test macierzy liczy je stąd, nie z ręcznej kopii. */ +export const SHAPE_CODES = ['longNotLongest', 'deloadNotLighter', 'sessionShareHigh', 'postRaceAccentHeavy', 'staleProgression', 'longBelowGoal'] as const +export type ShapeCode = (typeof SHAPE_CODES)[number] + +export interface ShapeIssue { + code: ShapeCode + /** Tydzień (poniedziałek) albo dzień, którego dotyczy; pusty dla całego planu. */ + date: string + ruleRefs: string[] + values: number[] +} + +/** Udział jednej jednostki w tygodniu, powyżej którego tydzień „wisi" na niej (inż., E-3). */ +export const SESSION_SHARE_MAX = 0.35 +/** + * Próg najdłuższego biegu dla dystansu: HM — dłuższy niż 21 km (J-2, P-7), + * maraton — co najmniej 25 km (P-8 karze „najdłuższy <25 km"). + */ +export function longRunThreshold(goal: Pick): { km: number; inclusive: boolean; ruleRefs: string[] } | undefined { + // klasa dystansu z tej samej funkcji co taper i szczyt objętości + const kind = goalClass(goal) + if (kind === 'marathon') return { km: 25, inclusive: true, ruleRefs: ['P-8', 'J-1'] } + if (kind === 'half') return { km: 21, inclusive: false, ruleRefs: ['J-2', 'P-7'] } + return undefined +} + +const LOADING_PHASES = new Set(['base', 'build', 'peak']) + +/** + * Początek bieżącego cyklu w planie bez `cycleStart`: pierwszy tydzień po ostatnim + * bloku przejściowym. Plan z jednym cyklem — undefined (cały plan). Regeneracja + * z historią zawsze zapisuje `cycleStart`, więc to tylko zabezpieczenie dla planów + * złożonych inaczej (testy, starsze pliki). + */ +function currentCycleStart(weeks: Microcycle[]): string | undefined { + let start: string | undefined + for (let i = 1; i < weeks.length; i++) { + // nowy cykl zaczyna pierwszy tydzień po bloku przejściowym — także taper albo start + if (weeks[i - 1]!.skeleton.phase === 'transition' && weeks[i]!.skeleton.phase !== 'transition') start = weeks[i]!.weekStart + } + return start +} +const isLoading = (w: Microcycle) => LOADING_PHASES.has(w.skeleton.phase) && !w.skeleton.deload + +/** `rows` — profil już policzony przez wołającego (unika drugiego przebiegu). */ +export function seasonShapeIssues(plan: { goal: Pick; weeks: Microcycle[]; cycleStart?: string | undefined }, rows = seasonProfile(plan.weeks)): ShapeIssue[] { + const issues: ShapeIssue[] = [] + // Plan z historią trzyma tygodnie poprzednich cykli. Oceniamy bieżący cykl (od + // `cycleStart`, a bez niego od pierwszego tygodnia po ostatnim bloku przejściowym, + // także taperu albo startu): inaczej długie 30 km z poprzedniego maratonu „spełniałoby" próg + // nowego półmaratonu, a bloki i odciążenia porównywałyby się między cyklami. + const from = plan.cycleStart ?? currentCycleStart(plan.weeks) + const weeks = from ? plan.weeks.filter((w) => w.weekStart >= from) : plan.weeks + rows = from ? rows.filter((r) => r.weekStart >= from) : rows + + for (const week of weeks) { + const runs = week.days.flatMap((d) => (d.workout ? [{ date: d.date, w: d.workout }] : [])) + // najdłuższe z długich (po `shift` tydzień bywa ma dwa), porównane z resztą biegów + const long = runs.filter((r) => r.w.kind === 'long').sort((a, z) => z.w.distanceKm - a.w.distanceKm)[0] + // J-1/S-2: długie jest najdłuższym biegiem tygodnia — także wobec akcentów i podbiegów + const others = runs.filter((r) => r.w !== long?.w && !['race', 'test', 'sharpener'].includes(r.w.kind)) + const longest = Math.max(0, ...others.map((r) => r.w.distanceKm)) + if (long && longest > long.w.distanceKm) issues.push({ code: 'longNotLongest', date: week.weekStart, ruleRefs: ['S-2', 'J-1'], values: [long.w.distanceKm, longest] }) + // jedna jednostka nie dźwiga tygodnia (inż.) + if (week.totalKm > 0 && week.skeleton.phase !== 'race') { + for (const r of runs) { + if (['long', 'race', 'test'].includes(r.w.kind)) continue + if (r.w.distanceKm > SESSION_SHARE_MAX * week.totalKm) issues.push({ code: 'sessionShareHigh', date: r.date, ruleRefs: ['E-3'], values: [r.w.distanceKm, round1(week.totalKm)] }) + } + } + } + + // P-2: odciążenie lżejsze od sąsiednich tygodni ładowania + weeks.forEach((week, i) => { + if (!week.skeleton.deload) return + const prev = weeks.slice(0, i).reverse().find(isLoading) + const next = weeks.slice(i + 1).find(isLoading) + const neighbours = [prev, next].filter((w): w is Microcycle => !!w).map((w) => w.totalKm) + if (neighbours.length && week.totalKm >= Math.min(...neighbours)) { + issues.push({ code: 'deloadNotLighter', date: week.weekStart, ruleRefs: ['P-2'], values: [round1(week.totalKm), round1(Math.min(...neighbours))] }) + } + }) + + // R-8: akcent w bloku przejściowym (po starcie celu) nie większy niż typowy akcent + // ostatniego bloku budowania przed nim (mediana — jedna skrócona jednostka nie zbija + // sufitu). Blok to tygodnie ładowania między odciążeniami; liczy się ostatni z akcentami + // innymi niż podbiegi. Oceniany jest jeden cykl (wyżej), więc blok przejściowy jest jeden. + // Plan bez budowania (krótki horyzont) albo z samymi podbiegami w budowaniu: sufit + // z ostatniego bloku ładowania przed startem (baza, szczyt), żeby R-8 nie znikało. + let buildBlock: number[] = [], buildCeiling: number[] = [] + let loadBlock: number[] = [], loadCeiling: number[] = [] + for (const r of rows) { + if (LOADING_PHASES.has(r.phase)) { + if (r.phase !== 'build' && buildBlock.length) { buildCeiling = buildBlock; buildBlock = [] } + if (r.deload) { + if (buildBlock.length) buildCeiling = buildBlock + if (loadBlock.length) loadCeiling = loadBlock + buildBlock = []; loadBlock = [] + continue + } + if (r.flags.length) continue + const hard = r.accents.filter((a) => a.kind !== 'easy_hills').map((a) => a.hardKm) + loadBlock.push(...hard) + if (r.phase === 'build') buildBlock.push(...hard) + continue + } + if (buildBlock.length) { buildCeiling = buildBlock; buildBlock = [] } + if (loadBlock.length) { loadCeiling = loadBlock; loadBlock = [] } + const ceilingHard = buildCeiling.length ? buildCeiling : loadCeiling + if (r.phase !== 'transition' || !ceilingHard.length) continue + const ceiling = round1(median(ceilingHard)) + for (const a of r.accents) if (a.kind !== 'easy_hills' && a.hardKm > ceiling) issues.push({ code: 'postRaceAccentHeavy', date: r.weekStart, ruleRefs: ['R-8'], values: [a.hardKm, ceiling] }) + } + + // P-1: kolejne bloki ładowania w budowaniu/szczycie nie powtarzają tej samej dawki + const blocks: SeasonRow[][] = [] + let current: SeasonRow[] = [] + for (const r of rows) { + if (r.phase !== 'build' && r.phase !== 'peak') { if (current.length) blocks.push(current); current = []; continue } + if (r.deload) { if (current.length) blocks.push(current); current = []; continue } + if (!r.flags.length) current.push(r) + } + if (current.length) blocks.push(current) + const signature = (r: SeasonRow) => JSON.stringify([r.longKm, r.accents.map((a) => [a.kind, a.dose])]) + for (let i = 1; i < blocks.length; i++) { + const a = blocks[i - 1]!.at(-1)!, z = blocks[i]!.at(-1)! + if (signature(a) === signature(z)) issues.push({ code: 'staleProgression', date: z.weekStart, ruleRefs: ['P-1'], values: [a.index + 1, z.index + 1] }) + } + + // J-2/P-7/P-8: najdłuższy bieg planu przed taperem a próg dla dystansu + const threshold = longRunThreshold(plan.goal) + if (threshold !== undefined) { + // cykl bez tygodni ładowania (start za tydzień): długiego nie ma czym zbudować — bez lintu + const loading = rows.filter((r) => LOADING_PHASES.has(r.phase)) + const longest = Math.max(0, ...loading.map((r) => r.longKm)) + const meets = threshold.inclusive ? longest >= threshold.km : longest > threshold.km + if (loading.length && !meets) issues.push({ code: 'longBelowGoal', date: '', ruleRefs: threshold.ruleRefs, values: [longest, threshold.km] }) + } + return issues +} diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts index 5b5140e..193b3b3 100644 --- a/packages/core/src/index.ts +++ b/packages/core/src/index.ts @@ -1,4 +1,5 @@ export * from './domain/types.ts' +export * from './domain/goal-class.ts' export * from './i18n/index.ts' export * from './util/dates.ts' export * from './zones/daniels.ts' @@ -12,6 +13,7 @@ export * from './engine/adapt.ts' export * from './engine/infer-profile.ts' export * from './engine/strength.ts' export * from './engine/validate.ts' +export * from './engine/season.ts' export * from './engine/desk.ts' export * from './engine/duration.ts' export * from './engine/shorten.ts' diff --git a/packages/core/src/util/stats.ts b/packages/core/src/util/stats.ts new file mode 100644 index 0000000..0f319a6 --- /dev/null +++ b/packages/core/src/util/stats.ts @@ -0,0 +1,6 @@ +/** Mediana; przy parzystej liczbie wartości średnia dwóch środkowych. */ +export function median(values: number[]): number { + const sorted = [...values].sort((a, b) => a - b) + const mid = Math.floor(sorted.length / 2) + return sorted.length % 2 ? sorted[mid]! : (sorted[mid - 1]! + sorted[mid]!) / 2 +} diff --git a/packages/core/src/zones/predict.ts b/packages/core/src/zones/predict.ts index 55cc1b7..5ec573f 100644 --- a/packages/core/src/zones/predict.ts +++ b/packages/core/src/zones/predict.ts @@ -6,6 +6,7 @@ import type { RaceResult } from '../domain/types.ts' import { diffDays } from '../util/dates.ts' import { predictTimeSec, vdotFromRace } from './daniels.ts' import { messages } from '../i18n/index.ts' +import { distanceClass } from '../domain/goal-class.ts' export interface RacePrediction { distanceKm: number @@ -34,8 +35,8 @@ const MARATHON_KM = 42.195 const HM_TO_MARATHON = 2.28 const HM_TO_MARATHON_MAE = 0.0567 +/** Wynik na dystansie półmaratonu (wąski zakres tolerancji pomiaru) — nie klasa celu. */ const isHm = (km: number) => km >= 20.9 && km <= 21.3 -const isMarathon = (km: number) => km >= 42.0 && km <= 42.5 function pickSource(results: RaceResult[], targetKm: number, today?: string): RaceResult { const valid = results.filter((r) => r.distanceKm > 0 && r.timeSec > 0) @@ -59,7 +60,7 @@ export function predictRace( const ruleRefs: string[] = ['W-1'] // Ultra: brak predykcji punktowej (W-7) — ekstrapolacja Riegla z szerokim pasmem - if (targetKm > 42.5) { + if (distanceClass(targetKm) === 'ultra') { const source = pickSource(results, targetKm, opts.today) const base = riegelTimeSec(source.timeSec, source.distanceKm, targetKm) ruleRefs.push('W-5', 'W-7', 'W-8') @@ -83,7 +84,7 @@ export function predictRace( } // Maraton: predyktor podstawowy = czas HM (W-2); VDOT tylko dla szybkich (W-3) - if (isMarathon(targetKm)) { + if (distanceClass(targetKm) === 'marathon') { const hm = results.filter((r) => isHm(r.distanceKm) && r.timeSec > 0) if (hm.length > 0) { const source = pickSource(hm, targetKm, opts.today) diff --git a/packages/mcp/src/server.test.ts b/packages/mcp/src/server.test.ts index ffef7e3..70d1965 100644 --- a/packages/mcp/src/server.test.ts +++ b/packages/mcp/src/server.test.ts @@ -211,7 +211,7 @@ describe('serwer MCP trainctl', () => { }) expect(log.isError).toBe(false) const week = await call('trainctl_week', { date: '2026-08-05' }) - expect(week.text).toContain('[done]') + expect(week.text).toContain('[wykonany]') // odprawa cytuje odczucie dosłownie — materiał do rozmowy, nie do liczenia (ADR-027) const review = await call('trainctl_review', { date: '2026-08-05' }) expect(review.text).toContain('RPE 6') diff --git a/tools/corpus/post_race_profile.py b/tools/corpus/post_race_profile.py index fc685d9..30381e7 100644 --- a/tools/corpus/post_race_profile.py +++ b/tools/corpus/post_race_profile.py @@ -12,7 +12,6 @@ """ import io import json -import re import statistics import sys from datetime import date, timedelta @@ -20,24 +19,14 @@ sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8') ROOT = Path(__file__).resolve().parents[2] +# `python -I` nie dodaje katalogu skryptu do sys.path — dodajemy własny katalog jawnie +sys.path.insert(0, str(Path(__file__).resolve().parent)) +from races import race_km # noqa: E402 (wspólna reguła startów, races.py) QUALITY = {'intervals', 'hills', 'progression', 'alternating', 'steady', 'steady_time', 'time_block', 'pickups', 'hills_drills'} MIN_RACE_KM = 21.0 HORIZON = 14 -def race_km(workout): - race = workout.get('race') or {} - if isinstance(race.get('distance_km'), (int, float)): - return float(race['distance_km']) - raw = (race.get('raw') or workout.get('raw') or '').upper() - if re.search(r'P[OÓ]{1}[ŁL]MARATON|HALF', raw): - return 21.0975 - if re.search(r'MARATON', raw): - return 42.195 - m = re.search(r'(\d{2,3})\s*KM', raw) - return float(m.group(1)) if m else None - - def km(workout): est = workout.get('distance_km_est') return est[1] if isinstance(est, list) and len(est) == 2 else 0.0 diff --git a/tools/corpus/races.py b/tools/corpus/races.py new file mode 100644 index 0000000..7df3a80 --- /dev/null +++ b/tools/corpus/races.py @@ -0,0 +1,29 @@ +# -*- coding: utf-8 -*- +"""Wspólne rozpoznanie dystansu startu dla skryptów pomiarowych korpusu. + +Jedna reguła dla post_race_profile.py (R-8) i season_profile.py (P-12, J-10): +oba pomiary liczą na tym samym zbiorze startów. +""" +import re + + +def race_km(workout): + """Dystans startu w km albo None, gdy z zapisu nie da się go ustalić. + + Kolejność: jawny dystans z parsera; ultra — największe „NN KM" w opisie albo + None; półmaraton; maraton; inaczej największe „NN KM" (dystans startu jest + zwykle największą liczbą w opisie, rozgrzewka „3 KM" nie wygrywa). + Opis startu, a gdy go brak — opis całej jednostki. + """ + race = workout.get('race') or {} + if isinstance(race.get('distance_km'), (int, float)): + return float(race['distance_km']) + raw = (race.get('raw') or workout.get('raw') or '').upper() + kms = [float(x.replace(',', '.')) for x in re.findall(r'(? 0 and not (segments and segments <= NON_RUN) + + +def segment_km(s): + """Górna granica dystansu segmentu; niepełny albo pusty zapis to 0, nie wyjątek.""" + d = s.get('distance_km') + return float(d[1]) if isinstance(d, list) and len(d) == 2 and isinstance(d[1], (int, float)) else 0.0 + + +def hard_km(w): + """Kilometry poza Z1: wszystko poza rozgrzewką, schłodzeniem i spokojnym biegiem; podbiegi w połowie.""" + total = 0.0 + for s in w.get('segments', []): + t = s.get('type') + dist = segment_km(s) + if t in EASY or t in NON_RUN: + continue + total += dist / 2 if t in ('hills', 'hills_drills') else dist + return total + + +def p90(xs): + xs = sorted(xs) + return round(xs[int(0.9 * (len(xs) - 1))], 2) if xs else None + + +def med(xs): + return round(statistics.median(xs), 2) if xs else None + + +def main(): + sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8') + plans = json.loads((ROOT / 'corpus' / 'parsed' / 'corpus.json').read_text(encoding='utf-8')) + days = {} + for p in plans: + for wk in p['weeks']: + for d in wk['days']: + if not d.get('date'): + continue + if d['date'] not in days or days[d['date']] is None: + days[d['date']] = d.get('workout') + + weeks = defaultdict(dict) + for iso, w in days.items(): + d = date.fromisoformat(iso) + weeks[(d - timedelta(days=d.weekday())).isoformat()][d.weekday()] = w + complete = {m: ws for m, ws in weeks.items() if len(ws) == 7} + + def long_of(ws): + runs = [w for w in ws.values() if is_run(w) and not set(types(w)) & REP_WORK] + best = max(runs, key=km, default=None) + return best if best is not None and km(best) >= LONG_MIN_KM else None + + # ---------------------------------------------------------------- A + bins = [(0, 30), (30, 40), (40, 50), (50, 60), (60, 70), (70, 999)] + a = {} + for lo, hi in bins: + rows = [] + for ws in complete.values(): + total = sum(km(w) for w in ws.values() if is_run(w)) + if not (lo <= total < hi) or any(w and w.get('race') for w in ws.values()): + continue + runs = [w for w in ws.values() if is_run(w)] + long = long_of(ws) + other_easy = [km(w) for w in runs if w is not long and set(types(w)) <= EASY] + quality = [w for w in runs if w.get('quality')] + rows.append({ + 'runs': len(runs), 'quality': len(quality), + 'ratio': (max(other_easy) / km(long)) if long and other_easy else None, + 'longShare': km(long) / total if long and total else None, + 'maxShareNonLong': max((km(w) / total for w in runs if w is not long), default=0) if total else None, + }) + a[f'{lo}-{hi if hi < 999 else "+"}'] = { + 'weeks': len(rows), + 'medianRuns': med([r['runs'] for r in rows]), + 'runsDistribution': dict(sorted(Counter(r['runs'] for r in rows).items())), + 'medianQuality': med([r['quality'] for r in rows]), + # „długie" to tu najdłuższy bieg bez pracy odcinkowej, więc stosunek ≤ 1 z definicji; + # mierzymy, jak daleko pod długim zostaje najdłuższy inny bieg spokojny + 'medianLongestEasyToLong': med([r['ratio'] for r in rows if r['ratio'] is not None]), + 'p90LongestEasyToLong': p90([r['ratio'] for r in rows if r['ratio'] is not None]), + 'medianLongShare': med([r['longShare'] for r in rows if r['longShare']]), + 'p90MaxShareNonLong': p90([r['maxShareNonLong'] for r in rows if r['maxShareNonLong'] is not None]), + } + print('A. liczba biegów i długie według objętości tygodnia (tygodnie pełne, bez startów)') + for k, v in a.items(): + print(f' {k:>6} km: {v}') + + # ---------------------------------------------------------------- B i C + goal_races = [] + for iso, w in sorted(days.items()): + if w and w.get('race'): + dist = race_km(w) + if dist is not None and dist >= 21: + goal_races.append((iso, dist)) + traj = defaultdict(list) + peak_offsets = [] + long_traj = defaultdict(list) + dose = defaultdict(list) + steady_blocks = defaultdict(list) + for iso, dist in goal_races: + race_monday = date.fromisoformat(iso) - timedelta(days=date.fromisoformat(iso).weekday()) + series = {} + for off in range(1, 17): + m = (race_monday - timedelta(weeks=off)).isoformat() + if m in complete: + series[off] = complete[m] + if len(series) < 10: + continue + totals = {off: sum(km(w) for w in ws.values() if is_run(w)) for off, ws in series.items()} + peak = max(totals.values()) + if peak <= 0: + continue + peak_offsets.append(max(totals, key=lambda o: (totals[o], o))) + for off, t in totals.items(): + traj[off].append(t / peak) + long = long_of(series[off]) + if long: + long_traj[off].append(km(long)) + for w in series[off].values(): + if is_run(w) and w.get('quality'): + band = '13-16' if off >= 13 else '9-12' if off >= 9 else '5-8' if off >= 5 else '1-4' + dose[band].append(hard_km(w)) + for s in w.get('segments', []): + block_km = segment_km(s) + if s.get('type') in ('steady', 'progression') and block_km >= 5: + steady_blocks[band].append(block_km) + b = { + 'races': len(peak_offsets), + 'peakWeekBeforeRace': dict(sorted(Counter(peak_offsets).items())), + 'medianShareOfPeak': {off: med(traj[off]) for off in sorted(traj, reverse=True)}, + 'medianLongKm': {off: med(long_traj[off]) for off in sorted(long_traj, reverse=True)}, + } + c = {band: {'sessions': len(dose[band]), 'medianHardKm': med(dose[band]), + 'continuousBlocks5kmPlus': len(steady_blocks[band]), 'medianBlockKm': med(steady_blocks[band])} + for band in ['13-16', '9-12', '5-8', '1-4']} + print('\nB. trajektoria objętości przed startem ≥ 21 km (tydzień startu = 0)') + print(f' startów z ≥10 pełnymi tygodniami przed: {b["races"]}; tydzień szczytu: {b["peakWeekBeforeRace"]}') + print(' mediana udziału szczytu:', b['medianShareOfPeak']) + print(' mediana długiego [km]:', b['medianLongKm']) + print('\nC. dawka akcentów według tygodni do startu') + for k, v in c.items(): + print(f' {k:>5} tyg.: {v}') + + # ---------------------------------------------------------------- D + def kind(ws, wd, lw): + w = ws.get(wd) + if not w or km(w) <= 0 and not w.get('race'): + return 'wolne' + if w.get('race'): + return 'start' + if w is lw: + return 'długie' + if w.get('quality'): + return 'akcent' + return 'spokojne' if is_run(w) else 'inne' + + pairs = Counter() + after_long = Counter() + sunday_after_sat_race = [] + longs = [] + for m, ws in complete.items(): + lw = long_of(ws) # raz na tydzień, nie przy każdym dniu + pairs[(kind(ws, 5, lw), kind(ws, 6, lw))] += 1 + if lw: + longs.append(km(lw)) + for wd in range(7): + if kind(ws, wd, lw) != 'długie': + continue + if wd < 6: + after_long[kind(ws, wd + 1, lw)] += 1 + else: + # niedzielne długie: dzień po nim to poniedziałek następnego tygodnia + nxt = (date.fromisoformat(m) + timedelta(days=7)).isoformat() + if nxt in complete: + after_long[kind(complete[nxt], 0, long_of(complete[nxt]))] += 1 + if kind(ws, 5, lw) == 'start' and ws.get(6) and is_run(ws[6]): + sunday_after_sat_race.append(km(ws[6])) + d = { + 'saturdaySundayPairs': {f'{s}→{n}': v for (s, n), v in pairs.most_common(12)}, + 'dayAfterLong': dict(after_long.most_common()), + 'sundayRunAfterSaturdayRace': {'n': len(sunday_after_sat_race), 'medianKm': med(sunday_after_sat_race)}, + 'medianLongKm': med(longs), + } + print('\nD. weekend (sobota→niedziela) i dzień po długim') + for k, v in d.items(): + print(f' {k}: {v}') + + out = {'A_sessionsByVolume': a, 'B_volumeTrajectory': b, 'C_qualityDose': c, 'D_weekend': d} + dest = ROOT / 'corpus' / 'parsed' / 'season-profile.json' + dest.write_text(json.dumps(out, ensure_ascii=False, indent=2), encoding='utf-8') + print(f'\nzapisano: {dest}') + + +if __name__ == '__main__': + main() diff --git a/tools/corpus/test_season_profile.py b/tools/corpus/test_season_profile.py new file mode 100644 index 0000000..cd05f5c --- /dev/null +++ b/tools/corpus/test_season_profile.py @@ -0,0 +1,50 @@ +"""Testy pomocników season_profile. Uruchomienie: python -m unittest discover tools/corpus -v""" +import unittest + +from races import race_km +from season_profile import is_run, med, p90 + + +class TestStats(unittest.TestCase): + def test_p90_on_filtered_values(self): + # lista po odfiltrowaniu bywa krótsza niż liczba tygodni — indeks liczony z niej + self.assertEqual(p90([0.2]), 0.2) + self.assertIsNone(p90([])) + self.assertEqual(p90([0.1 * i for i in range(1, 11)]), 0.9) + + def test_median(self): + self.assertIsNone(med([])) + self.assertEqual(med([1, 3]), 2) + + +class TestParsing(unittest.TestCase): + def test_decimal_race_distance(self): + self.assertEqual(race_km({'race': {'raw': 'START NA 21,1 KM'}}), 21.1) + self.assertEqual(race_km({'race': {'raw': 'START NA 21,0975 KM'}}), 21.0975) + self.assertEqual(race_km({'race': {'raw': 'START NA 10 KM'}}), 10.0) + + def test_warmup_distance_does_not_win(self): + self.assertEqual(race_km({'race': {'raw': 'ROZGRZEWKA 3 KM + PÓŁMARATON'}}), 21.0975) + self.assertEqual(race_km({'race': {}, 'raw': '2 KM TRUCHTU, START MARATON'}), 42.195) + self.assertEqual(race_km({'race': {'raw': 'START NA 5 KM'}}), 5.0) + + def test_marathon_names(self): + self.assertEqual(race_km({'race': {'raw': 'ULTRAMARATON 60 KM'}}), 60.0) + self.assertEqual(race_km({'race': {'raw': 'BERLIN MARATHON'}}), 42.195) + self.assertIsNone(race_km({'race': {'raw': 'ULTRAMARATON GÓRSKI'}})) + + def test_run_without_segments(self): + self.assertTrue(is_run({'distance_km_est': [8, 10], 'segments': []})) + self.assertFalse(is_run({'distance_km_est': [0, 45], 'segments': [{'type': 'cross'}]})) + + +class TestSteadyDistance(unittest.TestCase): + def test_hard_km_ignores_malformed_distance(self): + # segment z niepełnym dystansem nie wywraca pomiaru (hard_km i bloki ciągłe) + from season_profile import hard_km + w = {'segments': [{'type': 'steady', 'distance_km': [5]}, {'type': 'steady', 'distance_km': [None, None]}]} + self.assertEqual(hard_km(w), 0.0) + + +if __name__ == '__main__': + unittest.main()