Module tasks 

Task management system for tracking agent workflows

This module provides a task management system that integrates with the agent loop to track complex workflows, subtasks, and progress throughout conversation sessions.

Architecture

.gestura/tasks/
├── {session_id_1}.json    # Tasks for session 1
├── {session_id_2}.json    # Tasks for session 2
└── ...

Usage

use gestura_core::tasks::{TaskManager, Task, TaskStatus};

let manager = TaskManager::new("/path/to/workspace");
let task = manager.create_task("session-123", "Implement feature", "Add new API endpoint", None)?;
manager.update_task_status("session-123", &task.id, TaskStatus::InProgress)?;

Structs

AutoTrackedExecutionPlan

Shared execution context for a tracked auto-planned request.

MaterializedTaskBreakdown

Result of materializing requirement-breakdown tasks.

RequirementBreakdownTaskSpec

LLM-produced task specification used to materialize an auto-plan breakdown.

Task

A task represents a unit of work to be tracked

TaskBackgroundJob

Background job metadata attached to a task.

TaskExecutionEvidence

A single execution evidence record stored in task metadata.

TaskExecutionState

Runtime-owned execution state persisted in task metadata.

TaskList

A list of tasks for a session

TaskManager

Task manager for persisting and managing tasks

TaskMemoryEvent

Structured event recorded in task metadata for memory lifecycle tracking.

TaskMemoryLifecycle

Structured task-local memory lifecycle information persisted in metadata.

TaskTreeNode

A hierarchical node for rendering task trees in dashboards.

TaskVerificationProfile

Runtime-authored verification requirements for a tracked task.

Enums

TaskBackgroundStatus

Background execution status for tasks that represent long-running work.

TaskError

Error type for task operations

TaskExecutionEvidenceKind

Structured runtime evidence recorded for a task.

TaskExecutionKind

Runtime-owned execution kind inferred or assigned for a tracked task.

TaskMemoryPhase

Phase in the task/memory lifecycle.

TaskSource

Source of a task (who created it)

TaskStatus

Status of a task

TrackedTaskFinalization

Result of reconciling a tracked task after an agent turn.

Functions

get_global_task_manager

Returns the process-wide shared TaskManager.

parse_requirement_breakdown_response

Parse, normalize, and validate a planner response into typed task specs.