refactor(commands): 🔄 ⚠️ Add deprecation warnings for commands

Author: GeorgesAlkhouri

plugin/nvim_aider.lua

@@ -36,37 +36,71 @@ end, {
   end,
 })
 
-vim.api.nvim_create_user_command("AiderHealth", function()
-  require("nvim_aider.api").health_check()
-end, { desc = "Run nvim-aider health check" })
+-- Track which deprecation warnings have been shown
+local deprecated_shown = {}
 
-vim.api.nvim_create_user_command("AiderTerminalToggle", function()
-  require("nvim_aider.api").toggle_terminal()
-end, { desc = "Toggle Aider terminal" })
+-- Create a wrapper function for deprecated commands
+local function create_deprecated_handler(cmd, replacement, handler)
+  return function(opts)
+    if not deprecated_shown[cmd] then
+      vim.notify(
+        ("`%s` is deprecated and will be removed in future versions - use `%s` instead"):format(cmd, replacement),
+        vim.log.levels.WARN,
+        { title = "nvim-aider" }
+      )
+      deprecated_shown[cmd] = true
+    end
+    handler(opts)
+  end
+end
 
-vim.api.nvim_create_user_command("AiderTerminalSend", function(args)
-  require("nvim_aider.api").send_to_terminal(args.args)
-end, { nargs = "?", range = true, desc = "Send text to Aider terminal" })
+vim.api.nvim_create_user_command(
+  "AiderHealth",
+  create_deprecated_handler("AiderHealth", "Aider health", function()
+    require("nvim_aider.api").health_check()
+  end),
+  { desc = "Run nvim-aider health check" }
+)
 
-vim.api.nvim_create_user_command("AiderQuickSendCommand", function()
-  require("nvim_aider.api").open_command_picker()
-end, { desc = "Send Aider slash command to Aider terminal" })
+vim.api.nvim_create_user_command(
+  "AiderTerminalToggle",
+  create_deprecated_handler("AiderTerminalToggle", "Aider toggle", function()
+    require("nvim_aider.api").toggle_terminal()
+  end),
+  { desc = "Toggle Aider terminal" }
+)
 
-vim.api.nvim_create_user_command("AiderQuickSendBuffer", function()
-  require("nvim_aider.api").send_buffer_with_prompt()
-end, { desc = "Send buffer to Aider terminal" })
+vim.api.nvim_create_user_command(
+  "AiderTerminalSend",
+  create_deprecated_handler("AiderTerminalSend", "Aider send", function(args)
+    require("nvim_aider.api").send_to_terminal(args.args)
+  end),
+  { nargs = "?", range = true, desc = "Send text to Aider terminal" }
+)
 
-vim.api.nvim_create_user_command("AiderQuickAddFile", function()
-  require("nvim_aider.api").add_current_file()
-end, { desc = "Add current file to Aider session" })
+vim.api.nvim_create_user_command(
+  "AiderQuickSendCommand",
+  create_deprecated_handler("AiderQuickSendCommand", "Aider command", function()
+    require("nvim_aider.api").open_command_picker()
+  end),
+  { desc = "Send Aider slash command to Aider terminal" }
+)
 
-vim.api.nvim_create_user_command("AiderQuickDropFile", function()
-  require("nvim_aider.api").drop_current_file()
-end, { desc = "Remove current file from Aider session" })
+vim.api.nvim_create_user_command(
+  "AiderQuickSendBuffer",
+  create_deprecated_handler("AiderQuickSendBuffer", "Aider buffer", function()
+    require("nvim_aider.api").send_buffer_with_prompt()
+  end),
+  { desc = "Send buffer to Aider terminal" }
+)
 
-vim.api.nvim_create_user_command("AiderQuickReadOnlyFile", function()
-  require("nvim_aider.api").add_read_only_file()
-end, { desc = "Add current file as read-only to Aider session" })
+vim.api.nvim_create_user_command(
+  "AiderQuickAddFile",
+  create_deprecated_handler("AiderQuickAddFile", "Aider add", function()
+    require("nvim_aider.api").add_current_file()
+  end),
+  { desc = "Add current file to Aider session" }
+)
 
 -- Add nvim-tree integration commands if available
 local ok, _ = pcall(require, "nvim-tree")