# scadoshi/rustmas architecture

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

- Interactive diagram: https://gitdiagram.com/scadoshi/rustmas
- Repository: https://github.com/scadoshi/rustmas

## Overview

rustmas is a command-line Advent of Code toolkit. Its main workflow is to fetch and cache puzzle inputs, run a registered day solution offline, optionally compare answers with an independent solver, and submit only validated answers for stars. The graph preserves the distinct fetch, solve, validation, submission, and run-summary stages, plus the domain types and filesystem cache supporting them. Some fetch and client wiring is documented in the README but was not sampled directly; those relationships are cited to the README rather than treated as inspected implementation.

Main entry points: [`src/lib/inbound/solve/mod.rs`](https://github.com/scadoshi/rustmas/blob/main/src/lib/inbound/solve/mod.rs) (Solve workflow), [`src/lib/outbound/client/aoc_client.rs`](https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/client/aoc_client.rs) (Advent client), [`src/lib/inbound/input.rs`](https://github.com/scadoshi/rustmas/blob/main/src/lib/inbound/input.rs) (Entry acquisition), [`src/lib/inbound/cli.rs`](https://github.com/scadoshi/rustmas/blob/main/src/lib/inbound/cli.rs) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Command entry"]
  node_cli["CLI commands<br/>[cli.rs]"]
end

subgraph group_workflow["Puzzle workflows"]
  node_fetch["Fetch workflow"]
  node_solve["Solve workflow<br/>[mod.rs]"]
  node_input["Entry acquisition<br/>[input.rs]"]
end

subgraph group_domain["Puzzle domain"]
  node_address["Day and filters<br/>[day.rs]"]
  node_day_solution["Day solutions<br/>[mod.rs]"]
  node_answers["Answers and outcomes<br/>[outcome.rs]"]
  node_verdicts["Verdict types<br/>[solver_verdict.rs]"]
  node_totals["Run totals<br/>[totals.rs]"]
end

subgraph group_adapters["External adapters"]
  node_cache[("Disk cache<br/>[mod.rs]")]
  node_aoc_client["Advent client<br/>[aoc_client.rs]"]
  node_solver_client["Solver client<br/>[solver_client.rs]"]
  node_environment["Environment config<br/>[environment.rs]"]
  node_cookie["Session cookie<br/>[session_cookie.rs]"]
end

node_user(("Engineer"))
node_aoc(("Advent of Code"))
node_independent_solver(("Independent solver"))

node_user -->|"runs"| node_cli
node_cli -->|"routes fetch"| node_fetch
node_cli -->|"routes solve"| node_solve
node_fetch -->|"stores inputs"| node_cache
node_solve -->|"filters days"| node_address
node_solve -->|"ensures entry"| node_input
node_input -->|"reads and writes"| node_cache
node_input -->|"fetches missing data"| node_aoc_client
node_input -->|"checks session"| node_environment
node_solve -->|"validates answers"| node_solver_client
node_solve -->|"submits answers"| node_aoc_client
node_solve -->|"aggregates timings"| node_totals
node_solve -.->|"dispatches solutions"| node_day_solution
node_solver_client -->|"checks answers"| node_independent_solver
node_aoc_client -->|"fetches and submits"| node_aoc
node_aoc_client -.->|"loads settings"| node_environment
node_aoc_client -->|"authenticates with"| node_cookie
node_solve -.->|"reports outcomes"| node_answers
node_answers -->|"records checks"| node_verdicts

click node_cli "https://github.com/scadoshi/rustmas/blob/main/src/lib/inbound/cli.rs"
click node_fetch "https://github.com/scadoshi/rustmas/tree/main/src/lib/inbound/fetch"
click node_solve "https://github.com/scadoshi/rustmas/blob/main/src/lib/inbound/solve/mod.rs"
click node_input "https://github.com/scadoshi/rustmas/blob/main/src/lib/inbound/input.rs"
click node_cache "https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/store/mod.rs"
click node_address "https://github.com/scadoshi/rustmas/blob/main/src/lib/domain/address/day.rs"
click node_day_solution "https://github.com/scadoshi/rustmas/blob/main/src/lib/domain/solution/year_template/day_01/mod.rs"
click node_answers "https://github.com/scadoshi/rustmas/blob/main/src/lib/domain/solution/outcome.rs"
click node_verdicts "https://github.com/scadoshi/rustmas/blob/main/src/lib/domain/solution/solver_verdict.rs"
click node_totals "https://github.com/scadoshi/rustmas/blob/main/src/lib/domain/solution/totals.rs"
click node_aoc_client "https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/client/aoc_client.rs"
click node_solver_client "https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/client/solver_client.rs"
click node_environment "https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/client/environment.rs"
click node_cookie "https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/client/session_cookie.rs"

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_cli toneBlue
class node_fetch,node_solve,node_input toneAmber
class node_address,node_day_solution,node_answers,node_verdicts,node_totals toneMint
class node_cache,node_aoc_client,node_solver_client,node_environment,node_cookie toneRose
class node_user,node_aoc,node_independent_solver toneIndigo
```

## Components

### Command entry

- [CLI commands](https://github.com/scadoshi/rustmas/blob/main/src/lib/inbound/cli.rs): `src/lib/inbound/cli.rs`

### Puzzle workflows

- [Fetch workflow](https://github.com/scadoshi/rustmas/tree/main/src/lib/inbound/fetch): `src/lib/inbound/fetch`
- [Solve workflow](https://github.com/scadoshi/rustmas/blob/main/src/lib/inbound/solve/mod.rs): `src/lib/inbound/solve/mod.rs`
- [Entry acquisition](https://github.com/scadoshi/rustmas/blob/main/src/lib/inbound/input.rs): `src/lib/inbound/input.rs`

### Puzzle domain

- [Day and filters](https://github.com/scadoshi/rustmas/blob/main/src/lib/domain/address/day.rs): `src/lib/domain/address/day.rs`
- [Day solutions](https://github.com/scadoshi/rustmas/blob/main/src/lib/domain/solution/year_template/day_01/mod.rs): `src/lib/domain/solution/year_template/day_01/mod.rs`
- [Answers and outcomes](https://github.com/scadoshi/rustmas/blob/main/src/lib/domain/solution/outcome.rs): `src/lib/domain/solution/outcome.rs`
- [Verdict types](https://github.com/scadoshi/rustmas/blob/main/src/lib/domain/solution/solver_verdict.rs): `src/lib/domain/solution/solver_verdict.rs`
- [Run totals](https://github.com/scadoshi/rustmas/blob/main/src/lib/domain/solution/totals.rs): `src/lib/domain/solution/totals.rs`

### External adapters

- [Disk cache](https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/store/mod.rs): `src/lib/outbound/store/mod.rs`
- [Advent client](https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/client/aoc_client.rs): `src/lib/outbound/client/aoc_client.rs`
- [Solver client](https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/client/solver_client.rs): `src/lib/outbound/client/solver_client.rs`
- [Environment config](https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/client/environment.rs): `src/lib/outbound/client/environment.rs`
- [Session cookie](https://github.com/scadoshi/rustmas/blob/main/src/lib/outbound/client/session_cookie.rs): `src/lib/outbound/client/session_cookie.rs`

### Other components

- **Engineer**
- **Advent of Code**
- **Independent solver**

## Connections

- Engineer → CLI commands: runs (evidence: `README.md`)
- CLI commands → Fetch workflow: routes fetch (evidence: `README.md`)
- CLI commands → Solve workflow: routes solve (evidence: `README.md`)
- Fetch workflow → Disk cache: stores inputs (evidence: `README.md`)
- Solve workflow → Day and filters: filters days (evidence: `src/lib/inbound/solve/mod.rs`)
- Solve workflow → Entry acquisition: ensures entry (evidence: `src/lib/inbound/solve/mod.rs`)
- Entry acquisition → Disk cache: reads and writes (evidence: `src/lib/inbound/input.rs`)
- Entry acquisition → Advent client: fetches missing data (evidence: `src/lib/inbound/input.rs`)
- Entry acquisition → Environment config: checks session (evidence: `src/lib/inbound/input.rs`)
- Solve workflow → Solver client: validates answers (evidence: `src/lib/inbound/solve/mod.rs`)
- Solve workflow → Advent client: submits answers (evidence: `src/lib/inbound/solve/mod.rs`)
- Solve workflow → Run totals: aggregates timings (evidence: `src/lib/inbound/solve/mod.rs`)
- Solve workflow → Day solutions: dispatches solutions
- Solver client → Independent solver: checks answers (evidence: `src/lib/outbound/client/solver_client.rs`)
- Advent client → Advent of Code: fetches and submits (evidence: `src/lib/outbound/client/aoc_client.rs`)
- Advent client → Environment config: loads settings
- Advent client → Session cookie: authenticates with (evidence: `src/lib/outbound/client/aoc_client.rs`)
- Solve workflow → Answers and outcomes: reports outcomes
- Answers and outcomes → Verdict types: records checks (evidence: `src/lib/domain/solution/outcome.rs`)
