properties-catalog.json

[
  {
    "section": "Platform",
    "key": "SHAFT.CrossBrowserMode",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "off",
    "possibleValues": "off, sequential, parallelized",
    "description": "Cross Browser Mode allows SHAFT to run your test class against Chrome, Firefox, and Safari! You need to have 'Docker Desktop' installed on your machine, and configured to use Linux images. Off → Your tests will run normally and respect your configuration. Sequential → Your tests will run on Chrome, Firefox, and Safari in sequence. Parallelized → Your tests will run on Chrome, Firefox and Safari in parallel. And for each browser they will run in sequence."
  },
  {
    "section": "Platform",
    "key": "executionAddress",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "local",
    "possibleValues": "local, dockerized, browserstack, host:port, http://host:port/wd/hub",
    "description": "For Appium, set the below settings and move to the Mobile tab to continue. For BrowserStack, set the \"Target Operating System\" below, and the \"Automation Name\" in the Mobile tab, then configure the \"browserStack.properties\" file in your project directory."
  },
  {
    "section": "Platform",
    "key": "targetOperatingSystem",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "Linux",
    "possibleValues": "Linux, Windows, Mac, Android, iOS",
    "description": "The target operating system for test execution."
  },
  {
    "section": "Platform",
    "key": "com.SHAFT.proxySettings",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "host:port",
    "description": "Used to configure testing behind a proxy. e.g. corporate proxy."
  },
  {
    "section": "Platform",
    "key": "driverProxySettings",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "To enable or disable the driver proxy."
  },
  {
    "section": "Platform",
    "key": "jvmProxySettings",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "To enable or disable the JVM proxy."
  },
  {
    "section": "Platform",
    "key": "enableBiDi",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "To enable or disable the WebDriver BiDi protocol."
  },
  {
    "section": "Platform",
    "key": "remotePreflightEnabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Query Selenium Grid /status and /graphql before remote sessions and attach a preflight summary when Grid metadata is available."
  },
  {
    "section": "Platform",
    "key": "remoteAdaptiveSessionThrottling",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Limit local remote-session creation to the detected matching Selenium Grid slot count."
  },
  {
    "section": "Platform",
    "key": "remotePreflightFailFast",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Fail before WebDriver retries when Grid preflight proves the requested browser slot is unavailable."
  },
  {
    "section": "Platform",
    "key": "remotePreflightTimeoutSeconds",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "5",
    "possibleValues": "seconds",
    "description": "Timeout for each Grid preflight /status or /graphql call."
  },
  {
    "section": "Web",
    "key": "targetBrowserName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "chrome",
    "possibleValues": "chrome, firefox, safari, edge",
    "description": "The target web browser for test execution."
  },
  {
    "section": "Web",
    "key": "forceBrowserDownload",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "This only works for Chrome and Firefox. Allows Selenium Manager to download a Chrome for Testing browser build compatible with the current Selenium/browser resolution flow."
  },
  {
    "section": "Web",
    "key": "headlessExecution",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "This only works for Chrome, Firefox and Edge."
  },
  {
    "section": "Web",
    "key": "incognitoMode",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable browser incognito/private mode."
  },
  {
    "section": "Web",
    "key": "isMobileEmulation",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "This only works for Chrome and Edge."
  },
  {
    "section": "Web",
    "key": "mobileEmulation.isCustomDevice",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "This only works for Chrome and Edge."
  },
  {
    "section": "Web",
    "key": "mobileEmulation.deviceName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "blackberryZ30, BlackberryPlayBook, galaxyNote3, galaxyNoteII, galaxySIII, galaxyS5, galaxyS8, samsungGalaxyS8+, galaxyS9+, galaxyTabS4, galaxyFold, samsungGalaxyS20Ultra, samsungGalaxyA51/71, kindleFireHDX, lgOptimusL70, microsoftLumia550, microsoftLumia950, motoG4, nexus10, nexus4, nexus5, nexus5X, nexus6, nexus6P, nexus7, nokiaLumia520, nokiaN9, nestHub, nestHubMax, pixel2, pixel2XL, pixel3, pixel3XL, pixel4, pixel5, jioPhone2, iPhone4, iPhone5/SE, iPhone6/7/8, iPhone6/7/8Plus, iPhoneSE, iPhoneX, iPhoneXR, iPhone12Pro, iPad, iPadPro, iPadAir, iPadMini, surfacePro7, surfaceDuo",
    "description": "This only works for Chrome and Edge."
  },
  {
    "section": "Web",
    "key": "mobileEmulation.width",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "",
    "possibleValues": "example: 360",
    "description": "This only works for Chrome and Edge."
  },
  {
    "section": "Web",
    "key": "mobileEmulation.height",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "",
    "possibleValues": "example: 600",
    "description": "This only works for Chrome and Edge."
  },
  {
    "section": "Web",
    "key": "mobileEmulation.pixelRatio",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "1.0",
    "possibleValues": "example: 2.0",
    "description": "This only works for Chrome and Edge."
  },
  {
    "section": "Web",
    "key": "mobileEmulation.userAgent",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:35.0) Gecko/20100101 Firefox/35.0",
    "description": "This only works for Chrome and Edge."
  },
  {
    "section": "Web",
    "key": "baseURL",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: https://github.com/ShaftHQ/SHAFT_ENGINE",
    "description": "Base URL for the application under test."
  },
  {
    "section": "Web",
    "key": "browserWindowWidth",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "1920",
    "possibleValues": "",
    "description": "Won't work if autoMaximizeBrowserWindow is enabled."
  },
  {
    "section": "Web",
    "key": "browserWindowHeight",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "1080",
    "possibleValues": "",
    "description": "Won't work if autoMaximizeBrowserWindow is enabled."
  },
  {
    "section": "Web",
    "key": "pageLoadStrategy",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "none",
    "possibleValues": "none, eager, normal",
    "description": "Controls when Selenium considers the page loaded."
  },
  {
    "section": "Web",
    "key": "readinessState",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "none",
    "possibleValues": "interactive, none, complete",
    "description": "Controls the document readiness state to wait for."
  },
  {
    "section": "Web",
    "key": "storageStatePath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: target/auth-state.json",
    "description": "Path to a storage-state JSON file automatically loaded into a freshly-initialized driver. SHAFT navigates to the file's recorded origin (falling back to baseURL) first; a load failure is logged as a warning and never fails driver init. Blank (default) disables the feature."
  },
  {
    "section": "Playwright",
    "key": "playwright.browserName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "chromium, chrome, firefox, webkit, safari, edge",
    "description": "Optional Playwright browser engine override. When empty, SHAFT uses the device descriptor browser type or falls back to targetBrowserName."
  },
  {
    "section": "Playwright",
    "key": "playwright.deviceName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "Any Microsoft Playwright device descriptor name, Galaxy S26 Ultra, iPhone 17 Pro Max",
    "description": "Device descriptor applied to new browser contexts."
  },
  {
    "section": "Playwright",
    "key": "playwright.connectionMode",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "local",
    "possibleValues": "local, connect, connectOverCDP",
    "description": "Launch a local browser, connect over Playwright protocol, or connect over CDP."
  },
  {
    "section": "Playwright",
    "key": "playwright.endpoint",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "WebSocket or CDP endpoint",
    "description": "Remote endpoint used when connectionMode is connect or connectOverCDP."
  },
  {
    "section": "Playwright",
    "key": "playwright.channel",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "Chromium channel such as chrome or msedge",
    "description": "Optional Chromium channel passed to Playwright launch options."
  },
  {
    "section": "Playwright",
    "key": "playwright.slowMo",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "0",
    "possibleValues": "milliseconds",
    "description": "Slow motion delay for Playwright actions."
  },
  {
    "section": "Playwright",
    "key": "playwright.launchTimeoutMilliseconds",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30000",
    "possibleValues": "milliseconds",
    "description": "Timeout for launching or connecting to a browser."
  },
  {
    "section": "Playwright",
    "key": "playwright.defaultTimeoutMilliseconds",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30000",
    "possibleValues": "milliseconds",
    "description": "Default timeout applied to Playwright page actions."
  },
  {
    "section": "Playwright",
    "key": "playwright.navigationTimeoutMilliseconds",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30000",
    "possibleValues": "milliseconds",
    "description": "Default timeout applied to Playwright page navigation."
  },
  {
    "section": "Playwright",
    "key": "playwright.artifactsDirectory",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "target/playwright-artifacts",
    "possibleValues": "relative or absolute path",
    "description": "Directory for Playwright traces and artifacts."
  },
  {
    "section": "Playwright",
    "key": "playwright.downloadsDirectory",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "relative or absolute path",
    "description": "Optional downloads directory. Empty uses Playwright defaults."
  },
  {
    "section": "Playwright",
    "key": "playwright.acceptDownloads",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Allow Playwright browser contexts to accept downloads."
  },
  {
    "section": "Playwright",
    "key": "playwright.tracing.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Start Playwright tracing for the session."
  },
  {
    "section": "Playwright",
    "key": "playwright.tracing.onRetryOnly",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Enable tracing automatically only during SHAFT retry evidence capture."
  },
  {
    "section": "Playwright",
    "key": "playwright.tracing.screenshots",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Include screenshots in trace artifacts."
  },
  {
    "section": "Playwright",
    "key": "playwright.tracing.snapshots",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Include DOM snapshots in trace artifacts."
  },
  {
    "section": "Playwright",
    "key": "playwright.tracing.sources",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Include source files in trace artifacts."
  },
  {
    "section": "Mobile",
    "key": "platformName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: Android, iOS",
    "description": "Raw Appium platformName capability. Usually derived automatically from targetOperatingSystem; set this to override it directly."
  },
  {
    "section": "Mobile",
    "key": "mobile_platformVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: 11.0, 13.0",
    "description": "You can add any property from the List of Appium Capabilities directly to your .property files or via CLI arguments, just make sure to add mobile_ as a prefix."
  },
  {
    "section": "Mobile",
    "key": "mobile_deviceName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: ANDROID_EMULATOR",
    "description": "You can add any property from the List of Appium Capabilities directly to your .property files or via CLI arguments, just make sure to add mobile_ as a prefix."
  },
  {
    "section": "Mobile",
    "key": "mobile_automationName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "UiAutomator2",
    "possibleValues": "UiAutomator2, Espresso, XCUITest",
    "description": "You can add any property from the List of Appium Capabilities directly to your .property files or via CLI arguments, just make sure to add mobile_ as a prefix."
  },
  {
    "section": "Mobile",
    "key": "mobile_udid",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: RQ3005TAQP",
    "description": "Unique device identifier of the connected physical device (leave empty if not applicable). You can add any property from the List of Appium Capabilities directly to your .property files or via CLI arguments, just make sure to add mobile_ as a prefix."
  },
  {
    "section": "Mobile",
    "key": "browserName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "chrome, Chromium, Browser, Safari, samsung",
    "description": "You can add any property from the List of Appium Capabilities directly to your .property files or via CLI arguments, just make sure to add mobile_ as a prefix."
  },
  {
    "section": "Mobile",
    "key": "MobileBrowserVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: 83.0.4103.39",
    "description": "The WebDriver executable version compatible with the target mobile browser. Check Selenium driver requirements for browser-specific compatibility. You can add any property from the List of Appium Capabilities directly to your .property files or via CLI arguments, just make sure to add mobile_ as a prefix."
  },
  {
    "section": "Mobile",
    "key": "mobile_app",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "relativePath/to/myApp.apk, absolutePath/to/myApp.apk, http://myapp.com/app.ipa",
    "description": "You can add any property from the List of Appium Capabilities directly to your .property files or via CLI arguments, just make sure to add mobile_ as a prefix."
  },
  {
    "section": "Mobile",
    "key": "mobile_appPackage",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: com.example.android.myApp",
    "description": "You can add any property from the List of Appium Capabilities directly to your .property files or via CLI arguments, just make sure to add mobile_ as a prefix."
  },
  {
    "section": "Mobile",
    "key": "mobile_appActivity",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: .MainActivity",
    "description": "You can add any property from the List of Appium Capabilities directly to your .property files or via CLI arguments, just make sure to add mobile_ as a prefix."
  },
  {
    "section": "Mobile",
    "key": "mobile_bundleId",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "example: com.example.ios.myApp",
    "description": "iOS bundle identifier for launching an already installed app without providing mobile_app. You can add any property from the List of Appium Capabilities directly to your .property files or via CLI arguments, just make sure to add mobile_ as a prefix."
  },
  {
    "section": "API",
    "key": "swagger.validation.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enables or disables Swagger/OpenAPI contract validation for API testing."
  },
  {
    "section": "API",
    "key": "swagger.validation.url",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "URL or file path to the OpenAPI schema for validation."
  },
  {
    "section": "API",
    "key": "openapi.coverage.report.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Generates an end-of-run OpenAPI operation coverage report using swagger.validation.url as the spec source."
  },
  {
    "section": "API",
    "key": "openapi.coverage.threshold",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "0",
    "possibleValues": "",
    "description": "Minimum covered operation percentage required for a passing run; 0 disables threshold enforcement."
  },
  {
    "section": "API",
    "key": "shaft.contract.sensitiveKeys",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "authorization,cookie,set-cookie,password,passwd,secret,token,api-key,apikey,access-key,accesskey",
    "possibleValues": "",
    "description": "Configured sensitive key fragments."
  },
  {
    "section": "API",
    "key": "shaft.contract.volatileKeys",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "requestId,traceId,spanId,sessionId,nonce,timestamp,createdAt,updatedAt,expiresAt,date,etag",
    "possibleValues": "",
    "description": "Configured volatile key names."
  },
  {
    "section": "Capture",
    "key": "capture.api.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable or disable automatic capture of web API network traffic during test execution. Requires Chrome or Edge browser with DevTools Protocol support."
  },
  {
    "section": "Capture",
    "key": "capture.api.maxBodyBytes",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "1048576",
    "possibleValues": "bytes (integer)",
    "description": "Maximum request/response body size to capture in bytes (1 MB). Bodies exceeding this limit are truncated in the capture session."
  },
  {
    "section": "Capture",
    "key": "capture.api.includeAssets",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Include asset requests (images, CSS, fonts, etc.) in API capture. When false, only data/API calls are recorded."
  },
  {
    "section": "Capture",
    "key": "capture.api.firstPartyOnly",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Capture only first-party API calls from the primary domain. When false, all cross-origin requests are included."
  },
  {
    "section": "Capture",
    "key": "capture.api.storeSecretsLocally",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "",
    "possibleValues": "true, false",
    "description": "Store authorization headers and sensitive data in the capture session. When false (default), secrets are referenced via bodyRefId instead.",
    "sensitive": true
  },
  {
    "section": "Capture",
    "key": "capture.api.maxTransactions",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "500",
    "possibleValues": "integer",
    "description": "Maximum number of network transactions to retain per capture session."
  },
  {
    "section": "Capture",
    "key": "capture.api.urlIncludeGlobs",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "comma-separated glob patterns",
    "description": "When non-empty, only URLs matching one of these glob patterns are captured."
  },
  {
    "section": "Capture",
    "key": "capture.api.urlExcludeGlobs",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "comma-separated glob patterns",
    "description": "URLs matching one of these glob patterns are always excluded from capture."
  },
  {
    "section": "Flags",
    "key": "automaticallyAddRecommendedChromeOptions",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Automatically add recommended Chrome options for better stability."
  },
  {
    "section": "Flags",
    "key": "retryMaximumNumberOfAttempts",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "0",
    "possibleValues": "example: 0, 1, 2, 3, 4, ...etc",
    "description": "Maximum number of retry attempts after the first failed execution. JUnit retries run after @AfterEach cleanup and execute @BeforeEach again for isolated retry state."
  },
  {
    "section": "Flags",
    "key": "forceCaptureSupportingEvidenceOnRetry",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "When retrying a failed test, enable GIF/video/log evidence for the retry attempt."
  },
  {
    "section": "Flags",
    "key": "autoMaximizeBrowserWindow",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Automatically maximize browser window on launch."
  },
  {
    "section": "Flags",
    "key": "forceCheckForElementVisibility",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Force check for element visibility before interactions."
  },
  {
    "section": "Flags",
    "key": "forceCheckElementLocatorIsUnique",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Force check that element locator returns only one element. Still enforced on every retry within the identification timeout; only once that timeout is exhausted does SHAFT make one last-resort attempt to auto-resolve to a single displayed-and-enabled match before throwing MultipleElementsFoundException."
  },
  {
    "section": "Flags",
    "key": "forceCheckTextWasTypedCorrectly",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "In WebDriver element actions, after type, typeSecure, or typeAppend, compare the final element value/text with the expected typed text. SHAFT skips this comparison for special key sequences such as Keys.ENTER."
  },
  {
    "section": "Flags",
    "key": "scrollingMode",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "javascript",
    "possibleValues": "javascript, native",
    "description": "Mode for scrolling to elements."
  },
  {
    "section": "Flags",
    "key": "clearBeforeTypingMode",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "native",
    "possibleValues": "native, backspace, off",
    "description": "Replaces both deprecated attemptClearBeforeTyping and attemptClearBeforeTypingUsingBackspace flags. native = clear using native Selenium method, backspace = clear by deleting letter by letter, off = no clearing before typing."
  },
  {
    "section": "Flags",
    "key": "forceCheckNavigationWasSuccessful",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Force check that navigation to URL was successful."
  },
  {
    "section": "Flags",
    "key": "respectBuiltInWaitsInNativeMode",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Respect built-in waits when using native mode."
  },
  {
    "section": "Flags",
    "key": "forceCheckStatusOfRemoteServer",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Force check status of remote server before execution."
  },
  {
    "section": "Flags",
    "key": "clickUsingJavascriptWhenWebDriverClickFails",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Fallback to JavaScript click when native WebDriver click fails, including invalid-state and intercepted-click failures."
  },
  {
    "section": "Flags",
    "key": "autoCloseDriverInstance",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Automatically close driver instance after test execution."
  },
  {
    "section": "Flags",
    "key": "automaticallyAssertResponseStatusCode",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Automatically assert API response status code."
  },
  {
    "section": "Flags",
    "key": "maximumPerformanceMode",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "0",
    "possibleValues": "0, 1, 2",
    "description": "0 → Disabled, 1 → Without Headless Execution, 2 → With Headless Execution Enabling maximumPerformanceMode will disable all complementary features to ensure the fastest execution possible with a 400% calculated performance boost."
  },
  {
    "section": "Flags",
    "key": "skipTestsWithLinkedIssues",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "It is recommended to leave this feature disabled unless you explicitly want to skip any tests that have the @Issue or @Issues annotation."
  },
  {
    "section": "Flags",
    "key": "attemptToClickBeforeTyping",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Click the element before typing when clearBeforeTypingMode is not native."
  },
  {
    "section": "Flags",
    "key": "disableCache",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "To disable the cache in a browser session."
  },
  {
    "section": "Flags",
    "key": "enableTrueNativeMode",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable true native mode for mobile testing."
  },
  {
    "section": "Flags",
    "key": "handleNonSelectDropDown",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Handle non-select dropdown elements."
  },
  {
    "section": "Flags",
    "key": "validateSwipeToElement",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Validate swipe to element action on mobile."
  },
  {
    "section": "Flags",
    "key": "disableSslCertificateCheck",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Disable SSL certificate validation."
  },
  {
    "section": "Flags",
    "key": "telemetry.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Enable telemetry data collection for SHAFT usage analytics."
  },
  {
    "section": "Reporting",
    "key": "captureElementName",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Capture element name in reports for better readability."
  },
  {
    "section": "Reporting",
    "key": "captureWebDriverLogs",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Capture WebDriver logs for debugging purposes."
  },
  {
    "section": "Reporting",
    "key": "alwaysLogDiscreetly",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Always log discreetly without detailed output."
  },
  {
    "section": "Reporting",
    "key": "debugMode",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable debug mode for verbose logging."
  },
  {
    "section": "Reporting",
    "key": "openLighthouseReportWhileExecution",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Open Lighthouse performance report during execution."
  },
  {
    "section": "Reporting",
    "key": "cleanSummaryReportsDirectoryBeforeExecution",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Clean summary reports directory before execution."
  },
  {
    "section": "Reporting",
    "key": "openExecutionSummaryReportAfterExecution",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Open execution summary report after test execution."
  },
  {
    "section": "Reporting",
    "key": "disableLogging",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Disable all logging output."
  },
  {
    "section": "Reporting",
    "key": "attachFullLog",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Attach a streamed, deduplicated snapshot of the full engine log to the Allure report after test execution without deleting the live log file."
  },
  {
    "section": "Reporting",
    "key": "evidenceLevel",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "FAILURE_ONLY",
    "possibleValues": "FAILURE_ONLY, BALANCED, FAST, FULL, CUSTOM",
    "description": "Select the evidence profile. Profile values except CUSTOM override granular screenshot, page-source, GIF, video, WebDriver-log, full-log, diagnostics, and trace controls."
  },
  {
    "section": "Reporting",
    "key": "locatorHealthReportEnabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Generate end-of-run HTML/JSON locator health reports and attach them to Allure."
  },
  {
    "section": "Reporting",
    "key": "slowLocatorThresholdMillis",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "750",
    "possibleValues": "Integer milliseconds",
    "description": "Mark locator lookups at or above this duration as slow warnings."
  },
  {
    "section": "Reporting",
    "key": "failOnLocatorHealthWarnings",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Fail the run when locator health warnings are present."
  },
  {
    "section": "Reporting",
    "key": "shaft.locatorHealth.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Generate end-of-run locator health reports."
  },
  {
    "section": "Reporting",
    "key": "shaft.locatorHealth.warnBelowScore",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "70",
    "possibleValues": "0 to 100",
    "description": "Mark locators below this health score as risky in the dashboard."
  },
  {
    "section": "Reporting",
    "key": "shaft.locatorHealth.attachDashboard",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Attach the HTML locator health dashboard to Allure."
  },
  {
    "section": "Reporting",
    "key": "shaft.locatorHealth.failBelowScore",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "-1",
    "possibleValues": "-1 or 0 to 100",
    "description": "Fail the run when any locator score is below this threshold; -1 disables score-based failure."
  },
  {
    "section": "Reporting",
    "key": "shaft.diagnostics.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Attach shaft-diagnostics.zip with sanitized diagnostics.json for failed and broken tests."
  },
  {
    "section": "Reporting",
    "key": "shaft.diagnostics.maxArtifactMb",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "50",
    "possibleValues": "Integer megabytes",
    "description": "Maximum size for a single diagnostics ZIP entry."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Attach the SHAFT failure trace viewer archive to Allure."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.mode",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "auto",
    "possibleValues": "auto, failure, retry, always",
    "description": "Control trace generation: auto is retry-aware (resolves to retry when retryMaximumNumberOfAttempts > 0, otherwise failure)."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.retainFailedAttempts",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Retain failed-attempt trace archives under attempt-indexed names when retries are enabled."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.includeCodeContext",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Include the best matching project source-code frame and snippet."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.includeFullPageSnapshots",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Include web page snapshots when available."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.includeDomSnapshots",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Include DOM snapshots in the SHAFT failure trace bundle when available."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.includeScreenshots",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Include screenshots in the SHAFT failure trace bundle when available."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.includeNativePageSource",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Include native mobile page source when available."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.includeNetwork",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Reserve network evidence in the trace metadata."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.includeConsole",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Reserve console evidence in the trace metadata."
  },
  {
    "section": "Reporting",
    "key": "shaft.trace.maxArtifactMb",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "50",
    "possibleValues": "Integer megabytes",
    "description": "Maximum size for a single trace bundle entry."
  },
  {
    "section": "Reporting",
    "key": "shaft.flakeProfiler.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Attach opt-in flake and auto-wait timing profiles to Allure."
  },
  {
    "section": "Reporting",
    "key": "shaft.flakeProfiler.attachPerTest",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Attach each test's JSON/HTML profile when profiler signals exist."
  },
  {
    "section": "Reporting",
    "key": "shaft.flakeProfiler.failOnSevereFlakeRisk",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Fail the run when severe flake-risk actions are found."
  },
  {
    "section": "Reporting",
    "key": "shaft.flakeProfiler.slowActionThresholdMs",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "2000",
    "possibleValues": "Integer milliseconds",
    "description": "Duration threshold used to flag slow and severe-risk actions."
  },
  {
    "section": "Allure",
    "key": "allure.automaticallyOpen",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Open the Allure report in the default browser automatically after test execution. *(previously: openAllureReportAfterExecution)*"
  },
  {
    "section": "Allure",
    "key": "allure.accumulateHistory",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "When true, accumulates Allure history across runs to enable trend graphs and historical comparison. When false, old results are deleted before the new run. *(previously: cleanAllureResultsDirectoryBeforeExecution)*"
  },
  {
    "section": "Allure",
    "key": "allure.accumulateReports",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "When true, keeps previous Allure HTML report files in the report directory. When false, only the latest run report is retained."
  },
  {
    "section": "Allure",
    "key": "allure.cleanResultsDirectory",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Clean the Allure results directory before each test run. Disable when merging results from multiple partial runs."
  },
  {
    "section": "Allure",
    "key": "allure.generateArchive",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Generate a self-contained ZIP archive of the Allure report after test execution. Useful for sharing or archiving in CI pipelines. *(previously: generateAllureReportArchive)*"
  },
  {
    "section": "Allure",
    "key": "allure.generateReport",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Generate the Allure HTML report, convenience script, archive, and live watch process after test execution. Set to false to keep raw allure-results only."
  },
  {
    "section": "Allure",
    "key": "allure.customLogo",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "https://github.com/ShaftHQ/SHAFT_ENGINE/blob/main/shaft-engine/src/main/resources/images/shaft_report_logo.png?raw=true",
    "possibleValues": "URL or local file path",
    "description": "URL or local path to a custom logo image to replace the default SHAFT logo in the Allure report."
  },
  {
    "section": "Allure",
    "key": "allure.customTitle",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "SHAFT-powered test report",
    "possibleValues": "Any string",
    "description": "Custom title displayed in the header of the generated Allure report."
  },
  {
    "section": "Allure",
    "key": "allure.theme",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "auto",
    "possibleValues": "auto, light, dark",
    "description": "Controls the Allure 3 Awesome plugin report theme."
  },
  {
    "section": "Allure",
    "key": "allure.forceConfiguredCliVersion",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "true enforces the configured Allure 3 CLI version; false falls back to legacy PATH-first CLI resolution."
  },
  {
    "section": "Allure",
    "key": "allure.realtimeMonitoring",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enables SHAFT-managed Allure 3 native real-time monitoring via allure watch while tests run. Ignored for Allure 2 or when the Allure CLI cannot be resolved."
  },
  {
    "section": "Allure",
    "key": "allure.singleFile",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Controls the Allure 3 Awesome plugin singleFile option. When true, the report is generated as a self-contained HTML file."
  },
  {
    "section": "Allure",
    "key": "allure.reportLanguage",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "en",
    "possibleValues": "Language code, such as en, fr, or ru",
    "description": "Controls the Allure 3 Awesome plugin reportLanguage option used by the generated report UI."
  },
  {
    "section": "Allure",
    "key": "allure.open",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Controls the Allure 3 Awesome plugin open option passed to Allure CLI report generation."
  },
  {
    "section": "Allure",
    "key": "allure.groupBy",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "package,testClass",
    "possibleValues": "Comma-separated Allure label names",
    "description": "Controls the Allure 3 Awesome plugin groupBy hierarchy. Common values include epic,feature,story and parentSuite,suite,subSuite."
  },
  {
    "section": "Timeouts",
    "key": "waitForLazyLoading",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Especially useful for modern/responsive web apps using React, Vue, Angular, ...etc"
  },
  {
    "section": "Timeouts",
    "key": "browserNavigationTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for browser navigation."
  },
  {
    "section": "Timeouts",
    "key": "pageLoadTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for page load."
  },
  {
    "section": "Timeouts",
    "key": "scriptExecutionTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for script execution."
  },
  {
    "section": "Timeouts",
    "key": "waitForLazyLoadingTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for SHAFT's browser lazy-loading synchronization."
  },
  {
    "section": "Timeouts",
    "key": "lazyLoadingNetworkIdleInitialObservationMillis",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "200",
    "possibleValues": "(milliseconds)",
    "description": "Initial network observation window in milliseconds when no requests were seen."
  },
  {
    "section": "Timeouts",
    "key": "lazyLoadingNetworkIdleQuietWindowMillis",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "500",
    "possibleValues": "(milliseconds)",
    "description": "Required network quiet window in milliseconds after observed activity."
  },
  {
    "section": "Timeouts",
    "key": "lazyLoadingPollingIntervalMillis",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "200",
    "possibleValues": "(milliseconds)",
    "description": "Polling interval in milliseconds for the browser-readiness fluentWait loop."
  },
  {
    "section": "Timeouts",
    "key": "lazyLoadingDomStabilityQuietWindowMillis",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "0",
    "possibleValues": "(milliseconds); 0 disables DOM-stability folding",
    "description": "Required DOM-mutation quiet window in milliseconds before the browser-readiness wait treats the DOM as stable."
  },
  {
    "section": "Timeouts",
    "key": "lazyLoadingScrollSweepMaxSteps",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "20",
    "possibleValues": "(steps)",
    "description": "Maximum number of progressive-scroll steps that driver.browser().scrollToLoadAll() performs while sweeping a page for scroll-triggered lazy content."
  },
  {
    "section": "Timeouts",
    "key": "defaultElementIdentificationTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "10",
    "possibleValues": "(seconds)",
    "description": "Default timeout in seconds for element identification."
  },
  {
    "section": "Timeouts",
    "key": "waitForUiStateTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "600",
    "possibleValues": "(seconds)",
    "description": "Default timeout in seconds for UI state waits such as waitUntil()."
  },
  {
    "section": "Timeouts",
    "key": "apiSocketTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for API socket connections."
  },
  {
    "section": "Timeouts",
    "key": "apiConnectionTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for API connections."
  },
  {
    "section": "Timeouts",
    "key": "apiConnectionManagerTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for API connection manager."
  },
  {
    "section": "Timeouts",
    "key": "shellSessionTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for shell session."
  },
  {
    "section": "Timeouts",
    "key": "sshServerAliveInterval",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "60",
    "possibleValues": "seconds; <= 0 disables keep-alive packets | JSch ServerAliveInterval in seconds for remote SSH sessions.",
    "description": "JSch ServerAliveInterval in seconds for remote SSH sessions."
  },
  {
    "section": "Timeouts",
    "key": "dockerCommandTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Deprecated. Legacy docker-wrapped terminal command timeout."
  },
  {
    "section": "Timeouts",
    "key": "databaseLoginTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for database login."
  },
  {
    "section": "Timeouts",
    "key": "databaseNetworkTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for database network operations."
  },
  {
    "section": "Timeouts",
    "key": "databaseQueryTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for database queries."
  },
  {
    "section": "Timeouts",
    "key": "waitForRemoteServerToBeUp",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Wait for remote server to be up before execution."
  },
  {
    "section": "Timeouts",
    "key": "timeoutForRemoteServerToBeUp",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "1",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for remote server to be up."
  },
  {
    "section": "Timeouts",
    "key": "remoteServerInstanceCreationTimeout",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "5",
    "possibleValues": "(seconds)",
    "description": "Timeout in seconds for remote server instance creation."
  },
  {
    "section": "Visuals",
    "key": "visualMatchingThreshold",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "0.90",
    "possibleValues": "any decimal value between 0.00 and 1.00",
    "description": "Visual matching threshold for AI powered element identification."
  },
  {
    "section": "Visuals",
    "key": "screenshotParams_scalingFactor",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "1.0",
    "possibleValues": "example: 1.0, 0.5, 2.0",
    "description": "Scaling factor for screenshots."
  },
  {
    "section": "Visuals",
    "key": "screenshotParams_whenToTakeAScreenshot",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "ValidationPointsOnly",
    "possibleValues": "Always, ValidationPointsOnly, FailuresOnly, Never",
    "description": "Granular screenshot policy. Profile levels except CUSTOM override this after property loading."
  },
  {
    "section": "Visuals",
    "key": "screenshotParams_screenshotType",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "fullPage",
    "possibleValues": "fullPage, regular, element",
    "description": "Type of screenshot to capture."
  },
  {
    "section": "Visuals",
    "key": "screenshotParams_highlightElements",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Highlight elements in screenshots."
  },
  {
    "section": "Visuals",
    "key": "screenshotParams_highlightMethod",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "AI",
    "possibleValues": "AI, NATIVE",
    "description": "Method for highlighting elements in screenshots."
  },
  {
    "section": "Visuals",
    "key": "screenshotParams_skippedElementsFromScreenshot",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "CSS selectors separated by commas",
    "description": "Elements to skip/hide when taking screenshots."
  },
  {
    "section": "Visuals",
    "key": "screenshotParams_watermark",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Add watermark to screenshots."
  },
  {
    "section": "Visuals",
    "key": "screenshotParams_watermarkOpacity",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "0.2",
    "possibleValues": "0.0 to 1.0",
    "description": "Opacity level for screenshot watermark."
  },
  {
    "section": "Visuals",
    "key": "createAnimatedGif",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Granular GIF policy. Profile levels except CUSTOM override this after property loading; retry attempts can enable GIFs automatically."
  },
  {
    "section": "Visuals",
    "key": "animatedGif_frameDelay",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "500",
    "possibleValues": "milliseconds",
    "description": "Delay between frames in animated GIF."
  },
  {
    "section": "Visuals",
    "key": "videoParams_recordVideo",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Granular video policy. Profile levels except CUSTOM override this after property loading."
  },
  {
    "section": "Visuals",
    "key": "videoParams_scope",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "DriverSession",
    "possibleValues": "DriverSession, TestMethod",
    "description": "Scope for video recording."
  },
  {
    "section": "Visuals",
    "key": "whenToTakePageSourceSnapshot",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "Never",
    "possibleValues": "Never, Always, FailuresOnly",
    "description": "Granular page-source policy. Profile levels except CUSTOM override this after property loading."
  },
  {
    "section": "Visuals",
    "key": "shaft.updateSnapshots",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "When true, regenerates visual and ARIA-snapshot baselines instead of comparing new captures against the existing ones."
  },
  {
    "section": "Jira",
    "key": "jiraInteraction",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable Jira integration for test management."
  },
  {
    "section": "Jira",
    "key": "jiraUrl",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "https://",
    "possibleValues": "URL",
    "description": "Jira instance URL."
  },
  {
    "section": "Jira",
    "key": "projectKey",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "String",
    "description": "Jira project key."
  },
  {
    "section": "Jira",
    "key": "authorization",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "username:token",
    "description": "Jira authorization credentials (username:token or username:password).",
    "sensitive": true
  },
  {
    "section": "Jira",
    "key": "authType",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "basic",
    "possibleValues": "basic, bearer",
    "description": "Authorization type for Jira API."
  },
  {
    "section": "Jira",
    "key": "reportTestCasesExecution",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Report test case execution results to Jira/Xray."
  },
  {
    "section": "Jira",
    "key": "reportPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "target/surefire-reports/testng-results.xml",
    "possibleValues": "File path",
    "description": "Path to test results file for Jira/Xray reporting."
  },
  {
    "section": "Jira",
    "key": "ExecutionName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "String",
    "description": "Name for test execution in Jira/Xray."
  },
  {
    "section": "Jira",
    "key": "ExecutionDescription",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "String",
    "description": "Description for test execution in Jira/Xray."
  },
  {
    "section": "Jira",
    "key": "ReportBugs",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Automatically report bugs to Jira on test failures."
  },
  {
    "section": "Jira",
    "key": "assignee",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "String",
    "description": "Default assignee for reported bugs."
  },
  {
    "section": "Jira",
    "key": "allure.link.tms.pattern",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "https:///{}",
    "possibleValues": "URL pattern",
    "description": "Pattern for TMS (Test Management System) links in Allure."
  },
  {
    "section": "Jira",
    "key": "allure.link.custom.pattern",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "{}",
    "possibleValues": "URL pattern",
    "description": "Pattern for custom links in Allure reports."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.ansi-colors.disabled",
    "targetFile": "cucumber.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "True to disable ANSI colors; false to keep them enabled."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.execution.dry-run",
    "targetFile": "cucumber.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "True to enable dry-run mode; false for normal execution."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.execution.limit",
    "targetFile": "cucumber.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "The execution limit as a string, or empty for unlimited."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.execution.order",
    "targetFile": "cucumber.properties",
    "type": "text",
    "defaultValue": "lexical",
    "possibleValues": "",
    "description": "The execution order string."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.execution.strict",
    "targetFile": "cucumber.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "True to fail on undefined/pending steps; false to allow them."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.execution.wip",
    "targetFile": "cucumber.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "True to enable WIP mode; false otherwise."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.features",
    "targetFile": "cucumber.properties",
    "type": "text",
    "defaultValue": "src/test/resources",
    "possibleValues": "",
    "description": "The features path string."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.filter.name",
    "targetFile": "cucumber.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "The name filter regex, or empty to run all scenarios."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.filter.tags",
    "targetFile": "cucumber.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "The tag filter expression, or empty to run all scenarios."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.glue",
    "targetFile": "cucumber.properties",
    "type": "text",
    "defaultValue": "customCucumberSteps, com.shaft.cucumber",
    "possibleValues": "",
    "description": "The glue path(s) string."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.plugin",
    "targetFile": "cucumber.properties",
    "type": "text",
    "defaultValue": "pretty, json:allure-results/cucumber.json, html:allure-results/cucumberReport.html, com.shaft.listeners.CucumberTestRunnerListener",
    "possibleValues": "",
    "description": "The plugin configuration string."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.object-factory",
    "targetFile": "cucumber.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "The object factory class name, or empty to use the default."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.snippet-type",
    "targetFile": "cucumber.properties",
    "type": "text",
    "defaultValue": "underscore",
    "possibleValues": "",
    "description": "The snippet type string."
  },
  {
    "section": "Cucumber",
    "key": "cucumber.publish.quiet",
    "targetFile": "cucumber.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "True to suppress the publish banner; false to display it."
  },
  {
    "section": "Healenium",
    "key": "recovery-tries",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "1",
    "possibleValues": "",
    "description": "Number of Healenium self-healing recovery attempts before giving up on a broken locator."
  },
  {
    "section": "Healenium",
    "key": "score-cap",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "0.5",
    "possibleValues": "",
    "description": "Minimum Healenium similarity score (0.0-1.0) required to accept a healed locator candidate."
  },
  {
    "section": "Healenium",
    "key": "heal-enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enables the Healenium self-healing proxy for this run."
  },
  {
    "section": "Healenium",
    "key": "serverHost",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "localhost",
    "possibleValues": "",
    "description": "Hostname of the Healenium server that scores locator-healing candidates."
  },
  {
    "section": "Healenium",
    "key": "serverPort",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "7878",
    "possibleValues": "",
    "description": "Port of the Healenium server that scores locator-healing candidates."
  },
  {
    "section": "Healenium",
    "key": "imitatePort",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "8000",
    "possibleValues": "",
    "description": "Local port SHAFT points the browser at to imitate the real Selenium server so Healenium can intercept traffic."
  },
  {
    "section": "Healing",
    "key": "healing.strategy",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "disabled",
    "possibleValues": "disabled, healenium, shaft-heal, composite",
    "description": "Selects the locator recovery strategy."
  },
  {
    "section": "Healing",
    "key": "healing.minimumConfidence",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "0.75",
    "possibleValues": "0.0-1.0",
    "description": "Minimum deterministic confidence when no trust percentage override is set."
  },
  {
    "section": "Healing",
    "key": "healing.minimumTrustPercentage",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "-1",
    "possibleValues": "-1, 0-100",
    "description": "Preferred human-readable trust gate. -1 keeps using healing.minimumConfidence."
  },
  {
    "section": "Healing",
    "key": "healing.ambiguityMargin",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "0.10",
    "possibleValues": "0.0-1.0",
    "description": "Required lead over the next eligible candidate."
  },
  {
    "section": "Healing",
    "key": "healing.evidenceCategories",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "accessibility,label,test-id,stable-id-name,semantic,dom-fingerprint,native-state,ancestor-context,history",
    "possibleValues": "comma-separated categories",
    "description": "Deterministic evidence categories allowed for recovery."
  },
  {
    "section": "Healing",
    "key": "healing.testIdAttributes",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "data-testid,data-test,data-qa",
    "possibleValues": "comma-separated attributes",
    "description": "Attributes treated as stable test IDs."
  },
  {
    "section": "Healing",
    "key": "healing.history.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Enables bounded local recovery history."
  },
  {
    "section": "Healing",
    "key": "healing.history.path",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "target/shaft-heal/history.json",
    "possibleValues": "path",
    "description": "Local recovery history file."
  },
  {
    "section": "Healing",
    "key": "healing.history.maxEntries",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "500",
    "possibleValues": "integer",
    "description": "Maximum retained history entries."
  },
  {
    "section": "Healing",
    "key": "healing.history.retentionDays",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "30",
    "possibleValues": "integer",
    "description": "Maximum history age in days."
  },
  {
    "section": "Healing",
    "key": "healing.visual.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enables optional local visual evidence."
  },
  {
    "section": "Healing",
    "key": "healing.ai.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enables optional provider reranking after deterministic eligibility."
  },
  {
    "section": "Healing",
    "key": "healing.ai.trigger",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "ambiguous",
    "possibleValues": "never, ambiguous, below-threshold, always",
    "description": "Controls when enabled AI reranking runs after deterministic scoring."
  },
  {
    "section": "Healing",
    "key": "healing.sourcePatch.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Reserved consent gate for reviewed source-patch proposals."
  },
  {
    "section": "Natural Actions",
    "key": "naturalActions.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enables driver.act(...). Disabled plans fail before execution."
  },
  {
    "section": "Natural Actions",
    "key": "naturalActions.minimumTrustPercentage",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "85",
    "possibleValues": "0-100",
    "description": "Minimum plan trust required before execution."
  },
  {
    "section": "Natural Actions",
    "key": "naturalActions.planner",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "deterministic",
    "possibleValues": "deterministic, auto, or a ServiceLoader planner ID",
    "description": "Selects the natural-action planner."
  },
  {
    "section": "Natural Actions",
    "key": "naturalActions.aiFallback.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Allows optional provider-assisted planners after deterministic planning is unavailable."
  },
  {
    "section": "Natural Actions",
    "key": "naturalActions.aiFallback.threshold",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "0",
    "possibleValues": "0-1",
    "description": "Confidence threshold below which AI fallback is triggered."
  },
  {
    "section": "Natural Actions",
    "key": "naturalActions.allowedActions",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "browser,element,touch",
    "possibleValues": "comma-separated browser, element, touch",
    "description": "Restricts which action categories natural actions may execute."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Whether optional AI execution is enabled."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.provider",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "none",
    "possibleValues": "",
    "description": "Selected provider identifier."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.consent.local",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Whether local inference is approved."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.consent.onPrem",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Whether explicitly classified on-prem inference is approved."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.consent.remote",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Whether remote inference is approved."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.allowedEvidenceCategories",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Comma-separated approved evidence categories."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.telemetry.enabled",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Whether optional external telemetry is enabled."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.timeoutSeconds",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "300",
    "possibleValues": "",
    "description": "Maximum provider timeout in seconds."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.maxRequestBytes",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "1048576",
    "possibleValues": "",
    "description": "Maximum serialized request size."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.maxInputTokens",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "16000",
    "possibleValues": "",
    "description": "Maximum estimated input tokens."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.maxOutputTokens",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "2000",
    "possibleValues": "",
    "description": "Maximum output tokens."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.maxCostUsd",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "0",
    "possibleValues": "",
    "description": "Maximum accepted provider-reported cost in USD."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.retryMaxAttempts",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "2",
    "possibleValues": "",
    "description": "Maximum provider execution attempts."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.maxConcurrency",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "2",
    "possibleValues": "",
    "description": "Maximum concurrent calls per provider."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.circuitBreaker.failureThreshold",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "3",
    "possibleValues": "",
    "description": "Failures required to open the circuit."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.circuitBreaker.cooldownSeconds",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "60",
    "possibleValues": "",
    "description": "Circuit-open cooldown in seconds."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.redaction.selectors",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "input[type=password],[autocomplete=current-password],[autocomplete=new-password]",
    "possibleValues": "",
    "description": "Comma-separated CSS selectors to redact."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.redaction.attributes",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "authorization,cookie,set-cookie,password,passwd,secret,token,api-key,apikey,access-key",
    "possibleValues": "",
    "description": "Comma-separated structured or DOM attributes to redact."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.redaction.patterns",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Double-semicolon-separated custom regular expressions."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.openai.endpoint",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "https://api.openai.com/v1/responses",
    "possibleValues": "",
    "description": "OpenAI Responses endpoint."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.openai.model",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Configured OpenAI model."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.openai.apiKeyEnvironmentVariable",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "OPENAI_API_KEY",
    "possibleValues": "",
    "description": "Environment variable containing the OpenAI credential."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.openai.processingLocation",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "remote",
    "possibleValues": "",
    "description": "Explicit OpenAI endpoint processing location."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.anthropic.endpoint",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "https://api.anthropic.com/v1/messages",
    "possibleValues": "",
    "description": "Anthropic Messages endpoint."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.anthropic.model",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Configured Anthropic model."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.anthropic.apiKeyEnvironmentVariable",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "ANTHROPIC_API_KEY",
    "possibleValues": "",
    "description": "Environment variable containing the Anthropic credential."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.anthropic.processingLocation",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "remote",
    "possibleValues": "",
    "description": "Explicit Anthropic endpoint processing location."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.anthropic.version",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "2023-06-01",
    "possibleValues": "",
    "description": "Anthropic API contract version."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.gemini.endpoint",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "https://generativelanguage.googleapis.com/v1beta/models",
    "possibleValues": "",
    "description": "Gemini models endpoint."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.gemini.model",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "gemini-3.5-flash",
    "possibleValues": "",
    "description": "Configured Gemini model."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.gemini.apiKeyEnvironmentVariable",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "GEMINI_API_KEY",
    "possibleValues": "",
    "description": "Environment variable containing the Gemini credential."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.gemini.processingLocation",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "remote",
    "possibleValues": "",
    "description": "Explicit Gemini endpoint processing location."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.github.endpoint",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "https://models.github.ai/inference/chat/completions",
    "possibleValues": "",
    "description": "GitHub Models chat-completions endpoint."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.github.model",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Configured GitHub Models model."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.github.apiKeyEnvironmentVariable",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "GITHUB_TOKEN",
    "possibleValues": "",
    "description": "Environment variable containing the GitHub credential."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.github.processingLocation",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "remote",
    "possibleValues": "",
    "description": "Explicit GitHub Models endpoint processing location."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.ollama.endpoint",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "http://127.0.0.1:11434/api/chat",
    "possibleValues": "",
    "description": "Ollama chat endpoint."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.ollama.model",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Configured Ollama model."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.ollama.processingLocation",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "local",
    "possibleValues": "",
    "description": "Explicit Ollama endpoint processing location."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.ollama.apiKeyEnvironmentVariable",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Optional environment variable containing an on-prem Ollama gateway credential."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.ollama.apiKeyHeader",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "Authorization",
    "possibleValues": "",
    "description": "Optional Ollama gateway credential header."
  },
  {
    "section": "Pilot",
    "key": "pilot.ai.ollama.apiKeyPrefix",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "Bearer ",
    "possibleValues": "",
    "description": "Optional Ollama gateway credential prefix."
  },
  {
    "section": "Paths",
    "key": "propertiesFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "src/main/resources/properties/",
    "possibleValues": "",
    "description": "Path to the custom properties files folder."
  },
  {
    "section": "Paths",
    "key": "defaultPropertiesFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "src/main/resources/properties/default",
    "possibleValues": "",
    "description": "Path to the default properties files folder."
  },
  {
    "section": "Paths",
    "key": "aiAgentWorkspaceRoot",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Workspace root for SHAFT agent tooling."
  },
  {
    "section": "Paths",
    "key": "dynamicObjectRepositoryPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "src/main/resources/dynamicObjectRepository/",
    "possibleValues": "",
    "description": "Path to the dynamic object repository folder."
  },
  {
    "section": "Paths",
    "key": "ariaSnapshotFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "src/test/resources/aria/",
    "possibleValues": "",
    "description": "Folder that holds saved ARIA-snapshot baselines used for accessibility-tree comparisons; regenerate with -Dshaft.updateSnapshots=true."
  },
  {
    "section": "Paths",
    "key": "testDataFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "src/test/resources/testDataFiles/",
    "possibleValues": "",
    "description": "Path to the test data files folder."
  },
  {
    "section": "Paths",
    "key": "downloadsFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "target/downloadedFiles",
    "possibleValues": "",
    "description": "Path to the folder for downloaded files."
  },
  {
    "section": "Paths",
    "key": "allureResultsFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "allure-results/",
    "possibleValues": "",
    "description": "Path to the Allure results output folder."
  },
  {
    "section": "Paths",
    "key": "extentReportsFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "extent-reports/",
    "possibleValues": "",
    "description": "Path to the Extent reports output folder."
  },
  {
    "section": "Paths",
    "key": "executionSummaryReportFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "execution-summary/",
    "possibleValues": "",
    "description": "Path to the execution summary report folder."
  },
  {
    "section": "Paths",
    "key": "PerformanceReportFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "performanceReport/",
    "possibleValues": "",
    "description": "Path to the performance (Lighthouse) report output folder."
  },
  {
    "section": "Paths",
    "key": "video.folder",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "allure-results/videos",
    "possibleValues": "",
    "description": "Path to the folder where recorded videos and generated animated GIF files are saved."
  },
  {
    "section": "Paths",
    "key": "applitoolsApiKey",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Applitools API key for visual AI testing integration.",
    "sensitive": true
  },
  {
    "section": "Paths",
    "key": "servicesFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "src/test/resources/META-INF/services/",
    "possibleValues": "",
    "description": "Path to the META-INF services folder for custom service implementations."
  },
  {
    "section": "Paths",
    "key": "authCacheFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "target/auth-cache/",
    "possibleValues": "",
    "description": "Folder that holds SHAFT.Auth.setup(name, flow) storage-state cache files (one JSON file per name)."
  },
  {
    "section": "Paths",
    "key": "mobileSessionCacheFolderPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "target/mobile-session-cache/",
    "possibleValues": "",
    "description": "Folder that holds TouchActions.saveSessionCapabilities/saveAppState JSON snapshots used to reuse Appium session capabilities and mobile app state across test runs."
  },
  {
    "section": "Pattern",
    "key": "testDataColumnNamePrefix",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "Data",
    "possibleValues": "",
    "description": "Prefix used when naming generated data-provider parameters in test reports."
  },
  {
    "section": "Pattern",
    "key": "allure.link.issue.pattern",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "URL pattern used to turn @Issue/@Issues annotation values into clickable links in the Allure report; use {} as the issue-ID placeholder."
  },
  {
    "section": "Tinkey",
    "key": "tinkey.keysetFilename",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Path to the Google Tink keyset file used to encrypt/decrypt sensitive test data."
  },
  {
    "section": "Tinkey",
    "key": "tinkey.kms.serverType",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Key Management Service provider backing the Tink keyset (e.g. gcp-kms, aws-kms)."
  },
  {
    "section": "Tinkey",
    "key": "tinkey.kms.credentialPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Path to the KMS provider credential file used to access the remote master key.",
    "sensitive": true
  },
  {
    "section": "Tinkey",
    "key": "tinkey.kms.masterKeyUri",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "URI of the remote KMS master key used to encrypt/decrypt the local Tink keyset."
  },
  {
    "section": "Internal",
    "key": "shaftEngineVersion",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "10.3.20260717",
    "possibleValues": "version string",
    "description": "Engine version used by update checks, telemetry metadata, and internal tooling."
  },
  {
    "section": "Internal",
    "key": "watermarkImagePath",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "https://raw.githubusercontent.com/ShaftHQ/SHAFT_ENGINE/main/shaft-engine/src/main/resources/images/shaft_white_bg.png",
    "possibleValues": "URL or file path",
    "description": "Default watermark image used by screenshot processing."
  },
  {
    "section": "Internal",
    "key": "allure3Version",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "3.14.3",
    "possibleValues": "Allure 3 npm package version",
    "description": "Allure 3 CLI package version used when SHAFT resolves the CLI through npx."
  },
  {
    "section": "Internal",
    "key": "nodeLtsVersion",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "24.18.0",
    "possibleValues": "Node.js version",
    "description": "Portable Node.js version downloaded when neither allure nor npx is available on PATH."
  },
  {
    "section": "Internal",
    "key": "appiumServerVersion",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "3.5.2",
    "possibleValues": "Appium npm package version",
    "description": "Appium server version used by SHAFT MCP local mobile bootstrap."
  },
  {
    "section": "Internal",
    "key": "appiumInspectorPluginVersion",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "2026.5.1",
    "possibleValues": "Appium Inspector plugin version",
    "description": "Appium Inspector plugin version used by SHAFT MCP wrapped mobile recording."
  },
  {
    "section": "Internal",
    "key": "appiumUiAutomator2DriverVersion",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "8.1.0",
    "possibleValues": "Appium driver version",
    "description": "Appium UiAutomator2 driver version used by SHAFT MCP for Android."
  },
  {
    "section": "Internal",
    "key": "appiumXcuitestDriverVersion",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "11.17.7",
    "possibleValues": "Appium driver version",
    "description": "Appium XCUITest driver version used by SHAFT MCP for iOS."
  },
  {
    "section": "Internal",
    "key": "androidCommandLineToolsVersion",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "15859902",
    "possibleValues": "Android command-line tools build number",
    "description": "Android command-line tools version used when SHAFT MCP bootstraps Android SDK tools."
  },
  {
    "section": "Internal",
    "key": "androidEmulatorApiLevel",
    "targetFile": "internal.properties",
    "type": "number",
    "defaultValue": "36",
    "possibleValues": "Android API level",
    "description": "Default Android API level proposed for SHAFT-managed emulator creation."
  },
  {
    "section": "Internal",
    "key": "androidEmulatorDeviceProfile",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "pixel_8",
    "possibleValues": "Android virtual device profile",
    "description": "Default Android virtual device profile proposed for SHAFT-managed emulators."
  },
  {
    "section": "Internal",
    "key": "androidEmulatorImageTag",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "google_apis",
    "possibleValues": "Android system image tag",
    "description": "Default Android system image tag proposed for SHAFT-managed emulators."
  },
  {
    "section": "Internal",
    "key": "androidEmulatorRamMb",
    "targetFile": "internal.properties",
    "type": "number",
    "defaultValue": "4096",
    "possibleValues": "megabytes",
    "description": "Default Android emulator RAM size in MB."
  },
  {
    "section": "Internal",
    "key": "androidEmulatorCores",
    "targetFile": "internal.properties",
    "type": "number",
    "defaultValue": "2",
    "possibleValues": "CPU core count",
    "description": "Default Android emulator CPU core count."
  },
  {
    "section": "Internal",
    "key": "ga4MeasurementId",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "G-4L9L79WZBV",
    "possibleValues": "GA4 Measurement ID",
    "description": "Google Analytics 4 Measurement ID used for anonymous telemetry."
  },
  {
    "section": "Internal",
    "key": "ga4ApiSecret",
    "targetFile": "internal.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "GA4 API secret",
    "description": "Supply privately through internal.properties; do not commit real secrets.",
    "sensitive": true
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.userName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "BrowserStack username for authentication.",
    "sensitive": true
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.accessKey",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "BrowserStack access key for authentication.",
    "sensitive": true
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.platformVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Mobile platform version for BrowserStack execution."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.deviceName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Mobile device name for BrowserStack execution."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.appUrl",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Use a BrowserStack app URL for a previously uploaded app; takes precedence over remote mobile_app."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.customID",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Use customID to test the latest uploaded version as the above url expires regularly."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.appName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "App name for uploading to BrowserStack."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.appRelativeFilePath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Relative file path to the app for SHAFT/BrowserStack upload workflows."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.osVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "In case of Desktop web testing you must also set the targetOperatingSystem, and targetBrowserName."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.browserVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Browser version, optional, uses random by default."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.local",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable BrowserStack local testing."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.seleniumVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "4.40.0",
    "possibleValues": "",
    "description": "Selenium version to use on BrowserStack."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.acceptInsecureCerts",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Accept insecure SSL certificates."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.debug",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable debug mode for BrowserStack."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.networkLogs",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable network logs capture on BrowserStack."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.geoLocation",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Set geolocation for BrowserStack tests."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.appiumVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "3.1.0",
    "possibleValues": "",
    "description": "Appium version to use on BrowserStack for mobile testing."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.buildName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Build name to group test runs in the BrowserStack dashboard."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.projectName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Project name to group builds in the BrowserStack dashboard."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.parallelsPerPlatform",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "1",
    "possibleValues": "",
    "description": "Number of parallel sessions to run per platform when using the BrowserStack SDK."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.browserstackAutomation",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Enable BrowserStack Automation (SDK mode). Set to false to use legacy WebDriver URL mode."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.platformsList",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Comma-separated list of platforms for cross-browser/cross-device parallel runs (SDK mode)."
  },
  {
    "section": "BrowserStack",
    "key": "browserStack.customBrowserStackYmlPath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Path to a custom browserstack.yml configuration file. Overrides individual BrowserStack properties."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.username",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "LambdaTest username for authentication.",
    "sensitive": true
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.accessKey",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "LambdaTest access key for authentication.",
    "sensitive": true
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.platformVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Mobile platform version for LambdaTest execution."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.deviceName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Mobile device name for LambdaTest execution."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.appUrl",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Use appUrl to test a previously uploaded app file."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.appProfiling",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable app profiling during mobile testing."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.osVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "OS version for desktop browser testing on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.visual",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable visual logs (screenshots) on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.video",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable video recording on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.appName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Use appName and appRelativeFilePath to upload a new app file and test it"
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.appRelativeFilePath",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Use appName and appRelativeFilePath to upload a new app file and test it"
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.resolution",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Screen resolution for desktop browser testing (e.g. 1920x1080)."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.headless",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable headless browser execution on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.timezone",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Timezone for test execution on LambdaTest (e.g. UTC+5:30)."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.project",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "shaft-engine",
    "possibleValues": "",
    "description": "Project name to group builds in the LambdaTest dashboard."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.build",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "Build Name",
    "possibleValues": "",
    "description": "Build name to group test runs in the LambdaTest dashboard."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.tunnel",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable LambdaTest tunnel for testing locally hosted applications."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.tunnelName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "false",
    "possibleValues": "",
    "description": "Name of the LambdaTest tunnel to use when LambdaTest.tunnel is enabled."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.buildName",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Build name used in the LambdaTest SDK configuration. Use this instead of LambdaTest.build when using the LambdaTest SDK (automate-config.yml)."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.selenium_version",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Selenium version to use on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.driver_version",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Browser driver version to use on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.w3c",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Enable W3C WebDriver protocol on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.browserVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Browser version, optional, uses random by default."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.geoLocation",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Geolocation for test execution (e.g. US, IN)."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.debug",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable debug mode (command logs) on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.acceptInsecureCerts",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Accept insecure SSL certificates on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.networkLogs",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable network logs capture on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.appiumVersion",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "3.0.2",
    "possibleValues": "",
    "description": "Appium version to use on LambdaTest for mobile testing."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.autoGrantPermissions",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Automatically grant app permissions on mobile devices."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.autoAcceptAlerts",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Automatically accept alerts on mobile devices."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.isRealMobile",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Run tests on real mobile devices (as opposed to emulators/simulators)."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.console",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable console log capture on LambdaTest."
  },
  {
    "section": "LambdaTest",
    "key": "LambdaTest.customID",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "",
    "description": "Custom app ID for testing a previously uploaded app by its custom identifier."
  },
  {
    "section": "Performance",
    "key": "lightHouseExecution",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Enable WebDriver Lighthouse performance testing execution."
  },
  {
    "section": "Performance",
    "key": "lightHouseExecution.port",
    "targetFile": "custom.properties",
    "type": "number",
    "defaultValue": "8888",
    "possibleValues": "port number",
    "description": "Port to use for Lighthouse performance testing."
  },
  {
    "section": "Performance",
    "key": "generatePerformanceReport",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "true",
    "possibleValues": "true, false",
    "description": "Generate API and browser performance report files when timing data exists."
  },
  {
    "section": "Performance",
    "key": "apiEndpointPerformanceBudgets",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "endpoint=milliseconds list",
    "description": "Optional p95 API endpoint budgets using normalized endpoint names, separated by commas, semicolons, or new lines."
  },
  {
    "section": "Performance",
    "key": "failOnApiPerformanceBudgetViolation",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Fail the run when an API endpoint p95 budget is exceeded; otherwise log a warning."
  },
  {
    "section": "Performance",
    "key": "browserActionPerformanceBudgets",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "metric=milliseconds list",
    "description": "Optional p95 Playwright browser action budgets, such as playwright.element.click=750 or *=1000."
  },
  {
    "section": "Performance",
    "key": "pageLoadPerformanceBudgets",
    "targetFile": "custom.properties",
    "type": "text",
    "defaultValue": "",
    "possibleValues": "page=milliseconds list",
    "description": "Optional p95 Playwright page-load budgets using navigated URLs or * as a default budget."
  },
  {
    "section": "Performance",
    "key": "failOnBrowserPerformanceBudgetViolation",
    "targetFile": "custom.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Fail the run when a Playwright browser action or page-load p95 budget is exceeded; otherwise log a warning."
  },
  {
    "section": "TestNG",
    "key": "setParallel",
    "targetFile": "TestNG.properties",
    "type": "text",
    "defaultValue": "NONE",
    "possibleValues": "METHODS, CLASSES, TESTS, INSTANCES",
    "description": "TestNG parallel execution mode (maps to the generated suite's parallel attribute)."
  },
  {
    "section": "TestNG",
    "key": "setParallelMode",
    "targetFile": "TestNG.properties",
    "type": "text",
    "defaultValue": "STATIC",
    "possibleValues": "STATIC, DYNAMIC",
    "description": "Selects how setThreadCount is applied: STATIC uses it as-is, DYNAMIC multiplies it by the available processor cores."
  },
  {
    "section": "TestNG",
    "key": "setThreadCount",
    "targetFile": "TestNG.properties",
    "type": "number",
    "defaultValue": "1.0d",
    "possibleValues": "",
    "description": "ThreadCount is used as-is in case of STATIC mode. Total ThreadCount is automatically calculated for DYNAMIC mode; (Total ThreadCount = Number of available processor cores * setThreadCount)"
  },
  {
    "section": "TestNG",
    "key": "setVerbose",
    "targetFile": "TestNG.properties",
    "type": "number",
    "defaultValue": "0",
    "possibleValues": "",
    "description": "TestNG verbose logging level for the generated suite (0 = silent)."
  },
  {
    "section": "TestNG",
    "key": "setPreserveOrder",
    "targetFile": "TestNG.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Preserve declaration order of test methods/classes instead of TestNG's default ordering."
  },
  {
    "section": "TestNG",
    "key": "setGroupByInstances",
    "targetFile": "TestNG.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Group parallel test methods by instance instead of running them independently."
  },
  {
    "section": "TestNG",
    "key": "setDataProviderThreadCount",
    "targetFile": "TestNG.properties",
    "type": "number",
    "defaultValue": "1",
    "possibleValues": "",
    "description": "Number of threads TestNG uses to run @DataProvider-fed test invocations in parallel."
  },
  {
    "section": "TestNG",
    "key": "testSuiteTimeout",
    "targetFile": "TestNG.properties",
    "type": "number",
    "defaultValue": "1440",
    "possibleValues": "minutes",
    "description": "Test suite timeout. Default is 1440 minutes, or 24 hours."
  },
  {
    "section": "Log4j",
    "key": "name",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "PropertiesConfig",
    "possibleValues": "",
    "description": "Log4j2 configuration name, used internally as this configuration's identifier."
  },
  {
    "section": "Log4j",
    "key": "appender.console.type",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "Console",
    "possibleValues": "",
    "description": "Log4j2 appender type for the console output target (Console)."
  },
  {
    "section": "Log4j",
    "key": "appender.console.name",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "STDOUT",
    "possibleValues": "",
    "description": "Reference name of the console appender, used by rootLogger and other loggers to attach to it."
  },
  {
    "section": "Log4j",
    "key": "appender.console.layout.type",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "PatternLayout",
    "possibleValues": "",
    "description": "Log4j2 layout implementation used to format console log lines (PatternLayout)."
  },
  {
    "section": "Log4j",
    "key": "appender.console.layout.disableAnsi",
    "targetFile": "log4j2.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Disables ANSI color codes in console log output."
  },
  {
    "section": "Log4j",
    "key": "appender.console.layout.noConsoleNoAnsi",
    "targetFile": "log4j2.properties",
    "type": "boolean",
    "defaultValue": "false",
    "possibleValues": "true, false",
    "description": "Automatically disables ANSI colors when output isn't attached to a real console (e.g. redirected to a file)."
  },
  {
    "section": "Log4j",
    "key": "appender.console.layout.charset",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "UTF-8",
    "possibleValues": "",
    "description": "Character encoding used when writing console log output."
  },
  {
    "section": "Log4j",
    "key": "appender.console.layout.pattern",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "%highlight{[%p]}{FATAL=red blink, ERROR=red bold, WARN=yellow bold, INFO=fg_#0060a8 bold, DEBUG=fg_#43b02a bold, TRACE=black} %style{%d{HH:mm:ss}}{bright_black} %style{|}{bright_black} %m%n",
    "possibleValues": "",
    "description": "Click here to learn more about log4j2 pattern layouts"
  },
  {
    "section": "Log4j",
    "key": "appender.console.filter.threshold.type",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "ThresholdFilter",
    "possibleValues": "",
    "description": "Log4j2 filter type applied to the console appender (ThresholdFilter)."
  },
  {
    "section": "Log4j",
    "key": "appender.console.filter.threshold.level",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "info",
    "possibleValues": "fatal, error, warn, info, debug, trace",
    "description": "Minimum log level written to the console; messages below this level are suppressed."
  },
  {
    "section": "Log4j",
    "key": "appender.file.type",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "File",
    "possibleValues": "",
    "description": "Log4j2 appender type for the rolling log file (RollingFile)."
  },
  {
    "section": "Log4j",
    "key": "appender.file.name",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "LOGFILE",
    "possibleValues": "",
    "description": "Reference name of the file appender, used by rootLogger and other loggers to attach to it."
  },
  {
    "section": "Log4j",
    "key": "appender.file.fileName",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "target/logs/log4j.log",
    "possibleValues": "",
    "description": "Path to the active log file that SHAFT writes execution logs to."
  },
  {
    "section": "Log4j",
    "key": "appender.file.layout.type",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "PatternLayout",
    "possibleValues": "",
    "description": "Log4j2 layout implementation used to format file log lines (PatternLayout)."
  },
  {
    "section": "Log4j",
    "key": "appender.file.layout.pattern",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %c{1} - %msg%n",
    "possibleValues": "",
    "description": "Log4j2 PatternLayout string controlling the format of each file log line."
  },
  {
    "section": "Log4j",
    "key": "appender.file.layout.charset",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "UTF-8",
    "possibleValues": "",
    "description": "Character encoding used when writing the log file."
  },
  {
    "section": "Log4j",
    "key": "appender.file.filter.threshold.type",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "ThresholdFilter",
    "possibleValues": "",
    "description": "Log4j2 filter type applied to the file appender (ThresholdFilter)."
  },
  {
    "section": "Log4j",
    "key": "appender.file.filter.threshold.level",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "debug",
    "possibleValues": "fatal, error, warn, info, debug, trace",
    "description": "Minimum log level written to the log file; messages below this level are suppressed."
  },
  {
    "section": "Log4j",
    "key": "rootLogger",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "info, ASYNC_STDOUT, ASYNC_LOGFILE, ASYNC_REPORT_PORTAL",
    "possibleValues": "",
    "description": "Uses asynchronous appenders for console, file, and ReportPortal logging."
  },
  {
    "section": "Log4j",
    "key": "logger.app.name",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "org.apache.http.impl.client",
    "possibleValues": "",
    "description": "Fully qualified logger name whose level is overridden by logger.app.level (defaults to a noisy third-party logger)."
  },
  {
    "section": "Log4j",
    "key": "logger.app.level",
    "targetFile": "log4j2.properties",
    "type": "text",
    "defaultValue": "WARN",
    "possibleValues": "",
    "description": "Log level applied to the logger named by logger.app.name, used to quiet noisy third-party libraries."
  }
]