@sealant/mend 0.36.0-next.628 → 0.36.0-next.643

package/man/mend-attach.1

@@ -1,4 +1,4 @@
-.TH MEND-ATTACH 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-ATTACH 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-attach \- reattach this terminal to a running session
 .SH SYNOPSIS

package/man/mend-codex.1

@@ -1,4 +1,4 @@
-.TH MEND-CODEX 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-CODEX 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-codex \- launch codex, claude, opencode or pi in a recorded worktree
 .SH SYNOPSIS

package/man/mend-completions.1

@@ -1,4 +1,4 @@
-.TH MEND-COMPLETIONS 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-COMPLETIONS 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-completions \- print the TAB\-completion hook
 .SH SYNOPSIS

package/man/mend-connect-pi.1

@@ -1,4 +1,4 @@
-.TH MEND-CONNECT-PI 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-CONNECT-PI 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-connect\-pi \- send your pi setup to every pi session of yours
 .SH SYNOPSIS

package/man/mend-connect.1

@@ -1,4 +1,4 @@
-.TH MEND-CONNECT 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-CONNECT 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-connect \- send this machine's provider credential to the platform
 .SH SYNOPSIS

package/man/mend-continue.1

@@ -1,4 +1,4 @@
-.TH MEND-CONTINUE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-CONTINUE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-continue \- resume a session with its pending review follow\-up
 .SH SYNOPSIS

package/man/mend-doctor.1

@@ -1,4 +1,4 @@
-.TH MEND-DOCTOR 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-DOCTOR 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-doctor \- check this machine's setup, or bundle it for a bug report
 .SH SYNOPSIS

package/man/mend-dotfiles-repo.1

@@ -1,4 +1,4 @@
-.TH MEND-DOTFILES-REPO 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-DOTFILES-REPO 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-dotfiles\-repo \- set or clear the repository the server clones at launch
 .SH SYNOPSIS

package/man/mend-dotfiles-sync.1

@@ -1,4 +1,4 @@
-.TH MEND-DOTFILES-SYNC 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-DOTFILES-SYNC 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-dotfiles\-sync \- capture config files from this machine into your store
 .SH SYNOPSIS

package/man/mend-dotfiles.1

@@ -1,4 +1,4 @@
-.TH MEND-DOTFILES 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-DOTFILES 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-dotfiles \- your dotfiles on the server: repo and synced files
 .SH SYNOPSIS

package/man/mend-env-cluster.1

@@ -1,4 +1,4 @@
-.TH MEND-ENV-CLUSTER 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-ENV-CLUSTER 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-env\-cluster \- bind Kubernetes secrets and configmaps to the workspaces
 .SH SYNOPSIS

package/man/mend-env-load.1

@@ -1,4 +1,4 @@
-.TH MEND-ENV-LOAD 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-ENV-LOAD 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-env\-load \- load a .env into the project
 .SH SYNOPSIS

package/man/mend-env-show.1

@@ -1,4 +1,4 @@
-.TH MEND-ENV-SHOW 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-ENV-SHOW 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-env\-show \- what the project store holds: names only, never values
 .SH SYNOPSIS

package/man/mend-folder-create.1

@@ -1,4 +1,4 @@
-.TH MEND-FOLDER-CREATE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-FOLDER-CREATE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-folder\-create \- create an organization folder
 .SH SYNOPSIS

package/man/mend-folder-list.1

@@ -1,4 +1,4 @@
-.TH MEND-FOLDER-LIST 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-FOLDER-LIST 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-folder\-list \- list your organization's folders
 .SH SYNOPSIS

package/man/mend-folder-push.1

@@ -1,4 +1,4 @@
-.TH MEND-FOLDER-PUSH 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-FOLDER-PUSH 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-folder\-push \- upload a local directory into a folder
 .SH SYNOPSIS

package/man/mend-folder-rm.1

@@ -1,4 +1,4 @@
-.TH MEND-FOLDER-RM 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-FOLDER-RM 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-folder\-rm \- remove an organization folder
 .SH SYNOPSIS

package/man/mend-git-author.1

@@ -1,4 +1,4 @@
-.TH MEND-GIT-AUTHOR 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-GIT-AUTHOR 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-git\-author \- the name and email your workspaces commit as
 .SH SYNOPSIS

package/man/mend-help.1

@@ -1,4 +1,4 @@
-.TH MEND-HELP 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-HELP 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-help \- this index, or one command's page
 .SH SYNOPSIS

package/man/mend-invite.1

@@ -1,4 +1,4 @@
-.TH MEND-INVITE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-INVITE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-invite \- print a one\-time link that adds someone to your organization
 .SH SYNOPSIS

package/man/mend-keys-init.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-INIT 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-KEYS-INIT 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-keys\-init \- create your Mend key (ed25519) on the server
 .SH SYNOPSIS

package/man/mend-keys-mode.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-MODE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-KEYS-MODE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-keys\-mode \- how your remotes are reached: mend\-key or bridge
 .SH SYNOPSIS

package/man/mend-keys-share.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-SHARE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-KEYS-SHARE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-keys\-share \- relay this machine's ssh\-agent to the server
 .SH SYNOPSIS

package/man/mend-keys-show.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-SHOW 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-KEYS-SHOW 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-keys\-show \- print your Mend public key
 .SH SYNOPSIS

package/man/mend-land.1

@@ -1,4 +1,4 @@
-.TH MEND-LAND 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-LAND 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-land \- push a session's change to origin and open its pull request
 .SH SYNOPSIS

package/man/mend-login.1

@@ -1,4 +1,4 @@
-.TH MEND-LOGIN 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-LOGIN 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-login \- sign this terminal in through the browser
 .SH SYNOPSIS

package/man/mend-logout.1

@@ -1,4 +1,4 @@
-.TH MEND-LOGOUT 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-LOGOUT 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-logout \- revoke this terminal's device token and forget it
 .SH SYNOPSIS

package/man/mend-man.1

@@ -1,4 +1,4 @@
-.TH MEND-MAN 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-MAN 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-man \- one command's page, or the whole manual, in man
 .SH SYNOPSIS

package/man/mend-members.1

@@ -1,4 +1,4 @@
-.TH MEND-MEMBERS 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-MEMBERS 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-members \- who belongs to your organization, and their roles
 .SH SYNOPSIS

package/man/mend-memory-import.1

@@ -1,4 +1,4 @@
-.TH MEND-MEMORY-IMPORT 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-MEMORY-IMPORT 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-memory\-import \- bring this machine's claude and codex memory for the repository
 .SH SYNOPSIS

package/man/mend-memory-rm.1

@@ -1,4 +1,4 @@
-.TH MEND-MEMORY-RM 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-MEMORY-RM 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-memory\-rm \- remove one memory file
 .SH SYNOPSIS

package/man/mend-memory-show.1

@@ -1,4 +1,4 @@
-.TH MEND-MEMORY-SHOW 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-MEMORY-SHOW 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-memory\-show \- print one memory file
 .SH SYNOPSIS

package/man/mend-memory.1

@@ -1,4 +1,4 @@
-.TH MEND-MEMORY 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-MEMORY 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-memory \- what the agents remember about a project, for you
 .SH SYNOPSIS

package/man/mend-models.1

@@ -1,4 +1,4 @@
-.TH MEND-MODELS 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-MODELS 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-models \- the models each harness offers, as the server lists them
 .SH SYNOPSIS

package/man/mend-operator-exposure.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-EXPOSURE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-OPERATOR-EXPOSURE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-operator\-exposure \- how this instance is exposed, as declared and as observed
 .SH SYNOPSIS

package/man/mend-operator-gate.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-GATE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-OPERATOR-GATE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-operator\-gate \- what MEND_TENANCY=multi still needs on this instance
 .SH SYNOPSIS

package/man/mend-operator-grant-owner.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-GRANT-OWNER 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-OPERATOR-GRANT-OWNER 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-operator\-grant\-owner \- make an existing member an owner
 .SH SYNOPSIS

package/man/mend-operator-org-create.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-ORG-CREATE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-OPERATOR-ORG-CREATE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-operator\-org\-create \- create an organization (multi tenancy only)
 .SH SYNOPSIS

package/man/mend-operator-org-invite-owner.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-ORG-INVITE-OWNER 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-OPERATOR-ORG-INVITE-OWNER 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-operator\-org\-invite\-owner \- print a one\-time owner invitation for an organization
 .SH SYNOPSIS

package/man/mend-operator-org-list.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-ORG-LIST 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-OPERATOR-ORG-LIST 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-operator\-org\-list \- list organizations with their member and owner counts
 .SH SYNOPSIS

package/man/mend-operator-org-rename.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-ORG-RENAME 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-OPERATOR-ORG-RENAME 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-operator\-org\-rename \- rename an organization
 .SH SYNOPSIS

package/man/mend-operator-reset-link.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-RESET-LINK 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-OPERATOR-RESET-LINK 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-operator\-reset\-link \- print a one\-time password reset link for an account
 .SH SYNOPSIS

package/man/mend-pair.1

@@ -1,4 +1,4 @@
-.TH MEND-PAIR 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-PAIR 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-pair \- pair a phone or a second machine
 .SH SYNOPSIS

package/man/mend-projects.1

@@ -1,4 +1,4 @@
-.TH MEND-PROJECTS 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-PROJECTS 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-projects \- adopted projects and their live sessions
 .SH SYNOPSIS

