This project is a multi-language solver for Advent of Code puzzles, with support for Python and JavaScript.

1. Install Dependencies and Setup Environment:

   pnpm

This single command will install all Node.js dependencies and then automatically create a Python virtual environment (.venv) and install all Python dependencies into it.

To create the directory structure for a new puzzle, use the scaffold.py script:

pnpm scaffold <YEAR> <DAY>

Solutions are run using root-level scripts that automatically validate examples first.

• Python Execution: pnpm run:py <YEAR> <DAY>
• JavaScript Execution: pnpm run:js <YEAR> <DAY>

Workflow: The runner will first execute all example tests (from test_data.json and example_*.txt). ONLY if all tests pass will it then load the input.txt file and print the final solution for Part 1 and Part 2.