Files
meshcore-bot/modules/commands/satpass_command.py
T
agessaman fc63039a48 fix: address Codex review of tonight's work
Correctness:

- {path_distance} was always blank in production. The resolution code that
  builds repeater_info dropped latitude/longitude in every branch, so the
  calculator could never find a coordinate. My tests passed hand-built
  dicts straight to the calculator and never exercised the builder, which
  is why they stayed green. Coordinates are now carried through all four
  construction sites, and the new tests drive _lookup_repeater_names via
  its lookup_func hook so the real builder runs.

- The #80 route guard was defeated two ways in the channel handler. When
  the RF data was an uncorrelated fallback, control fell through to the
  raw-hex and routing_info fallbacks below, which took the route from the
  unrelated packet anyway; the guard had actually made that path
  reachable. message.routing_info was also assigned unconditionally, and
  the path command reads it. "Not attributable" is now a terminal branch
  and the routing_info hand-off checks provenance.

- Same fix was incomplete for DMs: routing_info was captured and turned
  into path_info before the provenance check ran, so the later check only
  declined to overwrite an already-wrong value. Guarded at the source.

- Rendering could transmit for real. Capture only intercepts
  send_response, but advert calls send_advert() directly and
  send_response_chunked never checked capture_sink. Chunked sends are now
  captured, and rendering is opt-in via BaseCommand.render_safe (default
  False) instead of a denylist that cannot be complete. This also closes
  the DM-only leak: schedule is not marked safe, so {cmd:schedule} can no
  longer broadcast configuration to a channel.

- Multi-part rendered output was rejoined into one oversized send.
  Scheduled messages are now split to the RF body budget and sent through
  send_channel_messages_chunked, on character boundaries so multi-byte
  text is not corrupted.

- _last_path_distance_km is instance state that was only set on success,
  so an invalid path request could show the previous request's distance.
  Reset at the start of every execute().

- Stale-contact retries were only counted on non-OK results, so timeouts
  and exceptions left a contact eligible forever and could recreate the
  storm. All failed attempts count now.

Web viewer:

- A failed config reload was reported as a successful save. The API and
  UI now distinguish "saved and active" from "saved, restart needed".

- Preview count was unbounded; clamped to 1-20.

- update_ini_values is a read-modify-replace with no locking, so two
  concurrent viewer saves could lose one. Serialised behind a lock.
2026-08-22 00:16:03 -07:00

124 lines
4.2 KiB
Python

#!/usr/bin/env python3
"""
Satellite Pass Command - Provides satellite pass information
"""
from ..models import MeshMessage
from ..solar_conditions import get_next_satellite_pass
from .base_command import BaseCommand
class SatpassCommand(BaseCommand):
"""Command to get satellite pass information"""
# Plugin metadata
# Read-only informational output; safe for scheduled {cmd:...} rendering.
render_safe = True
name = "satpass"
keywords = ['satpass']
description = "Get satellite pass info: satpass <NORAD_number_or_shortcut> [visual]"
category = "solar"
requires_internet = True # Requires internet access for N2YO API
# Documentation
short_description = "Get satellite pass predictions"
usage = "satpass <NORAD_number|shortcut> [visual]"
examples = ["satpass iss", "satpass 25544 visual"]
parameters = [
{"name": "satellite", "description": "NORAD ID or shortcut (iss, hst, starlink)"},
{"name": "visual", "description": "Add 'visual' for visible passes only"}
]
# Common satellite shortcuts
SATELLITE_SHORTCUTS = {
'iss': '25544',
'hst': '20580', # Hubble Space Telescope
'hubble': '20580',
'starlink': '44294', # Example Starlink satellite
'tiangong': '48274', # Tiangong space station
'goes18': '51850', # GOES-18 weather satellite
}
def __init__(self, bot):
"""Initialize the satpass command.
Args:
bot: The bot instance.
"""
super().__init__(bot)
self.satpass_enabled = self.get_config_value('Satpass_Command', 'enabled', fallback=True, value_type='bool')
def can_execute(self, message: MeshMessage, skip_channel_check: bool = False) -> bool:
"""Check if this command can be executed with the given message.
Args:
message: The message triggering the command.
Returns:
bool: True if command is enabled and checks pass, False otherwise.
"""
if not self.satpass_enabled:
return False
return super().can_execute(message)
async def execute(self, message: MeshMessage) -> bool:
"""Execute the satpass command.
Args:
message: The message triggering the command.
Returns:
bool: True if executed successfully, False otherwise.
"""
try:
# Check if user provided a satellite number
content = message.content.strip()
if content == 'satpass':
# No satellite specified, show short usage (fits message length limit)
await self.send_response(message, self.translate('commands.satpass.usage_short'))
return True
# Extract satellite identifier from command
parts = content.split()
if len(parts) < 2:
error_msg = self.translate('commands.satpass.no_satellite')
await self.send_response(message, error_msg)
return True
satellite_input = parts[1].lower()
# Check for "visual" or "vis" option
use_visual = False
if len(parts) >= 3:
option = parts[2].lower()
if option in ['visual', 'vis']:
use_visual = True
# Check if it's a shortcut first
if satellite_input in self.SATELLITE_SHORTCUTS:
satellite = self.SATELLITE_SHORTCUTS[satellite_input]
else:
# Assume it's a NORAD number
satellite = satellite_input
# Get satellite pass information
pass_info = get_next_satellite_pass(satellite, use_visual=use_visual)
# Send response
response = self.translate('commands.satpass.header', pass_info=pass_info)
await self.send_response(message, response)
return True
except Exception as e:
error_msg = self.translate('commands.satpass.error', error=str(e))
await self.send_response(message, error_msg)
return False
def get_help_text(self) -> str:
"""Get help text for this command.
Returns:
str: The help text for this command.
"""
return self.translate('commands.satpass.description')