cursorflow 2.2.5__tar.gz → 2.2.7__tar.gz

{cursorflow-2.2.5 → cursorflow-2.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.2.5
+Version: 2.2.7
 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
@@ -140,7 +140,7 @@ cursorflow cleanup --all
 cursorflow cleanup --all --dry-run
 ```
 
-**See:** [Artifact Cleanup Guide](docs/user/ARTIFACT_CLEANUP_GUIDE.md)
+**See:** [Complete Usage Guide](docs/user/USAGE_GUIDE.md#artifact-management)
 
 ---
 
@@ -157,7 +157,7 @@ Every test captures everything needed for debugging:
 - **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
+- **Sessions**: Save/restore authenticated browser state (requires auth_config)
 
 ### **🔄 Hot Reload Intelligence**
 - **Framework auto-detection** (Vite, Webpack, Next.js, Parcel, Laravel Mix)

{cursorflow-2.2.5 → cursorflow-2.2.7}/README.md

@@ -95,7 +95,7 @@ cursorflow cleanup --all
 cursorflow cleanup --all --dry-run
 ```
 
-**See:** [Artifact Cleanup Guide](docs/user/ARTIFACT_CLEANUP_GUIDE.md)
+**See:** [Complete Usage Guide](docs/user/USAGE_GUIDE.md#artifact-management)
 
 ---
 
@@ -112,7 +112,7 @@ Every test captures everything needed for debugging:
 - **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
+- **Sessions**: Save/restore authenticated browser state (requires auth_config)
 
 ### **🔄 Hot Reload Intelligence**
 - **Framework auto-detection** (Vite, Webpack, Next.js, Parcel, Laravel Mix)

{cursorflow-2.2.5 → cursorflow-2.2.7}/cursorflow/__init__.py

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

{cursorflow-2.2.5 → cursorflow-2.2.7}/cursorflow/cli.py

@@ -81,9 +81,9 @@ def main(ctx):
 @click.option('--responsive', is_flag=True,
               help='Test across multiple viewports (mobile, tablet, desktop)')
 @click.option('--save-session', '-S',
-              help='Save browser session state with this name for later reuse')
+              help='Save authenticated session state (requires auth_config in .cursorflow/config.json)')
 @click.option('--use-session', '-U',
-              help='Restore and use a previously saved session')
+              help='Restore authenticated session state (requires auth_config in .cursorflow/config.json)')
 @click.option('--wait-for', '-w',
               help='Wait for selector to appear before continuing')
 @click.option('--wait-timeout', type=int, default=30,
@@ -194,7 +194,7 @@ def test(base_url, path, actions, output, logs, config, verbose, headless, timeo
         # Simple path navigation
         test_actions = [
             {"navigate": path},
-            {"wait_for": "body"},
+            {"wait_for_selector": "body"},
             {"screenshot": "page_loaded"}
         ]
         console.print(f"📋 Using simple path navigation to [cyan]{path}[/cyan]")
@@ -202,7 +202,7 @@ def test(base_url, path, actions, output, logs, config, verbose, headless, timeo
         # Default actions - just navigate to root and screenshot
         test_actions = [
             {"navigate": "/"},
-            {"wait_for": "body"},
+            {"wait_for_selector": "body"},
             {"screenshot": "baseline"}
         ]
         console.print(f"📋 Using default actions (navigate to root + screenshot)")
@@ -1087,12 +1087,12 @@ def _display_test_results(results: Dict, test_description: str, show_console: bo
     console.print(f"\n📊 Captured:")
     console.print(f"   • Elements: {len(comprehensive_data.get('dom_analysis', {}).get('elements', []))}")
     console.print(f"   • Network requests: {len(comprehensive_data.get('network_data', {}).get('all_network_events', []))}")
-    console.print(f"   • Console messages: {len(comprehensive_data.get('console_data', {}).get('console_logs', []))}")
+    console.print(f"   • Console messages: {len(comprehensive_data.get('console_data', {}).get('all_console_logs', []))}")
     console.print(f"   • Screenshots: {len(artifacts.get('screenshots', []))}")
     
     # Phase 4.1: Console messages display
     console_data = comprehensive_data.get('console_data', {})
-    console_logs = console_data.get('console_logs', [])
+    console_logs = console_data.get('all_console_logs', [])
     
     if console_logs and (show_console or show_all_console):
         errors = [log for log in console_logs if log.get('type') == 'error']

{cursorflow-2.2.5 → cursorflow-2.2.7}/cursorflow/core/browser_controller.py

@@ -1148,13 +1148,15 @@ class BrowserController:
             # v2.0 Enhancement: Resource loading analysis
             resource_analysis = await self._capture_resource_loading_analysis()
             
-            # v2.0 Enhancement: Storage state (read-only)
-            storage_analysis = await self._capture_storage_state()
+            # v2.2 Enhancement: Enhanced context capture
+            javascript_context = await self._capture_javascript_context()
+            storage_state = await self._capture_storage_state()  # This also serves as storage_analysis
+            form_state = await self._capture_form_state()
             
             # Create enhanced analysis summary
             analysis_summary = self._create_analysis_summary(
                 dom_analysis, network_data, console_data, performance_data,
-                font_analysis, animation_analysis, resource_analysis, storage_analysis
+                font_analysis, animation_analysis, resource_analysis, storage_state
             )
             
             return {
@@ -1171,7 +1173,7 @@ class BrowserController:
                 "font_analysis": font_analysis,
                 "animation_analysis": animation_analysis,
                 "resource_analysis": resource_analysis,
-                "storage_analysis": storage_analysis,
+                "storage_analysis": storage_state,  # v2.2 uses storage_state
                 
                 "analysis_summary": analysis_summary,
                 "capture_timestamp": time.time(),
@@ -2248,6 +2250,9 @@ class BrowserController:
     def _capture_console_data(self) -> Dict[str, Any]:
         """Capture comprehensive console log data"""
         try:
+            # Debug: Log console capture state
+            self.logger.debug(f"Capturing console data: {len(self.console_logs)} messages in buffer")
+            
             # Categorize console logs
             errors = [log for log in self.console_logs if log.get("type") == "error"]
             warnings = [log for log in self.console_logs if log.get("type") == "warning"]

{cursorflow-2.2.5 → cursorflow-2.2.7}/cursorflow/core/cursorflow.py

@@ -143,6 +143,19 @@ class CursorFlow:
             )
             summary = self.correlator.get_summary(organized_timeline)
             
+            # Capture comprehensive data if screenshots were taken
+            comprehensive_data = {}
+            if self.artifacts.get("screenshots"):
+                # Get comprehensive data from last screenshot
+                last_screenshot = self.artifacts["screenshots"][-1]
+                if "comprehensive_data_path" in last_screenshot:
+                    import json
+                    try:
+                        with open(last_screenshot["comprehensive_data_path"], 'r') as f:
+                            comprehensive_data = json.load(f)
+                    except Exception as e:
+                        self.logger.warning(f"Could not load comprehensive data: {e}")
+            
             # Package results
             results = {
                 "success": success,
@@ -152,7 +165,8 @@ class CursorFlow:
                 "browser_events": self.timeline,  # Raw browser events
                 "server_logs": server_logs,       # Raw server logs
                 "summary": summary,               # Basic counts
-                "artifacts": self.artifacts
+                "artifacts": self.artifacts,
+                "comprehensive_data": comprehensive_data  # Complete page intelligence
             }
             
             self.logger.info(f"Test execution completed: {success}, timeline events: {len(organized_timeline)}")

{cursorflow-2.2.5 → cursorflow-2.2.7}/cursorflow/core/log_collector.py

@@ -164,7 +164,11 @@ class LogCollector:
     async def _monitor_source(self, source):
         """Monitor a single log source"""
         try:
-            await source.connect()
+            # connect() returns bool, not awaitable - just call it
+            connected = await source.connect()
+            if not connected:
+                self.logger.warning(f"Log source {source} failed to connect")
+                return
             
             while self.monitoring:
                 try:

{cursorflow-2.2.5 → cursorflow-2.2.7}/cursorflow/log_sources/local_file.py

@@ -168,6 +168,10 @@ class LocalFileLogSource:
         """Connect to log sources - compatibility method for log_collector"""
         return await self.start_monitoring()
     
+    async def disconnect(self):
+        """Disconnect from log sources - compatibility method for log_collector"""
+        return await self.stop_monitoring()
+    
     async def get_new_entries(self) -> List[Dict]:
         """
         Get new log entries since last call (required interface method)

{cursorflow-2.2.5 → cursorflow-2.2.7}/cursorflow/log_sources/ssh_remote.py

@@ -165,6 +165,10 @@ class SSHRemoteLogSource:
         """Connect to SSH log sources - compatibility method for log_collector"""
         return await self.start_monitoring()
     
+    async def disconnect(self):
+        """Disconnect from SSH log sources - compatibility method for log_collector"""
+        return await self.stop_monitoring()
+    
     async def get_new_entries(self) -> List[Dict]:
         """
         Get new log entries since last call (required interface method)

{cursorflow-2.2.5 → cursorflow-2.2.7}/cursorflow/rules/cursorflow-usage.mdc

@@ -225,74 +225,69 @@ print(f"Performance metrics: {screenshot_data['performance_data']}")
 # Playwright trace available at: .cursorflow/artifacts/traces/session.zip
 ```
 
-## 🚀 **CursorFlow CLI Usage (v2.1.4)**
+## 🚀 **CursorFlow CLI Usage**
 
 ### **Basic Testing:**
 ```bash
-# Test any URL with comprehensive data capture
-cursorflow test --base-url http://localhost:3000 --path "/dashboard"
-
-# Test with custom actions
-cursorflow test \
-  --base-url http://localhost:3000 \
-  --actions '[
-    {"navigate": "/page"},
-    {"wait_for": "#element"},
-    {"screenshot": "state"}
-  ]'
-
-# 🆕 Parallel responsive testing (mobile, tablet, desktop)
-cursorflow test --base-url http://localhost:3000 --path "/dashboard" --responsive
-
-# 🆕 Enhanced screenshot options
-cursorflow test \
-  --base-url http://localhost:3000 \
-  --actions '[
-    {"navigate": "/page"},
-    {"screenshot": {
-      "name": "clipped-header",
-      "options": {
-        "clip": {"selector": "#header"},
-        "mask": [".user-email", ".sensitive-data"],
-        "full_page": false,
-        "quality": 90
-      }
-    }}
-  ]'
+# Simple page capture
+cursorflow test --base-url http://localhost:3000 --path /dashboard
+
+# Inline actions (no JSON needed)
+cursorflow test --base-url http://localhost:3000 \
+  --path /messages \
+  --wait-for ".message-item" \
+  --wait 2 \
+  --hover ".message-item:first-child" \
+  --click ".message-item:first-child" \
+  --screenshot "result" \
+  --show-console \
+  --open-trace
+
+# Custom actions with JSON
+cursorflow test --base-url http://localhost:3000 --actions '[
+  {"navigate": "/page"},
+  {"hover": ".menu"},
+  {"click": "#button"},
+  {"screenshot": "result"}
+]'
+```
 
-# Results include:
-# - Hot Reload Intelligence status
-# - Advanced Element Intelligence (7 selector types)
-# - Comprehensive Page Analysis (fonts, animations, resources)
-# - Enhanced Error Context (smart deduplication)
-# - Enhanced Browser Data (Playwright traces)
-# - 🆕 Parallel Viewport Analysis (responsive testing)
-# - 🆕 Enhanced Screenshot Metadata (options used)
+### **All CLI Commands:**
+```bash
+cursorflow test              # Test UI with comprehensive data capture
+cursorflow rerun             # Re-run last test
+cursorflow inspect           # Quick element inspection
+cursorflow count             # Count matching elements
+cursorflow timeline          # View event timeline
+cursorflow sessions          # Manage saved sessions
+cursorflow cleanup           # Clean artifacts (use --yes for autonomous)
+cursorflow install-rules     # Install Cursor rules (use --yes)
 ```
 
-### **Available CLI Commands:**
+### **Inline Action Flags:**
 ```bash
-cursorflow test              # Execute comprehensive UI test
-cursorflow compare-mockup    # Visual mockup comparison
-cursorflow iterate-mockup    # Iterative mockup matching
-cursorflow install-rules     # Install Cursor AI rules
-cursorflow update           # Update CursorFlow and dependencies
-cursorflow --help           # Show all commands and options
+--click ".selector"              # Click element
+--hover ".selector"              # Hover element
+--fill "#input=value"            # Fill form field
+--wait 2                         # Wait seconds
+--wait-for ".selector"           # Wait for element
+--wait-for-network-idle          # Wait for network idle
+--screenshot "name"              # Capture screenshot
+--show-console                   # Show console errors
+--open-trace                     # Auto-open Playwright trace
+--save-session "name"            # Save authenticated state (requires auth_config)
+--use-session "name"             # Restore authenticated state (requires auth_config)
 ```
 
-## Available Actions
-
-| Action | Syntax | Purpose |
-|--------|--------|---------|
-| `navigate` | `{"navigate": "/path"}` | Go to URL or path |
-| `click` | `{"click": "#selector"}` | Click element |
-| `fill` | `{"fill": {"selector": "#input", "value": "text"}}` | Fill form field |
-| `wait` | `{"wait": 2}` | Wait seconds |
-| `wait_for` | `{"wait_for": "#element"}` | Wait for element |
-| `screenshot` | `{"screenshot": "name"}` | Take basic screenshot |
-| 🆕 `screenshot` | `{"screenshot": {"name": "test", "options": {"clip": {"selector": "#header"}}}}` | Enhanced screenshot with clipping |
-| 🆕 `screenshot` | `{"screenshot": {"name": "test", "options": {"mask": [".sensitive"]}}}` | Screenshot with masked elements |
-| 🆕 `screenshot` | `{"screenshot": {"name": "test.jpg", "options": {"quality": 90}}}` | JPEG screenshot with quality |
+### **Available Actions (94+ via Pass-Through):**
+
+CursorFlow passes actions directly to Playwright - ANY Page method works:
+- `click`, `dblclick`, `hover`, `tap`, `press`
+- `fill`, `type`, `check`, `uncheck`, `select_option`
+- `focus`, `blur`, `drag_and_drop`
+- `wait_for_selector`, `wait_for_load_state`, `wait_for_timeout`
+- `goto`, `reload`, `evaluate`, `route`
+- And 80+ more: https://playwright.dev/python/docs/api/class-page
 
 ## Common Usage Patterns
 

{cursorflow-2.2.5 → cursorflow-2.2.7}/pyproject.toml

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