synapse-hub 2.5.0 → 2.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synapse-hub",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "description": "Enterprise AI Agent Intelligence Hub & Autonomous Skill Network",
   "publishConfig": {
     "access": "public"

package/skills_manifest.json

@@ -1,15 +1,18 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "Enterprise Agent Skills Hub",
-  "version": "2.5.0",
-  "description": "Unified Catalog of 38 Specialized Skills for Autonomous AI Agents in Enterprise Software Quality Engineering, Performance, and Architecture.",
-  "totalSkills": 42,
+  "version": "2.7.0",
+  "description": "Unified Catalog of 51 Specialized Skills for Autonomous AI Agents in Enterprise Software Quality Engineering, Performance, and Architecture.",
+  "totalSkills": 51,
   "categories": {
     "context_and_optimization": [
       "token-and-context-optimizer",
       "agent-orchestration-multi-agent-optimize",
       "persistent-planning-files",
-      "meta-prompt-crafter"
+      "meta-prompt-crafter",
+      "qa-memory-os",
+      "event-stream-qa-orchestrator",
+      "actor-qa-swarm"
     ],
     "test_automation_and_execution": [
       "clean-pom-crafter",
@@ -22,7 +25,9 @@
       "gherkin-to-suite",
       "auth-session-and-cookie-manager",
       "backend-load-and-stress-patterns",
-      "rbt-manual-testing"
+      "rbt-manual-testing",
+      "web-agent-gym-benchmarking",
+      "tot-exploratory-testing"
     ],
     "verification_and_resilience": [
       "antigravity-test-sentinel",
@@ -38,7 +43,8 @@
       "flaky-test-sentinel-and-quarantine",
       "test-driven-development",
       "systematic-debugging",
-      "verification-before-completion"
+      "verification-before-completion",
+      "agentless-qa-repair"
     ],
     "architecture_and_analysis": [
       "api-spec-to-e2e-matrix",
@@ -53,7 +59,10 @@
       "graphify-impact-analyzer",
       "wcag-audit-patterns",
       "github-actions-templates",
-      "web-vitals-and-performance-profiler"
+      "web-vitals-and-performance-profiler",
+      "qa-aci-interface",
+      "mipro-prompt-compiler",
+      "review-spec"
     ]
   },
   "profiles": {
@@ -509,6 +518,78 @@
       "path": ".agents/skills/lean-impact-scoreboard/SKILL.md",
       "summary": "Display the measured impact scoreboard (code reduction %, token optimization %, cost reduction %, test rigor) from lean engineering benchmarks.",
       "version": "1.0.0"
+    },
+    {
+      "id": "agentless-qa-repair",
+      "name": "Agentless QA Repair",
+      "category": "verification_and_resilience",
+      "path": ".agents/skills/agentless-qa-repair/SKILL.md",
+      "summary": "Repair broken test scripts and Page Classes using an Agentless 3-phase flow: localization, candidate synthesis, and minimal diff validation.",
+      "version": "1.0.0"
+    },
+    {
+      "id": "qa-aci-interface",
+      "name": "QA Agent-Computer Interface",
+      "category": "architecture_and_analysis",
+      "path": ".agents/skills/qa-aci-interface/SKILL.md",
+      "summary": "Safe Agent-Computer Interface for inspecting code windows (40-50 lines), surgical editing with pre-commit AST checks, and distilled test execution.",
+      "version": "1.0.0"
+    },
+    {
+      "id": "qa-memory-os",
+      "name": "QA Test Memory OS",
+      "category": "context_and_optimization",
+      "path": ".agents/skills/qa-memory-os/SKILL.md",
+      "summary": "Hierarchical 3-tier memory operating system for test automation: Core Memory blocks, Recall step logs, and Archival semantic store with AUT version scoping.",
+      "version": "1.0.0"
+    },
+    {
+      "id": "event-stream-qa-orchestrator",
+      "name": "EventStream QA Orchestrator",
+      "category": "context_and_optimization",
+      "path": ".agents/skills/event-stream-qa-orchestrator/SKILL.md",
+      "summary": "Immutable EventStream orchestrator recording deterministic action/observation timelines with SHA-256 hash chains and reversible checkpoint rollbacks.",
+      "version": "1.0.0"
+    },
+    {
+      "id": "web-agent-gym-benchmarking",
+      "name": "Web Agent Gym Benchmarking",
+      "category": "test_automation_and_execution",
+      "path": ".agents/skills/web-agent-gym-benchmarking/SKILL.md",
+      "summary": "Empirical benchmark harness evaluating web agents and Page Classes against standardized enterprise tasks with headless <200ms latency budgets and ground-truth DB state verification.",
+      "version": "1.0.0"
+    },
+    {
+      "id": "tot-exploratory-testing",
+      "name": "Tree-of-Thoughts Exploratory Testing",
+      "category": "test_automation_and_execution",
+      "path": ".agents/skills/tot-exploratory-testing/SKILL.md",
+      "summary": "Non-linear Tree/Graph-of-Thoughts exploratory testing engine exploring Happy Path, Boundary/Race, and Negative/Chaos branches with Beam Search risk scoring and multi-hypothesis RCA.",
+      "version": "1.0.0"
+    },
+    {
+      "id": "actor-qa-swarm",
+      "name": "Actor QA Swarm",
+      "category": "context_and_optimization",
+      "path": ".agents/skills/actor-qa-swarm/SKILL.md",
+      "summary": "Asynchronous Actor Model message broker and matrix sharding coordinator for multi-agent test execution.",
+      "version": "1.0.0"
+    },
+    {
+      "id": "mipro-prompt-compiler",
+      "name": "MIPROv2 Prompt Compiler",
+      "category": "architecture_and_analysis",
+      "path": ".agents/skills/mipro-prompt-compiler/SKILL.md",
+      "summary": "MIPROv2 Bayesian teleprompter optimizer and few-shot compiler tuning prompt instructions against AST mutation kill scores.",
+      "version": "1.0.0"
+    },
+    {
+      "id": "review-spec",
+      "name": "Review Spec (Goldfish Protocol)",
+      "category": "architecture_and_analysis",
+      "path": ".agents/skills/review-spec/SKILL.md",
+      "summary": "Zero-context stress test and quality review of test specifications, user stories, BDD feature files, and acceptance criteria before code generation begins.",
+      "version": "1.0.0"
     }
   ]
 }

