diff --git a/.claude/tasks/contracts/2026-11-17-v1-2-6-u2-implementation.md b/.claude/tasks/contracts/2026-11-17-v1-2-6-u2-implementation.md index 23067251..093c6c6a 100644 --- a/.claude/tasks/contracts/2026-11-17-v1-2-6-u2-implementation.md +++ b/.claude/tasks/contracts/2026-11-17-v1-2-6-u2-implementation.md @@ -355,3 +355,94 @@ focus hold) close criteria 2 and 6's open rulings. The plan's rev 4 rulings bind ### FILE SCOPE (addendum) apps/app/src/components/shell/ShellChrome.tsx (the top bar's height variable only), apps/app/src/components/editor/HistoryButtons.tsx. + +## ADDENDUM 2026-11-19 (2): owner decisions at the checkpoint, rev 5 + +### REQUEST (verbatim — IMMUTABLE) +« Voici mes décisions pour les cinq points de contrôle U2. + +D1 : VALIDÉ. +Je choisis la petite bulle contextuelle sous le bouton « Refaire » ou « Défaire » indisponible. + +Elle doit être visible à proximité du bouton concerné, accessible au toucher, à la souris et au clavier, et ne provoquer aucun déplacement de l'interface. + +D2 : VALIDÉ. +Conserver le correctif de visibilité du focus à toutes les largeurs, y compris sous 1 024 px. + +D3 : VALIDÉ. +J'accepte les modifications de AppLayout.tsx, leaveGuardStore.ts, anchoredPlace.ts et layer.rs. Elles sont justifiées par le périmètre fonctionnel de U2. + +D4 : REFUSÉ. +Ne pas réinitialiser la sandbox. + +Les données existantes doivent être préservées. Mets le contrat en cohérence avec cette contrainte et conserve les limites de vérification documentées. + +D5 : ACCEPTÉ AVEC RÉSERVE. +Les 17 échecs E2E hors éditeur ne bloquent pas mon essai manuel de U2. + +En revanche, ils ne doivent pas être présentés comme résolus ou tous formellement indépendants de U2. + +Le passage de quatre à six échecs dans l'intégrité du catalogue mérite une vérification ciblée si elle peut être réalisée sans détruire de données. + +Je te laisse déterminer le diagnostic pertinent, en tenant compte des comparaisons déjà réalisées et de la charge de la sandbox. + +J'ai également une remarque importante concernant le bandeau des outils. + +Tu indiques que, lorsque la page défile, la barre d'outils peut recouvrir le haut du dessin. + +Ce comportement ne me convient pas complètement. + +Dans un éditeur anatomique, l'utilisateur doit pouvoir manipuler toute la surface utile du dessin sans qu'une partie soit masquée par les éléments fixes de l'interface. + +Je souhaite une correction ergonomique cohérente, sans décalage intempestif du schéma, sans défilement horizontal et sans régression des interactions tactiles. + +Je te laisse choisir la meilleure solution technique. + +Les autres comportements annoncés sont acceptés, notamment : +- Reprendre le tracé avec ses poignées ; +- Retour arrière et « + » sur Mac ; +- focus conservé après les manipulations ; +- sélection automatique du sommet suivant après suppression ; +- comportement cohérent de Défaire pendant une modification en cours. + +Tu peux poursuivre les ajustements et les vérifications avec ton orchestration habituelle. + +Une fois ces derniers points traités, je ferai mon essai manuel sur db:trial, à la souris et sur tablette. + +U2 sera clôturé après ma validation de cet essai. » + +### Amendments carried by the owner's decisions +- Criterion 22: no `db:sandbox up fresh` and no reset, ever, on this work (D4); the existing sandbox data is + preserved. The gates run on the existing sandbox; their verification limits stay documented (red environment + suites named with their evidence, never called resolved or all formally independent of U2, D5). +- Criterion 25: « below 1 024 px nothing changes » no longer covers the focus margin of the editor's own controls, + which applies at every width (D2). +- Criterion 30: the held reason appears in a bubble next to the held button (D1), replacing the message line. + The controller amendment of 2026-11-19 (texts, « reason only when it helps », « Défaire » cancels pending work) + is accepted by the owner (« comportement cohérent de Défaire pendant une modification en cours »). +- Scope (D3): AppLayout.tsx, leaveGuardStore.ts, anchoredPlace.ts and layer.rs are in scope. + +### ACCEPTANCE CRITERIA (addendum 2) +32. **The drawing is never under the strip (owner remark).** On the editable layout (≥ 1 024 px), at every page + scroll position, no part of the drawing's box, its view chips, its add row or its message line is under the + sticky strip or the top bar while the user can act on it; the presses that the rev 4 tests had to move to the + page top (`scrollToTop` / `expectOnDrawing` in editor-deselect and editor-journey) pass where they were first + written; no horizontal scroll at 1 024, 1 180 and 1 280 px nor at a shorter window height probed; the canvas + keeps its size during a scroll; a row selection does not move the drawing on screen; touch drags, pinch, + page scroll and the loupe keep their behaviour; a focus on a pinned control never scrolls the page. +33. **The held reason in a bubble (D1).** A press (click, tap, Enter, Space) on a held « Défaire » or « Refaire » + shows its reason in a bubble next to that button, inside the viewport and below the top bar, at the three + sizes, on every tab; it moves nothing (`expectNoShift`, `scrollWidth` unchanged); it is announced once, keeps + the `aria-describedby` reason, passes axe while open, closes when the hold ends, on a tab change, when the focus + leaves and on Escape (whose order with the creation and pending-work Escape is defined and tested); the message + line route for the reason is removed. +34. **Catalogue-integrity count (D5).** A non-destructive diagnosis of the 4 → 6 failures is recorded (read-only + counts, a head run alone with one worker, a pre-U2 baseline run only if the head run fails them all); the + result is stated as attributed or not attributed, never assumed. +35. **Documents and gates (rev 5).** §4.17 updated (the bubble, the pinned drawing, the decisions D1 to D5 as + accepted); UX_TESTS states the environment failures per D5; criteria 22 and 23 run again on the final code + (check:all, the shell suite without editor-equine, both measures, a fresh verifier, a fresh security auditor + on the rev 5 delta). + +### FILE SCOPE (addendum 2) +apps/app/src/components/shell/AppLayout.tsx, apps/app/src/state/leaveGuardStore.ts, apps/app/src/components/ui/anchoredPlace.ts, crates/core/src/anatomy/layer.rs (owner D3); apps/app/src/styles/index.css and the editor's annotations layout components for criterion 32; HistoryButtons.tsx and a bubble component under apps/app/src/components/editor/ for criterion 33.