@marver-design/marver 0.26.1 → 0.27.2

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 (109) hide show
  1. package/CHANGELOG.md +198 -0
  2. package/README.md +12 -4
  3. package/dist/{anchor-check-l-ny3UzH.mjs → anchor-check-gkxkPAIv.mjs} +1 -1
  4. package/dist/{board-tree-DRioF94d.mjs → board-tree-BXR8dw4b.mjs} +3 -1
  5. package/dist/{boards-CGg6piKF.mjs → boards-BHKP5yhI.mjs} +1 -1
  6. package/dist/{boards-DYG22tOe.mjs → boards-BqUqKNW8.mjs} +4 -4
  7. package/dist/{build-BDRiO_mP.mjs → build-VgNg4rr8.mjs} +8 -23
  8. package/dist/cli.mjs +45 -19
  9. package/dist/{collab-Dxg2trOK.mjs → collab-BEAcXrBb.mjs} +1 -1
  10. package/dist/{comments-BqXua-XL.mjs → comments-YEU1Zhv9.mjs} +4 -4
  11. package/dist/{context-HQ4Giw58.mjs → context-Ccjrhr1J.mjs} +3 -3
  12. package/dist/{daemon-DL6Fwq6D.mjs → daemon-Dc9AH0M3.mjs} +9 -7
  13. package/dist/detect-C0wpaePX.mjs +125 -0
  14. package/dist/dev-lock-C_FC70Mu.mjs +65 -0
  15. package/dist/dev-ri6nAlRp.mjs +1273 -0
  16. package/dist/exclusive-B1RtpeeP.mjs +150 -0
  17. package/dist/{init-D8DtrK_F.mjs → init-W0nxR1OY.mjs} +8 -6
  18. package/dist/{link-BNzLvdhI.mjs → link-CdTgn94Y.mjs} +23 -11
  19. package/dist/ls-BZ5TAtd5.mjs +38 -0
  20. package/dist/{manifest-Nl3KSVOk.mjs → manifest-aFyDmL8C.mjs} +2 -2
  21. package/dist/{marks-DyWMv_Z1.mjs → marks-BF9pNEgH.mjs} +3 -3
  22. package/dist/{marks-CKgzucHZ.mjs → marks-CnCCfAbD.mjs} +3 -3
  23. package/dist/{marver-id-gate-BjF6v4bT.mjs → marver-id-gate-D-R0hSt_.mjs} +1 -1
  24. package/dist/perf-DkAUFT6W.mjs +1319 -0
  25. package/dist/perf-jam-BaH3Lg0m.mjs +635 -0
  26. package/dist/plugin-B8UghYuF.mjs +5242 -0
  27. package/dist/{poster-BdtSKMDm.mjs → poster-BNgafWMK.mjs} +1 -1
  28. package/dist/{profile-WU9qcbIo.mjs → profile-jIS6BcAs.mjs} +1 -1
  29. package/dist/{publish-bakes-9RzRToXV.mjs → publish-bakes-38Nja78p.mjs} +3 -3
  30. package/dist/{queue-29ok5_eZ.mjs → queue-CAM_vNmX.mjs} +1 -1
  31. package/dist/recover-B8AiI29B.mjs +66 -0
  32. package/dist/{serve-C8rVheYk.mjs → serve-Dp3nHstu.mjs} +3 -3
  33. package/dist/{share--oFJ1bCI.mjs → share-Ce4tP7ji.mjs} +1 -1
  34. package/dist/{shot-XQV7HC9A.mjs → shot-CMQgMVZm.mjs} +1 -1
  35. package/dist/{shot-DQeR_Pfn.mjs → shot-Ch24tiMO.mjs} +36 -5
  36. package/dist/slots-CFNnegCc.mjs +478 -0
  37. package/dist/{sync-DKk-yT1V.mjs → sync-CQdGARJ9.mjs} +4 -3
  38. package/dist/{work-VvX_JIgl.mjs → work-Bxz-ObF3.mjs} +4 -2
  39. package/dist/{work-F5u-twpJ.mjs → work-CNhFF9pU.mjs} +5 -3
  40. package/docs/boards-and-folders.md +3 -1
  41. package/docs/jam-session.md +57 -2
  42. package/docs/performance.md +424 -0
  43. package/package.json +2 -2
  44. package/src/client/content/index.tsx +3 -0
  45. package/src/client/content/video.tsx +16 -4
  46. package/src/client/frame-host/bridge.js +22 -6
  47. package/src/client/frame-host/main.tsx +17 -5
  48. package/src/client/shell/App.tsx +188 -26
  49. package/src/client/shell/BoardList.tsx +5 -5
  50. package/src/client/shell/Comments.tsx +8 -5
  51. package/src/client/shell/ContextMenu.tsx +5 -3
  52. package/src/client/shell/JamSurface.tsx +4 -2
  53. package/src/client/shell/LockedApp.tsx +8 -5
  54. package/src/client/shell/Play.tsx +20 -10
  55. package/src/client/shell/Tip.tsx +3 -1
  56. package/src/client/shell/Toolbar.tsx +12 -1
  57. package/src/client/shell/api.ts +233 -0
  58. package/src/client/shell/app-bridge.ts +254 -0
  59. package/src/client/shell/app-perf.ts +92 -0
  60. package/src/client/shell/canvas/Canvas.tsx +141 -21
  61. package/src/client/shell/canvas/FrameNode.tsx +22 -9
  62. package/src/client/shell/canvas/admission.ts +31 -9
  63. package/src/client/shell/canvas/camera-broadcast.ts +15 -5
  64. package/src/client/shell/canvas/ctl.ts +8 -0
  65. package/src/client/shell/canvas/frame-registry.ts +28 -2
  66. package/src/client/shell/canvas/sleep.ts +60 -17
  67. package/src/client/shell/canvas/updates.ts +2 -1
  68. package/src/client/shell/comments-store.ts +12 -4
  69. package/src/client/shell/goto.ts +22 -10
  70. package/src/client/shell/inset.ts +44 -0
  71. package/src/client/shell/jam-capture.ts +41 -22
  72. package/src/client/shell/jam-keys.ts +12 -3
  73. package/src/client/shell/jam-panel.tsx +9 -3
  74. package/src/client/shell/jam-queue.ts +3 -3
  75. package/src/client/shell/jam-session.tsx +14 -8
  76. package/src/client/shell/jam-voice.ts +55 -15
  77. package/src/client/shell/legacy-links.ts +2 -2
  78. package/src/client/shell/main.tsx +18 -1
  79. package/src/client/shell/marks-ui.tsx +5 -3
  80. package/src/client/shell/marver-app.ts +21 -0
  81. package/src/client/shell/notes.ts +8 -1
  82. package/src/client/shell/perf-run-probe.ts +34 -0
  83. package/src/client/shell/perf-run.ts +70 -0
  84. package/src/client/shell/perf.ts +80 -58
  85. package/src/client/shell/recorder-core.ts +183 -0
  86. package/src/client/shell/recorder.ts +607 -0
  87. package/src/client/shell/store.ts +294 -110
  88. package/src/client/shell/styles.css +72 -15
  89. package/src/client/shell/unsaved.ts +81 -0
  90. package/src/client/shell/whiteout-probes.ts +141 -0
  91. package/src/shared/app-api.ts +205 -0
  92. package/src/shared/app-perf.ts +308 -0
  93. package/src/shared/logo-sniff.ts +86 -0
  94. package/src/shared/machine.ts +132 -0
  95. package/src/shared/perf-run.ts +177 -0
  96. package/templates/AGENTS-embedded.md +25 -4
  97. package/templates/AGENTS-studio.md +25 -4
  98. package/templates/demo/dark.tsx +1 -1
  99. package/templates/demo/welcome.tsx +1 -1
  100. package/templates/instructions/boards.md +3 -1
  101. package/templates/instructions/welcome.md +6 -3
  102. package/dist/bake-C-awKgLA.mjs +0 -786
  103. package/dist/config-Cf7EjAMf.mjs +0 -292
  104. package/dist/dev-Bw_qYWWq.mjs +0 -755
  105. package/dist/dev-lock-DWSpa6nj.mjs +0 -179
  106. package/dist/perf-C75MZ73h.mjs +0 -167
  107. package/dist/perf-DPbLGhhO.mjs +0 -49
  108. package/dist/perf-jam-BU3TVrZu.mjs +0 -239
  109. package/dist/plugin-DkGmZs_r.mjs +0 -2423
