cursorflow 2.1.6__py3-none-any.whl → 2.2.1__py3-none-any.whl

cursorflow/core/cursorflow.py

@@ -669,6 +669,15 @@ class CursorFlow:
     
     async def _execute_actions(self, actions: List[Dict]) -> bool:
         """Execute list of declarative actions"""
+        # Validate all actions before execution
+        from .action_validator import ActionValidator, ActionValidationError
+        
+        try:
+            actions = ActionValidator.validate_list(actions)
+        except ActionValidationError as e:
+            self.logger.error(f"Action validation failed: {e}")
+            return False
+        
         try:
             for action in actions:
                 await self._execute_single_action(action)
@@ -678,44 +687,26 @@ class CursorFlow:
             return False
     
     async def _execute_single_action(self, action: Dict):
-        """Execute a single declarative action and track it"""
+        """
+        Execute a single declarative action and track it
+        
+        Pass-through architecture: CursorFlow handles a few special actions,
+        then passes everything else directly to Playwright Page API.
+        """
         action_start = time.time()
         
         try:
-            # Navigation actions
-            if "navigate" in action:
+            # Extract action type
+            action_type = action.get('type') or list(action.keys())[0]
+            
+            # CursorFlow-specific actions (not direct Playwright methods)
+            if action_type == "navigate":
                 url = action["navigate"]
                 if isinstance(url, dict):
                     url = url["url"]
                 await self.browser.navigate(url)
                 
-            # Interaction actions
-            elif "click" in action:
-                selector = action["click"]
-                if isinstance(selector, dict):
-                    selector = selector["selector"]
-                await self.browser.click(selector)
-                
-            elif "fill" in action:
-                config = action["fill"]
-                await self.browser.fill(config["selector"], config["value"])
-                
-            elif "type" in action:
-                config = action["type"]
-                await self.browser.type(config["selector"], config["text"])
-                
-            # Waiting actions
-            elif "wait" in action:
-                await asyncio.sleep(action["wait"])
-                
-            elif "wait_for" in action:
-                selector = action["wait_for"]
-                if isinstance(selector, dict):
-                    selector = selector["selector"]
-                await self.browser.wait_for_element(selector)
-                
-            # Capture actions
-            elif "screenshot" in action:
+            elif action_type == "screenshot":
                 screenshot_config = action["screenshot"]
                 
                 # Handle both string and dict formats
@@ -734,15 +725,19 @@ class CursorFlow:
                 screenshot_data = await self.browser.screenshot(name, options)
                 self.artifacts["screenshots"].append(screenshot_data)
                 
-            elif "authenticate" in action:
+            elif action_type == "authenticate":
                 if self.auth_handler:
                     await self.auth_handler.authenticate(self.browser.page, action["authenticate"])
+            
+            # Pass-through to Playwright Page API (hover, dblclick, press, etc.)
+            else:
+                await self._execute_playwright_action(action_type, action)
                     
             # Record action in timeline
             self.timeline.append({
                 "timestamp": action_start,
                 "type": "browser",
-                "event": list(action.keys())[0],
+                "event": action_type,
                 "data": action,
                 "duration": time.time() - action_start
             })
@@ -751,6 +746,47 @@ class CursorFlow:
             self.logger.error(f"Action failed: {action}, error: {e}")
             raise
     
+    async def _execute_playwright_action(self, action_type: str, action: Dict):
+        """
+        Pass-through to Playwright Page API
+        
+        Enables using any Playwright method without hardcoding them:
+        - hover, dblclick, drag_and_drop
+        - press, focus, blur, check, uncheck
+        - evaluate, route, expose_function
+        - And 90+ more methods
+        
+        See: https://playwright.dev/python/docs/api/class-page
+        """
+        # Get the action config
+        action_config = action.get(action_type)
+        
+        # Check if method exists on Playwright Page
+        if hasattr(self.browser.page, action_type):
+            method = getattr(self.browser.page, action_type)
+            
+            # Call with appropriate args based on config format
+            if isinstance(action_config, str):
+                # Simple format: {"hover": ".selector"}
+                await method(action_config)
+            elif isinstance(action_config, dict):
+                # Config format: {"hover": {"selector": ".item", "timeout": 5000}}
+                await method(**action_config)
+            elif action_config is None:
+                # No args: {"reload": null}
+                await method()
+            else:
+                # Numeric or other: {"wait": 2}
+                await method(action_config)
+        else:
+            # Method doesn't exist on Page - provide helpful error
+            available_methods = [m for m in dir(self.browser.page) if not m.startswith('_') and callable(getattr(self.browser.page, m))]
+            raise AttributeError(
+                f"Unknown Playwright action: '{action_type}'\n"
+                f"Available methods: {', '.join(sorted(available_methods[:20]))}...\n"
+                f"Full API: https://playwright.dev/python/docs/api/class-page"
+            )
+    
     async def _cleanup_session(self, session_options: Dict):
         """Clean up browser session"""
         try:

