feat(catalyst): run and build Mac Catalyst apps with ns run catalyst - #6125

#!/bin/bash
set -eu
file=$(git ls-files | grep -F 'lib/common/mobile/mac/mac-catalyst-application-manager.ts' | head -n1)
printf '%s\n' "$file"
cat -n "$file" | sed -n '1,130p'
printf '\n-- path construction and related process calls --\n'
rg -n -C 3 'getExecutablePath|applicationBundlePath|spawnFromEvent|pkill' lib/common/mobile/mac "$file"

#!/bin/bash
set -eu
file=$(git ls-files | grep -F 'lib/common/mobile/mac/mac-catalyst-application-manager.ts' | head -n1)
cat -n "$file" | sed -n '1,130p'
rg -n -C 3 'getExecutablePath|applicationBundlePath|spawnFromEvent|pkill' lib/common/mobile/mac "$file"

#!/bin/bash
set -eu
printf '%s\n' '-- application bundle path sources --'
rg -n -C 5 'getBuiltApplicationBundlePath|packageFilePath|applicationBundlePath\s*=' lib | head -n 240
printf '%s\n' '-- pkill documentation available in the environment --'
if command -v man >/dev/null 2>&1; then
  man pkill 2>/dev/null | col -b 2>/dev/null | grep -n -A8 -B4 -E 'extended|full process|command line|regular expression' | head -n 120 || true
fi
printf '%s\n' '-- behavioral probe for the proposed escaping --'
node - <<'JS'
const escapeEre = value => value.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&");
const paths = [
  "/Users/me/[work]/Demo.app/Contents/MacOS/Demo",
  "/Users/me/foo+bar/Demo.app/Contents/MacOS/Demo",
  "/Users/me/foo.bar/Demo.app/Contents/MacOS/Demo",
  "/Users/me/foo(bar)/Demo.app/Contents/MacOS/Demo",
  "/Users/me/foo\\bar/Demo.app/Contents/MacOS/Demo",
];
for (const path of paths) {
  const raw = `^${path}$`;
  const escaped = `^${escapeEre(path)}$`;
  let rawValid = true;
  try { new RegExp(raw); } catch { rawValid = false; }
  let escapedValid = true;
  try { new RegExp(escaped); } catch { escapedValid = false; }
  console.log(JSON.stringify({path, raw, rawValid, escaped, escapedValid}));
}
JS

#!/bin/bash
set -eu
printf '%s\n' '-- Mac Catalyst device path generation --'
file=$(git ls-files | grep -F 'lib/common/mobile/mac/mac-catalyst-device.ts' | head -n1)
cat -n "$file" | sed -n '1,115p'
printf '%s\n' '-- inherited path-generation definitions --'
rg -n -C 5 'BuiltApplicationBundlePath|built application bundle|application bundle path|applicationBundlePath' lib/common lib/platforms | head -n 240
printf '%s\n' '-- process and Mac Catalyst tests --'
rg -n -C 4 'MacCatalystApplicationManager|mac-catalyst-application-manager|pkill|stopApplication' lib/common/test test 2>/dev/null | head -n 260 || true

#!/bin/bash
set -euo pipefail

ast-grep outline lib/device-path-provider.ts --items all
fd -i 'mac-catalyst-(device|file-system)\.ts$' lib --exec sed -n '1,240p' {}
rg -n -C 6 '\bgetDeviceSyncZipPath\s*\(' lib

#!/bin/bash
set -euo pipefail

rg -n -C 12 'deviceSyncZipPath|IOS_DEVICE_SYNC_ZIP_PATH|transferDirectory|transferFiles' lib/services lib/common lib | head -n 500
printf '\n--- Catalyst registrations and LiveSync services ---\n'
rg -n -C 8 'MacCatalyst(FileSystem|Device)|Catalyst.*LiveSync|liveSync.*Catalyst|platform.*Catalyst' lib

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- LiveSync service selection ---'
rg -n -C 15 'getDeviceLiveSyncService|IOSDeviceLiveSyncService|IosDeviceLiveSyncService|iOSLiveSync|isApplePlatform|isCatalystPlatform' lib/services lib/common
printf '%s\n' '--- iOS transfer entry points ---'
sed -n '1,180p' lib/services/livesync/ios-livesync-service.ts
printf '%s\n' '--- Catalyst filesystem and device path provider ---'
sed -n '1,130p' lib/device-path-provider.ts
sed -n '1,150p' lib/common/mobile/mac/mac-catalyst-file-system.ts

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- Platform LiveSync service resolution ---'
rg -n -C 12 'iOSLiveSyncService|androidLiveSyncService|getPlatformLiveSyncService|LiveSyncService' lib/services lib/commands lib/common --glob '*.ts' | grep -E 'iOSLiveSyncService|androidLiveSyncService|getPlatformLiveSyncService|resolve|platform|register' | head -n 240

