trainlog/docs/roadmap.md

Roadmap

Gate 0 — Project contract

Status: PASS

Canonical result:

GATE_0=PASS
GATE_0_REVIEW_01=PASS

Gate 0 established:

• repository structure;
• development contract;
• architecture documentation;
• coding-style rules;
• exchange-format draft;
• structural and semantic validation;
• positive and negative fixture strategy.

Reviewed hardening commit:

bc54d6b4ce10d098916823b6a79f72b39d9c7703

Gate 0 closure commit:

ebd4316ed68c58598a471e567edf13455d00f92b

Gate 1 — Exchange format v1 freeze

Status: VALIDATION PENDING — REVIEW #1

Canonical state:

GATE_1_REVIEW_01=IMPLEMENTED
GATE_1=VALIDATION_PENDING
TRAINLOG_FORMAT_V1=DRAFT

Review #1 freezes the proposed model for:

• exercise identity;
• stable repetition/duration tracking mode;
• session identity;
• session ordering;
• external/none/assistance load semantics;
• planned versus actual sets;
• zero-repetition failed attempts;
• planned exercises with zero actual sets;
• planned rest;
• body weight;
• final v1 body-measurement field list;
• optional notes;
• strict catalog completeness;
• strict unknown-field behavior.

Exit criteria:

• all valid fixtures accepted;
• all invalid fixtures rejected for the intended reason;
• Android documentation aligned;
• TUI documentation aligned;
• schema and semantic validator aligned;
• review commit pushed to Forgejo and GitHub;
• mirrored review passes;
• TRAINLOG_FORMAT_V1=FROZEN.

Gate 2 — TUI persistence core

Deliverables:

• Meson C17 project;
• SQLite open/create;
• schema versioning;
• exercise catalog;
• session import transaction;
• idempotent import tests.

Exit criteria:

• database tests pass;
• sanitizer validation passes.

Gate 3 — Minimal TUI

Deliverables:

• ncursesw initialization;
• centralized color theme module;
• dashboard shell;
• exercise list;
• session history;
• direct session entry;
• import screen;
• minimum-terminal fallback.

Exit criteria:

• usable color TUI;
• monochrome fallback;
• UTF-8 test pass.

Gate 4 — Android recorder

Deliverables:

• local exercise catalog;
• start/stop session timestamps;
• target entry;
• actual-set entry;
• rest entry;
• body data;
• JSON export.

Exit criteria:

• exported fixture validates against frozen v1;
• exported file imports successfully into the TUI.

Gate 5 — Analytics

Deliverables:

• body-weight trend;
• measurement trend;
• exercise performance trend;
• training volume summaries;
• terminal graphs.

Gate 6 — Hardening

Deliverables:

• broader fixture coverage;
• migrations;
• import/export robustness;
• documentation cleanup;
• packaging;
• first tagged release.