Skip to main content

Mercury Redesign: Clean Architecture Implementation

· 6 min read
Max Kaido
Architect

After extensive discussion and implementation, we've achieved a clean, minimal architecture that separates concerns properly and avoids over-engineering.

Core Architecture Principles

  1. Clear Separation: Variants (experiment tracking) vs Instances (deployment)
  2. Single Responsibility: Config = strategy, Instance = deployment, Scheduler = timing
  3. Type Safety: Strong enums prevent runtime errors
  4. No Database Pollution: Infrastructure concerns stay out of business logic
  5. Config-Over-Env: ABH variants determined by time + TypeScript config, NEVER environment variables

Naming Our Digital Guardians: Curie and Banach

· 4 min read
Max Kaido
Architect

When choosing names for our VPN infrastructure, we didn't want generic cloud provider labels. We wanted names that embody the spirit of breaking through barriers, transcending limitations, and opening new dimensions of possibility. After much deliberation (and a random number generator), we chose two immortal legends who revolutionized human understanding: Marie Curie and Stefan Banach.

From Shell Script Wild West to Battle-Tested Dotfiles: A BATS Testing Breakthrough

· 3 min read
Max Kaido
Architect

The Problem: Shell Scripts are the Wild West

For too long, shell scripts lived in the "wild west" of software development. You either drew your gun first and shot cleanly, or someone shot you first. There was no middle ground, no safety net, no way to know if your changes would break production until they already had.

Our dotfiles were no exception. A single wrong conditional statement could break shell loading for every developer, leaving them unable to work. The cost of mistakes was astronomical, and testing was... well, non-existent.

Hecate Server Connectivity Postmortem Analysis

· 2 min read

Date: June 11, 2025 Incident: Hecate server (192.168.3.25) connectivity issues and cloudflared timeouts Root Cause: Improperly crimped RJ45 connector causing intermittent network disconnections

A detailed postmortem analysis of network connectivity issues that revealed the importance of proper physical layer infrastructure and led to recommendations for router upgrades and redundancy planning.