Phase 551: whiteboard authoring queue refresh

docs/en/phase-0-reactflow-parity-audit.md

@@ -246,6 +246,10 @@ Phase 549 is GitHub #221 / `avalonia-node-map-3l6`, the whiteboard primitive per
 
 Phase 550 is GitHub #223 / `avalonia-node-map-wjr`, the whiteboard primitive Cookbook screenshot implementation gate. This proof-only Demo/Cookbook slice records `WHITEBOARD_PRIMITIVE_COOKBOOK_SCREENSHOT_GATE`: `cookbook-whiteboard-primitive-screenshot-proof` and `shell-cookbook-whiteboard-primitive-screenshot-proof` reuse `selection-marquee-workbench` to provide whiteboard primitive visual proof with route metadata, shell state, and non-overlap evidence after the internal model, renderer adapter, and persistence decision gates. Phase 550 is stacked after PR #222 and must not merge before Phase 549. It authorizes no public drawing API, no pointer coordinator, no toolbar, no eraser, no persisted whiteboard primitive state, no GraphDocument schema change, no renderer rewrite, no UI redesign, no retained API removal, and no full React Flow whiteboard parity.
 
+## Phase 551 Update
+
+Phase 551 is GitHub #225 / `avalonia-node-map-3c9`, the post-Phase-550 whiteboard authoring interaction queue refresh. This docs/tests-only slice records `WHITEBOARD_AUTHORING_INTERACTION_QUEUE_REFRESH`: after the internal model, renderer adapter, persistence decision, and Cookbook screenshot proof route gates, the next authoring work is split into tracker-backed follow-ups for Phase 552 public drawing tool activation, Phase 553 pointer gesture capture, Phase 554 authoring toolbar/Cookbook UX, Phase 555 eraser-on-primitive behavior, and Phase 556 persistence implementation decision. It authorizes no runtime behavior changes, no public API changes, no pointer coordinator edits, no toolbar implementation, no eraser implementation, no persistence/schema changes, no renderer rewrite, no screenshot manifest expansion, no UI redesign, no retained API removal, and no full React Flow whiteboard parity.
+
 ## Phase 489 Update
 
 Phase 489 closed GitHub #101 / `avalonia-node-map-6sc` through PR #102 as a renderer virtualization design spike on branch `perf/renderer-virtualization-spike`. This slice was docs/tests only: it defined the proof contract required before any future ItemsRepeater/Skia-style renderer virtualization, background graph index, or graph-size claim expansion. It made no public API change and no runtime change. The current evidence remains viewport-budgeted scene projection/rendering, not a true renderer virtualization contract; `xlarge` stays telemetry-only.
@@ -579,6 +583,8 @@ Phase 549 records the whiteboard primitive persistence decision implementation g
 
 Phase 550 records the whiteboard primitive Cookbook screenshot implementation gate through GitHub #223 / `avalonia-node-map-wjr`. It adds only the proof route/state pair `cookbook-whiteboard-primitive-screenshot-proof` and `shell-cookbook-whiteboard-primitive-screenshot-proof`, plus route metadata, shell state, and non-overlap visual proof for existing internal whiteboard primitive decisions; public drawing APIs, pointer coordinators, toolbar work, eraser behavior, persisted whiteboard primitive state, GraphDocument schema changes, renderer rewrites, UI redesign, and full React Flow whiteboard parity remain out of scope.
 
+Phase 551 records the post-Phase-550 whiteboard authoring interaction queue refresh through GitHub #225 / `avalonia-node-map-3c9`. It adds only `WHITEBOARD_AUTHORING_INTERACTION_QUEUE_REFRESH` and the next tracker-backed authoring split: public drawing tool activation, pointer gesture capture, authoring toolbar/Cookbook UX, eraser-on-primitive behavior, and persistence implementation decision. It does not implement runtime behavior, public API, pointer coordinator changes, toolbar UI, eraser behavior, persistence/schema changes, renderer changes, screenshot manifest expansion, UI redesign, or full React Flow whiteboard parity.
+
 | GitHub | Bead | Title | Priority | Likely write set | Parallelism |
 | --- | --- | --- | --- | --- | --- |
 | #193 | `avalonia-node-map-8l6` | Phase 535: refresh post-lasso visual feedback parity queue | P2 | parity roadmap docs and focused docs tests | Current docs/test queue refresh. Blocks the next implementation wave because it replaces the stale Phase 534 current row with tracker-backed follow-ups. |
