documented-mutations

Replace useMutation with useDocumentedMutation from ../accessControl, require documentationState as the first argument, pass actionsToDocument with your audit log key, and make the mutation function accept { variables, userNotes } and forward userNotes to the api-client call.

Prompt the user for the audit log key and text rather than inventing them. Add the key to AuditLogAction in react-api-client/src/accessControl/types.ts and add the key-text pair to app/src/assets/localization/en/audit_log.json only, never the zh locale.

OT-2 only callsites do not need real documentation state. Pass ACCESS_CONTROL_DISABLED_DOCUMENTATION_STATE from app/src/local-resources/access-control/utils.ts, while Flex, shared, and ODD callsites use useDocumentationState.

On isDocumentedMutationError, stay on the screen that launched the mutation such as the confirm modal or wizard step. Reset any in-flight UI without toasting, navigating away, or applying mutation success side effects.

Hook tests pass ACCESS_CONTROL_DISABLED_DOCUMENTATION_STATE from the react-api-client fixtures, and app tests mock useDocumentationState using the app fixtures. Keep existing api-client and useHost mocks, assert userNotes forwarding, and do not add new test files.