feat(publishing): automate essay publishing and fix SPA routes

[keithce]

Why

The public essay export had stopped at 106 entries while the source collection had grown to 312. Publishing also relied on a manual handoff to the Resonant Projects website, and direct routes in the Vercel-hosted web app did not have an SPA fallback.

What Changed

• Refresh the complete 312-essay metadata, Markdown export, and manifest.
• Add an automated publishing workflow that resolves the OpenRouter credential through 1Password, generates missing metadata, validates the export, commits generated artifacts, and invokes the Resonant Projects Vercel deploy hook.
• Add stable publishing commands, excerpt normalization with focused tests, and a durable operating/recovery runbook.
• Add the Vercel SPA rewrite and deployment troubleshooting documentation.
• Deliberately leave the separate writing-branch mismatch out of scope.

Operational Requirement

Before the publishing workflow can deploy rproj-website, create a deploy hook for the resonant-projects Vercel project on main and save its URL as the RPROJ_VERCEL_DEPLOY_HOOK_URL GitHub Actions secret in this repository. The runbook documents the exact setup and recovery path.

Verification

• Completed a real publish run: 10 essays processed, 302 skipped, 0 failed; 312 essays exported.
• Verified source, metadata, exported Markdown, and manifest all contain the same 312 unique essay IDs.
• Verified an unresolved OpenRouter reference exits nonzero and leaves metadata unchanged.
• Passed 17 focused parser and excerpt-normalization tests.
• Passed formatting checks and git diff --check; focused lint reported no errors (two pre-existing unsafe JSON-cast warnings remain).
• Verified the Vercel preview returns 200 for /, direct /essays navigation, and the referenced static asset.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
frequency-music	Ready	Preview, Comment	Jul 18, 2026 6:14pm

[coderabbitai]

Important

Review skipped

Draft detected.

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: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: f5400ed0-1d3f-4bdb-957a-5c96a4d93bcc

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 automate-publishing-and-spa-routing

---

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