cursorflow 2.7.8__tar.gz → 2.7.9__tar.gz

{cursorflow-2.7.8 → cursorflow-2.7.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.7.8
+Version: 2.7.9
 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
@@ -184,6 +184,7 @@ cursorflow test --use-session "user" \
 # Capture SSO auth (opens browser for manual login)
 cursorflow capture-auth --base-url http://localhost:3000 \
   --path /dashboard \
+  --browser chrome \
   --output google-sso.json
 
 # Use captured auth
@@ -191,6 +192,8 @@ cursorflow capture-auth --base-url http://localhost:3000 \
 cursorflow test --use-session "sso-user" --path /dashboard
 ```
 
+**Tip:** Use `--browser chrome` on macOS for better window visibility
+
 **See:** [Complete Authentication Guide](docs/user/USAGE_GUIDE.md#authentication--session-management)
 
 ---

{cursorflow-2.7.8 → cursorflow-2.7.9}/README.md

@@ -139,6 +139,7 @@ cursorflow test --use-session "user" \
 # Capture SSO auth (opens browser for manual login)
 cursorflow capture-auth --base-url http://localhost:3000 \
   --path /dashboard \
+  --browser chrome \
   --output google-sso.json
 
 # Use captured auth
@@ -146,6 +147,8 @@ cursorflow capture-auth --base-url http://localhost:3000 \
 cursorflow test --use-session "sso-user" --path /dashboard
 ```
 
+**Tip:** Use `--browser chrome` on macOS for better window visibility
+
 **See:** [Complete Authentication Guide](docs/user/USAGE_GUIDE.md#authentication--session-management)
 
 ---

{cursorflow-2.7.8 → cursorflow-2.7.9}/cursorflow/cli.py

@@ -1121,7 +1121,8 @@ def sessions(subcommand, name):
 @click.option('--path', '-p', default='/', help='Path to navigate to after login (e.g., /dashboard)')
 @click.option('--output', '-o', default='auth-capture.json', help='Output file for captured auth state')
 @click.option('--wait', type=int, default=60, help='Seconds to wait for manual login (default: 60)')
-def capture_auth(base_url, path, output, wait):
+@click.option('--browser', type=click.Choice(['chromium', 'chrome', 'firefox']), default='chromium', help='Browser to use (default: chromium)')
+def capture_auth(base_url, path, output, wait, browser):
     """
     Capture authentication state after manual SSO/OAuth login
     
@@ -1143,25 +1144,30 @@ def capture_auth(base_url, path, output, wait):
       # Capture Google SSO auth
       cursorflow capture-auth --base-url http://localhost:3000 --path /dashboard
       
+      # Use system Chrome (more visible on macOS)
+      cursorflow capture-auth -u http://localhost:3000 --browser chrome
+      
       # Capture with custom wait time
       cursorflow capture-auth -u http://localhost:3000 -p /dashboard --wait 120
       
       # Save to custom file
       cursorflow capture-auth -u http://localhost:3000 --output google-sso.json
     """
-    console.print(f"\n🔐 SSO Authentication Capture")
+    console.print(f"\n🔐 [bold]SSO Authentication Capture[/bold]")
     console.print(f"📍 Base URL: [cyan]{base_url}[/cyan]")
     console.print(f"🎯 Target path: [cyan]{path}[/cyan]")
     console.print(f"⏱️  Wait time: [yellow]{wait}[/yellow] seconds")
     console.print(f"📄 Output file: [green]{output}[/green]\n")
     
-    console.print("📋 [bold]Instructions:[/bold]")
-    console.print("  1. Browser will open to your application")
-    console.print("  2. [yellow]Complete SSO login manually[/yellow] (Google, Microsoft, Okta, etc.)")
+    console.print("📋 [bold yellow]Instructions:[/bold yellow]")
+    console.print("  1. [bold]A Chromium browser window will open[/bold]")
+    console.print("  2. [yellow]Complete SSO login manually[/yellow] in that browser window")
     console.print("  3. Navigate to a protected page (e.g., /dashboard)")
-    console.print("  4. [green]Press Enter[/green] when fully logged in")
+    console.print("  4. Return here and [green]press Enter[/green] when fully logged in")
     console.print("  5. CursorFlow will capture all auth state\n")
     
+    console.print("[bold red]⚠️  Look for the browser window - it may open behind other windows![/bold red]\n")
+    
     input("Press Enter to open browser and start capture...")
     
     try:
@@ -1169,14 +1175,53 @@ def capture_auth(base_url, path, output, wait):
         import json
         
         async def capture_process():
+            console.print("\n🚀 Starting Playwright...")
             async with async_playwright() as p:
+                # Select browser based on user choice
+                if browser == 'chrome':
+                    browser_type = p.chromium
+                    channel = 'chrome'  # Use system Chrome if available
+                elif browser == 'firefox':
+                    browser_type = p.firefox
+                    channel = None
+                else:  # chromium
+                    browser_type = p.chromium
+                    channel = None
+                
                 # Launch browser in HEADED mode (user needs to interact)
-                browser = await p.chromium.launch(headless=False)
-                context = await browser.new_context()
+                console.print(f"🌐 Launching [bold]{browser}[/bold] browser (headed mode)...")
+                console.print("[yellow]👀 Watch for browser window - it should appear shortly...[/yellow]")
+                
+                try:
+                    launch_options = {
+                        'headless': False,
+                        'slow_mo': 50,
+                        'args': ['--start-maximized']
+                    }
+                    if channel:
+                        launch_options['channel'] = channel
+                    
+                    browser_instance = await browser_type.launch(**launch_options)
+                except Exception as e:
+                    console.print(f"[red]❌ Failed to launch browser: {e}[/red]")
+                    console.print("\n💡 Try installing Chromium:")
+                    console.print("   [cyan]playwright install chromium[/cyan]")
+                    raise
+                
+                # Create context with viewport to ensure it's visible
+                context = await browser_instance.new_context(
+                    viewport={'width': 1280, 'height': 720}
+                )
                 page = await context.new_page()
                 
-                console.print(f"\n🌐 Opening browser to: [cyan]{base_url}[/cyan]")
+                # Bring page to front
+                await page.bring_to_front()
+                
+                console.print(f"\n✅ [bold green]Browser window opened![/bold green]")
+                console.print(f"   👉 [bold]If you don't see it, check behind other windows or different desktop spaces[/bold]")
+                console.print(f"\n🌐 Navigating to: [cyan]{base_url}[/cyan]...")
                 await page.goto(base_url)
+                console.print(f"✅ Page loaded!")
                 
                 console.print(f"\n⏳ [yellow]Complete your SSO login in the browser...[/yellow]")
                 console.print(f"   Waiting up to {wait} seconds...")
@@ -1259,7 +1304,7 @@ def capture_auth(base_url, path, output, wait):
                 console.print(f'\n  {{\n    "auth": {{\n      "method": "cookies",\n      "cookies": [... paste here ...]\n    }}\n  }}\n')
                 console.print(f"  4. Test with: [cyan]cursorflow test --use-session sso-user[/cyan]\n")
                 
-                await browser.close()
+                await browser_instance.close()
         
         asyncio.run(capture_process())
         

{cursorflow-2.7.8 → cursorflow-2.7.9}/cursorflow/rules/cursorflow-usage.mdc

@@ -1084,9 +1084,11 @@ cursorflow test --actions '[
 # 1. Capture SSO auth (opens browser, you login manually)
 cursorflow capture-auth --base-url http://localhost:3000 \
   --path /dashboard \
+  --browser chrome \
   --output google-sso.json
 
-# Browser opens, you complete SSO login, CursorFlow captures cookies
+# Browser opens (use --browser chrome for better visibility on macOS)
+# You complete SSO login, CursorFlow captures cookies
 
 # 2. Copy cookies from google-sso.json to .cursorflow/config.json:
 {

{cursorflow-2.7.8 → cursorflow-2.7.9}/docs/user/USAGE_GUIDE.md

@@ -1056,6 +1056,31 @@ Clicked submit: button[type='submit']
 cat .cursorflow/sessions/test_session.json | python3 -m json.tool
 ```
 
+**Problem: "Browser not appearing" (capture-auth)**
+
+**Solution:**
+
+The browser IS launching but may be hidden by macOS window management:
+
+1. **Use system Chrome** (more visible):
+```bash
+cursorflow capture-auth --base-url http://localhost:3000 \
+  --browser chrome \
+  --path /dashboard
+```
+
+2. **Check all desktop spaces**: 
+   - Press F3 or swipe up with 3 fingers (Mission Control)
+   - Look for Chromium/Chrome window
+
+3. **Check your Dock**:
+   - Look for Chromium icon that appeared
+   - Click to bring window forward
+
+4. **Verify browser launched**:
+   - Look for "✅ Browser opened!" in terminal output
+   - If you see this, browser is running somewhere
+
 ---
 
 #### **Advanced Authentication Scenarios**
@@ -1161,6 +1186,12 @@ cursorflow capture-auth --base-url http://localhost:3000 \
   --path /dashboard \
   --output sso-auth.json
 
+# Use system Chrome for better visibility (recommended for macOS)
+cursorflow capture-auth --base-url http://localhost:3000 \
+  --path /dashboard \
+  --browser chrome \
+  --output sso-auth.json
+
 # This opens a browser, lets you login, then captures:
 # - All cookies (including third-party cookies if needed)
 # - localStorage state
@@ -1168,6 +1199,18 @@ cursorflow capture-auth --base-url http://localhost:3000 \
 # - Any tokens or auth data
 ```
 
+**Command Options:**
+- `--base-url`: Your application URL
+- `--path`: Page to navigate to after login (default: `/`)
+- `--output`: File to save auth state (default: `auth-capture.json`)
+- `--browser`: Browser to use - `chromium`, `chrome`, or `firefox` (default: `chromium`)
+- `--wait`: Maximum seconds to wait for login (default: `60`)
+
+**Browser Visibility:**
+- Use `--browser chrome` on macOS for better window visibility
+- Browser opens maximized in headed mode
+- If you don't see it, check other desktop spaces or behind windows
+
 **Step 3: Use captured auth in config**
 ```json
 {

{cursorflow-2.7.8 → cursorflow-2.7.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cursorflow"
-version = "2.7.8"
+version = "2.7.9"
 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"}