Repair Actions

Summary

Repair actions are typed corrections that let a human move a workflow forward without bypassing the system of record.

Problem

Operational ambiguity is normal. If the only available response is manual work outside the platform, the platform loses auditability and cannot learn from the correction.

Principle

Repair should create durable facts and then re-enter the normal processing path.

Platform Shape

POA repair services persist corrections and retry processing. Precon repair surfaces correct solicitation, portal, document, and opportunity state. These actions are not UI-only patches; they are state transitions that should be audited, validated, and available to downstream services.

Source Evidence

• services/poa/review/workflow
• services/workflow/reviews
• app/web/app/poa-greenfield
• services/precon/review

Related Reading

• docs/engineering/concepts/failures-are-data.md
• docs/engineering/concepts/retry-resume-cancel.md