Advent of Code 2024 - Day 1

.editorconfig

@@ -0,0 +1,18 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[.ruby-version]
+insert_final_newline = false
+
+[*.txt]
+insert_final_newline = false

.overcommit.yml

@@ -0,0 +1,26 @@
+# Use this file to configure the Overcommit hooks you wish to use. This will
+# extend the default configuration defined in:
+# https://github.com/sds/overcommit/blob/master/config/default.yml
+#
+# At the topmost level of this YAML file is a key representing type of hook
+# being run (e.g. pre-commit, commit-msg, etc.). Within each type you can
+# customize each hook, such as whether to only run it on certain files (via
+# `include`), whether to only display output if it fails (via `quiet`), etc.
+#
+# For a complete list of hooks, see:
+# https://github.com/sds/overcommit/tree/master/lib/overcommit/hook
+#
+# For a complete list of options that you can use to customize hooks, see:
+# https://github.com/sds/overcommit#configuration
+#
+# Uncomment the following lines to make the configuration take effect.
+
+PreCommit:
+  RuboCop:
+    enabled: true
+    on_warn: fail # Treat all warnings as failures
+    problem_on_unmodified_line: ignore # run RuboCop only on modified code
+    command: ["bundle", "exec", "rubocop", "-a"] # Invoke within Bundler context and autocorrect offenses
+
+  TrailingWhitespace:
+    enabled: true

Gemfile

@@ -25,4 +25,7 @@ group :development do
 
   # Steep
   gem "steep"
+
+  # Overcommit
+  gem "overcommit"
 end

Gemfile.lock

@@ -18,6 +18,8 @@ GEM
     base64 (0.2.0)
     benchmark (0.4.0)
     bigdecimal (3.1.8)
+    childprocess (5.1.0)
+      logger (~> 1.5)
     concurrent-ruby (1.3.4)
     connection_pool (2.4.1)
     csv (3.3.0)
@@ -28,13 +30,18 @@ GEM
     fileutils (1.7.3)
     i18n (1.14.6)
       concurrent-ruby (~> 1.0)
+    iniparse (1.5.0)
     json (2.9.0)
     language_server-protocol (3.17.0.3)
     listen (3.9.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.6.3)
     minitest (5.25.4)
+    overcommit (0.64.1)
+      childprocess (>= 0.6.3, < 6)
+      iniparse (~> 1.4)
+      rexml (>= 3.3.9)
     parallel (1.26.3)
     parser (3.3.6.0)
       ast (~> 2.4.1)
@@ -106,12 +113,12 @@ GEM
     uri (1.0.2)
 
 PLATFORMS
-  arm64-darwin-23
   arm64-darwin-24
   x86_64-linux
 
 DEPENDENCIES
   minitest (~> 5.0)
+  overcommit
   rake (~> 13.0)
   rbs (~> 3.0)
   rubocop

README.md

@@ -24,69 +24,85 @@ SKIP_SLOW_TESTS=1 bundle exec rake test
 <a href="https://www.ruby-lang.org"><img src="https://s3.cdalvaro.io/github.com/cdalvaro/advent-of-code/Holly.png" width="230px" align="right"/></a>
 
 <details open>
+  <summary><b>Advent of Code - <a href="https://adventofcode.com/2024">2024</a></b></summary>
+  <p>
+  <table>
+    <tr>
+      <th>Day</th>
+      <th>Solution</th>
+      <th>Rank</th>
+    </tr>
+    <tr>
+      <td>1️⃣ <a href="https://adventofcode.com/2024/day/1">Historian Hysteria</a></td>
+      <td><a href="lib/puzzles/2024/day01"><code>lib/puzzles/2024/day01</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+  </table>
+</details>
+
+<details>
   <summary><b>Advent of Code - <a href="https://adventofcode.com/2023">2023</a></b></summary>
   <p>
