[DRAFT] Record wave level detection merge after #158

.cursor/rules/project-overview.mdc

@@ -11,7 +11,7 @@ Offline-first **Expo SDK 56** (React Native **0.85**, React **19.2.3**) companio
 
 - Entry: `App.tsx` → `initializeDatabase()` → `syncAllData()` → `AppNavigator`
 - App config: `app.config.ts` (EAS project ID, plugins, package id)
-- Screens: `src/app/tabs/` (`ProjectList`, `ViewProject`, `ViewChapter`)
+- Screens: `src/app/tabs/` (`ProjectList`, `ViewProject`, `drafting/DraftingPage` + `RecordTab`)
 - API: `src/services/api.ts` (`FluentAPI`)
 - Sync: `src/services/sync.ts`
 - DB writes: `src/db/repository.ts` | reads: `src/db/queries.ts`

app.config.ts

@@ -74,6 +74,14 @@ const config: ExpoConfig = {
     ],
     './plugins/withRNScreensFragmentFactory',
     'expo-secure-store',
+    'expo-asset',
+    [
+      'expo-audio',
+      {
+        microphonePermission:
+          'Fluent needs access to your microphone so translators can record verse drafts.',
+      },
+    ],
   ],
 };
 

docs/AGENT_ONBOARDING.md

@@ -32,7 +32,7 @@ Quick map for Cursor agents, other coding tools, and new contributors. Verified
 | Path | Purpose |
 |------|---------|
 | [`App.tsx`](../App.tsx) | Root: DB init + initial `syncAllData`, then navigator |
-| [`src/app/tabs/`](../src/app/tabs/) | Screens: `ProjectList`, `ViewProject`, `ViewChapter` |
+| [`src/app/tabs/`](../src/app/tabs/) | Screens: `ProjectList`, `ViewProject`, `drafting/DraftingPage` (parent shell stub for #47) with `RecordTab` (#49) |
 | [`src/navigation/`](../src/navigation/) | Stack navigator |
 | [`src/services/api.ts`](../src/services/api.ts) | HTTP client (`FluentAPI`) — see [api-client-standard.md](guides/api-client-standard.md) |
 | [`src/services/sync.ts`](../src/services/sync.ts) | Sync orchestration, retries, KV counts |
@@ -209,7 +209,9 @@ When adding features: mock `op-sqlite`, navigation, and sync in screen tests fol
 - [x] Dependabot reviewers: `eten-tech-foundation/fluent-admin`
 - [x] Mock or gate `fluent-api.test.ts` for offline CI
 - [ ] Align `format:check` glob with `format` or document intentionally narrow check
-- [ ] Wire `recordings` table to actual audio capture/upload
+- [x] Wire `recordings` table to actual audio capture (issue #49 — upload still pending)
+- [ ] Upload/sync draft recordings to the Fluent server (`sync_status='pending'` rows)
+- [ ] Replace parent drafting shell stub with full #47 implementation (chapter audio player, tab persistence)
 
 ## Related docs
 

docs/guides/waveform-decision.md

@@ -0,0 +1,29 @@
+# Waveform decision
+
+How the record/review waveform is rendered in Fluent Mobile, and why. Refs GitHub [#96](https://github.com/eten-tech-foundation/fluent-mobile/issues/96).
+
+## Decision
+
+Render the waveform in React from `expo-audio` data. **Do not** add a third-party waveform native module.
+
+- **Rejected:** [`@simform_solutions/react-native-audio-waveform`](https://github.com/SimformSolutionsPvtLtd/react-native-audio-waveform) (see [PR #82](https://github.com/eten-tech-foundation/fluent-mobile/pull/82)) — a bare-RN native module that complicates CNG prebuild / EAS builds and couples playback to a widget via imperative refs. Disproportionate for a level/progress visualization.
+- Any future third-party waveform must be Expo config-plugin compatible.
+
+## Approach
+
+| State | Source | Component |
+| ----- | ------ | --------- |
+| Live recording | `expo-audio` recorder **metering** (`isMeteringEnabled`), sampled on the recorder tick and normalized to `0..1` | `RecordingWaveform` (recording/paused) |
+| Review playback | position-driven progress fill from `positionMs` / `durationMs` | `RecordingWaveform` (review) — delivered in [#176](https://github.com/eten-tech-foundation/fluent-mobile/issues/176) |
+
+This is a **component + hook** change, not a native module — unlike the seekable-remux work in #176, waveform rendering needs no platform APIs.
+
+## Where it lives
+
+- `src/hooks/useRecorder.ts` — `dbfsToLevel()` (dBFS -> `0..1`, floor `-60 dB`); enables `isMeteringEnabled` and samples `recorder.getStatus().metering` on the tick into a bounded `meteringLevels` buffer (newest last, reset on new take, frozen on pause).
+- `src/app/tabs/drafting/record/components/RecordingWaveform.tsx` — renders live bars from the `levels` prop.
+
+## Notes
+
+- The live buffer length matches the bar count (`METERING_SAMPLE_CAP` = `LIVE_WAVEFORM_BARS`), so one sample maps to one bar and the row scrolls right as audio comes in.
+- Metering is a single level per poll (not a full amplitude array); bars visualize input loudness over time, not an offline sample-accurate waveform.