# sibvladimir97-ship-it/gta-irl-os architecture

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

- Interactive diagram: https://gitdiagram.com/sibvladimir97-ship-it/gta-irl-os
- Repository: https://github.com/sibvladimir97-ship-it/gta-irl-os

## Overview

GTA IRL OS combines a documented personal daily decision cycle with a working Telegram-based freelance-offer and deal workflow. The README describes the broader life-management stages and manual decision boundary; sampled scripts show concrete offer collection, scoring, deal handling, and local persistence. Some documented personal-system capabilities are represented at their exact directory paths because their runtime implementation was not sampled; edges without direct evidence are omitted.

Main entry points: [`scripts/main.py`](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/main.py) (Integrated runtime), [`scripts/negotiator.py`](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/negotiator.py) (Negotiator), [`core/CYCLE.md`](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/core/CYCLE.md) (Daily cycle), [`scripts/archive/offer_parser.py`](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/archive/offer_parser.py) (Offer parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_personal["Personal operating system"]
  node_cycle["Daily cycle<br/>[CYCLE.md]"]
  node_survival["Survival economy"]
  node_other_modules["Life modules"]
  node_collapse["Context collapse"]
  node_daily_runner["Daily cycle runner<br/>[daily_cycle.py]"]
end

subgraph group_offers["Offer discovery"]
  node_offer_parser["Offer parser<br/>[offer_parser.py]"]
  node_offer_scoring["Offer scoring<br/>[offer_scoring.py]"]
  node_offer_store[("Offer store<br/>[offer_store.py]")]
  node_priority["Priority engine<br/>[priority_engine.py]"]
end

subgraph group_deals["Deal management"]
  node_negotiator["Negotiator<br/>[negotiator.py]"]
  node_pipeline["Deal pipeline<br/>[deal_pipeline.py]"]
  node_inbox["Deal inbox listener<br/>[inbox_listener.py]"]
  node_deal_data[("Deal records")]
end

subgraph group_runtime["Runtime and operations"]
  node_main["Integrated runtime<br/>[main.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
  node_bot["Assistant bot<br/>[bot.py]"]
  node_ai["AI service<br/>[ai_service.py]"]
  node_risk["Telegram risk tracking<br/>[telegram_risk.py]"]
end

node_person(("Owner"))
node_telegram(("Telegram"))

node_person -->|"runs"| node_cycle
node_cycle -->|"updates"| node_survival
node_cycle -->|"updates"| node_other_modules
node_cycle -->|"compresses into"| node_collapse
node_collapse -->|"supports decision"| node_person
node_person -.->|"runs"| node_daily_runner
node_telegram -.->|"sends updates"| node_main
node_main -->|"loads settings"| node_config
node_main -->|"calls"| node_ai
node_main -->|"records events"| node_risk
node_main -->|"reads and updates"| node_offer_store
node_main -->|"uses"| node_negotiator
node_main -->|"uses"| node_pipeline
node_offer_parser -->|"creates offers"| node_offer_store
node_offer_parser -->|"scores offers"| node_offer_scoring
node_offer_parser -->|"sends cards"| node_telegram
node_priority -->|"reads offer files"| node_offer_store
node_priority -->|"sends summary"| node_telegram
node_negotiator -->|"updates stages"| node_pipeline
node_negotiator -->|"reads and writes"| node_deal_data
node_inbox -->|"uses deal functions"| node_negotiator
node_inbox -->|"loads active deals"| node_deal_data
node_bot -->|"uses deal functions"| node_negotiator
node_bot -->|"handles messages"| node_telegram

click node_cycle "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/core/CYCLE.md"
click node_survival "https://github.com/sibvladimir97-ship-it/gta-irl-os/tree/main/modules/survival-economy"
click node_other_modules "https://github.com/sibvladimir97-ship-it/gta-irl-os/tree/main/modules"
click node_collapse "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/data/schemas/context-collapse.schema.json"
click node_daily_runner "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/daily_cycle.py"
click node_main "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/main.py"
click node_config "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/config.py"
click node_offer_parser "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/archive/offer_parser.py"
click node_offer_scoring "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/offer_scoring.py"
click node_offer_store "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/offer_store.py"
click node_priority "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/priority_engine.py"
click node_negotiator "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/negotiator.py"
click node_pipeline "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/deal_pipeline.py"
click node_inbox "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/archive/inbox_listener.py"
click node_bot "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/archive/bot.py"
click node_ai "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/ai_service.py"
click node_risk "https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/telegram_risk.py"
click node_deal_data "https://github.com/sibvladimir97-ship-it/gta-irl-os/tree/main/data/deals"

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_cycle,node_survival,node_other_modules,node_collapse,node_daily_runner toneBlue
class node_offer_parser,node_offer_scoring,node_offer_store,node_priority toneAmber
class node_negotiator,node_pipeline,node_inbox,node_deal_data toneMint
class node_main,node_config,node_bot,node_ai,node_risk toneRose
class node_person,node_telegram toneIndigo
```

## Components

### Personal operating system

- [Daily cycle](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/core/CYCLE.md): `core/CYCLE.md`
- [Survival economy](https://github.com/sibvladimir97-ship-it/gta-irl-os/tree/main/modules/survival-economy): `modules/survival-economy`
- [Life modules](https://github.com/sibvladimir97-ship-it/gta-irl-os/tree/main/modules): `modules`
- [Context collapse](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/data/schemas/context-collapse.schema.json): `data/schemas/context-collapse.schema.json`
- [Daily cycle runner](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/daily_cycle.py): `scripts/daily_cycle.py`

### Offer discovery

- [Offer parser](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/archive/offer_parser.py): `scripts/archive/offer_parser.py`
- [Offer scoring](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/offer_scoring.py): `scripts/offer_scoring.py`
- [Offer store](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/offer_store.py): `scripts/offer_store.py`
- [Priority engine](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/priority_engine.py): `scripts/priority_engine.py`

### Deal management

- [Negotiator](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/negotiator.py): `scripts/negotiator.py`
- [Deal pipeline](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/deal_pipeline.py): `scripts/deal_pipeline.py`
- [Deal inbox listener](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/archive/inbox_listener.py): `scripts/archive/inbox_listener.py`
- [Deal records](https://github.com/sibvladimir97-ship-it/gta-irl-os/tree/main/data/deals): `data/deals`

### Runtime and operations

- [Integrated runtime](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/main.py): `scripts/main.py`
- [Runtime configuration](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/config.py): `scripts/config.py`
- [Assistant bot](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/archive/bot.py): `scripts/archive/bot.py`
- [AI service](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/ai_service.py): `scripts/ai_service.py`
- [Telegram risk tracking](https://github.com/sibvladimir97-ship-it/gta-irl-os/blob/main/scripts/telegram_risk.py): `scripts/telegram_risk.py`

### Other components

- **Owner**
- **Telegram**

## Connections

- Owner → Daily cycle: runs (evidence: `README.md`)
- Daily cycle → Survival economy: updates (evidence: `README.md`)
- Daily cycle → Life modules: updates (evidence: `README.md`)
- Daily cycle → Context collapse: compresses into (evidence: `README.md`)
- Context collapse → Owner: supports decision (evidence: `README.md`)
- Owner → Daily cycle runner: runs
- Telegram → Integrated runtime: sends updates
- Integrated runtime → Runtime configuration: loads settings (evidence: `scripts/main.py`)
- Integrated runtime → AI service: calls (evidence: `scripts/main.py`)
- Integrated runtime → Telegram risk tracking: records events (evidence: `scripts/main.py`)
- Integrated runtime → Offer store: reads and updates (evidence: `scripts/main.py`)
- Integrated runtime → Negotiator: uses (evidence: `scripts/main.py`)
- Integrated runtime → Deal pipeline: uses (evidence: `scripts/main.py`)
- Offer parser → Offer store: creates offers (evidence: `scripts/archive/offer_parser.py`)
- Offer parser → Offer scoring: scores offers (evidence: `scripts/archive/offer_parser.py`)
- Offer parser → Telegram: sends cards (evidence: `scripts/archive/offer_parser.py`)
- Priority engine → Offer store: reads offer files (evidence: `scripts/priority_engine.py`)
- Priority engine → Telegram: sends summary (evidence: `scripts/priority_engine.py`)
- Negotiator → Deal pipeline: updates stages (evidence: `scripts/negotiator.py`)
- Negotiator → Deal records: reads and writes (evidence: `scripts/negotiator.py`)
- Deal inbox listener → Negotiator: uses deal functions (evidence: `scripts/archive/inbox_listener.py`)
- Deal inbox listener → Deal records: loads active deals (evidence: `scripts/archive/inbox_listener.py`)
- Assistant bot → Negotiator: uses deal functions (evidence: `scripts/archive/bot.py`)
- Assistant bot → Telegram: handles messages (evidence: `scripts/archive/bot.py`)