-    <table>
-      <tr>
-        <th>Day</th>
-        <th>Solution</th>
-        <th>Rank</th>
-      </tr>
-      <tr>
-        <td>1️⃣ <a href="https://adventofcode.com/2023/day/1">Trebuchet?!</a></td>
-        <td><a href="lib/puzzles/2023/day01"><code>lib/puzzles/2023/day01</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-      <tr>
-        <td>2️⃣ <a href="https://adventofcode.com/2023/day/2">Cube Conundrum</a></td>
-        <td><a href="lib/puzzles/2023/day02"><code>lib/puzzles/2023/day02</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-      <tr>
-        <td>3️⃣ <a href="https://adventofcode.com/2023/day/3">Gear Ratios</a></td>
-        <td><a href="lib/puzzles/2023/day03"><code>lib/puzzles/2023/day03</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-      <tr>
-        <td>4️⃣ <a href="https://adventofcode.com/2023/day/4">Scratchcards</a></td>
-        <td><a href="lib/puzzles/2023/day04"><code>lib/puzzles/2023/day04</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-      <tr>
-        <td>5️⃣ <a href="https://adventofcode.com/2023/day/5">If You Give A Seed A Fertilizer</a></td>
-        <td><a href="lib/puzzles/2023/day05"><code>lib/puzzles/2023/day05</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-      <tr>
-        <td>6️⃣ <a href="https://adventofcode.com/2023/day/6">Wait For It</a></td>
-        <td><a href="lib/puzzles/2023/day06"><code>lib/puzzles/2023/day06</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-      <tr>
-        <td>7️⃣ <a href="https://adventofcode.com/2023/day/7">Camel Cards</a></td>
-        <td><a href="lib/puzzles/2023/day07"><code>lib/puzzles/2023/day07</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-      <tr>
-        <td>8️⃣ <a href="https://adventofcode.com/2023/day/8">Haunted Wasteland</a></td>
-        <td><a href="lib/puzzles/2023/day08"><code>lib/puzzles/2023/day08</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-      <tr>
-        <td>9️⃣ <a href="https://adventofcode.com/2023/day/9">Mirage Maintenance</a></td>
-        <td><a href="lib/puzzles/2023/day09"><code>lib/puzzles/2023/day09</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-      <tr>
-        <td>1️⃣0️⃣ <a href="https://adventofcode.com/2023/day/10">The Great Escape</a></td>
-        <td><a href="lib/puzzles/2023/day10"><code>lib/puzzles/2023/day10</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-      <tr>
-        <td>1️⃣1️⃣ <a href="https://adventofcode.com/2023/day/11">Cosmic Expansion</a></td>
-        <td><a href="lib/puzzles/2023/day11"><code>lib/puzzles/2023/day11</code></a></td>
-        <td>🌟🌟</td>
-      </tr>
-    </table>
-  </p>
+  <table>
+    <tr>
+      <th>Day</th>
+      <th>Solution</th>
+      <th>Rank</th>
+    </tr>
+    <tr>
+      <td>1️⃣ <a href="https://adventofcode.com/2023/day/1">Trebuchet?!</a></td>
+      <td><a href="lib/puzzles/2023/day01"><code>lib/puzzles/2023/day01</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+    <tr>
+      <td>2️⃣ <a href="https://adventofcode.com/2023/day/2">Cube Conundrum</a></td>
+      <td><a href="lib/puzzles/2023/day02"><code>lib/puzzles/2023/day02</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+    <tr>
+      <td>3️⃣ <a href="https://adventofcode.com/2023/day/3">Gear Ratios</a></td>
+      <td><a href="lib/puzzles/2023/day03"><code>lib/puzzles/2023/day03</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+    <tr>
+      <td>4️⃣ <a href="https://adventofcode.com/2023/day/4">Scratchcards</a></td>
+      <td><a href="lib/puzzles/2023/day04"><code>lib/puzzles/2023/day04</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+    <tr>
+      <td>5️⃣ <a href="https://adventofcode.com/2023/day/5">If You Give A Seed A Fertilizer</a></td>
+      <td><a href="lib/puzzles/2023/day05"><code>lib/puzzles/2023/day05</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+    <tr>
+      <td>6️⃣ <a href="https://adventofcode.com/2023/day/6">Wait For It</a></td>
+      <td><a href="lib/puzzles/2023/day06"><code>lib/puzzles/2023/day06</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+    <tr>
+      <td>7️⃣ <a href="https://adventofcode.com/2023/day/7">Camel Cards</a></td>
+      <td><a href="lib/puzzles/2023/day07"><code>lib/puzzles/2023/day07</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+    <tr>
+      <td>8️⃣ <a href="https://adventofcode.com/2023/day/8">Haunted Wasteland</a></td>
+      <td><a href="lib/puzzles/2023/day08"><code>lib/puzzles/2023/day08</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+    <tr>
+      <td>9️⃣ <a href="https://adventofcode.com/2023/day/9">Mirage Maintenance</a></td>
+      <td><a href="lib/puzzles/2023/day09"><code>lib/puzzles/2023/day09</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+    <tr>
+      <td>1️⃣0️⃣ <a href="https://adventofcode.com/2023/day/10">The Great Escape</a></td>
+      <td><a href="lib/puzzles/2023/day10"><code>lib/puzzles/2023/day10</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+    <tr>
+      <td>1️⃣1️⃣ <a href="https://adventofcode.com/2023/day/11">Cosmic Expansion</a></td>
+      <td><a href="lib/puzzles/2023/day11"><code>lib/puzzles/2023/day11</code></a></td>
+      <td>🌟🌟</td>
+    </tr>
+  </table>
 </details>

lib/puzzles/2024/day01/README.md

