feat: ✨ first commit

s0cks · s0cks · commit ee3474769d54 · 2025-12-12T17:13:00.000-05:00
diff --git a/.commitlintrc.mjs b/.commitlintrc.mjs
@@ -0,0 +1,5 @@
+export default {
+  extends: [
+    '@commitlint/config-conventional'
+  ]
+}
diff --git a/.editorconfig b/.editorconfig
@@ -0,0 +1,8 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
diff --git a/.gitattributes b/.gitattributes
@@ -0,0 +1,2 @@
+*.mjs linguist-vendored
+*.js linguist-vendored
diff --git a/.gitignore b/.gitignore
diff --git a/.lefthook.yml b/.lefthook.yml
@@ -0,0 +1,17 @@
+# https://lefthook.dev/configuration/index.html
+prepare-commit-msg:
+  commands:
+    commitizen:
+      interactive: true
+      run: npx cz --hook
+      env:
+        LEFTHOOK: 0
+commit-msg:
+  commands:
+    "lint commit message":
+      run: npx commitlint --edit {1}
+pre-commit:
+  commands:
+    "detect secrets":
+      files: git diff --name-only --diff-filter=d --staged
+      run: gitleaks protect --no-banner --staged --redact --verbose 
diff --git a/.luacheckrc b/.luacheckrc
diff --git a/.luarc.json b/.luarc.json
diff --git a/.releaserc b/.releaserc
diff --git a/.stylua.toml b/.stylua.toml
diff --git a/README.md b/README.md
@@ -0,0 +1,35 @@
+# taskfile.nvim
+
+Neovim plugin for working w/ [Taskfiles](https://taskfile.dev/)
+
+## Installation
+
+<details>
+  <summary>Lazy</summary>
+
+  ```lua
+  {
+    's0cks/taskfile.nvim',
+    version = '*',
+    dependencies = {
+      'folke/snacks.nvim',
+    },
+    opts = {},
+  }
+  ```
+
+</details>
+
+### Dependencies
+
+- [Snacks](https://github.com/folke/snacks.nvim)
+- [taskfile-language-server](https://github.com/s0cks/taskfile-language-server)
+
+## Task Picker
+
+The task picker allows you to fuzzy-find a task and run it using Snacks.
+
+```lua
+require('taskfile.picker').task_picker()
+```
+
diff --git a/Taskfile.yml b/Taskfile.yml
@@ -0,0 +1,6 @@
+---
+version: '3'
+tasks:
+  default:
+    cmds:
+    - echo "This is a test"
diff --git a/lua/taskfile.lua b/lua/taskfile.lua
@@ -0,0 +1,55 @@
+local M = {}
+
+---@param ft string The filetype
+---@param filenames table<string> The list of files
+local function add_filetype_for_filenames(ft, filenames)
+	local filename = {}
+	for _, f in ipairs(filenames) do
+		filename[f] = ft
+	end
+	vim.filetype.add({
+		filename = filename,
+	})
+end
+
+---@class taskfile.Config : vim.lsp.Config
+M.config = {
+	notify = true,
+	cmd = {
+		"taskfile-language-server",
+	},
+	filetypes = {
+		"yaml.taskfile",
+	},
+	root_markers = {
+		".git",
+	},
+}
+
+---@param opts? taskfile.Config
+M.setup = function(opts)
+	M.config = vim.tbl_deep_extend("force", M.config, opts or {})
+	add_filetype_for_filenames("yaml.taskfile", {
+		"Taskfile.yaml",
+		"Taskfile.yml",
+	})
+	vim.lsp.config("taskfile", {
+		cmd = M.config.cmd,
+		root_markers = M.config.root_markers,
+		filetypes = M.config.filetypes,
+		on_attach = function(client, bufnr)
+			vim.lsp.completion.enable(true, client.id, bufnr, { autotrigger = true })
+
+			if M.config.notify then
+				vim.notify("taskfile-language-server attached", vim.log.levels.DEBUG)
+			end
+
+			if M.config.on_attach then
+				M.config.on_attach(client, bufnr)
+			end
+		end,
+	})
+	vim.lsp.enable("taskfile")
+end
+
+return M
diff --git a/lua/taskfile/actions.lua b/lua/taskfile/actions.lua
@@ -0,0 +1,15 @@
+local M = {}
+
+---@param opts? taskfile.runner.RunOpts
+M.run = function(opts)
+	return function(picker, item)
+		picker:close()
+		if item then
+			vim.schedule(function()
+				require("taskfile.runner").run(item.value, opts)
+			end)
+		end
+	end
+end
+
+return M
diff --git a/lua/taskfile/finder.lua b/lua/taskfile/finder.lua
@@ -0,0 +1,35 @@
+local M = {}
+
+---@param req? taskfile.lsp.GetTasksRequest
+function M.task_finder(req)
+	return function()
+		local lsp = require("taskfile.lsp")
+		local client = lsp.find_taskfile_client()
+
+		if not client then
+			print("failed to find taskfile LSP client")
+			return {}
+		end
+
+		local data, error = lsp.get_tasks_request_sync(client, req)
+		if error then
+			print("LSP error: " .. vim.inspect(error))
+			return {}
+		elseif not data then
+			print("LSP returned empty response")
+			return {}
+		end
+
+		local items = {}
+		for _, task in ipairs(data) do
+			table.insert(items, {
+				text = task.task.value,
+				value = task.task.value,
+			})
+		end
+
+		return items
+	end
+end
+
+return M
diff --git a/lua/taskfile/lsp.lua b/lua/taskfile/lsp.lua
@@ -0,0 +1,83 @@
+local M = {}
+
+---@class taskfile.find_taskfile_client_opts
+---@field bufnr? number The buffer number to use to search attached lsp clients. defaults to 0, the current buffer
+---@field client_name? string The client name to search for. defaults to 'taskfile'
+local default_find_taskfile_client_opts = {
+	bufnr = 0,
+	client_name = "taskfile",
+}
+
+---@param opts? taskfile.find_taskfile_client_opts
+---@return vim.lsp.Client|nil
+function M.find_taskfile_client(opts)
+	opts = vim.tbl_deep_extend("force", default_find_taskfile_client_opts, opts or {})
+	local clients = vim.lsp.get_clients({ bufnr = opts.bufnr })
+
+	if #clients == 0 then
+		---TODO(@s0cks): probably should log this somehow?
+		return nil
+	end
+
+	for _, client in ipairs(clients) do
+		if client.name == opts.client_name then
+			return client
+		end
+	end
+
+	return nil
+end
+
+---@class taskfile.lsp.GetTasksRequest
+---@field fsPath? string The absolute path of the Taskfile to query
+local default_get_tasks_request = {}
+
+---@param client vim.lsp.Client The client to make the request w/
+---@param req? taskfile.lsp.GetTasksRequest The request to make
+function M.get_tasks_request_sync(client, req)
+	req = vim.tbl_deep_extend("force", default_get_tasks_request, req or {})
+	if not req.fsPath then
+		req.fsPath = vim.fn.expand("%p")
+	end
+	local data, error = client:request_sync("extension/getTasks", req)
+	if error then
+		---TODO(@s0cks): probaby should log this, client side error
+		---print("LSP client error: " .. vim.inspect(error))
+		return nil, error
+	elseif not data then
+		---TODO(@s0cks): probably should also log this, LSP returned empty response
+		---print("LSP no data returned")
+		return {}, nil
+	elseif data.err then
+		---TODO(@s0cks): probably should log this, LSP responded w/ an error
+		---print("LSP responded w/ error: " .. vim.inspect(data.err))
+		return nil, data.err
+	end
+	return data.result, nil
+end
+
+---@param client vim.lsp.Client The client to make the request w/
+---@param req? taskfile.lsp.GetTasksRequest The request to make
+function M.get_vars_request_sync(client, req)
+	req = vim.tbl_deep_extend("force", default_get_tasks_request, req)
+	if not req.fsPath then
+		req.fsPath = vim.fn.expand("%p")
+	end
+	local data, error = client:request_sync("extension/getVars", req)
+	if error then
+		---TODO(@s0cks): probaby should log this, client side error
+		---print("LSP client error: " .. vim.inspect(error))
+		return nil, error
+	elseif not data then
+		---TODO(@s0cks): probably should also log this, LSP returned empty response
+		---print("LSP no data returned")
+		return {}, nil
+	elseif data.err then
+		---TODO(@s0cks): probably should log this, LSP responded w/ an error
+		---print("LSP responded w/ error: " .. vim.inspect(data.err))
+		return nil, data.err
+	end
+	return data.result, nil
+end
+
+return M
diff --git a/lua/taskfile/picker.lua b/lua/taskfile/picker.lua
@@ -0,0 +1,25 @@
+local M = {}
+
+---@class taskfile.picker.TaskPickerOpts : snacks.picker.Config
+---@field req? taskfile.lsp.GetTasksRequest
+---@field run? taskfile.runner.RunOpts
+local default_task_picker_opts = {}
+
+---@param opts? taskfile.picker.TaskPickerOpts
+function M.task_picker(opts)
+	opts = vim.tbl_deep_extend("force", default_task_picker_opts, opts or {})
+	local finders = require("taskfile.finder")
+	Snacks.picker.pick({
+		source = "tasks",
+		finder = finders.task_finder(opts.req),
+		title = "Taskfile tasks",
+		format = "text",
+		layout = {
+			preset = "vertical",
+		},
+		preview = "none",
+		confirm = opts.confirm or (require("taskfile.actions").run(opts.run)),
+	})
+end
+
+return M
diff --git a/lua/taskfile/runner.lua b/lua/taskfile/runner.lua
@@ -0,0 +1,25 @@
+local M = {}
+
+---@class taskfile.runner.RunOpts : snacks.terminal.Opts
+---@field exec? string The task executable path
+local default_run_opts = {
+	exec = "task",
+	notify = true,
+}
+
+---@param task string The task to run
+---@param opts? taskfile.runner.RunOpts
+function M.run(task, opts)
+	opts = vim.tbl_deep_extend("force", default_run_opts, opts or {})
+
+	if opts.notify then
+		vim.notify("starting task " .. task, vim.log.levels.INFO)
+	end
+
+	Snacks.terminal.open(opts.exec .. " " .. task, --[[@as snacks.terminal.Opts ]] {
+		auto_close = false,
+		interactive = true,
+	})
+end
+
+return M
diff --git a/lua/taskfile/task.lua b/lua/taskfile/task.lua
@@ -0,0 +1,3 @@
+
+---@class taskfile.Task
+---@field id string The id of the task

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+*.mjs linguist-vendored`
	`2`	`+*.js linguist-vendored`