fix: support upgrading apps from CAMS 1.x to 2.x

[Zeroupper]

Problem

Apps upgrading from CAMS 1.x to 2.x hit three independent blockers:

1. Deserialization. Protocols and deployments created with CAMS 1.x (protocol API level < 2.0) can no longer be deserialized after the device type rename from dk.cachet.carp.common.application.devices.* to dk.carp.cams.devices.*. Old JSON throws a SerializationException and the protocol fails to load entirely.
2. SQLite schema. Both 1.x and 2.x open carp.db with database version 1, but 2.x renamed the deployment table to studies and added a device_role_name column to task_queue. Since the version never changed, neither onCreate nor any upgrade hook runs on a device with an existing 1.x database — every study save fails with no such table: studies and every task save throws an unhandled no such column: device_role_name exception.
3. Stored 1.x deployments. Deployment JSON cached on the phone by 1.x omits the deployed timestamp (it was nullable) and uses the 1.x StudyStatus enum names, both of which made SmartphoneDeployment.fromJson throw even with the type aliases in place.

Changes

Deserialization

• Register the 1.x device type names as fromJson aliases for the 2.x classes — Smartphone, BLEHeartRateDevice, SmartphoneDeviceRegistration, and the devices in the context, health, polar, movesense, esense, and movisens packages.
• Tolerate missing BLE scan fields (serviceUuids, allowDuplicates) when deserializing BLEDevice configurations, which 1.x JSON does not contain.
• Restore the 1.x stepcount measure type and probe, removed in 2.x in favor of stepevent.
• SmartphoneDeployment.fromJson now defaults deployed to now when missing and maps the eleven 1.x StudyStatus names onto StudyDeploymentStatusTypes (e.g. Deployed → Running, deployment-in-progress states → DeployingDevices).

Database migration

• Bump PersistenceService to database version 2 and add an onUpgrade migration which:
  • creates the studies table,
  • adds the device_role_name column to task_queue and backfills it from the saved task snapshots,
  • copies the mappable columns (ids, roles, timestamps, deployment JSON) from the 1.x deployment table into studies and drops the old table. The 1.x deployment_status column (an enum index) has no 2.x equivalent and is not migrated.
• The migration inspects the actual schema before changing it, so a database created by 2.x at version 1 passes through unchanged.

Runtime

• SmartphoneStudyController now reassigns connectedDeviceRegistrations instead of mutating it in place — the map may be the unmodifiable const {} default when no registrations were deserialized from a 1.x deployment.

Testing

• New api_level_1_compatibility_test.dart in carp_mobile_sensing and the context/polar/movesense packages, deserializing real 1.x JSON.
• New persistence_service_migration_test.dart which builds a real 1.x database (old schema, a genuine 1.x deployment JSON fixture, a queued task) and verifies that initializing the PersistenceService migrates it: studies and tasks load, the role name is backfilled, and the old table is dropped. Runs on sqflite_common_ffi (new dev dependency).
• All new and existing suites pass.

[bardram]

This looks very good, incl. the tests.

[bardram]

Note, however, that you did not touch the

• carp_apps_package
• carp_audio_package
• carp_communication_package
• carp_connectivity_package
• carp_survey_package

packages.

Are these not affected?

[Zeroupper]

Note, however, that you did not touch the

• carp_apps_package
• carp_audio_package
• carp_communication_package
• carp_connectivity_package
• carp_survey_package

packages.

Are these not affected?

That was my first intuition as well. We have two namespaces, one for the device namespace and one for data types. The 1.x break was specifically the device-namespace rename (dk.cachet.carp.common.application.devices.* → dk.carp.cams.devices.*) plus the removed stepcount type. None of apps/audio/communication/connectivity/survey define a device or service configuration, they all sample on the Smartphone primary device