TAXONOMY

[FILE: docs/TAXONOMY.md]

# Skyfeed Weather Alert Taxonomy Canada
Version v0.1.0-dev1
Scope Environment Canada MSC Alerts for Skyfeed and Telefact

Skyfeed is a Canada-focused weather engine.
This taxonomy defines all alert types Skyfeed aims to support, based on

Environment Canada Meteorological Service of Canada
Canadian severe weather and marine alerts
Air quality and wildfire smoke products

The goal is to mirror every alert type that can realistically be issued for Canada, so that
Nothing important is missed
Alerts can be formatted and colour-coded cleanly
The taxonomy can be localised to en-CA, fr-CA, and iu-CA Inuktitut

Note This file is taxonomy only.
Implementation details will live in internalweatheralerts.go and related files.

------------------------------------------------------------
1. Alert Levels and Concepts
------------------------------------------------------------

Skyfeed recognises these conceptual alert levels

Warning
Watch
Advisory
Statement
Information or Special Weather

Severity handling
1 Warnings
2 Watches
3 Advisories
4 Statements and informational products

------------------------------------------------------------
2. Core Severe Weather Warnings
------------------------------------------------------------

Tornado Warning
Severe Thunderstorm Warning
Snow Squall Warning
Squall Warning
Winter Storm Warning
Blizzard Warning
Snowfall Warning
Rainfall Warning
Freezing Rain Warning
Flash Freeze Warning
Wind Warning
Extreme Cold Warning
Heat Warning
Arctic Outflow Warning
Storm Surge Warning
Tropical Storm Warning
Hurricane Warning
Storm Warning Marine
Gale Warning Marine
Freezing Spray Warning Marine
High Water Level Warning

------------------------------------------------------------
3. Watches
------------------------------------------------------------

Tornado Watch
Severe Thunderstorm Watch
Snow Squall Watch
Special Weather Watch
Heat Watch
Cold Watch
Wind Watch
Hurricane Watch
Tropical Storm Watch
Storm Surge Watch

------------------------------------------------------------
4. Advisories
------------------------------------------------------------

Fog Advisory
Freezing Drizzle Advisory
Freezing Fog Advisory
Special Weather Advisory
Rainfall Advisory
Snowfall Advisory
Wind Advisory
Blowing Snow Advisory
Marine Fog Advisory
Freezing Spray Advisory

------------------------------------------------------------
5. Statements and Information Products
------------------------------------------------------------

Weather Statement
Special Weather Statement
Air Quality Statement
Smoke Statement
Dust Statement
Temperature Statement
Tropical Cyclone Information Statement
Outlook or Long Range Statement

------------------------------------------------------------
6. Air Quality and Wildfire Related Alerts
------------------------------------------------------------

Air Quality Advisory
Air Quality Statement
Wildfire Smoke Advisory
Wildfire Smoke Statement
Smoke Advisory
Dust and Smoke Statement

------------------------------------------------------------
7. Marine and Coastal Alerts
------------------------------------------------------------

Gale Warning
Storm Warning
Hurricane Force Wind Warning
Strong Wind Warning
Freezing Spray Warning
Squall Warning
Blizzard Warning Marine
High Water Level Warning
Storm Surge Warning
Wave or Surf Warning

------------------------------------------------------------
8. Arctic and Northern-Specific Alerts
------------------------------------------------------------

Arctic Outflow Warning
Extreme Cold Warning
Wind Chill Warning
Blowing Snow Advisory
Blizzard Warning
Freezing Spray Warning

------------------------------------------------------------
9. Rare but Possible Phenomena in Canada
------------------------------------------------------------

Funnel Cloud Advisory
Waterspout Warning
Tropical Cyclone Information Statement
Thunderstorm Outlook or Convective Outlook

------------------------------------------------------------
10. Out of Scope For Now
------------------------------------------------------------

Volcano Warning
Ashfall Warning
Lahar Warning
Lava Flow Warning
Tsunami Warning or Advisory
Radiation or Nuclear Incident Warning
Sandstorm or Haboob Alert

If such an event appears in CAP data, Skyfeed will classify it under Other Alert.

------------------------------------------------------------
11. Internal Skyfeed Alert Codes Planned
------------------------------------------------------------

