cursorflow 2.2.3__py3-none-any.whl → 2.2.5__py3-none-any.whl

cursorflow/__init__.py

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

cursorflow/cli.py

@@ -913,6 +913,120 @@ 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')
+@click.option('--yes', '-y', is_flag=True, help='Skip confirmation prompt (for automation)')
+def cleanup(artifacts, sessions, old_only, clean_all, dry_run, yes):
+    """
+    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 (skip if --yes flag or non-interactive)
+    import sys
+    if not yes and sys.stdin.isatty():
+        response = input("\n❓ Proceed with cleanup? [y/N]: ").strip().lower()
+        if response != 'y':
+            console.print("❌ Cleanup cancelled")
+            return
+    elif not yes and not sys.stdin.isatty():
+        # Non-interactive but no --yes flag
+        console.print("[yellow]⚠️  Non-interactive mode detected but no --yes flag[/yellow]")
+        console.print("Add --yes to cleanup command for autonomous operation")
+        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-2.2.3.dist-info → cursorflow-2.2.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.2.3
+Version: 2.2.5
 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.3.dist-info → cursorflow-2.2.5.dist-info}/RECORD

@@ -1,7 +1,7 @@
-cursorflow/__init__.py,sha256=x8fOUcON6ZcxoWYy_Yut_iNdcNLasE3Kb2sanysnmMk,2763
+cursorflow/__init__.py,sha256=oM_cHtshPNDQ881zI8Z96rpIpWLCe5p6zuJK8N75VcA,2763
 cursorflow/auto_init.py,sha256=dXQaXXiXe4wkUP-jd8fcJ5fYVt7ASdTb47b7SzXymOM,6122
 cursorflow/auto_updater.py,sha256=oQ12TIMZ6Cm3HF-x9iRWFtvOLkRh-JWPqitS69-4roE,7851
-cursorflow/cli.py,sha256=2e1582m3QBqNlrfEDYN2_7UETWxxJZHU8XXGQS0q9Rw,45348
+cursorflow/cli.py,sha256=t3acnfJSdc4tWCzraioR-JDMgxU19IZ3pY6IZvB7e18,50329
 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
@@ -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.3.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-2.2.3.dist-info/METADATA,sha256=N7WonXzbDp99DIxqDLQTbxc_iITk2GlSPb2XhOjXfH4,14014
-cursorflow-2.2.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-2.2.3.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-2.2.3.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-2.2.3.dist-info/RECORD,,
+cursorflow-2.2.5.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.2.5.dist-info/METADATA,sha256=a3FTj3fVs3k0pGEwfbKUo_MhWHYi8l9osy5oQc2W7mE,14520
+cursorflow-2.2.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.2.5.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.2.5.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.2.5.dist-info/RECORD,,