Compare commits
1
Commits
develop
...
prep/0.1.0
| Author | SHA1 | Date | |
|---|---|---|---|
  james.maesandCodex
|
1c32cc8ab2
|
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 prepared for publication; confirm the release receipt before installation. 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,15 +1,13 @@
|
||||
# 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. Repository created at https://git.kof22.com/QRun-IO/qbit-tools (id180); initial implementation4408b36 pushed to develop and main. First stable target0.1.0 is being prepared; not yet published.
|
||||
|
||||
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.
|
||||
Frontend: commit978adad7, https://git.kof22.com/QRun-IO/qqq-frontend-next/pulls/204. Its standard Node/browser checks are running. Existing released Next artifacts do not yet contain QQQ_TOOLS.
|
||||
|
||||
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.
|
||||
CI enrollment: QRun-IO/ci-policy PR30 merged after both required workflows passed. Publisher enrollment: KofTwentyTwo/cluster-gitops PR258 squash-merged after all checks passed; Argo sync/publication readback pending.
|
||||
|
||||
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.
|
||||
Validation: Maven verify8 tests including standard Qbit architecture guardrails and Checkstyle; frontend43 unit tests, production build/typecheck, targeted lint and2 browser/axe checks passed. Shared release build4292 verify/secrets/gate passed, source-version job awaiting publication. Installer scripts parsed only; no real device installations tested.
|
||||
|
||||
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.
|
||||
Design: Tools navigation app and account shortcut; compact chooser, platform/method selection, complete copyable installer scripts and connection guidance; reuse native enrollment and permissions. Print1.0.1 and scanner signed preview1.0.0 pinned. Forge login required for scanner APK.
|
||||
|
||||
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.
|
||||
|
||||
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 (not real backend/hardware).
|
||||
+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.
|
||||
- Confirm publisher sync and clean consumer resolution for0.1.0 before announcing availability.
|
||||
- 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