From 34d3aedf1a71705c045bf234389ed8e6036b2b29 Mon Sep 17 00:00:00 2001 From: "camara-release-automation[bot]" <261643975+camara-release-automation[bot]@users.noreply.github.com> Date: Mon, 9 Mar 2026 12:59:51 +0000 Subject: [PATCH 1/3] Update README Release Information for r1.2 --- README.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 673e289..c592a42 100644 --- a/README.md +++ b/README.md @@ -30,12 +30,11 @@ Sandbox API Repository to describe, develop, document, and test the ClickToDial > [!NOTE] > This repository has only pre-release versions available yet. Pre-releases are for testing and may change before public release. -* **PREVIEW**: The latest pre-release is [r1.1](https://github.com/camaraproject/ClickToDial/releases/tag/r1.1) (alpha), with the following API versions: - * **click-to-dial v0.1.0-alpha.1** - [[YAML]](https://github.com/camaraproject/ClickToDial/blob/r1.1/code/API_definitions/click-to-dial.yaml) - [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r1.1/code/API_definitions/click-to-dial.yaml&nocors) - [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r1.1/code/API_definitions/click-to-dial.yaml) -* For changes see [CHANGELOG.md](https://github.com/camaraproject/ClickToDial/blob/main/CHANGELOG.md) +* The latest pre-release is [r1.2](https://github.com/camaraproject/ClickToDial/releases/tag/r1.2) (release candidate), with the following API versions: + * **click-to-dial 0.1.0-rc.1** + [[YAML]](https://github.com/camaraproject/ClickToDial/blob/r1.2/code/API_definitions/click-to-dial.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r1.2/code/API_definitions/click-to-dial.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r1.2/code/API_definitions/click-to-dial.yaml) + +* For changes see [CHANGELOG](https://github.com/camaraproject/ClickToDial/tree/main/CHANGELOG) _The above section is automatically synchronized by CAMARA project-administration._ From 7e6d56202ef7038e0a016fa0a7cf00ddf64301c5 Mon Sep 17 00:00:00 2001 From: "camara-release-automation[bot]" <261643975+camara-release-automation[bot]@users.noreply.github.com> Date: Mon, 9 Mar 2026 12:59:52 +0000 Subject: [PATCH 2/3] Add CHANGELOG draft for r1.2 --- CHANGELOG/CHANGELOG-r1.md | 97 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 CHANGELOG/CHANGELOG-r1.md diff --git a/CHANGELOG/CHANGELOG-r1.md b/CHANGELOG/CHANGELOG-r1.md new file mode 100644 index 0000000..a814fab --- /dev/null +++ b/CHANGELOG/CHANGELOG-r1.md @@ -0,0 +1,97 @@ +# Changelog ClickToDial + + +## Table of Contents +- [r1.2](#r12) + + +**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 + +# r1.2 + +## Release Notes + +This release candidate contains the definition and documentation of +* click-to-dial 0.1.0-rc.1 + +The API definition(s) are based on +* Commonalities r4.1 +* Identity and Consent Management r4.1 + + +> **Working area — candidate changes (auto-removed on merge)** +> Copy relevant entries into the Added/Changed/Fixed/Removed sections below. +> 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 +* Add API rpository wiki page link to README.md by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/39 +* Codeowner update by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/41 +* Embed click-to-dial_API.md into the API definition by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/42 +* Remove the API name in the endpoints by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/43 +* Modification for CloudEvent model by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/46 +* chore: migrate swagger editor links to CAMARA swagger-ui by @hdamker-bot in https://github.com/camaraproject/ClickToDial/pull/48 +* admin: add line 13 (API description for marketing) to API readiness checklists by @hdamker-bot in https://github.com/camaraproject/ClickToDial/pull/49 +* Technical compliance fixes by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/55 +* Reset ClickToDial main branch to wip (Fixes #54) by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/57 +* Fix Authorization header value in test plans (fixes #50) by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/58 +* refactor(api): migrate ClickToDial to a CAMARA-compliant RESTful call resource model by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/59 +* Align Events, Credential Model, Tests and Documentation with CAMARA Guidelines by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/60 +* admin: migrate to centralized linting workflows by @hdamker-bot in https://github.com/camaraproject/ClickToDial/pull/53 +* docs(api): align /calls with OpenAPI by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/63 +* Add callback definition for call status change events by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/64 +* Update click-to-dial feature files with resource URLs and x-correlator by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/66 +* Align ClouEvent schema, security schemes and clean up intro/error codes by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/67 +* Update README terminology and supported features by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/68 +* Align API definitions with Commonalities 0.7.0-rc.1 by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/69 +* [bulk] Sync Release Information section (2026-02-19-001) by @hdamker-bot in https://github.com/camaraproject/ClickToDial/pull/70 +* [bulk] Add release-plan.yaml (2026-02-23-001) by @hdamker-bot in https://github.com/camaraproject/ClickToDial/pull/71 +* Update release track and dependencies in release-plan.yaml by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/74 +* chore: reset test resource URLs to vwip on main (fixes #75) by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/77 +* [bulk] Enable release automation process (2026-03-09-001) by @camara-release-automation[bot] in https://github.com/camaraproject/ClickToDial/pull/80 +* test: add Gherkin test definition for getCall operation (fixes #78) by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/81 + +## New Contributors +* @hdamker-bot made their first contribution in https://github.com/camaraproject/ClickToDial/pull/48 +* @camara-release-automation[bot] made their first contribution in https://github.com/camaraproject/ClickToDial/pull/80 + +
+ + +## click-to-dial 0.1.0-rc.1 + +**click-to-dial 0.1.0-rc.1 is ...** + +- API definition **with inline documentation**: + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r1.2/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/r1.2/code/API_definitions/click-to-dial.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/ClickToDial/blob/r1.2/code/API_definitions/click-to-dial.yaml) + +### Added + +* _To be filled during release review_ + +### Changed + +* _To be filled during release review_ + +### Fixed + +* _To be filled during release review_ + +### Removed + +* _To be filled during release review_ + +**Full Changelog**: https://github.com/camaraproject/ClickToDial/compare/r1.1...r1.2 + From 6d22d07abe50473f9e410cb16ab25119f111df3c Mon Sep 17 00:00:00 2001 From: Yading Fang <45770429+YadingFang@users.noreply.github.com> Date: Mon, 9 Mar 2026 21:44:16 +0800 Subject: [PATCH 3/3] Update CHANGELOG for release r1.2 Updated changelog for release r1.2, adding new API features and correcting previous entries. --- CHANGELOG/CHANGELOG-r1.md | 94 ++++++++++++++++++++++++++++++++++++--- 1 file changed, 87 insertions(+), 7 deletions(-) diff --git a/CHANGELOG/CHANGELOG-r1.md b/CHANGELOG/CHANGELOG-r1.md index a814fab..cd5d80a 100644 --- a/CHANGELOG/CHANGELOG-r1.md +++ b/CHANGELOG/CHANGELOG-r1.md @@ -3,6 +3,7 @@ ## Table of Contents - [r1.2](#r12) +- [r1.1](#r11) **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.** @@ -22,8 +23,8 @@ This release candidate contains the definition and documentation of * click-to-dial 0.1.0-rc.1 The API definition(s) are based on -* Commonalities r4.1 -* Identity and Consent Management r4.1 +* Commonalities v0.7.0-rc.1 +* Identity and Consent Management v0.5.0-rc.1 > **Working area — candidate changes (auto-removed on merge)** @@ -70,7 +71,7 @@ The API definition(s) are based on ## click-to-dial 0.1.0-rc.1 -**click-to-dial 0.1.0-rc.1 is ...** +**click-to-dial 0.1.0-rc.1 is a pre-release version of the click-to-dial API** - API definition **with inline documentation**: - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r1.2/code/API_definitions/click-to-dial.yaml&nocors) @@ -79,19 +80,98 @@ The API definition(s) are based on ### Added -* _To be filled during release review_ +* Introduced the fully RESTful `/calls` resource model: + * `POST /calls` + * `GET /calls/{callId}` + * `DELETE /calls/{callId}` + * `GET /calls/{callId}/recording` +* CloudEvents-based call status change notifications: + * type: `org.camaraproject.click-to-dial.v0.status-changed` + * specversion: "1.0" +* Structured `422 UnprocessableEntity` business validation error codes: + * `INVALID_PHONE_NUMBER` + * `SAME_CALLER_CALLEE` + * `RECORDING_NOT_SUPPORTED` + * `CALLER_NOT_AVAILABLE` + * `CALLEE_NOT_AVAILABLE` ### Changed -* _To be filled during release review_ +* Enum values aligned with CAMARA lowerCamelCase conventions for status and reason. +* Updated sink credential schema to enforce `credentialType = "ACCESSTOKEN"`. +* Updated BDD test definitions to reflect the `/calls` endpoints and versioned base paths. +* Improved alignment of OpenAPI definitions and markdown API documentation examples. ### Fixed -* _To be filled during release review_ +* Corrected CloudEvent examples to match defined schemas and enum values. +* Resolved inconsistencies between error examples and the `ErrorInfo` schema. ### Removed -* _To be filled during release review_ +* Removed deprecated operations from earlier alpha versions: + * `beginCall` + * `releaseCall` + * `downloadRecording` + + These have been replaced by the RESTful `/calls` design. + +### New Contributors + +- N/A **Full Changelog**: https://github.com/camaraproject/ClickToDial/compare/r1.1...r1.2 +# r1.1 + +## Release Note + +This release contains the definition and documentation of + +- click-to-dial v0.1.0-alpha.1 + +The API definition(s) are based on + +- Commonalities v0.5.0 +- Identity and Consent Management v0.3.0 + +## click-to-dial v0.1.0-alpha.1 + +click-to-dial v0.1.0-alpha.1 is the first pre-release version of the click-to-dial API. + +- API definition **with inline documentation**: + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r1.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/r1.1/code/API_definitions/click-to-dial.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/ClickToDial/blob/r1.1/code/API_definitions/click-to-dial.yaml) + +## Added + +- Update for fall2025 by @YadingFang in [#22](https://github.com/camaraproject/ClickToDial/pull/22), [#27](https://github.com/camaraproject/ClickToDial/pull/27), [#29](https://github.com/camaraproject/ClickToDial/pull/29), [#31](https://github.com/camaraproject/ClickToDial/pull/31), [#32](https://github.com/camaraproject/ClickToDial/pull/32) +- Create Click to Dial_API.md by @wuhonglin in [#9](https://github.com/camaraproject/ClickToDial/pull/9) +- Add Click to Dial support material by @HanbaiWang in [#6](https://github.com/camaraproject/ClickToDial/pull/6) +- Create Click to Dial_User_Story by @seekwain in [#11](https://github.com/camaraproject/ClickToDial/pull/11) +- Add API yaml files by @seekwain in [#10](https://github.com/camaraproject/ClickToDial/pull/10) +- Create Click to Dial_API.md by @wuhonglin in [#9](https://github.com/camaraproject/ClickToDial/pull/9) +- Add CTD support material by @HanbaiWang in [#6](https://github.com/camaraproject/ClickToDial/pull/6) + +## Changed + +- N/A + +## Fixed + +- N/A + +## Removed + +- N/A + +## New Contributors + +- @HanbaiWang made their first contribution in [#4](https://github.com/camaraproject/ClickToDial/pull/4) +- @wuhonglin made their first contribution in [#9](https://github.com/camaraproject/ClickToDial/pull/9) +- @seekwain made their first contribution in [#10](https://github.com/camaraproject/ClickToDial/pull/10) +- @YadingFang make their first contribution in [#22](https://github.com/camaraproject/ClickToDial/pull/22) + +**Full Changelog**: [https://github.com/camaraproject/ClickToDial/commits/r1.1/](https://github.com/camaraproject/ClickToDial/commits/r1.1/) +