Skip to content

v0.5.0 — multisport, Codex plugin and responsive CLI

Choose a tag to compare

@dithiothreitol dithiothreitol released this 04 Nov 16:25
· 107 commits to main since this release

Version 0.5.0 is distributed through GitHub only: source code and the bundled Codex plugin are available below. No 0.5.0 npm packages are published as part of this release. The ZIP plugin includes its dependencies and works without downloading them from npm.

Added

  • Cycling, swimming and mixed-sport plans with separate profiles, time volumes,
    equipment constraints, session IDs and multisport race groups.
  • Reviewed substitutions in all six directions between running, cycling and
    swimming, with time budgets, trade-offs and restoration of the original session.
  • Schema v1 to v2 migration with preview/apply, protected history, journal entries
    for the sport actually performed, and recovery after interrupted writes.
  • Multisport FIT, ICS and HTML exports, calendar withdrawal/reactivation, and
    activity matching across Intervals.icu and imported FIT/TCX/GPX files.
  • A self-contained Codex plugin bundle with 21 training tools, six skills and
    trainctl_workspace for selecting the training directory explicitly.
  • --color auto|always|never and --plain; responsive tables, consistent sport
    colours, readable help and separate session metadata in the CLI.

Fixed

  • week --session now selects the requested session, including other weeks,
    and rejects unknown IDs or conflicting sport filters.
  • init --from-intervals respects agent setup and commit options; a conflicting
    --sports option is rejected before contacting the provider or writing files.
  • CLI logs of a spontaneous sport change now use the same default modified
    status as MCP unless an explicit status is supplied.
  • Codex no longer treats the plugin cache as the training workspace. A server
    session binds to one selected directory and keeps its credential context separate.
  • Interactive selectors and the week browser now emit valid terminal control
    sequences. Narrow layouts preserve labels, full IDs and Unicode graphemes.

Dependencies and validation

  • Updated the MCP SDK, Zod, Vitest/Vite and transitive dependencies; adapted the
    test runner to Vitest 4. The dependency audit returned no known advisories.
  • CI checks source, installed npm tarballs and relocated plugin bundles on Linux
    and Windows. Export checks use Garmin FIT SDK and ICAL.js independently.

Known limits

  • Cycling/swimming templates and substitution limits remain explicit engineering
    choices; a substitution is not a claim of physiological equivalence.
  • Physical-watch acceptance is separate from file/parser validation. Suunto
    account pairing and live Google Calendar import were not completed in this audit.
  • Multisport groups export linked sessions; swimming FIT send-off is unsupported,
    and pace is descriptive when stroke is the executable target.

Release verification

  • Local full suite: 1044/1044 passed, types/build and npm dry-run passed.
  • CI: all six jobs passed, Linux/Windows and Node 22.18/24.
  • Installed tarballs: 56 CLI commands, 11 MCP calls, 128 FIT files and 8 ICS calendars verified.
  • Bundled plugin: all 22 tools, 40 CLI calls, 57 MCP calls, 49 resources and 2 prompts.
  • Attachments: plugin ZIP, SHA-256 sums, validation metadata and CLI output renders using synthetic data.

To install the Codex plugin, extract the ZIP to a permanent directory and follow INSTALL.txt. Node >=22.18.0 is required.