package/synapse.config.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://raw.githubusercontent.com/TeeVee998/Synapse-Hub/main/docs/schemas/synapse.config.schema.json",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "quality_gates": {
     "mutation_min_score": 80,
     "gates": {
@@ -12,7 +12,8 @@
       "gate_5_cleanup_blacklist": true,
       "gate_6_credential_security": true,
       "gate_7_infer_linter": true,
-      "gate_8_micro_mutator": true
+      "gate_8_micro_mutator": true,
+      "gate_9_skill_collision": true
     }
   },
   "infer_linter": {

package/templates/ai_bridges/CLAUDE.md

@@ -17,7 +17,7 @@ In accordance with the MIT License, the original copyright notice crediting **Th
 ---
 
 ## ⚡ Quick Commands
-- Verify 9 Quality Gates: `npx synapse-hub verify` (or `python tools/verify_all.py`)
+- Verify 10 Quality Gates: `npx synapse-hub verify` (or `python tools/verify_all.py`)
 - Project Health Audit: `npx synapse-hub analyze` (or `python tools/analyze_project.py`)
 - Code Linter & Fake-Pass Sentinel: `npx synapse-hub lint` (or `python tools/infer_linter.py`)
 - Verify Author Attribution: `python tools/author_integrity.py`

package/templates/welcome.html.tmpl

@@ -781,7 +781,7 @@
                 <li><a href="#pillars" data-i18n="nav_pillars">4 Trụ Cột</a></li>
                 <li><a href="#hero-features" data-i18n="nav_features">Tính Năng</a></li>
                 <li><a href="#quickstart" data-i18n="nav_quickstart">Lệnh CLI</a></li>
-                <li><a href="#quality-gates" data-i18n="nav_gates">9 Quality Gates</a></li>
+                <li><a href="#quality-gates" data-i18n="nav_gates">10 Quality Gates</a></li>
                 <li><a href="#comparison" data-i18n="nav_compare">So Sánh</a></li>
             </ul>
             <div class="nav-actions">
@@ -806,7 +806,7 @@
             <p data-i18n="hero_desc">
                 Tăng cường sức mạnh cho QA Engineers và các Autonomous AI Agent trên cả 4 mảng: 
                 <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong> và <strong>Performance Testing</strong>. 
-                Trang bị các Sentinel phân tích cú pháp AST 100% offline, 6 hồ sơ Swarm Agent, và 9 Quality Gates Definition-of-Done.
+                Trang bị các Sentinel phân tích cú pháp AST 100% offline, 6 hồ sơ Swarm Agent, và 10 Quality Gates Definition-of-Done.
             </p>
             <div class="hero-modes" style="display: flex; justify-content: center; gap: 16px; margin: 0 auto 32px; max-width: 820px; flex-wrap: wrap;">
                 <div style="background: rgba(255, 255, 255, 0.04); border: 1px solid rgba(255, 255, 255, 0.08); border-radius: 12px; padding: 14px 18px; text-align: left; flex: 1; min-width: 260px;">
@@ -821,7 +821,7 @@
             <div class="hero-buttons">
                 <a href="#quickstart" class="btn btn-primary" style="padding: 12px 24px; font-size: 15px;" data-i18n="btn_quickstart">🚀 Bắt Đầu Trong 5 Giây</a>
                 <a href="#pillars" class="btn btn-secondary" style="padding: 12px 24px; font-size: 15px;" data-i18n="btn_pillars">🎯 Khám Phá 4 Trụ Cột</a>
-                <a href="#quality-gates" class="btn btn-emerald" style="padding: 12px 24px; font-size: 15px;" data-i18n="btn_gates">🛡️ Xem 9 Quality Gates</a>
+                <a href="#quality-gates" class="btn btn-emerald" style="padding: 12px 24px; font-size: 15px;" data-i18n="btn_gates">🛡️ Xem 10 Quality Gates</a>
             </div>
 
             <!-- Stats Ribbon -->
@@ -831,7 +831,7 @@
                     <div class="stat-label" data-i18n="stat_skills">Kỹ Năng AI Tiêu Chuẩn</div>
                 </div>
                 <div class="stat-item">
-                    <div class="stat-val" style="color: var(--accent-emerald);">9 / 9</div>
+                    <div class="stat-val" style="color: var(--accent-emerald);">10 / 10</div>
                     <div class="stat-label" data-i18n="stat_gates">Cổng Kiểm Soát DoD</div>
                 </div>
                 <div class="stat-item">
@@ -983,7 +983,7 @@
                 <div class="terminal-tabs">
                     <div class="terminal-tab active" onclick="switchTab(event, 'tab-doctor')" data-i18n="t_doctor">1. Chẩn Đoán (Doctor)</div>
                     <div class="terminal-tab" onclick="switchTab(event, 'tab-setup')" data-i18n="t_setup">2. Cài Đặt (Setup)</div>
-                    <div class="terminal-tab" onclick="switchTab(event, 'tab-verify')" data-i18n="t_verify">3. Kiểm Tra 9 Cổng</div>
+                    <div class="terminal-tab" onclick="switchTab(event, 'tab-verify')" data-i18n="t_verify">3. Kiểm Tra 10 Cổng</div>
                     <div class="terminal-tab" onclick="switchTab(event, 'tab-lint')" data-i18n="t_lint">4. Quét Fake-Pass</div>
                     <div class="terminal-tab" onclick="switchTab(event, 'tab-excel')" data-i18n="t_excel">5. Xuất Excel</div>
                     <div class="terminal-tab" onclick="switchTab(event, 'tab-dashboard')" data-i18n="t_dashboard">6. Dashboard</div>
@@ -1016,7 +1016,7 @@
                             <div class="cmd-text"><span class="prompt">$</span>npx synapse-hub verify</div>
                             <button class="copy-btn" onclick="copyCmd('npx synapse-hub verify')">Copy</button>
                         </div>
-                        <p class="cmd-desc" data-i18n="t_desc_verify">🛡️ Thực thi toàn bộ 9 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Đường dẫn khả chuyển, Mutation &ge; 80%).</p>
+                        <p class="cmd-desc" data-i18n="t_desc_verify">🛡️ Thực thi toàn bộ 10 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Đường dẫn khả chuyển, Mutation &ge; 80%, Skill Routing Guard).</p>
                     </div>
 
                     <!-- Tab Lint -->
