cursorflow 2.6.3__py3-none-any.whl → 2.7.1__py3-none-any.whl

cursorflow/rules/cursorflow-usage.mdc

@@ -6,17 +6,256 @@ alwaysApply: true
 
 # CursorFlow Usage Rules for Cursor AI
 
-## 🔥 **CursorFlow: Complete Page Intelligence for AI-Driven Development**
+## 🔥 **CursorFlow: AI-Native Testing with Optimized Output**
 
-**CursorFlow provides comprehensive data collection for rapid UI iteration:**
+**CursorFlow v2.7.0 provides comprehensive data collection + AI-optimized output:**
 
+- 🎯 **AI-Optimized Output** - Multi-file format, each <100K tokens (v2.7.0)
+- 🔍 **Query Interface** - Instant data extraction, no manual JSON parsing (v2.7.0)
 - 🔥 **Hot Reload Intelligence** - Auto-detects Vite, Webpack, Next.js, Parcel, Laravel Mix
 - 🧠 **Advanced Element Intelligence** - 7 selector strategies + accessibility analysis
 - 📊 **Comprehensive Page Analysis** - Fonts, animations, resources, storage state
-- 🎯 **Enhanced Error Context Collection** - Smart screenshot deduplication
-- ⚡ **Enhanced Browser Data Capture** - Playwright traces + network interception
-- 📱 **Parallel Viewport Testing** - Mobile, tablet, desktop responsive testing
-- 🖼️ **Enhanced Screenshot Options** - Clipping, masking, quality control
+- 🎯 **Enhanced Error Context** - Smart screenshot deduplication
+- ⚡ **Enhanced Browser Data** - Playwright traces + network interception
+
+## ⚡ **CRITICAL: Test Output Now AI-Readable (v2.7.0)**
+
+**Before v2.7.0:** Single 3.7M token JSON (exceeded AI context limits)  
+**After v2.7.0:** Organized multi-file structure, AI digest, query interface
+
+```bash
+# Test generates AI-optimized output automatically
+cursorflow test --base-url http://localhost:3000 --path /app --logs local
+
+# Output structure (ALL data types captured automatically):
+.cursorflow/artifacts/sessions/session_XXX/
+├── summary.json       # Core metrics (2-5KB, ~500 tokens)
+├── errors.json        # Console errors (10-50KB, ~8K tokens)
+├── network.json       # Network data (50-200KB, ~35K tokens)
+├── console.json       # Console messages (20-100KB)
+├── server_logs.json   # SERVER LOGS (SSH/local/Docker) ⭐
+├── dom_analysis.json  # DOM data (500KB-2MB, ~440K tokens)
+├── performance.json   # Performance metrics (10-30KB)
+├── timeline.json      # Event timeline (20-50KB)
+├── screenshots.json   # Screenshot metadata
+├── data_digest.md     # AI summary (10-20KB, ~3.5K tokens) ⭐
+└── screenshots/       # Visual artifacts
+
+# Optional data (if specific features used):
+├── mockup_comparison.json  # If compare-mockup used
+├── responsive_results.json # If --responsive used
+└── css_iterations.json     # If css_iteration_session used
+
+# WORKFLOW FOR AI AGENTS:
+# 1. Read data_digest.md first (instant overview - includes server logs!)
+# 2. Query specific data as needed
+# 3. Compare sessions for regression detection
+```
+
+## 🔍 **Query Interface - Use This Instead of Reading JSON**
+
+**Fast data extraction without manual parsing - ALL data types supported:**
+
+### Core Data Queries
+
+```bash
+# List recent sessions
+cursorflow query --list
+
+# Browser console errors
+cursorflow query session_123 --errors
+cursorflow query session_123 --errors --severity critical
+
+# Server logs (SSH/local/Docker/systemd)
+cursorflow query session_123 --server-logs
+cursorflow query session_123 --server-logs --level error,warning
+cursorflow query session_123 --server-logs --source ssh
+cursorflow query session_123 --server-logs --pattern "database"
+cursorflow query session_123 --server-logs --contains "timeout"
+
+# Network requests
+cursorflow query session_123 --network
+cursorflow query session_123 --network --failed
+cursorflow query session_123 --network --status 4xx,5xx
+
+# Console messages
+cursorflow query session_123 --console
+cursorflow query session_123 --console --type error,warning
+
+# Performance & summary
+cursorflow query session_123 --performance
+cursorflow query session_123 --summary
+```
+
+### Advanced Data Queries
+
+```bash
+# DOM analysis
+cursorflow query session_123 --dom --selector "button"
+
+# Screenshots
+cursorflow query session_123 --screenshots
+cursorflow query session_123 --screenshots --with-errors
+
+# Timeline events
+cursorflow query session_123 --timeline --around 1234567890
+
+# Responsive results (if used --responsive)
+cursorflow query session_123 --responsive --viewport mobile
+
+# Mockup comparison (if used compare-mockup)
+cursorflow query session_123 --mockup
+
+# CSS iterations (if used css_iteration_session)
+cursorflow query session_123 --css-iterations --iteration 3
+```
+
+### Export & Comparison
+
+```bash
+# Export formats
+cursorflow query session_123 --errors --export markdown
+cursorflow query session_123 --server-logs --export csv
+
+# Session comparison (regression detection)
+cursorflow query session_baseline --compare-with session_current
+cursorflow query session_A --compare-with session_B --errors
+cursorflow query session_A --compare-with session_B --server-logs
+```
+
+**AI Agent Workflow:**
+1. Run test: `cursorflow test ...`
+2. Read AI digest: `cat .cursorflow/artifacts/sessions/session_XXX/data_digest.md`
+3. Query details: `cursorflow query session_XXX --errors` or `--server-logs`
+4. Make decisions based on organized data
+
+### Enhanced Query Capabilities
+
+**Smart Filtering:**
+```bash
+# Filter errors by source/content/time
+cursorflow query session_XXX --errors --from-file "app.js"
+cursorflow query session_XXX --errors --contains "undefined"
+cursorflow query session_XXX --errors --matches "TypeError.*"
+
+# Filter network by URL/timing/method
+cursorflow query session_XXX --network --url-contains "/api/"
+cursorflow query session_XXX --network --over 500ms  # Slow requests
+cursorflow query session_XXX --network --method POST
+
+# Filter DOM by visibility/interaction
+cursorflow query session_XXX --dom --visible
+cursorflow query session_XXX --dom --interactive
+cursorflow query session_XXX --dom --role button
+```
+
+**Cross-Referencing (time-based correlation):**
+```bash
+# Errors with related data (±5s window)
+cursorflow query session_XXX --errors --with-network
+cursorflow query session_XXX --errors --with-server-logs
+cursorflow query session_XXX --network --failed --with-errors
+```
+
+**Contextual Queries:**
+```bash
+# Full context for error
+cursorflow query session_XXX --context-for-error 2 --window 10
+# Returns: Error + network/console/server logs within ±10s
+
+# Group by pattern
+cursorflow query session_XXX --group-by-url "/api/users"
+cursorflow query session_XXX --group-by-selector "#button"
+```
+
+**Enhanced Comparison:**
+```bash
+# Message-level comparison
+cursorflow query session_A --compare-with session_B --errors
+# Shows: new_errors, fixed_errors, frequency_changes
+```
+
+---
+
+## 📊 **Server Log Monitoring (AUTOMATIC CAPTURE)**
+
+**Server logs are captured automatically during every test** - correlated with browser events by timestamp for complete visibility.
+
+**Configuration (Python API):**
+```python
+# SSH Remote Logs
+flow = CursorFlow(
+    base_url="https://staging.example.com",
+    log_config={
+        "source": "ssh",
+        "ssh_config": {
+            "hostname": "staging-server",
+            "username": "deploy",
+            "key_file": "~/.ssh/staging_key"
+        },
+        "paths": ["/var/log/app/error.log", "/var/log/httpd/error_log"]
+    }
+)
+
+# Local Logs
+flow = CursorFlow(
+    base_url="http://localhost:3000",
+    log_config={
+        "source": "local",
+        "paths": ["logs/app.log", "logs/error.log"]
+    }
+)
+
+# Docker Logs
+flow = CursorFlow(
+    base_url="http://localhost:3000",
+    log_config={
+        "source": "docker",
+        "container_name": "app-container",
+        "paths": ["/var/log/app.log"]
+    }
+)
+```
+
+**Configuration (CLI via config file):**
+```json
+{
+  "environments": {
+    "staging": {
+      "base_url": "https://staging.example.com",
+      "logs": "ssh",
+      "ssh_config": {
+        "hostname": "staging-server",
+        "username": "deploy",
+        "key_file": "~/.ssh/staging_key"
+      },
+      "log_paths": {
+        "app_error": "/var/log/app/error.log",
+        "apache_error": "/var/log/httpd/error_log"
+      }
+    },
+    "local": {
+      "base_url": "http://localhost:3000",
+      "logs": "local",
+      "log_paths": {
+        "app": "logs/app.log"
+      }
+    }
+  }
+}
+```
+
+**CLI Usage:**
+```bash
+# Use configured log source
+cursorflow test --base-url http://localhost:3000 --logs local
+cursorflow test --base-url https://staging.example.com --logs ssh --config config.json
+
+# Server logs appear in results:
+# - server_logs.json (dedicated file)
+# - timeline.json (correlated with browser events)
+# - data_digest.md (server errors section)
+```
 
 ## When to Use CursorFlow
 

