cursorflow 2.1.4__py3-none-any.whl → 2.1.6__py3-none-any.whl

cursorflow/__init__.py

@@ -56,7 +56,7 @@ def _get_version():
         pass
     
     # Fallback version - should match pyproject.toml
-    return "2.1.4"
+    return "2.1.6"
 
 __version__ = _get_version()
 __author__ = "GeekWarrior Development"

cursorflow/auto_init.py

@@ -0,0 +1,151 @@
+"""
+Auto-initialization for CursorFlow
+
+Detects uninitialized projects and offers to set them up automatically.
+Makes the setup process seamless for both humans and AI agents.
+"""
+
+import os
+import sys
+from pathlib import Path
+from typing import Optional
+
+
+def is_project_initialized(project_dir: Optional[str] = None) -> bool:
+    """
+    Check if CursorFlow is initialized in the project
+    
+    Returns True if:
+    - .cursor/rules/ contains CursorFlow rules
+    - .cursorflow/config.json exists
+    - .cursorflow/ directory exists
+    """
+    if project_dir is None:
+        project_dir = os.getcwd()
+    
+    project_path = Path(project_dir)
+    
+    # Check for key indicators
+    has_rules = (project_path / ".cursor" / "rules" / "cursorflow-usage.mdc").exists()
+    has_config = (project_path / ".cursorflow" / "config.json").exists()
+    
+    # Need at least rules and config
+    return has_rules and has_config
+
+
+def auto_initialize_if_needed(project_dir: Optional[str] = None, interactive: bool = True) -> bool:
+    """
+    Auto-initialize CursorFlow in project if not already initialized
+    
+    Args:
+        project_dir: Project directory (defaults to cwd)
+        interactive: If True, ask user for confirmation. If False, auto-initialize silently.
+        
+    Returns:
+        True if initialized (or already was), False if user declined or error occurred
+    """
+    if is_project_initialized(project_dir):
+        return True
+    
+    if project_dir is None:
+        project_dir = os.getcwd()
+    
+    project_path = Path(project_dir)
+    
+    # If non-interactive (e.g., running via Cursor), just do it
+    if not interactive:
+        try:
+            from .install_cursorflow_rules import install_cursorflow_rules
+            return install_cursorflow_rules(project_dir, force=False)
+        except Exception as e:
+            print(f"⚠️  Auto-initialization failed: {e}", file=sys.stderr)
+            print(f"💡 Run manually: cursorflow install-rules", file=sys.stderr)
+            return False
+    
+    # Interactive mode: ask user
+    if not sys.stdin.isatty():
+        # Non-interactive environment (CI, pipes, etc) - auto-accept
+        print("🎯 CursorFlow not initialized. Auto-initializing (non-interactive mode)...")
+        response = 'y'
+    else:
+        print("\n🎯 CursorFlow is not initialized in this project yet.")
+        print(f"📁 Project directory: {project_path}")
+        print("\nTo use CursorFlow, we need to set up:")
+        print("  • Cursor AI rules in .cursor/rules/")
+        print("  • Configuration file: .cursorflow/config.json")
+        print("  • Artifacts directory: .cursorflow/")
+        print("  • .gitignore entries for CursorFlow artifacts")
+        
+        response = input("\n🚀 Initialize CursorFlow now? [Y/n]: ").strip().lower()
+    
+    if response in ('', 'y', 'yes'):
+        try:
+            from .install_cursorflow_rules import install_cursorflow_rules
+            success = install_cursorflow_rules(project_dir, force=False)
+            
+            if success:
+                print("\n✅ CursorFlow is ready to use!")
+                print("💡 Start testing with: cursorflow test --help")
+            
+            return success
+            
+        except Exception as e:
+            print(f"\n❌ Initialization failed: {e}", file=sys.stderr)
+            print(f"💡 Try manually: cursorflow install-rules", file=sys.stderr)
+            return False
+    else:
+        print("\n⏭️  Skipped initialization.")
+        print("💡 Run later with: cursorflow install-rules")
+        return False
+
+
+def get_initialization_warning() -> str:
+    """Get a friendly warning message for uninitialized projects"""
+    
+    return """
+╔════════════════════════════════════════════════════════════════╗
+║  🎯 CursorFlow Not Initialized                                 ║
+╠════════════════════════════════════════════════════════════════╣
+║                                                                 ║
+║  CursorFlow requires project-specific setup to work properly.  ║
+║                                                                 ║
+║  Quick fix:                                                     ║
+║    cursorflow install-rules                                     ║
+║                                                                 ║
+║  This creates:                                                  ║
+║    • .cursor/rules/ (Cursor AI integration)                     ║
+║    • .cursorflow/config.json (project configuration)            ║
+║    • .cursorflow/ (artifacts and sessions)                      ║
+║    • .gitignore entries                                         ║
+║                                                                 ║
+╚════════════════════════════════════════════════════════════════╝
+"""
+
+
+def ensure_initialized(project_dir: Optional[str] = None, auto_init: bool = False) -> None:
+    """
+    Ensure project is initialized, or raise helpful error
+    
+    Args:
+        project_dir: Project directory
+        auto_init: If True, automatically initialize without asking
+        
+    Raises:
+        RuntimeError: If not initialized and user declines/can't initialize
+    """
+    if is_project_initialized(project_dir):
+        return
+    
+    # Try auto-initialization
+    interactive = not auto_init and sys.stdin.isatty()
+    
+    if auto_initialize_if_needed(project_dir, interactive=interactive):
+        return
+    
+    # Failed to initialize
+    print(get_initialization_warning(), file=sys.stderr)
+    raise RuntimeError(
+        "CursorFlow not initialized in this project. "
+        "Run: cursorflow install-rules"
+    )
+

cursorflow/cli.py

@@ -22,9 +22,36 @@ console = Console()
 
 @click.group()
 @click.version_option(version=__version__)
-def main():
+@click.pass_context
+def main(ctx):
     """Universal UI testing framework for any web technology"""
-    pass
+    
+    # Skip initialization check for commands that don't need it
+    skip_init_check = ['install-rules', 'init', 'update', 'check-updates', 'install-deps']
+    
+    if ctx.invoked_subcommand in skip_init_check:
+        return
+    
+    # Check if project is initialized, offer to auto-initialize
+    from .auto_init import is_project_initialized, auto_initialize_if_needed
+    
+    if not is_project_initialized():
+        # Check if running in non-interactive mode (CI, scripts, etc)
+        import sys
+        is_interactive = sys.stdin.isatty()
+        
+        if is_interactive:
+            console.print("\n[yellow]⚠️  CursorFlow not initialized in this project[/yellow]")
+            console.print("This is a one-time setup that creates:")
+            console.print("  • .cursor/rules/ (Cursor AI integration)")
+            console.print("  • .cursorflow/config.json (project configuration)")
+            console.print("  • .cursorflow/ (artifacts directory)")
+        
+        # Auto-initialize with confirmation (or silently if non-interactive)
+        if not auto_initialize_if_needed(interactive=is_interactive):
+            console.print("\n[red]Cannot proceed without initialization.[/red]")
+            console.print("Run: [cyan]cursorflow install-rules --yes[/cyan]")
+            ctx.exit(1)
 
 @main.command()
 @click.option('--base-url', '-u', required=True,
@@ -452,10 +479,12 @@ async def _run_auto_tests(framework: str, base_url: str, config: Dict):
 @click.argument('project_path', default='.')
 @click.option('--framework', '-f')  
 @click.option('--force', is_flag=True, help='Force update existing configuration')
-def install_rules(project_path, framework, force):
+@click.option('--yes', '-y', is_flag=True, help='Skip confirmation prompts')
+def install_rules(project_path, framework, force, yes):
     """Install CursorFlow rules and configuration in a project"""
     
-    console.print("🚀 Installing CursorFlow rules and configuration...")
+    if not yes:
+        console.print("🚀 Installing CursorFlow rules and configuration...")
     
     try:
         # Import and run the installation
@@ -465,7 +494,7 @@ def install_rules(project_path, framework, force):
         if success:
             console.print("[green]✅ CursorFlow rules installed successfully![/green]")
             console.print("\nNext steps:")
-            console.print("1. Review cursorflow-config.json")
+            console.print("1. Review .cursorflow/config.json")
             console.print("2. Install dependencies: pip install cursorflow && playwright install chromium")
             console.print("3. Start testing: Use CursorFlow in Cursor!")
         else:

cursorflow/install_cursorflow_rules.py

@@ -80,10 +80,9 @@ def install_cursorflow_rules(project_dir: str = ".", force: bool = False):
     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"   1. Review .cursorflow/config.json and update for your project")
+    print(f"   2. Install Playwright: playwright install chromium")
+    print(f"   3. 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")
@@ -120,18 +119,22 @@ cursorflow_session_*.json
 def create_config_template(project_path: Path, force: bool = False):
     """Create or update CursorFlow configuration template"""
     
-    config_path = project_path / "cursorflow-config.json"
+    # Create .cursorflow directory if it doesn't exist
+    cursorflow_dir = project_path / ".cursorflow"
+    cursorflow_dir.mkdir(exist_ok=True)
+    
+    config_path = cursorflow_dir / "config.json"
     
     # Get current version
     try:
         import cursorflow
-        current_version = getattr(cursorflow, '__version__', '2.1.4')
+        current_version = getattr(cursorflow, '__version__', '2.1.6')
     except ImportError:
-        current_version = '2.1.4'
+        current_version = '2.1.6'
     
     if config_path.exists():
         if not force:
-            print("ℹ️  cursorflow-config.json already exists (use --force to recreate)")
+            print("ℹ️  .cursorflow/config.json already exists (use --force to recreate)")
             # Smart update: only update version and add missing fields
             try:
                 with open(config_path) as f:
@@ -198,7 +201,7 @@ def create_config_template(project_path: Path, force: bool = False):
         json.dump(config_template, f, indent=2)
     
     action = "Recreated" if force else "Created"
-    print(f"✅ {action} configuration template: cursorflow-config.json")
+    print(f"✅ {action} configuration: .cursorflow/config.json")
     print(f"   Detected project type: {project_type}")
     print(f"   CursorFlow version: {current_version}")
 
@@ -302,9 +305,9 @@ def setup_update_checking(project_path: Path):
     # Create initial version tracking
     try:
         import cursorflow
-        current_version = getattr(cursorflow, '__version__', '2.1.4')
+        current_version = getattr(cursorflow, '__version__', '2.1.6')
     except ImportError:
-        current_version = '2.1.4'
+        current_version = '2.1.6'
     
     version_info = {
         "installed_version": current_version,

cursorflow/post_install.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+"""
+Post-install message for CursorFlow
+
+Shows important setup instructions after pip install.
+"""
+
+def show_post_install_message():
+    """Display post-install instructions"""
+    
+    message = """
+╔══════════════════════════════════════════════════════════════════════╗
+║                                                                      ║
+║  ✅ CursorFlow installed successfully!                               ║
+║                                                                      ║
+║  📋 IMPORTANT: One more step to enable CursorFlow in your project   ║
+║                                                                      ║
+║  Run this in your project directory:                                ║
+║                                                                      ║
+║    cd /path/to/your/project                                         ║
+║    cursorflow install-rules                                         ║
+║                                                                      ║
+║  This creates:                                                       ║
+║    • Cursor AI integration rules                                    ║
+║    • Project-specific configuration                                 ║
+║    • Artifacts directory structure                                  ║
+║                                                                      ║
+║  💡 Then install browser dependencies:                              ║
+║                                                                      ║
+║    playwright install chromium                                      ║
+║                                                                      ║
+║  🚀 After that, you can start testing:                              ║
+║                                                                      ║
+║    cursorflow test --base-url http://localhost:3000 --path /        ║
+║                                                                      ║
+║  📚 Documentation: https://github.com/haley-marketing-group/cursorflow ║
+║                                                                      ║
+╚══════════════════════════════════════════════════════════════════════╝
+"""
+    
+    print(message)
+
+
+if __name__ == "__main__":
+    show_post_install_message()
+

cursorflow/rules/cursorflow-installation.mdc

@@ -1,11 +1,32 @@
 ---
-title: CursorFlow 2.0.0 Installation & Setup Guide for Cursor
-description: How to install and configure CursorFlow 2.0.0 for complete page intelligence in AI-driven development
+title: CursorFlow Installation & Setup Guide for Cursor
+description: How to install and configure CursorFlow for complete page intelligence in AI-driven development
 ---
 
-# CursorFlow 2.1.4 Installation & Setup Guide for Cursor
+# CursorFlow Installation & Setup Guide for Cursor
 
-## 🚀 **When to Install CursorFlow 2.1.4**
+## ⚠️ **CRITICAL: Two-Step Installation Process**
+
+**If you are reading this file, Step 2 is already complete for this project.**
+
+CursorFlow requires **TWO installations**:
+
+1. **Step 1 - Package Installation** (once per Python environment):
+   ```bash
+   pip install cursorflow
+   playwright install chromium
+   ```
+
+2. **Step 2 - Project Initialization** (once per project):
+   ```bash
+   cursorflow install-rules
+   ```
+   This step created THIS FILE you're reading right now.
+
+**If Cursor reports "command not found: cursorflow"**, the user needs Step 1.  
+**If you can run cursorflow but tests fail**, check `.cursorflow/config.json` configuration.
+
+## 🚀 **When to Install CursorFlow**
 
 ### **Automatically Install When:**
 - User mentions UI testing, visual debugging, or layout issues
@@ -24,10 +45,13 @@ description: How to install and configure CursorFlow 2.0.0 for complete page int
 
 ## 📦 **Installation Steps**
 
-### **1. Install CursorFlow 2.0.0:**
+### **1. Verify Package Installation:**
 ```bash
-# Install CursorFlow 2.0.0 with complete page intelligence
-pip install cursorflow
+# Check if CursorFlow is installed
+cursorflow --version
+
+# If not installed or outdated:
+pip install --upgrade cursorflow
 
 # Install browser automation dependencies
 playwright install chromium

cursorflow/updater.py

@@ -363,7 +363,7 @@ class CursorFlowUpdater:
     
     async def _migrate_configuration(self) -> bool:
         """Migrate configuration to new format if needed"""
-        config_file = self.project_dir / "cursorflow-config.json"
+        config_file = self.project_dir / ".cursorflow" / "config.json"
         
         if not config_file.exists():
             return True
@@ -417,9 +417,10 @@ class CursorFlowUpdater:
         backup_path = backup_dir / backup_name
         
         # Backup configuration and rules
-        if (self.project_dir / "cursorflow-config.json").exists():
+        config_file = self.project_dir / ".cursorflow" / "config.json"
+        if config_file.exists():
             shutil.copy2(
-                self.project_dir / "cursorflow-config.json",
+                config_file,
                 backup_path.with_suffix('.config.json')
             )
         

{cursorflow-2.1.4.dist-info → cursorflow-2.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.1.4
+Version: 2.1.6
 Summary: 🔥 Complete page intelligence for AI-driven development with Hot Reload Intelligence - captures DOM, network, console, performance, HMR events, and comprehensive page analysis
 Author-email: GeekWarrior Development <rbush@cooltheory.com>
 License-Expression: MIT
@@ -138,10 +138,29 @@ All data structured for AI consumption:
 
 ## 🚀 Quick Start
 
+### Step 1: Install CursorFlow Package
 ```bash
-# Install CursorFlow
 pip install cursorflow
+playwright install chromium
+```
+
+### Step 2: Initialize Your Project (One-Time Setup)
+```bash
+cd /path/to/your/project
+cursorflow install-rules
 
+# Or skip prompts for automation/CI
+cursorflow install-rules --yes
+```
+
+This creates:
+- `.cursor/rules/` - Cursor AI integration rules
+- `.cursorflow/config.json` - Project-specific configuration
+- `.cursorflow/` - Artifacts and session storage
+- `.gitignore` entries for CursorFlow artifacts
+
+### Step 3: Start Testing
+```bash
 # Test real application behavior
 cursorflow test --base-url http://localhost:3000 --path "/dashboard"
 

{cursorflow-2.1.4.dist-info → cursorflow-2.1.6.dist-info}/RECORD

@@ -1,8 +1,10 @@
-cursorflow/__init__.py,sha256=3zdOAvMaLDe_OLKUbh-G9q0jXnprS-9CHxpRxKJPWy8,2763
+cursorflow/__init__.py,sha256=6fFhPsv_4SP9xjmte1e47Sn9ikjQ-6jU_XyWpBcyMYs,2763
+cursorflow/auto_init.py,sha256=dXQaXXiXe4wkUP-jd8fcJ5fYVt7ASdTb47b7SzXymOM,6122
 cursorflow/auto_updater.py,sha256=oQ12TIMZ6Cm3HF-x9iRWFtvOLkRh-JWPqitS69-4roE,7851
-cursorflow/cli.py,sha256=ca36aTHFLYpiaeQYoj3TB4o39CEfj3WWaePze8yNvdg,27280
-cursorflow/install_cursorflow_rules.py,sha256=xIVw1DhqHL9YDT_JM7sXfVcMXIB0OuYZjC18jac-v8o,11792
-cursorflow/updater.py,sha256=rAST7STjw-SgKxn_jsQJWOoyEMia-MQVxpKMwzPRnOA,19573
+cursorflow/cli.py,sha256=B0kmF_QdXWV2T3ibv55PKNF52Wu8wFQaLsAeVy1KGBI,28717
+cursorflow/install_cursorflow_rules.py,sha256=tMjvB1zk54wuVGOaVJPCDB6v4B8A6o0WdKx6_1QBqiM,11864
+cursorflow/post_install.py,sha256=WieBiKWG0qBAQpF8iMVWUyb9Fr2Xky9qECTMPrlAbpE,2678
+cursorflow/updater.py,sha256=SroSQHQi5cYyzcOK_bf-WzmQmE7yeOs8qo3r__j-Z6E,19583
 cursorflow/core/agent.py,sha256=f3lecgEzDRDdGTVccAtorpLGfNJJ49bbsQAmgr0vNGg,10136
 cursorflow/core/auth_handler.py,sha256=oRafO6ZdxoHryBIvHsrNV8TECed4GXpJsdEiH0KdPPk,17149
 cursorflow/core/browser_controller.py,sha256=KZXSrXInju09Q--D_ULej4_hc5s7qv-7ODxW4WS0nHw,131708
@@ -24,11 +26,11 @@ cursorflow/core/trace_manager.py,sha256=Jj9ultZrL1atiZXfcRVI6ynCnnfqZM-X0_taxt-l
 cursorflow/log_sources/local_file.py,sha256=YAzF6oZRusNT_EOJduoeMTgP6dc1Av9wK96yNxmhSGA,7558
 cursorflow/log_sources/ssh_remote.py,sha256=xLLxm5B95kUcLqMC7-oZUA66e1rU5LLeeBiR6Mw5syc,7642
 cursorflow/rules/__init__.py,sha256=gPcA-IkhXj03sl7cvZV0wwo7CtEkcyuKs4y0F5oQbqE,458
-cursorflow/rules/cursorflow-installation.mdc,sha256=dLyQmKvER5J54EV5GAb-g4xNPMZP8pqecZpOlxf-tKA,9511
+cursorflow/rules/cursorflow-installation.mdc,sha256=y4nj5XSROuBRXDK8GtfcEMRBqliQcEuvXYGyTPAZD8Q,10190
 cursorflow/rules/cursorflow-usage.mdc,sha256=jD5IrIP2eKIeQN2TS-ehnwD1u_J6lWSXQZZ9KSUcOUU,21449
-cursorflow-2.1.4.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-2.1.4.dist-info/METADATA,sha256=97woSQvbkl5nqSs2kOKwriTlwz1S41gp2u4dHOusFNU,12300
-cursorflow-2.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-2.1.4.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-2.1.4.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-2.1.4.dist-info/RECORD,,
+cursorflow-2.1.6.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.1.6.dist-info/METADATA,sha256=JahJbtiiK_gJyOvamARnNgLbKUjGUlMxysOe28X8UNQ,12790
+cursorflow-2.1.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.1.6.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.1.6.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.1.6.dist-info/RECORD,,