# florinidita/ecc architecture

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

- Interactive diagram: https://gitdiagram.com/florinidita/ecc
- Repository: https://github.com/florinidita/ecc

## Overview

ECC is a harness-native agent operating system and toolbox. An operator starts or monitors work through the Rust CLI or dashboard; session management coordinates agent runs, persistence, output, and inter-agent messages. The repository also contains context-profile evaluation, GateGuard effectiveness evaluation, taste-application tooling, and Python LLM provider code. The graph emphasizes relationships visible in excerpts or the SOURCE INDEX; several documented-by-tree subsystems have no sampled runtime wiring, so their connections are omitted.

Main entry points: [`ecc2/src/session/manager.rs`](https://github.com/florinidita/ecc/blob/main/ecc2/src/session/manager.rs) (Session manager), [`ecc2/src/main.rs`](https://github.com/florinidita/ecc/blob/main/ecc2/src/main.rs) (ECC CLI), [`ecc2/src/session/store.rs`](https://github.com/florinidita/ecc/blob/main/ecc2/src/session/store.rs) (Session store), [`src/llm/providers/ollama.py`](https://github.com/florinidita/ecc/blob/main/src/llm/providers/ollama.py) (Ollama provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Operator entry"]
  node_ecc_cli["ECC CLI<br/>[main.rs]"]
  node_config["Configuration<br/>[mod.rs]"]
  node_tui["Terminal dashboard<br/>[app.rs]"]
  node_dashboard["Dashboard view<br/>[dashboard.rs]"]
end

subgraph group_sessions["Session runtime"]
  node_session_manager["Session manager<br/>[manager.rs]"]
  node_session_runtime["Agent runtime<br/>[runtime.rs]"]
  node_session_store[("Session store<br/>[store.rs]")]
  node_session_output["Output stream<br/>[output.rs]"]
  node_communications["Agent messaging<br/>[mod.rs]"]
  node_daemon["Session daemon<br/>[daemon.rs]"]
  node_notifications["Notifications<br/>[notifications.rs]"]
end

subgraph group_evaluation["Evaluation tools"]
  node_harness_eval["Harness evaluation<br/>[harness_eval.rs]"]
  node_context_eval["Context evaluation<br/>[ai-eval-lib.js]"]
  node_gateguard_eval["GateGuard evaluation<br/>[lib.js]"]
  node_gateguard_arms["Evaluation arms<br/>[arms.js]"]
  node_gateguard_coverage["Coverage analysis<br/>[coverage.js]"]
end

subgraph group_extensions["Agent extensions"]
  node_taste_pipeline["Taste pipeline<br/>[pipeline.py]"]
  node_taste_forge["Taste forge<br/>[forge.py]"]
  node_llm_ollama["Ollama provider<br/>[ollama.py]"]
  node_llm_interface["LLM interface<br/>[interface.py]"]
  node_llm_types["LLM types<br/>[types.py]"]
  node_llm_reasoning["Reasoning support<br/>[reasoning.py]"]
end

node_operator(("Operator"))

node_operator -->|"runs commands"| node_ecc_cli
node_ecc_cli -->|"manages sessions"| node_session_manager
node_ecc_cli -->|"loads settings"| node_config
node_ecc_cli -->|"launches dashboard"| node_tui
node_tui -->|"handles interaction"| node_dashboard
node_tui -->|"reads state"| node_session_store
node_session_manager -->|"starts runtime"| node_session_runtime
node_session_manager -->|"persists sessions"| node_session_store
node_session_manager -->|"uses output"| node_session_output
node_session_manager -->|"routes messages"| node_communications
node_session_manager -->|"reads settings"| node_config
node_session_manager -->|"uses notifications"| node_notifications
node_daemon -->|"uses state"| node_session_store
node_communications -->|"stores messages"| node_session_store
node_session_runtime -->|"uses output"| node_session_output
node_harness_eval -->|"supports evaluation"| node_ecc_cli
node_gateguard_eval -->|"runs scored checks"| node_context_eval
node_gateguard_eval -->|"uses arms"| node_gateguard_arms
node_gateguard_coverage -->|"uses scoring"| node_context_eval
node_gateguard_coverage -->|"uses evaluator"| node_gateguard_eval
node_taste_pipeline -->|"invokes forge"| node_taste_forge
node_llm_ollama -->|"implements interface"| node_llm_interface
node_llm_ollama -->|"uses types"| node_llm_types
node_llm_ollama -->|"uses reasoning"| node_llm_reasoning

click node_ecc_cli "https://github.com/florinidita/ecc/blob/main/ecc2/src/main.rs"
click node_config "https://github.com/florinidita/ecc/blob/main/ecc2/src/config/mod.rs"
click node_tui "https://github.com/florinidita/ecc/blob/main/ecc2/src/tui/app.rs"
click node_dashboard "https://github.com/florinidita/ecc/blob/main/ecc2/src/tui/dashboard.rs"
click node_session_manager "https://github.com/florinidita/ecc/blob/main/ecc2/src/session/manager.rs"
click node_session_runtime "https://github.com/florinidita/ecc/blob/main/ecc2/src/session/runtime.rs"
click node_session_store "https://github.com/florinidita/ecc/blob/main/ecc2/src/session/store.rs"
click node_session_output "https://github.com/florinidita/ecc/blob/main/ecc2/src/session/output.rs"
click node_communications "https://github.com/florinidita/ecc/blob/main/ecc2/src/comms/mod.rs"
click node_daemon "https://github.com/florinidita/ecc/blob/main/ecc2/src/session/daemon.rs"
click node_notifications "https://github.com/florinidita/ecc/blob/main/ecc2/src/notifications.rs"
click node_harness_eval "https://github.com/florinidita/ecc/blob/main/ecc2/src/harness_eval.rs"
click node_context_eval "https://github.com/florinidita/ecc/blob/main/docker/context-profiles/ai-eval-lib.js"
click node_gateguard_eval "https://github.com/florinidita/ecc/blob/main/docker/gateguard-effectiveness/lib.js"
click node_gateguard_arms "https://github.com/florinidita/ecc/blob/main/docker/gateguard-effectiveness/arms.js"
click node_gateguard_coverage "https://github.com/florinidita/ecc/blob/main/docker/gateguard-effectiveness/coverage.js"
click node_taste_pipeline "https://github.com/florinidita/ecc/blob/main/skills/taste-application/scripts/pipeline.py"
click node_taste_forge "https://github.com/florinidita/ecc/blob/main/skills/taste-application/scripts/forge.py"
click node_llm_ollama "https://github.com/florinidita/ecc/blob/main/src/llm/providers/ollama.py"
click node_llm_interface "https://github.com/florinidita/ecc/blob/main/src/llm/core/interface.py"
click node_llm_types "https://github.com/florinidita/ecc/blob/main/src/llm/core/types.py"
click node_llm_reasoning "https://github.com/florinidita/ecc/blob/main/src/llm/providers/reasoning.py"

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_ecc_cli,node_config,node_tui,node_dashboard toneBlue
class node_session_manager,node_session_runtime,node_session_store,node_session_output,node_communications,node_daemon,node_notifications toneAmber
class node_harness_eval,node_context_eval,node_gateguard_eval,node_gateguard_arms,node_gateguard_coverage toneMint
class node_taste_pipeline,node_taste_forge,node_llm_ollama,node_llm_interface,node_llm_types,node_llm_reasoning toneRose
class node_operator toneIndigo
```

## Components

### Operator entry

- [ECC CLI](https://github.com/florinidita/ecc/blob/main/ecc2/src/main.rs): `ecc2/src/main.rs`
- [Configuration](https://github.com/florinidita/ecc/blob/main/ecc2/src/config/mod.rs): `ecc2/src/config/mod.rs`
- [Terminal dashboard](https://github.com/florinidita/ecc/blob/main/ecc2/src/tui/app.rs): `ecc2/src/tui/app.rs`
- [Dashboard view](https://github.com/florinidita/ecc/blob/main/ecc2/src/tui/dashboard.rs): `ecc2/src/tui/dashboard.rs`

### Session runtime

- [Session manager](https://github.com/florinidita/ecc/blob/main/ecc2/src/session/manager.rs): `ecc2/src/session/manager.rs`
- [Agent runtime](https://github.com/florinidita/ecc/blob/main/ecc2/src/session/runtime.rs): `ecc2/src/session/runtime.rs`
- [Session store](https://github.com/florinidita/ecc/blob/main/ecc2/src/session/store.rs): `ecc2/src/session/store.rs`
- [Output stream](https://github.com/florinidita/ecc/blob/main/ecc2/src/session/output.rs): `ecc2/src/session/output.rs`
- [Agent messaging](https://github.com/florinidita/ecc/blob/main/ecc2/src/comms/mod.rs): `ecc2/src/comms/mod.rs`
- [Session daemon](https://github.com/florinidita/ecc/blob/main/ecc2/src/session/daemon.rs): `ecc2/src/session/daemon.rs`
- [Notifications](https://github.com/florinidita/ecc/blob/main/ecc2/src/notifications.rs): `ecc2/src/notifications.rs`

### Evaluation tools

- [Harness evaluation](https://github.com/florinidita/ecc/blob/main/ecc2/src/harness_eval.rs): `ecc2/src/harness_eval.rs`
- [Context evaluation](https://github.com/florinidita/ecc/blob/main/docker/context-profiles/ai-eval-lib.js): `docker/context-profiles/ai-eval-lib.js`
- [GateGuard evaluation](https://github.com/florinidita/ecc/blob/main/docker/gateguard-effectiveness/lib.js): `docker/gateguard-effectiveness/lib.js`
- [Evaluation arms](https://github.com/florinidita/ecc/blob/main/docker/gateguard-effectiveness/arms.js): `docker/gateguard-effectiveness/arms.js`
- [Coverage analysis](https://github.com/florinidita/ecc/blob/main/docker/gateguard-effectiveness/coverage.js): `docker/gateguard-effectiveness/coverage.js`

### Agent extensions

- [Taste pipeline](https://github.com/florinidita/ecc/blob/main/skills/taste-application/scripts/pipeline.py): `skills/taste-application/scripts/pipeline.py`
- [Taste forge](https://github.com/florinidita/ecc/blob/main/skills/taste-application/scripts/forge.py): `skills/taste-application/scripts/forge.py`
- [Ollama provider](https://github.com/florinidita/ecc/blob/main/src/llm/providers/ollama.py): `src/llm/providers/ollama.py`
- [LLM interface](https://github.com/florinidita/ecc/blob/main/src/llm/core/interface.py): `src/llm/core/interface.py`
- [LLM types](https://github.com/florinidita/ecc/blob/main/src/llm/core/types.py): `src/llm/core/types.py`
- [Reasoning support](https://github.com/florinidita/ecc/blob/main/src/llm/providers/reasoning.py): `src/llm/providers/reasoning.py`

### Other components

- **Operator**

## Connections

- Operator → ECC CLI: runs commands (evidence: `README.md`)
- ECC CLI → Session manager: manages sessions (evidence: `ecc2/src/main.rs`)
- ECC CLI → Configuration: loads settings (evidence: `ecc2/src/main.rs`)
- ECC CLI → Terminal dashboard: launches dashboard (evidence: `ecc2/src/main.rs`)
- Terminal dashboard → Dashboard view: handles interaction (evidence: `ecc2/src/tui/app.rs`)
- Terminal dashboard → Session store: reads state (evidence: `ecc2/src/tui/app.rs`)
- Session manager → Agent runtime: starts runtime (evidence: `ecc2/src/session/manager.rs`)
- Session manager → Session store: persists sessions (evidence: `ecc2/src/session/manager.rs`)
- Session manager → Output stream: uses output (evidence: `ecc2/src/session/manager.rs`)
- Session manager → Agent messaging: routes messages (evidence: `ecc2/src/session/manager.rs`)
- Session manager → Configuration: reads settings (evidence: `ecc2/src/session/manager.rs`)
- Session manager → Notifications: uses notifications (evidence: `ecc2/src/session/manager.rs`)
- Session daemon → Session store: uses state (evidence: `ecc2/src/session/mod.rs`)
- Agent messaging → Session store: stores messages (evidence: `ecc2/src/comms/mod.rs`)
- Agent runtime → Output stream: uses output (evidence: `ecc2/src/session/runtime.rs`)
- Harness evaluation → ECC CLI: supports evaluation (evidence: `ecc2/src/main.rs`)
- GateGuard evaluation → Context evaluation: runs scored checks (evidence: `docker/gateguard-effectiveness/lib.js`)
- GateGuard evaluation → Evaluation arms: uses arms (evidence: `docker/gateguard-effectiveness/lib.js`)
- Coverage analysis → Context evaluation: uses scoring (evidence: `docker/gateguard-effectiveness/coverage.js`)
- Coverage analysis → GateGuard evaluation: uses evaluator (evidence: `docker/gateguard-effectiveness/coverage.js`)
- Taste pipeline → Taste forge: invokes forge (evidence: `skills/taste-application/scripts/pipeline.py`)
- Ollama provider → LLM interface: implements interface (evidence: `src/llm/providers/ollama.py`)
- Ollama provider → LLM types: uses types (evidence: `src/llm/providers/ollama.py`)
- Ollama provider → Reasoning support: uses reasoning (evidence: `src/llm/providers/ollama.py`)
