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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 1.3.1
+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

{cursorflow-1.3.1.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=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.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,,
+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,,