printf '%s\n' '--- iOS full-sync transfer implementation ---'
sed -n '1,145p' lib/services/livesync/ios-livesync-service.ts

printf '%s\n' '--- Catalyst-specific LiveSync references ---'
rg -n -C 10 'Catalyst' lib/services/livesync lib/common/mobile/mac lib/device-path-provider.ts --glob '*.ts'

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- LiveSync command and service injection ---'
fd -i '.*livesync.*\.ts$' lib --exec sh -c 'echo "--- $1"; rg -n -C 8 "iOSLiveSyncService|androidLiveSyncService|IPlatformLiveSyncService|platformLiveSyncService|resolve.*LiveSync|LiveSyncService" "$1"' sh {}

printf '%s\n' '--- All iOS LiveSync service references ---'
rg -n -C 8 'iOSLiveSyncService|IOSLiveSyncService' lib --glob '*.ts'

#!/bin/bash
set -euo pipefail

# Map the provider before tracing typed call sites.
ast-grep outline lib/device-path-provider.ts --items all

# Inspect consumers and their platform guards.
rg -n -C 6 '\.getDeviceSyncZipPath\s*\(' lib --type ts

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- device path provider ---'
sed -n '1,180p' lib/device-path-provider.ts

printf '%s\n' '--- livesync context and consumers ---'
sed -n '260,360p' lib/services/livesync/platform-livesync-service-base.ts
rg -n -C 8 'deviceSyncZipPath|IOS_DEVICE_SYNC_ZIP_PATH|syncZipPath|zipPath' lib/services lib/common --type ts

printf '%s\n' '--- Catalyst file-system implementation ---'
sed -n '1,140p' lib/common/mobile/mac/mac-catalyst-file-system.ts

printf '%s\n' '--- platform and emulator predicates ---'
rg -n -C 8 'isApplePlatform|isCatalystPlatform|isEmulator|deviceSyncZipPath' lib --type ts

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- iOS LiveSync service ---'
sed -n '1,220p' lib/services/livesync/ios-livesync-service.ts

printf '%s\n' '--- service resolver ---'
sed -n '1,80p' lib/resolvers/livesync-service-resolver.ts

printf '%s\n' '--- service selection and transfer entry points ---'
rg -n -C 12 'getDeviceLiveSyncService|resolveLiveSyncService|transferSyncZip|deviceSyncZipPath' \
  lib/services/livesync lib/resolvers --type ts

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- Catalyst integration ---'
rg -n -C 10 'MacCatalystFileSystem|isCatalystPlatform|IMacCatalystDevice|applicationBundlePath' \
  lib test tests --type ts --type d.ts 2>/dev/null || true

printf '%s\n' '--- LiveSync tests ---'
rg -n -C 8 'getDeviceSyncZipPath|IOSLiveSyncService|MacCatalyst|Catalyst|sync.zip' \
  test tests lib --glob '*test*' --glob '*spec*' --type ts 2>/dev/null || true

printf '%s\n' '--- read-only call-graph verifier ---'
python3 - <<'PY'
from pathlib import Path

provider = Path("lib/device-path-provider.ts").read_text()
resolver = Path("lib/resolvers/livesync-service-resolver.ts").read_text()
ios = Path("lib/services/livesync/ios-livesync-service.ts").read_text()
catalyst_fs = Path("lib/common/mobile/mac/mac-catalyst-file-system.ts").read_text()

checks = {
    "Catalyst project-root branch exists": 'isCatalystPlatform(device.deviceInfo.platform)' in provider,
    "sync-zip predicate lacks Catalyst exclusion": (
        'isApplePlatform(device.deviceInfo.platform)' in provider
        and '!device.isEmulator' in provider
        and 'isCatalystPlatform(device.deviceInfo.platform)' not in
           provider[provider.index('public getDeviceSyncZipPath'):provider.index('public getDeviceSyncZipPath') + 500]
    ),
    "Apple platforms resolve to iOS LiveSync": (
        'isApplePlatform(platform)' in resolver and '"iOSLiveSyncService"' in resolver
    ),
    "iOS fullSync uses the non-emulator archive branch": (
        'if (device.isEmulator)' in ios and
        'device.fileSystem.transferFiles(deviceAppData' in ios and
        'getDevicePath: () => deviceAppData.deviceSyncZipPath' in ios
    ),
    "Catalyst transferFiles performs local copy": (
        'public async transferFiles(' in catalyst_fs and
        'this.transferFile(' in catalyst_fs
    ),
}
for name, result in checks.items():
    print(f"{'PASS' if result else 'FAIL'}: {name}")
if not all(checks.values()):
    raise SystemExit(1)
