synapse-hub 2.2.3 → 2.4.0

package/.agents/skills/clean-pom-crafter/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: clean-pom-crafter
-description: "Build and refactor Clean POM Page Classes adhering to Flat Architecture standards."
+description: "Build and refactor Clean POM Page Classes adhering to Flat Architecture standards. Use when designing Clean POM page classes or enforcing zero-locator discipline in scripts."
 ---
 
 # Clean POM Crafter — Enterprise Clean POM Architecture Standards
@@ -22,7 +22,7 @@ Specialized skill for creating, refactoring, and standardizing test automation s
    - All `.groovy`, `.java`, `.ts`, `.tc` files must NEVER contain UTF-8 BOM bytes (`0xEF, 0xBB, 0xBF`).
 5. **Context Window Protection (Zero-Token Economy):**
    - 🚫 **NEVER read entire monolithic Page Class files (> 100KB) into LLM context.**
-   - Always use `python3 tools/lookup_xpath.py <keyword>` or line-range targeted reads (`read_file` with `StartLine`/`EndLine`) to find selectors and methods on demand.
+   - Always use `python3 ~/.zcode/synapse-hub/tools/lookup_xpath.py <keyword>` or line-range targeted reads (`read_file` with `StartLine`/`EndLine`) to find selectors and methods on demand.
 
 ---
 
@@ -68,5 +68,23 @@ All Page Classes **MUST** follow this strict locator hierarchy:
 
 - [**Standard Clean POM Methods (`pom_patterns.groovy`)**](references/pom_patterns.groovy): Full implementation of `searchRecord`, `editRecord`, `deleteRecord`, `setCalendarDate`, `selectMultiOptions`, `verifyRecordExists`, `verifyRecordNotExists`, `jsSetInput`.
 - [**Standard Test Script Template (`standard_test_case.groovy`)**](examples/standard_test_case.groovy): 7-step complete script template from Login -> Create -> Search -> Edit -> Delete.
-- [**Zero-Token XPath Lookup (`tools/lookup_xpath.py`)**](tools/lookup_xpath.py): Command `python3 tools/lookup_xpath.py <PageClass>` returns exact locators in <200 tokens without parsing full files.
+- [**Zero-Token XPath Lookup (`~/.zcode/synapse-hub/tools/lookup_xpath.py`)**](~/.zcode/synapse-hub/tools/lookup_xpath.py): Command `python3 ~/.zcode/synapse-hub/tools/lookup_xpath.py <PageClass>` returns exact locators in <200 tokens without parsing full files.
 - [**Browser Runtime Helper (`tools/browser_helpers.js`)**](tools/browser_helpers.js): In-browser validation engine for form audits, safe clicks, and batch verification.
+
+---
+
+## 6. Boundary: Three Ingress Points, One Codification Target
+
+`clean-pom-crafter` is the codification layer — it owns Page Class design and
+the zero-raw-locator discipline. Test *sources* arrive from three siblings and
+must not be re-invented here:
+
+| Source skill | Input | Hands over |
+| :--- | :--- | :--- |
+| `gherkin-to-suite` | `.feature` BDD specs | Test matrix + Universal IR |
+| `lam-script-generator` | User stories / acceptance criteria | Action-sequence script skeletons |
+| `playwright-live-interaction` | Live DOM/AOM survey | Verified selector contracts |
+
+Rule: upstream skills produce intents and IR; **only this skill** turns them
+into Page Classes with real locators (with `playwright-live-interaction`
+supplying the verified selectors).

package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy

