Welcome to cj81499’s Advent of Code solutions — a well-structured Python monorepo covering puzzle solutions from 2015 all the way through 2025. Every solution is tested against the official example inputs, fully type-checked with mypy, and linted with Ruff. A sharedDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/cj81499/advent-of-code/llms.txt
Use this file to discover all available pages before exploring further.
aoc_cj.util library provides reusable grid helpers, input parsers, and data structures that appear across many years.
Introduction
Learn what this repository contains and how it is organized.
Quickstart
Clone the repo, install dependencies, and run your first solution in minutes.
Utility Library
Explore the shared helpers for grids, parsing, and data structures.
Solutions by Year
Browse solved puzzles year by year from 2015 to 2025.
What’s Inside
11 Years of Solutions
From AoC 2015 through 2025 — over 250 daily puzzle solutions across 11 event years.
Shared Utility Library
aoc_cj.util exports grid adjacency helpers, numeric parsers, Point3D, and a generic PriorityQueue.Full Test Coverage
Every solved puzzle has a pytest test verified against the official example inputs from the problem statement.
Strict Type Checking
All source files pass mypy in strict mode — no untyped functions, no implicit
Any.Modern Tooling
Uses
uv for fast dependency management and pre-commit hooks enforcing Ruff format and lint on every commit.CI / CD
GitHub Actions runs tests on Python 3.13 and 3.14, uploads coverage to Codecov, and runs zizmor security analysis.
Quick Navigation
Development Setup
Install uv, sync dependencies, and configure your AOC session token.
Running Tests
Run the full test suite or target a specific year with pytest.
Solution Structure
Understand the
src/aoc_cj/ layout and the per-day module convention.Tooling & CI
Learn about Ruff, mypy, pre-commit hooks, and the GitHub Actions workflow.