@teevee98/synapse-hub 3.8.2 → 3.8.4

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 (132) hide show
  1. package/.agents/agents/orchestrator.md +1 -1
  2. package/.agents/agents/quality-gatekeeper.md +3 -3
  3. package/.agents/rules/author-integrity-guard.md +5 -5
  4. package/.agents/rules/mandatory-playwright-live.md +1 -1
  5. package/.agents/rules/skill-precedence.md +1 -1
  6. package/.agents/rules/systematic-debugging.md +1 -1
  7. package/.agents/skills/antigravity-test-sentinel/SKILL.md +3 -3
  8. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +1 -1
  9. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +1 -1
  10. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +1 -1
  11. package/.agents/skills/persistent-planning-files/SKILL.md +1 -1
  12. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +1 -1
  13. package/.agents/skills/repo-quality-audit/SKILL.md +1 -1
  14. package/.agents/skills/surgical-coding-principles/SKILL.md +2 -2
  15. package/.agents/skills/verification-before-completion/SKILL.md +2 -2
  16. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +2 -2
  17. package/.agents/workflows/verify.md +3 -3
  18. package/.cursor/rules/synapse-qa.mdc +1 -1
  19. package/.cursorrules +3 -3
  20. package/.pre-commit-hooks.yaml +2 -2
  21. package/.windsurfrules +3 -3
  22. package/AGENTS.md +3 -3
  23. package/CLAUDE.md +4 -4
  24. package/Dockerfile +5 -5
  25. package/README.en.md +16 -17
  26. package/README.md +16 -17
  27. package/action.yml +2 -2
  28. package/agentskills.json +4 -4
  29. package/bin/agent-qa.js +2 -2
  30. package/docker-compose.yml +8 -8
  31. package/docs/ARCHITECTURE.en.md +6 -5
  32. package/docs/ARCHITECTURE.md +7 -6
  33. package/docs/CI_CD_INTEGRATION.en.md +16 -16
  34. package/docs/CI_CD_INTEGRATION.md +16 -16
  35. package/docs/CLI_REFERENCE.en.md +2 -3
  36. package/docs/CLI_REFERENCE.md +4 -5
  37. package/docs/CONTRIBUTING.en.md +1 -1
  38. package/docs/CONTRIBUTING.md +1 -1
  39. package/docs/PERFORMANCE_AUDIT_REPORT.md +2 -3
  40. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +1 -1
  41. package/docs/QUALITY_GATES.en.md +9 -12
  42. package/docs/QUALITY_GATES.md +10 -13
  43. package/docs/TOOL_CATALOG.md +1 -1
  44. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +3 -3
  45. package/docs/research/agent_skill_training_analysis.md +17 -18
  46. package/docs/schemas/synapse.config.schema.json +0 -1
  47. package/package.json +5 -5
  48. package/plugin.json +6 -6
  49. package/skills_manifest.json +1 -1
  50. package/synapse.config.json +2 -3
  51. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +2 -2
  52. package/templates/PROJECT_STATE_TEMPLATE.md +1 -1
  53. package/templates/ai_bridges/CLAUDE.md +4 -4
  54. package/templates/ai_bridges/copilot-instructions.md +2 -2
  55. package/templates/ai_bridges/cursor_synapse_qa.mdc +1 -1
  56. package/templates/ai_bridges/windsurfrules +3 -3
  57. package/templates/ci/github-actions-synapse.yml +5 -5
  58. package/templates/ui/index.html +14 -14
  59. package/templates/welcome.html.tmpl +29 -34
  60. package/tools/TOOLS_RUNBOOK.md +7 -7
  61. package/tools/TOOL_CATALOG.json +1 -1
  62. package/tools/__init__.py +5 -5
  63. package/tools/_openapi_parser.py +2 -2
  64. package/tools/agentless_patcher.py +2 -2
  65. package/tools/analyze_project.py +10 -6
  66. package/tools/author_integrity.py +19 -13
  67. package/tools/auto_heal_reflexion.py +2 -2
  68. package/tools/autogen_qa_broker.py +2 -2
  69. package/tools/benchmark_swarm_context.py +2 -2
  70. package/tools/browser_helpers.js +2 -2
  71. package/tools/browsergym_eval.py +2 -2
  72. package/tools/bump_version.py +2 -2
  73. package/tools/ci_healing_hook.py +1 -1
  74. package/tools/cli.py +11 -11
  75. package/tools/contract_validator.py +2 -2
  76. package/tools/core/adapters.py +2 -2
  77. package/tools/core/circuit_breaker.py +2 -2
  78. package/tools/core/cli_runtime.py +2 -2
  79. package/tools/core/file_lock.py +2 -2
  80. package/tools/core/i18n.py +7 -7
  81. package/tools/core/memory_bus.py +2 -2
  82. package/tools/core/process_supervisor.py +2 -2
  83. package/tools/core/telemetry.py +2 -2
  84. package/tools/count_tokens.py +1 -1
  85. package/tools/dashboard_generator.py +31 -47
  86. package/tools/debt_harvester.py +2 -2
  87. package/tools/dspy_qa_signatures.py +3 -3
  88. package/tools/fsm_enforcer.py +5 -5
  89. package/tools/fsm_middleware.py +2 -2
  90. package/tools/generate_sbom.py +9 -9
  91. package/tools/generate_tool_catalog.py +3 -3
  92. package/tools/gherkin_suite.py +2 -2
  93. package/tools/goldfish_review.py +2 -2
  94. package/tools/heal_pr_automator.py +1 -1
  95. package/tools/hub_publisher.py +12 -12
  96. package/tools/humanize_linter.py +2 -2
  97. package/tools/init_config.py +4 -5
  98. package/tools/interview_story.py +2 -2
  99. package/tools/jira_sync.py +2 -2
  100. package/tools/lint_ai_docs.py +2 -2
  101. package/tools/mcp_docx_server.py +3 -3
  102. package/tools/mcp_excel_server.py +1 -1
  103. package/tools/mcp_server.py +5 -4
  104. package/tools/mipro_assertion_tuner.py +2 -2
  105. package/tools/openxml_guard.py +2 -2
  106. package/tools/package_release.py +2 -2
  107. package/tools/project_state.py +2 -2
  108. package/tools/qa_event_stream.py +2 -2
  109. package/tools/reversible_sandbox.py +2 -2
  110. package/tools/security_coverage_ledger.py +1 -1
  111. package/tools/security_scanner.py +2 -2
  112. package/tools/senior_code_review.py +2 -2
  113. package/tools/skill_collision_guard.py +2 -2
  114. package/tools/skill_profiles.py +2 -2
  115. package/tools/skill_vault.py +2 -2
  116. package/tools/skillspector.py +2 -2
  117. package/tools/spec_drift_sentinel.py +2 -2
  118. package/tools/swe_qa_aci.py +2 -2
  119. package/tools/synapse_observer.py +2 -2
  120. package/tools/synapse_qa_bench.py +2 -2
  121. package/tools/sync_agent_rules.py +15 -15
  122. package/tools/template_excel_exporter.py +2 -2
  123. package/tools/test_memory_os.py +2 -2
  124. package/tools/textgrad_mutation_optimizer.py +2 -2
  125. package/tools/tms_sync_bridge.py +2 -2
  126. package/tools/tot_exploratory_tester.py +2 -2
  127. package/tools/trend_analytics.py +2 -2
  128. package/tools/ui_server.py +6 -6
  129. package/tools/update_sentinel.py +6 -6
  130. package/tools/verify_all.py +36 -19
  131. package/tools/watch_mode.py +2 -2
  132. package/tools/welcome_page.py +9 -9
