Workshop → Miro (Top Mode vNext)

Goal

Produce a workshop output on Miro that is:

• readable as a diagram (not “scattered post-its”)
• easy to edit (real containers)
• idempotent (no duplicates)
• correctable (undo / delete / update)

Security (mandatory)

• Never print MIRO_ACCESS_TOKEN
• Use only env vars: MIRO_ACCESS_TOKEN and MIRO_BOARD_ID
• Never use browser cookies/session tokens

Key rule: a container = a FRAME (not a shape)

A “workshop container” must be a FRAME when:

• there is a large rectangle/square with a clear title (e.g., “Easy vision”, “Milestone”, “VMS”, “Data Hub”, “Vico Insider”)
• or there is a swimlane/column with a title
• or a box is clearly grouping multiple elements (stickies or sub-boxes)

Do NOT create a frame if:

• it’s just blank space without a title
• it’s only a decorative border without grouping meaning

HARD REQUIREMENT (do not violate)

• You MUST create frames[] when the board contains categories/areas.
• You MUST assign a non-null frameId to each sticky (except explicit "outside notes").
• If frames[] is empty OR if >10% stickies have frameId=null:
  • DO NOT run the push command.
  • Regenerate the structure (max 2 attempts).

Quality Gate — Container sanity check (mandatory)

If the image contains >=2 titled containers:

• frames.length MUST be >= 2
• at least 95% of stickies MUST have a non-null frameId If not satisfied:
• DO NOT push
• Regenerate structure (max 2 attempts)

Mandatory planning (do not print)

Before generating JSON and before running DIRECT PUSH:

1. Identify candidate FRAMES:
   • any large rectangle with a title
   • any area labeled on the side or centered above/below
2. Assign every sticky to a candidate frame.
3. If a sticky is ambiguous, add a warning and assign it to the closest/most plausible frame.
4. Only after that, generate the final JSON.

Quality Gate (mandatory)

Before executing `node ...