Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
  james.maesandCodex
|
caa01ba2cf
|
||
|
james.maes
|
e73b71e6ec
|
No files matched your search
@@ -6,13 +6,13 @@ Tools is an application Qbit, with no database, background jobs or credential st
|
||||
|
||||
## Install in a host
|
||||
|
||||
Requires Java 21, QQQ `4.1.0-RC.21`, and a Next frontend containing the `QQQ_TOOLS` renderer. The compatible frontend change is [Next PR 204](https://git.kof22.com/QRun-IO/qqq-frontend-next/pulls/204). Release preparation and publication status are tracked in [RELEASING.md](docs/RELEASING.md); older Next and Material builds do not support this widget.
|
||||
Requires Java 21, QQQ `4.1.0-RC.21`, and a Next frontend containing the `QQQ_TOOLS` renderer. The compatible frontend change is [Next PR 204](https://git.kof22.com/QRun-IO/qqq-frontend-next/pulls/204). Version [0.1.0 is published](https://git.kof22.com/QRun-IO/qbit-tools/releases/tag/v0.1.0) on Maven Central; the compatible frontend release is still pending. See [RELEASING.md](docs/RELEASING.md). Older Next and Material builds do not support this widget.
|
||||
|
||||
```xml
|
||||
<dependency>
|
||||
<groupId>com.kingsrook.qbits</groupId>
|
||||
<artifactId>qbit-tools</artifactId>
|
||||
<version>0.1.0-SNAPSHOT</version>
|
||||
<version>0.1.0</version>
|
||||
</dependency>
|
||||
```
|
||||
|
||||
|
||||
+1
-1
@@ -5,7 +5,7 @@ Use the shared QRun release pipeline, delegated through `.gitea/workflows/qrun-r
|
||||
- `develop` builds snapshots; `release/*` builds release candidates; stable `vX.Y.Z` tags publish stable artifacts.
|
||||
- The shared pipeline computes the effective Maven revision, tests it, retains the JAR/source/Javadoc/POM, and passes the verified artifacts to the trusted publisher.
|
||||
- Confirm CI and publication before announcing an artifact. Check Maven Central from a clean consumer and record the matching Next frontend release that supports `QQQ_TOOLS`.
|
||||
- First release target: `com.kingsrook.qbits:qbit-tools:0.1.0`. This target is not a publication receipt.
|
||||
- First release: `com.kingsrook.qbits:qbit-tools:0.1.0`, published by [successful run4352](https://git.kof22.com/QRun-IO/qbit-tools/actions/runs/4352). Clean consumer resolution including dependencies passed. [Release notes](https://git.kof22.com/QRun-IO/qbit-tools/releases/tag/v0.1.0).
|
||||
- Requires Java 21 and QQQ 4.1.0-RC.21. The compatible Next implementation is tracked in https://git.kof22.com/QRun-IO/qqq-frontend-next/pulls/204; do not claim older released frontends support it.
|
||||
- No database migration or background service is installed. Roll back by removing the Tools producer/dependency or returning to the previous frontend; existing companion clients and device records are unaffected.
|
||||
- Bundled scripts pin Print Client 1.0.1 and signed scanner preview 1.0.0. They have syntax and UI copy checks, but real OS/device installation qualification remains outstanding. Scanner preview is explicitly labeled and requires forge login.
|
||||
@@ -1,15 +1,15 @@
|
||||
# Session state
|
||||
|
||||
2026-11-04: Implemented local `qbit-tools` and matching `qqq-frontend-next` widget/account-menu integration. User authorized choosing the UX and implementing it. No commit, push, publication or deployment authorization.
|
||||
User authorized commit, push and release on 2026-11-04. Public repository: https://git.kof22.com/QRun-IO/qbit-tools (id180). Main e73b71e6ecde4cfe1f18f2f95bd00cbfcc70e163 carries signed v0.1.0. Version0.1.0 is published on Maven Central and https://git.kof22.com/QRun-IO/qbit-tools/releases/tag/v0.1.0.
|
||||
|
||||
Plan: use standard QQQ app/widget registration; keep tool catalog and availability on the server; render responsive setup/download cards in Next; verify backend serialization and real browser navigation; document host adoption.
|
||||
Release4352 completed successfully at2026-11-05T01:59UTC. A clean Maven consumer resolved com.kingsrook.qbits:qbit-tools:0.1.0 with all transitive dependencies. Public POM, JAR, sources, Javadoc and signatures are available. The automatic Gitea release record has installation/compatibility notes. Prior snapshot4292/4320 timed out and do not prove snapshot publication.
|
||||
|
||||
Decisions: Tools is a navigation app with an account-menu shortcut; supported tools first; other services collapsed; scanner distribution is administrator-configurable; instance URL and CLI commands are copyable; reuse existing enrollment and device-management flows. No new credential mechanism or device-management subsystem.
|
||||
Enrollment: ci-policy PR30 and cluster-gitops PR258 merged with checks passing. Argo synced. Repository was explicitly made public; existing QRun-IO publisher-source team8 now has read access to this repository (code/Actions only). Configured tea login uses SSH authentication; native commands work, generic tea api omits SSH auth. Task-cache helper reused tea Login.Client SDK for the exact team grant.
|
||||
|
||||
Validation complete: Maven verify (4 tests, real instance validation/rendering, serialization and Checkstyle), frontend production build/typecheck, targeted lint, license headers, 42 widget/tools unit tests and 2 production-browser tests passed. Browser acceptance covers 1440px/390px, account navigation, actual backend payload, setup, permission-hidden links, no horizontal overflow, and axe accessibility. Full frontend lint has 0 errors and 6 pre-existing warnings in untouched files. Screenshots are in the sibling frontend test-results/tools-* directories. Production verification used the existing installed Next 16.3.8 dependencies; package.json requests 16.4.1, so release CI should perform a clean locked install. This directory is a new local project, not yet a published artifact or provisioned forge repository.
|
||||
Frontend: https://git.kof22.com/QRun-IO/qqq-frontend-next/pulls/204, latest d71c6012. Full CI4353 queued. CI4326 passed3659 unit tests but two RecordQuery tests timed out (all17 in file pass locally). Browser287 passed/34 skipped; three keyboard tests navigated away due setup's page-center click. Fixed setup to blur focus; all19 keyboard tests pass. Both Tools browser tests passed in CI. The shared publisher explicitly holds frontend-next; a compatible released frontend is still required.
|
||||
|
||||
Preview launched at http://127.0.0.1:3199/app/qqqTools and opened in the default browser. Loopback proxy on3199 serves sample metadata/catalog; production Next server on3198. Background launcher: C:/Users/james/.cache/qqq-tools-preview/server.mjs (PID108288). This is a UX preview, not a live backend/device environment. HTTP page and catalog verified200.
|
||||
Validation: Maven verify8 tests including guardrails and Checkstyle; frontend50 targeted widget/contract tests, production build/typecheck, lint and two browser/axe checks passed. Installer scripts parsed only; no hardware installation qualification.
|
||||
|
||||
2026-11-04 UX revision: user rejected the tall card layout and requested in-app install commands. Replaced it with a compact three-tool chooser and shared setup panel; moved server address into the connection section. Added platform/method selectors for Scoop, Homebrew and curl, plus honest MSI/managed Android guidance. Backend verify4/Checkstyle, frontend production build/typecheck/lint,42unit tests and2desktop/mobile browser/axe tests passed. Same preview URL restarted after rebuilding; launch PID is in the latest tool receipt. No installs executed or releases published.
|
||||
Design: Tools navigation app and account shortcut; compact chooser, platform/method selection, complete copyable installer scripts and connection guidance; existing enrollment and permissions. Print1.0.1 and signed scanner preview1.0.0 pinned; forge login required for scanner APK.
|
||||
|
||||
2026-11-04 direct installer revision: bundled complete PowerShell Print Client 1.0.1 installer with checksum/publisher verification and setup launch. Added signed scanner preview 1.0.0 USB scripts for Windows/macOS/Linux, pinned APK checksum, authenticated browser download step, and direct handheld installation instructions. Multiline commands preserve newlines and provide Copy install script. Fixed narrow-screen instruction clipping after screenshot review. Maven verify4/Checkstyle, frontend build/typecheck, targeted lint,43 unit tests,2 desktop/mobile browser and axe checks passed; PowerShell parser and bash -n passed. No installers executed on hardware. Preview restarted at http://127.0.0.1:3199/app/qqqTools (launcher PID75024). Scripts pin reviewed releases and must be maintained when versions change.
|
||||
Preview remains http://127.0.0.1:3199/app/qqqTools using sample metadata.
|
||||
+5
-6
@@ -1,7 +1,6 @@
|
||||
# Remaining release work
|
||||
# Release work
|
||||
|
||||
- Provision the new repository and enroll it in the existing CI/release process when authorized.
|
||||
- Publish the Qbit and compatible Next frontend through their normal protected release flows.
|
||||
- Adopt the dependency and producer in the intended host application(s), using their public server URL and approved scanner distribution URL.
|
||||
- Verify the deployed host's download access and real enrollment handoffs after adoption. No device enrollment or print was performed during local development.
|
||||
- Validate bundled installers on clean supported OS/device combinations before release; local validation covers syntax, copy fidelity and UI only. Maintain pinned Print Client and scanner versions/checksums with future releases.
|
||||
- Completed:0.1.0 published via successful release4352; clean Maven consumer resolved the artifact and dependencies.
|
||||
- Complete Next PR204 and publish a compatible frontend; document its exact minimum version.
|
||||
- Adopt the dependency and producer in host apps using their public HTTPS address.
|
||||
- Validate bundled installers on clean supported OS/device combinations. Maintain reviewed versions/checksums with future releases.
|
||||
@@ -27,7 +27,7 @@
|
||||
</license>
|
||||
</licenses>
|
||||
<properties>
|
||||
<revision>0.1.0-SNAPSHOT</revision>
|
||||
<revision>0.1.0</revision>
|
||||
<qbit.guardrails.enforce>true</qbit.guardrails.enforce>
|
||||
<maven.compiler.release>21</maven.compiler.release>
|
||||
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
||||
|
||||
Reference in new issue
Block a user