How uripros/os-project works
The Citadel System is a C program that runs one Maester process per realm. Its main workflow loads realm configuration and stock, starts network and envoy workers, and provides commands for realm/product listing, pledges, envoy status, and trade sessions. Envoys handle delegated missions; socket framing and network handlers support communication between realms. The README describes these capabilities, but source excerpts are limited, so links between command routing and specific handlers are documented rather than verified from call sites.
Main entry points: maester.c Maester process · detectCommand.c Command detection · envoyConfig.c Envoy configuration · localConfig.c Local configuration
Components 17
Maester runtime
- Maester process
maester.c - Local configuration
CONFIG/localConfig.c - Shared utilities
utils.c
User commands
- Command detection
COMMANDS/detectCommand.c - Listing commands
COMMANDS/LIST/listComm.c - Pledge commands
COMMANDS/PLEDGE/pledgeComm.c - Envoy commands
COMMANDS/ENVOY/envoyComm.c - Trade commands
COMMANDS/START/startComm.c - Trade operations
COMMANDS/START/tradeFunc.c
Envoy operations
- Envoy configuration
CONFIG/envoyConfig.c - Envoy missions
CONFIG/envoyConfig.c
Realm networking
- Network configuration
CONFIG/networkConfig.c - Frame management
SOCKET/frame.c - Received-frame handlers
SOCKET/threadHandler.c
Realm data
- Realm configuration
REALMS - Product stock
REALMS
Other components
- Operator
Connections 17
- Operator → Maester process: starts
README.txt - Maester process → Local configuration: loads configuration
maester.c - Maester process → Product stock: loads stock
maester.c - Maester process → Envoy configuration: creates envoys
maester.c - Maester process → Network configuration: starts network worker
maester.c - Maester process → Envoy configuration: starts envoy worker
maester.c - Maester process → Command detection: runs commands
README.txt - Command detection → Listing commands: routes listing
README.txt - Command detection → Pledge commands: routes pledges
README.txt - Command detection → Envoy commands: routes envoy status
README.txt - Command detection → Trade commands: routes trades
README.txt - Trade commands → Trade operations: delegates trade work
COMMANDS/START/startComm.c - Network configuration → Received-frame handlers: handles network traffic
- Received-frame handlers → Frame management: processes frames
- Envoy configuration → Envoy missions: dispatches missions
CONFIG/envoyConfig.c - Local configuration → Realm configuration: reads realm settings
README.txt - Shared utilities → Maester process: provides shared functions