Project Manager

Implements a three-tier task hierarchy (ideas → epics → tasks) that enables progressive refinement of work items from high-level concepts to actionable tasks. The system maintains parent-child relationships through a graph-like data structure, allowing users to expand or collapse task trees and track completion status at each level. This architecture supports both top-down planning (breaking ideas into epics into tasks) and bottom-up aggregation (rolling up task completion to parent epic status).

Renders a terminal-based dashboard that displays the hierarchical task tree with visual indicators for status, priority, and completion. The implementation uses ANSI color codes and box-drawing characters to create an interactive tree view that can be navigated and expanded/collapsed. The dashboard updates in real-time as tasks are created, modified, or completed, providing immediate visual feedback without requiring page refreshes or external tools.

Exposes task management operations (create idea, create epic, create task, update status, delete task) as MCP tools that can be called by LLM agents through a standardized function-calling interface. Each tool has a defined schema (JSON Schema) specifying required parameters, types, and validation rules. The MCP server handles tool invocation, validates inputs, executes the operation, and returns structured results that the agent can reason about and chain into subsequent operations.

Maintains completion state for individual tasks (not started, in progress, completed) and automatically aggregates status up the hierarchy to calculate epic and idea completion percentages. The system uses a bottom-up calculation model where parent status is derived from child task completion counts. Status changes are propagated immediately, allowing dashboards and agents to see real-time progress metrics without manual updates.

Stores task hierarchies and metadata in a persistent backend (likely JSON files or SQLite database based on typical MCP patterns) that survives process restarts. The system implements CRUD operations (create, read, update, delete) that serialize/deserialize task objects to/from storage. Concurrent access is handled through file locking or transaction isolation, ensuring data consistency when multiple clients or agents access the same project.

Stores and manages additional task attributes beyond title and status, such as priority level (low, medium, high, critical), assignee, due date, and custom tags or labels. The system allows filtering and sorting tasks by these attributes, enabling users and agents to focus on high-priority or overdue work. Metadata is included in MCP tool schemas, allowing agents to set these properties when creating or updating tasks.