chore: changelog and plan update for M1 completion

Author: ericgriffin

CHANGELOG.md

@@ -3,6 +3,38 @@
 All notable changes to Submersion are documented in this file.
 
 
+## Unreleased
+
+### Added
+
+- MacDive UDDF imports now capture substantially richer dive data: boat
+  name and captain, dive operator, surface conditions, weather (stored
+  in the existing weather description field), plus site water type, body
+  of water, and difficulty rating.
+- Cross-format import deduplication: stable per-dive UUIDs from MacDive,
+  Shearwater Cloud, Subsurface SSRF, and generic UDDF are now preserved on
+  the `dive_data_sources` sidecar. Re-importing the same dives in a
+  different format no longer creates duplicates.
+
+### Fixed
+
+- MacDive UDDF: equipment / gear now imports correctly. The parser
+  previously only scanned Submersion's private equipment extension,
+  missing the standard UDDF gear location (`<diver><owner><equipment>`)
+  where MacDive and other compliant exporters place their inventory.
+- MacDive UDDF: `<equipmentused><link ref>` is now captured from both
+  `<informationbeforedive>` and `<informationafterdive>`.
+- MacDive UDDF: `<surfaceintervalbeforedive><infinity/></…>` is now
+  explicitly handled as "no prior dive" rather than relying on silent
+  int-parse failure.
+
+### Known limitations (to be addressed in a follow-up)
+
+- Gas switch markers (`<switchmix ref>`) in MacDive dive profiles are
+  parsed but not yet persisted to the profile samples table. A future
+  milestone will wire them through, likely via the dive-events table.
+
+
 ## 1.4.6 (2026-04-22)
 
 ### Bug Fixes

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

@@ -12,6 +12,27 @@
 
 ---
 
+## Milestone 1 Status — COMPLETE
+
+- All 12 tasks landed or explicitly skipped (Task 3 proven non-bug; see Task 3 section).
+- Schema bumped v69 → v70 (source_uuid on dive_data_sources) → v71
+  (7 new dive + site metadata columns: dive_number_of_day, boat_name,
+  boat_captain, dive_operator, surface_conditions on dives; water_type,
+  body_of_water on dive_sites).
+- Cross-format import dedup now works via `dive_data_sources.source_uuid`.
+- Parser-to-DB gap closed for MacDive rich fields. `weather` now lands
+  on the existing weather_description column. difficulty continues to
+  flow through the DiveSite entity path.
+- Dropped from scope: personalMode, altitudeMode, signature, site flag
+  (niche / redundant). LinkRefKind/LinkRefIndex (Task 2) also removed
+  after Task 3 investigation showed the bug they targeted didn't exist.
+- Known limitation: profile `gasMixRef` (from `<switchmix ref>`) is
+  parsed but not yet persisted to the profile samples table — deferred
+  to a future milestone, likely via dive-events.
+- Real-sample regression test passes (gated behind `@Tags(['real-data'])`).
+
+---
+
 ## File Structure
 
 | File | Role | New / Modified |