Skip to content

Phase 564: whiteboard annotation migration and compatibility proof #252

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ExplodingUFO wants to merge 1 commit into
base: docs/phase-563-whiteboard-annotation-screenshot-cookbook-proof
Choose a base branch
from
Open

Phase 564: whiteboard annotation migration and compatibility proof #252

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions docs/en/phase-0-reactflow-parity-audit.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -278,6 +278,10 @@ Phase 559 is GitHub #241 / `avalonia-node-map-8ca`, the post-annotation-store co

Phase 563 is GitHub #245 / `avalonia-node-map-kri`, the whiteboard annotation screenshot and Cookbook proof expansion. It adds `WHITEBOARD_ANNOTATION_SCREENSHOT_COOKBOOK_PROOF_EXPANSION` as a docs/tests planning gate only: future implementation must define Cookbook route expectations, screenshot proof metadata, non-overlap requirements, and separation from persistence/serialization implementation before screenshot manifest expansion or any visual/demo route changes. This proof expansion keeps no screenshot manifest expansion, no new Cookbook route, no UI behavior change, no production annotation store, no file/database I/O, no GraphDocument schema change, no workspace persistence behavior change, no clipboard/export behavior change, no renderer or pointer behavior change, no public API exposure, no saved whiteboard primitive state, and no full React Flow whiteboard parity.

## Phase 564 Update

Phase 564 is GitHub #246 / `avalonia-node-map-vyg`, the whiteboard annotation migration and compatibility proof. It adds `WHITEBOARD_ANNOTATION_MIGRATION_COMPATIBILITY_PROOF` as a docs/tests planning gate only: future implementation must define annotation-store versions, primitive references, style/geometry payloads, migration metadata validation, and coverage required before persistence, clipboard/export, or screenshot proof expands. It depends on Phase 560, Phase 561, and Phase 562 after Phase 559. This proof gate keeps no production migration implementation, no persisted annotation state, no file/database I/O, no GraphDocument schema change, no schema version bump, no workspace persistence behavior change, no clipboard/export serialization behavior change, no screenshot manifest expansion, no renderer or pointer behavior change, no public API exposure, 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.
Expand Down Expand Up @@ -637,6 +641,8 @@ Phase 562 records the whiteboard annotation clipboard/export serialization bound

Phase 563 records the whiteboard annotation screenshot and Cookbook proof expansion through GitHub #245 / `avalonia-node-map-kri`. It adds `WHITEBOARD_ANNOTATION_SCREENSHOT_COOKBOOK_PROOF_EXPANSION` as a docs/tests planning gate only: future implementation must define Cookbook route expectations, screenshot proof metadata, non-overlap requirements, and separation from persistence/serialization implementation before screenshot manifest expansion or any visual/demo route changes. This proof expansion keeps no screenshot manifest expansion, no new Cookbook route, no UI behavior change, no production annotation store, no file/database I/O, no GraphDocument schema change, no workspace persistence behavior change, no clipboard/export behavior change, no renderer or pointer behavior change, no public API exposure, no saved whiteboard primitive state, and no full React Flow whiteboard parity.

Phase 564 records the whiteboard annotation migration and compatibility proof through GitHub #246 / `avalonia-node-map-vyg`. It adds `WHITEBOARD_ANNOTATION_MIGRATION_COMPATIBILITY_PROOF` as a docs/tests planning gate only: future implementation must define annotation-store versions, primitive references, style/geometry payloads, migration metadata validation, and coverage required before persistence, clipboard/export, or screenshot proof expands. It depends on Phase 560, Phase 561, and Phase 562 after Phase 559. This proof gate keeps no production migration implementation, no persisted annotation state, no file/database I/O, no GraphDocument schema change, no schema version bump, no workspace persistence behavior change, no clipboard/export serialization behavior change, no screenshot manifest expansion, no renderer or pointer behavior change, no public API exposure, and no 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. |
Expand Down Expand Up @@ -668,7 +674,7 @@ Phase 563 records the whiteboard annotation screenshot and Cookbook proof expans
| #243 | `avalonia-node-map-xd8` | Phase 561: whiteboard annotation workspace sidecar persistence policy | P4 | workspace/sidecar persistence policy docs and compatibility criteria | Depends on Phase 559. Owns a policy gate only for workspace sidecar ownership, workspace-scoped lifetime, sidecar file naming, migration metadata, compatibility requirements, and verification requirements before workspace save/load behavior changes; no production persistence implementation, file/database I/O, GraphDocument schema change, schema version bump, workspace persistence behavior change, clipboard/export serialization behavior change, screenshot manifest expansion, renderer or pointer behavior change, public API exposure, saved whiteboard primitive state, or full whiteboard parity claim. |
| #244 | `avalonia-node-map-0gi` | Phase 562: whiteboard annotation clipboard/export serialization boundary | P4 | clipboard/export serialization boundary docs and focused compatibility tests | Depends on Phase 559. Owns a boundary gate only for annotation identity/reference and primitive payload eligibility across clipboard fragments, scene export artifacts, and workspace sidecar persistence, with compatibility and migration proof required before serialization behavior changes; no production serialization implementation, clipboard/export behavior change, file/database I/O, GraphDocument schema change, schema version bump, workspace persistence behavior change, screenshot manifest expansion, renderer or pointer behavior change, public API exposure, saved whiteboard primitive state, or full whiteboard parity claim. |
| #245 | `avalonia-node-map-kri` | Phase 563: whiteboard annotation screenshot and Cookbook proof expansion | P4 | screenshot/Cookbook proof planning, route criteria, and non-overlap evidence requirements | Depends on Phase 559. Owns screenshot/Cookbook proof expansion planning only, including Cookbook route expectations, screenshot proof metadata, non-overlap requirements, and separation from persistence/serialization implementation before screenshot manifest expansion, renderer changes, or toolbar/eraser changes. No screenshot manifest expansion, no new Cookbook route, no UI behavior change, no production annotation store, no file/database I/O, no GraphDocument schema change, no workspace persistence behavior change, no clipboard/export behavior change, no renderer or pointer behavior change, no public API exposure, no saved whiteboard primitive state, or full whiteboard parity claim. |
| #246 | `avalonia-node-map-vyg` | Phase 564: whiteboard annotation migration and compatibility proof | P4 | migration/compatibility proof docs, schema policy criteria, and compatibility test plan | Depends on Phase 559 plus Phase 560, Phase 561, and Phase 562. Owns migration/compatibility proof planning only, before schema version bumps, GraphDocument schema changes, saved whiteboard primitive state, or full whiteboard parity claims. |
| #246 | `avalonia-node-map-vyg` | Phase 564: whiteboard annotation migration and compatibility proof | P4 | migration/compatibility proof docs, schema policy criteria, and compatibility test plan | Depends on Phase 559 plus Phase 560, Phase 561, and Phase 562. Owns migration/compatibility proof planning only for annotation-store versions, primitive references, style/geometry payloads, migration metadata validation, and coverage required before persistence, clipboard/export, or screenshot proof expands. No production migration implementation, persisted annotation state, file/database I/O, GraphDocument schema change, schema version bump, workspace persistence behavior change, clipboard/export serialization behavior change, screenshot manifest expansion, renderer or pointer behavior change, public API exposure, schema version bumps, saved whiteboard primitive state, or full whiteboard parity claims. |

