# V9-004 mobile localization foundation

Date: 2026-07-27

## Repository result

Metis Mobile now negotiates English, Spanish, or French from an exact or
language-family device locale and retains an explicit learner override in
AsyncStorage. Every supported dictionary is checked against one TypeScript key
set, so a locale cannot silently omit a covered critical-shell message.
Malformed persisted locale values are ignored.

The initial account, connectivity, sign-in, resume, pending-progress, study,
tutor, and grounded-source chrome responds to the selected locale. A non-English
selection also renders an explicit notice that the sample course prose remains
English until a reviewed translation exists. This avoids presenting localized
navigation as proof that source, lesson, tutor, assessment, media, or
accessibility content has been translated and reviewed.

## Automated verification

- `pnpm --dir apps/metis/mobile test --runInBand`: 6 suites, 39 tests passed.
- `pnpm --dir apps/metis/mobile lint`: passed.
- `pnpm --dir apps/metis/mobile typecheck`: passed.
- `pnpm --dir apps/metis/mobile build`: Expo web export passed with 1,276
  modules.
- The checked-in `localization-expo-go.yaml` parses as YAML and covers
  selection, localized primary action, honest content fallback, application
  restart, and preference restoration.

## Rendered QA and honest boundary

The interactive frontend skill's `js_repl` tool remains unavailable, so a
Playwright Chromium equivalent exercised the exported app at 390×844 light and
320×700 dark viewports. Device negotiation selected Spanish, switching to French
updated the primary shell, and reloading restored French. Both viewports had
zero horizontal overflow; the primary lesson action remained visible at 320×700.
Screenshots were diagnostic and are not release artifacts.

No stable attached Android target was available for the new Maestro flow, so no
native execution is claimed. This increment does not provide reviewed
translations for course prose, sources, generated tutor output, assessments,
captions, audio, embodied instruction, or V2–V8 content. It therefore advances
but does not close the composite localization-at-scale checkbox.
