task

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 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 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 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 Task struct {
	Keyword     string
	ID          string // Optional unique identifier [id]
	Title       string
	Tag         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
}

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"`
	Tag         string   `json:"tag,omitempty" jsonschema:"task tag (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"`
}

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)"`
}