@@ -1141,12 +1141,12 @@
             </div>
         </section>
 
-        <!-- 9 Quality Gates DoD Section -->
+        <!-- 10 Quality Gates DoD Section -->
         <section id="quality-gates" style="scroll-margin-top: 100px;">
             <div class="section-header">
                 <span class="section-tag" data-i18n="sec_gates_tag">Kiểm Định Toàn Diện</span>
-                <h2 class="section-title" data-i18n="sec_gates_title">9 Cổng Kiểm Soát Chất Lượng (DoD Sentinel)</h2>
-                <p class="section-desc" data-i18n="sec_gates_desc">Mọi kịch bản test do AI sinh ra bắt buộc phải vượt qua toàn bộ 9 Quality Gates trước khi được commit hoặc merge code.</p>
+                <h2 class="section-title" data-i18n="sec_gates_title">10 Cổng Kiểm Soát Chất Lượng (DoD Sentinel)</h2>
+                <p class="section-desc" data-i18n="sec_gates_desc">Mọi kịch bản test do AI sinh ra bắt buộc phải vượt qua toàn bộ 10 Quality Gates trước khi được commit hoặc merge code.</p>
             </div>
 
             <div class="gates-grid">
@@ -1195,6 +1195,11 @@
                     <div class="gate-name" data-i18n="g8_name">Kiểm Thử Đột Biến Mã (Micro-Mutation)</div>
                     <div class="gate-desc" data-i18n="g8_desc">Yêu cầu điểm Mutation &ge; 80% để loại bỏ các bài test pass ảo nhưng không kiểm tra logic thực tế.</div>
                 </div>
+                <div class="gate-card">
+                    <div class="gate-top"><span class="gate-badge">GATE 9</span><span class="gate-pass">✓ PASS</span></div>
+                    <div class="gate-name" data-i18n="g9_name">Điều Phối Kỹ Năng & Ngăn Xung Đột</div>
+                    <div class="gate-desc" data-i18n="g9_desc">Kiểm tra độ tương đồng ngữ nghĩa và trigger giữa các skill, loại bỏ hoàn toàn kích hoạt nhầm lẫn.</div>
+                </div>
             </div>
         </section>
 
@@ -1287,21 +1292,21 @@
                 nav_pillars: "4 Trụ Cột",
                 nav_features: "Tính Năng",
                 nav_quickstart: "Lệnh CLI",
