docs: reconcile PRD boost spec with shipped implementation #61

cal · 2026-04-08T01:28:03Z

cal commented

2026-04-08 01:28:03 +00:00

Summary

Updated 05-rating-boosts.md section 5.3: removed profile-based boost distribution (never built), documented actual shipped algorithms (fixed batter deltas + TB-budget pitcher drain)
Corrected truncation behavior description — implementation scales positive deltas proportionally, preserving 108-sum exactly
Updated REFRACTOR_PHASE2_VALIDATION_SPEC.md T4-1 with shipped function signatures, marked complete

Doc-only change. No production code affected.

## Summary - Updated `05-rating-boosts.md` section 5.3: removed profile-based boost distribution (never built), documented actual shipped algorithms (fixed batter deltas + TB-budget pitcher drain) - Corrected truncation behavior description — implementation scales positive deltas proportionally, preserving 108-sum exactly - Updated `REFRACTOR_PHASE2_VALIDATION_SPEC.md` T4-1 with shipped function signatures, marked complete Doc-only change. No production code affected.

cal added 1 commit 2026-04-08 01:28:04 +00:00

docs: reconcile PRD boost spec with shipped implementation 3ad893c949

Section 5.3 of 05-rating-boosts.md described profile-based boost
distribution (power/contact/patient hitter profiles) that was never
built. Updated to document the actual shipped algorithms: fixed column
deltas for batters and TB-budget priority drain for pitchers, both in
database/app/services/refractor_boost.py.

Corrected the truncation behavior — the implementation scales positive
deltas proportionally rather than discarding them, preserving the
108-sum exactly in all cases.

Updated REFRACTOR_PHASE2_VALIDATION_SPEC.md T4-1 to reflect shipped
function signatures and marked the case as complete.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

cal added 1 commit 2026-04-08 01:33:04 +00:00

fix: address PR review — variant hash snippet and scaling denominator dba7e562c4

- compute_variant_hash: use refractor_tier key, json.dumps with sort_keys
  instead of str(), add variant=0 remapping guard
- Section 5.3.1 step 3: scaling denominator is total_requested_addition,
  not total_requested_reduction

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Claude approved these changes 2026-04-08 01:36:29 +00:00

Claude left a comment

Approved via pd-pr

cal added 1 commit 2026-04-08 01:36:44 +00:00

Merge branch 'main' into docs/reconcile-prd-boost-spec 0c68fdc081

cal merged commit ae73ce6755 into main

2026-04-08 01:36:49 +00:00

cal deleted branch docs/reconcile-prd-boost-spec

2026-04-08 01:36:49 +00:00

cal referenced this issue from a commit

2026-04-08 01:36:49 +00:00

Merge pull request 'docs: reconcile PRD boost spec with shipped implementation' (#61) from docs/reconcile-prd-boost-spec into main