@teevee98/synapse-hub 4.2.3 → 4.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/.agents/agents/api-engineer.md +1 -1
  2. package/.agents/agents/failure-analyst.md +1 -1
  3. package/.agents/agents/live-explorer.md +1 -1
  4. package/.agents/agents/orchestrator.md +1 -1
  5. package/.agents/agents/perf-engineer.md +1 -1
  6. package/.agents/agents/pom-crafter.md +1 -1
  7. package/.agents/agents/quality-gatekeeper.md +1 -1
  8. package/.agents/agents/test-designer.md +1 -1
  9. package/.agents/agents/test-runner.md +1 -1
  10. package/.agents/rules/git-push-protocol.md +2 -2
  11. package/.agents/rules/lessons-learned.md +10 -12
  12. package/.agents/rules/mandatory-playwright-live.md +1 -1
  13. package/.agents/rules/skill-precedence.md +1 -1
  14. package/.agents/rules/systematic-debugging.md +3 -3
  15. package/.agents/skills/01-web-automation/playwright-live-interaction/SKILL.md +2 -2
  16. package/.agents/skills/01-web-automation/playwright-live-interaction/references/recipes.md +14 -31
  17. package/.agents/skills/05-security-and-compliance/wcag-audit-patterns/SKILL.md +5 -4
  18. package/.agents/workflows/analyze_requirement_document.md +1 -1
  19. package/.agents/workflows/export_testcases_excel.md +1 -1
  20. package/.agents/workflows/generate_combinatorial_test_data.md +1 -1
  21. package/.agents/workflows/generate_cross_module_test_plan.md +1 -1
  22. package/.agents/workflows/generate_manual_testcases_rbt.md +1 -1
  23. package/.agents/workflows/generate_requirements_from_website.md +1 -1
  24. package/.agents/workflows/generate_testcases_from_requirements.md +1 -1
  25. package/.agents/workflows/test-impact.md +1 -1
  26. package/.agents/workflows/verify.md +1 -1
  27. package/AGENTS.md +1 -1
  28. package/README.en.md +2 -2
  29. package/README.md +2 -2
  30. package/agentskills.json +1 -1
  31. package/docs/ARCHITECTURE.en.md +1 -1
  32. package/docs/ARCHITECTURE.md +1 -1
  33. package/docs/PERFORMANCE_AUDIT_REPORT.md +2 -2
  34. package/docs/TOOL_CATALOG.md +25 -20
  35. package/package.json +1 -1
  36. package/plugin.json +1 -1
  37. package/scripts/setup.sh +6 -1
  38. package/skills_manifest.json +1 -1
  39. package/synapse.config.json +1 -1
  40. package/tools/TOOL_CATALOG.json +112 -31
  41. package/tools/__init__.py +1 -1
  42. package/tools/browser_helpers.js +2 -2
  43. package/tools/cli.py +3 -3
  44. package/tools/core/file_lock.py +7 -0
  45. package/tools/core/memory_bus.py +44 -40
  46. package/tools/core/process_supervisor.py +12 -4
  47. package/tools/core/telemetry.py +54 -16
  48. package/tools/dashboard_generator.py +6 -6
  49. package/tools/db_sandbox.py +8 -2
  50. package/tools/generate_tool_catalog.py +32 -2
  51. package/tools/mcp_docx_server.py +1 -1
  52. package/tools/mcp_excel_server.py +1 -1
  53. package/tools/mcp_server.py +1 -1
  54. package/tools/package_release.py +22 -27
  55. package/tools/reversible_sandbox.py +43 -10
  56. package/tools/task_memory_manager.py +2 -1
  57. package/tools/ui_server.py +1 -1
  58. package/tools/update_sentinel.py +3 -3
  59. package/tools/welcome_page.py +1 -1
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: api-engineer
3
- description: Enterprise API & Microservices Testing Specialist orchestrating OpenAPI test matrices, schema drift detection, Pact contract verification, and Newman CLI execution.
3
+ description: Enterprise API testing specialist for OpenAPI matrices, schema drift, and contract verification.
4
4
  skills:
5
5
  - api-spec-to-e2e-matrix
6
6
  - consumer-driven-contract-testing
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: failure-analyst
3
- description: Macro-level test run autopsy manager parsing JUnit XML reports, triage logs, and FAILED_*.png screenshots to diagnose root causes across entire failing test suites.
3
+ description: Test failure autopsy manager diagnosing root causes from JUnit XML, logs, and screenshots.
4
4
  skills:
5
5
  - failure-autopsy-and-healing