-                nav_gates: "9 Quality Gates",
+                nav_gates: "10 Quality Gates",
                 nav_compare: "So Sánh",
                 status_ready: "● Sẵn sàng",
                 hero_pill_tag: "🛡️ Trung Tâm Trí Tuệ Chất Lượng AI Doanh Nghiệp",
                 hero_pill_status: "Sẵn Sàng 100% Offline",
                 hero_target_label: "Dự án mục tiêu",
                 hero_title: "Trung Tâm Trí Tuệ QA Toàn Diện<br>Dành Cho AI Coding Agents",
-                hero_desc: "Tăng cường sức mạnh cho QA Engineers và các Autonomous AI Agent trên cả 4 mảng: <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong> và <strong>Performance Testing</strong>. Trang bị các Sentinel phân tích cú pháp AST 100% offline, 6 hồ sơ Swarm Agent, và 9 Quality Gates Definition-of-Done.",
+                hero_desc: "Tăng cường sức mạnh cho QA Engineers và các Autonomous AI Agent trên cả 4 mảng: <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong> và <strong>Performance Testing</strong>. Trang bị các Sentinel phân tích cú pháp AST 100% offline, 6 hồ sơ Swarm Agent, và 10 Quality Gates Definition-of-Done.",
                 mode_cli_title: "🛠️ Cách 1: CLI Độc Lập (Zero AI)",
                 mode_cli_desc: "Chạy <code>npx synapse-hub lint</code> phát hiện test pass ảo, nén log CI hoặc xuất Excel chuẩn mà không cần cấu hình.",
                 mode_agent_title: "🧠 Cách 2: Chốt Chặn Cho AI Coding",
                 mode_agent_desc: "Tích hợp vào Cursor, Antigravity, Claude Code làm bộ quy chuẩn — ngăn AI sinh mã nguồn cẩu thả hoặc bỏ qua ngoại lệ ngầm.",
                 btn_quickstart: "🚀 Bắt Đầu Trong 5 Giây",
                 btn_pillars: "🎯 Khám Phá 4 Trụ Cột",
-                btn_gates: "🛡️ Xem 9 Quality Gates",
+                btn_gates: "🛡️ Xem 10 Quality Gates",
                 stat_skills: "Kỹ Năng AI Tiêu Chuẩn",
                 stat_gates: "Cổng Kiểm Soát DoD",
                 stat_swarm: "Vai Trò AI Chuyên Biệt",
@@ -1354,7 +1359,7 @@
                 sec_cli_desc: "Thực thi mọi tính năng mạnh mẽ của Synapse Hub trực tiếp qua npx hoặc npm mà không cần cài đặt phức tạp.",
                 t_doctor: "1. Chẩn Đoán (Doctor)",
                 t_setup: "2. Cài Đặt (Setup)",
-                t_verify: "3. Kiểm Tra 9 Cổng",
+                t_verify: "3. Kiểm Tra 10 Cổng",
                 t_lint: "4. Quét Fake-Pass",
                 t_excel: "5. Xuất Excel",
                 t_dashboard: "6. Dashboard",
@@ -1362,7 +1367,7 @@
                 t_watch: "8. Giám Sát Real-Time",
                 t_desc_doctor: "🩺 Quét chẩn đoán 1-click kiểm tra môi trường Python 3.9+, Node.js, Git hook, trình duyệt, và Bộ nhớ Agent Trung tâm.",
                 t_desc_setup: "⚡ Cài đặt dự án 1-click: sinh hướng dẫn PROJECT_AI_GUIDE.md, cầu nối Universal AI bridges, bản đồ AST, và git hook chặn rò rỉ.",
-                t_desc_verify: "🛡️ Thực thi toàn bộ 9 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Đường dẫn linh hoạt, Mutation &ge; 80%).",
+                t_desc_verify: "🛡️ Thực thi toàn bộ 10 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Đường dẫn linh hoạt, Mutation &ge; 80%, Skill Routing Guard).",
                 t_desc_lint: "🔍 Quét AST phát hiện các test case pass ảo (0 assertion), khối catch rỗng và ngoại lệ bị bỏ qua ngầm (swallowed exceptions) trên toàn bộ test script.",
                 t_desc_excel: "📊 Biên dịch tài liệu test case markdown sang file bảng tính Excel 12 cột chuyên nghiệp có công thức và danh sách chọn trạng thái.",
                 t_desc_dashboard: "📈 Khởi tạo và mở trang Báo cáo QA Tổng thể dạng HTML độc lập ngay trong trình duyệt của bạn.",
@@ -1392,8 +1397,8 @@
                 tr6_dim: "QA Thủ Công (AI-RBT & Excel)",
                 tr6_syn: "Xuất Excel 12 cột tích hợp sẵn",
                 sec_gates_tag: "Kiểm Định Toàn Diện",
