Mobile Progress

Last updated: 2026-05-04

This file is the resumable working log for Tolaria mobile. The strategy and roadmap live in MOBILE_STRATEGY.md; this file records the current execution state.

Current State

Branch: codex/mobile
Active phase: Phase 2 - Mobile Shell
Active slice: Add mobile editor adapter boundary for TenTap
Push policy: commit locally; do not push unless explicitly requested
Validation target: iPad/iOS simulator first

Completed

Created high-fidelity iPhone mobile mockups in design/mobile-mockups/.
Documented the production mobile strategy in docs/MOBILE_STRATEGY.md.
Installed and authenticated Codacy MCP for this Codex environment.
Confirmed Codacy MCP can access refactoringhq/tolaria.
Recorded GitHub OAuth App as the first mobile GitHub auth path.
Created ADR-0109 for Expo React Native production mobile.
Superseded ADR-0005, the earlier Tauri iOS prototype ADR.
Created @tolaria/markdown as the first shared workspace package.
Moved compactMarkdown into packages/markdown and kept the existing desktop import path as a compatibility export.
Added package-local Vitest and TypeScript scripts for the shared Markdown package.
Added scripts/run-tests.mjs so pnpm test runs desktop and shared-package tests, while targeted test arguments remain targeted.
Updated the pre-commit branch guard to allow local commits on codex/mobile for this isolated mobile worktree.
Split src/utils/wikilinks.ts into shared @tolaria/markdown modules for frontmatter, wikilink block transforms, outgoing links, backlink context, snippets, and word counts.
Moved note-title derivation helpers into @tolaria/markdown, leaving the existing desktop import path as a compatibility export.
Added apps/mobile as an Expo React Native workspace package.
Added root mobile scripts: mobile:start, mobile:ios, mobile:test, and mobile:typecheck.
Configured Expo for a universal light-mode app with a development bundle identifier (com.tolaria.mobile.dev) and iPad support enabled.
Added the first iPad-first/phone-ready shell using fixture notes, shared Markdown title/snippet helpers, Phosphor React Native icons, and responsive panels for sidebar, note list, editor, and properties.
Split mobile styles into small panel-specific StyleSheet modules so new mobile code starts at CodeScene 10.0.
Pinned Expo runtime dependencies to the versions expected by Expo 55 after the initial generated versions failed iOS bundle export (react-native@0.83.6, react@19.2.0, matching safe-area/svg versions).
Extracted compact phone navigation into a pure tested state machine so future swipe gestures can dispatch explicit events instead of mutating panels ad hoc.
Extracted mobile note projection into a pure module that turns raw vault-like note records into the list/editor shape used by the mobile shell.
Added a minimal mobile vault repository contract plus fixture implementation so app-local vault storage and git sync can plug in behind listNotes / readNote later.
Updated scripts/run-tests.mjs so full pnpm test runs desktop, mobile, and shared package tests, while targeted apps/mobile/... and packages/markdown/... paths route to the correct workspace Vitest config.
Updated .husky/pre-commit to use pnpm test -- --silent so local commits include the new mobile test suite.
Added react-native-gesture-handler at Expo's SDK-compatible version.
Wrapped the mobile root in GestureHandlerRootView.
Added a tested compact gesture mapper and SwipeSurface wrapper so phone panels can transition through swipe gestures while keeping panel behavior in the reducer.
Re-tested the iPad simulator path; the app now launches in Expo Go on iPad Pro 13-inch (M4).
Added a pure mobile Git remote parser that codifies the auth choice: GitHub remotes use the GitHub OAuth App path, arbitrary Git remotes use the SSH-key path.
Added a pure mobile vault configuration model that keeps vault storage app-local, distinguishes local-only vs remote-backed sync, and derives the required Git auth path from the parsed remote.
Extracted the mobile editor surface behind MobileEditorAdapter with a tested document projection so TenTap can replace the placeholder surface without changing shell navigation.

Next Action

Continue Phase 2 with the next mobile shell slice:

Dismiss or suppress Expo Go's first-run tools modal during simulator QA so screenshots capture the app without the overlay.
Install and spike TenTap behind MobileEditorAdapter, keeping the adapter contract intact.
Add the first native storage adapter around the vault config/repository contracts after the editor spike confirms the app shape.

Verification Log

