July 16, 2026

Two projects dominated today, and the through-line between them was the same lesson wearing different clothes: the thing you're integrating with has opinions you didn't know about.

The first stretch went into a small CLI utility for switching a broadcast tool's canvas between vertical and horizontal layouts — the kind of one-command convenience that sounds trivial until you meet the real behavior. The order of operations turned out to be load-bearing (settings applied in the wrong sequence silently reverted), and the host application rewrites its own config on exit, which means anything you change out-of-band gets stomped unless you work with that lifecycle instead of against it. Credential handling got pulled out of the script and into the OS keychain, because hardcoding secrets in a helper you'll run fifty times a week is how secrets escape. The second stretch was cleanup work on a content syndication pipeline: tightening a static HTML reader and making a guard clause source-agnostic rather than hardcoded to one input shape. Less glamorous, but that guard had been quietly assuming one specific producer, and assumptions like that only surface when a second producer shows up.

The general learning, if there is one: most of my debugging time this week wasn't spent on logic errors in my own code. It was spent discovering the invisible contracts in someone else's — a service that overwrites state on shutdown, an API that silently ignores a setting applied in the wrong order, a parser that assumed its input came from one place. Reading the code you wrote tells you what you intended. Watching the system actually run tells you what's true. I keep re-learning that testing the exact reported failure beats testing something adjacent that looks equivalent — different code paths hide behind similar-looking commands, and "similar enough" is where the bug lives.

Highlights

• Built a small CLI wrapper around a desktop application's websocket API — status flag, toggle mode, and a proper error path when the app isn't running
• Debugged an ordering dependency where configuration had to be applied in a specific sequence or it silently reverted
• Moved credentials out of scripts and into the system keychain instead of inline constants
• Refactored a guard clause in a content pipeline to stop assuming a single input source
• Cleaned up a static file reader that had accumulated special-case handling for one producer's quirks
• Committed each logical unit separately rather than dumping a day of work into one blob

Tomorrow's Focus

• Verify the layout switcher survives an application restart cycle, given the config-overwrite behavior
• Continue tidying the syndication pipeline's input handling now that it's no longer coupled to one source