@teevee98/synapse-hub 4.2.5 → 4.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/.agents/rules/author-integrity-guard.md +1 -0
  2. package/.agents/rules/communication-style.md +1 -0
  3. package/.agents/rules/context-engineering.md +1 -0
  4. package/.agents/rules/cypress_rules.md +46 -0
  5. package/.agents/rules/git-push-protocol.md +1 -0
  6. package/.agents/rules/graphify.md +1 -0
  7. package/.agents/rules/lessons-learned.md +1 -0
  8. package/.agents/rules/mandatory-playwright-live.md +8 -10
  9. package/.agents/rules/mobile_appium_rules.md +26 -10
  10. package/.agents/rules/performance_testing_rules.md +26 -5
  11. package/.agents/rules/security_testing_rules.md +21 -15
  12. package/.agents/rules/skill-precedence.md +11 -4
  13. package/.agents/rules/stack-auto-router.md +18 -12
  14. package/.agents/rules/systematic-debugging.md +1 -0
  15. package/.agents/skills/01-web-automation/clean-pom-crafter/SKILL.md +71 -2
  16. package/.agents/skills/01-web-automation/e2e-testing-patterns/SKILL.md +38 -0
  17. package/.agents/skills/01-web-automation/katalon-cli-runner/SKILL.md +27 -0
  18. package/.agents/skills/01-web-automation/mobile-maestro-detox-patterns/SKILL.md +134 -0
  19. package/.agents/skills/01-web-automation/mobile-maestro-detox-patterns/examples/sample_flow.yaml +6 -0
  20. package/.agents/skills/02-test-design/rbt-manual-testing/SKILL.md +30 -1
  21. package/.agents/skills/02-test-design/rbt-manual-testing/references/field_validation_checklist.md +13 -1
  22. package/.agents/skills/02-test-design/review-spec/SKILL.md +7 -0
  23. package/.agents/skills/03-api-and-contracts/api-spec-to-e2e-matrix/SKILL.md +15 -0
  24. package/.agents/skills/06-healing-and-resilience/failure-autopsy-and-healing/SKILL.md +12 -0
  25. package/.agents/skills/07-data-and-state/synthetic-test-data-generator/SKILL.md +30 -0
  26. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/SKILL.md +123 -0
  27. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/examples/sample_gitlab_ci.yml +17 -0
  28. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/SKILL.md +133 -0
  29. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/examples/Jenkinsfile.example +21 -0
  30. package/README.en.md +3 -3
  31. package/README.md +3 -3
  32. package/agentskills.json +2 -2
  33. package/docs/ARCHITECTURE.en.md +3 -3
  34. package/docs/ARCHITECTURE.md +2 -2
  35. package/docs/TOOL_CATALOG.md +1 -1
  36. package/package.json +1 -1
  37. package/plugin.json +1 -1
  38. package/scripts/install_global_plugin.ps1 +1 -1
  39. package/scripts/install_global_plugin.sh +1 -1
  40. package/skills_manifest.json +61 -4
  41. package/synapse.config.json +1 -1
  42. package/tools/TOOL_CATALOG.json +1 -1
  43. package/tools/__init__.py +1 -1
  44. package/tools/benchmark_swarm_context.py +1 -1
  45. package/tools/browser_helpers.js +2 -2
  46. package/tools/cli.py +4 -4
  47. package/tools/dashboard_generator.py +8 -8
  48. package/tools/mcp_docx_server.py +1 -1
  49. package/tools/mcp_excel_server.py +1 -1
  50. package/tools/mcp_server.py +1 -1
  51. package/tools/rules_router.py +4 -4
  52. package/tools/setup_project.py +91 -63
  53. package/tools/skill_canonical_digest.py +2 -2
  54. package/tools/ui_server.py +1 -1
  55. package/tools/update_sentinel.py +3 -3
  56. package/tools/verify_all.py +1 -1
  57. package/tools/welcome_page.py +2 -2
package/agentskills.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "https://agentskills.io/schema/v1.json",
3
3
  "name": "Synapse-Hub",
4
- "version": "4.2.5",
5
- "description": "Enterprise QA & Test Automation AI Skills Ecosystem — 53 skills organised across 11 Domain Packages adhering to Clean POM Flat Architecture.",
4
+ "version": "4.3.0",
5
+ "description": "Enterprise QA & Test Automation AI Skills Ecosystem — 56 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",
8
8
  "license": "MIT",
@@ -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.2.5` | **Status:** Active / Production Standard
6
+ > **Version:** `4.3.0` | **Status:** Active / Production Standard
7
7
 
8
8
  ---
9
9
 
@@ -16,7 +16,7 @@ The `Synapse-Hub` repository functions as a centralized **Intelligence Core (Hub
16
16
  ```mermaid
17
17
  flowchart TD
18
18
  subgraph Hub["Synapse Hub (Intelligence Core)"]
19
- Catalog["53 Standardized Skills (.agents/skills)"]
19
+ Catalog["56 Standardized Skills (.agents/skills)"]
20
20
  Rules["Core Architectural Rules (.agents/rules)"]
21
21
  Tools["Zero-Token Python Engine (tools/)"]
22
22
  Swarm["9 Specialized Subagents (.agents/agents)"]
@@ -42,7 +42,7 @@ flowchart TD
42
42
 
43
43
  ## 2. Four-Tier Skill Stratification
44
44
 
45
- The 53 skills in the hub are structured into four progressive operational tiers:
45
+ The 56 skills in the hub are structured into four progressive operational tiers:
46
46
 
47
47
 
48
48
  ```mermaid
@@ -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.2.5` | **Trạng thái:** Hoạt động / Tiêu chuẩn Sản xuất
6
+ > **Version:** `4.3.0` | **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
  ---
@@ -17,7 +17,7 @@ Kho lưu trữ `Synapse Hub` hoạt động theo mô hình **Hub & Spoke**: tron
17
17
  ```mermaid
18
18
  flowchart TD
19
19
  subgraph Hub["Synapse Hub (Bộ Não Trung Tâm)"]
20
- Catalog["53 Standardized Skills (.agents/skills)"]
20
+ Catalog["56 Standardized Skills (.agents/skills)"]
21
21
  Rules["Bộ Quy Tắc Cốt Lõi (.agents/rules)"]
22
22
  Tools["Bộ Công Cụ Python Zero-Token (tools/)"]
23
23
  Swarm["9 Subagent Chuyên Biệt (.agents/agents)"]
@@ -145,4 +145,4 @@
145
145
  - `network`: Queries external APIs, monitors npm registry, or checks live URLs.
146
146
  - `destructive`: High-impact actions guarded by `safety_firewall.py` (e.g. drop database, hard resets).
147
147
 
148
- *Catalog generated: `2026-11-16T07:34:48.105553+00:00` by `tools/generate_tool_catalog.py`*
148
+ *Catalog generated: `2026-11-16T14:33:14.461153+00:00` by `tools/generate_tool_catalog.py`*
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@teevee98/synapse-hub",
3
- "version": "4.2.5",
3
+ "version": "4.3.0",
4
4
  "description": "Enterprise AI Agent Intelligence Hub & Autonomous Skill Network",
5
5
  "publishConfig": {
6
6
  "access": "public"
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.2.5",
4
+ "version": "4.3.0",
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",
@@ -1,7 +1,7 @@
1
1
  # Enterprise Synapse-Hub Global Antigravity Plugin Installer (Windows)
2
2
  # ======================================================================
3
3
  # Mounts Synapse-Hub directly into Google Antigravity's Global Plugin Directory.
4
- # Once installed, all 53 skills and 9 subagents are active across all projects automatically.
4
+ # Once installed, all 56 skills and 9 subagents are active across all projects automatically.
5
5
 
6
6
  [CmdletBinding()]
7
7
  param()
@@ -2,7 +2,7 @@
2
2
  # Enterprise Synapse-Hub Global Antigravity Plugin Installer (macOS / Linux)
3
3
  # ======================================================================
4
4
  # Mounts Synapse-Hub directly into Google Antigravity's Global Plugin Directory.
5
- # Once installed, all 53 skills and 9 subagents are active across all projects automatically.
5
+ # Once installed, all 56 skills and 9 subagents are active across all projects automatically.
6
6
 
7
7
  set -e
8
8
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "name": "Synapse-Hub",
4
- "version": "4.2.5",
4
+ "version": "4.3.0",
5
5
  "description": "Unified Catalog of 53 Skills across 11 Domain Packages for Enterprise QA AI Agents.",
6
- "totalSkills": 53,
6
+ "totalSkills": 56,
7
7
  "domains": {
8
8
  "01-web-automation": {
9
9
  "id": "01-web-automation",
@@ -156,7 +156,10 @@
156
156
  "verification-before-completion",
157
157
  "qa-aci-interface",
158
158
  "qa-memory-os",
159
- "github-actions-templates"
159
+ "github-actions-templates",
160
+ "gitlab-ci-templates",
161
+ "jenkins-pipeline-templates",
162
+ "mobile-maestro-detox-patterns"
160
163
  ]
161
164
  },
162
165
  "perf-and-load": {
@@ -249,7 +252,7 @@
249
252
  },
250
253
  "full": {
251
254
  "name": "Complete Enterprise Hub",
252
- "description": "All 53 skills enabled across context optimization, multi-agent swarms, performance, and architecture.",
255
+ "description": "All 56 skills enabled across context optimization, multi-agent swarms, performance, and architecture.",
253
256
  "skills": "all"
254
257
  },
255
258
  "playwright": {
@@ -1274,6 +1277,60 @@
1274
1277
  "shell": "read-only",
1275
1278
  "filesystem": "read-only"
1276
1279
  }
1280
+ },
1281
+ {
1282
+ "id": "gitlab-ci-templates",
1283
+ "name": "GitLab CI Templates",
1284
+ "domain": "09-ci-and-devops",
1285
+ "category": "architecture_and_analysis",
1286
+ "path": ".agents/skills/09-ci-and-devops/gitlab-ci-templates/SKILL.md",
1287
+ "summary": "Production GitLab CI/CD pipeline blueprints for test automation, Playwright matrix sharding, Katalon KRE execution, and artifact retention governance.",
1288
+ "version": "1.0.0",
1289
+ "profiles": [
1290
+ "core-web-qa"
1291
+ ],
1292
+ "description": "Production GitLab CI/CD pipeline blueprints for test automation, Playwright matrix sharding, Katalon KRE execution, and artifact retention governance. Use when wiring test pipelines or quality gates into GitLab CI.",
1293
+ "policies": {
1294
+ "network": "none",
1295
+ "shell": "none",
1296
+ "filesystem": "workspace-sandbox"
1297
+ }
1298
+ },
1299
+ {
1300
+ "id": "jenkins-pipeline-templates",
1301
+ "name": "Jenkins Pipeline Templates",
1302
+ "domain": "09-ci-and-devops",
1303
+ "category": "architecture_and_analysis",
1304
+ "path": ".agents/skills/09-ci-and-devops/jenkins-pipeline-templates/SKILL.md",
1305
+ "summary": "Enterprise Jenkins Declarative Pipeline templates for test automation, parallel stages, Katalon KRE runner, JUnit reporting, and workspace hygiene.",
1306
+ "version": "1.0.0",
1307
+ "profiles": [
1308
+ "core-web-qa"
1309
+ ],
1310
+ "description": "Enterprise Jenkins Declarative Pipeline templates for test automation, parallel stages, Katalon KRE runner, JUnit reporting, and workspace hygiene. Use when configuring Jenkins pipelines or quality gates.",
1311
+ "policies": {
1312
+ "network": "none",
1313
+ "shell": "none",
1314
+ "filesystem": "workspace-sandbox"
1315
+ }
1316
+ },
1317
+ {
1318
+ "id": "mobile-maestro-detox-patterns",
1319
+ "name": "Mobile Maestro and Detox Patterns",
1320
+ "domain": "01-web-automation",
1321
+ "category": "test_automation_and_execution",
1322
+ "path": ".agents/skills/01-web-automation/mobile-maestro-detox-patterns/SKILL.md",
1323
+ "summary": "Declarative mobile UI test patterns for Maestro flows and Detox gray-box automation on React Native and native mobile apps.",
1324
+ "version": "1.0.0",
1325
+ "profiles": [
1326
+ "core-web-qa"
1327
+ ],
1328
+ "description": "Declarative mobile UI test patterns for Maestro flows and Detox gray-box automation on React Native and native mobile apps. Use when authoring declarative mobile flows or fast gray-box mobile tests.",
1329
+ "policies": {
1330
+ "network": "localhost-only",
1331
+ "shell": "workspace-sandbox",
1332
+ "filesystem": "workspace-sandbox"
1333
+ }
1277
1334
  }
1278
1335
  ]
1279
1336
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://raw.githubusercontent.com/TeeVee98/Synapse-Hub/main/docs/schemas/synapse.config.schema.json",
3
- "version": "4.2.5",
3
+ "version": "4.3.0",
4
4
  "quality_gates": {
5
5
  "mutation_min_score": 80,
6
6
  "gates": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schema_version": "1.0.0",
3
- "updated_at": "2026-11-16T07:34:48.105553+00:00",
3
+ "updated_at": "2026-11-16T14:33:14.461153+00:00",
4
4
  "total_tools": 130,
5
5
  "stable_count": 130,
6
6
  "experimental_count": 0,
package/tools/__init__.py CHANGED
@@ -17,7 +17,7 @@ Domain Packages:
17
17
  - tools.mcp: Model Context Protocol servers (core QA and Excel manipulation).
18
18
  """
19
19
 
20
- __version__ = "4.2.5"
20
+ __version__ = "4.3.0"
21
21
  __author__ = "Thế Vị (@TeeVee98)"
22
22
 
23
23
  # Expose domain packages
@@ -511,7 +511,7 @@ def format_markdown_report(bench: Dict[str, Any]) -> str:
511
511
  "",
512
512
  "## Track 2: Empirical Reference Suites Benchmark (Static Workspace Inspection)",
513
513
  "",
514
- "> *Methodology: Dynamically enumerates all 13 rules and 53 skills in repository without static per-skill multiplier assumptions.*",
514
+ "> *Methodology: Dynamically enumerates all 14 rules and 56 skills in repository without static per-skill multiplier assumptions.*",
515
515
  "> *Disclosure: 'Avoided Disk Read (I/O)' measures filesystem file size bytes not read from storage; it is strictly distinguished from context tokens and is not billed token savings.*",
516
516
  "",
517
517
  "| Reference Project | Detected Stack | Confidence | Catalog Summary Saved | Full Hydration Saved | Avoided Disk Read (I/O) |",
@@ -13,7 +13,7 @@
13
13
  (function () {
14
14
  'use strict';
15
15
 
16
- if (window.__qa && window.__qa.__version === '4.2.5') {
16
+ if (window.__qa && window.__qa.__version === '4.3.0') {
17
17
  return window.__qa;
18
18
  }
19
19
 
@@ -47,7 +47,7 @@
47
47
  }
48
48
 
49
49
  const qa = {
50
- __version: '4.2.5',
50
+ __version: '4.3.0',
51
51
 
52
52
  /**
53
53
  * 1. Smart Action Batching
package/tools/cli.py CHANGED
@@ -133,8 +133,8 @@ def _resolve_manifest_path(repo_root: Optional[str] = None) -> Optional[str]:
133
133
  def cmd_version(args):
134
134
  """Displays the current hub version, skill catalog count, and license information."""
135
135
  manifest_path = _resolve_manifest_path()
136
- version = "4.2.5"
137
- manifest_skills = 53
136
+ version = "4.3.0"
137
+ manifest_skills = 56
138
138
  if manifest_path and os.path.exists(manifest_path):
139
139
  try:
140
140
  import json
@@ -775,14 +775,14 @@ def cmd_trend(args):
775
775
 
776
776
  def _hub_version():
777
777
  manifest_path = _resolve_manifest_path()
778
- version = "4.2.5"
778
+ version = "4.3.0"
779
779
  if manifest_path and os.path.exists(manifest_path):
780
780
  try:
781
781
  import json
782
782
  with open(manifest_path, "r", encoding="utf-8") as f:
783
783
  version = json.load(f).get("version", version)
784
784
  except (OSError, json.JSONDecodeError):
785
- version = "4.2.5"
785
+ version = "4.3.0"
786
786
  return version
787
787
 
788
788
 
@@ -1350,7 +1350,7 @@ def _build_target_translations(
1350
1350
  "th_step_status": "Trạng Thái",
1351
1351
  "th_step_details": "Chi Tiết Kỹ Thuật (OTel & AST)",
1352
1352
 
1353
- "footer_text": "Báo cáo được khởi tạo tự động bởi Synapse-Hub v4.2.5 • Bản quyền © Thế Vị (@TeeVee98) • Chuẩn Clean POM & Kiểm Thử Tự Chủ",
1353
+ "footer_text": "Báo cáo được khởi tạo tự động bởi Synapse-Hub v4.3.0 • Bản quyền © Thế Vị (@TeeVee98) • Chuẩn Clean POM & Kiểm Thử Tự Chủ",
1354
1354
  }
1355
1355
 
1356
1356
  translations_en = {
@@ -1428,7 +1428,7 @@ def _build_target_translations(
1428
1428
  "th_step_status": "Status",
1429
1429
  "th_step_details": "Technical Details (OTel & AST)",
1430
1430
 
1431
- "footer_text": "Generated automatically by Synapse-Hub v4.2.5 • Copyright © Thế Vị (@TeeVee98) • Clean POM & Autonomous Testing",
1431
+ "footer_text": "Generated automatically by Synapse-Hub v4.3.0 • Copyright © Thế Vị (@TeeVee98) • Clean POM & Autonomous Testing",
1432
1432
  }
1433
1433
 
1434
1434
  _inject_gate_translations(translations_vi, translations_en, gates)
@@ -1911,13 +1911,13 @@ def _build_hub_translations(
1911
1911
  now_str: str,
1912
1912
  bench: Dict[str, Any],
1913
1913
  gates: List[Dict[str, str]],
1914
- total_skills: int = 53,
1914
+ total_skills: int = 56,
1915
1915
  skills: Optional[List[Dict[str, Any]]] = None,
1916
1916
  ) -> Tuple[Dict[str, str], Dict[str, str]]:
1917
1917
  """Builds bilingual dictionaries for Hub Dashboard."""
1918
1918
  translations_vi = {
1919
1919
  "header_title": "Bảng Điều Hành Chất Lượng Doanh Nghiệp",
1920
- "header_subtitle": "Synapse-Hub v4.2.5 • Hệ Sinh Thái Kiểm Thử AI Agent Tự Chủ",
1920
+ "header_subtitle": "Synapse-Hub v4.3.0 • Hệ Sinh Thái Kiểm Thử AI Agent Tự Chủ",
1921
1921
  "nav_welcome": "Giới Thiệu",
1922
1922
  "meta_mode": "🏷️ Chế độ: <strong>HỆ SINH THÁI QA HUB</strong>",
1923
1923
  "meta_gen": f"🕒 Khởi tạo: <strong>{now_str}</strong>",
@@ -1987,12 +1987,12 @@ def _build_hub_translations(
1987
1987
  "th_sk_ver": "Phiên Bản",
1988
1988
  "th_sk_cap": "Khả Năng Nghiệp Vụ Cốt Lõi",
1989
1989
 
1990
- "footer_text": "Bảng Điều Hành Chất Lượng Doanh Nghiệp &bull; Synapse-Hub v4.2.5 &bull; Bản quyền &copy; Thế Vị (@TeeVee98) &bull; Hệ Thống Kiểm Thử AI Agent Tự Chủ",
1990
+ "footer_text": "Bảng Điều Hành Chất Lượng Doanh Nghiệp &bull; Synapse-Hub v4.3.0 &bull; Bản quyền &copy; Thế Vị (@TeeVee98) &bull; Hệ Thống Kiểm Thử AI Agent Tự Chủ",
1991
1991
  }
1992
1992
 
1993
1993
  translations_en = {
1994
1994
  "header_title": "Enterprise QA Executive Dashboard",
1995
- "header_subtitle": "Synapse-Hub v4.2.5 &bull; Autonomous AI Agent Testing Ecosystem",
1995
+ "header_subtitle": "Synapse-Hub v4.3.0 &bull; Autonomous AI Agent Testing Ecosystem",
1996
1996
  "nav_welcome": "Welcome",
1997
1997
  "meta_mode": "🏷️ Mode: <strong>QA HUB ECOSYSTEM</strong>",
1998
1998
  "meta_gen": f"🕒 Generated: <strong>{now_str}</strong>",
@@ -2062,7 +2062,7 @@ def _build_hub_translations(
2062
2062
  "th_sk_ver": "Version",
2063
2063
  "th_sk_cap": "Core Capabilities",
2064
2064
 
2065
- "footer_text": "Enterprise QA Executive Dashboard &bull; Synapse-Hub v4.2.5 &bull; Copyright &copy; Thế Vị (@TeeVee98) &bull; Autonomous AI Agent Testing Ecosystem",
2065
+ "footer_text": "Enterprise QA Executive Dashboard &bull; Synapse-Hub v4.3.0 &bull; Copyright &copy; Thế Vị (@TeeVee98) &bull; Autonomous AI Agent Testing Ecosystem",
2066
2066
  }
2067
2067
 
2068
2068
  _inject_gate_translations(translations_vi, translations_en, gates)
@@ -2258,7 +2258,7 @@ def generate_hub_html(
2258
2258
  now_str = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
2259
2259
  total_skills = manifest.get("totalSkills", len(manifest.get("skills", [])))
2260
2260
  if total_skills == 0:
2261
- total_skills = 53
2261
+ total_skills = 56
2262
2262
  skills = manifest.get("skills", [])
2263
2263
 
2264
2264
  gates = _get_hub_gates()
@@ -60,7 +60,7 @@ if hasattr(sys.stdout, 'reconfigure'):
60
60
  except Exception:
61
61
  pass
62
62
 
63
- SERVER_VERSION = "4.2.5"
63
+ SERVER_VERSION = "4.3.0"
64
64
  MAX_DOCX_SIZE = 50 * 1024 * 1024 # 50 MB
65
65
  MAX_UNCOMPRESSED_SIZE = 200 * 1024 * 1024 # 200 MB
66
66
  MAX_RATIO = 100 # 100:1 compression ratio limit
@@ -55,7 +55,7 @@ if hasattr(sys.stdout, 'reconfigure'):
55
55
  except Exception:
56
56
  pass
57
57
 
58
- SERVER_VERSION = "4.2.5"
58
+ SERVER_VERSION = "4.3.0"
59
59
  MAX_XLSX_SIZE = 50 * 1024 * 1024 # 50 MB
60
60
  MAX_UNCOMPRESSED_SIZE = 200 * 1024 * 1024 # 200 MB
61
61
  MAX_RATIO = 100 # 100:1 compression ratio limit
@@ -50,7 +50,7 @@ import gherkin_suite
50
50
  import api_fuzzer
51
51
 
52
52
  SERVER_NAME = "enterprise-agent-qa"
53
- SERVER_VERSION = "4.2.5"
53
+ SERVER_VERSION = "4.3.0"
54
54
 
55
55
  MCP_TOOLS = [
56
56
  {
@@ -85,10 +85,10 @@ except ImportError:
85
85
 
86
86
  def get_full_unrouted_baseline(repo_root: str) -> Dict[str, Any]:
87
87
  return {
88
- "rule_count": 13,
88
+ "rule_count": 14,
89
89
  "rule_tokens": 8420,
90
90
  "rule_bytes": 31927,
91
- "skill_count": 53,
91
+ "skill_count": 56,
92
92
  "skill_full_body_tokens": 61769,
93
93
  "skill_full_bytes": 232833,
94
94
  "skill_catalog_tokens": 3750,
@@ -111,7 +111,7 @@ CORE_BASE_RULES = [
111
111
  # Stack-to-Rule mappings
112
112
  STACK_RULE_MAPPINGS = {
113
113
  "playwright": ["mandatory-playwright-live.md", "systematic-debugging.md"],
114
- "cypress": ["systematic-debugging.md"],
114
+ "cypress": ["cypress_rules.md", "systematic-debugging.md"],
115
115
  "mobile": ["mobile_appium_rules.md", "systematic-debugging.md"],
116
116
  "katalon": ["systematic-debugging.md"],
117
117
  "selenium": ["systematic-debugging.md"],
@@ -193,7 +193,7 @@ TASK_TYPE_CONFIGS: Dict[str, Dict[str, Any]] = {
193
193
  "rules": ["mandatory-playwright-live.md", "systematic-debugging.md"],
194
194
  "primary_skills": ["clean-pom-crafter"],
195
195
  "secondary_skills": ["self-healing-locator"],
196
- "default_token_cap": 6000,
196
+ "default_token_cap": 7000,
197
197
  },
198
198
  "triage": {
199
199
  "rules": ["systematic-debugging.md"],
@@ -391,7 +391,7 @@ def inject_antigravity_global_plugin():
391
391
  """
392
392
  Automatically injects Synapse-Hub into Antigravity's Global Plugin Directory
393
393
  (~/.gemini/config/plugins/synapse-hub).
394
- Ensures that running `npx @teevee98/synapse-hub setup` activates the 53 skills and 9 subagents
394
+ Ensures that running `npx @teevee98/synapse-hub setup` activates the 56 skills and 9 subagents
395
395
  globally across ALL projects in Google Antigravity.
396
396
  """
397
397
  try:
@@ -464,81 +464,102 @@ def inject_antigravity_global_plugin():
464
464
  return False
465
465
 
466
466
 
467
- def install_universal_ai_bridges(target_dir):
467
+ def install_universal_ai_bridges(target_dir, ide="all"):
468
468
  """
469
469
  Deploys Universal AI Bridge configuration files into the target project workspace
470
470
  for seamless integration with Cursor, Claude Code, GitHub Copilot, and Windsurf.
471
+ Supports IDE-selective deployment to save 1,500-2,500 prompt tokens per turn:
472
+ - 'all' / 'auto': deploys standard bridges (Cursor modern, Claude, Copilot, Windsurf)
473
+ - 'cursor': deploys only .cursor/rules/synapse-qa.mdc (avoids legacy .cursorrules redundancy)
474
+ - 'cursor-legacy': deploys only .cursorrules
475
+ - 'windsurf': deploys only .windsurfrules
476
+ - 'claude': deploys only CLAUDE.md
477
+ - 'copilot': deploys only .github/copilot-instructions.md
471
478
  """
472
479
  bridges_dir = os.path.join(TEMPLATES_DIR, "ai_bridges")
473
480
  if not os.path.exists(bridges_dir):
474
481
  return False
475
482
 
476
483
  deployed = []
477
-
478
- # 1. Cursor (.cursor/rules/synapse-qa.mdc)
479
- cursor_dir = os.path.join(target_dir, ".cursor", "rules")
480
- os.makedirs(cursor_dir, exist_ok=True)
481
- src_cursor = os.path.join(bridges_dir, "cursor_synapse_qa.mdc")
482
- dst_cursor = os.path.join(cursor_dir, "synapse-qa.mdc")
483
- if os.path.exists(src_cursor):
484
- shutil.copy2(src_cursor, dst_cursor)
485
- deployed.append("Cursor (.cursor/rules/synapse-qa.mdc)")
484
+ ide_choice = (ide or "all").lower().strip()
485
+ install_all = ide_choice in ("all", "auto")
486
+
487
+ # 1. Cursor Modern (.cursor/rules/synapse-qa.mdc)
488
+ if install_all or ide_choice == "cursor":
489
+ cursor_dir = os.path.join(target_dir, ".cursor", "rules")
490
+ os.makedirs(cursor_dir, exist_ok=True)
491
+ src_cursor = os.path.join(bridges_dir, "cursor_synapse_qa.mdc")
492
+ dst_cursor = os.path.join(cursor_dir, "synapse-qa.mdc")
493
+ if os.path.exists(src_cursor):
494
+ shutil.copy2(src_cursor, dst_cursor)
495
+ deployed.append("Cursor (.cursor/rules/synapse-qa.mdc)")
496
+
497
+ # 1b. Cursor Legacy (.cursorrules)
498
+ if ide_choice == "cursor-legacy":
499
+ src_cr = os.path.join(HUB_ROOT, ".cursorrules")
500
+ dst_cr = os.path.join(target_dir, ".cursorrules")
501
+ if os.path.exists(src_cr):
502
+ shutil.copy2(src_cr, dst_cr)
503
+ deployed.append("Cursor Legacy (.cursorrules)")
486
504
 
487
505
  # 2. Claude Code (CLAUDE.md)
488
- dst_claude = os.path.join(target_dir, "CLAUDE.md")
489
- src_claude = os.path.join(bridges_dir, "CLAUDE.md")
490
- if os.path.exists(src_claude):
491
- if not os.path.exists(dst_claude):
492
- shutil.copy2(src_claude, dst_claude)
493
- deployed.append("Claude Code (CLAUDE.md)")
494
- else:
495
- with open(dst_claude, "r", encoding="utf-8", errors="ignore") as f:
496
- c_content = f.read()
497
- if "Synapse-Hub" not in c_content:
498
- with open(src_claude, "r", encoding="utf-8") as f:
499
- append_data = f.read()
500
- with open(dst_claude, "a", encoding="utf-8") as f:
501
- f.write("\n\n" + append_data)
502
- deployed.append("Claude Code (appended to CLAUDE.md)")
506
+ if install_all or ide_choice == "claude":
507
+ dst_claude = os.path.join(target_dir, "CLAUDE.md")
508
+ src_claude = os.path.join(bridges_dir, "CLAUDE.md")
509
+ if os.path.exists(src_claude):
510
+ if not os.path.exists(dst_claude):
511
+ shutil.copy2(src_claude, dst_claude)
512
+ deployed.append("Claude Code (CLAUDE.md)")
513
+ else:
514
+ with open(dst_claude, "r", encoding="utf-8", errors="ignore") as f:
515
+ c_content = f.read()
516
+ if "Synapse-Hub" not in c_content:
517
+ with open(src_claude, "r", encoding="utf-8") as f:
518
+ append_data = f.read()
519
+ with open(dst_claude, "a", encoding="utf-8") as f:
520
+ f.write("\n\n" + append_data)
521
+ deployed.append("Claude Code (appended to CLAUDE.md)")
503
522
 
504
523
  # 3. GitHub Copilot (.github/copilot-instructions.md)
505
- github_dir = os.path.join(target_dir, ".github")
506
- os.makedirs(github_dir, exist_ok=True)
507
- dst_copilot = os.path.join(github_dir, "copilot-instructions.md")
508
- src_copilot = os.path.join(bridges_dir, "copilot-instructions.md")
509
- if os.path.exists(src_copilot):
510
- if not os.path.exists(dst_copilot):
511
- shutil.copy2(src_copilot, dst_copilot)
512
- deployed.append("GitHub Copilot (.github/copilot-instructions.md)")
513
- else:
514
- with open(dst_copilot, "r", encoding="utf-8", errors="ignore") as f:
515
- cp_content = f.read()
516
- if "Synapse-Hub" not in cp_content:
517
- with open(src_copilot, "r", encoding="utf-8") as f:
518
- append_data = f.read()
519
- with open(dst_copilot, "a", encoding="utf-8") as f:
520
- f.write("\n\n" + append_data)
521
- deployed.append("GitHub Copilot (appended to copilot-instructions.md)")
524
+ if install_all or ide_choice == "copilot":
525
+ github_dir = os.path.join(target_dir, ".github")
526
+ os.makedirs(github_dir, exist_ok=True)
527
+ dst_copilot = os.path.join(github_dir, "copilot-instructions.md")
528
+ src_copilot = os.path.join(bridges_dir, "copilot-instructions.md")
529
+ if os.path.exists(src_copilot):
530
+ if not os.path.exists(dst_copilot):
531
+ shutil.copy2(src_copilot, dst_copilot)
532
+ deployed.append("GitHub Copilot (.github/copilot-instructions.md)")
533
+ else:
534
+ with open(dst_copilot, "r", encoding="utf-8", errors="ignore") as f:
535
+ cp_content = f.read()
536
+ if "Synapse-Hub" not in cp_content:
537
+ with open(src_copilot, "r", encoding="utf-8") as f:
538
+ append_data = f.read()
539
+ with open(dst_copilot, "a", encoding="utf-8") as f:
540
+ f.write("\n\n" + append_data)
541
+ deployed.append("GitHub Copilot (appended to copilot-instructions.md)")
522
542
 
523
543
  # 4. Windsurf (.windsurfrules)
524
- dst_windsurf = os.path.join(target_dir, ".windsurfrules")
525
- src_windsurf = os.path.join(bridges_dir, "windsurfrules")
526
- if os.path.exists(src_windsurf):
527
- if not os.path.exists(dst_windsurf):
528
- shutil.copy2(src_windsurf, dst_windsurf)
529
- deployed.append("Windsurf (.windsurfrules)")
530
- else:
531
- with open(dst_windsurf, "r", encoding="utf-8", errors="ignore") as f:
532
- w_content = f.read()
533
- if "Synapse-Hub" not in w_content:
534
- with open(src_windsurf, "r", encoding="utf-8") as f:
535
- append_data = f.read()
536
- with open(dst_windsurf, "a", encoding="utf-8") as f:
537
- f.write("\n\n" + append_data)
538
- deployed.append("Windsurf (appended to .windsurfrules)")
544
+ if install_all or ide_choice == "windsurf":
545
+ dst_windsurf = os.path.join(target_dir, ".windsurfrules")
546
+ src_windsurf = os.path.join(bridges_dir, "windsurfrules")
547
+ if os.path.exists(src_windsurf):
548
+ if not os.path.exists(dst_windsurf):
549
+ shutil.copy2(src_windsurf, dst_windsurf)
550
+ deployed.append("Windsurf (.windsurfrules)")
551
+ else:
552
+ with open(dst_windsurf, "r", encoding="utf-8", errors="ignore") as f:
553
+ w_content = f.read()
554
+ if "Synapse-Hub" not in w_content:
555
+ with open(src_windsurf, "r", encoding="utf-8") as f:
556
+ append_data = f.read()
557
+ with open(dst_windsurf, "a", encoding="utf-8") as f:
558
+ f.write("\n\n" + append_data)
559
+ deployed.append("Windsurf (appended to .windsurfrules)")
539
560
 
540
561
  if deployed:
541
- print(f" {GREEN}[OK] Deployed Universal AI Bridges:{RESET} {', '.join(deployed)}")
562
+ print(f" {GREEN}[OK] Deployed Universal AI Bridges ({ide_choice}):{RESET} {', '.join(deployed)}")
542
563
  return True
543
564
 
544
565
 
@@ -600,7 +621,7 @@ def uninstall_setup(target_repo: str) -> int:
600
621
  return 0
601
622
 
602
623
 
603
- def run_setup(target_repo, dry_run=False, profile="auto", no_global=True, no_git_hook=False, no_browser=True, open_browser=False):
624
+ def run_setup(target_repo, dry_run=False, profile="auto", no_global=True, no_git_hook=False, no_browser=True, open_browser=False, ide="all"):
604
625
  """Main execution entrypoint for automated project setup."""
605
626
  print(f"\n{BOLD}{CYAN}======================================================================{RESET}")
606
627
  print(f"{BOLD}{CYAN} AUTONOMOUS ZERO-COMMAND PROJECT BOOTSTRAP (AI-READY SETUP) {RESET}")
@@ -653,8 +674,8 @@ def run_setup(target_repo, dry_run=False, profile="auto", no_global=True, no_git
653
674
  ensure_synapse_config(target_repo)
654
675
 
655
676
  # 3. Deploy Universal AI Bridges (Cursor, Claude Code, GitHub Copilot, Windsurf)
656
- print(f"\n{BOLD}[2/5] Deploying Universal AI Bridges (Cursor, Claude, Copilot, Windsurf)...{RESET}")
657
- install_universal_ai_bridges(target_repo)
677
+ print(f"\n{BOLD}[2/5] Deploying Universal AI Bridges (ide={ide})...{RESET}")
678
+ install_universal_ai_bridges(target_repo, ide=ide)
658
679
 
659
680
  # 4. Inject Antigravity Global Plugin
660
681
  plugin_injected = False
@@ -732,6 +753,12 @@ def main():
732
753
  choices=["auto", "core", "web-e2e", "api-perf", "full", "playwright", "pytest", "cypress", "katalon"],
733
754
  help="Skills profile to install (auto, core, web-e2e, api-perf, full, playwright, pytest, cypress, katalon)"
734
755
  )
756
+ parser.add_argument(
757
+ "--ide",
758
+ default="all",
759
+ choices=["auto", "all", "cursor", "cursor-legacy", "windsurf", "claude", "copilot"],
760
+ help="Target IDE AI bridge to install (auto, all, cursor, cursor-legacy, windsurf, claude, copilot)"
761
+ )
735
762
  parser.add_argument("--dry-run", action="store_true", help="Simulate setup actions without modifying disk")
736
763
  parser.add_argument("--uninstall", action="store_true", help="Revert and remove files installed by setup_project")
737
764
  parser.add_argument("--global", action="store_true", dest="enable_global", default=False,
@@ -767,7 +794,8 @@ def main():
767
794
  no_global=use_no_global,
768
795
  no_git_hook=args.no_git_hook,
769
796
  no_browser=no_browser,
770
- open_browser=open_browser
797
+ open_browser=open_browser,
798
+ ide=args.ide
771
799
  )
772
800
 
773
801