Changelog

All notable changes to Trainlog are documented here.

Detailed implementation chronology remains available in Git history and docs/reviews. This file summarizes the current unreleased product baseline.

Unreleased

Added

multi-occurrence session V2: stable per-occurrence entry_id, repeated catalogue exercises in one session, per-set actual weights, and occurrence equipment associations across Android, desktop, import and export;
shared versioned equipment catalogue, Android machine selection/search, Android-local custom equipment creation, and explicit rejection of unknown equipment identities rather than silent association loss;
Android EXERCISE_EDIT_V1: visible catalog editing, stable-ID name rename, explicit invalid/conflict/profile/database results, and profile locking once completed history or an active draft references the exercise;
ANDROID_BANNER_PARITY_V1: one Android ◆ TRAINLOG ◆ header component matching the compact Notcurses banner's accent and muted context rhythm;
one durable Android active-session draft with Home resume, raw form restore, confirmed discard and draft-only exercise removal;
native Kotlin/Compose Android capture client;
Android local exercise, session, continuous-activity, and body persistence;
C17/ncursesw desktop TUI with direct session entry and durable SQLite history;
profile-aware exercise model using recording mode, tracking mode, and supplemental fields;
continuous activity persistence without synthetic sets;
variable repetition-set input including 5x10, explicit lists, and pyramid shorthand such as 4..10..4;
persisted desktop session editing and exercise removal;
Android current-session draft exercise removal;
body-observation history, editing, graphs, and normalized overlays;
exercise performance history;
direct physical Android USB/MTP discovery with libudev/libmtp;
direct MTP read/write/list/delete support without filesystem mounts;
Android full mobile snapshot export;
strict idempotent desktop mobile importer;
PC canonical exercise-catalog publication to Android;
automatic Android snapshot maintenance;
Android Synchroniser maintenant request flow;
shared C bidirectional synchronization engine;
trainlog-syncd user-session synchronization agent;
request/receipt synchronization protocol;
stable sy_<uuid-v4> synchronization identities;
structured synchronization history with selectable TUI list/detail views.

Changed

desktop SQLite schema v7 and Android SQLite schema v7 preserve historic rows while adding durable occurrence identities and occurrence-level equipment;
the active Android↔PC completed-session exchange is V2; frozen V1 artifacts remain readable as historical formats and are not redefined for repeated occurrences;
synchronization invokes each local helper with the explicit XDG-resolved desktop database path and records the concrete equipment-import failure;
same-ID Android ↔ PC catalog reconciliation now updates display-name metadata in place and rejects a different-ID normalized-name collision, preserving synchronization identity and preventing renamed duplicates;
Android local SQLite v3 -> v4 additive migration for structured active drafts;
completed-session insertion and draft clearing are atomic; drafts remain excluded from completed history and frozen mobile export;
desktop SQLite schema evolved to v5;
schema v5 permits targetless set-session rows for actual-only mobile data;
heterogeneous performed sets are preserved without inventing a uniform target;
Android/desktop synchronization uses dedicated versioned artifacts instead of modifying frozen Trainlog JSON v1;
PC and TUI synchronization paths now share one engine;
Android PC-created artifact access uses a persistent SAF grant for Download/Trainlog;
the Android data package is no longer accidentally hidden by a broad repository data/ ignore rule;
user-facing session history timestamps use DD/MM/YYYY HH:MM while canonical storage remains RFC3339.

Fixed

equipment companion import previously omitted its required --database argument and blocked synchronization after a successful session import;
PC catalogue/mobile export paths now accept schema v7 and preserve catalogue tracking metadata; Android completed-session equipment editing now targets the stable occurrence entry_id, not an ambiguous catalogue exercise ID;
in-progress Android workout loss when leaving the foreground or recreating the Activity/process;
missing selected-exercise recovery preserves raw partial input and reports a specific warning; draft write/finalization failures return explicit errors;
stale schema-v4 importer call after desktop schema v5 migration;
stale schema-v4 guard in the PC catalog exporter;
missing sy prefix support in the UUID creator;
synchronization failures that previously surfaced only as error=unknown;
Android folder-selection UX so a wrong SAF folder can be changed without clearing application data;
libmtp terminal output leaking into ncurses rendering.

Validation

Current validated baseline:

TRAINLOG_FORMAT_V1=FROZEN

DESKTOP_SCHEMA_V7=PASS
DESKTOP_TESTS=25/25 PASS

ANDROID_BUILD=PASS
ANDROID_LOCAL_WORKFLOWS=PASS
ANDROID_LOCAL_DATABASE_V7=PASS
ANDROID_HOST_TESTS=8/8 PASS
ANDROID_DEVICE_INSTRUMENTATION=5/5 PASS
ANDROID_SESSION_DRAFT_V1=PASS

USB_MTP_DETECTION=PASS
MTP_ROUNDTRIP=PASS

ANDROID_TO_PC_MTP=PASS
PC_TO_ANDROID_MTP_PUBLISH=PASS
COMMON_SYNC_ENGINE=PASS
TRAINLOG_SYNCD=PASS
ANDROID_TRIGGERED_SYNC=PASS
ANDROID_SYNC_RECEIPT=PASS
TUI_SYNC_LOG_SHOW=PASS
BIDIRECTIONAL_SYNC_V1=PASS
MULTI_OCCURRENCE_SESSION_V2=PASS
EQUIPMENT_ASSOCIATIONS_V2=PASS

Measured max v1

Added:

explicit measured-max derivation from max_test sessions only;
newest successful measured result and same-mode historical record;
dedicated TUI measured-max history and graph;
external working-load calculations at 60/70/80/90%;
selectable 0.5/1/2.5/5.0 kg working-load rounding;
direction-aware assistance measured-max semantics;
Android Entraînement / Test max session selection;
Android history/detail max-test identification;
measured-max regression coverage.

No estimated 1RM, schema v6, or frozen Trainlog JSON v1 change was introduced.

Body analytics v1