6
6
  - self-healing-locator
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: live-explorer
3
- description: Real-time browser probing and interactive live DOM exploration via Playwright MCP to inspect live web elements and verify selector hit rates under 200ms.
3
+ description: Real-time browser element probing and selector hit rate verification via Playwright.
4
4
  skills:
5
5
  - playwright-live-interaction
6
6
  - self-healing-locator
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: orchestrator
3
- description: Lead QA Orchestrator directing automated testing workflows, decomposing tasks, and coordinating specialized subagents.
3
+ description: Lead QA orchestrator directing testing workflows and coordinating specialized subagents.
4
4
  skills:
5
5
  - agent-orchestration-multi-agent-optimize
6
6
  - graphify-impact-analyzer
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: perf-engineer
3
- description: Enterprise Performance & Load Testing Specialist orchestrating JMeter, k6, Locust, real-time load profiling, and APM telemetry correlation.
3
+ description: Performance testing specialist orchestrating JMeter, k6, Locust, and APM telemetry.
4
4
  skills:
5
5
  - backend-load-and-stress-patterns
6
6
  - web-vitals-and-performance-profiler
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: pom-crafter
3
- description: Page Object Model (POM) and test script engineer enforcing Clean POM Flat Architecture.
3
+ description: Page Object Model and test script engineer enforcing Clean POM Flat Architecture.
4
4
  skills:
5
5
  - clean-pom-crafter
6
6
  - lam-script-generator
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: quality-gatekeeper
3
- description: Sentinel gatekeeper enforcing 10 Quality Gates, AST mutation thresholds (>= 80%), and static verification before task completion.
3
+ description: Sentinel gatekeeper enforcing 10 Quality Gates and mutation kill thresholds (>= 80%).
4
4
  skills:
5
5
  - antigravity-test-sentinel
6
6
  - code-refactoring-refactor-clean
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: test-designer
3
- description: Enterprise Test Designer & Manual QA Specialist transforming requirements into risk-based test matrices, ambiguity audits, and 12-column Excel suites.
3
+ description: Test designer transforming requirements into risk-based test matrices and Excel suites.
4
4
  skills:
5
5
  - rbt-manual-testing
6
6
  - review-spec
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: test-runner
3
- description: Automated test execution manager coordinating headless runs via CLI (KRE / Playwright / Gradle).
3
+ description: Automated test execution manager coordinating headless runs via CLI.
4
4
  skills:
5
5
  - katalon-cli-runner
6
6
  - e2e-testing-patterns
@@ -1,6 +1,6 @@
1
1
  ---
2
- trigger: always_on
3
- description: Clean Git Push Protocol for target projects and Synapse Hub, pre-push verification gate, and zero-leakage commit rules.
2
+ trigger: on_demand
3
+ description: Clean Git Push Protocol for target projects and Synapse Hub, git commit, push, version bump, pre-push verification gate, hub_publisher release pipeline, and zero-leakage commit rules.
4
4
  ---
5
5
 
6
6
  # Clean Git Push Protocol & Repository Hygiene
