feat: Add Treesitter support, marks caching, and fixed-size UI

Add marks file caching in storage module that validates against file modification times to reduce I/O operations.
Implement comprehensive Treesitter integration for more accurate context detection when generating mark names, with fallback to regex patterns.
Redesign the UI with a fixed 80x20 window size, featuring dimmed help text at the bottom and visual separators between sections.

The changes maintain backward compatibility while providing significant performance gains through caching and more intelligent mark naming through Treesitter AST analysis.

Author: alexekdahl

README.md

@@ -18,12 +18,12 @@ Vim's built-in marks are great, but they're global and get messy fast. Marksman
 
 - **Project-scoped marks** - Each project gets its own isolated set of bookmarks
 - **Persistent storage** - Your marks survive Neovim restarts with automatic backup
-- **Smart naming** - Context-aware auto-generation based on code structure
+- **Smart naming** - Context-aware auto-generation using Treesitter and pattern matching
 - **Quick access** - Jump to marks with single keys or interactive UI
 - **Enhanced search** - Find marks by name, file path, or content with real-time filtering
 - **Mark reordering** - Move marks up/down to organize them as needed
 - **Multiple integrations** - Works with Telescope, Snacks.nvim, and more
-- **Memory efficient** - Lazy loading, cleanup, and debounced operations
+- **Memory efficient** - Lazy loading, marks caching, cleanup, and debounced operations
 - **Robust error handling** - Graceful fallbacks and comprehensive validation
 
 ## Requirements
@@ -135,6 +135,9 @@ require("marksman").setup({
     ProjectMarksFile = { fg = "#56B6C2" },
     ProjectMarksLine = { fg = "#D19A66" },
     ProjectMarksText = { fg = "#5C6370", italic = true },
+    ProjectMarksHelp = { fg = "#5C6370" },
+    ProjectMarksBorder = { fg = "#5A5F8C" },
+    ProjectMarksSeparator = { fg = "#3E4451" },
   },
 })
 ```
@@ -253,15 +256,19 @@ marksman.show_marks("optional_search")
 
 ## How it works
 
-**Storage**: Marks are stored in `~/.local/share/nvim/marksman_[hash].json` per project with automatic backup.
+**Storage**: Marks are stored in `~/.local/share/nvim/marksman_[hash].json` per project with automatic backup and caching for improved performance.
 
-**Smart Naming**: Auto-generates context-aware names:
+**Smart Naming**: Auto-generates context-aware names using Treesitter when available, falling back to pattern matching:
 - `fn:calculate_total` for functions
 - `class:UserModel` for classes  
 - `var:api_key` for variables
+- `method:process_data` for methods
+- `interface:Serializable` for interfaces
+- `trait:Iterator` for Rust traits
+- `type:Config` for type definitions
 - `filename:line` as fallback
 
-**Project Detection**: Uses Git root, common project files (.git, package.json, etc.), or current directory.
+**Project Detection**: Uses Git root, common project files (.git, package.json, etc.), or current directory with 30-second caching.
 
 **Search**: Multi-field search across mark names, file paths, and code content.
 

lua/marksman/storage.lua

@@ -16,6 +16,11 @@ local config = {}
 local project_root_cache = {}
 local cache_expiry = {}
 
+-- Cache for marks file
+local marks_cache = nil
+local marks_cache_timestamp = nil
+local marks_cache_project = nil
+
 ---Helper function for conditional notifications
 ---@param message string The notification message
 ---@param level number The log level
@@ -202,12 +207,23 @@ local function validate_marks_data(data)
 	return true
 end
 
----Load marks from storage file
+---Load marks from storage file with caching
 ---@return table marks The loaded marks
 local function load_marks()
 	current_project = get_project_root()
 	local file = get_marks_file()
 
+	-- Check cache validity
+	if marks_cache and marks_cache_project == current_project then
+		local file_mtime = vim.fn.getftime(file)
+		if file_mtime > 0 and marks_cache_timestamp == file_mtime then
+			-- Cache is valid, return cached data
+			marks = marks_cache.marks
+			mark_order = marks_cache.mark_order
+			return marks
+		end
+	end
+
 	-- Initialize empty state
 	marks = {}
 	mark_order = {}
@@ -246,6 +262,14 @@ local function load_marks()
 							end
 						end
 						mark_order = valid_order
+
+						-- Update cache
+						marks_cache = {
+							marks = vim.deepcopy(marks),
+							mark_order = vim.deepcopy(mark_order),
+						}
+						marks_cache_timestamp = vim.fn.getftime(file)
+						marks_cache_project = current_project
 					end
 				end
 			end
@@ -325,6 +349,14 @@ function M.save_marks()
 		if not rename_ok then
 			error("Failed to move temporary file to final location")
 		end
+
+		-- Update cache after successful save
+		marks_cache = {
+			marks = vim.deepcopy(marks),
+			mark_order = vim.deepcopy(mark_order),
+		}
+		marks_cache_timestamp = vim.fn.getftime(file)
+		marks_cache_project = current_project
 	end)
 
 	if not ok then
@@ -409,6 +441,10 @@ function M.add_mark(name, mark)
 	end
 
 	marks_data[name] = mark
+
+	-- Invalidate cache for immediate update
+	marks_cache = nil
+
 	return true -- Save is handled by debounced save in main module
 end
 
@@ -429,6 +465,9 @@ function M.delete_mark(name)
 			end
 		end
 
+		-- Invalidate cache
+		marks_cache = nil
+
 		return true
 	end
 
@@ -466,6 +505,9 @@ function M.rename_mark(old_name, new_name)
 		end
 	end
 
+	-- Invalidate cache
+	marks_cache = nil
+
 	return true
 end
 
@@ -505,6 +547,9 @@ function M.move_mark(name, direction)
 	-- Swap positions
 	mark_order[current_index], mark_order[new_index] = mark_order[new_index], mark_order[current_index]
 
+	-- Invalidate cache
+	marks_cache = nil
+
 	return true
 end
 
@@ -513,6 +558,10 @@ end
 function M.clear_all_marks()
 	marks = {}
 	mark_order = {}
+
+	-- Invalidate cache
+	marks_cache = nil
+
 	return true
 end
 
@@ -628,6 +677,9 @@ function M.import_marks()
 							return { success = false, message = "Import cancelled" }
 						end
 
+						-- Invalidate cache
+						marks_cache = nil
+
 						if M.save_marks() then
 							notify("󰃀 Marks imported successfully", vim.log.levels.INFO)
 							return { success = true, message = "Marks imported successfully" }
@@ -665,6 +717,9 @@ function M.cleanup()
 	-- Clear caches
 	project_root_cache = {}
 	cache_expiry = {}
+	marks_cache = nil
+	marks_cache_timestamp = nil
+	marks_cache_project = nil
 
 	-- Reset state
 	marks = {}