From bc987677e4051a970cef22b976a8232df89ccea6 Mon Sep 17 00:00:00 2001 From: heaven Date: Fri, 7 Aug 2026 23:06:13 +0300 Subject: [PATCH] Tell the truth in the ratified contract header: it called itself an unratified S3 draft for three days and pointed at a companion path absent beside the canon --- docs/architecture/14-api-contract/openapi.yaml | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/docs/architecture/14-api-contract/openapi.yaml b/docs/architecture/14-api-contract/openapi.yaml index ec9cd8a3..125d0f5d 100644 --- a/docs/architecture/14-api-contract/openapi.yaml +++ b/docs/architecture/14-api-contract/openapi.yaml @@ -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