Cursor rule

1---
2description: MCP Filesystem integration for CursorRIPER Σ
3globs: 
4alwaysApply: true
5---
6 
7# CursorRIPER♦Σ Filesystem MCP Integration
8 
9## 📁 MCP Filesystem Operations
10 
11Φ_fs = {
12  read(path) = mcp_call("read_file", {path}),
13  read_multi(paths) = mcp_call("read_multiple_files", {paths}),
14  write(path, content) = mcp_call("write_file", {path, content}),
15  edit(path, edits, dry_run = false) = mcp_call("edit_file", {path, edits, dryRun: dry_run}),
16  create_dir(path) = mcp_call("create_directory", {path}),
17  list(path) = mcp_call("list_directory", {path}),
18  tree(path) = mcp_call("directory_tree", {path}),
19  move(source, dest) = mcp_call("move_file", {source, destination: dest}),
20  search(path, pattern, exclude = []) = mcp_call("search_files", {path, pattern, excludePatterns: exclude}),
21  info(path) = mcp_call("get_file_info", {path}),
22  allowed() = mcp_call("list_allowed_directories", {})
23}
24 
25## 🔌 Mode-Specific Filesystem Operations
26 
27MΦ = {
28  Ω₁: Φ_fs[read, read_multi, list, tree, search, info, allowed], // Research
29  Ω₂: Φ_fs[read, list, tree, search, info, allowed],             // Innovate
30  Ω₃: Φ_fs[read, list, search, info, create_dir, allowed],       // Plan
31  Ω₄: Φ_fs[read, write, edit, create_dir, move, allowed],        // Execute
32  Ω₅: Φ_fs[read, read_multi, list, tree, search, info, allowed]  // Review
33}
34 
35## 🔒 Filesystem Permission Matrix
36 
37ℙΦ = {
38  Ω₁: {read: ✓, create: ✗, update: ✗, delete: ✗},  // Research
39  Ω₂: {read: ✓, create: ~, update: ✗, delete: ✗},  // Innovate
40  Ω₃: {read: ✓, create: ✓, update: ~, delete: ✗},  // Plan
41  Ω₄: {read: ✓, create: ✓, update: ✓, delete: ~},  // Execute
42  Ω₅: {read: ✓, create: ✗, update: ✗, delete: ✗}   // Review
43}
44 
45## 🔍 Filesystem Operation Categories
46 
47𝕆fs_read = {read, read_multi, list, tree, search, info, allowed}
48𝕆fs_create = {write, create_dir}
49𝕆fs_update = {edit, move}
50𝕆fs_delete = {delete} // Not directly exposed in basic MCP
51 
52## 📡 Filesystem Context Integration
53 
54// Add Filesystem to Context References
55Γ₉ = 🗃️ @Filesystem
56 
57// Update Mode-Context Mapping to include Filesystem
58MΓ_fs = {
59  Ω₁: MΓ[Ω₁] + [Γ₉],  // Add to Research
60  Ω₂: MΓ[Ω₂],         // Innovate unchanged
61  Ω₃: MΓ[Ω₃] + [Γ₉],  // Add to Plan
62  Ω₄: MΓ[Ω₄] + [Γ₉],  // Add to Execute
63  Ω₅: MΓ[Ω₅] + [Γ₉]   // Add to Review
64}
65 
66// Context-Filesystem Reference Types
67ΓΦ = {
68  fs_path: "@path",      // Reference to file path
69  fs_dir: "@dir",        // Reference to directory
70  fs_pattern: "@pattern" // Reference to search pattern
71}
72 
73## 🛡️ Filesystem Protection Integration
74 
75// Protection Levels for Filesystem Operations
76ΨΦ = {
77  ψ₁: {desc: "Public", ops: Φ_fs[*]},
78  ψ₂: {desc: "Visible", ops: Φ_fs[read, list, search, info]},
79  ψ₃: {desc: "Limited", ops: Φ_fs[read, info]},
80  ψ₄: {desc: "Private", ops: Φ_fs[info]},
81  ψ₅: {desc: "Restricted", ops: {}},
82  ψ₆: {desc: "Forbidden", ops: {}}
83}
84 
85// Directory Protection Mapping Function
86ΨD(path) ⟶ protection_level
87 
88// Verify Protection Level Before Operation
89verify_fs_protection(op, path) = {
90  path_protection = ΨD(path),
91  op ∈ ΨΦ[path_protection].ops ? allow(op) : block(op)
92}
93 
94## 🔍 MCP Command Shortcuts
95 
96SΦ = {
97  "!fr": Φ_fs.read,             // file read
98  "!fm": Φ_fs.read_multi,       // file multi-read
99  "!fw": Φ_fs.write,            // file write
100  "!fe": Φ_fs.edit,             // file edit
101  "!fc": Φ_fs.create_dir,       // file create-dir
102  "!fl": Φ_fs.list,             // file list
103  "!ft": Φ_fs.tree,             // file tree
104  "!fv": Φ_fs.move,             // file move
105  "!fs": Φ_fs.search,           // file search
106  "!fi": Φ_fs.info,             // file info
107  "!fa": Φ_fs.allowed           // file allowed
108}
109 
110// Add Filesystem Context Command
111Φ_context_commands.!afs = (path) ⟶ Σ_context.add_reference(Γ₉, path)  // Add filesystem reference
112 
113## 💾 Filesystem Memory Integration
114 
115Σ_fs = {
116  σfs₁ = fs_paths ⟶ recently_accessed_paths,
117  σfs₂ = fs_operations ⟶ operation_history,
118  σfs₃ = fs_errors ⟶ error_history,
119  σfs₄ = fs_success ⟶ success_history
120}
121 
122// Memory Update for Filesystem Operations
123Σ_update_fs(op, result) = {
124  update(σfs₁, op.path),
125  update(σfs₂, {op: op, timestamp: now()}),
126  result.success ? update(σfs₄, result) : update(σfs₃, result)
127}
128 
129## ⚠️ Filesystem Safety Protocols
130 
131// Filesystem validation function
132Υ_fs = {
133  validate_path(path) = path_exists(path) ∧ path ∈ Φ_fs.allowed(),
134  validate_content(content) = content_safe(content) ∧ content_size_valid(content),
135  validate_operation(op, Ω) = op ∈ MΦ(Ω) ∧ Ξfs(op, Ω) ∧ verify_fs_protection(op, path)
136}
137 
138// Validate and execute filesystem operation
139execute_fs_op(op, ...args) = {
140  if (!has_mcp_filesystem()) {
141    return report_error("MCP Filesystem not available. Please install @modelcontextprotocol/server-filesystem.")
142  }
143  
144  if (Υ_fs.validate_operation(op, current_mode)) {
145    if (is_destructive(op)) {
146      warn("This operation will modify files") ∧ confirm ∧ Σ_backup.create_backup()
147    }
148    return op(...args)
149  } else {
150    return block_operation(op, "Filesystem operation not permitted in current mode")
151  }
152}
153 
154// Feature detection for MCP Filesystem
155has_mcp_filesystem() = {
156  try {
157    return Φ_fs.allowed() !== undefined
158  } catch {
159    return false
160  }
161}
162 
163// New safety protocol for filesystem operations
164Δ₇ = fs_destructive_op(op) ⟶ warn ∧ confirm ∧ Σ_backup.create_backup() ∧ op
165 
166## 🔗 Extended Cross-References
167 
168// Add filesystem references to cross-reference system
169χ_refs.filesystem = "[Γ₉:path/to/file.js]"  // Filesystem reference
170χ_refs.filesystem_op = "[Φ_fs.read:path/to/file.js]"  // Filesystem operation reference
171