Struct TodoManager 

pub struct TodoManager { /* private fields */ }

Manager for tracking todos during plan execution.

Holds an ordered map of todo items and provides CRUD operations. The manager is session-scoped (not persisted to disk by default).

Implementations

impl TodoManager

pub fn new() -> Self

Create a new, empty todo manager.

pub fn from_steps(steps: &[String]) -> Self

Create a todo manager pre-populated from plan step strings.

pub fn add(&mut self, title: String) -> usize

Add a new todo item. Returns its assigned ID.

pub fn add_with_status( &mut self, title: String, status: TodoStatus, active_form: String, children: Vec<SubTodoItem>, ) -> usize

Add a new todo item with initial status, active_form, and children. Returns its assigned ID.

pub fn write_todos( &mut self, items: Vec<(String, TodoStatus, String, Vec<SubTodoItem>)>, )

Replace the entire todo list with new items. Resets IDs starting from 1.

pub fn set_status(&mut self, id: usize, status: TodoStatus) -> bool

Update the status of a todo item by ID.

Enforces single “doing” constraint: when setting InProgress, auto-reverts other “doing” items to Pending.

Returns true if the item was found and updated.

pub fn start(&mut self, id: usize) -> bool

Mark a todo as in-progress.

pub fn complete(&mut self, id: usize) -> bool

Mark a todo as completed.

pub fn get(&self, id: usize) -> Option<&TodoItem>

Get a todo item by ID.

pub fn all(&self) -> Vec<&TodoItem>

Get all todo items in order.

pub fn todos_mut(&mut self) -> &mut BTreeMap<usize, TodoItem>

Get mutable access to the internal map (for title updates etc.).

pub fn has_todos(&self) -> bool

Check if there are any todos.

pub fn total(&self) -> usize

Total number of todos.

pub fn completed_count(&self) -> usize

Number of completed todos.

pub fn in_progress_count(&self) -> usize

Number of in-progress todos.

pub fn pending_count(&self) -> usize

Number of pending todos.

pub fn next_pending(&self) -> Option<&TodoItem>

Get the next pending todo (lowest ID).

pub fn all_completed(&self) -> bool

Whether all todos are completed.

pub fn format_status(&self) -> String

Format a status display string suitable for inclusion in prompts.

Example output:

Todos (2/5 done):
  [done] 1. Set up project structure
  [done] 2. Add config parser
  [doing] 3. Implement core logic
  [todo] 4. Write tests
  [todo] 5. Update docs

pub fn remove(&mut self, id: usize) -> bool

Remove a todo by ID. Returns true if it existed.

pub fn clear(&mut self)

Clear all todos.

pub fn find_todo(&self, id_str: &str) -> Option<(usize, &TodoItem)>

Fuzzy-find a todo by ID string.

Supports formats: "todo-3", "3", "todo_3", exact title match, or partial title match.

pub fn get_active_todo_message(&self) -> Option<String>

Get the active_form of the currently “doing” item, if any.

pub fn reset_stuck_todos(&mut self) -> usize

Reset all “doing” (in-progress) todos back to “pending”.

Called when the agent loop exits (interrupt, error, timeout, or normal completion) to ensure no todos remain spinning in “doing” state. Returns the number of items reset.

pub fn has_incomplete_todos(&self) -> bool

Whether there are any non-completed todos.

pub fn has_work_in_progress(&self) -> bool

Whether any todo has been started (moved beyond Pending). Returns true if at least one todo is InProgress or Completed.

pub fn format_status_sorted(&self) -> String

Format the todo list sorted by status: doing -> todo -> done.

Trait Implementations

impl Clone for TodoManager

fn clone(&self) -> TodoManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TodoManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TodoManager

fn default() -> TodoManager

Returns the “default value” for a type.