feat(recipes): add harpoon-bufsync recipe

Author: p0uyaDev

lua/astrocommunity/recipes/harpoon-bufsync/README.md

@@ -0,0 +1,21 @@
+# Harpoon BufSync
+
+Sync your AstroNvim buffer tabline to your Harpoon marks — close, open, and sort buffers based on your pinned files.
+
+## Overview
+
+Harpoon lets you pin frequently-used files for quick navigation. But your tabline (Heirline) doesn't reflect that order — it tracks buffers by open-time and internal buffer ID. This recipe bridges that gap: with a single keybind (`<Leader>bsh`), it closes non-Harpoon buffers, opens missing Harpoon files, and sorts the tabline to match your Harpoon order.
+
+## Requirements
+
+- [Harpoon v2](https://github.com/ThePrimeagen/harpoon) (branch `harpoon2`)
+- [AstroCore](https://github.com/AstroNvim/astrocore) (bundled with AstroNvim)
+- [Heirline](https://github.com/rebelot/heirline.nvim) (AstroNvim default tabline)
+
+## Installation
+
+Add to your `community.lua`:
+
+```lua
+{ import = "astrocommunity.recipes.harpoon-bufsync" },
+```

lua/astrocommunity/recipes/harpoon-bufsync/init.lua

@@ -0,0 +1,66 @@
+return {
+  {
+    "AstroNvim/astrocore",
+    ---@param opts AstroCoreOpts
+    opts = function(_, opts)
+      opts.mappings = opts.mappings or {}
+      opts.mappings.n = opts.mappings.n or {}
+
+      -- Sync tabline buffers to Harpoon mark order
+      opts.mappings.n["<Leader>bsh"] = {
+        function()
+          local harpoon = require "harpoon"
+          local harpoon_items = harpoon:list().items
+
+          -- Build path -> harpoon index map
+          local harpoon_order = {}
+          for i, item in ipairs(harpoon_items) do
+            local path = vim.fn.fnamemodify(item.value, ":p")
+            harpoon_order[path] = i
+          end
+
+          -- Get current tab's buffer list (this IS the tabline order)
+          local bufs = vim.t.bufs or {}
+
+          -- Close buffers NOT in Harpoon list
+          for _, bufnr in ipairs(bufs) do
+            if require("astrocore.buffer").is_valid(bufnr) then
+              local buf_path = vim.fn.fnamemodify(vim.api.nvim_buf_get_name(bufnr), ":p")
+              if not harpoon_order[buf_path] then require("astrocore.buffer").close(bufnr) end
+            end
+          end
+
+          -- Open Harpoon files that aren't open yet
+          local open_paths = {}
+          for _, bufnr in ipairs(vim.t.bufs or {}) do
+            open_paths[vim.fn.fnamemodify(vim.api.nvim_buf_get_name(bufnr), ":p")] = true
+          end
+
+          for _, item in ipairs(harpoon_items) do
+            local path = vim.fn.fnamemodify(item.value, ":p")
+            if not open_paths[path] and vim.fn.filereadable(path) == 1 then
+              vim.cmd("edit " .. vim.fn.fnameescape(path))
+            end
+          end
+
+          -- Re-sort vim.t.bufs by Harpoon order
+          local new_order = {}
+          for _, bufnr in ipairs(vim.t.bufs or {}) do
+            local buf_path = vim.fn.fnamemodify(vim.api.nvim_buf_get_name(bufnr), ":p")
+            if harpoon_order[buf_path] then
+              table.insert(new_order, { idx = harpoon_order[buf_path], bufnr = bufnr })
+            end
+          end
+          table.sort(new_order, function(a, b) return a.idx < b.idx end)
+
+          -- Write back the sorted order
+          vim.t.bufs = vim.tbl_map(function(item) return item.bufnr end, new_order)
+
+          -- Refresh the tabline
+          vim.cmd "redrawtabline"
+        end,
+        desc = "Sort by Harpoon",
+      }
+    end,
+  },
+}