PatchFlowDocs
Guides

Recover a failed migration

Read the evidence, inspect the gate, and deliberately retry or take over.

Open Markdown ↗

Inspect recent runs

Status includes the package transition, update type, evidence level, PR URL, and last update time.

Terminal
npm run patchflow -- status

Read the PR comment

  • Which gate ran
  • Which required checks were missing or failed
  • Whether repository setup failed
  • The bounded output excerpt sent to the retry agent

Retry manually

A full ID or unambiguous prefix is accepted. Manual retry creates a new run so the audit history remains intact.

Terminal
npm run patchflow -- retry 8f3c2a1b

Override a policy

Terminal
npm run patchflow -- retry 8f3c2a1b --force
Important

Force bypasses package and update-type policy only. It does not bypass test gates, required checks, draft PRs, or the human merge decision.

NextCLI reference