docs: dire partout que la lecture par lot n'existe plus

Le contrat publie et l'api-contract etaient traites avec le retrait lui-meme ;
restaient les documents qui decrivaient readUnion comme la primitive de
lecture du paquet, ou qui nommaient le module disparu.

Ce que les lecteurs apprennent maintenant : lire un document, c'est
docs.sparqlQuery ancre dessus, et lire plusieurs documents, c'est cet appel
une fois par document -- avec la decision sur une lecture qui echoue ecrite
au point d'appel. Deux consequences sont dites plutot que decouvertes : une
lecture refusee leve au lieu de rendre une liste vide, et les sujets sous le
prefixe reserve urn:ng-eventually: reviennent dans le resultat, a l'appelant
de les ignorer -- sans aucun gain de droits, les deux registres qu'un
document ordinaire porte etant l'adresse de sa boite et, pour un document
public, la cle que son magasin sert deja a qui la demande.

Les briefs dates ne sont pas touches : ils decrivent un etat de juillet, et
le reecrire falsifierait ce qui avait ete decide alors.

packages/polyfill/src/surface/docs.ts

@@ -24,7 +24,7 @@ import type { Nuri, NuriLike } from "../model/types";
 // through `sparqlQuery`, every write through `sparqlUpdate` (+ container creation
 // through `docCreate`) — each ultimately calling the real injected `ng` here. The
 // access log is therefore instrumented HERE so no access path escapes it. Callers
-// pass a semantic `label` (readDoc|readUnion|listMyEntityDocs|writeEntity|deposit
+// pass a semantic `label` (readDocument|listMyEntityDocs|writeEntity|deposit
 // |…); it is a lib-internal probe param, NOT forwarded to the real `ng` (the docs
 // primitives forward the exact SDK signature — see test/docs.test.ts). When the
 // log is OFF (default) the extra param is inert and costs one boolean read.

packages/polyfill/src/surface/inbox.ts

@@ -212,7 +212,7 @@ export async function post(targetInboxLike: NuriLike, opts: PostOptions): Promis
 
   // NO explicit `GRAPH <…>` wrapper — write the anchored DEFAULT graph:
   // `sparqlUpdate(sid, update, targetInbox)` scopes the write to that repo's
-  // default graph (same shape as read-model.ts readDoc/readUnion). This is the
+  // default graph (same shape as `read-document.ts`'s anchored read). This is the
   // CANONICAL, always-safe shape and the one the anchored default-graph read
   // queries. (Not a round-trip necessity on the current broker: the e2e harness
   // `packages/polyfill/e2e/` verified that an anchored `GRAPH <plainNuri>` write

packages/polyfill/src/surface/placement.ts

@@ -137,7 +137,7 @@ export async function createEntityDoc(store?: NuriLike): Promise<Nuri> {
 //
 //   - `listMyEntityDocs` has no counterpart at any level: there is no `doc_list`, no
 //     `list_docs`, nothing in the binding. Listing what one created is an ordinary query
-//     over the store's `ldp:contains` — the same shape `readUnion` is, sugar over
+//     over the store's `ldp:contains` — the same shape the anchored document read is, sugar over
 //     something already expressible. It stays reachable at `../shared-wallet/account-registry`
 //     for this library's own read path, which still calls it until that path queries the
 //     store itself.

packages/polyfill/src/surface/subscribe.ts

@@ -86,7 +86,7 @@ import type { Nuri, NuriLike } from "../model/types";
  * A push from the platform to a document subscriber. Loosely typed: the raw
  * serialized `AppResponse` (`{ V0: { State | Patch | TabInfo | ... } }`). The
  * consumer typically ignores the payload and uses the push purely as a
- * change SIGNAL (re-query on change — the read-model pattern), so this stays
+ * change SIGNAL (re-query on change — the read model in `docs/read-model.md`), so this stays
  * permissive rather than modelling every AppResponse variant.
  */
 // @provenance DocChange kind=aligned level=1 ref=engine/net/src/app_protocol.rs:AppResponseV0 — the raw serialized response, left `unknown` rather than modelling every variant

packages/polyfill/src/surface/use-shape-query.ts

@@ -22,9 +22,9 @@
  * The SDK's own shape query - `RdfOrmSubscription.getOrCreate(shapeType, scope)` - and
  * nothing of this library's own. Four steps went with the change, and they were one
  * mechanism: a logical scope resolved to a document set (`listMyEntityDocs`), those
- * documents opened through `ensureReposOpen` for a sync barrier, `readUnion` over them,
- * and a filter of the union by the shape's `@type` IRI. All four existed because the
- * parameter had to be TRANSLATED; once the parameter is upstream's own `Scope`, the
+ * documents opened through `ensureReposOpen` for a sync barrier, one anchored read over
+ * each of them, and a filter of the result by the shape's `@type` IRI. All four existed
+ * because the parameter had to be TRANSLATED; once the parameter is upstream's own `Scope`, the
  * question goes straight to the thing that answers it. `graphs`, `subjects` and the
  * whole-dataset marker `did:ng:i` are now read by the engine, literally, and this module
  * does not interpret them at all - so the three readings are upstream's, not ours.