From 8cae666625dd62f5ad50e8d393224cbb17f265e5 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Fri, 22 May 2026 14:56:23 +0000 Subject: [PATCH 1/2] Add AGENTS.md with Cursor Cloud development environment instructions - Document Flutter SDK requirements and PATH configuration - Add key development commands (lint, test, format) - Document secrets.dart setup for Supabase configuration - Note pre-existing codebase issues for future agent awareness Co-authored-by: Mark Siazon --- AGENTS.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..30642b9 --- /dev/null +++ b/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 From f82c237fdae2f967b6339f2bd47a5303e29c7552 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Fri, 22 May 2026 14:57:30 +0000 Subject: [PATCH 2/2] Update pubspec.lock for Dart 3.12.0 SDK compatibility Transitive dependency bumps: characters 1.4.1, matcher 0.12.19, material_color_utilities 0.13.0, meta 1.18.0, test_api 0.7.11 Co-authored-by: Mark Siazon --- pubspec.lock | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/pubspec.lock b/pubspec.lock index 0246760..a583ffd 100644 --- a/pubspec.lock +++ b/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: