feat: restore startup stall recovery for app launches (#78)

Restore startup stall recovery for RN-ready app launches, including restart-between-files. Startup retries now pause on Metro bundling activity, resume afterward, and still fail immediately on confirmed native crashes.

Author: V3RON

.nx/version-plans/restore-startup-stall-recovery.md

@@ -0,0 +1,5 @@
+---
+__default__: patch
+---
+
+Harness now restores app startup stall recovery for RN-ready launches, including restart-between-files. Apps are retried when startup stalls without a crash, while confirmed native crashes still fail immediately with crash diagnostics.

actions/shared/index.cjs

@@ -4225,10 +4225,8 @@ var ConfigSchema = external_exports.object({
   metroPort: external_exports.number().int("Metro port must be an integer").min(1, "Metro port must be at least 1").max(65535, "Metro port must be at most 65535").optional().default(DEFAULT_METRO_PORT),
   webSocketPort: external_exports.number().optional().default(3001),
   bridgeTimeout: external_exports.number().min(1e3, "Bridge timeout must be at least 1 second").default(6e4),
-  /** @deprecated Removed in favor of crash supervisor. Accepted for backwards compatibility. */
-  bundleStartTimeout: external_exports.number().optional(),
-  /** @deprecated Removed in favor of crash supervisor. Accepted for backwards compatibility. */
-  maxAppRestarts: external_exports.number().optional(),
+  bundleStartTimeout: external_exports.number().min(1e3, "Bundle start timeout must be at least 1 second").default(15e3),
+  maxAppRestarts: external_exports.number().min(0, "Max app restarts must be at least 0").default(2),
   resetEnvironmentBetweenTestFiles: external_exports.boolean().optional().default(true),
   unstable__skipAlreadyIncludedModules: external_exports.boolean().optional().default(false),
   unstable__enableMetroCache: external_exports.boolean().optional().default(false),
@@ -4415,20 +4413,6 @@ var import_node_path5 = __toESM(require("path"), 1);
 var import_node_fs5 = __toESM(require("fs"), 1);
 var import_node_module2 = require("module");
 var import_meta = {};
-var DEPRECATED_PROPERTIES = {
-  bundleStartTimeout: '"bundleStartTimeout" is no longer used and can be removed from your config. Startup crash detection is now handled automatically by the crash supervisor.',
-  maxAppRestarts: '"maxAppRestarts" is no longer used and can be removed from your config. Startup crash detection is now handled automatically by the crash supervisor.'
-};
-var warnDeprecatedProperties = (rawConfig) => {
-  if (typeof rawConfig !== "object" || rawConfig === null) {
-    return;
-  }
-  for (const [key, message] of Object.entries(DEPRECATED_PROPERTIES)) {
-    if (key in rawConfig) {
-      console.warn(`[react-native-harness] Deprecation warning: ${message}`);
-    }
-  }
-};
 var extensions = [".js", ".mjs", ".cjs", ".json"];
 var importUp = async (dir, name) => {
   const filePath = import_node_path5.default.join(dir, name);
@@ -4447,7 +4431,6 @@ var importUp = async (dir, name) => {
         throw new ConfigLoadError(filePathWithExt, error instanceof Error ? error : void 0);
       }
       try {
-        warnDeprecatedProperties(rawConfig);
         const config = ConfigSchema.parse(rawConfig);
         return { config, filePathWithExt, configDir: dir };
       } catch (error) {

packages/config/src/reader.ts

@@ -9,25 +9,6 @@ import fs from 'node:fs';
 import { createRequire } from 'node:module';
 import { ZodError } from 'zod';
 
-const DEPRECATED_PROPERTIES: Record<string, string> = {
-  bundleStartTimeout:
-    '"bundleStartTimeout" is no longer used and can be removed from your config. Startup crash detection is now handled automatically by the crash supervisor.',
-  maxAppRestarts:
-    '"maxAppRestarts" is no longer used and can be removed from your config. Startup crash detection is now handled automatically by the crash supervisor.',
-};
-
-const warnDeprecatedProperties = (rawConfig: unknown) => {
-  if (typeof rawConfig !== 'object' || rawConfig === null) {
-    return;
-  }
-
-  for (const [key, message] of Object.entries(DEPRECATED_PROPERTIES)) {
-    if (key in rawConfig) {
-      console.warn(`[react-native-harness] Deprecation warning: ${message}`);
-    }
-  }
-};
-
 const extensions = ['.js', '.mjs', '.cjs', '.json'];
 
 const importUp = async (
@@ -62,7 +43,6 @@ const importUp = async (
       }
 
       try {
-        warnDeprecatedProperties(rawConfig);
         const config = ConfigSchema.parse(rawConfig);
         return { config, filePathWithExt, configDir: dir };
       } catch (error) {

packages/config/src/types.ts

@@ -37,10 +37,14 @@ export const ConfigSchema = z
       .min(1000, 'Bridge timeout must be at least 1 second')
       .default(60000),
 
-    /** @deprecated Removed in favor of crash supervisor. Accepted for backwards compatibility. */
-    bundleStartTimeout: z.number().optional(),
-    /** @deprecated Removed in favor of crash supervisor. Accepted for backwards compatibility. */
-    maxAppRestarts: z.number().optional(),
+    bundleStartTimeout: z
+      .number()
+      .min(1000, 'Bundle start timeout must be at least 1 second')
+      .default(15000),
+    maxAppRestarts: z
+      .number()
+      .min(0, 'Max app restarts must be at least 0')
+      .default(2),
 
     resetEnvironmentBetweenTestFiles: z.boolean().optional().default(true),
     unstable__skipAlreadyIncludedModules: z.boolean().optional().default(false),