synapse-hub 2.4.3 → 2.6.0

package/tools/browser_helpers.js

@@ -13,7 +13,7 @@
 (function () {
   'use strict';
 
-  if (window.__qa && window.__qa.__version === '2.4.3') {
+  if (window.__qa && window.__qa.__version === '2.5.0') {
     return window.__qa;
   }
 
@@ -47,7 +47,7 @@
   }
 
   const qa = {
-    __version: '2.4.3',
+    __version: '2.5.0',
 
     /**
      * 1. Smart Action Batching
@@ -682,6 +682,61 @@
 
         check();
       });
+    },
+
+    /**
+     * 9. DFSDT Backtracking Locator Resolver (ToolBench / Master Locator Hierarchy Pattern)
+     * Executes Depth-First Search across 6 architectural locator tiers when a selector fails or goes stale.
+     * Evaluates DOM presence, visibility, and clickability before returning the resilient candidate.
+     * @param {Object|string} spec { testId, role, text, formControl, id, css } or broken selector string
+     * @returns {Object} { resolved: boolean, tier: number, selector: string, element: HTMLElement|null }
+     */
+    dfsdtResolve: function (spec) {
+      if (typeof document === 'undefined') {
+        return { resolved: false, tier: 0, selector: null, element: null };
+      }
+      const candidates = [];
+      if (typeof spec === 'string') {
+        const clean = spec.replace(/['"\\\[\]]/g, '').trim();
+        candidates.push({ tier: 1, sel: `[data-testid="${clean}"]` });
+        candidates.push({ tier: 2, sel: `[role="button"][name="${clean}"], [role="textbox"][name="${clean}"]` });
+        candidates.push({ tier: 2, sel: `button:has-text("${clean}"), a:has-text("${clean}")` });
+        candidates.push({ tier: 3, sel: `[formcontrolname="${clean}"]` });
+        candidates.push({ tier: 3, sel: `[name="${clean}"]` });
+        candidates.push({ tier: 4, sel: `#${clean}` });
+      } else if (spec && typeof spec === 'object') {
+        if (spec.testId) candidates.push({ tier: 1, sel: `[data-testid="${spec.testId}"]` });
+        if (spec.role && spec.name) candidates.push({ tier: 1, sel: `[role="${spec.role}"][name="${spec.name}"]` });
+        if (spec.text) candidates.push({ tier: 2, sel: `button:has-text("${spec.text}"), a:has-text("${spec.text}"), span:has-text("${spec.text}")` });
+        if (spec.formControl) candidates.push({ tier: 3, sel: `[formcontrolname="${spec.formControl}"]` });
+        if (spec.name) candidates.push({ tier: 3, sel: `[name="${spec.name}"]` });
+        if (spec.id) candidates.push({ tier: 4, sel: `#${spec.id}` });
+        if (spec.css) candidates.push({ tier: 5, sel: spec.css });
+      }
+
+      // DFSDT Backtracking evaluation
+      for (const cand of candidates) {
+        try {
+          const els = Array.from(document.querySelectorAll(cand.sel));
+          for (const el of els) {
+            const rect = el.getBoundingClientRect();
+            const isVisible = !!(rect.width > 0 && rect.height > 0 && window.getComputedStyle(el).display !== 'none' && window.getComputedStyle(el).visibility !== 'hidden');
+            if (isVisible) {
+              return {
+                resolved: true,
+                tier: cand.tier,
+                selector: cand.sel,
+                element: el
+              };
+            }
+          }
+        } catch (e) {
+          // Backtrack to next candidate tier
+          continue;
+        }
+      }
+
+      return { resolved: false, tier: 0, selector: null, element: null };
     }
   };
 

package/tools/bump_version.py

@@ -142,7 +142,18 @@ def git_commit_and_tag(version: str, push: bool = False):
 
     if push:
         print(f"🚀 Pushing commit and tags to remote origin...")
-        subprocess.run(["git", "push", "origin", "HEAD", "--tags"], cwd=REPO_ROOT, check=True)
+        res = subprocess.run(["git", "branch", "--show-current"], cwd=REPO_ROOT, stdout=subprocess.PIPE, text=True)
+        cur_branch = res.stdout.strip()
+        if cur_branch == "develop":
+            try:
+                subprocess.run(["git", "checkout", "main"], cwd=REPO_ROOT, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                subprocess.run(["git", "merge", "develop", "--ff-only"], cwd=REPO_ROOT, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                subprocess.run(["git", "checkout", "develop"], cwd=REPO_ROOT, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                subprocess.run(["git", "push", "origin", "develop", "main", "--tags"], cwd=REPO_ROOT, check=True)
+            except Exception:
+                subprocess.run(["git", "push", "origin", "HEAD", "--tags"], cwd=REPO_ROOT, check=True)
+        else:
+            subprocess.run(["git", "push", "origin", "HEAD", "--tags"], cwd=REPO_ROOT, check=True)
         print(f"✅ Remote origin synchronized.")
 
 def main():
@@ -174,7 +185,7 @@ def main():
     update_json_root_version("plugin.json", new_ver, args.dry_run)
 
     # 2. pyproject.toml
-    update_file("pyproject.toml", r'(version\s*=\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
+    update_file("pyproject.toml", r'(?m)^(\s*version\s*=\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
 
     # 3. skills_manifest.json
     update_json_root_version("skills_manifest.json", new_ver, args.dry_run)
@@ -222,6 +233,23 @@ def main():
     update_file("tools/update_sentinel.py", r'(\.get\("version",\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
     update_file("tools/update_sentinel.py", r'(return\s*")[0-9]+\.[0-9]+\.[0-9]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
 
+    # 14. CHANGELOG.md
+    cl_path = os.path.join(REPO_ROOT, "CHANGELOG.md")
+    if os.path.exists(cl_path) and not args.dry_run:
+        try:
+            with open(cl_path, "r", encoding="utf-8") as f:
+                cl_text = f.read()
+            if f"## [{new_ver}]" not in cl_text:
+                from datetime import date
+                today_str = date.today().isoformat()
+                new_block = f"---\n\n## [{new_ver}] - {today_str}\n\n### Changed\n- Maintenance & version release v{new_ver}.\n\n"
+                cl_text = re.sub(r'(?m)^---\s*\n\s*##\s*\[', new_block + "## [", cl_text, count=1)
+                with open(cl_path, "w", encoding="utf-8") as f:
+                    f.write(cl_text)
+                print(f"  [UPDATED] CHANGELOG.md (v{new_ver} entry added)")
+        except Exception as e:
+            print(f"  [WARN] CHANGELOG.md update notice: {e}")
+
     if args.dry_run:
         print("\n[INFO] Dry-run completed. No files modified on disk.")
         return

package/tools/cache_resolver.py

@@ -285,8 +285,8 @@ def get_db(db_path=None, timeout=30.0):
         conn.execute("PRAGMA journal_mode=WAL;")
         conn.execute("PRAGMA synchronous=NORMAL;")
         conn.execute("PRAGMA busy_timeout=30000;")
-    except Exception:
-        pass
+    except sqlite3.Error as e:
+        sys.stderr.write(f"Notice: SQLite PRAGMA configuration skipped: {e}\n")
     return conn
 
 
@@ -312,8 +312,8 @@ def init_db(seed=True, target_db=None):
         """)
         try:
             cursor.execute("ALTER TABLE healing_cache ADD COLUMN code_patch TEXT DEFAULT ''")
-        except Exception:
-            pass
+        except sqlite3.OperationalError:
+            column_exists = True
 
         # 2. Negative Memory Table (Blacklist of Failed Fix Attempts)
         cursor.execute("""
@@ -372,8 +372,8 @@ def init_db(seed=True, target_db=None):
                     """, (r["error_signature"], r["module_name"], r["symptom"], r["root_cause"], r["groovy_patch"], r["hit_count"]))
                 conn.commit()
                 local_conn.close()
-            except Exception:
-                pass
+            except (sqlite3.Error, OSError) as e:
+                sys.stderr.write(f"Notice: Local cache migration skipped: {e}\n")
 
         if seed:
             for s in SEED_SOLUTIONS:

package/tools/check_env.py

@@ -13,6 +13,7 @@ Autonomously detects Target Project or QA Hub (CLI, CWD, ENV).
 import os
 import sys
 import shutil
+import shlex
 import platform
 import subprocess
 import argparse
@@ -89,8 +90,13 @@ class DiagnosticRunner:
 
     def run_command(self, cmd, timeout: float = 15.0):
         try:
-            res = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, shell=isinstance(cmd, str), timeout=timeout)
-            return res.returncode == 0, res.stdout.strip()
+            if isinstance(cmd, str):
+                cmd_args = shlex.split(cmd, posix=(platform.system() != "Windows"))
+            else:
+                cmd_args = list(cmd)
+            res = subprocess.run(cmd_args, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, shell=False, timeout=timeout)
+            out = res.stdout.strip() if res.stdout.strip() else res.stderr.strip()
+            return res.returncode == 0, out
         except Exception as e:
             return False, str(e)
 
@@ -225,8 +231,8 @@ class DiagnosticRunner:
         is_user_home = False
         try:
             is_user_home = self.target_dir.resolve() == Path.home().resolve()
-        except Exception:
-            pass
+        except OSError:
+            is_user_home = False
 
         has_project_marker = any([
             (self.target_dir / marker).exists() for marker in [
@@ -303,8 +309,8 @@ class DiagnosticRunner:
                         k, v = line.strip().split("=", 1)
                         if k.strip() not in os.environ:
                             os.environ[k.strip()] = v.strip().strip("'\"")
-            except Exception:
-                pass
+            except OSError as err:
+                sys.stderr.write(f"Notice: .env read failed: {err}\n")
 
         base = os.environ.get("BASE_URL", "").rstrip("/")
         if not base:
@@ -328,7 +334,7 @@ class DiagnosticRunner:
                 ctx.verify_mode = ssl.CERT_NONE
 
             req = urllib.request.Request(test_url, headers={'User-Agent': 'Mozilla/5.0'})
-            with urllib.request.urlopen(req, timeout=8, context=ctx) as resp:
+            with urllib.request.urlopen(req, timeout=8, context=ctx) as resp:  # nosec B310
                 code = resp.getcode()
                 if code in (200, 301, 302):
                     self.log_check("Network / Server Base URL", "PASS", f"Connection successful to {test_url} (HTTP {code})")