@teevee98/synapse-hub 4.1.3 → 4.2.0

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 (206) hide show
  1. package/.agents/rules/git-push-protocol.md +2 -2
  2. package/.agents/skills/01-web-automation/auth-session-and-cookie-manager/SKILL.md +6 -1
  3. package/.agents/skills/01-web-automation/bats-testing-patterns/SKILL.md +6 -1
  4. package/.agents/skills/01-web-automation/clean-pom-crafter/SKILL.md +8 -3
  5. package/.agents/skills/01-web-automation/clean-pom-crafter/examples/standard_test_case.groovy +3 -0
  6. package/.agents/skills/01-web-automation/clean-pom-crafter/references/pom_patterns.groovy +3 -0
  7. package/.agents/skills/01-web-automation/e2e-testing-patterns/SKILL.md +6 -1
  8. package/.agents/skills/01-web-automation/e2e-testing-patterns/examples/playwright_sharded_config.ts +3 -0
  9. package/.agents/skills/01-web-automation/katalon-cli-runner/SKILL.md +6 -1
  10. package/.agents/skills/01-web-automation/lam-script-generator/SKILL.md +6 -1
  11. package/.agents/skills/01-web-automation/mobile-appium-som/SKILL.md +6 -1
  12. package/.agents/skills/01-web-automation/mobile-appium-som/examples/BaseScreen.java +2 -2
  13. package/.agents/skills/01-web-automation/mobile-appium-som/examples/LoginScreen.java +2 -2
  14. package/.agents/skills/01-web-automation/mobile-appium-som/examples/TC_MobileLogin.java +2 -2
  15. package/.agents/skills/01-web-automation/playwright-live-interaction/SKILL.md +7 -2
  16. package/.agents/skills/01-web-automation/playwright-webapp-testing/SKILL.md +6 -1
  17. package/.agents/skills/01-web-automation/playwright-webapp-testing/examples/server_lifecycle_playwright.py +3 -0
  18. package/.agents/skills/01-web-automation/web-agent-gym-benchmarking/SKILL.md +6 -1
  19. package/.agents/skills/02-test-design/architecture-decision-records/SKILL.md +6 -1
  20. package/.agents/skills/02-test-design/gherkin-to-suite/SKILL.md +6 -1
  21. package/.agents/skills/02-test-design/rbt-manual-testing/SKILL.md +6 -1
  22. package/.agents/skills/02-test-design/review-spec/SKILL.md +4 -1
  23. package/.agents/skills/02-test-design/tot-exploratory-testing/SKILL.md +6 -1
  24. package/.agents/skills/03-api-and-contracts/api-network-mocking-interception/SKILL.md +6 -1
  25. package/.agents/skills/03-api-and-contracts/api-spec-to-e2e-matrix/SKILL.md +6 -1
  26. package/.agents/skills/03-api-and-contracts/consumer-driven-contract-testing/SKILL.md +7 -2
  27. package/.agents/skills/04-performance-and-load/backend-load-and-stress-patterns/SKILL.md +7 -2
  28. package/.agents/skills/04-performance-and-load/lean-impact-scoreboard/SKILL.md +4 -1
  29. package/.agents/skills/04-performance-and-load/web-vitals-and-performance-profiler/SKILL.md +6 -1
  30. package/.agents/skills/04-performance-and-load/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +3 -0
  31. package/.agents/skills/05-security-and-compliance/security-dast-sentinel/SKILL.md +6 -1
  32. package/.agents/skills/05-security-and-compliance/security-dast-sentinel/references/dast_recipes.ts +3 -0
  33. package/.agents/skills/05-security-and-compliance/skillspector-security-guard/SKILL.md +6 -1
  34. package/.agents/skills/05-security-and-compliance/wcag-audit-patterns/SKILL.md +6 -1
  35. package/.agents/skills/06-healing-and-resilience/agentless-qa-repair/SKILL.md +6 -1
  36. package/.agents/skills/06-healing-and-resilience/antigravity-test-sentinel/SKILL.md +6 -1
  37. package/.agents/skills/06-healing-and-resilience/failure-autopsy-and-healing/SKILL.md +7 -2
  38. package/.agents/skills/06-healing-and-resilience/flaky-test-sentinel-and-quarantine/SKILL.md +6 -1
  39. package/.agents/skills/06-healing-and-resilience/self-healing-locator/SKILL.md +6 -1
  40. package/.agents/skills/06-healing-and-resilience/systematic-debugging/SKILL.md +6 -1
  41. package/.agents/skills/06-healing-and-resilience/test-driven-development/SKILL.md +6 -1
  42. package/.agents/skills/06-healing-and-resilience/verification-before-completion/SKILL.md +6 -1
  43. package/.agents/skills/06-healing-and-resilience/visual-regression-sentinel/SKILL.md +6 -1
  44. package/.agents/skills/07-data-and-state/db-state-verifier-and-seeder/SKILL.md +6 -1
  45. package/.agents/skills/07-data-and-state/file-and-report-validator/SKILL.md +6 -1
  46. package/.agents/skills/07-data-and-state/synthetic-test-data-generator/SKILL.md +6 -1
  47. package/.agents/skills/08-code-quality/code-refactoring-refactor-clean/SKILL.md +6 -1
  48. package/.agents/skills/08-code-quality/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +3 -0
  49. package/.agents/skills/08-code-quality/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +3 -0
  50. package/.agents/skills/08-code-quality/graphify-impact-analyzer/SKILL.md +6 -1
  51. package/.agents/skills/08-code-quality/lean-code-ladder/SKILL.md +6 -1
  52. package/.agents/skills/08-code-quality/repo-quality-audit/SKILL.md +4 -1
  53. package/.agents/skills/08-code-quality/senior-code-review/SKILL.md +4 -1
  54. package/.agents/skills/08-code-quality/surgical-coding-principles/SKILL.md +6 -1
  55. package/.agents/skills/08-code-quality/technical-debt-harvester/SKILL.md +4 -1
  56. package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +6 -1
  57. package/.agents/skills/10-agent-orchestration/actor-qa-swarm/SKILL.md +6 -1
  58. package/.agents/skills/10-agent-orchestration/agent-orchestration-multi-agent-optimize/SKILL.md +6 -1
  59. package/.agents/skills/10-agent-orchestration/event-stream-qa-orchestrator/SKILL.md +6 -1
  60. package/.agents/skills/10-agent-orchestration/persistent-planning-files/SKILL.md +6 -1
  61. package/.agents/skills/10-agent-orchestration/qa-memory-os/SKILL.md +6 -1
  62. package/.agents/skills/11-ai-and-prompting/meta-prompt-crafter/SKILL.md +6 -1
  63. package/.agents/skills/11-ai-and-prompting/mipro-prompt-compiler/SKILL.md +6 -1
  64. package/.agents/skills/11-ai-and-prompting/qa-aci-interface/SKILL.md +6 -1
  65. package/.agents/skills/11-ai-and-prompting/qa-aci-interface/examples/surgical_code_window_walkthrough.md +1 -1
  66. package/.agents/skills/11-ai-and-prompting/token-and-context-optimizer/SKILL.md +6 -1
  67. package/AGENTS.md +7 -1
  68. package/LICENSE +5 -5
  69. package/NOTICE +1 -1
  70. package/README.en.md +4 -4
  71. package/README.md +4 -4
  72. package/agentskills.json +1 -1
  73. package/docs/ARCHITECTURE.en.md +2 -2
  74. package/docs/ARCHITECTURE.md +11 -2
  75. package/docs/CLI_REFERENCE.en.md +6 -4
  76. package/docs/CLI_REFERENCE.md +1 -1
  77. package/docs/CONTRIBUTING.en.md +1 -1
  78. package/docs/CONTRIBUTING.md +2 -2
  79. package/docs/PERFORMANCE_AUDIT_REPORT.md +2 -2
  80. package/docs/TOOL_CATALOG.md +6 -2
  81. package/docs/research/agent_skill_training_analysis.md +1 -1
  82. package/package.json +1 -1
  83. package/plugin.json +1 -1
  84. package/scripts/generate_skill_examples.py +3 -0
  85. package/scripts/package_dist.py +3 -0
  86. package/skills_manifest.json +320 -55
  87. package/synapse.config.json +1 -1
  88. package/templates/ui/index.html +2 -2
  89. package/tools/.infer_baseline.json +3 -796
  90. package/tools/TOOL_CATALOG.json +63 -3
  91. package/tools/__init__.py +4 -1
  92. package/tools/agent_canary.py +3 -0
  93. package/tools/analyze_project.py +3 -0
  94. package/tools/api_drift_sentinel.py +3 -0
  95. package/tools/api_fuzzer.py +182 -118
  96. package/tools/ast_cache.py +4 -2
  97. package/tools/author_integrity.py +174 -12
  98. package/tools/auto_heal.py +7 -2
  99. package/tools/autogen_qa_broker.py +14 -15
  100. package/tools/benchmark_swarm_context.py +119 -18
  101. package/tools/break_ui_generator.py +233 -0
  102. package/tools/browser_helpers.js +2 -2
  103. package/tools/bug_reporter.py +3 -0
  104. package/tools/build_consolidated_report.py +3 -0
  105. package/tools/bump_version.py +4 -1
  106. package/tools/cache_resolver.py +7 -3
  107. package/tools/check_env.py +3 -0
  108. package/tools/check_version_sync.py +21 -50
  109. package/tools/ci_healing_hook.py +3 -0
  110. package/tools/cli.py +116 -22
  111. package/tools/config_decoupler.py +3 -0
  112. package/tools/core/__init__.py +3 -0
  113. package/tools/core/bm25_retriever.py +218 -0
  114. package/tools/core/file_lock.py +23 -14
  115. package/tools/core/i18n.py +13 -11
  116. package/tools/core/memory_bus.py +6 -3
  117. package/tools/core/process_supervisor.py +28 -18
  118. package/tools/core/provider_usage_adapter.py +317 -0
  119. package/tools/core/token_estimator.py +83 -18
  120. package/tools/count_tokens.py +16 -7
  121. package/tools/coverage_reporter.py +245 -0
  122. package/tools/create_mock_docx.py +3 -0
  123. package/tools/dashboard_generator.py +17 -15
  124. package/tools/db_sandbox.py +150 -5
  125. package/tools/debt_harvester.py +2 -2
  126. package/tools/diagram_architect.py +3 -0
  127. package/tools/distill_log.py +22 -2
  128. package/tools/distill_skill.py +191 -0
  129. package/tools/e2e_flow_prober.py +3 -0
  130. package/tools/export_postman_collection.py +3 -0
  131. package/tools/flaky_detector.py +3 -0
  132. package/tools/fsm_enforcer.py +2 -2
  133. package/tools/fuzz_payloads.py +3 -0
  134. package/tools/generate_allure_report.py +3 -0
  135. package/tools/generate_api_matrix.py +3 -0
  136. package/tools/generate_jmx_plan.py +3 -0
  137. package/tools/generate_tc_from_story.py +3 -0
  138. package/tools/generate_test_reports.py +3 -0
  139. package/tools/git_pre_commit_guard.py +25 -3
  140. package/tools/git_worktree_manager.py +3 -0
  141. package/tools/heal/__init__.py +3 -0
  142. package/tools/heal_pr_automator.py +3 -0
  143. package/tools/heuristic_locator_matcher.py +3 -0
  144. package/tools/hub_publisher.py +3 -3
  145. package/tools/humanize_linter.py +3 -0
  146. package/tools/infer_linter.py +19 -9
  147. package/tools/init_config.py +6 -9
  148. package/tools/jtl_analyzer.py +3 -0
  149. package/tools/lint/__init__.py +3 -0
  150. package/tools/lint_ai_docs.py +3 -0
  151. package/tools/lookup_tc.py +3 -0
  152. package/tools/lookup_xpath.py +3 -0
  153. package/tools/matrix_sharder.py +3 -0
  154. package/tools/mcp/__init__.py +3 -0
  155. package/tools/mcp_docx_server.py +1 -1
  156. package/tools/mcp_excel_server.py +4 -1
  157. package/tools/mcp_server.py +78 -15
  158. package/tools/md_to_xlsx.py +3 -0
  159. package/tools/mechanical_ui_gate.py +3 -0
  160. package/tools/micro_mutator.py +93 -19
  161. package/tools/network_mock_shield.py +3 -0
  162. package/tools/newman_analyzer.py +3 -0
  163. package/tools/omni_emitter.py +3 -0
  164. package/tools/omni_parser.py +3 -0
  165. package/tools/omni_transpiler.py +3 -0
  166. package/tools/output_formatter.py +3 -0
  167. package/tools/package_release.py +6 -6
  168. package/tools/pairwise_generator.py +3 -0
  169. package/tools/pentest_scope_guard.py +401 -58
  170. package/tools/perf/__init__.py +3 -0
  171. package/tools/perf/benchmark_perf_runner.py +42 -0
  172. package/tools/pinpoint_failure.py +3 -0
  173. package/tools/project_state.py +3 -0
  174. package/tools/repo_map.py +3 -0
  175. package/tools/report/__init__.py +3 -0
  176. package/tools/rules_router.py +426 -34
  177. package/tools/runaway_stopper.py +3 -0
  178. package/tools/safety_firewall.py +3 -0
  179. package/tools/security_scanner.py +80 -0
  180. package/tools/senior_code_review.py +14 -0
  181. package/tools/setup_project.py +9 -4
  182. package/tools/skill_canonical_digest.py +244 -0
  183. package/tools/skill_collision_guard.py +2 -2
  184. package/tools/skill_profiles.py +77 -7
  185. package/tools/skillspector.py +2 -1
  186. package/tools/slide_deck_exporter.py +477 -0
  187. package/tools/smart_visual_masker.py +3 -0
  188. package/tools/sync_skills_manifest.py +166 -0
  189. package/tools/task_memory_manager.py +260 -0
  190. package/tools/telemetry_correlator.py +3 -0
  191. package/tools/template_excel_exporter.py +2 -2
  192. package/tools/test_impact.py +3 -0
  193. package/tools/trace_data_flow.py +3 -0
  194. package/tools/traffic_session_converter.py +3 -0
  195. package/tools/ui_server.py +2 -2
  196. package/tools/universal_ir.py +3 -0
  197. package/tools/update_sentinel.py +15 -9
  198. package/tools/validate_groovy_scripts.py +3 -0
  199. package/tools/validate_host_interop.py +485 -0
  200. package/tools/validate_skills_schema.py +282 -0
  201. package/tools/verify_all.py +600 -63
  202. package/tools/visual_diff_canvas.py +3 -0
  203. package/tools/visual_som_helper.py +3 -0
  204. package/tools/watch_mode.py +4 -4
  205. package/tools/wcag_audit.py +3 -0
  206. package/tools/welcome_page.py +2 -2
