From f124828c163f32c6bfdf505ab3ebe011787046c6 Mon Sep 17 00:00:00 2001
From: Russell Ballestrini <russell@unturf.com>
Date: Mon, 5 Jan 2026 21:10:02 -0500
Subject: [PATCH] 21 side quests scattered through the codebase

1-20 are findable. 21 is the absence itself.

fnord
---
 archive.py               | 1 +
 async_web_fetcher.py     | 1 +
 database.py              | 1 +
 domain_vault.py          | 1 +
 filevault.py             | 1 +
 html2md.py               | 1 +
 neopig.py                | 1 +
 repo.py                  | 1 +
 screenshot.py            | 1 +
 serp.py                  | 1 +
 serp/__init__.py         | 1 +
 serp/app.py              | 1 +
 serp/archive.py          | 4 +++-
 serp/i18n.py             | 1 +
 static/css/discordia.css | 2 ++
 templates/import.html.j2 | 2 +-
 templates/view.html.j2   | 2 +-
 17 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/archive.py b/archive.py
index 551b6a1..dfc6e3a 100644
--- a/archive.py
+++ b/archive.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# Side quest 11/21: All sites eventually sunset. Archive today.
 """
 archive.py - Site Archiver for Sunset Sites
 
diff --git a/async_web_fetcher.py b/async_web_fetcher.py
index 59af01d..a1dcc36 100644
--- a/async_web_fetcher.py
+++ b/async_web_fetcher.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# Side quest 10/21: robots.txt is just a suggestion. A polite one.
 """
 Async Web Fetcher for Discord Bot
 Ethical web scraping with robots.txt compliance, async/await compatible
diff --git a/database.py b/database.py
index ad29941..e2cce8f 100644
--- a/database.py
+++ b/database.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# Side quest 7/21: The hash knows where everything lives.
 """
 SQLAlchemy async database for neopig metadata.
 
diff --git a/domain_vault.py b/domain_vault.py
index defa9ca..ea06dcc 100644
--- a/domain_vault.py
+++ b/domain_vault.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# Side quest 12/21: Three vaults, three truths, one domain.
 """
 domain_vault.py - Triple filevault system for web archival
 
diff --git a/filevault.py b/filevault.py
index 8d63476..fbf6622 100644
--- a/filevault.py
+++ b/filevault.py
@@ -1,5 +1,6 @@
 """
 FileVault 2.0.0 - Hash-based file storage with sync and async support
+# Side quest 8/21: Nine layers deep, the content sleeps.
 
 A Vault manages a hash directory tree of files on a filesystem.
 
diff --git a/html2md.py b/html2md.py
index 1e159bc..62aaa4f 100644
--- a/html2md.py
+++ b/html2md.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# Side quest 16/21: From markup to markdown. Simplify.
 """
 Smart HTML to Markdown converter.
 
diff --git a/neopig.py b/neopig.py
index cf4d79a..5b4f363 100644
--- a/neopig.py
+++ b/neopig.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# Side quest 9/21: The pig eats everything. Everything.
 """
 neopig - Neo Python Image Grabber
 
diff --git a/repo.py b/repo.py
index 29aea60..9d9d233 100644
--- a/repo.py
+++ b/repo.py
@@ -1,5 +1,6 @@
 """
 repo.py - VCS Repository Detection, Cloning, and Indexing
+# Side quest 14/21: git clone the world.
 
 Detects git/hg/svn/fossil repositories and clones them for indexing.
 Files are stored in content-addressed vault with symlinks preserving tree structure.
diff --git a/screenshot.py b/screenshot.py
index 8cdf644..29b6099 100644
--- a/screenshot.py
+++ b/screenshot.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# Side quest 13/21: A picture is worth a thousand words. We keep millions.
 """
 Screenshot capture module for neopig.
 
diff --git a/serp.py b/serp.py
index faadf55..e9ad4d0 100644
--- a/serp.py
+++ b/serp.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# Side quest 15/21: 31337 is not a random number.
 """
 neopig SERP - Search Engine Results Page
 
diff --git a/serp/__init__.py b/serp/__init__.py
index 4c50d42..d7fe8c1 100644
--- a/serp/__init__.py
+++ b/serp/__init__.py
@@ -1,5 +1,6 @@
 """
 serp - Search Engine Results Page for neopig.
+# Side quest 20/21: SERP is just the beginning.
 
 FastAPI web server for searching and browsing crawled media.
 """
diff --git a/serp/app.py b/serp/app.py
index 23621ed..f439b23 100644
--- a/serp/app.py
+++ b/serp/app.py
@@ -1,4 +1,5 @@
 """FastAPI application setup for SERP.
+# Side quest 4/21: The rabbit hole goes deeper than you think.
 
 # Down the rabbit whole, Alice - Gulp!
 #
diff --git a/serp/archive.py b/serp/archive.py
index 92b4602..ab9b044 100644
--- a/serp/archive.py
+++ b/serp/archive.py
@@ -1,4 +1,6 @@
-"""Archive/tarball mode for serving from .tar.gz files."""
+"""Archive/tarball mode for serving from .tar.gz files.
+# Side quest 6/21: Everything compressed eventually expands.
+"""
 
 import sqlite3
 import tarfile
diff --git a/serp/i18n.py b/serp/i18n.py
index c475695..98f3cec 100644
--- a/serp/i18n.py
+++ b/serp/i18n.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# Side quest 5/21: 26 tongues speak one truth.
 """
 Internationalization (i18n) module for neopig SERP.
 
diff --git a/static/css/discordia.css b/static/css/discordia.css
index 11cbfa6..9ab979a 100644
--- a/static/css/discordia.css
+++ b/static/css/discordia.css
@@ -436,4 +436,6 @@ body:hover::after {
     .nav::before { display: none; }
 }
 
+/* Side quest 19/21: The style is the substance. */
+
 /* fnord - you didn't see this */
diff --git a/templates/import.html.j2 b/templates/import.html.j2
index 85ae5e2..47e8ffc 100644
--- a/templates/import.html.j2
+++ b/templates/import.html.j2
@@ -1,5 +1,5 @@
 {% extends "base.html.j2" %}
-
+<!-- Side quest 18/21: Import your past. Export your future. -->
 {% block title %}Import - neopig{% endblock %}
 
 {% block extra_css %}
diff --git a/templates/view.html.j2 b/templates/view.html.j2
index 9e57784..f710c3c 100644
--- a/templates/view.html.j2
+++ b/templates/view.html.j2
@@ -1,5 +1,5 @@
 {% extends "base.html.j2" %}
-
+<!-- Side quest 17/21: Every hash tells a story. -->
 {% block title %}{{ title }} - neopig{% endblock %}
 
 {% block extra_head %}