# subset-ucsd/commit-challenge-2025 architecture

> Architecture diagram of the GitHub repository subset-ucsd/commit-challenge-2025, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/subset-ucsd/commit-challenge-2025
- Repository: https://github.com/subset-ucsd/commit-challenge-2025

## Overview

##### Project type and purpose
- This is a single “Commit-Challenge-2025” monorepo containing a collection of small web-based games, utilities, and bots. It’s not one cohesive full-stack app but rather a set of independent front-end static sites, real-time servers, CI-driven workflows (GitHub Actions), and hosted services (Discord bots, reminder daemons). Its overall purpose is to host “daily commit” mini-projects and automate their builds, tests, and deployments.

##### File structure
- Top-level directories each correspond to a sub-project:
- murder-game (TypeScript Canvas + Node server)
- qrbox (static JS game)
- escape (TypeScript CYOA)
- cave-game (WebGL client + WebSocket server + physics)
- remind (Rust Discord reminder service)
- 🍴💩 (TypeScript Discord bot RPG)
- 👑 (React puzzle)
- plus a bunch of standalone HTML/JS “toy” pages at the root.
- .github/workflows/ defines CI pipelines: compile, lint, test, nightly-release (using Gemini), auto-close (purr), etc.
- Shared configs: tsconfig.json, package.json, Cargo.toml for Rust, various README.md per project.

##### README for additional insights
- The README enumerates each sub-project, its URL, tech stack, and key files.