cursorflow/install_cursorflow_rules.py

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

cursorflow/log_sources/local_file.py

@@ -168,8 +168,27 @@ class LocalFileLogSource:
         """Connect to log sources - compatibility method for log_collector"""
         return await self.start_monitoring()
     
+    async def get_new_entries(self) -> List[Dict]:
+        """
+        Get new log entries since last call (required interface method)
+        
+        Returns:
+            List of log entry dicts with timestamp, content, source
+        """
+        new_entries = []
+        
+        # Drain queue of all available entries
+        while not self.log_queue.empty():
+            try:
+                log_entry = self.log_queue.get_nowait()
+                new_entries.append(log_entry)
+            except queue.Empty:
+                break
+        
+        return new_entries
+    
     def get_recent_logs(self, seconds: int = 10) -> List[Dict]:
-        """Get logs from the last N seconds"""
+        """Get logs from the last N seconds (non-destructive)"""
         from datetime import timedelta
         
         cutoff_time = datetime.now() - timedelta(seconds=seconds)

cursorflow/log_sources/ssh_remote.py

@@ -165,6 +165,25 @@ class SSHRemoteLogSource:
         """Connect to SSH log sources - compatibility method for log_collector"""
         return await self.start_monitoring()
     
+    async def get_new_entries(self) -> List[Dict]:
+        """
+        Get new log entries since last call (required interface method)
+        
+        Returns:
+            List of log entry dicts with timestamp, content, source
+        """
+        new_entries = []
+        
+        # Drain queue of all available entries
+        while not self.log_queue.empty():
+            try:
+                log_entry = self.log_queue.get_nowait()
+                new_entries.append(log_entry)
+            except queue.Empty:
+                break
+        
+        return new_entries
+    
     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

@@ -1,6 +1,7 @@
 ---
 title: CursorFlow Installation & Setup Guide for Cursor
 description: How to install and configure CursorFlow for complete page intelligence in AI-driven development
+alwaysApply: true
 ---
 
 # CursorFlow Installation & Setup Guide for Cursor

cursorflow/rules/cursorflow-usage.mdc

@@ -1,6 +1,12 @@
+---
+title: CursorFlow CLI Usage Guide for Cursor AI
+description: Complete guide for using CursorFlow CLI with comprehensive page intelligence and data collection
+alwaysApply: true
+---
+
 # CursorFlow Usage Rules for Cursor AI
 
-## 🔥 **CursorFlow 2.1.4: Complete Page Intelligence for AI-Driven Development**
+## 🔥 **CursorFlow: Complete Page Intelligence for AI-Driven Development**
 
 **CursorFlow provides comprehensive data collection for rapid UI iteration:**
 

