openai / codex
Components

An overview of source code logical components.

Intro

Logical decomposition is a representation of the organization of the main source code, where every and each file is put in exactly one logical component.

  • A software system can have one or more logical decompositions.
  • A logical decomposition can be defined in two ways in Sokrates.
  • First approach is based on the folders structure. Components are mapped to folders at defined folder depth relative to the source code root.
  • Second approach is based on explicit definition of each component. In such explicit definitions, components are explicitly named and their files are selected based on explicitly defined path and content filters.
  • A logical decomposition is considered invalid if a file is selected into two or more components. This constraint is introduced in order to facilitate measuring of dependencies among components.
  • Files not assigned to any component are put into a special "Unclassified" component.
Logical Decompositions Overview

Analyzed system has 2 logical decompositions:

  • primary (17 components)
  • by-layer (5 components)

Logical Decomposition #1: PRIMARY

The "primary" logical decomposition in based on 17 explicitly defined components.

Bubble Chart | Tree Map
Component Sizes (Lines of Code)
The "primary" logical decomposition has 17 components.
  • 2,448 files, 752,981 LOC (100.0% vs. main code).
  • "TUI frontend" is biggest, containing 23.62% of LOC.
  • "sdk (TypeScript & Python)" is smallest, containing 0.8% of LOC.


