@sealant/mend 0.30.0 → 0.31.0

package/man/mend-accounts.1

@@ -1,4 +1,4 @@
-.TH MEND-ACCOUNTS 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-ACCOUNTS 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-accounts \- your connected accounts on the platform
 .SH SYNOPSIS

package/man/mend-adopt.1

@@ -1,4 +1,4 @@
-.TH MEND-ADOPT 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-ADOPT 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-adopt \- adopt a repository into the store
 .SH SYNOPSIS

package/man/mend-attach.1

@@ -1,4 +1,4 @@
-.TH MEND-ATTACH 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-ATTACH 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-CODEX 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-codex \- launch codex, claude, or opencode in a recorded worktree
 .SH SYNOPSIS

package/man/mend-completions.1

@@ -1,4 +1,4 @@
-.TH MEND-COMPLETIONS 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-COMPLETIONS 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-completions \- print the TAB\-completion hook
 .SH SYNOPSIS

package/man/mend-connect.1

@@ -1,4 +1,4 @@
-.TH MEND-CONNECT 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-CONNECT 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-CONTINUE 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-DOCTOR 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-doctor \- check this machine's setup
 .SH SYNOPSIS

package/man/mend-dotfiles-repo.1

@@ -1,4 +1,4 @@
-.TH MEND-DOTFILES-REPO 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-DOTFILES-REPO 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-DOTFILES-SYNC 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-DOTFILES 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-ENV-CLUSTER 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-ENV-LOAD 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-ENV-SHOW 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-FOLDER-CREATE 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-FOLDER-LIST 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-FOLDER-PUSH 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-FOLDER-RM 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-folder\-rm \- remove an organization folder
 .SH SYNOPSIS

package/man/mend-git-author.1

@@ -0,0 +1,24 @@
+.TH MEND-GIT-AUTHOR 1 "" "mend 0.31.0" "mend manual"
+.SH NAME
+mend\-git\-author \- the name and email your workspaces commit as
+.SH SYNOPSIS
+.B mend git\-author [<name> <email>]
+.br
+.B mend git\-author \-\-clear
+.br
+.SH DESCRIPTION
+.PP
+Commits the agent makes in your workspaces name this author. Until you set one, it is the name and email you registered with. Without arguments, prints it and where it comes from.
+.PP
+Each workspace receives it as system git config before the agent starts, so a user section in your dotfiles' .gitconfig or in a repository's own config still decides. Sessions launched after a change commit as the new author.
+.SH OPTIONS
+.TP
+.B \-\-clear
+go back to your account's name and email
+.SH EXAMPLES
+.PP
+.B mend git\-author "Anna Example" anna@example.com
+.PP
+.B mend git\-author \-\-clear
+.SH SEE ALSO
+mend(1), mend\-dotfiles(1), mend\-keys\-mode(1)

package/man/mend-help.1

@@ -1,4 +1,4 @@
-.TH MEND-HELP 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-HELP 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-INVITE 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-KEYS-INIT 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-KEYS-MODE 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-KEYS-SHARE 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-KEYS-SHOW 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-keys\-show \- print your Mend public key
 .SH SYNOPSIS

package/man/mend-land.1

@@ -1,9 +1,11 @@
-.TH MEND-LAND 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-LAND 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-land \- push a session's change to origin and open its pull request
 .SH SYNOPSIS
 .B mend land <session> [\-\-branch <name>] [\-\-no\-pr] [\-\-title <text>] [\-\-project <p>]
 .br
+.B mend land <session> \-\-check [\-\-project <p>]
+.br
 .SH DESCRIPTION
 .PP
 Only the change's owner lands it: the owner of the worktree's first session, not someone who started a session in it later. Mend takes a checkpoint, commits what the agent left uncommitted on top of the agent's own commits and the last landing, and pushes that to origin with the project's git access. The agent's commits are pushed as they are. The session's branch, and the worktree's files, index and HEAD, are not touched.
@@ -14,11 +16,16 @@ When origin is on GitHub, Mend then opens a pull request into the session's base
 .PP
 Landing again after more work adds commits to the same branch and updates the same pull request. When nothing is new since the last landing, nothing is pushed and the command says so. The branch on origin is never the project's default branch or the pull request's base. The command then prints what Mend observed: the push, the pull request and its state, what changed since, and pushes the agent made itself. It exits 1 when the push was refused or a step failed.
 .PP
+A pull request someone opened outside Mend, the agent through gh included, is found and recorded as the change's own: Mend looks after the agent pushes a branch and when its turn ends, and \-\-check looks now. It asks GitHub, as you, about the worktree's branch, every branch the agent pushed, and the agent's head commit. A landing then pushes that pull request's branch and updates it. A pull request from a fork is shown and never updated: Mend pushes to origin only, and opens no second pull request beside it.
+.PP
 <session> is a prefix of the session id or the worktree's name. Settled sessions count.
 .SH OPTIONS
 .TP
 .B \-\-branch <name>
-the branch on origin. Default: where the change last pushed to, else mend/<worktree>
+the branch on origin. Default: where the change last pushed to, the branch the agent pushed, an adopted pull request's branch, else mend/<worktree>
+.TP
+.B \-\-check
+only look on GitHub for a pull request opened outside Mend, and record it; push nothing
 .TP
 .B \-\-no\-pr
 push only; open or update no pull request

package/man/mend-login.1

