synapse-hub 2.4.1 → 2.4.2

package/.agents/skills/katalon-cli-runner/references/katalon-api.md

@@ -1,155 +1,155 @@
-# Katalon Built-in Keywords API Reference
-
-This document provides a reference for Katalon Studio's most commonly used built-in keywords.
-
-## WebUI Keywords
-
-Katalon's WebUI keywords are accessed via `com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords` (commonly imported as `WebUI`).
-
-### Navigation Keywords
-
-- `WebUI.openBrowser(url)` - Open a browser and navigate to URL
-- `WebUI.navigateToUrl(url)` - Navigate to a URL in the current browser
-- `WebUI.closeBrowser()` - Close the current browser
-- `WebUI.back()` - Navigate back in browser history
-- `WebUI.forward()` - Navigate forward in browser history
-- `WebUI.refresh()` - Refresh the current page
-- `WebUI.switchToWindowIndex(index)` - Switch to a browser window by index
-- `WebUI.switchToWindowTitle(title)` - Switch to a browser window by title
-- `WebUI.switchToWindowUrl(url)` - Switch to a browser window by URL
-
-### Element Interaction Keywords
-
-- `WebUI.click(testObject)` - Click on an element
-- `WebUI.doubleClick(testObject)` - Double-click on an element
-- `WebUI.rightClick(testObject)` - Right-click on an element
-- `WebUI.setText(testObject, text)` - Set text for an input field
-- `WebUI.sendKeys(testObject, text)` - Send keyboard input to an element
-- `WebUI.clearText(testObject)` - Clear text from an input field
-- `WebUI.selectOptionByValue(testObject, value, isRegex)` - Select dropdown option by value
-- `WebUI.selectOptionByLabel(testObject, label, isRegex)` - Select dropdown option by label
-- `WebUI.selectOptionByIndex(testObject, index)` - Select dropdown option by index
-- `WebUI.check(testObject)` - Check a checkbox
-- `WebUI.uncheck(testObject)` - Uncheck a checkbox
-- `WebUI.uploadFile(testObject, filePath)` - Upload a file to a file input
-
-### Wait Keywords
-
-- `WebUI.waitForElementPresent(testObject, timeoutInSeconds)` - Wait for element to be present in DOM
-- `WebUI.waitForElementVisible(testObject, timeoutInSeconds)` - Wait for element to be visible
-- `WebUI.waitForElementClickable(testObject, timeoutInSeconds)` - Wait for element to be clickable
-- `WebUI.waitForElementNotPresent(testObject, timeoutInSeconds)` - Wait for element to not be present
-- `WebUI.waitForElementNotVisible(testObject, timeoutInSeconds)` - Wait for element to not be visible
-- `WebUI.waitForPageLoad(timeoutInSeconds)` - Wait for page to fully load
-- `WebUI.delay(timeInSeconds)` - Pause execution for specified seconds
-
-### Verification Keywords
-
-- `WebUI.verifyElementPresent(testObject, timeoutInSeconds)` - Verify element is present
-- `WebUI.verifyElementVisible(testObject)` - Verify element is visible
-- `WebUI.verifyElementClickable(testObject)` - Verify element is clickable
-- `WebUI.verifyElementNotPresent(testObject, timeoutInSeconds)` - Verify element is not present
-- `WebUI.verifyElementText(testObject, expectedText)` - Verify element contains expected text
-- `WebUI.verifyTextPresent(text, isRegex)` - Verify text is present on the page
-- `WebUI.verifyElementAttributeValue(testObject, attribute, expectedValue, timeoutInSeconds)` - Verify element attribute value
-
-### Get Keywords
-
-- `WebUI.getText(testObject)` - Get text content of an element
-- `WebUI.getAttribute(testObject, attribute)` - Get attribute value of an element
-- `WebUI.getCSSValue(testObject, propertyName)` - Get CSS property value
-- `WebUI.getUrl()` - Get current page URL
-- `WebUI.getWindowTitle()` - Get current window title
-
-### Screenshot Keywords
-
-- `WebUI.takeScreenshot(filePath)` - Take a screenshot and save to file
-- `WebUI.takeFullPageScreenshot(filePath)` - Take a full-page screenshot
-
-## Mobile Keywords
-
-Katalon's Mobile keywords are accessed via `com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords` (commonly imported as `Mobile`).
-
-### Common Mobile Keywords
-
-- `Mobile.startApplication(appPath)` - Start a mobile application
-- `Mobile.closeApplication()` - Close the current application
-- `Mobile.tap(testObject, timeout)` - Tap on a mobile element
-- `Mobile.setText(testObject, text, timeout)` - Set text in a mobile input
-- `Mobile.getText(testObject, timeout)` - Get text from a mobile element
-- `Mobile.verifyElementExist(testObject, timeout)` - Verify mobile element exists
-- `Mobile.scrollToText(text)` - Scroll until specified text is visible
-- `Mobile.swipe(startX, startY, endX, endY)` - Perform a swipe gesture
-
-## Web Service (API) Keywords
-
-Katalon's Web Service keywords are accessed via `com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords` (commonly imported as `WS`).
-
-### API Keywords
-
-- `WS.sendRequest(requestObject)` - Send a web service request
-- `WS.verifyResponseStatusCode(response, statusCode)` - Verify HTTP response status code
-- `WS.verifyElementPropertyValue(response, locator, expectedValue)` - Verify JSON/XML element value
-- `WS.getElementPropertyValue(response, locator)` - Get value from JSON/XML response
-- `WS.verifyElementsCount(response, locator, expectedCount)` - Verify count of elements in response
-
-## Utility Keywords
-
-### Checkpoint Keywords
-
-- `findCheckpoint(checkpointName)` - Find a checkpoint by name
-
-### Test Case Keywords
-
-- `findTestCase(testCasePath)` - Find a test case by path
-- `WebUI.callTestCase(testCase, variables)` - Call another test case
-
-### Test Data Keywords
-
-- `findTestData(testDataName)` - Find test data by name
-
-### Object Repository Keywords
-
-- `findTestObject(objectPath)` - Find a test object from Object Repository
-- `findTestObject(objectPath, variables)` - Find a test object with variable bindings
-
-## Global Variables
-
-Access global variables defined in profiles using `internal.GlobalVariable`:
-
-```groovy
-import internal.GlobalVariable
-
-// Access a global variable
-String url = GlobalVariable.baseUrl
-String username = GlobalVariable.username
-int timeout = GlobalVariable.waitTimeout
-```
-
-## Failure Handling
-
-Control how test execution handles failures using `com.kms.katalon.core.model.FailureHandling`:
-
-- `FailureHandling.STOP_ON_FAILURE` - Stop test execution on failure (default)
-- `FailureHandling.CONTINUE_ON_FAILURE` - Continue execution even if step fails
-- `FailureHandling.OPTIONAL` - Mark step as optional, continue regardless of result
-
-Example:
-```groovy
-WebUI.verifyElementPresent(findTestObject('optionalElement'), 5, FailureHandling.OPTIONAL)
-```
-
-## Annotations for Custom Keywords
-
-When creating custom keywords, use the `@Keyword` annotation:
-
-```groovy
-import com.kms.katalon.core.annotation.Keyword
-
-class MyKeywords {
-    @Keyword
-    def myCustomKeyword(String param) {
-        // Implementation
-    }
-}
-```
+# Katalon Built-in Keywords API Reference
+
+This document provides a reference for Katalon Studio's most commonly used built-in keywords.
+
+## WebUI Keywords
+
+Katalon's WebUI keywords are accessed via `com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords` (commonly imported as `WebUI`).
+
+### Navigation Keywords
+
+- `WebUI.openBrowser(url)` - Open a browser and navigate to URL
+- `WebUI.navigateToUrl(url)` - Navigate to a URL in the current browser
+- `WebUI.closeBrowser()` - Close the current browser
+- `WebUI.back()` - Navigate back in browser history
+- `WebUI.forward()` - Navigate forward in browser history
+- `WebUI.refresh()` - Refresh the current page
+- `WebUI.switchToWindowIndex(index)` - Switch to a browser window by index
+- `WebUI.switchToWindowTitle(title)` - Switch to a browser window by title
+- `WebUI.switchToWindowUrl(url)` - Switch to a browser window by URL
+
+### Element Interaction Keywords
+
+- `WebUI.click(testObject)` - Click on an element
+- `WebUI.doubleClick(testObject)` - Double-click on an element
+- `WebUI.rightClick(testObject)` - Right-click on an element
+- `WebUI.setText(testObject, text)` - Set text for an input field
+- `WebUI.sendKeys(testObject, text)` - Send keyboard input to an element
+- `WebUI.clearText(testObject)` - Clear text from an input field
+- `WebUI.selectOptionByValue(testObject, value, isRegex)` - Select dropdown option by value
+- `WebUI.selectOptionByLabel(testObject, label, isRegex)` - Select dropdown option by label
+- `WebUI.selectOptionByIndex(testObject, index)` - Select dropdown option by index
+- `WebUI.check(testObject)` - Check a checkbox
+- `WebUI.uncheck(testObject)` - Uncheck a checkbox
+- `WebUI.uploadFile(testObject, filePath)` - Upload a file to a file input
+
+### Wait Keywords
+
+- `WebUI.waitForElementPresent(testObject, timeoutInSeconds)` - Wait for element to be present in DOM
+- `WebUI.waitForElementVisible(testObject, timeoutInSeconds)` - Wait for element to be visible
+- `WebUI.waitForElementClickable(testObject, timeoutInSeconds)` - Wait for element to be clickable
+- `WebUI.waitForElementNotPresent(testObject, timeoutInSeconds)` - Wait for element to not be present
+- `WebUI.waitForElementNotVisible(testObject, timeoutInSeconds)` - Wait for element to not be visible
+- `WebUI.waitForPageLoad(timeoutInSeconds)` - Wait for page to fully load
+- `WebUI.delay(timeInSeconds)` - Pause execution for specified seconds
+
+### Verification Keywords
+
+- `WebUI.verifyElementPresent(testObject, timeoutInSeconds)` - Verify element is present
+- `WebUI.verifyElementVisible(testObject)` - Verify element is visible
+- `WebUI.verifyElementClickable(testObject)` - Verify element is clickable
+- `WebUI.verifyElementNotPresent(testObject, timeoutInSeconds)` - Verify element is not present
+- `WebUI.verifyElementText(testObject, expectedText)` - Verify element contains expected text
+- `WebUI.verifyTextPresent(text, isRegex)` - Verify text is present on the page
+- `WebUI.verifyElementAttributeValue(testObject, attribute, expectedValue, timeoutInSeconds)` - Verify element attribute value
+
+### Get Keywords
+
+- `WebUI.getText(testObject)` - Get text content of an element
+- `WebUI.getAttribute(testObject, attribute)` - Get attribute value of an element
+- `WebUI.getCSSValue(testObject, propertyName)` - Get CSS property value
+- `WebUI.getUrl()` - Get current page URL
+- `WebUI.getWindowTitle()` - Get current window title
+
+### Screenshot Keywords
+
+- `WebUI.takeScreenshot(filePath)` - Take a screenshot and save to file
+- `WebUI.takeFullPageScreenshot(filePath)` - Take a full-page screenshot
+
+## Mobile Keywords
+
+Katalon's Mobile keywords are accessed via `com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords` (commonly imported as `Mobile`).
+
+### Common Mobile Keywords
+
+- `Mobile.startApplication(appPath)` - Start a mobile application
+- `Mobile.closeApplication()` - Close the current application
+- `Mobile.tap(testObject, timeout)` - Tap on a mobile element
+- `Mobile.setText(testObject, text, timeout)` - Set text in a mobile input
+- `Mobile.getText(testObject, timeout)` - Get text from a mobile element
+- `Mobile.verifyElementExist(testObject, timeout)` - Verify mobile element exists
+- `Mobile.scrollToText(text)` - Scroll until specified text is visible
+- `Mobile.swipe(startX, startY, endX, endY)` - Perform a swipe gesture
+
+## Web Service (API) Keywords
+
+Katalon's Web Service keywords are accessed via `com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords` (commonly imported as `WS`).
+
+### API Keywords
+
+- `WS.sendRequest(requestObject)` - Send a web service request
+- `WS.verifyResponseStatusCode(response, statusCode)` - Verify HTTP response status code
+- `WS.verifyElementPropertyValue(response, locator, expectedValue)` - Verify JSON/XML element value
+- `WS.getElementPropertyValue(response, locator)` - Get value from JSON/XML response
+- `WS.verifyElementsCount(response, locator, expectedCount)` - Verify count of elements in response
+
+## Utility Keywords
+
+### Checkpoint Keywords
+
+- `findCheckpoint(checkpointName)` - Find a checkpoint by name
+
+### Test Case Keywords
+
+- `findTestCase(testCasePath)` - Find a test case by path
+- `WebUI.callTestCase(testCase, variables)` - Call another test case
+
+### Test Data Keywords
+
+- `findTestData(testDataName)` - Find test data by name
+
+### Object Repository Keywords
+
+- `findTestObject(objectPath)` - Find a test object from Object Repository
+- `findTestObject(objectPath, variables)` - Find a test object with variable bindings
+
+## Global Variables
+
+Access global variables defined in profiles using `internal.GlobalVariable`:
+
+```groovy
+import internal.GlobalVariable
+
+// Access a global variable
+String url = GlobalVariable.baseUrl
+String username = GlobalVariable.username
+int timeout = GlobalVariable.waitTimeout
+```
+
+## Failure Handling
+
+Control how test execution handles failures using `com.kms.katalon.core.model.FailureHandling`:
+
+- `FailureHandling.STOP_ON_FAILURE` - Stop test execution on failure (default)
+- `FailureHandling.CONTINUE_ON_FAILURE` - Continue execution even if step fails
+- `FailureHandling.OPTIONAL` - Mark step as optional, continue regardless of result
+
+Example:
+```groovy
+WebUI.verifyElementPresent(findTestObject('optionalElement'), 5, FailureHandling.OPTIONAL)
+```
+
+## Annotations for Custom Keywords
+
+When creating custom keywords, use the `@Keyword` annotation:
+
+```groovy
+import com.kms.katalon.core.annotation.Keyword
+
+class MyKeywords {
+    @Keyword
+    def myCustomKeyword(String param) {
+        // Implementation
+    }
+}
+```

