cursorflow 2.2.2__py3-none-any.whl → 2.2.4__py3-none-any.whl

cursorflow/__init__.py

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

cursorflow/cli.py

@@ -90,6 +90,8 @@ def main(ctx):
               help='Timeout in seconds for wait operations')
 @click.option('--wait-for-network-idle', is_flag=True,
               help='Wait for network to be idle (no requests for 2s)')
+@click.option('--wait', type=float,
+              help='Wait for specified seconds before continuing')
 @click.option('--click', multiple=True,
               help='Click element by selector (can specify multiple)')
 @click.option('--hover', multiple=True,
@@ -107,7 +109,7 @@ def main(ctx):
 @click.option('--quiet', '-q', is_flag=True,
               help='Minimal output, JSON results only')
 def test(base_url, path, actions, output, logs, config, verbose, headless, timeout, responsive, 
-         save_session, use_session, wait_for, wait_timeout, wait_for_network_idle, 
+         save_session, use_session, wait_for, wait_timeout, wait_for_network_idle, wait,
          click, hover, fill, screenshot, open_trace, show_console, show_all_console, quiet):
     """
     Test UI flows and interactions with real-time log monitoring
@@ -149,6 +151,8 @@ def test(base_url, path, actions, output, logs, config, verbose, headless, timeo
             test_actions.append({"navigate": path})
         
         # Wait options
+        if wait:
+            test_actions.append({"wait_for_timeout": int(wait * 1000)})
         if wait_for:
             test_actions.append({"wait_for_selector": wait_for})
         if wait_for_network_idle:
@@ -909,6 +913,114 @@ def timeline(session):
     except Exception as e:
         console.print(f"[red]❌ Failed to load timeline: {e}[/red]")
 
+@main.command()
+@click.option('--artifacts', is_flag=True, help='Clean all artifacts (screenshots, traces)')
+@click.option('--sessions', is_flag=True, help='Clean all saved sessions')
+@click.option('--old-only', is_flag=True, help='Only clean artifacts older than 7 days')
+@click.option('--all', 'clean_all', is_flag=True, help='Clean everything (artifacts, sessions, results)')
+@click.option('--dry-run', is_flag=True, help='Show what would be deleted without deleting')
+def cleanup(artifacts, sessions, old_only, clean_all, dry_run):
+    """
+    Clean up CursorFlow artifacts and data
+    
+    Examples:
+      cursorflow cleanup --artifacts              # Clean screenshots and traces
+      cursorflow cleanup --sessions               # Clean saved sessions
+      cursorflow cleanup --all                    # Clean everything
+      cursorflow cleanup --old-only --artifacts   # Clean old artifacts only
+      cursorflow cleanup --dry-run --all          # Preview what would be deleted
+    """
+    import shutil
+    from datetime import datetime, timedelta
+    
+    cursorflow_dir = Path('.cursorflow')
+    
+    if not cursorflow_dir.exists():
+        console.print("[yellow]⚠️  No .cursorflow directory found[/yellow]")
+        return
+    
+    total_size = 0
+    items_to_delete = []
+    
+    # Calculate cutoff time for old-only mode
+    cutoff_time = datetime.now() - timedelta(days=7) if old_only else None
+    
+    # Artifacts cleanup
+    if artifacts or clean_all:
+        artifacts_dir = cursorflow_dir / 'artifacts'
+        if artifacts_dir.exists():
+            for item in artifacts_dir.rglob('*'):
+                if item.is_file():
+                    # Check age if old-only mode
+                    if old_only:
+                        file_time = datetime.fromtimestamp(item.stat().st_mtime)
+                        if file_time > cutoff_time:
+                            continue
+                    
+                    size = item.stat().st_size
+                    total_size += size
+                    items_to_delete.append(('artifact', item, size))
+    
+    # Sessions cleanup
+    if sessions or clean_all:
+        sessions_dir = cursorflow_dir / 'sessions'
+        if sessions_dir.exists():
+            for session_dir in sessions_dir.iterdir():
+                if session_dir.is_dir():
+                    # Calculate session size
+                    session_size = sum(f.stat().st_size for f in session_dir.rglob('*') if f.is_file())
+                    total_size += session_size
+                    items_to_delete.append(('session', session_dir, session_size))
+    
+    # Display what will be deleted
+    if not items_to_delete:
+        console.print("✨ Nothing to clean - directory is already tidy!")
+        return
+    
+    console.print(f"\n📊 Cleanup Summary:")
+    console.print(f"   • Items to delete: {len(items_to_delete)}")
+    console.print(f"   • Total size: {total_size / 1024 / 1024:.2f} MB")
+    
+    # Show breakdown
+    artifact_count = sum(1 for t, _, _ in items_to_delete if t == 'artifact')
+    session_count = sum(1 for t, _, _ in items_to_delete if t == 'session')
+    
+    if artifact_count:
+        artifact_size = sum(s for t, _, s in items_to_delete if t == 'artifact')
+        console.print(f"   • Artifacts: {artifact_count} files ({artifact_size / 1024 / 1024:.2f} MB)")
+    if session_count:
+        session_size = sum(s for t, _, s in items_to_delete if t == 'session')
+        console.print(f"   • Sessions: {session_count} sessions ({session_size / 1024 / 1024:.2f} MB)")
+    
+    if dry_run:
+        console.print("\n🔍 Dry run - nothing deleted")
+        console.print("   Run without --dry-run to actually delete")
+        return
+    
+    # Confirm deletion
+    import sys
+    if sys.stdin.isatty():
+        response = input("\n❓ Proceed with cleanup? [y/N]: ").strip().lower()
+        if response != 'y':
+            console.print("❌ Cleanup cancelled")
+            return
+    
+    # Delete items
+    deleted_count = 0
+    for item_type, item_path, _ in items_to_delete:
+        try:
+            if item_path.is_dir():
+                shutil.rmtree(item_path)
+            else:
+                item_path.unlink()
+            deleted_count += 1
+        except Exception as e:
+            console.print(f"[red]⚠️  Failed to delete {item_path}: {e}[/red]")
+    
+    console.print(f"\n✅ Cleanup complete!")
+    console.print(f"   • Deleted {deleted_count}/{len(items_to_delete)} items")
+    console.print(f"   • Freed {total_size / 1024 / 1024:.2f} MB")
+
 @main.command()
 @click.argument('project_path')
 # Framework detection removed - CursorFlow is framework-agnostic

cursorflow/core/browser_controller.py

@@ -1313,7 +1313,7 @@ class BrowserController:
                                 const animInfo = {
                                     element_selector: element.tagName.toLowerCase() + 
                                         (element.id ? '#' + element.id : '') +
-                                        (element.className ? '.' + element.className.split(' ').join('.') : ''),
+                                        (element.className && typeof element.className === 'string' ? '.' + element.className.split(' ').join('.') : ''),
                                     animation_name: animation.animationName || 'transition',
                                     duration: animation.effect?.getTiming?.()?.duration || 0,
                                     delay: animation.effect?.getTiming?.()?.delay || 0,

{cursorflow-2.2.2.dist-info → cursorflow-2.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.2.2
+Version: 2.2.4
 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
@@ -119,6 +119,31 @@ cursorflow test --actions '[
 
 ---
 
+## 🧹 Artifact Management
+
+CursorFlow generates valuable debugging data (screenshots, traces, sessions). Manage disk space:
+
+```bash
+# Clean old artifacts (>7 days)
+cursorflow cleanup --artifacts --old-only
+
+# Clean all artifacts
+cursorflow cleanup --artifacts
+
+# Clean saved sessions
+cursorflow cleanup --sessions
+
+# Clean everything
+cursorflow cleanup --all
+
+# Preview before deleting
+cursorflow cleanup --all --dry-run
+```
+
+**See:** [Artifact Cleanup Guide](docs/user/ARTIFACT_CLEANUP_GUIDE.md)
+
+---
+
 ## 🚀 Complete Page Intelligence
 
 Every test captures everything needed for debugging:

{cursorflow-2.2.2.dist-info → cursorflow-2.2.4.dist-info}/RECORD

@@ -1,14 +1,14 @@
-cursorflow/__init__.py,sha256=UmNWQ3FzbteJbjMrv01dXJhSpgcA8UoReJsQO_fZAE8,2763
+cursorflow/__init__.py,sha256=knSM_hFobem45sngePIIKfT4BRRDdFlHApyJuCyWJLU,2763
 cursorflow/auto_init.py,sha256=dXQaXXiXe4wkUP-jd8fcJ5fYVt7ASdTb47b7SzXymOM,6122
 cursorflow/auto_updater.py,sha256=oQ12TIMZ6Cm3HF-x9iRWFtvOLkRh-JWPqitS69-4roE,7851
-cursorflow/cli.py,sha256=VYC_UJ0j3DggLUjNl82Q2dJNR_gWw-qWnIwRkSo3Oww,45151
+cursorflow/cli.py,sha256=wVjgZP0zScwQxuXaXemnh_pKCAzO5MFerO4Q4Rn3Wm8,49898
 cursorflow/install_cursorflow_rules.py,sha256=DsZ0680y9JMuTKFXjdgYtOKIEAjBMsdwL8LmA9WEb5A,11864
 cursorflow/post_install.py,sha256=WieBiKWG0qBAQpF8iMVWUyb9Fr2Xky9qECTMPrlAbpE,2678
 cursorflow/updater.py,sha256=SroSQHQi5cYyzcOK_bf-WzmQmE7yeOs8qo3r__j-Z6E,19583
 cursorflow/core/action_validator.py,sha256=SCk3w_62D1y0cCRDOajK8L44-abSj_KpnUBgR_yNVW4,6846
 cursorflow/core/agent.py,sha256=f3lecgEzDRDdGTVccAtorpLGfNJJ49bbsQAmgr0vNGg,10136
 cursorflow/core/auth_handler.py,sha256=oRafO6ZdxoHryBIvHsrNV8TECed4GXpJsdEiH0KdPPk,17149
-cursorflow/core/browser_controller.py,sha256=jA3zmdULJb4FLn3pS3zlK5RmbpRK8k4UVgwiVM6_pts,146990
+cursorflow/core/browser_controller.py,sha256=GLAdXP4JiMm27cNjpF_LyB8xV82Mo4_ZH56AC7hYpSs,147031
 cursorflow/core/browser_engine.py,sha256=7N9hPOyDrEhLWYgZW2981N9gKlHF6Lbp7D7h0zBzuz8,14851
 cursorflow/core/config_validator.py,sha256=HRtONSOmM0Xxt3-ok3xwnBADRiNnI0nNOMaS2OqOkDk,7286
 cursorflow/core/css_iterator.py,sha256=whLCIwbHZEWaH1HCbmqhNX5zrh_fL-r3hsxKjYsukcE,16478
@@ -30,9 +30,9 @@ cursorflow/log_sources/ssh_remote.py,sha256=kZRpLpiO7cLd67wlCiTvz4Prwx1_Vu3ytB5K
 cursorflow/rules/__init__.py,sha256=gPcA-IkhXj03sl7cvZV0wwo7CtEkcyuKs4y0F5oQbqE,458
 cursorflow/rules/cursorflow-installation.mdc,sha256=D55pzzDPAVVbE3gAtKPUGoT-2fvB-FI2l6yrTdzUIEo,10208
 cursorflow/rules/cursorflow-usage.mdc,sha256=hCbA9koCtRoeLOkB-PXmLlGzsag_15RuOveOE_R4JZ0,21628
-cursorflow-2.2.2.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-2.2.2.dist-info/METADATA,sha256=1_uK1v9xGrwRg7xn2a9eSMIrNmloYFBDMIE1qdR-9Ws,14014
-cursorflow-2.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-2.2.2.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-2.2.2.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-2.2.2.dist-info/RECORD,,
+cursorflow-2.2.4.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.2.4.dist-info/METADATA,sha256=bzgHTHdtixdH-KqgZBqVaaA2ZB_JAkI_tPmNikEL1jo,14520
+cursorflow-2.2.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.2.4.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.2.4.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.2.4.dist-info/RECORD,,