cursorflow 2.0.4__py3-none-any.whl → 2.1.0__py3-none-any.whl

cursorflow-2.1.0.dist-info/METADATA

@@ -0,0 +1,350 @@
+Metadata-Version: 2.4
+Name: cursorflow
+Version: 2.1.0
+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
+Project-URL: Homepage, https://github.com/haley-marketing-group/cursorflow
+Project-URL: Documentation, https://cursorflow.readthedocs.io
+Project-URL: Repository, https://github.com/haley-marketing-group/cursorflow
+Keywords: ui-testing,automation,cursor,ai,web-testing,css-iteration,hot-reload,hmr,element-intelligence,page-analysis,error-context
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: paramiko>=3.3.1
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: asyncio-mqtt>=0.11.1
+Requires-Dist: click>=8.1.7
+Requires-Dist: rich>=13.6.0
+Requires-Dist: jinja2>=3.1.2
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: watchdog>=3.0.0
+Requires-Dist: docker>=6.1.3
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: websockets>=11.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.1; extra == "dev"
+Requires-Dist: black>=23.9.1; extra == "dev"
+Requires-Dist: flake8>=6.1.0; extra == "dev"
+Requires-Dist: mypy>=1.6.1; extra == "dev"
+Dynamic: license-file
+
+# CursorFlow
+
+**The measurement tool for web testing - we capture reality, not fiction**
+
+CursorFlow is a pure data collection engine that captures comprehensive web application intelligence. Unlike simulation tools that let you control reality, CursorFlow measures actual reality - giving you complete trust in your test results.
+
+## 🎯 The CursorFlow Philosophy
+
+### **📊 We Collect Reality, Not Fiction**
+
+**Other tools are simulation tools** - they let you control reality:
+- Mock network responses
+- Simulate user interactions  
+- Create test environments
+
+**CursorFlow is a measurement tool** - we capture reality as-is:
+- Real API response times
+- Actual network failures
+- Genuine browser behavior
+- Complete page intelligence
+
+### **🔬 Pure Observation Principle**
+
+**CursorFlow is like a scientific instrument:**
+- **Microscopes** don't create the cells they observe
+- **Telescopes** don't generate the stars they capture  
+- **CursorFlow** doesn't mock the web it measures
+
+When CursorFlow reports `"average_response_time": 416.58ms`, you can tell stakeholders: **"This is what actually happened"** - not "this is what happened in our test simulation."
+
+### **🌟 The Trust Factor**
+
+**Complete Reliability:** Every data point reflects real application behavior
+- No mocked responses hiding slow APIs
+- No simulated interactions missing real edge cases
+- No test environments different from production
+
+**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.
+
+## 🚀 Complete Page Intelligence
+
+Every screenshot captures everything your AI needs to make intelligent decisions:
+
+### **📊 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
+
+### **🔄 Hot Reload Intelligence**
+- **Framework auto-detection** (Vite, Webpack, Next.js, Parcel, Laravel Mix)
+- **Perfect timing** for CSS change detection
+- **HMR event correlation** for understanding change impact
+- **Persistent sessions** that survive code changes
+
+### **🎯 Enhanced Screenshot Options**
+```python
+# Clip to specific components
+{"screenshot": {"name": "header", "options": {"clip": {"selector": "#header"}}}}
+
+# Hide sensitive information
+{"screenshot": {"name": "profile", "options": {"mask": [".user-email", ".api-key"]}}}
+
+# Full page with quality control
+{"screenshot": {"name": "page", "options": {"full_page": True, "quality": 90}}}
+```
+
+### **📱 Parallel Viewport Testing**
+```python
+# Test across multiple viewports simultaneously
+await flow.test_responsive([
+    {"width": 375, "height": 667, "name": "mobile"},
+    {"width": 768, "height": 1024, "name": "tablet"},
+    {"width": 1440, "height": 900, "name": "desktop"}
+], [
+    {"navigate": "/dashboard"},
+    {"screenshot": "responsive-test"}
+])
+```
+
+### **🤖 AI-First Design**
+All data structured for AI consumption:
+- Consistent JSON format across all features
+- **Multi-selector element identification** for robust automation
+- **Accessibility-aware** element analysis  
+- Error correlation with **smart screenshot deduplication**
+- Performance insights with **reliability metadata**
+
+## 🚀 Quick Start
+
+```bash
+# Install CursorFlow
+pip install cursorflow
+
+# Test real application behavior
+cursorflow test --base-url http://localhost:3000 --path "/dashboard"
+
+# Get complete intelligence with custom actions
+cursorflow test --base-url http://localhost:3000 --actions '[
+  {"navigate": "/login"},
+  {"fill": {"selector": "#email", "value": "test@example.com"}},
+  {"click": "#login-btn"},
+  {"screenshot": {"name": "result", "options": {"mask": [".sensitive-data"]}}}
+]'
+```
+
+## 💻 Python API Examples
+
+### **Complete Page Intelligence**
+```python
+from cursorflow import CursorFlow
+
+async def capture_reality():
+    flow = CursorFlow("http://localhost:3000", {"source": "local", "paths": ["logs/app.log"]})
+    
+    # Capture everything
+    results = await flow.execute_and_collect([
+        {"navigate": "/dashboard"},
+        {"screenshot": "complete-analysis"}
+    ])
+    
+    # Access comprehensive data
+    screenshot = results['artifacts']['screenshots'][0]
+    print(f"Real load time: {screenshot['performance_data']['page_load_time']}ms")
+    print(f"Actual memory usage: {screenshot['performance_data']['memory_usage_mb']}MB")
+    print(f"Elements found: {len(screenshot['dom_analysis']['elements'])}")
+```
+
+### **Enhanced Screenshot Options**
+```python
+# Component-focused testing
+await flow.execute_and_collect([
+    {"navigate": "/components"},
+    {"screenshot": {
+        "name": "button-component",
+        "options": {"clip": {"selector": ".component-demo"}}
+    }}
+])
+
+# Privacy-aware testing
+await flow.execute_and_collect([
+    {"navigate": "/admin"},
+    {"screenshot": {
+        "name": "admin-safe",
+        "options": {
+            "full_page": True,
+            "mask": [".api-key", ".user-data", ".sensitive-info"]
+        }
+    }}
+])
+```
+
+### **Hot Reload Intelligence**
+```python
+# Perfect CSS iteration timing
+async def hmr_workflow():
+    flow = CursorFlow("http://localhost:5173", {"headless": False})
+    
+    # Auto-detect and monitor HMR
+    await flow.browser.start_hmr_monitoring()
+    
+    # Baseline capture
+    await flow.execute_and_collect([{"screenshot": "baseline"}])
+    
+    # Wait for real CSS changes with perfect timing
+    hmr_event = await flow.browser.wait_for_css_update()
+    print(f"🔥 {hmr_event['framework']} detected real change!")
+    
+    # Capture immediately after actual change
+    await flow.execute_and_collect([{"screenshot": "updated"}])
+```
+
+### **Parallel Viewport Testing**
+```python
+# Test responsive design across multiple viewports
+async def test_responsive_design():
+    flow = CursorFlow("http://localhost:3000", {"source": "local", "paths": ["logs/app.log"]})
+    
+    # Define viewports
+    viewports = [
+        {"width": 375, "height": 667, "name": "mobile"},
+        {"width": 768, "height": 1024, "name": "tablet"},
+        {"width": 1440, "height": 900, "name": "desktop"}
+    ]
+    
+    # Test same actions across all viewports
+    results = await flow.test_responsive(viewports, [
+        {"navigate": "/dashboard"},
+        {"click": "#menu-toggle"},
+        {"screenshot": {"name": "navigation", "options": {"clip": {"selector": "#nav"}}}}
+    ])
+    
+    # Analyze responsive behavior
+    print(f"Tested {results['execution_summary']['successful_viewports']} viewports")
+    print(f"Fastest: {results['responsive_analysis']['performance_analysis']['fastest_viewport']}")
+```
+
+## 🔧 CLI Commands
+
+### **Universal Testing**
+```bash
+# Simple page test with complete intelligence
+cursorflow test --base-url http://localhost:3000 --path "/dashboard"
+
+# Responsive testing across multiple viewports
+cursorflow test --base-url http://localhost:3000 --path "/dashboard" --responsive
+
+# Complex interaction testing
+cursorflow test --base-url http://localhost:3000 --actions '[
+  {"navigate": "/form"},
+  {"fill": {"selector": "#name", "value": "Test User"}},
+  {"click": "#submit"},
+  {"screenshot": {"name": "result", "options": {"clip": {"selector": ".result-area"}}}}
+]'
+
+# Responsive testing with custom actions
+cursorflow test --base-url http://localhost:3000 --responsive --actions '[
+  {"navigate": "/products"},
+  {"fill": {"selector": "#search", "value": "laptop"}},
+  {"screenshot": "search-results"}
+]'
+
+# Custom output location
+cursorflow test --base-url http://localhost:3000 --path "/api" --output "api-test-results.json"
+```
+
+### **Design Comparison**
+```bash
+# Compare mockup to implementation
+cursorflow compare-mockup https://mockup.com/design \
+  --base-url http://localhost:3000 \
+  --mockup-actions '[{"navigate": "/"}]' \
+  --implementation-actions '[{"navigate": "/dashboard"}]'
+
+# CSS iteration with HMR intelligence
+cursorflow iterate-mockup https://mockup.com/design \
+  --base-url http://localhost:5173 \
+  --css-improvements '[
+    {"name": "fix-spacing", "css": ".container { gap: 2rem; }"}
+  ]'
+```
+
+### **AI Integration**
+```bash
+# Install Cursor AI rules
+cursorflow install-rules
+
+# Update to latest version and rules
+cursorflow update
+```
+
+## 🧠 Why This Matters
+
+### **For Job Board v4 Testing:**
+✅ **Real API response times** from `/ajax_rq.smpl?fn=gjapi_typeahead`  
+✅ **Actual network failures** when they occur  
+✅ **Real browser console errors** from production code  
+✅ **Genuine performance metrics** under real load  
+
+❌ **With mocking:** You'd never know the typeahead is slow in production!
+
+### **For Any Web Application:**
+- **Trust your test results** - they reflect actual behavior
+- **Find real performance bottlenecks** - no artificial speed boosts
+- **Discover actual edge cases** - no simulation gaps
+- **Debug genuine issues** - real errors, real timing, real context
+
+## 🌟 Framework Support
+
+**Universal Compatibility:**
+- Works with **any web application** regardless of technology
+- **Framework-agnostic** core operations  
+- **Smart adaptation** to different environments
+
+**HMR Auto-Detection:**
+- ✅ **Vite** (port 5173)
+- ✅ **Webpack Dev Server** (port 3000)  
+- ✅ **Next.js** (port 3000)
+- ✅ **Parcel** (port 1234)
+- ✅ **Laravel Mix** (port 3000)
+
+## 📖 Documentation
+
+- **[Complete User Manual](docs/USER_MANUAL.md)** - Full feature guide
+- **[Examples](examples/)** - Practical usage examples  
+- **[API Reference](docs/api/)** - Complete Python API documentation
+
+## 🎪 The CursorFlow Advantage
+
+### **Other Tools Say:**
+*"We let you mock and simulate"*
+
+### **CursorFlow Says:**  
+*"We tell you the truth"*
+
+**When you need to understand reality, choose the measurement tool - not the simulation tool.**
+
+---
+
+**Complete page intelligence • Real behavior measurement • AI-first design • Pure observation**

