NNUE search integration: FH% tables, NODE_TYPE refinement, TREEDUMP rewrite

- data.c/chess.h: widen the joint FH% table's late axis 16->17, dedicating
  the new bucket 0 to a whole-node ("will something here fail high at
  all") sample rather than sharing it with the first-leftover-move curve.
  Add an NNUE-eval counterpart table (g_uJointFHThousandths_NNUE) and an
  NNUE counterpart of the beta-side table, selected at runtime based on
  whether NNUE eval is active.
- search.c/searchsup.c: add _RefineNodeTypeGuess, which uses the FH%
  tables (via g_NodeTypeGuessTable) to refine a node's NODE_TYPE guess
  instead of the old heuristic; thread uParentMoveFHEstimate through
  PLY_INFO so a node can see its parent's prediction for the move that
  led to it.
- generate.c: initialize sKillers[2]/[3].uBonus unconditionally (an
  uninitialized-stack read caught by valgrind under LTO; harmless today
  but a real bug).
- dumptree.c/chess.h/GNUmakefile: replace the long-dead DUMP_TREE XML
  tree dump (written for a GUI this project no longer has) with TREEDUMP,
  a flat, path-keyed move/result trace meant to diff against an
  identically-instrumented Stockfish build -- see docs/TREEDUMP_FORMAT.md.
- docs/DEEPER_PRUNING.md: notes on closing the search-efficiency gap vs
  Stockfish.
- crafty_egtb/stockfish_xboard/typhoon_nnue: wrapper scripts so
  match_play.py's Engine class can drive Crafty, Stockfish (via
  PolyGlot), and an NNUE-enabled typhoon the same way it drives HCE
  typhoon.
- tests/lop: rename lop.txt -> lop.ep_; update compare_lop.cpp.
- annotate_pgns: add aggregate_marginsafety.py, dedup_pgn.py,
  fit_lazy_probe.py; update annotate.py/run_nnue_pipeline.py for the NNUE
  training pipeline.
- .gitignore: ignore compile_commands.json (clangd build DB) and
  eval.nnue (a symlink into the untracked head_reference/ comparison
  baseline), neither of which belongs in the repo.

Co-Authored-By: Claude Sonnet 5 <[email protected]>

1 files changed, 6 insertions, 5 deletions

diff --git a/src/GNUmakefile b/src/GNUmakefile
index 08cbf15..e710834 100644
--- a/src/GNUmakefile
+++ b/src/GNUmakefile
@@ -15,7 +15,8 @@
 #    perf-counter set by default.
 #  BOUNDS_CHECKING=1: make version with bounds checking enabled
 #  MP=1: make version for multi-processor machine
-#  DUMP_TREE=1: internal tree dumping version
+#  TREEDUMP=1: dump a flat MOVE/RESULT search-tree trace to
+#    treedump.log (see TREEDUMP_FORMAT.md)
 #  OSX=1: build for an Intel-based Apple Mac (omit this for FreeBSD/Linux)
 #  USE_READLINE=1: link against the GNU readline library
 #  SIXTYFOUR=1: make an X64 binary
@@ -157,7 +158,7 @@ ifndef DISABLE_BITBOARD_MOVEGEN
 endif
 
 ifdef EVERYTHING
-PROFILE 	+=	-DEVAL_DUMP -DEVAL_TIME -DPERF_COUNTERS -DMP -DSMP -DTEST_NULL -DDUMP_TREE -fbounds-checking -DMOVE_ORDERING_EVIDENCE_COLLECTION
+PROFILE 	+=	-DEVAL_DUMP -DEVAL_TIME -DPERF_COUNTERS -DMP -DSMP -DTEST_NULL -DTREEDUMP -fbounds-checking -DMOVE_ORDERING_EVIDENCE_COLLECTION
 else
 ifdef EVAL_DUMP
 PROFILE		+= 	-DEVAL_DUMP
@@ -203,8 +204,8 @@ endif
 ifdef TEST_NULL
 PROFILE		+=	-DTEST_NULL
 endif
-ifdef DUMP_TREE
-PROFILE 	+=  -DDUMP_TREE
+ifdef TREEDUMP
+PROFILE 	+=  -DTREEDUMP
 endif
 ifdef CALIBRATE_POSITIONAL
 PROFILE		+=	-DCALIBRATE_POSITIONAL
@@ -397,7 +398,7 @@ ifdef EVAL_DUMP
 OBJS	+=	testeval.o testsup.o
 endif
 endif
-ifdef DUMP_TREE
+ifdef TREEDUMP
 OBJS	+=	dumptree.o
 endif
 ifdef MP