From ffac49d098af6c9437ead2e779cc64d8a7e6bbf2 Mon Sep 17 00:00:00 2001 From: Patrick Buckley Date: Fri, 24 Apr 2026 15:15:21 -0700 Subject: [PATCH] docs(changelog): flag the coord URL move under [Unreleased] MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The plan called the CHANGELOG callout for the ``/v1/api/coordinator/`` → ``/v1/api/workstreams/`` move non-negotiable since experimental SDK consumers from 1.5.0aN lose the URL outright. Adds the path-mapping table under [Unreleased] so the line lands in the 1.5.0 release notes when the version cuts. Stable upgraders (1.0 / 1.3 / 1.4) never saw the coord URL prefix so the change is a no-op for them — the entry says so explicitly. --- CHANGELOG.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 50a735a2..7f1b6785 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,6 +15,29 @@ Three release tracks are maintained: ## [Unreleased] +### Changed + +- **Coordinator HTTP surface unified under `/v1/api/workstreams/`** + ([Stage 2 Priority 0]). The experimental `/v1/api/coordinator/*` + URL tree from 1.5.0aN is removed; coord verbs now mount at the + same shape as interactive workstreams via a shared route + registrar (`turnstone.core.session_routes`). Path mapping: + + | Was (1.5.0aN) | Now | + |--------------------------------------------------|--------------------------------------------------| + | `POST /v1/api/coordinator/new` | `POST /v1/api/workstreams/new` | + | `GET /v1/api/coordinator` | `GET /v1/api/workstreams` | + | `GET /v1/api/coordinator/saved` | `GET /v1/api/workstreams/saved` | + | `GET /v1/api/coordinator/{ws_id}` | `GET /v1/api/workstreams/{ws_id}` | + | `POST /v1/api/coordinator/{ws_id}/{verb}` | `POST /v1/api/workstreams/{ws_id}/{verb}` | + + Permission scopes, request / response bodies, and SSE event shapes + are unchanged. Callers on the experimental 1.5.0aN coord SDK must + swap their URL prefix; the legacy paths are gone with no compat + shim. Stable releases (1.0 / 1.3 / 1.4) never exposed + `/v1/api/coordinator/`, so this change is a no-op for anyone + upgrading from a stable line. + ## [1.4.0] User-visible additions: a full attachment system (images + text documents,