fy59/trainlog
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Authorize Notcurses TUI migration

Browse source
This commit is contained in:
fy59 2026-09-06 22:24:49 +02:00
parent 396bea6910
commit 444a4d2d8d
1 changed files with 59 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

64
AGENTS.md
View file

@ -5,8 +5,10 @@
Trainlog consists of: Trainlog consists of:
- a native Android application for fast workout and body-data capture; - a native Android application for fast workout and body-data capture;
- a Unix/Linux C17 ncursesw TUI for durable history, correction, analysis, - a Unix/Linux C17 terminal TUI for durable history, correction, analysis,
visualization, and manual synchronization; visualization, and manual synchronization. The current authorized
`TUI_NOTCURSES_V1` infrastructure tranche migrates the active rendering/input
backend from legacy ncursesw to Notcurses without changing product semantics;
- a small user-session PC agent, `trainlog-syncd`, for Android-triggered - a small user-session PC agent, `trainlog-syncd`, for Android-triggered
synchronization; synchronization;
- versioned JSON synchronization artifacts exchanged over direct MTP. - versioned JSON synchronization artifacts exchanged over direct MTP.
@ -71,23 +73,75 @@ The desktop core is C17.
Current primary dependencies: Current primary dependencies:
- ncursesw;
- SQLite3; - SQLite3;
- utf8proc; - utf8proc;
- libuuid; - libuuid;
- libudev; - libudev;
- libmtp; - libmtp;
- Meson; - Meson;
- Ninja. - Ninja;
- one active desktop terminal backend.
For the authorized `TUI_NOTCURSES_V1` tranche:
```text
legacy backend = ncursesw
target backend = Notcurses
```
During the migration, ncursesw may remain only as the pre-migration
implementation being replaced. Once `TUI_NOTCURSES_V1=PASS`, active desktop TUI
code and build wiring must use Notcurses and must not retain ncursesw as an
unused permanent compatibility backend.
Business logic, persistence, transport, and rendering remain separated. Business logic, persistence, transport, and rendering remain separated.
SQLite operations must not be scattered through rendering code. SQLite operations must not be scattered through rendering code.
Important business rules must not depend directly on ncurses. Important business rules must not depend directly on ncurses, Notcurses, or
terminal-library-specific key constants.
Strict warning policy must not be weakened to make a change compile. Strict warning policy must not be weakened to make a change compile.
### Desktop TUI backend contract
The terminal library is infrastructure, not product semantics.
The active TUI backend must preserve:
```text
public entry point: trainlog_tui_run(TrainlogDatabase *)
minimum terminal: 72x20
small-terminal fallback
keyboard-first navigation
UTF-8 text input
resize recovery
semantic color roles
all existing screen/workflow behavior
```
Terminal-library state must not become process-global application state.
Application screen logic should consume Trainlog-owned key/input semantics
rather than raw backend-specific `KEY_*`/event constants.
The Notcurses migration may modernize rendering with true color, Unicode
borders, flat panels, and clearer focus/selection states, but must not change:
```text
database schema or SQL semantics
TRAINLOG_FORMAT_V1
exercise semantics
session semantics
measured-max semantics
body-analytics semantics
sync/MTP protocols
Android behavior
```
After the migration is validated, canonical documentation must describe
Notcurses as the active desktop TUI backend.
## 6. Android implementation ## 6. Android implementation
Android is a Kotlin/Jetpack Compose capture client. Android is a Kotlin/Jetpack Compose capture client.