[Forge] Allen ISH region-energy heatmaps on neuroscience hypotheses done

Goal

Generate a per-region Allen Brain ISH expression-energy heatmap for every
neuroscience hypothesis whose domain_tags include neuroscience, alzheimers, or neurodegeneration. Persist as a registered figure artifact
so the Atlas wiki and /hypothesis/<id> page render the same image, and the
Skeptic can refute regional claims with the real ISH data.

Why this matters

The 19 King-of-the-Hill domains run nightly tournaments where regional
specificity is a key axis the LLM judge weighs. Today that judgment is based
on text alone; rendering the actual ISH heatmap (and feeding the per-region
energy vector to the judge) replaces "I think this gene is expressed in
hippocampus" with a measured value across 12 brain structures.

Acceptance Criteria

Atlas RMA API (https://api.brain-map.org/api/v2/data/...) for the
adult mouse experiment and aggregating expression_energy over
curated structure IDs (cortex, hippocampus, striatum, thalamus,
hypothalamus, midbrain, pons, medulla, cerebellum, OB, amygdala, BG). scidex/forge/image_generator.py and committed via
scidex.atlas.artifact_commit.commit_artifact. structure_acronym, expression_energy, density, intensity) keyed on
(hypothesis_id, structure_acronym). the per-region vector as a tool result before scoring. the Allen API isn't re-hit for the same gene twice. every heatmap traces back to a real Allen experiment_id.

Approach

Allen RMA — same auth-free pattern as the existing

allen_brain_expression tool registration.

Cache the per-gene experiment list under data/allen/experiments/ and

the per-structure energies under data/allen/structure_energies/.

Heatmap renderer uses Matplotlib with the colorblind-safe cividis ramp.

Wire artifact commit so the figure shows up in the wiki page for the gene.

Dependencies

• Quest q-555b6bea3848: prior Allen ABC Atlas / SEA-AD task done.
• allen_brain_expression skill.

Already Resolved — 2026-04-28 07:00:00Z

Triage task da20662f-9c0c-4159-a2a7-f836999bb031 confirmed all acceptance criteria
are met on origin/main (merged at commit a243f973d as PR #670). The watchdog's 67%
abandon ratio flag was pre-implementation noise — task completed and merged successfully.
No further action needed.

Work Log

2026-04-27 — Implementation (task:ccc08d9c-238b-4a74-a947-32ce00679bb1)

Commit d7d296c79 added:

• scidex/forge/forge_tools.py: ALLEN_ISD_STRUCTURES (12 structures), fetch_allen_structure_energies() (RMA API + disk cache under data/allen/structure_energies/), render_allen_ish_heatmap() (Matplotlib/cividis PNG)
• migrations/20260428_hypothesis_allen_ish.py: hypothesis_allen_ish table with (hypothesis_id, structure_acronym) unique key, covering all spec fields
• backfill_allen_ish_heatmaps.py: processes neuro/alzheimer/neurodegeneration/parkinson hypotheses, caches per-gene, writes to DB, renders PNG, attempts commit_artifact; dry-run by default (--apply to execute)
• data/allen/structure_energies/APOE.json: sample cache entry verifying RMA round-trip

This commit adds:

• scidex/senate/judge_arena.py: _fetch_entity_content now queries hypothesis_allen_ish and appends the per-region energy vector to the hypothesis body so KOTH LLM judges see measured ISH values instead of text claims
• api.py: new GET /api/hypotheses/{id}/allen-ish (JSON) and GET /api/hypotheses/{id}/allen-ish/heatmap.png (streaming PNG) endpoints; the PNG endpoint is also embedded on the hypothesis wiki page via <img> tag

Acceptance criteria status: