feat: add mini.files support to claudecode.nvim

Add mini.files integration following the same pattern as netrw support.
- Add _get_mini_files_selection() function to integrations.lua
- Support both visual selection and single file under cursor
- Add comprehensive test suite with 12 test cases
- Handle error cases and edge conditions gracefully

Author: jdurand

lua/claudecode/integrations.lua

@@ -16,6 +16,8 @@ function M.get_selected_files_from_tree()
     return M._get_neotree_selection()
   elseif current_ft == "oil" then
     return M._get_oil_selection()
+  elseif current_ft == "minifiles" then
+    return M._get_mini_files_selection()
   else
     return nil, "Not in a supported tree buffer (current filetype: " .. current_ft .. ")"
   end
@@ -261,4 +263,58 @@ function M._get_oil_selection()
   return {}, "No file found under cursor"
 end
 
+--- Get selected files from mini.files
+--- Supports both visual selection and single file under cursor
+--- Reference: mini.files API MiniFiles.get_fs_entry()
+--- @return table files List of file paths
+--- @return string|nil error Error message if operation failed
+function M._get_mini_files_selection()
+  local success, mini_files = pcall(require, "mini.files")
+  if not success then
+    return {}, "mini.files not available"
+  end
+
+  local files = {}
+
+  -- Check if we're in visual mode for multi-selection
+  local mode = vim.fn.mode()
+  if mode == "V" or mode == "v" or mode == "\22" then
+    -- Visual mode: get visual range
+    local visual_commands = require("claudecode.visual_commands")
+    local start_line, end_line = visual_commands.get_visual_range()
+
+    -- Process each line in the visual selection
+    for line = start_line, end_line do
+      local entry_ok, entry = pcall(mini_files.get_fs_entry, nil, line)
+      if entry_ok and entry and entry.path then
+        -- Validate that the path exists
+        if vim.fn.filereadable(entry.path) == 1 or vim.fn.isdirectory(entry.path) == 1 then
+          table.insert(files, entry.path)
+        end
+      end
+    end
+
+    if #files > 0 then
+      return files, nil
+    end
+  else
+    -- Normal mode: get file under cursor
+    local entry_ok, entry = pcall(mini_files.get_fs_entry)
+    if not entry_ok or not entry then
+      return {}, "Failed to get entry from mini.files"
+    end
+
+    if entry.path and entry.path ~= "" then
+      -- Validate that the path exists
+      if vim.fn.filereadable(entry.path) == 1 or vim.fn.isdirectory(entry.path) == 1 then
+        return { entry.path }, nil
+      else
+        return {}, "Invalid file or directory path: " .. entry.path
+      end
+    end
+  end
+
+  return {}, "No file found under cursor"
+end
+
 return M

tests/unit/mini_files_integration_spec.lua

@@ -0,0 +1,282 @@
+-- luacheck: globals expect
+require("tests.busted_setup")
+
+describe("mini.files integration", function()
+  local integrations
+  local mock_vim
+
+  local function setup_mocks()
+    package.loaded["claudecode.integrations"] = nil
+    package.loaded["claudecode.logger"] = nil
+    package.loaded["claudecode.visual_commands"] = nil
+
+    -- Mock logger
+    package.loaded["claudecode.logger"] = {
+      debug = function() end,
+      warn = function() end,
+      error = function() end,
+    }
+
+    -- Mock visual_commands
+    package.loaded["claudecode.visual_commands"] = {
+      get_visual_range = function()
+        return 1, 3 -- Return lines 1-3 by default
+      end,
+    }
+
+    mock_vim = {
+      fn = {
+        mode = function()
+          return "n" -- Normal mode by default
+        end,
+        filereadable = function(path)
+          if path:match("%.lua$") or path:match("%.txt$") then
+            return 1
+          end
+          return 0
+        end,
+        isdirectory = function(path)
+          if path:match("/$") or path:match("/src$") then
+            return 1
+          end
+          return 0
+        end,
+      },
+      bo = { filetype = "minifiles" },
+    }
+
+    _G.vim = mock_vim
+  end
+
+  before_each(function()
+    setup_mocks()
+    integrations = require("claudecode.integrations")
+  end)
+
+  describe("_get_mini_files_selection", function()
+    it("should get single file under cursor", function()
+      -- Mock mini.files module
+      local mock_mini_files = {
+        get_fs_entry = function()
+          return { path = "/Users/test/project/main.lua" }
+        end,
+      }
+      package.loaded["mini.files"] = mock_mini_files
+
+      local files, err = integrations._get_mini_files_selection()
+
+      expect(err).to_be_nil()
+      expect(files).to_be_table()
+      expect(#files).to_be(1)
+      expect(files[1]).to_be("/Users/test/project/main.lua")
+    end)
+
+    it("should get directory under cursor", function()
+      -- Mock mini.files module
+      local mock_mini_files = {
+        get_fs_entry = function()
+          return { path = "/Users/test/project/src" }
+        end,
+      }
+      package.loaded["mini.files"] = mock_mini_files
+
+      local files, err = integrations._get_mini_files_selection()
+
+      expect(err).to_be_nil()
+      expect(files).to_be_table()
+      expect(#files).to_be(1)
+      expect(files[1]).to_be("/Users/test/project/src")
+    end)
+
+    it("should get multiple files in visual mode", function()
+      mock_vim.fn.mode = function()
+        return "V" -- Visual line mode
+      end
+
+      -- Mock mini.files module
+      local mock_mini_files = {
+        get_fs_entry = function(buf_id, line)
+          if line == 1 then
+            return { path = "/Users/test/project/file1.lua" }
+          elseif line == 2 then
+            return { path = "/Users/test/project/file2.lua" }
+          elseif line == 3 then
+            return { path = "/Users/test/project/src" }
+          end
+          return nil
+        end,
+      }
+      package.loaded["mini.files"] = mock_mini_files
+
+      local files, err = integrations._get_mini_files_selection()
+
+      expect(err).to_be_nil()
+      expect(files).to_be_table()
+      expect(#files).to_be(3)
+      expect(files[1]).to_be("/Users/test/project/file1.lua")
+      expect(files[2]).to_be("/Users/test/project/file2.lua")
+      expect(files[3]).to_be("/Users/test/project/src")
+    end)
+
+    it("should filter out invalid files in visual mode", function()
+      mock_vim.fn.mode = function()
+        return "V" -- Visual line mode
+      end
+
+      -- Mock mini.files module
+      local mock_mini_files = {
+        get_fs_entry = function(buf_id, line)
+          if line == 1 then
+            return { path = "/Users/test/project/valid.lua" }
+          elseif line == 2 then
+            return { path = "/Users/test/project/invalid.xyz" } -- Won't pass filereadable/isdirectory
+          elseif line == 3 then
+            return { path = "/Users/test/project/src" }
+          end
+          return nil
+        end,
+      }
+      package.loaded["mini.files"] = mock_mini_files
+
+      local files, err = integrations._get_mini_files_selection()
+
+      expect(err).to_be_nil()
+      expect(files).to_be_table()
+      expect(#files).to_be(2) -- Only valid.lua and src
+      expect(files[1]).to_be("/Users/test/project/valid.lua")
+      expect(files[2]).to_be("/Users/test/project/src")
+    end)
+
+    it("should handle empty entry under cursor", function()
+      -- Mock mini.files module
+      local mock_mini_files = {
+        get_fs_entry = function()
+          return nil -- No entry
+        end,
+      }
+      package.loaded["mini.files"] = mock_mini_files
+
+      local files, err = integrations._get_mini_files_selection()
+
+      expect(err).to_be("Failed to get entry from mini.files")
+      expect(files).to_be_table()
+      expect(#files).to_be(0)
+    end)
+
+    it("should handle entry with empty path", function()
+      -- Mock mini.files module
+      local mock_mini_files = {
+        get_fs_entry = function()
+          return { path = "" } -- Empty path
+        end,
+      }
+      package.loaded["mini.files"] = mock_mini_files
+
+      local files, err = integrations._get_mini_files_selection()
+
+      expect(err).to_be("No file found under cursor")
+      expect(files).to_be_table()
+      expect(#files).to_be(0)
+    end)
+
+    it("should handle invalid file path", function()
+      -- Mock mini.files module
+      local mock_mini_files = {
+        get_fs_entry = function()
+          return { path = "/Users/test/project/invalid_file" }
+        end,
+      }
+      package.loaded["mini.files"] = mock_mini_files
+
+      mock_vim.fn.filereadable = function()
+        return 0 -- File not readable
+      end
+      mock_vim.fn.isdirectory = function()
+        return 0 -- Not a directory
+      end
+
+      local files, err = integrations._get_mini_files_selection()
+
+      expect(err).to_be("Invalid file or directory path: /Users/test/project/invalid_file")
+      expect(files).to_be_table()
+      expect(#files).to_be(0)
+    end)
+
+    it("should handle mini.files not available", function()
+      -- Don't mock mini.files module (will cause require to fail)
+      package.loaded["mini.files"] = nil
+
+      local files, err = integrations._get_mini_files_selection()
+
+      expect(err).to_be("mini.files not available")
+      expect(files).to_be_table()
+      expect(#files).to_be(0)
+    end)
+
+    it("should handle pcall errors gracefully", function()
+      -- Mock mini.files module that throws errors
+      local mock_mini_files = {
+        get_fs_entry = function()
+          error("mini.files get_fs_entry failed")
+        end,
+      }
+      package.loaded["mini.files"] = mock_mini_files
+
+      local files, err = integrations._get_mini_files_selection()
+
+      expect(err).to_be("Failed to get entry from mini.files")
+      expect(files).to_be_table()
+      expect(#files).to_be(0)
+    end)
+
+    it("should handle visual mode with no valid entries", function()
+      mock_vim.fn.mode = function()
+        return "V" -- Visual line mode
+      end
+
+      -- Mock mini.files module
+      local mock_mini_files = {
+        get_fs_entry = function(buf_id, line)
+          return nil -- No entries
+        end,
+      }
+      package.loaded["mini.files"] = mock_mini_files
+
+      local files, err = integrations._get_mini_files_selection()
+
+      expect(err).to_be("No file found under cursor")
+      expect(files).to_be_table()
+      expect(#files).to_be(0)
+    end)
+  end)
+
+  describe("get_selected_files_from_tree", function()
+    it("should detect minifiles filetype and delegate to _get_mini_files_selection", function()
+      mock_vim.bo.filetype = "minifiles"
+
+      -- Mock mini.files module
+      local mock_mini_files = {
+        get_fs_entry = function()
+          return { path = "/path/test.lua" }
+        end,
+      }
+      package.loaded["mini.files"] = mock_mini_files
+
+      local files, err = integrations.get_selected_files_from_tree()
+
+      expect(err).to_be_nil()
+      expect(files).to_be_table()
+      expect(#files).to_be(1)
+      expect(files[1]).to_be("/path/test.lua")
+    end)
+
+    it("should return error for unsupported filetype", function()
+      mock_vim.bo.filetype = "unsupported"
+
+      local files, err = integrations.get_selected_files_from_tree()
+
+      assert_contains(err, "Not in a supported tree buffer")
+      expect(files).to_be_nil()
+    end)
+  end)
+end)