diff --git a/contexts/tools/appium/setup/references/chromium/chromium-browser-prereqs.md b/contexts/browser/chromium/prereqs.md similarity index 86% rename from contexts/tools/appium/setup/references/chromium/chromium-browser-prereqs.md rename to contexts/browser/chromium/prereqs.md index 37ac23e..636114e 100644 --- a/contexts/tools/appium/setup/references/chromium/chromium-browser-prereqs.md +++ b/contexts/browser/chromium/prereqs.md @@ -1,12 +1,13 @@ --- owner: appium -id: appium.setup.references.chromium.chromium-browser-prereqs -name: "chromium-browser-prereqs" +id: browser.chromium.prereqs +name: "chromium-prereqs" description: "Install or validate Chrome, Chromium, Edge, and Linux browser dependencies" +status: stable --- -# chromium-browser-prereqs +# Chromium Browser Prerequisites ## Browser Checks diff --git a/contexts/tools/appium/setup/references/gecko/gecko-browser-prereqs.md b/contexts/browser/firefox/prereqs.md similarity index 88% rename from contexts/tools/appium/setup/references/gecko/gecko-browser-prereqs.md rename to contexts/browser/firefox/prereqs.md index e91e432..0ad004e 100644 --- a/contexts/tools/appium/setup/references/gecko/gecko-browser-prereqs.md +++ b/contexts/browser/firefox/prereqs.md @@ -1,12 +1,13 @@ --- owner: appium -id: appium.setup.references.gecko.gecko-browser-prereqs -name: "gecko-browser-prereqs" -description: "Validate Firefox browser availability and host prerequisites for Appium Gecko Driver" +id: browser.firefox.prereqs +name: "firefox-prereqs" +description: "Validate Firefox browser availability and host prerequisites" +status: stable --- -# gecko-browser-prereqs +# Firefox Browser Prerequisites ## Firefox Detection diff --git a/contexts/browser/safari/prereqs.md b/contexts/browser/safari/prereqs.md new file mode 100644 index 0000000..3937ce7 --- /dev/null +++ b/contexts/browser/safari/prereqs.md @@ -0,0 +1,32 @@ +--- +owner: appium +id: browser.safari.prereqs +name: "safari-prereqs" +description: "Validate Safari and safaridriver availability plus macOS automation authorization boundaries" +status: stable +--- + +# Safari Browser Prerequisites + +## Goal + +Validate Safari browser automation prerequisites that are not specific to Appium driver installation. + +## Checks + +Run read-only checks before changing Safari automation state: + +```bash +sw_vers +safaridriver --version +``` + +## Authorization Boundary + +- If `safaridriver` is missing, stop and repair Safari or macOS tooling before Appium driver work. +- Run `safaridriver --enable` only when Safari automation is required and the user can accept the macOS authorization prompt. +- Treat Safari automation authorization as an explicit user approval step, not automatic setup. + +## Evidence To Report + +Report macOS version, `safaridriver --version`, whether Safari automation was already enabled or explicitly enabled, and any user action still required. diff --git a/contexts/tools/appium/setup/references/environment-setup-bundletool.md b/contexts/platform/android/bundletool.md similarity index 66% rename from contexts/tools/appium/setup/references/environment-setup-bundletool.md rename to contexts/platform/android/bundletool.md index ae456bc..8b410ed 100644 --- a/contexts/tools/appium/setup/references/environment-setup-bundletool.md +++ b/contexts/platform/android/bundletool.md @@ -1,12 +1,13 @@ --- owner: appium -id: appium.setup.references.environment-setup-bundletool -name: "environment-setup-bundletool" +id: platform.android.bundletool +name: "android-bundletool" description: "Route optional bundletool.jar setup for Android App Bundle support" +status: stable --- -# environment-setup-bundletool +# Android Bundletool ## Goal @@ -16,9 +17,9 @@ Install and validate `bundletool.jar` from official Google bundletool releases o Load these references in order: -1. `contexts/tools/appium/setup/references/bundletool/bundletool-decision-logic.md` for optional-use gates and install triggers. -2. `contexts/tools/appium/setup/references/bundletool/bundletool-install.md` for download and PATH setup. -3. `contexts/tools/appium/setup/references/bundletool/bundletool-validation.md` for version evidence and completion criteria. +1. `contexts/platform/android/references/bundletool/decision-logic.md` for optional-use gates and install triggers. +2. `contexts/platform/android/references/bundletool/install.md` for download and PATH setup. +3. `contexts/platform/android/references/bundletool/validation.md` for version evidence and completion criteria. ## Validation Command diff --git a/contexts/tools/appium/setup/android-decision-logic.md b/contexts/platform/android/decision-logic.md similarity index 96% rename from contexts/tools/appium/setup/android-decision-logic.md rename to contexts/platform/android/decision-logic.md index 8dbdd09..0323865 100644 --- a/contexts/tools/appium/setup/android-decision-logic.md +++ b/contexts/platform/android/decision-logic.md @@ -2,7 +2,7 @@ owner: appium id: setup-references-android-android-decision-logic status: stable -source: contexts/tools/appium/setup/android-decision-logic.md +source: contexts/platform/android/decision-logic.md --- diff --git a/contexts/tools/appium/setup/references/environment-setup-android.md b/contexts/platform/android/emulator-setup.md similarity index 60% rename from contexts/tools/appium/setup/references/environment-setup-android.md rename to contexts/platform/android/emulator-setup.md index cfee114..32b56ab 100644 --- a/contexts/tools/appium/setup/references/environment-setup-android.md +++ b/contexts/platform/android/emulator-setup.md @@ -1,13 +1,13 @@ --- owner: appium -id: appium.setup.references.environment-setup-android -name: "environment-setup-android" -description: "Route Android SDK, Java, ADB, package, and emulator setup references for Appium Android drivers" +id: platform.android.emulator-setup +name: "android-emulator-setup" +description: "Route Android SDK, Java, ADB, package, device, and emulator setup references for Android automation" last_modified: "Mon, 27 Apr 2026 GMT" --- -# environment-setup-android +# Android Emulator Setup ## Goal @@ -17,12 +17,12 @@ Prepare Android automation by validating Java, Android SDK command-line tools, S Load these references in order: -1. `contexts/tools/appium/setup/android-decision-logic.md` for supported hosts, preservation rules, optional dependency boundaries, and install triggers. -2. `android/android-detect-base-tooling.md` for OS, Java, Android SDK, ADB, and emulator binary detection. -3. `android/android-sdk-commandline-tools.md` for platform default SDK paths and command-line tools bootstrap. -4. `android/android-java-configuration.md` for Java setup only when `java` or `javac` is missing. -5. `android/android-sdk-packages-and-path.md` for `ANDROID_HOME`, `PATH`, licenses, and required SDK packages. -6. `android/android-device-emulator-validation.md` for device inventory, emulator creation, final validation, and evidence. +1. `contexts/platform/android/decision-logic.md` for supported hosts, preservation rules, optional dependency boundaries, and install triggers. +2. `contexts/platform/android/references/detect-base-tooling.md` for OS, Java, Android SDK, ADB, and emulator binary detection. +3. `contexts/platform/android/references/sdk-commandline-tools.md` for platform default SDK paths and command-line tools bootstrap. +4. `contexts/platform/android/references/java-configuration.md` for Java setup only when `java` or `javac` is missing. +5. `contexts/platform/android/references/sdk-packages-and-path.md` for `ANDROID_HOME`, `PATH`, licenses, and required SDK packages. +6. `contexts/platform/android/references/device-emulator-validation.md` for device inventory, emulator creation, final validation, and evidence. For deterministic read-only validation, run: diff --git a/contexts/tools/appium/setup/profiles/android.md b/contexts/platform/android/profile.md similarity index 100% rename from contexts/tools/appium/setup/profiles/android.md rename to contexts/platform/android/profile.md diff --git a/contexts/tools/appium/setup/references/bundletool/bundletool-decision-logic.md b/contexts/platform/android/references/bundletool/decision-logic.md similarity index 91% rename from contexts/tools/appium/setup/references/bundletool/bundletool-decision-logic.md rename to contexts/platform/android/references/bundletool/decision-logic.md index 3c361d2..bb78d1e 100644 --- a/contexts/tools/appium/setup/references/bundletool/bundletool-decision-logic.md +++ b/contexts/platform/android/references/bundletool/decision-logic.md @@ -1,8 +1,9 @@ --- owner: appium -id: appium.setup.references.bundletool.bundletool-decision-logic +id: platform.android.bundletool.decision-logic name: "bundletool-decision-logic" description: "Optional bundletool setup gates and install triggers" +status: stable --- diff --git a/contexts/tools/appium/setup/references/bundletool/bundletool-install.md b/contexts/platform/android/references/bundletool/install.md similarity index 94% rename from contexts/tools/appium/setup/references/bundletool/bundletool-install.md rename to contexts/platform/android/references/bundletool/install.md index 1979411..f4df237 100644 --- a/contexts/tools/appium/setup/references/bundletool/bundletool-install.md +++ b/contexts/platform/android/references/bundletool/install.md @@ -1,8 +1,9 @@ --- owner: appium -id: appium.setup.references.bundletool.bundletool-install +id: platform.android.bundletool.install name: "bundletool-install" description: "Download bundletool.jar from official GitHub releases and place it on user PATH" +status: stable --- diff --git a/contexts/tools/appium/setup/references/bundletool/bundletool-validation.md b/contexts/platform/android/references/bundletool/validation.md similarity index 90% rename from contexts/tools/appium/setup/references/bundletool/bundletool-validation.md rename to contexts/platform/android/references/bundletool/validation.md index 9065827..70122ef 100644 --- a/contexts/tools/appium/setup/references/bundletool/bundletool-validation.md +++ b/contexts/platform/android/references/bundletool/validation.md @@ -1,8 +1,9 @@ --- owner: appium -id: appium.setup.references.bundletool.bundletool-validation +id: platform.android.bundletool.validation name: "bundletool-validation" description: "Validate bundletool.jar path, version, and setup evidence" +status: stable --- diff --git a/contexts/tools/appium/setup/references/android/android-detect-base-tooling.md b/contexts/platform/android/references/detect-base-tooling.md similarity index 100% rename from contexts/tools/appium/setup/references/android/android-detect-base-tooling.md rename to contexts/platform/android/references/detect-base-tooling.md diff --git a/contexts/tools/appium/setup/references/android/android-device-emulator-validation.md b/contexts/platform/android/references/device-emulator-validation.md similarity index 100% rename from contexts/tools/appium/setup/references/android/android-device-emulator-validation.md rename to contexts/platform/android/references/device-emulator-validation.md diff --git a/contexts/tools/appium/setup/references/android/android-java-configuration.md b/contexts/platform/android/references/java-configuration.md similarity index 100% rename from contexts/tools/appium/setup/references/android/android-java-configuration.md rename to contexts/platform/android/references/java-configuration.md diff --git a/contexts/tools/appium/setup/references/android/android-sdk-commandline-tools.md b/contexts/platform/android/references/sdk-commandline-tools.md similarity index 100% rename from contexts/tools/appium/setup/references/android/android-sdk-commandline-tools.md rename to contexts/platform/android/references/sdk-commandline-tools.md diff --git a/contexts/tools/appium/setup/references/android/android-sdk-packages-and-path.md b/contexts/platform/android/references/sdk-packages-and-path.md similarity index 100% rename from contexts/tools/appium/setup/references/android/android-sdk-packages-and-path.md rename to contexts/platform/android/references/sdk-packages-and-path.md diff --git a/contexts/tools/appium/setup/references/environment-setup-xcuitest.md b/contexts/platform/ios/simulator-setup.md similarity index 75% rename from contexts/tools/appium/setup/references/environment-setup-xcuitest.md rename to contexts/platform/ios/simulator-setup.md index a3f8b05..a4e9aae 100644 --- a/contexts/tools/appium/setup/references/environment-setup-xcuitest.md +++ b/contexts/platform/ios/simulator-setup.md @@ -1,12 +1,12 @@ --- owner: appium -id: appium.setup.references.environment-setup-xcuitest -name: "environment-setup-xcuitest" -description: "Route macOS XCUITest Appium driver setup, Xcode validation, doctor checks, and smoke tests" +id: platform.ios.simulator-setup +name: "ios-simulator-setup" +description: "Route iOS simulator, Xcode, XCUITest driver, doctor, and smoke validation setup" --- -# appium-xcuitest-environment-setup +# iOS Simulator Setup ## Goal @@ -16,9 +16,9 @@ Prepare Appium XCUITest on macOS by validating Node/Appium, Xcode, driver instal Load these references in order: -1. `contexts/tools/appium/setup/node-environment.md` for Node.js and npm. +1. `contexts/tools/appium/setup-basics.md` for Node.js and npm. 2. `contexts/tools/appium/setup/references/xcuitest/xcuitest-decision-logic.md` for macOS-only setup gates and optional dependency boundaries. -3. `contexts/tools/appium/setup/references/xcuitest/xcuitest-xcode-prereqs.md` for Xcode, command-line tools, license, and first-launch checks. +3. `contexts/platform/macos/xcode-prereqs.md` for Xcode, command-line tools, license, and first-launch checks. 4. `contexts/tools/appium/setup/references/xcuitest/xcuitest-driver-doctor.md` for driver install and doctor pass criteria. 5. `contexts/tools/appium/setup/references/xcuitest/xcuitest-smoke-status.md` for simulator inventory, `/status`, log evidence, and cleanup. diff --git a/contexts/tools/appium/setup/profiles/linux.md b/contexts/platform/linux/profile.md similarity index 87% rename from contexts/tools/appium/setup/profiles/linux.md rename to contexts/platform/linux/profile.md index d61114e..4f4a90b 100644 --- a/contexts/tools/appium/setup/profiles/linux.md +++ b/contexts/platform/linux/profile.md @@ -1,13 +1,12 @@ --- owner: appium -id: appium.setup.profiles.linux +id: platform.linux.profile +status: stable --- # Linux Setup Profile -Base skill: `skills/setup/SKILL.md` - Use this profile when setup is running on Linux. - Prefer user-space installs and require explicit human approval before privileged package-manager elevation. diff --git a/contexts/tools/appium/setup/profiles/macos.md b/contexts/platform/macos/profile.md similarity index 90% rename from contexts/tools/appium/setup/profiles/macos.md rename to contexts/platform/macos/profile.md index 61c3435..896fffe 100644 --- a/contexts/tools/appium/setup/profiles/macos.md +++ b/contexts/platform/macos/profile.md @@ -1,13 +1,12 @@ --- owner: appium -id: appium.setup.profiles.macos +id: platform.macos.profile +status: stable --- # macOS Setup Profile -Base skill: `skills/setup/SKILL.md` - Use this profile when setup is running on macOS. - Prefer user-space installs and require explicit human approval before privileged elevation. diff --git a/contexts/tools/appium/setup/references/mac2/mac2-xcode-prereqs.md b/contexts/platform/macos/xcode-command-line-tools.md similarity index 80% rename from contexts/tools/appium/setup/references/mac2/mac2-xcode-prereqs.md rename to contexts/platform/macos/xcode-command-line-tools.md index 37d4d44..12f6141 100644 --- a/contexts/tools/appium/setup/references/mac2/mac2-xcode-prereqs.md +++ b/contexts/platform/macos/xcode-command-line-tools.md @@ -1,12 +1,13 @@ --- owner: appium -id: appium.setup.references.mac2.mac2-xcode-prereqs -name: "mac2-xcode-prereqs" -description: "Validate Xcode and macOS command-line tooling for Appium Mac2 Driver" +id: platform.macos.xcode-command-line-tools +name: "macos-xcode-command-line-tools" +description: "Validate Xcode and macOS command-line tooling for macOS automation" +status: stable --- -# mac2-xcode-prereqs +# macOS Xcode Command-Line Tools ## Read-Only Checks diff --git a/contexts/tools/appium/setup/references/xcuitest/xcuitest-xcode-prereqs.md b/contexts/platform/macos/xcode-prereqs.md similarity index 82% rename from contexts/tools/appium/setup/references/xcuitest/xcuitest-xcode-prereqs.md rename to contexts/platform/macos/xcode-prereqs.md index eed12bb..3a6d077 100644 --- a/contexts/tools/appium/setup/references/xcuitest/xcuitest-xcode-prereqs.md +++ b/contexts/platform/macos/xcode-prereqs.md @@ -1,12 +1,13 @@ --- owner: appium -id: appium.setup.references.xcuitest.xcuitest-xcode-prereqs -name: "xcuitest-xcode-prereqs" +id: platform.macos.xcode-prereqs +name: "macos-xcode-prereqs" description: "Validate Xcode, command-line tools, license, first launch, and simulator inventory" +status: stable --- -# xcuitest-xcode-prereqs +# macOS Xcode Prerequisites ## Xcode Checks diff --git a/contexts/tools/appium/setup/profiles/windows.md b/contexts/platform/windows/profile.md similarity index 86% rename from contexts/tools/appium/setup/profiles/windows.md rename to contexts/platform/windows/profile.md index dca02ce..de3e8ff 100644 --- a/contexts/tools/appium/setup/profiles/windows.md +++ b/contexts/platform/windows/profile.md @@ -1,13 +1,12 @@ --- owner: appium -id: appium.setup.profiles.windows +id: platform.windows.profile +status: stable --- # Windows Setup Profile -Base skill: `skills/setup/SKILL.md` - Use this profile when setup is running on Windows or PowerShell. - Prefer `winget` for Node.js manager setup when no maintained version manager exists. diff --git a/contexts/tools/appium/capabilities.md b/contexts/tools/appium/capabilities.md new file mode 100644 index 0000000..21fc0f3 --- /dev/null +++ b/contexts/tools/appium/capabilities.md @@ -0,0 +1,23 @@ +--- +owner: appium +id: appium.capabilities +status: experimental +--- + +# Appium Capabilities + +## Goal + +Use this context when a workflow needs shared Appium capability guidance that is not specific to one setup or troubleshooting procedure. + +## Rules + +- Identify `platformName` and `appium:automationName` before selecting a driver-specific setup, troubleshooting, or real-device route. +- Keep capability changes narrow and tied to the observed failure, requested feature, or validated device mode. +- Prefer W3C namespaced Appium capabilities such as `appium:automationName`, `appium:deviceName`, `appium:app`, and `appium:platformVersion`. +- Do not use optional capability families such as media recording, app bundle handling, or prebuilt WebDriverAgent unless the user explicitly asks for the related feature or the selected route requires it. +- For real iOS or tvOS devices, load `skills/xcuitest-real-device-config/SKILL.md` before recommending signing, provisioning, or WebDriverAgent deployment capabilities. + +## Evidence To Report + +Report the smallest relevant capabilities block, the driver or platform assumption it depends on, and any optional capability that was intentionally skipped. diff --git a/contexts/tools/appium/real-device/examples/real-device.md b/contexts/tools/appium/real-device/examples/real-device.md index 9017664..e657887 100644 --- a/contexts/tools/appium/real-device/examples/real-device.md +++ b/contexts/tools/appium/real-device/examples/real-device.md @@ -9,10 +9,10 @@ id: appium.real-device.examples.real-device Use this repository's skills to prepare macOS + XCUITest for a real iOS or tvOS device. 1. Load `skills/setup/SKILL.md`. -2. Load `contexts/tools/appium/setup/profiles/macos.md`. +2. Load `contexts/platform/macos/profile.md`. 3. Load `contexts/tools/appium/setup/profiles/xcuitest.md`. -4. Load `contexts/tools/appium/setup/node-environment.md`. -5. Load `contexts/tools/appium/setup/references/environment-setup-xcuitest.md`. +4. Load `contexts/tools/appium/setup-basics.md`. +5. Load `contexts/platform/ios/simulator-setup.md`. 6. Load `skills/xcuitest-real-device-config/SKILL.md`. 7. Load the signing and WDA deployment profiles that match the user's path. 8. Load `contexts/tools/appium/real-device/references/real-device-procedure-part1.md`, `contexts/tools/appium/real-device/references/real-device-procedure-part2.md`, `contexts/tools/appium/real-device/references/real-device-procedure-part3.md`, `contexts/tools/appium/real-device/references/real-device-procedure-part4.md`, `contexts/tools/appium/real-device/references/real-device-procedure-part5.md`, `contexts/tools/appium/real-device/references/real-device-procedure-part6.md`, `contexts/tools/appium/real-device/references/real-device-procedure-part7.md`, `contexts/tools/appium/real-device/references/real-device-procedure-part8.md`, and `contexts/tools/appium/real-device/references/real-device-procedure-part9.md` in order. diff --git a/contexts/tools/appium/setup/node-environment.md b/contexts/tools/appium/setup-basics.md similarity index 83% rename from contexts/tools/appium/setup/node-environment.md rename to contexts/tools/appium/setup-basics.md index 1f5c5bc..09118bd 100644 --- a/contexts/tools/appium/setup/node-environment.md +++ b/contexts/tools/appium/setup-basics.md @@ -1,16 +1,16 @@ --- owner: appium -id: setup-references-environment-setup-node +id: appium.setup.basics status: stable -source: contexts/tools/appium/setup/node-environment.md +source: contexts/tools/appium/setup-basics.md --- -# Node Environment +# Appium Setup Basics ## Goal -Prepare a stable Node.js and npm environment by validating the active runtime, npm availability, registry connectivity, and engine compatibility needed by Appium setup workflows. +Prepare the shared Appium setup baseline by validating the active Node.js runtime, npm availability, registry connectivity, command mode, and engine compatibility needed by Appium setup workflows. ## Routing diff --git a/contexts/tools/appium/setup/espresso-environment.md b/contexts/tools/appium/setup/espresso-environment.md index f5c0aaa..deadc67 100644 --- a/contexts/tools/appium/setup/espresso-environment.md +++ b/contexts/tools/appium/setup/espresso-environment.md @@ -16,8 +16,8 @@ Prepare Appium Espresso by checking Node/Appium, Android prerequisites, driver i Load these references in order: -1. First load `contexts/tools/appium/setup/node-environment.md` to validate Node.js and npm. -2. Then load `contexts/tools/appium/setup/references/environment-setup-android.md` to validate Java, Android SDK, ADB, emulator, and SDK packages. +1. First load `contexts/tools/appium/setup-basics.md` to validate Node.js and npm. +2. Then load `contexts/platform/android/emulator-setup.md` to validate Java, Android SDK, ADB, emulator, and SDK packages. 3. `contexts/tools/appium/setup/references/espresso/espresso-decision-logic.md` for driver setup triggers and optional dependency boundaries. 4. `contexts/tools/appium/setup/references/espresso/espresso-driver-install.md` for global Appium and Espresso driver installation. 5. `contexts/tools/appium/setup/references/espresso/espresso-doctor-validation.md` for required doctor pass criteria. diff --git a/contexts/tools/appium/setup/examples/chromium.md b/contexts/tools/appium/setup/examples/chromium.md index d38c1f6..5110ea5 100644 --- a/contexts/tools/appium/setup/examples/chromium.md +++ b/contexts/tools/appium/setup/examples/chromium.md @@ -11,7 +11,7 @@ Use this repository's skills to prepare Appium Chromium Driver for desktop brows 1. Load `skills/setup/SKILL.md`. 2. Load `contexts/tools/appium/setup/profiles/global-appium.md` unless the user requests local mode. 3. Load `contexts/tools/appium/setup/profiles/chromium.md`. -4. Load `contexts/tools/appium/setup/node-environment.md`. +4. Load `contexts/tools/appium/setup-basics.md`. 5. Load `contexts/tools/appium/setup/references/environment-setup-chromium.md`. Rules: diff --git a/contexts/tools/appium/setup/examples/espresso.md b/contexts/tools/appium/setup/examples/espresso.md index b27d360..601cabc 100644 --- a/contexts/tools/appium/setup/examples/espresso.md +++ b/contexts/tools/appium/setup/examples/espresso.md @@ -10,9 +10,9 @@ Use this repository's skills to prepare Android + Espresso. 1. Load `skills/setup/SKILL.md`. 2. Load `contexts/tools/appium/setup/profiles/global-appium.md` unless the user requests local mode. -3. Load `contexts/tools/appium/setup/profiles/android.md`. -4. Load `contexts/tools/appium/setup/node-environment.md`. -5. Load `contexts/tools/appium/setup/references/environment-setup-android.md`. +3. Load `contexts/platform/android/profile.md`. +4. Load `contexts/tools/appium/setup-basics.md`. +5. Load `contexts/platform/android/emulator-setup.md`. 6. Load `contexts/tools/appium/setup/espresso-environment.md`. Rules: diff --git a/contexts/tools/appium/setup/examples/gecko.md b/contexts/tools/appium/setup/examples/gecko.md index c1b54e7..7290af2 100644 --- a/contexts/tools/appium/setup/examples/gecko.md +++ b/contexts/tools/appium/setup/examples/gecko.md @@ -11,7 +11,7 @@ Use skills to prepare Appium Gecko Driver for Firefox desktop automation. 1. Load `skills/setup/SKILL.md`. 2. Load `contexts/tools/appium/setup/profiles/global-appium.md` unless the user explicitly requested `npx appium`. 3. Load `contexts/tools/appium/setup/profiles/gecko.md`. -4. Load `contexts/tools/appium/setup/node-environment.md`. +4. Load `contexts/tools/appium/setup-basics.md`. 5. Load `contexts/tools/appium/setup/gecko-environment.md`. Rules: diff --git a/contexts/tools/appium/setup/examples/mac2.md b/contexts/tools/appium/setup/examples/mac2.md index 65b3445..88d523f 100644 --- a/contexts/tools/appium/setup/examples/mac2.md +++ b/contexts/tools/appium/setup/examples/mac2.md @@ -10,9 +10,9 @@ Use skills to prepare Appium Mac2 Driver for macOS desktop app automation. 1. Load `skills/setup/SKILL.md`. 2. Load `contexts/tools/appium/setup/profiles/global-appium.md` unless the user explicitly requested `npx appium`. -3. Load `contexts/tools/appium/setup/profiles/macos.md`. +3. Load `contexts/platform/macos/profile.md`. 4. Load `contexts/tools/appium/setup/profiles/mac2.md`. -5. Load `contexts/tools/appium/setup/node-environment.md`. +5. Load `contexts/tools/appium/setup-basics.md`. 6. Load `contexts/tools/appium/setup/mac2-environment.md`. Rules: diff --git a/contexts/tools/appium/setup/examples/safari.md b/contexts/tools/appium/setup/examples/safari.md index ce2597c..bb52fd8 100644 --- a/contexts/tools/appium/setup/examples/safari.md +++ b/contexts/tools/appium/setup/examples/safari.md @@ -10,10 +10,11 @@ Appium Safari Driver on macOS. 1. Load `skills/setup/SKILL.md`. 2. Load `contexts/tools/appium/setup/profiles/global-appium.md` unless the user explicitly asks for local `npx appium`. -3. Load `contexts/tools/appium/setup/profiles/macos.md`. +3. Load `contexts/platform/macos/profile.md`. 4. Load `contexts/tools/appium/setup/profiles/safari.md`. -5. Load `contexts/tools/appium/setup/node-environment.md`. -6. Load `contexts/tools/appium/setup/references/environment-setup-safari.md`. +5. Load `contexts/tools/appium/setup-basics.md`. +6. Load `contexts/browser/safari/prereqs.md`. +7. Load `contexts/tools/appium/setup/references/environment-setup-safari.md`. Rules: diff --git a/contexts/tools/appium/setup/examples/uiautomator2.md b/contexts/tools/appium/setup/examples/uiautomator2.md index d857f72..7da4929 100644 --- a/contexts/tools/appium/setup/examples/uiautomator2.md +++ b/contexts/tools/appium/setup/examples/uiautomator2.md @@ -10,9 +10,9 @@ Use this repository's skills to prepare Android + UiAutomator2. 1. Load `skills/setup/SKILL.md`. 2. Load `contexts/tools/appium/setup/profiles/global-appium.md` unless the user requests local mode. -3. Load `contexts/tools/appium/setup/profiles/android.md`. -4. Load `contexts/tools/appium/setup/node-environment.md`. -5. Load `contexts/tools/appium/setup/references/environment-setup-android.md`. +3. Load `contexts/platform/android/profile.md`. +4. Load `contexts/tools/appium/setup-basics.md`. +5. Load `contexts/platform/android/emulator-setup.md`. 6. Load `contexts/tools/appium/setup/uiautomator2-environment.md`. Smoke test: diff --git a/contexts/tools/appium/setup/examples/xcuitest.md b/contexts/tools/appium/setup/examples/xcuitest.md index fb46878..cc03624 100644 --- a/contexts/tools/appium/setup/examples/xcuitest.md +++ b/contexts/tools/appium/setup/examples/xcuitest.md @@ -9,10 +9,10 @@ id: appium.setup.examples.xcuitest Use this repository's skills to prepare macOS + XCUITest. 1. Load `skills/setup/SKILL.md`. -2. Load `contexts/tools/appium/setup/profiles/macos.md`. +2. Load `contexts/platform/macos/profile.md`. 3. Load `contexts/tools/appium/setup/profiles/xcuitest.md`. -4. Load `contexts/tools/appium/setup/node-environment.md`. -5. Load `contexts/tools/appium/setup/references/environment-setup-xcuitest.md`. +4. Load `contexts/tools/appium/setup-basics.md`. +5. Load `contexts/platform/ios/simulator-setup.md`. Rules: diff --git a/contexts/tools/appium/setup/gecko-environment.md b/contexts/tools/appium/setup/gecko-environment.md index d44d3c1..2c5cd73 100644 --- a/contexts/tools/appium/setup/gecko-environment.md +++ b/contexts/tools/appium/setup/gecko-environment.md @@ -13,9 +13,9 @@ Prepare Appium Gecko Driver by validating Node/Appium, Firefox availability, dri ## Routing -1. `contexts/tools/appium/setup/node-environment.md` for Node.js and npm. +1. `contexts/tools/appium/setup-basics.md` for Node.js and npm. 2. `contexts/tools/appium/setup/references/gecko/gecko-decision-logic.md` for host, Appium, Firefox, and GeckoDriver gates. -3. `contexts/tools/appium/setup/references/gecko/gecko-browser-prereqs.md` for Firefox release, ESR, Developer Edition, Nightly, and Linux dependency setup. +3. `contexts/browser/firefox/prereqs.md` for Firefox release, ESR, Developer Edition, Nightly, and Linux dependency setup. 4. `contexts/tools/appium/setup/references/gecko/gecko-driver-validation.md` for Appium driver installation and doctor handling. 5. `contexts/tools/appium/setup/references/gecko/gecko-smoke-status.md` for `/status`, log evidence, and cleanup. diff --git a/contexts/tools/appium/setup/mac2-environment.md b/contexts/tools/appium/setup/mac2-environment.md index d616ee2..9488711 100644 --- a/contexts/tools/appium/setup/mac2-environment.md +++ b/contexts/tools/appium/setup/mac2-environment.md @@ -14,9 +14,9 @@ Prepare Appium Mac2 Driver by validating macOS, Node/Appium, Xcode tooling, driv ## Routing -1. `contexts/tools/appium/setup/node-environment.md` for Node.js and npm. +1. `contexts/tools/appium/setup-basics.md` for Node.js and npm. 2. `contexts/tools/appium/setup/references/mac2/mac2-decision-logic.md` for macOS-only setup gates and authorization boundaries. -3. `contexts/tools/appium/setup/references/mac2/mac2-xcode-prereqs.md` for Xcode command-line tools, license, and first-launch checks. +3. `contexts/platform/macos/xcode-command-line-tools.md` for Xcode command-line tools, license, and first-launch checks. 4. `contexts/tools/appium/setup/references/mac2/mac2-driver-doctor.md` for driver installation and doctor pass criteria. 5. `contexts/tools/appium/setup/references/mac2/mac2-smoke-status.md` for `/status`, log evidence, and cleanup. diff --git a/contexts/tools/appium/setup/references/chromium/chromium-decision-logic.md b/contexts/tools/appium/setup/references/chromium/chromium-decision-logic.md index 7571714..663365b 100644 --- a/contexts/tools/appium/setup/references/chromium/chromium-decision-logic.md +++ b/contexts/tools/appium/setup/references/chromium/chromium-decision-logic.md @@ -11,7 +11,7 @@ description: "Chromium Appium setup triggers, browser gates, and driver validati ## Decision Logic - If host OS is not macOS, Linux, or Windows: stop. -- If Node.js or npm does not satisfy Appium/Chromium driver engines: run `contexts/tools/appium/setup/node-environment.md`. +- If Node.js or npm does not satisfy Appium/Chromium driver engines: run `contexts/tools/appium/setup-basics.md`. - If Appium CLI is missing or Appium major version is `< 3`: install or upgrade global Appium. - If `chromium` driver is missing: install it with Appium CLI. - If no Chrome, Chromium, or Edge browser is available: install one appropriate to the host. diff --git a/contexts/tools/appium/setup/references/environment-setup-chromium.md b/contexts/tools/appium/setup/references/environment-setup-chromium.md index 85a910d..fc56bf8 100644 --- a/contexts/tools/appium/setup/references/environment-setup-chromium.md +++ b/contexts/tools/appium/setup/references/environment-setup-chromium.md @@ -16,9 +16,9 @@ Prepare Appium Chromium Driver by validating Node/Appium, browser availability, Load these references in order: -1. `contexts/tools/appium/setup/node-environment.md` for Node.js and npm. +1. `contexts/tools/appium/setup-basics.md` for Node.js and npm. 2. `contexts/tools/appium/setup/references/chromium/chromium-decision-logic.md` for host, Appium, browser, and Edge-driver gates. -3. `contexts/tools/appium/setup/references/chromium/chromium-browser-prereqs.md` for Chrome, Chromium, Edge, and Linux dependency setup. +3. `contexts/browser/chromium/prereqs.md` for Chrome, Chromium, Edge, and Linux dependency setup. 4. `contexts/tools/appium/setup/references/chromium/chromium-driver-validation.md` for Appium driver installation and doctor handling. 5. `contexts/tools/appium/setup/references/chromium/chromium-smoke-status.md` for `/status`, log evidence, and cleanup. diff --git a/contexts/tools/appium/setup/references/environment-setup-safari.md b/contexts/tools/appium/setup/references/environment-setup-safari.md index 24dc920..f9dd2c1 100644 --- a/contexts/tools/appium/setup/references/environment-setup-safari.md +++ b/contexts/tools/appium/setup/references/environment-setup-safari.md @@ -10,16 +10,17 @@ description: "Route Appium Safari driver setup for macOS Safari and optional iOS ## Goal -Prepare Appium Safari Driver by validating macOS, Node/Appium, `safaridriver`, Safari driver installation, optional doctor behavior, and smoke checks. +Prepare Appium Safari Driver by validating macOS, Node/Appium, Safari prerequisites, Safari driver installation, optional doctor behavior, and smoke checks. ## Routing Load these references in order: -1. `contexts/tools/appium/setup/node-environment.md` for Node.js and npm. +1. `contexts/tools/appium/setup-basics.md` for Node.js and npm. 2. `contexts/tools/appium/setup/references/safari/safari-decision-logic.md` for macOS-only gates and authorization boundaries. -3. `contexts/tools/appium/setup/references/safari/safari-driver-install.md` for Appium Safari driver installation and `safaridriver` checks. -4. `contexts/tools/appium/setup/references/safari/safari-smoke-status.md` for `/status`, log evidence, and cleanup. +3. `contexts/browser/safari/prereqs.md` for Safari and `safaridriver` availability plus authorization boundaries. +4. `contexts/tools/appium/setup/references/safari/safari-driver-install.md` for Appium Safari driver installation. +5. `contexts/tools/appium/setup/references/safari/safari-smoke-status.md` for `/status`, log evidence, and cleanup. ## Validation Command diff --git a/contexts/tools/appium/setup/references/espresso/espresso-decision-logic.md b/contexts/tools/appium/setup/references/espresso/espresso-decision-logic.md index 04063e4..b6822b6 100644 --- a/contexts/tools/appium/setup/references/espresso/espresso-decision-logic.md +++ b/contexts/tools/appium/setup/references/espresso/espresso-decision-logic.md @@ -11,7 +11,7 @@ description: "Espresso setup triggers, dependency order, optional boundaries, an ## Decision Logic - If host OS is not macOS, Linux, or Windows: stop. -- Before Espresso-specific steps, complete the shared Node/Appium setup in `contexts/tools/appium/setup/node-environment.md` and the Android prerequisite checks in `contexts/tools/appium/setup/references/environment-setup-android.md`. +- Before Espresso-specific steps, complete the shared Node/Appium setup in `contexts/tools/appium/setup-basics.md` and the Android prerequisite checks in `contexts/platform/android/emulator-setup.md`. - Use global npm/Appium unless the user explicitly asks for `npx appium`. - If Appium CLI is missing: install `appium` globally under the active Node runtime. - If the `espresso` driver is not installed: install it with Appium CLI. diff --git a/contexts/tools/appium/setup/references/gecko/gecko-decision-logic.md b/contexts/tools/appium/setup/references/gecko/gecko-decision-logic.md index 16fce25..84c053c 100644 --- a/contexts/tools/appium/setup/references/gecko/gecko-decision-logic.md +++ b/contexts/tools/appium/setup/references/gecko/gecko-decision-logic.md @@ -17,7 +17,7 @@ description: "Decide Gecko setup path from host OS, Appium mode, Firefox channel ## Required Gates -1. Node.js and npm satisfy `contexts/tools/appium/setup/node-environment.md`. +1. Node.js and npm satisfy `contexts/tools/appium/setup-basics.md`. 2. `appium -v` succeeds and Appium major version is `>= 3`. 3. `appium driver list --installed` includes `gecko`. 4. A Firefox executable is available or the user provides one through capabilities. @@ -32,4 +32,4 @@ Appium Gecko Driver can manage GeckoDriver in normal flows, but an externally in - If Firefox is missing, ask before installing it. - If the user provides a Firefox executable path, validate that path before installing another browser. - If doctor is unsupported, continue only when Appium version, driver installation, Firefox availability, and smoke checks pass. -- If Linux browser startup fails, load `gecko-browser-prereqs.md` and validate shared library/display prerequisites before retrying sessions. +- If Linux browser startup fails, load `contexts/browser/firefox/prereqs.md` and validate shared library/display prerequisites before retrying sessions. diff --git a/contexts/tools/appium/setup/references/mac2/mac2-decision-logic.md b/contexts/tools/appium/setup/references/mac2/mac2-decision-logic.md index 2ed337f..44655d3 100644 --- a/contexts/tools/appium/setup/references/mac2/mac2-decision-logic.md +++ b/contexts/tools/appium/setup/references/mac2/mac2-decision-logic.md @@ -17,8 +17,8 @@ description: "Decide Mac2 setup path from macOS host, Appium mode, Xcode state, ## Required Gates -1. Node.js and npm satisfy `contexts/tools/appium/setup/node-environment.md`. -2. Xcode tooling satisfies `mac2-xcode-prereqs.md`. +1. Node.js and npm satisfy `contexts/tools/appium/setup-basics.md`. +2. Xcode tooling satisfies `contexts/platform/macos/xcode-command-line-tools.md`. 3. `appium -v` succeeds and Appium major version is `>= 3`. 4. `appium driver list --installed` includes `mac2`. 5. `appium driver doctor mac2` reports `0 required fixes needed`. diff --git a/contexts/tools/appium/setup/references/safari/safari-decision-logic.md b/contexts/tools/appium/setup/references/safari/safari-decision-logic.md index 35818e6..80861f3 100644 --- a/contexts/tools/appium/setup/references/safari/safari-decision-logic.md +++ b/contexts/tools/appium/setup/references/safari/safari-decision-logic.md @@ -11,8 +11,7 @@ description: "macOS-only Safari Appium setup gates and authorization boundaries" ## Decision Logic - If host OS is not macOS: stop. -- If Node.js or npm needs repair: run `contexts/tools/appium/setup/node-environment.md`. +- If Node.js or npm needs repair: run `contexts/tools/appium/setup-basics.md`. - If Appium CLI is missing or Appium major version is `< 3`: install or upgrade global Appium. -- If `safaridriver` is missing: stop and repair Safari/macOS tooling. -- Run `safaridriver --enable` only when Safari automation is not enabled and the user can accept the macOS authorization prompt. +- Validate Safari browser prerequisites with `contexts/browser/safari/prereqs.md`. - If the `safari` Appium driver is missing: install it with Appium CLI. diff --git a/contexts/tools/appium/setup/references/safari/safari-driver-install.md b/contexts/tools/appium/setup/references/safari/safari-driver-install.md index 7c00814..a8e33a6 100644 --- a/contexts/tools/appium/setup/references/safari/safari-driver-install.md +++ b/contexts/tools/appium/setup/references/safari/safari-driver-install.md @@ -2,19 +2,12 @@ owner: appium id: appium.setup.references.safari.safari-driver-install name: "safari-driver-install" -description: "Install and validate Appium Safari driver and safaridriver" +description: "Install and validate Appium Safari driver" --- # safari-driver-install -## Validate Safari Tooling - -```bash -sw_vers -safaridriver --version -``` - ## Install Driver ```bash @@ -23,4 +16,4 @@ appium driver install safari appium driver list --installed --json ``` -The installed list must include `safari`. If doctor is supported for the installed driver, required fixes must be zero; otherwise report `not-supported`. +The installed list must include `safari`. Safari browser prerequisites must satisfy `contexts/browser/safari/prereqs.md`. If doctor is supported for the installed driver, required fixes must be zero; otherwise report `not-supported`. diff --git a/contexts/tools/appium/setup/references/support-inventory.md b/contexts/tools/appium/setup/references/support-inventory.md index 9c8518d..3f7158e 100644 --- a/contexts/tools/appium/setup/references/support-inventory.md +++ b/contexts/tools/appium/setup/references/support-inventory.md @@ -13,14 +13,18 @@ Static reachability for nested setup support files: - `contexts/tools/appium/setup/references/espresso/espresso-doctor-validation.md` - `contexts/tools/appium/setup/references/espresso/espresso-driver-install.md` - `contexts/tools/appium/setup/references/espresso/espresso-smoke-status.md` -- `contexts/tools/appium/setup/references/gecko/gecko-browser-prereqs.md` +- `contexts/tools/ffmpeg/setup.md` +- `contexts/browser/firefox/prereqs.md` +- `contexts/browser/safari/prereqs.md` - `contexts/tools/appium/setup/references/gecko/gecko-decision-logic.md` - `contexts/tools/appium/setup/references/gecko/gecko-driver-validation.md` - `contexts/tools/appium/setup/references/gecko/gecko-smoke-status.md` - `contexts/tools/appium/setup/references/mac2/mac2-decision-logic.md` - `contexts/tools/appium/setup/references/mac2/mac2-driver-doctor.md` - `contexts/tools/appium/setup/references/mac2/mac2-smoke-status.md` -- `contexts/tools/appium/setup/references/mac2/mac2-xcode-prereqs.md` +- `contexts/platform/linux/profile.md` +- `contexts/platform/macos/xcode-command-line-tools.md` +- `contexts/platform/windows/profile.md` - `contexts/tools/appium/setup/references/node/node-decision-logic.md` - `contexts/tools/appium/setup/references/node/node-npm-health.md` - `contexts/tools/appium/setup/references/node/node-validation-evidence.md` diff --git a/contexts/tools/appium/setup/references/uiautomator2/uiautomator2-decision-logic.md b/contexts/tools/appium/setup/references/uiautomator2/uiautomator2-decision-logic.md index d88d2e0..8c21d47 100644 --- a/contexts/tools/appium/setup/references/uiautomator2/uiautomator2-decision-logic.md +++ b/contexts/tools/appium/setup/references/uiautomator2/uiautomator2-decision-logic.md @@ -11,7 +11,7 @@ description: "UiAutomator2 setup triggers, dependency order, optional boundaries ## Decision Logic - If host OS is not macOS, Linux, or Windows: stop. -- Run `contexts/tools/appium/setup/node-environment.md`, then `contexts/tools/appium/setup/references/environment-setup-android.md`, before driver-specific steps. +- Run `contexts/tools/appium/setup-basics.md`, then `contexts/platform/android/emulator-setup.md`, before driver-specific steps. - Use global npm/Appium unless the user explicitly asks for `npx appium`. - If Appium CLI is missing: install `appium` globally under the active Node runtime. - If the `uiautomator2` driver is not installed: install it with Appium CLI. diff --git a/contexts/tools/appium/setup/references/xcuitest/xcuitest-decision-logic.md b/contexts/tools/appium/setup/references/xcuitest/xcuitest-decision-logic.md index 6eaa956..59e692a 100644 --- a/contexts/tools/appium/setup/references/xcuitest/xcuitest-decision-logic.md +++ b/contexts/tools/appium/setup/references/xcuitest/xcuitest-decision-logic.md @@ -12,8 +12,8 @@ description: "macOS-only XCUITest setup gates and optional dependency boundaries - If host OS is not macOS: stop. - If Xcode is missing or command-line tools are unconfigured: install or configure them before continuing. -- If Node.js or npm needs repair: run `contexts/tools/appium/setup/node-environment.md`. +- If Node.js or npm needs repair: run `contexts/tools/appium/setup-basics.md`. - If Appium CLI or `xcuitest` driver is missing: install with Appium CLI. - If install returns "already installed": continue. -- Run `contexts/tools/appium/setup/ffmpeg-environment.md` only when the user explicitly requests media capabilities. +- Run `contexts/tools/ffmpeg/setup.md` only when the user explicitly requests media capabilities. - Re-run `appium driver doctor xcuitest` after every fix. diff --git a/contexts/tools/appium/setup/routing.md b/contexts/tools/appium/setup/routing.md index 42f3a1a..44af09f 100644 --- a/contexts/tools/appium/setup/routing.md +++ b/contexts/tools/appium/setup/routing.md @@ -2,7 +2,7 @@ owner: appium id: appium-setup-routing status: stable -optional_context: contexts/tools/appium/setup/android-decision-logic.md, contexts/tools/appium/setup/espresso-environment.md, contexts/tools/appium/setup/examples/chromium.md, contexts/tools/appium/setup/examples/espresso.md, contexts/tools/appium/setup/examples/gecko.md, contexts/tools/appium/setup/examples/mac2.md, contexts/tools/appium/setup/examples/safari.md, contexts/tools/appium/setup/examples/uiautomator2.md, contexts/tools/appium/setup/examples/xcuitest.md, contexts/tools/appium/setup/ffmpeg-environment.md, contexts/tools/appium/setup/gecko-environment.md, contexts/tools/appium/setup/mac2-environment.md, contexts/tools/appium/setup/node-environment.md, contexts/tools/appium/setup/profiles/android.md, contexts/tools/appium/setup/profiles/chromium.md, contexts/tools/appium/setup/profiles/gecko.md, contexts/tools/appium/setup/profiles/global-appium.md, contexts/tools/appium/setup/profiles/linux.md, contexts/tools/appium/setup/profiles/local-npx.md, contexts/tools/appium/setup/profiles/mac2.md, contexts/tools/appium/setup/profiles/macos.md, contexts/tools/appium/setup/profiles/safari.md, contexts/tools/appium/setup/profiles/windows.md, contexts/tools/appium/setup/profiles/xcuitest.md, contexts/tools/appium/setup/references/android/android-detect-base-tooling.md, contexts/tools/appium/setup/references/android/android-device-emulator-validation.md, contexts/tools/appium/setup/references/android/android-java-configuration.md, contexts/tools/appium/setup/references/android/android-sdk-commandline-tools.md, contexts/tools/appium/setup/references/android/android-sdk-packages-and-path.md, contexts/tools/appium/setup/references/bundletool/bundletool-decision-logic.md, contexts/tools/appium/setup/references/bundletool/bundletool-install.md, contexts/tools/appium/setup/references/bundletool/bundletool-validation.md, contexts/tools/appium/setup/references/chromium/chromium-browser-prereqs.md, contexts/tools/appium/setup/references/chromium/chromium-decision-logic.md, contexts/tools/appium/setup/references/chromium/chromium-driver-validation.md, contexts/tools/appium/setup/references/chromium/chromium-smoke-status.md, contexts/tools/appium/setup/references/environment-setup-android.md, contexts/tools/appium/setup/references/environment-setup-bundletool.md, contexts/tools/appium/setup/references/environment-setup-chromium.md, contexts/tools/appium/setup/references/environment-setup-safari.md, contexts/tools/appium/setup/references/environment-setup-xcuitest.md, contexts/tools/appium/setup/references/espresso/espresso-decision-logic.md, contexts/tools/appium/setup/references/espresso/espresso-doctor-validation.md, contexts/tools/appium/setup/references/espresso/espresso-driver-install.md, contexts/tools/appium/setup/references/espresso/espresso-smoke-status.md, contexts/tools/appium/setup/references/gecko/gecko-browser-prereqs.md, contexts/tools/appium/setup/references/gecko/gecko-decision-logic.md, contexts/tools/appium/setup/references/gecko/gecko-driver-validation.md, contexts/tools/appium/setup/references/gecko/gecko-smoke-status.md, contexts/tools/appium/setup/references/mac2/mac2-decision-logic.md, contexts/tools/appium/setup/references/mac2/mac2-driver-doctor.md, contexts/tools/appium/setup/references/mac2/mac2-smoke-status.md, contexts/tools/appium/setup/references/mac2/mac2-xcode-prereqs.md, contexts/tools/appium/setup/references/node/node-decision-logic.md, contexts/tools/appium/setup/references/node/node-npm-health.md, contexts/tools/appium/setup/references/node/node-validation-evidence.md, contexts/tools/appium/setup/references/node/node-version-manager-setup.md, contexts/tools/appium/setup/references/safari/safari-decision-logic.md, contexts/tools/appium/setup/references/safari/safari-driver-install.md, contexts/tools/appium/setup/references/safari/safari-smoke-status.md, contexts/tools/appium/setup/references/support-inventory.md, contexts/tools/appium/setup/references/uiautomator2/uiautomator2-decision-logic.md, contexts/tools/appium/setup/references/uiautomator2/uiautomator2-doctor-validation.md, contexts/tools/appium/setup/references/uiautomator2/uiautomator2-driver-install.md, contexts/tools/appium/setup/references/uiautomator2/uiautomator2-smoke-status.md, contexts/tools/appium/setup/references/xcuitest/xcuitest-decision-logic.md, contexts/tools/appium/setup/references/xcuitest/xcuitest-driver-doctor.md, contexts/tools/appium/setup/references/xcuitest/xcuitest-smoke-status.md, contexts/tools/appium/setup/references/xcuitest/xcuitest-xcode-prereqs.md, contexts/tools/appium/setup/uiautomator2-environment.md +optional_context: contexts/platform/android/decision-logic.md, contexts/tools/appium/capabilities.md, contexts/tools/appium/setup/espresso-environment.md, contexts/tools/appium/setup/examples/chromium.md, contexts/tools/appium/setup/examples/espresso.md, contexts/tools/appium/setup/examples/gecko.md, contexts/tools/appium/setup/examples/mac2.md, contexts/tools/appium/setup/examples/safari.md, contexts/tools/appium/setup/examples/uiautomator2.md, contexts/tools/appium/setup/examples/xcuitest.md, contexts/tools/ffmpeg/setup.md, contexts/tools/appium/setup/gecko-environment.md, contexts/tools/appium/setup/mac2-environment.md, contexts/tools/appium/setup-basics.md, contexts/platform/android/profile.md, contexts/tools/appium/setup/profiles/chromium.md, contexts/tools/appium/setup/profiles/gecko.md, contexts/tools/appium/setup/profiles/global-appium.md, contexts/platform/linux/profile.md, contexts/tools/appium/setup/profiles/local-npx.md, contexts/tools/appium/setup/profiles/mac2.md, contexts/platform/macos/profile.md, contexts/tools/appium/setup/profiles/safari.md, contexts/platform/windows/profile.md, contexts/tools/appium/setup/profiles/xcuitest.md, contexts/platform/android/references/detect-base-tooling.md, contexts/platform/android/references/device-emulator-validation.md, contexts/platform/android/references/java-configuration.md, contexts/platform/android/references/sdk-commandline-tools.md, contexts/platform/android/references/sdk-packages-and-path.md, contexts/platform/android/references/bundletool/decision-logic.md, contexts/platform/android/references/bundletool/install.md, contexts/platform/android/references/bundletool/validation.md, contexts/browser/chromium/prereqs.md, contexts/tools/appium/setup/references/chromium/chromium-decision-logic.md, contexts/tools/appium/setup/references/chromium/chromium-driver-validation.md, contexts/tools/appium/setup/references/chromium/chromium-smoke-status.md, contexts/platform/android/emulator-setup.md, contexts/platform/android/bundletool.md, contexts/tools/appium/setup/references/environment-setup-chromium.md, contexts/browser/safari/prereqs.md, contexts/tools/appium/setup/references/environment-setup-safari.md, contexts/platform/ios/simulator-setup.md, contexts/tools/appium/setup/references/espresso/espresso-decision-logic.md, contexts/tools/appium/setup/references/espresso/espresso-doctor-validation.md, contexts/tools/appium/setup/references/espresso/espresso-driver-install.md, contexts/tools/appium/setup/references/espresso/espresso-smoke-status.md, contexts/browser/firefox/prereqs.md, contexts/tools/appium/setup/references/gecko/gecko-decision-logic.md, contexts/tools/appium/setup/references/gecko/gecko-driver-validation.md, contexts/tools/appium/setup/references/gecko/gecko-smoke-status.md, contexts/tools/appium/setup/references/mac2/mac2-decision-logic.md, contexts/tools/appium/setup/references/mac2/mac2-driver-doctor.md, contexts/tools/appium/setup/references/mac2/mac2-smoke-status.md, contexts/platform/macos/xcode-command-line-tools.md, contexts/tools/appium/setup/references/node/node-decision-logic.md, contexts/tools/appium/setup/references/node/node-npm-health.md, contexts/tools/appium/setup/references/node/node-validation-evidence.md, contexts/tools/appium/setup/references/node/node-version-manager-setup.md, contexts/tools/appium/setup/references/safari/safari-decision-logic.md, contexts/tools/appium/setup/references/safari/safari-driver-install.md, contexts/tools/appium/setup/references/safari/safari-smoke-status.md, contexts/tools/appium/setup/references/support-inventory.md, contexts/tools/appium/setup/references/uiautomator2/uiautomator2-decision-logic.md, contexts/tools/appium/setup/references/uiautomator2/uiautomator2-doctor-validation.md, contexts/tools/appium/setup/references/uiautomator2/uiautomator2-driver-install.md, contexts/tools/appium/setup/references/uiautomator2/uiautomator2-smoke-status.md, contexts/tools/appium/setup/references/xcuitest/xcuitest-decision-logic.md, contexts/tools/appium/setup/references/xcuitest/xcuitest-driver-doctor.md, contexts/tools/appium/setup/references/xcuitest/xcuitest-smoke-status.md, contexts/platform/macos/xcode-prereqs.md, contexts/tools/appium/setup/uiautomator2-environment.md --- @@ -21,18 +21,18 @@ Use the matching route for the requested target. Load only the listed assets and ### Android + UiAutomator2 1. `skills/setup/SKILL.md` -2. `contexts/tools/appium/setup/profiles/android.md` -3. `contexts/tools/appium/setup/node-environment.md` -4. `contexts/tools/appium/setup/references/environment-setup-android.md` +2. `contexts/platform/android/profile.md` +3. `contexts/tools/appium/setup-basics.md` +4. `contexts/platform/android/emulator-setup.md` 5. `contexts/tools/appium/setup/uiautomator2-environment.md` 6. Example: `contexts/tools/appium/setup/examples/uiautomator2.md` ### Android + Espresso 1. `skills/setup/SKILL.md` -2. `contexts/tools/appium/setup/profiles/android.md` -3. `contexts/tools/appium/setup/node-environment.md` -4. `contexts/tools/appium/setup/references/environment-setup-android.md` +2. `contexts/platform/android/profile.md` +3. `contexts/tools/appium/setup-basics.md` +4. `contexts/platform/android/emulator-setup.md` 5. `contexts/tools/appium/setup/espresso-environment.md` 6. Example: `contexts/tools/appium/setup/examples/espresso.md` @@ -40,7 +40,7 @@ Use the matching route for the requested target. Load only the listed assets and 1. `skills/setup/SKILL.md` 2. `contexts/tools/appium/setup/profiles/chromium.md` -3. `contexts/tools/appium/setup/node-environment.md` +3. `contexts/tools/appium/setup-basics.md` 4. `contexts/tools/appium/setup/references/environment-setup-chromium.md` 5. Example: `contexts/tools/appium/setup/examples/chromium.md` @@ -48,33 +48,34 @@ Use the matching route for the requested target. Load only the listed assets and 1. `skills/setup/SKILL.md` 2. `contexts/tools/appium/setup/profiles/gecko.md` -3. `contexts/tools/appium/setup/node-environment.md` +3. `contexts/tools/appium/setup-basics.md` 4. `contexts/tools/appium/setup/gecko-environment.md` 5. Example: `contexts/tools/appium/setup/examples/gecko.md` ### macOS + Mac2 1. `skills/setup/SKILL.md` -2. `contexts/tools/appium/setup/profiles/macos.md` +2. `contexts/platform/macos/profile.md` 3. `contexts/tools/appium/setup/profiles/mac2.md` -4. `contexts/tools/appium/setup/node-environment.md` +4. `contexts/tools/appium/setup-basics.md` 5. `contexts/tools/appium/setup/mac2-environment.md` 6. Example: `contexts/tools/appium/setup/examples/mac2.md` ### macOS + Safari 1. `skills/setup/SKILL.md` -2. `contexts/tools/appium/setup/profiles/macos.md` +2. `contexts/platform/macos/profile.md` 3. `contexts/tools/appium/setup/profiles/safari.md` -4. `contexts/tools/appium/setup/node-environment.md` -5. `contexts/tools/appium/setup/references/environment-setup-safari.md` -6. Example: `contexts/tools/appium/setup/examples/safari.md` +4. `contexts/tools/appium/setup-basics.md` +5. `contexts/browser/safari/prereqs.md` +6. `contexts/tools/appium/setup/references/environment-setup-safari.md` +7. Example: `contexts/tools/appium/setup/examples/safari.md` ### iOS + XCUITest Simulator 1. `skills/setup/SKILL.md` -2. `contexts/tools/appium/setup/profiles/macos.md` +2. `contexts/platform/macos/profile.md` 3. `contexts/tools/appium/setup/profiles/xcuitest.md` -4. `contexts/tools/appium/setup/node-environment.md` -5. `contexts/tools/appium/setup/references/environment-setup-xcuitest.md` +4. `contexts/tools/appium/setup-basics.md` +5. `contexts/platform/ios/simulator-setup.md` 6. Example: `contexts/tools/appium/setup/examples/xcuitest.md` diff --git a/contexts/tools/appium/setup/uiautomator2-environment.md b/contexts/tools/appium/setup/uiautomator2-environment.md index b748ac1..a4e25cb 100644 --- a/contexts/tools/appium/setup/uiautomator2-environment.md +++ b/contexts/tools/appium/setup/uiautomator2-environment.md @@ -15,8 +15,8 @@ Prepare Appium UiAutomator2 by validating Node/Appium, Android prerequisites, dr Load these references in order: -1. `contexts/tools/appium/setup/node-environment.md` for Node.js and npm. -2. `contexts/tools/appium/setup/references/environment-setup-android.md` for Java, Android SDK, ADB, emulator, device, and SDK package validation. +1. `contexts/tools/appium/setup-basics.md` for Node.js and npm. +2. `contexts/platform/android/emulator-setup.md` for Java, Android SDK, ADB, emulator, device, and SDK package validation. 3. `contexts/tools/appium/setup/references/uiautomator2/uiautomator2-decision-logic.md` for driver setup triggers and optional dependency boundaries. 4. `contexts/tools/appium/setup/references/uiautomator2/uiautomator2-driver-install.md` for global Appium and UiAutomator2 driver installation. 5. `contexts/tools/appium/setup/references/uiautomator2/uiautomator2-doctor-validation.md` for required doctor pass criteria. diff --git a/contexts/tools/appium/setup/ffmpeg-environment.md b/contexts/tools/ffmpeg/setup.md similarity index 84% rename from contexts/tools/appium/setup/ffmpeg-environment.md rename to contexts/tools/ffmpeg/setup.md index 6e88adf..a4a1ed2 100644 --- a/contexts/tools/appium/setup/ffmpeg-environment.md +++ b/contexts/tools/ffmpeg/setup.md @@ -1,15 +1,15 @@ --- owner: appium -id: setup-references-environment-setup-ffmpeg +id: tools.ffmpeg.setup status: stable -source: contexts/tools/appium/setup/ffmpeg-environment.md +source: contexts/tools/ffmpeg/setup.md --- -# FFmpeg Environment +# FFmpeg Setup ## Goal -Installs and validates FFmpeg in a cross-platform way so Appium environments can use optional media-related capabilities when explicitly requested. +Install and validate FFmpeg in a cross-platform way so Appium and other workflows can use optional media-related capabilities when explicitly requested. ## Validation Command @@ -22,7 +22,7 @@ Use `summary.requiredOk: true` as the read-only setup gate after the user explic ## Decision Logic - If host OS is unsupported: stop and ask the user to run on macOS, Linux, or Windows. - If `ffmpeg` is already available in `PATH`: do not reinstall; only validate version output. -- If user has not explicitly requested FFmpeg-related capability: skip this skill. +- If user has not explicitly requested FFmpeg-related capability: skip this context. - If host OS is macOS: prefer Homebrew install. - If host OS is Linux: use distro package manager install. - If host OS is Windows: prefer `winget`; fallback to Chocolatey if `winget` is unavailable. @@ -96,12 +96,12 @@ Mark complete only when all are true: ## Self-Improvement Prompt -Before the final response, run the FFmpeg self-improvement check. Report any missing, ambiguous, outdated, or retry-causing instruction with section and proposed wording. Do not edit the skill unless asked. +Before the final response, run the FFmpeg self-improvement check. Report any missing, ambiguous, outdated, or retry-causing instruction with section and proposed wording. Do not edit the context unless asked. ## Constraints -- This optional skill requires explicit user request before installing FFmpeg. -- This is an optional skill; run only when the user explicitly requests FFmpeg-related setup. +- This optional context requires explicit user request before installing FFmpeg. +- This is an optional context; run only when the user explicitly requests FFmpeg-related setup. - Ask before installing optional dependencies. - If privileged commands are required, pause and provide exact commands for user execution. -- Do not modify unrelated Appium, Java, Android SDK, or Xcode configuration in this skill. +- Do not modify unrelated Appium, Java, Android SDK, or Xcode configuration in this context.