artes 1.7.2 → 1.7.4

package/README.md

@@ -139,61 +139,75 @@ npx artes [options]
 npx artes [options]
 ```
 
-### Options
-
-| Option                    | Description                                                                        | Usage Example                                                         |
-| ------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
-| 🆘 `-h, --help`           | Show the usage options                                                             | `artes -h` or `artes --help`                                          |
-| 🏷️ `-v, --version`        | Show the current version of Artes                                                  | `artes -v` or `artes --version`                                       |
-| 🏗️ `-c, --create`         | Create an example project with Artes                                               | `artes -c` or `artes --create`                                        |
-| ✅ `-y, --yes`            | Skip the confirmation prompt when creating an example project                      | `artes -c -y` or `artes --create --yes`                               |
-| 🚫 --noDeps               | Skip installing dependencies when creating example project                         | `artes -c --noDeps`                                                   |
-| 📊 `-r, --report`         | Run tests and generate Allure report                                               | `artes -r` or `artes --report`                                        |
-| `--reportSuccess`         | Add screenshots and video records for also Success test cases                      | `artes --reportSuccess`                                               |
-| `--trace`                 | Enable tracing                                                                     | `artes --trace`                                                       |
-| `-rwt, --reportWithTrace` | Add trace to the report                                                            | `artes -rwt` or `artes --reportWithTrace`                             |
-| `--singleFileReport`      | Generate single file allure report                                                 | `artes -r --singleFileReport`                                         |
-| `--zip`                   | Zip the report folder after generation                                             | `artes -r --zip`                                                      |
-| `--uploadReport`          | Upload the generated report to Artes Reporting System                              | `artes -r --zip --uploadReport --reporterURL "https://example.com"`            |
-| `--reporterURL`           | URL of the Artes Reporting System to upload the report                             | `artes -r --zip --uploadReport --reporterURL "https://example.com"`            |
-| `--projectName`           | Name of the project in the Artes Reporting System (default: `"Artes Report"`)     | `artes -r --zip --uploadReport --reporterURL "https://example.com" --projectName "My Project"` |
-| `--projectType`           | Type of the project for reporting purposes (default: `"Artes"`)                   | `artes -r --zip --uploadReport --reporterURL "https://example.com" --projectType "API"` |
-| `--reportPath`            | Path to the report zip file to upload (default: `./report.zip`)                   | `artes -r --zip --uploadReport --reporterURL "https://example.com" --reportPath "./my_report.zip"` |
-| 🖼️ `--logo`               | Set a custom logo in the report sidebar. Accepts an absolute path, a relative path, or a direct image URL | `artes -r --logo /abs/path/logo.png`<br>`artes --logo logo.png`<br>`artes --logo 'https://example.com/logo.png'` |
-| 🏢 `--brandName`          | Set the brand name displayed next to the logo in the report sidebar                | `artes --brandName 'My Company'`                                      |
-| 📄 `--reportName`         | Report name displayed on the summary widget and in the Artes Reporting System                       | `artes --reportName 'Alma UI'`  
-| 📁 `--features`           | Specify one or more feature files' relative paths to run (comma-separated)         | `artes --features "tests/features/Alma,tests/features/Banan.feature"` |
-| 📜 `--stepDef`            | Specify one or more step definition files' relative paths to use (comma-separated) | `artes --stepDef "tests/steps/login.js,tests/steps/home.js"`          |
-| 🔖 `--tags`               | Run tests with specified Cucumber tags                                             | `artes --tags "@smoke or @wip"`                                       |
-| 🌐 `--env`                | Set the environment for the test run                                               | `artes --env "dev"`                                                   |
-| `--saveVar`              |  Set the variables from CLI                                                         | `artes --saveVar '{"armud":20,"banana":200}'` |  
-| 🕶️ `--headless`           | Run browser in headless mode                                                       | `artes --headless`                                                    |
-| ⚡ `--parallel`           | Run tests in parallel mode                                                         | `artes --parallel 2`                                                  |
-| 🔁 `--retry`              | Retry failed tests                                                                 | `artes --retry 3`                                                     |
-| 🔁 `--rerun`              | Rerun only the failed tests from previous run                                      | `artes --rerun @rerun.txt`                                            |
-| 🎭 `--dryRun`             | Perform a dry run without executing tests                                          | `artes --dryRun`                                                      |
-| 📈 `--percentage`         | Set minimum success percentage to pass test run (default is 0)                     | `artes --percentage 85`                                               |
-| 🌍 `--browser`            | Specify browser to use (`chromium`, `firefox`, or `webkit`)                        | `artes --browser chromium`                                            |
-| `--offline`               | Run browser in offline mode                                                        | `artes --offline` |
-| 📱 `--device`             | Emulate specific device (e.g., "iPhone 13")                                        | `artes --device "iPhone 13"`   |
-| 🔗 `--baseURL`            | Set base URL for the tests                                                         | `artes --baseURL "https://example.com"`                               |
-| 🖥️ `--maxScreen`          | Maximize browser window on launch                                                  | `artes --maxScreen`                                                   |
-| 📏 `--width`              | Set browser width (default is 1280)                                                | `artes --width 1920`                                                  |
-| 📐 `--height`             | Set browser height (default is 720)                                                | `artes --height 1080`                                                 |
-| ⏱️ `--timeout`            | Set timeout for each test step in seconds (default is 30 seconds)                  | `artes --timeout 10`                                                  |
-| 🐢 `--slowMo`             | Slow down text execution for clear view (default: 0 seconds)                       | `artes --slowMo 1`                                                    |
-
-### AI Options
+
+### General ( artes -h or artes --help )
+
+| Option | Description | Usage Example |
+| --- | --- | --- |
+| `-h, --help` | Show this help message | `artes -h` or `artes --help` |
+| `-v, --version` | Show current version of artes | `artes -v` or `artes --version` |
+| `-c, --create` | Create example artes project | `artes -c` or `artes --create` |
+
+### Reporting & Branding ( artes report --help )
+
+| Option | Description | Usage Example |
+| --- | --- | --- |
+| `-r, --report` | Run tests and generate Allure report | `artes -r` or `artes --report` |
+| `--reportSuccess` | Generate screenshot and video with successful tests too | `artes --reportSuccess` |
+| `--trace` | Enable tracing for all tests | `artes --trace` |
+| `-rwt, --reportWithTrace` | Include trace in the report | `artes -rwt` or `artes --reportWithTrace` |
+| `--singleFileReport` | Generate single file Allure report | `artes -r --singleFileReport` |
+| `--zip` | Zip the report folder after generation | `artes -r --zip` |
+| `--logo` | Set a custom logo in the report sidebar | `artes --logo logo.png` |
+| `--brandName` | Set the brand name displayed next to the logo | `artes --brandName 'My Company'` |
+| `--reportName` | Report name on the summary widget | `artes --reportName 'Alma UI'` |
+| `--uploadReport` | Upload the generated report to Artes Reporting System | `artes -r --zip --uploadReport --reporterURL "https://example.com"` |
+| `--reporterURL` | URL of the Artes Reporting System | `artes --uploadReport --reporterURL "https://example.com"` |
+| `--projectName` | Project name in the Artes Reporting System (default: `"Artes Report"`) | `artes --uploadReport --reporterURL "https://example.com" --projectName "My Project"` |
+| `--projectType` | Project type for reporting, e.g., UI, API (default: `"Artes"`) | `artes --uploadReport --reporterURL "https://example.com" --projectType "API"` |
+| `--reportPath` | Path to the report zip file to upload (default: `./report.zip`) | `artes --uploadReport --reporterURL "https://example.com" --reportPath "./my_report.zip"` |
+
+### Browser ( artes browser --help )
+
+| Option | Description | Usage Example |
+| --- | --- | --- |
+| `--browser` | Specify browser to use (`chromium`, `firefox`, `webkit`) | `artes --browser chromium` |
+| `--device` | Emulate a specific device (e.g., `"iPhone 13"`) | `artes --device "iPhone 13"` |
+| `--maxScreen` | Maximize browser window on launch | `artes --maxScreen` |
+| `--width` | Set browser width (default: `1280`) | `artes --width 1920` |
+| `--height` | Set browser height (default: `720`) | `artes --height 1080` |
+
+### Execution ( artes execution --help )
+
+| Option | Description | Usage Example |
+| --- | --- | --- |
+| `--headless` | Run browser in headless mode | `artes --headless` |
+| `--baseURL` | Set base URL for the tests | `artes --baseURL "https://example.com"` |
+| `--offline` | Run browser in offline mode | `artes --offline` |
+| `--features` | Specify feature file paths to run (comma-separated) | `artes --features "tests/features/Alma,tests/features/Banan.feature"` |
+| `--stepDef` | Specify step definition file paths to use (comma-separated) | `artes --stepDef "tests/steps/login.js,tests/steps/home.js"` |
+| `--tags` | Run tests with specified Cucumber tags | `artes --tags "@smoke and not @wip"` |
+| `--env` | Set the environment for the test run | `artes --env "dev"` |
+| `--saveVar` | Set variables from CLI | `artes --saveVar '{"armud":20,"banana":200}'` |
+| `--parallel` | Run tests in parallel mode | `artes --parallel 3` |
+| `--retry` | Retry failed tests | `artes --retry 2` |
+| `--rerun` | Rerun only failed tests from previous run | `artes --rerun @rerun.txt` |
+| `--dryRun` | Perform a dry run without executing tests | `artes --dryRun` |
+| `--percentage` | Set minimum success percentage to pass test run (default: `0`) | `artes --percentage 85` |
+| `--timeout` | Set timeout for each test step in seconds (default: `30`) | `artes --timeout 10` |
+| `--slowMo` | Slow down execution for clear view (default: `0`) | `artes --slowMo 1` |
+
+### AI Bug Reporter ( artes ai --help )
 
 | Option | Description | Usage Example |
 | --- | --- | --- |
-| 🤖 `--ai` | Enable AI-generated bug reports and test summaries | `artes --ai` |
-| 🧠 `--aiModel` | AI model to use for report generation | `artes --ai --aiModel "gemini 2.5 flash"` |
-| 🔑 `--aiKey` | API key for the selected AI provider | `artes --ai --aiKey "your-api-key"` |
-| 🔗 `--aiURL` | Local AI endpoint URL (e.g. Ollama, LM Studio). Overrides `--aiModel` and `--aiKey` when set | `artes --ai --aiURL "http://localhost:11434/api/chat"` |
-| 🌍 `--aiLanguage` | Language for AI-generated reports (default: `"English"`) | `artes --ai --aiLanguage "Azerbaijani"` |
-| 🔢 --maxTokens | Maximum tokens for AI response output (default: 4000) | artes --ai --maxTokens 8000 |
-| 📋 `--maxReports` | Maximum number of AI reports to generate per test run (default: `10`) | `artes --ai --maxReports 5` |
+| `--ai` | Enable AI-generated bug reports and test summaries | `artes --ai` |
+| `--aiModel` | AI model to use for report generation | `artes --ai --aiModel "gemini 2.5 flash"` |
+| `--aiKey` | API key for the selected AI provider | `artes --ai --aiKey "your-api-key"` |
+| `--aiURL` | Local AI endpoint URL (e.g., Ollama, LM Studio). Overrides `--aiModel` and `--aiKey` when set | `artes --ai --aiURL "http://localhost:11434/api/chat"` |
+| `--aiLanguage` | Language for AI-generated reports (default: `"English"`) | `artes --ai --aiLanguage "Azerbaijani"` |
+| `--maxTokens` | Maximum tokens for AI-generated reports (default: `4000`) | `artes --ai --maxTokens 8000` |
+| `--maxReports` | Maximum number of AI reports to generate per test run (default: `10`) | `artes --ai --maxReports 5` |
 
 
 \*\* To just run the tests: <br>

package/executer.js

@@ -3,24 +3,25 @@ const {
   showHelp,
   showAIHelp,
   showVersion,
+  showBrowserHelp,
+  showExecutionHelp,
+  showReportingHelp,
   createProject,
   runTests,
   generateReport,
   cleanUp,
 } = require("./src/helper/executers/exporter");
+
 const { logPomWarnings } = require("./src/helper/controller/pomCollector");
-const fs = require("fs");
-const path = require("path");
-const {
-  testCoverageCalculator,
-} = require("./src/helper/controller/testCoverageCalculator");
+const { testCoverageCalculator } = require("./src/helper/controller/testCoverageCalculator");
 const { getExecutor } = require("./src/helper/controller/getExecutor");
-const {
-  findDuplicateTestNames,
-} = require("./src/helper/controller/findDuplicateTestNames");
+const { findDuplicateTestNames } = require("./src/helper/controller/findDuplicateTestNames");
 const { getEnvInfo } = require("artes/src/helper/controller/getEnvInfo");
 const { uploadReport } = require("./src/helper/controller/reportUploader");
 
+const fs = require("fs");
+const path = require("path");
+
 const artesConfigPath = path.resolve(process.cwd(), "artes.config.js");
 
 let artesConfig = {};
@@ -31,256 +32,215 @@ if (fs.existsSync(artesConfigPath)) {
 
 const args = process.argv.slice(2);
 
+const set = (key, value) => { if (value) process.env[key] = value; };
+
 const getArgValue = (flag) => {
   const index = args.indexOf(flag);
   return index >= 0 ? args[index + 1] : undefined;
 };
 
+
 const flags = {
-  help: args.includes("-h") || args.includes("--help"),
+  // Main
+  help:    args.includes("-h") || args.includes("--help"),
   version: args.includes("-v") || args.includes("--version"),
-  create: args.includes("-c") || args.includes("--create"),
-  createYes: args.includes("-y") || args.includes("--yes"),
-  noDeps: args.includes("--noDeps"),
-  report: args.includes("-r") || args.includes("--report"),
-  reportSuccess: args.includes("--reportSuccess"),
-  trace: args.includes("-t") || args.includes("--trace"),
-  reportWithTrace: args.includes("-rwt") || args.includes("--reportWithTrace"),
+  create:  args.includes("-c") || args.includes("--create"),
+
+  // Sub-command help pages
+  reportHelp:    (args[0] === "report"    && args.includes("--help")),
+  browserHelp:   (args[0] === "browser"   && args.includes("--help")),
+  executionHelp: (args[0] === "execution" && args.includes("--help")),
+  aiHelp:        (args[0] === "ai"        && args.includes("--help")),
+
+  // Reporting
+  report:           args.includes("-r")              || args.includes("--report"),
+  reportSuccess:    args.includes("--reportSuccess"),
+  reportWithTrace:  args.includes("-rwt")            || args.includes("--reportWithTrace"),
+  trace:            args.includes("--trace"),
   singleFileReport: args.includes("--singleFileReport"),
-  customLogo: args.includes("--logo"),
-  customBrandName: args.includes("--brandName"),
-  customReportName: args.includes("--reportName"),
-  zip: args.includes("--zip"),
-  uploadReport: args.includes("--uploadReport"),
-  reporterURL: args.includes("--reporterURL"),
-  projectName: args.includes("--projectName"),
-  projectType: args.includes("--projectType"),
-  reportPath: args.includes("--reportPath"),
-  aiHelp: args.includes("--aiHelp"),
-  ai: args.includes("--ai"),
-  aiURL: args.includes("--aiURL"),
-  aiModel: args.includes("--aiModel"),
-  aiKey: args.includes("--aiKey"),
-  aiLanguage: args.includes("--aiLanguage"),
-  maxTokens: args.includes("--maxTokens"),
-  maxReports: args.includes("--maxReports"),
-  features: args.includes("--features"),
-  stepDef: args.includes("--stepDef"),
-  tags: args.includes("--tags"),
-  env: args.includes("--env"),
-  saveVar: args.includes("--saveVar"),
-  headless: args.includes("--headless"),
-  parallel: args.includes("--parallel"),
-  retry: args.includes("--retry"),
-  rerun: args.includes("--rerun"),
-  dryRun: args.includes("--dryRun"),
+  zip:              args.includes("--zip"),
+  logo:             args.includes("--logo"),
+  brandName:        args.includes("--brandName"),
+  reportName:       args.includes("--reportName"),
+  uploadReport:     args.includes("--uploadReport"),
+  reporterURL:      args.includes("--reporterURL"),
+  projectName:      args.includes("--projectName"),
+  projectType:      args.includes("--projectType"),
+  reportPath:       args.includes("--reportPath"),
+
+  // Browser & Environment
+  browser:    args.includes("--browser"),
+  device:     args.includes("--device"),
+  maxScreen:  args.includes("--maxScreen"),
+  width:      args.includes("--width"),
+  height:     args.includes("--height"),
+
+  // Execution
+  baseURL:    args.includes("--baseURL"),
+  env:        args.includes("--env"),
+  headless:   args.includes("--headless"),
+  offline:    args.includes("--offline"),
+  features:   args.includes("--features"),
+  stepDef:    args.includes("--stepDef"),
+  tags:       args.includes("--tags"),
+  parallel:   args.includes("--parallel"),
+  retry:      args.includes("--retry"),
+  rerun:      args.includes("--rerun"),
+  dryRun:     args.includes("--dryRun"),
   percentage: args.includes("--percentage"),
-  browser: args.includes("--browser"),
-  offline: args.includes("--offline"),
-  device: args.includes("--device"),
-  baseURL: args.includes("--baseURL"),
-  maximizeScreen: args.includes("--maxScreen"),
-  width: args.includes("--width"),
-  height: args.includes("--height"),
-  timeout: args.includes("--timeout"),
-  slowMo: args.includes("--slowMo"),
+  timeout:    args.includes("--timeout"),
+  slowMo:     args.includes("--slowMo"),
+  saveVar:    args.includes("--saveVar"),
+
+  // AI
+  ai:          args.includes("--ai"),
+  aiModel:     args.includes("--aiModel"),
+  aiKey:       args.includes("--aiKey"),
+  aiURL:       args.includes("--aiURL"),
+  aiLanguage:  args.includes("--aiLanguage"),
+  maxTokens:   args.includes("--maxTokens"),
+  maxReports:  args.includes("--maxReports"),
 };
 
-const env = getArgValue("--env");
-const vars = getArgValue("--saveVar");
-const reporterURL = getArgValue("--reporterURL");
-const projectType = getArgValue("--projectType");
-const projectName = getArgValue("--projectName");
-const reportPath = getArgValue("--reportPath");
-const logo = getArgValue("--logo");
-const brandName = getArgValue("--brandName");
-const reportName = getArgValue("--reportName");
-const ai = args.includes("--ai");
-const aiURL = getArgValue("--aiURL");
-const aiModel = getArgValue("--aiModel");
-const aiKey = getArgValue("--aiKey");
-const aiLanguage = getArgValue("--aiLanguage");
-const maxTokens = getArgValue("--maxTokens")
-const maxReports = getArgValue("--maxReports");
+const shouldReport = flags.reportWithTrace || artesConfig.reportWithTrace || flags.report || artesConfig.report;
+
+// Reporting & Branding
+const logo             = getArgValue("--logo");
+const brandName        = getArgValue("--brandName");
+const reportName       = getArgValue("--reportName");
+const reporterURL      = getArgValue("--reporterURL");
+const projectName      = getArgValue("--projectName");
+const projectType      = getArgValue("--projectType");
+const reportPath       = getArgValue("--reportPath");
+
+// Browser & Environment
+const browser   = getArgValue("--browser");
+const baseURL   = getArgValue("--baseURL");
+const device    = getArgValue("--device");
+const width     = getArgValue("--width");
+const height    = getArgValue("--height");
+
+// Execution
+const env          = getArgValue("--env");
 const featureFiles = getArgValue("--features");
 const features = flags.features && featureFiles;
-const stepDef = getArgValue("--stepDef");
-const tags = getArgValue("--tags");
-const parallel = getArgValue("--parallel");
-const retry = getArgValue("--retry");
-const rerun = getArgValue("--rerun");
-const percentage = getArgValue("--percentage");
-const browser = getArgValue("--browser");
-const device = getArgValue("--device");
-const baseURL = getArgValue("--baseURL");
-const width = getArgValue("--width");
-const height = getArgValue("--height");
-const timeout = getArgValue("--timeout");
-const slowMo = getArgValue("--slowMo");
-
-flags.env ? (process.env.ENV = env) : "";
-
-vars ? (process.env.VARS = vars) : "";
-
-flags.reportWithTrace ||
-artesConfig.reportWithTrace ||
-flags.report ||
-artesConfig.report
-  ? (process.env.REPORT_FORMAT = JSON.stringify([
-      "allure-cucumberjs/reporter:./allure-results",
-    ]))
-  : "";
-
-flags.customLogo ? (process.env.LOGO = logo) : "";
-flags.customBrandName ? (process.env.BRAND_NAME = brandName) : "";
-flags.customReportName ? (process.env.REPORT_NAME = reportName) : "";
-
-flags.reportSuccess ? (process.env.REPORT_SUCCESS = true) : "";
-
-flags.tags && console.log("Running tags:", tags);
-flags.tags ? (process.env.RUN_TAGS = JSON.stringify(tags)) : "";
-
-flags.features && console.log("Running features:", features);
-flags.features ? (process.env.FEATURES = features) : "";
-
-flags.stepDef && console.log("Running step definitions:", flags.stepDef);
-flags.stepDef ? (process.env.STEP_DEFINITIONS = stepDef) : "";
-
-flags.report ? (process.env.REPORT = true) : "";
-
-flags.trace ? (process.env.TRACE = true) : "";
-
-flags.reportWithTrace
-  ? (process.env.REPORT_WITH_TRACE = true)
-  : (process.env.REPORT_WITH_TRACE = false);
-
-flags.singleFileReport
-  ? (process.env.SINGLE_FILE_REPORT = true)
-  : (process.env.SINGLE_FILE_REPORT = false);
-
-flags.zip ? (process.env.ZIP = true) : (process.env.ZIP = false);
-
-flags.ai ? (process.env.AI = ai) : (process.env.AI = false);
-flags.aiURL ? (process.env.AI_URL = aiURL) : "";
-flags.aiModel ? (process.env.AI_MODEL = aiModel) : "";
-flags.aiKey ? (process.env.AI_KEY = aiKey) : "";
-flags.aiLanguage ? (process.env.AI_LANGUAGE = aiLanguage) : "";
-flags.maxTokens ? (process.env.MAX_TOKENS = maxTokens) : "";
-flags.maxReports ? (process.env.MAX_REPORTS = maxReports) : "";
-
-flags.headless &&
-  console.log("Running mode:", flags.headless ? "headless" : "headed");
-flags.headless ? (process.env.MODE = JSON.stringify(true)) : false;
-
-flags.parallel ? (process.env.PARALLEL = parallel) : "";
-
-flags.retry ? (process.env.RETRY = retry) : "";
-
-flags.rerun ? (process.env.RERUN = rerun) : "";
-
-flags.dryRun ? (process.env.DRYRUN = flags.dryRun) : "";
-
-flags.percentage ? (process.env.PERCENTAGE = percentage) : "";
-
-flags.browser && console.log("Running browser:", browser);
-flags.browser ? (process.env.BROWSER = JSON.stringify(browser)) : "";
-
-flags.browser && console.log("Running mode:", flags.offline && "Offline");
-flags.offline ? (process.env.OFFLINE = true) : "";
-
-flags.device && console.log("Running device:", device);
-flags.device ? (process.env.DEVICE = JSON.stringify(device)) : "";
-
-flags.baseURL ? (process.env.BASE_URL = JSON.stringify(baseURL)) : "";
-
-flags.maximizeScreen
-  ? (process.env.MAXIMIZE_SCREEN = flags.maximizeScreen)
-  : "";
+const stepDef      = getArgValue("--stepDef");
+const tags         = getArgValue("--tags");
+const parallel     = getArgValue("--parallel");
+const retry        = getArgValue("--retry");
+const rerun        = getArgValue("--rerun");
+const percentage   = getArgValue("--percentage");
+const timeout      = getArgValue("--timeout");
+const slowMo       = getArgValue("--slowMo");
+const vars         = getArgValue("--saveVar");
+
+// AI
+const aiModel    = getArgValue("--aiModel");
+const aiKey      = getArgValue("--aiKey");
+const aiURL      = getArgValue("--aiURL");
+const aiLanguage = getArgValue("--aiLanguage");
+const maxTokens  = getArgValue("--maxTokens");
+const maxReports = getArgValue("--maxReports");
 
-flags.width && console.log("Running width:", width);
-flags.width ? (process.env.WIDTH = width) : "";
 
-flags.height && console.log("Running height:", height);
-flags.height ? (process.env.HEIGHT = height) : "";
 
-flags.timeout ? (process.env.TIMEOUT = timeout) : "";
+// Reporting & Branding
+set("REPORT",              flags.report);
+set("REPORT_SUCCESS",      flags.reportSuccess);
+set("SINGLE_FILE_REPORT",  flags.singleFileReport);
+set("REPORT_WITH_TRACE",   flags.reportWithTrace);
+set("TRACE",               flags.trace);
+set("ZIP",                 flags.zip);
+set("LOGO",                logo);
+set("BRAND_NAME",          brandName);
+set("REPORT_NAME",         reportName);
+
+if (shouldReport) { process.env.REPORT_FORMAT = JSON.stringify(["allure-cucumberjs/reporter:./allure-results"]) }
+
+set("REPORTER_URL",  reporterURL);
+set("PROJECT_NAME",  projectName);
+set("PROJECT_TYPE",  projectType);
+set("REPORT_PATH",   reportPath);
+
+// Browser & Environment
+set("BROWSER",          browser);
+set("BASE_URL",         baseURL ? JSON.stringify(baseURL) : null);
+set("DEVICE",           device  ? JSON.stringify(device)  : null);
+set("MODE",             flags.headless ? JSON.stringify(true)   : null);
+set("OFFLINE",          flags.offline);
+set("MAXIMIZE_SCREEN",  flags.maxScreen);
+set("WIDTH",            width);
+set("HEIGHT",           height);
+
+// Execution
+set("ENV",  env);
+set("VARS", vars);
+set("FEATURES",         features);
+set("STEP_DEFINITIONS", stepDef);
+set("RUN_TAGS",         tags ? JSON.stringify(tags) : null);
+set("PARALLEL",         parallel);
+set("RETRY",            retry);
+set("RERUN",            rerun);
+set("DRYRUN",           flags.dryRun);
+set("PERCENTAGE",       percentage);
+set("TIMEOUT",          timeout);
+set("SLOWMO",           slowMo);
+
+// AI
+set("AI",          flags.ai);
+set("AI_URL",      aiURL);
+set("AI_MODEL",    aiModel);
+set("AI_KEY",      aiKey);
+set("AI_LANGUAGE", aiLanguage);
+set("MAX_TOKENS",  maxTokens);
+set("MAX_REPORTS", maxReports);
 
-flags.slowMo ? (process.env.SLOWMO = slowMo) : "";
 
 async function main() {
+  if (flags.reportHelp)    return showReportingHelp();
+  if (flags.browserHelp)   return showBrowserHelp();
+  if (flags.executionHelp) return showExecutionHelp();
+  if (flags.aiHelp)        return showAIHelp();
+
   if (flags.help) return showHelp();
-  if (flags.aiHelp) return showAIHelp();
   if (flags.version) return showVersion();
   if (flags.create) return createProject(flags.createYes, flags.noDeps);
 
+
   runTests();
 
-  const testCoverage = testCoverageCalculator();
+  const testPercentage = process.env.PERCENTAGE ? Number(process.env.PERCENTAGE) : artesConfig.testPercentage || 0;
+
+  const testCoverage = testCoverageCalculator({ percentage: testPercentage });
 
+  if (!testCoverage) {
+    cleanUp();
+    process.exit(1);
+  }
+  
   if (testCoverage.totalTests === 0) {
-    console.log("\x1b[33mNo tests were run (0 scenarios). Skipping report generation and upload.\x1b[0m");
     cleanUp();
     process.exit(process.env.EXIT_CODE);
   }
-
+  
   logPomWarnings();
 
   findDuplicateTestNames();
 
-  const testPercentage = process.env.PERCENTAGE
-    ? Number(process.env.PERCENTAGE)
-    : artesConfig.testPercentage || 0;
-
-  if (testPercentage > 0) {
-    const meetsThreshold = testCoverage.percentage >= testPercentage;
-
-    if (meetsThreshold) {
-      console.log(
-        `\x1b[32mTests passed required ${testPercentage}% success rate with ${testCoverage.percentage.toFixed(2)}%!\x1b[0m`,
-      );
-      process.env.EXIT_CODE = parseInt(0, 10);
-    } else {
-      console.log(
-        `\x1b[31mTests failed required ${testPercentage}% success rate with ${testCoverage.percentage.toFixed(2)}%!\x1b[0m`,
-      );
-      process.env.EXIT_CODE = parseInt(1, 10);
-    }
-  }
-
-  const source = path.join(
-    process.cwd(),
-    "node_modules",
-    "artes",
-    "@rerun.txt",
-  );
+  const source = path.join(process.cwd(), "node_modules", "artes",  "@rerun.txt" );
   const destination = path.join(process.cwd(), "@rerun.txt");
+  if (fs.existsSync(source)) { fs.renameSync(source, destination)}
 
-  if (fs.existsSync(source)) {
-    fs.renameSync(source, destination);
-  }
-
-    if (
-      flags.reportWithTrace ||
-      artesConfig.reportWithTrace ||
-      flags.report ||
-      artesConfig.report
-    ) {
+    if (shouldReport) {
       getExecutor();
       getEnvInfo();
       generateReport();
     }
 
-
-  if (
-    !(process.env.TRACE === "true"
-      ? process.env.TRACE
-      : artesConfig.trace || false)
-  ) {
-    fs.rmSync(path.join(process.cwd(), "traces"), {
-      recursive: true,
-      force: true,
-    });
-  }
+    const traceEnabled = process.env.TRACE === "true" || artesConfig.trace || false;
+    if (!traceEnabled) {
+      fs.rmSync(path.join(process.cwd(), "traces"), { recursive: true, force: true });
+    }
 
   try {
     if (flags.uploadReport || artesConfig.uploadReport) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "artes",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "description": "The simplest way to automate UI and API tests using Cucumber-style steps.",
   "main": "index.js",
   "scripts": {

package/src/helper/controller/testCoverageCalculator.js

@@ -1,7 +1,7 @@
 const fs = require("fs");
 const path = require("path");
 
-function testCoverageCalculator({ silent = false } = {}) {
+function testCoverageCalculator({ silent = false, percentage = 0 } = {}) {
   const testStatusFile = path.join(
     process.cwd(),
     "node_modules",
@@ -67,16 +67,7 @@ function testCoverageCalculator({ silent = false } = {}) {
     }
   });
 
-  if (!silent && retriedTests.length > 0) {
-    console.warn("\n\x1b[33mRetried test cases:");
-    retriedTests.forEach((t) => {
-      console.warn(`- "${t.scenario}" ran ${t.count} times`);
-    });
-    console.log("\x1b[0m");
-    console.log("");
-  }
-
-  return {
+  const result = {
     percentage: ((total - notPassed) / total) * 100,
     totalTests: total,
     notPassed,
@@ -85,6 +76,36 @@ function testCoverageCalculator({ silent = false } = {}) {
       Object.entries(map).map(([id, data]) => [id, data.latest.status]),
     ),
   };
+
+  if (!silent && result.totalTests === 0) {
+    console.log("\x1b[33mNo tests were run (0 scenarios).\x1b[0m");
+    process.env.EXIT_CODE = 1;
+    return result;
+  }
+
+  if (!silent && retriedTests.length > 0) {
+    console.warn(`\n\x1b[33mRetried ${retriedTests.length} test cases:`);
+    retriedTests.forEach((t) => {
+      console.warn(`- "${t.scenario}" ran ${t.count} times`);
+    });
+    console.log("\x1b[0m");
+    console.log("");
+  }
+
+  if (!silent && percentage > 0) {
+    const meetsThreshold = result.percentage >= percentage;
+
+    if (meetsThreshold) {
+      console.log(`\x1b[32mTests passed required ${percentage}% success rate with ${result.percentage.toFixed(2)}%!\x1b[0m`);
+      process.env.EXIT_CODE = 0;
+    } else {
+      console.log(`\x1b[31mTests failed required ${percentage}% success rate with ${result.percentage.toFixed(2)}%!\x1b[0m`);
+      process.env.EXIT_CODE = 1;
+    }
+  }
+  
+
+  return result
 }
 
 module.exports = { testCoverageCalculator };

package/src/helper/executers/exporter.js

@@ -1,4 +1,4 @@
-const { showHelp, showAIHelp } = require("./helper");
+const { showHelp, showBrowserHelp, showExecutionHelp, showReportingHelp, showAIHelp } = require("./helper");
 const { createProject } = require("./projectCreator");
 const { generateReport } = require("./reportGenerator");
 const { runTests } = require("./testRunner");
@@ -10,6 +10,9 @@ module.exports = {
   generateReport,
   runTests,
   showHelp,
+  showBrowserHelp, 
+  showExecutionHelp, 
+  showReportingHelp,
   showAIHelp,
   showVersion,
   cleanUp,

package/src/helper/executers/helper.js

@@ -1,168 +1,192 @@
 function showHelp() {
-  console.log(`
-        🚀 Artes - Playwright Test Runner
-      
-        Description:
-            Artes is a test runner for Playwright that executes Cucumber tests
-            and can generate Allure reports.
-      
-        Usage: 
+    console.log(`
+      Artes CLI
+  
+        Usage:
             npx artes [options]
-      
+  
         Options:
-            🆘 -h, --help      Show this help message
-                Usage: artes -h or artes --help
-      
-            🏷️ -v, --version   Show current version of artes
-                Usage: artes -v or artes --version
-      
-            🏗️ -c, --create    Create example project with artes
-                Usage: artes -c or artes --create 
-      
-            ✅ -y, --yes       Skip confirmation prompt for creating example project
-                Usage:  artes -c -y or artes --create --yes
-
-            🚫 --noDeps       Skip installing dependencies when creating example project
-                Usage:  artes -c --noDeps or artes --create --noDeps
-      
-            📊 -r, --report    Run tests and generate Allure report
-                Usage:   artes -r or artes --report
-
-            ✅ --reportSuccess Generate screenshot and video record with also successful tests
-                Usage:   artes --reportSuccess
-
-            ⚡ --trace         Enable tracing for all tests
-                Usage:   artes --trace
-            
-            🔍 -rwt, --reportWithTrace Include trace in the report
-                Usage:   artes --reportWithTrace
-            
-            📄 --singleFileReport   Generate single file Allure report
-                Usage:   artes -r --singleFileReport
-
-           🗜️ --zip            Zip the report folder after generation
-                Usage:   artes -r --zip
-
-            --uploadReport     Upload the generated report to a Artes Reporting System
-                Usage:   artes --uploadReport --reporterURL "https://example.com/upload"
-            
-            --reporterURL      URL of the Artes Reporting System to upload the report
-                Usage:   artes --uploadReport --reporterURL "https://example.com/upload"
-
-            --projectName      Name of the project in the Artes Reporting System (default: "Artes Report")
-                Usage:   artes --uploadReport --reporterURL "https://example.com/upload" --projectName "My Project"
-
-            --projectType      Type of the project (e.g., UI, API) for reporting purposes (default: "Artes")
-                Usage:   artes --uploadReport --reporterURL "https://example.com/upload" --projectType "API"
-
-            --reportPath       Path to the report zip or html file to be uploaded (default: ./report.zip)
-                Usage:   artes --uploadReport --reporterURL "https://example.com/upload" --reportPath "./my_report.zip"
-
-            🖼️ --logo           Set a custom logo in the report sidebar  
-                Usage:  artes --logo logo.png
-
-            🏢 --brandName      Set the brand name displayed next to the logo in the report sidebar
-                Usage:  artes --brandName 'My Company' 
-
-            📄 --reportName      Report name displayed on the summary widget and in the Artes Reporting System
-                Usage:  artes --reportName 'Alma UI' 
-      
-            📁 --features      Specify one or more feature files' relative paths to run (comma-separated)
-                Usage:   artes --features "tests/features/Alma, tests/features/Banan.feature"
-
-            📜 --stepDef       Specify one or more step definition files' relative paths to use (comma-separated)
-                Usage:   artes --stepDef "tests/steps/login.js, tests/steps/home.js"
-      
-            🔖 --tags          Run tests with specified Cucumber tags
-                Usage:   artes --tags "@smoke and not @wip"
-      
-            🌐 --env           Set environment for the test run
-                Usage:   artes --env "dev"
-
-            --saveVar         Set variables from cli
-                        artes --saveVar '{"armud":20,"banana":200}'
-      
-            🕶️ --headless      Run browser in headless mode
-                Usage:   artes --headless
-      
-            ⚡ --parallel      Run tests in parallel mode
-                Usage:   artes --parallel 3
-      
-            🔁 --retry         Retry failed tests
-                Usage:   artes --retry 2
-
-            🔄 --rerun         Rerun only the failed tests from previous run
-                Usage:   artes --rerun @rerun.txt
-      
-            🎭 --dryRun        Perform a dry run without executing tests
-                Usage:   artes --dryRun
-
-            📈 --percentage    Set minimum success percentage to pass test run
-                Usage:   artes --percentage 85
-
-            🌐 --browser       Specify browser to use (chromium, firefox, webkit)
-                Usage:   artes --browser chromium
-            
-            --offline       Run browser in offline mode
-                Usage:   artes --offline
-
-            📱 --device       Emulate specific device (e.g., "iPhone 13")
-                Usage:   artes --device "iPhone 13"
-
-            🌐 --baseURL       Set base URL for the tests
-                Usage:   artes --baseURL "https://example.com"
-
-            📏 --maxScreen     Maximize browser window
-                Usage:   artes --maxScreen
-
-            📐 --width         Set browser width (default: 1280)
-                Usage:   artes --width 1920
-
-            📏 --height        Set browser height (default: 720)
-                Usage:   artes --height 1080
-
-            ⏱️ --timeout       Set timeout for each test step (default: 30 seconds)
-                Usage:   artes --timeout 10
-            
-            🐢 --slowMo        Slow down text execution for clear view (default: 0 seconds)
-                Usage:   artes --slowMo 1
-      `);
-}
-
-
-function showAIHelp() {
-  console.log(`
-        🚀 Artes AI Bug reporter
-      
-        Usage: 
+            -h, --help      Show this help message
+            -v, --version   Show current version of artes
+            -c, --create    Create example artes project
+  
+        For more options, use:
+            artes report --help       Reporting & branding options
+            artes browser --help      Browser & environment options
+            artes execution --help    Execution control options
+            artes ai --help           AI bug reporter options
+    `);
+  }
+  
+  function showReportingHelp() {
+    console.log(`
+      Artes CLI - Reporting & Branding
+  
+        Usage:
             npx artes [options]
-      
+  
+        Options:
+            -r, --report              Run tests and generate Allure report
+                Usage: artes -r or artes --report
+  
+            --reportSuccess           Generate screenshot and video with successful tests too
+                Usage: artes --reportSuccess
+  
+            -rwt, --reportWithTrace   Include trace in the report
+                Usage: artes --reportWithTrace
+  
+            --trace                   Enable tracing for all tests
+                Usage: artes --trace
+  
+            --singleFileReport        Generate single file Allure report
+                Usage: artes -r --singleFileReport
+  
+            --zip                     Zip the report folder after generation
+                Usage: artes -r --zip
+  
+            --logo                    Set a custom logo in the report sidebar
+                Usage: artes --logo logo.png
+  
+            --brandName               Set the brand name displayed next to the logo
+                Usage: artes --brandName 'My Company'
+  
+            --reportName              Report name on the summary widget
+                Usage: artes --reportName 'Alma UI'
+  
+            --uploadReport            Upload the generated report to Artes Reporting System
+                Usage: artes --uploadReport --reporterURL "https://example.com/upload"
+  
+            --reporterURL             URL of the Artes Reporting System
+                Usage: artes --uploadReport --reporterURL "https://example.com/upload"
+  
+            --projectName             Project name in the Artes Reporting System (default: "Artes Report")
+                Usage: artes --uploadReport --reporterURL "https://example.com/upload" --projectName "My Project"
+  
+            --projectType             Project type for reporting, e.g., UI, API (default: "Artes")
+                Usage: artes --uploadReport --reporterURL "https://example.com/upload" --projectType "API"
+  
+            --reportPath              Path to the report zip or html file to upload (default: ./report.zip)
+                Usage: artes --uploadReport --reporterURL "https://example.com/upload" --reportPath "./my_report.zip"
+    `);
+  }
+  
+  function showBrowserHelp() {
+    console.log(`
+      Artes CLI - Browser & Environment
+  
+        Usage:
+            npx artes [options]
+  
+        Options:
+            --browser     Specify browser to use (chromium, firefox, webkit)
+                Usage: artes --browser chromium
+  
+            --device      Emulate a specific device (e.g., "iPhone 13")
+                Usage: artes --device "iPhone 13"
+  
+            --maxScreen   Maximize browser window
+                Usage: artes --maxScreen
+  
+            --width       Set browser width (default: 1280)
+                Usage: artes --width 1920
+  
+            --height      Set browser height (default: 720)
+                Usage: artes --height 1080
+    `);
+  }
+  
+  function showExecutionHelp() {
+    console.log(`
+      Artes CLI - Execution
+  
+        Usage:
+            npx artes [options]
+  
         Options:
 
-            🤖 --ai            Enable AI-generated bug reports and test summaries
-                Usage:   artes --ai
-
-            🧠 --aiModel       AI model to use for report generation
-                               Supported: "gpt-4o", "gemini 2.5 flash", "claude sonnet", "mistral large"
-                Usage:   artes --ai --aiModel "gemini 2.5 flash"
-
-            🔑 --aiKey         API key for the selected AI provider
-                Usage:   artes --ai --aiKey "your-api-key"
-
-            🔗 --aiURL         Local AI endpoint URL (e.g., Ollama, LM Studio). Overrides --aiModel and --aiKey when set
-                Usage:   artes --ai --aiURL "http://localhost:11434/api/chat"
-
-            🌍 --aiLanguage    Language for AI-generated reports (default: "English")
-                Usage:   artes --ai --aiLanguage "Azerbaijani"
-               
-            🔢 --maxTokens     Maximum tokens for AI-generated reports (default: 4000)
-                Usage:   artes --ai --maxTokens 8000
-
-            📋 --maxReports    Maximum number of AI reports to generate per test run (default: 10)
-                Usage:   artes --ai --maxReports 5
-      `);
-}
-
-module.exports = {
-  showHelp, showAIHelp
-};
+            --headless    Run browser in headless mode
+                Usage: artes --headless
+
+            --baseURL     Set base URL for the tests
+                Usage: artes --baseURL "https://example.com"
+  
+            --env         Set environment for the test run
+                Usage: artes --env "dev"
+  
+            --offline     Run browser in offline mode
+                Usage: artes --offline
+
+            --features      Specify feature file paths to run (comma-separated)
+                Usage: artes --features "tests/features/Alma, tests/features/Banan.feature"
+  
+            --stepDef       Specify step definition file paths to use (comma-separated)
+                Usage: artes --stepDef "tests/steps/login.js, tests/steps/home.js"
+  
+            --tags          Run tests with specified Cucumber tags
+                Usage: artes --tags "@smoke and not @wip"
+  
+            --parallel      Run tests in parallel mode
+                Usage: artes --parallel 3
+  
+            --retry         Retry failed tests
+                Usage: artes --retry 2
+  
+            --rerun         Rerun only failed tests from previous run
+                Usage: artes --rerun @rerun.txt
+  
+            --dryRun        Perform a dry run without executing tests
+                Usage: artes --dryRun
+  
+            --percentage    Set minimum success percentage to pass test run
+                Usage: artes --percentage 85
+  
+            --timeout       Set timeout for each test step (default: 30 seconds)
+                Usage: artes --timeout 10
+  
+            --slowMo        Slow down execution for clear view (default: 0)
+                Usage: artes --slowMo 1
+  
+            --saveVar       Set variables from CLI
+                Usage: artes --saveVar '{"armud":20,"banana":200}'
+    `);
+  }
+  
+  function showAIHelp() {
+    console.log(`
+      Artes CLI - AI Bug Reporter
+  
+        Usage:
+            npx artes [options]
+  
+        Options:
+            --ai            Enable AI-generated bug reports and test summaries
+                Usage: artes --ai
+  
+            --aiModel       AI model to use for report generation.
+                            (For supported AI models: https://github.com/4gayev1/Artes/blob/main/docs/aiProviders.md)
+                Usage: artes --ai --aiModel "gemini 2.5 flash"
+  
+            --aiKey         API key for the selected AI provider
+                Usage: artes --ai --aiKey "your-api-key"
+  
+            --aiURL         Local AI endpoint URL (e.g., Ollama, LM Studio). Overrides --aiModel and --aiKey when set
+                Usage: artes --ai --aiURL "http://localhost:11434/api/chat"
+  
+            --aiLanguage    Language for AI-generated reports (default: "English")
+                Usage: artes --ai --aiLanguage "Azerbaijani"
+  
+            --maxTokens     Maximum tokens for AI-generated reports (default: 4000)
+                Usage: artes --ai --maxTokens 8000
+  
+            --maxReports    Maximum number of AI reports to generate per test run (default: 10)
+                Usage: artes --ai --maxReports 5
+    `);
+  }
+  
+  module.exports = {
+    showHelp,
+    showReportingHelp,
+    showBrowserHelp,
+    showExecutionHelp,
+    showAIHelp
+  };

package/src/hooks/hooks.js

@@ -164,7 +164,7 @@ After(async function ({ result, pickle }) {
   
 await attachResponse(allure.attachment);
 
-if (shouldReport && cucumberConfig.ai.ai) {
+if (shouldReport && cucumberConfig.ai.ai === "true") {
   await attachAiBugReport({
     result,
     pickle,