{cursorflow-2.0.4.dist-info → cursorflow-2.1.0.dist-info}/RECORD

@@ -1,15 +1,15 @@
-cursorflow/__init__.py,sha256=lP0RXTBbo-BTIT7w4GezlQzHasC46QXTOwDW1BUZqMg,2476
+cursorflow/__init__.py,sha256=-_zrc4ezhO8RMbCXUHhmlD-4dw-dKJVD25P6Enio6Sw,2763
 cursorflow/auto_updater.py,sha256=oQ12TIMZ6Cm3HF-x9iRWFtvOLkRh-JWPqitS69-4roE,7851
-cursorflow/cli.py,sha256=KD2yzVQvfoKqGgAQYp3TtWjRCuxH1EOtD-uA8ameDZ0,25388
-cursorflow/install_cursorflow_rules.py,sha256=2HE7PQgSDPz2BLWBhdxRXTHtk8YHLITjq5GWbKD7EZs,11792
+cursorflow/cli.py,sha256=ffsBKsQc95NfJOVuIn4-Arnx8LZU9fvzAHYy4_f_aSU,27250
+cursorflow/install_cursorflow_rules.py,sha256=3kSHeui119KMCFTL8gELkirg0QOKr5e-P011gmCzfF0,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=OII52LBgN97-G-6mPCiqbFGbHnU9KtHaYB0qeylqo2U,125963
-cursorflow/core/browser_engine.py,sha256=Glq8U_bXRkO2Yal0nku7Z2wKwOftY4So2XN4oy56WLo,13732
+cursorflow/core/browser_controller.py,sha256=uuapNgf93QY5tl49zVFbmE1TqL41vASxOpWniE3szMg,131059
+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
-cursorflow/core/cursorflow.py,sha256=GohWXvCLTsIIxI2UBRkFPM3yptbPNw4wI1vxKRPPMd0,31816
+cursorflow/core/cursorflow.py,sha256=sLML1rP-caLY-r_llkq6rb4TGL8ZGb4pBwN5pbPQICY,43919
 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
