Cursor rule

1# 🎭 Puppeteer MCP Integration for CursorRIPER Σ
2# Symbol: Υ (Upsilon)
3# Version: 1.0.0
4 
5## 📋 Service Definition
6```
7service = "Browser Automation Operations"
8symbol = "Υ"
9requires = ["@modelcontextprotocol/server-puppeteer", "@executeautomation/playwright-mcp-server"]
10```
11 
12## 🔧 Operation Mapping
13```
14Υ_ops = {
15  browser: {
16    launch: "puppeteer_navigate / playwright_navigate",
17    close: "puppeteer_close / playwright_close",
18    screenshot: "puppeteer_screenshot / playwright_screenshot"
19  },
20  page: {
21    navigate: "puppeteer_navigate / playwright_navigate", 
22    click: "puppeteer_click / playwright_click",
23    fill: "puppeteer_fill / playwright_fill",
24    select: "puppeteer_select / playwright_select",
25    hover: "puppeteer_hover / playwright_hover"
26  },
27  test: {
28    record: "start_codegen_session",
29    end_record: "end_codegen_session",
30    assert: "playwright_expect_response + playwright_assert_response"
31  },
32  scrape: {
33    content: "playwright_get_visible_text",
34    html: "playwright_get_visible_html",
35    evaluate: "puppeteer_evaluate / playwright_evaluate"
36  }
37}
38```
39 
40## 🔒 Mode Restrictions
41```
42MΥ = {
43  Ω₁: [scrape_*, screenshot],                    # RESEARCH: data gathering
44  Ω₂: [navigate, screenshot, scrape_*],          # INNOVATE: exploration
45  Ω₃: [all_ops],                                # PLAN: all operations
46  Ω₄: [test_*, navigate, click, fill, assert],   # EXECUTE: testing focus
47  Ω₅: [screenshot, scrape_*, get_console_logs]   # REVIEW: verification
48}
49```
50 
51## 🔑 Permission Matrix
52```
53ℙΥ = {
54  create: [Ω₃, Ω₄],          # PLAN/EXECUTE can create tests
55  read: [Ω₁, Ω₂, Ω₃, Ω₄, Ω₅], # All can read page content
56  update: [Ω₃, Ω₄],          # PLAN/EXECUTE can interact
57  delete: []                 # No delete operations
58}
59```
60 
61## 📍 Context Integration
62```
63Γ_browser = {
64  active_session: browser_instance,
65  current_url: page.url(),
66  test_recordings: codegen_sessions[],
67  console_logs: captured_logs[],
68  screenshots: saved_screenshots[]
69}
70```
71 
72## ⚡ Command Shortcuts
73```
74SΥ = {
75  !pn: "navigate to URL",
76  !ps: "take screenshot",
77  !pc: "click element",
78  !pf: "fill form field",
79  !pt: "start test recording",
80  !pe: "end test recording",
81  !pg: "get page content"
82}
83```
84 
85## 🛡️ Protection Levels
86```
87ΨΥ = {
88  navigate: Ψ₂,        # GUARDED - URL changes
89  click: Ψ₃,           # INFO - user actions
90  fill: Ψ₂,            # GUARDED - form data
91  test_record: Ψ₅,     # TEST - test recording
92  evaluate: Ψ₆         # CRITICAL - code execution
93}
94```
95 
96## 🔄 Mode-Specific Behaviors
97```
98apply_browser_op(op, mode) = {
99  check: op ∈ MΥ[mode] ? proceed : deny("Operation not allowed in " + mode),
100  protect: op ∈ ΨΥ ? apply_protection(ΨΥ[op]) : continue,
101  track: {
102    log_action(op, selector, value),
103    capture_state(screenshot_if_needed)
104  },
105  execute: Υ_ops[category][operation]()
106}
107```
108 
109## 🎯 Testing Integration
110```
111test_workflow = {
112  start: {
113    mode: require(Ω₃ ∨ Ω₄),
114    init: start_codegen_session({
115      outputPath: "./tests/",
116      includeComments: true
117    })
118  },
119  record: {
120    actions: [navigate, click, fill, assert],
121    capture: automatic_via_codegen
122  },
123  end: {
124    generate: end_codegen_session(sessionId),
125    output: test_file_with_playwright_code
126  }
127}
128```
129 
130## 📸 Screenshot Management
131```
132screenshot_policy = {
133  Ω₁: "on_demand",
134  Ω₂: "key_pages",
135  Ω₃: "all_interactions", 
136  Ω₄: "test_failures",
137  Ω₅: "final_state"
138}
139```
140 
141## 🔌 Feature Detection
142```
143detect_browser_automation() = {
144  puppeteer: tools.find("@modelcontextprotocol-server-puppeteer:*"),
145  playwright: tools.find("@executeautomation-playwright-mcp-server:*"),
146  preference: playwright > puppeteer,  # Playwright preferred
147  fallback: warn("No browser automation available")
148}
149```
150 
151## 🔗 Integration with Other Services
152```
153Υ×Θ = test_and_commit() = {
154  1: Υ.start_test_recording(),
155  2: Υ.execute_test_actions(),
156  3: Υ.end_test_recording() → test_file,
157  4: Θ.create_branch("test/" + test_name),
158  5: Θ.push_files([test_file]),
159  6: Θ.create_pull_request()
160}
161```
162