@@ -28,6 +28,6 @@ When working inside the Hub repository and the user requests *"push lên"*, *"pu
28
28
  - `major`: Breaking changes, major architectural redesigns (`X.0.0`).
29
29
  - **5-Step Autonomous Release Pipeline:**
30
30
  ```bash
31
- python tools/hub_publisher.py
31
+ python tools/hub_publisher.py -y
32
32
  ```
33
- *(Executes: 1. Push to main -> 2. Create & push tag vX.Y.Z -> 3. Create GitHub Release via API -> 4. Build GitHub Package -> 5. Publish & verify NPM registry).*
33
+ *(Executes: 1. Push to main -> 2. Create & push tag vX.Y.Z -> 3. Create GitHub Release via API -> 4. Build GitHub Package -> 5. Publish & verify NPM registry. Use `-y` to confirm non-interactively without stalling).*
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: auth-session-and-cookie-manager
3
3
  description: "Manage browser authentication sessions, storageState, JWT tokens, and multi-role state. Use when managing login sessions, storage state, or cookie reuse across tests."
4
+ category: test_automation_and_execution
5
+ version: "2.0.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Auth Session & Cookie Manager Skill
7
12
 
8
13
  > **Target:** Eliminate repetitive, slow UI login forms by saving, refreshing, and injecting browser storage states, cookies, and JWT bearer tokens directly into execution contexts.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: bats-testing-patterns
