@marver-design/marver 0.30.0 → 0.31.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 (109) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/README.md +11 -7
  3. package/dist/{anchor-check-c52IDkiQ.mjs → anchor-check-B92s9tVv.mjs} +1 -1
  4. package/dist/{board-tree-BXR8dw4b.mjs → board-tree-DGj0HhEE.mjs} +6 -2
  5. package/dist/{boards-EH2onUXM.mjs → boards-Cim1GTKc.mjs} +32 -2
  6. package/dist/{boards-BeWtjGUM.mjs → boards-OlAhZ87x.mjs} +7 -7
  7. package/dist/{build-C3mUtjEn.mjs → build-BNssmbqd.mjs} +14 -17
  8. package/dist/{capture-DEtM4qm5.mjs → capture-HaS-1or8.mjs} +1 -1
  9. package/dist/cli.mjs +38 -20
  10. package/dist/{collab-BEAcXrBb.mjs → collab-D2NcrOB8.mjs} +53 -14
  11. package/dist/comment-actions-Bxf9Ld4g.mjs +351 -0
  12. package/dist/{comments-XNhMmSSu.mjs → comments-BakJQwaf.mjs} +85 -10
  13. package/dist/config-B0YcFtqS.mjs +510 -0
  14. package/dist/{context-BUnFiyA3.mjs → context-Cj2TcC0H.mjs} +3 -3
  15. package/dist/{daemon-B0Wi1OQ3.mjs → daemon-MxoEQajX.mjs} +223 -26
  16. package/dist/deep-link-DYtuT740.mjs +163 -0
  17. package/dist/{dev-5dlxoW28.mjs → dev-BBZe_brH.mjs} +23 -16
  18. package/dist/devices-uJZ2inMq.mjs +155 -0
  19. package/dist/{events-CLH4ijKP.mjs → events-Dieo1482.mjs} +49 -4
  20. package/dist/{init-CYlFaRzG.mjs → init-BgusplYn.mjs} +40 -10
  21. package/dist/{jam-Cj5gBvwD.mjs → jam-CkuLL8A8.mjs} +1 -1
  22. package/dist/{link-BFFRgrMt.mjs → link-Cmt9Xy4X.mjs} +54 -7
  23. package/dist/{logo-CXY-1yrn.mjs → logo-C9s7-Cy9.mjs} +89 -66
  24. package/dist/{ls-NqmePKOf.mjs → ls-DGVIW-Io.mjs} +1 -1
  25. package/dist/{manifest-DPZ3WNg_.mjs → manifest-CK8Qh4Nq.mjs} +255 -13
  26. package/dist/{marks-BnNANic9.mjs → marks-C8oX8kbE.mjs} +3 -3
  27. package/dist/{marks-DBp3h1Mc.mjs → marks-Dt-5JXCp.mjs} +18 -5
  28. package/dist/{marver-id-gate-vBLb_Icb.mjs → marver-id-gate-BAeuMeaU.mjs} +11 -7
  29. package/dist/md-B9_13Q0R.mjs +105 -0
  30. package/dist/notes-CRAX4wgk.mjs +148 -0
  31. package/dist/own-C8Mq0Hnf.mjs +128 -0
  32. package/dist/pdf-0m721FFn.mjs +117 -0
  33. package/dist/pdf-CZENT6t3.mjs +2299 -0
  34. package/dist/{perf-BCxAo0IS.mjs → perf-BB0XNt1M.mjs} +1 -1
  35. package/dist/{perf-6MOTHxay.mjs → perf-CIMijND6.mjs} +5 -5
  36. package/dist/{plugin-CXRoMA8g.mjs → plugin-CL8_wL7a.mjs} +519 -112
  37. package/dist/{poster-CYmCa00B.mjs → poster-B7uSjlEP.mjs} +1 -1
  38. package/dist/{profile-B1FKOM1e.mjs → profile-cdmSer1k.mjs} +1 -1
  39. package/dist/{publish-bakes-C_2ZtHou.mjs → publish-bakes-BjgDNeyS.mjs} +3 -3
  40. package/dist/{queue-DeSQm24g.mjs → queue-BLLfdlDw.mjs} +156 -11
  41. package/dist/{recover-XD8iXJOj.mjs → recover-ByuFQOF9.mjs} +2 -2
  42. package/dist/{serve-DQv3Ti6X.mjs → serve-kcF6-H8V.mjs} +4 -4
  43. package/dist/{session-VDJfXEEm.mjs → session-DBF-nQvq.mjs} +29 -3
  44. package/dist/{share-Bu_kuOKL.mjs → share-CS2mg27O.mjs} +1 -1
  45. package/dist/{shot-CRRGgxru.mjs → shot-BqwkdtKn.mjs} +4 -4
  46. package/dist/{shot-DBWN8hPP.mjs → shot-D2TQGo2V.mjs} +1 -1
  47. package/dist/show-B1u3DiJw.mjs +101 -0
  48. package/dist/{sizes-wjXDev3b.mjs → sizes-BckcL4Zz.mjs} +1 -1
  49. package/dist/{slots-Dn4Onb0V.mjs → slots-BOcfIqxy.mjs} +15 -3
  50. package/dist/{summary-Y8MY1Wuc.mjs → summary-cPmRDGpX.mjs} +1 -1
  51. package/dist/{sync-CMozOwZ0.mjs → sync-BNWwh8OF.mjs} +205 -7
  52. package/dist/{work-BYWD_1Zf.mjs → work-DRdzXPvg.mjs} +3 -3
  53. package/dist/{work-DJxH7cCX.mjs → work-Nv-n2_Un.mjs} +1 -1
  54. package/docs/app.md +49 -0
  55. package/docs/boards-and-folders.md +37 -6
  56. package/docs/jam-session.md +5 -0
  57. package/docs/live-jam.md +9 -0
  58. package/docs/pdf.md +108 -0
  59. package/docs/performance.md +2 -1
  60. package/docs/publish.md +9 -9
  61. package/docs/sharing.md +11 -0
  62. package/docs/slides.md +9 -0
  63. package/package.json +3 -1
  64. package/src/client/content/index.tsx +4 -2
  65. package/src/client/frame-host/main.tsx +3 -0
  66. package/src/client/shell/App.tsx +71 -24
  67. package/src/client/shell/BoardList.tsx +16 -7
  68. package/src/client/shell/Comments.tsx +77 -16
  69. package/src/client/shell/Play.tsx +24 -22
  70. package/src/client/shell/Toolbar.tsx +4 -3
  71. package/src/client/shell/app-bridge.ts +32 -5
  72. package/src/client/shell/canvas/Canvas.tsx +30 -8
  73. package/src/client/shell/canvas/FrameNode.tsx +3 -1
  74. package/src/client/shell/canvas/ctl.ts +16 -0
  75. package/src/client/shell/commands.ts +20 -0
  76. package/src/client/shell/comments-store.ts +81 -2
  77. package/src/client/shell/devices.tsx +42 -0
  78. package/src/client/shell/goto.ts +56 -9
  79. package/src/client/shell/icons.tsx +11 -4
  80. package/src/client/shell/jam-lines.ts +5 -3
  81. package/src/client/shell/jam-panel.tsx +17 -5
  82. package/src/client/shell/marks-ui.tsx +54 -0
  83. package/src/client/shell/notes.ts +21 -0
  84. package/src/client/shell/pdf-export.tsx +154 -0
  85. package/src/client/shell/pdf-notes.ts +20 -0
  86. package/src/client/shell/recorder.ts +3 -2
  87. package/src/client/shell/show.ts +250 -0
  88. package/src/client/shell/store.ts +79 -48
  89. package/src/client/shell/styles.css +43 -0
  90. package/src/shared/app-api.ts +49 -4
  91. package/src/shared/auto-place.ts +32 -0
  92. package/src/shared/board-tree.ts +3 -0
  93. package/src/shared/board-types.ts +6 -2
  94. package/src/shared/deep-link.ts +212 -0
  95. package/src/shared/devices.ts +89 -0
  96. package/src/shared/events.ts +48 -5
  97. package/src/shared/export-plan.ts +98 -0
  98. package/templates/AGENTS-embedded.md +76 -12
  99. package/templates/AGENTS-studio.md +76 -12
  100. package/templates/instructions/boards.md +6 -5
  101. package/templates/instructions/configure.md +32 -2
  102. package/templates/instructions/iterate.md +8 -0
  103. package/templates/instructions/jam.md +9 -0
  104. package/templates/instructions/publish.md +14 -4
  105. package/templates/instructions/review.md +4 -0
  106. package/templates/instructions/slides.md +67 -1
  107. package/templates/instructions/welcome.md +9 -5
  108. package/templates/playbooks/publish-canvas/PLAYBOOK.md +1 -1
  109. package/dist/config-BezZTiov.mjs +0 -182
