Architecture

Model → Message → Update → View

src/
  main.rs              # Entry point, fork, terminal setup, CLI subcommands
  app/                 # Main event loop, App struct, event dispatch
  constants.rs         # APP_NAME and global constants
  config/              # TOML config loading & validation
  state/               # Application state (buffers, connections, sorting, typing, act)
  session/             # Detach/reattach infrastructure
    mod.rs             # Socket paths, session listing, PID liveness
    protocol.rs        # Shim ↔ backend message types (bincode framing)
    shim.rs            # Terminal shim (relay loop, splash, input)
    writer.rs          # SocketWriter (impl Write for socket output)
  irc/                 # IRC connection, event handling, formatting
    events.rs          # IRC message → state update
    mod.rs             # Connection setup, CAP negotiation, SASL, bouncer probe
    cap.rs             # IRCv3 CAP framework (30+ capabilities)
    isupport.rs        # ISUPPORT + draft/extended-isupport parsing
    batch.rs           # IRCv3 BATCH (netsplit/netjoin, chathistory, multiline, search)
    sasl.rs            # SASL PLAIN, EXTERNAL, SCRAM-SHA-1/256/512, ECDSA, OAUTHBEARER
    extban.rs          # Extended ban types ($a:account, etc.)
    flood.rs           # Flood protection & CTCP rate limiting
    netsplit.rs        # Netsplit detection
    ignore.rs          # Ignore list matching
    formatting.rs      # IRC formatting helpers
    whox.rs            # WHOX (extended WHO) tracking
  dcc/                 # DCC CHAT protocol (active & passive)
  e2e/                 # RPE2E v1 end-to-end encryption (Ed25519, X25519, XChaCha20-Poly1305)
  translate/           # Inline message translation (Lingva, Google, MyMemory, LibreTranslate)
  shrink/              # Automatic URL shrinking (is.gd)
  emote/               # Text emote dictionary & expansion
  image_preview/       # Inline & popup image rendering (Kitty, iTerm2, Sixel, halfblocks)
  shell/               # Embedded PTY terminal sessions (vt100 screen parser)
  spellcheck/          # Multi-language Hunspell spellchecker
  web/                 # Embedded HTTPS/WebSocket server, WebPush (RFC 8291), WASM bundle
  ui/                  # TUI rendering
    layout.rs          # Screen layout + regions
    tree_list.rs       # Tree & flat buffer sidebar
    nick_list.rs       # Right sidebar
    chat_view.rs       # Message display + inline image thumbnails
    bare_view.rs       # Bare mode (stripped chrome for clean text selection)
    shell_view.rs      # Embedded terminal PTY view
    settings_modal.rs  # Interactive /wizard & /config modal
    window_overlay.rs  # Searchable /window list popup overlay
    input.rs           # Command input + tab completion + multiline paste guard
    status_line.rs     # Bottom status bar (+typing, [E2E], [TR], [LAG], Act)
    topic_bar.rs       # Top topic display
    message_line.rs    # Single message rendering
    styled_text.rs     # Format string → ratatui spans
  theme/               # Theme loading + irssi-compatible format string parser
  scripting/           # Lua scripting engine
    engine.rs          # ScriptEngine trait + ScriptManager
    api.rs             # Event names & Lua API bindings
    event_bus.rs       # Priority-ordered event dispatch
    lua/               # Lua 5.4 backend (mlua 0.12.2)
  storage/             # SQLite logging + E2E keyring tables
    db.rs              # Database schema + migrations
    writer.rs          # Batched async writer
    query.rs           # Search + read queries
    crypto.rs          # AES-256-GCM encryption
    types.rs           # LogRow, StoredMessage
  commands/            # Command system
    parser.rs          # /command arg parsing
    registry.rs        # Command registration (80+ built-in commands)
    handlers_irc.rs    # IRC & IRCv3 commands (/join, /chathistory, /bouncer, /redact, etc.)
    handlers_ui.rs     # UI commands (/clear, /close, /wizard, /bare, /shell, etc.)
    handlers_admin.rs  # Admin commands (/set, /reload, /e2e, /translate, /script, etc.)
    handlers_dcc.rs    # DCC commands (/dcc chat, /dcc close, etc.)
    docs.rs            # Bilingual command documentation loader (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)