task

type AgendaDay struct {
	Date  time.Time
	Items []AgendaItem
}

type AgendaItem struct {
	Task        *Task
	Date        time.Time
	HasTime     bool
	HasEnd      bool
	EndTime     time.Time
	IsOverdue   bool
	IsDeadline  bool
	Warning     bool
	ClockActive bool
	Schedule    *Schedule
	IsCompleted bool
	CompletedAt time.Time
	TargetState string
}

type ClockEntry struct {
	Start time.Time
	End   time.Time
	Open  bool
}

type ClockInArgs struct {
	Project string `json:"project" jsonschema:"project name"`
	Keyword string `json:"keyword" jsonschema:"task keyword"`
	Title   string `json:"title" jsonschema:"task title"`
}

type ClockOutArgs struct {
	Project string `json:"project" jsonschema:"project name"`
	Keyword string `json:"keyword" jsonschema:"task keyword"`
	Title   string `json:"title" jsonschema:"task title"`
}

type ClockProjectResult struct {
	Project string            `json:"project" jsonschema:"project name"`
	Total   string            `json:"total" jsonschema:"project total time as H:MM"`
	Tasks   []ClockTaskResult `json:"tasks" jsonschema:"per-task breakdown"`
}

type ClockResult struct {
	Message string `json:"message" jsonschema:"result message"`
	Success bool   `json:"success" jsonschema:"whether the operation succeeded"`
}

type ClockTable struct {
	GrandTotal time.Duration
	Projects   []ClockTableProject
}

type ClockTableEntry struct {
	Task         *Task
	Duration     time.Duration
	WasCompleted bool
}

type ClockTableProject struct {
	Project string
	Total   time.Duration
	Entries []ClockTableEntry
}

type ClockTableResult struct {
	GrandTotal string               `json:"grand_total" jsonschema:"total time as H:MM"`
	Projects   []ClockProjectResult `json:"projects" jsonschema:"per-project breakdown"`
}

type ClockTaskResult struct {
	Keyword  string `json:"keyword" jsonschema:"task keyword"`
	Title    string `json:"title" jsonschema:"task title"`
	Duration string `json:"duration" jsonschema:"time spent as H:MM"`
}

type CompletionEntry struct {
	Timestamp time.Time
}

type CountTasksArgs struct {
	Project       string `json:"project,omitempty" jsonschema:"optional project name to filter count"`
	ShowCompleted bool   `json:"show_completed,omitempty" jsonschema:"whether to include completed tasks (default: false)"`
}

type CountTasksResult struct {
	Count    int            `json:"count" jsonschema:"total number of tasks"`
	ByStatus map[string]int `json:"by_status" jsonschema:"count of tasks by status category"`
}

type DatePicker struct {
	Task             *Task
	Field            DatePickerField
	Cursor           time.Time
	Confirmed        bool
	Cancelled        bool
	ClearedScheduled bool
	ClearedDue       bool
	ErrorMsg         string

	// Section navigation
	Section pickerSection

	// Time
	HasTime    bool
	Hour       int
	Minute     int
	HasEndTime bool
	EndHour    int
	EndMinute  int
	TimeFocus  timeFocus

	// Recurrence
	HasRecurrence      bool
	RecurrenceMode     RecurrenceMode
	RecurrenceInterval int
	RecurrenceUnit     byte
	RecFocus           recurrenceFocus

	// Warning
	HasWarning  bool
	WarningDays int
}

type DatePickerField int

type FilterTasksArgs struct {
	Filter        string `json:"filter" jsonschema:"filter expression (e.g., '>> alice' for assignee, '#urgent' for tag, '@2025-01-15' for date)"`
	Project       string `json:"project,omitempty" jsonschema:"optional project name to limit filter"`
	ShowCompleted bool   `json:"show_completed,omitempty" jsonschema:"whether to include completed tasks (default: false)"`
}

type FilterTasksResult struct {
	Tasks []TaskInfo `json:"tasks" jsonschema:"list of filtered tasks"`
	Count int        `json:"count" jsonschema:"total number of tasks matching filter"`
}

type GetClockTableArgs struct {
	Start string `json:"start" jsonschema:"start date (YYYY-MM-DD)"`
	End   string `json:"end" jsonschema:"end date (YYYY-MM-DD)"`
}

type GetCycleTasksArgs struct {
	Project string `json:"project,omitempty" jsonschema:"optional project name to limit search"`
}

type GetCycleTasksResult struct {
	Tasks []TaskInfo `json:"tasks" jsonschema:"tasks involved in circular dependencies"`
	Count int        `json:"count" jsonschema:"number of tasks in cycles"`
}

