synapse-hub 2.7.0 → 3.0.1

package/tools/db_sandbox.py

@@ -34,7 +34,7 @@ import sqlite3
 import argparse
 import urllib.request
 import urllib.error
-from typing import Dict, Any, List, Optional, Tuple
+from typing import Dict, Any, List, Tuple
 
 # Enforce UTF-8 stdout encoding for Windows console compatibility
 if hasattr(sys.stdout, 'reconfigure'):
@@ -86,18 +86,24 @@ class DBSandbox:
 
             if not os.path.exists(self.db_path):
                 conn = sqlite3.connect(self.db_path)
-                cursor = conn.cursor()
-                cursor.execute("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, code TEXT, status TEXT)")
-                cursor.execute("CREATE TABLE IF NOT EXISTS orders (id INTEGER PRIMARY KEY, user_id INTEGER, amount REAL)")
-                conn.commit()
-                conn.close()
+                try:
+                    cursor = conn.cursor()
+                    cursor.execute("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, code TEXT, status TEXT)")
+                    cursor.execute("CREATE TABLE IF NOT EXISTS orders (id INTEGER PRIMARY KEY, user_id INTEGER, amount REAL)")
+                    conn.commit()
+                finally:
+                    conn.close()
 
             # Perform atomic SQLite backup
             src_conn = sqlite3.connect(self.db_path)
-            dst_conn = sqlite3.connect(snapshot_file)
-            src_conn.backup(dst_conn)
-            src_conn.close()
-            dst_conn.close()
+            try:
+                dst_conn = sqlite3.connect(snapshot_file)
+                try:
+                    src_conn.backup(dst_conn)
+                finally:
+                    dst_conn.close()
+            finally:
+                src_conn.close()
 
         else:
             # PostgreSQL / MySQL Docker hook or file copy
@@ -150,10 +156,14 @@ class DBSandbox:
 
         if self.db_type == "sqlite":
             src_conn = sqlite3.connect(snapshot_file)
-            dst_conn = sqlite3.connect(self.db_path)
-            src_conn.backup(dst_conn)
-            src_conn.close()
-            dst_conn.close()
+            try:
+                dst_conn = sqlite3.connect(self.db_path)
+                try:
+                    src_conn.backup(dst_conn)
+                finally:
+                    dst_conn.close()
+            finally:
+                src_conn.close()
         else:
             shutil.copy2(snapshot_file, self.db_path)
 
@@ -181,25 +191,37 @@ class DBSandbox:
         cursor = conn.cursor()
         executed_count = 0
 
+        safe_sp = re.sub(r'[^a-zA-Z0-9_]', '', savepoint_name) or "sp_test_run"
         try:
-            cursor.execute(f"SAVEPOINT {savepoint_name};")
+            cursor.execute(f"SAVEPOINT {safe_sp};")
             for sql in sql_commands:
                 cursor.execute(sql)
                 executed_count += 1
 
-            # Simulate verification read inside the savepoint
-            cursor.execute("SELECT COUNT(*) FROM users")
-            count_inside_tx = cursor.fetchone()[0]
+            # Determine sample table for verification read (prefer 'users', fallback to first user table)
+            cursor.execute("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%';")
+            tables = [row[0] for row in cursor.fetchall()]
+            target_table = "users" if "users" in tables else (tables[0] if tables else None)
+
+            count_inside_tx = 0
+            if target_table:
+                safe_tbl = target_table.replace('"', '""')
+                cursor.execute(f'SELECT COUNT(*) FROM "{safe_tbl}"')
+                count_inside_tx = cursor.fetchone()[0]
+            else:
+                count_inside_tx = executed_count
 
             # Enforce automatic zero-pollution rollback
-            cursor.execute(f"ROLLBACK TO SAVEPOINT {savepoint_name};")
-            cursor.execute(f"RELEASE SAVEPOINT {savepoint_name};")
+            cursor.execute(f"ROLLBACK TO SAVEPOINT {safe_sp};")
+            cursor.execute(f"RELEASE SAVEPOINT {safe_sp};")
 
             # Verify that outside the savepoint, table is pristine
-            cursor.execute("SELECT COUNT(*) FROM users")
-            count_after_rollback = cursor.fetchone()[0]
+            count_after_rollback = 0
+            if target_table:
+                safe_tbl = target_table.replace('"', '""')
+                cursor.execute(f'SELECT COUNT(*) FROM "{safe_tbl}"')
+                count_after_rollback = cursor.fetchone()[0]
 