package/man/mend-pull.1

@@ -1,4 +1,4 @@
-.TH MEND-PULL 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-PULL 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-pull \- fetch a session's change into this clone as mend/<name>
 .SH SYNOPSIS

package/man/mend-refresh.1

@@ -1,4 +1,4 @@
-.TH MEND-REFRESH 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-REFRESH 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-refresh \- fetch origin's branches into the store
 .SH SYNOPSIS

package/man/mend-rejoin.1

@@ -1,4 +1,4 @@
-.TH MEND-REJOIN 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-REJOIN 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-rejoin \- attach if live, otherwise resume
 .SH SYNOPSIS

package/man/mend-resume.1

@@ -1,4 +1,4 @@
-.TH MEND-RESUME 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-RESUME 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-resume \- rejoin a settled session with its state restored
 .SH SYNOPSIS

package/man/mend-run.1

@@ -1,4 +1,4 @@
-.TH MEND-RUN 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-RUN 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-run \- run any command as a session
 .SH SYNOPSIS

package/man/mend-secrets-add.1

@@ -1,4 +1,4 @@
-.TH MEND-SECRETS-ADD 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SECRETS-ADD 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-secrets\-add \- keep a file as a secret file, or replace one
 .SH SYNOPSIS

package/man/mend-secrets-rm.1

@@ -1,4 +1,4 @@
-.TH MEND-SECRETS-RM 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SECRETS-RM 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-secrets\-rm \- remove a secret file
 .SH SYNOPSIS

package/man/mend-secrets.1

@@ -1,4 +1,4 @@
-.TH MEND-SECRETS 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SECRETS 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-secrets \- your secret files: written into every session you launch
 .SH SYNOPSIS

package/man/mend-server-logs.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-LOGS 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVER-LOGS 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-server\-logs \- print a bounded tail of the installation's container logs
 .SH SYNOPSIS

package/man/mend-server-restart.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-RESTART 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVER-RESTART 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-server\-restart \- restart Mend using the same generation and pin
 .SH SYNOPSIS

package/man/mend-server-setup.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-SETUP 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVER-SETUP 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-server\-setup \- install or repair the local Mend server
 .SH SYNOPSIS

package/man/mend-server-start.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-START 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVER-START 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-server\-start \- start the selected server generation
 .SH SYNOPSIS

package/man/mend-server-status.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-STATUS 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVER-STATUS 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-server\-status \- show the pin, generation, containers, edge and posture
 .SH SYNOPSIS

package/man/mend-server-stop.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-STOP 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVER-STOP 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-server\-stop \- stop Mend, Postgres, Garage and the edge without deleting data
 .SH SYNOPSIS

package/man/mend-server-upgrade.1

@@ -1,8 +1,8 @@
-.TH MEND-SERVER-UPGRADE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVER-UPGRADE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-server\-upgrade \- upgrade to an explicit version with a database backup
 .SH SYNOPSIS
-.B mend server upgrade \-\-version <target|latest> [\-\-assets\-dir <dir>] [\-\-offline] [\-\-from\-preview]
+.B mend server upgrade \-\-version <target|latest> [\-\-assets\-dir <dir>] [\-\-offline] [\-\-from\-preview] [\-\-keep\-backups <n>]
 .br
 .SH DESCRIPTION
 .PP
@@ -13,6 +13,10 @@ The installed configuration stays: the bind, the origin, the ports, the edge hos
 Stops app writers, starts official Postgres if needed, and streams pg_dumpall into a private database backup before selecting and starting the target. Connections are interrupted. Workspace containers and data are retained, but active work can lose connectivity and need reconnection. Stop any external database writers before upgrading.
 .PP
 Preflight or backup failure retains the old pin and attempts to recover the old app if it was running. Once target startup may have begun, Mend never automatically downgrades or restores the database. The target pin, old generation and backup remain. Inspect logs, fix the target, then use mend server start. Recovery records are under the installation's backups/upgrade\-UUID directory.
+.PP
+After the target answers health, its recovery record is marked completed and older completed backups are removed, keeping the newest two (this one included) in the order Mend wrote them; each removal is printed with the space it freed. A failed upgrade removes nothing. A backup this release recorded as pending, or whose dump is incomplete, is always kept. Each dump holds the whole database, so it can run to gigabytes.
+.PP
+Backups written by releases before 0.36 carry no outcome: the first upgrade on 0.36 or later treats each one whose dump is whole as completed and keeps only the newest N, so copy any you want to keep out of backups/ first. Their removals are marked "from before 0.36, no recorded outcome".
 .SH OPTIONS
 .TP
 .B \-\-version <target|latest>