type GetDependenciesArgs struct {
	ID      string `json:"id" jsonschema:"task ID to get dependencies for"`
	Project string `json:"project,omitempty" jsonschema:"optional project name to limit search"`
}

type GetDependenciesResult struct {
	Task         *TaskInfo  `json:"task,omitempty" jsonschema:"the task being queried"`
	Dependencies []TaskInfo `json:"dependencies" jsonschema:"tasks that this task depends on (referenced via ^id)"`
	Count        int        `json:"count" jsonschema:"number of dependencies"`
}

type GetDependentsArgs struct {
	ID      string `json:"id" jsonschema:"task ID to get dependents for"`
	Project string `json:"project,omitempty" jsonschema:"optional project name to limit search"`
}

type GetDependentsResult struct {
	Task       *TaskInfo  `json:"task,omitempty" jsonschema:"the task being queried"`
	Dependents []TaskInfo `json:"dependents" jsonschema:"tasks that depend on this task (have ^id reference to it)"`
	Count      int        `json:"count" jsonschema:"number of dependents"`
}

type GetKeywordsArgs struct{}

type GetKeywordsResult struct {
	Keywords   map[string][]string `json:"keywords" jsonschema:"keywords grouped by category (Active, InProgress, Completed, Someday)"`
	Categories []string            `json:"categories" jsonschema:"list of category names"`
}

type GetProjectsArgs struct{}

type GetProjectsResult struct {
	Projects []ProjectInfo `json:"projects" jsonschema:"list of projects with task counts"`
	Count    int           `json:"count" jsonschema:"total number of projects"`
}

type GetTaskArgs struct {
	Project string `json:"project" jsonschema:"project name"`
	Keyword string `json:"keyword" jsonschema:"task keyword"`
	Title   string `json:"title" jsonschema:"task title (partial match supported)"`
}

type GetTaskByIDArgs struct {
	ID      string `json:"id" jsonschema:"task ID to look up"`
	Project string `json:"project,omitempty" jsonschema:"optional project name to limit search"`
}

type GetTaskByIDResult struct {
	Task  *TaskInfo `json:"task,omitempty" jsonschema:"the matching task"`
	Found bool      `json:"found" jsonschema:"whether a task with this ID was found"`
}

type GetTaskResult struct {
	Task  *TaskInfo `json:"task,omitempty" jsonschema:"the matching task"`
	Found bool      `json:"found" jsonschema:"whether a matching task was found"`
}

type KeywordEntry struct {
	Keyword  string
	Category string
}

type ListTasksArgs struct {
	Project       string `json:"project,omitempty" jsonschema:"project name to filter tasks (optional, empty for all projects)"`
	ShowCompleted bool   `json:"show_completed,omitempty" jsonschema:"whether to include completed tasks (default: false)"`
}

type ListTasksResult struct {
	Tasks []TaskInfo `json:"tasks" jsonschema:"list of tasks"`
	Count int        `json:"count" jsonschema:"total number of tasks returned"`
}

type MCPServer struct {
	// contains filtered or unexported fields
}

type ProjectInfo struct {
	Name      string `json:"name" jsonschema:"project name"`
	TaskCount int    `json:"task_count" jsonschema:"number of active tasks in the project"`
}

type RecurrenceMode int

type RecurrenceSpec struct {
	Mode     RecurrenceMode
	Interval int
	Unit     byte // 'd', 'w', 'm', 'y'
}

type Schedule struct {
	Date       time.Time
	HasTime    bool
	EndTime    time.Time
	HasEnd     bool
	Recurrence *RecurrenceSpec
	Warning    *WarningSpec
	Raw        string
}

type ScheduleTaskArgs struct {
	Project         string `json:"project" jsonschema:"project name"`
	Keyword         string `json:"keyword" jsonschema:"current task keyword"`
	Title           string `json:"title" jsonschema:"task title to identify the task"`
	ScheduledAt     string `` /* 141-byte string literal not displayed */
	DueAt           string `json:"due_at,omitempty" jsonschema:"due date to set (same format). Omit to leave unchanged."`
	RemoveScheduled bool   `json:"remove_scheduled,omitempty" jsonschema:"if true, removes the existing scheduled date"`
	RemoveDue       bool   `json:"remove_due,omitempty" jsonschema:"if true, removes the existing due date"`
}

type ScheduleTaskResult struct {
	Message string `json:"message" jsonschema:"result message"`
	Success bool   `json:"success" jsonschema:"whether the operation succeeded"`
}

