docs: known issues (perte écriture, réhydratation à froid, écho auto-écriture) + gap 4 sdk-reference
Section 'Known open issues' dans nextgraph-current-state (A ouvert, B indéterminé, C hypothèse-en-cours) + gap 4 (auto-écho non confirmé) dans sdk-reference. Statuts préservés. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014GbGgNEHRejVKoREvFuDFg
This commit is contained in:
@@ -470,3 +470,50 @@ logout is exposed (`ng.session_stop()`, `ng.user_disconnect()`,
|
||||
redirect afterwards. This lib's identity store sidesteps all of it — the identity
|
||||
id is set at wallet-import time and relayed to the lib, without a separate login;
|
||||
see the identity store in [`simulation.md`](./simulation.md).
|
||||
|
||||
## Known open issues (section added 2026-07-18)
|
||||
|
||||
Live limitations observed against the current core/SDK, each with its epistemic
|
||||
status. **None is treated.** The status labels below are load-bearing — do not
|
||||
upgrade an OPEN / UNDETERMINED / HYPOTHESIS item to "confirmed" or "fixed"
|
||||
without new evidence.
|
||||
|
||||
### Write loss on socket death (`SerializationError`) — symptom VERIFIED, mechanism UNSETTLED, OPEN / untreated
|
||||
|
||||
A write made just before an idle period / spontaneous socket death
|
||||
(`SOCKET IS CLOSED Some(Left(SerializationError))`) can be **silently lost**:
|
||||
the entity is absent on reconnection while the account survives. Reconnection is
|
||||
an unimplemented `// TODO` stub in the core (`broker.rs`, ≈ `1051-1076`);
|
||||
`disconnections_subscribe` DOES fire on the failure but nothing — neither this
|
||||
polyfill nor the consumer app — consumes it; and there is **no
|
||||
write-durability-confirmation API** a caller could `await`. Full post-mortem
|
||||
(logs, causal chain, correction leads, none arbitrated):
|
||||
[`incidents/2026-07-14-write-loss-on-disconnect.md`](./incidents/2026-07-14-write-loss-on-disconnect.md).
|
||||
|
||||
### Cold-start read does not rehydrate the owner's own scope from the broker — symptom VERIFIED, root cause UNDETERMINED, OPEN / untreated
|
||||
|
||||
Decisive test (2026-07-14): a genuinely no-local cold reader — fresh
|
||||
non-persistent browser context, SAME wallet + account — reads **0** of the
|
||||
owner's own scope from the broker. The previously "passing" reconnect test was
|
||||
FALSE-GREEN: it read the owner's repos from the persistent profile's LOCAL
|
||||
IndexedDB, so it never proved broker durability. It is UNDETERMINED whether
|
||||
**(i)** the write never durably reached the broker, or **(ii)** the write IS on
|
||||
the broker but a fresh session cannot re-open the owner's own scope docs (a
|
||||
cold-open / rehydration limitation) — both collapse to the same 0-read in this
|
||||
setup. Next step (NOT done): disambiguate (i) vs (ii) with an independent warm /
|
||||
second-identity read of the same doc. The same (i)/(ii) reserve is carried in
|
||||
[`incidents/2026-07-14-write-loss-on-disconnect.md`](./incidents/2026-07-14-write-loss-on-disconnect.md)
|
||||
(§ *Portée & non-reproduit*), whose Firefox case leans (i) — this cold-reader
|
||||
signature is distinct (no socket death) and does not settle it.
|
||||
|
||||
### Reactive subscription may not echo the writer's OWN local commit — HYPOTHESIS (high-confidence), confirmation in progress (2026-07-18), NOT confirmed, NOT fixed
|
||||
|
||||
When a client does a local `sparqlUpdate` on a doc it is itself subscribed to
|
||||
(`subscribeDoc`/`doc_subscribe`), the subscription callback appears NOT to fire
|
||||
for its own local commit in the same session, so the polyfill's reactive re-read
|
||||
chain never runs and consumers keep a stale value until the next connection
|
||||
delivers a fresh initial `State`. REMOTE commits DO push correctly (verified:
|
||||
cross-browser reactive update works). Verdict pending a live instrumented run.
|
||||
Full write-up (suspect link, instrumentation, planned polyfill-side fix):
|
||||
[`../packages/client/docs/sdk-reference.md`](../packages/client/docs/sdk-reference.md)
|
||||
§ *Current emulation status*.
|
||||
|
||||
Reference in New Issue
Block a user