* docs: document S3 backend, auto-auth, and `:Pending done` command Problem: The S3 backend had no `:Pending s3` entry in the COMMANDS section, `:Pending auth` only mentioned Google, the `sync` config field omitted `s3`, `_s3_sync_id` was missing from the data format section, `:Pending done` was implemented but undocumented, and the README lacked a features overview. Solution: Add `:Pending s3` and `:Pending done` command docs, rewrite `:Pending auth` to cover all backends and sub-actions, update config and data format references, add `aws` CLI to requirements, and add a Features section to `README.md`. * feat(forge): add forge link parser and metadata fetcher Problem: no way to associate tasks with GitHub, GitLab, or Codeberg issues/PRs, or to track their remote state. Solution: add `forge.lua` with shorthand (`gh:user/repo#42`) and full URL parsing, async metadata fetching via `curl`, label formatting, conceal pattern generation, token resolution, and `refresh()` for state pull (closed/merged -> done). * feat(config): add forge config defaults and `%l` eol specifier Problem: no configuration surface for forge link rendering, icons, issue format, or self-hosted instances. Solution: add `pending.ForgeConfig` class with per-forge `token`, `icon`, `issue_format`, and `instances` fields. Add `%l` to the default `eol_format` so forge labels render in virtual text. * feat(parse): extract forge refs from task body Problem: `parse.body()` had no awareness of forge link tokens, so `gh:user/repo#42` stayed in the description instead of metadata. Solution: add `forge_ref` field to `pending.Metadata` and extend the right-to-left token loop in `body()` to call `forge.parse_ref()` as the final fallback before breaking. * feat(diff): persist forge refs in store on write Problem: forge refs parsed from buffer lines were discarded during diff reconciliation and never stored in the JSON. Solution: thread `forge_ref` through `parse_buffer` entries into `diff.apply`, storing it in `task._extra._forge_ref` for both new and existing tasks. * feat(views): pass forge ref and cache to line metadata Problem: `LineMeta` had no forge fields, so `buffer.lua` could not render forge labels or apply forge-specific highlights. Solution: add `forge_ref` and `forge_cache` fields to `LineMeta`, populated from `task._extra` in both `category_view` and `priority_view`. * feat(buffer): render forge links as concealed text with eol virt text Problem: forge tokens were visible as raw text with no virtual text labels, and the eol separator logic collapsed all gaps when non-adjacent specifiers were absent. Solution: add forge conceal syntax patterns in `setup_syntax()`, add `PendingForge`/`PendingForgeClosed` highlight groups, handle the `%l` specifier in `build_eol_virt()`, fix separator collapsing to buffer one separator between present segments, and change `concealcursor` to `nc` (reveal in visual and insert mode). * feat(complete): add forge shorthand omnifunc completions Problem: no completion support for `gh:`, `gl:`, or `cb:` tokens, requiring users to type owner/repo from memory. Solution: extend `omnifunc` to detect `gh:`/`gl:`/`cb:` prefixes and complete with `owner/repo#` candidates from existing forge refs in the store. * feat: trigger forge refresh on buffer open Problem: forge metadata was never fetched, so virt text highlights could not reflect remote issue/PR state. Solution: call `forge.refresh()` in `M.open()` so metadata is fetched once per `:Pending` invocation rather than on every render. * test(forge): add forge parsing spec Problem: no test coverage for forge link shorthand parsing, URL parsing, label formatting, or API URL generation. Solution: add `spec/forge_spec.lua` covering `_parse_shorthand`, `parse_ref` for all three forges, full URL parsing including nested GitLab groups, `format_label`, and `_api_url`. * docs: document forge links feature Problem: no user-facing documentation for forge link syntax, configuration, or behavior. Solution: add forge links section to `README.md` and `pending.txt` covering shorthand/URL syntax, config options, virtual text rendering, state pull, and auth resolution. * feat(forge): add `find_refs()` inline token scanner Problem: forge tokens were extracted by `parse.body()` which stripped them from the description, making editing awkward and multi-ref lines impossible. Solution: add `find_refs(text)` that scans a string for all forge tokens by whitespace tokenization, returning byte offsets and parsed refs without modifying the input. Remove unused `conceal_patterns()`. * refactor: move forge ref detection from `parse.body()` to `diff` Problem: `parse.body()` stripped forge tokens from the description, losing the raw text. This made inline overlay rendering impossible since the token no longer existed in the buffer. Solution: remove the `forge.parse_ref()` branch from `parse.body()` and call `forge.find_refs()` in `diff.parse_buffer()` instead. The description now retains forge tokens verbatim; `_extra._forge_ref` is still populated from the first matched ref. * feat(buffer): render forge links as inline conceal overlays Problem: forge tokens were stripped from the buffer and shown as EOL virtual text via `%l`. The token disappeared from the editable line, and multi-ref tasks broke. Solution: compute `forge_spans` in `views.lua` with byte offsets for each forge token in the rendered line. In `apply_inline_row()`, place extmarks with `conceal=''` and `virt_text_pos='inline'` to visually replace each raw token with its formatted label. Clear stale `forge_spans` on dirty rows to prevent `end_col` out-of-range errors after edits like `dd`. * fix(config): remove `%l` from default `eol_format` Problem: forge links are now rendered inline, making the `%l` EOL specifier redundant in the default format. Solution: change default `eol_format` from `'%l %c %r %d'` to `'%c %r %d'`. The `%l` specifier remains functional for users who explicitly set it. * test(forge): update specs for inline forge refs Problem: existing tests asserted that `parse.body()` stripped forge tokens from the description and populated `meta.forge_ref`. The `conceal_patterns` test referenced a removed function. Solution: update `parse.body` integration tests to assert tokens stay in the description. Add `find_refs()` tests covering single/multiple refs, URLs, byte offsets, and empty cases. Remove `conceal_patterns` test. Update diff tests to assert description includes the token. * docs: update forge links for inline overlay rendering Problem: documentation described forge tokens as stripped from the description and rendered via EOL `%l` specifier by default. Solution: update forge links section to describe inline conceal overlay rendering. Update default `eol_format` reference. Change `issue_format` field description from "EOL label" to "inline overlay label". * ci: format
198 lines
5.7 KiB
Lua
198 lines
5.7 KiB
Lua
local config = require('pending.config')
|
|
|
|
---@class pending.CompletionItem
|
|
---@field word string
|
|
---@field info string
|
|
|
|
---@class pending.complete
|
|
local M = {}
|
|
|
|
---@return string
|
|
local function date_key()
|
|
return config.get().date_syntax or 'due'
|
|
end
|
|
|
|
---@return string
|
|
local function recur_key()
|
|
return config.get().recur_syntax or 'rec'
|
|
end
|
|
|
|
---@return string[]
|
|
local function get_categories()
|
|
local s = require('pending.buffer').store()
|
|
if not s then
|
|
return {}
|
|
end
|
|
local seen = {}
|
|
local result = {}
|
|
for _, task in ipairs(s:active_tasks()) do
|
|
local cat = task.category
|
|
if cat and not seen[cat] then
|
|
seen[cat] = true
|
|
table.insert(result, cat)
|
|
end
|
|
end
|
|
table.sort(result)
|
|
return result
|
|
end
|
|
|
|
---@return pending.CompletionItem[]
|
|
local function date_completions()
|
|
return {
|
|
{ word = 'today', info = "Today's date" },
|
|
{ word = 'tomorrow', info = "Tomorrow's date" },
|
|
{ word = 'yesterday', info = "Yesterday's date" },
|
|
{ word = '+1d', info = '1 day from today' },
|
|
{ word = '+2d', info = '2 days from today' },
|
|
{ word = '+3d', info = '3 days from today' },
|
|
{ word = '+1w', info = '1 week from today' },
|
|
{ word = '+2w', info = '2 weeks from today' },
|
|
{ word = '+1m', info = '1 month from today' },
|
|
{ word = 'mon', info = 'Next Monday' },
|
|
{ word = 'tue', info = 'Next Tuesday' },
|
|
{ word = 'wed', info = 'Next Wednesday' },
|
|
{ word = 'thu', info = 'Next Thursday' },
|
|
{ word = 'fri', info = 'Next Friday' },
|
|
{ word = 'sat', info = 'Next Saturday' },
|
|
{ word = 'sun', info = 'Next Sunday' },
|
|
{ word = 'eod', info = 'End of day (today)' },
|
|
{ word = 'eow', info = 'End of week (Sunday)' },
|
|
{ word = 'eom', info = 'End of month' },
|
|
{ word = 'eoq', info = 'End of quarter' },
|
|
{ word = 'eoy', info = 'End of year (Dec 31)' },
|
|
{ word = 'sow', info = 'Start of week (Monday)' },
|
|
{ word = 'som', info = 'Start of month' },
|
|
{ word = 'soq', info = 'Start of quarter' },
|
|
{ word = 'soy', info = 'Start of year (Jan 1)' },
|
|
{ word = 'later', info = 'Someday (sentinel date)' },
|
|
{ word = 'today@08:00', info = 'Today at 08:00' },
|
|
{ word = 'today@09:00', info = 'Today at 09:00' },
|
|
{ word = 'today@10:00', info = 'Today at 10:00' },
|
|
{ word = 'today@12:00', info = 'Today at 12:00' },
|
|
{ word = 'today@14:00', info = 'Today at 14:00' },
|
|
{ word = 'today@17:00', info = 'Today at 17:00' },
|
|
}
|
|
end
|
|
|
|
---@type table<string, string>
|
|
local recur_descriptions = {
|
|
daily = 'Every day',
|
|
weekdays = 'Monday through Friday',
|
|
weekly = 'Every week',
|
|
biweekly = 'Every 2 weeks',
|
|
monthly = 'Every month',
|
|
quarterly = 'Every 3 months',
|
|
yearly = 'Every year',
|
|
['2d'] = 'Every 2 days',
|
|
['3d'] = 'Every 3 days',
|
|
['2w'] = 'Every 2 weeks',
|
|
['3w'] = 'Every 3 weeks',
|
|
['2m'] = 'Every 2 months',
|
|
['3m'] = 'Every 3 months',
|
|
['6m'] = 'Every 6 months',
|
|
['2y'] = 'Every 2 years',
|
|
}
|
|
|
|
---@return pending.CompletionItem[]
|
|
local function recur_completions()
|
|
local recur = require('pending.recur')
|
|
local list = recur.shorthand_list()
|
|
local result = {}
|
|
for _, s in ipairs(list) do
|
|
local desc = recur_descriptions[s] or s
|
|
table.insert(result, { word = s, info = desc })
|
|
end
|
|
for _, s in ipairs(list) do
|
|
local desc = recur_descriptions[s] or s
|
|
table.insert(result, { word = '!' .. s, info = desc .. ' (from completion date)' })
|
|
end
|
|
return result
|
|
end
|
|
|
|
---@type string?
|
|
local _complete_source = nil
|
|
|
|
---@param findstart integer
|
|
---@param base string
|
|
---@return integer|table[]
|
|
function M.omnifunc(findstart, base)
|
|
if findstart == 1 then
|
|
local line = vim.api.nvim_get_current_line()
|
|
local col = vim.api.nvim_win_get_cursor(0)[2]
|
|
local before = line:sub(1, col)
|
|
|
|
local dk = date_key()
|
|
local rk = recur_key()
|
|
|
|
local checks = {
|
|
{ vim.pesc(dk) .. ':([%S]*)$', dk },
|
|
{ 'cat:([%S]*)$', 'cat' },
|
|
{ vim.pesc(rk) .. ':([%S]*)$', rk },
|
|
{ 'gh:([%S]*)$', 'gh' },
|
|
{ 'gl:([%S]*)$', 'gl' },
|
|
{ 'cb:([%S]*)$', 'cb' },
|
|
}
|
|
|
|
for _, check in ipairs(checks) do
|
|
local start = before:find(check[1])
|
|
if start then
|
|
local colon_pos = before:find(':', start, true)
|
|
if colon_pos then
|
|
_complete_source = check[2]
|
|
return colon_pos
|
|
end
|
|
end
|
|
end
|
|
|
|
_complete_source = nil
|
|
return -1
|
|
end
|
|
|
|
local matches = {}
|
|
local source = _complete_source or ''
|
|
|
|
local dk = date_key()
|
|
local rk = recur_key()
|
|
|
|
if source == dk then
|
|
for _, c in ipairs(date_completions()) do
|
|
if base == '' or c.word:sub(1, #base) == base then
|
|
table.insert(matches, { word = c.word, menu = '[' .. source .. ']', info = c.info })
|
|
end
|
|
end
|
|
elseif source == 'cat' then
|
|
for _, c in ipairs(get_categories()) do
|
|
if base == '' or c:sub(1, #base) == base then
|
|
table.insert(matches, { word = c, menu = '[cat]' })
|
|
end
|
|
end
|
|
elseif source == rk then
|
|
for _, c in ipairs(recur_completions()) do
|
|
if base == '' or c.word:sub(1, #base) == base then
|
|
table.insert(matches, { word = c.word, menu = '[' .. source .. ']', info = c.info })
|
|
end
|
|
end
|
|
elseif source == 'gh' or source == 'gl' or source == 'cb' then
|
|
local s = require('pending.buffer').store()
|
|
if s then
|
|
local seen = {}
|
|
for _, task in ipairs(s:tasks()) do
|
|
if task._extra and task._extra._forge_ref then
|
|
local ref = task._extra._forge_ref
|
|
local key = ref.owner .. '/' .. ref.repo
|
|
if not seen[key] then
|
|
seen[key] = true
|
|
local word = key .. '#'
|
|
if base == '' or word:sub(1, #base) == base then
|
|
table.insert(matches, { word = word, menu = '[' .. source .. ']' })
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|
|
|
|
return matches
|
|
end
|
|
|
|
return M
|