Space Window ability

[hassan1731996]

What is Space Window?

A sky-watching ability that tells you exactly what's happening above your location tonight — ISS passes, aurora activity, and rocket launches — and alerts you before anything good happens so you never miss it.

Say your city once. After that it handles everything: ISS alerts 10 minutes before a visible pass, aurora alerts when the Kp index spikes high enough for your latitude, and launch countdowns 24 hours and 1 hour before liftoff.

Key Features

Proactive Alerts (background daemon)

• ISS: fires ~10 minutes before any visible pass with rise time, compass direction, peak elevation, and duration. 40-minute look-ahead window prevents passes falling between 30-minute polls
• Aurora: monitors NOAA Kp index every 30 minutes, alerts when it crosses the visibility threshold for your latitude — auto-calculated, adjustable
• Launches: 24-hour and 1-hour warnings before confirmed launches via Launch Library 2
• Morning brief at 9am local time: today's ISS passes, launches, and aurora status in one sentence

Interactive Queries

• TONIGHT: full sky summary — ISS, aurora, launches — in one shot
• ISS: next 2 days of visible passes with quality rating (great/good/fair by peak elevation), compass directions, and local times
• AURORA: current Kp, whether it's above your threshold, how far away you are from visibility
• LAUNCHES: next 7 days of confirmed launches with rocket, site, and countdown
• SETUP: set city once, persisted across sessions with timezone auto-detection
• ALERTS: toggle each alert type, adjust minimum elevation, set aurora Kp threshold

Smart Details

• ISS pass quality rated by peak elevation: great (≥60°), good (≥40°), fair (≥30°) — only alerts on passes worth going outside for
• Aurora threshold auto-set from latitude — London needs Kp 6, Oslo needs Kp 4, both hemispheres supported
• 80+ cities in built-in map with LLM fallback for anything else
• All times shown in user's local timezone via stdlib zoneinfo
• Aurora and launch monitoring need zero API keys — active immediately after location is set

APIs Used

API	Data	Key Required
N2YO	ISS pass predictions with elevation + compass	Free (registration)
NOAA Space Weather	Kp index / aurora	None
Launch Library 2	Rocket launches	None

Files

• community/space-window/main.py — foreground skill (6 intents, LLM router, all handlers)
• community/space-window/background.py — daemon (ISS/aurora/launch monitoring, morning brief)
• community/space-window/README.md — trigger phrases, setup, full example conversation

[github-actions]

🔀 Branch Merge Check

PR direction: feature/space-window → dev

✅ Passed — feature/space-window → dev is a valid merge direction

[github-actions]

🚫 Community PR Path Check — Failed

Community PRs can only modify files inside the community/ folder.

❌ Not Allowed

• ❌ .gitignore
• ❌ .vscode/extensions.json
• ❌ .vscode/launch.json
• ❌ .vscode/settings.json
• ❌ .vscode/spellright.dict
• ❌ .vscode/tasks.json
• ❌ CONTRIBUTORS.md
• ❌ public/fonts/README.md
• ❌ public/fonts/fa-brands-400.eot
• ❌ public/fonts/fa-brands-400.svg
• ❌ public/fonts/fa-brands-400.ttf
• ❌ public/fonts/fa-brands-400.woff
• ❌ public/fonts/fa-brands-400.woff2
• ❌ public/fonts/fa-regular-400.eot
• ❌ public/fonts/fa-regular-400.svg
• ❌ public/fonts/fa-regular-400.ttf
• ❌ public/fonts/fa-regular-400.woff
• ❌ public/fonts/fa-regular-400.woff2
• ❌ public/fonts/fa-solid-400.woff2
• ❌ public/fonts/fa-solid-900.eot
• ❌ public/fonts/fa-solid-900.svg
• ❌ public/fonts/fa-solid-900.ttf
• ❌ public/fonts/fa-solid-900.woff
• ❌ public/fonts/fa-solid-900.woff2

---

Please remove changes to files outside community/.
If you need changes elsewhere, open an issue to discuss with maintainers.

[github-actions]

✅ Ability Validation Passed

📋 Validating: community/space-window
  ✅ All checks passed!

[github-actions]

🔍 Lint Results

✅ __init__.py — Empty as expected

Files linted: community/space-window/background.py community/space-window/main.py

✅ Flake8 — Passed

✅ All checks passed!