synapse-hub 2.4.3 → 2.6.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 (184) hide show
  1. package/.agents/agents/failure-analyst.md +13 -0
  2. package/.agents/agents/orchestrator.md +5 -2
  3. package/.agents/agents/pom-crafter.md +13 -0
  4. package/.agents/agents/quality-gatekeeper.md +21 -2
  5. package/.agents/agents/test-runner.md +11 -0
  6. package/.agents/rules/context-engineering.md +22 -102
  7. package/.agents/rules/mobile_appium_rules.md +19 -115
  8. package/.agents/rules/performance_testing_rules.md +18 -62
  9. package/.agents/rules/skill-precedence.md +24 -24
  10. package/.agents/rules/systematic-debugging.md +10 -27
  11. package/.agents/skills/lean-code-ladder/SKILL.md +12 -1
  12. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  13. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  14. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  15. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  16. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  17. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  18. package/.agents/skills/senior-code-review/SKILL.md +90 -0
  19. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  20. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  21. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  22. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  23. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  24. package/.cursor/rules/synapse-qa.mdc +4 -3
  25. package/.cursorrules +1 -0
  26. package/.windsurfrules +1 -0
  27. package/AGENTS.md +57 -180
  28. package/CLAUDE.md +5 -0
  29. package/NOTICE +40 -4
  30. package/README.en.md +33 -13
  31. package/README.md +36 -16
  32. package/bin/agent-qa.js +3 -2
  33. package/docs/ARCHITECTURE.md +39 -11
  34. package/docs/CLI_REFERENCE.md +15 -1
  35. package/docs/adopted-ecosystem-tools.md +9 -0
  36. package/docs/research/agent_skill_training_analysis.md +1357 -0
  37. package/package.json +1 -3
  38. package/skills_manifest.json +39 -3
  39. package/synapse.config.json +3 -2
  40. package/templates/ai_bridges/CLAUDE.md +5 -0
  41. package/templates/ai_bridges/copilot-instructions.md +2 -0
  42. package/templates/ai_bridges/cursor_synapse_qa.mdc +4 -3
  43. package/templates/ai_bridges/windsurfrules +1 -0
  44. package/templates/welcome.html.tmpl +34 -25
  45. package/tools/.infer_baseline.json +7 -1079
  46. package/tools/TOOLS_RUNBOOK.md +182 -13
  47. package/tools/__init__.py +1 -1
  48. package/tools/agent_canary.py +4 -4
  49. package/tools/analyze_project.py +2 -2
  50. package/tools/api_fuzzer.py +4 -4
  51. package/tools/auto_heal.py +14 -2
  52. package/tools/auto_heal_reflexion.py +172 -0
  53. package/tools/browser_helpers.js +57 -2
  54. package/tools/bump_version.py +30 -2
  55. package/tools/cache_resolver.py +6 -6
  56. package/tools/check_env.py +13 -7
  57. package/tools/cli.py +265 -197
  58. package/tools/count_tokens.py +7 -7
  59. package/tools/dashboard_generator.py +39 -23
  60. package/tools/db_sandbox.py +5 -5
  61. package/tools/debt_harvester.py +236 -0
  62. package/tools/distill_log.py +2 -2
  63. package/tools/dspy_qa_signatures.py +357 -0
  64. package/tools/flaky_detector.py +5 -5
  65. package/tools/generate_tc_from_story.py +2 -2
  66. package/tools/generate_test_reports.py +4 -4
  67. package/tools/git_pre_commit_guard.py +6 -6
  68. package/tools/infer_linter.py +12 -7
  69. package/tools/interview_story.py +117 -0
  70. package/tools/lint_ai_docs.py +3 -3
  71. package/tools/matrix_sharder.py +4 -4
  72. package/tools/mcp_excel_server.py +1 -1
  73. package/tools/mcp_server.py +3 -3
  74. package/tools/micro_mutator.py +6 -6
  75. package/tools/omni_transpiler.py +2 -2
  76. package/tools/output_formatter.py +37 -2
  77. package/tools/pinpoint_failure.py +4 -1
  78. package/tools/repo_map.py +2 -2
  79. package/tools/reversible_sandbox.py +157 -0
  80. package/tools/safety_firewall.py +30 -2
  81. package/tools/senior_code_review.py +341 -0
  82. package/tools/setup_project.py +9 -9
  83. package/tools/skill_collision_guard.py +231 -0
  84. package/tools/skill_vault.py +343 -0
  85. package/tools/skillspector.py +2 -2
  86. package/tools/synapse_qa_bench.py +190 -0
  87. package/tools/sync_agent_rules.py +14 -3
  88. package/tools/test_impact.py +4 -4
  89. package/tools/textgrad_mutation_optimizer.py +234 -0
  90. package/tools/tms_sync_bridge.py +2 -2
  91. package/tools/update_sentinel.py +17 -17
  92. package/tools/verify_all.py +47 -16
  93. package/tools/visual_som_helper.py +8 -8
  94. package/tools/watch_mode.py +7 -8
  95. package/tools/wcag_audit.py +5 -1
  96. package/tools/welcome_page.py +12 -12
  97. package/benchmarks/qa_eval/README.md +0 -71
  98. package/benchmarks/qa_eval/build_dataset.py +0 -677
  99. package/benchmarks/qa_eval/dataset/api_contract_drift/qa-challenge-06_api_contract_drift.json +0 -22
  100. package/benchmarks/qa_eval/dataset/api_contract_drift/qa-challenge-07_api_contract_drift.json +0 -22
  101. package/benchmarks/qa_eval/dataset/api_contract_drift/qa-challenge-08_api_contract_drift.json +0 -22
  102. package/benchmarks/qa_eval/dataset/api_contract_drift/qa-challenge-09_api_contract_drift.json +0 -22
  103. package/benchmarks/qa_eval/dataset/api_contract_drift/qa-challenge-10_api_contract_drift.json +0 -22
  104. package/benchmarks/qa_eval/dataset/fake_pass_tautology/qa-challenge-21_fake_pass_tautology.json +0 -21
  105. package/benchmarks/qa_eval/dataset/fake_pass_tautology/qa-challenge-22_fake_pass_tautology.json +0 -21
  106. package/benchmarks/qa_eval/dataset/fake_pass_tautology/qa-challenge-23_fake_pass_tautology.json +0 -21
  107. package/benchmarks/qa_eval/dataset/fake_pass_tautology/qa-challenge-24_fake_pass_tautology.json +0 -21
  108. package/benchmarks/qa_eval/dataset/fake_pass_tautology/qa-challenge-25_fake_pass_tautology.json +0 -21
  109. package/benchmarks/qa_eval/dataset/locator_drift/qa-challenge-01_locator_drift.json +0 -23
  110. package/benchmarks/qa_eval/dataset/locator_drift/qa-challenge-02_locator_drift.json +0 -23
  111. package/benchmarks/qa_eval/dataset/locator_drift/qa-challenge-03_locator_drift.json +0 -23
  112. package/benchmarks/qa_eval/dataset/locator_drift/qa-challenge-04_locator_drift.json +0 -23
  113. package/benchmarks/qa_eval/dataset/locator_drift/qa-challenge-05_locator_drift.json +0 -23
  114. package/benchmarks/qa_eval/dataset/stale_and_mutation/qa-challenge-16_stale_and_mutation.json +0 -22
  115. package/benchmarks/qa_eval/dataset/stale_and_mutation/qa-challenge-17_stale_and_mutation.json +0 -22
  116. package/benchmarks/qa_eval/dataset/stale_and_mutation/qa-challenge-18_stale_and_mutation.json +0 -22
  117. package/benchmarks/qa_eval/dataset/stale_and_mutation/qa-challenge-19_stale_and_mutation.json +0 -22
  118. package/benchmarks/qa_eval/dataset/stale_and_mutation/qa-challenge-20_stale_and_mutation.json +0 -23
  119. package/benchmarks/qa_eval/dataset/timing_and_race/qa-challenge-11_timing_and_race.json +0 -22
  120. package/benchmarks/qa_eval/dataset/timing_and_race/qa-challenge-12_timing_and_race.json +0 -22
  121. package/benchmarks/qa_eval/dataset/timing_and_race/qa-challenge-13_timing_and_race.json +0 -22
  122. package/benchmarks/qa_eval/dataset/timing_and_race/qa-challenge-14_timing_and_race.json +0 -22
  123. package/benchmarks/qa_eval/dataset/timing_and_race/qa-challenge-15_timing_and_race.json +0 -22
  124. package/benchmarks/qa_eval/eval_runner.py +0 -418
  125. package/examples/cypress-ecommerce-suite/README.md +0 -45
  126. package/examples/cypress-ecommerce-suite/cypress/e2e/checkout.cy.js +0 -17
  127. package/examples/cypress-ecommerce-suite/cypress/pages/BasePage.js +0 -29
  128. package/examples/cypress-ecommerce-suite/cypress/pages/CartPage.js +0 -51
  129. package/examples/cypress-ecommerce-suite/cypress.config.js +0 -13
  130. package/examples/cypress-ecommerce-suite/package.json +0 -13
  131. package/examples/katalon-suite/Keywords/pages/BasePage.groovy +0 -19
  132. package/examples/katalon-suite/Keywords/pages/DashboardPage.groovy +0 -29
  133. package/examples/katalon-suite/Keywords/pages/LoginPage.groovy +0 -45
  134. package/examples/katalon-suite/Profiles/default.glbl +0 -12
  135. package/examples/katalon-suite/README.md +0 -18
  136. package/examples/katalon-suite/Scripts/Auth/TC_LoginSuccess/Script1234567890.groovy +0 -12
  137. package/examples/katalon-suite/Scripts/Dashboard/TC_ViewSummary/Script1234567891.groovy +0 -15
  138. package/examples/katalon-suite/katalon_suite.prj +0 -21
  139. package/examples/playwright-crm-suite/README.md +0 -40
  140. package/examples/playwright-crm-suite/package.json +0 -14
  141. package/examples/playwright-crm-suite/pages/BasePage.ts +0 -37
  142. package/examples/playwright-crm-suite/pages/CustomerPage.ts +0 -57
  143. package/examples/playwright-crm-suite/pages/LoginPage.ts +0 -32
  144. package/examples/playwright-crm-suite/playwright.config.ts +0 -27
  145. package/examples/playwright-crm-suite/tests/auth.spec.ts +0 -22
  146. package/examples/playwright-crm-suite/tests/customers.spec.ts +0 -33
  147. package/examples/plugins/sample-custom-plugin/README.md +0 -14
  148. package/examples/plugins/sample-custom-plugin/plugin.json +0 -16
  149. package/examples/plugins/sample-custom-plugin/skills/custom-security-headers-audit/SKILL.md +0 -29
  150. package/examples/plugins/sample-custom-plugin/skills/custom-security-headers-audit/examples/audit_fixture.json +0 -8
  151. package/examples/plugins/sample-custom-plugin/tools/custom_security_headers.py +0 -125
  152. package/examples/practices/README.md +0 -22
  153. package/examples/practices/requirements/crm/requirements_contracts.md +0 -292
  154. package/examples/practices/requirements/crm/requirements_customers.md +0 -462
  155. package/examples/practices/requirements/crm/requirements_login.md +0 -202
  156. package/examples/practices/requirements/crm/requirements_projects.md +0 -396
  157. package/examples/practices/requirements/crm/requirements_tasks.md +0 -343
  158. package/examples/practices/requirements/ecommerce/requirements_category_brand.txt +0 -402
  159. package/examples/practices/requirements/jira/KAN-5/KAN-1/2026-04-03_04-28-27.png +0 -0
  160. package/examples/practices/requirements/jira/KAN-5/KAN-1/KAN-1_requirement.md +0 -52
  161. package/examples/practices/requirements/jira/KAN-5/KAN-4/2026-04-03_04-28-19.png +0 -0
  162. package/examples/practices/requirements/jira/KAN-5/KAN-4/2026-04-03_04-28-57.png +0 -0
  163. package/examples/practices/requirements/jira/KAN-5/KAN-4/KAN-4_requirement.md +0 -119
  164. package/examples/practices/requirements/jira/KAN-5/KAN-5_overview.md +0 -9
  165. package/examples/practices/requirements/jira/KAN-5/KAN-6/2026-04-03_05-58-08.png +0 -0
  166. package/examples/practices/requirements/jira/KAN-5/KAN-6/2026-04-03_05-58-23.png +0 -0
  167. package/examples/practices/requirements/jira/KAN-5/KAN-6/KAN-6_requirement.md +0 -32
  168. package/examples/practices/testcases/api/book_management_api_test_cases.md +0 -144
  169. package/examples/practices/testcases/api/user_management_api_test_cases.md +0 -139
  170. package/examples/practices/testcases/crm/test_cases_crm_login.md +0 -148
  171. package/examples/practices/testcases/crm/test_cases_customers.md +0 -156
  172. package/examples/pytest-api-suite/README.md +0 -45
  173. package/examples/pytest-api-suite/conftest.py +0 -31
  174. package/examples/pytest-api-suite/pages/user_api_client.py +0 -36
  175. package/examples/pytest-api-suite/requirements.txt +0 -2
  176. package/examples/pytest-api-suite/tests/test_user_api.py +0 -44
  177. package/examples/selenium-suite/README.md +0 -18
  178. package/examples/selenium-suite/pages/base_page.py +0 -27
  179. package/examples/selenium-suite/pages/login_page.py +0 -29
  180. package/examples/selenium-suite/pages/order_page.py +0 -25
  181. package/examples/selenium-suite/pytest.ini +0 -6
  182. package/examples/selenium-suite/requirements.txt +0 -2
  183. package/examples/selenium-suite/tests/test_login.py +0 -10
  184. package/examples/selenium-suite/tests/test_order.py +0 -10
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "synapse-hub",
3
- "version": "2.4.3",
3
+ "version": "2.6.0",
4
4
  "description": "Enterprise AI Agent Intelligence Hub & Autonomous Skill Network",
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -42,8 +42,6 @@
42
42
  "!tools/repo_map.txt",