-                sec_gates_title: "9 Cổng Kiểm Soát Chất Lượng (DoD Sentinel)",
-                sec_gates_desc: "Mọi kịch bản test do AI sinh ra bắt buộc phải vượt qua toàn bộ 9 Quality Gates trước khi được commit hoặc merge code.",
+                sec_gates_title: "10 Cổng Kiểm Soát Chất Lượng (DoD Sentinel)",
+                sec_gates_desc: "Mọi kịch bản test do AI sinh ra bắt buộc phải vượt qua toàn bộ 10 Quality Gates trước khi được commit hoặc merge code.",
                 g0_name: "Bảo Đảm Bản Quyền & Tác Giả",
                 g0_desc: "Bảo chứng nguồn gốc tác quyền Thế Vị (@TeeVee998) theo chuẩn Giấy phép MIT.",
                 g1_name: "Chuẩn Mã Hóa UTF-8 No BOM",
@@ -1412,6 +1417,8 @@
                 g7_desc: "Tự động quét phát hiện test thiếu assertion, sleep cố định và try-catch bỏ qua ngoại lệ ngầm.",
                 g8_name: "Kiểm Thử Đột Biến Mã (Micro-Mutation)",
                 g8_desc: "Yêu cầu điểm Mutation &ge; 80% để loại bỏ các bài test pass ảo nhưng không kiểm tra logic thực tế.",
+                g9_name: "Điều Phối Kỹ Năng & Ngăn Xung Đột (Skill Collision Guard)",
+                g9_desc: "Kiểm tra độ tương đồng ngữ nghĩa và trigger giữa các skill, loại bỏ hoàn toàn xung đột nhầm lẫn.",
                 sec_swarm_tag: "Hệ Thống AI Agent Tự Động (Swarm)",
                 sec_swarm_title: "6 Hồ Sơ Subagent Chuyên Biệt",
                 sec_swarm_desc: "Phối hợp nhịp nhàng thông qua kiến trúc Single Front-Door FSM, loại bỏ hoàn toàn sự lúng túng khi điều phối agent.",
@@ -1426,7 +1433,7 @@
                 a5_role: "Chuyên Gia Phân Tích & Điều Tra Lỗi (Failure Autopsy)",
                 a5_desc: "Chẩn đoán nguyên nhân gốc (RCA) từ JUnit XML và ảnh chụp lỗi; tự động đề xuất giải pháp và tạo PR khắc phục lỗi.",
                 a6_role: "Chốt Chặn Kiểm Soát Chất Lượng (Quality Gatekeeper)",
-                a6_desc: "Kiểm định nghiêm ngặt toàn bộ 9 Quality Gates DoD và điểm mutation &ge; 80% trước khi hoàn tất công việc.",
+                a6_desc: "Kiểm định nghiêm ngặt toàn bộ 10 Quality Gates DoD và điểm mutation &ge; 80% trước khi hoàn tất công việc.",
                 footer_subtitle: "Nền Tảng Kiểm Định Chất Lượng & Guardrail Cho AI Coding Doanh Nghiệp.",
                 footer_creator: "Tác giả sáng lập",
                 footer_license: "Phát hành theo",
@@ -1438,21 +1445,21 @@
                 nav_pillars: "4 Pillars",
                 nav_features: "Features",
                 nav_quickstart: "CLI Commands",
-                nav_gates: "9 Quality Gates",
+                nav_gates: "10 Quality Gates",
                 nav_compare: "Comparison",
                 status_ready: "● Ready",
                 hero_pill_tag: "🛡️ Enterprise AI Quality Intelligence Hub",
                 hero_pill_status: "100% Offline Ready",
                 hero_target_label: "Target Project",
                 hero_title: "The Complete QA Intelligence Hub<br>for AI Coding Agents",
-                hero_desc: "Empowering QA Engineers and Autonomous AI Agents across <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong>, and <strong>Performance</strong> testing. Equipped with 100% offline-first AST sentinels, 6 swarm profiles, and 9 Quality Gates Definition-of-Done.",
+                hero_desc: "Empowering QA Engineers and Autonomous AI Agents across <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong>, and <strong>Performance</strong> testing. Equipped with 100% offline-first AST sentinels, 6 swarm profiles, and 10 Quality Gates Definition-of-Done.",
                 mode_cli_title: "🛠️ Mode 1: Standalone CLI (Zero AI)",
                 mode_cli_desc: "Run <code>npx synapse-hub lint</code> to catch fake passes, distill CI logs, or export Excel with zero setup.",
                 mode_agent_title: "🧠 Mode 2: Guardrail for AI Coding",
                 mode_agent_desc: "Mount into Cursor, Antigravity, or Claude Code as quality guardrails — stopping AI from writing brittle or tautological tests.",
                 btn_quickstart: "🚀 5-Second Quickstart",
                 btn_pillars: "🎯 Explore 4 Pillars",
-                btn_gates: "🛡️ View 9 Quality Gates",
+                btn_gates: "🛡️ View 10 Quality Gates",
                 stat_skills: "Standardized AI Skills",
                 stat_gates: "Quality Gates DoD",
                 stat_swarm: "Autonomous Swarm Roles",
@@ -1505,7 +1512,7 @@
                 sec_cli_desc: "Run all Synapse Hub capabilities directly via npx without manual configuration.",
                 t_doctor: "1. Doctor",
                 t_setup: "2. Setup Project",
