Move a deal to another stage, or close it

Either moves a deal to another stage of its own pipeline (stage_id) or closes it (outcome), never both. Call crm_get_deal first: it lists the stages this deal can move to. Closing is a decision with consequences — it takes the deal out of the forecast and into the win-rate — so show the user what they are closing and get an explicit yes. Closing as lost normally requires a reason from the organisation’s own list; if one is needed this tool refuses and returns the list.