Local native wrapper planning

Contact Capture Native Wrapper Planning

Plan a future mobile app wrapper around the current PWA shell. This page keeps Expo install, native project creation, native builds, deploy, credentials, and live services blocked.

Native wrapper planning only
Mode Planning packet
Allowed PWA source of truth
Blocked No Expo install, native build, deploy
Next Separate Strict Control approval

Planning Outcome

  • 1ready-for-more-pwa-review keeps the owner in local PWA review.
  • 2ready-for-expo-wrapper-plan prepares an Expo Router wrapper implementation packet only.
  • 3ready-for-native-capability-map maps camera, QR, share, offline, and notification decisions.
  • !blocked-native-build-request and blocked-native-wrapper-planning stop the chain.

Request Evidence

  • 1nativeWrapperRequestStatus must be ready-for-native-wrapper-planning-request.
  • 2nativeWrapperRequestReference and nativeWrapperRequestFingerprintReference are reference-only.
  • 3One upstream packet, either packagingTargetRequestReference or postReviewRequestReference, must be present.
  • !pwaReviewReference, releaseReadinessReference, localPreviewReference, ownerReviewReference, and operatorAcknowledgementReference stay required.

Decision Options

  • 1continue-pwa-review keeps native work blocked.
  • 2prepare-expo-wrapper-plan plans the wrapper around the PWA shell.
  • 3prepare-native-capability-map documents mobile-only capabilities.
  • !request-native-build is blocked until a separate Strict Control packet exists.

Planning Boundary

  • 1This is a planning-only page; it does not create an app or mutate project structure.
  • !No npm install, Expo install, native project initialization, native build, app-store/TestFlight action, package build, deploy, hosting change, DNS change, or production touch.
  • !No service-worker cache expansion, live OCR, Google Contacts, n8n/Contacts Agent, credentials, durable writes, raw logs, raw payload storage, or notifications.

Safety Confirmations

  • 1planningOnly, nativeWrapperRequestReady, noDependencyInstall, and noExpoInstall remain true.
  • 2noNativeProjectCreated, noNativeBuildStarted, noPackageBuildStarted, and noAppStoreSubmission stay true.
  • 3noDeployStarted, noHostingChange, noDnsChange, and noServiceWorkerCacheExpansion are mandatory.
  • !noCredentialAccess, noProductionAccess, noRawLogStorage, noRawPayloadStorage, noNotificationSend, and separateApprovalRequired remain true.

Native Capability Map

  • 1camera capture for business card photos.
  • 2QR and vCard scanning handoff.
  • 3Image/OCR handoff into the existing review pipeline with manual field confirmation.
  • !Share sheet import, offline draft queue, and push/completion notifications are later owner decisions.

Owner Decision Gates

  • 1decision-native-wrapper-framework-owner.
  • 2decision-native-wrapper-capability-map-owner.
  • 3decision-native-wrapper-install-window-owner and decision-native-wrapper-build-window-owner.
  • !decision-native-wrapper-signing-owner, decision-native-wrapper-release-channel-owner, and rollback owner are separate approvals.

Stop Rules

  • !No planning packet if the native-wrapper request is missing or not ready.
  • !No packet if owner review, PWA review, release readiness, local preview, or operator acknowledgement is missing.
  • !No dependency install, Expo initialization, native files, native build, package build, deploy, hosting/DNS change, production, credential access, live adapter, durable write, raw storage, or notification send.

Local Endpoints

  • 1/mobile-assistant-native-wrapper-planning-policy lists native wrapper planning guardrails.
  • 2/mobile-assistant-native-wrapper-planning-plan classifies the planning decision without installing or building anything.
  • 3npm run verify:mobile-assistant-native-wrapper-planning-browser checks this page visually.