3
3
  description: "Test bash/sh scripts, CLI tools, and CI/CD pipelines with Bats. Use when writing Bash automation tests with the BATS framework."
4
+ category: test_automation_and_execution
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Bats Testing Patterns (Bash Automated Testing System)
7
12
 
8
13
  Comprehensive test engineering standard for validating shell scripts, CI/CD scripts (`.sh`), CLI wrappers, and DevOps automation using Bats-core.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: clean-pom-crafter
3
3
  description: "Build and refactor Clean POM Page Classes adhering to Flat Architecture standards. Use when designing Clean POM page classes or enforcing zero-locator discipline in scripts."
4
+ category: test_automation_and_execution
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Clean POM Crafter — Enterprise Clean POM Architecture Standards
7
12
 
8
13
  Specialized skill for creating, refactoring, and standardizing test automation scripts using **Clean Page Object Model (POM)** and **Flat Architecture** across enterprise test suites.
@@ -72,8 +77,8 @@ All Page Classes **MUST** follow this strict locator hierarchy:
72
77
 
73
78
  - [**Standard Clean POM Methods (`pom_patterns.groovy`)**](references/pom_patterns.groovy): Full implementation of `searchRecord`, `editRecord`, `deleteRecord`, `setCalendarDate`, `selectMultiOptions`, `verifyRecordExists`, `verifyRecordNotExists`, `jsSetInput`.