##### Essential architectural elements
- Don’t try to map every single tiny script—group similar static pages together.
- How code flows from developer commit to live user experience.
- Unique LLM-driven workflows in “actions game” and “release” pipelines.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Monorepo
    subgraph "Monorepo Root" 
        MR["Monorepo Root"]:::ext
    end
    click MR "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/."

    %% CI/CD Pipelines
    subgraph "CI/CD Pipelines" 
        CI1["compile.yml"]:::ci
        CI2["autolint.yml"]:::ci
        CI3["actions_game_test.yml"]:::ci
        CI4["release.yml"]:::ci
        CI5["remind.yml"]:::ci
        CI6["purr.yml"]:::ci
        CI7["send.yml"]:::ci
        CI8["retry.yml"]:::ci
        CI9["fuck.yml"]:::ci
        CI10["fuckelonmusk.yml"]:::ci
    end
    click CI1 "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/.github/workflows/compile.yml"
    click CI2 "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/.github/workflows/autolint.yml"
    click CI3 "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/.github/workflows/actions_game_test.yml"
    click CI4 "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/.github/workflows/release.yml"
    click CI5 "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/.github/workflows/remind.yml"
    click CI6 "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/.github/workflows/purr.yml"
    click CI7 "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/.github/workflows/send.yml"
    click CI8 "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/.github/workflows/retry.yml"
    click CI9 "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/.github/workflows/fuck.yml"
    click CI10 "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/.github/workflows/fuckelonmusk.yml"

    %% Static Sites
    subgraph "Static Sites (GitHub Pages/CDN)" 
        QR["qrbox"]:::static
        ES["escape"]:::static
        CS["cube-spin"]:::static
        FM["fruit-merge"]:::static
        PC["pixel-converter"]:::static
        RT["Root Toys"]:::static
    end
    click QR "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/qrbox/index.html"
    click ES "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/escape/index.html"
    click CS "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/cube-spin/index.html"
    click FM "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/fruit-merge/index.html"
    click PC "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/pixel-converter/index.html"
    click RT "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/index.html"

    %% murder-game
    subgraph "murder-game (TS Canvas + Node)" 
        MGClient["Client"]:::servers
        MGServer["Server"]:::servers
    end
    click MGClient "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/murder-game/client/index.ts"
    click MGServer "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/murder-game/server/index.ts"

    %% cave-game
    subgraph "cave-game (WebGL + WS Server)" 
        CGClient["WebGL Client"]:::servers
        CGServer["WS Server"]:::servers
        Phys["Physics Engine"]:::servers
    end
    click CGClient "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/cave-game/client/index.ts"
    click CGServer "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/cave-game/server/WsServer.ts"
    click Phys "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/cave-game/server/PhysicsWorld.ts"
    click CGDeploy "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/cave-game/deploy_serve.sh"

    %% remind service
    subgraph "remind (Rust Discord Service)" 
        RemindSrv["remind/src/main.rs"]:::servers
    end
    click RemindSrv "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/remind/src/main.rs"

    %% Discord Bot
    subgraph "🍴💩 Bot (Discord.js)" 
        Bot["bot.mts"]:::servers
    end
    click Bot "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/🍴💩/bot.mts"

    %% React Puzzle
    subgraph "👑 React Puzzle" 
        RPClient["Next/React App"]:::servers
    end
    click RPClient "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/👑/src/index.tsx"

    %% actions-game runner
    subgraph "actions-game Runner" 
        AGCode["act.mts"]:::servers
        AGState["state.yml"]:::servers
    end
    click AGCode "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/actions/act.mts"
    click AGState "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/actions/state.yml"

    %% Shared Toys & Utils
    subgraph "Shared Scripts & Tests" 
        AT["a_task"]:::servers
        UT["Tests"]:::servers
    end
    click AT "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/a_task/create_a_file.py"
    click UT "https://github.com/subset-ucsd/commit-challenge-2025/blob/main/test/rotation.test.js"

    %% Deployment Targets
    subgraph "Deployment Targets"
        GHP["GitHub Pages"]:::ext
        CDN["CDN"]:::ext
        VM["SSH/VM Host"]:::ext
        DiscordAPI["Discord API"]:::ext
        Gemini["Gemini LLM"]:::ext
        Browser["Web Browser"]:::ext
        DiscordClient["Discord Client"]:::ext
    end

    %% Relationships
    MR -->|"triggers"| CI1
    MR -->|"triggers"| CI2
    MR -->|"triggers"| CI3
    MR -->|"triggers"| CI4
    MR -->|"triggers"| CI5
    MR -->|"triggers"| CI6
    CI1 -->|"build"| QR
    CI1 -->|"build"| ES
    CI1 -->|"build"| CS
    CI1 -->|"build"| FM
    CI1 -->|"build"| PC
    CI4 -->|"deploy"| GHP
    GHP -->|"hosts"| QR
    GHP -->|"hosts"| ES
    GHP -->|"hosts"| CS
    GHP -->|"hosts"| FM
    GHP -->|"hosts"| PC
    CI4 -->|"deploy"| VM
    VM -->|"runs"| CGServer
    CGServer -->|"serves assets"| GHP
    CGClient -->|"WS handshake"| CGServer
    CGClient -->|"renders"| Phys
    Browser -->|"HTTP(S)"| QR
    Browser -->|"HTTP(S)"| ES
    Browser -->|"HTTP(S)"| CS
    Browser -->|"HTTP(S)"| FM
    Browser -->|"HTTP(S)"| PC
    Browser -->|"HTTP(S)"| MGClient
    MGClient -->|"WebSocket"| MGServer
    MGServer -->|"static assets"| GHP
    RemindSrv -->|"schedule & send"| DiscordAPI
    Bot -->|"responds"| DiscordAPI
    AGCode -->|"calls"| Gemini
    Gemini -->|"returns"| AGState
    CI3 -->|"tests runner"| AGCode
    AGState -->|"commit update"| MR
    DiscordClient -->|"interacts"| Bot
    DiscordClient -->|"interacts"| RemindSrv

    %% Styles
    classDef static fill:#add8e6,stroke:#333,stroke-width:1px
    classDef servers fill:#90ee90,stroke:#333,stroke-width:1px
    classDef ci fill:#ffa500,stroke:#333,stroke-width:1px
    classDef ext fill:#d3d3d3,stroke:#333,stroke-width:1px
```