43
43
  "templates",
44
44
  "docs",
45
- "examples",
46
- "benchmarks",
47
45
  "scripts",
48
46
  "LICENSE",
49
47
  "NOTICE",
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "name": "Enterprise Agent Skills Hub",
4
- "version": "2.4.3",
5
- "description": "Unified Catalog of 38 Specialized Skills for Autonomous AI Agents in Enterprise Software Quality Engineering, Performance, and Architecture.",
6
- "totalSkills": 38,
4
+ "version": "2.6.0",
5
+ "description": "Unified Catalog of 42 Specialized Skills for Autonomous AI Agents in Enterprise Software Quality Engineering, Performance, and Architecture.",
6
+ "totalSkills": 42,
7
7
  "categories": {
8
8
  "context_and_optimization": [
9
9
  "token-and-context-optimizer",
@@ -46,6 +46,10 @@
46
46
  "code-refactoring-refactor-clean",
47
47
  "surgical-coding-principles",
48
48
  "lean-code-ladder",
49
+ "senior-code-review",
50
+ "repo-quality-audit",
51
+ "technical-debt-harvester",
52
+ "lean-impact-scoreboard",
49
53
  "graphify-impact-analyzer",
50
54
  "wcag-audit-patterns",
51
55
  "github-actions-templates",
@@ -473,6 +477,38 @@
473
477
  "path": ".agents/skills/meta-prompt-crafter/SKILL.md",
474
478
  "summary": "Meta-prompt engineer transforming rough human requests into high-fidelity, production-grade prompts for ChatGPT, Gemini, Claude, and Midjourney.",
475
479
  "version": "1.0.0"
480
+ },
481
+ {
482
+ "id": "senior-code-review",
483
+ "name": "Senior Code Review",
484
+ "category": "architecture_and_analysis",
485
+ "path": ".agents/skills/senior-code-review/SKILL.md",
486
+ "summary": "Quality review of a code change: verify logic correctness, security boundaries, real concurrency/load, missing test coverage, execution speed, and eliminate bloat.",
487
+ "version": "1.0.0"
488
+ },
489
+ {
490
+ "id": "repo-quality-audit",
491
+ "name": "Repo Quality Audit",
492
+ "category": "architecture_and_analysis",
493
+ "path": ".agents/skills/repo-quality-audit/SKILL.md",
494
+ "summary": "Quality audit of a whole codebase: bugs, security risks, concurrency and scale bottlenecks, missing test coverage, and code bloat with 'Fix this first' priority.",
495
+ "version": "1.0.0"
496
+ },
497
+ {
498
+ "id": "technical-debt-harvester",
499
+ "name": "Technical Debt Harvester",
500
+ "category": "architecture_and_analysis",
501
+ "path": ".agents/skills/technical-debt-harvester/SKILL.md",
502
+ "summary": "Harvest shortcut: comments into a tracked debt ledger so deliberate compromises do not rot into forgotten tech debt.",
503
+ "version": "1.0.0"
504
+ },
505
+ {
506
+ "id": "lean-impact-scoreboard",
507
+ "name": "Lean Impact Scoreboard",
508
+ "category": "architecture_and_analysis",
509
+ "path": ".agents/skills/lean-impact-scoreboard/SKILL.md",
510
+ "summary": "Display the measured impact scoreboard (code reduction %, token optimization %, cost reduction %, test rigor) from lean engineering benchmarks.",
511
+ "version": "1.0.0"
476
512
  }
477
513
  ]
