Refactor Places integration internals

[Snuffy2]

Summary

Refactors the Places integration internals into focused helper modules while preserving the existing entity behavior. The change separates attribute storage, tracker snapshots, location math, OSM requests, config schemas, and update orchestration so the main sensor/updater code is easier to reason about and test.

What Changed

• Added PlacesAttributes as the mutable attribute store and delegated sensor attribute helpers through it.
• Added tracker and location primitives for coordinate validation, distance calculations, direction-of-travel classification, and GPS metadata handling.
• Added an OSMClient for URL construction, throttled/cached JSON fetches, non-2xx response handling, service-error detection, and stale-cache cleanup.
• Added PlacesUpdatePipeline to keep update phase ordering explicit, including rollback/finalization behavior when a phase fails.
• Extracted config-flow schema construction and display-option helper logic into smaller modules.
• Updated OSM parsing to prefer explicit payloads over stale sensor attributes.
• Added architecture design/implementation docs under docs/superpowers/.

Reviewer Notes

• The intent is structural cleanup, not a feature rewrite. Existing behavior is covered by characterization tests where the refactor moved logic behind new helper classes.
• Tracker state objects with unknown/unavailable states still proceed when valid coordinates are present; this preserves the current characterized behavior.
• OSM request handling now avoids caching error responses and keeps list/mapping cache semantics explicit.

Validation

• ./.venv/bin/python -m pytest (411 passed)
• ./.venv/bin/python -m prek run -a

[github-actions]

Coverage report

Click to see where and how coverage changed

File	Statements	Missing	Coverage	Coverage (new stmts)	Lines missing
custom_components/places
advanced_options.py
attributes.py
basic_options.py
config_flow.py
config_schema.py
location.py					55, 62, 69, 86
osm_client.py					122, 193
parse_osm.py					69, 73-76
pipeline.py					60-64
sensor.py					453
tracker.py
update_sensor.py					897
Project Total

This report was generated by python-coverage-comment-action