@specsage/cli 0.1.7 → 0.1.9

package/lib/browser.js

@@ -248,6 +248,7 @@ async function enumerateElements() {
             w: Math.round(box.width),
             h: Math.round(box.height)
           },
+          locator: el,
           mechanism: 'native',
           source: 'native'
         });
@@ -336,6 +337,7 @@ async function enumerateElements() {
             w: Math.round(box.width),
             h: Math.round(box.height)
           },
+          locator: el,
           mechanism: 'scripted',
           source: source
         });
@@ -427,7 +429,8 @@ async function enumerateElements() {
   }
 
   lastElements = uniqueElements;
-  return lastElements;
+  // Return elements without the locator property (not JSON-serializable)
+  return lastElements.map(({ locator, ...rest }) => rest);
 }
 
 async function debugOverlay(x, y) {
@@ -499,9 +502,26 @@ async function handleCommand(msg) {
         if (!element) throw new Error(`Element not found: ${element_id}`);
         lastClickedElement = element; // Store for keypress context
 
-        const { x, y, w, h } = element.bounding_box;
+        let { x, y, w, h } = element.bounding_box;
+
+        // Auto-scroll element into view if its center is outside the viewport
+        const viewportSize = page.viewportSize();
+        let centerY = y + h / 2;
+        if (element.locator && (centerY < 0 || centerY >= viewportSize.height)) {
+          await element.locator.scrollIntoViewIfNeeded({ timeout: 3000 });
+          await new Promise(r => setTimeout(r, 200));
+          const newBox = await element.locator.boundingBox();
+          if (newBox) {
+            x = Math.round(newBox.x);
+            y = Math.round(newBox.y);
+            w = Math.round(newBox.width);
+            h = Math.round(newBox.height);
+            element.bounding_box = { x, y, w, h };
+          }
+        }
+
         const centerX = x + w / 2;
-        const centerY = y + h / 2;
+        centerY = y + h / 2;
 
         await debugOverlay(centerX, centerY);
 
@@ -559,9 +579,26 @@ async function handleCommand(msg) {
         if (!element) throw new Error(`Element not found: ${element_id}`);
 
         // Find the select element by its bounding box center
-        const { x, y, w, h } = element.bounding_box;
+        let { x, y, w, h } = element.bounding_box;
+
+        // Auto-scroll element into view if its center is outside the viewport
+        const viewportSize = page.viewportSize();
+        let centerY = y + h / 2;
+        if (element.locator && (centerY < 0 || centerY >= viewportSize.height)) {
+          await element.locator.scrollIntoViewIfNeeded({ timeout: 3000 });
+          await new Promise(r => setTimeout(r, 200));
+          const newBox = await element.locator.boundingBox();
+          if (newBox) {
+            x = Math.round(newBox.x);
+            y = Math.round(newBox.y);
+            w = Math.round(newBox.width);
+            h = Math.round(newBox.height);
+            element.bounding_box = { x, y, w, h };
+          }
+        }
+
         const centerX = x + w / 2;
-        const centerY = y + h / 2;
+        centerY = y + h / 2;
 
         // Use Playwright's selectOption by locating the element at the position
         const selectEl = page.locator('select').filter({

package/lib/cli.rb

@@ -71,6 +71,15 @@ class SpecSageCLI
     parser.parse!(@args)
   end
 
+  def build_ci_metadata
+    metadata = {}
+    metadata[:commit_sha] = ENV['GITHUB_SHA'] if ENV['GITHUB_SHA']
+    metadata[:branch] = ENV['GITHUB_REF_NAME'] if ENV['GITHUB_REF_NAME']
+    metadata[:pr_number] = ENV['GITHUB_PR_NUMBER'].to_i if ENV['GITHUB_PR_NUMBER']
+    metadata[:commit_message] = ENV['GITHUB_COMMIT_MESSAGE'] if ENV['GITHUB_COMMIT_MESSAGE']
+    metadata
+  end
+
   def run_ci_mode
     website = ENV['TARGET_WEBSITE_SLUG']
     api_key = ENV['SPEC_SAGE_API_KEY']
@@ -108,7 +117,7 @@ class SpecSageCLI
     puts ""
 
     begin
-      run_response = publisher.create_ci_run(website)
+      run_response = publisher.create_ci_run(website, ci_metadata: build_ci_metadata)
       server_run_id = run_response['server_run_id']
     rescue ResultsUploader::UploadError => e
       puts "Error creating run: #{e.message}"

package/lib/results_uploader.rb

@@ -58,8 +58,11 @@ class ResultsUploader
 
   # Create a CI run on the server
   # Returns hash with server_run_id and base_url
-  def create_ci_run(website_identifier)
-    post("/api/v1/ci/runs", { website: website_identifier })
+  # ci_metadata can include: commit_sha, branch, pr_number, commit_message
+  def create_ci_run(website_identifier, ci_metadata: {})
+    body = { website: website_identifier }
+    body.merge!(ci_metadata) if ci_metadata.any?
+    post("/api/v1/ci/runs", body)
   end
 
   private

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specsage/cli",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "SpecSage CLI - AI-powered end-to-end testing automation (Node wrapper for Ruby CLI)",
   "type": "module",
   "bin": {
@@ -31,6 +31,6 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "playwright": "^1.57.0"
+    "playwright": "1.57.0"
   }
 }