@marver-design/marver 0.26.0 → 0.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/CHANGELOG.md +158 -0
  2. package/README.md +10 -5
  3. package/dist/{anchor-check-Dg5xpNnU.mjs → anchor-check-ChdDqL5z.mjs} +1 -1
  4. package/dist/{audio-CmSRYFEs.mjs → audio-Dw1lfMdb.mjs} +14 -0
  5. package/dist/{bake-DtVlm0_F.mjs → bake-DM_uWgAA.mjs} +1 -1
  6. package/dist/{boards-DYG22tOe.mjs → boards-DlTcpF47.mjs} +1 -1
  7. package/dist/{build-C_gUgcdC.mjs → build-DZnFysGU.mjs} +4 -4
  8. package/dist/{capture-CrqvU_jh.mjs → capture-vadKjuCo.mjs} +2 -1
  9. package/dist/cli.mjs +28 -16
  10. package/dist/{comments-BqXua-XL.mjs → comments-DxOkCSNE.mjs} +4 -4
  11. package/dist/{daemon-DZo6o3rU.mjs → daemon-BSA0lV8d.mjs} +400 -274
  12. package/dist/detect-C0wpaePX.mjs +125 -0
  13. package/dist/dev-eQJhWsqg.mjs +1273 -0
  14. package/dist/dev-lock-C_FC70Mu.mjs +65 -0
  15. package/dist/exclusive-B1RtpeeP.mjs +150 -0
  16. package/dist/{init-D8DtrK_F.mjs → init-COD0x48i.mjs} +5 -3
  17. package/dist/{link-BNzLvdhI.mjs → link-DDXZVGtv.mjs} +20 -8
  18. package/dist/ls-D7O1G505.mjs +38 -0
  19. package/dist/{marks-NQi0wZJ4.mjs → marks-CWM3WJjc.mjs} +1 -1
  20. package/dist/perf-BWzQwZqj.mjs +369 -0
  21. package/dist/perf-BoDSkbEb.mjs +429 -0
  22. package/dist/perf-jam-D55U3FZK.mjs +242 -0
  23. package/dist/{plugin-CTD0rydA.mjs → plugin-C-E7omsh.mjs} +425 -66
  24. package/dist/{poster-ChjXGTS5.mjs → poster-Bx83ZYVK.mjs} +2 -1
  25. package/dist/{profile-WU9qcbIo.mjs → profile-Bh5Y5zpW.mjs} +1 -1
  26. package/dist/{publish-bakes-CEP_2NRc.mjs → publish-bakes-aljgm45S.mjs} +2 -2
  27. package/dist/{queue-BuiCKSX1.mjs → queue-CAM_vNmX.mjs} +3 -3
  28. package/dist/recover-t9Pno3u9.mjs +66 -0
  29. package/dist/{session-qZWKt_VA.mjs → session-BAaJsK5c.mjs} +1 -1
  30. package/dist/{share--oFJ1bCI.mjs → share-W5H3BNvP.mjs} +1 -1
  31. package/dist/shot-DoHLl6ig.mjs +139 -0
  32. package/dist/{shot-DqcxJibP.mjs → shot-LFhC-WYD.mjs} +343 -19
  33. package/dist/slots-DCDo3N0x.mjs +471 -0
  34. package/dist/speech-worker.mjs +40 -5
  35. package/dist/{sync-DKk-yT1V.mjs → sync-BQVlHZpx.mjs} +4 -3
  36. package/dist/{work-F5u-twpJ.mjs → work-Bp1p39kq.mjs} +4 -2
  37. package/dist/{work-VvX_JIgl.mjs → work-BroFwnup.mjs} +4 -2
  38. package/docs/boards-and-folders.md +3 -1
  39. package/docs/jam-session.md +78 -7
  40. package/docs/live-jam.md +8 -0
  41. package/docs/performance.md +262 -0
  42. package/package.json +2 -2
  43. package/src/client/content/index.tsx +3 -0
  44. package/src/client/content/video.tsx +6 -2
  45. package/src/client/frame-host/bridge.js +22 -6
  46. package/src/client/frame-host/inspect.js +8 -3
  47. package/src/client/frame-host/keys.js +6 -2
  48. package/src/client/frame-host/main.tsx +17 -5
  49. package/src/client/shell/App.tsx +188 -29
  50. package/src/client/shell/BoardList.tsx +5 -5
  51. package/src/client/shell/Comments.tsx +3 -2
  52. package/src/client/shell/JamSurface.tsx +13 -5
  53. package/src/client/shell/LockedApp.tsx +5 -5
  54. package/src/client/shell/Play.tsx +27 -15
  55. package/src/client/shell/Toolbar.tsx +17 -5
  56. package/src/client/shell/api.ts +206 -0
  57. package/src/client/shell/canvas/Canvas.tsx +30 -3
  58. package/src/client/shell/canvas/FrameNode.tsx +15 -5
  59. package/src/client/shell/canvas/admission.ts +8 -1
  60. package/src/client/shell/canvas/camera-broadcast.ts +15 -5
  61. package/src/client/shell/canvas/ctl.ts +2 -0
  62. package/src/client/shell/canvas/frame-registry.ts +28 -2
  63. package/src/client/shell/canvas/sleep.ts +4 -1
  64. package/src/client/shell/comments-store.ts +12 -4
  65. package/src/client/shell/goto.ts +22 -10
  66. package/src/client/shell/icons.tsx +2 -0
  67. package/src/client/shell/jam-capture.ts +96 -16
  68. package/src/client/shell/jam-keys.ts +51 -18
  69. package/src/client/shell/jam-lane.tsx +46 -5
  70. package/src/client/shell/jam-panel.tsx +66 -13
  71. package/src/client/shell/jam-queue.ts +3 -3
  72. package/src/client/shell/jam-session.tsx +14 -8
  73. package/src/client/shell/jam-state.ts +48 -6
  74. package/src/client/shell/jam-surface-parts.tsx +10 -6
  75. package/src/client/shell/jam-voice.ts +7 -5
  76. package/src/client/shell/legacy-links.ts +2 -2
  77. package/src/client/shell/main.tsx +4 -0
  78. package/src/client/shell/notes.ts +8 -1
  79. package/src/client/shell/perf.ts +69 -58
  80. package/src/client/shell/recorder-core.ts +183 -0
  81. package/src/client/shell/recorder.ts +565 -0
  82. package/src/client/shell/store.ts +268 -103
  83. package/src/client/shell/styles.css +54 -9
  84. package/src/client/stage/main.tsx +2 -0
  85. package/templates/AGENTS-embedded.md +22 -4
  86. package/templates/AGENTS-studio.md +22 -4
  87. package/templates/demo/dark.tsx +1 -1
  88. package/templates/demo/welcome.tsx +1 -1
  89. package/templates/instructions/jam.md +5 -3
  90. package/templates/instructions/welcome.md +6 -3
  91. package/dist/config-Cf7EjAMf.mjs +0 -292
  92. package/dist/dev-_Nlsc6v9.mjs +0 -742
  93. package/dist/dev-lock-DWSpa6nj.mjs +0 -179
  94. package/dist/perf-D6VmmJ2q.mjs +0 -68
  95. package/dist/perf-DPbLGhhO.mjs +0 -49
  96. package/dist/shot-CNbHoZ6H.mjs +0 -86
