Cursor rule

1# 🐙 GitHub MCP Integration for CursorRIPER Σ
2# Symbol: Θ (Theta)
3# Version: 1.0.0
4 
5## 📋 Service Definition
6```
7service = "GitHub Operations"
8symbol = "Θ"
9requires = "@modelcontextprotocol/server-github"
10```
11 
12## 🔧 Operation Mapping
13```
14Θ_ops = {
15  repo: {
16    create: "@modelcontextprotocol-server-github:create_repository",
17    search: "@modelcontextprotocol-server-github:search_repositories", 
18    fork: "@modelcontextprotocol-server-github:fork_repository",
19    clone: "git clone via get_file_contents"
20  },
21  branch: {
22    create: "@modelcontextprotocol-server-github:create_branch",
23    list: "@modelcontextprotocol-server-github:list_commits",
24    checkout: "via create_branch with from_branch"
25  },
26  file: {
27    create: "@modelcontextprotocol-server-github:create_or_update_file",
28    push: "@modelcontextprotocol-server-github:push_files",
29    get: "@modelcontextprotocol-server-github:get_file_contents"
30  },
31  pr: {
32    create: "@modelcontextprotocol-server-github:create_pull_request",
33    review: "@modelcontextprotocol-server-github:create_pull_request_review",
34    merge: "@modelcontextprotocol-server-github:merge_pull_request",
35    list: "@modelcontextprotocol-server-github:list_pull_requests"
36  },
37  issue: {
38    create: "@modelcontextprotocol-server-github:create_issue",
39    update: "@modelcontextprotocol-server-github:update_issue",
40    comment: "@modelcontextprotocol-server-github:add_issue_comment",
41    list: "@modelcontextprotocol-server-github:list_issues"
42  }
43}
44```
45 
46## 🔒 Mode Restrictions
47```
48MΘ = {
49  Ω₁: [search_*, list_*, get_*],                    # RESEARCH: read-only
50  Ω₂: [search_*, list_*, get_*, fork_repository],   # INNOVATE: read + fork
51  Ω₃: [all_ops],                                    # PLAN: all operations
52  Ω₄: [create_*, update_*, push_*, merge_*],        # EXECUTE: write ops
53  Ω₅: [get_*, list_*, search_*]                     # REVIEW: read-only
54}
55```
56 
57## 🔑 Permission Matrix
58```
59ℙΘ = {
60  create: [Ω₃, Ω₄],
61  read: [Ω₁, Ω₂, Ω₃, Ω₄, Ω₅],
62  update: [Ω₃, Ω₄],
63  delete: [Ω₃]
64}
65```
66 
67## 📍 Context Integration
68```
69Γ_github = {
70  current_repo: active repository reference,
71  current_branch: active branch name,
72  pending_prs: open pull requests,
73  assigned_issues: assigned issue list
74}
75```
76 
77## ⚡ Command Shortcuts
78```
79SΘ = {
80  !gr: "search_repositories",
81  !gc: "create_repository",
82  !gp: "push_files",
83  !gpr: "create_pull_request",
84  !gi: "create_issue",
85  !gb: "create_branch",
86  !gm: "merge_pull_request"
87}
88```
89 
90## 🛡️ Protection Levels
91```
92ΨΘ = {
93  push_files: Ψ₂,           # GUARDED - code changes
94  merge_pull_request: Ψ₆,   # CRITICAL - main branch
95  delete_*: Ψ₆,            # CRITICAL - destructive
96  create_repository: Ψ₃     # INFO - new repo
97}
98```
99 
100## 🔄 Mode-Specific Behaviors
101```
102apply_github_op(op, mode) = {
103  check: op ∈ MΘ[mode] ? proceed : deny("Operation not allowed in " + mode),
104  protect: op ∈ ΨΘ ? apply_protection(ΨΘ[op]) : continue,
105  log: record_operation(op, mode, timestamp),
106  execute: Θ_ops[category][operation]()
107}
108```
109 
110## 🚨 Safety Protocols
111```
112ΔΘ = {
113  merge_*: require_review() ∧ check_ci_status(),
114  delete_*: confirm() ∧ backup_reference(),
115  push_to_main: deny() ∨ (confirm() ∧ Ψ₆)
116}
117```
118 
119## 🔌 Feature Detection
120```
121detect_github() = {
122  try: tools.find("@modelcontextprotocol-server-github:*"),
123  catch: warn("GitHub MCP not available. Install with: npm install -g @modelcontextprotocol/server-github"),
124  fallback: disable_github_features()
125}
126```
127