sdk: release 0.2.31

[foxnne]

What changes

sdk_version goes from 0.2.30 to 0.2.31. Merging this tags sdk-v0.2.31 and publishes its tarball. sdk-repin then asks each store plugin to repin.

Why now: the SDK's shape has moved several times since 0.2.30. Store plugins and apps built on fizzy, Graphl among them, only get the new calls once they're released. Most of them come from Graphl's report.

SDK impact

• None
• Core-only or additive: reaches plugins at the next SDK release
• Fingerprint moved: recorded in sdk/src/version.zig, sdk_version untouched, PR labelled sdk
• SDK release: bumps sdk_version, lists the sdk PRs since the last sdk-v* tag

sdk PRs since sdk-v0.2.30:

• sdk: a plugin has a data folder of its own #560: a plugin's own data folder. host.pluginDataFolder(plugin) gives <config>/plugin-data/<id>, made on first ask. It's the plugin's own from register through deinit, and stays on disk after uninstall.
• sdk: a plugin's data folder entry goes with the plugin #587: the data folder goes with the plugin. Host.retirePlugin unregisters a plugin, runs its deinit, then tells the app, so a plugin can still write out state in deinit. On EditorAPI, pluginUnregistered became pluginRetired; that vtable is implemented by the app, not by plugins.
• sdk: a plugin can put a tray's or a lone float's view away #593: put a view away. host.hideSurface(id) shuts the tray whose shown view is id, or closes a float that holds only id. Anything else returns false. Mid-frame it acts after the frame has drawn. A toggle is if (!host.hideSurface(id)) _ = host.revealSurface(id);.
• app: recent folders remember when they were opened #603: times on recent folders. host.recentFolderOpened(i) returns when recent folder i was opened, in Unix seconds, or null if unknown. recentFolderAt is unchanged.
• workbench: a home surface replaces the built-in home page #599: a home page. sdk.keywords.ide.home is new. While the workbench's pane is empty, it shows a surface keyworded home in place of its own page. The fingerprint didn't move; a plugin on an older SDK can write &.{"home"}.
• sdk: undoing someone else's step is announced as fizzy.history.undone #581: undo is announced. Undoing someone else's step is announced as fizzy.history.undone, with a payload type events.StepTaken. Additive; the fingerprint didn't move.
• sdk + text: an owner puts a document's history back from its track #609: history restore. An optional restoreHistory hook and sdk.Plugin.RestoredHistory. Plugins without the hook are unaffected.

Core change plugins pick up at this release (no boundary change): #550, a replayed backdrop captures inside a front-to-back block. (app/ changes since 0.2.30, such as #570 and #602, are not compiled into plugins.)

Verified

• macOS: scripts/check-fmt.sh and zig build test-sdk-version pass. The fingerprint is main's recorded value; only sdk_version changed.
• Windows:
• Linux: CI
• Web:

Follow-ups

• Repin and release the store plugins (pixi, zig, ghostty, drive, atlas; then agent and chat) when sdk-repin opens their PRs.
• Make 0.2.31 live on fizzyed.it/app once the repinned plugins are in the store: gh workflow run web.yml --ref main -f go_live=0.2.31.

🤖 Generated with Claude Code