package/CHANGELOG.md CHANGED
@@ -2,6 +2,164 @@
2
2
 
3
3
  Notable changes to `@marver-design/marver`. Format follows [Keep a Changelog](https://keepachangelog.com); versions follow semver.
4
4
 
5
+ ## 0.27.0 - 2026-10-23
6
+
7
+ ### Highlights
8
+
9
+ - **Each canvas takes a slot: localhost:4805 to 4824.** `marver dev` no longer works its port out from the folder's
10
+ path (5200-5399). It takes one of twenty fixed ports - this project's last one when it is free, else the first free
11
+ one - so a project usually gets its address back. A port another program holds is skipped, and said; with all twenty
12
+ taken it stops before starting, lists them and says how to free one. A canvas that ran before says where it moved on
13
+ its first start: "ports are now fixed slots: this canvas is at http://localhost:4806/".
14
+ - **`npx marver ls`** lists the canvases running on this Mac - slot, link, name, version, state, uptime, folder - with
15
+ `--json` for agents (never a canvas's key). It needs no repo and leaves out a canvas that died without stopping; one
16
+ that has begun to stop shows `closing` and holds its slot until it has gone.
17
+ - **A tab left open can no longer write into another project.** A tab whose canvas had stopped kept talking to
18
+ whatever started next on its port, and could save its board into another project whose board file matched. Now every
19
+ request it makes, and every frame, play-stage and Jam-picture address, names its project, and another project
20
+ refuses them before reading or writing anything. The tab says what happened and the way back ("This canvas stopped -
21
+ run npx marver dev to bring it back"), and that your unsaved edits are kept in it when it holds some; comments and
22
+ Jam captures wait for the canvas. When its canvas answers again, the tab saves, then reloads on the view you had
23
+ once nothing is in progress (a capture, words not sent, a drag): "Back - your edits were saved". If the board's file
24
+ changed on disk meanwhile, the file wins, as it always has, and the tab's unsaved board edits are lost ("board
25
+ changed on disk - canvas layout reloaded"); a board renamed or removed meanwhile is not created again. Leaving a
26
+ stopped tab with unsaved board edits asks first.
27
+ - **`npx marver perf --loads`** says what each board load did, from the page: the time until the frames in view were
28
+ ready, until all were and until the board settled, or why the load was cut; how often the board moved and why; the
29
+ five slowest frames, each with its wait in the queue and its own time; errors, and frames that never answered or are
30
+ missing. `--json` for agents; plain `marver perf` adds a line per load. Its record (`design/.local/perf/page.jsonl`)
31
+ can hold file paths, so it stays on your machine; it costs nothing at rest ([Performance](docs/performance.md)).
32
+ - **Pictures work with Chrome 156.0.8078.47 and later.** That update made a headless page read as hidden when another
33
+ window covers it, and each picture has a window of its own, so a picture could wait on a paint that never came.
34
+ Marver's Chrome now runs every page as if seen (`marver shot`, agent pictures, copy as image, video posters, Jam).
35
+ - **Your agent keeps the canvas up.** A canvas an agent starts dies with its job (Claude Code stops a background job
36
+ after 10 minutes), and the link it gave you with it. The agent instructions now say: `npx marver ls` first; none
37
+ running, ask you to run `npx marver dev` in your own terminal; if it starts one, detached so it outlives it (output
38
+ in `design/.local/dev.log`), its link read from `npx marver ls`. Where a sandbox keeps the canvas from starting or
39
+ being reached, the agent asks you to run it; `marver shot`, `marks`, `ls` and `perf --loads` still work there.
40
+
41
+ ### Changed
42
+
43
+ - **A port you chose stays yours.** `--port <n>`, or a `port` in `design/config.ts` other than the scaffolded 5199, is
44
+ tried first, as before; when it is taken, the canvas takes a slot and says so. A port in 4805-4824 claims exactly
45
+ that slot: when something else holds it, `marver dev` stops and says what. A port from `design/config.ts` is named
46
+ as the canvas starts ("remove it to use the slots"); a new `design/config.ts` has it only as a commented example.
47
+ - **A start that fails leaves nothing behind.** Its lock, its slot, a half-made server and the watchers are given
48
+ back; it says what failed ("port 4806 was just taken by another program - start again", for one) and exits with 1.
49
+ - **`marver dev` says when it stops**: "canvas stopped - open tabs keep their edits and save when it is back".
50
+ - **One project key, the one 0.26 used.** Marver names a project by one key, made from the folder's real path - 0.26's
51
+ key for a canvas started with `npx marver dev` - so a capture waiting in a page keeps it; only the address moved.
52
+ - **Five viewer preferences are kept per project.** Your view theme, the update notice you closed, the mentions you
53
+ opened, which sticky notes show and which folders are folded were kept per address, shared by projects that ran
54
+ there in turn. A local canvas now keeps them per project at each address and carries them nowhere else: they start
55
+ fresh after the upgrade, and on a slot the canvas has not used before. A published canvas is unchanged.
56
+ - **No service workers on a local canvas**: an address is reused by whichever canvas starts there next, and a worker
57
+ would outlive its canvas. A PWA prototype shows its screens, not its offline behaviour.
58
+ - **`__mvPerf.report()` has new names:** `over33ms` (a count) and `over17ms` replace `dropped` and `droppedFrac`;
59
+ `longTask*` become `longFrame*`.
60
+ - **The frame-time sampler rests with the canvas:** it runs only during a pan, a zoom or a layout animation.
61
+
62
+ ### Added
63
+
64
+ - **`npx marver dev --recover`** starts a canvas on an address it ran on before - exactly its port, the address it
65
+ bound and the project key that run used, never another - so a Jam capture left unsent in that browser sends itself.
66
+ Alone it lists the last five addresses, newest first, then the one 0.26 gave the folder; `--recover <n>` starts on
67
+ one; `--recover --port <p>` on the port 0.26 moved to. A canvas whose slot was taken says where it ran last time,
68
+ which canvas runs there now, and that a tab still open there keeps its unsaved edits (and an unsent capture waits)
69
+ until this canvas runs there again: "stop "atlas" and this canvas, then `npx marver dev --recover 2`" ([A capture
70
+ left on an old address](docs/jam-session.md#a-capture-left-on-an-old-address)).
71
+ - **The document proof.** An app that opens the canvas page can check the page comes from that canvas: send
72
+ `x-mv-nonce`, get `x-mv-instance` and a signed `x-mv-proof` back. Without the header nothing changes.
73
+ - **`MARVER_HOME`** moves `~/.marver` - running canvases, slot preferences, collaboration credentials - and
74
+ `marver ls` reads it too. The speech model stays in `~/.marver/models` (`MARVER_MODELS` moves it).
75
+
76
+ ### Fixed
77
+
78
+ - **Editing `.env` no longer stops Live Jam.** Vite restarts the canvas's server in place when an `.env` file changes,
79
+ and 0.26 took that for a stop: Live Jam stopped, comments written from the terminal no longer reached the page at
80
+ once, and `marver shot`, `work` and `link` lost the canvas. Now only the server restarts.
81
+ - **A link, back or forward reads its board once**, not twice (each fires two browser events).
82
+ - **The demo frames show their bottom button whole**: `welcome` and `dark` ran past the frame and cut it off.
83
+ - **A frame's error card comes from the document it shows**: a late error from a document it replaced is ignored.
84
+ - **The dev server never serves `~/.marver`**, which holds the running canvases' keys and the collaboration
85
+ credentials - not even when your project's workspace root is your home folder.
86
+ - **In a sandbox, `marver dev` says why it cannot start.** Where every file watcher fails (`EMFILE` in Codex's
87
+ sandbox), it ended with Node's own error; it now says to ask the person to run `npx marver dev` in their own
88
+ terminal and exits with 1, leaving nothing behind - as when a watcher fails later.
89
+ - **A canvas out of reach is not "not running".** In a sandbox that keeps an agent off localhost, `marver link` said
90
+ the canvas was not running, an invitation to start a second one. When `design/.local/dev.json` names a process that
91
+ runs, `link` prints the link and says the canvas runs but cannot be reached from here; so do `work start` and
92
+ `work done`.
93
+ - **The perf logs are yours alone**: `design/.local/perf/` is mode 700 and its files 600, older ones included; at
94
+ start each log loses lines older than 14 days, and past 2 MB its oldest half (`page.jsonl` keeps 8 MB).
95
+
96
+ ### Upgrading
97
+
98
+ `npm install @marver-design/marver@latest`, then `npx marver init` to refresh the agent instructions (they find the
99
+ canvas with `npx marver ls`, ask you to start it in your own terminal or start it so it outlives them - never with a
100
+ port - and read `npx marver perf --loads`). **Before you upgrade**, open each canvas once in the browser you make
101
+ captures in, with its old version still running and Live Jam on: a capture left unsent there sends itself. One left
102
+ behind comes back with `npx marver dev --recover`. On its first start each canvas moves to a slot and says where; a
103
+ bookmark to its old address no longer reaches it (`marver ls` lists the new one). A `port` you set in
104
+ `design/config.ts` stays until you remove the line. The five viewer preferences start fresh. **Then close every tab a
105
+ 0.26 canvas opened** (send or save what they hold first) and open the canvas again from its new link: a page 0.26
106
+ served names no project in its requests, so the protection above - a stopped tab that never writes into another
107
+ project - covers pages loaded from 0.27 on, not those older tabs.
108
+
109
+ ## 0.26.1 - 2026-10-20
110
+
111
+ ### Fixed
112
+
113
+ - **Pictures are what the frame shows** ([#14](https://github.com/TNEP4/marver/issues/14),
114
+ [#24](https://github.com/TNEP4/marver/issues/24)). About one picture in thirty at 2x - and a very tall frame almost
115
+ every time - came back as the frame's top-left corner repeated across the image, with nothing to say it was wrong.
116
+ Headless Chrome copied its view before resizing it for the picture and tiled the old copy. Each picture now gets a
117
+ window of its own, and a fixed-size frame or a slide has its window sized to the picture first, so there is nothing
118
+ left to resize: in 900 pictures, none came back tiled (31 did before). Every picture - a tall content frame's too - is
119
+ also checked for that tiling; one that still shows it is taken again (a tall one at 1x if need be), and if it never
120
+ comes out right the shot fails instead of shipping a wrong picture. This covers `marver shot`, your agent's
121
+ pictures, copy as image, video posters and Jam's before and after pictures.
122
+ - **Content frames keep their diagrams** ([#7](https://github.com/TNEP4/marver/issues/7)). A state, sequence, gantt or
123
+ pie diagram - or a first `Md` - could fail with "Failed to fetch dynamically imported module" until `marver dev`
124
+ restarted. Another Vite server on the same project (your app's own, for one) was replacing the files the canvas had
125
+ prepared. The canvas now keeps its own folder for them, `node_modules/.vite-marver`. The first chart frame also loads
126
+ much faster: its chart library is prepared up front (about 40 requests instead of 600).
127
+ - **A capture outlives its page.** Closing or reloading the tab while a capture was recording or finishing used to
128
+ lose it. Now it is kept as it stood - with your notes, and a line saying the page closed before it finished - and
129
+ comes back as a draft to read, resume or drop. It never goes to your agent on its own, even with
130
+ `jam: { capture: "at-once" }`.
131
+ - **`marver shot` works inside a sandbox.** An agent whose sandbox blocks the network (Codex) could not reach the
132
+ canvas and said it could not look at its work. The command now takes the same picture through the canvas's file
133
+ inbox when it cannot connect, with the same output.
134
+
135
+ ### Added
136
+
137
+ - **`npx marver perf --jam`** shows how long each step of Jam takes on your machine - a capture sealing, its pictures,
138
+ your words, naming, the queue, your agent, the pictures before and after, the reply - with the median, the slowest
139
+ and anything that went wrong lately. It reads `design/.local/perf/jam.jsonl`: numbers and fixed codes only, never
140
+ your words, kept on your machine.
141
+
142
+ ### Changed
143
+
144
+ From a first long real Jam session:
145
+
146
+ - **Review shows before and after at once.** Side by side for a tall frame (a phone), one above the other for a wide
147
+ one (a laptop), and the panel grows as wide as that takes, up to the window. **Both · Before · After** shows one
148
+ alone; `B` steps through them.
149
+ - **The lane stays readable when full.** Its tiles lost their frosted blur exactly when the lane scrolled (its edge
150
+ fades cut them off from what was behind); the fades are now strips of their own, and the tiles a touch more opaque.
151
+ - **Done captures fold into one tile.** With two or more done, one **Done** tile - "4 captures · 6 frames changed" -
152
+ keeps the lane for what still needs you. Click it (or `⏎` with `Q`) to open them, a collapse tile folds them back.
153
+ - **The laser is a pointer.** `L` now lights only the element under the cursor, as comment mode does; a click still
154
+ copies its path (or, in a capture, is its pick). The old laser, every element outlined, is **inspect**: `⌥L`, or
155
+ ⌥-click the laser button. `Esc` turns a laser off before it closes or drops anything.
156
+
157
+ ### Upgrading
158
+
159
+ `npm install @marver-design/marver@latest`, then `npx marver init` to refresh the agent instructions (a sandboxed agent
160
+ now knows `marver shot` reaches the canvas through the file inbox). The first `marver dev` after the upgrade prepares
161
+ its new `node_modules/.vite-marver` folder (a moment, once).
162
+
5
163
  ## 0.26.0 - 2026-10-20
6
164
 
7
165
  ### Added
package/README.md CHANGED
@@ -8,14 +8,14 @@
8
8
 
9
9
  Screens, prototypes, specs, and now slide decks - all real code, all on one canvas, all shareable with people who sign in as themselves.
10
10
 
11
- [marver.design](https://marver.design) · [Boards and folders](docs/boards-and-folders.md) · [Context](docs/context.md) · [Slides](docs/slides.md) · [Sticky notes](docs/sticky-notes.md) · [Live Jam](docs/live-jam.md) · [Jam sessions](docs/jam-session.md) · [Deploying a canvas](docs/publish.md) · [Sharing](docs/sharing.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/TNEP4/marver/issues)
11
+ [marver.design](https://marver.design) · [Boards and folders](docs/boards-and-folders.md) · [Context](docs/context.md) · [Slides](docs/slides.md) · [Sticky notes](docs/sticky-notes.md) · [Live Jam](docs/live-jam.md) · [Jam sessions](docs/jam-session.md) · [Performance](docs/performance.md) · [Deploying a canvas](docs/publish.md) · [Sharing](docs/sharing.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/TNEP4/marver/issues)
12
12
 
13
13
  ## Quickstart
14
14
 
15
15
  ```bash
16
16
  npm i -D @marver-design/marver
17
17
  npx marver init # scaffolds design/ (detects shadcn, Tailwind, your router)
18
- npx marver dev # canvas at localhost:5199 (npx marver canvas works too - same thing)
18
+ npx marver dev # the canvas, on a free slot (localhost:4805-4824) - it prints the link (npx marver canvas works too)
19
19
  ```
20
20
 
21
21
  Then, to your agent:
@@ -77,7 +77,7 @@ Publish a deck with `{ "boards": { "pitch": { "max": "read", "type": "slides", "
77
77
  ## Collaboration
78
78
 
79
79
  - **Comments.** Google-Docs-style feedback pinned to actual elements. Press `c`, click a div inside a frame, write - the thread lives on that element and survives edits via a layered anchor (source semantics → structure → fuzzy text). Type `@` to mention someone who can already see the canvas; they get a mail with the comment and a link that lands on the thread, and the mention pulses its pin in their canvas with an in-app notification. A reply mails the thread's other participants, throttled per person and thread; anyone can mute a canvas's mail. `marver dev` syncs the same threads into `design/comments/*.jsonl`, where your agent works the queue: `npx marver comments list --open --json` → fork a variant → `resolve --addressed-in`. Live via SSE; one deploy, no extra services.
80
- - **Laser mode.** Press `l`: every element in every frame gets depth-hued outlines plus a hover label - the fastest way to see structure. Click any element to copy its full address (frame file + CSS path) for the agent. (On a published canvas, laser needs `"reveal": { "source": true }` in `publish.json` - source paths go opaque by default.)
80
+ - **Laser mode.** Press `l`: the element under your cursor lights up with a label naming it and its source. Click it to copy its full address (frame file + CSS path) for the agent. `⌥L` is the inspect laser: every element in every frame gets depth-hued outlines - the fastest way to see structure. (On a published canvas, laser needs `"reveal": { "source": true }` in `publish.json` - source paths go opaque by default.)
81
81
  - **Publishing.** `npx marver build` exports a static canvas (default-closed: `design/publish.json` names what ships, each board's ceiling - `read` or `comment` - and, since 0.12, its **type** and **landing view**: `{ "max", "type": "doc" | "slides" | "design" | "sketch" | "refs" | "mix", "open": "canvas" | "board" | "present" | "focus" | "slides", "lock": true }`); `npx marver serve` hosts it. One deploy on Railway, Docker, or any static host - the [publishing guide](docs/publish.md) has the one-pagers.
82
82
  - **Sharing, person by person.** On a canvas with a persistent volume, `marver share add sam@acme.com --role comment` (or the browser's share dialog) grants one person access, `@acme.com` grants a domain, `general private|password|public` sets the floor, and a refused visitor can ask to get in - approve from the terminal. One resolver answers "what can this person do here", and `marver share explain <email>` shows its reasoning. The [sharing guide](docs/sharing.md) has the whole surface.
83
83
 
@@ -106,7 +106,9 @@ The same glow, driven from the terminal. When your agent takes a request, it cre
106
106
  | Command | What it does |
107
107
  |---|---|
108
108
  | `npx marver init [--kind product\|knowledge]` | Scaffold `design/` in this repo (safe to re-run; refreshes managed files); a fresh canvas gets the kind's typed folders |
109
- | `npx marver dev` / `canvas` | Start the local canvas - hot reload, comments, Live Jam armed (`--port`, default 5199) |
109
+ | `npx marver dev` / `canvas` | Start the local canvas - hot reload, comments, Live Jam armed. It takes a free slot, localhost:4805-4824, usually the same one next time, and prints its link (`--port <n>`: a port of its own) |
110
+ | `npx marver ls [--json]` | The canvases running on this Mac: slot, link, name, version, state, uptime, folder - no repo needed |
111
+ | `npx marver dev --recover [n]` | Start the canvas on an address it ran on before, so a Jam capture left unsent in that browser sends itself; alone it lists them ([Jam sessions](docs/jam-session.md#a-capture-left-on-an-old-address)) |
110
112
  | `npx marver build` | Static export → `design/.dist`; what ships comes from `design/publish.json` (default-closed) |
111
113
  | `npx marver serve` | Serve the export; `MARVER_ID_ISSUER` or `MARVER_PASSWORD` gates it, `MARVER_DATA_DIR` persists comments + accounts |
112
114
  | `npx marver share …` | The roster (owner): `add <who> [--role]` · `remove` · `block` / `unblock` · `general <mode>` · `list` · `requests` · `explain <who>` · `who` |
@@ -114,11 +116,14 @@ The same glow, driven from the terminal. When your agent takes a request, it cre
114
116
  | `npx marver work …` | Working glow from the terminal: `start <scene/frame …>` · `done … \| --all` (prints the canvas link) · `list` |
115
117
  | `npx marver link <scene/frame \| scene ...>` | The canvas link that lands on those frames - their board, selected and in view (needs `dev` running) |
116
118
  | `npx marver shot <frame ...> \| --scene <name> \| --all [--scale 1-4] [--json]` | Render frames headless and print the PNG paths (needs `dev` running); a scene is one browser, several frames at a time; 2x by default |
119
+ | `npx marver perf [--loads \| --jam] [--json]` | What the canvas did lately: each edit's reloads; `--loads` each board load (time to settled, how many moves and why, the slowest frames, errors); `--jam` Jam's timings ([Performance](docs/performance.md)) |
117
120
  | `npx marver boards [--json]` | The sidebar as the files say it is: folders and sub-folders, boards in reading order with their title, type, status, `order` and description, the landing board; a board file that is not valid JSON says why, with line and column |
118
121
  | `npx marver boards new <name> [--folder f] [--type t]` | A board in its type's starting layout - a feature's spec, lo-fi and hi-fi bands, a start board rendering `context/` |
119
122
  | `npx marver folders add <module ...>` | Add a typed folder: `start`, `features`, `surfaces`, `projects`, `feedback`, `context`, `decks`, `archive` |
120
123
  | `npx marver context init \| check \| index` | Set up `context/`; check it (exit 0 / 1 / 2; `--base`, `--body-file` for a pull request); regenerate the index's capability table |
121
124
 
125
+ **Where the canvas runs.** Each canvas on your Mac takes one of twenty fixed ports, localhost:4805 to localhost:4824 - usually the same one each time - and prints its link; `npx marver ls` lists them all. `--port <n>`, or a `port` in `design/config.ts` (other than the old 5199), gives a canvas a port of its own instead. Because an address is reused by whichever canvas starts there next, a tab left open after its canvas stopped says so, and how to bring it back, and keeps your unsaved edits until its own canvas is back, and a local canvas runs no service workers.
126
+
122
127
  ## Shortcuts
123
128
 
124
129
  **Canvas** - two-finger scroll pans · pinch or ctrl/cmd+scroll zooms · space+drag pans from anywhere · click empty canvas deselects / exits interact.
@@ -134,7 +139,7 @@ The same glow, driven from the terminal. When your agent takes a request, it cre
134
139
 
135
140
  **Where to look** - `u` goes to the next frame that needs you (an orange question bubble), then the next new one (blue) - see [what is new, what needs you](docs/boards-and-folders.md#what-is-new-what-needs-you).
136
141
 
137
- **Modes** - `c` comment mode · `l` laser mode · `⇧C` hide/show comment pins · `⇧L` laser comment (spotlight a thread's element) · `p` play (present, or slides on a slides board) · `h` hide all chrome.
142
+ **Modes** - `c` comment mode · `l` laser · `⌥L` inspect laser · `⇧C` hide/show comment pins · `⇧L` laser comment (spotlight a thread's element) · `p` play (present, or slides on a slides board) · `h` hide all chrome.
138
143
 
139
144
  **In play** - `←` `→` step (Space and click advance a deck) · `[` `]` cycle variants · `d` cycles the theme · digits pick a device, the digit after your last one fills the window · `esc` exits, unless the board is locked to that view.
140
145
 
@@ -1,4 +1,4 @@
1
- import { MOUNTED, frameUrl, manifestFrame, planShot, withBrowser } from "./shot-DqcxJibP.mjs";
1
+ import { MOUNTED, frameUrl, manifestFrame, planShot, withBrowser } from "./shot-LFhC-WYD.mjs";
2
2
  //#region src/server/anchor-check.ts
3
3
  /**
4
4
  * The anchor check (spec 26, Part 6): `comments new --on|--at`, `comments move` and a Live Jam re-pin
@@ -96,7 +96,21 @@ function createSpeech(opts = {}) {
96
96
  }
97
97
  };
98
98
  w.on("message", (m) => {
99
+ if (m?.type === "timing") {
100
+ try {
101
+ opts.onTiming?.({
102
+ audioMs: m.audioMs,
103
+ waitMs: m.waitMs,
104
+ decodeMs: m.decodeMs,
105
+ backlogMs: m.backlogMs
106
+ });
107
+ } catch {}
108
+ return;
109
+ }
99
110
  if (m?.type === "ready") {
111
+ if (typeof m.modelLoadMs === "number") try {
112
+ opts.onTiming?.({ modelLoadMs: m.modelLoadMs });
113
+ } catch {}
100
114
  if (worker && worker !== w) {
101
115
  w.terminate();
102
116
  settle(worker);
@@ -1,4 +1,4 @@
1
- import { AREA, SURFACE, pool, shotConcurrency, withBrowser } from "./shot-DqcxJibP.mjs";
1
+ import { AREA, SURFACE, pool, shotConcurrency, withBrowser } from "./shot-LFhC-WYD.mjs";
2
2
  import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, utimesSync, writeFileSync } from "node:fs";
3
3
  import { join, sep } from "node:path";
4
4
  import { createHash } from "node:crypto";
@@ -2,7 +2,7 @@ import { r as NAME } from "./cli.mjs";
2
2
  import { a as checkRealDirs, d as readMembership, f as readRegistry, i as checkBoardsDir, n as addFolders, r as boardFields, s as listBoardFiles, u as pinFrames } from "./boards-CGg6piKF.mjs";
3
3
  import { T as readCapability, a as buildTree, b as FOLDER_MODULES, c as folderMap, f as isBoardName, k as resolveType, o as flatten, u as humanize, v as BOARD_TYPES, w as knownType } from "./board-tree-DRioF94d.mjs";
4
4
  import { _ as STATUS_LABEL, d as annotateBoards, h as PHASE_LABEL, s as scanFrames } from "./manifest-Nl3KSVOk.mjs";
5
- import { resolveTargets } from "./link-BNzLvdhI.mjs";
5
+ import { resolveTargets } from "./link-DDXZVGtv.mjs";
6
6
  import { existsSync, mkdirSync, writeFileSync } from "node:fs";
7
7
  import { join } from "node:path";
8
8
  //#region src/cli/boards.ts
@@ -3,8 +3,8 @@ import { f as readRegistry, i as checkBoardsDir, o as isRegularFile, r as boardF
3
3
  import { C as PROPOSED_PUBLISH, a as buildTree, f as isBoardName, l as framesOn, o as flatten, t as ALL_SCENES } from "./board-tree-DRioF94d.mjs";
4
4
  import { g as PUBLISHABLE, s as scanFrames, v as publishableStatus } from "./manifest-Nl3KSVOk.mjs";
5
5
  import { a as readLog, o as shareable, r as legacyExposure, t as appendEvents } from "./comments-0BSbb04K.mjs";
6
- import { n as loadConfig, r as detectHost } from "./config-Cf7EjAMf.mjs";
7
- import { a as autoWidthOf, c as readSizes, n as tailwind3Css, o as keptSizes, r as tailwind4Plugin, s as measuringFrames, t as marverPlugin } from "./plugin-CTD0rydA.mjs";
6
+ import { t as detectHost } from "./detect-C0wpaePX.mjs";
7
+ import { a as autoWidthOf, c as readSizes, l as loadConfig, n as tailwind3Css, o as keptSizes, r as tailwind4Plugin, s as measuringFrames, t as marverPlugin } from "./plugin-C-E7omsh.mjs";
8
8
  import { cpSync, existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs";
9
9
  import { basename, dirname, join, sep } from "node:path";
10
10
  import { fileURLToPath } from "node:url";
@@ -785,7 +785,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
785
785
  const realAssets = existsSync(assetsDir) ? realpathSync(assetsDir) : null;
786
786
  for (const r of refs) {
787
787
  if (!isLocalAssetRef(r) || !r.endsWith(".poster.png") || existsSync(join(assetsDir, r))) continue;
788
- const { ensurePoster } = await import("./poster-ChjXGTS5.mjs");
788
+ const { ensurePoster } = await import("./poster-Bx83ZYVK.mjs");
789
789
  const g = await ensurePoster(assetsDir, r.slice(0, -11));
790
790
  if (!g.ok) throw new Error(`design/assets/${r}: ${g.error}`);
791
791
  console.log(` poster: rendered design/assets/${r} (${g.width}×${g.height})`);
@@ -862,7 +862,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
862
862
  }));
863
863
  let textureLine = " textures: skipped (--no-textures)";
864
864
  if (textures && bakeGen) {
865
- const { bakePublished } = await import("./publish-bakes-CEP_2NRc.mjs");
865
+ const { bakePublished } = await import("./publish-bakes-aljgm45S.mjs");
866
866
  const pubFrameFile = new Map(pubFrames.map((f) => [f.id, f]));
867
867
  const r = await bakePublished({
868
868
  root,
@@ -544,7 +544,8 @@ function checkRecord(raw) {
544
544
  board: c.board,
545
545
  ...str(c.session, 200) ? { session: str(c.session, 200) } : {},
546
546
  ...reviewing ? { reviewing } : {},
547
- ...resumes ? { resumes } : {}
547
+ ...resumes ? { resumes } : {},
548
+ ...c.interrupted === true ? { interrupted: true } : {}
548
549
  },
549
550
  view: viewOf(r.view),
550
551
  timeline,
package/dist/cli.mjs CHANGED
@@ -82,31 +82,43 @@ cli.command("init", "Scaffold design/ in this repo").option("--mode <mode>", "st
82
82
  console.error(`[${NAME}] --kind ${opts.kind}: use product or knowledge`);
83
83
  process.exit(1);
84
84
  }
85
- const { init } = await import("./init-D8DtrK_F.mjs");
85
+ const { init } = await import("./init-COD0x48i.mjs");
86
86
  init(resolve$1(opts.root), {
87
87
  mode: opts.mode === "embedded" ? "embedded" : "studio",
88
88
  demo: opts.demo !== false,
89
89
  kind: opts.kind
90
90
  });
91
91
  });
92
- for (const [name, desc] of [["dev", "Start the local canvas (everything on: hot reload, comments, Live Jam)"], ["canvas", "Start the local canvas - same as dev"]]) cli.command(name, desc).option("--root <dir>", "Host repo root", { default: "." }).option("--port <port>", "Port (default 5199)").action(async (opts) => {
93
- const { dev, DevLockError } = await import("./dev-_Nlsc6v9.mjs");
92
+ for (const [name, desc] of [["dev", "Start the local canvas (everything on: hot reload, comments, Live Jam)"], ["canvas", "Start the local canvas - same as dev"]]) cli.command(name, desc).option("--root <dir>", "Host repo root", { default: "." }).option("--port <port>", "A port of its own (default: a free slot, localhost:4805-4824 - usually the same one next time; a port in that range takes exactly that slot)").option("--recover [n]", "Run on an address this canvas had before, where an unsent Jam capture waits: alone it lists them; with a number it starts on that one; --recover --port <p>: the port 0.26 used").action(async (opts) => {
93
+ const { dev, DevStartError, DevLockError } = await import("./dev-eQJhWsqg.mjs");
94
94
  let port;
95
95
  if (opts.port !== void 0) {
96
96
  const n = Number(opts.port);
97
97
  if (Number.isInteger(n) && n > 0 && n < 65536) port = n;
98
98
  else console.warn(`[${NAME}] ignoring invalid --port "${opts.port}"`);
99
99
  }
100
+ const onFail = (err) => {
101
+ console.error(`\n ${err.message}\n`);
102
+ process.exit(1);
103
+ };
100
104
  try {
101
- await dev(resolve$1(opts.root), port);
105
+ if (opts.recover !== void 0 && opts.recover !== false) await (await import("./recover-t9Pno3u9.mjs")).recoverCommand(resolve$1(opts.root), opts.recover, port, { onFail });
106
+ else await dev(resolve$1(opts.root), {
107
+ port,
108
+ onFail
109
+ });
102
110
  } catch (err) {
103
- if (!(err instanceof DevLockError)) throw err;
111
+ if (!(err instanceof DevStartError)) throw err;
104
112
  console.error(`\n ${err.message}\n`);
113
+ if (!(err instanceof DevLockError) && /^the canvas could not start/.test(err.message) && err.cause instanceof Error && err.cause.stack) console.error(err.cause.stack);
105
114
  process.exit(1);
106
115
  }
107
116
  });
117
+ cli.command("ls", "The canvases running on this Mac: slot, link, name, version, state, uptime, folder (no repo needed)").option("--json", "Machine-readable output (never a canvas's key)").action(async (opts) => {
118
+ (await import("./ls-D7O1G505.mjs")).lsCommand({ json: opts.json === true });
119
+ });
108
120
  cli.command("build", "Static export → design/.dist (what ships comes from design/publish.json - publishing is default-closed)").option("--boards <names>", "Publish only these boards (comma-separated); overrides the publish policy").option("--all-boards", "Publish every board - the loud override for the default-closed policy").option("--embed-seeds", "Copy comment history INTO the web root (identifying - every event carries its author's email)").option("--no-textures", "Skip compiling the glass textures the published frames rest under (needs Chrome; a CI without one skips on its own)").option("--root <dir>", "Host repo root", { default: "." }).action(async (opts) => {
109
- const { buildSite } = await import("./build-C_gUgcdC.mjs");
121
+ const { buildSite } = await import("./build-DZnFysGU.mjs");
110
122
  try {
111
123
  const boards = opts.boards === void 0 ? void 0 : typeof opts.boards === "string" ? opts.boards : "";
112
124
  await buildSite(resolve$1(opts.root), boards, opts.allBoards === true, opts.embedSeeds === true, opts.textures !== false && !process.env.MARVER_NO_TEXTURES);
@@ -125,7 +137,7 @@ cli.command("serve", "Serve design/.dist (set MARVER_PASSWORD to gate it)").opti
125
137
  serve(resolve$1(opts.root), port);
126
138
  });
127
139
  cli.command("comments <action> [value]", "Comment collaboration: connect <url> · sync · list · new <scene/frame> · reply <thread> · move <thread> · resolve <thread> · invite <email> · revoke <email>").option("--root <dir>", "Host repo root", { default: "." }).option("--token <token>", "connect: the canvas's MARVER_CLI_TOKEN (default $MARVER_CLI_TOKEN) - the identity-mode path").option("--invite <token>", "connect: claim this invite instead of signing in").option("--canvas-password <password>", "connect: the canvas gate password (default $MARVER_PASSWORD or prompt)").option("--email <email>", "connect: account email (skips the prompt)").option("--password <password>", "connect: account password (skips the prompt - mind your shell history)").option("--name <name>", "connect --invite: display name for the new account").option("--open", "list: only unresolved threads").option("--json", "list: machine-readable output").option("--board <board>", "list: scope to one board · new: the board to pin on (default: the one its link opens)").option("--body <text>", "new / reply: the text").option("--on <text>", "new / move: pin on the element showing these words").option("--at <selector>", "new / move: pin on the element this data-testid or CSS selector names (an element without words, like an icon)").option("--nth <n>", "new / move: which of several matching elements (1 = the first)").option("--viewport <name>", "new / move: check the frame at this viewport (default: its own)").option("--theme <name>", "new / move: check the frame in this theme (default: light)").option("--thread <id>", "new: add the note to this open thread instead of pinning a new one").option("--fyi", "new: the note asks nothing (default: it asks - it comes first for the human)").option("--ask", "reply: the reply asks the human something").option("--addressed-in <frame>", "resolve: the variant frame that answered the feedback").action(async (action, value, opts) => {
128
- const { commentsCommand } = await import("./comments-BqXua-XL.mjs");
140
+ const { commentsCommand } = await import("./comments-DxOkCSNE.mjs");
129
141
  try {
130
142
  await commentsCommand(resolve$1(opts.root), action, value, opts);
131
143
  } catch (err) {
@@ -134,7 +146,7 @@ cli.command("comments <action> [value]", "Comment collaboration: connect <url>
134
146
  }
135
147
  });
136
148
  cli.command("share <action> [value]", "Sharing roster (owner): add <who> · remove <who> · block/unblock <email> · general <mode> · list · requests · explain <who> · who").option("--root <dir>", "Host repo root", { default: "." }).option("--role <role>", "add / requests --approve: view (default) or comment").option("--expires <iso>", "add: expiry timestamp, e.g. 2026-12-31T00:00:00Z").option("--approve <email>", "requests: approve this pending request (canvas-wide in v1)").option("--decline <email>", "requests: decline this pending request (silent to the asker)").option("--json", "list: machine-readable output").action(async (action, value, opts) => {
137
- const { shareCommand } = await import("./share--oFJ1bCI.mjs");
149
+ const { shareCommand } = await import("./share-W5H3BNvP.mjs");
138
150
  try {
139
151
  await shareCommand(resolve$1(opts.root), action, value, opts);
140
152
  } catch (err) {
@@ -143,7 +155,7 @@ cli.command("share <action> [value]", "Sharing roster (owner): add <who> · remo
143
155
  }
144
156
  });
145
157
  cli.command("work <action> [...frames]", "Working state on the canvas: start <scene/frame ...> · done <scene/frame ...> | --all · list").option("--root <dir>", "Host repo root", { default: "." }).option("--ttl <minutes>", "start: minutes before the glow self-expires (default 10, max 30)").option("--all", "done: clear every working frame").action(async (action, frames, opts) => {
146
- const { workCommand } = await import("./work-VvX_JIgl.mjs");
158
+ const { workCommand } = await import("./work-BroFwnup.mjs");
147
159
  try {
148
160
  await workCommand(resolve$1(opts.root), action, frames ?? [], opts);
149
161
  } catch (err) {
@@ -152,7 +164,7 @@ cli.command("work <action> [...frames]", "Working state on the canvas: start <sc
152
164
  }
153
165
  });
154
166
  cli.command("link [...targets]", "The canvas link that lands on frames: link <scene/frame | scene ...> - their board, in canvas mode, selected and fitted").option("--root <dir>", "Host repo root", { default: "." }).option("--board <board>", "The board to open (default: the first board that shows them all, else one link per board)").action(async (targets, opts) => {
155
- const { linkCommand } = await import("./link-BNzLvdhI.mjs");
167
+ const { linkCommand } = await import("./link-DDXZVGtv.mjs");
156
168
  try {
157
169
  await linkCommand(resolve$1(opts.root), targets ?? [], opts);
158
170
  } catch (err) {
@@ -161,7 +173,7 @@ cli.command("link [...targets]", "The canvas link that lands on frames: link <sc
161
173
  }
162
174
  });
163
175
  cli.command("boards [action] [...args]", "The sidebar as files: every folder and board in reading order, with types and statuses, and the frames on no board · new <name>: a board in its type's starting layout · pin <board> <scene/frame ...>: put frames on a board").option("--root <dir>", "Host repo root", { default: "." }).option("--json", "The tree as JSON ({ tree, boards, landing, unplaced, registry })").option("--type <type>", "new: start | feature | surface | project | feedback | context | deck | archive (default: the folder's)").option("--folder <folder>", "new: the folder it sits in").option("--title <title>", "new: what humans see").option("--description <sentence>", "new: what agents read").option("--capability <slug>", "new: the capability it shows, when not its own name").action(async (action, args, opts) => {
164
- const { boardsCommand, boardsNew, boardsPin } = await import("./boards-DYG22tOe.mjs");
176
+ const { boardsCommand, boardsNew, boardsPin } = await import("./boards-DlTcpF47.mjs");
165
177
  const [name, ...frames] = args ?? [];
166
178
  try {
167
179
  if (action === void 0) boardsCommand(resolve$1(opts.root), opts);
@@ -183,7 +195,7 @@ cli.command("boards [action] [...args]", "The sidebar as files: every folder and
183
195
  }
184
196
  });
185
197
  cli.command("folders <action> [...modules]", "The shared sidebar's typed folders · add <start|features|surfaces|projects|feedback|context|decks|archive ...>").option("--root <dir>", "Host repo root", { default: "." }).action(async (action, modules, opts) => {
186
- const { foldersAdd } = await import("./boards-DYG22tOe.mjs");
198
+ const { foldersAdd } = await import("./boards-DlTcpF47.mjs");
187
199
  try {
188
200
  if (action !== "add") throw new Error(`unknown action "${action}" - \`folders add <module ...>\``);
189
201
  const { added, existing } = foldersAdd(resolve$1(opts.root), modules);
@@ -231,15 +243,15 @@ cli.command("context <action>", "The project's context/ (spec 19) · init: creat
231
243
  }
232
244
  });
233
245
  cli.command("marks", "What the human has not reviewed: frames waiting on them (the ones that ask first), their answers nothing has acted on yet, and frames new since they looked").option("--root <dir>", "Host repo root", { default: "." }).option("--json", "Machine-readable output").option("--all", "Also list the answers from before 0.26 that may already be handled").action(async (opts) => {
234
- const { marksCommand } = await import("./marks-NQi0wZJ4.mjs");
246
+ const { marksCommand } = await import("./marks-CWM3WJjc.mjs");
235
247
  marksCommand(resolve$1(opts.root), opts);
236
248
  });
237
- cli.command("perf", "The reload log: what each edit reloaded, page-wide reloads, the slowest frames to settle").option("--root <dir>", "Host repo root", { default: "." }).option("--minutes <n>", "How far back to read (default 60)").option("--json", "Machine-readable output").action(async (opts) => {
238
- const { perfCommand } = await import("./perf-D6VmmJ2q.mjs");
249
+ cli.command("perf", "The reload log: what each edit reloaded, page-wide reloads, the slowest frames to settle, one line per board load; --loads: what each board load did; --jam: Jam's timings").option("--root <dir>", "Host repo root", { default: "." }).option("--minutes <n>", "How far back to read (default 60; 24 h with --jam)").option("--loads", "Board loads, from the page: time to the visible frames ready, all ready, quiet, the last move and settled (or why it was cut, and how many frames were ready by then), how many moves and their causes, when the first frame started, the slowest frames and how long each waited for its turn to start, errors (design/.local/perf/page.jsonl)").option("--jam", "Jam's timings: captures, pictures, words, naming, runs, shots - numbers only (design/.local/perf/jam.jsonl)").option("--json", "Machine-readable output").action(async (opts) => {
250
+ const { perfCommand } = await import("./perf-BoDSkbEb.mjs");
239
251
  perfCommand(resolve$1(opts.root), opts);
240
252
  });
241
253
  cli.command("shot [...frames]", "Render frames headless and print the PNG paths (needs `dev` running): ids, --scene <name> or --all").option("--root <dir>", "Host repo root", { default: "." }).option("--scene <name>", "Every frame of one scene").option("--all", "Every frame of the canvas").option("--theme <name>", "Theme to render (default: light)").option("--scale <n>", "Device pixels per CSS px, 1-4 (default: 2; 4 for print-quality stills)").option("--json", "Print the results as JSON ({ results: [...] }) instead of paths").action(async (frames, opts) => {
242
- const { shotCommand } = await import("./shot-CNbHoZ6H.mjs");
254
+ const { shotCommand } = await import("./shot-DoHLl6ig.mjs");
243
255
  try {
244
256
  await shotCommand(resolve$1(opts.root), frames, opts);
245
257
  } catch (err) {
@@ -1,9 +1,9 @@
1
1
  import { r as NAME } from "./cli.mjs";
2
- import { i as readDevInfo } from "./work-F5u-twpJ.mjs";
2
+ import { i as readDevInfo } from "./work-Bp1p39kq.mjs";
3
3
  import { r as replay } from "./events-CLH4ijKP.mjs";
4
4
  import { a as readLog, i as listBoards, t as appendEvents } from "./comments-0BSbb04K.mjs";
5
- import { a as syncOnce, i as loadCollab, n as connectClaim, r as connectToken, t as connect } from "./sync-DKk-yT1V.mjs";
6
- import { n as localProfile } from "./profile-WU9qcbIo.mjs";
5
+ import { a as syncOnce, i as loadCollab, n as connectClaim, r as connectToken, t as connect } from "./sync-BQVlHZpx.mjs";
6
+ import { n as localProfile } from "./profile-Bh5Y5zpW.mjs";
7
7
  import { a as runningAgent } from "./agent-BsieQGTD.mjs";
8
8
  import { n as readTarget, r as uncheckedAnchor } from "./anchor-5H1vnoLu.mjs";
9
9
  import { join } from "node:path";
@@ -132,7 +132,7 @@ async function commentsCommand(root, action, value, opts) {
132
132
  case "new": {
133
133
  if (opts.thread !== void 0) return addToThread(root, String(opts.thread), value, opts);
134
134
  if (!value || !opts.body) throw new Error("usage: comments new <scene/frame> --body \"...\" --on \"<words it shows>\" | --at \"<selector or data-testid>\" [--nth <n>] [--fyi] [--board <board>]");
135
- const { resolveLink, devOrigin } = await import("./link-BNzLvdhI.mjs");
135
+ const { resolveLink, devOrigin } = await import("./link-DDXZVGtv.mjs");
136
136
  const r = resolveLink(root, [value], opts.board);
137
137
  if (r.exact.length !== 1) throw new Error(`"${value}" is a folder of frames - pin a note on one frame: comments new <scene/frame>`);
138
138
  if (!r.board) throw new Error(`a note needs a board to live on - ${r.hints.join("\n")}`);