# txyy2023/log_print architecture

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

- Interactive diagram: https://gitdiagram.com/txyy2023/log_print
- Repository: https://github.com/txyy2023/log_print

## Overview

log_print is a local Rust toolkit for collecting, inspecting, transforming, displaying, and archiving log streams. The main workflow is to use the CLI to start a Core instance and input/output plugins, then inspect streams or view them in the browser or terminal; transformation can publish derived streams, and file outputs provide explicit persistence. The graph also shows the shared display engine and the distinct WebUI and TUI interfaces. Some plugin relationships are documented in the README rather than shown in sampled implementation excerpts.

Main entry points: [`project/crates/log-core/src/lib.rs`](https://github.com/txyy2023/log_print/blob/main/project/crates/log-core/src/lib.rs) (Core router and buffer), [`project/plugins/outputs/output-webui/frontend/src/App.vue`](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/App.vue) (WebUI workbench), [`project/plugins/outputs/output-tui/src/main.rs`](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-tui/src/main.rs) (TUI entry point), [`project/crates/log-view/src/engine.rs`](https://github.com/txyy2023/log_print/blob/main/project/crates/log-view/src/engine.rs) (Shared display engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control and protocol"]
  node_cli["CLI<br/>[cli.rs]"]
  node_supervisor["Instance supervisor<br/>[main.rs]"]
  node_core["Core router and buffer<br/>[lib.rs]"]
  node_plugin_sdk["Plugin lifecycle SDK<br/>[lifecycle.rs]"]
  node_protocol["Stream protocol<br/>[lib.rs]"]
end

subgraph group_collection["Stream collection"]
  node_file_input["File input<br/>[main.rs]"]
  node_program_input["Program / tmux input<br/>[main.rs]"]
end

subgraph group_processing["Stream processing"]
  node_transform["Stream transform<br/>[transform.rs]"]
  node_transform_plugin["Transform publisher<br/>[main.rs]"]
end

subgraph group_display["Workbench display"]
  node_raw_output["Raw display output<br/>[main.rs]"]
  node_display_engine["Shared display engine<br/>[engine.rs]"]
  node_display_server["Display HTTP server<br/>[server.rs]"]
  node_display_store[("Workbench state store<br/>[store.rs]")]
  node_web_frontend["WebUI workbench<br/>[App.vue]"]
  node_web_api["WebUI API client<br/>[api.ts]"]
  node_web_panels["Canvas and panels<br/>[CanvasBoard.vue]"]
  node_web_inspector["Panel inspector<br/>[Inspector.vue]"]
  node_web_icons["Workbench icons<br/>[Icon.vue]"]
  node_tui_client["TUI display client<br/>[client.rs]"]
  node_tui_ui["TUI interaction<br/>[ui.rs]"]
  node_tui_render["TUI rendering<br/>[render.rs]"]
  node_tui_entry["TUI entry point<br/>[main.rs]"]
end

subgraph group_persistence["Archiving"]
  node_file_archive["File and SQLite archive<br/>[main.rs]"]
end

node_operator(("Operator / agent"))

node_operator -->|"runs commands"| node_cli
node_cli -->|"configures instance"| node_supervisor
node_supervisor -->|"starts and controls"| node_core
node_file_input -->|"publishes records"| node_core
node_program_input -->|"publishes records"| node_core
node_transform_plugin -->|"subscribes and publishes"| node_core
node_transform_plugin -->|"uses processor"| node_transform
node_core -->|"routes stream records"| node_raw_output
node_core -->|"routes stream records"| node_file_archive
node_core -->|"serves display history"| node_display_engine
node_display_engine -->|"reads and writes state"| node_display_store
node_display_engine -->|"queries live streams"| node_core
node_display_server -->|"dispatches commands"| node_display_engine
node_web_frontend -->|"calls commands"| node_web_api
node_web_api -->|"posts control requests"| node_display_server
node_web_frontend -->|"renders workbench"| node_web_panels
node_web_frontend -->|"renders inspector"| node_web_inspector
node_web_frontend -->|"renders icons"| node_web_icons
node_tui_entry -->|"starts display service"| node_display_server
node_tui_entry -->|"creates viewer client"| node_tui_client
node_tui_client -->|"requests display data"| node_display_server
node_tui_ui -->|"sends commands"| node_tui_client
node_tui_entry -->|"drives interaction"| node_tui_ui
node_tui_entry -->|"draws terminal view"| node_tui_render
node_tui_render -->|"renders application state"| node_tui_ui
node_plugin_sdk -.->|"uses stream types"| node_protocol
node_file_archive -->|"reports commit results"| node_operator

click node_cli "https://github.com/txyy2023/log_print/blob/main/project/crates/app-log-print/src/cli.rs"
click node_supervisor "https://github.com/txyy2023/log_print/blob/main/project/crates/app-log-print/src/main.rs"
click node_core "https://github.com/txyy2023/log_print/blob/main/project/crates/log-core/src/lib.rs"
click node_plugin_sdk "https://github.com/txyy2023/log_print/blob/main/project/crates/log-plugin-sdk/src/lifecycle.rs"
click node_protocol "https://github.com/txyy2023/log_print/blob/main/project/crates/log-proto/src/lib.rs"
click node_file_input "https://github.com/txyy2023/log_print/blob/main/project/plugins/inputs/input-file/src/main.rs"
click node_program_input "https://github.com/txyy2023/log_print/blob/main/project/plugins/inputs/input-program/src/main.rs"
click node_transform "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-transform/src/transform.rs"
click node_transform_plugin "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-transform/src/main.rs"
click node_raw_output "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-raw/src/main.rs"
click node_display_engine "https://github.com/txyy2023/log_print/blob/main/project/crates/log-view/src/engine.rs"
click node_display_server "https://github.com/txyy2023/log_print/blob/main/project/crates/log-view/src/server.rs"
click node_display_store "https://github.com/txyy2023/log_print/blob/main/project/crates/log-view/src/store.rs"
click node_web_frontend "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/App.vue"
click node_web_api "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/api.ts"
click node_web_panels "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/CanvasBoard.vue"
click node_web_inspector "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/Inspector.vue"
click node_web_icons "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/Icon.vue"
click node_tui_client "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-tui/src/client.rs"
click node_tui_ui "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-tui/src/ui.rs"
click node_tui_render "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-tui/src/render.rs"
click node_tui_entry "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-tui/src/main.rs"
click node_file_archive "https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-file/src/main.rs"

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_cli,node_supervisor,node_core,node_plugin_sdk,node_protocol toneBlue
class node_file_input,node_program_input toneAmber
class node_transform,node_transform_plugin toneMint
class node_raw_output,node_display_engine,node_display_server,node_display_store,node_web_frontend,node_web_api,node_web_panels,node_web_inspector,node_web_icons,node_tui_client,node_tui_ui,node_tui_render,node_tui_entry toneRose
class node_file_archive,node_operator toneIndigo
```

## Components

### Control and protocol

- [CLI](https://github.com/txyy2023/log_print/blob/main/project/crates/app-log-print/src/cli.rs): `project/crates/app-log-print/src/cli.rs`
- [Instance supervisor](https://github.com/txyy2023/log_print/blob/main/project/crates/app-log-print/src/main.rs): `project/crates/app-log-print/src/main.rs`
- [Core router and buffer](https://github.com/txyy2023/log_print/blob/main/project/crates/log-core/src/lib.rs): `project/crates/log-core/src/lib.rs`
- [Plugin lifecycle SDK](https://github.com/txyy2023/log_print/blob/main/project/crates/log-plugin-sdk/src/lifecycle.rs): `project/crates/log-plugin-sdk/src/lifecycle.rs`
- [Stream protocol](https://github.com/txyy2023/log_print/blob/main/project/crates/log-proto/src/lib.rs): `project/crates/log-proto/src/lib.rs`

### Stream collection

- [File input](https://github.com/txyy2023/log_print/blob/main/project/plugins/inputs/input-file/src/main.rs): `project/plugins/inputs/input-file/src/main.rs`
- [Program / tmux input](https://github.com/txyy2023/log_print/blob/main/project/plugins/inputs/input-program/src/main.rs): `project/plugins/inputs/input-program/src/main.rs`

### Stream processing

- [Stream transform](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-transform/src/transform.rs): `project/plugins/outputs/output-transform/src/transform.rs`
- [Transform publisher](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-transform/src/main.rs): `project/plugins/outputs/output-transform/src/main.rs`

### Workbench display

- [Raw display output](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-raw/src/main.rs): `project/plugins/outputs/output-raw/src/main.rs`
- [Shared display engine](https://github.com/txyy2023/log_print/blob/main/project/crates/log-view/src/engine.rs): `project/crates/log-view/src/engine.rs`
- [Display HTTP server](https://github.com/txyy2023/log_print/blob/main/project/crates/log-view/src/server.rs): `project/crates/log-view/src/server.rs`
- [Workbench state store](https://github.com/txyy2023/log_print/blob/main/project/crates/log-view/src/store.rs): `project/crates/log-view/src/store.rs`
- [WebUI workbench](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/App.vue): `project/plugins/outputs/output-webui/frontend/src/App.vue`
- [WebUI API client](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/api.ts): `project/plugins/outputs/output-webui/frontend/src/api.ts`
- [Canvas and panels](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/CanvasBoard.vue): `project/plugins/outputs/output-webui/frontend/src/CanvasBoard.vue`
- [Panel inspector](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/Inspector.vue): `project/plugins/outputs/output-webui/frontend/src/Inspector.vue`
- [Workbench icons](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-webui/frontend/src/Icon.vue): `project/plugins/outputs/output-webui/frontend/src/Icon.vue`
- [TUI display client](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-tui/src/client.rs): `project/plugins/outputs/output-tui/src/client.rs`
- [TUI interaction](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-tui/src/ui.rs): `project/plugins/outputs/output-tui/src/ui.rs`
- [TUI rendering](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-tui/src/render.rs): `project/plugins/outputs/output-tui/src/render.rs`
- [TUI entry point](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-tui/src/main.rs): `project/plugins/outputs/output-tui/src/main.rs`

### Archiving

- [File and SQLite archive](https://github.com/txyy2023/log_print/blob/main/project/plugins/outputs/output-file/src/main.rs): `project/plugins/outputs/output-file/src/main.rs`

### Other components

- **Operator / agent**

## Connections

- Operator / agent → CLI: runs commands (evidence: `README.md`)
- CLI → Instance supervisor: configures instance (evidence: `project/crates/app-log-print/src/main.rs`)
- Instance supervisor → Core router and buffer: starts and controls (evidence: `README.md`)
- File input → Core router and buffer: publishes records (evidence: `README.md`)
- Program / tmux input → Core router and buffer: publishes records (evidence: `README.md`)
- Transform publisher → Core router and buffer: subscribes and publishes (evidence: `project/plugins/outputs/output-transform/src/main.rs`)
- Transform publisher → Stream transform: uses processor (evidence: `project/plugins/outputs/output-transform/src/main.rs`)
- Core router and buffer → Raw display output: routes stream records (evidence: `README.md`)
- Core router and buffer → File and SQLite archive: routes stream records (evidence: `README.md`)
- Core router and buffer → Shared display engine: serves display history (evidence: `README.md`)
- Shared display engine → Workbench state store: reads and writes state (evidence: `project/crates/log-view/src/server.rs`)
- Shared display engine → Core router and buffer: queries live streams (evidence: `project/crates/log-view/src/engine.rs`)
- Display HTTP server → Shared display engine: dispatches commands (evidence: `project/crates/log-view/src/server.rs`)
- WebUI workbench → WebUI API client: calls commands (evidence: `project/plugins/outputs/output-webui/frontend/src/App.vue`)
- WebUI API client → Display HTTP server: posts control requests (evidence: `project/plugins/outputs/output-webui/frontend/src/api.ts`)
- WebUI workbench → Canvas and panels: renders workbench (evidence: `project/plugins/outputs/output-webui/frontend/src/App.vue`)
- WebUI workbench → Panel inspector: renders inspector (evidence: `project/plugins/outputs/output-webui/frontend/src/App.vue`)
- WebUI workbench → Workbench icons: renders icons (evidence: `project/plugins/outputs/output-webui/frontend/src/App.vue`)
- TUI entry point → Display HTTP server: starts display service (evidence: `project/plugins/outputs/output-tui/src/main.rs`)
- TUI entry point → TUI display client: creates viewer client (evidence: `project/plugins/outputs/output-tui/src/main.rs`)
- TUI display client → Display HTTP server: requests display data (evidence: `project/plugins/outputs/output-tui/src/client.rs`)
- TUI interaction → TUI display client: sends commands (evidence: `project/plugins/outputs/output-tui/src/ui.rs`)
- TUI entry point → TUI interaction: drives interaction (evidence: `project/plugins/outputs/output-tui/src/main.rs`)
- TUI entry point → TUI rendering: draws terminal view (evidence: `project/plugins/outputs/output-tui/src/main.rs`)
- TUI rendering → TUI interaction: renders application state (evidence: `project/plugins/outputs/output-tui/src/render.rs`)
- Plugin lifecycle SDK → Stream protocol: uses stream types
- File and SQLite archive → Operator / agent: reports commit results (evidence: `README.md`)