## Recommended Parallel Worktree Plan

Expand Down Expand Up @@ -813,5 +819,5 @@ Current coverage includes scene-level route captures plus ten manifest-driven fu
- Phase 561 is GitHub #243 / `avalonia-node-map-xd8`; it records `WHITEBOARD_ANNOTATION_WORKSPACE_SIDECAR_PERSISTENCE_POLICY` as a docs/tests policy gate for workspace sidecar ownership, workspace-scoped lifetime, sidecar file naming, migration metadata, compatibility requirements, and verification requirements before workspace save/load behavior changes, while keeping no production persistence implementation, no file/database I/O, no GraphDocument schema change, no schema version bump, no workspace persistence behavior change, no clipboard/export serialization behavior change, no screenshot manifest expansion, no renderer or pointer behavior change, no public API exposure, no saved whiteboard primitive state, and no full React Flow whiteboard parity.
- Phase 562 is GitHub #244 / `avalonia-node-map-0gi`; it records `WHITEBOARD_ANNOTATION_CLIPBOARD_EXPORT_SERIALIZATION_BOUNDARY` as a docs/tests boundary gate for annotation identity/reference and primitive payload eligibility across clipboard fragments, scene export artifacts, and workspace sidecar persistence, with compatibility and migration proof required before serialization behavior changes, while keeping no production serialization implementation, no clipboard/export behavior change, no file/database I/O, no GraphDocument schema change, no schema version bump, no workspace persistence behavior change, no screenshot manifest expansion, no renderer or pointer behavior change, no public API exposure, no saved whiteboard primitive state, and no full React Flow whiteboard parity.
- Phase 563 is GitHub #245 / `avalonia-node-map-kri`; it records `WHITEBOARD_ANNOTATION_SCREENSHOT_COOKBOOK_PROOF_EXPANSION` as a docs/tests planning gate for Cookbook route expectations, screenshot proof metadata, non-overlap requirements, and separation from persistence/serialization implementation before screenshot manifest expansion. It keeps no screenshot manifest expansion, no new Cookbook route, no UI behavior change, no production annotation store, no file/database I/O, no GraphDocument schema change, no workspace persistence behavior change, no clipboard/export behavior change, no renderer or pointer behavior change, no public API exposure, no saved whiteboard primitive state, and no full React Flow whiteboard parity.
- Phase 564 is GitHub #246 / `avalonia-node-map-vyg`; it is queued for the whiteboard annotation migration/compatibility proof after Phase 559 and after the adapter, persistence policy, and serialization boundary decisions.
- Phase 564 is GitHub #246 / `avalonia-node-map-vyg`; it records `WHITEBOARD_ANNOTATION_MIGRATION_COMPATIBILITY_PROOF` as a docs/tests planning gate for annotation-store versions, primitive references, style/geometry payloads, migration metadata validation, and coverage required before persistence, clipboard/export, or screenshot proof expands. It depends on Phase 560, Phase 561, and Phase 562 after Phase 559, while keeping no production migration implementation, no persisted annotation state, no file/database I/O, no GraphDocument schema change, no schema version bump, no workspace persistence behavior change, no clipboard/export serialization behavior change, no screenshot manifest expansion, no renderer or pointer behavior change, no public API exposure, and no full React Flow whiteboard parity.
- 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, Phase 551, and Phase 557 unless a focused test proves a specific missing contract.
Loading
Loading