package/CHANGELOG.md CHANGED
@@ -2,6 +2,204 @@
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.2 - 2026-10-24
6
+
7
+ 0.27.1 was never published: its changes ship here, with 0.27.2's.
8
+
9
+ ### Highlights
10
+
11
+ - **Leaving a canvas that holds unsaved work asks first, in every browser.** Chrome asked only while a Jam capture was
12
+ being recorded, or on a stopped tab with board edits. Now a reload or a close asks whenever the page holds anything
13
+ the canvas does not have yet: a capture recording, finishing or not taken by the canvas yet, a board edit not saved
14
+ yet (a save on its way or one that failed), frame heights not written yet, or words typed and not sent (a comment, a
15
+ Jam edit or note). A drag is not work until it drops. The page's own reload when its canvas comes back still goes
16
+ without asking: it saves first. Chrome asks only on a page you have clicked or typed in since it loaded. A published
17
+ canvas is unchanged.
18
+ - **A canvas opens where you left it.** A board you reload opens on the view you had, kept per project and board,
19
+ unless the link names a selection: then it fits that, as before. The view is kept a second after it settles, and at
20
+ once when the tab is hidden or closed; a tab hidden while the view is still flying (a fit, a zoom) keeps where it was
21
+ going. A published canvas still opens on the whole board.
22
+ - **A board's first frame starts about 0.3 s sooner.** It waited 0.35 s after the board mounted, for the camera's first
23
+ fit to land. It now starts as the fit sets off, chosen on where the fit will land, so it is the same frame. On a real
24
+ project's boards the frames were ready 0.1-0.4 s sooner (a 30-frame board: 1.3 s to 1.0 s), and nothing moved more
25
+ ([Performance](docs/performance.md#making-a-board-faster) has the numbers).
26
+ - **`npx marver perf run <board>`: a board measured the same way every time.** With `marver dev` running, the canvas's
27
+ own headless Chrome loads the board once to warm up, then measures a load, a fit and three gestures (zoom in, zoom
28
+ out, a pan that turns back), and writes one line: load to settled, frame times (p50, p95, frames over 33 ms), the
29
+ heap's peak, and whether the run is valid, with the first reason it is not. A run is read-only: its page sends no
30
+ write but its own records and the frames' sleep textures, and the dev server refuses any other. `--slow` throttles
31
+ the CPU 4x, `--repeat <n>` runs it up to 5 times. `npx marver perf --runs` compares a run only with runs made the
32
+ same way (board, Chrome, machine, power, `--slow`): the latest against the last with the same inputs and the last
33
+ with others; `--against <run>` against one you name. Your agent is told to use it before and after a change
34
+ ([Headless runs](docs/performance.md#headless-runs)).
35
+ - **The Mac app needs this version.** With it, the app asks before a close, a quit or a reload loses unsaved work,
36
+ follows the canvas's theme, shows its View and Jam items in the menu bar and wears its logo on the tab; app 0.2 also
37
+ runs the canvas full height under its transparent tabs. A 0.27.0 canvas opens in the app with a lesser
38
+ guard and none of the rest. In a browser, none of the app's side runs.
39
+
40
+ ### Changed
41
+
42
+ - **Reduce Transparency and Increase Contrast make the glass opaque.** With either set in macOS, the sidebar, the
43
+ toolbar and every glass surface take a solid fill and a plain border; with Increase Contrast the dimmer text takes the
44
+ full ink. Chrome reads the same settings.
45
+ - **`npx marver perf --loads` names each board as the sidebar does, and its two clocks apart.** A load is headed by its
46
+ board's title ("v1 lo-fi - Mac and iPhone", not "Journey"; `--json` keeps the board's name). A settled load says
47
+ `still from` its last move, where it said `quiet 0.0 s · last move 1.3 s`, which read as a contradiction. `slowest`
48
+ is now `slowest to settle`: a frame's time to its last height, which can come after `all ready`, each frame's first
49
+ render. [Performance](docs/performance.md) says what settled means.
50
+ - **The logo ladder reads `public/favicon.png` and `public/favicon.ico` too, and a logo must be one.** After
51
+ `share.logo`, `design/logo.svg|png`, `public/logo.svg|png` and `public/favicon.svg`, `marver build` now tries
52
+ `public/favicon.png` and `public/favicon.ico`. A candidate counts only as a regular file inside the repo (never a
53
+ symlink, even one inside it) of at most 256 KB whose bytes are an SVG, a PNG or an ICO; its type comes from its
54
+ bytes, so a PNG named `.svg` is published as `logo.png`. A `share.logo` that fails is ignored with one line saying
55
+ why; 0.27.0 followed a symlink and copied `share.logo` from anywhere. A gated `marver serve` shows a `logo.ico` before
56
+ sign-in, as it does a `.svg` or `.png`.
57
+ - **`marver ls` names a canvas as the canvas does**: `share.name` when you set one ("TMS broker", not "tms-broker"),
58
+ else the folder name.
59
+
60
+ ### Added
61
+
62
+ - **The Mac app's bridge.** In the app, a canvas page tells the app what it holds, so closing its tab, quitting or
63
+ reloading asks first or waits; its theme, which the app's tabs follow; and its View and Jam menu items with their
64
+ keys. When its tab is shown again it reads its marks, its agents' work, the Jam queue and its board again; when the
65
+ app stops trusting it, it lets go of the microphone at once, one still opening too. Each canvas's file in
66
+ `~/.marver/running/` lists `bridge` and `inset` among its features.
67
+ - **Under the Mac app's tabs (app 0.2).** When the app places a canvas full height under its transparent strip,
68
+ everything you read or click stays below the strip: the sidebar, the toolbar, the Jam panel and sheet, play's pills
69
+ and the stopped banner sit 44 px lower; the selection bar, tooltips and menus never go above it; a fit, a frame's
70
+ focus and play's stage leave its room. The canvas's own ground and dots run under the strip and fade out just below
71
+ it, and a frame under it counts as out of view (not marked seen, not named to Jam). Everywhere else (Chrome, a
72
+ published canvas, `marver shot`, app 0.1) nothing moves.
73
+ - **`npx marver perf --crashes`, `--flashes` and `--machine` read the Mac app's records** (app 0.2), joined to this
74
+ repo's board loads: each canvas crash with its board, whether its load had settled and the last gesture before it;
75
+ each flash you marked with ⌃⌥F, with the gesture it fell in and the GPU process's events around it, the white-out
76
+ candidates apart; the machine profiles by host. In the app the canvas tells the recorder its gestures, so its
77
+ records land on the right board load. `--days <n>` (14) for these and `--runs` ([The Mac app's
78
+ half](docs/performance.md#the-mac-apps-half)).
79
+ - **`GET /__mv/logo`** on `marver dev`: the canvas's logo, from the same ladder and checks as `marver build`, signed
80
+ when the app asks, so the app shows a logo only from the canvas it verified.
81
+
82
+ ### Fixed
83
+
84
+ - **"Back - your edits were saved" every time.** A tab that held an edit when its canvas stopped saved it when the
85
+ canvas came back and reloaded, but said so only when the save it made on the way back carried the edit. Often the
86
+ ordinary autosave had already saved it (a frame still in your hand when the canvas answered, then dropped) and the
87
+ reloaded page said nothing, though the edit was on disk. Now every board save between the stop and the reload
88
+ counts, and a lost one too: the reloaded page then says the file won, or that the board is gone.
89
+ - **A tab whose canvas came back reloads only once its heights are saved.** A heights write that failed on the way back
90
+ was dropped by the reload. Now the tab reloads once every height has reached `_sizes.json`; until then it works as
91
+ live and sends them again.
92
+
93
+ ### Upgrading
94
+
95
+ `npm install @marver-design/marver@latest`, then `npx marver init` to refresh the agent instructions (they compare a
96
+ board before and after a change with `npx marver perf run`, and say what counts as a logo). Restart each canvas: the
97
+ Mac app sees the bridge only on a canvas started from this version.
98
+
99
+ ## 0.27.0 - 2026-10-23
100
+
101
+ ### Highlights
102
+
103
+ - **Each canvas takes a slot: localhost:4805 to 4824.** `marver dev` no longer works its port out from the folder's
104
+ path (5200-5399). It takes one of twenty fixed ports - this project's last one when it is free, else the first free
105
+ one - so a project usually gets its address back. A port another program holds is skipped, and said; with all twenty
106
+ taken it stops before starting, lists them and says how to free one. A canvas that ran before says where it moved on
107
+ its first start: "ports are now fixed slots: this canvas is at http://localhost:4806/".
108
+ - **`npx marver ls`** lists the canvases running on this Mac - slot, link, name, version, state, uptime, folder - with
109
+ `--json` for agents (never a canvas's key). It needs no repo and leaves out a canvas that died without stopping; one
110
+ that has begun to stop shows `closing` and holds its slot until it has gone.
111
+ - **A tab left open can no longer write into another project.** A tab whose canvas had stopped kept talking to
112
+ whatever started next on its port, and could save its board into another project whose board file matched. Now every
113
+ request it makes, and every frame, play-stage and Jam-picture address, names its project, and another project
114
+ refuses them before reading or writing anything. The tab says what happened and the way back ("This canvas stopped -
115
+ run npx marver dev to bring it back"), and that your unsaved edits are kept in it when it holds some; comments and
116
+ Jam captures wait for the canvas. When its canvas answers again, the tab saves, then reloads on the view you had
117
+ once nothing is in progress (a capture, words not sent, a drag): "Back - your edits were saved". If the board's file
118
+ changed on disk meanwhile, the file wins, as it always has, and the tab's unsaved board edits are lost ("board
119
+ changed on disk - canvas layout reloaded"); a board renamed or removed meanwhile is not created again. Leaving a
120
+ stopped tab with unsaved board edits asks first.
121
+ - **`npx marver perf --loads`** says what each board load did, from the page: the time until the frames in view were
122
+ ready, until all were and until the board settled, or why the load was cut; how often the board moved and why; the
123
+ five slowest frames, each with its wait in the queue and its own time; errors, and frames that never answered or are
124
+ missing. `--json` for agents; plain `marver perf` adds a line per load. Its record (`design/.local/perf/page.jsonl`)
125
+ can hold file paths, so it stays on your machine; it costs nothing at rest ([Performance](docs/performance.md)).
126
+ - **Pictures work with Chrome 156.0.8078.47 and later.** That update made a headless page read as hidden when another
127
+ window covers it, and each picture has a window of its own, so a picture could wait on a paint that never came.
128
+ Marver's Chrome now runs every page as if seen (`marver shot`, agent pictures, copy as image, video posters, Jam).
129
+ - **Your agent keeps the canvas up.** A canvas an agent starts dies with its job (Claude Code stops a background job
130
+ after 10 minutes), and the link it gave you with it. The agent instructions now say: `npx marver ls` first; none
131
+ running, ask you to run `npx marver dev` in your own terminal; if it starts one, detached so it outlives it (output
132
+ in `design/.local/dev.log`), its link read from `npx marver ls`. Where a sandbox keeps the canvas from starting or
133
+ being reached, the agent asks you to run it; `marver shot`, `marks`, `ls` and `perf --loads` still work there.
134
+
135
+ ### Changed
136
+
137
+ - **A port you chose stays yours.** `--port <n>`, or a `port` in `design/config.ts` other than the scaffolded 5199, is
138
+ tried first, as before; when it is taken, the canvas takes a slot and says so. A port in 4805-4824 claims exactly
139
+ that slot: when something else holds it, `marver dev` stops and says what. A port from `design/config.ts` is named
140
+ as the canvas starts ("remove it to use the slots"); a new `design/config.ts` has it only as a commented example.
141
+ - **A start that fails leaves nothing behind.** Its lock, its slot, a half-made server and the watchers are given
142
+ back; it says what failed ("port 4806 was just taken by another program - start again", for one) and exits with 1.
143
+ - **`marver dev` says when it stops**: "canvas stopped - open tabs keep their edits and save when it is back".
144
+ - **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
145
+ key for a canvas started with `npx marver dev` - so a capture waiting in a page keeps it; only the address moved.
146
+ - **Five viewer preferences are kept per project.** Your view theme, the update notice you closed, the mentions you
147
+ opened, which sticky notes show and which folders are folded were kept per address, shared by projects that ran
148
+ there in turn. A local canvas now keeps them per project at each address and carries them nowhere else: they start
149
+ fresh after the upgrade, and on a slot the canvas has not used before. A published canvas is unchanged.
150
+ - **No service workers on a local canvas**: an address is reused by whichever canvas starts there next, and a worker
151
+ would outlive its canvas. A PWA prototype shows its screens, not its offline behaviour.
152
+ - **`__mvPerf.report()` has new names:** `over33ms` (a count) and `over17ms` replace `dropped` and `droppedFrac`;
153
+ `longTask*` become `longFrame*`.
154
+ - **The frame-time sampler rests with the canvas:** it runs only during a pan, a zoom or a layout animation.
155
+
156
+ ### Added
157
+
158
+ - **`npx marver dev --recover`** starts a canvas on an address it ran on before - exactly its port, the address it
159
+ bound and the project key that run used, never another - so a Jam capture left unsent in that browser sends itself.
160
+ Alone it lists the last five addresses, newest first, then the one 0.26 gave the folder; `--recover <n>` starts on
161
+ one; `--recover --port <p>` on the port 0.26 moved to. A canvas whose slot was taken says where it ran last time,
162
+ which canvas runs there now, and that a tab still open there keeps its unsaved edits (and an unsent capture waits)
163
+ until this canvas runs there again: "stop "atlas" and this canvas, then `npx marver dev --recover 2`" ([A capture
164
+ left on an old address](docs/jam-session.md#a-capture-left-on-an-old-address)).
165
+ - **The document proof.** An app that opens the canvas page can check the page comes from that canvas: send
166
+ `x-mv-nonce`, get `x-mv-instance` and a signed `x-mv-proof` back. Without the header nothing changes.
167
+ - **`MARVER_HOME`** moves `~/.marver` - running canvases, slot preferences, collaboration credentials - and
168
+ `marver ls` reads it too. The speech model stays in `~/.marver/models` (`MARVER_MODELS` moves it).
169
+
170
+ ### Fixed
171
+
172
+ - **Editing `.env` no longer stops Live Jam.** Vite restarts the canvas's server in place when an `.env` file changes,
173
+ and 0.26 took that for a stop: Live Jam stopped, comments written from the terminal no longer reached the page at
174
+ once, and `marver shot`, `work` and `link` lost the canvas. Now only the server restarts.
175
+ - **A link, back or forward reads its board once**, not twice (each fires two browser events).
176
+ - **The demo frames show their bottom button whole**: `welcome` and `dark` ran past the frame and cut it off.
177
+ - **A frame's error card comes from the document it shows**: a late error from a document it replaced is ignored.
178
+ - **The dev server never serves `~/.marver`**, which holds the running canvases' keys and the collaboration
179
+ credentials - not even when your project's workspace root is your home folder.
180
+ - **In a sandbox, `marver dev` says why it cannot start.** Where every file watcher fails (`EMFILE` in Codex's
181
+ sandbox), it ended with Node's own error; it now says to ask the person to run `npx marver dev` in their own
182
+ terminal and exits with 1, leaving nothing behind - as when a watcher fails later.
183
+ - **A canvas out of reach is not "not running".** In a sandbox that keeps an agent off localhost, `marver link` said
184
+ the canvas was not running, an invitation to start a second one. When `design/.local/dev.json` names a process that
185
+ runs, `link` prints the link and says the canvas runs but cannot be reached from here; so do `work start` and
186
+ `work done`.
187
+ - **The perf logs are yours alone**: `design/.local/perf/` is mode 700 and its files 600, older ones included; at
188
+ start each log loses lines older than 14 days, and past 2 MB its oldest half (`page.jsonl` keeps 8 MB).
189
+
190
+ ### Upgrading
191
+
192
+ `npm install @marver-design/marver@latest`, then `npx marver init` to refresh the agent instructions (they find the
193
+ canvas with `npx marver ls`, ask you to start it in your own terminal or start it so it outlives them - never with a
194
+ port - and read `npx marver perf --loads`). **Before you upgrade**, open each canvas once in the browser you make
195
+ captures in, with its old version still running and Live Jam on: a capture left unsent there sends itself. One left
196
+ behind comes back with `npx marver dev --recover`. On its first start each canvas moves to a slot and says where; a
197
+ bookmark to its old address no longer reaches it (`marver ls` lists the new one). A `port` you set in
198
+ `design/config.ts` stays until you remove the line. The five viewer preferences start fresh. **Then close every tab a
199
+ 0.26 canvas opened** (send or save what they hold first) and open the canvas again from its new link: a page 0.26
200
+ served names no project in its requests, so the protection above - a stopped tab that never writes into another
201
+ project - covers pages loaded from 0.27 on, not those older tabs.
202
+
5
203
  ## 0.26.1 - 2026-10-20
6
204
 
7
205
  ### Fixed
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:
@@ -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,17 @@ 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 \| --runs] [--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; `--runs` the headless runs compared ([Performance](docs/performance.md)) |
120
+ | `npx marver perf run <board> [--slow] [--repeat n]` | Measure a board the same way every time - a load, a fit, a zoom and a pan in the canvas's own headless Chrome, read-only - so you or your agent can compare before and after a change (needs `dev` running; [Headless runs](docs/performance.md#headless-runs)) |
117
121
  | `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
122
  | `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
123
  | `npx marver folders add <module ...>` | Add a typed folder: `start`, `features`, `surfaces`, `projects`, `feedback`, `context`, `decks`, `archive` |
120
124
  | `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
125
 
126
+ **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.
127
+
128
+ **The Mac app.** In Marver's Mac app a canvas tells the app what it holds, so closing its tab, quitting or reloading asks before losing unsaved work, and the app follows its theme and shows its View and Jam items in the menu bar. In a browser none of this runs; browsers ask before a reload or a close loses unsaved work too.
129
+
122
130
  ## Shortcuts
123
131
 
124
132
  **Canvas** - two-finger scroll pans · pinch or ctrl/cmd+scroll zooms · space+drag pans from anywhere · click empty canvas deselects / exits interact.
@@ -142,7 +150,7 @@ The same glow, driven from the terminal. When your agent takes a request, it cre
142
150
 
143
151
  - **Next.js**: supported with one caveat - frames render in Vite, outside Next. `next/font` CSS variables are undefined inside frames (give font tokens a fallback chain), `next/image`/`next/link` should be plain `img`/`data-goto` in frames, and Server Components cannot run there. `init` writes the specifics into `design/AGENTS.md` when it detects Next.
144
152
  - **Upgrade**: `npm i -D @marver-design/marver@latest && npx marver init`. The canvas tells you when a new version is out (one anonymous registry check per day, cached in `design/.local/`; `MARVER_NO_UPDATE_CHECK=1` disables), and warns when your `design/instructions/` predate the installed package. Re-running init refreshes the managed files (AGENTS.md, `design/instructions/`) - your edits to them are detected and preserved; when both you and a release changed a file, the fresh version is staged at `design/.local/latest/` for you (or your agent) to merge. Everything else in `design/` is yours and never touched.
145
- - **Name your canvas**: `share: { name: "Your App" }` in `design/config.ts` titles the gate, labels the brand pill, and tags every powered-by link. Unset, the gate falls back to your `package.json` name and the canvas shell to the directory name - `app` inside most containers.
153
+ - **Name your canvas**: `share: { name: "Your App" }` in `design/config.ts` titles the gate, labels the brand pill, names the canvas in `marver ls`, and tags every powered-by link. Unset, the gate falls back to your `package.json` name and the canvas shell to the directory name - `app` inside most containers. Its logo is the first of `share.logo`, `design/logo.svg|png`, `public/logo.svg|png` and `public/favicon.svg|png|ico` that is a real file in the repo (never a symlink) of at most 256 KB, an SVG, PNG or ICO by its bytes; the gate page and the Mac app's tab wear it.
146
154
  - **Uninstall**: delete `design/`, remove the dependency. (If `init` patched your tsconfig `exclude`, revert that one line.)
147
155
 
148
156
  ## Status
@@ -1,4 +1,4 @@
1
- import { MOUNTED, frameUrl, manifestFrame, planShot, withBrowser } from "./shot-DQeR_Pfn.mjs";
1
+ import { a as frameUrl, d as withBrowser, n as MOUNTED, o as manifestFrame, s as planShot } from "./shot-Ch24tiMO.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
@@ -189,6 +189,8 @@ const readTitle = (v) => {
189
189
  };
190
190
  /** Title Case off a slug - the display when no title is set ("old-stuff" → "Old Stuff"). */
191
191
  const humanize = (s) => s.replace(/-/g, " ").replace(/(^|\s)\S/g, (c) => c.toUpperCase());
192
+ /** What a board, folder or scene is called on screen: its title, else its humanized slug. */
193
+ const labelOf = (name, title) => title ?? humanize(name);
192
194
  const rank = (o) => typeof o === "number" && Number.isFinite(o) ? o : Infinity;
193
195
  /** A folder's title, description and type, present only when set. */
194
196
  const folderExtras = (it) => ({
@@ -361,4 +363,4 @@ function folderMap(t) {
361
363
  return out;
362
364
  }
363
365
  //#endregion
364
- export { settableStatuses as A, PROPOSED_PUBLISH as C, readStatusWord as D, readReason as E, readType as O, KIND_FOLDERS as S, readCapability as T, wireKids as _, buildTree as a, FOLDER_MODULES as b, folderMap as c, isBoardFile as d, isBoardName as f, validateWire as g, readTitle as h, archiveLast as i, resolveType as k, framesOn as l, readDescription as m, BOARD_NAME as n, flatten as o, parseFolders as p, FOLDERS_FILE as r, folderEntries as s, ALL_SCENES as t, humanize as u, BOARD_TYPES as v, knownType as w, HAS_STATUS as x, DECISIONS as y };
366
+ export { resolveType as A, KIND_FOLDERS as C, readReason as D, readCapability as E, readStatusWord as O, HAS_STATUS as S, knownType as T, validateWire as _, buildTree as a, DECISIONS as b, folderMap as c, isBoardFile as d, isBoardName as f, readTitle as g, readDescription as h, archiveLast as i, settableStatuses as j, readType as k, framesOn as l, parseFolders as m, BOARD_NAME as n, flatten as o, labelOf as p, FOLDERS_FILE as r, folderEntries as s, ALL_SCENES as t, humanize as u, wireKids as v, PROPOSED_PUBLISH as w, FOLDER_MODULES as x, BOARD_TYPES as y };
@@ -1,4 +1,4 @@
1
- import { D as readStatusWord, E as readReason, O as readType, T as readCapability, a as buildTree, c as folderMap, d as isBoardFile, f as isBoardName, h as readTitle, i as archiveLast, k as resolveType, l as framesOn, m as readDescription, o as flatten, p as parseFolders, r as FOLDERS_FILE } from "./board-tree-DRioF94d.mjs";
1
+ import { A as resolveType, D as readReason, E as readCapability, O as readStatusWord, a as buildTree, c as folderMap, d as isBoardFile, f as isBoardName, g as readTitle, h as readDescription, i as archiveLast, k as readType, l as framesOn, m as parseFolders, o as flatten, r as FOLDERS_FILE } from "./board-tree-BXR8dw4b.mjs";
2
2
  import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
3
3
  import { join, sep } from "node:path";
4
4
  import { createHash, randomBytes } from "node:crypto";
@@ -1,8 +1,8 @@
1
1
  import { r as NAME } from "./cli.mjs";
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
- 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
- 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";
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-BHKP5yhI.mjs";
3
+ import { A as resolveType, E as readCapability, T as knownType, a as buildTree, c as folderMap, f as isBoardName, o as flatten, u as humanize, x as FOLDER_MODULES, y as BOARD_TYPES } from "./board-tree-BXR8dw4b.mjs";
4
+ import { _ as STATUS_LABEL, d as annotateBoards, h as PHASE_LABEL, s as scanFrames } from "./manifest-aFyDmL8C.mjs";
5
+ import { resolveTargets } from "./link-CdTgn94Y.mjs";
6
6
  import { existsSync, mkdirSync, writeFileSync } from "node:fs";
7
7
  import { join } from "node:path";
8
8
  //#region src/cli/boards.ts
@@ -1,10 +1,10 @@
1
1
  import { a as ROUTE, r as NAME } from "./cli.mjs";
2
- import { f as readRegistry, i as checkBoardsDir, o as isRegularFile, r as boardFields, s as listBoardFiles } from "./boards-CGg6piKF.mjs";
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
- import { g as PUBLISHABLE, s as scanFrames, v as publishableStatus } from "./manifest-Nl3KSVOk.mjs";
2
+ import { f as readRegistry, i as checkBoardsDir, o as isRegularFile, r as boardFields, s as listBoardFiles } from "./boards-BHKP5yhI.mjs";
3
+ import { a as buildTree, f as isBoardName, l as framesOn, o as flatten, t as ALL_SCENES, w as PROPOSED_PUBLISH } from "./board-tree-BXR8dw4b.mjs";
4
+ import { g as PUBLISHABLE, s as scanFrames, v as publishableStatus } from "./manifest-aFyDmL8C.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-DkGmZs_r.mjs";
6
+ import { t as detectHost } from "./detect-C0wpaePX.mjs";
7
+ import { c as autoWidthOf, d as readSizes, f as loadConfig, i as publishLogo, l as keptSizes, n as tailwind3Css, r as tailwind4Plugin, t as marverPlugin, u as measuringFrames } from "./plugin-B8UghYuF.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-BdtSKMDm.mjs");
788
+ const { ensurePoster } = await import("./poster-BNgafWMK.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})`);
@@ -833,22 +833,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
833
833
  name = JSON.parse(readFileSync(join(root, "package.json"), "utf8")).name ?? name;
834
834
  } catch {}
835
835
  if (config.share.name) name = config.share.name;
836
- let logo;
837
- const logoLadder = [
838
- ...config.share.logo ? [config.share.logo] : [],
839
- "design/logo.svg",
840
- "design/logo.png",
841
- "public/logo.svg",
842
- "public/logo.png",
843
- "public/favicon.svg"
844
- ];
845
- for (const cand of logoLadder) {
846
- if (!existsSync(join(root, cand))) continue;
847
- const ext = cand.endsWith(".png") ? "png" : "svg";
848
- cpSync(join(root, cand), join(outDir, ROUTE.slice(1), `logo.${ext}`));
849
- logo = `${ROUTE}/logo.${ext}`;
850
- break;
851
- }
836
+ const logo = publishLogo(root, config.share.logo, outDir, (m) => console.warn(` ${m}`));
852
837
  writeFileSync(join(outDir, "meta.json"), JSON.stringify({
853
838
  name,
854
839
  branding: config.share.branding,
@@ -862,7 +847,7 @@ async function buildSite(root, boardsFlag, allBoardsFlag, embedSeeds, textures =
862
847
  }));
863
848
  let textureLine = " textures: skipped (--no-textures)";
864
849
  if (textures && bakeGen) {
865
- const { bakePublished } = await import("./publish-bakes-9RzRToXV.mjs");
850
+ const { bakePublished } = await import("./publish-bakes-38Nja78p.mjs");
866
851
  const pubFrameFile = new Map(pubFrames.map((f) => [f.id, f]));
867
852
  const r = await bakePublished({
868
853
  root,
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-W0nxR1OY.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-Bw_qYWWq.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-ri6nAlRp.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-B8AiI29B.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-BZ5TAtd5.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-BDRiO_mP.mjs");
121
+ const { buildSite } = await import("./build-VgNg4rr8.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);
@@ -116,7 +128,7 @@ cli.command("build", "Static export → design/.dist (what ships comes from desi
116
128
  }
117
129
  });
118
130
  cli.command("serve", "Serve design/.dist (set MARVER_PASSWORD to gate it)").option("--root <dir>", "Host repo root", { default: "." }).option("--port <port>", "Port (default $PORT or 4199)").action(async (opts) => {
119
- const { serve } = await import("./serve-C8rVheYk.mjs");
131
+ const { serve } = await import("./serve-Dp3nHstu.mjs");
120
132
  let port;
121
133
  if (opts.port !== void 0) {
122
134
  const n = Number(opts.port);
@@ -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-YEU1Zhv9.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-Ce4tP7ji.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-Bxz-ObF3.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-CdTgn94Y.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-BqUqKNW8.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-BqUqKNW8.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);
@@ -195,7 +207,7 @@ cli.command("folders <action> [...modules]", "The shared sidebar's typed folders
195
207
  }
196
208
  });
197
209
  cli.command("context <action>", "The project's context/ (spec 19) · init: create it · check: keep it true (exit 0 pass, 1 fail, 2 cannot determine) · index: regenerate the index's capability table").option("--root <dir>", "Host repo root", { default: "." }).option("--base <ref>", "check: the pull request's base - a change to a contracted capability's code must change its contract or say why (in ci, read from the event)").option("--head <ref>", "check: the pull request's head (default HEAD)").option("--body-file <file>", "check: the pull request's body, for `no-contract-change: <capability> - <why>`").option("--json", "check: the findings as JSON ({ exit, failures, unsure, notes })").option("--kind <kind>", "init: product (a shipped record) or knowledge (a delivered record)", { default: "product" }).action(async (action, opts) => {
198
- const ctx = await import("./context-HQ4Giw58.mjs");
210
+ const ctx = await import("./context-Ccjrhr1J.mjs");
199
211
  const root = resolve$1(opts.root);
200
212
  try {
201
213
  if (action === "init") {
@@ -231,15 +243,29 @@ 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-DyWMv_Z1.mjs");
246
+ const { marksCommand } = await import("./marks-BF9pNEgH.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; --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("--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) => {
238
- const { perfCommand } = await import("./perf-C75MZ73h.mjs");
239
- perfCommand(resolve$1(opts.root), opts);
249
+ cli.command("perf [action] [board]", "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; `perf run <board>`: a headless run of the board, read-only (needs `dev` running); --runs: those runs compared; --crashes, --flashes, --machine: the Mac app's records").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, each board by its title: time to the visible frames ready and all ready (each frame's first render), still from the last move and settled (a second still after it) - 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 to settle (their last height) 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("--runs", "The headless runs (`perf run`), compared only inside a cohort (script, board, Chrome, flags, machine, power, --slow, bakes): the latest against the one before with the same inputs, and against the last with other inputs; overlapped and invalid runs listed apart (design/.local/perf/runs.jsonl)").option("--against <run>", "With --runs: the latest run of that run's cohort against it, whatever their inputs (you changed something on purpose)").option("--crashes", "The Mac app's crashes and hangs of this repo's canvases, each joined to its board load by page (what had settled, the last gesture), the minute before it, and the GPU and utility processes' ends by time (~/.marver/perf/app.jsonl, app-dev.jsonl)").option("--flashes", "The flashes marked in the Mac app (⌃⌥F) on this repo's canvases: the board, the gesture the mark fell in (or the one ending within 2 s of it), the GPU process's events, pressure at the mark, the GPU figures and the picture's path; the white-out detector's candidates apart, automatic and not verified").option("--machine", "The machine profiles the Mac app and headless runs wrote (~/.marver/perf/machine), by host, which is current, and how many records and runs name each").option("--all", "With --flashes: also the marks made on other canvases or on Home").option("--days <n>", "How far back --runs, --crashes, --flashes and --machine read (default 14)").option("--slow", "With `run`: the CPU throttled 4x (a stand-in for a slower Mac's CPU, not its GPU or memory)").option("--repeat <n>", "With `run`: how many runs, one after another (1-5, default 1)").option("--json", "Machine-readable output").action(async (action, board, opts) => {
250
+ if (action !== void 0 && action !== "run") {
251
+ console.error(`[${NAME}] unknown action "${action}" - the one action is run: ${NAME} perf run <board>`);
252
+ process.exit(1);
253
+ }
254
+ const { perfCommand, perfRunCommand } = await import("./perf-DkAUFT6W.mjs");
255
+ const typed = (v) => typeof v === "number" ? process.argv.find((t) => !t.startsWith("-") && Number(t) === v) ?? String(v) : v === void 0 ? void 0 : String(v);
256
+ if (action !== "run") return perfCommand(resolve$1(opts.root), {
257
+ ...opts,
258
+ against: typed(opts.against)
259
+ });
260
+ try {
261
+ process.exit(await perfRunCommand(resolve$1(opts.root), typed(board), opts));
262
+ } catch (err) {
263
+ console.error(`[${NAME}] ${err.message}`);
264
+ process.exit(1);
265
+ }
240
266
  });
241
267
  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-XQV7HC9A.mjs");
268
+ const { shotCommand } = await import("./shot-CMQgMVZm.mjs");
243
269
  try {
244
270
  await shotCommand(resolve$1(opts.root), frames, opts);
245
271
  } catch (err) {
@@ -1,4 +1,4 @@
1
- import { t as ALL_SCENES } from "./board-tree-DRioF94d.mjs";
1
+ import { t as ALL_SCENES } from "./board-tree-BXR8dw4b.mjs";
2
2
  import { a as readLog, i as listBoards, r as legacyExposure, t as appendEvents } from "./comments-0BSbb04K.mjs";
3
3
  import { A as reconfirmGrant, C as commentAllowed, D as operativeMode, E as loadShare, F as setBlocked, I as setGeneralMode, L as shareState, M as resolveAccess, N as resolveRequest, O as provisionVerdict, P as rosterEtag, S as ceilingsFromRights, T as loadRequests, _ as sessionUser, a as claimInvite, b as updateProfile, c as issueDeviceSession, d as opaqueId, f as ownerName, g as sessionIsOperator, h as revokeUser, j as removeGrant, k as putRequest, l as loadStore, m as publicUser, o as createInvite, s as inviteInfo, u as normEmail, v as signIn, w as entryAllowed, y as signOut, z as upsertGrant } from "./auth-Dix8wrXV.mjs";
4
4
  import { canvasIdentity, deriveThreads, loadSeen, markSeen, signCanvasJws, unreadCount, verifyCanvasJws } from "./summary-Y8MY1Wuc.mjs";
@@ -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-CNhFF9pU.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-CQdGARJ9.mjs";
6
+ import { n as localProfile } from "./profile-jIS6BcAs.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-CdTgn94Y.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")}`);
@@ -1,7 +1,7 @@
1
1
  import { r as NAME } from "./cli.mjs";
2
- import { a as checkRealDirs } from "./boards-CGg6piKF.mjs";
3
- import { D as readStatusWord, f as isBoardName, l as framesOn } from "./board-tree-DRioF94d.mjs";
4
- import { A as levelsIn, C as LEVEL, D as globRe, E as frontMatter, F as tables, I as wordCount, M as looseTables, N as parseMap, O as hasGlob, P as proseLines, S as GENERATED, T as capabilityTable, b as CITED_FILE, j as lf, k as isRecordTable, s as scanFrames, w as availableLevels, x as EVIDENCE_COLUMN, y as CITATION } from "./manifest-Nl3KSVOk.mjs";
2
+ import { a as checkRealDirs } from "./boards-BHKP5yhI.mjs";
3
+ import { O as readStatusWord, f as isBoardName, l as framesOn } from "./board-tree-BXR8dw4b.mjs";
4
+ import { A as levelsIn, C as LEVEL, D as globRe, E as frontMatter, F as tables, I as wordCount, M as looseTables, N as parseMap, O as hasGlob, P as proseLines, S as GENERATED, T as capabilityTable, b as CITED_FILE, j as lf, k as isRecordTable, s as scanFrames, w as availableLevels, x as EVIDENCE_COLUMN, y as CITATION } from "./manifest-aFyDmL8C.mjs";
5
5
  import { pkgDir } from "./managed-HwHVNI3h.mjs";
6
6
  import { t as writeManaged } from "./managed-write-Bo-oPc-i.mjs";
7
7
  import { t as imports } from "./imports-WBSnnHLb.mjs";