quality: fix review issues and update external references Metadata: fix mcp-server description (12->15 tools), regenerate lockfiles, update SECURITY.md supported versions, remove shipped feature from ROADMAP v0.7. MCP tools: add try/catch to runOnDevice, fix 5 tool description mismatches (checkDevEnvironment, submitToAppStore, validateStoreMetadata, scaffoldProject, runOnDevice). Rules: move UIManager.setLayoutAnimationEnabledExperimental to Android-only. CI: fix brittle stdio smoke test to accept clean exit from stdin-less server. Docs: align CONTRIBUTING.md required sections with test_skills.py, fix checkDevEnvironment description in CLAUDE.md and README.md. Skills (April 2026 freshness): update for Expo SDK 55 (Node 20+, New Architecture required), Android API 36 deadline, iOS 26 SDK/Xcode 26 requirement, expo-notifications v55 breaking changes, ngrok tunnel issues, remove stale internal version labels.

TMHSDigital · TMHSDigital · commit fca072d020d7 · 2026-04-03T15:52:58.000-04:00
Made-with: Cursor
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -51,17 +51,23 @@ jobs:
 
       - name: Smoke test (server starts without crashing)
         run: |
-          sleep 5 | node dist/index.js &
+          node dist/index.js < /dev/null &
           PID=$!
           sleep 3
           if kill -0 "$PID" 2>/dev/null; then
             echo "Server still running after 3s. Smoke test passed."
             kill "$PID" 2>/dev/null || true
             wait "$PID" 2>/dev/null || true
           else
+            echo "Server exited (expected for stdio server with no stdin). Checking exit code."
             wait "$PID" 2>/dev/null
-            echo "Server exited early."
-            exit 1
+            EXIT_CODE=$?
+            if [ "$EXIT_CODE" -le 1 ]; then
+              echo "Clean exit (code $EXIT_CODE). Smoke test passed."
+            else
+              echo "Server crashed with exit code $EXIT_CODE."
+              exit 1
+            fi
           fi
 
   build-npm-package:
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -76,7 +76,7 @@ Tools use the `mobile_` prefix (for example `mobile_checkDevEnvironment`).
 
 | Tool | Description |
 | --- | --- |
-| mobile_checkDevEnvironment | Detect installed tools, SDKs, simulators; report what is missing |
+| mobile_checkDevEnvironment | Detect installed tools and SDKs (Node, Expo CLI, Watchman, Xcode, Android Studio, JDK); report what is missing |
 | mobile_scaffoldProject | Generate a new Expo project from a template with chosen options |
 | mobile_runOnDevice | Start dev server and provide instructions for connecting a physical device |
 | mobile_generateScreen | Create a new Expo Router screen file with navigation wiring and boilerplate |
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -15,7 +15,7 @@ Thanks for your interest in contributing to Mobile App Developer Tools.
 
 1. Create a directory under `skills/` matching your skill name (e.g. `skills/mobile-my-skill/`)
 2. Add a `SKILL.md` file with YAML frontmatter containing `name` (must match directory) and `description`
-3. Include these sections in order: Trigger, Required Inputs, Workflow, Key References, Example Interaction, MCP Usage, Common Pitfalls, See Also
+3. Include these required sections in order: Trigger, Required Inputs, Workflow, Example Interaction, MCP Usage, Common Pitfalls. Optional sections: Key References, See Also
 4. Run `pytest tests/test_skills.py -v` to verify frontmatter and structure
 
 ## Adding a Rule
diff --git a/README.md b/README.md
@@ -281,7 +281,7 @@ npx @tmhs/mobile-mcp
 
 | Tool | Purpose |
 | --- | --- |
-| `mobile_checkDevEnvironment` | Detect installed tools (Node, Expo CLI, Watchman, Xcode, Android Studio, JDK). Report what is missing with install instructions. |
+| `mobile_checkDevEnvironment` | Detect installed tools and SDKs (Node, Expo CLI, Watchman, Xcode, Android Studio, JDK). Report what is missing with install instructions. |
 | `mobile_scaffoldProject` | Generate a new Expo project with TypeScript template and recommended config. |
 | `mobile_runOnDevice` | Start dev server and provide step-by-step instructions for connecting a physical device. |
 | `mobile_generateScreen` | Create a new Expo Router screen file with correct convention, navigation wiring, and boilerplate. |
