synapse-hub 2.6.0 → 2.7.0

package/package.json

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

package/skills_manifest.json

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

package/synapse.config.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://raw.githubusercontent.com/TeeVee998/Synapse-Hub/main/docs/schemas/synapse.config.schema.json",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "quality_gates": {
     "mutation_min_score": 80,
     "gates": {

package/templates/ai_bridges/CLAUDE.md

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

package/tools/TOOLS_RUNBOOK.md

@@ -15,7 +15,7 @@
 | **Flaky Test Detection & Quarantine Governance ("flaky")** | `tools/flaky_detector.py` | `agent-qa flaky --detect` (or `npx synapse-hub flaky`) |
 | **Executive Project Health & Quality Dashboard ("dashboard")** | `tools/dashboard_generator.py` | `agent-qa dashboard` (or `npx synapse-hub dashboard`) |
 | **Clean Uninstall of AI Bridges & Global Plugins ("uninstall")** | `tools/cli.py` | `agent-qa uninstall` (or `npx synapse-hub uninstall`) |
-| **Comprehensive Health & AST Analysis ("analyze project")** | `tools/analyze_project.py` | `python tools/analyze_project.py [target]` (or `agent-qa analyze`).<br/>*Post-Audit:* Stages, commits, and pushes `PROJECT_HEALTH_REPORT.md` & `repo_map.txt` to project Git. |
+| **Comprehensive Health & AST Analysis ("analyze project")** | `tools/analyze_project.py` | `python tools/analyze_project.py [target]` (or `agent-qa analyze`).<br/>*Post-Audit:* Stages and commits `PROJECT_HEALTH_REPORT.md` & `repo_map.txt` locally; confirms with user before pushing to remote. |
 | **Action Safety Firewall (Environment Protection)** | `tools/safety_firewall.py` | `python tools/safety_firewall.py --text "Delete" --action click` (or `agent-qa safety-check`) |
 | **API Contract Drift (Breaking Change Detection)** | `tools/api_drift_sentinel.py` | `python tools/api_drift_sentinel.py --old base.json --new curr.json` (or `agent-qa contract-drift`) |
 | **Autonomous API Fuzzing & Chaos Breaker** | `tools/api_fuzzer.py` | `agent-qa fuzz-api --base-url <url> --spec <swagger.json>` (Catches 500, DB leaks, SLA breach) |

package/tools/__init__.py

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

package/tools/_openapi_parser.py

@@ -0,0 +1,158 @@
+#!/usr/bin/env python3
+# SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
+# SPDX-License-Identifier: MIT
+# Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
+
+"""
+tools/_openapi_parser.py — Shared OpenAPI & Swagger Specification Parser
+-------------------------------------------------------------------------
+Internal shared helper module consolidating OpenAPI 3.0 and Swagger 2.0
+schema ingestion, $ref dereferencing, endpoint extraction, and boundary
+value test scenario synthesis across API testing tools.
+"""
+
+import os
+import sys
+import json
+from typing import Dict, Any, List, Optional, Tuple
+
+if hasattr(sys.stdout, 'reconfigure'):
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+        sys.stderr.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+
+def load_spec(spec_input: Any) -> Dict[str, Any]:
+    """
+    Loads OpenAPI / Swagger spec from a file path, raw JSON string, or dict.
+    """
+    if isinstance(spec_input, dict):
+        return spec_input
+    if isinstance(spec_input, str):
+        if os.path.exists(spec_input):
+            with open(spec_input, "r", encoding="utf-8") as f:
+                return json.load(f)
+        try:
+            return json.loads(spec_input)
+        except Exception:
+            raise ValueError(f"Unable to parse spec input as JSON file or string: {spec_input[:100]}")
+    raise TypeError(f"Expected dict, str path, or JSON string; got {type(spec_input)}")
+
+
+def resolve_ref(spec_data: Dict[str, Any], ref_str: str) -> Dict[str, Any]:
+    """
+    Resolves local JSON pointers such as '#/components/schemas/User' or '#/definitions/User'.
+    """
+    if not ref_str.startswith("#/"):
+        return {}
+    parts = ref_str[2:].split("/")
+    curr = spec_data
+    for p in parts:
+        if isinstance(curr, dict) and p in curr:
+            curr = curr[p]
+        else:
+            return {}
+    return curr if isinstance(curr, dict) else {}
+
+
+def extract_endpoints(spec_data: Dict[str, Any]) -> List[Dict[str, Any]]:
+    """
+    Parses paths and HTTP operations into a normalized list of API endpoints.
+    """
+    endpoints = []
+    paths = spec_data.get("paths", {})
+
+    for path, methods in paths.items():
+        if not isinstance(methods, dict):
+            continue
+        for method, details in methods.items():
+            if method.lower() not in ("get", "post", "put", "delete", "patch", "options", "head"):
+                continue
+            if not isinstance(details, dict):
+                continue
+
+            summary = details.get("summary", details.get("operationId", f"{method.upper()} {path}"))
+            operation_id = details.get("operationId", f"{method.lower()}_{path.replace('/', '_').strip('_')}")
+            tags = details.get("tags", ["General"])
+
+            # Parameters (Path, Query, Header)
+            parameters = details.get("parameters", [])
+
+            # Request Body Schema (OpenAPI 3.0 application/json)
+            req_content = details.get("requestBody", {}).get("content", {})
+            schema = req_content.get("application/json", {}).get("schema", {})
+            if "$ref" in schema:
+                schema = resolve_ref(spec_data, schema["$ref"])
+
+            # Swagger 2.0 body parameter fallback
+            if not schema:
+                for param in parameters:
+                    if param.get("in") == "body" and "schema" in param:
+                        s = param["schema"]
+                        schema = resolve_ref(spec_data, s["$ref"]) if "$ref" in s else s
+                        break
+
+            # Response schemas
+            responses = details.get("responses", {})
+
+            endpoints.append({
+                "path": path,
+                "method": method.upper(),
+                "summary": summary,
+                "operation_id": operation_id,
+                "tags": tags,
+                "parameters": parameters,
+                "request_schema": schema,
+                "responses": responses
+            })
+
+    return endpoints
+
+
+def generate_boundary_scenarios(field_name: str, field_schema: Dict[str, Any]) -> List[Dict[str, Any]]:
+    """
+    Generates standard positive and boundary value test scenarios for a given field schema.
+    """
+    boundaries = []
+    f_type = field_schema.get("type", "string")
+
+    if f_type == "string":
+        min_l = field_schema.get("minLength", 1)
+        max_l = field_schema.get("maxLength", 50)
+        boundaries.append({"scenario": f"{field_name} Empty String", "value": "", "expected": 400})
+        boundaries.append({
+            "scenario": f"{field_name} Below MinLength ({min_l - 1} chars)",
+            "value": "A" * max(0, min_l - 1),
+            "expected": 400 if min_l > 0 else 200
+        })
+        boundaries.append({
+            "scenario": f"{field_name} Exact MaxLength ({max_l} chars)",
+            "value": "A" * max_l,
+            "expected": 200
+        })
+        boundaries.append({
+            "scenario": f"{field_name} Exceed MaxLength ({max_l + 1} chars)",
+            "value": "A" * (max_l + 1),
+            "expected": 400
+        })
+        boundaries.append({
+            "scenario": f"{field_name} Special & XSS Payload",
+            "value": "<script>alert(1)</script>",
+            "expected": 400
+        })
+
+    elif f_type in ("integer", "number"):
+        minimum = field_schema.get("minimum", 0)
+        maximum = field_schema.get("maximum", 1000)
+        boundaries.append({"scenario": f"{field_name} Negative Value ({minimum - 1})", "value": minimum - 1, "expected": 400})
+        boundaries.append({"scenario": f"{field_name} Boundary Minimum ({minimum})", "value": minimum, "expected": 200})
+        boundaries.append({"scenario": f"{field_name} Boundary Maximum ({maximum})", "value": maximum, "expected": 200})
+        boundaries.append({"scenario": f"{field_name} Exceed Maximum ({maximum + 1})", "value": maximum + 1, "expected": 400})
+        boundaries.append({"scenario": f"{field_name} 32-bit Integer Overflow", "value": 2147483648, "expected": 400})
+
+    elif f_type == "boolean":
+        boundaries.append({"scenario": f"{field_name} Invalid String Instead of Boolean", "value": "not_a_bool", "expected": 400})
+
+    return boundaries