# pacutacatete100/mytodocli architecture

> Architecture diagram of the GitHub repository pacutacatete100/mytodocli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pacutacatete100/mytodocli
- Repository: https://github.com/pacutacatete100/mytodocli

## Overview

myTodoCLI is a terminal to-do manager. Users invoke commands to list, create, edit, complete, or remove main tasks and subtasks; the CLI delegates task operations to a controller, which updates the in-memory list and task objects persist changes to JSON. Date parsing and optional natural-language extraction support task creation and editing. The CLI also provides due-date, class, schedule, and progress views. The README only documents the initial JSON shape; the sampled CLI excerpt is partial, so some command wiring and persistence details are not shown.

Main entry points: [`todo/todo.py`](https://github.com/pacutacatete100/mytodocli/blob/master/todo/todo.py) (Commands and views), [`todo/MainTask.py`](https://github.com/pacutacatete100/mytodocli/blob/master/todo/MainTask.py) (Main tasks), [`todo/TaskController.py`](https://github.com/pacutacatete100/mytodocli/blob/master/todo/TaskController.py) (Task controller), [`todo/SubTask.py`](https://github.com/pacutacatete100/mytodocli/blob/master/todo/SubTask.py) (Subtasks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and views"]
  node_commands["Commands and views<br/>[todo.py]"]
end

subgraph group_tasks["Task management"]
  node_controller["Task controller<br/>[TaskController.py]"]
  node_main_task["Main tasks<br/>[MainTask.py]"]
  node_subtask["Subtasks<br/>[SubTask.py]"]
  node_task_base["Task base<br/>[Task.py]"]
end

subgraph group_assist["Date and inference"]
  node_date["Date processing<br/>[DateProcessor.py]"]
  node_inference["Text inference<br/>[Inference.py]"]
end

node_user(("CLI user"))
node_json_store[("JSON task file")]

node_user -->|"invokes"| node_commands
node_commands -->|"calls"| node_controller
node_commands -->|"creates"| node_main_task
node_commands -->|"creates"| node_subtask
node_commands -->|"processes dates"| node_date
node_commands -->|"extracts task data"| node_inference
node_controller -->|"loads and updates"| node_main_task
node_controller -->|"updates"| node_subtask
node_controller -->|"processes edits"| node_date
node_main_task -->|"converts and renders"| node_subtask
node_main_task -->|"inherits"| node_task_base
node_subtask -->|"inherits"| node_task_base
node_main_task -->|"formats due dates"| node_date
node_controller -->|"loads and saves"| node_json_store
node_main_task -->|"reads and writes"| node_json_store
node_subtask -->|"reads and writes"| node_json_store

click node_commands "https://github.com/pacutacatete100/mytodocli/blob/master/todo/todo.py"
click node_controller "https://github.com/pacutacatete100/mytodocli/blob/master/todo/TaskController.py"
click node_main_task "https://github.com/pacutacatete100/mytodocli/blob/master/todo/MainTask.py"
click node_subtask "https://github.com/pacutacatete100/mytodocli/blob/master/todo/SubTask.py"
click node_task_base "https://github.com/pacutacatete100/mytodocli/blob/master/todo/Task.py"
click node_date "https://github.com/pacutacatete100/mytodocli/blob/master/todo/DateProcessor.py"
click node_inference "https://github.com/pacutacatete100/mytodocli/blob/master/todo/Inference.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_commands,node_user toneBlue
class node_controller,node_main_task,node_subtask,node_task_base,node_json_store toneAmber
class node_date,node_inference toneMint
```

## Components

### CLI and views

- [Commands and views](https://github.com/pacutacatete100/mytodocli/blob/master/todo/todo.py): `todo/todo.py`

### Task management

- [Task controller](https://github.com/pacutacatete100/mytodocli/blob/master/todo/TaskController.py): `todo/TaskController.py`
- [Main tasks](https://github.com/pacutacatete100/mytodocli/blob/master/todo/MainTask.py): `todo/MainTask.py`
- [Subtasks](https://github.com/pacutacatete100/mytodocli/blob/master/todo/SubTask.py): `todo/SubTask.py`
- [Task base](https://github.com/pacutacatete100/mytodocli/blob/master/todo/Task.py): `todo/Task.py`

### Date and inference

- [Date processing](https://github.com/pacutacatete100/mytodocli/blob/master/todo/DateProcessor.py): `todo/DateProcessor.py`
- [Text inference](https://github.com/pacutacatete100/mytodocli/blob/master/todo/Inference.py): `todo/Inference.py`

### Other components

- **CLI user**
- **JSON task file**

## Connections

- CLI user → Commands and views: invokes
- Commands and views → Task controller: calls (evidence: `todo/todo.py`)
- Commands and views → Main tasks: creates (evidence: `todo/todo.py`)
- Commands and views → Subtasks: creates (evidence: `todo/todo.py`)
- Commands and views → Date processing: processes dates (evidence: `todo/todo.py`)
- Commands and views → Text inference: extracts task data (evidence: `todo/todo.py`)
- Task controller → Main tasks: loads and updates (evidence: `todo/TaskController.py`)
- Task controller → Subtasks: updates (evidence: `todo/TaskController.py`)
- Task controller → Date processing: processes edits (evidence: `todo/TaskController.py`)
- Main tasks → Subtasks: converts and renders (evidence: `todo/MainTask.py`)
- Main tasks → Task base: inherits (evidence: `todo/MainTask.py`)
- Subtasks → Task base: inherits (evidence: `todo/SubTask.py`)
- Main tasks → Date processing: formats due dates (evidence: `todo/MainTask.py`)
- Task controller → JSON task file: loads and saves (evidence: `todo/TaskController.py`)
- Main tasks → JSON task file: reads and writes (evidence: `todo/MainTask.py`)
- Subtasks → JSON task file: reads and writes (evidence: `todo/SubTask.py`)
