feat: complete app overhaul — engines, UI, tests, CI

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+# CI Pipeline for Thump (HeartCoach)
+# Builds iOS and watchOS targets and runs unit tests.
+# Triggered on push to main and on pull requests.
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  DEVELOPER_DIR: /Applications/Xcode_15.2.app/Contents/Developer
+
+jobs:
+  build-and-test:
+    name: Build & Test
+    runs-on: macos-14
+    steps:
+      - uses: actions/checkout@v4
+
+      # ── Cache SPM packages ──────────────────────────────────
+      - name: Cache SPM packages
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/Library/Developer/Xcode/DerivedData/**/SourcePackages
+            ~/.build
+          key: spm-${{ runner.os }}-${{ hashFiles('apps/HeartCoach/Package.swift') }}
+          restore-keys: |
+            spm-${{ runner.os }}-
+
+      # ── Install tools ───────────────────────────────────────
+      - name: Install XcodeGen
+        run: brew install xcodegen
+
+      - name: Generate Xcode Project
+        run: |
+          cd apps/HeartCoach
+          xcodegen generate
+
+      # ── Build iOS ───────────────────────────────────────────
+      - name: Build iOS
+        run: |
+          set -o pipefail
+          cd apps/HeartCoach
+          xcodebuild build \
+            -project Thump.xcodeproj \
+            -scheme Thump \
+            -destination 'platform=iOS Simulator,name=iPhone 15 Pro' \
+            -configuration Debug \
+            CODE_SIGN_IDENTITY="" \
+            CODE_SIGNING_REQUIRED=NO \
+            | xcpretty
+
+      # ── Build watchOS ───────────────────────────────────────
+      - name: Build watchOS
+        run: |
+          set -o pipefail
+          cd apps/HeartCoach
+          xcodebuild build \
+            -project Thump.xcodeproj \
+            -scheme ThumpWatch \
+            -destination 'platform=watchOS Simulator,name=Apple Watch Series 9 (45mm)' \
+            -configuration Debug \
+            CODE_SIGN_IDENTITY="" \
+            CODE_SIGNING_REQUIRED=NO \
+            | xcpretty
+
+      # ── Run unit tests ──────────────────────────────────────
+      - name: Run Tests
+        run: |
+          set -o pipefail
+          cd apps/HeartCoach
+          xcodebuild test \
+            -project Thump.xcodeproj \
+            -scheme Thump \
+            -destination 'platform=iOS Simulator,name=iPhone 15 Pro' \
+            -enableCodeCoverage YES \
+            -resultBundlePath TestResults.xcresult \
+            CODE_SIGN_IDENTITY="" \
+            CODE_SIGNING_REQUIRED=NO \
+            | xcpretty
+
+      # ── Coverage report ─────────────────────────────────────
+      - name: Extract Code Coverage
+        if: success()
+        run: |
+          cd apps/HeartCoach
+          xcrun xccov view --report TestResults.xcresult | head -30 >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Upload Test Results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results
+          path: apps/HeartCoach/TestResults.xcresult
+          retention-days: 7

.gitignore

@@ -29,6 +29,15 @@ Package.resolved
 .ux/
 .project/
 
+# TaskPilot / Orchestrator (internal tooling, not part of the app)
+TaskPilot/
+ORCHESTRATOR_DRIVEN_IMPROVEMENTS.md
+
+# Project docs (local only)
+CLAUDE.md
+PROJECT_HISTORY.md
+TESTING_AND_IMPROVEMENTS.md
+
 # IDE
 .vscode/
 .idea/

apps/HeartCoach/.gitignore

@@ -0,0 +1,30 @@
+# Xcode
+*.xcodeproj/xcuserdata/
+*.xcworkspace/xcuserdata/
+*.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
+DerivedData/
+build/
+*.dSYM.zip
+*.dSYM
+*.moved-aside
+*.hmap
+*.ipa
+*.xcuserstate
+
+# Swift Package Manager
+.build/
+Packages/
+Package.pins
+Package.resolved
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Algorithm TODO & research files (local development only)
+TODO/
+.algo-research/
+
+# Feature requests & redesign specs (internal planning, not shipped)
+FEATURE_REQUESTS.md
+DASHBOARD_REDESIGN.md

apps/HeartCoach/.swiftlint.yml

@@ -0,0 +1,29 @@
+# SwiftLint Configuration for Thump
+
+excluded:
+  - Tests/
+  - .build/
+
+# Pre-existing violations in engine files — will be addressed in
+# a dedicated refactoring pass.
+identifier_name:
+  min_length: 1
+  max_length: 50
+file_length:
+  warning: 700
+  error: 1000
+type_body_length:
+  warning: 500
+  error: 800
+function_body_length:
+  warning: 100
+  error: 200
+function_parameter_count:
+  warning: 7
+  error: 10
+cyclomatic_complexity:
+  warning: 15
+  error: 25
+large_tuple:
+  warning: 4
+  error: 12