PartyFinder v1.0.2 Release Notes

🎯 Accuracy & Keystone Integrity Tightening (Eliminated Fabricated Key Approximations & Fake Parses)

• Authentic Warcraft Logs Parses Only (Zero Fabricated Parses):
  • Removed artificial rating-to-parse heuristics (uScore >= 3200 -> 98%) across Init.lua, MainWindow.lua, and the companion app. Mythic+ rating and item levels are never disguised as WCL parses.
  • When verified WCL logs exist, the addon displays the applicant's exact bracketed percentile (bestParse, e.g. 93%, 98%). If unverified, the dial displays --% WCL PARSE, never a manufactured number.
• Universal WCL Telemetry on All Key Levels:
  • Removed the isHighKey gate constraint from Path A in Engine.lua. Any applicant with verified Warcraft Logs data is now immediately evaluated via Path A, preserving their authentic parse, median consistency, timed depth, and telemetry on any key (+2 to +20) rather than falling back to in-game heuristics.
• Accented Character Transliteration & Guaranteed Lookups:
  • Updated CleanKey in Database.lua to transliterate accents using CleanText (Coôkêd → cooked, Shockoláte → shockolate), eliminating false UNVERIFIED LOGS caused by character encoding mismatches. Added raw UTF-8 and normalized ASCII multi-key fallback matching.
• True Best Bracket Parse Display:
  • Fixed Tab 2 and Tab 1 in MainWindow.lua to display the true bestParse (e.g. 93%) rather than accidentally selecting the lower medianParse (e.g. 84%).
• Companion Dual-Metric Resolution & Credential Sync:
  • Updated companion WCL GraphQL queries to fetch both dpsRankings and scoreRankings concurrently, correctly prioritizing the applicant's queued role so DPS parses are not zeroed out by tank off-specs.
• Eliminated Fabricated Key Approximations (score / 160 Killed):
  • Removed math.floor(score / 160) across Engine.lua and MainWindow.lua that fabricated fake Best Key: +20 and Best Key: +21 for applicants with ~3200–3400 Blizzard Mythic+ rating.
  • Replaced with verified depth only from Warcraft Logs or Raider.IO profiles. If no timed keystone is recorded, the addon displays Best Key: -- alongside their real Blizzard rating ([UNVERIFIED] Rating: 3240), eliminating fake claims and preventing UI text truncation against the Logs button.
  • Showcase Card Box 2 now displays Untested Depth with subtext Rating: 3240 (No WCL Depth) instead of an estimated keystone level.
  • Party Member Tooltip: Removed hardcoded or 15 fallback, displaying Untested when no verified run depth is present.
• Progression Pusher Classification:
  • Fixed an issue where applicants with high performance (e.g. 93% parse, 84% stable median) whose highest timed key is 1 key level below the target (e.g. +15 on a +16 key) were mistakenly flagged as RISK APPLICANT: Untested in Dungeon.
  • Now accurately classified as RECOMMENDED Progression Pushers (Season High: +15 (Pushing +16)).

🔒 Strict WCL Hard Gate on Keys +12 & Above (Anti-Deplete Enforcement)

• Zero Silent Heuristic Fallback: On keys ≥ 12, candidates without Warcraft Logs data are hard-gated from bypassing WCL requirements. Eliminates the transition grace loophole where players with lower timed keys (e.g. +11 best on a +16 key) were crowned as 96% "Keystone Veterans".
• Mathematical Keystone Jump Risk: Computes key jump mathematically: Active Key - Applicant Best Key = 16 - 11 = +5 Key Jump (High Deplete Risk). If unrecorded, flags as Untested in Key Depth (No Timed Record).
• Telemetry Presentation:
  • Verified candidates render full telemetry (Bracketed Percentile, Historic Median, Highest Timed Key, Spec Meta Tier).
  • Unverified candidates render --% WCL PARSE dial with amber ring, [UNVERIFIED LOGS] badge, and 4 diagnostic stat boxes:
    • Box 1: WCL RECORD: Missing / Not Parsed
    • Box 2: IN-GAME BEST: +X Keystone (with jump risk warning)
    • Box 3: GEAR: X Ilvl (Floor Y)
    • Box 4: SPEC META TIER: Spec Tier
• Composer Standby Enforcement: With Strict: On, candidates without WCL on keys ≥ 12 are disqualified. If no verified candidates are queued for a role, the slot stays in Standby Mode (Waiting for Verified <Role>... / No Verified Candidate Queued).
• Header Button Clearance Fix: Shortened SUGGESTED TEAM COMPOSITION to TEAM COMPOSITION and adjusted button anchors, completely eliminating the visual overlap where Strict: On overlapped Your Role: HEALER (PALADIN).
• Preserved Lower Keys (+2 to +11): The working 0–100% Reliability heuristic (40 gear, 40 exp, 20 synergy) remains 100% preserved and untouched for keys +2 to +11.

🚨 Mandatory Desktop Companion Gate (Strict Anti-Deplete Policy - No Fallback)

• Mandatory Heartbeat Verification: Checks PartyFinderDB.companionHeartbeat, PartyFinderDB.lastCompanionSync, and PF.Data_Live timestamps. If older than 2 hours or missing, marks companion state as OFFLINE / NOT RUNNING.
• Zero Silent Fallback: Completely disables reliability scores, recommendation tiers, and green [RECOMMENDED] badges when companion is offline.
• Hard Gate Lockout Overlay: Prominently locks applicant cards across Party Finder (Tab 2) and Team Comp (Tab 1) tabs when companion is not detected, rendering a modal with ⚠️ DESKTOP COMPANION REQUIRED, instructions, and a [ Check Connection / Refresh ] button.
• Status Bar State: Bottom status bar indicates ● Companion Synced & Active (green) when online, or ⚠️ COMPANION OFFLINE - SCORING LOCKED (red warning) when offline.
• Instant Auto-Unlock: Once the companion app runs in the background and user clicks Refresh or reloads, overlays hide and evaluations unlock immediately.

