Wire the composed surface: the honest fields now reach a user

PHASE 0 re-check caught the same failure a THIRD time, mine again. Last
turn I created GradeScaleLegend.tsx and never mounted it, and I reported
that the separation flag "renders per band" -- it did not. grep: zero
frontend references to separates_from_base_rate, served_grade or
factor_adjustment. The honest grade was reaching the API payload and dying
at the adapter boundary.

That is three occurrences in three orders of the same shape: built,
correct, unread. gradeBands, then served_grade, then the legend.

PHASE 2 — the composed surface is wired end to end:
  analyzeViaEngine1 -> served_grade + factor_adjustment on the payload
  scan/page.tsx     -> ScanResponse types them and forwards them
  gradeAdapter      -> gradeMeaning, separatesFromBaseRate,
                       bandRealizedRate, factorsApplied, refusalReason
  GradeResultCard   -> renders "WHAT THIS GRADE MEANS"

What a user now sees that they could not before: what the band has
actually realized, an amber note when the read CANNOT be separated from
the baseline, and -- only where a factor actually fired, with its proven
sign -- what moved the read, in plain language rather than feature names
("where he hits it vs who is standing there").

No narrative on props where nothing fired: factorsApplied is empty and the
block self-hides. Only the three PROVEN hits factors have labels, so an
unproven factor cannot acquire prose by being added to the map.

PHASE 1 — GradeScaleLegend is now MOUNTED on the grade card (compact). The
ceiling is a stated position where the grade is, not a page a user would
have to find.

PHASE 3 hand-verified through the real adapter across twelve states: B+
with 3/0 factors, B with 1, C+/C/C- all flagged not-separable, D, F, a
switch-hitter case where 2 of 3 factors fire, two refusals and a
no-forecast. never-blank PASS, no-manufactured-A PASS, no-narrative-when-
nothing-fired PASS, separation-flag-reaches-card PASS.

No A-threshold loosening. No calibrated number leaks. p_win never mutated.
engine_grade still read by zero serving code. No Bonferroni slot.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01W1sivYNqY2TS5ftykmHBU9
This commit is contained in:
Kev
2026-08-07 14:36:03 -04:00
parent 3591c7626e
commit 09186ea609
4 changed files with 104 additions and 1 deletions
@@ -19,6 +19,15 @@ import { gradeGlows } from '@/lib/colorContract';
import PriceTriplet, { type PriceTripletData } from './PriceTriplet';
import { playerHref } from '@/lib/playerHref';
import GradeScaleLegend from './GradeScaleLegend';
/** Only the three factors PROVEN for hits reach the card, so only these map. */
const FACTOR_LABEL: Record<string, string> = {
defense_by_direction: 'where he hits it vs who is standing there',
platoon_severity: 'his own measured platoon split',
pitcher_contact_profile: 'the contact this arm concedes',
};
export interface GradeResultData {
player: string;
team: string;
@@ -36,6 +45,12 @@ export interface GradeResultData {
projection: number | null;
phosphorConfirmed?: boolean;
signals: string[];
/** What this band has actually realized, and whether it separates at all. */
gradeMeaning?: string | null;
separatesFromBaseRate?: boolean | null;
bandRealizedRate?: number | null;
/** ONLY factors that fired, with their proven sign. Empty is the common case. */
factorsApplied?: Array<{ factor: string; direction: 'up' | 'down'; multiplier: number }>;
killConditions?: string[];
books: Array<{ name: string; line: number; odds: string; best?: boolean }>;
altLadder?: Array<{ line: number; grade: string; edge?: number | null; base?: boolean }>;
@@ -248,6 +263,58 @@ export default function GradeResultCard({
nothing rather than a fabricated timeline. */}
<GradeShift history={d.history} side={d.side} grade={d.grade} revisedFrom={d.revisedFrom} gradedLine={d.gradedLine ?? d.line} />
{/* 4b. WHAT THIS GRADE MEANS — the honest core.
A band that cannot be separated from the baseline SAYS so here. That
is most of any slate, and stating it is the point: a C is not a weak
opinion, it is us telling you we see nothing that distinguishes this
prop. Absent fields self-hide, so nothing renders on a refusal. */}
{(d.gradeMeaning || (d.factorsApplied && d.factorsApplied.length > 0)) && (
<div style={{ padding: '14px 20px', borderTop: '1px solid var(--line)' }}>
<SectionHead style={{ marginBottom: 10 }}>WHAT THIS GRADE MEANS</SectionHead>
{d.gradeMeaning && (
<p className="mono" style={{ margin: '0 0 8px', fontSize: 11, lineHeight: 1.6, color: 'var(--text-2)' }}>
{d.gradeMeaning}
{typeof d.bandRealizedRate === 'number' && (
<> this band has landed <strong style={{ color: 'var(--text-1)' }}>
{Math.round(d.bandRealizedRate * 100)}%
</strong> of the time.</>
)}
</p>
)}
{d.separatesFromBaseRate === false && (
<p className="mono" style={{ margin: '0 0 8px', fontSize: 11, lineHeight: 1.6, color: 'var(--amber)' }}>
We cannot separate this read from the baseline. Shown so you know
the model is not claiming an edge here.
</p>
)}
{d.factorsApplied && d.factorsApplied.length > 0 && (
<div style={{ display: 'flex', flexDirection: 'column', gap: 4 }}>
<div className="mono" style={{ fontSize: 10, letterSpacing: '.08em', color: 'var(--text-3)' }}>
WHAT MOVED THE READ
</div>
{d.factorsApplied.map((f) => (
<div key={f.factor} className="mono" style={{ fontSize: 11, color: 'var(--text-2)' }}>
<span style={{ color: f.direction === 'up' ? 'var(--hit)' : 'var(--miss)' }}>
{f.direction === 'up' ? '\u25B2' : '\u25BC'}
</span>{' '}
{FACTOR_LABEL[f.factor] || f.factor}
</div>
))}
</div>
)}
</div>
)}
{/* 4c. THE SCALE ITSELF. A user who never sees an A will invent a reason
for it, and every reason they might invent is wrong. Compact form
rides the card; the full band table lives on the scale page. */}
<div style={{ padding: '12px 20px', borderTop: '1px solid var(--line)' }}>
<GradeScaleLegend compact />
</div>
{/* 5. SIGNAL BREAKDOWN */}
{d.signals.length > 0 && (
<div style={{ padding: '16px 20px' }}>