@teevee98/synapse-hub 4.0.0 → 4.1.1
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/rules/context-engineering.md +3 -3
- package/.agents/rules/security_testing_rules.md +8 -5
- package/README.en.md +4 -4
- package/README.md +4 -4
- package/agentskills.json +1 -1
- package/docs/ARCHITECTURE.en.md +2 -2
- package/docs/ARCHITECTURE.md +2 -2
- package/docs/CONTRIBUTING.en.md +1 -1
- package/docs/CONTRIBUTING.md +1 -1
- package/docs/TOOL_CATALOG.md +14 -4
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/skills_manifest.json +162 -54
- package/synapse.config.json +17 -1
- package/tools/TOOL_CATALOG.json +156 -6
- package/tools/__init__.py +1 -1
- package/tools/ast_cache.py +1 -3
- package/tools/author_integrity.py +7 -2
- package/tools/benchmark_swarm_context.py +242 -151
- package/tools/browser_helpers.js +2 -2
- package/tools/build_consolidated_report.py +5 -5
- package/tools/check_version_sync.py +56 -0
- package/tools/cli.py +3 -3
- package/tools/core/file_lock.py +81 -6
- package/tools/core/telemetry.py +139 -1
- package/tools/core/token_estimator.py +144 -0
- package/tools/count_tokens.py +28 -0
- package/tools/dashboard_generator.py +6 -6
- package/tools/debt_harvester.py +20 -9
- package/tools/diagram_architect.py +0 -1
- package/tools/distill_log.py +266 -89
- package/tools/git_worktree_manager.py +1 -1
- package/tools/mcp_docx_server.py +1 -1
- package/tools/mcp_excel_server.py +1 -1
- package/tools/mcp_server.py +1 -1
- package/tools/mechanical_ui_gate.py +1 -1
- package/tools/micro_mutator.py +51 -10
- package/tools/pairwise_generator.py +0 -1
- package/tools/pentest_scope_guard.py +328 -0
- package/tools/perf/benchmark_perf_runner.py +225 -0
- package/tools/rules_router.py +326 -103
- package/tools/token_telemetry.py +224 -0
- package/tools/ui_server.py +1 -1
- package/tools/update_sentinel.py +3 -3
- package/tools/verify_all.py +24 -6
- package/tools/welcome_page.py +1 -1
|
@@ -20,11 +20,11 @@ description: Context engineering and token optimization protocols for large test
|
|
|
20
20
|
- Tier 1: Check `tools/repo_map.txt` for class signatures (~500 tokens).
|
|
21
21
|
- Tier 2: Check dependency blast radius via `tools/test_impact.py`.
|
|
22
22
|
- Tier 3: Micro-read targeted 20–50 lines using `StartLine` and `EndLine`.
|
|
23
|
-
- **English-First Documentation Reading:** When inspecting or reading documentation or architecture specifications with bilingual editions (e.g. `ARCHITECTURE.en.md` vs `ARCHITECTURE.md`, `README.en.md` vs `README.md`),
|
|
23
|
+
- **English-First Documentation Reading (BPE Token Density):** When inspecting or reading documentation or architecture specifications with bilingual editions (e.g. `ARCHITECTURE.en.md` vs `ARCHITECTURE.md`, `README.en.md` vs `README.md`), prioritize the English version (`*.en.md`). Standard subword BPE tokenizers (cl100k, o200k, Gemini) allocate ~1.8 chars/token for accented Vietnamese text compared to ~3.85 chars/token for English technical prose, yielding ~1.5x–2.2x higher token efficiency and preserving context window capacity.
|
|
24
24
|
|
|
25
25
|
## 3. KV-Cache Optimization & Static Prefix
|
|
26
|
-
- Keep system instructions and rule headers static and immutable at the top.
|
|
27
|
-
- Append new observations strictly at the bottom.
|
|
26
|
+
- Keep system instructions and rule headers static and immutable at the top to optimize provider prefix caching (e.g. Anthropic prompt caching with >= 1,024 prefix tokens, OpenAI prompt caching, Gemini context caching).
|
|
27
|
+
- Append new observations strictly at the bottom. Consistent status badge prefixes maintain prompt invariance across turns where context exceeds the provider cache activation threshold.
|
|
28
28
|
|
|
29
29
|
## 4. Compaction Anchoring & Subagent Isolation
|
|
30
30
|
- Persist active test registers, IDs, and state to `PROJECT_STATE.md` so automated context compaction never causes state loss.
|
|
@@ -1,15 +1,18 @@
|
|
|
1
1
|
# Security & Pentest Testing Invariants (5-Layer Safety Gate)
|
|
2
2
|
|
|
3
3
|
> Rule chốt chặn bắt buộc khi thực thi `security-dast-sentinel` hoặc `skillspector-security-guard` trong Synapse-Hub.
|
|
4
|
+
> **Runtime Enforcement Engine:** Toàn bộ Layer 1 & Layer 2 được kiểm soát và cưỡng chế qua `tools/pentest_scope_guard.py` (`PentestScopeGuard`).
|
|
4
5
|
|
|
5
6
|
## 1. Layer 1 — Scope & Production Blocklist (Allowlist Gate)
|
|
6
|
-
* Mọi script DAST/Fuzzing/Pentest (Burp Suite, OWASP ZAP, Nuclei, Python) bắt buộc đọc `TARGET_BASE_URL` và kiểm tra khớp với `ALLOWED_PENTEST_HOSTS
|
|
7
|
-
* **
|
|
8
|
-
*
|
|
7
|
+
* Mọi script DAST/Fuzzing/Pentest (Burp Suite, OWASP ZAP, Nuclei, Python) bắt buộc tích hợp `PentestScopeGuard` (`tools/pentest_scope_guard.py`), đọc `TARGET_BASE_URL` và kiểm tra khớp với `ALLOWED_PENTEST_HOSTS`.
|
|
8
|
+
* **Cơ chế Fail-Closed / Mặc định từ chối:** Nếu `ALLOWED_PENTEST_HOSTS` trống, toàn bộ quét chủ động bị ngắt.
|
|
9
|
+
* **Từ chối thực thi ngay** nếu URL mục tiêu thuộc môi trường Production (`prod`, `live`, tên miền chính thức chưa nằm trong `ALLOWED_PENTEST_HOSTS`), hoặc trỏ tới AWS Metadata (`169.254.169.254`) / RFC1918 internal IPs trái phép.
|
|
10
|
+
* Mọi chuyển hướng (HTTP Redirect 301/302) đều phải qua `validate_redirect` để chống SSRF bounce.
|
|
11
|
+
* Bắt buộc có cờ xác nhận `--confirm-pentest-scope` hoặc `PENTEST_CONSENT_ACKNOWLEDGED=1` trước khi chạy quét chủ động. Mọi lần kiểm tra được ghi vào audit trail `.synapse/pentest_audit.log`.
|
|
9
12
|
|
|
10
13
|
## 2. Layer 2 — Rate-Limit & Concurrency Cap
|
|
11
|
-
* Giới hạn cứng tốc độ gửi request
|
|
12
|
-
* Bắt buộc đặt `timeout <= 10s` cho mọi HTTP request và tự ngắt script nếu gặp `5xx` hoặc `429` liên tiếp vượt ngưỡng.
|
|
14
|
+
* Thực thi qua `PentestRateLimiter`: Giới hạn cứng tốc độ gửi request: tối đa `5–10 req/s` và tối đa `3–5` luồng song song (trừ bài test Rate-Limit có xác nhận riêng).
|
|
15
|
+
* Bắt buộc đặt `timeout <= 10s` cho mọi HTTP request và tự động kích hoạt Circuit Breaker ngắt script nếu gặp `5xx` hoặc `429` liên tiếp vượt ngưỡng.
|
|
13
16
|
|
|
14
17
|
## 3. Layer 3 — Non-Destructive PoC & Account Isolation
|
|
15
18
|
* Chỉ dùng payload chứng minh lỗ hổng vô hại (SQLi đọc an toàn, canary string, time-delay nhỏ). Cấm tuyệt đối payload xóa/sửa dữ liệu (`DROP`, `DELETE`, `UPDATE` không điều kiện) hoặc gây DoS.
|
package/README.en.md
CHANGED
|
@@ -6,13 +6,13 @@
|
|
|
6
6
|
|
|
7
7
|
> **Core Mission:** A standalone linter and guardrail engine (zero external dependencies for core engine & DoD gates) safeguarding automated test suites when AI writes code — Automatically catching "fake-pass" tests (0 assertions, tautologies), eliminating fixed sleeps, compressing 95% of CI/CD log noise, and enforcing Clean POM architecture.
|
|
8
8
|
> **Author:** Thế Vị ([@TeeVee98](https://github.com/TeeVee98)) | **License:** MIT License
|
|
9
|
-
> **Version:** `v4.
|
|
9
|
+
> **Version:** `v4.1.1` | **Scale:** 53 Standardized QA Skills, 9 Specialized AI Agents, 10 DoD Quality Gates.
|
|
10
10
|
|
|
11
11
|
[](https://www.npmjs.com/package/@teevee98/synapse-hub)
|
|
12
12
|
[](https://nodejs.org)
|
|
13
13
|
[](https://python.org)
|
|
14
14
|
[](docs/QUALITY_GATES.en.md)
|
|
15
|
-
[](#)
|
|
16
16
|
[](https://github.com/TeeVee98/Synapse-Hub/blob/main/LICENSE)
|
|
17
17
|
[](#)
|
|
18
18
|
|
|
@@ -68,7 +68,7 @@ flowchart LR
|
|
|
68
68
|
|
|
69
69
|
## ⚡ Quickstart in 60 Seconds (One-Command Onboarding 🚀)
|
|
70
70
|
|
|
71
|
-
You **never need to memorize** 53 skills or
|
|
71
|
+
You **never need to memorize** 53 skills or 121 internal tools. Synapse Hub activates autonomously when needed:
|
|
72
72
|
|
|
73
73
|
|
|
74
74
|
```bash
|
|
@@ -154,7 +154,7 @@ Every test code change must satisfy all 10 Quality Gates before pull request mer
|
|
|
154
154
|
# Pre-commit hook (.pre-commit-config.yaml):
|
|
155
155
|
repos:
|
|
156
156
|
- repo: https://github.com/TeeVee98/Synapse-Hub
|
|
157
|
-
rev: v4.
|
|
157
|
+
rev: v4.1.1
|
|
158
158
|
hooks:
|
|
159
159
|
- id: synapse-lint
|
|
160
160
|
- id: synapse-verify
|
package/README.md
CHANGED
|
@@ -6,13 +6,13 @@
|
|
|
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
8
|
> **Tác giả:** Thế Vị ([@TeeVee98](https://github.com/TeeVee98)) | **Giấy phép:** MIT License
|
|
9
|
-
> **Phiên bản:** `v4.
|
|
9
|
+
> **Phiên bản:** `v4.1.1` | **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/@teevee98/synapse-hub)
|
|
12
12
|
[](https://nodejs.org)
|
|
13
13
|
[](https://python.org)
|
|
14
14
|
[](docs/QUALITY_GATES.md)
|
|
15
|
-
[](#)
|
|
16
16
|
[](https://github.com/TeeVee98/Synapse-Hub/blob/main/LICENSE)
|
|
17
17
|
[](#)
|
|
18
18
|
|
|
@@ -68,7 +68,7 @@ flowchart LR
|
|
|
68
68
|
|
|
69
69
|
## ⚡ Bắt Đầu Nhanh Trong 60 Giây (1 Lệnh Khởi Chạy 🚀)
|
|
70
70
|
|
|
71
|
-
Bạn **không cần học hay ghi nhớ** 53 kỹ năng hay
|
|
71
|
+
Bạn **không cần học hay ghi nhớ** 53 kỹ năng hay 121 công cụ bên trong. Synapse Hub hoạt động tự động khi cần:
|
|
72
72
|
|
|
73
73
|
|
|
74
74
|
```bash
|
|
@@ -154,7 +154,7 @@ Mọi thay đổi mã nguồn kiểm thử đều được kiểm chứng qua 10
|
|
|
154
154
|
# Pre-commit hook (.pre-commit-config.yaml):
|
|
155
155
|
repos:
|
|
156
156
|
- repo: https://github.com/TeeVee98/Synapse-Hub
|
|
157
|
-
rev: v4.
|
|
157
|
+
rev: v4.1.1
|
|
158
158
|
hooks:
|
|
159
159
|
- id: synapse-lint
|
|
160
160
|
- id: synapse-verify
|
package/agentskills.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://agentskills.io/schema/v1.json",
|
|
3
3
|
"name": "Synapse-Hub",
|
|
4
|
-
"version": "4.
|
|
4
|
+
"version": "4.1.1",
|
|
5
5
|
"description": "Enterprise QA & Test Automation AI Skills Ecosystem — 53 skills organised across 11 Domain Packages adhering to Clean POM Flat Architecture.",
|
|
6
6
|
"author": "Thế Vị (@TeeVee98)",
|
|
7
7
|
"repository": "https://github.com/TeeVee98/Synapse-Hub",
|
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:** `4.
|
|
6
|
+
> **Version:** `4.1.1` | **Status:** Active / Production Standard
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -193,7 +193,7 @@ To maintain strict engineering rigor (**Truth Anchor**), Synapse Hub discloses a
|
|
|
193
193
|
2. **Empirical Benchmarks (Self-Reported Baseline):**
|
|
194
194
|
The metrics (25/25 challenges resolved, 76.2 tokens/bug) reflect author-measured internal baselines on curated challenges (`benchmarks/qa_eval`) rather than independent third-party double-blind audits. Metrics may vary on real-world enterprise suites depending on architectural complexity and test coverage.
|
|
195
195
|
3. **Hub-Spoke Version Pinning (Blast-Radius Isolation):**
|
|
196
|
-
When mounting or referencing Synapse Hub in downstream Spoke projects, downstream repositories should pin a specific Git Submodule commit or release tag (`git checkout
|
|
196
|
+
When mounting or referencing Synapse Hub in downstream Spoke projects, downstream repositories should pin a specific Git Submodule commit or release tag (`git checkout v4.1.1`) rather than tracking unpinned `main` HEAD, preventing upstream Hub changes from unexpectedly breaking downstream CI/CD pipelines.
|
|
197
197
|
4. **Supported Runners:**
|
|
198
198
|
First-class runner adapters for **Playwright, Pytest, Katalon Studio/Groovy, and Cypress**. Selenium WebDriver is supported via Clean POM architecture patterns, smart-wait primitives, and Universal IR transpilation.
|
|
199
199
|
5. **Environment Prerequisites:**
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
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:** `4.
|
|
6
|
+
> **Version:** `4.1.1` | **Trạng thái:** Hoạt động / Tiêu chuẩn Sản xuất
|
|
7
7
|
> **Tác giả:** Thế Vị (@TeeVee98) | **Giấy phép:** MIT License
|
|
8
8
|
|
|
9
9
|
---
|
|
@@ -194,7 +194,7 @@ flowchart TD
|
|
|
194
194
|
2. **Kết Quả Benchmark Thực Nghiệm (Self-Reported Baseline):**
|
|
195
195
|
Các chỉ số 25/25 bài toán (100.0%) và 76.2 token / lỗi là kết quả đo lường nội bộ do tác giả thực hiện trên bộ benchmark curated nội bộ (`benchmarks/qa_eval`), chưa qua kiểm chứng độc lập của bên thứ ba (third-party double-blind benchmark). Khi áp dụng vào dự án thực tế với kiến trúc phức tạp, các chỉ số có thể thay đổi tùy thuộc vào độ bao phủ của bộ test.
|
|
196
196
|
3. **Cơ Chế Pin Version Hub-Spoke (Chống Lỗi Lan Truyền):**
|
|
197
|
-
Khi tích hợp Synapse Hub vào các dự án Spoke, khuyến nghị bắt buộc pin phiên bản qua Git Submodule commit cụ thể hoặc git release tag (`git checkout
|
|
197
|
+
Khi tích hợp Synapse Hub vào các dự án Spoke, khuyến nghị bắt buộc pin phiên bản qua Git Submodule commit cụ thể hoặc git release tag (`git checkout v4.1.1`), tránh kéo trực tiếp nhánh `main` tự động để không làm ảnh hưởng pipeline của các Spoke khi Hub có cập nhật chưa kiểm duyệt.
|
|
198
198
|
4. **Test Framework Được Hỗ Trợ Tốt Nhất:**
|
|
199
199
|
Tối ưu tốt nhất cho **Playwright, Pytest, Katalon Studio/Groovy, và Cypress**. Hỗ trợ Selenium WebDriver thông qua chuẩn kiến trúc Clean POM, smart wait và chuyển ngữ Universal IR.
|
|
200
200
|
5. **Yêu Cầu Môi Trường:**
|
package/docs/CONTRIBUTING.en.md
CHANGED
|
@@ -8,7 +8,7 @@ We welcome contributions to expand and refine skills, tools, and rules in the **
|
|
|
8
8
|
|
|
9
9
|
## 1. Skill Authoring Standards
|
|
10
10
|
|
|
11
|
-
Every skill resides in `.agents/skills/<skill-name>/` and must satisfy:
|
|
11
|
+
Every skill resides in `.agents/skills/<category>/<skill-name>/` (across 11 domain categories) and must satisfy:
|
|
12
12
|
|
|
13
13
|
1. **`SKILL.md` Structure:**
|
|
14
14
|
- Must contain valid YAML frontmatter with `name` and `description`.
|
package/docs/CONTRIBUTING.md
CHANGED
|
@@ -8,7 +8,7 @@ Chào mừng bạn tham gia đóng góp mở rộng kỹ năng (Skills), công c
|
|
|
8
8
|
|
|
9
9
|
## 1. Quy Chuẩn Khi Viết Kỹ Năng Mới (Skill Standards)
|
|
10
10
|
|
|
11
|
-
Mỗi kỹ năng nằm trong thư mục riêng `.agents/skills/<ten-ky-nang>/` và cần đáp ứng các tiêu chí sau:
|
|
11
|
+
Mỗi kỹ năng nằm trong thư mục riêng `.agents/skills/<category>/<ten-ky-nang>/` (thuộc 1 trong 11 nhóm chuyên mục) và cần đáp ứng các tiêu chí sau:
|
|
12
12
|
|
|
13
13
|
1. **Cấu trúc file `SKILL.md`:**
|
|
14
14
|
- Bắt buộc có phần mở đầu YAML frontmatter chuẩn xác chứa `name` và `description`.
|
package/docs/TOOL_CATALOG.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Synapse Hub — Tooling Ecosystem Catalog & Runbook
|
|
2
2
|
|
|
3
3
|
> **Audience:** QA Engineers, Autonomous AI Agents (Lead Orchestrator, POM-Crafter, Test-Runner, Failure-Analyst, Quality-Gatekeeper).
|
|
4
|
-
> **Total Tools Cataloged:** `
|
|
4
|
+
> **Total Tools Cataloged:** `121` | **Stable:** `121` | **Experimental:** `0`
|
|
5
5
|
|
|
6
6
|
## 1. Primary Enterprise CLI Tools
|
|
7
7
|
|
|
@@ -13,13 +13,15 @@
|
|
|
13
13
|
| `python tools/analyze_project.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Comprehensive health audit analyzing environment, POM structure, and Quality Gates. |
|
|
14
14
|
| `python tools/api_drift_sentinel.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Detects contract drift and breaking schema mutations against OpenAPI specifications. |
|
|
15
15
|
| `python tools/api_fuzzer.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Autonomous API Fuzzing & Chaos Breaker |
|
|
16
|
-
| `python tools/
|
|
16
|
+
| `python tools/ast_cache.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/ast_cache.py — AST Dataflow Pre-Validation Cache (Boost B3) |
|
|
17
|
+
| `python tools/author_integrity.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/author_integrity.py — Author Attribution & Repository Provenance Guard |
|
|
17
18
|
| `python tools/auto_heal.py` | **Failure Autopsy & Healing** | `failure-analyst` | 🟢 Stable | `modifying` | Closed-loop locator self-healing engine matching broken selectors against DOM/AOM. |
|
|
18
19
|
| `python tools/auto_heal_reflexion.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Multi-Trial Episodic Reflexion Loop for Autonomous Healing (Noah Shinn / Reflexion Pattern) |
|
|
19
20
|
| `python tools/autogen_qa_broker.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Asynchronous Actor QA Message Broker (Microsoft AutoGen v0.4+ Pattern) |
|
|
20
21
|
| `python tools/benchmark_swarm_context.py` | **Benchmarking** | `orchestrator` | 🟢 Stable | `read_only` | Empirical context token reduction benchmark harness proving >= 40% savings. |
|
|
21
22
|
| `python tools/browsergym_eval.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | BrowserGym Web Agent Benchmark Harness (BrowserGym / WebArena Pattern) |
|
|
22
23
|
| `python tools/bug_reporter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Auto-Bug Reporter & Root Cause Analysis (RCA) Ticket Generator |
|
|
24
|
+
| `python tools/build_consolidated_report.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/build_consolidated_report.py — Generate Unified Top 20 Skills & Agents Evaluation Report |
|
|
23
25
|
| `python tools/bump_version.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/bump_version.py — Atomic Universal Version Bumper for Synapse Hub |
|
|
24
26
|
| `python tools/cache_resolver.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal Local Semantic Memory Cache & Self-Healing Resolver |
|
|
25
27
|
| `python tools/check_env.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | ============================================================================== |
|
|
@@ -33,7 +35,8 @@
|
|
|
33
35
|
| `python tools/dashboard_generator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/dashboard_generator.py — Standalone One-Page Enterprise QA HTML Dashboard |
|
|
34
36
|
| `python tools/db_sandbox.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Zero-Pollution Database Sandbox & Ephemeral Teardown Engine |
|
|
35
37
|
| `python tools/debt_harvester.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/debt_harvester.py — Technical Debt & Shortcut Harvester |
|
|
36
|
-
| `python tools/
|
|
38
|
+
| `python tools/diagram_architect.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/diagram_architect.py — Standalone Self-Contained SVG & HTML Diagram Builder |
|
|
39
|
+
| `python tools/distill_log.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/distill_log.py — Enterprise Multi-Framework Log Distiller (Token & Failure Sentinel) |
|
|
37
40
|
| `python tools/dspy_qa_signatures.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Declarative QA Signature Compilation Engine (Stanford DSPy Pattern) |
|
|
38
41
|
| `python tools/e2e_flow_prober.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise E2E Flow Prober & XPath Crawler Dispatcher (Cross-Platform) |
|
|
39
42
|
| `python tools/export_postman_collection.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Exports API test matrices into runnable Postman Collections with pre-request scripts. |
|
|
@@ -50,6 +53,7 @@
|
|
|
50
53
|
| `python tools/generate_tool_catalog.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/generate_tool_catalog.py — Enterprise Tooling Ecosystem Catalog Generator |
|
|
51
54
|
| `python tools/gherkin_suite.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `read_only` | Compiles Gherkin .feature specs into expanded test matrices and coverage reports. |
|
|
52
55
|
| `python tools/git_pre_commit_guard.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Git Pre-Commit Architecture & Discipline Guard |
|
|
56
|
+
| `python tools/git_worktree_manager.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/git_worktree_manager.py — Ephemeral Git Worktree Manager for Subagents |
|
|
53
57
|
| `python tools/goldfish_review.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/goldfish_review.py — Zero-Context Test Specification Reviewer |
|
|
54
58
|
| `python tools/heal_pr_automator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Self-Healing Confidence Scorer & PR Automator |
|
|
55
59
|
| `python tools/heuristic_locator_matcher.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | 3-Layer Heuristic Locator Matcher (0-Token Autonomous Recovery) |
|
|
@@ -68,6 +72,7 @@
|
|
|
68
72
|
| `python tools/mcp_excel_server.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Cross-Platform MCP Excel Server (Zero-Dependency) |
|
|
69
73
|
| `python tools/mcp_server.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Model Context Protocol (MCP) Standard Server |
|
|
70
74
|
| `python tools/md_to_xlsx.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Markdown to Excel (.xlsx) Enterprise Converter |
|
|
75
|
+
| `python tools/mechanical_ui_gate.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/mechanical_ui_gate.py — Headless Chrome Mechanical Layout & Contrast Gate |
|
|
71
76
|
| `python tools/micro_mutator.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Syntactic micro-mutation sentinel eliminating tautological tests and measuring assertion sensitivity. |
|
|
72
77
|
| `python tools/mipro_assertion_tuner.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | MIPROv2 Prompt Assertion Tuner (Stanford DSPy v2 & Optuna TPE Pattern) |
|
|
73
78
|
| `python tools/network_mock_shield.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `modifying` | Network interception shield stubbing external routes and injecting chaos network faults. |
|
|
@@ -78,11 +83,15 @@
|
|
|
78
83
|
| `python tools/openxml_guard.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | OpenXML Security & Protocol Defense Guard |
|
|
79
84
|
| `python tools/output_formatter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Standardized Output Formatter & Exit Code Specification |
|
|
80
85
|
| `python tools/package_release.py` | **CI/CD & Packaging** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise release packager preserving .github/workflows and generating SHA-256 provenance. |
|
|
86
|
+
| `python tools/pairwise_generator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/pairwise_generator.py — Pairwise (2-Way) Combinatorial Test Case Generator |
|
|
87
|
+
| `python tools/pentest_scope_guard.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/pentest_scope_guard.py — Enterprise Pentest Scope & DAST Runtime Guard |
|
|
81
88
|
| `python tools/pinpoint_failure.py` | **Failure Autopsy & Healing** | `failure-analyst` | 🟢 Stable | `read_only` | Sub-0.1s JUnit XML autopsy parser diagnosing test crashes without LLM token waste. |
|
|
82
89
|
| `python tools/project_state.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Project State Machine & Token-Capped Memory Anchor |
|
|
83
90
|
| `python tools/qa_event_stream.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Immutable QA Event Stream Engine (OpenHands EventStream Pattern) |
|
|
84
91
|
| `python tools/repo_map.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Repository Map Compressor (Inspired by Aider-AI/aider) |
|
|
85
92
|
| `python tools/reversible_sandbox.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Reversible Execution Sandbox & Automated Teardown Engine (GoEx Pattern) |
|
|
93
|
+
| `python tools/rules_router.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/rules_router.py — Progressive Rules Router & Context Optimizer (Boost B2) |
|
|
94
|
+
| `python tools/runaway_stopper.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/runaway_stopper.py — Agent Runaway & Token Loop Sentinel |
|
|
86
95
|
| `python tools/safety_firewall.py` | **Security** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Non-bypassable safety firewall blocking destructive operations (drop database, git push force, rm -rf). |
|
|
87
96
|
| `python tools/security_coverage_ledger.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Mathematical Security Coverage Ledger & Audit Tracker |
|
|
88
97
|
| `python tools/security_scanner.py` | **Security** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Comprehensive enterprise security sentinel auditing Python & NPM dependencies and threat-model defense. |
|
|
@@ -104,6 +113,7 @@
|
|
|
104
113
|
| `python tools/test_memory_os.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Hierarchical QA Test Memory OS (Letta / MemGPT Pattern) |
|
|
105
114
|
| `python tools/textgrad_mutation_optimizer.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Mutant-Directed Textual Loss Optimizer (Deterministic TextGrad-Style Heuristic) |
|
|
106
115
|
| `python tools/tms_sync_bridge.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise ALM & TMS Sync Bridge (Jira / Xray / Zephyr / TestRail) |
|
|
116
|
+
| `python tools/token_telemetry.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/token_telemetry.py — Live LLM Token & MTTR Telemetry Engine |
|
|
107
117
|
| `python tools/tot_exploratory_tester.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `read_only` | Tree-of-Thoughts exploratory scenario generator with risk scoring and boundary decomposition. |
|
|
108
118
|
| `python tools/trace_data_flow.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal Data Flow & Teardown Tracer (Taint Analysis) |
|
|
109
119
|
| `python tools/traffic_session_converter.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Converts recorded HAR traffic sessions into executable API automation test cases. |
|
|
@@ -126,4 +136,4 @@
|
|
|
126
136
|
- `network`: Queries external APIs, monitors npm registry, or checks live URLs.
|
|
127
137
|
- `destructive`: High-impact actions guarded by `safety_firewall.py` (e.g. drop database, hard resets).
|
|
128
138
|
|
|
129
|
-
*Catalog generated: `2026-11-
|
|
139
|
+
*Catalog generated: `2026-11-13T16:17:55.180336+00:00` by `tools/generate_tool_catalog.py`*
|
package/package.json
CHANGED
package/plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "synapse-hub",
|
|
3
3
|
"displayName": "Synapse Hub Enterprise QA",
|
|
4
|
-
"version": "4.
|
|
4
|
+
"version": "4.1.1",
|
|
5
5
|
"description": "Enterprise AI Agent Intelligence Hub & Autonomous Skill Network for Quality Engineering, Clean POM, and Automated Testing.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "TeeVee98",
|