{cursorflow-2.6.3.dist-info → cursorflow-2.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cursorflow
-Version: 2.6.3
+Version: 2.7.1
 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
@@ -198,6 +198,64 @@ All data structured for AI consumption:
 - Error correlation with **smart screenshot deduplication**
 - Performance insights with **reliability metadata**
 
+## ✨ What's New in v2.7.1
+
+**AI-Optimized Output with Complete Data Type Coverage** - All CursorFlow features now organized for AI consumption:
+
+- **Multi-File Structure**: Split 3.7M token JSON → organized files under 100K tokens each
+- **Complete Coverage**: Browser console, server logs, network, DOM, screenshots - all queryable
+- **AI Data Digest**: Auto-generated markdown summary with server logs included
+- **Query Interface**: Fast data extraction for ALL data types without manual JSON parsing
+- **Session Comparison**: Compare test results to detect regressions
+- **Export Formats**: JSON, Markdown, CSV outputs for any use case
+
+```bash
+# Test generates AI-optimized output automatically
+cursorflow test --base-url http://localhost:3000 --path /app --logs local
+
+# Query ANY data type instantly
+cursorflow query session_123 --errors              # Console errors
+cursorflow query session_123 --server-logs         # Server logs
+cursorflow query session_123 --network --failed    # Network failures
+cursorflow query session_123 --screenshots         # Screenshot index
+cursorflow query session_123 --responsive          # Responsive results
+cursorflow query session_123 --css-iterations      # CSS iterations
+
+# Enhanced filtering
+cursorflow query session_123 --errors --from-file "app.js" --contains "undefined"
+cursorflow query session_123 --network --url-contains "/api/" --over 500ms
+cursorflow query session_123 --server-logs --level error --pattern "database"
+
+# Cross-referencing (time-based correlation)
+cursorflow query session_123 --errors --with-network --with-server-logs
+
+# Contextual queries
+cursorflow query session_123 --context-for-error 2 --window 10
+cursorflow query session_123 --group-by-url "/api/users"
+
+# Enhanced comparison
+cursorflow query session_A --compare-with session_B --errors
+```
+
+**Impact:**
+- ✅ 100% AI-readable results (vs 0% before - exceeded context limits)
+- ✅ 90% faster error diagnosis with AI assistants
+- ✅ Zero manual JSON parsing required
+- ✅ Complete backend + frontend visibility (server logs included)
+
+**Complete Data Coverage:**
+```
+.cursorflow/artifacts/sessions/session_XXX/
+├── server_logs.json   # ⭐ Server-side logs (SSH/local/Docker)
+├── errors.json        # Browser console errors
+├── network.json       # Network requests/responses
+├── screenshots.json   # ⭐ Screenshot metadata
+├── data_digest.md     # AI summary (includes server logs)
+└── + 6 more data files covering all CursorFlow features
+```
+
+---
+
 ## 🚀 Quick Start
 
 ### Step 1: Install CursorFlow Package

{cursorflow-2.6.3.dist-info → cursorflow-2.7.1.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=-gzdhMgkLxhzeCqiQaPNCgUN8jC1g8MYV4YpQmC8hVM,65834
+cursorflow/cli.py,sha256=2jPCIBTGdN7ZFFf7HpWNHdtdEZ27vJSx5P_t4L7Y1Z8,79716
 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
@@ -13,7 +13,8 @@ cursorflow/core/browser_engine.py,sha256=7N9hPOyDrEhLWYgZW2981N9gKlHF6Lbp7D7h0zB
 cursorflow/core/config_validator.py,sha256=HRtONSOmM0Xxt3-ok3xwnBADRiNnI0nNOMaS2OqOkDk,7286
 cursorflow/core/css_iterator.py,sha256=whLCIwbHZEWaH1HCbmqhNX5zrh_fL-r3hsxKjYsukcE,16478
 cursorflow/core/cursor_integration.py,sha256=MAeHjXYeqzaXnhskqkTDB-n5ixIHqapGe93X0lLKhws,67501
-cursorflow/core/cursorflow.py,sha256=j1LRNiRpUl3gZlB3r-yQ_h0HISNwnhi8-iZa_E0h86o,46111
+cursorflow/core/cursorflow.py,sha256=TqlJqyT9Y294aL_JpAV4G8MMelIESRI9VX6Z3fCyj2c,46467
+cursorflow/core/data_presenter.py,sha256=N9VAuRxwegif_l9dtBdcr92MZ3MkRqJW2qy07BNuaSw,18317
 cursorflow/core/error_context_collector.py,sha256=so-aveqwb6_vRDbtKR2ln8_F84aaVIceNi1UHsaVPgc,26196
 cursorflow/core/error_correlator.py,sha256=g6YaIF2yFXUDrTuWHCyuES6K0696H8LDWmXH1qI8ddA,13367
 cursorflow/core/event_correlator.py,sha256=lCzXFnii17AQt3rOVOclez_AnjvBCF_2ZlnFG0mIN6c,7808
@@ -23,17 +24,19 @@ cursorflow/core/json_utils.py,sha256=ofqRP1twDSHQx-SERgLTO5y2ZXkoirsEw8OOiJkGh2w
 cursorflow/core/log_collector.py,sha256=CYh41SLDI_t-hgzJqG3fTrSTDhEPFDktjO_mOQwucnE,15198
 cursorflow/core/log_monitor.py,sha256=pONMu_JHEnT0T62OA5KRZ4nClzKgNpifPyrfN5w_RM8,6704
 cursorflow/core/mockup_comparator.py,sha256=ttcXdueZz9dwcUGBQ2sft4i66zRdkZkFPu41s6JlEwU,63472
+cursorflow/core/output_manager.py,sha256=fyIhxoJO1Hps8HgGMEekzfSfFqcO4iy7YliXes2nvxI,22054
 cursorflow/core/persistent_session.py,sha256=FsEHj4wKkycmdp6PFRHv3g333Y74yqra0x_qhUTQpik,36075
+cursorflow/core/query_engine.py,sha256=kNqnVk_QxJXkhF2p9TM3L6J8w7pBVob1wEo-vPfSrP4,54075
 cursorflow/core/report_generator.py,sha256=-vosfyrnfVyWDbAIMlMurl90xOXqBae8d6aLd9sEqiY,10113
 cursorflow/core/trace_manager.py,sha256=Jj9ultZrL1atiZXfcRVI6ynCnnfqZM-X0_taxt-llJ0,7189
 cursorflow/log_sources/local_file.py,sha256=GVnhsaifIdc41twXwbxRM9-fBeRDsknDpk5IEGulnhQ,8318
 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=W56Qydfb4jqSBTrki7cNyFPfOe_b89mzniRtKSrMlz4,24138
-cursorflow-2.6.3.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
-cursorflow-2.6.3.dist-info/METADATA,sha256=NFnew-OVbuPvE-0Bmt5TG0CDgNWdaw-76D8HkeDoet8,15011
-cursorflow-2.6.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cursorflow-2.6.3.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
-cursorflow-2.6.3.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
-cursorflow-2.6.3.dist-info/RECORD,,
+cursorflow/rules/cursorflow-usage.mdc,sha256=e5l9sKtrkphRSOfqZTN7fvTvzPNoBAuVyCxFpAJ4uYY,31403
+cursorflow-2.7.1.dist-info/licenses/LICENSE,sha256=e4QbjAsj3bW-xgQOvQelr8sGLYDoqc48k6cKgCr_pBU,1080
+cursorflow-2.7.1.dist-info/METADATA,sha256=uRVlMJxjtG1AUAe5Udd5AxUW_As2EVhz9qrhGOVY09E,17538
+cursorflow-2.7.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cursorflow-2.7.1.dist-info/entry_points.txt,sha256=-Ed_n4Uff7wClEtWS-Py6xmQabecB9f0QAOjX0w7ljA,51
+cursorflow-2.7.1.dist-info/top_level.txt,sha256=t1UZwRyZP4u-ng2CEcNHmk_ZT4ibQxoihB2IjTF7ovc,11
+cursorflow-2.7.1.dist-info/RECORD,,