trainlog/CHANGELOG.md

Changelog

All notable changes to Trainlog will be documented in this file.

Unreleased

Added

• Frozen Trainlog JSON v1 contract.
• SQLite persistence foundation.
• Direct workout entry.
• Exercise catalog.
• Body tracking.
• Colored ncursesw dashboard.
• Body-weight graph.
• Arrow-key and F1-F4 navigation.
• Highlighted list selections.
• Navigable session history.

Changed

• Exercise selection now uses interactive keyboard navigation.
• Body tracking is now a persistent history screen instead of entry-only.
• TUI polish is prioritized before Android development.

TUI v0.2 checkpoint

Added:

• bordered colorful dashboard;
• arrow-key and F-key navigation;
• weight history visualization;
• flat-series weight graph handling;
• navigable session history;
• complete read-only workout details.

Planned next:

• human duration input such as 1:30, 1m30, 2m, and 45s (implemented);
• automatic minute/second display formatting (implemented);
• history graphs for all body measurements (implemented);
• left/right asymmetry summaries (implemented).

Current TUI checkpoint

Implemented:

• human duration input;
• human minute/second display;
• graphs for every persisted body metric;
• recent values for every body metric;
• left/right asymmetry summaries.

Next:

• normalized global body overlay graph (implemented);
• metric legend using both colors and symbols;
• percentage evolution summary;
• richer dashboard weight graph (implemented);
• dashboard previous-weight delta and min/max (implemented);
• compact body/asymmetry dashboard summary (implemented).

Dashboard graph-only refinement

• removed redundant weight/min/max/asymmetry summary lines;
• dashboard now uses a global body evolution graph;
• dates are shown on X;
• Y is percentage evolution from each metric baseline;
• legend shows metric name, unit, and latest percentage change.

Dashboard rolling 12 months

• added a fixed 12-month rolling X axis;
• empty months remain visible and empty;
• no zero fill or interpolation across missing months;
• multiple readings in one month use the last monthly value.

Exercise performance history

• added Enter-to-open exercise performance detail;
• added mode-aware representative best-set history;
• added terminal performance graph;
• assistance explicitly treats lower assistance as better;
• best recorded set remains distinct from measured max.

Session type schema v2

• added local training / max_test session classification;
• added transactional SQLite schema migration v1 -> v2;
• preserved migrated sessions as training;
• kept Trainlog JSON v1 frozen and unchanged.

Transaction-safe session editing foundation

• added exact bounded loading of persisted exercise/set values;
• added atomic replacement of recorded session exercise/set rows;
• preserved the parent session row and linked body observations;
• added rollback coverage for failed replacements.

Body observation history and correction

• redesigned F4 Corps around recorded measurement dates;
• added a framed trend graph above the newest-first record list;
• added PageUp/PageDown and a visual ncurses scrollbar;
• added two-page detail views with e Modifier on every page;
• added correction of existing observations without changing their timestamp or session link;
• added - to clear one erroneous measurement and Escape to cancel the edit.

TUI editability and navigation checkpoint

• added local training / max_test selection to the session workflow;
• added safe persisted-session editing while preserving parent session identity;
• added newest-first body-observation history, detail pages, and editing;
• added immediate Escape cancellation to text/numeric entry paths;
• added a shared top navigation bar with 0 Accueil, 1-4, and F1-F4;
• added Tab/Shift+Tab focus on multi-zone screens;
• focused frames use a yellow border/title without recoloring content;
• added consistent ASCII banners and ncurses frames to secondary detail views;
• added direct exercise creation from the in-session exercise chooser;
• kept the final rolling 12-month MM/YY dashboard label inside its frame.

Direct Android USB/MTP transport foundation

• added libudev discovery of physical MTP devices;
• filtered MTP USB interface children to avoid duplicate phones;
• added exact bus/device matching into libmtp;
• added MTP storage enumeration;
• added root-folder discovery/creation;
• added direct MTP text-file upload;
• added direct folder-child listing;
• added direct MTP file download;
• split cached and uncached libmtp open paths where required;
• validated a real Android internal-storage write/list/read roundtrip;
• kept Android access mount-free: no GVFS/FUSE mount lifecycle is required.

