feat: add admin-only force-resolve market function with idempotency-key support

[muffti123]

Summary

Implements an admin-only force_resolve_market entrypoint that allows the contract admin to resolve any market (Active, Ended, Disputed, or already Resolved) to an arbitrary set of winning outcomes, bypassing oracle resolution. Idempotency is guaranteed via a caller-supplied key, making the operation safe to retry.

Closes Predictify-org#179

New Files

File	Purpose
contracts/predictify-hybrid/src/force_resolve.rs	ForceResolveRecord struct and ForceResolveManager with persistent idempotency storage
contracts/predictify-hybrid/src/force_resolve_tests.rs	13 tests covering all paths

Modified Files

File	Change
src/lib.rs	Added mod force_resolve, mod force_resolve_tests, and force_resolve_market entrypoint
src/err.rs	Added ForceResolveAlreadyUsed = 435 with full severity/category/recoverability classification
src/resolution.rs	Added ForceResolve variant to ResolutionMethod enum (confidence 100)
Various (admin.rs, bets.rs, fees.rs, oracles.rs, storage.rs, etc.)	Pre-existing compilation fixes needed to run tests

Design Decisions

Decision	Rationale
Idempotency key	Caller-provided String stored as (symbol_short!("frc_rslv"), market_id, key) — safe for retries
Key scope	Per-market: same key on different markets = independent resolutions
No state restriction	Force-resolve works on Active, Ended, Disputed, or Resolved markets (bypasses end_time)
Crash-safe ordering	Idempotency record persisted AFTER market state so a mid-write crash does not permanently block resolution
Resolution method	"ForceResolve" with confidence 100 (highest authority)

API

fn force_resolve_market(
    env: Env,
    admin: Address,
    market_id: Symbol,
    winning_outcomes: Vec<String>,
    idempotency_key: String,
);

Returns nothing. Panics on error (Standard Soroban pattern). try_* variant returns wrapped contract error codes.

Validation Order (in entrypoint)

1. Admin auth check
2. Empty outcomes → InvalidInput (401)
3. Market lookup → MarketNotFound (101)
4. Outcome membership → InvalidOutcome (108)
5. Idempotency key check → early return (no-op) if already used

Tests (13 total, all passing)

• ✅ Force-resolve active market
• ✅ Force-resolve ended market
• ✅ Force-resolve already-resolved market
• ✅ Idempotency: same key re-use (no-op)
• ✅ Idempotency: different keys on same market
• ✅ Idempotency: record persistence after call
• ✅ Idempotency: key uniqueness across markets
• ✅ Unauthorized user -> Error::Unauthorized
• ✅ Market not found -> Error::MarketNotFound
• ✅ Invalid outcome -> Error::InvalidOutcome
• ✅ Empty outcomes -> Error::InvalidInput
• ✅ Event emission on resolution
• ✅ Multiple winning outcomes (tie)