cursorflow 1.3.0__tar.gz → 1.3.1__tar.gz

{cursorflow-1.3.0 → cursorflow-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 1.3.0
+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
@@ -77,8 +77,12 @@ All data structured for AI consumption:
 # Install
 pip install cursorflow
 
-# Test any component - captures everything automatically
-cursorflow test dashboard --base-url http://localhost:3000
+# 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
@@ -134,14 +138,31 @@ results = await flow.css_iteration_persistent(
 ## 🔧 CLI Commands
 
 ```bash
-# Test component with complete data capture
-cursorflow test component --base-url http://localhost:3000
+# 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
+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
+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

{cursorflow-1.3.0 → cursorflow-1.3.1}/README.md

@@ -35,8 +35,12 @@ All data structured for AI consumption:
 # Install
 pip install cursorflow
 
-# Test any component - captures everything automatically
-cursorflow test dashboard --base-url http://localhost:3000
+# 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
@@ -92,14 +96,31 @@ results = await flow.css_iteration_persistent(
 ## 🔧 CLI Commands
 
 ```bash
-# Test component with complete data capture
-cursorflow test component --base-url http://localhost:3000
+# 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
+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
+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

{cursorflow-1.3.0 → cursorflow-1.3.1}/cursorflow/cli.py

@@ -26,11 +26,14 @@ def main():
     pass
 
 @main.command()
-@click.argument('test_name', required=False, default='ui-test')
-@click.option('--base-url', '-u', default='http://localhost:3000',
-              help='Base URL for testing')
+@click.option('--base-url', '-u', required=True,
+              help='Base URL for testing (e.g., http://localhost:3000)')
+@click.option('--path', '-p',
+              help='Simple path to navigate to (e.g., "/dashboard")')
 @click.option('--actions', '-a',
               help='JSON file with test actions, or inline JSON string')
+@click.option('--output', '-o',
+              help='Output file for results (auto-generated if not specified)')
 @click.option('--logs', '-l', 
               type=click.Choice(['local', 'ssh', 'docker', 'systemd']),
               default='local',
@@ -39,7 +42,11 @@ def main():
               help='Configuration file path')
 @click.option('--verbose', '-v', is_flag=True,
               help='Verbose output')
-def test(test_name, base_url, actions, logs, config, verbose):
+@click.option('--headless', is_flag=True, default=True,
+              help='Run browser in headless mode')
+@click.option('--timeout', type=int, default=30,
+              help='Timeout in seconds for actions')
+def test(base_url, path, actions, output, logs, config, verbose, headless, timeout):
     """Test UI flows and interactions with real-time log monitoring"""
     
     if verbose:
@@ -65,14 +72,22 @@ def test(test_name, base_url, actions, logs, config, verbose):
         except Exception as e:
             console.print(f"[red]❌ Failed to load actions: {e}[/red]")
             return
+    elif path:
+        # Simple path navigation
+        test_actions = [
+            {"navigate": path},
+            {"wait_for": "body"},
+            {"screenshot": "page_loaded"}
+        ]
+        console.print(f"📋 Using simple path navigation to [cyan]{path}[/cyan]")
     else:
-        # Default actions - just navigate and screenshot
+        # Default actions - just navigate to root and screenshot
         test_actions = [
             {"navigate": "/"},
             {"wait_for": "body"},
             {"screenshot": "baseline"}
         ]
-        console.print(f"📋 Using default actions (navigate + screenshot)")
+        console.print(f"📋 Using default actions (navigate to root + screenshot)")
     
     # Load configuration
     agent_config = {}
@@ -80,7 +95,8 @@ def test(test_name, base_url, actions, logs, config, verbose):
         with open(config, 'r') as f:
             agent_config = json.load(f)
     
-    console.print(f"🎯 Testing [bold]{test_name}[/bold] at [blue]{base_url}[/blue]")
+    test_description = path if path else "root page"
+    console.print(f"🎯 Testing [bold]{test_description}[/bold] at [blue]{base_url}[/blue]")
     
     # Initialize CursorFlow (framework-agnostic)
     try:
@@ -88,6 +104,7 @@ def test(test_name, base_url, actions, logs, config, verbose):
         flow = CursorFlow(
             base_url=base_url,
             log_config={'source': logs, 'paths': ['logs/app.log']},
+            browser_config={'headless': headless, 'timeout': timeout},
             **agent_config
         )
     except Exception as e:
@@ -99,7 +116,7 @@ def test(test_name, base_url, actions, logs, config, verbose):
         console.print(f"🚀 Executing {len(test_actions)} actions...")
         results = asyncio.run(flow.execute_and_collect(test_actions))
         
-        console.print(f"✅ Test completed: {test_name}")
+        console.print(f"✅ Test completed: {test_description}")
         console.print(f"📊 Browser events: {len(results.get('browser_events', []))}")
         console.print(f"📋 Server logs: {len(results.get('server_logs', []))}")
         console.print(f"📸 Screenshots: {len(results.get('artifacts', {}).get('screenshots', []))}")
@@ -110,11 +127,16 @@ def test(test_name, base_url, actions, logs, config, verbose):
             console.print(f"⏰ Timeline events: {len(timeline)}")
         
         # Save results to file for Cursor analysis
-        output_file = f"{test_name.replace(' ', '_')}_test_results.json"
-        with open(output_file, 'w') as f:
+        if not output:
+            # Auto-generate meaningful filename
+            session_id = results.get('session_id', 'unknown')
+            path_part = path.replace('/', '_') if path else 'root'
+            output = f"cursorflow_{path_part}_{session_id}.json"
+        
+        with open(output, 'w') as f:
             json.dump(results, f, indent=2, default=str)
         
-        console.print(f"💾 Full results saved to: [cyan]{output_file}[/cyan]")
+        console.print(f"💾 Full results saved to: [cyan]{output}[/cyan]")
         console.print(f"📁 Artifacts stored in: [cyan].cursorflow/artifacts/[/cyan]")
         
     except Exception as e:

{cursorflow-1.3.0 → cursorflow-1.3.1}/docs/USER_MANUAL.md

@@ -26,7 +26,7 @@
 pip install cursorflow
 
 # Test your app
-cursorflow test my-component --base-url http://localhost:3000
+cursorflow test --base-url http://localhost:3000 --path "/dashboard"
 ```
 
 **That's it!** CursorFlow captures screenshots, DOM data, network activity, console logs, and performance metrics automatically.
@@ -53,9 +53,9 @@ playwright install chromium  # Optional - happens automatically
 
 ## 🎯 Basic Usage
 
-### 1. Test Any Component
+### 1. Test Any Page
 ```bash
-cursorflow test dashboard --base-url http://localhost:3000
+cursorflow test --base-url http://localhost:3000 --path "/dashboard"
 ```
 
 ### 2. Compare Design to Implementation
@@ -136,39 +136,162 @@ All data is structured for AI analysis:
 
 ### **Basic Testing**
 ```bash
-# Test a component
-cursorflow test component-name --base-url http://localhost:3000
+# Simple page test (navigate and screenshot)
+cursorflow test --base-url http://localhost:3000 --path "/dashboard"
 
 # Test with custom actions
-cursorflow test login --actions '[
+cursorflow test --base-url http://localhost:3000 --actions '[
   {"navigate": "/login"},
-  {"fill": {"selector": "#username", "value": "test"}},
-  {"click": "#submit"},
-  {"screenshot": "result"}
+  {"fill": {"selector": "#username", "value": "test@example.com"}},
+  {"fill": {"selector": "#password", "value": "password123"}},
+  {"click": "#login-button"},
+  {"wait_for": ".dashboard"},
+  {"screenshot": "logged-in"}
 ]'
+
+# Test with all options
+cursorflow test \
+  --base-url http://localhost:3000 \
+  --actions '[
+    {"navigate": "/products"},
+    {"wait_for": ".product-grid"},
+    {"click": ".filter-button"},
+    {"fill": {"selector": "#search", "value": "laptop"}},
+    {"click": "#apply-filter"},
+    {"wait": 2},
+    {"screenshot": "filtered-products"}
+  ]' \
+  --output results.json \
+  --verbose
 ```
 
 ### **Mockup Comparison**
 ```bash
