7ebb03a3f3
Document the SDK's public read surface grounded in real NextGraph: the reactive useShape hook (subscribe/push — a doc change, local or broker-synced from a remote peer, propagates to every subscriber; no polling) is THE recommended read path; one-shot sparqlQuery/readUnion is the exception. Includes the write surface, identity/scope (per-document isolation, public = owner-writes-only), and a separate 'current emulation status' section flagging where the polyfill does not yet honor the reactive contract (entity reads one-shot + polling inbox/index watchers) as gaps to close. Shared reference: honored by the lib, used by Festipod. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>