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

Mirror the corrected contract header in the frontend copy and tell S3 only the version bump is left

Browse source
This commit is contained in:
heaven 2026-08-07 23:06:13 +03:00
parent bc987677e4
commit 61c20bf8e1
2 changed files with 19 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
frontend/docs/S3_SESSION_PROMPT.md
View file

@ -65,6 +65,14 @@
платформа ответила на свои К-вопросы и владелец сменил модель лимитов. Порядок правок твой,
но ни одна не «на потом»: спека — нормативная поверхность, и на ней уже стоит код платформы.
**А-нуль. Шапка `info` спеки уже исправлена оркестратором №15 (07.08) — НЕ возвращай её обратно.**
Три дня после ратификации файл называл себя «DRAFT of frontend session S3 — not a ratified
contract» и ссылался на компаньон по пути, которого рядом с каноном нет. Сейчас там сказана
правда: ратифицирован D39.99, канон в `docs/architecture/14-api-contract/`, зонная копия —
байт-зеркало, компаньон = `README.md` рядом с каноном. **Твоё в этом пункте одно:** строка
`version` всё ещё `0.1.0-draft` — бампни её первым же действием (минорный бамп, как и сказано
ниже), и байт-сверку копий из пункта Д делай уже с этой шапкой.
**А. Решения владельца 04.08 (D39.100).**
1. **К-1:** десять статусов приняты — статусов больше не трогать.
2. **К-8:** `BookStatus` получает 11-е значение **`paused`** (резюмируемый стоп; в `failed` не

17
frontend/docs/api-contract/openapi.yaml
View file

@ -3,14 +3,19 @@ openapi: 3.1.0
info:
title: TextMachine API
version: 0.1.0-draft
summary: Contract between the frontend and the TextMachine platform (draft, awaiting ratification).
summary: Ratified contract between the frontend and the TextMachine platform (D39.99).
description: |
**DRAFT of frontend session S3 — not a ratified contract.** The ratified copy belongs in
`docs/architecture/14-api-contract/` (orchestrator's zone).
**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.
⚠ Text corrected by orchestrator #15 on 07.08: this file called itself an unratified draft of
session S3 for three days after it was ratified, and pointed at a companion path that does not
exist beside the canonical copy. The version string still reads `-draft` — session S3 bumps it
as the first item of its spec work.
Companion document: `../API_CONTRACT_DRAFT.md` — 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.
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.
## Boundaries