Architektura

Model → Message → Update → View

src/
  main.rs              # Entry point, fork, terminal setup, podkomendy CLI
  app/                 # Główna pętla zdarzeń, struktura App, dispatch zdarzeń
  constants.rs         # APP_NAME i stałe globalne
  config/              # Ładowanie i walidacja konfiguracji TOML
  state/               # Stan aplikacji (bufory, połączenia, sortowanie, typing, act)
  session/             # Infrastruktura odłączania/podłączania
    mod.rs             # Ścieżki gniazd, listowanie sesji, żywotność PID
    protocol.rs        # Typy wiadomości Shim ↔ backend (ramkowanie bincode)
    shim.rs            # Shim terminala (pętla przekaźnikowa, splash, wejście)
    writer.rs          # SocketWriter (impl Write dla wyjścia gniazda)
  irc/                 # Połączenie IRC, obsługa zdarzeń, formatowanie
    events.rs          # Wiadomość IRC → aktualizacja stanu
    mod.rs             # Konfiguracja połączenia, negocjacja CAP, SASL, sonda bouncera
    cap.rs             # Framework IRCv3 CAP (ponad 30 możliwości)
    isupport.rs        # Parsowanie ISUPPORT + draft/extended-isupport
    batch.rs           # IRCv3 BATCH (netsplit/netjoin, chathistory, multiline, search)
    sasl.rs            # SASL PLAIN, EXTERNAL, SCRAM-SHA-1/256/512, ECDSA, OAUTHBEARER
    extban.rs          # Rozszerzone typy banów ($a:account itp.)
    flood.rs           # Ochrona przed floodem i limitowanie CTCP
    netsplit.rs        # Wykrywanie netsplitów
    ignore.rs          # Dopasowywanie listy ignorowanych
    formatting.rs      # Pomocniki formatowania IRC
    whox.rs            # Śledzenie WHOX (rozszerzone WHO)
  dcc/                 # Protokół DCC CHAT (aktywny i pasywny)
  e2e/                 # Szyfrowanie end-to-end RPE2E v1 (Ed25519, X25519, XChaCha20-Poly1305)
  translate/           # Tłumaczenie wiadomości w locie (Lingva, Google, MyMemory, LibreTranslate)
  shrink/              # Automatyczne skracanie URL (is.gd)
  emote/               # Słownik i rozwijanie emotek tekstowych
  image_preview/       # Podgląd obrazów w czacie i popupach (Kitty, iTerm2, Sixel, halfblocks)
  shell/               # Wbudowane sesje terminala PTY (parser ekranu vt100)
  spellcheck/          # Wielojęzyczne sprawdzanie pisowni Hunspell
  web/                 # Wbudowany serwer HTTPS/WebSocket, WebPush (RFC 8291), paczka WASM
  ui/                  # Renderowanie TUI
    layout.rs          # Układ ekranu + regiony
    tree_list.rs       # Drzewiasty i płaski pasek boczny buforów
    nick_list.rs       # Prawy pasek boczny
    chat_view.rs       # Wyświetlanie wiadomości + miniatury obrazów w czacie
    bare_view.rs       # Tryb bare (czysty widok do zaznaczania tekstu)
    shell_view.rs      # Widok wbudowanego terminala PTY
    settings_modal.rs  # Interaktywny modal /wizard i /config
    window_overlay.rs  # Przeszukiwalny popup /window list
    input.rs           # Wejście poleceń + autouzupełnianie Tab + ochrona wklejania
    status_line.rs     # Dolny pasek statusu (+typing, [E2E], [TR], [LAG], Act)
    topic_bar.rs       # Górny pasek tematu
    message_line.rs    # Renderowanie pojedynczej wiadomości
    styled_text.rs     # Ciągi formatujące → spany ratatui
  theme/               # Ładowanie motywów + parser ciągów formatujących irssi
  scripting/           # Silnik skryptowy Lua
    engine.rs          # Trait ScriptEngine + ScriptManager
    api.rs             # Nazwy zdarzeń i wiązania API Lua
    event_bus.rs       # Dispatch zdarzeń według priorytetu
    lua/               # Backend Lua 5.4 (mlua 0.12.2)
  storage/             # Logowanie SQLite + tabele pęku kluczy E2E
    db.rs              # Schemat bazy danych + migracje
    writer.rs          # Wsadowy zapis asynchroniczny
    query.rs           # Zapytania wyszukiwania i odczytu
    crypto.rs          # Szyfrowanie AES-256-GCM
    types.rs           # LogRow, StoredMessage
  commands/            # System poleceń
    parser.rs          # Parsowanie argumentów /poleceń
    registry.rs        # Rejestracja poleceń (ponad 80 wbudowanych poleceń)
    handlers_irc.rs    # Polecenia IRC i IRCv3 (/join, /chathistory, /bouncer, /redact itp.)
    handlers_ui.rs     # Polecenia UI (/clear, /close, /wizard, /bare, /shell itp.)
    handlers_admin.rs  # Polecenia admina (/set, /reload, /e2e, /translate, /script itp.)
    handlers_dcc.rs    # Polecenia DCC (/dcc chat, /dcc close itp.)
    docs.rs            # Dwujęzyczny loader dokumentacji poleceń (EN + PL)

repartee
  ├── Backend (child)     # headless daemon — IRC, state, socket listener
  │     └── Unix socket   # ~/.repartee/sessions/{pid}.sock
  └── Shim (parent)       # terminal bridge — renders UI, forwards input

ScriptManager
  └── Vec<Box<dyn ScriptEngine>>
        └── LuaEngine (mlua)
              ├── Per-script Lua environments (sandboxed)
              ├── Event handlers (priority-sorted, per-event)
              └── Command handlers

AppState::add_message()
  → log_tx (tokio mpsc sender)
  → WriterTask (batches 50 rows / 1 second)
  → SQLite (WAL mode, FTS5 index)