Repository navigation
v0.6.0 · Structured workouts and clearer CLI
Version 0.6.0 adds detailed workout instructions and makes the terminal descriptions easier to follow. Version 0.6.0 is available on npm and GitHub. All six npm packages use the latest tag. The Codex plugin ZIP includes the CLI, MCP server and dependencies.
Fixed
- Fractional pace now rounds correctly across minute boundaries in CLI and
Intervals.icu work/recovery steps. - Hard running and timed swimming repetitions explain their actual intent;
standalone sessions do not imply a known training phase. - Multisport rule links now refer to MULTISPORT rather than running foundations.
Added
- Phase-specific cycling and swimming recipes with objectives, rationale,
success criteria, warm-up, main work, recovery and cool-down. - Named swimming drills, RPE guidance without current calibration, and
bounded progression for bike/run bricks. - Coaching instructions in CLI/MCP, JSON/YAML, Markdown, HTML, ICS and
Intervals.icu; FIT step notes and explicit recovery power/pace. - MS-6 documents recipe parameters, evidence boundaries and device limits.
Changed
- CLI workout cards separate objectives, structure, rationale and adjustments
with coloured headings. Planned peak RPE has a labelled ten-step colour scale;
recovery targets have separate rows, and durations use minutes and seconds. - Replacement and shortening previews compare structured cards; confirmation
shows a concise summary. Plain/MCP output keeps headings and numeric RPE. - FTP/CSS without a current dated source now uses subjective effort guidance.
- Shortening preserves complete repetitions and the minimum quality stimulus.
- A time budget too small for a quality set explicitly produces an easy session.
Distribution and limits
- Six npm packages at version 0.6.0 (
latest), plus a self-contained Codex plugin
and terminal examples on GitHub. - Training recipe parameters remain documented engineering choices; independent
coaching review and tests on physical Garmin/Suunto watches are still pending. - FIT step notes may be truncated to 254 UTF-8 bytes; full instructions remain
available through CLI/MCP and text exports.
Verification
- Public npm installation (fresh directory and cache, no authentication): PASS. All six
latesttags resolve to 0.6.0; 56 CLI commands, 11 MCP calls, 128 FIT files and 8 ICS calendars / 231 events. Coaching metadata and coloured RPE output verified. - Local suite: 1076/1076 tests passed, types, build and generated skills checked.
- Coaching simulation: 17 real CLI calls, 72 sessions and 22 workout recipes.
- Isolated package installation: 56 CLI commands, 11 MCP calls, 128 FIT files and 8 ICS calendars / 231 events.
- Relocated plugin: 40 CLI calls, 58 MCP calls, all 22 tools, 50 resources and 2 prompts.
- All six CI jobs passed, Linux/Windows and Node 22.18/24.
Install from npm
npm install -g trainctl@0.6.0
# Or run without a global installation:
npx --yes trainctl@0.6.0 --versionMCP: npx --yes trainctl-mcp@0.6.0. Requires Node >=22.18.0.
Downloads
trainctl-codex-0.6.0.zip: extract to a permanent directory and followINSTALL.txt. Requires Node >=22.18.0. The bundled CLI runs throughnode plugin/scripts/trainctl.mjs.trainctl-x-examples-0.6.0.zip: 10 terminal images at 1600×900, draft Polish posts, alt text and an offline gallery. Captured during 0.6.0 development using synthetic data.validation.json,npm-validation.jsonandSHA256SUMS.txt: verification details and asset integrity.
Full changes: v0.5.0...v0.6.0
