synapse-hub 2.4.2 → 2.5.0

package/tools/count_tokens.py

@@ -140,7 +140,7 @@ def get_budget_config() -> Dict[str, int]:
                     "budget_7d": data.get("budget_7d", DEFAULT_7D_BUDGET),
                 }
         except (OSError, json.JSONDecodeError):
-            pass
+            custom_budgets = None
     return {
         "budget_5h": DEFAULT_5H_BUDGET,
         "budget_7d": DEFAULT_7D_BUDGET,
@@ -208,7 +208,7 @@ class AntigravityAdapter:
                     }
                 conn.close()
             except (sqlite3.Error, OSError):
-                pass
+                conn_closed = True
 
         conversations = []
         for entry in os.listdir(brain_dir):
@@ -388,7 +388,7 @@ class AntigravityAdapter:
                             usage_hours["cache"] += cache_tok
                             usage_hours["output"] += out_tok
             except (OSError, UnicodeDecodeError):
-                pass
+                transcript_read = False
 
         budgets = get_budget_config()
         b_5h = budgets["budget_5h"]
@@ -665,7 +665,7 @@ def detect_platform_from_file(file_path: str) -> str:
                 if "claude" in line.lower():
                     return "claude"
     except (OSError, UnicodeDecodeError):
-        pass
+        model_detected = None
     return "antigravity"
 
 