package/.agents/skills/katalon-cli-runner/references/runner_commands.md

@@ -1,67 +1,67 @@
-# CLI Runner Commands & Enterprise Test Suites Registry
-
-Reference documentation for the `katalon-cli-runner` skill.
-
----
-
-## 1. Environment Variable Configuration (.env)
-```bash
-KATALON_API_KEY="your_actual_api_key_here"
-KATALON_PROJECT_PATH="/path/to/project"
-TELEGRAM_BOT_TOKEN="your_bot_token"
-TELEGRAM_CHAT_ID="your_chat_id"
-```
-
----
-
-## 2. Platform-Specific Execution Commands (KRE CLI)
-
-### 2.1. Windows Environment (PowerShell Runner)
-```powershell
-# Run Test Suite with API Key
-powershell -ExecutionPolicy Bypass -File .\run_tests_windows.ps1 -Suite "Test Suites/07_QuanTriDuLieu" -ApiKey $env:KATALON_API_KEY
-
-# Run single Test Suite for debugging:
-powershell -ExecutionPolicy Bypass -File .\run_tests_windows.ps1 -Suite "Test Suites/Group_07_01_CumCongNghiep"
-```
-
-### 2.2. macOS / Linux CLI (Headless Full HD)
-```bash
-# Run Test Suite
-katalonc \
-  -noSplash \
-  -runMode=console \
-  -projectPath="$(pwd)/project.prj" \
-  -retry=0 \
-  -testSuitePath="Test Suites/07_QuanTriDuLieu" \
-  -browserType="Chrome (headless)" \
-  -executionProfile="default" \
-  -apiKey="$KATALON_API_KEY" \
-  --args="-headless --window-size=1920,1080 --disable-gpu --no-sandbox --disable-dev-shm-usage"
-
-# Run single Test Case (Debug Mode):
-katalonc \
-  -noSplash \
-  -runMode=console \
-  -projectPath="$(pwd)/project.prj" \
-  -testCasePath="Test Cases/TC-1 Kiểm tra tạo mới thành công" \
-  -browserType="Chrome (headless)" \
-  -apiKey="$KATALON_API_KEY"
-```
-
----
-
-## 3. Standard Enterprise Test Suite Registry
-
-| Test Suite Name | Scale | Target Functional Module |
-| :--- | :---: | :--- |
-| `Test Suites/All_Tests` | Full Suite | All functional modules |
-| `Test Suites/01_QuanLyChiTieu` | 7 TCs | Target Planning |
-| `Test Suites/02_XacThucNguoiDung` | 5 TCs | User Authentication & Profiles |
-| `Test Suites/03_QuanTriHeThong` | 4 TCs | System Administration & Users |
-| `Test Suites/04_DanhMucDungChung` | 12 TCs | Common Categories (Departments, Roles) |
-| `Test Suites/05_DanhMucNganhCongThuong` | 64 TCs | 16 Industry Sub-Categories |
-| `Test Suites/06_QuyHoachCongThuong` | 30 TCs | Sector Planning |
-| `Test Suites/07_QuanTriDuLieu` | 125 TCs | Data Mining & GIS Maps |
-| `Test Suites/08_BaoCaoThongKe` | 2 TCs | Statistical Reports (Data & Permits) |
-| `Test Suites/09_ChiaSeDuLieu` | 10 TCs | Data Sharing & API Token Lifecycle |
+# CLI Runner Commands & Enterprise Test Suites Registry
+
+Reference documentation for the `katalon-cli-runner` skill.
+
+---
+
+## 1. Environment Variable Configuration (.env)
+```bash
+KATALON_API_KEY="your_actual_api_key_here"
+KATALON_PROJECT_PATH="/path/to/project"
+TELEGRAM_BOT_TOKEN="your_bot_token"
+TELEGRAM_CHAT_ID="your_chat_id"
+```
+
+---
+
+## 2. Platform-Specific Execution Commands (KRE CLI)
+
+### 2.1. Windows Environment (PowerShell Runner)
+```powershell
+# Run Test Suite with API Key
+powershell -ExecutionPolicy Bypass -File .\run_tests_windows.ps1 -Suite "Test Suites/07_QuanTriDuLieu" -ApiKey $env:KATALON_API_KEY
+
+# Run single Test Suite for debugging:
+powershell -ExecutionPolicy Bypass -File .\run_tests_windows.ps1 -Suite "Test Suites/Group_07_01_CumCongNghiep"
+```
+
+### 2.2. macOS / Linux CLI (Headless Full HD)
+```bash
+# Run Test Suite
+katalonc \
+  -noSplash \
+  -runMode=console \
+  -projectPath="$(pwd)/project.prj" \
+  -retry=0 \
+  -testSuitePath="Test Suites/07_QuanTriDuLieu" \
+  -browserType="Chrome (headless)" \
+  -executionProfile="default" \
+  -apiKey="$KATALON_API_KEY" \
+  --args="-headless --window-size=1920,1080 --disable-gpu --no-sandbox --disable-dev-shm-usage"
+
+# Run single Test Case (Debug Mode):
+katalonc \
+  -noSplash \
+  -runMode=console \
+  -projectPath="$(pwd)/project.prj" \
+  -testCasePath="Test Cases/TC-1 Kiểm tra tạo mới thành công" \
+  -browserType="Chrome (headless)" \
+  -apiKey="$KATALON_API_KEY"
+```
+
+---
+
+## 3. Standard Enterprise Test Suite Registry
+
+| Test Suite Name | Scale | Target Functional Module |
+| :--- | :---: | :--- |
+| `Test Suites/All_Tests` | Full Suite | All functional modules |
+| `Test Suites/01_QuanLyChiTieu` | 7 TCs | Target Planning |
+| `Test Suites/02_XacThucNguoiDung` | 5 TCs | User Authentication & Profiles |
+| `Test Suites/03_QuanTriHeThong` | 4 TCs | System Administration & Users |
+| `Test Suites/04_DanhMucDungChung` | 12 TCs | Common Categories (Departments, Roles) |
+| `Test Suites/05_DanhMucNganhCongThuong` | 64 TCs | 16 Industry Sub-Categories |
+| `Test Suites/06_QuyHoachCongThuong` | 30 TCs | Sector Planning |
+| `Test Suites/07_QuanTriDuLieu` | 125 TCs | Data Mining & GIS Maps |
+| `Test Suites/08_BaoCaoThongKe` | 2 TCs | Statistical Reports (Data & Permits) |
+| `Test Suites/09_ChiaSeDuLieu` | 10 TCs | Data Sharing & API Token Lifecycle |