[feature/alarm-core] Implement core alarm system

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

AGENTS.md

@@ -26,6 +26,7 @@ Always read the relevant `docs/` section before implementing a subsystem; the do
 - **Navigation:** `expo-router` (file-based). Route groups `app/(main)/` and `app/(alarm)/`, each with `_layout.tsx`.
 - **State:** Zustand (+ immer). One shared `alarmStore`, plus per-screen `homeStore` / `createAlarmStore` mirroring the Kotlin `ViewModel`/`StateFlow` contracts.
 - **Persistence:** `expo-sqlite` via Drizzle ORM (`drizzle-orm/expo-sqlite`); drizzle-kit migrations in `drizzle/` — after editing `src/data/schema.ts` run `npm run db:generate` and include the generated artifacts when committing the schema change is requested. Store `days` as **JSON** (Drizzle `json` column mode), never CSV. `babel.config.js` exists only for `babel-plugin-inline-import` (`.sql` inlining for Drizzle migrations) and `metro.config.js` adds `sql` to `sourceExts`; do not re-add decorator plugins.
+- **Native module build:** Run `npm run build:native` (`scripts/build-native-module.js`) to compile the custom `alarm-scheduler` Expo module at `native/`. Accepts an optional platform argument (`android`, `ios`, or `all` — default `all`). The script first runs `expo prebuild --platform <p> --no-install` if the native project directories (`android/`, `ios/`) don't exist. For **Android**, it invokes `./gradlew :expo.modules.alarmscheduler:assembleRelease` in the generated `android/` directory, compiling only the alarm-scheduler library (not the full app). For **iOS**, it runs `pod install` in the generated `ios/` directory to build the CocoaPods-based module. Run this after making changes to any file under `native/android/` (Kotlin sources, `build.gradle`, `AndroidManifest.xml`) or `native/ios/` (Swift sources, `AlarmScheduler.podspec`) to verify the module compiles before a full `expo run:android`/`expo run:ios`. The `native/` module is auto-linked via `expo.autolinking.nativeModulesDir: "./native"` in `package.json` and its config plugin (`native/app.plugin.js`) is registered in `app.json`.
 - **Alarm scheduling:** custom Expo native module for exact, wake-up, recurring alarms (iOS has no exact alarms — degraded UX is expected and must be documented). Complement with `expo-notifications` + `expo-task-manager`.
 - **Sound:** `expo-audio` (or `expo-av`) looping on the alarm audio category; override silent/DND where the platform allows. Keep playback alive in the background while ringing.
 - **Audio picking:** `expo-document-picker` + `expo-file-system` copy to sandbox (fixes the persisted-URI bug from doc 06 §2.3).

app.json

@@ -45,7 +45,9 @@
           ]
         }
       ],
-      "expo-sqlite"
+      "expo-sqlite",
+      "expo-notifications",
+      "./native/app.plugin.js"
     ],
     "experiments": {
       "typedRoutes": true,

drizzle/0001_equal_jetstream.sql

@@ -0,0 +1,10 @@
+CREATE TABLE `scheduled_alarms` (
+	`id` text PRIMARY KEY NOT NULL,
+	`alarm_id` text NOT NULL,
+	`weekday` integer,
+	`type` text NOT NULL,
+	`trigger_at` integer NOT NULL,
+	`payload` text NOT NULL,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL
+);

drizzle/0002_bent_zemo.sql

@@ -0,0 +1,6 @@
+CREATE TABLE `active_alarm` (
+	`id` text PRIMARY KEY NOT NULL,
+	`payload` text NOT NULL,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL
+);

drizzle/0003_misty_moon.sql

@@ -0,0 +1,15 @@
+CREATE TABLE `alarm_registrations` (
+  `alarm_id` text NOT NULL,
+  `type` text NOT NULL,
+  PRIMARY KEY (`alarm_id`, `type`)
+);
+
+INSERT INTO `alarm_registrations` (`alarm_id`, `type`)
+  SELECT DISTINCT `alarm_id`, 'weekly' FROM `scheduled_alarms`
+  WHERE `type` = 'weekly';
+
+INSERT INTO `alarm_registrations` (`alarm_id`, `type`)
+  SELECT DISTINCT `alarm_id`, 'snooze' FROM `scheduled_alarms`
+  WHERE `type` = 'snooze';
+
+DROP TABLE `scheduled_alarms`;

drizzle/meta/0001_snapshot.json

@@ -0,0 +1,178 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "a6f8aeec-c7aa-4dd2-be62-bda2fce7860d",
+  "prevId": "4b78312f-618e-4fa6-82ef-683351061594",
+  "tables": {
+    "alarms": {
+      "name": "alarms",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "days": {
+          "name": "days",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "hour": {
+          "name": "hour",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "minute": {
+          "name": "minute",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "task": {
+          "name": "task",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "rounds": {
+          "name": "rounds",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "difficulty": {
+          "name": "difficulty",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "sound": {
+          "name": "sound",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "is_snooze": {
+          "name": "is_snooze",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_enabled": {
+          "name": "is_enabled",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "scheduled_alarms": {
+      "name": "scheduled_alarms",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "alarm_id": {
+          "name": "alarm_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "weekday": {
+          "name": "weekday",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "type": {
+          "name": "type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "trigger_at": {
+          "name": "trigger_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "payload": {
+          "name": "payload",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}