# travisbhartwell/mycmd architecture

> Architecture diagram of the GitHub repository travisbhartwell/mycmd, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/travisbhartwell/mycmd
- Repository: https://github.com/travisbhartwell/mycmd

## Overview

##### Main Components

a) Core Components:
- Command Execution Engine
- Command Group Management
- Path Resolution System
- Event System
- Logging System
- Project Management

b) Supporting Components:
- Vendor Libraries
- Development Tools
- Testing Framework

##### Key Relationships to Highlight

- Command Execution Flow:
How a command flows from the CLI through the system:
1. Command input
2. Path resolution
3. Command group loading
4. Library loading
5. Command execution
6. Output handling

- Event System Integration:
Demonstrate how the event system (bashup.events) integrates with the command execution lifecycle

- Testing Framework:
How the testing components (in /testing) interact with the core system

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph UI
        CLI["Command Line Interface"]:::ui
        EP["Entry Point"]:::ui
    end

    subgraph Core
        CE["Command Execution Engine"]:::core
        CGM["Command Group Management"]:::core
        PRS["Path Resolution System"]:::core
        ES["Event System"]:::core
        LS["Logging System"]:::core
        PM["Project Management"]:::core
    end

    subgraph Runtime
        RS["Runtime Services"]:::runtime
        OH["Output Handling"]:::runtime
        PS["Platform Support"]:::runtime
    end

    subgraph Infrastructure
        VI["Vendor Integration"]:::infra
        DT["Development Tools"]:::infra
        TF["Testing Framework"]:::infra
    end

    %% Relationships
    CLI --> EP
    EP --> CE
    CE --> CGM
    CE --> PRS
    CE --> ES
    CGM --> RS
    RS --> OH
    RS --> PS
    CE --> LS
    CE --> PM
    PM --> VI
    VI --> DT
    DT --> TF

    %% Click Events
    click CE "https://github.com/travisbhartwell/mycmd/tree/main//mycmd/mycmd-lib,/mycmd/mycmd-command-lib"
    click CGM "https://github.com/travisbhartwell/mycmd/tree/main//mycmd/mycmd-command-group-lib,/mycmd/mycmd-registry-lib"
    click PRS "https://github.com/travisbhartwell/mycmd/tree/main//mycmd/mycmd-pathname-lib"
    click ES "https://github.com/travisbhartwell/mycmd/tree/main//mycmd/mycmd-event-base-lib,/mycmd/mycmd-event-lifecycle-lib"
    click LS "https://github.com/travisbhartwell/mycmd/tree/main//mycmd/logging/logging-lib"
    click PM "https://github.com/travisbhartwell/mycmd/tree/main//mycmd/project/project-lib,/mycmd/project/project-git-lib,/mycmd/project/project-shell-lib"
    click RS "https://github.com/travisbhartwell/mycmd/tree/main//mycmd/mycmd-environment-lib,/mycmd/mycmd-loading-lib,/mycmd/mycmd-loading-base-lib"
    click OH "https://github.com/travisbhartwell/mycmd/tree/main//mycmd/mycmd-formatted-output-lib,/mycmd/mycmd-output-lib"
    click PS "https://github.com/travisbhartwell/mycmd/tree/main//mycmd/mycmd-platform-support-lib"
    click VI "https://github.com/travisbhartwell/mycmd/tree/main//mycmd/mycmd-vendoring-lib,/vendor"
    click DT "https://github.com/travisbhartwell/mycmd/tree/main//support"
    click TF "https://github.com/travisbhartwell/mycmd/tree/main//testing"
    click EP "https://github.com/travisbhartwell/mycmd/tree/main//bin/mycmd"

    %% Styles
    classDef ui fill:#f9f,stroke:#333,stroke-width:2px
    classDef core fill:#9cf,stroke:#333,stroke-width:2px
    classDef runtime fill:#9f9,stroke:#333,stroke-width:2px
    classDef infra fill:#ff9,stroke:#333,stroke-width:2px

    %% Legend
    subgraph Legend
        L1["UI Components"]:::ui
        L2["Core Components"]:::core
        L3["Runtime Components"]:::runtime
        L4["Infrastructure"]:::infra
    end
```
