Repository navigation
Release 0.4.0: protected regeneration, scriptable CLI, agent plugin, activity files, time budget - #1
Merged
Merged
Conversation
… zgodna z kodem Usterki zauważone przy uruchomieniu wszystkich komend na świeżym katalogu (docs/PLAN-v0.4.md, etap A): - review w niedzielę pokazuje pozostałe km obok celu tygodnia zamiast objętości całego tygodnia przy liczbie pozostałych sesji; - katalog bez trainctl.yaml odsyła do init, nie do plan; - why bez „0 minut" w dzień wolny, bez dublowania celu, jedna lista reguł z treścią i pochodzeniem; - log odbija plan obok zapisu i zwraca dane strukturalne; - ścieżki w komunikatach w formie POSIX na każdym systemie; - informacja o planie z innego minora silnika, odmowa nowszego schematu; - FOUNDATIONS jako link przypięty do tagu wydania (pliku nie ma w paczce npm). Dokumentacja: tabela komend z shorten, listy narzędzi bez liczby, przykłady CI na opublikowanej paczce, CLAUDE.md, krok GitHub Release w procedurze wydania. docs.test.ts pilnuje zgodności README z bin.ts i server.ts. Port sync rozdzielony na ActivitySource i SyncProvider (pod adapter plikowy). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Etap B z docs/PLAN-v0.4.md. Regeneracja (ADR-033): `trainctl plan` na istniejącym planie zmienia tylko przyszłość. Dni przeszłe, zalogowane, przypięte, ręcznie edytowane, zatwierdzone skrócenia i przekraczające budżet czasu zostają; zatwierdzona baza z adapt obowiązuje, dopóki profil nie zmieni recentWeeklyKm. Ten sam cykl trzyma granice faz, inny dystans albo cel po starcie otwiera nowy cykl z historią w pliku. diff pokazuje tę samą regenerację, --fresh zaczyna od zera. Silnik: wynik wpisany w horyzoncie planu zeruje rytm kalibracji (W-12) — wcześniej regeneracja potrafiła wstawić sprawdzian tydzień po świeżym wyniku. CLI: --json, -C/TRAINCTL_DIR, jawny zegar TRAINCTL_TODAY (ADR-034), daty względne, interaktywny log, status (+ trainctl_status w MCP), --commit wyłącznie na plikach zmienionych przez komendę (ADR-040), czas i następna sesja w today, completion dla czterech powłok, przykłady w help, kod 2 dla błędów użycia. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…pty MCP
Etap C z docs/PLAN-v0.4.md (ADR-036).
- plugin/: serwer MCP, persona trenera generowana z tego samego tekstu co
AGENTS.md, skille review/debrief/shorten/what-if, a w Claude Code hooki:
instrukcja trenera na starcie sesji w katalogu treningowym i trainctl check
po edycji plan/plan.yaml (błąd → kod 2, ostrzeżenia → additionalContext).
- Repozytorium jest marketplace'em dla obu agentów (.claude-plugin/,
.agents/plugins/); walidacja `claude plugin validate` przechodzi.
- init --agent claude|codex|all: .claude/settings.json albo .codex/config.toml,
bez nadpisywania istniejących plików i bez duplikowania serwera MCP.
- MCP: trainctl_rule, zasoby trainctl://plan|config|agents|rules/{id},
prompty weekly-review i debrief; CLI: trainctl rules [id].
- check zwraca ustalenia jako data; tools/release/bump-version.mjs przesuwa
wszystkie przypięte wersje razem; CI sprawdza świeżość skilli.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…u, kontekst z zegarka Etap D z docs/PLAN-v0.4.md (ADR-037). - Nowy pakiet trainctl-sync-files: eksport FIT/TCX/GPX (także .gz ze zbiorczych eksportów Stravy i Garmina) jako źródło pull-only, bez zależności, testowany wyłącznie syntetycznymi plikami. pull --from <katalog> i sync.files w trainctl.yaml dla review bez klucza; init dopisuje activities/ do .gitignore (ślady GPS). - Port sync: ActivitySource (pull) i SyncProvider (pull + push). - push: starty jako RACE_A/B/C, siła jako WeightTraining — osobnymi żądaniami z wycofaniem, więc odrzucenie nie wywraca pushu treningów; sprzątanie obejmuje wszystkie wpisy trainctl-. Postać niezweryfikowana na żywym koncie — opisane w SPEC §7 i CHANGELOG. - review cytuje tętno spoczynkowe, sen i masę oraz RPE z huba (gdy dziennik go nie ma), ze źródłem, bez średnich i progów; HRV i CTL/ATL pominięte. - CI i testy pakowania obejmują szóstą paczkę; instalacja z tarballi sprawdzona lokalnie. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…y i dziennik siły Etap E z docs/PLAN-v0.4.md — najpierw nauka, potem kod. - E-2: sekcja `time` w trainctl.yaml. Tydzień ponad budżetem dostaje niższy cel km i jest generowany od nowa, dzień ponad limitem przechodzi przez skracanie E-1 z jawnym timeAdjustment (pochodzenie: profil); ostrzeżenie, gdy budżet ogranicza objętość poniżej P-7/P-8. - R-8…R-10 (ADR-038): makrocykl kończy się blokiem przejściowym — po ≥HM dwa tygodnie (~50% spokojnie, pierwszy bieg 3. dnia po maratonie wg R-1; potem ~100% z jednym akcentem), po krótszym jeden (~70%). Kształt zmierzony na korpusie (tools/corpus/post_race_profile.py, n=3 — słaba podstawa, nazwana wprost). Nowy cel w trakcie bloku zaczyna cykl po nim. - P-11 (ADR-039): goal.kind base z datą until — tylko baza z odciążeniem, plateau na szczycie, bez taperu, predykcji i pakietu startowego. - Siła: wejście w blok (F-18), ciężko (F-4), w szczycie jedna sesja podtrzymująca (F-12/F-14); log --strength done|skipped jako osobny wpis. - Z-10: wynik z trailu nie kalibruje stref szosowych przy wyniku szosowym. Backtest na korpusie bez zmian (objętość 1,04, Δ akcentów 0, Δ sesji 0, starty 6/6, długie 3/6 — sprawdzone także na poprzednim commicie). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…” — bez powtórzenia w today Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- budżet czasu: cel tygodnia idzie za skróconymi dniami (bez fałszywego P-3 w świeżym planie), ostrzeżenie o ograniczeniu objętości tylko gdy budżet coś obciął, minuty siły liczone między przebiegami; - regeneracja z zatwierdzoną bazą i propozycje adapt ponownie stosują budżet czasu z profilu; - plan liczy od zera przy niesparsowalnym plan.yaml (znaczniki konfliktu), a --fresh nadpisuje także plik z nowszym schematem; - w dniu startu nowy cel otwiera nowy cykl, ten sam cel zostaje tym cyklem; - zakres planu w komunikatach kończy się z blokiem przejściowym; - init --commit commituje tylko pliki, które init zapisał; - status: bez wyjątków przy połamanym dzienniku, źródło klucza w kolejności readApiKey, podpowiedź commita bez `git add -A`; - push: start odrzucony w obu postaciach daje prawdziwy komunikat; - pliki aktywności: ten sam bieg w dwóch formatach liczy się raz (FIT > TCX > GPX); - reguły R-1/R-2 mają objaśnienia; szczyt objętości liczony z bieżącego cyklu. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…tartu - budżet czasu w jednym etapie computePlan (hook dla skalowania bazy i propozycji): cel tygodnia zostaje zamiarem makrocyklu, objętość po budżecie w osobnym timeCappedKm (lint i skalowanie bez zniekształceń), ostrzeżenia budżetu trafiają do planu i propozycji, siła w planie z historią zostaje na miejscu, ponowne skrócenie nie gubi pierwotnej jednostki; regeneracja bez zmian na wejściu jest „aktualna" także z budżetem; - niesparsowalny plan.yaml (konflikt merge'a) albo nowszy schemat: bez --fresh odmowa z instrukcją, z --fresh nadpisanie z ostrzeżeniem — nic nie ginie po cichu; - dzień startu jest „za nami" dopiero po zapisie startu — start przełożony rano zostaje tym samym cyklem; - init --commit nie commituje istniejącego .gitignore z cudzymi zmianami; - status: źródło klucza z jednego helpera obok readApiKey (eksport w powłoce wygrywa z .env), podpowiedź git add ze ścieżek katalogu, nie z porcelain; - shorten: zakres planu kończy się z blokiem przejściowym; - pliki aktywności: bliźniaki w obrębie rodziny biegów (trail i szosa), przesuwane okno O(n log n), duplikaty wymienione w skipped; - testy przywracają zmienną klucza programisty zamiast ją kasować. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…startu, duplikaty - regeneracja tuż po adapt --apply odtwarza zatwierdzone dni: siła zostaje na dniach zapisanego planu (tryb 'keep' jak w propozycji), dzień decyzji chroniony jak w propozycji - dzień startu „za nami” tylko gdy zapisano prawie cały dystans (≥80%) i cel się zmienił — rozruch przed przełożonym startem i niezmieniony cel to ten sam cykl - plannedWeekKm (timeCappedKm ?? targetKm) w adapt, week, diff, why, export i objętości nowego cyklu; timeCappedKm = faktycznie rozpisana objętość, zaokrąglona — świeży plan przechodzi własny P-3 - ostrzeżenie o budżecie czasu tylko gdy bez budżetu plan sięgnąłby rekomendacji (redukcja w propozycji nie jest „winą” budżetu) - nowszy schemat planu: rada „upgrade trainctl”, nie --fresh; status nie podpowiada `trainctl plan`, który by odmówił - podpowiedź commita w status: dokładnie zmienione ścieżki względem katalogu treningowego (także usunięte, bez ignorowanych), `git add -- …` - init --commit: czysty .gitignore po dopisaniu wzorców wchodzi do commita; nota tylko przy realnym commicie - sync-files: duplikat wymaga też podobnego dystansu; podmiana bliźniaka utrzymuje sortowanie okna - jedno API_KEY_ENV, jeden odczyt .env w status; martwy kod usunięty Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…mi, wspólne skalowanie - budżet tygodnia: cel generatora maleje z przebiegu na przebieg; zapisana objętość (timeCappedKm) nie cofa redukcji - scaleToBaseline w planfile.ts: jedna arytmetyka skalowania do bazy dla propozycji i regeneracji (koniec ręcznie synchronizowanych kopii) - siła po zatwierdzonej bazie stoi tam, gdzie w planie bez bazy — idzie za przesuniętym startem i strength.days; propozycja przepisuje ją z zapisanego planu, który ma to samo rozstawienie - dzień decyzji chroniony z własnym powodem 'baseline' (en/pl) - szczyt przed budżetem z celów szkieletu bieżącego cyklu (cycleStart w haku propozycji); bez szumu zaokrągleń generatora - raceDayKm: maks. z dziennika i synchronizacji (rozruch nie przykrywa startu z zegarka), liczone leniwie tylko w dniu startu - git status: --untracked-files=normal i rename w obu kolumnach - diff: bez echa „suma dni” dla tygodnia przyciętego budżetem - validate używa plannedWeekKm Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…wica bazy, rename w drzewie - budżet tygodnia: cel generatora nie przekracza tego, co generator rozpisał (przy dwóch dniach biegowych tygodnie znów mieszczą się w budżecie); tydzień już przycięty nie jest przycinany drugi raz (generator nie jest monotoniczny przy małych celach) - ostrzeżenie „budżet obcina szczyt” z sum dni (+0,5 km tolerancji P-3), nie z nieosiągalnego celu szkieletu - scaleToBaseline: kotwica pomija tygodnie po starcie (decyzja w taperze bierze ostatni tydzień budowania), tygodnie sprzed decyzji przechodzą z planu bez bazy, notatki siły zostają; drugi computePlan w regeneracji tylko przy budżecie tygodnia - raceDayKm: „pominięte” (DNS) wygrywa nad zegarkiem; logFor i wspólne runningKmByDate zamiast kopii reguł - git status: rename w drzewie roboczym podaje też starą ścieżkę, więc podpowiedź zapisuje usunięcie - komentarze w proposals.ts po polsku Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… uczciwe ostrzeżenie - budgetFrom w computePlan: tylko tygodnie sprzed decyzji (gotowe z planu bez bazy albo z zapisanego planu) omijają budżet; rekalibracja znów dopasowuje przycięte tygodnie do budżetu (koniec tygodni po 249–262 min) - ostrzeżenie o budżecie, gdy budżet wyraźnie obniża szczyt poniżej rekomendacji, z szczytem bez budżetu w treści (en/pl); tygodnie przycięte wcześniej liczą się objętością świeżej generacji, więc rekalibracja go nie gubi, a plany z 2–3 dniami biegowymi znów je dostają - upToDate porównuje notatki siły tygodni — plan, który je zgubił, się naprawia - recordedDates przez runningKmByDate; raceDayKm z opisem świadomej różnicy wobec buildExecution - JSDoc scaleToBaseline zgodny z kodem, komentarz w execution.ts po polsku, test dni przeszłych sprawdza kod wyjścia i niepustą listę Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…jach i regeneracji - regeneracja z bazą zawsze liczy pełny plan bez bazy: z niego tygodnie sprzed decyzji (gotowe, po budżecie) i rozstawienie siły — także bez siły albo z samymi limitami dni - budżet i jego ostrzeżenia dotyczą tylko tygodni od budgetFrom; gotowe tygodnie nie dostają „ponad budżet”, a redukcja nie jest liczona jako skutek budżetu (szczyt bez budżetu = poziom po skalowaniu) - tydzień przycięty wcześniej liczy się jako przycięcie — szybsza rekalibracja nie gubi ostrzeżenia - rekalibracja: budżet od następnego poniedziałku, bieżący tydzień zmienia tylko tempa (koniec rozjazdu timeCappedKm z sumą dni, P-3); objętość budżet tylko obniża - applyStrength nigdy przy granicy budżetu (nie rusza gotowych tygodni) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…nie” w planie - budgetFrom (limity dni, od tygodnia decyzji) i weeklyBudgetFrom (przycinanie tygodni): rekalibracja skraca za długie dni już w bieżącym tygodniu, tygodnie przycina od następnego; ostrzeżenia tylko dla tygodni, które budżet obrabia - StoredPlan.timeCaps: liczby obok ostrzeżenia „budżet tnie objętość”; rekalibracja przenosi poziom bez budżetu z zapisanego planu (przy bazie to baza, nie pierwotny szczyt) zamiast przybliżenia ze świeżej generacji - tydzień mieszany w propozycji: timeCappedKm = suma tego, co w nim jest (P-3) - budgetStrength usunięte: granica budżetu = siła zostaje (jeden warunek zamiast martwego strażnika), wspólny predykat beforeBoundary - regeneracja z bazą liczy plan bez bazy tylko przy budżecie czasu Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…, dni zmienialne - WeekSkeleton.uncappedKm: objętość przed budżetem zapisana przy pierwszym przycięciu; ostrzeżenie „budżet tnie objętość” liczy z niej szczyt bez budżetu tygodni, które budżet obrabia — trafnie przy rekalibracji, po zatwierdzonej bazie i późno w cyklu (zamiast jednej liczby na plan) - ostrzeżenie tylko gdy któryś z tych tygodni jest przycięty (koniec „0 km/tydz.”) - daysFrom: propozycja nie skraca ani nie zgłasza dni do dziś włącznie; tydzień ponad budżetem zgłaszany, gdy ma jeszcze dni do zmiany (także bieżący przy rekalibracji) - settleMixedWeek: wspólne domknięcie tygodnia mieszanego dla propozycji i regeneracji (P-3 po `plan` za mid-week `adapt --apply`) - usunięte StoredPlan.timeCaps i opcja withoutBudgetKm Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ońcowym - budgetWarnings(plan, config, from): jedna funkcja ostrzeżeń budżetu (za długie dni, tygodnie ponad budżetem, „budżet tnie objętość”) liczona na planie, który biegacz dostaje — świeżym, po regeneracji z dniami chronionymi i w propozycji — tylko dla dni od pierwszego zmienialnego (propozycja: max(jutro, dziś w kalendarzu), regeneracja: dziś) - fitTimeBudget już tylko przycina; koniec rozjazdu ostrzeżeń kandydata z tym, co trafia do pliku (szczyt z niedokrojonych dni decyzji, minione dni w ostrzeżeniach, bieżący tydzień liczony z nowymi tempami dni minionych) - regeneracja domyka tydzień mieszany tylko, gdy zmieszał go czas (przeszłe, zalogowane, dzień decyzji); ręczne zmiany w tygodniu przyciętym budżetem nadal widać w P-3 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Cały plan z docs/PLAN-v0.4.md w jednym wydaniu: chroniona regeneracja, CLI do skryptów, plugin do Claude Code i Codex, wykonanie z plików FIT/TCX/GPX (nowa paczka trainctl-sync-files) oraz silnik z budżetem czasu, blokiem po starcie i planem bez startu. Wersje sześciu paczek, pluginu, marketplace'u i przykładów CI przesunięte skryptem bump-version; README z nowościami 0.4.0, CHANGELOG z sekcją wydania, PUBLISHING ze stanem. Walidacja: pnpm check (896 testów), build, release:dry, instalacja sześciu tarballi w czystym katalogu — CLI (plan, status --json, rules) i MCP (19 narzędzi, zasoby, prompty) z node_modules. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ex przyjmuje `codex plugin marketplace add` odrzucał cały marketplace: wartość `ON_FIRST_USE` nie istnieje, parser Codex 0.153 zna `ON_INSTALL` i `ON_USE`. Wykryte przy instalacji pluginu w odizolowanym CODEX_HOME; test pilnuje dozwolonych wartości obu pól polityki. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
CI na Windows wywracał plugin.test.ts na imporcie hooków: git z autocrlf zapisuje `.mjs` z CRLF, a vitest zdejmuje `#!` tylko przed LF, więc shebang zostawał w kodzie modułu (SyntaxError). `.gitattributes` trzyma `*.mjs` w LF; packaging.test.ts sprawdza atrybut przez `git check-attr`, żeby przyczyna była widoczna, a nie tylko błąd składni. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this changes
Release 0.4.0: the whole of docs/PLAN-v0.4.md in one release, with six packages and the plugin at 0.4.0.
plankeeps what you decided (ADR-033). On an existing plan it regenerates only the future. Past and logged days, pins, hand edits, approved shortenings and the volume baseline fromadapt --applystay.plan --freshstarts over and lists what it discards.--jsonon every command (ADR-035),-C <dir>, relative dates,status,rules,completion,--committhat commits only the changed files (ADR-040), and an explicit clock viaTRAINCTL_TODAY(ADR-034).init --agentwrites the agent setup.trainctl-sync-filesreads exported FIT, TCX and GPX files.pushalso sends races and strength sessions.goal.kind: base, P-11), strength variants with a journal (F-18), and road zones that ignore trail results (Z-10).What a plan looks like before and after: a fresh plan without
timeorgoal.kind: basechanges in four ways.The corpus backtest is unchanged.
Validation:
pnpm checkruns 896 tests. Build,release:dry, and the six tarballs installed in a clean directory were also run: the CLI scenarios work, and the MCP server lists 19 tools, resources and prompts. The branch went through ten rounds of code review, and every fix has a test that fails without it.Merge after the npm publish. The plugin pins
trainctl-mcp@0.4.0, and the marketplace readsmain.Checklist
pnpm checkpasses (typecheck + tests)engineering choice rather than a finding
cli-en.ts,cli-pl.ts) —never inline in a handler
🤖 Generated with Claude Code