Jason Vertrees inchoate

Logging Best Practices

A practical guide to structured logging for production services, with emphasis on observability platforms like Datadog, Splunk, and CloudWatch.

1. Log Levels - When to Use Each

CRITICAL  →  System is unusable, wake someone up at 3am

Frontend Dashboard Refactoring Playbook

Based on the successful refactoring patterns I've seen before, here's a comprehensive playbook for refactoring another frontend. This guide will help another agent execute the same high-quality refactoring.

📋 Pre-Refactoring Checklist

  1. Analyze Current Structure
    - Map out all files in the dashboard directory

syncwrap

syncwrap is a light and elegant solution for running asynchronous functions in a synchronous environment. This helper neatly packages your async tasks, handling event loop creation and cleanup so you don’t have to.

Code

import asyncio

def run_async_safely(async_func, *args, **kwargs):

#!/bin/zsh

# Usage:
#     ./download_site.sh {URL}


url=$1
output_dir="./sites"

Moving from Sync to Async in FastAPI with SQLModel? Here's What You Need to Know!

Switching from a synchronous setup to an asynchronous one in your FastAPI/SQLModel app can bring some challenges. When making this switch, several important details need attention, especially around async sessions, avoiding misuse of await, and correctly handling relationships between tables.

A Typical Synchronous Setup:

# sync version
engine = create_engine(database_settings.pg_connection_string)
session = sessionmaker(bind=engine)

	#!/bin/bash
	# Claude Code status line — single line, utility-first
	input=$(cat)

	# ── Extract fields (single jq call for speed) ────────────────────────────────
	eval "$(echo "$input" \| jq -r '
	@sh "MODEL=\(.model.display_name // "?")",
	@sh "DIR=\(.workspace.current_dir // "?")",
	@sh "DURATION_MS=\(.cost.total_duration_ms // 0)",
	@sh "ADDED=\(.cost.total_lines_added // 0)",

	# ╔══════════════════════════════════════════════════════════════════╗
	# ║ tmux.conf — Ghostty + Claude Code + Neovim ║
	# ║ OSC 52 clipboard · vi copy mode · session persistence ║
	# ╚══════════════════════════════════════════════════════════════════╝


	# ── Terminal & Color ──────────────────────────────────────────────
	# Ghostty supports true color and undercurl natively.
	# We set tmux-256color as the base, then add Ghostty-specific
	# capabilities: RGB (true color), styled underlines, overlines.

	# Python Project Refactor Playbook

	A comprehensive guide for refactoring monolithic Python applications (Flask, Django, FastAPI) into maintainable, production-ready codebases.

	## 📋 Pre-Refactoring Assessment

	### 1. Current State Analysis
	```bash
	# Analyze codebase structure
	find . -name "*.py" -exec wc -l {} + \| sort -nr

	#!/bin/bash

	# cycle_stack.sh - Script to tear down and rebuild Docker Compose services
	# Usage: ./cycle_stack.sh [service_name1] [service_name2] ...

	set -e # Exit on error

	# Check if Docker Compose is installed
	if ! command -v docker compose &>/dev/null; then
	echo "Error: docker compose is not installed or not in PATH"

	# Makefile for managing Python dependencies with uv
	#
	# I built this because I got tired of juggling uv, pip, pyproject.toml,
	# and requirements.txt by hand. This Makefile gives me fast, reproducible
	# dependency management without forgetting to freeze, clean, or sync anything.
	#
	# Were I smarter I'd probably not have to do this. But, alas, I'm not.
	#
	# Key commands:
	#