@@ -985,7 +985,7 @@ def export_opentelemetry_genai_spans(parsed: Dict[str, Any], session_id: str = "
       - gen_ai.usage.cache_read_tokens
       - tool.name / tool.system
     """
-    trace_id = hashlib.md5(session_id.encode('utf-8')).hexdigest()
+    trace_id = hashlib.md5(session_id.encode('utf-8'), usedforsecurity=False).hexdigest()
     platform = parsed.get("platform", "antigravity")
     model = parsed.get("detected_model", "gemini-flash")
 
@@ -1000,7 +1000,7 @@ def export_opentelemetry_genai_spans(parsed: Dict[str, Any], session_id: str = "
     spans = []
     turns = parsed.get("turns", [])
     for idx, turn in enumerate(turns, 1):
-        turn_span_id = hashlib.md5(f"{session_id}_turn_{idx}".encode('utf-8')).hexdigest()[:16]
+        turn_span_id = hashlib.md5(f"{session_id}_turn_{idx}".encode('utf-8'), usedforsecurity=False).hexdigest()[:16]
         turn_start_nano = int(time.time() * 1e9) - (len(turns) - idx) * int(1e9)
 
         turn_span = {
@@ -1025,7 +1025,7 @@ def export_opentelemetry_genai_spans(parsed: Dict[str, Any], session_id: str = "
         spans.append(turn_span)
 
         for t_idx, tool_name in enumerate(turn.get("tools_called", []), 1):
-            tool_span_id = hashlib.md5(f"{session_id}_turn_{idx}_tool_{t_idx}".encode('utf-8')).hexdigest()[:16]
+            tool_span_id = hashlib.md5(f"{session_id}_turn_{idx}_tool_{t_idx}".encode('utf-8'), usedforsecurity=False).hexdigest()[:16]
             tool_span = {
                 "traceId": trace_id,
                 "spanId": tool_span_id,

package/tools/dashboard_generator.py

@@ -14,7 +14,7 @@ Supports Dual-Mode:
   1. TARGET PROJECT MODE: Displays target project test suites, POM PageClasses,
      automation tech stack (Playwright/Katalon/Pytest/Cypress), in-project 9 Gates DoD,
      and active AI skill profile.
-  2. HUB ECOSYSTEM MODE: Displays central Synapse-Hub catalog (38 skills),
+  2. HUB ECOSYSTEM MODE: Displays central Synapse-Hub catalog (42 skills),
      self-healing benchmark (25 challenges), and platform governance.
 
 Features:
@@ -183,8 +183,8 @@ def load_manifest(hub_root: str) -> Dict[str, Any]:
             with open(path, "r", encoding="utf-8") as f:
                 return json.load(f)
         except (OSError, json.JSONDecodeError):
-            pass
-    return {"totalSkills": 38, "skills": [], "categories": {}, "profiles": {}}
+            manifest_data = None
+    return {"totalSkills": 42, "skills": [], "categories": {}, "profiles": {}}
 
 
 def load_benchmark_report(hub_root: str) -> Dict[str, Any]:
@@ -209,7 +209,7 @@ def load_benchmark_report(hub_root: str) -> Dict[str, Any]:
                     "available": True
                 }
             except (OSError, UnicodeDecodeError):
-                pass
+                report_found = False
     return {
         "resolution_rate": "100.0%",
         "mttr": "0.0s",
@@ -242,7 +242,7 @@ def load_health_report(target_dir: str) -> Dict[str, Any]:
                     "available": True
                 }
             except (OSError, UnicodeDecodeError):
-                pass
+                report_found = False
     return {
         "dod_status": "100%_PASS",
         "classes_count": 0,
@@ -308,7 +308,7 @@ def load_latest_execution_results(target_dir: str) -> Dict[str, Any]:
                 "report_path": rel_path
             }
         except (ET.ParseError, OSError, ValueError, KeyError):
-            pass
+            parsed_xml = False
 
     # Check summaryTemp.txt if JUnit report not parsed
     summary_files = list(target_path.glob("**/summaryTemp.txt"))
@@ -341,7 +341,7 @@ def load_latest_execution_results(target_dir: str) -> Dict[str, Any]:
                     "report_path": str(sf.relative_to(target_path))
                 }
         except (OSError, ValueError):
-            pass
+            parsed_summary = False
 
     return {
         "available": False,
@@ -401,7 +401,7 @@ def scan_target_project_assets(target_dir: str, stack_info: Dict[str, str]) -> D
                 if classes_list:
                     break
             except (json.JSONDecodeError, OSError, KeyError):
-                pass
+                json_parsed = False
 
     # Priority B: Parse repo_map.txt
     if not classes_list:
@@ -451,7 +451,7 @@ def scan_target_project_assets(target_dir: str, stack_info: Dict[str, str]) -> D
                     if classes_list:
                         break
                 except (OSError, UnicodeDecodeError):
-                    pass
+                    continue
 
     # Priority C: Scan filesystem directly if repo_map files were missing
     if not classes_list:
@@ -488,7 +488,7 @@ def scan_target_project_assets(target_dir: str, stack_info: Dict[str, str]) -> D
                     "methods": m_list or ["(Defined in source)"]
                 })
             except (OSError, UnicodeDecodeError):
-                pass
+                report_found = False
 
     # 2. Discover Test Cases
     test_files = []
@@ -1766,7 +1766,7 @@ def generate_hub_html(
     now_str = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
     total_skills = manifest.get("totalSkills", len(manifest.get("skills", [])))
     if total_skills == 0:
-        total_skills = 38
+        total_skills = 42
     skills = manifest.get("skills", [])
 
     gates = [
@@ -1885,7 +1885,7 @@ def generate_hub_html(
 
     translations_vi = {
         "header_title": "Bảng Điều Hành Chất Lượng Doanh Nghiệp",
-        "header_subtitle": "Synapse-Hub v2.4.2 • Hệ Sinh Thái Kiểm Thử AI Agent Tự Chủ",
+        "header_subtitle": "Synapse-Hub v2.5.0 • Hệ Sinh Thái Kiểm Thử AI Agent Tự Chủ",
         "nav_welcome": "Giới Thiệu",
         "meta_mode": "🏷️ Chế độ: <strong>HỆ SINH THÁI QA HUB</strong>",
         "meta_gen": f"🕒 Khởi tạo: <strong>{now_str}</strong>",
@@ -1963,7 +1963,7 @@ def generate_hub_html(
 
     translations_en = {
         "header_title": "Enterprise QA Executive Dashboard",
-        "header_subtitle": "Synapse-Hub v2.4.2 &bull; Autonomous AI Agent Testing Ecosystem",
+        "header_subtitle": "Synapse-Hub v2.5.0 &bull; Autonomous AI Agent Testing Ecosystem",
         "nav_welcome": "Welcome",
         "meta_mode": "🏷️ Mode: <strong>QA HUB ECOSYSTEM</strong>",
         "meta_gen": f"🕒 Generated: <strong>{now_str}</strong>",
@@ -2429,7 +2429,7 @@ def generate_hub_html(
         </div>
         {timeline_section_html}
 
-        <!-- 38 Specialized Skills Catalog -->
+        <!-- 42 Specialized Skills Catalog -->
         <div class="section-header">
             <h2 data-i18n="sec_skills_title">{t['sec_skills_title']}</h2>
             <span class="section-badge" data-i18n="sec_skills_badge">{t['sec_skills_badge']}</span>

package/tools/db_sandbox.py

@@ -143,8 +143,8 @@ class DBSandbox:
                     with open(meta_file, "r", encoding="utf-8") as f:
                         meta = json.load(f)
                         self.db_path = meta.get("source_db", "")
-                except Exception:
-                    pass
+                except (OSError, json.JSONDecodeError):
+                    meta = {}
             if not self.db_path:
                 self.db_path = os.path.join(self.snapshot_dir, "active_test.db")
 
@@ -212,8 +212,8 @@ class DBSandbox:
             try:
                 cursor.execute(f"ROLLBACK TO SAVEPOINT {savepoint_name};")
                 conn.close()
-            except Exception:
-                pass
+            except sqlite3.Error as rollback_err:
+                sys.stderr.write(f"Notice: Savepoint rollback notice: {rollback_err}\n")
             return {
                 "status": "ERROR",
                 "error": str(e),
@@ -340,7 +340,7 @@ def _probe_http(target: str) -> Tuple[bool, str]:
     such as 401/403 still proves the service is up)."""
     try:
         req = urllib.request.Request(target, method="GET")
-        with urllib.request.urlopen(req, timeout=2.0) as resp:
+        with urllib.request.urlopen(req, timeout=2.0) as resp:  # nosec B310
             return True, f"http {resp.getcode()}"
     except urllib.error.HTTPError as exc:
         if exc.code < 500:

package/tools/debt_harvester.py

@@ -0,0 +1,236 @@
+#!/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/debt_harvester.py — Technical Debt & Shortcut Harvester
+-----------------------------------------------------------
+Scans repositories for deliberate simplification markers ('shortcut:' or 'ponytail:').
+Compiles them into a structured Technical Debt Ledger so pragmatic compromises
+and deferred upgrades are tracked and do not rot into forgotten technical debt.
+
+Usage:
+  python3 tools/debt_harvester.py [target_dir]
+  python3 tools/debt_harvester.py [target_dir] --output DEBT_LEDGER.md
+  python3 tools/debt_harvester.py [target_dir] --json
+  python3 tools/debt_harvester.py [target_dir] --keyword "custom-tag:"
+"""
+
+import os
+import sys
+import re
+import json
+import argparse
+from typing import Dict, List, Any, Optional
+
+# UTF-8 stdout encoding enforcement
+if hasattr(sys.stdout, 'reconfigure'):
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+        sys.stderr.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+# Default directories to ignore during scan
+IGNORED_DIRS = {
+    ".git", "node_modules", "dist", "build", ".next", "out",
+    "venv", ".venv", "env", ".env", "__pycache__", ".idea",
+    ".vscode", "coverage", ".mypy_cache", ".ruff_cache",
+    ".pytest_cache", ".sandbox_snapshots", "graphify-out",
+    "claude-ecosystem-repos"
+}
+
+# Supported comment markers across major languages
+# Supports: # (Python, Bash, YAML), // (JS, TS, Java, Groovy, C, C++),
+# /* ... */, -- (SQL, Lua), <!-- (HTML, XML, Markdown)
+DEBT_REGEX = re.compile(
+    r'(?:#|//|/\*|--|<!--)\s*(?:shortcut|ponytail):\s*(.+?)(?:\*/|-->)?$',
+    re.IGNORECASE
+)
+
+
+class ShortcutEntry:
+    def __init__(self, file_path: str, line_no: int, raw_comment: str):
+        self.file_path = file_path
+        self.line_no = line_no
+        self.raw_comment = raw_comment.strip()
+        self.description = ""
+        self.ceiling = ""
+        self.upgrade_trigger = ""
+        self.has_trigger = False
+        self._parse()
+
+    def _parse(self):
+        text = self.raw_comment
+        # Format patterns:
+        # 1. shortcut: <desc>, ceiling: <limit>, upgrade: <trigger>
+        # 2. shortcut: <desc>, <limit>, <trigger>
+        # 3. shortcut: <limit>, <when to upgrade>
+        
+        parts = [p.strip() for p in text.split(',') if p.strip()]
+        
+        # Check explicit labels
+        ceiling_match = re.search(r'(?:ceiling|limit):\s*([^,]+)', text, re.IGNORECASE)
+        upgrade_match = re.search(r'(?:upgrade|when|trigger):\s*([^,]+)', text, re.IGNORECASE)
+
+        if ceiling_match or upgrade_match:
+            self.ceiling = ceiling_match.group(1).strip() if ceiling_match else ""
+            self.upgrade_trigger = upgrade_match.group(1).strip() if upgrade_match else ""
+            # Description is what's left before ceiling/upgrade
+            desc_part = re.split(r'(?:ceiling|limit|upgrade|when|trigger):', text, flags=re.IGNORECASE)[0]
+            self.description = desc_part.strip().rstrip(',')
+        elif len(parts) >= 2:
+            self.description = parts[0]
+            self.ceiling = parts[1]
+            if len(parts) >= 3:
+                self.upgrade_trigger = parts[2]
+            else:
+                self.upgrade_trigger = parts[1]
+        elif len(parts) == 1:
+            self.description = parts[0]
+            self.ceiling = "Not specified"
+            self.upgrade_trigger = ""
+
+        if self.upgrade_trigger:
+            self.has_trigger = True
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            "file": self.file_path,
+            "line": self.line_no,
+            "description": self.description or self.raw_comment,
+            "ceiling": self.ceiling or "Not specified",
+            "upgrade_trigger": self.upgrade_trigger or "No trigger specified",
+            "has_trigger": self.has_trigger,
+            "raw": self.raw_comment
+        }
+
+
+def scan_directory(target_dir: str, keyword: Optional[str] = None) -> List[ShortcutEntry]:
+    """Scans all non-ignored source files in target_dir for shortcut/debt markers."""
+    target_dir = os.path.abspath(target_dir)
+    results: List[ShortcutEntry] = []
+
+    pattern = DEBT_REGEX
+    if keyword:
+        escaped = re.escape(keyword.rstrip(':'))
+        pattern = re.compile(
+            rf'(?:#|//|/\*|--|<!--)\s*{escaped}:\s*(.+?)(?:\*/|-->)?$',
+            re.IGNORECASE
+        )
+
+    for root, dirs, files in os.walk(target_dir):
+        # Exclude ignored directories in-place
+        dirs[:] = [d for d in dirs if d not in IGNORED_DIRS and not d.startswith('.')]
+
+        for f in sorted(files):
+            # Skip non-text or binary files
+            ext = os.path.splitext(f)[1].lower()
+            if ext in {".png", ".jpg", ".jpeg", ".svg", ".zip", ".tar", ".gz", ".lock", ".ico", ".pdf"}:
+                continue
+
+            file_path = os.path.join(root, f)
+            rel_path = os.path.relpath(file_path, target_dir)
+
+            try:
+                with open(file_path, "r", encoding="utf-8", errors="ignore") as fh:
+                    for line_idx, line in enumerate(fh, start=1):
+                        match = pattern.search(line)
+                        if match:
+                            comment_body = match.group(1).strip()
+                            # Filter false positives like documentation describing the marker itself
+                            if "shortcut: <" in comment_body or "shortcut: (" in comment_body:
+                                continue
+                            results.append(ShortcutEntry(rel_path, line_idx, comment_body))
+            except Exception:
+                continue
+
+    return results
+
+
+def format_markdown(entries: List[ShortcutEntry], target_dir: str) -> str:
+    """Renders shortcut debt entries into a structured Markdown ledger."""
+    total = len(entries)
+    no_trigger = sum(1 for e in entries if not e.has_trigger)
+    
+    lines = [
+        "# Technical Debt & Shortcut Ledger",
+        "",
+        "> **Ledger Policy:** Deliberate shortcuts prevent over-engineering. Track limits and upgrade triggers so they never rot silently into permanent defects.",
+        "",
+        f"- **Repository:** `{os.path.basename(target_dir)}`",
+        f"- **Total Shortcuts:** `{total}`",
+        f"- **Missing Upgrade Triggers:** `{no_trigger}` " + ("⚠️ *(Action Required)*" if no_trigger > 0 else "✅ *(All tracked)*"),
+        "",
+        "---",
+        "",
+    ]
+
+    if not entries:
+        lines.append("🎉 **No shortcut debt found. Clean ledger.**")
+        return "\n".join(lines)
+
+    lines.append("| Location | Description | Ceiling (Limit) | Upgrade Trigger | Status |")
+    lines.append("| :--- | :--- | :--- | :--- | :--- |")
+
+    for e in entries:
+        status = "✅ Tracked" if e.has_trigger else "⚠️ `no-trigger`"
+        loc = f"`{e.file_path}:{e.line_no}`"
+        lines.append(f"| {loc} | {e.description} | {e.ceiling} | {e.upgrade_trigger or 'None'} | {status} |")
+
+    lines.append("")
+    lines.append("### Recommended Action")
+    if no_trigger > 0:
+        lines.append(f"1. Review the `{no_trigger}` shortcut(s) tagged `no-trigger` above and define concrete upgrade conditions.")
+    else:
+        lines.append("1. All tracked shortcuts have defined upgrade boundaries. Review them during sprint refactoring cycles.")
+    lines.append("2. Run `agent-qa debt` in CI to monitor debt accumulation.")
+
+    return "\n".join(lines)
+
+
+def run_debt_harvest(target_dir: str, keyword: Optional[str] = None, output_file: Optional[str] = None, as_json: bool = False) -> int:
+    """Executes the debt scan and prints/writes results."""
+    entries = scan_directory(target_dir, keyword)
+    total = len(entries)
+    no_trigger = sum(1 for e in entries if not e.has_trigger)
+
+    if as_json:
+        payload = {
+            "target": os.path.abspath(target_dir),
+            "total": total,
+            "no_trigger_count": no_trigger,
+            "items": [e.to_dict() for e in entries]
+        }
+        print(json.dumps(payload, indent=2, ensure_ascii=False))
+        return 0
+
+    md_report = format_markdown(entries, target_dir)
+
+    if output_file:
+        out_path = os.path.abspath(output_file)
+        with open(out_path, "w", encoding="utf-8") as f:
+            f.write(md_report)
+        print(f"\n✅ Technical Debt Ledger saved to: {out_path} ({total} entries)")
+    else:
+        print("\n" + md_report)
+
+    return 0
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Harvest shortcut: and deliberate debt comments into a tracked technical debt ledger."
+    )
+    parser.add_argument("target", nargs="?", default=".", help="Directory to scan (default: current directory)")
+    parser.add_argument("--keyword", "-k", default=None, help="Custom marker keyword (default: shortcut or ponytail)")
+    parser.add_argument("--output", "-o", default=None, help="Save report to Markdown file")
+    parser.add_argument("--json", action="store_true", help="Output results in JSON format")
+
+    args = parser.parse_args()
+    sys.exit(run_debt_harvest(args.target, args.keyword, args.output, args.json))
+
+
+if __name__ == "__main__":
+    main()

package/tools/distill_log.py

@@ -149,8 +149,8 @@ def main():
             os.makedirs(os.path.dirname(os.path.abspath(args.save_raw)), exist_ok=True)
             with open(args.save_raw, "w", encoding="utf-8") as fp:
                 fp.write(log_text)
-        except Exception:
-            pass
+        except OSError as err:
+            sys.stderr.write(f"Warning: Could not save raw log: {err}\n")
 
     summary = distill(log_text)
     print(summary)

package/tools/flaky_detector.py

@@ -15,10 +15,10 @@ Features:
 """
 
 import os
-import re
 import sys
 import glob
 import json
+import sqlite3
 import time
 import shlex
 import argparse
@@ -187,8 +187,8 @@ def benchmark_live_command(cmd: str, iterations: int = 5, test_id: Optional[str]
                     error_signature="NON_ZERO_EXIT" if not is_pass else "",
                     context=cmd
                 )
-            except Exception:
-                pass
+            except sqlite3.Error as db_err:
+                sys.stderr.write(f"Notice: Run recording skipped: {db_err}\n")
 
         status_str = f"{GREEN}PASS{RESET}" if is_pass else f"{RED}FAIL (Exit {code}){RESET}"
         print(f"{status_str} ({ms} ms)")
@@ -362,8 +362,8 @@ def main():
                             duration_ms=0.0,
                             context=args.reports
                         )
