{
    "ok": true,
    "version": "3.7.3-gameplay-action-verification-live-readiness",
    "troubleshooting": [
        {
            "issue": "Missing Phase 37 tables",
            "symptom": "No rows available, readiness warnings, or SQL table missing errors.",
            "fix": "Run /install/ and confirm migrations 049, 050, 051 and 052 are recorded in migrations table."
        },
        {
            "issue": "Cards not minting on pack open",
            "symptom": "Pack opens but no user_cards or pack_opening_items row appears.",
            "fix": "Check card pool eligibility, edition limits, pack_opening_logs, rng_proofs and economy_ledger rows."
        },
        {
            "issue": "Pack proof missing",
            "symptom": "Player receipt has no proof_log_id or proof page cannot load.",
            "fix": "Verify rng_proofs and pack_opening_logs tables, then retry with a fresh idempotency key."
        },
        {
            "issue": "Duplicate idempotency key",
            "symptom": "Action returns idempotency_payload_mismatch.",
            "fix": "Mobile/web client reused the same key with a different body. Generate a new UUID per unique write action."
        },
        {
            "issue": "Ledger mismatch",
            "symptom": "Wallet does not match ledger totals or reconciliation warns.",
            "fix": "Run economy reconciliation, inspect economy_ledger rows for that user and avoid manual wallet edits without ledger correction."
        },
        {
            "issue": "Card stuck locked",
            "symptom": "Card cannot be used after listing/trade/auction is cancelled.",
            "fix": "Inspect market_listings/trade_offers/market_bids, then use admin rollback/repair once the pending item is resolved."
        },
        {
            "issue": "Listing stuck pending",
            "symptom": "Listing stays active after sale/cancel.",
            "fix": "Check market_transactions and listing status; run marketplace reconciliation and clear stale locks only after ledger/provenance is verified."
        },
        {
            "issue": "Auction not settling",
            "symptom": "Auction closed but card/funds did not transfer.",
            "fix": "Run auction settlement endpoint as seller/admin, check market_bids and user_wallets, then inspect phase37_escrow_intents."
        },
        {
            "issue": "Mission not progressing",
            "symptom": "Gameplay action succeeds but mission progress unchanged.",
            "fix": "Check phase37_mission_events status, challenge_definitions activity_type and user_challenge_progress."
        },
        {
            "issue": "Notification not created",
            "symptom": "Trade/sale/battle succeeds but no notification.",
            "fix": "Check phase37_notification_events, notification_preferences, quiet hours and frequency caps."
        }
    ]
}