@@ -1,28 +1,28 @@
-import com.enterprise.pages.BasePage
-import com.enterprise.pages.LoginPage
-import com.enterprise.pages.DataMiningPage
-import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
-
-// Bước 1: Đảm bảo phiên đăng nhập hợp lệ
-LoginPage.ensureLoggedIn()
-
-// Bước 2: Điều hướng đến phân hệ mục tiêu
-DataMiningPage.navigateToCumCongNghiep()
-
-// Bước 3: Chuẩn bị dữ liệu kiểm thử duy nhất
-String testCode = BasePage.uniqueCode("CCN_")
-String testName = "CCN Thử Nghiệm " + testCode
-
-// Bước 4: Thực thi tạo mới
-DataMiningPage.createCluster(testCode, testName, "Hà Nội", "Đang hoạt động")
-
-// Bước 5: Tìm kiếm 2 pha và xác thực theo Mã
-DataMiningPage.searchRecord(testCode)
-DataMiningPage.verifyRecordExists(testCode)
-
-// Bước 6: Chỉnh sửa và xác thực cập nhật
-String updatedName = testName + " [ĐÃ CẬP NHẬT]"
-DataMiningPage.editRecord(testCode, updatedName)
-
-// Bước 7: Dọn dẹp dữ liệu (Xóa & Verify Không còn tồn tại)
-DataMiningPage.deleteRecord(testCode)
+import com.enterprise.pages.BasePage
+import com.enterprise.pages.LoginPage
+import com.enterprise.pages.DataMiningPage
+import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
+
+// Bước 1: Đảm bảo phiên đăng nhập hợp lệ
+LoginPage.ensureLoggedIn()
+
+// Bước 2: Điều hướng đến phân hệ mục tiêu
+DataMiningPage.navigateToCumCongNghiep()
+
+// Bước 3: Chuẩn bị dữ liệu kiểm thử duy nhất
+String testCode = BasePage.uniqueCode("CCN_")
+String testName = "CCN Thử Nghiệm " + testCode
+
+// Bước 4: Thực thi tạo mới
+DataMiningPage.createCluster(testCode, testName, "Hà Nội", "Đang hoạt động")
+
+// Bước 5: Tìm kiếm 2 pha và xác thực theo Mã
+DataMiningPage.searchRecord(testCode)
+DataMiningPage.verifyRecordExists(testCode)
+
+// Bước 6: Chỉnh sửa và xác thực cập nhật
+String updatedName = testName + " [ĐÃ CẬP NHẬT]"
+DataMiningPage.editRecord(testCode, updatedName)
+
+// Bước 7: Dọn dẹp dữ liệu (Xóa & Verify Không còn tồn tại)
+DataMiningPage.deleteRecord(testCode)

package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy

@@ -1,138 +1,138 @@
-package com.enterprise.pages
-
-import org.openqa.selenium.By
-import org.openqa.selenium.JavascriptExecutor
-import org.openqa.selenium.Keys
-import org.openqa.selenium.WebDriver
-import org.openqa.selenium.WebElement
-import com.kms.katalon.core.webui.driver.DriverFactory
-
-/**
- * Enterprise Clean POM common methods reusable across Page Classes.
- * Kế thừa trực tiếp từ BasePage.
- */
-class PomPatterns extends BasePage {
-
-    /**
-     * Hành vi tìm kiếm 2 pha: Bấm Search -> Điền từ khóa -> Enter -> Chờ bảng cập nhật
-     */
-    public static void searchRecord(String keyword) {
-        WebDriver driver = DriverFactory.getWebDriver()
-        List<WebElement> inputs = driver.findElements(By.cssSelector("input.p-inputtext[placeholder*='Tìm kiếm'], input[placeholder*='tên'], input[placeholder*='mã']"))
-        if (inputs.isEmpty() || !inputs.get(0).isDisplayed()) {
-            WebElement searchToggle = findElement(By.cssSelector("button.p-button-icon-only[icon*='search'], button[title*='Tìm kiếm']"))
-            searchToggle.click()
-            waitForElementVisible(By.cssSelector("input.p-inputtext[placeholder*='Tìm kiếm'], input[placeholder*='tên'], input[placeholder*='mã']"), 5)
-        }
-        WebElement input = findElement(By.cssSelector("input.p-inputtext[placeholder*='Tìm kiếm'], input[placeholder*='tên'], input[placeholder*='mã']"))
-        jsSetInput(input, keyword)
-        input.sendKeys(Keys.ENTER)
-        waitForAngular(5)
-        waitForElementVisible(By.cssSelector("p-table table tbody tr"), 5)
-    }
-
-    /**
-     * Chỉnh sửa bản ghi tại dòng đầu tiên và xác thực theo tên mới
-     */
-    public static void editRecord(String oldKeyword, String newName) {
-        searchRecord(oldKeyword)
-        WebElement editBtn = findElement(By.cssSelector("p-table tbody tr:first-child button[icon*='pencil'], p-table tbody tr:first-child button[icon*='edit']"))
-        clickElement(editBtn)
-        waitForElementVisible(By.cssSelector("input[formcontrolname='name'], input[name='name']"), 5)
-
-        WebElement nameInput = findElement(By.cssSelector("input[formcontrolname='name'], input[name='name']"))
-        jsSetInput(nameInput, newName)
-
-        WebElement saveBtn = findElement(By.xpath("//button[@title='Xác nhận' or contains(.,'Lưu') or contains(.,'Xác nhận')]"))
-        clickElement(saveBtn)
-        waitForAngular(5)
-
-        searchRecord(newName)
-        WebElement firstRow = findElement(By.cssSelector("p-table tbody tr:first-child"))
-        assert firstRow.getText().contains(newName) : "Lỗi: Bản ghi chưa cập nhật tên mới!"
-    }
-
-    /**
-     * Xóa bản ghi tại dòng đầu tiên và xác nhận p-confirmdialog
-     */
-    public static void deleteRecord(String keyword) {
-        WebDriver driver = DriverFactory.getWebDriver()
-        searchRecord(keyword)
-        WebElement deleteBtn = findElement(By.cssSelector("p-table tbody tr:first-child button.p-button-danger, p-table tbody tr:first-child button[icon*='trash']"))
-        clickElement(deleteBtn)
-        waitForElementVisible(By.xpath("//div[contains(@class,'p-dialog-footer') or contains(@class,'p-confirm-dialog')]//button[contains(@class,'p-confirm-dialog-accept') or contains(.,'Xóa') or contains(.,'Đồng ý') or contains(.,'Xác nhận')]"), 5)
-
-        WebElement confirmBtn = findElement(By.xpath("//div[contains(@class,'p-dialog-footer') or contains(@class,'p-confirm-dialog')]//button[contains(@class,'p-confirm-dialog-accept') or contains(.,'Xóa') or contains(.,'Đồng ý') or contains(.,'Xác nhận')]"))
-        clickElement(confirmBtn)
-        waitForAngular(5)
-
-        verifyRecordNotExists(keyword)
-    }
-
-    /**
-     * Điền ngày vào p-calendar an toàn với Angular
-     */
-    public static void setCalendarDate(WebElement element, String dateStr) {
-        WebDriver driver = DriverFactory.getWebDriver()
-        JavascriptExecutor js = (JavascriptExecutor) driver
-        js.executeScript("""
-            arguments[0].value = arguments[1];
-            arguments[0].dispatchEvent(new Event('input', { bubbles: true }));
-            arguments[0].dispatchEvent(new Event('change', { bubbles: true }));
-            arguments[0].dispatchEvent(new Event('blur', { bubbles: true }));
-        """, element, dateStr)
-    }
-
-    /**
-     * Chọn nhiều lựa chọn trong p-multiselect
-     */
-    public static void selectMultiOptions(WebElement multiSelectEl, List<String> optionTexts) {
-        clickElement(multiSelectEl)
-        waitForElementVisible(By.cssSelector(".p-multiselect-panel"), 5)
-        WebDriver driver = DriverFactory.getWebDriver()
-        for (String opt : optionTexts) {
-            WebElement item = driver.findElement(By.xpath("//li[contains(@class, 'p-multiselect-item') and contains(., '" + opt + "')]"))
-            clickElement(item)
-        }
-        WebElement closeBtn = driver.findElement(By.cssSelector(".p-multiselect-close"))
-        if (closeBtn != null && closeBtn.isDisplayed()) {
-            closeBtn.click()
-        }
-    }
-
-    /**
-     * Kiểm tra bản ghi tồn tại trong bảng p-table
-     */
-    public static void verifyRecordExists(String keyword) {
-        WebDriver driver = DriverFactory.getWebDriver()
-        List<WebElement> rows = driver.findElements(By.cssSelector("p-table table tbody tr"))
-        assert !rows.isEmpty() : "Lỗi: Bảng không có dữ liệu nào!"
-        String firstRowText = rows.get(0).getText()
-        assert firstRowText.contains(keyword) : "Lỗi: Không tìm thấy từ khóa '${keyword}' trong hàng đầu tiên!"
-    }
-
-    /**
-     * Kiểm tra bản ghi đã bị xóa hoàn toàn khỏi bảng
-     */
-    public static void verifyRecordNotExists(String keyword) {
-        WebDriver driver = DriverFactory.getWebDriver()
-        searchRecord(keyword)
-        List<WebElement> rows = driver.findElements(By.cssSelector("p-table table tbody tr"))
-        if (rows.isEmpty()) return
-        String firstRowText = rows.get(0).getText()
-        assert !firstRowText.contains(keyword) || firstRowText.contains("Không có dữ liệu") : "Lỗi: Bản ghi '${keyword}' vẫn còn tồn tại trong bảng!"
-    }
-
-    /**
-     * Gán giá trị an toàn kích hoạt Angular Change Detection
-     */
-    public static void jsSetInput(WebElement element, String value) {
-        WebDriver driver = DriverFactory.getWebDriver()
-        JavascriptExecutor js = (JavascriptExecutor) driver
-        js.executeScript("""
-            arguments[0].value = arguments[1];
-            arguments[0].dispatchEvent(new Event('input', { bubbles: true }));
-            arguments[0].dispatchEvent(new Event('change', { bubbles: true }));
-        """, element, value)
-    }
-}
+package com.enterprise.pages
+
+import org.openqa.selenium.By
+import org.openqa.selenium.JavascriptExecutor
+import org.openqa.selenium.Keys
+import org.openqa.selenium.WebDriver
+import org.openqa.selenium.WebElement
+import com.kms.katalon.core.webui.driver.DriverFactory
+
+/**
+ * Enterprise Clean POM common methods reusable across Page Classes.
+ * Kế thừa trực tiếp từ BasePage.
+ */
+class PomPatterns extends BasePage {
+
+    /**
+     * Hành vi tìm kiếm 2 pha: Bấm Search -> Điền từ khóa -> Enter -> Chờ bảng cập nhật
+     */
+    public static void searchRecord(String keyword) {
+        WebDriver driver = DriverFactory.getWebDriver()
+        List<WebElement> inputs = driver.findElements(By.cssSelector("input.p-inputtext[placeholder*='Tìm kiếm'], input[placeholder*='tên'], input[placeholder*='mã']"))
+        if (inputs.isEmpty() || !inputs.get(0).isDisplayed()) {
+            WebElement searchToggle = findElement(By.cssSelector("button.p-button-icon-only[icon*='search'], button[title*='Tìm kiếm']"))
+            searchToggle.click()
+            waitForElementVisible(By.cssSelector("input.p-inputtext[placeholder*='Tìm kiếm'], input[placeholder*='tên'], input[placeholder*='mã']"), 5)
+        }
+        WebElement input = findElement(By.cssSelector("input.p-inputtext[placeholder*='Tìm kiếm'], input[placeholder*='tên'], input[placeholder*='mã']"))
+        jsSetInput(input, keyword)
+        input.sendKeys(Keys.ENTER)
+        waitForAngular(5)
+        waitForElementVisible(By.cssSelector("p-table table tbody tr"), 5)
+    }
+
+    /**
+     * Chỉnh sửa bản ghi tại dòng đầu tiên và xác thực theo tên mới
+     */
+    public static void editRecord(String oldKeyword, String newName) {
+        searchRecord(oldKeyword)
+        WebElement editBtn = findElement(By.cssSelector("p-table tbody tr:first-child button[icon*='pencil'], p-table tbody tr:first-child button[icon*='edit']"))
+        clickElement(editBtn)
+        waitForElementVisible(By.cssSelector("input[formcontrolname='name'], input[name='name']"), 5)
+
+        WebElement nameInput = findElement(By.cssSelector("input[formcontrolname='name'], input[name='name']"))
+        jsSetInput(nameInput, newName)
+
+        WebElement saveBtn = findElement(By.xpath("//button[@title='Xác nhận' or contains(.,'Lưu') or contains(.,'Xác nhận')]"))
+        clickElement(saveBtn)
+        waitForAngular(5)
+
+        searchRecord(newName)
+        WebElement firstRow = findElement(By.cssSelector("p-table tbody tr:first-child"))
+        assert firstRow.getText().contains(newName) : "Lỗi: Bản ghi chưa cập nhật tên mới!"
+    }
+
+    /**
+     * Xóa bản ghi tại dòng đầu tiên và xác nhận p-confirmdialog
+     */
+    public static void deleteRecord(String keyword) {
+        WebDriver driver = DriverFactory.getWebDriver()
+        searchRecord(keyword)
+        WebElement deleteBtn = findElement(By.cssSelector("p-table tbody tr:first-child button.p-button-danger, p-table tbody tr:first-child button[icon*='trash']"))
+        clickElement(deleteBtn)
+        waitForElementVisible(By.xpath("//div[contains(@class,'p-dialog-footer') or contains(@class,'p-confirm-dialog')]//button[contains(@class,'p-confirm-dialog-accept') or contains(.,'Xóa') or contains(.,'Đồng ý') or contains(.,'Xác nhận')]"), 5)
+
+        WebElement confirmBtn = findElement(By.xpath("//div[contains(@class,'p-dialog-footer') or contains(@class,'p-confirm-dialog')]//button[contains(@class,'p-confirm-dialog-accept') or contains(.,'Xóa') or contains(.,'Đồng ý') or contains(.,'Xác nhận')]"))
+        clickElement(confirmBtn)
+        waitForAngular(5)
+
+        verifyRecordNotExists(keyword)
+    }
+
+    /**
+     * Điền ngày vào p-calendar an toàn với Angular
+     */
+    public static void setCalendarDate(WebElement element, String dateStr) {
+        WebDriver driver = DriverFactory.getWebDriver()
+        JavascriptExecutor js = (JavascriptExecutor) driver
+        js.executeScript("""
+            arguments[0].value = arguments[1];
+            arguments[0].dispatchEvent(new Event('input', { bubbles: true }));
+            arguments[0].dispatchEvent(new Event('change', { bubbles: true }));
+            arguments[0].dispatchEvent(new Event('blur', { bubbles: true }));
+        """, element, dateStr)
+    }
+
+    /**
+     * Chọn nhiều lựa chọn trong p-multiselect
+     */
+    public static void selectMultiOptions(WebElement multiSelectEl, List<String> optionTexts) {
+        clickElement(multiSelectEl)
+        waitForElementVisible(By.cssSelector(".p-multiselect-panel"), 5)
+        WebDriver driver = DriverFactory.getWebDriver()
+        for (String opt : optionTexts) {
+            WebElement item = driver.findElement(By.xpath("//li[contains(@class, 'p-multiselect-item') and contains(., '" + opt + "')]"))
+            clickElement(item)
+        }
+        WebElement closeBtn = driver.findElement(By.cssSelector(".p-multiselect-close"))
+        if (closeBtn != null && closeBtn.isDisplayed()) {
+            closeBtn.click()
+        }
+    }
+
+    /**
+     * Kiểm tra bản ghi tồn tại trong bảng p-table
+     */
+    public static void verifyRecordExists(String keyword) {
+        WebDriver driver = DriverFactory.getWebDriver()
+        List<WebElement> rows = driver.findElements(By.cssSelector("p-table table tbody tr"))
+        assert !rows.isEmpty() : "Lỗi: Bảng không có dữ liệu nào!"
+        String firstRowText = rows.get(0).getText()
+        assert firstRowText.contains(keyword) : "Lỗi: Không tìm thấy từ khóa '${keyword}' trong hàng đầu tiên!"
+    }
+
+    /**
+     * Kiểm tra bản ghi đã bị xóa hoàn toàn khỏi bảng
+     */
+    public static void verifyRecordNotExists(String keyword) {
+        WebDriver driver = DriverFactory.getWebDriver()
+        searchRecord(keyword)
+        List<WebElement> rows = driver.findElements(By.cssSelector("p-table table tbody tr"))
+        if (rows.isEmpty()) return
+        String firstRowText = rows.get(0).getText()
+        assert !firstRowText.contains(keyword) || firstRowText.contains("Không có dữ liệu") : "Lỗi: Bản ghi '${keyword}' vẫn còn tồn tại trong bảng!"
+    }
+
+    /**
+     * Gán giá trị an toàn kích hoạt Angular Change Detection
+     */
+    public static void jsSetInput(WebElement element, String value) {
+        WebDriver driver = DriverFactory.getWebDriver()
+        JavascriptExecutor js = (JavascriptExecutor) driver
+        js.executeScript("""
+            arguments[0].value = arguments[1];
+            arguments[0].dispatchEvent(new Event('input', { bubbles: true }));
+            arguments[0].dispatchEvent(new Event('change', { bubbles: true }));
+        """, element, value)
+    }
+}

