@teevee98/synapse-hub 4.2.0 → 4.2.2
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/skills/01-web-automation/auth-session-and-cookie-manager/SKILL.md +46 -2
- package/.agents/skills/01-web-automation/bats-testing-patterns/SKILL.md +49 -4
- package/.agents/skills/01-web-automation/clean-pom-crafter/SKILL.md +56 -66
- package/.agents/skills/01-web-automation/e2e-testing-patterns/SKILL.md +48 -3
- package/.agents/skills/01-web-automation/katalon-cli-runner/SKILL.md +56 -11
- package/.agents/skills/01-web-automation/lam-script-generator/SKILL.md +49 -7
- package/.agents/skills/01-web-automation/mobile-appium-som/SKILL.md +54 -11
- package/.agents/skills/01-web-automation/playwright-live-interaction/SKILL.md +48 -90
- package/.agents/skills/01-web-automation/playwright-webapp-testing/SKILL.md +53 -10
- package/.agents/skills/01-web-automation/web-agent-gym-benchmarking/SKILL.md +44 -3
- package/.agents/skills/02-test-design/architecture-decision-records/SKILL.md +49 -8
- package/.agents/skills/02-test-design/gherkin-to-suite/SKILL.md +49 -8
- package/.agents/skills/02-test-design/rbt-manual-testing/SKILL.md +49 -7
- package/.agents/skills/02-test-design/review-spec/SKILL.md +46 -5
- package/.agents/skills/02-test-design/tot-exploratory-testing/SKILL.md +44 -3
- package/.agents/skills/03-api-and-contracts/api-network-mocking-interception/SKILL.md +50 -4
- package/.agents/skills/03-api-and-contracts/api-spec-to-e2e-matrix/SKILL.md +47 -6
- package/.agents/skills/03-api-and-contracts/consumer-driven-contract-testing/SKILL.md +79 -34
- package/.agents/skills/04-performance-and-load/backend-load-and-stress-patterns/SKILL.md +47 -4
- package/.agents/skills/04-performance-and-load/lean-impact-scoreboard/SKILL.md +46 -5
- package/.agents/skills/04-performance-and-load/web-vitals-and-performance-profiler/SKILL.md +44 -2
- package/.agents/skills/05-security-and-compliance/security-dast-sentinel/SKILL.md +57 -13
- package/.agents/skills/05-security-and-compliance/skillspector-security-guard/SKILL.md +45 -4
- package/.agents/skills/05-security-and-compliance/wcag-audit-patterns/SKILL.md +48 -3
- package/.agents/skills/06-healing-and-resilience/agentless-qa-repair/SKILL.md +45 -4
- package/.agents/skills/06-healing-and-resilience/antigravity-test-sentinel/SKILL.md +47 -5
- package/.agents/skills/06-healing-and-resilience/failure-autopsy-and-healing/SKILL.md +48 -7
- package/.agents/skills/06-healing-and-resilience/flaky-test-sentinel-and-quarantine/SKILL.md +54 -23
- package/.agents/skills/06-healing-and-resilience/self-healing-locator/SKILL.md +46 -5
- package/.agents/skills/06-healing-and-resilience/systematic-debugging/SKILL.md +50 -9
- package/.agents/skills/06-healing-and-resilience/test-driven-development/SKILL.md +52 -11
- package/.agents/skills/06-healing-and-resilience/verification-before-completion/SKILL.md +52 -11
- package/.agents/skills/06-healing-and-resilience/visual-regression-sentinel/SKILL.md +47 -4
- package/.agents/skills/07-data-and-state/db-state-verifier-and-seeder/SKILL.md +50 -4
- package/.agents/skills/07-data-and-state/file-and-report-validator/SKILL.md +47 -3
- package/.agents/skills/07-data-and-state/synthetic-test-data-generator/SKILL.md +52 -4
- package/.agents/skills/08-code-quality/code-refactoring-refactor-clean/SKILL.md +51 -10
- package/.agents/skills/08-code-quality/graphify-impact-analyzer/SKILL.md +78 -34
- package/.agents/skills/08-code-quality/graphify-impact-analyzer/examples/dependency_blast_radius.json +3 -4
- package/.agents/skills/08-code-quality/lean-code-ladder/SKILL.md +49 -9
- package/.agents/skills/08-code-quality/repo-quality-audit/SKILL.md +45 -5
- package/.agents/skills/08-code-quality/senior-code-review/SKILL.md +48 -6
- package/.agents/skills/08-code-quality/surgical-coding-principles/SKILL.md +49 -9
- package/.agents/skills/08-code-quality/technical-debt-harvester/SKILL.md +47 -4
- package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +48 -16
- package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +2 -1
- package/.agents/skills/10-agent-orchestration/actor-qa-swarm/SKILL.md +44 -3
- package/.agents/skills/10-agent-orchestration/agent-orchestration-multi-agent-optimize/SKILL.md +47 -6
- package/.agents/skills/10-agent-orchestration/event-stream-qa-orchestrator/SKILL.md +44 -3
- package/.agents/skills/10-agent-orchestration/persistent-planning-files/SKILL.md +52 -12
- package/.agents/skills/10-agent-orchestration/qa-memory-os/SKILL.md +45 -4
- package/.agents/skills/11-ai-and-prompting/meta-prompt-crafter/SKILL.md +51 -9
- package/.agents/skills/11-ai-and-prompting/mipro-prompt-compiler/SKILL.md +44 -3
- package/.agents/skills/11-ai-and-prompting/qa-aci-interface/SKILL.md +44 -3
- package/.agents/skills/11-ai-and-prompting/token-and-context-optimizer/SKILL.md +49 -8
- package/.cursor/rules/synapse-qa.mdc +20 -7
- package/.cursorrules +19 -5
- package/.windsurfrules +18 -3
- package/AGENTS.md +51 -65
- package/CLAUDE.md +38 -24
- 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/CLIENT_SUPPORT_MATRIX.md +44 -0
- package/docs/SIDE_EFFECTING_TOOLS_INVENTORY.md +233 -0
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/skills_manifest.json +1 -1
- package/synapse.config.json +1 -1
- package/templates/ai_bridges/CLAUDE.md +29 -26
- package/templates/ai_bridges/copilot-instructions.md +14 -5
- package/templates/ai_bridges/cursor_synapse_qa.mdc +16 -7
- package/templates/ai_bridges/windsurfrules +14 -3
- package/tools/TOOLS_RUNBOOK.md +1 -1
- package/tools/__init__.py +1 -1
- package/tools/api_fuzzer.py +295 -41
- package/tools/benchmark_swarm_context.py +11 -4
- package/tools/browser_helpers.js +2 -2
- package/tools/bump_version.py +2 -2
- package/tools/cli.py +4 -4
- package/tools/core/bm25_retriever.py +1 -1
- package/tools/core/i18n.py +1 -1
- package/tools/core/provider_usage_adapter.py +66 -0
- package/tools/core/token_estimator.py +39 -1
- package/tools/count_tokens.py +2 -2
- package/tools/dashboard_generator.py +8 -8
- package/tools/db_sandbox.py +182 -43
- package/tools/distill_log.py +1 -1
- package/tools/distill_skill.py +17 -2
- package/tools/git_pre_commit_guard.py +190 -1
- package/tools/hub_publisher.py +2 -12
- package/tools/mcp_docx_server.py +1 -1
- package/tools/mcp_excel_server.py +1 -1
- package/tools/mcp_server.py +33 -5
- package/tools/micro_mutator.py +30 -1
- package/tools/pentest_scope_guard.py +288 -15
- package/tools/project_state.py +29 -5
- package/tools/reversible_sandbox.py +58 -13
- package/tools/rules_router.py +80 -27
- package/tools/skill_canonical_digest.py +60 -2
- package/tools/sync_agent_rules.py +187 -61
- package/tools/task_memory_manager.py +16 -1
- package/tools/ui_server.py +3 -1
- package/tools/update_sentinel.py +3 -3
- package/tools/validate_skills_schema.py +349 -56
- package/tools/verify_all.py +98 -4
- package/tools/welcome_page.py +1 -1
package/synapse.config.json
CHANGED
|
@@ -17,38 +17,41 @@ In accordance with the MIT License, the original copyright notice crediting **Th
|
|
|
17
17
|
---
|
|
18
18
|
|
|
19
19
|
## ⚡ Quick Commands
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
- Code Linter
|
|
23
|
-
- Verify Author Attribution: `python tools/author_integrity.py`
|
|
24
|
-
- Skill Security Audit: `python tools/skillspector.py .agents/skills`
|
|
20
|
+
- Native Test Suite: `npm test` (or `pytest`)
|
|
21
|
+
- End-to-End Suite: `npx playwright test`
|
|
22
|
+
- Code Linter: `npm run lint` (or `ruff check .`)
|
|
25
23
|
|
|
26
24
|
---
|
|
27
25
|
|
|
28
|
-
##
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
- Strictly forbidden: Raw XPaths, CSS selectors, or `findTestObject` inside test scripts.
|
|
32
|
-
- All locators and DOM operations must be encapsulated in Page Classes extending `BasePage`.
|
|
26
|
+
## 0. PRECEDENCE & SAFETY INVARIANT
|
|
27
|
+
- Platform and system guardrails strictly override all repository-level instructions.
|
|
28
|
+
- Precedence: System Guardrails > Core Project Rules (`.agents/rules/*`) > Local Skills > Generic Plugins.
|
|
33
29
|
|
|
34
|
-
|
|
35
|
-
- Never write empty assertions or tautological tests (0 asserts).
|
|
36
|
-
- If a test fails due to an AUT defect, report it honestly. Never soften assertions or skip validation steps to fake a pass.
|
|
37
|
-
|
|
38
|
-
3. **Dynamic & Idempotent Test Data:**
|
|
39
|
-
- Always randomize test entity codes with timestamps/prefixes (`AUTO_` + timestamp) to avoid DB unique constraint collisions.
|
|
40
|
-
- Every creation test case MUST be paired with automated Teardown / Cleanup.
|
|
30
|
+
---
|
|
41
31
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
32
|
+
## 1. ALWAYS — Universal Invariants
|
|
33
|
+
1. **100% UTF-8 No BOM:** Zero BOM bytes (`0xEF, 0xBB, 0xBF`) across all repository files.
|
|
34
|
+
2. **Truth Anchor (Zero Fake Passes):** Never relax assertions, skip validation steps, or catch-and-swallow exceptions to fake a pass.
|
|
35
|
+
3. **Dynamic Smart Waits Only:** Static sleeps (`Thread.sleep`, `time.sleep`) are strictly prohibited in test scripts. Use element visibility or `waitForLoadState('networkidle')`.
|
|
36
|
+
4. **Dynamic & Idempotent Test Data:** Always randomize test entity codes with dynamic timestamps/prefixes (`BasePage.uniqueCode("AUTO_")`). Pair creation with automated Teardown cleanup.
|
|
37
|
+
5. **Strict Credential Security:** Never commit raw plaintext passwords, secret tokens, or private keys.
|
|
38
|
+
6. **Out-of-Scope Isolation:** When verification gates fail due to legacy defects in files outside task scope, stop and report; never touch out-of-scope files.
|
|
45
39
|
|
|
46
|
-
|
|
47
|
-
- Conversational responses, explanation, and telemetry MUST be in Vietnamese.
|
|
48
|
-
- All codebase assets, test scripts, Page Classes, docstrings, and commits MUST remain strictly in English.
|
|
49
|
-
- English-First Document Ingestion: When reading bilingual docs (e.g. ARCHITECTURE.en.md vs ARCHITECTURE.md), always read the English version (*.en.md) to save 50–65% BPE tokens.
|
|
40
|
+
---
|
|
50
41
|
|
|
51
|
-
|
|
42
|
+
## 2. RECOMMENDED — Best Practices
|
|
43
|
+
1. **Clean Page Object Model (POM) Flat Architecture:**
|
|
44
|
+
- Test scripts (`tests/`, `Scripts/`) must contain ONLY business workflow method calls on Page Classes.
|
|
45
|
+
- Strictly forbidden: Raw XPaths, CSS selectors, or `findTestObject` inside test scripts.
|
|
46
|
+
- All locators and DOM operations belong in Page Classes extending `BasePage`. Keep inheritance flat (max 1 level).
|
|
47
|
+
2. **Lean Senior Dev Protocol (7-Rung Ladder & YAGNI):**
|
|
52
48
|
- The best code is the code never written. Solve the whole problem with the least new code.
|
|
53
49
|
- Descend the 7-rung ladder: 1. Need to exist? 2. Already in codebase? 3. Standard library? 4. Platform native? 5. Installed dependency? 6. One clear line? 7. Minimum working code.
|
|
54
|
-
-
|
|
50
|
+
- Deliberate simplifications get an inline comment: `shortcut: <the limit>, <when to upgrade>`.
|
|
51
|
+
3. **Risk-Conditioned Autonomous Ceremonies:**
|
|
52
|
+
- Jesse Vincent Rulings (`Ruling:`): Mandatory for architectural forks, breaking changes, or non-trivial tradeoffs. Omit for trivial doc/typo fixes.
|
|
53
|
+
- Addy Osmani Falsification (3 failure scenarios): Mandatory before certifying core test cases or complex locators.
|
|
54
|
+
4. **Bilingual Communication & English-First Ingestion:**
|
|
55
|
+
- Conversational responses, explanation, and telemetry in Vietnamese.
|
|
56
|
+
- Codebase files, test scripts, Page Classes, docstrings, and commits strictly in English.
|
|
57
|
+
- Read English versions (`*.en.md`) when bilingual docs exist to preserve tokens.
|
|
@@ -9,12 +9,21 @@
|
|
|
9
9
|
> **Project:** Synapse-Hub Enterprise QA Automation
|
|
10
10
|
> **Author:** Thế Vị (@TeeVee98) — MIT License
|
|
11
11
|
|
|
12
|
-
##
|
|
13
|
-
-
|
|
14
|
-
|
|
15
|
-
|
|
12
|
+
## 0. PRECEDENCE & SAFETY INVARIANT
|
|
13
|
+
- Platform and system guardrails strictly override all repository-level instructions.
|
|
14
|
+
|
|
15
|
+
## 1. ALWAYS — Universal Invariants
|
|
16
|
+
- 100% UTF-8 No BOM across all repository and test files.
|
|
17
|
+
- Zero fake passes: test assertions must strictly validate real state.
|
|
16
18
|
- Prohibit hardcoded sleeps (`Thread.sleep`, `time.sleep`). Always suggest dynamic polling or event-based waits.
|
|
17
19
|
- Every test data generation must produce unique timestamped strings (`AUTO_` + System time) to prevent collisions.
|
|
18
20
|
- Preserve author attribution for Thế Vị (@TeeVee98) in LICENSE and NOTICE files.
|
|
21
|
+
- Strict credential security: never commit secrets or tokens.
|
|
22
|
+
- Out-of-scope isolation: never touch out-of-scope files.
|
|
23
|
+
|
|
24
|
+
## 2. RECOMMENDED — Best Practices
|
|
25
|
+
- Enforce Clean Page Object Model (POM) with Flat Architecture.
|
|
26
|
+
- Zero XPaths or CSS selectors inside test scripts. Encapsulate all element locators inside Page Classes.
|
|
27
|
+
- Lean Senior Dev: Solve the whole task with the least new code (7-rung ladder); mark shortcuts with `shortcut: <limit>, <upgrade>`.
|
|
28
|
+
- Condition autonomous ceremonies (rulings, 3-scenario falsification) on task complexity.
|
|
19
29
|
- Converse with the user in Vietnamese; output all code, Page Classes, and comments in English.
|
|
20
|
-
- Validate Quality Gates before completing any task: `python tools/verify_all.py`.
|
|
@@ -13,12 +13,21 @@ globs: **/*
|
|
|
13
13
|
|
|
14
14
|
## Mandatory Author Attribution
|
|
15
15
|
This project incorporates Synapse Hub created by Thế Vị (@TeeVee98) under the MIT License.
|
|
16
|
-
Attribution notices must be preserved.
|
|
16
|
+
Attribution notices must be preserved in all copies.
|
|
17
17
|
|
|
18
|
-
##
|
|
19
|
-
|
|
18
|
+
## 0. PRECEDENCE & SAFETY INVARIANT
|
|
19
|
+
Platform guardrails strictly override repository instructions.
|
|
20
|
+
|
|
21
|
+
## 1. ALWAYS — Universal Invariants
|
|
22
|
+
1. **100% UTF-8 No BOM:** Zero BOM bytes across all files.
|
|
20
23
|
2. **Truth Anchor:** Never fake test passes. Report genuine defects.
|
|
21
|
-
3. **
|
|
22
|
-
4. **
|
|
23
|
-
5. **
|
|
24
|
-
6. **
|
|
24
|
+
3. **Smart Wait:** Prohibit static delays (`Thread.sleep`, `time.sleep`). Use dynamic smart waits.
|
|
25
|
+
4. **Idempotent Test Data:** Prefix with `AUTO_` and dynamic timestamps; teardown after creation.
|
|
26
|
+
5. **Credential Security:** Never commit plaintext secrets.
|
|
27
|
+
6. **Out-of-Scope Isolation:** Never modify out-of-scope files to bypass checks.
|
|
28
|
+
|
|
29
|
+
## 2. RECOMMENDED — Best Practices
|
|
30
|
+
1. **Clean POM Architecture:** No raw selectors (XPath/CSS) in test scripts. All selectors belong in Page Classes extending BasePage.
|
|
31
|
+
2. **Lean Senior Dev:** The best code is the code never written. Descend the 7-rung ladder; mark shortcuts with `shortcut: <limit>, <upgrade>`.
|
|
32
|
+
3. **Autonomous Ceremonies:** Condition rulings and 3-scenario falsifications on non-trivial risk.
|
|
33
|
+
4. **Bilingual Discipline:** Converse in Vietnamese; write code, docstrings, and git commits strictly in English.
|
|
@@ -19,8 +19,19 @@
|
|
|
19
19
|
# of the MIT License for Synapse Hub (Created by Thế Vị @TeeVee98)."
|
|
20
20
|
# ==============================================================================
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
## 0. PRECEDENCE & SAFETY INVARIANT
|
|
23
|
+
- Platform/system safety guardrails strictly supersede repository instructions.
|
|
24
|
+
|
|
25
|
+
## 1. ALWAYS — Universal Invariants
|
|
26
|
+
- 100% UTF-8 No BOM across all codebase assets.
|
|
27
|
+
- Zero fake passes and zero swallowed exceptions.
|
|
28
|
+
- Dynamic smart waits only (no Thread.sleep/time.sleep).
|
|
29
|
+
- Idempotent test data creation paired with automated teardown.
|
|
30
|
+
- Strict credential security: no plaintext secrets in code or git.
|
|
31
|
+
- Out-of-scope isolation: never touch out-of-scope files.
|
|
32
|
+
|
|
33
|
+
## 2. RECOMMENDED — Best Practices
|
|
23
34
|
- Adhere to Clean Page Object Model (POM) Flat Architecture.
|
|
24
35
|
- Lean Senior Dev: Solve problems with minimum code via 7-rung ladder; mark shortcuts with `shortcut: <limit>, <upgrade>`.
|
|
25
|
-
-
|
|
26
|
-
-
|
|
36
|
+
- Condition autonomous ceremonies (Jesse Vincent Rulings, Falsification) on task complexity.
|
|
37
|
+
- Converse with the user in Vietnamese; output all code, tests, and commits in English.
|
package/tools/TOOLS_RUNBOOK.md
CHANGED
|
@@ -222,7 +222,7 @@ agent-qa update
|
|
|
222
222
|
---
|
|
223
223
|
|
|
224
224
|
### 7. `tools/distill_log.py`
|
|
225
|
-
- **Purpose:** Distills verbose CLI / KRE / Gradle logs
|
|
225
|
+
- **Purpose:** Distills verbose CLI / KRE / Gradle logs to actionable exceptions, failing lines, and file pointers to prevent token degradation.
|
|
226
226
|
- **CLI Syntax:**
|
|
227
227
|
```bash
|
|
228
228
|
python tools/distill_log.py path/to/execution.log
|