@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.
- package/.agents/agents/api-engineer.md +1 -1
- package/.agents/agents/failure-analyst.md +1 -1
- package/.agents/agents/live-explorer.md +1 -1
- package/.agents/agents/orchestrator.md +1 -1
- package/.agents/agents/perf-engineer.md +1 -1
- package/.agents/agents/pom-crafter.md +1 -1
- package/.agents/agents/quality-gatekeeper.md +1 -1
- package/.agents/agents/test-designer.md +1 -1
- package/.agents/agents/test-runner.md +1 -1
- package/.agents/rules/git-push-protocol.md +2 -2
- package/.agents/rules/lessons-learned.md +10 -12
- package/.agents/rules/mandatory-playwright-live.md +1 -1
- package/.agents/rules/skill-precedence.md +1 -1
- package/.agents/rules/systematic-debugging.md +3 -3
- package/.agents/skills/01-web-automation/playwright-live-interaction/SKILL.md +2 -2
- package/.agents/skills/01-web-automation/playwright-live-interaction/references/recipes.md +14 -31
- package/.agents/skills/05-security-and-compliance/wcag-audit-patterns/SKILL.md +5 -4
- package/.agents/workflows/analyze_requirement_document.md +1 -1
- package/.agents/workflows/export_testcases_excel.md +1 -1
- package/.agents/workflows/generate_combinatorial_test_data.md +1 -1
- package/.agents/workflows/generate_cross_module_test_plan.md +1 -1
- package/.agents/workflows/generate_manual_testcases_rbt.md +1 -1
- package/.agents/workflows/generate_requirements_from_website.md +1 -1
- package/.agents/workflows/generate_testcases_from_requirements.md +1 -1
- package/.agents/workflows/test-impact.md +1 -1
- package/.agents/workflows/verify.md +1 -1
- package/AGENTS.md +1 -1
- package/README.en.md +2 -2
- package/README.md +2 -2
- package/agentskills.json +1 -1
- package/docs/ARCHITECTURE.en.md +1 -1
- package/docs/ARCHITECTURE.md +1 -1
- package/docs/PERFORMANCE_AUDIT_REPORT.md +2 -2
- package/docs/TOOL_CATALOG.md +25 -20
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/scripts/setup.sh +6 -1
- package/skills_manifest.json +1 -1
- package/synapse.config.json +1 -1
- package/tools/TOOL_CATALOG.json +112 -31
- package/tools/__init__.py +1 -1
- package/tools/browser_helpers.js +2 -2
- package/tools/cli.py +3 -3
- package/tools/core/file_lock.py +7 -0
- package/tools/core/memory_bus.py +44 -40
- package/tools/core/process_supervisor.py +12 -4
- package/tools/core/telemetry.py +54 -16
- package/tools/dashboard_generator.py +6 -6
- package/tools/db_sandbox.py +8 -2
- package/tools/generate_tool_catalog.py +32 -2
- package/tools/mcp_docx_server.py +1 -1
- package/tools/mcp_excel_server.py +1 -1
- package/tools/mcp_server.py +1 -1
- package/tools/package_release.py +22 -27
- package/tools/reversible_sandbox.py +43 -10
- package/tools/task_memory_manager.py +2 -1
- package/tools/ui_server.py +1 -1
- package/tools/update_sentinel.py +3 -3
- package/tools/welcome_page.py +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: api-engineer
|
|
3
|
-
description: Enterprise API
|
|
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:
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
14
|
-
| **2** | **GIS
|
|
15
|
-
| **3** | **`
|
|
16
|
-
| **4** | **Context
|
|
17
|
-
| **5** | **Flaky timing on CI
|
|
18
|
-
| **6** | **DB polluted with test junk** | Created entities without
|
|
19
|
-
| **7** | **
|
|
20
|
-
| **8** | **Target test
|
|
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
|
-
|
|
23
|
-
- **
|
|
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.
|
|
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,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
|
-
trigger:
|
|
3
|
-
description:
|
|
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
|
|
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** |
|
|
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
|
|
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
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
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
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
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
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
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 |
|
|
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
|
|
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
|
|
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}$
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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
|
|
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
|
|
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:
|
|
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: verify
|
|
3
|
-
description: Execute 10 Quality Gates to verify
|
|
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.
|
|
9
|
+
> **Version:** `v4.2.5` | **Scale:** 53 Standardized QA Skills, 9 Specialized AI Agents, 10 DoD Quality Gates.
|
|
10
10
|
|
|
11
11
|
[](https://www.npmjs.com/package/@teevee98/synapse-hub)
|
|
12
12
|
[](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.
|
|
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.
|
|
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
|
[](https://www.npmjs.com/package/@teevee98/synapse-hub)
|
|
12
12
|
[](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.
|
|
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.
|
|
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",
|
package/docs/ARCHITECTURE.en.md
CHANGED
|
@@ -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.
|
|
6
|
+
> **Version:** `4.2.5` | **Status:** Active / Production Standard
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -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.
|
|
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. **
|
|
90
|
-
|
|
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:**
|