-# Compare mockup to implementation
+# Basic mockup comparison
 cursorflow compare-mockup https://mockup.com/design \
   --base-url http://localhost:3000
 
-# Test multiple viewports
+# Compare with multiple viewports
 cursorflow compare-mockup https://mockup.com/design \
   --base-url http://localhost:3000 \
   --viewports '[
     {"width": 1440, "height": 900, "name": "desktop"},
-    {"width": 768, "height": 1024, "name": "tablet"}
+    {"width": 768, "height": 1024, "name": "tablet"},
+    {"width": 375, "height": 667, "name": "mobile"}
   ]'
+
+# Compare with custom actions on both mockup and implementation
+cursorflow compare-mockup https://mockup.com/design \
+  --base-url http://localhost:3000 \
+  --mockup-actions '[
+    {"navigate": "/"},
+    {"click": "#menu-toggle"},
+    {"screenshot": "menu-open"}
+  ]' \
+  --implementation-actions '[
+    {"navigate": "/"},
+    {"wait_for": "#main-nav"},
+    {"click": "#menu-toggle"},
+    {"wait": 1},
+    {"screenshot": "menu-open"}
+  ]' \
+  --diff-threshold 0.1 \
+  --output comparison-results.json
 ```
 
 ### **CSS Iteration**
 ```bash
