QRun-IO/qbit-quick-search
3
0 Fork 0
Code Issues 2 Pull Requests 4 Actions Packages Projects Releases 14 Wiki Activity

Quick Search 1.0 on QQQ 4.1 #12

New Issue
Open
opened 2026-10-06 12:22:57 +00:00 by KofTwentyTwo · 3 comments
KofTwentyTwo commented 2026-10-06 12:22:57 +00:00 (Migrated from github.com)
Copy link
Copy source

Tracking issue for the 1.0 initiative. The PRD is docs/initiatives/quick-search-1.0.md; the audit it closes is docs/audits/2026-10-04/README.md (blockers B1 to B25).

Status

  • All 25 audit blockers implemented, reviewed and merged to develop (#10, #8).
  • 1.0.0-RC.1 published to Maven Central from release/1.0 (2026-10-05).
  • qqq-all and Voyage adopt 1.0.0-RC.2 and report back.
  • Pre-GA follow-ups from the PR #10 review: #13 to #17 fixed and closed by #22, #20, #18, #19 and #21.
  • 1.0.0-RC.2 published to Maven Central from release/1.0 (2026-10-06).
  • Stuck REBUILDING after a killed or overlapping full reindex (follow-up from the PR #20 review; no data loss, see docs/TODO.md).
  • Re-pin to qbit-build-parent 2.1.0 once it ships, and drop the default-active qqq-snapshot profile (ADR-0007).
  • Merge release/1.0 to main and tag v1.0.0 for GA.

RC artifacts are published without a git tag or GitHub release; the GitHub release is created at GA.

Tracking issue for the 1.0 initiative. The PRD is `docs/initiatives/quick-search-1.0.md`; the audit it closes is `docs/audits/2026-10-04/README.md` (blockers B1 to B25). ## Status - [x] All 25 audit blockers implemented, reviewed and merged to `develop` (#10, #8). - [x] `1.0.0-RC.1` published to Maven Central from `release/1.0` (2026-10-05). - [ ] qqq-all and Voyage adopt `1.0.0-RC.2` and report back. - [x] Pre-GA follow-ups from the PR #10 review: #13 to #17 fixed and closed by #22, #20, #18, #19 and #21. - [x] `1.0.0-RC.2` published to Maven Central from `release/1.0` (2026-10-06). - [ ] Stuck `REBUILDING` after a killed or overlapping full reindex (follow-up from the PR #20 review; no data loss, see `docs/TODO.md`). - [ ] Re-pin to `qbit-build-parent` 2.1.0 once it ships, and drop the default-active `qqq-snapshot` profile (ADR-0007). - [ ] Merge `release/1.0` to `main` and tag `v1.0.0` for GA. RC artifacts are published without a git tag or GitHub release; the GitHub release is created at GA.
KofTwentyTwo commented 2026-10-07 02:03:37 +00:00 (Migrated from github.com)
Copy link
Copy source

1.0.0-RC.2 is on Maven Central. It was published from release/1.0 (b7d366c, bump c11b2c2) with the jar, pom, sources, javadoc and signatures.

It fixes all five pre-GA findings from the PR #10 review:

  • #13 via #22: a failed listener re-read or a missing AWS SDK is now recorded as a failed event.
  • #14 via #20: deletes made during a full reindex are replayed after the alias swap.
  • #15 via #18: transport config hardening.
  • #16 via #19: search paging under record locks, with a bounded scan.
  • #17 via #21: count failures are now logged.

There are no schema changes. There are two new status values, REBUILDING and AWAITING_REINDEX. Hosts that sized quickSearchFailedEvent.status themselves need at least 16 characters.

Still open before GA:

  • qqq-all and Voyage pin RC.2 and report back.
  • Stuck REBUILDING after a killed full reindex (PR #20 review follow-up).
  • The qbit-build-parent 2.1.0 re-pin.

Docs: #23.

`1.0.0-RC.2` is on Maven Central. It was published from `release/1.0` (`b7d366c`, bump `c11b2c2`) with the jar, pom, sources, javadoc and signatures. It fixes all five pre-GA findings from the PR #10 review: - #13 via #22: a failed listener re-read or a missing AWS SDK is now recorded as a failed event. - #14 via #20: deletes made during a full reindex are replayed after the alias swap. - #15 via #18: transport config hardening. - #16 via #19: search paging under record locks, with a bounded scan. - #17 via #21: count failures are now logged. There are no schema changes. There are two new status values, `REBUILDING` and `AWAITING_REINDEX`. Hosts that sized `quickSearchFailedEvent.status` themselves need at least 16 characters. Still open before GA: - qqq-all and Voyage pin RC.2 and report back. - Stuck `REBUILDING` after a killed full reindex (PR #20 review follow-up). - The `qbit-build-parent` 2.1.0 re-pin. Docs: #23.
KofTwentyTwo commented 2026-10-09 23:21:29 +00:00 (Migrated from github.com)
Copy link
Copy source

qqq-all adoption of RC.2 (QRun-IO/qqq-all#29, PR QRun-IO/qqq-all#30): clean, with no quick-search defects. RC.2 runs on qqq 4.1.0-SNAPSHOT with no version conflicts.

  • In the full Compose smoke, the index built behind the alias, and basepull on demoScheduler indexed 2 customers with 0 errors, both locally and in CI.
  • Expected 1.0 changes that bit:
    • The FAIL_FAST default fails metadata-only builds without OpenSearch. The error names the DEGRADED fix.
    • A leftover manual addQBit throws IllegalArgumentException.
  • Docs gaps, fixed in #26: permission names, a schema section, the withAllowPlaintextCredentials method name, and the README still saying RC.1.
  • The qqq-all "full" smoke fails at OIDC login. That is a qqq snapshot regression that also fails on unchanged qqq-all develop, not quick-search.

Also in progress toward GA: #24 (stuck REBUILDING recovery, PR #25), and Voyage's move to qqq 4.1 with RC.2 (QRun-IO/Voyage#111).

qqq-all adoption of RC.2 (QRun-IO/qqq-all#29, PR QRun-IO/qqq-all#30): clean, with no quick-search defects. RC.2 runs on qqq 4.1.0-SNAPSHOT with no version conflicts. - In the full Compose smoke, the index built behind the alias, and basepull on `demoScheduler` indexed 2 customers with 0 errors, both locally and in CI. - Expected 1.0 changes that bit: - The `FAIL_FAST` default fails metadata-only builds without OpenSearch. The error names the `DEGRADED` fix. - A leftover manual `addQBit` throws `IllegalArgumentException`. - Docs gaps, fixed in #26: permission names, a schema section, the `withAllowPlaintextCredentials` method name, and the README still saying RC.1. - The qqq-all "full" smoke fails at OIDC login. That is a qqq snapshot regression that also fails on unchanged qqq-all develop, not quick-search. Also in progress toward GA: #24 (stuck `REBUILDING` recovery, PR #25), and Voyage's move to qqq 4.1 with RC.2 (QRun-IO/Voyage#111).
KofTwentyTwo commented 2026-10-10 00:12:54 +00:00 (Migrated from github.com)
Copy link
Copy source

Voyage adoption of RC.2 (QRun-IO/Voyage#111, PR QRun-IO/Voyage#112, with Voyage moved from qqq 0.40 to 4.1.0-RC.1): mostly clean, but it found two quick-search defects that need fixing before GA.

  • Ran against Postgres 17 and OpenSearch 2.19.6:
    • FAIL_FAST started the scheduler and basepull, and writes were indexed after commit.
    • With no cluster, FAIL_FAST stopped with a clear error, and DEGRADED booted and recorded the failed event.
  • Defects:
    • #28: a real-time INSERT indexes raw values instead of display values and PVS labels. Basepull corrects it later.
    • #29: a reconcile cron without a timezone passes validation but fails at startup.
  • Docs gaps (#29): schedules need QApplicationLauncher, and a reconcile cron needs Quartz. Also confirmed the four #26 gaps (PR #27).
  • Expected 1.0 changes:
    • field validation caught a nonexistent field in Voyage's config
    • the FAIL_FAST default
    • credentials over http are refused

GA now waits on: #25 (#24), #27 (#26), #28, #29, the qbit-build-parent 2.1.0 re-pin, and qqq 4.1 GA.

Voyage adoption of RC.2 (QRun-IO/Voyage#111, PR QRun-IO/Voyage#112, with Voyage moved from qqq 0.40 to 4.1.0-RC.1): mostly clean, but it found two quick-search defects that need fixing before GA. - Ran against Postgres 17 and OpenSearch 2.19.6: - FAIL_FAST started the scheduler and basepull, and writes were indexed after commit. - With no cluster, FAIL_FAST stopped with a clear error, and DEGRADED booted and recorded the failed event. - Defects: - #28: a real-time INSERT indexes raw values instead of display values and PVS labels. Basepull corrects it later. - #29: a reconcile cron without a timezone passes validation but fails at startup. - Docs gaps (#29): schedules need `QApplicationLauncher`, and a reconcile cron needs Quartz. Also confirmed the four #26 gaps (PR #27). - Expected 1.0 changes: - field validation caught a nonexistent field in Voyage's config - the FAIL_FAST default - credentials over http are refused GA now waits on: #25 (#24), #27 (#26), #28, #29, the `qbit-build-parent` 2.1.0 re-pin, and qqq 4.1 GA.
Sign in to join this conversation.
No Branch/Tag Specified
Labels
Clear labels
architecture
Architecture review: coupling, cohesion, UI API
 bug
Something isn't working
 dependencies
documentation
Improvements or additions to documentation
 duplicate
This issue or pull request already exists
 enhancement
New feature or request
 github_actions
Pull requests that update GitHub Actions code
 good first issue
Good for newcomers
 help wanted
Extra attention is needed
 invalid
This doesn't seem right
 java
Pull requests that update java code
 question
Further information is requested
 release:rc
Merging this develop PR cuts the next release candidate
 secuurity
wontfix
This will not be worked on
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
forge-recovery (Forge Recovery) james.maes (James Maes)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: QRun-IO/qbit-quick-search#12