tagradar

Imported from sebdanielsson/tagradar (AGENTS.md). Install upstream with npx skills add sebdanielsson/tagradar. Copyright stays with the author.

Tågradar — repo notes for AI assistants

• Native SwiftUI app, iOS 26.5+ built with the iOS 27 SDK (Xcode 27), Swift 6 strict concurrency. No third-party packages. Only Trafikverket's open data as data sources: the live Open API, plus NJDB track geometry bundled offline as Tagradar/Resources/RailNetwork.json (see docs/rail-network.md).
• The Xcode project is generated: edit project.yml, then run xcodegen (or Scripts/bootstrap.sh). Never commit Tagradar.xcodeproj.
• API key: .env.local → Scripts/bootstrap.sh → Config/Secrets.xcconfig → Info.plist key TRVAPIKey. Users can override in Settings (Keychain). Never commit keys.
• Packages/TrafikverketKit is platform-agnostic and testable with swift test. App-level logic tests live in TagradarTests.
• TagradarWidgets is the WidgetKit extension (widgets + Live Activity UI). It compiles its own copy of the shared files listed in project.yml (Tagradar/Models, TrainService, Formatters, SharedStorage, …); keep those free of app-only dependencies. App and extension share data through the App Group group.se.tagradar.app (SwiftData store, station cache, alert state).
• Notifications are local only (no push server): TrainMonitor refreshes saved/followed trains every 30 s in the foreground and via BGAppRefreshTask in the background, then feeds TrainAlerts (rules in TrainAlertEngine), LiveActivityController and WidgetCenter. A saved train's optional TripSegment (boarding/alighting) is applied in TrainSnapshot, so all consumers see segment-relative delays. ActivityBackgroundRefresher keeps Live Activities fresh in the background by chaining background URLSession uploads with earliestBeginDate (60 s en route); each completion wakes the app via AppDelegate.application(_:handleEventsForBackgroundURLSession:).
• User-facing strings are English source keys in Tagradar/Resources/Localizable.xcstrings with Swedish translations. Code, comments and commits are in English.
• Build: xcodebuild -project Tagradar.xcodeproj -scheme Tagradar -destination 'platform=iOS Simulator,name=iPhone 17 Pro' build.
• App icon: Tagradar/AppIcon.icon (Icon Composer package, layers rendered by Scripts/make-app-icon.swift). Never use SF Symbols in the icon (licence). Preview appearances with the ictool inside Icon Composer.app (see docs/app-store.md).
• Commits and PR titles follow Conventional Commits (feat:, fix:, docs:, chore:, ci:…); release-please turns them into versions and CHANGELOG.md. version.txt and MARKETING_VERSION in project.yml are bumped by the release PR only. CI/CD lives in one workflow (.github/workflows/ci.yml): verify → TestFlight on main, release PR, App Store submission on release (see docs/release.md). Code scanning is CodeQL advanced setup in .github/workflows/codeql.yml — Swift needs a real xcodebuild run, so default setup's autobuild cannot analyse this repo (the Xcode project is generated).
• Bundle identifier: se.tagradar.app for CI and releases (Jesper's team). Sebastian's personal team cannot register it, so .env.local sets APP_BUNDLE_ID=se.sebastiandanielsson.tagradar; project.yml derives every identifier from $(APP_BUNDLE_ID:default=se.tagradar.app) and the code reads the App Group, Keychain group and background task ID from Info.plist. Never hard-code identifiers in Swift.