cursorflow 1.3.0__py3-none-any.whl → 1.3.2__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/install_cursorflow_rules.py

@@ -0,0 +1,271 @@
+#!/usr/bin/env python3
+"""
+CursorFlow Rules Installation Script
+
+Installs CursorFlow usage rules into a user's project for Cursor AI.
+Run this in your project directory to enable CursorFlow integration.
+"""
+
+import os
+import shutil
+import json
+import datetime
+from pathlib import Path
+import argparse
+
+
+def install_cursorflow_rules(project_dir: str = "."):
+    """Install CursorFlow rules and configuration in user's project"""
+    
+    project_path = Path(project_dir).resolve()
+    print(f"🚀 Installing CursorFlow rules in: {project_path}")
+    
+    # Create .cursor directory if it doesn't exist
+    cursor_dir = project_path / ".cursor"
+    cursor_dir.mkdir(exist_ok=True)
+    
+    rules_dir = cursor_dir / "rules"
+    rules_dir.mkdir(exist_ok=True)
+    
+    print(f"📁 Created Cursor rules directory: {rules_dir}")
+    
+    # Find CursorFlow package location
+    try:
+        import cursorflow
+        package_dir = Path(cursorflow.__file__).parent.parent
+        rules_source_dir = package_dir / "rules"
+    except ImportError:
+        # Fallback: look for rules in current directory structure
+        current_dir = Path(__file__).parent
+        rules_source_dir = current_dir.parent / "rules"  # Go up one level from cursorflow/ to find rules/
+        
+    if not rules_source_dir.exists():
+        print(f"❌ Could not find CursorFlow rules directory at: {rules_source_dir}")
+        return False
+    
+    # Copy usage rules (not development rules)
+    usage_rules = [
+        "cursorflow-usage.mdc",
+        "cursorflow-installation.mdc"
+    ]
+    
+    copied_files = []
+    for rule_file in usage_rules:
+        source_file = rules_source_dir / rule_file
+        target_file = rules_dir / rule_file
+        
+        if source_file.exists():
+            shutil.copy2(source_file, target_file)
+            copied_files.append(rule_file)
+            print(f"✅ Installed: {rule_file}")
+        else:
+            print(f"⚠️  Rule file not found: {rule_file}")
+    
+    # Create project-specific .gitignore entries
+    create_gitignore_entries(project_path)
+    
+    # Create CursorFlow configuration template
+    create_config_template(project_path)
+    
+    print(f"\n🎉 CursorFlow rules installation complete!")
+    print(f"📋 Installed {len(copied_files)} rule files:")
+    for file in copied_files:
+        print(f"   - {file}")
+    
+    # Set up automatic update checking
+    setup_update_checking(project_path)
+    
+    print(f"\n📝 Next steps:")
+    print(f"   1. Review cursorflow-config.json and update for your project")
+    print(f"   2. Install CursorFlow: pip install cursorflow")
+    print(f"   3. Install Playwright: playwright install chromium")
+    print(f"   4. Start using CursorFlow for UI testing and CSS iteration!")
+    print(f"\n🔄 Update commands:")
+    print(f"   - Check for updates: python -m cursorflow check-updates")
+    print(f"   - Update CursorFlow: python -m cursorflow update")
+    print(f"   - Install dependencies: python -m cursorflow install-deps")
+    
+    return True
+
+
+def create_gitignore_entries(project_path: Path):
+    """Add CursorFlow artifacts to .gitignore"""
+    
+    gitignore_path = project_path / ".gitignore"
+    
+    cursorflow_entries = """
+# CursorFlow artifacts (UI testing framework)
+.cursorflow/
+*.cursorflow.log
+cursorflow_session_*.json
+"""
+    
+    # Check if entries already exist
+    existing_content = ""
+    if gitignore_path.exists():
+        existing_content = gitignore_path.read_text()
+    
+    if ".cursorflow/" not in existing_content:
+        with open(gitignore_path, "a") as f:
+            f.write(cursorflow_entries)
+        print("✅ Added CursorFlow entries to .gitignore")
+    else:
+        print("ℹ️  CursorFlow entries already in .gitignore")
+
+
+def create_config_template(project_path: Path):
+    """Create CursorFlow configuration template"""
+    
+    config_path = project_path / "cursorflow-config.json"
+    
+    if config_path.exists():
+        print("ℹ️  cursorflow-config.json already exists")
+        return
+    
+    # Auto-detect project type for better defaults
+    project_type = detect_project_type(project_path)
+    
+    config_template = {
+        "base_url": get_default_url(project_type),
+        "logs": get_default_log_config(project_type),
+        "auth": {
+            "method": "form",
+            "username_selector": "#username",
+            "password_selector": "#password", 
+            "submit_selector": "#login-button",
+            "session_storage": ".cursorflow/sessions/"
+        },
+        "browser": {
+            "headless": True,
+            "debug_mode": False
+        },
+        "_project_type": project_type,
+        "_cursorflow_version": "1.0.0"
+    }
+    
+    import json
+    with open(config_path, "w") as f:
+        json.dump(config_template, f, indent=2)
+    
+    print(f"✅ Created configuration template: cursorflow-config.json")
+    print(f"   Detected project type: {project_type}")
+
+
+def detect_project_type(project_path: Path) -> str:
+    """Detect project type for better defaults"""
+    
+    if (project_path / "package.json").exists():
+        package_json = project_path / "package.json"
+        try:
+            import json
+            with open(package_json) as f:
+                package_data = json.load(f)
+            
+            dependencies = package_data.get("dependencies", {})
+            dev_dependencies = package_data.get("devDependencies", {})
+            all_deps = {**dependencies, **dev_dependencies}
+            
+            if "next" in all_deps:
+                return "nextjs"
+            elif "react" in all_deps:
+                return "react"
+            elif "vue" in all_deps:
+                return "vue"
+            else:
+                return "nodejs"
+        except:
+            return "nodejs"
+    
+    elif (project_path / "manage.py").exists():
+        return "django"
+    
+    elif (project_path / "composer.json").exists():
+        return "php"
+    
+    elif (project_path / "Gemfile").exists():
+        return "rails"
+    
+    elif any((project_path / f).exists() for f in ["*.pl", "*.pm"]):
+        return "perl"
+    
+    else:
+        return "generic"
+
+
+def get_default_url(project_type: str) -> str:
+    """Get default development server URL"""
+    
+    defaults = {
+        "nextjs": "http://localhost:3000",
+        "react": "http://localhost:3000",
+        "vue": "http://localhost:8080",
+        "nodejs": "http://localhost:3000",
+        "django": "http://localhost:8000",
+        "php": "http://localhost:8080",
+        "rails": "http://localhost:3000",
+        "perl": "http://localhost:8080",
+        "generic": "http://localhost:3000"
+    }
+    
+    return defaults.get(project_type, "http://localhost:3000")
+
+
+def get_default_log_config(project_type: str) -> dict:
+    """Get default log configuration"""
+    
+    log_configs = {
+        "nextjs": {"source": "local", "paths": [".next/trace.log", "logs/app.log"]},
+        "react": {"source": "local", "paths": ["logs/app.log", "console.log"]},
+        "vue": {"source": "local", "paths": ["logs/app.log"]},
+        "nodejs": {"source": "local", "paths": ["logs/app.log", "npm-debug.log"]},
+        "django": {"source": "local", "paths": ["logs/django.log", "logs/debug.log"]},
+        "php": {"source": "local", "paths": ["storage/logs/laravel.log", "logs/error.log"]},
+        "rails": {"source": "local", "paths": ["log/development.log", "log/test.log"]},
+        "perl": {"source": "ssh", "host": "staging-server", "paths": ["/var/log/httpd/error_log"]},
+        "generic": {"source": "local", "paths": ["logs/app.log"]}
+    }
+    
+    return log_configs.get(project_type, {"source": "local", "paths": ["logs/app.log"]})
+
+
+def setup_update_checking(project_path: Path):
+    """Set up automatic update checking configuration"""
+    
+    cursorflow_dir = project_path / ".cursorflow"
+    cursorflow_dir.mkdir(exist_ok=True)
+    
+    # Create update preferences
+    update_prefs = {
+        "check_interval_hours": 24,
+        "auto_update": False,
+        "include_prereleases": False,
+        "backup_before_update": True,
+        "last_check": None
+    }
+    
+    prefs_file = cursorflow_dir / "update_preferences.json"
+    with open(prefs_file, 'w') as f:
+        json.dump(update_prefs, f, indent=2)
+    
+    # Create initial version tracking
+    version_info = {
+        "installed_version": "1.0.0",
+        "rules_version": "1.0.0",
+        "installation_date": str(datetime.datetime.now().isoformat())
+    }
+    
+    version_file = cursorflow_dir / "version_info.json"
+    with open(version_file, 'w') as f:
+        json.dump(version_info, f, indent=2)
+    
+    print("✅ Update checking configured")
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="Install CursorFlow rules in a project")
+    parser.add_argument("--project-dir", default=".", help="Project directory (default: current directory)")
+    
+    args = parser.parse_args()
+    
+    success = install_cursorflow_rules(args.project_dir)
+    exit(0 if success else 1)

{cursorflow-1.3.0.dist-info → cursorflow-1.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 1.3.0
+Version: 1.3.2
 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.2.dist-info}/RECORD

@@ -1,6 +1,7 @@
 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/install_cursorflow_rules.py,sha256=Kc_rUs1oZ0-7oZE6LKEPCMnQUmixm5qgOe6rHzTCdoA,9041
 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 +20,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.2.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-1.3.2.dist-info/METADATA,sha256=jZu97_NLgtcgL5fHVbi7z7zE3_PVY7jqDfcwcXgQlMw,7659
+cursorflow-1.3.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-1.3.2.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-1.3.2.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-1.3.2.dist-info/RECORD,,