PY

#!/bin/bash
set -eu

printf '%s\n' '--- semver dependency declarations ---'
rg -n '"semver"|"`@types/semver`"' package.json package-lock.json yarn.lock pnpm-lock.yaml 2>/dev/null || true

printf '%s\n' '--- relevant source symbols and usages ---'
rg -n -C 6 'getCatalystDeploymentTargetArgs|IPHONEOS_DEPLOYMENT_TARGET|readPropertyValue|MIN_CATALYST_DEPLOYMENT_TARGET' lib test tests 2>/dev/null || true

printf '%s\n' '--- xcconfig service definitions ---'
fd -i '.*xcconfig.*' .

#!/bin/bash
set -eu

printf '%s\n' '--- xcconfig parser implementation ---'
sed -n '1,180p' lib/services/xcconfig-service.ts

printf '%s\n' '--- xcconfig parser tests ---'
sed -n '1,180p' test/xcconfig-service.ts

printf '%s\n' '--- deployment-target tests ---'
rg -n -C 12 'Catalyst|catalyst|deployment target|deploymentTarget|MACCATALYST_DEPLOYMENT_TARGET' test lib/services/ios/xcodebuild-args-service.ts

#!/bin/bash
set -eu

node - <<'JS'
const semver = require("semver");

for (const value of ["$(IPHONEOS_DEPLOYMENT_TARGET)", "", "13.0", "13.1"]) {
  const coerced = semver.coerce(value);
  let comparison;
  let error;
  try {
    comparison = semver.lt(coerced, "13.1");
  } catch (err) {
    error = String(err);
  }
  console.log(JSON.stringify({ value, coerced: coerced && coerced.version, comparison, error }));
}
JS

#!/bin/bash
set -euo pipefail

# Map the platform-data sources before inspecting project-root resolution.
ast-grep outline lib/services/platforms-data-service.ts --items all
ast-grep outline lib/project-data.ts --items all

# Inspect how hostProjectPath and projectRoot relate across add-platform flows.
rg -n -C 8 '\b(hostProjectPath|projectRoot)\b' \
  lib/services/platforms-data-service.ts \
  lib/project-data.ts \
  lib/services/platform/add-platform-service.ts

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- platforms data service ---'
cat -n lib/services/platforms-data-service.ts | sed -n '1,180p'

printf '%s\n' '--- add platform service ---'
cat -n lib/services/platform/add-platform-service.ts | sed -n '1,220p'

printf '%s\n' '--- platform data definitions and hostProjectPath references ---'
rg -n -C 6 'interface IPlatformData|hostProjectPath|platforms/catalyst|platformData\.projectRoot|getPlatformData' \
  lib/definitions lib lib/services --glob '*.ts' | sed -n '1,260p'

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- platform getPlatformData implementations ---'
rg -n -l 'getPlatformData\s*\(' lib --glob '*.ts' --glob '*.js' | sort

printf '%s\n' '--- platform root construction ---'
rg -n -C 12 'getPlatformData\s*\(|projectRoot\s*[:=]|hostProjectPath|platformsDir' \
  lib/platforms lib/services lib --glob '*.ts' --glob '*.js' \
  | rg -v 'node_modules' | sed -n '1,360p'

printf '%s\n' '--- add-platform call graph ---'
rg -n -C 10 'addPlatformSafe|addPlatform\(|hostProjectPath' \
  lib/services lib/helpers lib/commands lib/controllers --glob '*.ts' | sed -n '1,300p'

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- Android project data ---'
rg -n -C 20 'getPlatformData|projectRoot|hostProjectPath|platformsDir' \
  lib/services/android-project-service.ts | sed -n '1,240p'

printf '%s\n' '--- iOS project data ---'
rg -n -C 24 'getPlatformData|projectRoot|hostProjectPath|platformsDir' \
  lib/services/ios-project-service.ts | sed -n '1,280p'

printf '%s\n' '--- Catalyst and host-path helpers ---'
rg -n -C 16 'isCatalystPlatform|hostProjectPath|USER_PROJECT_PLATFORMS_IOS|USER_PROJECT_PLATFORMS_ANDROID' \
  lib --glob '*.ts' | sed -n '1,300p'

printf '%s\n' '--- add-platform service tests ---'
rg -n -l 'AddPlatformService|addPlatformSafe|deleteDirectory' test tests spec lib --glob '*.{ts,js}' 2>/dev/null | sort | sed -n '1,160p'

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- platform controller add flow ---'
cat -n lib/controllers/platform-controller.ts | sed -n '40,155p'

printf '%s\n' '--- hostProjectPath assignments and add-platform invocations ---'
rg -n -C 12 'hostProjectPath\s*=|hostProjectPath:|addPlatformSafe|addPlatformService' \
  lib test --glob '*.{ts,js}' | sed -n '1,360p'