{cursorflow-2.1.6.dist-info → cursorflow-2.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.1.6
+Version: 2.2.1
 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
@@ -82,20 +82,57 @@ When CursorFlow reports `"average_response_time": 416.58ms`, you can tell stakeh
 
 **Documentary vs Movie:** Both are valuable, but if you're trying to understand reality, you watch the documentary. CursorFlow is the documentary of web testing.
 
+## 🎯 Pass-Through Architecture
+
+CursorFlow doesn't limit you - it exposes the full power of Playwright:
+
+**94+ Playwright actions available:**
+```bash
+# Any Playwright Page method works
+cursorflow test --actions '[
+  {"hover": ".menu"},
+  {"dblclick": ".editable"},
+  {"press": "Enter"},
+  {"drag_and_drop": {"source": ".item", "target": ".zone"}},
+  {"check": "#checkbox"},
+  {"evaluate": "window.scrollTo(0, 500)"}
+]'
+```
+
+**Full configuration pass-through:**
+```json
+{
+  "browser_config": {
+    "browser_launch_options": {"devtools": true, "channel": "chrome"}
+  },
+  "context_options": {
+    "color_scheme": "dark",
+    "geolocation": {"latitude": 40.7128, "longitude": -74.0060},
+    "timezone_id": "America/Los_Angeles"
+  }
+}
+```
+
+**Forward-compatible:** New Playwright features work immediately without CursorFlow updates.
+
+**See:** [Playwright API Documentation](https://playwright.dev/python/docs/api/class-page)
+
+---
+
 ## 🚀 Complete Page Intelligence
 
-Every screenshot captures everything your AI needs to make intelligent decisions:
+Every test captures everything needed for debugging:
 
 ### **📊 Comprehensive Data Collection**
-- **DOM**: All elements with 7 selector strategies each
-- **Network**: All requests, responses, and complete response bodies  
-- **Console**: All logs, errors, and smart error correlation
-- **Performance**: Load times, memory usage, with reliability indicators
-- **Visual**: Screenshots with pixel-perfect comparisons and enhanced options
-- **Fonts**: Loading status, performance, and usage analysis
-- **Animations**: Active animations and transitions tracking
-- **Resources**: Complete resource loading analysis
-- **Storage**: localStorage, sessionStorage, cookies, IndexedDB state
+- **DOM**: All elements with 7 selector strategies + event handlers
+- **Network**: Requests, responses, and complete request/response bodies  
+- **Console**: All logs, errors, warnings - displayed prominently
+- **JavaScript**: Global functions, variables, specific window objects
+- **Storage**: localStorage, sessionStorage, cookies (sensitive data masked)
+- **Forms**: All field values at capture time (passwords masked)
+- **Performance**: Load times, memory usage, reliability indicators
+- **Visual**: Screenshots with comprehensive page analysis
+- **Sessions**: Save/restore browser state for authenticated testing
 
 ### **🔄 Hot Reload Intelligence**
 - **Framework auto-detection** (Vite, Webpack, Next.js, Parcel, Laravel Mix)
@@ -160,11 +197,26 @@ This creates:
 - `.gitignore` entries for CursorFlow artifacts
 
 ### Step 3: Start Testing
+
+**Simple page capture:**
 ```bash
-# Test real application behavior
-cursorflow test --base-url http://localhost:3000 --path "/dashboard"
+cursorflow test --base-url http://localhost:3000 --path /dashboard
+```
 
-# Get complete intelligence with custom actions
+**Interactive testing with inline actions:**
+```bash
+cursorflow test --base-url http://localhost:3000 \
+  --path /messages \
+  --wait-for ".message-item" \
+  --hover ".message-item:first-child" \
+  --click ".message-item:first-child" \
+  --screenshot "clicked" \
+  --show-console \
+  --open-trace
+```
+
+**Custom actions with JSON:**
+```bash
 cursorflow test --base-url http://localhost:3000 --actions '[
   {"navigate": "/login"},
   {"fill": {"selector": "#email", "value": "test@example.com"}},

{cursorflow-2.1.6.dist-info → cursorflow-2.2.1.dist-info}/RECORD

@@ -1,17 +1,19 @@
-cursorflow/__init__.py,sha256=6fFhPsv_4SP9xjmte1e47Sn9ikjQ-6jU_XyWpBcyMYs,2763
+cursorflow/__init__.py,sha256=3szUCSDj7rxLr4NkfDoXWq7BWqMf7__8vTFg15LWcXo,2763
 cursorflow/auto_init.py,sha256=dXQaXXiXe4wkUP-jd8fcJ5fYVt7ASdTb47b7SzXymOM,6122
 cursorflow/auto_updater.py,sha256=oQ12TIMZ6Cm3HF-x9iRWFtvOLkRh-JWPqitS69-4roE,7851
-cursorflow/cli.py,sha256=B0kmF_QdXWV2T3ibv55PKNF52Wu8wFQaLsAeVy1KGBI,28717
-cursorflow/install_cursorflow_rules.py,sha256=tMjvB1zk54wuVGOaVJPCDB6v4B8A6o0WdKx6_1QBqiM,11864
+cursorflow/cli.py,sha256=qSungpsi9OgL55w-LqgmGj-S7eJhfJq7ve_QwSoSEhI,43588
+cursorflow/install_cursorflow_rules.py,sha256=DsZ0680y9JMuTKFXjdgYtOKIEAjBMsdwL8LmA9WEb5A,11864
 cursorflow/post_install.py,sha256=WieBiKWG0qBAQpF8iMVWUyb9Fr2Xky9qECTMPrlAbpE,2678
 cursorflow/updater.py,sha256=SroSQHQi5cYyzcOK_bf-WzmQmE7yeOs8qo3r__j-Z6E,19583
+cursorflow/core/action_validator.py,sha256=SCk3w_62D1y0cCRDOajK8L44-abSj_KpnUBgR_yNVW4,6846
 cursorflow/core/agent.py,sha256=f3lecgEzDRDdGTVccAtorpLGfNJJ49bbsQAmgr0vNGg,10136
 cursorflow/core/auth_handler.py,sha256=oRafO6ZdxoHryBIvHsrNV8TECed4GXpJsdEiH0KdPPk,17149
-cursorflow/core/browser_controller.py,sha256=KZXSrXInju09Q--D_ULej4_hc5s7qv-7ODxW4WS0nHw,131708
-cursorflow/core/browser_engine.py,sha256=RpGtMOjyE7WW2BiR1cKcNnXNuiUbKt5svFgn1k3zozo,14415
+cursorflow/core/browser_controller.py,sha256=jA3zmdULJb4FLn3pS3zlK5RmbpRK8k4UVgwiVM6_pts,146990
+cursorflow/core/browser_engine.py,sha256=7N9hPOyDrEhLWYgZW2981N9gKlHF6Lbp7D7h0zBzuz8,14851
+cursorflow/core/config_validator.py,sha256=HRtONSOmM0Xxt3-ok3xwnBADRiNnI0nNOMaS2OqOkDk,7286
 cursorflow/core/css_iterator.py,sha256=whLCIwbHZEWaH1HCbmqhNX5zrh_fL-r3hsxKjYsukcE,16478
 cursorflow/core/cursor_integration.py,sha256=MAeHjXYeqzaXnhskqkTDB-n5ixIHqapGe93X0lLKhws,67501
-cursorflow/core/cursorflow.py,sha256=sLML1rP-caLY-r_llkq6rb4TGL8ZGb4pBwN5pbPQICY,43919
+cursorflow/core/cursorflow.py,sha256=oPe5R_m3V0DWy0FZcb0TL0rPDdz0KXw7KDcdR3Eg2Xs,45588
 cursorflow/core/error_context_collector.py,sha256=so-aveqwb6_vRDbtKR2ln8_F84aaVIceNi1UHsaVPgc,26196
 cursorflow/core/error_correlator.py,sha256=g6YaIF2yFXUDrTuWHCyuES6K0696H8LDWmXH1qI8ddA,13367
 cursorflow/core/event_correlator.py,sha256=lCzXFnii17AQt3rOVOclez_AnjvBCF_2ZlnFG0mIN6c,7808
@@ -23,14 +25,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=YAzF6oZRusNT_EOJduoeMTgP6dc1Av9wK96yNxmhSGA,7558
-cursorflow/log_sources/ssh_remote.py,sha256=xLLxm5B95kUcLqMC7-oZUA66e1rU5LLeeBiR6Mw5syc,7642
+cursorflow/log_sources/local_file.py,sha256=IEUslfRLwp19J4upMAnKNY9aoVl7zeIrrGbS-qQfyEw,8154
+cursorflow/log_sources/ssh_remote.py,sha256=kZRpLpiO7cLd67wlCiTvz4Prwx1_Vu3ytB5KHzOUFxc,8220
 cursorflow/rules/__init__.py,sha256=gPcA-IkhXj03sl7cvZV0wwo7CtEkcyuKs4y0F5oQbqE,458
-cursorflow/rules/cursorflow-installation.mdc,sha256=y4nj5XSROuBRXDK8GtfcEMRBqliQcEuvXYGyTPAZD8Q,10190
-cursorflow/rules/cursorflow-usage.mdc,sha256=jD5IrIP2eKIeQN2TS-ehnwD1u_J6lWSXQZZ9KSUcOUU,21449
-cursorflow-2.1.6.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-2.1.6.dist-info/METADATA,sha256=JahJbtiiK_gJyOvamARnNgLbKUjGUlMxysOe28X8UNQ,12790
-cursorflow-2.1.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-2.1.6.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-2.1.6.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-2.1.6.dist-info/RECORD,,
+cursorflow/rules/cursorflow-installation.mdc,sha256=D55pzzDPAVVbE3gAtKPUGoT-2fvB-FI2l6yrTdzUIEo,10208
+cursorflow/rules/cursorflow-usage.mdc,sha256=hCbA9koCtRoeLOkB-PXmLlGzsag_15RuOveOE_R4JZ0,21628
+cursorflow-2.2.1.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.2.1.dist-info/METADATA,sha256=gnoZ9OAIuFBdOyJ9Kcow_yIB4kGQwTt4G7KD6nkWxcQ,14014
+cursorflow-2.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.2.1.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.2.1.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.2.1.dist-info/RECORD,,