zm.deleteBranch

Delete a branch — git branch -D <name>.

Drops the branch and the working tree it owns. Its commits are left alone: they stay reachable from any other branch that shares them, and where none does they remain the record of what the branch held. Deleting a branch drops the name and the tree under it; it does not rewrite history.

Uncommitted work on that branch goes with it, and unlike a discarded file it is not recoverable from trash. So the first call refuses and hands back an affirmation token; affirm it with zm.affirm to go through with the delete.

Two things it will not do: delete the branch this session is on — check out another with zm.checkout first, the way git refuses to remove the branch you are standing on — and delete a world's last branch, which would leave the world with nothing for a session to bind.

zm.deleteBranch("feature")
--> error: affirmation required: zm affirm <token>
zm.affirm("<token>")