printf '%s\n' '--- add-platform service tests ---'
cat -n test/services/platform/add-platform-service.ts | sed -n '1,320p'

printf '%s\n' '--- controller tests around host project handling ---'
rg -n -C 16 'hostProjectPath|addPlatformIfNeeded|addPlatform' \
  test/controllers test --glob '*.{ts,js}' | sed -n '1,320p'

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- embedding command execution ---'
cat -n lib/commands/embedding/embed.ts | sed -n '40,190p'

printf '%s\n' '--- all PlatformController.addPlatform callers ---'
rg -n -C 14 '\$platformController\.addPlatform|platformController\.addPlatform|addPlatformIfNeeded' \
  lib --glob '*.ts' | sed -n '1,300p'

printf '%s\n' '--- host option propagation ---'
rg -n -C 12 'hostProjectPath' \
  lib/commands lib/controllers lib/services lib/options.ts lib/declarations.d.ts \
  --glob '*.ts' --glob '*.d.ts' | sed -n '1,360p'

#!/bin/bash
set -euo pipefail

python3 - <<'PY'
from pathlib import Path
import posixpath
import re

android = Path("lib/services/android-project-service.ts").read_text()
ios = Path("lib/services/ios-project-service.ts").read_text()
add = Path("lib/services/platform/add-platform-service.ts").read_text()
controller = Path("lib/controllers/platform-controller.ts").read_text()

assert "const projectRoot = this.$options.hostProjectPath" in android
assert "const projectRoot = this.$options.hostProjectPath" in ios
assert re.search(r"this\.\$fs\.deleteDirectory\(platformData\.projectRoot\);", add)
assert re.search(
    r"if\s*\(!this\.\$options\.hostProjectPath\)\s*\{\s*"
    r"this\.\$fs\.deleteDirectory\(platformData\.projectRoot\);",
    add,
    re.S,
)

def root(host, platforms, platform):
    return host if host else posixpath.join(platforms, platform)

cases = [
    (None, "/project/platforms", "android"),
    (None, "/project/platforms", "catalyst"),
    ("/user/native-host", "/project/platforms", "android"),
    ("/user/native-host", "/project/platforms", "catalyst"),
]
for host, platforms, platform in cases:
    print({
        "hostProjectPath": host,
        "platform": platform,
        "projectRoot": root(host, platforms, platform),
        "failure_cleanup_deletes": not bool(host),
        "native_cleanup_deletes": True,
    })

print("root mapping: hostProjectPath overrides platforms/<platform>")
print("failure cleanup: guarded by !hostProjectPath")
print("native cleanup: unconditional")
print("addPlatformIfNeeded: returns before addPlatform when addPlatformData.hostProjectPath is set:",
      bool(re.search(r"if\s*\(addPlatformData\.hostProjectPath\).*?return;", controller, re.S)))
PY

#!/bin/bash
set -euo pipefail

python3 - <<'PY'
from pathlib import Path
import posixpath
import re

android = Path("lib/services/android-project-service.ts").read_text()
ios = Path("lib/services/ios-project-service.ts").read_text()
add = Path("lib/services/platform/add-platform-service.ts").read_text()
controller = Path("lib/controllers/platform-controller.ts").read_text()

assert "const projectRoot = this.$options.hostProjectPath" in android
assert "const projectRoot = this.$options.hostProjectPath" in ios
assert re.search(r"this\.\$fs\.deleteDirectory\(platformData\.projectRoot\);", add)
assert re.search(
    r"if\s*\(!this\.\$options\.hostProjectPath\)\s*\{\s*"
    r"this\.\$fs\.deleteDirectory\(platformData\.projectRoot\);",
    add,
    re.S,
)

def root(host, platforms, platform):
    return host if host else posixpath.join(platforms, platform)

for host, platforms, platform in [
    (None, "/project/platforms", "android"),
    (None, "/project/platforms", "catalyst"),
    ("/user/native-host", "/project/platforms", "android"),
    ("/user/native-host", "/project/platforms", "catalyst"),
]:
    print({
        "hostProjectPath": host,
        "platform": platform,
        "projectRoot": root(host, platforms, platform),
        "failure_cleanup_deletes": not bool(host),
        "native_cleanup_deletes": True,
    })

print("root mapping: hostProjectPath overrides platforms/<platform>")
print("failure cleanup: guarded by !hostProjectPath")
print("native cleanup: unconditional")
print(
    "addPlatformIfNeeded: returns before addPlatform when addPlatformData.hostProjectPath is set:",
    bool(re.search(
        r"if\s*\(addPlatformData\.hostProjectPath\).*?return;",
        controller,
        re.S,
    )),
)
PY