🛡️ Anti-Deplete & Composition Engine

• Live 5-Slot Party Roster: Converts the Team Comp tab into a fixed 5-man Mythic+ composition board (1 Tank, 1 Healer, 3 DPS).
• Roster Seeding: Automatically seeds existing party members (and the local player as [YOU]) directly into their respective role slots with [FILLED] status, class colors, spec, realm, and item level.
• Dynamic Open Slot Calculation: Dynamically computes remaining vacancies (Remaining = Required - Current In Party) and only queries applicants for unfilled slots.
• Live Event Transition: Automatically catches GROUP_ROSTER_UPDATE when an applicant joins the group, converting the applicant slot into a [FILLED] member slot instantly without a manual UI reload.
• Open DPS Slot Population & UI Exception Handling: Resolved a silent runtime exception in MainWindow.lua caused by missing UI:GetHexColor on Card 2 (Healer), which prematurely terminated the composition refresh loop before reaching Cards 3, 4, and 5. Implemented UI:GetHexColor in Widgets.lua, surfaced refresh errors to chat, and verified open DPS slots seamlessly populate with top-scoring applicants (Dips, Hisaragi, Logdh).
• Strict Anti-Deplete Filtering: By default (Strict: On), the Team Comp engine strictly bars applicants with <50% Reliability or marked as [RISK APPLICANT] (such as sub-50% players like Aramar at 46%) from filling team slots.
• Standby Slot State: If no qualified or viable applicant is queued for a role, the slot stays in standby (Waiting for DPS... / No Viable Candidate Queued), hiding invite/decline actions to prevent accidental key depletion.
• Strict Mode Off & Compromise Picks: If the leader toggles Strict to Off, sub-50% candidates can be suggested as compromise picks, badged with high-visibility amber warning borders (#f59e0b), amber avatar outlines, and [COMPROMISE PICK] tags. Viable applicants are always prioritized first.

⚔️ Role Detection & Class Guardrails

• Cannot-Heal Class Guardrails: Defined explicit class sets (6 healing classes vs 7 non-healing classes). Death Knights, Demon Hunters, Warriors, Rogues, Mages, Warlocks, and Hunters can never be assigned as Healers (resolving the issue where Unholy Death Knights appeared with green healer cross icons).
• Spec-Role Primary Authority: Mapped all 39 specs across 13 classes. Specialization ID/Name now takes absolute priority over Blizzard boolean flags or group-queue anomalies.
• Hybrid Tank Role Locking: Dedicated tanks (Guardian Druid, Blood DK, Brewmaster Monk, Prot Paladin/Warrior, VDH) are locked to TANK, even when joining in multi-applicant party queues.
• API Return Index Unpacking: Corrected the return indices for C_LFGList.GetApplicantMemberInfo (Returns 7, 8, 9, 10, 12, 13).

📊 Mythic+ Scoring & Telemetry

• Native Mythic+ Rating Integration: Connected Blizzard API Return 12 (dScore) directly into the scoring pipeline, fixing the bug where applicants showed 0 / 40 Pts (Untested in Keystone) despite having high Mythic+ ratings.
• Dynamic Keystone Badges: Warning badges dynamically evaluate against the active key level (+11, +7, etc.) rather than a static +10.
• Contextual Warning Text: Geared players without dungeon history display "No Dungeon History for this Key Level" instead of falsely labeling them "Under-geared".
• Harmonized Dial Colors: Risk (<50%) is strictly Red (#ef4444); Viable (50–74%) is Light Blue / Amber; Recommended (75%+) is Purple / Orange.

🗝️ Keystone Detection & Interactive Stepper

• Strict Keystone Title Matching: Enforced strict + prefixed/suffixed matching ("%+(%d%d?)" and "(%d%d?)%+"), ignoring descriptive text numbers like "need 4" or "4/5".
• Direct Bag Scan via C_Container: Added bag scanner fallback to immediately detect keystone links (|Hkeystone:...), eliminating Blizzard API login/reload caching delays.
• Header Manual Override Stepper: Added interactive [-] [ +11 ] [+] stepper in the header to manually shift key evaluation brackets from +2 to +35 with live UI recalculation. Left-click resets to auto-detected; mouse wheel scrolls.

🎨 UI / UX, Spacing & Typography

• Gear Readiness Box Spacing: Anchored tile title at y = -5 and score text at y = -20 (15px vertical clearance) to eliminate vertical text collision between title and score.
• Compact Row Breathing Room: Anchored character name at y = -8 and realm/class subtitle at y = -4 below the name; expanded row height to 52px for clean descender clearance (g, y, p, q, j).
• Logs Button Clearance: Score and keystone text anchored 8px before the Logs button with SetWordWrap(false).
• Clockwise Dial Sweep: Horizontally transposed CircleRing.png so the circular status dial sweeps clockwise from 12 o'clock, leaving the empty gap cleanly at the top-left.
• String Truncation Fixes: Widened recommendation badges and dial subtexts with SetWordWrap(false) to prevent ... truncation.

🔒 Permissions & Safety

• Non-Leader Action Lock: Automatically checks UnitIsGroupLeader("player"). When inspecting as a party member, INVITE and DECLINE buttons are disabled and hidden with a (View Only) label to prevent Blizzard UI permission popups.