# linruiliu/toolx-cpp architecture

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

- Interactive diagram: https://gitdiagram.com/linruiliu/toolx-cpp
- Repository: https://github.com/linruiliu/toolx-cpp

## Overview

ToolX is a C++20 toolkit with reusable libraries and six independently invokable operator CLIs. The principal release workflow is to inspect or author configuration, compose and publish it with sync, stage and archive a release with pack, then use HTTP, log, and inspect tools for operational checks and diagnosis. The README describes that CLI sequence as an operator journey, not runtime dependencies, so the graph does not connect the tools to each other. Library and CLI relationships are shown where documented or visible in sampled CMake; unsampled tool implementations are represented by their documented responsibilities.

Main entry points: [`tools/toolx_sync.cpp`](https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_sync.cpp) (Sync CLI), [`tools/toolx_inspect.cpp`](https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_inspect.cpp) (Inspect CLI), [`tools/toolx_config.cpp`](https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_config.cpp) (Config CLI), [`tools/toolx_pack.cpp`](https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_pack.cpp) (Pack CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_config["Configuration"]
  node_config_cli["Config CLI<br/>[toolx_config.cpp]"]
  node_sync_cli["Sync CLI<br/>[toolx_sync.cpp]"]
  node_cfgx["Config engine<br/>[cfgx.cpp]"]
  node_schemax["Schema validation<br/>[schemax.cpp]"]
end

subgraph group_release["Release operations"]
  node_pack_cli["Pack CLI<br/>[toolx_pack.cpp]"]
  node_http_cli["HTTP CLI<br/>[toolx_http.cpp]"]
end

subgraph group_runtime["Runtime libraries"]
  node_argtool["CLI parsing<br/>[argtool.cpp]"]
  node_asyncx["Concurrency<br/>[asyncx.cpp]"]
  node_fsx["Filesystem transactions<br/>[fsx.cpp]"]
  node_httpx["HTTP client<br/>[httpx.cpp]"]
  node_logsys["Logging<br/>[logsys.cpp]"]
end

subgraph group_support["Support libraries"]
  node_utils["Common utilities<br/>[utils.cpp]"]
  node_sysx["Platform utilities<br/>[sysx.cpp]"]
  node_resultx["Result adapters"]
  node_hashx["Hash functions<br/>[hashx.cpp]"]
  node_textcodec["Text codecs<br/>[textcodec.cpp]"]
end

subgraph group_inspect["Inspection"]
  node_log_cli["Log CLI<br/>[toolx_log.cpp]"]
  node_inspect_cli["Inspect CLI<br/>[toolx_inspect.cpp]"]
  node_tuix["Terminal UI<br/>[tuix.cpp]"]
end

node_operator(("Operator"))
node_config_files["Config and schema files"]
node_log_files["Log files"]
node_release_tree["Source tree"]
node_release_output["Staged archive"]
node_http_endpoints(("HTTP endpoints"))

node_operator -->|"invokes"| node_config_cli
node_operator -->|"invokes"| node_sync_cli
node_operator -->|"invokes"| node_pack_cli
node_operator -->|"invokes"| node_http_cli
node_operator -->|"invokes"| node_log_cli
node_operator -->|"invokes"| node_inspect_cli
node_config_cli -->|"reads or edits"| node_config_files
node_config_cli -->|"loads and validates"| node_cfgx
node_config_cli -.->|"validates schema"| node_schemax
node_sync_cli -->|"reads layers; writes result"| node_config_files
node_sync_cli -->|"composes configuration"| node_cfgx
node_sync_cli -.->|"validates schema"| node_schemax
node_sync_cli -.->|"fetches remote layer"| node_httpx
node_pack_cli -->|"selects source files"| node_release_tree
node_pack_cli -->|"stages and archives"| node_release_output
node_pack_cli -->|"uses transactions"| node_fsx
node_http_cli -->|"checks endpoints"| node_http_endpoints
node_http_cli -->|"sends requests"| node_httpx
node_log_cli -->|"reads and summarizes"| node_log_files
node_inspect_cli -->|"reads config and schema"| node_config_files
node_inspect_cli -->|"loads config"| node_cfgx
node_inspect_cli -.->|"checks schema"| node_schemax
node_inspect_cli -->|"renders inspection UI"| node_tuix
node_httpx -->|"uses utilities"| node_utils
node_argtool -->|"parses arguments"| node_operator

click node_config_cli "https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_config.cpp"
click node_sync_cli "https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_sync.cpp"
click node_cfgx "https://github.com/linruiliu/toolx-cpp/blob/main/src/cfgx.cpp"
click node_schemax "https://github.com/linruiliu/toolx-cpp/blob/main/src/schemax.cpp"
click node_pack_cli "https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_pack.cpp"
click node_http_cli "https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_http.cpp"
click node_log_cli "https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_log.cpp"
click node_inspect_cli "https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_inspect.cpp"
click node_argtool "https://github.com/linruiliu/toolx-cpp/blob/main/src/argtool.cpp"
click node_asyncx "https://github.com/linruiliu/toolx-cpp/blob/main/src/asyncx.cpp"
click node_fsx "https://github.com/linruiliu/toolx-cpp/blob/main/src/fsx.cpp"
click node_httpx "https://github.com/linruiliu/toolx-cpp/blob/main/src/httpx.cpp"
click node_logsys "https://github.com/linruiliu/toolx-cpp/blob/main/src/logsys.cpp"
click node_utils "https://github.com/linruiliu/toolx-cpp/blob/main/src/utils.cpp"
click node_sysx "https://github.com/linruiliu/toolx-cpp/blob/main/src/sysx.cpp"
click node_hashx "https://github.com/linruiliu/toolx-cpp/blob/main/src/hashx.cpp"
click node_textcodec "https://github.com/linruiliu/toolx-cpp/blob/main/src/textcodec.cpp"
click node_tuix "https://github.com/linruiliu/toolx-cpp/blob/main/src/tuix.cpp"

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_config_cli,node_sync_cli,node_cfgx,node_schemax toneBlue
class node_pack_cli,node_http_cli toneAmber
class node_argtool,node_asyncx,node_fsx,node_httpx,node_logsys toneMint
class node_utils,node_sysx,node_resultx,node_hashx,node_textcodec toneRose
class node_log_cli,node_inspect_cli,node_tuix,node_operator,node_config_files,node_log_files,node_release_tree,node_release_output,node_http_endpoints toneIndigo
```

## Components

### Configuration

- [Config CLI](https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_config.cpp): `tools/toolx_config.cpp`
- [Sync CLI](https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_sync.cpp): `tools/toolx_sync.cpp`
- [Config engine](https://github.com/linruiliu/toolx-cpp/blob/main/src/cfgx.cpp): `src/cfgx.cpp`
- [Schema validation](https://github.com/linruiliu/toolx-cpp/blob/main/src/schemax.cpp): `src/schemax.cpp`

### Release operations

- [Pack CLI](https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_pack.cpp): `tools/toolx_pack.cpp`
- [HTTP CLI](https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_http.cpp): `tools/toolx_http.cpp`

### Runtime libraries

- [CLI parsing](https://github.com/linruiliu/toolx-cpp/blob/main/src/argtool.cpp): `src/argtool.cpp`
- [Concurrency](https://github.com/linruiliu/toolx-cpp/blob/main/src/asyncx.cpp): `src/asyncx.cpp`
- [Filesystem transactions](https://github.com/linruiliu/toolx-cpp/blob/main/src/fsx.cpp): `src/fsx.cpp`
- [HTTP client](https://github.com/linruiliu/toolx-cpp/blob/main/src/httpx.cpp): `src/httpx.cpp`
- [Logging](https://github.com/linruiliu/toolx-cpp/blob/main/src/logsys.cpp): `src/logsys.cpp`

### Support libraries

- [Common utilities](https://github.com/linruiliu/toolx-cpp/blob/main/src/utils.cpp): `src/utils.cpp`
- [Platform utilities](https://github.com/linruiliu/toolx-cpp/blob/main/src/sysx.cpp): `src/sysx.cpp`
- **Result adapters**
- [Hash functions](https://github.com/linruiliu/toolx-cpp/blob/main/src/hashx.cpp): `src/hashx.cpp`
- [Text codecs](https://github.com/linruiliu/toolx-cpp/blob/main/src/textcodec.cpp): `src/textcodec.cpp`

### Inspection

- [Log CLI](https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_log.cpp): `tools/toolx_log.cpp`
- [Inspect CLI](https://github.com/linruiliu/toolx-cpp/blob/main/tools/toolx_inspect.cpp): `tools/toolx_inspect.cpp`
- [Terminal UI](https://github.com/linruiliu/toolx-cpp/blob/main/src/tuix.cpp): `src/tuix.cpp`

### Other components

- **Operator**
- **Config and schema files**
- **Log files**
- **Source tree**
- **Staged archive**
- **HTTP endpoints**

## Connections

- Operator → Config CLI: invokes
- Operator → Sync CLI: invokes
- Operator → Pack CLI: invokes
- Operator → HTTP CLI: invokes
- Operator → Log CLI: invokes
- Operator → Inspect CLI: invokes
- Config CLI → Config and schema files: reads or edits
- Config CLI → Config engine: loads and validates
- Config CLI → Schema validation: validates schema
- Sync CLI → Config and schema files: reads layers; writes result
- Sync CLI → Config engine: composes configuration
- Sync CLI → Schema validation: validates schema
- Sync CLI → HTTP client: fetches remote layer
- Pack CLI → Source tree: selects source files
- Pack CLI → Staged archive: stages and archives
- Pack CLI → Filesystem transactions: uses transactions
- HTTP CLI → HTTP endpoints: checks endpoints
- HTTP CLI → HTTP client: sends requests
- Log CLI → Log files: reads and summarizes
- Inspect CLI → Config and schema files: reads config and schema
- Inspect CLI → Config engine: loads config
- Inspect CLI → Schema validation: checks schema
- Inspect CLI → Terminal UI: renders inspection UI
- HTTP client → Common utilities: uses utilities
- CLI parsing → Operator: parses arguments