TUI frontend177839 LOC (23%) 402 files
core engine105038 LOC (13%) 391 files
app-server API85412 LOC (11%) 178 files
extensibility (MCP, plugins, skills, hooks)58778 LOC (7%) 191 files
sandboxing & policy49139 LOC (6%) 152 files
persistence (rollout, state, thread-store)48901 LOC (6%) 193 files
CLI & headless frontends44759 LOC (5%) 128 files
extensions (ext/*)26321 LOC (3%) 170 files
exec-server (sandboxed executor)26184 LOC (3%) 82 files
model backends & API clients24654 LOC (3%) 129 files
shared infrastructure (utils & leaf crates)22287 LOC (2%) 107 files
protocol (shared vocabulary)20007 LOC (2%) 45 files
configuration19680 LOC (2%) 70 files
repo tooling & CI15146 LOC (2%) 70 files
code-mode (V8 runtime)14453 LOC (1%) 71 files
auth & identity8378 LOC (1%) 34 files
sdk (TypeScript & Python)6005 LOC (<1%) 35 files
Component Commits
Components ordered by number of commits
Total Commits per Component
All commits, some commits may include files from multiple components.
core engine3347 commits (33%)
TUI frontend2235 commits (22%)
app-server API1338 commits (13%)
CLI & headless frontends947 commits (9%)
extensibility (MCP, plugins, skills, hooks)889 commits (8%)
protocol (shared vocabulary)876 commits (8%)
configuration506 commits (5%)
model backends & API clients471 commits (4%)
sandboxing & policy459 commits (4%)
persistence (rollout, state, thread-store)441 commits (4%)
extensions (ext/*)429 commits (4%)
shared infrastructure (utils & leaf crates)419 commits (4%)
exec-server (sandboxed executor)244 commits (2%)
auth & identity187 commits (1%)
repo tooling & CI136 commits (1%)
sdk (TypeScript & Python)71 commits (<1%)
code-mode (V8 runtime)62 commits (<1%)
Yearly File Updates Trend per Components
The number of file changes in commits
animated commit history: all time cumulative | 12 months window
2026 2025
core engine
2805
542
TUI frontend
1532
703
app-server API
1243
95
CLI & headless frontends
631
316
extensibility (MCP, plugins, skills, hooks)
727
162
protocol (shared vocabulary)
711
165
configuration
505
1
model backends & API clients
428
43
sandboxing & policy
404
55
persistence (rollout, state, thread-store)
441
extensions (ext/*)
429
shared infrastructure (utils & leaf crates)
381
38
exec-server (sandboxed executor)
242
2
auth & identity
126
61
repo tooling & CI
116
20
sdk (TypeScript & Python)
45
26
code-mode (V8 runtime)
62


Dependencies between components in same commits (past 180 days)
The number on the lines shows the number of shared commits.
See detailed temporal dependencies report... 

flowchart TB
    n0["core engine"]
    n1["TUI frontend"]
    n2["app-server API"]
    n3["protocol (shared vocabulary)"]
    n4["extensibility (MCP, plugins, skills, hooks)"]
    n5["configuration"]
    n6["extensions (ext/*)"]
    n7["persistence (rollout, state, thread-store)"]
    n8["CLI & headless frontends"]
    n9["model backends & API clients"]
    n10["shared infrastructure (utils & leaf crates)"]
    n11["sandboxing & policy"]
    n12["exec-server (sandboxed executor)"]
    n0 ---|"1494"| n0
    n1 ---|"754"| n1
    n2 ---|"692"| n2
    n2 ---|"539"| n0
    n3 ---|"474"| n0
    n4 ---|"394"| n4
    n1 ---|"366"| n0
    n2 ---|"362"| n1
    n0 ---|"338"| n4
    n0 ---|"327"| n5
    n2 ---|"289"| n3
    n6 ---|"278"| n6
    n2 ---|"272"| n4
    n5 ---|"250"| n5
    n6 ---|"248"| n0
    n7 ---|"238"| n7
    n8 ---|"233"| n0
    n8 ---|"227"| n2
    n3 ---|"206"| n1
    n8 ---|"204"| n1
    n9 ---|"204"| n0
    n9 ---|"201"| n9
    n10 ---|"191"| n0
    n11 ---|"190"| n11
    n7 ---|"187"| n0
    n8 ---|"176"| n8
    n7 ---|"163"| n2
    n3 ---|"161"| n3
    n12 ---|"156"| n12
    n10 ---|"151"| n10
    n1 ---|"151"| n5
    n4 ---|"149"| n1
    n5 ---|"141"| n2
    n11 ---|"131"| n0
    n4 ---|"122"| n8
    n7 ---|"120"| n3
    n4 ---|"115"| n3
    n2 ---|"115"| n10
    n9 ---|"110"| n3
    n9 ---|"110"| n2
    n6 ---|"104"| n2
    n12 ---|"100"| n0
    n7 ---|"97"| n1
    n10 ---|"92"| n3
    n8 ---|"87"| n3
    n4 ---|"87"| n5
    n1 ---|"83"| n10
    n9 ---|"82"| n1
    n5 ---|"77"| n8
    n5 ---|"71"| n3
    classDef default fill:#00b2ee,stroke:#ffffff,color:#000000;
    classDef highlighted fill:#00b2ee,stroke:#ffffff,color:#000000;
    linkStyle 0 stroke:#a0a0a0FF,stroke-width:10px
    linkStyle 1 stroke:#a0a0a0A5,stroke-width:5px
    linkStyle 2 stroke:#a0a0a093,stroke-width:4px
    linkStyle 3 stroke:#00688b82,stroke-width:3px
    linkStyle 4 stroke:#00688b82,stroke-width:3px
    linkStyle 5 stroke:#a0a0a070,stroke-width:2px
    linkStyle 6 stroke:#00688b70,stroke-width:2px
    linkStyle 7 stroke:#00688b70,stroke-width:2px
    linkStyle 8 stroke:#00688b70,stroke-width:2px
    linkStyle 9 stroke:#00688b70,stroke-width:2px
    linkStyle 10 stroke:#00688b5E,stroke-width:1px
    linkStyle 11 stroke:#a0a0a05E,stroke-width:1px
    linkStyle 12 stroke:#00688b5E,stroke-width:1px
    linkStyle 13 stroke:#a0a0a05E,stroke-width:1px
    linkStyle 14 stroke:#00688b5E,stroke-width:1px
    linkStyle 15 stroke:#a0a0a05E,stroke-width:1px
    linkStyle 16 stroke:#00688b5E,stroke-width:1px
    linkStyle 17 stroke:#00688b5E,stroke-width:1px
    linkStyle 18 stroke:#00688b5E,stroke-width:1px
    linkStyle 19 stroke:#00688b5E,stroke-width:1px
    linkStyle 20 stroke:#00688b5E,stroke-width:1px
    linkStyle 21 stroke:#a0a0a05E,stroke-width:1px
    linkStyle 22 stroke:#00688b5E,stroke-width:1px
    linkStyle 23 stroke:#a0a0a05E,stroke-width:1px
    linkStyle 24 stroke:#00688b5E,stroke-width:1px
    linkStyle 25 stroke:#a0a0a05E,stroke-width:1px
    linkStyle 26 stroke:#00688b5E,stroke-width:1px
    linkStyle 27 stroke:#a0a0a05E,stroke-width:1px
    linkStyle 28 stroke:#a0a0a05E,stroke-width:1px
    linkStyle 29 stroke:#a0a0a05E,stroke-width:1px
    linkStyle 30 stroke:#00688b5E,stroke-width:1px
    linkStyle 31 stroke:#00688b4C,stroke-width:1px
    linkStyle 32 stroke:#00688b4C,stroke-width:1px
    linkStyle 33 stroke:#00688b4C,stroke-width:1px
    linkStyle 34 stroke:#00688b4C,stroke-width:1px
    linkStyle 35 stroke:#00688b4C,stroke-width:1px
    linkStyle 36 stroke:#00688b4C,stroke-width:1px
    linkStyle 37 stroke:#00688b4C,stroke-width:1px
    linkStyle 38 stroke:#00688b4C,stroke-width:1px
    linkStyle 39 stroke:#00688b4C,stroke-width:1px
    linkStyle 40 stroke:#00688b4C,stroke-width:1px
    linkStyle 41 stroke:#00688b4C,stroke-width:1px
    linkStyle 42 stroke:#00688b4C,stroke-width:1px
    linkStyle 43 stroke:#00688b4C,stroke-width:1px
    linkStyle 44 stroke:#00688b4C,stroke-width:1px
    linkStyle 45 stroke:#00688b4C,stroke-width:1px
    linkStyle 46 stroke:#00688b4C,stroke-width:1px
    linkStyle 47 stroke:#00688b4C,stroke-width:1px
    linkStyle 48 stroke:#00688b4C,stroke-width:1px
    linkStyle 49 stroke:#00688b4C,stroke-width:1px

2026-08-31 17:17