cursorflow 2.1.2__py3-none-any.whl → 2.1.4__py3-none-any.whl

cursorflow/__init__.py

@@ -56,7 +56,7 @@ def _get_version():
         pass
     
     # Fallback version - should match pyproject.toml
-    return "2.1.2"
+    return "2.1.4"
 
 __version__ = _get_version()
 __author__ = "GeekWarrior Development"

cursorflow/core/browser_controller.py

@@ -419,11 +419,21 @@ class BrowserController:
         """
         try:
             # Process options with defaults
-            screenshot_options = options or {}
-            full_page = screenshot_options.get("full_page", False)
-            clip_config = screenshot_options.get("clip")
-            mask_selectors = screenshot_options.get("mask", [])
-            quality = screenshot_options.get("quality", 80)
+            raw_options = options or {}
+            full_page = raw_options.get("full_page", False)
+            clip_config = raw_options.get("clip")
+            mask_selectors = raw_options.get("mask", [])
+            quality = raw_options.get("quality", 80)
+            
+            # Build actual screenshot options used (for metadata)
+            screenshot_options = {
+                "full_page": full_page,
+                "quality": quality
+            }
+            if clip_config:
+                screenshot_options["clip"] = clip_config
+            if mask_selectors:
+                screenshot_options["mask"] = mask_selectors
             
             timestamp = int(time.time())
             screenshot_filename = f".cursorflow/artifacts/screenshots/{name}_{timestamp}.png"

cursorflow/install_cursorflow_rules.py

@@ -125,9 +125,9 @@ def create_config_template(project_path: Path, force: bool = False):
     # Get current version
     try:
         import cursorflow
-        current_version = getattr(cursorflow, '__version__', '2.1.2')
+        current_version = getattr(cursorflow, '__version__', '2.1.4')
     except ImportError:
-        current_version = '2.1.2'
+        current_version = '2.1.4'
     
     if config_path.exists():
         if not force:
@@ -302,9 +302,9 @@ def setup_update_checking(project_path: Path):
     # Create initial version tracking
     try:
         import cursorflow
-        current_version = getattr(cursorflow, '__version__', '2.1.2')
+        current_version = getattr(cursorflow, '__version__', '2.1.4')
     except ImportError:
-        current_version = '2.1.2'
+        current_version = '2.1.4'
     
     version_info = {
         "installed_version": current_version,

cursorflow/log_sources/local_file.py

@@ -30,11 +30,17 @@ class LocalFileLogSource:
                     'next_server': '.next/trace.log'
                 }
         """
-        self.log_paths = log_paths
+        # Handle case where log_paths is a string instead of dict
+        if isinstance(log_paths, str):
+            self.log_paths = {"default": log_paths}
+        elif isinstance(log_paths, list):
+            self.log_paths = {f"log_{i}": path for i, path in enumerate(log_paths)}
+        else:
+            self.log_paths = log_paths
         self.log_queue = queue.Queue()
         self.tail_processes = {}
         self.monitoring = False
-        self.connect = True  # Attribute expected by other components
+        # Note: connect() method implemented below for compatibility
         
         import logging
         self.logger = logging.getLogger(__name__)
@@ -158,6 +164,10 @@ class LocalFileLogSource:
         
         return logs
     
+    async def connect(self):
+        """Connect to log sources - compatibility method for log_collector"""
+        return await self.start_monitoring()
+    
     def get_recent_logs(self, seconds: int = 10) -> List[Dict]:
         """Get logs from the last N seconds"""
         from datetime import timedelta

cursorflow/log_sources/ssh_remote.py

@@ -43,7 +43,7 @@ class SSHRemoteLogSource:
         self.ssh_client = None
         self.monitoring_threads = []
         self.monitoring = False
-        self.connect = True  # Attribute expected by other components
+        # Note: connect() method implemented below for compatibility
         
         self.logger = logging.getLogger(__name__)
         
@@ -161,6 +161,10 @@ class SSHRemoteLogSource:
         
         return logs
     
