P0: recover #2 organic page from a 404, fix unbootable published configs + broken sample code

[pftg]

Supersedes #493 (which was blocked by a stray commit from another session — see below). Same work, clean base off current master, plus two live defects found after it was opened.

P0 — the site's #2 organic page was a 404

Google ranks /blog/falcon-web-server-async-ruby-**in**-production/ at 37 clicks / 3,778 impressions / position 10.1 over 90 days — second only to the homepage — and that slug has never existed in this repo. Every click on our best-ranking blog result hit an error page, and the whole falcon * head-term cluster sits there.

Fixed with a Hugo aliases: entry (redirect verified in built output; correctly excluded from the sitemap). A reviewer swept all 450 ranking /blog/ URLs against published output — this is the only 404.

P0 — published boot configs that cannot boot

falcon --config config/falcon.rb serve appeared seven times on that page. It is invalid CLI — it errors Could not parse token "serve" because -c belongs to the subcommand. Two of the seven were the systemd ExecStart and the Dockerfile CMD. All replaced with falcon host, which reads falcon.rb from the app root; the multi-word env shebangs (which also fail on Linux) became falcon-host.

Broken copyable code in a post shipped this morning

multi-agent-llm-rails-rubyllm demonstrated model { ... } and claimed the block resolves lazily. In ruby_llm 1.16.0 model takes no block: with a nil argument it assigns an empty hash to @chat_kwargs, so the block form wipes the model and provider and the agent silently falls back to the configured default. Replaced with plain values and an explanation of the trap. Also cut "answers in milliseconds on a laptop" — the exact claim a sibling post dropped as unsupported — for the sourced 523MB figure.

Fabricated Rails config removed

Verified against Rails source, not memory:

Snippet	Reality
async_query_executor = :fiber_pool	Not a valid value — only nil, :global_thread_pool, :multi_thread_pool
allow_concurrency = true	A no-op; only an explicit false does anything (inserts Rack::Lock)

Corrections to my own earlier claims

• The isolation_level guidance in both the Falcon page and the fibers post told readers to add a line Falcon's Railtie sets unconditionally. Corrected in both; Railtie links pinned to v0.57.0.
• An earlier commit claimed the external cover_image broke og:image. It didn't — metatags.image resolves first. Retracted in the doc; the frontmatter change stays as hygiene with cover_image_alt added.
• §12c no longer certifies work that hasn't happened (three defects remain live in a section being rewritten separately, and the doc now says so).

Why this supersedes #493

A worktree collision landed another session's post (12e2ab1ac) inside #493, and my session lost write access to that branch before it could be dropped. This branch is that work cherry-picked onto current master without the stray commit, so the other session's post stays owned by its own branch.

Gates

bin/hugo-build green · check-post-visuals at floor (72) · alias redirect verified in built output · content-only diff, so visual suites correctly skipped.

🤖 Generated with Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: d32c15a5-ab7d-4adf-8518-90b3594da246

---

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.}