Skip to content

docs(specs): browser TODO persists across restart via the alert blob#194

Merged
nedtwigg merged 4 commits into
mainfrom
docs/browser-todo-persistence
Jun 30, 2026
Merged

docs(specs): browser TODO persists across restart via the alert blob#194
nedtwigg merged 4 commits into
mainfrom
docs/browser-todo-persistence

Conversation

@dormouse-bot

Copy link
Copy Markdown
Collaborator

The recent "Persist browser surface TODO state" work added full cross-restart persistence for a browser Surface's todo, but two spec passages still described the older live-only behavior.

What the code now does (lib/src/lib/): a browser pane's TODO is saved into PersistedPane.alert (session-save.ts via browserPersistedPane) and re-primed on both cold restore (session-restore.ts) and live resume (reconnect.ts) through restoreBrowserSurfaceTodo.

Spec corrections:

  • glossary.md (Implementation status) and alert.md (stage-2a blockquote): "round-trips to the activity store live" understated the now-implemented persistent path — clarified that it also persists across restart via the alert blob.
  • alert.md (Workspace union membership): said a browser Surface's todo "survives in its persisted params", but it survives in the persisted alert blob (PersistedPane.alert), not the dockview render/door params. Corrected.

Docs-only change, so no regression test.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 30, 2026

Copy link
Copy Markdown

Deploying mouseterm with  Cloudflare Pages  Cloudflare Pages

Latest commit: af6b762
Status: ✅  Deploy successful!
Preview URL: https://f6cd935b.mouseterm.pages.dev
Branch Preview URL: https://docs-browser-todo-persistenc.mouseterm.pages.dev

View logs

…on note

The union-membership note still said a browser Surface's todo survives in
its 'persisted params', the same imprecision this PR corrects in alert.md.
A browser Surface's todo survives in the persisted alert blob, not the
dockview render/door params.

Co-Authored-By: Claude <noreply@anthropic.com>
nedtwigg added 2 commits June 30, 2026 11:53
…sistence

# Conflicts:
#	docs/specs/alert.md
#	docs/specs/glossary.md
@nedtwigg nedtwigg merged commit 1370ead into main Jun 30, 2026
4 checks passed
@nedtwigg nedtwigg deleted the docs/browser-todo-persistence branch June 30, 2026 19:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants