TanStack · KyleAMathews · Sep 4, 2026 · Sep 4, 2026 · Sep 4, 2026 · Sep 4, 2026
diff --git a/.changeset/harden-load-subset-lifecycle.md b/.changeset/harden-load-subset-lifecycle.md
@@ -0,0 +1,14 @@
+---
+'@tanstack/db': patch
+'@tanstack/db-ivm': patch
+'@tanstack/db-sqlite-persistence-core': patch
+'@tanstack/electric-db-collection': patch
+'@tanstack/powersync-db-collection': patch
+'@tanstack/query-db-collection': patch
+---
+
+Fix on-demand load settlement, ordered pagination, and replay to preserve coherent results across cancellation, failure, cleanup, and restart. Preserve subset results and ownership across Electric, PowerSync, Query, and SQLite persistence adapters. Correct live-query grouping, include projections, value identity, and indexed comparisons. D2 hashing now rejects structural cycles and excessive traversal depth or work with an explicit error; Collection handles retain object-reference identity without traversing their mutable contents.
+
+Remove the unused public subset-algebra helpers: `isWhereSubset`, `unionWherePredicates`, `minusWherePredicates`, `isOrderBySubset`, `isLimitSubset`, `isOffsetLimitSubset`, `isPredicateSubset`, and `isLoadSubsetRequestSubsumedBy`. Apps that import these helpers must remove those imports; normal queries and adapters are unaffected. `DeduplicatedLoadSubset` remains available and shares only exact demand identities.
+
+Reject compiled Collection-valued includes as `fn.select()` inputs, including nested descendants, before invoking the callback. Use `toArray()` or `materialize()` in the upstream `.select()` for child-value calculations. To keep live child Collections, use expression `.select()` or perform parent-only functional work before adding the includes. Ordinary Collection-valued includes remain supported.
diff --git a/docs/guides/error-handling.md b/docs/guides/error-handling.md
@@ -157,11 +157,12 @@ their incremental result can no longer be kept complete.
 
 When a must-refetch truncate cannot reload every active subset, a subscription
 keeps its last successful snapshot and reports the subset error. It discards
-the incomplete replay batch, then resumes publishing ordinary source changes.
-The next truncate retries every active subset. Overlapping truncates form one
-atomic replay: all in-flight requests settle, the newest attempt decides the
-result, and subscribers receive the replacement only when that attempt
-succeeds.
+the incomplete replay batch and keeps later source changes private because they
+cannot prove a complete replacement. The next truncate retries every active
+subset. Overlapping truncates form one atomic replay: all in-flight requests
+settle, the newest attempt decides the result, and subscribers receive the
+replacement only when that attempt succeeds. Cleanup rejects window moves that
+are waiting for replay with `AbortError`.
 
 ## Collection Status and Error States
 

diff --git a/docs/guides/live-queries.md b/docs/guides/live-queries.md
@@ -2821,6 +2821,11 @@ The functional variant API provides an alternative to the standard API, offering
 
 ### Functional Select
 
+> [!WARNING]
+> `fn.select()` cannot consume Collection-valued includes, even when the callback ignores or passes through that field. This also applies to nested Collection-valued includes. Use `toArray()` or `materialize()` in the upstream `.select()` to provide inline child values. Keep these helpers outside the functional callback.
+
+Inline child updates rerun the functional projection. Arrays support JavaScript calculations, but do not expose Collection methods such as `get()`, `createIndex()`, or `subscribeChanges()`. To keep live child Collections, use standard `.select()`, or perform parent-only `.fn.select()` work before adding the child include.
+
 > [!WARNING]
 > `fn.select()` cannot be used with `groupBy()`. The `groupBy` operator needs to statically analyze the `select` clause to discover which aggregate functions to compute, which is not possible with an opaque JavaScript function. Use the standard `.select()` API for grouped queries.
 

diff --git a/docs/reference/classes/BaseQueryBuilder.md b/docs/reference/classes/BaseQueryBuilder.md
@@ -145,6 +145,11 @@ toArray(), and materialize() cannot be returned from fn.select(). Use
 them as fields in select() so the compiler can add them to the query
 graph.
 
+Compiled Collection-valued includes cannot be inputs to fn.select(),
+including nested descendants. Use toArray() or materialize() in the
+upstream select(), or do parent-only functional work before adding
+live Collection includes with select().
+
 ###### where()
 
 ```ts

diff --git a/docs/reference/functions/isLimitSubset.md b/docs/reference/functions/isLimitSubset.md
diff --git a/docs/reference/functions/isLoadSubsetRequestSubsumedBy.md b/docs/reference/functions/isLoadSubsetRequestSubsumedBy.md
diff --git a/docs/reference/functions/isOffsetLimitSubset.md b/docs/reference/functions/isOffsetLimitSubset.md
diff --git a/docs/reference/functions/isOrderBySubset.md b/docs/reference/functions/isOrderBySubset.md
diff --git a/docs/reference/functions/isPredicateSubset.md b/docs/reference/functions/isPredicateSubset.md
diff --git a/docs/reference/functions/isWhereSubset.md b/docs/reference/functions/isWhereSubset.md