package/README.md CHANGED
@@ -5,15 +5,15 @@
5
5
  [🇻🇳 Tiếng Việt](README.md) | [🇬🇧 English Edition](README.en.md)
6
6
 
7
7
  > **Định vị cốt lõi:** Bộ Linter & Guardrails độc lập (zero external dependencies cho core engine & DoD gates) bảo vệ độ tin cậy của test suite khi AI viết code — Tự động bắt test "pass ảo" (0 assert, tautology), loại bỏ hoàn toàn sleep cố định, nén 95% log CI/CD, và chuẩn hóa cấu trúc Clean POM.
8
- > **Tác giả:** Thế Vị ([@TeeVee998](https://github.com/TeeVee998)) | **Giấy phép:** MIT License
9
- > **Phiên bản:** `v3.8.2` | **Quy mô:** 53 Kỹ năng QA, 9 Vai trò AI Agent, 11 Cổng kiểm định DoD.
8
+ > **Tác giả:** Thế Vị ([@TeeVee98](https://github.com/TeeVee98)) | **Giấy phép:** MIT License
9
+ > **Phiên bản:** `v3.8.4` | **Quy mô:** 53 Kỹ năng QA, 9 Vai trò AI Agent, 10 Cổng kiểm định DoD.
10
10
 
11
11
  [![npm version](https://img.shields.io/npm/v/synapse-hub.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/synapse-hub)
12
12
  [![node version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org)
13
13
  [![python version](https://img.shields.io/badge/python-%3E%3D3.10-blue.svg?style=flat-square)](https://python.org)
14
- [![Quality Gates](https://img.shields.io/badge/Quality%20Gates-11%2F11%20DoD%20PASS-success.svg?style=flat-square)](docs/QUALITY_GATES.md)
14
+ [![Quality Gates](https://img.shields.io/badge/Quality%20Gates-10%2F10%20DoD%20PASS-success.svg?style=flat-square)](docs/QUALITY_GATES.md)
15
15
  [![Tests](https://img.shields.io/badge/tests-700%2B%20passing-brightgreen.svg?style=flat-square)](#)
16
- [![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](https://github.com/TeeVee998/Synapse-Hub/blob/main/LICENSE)
16
+ [![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](https://github.com/TeeVee98/Synapse-Hub/blob/main/LICENSE)
17
17
  [![Ecosystem](https://img.shields.io/badge/AI%20Ecosystem-Antigravity%20%7C%20Cursor%20%7C%20Claude%20%7C%20Copilot%20%7C%20Windsurf-orange.svg?style=flat-square)](#)
18
18
 
19
19
  ---
@@ -36,12 +36,12 @@ flowchart LR
36
36
  -->|Sinh mã thô| Raw["📄 <b>Mã test tự động chưa kiểm định</b><br/><i>(Playwright, Pytest, Cypress, Katalon)</i>"]
37
37
  end
38
38
 
39
- subgraph Hub["🛡️ Synapse Hub — Bộ Linter & 11 Cổng Chất Lượng DoD"]
39
+ subgraph Hub["🛡️ Synapse Hub — Bộ Linter & 10 Cổng Chất Lượng DoD"]
40
40
  direction LR
41
41
  Linter["🔍 <b>Cú Pháp Tĩnh AST</b><br/>• Bắt test 0-assert & pass ảo<br/>• Loại bỏ hoàn toàn sleep cố định<br/>• Ngăn nuốt ngoại lệ try-catch"]
42
42
  --> CleanPOM["🏛️ <b>Chuẩn Clean POM</b><br/>• Cấm raw XPath/CSS trong script<br/>• Đóng gói 100% vào BasePage<br/>• Chuẩn hóa Flat Architecture"]
43
43
  --> Mutator["🧬 <b>Micro-Mutation</b><br/>• Bơm đột biến vào câu assert<br/>• Bắt buộc Kill Score &gt;= 80%<br/>• Diệt sạch test assertion yếu"]
44
- --> Security["🔒 <b>Bảo Mật & Bản Quyền</b><br/>• Quét sạch token/mật khẩu<br/>• Chặn leak biến môi trường<br/>• Giữ bản quyền Thế Vị @TeeVee998"]
44
+ --> Security["🔒 <b>Bảo Mật & Bản Quyền</b><br/>• Quét sạch token/mật khẩu<br/>• Chặn leak biến môi trường<br/>• Giữ bản quyền Thế Vị @TeeVee98"]
45
45
  end
46
46
 
47
47
  subgraph Outputs["3. Đầu Ra Đã Kiểm Định"]
@@ -52,7 +52,7 @@ flowchart LR
52
52
  end
53
53
 
54
54
  Raw ==>|Nạp vào kiểm định| Linter
55
- Security ==>|Đạt 11/11 Cổng DoD| Pass
55
+ Security ==>|Đạt 10/10 Cổng DoD| Pass
56
56
  Security -.->|Phát hiện lỗi CI| Distill
57
57
  Security -.->|Vi phạm chất lượng| Reject
58
58
 
@@ -81,7 +81,7 @@ npx synapse-hub setup --target /duong-dan/toi/du-an-test
81
81
  # 3. Quét lỗi test pass ảo & sleep cứng ngay lập tức:
82
82
  npx synapse-hub lint ./tests
83
83
 
84
- # 4. Kiểm định 11 Cổng Chất Lượng DoD trước khi đẩy code:
84
+ # 4. Kiểm định 10 Cổng Chất Lượng DoD trước khi đẩy code:
85
85
  npx synapse-hub verify
86
86
  ```
87
87
 
@@ -99,7 +99,7 @@ npx synapse-hub verify
99
99
  # Bắt test pass ảo, sleep cố định, try-catch nuốt lỗi (đa ngôn ngữ TS/JS, Python, Groovy):
100
100
  synapse-hub lint ./tests
101
101
 
102
- # Chạy toàn diện 11 Cổng Kiểm Định DoD (Definition of Done):
102
+ # Chạy toàn diện 10 Cổng Kiểm Định DoD (Definition of Done):
103
103
  synapse-hub verify
104
104
 
105
105
  # Chẩn đoán và xuất báo cáo sức khỏe dự án (PROJECT_HEALTH_REPORT.md):
@@ -117,11 +117,10 @@ synapse-hub mutate ./tests
117
117
 
118
118
  ---
119
119
 
120
- ## 🛡️ 11 Cổng Kiểm Định Chất Lượng (DoD Gates)
120
+ ## 🛡️ 10 Cổng Kiểm Định Chất Lượng (DoD Gates)
121
121
 
122
- Mọi thay đổi mã nguồn kiểm thử đều được kiểm chứng qua 11 Cổng Chất Lượng trước khi merge PR:
122
+ Mọi thay đổi mã nguồn kiểm thử đều được kiểm chứng qua 10 Cổng Chất Lượng trước khi merge PR:
123
123
 
124
- - **Gate 0:** Bảo Toàn Tác Quyền & MIT License Provenance
125
124
  - **Gate 1:** Mã Hóa Chuẩn 100% UTF-8 No BOM (Zero byte rác)
126
125
  - **Gate 2:** Đường Dẫn Linh Hoạt (Zero hardcoded absolute paths)
127
126
  - **Gate 3:** Kiến Trúc Clean POM (Flat Architecture) (Zero locator trong test script)
@@ -133,7 +132,7 @@ Mọi thay đổi mã nguồn kiểm thử đều được kiểm chứng qua 11
133
132
  - **Gate 9:** Điều Phối Kỹ Năng & Ngăn Xung Đột (Similarity $< 0.75$)
134
133
  - **Gate 10:** Kiểm Soát Hiệu Năng & SLA Sentinel (P95 $\le$ 500ms, Error Rate $\le$ 1.0%)
135
134
 
136
- *(Xem chi tiết tiêu chuẩn, mã lỗi và cách khắc phục tại [docs/QUALITY_GATES.md](docs/QUALITY_GATES.md)).*
135
+ *(Động cơ tích hợp sẵn cơ chế kiểm tra ngầm Pre-flight Integrity Guard bảo toàn bản quyền tác giả Thế Vị @TeeVee98 & giấy phép MIT. Xem chi tiết tiêu chuẩn, mã lỗi và cách khắc phục tại [docs/QUALITY_GATES.md](docs/QUALITY_GATES.md)).*
137
136
 
138
137
  ---
139
138
 
@@ -142,7 +141,7 @@ Mọi thay đổi mã nguồn kiểm thử đều được kiểm chứng qua 11
142
141
  ```yaml
143
142
  # GitHub Actions (.github/workflows/verify.yml):
144
143
  - name: Run Synapse Hub Quality Gates
145
- uses: TeeVee998/Synapse-Hub@v2
144
+ uses: TeeVee98/Synapse-Hub@v2
146
145
  with:
147
146
  mode: 'target'
148
147
 
@@ -154,8 +153,8 @@ Mọi thay đổi mã nguồn kiểm thử đều được kiểm chứng qua 11
154
153
  ```yaml
155
154
  # Pre-commit hook (.pre-commit-config.yaml):
156
155
  repos:
157
- - repo: https://github.com/TeeVee998/Synapse-Hub
158
- rev: v3.8.2
156
+ - repo: https://github.com/TeeVee98/Synapse-Hub
157
+ rev: v3.8.4
159
158
  hooks:
160
159
  - id: synapse-lint
161
160
  - id: synapse-verify
@@ -166,7 +165,7 @@ repos:
166
165
  ## 📚 Tài Liệu Kỹ Thuật Chuyên Sâu
167
166
 
168
167
  - 🏛️ **Kiến Trúc & Bảng So Sánh Chi Tiết:** [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
169
- - 🛡️ **Đặc Tả 11 Cổng Chất Lượng (DoD):** [docs/QUALITY_GATES.md](docs/QUALITY_GATES.md)
168
+ - 🛡️ **Đặc Tả 10 Cổng Chất Lượng (DoD):** [docs/QUALITY_GATES.md](docs/QUALITY_GATES.md)
170
169
  - 📖 **Cẩm Nang Tra Cứu Lệnh CLI:** [docs/CLI_REFERENCE.md](docs/CLI_REFERENCE.md)
171
170
  - 🚀 **Hướng Dẫn Tích Hợp CI/CD:** [docs/CI_CD_INTEGRATION.md](docs/CI_CD_INTEGRATION.md)
172
171
  - 🤝 **Hướng Dẫn Đóng Góp:** [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md)
package/action.yml CHANGED
@@ -1,6 +1,6 @@
1
1
  name: "Synapse Hub Quality Sentinel"
2
- description: "Zero-dependency enterprise AI QA gatekeeper: verifies 11 DoD Quality Gates, detects fake-passes, and blocks flakiness in CI."
3
- author: "Thế Vị (@TeeVee998)"
2
+ description: "Zero-dependency enterprise AI QA gatekeeper: verifies 10 DoD Quality Gates, detects fake-passes, and blocks flakiness in CI."
3
+ author: "Thế Vị (@TeeVee98)"
4
4
 
5
5
  inputs:
6
6
  mode:
package/agentskills.json CHANGED
@@ -1,16 +1,16 @@
1
1
  {
2
2
  "$schema": "https://agentskills.io/schema/v1.json",
3
3
  "name": "Synapse-Hub",
4
- "version": "3.8.2",
4
+ "version": "3.8.4",
5
5
  "description": "Enterprise QA & Test Automation AI Skills Ecosystem adhering to Clean POM Flat Architecture.",
6
- "author": "Thế Vị (@TeeVee998)",
7
- "repository": "https://github.com/TeeVee998/Synapse-Hub",
6
+ "author": "Thế Vị (@TeeVee98)",
7
+ "repository": "https://github.com/TeeVee98/Synapse-Hub",
8
8
  "license": "MIT",
9
9
  "skillsRoot": ".agents/skills",
10
10
  "standards": [
11
11
  "Clean-POM-Flat-Architecture",
12
12
  "100%-UTF8-No-BOM",
13
13
  "Truth-Anchor-No-Fake-Pass",
14
- "11-Quality-Gates-DoD"
14
+ "10-Quality-Gates-DoD"
15
15
  ]
16
16
  }
package/bin/agent-qa.js CHANGED
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
- // SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
2
+ // SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
3
3
  // SPDX-License-Identifier: MIT
4
- // Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
4
+ // Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
5
5
 
6
6
  /**
7
7
  * Enterprise Synapse-Hub NPM Launcher
@@ -1,19 +1,19 @@
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
  # Enterprise Synapse-Hub Developer Compose Environment
6
6
  # Enables running quality gates, linting, and health audits against local target test suites
7
7
  # with zero host tool installation.
8
8
 
9
9
  services:
10
- # 1. Primary Quality Gate: 11 Quality Gates DoD Verification
10
+ # 1. Primary Quality Gate: 10 Quality Gates DoD Verification
11
11
  # Usage: docker compose run --rm verify
12
12
  verify:
13
13
  build:
14
14
  context: .
15
15
  dockerfile: Dockerfile
16
- image: ghcr.io/teevee998/synapse-hub:latest
16
+ image: ghcr.io/teevee98/synapse-hub:latest
17
17
  container_name: synapse-qa-verify
18
18
  volumes:
19
19
  - ./target:/workspace/target
@@ -27,7 +27,7 @@ services:
27
27
  # 2. Meta Infer-style AST Defect & Fake-Pass Linter
28
28
  # Usage: docker compose run --rm lint
29
29
  lint:
30
- image: ghcr.io/teevee998/synapse-hub:latest
30
+ image: ghcr.io/teevee98/synapse-hub:latest
31
31
  container_name: synapse-qa-lint
32
32
  volumes:
33
33
  - ./target:/workspace/target
@@ -37,7 +37,7 @@ services:
37
37
  # 3. Comprehensive 5-in-1 Repository Health Audit
38
38
  # Usage: docker compose run --rm analyze
39
39
  analyze:
40
- image: ghcr.io/teevee998/synapse-hub:latest
40
+ image: ghcr.io/teevee98/synapse-hub:latest
41
41
  container_name: synapse-qa-analyze
42
42
  volumes:
43
43
  - ./target:/workspace/target
@@ -48,7 +48,7 @@ services:
48
48
  # 4. Syntactic Micro-Mutation Verification (Kill Score >= 80%)
49
49
  # Usage: docker compose run --rm mutate
50
50
  mutate:
51
- image: ghcr.io/teevee998/synapse-hub:latest
51
+ image: ghcr.io/teevee98/synapse-hub:latest
52
52
  container_name: synapse-qa-mutate
53
53
  volumes:
54
54
  - ./target:/workspace/target
@@ -62,7 +62,7 @@ services:
62
62
  build:
63
63
  context: .
64
64
  dockerfile: Dockerfile
65
- image: ghcr.io/teevee998/synapse-hub:latest
65
+ image: ghcr.io/teevee98/synapse-hub:latest
66
66
  container_name: synapse-qa-shell
67
67
  entrypoint: ["/bin/bash"]
68
68
  command: []
@@ -3,7 +3,7 @@
3
3
  [🇻🇳 Tiếng Việt](ARCHITECTURE.md) | [🇬🇧 English Edition](ARCHITECTURE.en.md)
4
4
 
5
5
  > **Scope:** Enterprise Multi-Agent QA Hub
6
- > **Version:** `3.8.2` | **Status:** Active / Production Standard
6
+ > **Version:** `3.8.4` | **Status:** Active / Production Standard
7
7
 
8
8
  ---
9
9
 
@@ -72,13 +72,14 @@ Test automation scripts orchestrated through this Hub enforce strict Clean POM b
72
72
 
73
73
  ---
74
74
 
75
- ## 4. The 11 Quality Gates Definition-of-Done (DoD)
75
+ ## 4. The 10 Quality Gates Definition-of-Done (DoD)
76
76
 
77
- All automated test code authored, modified, or refactored by AI agents must pass through the deterministic 11 Quality Gates pipeline (`tools/verify_all.py`) prior to committing or merging:
77
+ All automated test code authored, modified, or refactored by AI agents must pass through the deterministic 10 Quality Gates pipeline (`tools/verify_all.py`) prior to committing or merging:
78
+
79
+ > **Pre-flight Engine Integrity Guard:** Synapse Hub automatically executes a silent pre-flight engine verification check (`tools/author_integrity.py`) to safeguard original author attribution for **Thế Vị (@TeeVee98)** and MIT license compliance before evaluating the 10 Quality Gates.
78
80
 
79
81
  | Gate | Title | Verifier Tool | Strict Acceptance Criteria |
80
82
  | :---: | :--- | :--- | :--- |
81
- | **Gate 0** | **Author Attribution & MIT Provenance** | `author_integrity.py` | Validates immutable MIT license and attribution to original author Thế Vị (@TeeVee998). |
82
83
  | **Gate 1** | **UTF-8 No BOM Clean Encoding** | `verify_all.py` | Scans 100% of repository files; zero BOM bytes (`0xEF, 0xBB, 0xBF`) and zero mojibake errors. |
83
84
  | **Gate 2** | **Path Portability** | `verify_all.py` | Rejects workstation-specific absolute paths (`/Users/...`, `C:\...`); mandates root-relative resolution. |
84
85
  | **Gate 3** | **Clean POM Flat Architecture** | `verify_all.py` | Enforces 100% locator encapsulation in Page Classes; strictly prohibits raw XPaths in test scripts. |
@@ -112,7 +113,7 @@ The Hub equips 9 specialized subagents with scoped tool and skill permissions:
112
113
  | **`test-runner`** | Headless CLI functional test execution & CI | `katalon-cli-runner`, `e2e-testing-patterns`, `flaky-test-sentinel-and-quarantine`, `bats-testing-patterns`, `github-actions-templates` | `matrix_sharder.py`, `distill_log.py`, `pinpoint_failure.py`, `flaky_detector.py`, `reversible_sandbox.py`, `db_sandbox.py`, `generate_allure_report.py`, `generate_test_reports.py` |
113
114
  | **`perf-engineer`** | Performance, load testing (k6/JMeter/Locust) & APM telemetry profiling | `backend-load-and-stress-patterns`, `web-vitals-and-performance-profiler`, `synthetic-test-data-generator`, `db-state-verifier-and-seeder`, `debug-optimize-lcp`, `memory-leak-debugging` | `generate_jmx_plan.py`, `jtl_analyzer.py`, `telemetry_correlator.py`, `distill_log.py`, `safety_firewall.py`, `reversible_sandbox.py` |
114
115
  | **`failure-analyst`**| Visual & XML error autopsy | `failure-autopsy-and-healing`, `self-healing-locator`, `file-and-report-validator`, `systematic-debugging`, `agentless-qa-repair` | `auto_heal.py`, `heal_pr_automator.py`, `pinpoint_failure.py`, `cache_resolver.py`, `auto_heal_reflexion.py`, `agentless_patcher.py`, `heuristic_locator_matcher.py`, `telemetry_correlator.py` |
115
- | **`quality-gatekeeper`**| 11 Gates DoD & Fake-Pass Sentinel | `antigravity-test-sentinel`, `code-refactoring-refactor-clean`, `wcag-audit-patterns`, `web-vitals-and-performance-profiler`, `security-dast-sentinel`, `lean-impact-scoreboard`, `web-agent-gym-benchmarking` | `verify_all.py`, `infer_linter.py`, `micro_mutator.py`, `trace_data_flow.py`, `skill_collision_guard.py`, `textgrad_mutation_optimizer.py`, `skillspector.py`, `author_integrity.py`, `browsergym_eval.py` |
116
+ | **`quality-gatekeeper`**| 10 Gates DoD & Fake-Pass Sentinel | `antigravity-test-sentinel`, `code-refactoring-refactor-clean`, `wcag-audit-patterns`, `web-vitals-and-performance-profiler`, `security-dast-sentinel`, `lean-impact-scoreboard`, `web-agent-gym-benchmarking` | `verify_all.py`, `infer_linter.py`, `micro_mutator.py`, `trace_data_flow.py`, `skill_collision_guard.py`, `textgrad_mutation_optimizer.py`, `skillspector.py`, `author_integrity.py`, `browsergym_eval.py` |
116
117
 
117
118
  ### 5.1 Standalone CLI Utilities & Hub Infrastructure Tools (Non-Persona Scoped)
118
119
 
@@ -3,8 +3,8 @@
3
3
  [🇻🇳 Tiếng Việt](ARCHITECTURE.md) | [🇬🇧 English Edition](ARCHITECTURE.en.md)
4
4
 
5
5
  > **Phạm vi:** Enterprise Multi-Agent QA Hub
6
- > **Version:** `3.8.2` | **Trạng thái:** Hoạt động / Tiêu chuẩn Sản xuất
7
- > **Tác giả:** Thế Vị (@TeeVee998) | **Giấy phép:** MIT License
6
+ > **Version:** `3.8.4` | **Trạng thái:** Hoạt động / Tiêu chuẩn Sản xuất
7
+ > **Tác giả:** Thế Vị (@TeeVee98) | **Giấy phép:** MIT License
8
8
 
9
9
  ---
10
10
 
@@ -73,13 +73,14 @@ Toàn bộ script kiểm thử do AI viết hoặc refactor đều phải tuân
73
73
 
74
74
  ---
75
75
 
76
- ## 4. 11 Cổng Chất Lượng Bắt Buộc Khi Hoàn Thành (11 DoD Quality Gates)
76
+ ## 4. 10 Cổng Chất Lượng Bắt Buộc Khi Hoàn Thành (10 DoD Quality Gates)
77
77
 
78
- Trước khi commit code hoặc merge Pull Request, toàn bộ mã kiểm thử bắt buộc phải vượt qua 11 Cổng Kiểm Định (`tools/verify_all.py`):
78
+ Trước khi commit code hoặc merge Pull Request, toàn bộ mã kiểm thử bắt buộc phải vượt qua 10 Cổng Kiểm Định (`tools/verify_all.py`):
79
+
80
+ > **Tiền kiểm tra bảo vệ tác quyền (Pre-flight Engine Integrity Guard):** Động cơ tự động kích hoạt kiểm tra ngầm `tools/author_integrity.py` trước khi chạy các gate để bảo toàn bản quyền tác giả **Thế Vị (@TeeVee98)** và tuân thủ giấy phép MIT.
79
81
 
80
82
  | Cổng | Tên Cổng | Công Cụ Kiểm Tra | Tiêu Chuẩn Vượt Qua (DoD) |
81
83
  | :---: | :--- | :--- | :--- |
82
- | **Gate 0** | **Bảo Toàn Tác Quyền & MIT Provenance** | `author_integrity.py` | Bảo toàn giấy phép MIT và quyền tác giả gốc của Thế Vị (@TeeVee998). |
83
84
  | **Gate 1** | **Chuẩn Mã Hóa UTF-8 No BOM** | `verify_all.py` | 100% file không chứa ký tự BOM rác (`0xEF, 0xBB, 0xBF`), không vỡ font trên Linux/CI. |
84
85
  | **Gate 2** | **Đường Dẫn Linh Hoạt (Path Portability)** | `verify_all.py` | Cấm hardcode đường dẫn máy cá nhân (`/Users/...`, `C:\...`); bắt buộc dùng path tương đối. |
85
86
  | **Gate 3** | **Kiến Trúc Clean POM (Flat Architecture)** | `verify_all.py` | 100% selector nằm trong Page Class; cấm triệt để selector thô trong file test. |
@@ -113,7 +114,7 @@ Hệ thống điều phối 9 subagent chuyên biệt với quyền hạn công
113
114
  | **`test-runner`** | Chạy test chức năng headless qua CLI và CI | `katalon-cli-runner`, `e2e-testing-patterns`, `flaky-test-sentinel-and-quarantine`, `bats-testing-patterns`, `github-actions-templates` | `matrix_sharder.py`, `distill_log.py`, `pinpoint_failure.py`, `flaky_detector.py`, `reversible_sandbox.py`, `db_sandbox.py`, `generate_allure_report.py`, `generate_test_reports.py` |
114
115
  | **`perf-engineer`** | Chuyên trách kiểm thử hiệu năng, tải k6/JMeter/Locust & APM profiling | `backend-load-and-stress-patterns`, `web-vitals-and-performance-profiler`, `synthetic-test-data-generator`, `db-state-verifier-and-seeder`, `debug-optimize-lcp`, `memory-leak-debugging` | `generate_jmx_plan.py`, `jtl_analyzer.py`, `telemetry_correlator.py`, `distill_log.py`, `safety_firewall.py`, `reversible_sandbox.py` |
115
116
  | **`failure-analyst`**| Khám nghiệm lỗi qua log, ảnh chụp & JUnit XML | `failure-autopsy-and-healing`, `self-healing-locator`, `file-and-report-validator`, `systematic-debugging`, `agentless-qa-repair` | `auto_heal.py`, `heal_pr_automator.py`, `pinpoint_failure.py`, `cache_resolver.py`, `auto_heal_reflexion.py`, `agentless_patcher.py`, `heuristic_locator_matcher.py`, `telemetry_correlator.py` |
116
- | **`quality-gatekeeper`**| Gác 11 Cổng DoD & triệt tiêu test pass ảo | `antigravity-test-sentinel`, `code-refactoring-refactor-clean`, `wcag-audit-patterns`, `web-vitals-and-performance-profiler`, `security-dast-sentinel`, `lean-impact-scoreboard`, `web-agent-gym-benchmarking` | `verify_all.py`, `infer_linter.py`, `micro_mutator.py`, `trace_data_flow.py`, `skill_collision_guard.py`, `textgrad_mutation_optimizer.py`, `skillspector.py`, `author_integrity.py`, `browsergym_eval.py` |
117
+ | **`quality-gatekeeper`**| Gác 10 Cổng DoD & triệt tiêu test pass ảo | `antigravity-test-sentinel`, `code-refactoring-refactor-clean`, `wcag-audit-patterns`, `web-vitals-and-performance-profiler`, `security-dast-sentinel`, `lean-impact-scoreboard`, `web-agent-gym-benchmarking` | `verify_all.py`, `infer_linter.py`, `micro_mutator.py`, `trace_data_flow.py`, `skill_collision_guard.py`, `textgrad_mutation_optimizer.py`, `skillspector.py`, `author_integrity.py`, `browsergym_eval.py` |
117
118
 
118
119
  ### 5.1 Các Tiện Ích Dùng Trực Tiếp (Không Cần Phân Quyền Subagent)
119
120
 
@@ -23,7 +23,7 @@ on:
23
23
 
24
24
  jobs:
25
25
  quality-gate:
26
- name: 11 Quality Gates DoD Verification
26
+ name: 10 Quality Gates DoD Verification
27
27
  runs-on: ubuntu-latest
28
28
  steps:
29
29
  - name: Checkout Project Source
@@ -37,7 +37,7 @@ jobs:
37
37
  with:
38
38
  python-version: '3.12'
39
39
 
40
- - name: Verify 11 Quality Gates
40
+ - name: Verify 10 Quality Gates
41
41
  run: npx synapse-hub verify
42
42
  ```
43
43
 
@@ -62,7 +62,7 @@ synapse-qa-gate:
62
62
 
63
63
  For zero-dependency CI/CD execution across air-gapped environments, Kubernetes, OpenShift, GitLab Runners, and Jenkins, use the official **Synapse-Hub All-in-One Container Image**:
64
64
 
65
- - **Registry Image**: `ghcr.io/teevee998/synapse-hub:latest`
65
+ - **Registry Image**: `ghcr.io/teevee98/synapse-hub:latest`
66
66
  - **Bundled Runtimes**: Python 3.12, Node.js 20, OpenJDK Headless, Playwright/Chromium dependencies, Git, Bash.
67
67
 
68
68
  ### A. Standalone 1-Line Docker Execution
@@ -70,14 +70,14 @@ For zero-dependency CI/CD execution across air-gapped environments, Kubernetes,
70
70
  Mount your target test repository into `/workspace` and execute any Synapse Hub quality gate:
71
71
 
72
72
  ```bash
73
- # Run 11 Quality Gates DoD Verification
74
- docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub verify
73
+ # Run 10 Quality Gates DoD Verification
74
+ docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub verify
75
75
 
76
76
  # Run Meta Infer-style AST Defect & Fake-Pass Linter
77
- docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub lint
77
+ docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub lint
78
78
 
79
79
  # Run Comprehensive 5-in-1 Repository Health Audit
80
- docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub analyze
80
+ docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub analyze
81
81
  ```
82
82
 
83
83
  ### B. GitLab CI (`.gitlab-ci.yml`) via Docker
@@ -86,7 +86,7 @@ docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub analyze
86
86
  synapse-docker-gate:
87
87
  stage: test
88
88
  image:
89
- name: ghcr.io/teevee998/synapse-hub:latest
89
+ name: ghcr.io/teevee98/synapse-hub:latest
90
90
  entrypoint: [""]
91
91
  script:
92
92
  - synapse-hub verify
@@ -101,7 +101,7 @@ synapse-docker-gate:
101
101
  pipeline {
102
102
  agent {
103
103
  docker {
104
- image 'ghcr.io/teevee998/synapse-hub:latest'
104
+ image 'ghcr.io/teevee98/synapse-hub:latest'
105
105
  args '-v ${WORKSPACE}:/workspace'
106
106
  }
107
107
  }
@@ -120,7 +120,7 @@ pipeline {
120
120
  Mount your local test project into `./target` and verify with zero host toolchain requirements:
121
121
 
122
122
  ```bash
123
- # Run 11 Quality Gates DoD Verification
123
+ # Run 10 Quality Gates DoD Verification
124
124
  docker compose run --rm verify
125
125
 
126
126
  # Run AST defect scanner
@@ -138,7 +138,7 @@ If your enterprise network restricts public NPM registry access, mount `Synapse-
138
138
 
139
139
  ```bash
140
140
  # Add submodule into target project
141
- git submodule add https://github.com/TeeVee998/Synapse-Hub.git .synapse-hub
141
+ git submodule add https://github.com/TeeVee98/Synapse-Hub.git .synapse-hub
142
142
  ```
143
143
 
144
144
  In your CI pipeline:
@@ -154,7 +154,7 @@ python .synapse-hub/tools/verify_all.py
154
154
  Target runners with Python 3.9+ can install `synapse-hub` directly from git:
155
155
 
156
156
  ```bash
157
- pip install git+https://github.com/TeeVee998/Synapse-Hub.git
157
+ pip install git+https://github.com/TeeVee98/Synapse-Hub.git
158
158
  agent-qa verify
159
159
  ```
160
160
 
@@ -164,7 +164,7 @@ agent-qa verify
164
164
 
165
165
  | NPX Command | Docker Command | Purpose | SLA / Exit Code |
166
166
  | :--- | :--- | :--- | :--- |
167
- | `npx synapse-hub verify` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub verify` | Executes all 11 Quality Gates DoD | Exits `0` if all PASS; non-zero if any FAIL. |
168
- | `npx synapse-hub lint` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub lint` | Meta Infer-style static defect & fake-pass scan | Fails if 0-assert tests or empty catches exist. |
169
- | `npx synapse-hub mutate --min-score 80` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub mutate --min-score 80` | Syntactic Micro-Mutation verification | Fails if test assertion score < 80%. |
170
- | `npx synapse-hub analyze` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub analyze` | Comprehensive 5-in-1 health audit | Outputs health score and JSON/Markdown artifacts. |
167
+ | `npx synapse-hub verify` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub verify` | Executes all 10 Quality Gates DoD | Exits `0` if all PASS; non-zero if any FAIL. |
168
+ | `npx synapse-hub lint` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub lint` | Meta Infer-style static defect & fake-pass scan | Fails if 0-assert tests or empty catches exist. |
169
+ | `npx synapse-hub mutate --min-score 80` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub mutate --min-score 80` | Syntactic Micro-Mutation verification | Fails if test assertion score < 80%. |
170
+ | `npx synapse-hub analyze` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub analyze` | Comprehensive 5-in-1 health audit | Outputs health score and JSON/Markdown artifacts. |
@@ -23,7 +23,7 @@ on:
23
23
 
24
24
  jobs:
25
25
  quality-gate:
26
- name: Kiểm Định 11 Cổng Chất Lượng DoD
26
+ name: Kiểm Định 10 Cổng Chất Lượng DoD
27
27
  runs-on: ubuntu-latest
28
28
  steps:
29
29
  - name: Checkout Mã Nguồn Dự Án
@@ -37,7 +37,7 @@ jobs:
37
37
  with:
38
38
  python-version: '3.12'
39
39
 
40
- - name: Chạy Kiểm Định 11 Cổng Chất Lượng
40
+ - name: Chạy Kiểm Định 10 Cổng Chất Lượng
41
41
  run: npx synapse-hub verify
42
42
  ```
43
43
 
@@ -62,7 +62,7 @@ synapse-qa-gate:
62
62
 
63
63
  Với các môi trường runner cô lập, Kubernetes, OpenShift, GitLab Runner hoặc Jenkins không muốn cài đặt công cụ lên máy chủ host, hãy sử dụng **Synapse-Hub All-in-One Container Image** chính thức:
64
64
 
65
- - **Địa chỉ Registry**: `ghcr.io/teevee998/synapse-hub:latest`
65
+ - **Địa chỉ Registry**: `ghcr.io/teevee98/synapse-hub:latest`
66
66
  - **Môi trường tích hợp sẵn**: Python 3.12, Node.js 20, OpenJDK Headless, Chromium Headless và toàn bộ thư viện Playwright, Git, Bash.
67
67
 
68
68
  ### A. Chạy Trực Tiếp 1 Dòng Lệnh Với Docker
@@ -70,14 +70,14 @@ Với các môi trường runner cô lập, Kubernetes, OpenShift, GitLab Runner
70
70
  Gắn thư mục dự án test của bạn vào `/workspace` và gọi trực tiếp các cổng kiểm định chất lượng:
71
71
 
72
72
  ```bash
73
- # Kiểm định 11 Cổng Chất Lượng DoD
74
- docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub verify
73
+ # Kiểm định 10 Cổng Chất Lượng DoD
74
+ docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub verify
75
75
 
76
76
  # Quét lỗi tĩnh Meta Infer-style và test pass ảo
77
- docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub lint
77
+ docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub lint
78
78
 
79
79
  # Báo cáo kiểm toán sức khỏe dự án 5-trong-1
80
- docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub analyze
80
+ docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub analyze
81
81
  ```
82
82
 
83
83
  ### B. Đường Ống GitLab CI (`.gitlab-ci.yml`) Dùng Docker
@@ -86,7 +86,7 @@ docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub analyze
86
86
  synapse-docker-gate:
87
87
  stage: test
88
88
  image:
89
- name: ghcr.io/teevee998/synapse-hub:latest
89
+ name: ghcr.io/teevee98/synapse-hub:latest
90
90
  entrypoint: [""]
91
91
  script:
92
92
  - synapse-hub verify
@@ -101,7 +101,7 @@ synapse-docker-gate:
101
101
  pipeline {
102
102
  agent {
103
103
  docker {
104
- image 'ghcr.io/teevee998/synapse-hub:latest'
104
+ image 'ghcr.io/teevee98/synapse-hub:latest'
105
105
  args '-v ${WORKSPACE}:/workspace'
106
106
  }
107
107
  }
@@ -120,7 +120,7 @@ pipeline {
120
120
  Gắn thư mục dự án test vào `./target` và chạy kiểm tra tức thì:
121
121
 
122
122
  ```bash
123
- # Chạy kiểm định 11 Cổng Chất Lượng DoD
123
+ # Chạy kiểm định 10 Cổng Chất Lượng DoD
124
124
  docker compose run --rm verify
125
125
 
126
126
  # Chạy linter kiểm tra lỗi tĩnh
@@ -138,7 +138,7 @@ Nếu hệ thống mạng nội bộ công ty bị chặn truy cập ra ngoài i
138
138
 
139
139
  ```bash
140
140
  # Thêm submodule vào thư mục dự án test
141
- git submodule add https://github.com/TeeVee998/Synapse-Hub.git .synapse-hub
141
+ git submodule add https://github.com/TeeVee98/Synapse-Hub.git .synapse-hub
142
142
  ```
143
143
 
144
144
  Trong file cấu hình pipeline CI:
@@ -154,7 +154,7 @@ python .synapse-hub/tools/verify_all.py
154
154
  Với các runner CI đã có sẵn môi trường Python 3.10+, bạn có thể cài đặt `synapse-hub` trực tiếp từ Git repository:
155
155
 
156
156
  ```bash
157
- pip install git+https://github.com/TeeVee998/Synapse-Hub.git
157
+ pip install git+https://github.com/TeeVee98/Synapse-Hub.git
158
158
  agent-qa verify
159
159
  ```
160
160
 
@@ -164,7 +164,7 @@ agent-qa verify
164
164
 
165
165
  | Lệnh NPX | Lệnh Docker Container | Mục Đích | Điều Kiện Vượt Qua / Mã Thoát |
166
166
  | :--- | :--- | :--- | :--- |
167
- | `npx synapse-hub verify` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub verify` | Chạy toàn diện 11 Cổng Chất Lượng DoD | Trả về `0` nếu toàn bộ PASS; báo lỗi khác 0 nếu có bất kỳ cổng nào FAIL. |
168
- | `npx synapse-hub lint` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub lint` | Bắt lỗi tĩnh Meta Infer-style và test pass ảo | Fail ngay nếu có test 0 câu assert hoặc try-catch nuốt lỗi. |
169
- | `npx synapse-hub mutate --min-score 80` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub mutate --min-score 80` | Kiểm tra độ nhạy của các câu assert bằng Micro-Mutation | Fail nếu điểm diệt đột biến của test < 80%. |
170
- | `npx synapse-hub analyze` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee998/synapse-hub analyze` | Báo cáo kiểm toán sức khỏe dự án 5-trong-1 | Xuất điểm đánh giá và file báo cáo JSON/Markdown cho team. |
167
+ | `npx synapse-hub verify` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub verify` | Chạy toàn diện 10 Cổng Chất Lượng DoD | Trả về `0` nếu toàn bộ PASS; báo lỗi khác 0 nếu có bất kỳ cổng nào FAIL. |
168
+ | `npx synapse-hub lint` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub lint` | Bắt lỗi tĩnh Meta Infer-style và test pass ảo | Fail ngay nếu có test 0 câu assert hoặc try-catch nuốt lỗi. |
169
+ | `npx synapse-hub mutate --min-score 80` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub mutate --min-score 80` | Kiểm tra độ nhạy của các câu assert bằng Micro-Mutation | Fail nếu điểm diệt đột biến của test < 80%. |
170
+ | `npx synapse-hub analyze` | `docker run --rm -v $(pwd):/workspace ghcr.io/teevee98/synapse-hub analyze` | Báo cáo kiểm toán sức khỏe dự án 5-trong-1 | Xuất điểm đánh giá và file báo cáo JSON/Markdown cho team. |
@@ -19,7 +19,7 @@ agent-qa <command> [options]
19
19
  #### A. Core Quality & DoD Gates
20
20
  | Command | Subsystem | Description | Example |
21
21
  | :--- | :--- | :--- | :--- |
22
- | `verify` | Quality Sentinel | Executes all 11 Quality Gates DoD validation | `synapse-hub verify` |
22
+ | `verify` | Quality Sentinel | Executes all 10 Quality Gates DoD validation | `synapse-hub verify` |
23
23
  | `lint` | Static Analysis | Polyglot heuristic & static AST defect scanner with baseline & suppression | `synapse-hub lint ./tests` |
24
24
  | `mutate` | Mutation Sentinel | Syntactic micro-mutator checking assertion sensitivity | `synapse-hub mutate ./tests --min-score 80` |
25
25
  | `watch` | HUD Sentinel | Incremental live file watcher for real-time quality feedback | `synapse-hub watch` |
@@ -94,7 +94,7 @@ agent-qa <command> [options]
94
94
 
95
95
  If running without global package installation, tools can be executed directly via Python:
96
96
 
97
- ### 2.1. Verify 11 Quality Gates (Gate 0 - Gate 10)
97
+ ### 2.1. Verify 10 Quality Gates (Gate 1 - Gate 10)
98
98
  ```bash
99
99
  # Auto-detect mode (default: detects Hub vs Target Test Project)
100
100
  python tools/verify_all.py
@@ -106,7 +106,6 @@ python tools/verify_all.py --mode target # Target automation suite validation
106
106
  - **Operational Modes:**
107
107
  - `--mode hub`: Validates QA Hub assets, skills, tools integrity, zero BOM, path portability, and universal credential security across repository files without requiring target test scripts.
108
108
  - `--mode target`: Enforces target automation suite standards including Clean POM across test scripts and credential encryption.
109
- - **Gate 0:** Author Attribution & Provenance Guard (preserves MIT author notice).
110
109
  - **Gate 1:** 100% UTF-8 No BOM check across all scripts, markdown, and config files.
111
110
  - **Gate 2:** Path Portability (zero absolute host/machine directory paths).
112
111
  - **Gate 3:** Clean POM & Flat Architecture (zero raw XPaths/CSS in test scripts).
@@ -18,10 +18,10 @@ agent-qa <lệnh> [tùy_chọn]
18
18
 
19
19
  ### Danh Mục 53 Lệnh Hỗ Trợ
20
20
 
21
- #### A. Cốt Lõi Kiểm Định & 11 Cổng DoD
21
+ #### A. Cốt Lõi Kiểm Định & 10 Cổng DoD
22
22
  | Lệnh | Nhóm Chức Năng | Mô Tả Thực Tế | Ví Dụ |
23
23
  | :--- | :--- | :--- | :--- |
24
- | `verify` | Gác Cổng DoD | Chạy toàn diện 11 Cổng Chất Lượng trước khi commit/push | `synapse-hub verify` |
24
+ | `verify` | Gác Cổng DoD | Chạy toàn diện 10 Cổng Chất Lượng trước khi commit/push | `synapse-hub verify` |
25
25
  | `lint` | Bắt Lỗi Tĩnh | Quét lỗi tĩnh, bắt test 0-assert, try-catch nuốt lỗi (TS, Python, Groovy) | `synapse-hub lint ./tests` |
26
26
  | `mutate` | Kiểm Thử Đột Biến | Bắn vi đột biến kiểm tra độ nhạy của các câu lệnh assert | `synapse-hub mutate ./tests --min-score 80` |
27
27
  | `watch` | HUD Thời Gian Thực | Tự động quét và báo lỗi ngay khi có file code thay đổi | `synapse-hub watch` |
@@ -87,7 +87,7 @@ agent-qa <lệnh> [tùy_chọn]
87
87
  | `decouple-config`| Tách Biệt Cấu Hình | Tách rời biến môi trường và mật khẩu ra khỏi mã nguồn test | `synapse-hub decouple-config config.groovy` |
88
88
  | `correlate-telemetry` | Đối Chiếu Log Đa Kênh | Khớp nối dấu vết browser trace, HTTP log và server log khi debug | `synapse-hub correlate-telemetry --trace trace.zip` |
89
89
  | `dashboard` | Bảng Điều Khiển HUD | Tạo bảng điều khiển HTML5 tổng quan sức khỏe dự án test | `synapse-hub dashboard` |
90
- | `analyze` | Kiểm Toán Toàn Diện | Báo cáo sức khỏe dự án 5-trong-1 và kiểm định 11 cổng DoD | `synapse-hub analyze` |
90
+ | `analyze` | Kiểm Toán Toàn Diện | Báo cáo sức khỏe dự án 5-trong-1 và kiểm định 10 Cổng DoD | `synapse-hub analyze` |
91
91
  | `mcp-serve` | Khởi Chạy Máy Chủ MCP | Chạy máy chủ Model Context Protocol (MCP) qua giao thức stdio | `synapse-hub mcp-serve` |
92
92
 
93
93
  ---
@@ -96,7 +96,7 @@ agent-qa <lệnh> [tùy_chọn]
96
96
 
97
97
  Nếu bạn không muốn cài đặt package toàn cục, toàn bộ công cụ đều có thể chạy trực tiếp bằng Python:
98
98
 
99
- ### 2.1. Chạy 11 Cổng Kiểm Định DoD (Gate 0 - Gate 10)
99
+ ### 2.1. Chạy 10 Cổng Kiểm Định DoD (Gate 1 - Gate 10)
100
100
  ```bash
101
101
  # Tự động nhận diện chế độ (mặc định: tự phát hiện Hub hoặc Dự án test con)
102
102
  python tools/verify_all.py
@@ -108,7 +108,6 @@ python tools/verify_all.py --mode target # Kiểm định dự án kiểm th
108
108
  - **Ý Nghĩa Các Chế Độ:**
109
109
  - `--mode hub`: Kiểm tra tài nguyên của Hub, tính toàn vẹn của các kỹ năng, công cụ, không byte BOM rác, đường dẫn linh hoạt và bảo mật secret trên toàn bộ repo mà không bắt buộc có file test nghiệp vụ.
110
110
  - `--mode target`: Bắt buộc tuân thủ chuẩn kiểm thử cho dự án thực tế: 100% selector nằm trong Page Class (Clean POM) và không lộ mật khẩu.
111
- - **Gate 0:** Bảo Toàn Tác Quyền & Giấy Phép MIT (giữ thông báo bản quyền của Thế Vị @TeeVee998).
112
111
  - **Gate 1:** Quét 100% file không chứa ký tự UTF-8 BOM rác.
113
112
  - **Gate 2:** Đường Dẫn Linh Hoạt (không hardcode path máy cá nhân).
114
113
  - **Gate 3:** Kiến Trúc Clean POM (Flat Architecture) (không chứa XPath/CSS selector trong file test).
@@ -31,7 +31,7 @@ Before submitting a pull request or committing changes:
31
31
  # 1. Run regression test suite (770+ tests)
32
32
  pytest tests -q
33
33
 
34
- # 2. Verify all 11 DoD Quality Gates (Gate 0–10)
34
+ # 2. Verify all 10 DoD Quality Gates (Gate 1–10)
35
35
  python3 tools/verify_all.py
36
36
 
37
37
  # 3. Test documentation and entity references integrity
@@ -31,7 +31,7 @@ Trước khi mở PR hoặc đẩy code lên nhánh `develop`:
31
31
  # 1. Chạy toàn bộ 260+ bài unit test
32
32
  python3 -m unittest discover tests
33
33
 
34
- # 2. Kiểm định toàn vẹn 11 Cổng Chất Lượng DoD (Gate 0–10)
34
+ # 2. Kiểm định toàn vẹn 10 Cổng Chất Lượng DoD (Gate 1–10)
35
35
  python3 tools/verify_all.py
36
36
 
37
37
  # 3. Kiểm tra tính toàn vẹn của tài liệu và công cụ
@@ -348,10 +348,9 @@ Teams using k6 or Locust are locked out of the automated SLA quality gate.
348
348
  The distiller lacks regex patterns for JMeter CLI summaries (`summary + 1500 in 00:00:10 = 150.0/s Avg: 120 Min: 80 Max: 450 Err: 0 (0.00%)`), k6 terminal outputs (`✓ status is 200`, `http_req_duration: p(95)=420ms`), and Locust terminal tables. Piping load test logs into `distill_log.py` results in either suppressed performance data or unparsed output blocks.
349
349
 
350
350
  ##### 4. Decoupling from Core Definition of Done & CI Templates
351
- - **Omission from `tools/verify_all.py`:** `verify_all.py` (lines 11–22) enforces Gates 0 through 9:
351
+ - **Omission from `tools/verify_all.py`:** `verify_all.py` enforces 10 Quality Gates with Pre-flight Integrity:
352
352
  ```python
353
- # Gates 0-9 in tools/verify_all.py:
354
- # Gate 0: Author Attribution & Copyright
353
+ # Pre-flight: Author Attribution & Copyright
355
354
  # Gate 1: 100% UTF-8 No BOM
356
355
  # Gate 2: Path Portability
357
356
  # Gate 3: Clean POM & Flat Architecture
@@ -1,7 +1,7 @@
1
1
  # 3rd-Party Plugin Development Guide — Synapse Hub
2
2
 
3
3
  > **Specification Version:** 2.2.4
4
- > **Hub Core Provenance:** Thế Vị (@TeeVee998) — [Synapse Hub](https://github.com/TeeVee998/Synapse-Hub)
4
+ > **Hub Core Provenance:** Thế Vị (@TeeVee98) — [Synapse Hub](https://github.com/TeeVee98/Synapse-Hub)
5
5
  > **Reference Example:** [examples/plugins/sample-custom-plugin](../examples/plugins/sample-custom-plugin)
6
6
 
7
7
  ---