cursorflow 2.2.5__py3-none-any.whl → 2.2.6__py3-none-any.whl

cursorflow/__init__.py

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

cursorflow/cli.py

@@ -194,7 +194,7 @@ def test(base_url, path, actions, output, logs, config, verbose, headless, timeo
         # Simple path navigation
         test_actions = [
             {"navigate": path},
-            {"wait_for": "body"},
+            {"wait_for_selector": "body"},
             {"screenshot": "page_loaded"}
         ]
         console.print(f"📋 Using simple path navigation to [cyan]{path}[/cyan]")
@@ -202,7 +202,7 @@ def test(base_url, path, actions, output, logs, config, verbose, headless, timeo
         # Default actions - just navigate to root and screenshot
         test_actions = [
             {"navigate": "/"},
-            {"wait_for": "body"},
+            {"wait_for_selector": "body"},
             {"screenshot": "baseline"}
         ]
         console.print(f"📋 Using default actions (navigate to root + screenshot)")

cursorflow/core/browser_controller.py

@@ -1148,13 +1148,15 @@ class BrowserController:
             # v2.0 Enhancement: Resource loading analysis
             resource_analysis = await self._capture_resource_loading_analysis()
             
-            # v2.0 Enhancement: Storage state (read-only)
-            storage_analysis = await self._capture_storage_state()
+            # v2.2 Enhancement: Enhanced context capture
+            javascript_context = await self._capture_javascript_context()
+            storage_state = await self._capture_storage_state()  # This also serves as storage_analysis
+            form_state = await self._capture_form_state()
             
             # Create enhanced analysis summary
             analysis_summary = self._create_analysis_summary(
                 dom_analysis, network_data, console_data, performance_data,
-                font_analysis, animation_analysis, resource_analysis, storage_analysis
+                font_analysis, animation_analysis, resource_analysis, storage_state
             )
             
             return {
@@ -1171,7 +1173,7 @@ class BrowserController:
                 "font_analysis": font_analysis,
                 "animation_analysis": animation_analysis,
                 "resource_analysis": resource_analysis,
-                "storage_analysis": storage_analysis,
+                "storage_analysis": storage_state,  # v2.2 uses storage_state
                 
                 "analysis_summary": analysis_summary,
                 "capture_timestamp": time.time(),

cursorflow/core/cursorflow.py

@@ -143,6 +143,19 @@ class CursorFlow:
             )
             summary = self.correlator.get_summary(organized_timeline)
             
+            # Capture comprehensive data if screenshots were taken
+            comprehensive_data = {}
+            if self.artifacts.get("screenshots"):
+                # Get comprehensive data from last screenshot
+                last_screenshot = self.artifacts["screenshots"][-1]
+                if "comprehensive_data_path" in last_screenshot:
+                    import json
+                    try:
+                        with open(last_screenshot["comprehensive_data_path"], 'r') as f:
+                            comprehensive_data = json.load(f)
+                    except Exception as e:
+                        self.logger.warning(f"Could not load comprehensive data: {e}")
+            
             # Package results
             results = {
                 "success": success,
@@ -152,7 +165,8 @@ class CursorFlow:
                 "browser_events": self.timeline,  # Raw browser events
                 "server_logs": server_logs,       # Raw server logs
                 "summary": summary,               # Basic counts
-                "artifacts": self.artifacts
+                "artifacts": self.artifacts,
+                "comprehensive_data": comprehensive_data  # Complete page intelligence
             }
             
             self.logger.info(f"Test execution completed: {success}, timeline events: {len(organized_timeline)}")

cursorflow/core/log_collector.py

@@ -164,7 +164,11 @@ class LogCollector:
     async def _monitor_source(self, source):
         """Monitor a single log source"""
         try:
-            await source.connect()
+            # connect() returns bool, not awaitable - just call it
+            connected = await source.connect()
+            if not connected:
+                self.logger.warning(f"Log source {source} failed to connect")
+                return
             
             while self.monitoring:
                 try:

cursorflow/log_sources/local_file.py

@@ -168,6 +168,10 @@ class LocalFileLogSource:
         """Connect to log sources - compatibility method for log_collector"""
         return await self.start_monitoring()
     
+    async def disconnect(self):
+        """Disconnect from log sources - compatibility method for log_collector"""
+        return await self.stop_monitoring()
+    
     async def get_new_entries(self) -> List[Dict]:
         """
         Get new log entries since last call (required interface method)

cursorflow/log_sources/ssh_remote.py

@@ -165,6 +165,10 @@ class SSHRemoteLogSource:
         """Connect to SSH log sources - compatibility method for log_collector"""
         return await self.start_monitoring()
     
+    async def disconnect(self):
+        """Disconnect from SSH log sources - compatibility method for log_collector"""
+        return await self.stop_monitoring()
+    
     async def get_new_entries(self) -> List[Dict]:
         """
         Get new log entries since last call (required interface method)

cursorflow/rules/cursorflow-usage.mdc

@@ -225,74 +225,69 @@ print(f"Performance metrics: {screenshot_data['performance_data']}")
 # Playwright trace available at: .cursorflow/artifacts/traces/session.zip
 ```
 
-## 🚀 **CursorFlow CLI Usage (v2.1.4)**
+## 🚀 **CursorFlow CLI Usage**
 
 ### **Basic Testing:**
 ```bash
-# Test any URL with comprehensive data capture
-cursorflow test --base-url http://localhost:3000 --path "/dashboard"
-
-# Test with custom actions
-cursorflow test \
-  --base-url http://localhost:3000 \
-  --actions '[
-    {"navigate": "/page"},
-    {"wait_for": "#element"},
-    {"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
-      }
-    }}
-  ]'
+# Simple page capture
+cursorflow test --base-url http://localhost:3000 --path /dashboard
+
+# Inline actions (no JSON needed)
+cursorflow test --base-url http://localhost:3000 \
+  --path /messages \
+  --wait-for ".message-item" \
+  --wait 2 \
+  --hover ".message-item:first-child" \
+  --click ".message-item:first-child" \
+  --screenshot "result" \
+  --show-console \
+  --open-trace
+
+# Custom actions with JSON
+cursorflow test --base-url http://localhost:3000 --actions '[
+  {"navigate": "/page"},
+  {"hover": ".menu"},
+  {"click": "#button"},
+  {"screenshot": "result"}
+]'
+```
 
-# 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)
+### **All CLI Commands:**
+```bash
+cursorflow test              # Test UI with comprehensive data capture
+cursorflow rerun             # Re-run last test
+cursorflow inspect           # Quick element inspection
+cursorflow count             # Count matching elements
+cursorflow timeline          # View event timeline
+cursorflow sessions          # Manage saved sessions
+cursorflow cleanup           # Clean artifacts (use --yes for autonomous)
+cursorflow install-rules     # Install Cursor rules (use --yes)
 ```
 
-### **Available CLI Commands:**
+### **Inline Action Flags:**
 ```bash