478
514
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://raw.githubusercontent.com/TeeVee998/Synapse-Hub/main/docs/schemas/synapse.config.schema.json",
3
- "version": "2.4.3",
3
+ "version": "2.6.0",
4
4
  "quality_gates": {
5
5
  "mutation_min_score": 80,
6
6
  "gates": {
@@ -12,7 +12,8 @@
12
12
  "gate_5_cleanup_blacklist": true,
13
13
  "gate_6_credential_security": true,
14
14
  "gate_7_infer_linter": true,
15
- "gate_8_micro_mutator": true
15
+ "gate_8_micro_mutator": true,
16
+ "gate_9_skill_collision": true
16
17
  }
17
18
  },
18
19
  "infer_linter": {
@@ -46,3 +46,8 @@ In accordance with the MIT License, the original copyright notice crediting **Th
46
46
  5. **Pragmatic Communication Protocol:**
47
47
  - Conversational responses, explanation, and telemetry MUST be in Vietnamese.
48
48
  - All codebase assets, test scripts, Page Classes, docstrings, and commits MUST remain strictly in English.
49
+
50
+ 6. **Lean Senior Dev Protocol (The 7-Rung Ladder & YAGNI):**
51
+ - The best code is the code never written. Solve the whole problem with the least new code.
52
+ - 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.
53
+ - Any deliberate simplification gets an inline comment: `shortcut: <the limit>, <when to upgrade>`.
@@ -12,7 +12,9 @@
12
12
  ## Coding Invariants
13
13
  - Enforce Clean Page Object Model (POM) with Flat Architecture.
14
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>`.
15
16
  - Prohibit hardcoded sleeps (`Thread.sleep`, `time.sleep`). Always suggest dynamic polling or event-based waits.
16
17
  - Every test data generation must produce unique timestamped strings (`AUTO_` + System time) to prevent collisions.
17
18
  - Preserve author attribution for Thế Vị (@TeeVee998) in LICENSE and NOTICE files.
18
19
  - 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`.
@@ -18,6 +18,7 @@ Attribution notices must be preserved.
18
18
  ## Core Rules
19
19
  1. **Clean POM Architecture:** No raw selectors (XPath/CSS) in test scripts. All selectors belong in Page Classes extending BasePage.
20
20
  2. **Truth Anchor:** Never fake test passes. Report genuine defects.
21
- 3. **Smart Wait:** Prohibit static delays (`Thread.sleep`). Use dynamic smart waits.
22
- 4. **Idempotent Test Data:** Prefix with `AUTO_` and dynamic timestamps; teardown after creation.
23
- 5. **Bilingual Discipline:** Converse in Vietnamese; write code and git commits strictly in English.
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.
@@ -21,5 +21,6 @@
21
21
 
22
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.
23
23
  - Adhere to Clean Page Object Model (POM) Flat Architecture.
24
+ - Lean Senior Dev: Solve problems with minimum code via 7-rung ladder; mark shortcuts with `shortcut: <limit>, <upgrade>`.
24
25
  - Zero fake passes and zero swallowed exceptions.
25
26
  - Run Definition of Done verification: python tools/verify_all.py
@@ -781,7 +781,7 @@
781
781
  <li><a href="#pillars" data-i18n="nav_pillars">4 Trụ Cột</a></li>
782
782
  <li><a href="#hero-features" data-i18n="nav_features">Tính Năng</a></li>
783
783
  <li><a href="#quickstart" data-i18n="nav_quickstart">Lệnh CLI</a></li>
784
- <li><a href="#quality-gates" data-i18n="nav_gates">9 Quality Gates</a></li>
784
+ <li><a href="#quality-gates" data-i18n="nav_gates">10 Quality Gates</a></li>
785
785
  <li><a href="#comparison" data-i18n="nav_compare">So Sánh</a></li>
786
786
  </ul>
787
787
  <div class="nav-actions">
@@ -806,7 +806,7 @@
806
806
  <p data-i18n="hero_desc">
807
807
  Tăng cường sức mạnh cho QA Engineers và các Autonomous AI Agent trên cả 4 mảng:
808
808
  <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong> và <strong>Performance Testing</strong>.
809
- Trang bị các Sentinel phân tích cú pháp AST 100% offline, 6 hồ sơ Swarm Agent, và 9 Quality Gates Definition-of-Done.
809
+ Trang bị các Sentinel phân tích cú pháp AST 100% offline, 6 hồ sơ Swarm Agent, và 10 Quality Gates Definition-of-Done.
810
810
  </p>
811
811
  <div class="hero-modes" style="display: flex; justify-content: center; gap: 16px; margin: 0 auto 32px; max-width: 820px; flex-wrap: wrap;">
812
812
  <div style="background: rgba(255, 255, 255, 0.04); border: 1px solid rgba(255, 255, 255, 0.08); border-radius: 12px; padding: 14px 18px; text-align: left; flex: 1; min-width: 260px;">
@@ -821,7 +821,7 @@
821
821
  <div class="hero-buttons">
822
822
  <a href="#quickstart" class="btn btn-primary" style="padding: 12px 24px; font-size: 15px;" data-i18n="btn_quickstart">🚀 Bắt Đầu Trong 5 Giây</a>
823
823
  <a href="#pillars" class="btn btn-secondary" style="padding: 12px 24px; font-size: 15px;" data-i18n="btn_pillars">🎯 Khám Phá 4 Trụ Cột</a>
824
- <a href="#quality-gates" class="btn btn-emerald" style="padding: 12px 24px; font-size: 15px;" data-i18n="btn_gates">🛡️ Xem 9 Quality Gates</a>
824
+ <a href="#quality-gates" class="btn btn-emerald" style="padding: 12px 24px; font-size: 15px;" data-i18n="btn_gates">🛡️ Xem 10 Quality Gates</a>
825
825
  </div>
826
826
 
827
827
  <!-- Stats Ribbon -->
@@ -831,7 +831,7 @@
831
831
  <div class="stat-label" data-i18n="stat_skills">Kỹ Năng AI Tiêu Chuẩn</div>
832
832
  </div>
833
833
  <div class="stat-item">
834
- <div class="stat-val" style="color: var(--accent-emerald);">9 / 9</div>
834
+ <div class="stat-val" style="color: var(--accent-emerald);">10 / 10</div>
835
835
  <div class="stat-label" data-i18n="stat_gates">Cổng Kiểm Soát DoD</div>
836
836
  </div>
837
837
  <div class="stat-item">
@@ -983,7 +983,7 @@
983
983
  <div class="terminal-tabs">
984
984
  <div class="terminal-tab active" onclick="switchTab(event, 'tab-doctor')" data-i18n="t_doctor">1. Chẩn Đoán (Doctor)</div>
985
985
  <div class="terminal-tab" onclick="switchTab(event, 'tab-setup')" data-i18n="t_setup">2. Cài Đặt (Setup)</div>
986
- <div class="terminal-tab" onclick="switchTab(event, 'tab-verify')" data-i18n="t_verify">3. Kiểm Tra 9 Cổng</div>
986
+ <div class="terminal-tab" onclick="switchTab(event, 'tab-verify')" data-i18n="t_verify">3. Kiểm Tra 10 Cổng</div>
987
987
  <div class="terminal-tab" onclick="switchTab(event, 'tab-lint')" data-i18n="t_lint">4. Quét Fake-Pass</div>
988
988
  <div class="terminal-tab" onclick="switchTab(event, 'tab-excel')" data-i18n="t_excel">5. Xuất Excel</div>
989
989
  <div class="terminal-tab" onclick="switchTab(event, 'tab-dashboard')" data-i18n="t_dashboard">6. Dashboard</div>
@@ -1016,7 +1016,7 @@
1016
1016
  <div class="cmd-text"><span class="prompt">$</span>npx synapse-hub verify</div>
1017
1017
  <button class="copy-btn" onclick="copyCmd('npx synapse-hub verify')">Copy</button>
1018
1018
  </div>
1019
- <p class="cmd-desc" data-i18n="t_desc_verify">🛡️ Thực thi toàn bộ 9 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Đường dẫn khả chuyển, Mutation &ge; 80%).</p>
1019
+ <p class="cmd-desc" data-i18n="t_desc_verify">🛡️ Thực thi toàn bộ 10 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Đường dẫn khả chuyển, Mutation &ge; 80%, Skill Routing Guard).</p>
1020
1020
  </div>
