cursorflow 2.1.5__tar.gz → 2.2.0__tar.gz

{cursorflow-2.1.5 → cursorflow-2.2.0}/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.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.1.5
+Version: 2.2.0
 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
@@ -82,20 +82,57 @@ When CursorFlow reports `"average_response_time": 416.58ms`, you can tell stakeh
 
 **Documentary vs Movie:** Both are valuable, but if you're trying to understand reality, you watch the documentary. CursorFlow is the documentary of web testing.
 
+## 🎯 Pass-Through Architecture
+
+CursorFlow doesn't limit you - it exposes the full power of Playwright:
+
+**94+ Playwright actions available:**
+```bash
+# Any Playwright Page method works
+cursorflow test --actions '[
+  {"hover": ".menu"},
+  {"dblclick": ".editable"},
+  {"press": "Enter"},
+  {"drag_and_drop": {"source": ".item", "target": ".zone"}},
+  {"check": "#checkbox"},
+  {"evaluate": "window.scrollTo(0, 500)"}
+]'
+```
+
+**Full configuration pass-through:**
+```json
+{
+  "browser_config": {
+    "browser_launch_options": {"devtools": true, "channel": "chrome"}
+  },
+  "context_options": {
+    "color_scheme": "dark",
+    "geolocation": {"latitude": 40.7128, "longitude": -74.0060},
+    "timezone_id": "America/Los_Angeles"
+  }
+}
+```
+
+**Forward-compatible:** New Playwright features work immediately without CursorFlow updates.
+
+**See:** [Playwright API Documentation](https://playwright.dev/python/docs/api/class-page)
+
+---
+
 ## 🚀 Complete Page Intelligence
 
-Every screenshot captures everything your AI needs to make intelligent decisions:
+Every test captures everything needed for debugging:
 
 ### **📊 Comprehensive Data Collection**
-- **DOM**: All elements with 7 selector strategies each
-- **Network**: All requests, responses, and complete response bodies  
-- **Console**: All logs, errors, and smart error correlation
-- **Performance**: Load times, memory usage, with reliability indicators
-- **Visual**: Screenshots with pixel-perfect comparisons and enhanced options
-- **Fonts**: Loading status, performance, and usage analysis
-- **Animations**: Active animations and transitions tracking
-- **Resources**: Complete resource loading analysis
-- **Storage**: localStorage, sessionStorage, cookies, IndexedDB state
+- **DOM**: All elements with 7 selector strategies + event handlers
+- **Network**: Requests, responses, and complete request/response bodies  
+- **Console**: All logs, errors, warnings - displayed prominently
+- **JavaScript**: Global functions, variables, specific window objects
+- **Storage**: localStorage, sessionStorage, cookies (sensitive data masked)
+- **Forms**: All field values at capture time (passwords masked)
+- **Performance**: Load times, memory usage, reliability indicators
+- **Visual**: Screenshots with comprehensive page analysis
+- **Sessions**: Save/restore browser state for authenticated testing
 
 ### **🔄 Hot Reload Intelligence**
 - **Framework auto-detection** (Vite, Webpack, Next.js, Parcel, Laravel Mix)
@@ -148,20 +185,38 @@ 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
 
 ### Step 3: Start Testing
+
+**Simple page capture:**
 ```bash
-# Test real application behavior
-cursorflow test --base-url http://localhost:3000 --path "/dashboard"
+cursorflow test --base-url http://localhost:3000 --path /dashboard
+```
 
-# Get complete intelligence with custom actions
+**Interactive testing with inline actions:**
+```bash
+cursorflow test --base-url http://localhost:3000 \
+  --path /messages \
+  --wait-for ".message-item" \
+  --hover ".message-item:first-child" \
+  --click ".message-item:first-child" \
+  --screenshot "clicked" \
+  --show-console \
+  --open-trace
+```
+
+**Custom actions with JSON:**
+```bash
 cursorflow test --base-url http://localhost:3000 --actions '[
   {"navigate": "/login"},
   {"fill": {"selector": "#email", "value": "test@example.com"}},

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

@@ -37,20 +37,57 @@ When CursorFlow reports `"average_response_time": 416.58ms`, you can tell stakeh
 
 **Documentary vs Movie:** Both are valuable, but if you're trying to understand reality, you watch the documentary. CursorFlow is the documentary of web testing.
 
+## 🎯 Pass-Through Architecture
+
+CursorFlow doesn't limit you - it exposes the full power of Playwright:
+
+**94+ Playwright actions available:**
+```bash
+# Any Playwright Page method works
+cursorflow test --actions '[
+  {"hover": ".menu"},
+  {"dblclick": ".editable"},
+  {"press": "Enter"},
+  {"drag_and_drop": {"source": ".item", "target": ".zone"}},
+  {"check": "#checkbox"},
+  {"evaluate": "window.scrollTo(0, 500)"}
+]'
+```
+
+**Full configuration pass-through:**
+```json
+{
+  "browser_config": {
+    "browser_launch_options": {"devtools": true, "channel": "chrome"}
+  },
+  "context_options": {
+    "color_scheme": "dark",
+    "geolocation": {"latitude": 40.7128, "longitude": -74.0060},
+    "timezone_id": "America/Los_Angeles"
+  }
+}
+```
+
+**Forward-compatible:** New Playwright features work immediately without CursorFlow updates.
+
+**See:** [Playwright API Documentation](https://playwright.dev/python/docs/api/class-page)
+
+---
+
 ## 🚀 Complete Page Intelligence
 
-Every screenshot captures everything your AI needs to make intelligent decisions:
+Every test captures everything needed for debugging:
 
 ### **📊 Comprehensive Data Collection**
-- **DOM**: All elements with 7 selector strategies each
-- **Network**: All requests, responses, and complete response bodies  
-- **Console**: All logs, errors, and smart error correlation
-- **Performance**: Load times, memory usage, with reliability indicators
-- **Visual**: Screenshots with pixel-perfect comparisons and enhanced options
-- **Fonts**: Loading status, performance, and usage analysis
-- **Animations**: Active animations and transitions tracking
-- **Resources**: Complete resource loading analysis
-- **Storage**: localStorage, sessionStorage, cookies, IndexedDB state
+- **DOM**: All elements with 7 selector strategies + event handlers
+- **Network**: Requests, responses, and complete request/response bodies  
+- **Console**: All logs, errors, warnings - displayed prominently
+- **JavaScript**: Global functions, variables, specific window objects
+- **Storage**: localStorage, sessionStorage, cookies (sensitive data masked)
+- **Forms**: All field values at capture time (passwords masked)
+- **Performance**: Load times, memory usage, reliability indicators
+- **Visual**: Screenshots with comprehensive page analysis
+- **Sessions**: Save/restore browser state for authenticated testing
 
 ### **🔄 Hot Reload Intelligence**
 - **Framework auto-detection** (Vite, Webpack, Next.js, Parcel, Laravel Mix)
@@ -103,20 +140,38 @@ 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
 
 ### Step 3: Start Testing
+
+**Simple page capture:**
 ```bash
-# Test real application behavior
-cursorflow test --base-url http://localhost:3000 --path "/dashboard"
+cursorflow test --base-url http://localhost:3000 --path /dashboard
+```
 
-# Get complete intelligence with custom actions
+**Interactive testing with inline actions:**
+```bash
+cursorflow test --base-url http://localhost:3000 \
+  --path /messages \
+  --wait-for ".message-item" \
+  --hover ".message-item:first-child" \
+  --click ".message-item:first-child" \
+  --screenshot "clicked" \
+  --show-console \
+  --open-trace
+```
+
+**Custom actions with JSON:**
+```bash
 cursorflow test --base-url http://localhost:3000 --actions '[
   {"navigate": "/login"},
   {"fill": {"selector": "#email", "value": "test@example.com"}},

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

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

{cursorflow-2.1.5 → cursorflow-2.2.0}/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                                         ║
 ║                                                                 ║