feat(core): implement recursive .app bundle discovery in zip extractor

Author: tranhoangpich

src/core/engine.rs

@@ -13,6 +13,8 @@ pub enum OrchestratorError {
     Extraction(#[from] ExtractionError),
     #[error("Failed to parse Info.plist: {0}")]
     PlistParse(#[from] PlistError),
+    #[error("Could not locate App Bundle (.app) inside {0}. Found entries: {1}")]
+    AppBundleNotFoundWithContext(String, String),
     #[error("Could not locate App Bundle (.app) inside IPAPayload")]
     AppBundleNotFound,
 }
@@ -62,8 +64,23 @@ impl Engine {
 
         let app_bundle_path = extracted_ipa
             .get_app_bundle_path()
-            .map_err(|e| OrchestratorError::Extraction(ExtractionError::Io(e)))?
-            .ok_or(OrchestratorError::AppBundleNotFound)?;
+            .map_err(|e| OrchestratorError::Extraction(ExtractionError::Io(e)))?;
+
+        let app_bundle_path = match app_bundle_path {
+            Some(p) => p,
+            None => {
+                let mut entries = Vec::new();
+                if let Ok(rd) = std::fs::read_dir(&extracted_ipa.payload_dir) {
+                    for entry in rd.flatten().take(10) {
+                        entries.push(entry.file_name().to_string_lossy().into_owned());
+                    }
+                }
+                return Err(OrchestratorError::AppBundleNotFoundWithContext(
+                    extracted_ipa.payload_dir.display().to_string(),
+                    entries.join(", "),
+                ));
+            }
+        };
 
         self.run_on_bundle(&app_bundle_path, run_started)
     }

src/parsers/zip_extractor.rs

@@ -25,13 +25,31 @@ impl ExtractedIpa {
             return Ok(None);
         }
 
+        // Try direct root search first
         for entry in fs::read_dir(&self.payload_dir)? {
             let entry = entry?;
             let path = entry.path();
             if path.extension().and_then(|e| e.to_str()) == Some("app") {
                 return Ok(Some(path));
             }
         }
+
+        // Fallback: recursive search
+        let mut queue = vec![self.payload_dir.clone()];
+        while let Some(dir) = queue.pop() {
+            if let Ok(entries) = fs::read_dir(dir) {
+                for entry in entries.flatten() {
+                    let path = entry.path();
+                    if path.is_dir() {
+                        if path.extension().and_then(|e| e.to_str()) == Some("app") {
+                            return Ok(Some(path));
+                        }
+                        queue.push(path);
+                    }
+                }
+            }
+        }
+
         Ok(None)
     }
 }
@@ -48,7 +66,10 @@ pub fn extract_ipa<P: AsRef<Path>>(ipa_path: P) -> Result<ExtractedIpa, Extracti
 
     archive.extract(extract_path)?;
 
-    let payload_dir = extract_path.join("Payload");
+    let mut payload_dir = extract_path.join("Payload");
+    if !payload_dir.exists() {
+        payload_dir = extract_path.to_path_buf();
+    }
 
     Ok(ExtractedIpa {
         temp_dir,