cursorflow 2.2.3__tar.gz → 2.2.4__tar.gz

{cursorflow-2.2.3 → cursorflow-2.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.2.3
+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.3 → cursorflow-2.2.4}/README.md

@@ -74,6 +74,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 → cursorflow-2.2.4}/cursorflow/__init__.py

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

{cursorflow-2.2.3 → cursorflow-2.2.4}/cursorflow/cli.py

@@ -913,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-2.2.3 → cursorflow-2.2.4}/pyproject.toml

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