-                    except Exception:
-                        pass
+                    except sqlite3.Error as db_err:
+                        sys.stderr.write(f"Notice: Run recording skipped: {db_err}\n")
 
             if st["quarantine"]:
                 quarantine_candidates.append(st)

package/tools/generate_tc_from_story.py

@@ -43,8 +43,8 @@ def detect_project_package(repo_root="."):
                 m = re.search(r'import\s+([\w\.]+)\.pages\.', content)
                 if m:
                     return f"{m.group(1)}.pages"
-        except Exception:
-            pass
+        except (OSError, UnicodeDecodeError):
+            content = ""
 
     # 2. Check existing Keywords/ directory
     keywords_dir = os.path.join(repo_root, "Keywords")

package/tools/generate_test_reports.py

@@ -27,8 +27,8 @@ def find_latest_junit_report(search_dirs):
                     try:
                         mtime = os.path.getmtime(p)
                         candidates.append((mtime, p))
-                    except OSError:
-                        pass
+                    except OSError as err:
+                        sys.stderr.write(f"Notice: getmtime skipped: {err}\n")
     if not candidates:
         return None
     candidates.sort(key=lambda x: x[0], reverse=True)
@@ -96,8 +96,8 @@ def generate_reports(target_dir=None, project_name="Enterprise-Automation"):
                 if "Passed" in content:
                     print(f"[+] Found existing summary file: {existing}")
                     return 0
