Git Worktree Wrapper (GWW) - High-Level Architecture

Component relationships and data flow

graph TB subgraph "User Interface Layer" CLI[CLI Entry Point
gww main.py] Commands[Command Handlers
clone, add, remove, pull, migrate, init] end subgraph "Core Services Layer" ConfigMgr[Config Manager
loader, validator, resolver] TemplateEngine[Template Engine
evaluator, functions] GitOps[Git Operations
repository, worktree, branch] ActionSys[Action System
matcher, executor] end subgraph "Utilities Layer" Utils[Utilities
shell, URI parsing, XDG paths] end subgraph "External Dependencies" Git[Git CLI] ConfigFile[YAML Config File
~/.config/gww/config.yml] FileSystem[File System] end CLI --> Commands Commands --> ConfigMgr Commands --> GitOps Commands --> ActionSys ConfigMgr --> TemplateEngine ConfigMgr --> ConfigFile ConfigMgr --> Utils TemplateEngine --> Utils GitOps --> Git GitOps --> FileSystem GitOps --> Utils ActionSys --> TemplateEngine ActionSys --> FileSystem ActionSys --> Utils Commands --> TemplateEngine style CLI fill:#e1f5ff style Commands fill:#e1f5ff style ConfigMgr fill:#fff4e1 style TemplateEngine fill:#fff4e1 style GitOps fill:#fff4e1 style ActionSys fill:#fff4e1 style Utils fill:#e8f5e9 style Git fill:#fce4ec style ConfigFile fill:#fce4ec style FileSystem fill:#fce4ec