-                t_verify: "3. Verify 9 Gates",
+                t_verify: "3. Verify 10 Gates",
                 t_lint: "4. Scan Fake-Pass",
                 t_excel: "5. Export Excel",
                 t_dashboard: "6. Dashboard",
@@ -1513,7 +1520,7 @@
                 t_watch: "8. Real-Time Watch",
                 t_desc_doctor: "🩺 Runs a 1-click diagnostic scan verifying Python 3.9+, Node.js, Git hooks, browser drivers, and Central Agent Memory.",
                 t_desc_setup: "⚡ 1-click bootstrap of target repository: generates PROJECT_AI_GUIDE.md, universal AI bridges, AST map, and pre-push sentinel.",
-                t_desc_verify: "🛡️ Enforces all 9 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Path Portability, Mutation &ge; 80%).",
+                t_desc_verify: "🛡️ Enforces all 10 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Path Portability, Mutation &ge; 80%, Skill Routing Guard).",
                 t_desc_lint: "🔍 AST scan detecting fake passes (0 assertions), empty catch blocks, and swallowed exceptions across all test scripts.",
                 t_desc_excel: "📊 Compiles markdown test cases into a professional 12-column Excel workbook with status dropdowns and formulas.",
                 t_desc_dashboard: "📈 Compiles and opens the standalone executive QA HTML report in your browser.",
@@ -1543,8 +1550,8 @@
                 tr6_dim: "Manual QA (AI-RBT & Excel)",
                 tr6_syn: "Native 12-Col Exporter",
                 sec_gates_tag: "Zero-Hallucination Pipeline",
-                sec_gates_title: "9 Quality Gates DoD Sentinel",
-                sec_gates_desc: "Every AI-generated test script must satisfy all 9 Quality Gates before code can be committed or merged.",
+                sec_gates_title: "10 Quality Gates DoD Sentinel",
+                sec_gates_desc: "Every AI-generated test script must satisfy all 10 Quality Gates before code can be committed or merged.",
                 g0_name: "Author Attribution & Integrity",
                 g0_desc: "Cryptographic provenance invariant preserving author Thế Vị (@TeeVee998) MIT license.",
                 g1_name: "UTF-8 No BOM & Clean Encoding",
@@ -1563,6 +1570,8 @@
                 g7_desc: "Meta Infer-style heuristic & static AST scan catching 0-assertion tests, static sleeps, and swallowed exception blocks.",
                 g8_name: "Syntactic Micro-Mutation",
                 g8_desc: "Requires test suite mutation score &ge; 80% to eliminate tautological test cases.",
+                g9_name: "Skill Routing & Collision Guard",
+                g9_desc: "Audits semantic descriptions and activation triggers between skills, eliminating ambiguous dispatch.",
                 sec_swarm_tag: "Autonomous Multi-Agent System",
                 sec_swarm_title: "6 Specialized Subagent Profiles",
                 sec_swarm_desc: "Coordinated through a single front-door FSM architecture to avoid decision paralysis.",
@@ -1577,7 +1586,7 @@
                 a5_role: "Failure Autopsy Analyst",
                 a5_desc: "Closed-loop failure diagnosis from JUnit XML and screenshots; generates auto-healing PR plans.",
                 a6_role: "Quality Gatekeeper Sentinel",
-                a6_desc: "Final gatekeeper enforcing all 9 Quality Gates DoD and &ge; 80% mutation score before task completion.",
+                a6_desc: "Final gatekeeper enforcing all 10 Quality Gates DoD and &ge; 80% mutation score before task completion.",
                 footer_subtitle: "The Enterprise AI Agent Quality Engineering & Autonomous Skill Network.",
                 footer_creator: "Original Creator",
                 footer_license: "Released under the",

package/tools/TOOLS_RUNBOOK.md

@@ -15,7 +15,7 @@
 | **Flaky Test Detection & Quarantine Governance ("flaky")** | `tools/flaky_detector.py` | `agent-qa flaky --detect` (or `npx synapse-hub flaky`) |
 | **Executive Project Health & Quality Dashboard ("dashboard")** | `tools/dashboard_generator.py` | `agent-qa dashboard` (or `npx synapse-hub dashboard`) |
 | **Clean Uninstall of AI Bridges & Global Plugins ("uninstall")** | `tools/cli.py` | `agent-qa uninstall` (or `npx synapse-hub uninstall`) |
-| **Comprehensive Health & AST Analysis ("analyze project")** | `tools/analyze_project.py` | `python tools/analyze_project.py [target]` (or `agent-qa analyze`).<br/>*Post-Audit:* Stages, commits, and pushes `PROJECT_HEALTH_REPORT.md` & `repo_map.txt` to project Git. |
+| **Comprehensive Health & AST Analysis ("analyze project")** | `tools/analyze_project.py` | `python tools/analyze_project.py [target]` (or `agent-qa analyze`).<br/>*Post-Audit:* Stages and commits `PROJECT_HEALTH_REPORT.md` & `repo_map.txt` locally; confirms with user before pushing to remote. |
 | **Action Safety Firewall (Environment Protection)** | `tools/safety_firewall.py` | `python tools/safety_firewall.py --text "Delete" --action click` (or `agent-qa safety-check`) |
 | **API Contract Drift (Breaking Change Detection)** | `tools/api_drift_sentinel.py` | `python tools/api_drift_sentinel.py --old base.json --new curr.json` (or `agent-qa contract-drift`) |
 | **Autonomous API Fuzzing & Chaos Breaker** | `tools/api_fuzzer.py` | `agent-qa fuzz-api --base-url <url> --spec <swagger.json>` (Catches 500, DB leaks, SLA breach) |