-# Iterate on CSS improvements
+# Basic CSS iteration
+cursorflow iterate-mockup https://mockup.com/design \
+  --base-url http://localhost:3000 \
+  --css-improvements '[
+    {"name": "spacing", "css": ".container { gap: 2rem; padding: 1.5rem; }"},
+    {"name": "colors", "css": ".button { background: #007bff; color: white; }"}
+  ]'
+
+# CSS iteration with custom base actions
+cursorflow iterate-mockup https://mockup.com/design \
+  --base-url http://localhost:3000 \
+  --base-actions '[
+    {"navigate": "/dashboard"},
+    {"wait_for": "#main-content"},
+    {"screenshot": "baseline"}
+  ]' \
+  --css-improvements '[
+    {"name": "improve-layout", "css": ".grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 1rem; }"},
+    {"name": "better-typography", "css": "h1 { font-size: 2.5rem; font-weight: 600; }"},
+    {"name": "enhanced-buttons", "css": ".btn { border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }"}
+  ]' \
+  --diff-threshold 0.05 \
+  --output iteration-results.json
+
+# Load CSS improvements from file
 cursorflow iterate-mockup https://mockup.com/design \
   --base-url http://localhost:3000 \
-  --css-improvements improvements.json
+  --css-improvements @css-improvements.json
+```
+
+### **Complete CLI Options Reference**
+
+#### **`cursorflow test` Options:**
+```bash
+cursorflow test [OPTIONS]
+
+Required:
+  --base-url TEXT          Base URL of the application to test
+
+Optional:
+  --path TEXT              Simple path to navigate to (e.g., "/dashboard")
+  --actions TEXT           JSON array of actions to perform
+  --output TEXT            Output file for results (default: prints to stdout)
+  --verbose               Enable verbose logging
+  --headless              Run browser in headless mode (default: true)
+  --timeout INTEGER       Timeout in seconds for actions (default: 30)
+```
+
+#### **`cursorflow compare-mockup` Options:**
+```bash
+cursorflow compare-mockup MOCKUP_URL [OPTIONS]
+
+Required:
+  MOCKUP_URL              URL of the mockup/design to compare against
+  --base-url TEXT         Base URL of the implementation
+
+Optional:
+  --mockup-actions TEXT   JSON array of actions for mockup
+  --implementation-actions TEXT  JSON array of actions for implementation
+  --viewports TEXT        JSON array of viewport configurations
+  --diff-threshold FLOAT  Similarity threshold (0.0-1.0, default: 0.1)
+  --output TEXT          Output file for comparison results
+  --verbose              Enable verbose logging
+```
+
+#### **`cursorflow iterate-mockup` Options:**
+```bash
+cursorflow iterate-mockup MOCKUP_URL [OPTIONS]
+
+Required:
+  MOCKUP_URL              URL of the mockup/design to match
+  --base-url TEXT         Base URL of the implementation
+
+Optional:
+  --base-actions TEXT     JSON array of base actions before CSS changes
+  --css-improvements TEXT JSON array of CSS improvements to test
+  --diff-threshold FLOAT  Similarity threshold (0.0-1.0, default: 0.05)
+  --output TEXT          Output file for iteration results
+  --verbose              Enable verbose logging
+```
+
+#### **Action Types Reference:**
+```json
+{"navigate": "/path"}                                    // Navigate to path
+{"click": "#selector"}                                   // Click element
+{"fill": {"selector": "#input", "value": "text"}}      // Fill input field
+{"select": {"selector": "#dropdown", "value": "option"}} // Select dropdown option
+{"wait": 2}                                             // Wait seconds
+{"wait_for": "#selector"}                               // Wait for element
+{"screenshot": "name"}                                  // Take screenshot
+{"screenshot": "name", "full_page": true}              // Full page screenshot
 ```
 
 ---

{cursorflow-1.3.0 → cursorflow-1.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cursorflow"
-version = "1.3.0"
+version = "1.3.1"
 description = "Complete page intelligence for AI-driven development - captures DOM, network, console, and performance data"
 authors = [
     {name = "GeekWarrior Development", email = "support@cursorflow.dev"}