Add ops cheat sheet and smoke/uptime monitoring scripts

[alastairong1]

Summary

• New docs/ops.md — journalctl + curl recipes for the deployed service, cache_warmer status interpretation, smoke-test usage
• New scripts/smoke.sh — end-to-end correctness + latency probe; asserts on response shape (not just status), reports per-check latency, exits non-zero on FAIL
• New scripts/uptimerobot-setup.sh — one-shot creation of the 3 baseline UptimeRobot monitors (liveness, /health/detailed status=ok, cache_warmer running=true)

Why

Ops knowledge for the preview environment was living outside the repo. This pulls it inline so:

• New team members can debug the live service from journalctl recipes
• Smoke tests can run post-deploy or on a cron
• UptimeRobot setup is reproducible per-environment via one script

Forward-looking note

• The smoke + UptimeRobot scripts probe /health/detailed.cache_warmer, which lights up only after Add detailed health endpoint with raindex sync status #95 (detailed health endpoint) and the cache-warmer PR (TBD, see [Tracking] Deployed preview state — split-source, do not merge #94) merge. Until then those checks return FAIL/keyword-miss against main — that's expected.
• No application code touched in this PR; safe to merge ahead of the dependent endpoints.

Test plan

• bash -n scripts/smoke.sh (syntax check)
• Run ./scripts/smoke.sh against preview once detailed-health lands; expect PASS on liveness + 401 checks
• Read docs/ops.md end-to-end

Part of the deployed-state split tracked in #94.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 363ddb71-f62c-4a02-9793-9ac22cfb2d37

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch alastair/ops-tooling

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[findolor]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Add ops cheat sheet and smoke/uptime monitoring scripts #96 👈 (View in Graphite)
• Add detailed health endpoint with raindex sync status #95
• main

---

How to use the Graphite Merge Queue

Add the label add-to-gt-merge-queue to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.