Upgrade Opportunity workflow instances safely

Existing Opportunity instances remain pinned to their published workflow version. Preview the move from version 1 to the effective managed version 2 binding without changing data:

text
nucli --tenant <tenant> workflow instance-upgrade opportunity-v1 --json

The plan lists at most 200 instances, their expected versions, and stable blockers. Resolve unhealthy instances, dead letters, missing state mappings, or mismatched Opportunity bindings outside this command.

Apply the exact server-validated plan:

text
nucli --tenant <tenant> workflow instance-upgrade opportunity-v1 --apply --json

You need workflow_integrity:repair. The server locks the target rows, rechecks the plan digest and instance versions, and upgrades all selected instances or none. It changes only the pinned workflow ID and version, the instance version, and the timestamp. State, Opportunity data, transitions, and actions remain unchanged. Every successful change is audited within the tenant.

Use repeated --instance <uuid> options to limit a plan. Apply does not repair business data, dead letters, or workflow definitions.