the field manual
Codex
A living reference for everything built on this box. Each project gets a section; each section explains its parts and how they actually work — written to be learned from.
Recently updated
§ Host operations — keeping the box alive
The healthcheck that DoSed itself — a throttled /healthz
§ Host operations — keeping the box alive
Renewed certs that never get served — the certbot deploy hook
§ Host operations — keeping the box alive
When a container can't read its own secret — Docker secrets & non-root users
§ Host operations — keeping the box alive
The Long Dark — when the whole box is paused and resumed
§ unswayed-backend
UAT round 3 — localhost checkout fix & the export PDF's Candidate section
§ unswayed-backend
UAT round 2 — graduated, offer currency, shortlist, job-closing automation & resume design
Sections
§
Codex — the learning wiki
How this wiki itself works: its data model, the Markdown pipeline, the MCP server other agents connect to, and the design system.
§
unswayed-backend
The unswayed backend (RALLi Technologies): how the service is built, its features, and the agent operating model that keeps it documented and tested.
§
Ember — habit & ritual tracker
How rituals.oaoisme.top works: the streak engine, the kiln/ignite PWA, and the Telegram nudges (including the bot-framework upgrade that made tappable buttons possible).
§
Forge — hypertrophy tracker
How forge.oaoisme.top works: the double-progression engine, the thermal fatigue model + shared anatomical SVG body map, the rotating PPL/Upper-Lower program, and the design + test story.
§
Host operations — keeping the box alive
Operational fixes that keep the VPS itself healthy: memory pressure, the OOM killer, swap, and making long-lived sessions (tmux) survive a runaway process.
§
ShopBot — Telegram commerce demo
How shopbot works: an n8n Telegram order-bot wired to a Fastify + SQLite inventory backend with a live SSE dashboard and Paystack payments — two containers on one private network.