+    async def connect(self):
+        """Connect to SSH log sources - compatibility method for log_collector"""
+        return await self.start_monitoring()
+    
     def get_recent_logs(self, seconds: int = 10) -> List[Dict]:
         """Get logs from the last N seconds without stopping monitoring"""
         

cursorflow/rules/cursorflow-installation.mdc

@@ -3,9 +3,9 @@ title: CursorFlow 2.0.0 Installation & Setup Guide for Cursor
 description: How to install and configure CursorFlow 2.0.0 for complete page intelligence in AI-driven development
 ---
 
-# CursorFlow 2.0.0 Installation & Setup Guide for Cursor
+# CursorFlow 2.1.4 Installation & Setup Guide for Cursor
 
-## 🚀 **When to Install CursorFlow 2.0.0**
+## 🚀 **When to Install CursorFlow 2.1.4**
 
 ### **Automatically Install When:**
 - User mentions UI testing, visual debugging, or layout issues

cursorflow/rules/cursorflow-usage.mdc

@@ -1,6 +1,6 @@
 # CursorFlow Usage Rules for Cursor AI
 
-## 🔥 **CursorFlow 2.0.0: Complete Page Intelligence for AI-Driven Development**
+## 🔥 **CursorFlow 2.1.4: Complete Page Intelligence for AI-Driven Development**
 
 **CursorFlow provides comprehensive data collection for rapid UI iteration:**
 
@@ -9,6 +9,8 @@
 - 📊 **Comprehensive Page Analysis** - Fonts, animations, resources, storage state
 - 🎯 **Enhanced Error Context Collection** - Smart screenshot deduplication
 - ⚡ **Enhanced Browser Data Capture** - Playwright traces + network interception
+- 📱 **Parallel Viewport Testing** - Mobile, tablet, desktop responsive testing
+- 🖼️ **Enhanced Screenshot Options** - Clipping, masking, quality control
 
 ## When to Use CursorFlow
 
@@ -217,7 +219,7 @@ print(f"Performance metrics: {screenshot_data['performance_data']}")
 # Playwright trace available at: .cursorflow/artifacts/traces/session.zip
 ```
 
-## 🚀 **CursorFlow CLI Usage (v2.0.0)**
+## 🚀 **CursorFlow CLI Usage (v2.1.4)**
 
 ### **Basic Testing:**
 ```bash
@@ -233,12 +235,33 @@ cursorflow test \
     {"screenshot": "state"}
   ]'
 
+# 🆕 Parallel responsive testing (mobile, tablet, desktop)
+cursorflow test --base-url http://localhost:3000 --path "/dashboard" --responsive
+
+# 🆕 Enhanced screenshot options
+cursorflow test \
+  --base-url http://localhost:3000 \
+  --actions '[
+    {"navigate": "/page"},
+    {"screenshot": {
+      "name": "clipped-header",
+      "options": {
+        "clip": {"selector": "#header"},
+        "mask": [".user-email", ".sensitive-data"],
+        "full_page": false,
+        "quality": 90
+      }
+    }}
+  ]'
+
 # Results include:
 # - Hot Reload Intelligence status
 # - Advanced Element Intelligence (7 selector types)
 # - Comprehensive Page Analysis (fonts, animations, resources)
 # - Enhanced Error Context (smart deduplication)
 # - Enhanced Browser Data (Playwright traces)
