Add geofence validation, distance filtering, and debug mode

[MrAlders0n]

Merge Notes: dev → main

Here's a detailed breakdown of all changes in the dev branch that will be merged into main:

---

📄 .gitignore

Added temporary files directory to ignore list:

# Temporary files
tmp/

---

📄 README.md

Improved setup instructions for both Android and iOS:

• Added explicit steps to join the #wardriving public hashtag channel in the MeshCore app before using the web app
• Both platform instructions now include detailed sub-steps for adding the channel via the app's menu

---

📄 index.html

New UI element - Added a "Distance from last ping" display row in the GPS info table:

<tr>
  <td class="pr-3 text-slate-400 whitespace-nowrap align-top">Distance from last ping:</td>
  <td id="distanceInfo">-</td>
</tr>

---

📄 content/wardrive.js (Major changes)

This is the bulk of the update with significant feature additions and refactoring:

🔧 Debug System

• Added URL parameter-based debug logging (?debug=true)
• New debugLog(), debugWarn(), debugError() helper functions
• Extensive debug logging throughout the codebase

🌍 Geofence Validation

• Added Ottawa geofence (centered on Parliament Hill, 150km radius)
• New validateGeofence() function using Haversine distance calculation
• Pings outside the geofence are blocked with appropriate status messages

📏 Distance-Based Ping Filtering

• Minimum 25m distance requirement between consecutive pings
• New calculateHaversineDistance() function for accurate distance calculations
• New validateMinimumDistance() function
• Tracks lastSuccessfulPingLocation for distance comparisons
• Real-time "Distance from last ping" UI updates every 3 seconds

⏱️ Countdown Timer Refactoring

• Created generalized createCountdownTimer() factory function
• Refactored auto-ping and API countdown timers to use the new system
• Added pause/resume functionality for auto countdown when manual pings are sent during auto mode
• New constants: MIN_PAUSE_THRESHOLD_MS (1s), MAX_REASONABLE_TIMER_MS (5min) for clock skew handling

🎨 Status Color System

• New STATUS_COLORS constant object for consistent UI colors:
  • idle: slate-300
  • success: emerald-300
  • warning: amber-300
  • error: red-300
  • info: sky-300

📍 GPS Handling Improvements

• New GPS_WATCH_MAX_AGE_MS constant (60s) for manual ping GPS data validation
• Improved getGpsCoordinatesForPing() function with better handling of GPS watch data
• New acquireFreshGpsPosition() helper function
• Better fallback logic when GPS data is stale

🔄 Skip Reason Tracking

• New state.skipReason property to track why pings were skipped
• Countdown displays now show skip reasons (e.g., "outside geofence", "too close", "gps too old")

🧹 Code Organization

• New cleanupAllTimers() function for comprehensive timer cleanup
• Refactored scheduleApiPostAndMapRefresh() as a standalone function
• New getDeviceIdentifier() helper function
• New logPingToUI() helper function
• Better separation of concerns throughout

🐛 Bug Fixes & Improvements

• Fixed potential timer state issues during manual pings in auto mode
• Added getRemainingCooldownSeconds() helper
• Improved wake lock acquisition/release logging
• Better error handling and user feedback

---

Summary of Key New Features

Feature	Description
🌍 Geofence	Pings restricted to 150km radius around Ottawa
📏 Min Distance	25m minimum between consecutive pings
🐛 Debug Mode	Enable via ?debug=true URL parameter
📍 Distance UI	Real-time distance from last ping display
⏸️ Timer Pause	Auto countdown pauses during manual pings
📋 Setup Guide	Improved README with channel setup instructions