chore(memory): BDR-103, LRN-119, U2b decisions contract and TODO
This commit is contained in:
1 parent
604f502b44
commit
a43145a03f
5 files changed
+183
-1
No files matched your search
@@ -0,0 +1,154 @@
|
||||
# CONTRACT — v1-2-6-findings-nav-decisions
|
||||
- date: 2026-11-06 | flow: design checkpoint preparation (docs only) | branch: feature/v1-2-anatomical-sheets
|
||||
- status: active
|
||||
- worktree: /home/bchanot/Documents/faunosteo-v1-2 (every command from this absolute path; never DEV: the
|
||||
`supabase_*_faunosteo` containers are DEV; no sandbox needed)
|
||||
- base: 567da67 (complement after the verifier's CONFORME 9/9, trigger name per the core). Commit in place, push; no
|
||||
merge, no `gitflow.sh finish`.
|
||||
- context: follows `.claude/tasks/contracts/2026-11-06-v1-2-6-findings-nav-design.md` (complement design, verdict
|
||||
CONFORME 9/9 on round 3, before 567da67). The U1 plan and contract stay as committed at 2e46c14.
|
||||
|
||||
## REQUEST (verbatim — IMMUTABLE)
|
||||
|
||||
# FAUNOSTEO — Validation de principe U2b et préparation des checkpoints
|
||||
|
||||
Le propriétaire approuve le principe de la navigation bidirectionnelle entre annotations et constats.
|
||||
|
||||
## 1. Placement
|
||||
|
||||
Retenir une sous-étape U2b « Annotations et constats », après U2 et avant U3, avec son propre contrat, ses tests et son checkpoint.
|
||||
|
||||
Ne pas modifier le plan U1 si les points d'intégration déjà prévus suffisent réellement.
|
||||
|
||||
Ne pas commencer l'implémentation de U2b.
|
||||
|
||||
## 2. Décisions enregistrables
|
||||
|
||||
F1 : placement U2b approuvé.
|
||||
|
||||
F2 : les compteurs portent sur les constats réels à toute profondeur, sans compter les conteneurs de familles et sans doublonner les constats associés à une même zone par plusieurs annotations.
|
||||
|
||||
F3 : recherche instantanée, insensible aux accents et à la casse. La liste exacte des champs recherchés doit être présentée avant ratification complète.
|
||||
|
||||
F4 : filtres texte et anatomiques combinés par intersection ; plusieurs zones anatomiques sélectionnées produisent une union sans doublon. Présenter la sémantique complète du filtre par vues avant ratification.
|
||||
|
||||
F6 : sous 1 024 px, consultation et filtres par liste, aucune édition graphique.
|
||||
|
||||
F7 : « Famille » désigne les familles de constats, distinctes des catégories anatomiques.
|
||||
|
||||
F8 : l'association d'une annotation dépourvue de zone passe par une opération logique atomique, validée et annulable, sans doublon silencieux.
|
||||
|
||||
Lorsqu'une annotation est sélectionnée et que l'utilisateur ajoute un constat, préselectionner sa zone de rattachement. Ne pas imposer une seconde sélection inutile.
|
||||
|
||||
## 3. Décisions non encore ratifiées
|
||||
|
||||
Préparer une table complète F1 à F21, reproduisant pour chacune :
|
||||
- Le libellé exact.
|
||||
- Les alternatives.
|
||||
- La recommandation.
|
||||
- Les conséquences techniques.
|
||||
- L'état : approuvé, partiellement approuvé ou à décider.
|
||||
|
||||
Ne pas convertir automatiquement les recommandations F5 et F9 à F21 en décisions du propriétaire.
|
||||
|
||||
## 4. Apprentissage React
|
||||
|
||||
Ajouter au registre d'apprentissages la distinction entre la conservation de l'état et la remise en route des effets avec React 19.2 `<Activity>`.
|
||||
|
||||
Documenter l'impact possible sur useFraming et FindingTree.
|
||||
|
||||
Ne pas généraliser l'interdiction de `<Activity>`.
|
||||
|
||||
## 5. Complément graphique
|
||||
|
||||
Conserver les six planches 17 à 22 comme proposition de conception U2b.
|
||||
|
||||
Fournir un moyen simple de les revoir avec les décisions F1 à F21.
|
||||
|
||||
Ne pas déclarer une nouvelle conformité indépendante après les modifications effectuées postérieurement au verdict CONFORME 9/9 sans vérification supplémentaire.
|
||||
|
||||
## 6. Plan U1
|
||||
|
||||
Préserver le plan U1 existant au commit 2e46c14.
|
||||
|
||||
Présenter son bilan de conception et les résultats des trois relecteurs indépendants, avec les éventuels blocages restants.
|
||||
|
||||
Ne pas engager l'implémentation U1 avant le checkpoint d'autorisation correspondant.
|
||||
|
||||
## 7. Restrictions
|
||||
|
||||
Documentation et conception uniquement pour cette intervention.
|
||||
|
||||
Aucune modification applicative, Rust, SQL ou worker.
|
||||
|
||||
Aucune opération sur Supabase DEV.
|
||||
|
||||
Aucune fusion, aucun déploiement et aucun début de V1-2.7.
|
||||
|
||||
S'arrêter au prochain checkpoint documentaire.
|
||||
|
||||
## CLARIFICATIONS
|
||||
(none; owner questions stay in the study's section 7)
|
||||
|
||||
## ACCEPTANCE CRITERIA
|
||||
1. Placement (request 1): `docs/development/V1-2-6_UX_PLAN.md` §3 lists a sub-step « U2b · Annotations et constats »
|
||||
between U2 and U3, stating its own contract, tests and owner checkpoint, that it starts only on a new owner
|
||||
authorisation, and pointing to the study; the study's section 4 records F1 as approved; the study's section 3
|
||||
re-checks, with line references to the U1 plan, that the integration points already planned suffice, and proposes
|
||||
no U1 amendment.
|
||||
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && grep -q "^### U2b · Annotations et constats" docs/development/V1-2-6_UX_PLAN.md && awk '/^### U2 ·/{a=NR} /^### U2b ·/{b=NR} /^### U3 ·/{c=NR} END{exit !(a<b && b<c)}' docs/development/V1-2-6_UX_PLAN.md && echo U2B_PLACED
|
||||
EXPECT: U2B_PLACED
|
||||
EVIDENCE: MET exit=0 marker-found :: U2B_PLACED
|
||||
2. U1 preserved (request 6): the U1 plan and contract are byte-identical to 2e46c14, in the commits and in the
|
||||
working tree.
|
||||
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet 2e46c14 -- .claude/tasks/plans/2026-11-06-v1-2-6-ux-u1.md .claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md && echo U1_UNCHANGED
|
||||
EXPECT: U1_UNCHANGED
|
||||
EVIDENCE: MET exit=0 marker-found :: U1_UNCHANGED
|
||||
3. Decision table (request 3): the study's section 7 holds one row per decision F1 to F21, each with the question as
|
||||
the study worded it, the alternatives, the recommendation, the technical consequences and a state among
|
||||
« approved », « partially approved », « to decide »; F1, F2, F6, F8 approved and F7 approved for the term
|
||||
« Famille », with the owner's sentence quoted verbatim; F3 and F4 partially approved, with the approved part quoted
|
||||
and the part left to ratify named; F5 and F9 to F21 « to decide »; the owner's sentence on the preselected zone is
|
||||
recorded verbatim as an approved decision; every recommendation changed since commit 567da67 is flagged as changed.
|
||||
4. F2 precision: the study flags that « constats réels » may exclude intermediate group nodes, gives both counts on
|
||||
the equine draft (all nodes and leaves only: total, grasset, the boards' searches), cites the practitioner picker
|
||||
rule (only leaves are ticked) and leaves the choice to the owner.
|
||||
5. F3 field list (request 2): the study lists every text field of zones, families and findings, plus descriptions,
|
||||
references, ids, annotation names, kind labels, review status and the vet flag, each with searched or not
|
||||
(recommendation), its alternative and its effect on the equine draft computed from `document.json`; it states the
|
||||
normalisation, the word rule and the language rule.
|
||||
6. F4 semantics (request 2): the study states the complete semantics of the view filter: what the state holds, what
|
||||
chosen views do with and without picked annotations, picks across views, deselecting a view, detail triggers,
|
||||
annotations without zone, a zone shown by several annotations, combination with the text, partial clears, the
|
||||
keyboard and narrow lists, document changes (undo), read-only modes; with at least one alternative model and
|
||||
examples computed from the equine draft.
|
||||
7. Learning (request 4): a learnings entry written through `memory.sh` distinguishes state kept from effects re-run
|
||||
under `<Activity>` (React 19.2), names `useFraming.ts:69` and `FindingTree.tsx:31-33` with their impact, and does
|
||||
not forbid `<Activity>` in general.
|
||||
8. Boards (request 5): the PNG boards 17 to 22 and the contact sheet are byte-identical to 567da67; the study's
|
||||
section 7.4 shows the six boards (Markdown images, any preview) each with the ids of the decisions whose « Boards »
|
||||
column names it, consistent with that column, and no second copy of the decisions' content (amended 2026-11-06
|
||||
before verification: a generated HTML page needed a script, refused outside a skill run); `REVUE.md` says the
|
||||
CONFORME 9/9 verdict predates 567da67 and does not cover it, and claims no conformity for this intervention
|
||||
beyond the verdict of criterion 11.
|
||||
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet 567da67 -- 'docs/design/v1-2-6-constats/*.png' && echo BOARDS_UNCHANGED
|
||||
EXPECT: BOARDS_UNCHANGED
|
||||
EVIDENCE: MET exit=0 marker-found :: BOARDS_UNCHANGED
|
||||
9. Registries: the owner's approved decisions recorded in one decisions entry (no recommendation recorded as
|
||||
decided), a journal line, the TODO line of the complement updated; all through `memory.sh` except TODO.md.
|
||||
10. Constraints (request 7): no change under `apps/`, `crates/`, `supabase/`, `packages/`, `scripts/`,
|
||||
`docs/design/v1-2-6/`; untracked review files never staged; no DEV, no merge, no V1-2.7.
|
||||
CHECK: cd /home/bchanot/Documents/faunosteo-v1-2 && git diff --quiet 567da67 -- apps crates supabase packages scripts docs/design/v1-2-6 && ! git ls-files --error-unmatch faunosteo-v1-2-6-revue-ux-chatgpt.md >/dev/null 2>&1 && echo FD_SCOPE_OK
|
||||
EXPECT: FD_SCOPE_OK
|
||||
EVIDENCE: MET exit=0 marker-found :: FD_SCOPE_OK
|
||||
11. A fresh independent verifier against this contract, covering the 567da67 delta (board 19 C trigger name, F7
|
||||
citation, REVUE text) and this intervention; justified gaps fixed; exact verdict reported. STOP at the
|
||||
documentary checkpoint.
|
||||
|
||||
## FILE SCOPE
|
||||
- docs/development/V1-2-6_UX_FINDINGS_NAV.md, docs/development/V1-2-6_UX_PLAN.md (U2b entry and order line),
|
||||
docs/development/V1-2-6_UX_DECISIONS.md (one pointer line)
|
||||
- docs/design/v1-2-6-constats/REVUE.md, docs/design/README.md (the complement's pointer line)
|
||||
- .claude/tasks/TODO.md, this contract, .claude/memory (through memory.sh)
|
||||
- NOT in scope: apps/**, crates/**, supabase/**, packages/**, scripts/**, docs/design/v1-2-6/**, the PNG boards, the
|
||||
U1 plan and contract, the V1-1 checkout
|
||||
Reference in new issue
Block a user