+# - 🆕 Parallel Viewport Analysis (responsive testing)
+# - 🆕 Enhanced Screenshot Metadata (options used)
 ```
 
 ### **Available CLI Commands:**
@@ -260,7 +283,10 @@ cursorflow --help           # Show all commands and options
 | `fill` | `{"fill": {"selector": "#input", "value": "text"}}` | Fill form field |
 | `wait` | `{"wait": 2}` | Wait seconds |
 | `wait_for` | `{"wait_for": "#element"}` | Wait for element |
-| `screenshot` | `{"screenshot": "name"}` | Take screenshot |
+| `screenshot` | `{"screenshot": "name"}` | Take basic screenshot |
+| 🆕 `screenshot` | `{"screenshot": {"name": "test", "options": {"clip": {"selector": "#header"}}}}` | Enhanced screenshot with clipping |
+| 🆕 `screenshot` | `{"screenshot": {"name": "test", "options": {"mask": [".sensitive"]}}}` | Screenshot with masked elements |
+| 🆕 `screenshot` | `{"screenshot": {"name": "test.jpg", "options": {"quality": 90}}}` | JPEG screenshot with quality |
 
 ## Common Usage Patterns
 
@@ -279,6 +305,48 @@ cursorflow test \
   ]'
 ```
 
+### 🆕 Responsive Testing (Parallel Viewports)
+```bash
+# Simple responsive test across mobile, tablet, desktop
+cursorflow test --base-url http://localhost:3000 --path "/dashboard" --responsive
+
+# Custom responsive test with actions
+cursorflow test --base-url http://localhost:3000 --responsive --actions '[
+  {"navigate": "/dashboard"},
+  {"wait_for": "#main-content"},
+  {"screenshot": "responsive-dashboard"},
+  {"click": "#menu-toggle"},
+  {"screenshot": "responsive-menu"}
+]'
+
+# Results include:
+# - Performance comparison across viewports
+# - Layout differences analysis
+# - Responsive behavior insights
+# - Cross-viewport screenshots
+```
+
+### 🆕 Enhanced Screenshot Options
+```bash
+# Component-focused screenshots
+cursorflow test --base-url http://localhost:3000 --actions '[
+  {"navigate": "/page"},
+  {"screenshot": {"name": "header", "options": {"clip": {"selector": "#header"}}}}
+]'
+
+# Privacy-aware screenshots (mask sensitive data)
+cursorflow test --base-url http://localhost:3000 --actions '[
+  {"navigate": "/profile"},
+  {"screenshot": {"name": "profile", "options": {"mask": [".user-email", ".api-key"]}}}
+]'
+
+# High-quality JPEG screenshots
+cursorflow test --base-url http://localhost:3000 --actions '[
+  {"navigate": "/page"},
+  {"screenshot": {"name": "page.jpg", "options": {"quality": 95, "full_page": true}}}
+]'
+```
+
 ### Login Flow Testing
 ```bash
 cursorflow test \

{cursorflow-2.1.2.dist-info → cursorflow-2.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.1.2
+Version: 2.1.4
 Summary: 🔥 Complete page intelligence for AI-driven development with Hot Reload Intelligence - captures DOM, network, console, performance, HMR events, and comprehensive page analysis
 Author-email: GeekWarrior Development <rbush@cooltheory.com>
 License-Expression: MIT

{cursorflow-2.1.2.dist-info → cursorflow-2.1.4.dist-info}/RECORD

@@ -1,11 +1,11 @@
-cursorflow/__init__.py,sha256=pZBGeQOH2whVKOyck1v7_SRRtceC5yD-SRy7Zn014Sw,2763
+cursorflow/__init__.py,sha256=3zdOAvMaLDe_OLKUbh-G9q0jXnprS-9CHxpRxKJPWy8,2763
 cursorflow/auto_updater.py,sha256=oQ12TIMZ6Cm3HF-x9iRWFtvOLkRh-JWPqitS69-4roE,7851
 cursorflow/cli.py,sha256=ca36aTHFLYpiaeQYoj3TB4o39CEfj3WWaePze8yNvdg,27280
-cursorflow/install_cursorflow_rules.py,sha256=NZfZC80XgKUEQVVuaPQHvhuY37V3HIGN2ZW5yZffVbQ,11792
+cursorflow/install_cursorflow_rules.py,sha256=xIVw1DhqHL9YDT_JM7sXfVcMXIB0OuYZjC18jac-v8o,11792
 cursorflow/updater.py,sha256=rAST7STjw-SgKxn_jsQJWOoyEMia-MQVxpKMwzPRnOA,19573
 cursorflow/core/agent.py,sha256=f3lecgEzDRDdGTVccAtorpLGfNJJ49bbsQAmgr0vNGg,10136
 cursorflow/core/auth_handler.py,sha256=oRafO6ZdxoHryBIvHsrNV8TECed4GXpJsdEiH0KdPPk,17149
-cursorflow/core/browser_controller.py,sha256=8TfhkBavWbwhTEGUmLdvA4UvIdLI64qct1HpnSBjBFo,131364
+cursorflow/core/browser_controller.py,sha256=KZXSrXInju09Q--D_ULej4_hc5s7qv-7ODxW4WS0nHw,131708
 cursorflow/core/browser_engine.py,sha256=RpGtMOjyE7WW2BiR1cKcNnXNuiUbKt5svFgn1k3zozo,14415
 cursorflow/core/css_iterator.py,sha256=whLCIwbHZEWaH1HCbmqhNX5zrh_fL-r3hsxKjYsukcE,16478
 cursorflow/core/cursor_integration.py,sha256=MAeHjXYeqzaXnhskqkTDB-n5ixIHqapGe93X0lLKhws,67501
@@ -21,14 +21,14 @@ cursorflow/core/mockup_comparator.py,sha256=VLfEEaTgbcY0oTb-bhBD2uTbXGjbnOV7LXNV
 cursorflow/core/persistent_session.py,sha256=FsEHj4wKkycmdp6PFRHv3g333Y74yqra0x_qhUTQpik,36075
 cursorflow/core/report_generator.py,sha256=-vosfyrnfVyWDbAIMlMurl90xOXqBae8d6aLd9sEqiY,10113
 cursorflow/core/trace_manager.py,sha256=Jj9ultZrL1atiZXfcRVI6ynCnnfqZM-X0_taxt-llJ0,7189
-cursorflow/log_sources/local_file.py,sha256=Hn3hDQjAqgNBQN8b5AbC6IQAzgY_ekLgePwDuq9wBlA,7101
-cursorflow/log_sources/ssh_remote.py,sha256=zSnX8mpa5G86UDWEm3_FqYwo1PjBW67C1LPkJ5Ta_ho,7482
+cursorflow/log_sources/local_file.py,sha256=YAzF6oZRusNT_EOJduoeMTgP6dc1Av9wK96yNxmhSGA,7558
+cursorflow/log_sources/ssh_remote.py,sha256=xLLxm5B95kUcLqMC7-oZUA66e1rU5LLeeBiR6Mw5syc,7642
 cursorflow/rules/__init__.py,sha256=gPcA-IkhXj03sl7cvZV0wwo7CtEkcyuKs4y0F5oQbqE,458
-cursorflow/rules/cursorflow-installation.mdc,sha256=PZN4hHpy2_g3EzD8BxZYhXF9A6YCvtMGaD3uOA7UVSs,9511
-cursorflow/rules/cursorflow-usage.mdc,sha256=SAsJRmml8W1zE_jArZnRtygO9RmggjEzxGA6hxBJ-H4,18924
-cursorflow-2.1.2.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-2.1.2.dist-info/METADATA,sha256=X2FUWbVHRC8PF-K2JzccvIVAbMqmqQEhd8iVuav5acE,12300
-cursorflow-2.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-2.1.2.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-2.1.2.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-2.1.2.dist-info/RECORD,,
+cursorflow/rules/cursorflow-installation.mdc,sha256=dLyQmKvER5J54EV5GAb-g4xNPMZP8pqecZpOlxf-tKA,9511
+cursorflow/rules/cursorflow-usage.mdc,sha256=jD5IrIP2eKIeQN2TS-ehnwD1u_J6lWSXQZZ9KSUcOUU,21449
+cursorflow-2.1.4.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.1.4.dist-info/METADATA,sha256=97woSQvbkl5nqSs2kOKwriTlwz1S41gp2u4dHOusFNU,12300
+cursorflow-2.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.1.4.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.1.4.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.1.4.dist-info/RECORD,,