#!/usr/bin/env fish
# FKRPG worldgen test — repeatable, never touches production world
# Usage: fish tools/worldgen-test.fish

set -l repo (dirname (dirname (realpath (status filename))))

echo "=== FKRPG WORLDGEN TEST (repeatable, dry-run documented) ==="
echo "This is a procedure stub — actual pregeneration requires a running test server."
echo
echo "Steps (on LOCAL TEST only, same seed/border/mods/configs):"
echo "  1. Backup: cp -a ~/.auto-mcs/Servers/FKRPG/world /tmp/world-backup-(date +%F)"
echo "  2. Fresh world: rm -rf ~/.auto-mcs/Servers/FKRPG/world; mkdir -p ~/.auto-mcs/Servers/FKRPG/world"
echo "  3. Set seed: echo 'level-seed=FKRPG-bench-1' >> ~/.auto-mcs/Servers/FKRPG/server.properties"
echo "  4. Start: ./Start.sh (or docker compose up) — wait for 'Done!'"
echo "  5. Pregen: /chunksmith pregen 128  OR  /forceload add -5000 -5000 5000 5000"
echo "  6. Measure: time, CPU, RAM, MSPT (spark), disk IO (iostat), chunks/sec (ChunkSmith log)"
echo "  7. Record to benchmarks/worldgen-(date).json and compare to baseline.json"
echo
echo "Metrics to capture:"
echo "  - chunks_generated, time_required, cpu_percent, ram_gb, mspt, disk_io_mb_s"
echo "  - Compare: baseline vs optimized — only claim win if chunks/sec up and MSPT stable"
echo
echo "Safety: never run on production world or with production seed; use isolated test world."