-cursorflow test              # Execute comprehensive UI test
-cursorflow compare-mockup    # Visual mockup comparison
-cursorflow iterate-mockup    # Iterative mockup matching
-cursorflow install-rules     # Install Cursor AI rules
-cursorflow update           # Update CursorFlow and dependencies
-cursorflow --help           # Show all commands and options
+--click ".selector"              # Click element
+--hover ".selector"              # Hover element
+--fill "#input=value"            # Fill form field
+--wait 2                         # Wait seconds
+--wait-for ".selector"           # Wait for element
+--wait-for-network-idle          # Wait for network idle
+--screenshot "name"              # Capture screenshot
+--show-console                   # Show console errors
+--open-trace                     # Auto-open Playwright trace
+--save-session "name"            # Save browser state
+--use-session "name"             # Restore browser state
 ```
 
-## Available Actions
-
-| Action | Syntax | Purpose |
-|--------|--------|---------|
-| `navigate` | `{"navigate": "/path"}` | Go to URL or path |
-| `click` | `{"click": "#selector"}` | Click element |
-| `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 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 |
+### **Available Actions (94+ via Pass-Through):**
+
+CursorFlow passes actions directly to Playwright - ANY Page method works:
+- `click`, `dblclick`, `hover`, `tap`, `press`
+- `fill`, `type`, `check`, `uncheck`, `select_option`
+- `focus`, `blur`, `drag_and_drop`
+- `wait_for_selector`, `wait_for_load_state`, `wait_for_timeout`
+- `goto`, `reload`, `evaluate`, `route`
+- And 80+ more: https://playwright.dev/python/docs/api/class-page
 
 ## Common Usage Patterns
 

