# ahmadalameri-0/codexion architecture

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

- Interactive diagram: https://gitdiagram.com/ahmadalameri-0/codexion
- Repository: https://github.com/ahmadalameri-0/codexion

## Overview

Codexion is a command-line POSIX-thread simulation of coders competing for adjacent dongles. The workflow parses parameters, initializes shared simulation state, runs one coder thread per participant, arbitrates atomic dongle acquisition using FIFO or EDF request heaps, and monitors burnout or completion before joining workers. Cooldowns, synchronized logging, and stop signaling support that workflow. The excerpts show the main calls and synchronization paths; unsampled build and peripheral details are omitted.

Main entry points: [`main.c`](https://github.com/ahmadalameri-0/codexion/blob/main/main.c) (Simulation Entry), [`src/routine.c`](https://github.com/ahmadalameri-0/codexion/blob/main/src/routine.c) (Coder Workers), [`src/monitor.c`](https://github.com/ahmadalameri-0/codexion/blob/main/src/monitor.c) (Burnout Monitor), [`src/dongle.c`](https://github.com/ahmadalameri-0/codexion/blob/main/src/dongle.c) (Dongle Arbitration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Simulation Lifecycle"]
  node_entry["Simulation Entry<br/>[main.c]"]
  node_arguments["Argument Parsing<br/>[parse.c]"]
  node_initialization["State Initialization<br/>[init.c]"]
  node_coder["Coder Workers<br/>[routine.c]"]
  node_monitor["Burnout Monitor<br/>[monitor.c]"]
end

subgraph group_arbitration["Resource Arbitration"]
  node_dongles["Dongle Arbitration<br/>[dongle.c]"]
  node_scheduler["Request Heaps<br/>[scheduler.c]"]
end

subgraph group_state["Timing and State"]
  node_shared["Simulation State<br/>[Codexion.h]"]
  node_timing["Timing Utilities<br/>[utils.c]"]
end

node_operator(("CLI User"))

node_operator -->|"runs"| node_entry
node_entry -->|"parses arguments"| node_arguments
node_entry -->|"initializes"| node_initialization
node_entry -->|"starts threads"| node_coder
node_entry -->|"runs monitor"| node_monitor
node_entry -->|"joins threads"| node_coder
node_initialization -->|"initializes fields"| node_shared
node_coder -->|"requests and releases"| node_dongles
node_dongles -->|"updates heaps"| node_scheduler
node_coder -->|"uses time and waits"| node_timing
node_dongles -->|"waits for cooldown"| node_timing
node_monitor -->|"checks time"| node_timing
node_monitor -->|"stops simulation"| node_shared

click node_entry "https://github.com/ahmadalameri-0/codexion/blob/main/main.c"
click node_arguments "https://github.com/ahmadalameri-0/codexion/blob/main/src/parse.c"
click node_initialization "https://github.com/ahmadalameri-0/codexion/blob/main/src/init.c"
click node_coder "https://github.com/ahmadalameri-0/codexion/blob/main/src/routine.c"
click node_monitor "https://github.com/ahmadalameri-0/codexion/blob/main/src/monitor.c"
click node_dongles "https://github.com/ahmadalameri-0/codexion/blob/main/src/dongle.c"
click node_scheduler "https://github.com/ahmadalameri-0/codexion/blob/main/src/scheduler.c"
click node_shared "https://github.com/ahmadalameri-0/codexion/blob/main/Codexion.h"
click node_timing "https://github.com/ahmadalameri-0/codexion/blob/main/src/utils.c"

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_entry,node_arguments,node_initialization,node_coder,node_monitor,node_operator toneBlue
class node_dongles,node_scheduler toneAmber
class node_shared,node_timing toneMint
```

## Components

### Simulation Lifecycle

- [Simulation Entry](https://github.com/ahmadalameri-0/codexion/blob/main/main.c): `main.c`
- [Argument Parsing](https://github.com/ahmadalameri-0/codexion/blob/main/src/parse.c): `src/parse.c`
- [State Initialization](https://github.com/ahmadalameri-0/codexion/blob/main/src/init.c): `src/init.c`
- [Coder Workers](https://github.com/ahmadalameri-0/codexion/blob/main/src/routine.c): `src/routine.c`
- [Burnout Monitor](https://github.com/ahmadalameri-0/codexion/blob/main/src/monitor.c): `src/monitor.c`

### Resource Arbitration

- [Dongle Arbitration](https://github.com/ahmadalameri-0/codexion/blob/main/src/dongle.c): `src/dongle.c`
- [Request Heaps](https://github.com/ahmadalameri-0/codexion/blob/main/src/scheduler.c): `src/scheduler.c`

### Timing and State

- [Simulation State](https://github.com/ahmadalameri-0/codexion/blob/main/Codexion.h): `Codexion.h`
- [Timing Utilities](https://github.com/ahmadalameri-0/codexion/blob/main/src/utils.c): `src/utils.c`

### Other components

- **CLI User**

## Connections

- CLI User → Simulation Entry: runs (evidence: `README.md`)
- Simulation Entry → Argument Parsing: parses arguments (evidence: `main.c`)
- Simulation Entry → State Initialization: initializes (evidence: `main.c`)
- Simulation Entry → Coder Workers: starts threads (evidence: `main.c`)
- Simulation Entry → Burnout Monitor: runs monitor (evidence: `main.c`)
- Simulation Entry → Coder Workers: joins threads (evidence: `main.c`)
- State Initialization → Simulation State: initializes fields (evidence: `src/init.c`)
- Coder Workers → Dongle Arbitration: requests and releases (evidence: `src/routine.c`)
- Dongle Arbitration → Request Heaps: updates heaps (evidence: `src/dongle.c`)
- Coder Workers → Timing Utilities: uses time and waits (evidence: `src/routine.c`)
- Dongle Arbitration → Timing Utilities: waits for cooldown (evidence: `src/dongle.c`)
- Burnout Monitor → Timing Utilities: checks time (evidence: `src/monitor.c`)
- Burnout Monitor → Simulation State: stops simulation (evidence: `src/monitor.c`)
