synapse-hub 2.1.1 → 2.2.1

package/README.md

@@ -4,7 +4,7 @@
 
 > **Bộ não trí tuệ dùng chung và mạng lưới kỹ năng tự hành, tăng cường năng lực cho các trợ lý AI (Google Antigravity, Cursor, Windsurf, Claude Code) trên mọi hệ sinh thái kiểm thử tự động.**  
 > **Tác giả:** Thế Vị ([@TeeVee998](https://github.com/TeeVee998))  
-> **Phiên bản Hub:** `v2.1.1` | **Quy mô:** 27 Kỹ năng chuẩn hóa, 6 Vai trò AI Swarm, 7 Quy tắc cốt lõi, 20+ Công cụ tự động.
+> **Phiên bản Hub:** `v2.2.1` | **Quy mô:** 28 Kỹ năng chuẩn hóa, 6 Vai trò AI Swarm, 7 Quy tắc cốt lõi, 20+ Công cụ tự động.
 
 ---
 
@@ -14,8 +14,8 @@
 
 ```mermaid
 flowchart TD
-    subgraph Hub["🧠 Synapse Hub (Intelligence Core v2.1.1)"]
-        Skills[".agents/skills/ (27 Skills)"]
+    subgraph Hub["🧠 Synapse Hub (Intelligence Core v2.2.1)"]
+        Skills[".agents/skills/ (28 Skills)"]
         Agents[".agents/agents/ (6 Specialized Roles)"]
         Rules[".agents/rules/ (7 Core Rules)"]
         Tools["tools/ (20+ Universal Python Tools)"]
@@ -68,22 +68,38 @@ flowchart TD
 
 ---
 
-## 🚀 2. Cách Sử Dụng (NPM / npx & Workspace Mount)
+## 🚀 2. Hướng Dẫn Bắt Đầu & Tích Hợp (3 Cách Dùng)
 
 [![npm version](https://img.shields.io/npm/v/synapse-hub.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/synapse-hub)
-[![npm downloads](https://img.shields.io/npm/dm/synapse-hub.svg?style=flat-square)](https://www.npmjs.com/package/synapse-hub)
-[![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](https://github.com/TeeVee998/Synapse-Hub/blob/main/package.json)
+[![node version](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org)
+[![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](https://github.com/TeeVee998/Synapse-Hub/blob/main/LICENSE)
 
-### Cách A: Sử dụng tức thì qua NPM Registry (Khuyên dùng)
-Gói chính thức đã được phát hành toàn cầu tại **[npmjs.com/package/synapse-hub](https://www.npmjs.com/package/synapse-hub)**. Bạn có thể sử dụng ngay mà không cần clone mã nguồn:
+---
+
+### ⚡ Khởi Động Siêu Tốc: Đúng 1 Lệnh Duy Nhất Với NPX (All-in-One 🚀)
+*Tất cả trong một: **KHÔNG CẦN clone repo Hub**, **KHÔNG CẦN mở Multi-root workspace**, tự động cấu hình dự án **VÀ tự động bơm thẳng vào Antigravity Global Plugin**.*
 
-#### 1. Thực thi tức thì không cần cài đặt (`npx`):
-Tại thư mục gốc của bất kỳ dự án nào, thực thi trực tiếp:
+Mở terminal ngay tại thư mục **dự án kiểm thử của bạn** và chạy đúng 1 dòng:
 ```bash
-# Khởi tạo tự động 1-Click (sinh PROJECT_AI_GUIDE.md, cài pre-push hook, trích xuất AST repo map)
 npx synapse-hub setup
-
-# Chạy kiểm định 8 Cổng Chất Lượng (DoD Quality Gates)
+```
+👉 **Đúng 1 lệnh này sẽ tự động hoàn tất toàn bộ trong 5 giây:**
+1. 🧠 **Tự động bơm vào Antigravity Global Plugin:** Triển khai Synapse-Hub vào `~/.gemini/config/plugins/synapse-hub`. Kể từ giây phút này, **mọi dự án** mở trên Google Antigravity đều tự động sở hữu toàn bộ 28 Skills và 6 Subagents mà không cần cấu hình thêm!
+2. 🌐 **Triển Khai Cầu Nối Đa IDE & AI (Universal AI Bridges):** Tự động sinh file cấu hình và quy chuẩn cho mọi trợ lý AI khác nhau ngay trong dự án của bạn:
+   - 🖱️ **Cursor:** `.cursor/rules/synapse-qa.mdc` (Tự động kích hoạt khi mở file trong Cursor)
+   - 🤖 **Claude Code:** `CLAUDE.md` (Hướng dẫn quy chuẩn QA, commands và Clean POM)
+   - 🐙 **GitHub Copilot:** `.github/copilot-instructions.md` (Chỉ dẫn hệ thống cho VS Code / JetBrains Copilot)
+   - 🏄 **Windsurf (Cascade):** `.windsurfrules` (Nguyên tắc kiểm thử bắt buộc)
+   *(Mọi thành viên dù dùng Antigravity, Cursor, Claude Code, Copilot hay Windsurf đều chung 1 chuẩn Clean POM, 1 nguyên tắc Truth Anchor chống pass ảo, và 8 Cổng Kiểm Định DoD!)*
+3. 🔍 **Nhận diện Framework:** Tự động phát hiện Playwright TypeScript/JS, Katalon Studio Groovy, Cypress, hoặc Pytest.
+4. 📋 **Sinh Hướng Dẫn Nghiệp Vụ:** Tạo file `PROJECT_AI_GUIDE.md` ngay trong dự án của bạn để AI hiểu sâu kiến trúc và quy chuẩn code.
+5. 🛡️ **Cài Đặt Cổng Gác Git (Pre-Push Hook):** Tự cài `.git/hooks/pre-push` gọi `npx synapse-hub verify` để chặn đứng mã lỗi và lộ mật khẩu trước khi push.
+6. 💾 **Khởi Tạo Bộ Nhớ Kinh Nghiệm (SQLite Cache):** Khởi tạo và nạp giải pháp sửa lỗi UI vào `~/.agent_memory/global_cache.db` (chi phí 0 token).
+7. 🗺️ **Quét AST & Xuất Bản Đồ Hàm:** Tự động phân tích codebase và trích xuất `repo_map.txt` cô đọng.
+
+Sau đó, bạn có thể thực thi kiểm định bất cứ lúc nào:
+```bash
+# Kiểm định 8 Cổng Chất Lượng (DoD Quality Gates)
 npx synapse-hub verify
 
 # Đánh giá sức khỏe toàn diện dự án (5-in-1 Project Health Report)
@@ -92,45 +108,39 @@ npx synapse-hub analyze
 # Quét phát hiện mã giả, assertion rỗng (Fake-Pass AST Sentinel)
 npx synapse-hub lint
 ```
-> 💡 **Mẹo:** Bạn cũng có thể dùng lệnh gọi rút gọn: `npx synapse setup` hoặc `npx synapse verify`.
 
-#### 2. Cài đặt cố định vào dự án (DevDependency):
-```bash
-npm install -D synapse-hub
-```
-Sau đó có thể khai báo vào `scripts` trong file `package.json` của dự án mục tiêu:
-```json
-"scripts": {
-  "qa:verify": "synapse-hub verify",
-  "qa:analyze": "synapse-hub analyze"
-}
+---
+
+### 🥈 Cách 2: Tối Ưu Cho Antigravity — Cài Đặt 1 Lần Thành "Global Plugin"
+*Cài đặt 1 lần duy nhất: Kể từ đó **BẤT KỲ DỰ ÁN NÀO** mở trên Google Antigravity cũng tự động có sẵn toàn bộ 28 Skills và 6 Subagents mà không cần cấu hình thêm.*
+
+#### Bước cài đặt 1-Click:
+```powershell
+# Trên Windows PowerShell:
+./scripts/install_global_plugin.ps1
+
+# Trên macOS / Linux:
+./scripts/install_global_plugin.sh
 ```
 
-#### 3. Cài đặt toàn cục (Global CLI):
-Để sử dụng công cụ ở bất cứ đâu trên máy tính:
+*(Hoặc nếu chưa clone repo, chỉ cần clone thẳng vào thư mục plugin của Antigravity):*
 ```bash
-npm install -g synapse-hub
-
-# Sử dụng trực tiếp:
-synapse-hub verify
-synapse setup
+git clone https://github.com/TeeVee998/Synapse-Hub.git "$HOME/.gemini/config/plugins/synapse-hub"
 ```
 
-### Cách B: Mở phiên làm việc đa thư mục (Multi-Root Workspace)
-Trong IDE (Google Antigravity / VS Code / Cursor):
-1. Mở thư mục dự án mục tiêu của bạn.
-2. Thêm thư mục `Synapse-Hub` vào Workspace (`File` -> `Add Folder to Workspace...`).
-
-### Bước 2: Khởi tạo hướng dẫn dự án (`PROJECT_AI_GUIDE.md`)
-Copy file mẫu từ `templates/PROJECT_AI_GUIDE_TEMPLATE.md` vào thư mục gốc của dự án mục tiêu, đổi tên thành `PROJECT_AI_GUIDE.md` và điền thông tin cụ thể:
-- URL môi trường test/staging.
-- Tài khoản và cơ chế đăng nhập.
-- Cấu trúc thư mục mã nguồn.
-- Lệnh chạy test headless và công nghệ sử dụng.
-- **Dữ liệu tra cứu nhanh:** Khai báo đường dẫn `testcases.json` và `selectors.json` (hoặc đặt biến môi trường `TC_DATA_FILE` / `XPATH_DATA_FILE`) để công cụ `tools/lookup_tc.py` và `tools/lookup_xpath.py` nạp đúng dữ liệu của dự án.
-
-### Bước 3: Cài đặt tự động (One-Click Bootstrap)
-Chạy script cài đặt môi trường và phụ thuộc:
+**Sau khi cài đặt:**
+- Mở Google Antigravity lên, bạn sẽ thấy `synapse-hub` xuất hiện trong danh mục Plugins toàn cục.
+- Mở bất kỳ thư mục dự án nào, AI Agent cũng tự động nắm bắt toàn bộ năng lực kiểm thử của Synapse-Hub!
+
+---
+
+### 🥉 Cách 3: Truyền Thống — Mở Multi-Root Workspace trong IDE
+*Dành cho Core Developers muốn chỉnh sửa, mở rộng hoặc đóng góp phát triển thêm Skills/Tools cho Synapse-Hub.*
+
+1. Mở IDE (Google Antigravity / Cursor / VS Code).
+2. Mở thư mục dự án mục tiêu của bạn (`File -> Open Folder`).
+3. Thêm thư mục `Synapse-Hub` vào Workspace (`File -> Add Folder to Workspace...`).
+4. Chạy script bootstrap môi trường nội bộ:
 ```powershell
 # Windows PowerShell
 ./scripts/install.ps1
@@ -138,15 +148,6 @@ Chạy script cài đặt môi trường và phụ thuộc:
 # Linux / macOS
 ./scripts/setup.sh
 ```
-Script bootstrap sẽ tự động thiết lập `.venv`, cài dependencies, chạy lint kiểm tra 30 skills, và **khởi tạo nạp seed giải pháp ban đầu** cho SQLite Central Agent Memory (`~/.agent_memory/global_cache.db`).
-
-> 💡 **Khởi tạo SQLite Memory trên CI/CD & Docker sạch:**  
-> Trên agent runner CI hoặc container Docker mới tinh, chạy lệnh sau để cấp quyền và khởi tạo bộ nhớ 0-token:
-> ```bash
-> agent-qa heal init
-> # hoặc chạy trực tiếp:
-> python tools/cache_resolver.py init
-> ```
 
 ---
 
@@ -161,11 +162,11 @@ Hub phân chia năng lực rõ ràng cho 6 vai trò Agent, mỗi Agent được
 | **`pom-crafter`** | Kỹ sư Clean POM, kiểm tra API drift, sinh test từ User Story. | `clean-pom-crafter`, `lam-script-generator`, `synthetic-test-data-generator`, `api-spec-to-e2e-matrix`, `file-and-report-validator`, `db-state-verifier-and-seeder` | `tools/generate_tc_from_story.py`, `tools/generate_api_matrix.py`, `tools/api_drift_sentinel.py`, `tools/repo_map.py` |
 | **`test-runner`** | Quản lý chạy test headless CLI, chia tải thời gian chạy trên CI. | `katalon-cli-runner`, `e2e-testing-patterns`, `bats-testing-patterns`, `auth-session-and-cookie-manager`, `flaky-test-sentinel-and-quarantine` | `tools/matrix_sharder.py`, `tools/distill_log.py`, `tools/pinpoint_failure.py`, `tools/flaky_detector.py` |
 | **`failure-analyst`**| Tự động chẩn đoán lỗi, tính điểm tin cậy & tự tạo PR đối soát. | `failure-autopsy-and-healing`, `self-healing-locator`, `file-and-report-validator` | `tools/auto_heal.py`, `tools/heal_pr_automator.py`, `tools/pinpoint_failure.py`, `tools/cache_resolver.py` |
-| **`quality-gatekeeper`**| Gác cổng chất lượng 7 Gates DoD, quét Fake-Pass, bơm mutant. | `antigravity-test-sentinel`, `code-refactoring-refactor-clean`, `wcag-audit-patterns`, `web-vitals-and-performance-profiler`, `db-state-verifier-and-seeder`, `security-dast-sentinel` | `tools/verify_all.py`, `tools/infer_linter.py`, `tools/micro_mutator.py`, `tools/trace_data_flow.py`, `tools/wcag_audit.py`, `tools/lint_ai_docs.py` |
+| **`quality-gatekeeper`**| Gác cổng chất lượng 7 Gates DoD, quét Fake-Pass, bơm mutant. | `antigravity-test-sentinel`, `code-refactoring-refactor-clean`, `wcag-audit-patterns`, `web-vitals-and-performance-profiler`, `db-state-verifier-and-seeder`, `security-dast-sentinel`, `skillspector-security-guard` | `tools/verify_all.py`, `tools/infer_linter.py`, `tools/micro_mutator.py`, `tools/trace_data_flow.py`, `tools/wcag_audit.py`, `tools/lint_ai_docs.py`, `tools/skillspector.py` |
 
 ---
 
-## 📦 4. Danh Mục 27 Kỹ Năng Chuẩn Hóa (.agents/skills/)
+## 📦 4. Danh Mục 28 Kỹ Năng Chuẩn Hóa (.agents/skills/)
 
 | STT | Tên Kỹ Năng (Skill) | Phạm Vi Hoạt Động Cốt Lõi |
 |:---:|---|---|
@@ -196,6 +197,7 @@ Hub phân chia năng lực rõ ràng cho 6 vai trò Agent, mỗi Agent được
 | 25 | `visual-regression-sentinel` | So sánh giao diện mức pixel và SSIM, hỗ trợ dynamic masking chống flaky test. |
 | 26 | `wcag-audit-patterns` | Kiểm toán tiếp cận web WCAG 2.2 Level A/AA tự động qua AST và `@axe-core`. |
 | 27 | `web-vitals-and-performance-profiler` | Đo lường Core Web Vitals (LCP, CLS, TTFB) và giám sát API endpoint chậm qua CDP. |
+| 28 | `skillspector-security-guard` | Kiểm toán bảo mật AI Agent skills & MCP configs với 71 vector lỗ hổng (Prompt Injection, Data Exfiltration, Privilege Escalation) theo chuẩn NVIDIA SkillSpector. |
 
 ---
 
@@ -215,7 +217,18 @@ Hub phân chia năng lực rõ ràng cho 6 vai trò Agent, mỗi Agent được
 
 Chi tiết đầy đủ xem tại [tools/TOOLS_RUNBOOK.md](tools/TOOLS_RUNBOOK.md):
 
-- `tools/verify_all.py`: Cổng thẩm định 7 Gates DoD (UTF-8, No XPaths, UniqueCode, Clean POM).
+- `tools/verify_all.py`: Cổng thẩm định 8 Gates DoD (UTF-8, No XPaths, UniqueCode, Clean POM, AST Mutation).
+- `tools/generate_jmx_plan.py`: Sinh kịch bản Apache JMeter 5.x (.jmx) đa giao thức (HTTP, JDBC, WS, gRPC, Kafka) kèm Traffic Shaping Pareto.
+- `tools/jtl_analyzer.py`: Phân tích kết quả JTL, kiểm soát SLA percentiles ($P_{90}, P_{95}, P_{99}$) và làm Quality Gate CI/CD.
+- `tools/telemetry_correlator.py`: Phân tích tương quan Pearson giữa Client Latency và Server APM (CPU, RAM, DB Pool).
+- `tools/export_postman_collection.py`: Xuất Postman Collection v2.1 với AJV JSON Schema, DDT, và Zero-Input synthesis.
+- `tools/newman_analyzer.py`: Phân tích kết quả Newman, triage lỗi assertion và làm Quality Gate cho API.
+- `tools/api_fuzzer.py`: Autonomous API Fuzzer phát hiện lỗi HTTP 500, rò rỉ stacktrace DB và vi phạm SLA độ trễ.
+- `tools/api_drift_sentinel.py`: Bắt breaking change giữa các phiên bản OpenAPI / Swagger specifications.
+- `tools/auto_heal.py`: Tự phục hồi locator gãy dựa trên AOM diffing mà không cần chạy lại toàn bộ test suite.
+- `tools/flaky_detector.py`: Phát hiện kiểm thử chập chờn (Flaky tests) và quản lý vòng đời cách ly Quarantine.
+- `tools/skillspector.py`: Quét kiểm toán an ninh AI Agent Skills & MCP (71 vectors theo chuẩn NVIDIA SkillSpector).
+- `tools/omni_transpiler.py`: Chuyển đổi mã kiểm thử 0-token đa ngôn ngữ (Playwright TS/Python, Java, Groovy, Cypress).
 - `tools/infer_linter.py`: Phân tích tĩnh AST phát hiện fake-pass (0 assertion) và khối try-catch nuốt lỗi.
 - `tools/test_impact.py`: Phân tích git diff và khoanh vùng chính xác test cases bị ảnh hưởng.
 - `tools/cache_resolver.py`: Quản lý bộ nhớ đệm lỗi SQLite trung tâm (`~/.agent_memory/global_cache.db`).
@@ -228,7 +241,7 @@ Chi tiết đầy đủ xem tại [tools/TOOLS_RUNBOOK.md](tools/TOOLS_RUNBOOK.m
 - `tools/generate_tc_from_story.py`: Large Action Model parser sinh khung Clean POM từ User Story.
 - `tools/trace_data_flow.py`: Kiểm tra luồng dữ liệu kiểm thử, phát hiện rác dữ liệu DB (Orphan Data).
 - `scripts/install.ps1` & `scripts/setup.sh`: Script cài đặt 1-click tự động khởi tạo môi trường Hub.
-- `scripts/lint_skills.ps1`: Linter kiểm tra tính toàn vẹn 30 skills và metadata manifest.
+- `scripts/lint_skills.ps1`: Linter kiểm tra tính toàn vẹn 28 skills và metadata manifest.
 - `pyproject.toml` & `tools/cli.py`: Đóng gói chuẩn PEP 621 cho lệnh CLI toàn cầu `agent-qa`.
 
 ---
@@ -268,13 +281,26 @@ Dự án **Synapse Hub** được tổng hợp, kế thừa và phát triển d
 
 ---
 
+## 📄 9. Bản Quyền & Điều Khoản Sử Dụng (License & Attribution)
+
+Dự án được phân phối chính thức dưới giấy phép **[MIT License](LICENSE)**.
+
+**Quyền sở hữu tác giả & Xuất xứ (Provenance):**
+- **Tác giả & Nhà sáng lập:** Thế Vị ([@TeeVee998](https://github.com/TeeVee998))
+- **Mã nguồn gốc:** [https://github.com/TeeVee998/Synapse-Hub](https://github.com/TeeVee998/Synapse-Hub)
+- **Bản quyền:** Copyright © 2026 Thế Vị (@TeeVee998). All rights reserved.
+
+> ⚖️ **Quy định bản quyền quốc tế & MIT:** Bạn được toàn quyền sử dụng, sửa đổi, tích hợp và phân phối lại mã nguồn này cho bất kỳ mục đích cá nhân hay thương mại nào, **VỚI ĐIỀU KIỆN** thông báo bản quyền gốc ghi nhận tác giả **Thế Vị (@TeeVee998)** cùng liên kết mã nguồn gốc phải được giữ nguyên vẹn trong toàn bộ bản sao hoặc các phần phái sinh quan trọng của phần mềm. Mọi hành vi xóa bỏ tên tác giả khỏi dự án đều cấu thành hành vi vi phạm điều khoản giấy phép MIT.
+
+---
+
 # 🌐 English Edition
 
 # 🧠 Synapse Hub — AI Agent Intelligence Core & Skill Network
 
 > **The shared intelligence core and autonomous skill hub empowering AI coding assistants (Google Antigravity / Cursor / Windsurf / Claude Code) across automated testing suites.**  
 > **Author:** Thế Vị ([@TeeVee998](https://github.com/TeeVee998))  
-> **Hub Version:** `v2.1.1` (Semantic Versioning) | **Integrity Index:** 27 Skills, 6 Agent Swarm Roles, 7 Core Rules, 20+ Python Tools.
+> **Hub Version:** `v2.2.1` (Semantic Versioning) | **Integrity Index:** 28 Skills, 6 Agent Swarm Roles, 7 Core Rules, 20+ Python Tools.
 
 ---
 
@@ -284,8 +310,8 @@ Dự án **Synapse Hub** được tổng hợp, kế thừa và phát triển d
 
 ```mermaid
 flowchart TD
-    subgraph Hub["🧠 Synapse Hub (Intelligence Core v2.1.1)"]
-        Skills[".agents/skills/ (27 Skills)"]
+    subgraph Hub["🧠 Synapse Hub (Intelligence Core v2.2.1)"]
+        Skills[".agents/skills/ (28 Skills)"]
         Agents[".agents/agents/ (6 Specialized Roles)"]
         Rules[".agents/rules/ (7 Core Rules)"]
         Tools["tools/ (20+ Universal Python Tools)"]
@@ -338,21 +364,37 @@ flowchart TD
 
 ---
 
-## 🚀 2. Getting Started & Usage (NPM / npx & Workspace Mount)
+## 🚀 2. Getting Started & Integration (3 Approaches)
 
 [![npm version](https://img.shields.io/npm/v/synapse-hub.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/synapse-hub)
-[![npm downloads](https://img.shields.io/npm/dm/synapse-hub.svg?style=flat-square)](https://www.npmjs.com/package/synapse-hub)
-[![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](https://github.com/TeeVee998/Synapse-Hub/blob/main/package.json)
+[![node version](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org)
+[![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](https://github.com/TeeVee998/Synapse-Hub/blob/main/LICENSE)
+
+---
 
-### Method A: Instant Execution via NPM Registry (Recommended)
-The package is officially published at **[npmjs.com/package/synapse-hub](https://www.npmjs.com/package/synapse-hub)**. Execute directly without cloning:
+### ⚡ Instant All-in-One Setup: Single NPX Command (Zero-Clone 🚀)
+*All-in-one execution: **NO git cloning**, **NO multi-root workspace setup**, configures the target project **AND automatically injects into Antigravity Global Plugin**.*
 
-#### 1. Zero-Install Execution (`npx`):
-Run from any target project directory:
+Run directly from your **target automation project root**:
 ```bash
-# 1-Click Project Bootstrap (generates PROJECT_AI_GUIDE.md, installs pre-push hook, extracts AST repo map)
 npx synapse-hub setup
-
+```
+👉 **This single command automatically completes everything in 5 seconds:**
+1. 🧠 **Injects Antigravity Global Plugin:** Deploys Synapse-Hub into `~/.gemini/config/plugins/synapse-hub`. From this moment on, **ALL projects** opened in Google Antigravity automatically inherit all 28 Skills and 6 Subagent profiles!
+2. 🌐 **Universal AI Bridges Deployment:** Automatically generates tailored configuration rules for all leading AI IDEs and assistants:
+   - 🖱️ **Cursor:** `.cursor/rules/synapse-qa.mdc`
+   - 🤖 **Claude Code:** `CLAUDE.md`
+   - 🐙 **GitHub Copilot:** `.github/copilot-instructions.md`
+   - 🏄 **Windsurf (Cascade):** `.windsurfrules`
+   *(Empowers team members across Antigravity, Cursor, Claude Code, Copilot, or Windsurf to enforce the exact same Clean POM architecture, Truth Anchor, and 8 Quality Gates DoD!)*
+3. 🔍 **Tech Stack Detection:** Auto-detects Playwright TypeScript/JS, Katalon Groovy, Cypress, or Pytest.
+4. 📋 **Project AI Guide Synthesis:** Generates `PROJECT_AI_GUIDE.md` so AI assistants strictly adhere to project workflows.
+5. 🛡️ **Zero-Leakage Git Pre-Push Hook:** Installs `.git/hooks/pre-push` invoking `npx synapse-hub verify` before any git push.
+6. 💾 **Central Agent Memory Initialization:** Seeds offline SQLite healing memory at `~/.agent_memory/global_cache.db` (0 token cost).
+7. 🗺️ **AST Architecture Mapping:** Scans project methods and exports condensed context map (`repo_map.txt`).
+
+Run verification anytime:
+```bash
 # Run 8 Quality Gates DoD Verification
 npx synapse-hub verify
 
@@ -362,45 +404,39 @@ npx synapse-hub analyze
 # Static Defect & Fake-Pass Sentinel scan
 npx synapse-hub lint
 ```
-> 💡 **Tip:** You can also use the shorthand alias: `npx synapse setup` or `npx synapse verify`.
 
-#### 2. Project-Local Installation (DevDependency):
-```bash
-npm install -D synapse-hub
-```
-Configure custom lifecycle scripts in your target project's `package.json`:
-```json
-"scripts": {
-  "qa:verify": "synapse-hub verify",
-  "qa:analyze": "synapse-hub analyze"
-}
+---
+
+### 🥈 Method 2: Antigravity-Native — Install Once as Global Plugin
+*Install once: From that moment onward, **ANY project** opened in Google Antigravity automatically inherits all 28 Skills and 6 Subagent Swarm profiles.*
+
+#### 1-Click Plugin Installation:
+```powershell
+# On Windows PowerShell:
+./scripts/install_global_plugin.ps1
+
+# On macOS / Linux:
+./scripts/install_global_plugin.sh
 ```
 
-#### 3. Global CLI Installation:
-To use `synapse-hub` anywhere on your terminal:
+*(Or clone directly into Antigravity's Global Plugins folder):*
 ```bash
-npm install -g synapse-hub
-
-# Direct invocation:
-synapse-hub verify
-synapse setup
+git clone https://github.com/TeeVee998/Synapse-Hub.git "$HOME/.gemini/config/plugins/synapse-hub"
 ```
 
-### Method B: Multi-Root Workspace Mounting
-Within your AI IDE (Google Antigravity / VS Code / Cursor):
-1. Open your target project folder.
-2. Add the `Synapse-Hub` directory to your workspace (`File` -> `Add Folder to Workspace...`).
-
-### Step 2: Initialize Project AI Guide (`PROJECT_AI_GUIDE.md`)
-Copy `templates/PROJECT_AI_GUIDE_TEMPLATE.md` to target project root, rename to `PROJECT_AI_GUIDE.md`, and configure:
-- Test/staging environment URLs.
-- Credentials and authentication strategies.
-- Source code directory structure.
-- Headless execution commands and technology stack.
-- **Fast-Lookup Registers:** Point `testcases.json` and `selectors.json` (or set `TC_DATA_FILE` / `XPATH_DATA_FILE` env vars) for instant zero-token query via `tools/lookup_tc.py` and `tools/lookup_xpath.py`.
-
-### Step 3: One-Click Environment Bootstrap
-Execute the automated bootstrap script:
+**Result:**
+- Google Antigravity registers `synapse-hub` globally.
+- Every workspace session automatically loads the complete QA intelligence core without manual workspace mounts!
+
+---
+
+### 🥉 Method 3: Multi-Root Workspace Mounting
+*For Core Developers looking to extend, customize, or contribute new Skills and Tools directly to Synapse-Hub.*
+
+1. Open your AI IDE (Google Antigravity / Cursor / VS Code).
+2. Open your target test project (`File -> Open Folder`).
+3. Add `Synapse-Hub` to your workspace (`File -> Add Folder to Workspace...`).
+4. Run the local environment bootstrap script:
 ```powershell
 # Windows PowerShell
 ./scripts/install.ps1
@@ -431,11 +467,11 @@ Synapse Hub clearly partitions capabilities across 6 specialized AI roles, pre-c
 | **`pom-crafter`** | Clean POM engineer, API drift detection, User Story to test generation. | `clean-pom-crafter`, `lam-script-generator`, `synthetic-test-data-generator`, `api-spec-to-e2e-matrix`, `file-and-report-validator`, `db-state-verifier-and-seeder` | `tools/generate_tc_from_story.py`, `tools/generate_api_matrix.py`, `tools/api_drift_sentinel.py`, `tools/repo_map.py` |
 | **`test-runner`** | Headless CLI suite manager, CI parallel sharding and log distillation. | `katalon-cli-runner`, `e2e-testing-patterns`, `bats-testing-patterns`, `auth-session-and-cookie-manager`, `flaky-test-sentinel-and-quarantine` | `tools/matrix_sharder.py`, `tools/distill_log.py`, `tools/pinpoint_failure.py`, `tools/flaky_detector.py` |
 | **`failure-analyst`**| Automated closed-loop failure triage, MTTR scoring, self-healing PR drafting. | `failure-autopsy-and-healing`, `self-healing-locator`, `file-and-report-validator` | `tools/auto_heal.py`, `tools/heal_pr_automator.py`, `tools/pinpoint_failure.py`, `tools/cache_resolver.py` |
-| **`quality-gatekeeper`**| Enforces 8 Quality Gates DoD, scans fake passes, runs AST mutation testing. | `antigravity-test-sentinel`, `code-refactoring-refactor-clean`, `wcag-audit-patterns`, `web-vitals-and-performance-profiler`, `db-state-verifier-and-seeder`, `security-dast-sentinel` | `tools/verify_all.py`, `tools/infer_linter.py`, `tools/micro_mutator.py`, `tools/trace_data_flow.py`, `tools/wcag_audit.py`, `tools/lint_ai_docs.py` |
+| **`quality-gatekeeper`**| Enforces 8 Quality Gates DoD, scans fake passes, runs AST mutation testing. | `antigravity-test-sentinel`, `code-refactoring-refactor-clean`, `wcag-audit-patterns`, `web-vitals-and-performance-profiler`, `db-state-verifier-and-seeder`, `security-dast-sentinel`, `skillspector-security-guard` | `tools/verify_all.py`, `tools/infer_linter.py`, `tools/micro_mutator.py`, `tools/trace_data_flow.py`, `tools/wcag_audit.py`, `tools/lint_ai_docs.py`, `tools/skillspector.py` |
 
 ---
 
-## 📦 4. Standardized 27 Skills Catalog (.agents/skills/)
+## 📦 4. Standardized 28 Skills Catalog (.agents/skills/)
 
 | # | Skill Name | Core Operational Scope |
 |:---:|---|---|
@@ -466,6 +502,7 @@ Synapse Hub clearly partitions capabilities across 6 specialized AI roles, pre-c
 | 25 | `visual-regression-sentinel` | Pixel-level and SSIM visual regression testing with dynamic masking. |
 | 26 | `wcag-audit-patterns` | Automated WCAG 2.2 Level A/AA accessibility auditing via AST and `@axe-core`. |
 | 27 | `web-vitals-and-performance-profiler` | Core Web Vitals (LCP, CLS, TTFB) profiling and slow API endpoint detection via CDP. |
+| 28 | `skillspector-security-guard` | AI agent skill & MCP config security auditing against 71 vulnerability vectors (Prompt Injection, Data Exfiltration, Privilege Escalation) powered by NVIDIA SkillSpector spec. |
 
 ---
 
@@ -485,7 +522,18 @@ Synapse Hub clearly partitions capabilities across 6 specialized AI roles, pre-c
 
 For full details, refer to [tools/TOOLS_RUNBOOK.md](tools/TOOLS_RUNBOOK.md):
 
-- `tools/verify_all.py`: 8 Quality Gates DoD verification (UTF-8, No XPaths, UniqueCode, Clean POM).
+- `tools/verify_all.py`: 8 Quality Gates DoD verification (UTF-8, No XPaths, UniqueCode, Clean POM, AST Mutation).
+- `tools/generate_jmx_plan.py`: Multi-protocol Apache JMeter 5.x (.jmx) plan generator (HTTP, JDBC, WS, gRPC, Kafka) with Pareto traffic shaping.
+- `tools/jtl_analyzer.py`: JTL execution metrics analyzer, P95/P99 SLA gatekeeper, and CI/CD Quality Gate enforcer.
+- `tools/telemetry_correlator.py`: Full-stack Pearson correlation analyzer between client-side latency and server APM (CPU, RAM, DB Pool).
+- `tools/export_postman_collection.py`: Exports Postman Collections v2.1 with native AJV JSON Schema, DDT CSV, and Zero-Input domain synthesis.
+- `tools/newman_analyzer.py`: Newman automated test results analyzer, assertion failure triage, and CI/CD Quality Gate.
+- `tools/api_fuzzer.py`: Autonomous API fuzzer detecting HTTP 500 crashes, database stacktrace leaks, and latency SLA breaches.
+- `tools/api_drift_sentinel.py`: Contract drift detector comparing OpenAPI/Swagger specifications for breaking changes.
+- `tools/auto_heal.py`: In-place locator self-healing engine correlating JUnit XML and screenshots via AOM diffing.
+- `tools/flaky_detector.py`: Flaky test detector and automated quarantine lifecycle manager.
+- `tools/skillspector.py`: AI Agent Skill & MCP Security Sentinel (71 detection vectors, Prohibition Context Engine, SARIF/JSON reporting).
+- `tools/omni_transpiler.py`: 0-token polyglot test transpiler (Playwright TS/Python, Java, Groovy, Cypress).
 - `tools/infer_linter.py`: Static AST analysis detecting fake passes (zero asserts) and empty catch blocks.
 - `tools/test_impact.py`: Scopes affected test cases based on git diffs.
 - `tools/cache_resolver.py`: Manages the central SQLite error memory cache (`~/.agent_memory/global_cache.db`).
@@ -515,6 +563,7 @@ pip install -e .
 agent-qa --help
 agent-qa verify
 agent-qa lint
+agent-qa skillspector
 ```
 
 ---
@@ -525,6 +574,7 @@ agent-qa lint
 
 | Project & Author | Architectural Inspiration in Synapse Hub |
 | :--- | :--- |
+| **[NVIDIA/SkillSpector](https://github.com/NVIDIA/SkillSpector)** *(NVIDIA AI Security Team)* | AI Agent skill & MCP security vetting engine (`tools/skillspector.py`, Skill #28 `skillspector-security-guard`) featuring 71 vulnerability vectors across 17 categories and the Prohibition Context Engine. |
 | **[muratcankoylan/Agent-Skills-for-Context-Engineering](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)** | Context Engineering foundations, observation masking, and LLM attention budget optimization. |
 | **[alexgreensh/token-optimizer](https://github.com/alexgreensh/token-optimizer)** | Token-efficient reasoning, 95% log distillation, and KV-cache serialization protocols. |
 | **[obra/superpowers](https://github.com/obra/superpowers)** *(Jesse Vincent)* | Systematic evidence-based debugging, cognitive forcing functions, and Red-Team vs Blue-Team verification. |
@@ -536,3 +586,17 @@ agent-qa lint
 | **[bats-core/bats-core](https://github.com/bats-core/bats-core)** | Bash Automated Testing System patterns for CI/CD pipelines and cross-platform CLI verification. |
 | **[npryce/adr-tools](https://github.com/npryce/adr-tools)** | Architecture Decision Record (ADR) conventions and lifecycle workflows. |
 
+---
+
+## 📄 9. License & Author Attribution
+
+This project is licensed under the **[MIT License](LICENSE)**.
+
+**Provenance & Copyright Notice:**
+- **Author & Founder:** Thế Vị ([@TeeVee998](https://github.com/TeeVee998))
+- **Original Repository:** [https://github.com/TeeVee998/Synapse-Hub](https://github.com/TeeVee998/Synapse-Hub)
+- **Copyright:** Copyright © 2026 Thế Vị (@TeeVee998). All rights reserved.
+
+> ⚖️ **Mandatory Attribution Condition:** Under the terms of the MIT License, you are granted permission to use, modify, merge, publish, and distribute this software freely, **PROVIDED** that the original copyright notice crediting **Thế Vị (@TeeVee998)** and repository provenance link are preserved in all copies or substantial portions of the Software. Stripping author attribution is a violation of international copyright treaties and MIT License conditions.
+
+

package/bin/agent-qa.js

@@ -1,4 +1,8 @@
 #!/usr/bin/env node
+// SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
+// SPDX-License-Identifier: MIT
+// Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
+
 /**
  * Enterprise Synapse-Hub NPM Launcher
  * ====================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synapse-hub",
-  "version": "2.1.1",
+  "version": "2.2.1",
   "description": "Enterprise AI Agent Intelligence Hub & Autonomous Skill Network",
   "publishConfig": {
     "access": "public"
@@ -25,7 +25,7 @@
     "url": "git+https://github.com/TeeVee998/Synapse-Hub.git"
   },
   "license": "MIT",
-  "author": "AI QA Engineering Swarm <qa-swarm@enterprise.internal>",
+  "author": "Thế Vị (@TeeVee998) <https://github.com/TeeVee998>",
   "main": "bin/agent-qa.js",
   "bin": {
     "synapse-hub": "./bin/agent-qa.js",
@@ -38,6 +38,7 @@
     "bin",
     "tools",
     "templates",
+    "LICENSE",
     "README.md",
     "AGENTS.md",
     "skills_manifest.json",