BreezyCorp Handbook

Appearance

DOCX export refused: mandatory_policy_mismatch ​

You clicked Export Word; the export refused with HTTP 422 and reason: "mandatory_policy_mismatch".

What this means ​

The renderer asserts that the verbatim policy text in note_policies matches the constitution exactly. The note drifted. Most often: Claude paraphrased a sentence and you didn't catch it.

Fix ​

  1. Open the Notes tab.
  2. Click Regenerate notes.
  3. After regeneration, click Export Word again.

If the assertion still fails after regeneration:

  1. Compare the note text to the constitution (see Policy text missing for the SQL + cat commands).

  2. Identify the offending paragraph.

  3. Check whether the constitution was recently updated (git log packages/financial-statements/constitution/mandatory_policies/).

  4. Restart the worker if a constitution-cache issue is suspected:

    bash
    docker restart breezycorp-monorepo-worker-1

  5. Regenerate notes and retry the export.

Why we don't auto-fix ​

Auto-rewriting the note at export time would silently mask LLM drift across engagements. The renderer surfaces the mismatch so a reviewer sees that the LLM is occasionally paraphrasing, and can escalate.

Internal use only — BreezyCorp