1021
1021
 
1022
1022
  <!-- Tab Lint -->
@@ -1141,12 +1141,12 @@
1141
1141
  </div>
1142
1142
  </section>
1143
1143
 
1144
- <!-- 9 Quality Gates DoD Section -->
1144
+ <!-- 10 Quality Gates DoD Section -->
1145
1145
  <section id="quality-gates" style="scroll-margin-top: 100px;">
1146
1146
  <div class="section-header">
1147
1147
  <span class="section-tag" data-i18n="sec_gates_tag">Kiểm Định Toàn Diện</span>
1148
- <h2 class="section-title" data-i18n="sec_gates_title">9 Cổng Kiểm Soát Chất Lượng (DoD Sentinel)</h2>
1149
- <p class="section-desc" data-i18n="sec_gates_desc">Mọi kịch bản test do AI sinh ra bắt buộc phải vượt qua toàn bộ 9 Quality Gates trước khi được commit hoặc merge code.</p>
1148
+ <h2 class="section-title" data-i18n="sec_gates_title">10 Cổng Kiểm Soát Chất Lượng (DoD Sentinel)</h2>
1149
+ <p class="section-desc" data-i18n="sec_gates_desc">Mọi kịch bản test do AI sinh ra bắt buộc phải vượt qua toàn bộ 10 Quality Gates trước khi được commit hoặc merge code.</p>
1150
1150
  </div>
