# SolarSphere Offline-First MVP

Overview
- A Python-based MVP for offline-first geospatial visualization and telemetry replay. Focuses on simple, well-defined data contracts and deterministic delta reconciliation that can run entirely offline with optional data-sync when connectivity returns.

What’s included
- Core data primitives: Asset, TelemetryPoint, WeatherLayer, Event
- CSV-based telemetry adapter for MVP data ingestion
- Delta reconciliation utilities for deterministic merges
- Lightweight render summary producing JSON suitable for downstream tooling
- Minimal CLI and a test suite to validate core behavior

Getting started
- Install dependencies and run tests: `bash test.sh`
- Package: `python3 -m build` (also in test script)

Project structure (high level)
- src/idea78_solarsphere_offline_first/: Python package with core models, adapters, delta logic, and rendering helpers
- tests/: Unit tests for models, delta logic, and adapters
- AGENTS.md: Architecture and contribution guidance
- test.sh: Test runner that executes tests and packaging checks

Usage example (quick)
- Load a CSV telemetry file via CSVAdapter, reconcile with a local delta, and render a snapshot:
  - adapter = CSVAdapter("telemetry.csv")
  - telem = adapter.load_telemetry()
  - snapshot = render.render_snapshot([asset], telem, weather, events)
  - print(snapshot)

This repository adheres to the contribution guidelines described in AGENTS.md and is designed to be extended in sprint fashion.