feat: Member Effectiveness Score + Representation Alignment View (v0.9.9)

Member Effectiveness Score
- New BillCosponsor table (migration 0018) with per-bill co-sponsor
  party data required for the bipartisan multiplier
- bill_category column on Bill (substantive | commemorative | administrative)
  set by a cheap one-shot LLM call after each brief is generated
- effectiveness_score / percentile / tier columns on Member
- New bill_classifier.py worker with 5 tasks:
    classify_bill_category  — triggered from llm_processor after brief
    fetch_bill_cosponsors   — triggered from congress_poller on new bill
    calculate_effectiveness_scores — nightly at 5 AM UTC
    backfill_bill_categories / backfill_all_bill_cosponsors — one-time
- Scoring: distance-traveled pts × bipartisan (1.5×) × substance (0.1×
  for commemorative) × leadership (1.2× for committee chairs)
- Percentile normalised within (seniority tier × party) buckets
- Effectiveness card on member detail page with colour-coded bar
- Admin panel: 3 new backfill/calculate controls in Maintenance section

Representation Alignment View
- New GET /api/alignment endpoint: cross-references user's stanced bill
  follows (pocket_veto/pocket_boost) with followed members' vote positions
- Efficient bulk queries — no N+1 loops
- New /alignment page with ranked member list and alignment bars
- Alignment added to sidebar nav (auth-required)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Jack Levy
2026-03-14 18:05:09 -04:00
parent cba19c7bb3
commit d0da0b8dce
19 changed files with 910 additions and 5 deletions

View File

@@ -187,6 +187,42 @@ export default function MemberDetailPage({ params }: { params: Promise<{ id: str
</div>
)}
{/* Effectiveness Score */}
{member.effectiveness_score != null && (
<div className="bg-card border border-border rounded-lg p-4 space-y-3">
<h3 className="text-sm font-semibold">Effectiveness Score</h3>
<div className="space-y-2">
<div className="flex justify-between text-sm">
<span className="text-muted-foreground">Score</span>
<span className="font-medium">{member.effectiveness_score.toFixed(1)}</span>
</div>
{member.effectiveness_percentile != null && (
<>
<div className="h-1.5 bg-muted rounded overflow-hidden">
<div
className={`h-full rounded transition-all ${
member.effectiveness_percentile >= 66
? "bg-emerald-500"
: member.effectiveness_percentile >= 33
? "bg-amber-500"
: "bg-red-500"
}`}
style={{ width: `${member.effectiveness_percentile}%` }}
/>
</div>
<p className="text-xs text-muted-foreground">
{Math.round(member.effectiveness_percentile)}th percentile
{member.effectiveness_tier ? ` among ${member.effectiveness_tier} members` : ""}
</p>
</>
)}
<p className="text-xs text-muted-foreground leading-relaxed">
Measures legislative output: how far sponsored bills travel, bipartisan support, substance, and committee leadership.
</p>
</div>
</div>
)}
{/* Service history */}
{termsSorted.length > 0 && (
<div className="bg-card border border-border rounded-lg p-4 space-y-3">