1151
1151
 
1152
1152
  <div class="gates-grid">
@@ -1195,6 +1195,11 @@
1195
1195
  <div class="gate-name" data-i18n="g8_name">Kiểm Thử Đột Biến Mã (Micro-Mutation)</div>
1196
1196
  <div class="gate-desc" data-i18n="g8_desc">Yêu cầu điểm Mutation &ge; 80% để loại bỏ các bài test pass ảo nhưng không kiểm tra logic thực tế.</div>
1197
1197
  </div>
1198
+ <div class="gate-card">
1199
+ <div class="gate-top"><span class="gate-badge">GATE 9</span><span class="gate-pass">✓ PASS</span></div>
1200
+ <div class="gate-name" data-i18n="g9_name">Điều Phối Kỹ Năng & Ngăn Xung Đột</div>
1201
+ <div class="gate-desc" data-i18n="g9_desc">Kiểm tra độ tương đồng ngữ nghĩa và trigger giữa các skill, loại bỏ hoàn toàn kích hoạt nhầm lẫn.</div>
1202
+ </div>
1198
1203
  </div>
1199
1204
  </section>
1200
1205
 
@@ -1287,21 +1292,21 @@
1287
1292
  nav_pillars: "4 Trụ Cột",
1288
1293
  nav_features: "Tính Năng",
