Interaction models¶
North Star: predictable and forgiving: the same gesture does the same thing everywhere, and nothing is silent or irreversible (SUB-21, SUB-28).
Worked patterns applied the same way across hosts, tools and agents (DEV-08). Each model is one short page: the requirements it cites, a Mermaid sequence diagram, and a pointer to its reference implementation. Where an interaction is already a requirement, the model cites it rather than restating it.
| Model | Written in | Status |
|---|---|---|
| Selection and tool offering | Phase 1 | Requirements gathered |
| Tool invocation and forms | Phase 1 | Requirements gathered |
| Unavailable capabilities | Phase 1 | Requirements gathered |
| Undo | Phase 2 | Written |
| Conflicts | Phase 2 | Written |
| Long-running operations | Phase 2 | Requirements gathered |
| Check overrides | Phase 2 | Requirements gathered |
| Time controller | Phase 3 | Written |
| Annotations | Phase 3 | Written (forms; drawing and editing on the map) |
| Track operations | Phase 3 | Written (part A: move, rotate, split, merge; part B1: shear, stretch; part B2: jumps, smoothing, marked fixes; part B3: single fixes, dead reckoning) |
| Labels, symbols and arrows | Phase 3 | Written (intervals per track, aligned to the clock as legacy Debrief; thinning; a fix's own label or symbol) |
| Tote | Phase 3 | Written (part A: primary and secondaries, the core measures, latency) |
| Timeline and narrative | Phase 3 | Written (part A: narrative entries, REP and .dpf import, the Timeline following current time, filter, search, editing, scale) |
| Sensors and bearings | Phase 4 | Written (sensors on their tracks and their cuts from REP, DSF, .dpf and Rider's narrative; cuts drawn in the window from the track; ambiguity resolved per cut or per period, one step each; the performance budget) |
| TMA solutions | Phase 4 | Written (a solution made from a period of a sensor's cuts, by form or by two clicks, one step; a track by dead reckoning tagged with its contact and rooted in its cuts; residuals after legacy's Stacked Dots, live while dragging, an ambiguous cut's other bearing faint; hidden cuts and cuts left out not counted; legs split at a time, each dragged on its own, the others staying put; legacy .dpf solutions) |
| Collation | Phase 3 | Written (coverage, platforms across items, source preference per period, new data, taking it, review flags) |
| Exported images | Phase 3 | Written (the map as an image with an ID naming the plot and the revision, the footer, the export log; finding an image's source, read-only) |
| Walkthroughs | Phase 3 | Written (five walkthroughs on fresh copies of the sample, Bearings and TMA the fifth, each step ticked by doing it; the same words in VS Code's Get Started page and the playground; the web demo) |
| Browser layout | Phase 3 | Written (the playground's and the web demo's panels docked in tab groups around the map, from 900 px; the top bar; remembered per browser; the side column narrower) |
| Keyboard equivalents | Phase 3 | Partly written (annotations, tracks, the Tote, the Timeline, collation, exported images, the browser's layout, sensor bearings, TMA) |
Analysts review the Phase 1 models before they are built.