Add update_head_reference.sh: automate the head_reference checkpoint ritual, so it actually happens instead of being forgotten.

Refreshing head_reference/ (rebuild release binary, sd10+sn5m sweep
across all three curated suites, copy logs, tag the commit, archive
the binary) was, until now, a several-minute manual dance repeated by
hand every time a commit became the new comparison baseline -- exactly
the kind of multi-step ritual an AI assistant with no persistent
memory across sessions will reliably forget to fully repeat. Scripted
the mechanical parts: build, 6-way sweep, log copy, git tag (head-
reference-<date>, the durable/versioned source of truth for "which
commit was checkpoint N" -- see head_reference/README.md's new
"Checkpoint history convention" section), and binary archive (a
rebuild-avoidance cache alongside the tag, not a replacement for it).
Does NOT write the README's prose sections (what changed, why, how to
read the net score) -- that still needs a human/Claude actually
looking at the diff and the numbers this script prints at the end,
not a template trying to guess at them.

Checks for a dirty working tree and warns rather than silently tagging
something that doesn't correspond to a real commit -- the intended
sequence is still git commit first, then this script, same as
precommit_check.sh's gate runs before a commit rather than replacing
it.

precommit_check.sh: two lines printing the actual next-step commands
("git commit", "./update_head_reference.sh") after a passing check, so
the two scripts' relationship is visible right where the first one
succeeds.

Co-Authored-By: Claude Sonnet 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01M9ZDiJhiUajUxh95mTXCFJ

1 files changed, 56 insertions, 0 deletions

