synapse-hub 2.4.0 → 2.4.2

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 30-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/install_global_plugin.ps1

@@ -1,7 +1,7 @@
 # Enterprise Synapse-Hub Global Antigravity Plugin Installer (Windows)
 # ======================================================================
 # Mounts Synapse-Hub directly into Google Antigravity's Global Plugin Directory.
-# Once installed, all 27 skills and 6 subagents are active across all projects automatically.
+# Once installed, all 38 skills and 6 subagents are active across all projects automatically.
 
 [CmdletBinding()]
 param()

package/scripts/install_global_plugin.sh

@@ -2,7 +2,7 @@
 # Enterprise Synapse-Hub Global Antigravity Plugin Installer (macOS / Linux)
 # ======================================================================
 # Mounts Synapse-Hub directly into Google Antigravity's Global Plugin Directory.
-# Once installed, all 27 skills and 6 subagents are active across all projects automatically.
+# Once installed, all 38 skills and 6 subagents are active across all projects automatically.
 
 set -e
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

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

package/tools/TOOLS_RUNBOOK.md

@@ -60,7 +60,12 @@
 | **Smart Visual Masking (Anti-Flake)** | `tools/smart_visual_masker.py` | `agent-qa visual-mask --playwright-snippet` |
 | **CI/CD Silent Self-Healing Hook & Auto-PR** | `tools/ci_healing_hook.py` | `agent-qa ci-hook --file <f> --old-loc <old> --new-loc <new>` |
 | **Checking DB data leaks (Taint Analysis)** | `tools/trace_data_flow.py` | `python tools/trace_data_flow.py` |
-| **Detecting Canvas / GIS Map visual regression** | `tools/visual_diff_canvas.py` | `python tools/visual_diff_canvas.py --baseline <b> --actual <a>` |
+| **Detecting Canvas / GIS Map visual regression** | `tools/visual_diff_canvas.py` | `python tools/visual_diff_canvas.py compare <b> <a> --diff <d>` (or `agent-qa canvas-diff`) |
+| **Universal Release Version Synchronization Audit** | `tools/check_version_sync.py` | `python tools/check_version_sync.py` (or `agent-qa check-version`) |
+| **Groovy Scripts & Keywords Syntax Pre-check** | `tools/validate_groovy_scripts.py` | `python tools/validate_groovy_scripts.py` (or `agent-qa validate-groovy`) |
+| **Model Context Protocol (MCP) Excel Server** | `tools/mcp_excel_server.py` | `python tools/mcp_excel_server.py` (or `agent-qa mcp-excel`) |
+| **3-Layer Heuristic Locator Matcher (0-Token Recovery)** | `tools/heuristic_locator_matcher.py` | `python tools/heuristic_locator_matcher.py` (Internal autonomous fallback engine) |
+| **Output Formatter & Exit Code Spec (NO_COLOR standard)** | `tools/output_formatter.py` | `from output_formatter import is_color_enabled, EXIT_SUCCESS` |
 | **Canary Self-Healing Audit** | `tools/agent_canary.py` | `python tools/agent_canary.py --run` |
 | **Lookup XPath Locator in cached memory** | `tools/lookup_xpath.py` | `python tools/lookup_xpath.py "<keyword>"` |
 | **Lookup Test Case metadata** | `tools/lookup_tc.py` | `python tools/lookup_tc.py "<keyword_or_id>"` |

package/tools/__init__.py

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