tool_search exposed Codacy MCP tools after Codex restart.
codacy_get_repository_with_analysis succeeded for refactoringhq/tolaria.
Current branch verified as codex/mobile.
CodeScene before extraction: src/utils/compact-markdown.ts scored 10.
CodeScene after extraction: packages/markdown/src/compactMarkdown.ts scored 10; packages/markdown/src/compactMarkdown.test.ts scored 10; tiny export/config files returned no scorable code and no findings.
pnpm --filter @tolaria/markdown test passed: 29 tests.
pnpm --filter @tolaria/markdown typecheck passed.
pnpm test -- src/utils/compact-markdown.test.ts passed and ran only that desktop test file: 29 tests.
pnpm test passed and ran the full desktop suite plus package tests: 309 desktop test files / 3639 desktop tests, then 29 package tests.
pnpm lint passed with one pre-existing warning in src/components/tolariaBlockNoteSideMenu.tsx.
npx tsc --noEmit passed.
pnpm build passed.
CodeScene before wikilink extraction: src/utils/wikilinks.ts scored 9.09.
CodeScene after wikilink extraction: new shared wikilink/frontmatter/content files scored 10; small export surfaces returned no scorable code and no findings.
pnpm --filter @tolaria/markdown test passed after wikilink extraction: 40 tests.
pnpm test -- src/utils/wikilinks.test.ts src/utils/noteTitle.test.ts passed: 91 desktop tests.
pnpm --filter @tolaria/markdown typecheck passed after wikilink extraction.
pnpm lint, npx tsc --noEmit, and pnpm build passed after wikilink extraction.
CodeScene before note-title extraction: src/utils/noteTitle.ts scored 9.68.
CodeScene after note-title extraction: packages/markdown/src/noteTitle.ts and packages/markdown/src/noteTitle.test.ts scored 10; the desktop compatibility export returned no scorable code and no findings.
pnpm --filter @tolaria/markdown test passed after note-title extraction: 56 tests.
pnpm test -- src/utils/noteTitle.test.ts passed: 14 desktop tests.
pnpm --filter @tolaria/markdown typecheck passed after note-title extraction.
pnpm --filter @tolaria/mobile typecheck passed.
pnpm --filter @tolaria/mobile test passed: 1 file / 2 tests.
pnpm --filter @tolaria/mobile exec expo install --check passed after pinning Expo-compatible dependency versions.
pnpm --filter @tolaria/mobile exec expo config --type public passed and shows iOS bundle identifier com.tolaria.mobile.dev, Android package com.tolaria.mobile.dev, and supportsTablet: true.
pnpm --filter @tolaria/mobile exec expo export --platform ios --output-dir /tmp/tolaria-mobile-export passed and produced the iOS bundle.
pnpm lint passed with one pre-existing warning in src/components/tolariaBlockNoteSideMenu.tsx.
npx tsc --noEmit passed.
pnpm test passed after the mobile scaffold: 309 desktop test files / 3639 desktop tests plus 56 shared package tests.
CodeScene mobile shell scores: apps/mobile/App.tsx, apps/mobile/src/MobileApp.tsx, apps/mobile/src/NamedIcon.tsx, apps/mobile/src/demoData.ts, apps/mobile/src/demoData.test.ts, and all scorable style modules scored 10; tiny config/export/theme files returned no scorable code.
CodeScene pre-commit safeguard passed for the current change set.
Codacy MCP can read repository analysis and security items for refactoringhq/tolaria; local Codacy CLI analysis is currently blocked because the Codacy CLI binary is not installed in this environment.
iOS simulator validation was initially blocked locally: Xcode is installed (Xcode 26.3), but xcrun simctl list ... hung indefinitely even after opening /Applications/Xcode.app/Contents/Developer/Applications/Simulator.app.
pnpm --filter @tolaria/mobile test passed after compact navigation extraction: 2 files / 6 tests.
pnpm --filter @tolaria/mobile typecheck passed after compact navigation extraction.
CodeScene after compact navigation extraction: apps/mobile/src/compactNavigation.ts, apps/mobile/src/compactNavigation.test.ts, and the touched apps/mobile/src/MobileApp.tsx scored 10.
pnpm --filter @tolaria/mobile exec expo export --platform ios --output-dir /tmp/tolaria-mobile-export passed after compact navigation extraction.
pnpm --filter @tolaria/mobile test passed after note projection extraction: 3 files / 8 tests.
pnpm --filter @tolaria/mobile typecheck passed after note projection extraction.
CodeScene after note projection extraction: apps/mobile/src/mobileNoteProjection.ts and apps/mobile/src/mobileNoteProjection.test.ts scored 10; apps/mobile/src/demoData.ts returned no scorable code and no findings.
pnpm --filter @tolaria/mobile exec expo export --platform ios --output-dir /tmp/tolaria-mobile-export passed after note projection extraction.
pnpm --filter @tolaria/mobile test passed after mobile vault repository extraction: 4 files / 11 tests.
pnpm --filter @tolaria/mobile typecheck passed after mobile vault repository extraction.
CodeScene after mobile vault repository extraction: apps/mobile/src/mobileVaultRepository.ts and apps/mobile/src/mobileVaultRepository.test.ts scored 10; apps/mobile/src/demoData.ts still returned no scorable code and no findings.
pnpm --filter @tolaria/mobile exec expo export --platform ios --output-dir /tmp/tolaria-mobile-export passed after mobile vault repository extraction.
pnpm test -- apps/mobile/src/mobileVaultRepository.test.ts passed and ran only the mobile repository test file.
pnpm test -- packages/markdown/src/noteTitle.test.ts passed and ran only the shared Markdown note-title test file.
pnpm test -- --silent passed after runner/hook updates: 309 desktop files / 3639 desktop tests, 4 mobile files / 11 mobile tests, 3 shared Markdown files / 56 shared tests.
CodeScene after test-runner update: scripts/run-tests.mjs scored 10; .husky/pre-commit is unsupported by CodeScene file analysis because it has no supported extension.
xcrun simctl list devices available now responds with available iPhone/iPad devices.
xcrun simctl boot 40724AA3-A793-41D8-9C66-79745DA28DE4 booted iPad Pro 13-inch (M4).
pnpm --filter @tolaria/mobile exec expo start --ios installed/opened Expo Go and launched Tolaria on the booted iPad simulator.
Simulator screenshot captured at /tmp/tolaria-mobile-ipad.png; the Tolaria shell renders behind Expo Go's first-run tools modal.
pnpm --filter @tolaria/mobile test passed after adding gesture support: 5 files / 15 tests.
pnpm --filter @tolaria/mobile typecheck passed after adding gesture support.
CodeScene after gesture support: apps/mobile/src/compactGestures.ts, apps/mobile/src/compactGestures.test.ts, apps/mobile/src/SwipeSurface.tsx, touched app/root files, and touched style module scored 10; apps/mobile/index.ts returned no scorable code.
pnpm --filter @tolaria/mobile exec expo export --platform ios --output-dir /tmp/tolaria-mobile-export passed after adding gesture support.
Simulator screenshot after gesture support captured at /tmp/tolaria-mobile-gestures-ipad.png; no red runtime error overlay appeared.
pnpm --filter @tolaria/mobile test passed after Git remote auth parsing: 6 files / 20 tests.
pnpm --filter @tolaria/mobile typecheck passed after Git remote auth parsing.
CodeScene after Git remote auth parsing: apps/mobile/src/mobileGitRemote.ts and apps/mobile/src/mobileGitRemote.test.ts scored 10.
pnpm --filter @tolaria/mobile exec expo export --platform ios --output-dir /tmp/tolaria-mobile-export passed after Git remote auth parsing.
pnpm --filter @tolaria/mobile test -- src/mobileVaultConfig.test.ts passed after vault config extraction: 7 files / 24 tests.
pnpm --filter @tolaria/mobile typecheck passed after vault config extraction.
CodeScene after vault config extraction: apps/mobile/src/mobileVaultConfig.ts and apps/mobile/src/mobileVaultConfig.test.ts scored 10.
pnpm --filter @tolaria/mobile exec expo export --platform ios --output-dir /tmp/tolaria-mobile-export passed after vault config extraction.
pnpm --filter @tolaria/mobile test -- src/mobileEditorDocument.test.ts passed after editor adapter extraction: 8 files / 27 tests.
pnpm --filter @tolaria/mobile typecheck passed after editor adapter extraction.
CodeScene after editor adapter extraction: apps/mobile/src/MobileApp.tsx, apps/mobile/src/MobileEditorAdapter.tsx, apps/mobile/src/mobileEditorDocument.ts, and apps/mobile/src/mobileEditorDocument.test.ts scored 10.
pnpm --filter @tolaria/mobile exec expo export --platform ios --output-dir /tmp/tolaria-mobile-export passed after editor adapter extraction.

Risks / Watch Items

Editor quality remains the largest mobile risk; TenTap must pass the quality gates before becoming accepted.
Shared package extraction must not destabilize active desktop work.
Desktop alpha release currently triggers on every push to main; this branch is safe, but release path filters should be added before mobile work merges to main.
Codacy analyzes committed/pushed repository state; local edits still need local lint/test/CodeScene discipline before remote checks exist.

14 KiB Raw Blame History