feat: proactive weather ability

[melodygui]

What does this Ability do?

Provides on-demand weather queries with a concise voice-friendly forecast summary, and runs a background daemon that silently monitors conditions every 10 minutes and proactively interrupts the conversation if severe weather is detected. Also writes local_weather.md to persistent storage so the Personality stays passively aware of local weather conditions throughout the session.

Suggested Trigger Words

• what's the weather
• how's the weather
• weather
• will it rain
• do I need an umbrella

Type

• New community Ability
• Improvement to existing Ability
• Bug fix
• Documentation update

External APIs

• No external APIs
• Uses external API(s): Open-Meteo (weather data, free, no API key required), Nominatim/OpenStreetMap (geocoding, free, no API key required)

Testing

• Tested in OpenHome Live Editor
• All exit paths tested (said "stop", "exit", etc.)
• Error scenarios tested (API down, bad input, etc.)

Checklist

• Files are in community/my-ability-name/
• main.py follows SDK pattern (extends MatchingCapability, has register_capability + call)
• README.md included with description, suggested triggers, and setup
• resume_normal_flow() called on every exit path
• No print() — using editor_logging_handler
• No hardcoded API keys — using placeholders
• No blocked imports (redis, user_config)
• No asyncio.sleep() or asyncio.create_task() — using session_tasks
• Error handling on all external calls
• Tested in OpenHome Live Editor

Anything else?

This ability uses the new background.py daemon infrastructure introduced in the March 2026 SDK update. It is an Interactive Combined ability: main.py handles the reactive weather query flow and background.py runs as a persistent daemon for the entire session.

[github-actions]

🔀 Branch Merge Check

PR direction: weather-alerts → dev

✅ Passed — weather-alerts → dev is a valid merge direction

[github-actions]

✅ Community PR Path Check — Passed

All changed files are inside the community/ folder. Looks good!

[github-actions]

✅ Ability Validation Passed

📋 Validating: community/proactive-weather
  ✅ All checks passed!

[github-actions]

🔍 Lint Results

🔧 Auto-formatted

Some files were automatically cleaned and formatted with autoflake + autopep8 and committed.

• ✅ Unused imports removed (autoflake)
• ✅ Unused variables removed (autoflake)
• ✅ PEP8 formatting applied (autopep8)

✅ __init__.py — Empty as expected

Files linted: community/proactive-weather/background.py community/proactive-weather/main.py

✅ Flake8 — Passed

✅ All checks passed!