cursorflow 1.3.7__py3-none-any.whl → 2.0.0__py3-none-any.whl

cursorflow-2.0.0.dist-info/METADATA

@@ -0,0 +1,293 @@
+Metadata-Version: 2.4
+Name: cursorflow
+Version: 2.0.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
+
+**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*

{cursorflow-1.3.7.dist-info → cursorflow-2.0.0.dist-info}/RECORD

@@ -5,27 +5,30 @@ cursorflow/install_cursorflow_rules.py,sha256=ny4c-S1O-V2sITunZO2kk6sCf1yec42UJO
 cursorflow/updater.py,sha256=pvbSZgg6hgWZBE5AAUPppS5Yzv0yNMp2X_CL2GALg_w,18783
 cursorflow/core/agent.py,sha256=f3lecgEzDRDdGTVccAtorpLGfNJJ49bbsQAmgr0vNGg,10136
 cursorflow/core/auth_handler.py,sha256=oRafO6ZdxoHryBIvHsrNV8TECed4GXpJsdEiH0KdPPk,17149
-cursorflow/core/browser_controller.py,sha256=fqbCAXyPXY8_k1gNNwETjNVVPfLSNdGLOcGvpHUkMV4,59333
+cursorflow/core/browser_controller.py,sha256=OII52LBgN97-G-6mPCiqbFGbHnU9KtHaYB0qeylqo2U,125963
 cursorflow/core/browser_engine.py,sha256=Glq8U_bXRkO2Yal0nku7Z2wKwOftY4So2XN4oy56WLo,13732
 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/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_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=Hn3hDQjAqgNBQN8b5AbC6IQAzgY_ekLgePwDuq9wBlA,7101
 cursorflow/log_sources/ssh_remote.py,sha256=zSnX8mpa5G86UDWEm3_FqYwo1PjBW67C1LPkJ5Ta_ho,7482
 cursorflow/rules/__init__.py,sha256=gPcA-IkhXj03sl7cvZV0wwo7CtEkcyuKs4y0F5oQbqE,458
 cursorflow/rules/cursorflow-installation.mdc,sha256=Nnu7PuP5nGD6hGAV_x2SX5Y2_uPz3oNA5XUjNJBFC1M,6985
 cursorflow/rules/cursorflow-usage.mdc,sha256=Zv0TWuo7S3iJHq8R6oBaHRI3V6h-T81pdb7vi-b8NoU,14157
-cursorflow-1.3.7.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-1.3.7.dist-info/METADATA,sha256=ViqtojUrMloBzdc_FQgTysm-OJkeLVnyw3rRBO7AD-Y,7716
-cursorflow-1.3.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-1.3.7.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-1.3.7.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-1.3.7.dist-info/RECORD,,
+cursorflow-2.0.0.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.0.0.dist-info/METADATA,sha256=umhLvqBVKOkvvJ0as3gfKDGmd-KW2POSW8c1nHovBAk,10656
+cursorflow-2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.0.0.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.0.0.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.0.0.dist-info/RECORD,,

cursorflow-1.3.7.dist-info/METADATA

