diet-guard/docs/DOCS-textgate-keep.md
Krzysztof kuhy Rudnicki 3cd04e60dc
Some checks are pending
file-length / file length <= 250 lines (push) Waiting to run
md-naming / markdown naming convention (push) Waiting to run
pre-commit / pre-commit (${{ matrix.group }}) (mypy, mypy, ) (push) Waiting to run
pre-commit / pre-commit (${{ matrix.group }}) (pylint, pylint, ) (push) Waiting to run
pre-commit / pre-commit (${{ matrix.group }}) (rest, , mypy,pylint,dependency-freshness) (push) Waiting to run
Tests / test (push) Waiting to run
release-apk / release (APK) (push) Waiting to run
repo-contract / repo contract (push) Waiting to run
textgate: document launcher rows
2026-11-19 15:35:36 +01:00

3.1 KiB

Text kept on purpose (textgate keep list)

kuhy's rule: nothing he sees carries text unless he asked. textgate scan still lists the rows below; each is documented here, and diet_guard/tests/test_textgate_scan_clean.py fails on any hit this file does not name by path. The per-surface guards are test_gate_no_words.py and test_gate_no_words_static.py (Tk gate), app/test/no_words_*_test.dart (phone and web screens) and app/test/desktop/desktop_wrapper_no_text_test.dart (pages served into the Chrome window).

Exempt

  • docs/explanations/*.html: documentation pages, read in a browser on purpose. Not app UI. The scan lists them; the guard ignores that prefix.

Proper nouns (OS-level app name)

Where Text Why
app/lib/main.dart Diet Guard MaterialApp.title: task switcher and tab name
diet_guard/_gatelock.py Diet Gate window title, an identifier under override-redirect
app/android/app/src/main/AndroidManifest.xml DietGuard android:label: launcher name
app/desktop/install_desktop_entry.sh DietGuard, Diet logging and budget companion .desktop Name and Comment: app-menu entry
packaging/aur/PKGBUILD DietGuard, Diet logging and budget companion .desktop Name and Comment in the AUR package

The launcher label and notification channel (DietGuard) live in AndroidManifest.xml and notification_backend_io.dart; a due-slot notification shows only the slot clock time and has no body.

Spoken only (never painted)

Where Text Evidence
app/lib/services/kuchnia_fill_flow.dart delivery and logged sentences FillOutcome.message, same route; no_words_kuchnia_test.dart proves the snackbar paints a glyph and a number

Read by Claude, not by kuhy

MCP tool titles in diet_guard/_mcp.py and diet_guard/_mcp_read.py, and the commit text in diet_guard/_prune_peers.py: tool metadata and a CLI commit message.

Terminal output (settled: keeps its text)

All print/stdout/stderr and --help of the Python CLI, app/bin/ and the stderr lines of app/lib/desktop/wrapper_server.dart. Pages served into the Chrome window answer errors with a status code and an empty body.

DOUBT rows (kuhy to confirm or file a task)

  • MET next to kcal figures (activity rows), and unit symbols kcal kg lb st cm km min: bare identifiers beside a number.
  • Formula proper names painted outside the activity sheet: app/lib/widgets/body/body_stats_cards.dart, goal_card.dart (BMI Prime, Trefethen, ideal-weight and resting-burn formula names). The Tk gate dropped them.
  • Workout names (session.label, session.kind) are PC-published content.

Framework pickers (replaced 2026-11-10)

showDatePicker, showDateRangePicker and showTimePicker painted Select date, Cancel, OK, Save. All five call sites now use the icon-only app/lib/widgets/pickers/ (numerals, check and close icons), guarded by app/test/pickers/no_words_pickers_test.dart and a repo_invariants_test ban. Lost on purpose: the weekday header (Monday-first layout plus a weekend dot instead), month names (numerals 1-12) and both text-entry modes.