diff --git a/ROADMAP.md b/ROADMAP.md
@@ -10,7 +10,7 @@
 | **v0.4.0** | Users & Data | +4 | +1 | +3 | Auth, push notifications, local storage, API integration, env-safety rule |
 | **v0.5.0** | Flutter | +4 | +1 | +0 | Flutter project setup, navigation, run-on-device, state management, performance rule |
 | **v0.6.0** | Ship It | +3 | +1 | +3 | App store prep, iOS submission, Android submission, accessibility rule **(current)** |
-| **v0.7.0** | Grow | +2 | +0 | +3 | Monetization, deep links, build-for-store, screenshots, bundle analysis |
+| **v0.7.0** | Grow | +2 | +0 | +3 | Monetization, deep links, screenshots, bundle analysis |
 | **v1.0.0** | Stable | +0 | +0 | +0 | Polish, docs, production release: 22 skills, 7 rules, 18 MCP tools |
 
 ## v0.1.0 - Zero to Phone
diff --git a/SECURITY.md b/SECURITY.md
@@ -4,7 +4,9 @@
 
 | Version | Supported |
 |---------|-----------|
-| 0.1.x   | Yes       |
+| 0.6.x   | Yes       |
+| 0.5.x   | Best-effort |
+| < 0.5   | No        |
 
 ## Reporting a Vulnerability
 
diff --git a/mcp-server/package-lock.json b/mcp-server/package-lock.json
diff --git a/mcp-server/package.json b/mcp-server/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tmhs/mobile-mcp",
   "version": "0.6.0",