1289
1294
  nav_quickstart: "Lệnh CLI",
1290
- nav_gates: "9 Quality Gates",
1295
+ nav_gates: "10 Quality Gates",
1291
1296
  nav_compare: "So Sánh",
1292
1297
  status_ready: "● Sẵn sàng",
1293
1298
  hero_pill_tag: "🛡️ Trung Tâm Trí Tuệ Chất Lượng AI Doanh Nghiệp",
1294
1299
  hero_pill_status: "Sẵn Sàng 100% Offline",
1295
1300
  hero_target_label: "Dự án mục tiêu",
1296
1301
  hero_title: "Trung Tâm Trí Tuệ QA Toàn Diện<br>Dành Cho AI Coding Agents",
1297
- hero_desc: "Tăng cường sức mạnh cho QA Engineers và các Autonomous AI Agent trên cả 4 mảng: <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong> và <strong>Performance Testing</strong>. Trang bị các Sentinel phân tích cú pháp AST 100% offline, 6 hồ sơ Swarm Agent, và 9 Quality Gates Definition-of-Done.",
1302
+ hero_desc: "Tăng cường sức mạnh cho QA Engineers và các Autonomous AI Agent trên cả 4 mảng: <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong> và <strong>Performance Testing</strong>. Trang bị các Sentinel phân tích cú pháp AST 100% offline, 6 hồ sơ Swarm Agent, và 10 Quality Gates Definition-of-Done.",
1298
1303
  mode_cli_title: "🛠️ Cách 1: CLI Độc Lập (Zero AI)",
1299
1304
  mode_cli_desc: "Chạy <code>npx synapse-hub lint</code> phát hiện test pass ảo, nén log CI hoặc xuất Excel chuẩn mà không cần cấu hình.",
1300
1305
  mode_agent_title: "🧠 Cách 2: Chốt Chặn Cho AI Coding",
1301
1306
  mode_agent_desc: "Tích hợp vào Cursor, Antigravity, Claude Code làm bộ quy chuẩn — ngăn AI sinh mã nguồn cẩu thả hoặc bỏ qua ngoại lệ ngầm.",
1302
1307
  btn_quickstart: "🚀 Bắt Đầu Trong 5 Giây",
1303
1308
  btn_pillars: "🎯 Khám Phá 4 Trụ Cột",
1304
- btn_gates: "🛡️ Xem 9 Quality Gates",
1309
+ btn_gates: "🛡️ Xem 10 Quality Gates",
1305
1310
  stat_skills: "Kỹ Năng AI Tiêu Chuẩn",
1306
1311
  stat_gates: "Cổng Kiểm Soát DoD",
1307
1312
  stat_swarm: "Vai Trò AI Chuyên Biệt",
@@ -1354,7 +1359,7 @@
1354
1359
  sec_cli_desc: "Thực thi mọi tính năng mạnh mẽ của Synapse Hub trực tiếp qua npx hoặc npm mà không cần cài đặt phức tạp.",
1355
1360
  t_doctor: "1. Chẩn Đoán (Doctor)",
1356
1361
  t_setup: "2. Cài Đặt (Setup)",
1357
- t_verify: "3. Kiểm Tra 9 Cổng",
1362
+ t_verify: "3. Kiểm Tra 10 Cổng",
1358
1363
  t_lint: "4. Quét Fake-Pass",
1359
1364
  t_excel: "5. Xuất Excel",
1360
1365
  t_dashboard: "6. Dashboard",
@@ -1362,7 +1367,7 @@
1362
1367
  t_watch: "8. Giám Sát Real-Time",
1363
1368
  t_desc_doctor: "🩺 Quét chẩn đoán 1-click kiểm tra môi trường Python 3.9+, Node.js, Git hook, trình duyệt, và Bộ nhớ Agent Trung tâm.",
1364
1369
  t_desc_setup: "⚡ Cài đặt dự án 1-click: sinh hướng dẫn PROJECT_AI_GUIDE.md, cầu nối Universal AI bridges, bản đồ AST, và git hook chặn rò rỉ.",