@@ -78,6 +78,14 @@
 | **Technical Debt & Shortcut Harvester ("debt")** | `tools/debt_harvester.py` | `agent-qa debt [path]` (or `python tools/debt_harvester.py --scan`).<br/>*Autonomous:* Scans `shortcut:` markers across repo, generates tracked markdown ledger. |
 | **6-Pillar Senior Git Diff Reviewer ("review")** | `tools/senior_code_review.py` | `agent-qa review [--staged]` (or `python tools/senior_code_review.py`).<br/>*Autonomous:* Reviews diff across Bugs, Security, Concurrency, Missing Tests, Speed, Bloat. |
 | **Upstream Version Check & 1-Click Self-Update** | `tools/update_sentinel.py` | `python tools/update_sentinel.py --check / --update` (or `agent-qa update` / `npx synapse-hub update`) |
+| **Tier-2 Skill Routing & Collision Guard (Gate 9)** | `tools/skill_collision_guard.py` | `python tools/skill_collision_guard.py` (or `verify_all Gate 9` / `--route "<intent>"`) |
+| **GoEx Reversible Sandbox Teardown Stack** | `tools/reversible_sandbox.py` | `python tools/reversible_sandbox.py run --cmd "<cmd>" --rollback "<cleanup>"` |
+| **Multi-Trial Episodic Reflexion Loop (K=3)** | `tools/auto_heal_reflexion.py` | `python tools/auto_heal_reflexion.py --test-cmd "<cmd>" --max-trials 3` |
+| **Voyager Lifelong Page Class SQLite Vault** | `tools/skill_vault.py` | `python tools/skill_vault.py query "<keyword>"` / `stats` / `store` |
+| **Stanford DSPy Declarative QA Signatures** | `tools/dspy_qa_signatures.py` | `python tools/dspy_qa_signatures.py compile-suite --spec <file>` |
+| **Pocock Grilling Primitive & Requirement Interrogation** | `tools/interview_story.py` | `python tools/interview_story.py analyze <story.md>` / `interactive` |
+| **Mutant-Directed Textual Loss Optimizer (TextGrad)** | `tools/textgrad_mutation_optimizer.py` | `python tools/textgrad_mutation_optimizer.py optimize --test-file <path>` |
+| **Tool Function Calling Benchmark (Gorilla BFCL)** | `tools/synapse_qa_bench.py` | `python tools/synapse_qa_bench.py benchmark --top-k 5` |
 
 ---
 
