|------|----------------|--------------------|

 | Product docs | Updated | Keep `HealthProbe/Doc/README.md` as canonical index |

 | HealthKit capture | Capture now opens one archive observation per user-visible snapshot, attaches HealthKit pages, deleted-object evidence, and type verification to that observation id before finishing it, no longer aborts initial full-history imports after a fixed 30-minute wall-clock cap while page-level HealthKit timeouts remain in place, defers grouped observation summary/daily aggregate rebuilds until per-type verification instead of rebuilding after every imported page, and persists large HealthKit pages in smaller archive chunks while using type-specific import strategies: conservative paging for the heaviest metrics, more aggressive pages/chunks for ordinary metrics, adaptive write chunk sizing, batched deleted-object persistence, explicit task yields, and lower-allocation streaming loops to avoid long monolithic SQLite stalls | Continue moving UI/cache reads to archive-backed observation ids and revisit full checkpoint/resume and background collection separately |

 | Core Data cache | Initial programmatic Core Data model, full-cache rebuild service, read DTOs for observation/type/diff/health rows, and Dashboard archive-cache status wiring are in place | Move remaining export/report paths to cache DTOs and add targeted partial invalidation |

 | SwiftData cache | Exists; test builds now reset legacy prototype UI/archive/cache stores once for archive v2 so old SwiftData-only snapshots are not treated as backed-up observations. Metric timeout calibration, local device profile settings, operation logging, ContentView preview, Settings data maintenance, legacy detail/PDF views, unused legacy repair/observer services, Dashboard view/view-model access, and legacy anomaly/count-drop review have moved outside SwiftData or been removed. Remaining SwiftData imports are inventoried in [`SwiftData-Retirement-Inventory.md`](SwiftData-Retirement-Inventory.md) | Treat as disposable prototype data; stop returning/storing `HealthSnapshot` bridge handles before removing `ModelContainer` |

 | UI | Prototype exists; Dashboard status reads archive/cache observation rows and shows cache health, and Dashboard view/view-model code no longer imports SwiftData or reads `ModelContext`; capture/review actions now route through DTOs and snapshot ids, with the remaining legacy bridge isolated in `HealthKitService`. Snapshots and Data Types tab roots no longer import SwiftData, load Core Data cached observation rows, and open archive/cache-backed detail rows; `SnapshotArchiveDetailView` and `DataTypeArchiveDetailView` read Core Data type/diff summaries and page record drill-down through SQLite; unused legacy SwiftData snapshot/type detail and PDF views have been deleted; record-change evolution and temporal distribution screens now receive DTO rows/cache input instead of querying SwiftData directly; export preview reads the archive export API before showing/exporting JSON; simplified detail mode replaces heavy charts with summary rows on small/accessibility layouts or when enabled in Settings; visible change labels now use neutral new/missing/change-review language; Settings can now schedule a full test-database reset for the next app launch | Stop writing prototype `HealthSnapshot` bridge rows during capture/review |

         )

         """, db: db)

         try execute("CREATE INDEX IF NOT EXISTS idx_samples_uuid_hash ON samples(sample_uuid_hash)", db: db)

         try execute("CREATE INDEX IF NOT EXISTS idx_samples_type_uuid_hash ON samples(sample_type_id, sample_uuid_hash)", db: db)

         try execute("CREATE INDEX IF NOT EXISTS idx_samples_type_semantic ON samples(sample_type_id, semantic_fingerprint)", db: db)

         try execute("""

             statementCache: statementCache,

             lookupCache: lookupCache

         )

         try insertObservationTypeRun(

             observationID: observationID,

             sampleTypeID: sampleTypeID,

             db: db,

             statementCache: statementCache

         )

         try rebuildDailyAggregates(

             observationID: observationID,

             sampleTypeID: sampleTypeID,

     private func rebuildTypeSummary(observationID: Int64, sampleTypeID: Int64, db: OpaquePointer?) throws {

         let summary = try typeSummary(observationID: observationID, sampleTypeID: sampleTypeID, db: db)

         let aggregateParts: [String?] = [

             String(observationID),

             String(sampleTypeID),

         ]

         let aggregateHash = HashService.archiveContentHash(

             domain: "hp:v2:type_summary",

         ) { statement in

             bindInt64(observationID, to: 1, in: statement)

             bindInt64(sampleTypeID, to: 2, in: statement)

             bindText(aggregateHash, to: 11, in: statement)

             guard sqlite3_step(statement) == SQLITE_DONE else {

                 throw SQLiteHealthArchiveStoreError.stepFailed(lastErrorMessage(db))

             SUM(v.numeric_value),

             MAX(v.numeric_value),

             v.source_revision_id

         JOIN sample_versions v ON v.id = r.version_id

         GROUP BY bucket_start, bucket_end, v.source_revision_id

         ORDER BY bucket_start ASC, v.source_revision_id ASC

         """

     private func visibleAggregate(sampleTypeID: Int64, db: OpaquePointer?) throws -> ArchiveV2VisibleAggregate {

         let sql = """

         SELECT COUNT(*), MIN(v.start_date), MAX(v.end_date), SUM(v.numeric_value), MAX(v.numeric_value)

         JOIN sample_versions v ON v.id = r.version_id

         """

         return try withStatement(sql, db: db) { statement in

             bindInt64(sampleTypeID, to: 1, in: statement)