@@ -597,6 +603,12 @@ Phase 550 records the whiteboard primitive Cookbook screenshot implementation ga
 | #219 | `avalonia-node-map-10p` | Phase 548: whiteboard primitive renderer adapter skeleton | P2 | renderer adapter tests, scene snapshot projection proof, and topmost primitive hit-testing evidence | Stacked after PR #218; do not merge before Phase 547. Must keep persistence/schema, Cookbook screenshot rows, pointer coordinators, and toolbar activation out of scope. |
 | #221 | `avalonia-node-map-3l6` | Phase 549: whiteboard primitive persistence decision implementation gate | P3 | persistence decision tests, schema/surface choice, migration criteria, and compatibility coverage | Stacked after PR #220; do not merge before Phase 548. Chooses separate annotation surface and keeps GraphDocument schema/version/workspace persistence unchanged before any saved whiteboard primitive claim. |
 | #223 | `avalonia-node-map-wjr` | Phase 550: whiteboard primitive Cookbook screenshot implementation gate | P3 | Cookbook screenshot implementation gate docs/tests, route metadata, shell state, and non-overlap visual proof | Stacked after PR #222; do not merge before Phase 549. Adds the whiteboard primitive visual proof route/state pair only, with no public drawing API, pointer coordinator, toolbar, eraser, persisted whiteboard primitive state, GraphDocument schema change, renderer rewrite, UI redesign, or full whiteboard parity claim. |
+| #225 | `avalonia-node-map-3c9` | Phase 551: post-Phase-550 whiteboard authoring interaction queue refresh | P4 | parity roadmap docs and focused docs tests | Stacked after PR #224; do not merge before Phase 550. This docs/test queue refresh records the next authoring split without runtime/API/pointer/toolbar/eraser/persistence/renderer/screenshot-manifest behavior. |
+| #226 | `avalonia-node-map-718` | Phase 552: whiteboard drawing tool public activation contract | P2 | public drawing tool activation contract, hosted/editor seam tests, and docs | Depends on Phase 551. Owns activation only; no pointer gesture capture, runtime drawing creation, toolbar UI, eraser behavior, persistence/schema changes, renderer rewrite, screenshot manifest expansion, or full whiteboard parity claim. |
+| #227 | `avalonia-node-map-9f0` | Phase 553: whiteboard primitive pointer gesture capture | P2 | pointer gesture capture tests, editor/Avalonia interaction state, and lifecycle boundaries | Depends on Phase 552. Owns pointer gesture capture after activation; no toolbar UI implementation, eraser behavior, persisted whiteboard primitive state, GraphDocument schema changes, renderer rewrite, screenshot manifest expansion, or full whiteboard parity claim. |
+| #228 | `avalonia-node-map-kpy` | Phase 554: whiteboard authoring toolbar and Cookbook UX route | P3 | hosted authoring actions, Cookbook route, screenshot proof metadata, and non-overlap visual evidence | Depends on Phase 553. Owns authoring toolbar/Cookbook UX after pointer capture; no new core model design, pointer coordinator redesign, eraser behavior, GraphDocument schema changes, persisted whiteboard primitive claim, renderer rewrite, or full whiteboard parity claim. |
+| #229 | `avalonia-node-map-71c` | Phase 555: whiteboard primitive eraser behavior route | P3 | eraser-on-primitive behavior tests, primitive hit-testing, and graph-deletion separation | Depends on Phase 554. Owns eraser-on-primitive behavior only; graph-selection delete remains separate and no broad eraser cursor redesign, GraphDocument schema changes, renderer rewrite, retained API removal, or full whiteboard parity claim is authorized. |
+| #230 | `avalonia-node-map-bck` | Phase 556: whiteboard primitive persistence implementation decision | P4 | persistence implementation decision, schema/version evidence, workspace and clipboard boundaries | Depends on Phase 555. Revisits persisted whiteboard primitive state only after authoring/eraser behavior; no pointer coordinator redesign, toolbar redesign, eraser implementation, renderer rewrite, unrelated GraphDocument cleanup, or full whiteboard parity claim. |
 
 ## Recommended Parallel Worktree Plan
 
@@ -646,8 +658,14 @@ Phase 550 records the whiteboard primitive Cookbook screenshot implementation ga
 - `docs/phase-546-post-whiteboard-queue`: owns #215 / `avalonia-node-map-0l9`; current stacked docs/test queue refresh after the Phase 545 proof-route gate, with no runtime/API/model/schema/renderer/screenshot-manifest changes.
 - `feature/phase-547-whiteboard-primitive-model-skeleton`: owns #217 / `avalonia-node-map-rs0`; current stacked implementation worktree for the internal whiteboard primitive model skeleton after Phase 546, with renderer adapters, persistence/schema, pointer coordinators, screenshot manifests, toolbar UX, eraser behavior, and public API claim expansion out of scope.
 - `feature/phase-548-whiteboard-renderer-adapter-skeleton`: owns #219 / `avalonia-node-map-10p`; current stacked implementation worktree for the internal renderer-neutral whiteboard primitive renderer adapter and topmost primitive hit-testing proof after the Phase 547 model skeleton, with persistence/schema, pointer coordinators, toolbar, eraser, screenshot manifests, and Cookbook implementation out of scope.
