barrett/pending.nvim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 4

feat(file-token): file: inline metadata token with gf navigation (#45)

Browse source 
* feat(file-token): add file: inline metadata token with gf navigation

Problem: there was no way to link a task to a specific location in a
source file, or to quickly jump from a task to the relevant code.

Solution: add a file:<path>:<line> inline token that stores a relative
file reference in task._extra.file. Virtual text renders basename:line
in a new PendingFile highlight group. A buffer-local gf mapping
(configurable via keymaps.goto_file) opens the file at the given line.
M.add_here() lets users attach the current cursor position to any task
via vim.ui.select(). M.edit() gains -file support to clear the
reference. <Plug>(pending-goto-file) and <Plug>(pending-add-here) are
exposed for custom mappings.

* test(file-token): add parse, diff, views, edit, and navigation tests

Problem: the file: token implementation had no test coverage.

Solution: add spec/file_spec.lua covering parse.body extraction,
malformed token handling, duplicate token stop-parsing, diff
reconciliation (store/update/clear/round-trip), LineMeta population
in both views, :Pending edit -file, and goto_file notify paths for
no-file and unreadable-file cases. All 292 tests pass.

* style: apply stylua formatting

* fix(types): remove empty elseif block, fix file? annotation nullability
This commit is contained in:
Barrett Ruth 2026-02-26 19:12:48 -05:00
parent de0dc564cf
commit a2e0e296ac
10 changed files with 605 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

17
lua/pending/parse.lua
View file

@ -416,7 +416,7 @@ end
---@param text string
---@return string description
---@return { due?: string, cat?: string, rec?: string, rec_mode?: 'scheduled'|'completion' } metadata
---@return { due?: string, cat?: string, rec?: string, rec_mode?: 'scheduled'|'completion', file?: string? } metadata
function M.body(text)
local tokens = {}
for token in text:gmatch('%S+') do
@ -481,7 +481,18 @@ function M.body(text)
metadata.rec = raw_spec
i = i - 1
else
break
local file_path_val, file_line_val = token:match('^file:(.+):(%d+)$')
if file_path_val and file_line_val then
if metadata.file then
break
end
metadata.file = file_path_val .. ':' .. file_line_val
i = i - 1
elseif token:match('^file:') then
break
else
break
end
end
end
end
@ -499,7 +510,7 @@ end
---@param text string
---@return string description
---@return { due?: string, cat?: string, rec?: string, rec_mode?: 'scheduled'|'completion' } metadata
---@return { due?: string, cat?: string, rec?: string, rec_mode?: 'scheduled'|'completion', file?: string? } metadata
function M.command_add(text)
local cat_prefix = text:match('^(%S.-):%s')
if cat_prefix then