package/.agents/skills/code-refactoring-refactor-clean/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: code-refactoring-refactor-clean
-description: "Eliminate technical debt and refactor code using SOLID and Clean Code patterns."
+description: "Eliminate technical debt and refactor code using SOLID and Clean Code patterns. Use when refactoring legacy test code toward clean, maintainable structures."
 ---
 
 # Refactor, Clean Code & Technical Debt Remediation
@@ -48,7 +48,7 @@ The user needs actionable code refactoring and technical debt remediation. Focus
 - Never alter business logic without explicit confirmation.
 - Keep diffs minimal, reviewable, and run verification gates:
   ```bash
-  python3 tools/verify_all.py
+  synapse verify
   ```
 
 ## Output Format

package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy

@@ -0,0 +1,9 @@
+package pages
+
+class UserManagementPage extends BasePage {
+    static final String USER_TABLE_ROW = "table#users tbody tr"
+
+    static boolean verifyUserActive(String email) {
+        return verifyElementPresent(uniqueLocator(USER_TABLE_ROW, email))
+    }
+}

package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md

@@ -564,7 +564,7 @@ jobs:
 
 **Static Analysis Toolchain**
 
-```python
+```	oml
 # pyproject.toml
 [tool.ruff]
 line-length = 100
@@ -614,7 +614,7 @@ fail_under = 80
 
 **Automated Refactoring Suggestions**
 
