History

Erich Blume 7c9a734ebd Some checks failed Build / validate (pull_request) Failing after 2s Details heph.nvim: task views — next/list/capture/attention/state/log (slice 11b) 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>		2026-06-01 21:12:56 -07:00
..
lua/heph	heph.nvim: task views — next/list/capture/attention/state/log (slice 11b)	2026-06-01 21:12:56 -07:00
plugin	heph.nvim: task views — next/list/capture/attention/state/log (slice 11b)	2026-06-01 21:12:56 -07:00
tests/e2e	heph.nvim: task views — next/list/capture/attention/state/log (slice 11b)	2026-06-01 21:12:56 -07:00
README.md	heph.nvim: run e2e via `mise run test-nvim`, drop the Makefile	2026-06-01 21:02:46 -07:00

README.md

heph.nvim

The primary surface for hephaestus — an obsidian.nvim replacement that is a thin client of the local hephd daemon over its unix-socket JSON-RPC (tech-spec §8). Notes, journals, and tasks are edited as ordinary Neovim buffers; saving routes through the daemon.

Status: built in checkpointed slices. 11a (this slice) delivers the RPC client, buffer-backed editing, [[wiki-link]] following, and the daily journal. Task/agenda views (:Heph next/list/capture), the per-task log, and promotion arrive in 11b/11c. See tech-spec §14.

How it works

Buffer-backed nodes. A node is edited in a buffer named heph://node/<id>. Opening it loads the markdown body via node.get; :w saves the whole buffer back via node.update (the backend diffs it into a text CRDT, so sending the full buffer is correct). buftype=acwrite.
Links. Press <CR> on a [[wiki-link]] to jump to its node (resolved exactly via node.resolve). Unresolved links are allowed — they just notify.
Journal. :Heph today (or :Heph journal YYYY-MM-DD) opens a dated journal note; the id is deterministic so reopening is idempotent.

Setup

Requires a running hephd (hephd --mode local) and Neovim ≥ 0.10.

require("heph").setup({
  -- socket = "/run/user/1000/heph/hephd.sock",  -- defaults to hephd's path
  -- keymaps = true,                             -- <leader>h* maps
  -- autostart = false,                          -- spawn hephd if absent
})

Commands

Command	Action
`:Heph today`	Open today's journal
`:Heph journal <YYYY-MM-DD>`	Open a dated journal
`:Heph follow`	Follow the `[[link]]` under the cursor (also `<CR>`)
`:Heph open <id>`	Open a node buffer by id

Tests

The e2e suite drives the plugin in headless Neovim against a real daemon:

mise run test-nvim   # builds hephd, runs the headless e2e suite

The suite uses a small self-contained busted-style runner (tests/e2e/runner.lua) — no external plugins and no network, so it is deterministic. Dev runs use system-installed Neovim (≥ 0.10) + rustc; CI runs the same suite inside a Dagger container that provides them (slice 11c).