@@ -1,9 +1,9 @@
1
1
  import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
2
- import { n as diffEvents } from "./events-CLH4ijKP.mjs";
2
+ import { i as marverHome } from "./slots-BOcfIqxy.mjs";
3
+ import { n as deletedMessages, r as diffEvents } from "./events-Dieo1482.mjs";
3
4
  import { a as readLog, i as listBoards, t as appendEvents } from "./comments-0BSbb04K.mjs";
4
5
  import { t as CLI_TOKEN_CHARS } from "./auth-Dix8wrXV.mjs";
5
- import { i as marverHome } from "./slots-Dn4Onb0V.mjs";
6
- import { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, unlinkSync, writeSync } from "node:fs";
6
+ import { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
7
7
  import { join } from "node:path";
8
8
  import { createHash, randomBytes } from "node:crypto";
9
9
  //#region src/server/sync.ts
@@ -23,13 +23,20 @@ import { createHash, randomBytes } from "node:crypto";
23
23
  * which is traded for one and then forgotten.
24
24
  */
25
25
  var sync_exports = /* @__PURE__ */ __exportAll({
26
+ admitted: () => admitted,
27
+ bindIdentity: () => bindIdentity,
26
28
  connect: () => connect,
27
29
  connectClaim: () => connectClaim,
28
30
  connectToken: () => connectToken,
31
+ heldWords: () => heldWords,
32
+ identityBindings: () => identityBindings,
29
33
  loadCollab: () => loadCollab,
30
34
  localOnlyThreads: () => localOnlyThreads,
35
+ readHeld: () => readHeld,
31
36
  saveCollab: () => saveCollab,
32
- syncOnce: () => syncOnce
37
+ serverCapabilities: () => serverCapabilities,
38
+ syncOnce: () => syncOnce,
39
+ unauthorized: () => unauthorized
33
40
  });
34
41
  /**
35
42
  * The credential does not live in the repository.
@@ -137,6 +144,10 @@ async function syncOnce(root, collab) {
137
144
  if (bres.status === 401) throw new Error("the connect token was rejected - run `comments connect` again");
138
145
  if (!bres.ok) throw new Error(`published canvas answered ${bres.status} - is it up?`);
139
146
  const { rights, legacy } = await bres.json();
147
+ const myId = await fetch(`${base}/__mv/api/me`, { headers: auth }).then(async (r) => r.ok ? (await r.json()).id : void 0, () => void 0);
148
+ if (myId && collab.email) bindIdentity(root, base, collab.email, myId);
149
+ const bindings = identityBindings(root, base);
150
+ const caps = await serverCapabilities(base, auth);
140
151
  const boards = [.../* @__PURE__ */ new Set([
141
152
  ...Object.keys(rights),
142
153
  ...listBoards(dir),
@@ -144,6 +155,7 @@ async function syncOnce(root, collab) {
144
155
  ])];
145
156
  const out = {};
146
157
  const failures = [];
158
+ const held = {};
147
159
  for (const board of boards) {
148
160
  const old = legacy?.board === board;
149
161
  if (!(board in rights) && !old) continue;
@@ -153,13 +165,21 @@ async function syncOnce(root, collab) {
153
165
  continue;
154
166
  }
155
167
  const { events: remote } = await res.json();
156
- const pulled = appendEvents(dir, board, remote).length;
168
+ const pulled = appendEvents(dir, board, admitted(readLog(dir, board), remote, bindings)).length;
157
169
  let pushed = 0;
158
170
  if (rights[board] === "comment" || old) {
159
171
  const local = readLog(dir, board);
160
172
  const marverThreads = localOnlyThreads(local);
161
173
  const shipped = old ? threadIds(local, (e) => legacy.frames.includes(e.frame ?? "")) : null;
162
- const missing = diffEvents(local, remote.map((e) => e.id)).filter((e) => !e.agent && !marverThreads.has(threadOf(e)) && (!shipped || shipped.has(threadOf(e))));
174
+ const gone = deletedMessages([...local, ...remote]);
175
+ const candidates = diffEvents(local, remote.map((e) => e.id)).filter((e) => !e.agent && !marverThreads.has(threadOf(e)) && (!shipped || shipped.has(threadOf(e))) && (caps.delete || e.type !== "delete") && !(e.type === "edit" && gone.has(e.commentId ?? "")));
176
+ const keptHere = unauthorized(candidates, [...local, ...remote], {
177
+ email: collab.email,
178
+ id: myId
179
+ });
180
+ if (keptHere.length) held[board] = keptHere;
181
+ const keep = new Set(keptHere.map((h) => h.id));
182
+ const missing = candidates.filter((e) => !keep.has(e.id));
163
183
  for (let i = 0; i < missing.length; i += 100) {
164
184
  const r = await fetch(`${base}/__mv/api/comments/${board}`, {
165
185
  method: "POST",
@@ -175,12 +195,190 @@ async function syncOnce(root, collab) {
175
195
  }
176
196
  out[board] = {
177
197
  pulled,
178
- pushed
198
+ pushed,
199
+ ...held[board]?.length ? { held: held[board].length } : {}
179
200
  };
180
201
  }
202
+ saveHeld(root, held);
181
203
  if (failures.length) throw new Error(`sync incomplete - ${failures.join(" · ")}`);
182
204
  return out;
183
205
  }
206
+ function unauthorized(events, log, account) {
207
+ const acct = typeof account === "string" ? { email: account } : account ?? {};
208
+ const myEmail = (acct.email ?? "").toLowerCase(), myId = acct.id ?? "";
209
+ if (!myEmail && !myId) return [];
210
+ const mine = (a) => a?.email ? myEmail ? a.email.toLowerCase() === myEmail : null : a?.id ? myId ? a.id === myId : null : false;
211
+ const authorOf = /* @__PURE__ */ new Map();
212
+ const rootOf = /* @__PURE__ */ new Map();
213
+ for (const e of [...log, ...events]) {
214
+ if ((e.type === "create" || e.type === "reply") && e.commentId && !authorOf.has(e.commentId)) authorOf.set(e.commentId, e.author);
215
+ if (e.type === "reply" && e.commentId && e.parentId) rootOf.set(e.commentId, e.parentId);
216
+ if (e.type === "create" && e.commentId) rootOf.set(e.commentId, e.commentId);
217
+ }
218
+ const byAuthor = /* @__PURE__ */ new Set([
219
+ "create",
220
+ "reply",
221
+ "react",
222
+ "edit",
223
+ "reanchor",
224
+ "profile",
225
+ "delete"
226
+ ]);
227
+ const held = /* @__PURE__ */ new Map();
228
+ for (const e of events) {
229
+ let why = null;
230
+ if (byAuthor.has(e.type) && mine(e.author) === false) why = "another-account";
231
+ else if ((e.type === "edit" || e.type === "delete" || e.type === "reanchor") && mine(authorOf.get(e.commentId ?? "")) === false) why = "message-of-another-account";
232
+ if (why) held.set(e.id, {
233
+ id: e.id,
234
+ type: e.type,
235
+ why
236
+ });
237
+ }
238
+ for (let grew = true; grew;) {
239
+ grew = false;
240
+ const keptMsgs = new Set(events.filter((e) => held.has(e.id) && (e.type === "create" || e.type === "reply") && e.commentId).map((e) => e.commentId));
241
+ const keptThreads = new Set([...keptMsgs].map((m) => rootOf.get(m) ?? m).filter((m) => keptMsgs.has(m)));
242
+ for (const e of events) {
243
+ if (held.has(e.id)) continue;
244
+ const target = e.type === "reply" ? e.parentId : e.commentId;
245
+ const root = target ? rootOf.get(target) ?? target : "";
246
+ if (target && keptMsgs.has(target) || root && keptThreads.has(root)) {
247
+ held.set(e.id, {
248
+ id: e.id,
249
+ type: e.type,
250
+ why: "thread-kept-here"
251
+ });
252
+ grew = true;
253
+ }
254
+ }
255
+ }
256
+ return events.filter((e) => held.has(e.id)).map((e) => held.get(e.id));
257
+ }
258
+ /**
259
+ * Identity bindings (Codex r9): an address and the opaque id a published canvas gives it, learned only from that canvas's
260
+ * own `/me`, signed in as that address - never from an event, whose ids anyone may choose. Per canvas origin, kept in
261
+ * `design/.local/identity-bindings.json` (never synced) so a reconnect under another address still recognises the first
262
+ * one's messages as the server projects them.
263
+ */
264
+ const bindingsFile = (root) => join(root, "design", ".local", "identity-bindings.json");
265
+ const readBindings = (root) => {
266
+ try {
267
+ const v = JSON.parse(readFileSync(bindingsFile(root), "utf8"));
268
+ return v && typeof v === "object" && !Array.isArray(v) ? v : {};
269
+ } catch {
270
+ return {};
271
+ }
272
+ };
273
+ const originOf = (base) => {
274
+ try {
275
+ return new URL(base).origin;
276
+ } catch {
277
+ return base.replace(/\/+$/, "");
278
+ }
279
+ };
280
+ function identityBindings(root, base) {
281
+ const all = readBindings(root);
282
+ const here = Object.hasOwn(all, originOf(base)) ? all[originOf(base)] : {};
283
+ const out = Object.create(null);
284
+ for (const [email, id] of Object.entries(here ?? {})) if (typeof id === "string" && /^[0-9a-f]{24}$/.test(id)) out[email.toLowerCase()] = id;
285
+ return out;
286
+ }
287
+ function bindIdentity(root, base, email, id) {
288
+ if (!/^[0-9a-f]{24}$/.test(id) || !email) return;
289
+ const all = readBindings(root);
290
+ const o = originOf(base);
291
+ const here = Object.assign(Object.create(null), Object.hasOwn(all, o) ? all[o] : {});
292
+ if (here[email.toLowerCase()] === id) return;
293
+ here[email.toLowerCase()] = id;
294
+ try {
295
+ mkdirSync(join(root, "design", ".local"), { recursive: true });
296
+ writeFileSync(bindingsFile(root), JSON.stringify({
297
+ ...all,
298
+ [o]: here
299
+ }, null, 1) + "\n", { mode: 384 });
300
+ } catch {}
301
+ }
302
+ const heldFile = (root) => join(root, "design", ".local", "sync-held.json");
303
+ /** The last exchange's kept events, per board - what `marver comments sync` says, and what stays until you change it. */
304
+ function saveHeld(root, held) {
305
+ try {
306
+ if (!Object.keys(held).length) {
307
+ if (existsSync(heldFile(root))) unlinkSync(heldFile(root));
308
+ return;
309
+ }
310
+ mkdirSync(join(root, "design", ".local"), { recursive: true });
311
+ writeFileSync(heldFile(root), JSON.stringify({
312
+ at: Date.now(),
313
+ boards: held
314
+ }, null, 1) + "\n");
315
+ } catch {}
316
+ }
317
+ /** "1 edit kept local: written under another account" - one line per board and reason. */
318
+ function heldWords(held) {
319
+ const by = /* @__PURE__ */ new Map();
320
+ for (const h of held) by.set(h.why, [...by.get(h.why) ?? [], h]);
321
+ const what = (hs) => {
322
+ const types = [...new Set(hs.map((h) => h.type))];
323
+ const n = hs.length;
324
+ return types.length === 1 ? `${n} ${types[0]}${n === 1 ? "" : "s"}` : `${n} events`;
325
+ };
326
+ const words = {
327
+ "another-account": "written under another account",
328
+ "message-of-another-account": "its comment was written under another account",
329
+ "thread-kept-here": "its thread is kept local"
330
+ };
331
+ return [...by].map(([why, hs]) => `${what(hs)} kept local: ${words[why]}`);
332
+ }
333
+ function readHeld(root) {
334
+ try {
335
+ return JSON.parse(readFileSync(heldFile(root), "utf8")).boards ?? {};
336
+ } catch {
337
+ return {};
338
+ }
339
+ }
340
+ /** What a server's comment API takes (`GET /__mv/api/capabilities`, 0.31): anything but a JSON answer that says so
341
+ * (an older server's 404, its gate page) is an older server - nothing new is sent to it. */
342
+ async function serverCapabilities(base, headers = {}) {
343
+ try {
344
+ const r = await fetch(`${base.replace(/\/+$/, "")}/__mv/api/capabilities`, { headers });
345
+ if (!r.ok || !(r.headers.get("content-type") ?? "").includes("application/json")) return { delete: false };
346
+ return { delete: (await r.json())?.delete === true };
347
+ } catch {
348
+ return { delete: false };
349
+ }
350
+ }
351
+ /** What of a pull may join the local log (spec 31, Codex r4): the server validated each event against ITS log, which
352
+ * never held this machine's own messages (Marver's notes, captures - never pushed). So a message id already here is
353
+ * one message's: another event claiming it as a new message is refused, and an edit or a delete of it must come from
354
+ * its original author - never touching Marver's or a local-only message at all. */
355
+ function admitted(local, remote, bindings = {}) {
356
+ const msgs = /* @__PURE__ */ new Map();
357
+ for (const e of local) if ((e.type === "create" || e.type === "reply") && e.commentId && !msgs.has(e.commentId)) msgs.set(e.commentId, e);
358
+ const theirs = /* @__PURE__ */ new Map();
359
+ for (const e of remote) if (e && (e.type === "create" || e.type === "reply") && e.commentId && !theirs.has(e.commentId)) theirs.set(e.commentId, e);
360
+ const key = (a) => (a?.email ?? a?.id ?? "").toLowerCase();
361
+ const localIds = new Set(local.map((e) => e.id));
362
+ const offLimits = localOnlyThreads(local);
363
+ const out = [];
364
+ for (const e of remote) {
365
+ if (!e || typeof e.id !== "string" || localIds.has(e.id)) {
366
+ out.push(e);
367
+ continue;
368
+ }
369
+ if ((e.type === "create" || e.type === "reply") && e.commentId) {
370
+ if (msgs.has(e.commentId)) continue;
371
+ msgs.set(e.commentId, e);
372
+ } else if ((e.type === "edit" || e.type === "delete") && e.commentId) {
373
+ const orig = msgs.get(e.commentId), there = theirs.get(e.commentId);
374
+ if (!orig || !there || there.id !== orig.id || orig.agent || offLimits.has(e.commentId)) continue;
375
+ if (!(orig.author?.email && there.author?.email ? key(orig.author) === key(there.author) : orig.author?.id && there.author?.id ? orig.author.id === there.author.id : !!orig.author?.email && !!there.author?.id ? Object.hasOwn(bindings, key(orig.author)) && bindings[key(orig.author)] === there.author.id : !!orig.author?.id && !!there.author?.email && Object.hasOwn(bindings, key(there.author)) && bindings[key(there.author)] === orig.author.id)) continue;
376
+ if (!key(e.author) || key(e.author) !== key(there.author)) continue;
377
+ }
378
+ out.push(e);
379
+ }
380
+ return out;
381
+ }
184
382
  /** The account endpoints live BEHIND the canvas gate (the outer READ boundary), so
185
383
  * connecting passes the gate first when a canvas password is set. */
186
384
  async function gateCookie(base, canvasPassword) {
@@ -1,6 +1,6 @@
1
1
  import { r as NAME } from "./cli.mjs";
2
- import { i as readDevInfo, n as WORK_TTL_MAX, t as WORK_TTL_DEFAULT } from "./work-DJxH7cCX.mjs";
3
- import { unreachable } from "./link-BFFRgrMt.mjs";
2
+ import { i as readDevInfo, n as WORK_TTL_MAX, t as WORK_TTL_DEFAULT } from "./work-Nv-n2_Un.mjs";
3
+ import { unreachable } from "./link-Cmt9Xy4X.mjs";
4
4
  //#region src/cli/work.ts
5
5
  /**
6
6
  * `marver work` - the coding agent's hand on the canvas working state.
@@ -68,7 +68,7 @@ async function workCommand(root, action, frames, opts) {
68
68
  });
69
69
  console.log(active.length ? `still working: ${active.join(", ")}` : "nothing working - all clear");
70
70
  const done = before.filter((f) => !active.includes(f));
71
- const { links, hints } = done.length ? await (await import("./link-BFFRgrMt.mjs")).handBack(root, done) : {
71
+ const { links, hints } = done.length ? await (await import("./link-Cmt9Xy4X.mjs")).handBack(root, done) : {
72
72
  links: [],
73
73
  hints: []
74
74
  };
@@ -1,5 +1,5 @@
1
1
  import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
2
- import { c as listBoardFiles } from "./boards-EH2onUXM.mjs";
2
+ import { l as listBoardFiles } from "./boards-Cim1GTKc.mjs";
3
3
  import { r as pidRuns } from "./exclusive-B1RtpeeP.mjs";
4
4
  import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
5
5
  import { join } from "node:path";
package/docs/app.md CHANGED
@@ -72,6 +72,45 @@ appears here, with its own tab, a second after it starts."), and for a repo with
72
72
  @marver-design/marver && npx marver init` first. Each command has a button that copies it. Every canvas running on
73
73
  this Mac gets its own tab; `⌘L`, or Home's field, opens a link - a local canvas's, or a shared canvas's.
74
74
 
75
+ A canvas's tab and Home card wear its name and its logo: `name` in its `design/config.ts` (else `share.name`, else
76
+ the folder's name) and `logo` (else `share.logo`, else the first of `design/logo.svg|png`, `public/logo.svg|png`,
77
+ `public/favicon.svg|png|ico`, else Marver's mark). A canvas still on its folder's name or Marver's mark looks like
78
+ every other one in the strip, so `marver dev` says so on its boot line.
79
+
80
+ ## Links into the app
81
+
82
+ When Marver is open with a canvas in a tab, `npx marver link` prints a `marver://` link for that canvas instead of its
83
+ localhost one, and an agent hands you that. Click it anywhere - the terminal, a chat, a note - and Marver comes forward
84
+ on that board, the frames selected and in view:
85
+
86
+ - **The canvas's tab is already open:** Marver never reloads it. The tab moves to the place the link names, as
87
+ `marver show` does - and if you were typing a comment or a Jam edit there, it stays put and says "Your agent wants
88
+ to show you <the frame> · Go" instead, so nothing you typed is lost.
89
+ - **It has no tab yet:** a tab opens on that place.
90
+ - **The canvas is not running:** Home opens with its card first, highlighted, and its start command ready to copy.
91
+
92
+ A link names its canvas by its folder, and only a canvas running from that same folder opens it - never another canvas
93
+ that took the same port later. A link that names no place Marver understands opens the canvas on its board.
94
+ `marver link` gives the `marver://` link only while Marver is in use (it keeps `~/.marver/state/app-live.json` fresh
95
+ every 30 seconds) with that canvas open in a tab; otherwise, and with `--web`, the localhost link.
96
+
97
+ ## A tab's badge and menu
98
+
99
+ Each canvas's tab shows an orange count of what needs you (Marver's questions, captures to review, runs that failed or
100
+ stalled), else a blue dot when frames are new since you looked (no number, from 1.1), else a shimmer while an agent
101
+ works. Right-click the tab of a canvas on this Mac for **Mark All as Seen** and, with Marver 0.31 or later, **Resolve
102
+ All Comments**: every open conversation on that canvas, never what Jam is working on, with Undo. [What the marks
103
+ mean](boards-and-folders.md#what-is-new-what-needs-you).
104
+
105
+ ## Home
106
+
107
+ - **Running canvases** each have a card; one whose Marver has a newer release says "0.31.0 available" with the command
108
+ that updates it, in its own folder, ready to copy.
109
+ - **Recently here** lists the canvases that ran before, with their logo and start command - not those in a temporary
110
+ folder (`/tmp`, `/private/tmp`, `/var/folders`), which are tests and scratch copies.
111
+ - **Shared canvases** show their name and logo once Marver has opened them once (read from the canvas's own
112
+ `meta.json`, through that tab's sign-in).
113
+
75
114
  ## What it asks, and when
76
115
 
77
116
  - **Notices.** Nothing touches macOS's notices or the Dock before you choose. The first time a canvas needs you while
@@ -126,6 +165,16 @@ Check for Updates…:
126
165
  [the disk image](https://github.com/TNEP4/marver-app/releases/latest/download/Marver-arm64.dmg) again, open it,
127
166
  drag Marver into Applications and choose Replace. Your settings and tabs stay.
128
167
 
168
+ ## Exporting a PDF
169
+
170
+ **File > Export PDF…** (app 1.1, a canvas on Marver 0.31 or later) prints the open board as a PDF - one page per slide
171
+ ([Deck PDFs](pdf.md)) - and, when it is ready, opens a save panel on `~/Downloads/<board>.pdf`. The canvas's own Export
172
+ PDF (a board's menu, slides and present mode's toolbar) saves the same way in the app. The canvas sends the app only
173
+ the finished job's id: the app fetches the file itself from that canvas, checks it is a PDF of 200 MB at most, checks
174
+ again that the tab still shows the same canvas page after you chose where to save, and writes it whole.
175
+ In app 1.0.1 (no File > Export PDF…), the canvas's Export PDF ends on a notice with **Download**: 1.0.1 cancels a
176
+ download its window did not start while in front, so the file waits for that click rather than for the last page.
177
+
129
178
  ## The performance report
130
179
 
131
180
  When Marver is slow, crashes or flashes, a report helps find out why. **Help > Export Performance Report…** (also on a
@@ -78,8 +78,9 @@ The sidebar shows where to look.
78
78
  - **One slot per row.** Every row keeps the one item at its right edge it has today, and what matters
79
79
  most takes it: the bubble first, then the row's own count or status, then a frame's dot. A board
80
80
  you are not on turns blue when its frames hold something new, and the bubble takes its status
81
- glyph's place until answered. A closed folder or a folded scene changes only its count: blue when
82
- something inside is new, the bubble when something inside waits on you.
81
+ glyph's place until answered. A closed folder shows the bubble when something inside waits on you,
82
+ else a blue dot when something inside is new, else nothing - never a number for new: it is not a
83
+ to-do count (0.31). An open folder shows how many boards it holds. A folded scene keeps its frame count, blue when something inside is new.
83
84
  - **`U`** goes to the next frame that asks you something, then the next one waiting on you, then the
84
85
  next new one.
85
86
 
@@ -94,15 +95,31 @@ a scene, board or folder - for the version on screen: a change still loading (or
94
95
  focus or play) stays new until its new version shows, and a look you made while it loaded counts as
95
96
  soon as it does.
96
97
 
98
+ **Resolve all comments** sits beside every **Mark all as seen** - a board's, a folder's, a scene's,
99
+ and the Mac app's tab menu - for when the bubbles are noise (0.31). It resolves what that row shows,
100
+ never a log: a board's every open thread on the frames it shows, a folder's over all its boards and
101
+ sub-folders, a scene's on its frames, the tab's every open thread on the canvas. It is the same as
102
+ resolving each one by hand - Jam's questions, reviews and failed runs on them are finished - except
103
+ live work: a thread Jam is queued or working on is left open and counted ("2 left open: work in
104
+ progress"). The notice says how many, with **Undo**: it reopens each thread nothing happened in since - no
105
+ reply, edit, reaction, resolve or reopen ("1 changed since - left as is"); what Jam finished stays finished. From the terminal: `npx marver
106
+ comments resolve --all --board <b>` (`--folder`, `--scene`, `--canvas`, `--dry-run`), then `--undo <op>`
107
+ with the op it prints. Missed the notice's Undo (it shows for 10 seconds)? Every run is kept as
108
+ `design/.local/comment-ops/<op>.json` (its `scope` and `at` say which), and `npx marver comments resolve --undo <op>`
109
+ undoes it. On the board you have open, it saves your latest edits first; while they are not saved it resolves nothing
110
+ and says so ("this board's latest changes are not saved yet"). A published canvas has no Resolve all of its own: run it
111
+ here, and each thread it resolves reaches the published canvas with the next sync.
112
+
97
113
  The marks start when `marver dev` starts, so whatever your agent makes before you open the canvas is
98
114
  new when you do; everything already there the first time counts as seen. They live in
99
115
  `design/.local/`, on this machine only, and a published canvas shows none. `npx marver marks` prints
100
- them - for you, or for your agent at the start of a session.
116
+ them, and the open conversations per board - for you, or for your agent at the start of a session.
101
117
 
102
118
  **In the Mac app** (0.3, with Marver 0.29), each canvas's tab sums this up, even while it is hidden: an
103
119
  orange count of what needs you - Marver's questions, captures to review, runs that failed or stalled -
104
- else a blue count of new frames, else a shimmer while an agent works, and a teal dot while a Jam session
105
- runs. Turn notices on and a canvas you are not looking at sends one when something new needs you, and the
120
+ else a blue dot for new frames (no number, from app 1.1), else a shimmer while an agent works, and a teal
121
+ dot while a Jam session runs. Its right-click menu holds **Resolve All Comments** beside **Mark All as
122
+ Seen** for a canvas on Marver 0.31 or later. Turn notices on and a canvas you are not looking at sends one when something new needs you, and the
106
123
  Dock counts them all. Clicking a notice opens what it names where you can see it, on its board: a question
107
124
  in its thread on the frame (Play left and hidden pins shown for it), or in a panel with a field to answer
108
125
  when no frame on the board holds it; a review in its review; a failed run with Retry in view, a stalled
@@ -274,7 +291,21 @@ last); frames that sit on several boards get one link per board, and a frame on
274
291
  instead of a link. `--board` picks one. The link reads `#/b/<board>?f=<scene/frame>,...` (or
275
292
  `?s=<scene>` for a whole scene), and a link naming a frame its board does not show follows the
276
293
  frame to where it lives. `npx marver work done` prints the same links for the frames it clears, so an
277
- agent's reply ends with them. A focus link (`#/f/<frame>`) opened on your dev canvas now has its way
294
+ agent's reply ends with them. When the Mac app has this canvas open in a tab, each of them is a `marver://` link that
295
+ opens it there ([Links into the app](app.md#links-into-the-app)); `--web` prints the localhost link anyway.
296
+
297
+ ## Showing you a place
298
+
299
+ `npx marver show <scene/frame | scene ... | board>` (needs `marver dev`) moves every tab where this canvas is open to
300
+ that place - its board, selected, the camera fitted, even when it is already there - and in the Mac app brings that tab
301
+ and the window forward. A name alone is a board, fitted whole, when no frame or scene has that name. `--thread <id>`
302
+ opens a comment thread there too; frames on two boards are refused (show one board at a time). A tab where you are
303
+ typing (a comment, a Jam edit) or recording a capture does not move: it says "Your agent wants to show you <title> ·
304
+ Go", and Go takes you. Click, pan or press a key while it is on its way and yours wins: it stops. The command waits 3
305
+ seconds and says "shown in 2 tabs" (or "not shown - no open tab took it" when no tab answered), then prints the link. Agents run it only
306
+ when you ask to be shown; otherwise they give the link.
307
+
308
+ A focus link (`#/f/<frame>`) opened on your dev canvas now has its way
278
309
  back to the canvas (the grid button, or Esc); on a published canvas a focus link stays a page of
279
310
  its own.
280
311
 
@@ -229,6 +229,11 @@ Threads live in `design/comments/<board>.jsonl`, which is committed with the res
229
229
  comment would. They never reach a published canvas: `marver build` and `marver comments sync`
230
230
  leave capture threads (and Marver's notes and replies) on your machine. The session
231
231
  **record** your agent writes goes to `context/sessions/`, also meant to be committed.
232
+
233
+ In its thread, a capture's own comment can be deleted but not edited (0.31): Jam keeps the words it took, so an edit
234
+ would change what you see and never what your agent gets. Deleting it withdraws a capture your agent has not been
235
+ handed yet, as deleting a tagged comment does ([A deleted comment](live-jam.md#a-deleted-comment-031)); its tile reads
236
+ "Withdrawn capture".
232
237
  Published canvases carry none of Jam: no captures, no queue, no microphone.
233
238
 
234
239
  ## A capture left on an old address
package/docs/live-jam.md CHANGED
@@ -251,6 +251,15 @@ The larger caution is unchanged and worth stating plainly: `marver dev` imports
251
251
  `design/config.ts`, so running a dev server in a repo you do not trust is already running
252
252
  that repo's code. Live Jam adds no new hole to that; it does not make it safe.
253
253
 
254
+ ### A deleted comment (0.31)
255
+
256
+ Delete one of your messages and Jam lets go of it: a request still queued drops it (a card left with no
257
+ request is dropped), and a run that has not been handed to the agent yet - a card is "working" while its
258
+ pictures are taken - has the message taken out of its packet, per message, history included; a frozen packet
259
+ recovered after a restart is rebuilt the same way. Work already handed to an agent cannot unread it: a
260
+ deleted message it read is in that run's context, though its reply never quotes it back. `marver comments
261
+ list` and the context the agent reads never show a deleted message's words.
262
+
254
263
  ## Provenance
255
264
 
256
265
  Every jam reply is stamped with who acted: your dev user, the harness that ran, and the
package/docs/pdf.md ADDED
@@ -0,0 +1,108 @@
1
+ # Deck PDFs
2
+
3
+ `npx marver pdf <board>` turns a board into a PDF: one page per slide, exactly what the stage shows, with real text you
4
+ can search and copy, vector shapes, and links that click. The running `marver dev` makes it with your own Chrome, so
5
+ what prints is the frame your agent built - fonts, images, charts and all.
6
+
7
+ ```sh
8
+ npx marver pdf pitch # design/exports/pitch.pdf
9
+ npx marver pdf pitch --notes # design/exports/pitch-notes.pdf - a handout with the speaker notes
10
+ npx marver pdf pitch --theme dark --out ~/Desktop/pitch.pdf
11
+ ```
12
+
13
+ On the canvas: **Export PDF** in a board's menu (right-click it in the sidebar), and the export button in slides and
14
+ present mode's toolbar, which prints in the theme the stage shows. A notice shows the page it is on, with Cancel; the
15
+ file downloads when it is done. In the Mac app, **File > Export PDF…** does the same for the open board and asks where
16
+ to save it. App 1.0.1 has no save panel for it: there the notice keeps the finished PDF and offers **Download**, since
17
+ that app drops a download its window did not start while in front. The canvas exports with the
18
+ defaults: the handout (`--notes`), `--paper`, `--raster`, `--vector`, `--keep-going` and `--out` are the command's.
19
+
20
+ ## What goes in the PDF
21
+
22
+ - **A slides board** (its publish row plays it as slides) prints its deck: its `slide: true` frames in reading order -
23
+ top to bottom, then left to right - each once, as slides mode plays them. The publish row decides, not the mode you
24
+ are in: a board with no such row prints as any other board below, even from slides mode's export button. A board's
25
+ own type (`"type": "deck"` in its JSON) does not decide it either.
26
+ - **Any other board** prints its frames in the board's order, as Play walks them, html frames included. A slide frame
27
+ is its stage size on any board; any other frame is printed at the device Play shows it at - the viewport whose width
28
+ is its node's on the board, else the frame's own viewport, else the first - at that viewport's height.
29
+ - **Each page is the slide's own size** (1280×720 is 13.33 × 7.5 in), margins zero. A slide taller than its stage is
30
+ cut where the stage cuts it, and the report names it *clipped*.
31
+ - **The finished slide.** Entrances show their end state (the PDF is never "playing"), animations are stopped where
32
+ they end - an infinite one at its first pose, so a spinning mark rests upright - and a video shows its first frame.
33
+ Motion driven by your own `requestAnimationFrame` code cannot be stopped from outside: it prints as it is two frames
34
+ after the slide settles.
35
+ - **Screen styles, not print styles.** `@media print` and Tailwind's `print:` are ignored: the page is the slide you see.
36
+ - **Images at full resolution.** Every image is printed from its original file, never the downscaled copy the canvas
37
+ shows while you zoom.
38
+ - **Bookmarks** - one per page, named by the frame's title - and the PDF's title (the board's), author (the canvas's
39
+ name) and creator (`Marver x.y.z`).
40
+ - **Theme**: `--theme` when you give one, else the theme pinned on the frame's node, else the frame's own, else light.
41
+
42
+ ## Effects Chrome cannot print
43
+
44
+ Some CSS effects come out wrong when Chrome prints: a frosted-glass `backdrop-filter` prints transparent, a `filter`,
45
+ `mix-blend-mode` or a CSS `mask` prints as a grey box, a large soft `box-shadow` prints as a hard grey rectangle, and a
46
+ `<canvas>` or `<video>` may print blank. (A `filter` that is only `drop-shadow()` prints right, and is left as it is.)
47
+ Marver fixes each one element by element, and checks its own work:
48
+
49
+ - **Glass** keeps its children live (text, links, icons stay vector and selectable); only the blurred backdrop behind it
50
+ becomes a picture, taken at 3x (lowered for a large slide so one picture stays under 16 megapixels: 2.75x at
51
+ 1920×1080, 1x at 4096×4096).
52
+ - **A filtered, blended or masked box, a canvas, a video** becomes a 3x picture of itself, including the shadow or blur
53
+ that spills past its edge; any link inside it stays clickable.
54
+ - **A large soft shadow** is redrawn as a stack of sharp vector shadows that follows the blur's falloff - no picture
55
+ at all.
56
+ - **An effect on the page itself** (a filter or blend on `body` or `html`) has nothing to be patched into: that page is
57
+ printed as a 3x picture, and the report says why. So is an effect under a rotation or a skew.
58
+
59
+ Then the fixed page is compared with the unfixed screenshot, taken before anything was prepared for print. A fix that
60
+ changes more than 1 % of its own area, or anything outside it, is thrown away and that page is printed as a 3x picture
61
+ instead (*raster*). Every printed page is also rasterised (macOS `sips`) and compared with the screen - pixel by pixel,
62
+ allowing only the edge differences two renderers make, and area by area - which catches anything that only goes wrong
63
+ in print: such a page becomes a picture too. Where there is no rasteriser (not on a Mac), the report says *screen-certified only*.
64
+
65
+ `--raster` prints every page as a picture at that same scale (no vector text). `--vector` fixes nothing: every page exactly as Chrome
66
+ prints it (a page whose print differs from the screen is named, and kept).
67
+
68
+ ## The report
69
+
70
+ ```
71
+ design/exports/mark-ii.pdf - 32 pages, 2.7 MB, 17.8 s
72
+ patched: mark-ii/12-chat (::after mix-blend-mode: soft-light; mask-image), mark-ii/17b-navigation-views (backdrop-filter; box-shadow)
73
+ every page print-certified (rasterised and compared with the screen)
74
+ ```
75
+
76
+ Each kind of slide that needs a look is named: **skipped** (a frame the manifest no longer lists, or a non-slide frame
77
+ on a slides board), **failed**, **patched** (and with what), **raster** (and why), **unsettled** (still loading images or
78
+ charts after 10 s - printed anyway), **clipped**, **spilled** (Chrome made more than one page; the first is kept),
79
+ **changed while printing** (its source changed while it rendered and again on the second try, or the frame left the
80
+ board), and with `--vector` **printed differently from the screen** (kept as Chrome printed it). The last line says
81
+ whether every page was print-certified, or screen-certified only. `--json` prints all of it, slide by slide, with the
82
+ file's absolute path.
83
+
84
+ A slide that fails to render fails the export - a PDF is never handed over with a page missing. `--keep-going` prints
85
+ the rest and leaves the failed page blank, named in the report. The command then exits 1, though the PDF is written.
86
+
87
+ ## The handout (`--notes`)
88
+
89
+ `--notes` prints a handout instead: each slide's picture, its title, and its notes (the frame's `.note.md`, rendered as
90
+ Markdown at 11 pt or more) - "No notes" where there are none. Long notes continue on the next page. Letter landscape by
91
+ default, `--paper a4` for A4. Page numbers in the footer, a bookmark per slide. The slides in a handout are pictures:
92
+ the deck PDF is the one you search.
93
+
94
+ ## What it does not do
95
+
96
+ - **Not a tagged (accessible) PDF**: the pages are merged with pdf-lib, which keeps each page but not Chrome's structure
97
+ tree. The handout, printed as one document, is tagged.
98
+ - **Links between slides** (`data-goto`) do not carry over; `https:` and `mailto:` links do.
99
+ - **Published canvases** cannot export: the build has no browser. Export from `marver dev`.
100
+ - A CJK character may copy out of the PDF as its compatibility form (a Kangxi radical) - how Chrome's font subsets map
101
+ it; it displays and prints right.
102
+
103
+ ## Limits
104
+
105
+ One PDF at a time per canvas (a second is refused, naming the one running). 300 pages at most, a page side of 4096 CSS
106
+ px at most, 15 minutes, 500 MB. The job's folder (`design/.local/pdf/`) keeps only the finished file, for an hour, and
107
+ is emptied when `marver dev` starts. `marver init` keeps `design/exports/` out of git. The Mac app saves a PDF of 200 MB
108
+ at most; a larger one says "not saved (too-large)": export it with `npx marver pdf`.
@@ -182,7 +182,8 @@ Each frame of a load ends at one outcome:
182
182
 
183
183
  An outcome counts only from the document the frame shows now: a message from a document since replaced, or
184
184
  from one a reload is replacing, never counts. When the same board is read again its frames keep their
185
- documents, and a frame whose document is older than the load is marked `kept`. A load with missing or
185
+ documents, and a frame whose document is older than the load is marked `kept` - all but a frame that had failed, one
186
+ silent past its retry, and one whose sizing the file changed: those load again, and are not `kept`. A load with missing or
186
187
  never-ready frames settles anyway, and says so.
187
188
 
188
189
  ## Moves and why
package/docs/publish.md CHANGED
@@ -251,14 +251,14 @@ mention from the page metadata, the sign-in screens included).
251
251
 
252
252
  ### Name the canvas
253
253
 
254
- `share: { name: "Your App" }` in `design/config.ts`. That name titles the gate,
255
- labels the brand pill, and becomes `utm_campaign` on every powered-by link the
256
- canvas emits, so site analytics can tell which canvas sent a visitor. Unset, the gate
257
- falls back to your `package.json` name and the canvas shell to the root
258
- directory name - which inside a container is usually `app`, so every unnamed
259
- containerised canvas reports as one campaign.
260
-
261
- Your logo - `share.logo`, else the first of `design/logo.svg|png`, `public/logo.svg|png`
254
+ `name: "Your App"` in `design/config.ts` (`share: { name }` still works; `name` wins). That
255
+ name titles the gate, labels the brand pill, names the canvas in the Mac app, and becomes
256
+ `utm_campaign` on every powered-by link the canvas emits, so site analytics can tell which
257
+ canvas sent a visitor. Unset, the gate falls back to your `package.json` name and the
258
+ canvas shell to the root directory name - which inside a container is usually `app`, so
259
+ every unnamed containerised canvas reports as one campaign.
260
+
261
+ Your logo - `logo` in the config, else `share.logo`, else the first of `design/logo.svg|png`, `public/logo.svg|png`
262
262
  and `public/favicon.svg|png|ico` - ships with the build. The gate shows it, and since
263
263
  0.29 it is the only tab icon of the canvas and the gate, so a browser tab (and the Mac
264
264
  app's tab for a shared canvas) wears it rather than Marver's mark. With no logo, the tab
@@ -283,7 +283,7 @@ Deploy. The repo itself is the deployable - nothing to export, nothing to sync.
283
283
  FROM node:22-slim
284
284
  RUN apt-get update && apt-get install -y --no-install-recommends chromium fonts-liberation \
285
285
  && rm -rf /var/lib/apt/lists/* # the browser `marver build` compiles the glass textures with
286
- WORKDIR /app # set share.name in design/config.ts - the fallback name is this directory
286
+ WORKDIR /app # set name in design/config.ts - the fallback name is this directory
287
287
  COPY . .
288
288
  RUN npm ci && npx marver build # as root in a container: marver adds Chrome's --no-sandbox itself
289
289
  ENV PORT=8080
package/docs/sharing.md CHANGED
@@ -276,6 +276,17 @@ board". Note the gate's own entry check short-circuits step 1 for the owner - th
276
276
  owner is always admitted so the canvas can be administered - which is the one
277
277
  place the blocklist does not have the last word.
278
278
 
279
+ ### What `comment` lets a person do with a thread
280
+
281
+ Anyone with `comment` on a board may write, reply, react, and **resolve or reopen any thread** on it - not only
282
+ their own. Editing and deleting a message stays its author's: the canvas compares the address of whoever wrote
283
+ the original comment or reply with the signed-in account's (0.31 adds delete; a deleted message's replies stay,
284
+ under "Comment deleted"). A canvas older than 0.31 takes no deletes: a delete made on your machine waits there,
285
+ held back by `marver dev`'s sync, until the canvas is upgraded, and its shell offers no Delete. Connected under a new
286
+ address, an edit or delete of a comment the old address wrote (or anything still signed with the old address) stays on
287
+ your machine - the canvas would refuse it - and `marver comments sync` says so ("1 edit kept local: its comment was
288
+ written under another account"); everything else still syncs.
289
+
279
290
  ## Mail, mentions, and the bell (v1.1)
280
291
 
281
292
  Sharing's mail rides one relay at the identity service, and the canvas can only