74
79
  - [**Standard Test Script Template (`standard_test_case.groovy`)**](examples/standard_test_case.groovy): 7-step complete script template from Login -> Create -> Search -> Edit -> Delete.
75
- - [**Zero-Token XPath Lookup (`tools/lookup_xpath.py`)**](../../../tools/lookup_xpath.py): Command `python tools/lookup_xpath.py <PageClass>` returns exact locators in <200 tokens without parsing full files.
76
- - [**Browser Runtime Helper (`tools/browser_helpers.js`)**](../../../tools/browser_helpers.js): In-browser validation engine for form audits, safe clicks, and batch verification.
80
+ - [**Zero-Token XPath Lookup (`tools/lookup_xpath.py`)**](../../../../tools/lookup_xpath.py): Command `python tools/lookup_xpath.py <PageClass>` returns exact locators in <200 tokens without parsing full files.
81
+ - [**Browser Runtime Helper (`tools/browser_helpers.js`)**](../../../../tools/browser_helpers.js): In-browser validation engine for form audits, safe clicks, and batch verification.
77
82
 
78
83
  ---
79
84
 
@@ -1,3 +1,6 @@
1
+ // SPDX-FileCopyrightText: © 2026 Thế Vị (@TeeVee98) <https://github.com/TeeVee98/Synapse-Hub>
2
+ // SPDX-License-Identifier: MIT
3
+
1
4
  import com.enterprise.pages.BasePage
2
5
  import com.enterprise.pages.LoginPage
3
6
  import com.enterprise.pages.DataMiningPage
@@ -1,3 +1,6 @@
1
+ // SPDX-FileCopyrightText: © 2026 Thế Vị (@TeeVee98) <https://github.com/TeeVee98/Synapse-Hub>
2
+ // SPDX-License-Identifier: MIT
3
+
1
4
  package com.enterprise.pages
2
5
 
3
6
  import org.openqa.selenium.By
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: e2e-testing-patterns
3
3
  description: "Design robust multi-browser E2E test architectures, parallel sharding, and retry governance. Use when designing end-to-end test suites for web applications."
4
+ category: test_automation_and_execution
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # E2E Testing Architectural Patterns
7
12
 
8
13
  Engineering standard for structuring, scaling, and maintaining large-scale End-to-End (E2E) test automation suites across modern web frameworks (React, Angular, Vue, Next.js).
@@ -1,3 +1,6 @@
1
+ // SPDX-FileCopyrightText: © 2026 Thế Vị (@TeeVee98) <https://github.com/TeeVee98/Synapse-Hub>
2
+ // SPDX-License-Identifier: MIT
3
+
1
4
  import { defineConfig, devices } from '@playwright/test';
2
5
 
