@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.
- package/.agents/agents/orchestrator.md +1 -1
- package/.agents/agents/quality-gatekeeper.md +3 -3
- package/.agents/rules/author-integrity-guard.md +5 -5
- package/.agents/rules/mandatory-playwright-live.md +1 -1
- package/.agents/rules/skill-precedence.md +1 -1
- package/.agents/rules/systematic-debugging.md +1 -1
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +3 -3
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +1 -1
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +1 -1
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +1 -1
- package/.agents/skills/persistent-planning-files/SKILL.md +1 -1
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +1 -1
- package/.agents/skills/repo-quality-audit/SKILL.md +1 -1
- package/.agents/skills/surgical-coding-principles/SKILL.md +2 -2
- package/.agents/skills/verification-before-completion/SKILL.md +2 -2
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +2 -2
- package/.agents/workflows/verify.md +3 -3
- package/.cursor/rules/synapse-qa.mdc +1 -1
- package/.cursorrules +3 -3
- package/.pre-commit-hooks.yaml +2 -2
- package/.windsurfrules +3 -3
- package/AGENTS.md +3 -3
- package/CLAUDE.md +4 -4
- package/Dockerfile +5 -5
- package/README.en.md +16 -17
- package/README.md +16 -17
- package/action.yml +2 -2
- package/agentskills.json +4 -4
- package/bin/agent-qa.js +2 -2
- package/docker-compose.yml +8 -8
- package/docs/ARCHITECTURE.en.md +6 -5
- package/docs/ARCHITECTURE.md +7 -6
- package/docs/CI_CD_INTEGRATION.en.md +16 -16
- package/docs/CI_CD_INTEGRATION.md +16 -16
- package/docs/CLI_REFERENCE.en.md +2 -3
- package/docs/CLI_REFERENCE.md +4 -5
- package/docs/CONTRIBUTING.en.md +1 -1
- package/docs/CONTRIBUTING.md +1 -1
- package/docs/PERFORMANCE_AUDIT_REPORT.md +2 -3
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +1 -1
- package/docs/QUALITY_GATES.en.md +9 -12
- package/docs/QUALITY_GATES.md +10 -13
- package/docs/TOOL_CATALOG.md +1 -1
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +3 -3
- package/docs/research/agent_skill_training_analysis.md +17 -18
- package/docs/schemas/synapse.config.schema.json +0 -1
- package/package.json +5 -5
- package/plugin.json +6 -6
- package/skills_manifest.json +1 -1
- package/synapse.config.json +2 -3
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +2 -2
- package/templates/PROJECT_STATE_TEMPLATE.md +1 -1
- package/templates/ai_bridges/CLAUDE.md +4 -4
- package/templates/ai_bridges/copilot-instructions.md +2 -2
- package/templates/ai_bridges/cursor_synapse_qa.mdc +1 -1
- package/templates/ai_bridges/windsurfrules +3 -3
- package/templates/ci/github-actions-synapse.yml +5 -5
- package/templates/ui/index.html +14 -14
- package/templates/welcome.html.tmpl +29 -34
- package/tools/TOOLS_RUNBOOK.md +7 -7
- package/tools/TOOL_CATALOG.json +1 -1
- package/tools/__init__.py +5 -5
- package/tools/_openapi_parser.py +2 -2
- package/tools/agentless_patcher.py +2 -2
- package/tools/analyze_project.py +10 -6
- package/tools/author_integrity.py +19 -13
- package/tools/auto_heal_reflexion.py +2 -2
- package/tools/autogen_qa_broker.py +2 -2
- package/tools/benchmark_swarm_context.py +2 -2
- package/tools/browser_helpers.js +2 -2
- package/tools/browsergym_eval.py +2 -2
- package/tools/bump_version.py +2 -2
- package/tools/ci_healing_hook.py +1 -1
- package/tools/cli.py +11 -11
- package/tools/contract_validator.py +2 -2
- package/tools/core/adapters.py +2 -2
- package/tools/core/circuit_breaker.py +2 -2
- package/tools/core/cli_runtime.py +2 -2
- package/tools/core/file_lock.py +2 -2
- package/tools/core/i18n.py +7 -7
- package/tools/core/memory_bus.py +2 -2
- package/tools/core/process_supervisor.py +2 -2
- package/tools/core/telemetry.py +2 -2
- package/tools/count_tokens.py +1 -1
- package/tools/dashboard_generator.py +31 -47
- package/tools/debt_harvester.py +2 -2
- package/tools/dspy_qa_signatures.py +3 -3
- package/tools/fsm_enforcer.py +5 -5
- package/tools/fsm_middleware.py +2 -2
- package/tools/generate_sbom.py +9 -9
- package/tools/generate_tool_catalog.py +3 -3
- package/tools/gherkin_suite.py +2 -2
- package/tools/goldfish_review.py +2 -2
- package/tools/heal_pr_automator.py +1 -1
- package/tools/hub_publisher.py +12 -12
- package/tools/humanize_linter.py +2 -2
- package/tools/init_config.py +4 -5
- package/tools/interview_story.py +2 -2
- package/tools/jira_sync.py +2 -2
- package/tools/lint_ai_docs.py +2 -2
- package/tools/mcp_docx_server.py +3 -3
- package/tools/mcp_excel_server.py +1 -1
- package/tools/mcp_server.py +5 -4
- package/tools/mipro_assertion_tuner.py +2 -2
- package/tools/openxml_guard.py +2 -2
- package/tools/package_release.py +2 -2
- package/tools/project_state.py +2 -2
- package/tools/qa_event_stream.py +2 -2
- package/tools/reversible_sandbox.py +2 -2
- package/tools/security_coverage_ledger.py +1 -1
- package/tools/security_scanner.py +2 -2
- package/tools/senior_code_review.py +2 -2
- package/tools/skill_collision_guard.py +2 -2
- package/tools/skill_profiles.py +2 -2
- package/tools/skill_vault.py +2 -2
- package/tools/skillspector.py +2 -2
- package/tools/spec_drift_sentinel.py +2 -2
- package/tools/swe_qa_aci.py +2 -2
- package/tools/synapse_observer.py +2 -2
- package/tools/synapse_qa_bench.py +2 -2
- package/tools/sync_agent_rules.py +15 -15
- package/tools/template_excel_exporter.py +2 -2
- package/tools/test_memory_os.py +2 -2
- package/tools/textgrad_mutation_optimizer.py +2 -2
- package/tools/tms_sync_bridge.py +2 -2
- package/tools/tot_exploratory_tester.py +2 -2
- package/tools/trend_analytics.py +2 -2
- package/tools/ui_server.py +6 -6
- package/tools/update_sentinel.py +6 -6
- package/tools/verify_all.py +36 -19
- package/tools/watch_mode.py +2 -2
- 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ị ([@
|
|
9
|
-
> **Phiên bản:** `v3.8.
|
|
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
|
[](https://www.npmjs.com/package/synapse-hub)
|
|
12
12
|
[](https://nodejs.org)
|
|
13
13
|
[](https://python.org)
|
|
14
|
-
[](docs/QUALITY_GATES.md)
|
|
15
15
|
[](#)
|
|
16
|
-
[](https://github.com/
|
|
16
|
+
[](https://github.com/TeeVee98/Synapse-Hub/blob/main/LICENSE)
|
|
17
17
|
[](#)
|
|
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 &
|
|
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 >= 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ị @
|
|
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
|
|
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
|
|
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
|
|
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
|
-
## 🛡️
|
|
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
|
|
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:
|
|
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/
|
|
158
|
-
rev: v3.8.
|
|
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ả
|
|
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
|
|
3
|
-
author: "Thế Vị (@
|
|
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.
|
|
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ị (@
|
|
7
|
-
"repository": "https://github.com/
|
|
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
|
-
"
|
|
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ị (@
|
|
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/
|
|
4
|
+
// Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* Enterprise Synapse-Hub NPM Launcher
|
package/docker-compose.yml
CHANGED
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
# SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@
|
|
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/
|
|
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:
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
65
|
+
image: ghcr.io/teevee98/synapse-hub:latest
|
|
66
66
|
container_name: synapse-qa-shell
|
|
67
67
|
entrypoint: ["/bin/bash"]
|
|
68
68
|
command: []
|
package/docs/ARCHITECTURE.en.md
CHANGED
|
@@ -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.
|
|
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
|
|
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
|
|
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`**|
|
|
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
|
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -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.
|
|
7
|
-
> **Tác giả:** Thế Vị (@
|
|
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.
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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/
|
|
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
|
|
74
|
-
docker run --rm -v $(pwd):/workspace ghcr.io/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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
|
|
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/
|
|
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/
|
|
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/
|
|
168
|
-
| `npx synapse-hub lint` | `docker run --rm -v $(pwd):/workspace ghcr.io/
|
|
169
|
-
| `npx synapse-hub mutate --min-score 80` | `docker run --rm -v $(pwd):/workspace ghcr.io/
|
|
170
|
-
| `npx synapse-hub analyze` | `docker run --rm -v $(pwd):/workspace ghcr.io/
|
|
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
|
|
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
|
|
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/
|
|
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
|
|
74
|
-
docker run --rm -v $(pwd):/workspace ghcr.io/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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
|
|
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/
|
|
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/
|
|
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/
|
|
168
|
-
| `npx synapse-hub lint` | `docker run --rm -v $(pwd):/workspace ghcr.io/
|
|
169
|
-
| `npx synapse-hub mutate --min-score 80` | `docker run --rm -v $(pwd):/workspace ghcr.io/
|
|
170
|
-
| `npx synapse-hub analyze` | `docker run --rm -v $(pwd):/workspace ghcr.io/
|
|
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. |
|
package/docs/CLI_REFERENCE.en.md
CHANGED
|
@@ -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
|
|
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
|
|
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).
|
package/docs/CLI_REFERENCE.md
CHANGED
|
@@ -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 &
|
|
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
|
|
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
|
|
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
|
|
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).
|
package/docs/CONTRIBUTING.en.md
CHANGED
|
@@ -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
|
|
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
|
package/docs/CONTRIBUTING.md
CHANGED
|
@@ -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
|
|
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`
|
|
351
|
+
- **Omission from `tools/verify_all.py`:** `verify_all.py` enforces 10 Quality Gates with Pre-flight Integrity:
|
|
352
352
|
```python
|
|
353
|
-
#
|
|
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ị (@
|
|
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
|
---
|