Skip to content

Release 0.4.0: protected regeneration, scriptable CLI, agent plugin, activity files, time budget - #1

Merged
dithiothreitol merged 19 commits into
mainfrom
dev/plan-v0.4
Oct 21, 2026
Merged

dithiothreitol merged 19 commits into
mainfrom
dev/plan-v0.4

Conversation

@dithiothreitol

@dithiothreitol dithiothreitol commented Oct 21, 2026 •

Copy link
Copy Markdown
Owner

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.

  • plan keeps 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 from adapt --apply stay. plan --fresh starts over and lists what it discards.
  • A CLI you can script. --json on every command (ADR-035), -C <dir>, relative dates, status, rules, completion, --commit that commits only the changed files (ADR-040), and an explicit clock via TRAINCTL_TODAY (ADR-034).
  • Plugin for Claude Code and Codex (ADR-036). Marketplaces, skills, a plan-lint hook, MCP resources and prompts. init --agent writes the agent setup.
  • Execution without a hub (ADR-037). The new package trainctl-sync-files reads exported FIT, TCX and GPX files. push also sends races and strength sessions.
  • Engine. It adds a time budget (E-2), a transition block after the goal race (R-8 to R-10), plans without a race (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 time or goal.kind: base changes in four ways.

  • Transition weeks now follow the goal race.
  • Strength starts with two intro weeks.
  • A result recorded inside the horizon resets the time-trial rhythm. This fixes W-12.
  • Trail results no longer set road zones while a road result exists.

The corpus backtest is unchanged.

Validation: pnpm check runs 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 reads main.

Checklist

  • pnpm check passes (typecheck + tests)
  • New behaviour has a test; a fixed bug has a test that failed before the fix
  • Engine rules cite a FOUNDATIONS ID, or are marked in code as an
    engineering choice rather than a finding
  • User-facing strings live in both catalogues (cli-en.ts, cli-pl.ts) —
    never inline in a handler
  • No corpus data, personal data, API keys or real intervals.icu output

🤖 Generated with Claude Code

dithiothreitol and others added 19 commits October 21, 2026 10:39
… 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>
@dithiothreitol
dithiothreitol merged commit de99eee into main Oct 21, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant