gpt-5.3-codex review phase 1 - Flatten the documentation

2026-08-19 14:54:24 -05:00
parent 2c26177d0c
commit 5404224079
32 changed files with 358 additions and 4467 deletions
@@ -37,6 +37,7 @@ Pages may depend on application services and framework-provided dependencies. Co
 - Keep app-wide navigation and layout primitives in `components/app_shell.py`.
 - Keep generic table/event adaptation in `components/table/common.py`; feature-specific columns, row read models, and formatting belong in the feature table module.
 - Keep exception normalization and user-facing error display in `components/error_presenter.py`; preserve `AppError` details and operation identifiers at page/component boundaries.
+- Use `components/media_urls.py` for media URL generation; do not hand-build upload/static paths in page code.

 ## CSS Assets

@@ -51,3 +52,9 @@ Pages may depend on application services and framework-provided dependencies. Co
 - Limit component state to ephemeral interaction state such as loading flags, form values, dialogs, and expansion state.
 - Application and worker state must be resolved at the page or application boundary and passed through narrow interfaces such as callbacks or notifier protocols.
 - Keep filesystem, network, provider, and worker orchestration behind application services or dedicated adapters. UI code may trigger those operations but must not implement them.
+
+## V4 Contract Alignment
+
+- Treat `docs/ver4/` as the active baseline and `docs/ver4/history.md` as historical reference only.
+- Use status vocabulary exactly as modeled (`queued`, `processing`, `transcribed`, `partial_success`, `failed`; and `pending`, `transcribed`, `failed`, `cancelled`).
+- Print/export media flows must use record-validated routes from API modules; direct local filesystem paths are prohibited.