From 9ccd9d9b430db40f2e4acd4f463583b9adfff66a Mon Sep 17 00:00:00 2001 From: James Maes Date: Tue, 3 Nov 2026 09:53:23 -0600 Subject: [PATCH 1/3] release: prepare printing 1.0.0 dependency adoption Document the final product scope and remaining native-login core publication dependency. Preserve the current core pin until the supported artifact is published. Co-Authored-By: Claude Sonnet 5.5 --- CHANGELOG.md | 11 +++++++++++ README.md | 4 ++-- docs/SESSION-STATE.md | 10 ++++++++++ docs/TODO.md | 5 +++++ pom.xml | 2 +- 5 files changed, 29 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index fe75720..3a86c94 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,16 @@ # Changelog +## 1.0.0 — prepared; not yet published + +Product version 1.0.0 for the same code as 0.4.0-rc.1: record, table-list and text print +processes, PDF rendering with headers and footers, the least-privilege operator catalog, +reported Windows queue-default media (`printer-media-v1`) and the opt-in retained-source +facade. Native printing stays **2.3.0** with wire payload v1; 1.0 is a product version, not a +wire change, and it pairs with Windows connector 1.0.1 and protocol 1.0.0. The QQQ dependency +is still 4.1.0-RC.20; it will move to a published QQQ 4.1 candidate that provides native +session login before this release is built and published. Until then 1.0.0 is not published +and has not been verified against that core. + ## 0.4.0-rc.1 Printing extension **2.3.0** (additive; wire payload v1 and the agent subprotocol are diff --git a/README.md b/README.md index 112f0ad..f6ca52c 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ # QQQ Printing -Cloud printing for QQQ 4.1+, paired with the [Windows AppKit connector](https://github.com/QRun-IO/qqq-print-agent) and the [shared protocol](https://github.com/QRun-IO/qqq-print-protocol). The Windows connector opens an outbound, authenticated two-way WebSocket; documents download separately over HTTPS. The cloud needs no inbound route into the facility. Release candidate **0.3.0-rc.1** requires native printing API **2.0**, with no job/control polling fallback. Upgrade the server before the matching Windows connector. +Cloud printing for QQQ 4.1+, paired with the [Windows AppKit connector](https://git.kof22.com/QRun-IO/qqq-print-agent) (1.0.1 is published) and the [shared protocol](https://git.kof22.com/QRun-IO/qqq-print-protocol) (1.0.0 is published). The Windows connector opens an outbound, authenticated two-way WebSocket; documents download separately over HTTPS. The cloud needs no inbound route into the facility. Version **1.0.0** is prepared in this source: native printing **2.3**, wire payload v1, no job/control polling fallback, and the same server code as 0.4.0-rc.1. It is not yet published, and it has not yet been built or tested against the QQQ core that provides native browser sign-in. Upgrade the server before the matching Windows connector. -**Prerelease software**, tested against QQQ **4.1.0-RC.20** and Java 21. Current release candidate: [**0.3.0-rc.1**](https://github.com/QRun-IO/qbit-printing/releases/tag/v0.3.0-rc.1). The previous [**0.2.0-rc.1**](https://github.com/QRun-IO/qbit-printing/releases/tag/v0.2.0-rc.1) tagged build passed 110 tests and zero Checkstyle violations. The optional native UI demo uses QQQ frontend **1.0.0-RC.37**. GitHub releases provide a library JAR, POM and SHA-256 checksums, with build attestations for all three assets. Verify the exact downloaded release; publication does not establish installed or physical-output acceptance. This repository does not claim Maven Central publication or provide a standalone executable/fat JAR. +**Current dependency:** QQQ **4.1.0-RC.20** (unchanged until a published QQQ 4.1 candidate with native session login is adopted) and Java 21. Latest published release candidate: [**0.4.0-rc.1**](https://git.kof22.com/QRun-IO/qbit-printing/releases/tag/v0.4.0-rc.1). The previous [**0.2.0-rc.1**](https://github.com/QRun-IO/qbit-printing/releases/tag/v0.2.0-rc.1) tagged build passed 110 tests and zero Checkstyle violations. The optional native UI demo uses QQQ frontend **1.0.0-RC.37**. GitHub releases provide a library JAR, POM and SHA-256 checksums, with build attestations for all three assets. Verify the exact downloaded release; publication does not establish installed or physical-output acceptance. This repository does not claim Maven Central publication or provide a standalone executable/fat JAR. Implemented: single-use enrollment, device credentials, inventory/approval, PDF/ZPL submission, durable JDBC queue, idempotency, claim/content/events, native QQQ setup/test-print processes, read-only device/printer/job tables and a durable enqueue effect target. diff --git a/docs/SESSION-STATE.md b/docs/SESSION-STATE.md index 8aa82c8..5f7ddf8 100644 --- a/docs/SESSION-STATE.md +++ b/docs/SESSION-STATE.md @@ -1,5 +1,15 @@ # Session state — 2026-10-31 +## CURRENT checkpoint — 1.0.0 release preparation (2026-11-03) + +The tree is at the primary head `a583f91` (plus the identical `.gitea/workflows/qrun-release.yaml` caller) with the +prepared 1.0.0 version (`pom.xml`, README, CHANGELOG). Windows connector 1.0.1 and protocol 1.0.0 are published. +The QQQ pin stays `4.1.0-RC.20` until root supplies the published QQQ 4.1 candidate that provides native session +login; the core's native-auth and PostgreSQL changes are merged on the core side and the shared publisher owns the core +publication. Remaining: adopt that one coordinate, run the existing normal verification, then the existing normal +tag publication. Nothing here is published or verified against the new core yet. Every checklist below is +historical. + ## Standards and small-label release cohort — 2026-11-01 The strict standards tree (commit `43253f6`) combines the 2.3.0 operator/media/retained source with the diff --git a/docs/TODO.md b/docs/TODO.md index 9d675de..5458c3b 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -1,5 +1,10 @@ # Follow-up +## CURRENT — 1.0.0 (everything below this section is historical) + +- [ ] Adopt the published QQQ 4.1 candidate coordinate supplied by root (`pom.xml` `qqq.version`, plus the active text that names it; see CHANGELOG/README). +- [ ] Run the existing normal verification (`./mvnw -Pui-demo verify`), then the existing normal tag publication of `1.0.0`. Not yet done; not yet verified against the new core. + ## Echo integration candidate - [x] Implement authorized operator catalog, native submission/process permission, diff --git a/pom.xml b/pom.xml index 9cfff30..cf673f2 100644 --- a/pom.xml +++ b/pom.xml @@ -9,7 +9,7 @@ com.kingsrookqbit-build-parent2.0.0 com.kingsrook.qbits qbit-printing - 0.4.0-rc.1 + 1.0.0 QQQ Printing Apache License, Version 2.0https://www.apache.org/licenses/LICENSE-2.0 -- 2.54.0 From 48e6cdb9df9fe96c66b86b191137de0c1cfafd3f Mon Sep 17 00:00:00 2001 From: James Maes Date: Tue, 3 Nov 2026 15:04:49 -0600 Subject: [PATCH 2/3] release: adopt published QQQ RC.21 for printing 1.0 Co-Authored-By: Codex --- CHANGELOG.md | 7 ++++--- README.md | 4 ++-- docs/SESSION-STATE.md | 14 +++++++------- docs/TODO.md | 5 +++-- pom.xml | 2 +- 5 files changed, 17 insertions(+), 15 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3a86c94..d527edf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,9 +7,10 @@ processes, PDF rendering with headers and footers, the least-privilege operator reported Windows queue-default media (`printer-media-v1`) and the opt-in retained-source facade. Native printing stays **2.3.0** with wire payload v1; 1.0 is a product version, not a wire change, and it pairs with Windows connector 1.0.1 and protocol 1.0.0. The QQQ dependency -is still 4.1.0-RC.20; it will move to a published QQQ 4.1 candidate that provides native -session login before this release is built and published. Until then 1.0.0 is not published -and has not been verified against that core. +is the published 4.1.0-RC.21 candidate, which provides native session login. Local +`-Pui-demo verify` passed against that dependency: 193 tests reported, zero failures or +errors, one existing opt-in workload skip and zero Checkstyle violations. The printing +1.0.0 release remains pending its normal CI and publication. ## 0.4.0-rc.1 diff --git a/README.md b/README.md index f6ca52c..e0cb694 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ # QQQ Printing -Cloud printing for QQQ 4.1+, paired with the [Windows AppKit connector](https://git.kof22.com/QRun-IO/qqq-print-agent) (1.0.1 is published) and the [shared protocol](https://git.kof22.com/QRun-IO/qqq-print-protocol) (1.0.0 is published). The Windows connector opens an outbound, authenticated two-way WebSocket; documents download separately over HTTPS. The cloud needs no inbound route into the facility. Version **1.0.0** is prepared in this source: native printing **2.3**, wire payload v1, no job/control polling fallback, and the same server code as 0.4.0-rc.1. It is not yet published, and it has not yet been built or tested against the QQQ core that provides native browser sign-in. Upgrade the server before the matching Windows connector. +Cloud printing for QQQ 4.1+, paired with the [Windows AppKit connector](https://git.kof22.com/QRun-IO/qqq-print-agent) (1.0.1 is published) and the [shared protocol](https://git.kof22.com/QRun-IO/qqq-print-protocol) (1.0.0 is published). The Windows connector opens an outbound, authenticated two-way WebSocket; documents download separately over HTTPS. The cloud needs no inbound route into the facility. Version **1.0.0** is prepared in this source: native printing **2.3**, wire payload v1, no job/control polling fallback, and the same server code as 0.4.0-rc.1 with the published QQQ core that provides native browser sign-in. It is not yet published. Upgrade the server before the matching Windows connector. -**Current dependency:** QQQ **4.1.0-RC.20** (unchanged until a published QQQ 4.1 candidate with native session login is adopted) and Java 21. Latest published release candidate: [**0.4.0-rc.1**](https://git.kof22.com/QRun-IO/qbit-printing/releases/tag/v0.4.0-rc.1). The previous [**0.2.0-rc.1**](https://github.com/QRun-IO/qbit-printing/releases/tag/v0.2.0-rc.1) tagged build passed 110 tests and zero Checkstyle violations. The optional native UI demo uses QQQ frontend **1.0.0-RC.37**. GitHub releases provide a library JAR, POM and SHA-256 checksums, with build attestations for all three assets. Verify the exact downloaded release; publication does not establish installed or physical-output acceptance. This repository does not claim Maven Central publication or provide a standalone executable/fat JAR. +**Current dependency:** QQQ **4.1.0-RC.21**, published on Maven Central with native session login, and Java 21. Latest published release candidate: [**0.4.0-rc.1**](https://git.kof22.com/QRun-IO/qbit-printing/releases/tag/v0.4.0-rc.1). The previous [**0.2.0-rc.1**](https://github.com/QRun-IO/qbit-printing/releases/tag/v0.2.0-rc.1) tagged build passed 110 tests and zero Checkstyle violations. The optional native UI demo uses QQQ frontend **1.0.0-RC.37**. GitHub releases provide a library JAR, POM and SHA-256 checksums, with build attestations for all three assets. Verify the exact downloaded release; publication does not establish installed or physical-output acceptance. This repository does not claim Maven Central publication or provide a standalone executable/fat JAR. Implemented: single-use enrollment, device credentials, inventory/approval, PDF/ZPL submission, durable JDBC queue, idempotency, claim/content/events, native QQQ setup/test-print processes, read-only device/printer/job tables and a durable enqueue effect target. diff --git a/docs/SESSION-STATE.md b/docs/SESSION-STATE.md index 5f7ddf8..03ee8a9 100644 --- a/docs/SESSION-STATE.md +++ b/docs/SESSION-STATE.md @@ -2,13 +2,13 @@ ## CURRENT checkpoint — 1.0.0 release preparation (2026-11-03) -The tree is at the primary head `a583f91` (plus the identical `.gitea/workflows/qrun-release.yaml` caller) with the -prepared 1.0.0 version (`pom.xml`, README, CHANGELOG). Windows connector 1.0.1 and protocol 1.0.0 are published. -The QQQ pin stays `4.1.0-RC.20` until root supplies the published QQQ 4.1 candidate that provides native session -login; the core's native-auth and PostgreSQL changes are merged on the core side and the shared publisher owns the core -publication. Remaining: adopt that one coordinate, run the existing normal verification, then the existing normal -tag publication. Nothing here is published or verified against the new core yet. Every checklist below is -historical. +The release branch includes the primary head `a583f91` and the prepared 1.0.0 version. Windows connector 1.0.1 +and protocol 1.0.0 are published. The QQQ pin is now the published `4.1.0-RC.21` candidate that provides native +session login; its BOM was independently retrieved from Maven Central. The existing `-Pui-demo verify` gate +passed against that dependency on 2026-11-03: 193 tests reported, zero failures or errors, one existing opt-in +workload skip and zero Checkstyle violations. Main and test sources compile under the existing Error Prone, +NullAway and warnings-as-errors checks. Printing 1.0.0 publication remains pending its normal CI and release +process. Every checklist below is historical. ## Standards and small-label release cohort — 2026-11-01 diff --git a/docs/TODO.md b/docs/TODO.md index 5458c3b..c554d9f 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -2,8 +2,9 @@ ## CURRENT — 1.0.0 (everything below this section is historical) -- [ ] Adopt the published QQQ 4.1 candidate coordinate supplied by root (`pom.xml` `qqq.version`, plus the active text that names it; see CHANGELOG/README). -- [ ] Run the existing normal verification (`./mvnw -Pui-demo verify`), then the existing normal tag publication of `1.0.0`. Not yet done; not yet verified against the new core. +- [x] Adopt the published QQQ `4.1.0-RC.21` candidate in `pom.xml` and the active release documentation; the BOM resolves from Maven Central. +- [x] Complete the existing normal verification (`./mvnw -Pui-demo verify`) against RC.21: 193 tests reported, zero failures/errors, one existing opt-in workload skip and zero Checkstyle violations. +- [ ] Complete the existing normal publication of `1.0.0` after its required CI checks. ## Echo integration candidate diff --git a/pom.xml b/pom.xml index cf673f2..6a8cf14 100644 --- a/pom.xml +++ b/pom.xml @@ -15,7 +15,7 @@ 21 UTF-8 - 4.1.0-RC.20 + 4.1.0-RC.21 none -- 2.54.0 From fbec343cb2568fcfed5f78404e3dcb5c56ca10fd Mon Sep 17 00:00:00 2001 From: James Maes Date: Tue, 3 Nov 2026 15:06:40 -0600 Subject: [PATCH 3/3] docs: finalize printing 1.0 release wording Co-Authored-By: Codex --- CHANGELOG.md | 11 ++++------- README.md | 4 ++-- 2 files changed, 6 insertions(+), 9 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d527edf..a27ba1d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,16 +1,13 @@ # Changelog -## 1.0.0 — prepared; not yet published +## 1.0.0 -Product version 1.0.0 for the same code as 0.4.0-rc.1: record, table-list and text print -processes, PDF rendering with headers and footers, the least-privilege operator catalog, +Product version 1.0.0 includes record, table-list and text print processes, +PDF rendering with headers and footers, the least-privilege operator catalog, reported Windows queue-default media (`printer-media-v1`) and the opt-in retained-source facade. Native printing stays **2.3.0** with wire payload v1; 1.0 is a product version, not a wire change, and it pairs with Windows connector 1.0.1 and protocol 1.0.0. The QQQ dependency -is the published 4.1.0-RC.21 candidate, which provides native session login. Local -`-Pui-demo verify` passed against that dependency: 193 tests reported, zero failures or -errors, one existing opt-in workload skip and zero Checkstyle violations. The printing -1.0.0 release remains pending its normal CI and publication. +is the published 4.1.0-RC.21 candidate, which provides native session login. ## 0.4.0-rc.1 diff --git a/README.md b/README.md index e0cb694..3e5630c 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ # QQQ Printing -Cloud printing for QQQ 4.1+, paired with the [Windows AppKit connector](https://git.kof22.com/QRun-IO/qqq-print-agent) (1.0.1 is published) and the [shared protocol](https://git.kof22.com/QRun-IO/qqq-print-protocol) (1.0.0 is published). The Windows connector opens an outbound, authenticated two-way WebSocket; documents download separately over HTTPS. The cloud needs no inbound route into the facility. Version **1.0.0** is prepared in this source: native printing **2.3**, wire payload v1, no job/control polling fallback, and the same server code as 0.4.0-rc.1 with the published QQQ core that provides native browser sign-in. It is not yet published. Upgrade the server before the matching Windows connector. +Cloud printing for QQQ 4.1+, paired with the [Windows AppKit connector](https://git.kof22.com/QRun-IO/qqq-print-agent) 1.0.1 and the [shared protocol](https://git.kof22.com/QRun-IO/qqq-print-protocol) 1.0.0. The Windows connector opens an outbound, authenticated two-way WebSocket; documents download separately over HTTPS. The cloud needs no inbound route into the facility. Version **1.0.0** supports native printing **2.3**, wire payload v1, real-time jobs and controls, and native browser sign-in through QQQ. Upgrade the server before the matching Windows connector. -**Current dependency:** QQQ **4.1.0-RC.21**, published on Maven Central with native session login, and Java 21. Latest published release candidate: [**0.4.0-rc.1**](https://git.kof22.com/QRun-IO/qbit-printing/releases/tag/v0.4.0-rc.1). The previous [**0.2.0-rc.1**](https://github.com/QRun-IO/qbit-printing/releases/tag/v0.2.0-rc.1) tagged build passed 110 tests and zero Checkstyle violations. The optional native UI demo uses QQQ frontend **1.0.0-RC.37**. GitHub releases provide a library JAR, POM and SHA-256 checksums, with build attestations for all three assets. Verify the exact downloaded release; publication does not establish installed or physical-output acceptance. This repository does not claim Maven Central publication or provide a standalone executable/fat JAR. +**Current dependency:** QQQ **4.1.0-RC.21**, published on Maven Central with native session login, and Java 21. See the [printing releases](https://git.kof22.com/QRun-IO/qbit-printing/releases) for downloads. The optional native UI demo uses QQQ frontend **1.0.0-RC.37**. GitHub releases provide a library JAR, POM and SHA-256 checksums, with build attestations for all three assets. Verify the exact downloaded release; publication does not establish installed or physical-output acceptance. This repository does not claim Maven Central publication or provide a standalone executable/fat JAR. Implemented: single-use enrollment, device credentials, inventory/approval, PDF/ZPL submission, durable JDBC queue, idempotency, claim/content/events, native QQQ setup/test-print processes, read-only device/printer/job tables and a durable enqueue effect target. -- 2.54.0