Check Hive Test Progress

Monitor the progress of a running Hive consensus test suite and optionally update documentation.

Arguments

• --update

  : Automatically update SITREP.md and TODO.md without asking
• (no args): Show progress, then ask user if they want to update docs

What This Skill Does

1. Finds the active Hive test run by checking recent simulator logs
2. Counts completed tests from the details log
3. Analyzes client log timestamps to calculate actual running time (excluding hibernation gaps)
4. Estimates remaining time based on test rate
5. Displays progress summary
6. If

   --update

   passed: automatically updates SITREP.md only
7. If no args: asks user "Would you like me to update SITREP.md with this progress?"

Note: Only SITREP.md is updated. TODO.md is for future plans only.

How to Find Test Progress

1. Find the Active Simulator Log

# Find the most recent simulator details log
/bin/ls -lt /workspaces/etc-nexus/hive/workspace/logs/details/ | head -5

The active log will be the most recently modified file matching

*-simulator-*-0.log

2. Count Completed Tests

# Count test entries (each test starts with "-- ")
grep -c "^-- " /workspaces/etc-nexus/hive/workspace/logs/details/<log-file>

3. Analyze Timestamps for Hibernation Gaps

Check client log distribution to find gaps (hibernation periods):

# Get timestamp distribution of client logs
/bin/ls -lt /workspaces/etc-nexus/hive/workspace/logs/core-geth/ | awk '{print $6, $7, $8}' | sort | uniq -c

Look for gaps >30 minutes between consecutive timestamps - these indicate hibernation.

4. Calculate Test Rate

rate = completed_tests / active_minutes (excluding hibernation)

Typical rate on this machine: ~70 tests/minute

5. Estimate Remaining Time

remaining_tests = total_tests - completed_tests
remaining_time = remaining_tests / rate

Test Suite Totals (Reference)

legacy

--sim.limit legacy

legacy-cancun

--sim.limit legacy-cancun

consensus

--sim.limit consensus

Update Documentation

After displaying progress:

• If

  --update

  flag was passed: automatically update SITREP.md
• Otherwise: ask the user "Would you like me to update SITREP.md with this progress?"

SITREP.md (Only File to Update)

Update the test progress section with:

• Progress: X / Y tests (Z%)
• Rate: ~N tests/minute
• Estimated time remaining: ~H hours
• Status: Running / Completed / Interrupted

Do NOT update TODO.md - It's for future plans only.

Example Output

=== Hive Test Progress ===
Suite: legacy (LegacyTests/Constantinople/BlockchainTests)
Progress: 17,468 / 32,615 (54%)
Rate: ~70 tests/minute
Estimated remaining: ~3.6 hours
Estimated total: ~7.8 hours

Note: Hibernation gap detected 15:21-22:36 UTC (excluded from estimates)

Troubleshooting

• If no active log found, check if hive is running:

  ps aux | grep hive

• If timestamps show no recent activity, the test may have completed or stalled
• Check

  hive.json

  for run metadata:

  cat /workspaces/etc-nexus/hive/workspace/logs/hive.json