-- `feature/phase-549-whiteboard-persistence-decision`: future candidate for the first persistence decision implementation gate after model ownership is settled.
-- `visual/phase-550-whiteboard-cookbook-screenshot-implementation`: future candidate for the Cookbook screenshot implementation gate after model, renderer, and persistence decisions.
+- `feature/phase-549-whiteboard-persistence-decision`: owns #221 / `avalonia-node-map-3l6`; current stacked implementation gate for the separate annotation-surface persistence decision after the renderer adapter skeleton.
+- `visual/phase-550-whiteboard-cookbook-screenshot-implementation`: owns #223 / `avalonia-node-map-wjr`; current stacked visual proof gate for the whiteboard primitive Cookbook route/state pair after the persistence decision.
+- `docs/phase-551-whiteboard-authoring-queue`: owns #225 / `avalonia-node-map-3c9`; current stacked docs/test queue refresh after Phase 550, with no runtime/API/pointer/toolbar/eraser/persistence/renderer/screenshot-manifest changes.
+- `feature/phase-552-whiteboard-tool-activation`: owns #226 / `avalonia-node-map-718`; future activation-contract worktree after Phase 551.
+- `feature/phase-553-whiteboard-pointer-capture`: owns #227 / `avalonia-node-map-9f0`; future pointer gesture capture worktree after Phase 552.
+- `visual/phase-554-whiteboard-authoring-cookbook`: owns #228 / `avalonia-node-map-kpy`; future hosted authoring toolbar and Cookbook UX worktree after Phase 553.
+- `feature/phase-555-whiteboard-eraser-behavior`: owns #229 / `avalonia-node-map-71c`; future eraser-on-primitive behavior worktree after Phase 554.
+- `feature/phase-556-whiteboard-persistence-decision`: owns #230 / `avalonia-node-map-bck`; future persistence implementation decision worktree after Phase 555.
 
 ## UI Verification Policy
 
@@ -714,4 +732,5 @@ Current coverage includes scene-level route captures plus ten manifest-driven fu
 - Phase 548 is GitHub #219 / `avalonia-node-map-10p`; it records `WHITEBOARD_PRIMITIVE_RENDERER_ADAPTER_SKELETON` with internal Core renderer-neutral projection and hit-testing tests only. GraphDocument schema changes, public drawing API, Avalonia renderer rewrites, NodeCanvasConnectionSceneRenderer edits, pointer coordinators, toolbar/tool activation, eraser behavior, persistence/schema work, screenshot manifests, Cookbook visual proof, retained API removal, and full React Flow whiteboard parity remain out of scope.
 - Phase 549 is GitHub #221 / `avalonia-node-map-3l6`; it records `WHITEBOARD_PRIMITIVE_PERSISTENCE_DECISION_GATE` with the internal `GraphWhiteboardPrimitivePersistenceDecision` policy contract only. GraphDocument schema changes, schema version bumps, workspace persistence behavior changes, public drawing APIs, pointer coordinators, toolbar/tool activation, eraser behavior, screenshot manifest expansion, UI redesign, retained API removal, and full React Flow whiteboard parity remain out of scope.
 - Phase 550 is GitHub #223 / `avalonia-node-map-wjr`; it records `WHITEBOARD_PRIMITIVE_COOKBOOK_SCREENSHOT_GATE` with `cookbook-whiteboard-primitive-screenshot-proof`, `shell-cookbook-whiteboard-primitive-screenshot-proof`, route metadata, shell state, non-overlap visual proof, and `WHITEBOARD_PRIMITIVE_SCREENSHOT_GATE_OK` only. Public drawing APIs, pointer coordinators, toolbar work, eraser behavior, persisted whiteboard primitive state, GraphDocument schema changes, renderer rewrites, UI redesign, retained API removal, and full React Flow whiteboard parity remain out of scope.
-- Product code remains out of scope for Phase 478, Phase 484, Phase 490, Phase 491, Phase 492, Phase 493, Phase 494, Phase 495, Phase 497, Phase 498, Phase 499, Phase 500, Phase 501, Phase 502, Phase 503, Phase 504, Phase 505, Phase 506, Phase 507, Phase 508, Phase 509, Phase 510, Phase 511, Phase 512, Phase 513, Phase 520, Phase 521, Phase 522, Phase 523, Phase 524, Phase 525, Phase 526, Phase 527, Phase 528, Phase 529, Phase 535, Phase 539, Phase 540, Phase 541, Phase 546, and Phase 550 unless a focused test proves a specific missing contract.
+- Phase 551 is GitHub #225 / `avalonia-node-map-3c9`; it records `WHITEBOARD_AUTHORING_INTERACTION_QUEUE_REFRESH` and splits the next whiteboard authoring work into Phase 552 public drawing tool activation, Phase 553 pointer gesture capture, Phase 554 authoring toolbar/Cookbook UX, Phase 555 eraser-on-primitive behavior, and Phase 556 persistence implementation decision without implementing those behaviors.
+- Product code remains out of scope for Phase 478, Phase 484, Phase 490, Phase 491, Phase 492, Phase 493, Phase 494, Phase 495, Phase 497, Phase 498, Phase 499, Phase 500, Phase 501, Phase 502, Phase 503, Phase 504, Phase 505, Phase 506, Phase 507, Phase 508, Phase 509, Phase 510, Phase 511, Phase 512, Phase 513, Phase 520, Phase 521, Phase 522, Phase 523, Phase 524, Phase 525, Phase 526, Phase 527, Phase 528, Phase 529, Phase 535, Phase 539, Phase 540, Phase 541, Phase 546, Phase 550, and Phase 551 unless a focused test proves a specific missing contract.