-```python
+```yaml
 # Use Sourcery for automatic refactoring suggestions
 # sourcery.yaml
 rules:
@@ -622,7 +622,9 @@ rules:
   - id: merge-duplicate-blocks
   - id: use-named-expression
   - id: inline-immediately-returned-variable
+`
 
+`python
 # Example: Sourcery will suggest
 # BEFORE
 result = []
@@ -636,7 +638,7 @@ result = [item.name for item in items if item.is_active]
 
 **Code Quality Dashboard Configuration**
 
-```yaml
+```properties
 # sonar-project.properties
 sonar.projectKey=my-project
 sonar.sources=src
@@ -658,7 +660,7 @@ sonar.security.rating=A
 
 **Security-Focused Refactoring**
 
-```python
+```yaml
 # Use Semgrep for security-aware refactoring
 # .semgrep.yml
 rules:
@@ -815,12 +817,12 @@ Include specific optimizations:
 for item in items:
     for other in items:
         if item.id == other.id:
-            # process
+            pass  # process
 
 # After: O(n)
 item_map = {item.id: item for item in items}
 for item_id, item in item_map.items():
-    # process
+    pass  # process
 ```
 
 **Caching Strategy**
@@ -830,7 +832,7 @@ from functools import lru_cache
 @lru_cache(maxsize=128)
 def calculate_expensive_metric(data_id: str) -> float:
     # Expensive calculation cached
-    return result
+    return 0.0
 ```
 
 ### 12. Code Quality Checklist

