From a4ab8a4fa1ead64fa3da98cb7f1ef1d6dbecf4e9 Mon Sep 17 00:00:00 2001 From: James Maes Date: Thu, 5 Nov 2026 17:09:15 -0600 Subject: [PATCH 1/4] docs(release): record protocol 1.1.0 publication and consumer fixture pins Co-Authored-By: Claude Fable 5.1 Signed-off-by: James Maes --- CHANGELOG.md | 2 +- docs/INTEGRATION.md | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f7bec30..fa212e0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,6 @@ # Changelog -## 1.1.0 — unreleased +## 1.1.0 Additive contract for printing semantic extension **2.4.0**. Wire payload stays **v1** and the subprotocol stays `qqq-printing.v1`; every 2.3.0 fixture is unchanged. diff --git a/docs/INTEGRATION.md b/docs/INTEGRATION.md index 7300e24..9e91754 100644 --- a/docs/INTEGRATION.md +++ b/docs/INTEGRATION.md @@ -2,6 +2,8 @@ ## Stable printing release +The current primary release is [protocol 1.1.0](https://git.kof22.com/QRun-IO/qqq-print-protocol/releases/tag/v1.1.0) (annotated tag `v1.1.0` at source `5005f3c9e27053b6c327bb923695012832c0fdcc`, bundle `qqq-print-protocol-1.1.0.tar.gz` SHA-256 `541f0f3054cbfe9ce16e7dea58fad01b55a7f0e9246ade8f30df1bb826940703`), adding printing extension 2.4.0's `printer-approval-v1` capability and `PRINTERS` frame. It pairs with [QBit 1.1.0](https://git.kof22.com/QRun-IO/qbit-printing/releases/tag/v1.1.0) and the Windows connector 1.2.0 (pending publication at the time of writing); the 1.0.0 cohort below stays valid for 2.3 peers. + The primary [protocol 1.0.0 release](https://git.kof22.com/QRun-IO/qqq-print-protocol/releases/tag/v1.0.0) is published on Gitea (release record 1344). This is the specification and fixture bundle, not an application installer. @@ -64,7 +66,7 @@ with native printing API 2.3.0 and QQQ 4.1.0-RC.21 as its dependency baseline. For local development, clone them as siblings. The Java HTTP test defaults to `../qqq-print-protocol/fixtures` and accepts `-Dprinting.protocol.fixtures=`. The Windows tests link shared fixtures from the sibling repository. See each consumer README for its build and platform requirements. -CI must check out this repository at an immutable commit reviewed with the consumer change. A checkout path of `qqq-print-protocol` beside `qbit-printing` or `qqq-print-agent` preserves the local layout. Do not pin a moving branch for release qualification. The current consumer fixture pin `42c0d249f81395f00408ec0f92638dcbbf5deb03` is distinct from protocol 1.0.0 release source `d652fba1317aec7f25c5a464bac15e97d6094e67`. Maintainers update the pin through a reviewed consumer change; the readable GitHub shadow retains it for the Windows fixture bridge. +CI must check out this repository at an immutable commit reviewed with the consumer change. A checkout path of `qqq-print-protocol` beside `qbit-printing` or `qqq-print-agent` preserves the local layout. Do not pin a moving branch for release qualification. The current consumer fixture pins are `ac835f8b9396b641b525669249fdb4a1e2a50c99` (Windows, the PR 11 commit) and `5005f3c9e27053b6c327bb923695012832c0fdcc` (QBit, the 1.1.0 source); both carry the 1.1.0 fixtures. Maintainers update the pin through a reviewed consumer change; the readable GitHub shadow retains it for the Windows fixture bridge. If a consumer builds outside a multi-checkout workspace, download the release archive, verify `SHA256SUMS`, extract it and point its tests at `fixtures/`. Consume `schemas/protocol.schema.json#/$defs/` with a JSON Schema 2020-12 validator. -- 2.54.0 From 54c02db3a0cd0c1a6af70a1599733b0cdcefe9d4 Mon Sep 17 00:00:00 2001 From: James Maes Date: Fri, 6 Nov 2026 07:54:15 -0600 Subject: [PATCH 2/4] docs(readme): published distribution 1.1.0 and the 2.4.0 cohort Co-Authored-By: Claude Fable 5.1 Signed-off-by: James Maes --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8bc076c..d3dc43a 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ Shared contract for the [QQQ 4.1+ printing QBit](https://git.kof22.com/QRun-IO/qbit-printing) and [Windows AppKit connector](https://git.kof22.com/QRun-IO/qqq-print-agent). The [realtime transport](docs/REALTIME.md) uses a client-initiated authenticated two-way WebSocket for controls, receipts and job notifications, with separate streamed HTTPS documents and no polling fallback. No inbound connection to the facility is required. This contract is authoritative for wire names; language types may use their idiomatic naming. -Published distribution: [**1.0.0**](https://git.kof22.com/QRun-IO/qqq-print-protocol/releases/tag/v1.0.0). Wire protocol: **v1**. The stable cohort pairs [Windows 1.0.1](https://git.kof22.com/QRun-IO/qqq-print-agent/releases/tag/v1.0.1) with [QBit 1.0.0](https://git.kof22.com/QRun-IO/qbit-printing/releases/tag/v1.0.0), printing semantic API **2.3.0**, and QQQ **4.1.0-RC.21**. See [release and fixture provenance](docs/INTEGRATION.md#stable-printing-release). This repository supplies specification, JSON Schema and synthetic compatibility fixtures; install the Windows connector and integrate the QBit from their own repositories to print documents. +Published distribution: [**1.1.0**](https://git.kof22.com/QRun-IO/qqq-print-protocol/releases/tag/v1.1.0). Wire protocol: **v1**. The stable cohort pairs [Windows 1.2.1](https://git.kof22.com/QRun-IO/qqq-print-agent/releases/tag/v1.2.1) with [QBit 1.1.0](https://git.kof22.com/QRun-IO/qbit-printing/releases/tag/v1.1.0), printing semantic API **2.4.0**, and QQQ **4.1.0-RC.21**; the [1.0.0 cohort](https://git.kof22.com/QRun-IO/qqq-print-protocol/releases/tag/v1.0.0) (Windows 1.0.1, QBit 1.0.0, API 2.3.0) stays compatible. See [release and fixture provenance](docs/INTEGRATION.md#stable-printing-release). This repository supplies specification, JSON Schema and synthetic compatibility fixtures; install the Windows connector and integrate the QBit from their own repositories to print documents. The stable release includes the [printer media and operator contract](docs/PRINTER-MEDIA.md) for printing semantic extension **2.3.0** (see the @@ -13,7 +13,7 @@ granting device management. Use the stable cohort above for these profiles; older 0.3.2 clients do not support them. Wire version 1 and the client-initiated realtime transport stay the same. -Source version **1.1.0** (unreleased) adds printing semantic extension **2.4.0**: +Distribution **1.1.0** adds printing semantic extension **2.4.0**: the `printer-approval-v1` HELLO capability and the server → client `PRINTERS` frame, which reports each exposed printer's server approval over the [realtime channel](docs/REALTIME.md#printer-approval). Clients advertise it only -- 2.54.0 From 920dd57035032ff566eae9f32f1c8ae7628159a6 Mon Sep 17 00:00:00 2001 From: James Maes Date: Fri, 6 Nov 2026 07:55:04 -0600 Subject: [PATCH 3/4] docs: the paired Windows connector is 1.2.1 (1.2.0 was never published) Co-Authored-By: Claude Fable 5.1 Signed-off-by: James Maes --- docs/INTEGRATION.md | 2 +- docs/VERSIONS.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/INTEGRATION.md b/docs/INTEGRATION.md index 9e91754..b27e971 100644 --- a/docs/INTEGRATION.md +++ b/docs/INTEGRATION.md @@ -2,7 +2,7 @@ ## Stable printing release -The current primary release is [protocol 1.1.0](https://git.kof22.com/QRun-IO/qqq-print-protocol/releases/tag/v1.1.0) (annotated tag `v1.1.0` at source `5005f3c9e27053b6c327bb923695012832c0fdcc`, bundle `qqq-print-protocol-1.1.0.tar.gz` SHA-256 `541f0f3054cbfe9ce16e7dea58fad01b55a7f0e9246ade8f30df1bb826940703`), adding printing extension 2.4.0's `printer-approval-v1` capability and `PRINTERS` frame. It pairs with [QBit 1.1.0](https://git.kof22.com/QRun-IO/qbit-printing/releases/tag/v1.1.0) and the Windows connector 1.2.0 (pending publication at the time of writing); the 1.0.0 cohort below stays valid for 2.3 peers. +The current primary release is [protocol 1.1.0](https://git.kof22.com/QRun-IO/qqq-print-protocol/releases/tag/v1.1.0) (annotated tag `v1.1.0` at source `5005f3c9e27053b6c327bb923695012832c0fdcc`, bundle `qqq-print-protocol-1.1.0.tar.gz` SHA-256 `541f0f3054cbfe9ce16e7dea58fad01b55a7f0e9246ade8f30df1bb826940703`), adding printing extension 2.4.0's `printer-approval-v1` capability and `PRINTERS` frame. It pairs with [QBit 1.1.0](https://git.kof22.com/QRun-IO/qbit-printing/releases/tag/v1.1.0) and the Windows connector 1.2.1; the 1.0.0 cohort below stays valid for 2.3 peers. The primary [protocol 1.0.0 release](https://git.kof22.com/QRun-IO/qqq-print-protocol/releases/tag/v1.0.0) is published on Gitea (release record 1344). This is the specification and fixture diff --git a/docs/VERSIONS.md b/docs/VERSIONS.md index 9278ac8..43ecd27 100644 --- a/docs/VERSIONS.md +++ b/docs/VERSIONS.md @@ -46,6 +46,6 @@ additive and keeps the earlier behavior. QBit 1.0.0 advertises native printing extension 2.3.0. Windows 1.0.1 is the paired stable client; their product versions do not replace capability discovery. -QBit 1.1.0 advertises 2.4.0 and pairs with Windows 1.2.0; a 2.4.0 server still +QBit 1.1.0 advertises 2.4.0 and pairs with Windows 1.2.1; a 2.4.0 server still serves 1.0.1/1.1.x clients as four-capability peers, and a 1.2.0 client facing 2.3.0 does not advertise `printer-approval-v1`. -- 2.54.0 From fde9cd81836ef51a3e0fdb5bcb2bbc515372cc84 Mon Sep 17 00:00:00 2001 From: James Maes Date: Fri, 6 Nov 2026 07:55:33 -0600 Subject: [PATCH 4/4] docs(versions): 1.2.1 client in the negotiation example Co-Authored-By: Claude Fable 5.1 Signed-off-by: James Maes --- docs/VERSIONS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/VERSIONS.md b/docs/VERSIONS.md index 43ecd27..aec9bb3 100644 --- a/docs/VERSIONS.md +++ b/docs/VERSIONS.md @@ -47,5 +47,5 @@ additive and keeps the earlier behavior. QBit 1.0.0 advertises native printing extension 2.3.0. Windows 1.0.1 is the paired stable client; their product versions do not replace capability discovery. QBit 1.1.0 advertises 2.4.0 and pairs with Windows 1.2.1; a 2.4.0 server still -serves 1.0.1/1.1.x clients as four-capability peers, and a 1.2.0 client facing +serves 1.0.1/1.1.x clients as four-capability peers, and a 1.2.1 client facing 2.3.0 does not advertise `printer-approval-v1`. -- 2.54.0