initial commit

CLAUDE.md

@@ -0,0 +1,167 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is an Android application project using Gradle with Kotlin DSL. The project uses modern Android development practices with AndroidX libraries and targets Android 12+ (minSdk 32).
+
+## Build Commands
+
+```bash
+# Clean build artifacts
+./gradlew clean
+
+# Build debug APK
+./gradlew assembleDebug
+
+# Build release APK
+./gradlew assembleRelease
+
+# Run unit tests
+./gradlew test
+
+# Run instrumented tests (requires connected device/emulator)
+./gradlew connectedAndroidTest
+
+# Run all tests
+./gradlew test connectedAndroidTest
+
+# Check for lint issues
+./gradlew lint
+
+# Install debug APK on connected device
+./gradlew installDebug
+
+# Run a specific test class
+./gradlew test --tests "com.mattintech.androidtestapp.ExampleUnitTest"
+
+# Run tests with additional output
+./gradlew test --info
+```
+
+## Project Structure
+
+- **App Module**: `app/` - Main application module
+  - Source code: `app/src/main/java/com/mattintech/androidtestapp/`
+  - Unit tests: `app/src/test/java/com/mattintech/androidtestapp/`
+  - Instrumented tests: `app/src/androidTest/java/com/mattintech/androidtestapp/`
+  - Resources: `app/src/main/res/`
+  - Manifest: `app/src/main/AndroidManifest.xml`
+
+- **Gradle Configuration**:
+  - Project-level: `build.gradle.kts`
+  - App-level: `app/build.gradle.kts`
+  - Version catalog: `gradle/libs.versions.toml`
+  - Gradle wrapper: `gradle/wrapper/` (Gradle 8.11.1)
+
+## Key Configuration
+
+- **Package name**: `com.mattintech.androidtestapp`
+- **Application ID**: `com.mattintech.androidtestapp`
+- **Target SDK**: 35 (Android 15)
+- **Min SDK**: 32 (Android 12)
+- **Compile SDK**: 35
+- **Test runner**: `androidx.test.runner.AndroidJUnitRunner`
+
+## Development Notes
+
+This is currently a minimal Android project template. When developing:
+
+1. The project uses Gradle Version Catalog (`libs.versions.toml`) for dependency management
+2. All build configuration uses Kotlin DSL (`.kts` files)
+3. The project is set up for both unit tests (JUnit) and instrumented tests (Espresso)
+4. No custom lint rules are configured - default Android lint rules apply
+
+## App Features
+
+This is a demo app for testing device stress scenarios with three main features:
+
+### 1. Battery Draining Feature
+Tests battery consumption through various hardware components:
+
+**User-configurable options:**
+- Test duration (minutes/hours)
+- CPU intensive operations (mathematical calculations, loops)
+- Screen (maximum brightness, prevent sleep)
+- Flashlight (continuous or strobe)
+- GPS (high accuracy location updates)
+- BLE scanning (continuous discovery)
+- WiFi scanning
+- Network activity (continuous data transfers)
+- Sensors (accelerometer, gyroscope, magnetometer - continuous reading)
+- Camera (preview without recording)
+- Audio (silent playback to keep audio subsystem active)
+- Vibration (continuous patterns)
+
+**Presets:**
+- "Maximum Drain" - All features enabled
+- "CPU & GPU Focus" - CPU calculations + screen brightness
+- "Radio Focus" - GPS + BLE + WiFi scanning
+- "Sensor Focus" - All sensors + vibration
+
+### 2. Bad Behavior Feature
+Intentionally causes app crashes and ANRs for testing:
+
+**Crash types (user-selectable):**
+- Division by zero
+- Null pointer exception
+- Out of memory error
+- Stack overflow
+- Array index out of bounds
+
+**ANR triggers (user-selectable):**
+- UI thread blocking (long-running operation on main thread)
+- Broadcast receiver timeout
+- Service timeout
+
+**Settings:**
+- Frequency: Manual trigger or random intervals (configurable)
+- Auto-restart: App automatically restarts after crash
+
+### 3. Downloader Feature
+Schedules and executes file downloads:
+
+**User-configurable options:**
+- Download URL (with default test URLs)
+- File size options (1MB, 10MB, 100MB, custom)
+- Schedule type:
+  - One-time download
+  - Repeat every X minutes/hours
+  - Specific times of day
+- Network preference (WiFi only, cellular only, any)
+- Storage behavior (save or discard after download)
+- Background downloads (continue when app in background)
+- Concurrent downloads (1-10 simultaneous)
+
+**UI shows:**
+- Download progress
+- Download history
+- Total data downloaded
+
+## Architecture
+
+- **MainActivity**: Launch screen with buttons to three feature activities
+- **BatteryDrainActivity**: Configure and run battery drain tests
+- **BadBehaviorActivity**: Configure and trigger crashes/ANRs
+- **DownloaderActivity**: Configure and manage downloads
+- **Services**: Background services for battery drain and downloads
+- **Permissions**: Auto-request all required permissions on app launch
+
+## Required Permissions
+
+The app will need these permissions (auto-requested on launch):
+- CAMERA
+- ACCESS_FINE_LOCATION
+- ACCESS_COARSE_LOCATION
+- BLUETOOTH_SCAN
+- BLUETOOTH_CONNECT
+- FLASHLIGHT
+- VIBRATE
+- INTERNET
+- ACCESS_NETWORK_STATE
+- ACCESS_WIFI_STATE
+- WAKE_LOCK
+- FOREGROUND_SERVICE
+- WRITE_EXTERNAL_STORAGE (for downloads)
+- HIGH_SAMPLING_RATE_SENSORS