1365
- t_desc_verify: "🛡️ Thực thi toàn bộ 9 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Đường dẫn linh hoạt, Mutation &ge; 80%).",
1370
+ t_desc_verify: "🛡️ Thực thi toàn bộ 10 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Đường dẫn linh hoạt, Mutation &ge; 80%, Skill Routing Guard).",
1366
1371
  t_desc_lint: "🔍 Quét AST phát hiện các test case pass ảo (0 assertion), khối catch rỗng và ngoại lệ bị bỏ qua ngầm (swallowed exceptions) trên toàn bộ test script.",
1367
1372
  t_desc_excel: "📊 Biên dịch tài liệu test case markdown sang file bảng tính Excel 12 cột chuyên nghiệp có công thức và danh sách chọn trạng thái.",
1368
1373
  t_desc_dashboard: "📈 Khởi tạo và mở trang Báo cáo QA Tổng thể dạng HTML độc lập ngay trong trình duyệt của bạn.",
@@ -1392,8 +1397,8 @@
1392
1397
  tr6_dim: "QA Thủ Công (AI-RBT & Excel)",
1393
1398
  tr6_syn: "Xuất Excel 12 cột tích hợp sẵn",
1394
1399
  sec_gates_tag: "Kiểm Định Toàn Diện",
1395
- sec_gates_title: "9 Cổng Kiểm Soát Chất Lượng (DoD Sentinel)",
1396
- sec_gates_desc: "Mọi kịch bản test do AI sinh ra bắt buộc phải vượt qua toàn bộ 9 Quality Gates trước khi được commit hoặc merge code.",
1400
+ sec_gates_title: "10 Cổng Kiểm Soát Chất Lượng (DoD Sentinel)",
1401
+ sec_gates_desc: "Mọi kịch bản test do AI sinh ra bắt buộc phải vượt qua toàn bộ 10 Quality Gates trước khi được commit hoặc merge code.",
1397
1402
  g0_name: "Bảo Đảm Bản Quyền & Tác Giả",
1398
1403
  g0_desc: "Bảo chứng nguồn gốc tác quyền Thế Vị (@TeeVee998) theo chuẩn Giấy phép MIT.",
1399
1404
  g1_name: "Chuẩn Mã Hóa UTF-8 No BOM",
@@ -1412,6 +1417,8 @@
1412
1417
  g7_desc: "Tự động quét phát hiện test thiếu assertion, sleep cố định và try-catch bỏ qua ngoại lệ ngầm.",
1413
1418
  g8_name: "Kiểm Thử Đột Biến Mã (Micro-Mutation)",
1414
1419
  g8_desc: "Yêu cầu điểm Mutation &ge; 80% để loại bỏ các bài test pass ảo nhưng không kiểm tra logic thực tế.",
1420
+ g9_name: "Điều Phối Kỹ Năng & Ngăn Xung Đột (Skill Collision Guard)",
1421
+ g9_desc: "Kiểm tra độ tương đồng ngữ nghĩa và trigger giữa các skill, loại bỏ hoàn toàn xung đột nhầm lẫn.",
1415
1422
  sec_swarm_tag: "Hệ Thống AI Agent Tự Động (Swarm)",
1416
1423
  sec_swarm_title: "6 Hồ Sơ Subagent Chuyên Biệt",
1417
1424
  sec_swarm_desc: "Phối hợp nhịp nhàng thông qua kiến trúc Single Front-Door FSM, loại bỏ hoàn toàn sự lúng túng khi điều phối agent.",
@@ -1426,7 +1433,7 @@
1426
1433
  a5_role: "Chuyên Gia Phân Tích & Điều Tra Lỗi (Failure Autopsy)",
1427
1434
  a5_desc: "Chẩn đoán nguyên nhân gốc (RCA) từ JUnit XML và ảnh chụp lỗi; tự động đề xuất giải pháp và tạo PR khắc phục lỗi.",
1428
1435
  a6_role: "Chốt Chặn Kiểm Soát Chất Lượng (Quality Gatekeeper)",
1429
- a6_desc: "Kiểm định nghiêm ngặt toàn bộ 9 Quality Gates DoD và điểm mutation &ge; 80% trước khi hoàn tất công việc.",
1436
+ a6_desc: "Kiểm định nghiêm ngặt toàn bộ 10 Quality Gates DoD và điểm mutation &ge; 80% trước khi hoàn tất công việc.",
1430
1437
  footer_subtitle: "Nền Tảng Kiểm Định Chất Lượng & Guardrail Cho AI Coding Doanh Nghiệp.",
1431
1438
  footer_creator: "Tác giả sáng lập",
1432
1439
  footer_license: "Phát hành theo",
@@ -1438,21 +1445,21 @@
1438
1445
  nav_pillars: "4 Pillars",
1439
1446
  nav_features: "Features",
1440
1447
  nav_quickstart: "CLI Commands",
1441
- nav_gates: "9 Quality Gates",
1448
+ nav_gates: "10 Quality Gates",
1442
1449
  nav_compare: "Comparison",
1443
1450
  status_ready: "● Ready",
1444
1451
  hero_pill_tag: "🛡️ Enterprise AI Quality Intelligence Hub",
1445
1452
  hero_pill_status: "100% Offline Ready",
1446
1453
  hero_target_label: "Target Project",
1447
1454
  hero_title: "The Complete QA Intelligence Hub<br>for AI Coding Agents",
1448
- hero_desc: "Empowering QA Engineers and Autonomous AI Agents across <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong>, and <strong>Performance</strong> testing. Equipped with 100% offline-first AST sentinels, 6 swarm profiles, and 9 Quality Gates Definition-of-Done.",
1455
+ hero_desc: "Empowering QA Engineers and Autonomous AI Agents across <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong>, and <strong>Performance</strong> testing. Equipped with 100% offline-first AST sentinels, 6 swarm profiles, and 10 Quality Gates Definition-of-Done.",
1449
1456
  mode_cli_title: "🛠️ Mode 1: Standalone CLI (Zero AI)",