Sync TUI page

• added 5 Sync / F5 to primary navigation;
• added dedicated Sync ASCII banner and framed page;
• added live direct-MTP device and storage status;
• suppressed libmtp terminal output during ncurses rendering;
• added focused-frame navigation with Tab/Shift+Tab;
• added clean list navigation and scrollbar behavior;
• exposed Android -> PC session/exercise/body synchronization directions;
• exposed PC -> Android canonical exercise-catalog direction;
• kept frozen Trainlog session JSON v1 unchanged.

Profile-aware and continuous exercise tracking

• added set-based versus continuous recording organization;
• added speed and distance supplemental-field metadata;
• added profiled catalog creation API;
• added profile-aware exercise creation in the TUI;
• added inline profiled exercise creation while recording a session;
• migrated SQLite persistence to schema v4;
• added one-to-one continuous activity persistence;
• kept continuous activities out of performed_sets;
• added profile-aware session detail loading;
• added continuous duration/speed/distance history display;
• made continuous TUI duration entry explicitly minute-based;
• preserved frozen session JSON v1 unchanged.

Android local client

• added native Kotlin/Jetpack Compose Android client;
• matched Trainlog TUI visual language;
• added minimal themed T launcher icon;
• added exercise catalog and profile-aware exercise creation;
• added inline exercise creation from session recording;
• added persistent local session recording;
• preserved SETS versus CONTINUOUS persistence semantics;
• added local session history and detail views;
• added persistent body measurement recording;
• validated the application on a real Samsung device through ADB.

Bidirectional synchronization foundation

• validated Android-to-PC domain snapshot transfer through direct MTP;
• added strict transactional and idempotent desktop mobile import;
• added canonical PC exercise-catalog export;
• validated PC-to-Android catalog publication through direct MTP;
• added Android Storage Access Framework access for PC-created catalog files;
• made the Android synchronization folder selection recoverable/changeable;
• kept synchronization artifacts separate from frozen Trainlog session JSON v1;
• documented the next synchronization architecture: structured history, detailed sync inspection, common sync engine and PC-side trainlog-syncd.

Variable repetition sets

Trainlog preserves each performed set independently.

Accepted repetition input:

5x10
4,5,6,7,8,9,10,9,8,7,6,5,4
4..10..4

4..10..4 expands to:

4,5,6,7,8,9,10,9,8,7,6,5,4

Desktop schema v5 permits targetless SETS rows for actual-only mobile observations. Synchronization therefore does not invent a uniform target when performed sets are heterogeneous.

performed_sets remains the source of truth for actual per-set values.

Existing planned desktop sessions may still carry explicit target sets/reps or target durations.

trainlog-mobile-export v1 keeps ordered heterogeneous sets[].

Frozen TRAINLOG_FORMAT_V1 is unchanged.

Variable sets and session exercise removal checkpoint

Validated functionality in this checkpoint:

VARIABLE_REPETITION_SETS=PASS
REPETITION_SHORTHAND_5x10=PASS
REPETITION_EXPLICIT_LIST=PASS
REPETITION_PYRAMID=PASS

DESKTOP_SCHEMA_V5=PASS
V4_TO_V5_MIGRATION_REGRESSION=PASS
MOBILE_HETEROGENEOUS_SET_IMPORT=PASS
MOBILE_IMPORT_IDEMPOTENCE=PASS
NO_FAKE_UNIFORM_TARGET=PASS

ANDROID_SESSION_DRAFT_EXERCISE_REMOVE=PASS
DESKTOP_SESSION_EXERCISE_REMOVE=PASS

Accepted repetition examples:

5x10
4,5,6,7,8,9,10,9,8,7,6,5,4
4..10..4

A heterogeneous mobile session is persisted as ordered performed_sets. The desktop does not invent target_sets, target_reps or target_duration_seconds for actual-only mobile observations.

On Android, an exercise already added to the current session can be removed before saving the session.

On the desktop TUI, session editing already supports:

d supprimer

for removing the selected exercise from a current or persisted session draft. The database replacement remains transactional.

TRAINLOG_FORMAT_V1 remains frozen and unchanged.