cursorflow 2.1.5__tar.gz → 2.1.6__tar.gz

{cursorflow-2.1.5 → cursorflow-2.1.6}/FIRST_TIME_SETUP.md

@@ -23,13 +23,16 @@ This sets up CursorFlow in your specific project:
 ```bash
 cd /path/to/your/project
 cursorflow install-rules
+
+# Or for automation/CI (skip prompts)
+cursorflow install-rules --yes
 ```
 
 **What this creates:**
 - `.cursor/rules/` - Cursor AI integration rules (tells Cursor how to use CursorFlow)
-- `cursorflow-config.json` - Project-specific settings (base URL, log paths, etc.)
+- `.cursorflow/config.json` - Project-specific settings (base URL, log paths, etc.)
 - `.cursorflow/` - Artifacts directory (screenshots, sessions, test results)
-- `.gitignore` entries - Excludes CursorFlow artifacts from version control
+- `.gitignore` entries - Excludes entire `.cursorflow/` directory from version control
 
 ## 🤔 Why Two Steps?
 
@@ -68,7 +71,7 @@ Copies usage rules that teach Cursor AI how to use CursorFlow:
 - `cursorflow-usage.mdc` - How to run tests and analyze results
 - `cursorflow-installation.mdc` - Installation and setup guidance
 
-### 2. Configuration Template (`cursorflow-config.json`)
+### 2. Configuration File (`.cursorflow/config.json`)
 Auto-detects your project type and creates smart defaults:
 
 ```json
@@ -102,10 +105,10 @@ your-project/
 │       ├── cursorflow-usage.mdc
 │       └── cursorflow-installation.mdc
 ├── .cursorflow/
+│   ├── config.json
 │   ├── artifacts/
 │   ├── sessions/
 │   └── version_info.json
-├── cursorflow-config.json
 └── .gitignore (updated with CursorFlow entries)
 ```
 
@@ -155,7 +158,7 @@ cursorflow --version
 ls -la .cursor/rules/
 # Should show: cursorflow-usage.mdc, cursorflow-installation.mdc
 
-ls -la cursorflow-config.json
+ls -la .cursorflow/config.json
 # Should exist
 
 ls -la .cursorflow/
@@ -199,9 +202,9 @@ ls -la .cursorflow/
    - [ ] Run tests
 
 3. **Version control:**
-   - ✅ Commit `cursorflow-config.json` (team settings)
-   - ❌ Don't commit `.cursorflow/` (artifacts, generated per-developer)
+   - ❌ Don't commit `.cursorflow/` (config, artifacts, all per-developer)
    - ✅ Commit `.cursor/rules/` (Cursor AI integration)
+   - 💡 Each dev runs `cursorflow install-rules` to create their own config
 
 ## 🎯 Remember
 

{cursorflow-2.1.5 → cursorflow-2.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.1.5
+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
@@ -148,11 +148,14 @@ playwright install chromium
 ```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/config.json` - Project-specific configuration
 - `.cursorflow/` - Artifacts and session storage
 - `.gitignore` entries for CursorFlow artifacts
 

{cursorflow-2.1.5 → cursorflow-2.1.6}/README.md

@@ -103,11 +103,14 @@ playwright install chromium
 ```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/config.json` - Project-specific configuration
 - `.cursorflow/` - Artifacts and session storage
 - `.gitignore` entries for CursorFlow artifacts
 

{cursorflow-2.1.5 → cursorflow-2.1.6}/cursorflow/__init__.py

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

{cursorflow-2.1.5 → cursorflow-2.1.6}/cursorflow/auto_init.py

@@ -17,7 +17,7 @@ def is_project_initialized(project_dir: Optional[str] = None) -> bool:
     
     Returns True if:
     - .cursor/rules/ contains CursorFlow rules
-    - cursorflow-config.json exists
+    - .cursorflow/config.json exists
     - .cursorflow/ directory exists
     """
     if project_dir is None:
@@ -27,8 +27,7 @@ def is_project_initialized(project_dir: Optional[str] = None) -> bool:
     
     # Check for key indicators
     has_rules = (project_path / ".cursor" / "rules" / "cursorflow-usage.mdc").exists()
-    has_config = (project_path / "cursorflow-config.json").exists()
-    has_artifacts_dir = (project_path / ".cursorflow").exists()
+    has_config = (project_path / ".cursorflow" / "config.json").exists()
     
     # Need at least rules and config
     return has_rules and has_config
@@ -64,15 +63,20 @@ def auto_initialize_if_needed(project_dir: Optional[str] = None, interactive: bo
             return False
     
     # Interactive mode: ask user
-    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 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:
@@ -110,7 +114,7 @@ def get_initialization_warning() -> str:
 ║                                                                 ║
 ║  This creates:                                                  ║
 ║    • .cursor/rules/ (Cursor AI integration)                     ║
-║    • cursorflow-config.json (project configuration)             ║
+║    • .cursorflow/config.json (project configuration)            ║
 ║    • .cursorflow/ (artifacts and sessions)                      ║
 ║    • .gitignore entries                                         ║
 ║                                                                 ║

{cursorflow-2.1.5 → cursorflow-2.1.6}/cursorflow/cli.py

@@ -36,16 +36,21 @@ def main(ctx):
     from .auto_init import is_project_initialized, auto_initialize_if_needed
     
     if not is_project_initialized():
-        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
-        if not auto_initialize_if_needed(interactive=True):
+        # 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[/cyan]")
+            console.print("Run: [cyan]cursorflow install-rules --yes[/cyan]")
             ctx.exit(1)
 
 @main.command()
@@ -474,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
@@ -487,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-2.1.5 → cursorflow-2.1.6}/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.5')
+        current_version = getattr(cursorflow, '__version__', '2.1.6')
     except ImportError:
-        current_version = '2.1.5'
+        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.5')
+        current_version = getattr(cursorflow, '__version__', '2.1.6')
     except ImportError:
-        current_version = '2.1.5'
+        current_version = '2.1.6'
     
     version_info = {
         "installed_version": current_version,

{cursorflow-2.1.5 → cursorflow-2.1.6}/cursorflow/rules/cursorflow-installation.mdc

@@ -24,7 +24,7 @@ CursorFlow requires **TWO installations**:
    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` in project root.
+**If you can run cursorflow but tests fail**, check `.cursorflow/config.json` configuration.
 
 ## 🚀 **When to Install CursorFlow**
 

{cursorflow-2.1.5 → cursorflow-2.1.6}/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.5 → cursorflow-2.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cursorflow"
-version = "2.1.5"
+version = "2.1.6"
 description = "🔥 Complete page intelligence for AI-driven development with Hot Reload Intelligence - captures DOM, network, console, performance, HMR events, and comprehensive page analysis"
 authors = [
     {name = "GeekWarrior Development", email = "rbush@cooltheory.com"}