gpt-5.3-codex review Phase 3

2026-08-19 20:50:21 -05:00
parent de8cdb6e1a
commit 30fcef3892
10 changed files with 25 additions and 55 deletions
@@ -23,6 +23,7 @@ Use category-driven semantics aligned to canonical V4 policy:
 - `internal`

 Do not invent ad hoc categories in user/API-facing envelopes unless canonical docs are updated.
+Service-layer exceptions must normalize to this category set before crossing service boundaries.

 ## Translation Boundaries

@@ -41,6 +42,7 @@ Do not invent ad hoc categories in user/API-facing envelopes unless canonical do
 - Page-level (`JobSource`): `pending`, `transcribed`, `failed`, `cancelled`.
 - Job terminals: `transcribed`, `partial_success`, `failed`.
 - Cancellation must keep job-level and page-level semantics explicit and consistent.
+- Do not emit legacy terminal state language such as `completed` in active user/API lifecycle contracts.

 ## User-Safe Messaging

@@ -67,3 +69,4 @@ If taxonomy, retries, or envelope semantics change:
 1. Update canonical docs (`docs/ver4/error_handling_v4.md`, and invariant docs if needed).
 2. Update tests in the same change.
 3. Update related instruction/skill references.
+4. If change affects persisted status/category fields, update `docs/ver4/schema_v4.md` when applicable.