3
6
  export default defineConfig({
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: katalon-cli-runner
3
3
  description: "Execute headless Katalon and Gradle test runners with automatic driver cleanup. Use when running Katalon suites headless or integrating KRE into CI/CD."
4
+ category: test_automation_and_execution
5
+ version: "2.0.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Katalon CLI & Enterprise Runner — Dual-Mode Execution Management
7
12
 
8
13
  Specialized skill for managing, dispatching, and monitoring enterprise Katalon test runs across different licensing states (**Licensed Headless KRE** vs **Free Community Mode**), integrated with Allure reporting and automated driver cleanup.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: lam-script-generator
3
3
  description: "Transform user stories and acceptance criteria into Clean POM automation scripts. Use when the user provides a user story, acceptance criteria, or requirement document that must become a runnable script."
4
+ category: test_automation_and_execution
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # LAM Script Generator — Large Action Model for Test Automation
7
12
 
8
13
  Inspired by the **LaVague AI Web Agent & Large Action Model (LAM)** framework, this skill bridges the gap between natural language requirements (User Stories, Acceptance Criteria) and durable, deterministic automation code conforming to Clean POM Flat Architecture.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: mobile-appium-som
3
3
  description: "Enterprise Screen Object Model (SOM) and Appium mobile automation standards for iOS and Android. Use when authoring, refactoring, or executing native or hybrid mobile tests with Appium, UIAutomator2, or XCUITest."
4
+ category: test_automation_and_execution
5
+ version: "1.0.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Mobile Appium Screen Object Model (SOM) — Enterprise Architecture Standards
7
12
 
8
13
  Specialized skill for creating, refactoring, and maintaining enterprise mobile automation test suites across **Android (UIAutomator2)** and **iOS (XCUITest)** using the **Screen Object Model (SOM)** and Clean Architecture.
@@ -1,6 +1,6 @@
1
- // SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
1
+ // SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
2
2
  // SPDX-License-Identifier: MIT
3
- // Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
3
+ // Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
4
4
 
5
5
  package com.synapse.mobile.pages;
6
6
 
@@ -1,6 +1,6 @@
1
- // SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
1
+ // SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
2
2
  // SPDX-License-Identifier: MIT
3
- // Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
3
+ // Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
4
4
 
5
5
  package com.synapse.mobile.pages;
6
6
 
@@ -1,6 +1,6 @@
1
- // SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
1
+ // SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
2
2
  // SPDX-License-Identifier: MIT
3
- // Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
3
+ // Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
4
4
 
5
5
  package com.synapse.mobile.tests;
6
6
 
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: playwright-live-interaction
3
3
  description: "Probe live web DOM/AOM and verify selectors under 200ms using headless Playwright. Use when probing live DOM/AOM, verifying selectors, or debugging a live browser session."
4
+ category: test_automation_and_execution
5
+ version: "2.0.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Playwright Live Interaction & Fast Debugging Handbook (Enterprise Web & Clean POM)
7
12
 
8
13
  Direct in-browser interaction and rapid debugging via **Playwright MCP Tools** (`browser_run_code_unsafe` / `call_mcp_tool`), executing live JavaScript/Playwright commands without rebuilding or restarting test runs.
@@ -78,7 +83,7 @@ Mandatory 5-point verification before committing POM code:
78
83
  ## 5. Reference Documentation (Progressive Disclosure)
79
84
 
80
85
  - [**20 Complete UI Recipes**](references/recipes.md): Code recipes for Auth, Data Tables, Dropdowns, Modals, Confirm Dialogs, File Upload, Calendar, MultiSelect, Stale Retries, Form Audit, Smart Action Batching, and Self-Healing Locators.
81
- - [**Runtime Browser Helper (`tools/browser_helpers.js`)**](../../../tools/browser_helpers.js): Unified JavaScript module providing `window.__qa` (`batch`, `audit`, `heal`, `clickSafe`, `exportSession`).
86
+ - [**Runtime Browser Helper (`tools/browser_helpers.js`)**](../../../../tools/browser_helpers.js): Unified JavaScript module providing `window.__qa` (`batch`, `audit`, `heal`, `clickSafe`, `exportSession`).
82
87
  - [**5 Superpowers & 5 AI Paradigms**](references/advanced_superpowers.md): Zero-Second Auth (`session.json`), Direct API Seeding, AOM Snapshots, Multi-Context Dual Role, Route Mocking, Self-Healing Locators, Fuzzing, CDP Profiling.
83
88
  - [**Multi-Agent Swarm Orchestration**](references/swarm_orchestration.md): Specialized swarm roles and collaboration protocol.
84
89
 
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: playwright-webapp-testing
3
3
  description: "Drive Playwright test runs against a local web application with a managed server lifecycle: start, wait for readiness, run automation, and guarantee teardown. Use when verifying frontend functionality or debugging UI behavior of a dynamic webapp that must be started before testing."
4
+ category: test_automation_and_execution
5
+ version: "1.0.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Playwright Webapp Testing — Enterprise Server-Lifecycle Standard
7
12
 
8
13
  Specialized skill for testing local dynamic web applications with Playwright under Synapse Hub rules: managed server lifecycle, smart waits instead of static sleeps, and the 3-Stage Live Protocol for selector discovery.
@@ -1,3 +1,6 @@
1
+ # SPDX-FileCopyrightText: © 2026 Thế Vị (@TeeVee98) <https://github.com/TeeVee98/Synapse-Hub>
2
+ # SPDX-License-Identifier: MIT
3
+
1
4
  """Example: managed server lifecycle + minimal Playwright automation.
2
5
 
3
6
  Hub baseline: headless chromium, 1920x1080 viewport, networkidle wait,
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: web-agent-gym-benchmarking
3
3
  description: "Empirical benchmark harness evaluating web agents and Page Classes against standardized enterprise tasks with headless <200ms latency budgets and ground-truth DB state verification. Use when benchmarking web agents or certifying Page Classes."
4
+ category: test_automation_and_execution
5
+ version: "1.0.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Web Agent Gym Benchmarking Skill — Empirical Interaction & PageClass Certification
7
12
 
8
13
  > **Paradigm Attribution:** Inspired by **ServiceNow Research BrowserGym & CMU WebArena**.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: architecture-decision-records
3
3
  description: "Record, structure, and maintain technical Architecture Decision Records (ADRs). Use when documenting significant architecture decisions as ADRs."
4
+ category: architecture_and_analysis
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Architecture Decision Records (ADR) Skill
7
12
 
8
13
  > **Target:** Standardize technical decision logs, architectural trade-offs, and design rationale across enterprise testing platforms.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: gherkin-to-suite
3
3
  description: "Compile Gherkin .feature files into an expanded test matrix, hub Universal IR and a proven-vs-owed coverage-gap report with zero LLM tokens. Use when the user supplies BDD .feature specs or wants a BDD suite audited before codification."
4
+ category: test_automation_and_execution
5
+ version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Gherkin to Suite Compiler — Natural-Language Test Ingestion (0-Token)
7
12
 
8
13
  This skill turns business-readable Gherkin `.feature` files into deterministic
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: rbt-manual-testing
3
3
  description: "Comprehensive Risk-Based Testing (AI-RBT) 6-stage manual test case generation, Ambiguity Q&A analysis, Traceability Matrix, Field-Level Validation Checklist (15 input field types), Non-Functional scenarios (Double-Submit, Race Conditions), and Excel export formatting. Use when generating risk-based manual test cases and exploratory charters."
4
+ category: test_automation_and_execution
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # RBT Manual Testing (AI-Driven Risk-Based Testing Engine)
7
12
 
8
13
  ## 1. Overview & Capabilities
@@ -3,8 +3,11 @@ name: review-spec
3
3
  description: "Stress-test specifications, user stories, and BDD feature files with zero-context rigor. Use when reviewing requirements, user stories, or acceptance criteria before code generation."
4
4
  category: architecture_and_analysis
5
5
  version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: read-only
6
10
  ---
7
-
8
11
  # Review Spec — Zero-Context Specification Stress-Tester
9
12
 
10
13
  Review test specifications, User Stories, and BDD `.feature` files with stateless, zero-context rigor (Elephant-Goldfish Model) before generating code.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: tot-exploratory-testing
3
3
  description: "Non-linear Tree/Graph-of-Thoughts exploratory testing engine exploring Happy Path, Boundary/Race, and Negative/Chaos branches with Beam Search risk scoring and multi-hypothesis RCA. Use when decomposing complex user stories into exploratory test trees or triaging complex failures."
4
+ category: test_automation_and_execution
5
+ version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: read-only
4
10
  ---
5
-
6
11
  # Tree-of-Thoughts Exploratory Testing Skill — Deliberative QA Reasoning
7
12
 
8
13
  > **Paradigm Attribution:** Inspired by **Princeton NLP Tree-of-Thoughts (ToT) & ETH Zürich Graph-of-Thoughts (GoT)**.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: api-network-mocking-interception
3
3
  description: "Intercept HTTP/GraphQL traffic, stub routes, and simulate chaos network failures. Use when stubbing, mocking, or intercepting network calls during UI or API tests."
4
+ category: verification_and_resilience
5
+ version: "2.0.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # API Network Mocking, Interception & Resilience Skill
7
12
 
8
13
  > **Target:** Eliminate flaky tests caused by backend dependencies, slow microservices, or inconsistent staging data by intercepting browser-level network requests, and verify frontend resilience against network faults and degradations.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: api-spec-to-e2e-matrix
3
3
  description: "Generate automated positive, boundary, and negative test matrices from OpenAPI specifications. Use when converting an OpenAPI/Swagger spec into an end-to-end test matrix."
4
+ category: architecture_and_analysis
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # API Spec to E2E Matrix — Contract-Based Test Generator
7
12
 
8
13
  This skill converts OpenAPI / Swagger specifications, JSON Schemas, or REST endpoint contracts into a structured, executable End-to-End (E2E) testing matrix covering happy path, boundary values, and negative error scenarios.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: consumer-driven-contract-testing
3
- description: "Standardize Consumer-Driven Contract (CDC) testing with Pact and OpenAPI Bidirectional Contract Testing. Detect and prevent breaking schema changes, payload drift, and microservice integration failures."
3
+ description: "Standardize Consumer-Driven Contract (CDC) testing with Pact and OpenAPI Bidirectional Contract Testing. Detect and prevent breaking schema changes, payload drift, and microservice integration failures. Use when implementing contract testing, verifying CDC providers, or preventing breaking API schema changes."
4
+ category: verification_and_resilience
5
+ version: "3.2.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Consumer-Driven Contract (CDC) Testing — Schema Drift & Integration Sentinel
7
12
 
8
13
  > **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
@@ -1,12 +1,17 @@
1
1
  ---
2
2
  name: backend-load-and-stress-patterns
3
3
  description: "Orchestrate k6, Locust, and JMeter backend load, stress, and SLA endurance test suites. Use when designing load, stress, or spike test patterns for backend systems."
4
+ category: test_automation_and_execution
5
+ version: "1.0.0"
6
+ policies:
7
+ network: sandbox-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Backend Load & Performance Testing Skill
7
12
 
8
13
  > **Target:** Model concurrent Virtual User (VU) and arrival-rate traffic, execute stress/soak test profiles, and enforce automated SLA gates (P95/P99 latency, error rate < 1.0%) to detect bottlenecks before production.
9
- > **Mandatory Rule:** Adhere strictly to [performance_testing_rules.md](../../rules/performance_testing_rules.md) for safety approvals, hard caps, and truth-anchor reporting.
14
+ > **Mandatory Rule:** Adhere strictly to [performance_testing_rules.md](../../../rules/performance_testing_rules.md) for safety approvals, hard caps, and truth-anchor reporting.
10
15
 
11
16
  ---
12
17
 
@@ -3,8 +3,11 @@ name: lean-impact-scoreboard
3
3
  description: "Display empirical impact scoreboards (code reduction, token savings, mutation rigor). Use when reviewing lean engineering benchmarks, token throughput, or reporting quality metrics."
4
4
  category: architecture_and_analysis
5
5
  version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: read-only
6
10
  ---
7
-
8
11
  # Lean Impact Scoreboard — Verified Efficiency & Token Benchmarks
9
12
 
10
13
  Displays empirical metrics and benchmarks demonstrating the impact of Lean Engineering (The 7-Rung Ladder, Clean POM, and Verification-First).
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: web-vitals-and-performance-profiler
3
3
  description: "Measure Core Web Vitals (LCP, CLS, INP) and network waterfalls via CDP. Use when the user asks why a page is slow or needs CWV budgets enforced in CI."
4
+ category: architecture_and_analysis
5
+ version: "2.0.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Web Vitals & Performance Profiler Skill
7
12
 
8
13
  > **Target:** Detect user-experience bottlenecks, layout shifts, sluggish API responses, and render-blocking assets automatically during headless test execution.
@@ -1,3 +1,6 @@
1
+ // SPDX-FileCopyrightText: © 2026 Thế Vị (@TeeVee98) <https://github.com/TeeVee98/Synapse-Hub>
2
+ // SPDX-License-Identifier: MIT
3
+
1
4
  /**
2
5
  * Playwright Core Web Vitals (CWV) Profiling Fixture via Chrome DevTools Protocol (CDP)
3
6
  * Measures LCP (Largest Contentful Paint), CLS (Cumulative Layout Shift),
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: security-dast-sentinel
3
3
  description: "Run dynamic security audits: OWASP Top 10, security headers, BOLA/IDOR, and token leakage. Use when running or planning DAST and security scans against a target app."
4
+ category: verification_and_resilience
5
+ version: "1.0.0"
6
+ policies:
7
+ network: sandbox-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Security DAST Sentinel & Enterprise Security Audit Harness
7
12
 
8
13
  > **Purpose:** Automated Dynamic Application Security Testing (DAST), defensive runtime verification, and mathematical security audit orchestration across enterprise web applications, APIs, and AI agent swarms. Bridges functional automated testing with OWASP Top 10 compliance gates and Cloudflare 6-Phase audit rigor.
@@ -1,3 +1,6 @@
1
+ // SPDX-FileCopyrightText: © 2026 Thế Vị (@TeeVee98) <https://github.com/TeeVee98/Synapse-Hub>
2
+ // SPDX-License-Identifier: MIT
3
+
1
4
  /**
2
5
  * DAST Automated Security Test Recipes (Playwright TypeScript)
3
6
  * Includes HTTP Security Headers auditing and BOLA / IDOR cross-tenant defense checks.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: skillspector-security-guard
3
3
  description: "Audit and verify AI agent skills, prompts, and MCP configurations against vulnerability vectors inspired by NVIDIA SkillSpector. Use when auditing skills and plugins for prompt-injection and security threats."
4
+ category: verification_and_resilience
5
+ version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: read-only
9
+ filesystem: read-only
4
10
  ---
5
-
6
11
  # SkillSpector Security Guard — AI Agent & MCP Security Sentinel
7
12
 
8
13
  > **Purpose:** Autonomous security vetting for AI Agent skills, prompt instructions, Model Context Protocol (MCP) servers, and automation tools.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: wcag-audit-patterns
3
3
  description: "Audit WCAG 2.2 accessibility (A/AA), keyboard navigation, and ARIA roles. Use when auditing accessibility against WCAG 2.2 A/AA criteria."
4
+ category: architecture_and_analysis
5
+ version: "2.0.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: read-only
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # WCAG 2.2 Accessibility Audit Patterns
7
12
 
8
13
  Engineering standards for automated, continuous Web Content Accessibility Guidelines (WCAG 2.2 Level A and AA) auditing across enterprise web applications.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: agentless-qa-repair
3
3
  description: "Repair broken test scripts and Page Classes using an Agentless 3-phase flow: localization, candidate synthesis, and minimal diff validation. Use when repairing test failures without multi-agent chat bloat."
4
+ category: verification_and_resilience
5
+ version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Agentless QA Repair Skill — Ultra-Low-Token 3-Phase Failure Healing
7
12
 
8
13
  > **Paradigm Attribution:** Inspired by **UIUC OpenAutoCoder Agentless**.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: antigravity-test-sentinel
3
3
  description: "Enforce verification-first discipline: blocks task completion until tests and quality gates pass. Use when enforcing Definition-of-Done quality gates before completing a code or test task."
4
+ category: verification_and_resilience
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Antigravity Test Sentinel — Verification-First Gatekeeper
7
12
 
8
13
  The **Antigravity Test Sentinel** enforces absolute engineering integrity across test creation, script refactoring, and bug fixes. It acts as an autonomous circuit breaker that physically prohibits the AI Agent from concluding a task without verifiable proof of test execution success.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: failure-autopsy-and-healing
3
3
  description: "Triage test failures from JUnit XML/screenshots and heal broken Page Class locators. Use when diagnosing failed test runs and producing closed-loop healing plans."
4
+ category: verification_and_resilience
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Failure Autopsy & Auto-Healing (Diagnostic & Self-Healing Engine)
7
12
 
8
13
  Specialized skill for diagnosing batch test execution failures across automated test cases, performing visual autopsies via `Screenshots/FAILED_*.png`, parsing `JUnit_Report.xml`, and healing Page Classes (`Keywords/<namespace>/pages/*.groovy` or `pages/*.ts`) in place.
@@ -48,7 +53,7 @@ flowchart LR
48
53
  ## 3. Reference Documentation
49
54
 
50
55
  - [**Diagnostic & Healing Matrix (`healing_matrix.md`)**](references/healing_matrix.md): Concrete code prescriptions for disabled buttons, boundary overlaps, `ElementClickInterceptedException`, `StaleElementReferenceException`, and 4 flaky test root causes.
51
- - [**Fast-Fix Triad & Runtime Helper (`tools/browser_helpers.js`)**](../../../tools/browser_helpers.js): In-browser diagnosis engine via `window.__qa` (`audit`, `heal`, `clickSafe`, `hud`).
56
+ - [**Fast-Fix Triad & Runtime Helper (`tools/browser_helpers.js`)**](../../../../tools/browser_helpers.js): In-browser diagnosis engine via `window.__qa` (`audit`, `heal`, `clickSafe`, `hud`).
52
57
  - **Automated Triage Script:** `python tools/pinpoint_failure.py` and `scripts/triage_failures.sh`.
53
58
 
54
59
  ---
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: flaky-test-sentinel-and-quarantine
3
3
  description: "Detect non-deterministic flaky tests, calculate flakiness scores, and manage quarantine. Use when detecting flaky tests and managing quarantine lifecycles."
4
+ category: verification_and_resilience
5
+ version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Flaky Test Sentinel & Quarantine Protocol
7
12
 
8
13
  > **Purpose:** Master flaky test governance, automated quarantine isolation, and non-deterministic test remediation. Eliminates false-positive CI/CD pipeline blockers by identifying unstable tests through repeated execution ($N=5$), moving them into isolated quarantine suites, and tracking remediation until graduation.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: self-healing-locator
3
3
  description: "Heal broken locators using semantic AOM diffing with Role, Label, and TestId hierarchy. Use when locators break and automated healing strategies are needed."
4
+ category: verification_and_resilience
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Self-Healing Locator Skill — Token-Efficient AOM Diffing
7
12
 
8
13
  This skill provides an automated, token-conservative mechanism to diagnose, diff, and repair broken web element locators across web applications without overwhelming the LLM context window with raw HTML dumps.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: systematic-debugging
3
3
  description: "Investigate root cause through four disciplined phases before proposing any fix for a test failure, bug, or unexpected behavior. Use when a test fails, a defect appears, or a fix attempt has already failed and guessing is tempting."
4
+ category: verification_and_resilience
5
+ version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Systematic Debugging — Enterprise Root-Cause Standard
7
12
 
8
13
  Specialized skill for failure investigation in test automation: always find root cause before attempting fixes. Symptom fixes are failure.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: test-driven-development
3
3
  description: "Enforce the RED-GREEN-REFACTOR cycle: no production or automation code is written before a failing test exists and has been watched failing. Use when implementing new helpers, Page Class logic, bug fixes, or any behavior change in test codebases."
4
+ category: verification_and_resilience
5
+ version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Test-Driven Development — Enterprise Red-Green-Refactor Standard
7
12
 
8
13
  Specialized skill for writing test-automation and tool code test-first: write the test, watch it fail for the right reason, write minimal code to pass, then refactor while staying green.
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: verification-before-completion
3
3
  description: "Require fresh verification evidence — a command run in the current session with its real output — before any claim that work is complete, fixed, or passing. Use when about to report success, commit, open a PR, or close a task."
4
+ category: verification_and_resilience
5
+ version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: read-only
9
+ filesystem: read-only
4
10
  ---
5
-
6
11
  # Verification Before Completion — Enterprise Evidence Protocol
7
12
 
8
13
  Specialized skill for the evidence discipline behind every success claim in the hub: no completion statement exists without fresh verification output. This is the operational form of the Truth Anchor (No Fake Pass) rule in `AGENTS.md` Section 3.