cursorflow 1.2.0__tar.gz → 1.3.1__tar.gz

cursorflow-1.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 GeekWarrior Development
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cursorflow-1.3.1/MANIFEST.in

@@ -0,0 +1,64 @@
+# CursorFlow PyPI Package Manifest
+# Controls exactly what gets included in the published package
+
+# INCLUDE: Essential files for users
+include README.md
+include LICENSE
+include pyproject.toml
+include setup.py
+
+# INCLUDE: Core package code (automatically included by setuptools)
+recursive-include cursorflow *.py
+
+# INCLUDE: Essential examples for users
+include examples/react_example.py
+include examples/opensas_example.py
+include examples/mockup_comparison_example.py
+include examples/comprehensive_screenshot_example.py
+
+# INCLUDE: Single comprehensive user manual
+include docs/USER_MANUAL.md
+
+# EXCLUDE: Development and internal documentation
+exclude docs/README.md
+exclude docs/development/*
+exclude docs/product/*
+exclude docs/api/*
+exclude docs/examples/*
+
+# EXCLUDE: Development files and directories
+exclude .gitignore
+exclude .github/*
+exclude tests/*
+exclude scripts/*
+exclude venv/*
+exclude dist/*
+exclude build/*
+exclude *.egg-info/*
+exclude .pytest_cache/*
+exclude __pycache__/*
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+
+# EXCLUDE: Configuration and rules (internal use)
+exclude config/*
+exclude rules/*
+exclude install_cursorflow_rules.py
+exclude PERSISTENT_SESSION_SUMMARY.md
+
+# EXCLUDE: Artifacts and temporary files
+exclude artifacts/*
+exclude .cursorflow/*
+exclude *.log
+exclude *.tmp
+
+# EXCLUDE: IDE and editor files
+exclude .vscode/*
+exclude .idea/*
+exclude *.swp
+exclude *.swo
+exclude *~
+
+# EXCLUDE: OS files
+exclude .DS_Store
+exclude Thumbs.db

cursorflow-1.3.1/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.4
+Name: cursorflow
+Version: 1.3.1
+Summary: Complete page intelligence for AI-driven development - captures DOM, network, console, and performance data
+Author-email: GeekWarrior Development <support@cursorflow.dev>
+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
+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.** 🚀

cursorflow-1.3.1/README.md

@@ -0,0 +1,205 @@
+# 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.** 🚀