test: add cloud integration tests for Search API RRF and GroupBy (#483)

* docs(17): capture phase context

* docs(state): record phase 17 context session

* docs(17): research phase domain

* docs(phase-17): add validation strategy

* docs(17): create phase plan

* fix(17): revise plan based on checker feedback

* test(17-01): add TestCloudClientSearchRRF with dense+sparse smoke and weighted subtests

- RRF smoke test verifies dense+sparse KNN fusion returns quantum docs first
- Weight/k test verifies different configurations produce different score slices

* test(17-01): add TestCloudClientSearchGroupBy with MinK and MaxK subtests

- MinK test verifies per-group cap of 2 using sr.RowGroups() iteration
- MaxK test verifies per-group cap of 2 with numeric priority metadata

* docs(17-01): complete cloud RRF and GroupBy test coverage plan

- SUMMARY.md with self-check passed
- STATE.md updated with phase 17 plan 01 completion
- ROADMAP.md updated with phase 17 progress

* test(17): persist human verification items as UAT

* docs(phase-17): complete phase execution

* docs(phase-17): evolve PROJECT.md after phase completion

* test(17): complete UAT - 2 passed, 0 issues

* test(17): add edge case and validation subtests for RRF and GroupBy

RRF: single rank, zero weight isolation, rejects negative/NaN/zero-k/no-ranks
GroupBy: k=1 per-group cap, rejects zero-k/nil-aggregate/no-keys

* test: tighten cloud RRF and GroupBy assertions

* docs(17): ship phase 17 — PR #483

Author: tazarov

.planning/PROJECT.md

@@ -71,4 +71,4 @@ Go applications can use Chroma and embedding providers through a stable, portabl
 | Pivot Phase 7 from vLLM/Nemotron to VoyageAI | vLLM lacks NVOmniEmbedModel support; VoyageAI multimodal validates portability with text/image/video | ✓ Good |
 
 ---
-*Last updated: 2026-03-30 — Phase 15 (openrouter-embeddings-compatibility) complete: standalone OpenRouter embedding provider with ProviderPreferences, encoding_format, input_type fields; OpenAI WithModelString for proxy endpoints; full test coverage.*
+*Last updated: 2026-04-02 — Phase 17 (cloud-rrf-and-groupby-test-coverage) complete: cloud integration tests for Search API RRF (dense+sparse fusion with behavioral assertions) and GroupBy (MinK/MaxK per-group capping via RowGroups); phases 16 (Twelve Labs EF) and 17 completed since last update.*

.planning/ROADMAP.md

@@ -30,7 +30,7 @@ This roadmap initializes GSD planning for the current brownfield milestone focus
 - [x] **Phase 14: Delete with Limit** - Add delete-with-limit support for upstream limit parameter. (issue #439) [1/2 plans complete] (completed 2026-03-29)
 - [x] **Phase 15: OpenRouter Embeddings Compatibility** - Add first-class OpenRouter support via provider preferences and encoding_format. (issue #438) (completed 2026-03-30)
 - [x] **Phase 16: Twelve Labs Embedding Function** - Add Twelve Labs multimodal embedding provider. (issue #190) (completed 2026-04-01)
-- [ ] **Phase 17: Cloud RRF and GroupBy Test Coverage** - Add cloud integration tests for Search API RRF and GroupBy primitives. (issue #462)
+- [x] **Phase 17: Cloud RRF and GroupBy Test Coverage** - Add cloud integration tests for Search API RRF and GroupBy primitives. (issue #462) (completed 2026-04-02)
 - [ ] **Phase 18: Embedded Client contentEmbeddingFunction Parity** - Add contentEmbeddingFunction support to embeddedCollection for feature parity with HTTP client. (issue #472)
 
 ## Phase Details
@@ -181,7 +181,7 @@ Plans:
 | 14. Delete with Limit | 2/2 | Complete    | 2026-03-29 |
 | 15. OpenRouter Embeddings | 2/2 | Complete    | 2026-03-30 |
 | 16. Twelve Labs EF | 2/2 | Complete    | 2026-04-01 |
-| 17. Cloud RRF/GroupBy Tests | 0/0 | Not started | - |
+| 17. Cloud RRF/GroupBy Tests | 1/1 | Complete    | 2026-04-02 |
 | 18. Embedded contentEF Parity | 0/0 | Not started | - |
 
 ### Phase 9: Convenience Constructors and Documentation Polish
@@ -318,10 +318,10 @@ Plans:
   2. RRF weighted/custom-k test proves request acceptance and ordering changes.
   3. GroupBy MinK/MaxK tests assert per-group caps and flattened limits.
   4. All tests tagged `cloud` and use existing cloud test infrastructure.
-**Plans:** 0 plans
+**Plans:** 1/1 plans complete
 
 Plans:
-- [ ] TBD (run /gsd:plan-phase 17 to break down)
+- [x] TBD (run /gsd:plan-phase 17 to break down) (completed 2026-04-02)
 
 ### Phase 18: Embedded Client contentEmbeddingFunction Parity
 **Goal:** Add contentEmbeddingFunction support to embeddedCollection so the embedded client has feature parity with the HTTP client for content embedding lifecycle, auto-wiring, and Fork/Close handling.

.planning/STATE.md

@@ -2,14 +2,14 @@
 gsd_state_version: 1.0
 milestone: v0.4.1
 milestone_name: Provider-Neutral Multimodal Foundations
-status: "Phase 16 shipped — PR #480"
-stopped_at: Completed 16-02-PLAN.md
-last_updated: "2026-04-01T12:36:00.417Z"
+status: "Phase 17 shipped — PR #483"
+stopped_at: Completed 17-01-PLAN.md
+last_updated: "2026-04-02T09:42:28.701Z"
 progress:
   total_phases: 18
-  completed_phases: 16
-  total_plans: 35
-  completed_plans: 35
+  completed_phases: 17
+  total_plans: 36
+  completed_plans: 36
 ---
 
 # Project State
@@ -23,7 +23,7 @@ See: .planning/PROJECT.md (updated 2026-03-18)
 
 ## Current Position
 
-Phase: 17
+Phase: 18
 Plan: Not started
 
 ## Performance Metrics
@@ -78,6 +78,7 @@ Plan: Not started
 | Phase 15 P02 | 2min | 2 tasks | 2 files |
 | Phase 16 P01 | 3min | 2 tasks | 3 files |
 | Phase 16 P02 | 3min | 2 tasks | 5 files |
+| Phase 17 P01 | 3min | 2 tasks | 1 files |
 
 ## Accumulated Context
 
@@ -137,6 +138,7 @@ Recent decisions affecting current work:
 - [Phase 16]: One API call per Content item - no batch support (SupportsBatch: false)
 - [Phase 16]: Remove unused resolveMIME/extToMIME dead code from content.go to pass lint
 - [Phase 16]: Use struct literal construction for hermetic tests matching Gemini/Voyage pattern
+- [Phase 17]: Follow existing cloud test patterns for RRF and GroupBy tests - no deviations required
 
 ### Roadmap Evolution
 
@@ -169,6 +171,6 @@ None.
 
 ## Session
 
-**Last Date:** 2026-04-01T09:15:21.355Z
-**Stopped At:** Completed 16-02-PLAN.md
+**Last Date:** 2026-04-02T07:38:41Z
+**Stopped At:** Completed 17-01-PLAN.md
 **Resume File:** None