@@ -26,6 +30,9 @@ no GitHub requests or release\-image pulls; target assets and exact\-version ima
 .TP
 .B \-\-from\-preview
 once, from a preview numbered X.Y.Z\-preview.K to a next build X.Y.Z\-next.N; refused unless the target carries every migration the server applied
+.TP
+.B \-\-keep\-backups <n>
+completed upgrade backups to keep after a healthy upgrade, this one included; 0 keeps all. Default: 2
 .SH EXAMPLES
 .PP
 .B mend server upgrade \-\-version 0.24.0 \-\-assets\-dir ./release\-0.24.0 \-\-offline

package/man/mend-server.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVER 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-server \- install and manage this machine's Mend server
 .SH SYNOPSIS

package/man/mend-service-add.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-ADD 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVICE-ADD 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-service\-add \- adopt a port something in the workspace already listens on
 .SH SYNOPSIS

package/man/mend-service-connect.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-CONNECT 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVICE-CONNECT 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-service\-connect \- bring live Services to this machine's loopback
 .SH SYNOPSIS

package/man/mend-service-init.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-INIT 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVICE-INIT 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-service\-init \- scaffold mend.toml from package.json and compose ports
 .SH SYNOPSIS

package/man/mend-service-list.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-LIST 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVICE-LIST 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-service\-list \- every live service and its observed state
 .SH SYNOPSIS

package/man/mend-service-logs.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-LOGS 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVICE-LOGS 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-service\-logs \- follow a supervised service's output
 .SH SYNOPSIS

package/man/mend-service-restart.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-RESTART 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVICE-RESTART 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-service\-restart \- re\-run a service's recorded command, same URL
 .SH SYNOPSIS

package/man/mend-service-run.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-RUN 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVICE-RUN 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-service\-run \- start and supervise a server in the session's workspace
 .SH SYNOPSIS

package/man/mend-service-stop.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-STOP 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SERVICE-STOP 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-service\-stop \- stop a service and close its host port
 .SH SYNOPSIS

package/man/mend-session-share.1

@@ -1,4 +1,4 @@
-.TH MEND-SESSION-SHARE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SESSION-SHARE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-session\-share \- let everyone who can see a session steer it, or stop
 .SH SYNOPSIS

package/man/mend-sessions.1

@@ -1,4 +1,4 @@
-.TH MEND-SESSIONS 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SESSIONS 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-sessions \- sessions with their review facts
 .SH SYNOPSIS

package/man/mend-shell.1

@@ -1,4 +1,4 @@
-.TH MEND-SHELL 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SHELL 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-shell \- open a shell in a live session's workspace
 .SH SYNOPSIS

package/man/mend-skills-push.1

@@ -1,4 +1,4 @@
-.TH MEND-SKILLS-PUSH 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SKILLS-PUSH 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-skills\-push \- upload ~/.agents/skills into the library
 .SH SYNOPSIS

package/man/mend-skills.1

@@ -1,4 +1,4 @@
-.TH MEND-SKILLS 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SKILLS 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-skills \- your skill library on the server, or a project's
 .SH SYNOPSIS

package/man/mend-snake.1

@@ -1,4 +1,4 @@
-.TH MEND-SNAKE 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SNAKE 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-snake \- the dashboard, with snake over it
 .SH SYNOPSIS

package/man/mend-ssh-setup.1

@@ -1,4 +1,4 @@
-.TH MEND-SSH-SETUP 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SSH-SETUP 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-ssh\-setup \- make this machine ready to ssh into workspaces, once
 .SH SYNOPSIS

package/man/mend-ssh.1

@@ -1,4 +1,4 @@
-.TH MEND-SSH 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-SSH 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-ssh \- workspace SSH status: gateway, registered keys, ssh config
 .SH SYNOPSIS

package/man/mend-stop.1

@@ -1,4 +1,4 @@
-.TH MEND-STOP 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-STOP 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-stop \- stop the agent; the record and the review remain
 .SH SYNOPSIS

package/man/mend-ui.1

@@ -1,4 +1,4 @@
-.TH MEND-UI 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-UI 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-ui \- the dashboard: every project and session, live
 .SH SYNOPSIS

package/man/mend-uninstall.1

@@ -1,4 +1,4 @@
-.TH MEND-UNINSTALL 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-UNINSTALL 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-uninstall \- remove the server, this machine's Mend files, or both
 .SH SYNOPSIS

package/man/mend-version.1

@@ -1,4 +1,4 @@
-.TH MEND-VERSION 1 "" "mend 0.36.0\-next.628" "mend manual"
+.TH MEND-VERSION 1 "" "mend 0.36.0\-next.643" "mend manual"
 .SH NAME
 mend\-version \- this CLI's version, and the server's when it answers
 .SH SYNOPSIS