docs: add annotated refund violation trace

[Nomee-123]

Summary

• Add an annotated companion for m4_refund_limit_violation.json
• Explain how the refund_limit policy maps to the issue_refund tool call
• Document the evidence fields that show why the rule is violated

Closes #40

Type of change

• Docs / community / DX only
• Bug fix
• Tests
• CLI / DX
• Adapter (new or Adapter docs: add policy.yaml operator cheatsheet #1)
• Core engine (policy, campaign, minimize, regression)
• Hosted API / UI (secondary surface)

Checklist

• I read CONTRIBUTING.md (where to ask, how reviews work, how to run tests)
• Linked related issue (Fixes #N) or Discussion when applicable
• Core stays free of framework SDK imports (adapters own glue)
• Tests added or updated when behavior changes (uv run pytest tests/unit -q)
• Docs / README claims match reality (no PyPI / multi-adapter claims unless shipped)
• One concern per PR when possible
• Authorized testing only — no open-internet attack-proxy behavior

Test plan

docs-only / N/A

[vercel]

@Nomee-123 is attempting to deploy a commit to the priyanshu's projects Team on Vercel.

A member of the Team first needs to authorize it.

[CodewithJha]

LGTM — S-sized docs-only companion for #40: m4_refund_limit_violation.annotated.md maps refund_limit → issue_refund (demo-tc-1, amount 210, approved false) with clear evidence notes. No Core changes; unit CI green on 3.11/3.12. Ignoring Vercel auth.

[CodewithJha]

Thanks @Nomee-123 — this hits #40 cleanly: annotated sibling for the refund-limit violation trace, links the refund_limit rule, and stays static/docs-only (no campaign or real refund). Unit CI green on 3.11/3.12; ignoring the Vercel auth failure (unrelated to this PR). Merging now.

[CodewithJha]

Merged — thank you @Nomee-123. Exactly the kind of good-first-issue docs companion Mutiny needs: clear refund_limit evidence mapping, static/authorized-testing only, no Core churn.

If you want another similar bite later, feel free to browse open good first issue labels — comment on the issue first so nobody doubles up.