Struct TaskService 

pub struct TaskService<'a> { /* private fields */ }

Service for managing development tasks.

TaskService provides operations for creating, retrieving, updating, and archiving tasks. It handles task lifecycle management, ticket linking, and task switching.

Implementations

impl<'a> TaskService<'a>

pub fn new(db: &'a Database) -> Self

Creates a new TaskService instance.

Arguments

• db - Reference to the database connection

pub fn create_task( &self, name: &str, description: Option<&str>, ticket_id: Option<&str>, ticket_url: Option<&str>, ) -> Result<Task>

Creates a new task and sets it as the current task.

Arguments

• name - Name of the task (cannot be empty)
• description - Optional task description
• ticket_id - Optional ticket ID (e.g., “PROJ-123” or “owner/repo/456”)
• ticket_url - Optional URL to the ticket

Errors

Returns an error if:

• The task name is empty
• The ticket ID format is invalid
• A task with the same ticket ID already exists

pub fn get_task(&self, task_id: i64) -> Result<Task>

Retrieves a task by its ID.

Arguments

• task_id - The ID of the task to retrieve

Errors

Returns TrackError::TaskNotFound if the task does not exist.

pub fn list_tasks(&self, include_archived: bool) -> Result<Vec<Task>>

Lists all tasks, optionally including archived tasks.

Arguments

• include_archived - If true, includes archived tasks in the results

Returns

A vector of tasks ordered by creation date (newest first).

pub fn switch_task(&self, task_id: i64) -> Result<Task>

Switches to a different task, making it the current active task.

Arguments

• task_id - The ID of the task to switch to

Errors

Returns an error if:

• The task does not exist
• The task is archived

pub fn archive_task(&self, task_id: i64) -> Result<()>

Archives a task, marking it as completed or abandoned.

If the archived task is the current task, the current task is cleared.

Arguments

• task_id - The ID of the task to archive

pub fn link_ticket( &self, task_id: i64, ticket_id: &str, url: &str, ) -> Result<()>

Links a ticket to an existing task.

Arguments

• task_id - The ID of the task to link the ticket to
• ticket_id - The ticket ID (e.g., “PROJ-123” or “owner/repo/456”)
• url - The URL to the ticket

Errors

Returns an error if:

• The ticket ID format is invalid
• Another task is already linked to this ticket

pub fn set_description(&self, task_id: i64, description: &str) -> Result<()>

Sets or updates the description of a task.

Arguments

• task_id - The ID of the task to update
• description - The new description text

Errors

Returns an error if:

• The task does not exist
• The task is archived

pub fn resolve_task_id(&self, reference: &str) -> Result<i64>

Resolves a task reference to a task ID.

Accepts a numeric task ID, a ticket reference prefixed with “t:”, or an alias.

Arguments

• reference - Either a task ID (e.g., “1”), ticket reference (e.g., “t:PROJ-123”), or alias (e.g., “daily-work”)

Returns

The resolved task ID.

Errors

Returns an error if the reference is invalid or no matching task is found.

pub fn set_alias(&self, task_id: i64, alias: &str, force: bool) -> Result<()>

Sets an alias for a task.

Arguments

• task_id - The ID of the task to set the alias for
• alias - The alias to set (must be unique and valid)
• force - If true, removes the alias from any existing task before setting it

Errors

Returns an error if:

• The alias format is invalid
• The alias is already in use by another task (when force is false)
• The task does not exist

pub fn remove_alias(&self, task_id: i64) -> Result<()>

Removes the alias from a task.

Arguments

• task_id - The ID of the task to remove the alias from