Skip to content
FSS Knowledge Base

MBR-Business-Dev — Lessons

Section titled “MBR-Business-Dev — Lessons”

Insights captured during project work. Add entries as discovered.

Project folder naming: confirm before first build

Section titled “Project folder naming: confirm before first build”

Project folder rename (e.g. bmr/ → mbr/) cascades: crontab entries, all shell scripts, all Python path references, all KB notes referencing old path. Confirm folder naming with Talbot before first build — rename costs full session.

Captured from: Hassle Threshold Engine task (2026-04-09)

Wrangler Pages: create project before first deploy

Section titled “Wrangler Pages: create project before first deploy”

wrangler pages deploy fails “Project not found” if Cloudflare Pages project doesn’t exist yet — does NOT auto-create. Always run first:

Terminal window
wrangler pages project create [name] --production-branch main

Then deploy normally. Subsequent deploys to same project name work without create step.

Captured from: Rate Scanner Layer 1 Hardening task (2026-04-22)

Health-check sentinels must never gate the pipeline they monitor

Section titled “Health-check sentinels must never gate the pipeline they monitor”

Health-check sentinels must never gate pipeline producing output they check. Rate-scanner health-check monitors rates.json freshness — gating export on that sentinel creates irrecoverable deadlock: stale output → health FAIL → no export → stale. Only sentinels written by current run (e.g. anomaly-status) safe as export gates.

Captured from: Rate Scanner Issues task (2026-05-01)

External Python utils: load your .env before importing, declare dotenv explicitly

Section titled “External Python utils: load your .env before importing, declare dotenv explicitly”

Integrating external Python utility (like notify_manager) calling load_dotenv() at module level: load your own .env before adding utility to sys.path and importing it — else module-level load_dotenv() fires first, misses your credentials. Also add python-dotenv as explicit dependency even if external tool brings it transitively; uv won’t resolve transitive deps for direct import.

Captured from: Rate Scanner Issues task (2026-05-01)