{cursorflow-2.2.5.dist-info → cursorflow-2.2.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.2.5
+Version: 2.2.6
 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
@@ -140,7 +140,7 @@ cursorflow cleanup --all
 cursorflow cleanup --all --dry-run
 ```
 
-**See:** [Artifact Cleanup Guide](docs/user/ARTIFACT_CLEANUP_GUIDE.md)
+**See:** [Complete Usage Guide](docs/user/USAGE_GUIDE.md#artifact-management)
 
 ---
 

{cursorflow-2.2.5.dist-info → cursorflow-2.2.6.dist-info}/RECORD

@@ -1,38 +1,38 @@
-cursorflow/__init__.py,sha256=oM_cHtshPNDQ881zI8Z96rpIpWLCe5p6zuJK8N75VcA,2763
+cursorflow/__init__.py,sha256=j0MIwqCJf-WXoJkccyHFTM2sRiL2KSeeRx8dfLiJA0I,2763
 cursorflow/auto_init.py,sha256=dXQaXXiXe4wkUP-jd8fcJ5fYVt7ASdTb47b7SzXymOM,6122
 cursorflow/auto_updater.py,sha256=oQ12TIMZ6Cm3HF-x9iRWFtvOLkRh-JWPqitS69-4roE,7851
-cursorflow/cli.py,sha256=t3acnfJSdc4tWCzraioR-JDMgxU19IZ3pY6IZvB7e18,50329
+cursorflow/cli.py,sha256=JmT0uw5lrZhUhN_MOkUtkGScPSYw7PzkQKT2e2In24o,50347
 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=GLAdXP4JiMm27cNjpF_LyB8xV82Mo4_ZH56AC7hYpSs,147031
+cursorflow/core/browser_controller.py,sha256=PuODrTefj3fH1FPuinvXmCcRfjLhWL9yWyWkmJgNd70,147220
 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=oPe5R_m3V0DWy0FZcb0TL0rPDdz0KXw7KDcdR3Eg2Xs,45588
+cursorflow/core/cursorflow.py,sha256=OH-QmS8B8dO3RZag5ewqik0TEmVIdnyFYUJF4btzMo4,46375
 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
 cursorflow/core/file_change_monitor.py,sha256=tl_ZdsGW8LZBTImniD-lqaGgNb9dYjlDsP2XmevE0xk,21258
 cursorflow/core/hmr_detector.py,sha256=IrGYhXIeTBukffRXF74SW45cB_Im0cmq8RxxjtSz-2w,17431
-cursorflow/core/log_collector.py,sha256=vZ2Slm6C_OOi68xROWpXPSZqzzQAWK0sk5xEybGlA4w,14217
+cursorflow/core/log_collector.py,sha256=5ZoPlTyV1-1Q5Wn7NmW4aQK211i5fjrXQt69osVRSD0,14427
 cursorflow/core/log_monitor.py,sha256=pONMu_JHEnT0T62OA5KRZ4nClzKgNpifPyrfN5w_RM8,6704
 cursorflow/core/mockup_comparator.py,sha256=VLfEEaTgbcY0oTb-bhBD2uTbXGjbnOV7LXNVvXpWMrM,64695
 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=IEUslfRLwp19J4upMAnKNY9aoVl7zeIrrGbS-qQfyEw,8154
-cursorflow/log_sources/ssh_remote.py,sha256=kZRpLpiO7cLd67wlCiTvz4Prwx1_Vu3ytB5KHzOUFxc,8220
+cursorflow/log_sources/local_file.py,sha256=GVnhsaifIdc41twXwbxRM9-fBeRDsknDpk5IEGulnhQ,8318
+cursorflow/log_sources/ssh_remote.py,sha256=_Kwh0bhRpKgq-0c98oaX2hN6h9cT-wCHlqY5NiWVCoY,8388
 cursorflow/rules/__init__.py,sha256=gPcA-IkhXj03sl7cvZV0wwo7CtEkcyuKs4y0F5oQbqE,458
 cursorflow/rules/cursorflow-installation.mdc,sha256=D55pzzDPAVVbE3gAtKPUGoT-2fvB-FI2l6yrTdzUIEo,10208
-cursorflow/rules/cursorflow-usage.mdc,sha256=hCbA9koCtRoeLOkB-PXmLlGzsag_15RuOveOE_R4JZ0,21628
-cursorflow-2.2.5.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-2.2.5.dist-info/METADATA,sha256=a3FTj3fVs3k0pGEwfbKUo_MhWHYi8l9osy5oQc2W7mE,14520
-cursorflow-2.2.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-2.2.5.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-2.2.5.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-2.2.5.dist-info/RECORD,,
+cursorflow/rules/cursorflow-usage.mdc,sha256=kyRk9SaqkjjT6FRyMpEwzJ-KySpxCxAEQAmtxldWOPY,21325
+cursorflow-2.2.6.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.2.6.dist-info/METADATA,sha256=OQVM0yPYW53WhTXRw_ZyzwIeF-5vl5zJQHgDgjPVHAQ,14527
+cursorflow-2.2.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.2.6.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.2.6.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.2.6.dist-info/RECORD,,