-            conn.close()
             return {
                 "status": "SUCCESS",
                 "statements_executed": executed_count,
@@ -210,8 +232,7 @@ class DBSandbox:
             }
         except Exception as e:
             try:
-                cursor.execute(f"ROLLBACK TO SAVEPOINT {savepoint_name};")
-                conn.close()
+                cursor.execute(f"ROLLBACK TO SAVEPOINT {safe_sp};")
             except sqlite3.Error as rollback_err:
                 sys.stderr.write(f"Notice: Savepoint rollback notice: {rollback_err}\n")
             return {
@@ -219,6 +240,8 @@ class DBSandbox:
                 "error": str(e),
                 "zero_pollution_verified": True
             }
+        finally:
+            conn.close()
 
     # -------------------------------------------------------------------------
     # 3. TAINT POLLUTION AUDIT & PURGE
@@ -254,43 +277,45 @@ class DBSandbox:
             }
 
         conn = sqlite3.connect(self.db_path)
-        cursor = conn.cursor()
-        cursor.execute("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%';")
-        tables = [r[0] for r in cursor.fetchall()]
-
-        total_purged = 0
-        purge_log = []
-
-        for table in tables:
-            # Validate table identifier to protect against injection
-            if not re.match(r'^[a-zA-Z0-9_]+$', table):
-                continue
-            cursor.execute(f"PRAGMA table_info([{table}]);")
-            columns = [c[1] for c in cursor.fetchall()]
-
-            # Look for code or name columns
-            target_cols = [c for c in columns if c.lower() in ("code", "username", "name", "email", "status") and re.match(r'^[a-zA-Z0-9_]+$', c)]
-            for col in target_cols:
-                for prefix in known_test_prefixes:
-                    escaped_pattern = self._escape_sql_like(prefix) + "%"
-                    cursor.execute(
-                        f"SELECT COUNT(*) FROM [{table}] WHERE [{col}] LIKE ? ESCAPE '\\'",
-                        (escaped_pattern,)
-                    )
-                    c_count = cursor.fetchone()[0]
-                    if c_count > 0:
-                        if not dry_run:
-                            cursor.execute(
-                                f"DELETE FROM [{table}] WHERE [{col}] LIKE ? ESCAPE '\\'",
-                                (escaped_pattern,)
-                            )
-                        total_purged += c_count
-                        action_str = "previewed" if dry_run else "deleted"
-                        purge_log.append(f"Table '{table}' ({col}): {action_str} {c_count} rows matching literal prefix '{prefix}'")
-
-        if not dry_run:
-            conn.commit()
-        conn.close()
+        try:
+            cursor = conn.cursor()
+            cursor.execute("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%';")
+            tables = [r[0] for r in cursor.fetchall()]
+
+            total_purged = 0
+            purge_log = []
+
+            for table in tables:
+                # Validate table identifier to protect against injection
+                if not re.match(r'^[a-zA-Z0-9_]+$', table):
+                    continue
+                cursor.execute(f"PRAGMA table_info([{table}]);")
+                columns = [c[1] for c in cursor.fetchall()]
+
+                # Look for code or name columns
+                target_cols = [c for c in columns if c.lower() in ("code", "username", "name", "email", "status") and re.match(r'^[a-zA-Z0-9_]+$', c)]
+                for col in target_cols:
+                    for prefix in known_test_prefixes:
+                        escaped_pattern = self._escape_sql_like(prefix) + "%"
+                        cursor.execute(
+                            f"SELECT COUNT(*) FROM [{table}] WHERE [{col}] LIKE ? ESCAPE '\\'",
+                            (escaped_pattern,)
+                        )
+                        c_count = cursor.fetchone()[0]
+                        if c_count > 0:
+                            if not dry_run:
+                                cursor.execute(
+                                    f"DELETE FROM [{table}] WHERE [{col}] LIKE ? ESCAPE '\\'",
+                                    (escaped_pattern,)
+                                )
+                            total_purged += c_count
+                            action_str = "previewed" if dry_run else "deleted"
+                            purge_log.append(f"Table '{table}' ({col}): {action_str} {c_count} rows matching literal prefix '{prefix}'")
+
+            if not dry_run:
+                conn.commit()
+        finally:
+            conn.close()
 
         return {
             "status": "CLEAN" if not dry_run else "DRY_RUN",

package/tools/debt_harvester.py

@@ -67,9 +67,9 @@ class ShortcutEntry:
         # 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)
@@ -153,7 +153,7 @@ 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",
         "",

package/tools/distill_log.py

@@ -22,7 +22,7 @@ if hasattr(sys.stdout, 'reconfigure'):
 def distill(log_text, max_lines=40):
     lines = log_text.splitlines()
     total_raw_lines = len(lines)
-    
+
     # Noise filters
     noise_patterns = [
         re.compile(r'^\s*$'),
@@ -54,7 +54,7 @@ def distill(log_text, max_lines=40):
 
     tc_pattern = re.compile(r'(TC-\d+|test_[A-Za-z0-9_]+|[A-Za-z0-9_-]+\.(?:spec|test)\.[jt]sx?)')
     line_num_pattern = re.compile(r'((?:Script\d+|\w+Page|\w+\.(?:groovy|ts|js|py)):(\d+))|File "([^"]+)", line (\d+)')
-    exception_pattern = re.compile(r'([A-Za-z0-9_.]*(?:Exception|Error)):?\s*(.*)')
+    re.compile(r'([A-Za-z0-9_.]*(?:Exception|Error)):?\s*(.*)')
 
     captured_failures = []
     failing_tcs = set()
@@ -110,7 +110,7 @@ def distill(log_text, max_lines=40):
         output.append(f"   Targeted TCs: {', '.join(sorted(failing_tcs))}")
     else:
         output.append(f"❌ FAILURES / ERRORS DETECTED: {len(captured_failures)} failure block(s) isolated.")
-        
+
     if failing_locs:
         unique_locs = sorted(set(failing_locs))
         output.append(f"   Failing Script Location(s): {', '.join(unique_locs[:5])}")

package/tools/dspy_qa_signatures.py

@@ -15,12 +15,11 @@ Reference:
   - Synapse-Hub Subsystem 3: Section 6.4 of agent_skill_training_analysis.md.
 """
 
-import os
 import sys
 import json
 import re
 import argparse
-from typing import Dict, Any, Optional, Tuple, List
+from typing import Dict, Any, Optional, Tuple
 
 # Enforce UTF-8 stdout encoding for Windows console compatibility
 if hasattr(sys.stdout, 'reconfigure'):
@@ -261,7 +260,7 @@ def qa_dod_metric(gold: Any, pred: Any, trace: Optional[Any] = None) -> float:
     Returns 1.0 (PASS) or 0.0 (FAIL).
     """
     test_code = getattr(pred, "test_script_code", "")
-    page_code = getattr(pred, "page_class_code", "")
+    getattr(pred, "page_class_code", "")
 
     if not test_code:
         return 0.0
@@ -305,7 +304,7 @@ def main():
         return 0
 
     if args.rca:
-        print(f"\n🩺 Diagnosing Failure Trace with RCA Signature...")
+        print("\n🩺 Diagnosing Failure Trace with RCA Signature...")
         diagnosis = OfflineSignatureCompiler.diagnose_rca_failure(args.rca)
         print(json.dumps(diagnosis, indent=2))
         return 0

package/tools/export_postman_collection.py

@@ -41,7 +41,7 @@ import uuid
 import csv
 import argparse
 from typing import Dict, Any, List, Optional
-from urllib.parse import urlparse, parse_qs
+from urllib.parse import urlparse
 
 # Enforce UTF-8 stdout encoding for Windows/macOS/Linux console compatibility
 if hasattr(sys.stdout, "reconfigure"):
@@ -151,7 +151,7 @@ def mock_schema_payload(schema: Dict[str, Any], depth: int = 0) -> Any:
             return "{{$guid}}"
         elif fmt in ("date-time", "date"):
             return "{{$isoTimestamp}}"
-        return schema.get("example") or f"AUTO_{{{{$randomAlphaNumeric}}}}"
+        return schema.get("example") or "AUTO_{{$randomAlphaNumeric}}"
 
     elif stype in ("integer", "number"):
         return schema.get("example") or schema.get("minimum", 100)
@@ -191,7 +191,7 @@ def parse_openapi_spec(spec_data: Dict[str, Any], base_url_override: Optional[st
         base_url_default = "https://api.staging.enterprise.local"
 
     # Postman root structure
-    collection = {
+    collection: Dict[str, Any] = {
         "info": {
             "_postman_id": generate_uuid(),
             "name": col_name,
@@ -302,7 +302,7 @@ def parse_openapi_spec(spec_data: Dict[str, Any], base_url_override: Optional[st
                 else:
                     normalized_segments.append(seg)
 
-            url_obj = {
+            url_obj: Dict[str, Any] = {
                 "raw": f"{{{{baseUrl}}}}{raw_path}",
                 "host": ["{{baseUrl}}"],
                 "path": normalized_segments
@@ -325,7 +325,7 @@ def parse_openapi_spec(spec_data: Dict[str, Any], base_url_override: Optional[st
             if not resp_schema and "schema" in resp_info:
                 resp_schema = resp_info["schema"]
 
-            postman_request = {
+            postman_request: Dict[str, Any] = {
                 "name": summary,
                 "event": [
                     {
@@ -380,7 +380,7 @@ def parse_har_file(har_data: Dict[str, Any], base_url_override: Optional[str] =
 
     base_url_default = base_url_override or "https://api.staging.enterprise.local"
 
-    collection = {
+    collection: Dict[str, Any] = {
         "info": {
             "_postman_id": generate_uuid(),
             "name": collection_name,
@@ -428,7 +428,7 @@ def parse_har_file(har_data: Dict[str, Any], base_url_override: Optional[str] =
             }
 
         expected_status = resp.get("status", 200) or 200
-        postman_item = {
+        postman_item: Dict[str, Any] = {
             "name": f"[{method}] {p.path or '/'}",
             "event": [
                 {
@@ -918,7 +918,7 @@ def main():
     with open(target_output, "w", encoding="utf-8") as f:
         json.dump(collection, f, indent=2, ensure_ascii=False)
     print(f"✅ [POSTMAN EXPORT] Successfully created Postman Collection v2.1.0: {target_output}")
-    print(f"🛡️ Embedded: Pre-request Nonce & Auth | SLA Tests (< 1000ms) | AJV JSON Schema Validation | Token Chaining")
+    print("🛡️ Embedded: Pre-request Nonce & Auth | SLA Tests (< 1000ms) | AJV JSON Schema Validation | Token Chaining")
 
     # Optional Companion Environment
     env_file = args.env_output or (os.path.splitext(target_output)[0] + "_env.json")

package/tools/flaky_detector.py

@@ -213,7 +213,7 @@ def benchmark_live_command(cmd: str, iterations: int = 5, test_id: Optional[str]
         print(f"  Recommendation     : {RED}{BOLD}[QUARANTINE REQUIRED]{RESET} Tag with @quarantine immediately!")
     else:
         print(f"  Recommendation     : {GREEN}[SUITE APPROVED]{RESET} Test is deterministic.")
-    print(f"======================================================================\n")
+    print("======================================================================\n")
 
     # Persist Report
     os.makedirs(REPORTS_DIR, exist_ok=True)
@@ -334,7 +334,7 @@ def main():
                     if args.isolate:
                         auto_quarantine_test_file(c["test_id"], target_dir=args.target_dir)
 
-            print(f"======================================================================")
+            print("======================================================================")
             print(f"Quarantine Recommendations: {quarantined_count}/{len(candidates)}")
         sys.exit(0)
 

package/tools/fuzz_payloads.py

@@ -164,9 +164,9 @@ def main():
         if args.json:
             print(json.dumps(scenarios, indent=2, ensure_ascii=False))
         else:
-            print(f"\n======================================================================")
+            print("\n======================================================================")
             print(f"      EDGE-CASE FUZZING SCENARIOS FOR FIELD: '{args.field}' ({args.type.upper()})")
-            print(f"======================================================================")
+            print("======================================================================")
             for idx, sc in enumerate(scenarios, start=1):
                 val_disp = repr(sc['value']) if len(str(sc['value'])) < 60 else repr(str(sc['value'])[:50] + "...")
                 print(f"  [{idx:02d}] {sc['scenario']:<45} | Expected: HTTP {sc['expected']} | Value: {val_disp}")
@@ -177,9 +177,9 @@ def main():
     if args.json:
         print(json.dumps(catalog, indent=2, ensure_ascii=False))
     else:
-        print(f"\n======================================================================")
-        print(f"         ENTERPRISE EDGE-CASE FUZZING & SANITIZATION CATALOG          ")
-        print(f"======================================================================")
+        print("\n======================================================================")
+        print("         ENTERPRISE EDGE-CASE FUZZING & SANITIZATION CATALOG          ")
+        print("======================================================================")
         total_payloads = sum(len(items) for items in catalog.values())
         print(f"Categories: {len(catalog)} | Total Payloads: {total_payloads}\n")
 

package/tools/generate_allure_report.py

@@ -41,7 +41,7 @@ def generate_allure_report(results_dir=None, report_dir=None, clean=True, open_b
 
     print(f"[+] Generating Allure HTML report from '{results_path}' to '{report_path}'...")
     try:
-        ret = subprocess.run(cmd, check=True)
+        subprocess.run(cmd, check=True, timeout=120.0)
         print(f"[+] Report generated successfully at: {report_path}")
     except subprocess.CalledProcessError as e:
         print(f"[ERROR] Allure report generation failed with exit code {e.returncode}")

package/tools/generate_jmx_plan.py

@@ -125,7 +125,7 @@ def build_jmx_xml(
     kafka_config: Optional[Dict[str, Any]] = None
 ) -> str:
     """Builds valid, production-grade Apache JMeter 5.x XML Test Plan."""
-    
+
     loops_str = "-1" if loop_count < 0 else str(loop_count)
     continue_forever = "true" if loop_count < 0 else "false"
 
@@ -960,7 +960,7 @@ def parse_openapi_for_jmeter(spec_data: Dict[str, Any]) -> tuple:
                     for p_name, p_schema in props.items():
                         ptype = p_schema.get("type", "string")
                         if ptype == "string":
-                            sample_payload[p_name] = p_schema.get("example") or f"PERF_AUTO_${{__time(HMS,)}}"
+                            sample_payload[p_name] = p_schema.get("example") or "PERF_AUTO_${__time(HMS,)}"
                         elif ptype in ("integer", "number"):
                             sample_payload[p_name] = p_schema.get("example") or 100
                         elif ptype == "boolean":
@@ -1075,7 +1075,7 @@ def parse_har_for_jmeter(har_data: Dict[str, Any]) -> tuple:
         url = req.get("url", "/")
         p = urlparse(url)
         method = req.get("method", "GET").upper()
-        
+
         post_data = req.get("postData", {})
         body_str = post_data.get("text", "")
         status_code = e.get("response", {}).get("status", 200)
@@ -1107,7 +1107,7 @@ def main():
     parser.add_argument("--output", "-o", help="Target output JMeter test plan file path (.jmx).")
     parser.add_argument("--emit-locust", dest="emit_locust", help="Also/instead emit a runnable Locust locustfile.py (code-as-code load model).")
     parser.add_argument("--sample", action="store_true", help="Generate a sample load test plan using built-in enterprise schema.")
-    
+
     # Advanced JMeter 360° Extensions
     parser.add_argument("--no-cookies", action="store_true", help="Disable automatic HTTP Cookie Manager.")
     parser.add_argument("--no-cache", action="store_true", help="Disable automatic HTTP Cache Manager.")

package/tools/gherkin_suite.py

@@ -649,7 +649,7 @@ def compile_feature(path: str) -> Dict[str, Any]:
     errors = list(parser.errors)
 
     cases = expand_feature(feature, errors)
-    error_count = sum(len(c["errors"]) for c in cases) + len(errors)
+    sum(len(c["errors"]) for c in cases) + len(errors)
     gaps = analyze_gaps(feature, cases)
 
     mapped = {c["id"]: [map_step_to_ir(s).to_dict() for s in c["steps"]] for c in cases}

package/tools/git_pre_commit_guard.py

@@ -94,7 +94,7 @@ def main():
         if not git_dir or not os.path.isdir(git_dir):
             print("❌ Error: Not a git repository.")
             sys.exit(1)
-        
+
         # 1. Pre-commit hook
         pre_commit_path = os.path.join(git_dir, "hooks", "pre-commit")
         pre_commit_content = (
@@ -134,7 +134,7 @@ def main():
             fp.write(pre_push_content)
         os.chmod(pre_push_path, 0o755)
 
-        print(f"✅ Git hooks installed successfully:")
+        print("✅ Git hooks installed successfully:")
         print(f"   - Pre-commit: {pre_commit_path}")
         print(f"   - Post-merge: {post_merge_path} (Auto-runs cache_resolver.py init on git pull)")
         print(f"   - Pre-push:   {pre_push_path} (Auto-runs cache_resolver.py sync on git push)")

package/tools/goldfish_review.py

@@ -108,8 +108,8 @@ def evaluate_spec_content(content: str, filename: str = "") -> dict:
     findings = []
     vector_scores = {}
 
-    lines = [line.strip() for line in content.splitlines() if line.strip()]
-    full_text = content.lower()
+    [line.strip() for line in content.splitlines() if line.strip()]
+    content.lower()
 
     # -------------------------------------------------------------
     # Vector 1: Comprehension & System Boundaries (Weight: 20)

package/tools/heal/__init__.py

@@ -0,0 +1,28 @@
+"""
+Synapse Hub — Self-Healing & Autonomous Repair Engines (tools.heal)
+-------------------------------------------------------------------
+Domain package grouping all locator repair, AOM semantic diffing,
+episodic Reflexion memory, and agentless patching tools.
+"""
+
+from tools import (
+    agentless_patcher,
+    auto_heal,
+    auto_heal_reflexion,
+    cache_resolver,
+    ci_healing_hook,
+    heal_pr_automator,
+    heuristic_locator_matcher,
+    reversible_sandbox,
+)
+
+__all__ = [
+    "agentless_patcher",
+    "auto_heal",
+    "auto_heal_reflexion",
+    "cache_resolver",
+    "ci_healing_hook",
+    "heal_pr_automator",
+    "heuristic_locator_matcher",
+    "reversible_sandbox",
+]

package/tools/heal_pr_automator.py

@@ -114,8 +114,8 @@ def generate_pr_draft(
 
     pr_body = fr"""### 🛡️ Automated Self-Healing Verification PR
 
-> **Origin:** Enterprise Autonomous QA Sentinel  
-> **Confidence Rating:** `{confidence_info['confidence_percentage']}%` ({confidence_info['risk_tier']})  
+> **Origin:** Enterprise Autonomous QA Sentinel
+> **Confidence Rating:** `{confidence_info['confidence_percentage']}%` ({confidence_info['risk_tier']})
 > **Zero Silent Drift Guarantee:** This change was isolated to prevent undocumented modifications on `main`.
 
 ---
@@ -183,9 +183,9 @@ def main():
         if args.json:
             print(json.dumps(res, indent=2))
         else:
-            print(f"\n======================================================================")
+            print("\n======================================================================")
             print(f"      CI/CD SILENT SELF-HEALING HOOK EXECUTED ({conf['risk_tier']})")
-            print(f"======================================================================")
+            print("======================================================================")
             print(f"  Branch Name : {res['branch']}")
             print(f"  PR Title    : {res['pr_title']}")
             print(f"  Confidence  : {conf['confidence_percentage']}%")
@@ -205,9 +205,9 @@ def main():
     if args.json:
         print(json.dumps({"confidence": conf, "pr": pr}, indent=2))
     else:
-        print(f"\n======================================================================")
+        print("\n======================================================================")
         print(f"      SELF-HEALING CONFIDENCE SCORE: {conf['confidence_percentage']}% ({conf['risk_tier']})")
-        print(f"======================================================================")
+        print("======================================================================")
         print(f"  Branch Name : {pr['branch_name']}")
         print(f"  PR Title    : {pr['pr_title']}")
         print(f"  Qualified   : {'✅ YES (Auto-PR Recommended)' if conf['qualified_for_pr'] else '⚠️ NO (Manual QA Review Needed)'}\n")

package/tools/heuristic_locator_matcher.py

@@ -75,7 +75,7 @@ class HeuristicLocatorMatcher:
             ("left", "top", "width", "height"),
         ):
             if all(k in el for k in keys):
-                return tuple(float(el[k]) for k in keys)
+                return (float(el[keys[0]]), float(el[keys[1]]), float(el[keys[2]]), float(el[keys[3]]))
         bbox = el.get("bbox")
         if isinstance(bbox, dict) and all(k in bbox for k in ("x", "y", "width", "height")):
             return (float(bbox["x"]), float(bbox["y"]),
@@ -270,7 +270,7 @@ class HeuristicLocatorMatcher:
                 ]
                 candidates = [el for el in candidates if cls._get_bbox(el) is not None]
                 if candidates:
-                    target = min(candidates, key=lambda el: cls._center_distance(cls._get_bbox(el), anchor_bbox))
+                    target = min(candidates, key=lambda el: cls._center_distance(cls._get_bbox(el) or (0.0, 0.0, 0.0, 0.0), anchor_bbox))
                     if target.get("id"):
                         healed = f"#{target['id']}"
                     elif target.get("data-testid") or target.get("test-id"):