@@ -1,4 +1,4 @@
-.TH MEND-LOGIN 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-LOGIN 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-LOGOUT 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-MAN 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-MEMBERS 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-members \- who belongs to your organization, and their roles
 .SH SYNOPSIS

package/man/mend-operator-exposure.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-EXPOSURE 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-OPERATOR-EXPOSURE 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-OPERATOR-GATE 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-OPERATOR-GRANT-OWNER 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-OPERATOR-ORG-CREATE 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-OPERATOR-ORG-INVITE-OWNER 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-OPERATOR-ORG-LIST 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-OPERATOR-ORG-RENAME 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-OPERATOR-RESET-LINK 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-PAIR 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-PROJECTS 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-PULL 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-REFRESH 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-REJOIN 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-RESUME 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-RUN 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-run \- run any command as a session
 .SH SYNOPSIS

package/man/mend-server-logs.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-LOGS 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-SERVER-LOGS 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVER-RESTART 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVER-SETUP 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVER-START 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVER-STATUS 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server\-status \- show the saved pin, generation and container state
 .SH SYNOPSIS

package/man/mend-server-stop.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-STOP 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-SERVER-STOP 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server\-stop \- stop Mend, Postgres and Garage without deleting data
 .SH SYNOPSIS

package/man/mend-server-upgrade.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-UPGRADE 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-SERVER-UPGRADE 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server\-upgrade \- upgrade to an explicit version with a database backup
 .SH SYNOPSIS

package/man/mend-server.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-SERVER 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVICE-ADD 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVICE-CONNECT 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVICE-INIT 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVICE-LIST 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVICE-LOGS 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVICE-RESTART 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVICE-RUN 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SERVICE-STOP 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SESSION-SHARE 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SESSIONS 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SHELL 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SKILLS-PUSH 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SKILLS 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SNAKE 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SSH-SETUP 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-SSH 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-STOP 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-stop \- stop the agent; the record and the review remain
 .SH SYNOPSIS
@@ -6,10 +6,14 @@ mend\-stop \- stop the agent; the record and the review remain
 .br
 .B mend stop \-\-all [\-\-project <p>]
 .br
+.B mend stop \-\-services [session\-id\-prefix]
+.br
 .SH DESCRIPTION
 .PP
 Ends the agent process. The workspace harvests the harness state and closes. The worktree, the record, and the review stay, and mend resume brings the conversation back.
 .PP
+Services keep running after a stop, and a running Service keeps the workspace up. The stop then prints, for example, agent stopped · 3 services keep the workspace up. \-\-services stops all of them. Once nothing is live, the workspace closes.
+.PP
 With no id, the one live session is taken; with several, a picker opens. A prefix of the id is enough.
 .SH OPTIONS
 .TP
@@ -18,5 +22,8 @@ every live session
 .TP
 .B \-\-project <p>
 limit \-\-all to one project by name, when the current directory is not inside it
+.TP
+.B \-\-services
+stop the session's Services instead of its agent
 .SH SEE ALSO
 mend(1), mend\-resume(1), mend\-attach(1)

package/man/mend-ui.1

@@ -1,4 +1,4 @@
-.TH MEND-UI 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-UI 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-ui \- the dashboard: every project and session, live
 .SH SYNOPSIS
@@ -8,7 +8,7 @@ mend\-ui \- the dashboard: every project and session, live
 .PP
 A full\-screen view of every project and session, updating live. The session pane takes three quarters of the screen: a read\-only detail for the selected session with the conversation record it has written so far. The remaining quarter is a sidebar of three stacked sections, projects then worktrees then sessions, where the section you are in stands open and the other two fold to the line that says what is selected. Bare mend with no command opens the same thing.
 .PP
-Moving the selection only ever navigates: arrows or j/k move inside the open section, enter and the arrows move between the sidebar and the session pane, and nothing takes this terminal until you ask. Reading the record leaves the sidebar as it was. The verbs are a to attach a live session, r to resume a settled one, n for another session in the selected worktree, w for a new worktree, e to rename, v to review the change, o to open it in the browser, Shift+K to stop, Shift+D to remove, and Shift+R to refresh.
+Moving the selection only ever navigates: arrows or j/k move inside the open section, enter and the arrows move between the sidebar and the session pane, and nothing takes this terminal until you ask. Reading the record leaves the sidebar as it was. The verbs are a to attach a live session, r to resume a settled one, n for another session in the selected worktree, w for a new worktree, e to rename, v to review the change, o to open it in the browser, Shift+K to stop (on a row whose agent has stopped while its Services keep the workspace up, Shift+K stops those Services), Shift+D to remove, and Shift+R to refresh.
 .PP
 Nothing is ever squeezed. A terminal too narrow for both gives the whole width to the side you are on, a terminal too short for three drawn panes shows the open section alone, and a one\-line breadcrumb states whatever did not fit.
 .PP

package/man/mend-uninstall.1

@@ -1,4 +1,4 @@
-.TH MEND-UNINSTALL 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-UNINSTALL 1 "" "mend 0.31.0" "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.30.0" "mend manual"
+.TH MEND-VERSION 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-version \- this CLI's version, and the server's when it answers
 .SH SYNOPSIS

package/man/mend-worktrees.1

@@ -1,4 +1,4 @@
-.TH MEND-WORKTREES 1 "" "mend 0.30.0" "mend manual"
+.TH MEND-WORKTREES 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-worktrees \- every worktree and the sessions inside it
 .SH SYNOPSIS