-            except OSError:
-                pass
+            except OSError as err:
+                sys.stderr.write(f"Notice: Read summaryTemp skipped: {err}\n")
 
     latest_xml = find_latest_junit_report([reports_dir, test_reports_dir, root_dir])
     if latest_xml:

package/tools/git_pre_commit_guard.py

@@ -41,8 +41,8 @@ def check_bom(files):
             with open(f, "rb") as fp:
                 if fp.read(3) == b"\xef\xbb\xbf":
                     bom_files.append(f)
-        except Exception:
-            pass
+        except OSError as err:
+            sys.stderr.write(f"Notice: Could not read {f}: {err}\n")
     return bom_files
 
 def check_forbidden_paths(files):
@@ -62,8 +62,8 @@ def check_forbidden_paths(files):
                     for forbidden in FORBIDDEN_PATHS:
                         if forbidden in line:
                             violations.append((f, line_no, forbidden))
-        except Exception:
-            pass
+        except OSError as err:
+            sys.stderr.write(f"Notice: Could not read {f}: {err}\n")
     return violations
 
 def check_scripts_clean_pom(files):
@@ -83,8 +83,8 @@ def check_scripts_clean_pom(files):
                             violations.append((f, line_no, "Raw findTestObject is forbidden in Scripts/"))
                         if "//" in line and ("//table" in line or "//input" in line or "//button" in line):
                             violations.append((f, line_no, "Raw XPath is forbidden in Scripts/"))