@@ -26,9 +26,9 @@ cursorflow/log_sources/ssh_remote.py,sha256=zSnX8mpa5G86UDWEm3_FqYwo1PjBW67C1LPk
 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.0.4.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-2.0.4.dist-info/METADATA,sha256=PcY-kjD3pWWiGFR1HweY3RHs9_pHr9J63JMlzVdmJwA,10656
-cursorflow-2.0.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-2.0.4.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-2.0.4.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-2.0.4.dist-info/RECORD,,
+cursorflow-2.1.0.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.1.0.dist-info/METADATA,sha256=O2ENij5kL47HqJJug3_MS4vuovWb51ZbgW9QrwlyScs,12300
+cursorflow-2.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.1.0.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.1.0.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.1.0.dist-info/RECORD,,

cursorflow-2.0.4.dist-info/METADATA

@@ -1,293 +0,0 @@
-Metadata-Version: 2.4
-Name: cursorflow
-Version: 2.0.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
-Project-URL: Homepage, https://github.com/haley-marketing-group/cursorflow
-Project-URL: Documentation, https://cursorflow.readthedocs.io
-Project-URL: Repository, https://github.com/haley-marketing-group/cursorflow
-Keywords: ui-testing,automation,cursor,ai,web-testing,css-iteration,hot-reload,hmr,element-intelligence,page-analysis,error-context
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Testing
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Framework :: AsyncIO
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: playwright>=1.40.0
-Requires-Dist: paramiko>=3.3.1
-Requires-Dist: pyyaml>=6.0.1
-Requires-Dist: asyncio-mqtt>=0.11.1
-Requires-Dist: click>=8.1.7
-Requires-Dist: rich>=13.6.0
-Requires-Dist: jinja2>=3.1.2
-Requires-Dist: python-dateutil>=2.8.2
-Requires-Dist: watchdog>=3.0.0
-Requires-Dist: docker>=6.1.3
-Requires-Dist: pillow>=10.0.0
-Requires-Dist: numpy>=1.24.0
-Requires-Dist: websockets>=11.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.4.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.21.1; extra == "dev"
-Requires-Dist: black>=23.9.1; extra == "dev"
-Requires-Dist: flake8>=6.1.0; extra == "dev"
-Requires-Dist: mypy>=1.6.1; extra == "dev"
-Dynamic: license-file
-
-# CursorFlow
-
-**Complete page intelligence for AI-driven development**
-
-CursorFlow captures comprehensive data from web applications - DOM structure, CSS properties, network activity, console logs, and performance metrics - enabling AI agents like Cursor to make intelligent decisions about UI improvements and debugging.
-
-## 🎯 What CursorFlow Does
-
-**Data Collection, Not Analysis** - We gather structured data, AI makes the decisions.
-
-### **📊 Complete Page Intelligence**
-Every screenshot captures everything:
-- **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
-- **Fonts**: Loading status, performance, and usage analysis
-- **Animations**: Active animations and transitions tracking
-- **Resources**: Complete resource loading analysis
-- **Storage**: localStorage, sessionStorage, cookies, IndexedDB state
-
-### **🔄 Rapid Iteration Support**
-- **Hot Reload Intelligence** with framework auto-detection (Vite, Webpack, Next.js, Parcel, Laravel Mix)
-- **Mockup comparison** with enhanced DOM and CSS analysis
-- **Hot reload integration** for instant, perfectly-timed CSS testing
-- **Persistent sessions** that survive code changes
-- **Universal framework support** (React, Vue, PHP, Perl, anything)
-
-### **🤖 AI-First Design**
-All data structured for AI consumption:
-- Consistent JSON format across all features
-- **Multi-selector element identification** for robust automation
-- **Accessibility-aware** element analysis
-- Error correlation with **smart screenshot deduplication**
-- Performance insights with **reliability metadata**
-- **HMR event correlation** for CSS change tracking
-
-## 🚀 Quick Start
-
-```bash
-# Install CursorFlow
-pip install cursorflow
-
-# Test with complete intelligence
-cursorflow test --base-url http://localhost:3000 --actions '[
-  {"navigate": "/dashboard"},
-  {"wait_for": "#main-content"},
-  {"screenshot": "dashboard-loaded"}
-]'
-
-# HMR-powered CSS iteration
-cursorflow iterate-mockup https://mockup.com/design \
-  --base-url http://localhost:5173 \
-  --css-improvements '[
-    {"name": "fix-spacing", "css": ".container { gap: 2rem; }"}
-  ]'
-```
-
-## 💻 Usage Examples
-
-### **Hot Reload Intelligence**
-```python
-from cursorflow import CursorFlow
-
-async def hmr_workflow():
-    flow = CursorFlow("http://localhost:5173", {"headless": False})
-    
-    # Start HMR monitoring (auto-detects Vite/Webpack/Next.js)
-    await flow.browser.start_hmr_monitoring()
-    
-    # Take baseline
-    await flow.execute_and_collect([
-        {"navigate": "/app"},
-        {"screenshot": "baseline"}
-    ])
-    
-    # Wait for CSS changes with perfect timing
-    hmr_event = await flow.browser.wait_for_css_update()
-    print(f"🔥 {hmr_event['framework']} CSS update detected!")
-    
-    # Capture immediately after change
-    await flow.execute_and_collect([
-        {"screenshot": "updated"}
-    ])
-```
-
-### **Advanced Element Analysis**
-```python
-# Get comprehensive element data
-results = await flow.execute_and_collect([
-    {"navigate": "/form"},
-    {"screenshot": "form-analysis"}
-])
-
-# Access enhanced element data
-for element in results['artifacts']['screenshots'][0]['dom_analysis']['elements']:
-    print(f"Element: {element['selector']}")
-    print(f"  7 Selectors: {list(element['selectors'].keys())}")
-    print(f"  Accessible: {element['accessibility']['role']}")
-    print(f"  Interactive: {element['accessibility']['interactive']}")
-    print(f"  Visible: {element['visual_context']['visibility']['is_visible']}")
-```
-
-### **Comprehensive Page Intelligence**
-```python
-# Get complete page analysis
-screenshot = results['artifacts']['screenshots'][0]
-
-# Complete Intelligence
-print(f"Fonts loaded: {screenshot['font_status']['loadedFonts']}")
-print(f"Animations running: {screenshot['animation_status']['runningAnimations']}")  
-print(f"Resources: {screenshot['resource_status']['totalResources']}")
-print(f"Storage items: {screenshot['storage_status']['localStorage']['itemCount']}")
-```
-
-### **Smart Error Diagnostics**
-```python
-# Enhanced error context with deduplication
-error_context = await flow.browser.capture_interaction_error_context(
-    action_description="Submit form",
-    error_details={"type": "validation_error"}
-)
-
-print(f"Screenshot: {error_context['screenshot_info']['path']}")
-print(f"Reused: {error_context['screenshot_info']['is_reused']}")  # Smart deduplication
-print(f"Context: {len(error_context['recent_actions'])} recent actions")
-```
-
-## 🔧 CLI Commands
-
-### **Universal Testing with Complete Intelligence**
-```bash
-# Simple page test with full intelligence
-cursorflow test --base-url http://localhost:3000 --path "/dashboard"
-
-# Complex interaction test
-cursorflow test --base-url http://localhost:3000 --actions '[
-  {"navigate": "/login"},
-  {"fill": {"selector": "#email", "value": "test@example.com"}},
-  {"click": "#login-btn"},
-  {"wait_for": ".dashboard"},
-  {"screenshot": "logged-in"}
-]'
-```
-
-### **HMR-Powered CSS Iteration**
-```bash
-# Perfect CSS iteration with HMR intelligence
-cursorflow iterate-mockup https://mockup.com/design \
-  --base-url http://localhost:5173 \
-  --css-improvements '[
-    {"name": "improve-spacing", "css": ".container { gap: 2rem; }"},
-    {"name": "enhance-colors", "css": ".button { background: #007bff; }"}
-  ]'
-```
-
-### **Enhanced Design Comparison**
-```bash
-# Compare with comprehensive intelligence
-cursorflow compare-mockup https://mockup.com/design \
-  --base-url http://localhost:3000 \
-  --mockup-actions '[{"navigate": "/"}]' \
-  --implementation-actions '[{"navigate": "/dashboard"}]'
-```
-
-## 🧠 AI Integration
-
-### **Cursor Rules (Auto-Install)**
-```bash
-# Install AI assistance rules
-cursorflow install-rules
-```
-
-CursorFlow includes comprehensive rules that teach Cursor:
-- **When to use HMR intelligence** for CSS iteration
-- **How to analyze multi-selector element data**
-- **Best practices for comprehensive page analysis**
-- **Error debugging with smart context collection**
-
-### **Structured Data for AI**
-Every CursorFlow operation returns **perfectly structured JSON** optimized for AI analysis:
-
-```json
-{
-  "artifacts": {
-    "screenshots": [{
-      "path": ".cursorflow/artifacts/screenshots/dashboard_123.png",
-      "dom_analysis": {
-        "elements": [...],  // 7 selectors + accessibility per element
-        "pageStructure": {...},  // Enhanced page analysis
-        "analysisVersion": "2.0"  // Version tracking
-      },
-      "font_status": {...},      // Font loading intelligence
-      "animation_status": {...}, // Animation tracking
-      "resource_status": {...},  // Resource analysis
-      "storage_status": {...},   // Storage state
-      "hmr_status": {...}        // HMR event data
-    }]
-  }
-}
-```
-
-## 🌟 Framework Support
-
-**HMR Auto-Detection:**
-- ✅ **Vite** (port 5173, WebSocket `/__vite_hmr`)
-- ✅ **Webpack Dev Server** (port 3000, WebSocket `/sockjs-node`)
-- ✅ **Next.js** (port 3000, WebSocket `/_next/webpack-hmr`)
-- ✅ **Parcel** (port 1234, WebSocket `/hmr`)
-- ✅ **Laravel Mix** (port 3000, WebSocket `/browser-sync/socket.io`)
-
-**Universal Compatibility:**
-- Works with **any web application** regardless of framework
-- **Framework-agnostic** core operations
-- **Smart adaptation** to different development environments
-
-## 📖 Documentation
-
-- **[Complete User Manual](docs/USER_MANUAL.md)** - Full feature guide
-- **[Examples](examples/)** - Practical usage examples
-- **[API Reference](docs/api/)** - Complete Python API documentation
-
-## 🚀 Why CursorFlow?
-
-### **For Developers:**
-- **Faster CSS iteration** with HMR precision timing
-- **Complete element intelligence** with multi-selector strategies
-- **Full page visibility** with comprehensive analysis
-- **Smart error debugging** with rich context collection
-
-### **For AI Agents:**
-- **Perfect structured data** for intelligent decision making
-- **Multi-selector reliability** for robust automation
-- **Accessibility awareness** for inclusive development
-- **HMR correlation** for understanding change impact
-
-### **For Teams:**
-- **Framework agnostic** - works with any web technology
-- **Production ready** - handles real-world complexity
-- **Comprehensive testing** - covers all aspects of web apps
-- **AI-first design** - built for autonomous development
-
----
-
-**Complete page intelligence for AI-driven development with CursorFlow**
-
-*Hot reload precision • Advanced element analysis • Smart error diagnostics • Comprehensive page intelligence*