@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.
Files changed (109) hide show
  1. package/.agents/skills/01-web-automation/auth-session-and-cookie-manager/SKILL.md +46 -2
  2. package/.agents/skills/01-web-automation/bats-testing-patterns/SKILL.md +49 -4
  3. package/.agents/skills/01-web-automation/clean-pom-crafter/SKILL.md +56 -66
  4. package/.agents/skills/01-web-automation/e2e-testing-patterns/SKILL.md +48 -3
  5. package/.agents/skills/01-web-automation/katalon-cli-runner/SKILL.md +56 -11
  6. package/.agents/skills/01-web-automation/lam-script-generator/SKILL.md +49 -7
  7. package/.agents/skills/01-web-automation/mobile-appium-som/SKILL.md +54 -11
  8. package/.agents/skills/01-web-automation/playwright-live-interaction/SKILL.md +48 -90
  9. package/.agents/skills/01-web-automation/playwright-webapp-testing/SKILL.md +53 -10
  10. package/.agents/skills/01-web-automation/web-agent-gym-benchmarking/SKILL.md +44 -3
  11. package/.agents/skills/02-test-design/architecture-decision-records/SKILL.md +49 -8
  12. package/.agents/skills/02-test-design/gherkin-to-suite/SKILL.md +49 -8
  13. package/.agents/skills/02-test-design/rbt-manual-testing/SKILL.md +49 -7
  14. package/.agents/skills/02-test-design/review-spec/SKILL.md +46 -5
  15. package/.agents/skills/02-test-design/tot-exploratory-testing/SKILL.md +44 -3
  16. package/.agents/skills/03-api-and-contracts/api-network-mocking-interception/SKILL.md +50 -4
  17. package/.agents/skills/03-api-and-contracts/api-spec-to-e2e-matrix/SKILL.md +47 -6
  18. package/.agents/skills/03-api-and-contracts/consumer-driven-contract-testing/SKILL.md +79 -34
  19. package/.agents/skills/04-performance-and-load/backend-load-and-stress-patterns/SKILL.md +47 -4
  20. package/.agents/skills/04-performance-and-load/lean-impact-scoreboard/SKILL.md +46 -5
  21. package/.agents/skills/04-performance-and-load/web-vitals-and-performance-profiler/SKILL.md +44 -2
  22. package/.agents/skills/05-security-and-compliance/security-dast-sentinel/SKILL.md +57 -13
  23. package/.agents/skills/05-security-and-compliance/skillspector-security-guard/SKILL.md +45 -4
  24. package/.agents/skills/05-security-and-compliance/wcag-audit-patterns/SKILL.md +48 -3
  25. package/.agents/skills/06-healing-and-resilience/agentless-qa-repair/SKILL.md +45 -4
  26. package/.agents/skills/06-healing-and-resilience/antigravity-test-sentinel/SKILL.md +47 -5
  27. package/.agents/skills/06-healing-and-resilience/failure-autopsy-and-healing/SKILL.md +48 -7
  28. package/.agents/skills/06-healing-and-resilience/flaky-test-sentinel-and-quarantine/SKILL.md +54 -23
  29. package/.agents/skills/06-healing-and-resilience/self-healing-locator/SKILL.md +46 -5
  30. package/.agents/skills/06-healing-and-resilience/systematic-debugging/SKILL.md +50 -9
  31. package/.agents/skills/06-healing-and-resilience/test-driven-development/SKILL.md +52 -11
  32. package/.agents/skills/06-healing-and-resilience/verification-before-completion/SKILL.md +52 -11
  33. package/.agents/skills/06-healing-and-resilience/visual-regression-sentinel/SKILL.md +47 -4
  34. package/.agents/skills/07-data-and-state/db-state-verifier-and-seeder/SKILL.md +50 -4
  35. package/.agents/skills/07-data-and-state/file-and-report-validator/SKILL.md +47 -3
  36. package/.agents/skills/07-data-and-state/synthetic-test-data-generator/SKILL.md +52 -4
  37. package/.agents/skills/08-code-quality/code-refactoring-refactor-clean/SKILL.md +51 -10
  38. package/.agents/skills/08-code-quality/graphify-impact-analyzer/SKILL.md +78 -34
  39. package/.agents/skills/08-code-quality/graphify-impact-analyzer/examples/dependency_blast_radius.json +3 -4
  40. package/.agents/skills/08-code-quality/lean-code-ladder/SKILL.md +49 -9
  41. package/.agents/skills/08-code-quality/repo-quality-audit/SKILL.md +45 -5
  42. package/.agents/skills/08-code-quality/senior-code-review/SKILL.md +48 -6
  43. package/.agents/skills/08-code-quality/surgical-coding-principles/SKILL.md +49 -9
  44. package/.agents/skills/08-code-quality/technical-debt-harvester/SKILL.md +47 -4
  45. package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +48 -16
  46. package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +2 -1
  47. package/.agents/skills/10-agent-orchestration/actor-qa-swarm/SKILL.md +44 -3
  48. package/.agents/skills/10-agent-orchestration/agent-orchestration-multi-agent-optimize/SKILL.md +47 -6
  49. package/.agents/skills/10-agent-orchestration/event-stream-qa-orchestrator/SKILL.md +44 -3
  50. package/.agents/skills/10-agent-orchestration/persistent-planning-files/SKILL.md +52 -12
  51. package/.agents/skills/10-agent-orchestration/qa-memory-os/SKILL.md +45 -4
  52. package/.agents/skills/11-ai-and-prompting/meta-prompt-crafter/SKILL.md +51 -9
  53. package/.agents/skills/11-ai-and-prompting/mipro-prompt-compiler/SKILL.md +44 -3
  54. package/.agents/skills/11-ai-and-prompting/qa-aci-interface/SKILL.md +44 -3
  55. package/.agents/skills/11-ai-and-prompting/token-and-context-optimizer/SKILL.md +49 -8
  56. package/.cursor/rules/synapse-qa.mdc +20 -7
  57. package/.cursorrules +19 -5
  58. package/.windsurfrules +18 -3
  59. package/AGENTS.md +51 -65
  60. package/CLAUDE.md +38 -24
  61. package/README.en.md +2 -2
  62. package/README.md +2 -2
  63. package/agentskills.json +1 -1
  64. package/docs/ARCHITECTURE.en.md +1 -1
  65. package/docs/ARCHITECTURE.md +1 -1
  66. package/docs/CLIENT_SUPPORT_MATRIX.md +44 -0
  67. package/docs/SIDE_EFFECTING_TOOLS_INVENTORY.md +233 -0
  68. package/package.json +1 -1
  69. package/plugin.json +1 -1
  70. package/skills_manifest.json +1 -1
  71. package/synapse.config.json +1 -1
  72. package/templates/ai_bridges/CLAUDE.md +29 -26
  73. package/templates/ai_bridges/copilot-instructions.md +14 -5
  74. package/templates/ai_bridges/cursor_synapse_qa.mdc +16 -7
  75. package/templates/ai_bridges/windsurfrules +14 -3
  76. package/tools/TOOLS_RUNBOOK.md +1 -1
  77. package/tools/__init__.py +1 -1
  78. package/tools/api_fuzzer.py +295 -41
  79. package/tools/benchmark_swarm_context.py +11 -4
  80. package/tools/browser_helpers.js +2 -2
  81. package/tools/bump_version.py +2 -2
  82. package/tools/cli.py +4 -4
  83. package/tools/core/bm25_retriever.py +1 -1
  84. package/tools/core/i18n.py +1 -1
  85. package/tools/core/provider_usage_adapter.py +66 -0
  86. package/tools/core/token_estimator.py +39 -1
  87. package/tools/count_tokens.py +2 -2
  88. package/tools/dashboard_generator.py +8 -8
  89. package/tools/db_sandbox.py +182 -43
  90. package/tools/distill_log.py +1 -1
  91. package/tools/distill_skill.py +17 -2
  92. package/tools/git_pre_commit_guard.py +190 -1
  93. package/tools/hub_publisher.py +2 -12
  94. package/tools/mcp_docx_server.py +1 -1
  95. package/tools/mcp_excel_server.py +1 -1
  96. package/tools/mcp_server.py +33 -5
  97. package/tools/micro_mutator.py +30 -1
  98. package/tools/pentest_scope_guard.py +288 -15
  99. package/tools/project_state.py +29 -5
  100. package/tools/reversible_sandbox.py +58 -13
  101. package/tools/rules_router.py +80 -27
  102. package/tools/skill_canonical_digest.py +60 -2
  103. package/tools/sync_agent_rules.py +187 -61
  104. package/tools/task_memory_manager.py +16 -1
  105. package/tools/ui_server.py +3 -1
  106. package/tools/update_sentinel.py +3 -3
  107. package/tools/validate_skills_schema.py +349 -56
  108. package/tools/verify_all.py +98 -4
  109. package/tools/welcome_page.py +1 -1
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://raw.githubusercontent.com/TeeVee98/Synapse-Hub/main/docs/schemas/synapse.config.schema.json",
3
- "version": "4.2.0",
3
+ "version": "4.2.2",
4
4
  "quality_gates": {
5
5
  "mutation_min_score": 80,
6
6
  "gates": {
@@ -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
- - Verify 10 Quality Gates: `npx @teevee98/synapse-hub verify` (or `python tools/verify_all.py`)
21
- - Project Health Audit: `npx @teevee98/synapse-hub analyze` (or `python tools/analyze_project.py`)
22
- - Code Linter & Fake-Pass Sentinel: `npx @teevee98/synapse-hub lint` (or `python tools/infer_linter.py`)
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
- ## 🏛️ Core QA Automation Invariants (From AGENTS.md)
29
- 1. **Clean Page Object Model (POM):**
30
- - Test scripts (`tests/`, `Scripts/`) must contain ONLY business workflow method calls on Page Classes.
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
- 2. **Truth Anchor (Zero Fake Passes):**
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
- 4. **Synchronization & Smart Waits:**
43
- - Static sleeps (`Thread.sleep`, `time.sleep`) are strictly prohibited in test scripts.
44
- - Use dynamic smart waits: element visibility checks or Playwright `waitForLoadState('networkidle')`.
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
- 5. **Pragmatic Communication Protocol:**
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
- 6. **Lean Senior Dev Protocol (The 7-Rung Ladder & YAGNI):**
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
- - Any deliberate simplification gets an inline comment: `shortcut: <the limit>, <when to upgrade>`.
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
- ## Coding Invariants
13
- - Enforce Clean Page Object Model (POM) with Flat Architecture.
14
- - Zero XPaths or CSS selectors inside test scripts. Encapsulate all element locators inside Page Classes.
15
- - Lean Senior Dev: Solve the whole task with the least new code (7-rung ladder); mark shortcuts with `shortcut: <limit>, <upgrade>`.
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
- ## Core Rules
19
- 1. **Clean POM Architecture:** No raw selectors (XPath/CSS) in test scripts. All selectors belong in Page Classes extending BasePage.
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. **Lean Senior Dev:** The best code is the code never written. Descend the 7-rung ladder; mark shortcuts with `shortcut: <limit>, <upgrade>`.
22
- 4. **Smart Wait:** Prohibit static delays (`Thread.sleep`). Use dynamic smart waits.
23
- 5. **Idempotent Test Data:** Prefix with `AUTO_` and dynamic timestamps; teardown after creation.
24
- 6. **Bilingual Discipline:** Converse in Vietnamese; write code and git commits strictly in English.
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
- - Communicate with the user in Vietnamese; avoid unnecessary technical jargon overload ("don't be too tech"). All code, tests, and docs stay in English.
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
- - Zero fake passes and zero swallowed exceptions.
26
- - Run Definition of Done verification: python tools/verify_all.py
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.
@@ -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 by 95%, extracting only actionable exceptions, failing lines, and file pointers to prevent token degradation.
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
package/tools/__init__.py CHANGED
@@ -17,7 +17,7 @@ Domain Packages:
17
17
  - tools.mcp: Model Context Protocol servers (core QA and Excel manipulation).
18
18
  """
19
19
 
20
- __version__ = "4.2.0"
20
+ __version__ = "4.2.2"
21
21
  __author__ = "Thế Vị (@TeeVee98)"
22
22
 
23
23
  # Expose domain packages