synapse-hub 2.4.1 → 2.4.3

package/benchmarks/qa_eval/dataset/timing_and_race/qa-challenge-14_timing_and_race.json

@@ -1,22 +1,22 @@
-{
-  "id": "QA-CHALLENGE-14",
-  "name": "Async Chart SVG Animation Race Condition",
-  "category": "timing_and_race",
-  "difficulty": "MEDIUM",
-  "description": "Financial chart takes 1200ms to calculate series and render SVG paths.",
-  "failure_vector": {
-    "type": "ASYNC_RENDER_RACE",
-    "broken_code": "page.click('.chart-bar:last-child')",
-    "error_log": "ElementNotFoundException: Selector '.chart-bar:last-child' not found",
-    "environment_condition": "Highcharts Rendering Animation"
-  },
-  "expected_resolution": {
-    "healed_code": "page.waitForSelector('.highcharts-series path', state: 'visible'); page.click('.chart-bar:last-child')",
-    "strategy": "SVG_VISIBILITY_SMART_WAIT"
-  },
-  "benchmark_targets": {
-    "max_heal_time_sec": 2.0,
-    "max_token_cost": 310,
-    "min_confidence_score": 0.9
-  }
+{
+  "id": "QA-CHALLENGE-14",
+  "name": "Async Chart SVG Animation Race Condition",
+  "category": "timing_and_race",
+  "difficulty": "MEDIUM",
+  "description": "Financial chart takes 1200ms to calculate series and render SVG paths.",
+  "failure_vector": {
+    "type": "ASYNC_RENDER_RACE",
+    "broken_code": "page.click('.chart-bar:last-child')",
+    "error_log": "ElementNotFoundException: Selector '.chart-bar:last-child' not found",
+    "environment_condition": "Highcharts Rendering Animation"
+  },
+  "expected_resolution": {
+    "healed_code": "page.waitForSelector('.highcharts-series path', state: 'visible'); page.click('.chart-bar:last-child')",
+    "strategy": "SVG_VISIBILITY_SMART_WAIT"
+  },
+  "benchmark_targets": {
+    "max_heal_time_sec": 2.0,
+    "max_token_cost": 310,
+    "min_confidence_score": 0.9
+  }
 }

package/benchmarks/qa_eval/dataset/timing_and_race/qa-challenge-15_timing_and_race.json

@@ -1,22 +1,22 @@
-{
-  "id": "QA-CHALLENGE-15",
-  "name": "Infinite Scroll Lazy Loaded Chunk Detach",
-  "category": "timing_and_race",
-  "difficulty": "MEDIUM",
-  "description": "Table rows 50-100 require viewport scroll to trigger network chunk download.",
-  "failure_vector": {
-    "type": "LAZY_LOAD_RACE",
-    "broken_code": "page.locator('tr[data-id=\"75\"]').click()",
-    "error_log": "TimeoutException: Timed out waiting for 'tr[data-id=\"75\"]' to be visible",
-    "environment_condition": "Virtual Scrolling Table"
-  },
-  "expected_resolution": {
-    "healed_code": "page.locator('tr[data-id=\"75\"]').scrollIntoViewIfNeeded(); page.locator('tr[data-id=\"75\"]').click()",
-    "strategy": "VIRTUAL_SCROLL_INTO_VIEW"
-  },
-  "benchmark_targets": {
-    "max_heal_time_sec": 2.0,
-    "max_token_cost": 300,
-    "min_confidence_score": 0.92
-  }
+{
+  "id": "QA-CHALLENGE-15",
+  "name": "Infinite Scroll Lazy Loaded Chunk Detach",
+  "category": "timing_and_race",
+  "difficulty": "MEDIUM",
+  "description": "Table rows 50-100 require viewport scroll to trigger network chunk download.",
+  "failure_vector": {
+    "type": "LAZY_LOAD_RACE",
+    "broken_code": "page.locator('tr[data-id=\"75\"]').click()",
+    "error_log": "TimeoutException: Timed out waiting for 'tr[data-id=\"75\"]' to be visible",
+    "environment_condition": "Virtual Scrolling Table"
+  },
+  "expected_resolution": {
+    "healed_code": "page.locator('tr[data-id=\"75\"]').scrollIntoViewIfNeeded(); page.locator('tr[data-id=\"75\"]').click()",
+    "strategy": "VIRTUAL_SCROLL_INTO_VIEW"
+  },
+  "benchmark_targets": {
+    "max_heal_time_sec": 2.0,
+    "max_token_cost": 300,
+    "min_confidence_score": 0.92
+  }
 }

package/docs/ARCHITECTURE.md

@@ -1,7 +1,7 @@
 # Agent-Skills Architecture & Design Principles
 
 > **Scope:** Enterprise Multi-Agent QA Hub  
-> **Version:** `2.4.1` | **Status:** Active / Production Standard
+> **Version:** `2.4.3` | **Status:** Active / Production Standard
 
 ---
 
@@ -105,3 +105,14 @@ The Hub equips 6 specialized subagents with scoped tool and skill permissions:
 | **`test-runner`** | Headless CLI test execution & CI | `katalon-cli-runner`, `e2e-testing-patterns`, `flaky-test-sentinel-and-quarantine`, `backend-load-and-stress-patterns`, `github-actions-templates` | `matrix_sharder.py`, `distill_log.py`, `pinpoint_failure.py`, `flaky_detector.py` |
 | **`failure-analyst`**| Visual & XML error autopsy | `failure-autopsy-and-healing`, `self-healing-locator`, `file-and-report-validator` | `auto_heal.py`, `heal_pr_automator.py`, `pinpoint_failure.py`, `cache_resolver.py` |
 | **`quality-gatekeeper`**| 9 Gates DoD & Fake-Pass Sentinel | `antigravity-test-sentinel`, `code-refactoring-refactor-clean`, `wcag-audit-patterns`, `web-vitals-and-performance-profiler`, `security-dast-sentinel` | `verify_all.py`, `infer_linter.py`, `micro_mutator.py`, `trace_data_flow.py` |
+
+---
+
+## 6. Nomenclature & Package Architecture
+
+To ensure consistency across various distribution registries and developer interfaces:
+- **Ecosystem / Project Name:** Synapse Hub (`Synapse-Hub` on GitHub)
+- **NPM Package & Antigravity Plugin:** `synapse-hub` (distributed on NPM Registry and Antigravity Marketplace)
+- **Python Package & Universal CLI:** `agent-qa` (PEP 621 package on PyPI providing the `agent-qa` CLI binary)
+- **MCP Server Protocol Services:** `enterprise-agent-qa` (Core QA MCP server) and `synapse-mcp-excel` (Excel tool server)
+- **Skill Catalog Manifest:** `enterprise-agent-skills-hub` (internal catalog schema identifier in `skills_manifest.json`)

package/package.json

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

package/scripts/install.ps1

@@ -1,112 +1,112 @@
-<#
-.SYNOPSIS
-    One-click setup and dependency bootstrap script for Enterprise Agent-Skills Hub.
-.DESCRIPTION
-    Detects and installs Python, Node.js, Playwright, sets up a clean virtual environment,
-    installs requirements.txt, and verifies the full 38-skill catalog.
-#>
-
-[CmdletBinding()]
-param(
-    [switch]$ForceInstall = $false
-)
-
-Write-Host "==========================================================" -ForegroundColor Cyan
-Write-Host "  Enterprise Agent-Skills Hub: Automated Bootstrap Setup  " -ForegroundColor Cyan
-Write-Host "==========================================================" -ForegroundColor Cyan
-
-$repoRoot = Split-Path -Parent $PSScriptRoot
-Set-Location $repoRoot
-
-# 1. Verify / Install Python
-Write-Host "`n[1/5] Checking Python 3 Runtime..." -ForegroundColor Yellow
-$py = $null
-foreach ($cmd in @("python", "python3", "py")) {
-    try {
-        $v = & $cmd --version 2>&1
-        if ($LASTEXITCODE -eq 0 -and $v -match "Python\s+3\.(1[0-9]|[2-9][0-9])") {
-            $py = $cmd
-            Write-Host "  [OK] Found Python: $v" -ForegroundColor Green
-            break
-        }
-    } catch { }
-}
-
-if (-not $py) {
-    Write-Host "  [WARN] Python 3.10+ not found in PATH." -ForegroundColor Yellow
-    Write-Host "  Attempting automated installation via winget..." -ForegroundColor Cyan
-    try {
-        winget install -e --id Python.Python.3.11 --accept-source-agreements --accept-package-agreements --scope currentUser
-        Write-Host "  [OK] Python 3.11 installed. Please restart your shell if PATH is not updated." -ForegroundColor Green
-    } catch {
-        Write-Host "  [FAIL] Could not auto-install Python. Please install from https://python.org" -ForegroundColor Red
-    }
-}
-
-# 2. Virtual Environment Setup
-Write-Host "`n[2/5] Setting up Virtual Environment (.venv)..." -ForegroundColor Yellow
-$venvDir = Join-Path $repoRoot ".venv"
-if (-not (Test-Path $venvDir) -and $py) {
-    Write-Host "  Creating virtual environment at $venvDir..." -ForegroundColor Cyan
-    & $py -m venv $venvDir
-}
-
-$venvPython = if ($IsWindows -or $env:OS -match "Windows") {
-    Join-Path $venvDir "Scripts\python.exe"
-} else {
-    Join-Path $venvDir "bin/python"
-}
-
-# 3. Pip Dependencies
-Write-Host "`n[3/5] Installing Core Python Dependencies..." -ForegroundColor Yellow
-$reqFile = Join-Path $repoRoot "requirements.txt"
-if (Test-Path $venvPython) {
-    Write-Host "  Upgrading pip & wheel..." -ForegroundColor Cyan
-    & $venvPython -m pip install --upgrade pip setuptools wheel --quiet
-    if (Test-Path $reqFile) {
-        Write-Host "  Installing requirements from requirements.txt..." -ForegroundColor Cyan
-        & $venvPython -m pip install -r $reqFile --quiet
-        Write-Host "  [OK] Dependencies installed in .venv" -ForegroundColor Green
-    }
-} elseif ($py) {
-    Write-Host "  Installing requirements using system $py..." -ForegroundColor Cyan
-    & $py -m pip install -r $reqFile --quiet
-} else {
-    Write-Host "  [SKIP] Skipping pip install: Python runtime not yet active." -ForegroundColor Yellow
-}
-
-# 4. Check Node.js / Playwright
-Write-Host "`n[4/5] Checking Node.js & Playwright CLI..." -ForegroundColor Yellow
-try {
-    $nodeVer = & node --version 2>&1
-    Write-Host "  [OK] Found Node.js: $nodeVer" -ForegroundColor Green
-} catch {
-    Write-Host "  [INFO] Node.js not detected. Optional for standalone Python tools, required for Playwright MCP." -ForegroundColor Gray
-}
-
-# 5. Run Quality Gate Linting
-Write-Host "`n[5/6] Running Quality Gate & Skill Integrity Verification..." -ForegroundColor Yellow
-$linter = Join-Path $repoRoot "scripts\lint_skills.ps1"
-if (Test-Path $linter) {
-    & powershell -ExecutionPolicy Bypass -File $linter
-}
-
-# 6. Initialize SQLite Central Agent Memory
-Write-Host "`n[6/6] Initializing Global Central Agent Memory (~/.agent_memory/global_cache.db)..." -ForegroundColor Yellow
-$cacheTool = Join-Path $repoRoot "tools\cache_resolver.py"
-if (Test-Path $cacheTool) {
-    try {
-        if (Test-Path $venvPython) {
-            & $venvPython $cacheTool init
-        } elseif ($py) {
-            & $py $cacheTool init
-        }
-        Write-Host "  [OK] Central Agent Memory initialized and seeded." -ForegroundColor Green
-    } catch {
-        Write-Host "  [WARN] Could not initialize ~/.agent_memory/global_cache.db: $_" -ForegroundColor Yellow
-    }
-}
-
-Write-Host "`n==========================================================" -ForegroundColor Cyan
-Write-Host "  Bootstrap Complete! Hub is ready for Multi-Agent Swarm. " -ForegroundColor Green
-Write-Host "==========================================================" -ForegroundColor Cyan
+<#
+.SYNOPSIS
+    One-click setup and dependency bootstrap script for Enterprise Agent-Skills Hub.
+.DESCRIPTION
+    Detects and installs Python, Node.js, Playwright, sets up a clean virtual environment,
+    installs requirements.txt, and verifies the full 38-skill catalog.
+#>
+
+[CmdletBinding()]
+param(
+    [switch]$ForceInstall = $false
+)
+
+Write-Host "==========================================================" -ForegroundColor Cyan
+Write-Host "  Enterprise Agent-Skills Hub: Automated Bootstrap Setup  " -ForegroundColor Cyan
+Write-Host "==========================================================" -ForegroundColor Cyan
+
+$repoRoot = Split-Path -Parent $PSScriptRoot
+Set-Location $repoRoot
+
+# 1. Verify / Install Python
+Write-Host "`n[1/5] Checking Python 3 Runtime..." -ForegroundColor Yellow
+$py = $null
+foreach ($cmd in @("python", "python3", "py")) {
+    try {
+        $v = & $cmd --version 2>&1
+        if ($LASTEXITCODE -eq 0 -and $v -match "Python\s+3\.(1[0-9]|[2-9][0-9])") {
+            $py = $cmd
+            Write-Host "  [OK] Found Python: $v" -ForegroundColor Green
+            break
+        }
+    } catch { }
+}
+
+if (-not $py) {
+    Write-Host "  [WARN] Python 3.10+ not found in PATH." -ForegroundColor Yellow
+    Write-Host "  Attempting automated installation via winget..." -ForegroundColor Cyan
+    try {
+        winget install -e --id Python.Python.3.11 --accept-source-agreements --accept-package-agreements --scope currentUser
+        Write-Host "  [OK] Python 3.11 installed. Please restart your shell if PATH is not updated." -ForegroundColor Green
+    } catch {
+        Write-Host "  [FAIL] Could not auto-install Python. Please install from https://python.org" -ForegroundColor Red
+    }
+}
+
+# 2. Virtual Environment Setup
+Write-Host "`n[2/5] Setting up Virtual Environment (.venv)..." -ForegroundColor Yellow
+$venvDir = Join-Path $repoRoot ".venv"
+if (-not (Test-Path $venvDir) -and $py) {
+    Write-Host "  Creating virtual environment at $venvDir..." -ForegroundColor Cyan
+    & $py -m venv $venvDir
+}
+
+$venvPython = if ($IsWindows -or $env:OS -match "Windows") {
+    Join-Path $venvDir "Scripts\python.exe"
+} else {
+    Join-Path $venvDir "bin/python"
+}
+
+# 3. Pip Dependencies
+Write-Host "`n[3/5] Installing Core Python Dependencies..." -ForegroundColor Yellow
+$reqFile = Join-Path $repoRoot "requirements.txt"
+if (Test-Path $venvPython) {
+    Write-Host "  Upgrading pip & wheel..." -ForegroundColor Cyan
+    & $venvPython -m pip install --upgrade pip setuptools wheel --quiet
+    if (Test-Path $reqFile) {
+        Write-Host "  Installing requirements from requirements.txt..." -ForegroundColor Cyan
+        & $venvPython -m pip install -r $reqFile --quiet
+        Write-Host "  [OK] Dependencies installed in .venv" -ForegroundColor Green
+    }
+} elseif ($py) {
+    Write-Host "  Installing requirements using system $py..." -ForegroundColor Cyan
+    & $py -m pip install -r $reqFile --quiet
+} else {
+    Write-Host "  [SKIP] Skipping pip install: Python runtime not yet active." -ForegroundColor Yellow
+}
+
+# 4. Check Node.js / Playwright
+Write-Host "`n[4/5] Checking Node.js & Playwright CLI..." -ForegroundColor Yellow
+try {
+    $nodeVer = & node --version 2>&1
+    Write-Host "  [OK] Found Node.js: $nodeVer" -ForegroundColor Green
+} catch {
+    Write-Host "  [INFO] Node.js not detected. Optional for standalone Python tools, required for Playwright MCP." -ForegroundColor Gray
+}
+
+# 5. Run Quality Gate Linting
+Write-Host "`n[5/6] Running Quality Gate & Skill Integrity Verification..." -ForegroundColor Yellow
+$linter = Join-Path $repoRoot "scripts\lint_skills.ps1"
+if (Test-Path $linter) {
+    & powershell -ExecutionPolicy Bypass -File $linter
+}
+
+# 6. Initialize SQLite Central Agent Memory
+Write-Host "`n[6/6] Initializing Global Central Agent Memory (~/.agent_memory/global_cache.db)..." -ForegroundColor Yellow
+$cacheTool = Join-Path $repoRoot "tools\cache_resolver.py"
+if (Test-Path $cacheTool) {
+    try {
+        if (Test-Path $venvPython) {
+            & $venvPython $cacheTool init
+        } elseif ($py) {
+            & $py $cacheTool init
+        }
+        Write-Host "  [OK] Central Agent Memory initialized and seeded." -ForegroundColor Green
+    } catch {
+        Write-Host "  [WARN] Could not initialize ~/.agent_memory/global_cache.db: $_" -ForegroundColor Yellow
+    }
+}
+
+Write-Host "`n==========================================================" -ForegroundColor Cyan
+Write-Host "  Bootstrap Complete! Hub is ready for Multi-Agent Swarm. " -ForegroundColor Green
+Write-Host "==========================================================" -ForegroundColor Cyan

package/scripts/lint_skills.ps1

@@ -1,57 +1,57 @@
-<#
-.SYNOPSIS
-    Automated validation test for all skills in Agent-Skills Hub.
-.DESCRIPTION
-    Checks presence of SKILL.md, valid frontmatter (name, description), and verifies skills_manifest.json.
-#>
-
-Write-Host "==========================================================" -ForegroundColor Cyan
-Write-Host "         Agent-Skills Quality & Integrity Linter          " -ForegroundColor Cyan
-Write-Host "==========================================================" -ForegroundColor Cyan
-
-$skillsDir = Join-Path $PSScriptRoot "..\.agents\skills"
-$manifestPath = Join-Path $PSScriptRoot "..\skills_manifest.json"
-
-$passed = 0
-$failed = 0
-
-if (-not (Test-Path $manifestPath)) {
-    Write-Host "[FAIL] Missing skills_manifest.json!" -ForegroundColor Red
-    exit 1
-}
-
-$manifest = Get-Content $manifestPath -Raw | ConvertFrom-Json
-Write-Host "[INFO] Manifest loaded: $($manifest.totalSkills) declared skills." -ForegroundColor Gray
-
-$skillDirs = Get-ChildItem -Path $skillsDir -Directory
-
-foreach ($dir in $skillDirs) {
-    $skillMd = Join-Path $dir.FullName "SKILL.md"
-    if (-not (Test-Path $skillMd)) {
-        Write-Host "[FAIL] $($dir.Name): Missing SKILL.md" -ForegroundColor Red
-        $failed++
-        continue
-    }
-
-    $content = Get-Content $skillMd -Raw
-    $hasName = $content -match "name:\s*[\w\-\s]+"
-    $hasDesc = $content -match "description:\s*.+"
-
-    if ($hasName -and $hasDesc) {
-        Write-Host "[PASS] $($dir.Name) - Valid Frontmatter" -ForegroundColor Green
-        $passed++
-    } else {
-        Write-Host "[FAIL] $($dir.Name) - Invalid or missing YAML frontmatter" -ForegroundColor Red
-        $failed++
-    }
-}
-
-Write-Host "----------------------------------------------------------" -ForegroundColor Cyan
-Write-Host "Verification Results: $passed Passed, $failed Failed." -ForegroundColor $(if ($failed -eq 0) { "Green" } else { "Red" })
-Write-Host "----------------------------------------------------------" -ForegroundColor Cyan
-
-if ($failed -gt 0) {
-    exit 1
-} else {
-    exit 0
-}
+<#
+.SYNOPSIS
+    Automated validation test for all skills in Agent-Skills Hub.
+.DESCRIPTION
+    Checks presence of SKILL.md, valid frontmatter (name, description), and verifies skills_manifest.json.
+#>
+
+Write-Host "==========================================================" -ForegroundColor Cyan
+Write-Host "         Agent-Skills Quality & Integrity Linter          " -ForegroundColor Cyan
+Write-Host "==========================================================" -ForegroundColor Cyan
+
+$skillsDir = Join-Path $PSScriptRoot "..\.agents\skills"
+$manifestPath = Join-Path $PSScriptRoot "..\skills_manifest.json"
+
+$passed = 0
+$failed = 0
+
+if (-not (Test-Path $manifestPath)) {
+    Write-Host "[FAIL] Missing skills_manifest.json!" -ForegroundColor Red
+    exit 1
+}
+
+$manifest = Get-Content $manifestPath -Raw | ConvertFrom-Json
+Write-Host "[INFO] Manifest loaded: $($manifest.totalSkills) declared skills." -ForegroundColor Gray
+
+$skillDirs = Get-ChildItem -Path $skillsDir -Directory
+
+foreach ($dir in $skillDirs) {
+    $skillMd = Join-Path $dir.FullName "SKILL.md"
+    if (-not (Test-Path $skillMd)) {
+        Write-Host "[FAIL] $($dir.Name): Missing SKILL.md" -ForegroundColor Red
+        $failed++
+        continue
+    }
+
+    $content = Get-Content $skillMd -Raw
+    $hasName = $content -match "name:\s*[\w\-\s]+"
+    $hasDesc = $content -match "description:\s*.+"
+
+    if ($hasName -and $hasDesc) {
+        Write-Host "[PASS] $($dir.Name) - Valid Frontmatter" -ForegroundColor Green
+        $passed++
+    } else {
+        Write-Host "[FAIL] $($dir.Name) - Invalid or missing YAML frontmatter" -ForegroundColor Red
+        $failed++
+    }
+}
+
+Write-Host "----------------------------------------------------------" -ForegroundColor Cyan
+Write-Host "Verification Results: $passed Passed, $failed Failed." -ForegroundColor $(if ($failed -eq 0) { "Green" } else { "Red" })
+Write-Host "----------------------------------------------------------" -ForegroundColor Cyan
+
+if ($failed -gt 0) {
+    exit 1
+} else {
+    exit 0
+}

package/skills_manifest.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "Enterprise Agent Skills Hub",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "description": "Unified Catalog of 38 Specialized Skills for Autonomous AI Agents in Enterprise Software Quality Engineering, Performance, and Architecture.",
   "totalSkills": 38,
   "categories": {

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.4.1",
+  "version": "2.4.3",
   "quality_gates": {
     "mutation_min_score": 80,
     "gates": {

package/tools/__init__.py

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