How scadoshi/rustmas works
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: mod.rs Solve workflow · aoc_client.rs Advent client · input.rs Entry acquisition · cli.rs CLI commands
Components 17
Command entry
- CLI commands
src/lib/inbound/cli.rs
Puzzle workflows
- Fetch workflow
src/lib/inbound/fetch - Solve workflow
src/lib/inbound/solve/mod.rs - Entry acquisition
src/lib/inbound/input.rs
Puzzle domain
- Day and filters
src/lib/domain/address/day.rs - Day solutions
src/lib/domain/solution/year_template/day_01/mod.rs - Answers and outcomes
src/lib/domain/solution/outcome.rs - Verdict types
src/lib/domain/solution/solver_verdict.rs - Run totals
src/lib/domain/solution/totals.rs
External adapters
- Disk cache
src/lib/outbound/store/mod.rs - Advent client
src/lib/outbound/client/aoc_client.rs - Solver client
src/lib/outbound/client/solver_client.rs - Environment config
src/lib/outbound/client/environment.rs - Session cookie
src/lib/outbound/client/session_cookie.rs
Other components
- Engineer
- Advent of Code
- Independent solver
Connections 19
- Engineer → CLI commands: runs
README.md - CLI commands → Fetch workflow: routes fetch
README.md - CLI commands → Solve workflow: routes solve
README.md - Fetch workflow → Disk cache: stores inputs
README.md - Solve workflow → Day and filters: filters days
src/lib/inbound/solve/mod.rs - Solve workflow → Entry acquisition: ensures entry
src/lib/inbound/solve/mod.rs - Entry acquisition → Disk cache: reads and writes
src/lib/inbound/input.rs - Entry acquisition → Advent client: fetches missing data
src/lib/inbound/input.rs - Entry acquisition → Environment config: checks session
src/lib/inbound/input.rs - Solve workflow → Solver client: validates answers
src/lib/inbound/solve/mod.rs - Solve workflow → Advent client: submits answers
src/lib/inbound/solve/mod.rs - Solve workflow → Run totals: aggregates timings
src/lib/inbound/solve/mod.rs - Solve workflow → Day solutions: dispatches solutions
- Solver client → Independent solver: checks answers
src/lib/outbound/client/solver_client.rs - Advent client → Advent of Code: fetches and submits
src/lib/outbound/client/aoc_client.rs - Advent client → Environment config: loads settings
- Advent client → Session cookie: authenticates with
src/lib/outbound/client/aoc_client.rs - Solve workflow → Answers and outcomes: reports outcomes
- Answers and outcomes → Verdict types: records checks
src/lib/domain/solution/outcome.rs