architect(ET): auto-commit from architect run_id=158

docs/work-items/ORCH-044/08-data-requirements.md

@@ -0,0 +1,23 @@
+# 08 — Требования к схеме БД
+
+**Work Item:** ORCH-044
+**Основано на:** ADR-001, ТЗ `02-trz.md` §4
+
+## Вердикт: изменений схемы НЕ требуется
+
+Новых таблиц, колонок, индексов, миграций — **нет**.
+
+P1 (auth-preflight) и P3 (пустой результат ⇒ провал) работают на **существующих** структурах:
+
+- **`jobs`** — повторно используются существующие колонки для пути провала:
+  `status` (`queued`/`running`/`done`/`failed`), `error`, `attempts`, `max_attempts`,
+  `transient_attempts`, `available_at`, `run_id`. Пустой/невалидный результат идёт тем же
+  путём, что и обычный permanent/transient провал (`mark_job` / `mark_job_transient`).
+- **`agent_runs`** — `exit_code` пишется без искажения (реальный код выхода процесса).
+  Решение done/fail принимается по отдельному in-memory флагу `result_ok` в `_monitor_agent`,
+  а не по колонке.
+
+## Состояние данных
+- Никаких бэкофиллов / data-migration.
+- Auth-проверка читает **файл** `.credentials.json` (вне БД), результат кешируется in-memory
+  (`preflight._cache`), не персистится.