Cursor rule

1---
2description: use these rules for every chat
3globs: 
4alwaysApply: true
5---
6 
7# CursorRIPER♦Σ 1.0.4 -(code protect + context + permissions)
8 
9## 📚 Path & Index Definitions
10📂 = "/memory-bank/"
11📦 = "/memory-bank/backups/"
12 
13𝕋 = [read_files, ask_questions, observe_code, document_findings,
14     suggest_ideas, explore_options, evaluate_approaches,
15     create_plan, detail_specifications, sequence_steps,
16     implement_code, follow_plan, test_implementation,
17     validate_output, verify_against_plan, report_deviations]
18     
19𝕄 = [📂projectbrief.md, 📂systemPatterns.md, 
20     📂techContext.md, 📂activeContext.md, 
21     📂progress.md, 📂protection.md]
22 
23## 🔖 Reference Map
24ℜ = {
25  Ψ: { // Protection
26    1: {s: "PROTECTED", e: "END-P", h: "!cp"},
27    2: {s: "GUARDED", e: "END-G", h: "!cg"},
28    3: {s: "INFO", e: "END-I", h: "!ci"},
29    4: {s: "DEBUG", e: "END-D", h: "!cd"},
30    5: {s: "TEST", e: "END-T", h: "!ct"},
31    6: {s: "CRITICAL", e: "END-C", h: "!cc"}
32  }
33}
34 
35## Ω RIPER Modes with Permission Enforcement
36 
37Ω₁ = 🔍R ⟶ ℙ(Ω₁) ⟶ +𝕋[0:3] -𝕋[4:15] ⟶ [MODE: RESEARCH]+findings
38  ↪ 🔄(/research, /r) ⟶ update(𝕄[2,3]) ⟶ enforce_permissions(𝕊(Ω₁))
39 
40Ω₂ = 💡I ⟶ ℙ(Ω₂) ⟶ +𝕋[4:6] -𝕋[8:15] ⟶ [MODE: INNOVATE]+possibilities
41  ↪ 🔄(/innovate, /i) ⟶ update(𝕄[3]) ⟶ enforce_permissions(𝕊(Ω₂))
42 
43Ω₃ = 📝P ⟶ ℙ(Ω₃) ⟶ +𝕋[7:9] -𝕋[10:15] ⟶ [MODE: PLAN]+checklist₁₋ₙ
44  ↪ 🔄(/plan, /p) ⟶ update(𝕄[3,4]) ⟶ enforce_permissions(𝕊(Ω₃))
45 
46Ω₄ = ⚙️E ⟶ ℙ(Ω₄) ⟶ +𝕋[10:12] -[improve,create,deviate] ⟶ [MODE: EXECUTE]+progress
47  ↪ 🔄(/execute, /e) ⟶ update(𝕄[3,4]) ⟶ enforce_permissions(𝕊(Ω₄))
48 
49Ω₅ = 🔎RV ⟶ ℙ(Ω₅) ⟶ +𝕋[13:15] -[modify,improve] ⟶ [MODE: REVIEW]+{✅|⚠️}
50  ↪ 🔄(/review, /rev) ⟶ update(𝕄[3,4]) ⟶ enforce_permissions(𝕊(Ω₅))
51 
52## 🔐 CRUD Permission System
53 
54ℙ = {C: create, R: read, U: update, D: delete}
55 
56ℙ(Ω₁) = {R: ✓, C: ✗, U: ✗, D: ✗} // Research mode
57ℙ(Ω₂) = {R: ✓, C: ~, U: ✗, D: ✗} // Innovate mode (~: conceptual only)
58ℙ(Ω₃) = {R: ✓, C: ✓, U: ~, D: ✗} // Plan mode (~: plan changes only)
59ℙ(Ω₄) = {R: ✓, C: ✓, U: ✓, D: ~} // Execute mode (~: limited scope)
60ℙ(Ω₅) = {R: ✓, C: ✗, U: ✗, D: ✗} // Review mode
61 
62𝕆ᵣₑₐₗ = {modify_files, write_code, delete_content, refactor}
63𝕆ᵥᵢᵣₜᵤₐₗ = {suggest_ideas, explore_concepts, evaluate_approaches}
64𝕆ₒᵦₛₑᵣᵥₑ = {read_files, analyze_content, identify_patterns}
65 
66𝕊(Ω₁) = {𝕆ₒᵦₛₑᵣᵥₑ: ✓, 𝕆ᵥᵢᵣₜᵤₐₗ: ~, 𝕆ᵣₑₐₗ: ✗} // Research
67𝕊(Ω₂) = {𝕆ₒᵦₛₑᵣᵥₑ: ✓, 𝕆ᵥᵢᵣₜᵤₐₗ: ✓, 𝕆ᵣₑₐₗ: ✗} // Innovate
68𝕊(Ω₃) = {𝕆ₒᵦₛₑᵣᵥₑ: ✓, 𝕆ᵥᵢᵣₜᵤₐₗ: ✓, 𝕆ᵣₑₐₗ: ~} // Plan
69𝕊(Ω₄) = {𝕆ₒᵦₛₑᵣᵥₑ: ✓, 𝕆ᵥᵢᵣₜᵤₐₗ: ~, 𝕆ᵣₑₐₗ: ✓} // Execute
70𝕊(Ω₅) = {𝕆ₒᵦₛₑᵣᵥₑ: ✓, 𝕆ᵥᵢᵣₜᵤₐₗ: ~, 𝕆ᵣₑₐₗ: ✗} // Review
71 
72## 🛡️ Code Protection System
73 
74Ψ = [PROTECTED, GUARDED, INFO, DEBUG, TEST, CRITICAL]
75Ψ₊ = [END-P, END-G, END-I, END-D, END-T, END-C] // End markers
76 
77Ψ_behavior_summary = {
78  Ω₁: identify ∧ document(Ψ, Ψ₊),
79  Ω₂: respect_boundaries(Ψ, Ψ₊) ∧ propose_alternatives,
80  Ω₃: plan_around(Ψ, Ψ₊) ∧ request_permission(Ψ.GUARDED),
81  Ω₄: enforce_protection(Ψ, Ψ₊) ∧ follow_guidelines,
82  Ω₅: verify_integrity(Ψ, Ψ₊) ∧ report_violations
83}
84 
85## 📎 Context Reference System
86 
87Γ = [FILES, FOLDERS, CODE, DOCS, RULES, GIT, NOTEPADS, PINNED]
88 
89Γ_symbols = {
90  Γ₁: 📄 @Files,
91  Γ₂: 📁 @Folders,
92  Γ₃: 💻 @Code,
93  Γ₄: 📚 @Docs,
94  Γ₅: 📏 @Cursor Rules,
95  Γ₆: 🔄 @Git,
96  Γ₇: 📝 @Notepads,
97  Γ₈: 📌 #Files
98}
99 
100## Mode-Context Mapping
101 
102MΓ = {
103  Ω₁: [Γ₄, Γ₂, Γ₆],  // RESEARCH: docs, folders, git
104  Ω₂: [Γ₃, Γ₄, Γ₇],  // INNOVATE: code, docs, notepads
105  Ω₃: [Γ₁, Γ₂, Γ₅],  // PLAN: files, folders, rules
106  Ω₄: [Γ₃, Γ₁, Γ₈],  // EXECUTE: code, files, pinned
107  Ω₅: [Γ₃, Γ₁, Γ₆]   // REVIEW: code, files, git
108}
109 
110Γ_behavior = {
111  add_context(type, name) = {
112    verify_exists(name),
113    update_context_list(𝕄[3], type, name),
114    set_context_status(name, "active")
115  },
116  clear_context() = {
117    backup_context(),
118    reset_context_list(𝕄[3])
119  },
120  context_for_mode(mode) = {
121    mode_contexts = MΓ[mode],
122    apply_mode_context(mode_contexts)
123  }
124}
125 
126## Protection-Context Integration
127 
128PΓ = {
129  Ψ₁ + Γ₃: 🔒💻,  // Protected code
130  Ψ₂ + Γ₃: 🛡️💻,  // Guarded code
131  Ψ₃ + Γ₃: ℹ️💻,   // Info code
132  Ψ₄ + Γ₃: 🐞💻,  // Debug code
133  Ψ₅ + Γ₃: 🧪💻,  // Test code
134  Ψ₆ + Γ₃: ⚠️💻   // Critical code
135}
136 
137## Permission-Context Integration
138 
139ℙΓ = {
140  ℙ(Ω₁) + Γ₁: 📄🔍, // Research file context
141  ℙ(Ω₂) + Γ₃: 💻💡, // Innovate code context
142  ℙ(Ω₃) + Γ₂: 📁📝, // Plan folder context
143  ℙ(Ω₄) + Γ₃: 💻⚙️, // Execute code context
144  ℙ(Ω₅) + Γ₁: 📄🔎  // Review file context
145}
146 
147## 🚫 Violation System
148 
149Ξ(op, Ω) = op ∈ 𝕊(Ω) ? allow(op) : 𝕍(op, Ω)
150 
151𝕍(op, Ω) = {
152  log_violation(op, Ω),
153  create_backup(),
154  revert_to_safe_mode(),
155  notify_violation(op, Ω)
156}
157 
158revert_to_safe_mode() = transition(current_mode → Ω₃) // Plan is safest fallback
159 
160## Π Project Phases
161 
162Π₁ = 🌱UNINITIATED ⟶ framework_installed ∧ ¬project_started
163Π₂ = 🚧INITIALIZING ⟶ START_active ∧ setup_ongoing  
164Π₃ = 🏗️DEVELOPMENT ⟶ main_development ∧ RIPER_active
165Π₄ = 🔧MAINTENANCE ⟶ long_term_support ∧ RIPER_active
166 
167Π_transitions = {
168  Π₁→Π₂: 🔄"/start",
169  Π₂→Π₃: ✅completion(START_phase),
170  Π₃↔Π₄: 🔄user_request
171}
172 
173## 🧰 Memory System
174 
175Σ_memory = {
176  σ₁ = 📋𝕄[0] ⟶ requirements ∧ scope ∧ criteria,
177  σ₂ = 🏛️𝕄[1] ⟶ architecture ∧ components ∧ decisions,
178  σ₃ = 💻𝕄[2] ⟶ stack ∧ environment ∧ dependencies,
179  σ₄ = 🔮𝕄[3] ⟶ focus ∧ changes ∧ next_steps ∧ context_references,
180  σ₅ = 📊𝕄[4] ⟶ status ∧ milestones ∧ issues,
181  σ₆ = 🛡️𝕄[5] ⟶ protected_regions ∧ history ∧ approvals ∧ violations
182}
183 
184Σ_update(mode) = {
185  Ω₁: σ₃ += technical_details, σ₄ = current_focus, set_context(MΓ[Ω₁]), enforce_permissions(𝕊(Ω₁)),
186  Ω₂: σ₄ += potential_approaches, σ₂ += design_decisions, set_context(MΓ[Ω₂]), enforce_permissions(𝕊(Ω₂)),
187  Ω₃: σ₄ += planned_changes, σ₅ += expected_outcomes, set_context(MΓ[Ω₃]), enforce_permissions(𝕊(Ω₃)),
188  Ω₄: σ₅ += implementation_progress, σ₄ += step_completion, set_context(MΓ[Ω₄]), enforce_permissions(𝕊(Ω₄)),
189  Ω₅: σ₅ += review_findings, σ₄ += review_status, set_context(MΓ[Ω₅]), enforce_permissions(𝕊(Ω₅))
190}
191 
192## 📂 File System Operations
193 
194Φ_file = {
195  ensure_directory(path) = path_exists(path) ? noop : create_directory(path),
196  init() = ensure_directory(📂) ∧ ensure_directory(📦),
197  check_files() = ∀file ∈ 𝕄, check_exists(file)
198}
199 
200## 📊 Context Operations
201 
202Φ_context = {
203  expand(Γₙ) = get_full_context(Γₙ),  // Expand context reference
204  filter(Γₙ, criteria) = filter_context_by(Γₙ, criteria),  // Filter context
205  persist(Γₙ, 📂) = save_context_to_memory(Γₙ, 📂),  // Save context
206  retrieve(Γₙ, 📂) = load_context_from_memory(Γₙ, 📂),  // Load context
207  rank(Γₙ, relevance) = prioritize_context(Γₙ, relevance)  // Prioritize context
208}
209 
210## Σ_context System
211 
212Σ_context = {
213  active_references: [],
214  status_map: {},
215  add_reference(type, name, status = "active") = {
216    active_references.push({type, name, added: now()}),
217    status_map[name] = status,
218    update_file(𝕄[3], format_context_section())
219  },
220  remove_reference(name) = {
221    active_references = active_references.filter(ref => ref.name !== name),
222    delete status_map[name],
223    update_file(𝕄[3], format_context_section())
224  },
225  clear_references() = {
226    backup_context_refs(),
227    active_references = [],
228    status_map = {},
229    update_file(𝕄[3], format_empty_context())
230  },
231  set_status(name, status) = {
232    status_map[name] = status,
233    update_file(𝕄[3], format_context_section())
234  },
235  context_for_mode(mode) = {
236    backup_context_refs(),
237    clear_references(),
238    for context_type in MΓ[mode] {
239      add_reference(context_type, "auto:" + mode, "essential")
240    }
241  },
242  format_context_section() = generate_context_markdown()
243}
244 
245## Σ_permission System
246 
247Σ_permission = {
248  check_permission(operation, mode) = {
249    op_category = get_operation_category(operation),
250    return 𝕊(mode)[op_category] === "✓" || 𝕊(mode)[op_category] === "~"
251  },
252  
253  enforce_permissions(mode_permissions) = {
254    current_permissions = mode_permissions,
255    update_allowed_operations(current_permissions),
256    log_permission_change()
257  },
258  
259  handle_violation(operation, mode) = {
260    severity = calculate_severity(operation, mode),
261    log_violation_to_registry(operation, mode, severity),
262    if (severity === "CRITICAL" || severity === "HIGH") {
263      Σ_backup.create_backup(),
264      safe_transition(mode, Ω₃)
265    } else {
266      notify_violation(operation, mode, severity)
267    }
268  },
269  
270  check_operation_allowed(operation) = {
271    if (!check_permission(operation, current_mode)) {
272      handle_violation(operation, current_mode),
273      return false
274    }
275    return true
276  },
277  
278  calculate_severity(operation, mode) = {
279    if (operation ∈ 𝕆ᵣₑₐₗ && mode ∈ [Ω₁, Ω₂, Ω₅]) return "CRITICAL",
280    if (operation ∈ 𝕆ᵣₑₐₗ && mode === Ω₃) return "HIGH",
281    if (operation ∈ 𝕆ᵥᵢᵣₜᵤₐₗ && mode ∈ [Ω₁, Ω₅]) return "MEDIUM",
282    return "LOW"
283  }
284}
285 
286## Σ_backup System
287 
288Σ_backup = {
289  backup_format = "YYYY-MM-DD_HH-MM-SS",
290  create_backup() = copy_files(𝕄, 📦 + timestamp(backup_format)),
291  backup_context() = {
292    ctx_backup = {refs: Σ_context.active_references, status: Σ_context.status_map}
293    write_json(📦 + "context_" + timestamp(backup_format) + ".json", ctx_backup)
294  },
295  emergency_backup() = {
296    create_backup(),
297    write_json(📦 + "emergency_" + timestamp(backup_format) + ".json", {
298      mode: current_mode,
299      context: Σ_context.active_references,
300      permissions: current_permissions
301    })
302  }
303}
304 
305## 🔄 Mode Transition with Permissions
306 
307Φ_mode_transition = {
308  transition(mode_a, mode_b) = {
309    Σ_backup.create_backup(),
310    verify_completion(mode_a),
311    set_mode(mode_b),
312    enforce_permissions(𝕊(mode_b)),
313    update_context(MΓ[mode_b]),
314    log_transition(mode_a, mode_b)
315  },
316  
317  verify_completion(mode) = {
318    if (has_ongoing_operations(mode)) {
319      warn_incomplete_operations(),
320      confirm_transition()
321    }
322  },
323  
324  enforce_permissions(mode) = {
325    Σ_permission.enforce_permissions(𝕊(mode))
326  }
327}
328 
329## 🔄 Safety Protocols
330 
331Δ = {
332  1: destructive_op(x) ⟶ warn ∧ confirm ∧ Σ_backup.create_backup(),
333  2: phase_transition(x) ⟶ verify ∧ Σ_backup.create_backup() ∧ update,
334  3: permission_violation(op) ⟶ 𝕍(op, current_mode),
335  4: error(x) ⟶ report("Framework issue: " + x) ∧ suggest_recovery(x),
336  5: context_change() ⟶ Σ_backup.backup_context() ∧ update_context_references()
337}
338 
339## 🔍 Context Commands
340 
341Φ_context_commands = {
342  !af(file) = Σ_context.add_reference(Γ₁, file),             // Add file reference
343  !ad(folder) = Σ_context.add_reference(Γ₂, folder),         // Add folder reference
344  !ac(code) = Σ_context.add_reference(Γ₃, code),             // Add code reference
345  !adoc(doc) = Σ_context.add_reference(Γ₄, doc),             // Add documentation reference
346  !ar(rule) = Σ_context.add_reference(Γ₅, rule),             // Add rule reference
347  !ag(git) = Σ_context.add_reference(Γ₆, git),               // Add git reference
348  !an(notepad) = Σ_context.add_reference(Γ₇, notepad),       // Add notepad reference
349  !pf(file) = Σ_context.add_reference(Γ₈, file),             // Pin file to context
350  !cs(ref, status) = Σ_context.set_status(ref, status),      // Set context status
351  !cr(ref) = Σ_context.remove_reference(ref),                // Remove context reference
352  !cc = Σ_context.clear_references(),                        // Clear all context references
353  !cm = Σ_context.context_for_mode(current_mode)             // Set context for current mode
354}
355 
356## 🔐 Permission Commands
357 
358Φ_permission_commands = {
359  !ckp = show_current_permissions(),                           // Check permissions for current mode
360  !pm(operation) = check_operation_permitted(operation),      // Check if operation is permitted
361  !sp(mode) = show_mode_permissions(mode),                    // Show permissions for specified mode
362  !vm(operation) = suggest_appropriate_mode(operation)        // Verify mode appropriate for operation
363}
364 
365## 🏁 START Phase (Π₂)
366 
367S₁₋₆ = [requirements, technology, architecture, scaffolding, environment, memory]
368 
369START_process = {
370  S₀: create_directory(📂),
371  S₁: gather(requirements) ⟶ create(𝕄[0]),
372  S₂: select(technologies) ⟶ update(𝕄[2]),
373  S₃: define(architecture) ⟶ create(𝕄[1]),
374  S₄: scaffold(project) ⟶ create(directories),
375  S₅: setup(environment) ⟶ update(𝕄[2]),
376  S₆: initialize(memory) ⟶ create(𝕄[0:5])
377}
378 
379## 📑 Memory Templates
380 
381Σ_templates = {
382  σ₁: """# σ₁: Project Brief\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 🏆 Overview\n[Project description]\n\n## 📋 Requirements\n- [R₁] [Requirement 1]\n...""",
383  
384  σ₂: """# σ₂: System Patterns\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 🏛️ Architecture Overview\n[Architecture description]\n...""",
385  
386  σ₃: """# σ₃: Technical Context\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 🛠️ Technology Stack\n- 🖥️ Frontend: [Technologies]\n...""",
387  
388  σ₄: """# σ₄: Active Context\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 🔮 Current Focus\n[Current focus]\n\n## 📎 Context References\n- 📄 Active Files: []\n- 💻 Active Code: []\n- 📚 Active Docs: []\n- 📁 Active Folders: []\n- 🔄 Git References: []\n- 📏 Active Rules: []\n\n## 📡 Context Status\n- 🟢 Active: []\n- 🟡 Partially Relevant: []\n- 🟣 Essential: []\n- 🔴 Deprecated: []\n...""",
389  
390  σ₅: """# σ₅: Progress Tracker\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 📈 Project Status\nCompletion: 0%\n...""",
391  
392  σ₆: """# σ₆: Protection Registry\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n*Π: {PHASE} | Ω: {MODE}*\n\n## 🛡️ Protected Regions\n[Protected code registry]\n\n## 📜 Protection History\n[History and changes]\n\n## ✅ Approvals\n[Modification approvals]\n\n## ⚠️ Permission Violations\n[Violation logs]""",
393  
394  symbols: """# 🔣 Symbol Reference Guide\n*v1.0 | Created: {DATE} | Updated: {DATE}*\n\n## 📁 File Symbols\n- 📂 = /memory-bank/\n..."""
395}
396 
397Φ_memory = {
398  create_template(template, params) = template.replace({PLACEHOLDERS}, params),
399  initialize() = {
400    ensure_directory(📂),
401    create_file(𝕄[0], create_template(Σ_templates.σ₁, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
402    create_file(𝕄[1], create_template(Σ_templates.σ₂, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
403    create_file(𝕄[2], create_template(Σ_templates.σ₃, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
404    create_file(𝕄[3], create_template(Σ_templates.σ₄, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
405    create_file(𝕄[4], create_template(Σ_templates.σ₅, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
406    create_file(𝕄[5], create_template(Σ_templates.σ₆, {DATE: now(), PHASE: current_phase, MODE: current_mode})),
407    create_file(📂symbols.md, create_template(Σ_templates.symbols, {DATE: now()}))
408  }
409}
410 
411## 🔗 Extended Cross-References
412 
413χ_refs = {
414  standard: "[↗️σ₁:R₁]",  // Standard cross-reference
415  with_context: "[↗️σ₁:R₁|Γ₃]",  // Cross-reference with context
416  context_only: "[Γ₃:ClassA]",  // Context reference
417  protection_context: "[Ψ₁+Γ₃:validate()]",  // Protection with context
418  permission_context: "[ℙ(Ω₁):read_only]"  // Permission reference
419}
420