type SearchResult struct {
	ZettelID string
	Title    string
	LineNum  int
	Line     string
	Path     string
	Project  string
}

type SearchResultInfo struct {
	Project  string `json:"project" jsonschema:"project name"`
	ZettelID string `json:"zettel_id,omitempty" jsonschema:"zettel ID (if structured mode)"`
	Title    string `json:"title" jsonschema:"file/zettel title"`
	LineNum  int    `json:"line_num" jsonschema:"line number of the match"`
	Line     string `json:"line" jsonschema:"the matching line"`
	Path     string `json:"path" jsonschema:"file path"`
}

type SearchTasksArgs struct {
	Pattern string `json:"pattern" jsonschema:"search pattern (case-insensitive substring match across all task fields)"`
	Project string `json:"project,omitempty" jsonschema:"optional project name to limit search"`
}

type SearchTasksResult struct {
	Results []SearchResultInfo `json:"results" jsonschema:"list of search results"`
	Count   int                `json:"count" jsonschema:"total number of matches"`
}

type StateTransition struct {
	From      string
	To        string
	Timestamp time.Time
}

type StatusPicker struct {
	Task      *Task
	Config    *config.Config
	Columns   []statusColumn
	ColCursor int
	Confirmed bool
	Cancelled bool
	Selected  string
}

type SyncJiraArgs struct{}

type SyncJiraResult struct {
	Message string `json:"message"`
}

type Task struct {
	Keyword     string
	ID          string // Optional unique identifier [id]
	Title       string
	Tags        []string
	References  []string // IDs of tasks this task depends on (^id syntax)
	ScheduledAt string   // @date or @s:date (scheduled date)
	DueAt       string   // @d:date (due date)
	Assignee    string
	Project     string
	Zettel      string
	FilePath    string  // Original file path where this task was found
	InCycle     bool    // True if this task participates in a circular dependency
	IndentLevel int     // Byte offset of first non-whitespace character in source line
	LineNum     int     // 1-based line number in source file
	Parent      *Task   // Parent task, nil for root tasks
	Children    []*Task // Child tasks nested under this task in the source file
}

type TaskInfo struct {
	Keyword     string   `json:"keyword" jsonschema:"task status keyword (e.g., TODO, DOING, DONE)"`
	ID          string   `json:"id,omitempty" jsonschema:"task unique identifier"`
	Title       string   `json:"title" jsonschema:"task title/description"`
	Tags        []string `json:"tags,omitempty" jsonschema:"task tags (without #)"`
	References  []string `json:"references,omitempty" jsonschema:"IDs of tasks this task depends on (^id syntax)"`
	ScheduledAt string   `json:"scheduled_at,omitempty" jsonschema:"scheduled date"`
	DueAt       string   `json:"due_at,omitempty" jsonschema:"due date"`
	Assignee    string   `json:"assignee,omitempty" jsonschema:"task assignee"`
	Project     string   `json:"project" jsonschema:"project name"`
	Zettel      string   `json:"zettel,omitempty" jsonschema:"zettel ID (if structured mode)"`
	FilePath    string   `json:"file_path" jsonschema:"file path where task is defined"`
	Priority    int      `json:"priority" jsonschema:"priority level (1=in_progress, 2=active, 3=someday, 4=completed)"`
	Status      string   `json:"status" jsonschema:"status category (active, in_progress, completed, someday)"`
	InCycle     bool     `json:"in_cycle,omitempty" jsonschema:"true if task participates in a circular dependency"`
	ParentID    string   `json:"parent_id,omitempty" jsonschema:"ID of parent task (if this is a sub-task)"`
	ChildCount  int      `json:"child_count,omitempty" jsonschema:"number of direct child tasks"`
	RawContent  string   `json:"raw_content,omitempty" jsonschema:"raw file content of task and all indented lines below it"`
}

type UpdateTaskStatusArgs struct {
	Project    string `json:"project" jsonschema:"project name"`
	Keyword    string `json:"keyword" jsonschema:"current task keyword"`
	Title      string `json:"title" jsonschema:"task title to identify the task"`
	NewKeyword string `json:"new_keyword" jsonschema:"new status keyword to set"`
}

type UpdateTaskStatusResult struct {
	Message       string              `json:"message" jsonschema:"status message"`
	Success       bool                `json:"success" jsonschema:"whether the update succeeded"`
	ValidKeywords map[string][]string `json:"valid_keywords" jsonschema:"valid keywords grouped by category (Active, InProgress, Completed, Someday)"`
}

type WarningSpec struct {
	Days int
}