Orgonomic

local clock = require('yalms.orgonomics.clock').get()
clock:clock_in()
-- You are now clocked into "No active task" (or whatever you set as checkin_task)

clock:clock_in({ pick = true })
-- A picker opens showing all tasks. Select one and press Enter.

clock:clock_in({ memo = true })
-- A capture window opens. Write your task description and save.

clock:clock_in({
  memo = true,
  template = "my_template",  -- use a custom org-capture template
  file = "~/org/work.org",   -- save to a specific file
})

clock:clock_in({ is_break = true, memo = true })
-- Captures a break note and starts the break clock.
-- When you clock back in, it returns you to your previous task.

clock = {
  break_types = { "Time-Off", "Meeting", "Sick", "Errand" },
}

local task = clock:get_checked_in_task()
if task then
  print("Currently working on: " .. task.title)
end

clock:get_checkin_task():next(function(headline)
  print("Check-in task: " .. headline.title)
end)

clock:edit_checked_in_task()
-- Opens a floating window with the task content.
-- Edit and close the window to save changes back to the source file.

clock:clock_out()
-- The org clock is stopped. Duration is recorded in the headline.

clock:summarize("today")
-- or: "week", "month", "yesterday"

clock:summarize("week", { position = "float", width = 80 })

require('yalms.orgonomics').setup({
  pickers = {
    headlines = {
      hooks = {
        after = {
          refile = function(item, picker, action)
            -- e.g., log the refile or trigger a notification
          end,
        },
      },
    },
  },
})

pickers = {
  files = {
    -- Enable file picker. Accepts boolean or snacks.picker.files.Config.
    true,
    -- or
    {
      title_format = "both",  -- "title" | "filename" | "both"
    },
  },
  headlines = {
    -- Enable headline picker. Accepts boolean or table.
    true,
    -- or
    {
      level = 1,            -- only show headlines at this depth
      dirs = { "~/org" },   -- restrict to specific directories
      keywords = { "TODO", "PROG" },  -- filter by todo keyword
      orgtags = { "work" }, -- filter by tag
      hooks = {
        after = {
          refile = function(item, picker, action) end,
        },
      },
    },
  },
}

clock = {
  breaks_file  = "~/.nixvim/breaks.org",  -- file that stores break headlines
  checkin_task = "No active task",         -- title of the default check-in headline
  break_types  = { "Time-Off" },           -- list of break headline types to auto-create
  tag          = "vnix",                   -- tag applied to managed headlines
  breaks_tag   = "breaks",                 -- tag applied to break headlines
}

local helpers = require('yalms.orgonomics.helpers')
local headline, file = helpers.resolve_headline_api(node)

-- Clock operations
headline:clock_in():next(function()
  print("Clock started")
end)

headline:clock_out():next(function()
  print("Clock stopped")
end)

headline:toggle_clock()

headline:is_clocked_in():next(function(is_in)
  print("Clocked in:", is_in)
end)

headline:cancel_active_clock()

-- Content access
headline:get_closest_headline():next(function(hl)
  -- Returns the underlying OrgHeadline object
end)

headline:get_lines():next(function(lines)
  -- Returns the headline content as an array of lines
end)

headline:get_content():next(function(content)
  -- Returns the headline content as a single string
end)

local file = helpers.resolve_file_api("path/to/file.org")
local headline = file:insert_headline({
  text = "New Task",
  level = 1,
})
-- Or insert after a specific existing headline:
file:insert_headline({ text = "Sub-task", level = 2 }, existing_headline)

-- Get the currently active clock (if any)
helpers.get_active_clock():next(function(clock)
  if clock then
    print("Clocked into: " .. clock.headline:get_title())
  end
end)

-- Clock out of all running clocks, optionally keeping one
helpers.clock_out_all(keep_headline)