Release Discipline

Version Bump

Every code change must bump the version in:

• src/main.zig APP_VERSION
• the stable and DEV title strings in src/main.zig
• AGENTS.md current version line

The title bar is the human verification source.

DEV First

Risky UI, browser geometry, workspace restore, and zsb routing changes should be proven in DEV before replacing stable.

DEV checks should include:

• visible title bar version
• screenshot where applicable
• inbox-*.json state when changing indicators or sort order
• browser pane geometry checks when changing Edge layout
• zsb status/doctor checks when changing pane routing

Stable

Only update stable when the user approves or asks for it. Stable is where important live agent sessions run.

Before rebuilding stable, close ZigShell gracefully when possible so sessions are saved.

Commit Message

Use:

vX.Y.Z: Brief description

Do Not Persist Runtime State

Do not persist:

• spinners
• blue dots
• temporary browser HWNDs as authoritative state
• overlay visibility

Runtime state should be rebuilt from explicit events, live windows, and binding files.