docs(docs): U2 final gate results and measures on 15b23f8

UX_TESTS: gates at 15b23f8 (check:all passed; shell suite 311 passed, 14 failed, red; test 105 passed; test-db FAIL 014/021 as before U2), measures rerun, keyboard map row (Backspace only while tracing). Plan Tasks 8 and 10 and OWNER_TRIAL Mesures carry the new figures.
This commit is contained in:
bchanot committed 2026-11-18 14:54:24 +01:00
1 parent 15b23f8420
commit 4e2bdb5ebb
3 files changed
+13 -5

No files matched your search

@@ -1286,6 +1286,9 @@ Behaviour:
timestamp the touch median is about 26 to 30 ms for all three (browser input queueing, the same without
loupe). The first run on the Vite dev server (React development build, StrictMode) gave about 30 ms for A and
25 ms with no loupe; it does not stand for the product.
- Measured again 2026-11-18 on the final code (15b23f8), same conditions, technique A only, three runs: frame
work median / p95 3.0 / 3.9, 3.2 / 4.5, 3.1 / 4.0 ms (53 of 55 samples with the loupe); touch from the event
timestamp 26.9 ms median in each run; mouse control p95 3.2 / 3.9 / 3.4 ms.
- [ ] **Step 2:** FAIL. **Step 3:** implement. **Step 4:** gates.
- [ ] **Step 5:** commit `feat(editor): two-finger pan, touch hint, loupe, touch-sized handles`.
@@ -1323,6 +1326,9 @@ Behaviour:
max: drag 176.9 / 209.2 ms, « + » 176.2 / 177.6 ms, « − » 168.2 / 170.3 ms; a second spec run gave 176.0 /
209.1, 176.1 / 186.1, 169.5 / 175.3 ms. All under the 500 ms bar. A dev-server smoke run (React development
build) gave medians 337.3, 329.1 and 272.2 ms, max 399.3 ms; it does not stand for the product.
- Measured again 2026-11-18 on the final code (15b23f8), same protocol: drag 202.1, 174.7, 171.0 ms (median
174.7, max 202.1); « + » 175.1, 178.3, 173.4 ms (175.1 / 178.3); « − » 169.7, 165.7, 182.2 ms (169.7 / 182.2).
All under the 500 ms bar.
- [ ] **Step 4:** fresh `verifier` against the U2 implementation contract (written at the start of execution with
the owner's approval brief verbatim), and fresh `security-auditor` on the U2 diff, once each.
- [ ] **Step 5:** owner trial section `docs/development/V1-2-6_OWNER_TRIAL.md` §4.17 « Démonstration U2 », on the
+4 -2
View File
@@ -867,10 +867,12 @@ Limites connues :
Deux mesures ont été faites sur un brouillon équin créé pour l'occasion sur la sandbox, jamais sur la copie de
travail ni sur la fiche historique, avec Chromium sur ordinateur et un processeur ralenti quatre fois :
- la fluidité de la loupe (2026-11-18, version de production) : le travail d'une image pendant un glisser au doigt
reste sous 4,7 ms dans 95 % des cas (p95 4,2 à 4,7 ms avec la loupe, 3,6 à 4,2 ms sans), loin des 16 ms d'une image ;
reste sous 4,5 ms dans 95 % des cas sur la version finale (p95 3,9 à 4,5 ms avec la loupe ; 3,6 à 4,2 ms sans, mesuré
avant), loin des 16 ms d'une image ;
- le délai d'enregistrement d'un geste (2026-11-18, version de production, souris) : du relâchement de la souris à
l'image où la nouvelle forme est affichée et où « Défaire » est disponible, trois essais par geste. Médiane et
maximum : glisser d'un sommet 177 et 209 ms, « + » 176 et 178 ms, « − » 168 et 170 ms, sous la limite de 500 ms.
maximum sur la version finale : glisser d'un sommet 175 et 202 ms, « + » 175 et 178 ms, « − » 170 et 182 ms, sous la
limite de 500 ms.
Ces chiffres viennent d'un navigateur piloté par ordinateur. Le vrai contrôle est votre essai sur la tablette : si un
glisser, un « + » ou un « − » vous paraît lent ou saccadé, notez le geste et la vue.
+3 -3
View File
@@ -50,11 +50,11 @@ Implemented (contract `.claude/tasks/contracts/2026-11-06-v1-2-6-ux-u1-1123.md`)
## U2 · Points and polygons
Implemented (plan `.claude/tasks/plans/2026-11-17-v1-2-6-u2.md`, rev 3; boards `docs/design/v1-2-6-u2/`, A1 to A15 and the three adjustments). Rule numbers (R-n) are the plan's. The owner trial and the gates (plan Task 10) are pending. The suites run on the sandbox only (`pnpm db:sandbox`).
Implemented (plan `.claude/tasks/plans/2026-11-17-v1-2-6-u2.md`, rev 3; boards `docs/design/v1-2-6-u2/`, A1 to A15 and the three adjustments). Rule numbers (R-n) are the plan's. Gates (plan Task 10) rerun 2026-11-18 on 15b23f8, the final code (later commits are documents only): `pnpm check:all` passed; the shell suite, every file but `editor-equine.spec.ts` in four batches, 311 passed, 14 failed, 200 skipped, 1 did not run (526 tests, 33 files), and is not green. The failures are `admin.spec.ts` 6 and `catalogue-integrity.spec.ts` 4, the same counts and errors as on pre-U2 56c75b1; `catalogue.spec.ts` 2 and `admin-sheets-list.spec.ts` 1 failed in the batch, and alone `admin-sheets-list` passed 8 while `catalogue` failed 1 then 2 different tests on a sheet or refusal page still loading at 10 s (no change to that path in U2, not run on 56c75b1). `pnpm db:sandbox test` 105 passed, 10 skipped; `pnpm db:sandbox test-db` FAIL, `014_animals_relations` 2/258 and `021_sheet_verification_jobs` 23 failed (« Bad plan », `draft.frozen`), as recorded before U2 on accumulated sandbox data. The owner trial is pending. The suites run on the sandbox only (`pnpm db:sandbox`).
| Kind | Tests |
|---|---|
| Unit (tables) | the press machine (`annotations.press.test.ts`): slop per kind (4, 6 and 10 CSS px), click and drag decisions, handle priority (vertex over « − » over « + », nearest first), double click within 400 ms and 8 px opens the dialog and never inserts, a second pointer cancels; slider stops, most-used radius, snap within 8 CSS px, range (`pointSize`); midpoint insert after the segment start, « − » refused at 3 vertices (`message.vertex_min`), vertex move, no-op move, the 40-vertex cap, « + » hidden under two hit radii (`polygonEdit`); Escape action (`escape`); `missingFields` names only the missing fields in form order; keyboard map (arrows by 0.5 % of the frame's longer side, Shift ×10, Insert, Backspace or Delete, Enter, Escape, roving focus); arrows pan only when the box itself is focused (`useFraming`, catalogue defaults unchanged); two pointers translate without scaling (`twoPointerPan`) |
| Unit (tables) | the press machine (`annotations.press.test.ts`): slop per kind (4, 6 and 10 CSS px), click and drag decisions, handle priority (vertex over « − » over « + », nearest first), double click within 400 ms and 8 px opens the dialog and never inserts, a second pointer cancels; slider stops, most-used radius, snap within 8 CSS px, range (`pointSize`); midpoint insert after the segment start, « − » refused at 3 vertices (`message.vertex_min`), vertex move, no-op move, the 40-vertex cap, « + » hidden under two hit radii (`polygonEdit`); Escape action (`escape`); `missingFields` names only the missing fields in form order; keyboard map (arrows by 0.5 % of the frame's longer side, Shift ×10, Insert and Delete on a vertex, Backspace while tracing, Enter, Escape, roving focus); arrows pan only when the box itself is focused (`useFraming`, catalogue defaults unchanged); two pointers translate without scaling (`twoPointerPan`) |
| Unit (state) | every preview, keyboard series and chosen vertex carries the `documentText` it was computed on, and a stale stamp is refused (`annotations.workStore.test.ts`); a preview is cancelled and restored, never committed, on undo, document replacement, tab change and a second pointer; redo is held (the header « Refaire » greyed, Ctrl+Shift+Z inert) while a move mode, a redraw or uncommitted arrow or slider steps are pending, so the pending work is kept, never dropped (`editor-zone-edit.test.tsx` « final review I-1 »); an undo with a move mode, a slider or a series pending only cancels the preview (R-13); during a creation undo is inactive and « Défaire » is hidden (A12); the message line: « Point déplacé · Défaire » calls the same `undo()` as the header, any commit, undo or redo closes it, a refusal is `role="alert"` without « Défaire », 6 s, a mouse hover or the keyboard focus inside the line pauses it (WCAG 2.2.1) and a touch does not; the hint after a futile finger drag only when the line is free and never after a two-finger gesture worked (R-1); the slider commits once on release (history depth after a keyboard walk); the strip keeps a fixed height and truncates a long name before the status; dialogs mounted outside `EditOnly`: the width flip and the mode flip keep the draft, disable the save and commit nothing (R-14); a creation, a started move mode or a started redraw asks before a tab, a section, a view chip, a tool, Back, Escape, sign-out or leaving the editor, and a document change made elsewhere announces the dropped work (R-12, R-13); `Dialog` `anchor`, a click on the veil does nothing (R-6); undo history cap 8 MiB, about 47 equine steps (R-15) |
| Core | the per-view minimum visible radius (`PreviewState.min_point_radius`) equals the `marker_too_small` threshold on the equine views and on edge frames (`sheet_preview.rs`, `editor-min-point-radius.test.ts`) |
| E2E mouse | drag a vertex, « + », « − », zone drag on a selected zone, redraw accepted, redraw refused by `interior_too_small` keeps and restores the old shape, undo and redo of each (`editor-zones.spec.ts`); a point: handle drag, size by a click on the track, the move mode (`editor-annotations.spec.ts`); the properties dialog opens over the right column and never over the drawing, a click on the veil does nothing, a double click on the selected zone opens it and inserts no vertex, a typed form then Back asks, a width crossing below 1 024 px keeps the draft (`editor-properties.spec.ts`); « Défaire » in the message line undoes the same entry as the header button, which carries the accessible name « Défaire la dernière modification » (T15; EN « Undo the last change ») |
@@ -63,7 +63,7 @@ Implemented (plan `.claude/tasks/plans/2026-11-17-v1-2-6-u2.md`, rev 3; boards `
| Keyboard | create a zone, add and remove a vertex, move the zone, validate, without a pointer; Ctrl+Z on a focused handle after arrow moves only cancels the preview and a later Enter commits nothing stale; after undoing « + », « − » never removes the wrong vertex; « Désélectionner » commits a pending series |
| Paths (T16) | a path annotation gets no handle, no « + » or « − », no zone move in either mode, no keyboard move; its `d` is byte-identical after every gesture on its neighbours, a save and a reload; « Remplacer par un polygone » stays the only change: explicit, validated by the core, the path kept while tracing, on Escape and on a refusal; one undo entry restoring the exact `d`, redo restoring the polygon (owner, BDR-101) |
| Accessibility | axe on selection, tracing, move states and the dialog in read and edit modes; handle names (« Point {nom} », « Sommet {n} de {nom} », « Ajouter un sommet après le sommet {n} de {nom} », « Retirer le sommet {n} de {nom} », the handle group « Sommets de {nom} »); live-region message after a move; WCAG 2.5.7: the move mode with four arrow buttons is the single-pointer path without dragging (A11) |
| Performance | commit latency under the 500 ms budget for drag, insert and remove, a measure run by hand at the gates (`e2e/support/measure-commit.ts`, `editor-measure-commit.spec.ts`, `MEASURE_COMMIT=1`) on a run-seeded equine-sized draft, never on the historical copy nor through `editor-equine.spec.ts`. Measured 2026-11-18 on a production build under `vite preview`, Chromium mouse at 1 280 px, CPU ×4, from the release to the painted frame showing the new geometry with the undo entry: median / max drag 176.9 / 209.2 ms, « + » 176.2 / 177.6 ms, « − » 168.2 / 170.3 ms (three runs each; figures in plan Task 10); the drag smoothness is a measure, not an assertion (`e2e/support/measure-drag.ts`, `editor-measure-drag.spec.ts`, run by hand). Measured 2026-11-18 on a production build under `vite preview`, Chromium touch at 1 180 px, CPU ×4: frame work p95 4.2 to 4.7 ms with the loupe (technique A), 4.0 to 4.4 ms outline only (B), 3.6 to 4.2 ms without a loupe; technique A kept. The figures are in plan Task 8; the owner's tablet trial is the real check |
| Performance | commit latency under the 500 ms budget for drag, insert and remove, a measure run by hand at the gates (`e2e/support/measure-commit.ts`, `editor-measure-commit.spec.ts`, `MEASURE_COMMIT=1`) on a run-seeded equine-sized draft, never on the historical copy nor through `editor-equine.spec.ts`. Measured 2026-11-18 on a production build under `vite preview`, Chromium mouse at 1 280 px, CPU ×4, from the release to the painted frame showing the new geometry with the undo entry; on the final code (15b23f8): median / max drag 174.7 / 202.1 ms, « + » 175.1 / 178.3 ms, « − » 169.7 / 182.2 ms (three runs each; earlier figures in plan Task 10); the drag smoothness is a measure, not an assertion (`e2e/support/measure-drag.ts`, `editor-measure-drag.spec.ts`, run by hand). Measured 2026-11-18 on a production build under `vite preview`, Chromium touch at 1 180 px, CPU ×4: frame work p95 3.9 to 4.5 ms with the loupe (technique A, final code 15b23f8; 4.2 to 4.7 ms before), 4.0 to 4.4 ms outline only (B), 3.6 to 4.2 ms without a loupe; technique A kept. The figures are in plan Task 8; the owner's tablet trial is the real check |
## U3 · Category panel and own colour