synapse-hub 2.7.0 → 3.0.1

package/tools/visual_som_helper.py

@@ -1,5 +1,4 @@
 #!/usr/bin/env python3
-from __future__ import annotations
 """
 Enterprise Vision-Grounded Fallback & Set-of-Marks (SoM) Engine
 --------------------------------------------------------------
@@ -20,27 +19,25 @@ Features:
   4. Compact Vision Prompt Formatter:
      - Formats token-efficient briefs for Multimodal Vision Models (Gemini / Claude / GPT-4o).
 """
+from __future__ import annotations
 
 import os
 import sys
 import json
 import sqlite3
 import argparse
-from typing import Dict, Any, List, Optional, Tuple, Union
+from typing import Dict, Any, List, Optional, Tuple
 try:
     from PIL import Image, ImageDraw, ImageFont, ImageFilter
     HAS_PIL = True
 except ImportError:
-    Image = None
-    ImageDraw = None
-    ImageFont = None
-    ImageFilter = None
+    Image = None  # type: ignore[assignment]
+    ImageDraw = None  # type: ignore[assignment]
+    ImageFont = None  # type: ignore[assignment]
+    ImageFilter = None  # type: ignore[assignment]
     HAS_PIL = False
 
-if HAS_PIL and Image is not None:
-    ImageSourceType = Union[Image.Image, str]
-else:
-    ImageSourceType = Any
+ImageSourceType = Any
 
 # Enforce UTF-8 stdout encoding for Windows console compatibility
 if hasattr(sys.stdout, 'reconfigure'):
@@ -74,12 +71,12 @@ def compute_visual_hash(image_source: ImageSourceType, bbox: Optional[List[int]]
     if isinstance(image_source, str):
         if not os.path.exists(image_source):
             raise FileNotFoundError(f"Image not found: {image_source}")
-        img = Image.open(image_source)
+        img: Any = Image.open(image_source)
     else:
         img = image_source
 
     if bbox and len(bbox) == 4:
-        img = img.crop(bbox)
+        img = img.crop(tuple(bbox))
 
     # Resize to (hash_size + 1, hash_size) in grayscale
     resized = img.convert("L").resize((hash_size + 1, hash_size), Image.Resampling.LANCZOS)
@@ -266,6 +263,8 @@ class VisualSoMHelper:
         edges = img.filter(ImageFilter.FIND_EDGES)
         edges = edges.point(lambda p: 255 if p > edge_threshold else 0)
         pixels = edges.load()
+        if pixels is None:
+            return []
 
         # Identify active cells with high edge density
         active_cells = set()
@@ -274,7 +273,10 @@ class VisualSoMHelper:
                 count = 0
                 for cy in range(y, min(h, y + stride)):
                     for cx in range(x, min(w, x + stride)):
-                        if pixels[cx, cy] > 0:
+                        px_val = pixels[cx, cy]
+                        if isinstance(px_val, (int, float)) and px_val > 0:
+                            count += 1
+                        elif isinstance(px_val, tuple) and px_val and px_val[0] > 0:
                             count += 1
                 if count >= min_pixels_per_cell:
                     active_cells.add((x // stride, y // stride))

package/tools/watch_mode.py

@@ -156,7 +156,7 @@ def run_incremental_audit(file_path: str, target_dir: str) -> Dict[str, Any]:
     """Performs fast sub-100ms audit on a single changed file."""
     start_t = time.perf_counter()
     rel_path = os.path.relpath(file_path, target_dir)
-    results = {
+    results: Dict[str, Any] = {
         "file": rel_path,
         "bom_pass": True,
         "path_pass": True,

package/tools/wcag_audit.py

@@ -126,6 +126,18 @@ class WCAGAuditor(HTMLParser):
 
 
 def run_audit(target, is_url=False):
+    """Executes a WCAG 2.2 accessibility audit against an HTML file or live web URL.
+
+    Args:
+        target: Filepath or URL pointing to HTML content.
+        is_url: True if target should be fetched over HTTP/HTTPS.
+
+    Returns:
+        The populated WCAGAuditor instance containing violations and stats.
+
+    Raises:
+        ValueError: If an insecure or invalid URL scheme is passed.
+    """
     auditor = WCAGAuditor()
     if is_url:
         parsed = urllib.parse.urlparse(target)
@@ -143,6 +155,15 @@ def run_audit(target, is_url=False):
 
 
 def format_markdown_report(target, auditor):
+    """Generates an executive WCAG 2.2 audit markdown report.
+
+    Args:
+        target: Target URL or file audited.
+        auditor: Populated WCAGAuditor instance.
+
+    Returns:
+        Markdown string containing compliance score, grade, and violation details.
+    """
     violations = auditor.violations
     stats = {
         "elements_scanned": auditor.elements_scanned,
@@ -158,7 +179,7 @@ def format_markdown_report(target, auditor):
     grade = "PASS" if score >= 80 else "NEEDS REMEDIATION"
 
     out = [
-        f"# WCAG 2.2 Accessibility Audit Report",
+        "# WCAG 2.2 Accessibility Audit Report",
         f"**Target:** `{target}`",
         f"**Elements Scanned:** {stats['elements_scanned']}",
         f"**Violations Found:** {stats['violations_found']}",

package/tools/welcome_page.py

@@ -28,7 +28,6 @@ import html as html_lib
 import argparse
 import webbrowser
 from datetime import datetime
-from pathlib import Path
 from typing import Dict, Any, Optional
 
 # Enforce UTF-8 stdout encoding for Windows console compatibility
@@ -48,7 +47,7 @@ def get_hub_metadata() -> Dict[str, Any]:
     """Retrieves version and catalog count from skills_manifest.json."""
     manifest_path = os.path.join(HUB_ROOT, "skills_manifest.json")
     meta = {
-        "version": "2.7.0",
+        "version": "3.0.1",
         "totalSkills": 42,
         "author": "Thế Vị (@TeeVee998)",
         "repo": "https://github.com/TeeVee998/Synapse-Hub"
@@ -80,10 +79,10 @@ def generate_welcome_html(target_repo: Optional[str] = None, stack_info: Optiona
     """Renders the standalone interactive HTML5 landing page with bilingual language switcher."""
     meta = get_hub_metadata()
     now_str = datetime.now().strftime("%Y-%m-%d %H:%M")
-    
+
     is_external_target = bool(target_repo and not is_hub_repo(target_repo) and stack_info)
     if is_external_target:
-        raw_target_name = (stack_info.get("name") if stack_info else "") or os.path.basename(os.path.abspath(target_repo))
+        raw_target_name = (stack_info.get("name") if stack_info else "") or os.path.basename(os.path.abspath(target_repo or ""))
         raw_framework = (stack_info.get("framework") if stack_info else "") or "Automated QA"
         target_name = html_lib.escape(str(raw_target_name))
         framework_name = html_lib.escape(str(raw_framework))
@@ -248,7 +247,7 @@ def generate_welcome_page(target_repo: Optional[str] = None, output_path: Option
     if open_browser:
         opened = open_welcome_page(out_file)
         if opened:
-            print(f"  🚀 Đã mở Visual Landing Page trong trình duyệt của bạn.")
+            print("  🚀 Đã mở Visual Landing Page trong trình duyệt của bạn.")
     return out_file
 
 
@@ -284,7 +283,7 @@ def main():
         mark_first_run_completed(target_dir)
 
     print(f"✅ Landing page generated successfully at:\n   file://{out_path}")
-    print(f"👉 You can re-open it anytime with: npx synapse-hub welcome")
+    print("👉 You can re-open it anytime with: npx synapse-hub welcome")
 
 
 if __name__ == "__main__":