How alajmo/mani works
Main Components Identification
The system can be broken down into these major components:
a. Command Layer (cmd/)
• Entry points for different CLI commands
• Handles user interaction and command parsing
b. Core Layer (core/)
• Business logic implementation
• Multiple sub-components:
• DAO (Data Access Objects)
• Execution Engine
• Print/Output System
• TUI (Terminal User Interface)
Key Architectural Patterns
The system follows these patterns:
• Command Pattern (for CLI commands)
• MVC-like structure (separation of data, logic, and presentation)
• Plugin-style architecture for different output formats
┌─────────────────────────────────────────────────────────┐
• User Interface │
• ┬───────────────────────┬─────────────────┤
• CLI Mode │ TUI Mode │ Output Formats │
• (cmd/) │ (core/tui) │ (core/print) │
• ┬───────┴──────────┬────────────┴────────┬────────┘
┌───────▼──────────────────▼─────────────────────▼────────┐
• Core Layer │
• ┬────────────────┬────────────────────────┤
• DAO │ Exec Engine │ Theme Engine │
• (core/dao) │ (core/exec) │ (core/dao/theme) │
• ┴───────┬────────┴────────────────────────┘
┌───────────────────────▼─────────────────────────────────┐
• External Systems │
• ┬────────────────┬────────────────────────┤
• Git Repos │ Shell │ File System │
• ┴────────────────┴────────────────────────┘
Component Relationships
• Double lines: Data flow
Additional Elements
• Config file handling (mani.yaml)
• Project management flows
• Task execution pipelines
• Theme customization system
Key Technical Details to Highlight
• Parallel execution capability
• Cross-platform support
• Plugin-based output system
• TUI component architecture
Implementation Notes
• How the system handles different operating systems
• Where configuration is stored and processed
• Points of extension/customization
Scale and Detail Level
• Keep high-level architecture visible at a glance
• Provide zoom-in sections for complex subsystems
• Callouts for important features
Remember to emphasize:
• The modular nature of the system
• Clear separation of concerns
• The flexibility of the execution engine
• Multiple user interface options (CLI/TUI)