Add AGENTS.md for Cursor Cloud development environment setup

AGENTS.md

@@ -0,0 +1,40 @@
+# AGENTS.md
+
+## Cursor Cloud specific instructions
+
+### Environment
+
+- **Flutter SDK 3.44.0** (Dart 3.12.0) is installed at `/home/ubuntu/flutter`. PATH is configured in `~/.bashrc`.
+- The project requires Dart SDK `^3.10.0` — do not downgrade to an older Flutter version.
+
+### Key commands
+
+| Task | Command |
+|------|---------|
+| Install deps | `flutter pub get` |
+| Lint / analyze | `flutter analyze` |
+| Format | `dart format .` |
+| Run all tests | `flutter test` |
+| Run subset | `flutter test test/models/` |
+
+See `README.md` and `.github/copilot-instructions.md` for full developer workflow details.
+
+### Secrets
+
+- `lib/secrets.dart` is gitignored and must exist for compilation. It exports `SupabaseConfig.url` and `SupabaseConfig.anonKey`. A placeholder is created during setup; replace with real values to test Supabase-dependent flows.
+
+### Known pre-existing issues
+
+- `solar_icons` 0.0.5 extends `IconData` (a `final` class in newer Dart SDKs) — causes compilation failures in tests that import `main.dart`.
+- `lib/screens/track/track_screen.dart` has syntax errors (unmatched brackets, undefined getters) that also cause compile failures.
+- Several `const` constructor usages in `main.dart` are invalid with the current Dart SDK.
+- These issues together cause ~42 test failures out of ~505 total tests. The remaining ~463 tests pass.
+
+### Running the app
+
+This is a **Flutter mobile app** targeting Android / Wear OS physical devices. There is no web or desktop entrypoint that can be run headlessly in the cloud VM. The meaningful development loop in this environment is:
+
+1. `flutter pub get` — install dependencies
+2. `flutter analyze` — static analysis
+3. `flutter test` — run unit/widget tests
+4. `dart format .` — check formatting

pubspec.lock

@@ -197,10 +197,10 @@ packages:
     dependency: transitive
     description:
       name: characters
-      sha256: f71061c654a3380576a52b451dd5532377954cf9dbd272a78fc8479606670803
+      sha256: faf38497bda5ead2a8c7615f4f7939df04333478bf32e4173fcb06d428b5716b
       url: "https://pub.dev"
     source: hosted
-    version: "1.4.0"
+    version: "1.4.1"
   checked_yaml:
     dependency: transitive
     description:
@@ -884,26 +884,26 @@ packages:
     dependency: transitive
     description:
       name: matcher
-      sha256: dc58c723c3c24bf8d3e2d3ad3f2f9d7bd9cf43ec6feaa64181775e60190153f2
+      sha256: dc0b7dc7651697ea4ff3e69ef44b0407ea32c487a39fff6a4004fa585e901861
       url: "https://pub.dev"
     source: hosted
-    version: "0.12.17"
+    version: "0.12.19"
   material_color_utilities:
     dependency: transitive
     description:
       name: material_color_utilities
-      sha256: f7142bb1154231d7ea5f96bc7bde4bda2a0945d2806bb11670e30b850d56bdec
+      sha256: "9c337007e82b1889149c82ed242ed1cb24a66044e30979c44912381e9be4c48b"
       url: "https://pub.dev"
     source: hosted
-    version: "0.11.1"
+    version: "0.13.0"
   meta:
     dependency: transitive
     description:
       name: meta
-      sha256: "23f08335362185a5ea2ad3a4e597f1375e78bce8a040df5c600c8d3552ef2394"
+      sha256: "1741988757a65eb6b36abe716829688cf01910bbf91c34354ff7ec1c3de2b349"
       url: "https://pub.dev"
     source: hosted
-    version: "1.17.0"
+    version: "1.18.0"
   mgrs_dart:
     dependency: transitive
     description:
@@ -1497,10 +1497,10 @@ packages:
     dependency: transitive
     description:
       name: test_api
-      sha256: ab2726c1a94d3176a45960b6234466ec367179b87dd74f1611adb1f3b5fb9d55
+      sha256: "949a932224383300f01be9221c39180316445ecb8e7547f70a41a35bf421fb9e"
       url: "https://pub.dev"
     source: hosted
-    version: "0.7.7"
+    version: "0.7.11"
   tflite_flutter:
     dependency: "direct main"
     description: