heph.nvim: task views — next/list/capture/attention/state/log (slice 11b)
Some checks failed
Build / validate (pull_request) Failing after 2s

Backend: enrich `list` to return titled RankedTask rows (title +
canonical_context_id, via a shared ranked_from_row with `next`), so the
Organizational view needs no N+1 node.get. TDD: query_surface test asserts
list rows carry title + context id.

Plugin:
- view.lua: Tactical `next` + Organizational `list` rendered scratch buffers;
  <CR> opens the row's canonical-context doc. Narrowed the node autocmd to
  heph://node/* so view buffers (heph://next, heph://list) don't trip it.
- task.lua: capture, set-attention, done/drop, skip, per-task log append, all
  resolving "the current task" from the buffer (a task node, or a context doc
  via its canonical-context backlink).
- picker.lua: vim.ui.select with Telescope auto-upgrade (headless-safe).
- command.lua: :Heph next/list/capture/attention/done/drop/skip/log/search.

e2e: capture→next→open context→add/check checklist→done; recurring
fresh-checklist (complete rolls forward in place, next occurrence all-unchecked
— the §4.4 hard requirement). 6 specs green via `mise run test-nvim`.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Erich Blume 2026-06-01 21:12:56 -07:00
commit 7c9a734ebd
17 changed files with 507 additions and 55 deletions

View file

@ -4,8 +4,11 @@
local M = {}
local ATTENTIONS = { "white", "orange", "red", "blue" }
--- subcommand -> handler(args: string[])
M.subs = {
-- knowledge base
today = function()
require("heph.journal").open()
end,
@ -20,6 +23,66 @@ M.subs = {
require("heph.node").open(args[1])
end
end,
search = function(args)
local query = table.concat(args, " ")
if #query == 0 then
require("heph.util").notify("usage: :Heph search <query>", vim.log.levels.WARN)
return
end
local nodes = require("heph.rpc").call("search", { query = query })
require("heph.picker").select(nodes, {
prompt = "heph search: " .. query,
format = function(n)
return string.format("[%s] %s", n.kind, n.title)
end,
}, function(choice)
if choice then
require("heph.node").open(choice.id)
end
end)
end,
-- tasks
next = function(args)
require("heph.view").next({ scope = args[1] })
end,
list = function(args)
require("heph.view").list({ attention = args[1] })
end,
capture = function(args)
local title = table.concat(args, " ")
if #title == 0 then
require("heph.util").notify("usage: :Heph capture <title>", vim.log.levels.WARN)
return
end
require("heph.picker").select(ATTENTIONS, { prompt = "attention for: " .. title }, function(attention)
require("heph.task").capture(title, { attention = attention })
require("heph.util").notify("captured: " .. title)
end)
end,
attention = function(args)
if args[1] then
require("heph.task").set_attention_current(args[1])
else
require("heph.picker").select(ATTENTIONS, { prompt = "attention" }, function(choice)
if choice then
require("heph.task").set_attention_current(choice)
end
end)
end
end,
done = function()
require("heph.task").set_state_current("done")
end,
drop = function()
require("heph.task").set_state_current("dropped")
end,
skip = function()
require("heph.task").skip_current()
end,
log = function(args)
require("heph.task").log_append_current(table.concat(args, " "))
end,
}
--- `:Heph` entry point.