feat(firestore)!: add collection group queries

[fwal]

Adds collection group queries across the stack.

• FirestoreService.queryGroup / streamQueryGroup (admin, client, mock, noopLayer, MockFirestoreService).
• Every repository gets a group view with the same four query methods, run over the collection group named by the last segment of collectionPath.
• New makeRepository option pathField (string fields only) fills a model field with each document's full path on read.
• validateCollectionId / collectionIdOf exported from core and shared by all backends; malformed IDs fail with a typed FirestoreError on both effect and stream.
• Mock: state for a group resolves by collection ID.
• Docs: core AGENTS/README/MIGRATION, mock README, root README.

Breaking: FirestoreServiceShape has two new required members. Hand-written layers must implement them; see MIGRATION.md step 8.

Verified: nx run-many -t build test lint green for all 8 projects. effect-firebase:typecheck fails identically on main (pre-existing tsconfig.spec.json issue).

🤖 Generated with Claude Code

https://claude.ai/code/session_01Xo119tdUdoz5hd3eZ6QuzP

---

Generated by Claude Code

[greptile-apps]

Confidence Score: 5/5

The PR appears safe to merge; the latest cursor-arity fix resolves the remaining previous finding without introducing a new actionable defect.

Summary

The PR adds collection-group querying throughout the Firestore abstraction and repository API.

• Adds effect and streaming collection-group queries to the Admin, Client, Mock, noop, and custom-service surfaces.
• Adds repository group query methods and optional full-document-path decoding through pathField.
• Centralizes collection-ID validation and expands collection-group cursor behavior in the mock.
• Documents the new API and its breaking custom-layer requirements.
• The latest revision correctly fixes explicit document-name cursor arity in the mock.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  R[Repository group view] --> S[FirestoreService queryGroup / streamQueryGroup]
  S --> A[Admin collectionGroup]
  S --> C[Client collectionGroup]
  S --> M[Mock collection-group selector]
  M --> V[Collection ID and cursor validation]
  A --> D[Snapshots with full paths]
  C --> D
  M --> D
  D --> P[Model decoding with optional pathField]

Loading

_{Reviews (5) · Last reviewed commit: "fix(mock): count an explicit __name__ or..."}