heaven/textmachine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Record 0.2.2 and the queued 0.2.3 task in the contract companion, drop the stale pre-ratification note from the canonical spec description

Browse source
This commit is contained in:
heaven 2026-08-14 03:46:18 +03:00
parent e4b7960270
commit 381212086f
2 changed files with 1 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
docs/architecture/14-api-contract/README.md
View file

@ -41,7 +41,7 @@ openapi.yaml РЯДОМ (байт-копия зонной frontend/docs/api-cont
> каждое решение, чем оно обосновано, что осталось открытым. При расхождении по ФОРМЕ
> побеждает YAML; при вопросе «почему так» — этот файл.
>
> **Статус: РАТИФИЦИРОВАН — D39.99 (04.08), контракт 0.2.0 (D39.115, 08.08); 0.2.1 (D39.123, 09.08): += `503` на `POST /books/{bookId}/runs` — старт прогона на неукомплектованном деплое (шов движка не сконфигурирован) не выражается ни одним прежним кодом; закрывает PD-112 платформы.** Дом канона — этот каталог; `frontend/docs/api-contract/openapi.yaml` — байт-зеркало. ⚠ Испр. оркестратором №15 08.08: файл называл себя черновиком на ратификацию четверо суток ПОСЛЕ ратификации — тот же класс, что шапка `info` спеки.
> **Статус: РАТИФИЦИРОВАН — D39.99 (04.08), контракт 0.2.0 (D39.115, 08.08); 0.2.1 (D39.123, 09.08): += `503` на `POST /books/{bookId}/runs` — старт прогона на неукомплектованном деплое (шов движка не сконфигурирован) не выражается ни одним прежним кодом; закрывает PD-112 платформы; 0.2.2 (D39.129, 10.08): `BankTerm.sense` обязателен (Ф-47). Следующая правка — 0.2.3 (PD-172/173/174/180), задача S4-промта (D39.130).** Дом канона — этот каталог; `frontend/docs/api-contract/openapi.yaml` — байт-зеркало. ⚠ Испр. оркестратором №15 08.08: файл называл себя черновиком на ратификацию четверо суток ПОСЛЕ ратификации — тот же класс, что шапка `info` спеки.
> `docs/architecture/14-api-contract/`, зона оркестратора; перенос делает он, генерация типов
> после ратификации идёт из перенесённой копии — контракт первичен, код вторичен.
>

5
docs/architecture/14-api-contract/openapi.yaml
View file

@ -8,11 +8,6 @@ info:
**RATIFIED contract (D39.99, 04.08.2026).** The canonical copy lives in
`docs/architecture/14-api-contract/` (orchestrator's zone); `frontend/docs/api-contract/` is a
byte-mirror of it, and a divergence is a defect of one of the two, never a local edit.
⚠ **This copy is deliberately AHEAD of the canonical one right now.** Version 0.2.0 was written
by session S3 from the owner's decisions of 04–07.08 and the platform's ratified answers; the
orchestrator re-ratifies the canonical copy by diff, and the two are byte-equal again after
that landing.
Companion document: the `README.md` beside the canonical copy — provenance of every decision
(derived from engine code / proposed by the frontend / open), rationale, dependencies and open
questions. This file is normative for the FORM; the companion explains where the form comes from.