-  "description": "MCP server for mobile app development - 12 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, and dev environment reset.",
+  "description": "MCP server for mobile app development - 15 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, dev environment reset, store builds, metadata validation, and App Store submission.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
diff --git a/mcp-server/src/tools/checkDevEnvironment.ts b/mcp-server/src/tools/checkDevEnvironment.ts
@@ -57,7 +57,7 @@ const inputSchema = {
 export function register(server: McpServer): void {
   server.tool(
     "mobile_checkDevEnvironment",
-    "Detect installed mobile development tools, SDKs, and simulators. Report what is installed and what is missing with install instructions.",
+    "Detect installed mobile development tools and SDKs (Node, Expo CLI, Watchman, Xcode, Android Studio, JDK). Report what is installed and what is missing with install instructions.",
     inputSchema,
     async (args) => {
       try {
diff --git a/mcp-server/src/tools/runOnDevice.ts b/mcp-server/src/tools/runOnDevice.ts
@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { platform } from "node:os";
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { textResponse } from "../types.js";
+import { textResponse, errorResponse } from "../types.js";
 
 const inputSchema = {
   project_path: z
@@ -22,9 +22,10 @@ const inputSchema = {
 export function register(server: McpServer): void {
   server.tool(
     "mobile_runOnDevice",
-    "Start the Expo dev server and provide step-by-step instructions for connecting a physical device.",
+    "Provide step-by-step instructions for connecting a physical device to the Expo dev server via LAN, tunnel, or USB.",
     inputSchema,
     async (args) => {
+      try {
       const os = platform();
       const connection = args.connection;
       const targetPlatform = args.target_platform;
@@ -114,6 +115,9 @@ export function register(server: McpServer): void {
       };
 
       return textResponse(JSON.stringify(result, null, 2));
+      } catch (err) {
+        return errorResponse(err);
+      }
     },
   );
 }
diff --git a/mcp-server/src/tools/scaffoldProject.ts b/mcp-server/src/tools/scaffoldProject.ts
@@ -21,7 +21,7 @@ const inputSchema = {
 export function register(server: McpServer): void {
   server.tool(
     "mobile_scaffoldProject",
-    "Generate a new Expo project with TypeScript and recommended configuration.",
+    "Generate a new Expo project using create-expo-app with the default or specified template.",
     inputSchema,
     async (args) => {
       try {
diff --git a/mcp-server/src/tools/submitToAppStore.ts b/mcp-server/src/tools/submitToAppStore.ts
@@ -23,7 +23,7 @@ const inputSchema = {
 export function register(server: McpServer): void {
   server.tool(
     "mobile_submitToAppStore",
-    "Submit the latest iOS production build to App Store Connect via EAS Submit. Validates that EAS CLI is available and a recent build exists.",
+    "Submit the latest iOS production build to App Store Connect via EAS Submit. Validates that EAS CLI is available.",
     inputSchema,
     async (args) => {
       try {
diff --git a/mcp-server/src/tools/validateStoreMetadata.ts b/mcp-server/src/tools/validateStoreMetadata.ts
@@ -25,7 +25,7 @@ interface CheckResult {
 export function register(server: McpServer): void {
   server.tool(
     "mobile_validateStoreMetadata",
-    "Check that an Expo project has all required app store listing fields: name, bundle ID, version, icon, splash, privacy policy. Returns a pass/fail checklist.",
+    "Check that an Expo project has all required app store listing fields: name, bundle ID, version, icon, splash screen. Returns a pass/fail checklist.",
     inputSchema,
     async (args) => {
       try {
diff --git a/packages/mobile-dev-tools/package-lock.json b/packages/mobile-dev-tools/package-lock.json
diff --git a/rules/mobile-platform-check.mdc b/rules/mobile-platform-check.mdc
@@ -19,7 +19,6 @@ When reviewing or writing `.ts` / `.tsx` files in a React Native or Expo project
 - `Settings` (iOS NSUserDefaults bridge)
 - `PushNotificationIOS`
 - `DynamicColorIOS`
-- `UIManager.setLayoutAnimationEnabledExperimental` (Android-only call to enable layout animations)
 - `SafeAreaView` from `react-native` (use `react-native-safe-area-context` instead for cross-platform)
 - `DatePickerIOS` (deprecated, but still appears in older code)
 
@@ -33,6 +32,7 @@ When reviewing or writing `.ts` / `.tsx` files in a React Native or Expo project
 - `ProgressBarAndroid`
 - `StatusBar.setBackgroundColor` (no-op on iOS)
 - `StatusBar.setTranslucent` (Android-only)
+- `UIManager.setLayoutAnimationEnabledExperimental` (must be called on Android to enable LayoutAnimation)
 
 ### Platform-varying behavior
 
diff --git a/skills/mobile-android-submission/SKILL.md b/skills/mobile-android-submission/SKILL.md
@@ -170,10 +170,10 @@ Use this skill when the user:
 
 8. **Target API level.** Google Play requires targeting recent API levels:
 
-   | Date | Minimum targetSdkVersion |
-   |------|-------------------------|
-   | 2024+ | API 34 (Android 14) |
-   | 2025+ | API 35 (Android 15) |
+   | Deadline | Minimum targetSdkVersion |
+   |----------|-------------------------|
+   | Aug 2025 | API 35 (Android 15) |
+   | Aug 2026 | API 36 (Android 16) |
 
    Expo SDK handles this automatically. Check with:
 
diff --git a/skills/mobile-api-integration/SKILL.md b/skills/mobile-api-integration/SKILL.md
@@ -32,7 +32,7 @@ Use this skill when the user:
    | GraphQL | urql or Apollo Client | Built-in cache |
    | Real-time GraphQL | urql with subscriptions | Built-in |
 
-   React Query (from v0.2.0 state-management skill) is the cache/state layer for REST. GraphQL clients have their own cache.
+   React Query (from the state-management skill) is the cache/state layer for REST. GraphQL clients have their own cache.
 
 2. **Create a typed API client.** In `lib/api.ts`:
 
diff --git a/skills/mobile-app-store-prep/SKILL.md b/skills/mobile-app-store-prep/SKILL.md
@@ -117,7 +117,7 @@ Use this skill when the user:
    And provide the URL in App Store Connect / Play Console.
 
 5. **Age rating / content rating.**
-   - **iOS**: Fill the age rating questionnaire in App Store Connect (violence, language, etc.)
+   - **iOS**: Fill the age rating questionnaire in App Store Connect (violence, language, etc.). Apple updated the age rating system in January 2026; review your responses.
    - **Android**: Complete the content rating questionnaire in Play Console (uses IARC system)
 
    Both are required before the first submission.
@@ -133,7 +133,8 @@ Use this skill when the user:
    | Misleading metadata | Both | Screenshots must show actual app UI |
    | External payment links | iOS | Do not link to web payment outside IAP |
    | Missing App Tracking Transparency | iOS | Add ATT prompt if using IDFA |
-   | Target API too low | Android | Must target latest or latest-1 API level |
+   | Missing AI disclosure | iOS | If using AI, explain what it does and what data it uses |
+   | Target API too low | Android | Must target latest or latest-1 API level (API 36 from Aug 2026) |
 
 7. **Version numbering.**
 
diff --git a/skills/mobile-dev-environment/SKILL.md b/skills/mobile-dev-environment/SKILL.md
@@ -45,19 +45,19 @@ Use this skill when the user:
    xcodebuild -version     # Full Xcode (required for iOS device builds)
    watchman --version       # File watcher (recommended for performance)
    pod --version            # CocoaPods (required for iOS native modules)
-   java -version            # JDK 17 (required for Android)
+   java -version            # JDK 17 or 21 (required for Android)
    ```
 
    **Windows (Android only):**
    ```powershell
-   java -version            # JDK 17
+   java -version            # JDK 17 or 21
    # Android Studio: check ANDROID_HOME environment variable
    echo $env:ANDROID_HOME
    ```
 
    **Linux (Android only):**
    ```bash
-   java -version            # JDK 17
+   java -version            # JDK 17 or 21
    echo $ANDROID_HOME       # Android SDK path
    watchman --version        # Recommended
    ```
@@ -66,10 +66,10 @@ Use this skill when the user:
 
    | Tool | Status | Version | Action |
    |------|--------|---------|--------|
-   | Node.js | Installed | v20.11.0 | - |
-   | Expo CLI | Available | 0.18.0 | - |
+   | Node.js | Installed | v20.19.0 | - |
+   | Expo CLI | Available | latest | - |
    | Watchman | Missing | - | `brew install watchman` |
-   | Xcode | Installed | 15.4 | - |
+   | Xcode | Installed | 16.1 | Upgrade to Xcode 26 for iOS 26 SDK (required from April 28, 2026) |
    | Android Studio | Missing | - | Download from developer.android.com |
 
 5. **Provide install commands for missing tools:**
@@ -98,13 +98,13 @@ Use this skill when the user:
    # For full Xcode: install from the Mac App Store
    ```
 
-   **JDK 17 (all platforms):**
+   **JDK 17 or 21 (all platforms):**
    ```bash
    # macOS
    brew install --cask zulu@17
 
    # Windows
-   # Download Azul Zulu JDK 17 from https://www.azul.com/downloads/
+   # Download Azul Zulu JDK 17 or 21 from https://www.azul.com/downloads/
 
    # Linux
    sudo apt install openjdk-17-jdk
@@ -113,7 +113,7 @@ Use this skill when the user:
    **Android Studio:**
    Download from https://developer.android.com/studio. During setup, install:
    - Android SDK
-   - Android SDK Platform 34
+   - Android SDK Platform 36 (or latest)
    - Android Virtual Device (AVD)
 
    Set `ANDROID_HOME`:
@@ -144,7 +144,7 @@ Use this skill when the user:
 
 **Agent:**
 1. Runs `mobile_checkDevEnvironment` to scan installed tools
-2. Reports: Node 20.11.0 installed, Watchman missing, Xcode 15.4 installed, Android Studio missing
+2. Reports: Node 20.19.0 installed, Watchman missing, Xcode 16.1 installed, Android Studio missing
 3. Provides `brew install watchman` command
 4. Asks if the user wants Android support (if yes, links to Android Studio download)
 5. Confirms the environment is ready for Expo/iOS development
@@ -157,10 +157,10 @@ Use this skill when the user:
 
 ## Common Pitfalls
 
-1. **Wrong Node version** - Expo requires Node 18+. If you have an older version, use `nvm` or `fnm` to manage versions.
+1. **Wrong Node version** - Expo SDK 55+ requires Node 20+. If you have an older version, use `nvm` or `fnm` to manage versions.
 2. **Missing ANDROID_HOME** - Android builds fail silently if this env var is not set. Check with `echo $ANDROID_HOME` (macOS/Linux) or `echo $env:ANDROID_HOME` (Windows).
 3. **Xcode CLI tools without full Xcode** - `xcode-select --install` gives you command line tools, but iOS device builds require the full Xcode from the App Store.
-4. **JDK version mismatch** - Android Gradle builds require JDK 17. JDK 21 may cause issues with older Gradle versions.
+4. **JDK version mismatch** - Android Gradle builds require JDK 17 or 21. JDK 21 ships with recent Android Studio versions and is the recommended choice for new projects.
 5. **Windows and iOS** - You cannot build iOS apps on Windows. Use Expo Go for testing or EAS Build for cloud-based iOS builds.
 6. **CocoaPods not installed** - Run `sudo gem install cocoapods` on macOS if `pod --version` fails. On Apple Silicon, you may need `sudo arch -x86_64 gem install ffi` first.
 
diff --git a/skills/mobile-ios-submission/SKILL.md b/skills/mobile-ios-submission/SKILL.md
@@ -171,7 +171,25 @@ Use this skill when the user:
 
    Review typically takes 24-48 hours. Expedited reviews are available for critical bug fixes.
 
-8. **Common rejection reasons and fixes.**
+8. **SDK and Xcode requirements.** Apple enforces minimum SDK versions:
+
+   | Deadline | Requirement |
+   |----------|-------------|
+   | April 24, 2025 | iOS 18 SDK, Xcode 16 |
+   | April 28, 2026 | iOS 26 SDK, Xcode 26 |
+
+   Apps uploaded after the deadline must be built with the required Xcode version. Expo SDK 55+ with EAS Build handles this automatically.
+
+9. **AI disclosure.** If the app uses AI features, Apple requires:
+   - Clear explanation of what the AI does
+   - Disclosure of what data the AI uses
+   - User controls for AI behavior
+   
+   Add this information in the App Store Connect app description and in-app where AI features are used.
+
+10. **Age rating.** Apple updated the age rating system in January 2026. Review and update responses in App Store Connect to avoid submission delays.
+
+11. **Common rejection reasons and fixes.**
 
    | Rejection | Fix |
    |-----------|-----|
diff --git a/skills/mobile-local-storage/SKILL.md b/skills/mobile-local-storage/SKILL.md
@@ -53,7 +53,7 @@ Use this skill when the user:
    );
    ```
 
-   AsyncStorage with Zustand persist (from v0.2.0):
+   AsyncStorage with Zustand persist:
 
    ```tsx
    import { create } from "zustand";
diff --git a/skills/mobile-project-setup/SKILL.md b/skills/mobile-project-setup/SKILL.md
diff --git a/skills/mobile-push-notifications/SKILL.md b/skills/mobile-push-notifications/SKILL.md
diff --git a/skills/mobile-run-on-device/SKILL.md b/skills/mobile-run-on-device/SKILL.md

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@tmhs/mobile-mcp",`
`3`	`3`	`"version": "0.6.0",`
`4`		`- "description": "MCP server for mobile app development - 12 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, and dev environment reset.",`
	`4`	`+ "description": "MCP server for mobile app development - 15 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, dev environment reset, store builds, metadata validation, and App Store submission.",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "dist/index.js",`
`7`	`7`	`"bin": {`