@@ -1,249 +0,0 @@
-Metadata-Version: 2.4
-Name: cursorflow
-Version: 1.3.7
-Summary: Complete page intelligence for AI-driven development - captures DOM, network, console, and performance data
-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
-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
-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 exact CSS properties
-- **Network**: All requests, responses, and timing
-- **Console**: All logs, errors, and warnings  
-- **Performance**: Load times, memory usage, metrics
-- **Visual**: Screenshots and pixel-perfect comparisons
-
-### **🔄 Rapid Iteration Support**
-- **Mockup comparison** with pixel-level analysis
-- **Hot reload integration** for instant 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
-- Element-level CSS properties for precise modifications
-- Error correlation with timing data
-- Performance insights with actionable metrics
-
-## 🚀 Quick Start
-
-```bash
-# Install
-pip install cursorflow
-
-# Test any page - captures everything automatically
-cursorflow test --base-url http://localhost:3000 --actions '[
-  {"navigate": "/dashboard"},
-  {"wait_for": "#main-content"},
-  {"screenshot": "dashboard-loaded"}
-]'
-
-# Compare mockup to implementation
-cursorflow compare-mockup https://mockup.com/design --base-url http://localhost:3000
-```
-
-## 💻 Usage Examples
-
-### **Basic Testing**
-```python
-from cursorflow import CursorFlow
-
-flow = CursorFlow(base_url="http://localhost:3000")
-
-# Every screenshot includes complete page data
-results = await flow.execute_and_collect([
-    {"navigate": "/dashboard"},
-    {"screenshot": "loaded"}  # Captures DOM, network, console, performance
-])
-
-# Access structured data for AI analysis
-screenshot = results['artifacts']['screenshots'][0]
-elements = screenshot['dom_analysis']['elements']  # All elements + CSS
-network = screenshot['network_data']               # All requests + timing
-console = screenshot['console_data']               # All logs + errors
-```
-
-### **Mockup Comparison**
-```python
-# Compare design to implementation with complete element data
-results = await flow.compare_mockup_to_implementation(
-    mockup_url="https://mockup.com/design",
-    implementation_url="http://localhost:3000/dashboard"
-)
-
-# AI gets exact differences and CSS properties for every element
-differences = results['layout_analysis']['element_differences']
-```
-
-### **CSS Iteration**
-```python
-# Test CSS changes with hot reload - no page refresh needed
-css_changes = [
-    {"name": "spacing", "css": ".container { gap: 2rem; }"},
-    {"name": "colors", "css": ".button { background: blue; }"}
-]
-
-results = await flow.css_iteration_persistent(
-    base_actions=[{"navigate": "/page"}],
-    css_changes=css_changes
-)
-```
-
-## 🔧 CLI Commands
-
-```bash
-# Test any page with custom actions
-cursorflow test --base-url http://localhost:3000 --actions '[
-  {"navigate": "/login"},
-  {"fill": {"selector": "#username", "value": "test@example.com"}},
-  {"fill": {"selector": "#password", "value": "password123"}},
-  {"click": "#login-button"},
-  {"wait_for": ".dashboard"},
-  {"screenshot": "logged-in"}
-]'
-
-# Simple page test (just navigate and screenshot)
-cursorflow test --base-url http://localhost:3000 --path "/dashboard"
-
-# Compare mockup to implementation
-cursorflow compare-mockup https://mockup.com/design \
-  --base-url http://localhost:3000 \
-  --viewports '[{"width": 1440, "height": 900, "name": "desktop"}]'
-
-# Iterate on CSS improvements
-cursorflow iterate-mockup https://mockup.com/design \
-  --base-url http://localhost:3000 \
-  --css-improvements '[
-    {"name": "spacing", "css": ".container { gap: 2rem; }"},
-    {"name": "colors", "css": ".button { background: blue; }"}
-  ]'
-```
-
-## 🌐 Universal Framework Support
-
-Works with any web technology:
-- **Modern**: React, Vue, Angular, Next.js, Svelte
-- **Traditional**: PHP, Django, Rails, Laravel
-- **Legacy**: Perl, mod_perl, OpenSAS, Classic ASP
-- **Any URL**: Local development, staging, production
-
-## 📊 What AI Gets
-
-### **Complete Element Data**
-```json
-{
-  "tagName": "button",
-  "textContent": "Save Changes",
-  "boundingBox": {"x": 100, "y": 200, "width": 120, "height": 40},
-  "computedStyles": {
-    "backgroundColor": "rgb(0, 123, 255)",
-    "fontSize": "14px",
-    "padding": "8px 16px",
-    "borderRadius": "4px"
-  }
-}
-```
-
-### **Network Activity**
-```json
-{
-  "network_summary": {
-    "total_requests": 23,
-    "failed_requests": 2,
-    "average_response_time": 145.5
-  },
-  "failed_requests": [
-    {"url": "/api/data", "status": 404, "timing": 1250}
-  ]
-}
-```
-
-### **Console Intelligence**
-```json
-{
-  "console_summary": {
-    "error_count": 1,
-    "warning_count": 2
-  },
-  "errors": [
-    {"text": "Cannot read property 'id' of undefined", "location": "app.js:42"}
-  ]
-}
-```
-
-## 📚 Documentation
-
-**[📖 Complete User Manual](docs/USER_MANUAL.md)** - Everything you need:
-- Installation and setup
-- All features and examples
-- CLI commands and Python API
-- Troubleshooting guide
-
-## 🎯 Perfect for AI Development
-
-CursorFlow is designed specifically for AI agents:
-- **Complete data collection** - AI gets full context
-- **Structured output** - Consistent JSON format
-- **No analysis** - We collect, AI decides
-- **Rapid iteration** - Fast feedback loops
-- **Universal compatibility** - Works with any web app
-
-## Installation
-
-```bash
-pip install cursorflow
-```
-
-Browser dependencies install automatically on first use.
-
----
-
-**CursorFlow: The data collection engine that powers AI-driven web development.** 🚀