cursorflow 1.3.0__py3-none-any.whl → 1.3.1__py3-none-any.whl

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.dist-info → cursorflow-1.3.1.dist-info}/METADATA

@@ -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.dist-info → cursorflow-1.3.1.dist-info}/RECORD

@@ -1,6 +1,6 @@
 cursorflow/__init__.py,sha256=nRmHnnnsbDH1A7_d3XkmzB5iJ44bt124zAQhaEhscyY,2450
 cursorflow/auto_updater.py,sha256=oQ12TIMZ6Cm3HF-x9iRWFtvOLkRh-JWPqitS69-4roE,7851
-cursorflow/cli.py,sha256=cE4W8XGAaS8NBw94aKVciWMvV6rqi0-waA2bB2O88kM,24026
+cursorflow/cli.py,sha256=JRznfNAaXuthmCVwQX7yvX8FtAFrZYwemUA7BfvfFOo,25036
 cursorflow/updater.py,sha256=pvbSZgg6hgWZBE5AAUPppS5Yzv0yNMp2X_CL2GALg_w,18783
 cursorflow/core/agent.py,sha256=f3lecgEzDRDdGTVccAtorpLGfNJJ49bbsQAmgr0vNGg,10136
 cursorflow/core/auth_handler.py,sha256=oRafO6ZdxoHryBIvHsrNV8TECed4GXpJsdEiH0KdPPk,17149
@@ -19,9 +19,9 @@ cursorflow/core/persistent_session.py,sha256=FsEHj4wKkycmdp6PFRHv3g333Y74yqra0x_
 cursorflow/core/report_generator.py,sha256=-vosfyrnfVyWDbAIMlMurl90xOXqBae8d6aLd9sEqiY,10113
 cursorflow/log_sources/local_file.py,sha256=SwA294n_Ozg76ZUF5nPn5W2Fts_XtSOHEcO2S65vnjc,6768
 cursorflow/log_sources/ssh_remote.py,sha256=TrE9FZ4aI6Cz1vChjvG8RC2KrNlgRKtG0_hC1w8pGDA,7106
-cursorflow-1.3.0.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-1.3.0.dist-info/METADATA,sha256=cLggB4V0-twK1XBZMk-Hnrdme0vdN3RwNan9FbrwIqY,6960
-cursorflow-1.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-1.3.0.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-1.3.0.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-1.3.0.dist-info/RECORD,,
+cursorflow-1.3.1.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-1.3.1.dist-info/METADATA,sha256=hpTsD-iCuuDDt8hCuGKsC8yTP3AgTdPmUAIHAPDhwTQ,7659
+cursorflow-1.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-1.3.1.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-1.3.1.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-1.3.1.dist-info/RECORD,,