@@ -0,0 +1,86 @@
+# [Day 1: Historian Hysteria](https://adventofcode.com/2024/day/1)
+
+## Part One
+
+The **Chief Historian** is always present for the big Christmas sleigh launch, but nobody has seen him in months! Last anyone heard, he was visiting locations that are historically significant to the North Pole; a group of Senior Historians has asked you to accompany them as they check the places they think he was most likely to visit.
+
+As each location is checked, they will mark it on their list with a **star**. They figure the Chief Historian **must** be in one of the first fifty places they'll look, so in order to save Christmas, you need to help them get **fifty stars** on their list before Santa takes off on December 25th.
+
+Collect stars by solving puzzles. Two puzzles will be made available on each day in the Advent calendar; the second puzzle is unlocked when you complete the first. Each puzzle grants **one star**. Good luck!
+
+You haven't even left yet and the group of Elvish Senior Historians has already hit a problem: their list of locations to check is currently **empty**. Eventually, someone decides that the best place to check first would be the Chief Historian's office.
+
+Upon pouring into the office, everyone confirms that the Chief Historian is indeed nowhere to be found. Instead, the Elves discover an assortment of notes and lists of historically significant locations! This seems to be the planning the Chief Historian was doing before he left. Perhaps these notes can be used to determine which locations to search?
+
+Throughout the Chief's office, the historically significant locations are listed not by name but by a unique number called the **location ID**. To make sure they don't miss anything, The Historians split into two groups, each searching the office and trying to create their own complete list of location IDs.
+
+There's just one problem: by holding the two lists up **side by side** (your puzzle input), it quickly becomes clear that the lists aren't very similar. Maybe you can help The Historians reconcile their lists?
+
+For example:
+
+```plaintext
+3   4
+4   3
+2   5
+1   3
+3   9
+3   3
+```
+
+Maybe the lists are only off by a small amount! To find out, pair up the numbers and measure how far apart they are. Pair up the **smallest number in the left list** with the **smallest number in the right list**, then the **second-smallest left number** with the **second-smallest right number**, and so on.
+
+Within each pair, figure out **how far apart** the two numbers are; you'll need to **add up all of those distances**. For example, if you pair up a `3` from the left list with a `7` from the right list, the distance apart is `4`; if you pair up a `9` with a `3`, the distance apart is `6`.
+
+In the example list above, the pairs and distances would be as follows:
+
+- The smallest number in the left list is `1`, and the smallest number in the right list is `3`. The distance between them is **`2`**.
+- The second-smallest number in the left list is `2`, and the second-smallest number in the right list is another `3`. The distance between them is **`1`**.
+- The third-smallest number in both lists is `3`, so the distance between them is **`0`**.
+- The next numbers to pair up are `3` and `4`, a distance of **`1`**.
+- The fifth-smallest numbers in each list are `3` and `5`, a distance of **`2`**.
+- Finally, the largest number in the left list is `4`, while the largest number in the right list is `9`; these are a distance **`5`** apart.
+
+To find the **total distance** between the left list and the right list, add up the distances between all the pairs you found. In the example above, this is `2 + 1 + 0 + 1 + 2 + 5`, a total distance of **`11`**!
+
+Your actual left and right lists contain many location IDs. **What is the total distance between your lists?**
+
+Your puzzle answer was `1,222,801`.
+
+**The first half of this puzzle is complete! It provides one gold star:** 🌟
+
+## Part Two
+
+Your analysis only confirmed what everyone feared: the two lists of location IDs are indeed very different.
+
+Or are they?
+
+The Historians can't agree on which group made the mistakes **or** how to read most of the Chief's handwriting, but in the commotion you notice an interesting detail: a lot of location IDs appear in both lists! Maybe the other numbers aren't location IDs at all but rather misinterpreted handwriting.
+
+This time, you'll need to figure out exactly how often each number from the left list appears in the right list. Calculate a **total similarity** score by adding up each number in the left list after multiplying it by the number of times that number appears in the right list.
+
+Here are the same example lists again:
+
+```plaintext
+3   4
+4   3
+2   5
+1   3
+3   9
+3   3
+```
+
+For these example lists, here is the process of finding the similarity score:
+
+- The first number in the left list is `3`. It appears in the right list three times, so the similarity score increases by `3 * 3 = 9`.
+- The second number in the left list is `4`. It appears in the right list once, so the similarity score increases by `4 * 1 = 4`.
+- The third number in the left list is `2`. It does not appear in the right list, so the similarity score does not increase (`2 * 0 = 0`).
+- The fourth number, `1`, also does not appear in the right list.
+- The fifth number, `3`, appears in the right list three times; the similarity score increases by `9`.
+- The last number, `3`, appears in the right list three times; the similarity score again increases by `9`.
+- So, for these example lists, the similarity score at the end of this process is **`31`** (`9 + 4 + 0 + 0 + 9 + 9`).
+
+Once again consider your left and right lists. **What is their similarity score?**
+
+Your puzzle answer was `22,545,250`.
+
+**Both parts of this puzzle are complete! They provide two gold stars:** 🌟🌟

lib/puzzles/2024/day01/day01.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "part1"
+require_relative "part2"
+
+module AdventOfCode
+  module Puzzles2024
+    ##
+    # {include:file:lib/puzzles/2024/day01/README.md}
+    module Day01
+    end
+  end
+end