From 01d65238ce91f01c11fbf30c9de0c50e2209aa58 Mon Sep 17 00:00:00 2001 From: Sylvain Duchesne Date: Mon, 6 Jul 2026 22:02:47 +0200 Subject: [PATCH] docs(data-layer): point to the SDK reference for the reactive read hook MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add a pointer in knowledge_nextgraph-stack: the SDK's recommended read is its reactive useShape hook (subscribe/push, one-shot is the exception); full contract in @ng-eventually/client packages/client/docs/sdk-reference.md. No NextGraph internals copied into the app repo — just the pointer. Co-Authored-By: Claude Opus 4.8 (1M context) --- .project/concepts/data-layer/knowledge_nextgraph-stack.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.project/concepts/data-layer/knowledge_nextgraph-stack.md b/.project/concepts/data-layer/knowledge_nextgraph-stack.md index f4699f7..e004984 100644 --- a/.project/concepts/data-layer/knowledge_nextgraph-stack.md +++ b/.project/concepts/data-layer/knowledge_nextgraph-stack.md @@ -29,4 +29,6 @@ L'ORM réactif (`useShape`) s'appuie sur des **shapes SHEX** : `src/shared/shape Bindings ORM générés dans `src/shared/shapes/orm/` (`*.schema.ts`, `*.shapeTypes.ts`, `*.typings.ts`). **Régénérer** avec `bun run build:orm` après toute modif `.shex`. +> **Lecture recommandée = le hook réactif du SDK.** La façon canonique de lire, c'est `useShape` : on s'abonne à une shape sur un scope, on obtient la valeur courante, et le composant se re-rend à chaque changement (local **ou** distant synchronisé) — abonnement/push, jamais de polling ; les lectures one-shot sont l'exception. La référence complète du SDK (contrat de lecture/réactivité + où l'émulation courante diverge encore) vit côté lib : `packages/client/docs/sdk-reference.md` dans `@ng-eventually/client`. Ne pas recopier les internes NextGraph ici. + > `Friendship` n'a **pas** de shape SHEX ni de persistance — il reste app-TS-only (cf. [[knowledge_entities]]).