docs(docs): U2 contract addendum 2, owner decisions D1 to D5

This commit is contained in:
bchanot committed 2026-11-19 19:44:30 +01:00
1 parent 0d362605b3
commit e2f9302dfe
1 file changed
+91
@@ -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.