Skip to content

v0.6.0 · Structured workouts and clearer CLI

Choose a tag to compare

@dithiothreitol dithiothreitol released this 04 Nov 21:33
· 106 commits to main since this release

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 latest tags 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 --version

MCP: 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 follow INSTALL.txt. Requires Node >=22.18.0. The bundled CLI runs through node 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.json and SHA256SUMS.txt: verification details and asset integrity.

Workout objective and RPE scale

Full changes: v0.5.0...v0.6.0