cursorflow 2.7.2__py3-none-any.whl → 2.7.3__py3-none-any.whl

cursorflow/cli.py

@@ -337,9 +337,6 @@ def test(base_url, path, actions, output, logs, config, verbose, headless, timeo
         with open(last_test_file, 'w') as f:
             json.dump(last_test_data, f, indent=2, default=str)
         
-        console.print(f"💾 Full results saved to: [cyan]{output}[/cyan]")
-        console.print(f"📁 Artifacts stored in: [cyan].cursorflow/artifacts/[/cyan]")
-        
         # Phase 3.4: Auto-open trace
         if open_trace and 'artifacts' in results and 'trace' in results['artifacts']:
             trace_path = results['artifacts']['trace']

cursorflow/rules/cursorflow-usage.mdc

@@ -6,6 +6,115 @@ alwaysApply: true
 
 # CursorFlow Usage Rules for Cursor AI
 
+## 🎯 **AI AGENT QUICK START - Read This First**
+
+### Instant Decision Tree
+
+**User reports error?**
+→ `cursorflow test --base-url URL --path /page`
+→ `cat .cursorflow/artifacts/sessions/session_XXX/data_digest.md`
+→ `cursorflow query session_XXX --errors --with-server-logs --with-network`
+→ Analyze correlated data, make fix
+
+**User wants CSS/styling change?**
+→ Python API: `css_iteration_persistent()`
+→ Test 2-3 CSS variations
+→ Apply best result
+
+**User reports slow page?**
+→ `cursorflow query session_XXX --network --over 500ms`
+→ `cursorflow query session_XXX --performance`
+→ Identify bottlenecks
+
+**User debugging network failure?**
+→ `cursorflow query session_XXX --network --failed --with-errors`
+→ See errors that happened around network failure
+→ `cursorflow query session_XXX --server-logs --pattern "api"`
+
+---
+
+## 🔍 **Common Debugging Patterns - Copy These**
+
+### Pattern 1: "Page has JavaScript error"
+```bash
+# 1. Capture current state
+cursorflow test --base-url http://localhost:3000 --path /page
+
+# 2. Get error context
+cursorflow query session_XXX --errors --export markdown
+
+# 3. Find what triggered it
+cursorflow query session_XXX --context-for-error 0 --window 10
+
+# 4. Check server logs
+cursorflow query session_XXX --server-logs --level error
+```
+
+### Pattern 2: "API call failing"
+```bash
+# 1. Find failed request
+cursorflow query session_XXX --network --failed
+
+# 2. Get full context
+cursorflow query session_XXX --network --url-contains "/api/" --with-errors
+
+# 3. Check server side
+cursorflow query session_XXX --server-logs --pattern "api" --level error
+```
+
+### Pattern 3: "Feature broken after deployment"
+```bash
+# 1. Test current version
+cursorflow test --base-url https://staging.com --path /feature
+
+# 2. Compare with baseline
+cursorflow query session_new --compare-with session_baseline --errors
+cursorflow query session_new --compare-with session_baseline --network
+
+# 3. Identify regressions
+# Shows: new_errors, fixed_errors, timing_changes
+```
+
+### Pattern 4: "Element not visible/clickable"
+```bash
+# 1. Inspect element
+cursorflow inspect --base-url URL --path /page --selector ".element"
+
+# 2. Query DOM
+cursorflow query session_XXX --dom --selector ".element"
+
+# 3. Check if hidden
+cursorflow query session_XXX --dom --visible
+```
+
+### Pattern 5: "Slow page load"
+```bash
+# 1. Find slow requests
+cursorflow query session_XXX --network --over 1000ms
+
+# 2. Group by URL
+cursorflow query session_XXX --group-by-url "/api/slow"
+
+# 3. Check performance
+cursorflow query session_XXX --performance
+```
+
+---
+
+## 💡 **What Each Query Reveals - AI Agent Guide**
+
+**`--errors`** → Error message, source file, line number, stack trace  
+**`--errors --with-network`** → Errors + network requests within ±5s (find API failures)  
+**`--errors --with-server-logs`** → Errors + backend logs (complete picture)  
+**`--network --failed`** → All 4xx/5xx responses with headers and timing  
+**`--network --over 500ms`** → Slow requests (bottleneck identification)  
+**`--server-logs --level error`** → Backend errors with timestamps  
+**`--context-for-error 0`** → Everything within ±5s of error (deep debugging)  
+**`--group-by-url "/api/X"`** → All data for specific endpoint  
+**`session_A --compare-with session_B`** → New/fixed errors, timing changes
+
+---
+
 ## 🔥 **CursorFlow: AI-Native Testing with Optimized Output**
 
 **CursorFlow v2.7.0 provides comprehensive data collection + AI-optimized output:**

{cursorflow-2.7.2.dist-info → cursorflow-2.7.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.7.2
+Version: 2.7.3
 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
@@ -256,6 +256,77 @@ cursorflow query session_A --compare-with session_B --errors
 
 ---
 
+## 🤖 **For AI Agents: Start Here**
+
+### 3-Second Decision Guide
+
+| User Says | Command | What You Get |
+|-----------|---------|--------------|
+| "Debug this error" | `cursorflow test` → `query session_X --errors --with-network` | Error + network + server logs correlated |
+| "Fix this CSS" | Python: `css_iteration_persistent()` | Visual comparison of CSS variations |
+| "Why is this slow?" | `query session_X --network --over 500ms` | Slow requests identified |
+| "Test login flow" | `cursorflow test --actions '[...]'` | Complete flow with server correlation |
+
+### Complete Debugging Example
+
+```bash
+# User: "There's a JavaScript error on the dashboard"
+
+# 1. Capture (5 seconds)
+cursorflow test --base-url http://localhost:3000 --path /dashboard
+
+# 2. Diagnose (10 seconds)
+cat .cursorflow/artifacts/sessions/session_XXX/data_digest.md
+cursorflow query session_XXX --errors
+
+# 3. Get context (5 seconds)
+cursorflow query session_XXX --context-for-error 0 --export markdown
+
+# 4. Fix based on correlated data
+# (You now have: error message, stack trace, network requests, server logs)
+```
+
+**Total time: 20 seconds from problem to actionable diagnosis**
+
+### When User Mentions...
+
+**"Error", "Broken", "Not working"**
+1. `cursorflow test` to capture
+2. `query --errors` to identify
+3. `query --context-for-error` to understand
+4. Fix based on correlated data
+
+**"Slow", "Performance", "Takes forever"**
+1. `cursorflow test` to baseline
+2. `query --network --over 500ms` to find bottlenecks
+3. `query --performance` for metrics
+4. Optimize slow requests
+
+**"CSS", "Styling", "Layout", "Spacing"**
+1. Python API: `css_iteration_persistent()`
+2. Test 2-3 CSS approaches
+3. Compare screenshots
+4. Apply best result
+
+**"Login", "Auth", "Session"**
+1. `cursorflow test --actions '[...]'` with login flow
+2. `--save-session` to preserve auth
+3. `--use-session` for subsequent tests
+4. Check auth errors with `query --errors --contains "auth"`
+
+**"Responsive", "Mobile", "Tablet"**
+1. `cursorflow test --responsive`
+2. `query --responsive --viewport mobile`
+3. Compare viewport results
+4. Fix mobile-specific issues
+
+**"Compare", "Regression", "What changed"**
+1. `query session_before --compare-with session_after`
+2. Focus on `new_errors` and `timing_changes`
+3. Investigate specific regressions
+
+---
+
 ## 🚀 Quick Start
 
 ### Step 1: Install CursorFlow Package

{cursorflow-2.7.2.dist-info → cursorflow-2.7.3.dist-info}/RECORD

@@ -1,7 +1,7 @@
 cursorflow/__init__.py,sha256=2V9xzG2tYxVWOTmSw2v9Jdbr7lSrMi_y2SMUMuNZdvw,2990
 cursorflow/auto_init.py,sha256=dXQaXXiXe4wkUP-jd8fcJ5fYVt7ASdTb47b7SzXymOM,6122
 cursorflow/auto_updater.py,sha256=oQ12TIMZ6Cm3HF-x9iRWFtvOLkRh-JWPqitS69-4roE,7851
-cursorflow/cli.py,sha256=jU-jEqFZUWngSYv-sNPxF7nn_hYZ4-K0TJsqucRPMmM,80268
+cursorflow/cli.py,sha256=5uObhh0ggolMX9DBHtQ8F74ewpzEcUxj9XkwoWyfCBA,80095
 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
@@ -33,10 +33,10 @@ cursorflow/log_sources/local_file.py,sha256=GVnhsaifIdc41twXwbxRM9-fBeRDsknDpk5I
 cursorflow/log_sources/ssh_remote.py,sha256=_Kwh0bhRpKgq-0c98oaX2hN6h9cT-wCHlqY5NiWVCoY,8388
 cursorflow/rules/__init__.py,sha256=gPcA-IkhXj03sl7cvZV0wwo7CtEkcyuKs4y0F5oQbqE,458
 cursorflow/rules/cursorflow-installation.mdc,sha256=D55pzzDPAVVbE3gAtKPUGoT-2fvB-FI2l6yrTdzUIEo,10208
-cursorflow/rules/cursorflow-usage.mdc,sha256=e5l9sKtrkphRSOfqZTN7fvTvzPNoBAuVyCxFpAJ4uYY,31403
-cursorflow-2.7.2.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-2.7.2.dist-info/METADATA,sha256=seQbf_TZ742n1ZTROhD8lWvzpor0Fams1xLjoJeRE7Q,17538
-cursorflow-2.7.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-2.7.2.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-2.7.2.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-2.7.2.dist-info/RECORD,,
+cursorflow/rules/cursorflow-usage.mdc,sha256=OYsqF1OKeGP5Bl8yR5TJ92dDXH7C3yp-SKAs9aZfBAw,34744
+cursorflow-2.7.3.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.7.3.dist-info/METADATA,sha256=J4eWtDeDZ2xaXpLgk9th-ku0Ysmalil-vcjICY8C9D0,19844
+cursorflow-2.7.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.7.3.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.7.3.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.7.3.dist-info/RECORD,,