diff --git a/src/dna/first.dna b/src/dna/first.dna
new file mode 100644
index 0000000..a960faf
--- /dev/null
+++ b/src/dna/first.dna
@@ -0,0 +1,56 @@
+-1,90,89,89,59,46,25,4,50,50,50,50,50,50,50,50,-1,-1,125,125,109,132,123,100,78,71,66,66,66,66,66,66,66,-1,-1,158,180,148,92,109,70,46,87,77,77,77,77,77,77,77,-1
+-59,-63,0,3,14,18,-9,-19,-20,-31,7,0,52,41,14,19,41,32,-58,0,0,47,-9,4,-24,-19,44
+0,0,0,0,0,0,0,0,0,1,1,1,1,1,10,11,4,5,6,6,7,7,7,7,8,8,8,8,8,8,8,8
+8,8,8,8,8,8,8,8,8,15,15,15,15,6,6,5,12,11,11,11,10,10,10,9,9,9,0,0,0,0,0,0
+16,16,16,16,16,16,15,15,15,14,15,13,12,13,12,11,2,2,9,9,-8,-8,-8,-8,-8,-8,-8,-8,-8,-8,-8,-8
+8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,-8,8,8,8,8,8,8,-8,8,8,8,8,8,8,8,8,-8,8,-3,-3,-3,-3,8,-8,8,8,8,8,8,8,8,8,-8,8,-3,17,17,-3,8,-8,8,8,8,8,8,8,8,8,-8,8,-3,17,17,-3,8,-8,8,8,8,8,8,8,8,8,-8,8,-3,-3,-3,-3,8,-8,8,8,8,8,8,8,8,8,-8,8,8,8,8,8,8,-8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,17,3,3,17,17,3,3,17,0,0,0,0,0,0,0,0,3,12,12,3,3,12,12,3,0,0,0,0,0,0,0,0,12,-3,-3,12,12,-3,-3,12,0,0,0,0,0,0,0,0,12,-3,-3,12,12,-3,-3,12,0,0,0,0,0,0,0,0,3,12,12,3,3,12,12,3,0,0,0,0,0,0,0,0,17,3,3,17,17,3,3,17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-12,7,7,-27,-27,7,7,-12,0,0,0,0,0,0,0,0,7,1,1,7,7,1,1,7,0,0,0,0,0,0,0,0,1,-6,-6,1,1,-6,-6,1,0,0,0,0,0,0,0,0,1,-6,-6,1,1,-6,-6,1,0,0,0,0,0,0,0,0,7,1,1,7,7,1,1,7,0,0,0,0,0,0,0,0,-12,7,7,-27,-27,7,7,-12,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
+0,-32,-41,-91,-102,-170,-207,-222,-250,0,-7,1,-76,-76,-120,-184,-200,-216,0,-21,-7,-18,-30,-48,-78,-111,-138,0,-7,-21,-25,-31,-47,-57,-95,-121
+16,5,-7,-33,-32,-19,-34,-85,-100
+0,1,-24,-9,-18,-18,-9,-24,1
+-5
+13
+0,0,194,135,54,20,-6,-3,0,0,0,-3,-6,20,54,135,194,0
+0,0,0,48,42,14,21,17,0,0,0,17,21,14,42,48,0,0
+0,0,80,58,56,29,10,21,0,0,0,21,10,29,56,58,80,0
+0,0,92,80,21,6,11,1,0,0,0,1,11,6,21,80,92,0
+0,0,15,30,21,28,34,41,55
+92,-1,-1,53,-1,3,19,-1,6,9,12,-4,-5,-5,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8
+784
+-8,-14,-10,-24,-38
+1
+-16,-16,-16,-16,-16,-16,-16,-16,-16,-16,-16,-16,-16,-16,-16,-16,-16,21,68,51,34,41,48,55,37,59,57,40,40,40,40,40,40,40
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-20,-14,-7,-7,-7,-7,-14,-20,0,0,0,0,0,0,0,0,-14,-7,-17,-8,-8,-17,-7,-14,0,0,0,0,0,0,0,0,-7,-8,-10,-11,-11,-10,-8,-7,0,0,0,0,0,0,0,0,-7,-8,-10,-11,-11,-10,-8,-7,0,0,0,0,0,0,0,0,-14,-7,-17,-8,-8,-17,-7,-14,0,0,0,0,0,0,0,0,-20,-14,-7,-7,-7,-7,-14,-20,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-1,-1,-2,-2,-2,-2,-1,-1,0,0,0,0,0,0,0,0,-11,-4,-4,-4,-4,-4,-4,-11,0,0,0,0,0,0,0,0,-4,-5,1,-16,-16,1,-5,-4,0,0,0,0,0,0,0,0,-4,-5,1,-16,-16,1,-5,-4,0,0,0,0,0,0,0,0,-11,-4,-4,-4,-4,-4,-4,-11,0,0,0,0,0,0,0,0,-1,-1,-2,-2,-2,-2,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
+-38,-22,-26,-13,-9,0,1,11,4,13,22,15,40,-7
+-18,4,9,3,12,-3,-3,-3
+8,1,36,26,32,-12,8,-26,-16
+2,2,2,17,17,8,8,7,7,-2,13,20,3,18,9,16,16,16,16,16,16,16,16,16,16,16,16,16,16,16,16,16,16
+-60,-16,-16,-16,-16,-16,-16,-60,0,0,0,0,0,0,0,0,-16,-2,-2,0,0,-2,-2,-16,0,0,0,0,0,0,0,0,-16,-2,-4,13,13,-4,-2,-16,0,0,0,0,0,0,0,0,-16,-2,13,16,16,13,-2,-16,0,0,0,0,0,0,0,0,-16,-2,13,16,16,13,-2,-16,0,0,0,0,0,0,0,0,-16,-2,-4,13,13,-4,-2,-16,0,0,0,0,0,0,0,0,-16,-2,-2,0,0,-2,-2,-16,0,0,0,0,0,0,0,0,-60,-16,-16,-16,-16,-16,-16,-60,0,0,0,0,0,0,0,0
+8,-9,12,1,12,8,8,8,8
+-24,9,11,38,14,-24,-24,-24,-24
+-8,4,27,25,22,3,-8,-8,-8,-8,-8,-8,-8,3,22,25,27,4
+-33,-18,-14,-8,-5,5,15,8,8
+16,12,0
+8,8,8,8,8,8,8,8,8,8,9,18,4,6,17,-13,12,5,-17,1,19,-3,-3,30,30,23,23,24,24,25,25,26,27
+48,38,41,38,29,29,20,20
+12,11,17,17,32,32,32,15
+-3,12,11,11,17,17,17,16
+-24,-24,41,17,4,-2,-31,-24,-24,-24,-24,-24,-31,-2,4,17,41,-24
+0,0,-54,-16,11,-9,19,-3,0,0,0,-3,19,-9,11,-16,-54,0
+-48
+46
+7,35,92,46,33,-5,-10,16,-17,-15,-27,-38,-57,-44,-42,-70,-41
+7
+4
+-36,-16,-20,-14,-7,-10,0,4,8,12,15,9,19,13,14
+1,10,8,12,8,8,8,8
+-54,-34,-22,-17,-19,-8,-4,-2,7,10,12,15,18,4,30,31,32,41,42,35,36,36,21,21,6,6,7,7
+0,-14,-6,-2,-25
+0,34,76,30,27,9,8,-1
+-8
+1,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,0,0,0,0,0,0,0,0,3,3,3,3,3,3,3,3,0,0,0,0,0,0,0,0,4,4,4,4,4,4,4,4,0,0,0,0,0,0,0,0,4,4,4,4,4,4,4,4,0,0,0,0,0,0,0,0,4,4,4,4,4,4,4,4,0,0,0,0,0,0,0,0,4,4,4,4,4,4,4,4,0,0,0,0,0,0,0,0,4,4,4,4,4,4,4,4,0,0,0,0,0,0,0,0,4,4,4,4,4,4,4,4,0,0,0,0,0,0,0,0,4,4,4,4,4,4,4,4,0,0,0,0,0,0,0,0,4,4,4,4,4,4,4,4,0,0,0,0,0,0,0,0,4,4,4,4,4,4,4,4,0,0,0,0,0,0,0,0,4,4,4,4,4,4,4,4,0,0,0,0,0,0,0,0,3,3,3,3,3,3,3,3,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,0,0,0,0,0,0,0,0,1,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0
+-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-23,3,5,-1,-1,5,3,-23,-32,-32,-32,-32,-32,-32,-32,-32,3,5,13,15,15,13,5,3,-32,-32,-32,-32,-32,-32,-32,-32,5,-1,41,31,31,41,-1,5,-32,-32,-32,-32,-32,-32,-32,-32,5,-1,41,31,31,41,-1,5,-32,-32,-32,-32,-32,-32,-32,-32,3,5,13,15,15,13,5,3,-32,-32,-32,-32,-32,-32,-32,-32,-23,3,5,-1,-1,5,3,-23,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32,-32
+0,-4,-40,-28,-24,-28,-33,-39,-30,-50,-55,-60,-90,-97,-104,-135,-150,-141,-148,-211,-210,-217,-240,-255,-286,-306,-262,-330,-350,-386,-390,-378,-448,-462,-508,-508,-508,-508,-508,-508,-508,-508
+9
\ No newline at end of file