@@ -10,16 +10,14 @@ description: Critical anti-patterns, past mistakes, and strict avoidance rules (
10
10
 
11
11
  | # | Mistake / Anti-Pattern | Root Cause | Mandatory Avoidance Rule |
12
12
  |---|---|---|---|
13
- | **1** | **XPath strings parsed as methods** | Regex captured `String TXT = "...contains(...)"`. | In Groovy, `=` before `(` denotes a variable/constant, **never** a method. |
14
- | **2** | **GIS map / geometric polygon collision** | Hardcoded fixed coordinates `(100, 200)` caused overlap. | Always randomize geometric coordinates via dynamic bounding box/offset randomizer. |
15
- | **3** | **`ElementClickInterceptedException`** | Clicked while modal/spinner backdrop overlay was fading. | Wait for overlay detachment or bypass via JS dispatch (`clickJS` / `window.__helper.clickSafe()`). |
16
- | **4** | **Context window blowout** | Read monolithic 4,000+ line Page Class directly. | **Never read large files whole.** Query `tools/repo_map.txt` or read 20-50 line ranges. |
17
- | **5** | **Flaky timing on CI/CD** | `Thread.sleep` failed under variable network lag. | Replace 100% with Smart Wait: Angular `isStable()` and CDP `Network Idle 0`. |
18
- | **6** | **DB polluted with test junk** | Created entities without executing deletion. | Every data creation test case **must** execute idempotent teardown cleanup. |
19
- | **7** | **Graphify/CLI ran on Skill Hub instead of target project** | Defaulted to `CWD = Synapse Hub` without checking Active Workspaces. | **Synapse-Hub repository = read-only hub, NEVER a CLI target.** Always identify the real target project from `Active Workspaces` (the non-hub workspace). If multiple project workspaces exist, ask the user. All outputs (graphify-out/, reports) must land inside the target project folder. |
20
- | **8** | **Target test code pollution on Hub** | Created/committed target tests inside Hub repo. | **Synapse-Hub is strictly read-only for business automation tests.** All page classes, specs, and test cases must reside in the target project workspace. Pre-commit guard rejects business code in Hub. |
13
+ | **1** | **XPath parsed as method** | Regex matched `String TXT = "...("`. | In Groovy, `=` before `(` denotes variable/constant, never method. |
14
+ | **2** | **GIS coordinate collision** | Hardcoded coordinates `(100, 200)`. | Randomize coordinates via dynamic bounding box/offset randomizer. |
15
+ | **3** | **`ElementClickIntercepted`** | Clicked while backdrop overlay was fading. | Wait for overlay detachment or bypass via JS dispatch (`clickJS`). |
16
+ | **4** | **Context blowout** | Read monolithic 4,000+ line Page Class. | Never read large files whole; query `tools/repo_map.txt` or read 20-50 lines. |
17
+ | **5** | **Flaky timing on CI** | `Thread.sleep` failed under network lag. | Replace with Smart Wait: Angular `isStable()` and CDP `Network Idle 0`. |
18
+ | **6** | **DB polluted with test junk** | Created entities without deletion. | Every data creation test case must execute idempotent teardown cleanup. |
19
+ | **7** | **CLI ran on Hub instead of target** | Defaulted to CWD=Hub without checking workspaces. | **Synapse-Hub is read-only hub, never CLI target.** Identify target workspace; outputs land there. |
20
+ | **8** | **Target test pollution on Hub** | Committed target tests inside Hub repo. | **Synapse-Hub holds 0 business tests.** All page classes/specs reside in target workspace. |
21
21
 
22
- ### Memory Management & Consolidation Protocol:
23
- - **Max capacity:** 8 active rules in prompt hot memory.
24
- - **Negative Feedback Cache (Blind Retry Prevention):** Whenever a bug fix attempt fails during test verification, AI agents MUST immediately persist it via `agent-qa heal record-failed --error "<sig>" --patch "<failed_code>" --reason "<why_failed>"` to prevent repeating the failed patch.
25
- - **Overflow policy:** Consolidate related patterns into a single generalized invariant; offload edge cases to SQLite `~/.agent_memory/global_cache.db` (0-token cold storage).
22
+ - **Feedback Cache:** On failed fix, persist via `agent-qa heal record-failed` to prevent repeat patches.
23
+ - **Overflow Policy:** Consolidate related patterns into a single invariant; offload edge cases to SQLite `~/.agent_memory/global_cache.db`.
@@ -29,7 +29,7 @@ description: Rules for Autonomous Multi-Agent Swarm, Pure Headless Playwright Li
29
29
 
30
30
  4. **Native Playwright Assertions & Zero-Sleep Standard:**
31
31
  - **Web-First Assertions Only:** Always utilize native auto-retrying matchers: `await expect(locator).toBeVisible()`, `await expect(locator).toBeEnabled()`, `await expect(locator).toHaveText(...)`.
32
- - **Zero Static Sleeps (AGENTS.md Rule 1.4):** Static delays (`page.waitForTimeout`, `time.sleep`, `Thread.sleep`) are strictly prohibited in test scripts. Synchronize via locator auto-waiting or `page.waitForLoadState('networkidle')`.
32
+ - **Zero Static Sleeps (AGENTS.md Rule 1.3):** Static delays (`page.waitForTimeout`, `time.sleep`, `Thread.sleep`) are strictly prohibited in test scripts. Synchronize via locator auto-waiting or bounded `page.waitForLoadState('networkidle')` (avoid unconditional `networkidle` on apps with continuous background polling, WebSocket, or streaming traffic).
33
33
  - **Clean POM Locator Hierarchy:** Page Classes must prioritize semantic locators:
34
34
  1. User-facing ARIA role (`page.getByRole(...)`)
35
35
  2. Semantic test identifier (`page.getByTestId(...)`)
@@ -1,5 +1,5 @@
1
1
  ---
2
- trigger: always_on
2
+ trigger: on_demand
3
3
  description: Skill Resolution Precedence, Inter-Skill Coordination, and Anti-Collision Protocol enforcing Workspace-Local skills over external generic plugin skills.
4
4
  ---
5
5
 
@@ -1,6 +1,6 @@
1
1
  ---
2
- trigger: always_on
3
- description: Enforce rigorous engineering discipline, systematic debugging without guesswork, and verification before completion.
2
+ trigger: on_demand
3
+ description: Systematic debugging discipline, zero guesswork, root cause analysis, evidence before action, fast-track vs full-gate verification, and cognitive forcing functions.
4
4
  ---
5
5
 
6
6
  # Systematic Debugging & Verification Discipline
@@ -21,7 +21,7 @@ description: Enforce rigorous engineering discipline, systematic debugging witho
21
21
  - **Sync Knowledge & Artifacts:** Run `python3 tools/repo_map.py` if `tools/repo_map.py` exists; run `graphify update .` if `graphify-out/` exists.
22
22
 
23
23
  ## 3. Situational Tool Autonomy (Zero-Command Invariant)
24
- Autonomously trigger tools on-demand per `AGENTS.md` Section 3.4 (Setup: `setup_project.py`/`analyze_project.py`; Quality: `verify_all.py`/`infer_linter.py`/`micro_mutator.py`; Healing: `pinpoint_failure.py`/`auto_heal_reflexion.py`/`reversible_sandbox.py`; Context: `distill_log.py`/`safety_firewall.py`). Never expect user to memorize CLI syntax.
24
+ Autonomously run tools per `AGENTS.md` §3 (verify: `verify_all.py`; heal: `pinpoint_failure.py`; context: `distill_log.py`). Zero-command protocol: never expect user to memorize CLI syntax.
25
25
 
26
26
  ## 4. Cognitive Forcing Functions (System-2 Reasoning)
27
27
  Before outputting any test script, Universal IR, or Page Class, pass through:
@@ -61,7 +61,7 @@ flowchart LR
61
61
  | **Fill Input** | `await page.locator(sel).fill(val);` | `WebElement el = findElement(By.cssSelector(sel)); jsSetInput(el, val);` | `await this.inputField.fill(val);` |
62
62
  | **Safe Click / Overlay** | `await page.locator(sel).click();` | `WebElement el = findElement(By.cssSelector(sel)); clickElement(el);` | `await this.submitButton.click();` |
63
63
  | **Dropdown Selection** | `await page.locator('p-dropdown').click(); await page.locator('.p-dropdown-item:has-text("X")').click();` | `selectDropdownByText(dropdownEl, "X")` | `await this.dropdown.selectOption("X");` |
64
- | **Calendar Picker** | Synthetic `input` + `change` event | `jsSetInput(calendarInput, "25/10/2026")` | `await this.datePicker.fill("2026-10-25");` |
64
+ | **Calendar Picker** | `await page.locator('p-calendar input').fill('2026-10-25');` | `jsSetInput(calendarInput, "25/10/2026")` | `await this.datePicker.fill("2026-10-25");` |
65
65
  | **Catch Success Toast** | `await page.waitForSelector('.toast-success')` | `verifyToastMessage("Success")` | `await expect(this.toast).toBeVisible();` |
66
66
 
67
67
  ### Phase 3: Observe → Act → Extract Triad
@@ -82,7 +82,7 @@ flowchart LR
82
82
 
83
83
  1. **Selector Uniqueness:** Every codified locator matches exactly 1 target element in the active DOM/AOM.
84
84
  2. **Response Responsiveness:** Element interaction completes with sub-second verified latency under normal load.
85
- 3. **Event Triggering:** Complex inputs correctly fire synthetic `input` and `change` events.
85
+ 3. **Event Triggering:** Complex inputs correctly receive and validate user-equivalent inputs without bypassing framework validation.
86
86
  4. **Encoding & Standards:** All generated test fixtures adhere to 100% UTF-8 No BOM.
87
87
 
88
88
  ---
@@ -51,28 +51,17 @@ async (page) => {
51
51
  ## Recipe 4: Modal Dialogs & Popup Forms (`p-dialog`, `.card.popup-data`)
52
52
  ```javascript
53
53
  async (page) => {
54
- await page.evaluate(() => {
55
- function setAngularInput(selector, val) {
56
- const el = document.querySelector(selector);
57
- if (el) {
58
- el.value = val;
59
- el.dispatchEvent(new Event('input', { bubbles: true }));
60
- el.dispatchEvent(new Event('change', { bubbles: true }));
61
- }
62
- }
63
- const testCode = 'CCN_' + Math.floor(Date.now() / 1000);
64
- setAngularInput('input[formcontrolname="code"]', testCode);
65
- setAngularInput('input[formcontrolname="name"]', 'Cụm Công Nghiệp ' + testCode);
66
- setAngularInput('textarea[formcontrolname="address"]', 'Địa chỉ kiểm thử tự động');
67
- });
54
+ const testCode = 'CCN_' + Math.floor(Date.now() / 1000);
55
+ await page.locator('input[formcontrolname="code"]').fill(testCode);
56
+ await page.locator('input[formcontrolname="name"]').fill('Cụm Công Nghiệp ' + testCode);
57
+ await page.locator('textarea[formcontrolname="address"]').fill('Địa chỉ kiểm thử tự động');
68
58
 
69
59
  const saveBtn = page.locator('button:has-text("Lưu"), button:has-text("Xác nhận"), button[title="Xác nhận"]').first();
70
- const isEnabled = !(await saveBtn.isDisabled());
71
- if (isEnabled) {
72
- await saveBtn.click();
73
- await page.waitForTimeout(1500);
74
- }
75
- return { isSaveButtonEnabled: isEnabled };
60
+ await expect(saveBtn).toBeEnabled({ timeout: 5000 });
61
+ await saveBtn.click();
62
+ // Dynamic smart wait: wait for modal dismissal rather than arbitrary sleep
63
+ await expect(page.locator('p-dialog, .card.popup-data')).toBeHidden({ timeout: 10000 });
64
+ return { testCode, isSaveSuccess: true };
76
65
  }
77
66
  ```
78
67
 
@@ -227,17 +216,11 @@ async (page, targetKeyword) => {
227
216
  ```javascript
228
217
  async (page) => {
229
218
  const dateValue = '25/10/2026';
230
- await page.evaluate(({ selector, val }) => {
231
- const calInput = document.querySelector(selector);
232
- if (calInput) {
233
- calInput.value = val;
234
- calInput.dispatchEvent(new Event('input', { bubbles: true }));
235
- calInput.dispatchEvent(new Event('change', { bubbles: true }));
236
- calInput.dispatchEvent(new Event('blur', { bubbles: true }));
237
- }
238
- }, { selector: 'p-calendar input, input[formcontrolname*="date"], input[formcontrolname*="Date"]', val: dateValue });
239
-
240
- await page.waitForTimeout(300);
219
+ const calInput = page.locator('p-calendar input, input[formcontrolname*="date"], input[formcontrolname*="Date"]').first();
220
+ await calInput.click();
221
+ await calInput.fill(dateValue);
222
+ await calInput.press('Enter');
223
+ await expect(calInput).toHaveValue(dateValue, { timeout: 3000 });
241
224
  return { status: 'Date filled', value: dateValue };
242
225
  }
243
226
  ```
@@ -42,14 +42,14 @@ Engineering standards for automated, continuous Web Content Accessibility Guidel
42
42
 
43
43
  | Criterion | Rule Code | Level | Requirement & Automated Assertion |
44
44
  | :--- | :--- | :--- | :--- |
45
- | **Non-text Content** | WCAG 1.1.1 | Level A | All `<img>` tags must possess non-empty `alt` attributes or `aria-hidden="true"` if decorative. |
45
+ | **Non-text Content** | WCAG 1.1.1 | Level A | Informative `<img>` tags must possess descriptive `alt` text; decorative images must use null/empty `alt=""` (W3C Technique H67), `role="presentation"`, or `aria-hidden="true"`. |
46
46
  | **Info and Relationships**| WCAG 1.3.1 | Level A | Form controls `<input>`, `<select>` must link to `<label>` via `id/for` or `aria-label`. |
47
- | **Heading Structure** | WCAG 1.3.1 | Level A | Headings must not skip levels (e.g. `<h1>` followed immediately by `<h3>`). |
47
+ | **Heading Structure** | WCAG 1.3.1 | Level A | Headings should follow logical hierarchy without skipping levels (advisory best practice per W3C Technique G141). |
48
48
  | **Contrast (Minimum)** | WCAG 1.4.3 | Level AA | Normal text contrast ratio $\ge 4.5:1$; Large text ($\ge 18\text{pt}$ or bold $14\text{pt}$) $\ge 3:1$. |
49
49
  | **Keyboard Navigable** | WCAG 2.1.1 | Level A | All interactive elements must be focusable via `Tab` with visible focus indicators. |
50
- | **No Keyboard Trap** | WCAG 2.1.2 | Level A | Focus must not become permanently trapped in modal dialogs; `Esc` key must exit. |
50
+ | **No Keyboard Trap** | WCAG 2.1.2 | Level A | Focus must not become trapped; modal dialogs must provide a standard keyboard exit (e.g. `Esc` key, reachable close button). |
51
51
  | **Focus Not Obscured** | WCAG 2.4.11 | Level AA | Focused element must not be completely hidden by sticky banners, footers, or overlays (WCAG 2.2). |
52
- | **Target Size (Minimum)**| WCAG 2.5.8 | Level AA | Interactive targets must meet $24 \times 24\text{px}$ minimum bounding box or sufficient spacing (WCAG 2.2). |
52
+ | **Target Size (Minimum)**| WCAG 2.5.8 | Level AA | Interactive targets must meet $24 \times 24\text{px}$ or sufficient spacing/offset (WCAG 2.2; exceptions: inline text links, essential UI). |
53
53
  | **Consistent Help** | WCAG 3.2.6 | Level A | Help options (chat, FAQ, phone) must reside in identical relative layout order across pages (WCAG 2.2). |
54
54
  | **Redundant Entry** | WCAG 3.3.7 | Level A | Multi-step workflows must auto-populate or allow selection of previously entered data (WCAG 2.2). |
55
55
  | **Accessible Auth** | WCAG 3.3.8 | Level AA | Login must support password managers / paste / passkeys without cognitive puzzles (WCAG 2.2). |
@@ -98,6 +98,7 @@ test('modal dialog traps keyboard focus and closes on Escape', async ({ page })
98
98
  ```
99
99
 
100
100
  ### Pattern C: WCAG 2.5.8 Target Size ($24 \times 24\text{px}$) Assertion
101
+ > **WCAG 2.5.8 Exceptions:** Targets under $24 \times 24\text{px}$ pass if sufficient spacing (offset) ensures a 24px diameter circle centered on the target does not intersect another target/circle, or if the target is inline within a block of text, user-agent controlled, or essential.
101
102
  <!-- classification: illustrative -->
102
103
  ```typescript
103
104
  test('all interactive buttons satisfy WCAG 2.5.8 24x24px target size', async ({ page }) => {
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Perform automated Ambiguity Analysis, Gap Detection, and Boundary Verification on Business Requirements Documents (BRD, PRD, User Stories).
2
+ description: Requirement ambiguity, gap detection, and boundary verification.
3
3
  skills:
4
4
  - rbt-manual-testing
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Convert a Markdown Test Case table into a corporate-styled, formatted Excel spreadsheet (.xlsx) using the native tools/md_to_xlsx.py engine.
2
+ description: Convert Markdown test cases into styled Excel (.xlsx) spreadsheets.
3
3
  skills:
4
4
  - rbt-manual-testing
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Generate concrete combinatorial test data sets (JSON, CSV, Markdown) covering all parameter combinations from a cross-module dimension matrix or Pairwise specification.
2
+ description: Synthesize combinatorial test data fixtures covering pairwise parameter combinations.
3
3
  skills:
4
4
  - synthetic-test-data-generator
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Analyze end-to-end user journeys traversing multiple interconnected modules, construct Data Flow Diagrams, and generate optimized Pairwise (All-Pairs) combinatorial test matrices.
2
+ description: Cross-module user journey test planning and pairwise combinatorial test matrices.
3
3
  skills:
4
4
  - clean-pom-crafter
5
5
  - e2e-testing-patterns
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Generate comprehensive manual test cases using the 6-stage AI-RBT (Risk-Based Testing) methodology with ambiguity checkpoints and 15-field validation checklist.
2
+ description: Generate manual test cases using 6-stage Risk-Based Testing pipeline.
3
3
  skills:
4
4
  - rbt-manual-testing
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Reverse-engineer structured functional requirements and user story specifications by inspecting a live web application using headless Playwright.
2
+ description: Reverse-engineer functional requirements and user stories by inspecting live web apps.
3
3
  skills:
4
4
  - playwright-live-interaction
5
5
  - clean-pom-crafter
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Fast single-pass generation of structured manual test cases directly from requirements or user stories (QUICK Mode of rbt-manual-testing).
2
+ description: Rapid single-pass generation of structured test cases from requirements.
3
3
  skills:
4
4
  - rbt-manual-testing
5
5
  ---
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: test-impact
3
- description: Analyze impacted test cases after modifying Page Classes using AST Knowledge Graph.
3
+ description: Analyze impacted test cases after modifying Page Classes.
4
4
  trigger: /test-impact
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: verify
3
- description: Execute 10 Quality Gates to verify complete codebase integrity and enforce deterministic safety boundaries before handoff.
3
+ description: Execute 10 Quality Gates to verify codebase integrity before completion.
4
4
  trigger: /verify
5
5
  ---
6
6
 
package/AGENTS.md CHANGED
@@ -19,7 +19,7 @@ Mandatory across all workspaces, projects, test scripts, and runtime environment
19
19
 
20
20
  1. **100% UTF-8 No BOM:** Zero BOM bytes (`0xEF, 0xBB, 0xBF`) across all repository and test files (`.groovy`, `.java`, `.ts`, `.py`, `.json`, `.md`).
21
21
  2. **Truth Anchor (Zero Fake Passes):** Never relax assertions, skip validation steps, write empty tests (0 asserts), or catch-and-swallow exceptions (`pass`, dummy suppression `_ = err` or `_ = False`, `const _ = e`) to manufacture a pass. Report AUT defects honestly.
22
- 3. **Dynamic Smart Waits Only:** Static sleeps (`Thread.sleep`, `time.sleep`) are strictly prohibited in test scripts to prevent flakiness. Use dynamic smart waits: element visibility checks or Playwright `waitForLoadState('networkidle')`.
22
+ 3. **Dynamic Smart Waits Only:** Static sleeps (`Thread.sleep`, `time.sleep`, `waitForTimeout`) are strictly prohibited in test scripts to prevent flakiness. Use dynamic smart waits: web-first element visibility checks (`expect(locator).toBeVisible()`) or bounded Playwright `waitForLoadState('networkidle')` (avoid unconditional `networkidle` on apps with continuous polling, WebSocket, or streaming traffic).
23
23
  4. **Dynamic & Idempotent Test Data:** Always randomize test entity codes with dynamic timestamps and prefixes (`BasePage.uniqueCode("AUTO_")` or `DataGenerator`) to eliminate database unique key collisions. Every creation test case must be paired with automated Teardown cleanup.
24
24
  5. **Strict Credential Security:** Never commit raw plaintext passwords, secret tokens, private keys, or cloud credentials to git. Inject secrets via environment variables or test fixtures.
25
25
  6. **Out-of-Scope Isolation & Stop-and-Report:** When verification gates fail due to legacy defects in files outside task scope, strictly forbid modifying those files or writing dummy bypasses. Stop and report with evidence; ask the user whether to baseline legacy debt or handle it in a separate task.
package/README.en.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  > **Core Mission:** A standalone linter and guardrail engine (zero external dependencies for core engine & DoD gates) safeguarding automated test suites when AI writes code — Automatically catching "fake-pass" tests (0 assertions, tautologies), eliminating fixed sleeps, compressing 95% of CI/CD log noise, and enforcing Clean POM architecture.
8
8
  > **Author:** Thế Vị ([@TeeVee98](https://github.com/TeeVee98)) | **License:** MIT License
9
- > **Version:** `v4.2.3` | **Scale:** 53 Standardized QA Skills, 9 Specialized AI Agents, 10 DoD Quality Gates.
9
+ > **Version:** `v4.2.5` | **Scale:** 53 Standardized QA Skills, 9 Specialized AI Agents, 10 DoD Quality Gates.
10
10
 
11
11
  [![npm version](https://img.shields.io/npm/v/@teevee98/synapse-hub.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@teevee98/synapse-hub)
12
12
  [![node version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org)
@@ -154,7 +154,7 @@ Every test code change must satisfy all 10 Quality Gates before pull request mer
154
154
  # Pre-commit hook (.pre-commit-config.yaml):
155
155
  repos:
156
156
  - repo: https://github.com/TeeVee98/Synapse-Hub
157
- rev: v4.2.3
157
+ rev: v4.2.5
158
158
  hooks:
159
159
  - id: synapse-lint
160
160
  - id: synapse-verify
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  > **Định vị cốt lõi:** Bộ Linter & Guardrails độc lập (zero external dependencies cho core engine & DoD gates) bảo vệ độ tin cậy của test suite khi AI viết code — Tự động bắt test "pass ảo" (0 assert, tautology), loại bỏ hoàn toàn sleep cố định, nén 95% log CI/CD, và chuẩn hóa cấu trúc Clean POM.
8
8
  > **Tác giả:** Thế Vị ([@TeeVee98](https://github.com/TeeVee98)) | **Giấy phép:** MIT License
9
- > **Phiên bản:** `v4.2.3` | **Quy mô:** 53 Kỹ năng QA, 9 Vai trò AI Agent, 10 Cổng kiểm định DoD.
9
+ > **Phiên bản:** `v4.2.5` | **Quy mô:** 53 Kỹ năng QA, 9 Vai trò AI Agent, 10 Cổng kiểm định DoD.
10
10
 
11
11
  [![npm version](https://img.shields.io/npm/v/@teevee98/synapse-hub.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@teevee98/synapse-hub)
12
12
  [![node version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org)
@@ -154,7 +154,7 @@ Mọi thay đổi mã nguồn kiểm thử đều được kiểm chứng qua 10
154
154
  # Pre-commit hook (.pre-commit-config.yaml):
155
155
  repos:
156
156
  - repo: https://github.com/TeeVee98/Synapse-Hub
157
- rev: v4.2.3
157
+ rev: v4.2.5
158
158
  hooks:
159
159
  - id: synapse-lint
160
160
  - id: synapse-verify
package/agentskills.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agentskills.io/schema/v1.json",
3
3
  "name": "Synapse-Hub",
4
- "version": "4.2.3",
4
+ "version": "4.2.5",
5
5
  "description": "Enterprise QA & Test Automation AI Skills Ecosystem — 53 skills organised across 11 Domain Packages adhering to Clean POM Flat Architecture.",
6
6
  "author": "Thế Vị (@TeeVee98)",
7
7
  "repository": "https://github.com/TeeVee98/Synapse-Hub",
@@ -3,7 +3,7 @@
3
3
  [🇻🇳 Tiếng Việt](ARCHITECTURE.md) | [🇬🇧 English Edition](ARCHITECTURE.en.md)
4
4
 
5
5
  > **Scope:** Enterprise Multi-Agent QA Hub
6
- > **Version:** `4.2.3` | **Status:** Active / Production Standard
6
+ > **Version:** `4.2.5` | **Status:** Active / Production Standard
7
7
 
8
8
  ---
9
9
 
@@ -3,7 +3,7 @@
3
3
  [🇻🇳 Tiếng Việt](ARCHITECTURE.md) | [🇬🇧 English Edition](ARCHITECTURE.en.md)
4
4
 
5
5
  > **Phạm vi:** Enterprise Multi-Agent QA Hub
6
- > **Version:** `4.2.3` | **Trạng thái:** Hoạt động / Tiêu chuẩn Sản xuất
6
+ > **Version:** `4.2.5` | **Trạng thái:** Hoạt động / Tiêu chuẩn Sản xuất
7
7
  > **Tác giả:** Thế Vị (@TeeVee98) | **Giấy phép:** MIT License
8
8
 
9
9
  ---
@@ -86,8 +86,8 @@ The evaluation covers five core performance pillars:
86
86
  ### 2.2 Technical Invalidation: Why the System Fails Production Certification
87
87
  Deploying this performance testing framework into mission-critical production pipelines without human oversight will lead to false passes, undetected latency spikes, or infrastructure instability. The certification denial is grounded in six fatal deficiencies:
88
88
 
89
- 1. **Complete Disconnection from Mandatory Quality Gatekeeper (`tools/verify_all.py`):**
90
- The central Definition of Done (`verify_all.py`), which controls Stage 5 acceptance in `AGENTS.md`, evaluates Gates 0 through 9 (attribution, BOM, path portability, clean POM, docs drift, cleanup blacklist, credentials, static defect AST, micro-mutation, and skill collision). **Zero performance or SLA gates exist in `verify_all.py`.** A PR introducing severe tail-latency degradation or elevated 5xx error rates will pass the 10 gates with zero warnings and merge into production.
89
+ 1. **[RESOLVED] Historical Disconnection from Mandatory Quality Gatekeeper (`tools/verify_all.py`):**
90
+ *(Status: Resolved in Synapse Hub v4.2+ via `gate_10_performance_sla`).* Earlier audits noted that `verify_all.py` only evaluated Gates 0 through 9 without a performance gate. `verify_all.py` now implements **Gate 10: Performance & SLA Sentinel**, which ingests performance test artifacts (`.jtl`, `k6_summary.json`) from `Reports/perf/` and validates P95 latency and error rate thresholds against configured SLAs before granting DoD certification.
91
91
  2. **Absence of Autonomous `abortOnFail` Kill-Switch in Generated JMeter Suites:**
92
92
  While the k6 documentation specifies error rate thresholds, `tools/generate_jmx_plan.py` emits thread groups with `<stringProp name="ThreadGroup.on_sample_error">continue</stringProp>` and injects no AutoStop listeners or JSR223 aggregate failure monitors. Under catastrophic gateway degradation (e.g. cascading 503s), the load generator will continuously hammer degraded upstream microservices until test completion, triggering cascading outages in shared environments.
93
93
  3. **Single-Token Auth Anti-Pattern in Canonical k6 Template:**