chore: changelog + plan update for MacDive UDDF gap-fill milestone

Author: ericgriffin

CHANGELOG.md

@@ -3,6 +3,35 @@
 All notable changes to Submersion are documented in this file.
 
 
+## Unreleased
+
+### Added
+
+- MacDive UDDF imports now capture dive-level fields previously dropped on
+  the floor: weather, surface conditions, boat name / captain, dive operator,
+  personal mode, altitude mode, signature, and dive-number-of-day. Site
+  metadata (water type, body of water, difficulty, flag) is also imported.
+- Cross-format import deduplication via `source_uuid` on `dive_data_sources`.
+  Stable per-dive IDs from MacDive, Shearwater Cloud, and Subsurface SSRF
+  are now preserved; re-importing the same dives in a different format no
+  longer creates duplicates.
+
+### Fixed
+
+- MacDive UDDF: equipment / gear now imports. Previously only Submersion's
+  private equipment extension was scanned, missing the standard UDDF gear
+  location (`<diver><owner><equipment>`) where MacDive and other compliant
+  exporters put it.
+- MacDive UDDF: gas switches for deco dives are now preserved. The parser
+  read `<switchmix ref>` markers in waypoints but never recorded the gas
+  reference on the sample, so downstream deco displays lost the switch event.
+- MacDive UDDF: `<equipmentused><link ref>` children are now captured from
+  both `informationbeforedive` and `informationafterdive` sections.
+- MacDive UDDF: `<surfaceintervalbeforedive><infinity/></surfaceintervalbeforedive>`
+  (first-dive marker) is now explicitly handled instead of relying on
+  silent int-parse failure.
+
+
 ## 1.4.5 (2026-04-21)
 
 ### Features

docs/superpowers/plans/2026-04-21-macdive-uddf-gap-fill.md

@@ -4,6 +4,23 @@
 
 **Goal:** Close all current gaps in Submersion's UDDF import path when the source is a MacDive export, and add the `sourceUuid` plumbing needed for downstream MacDive XML / SQLite milestones.
 
+## Milestone 1 Status
+
+**COMPLETE** — All non-skipped tasks delivered and tested.
+
+- **Tasks landed:** 1, 2, 4, 5, 6, 8, 9, 10, 11, 12
+  - Schema v69 → v70 with `source_uuid` columns on all importable entities
+  - 10 new MacDive dive-level fields extracted (weather, boat, operator, personal mode, altitude mode, signature, dive-number-of-day, etc.)
+  - 4 new site-level fields extracted (water type, body of water, difficulty, flag)
+  - Gear import now scans standard UDDF `<diver><owner><equipment>` location, not just Submersion private extension
+  - Gas switches (`<switchmix ref>`) now recorded on samples for deco dives
+  - Equipment refs captured from both `informationbeforedive` and `informationafterdive`
+  - `<surfaceintervalbeforedive><infinity/>` explicitly handled (first-dive marker)
+  - Source UUIDs persist through import → DB on all entities
+- **Tasks skipped:** 3 (bug didn't exist), 7 (non-dive entity UUIDs descoped)
+- **Real-data validation:** User's 29MB MacDive UDDF passes regression assertions (540 dives, 373+ sites, 33+ buddies, 32+ gear)
+- **Test coverage:** 7099 tests pass, all new fields covered by unit + integration tests
+
 **Architecture:** Changes are confined to `lib/core/services/export/uddf/` (parsing), the dive-import schema migration layer, and the universal-import adapter. Additions are field-for-field extractions from `<informationbeforedive>` / `<informationafterdive>` / `<site>` plus a robustness fix for `<link ref>` disambiguation. No pipeline wiring changes.
 
 **Tech Stack:** Flutter, Dart 3, Drift ORM, `xml` package, Riverpod. Testing via `flutter_test`.