Skyfeed will define internal alert keys, for example

tornado_warning
severe_thunderstorm_warning
snow_squall_warning
heat_warning
fog_advisory
air_quality_statement
arctic_outflow_warning
hurricane_watch
wildfire_smoke_advisory

Each code will map to
English label
French label
Inuktitut label
Severity
Colour theme
Optional long description

------------------------------------------------------------
12. Language and Localisation Notes
------------------------------------------------------------

Supported languages
en-CA / Canadian English
fr-CA / Canadian French
iu-CA / Inuktitut

------------------------------------------------------------
13. Future Work
------------------------------------------------------------

CAP to Skyfeed mapping layer
Colour and icon system
Alert grouping rules
Multi-language rendering
Per-page prioritisation for Telefact

END OF FILE

[FILE: docs/TAXONOMY_WEATHER.md]

# Skyfeed Weather Condition Taxonomy
Version v0.1.0-dev1
Scope Normalised condition codes for Canada for Skyfeed and Telefact

This document defines all base weather conditions, grouped logically, and provides stable internal keys for Skyfeed.
Translations will be handled separately.

------------------------------------------------------------
1. Skyfeed Condition Structure
------------------------------------------------------------

Each condition has
A unique internal key
A short description
A category
A suggested icon
A colour theme mapping

Categories are
Sky conditions
Precipitation
Visibility
Wind
Arctic or cold-specific
Thunderstorm and convection
Smoke and air quality
Marine

------------------------------------------------------------
2. Sky Conditions
------------------------------------------------------------

clear
mainly_clear
partly_cloudy
mostly_cloudy
cloudy
overcast
sunny_breaks
cloudy_with_sunny_breaks

------------------------------------------------------------
3. Precipitation Types
------------------------------------------------------------

drizzle
light_drizzle
freezing_drizzle
rain
light_rain
heavy_rain
freezing_rain
rain_showers
snow
light_snow
heavy_snow
ice_pellets
sleet
mixed_precipitation
snow_showers
rain_and_snow
hail
graupel

------------------------------------------------------------
4. Visibility and Obscuration
------------------------------------------------------------

fog
freezing_fog
mist
haze
smoke
blowing_snow
drifting_snow
dust
sand
ice_crystals

------------------------------------------------------------
5. Wind and Motion
------------------------------------------------------------

wind_light
wind_moderate
wind_strong
wind_gale
wind_storm
wind_hurricane_force
gusty_winds

------------------------------------------------------------
6. Thunderstorm and Convective Weather
------------------------------------------------------------

thunderstorm
strong_thunderstorm
severe_thunderstorm
thundershowers
lightning_only

------------------------------------------------------------
7. Arctic and Northern Conditions
------------------------------------------------------------

extreme_cold
wind_chill
arctic_outflow
ice_fog
polar_low
freezing_spray
sea_ice
blizzard_conditions

------------------------------------------------------------
8. Marine Weather Conditions
------------------------------------------------------------

marine_fog
marine_freezing_spray
rough_seas
high_waves
storm_surge_conditions
water_spout

------------------------------------------------------------
9. Special and Rare Conditions
------------------------------------------------------------

funnel_cloud
volcanic_ash
ash_in_air
dust_storm
smoke_storm

------------------------------------------------------------
10. Normalisation Table Notes
------------------------------------------------------------

Environment Canada condition strings must be mapped into the above keys.
Examples

Mainly Sunny maps to mainly_clear
A Few Clouds maps to partly_cloudy
Periods of Rain maps to rain
Risk of Freezing Rain maps to freezing_rain
Snow at times heavy maps to heavy_snow
Ice Crystals maps to ice_crystals
Local Smoke maps to smoke
Haze maps to haze
Mist maps to mist
Thunderstorms maps to thunderstorm unless severity tag present

A complete mapping list will be implemented in internalweathernormalize.go.

------------------------------------------------------------
11. Colour Theme Notes
------------------------------------------------------------

clear primary sky blue and secondary gold
cloudy light grey to blue-grey
rain slate blue
snow white to light grey
fog mid grey
smoke brown-grey
thunderstorm violet purple accents
arctic cold pale blue and white
marine deep blue

These themes apply to the Skyfeed logo.

END OF FILE