1450
1457
  mode_cli_desc: "Run <code>npx synapse-hub lint</code> to catch fake passes, distill CI logs, or export Excel with zero setup.",
1451
1458
  mode_agent_title: "🧠 Mode 2: Guardrail for AI Coding",
1452
1459
  mode_agent_desc: "Mount into Cursor, Antigravity, or Claude Code as quality guardrails — stopping AI from writing brittle or tautological tests.",
1453
1460
  btn_quickstart: "🚀 5-Second Quickstart",
1454
1461
  btn_pillars: "🎯 Explore 4 Pillars",
1455
- btn_gates: "🛡️ View 9 Quality Gates",
1462
+ btn_gates: "🛡️ View 10 Quality Gates",
1456
1463
  stat_skills: "Standardized AI Skills",
1457
1464
  stat_gates: "Quality Gates DoD",
1458
1465
  stat_swarm: "Autonomous Swarm Roles",
@@ -1505,7 +1512,7 @@
1505
1512
  sec_cli_desc: "Run all Synapse Hub capabilities directly via npx without manual configuration.",
1506
1513
  t_doctor: "1. Doctor",
1507
1514
  t_setup: "2. Setup Project",
1508
- t_verify: "3. Verify 9 Gates",
1515
+ t_verify: "3. Verify 10 Gates",
1509
1516
  t_lint: "4. Scan Fake-Pass",
1510
1517
  t_excel: "5. Export Excel",
1511
1518
  t_dashboard: "6. Dashboard",
@@ -1513,7 +1520,7 @@
1513
1520
  t_watch: "8. Real-Time Watch",
1514
1521
  t_desc_doctor: "🩺 Runs a 1-click diagnostic scan verifying Python 3.9+, Node.js, Git hooks, browser drivers, and Central Agent Memory.",
1515
1522
  t_desc_setup: "⚡ 1-click bootstrap of target repository: generates PROJECT_AI_GUIDE.md, universal AI bridges, AST map, and pre-push sentinel.",
1516
- t_desc_verify: "🛡️ Enforces all 9 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Path Portability, Mutation &ge; 80%).",
1523
+ t_desc_verify: "🛡️ Enforces all 10 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Path Portability, Mutation &ge; 80%, Skill Routing Guard).",
1517
1524
  t_desc_lint: "🔍 AST scan detecting fake passes (0 assertions), empty catch blocks, and swallowed exceptions across all test scripts.",
1518
1525
  t_desc_excel: "📊 Compiles markdown test cases into a professional 12-column Excel workbook with status dropdowns and formulas.",
1519
1526
  t_desc_dashboard: "📈 Compiles and opens the standalone executive QA HTML report in your browser.",
@@ -1543,8 +1550,8 @@
1543
1550
  tr6_dim: "Manual QA (AI-RBT & Excel)",
1544
1551
  tr6_syn: "Native 12-Col Exporter",
1545
1552
  sec_gates_tag: "Zero-Hallucination Pipeline",
1546
- sec_gates_title: "9 Quality Gates DoD Sentinel",
1547
- sec_gates_desc: "Every AI-generated test script must satisfy all 9 Quality Gates before code can be committed or merged.",
1553
+ sec_gates_title: "10 Quality Gates DoD Sentinel",
1554
+ sec_gates_desc: "Every AI-generated test script must satisfy all 10 Quality Gates before code can be committed or merged.",
1548
1555
  g0_name: "Author Attribution & Integrity",
1549
1556
  g0_desc: "Cryptographic provenance invariant preserving author Thế Vị (@TeeVee998) MIT license.",
1550
1557
  g1_name: "UTF-8 No BOM & Clean Encoding",
@@ -1563,6 +1570,8 @@
1563
1570
  g7_desc: "Meta Infer-style heuristic & static AST scan catching 0-assertion tests, static sleeps, and swallowed exception blocks.",
1564
1571
  g8_name: "Syntactic Micro-Mutation",
1565
1572
  g8_desc: "Requires test suite mutation score &ge; 80% to eliminate tautological test cases.",
1573
+ g9_name: "Skill Routing & Collision Guard",
1574
+ g9_desc: "Audits semantic descriptions and activation triggers between skills, eliminating ambiguous dispatch.",
1566
1575
  sec_swarm_tag: "Autonomous Multi-Agent System",
1567
1576
  sec_swarm_title: "6 Specialized Subagent Profiles",
1568
1577
  sec_swarm_desc: "Coordinated through a single front-door FSM architecture to avoid decision paralysis.",
@@ -1577,7 +1586,7 @@
1577
1586
  a5_role: "Failure Autopsy Analyst",
1578
1587
  a5_desc: "Closed-loop failure diagnosis from JUnit XML and screenshots; generates auto-healing PR plans.",
1579
1588
  a6_role: "Quality Gatekeeper Sentinel",
1580
- a6_desc: "Final gatekeeper enforcing all 9 Quality Gates DoD and &ge; 80% mutation score before task completion.",
1589
+ a6_desc: "Final gatekeeper enforcing all 10 Quality Gates DoD and &ge; 80% mutation score before task completion.",
1581
1590
  footer_subtitle: "The Enterprise AI Agent Quality Engineering & Autonomous Skill Network.",
1582
1591
  footer_creator: "Original Creator",
1583
1592
  footer_license: "Released under the",