-            except Exception:
-                pass
+            except OSError as err:
+                sys.stderr.write(f"Notice: Could not parse {f}: {err}\n")
     return violations
 
 def main():

package/tools/infer_linter.py

@@ -185,7 +185,7 @@ def load_config(repo_root=None, config_path=None):
             with open(config_path, "r", encoding="utf-8") as f:
                 return json.load(f)
         except (OSError, json.JSONDecodeError):
-            pass
+            config_data = {}
 
     root = repo_root or REPO_ROOT
     candidates = [
@@ -198,7 +198,7 @@ def load_config(repo_root=None, config_path=None):
                 with open(c, "r", encoding="utf-8") as f:
                     return json.load(f)
             except (OSError, json.JSONDecodeError):
-                pass
+                continue
     return {}
 
 
@@ -325,8 +325,8 @@ def classify_file_role(file_path: str) -> str:
     if re.search(r'(^|_)basepage\b', base) or re.search(r'[a-z0-9_]page\.(ts|js|py|groovy|java)$', base):
         return "PAGE_OBJECT"
 
-    # 3. Helpers & Fixtures / Tools & Utilities
-    if any(p in ("fixtures", "helpers", "utils", "support", "tools", "bin") for p in parts):
+    # 3. Helpers & Fixtures / Tools & Utilities / Benchmarks
+    if any(p in ("fixtures", "helpers", "utils", "support", "tools", "bin", "benchmarks", "benchmark") for p in parts):
         return "HELPER"
     if any(base.endswith(sfx) for sfx in ("helper.ts", "helper.js", "helper.py", "helper.groovy", "utils.ts", "utils.js", "utils.py", "fixture.ts", "fixture.js")):
         return "HELPER"
@@ -613,7 +613,12 @@ def run_infer_linter(target_dir=None, output_path=None, strict: bool = False,
             for ext in EXTENSIONS:
                 raw_files.extend(glob.glob(os.path.join(scan_dir, "**", ext), recursive=True))
             # Filter out non-test files like tools, __init__.py, node_modules when scanning generic directory
-            ignored_parts = {"tools", "node_modules", ".git", "__pycache__", "venv", ".venv"} | extra_ignored
+            ignored_parts = {
+                "tools", "bin", "node_modules", ".git", "__pycache__", "venv", ".venv",
+                "claude-ecosystem-repos", "dist", "build", ".idea", ".vscode",
+                ".mypy_cache", ".pytest_cache", ".ruff_cache", ".sandbox_snapshots",
+                "graphify-out"
+            } | extra_ignored
             script_files = [
                 f for f in raw_files
                 if not any(part.lower() in ignored_parts for part in os.path.relpath(f, scan_dir).replace("\\", "/").split("/")[:-1])
@@ -768,8 +773,8 @@ def run_infer_linter(target_dir=None, output_path=None, strict: bool = False,
             os.makedirs(os.path.dirname(target_out), exist_ok=True)
             with open(target_out, "w", encoding="utf-8") as f:
                 json.dump(report_data, f, indent=2, ensure_ascii=False)
-        except OSError:
-            pass
+        except OSError as err:
+            sys.stderr.write(f"Notice: Target report write failed: {err}\n")
 
     if strict:
         fake_pass_count = sum(1 for r in results for d in r["defects"] if d["type"] in ("FAKE_PASS_NO_ASSERTION", "NO_ASSERTION_IN_TEST"))

package/tools/lint_ai_docs.py

@@ -55,8 +55,8 @@ def extract_groovy_methods(file_path):
                 mname = m.group(1)
                 if mname not in {"if", "for", "while", "switch", "catch"}:
                     methods.add(mname)
-    except Exception:
-        pass
+    except (OSError, UnicodeDecodeError) as err:
+        sys.stderr.write(f"Notice: Parse methods skipped for {file_path}: {err}\n")
     return methods
 
 def get_actual_entities(repo_root):

package/tools/matrix_sharder.py

@@ -59,8 +59,8 @@ def estimate_test_duration(file_path: str, full_path: str) -> float:
             conn.close()
             if row and row[0]:
                 return float(row[0])
-        except Exception:
-            pass
+        except sqlite3.Error:
+            conn = None
 
     # Heuristic fallback: ~0.5s per line of script
     try:
@@ -68,8 +68,8 @@ def estimate_test_duration(file_path: str, full_path: str) -> float:
             with open(full_path, "r", encoding="utf-8", errors="ignore") as fp:
                 lines = len(fp.readlines())
             return max(5.0, round(lines * 0.25, 1))
-    except Exception:
-        pass
+    except (OSError, UnicodeDecodeError):
+        lines = 0
 
     return 10.0
 

package/tools/mcp_excel_server.py

@@ -23,7 +23,7 @@ if hasattr(sys.stdout, 'reconfigure'):
     except Exception:
         pass
 
-SERVER_VERSION = "2.4.2"
+SERVER_VERSION = "2.5.0"
 
 NS_MAIN = "{http://schemas.openxmlformats.org/spreadsheetml/2006/main}"
 NS_REL = "{http://schemas.openxmlformats.org/officeDocument/2006/relationships}"