Cursor rule

1# 🐳 Docker MCP Integration for CursorRIPER Σ
2# Symbol: Ξ (Xi)
3# Version: 1.0.0
4 
5## 📋 Service Definition
6```
7service = "Container Operations"
8symbol = "Ξ"
9requires = "docker-mcp"
10```
11 
12## 🔧 Operation Mapping
13```
14Ξ_ops = {
15  container: {
16    create: "docker-mcp:create-container",
17    list: "docker-mcp:list-containers",
18    logs: "docker-mcp:get-logs",
19    start: "docker exec via create",
20    stop: "docker stop via compose"
21  },
22  compose: {
23    deploy: "docker-mcp:deploy-compose",
24    down: "modify compose_yaml with replicas: 0"
25  },
26  image: {
27    pull: "implicit via create-container",
28    build: "via Dockerfile in compose_yaml"
29  }
30}
31```
32 
33## 🔒 Mode Restrictions
34```
35MΞ = {
36  Ω₁: [list_*, logs],                      # RESEARCH: read-only
37  Ω₂: [list_*, logs, pull],                # INNOVATE: read + pull
38  Ω₃: [all_ops],                          # PLAN: all operations
39  Ω₄: [create, deploy, logs],              # EXECUTE: runtime ops
40  Ω₅: [logs, list_*]                      # REVIEW: monitoring
41}
42```
43 
44## 🔑 Permission Matrix
45```
46ℙΞ = {
47  create: [Ω₃, Ω₄],
48  read: [Ω₁, Ω₂, Ω₃, Ω₄, Ω₅],
49  update: [Ω₃, Ω₄],
50  delete: [Ω₃]              # Only PLAN can remove
51}
52```
53 
54## 📍 Context Integration
55```
56Γ_docker = {
57  running_containers: active_container_list[],
58  compose_stacks: deployed_stacks[],
59  container_logs: recent_logs{},
60  resource_usage: {cpu: %, memory: MB}
61}
62```
63 
64## ⚡ Command Shortcuts
65```
66SΞ = {
67  !dc: "create container",
68  !dd: "deploy compose stack",
69  !dl: "get container logs",
70  !dls: "list containers",
71  !ds: "stop container",
72  !dr: "remove container"
73}
74```
75 
76## 🛡️ Protection Levels
77```
78ΨΞ = {
79  create_container: Ψ₃,     # INFO - new container
80  deploy_compose: Ψ₂,       # GUARDED - stack deployment
81  stop_*: Ψ₄,              # DEBUG - stopping services
82  remove_*: Ψ₆             # CRITICAL - destructive
83}
84```
85 
86## 🔄 Mode-Specific Behaviors
87```
88apply_docker_op(op, mode) = {
89  check: op ∈ MΞ[mode] ? proceed : deny("Operation not allowed in " + mode),
90  protect: op ∈ ΨΞ ? apply_protection(ΨΞ[op]) : continue,
91  validate: check_resources() ∧ verify_config(),
92  execute: Ξ_ops[category][operation]()
93}
94```
95 
96## 🔐 Safety Protocols
97```
98ΔΞ = {
99  remove_*: confirm() ∧ backup_config() ∧ check_dependencies(),
100  deploy: validate_compose() ∧ check_port_conflicts(),
101  scale: check_resources() ∧ gradual_rollout(),
102  production_deploy: require(Ω₅) ∧ approval_gate()
103}
104```
105 
106## 📊 Resource Management
107```
108resource_limits = {
109  dev: {
110    containers: 10,
111    memory: "4GB",
112    cpu: "2 cores"
113  },
114  prod: {
115    containers: 50,
116    memory: "16GB", 
117    cpu: "8 cores"
118  }
119}
120```
121 
122## 🚀 Deployment Workflows
123```
124deployment_flow = {
125  dev: {
126    build: local_dockerfile,
127    test: Υ.test_container(),
128    deploy: Ξ.create_container()
129  },
130  staging: {
131    compose: staging_compose.yml,
132    validate: health_checks(),
133    deploy: Ξ.deploy_compose()
134  },
135  prod: {
136    approval: require_gate(Κ₅),
137    deploy: blue_green_deployment(),
138    monitor: continuous_logs()
139  }
140}
141```
142 
143## 📝 Compose Template Integration
144```
145compose_generator(project) = {
146  template: `
147version: '3.8'
148services:
149  ${project.name}:
150    image: ${project.image}
151    ports: ${project.ports}
152    environment: ${project.env}
153    deploy:
154      replicas: ${project.replicas || 1}
155  `,
156  validate: yaml_syntax ∧ image_exists ∧ port_available
157}
158```
159 
160## 🔌 Feature Detection
161```
162detect_docker() = {
163  try: {
164    tools.find("docker-mcp:*"),
165    verify_docker_daemon()
166  },
167  catch: warn("Docker MCP not available. Ensure Docker daemon is running."),
168  fallback: disable_container_features()
169}
170```
171 
172## 🔗 Integration with Other Services
173```
174Θ×Ξ = deploy_from_github() = {
175  1: Θ.get_file_contents("Dockerfile"),
176  2: Θ.get_file_contents("docker-compose.yml"),
177  3: Ξ.validate_config(compose_yaml),
178  4: Ξ.deploy_compose({
179       project_name: repo_name,
180       compose_yaml: contents
181     })
182}
183```
184