hephaestus/heph.nvim/lua/heph/util.lua

--- Small shared helpers: URIs, dates, notifications.

local M = {}

--- Today's date as an ISO `YYYY-MM-DD`. Uses the real wall clock — the plugin
--- picks "today"; `heph-core` stays clock-injected, this is surface-only.
function M.iso_today()
  return os.date("%Y-%m-%d")
end

--- The buffer URI for a node id.
function M.node_uri(id)
  return "heph://node/" .. id
end

--- Parse a `heph://<kind>/<id>` URI into `kind, id` (nil on no match).
function M.parse_uri(uri)
  return uri:match("^heph://([^/]+)/(.+)$")
end

--- The 1-based index of the context item on the cursor's line among the
--- buffer's context items (document order, fenced code skipped) — the `item_ref`
--- for `task.promote`. Mirrors heph-core's `extract.rs` ordering. Returns nil if
--- the cursor line is not a `- [ ]` / `- [x]` item.
function M.context_item_index_at_cursor(buf)
  local cur = vim.api.nvim_win_get_cursor(0)[1]
  local lines = vim.api.nvim_buf_get_lines(buf, 0, cur, false) -- lines 1..cursor
  local in_fence, count, last_is_item = false, 0, false
  for _, line in ipairs(lines) do
    if line:match("^%s*```") then
      in_fence = not in_fence
      last_is_item = false
    elseif not in_fence and line:match("^%s*[-*+]%s+%[[ xX]%]") then
      count = count + 1
      last_is_item = true
    else
      last_is_item = false
    end
  end
  if last_is_item then
    return count
  end
  return nil
end

--- Notify with a consistent `heph:` prefix.
function M.notify(msg, level)
  vim.notify("heph: " .. msg, level or vim.log.levels.INFO)
end

return M