@@ -565,3 +573,124 @@ agent-qa update
   agent-qa review --output-md REVIEW_REPORT.md
   agent-qa review --json
   ```
+
+---
+
+### 32. `tools/skill_collision_guard.py` (Tier-2 Skill Routing & Collision Guard — Gate 9)
+- **Purpose:** Enforces deterministic skill dispatch and prevents routing collision across internal Hub skills (`.agents/skills/`) and external plugins based on cosine/Jaccard semantic overlap. Guarantees zero ambiguous triggers and acts as DoD Gate 9.
+- **Trigger Condition:** Executed automatically during `verify_all.py` (Gate 9), pre-commit, or on-demand when auditing skill trigger uniqueness.
+- **CLI Syntax:**
+  ```bash
+  # 1. Audit skill overlap and check for collision
+  python3 tools/skill_collision_guard.py
+
+  # 2. Audit with custom similarity threshold (default: 0.75 critical, 0.50 warning)
+  python3 tools/skill_collision_guard.py --threshold 0.80 --warn-threshold 0.45
+
+  # 3. Output machine-readable JSON for CI integration
+  python3 tools/skill_collision_guard.py --json
+  ```
+
+---
+
+### 33. `tools/reversible_sandbox.py` (GoEx Reversible Teardown Sandbox Stack)
+- **Purpose:** Manages a deterministic LIFO undo execution stack for safe test automation and self-healing. Automatically rolls back filesystem mutations, database fixture insertions, and environment changes if a test or patch crashes.
+- **Trigger Condition:** When dispatching destructive mutations, exploratory self-healing patches, or running isolated trial runs.
+- **CLI Syntax:**
+  ```bash
+  # 1. Check current sandbox undo stack status
+  python3 tools/reversible_sandbox.py --status
+
+  # 2. Run reversible stack verification demo
+  python3 tools/reversible_sandbox.py --demo
+  ```
+
+---
+
+### 34. `tools/auto_heal_reflexion.py` (Multi-Trial Episodic Reflexion Loop — K=3)
+- **Purpose:** Implements the Noah Shinn Episodic Reflexion loop for failed automated tests. Performs up to $K=3$ iterative trial-feedback cycles, updating episodic memory and self-correcting locators/code without polluting git history.
+- **Trigger Condition:** When headless test suites fail in runner, or single-pass self-healing fails to resolve complex selector or timing issues.
+- **CLI Syntax:**
+  ```bash
+  # 1. Run multi-trial reflexion self-healing on failing test
+  python3 tools/auto_heal_reflexion.py --test "TC_Checkout_01" --error "ElementClickInterceptedException"
+
+  # 2. Configure custom max trials (default: 3)
+  python3 tools/auto_heal_reflexion.py --test "TC_Login_02" --error "TimeoutException" --max-trials 5
+  ```
+
+---
+
+### 35. `tools/skill_vault.py` (Voyager Lifelong Page Class SQLite Vault)
+- **Purpose:** Persists, indexes, and retrieves verified Clean POM Page Class methods, custom locators, and resilient interaction primitives in a permanent SQLite repository (`~/.agent_memory/skill_vault.db`). Prevents re-inventing known solutions across sessions.
+- **Trigger Condition:** When authoring new Page Classes, searching for proven element interactions, or archiving new successful POM patterns.
+- **CLI Syntax:**
+  ```bash
+  # 1. Query verified Page Class primitives by keyword
+  python3 tools/skill_vault.py --query "table_pagination"
+
+  # 2. List all indexed primitives in the lifelong vault
+  python3 tools/skill_vault.py --list
+
+  # 3. Seed initial baseline POM primitives
+  python3 tools/skill_vault.py --seed-samples
+  ```
+
+---
+
+### 36. `tools/dspy_qa_signatures.py` (Stanford DSPy Declarative QA Signature Engine)
+- **Purpose:** Transforms prompt-based test generation into typed, declarative signatures (`StoryToUniversalIR`, `HealBrokenLocator`, `MutantAssertionSignature`) with formal input/output contracts, eliminating brittle prompt hacking.
+- **Trigger Condition:** When compiling user stories into Universal IR, generating defensive assertions, or verifying agent signature compatibility.
+- **CLI Syntax:**
+  ```bash
+  # 1. Check DSPy engine status and signature registrations
+  python3 tools/dspy_qa_signatures.py --check
+
+  # 2. Run declarative compilation demonstration
+  python3 tools/dspy_qa_signatures.py --demo
+  ```
+
+---
+
+### 37. `tools/interview_story.py` (Pocock Grilling Primitive & Requirement Interrogation)
+- **Purpose:** Analyzes rough user stories and acceptance criteria against the Frontier Interrogation Checklist, identifying ambiguities, missing negative boundaries, unstated auth constraints, and race conditions before coding begins.
+- **Trigger Condition:** Triggered autonomously when a user provides an incomplete story or uses `/grill-me` to sharpen requirements.
+- **CLI Syntax:**
+  ```bash
+  # 1. Interrogate user story text directly
+  python3 tools/interview_story.py "As a user I want to checkout cart"
+
+  # 2. Analyze user story file and output JSON questions
+  python3 tools/interview_story.py docs/specs/order_flow.md --json
+  ```
+
+---
+
+### 38. `tools/textgrad_mutation_optimizer.py` (Mutant-Directed Textual Loss Optimizer)
+- **Purpose:** Uses AST micro-mutants as a "textual loss function" to iteratively refine test assertions and Page Class validation methods until mutation score satisfies $\ge 80\%$.
+- **Trigger Condition:** When newly generated tests fail Gate 8 (Mutation Score $< 80\%$), optimizing assertions to catch all logic mutations.
+- **CLI Syntax:**
+  ```bash
+  # 1. Optimize test script assertions against mutants
+  python3 tools/textgrad_mutation_optimizer.py --file tests/test_checkout.py
+
+  # 2. Optimize with custom target score threshold
+  python3 tools/textgrad_mutation_optimizer.py --file tests/test_login.py --target-score 85.0
+
+  # 3. Output results as JSON
+  python3 tools/textgrad_mutation_optimizer.py --file tests/test_checkout.py --json
+  ```
+
+---
+
+### 39. `tools/synapse_qa_bench.py` (Tool Function Calling Benchmark — Gorilla BFCL)
+- **Purpose:** Evaluates AI Agent tool-selection accuracy, argument validation precision, and multi-turn execution efficiency against standardized enterprise QA scenarios.
+- **Trigger Condition:** On-demand when benchmarking agent model upgrades, evaluating tool prompt updates, or running QA engine evaluations.
+- **CLI Syntax:**
+  ```bash
+  # 1. Run QA function-calling benchmark across all test scenarios
+  python3 tools/synapse_qa_bench.py
+
+  # 2. Output detailed benchmark report as JSON
+  python3 tools/synapse_qa_bench.py --json
+  ```

package/tools/__init__.py

@@ -6,7 +6,7 @@ Repository: https://github.com/TeeVee998/Synapse-Hub
 License: MIT
 """
 
-__version__ = "2.5.0"
+__version__ = "2.7.0"
 __author__ = "Thế Vị (@TeeVee998)"
 
 __all__ = [