From 74a8f019804fb2592fc2202066c919333b7f2cf1 Mon Sep 17 00:00:00 2001 From: "camara-release-automation[bot]" <261643975+camara-release-automation[bot]@users.noreply.github.com> Date: Wed, 24 Jun 2026 04:29:35 +0000 Subject: [PATCH 1/4] Update README Release Information for r2.1 --- README.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 8d8d256..6370a24 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ Sandbox API Repository to describe, develop, document, and test the ClickToDial > [!NOTE] > Please be aware that the project will have frequent updates to the main branch. There are no compatibility guarantees associated with code in any branch, including main, until a new release is created. For example, changes may be reverted before a release is created. **For best results, use the latest available release**. -* The latest public release is [r1.4](https://github.com/camaraproject/ClickToDial/releases/tag/r1.4) (Spring26), with the following API versions: +* The latest public release is [r1.4](https://github.com/camaraproject/ClickToDial/releases/tag/r1.4), with the following API versions: * **click-to-dial 0.1.0** [[YAML]](https://github.com/camaraproject/ClickToDial/blob/r1.4/code/API_definitions/click-to-dial.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r1.4/code/API_definitions/click-to-dial.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r1.4/code/API_definitions/click-to-dial.yaml) @@ -38,6 +38,13 @@ Sandbox API Repository to describe, develop, document, and test the ClickToDial * Other releases of this repository are available in https://github.com/camaraproject/ClickToDial/releases * For changes see [CHANGELOG](https://github.com/camaraproject/ClickToDial/tree/main/CHANGELOG) +### Upcoming Release Preview + +* Pre-release: [r2.1](https://github.com/camaraproject/ClickToDial/releases/tag/r2.1) (release candidate) + * **click-to-dial 0.2.0-rc.1** + [[YAML]](https://github.com/camaraproject/ClickToDial/blob/r2.1/code/API_definitions/click-to-dial.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r2.1/code/API_definitions/click-to-dial.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r2.1/code/API_definitions/click-to-dial.yaml) + + _The above section is automatically synchronized by CAMARA project-administration._ From 4671faa1875a03cc439d4c7b1dde324db7884622 Mon Sep 17 00:00:00 2001 From: "camara-release-automation[bot]" <261643975+camara-release-automation[bot]@users.noreply.github.com> Date: Wed, 24 Jun 2026 04:29:36 +0000 Subject: [PATCH 2/4] Add CHANGELOG draft for r2.1 --- CHANGELOG/CHANGELOG-r2.md | 78 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 CHANGELOG/CHANGELOG-r2.md diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md new file mode 100644 index 0000000..6420e0a --- /dev/null +++ b/CHANGELOG/CHANGELOG-r2.md @@ -0,0 +1,78 @@ +# Changelog ClickToDial + + +## Table of Contents +- [r2.1](#r21) + + +**Please be aware that the project will have frequent updates to the main branch. There are no compatibility guarantees associated with code in any branch, including main, until it has been released. For example, changes may be reverted before a release is published. For the best results, use the latest published release.** + +The below sections record the changes for each API version in each release as follows: + +* for an alpha release, the delta with respect to the previous release +* for the first release-candidate, all changes since the last public release +* for subsequent release-candidate(s), only the delta to the previous release-candidate +* for a public release, the consolidated changes since the previous public release + +# r2.1 + +## Release Notes + +This release candidate contains the definition and documentation of +* click-to-dial 0.2.0-rc.1 + +The API definition(s) are based on +* Commonalities 0.8.0 +* Identity and Consent Management 0.5.0 + + +> **Working area — candidate changes (auto-removed on merge)** +> Copy relevant entries into the Breaking changes/Added/Changed/Fixed/Removed sections below. List breaking changes both in Breaking changes and in their normal change category. +> You may edit this list while triaging; it will be removed on merge. +> This working-area section is removed automatically when the PR is merged. + +
+Candidate changes (auto-generated from merged PRs) + +## What's Changed +* Release Automation: Post-release sync (r1.4) by @camara-release-automation[bot] in https://github.com/camaraproject/ClickToDial/pull/107 +* Update release plan for Sync26 ClickToDial 0.2.0-rc by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/108 +* Clarify ClickToDial lifecycle and callback documentation by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/110 +* Add enhanced ClickToDial rainy-day test scenarios by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/111 + +
+ + +## click-to-dial 0.2.0-rc.1 + +**click-to-dial 0.2.0-rc.1 is a release-candidate version of this API.** + +Changes documented below are compared to version 0.1.0. + +- API definition **with inline documentation**: + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r2.1/code/API_definitions/click-to-dial.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r2.1/code/API_definitions/click-to-dial.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/ClickToDial/blob/r2.1/code/API_definitions/click-to-dial.yaml) + +### Breaking changes + +* N/A + +### Added + +* N/A + +### Changed + +* N/A + +### Fixed + +* N/A + +### Removed + +* N/A + +**Full Changelog**: https://github.com/camaraproject/ClickToDial/compare/r1.4...r2.1 + From e7261b423c583899f88d48f84690c82473b41c1f Mon Sep 17 00:00:00 2001 From: Yading Fang <45770429+YadingFang@users.noreply.github.com> Date: Wed, 24 Jun 2026 13:10:34 +0800 Subject: [PATCH 3/4] Update CHANGELOG-r2.md --- CHANGELOG/CHANGELOG-r2.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md index 6420e0a..81b0f66 100644 --- a/CHANGELOG/CHANGELOG-r2.md +++ b/CHANGELOG/CHANGELOG-r2.md @@ -61,14 +61,27 @@ Changes documented below are compared to version 0.1.0. ### Added * N/A +* ### Breaking changes + +* N/A + +### Added + +* Added detailed ClickToDial call lifecycle documentation, clarifying the provider-managed aggregate call session state and the `initiating`, `callingCaller`, `callingCallee`, `connected`, `disconnected`, and `failed` status values. +* Added detailed user stories and acceptance criteria for creating ClickToDial calls with status notifications, terminating active calls, and retrieving recordings after completed recorded calls. +* Added enhanced Gherkin test scenarios for rainy-day and edge-case behavior across `createCall`, `getCall`, `terminateCall`, and `getRecording`, including malformed and unknown `callId`, authentication and authorization failures, invalid caller/callee inputs, recording availability, and callback event validation. ### Changed -* N/A +* Clarified callback delivery behavior for status notifications, including structured CloudEvents delivery, `CallStatusChangedEvent` usage, sink credential handling, retry behavior, and state reconciliation using `GET /calls/{callId}`. +* Clarified recording availability conditions for `GET /calls/{callId}/recording`, including when a recording can be retrieved and when `404 NOT_FOUND` is returned. +* Improved OpenAPI descriptions for call status, callback events, call creation, and recording retrieval without changing API behavior. ### Fixed -* N/A +* Fixed stale documentation and test references from `EventCTDStatusChanged` to the current `CallStatusChangedEvent` schema. +* Fixed Gherkin test expectations to align callback event `caller` and `callee` values with the phone number payload defined in the OpenAPI schema. +* Fixed recording retrieval test expectations to avoid requiring optional `generatedAt` in `RecordingResource`. ### Removed From 35ff62ceca2dc4e3fe2b3f0fe9118de81dbc6a96 Mon Sep 17 00:00:00 2001 From: Yading Fang <45770429+YadingFang@users.noreply.github.com> Date: Wed, 24 Jun 2026 13:12:26 +0800 Subject: [PATCH 4/4] Update CHANGELOG --- CHANGELOG/CHANGELOG-r2.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md index 81b0f66..c3ad64f 100644 --- a/CHANGELOG/CHANGELOG-r2.md +++ b/CHANGELOG/CHANGELOG-r2.md @@ -60,13 +60,6 @@ Changes documented below are compared to version 0.1.0. ### Added -* N/A -* ### Breaking changes - -* N/A - -### Added - * Added detailed ClickToDial call lifecycle documentation, clarifying the provider-managed aggregate call session state and the `initiating`, `callingCaller`, `callingCallee`, `connected`, `disconnected`, and `failed` status values. * Added detailed user stories and acceptance criteria for creating ClickToDial calls with status notifications, terminating active calls, and retrieving recordings after completed recorded calls. * Added enhanced Gherkin test scenarios for rainy-day and edge-case behavior across `createCall`, `getCall`, `terminateCall`, and `getRecording`, including malformed and unknown `callId`, authentication and authorization failures, invalid caller/callee inputs, recording availability, and callback event validation.