How to

Record finish disposition

Record how the delivered branch was left without performing external actions.

What changes

finish imports a bounded structured disposition for pr_created, merged, branch_kept, handoff_required, or abandoned. It records validated facts and never pushes, creates a PR, merges, switches branches, or removes a workspace. The central Mission guide's Build structured JSON inputs section includes a valid branch_kept input.

When this helps

After delivery reaches a truthful terminal state that can be recorded before close.
When a handoff is still required and the Mission must remain open.
When abandonment needs an explicit actor and reason instead of a safety bypass.

Run this command

terminal

$sumr mission finish SUM-123 --from disposition.json# record the terminal or handoff state

Flags you can use

--from <disposition.json>

Import a bounded structured JSON finish disposition.

--allow-custom-key

Accept a work key that does not match a configured work-provider prefix. Use only for local or intentionally custom work.

--json

Return a structured JSON envelope for scripts, CI jobs, and AI assistants.

--help, -h

Show the command syntax, supported flags, and examples without changing files.

Keep in mind

Delivered terminal dispositions are pr_created, merged, and branch_kept; abandoned is terminal with an actor and reason.
handoff_required is intentionally nonterminal and prevents close.
Workspace provenance and disposition never authorize destructive cleanup.