package/.agents/skills/db-state-verifier-and-seeder/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: db-state-verifier-and-seeder
-description: "Seed isolated test fixtures and assert database mutations across SQL and NoSQL."
+description: "Seed isolated test fixtures and assert database mutations across SQL and NoSQL. Use when seeding, verifying, or cleaning database state around tests."
 ---
 
 # Database State Verifier & Seeder Skill
@@ -102,22 +102,22 @@ To eliminate cascading flakiness and orphan test junk in parallel CI runs, agent
 ### 1. Transaction Savepoint Rollback Context
 Wrap E2E test data creation inside transactional savepoints:
 ```bash
-python tools/db_sandbox.py rollback-test --db-path "path/to/db.sqlite"
+python3 ~/.zcode/synapse-hub/tools/db_sandbox.py rollback-test --db-path "path/to/db.sqlite"
 ```
 *Guarantees zero leftover records: state is automatically rolled back to pristine baseline upon test completion.*
 
 ### 2. Ephemeral Snapshot & Instant Restore (< 0.5s)
 ```bash
 # Before test suite runs: capture pristine database baseline
-python tools/db_sandbox.py snapshot --id pristine_baseline
+python3 ~/.zcode/synapse-hub/tools/db_sandbox.py snapshot --id pristine_baseline
 
 # After suite execution: instantly restore clean database
-python tools/db_sandbox.py restore --id pristine_baseline
+python3 ~/.zcode/synapse-hub/tools/db_sandbox.py restore --id pristine_baseline
 ```
 
 ### 3. Taint Pollution Audit & Cascading Purge
 Scan all tables for orphan records carrying test prefixes (`AUTO_`, `TEST_`) and purge them cleanly:
 ```bash
-python tools/db_sandbox.py audit
+python3 ~/.zcode/synapse-hub/tools/db_sandbox.py audit
 ```
 

package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json

@@ -0,0 +1,12 @@
+{
+  "table": "tenants",
+  "operation": "INSERT",
+  "records": [
+    {
+      "tenant_id": "AUTO_TENANT_01",
+      "status": "ACTIVE",
+      "plan": "ENTERPRISE"
+    }
+  ],
+  "teardown": "DELETE FROM tenants WHERE tenant_id = :tenant_id"
+}

package/.agents/skills/e2e-testing-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: e2e-testing-patterns
-description: "Design robust multi-browser E2E test architectures, parallel sharding, and retry governance."
+description: "Design robust multi-browser E2E test architectures, parallel sharding, and retry governance. Use when designing end-to-end test suites for web applications."
 ---
 
 # E2E Testing Architectural Patterns

package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts

@@ -0,0 +1,12 @@
+import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+  fullyParallel: true,
+  retries: 2,
+  workers: process.env.CI ? 4 : undefined,
+  use: {
+    headless: true,
+    trace: 'on-first-retry',
+  },
+});