Dev to main, 27th Aug, 2026

[abhijaisrivastava15]

Summary

Promotion PR. Everything in it is already reviewed and merged to dev in #786; this moves it to main so it deploys to prod.

The payload is one cookbook page, instrument-and-verify, plus the checker script it tells the reader to download and the three captures it embeds. main currently serves the cookbook index but not this page, so the quickstart is live on dev and invisible in prod.

Why this is needed

.github/workflows/deploy.yml builds and deploys on push to main only. Merging #786 into dev therefore shipped nothing to docs.futureagi.com.

Checked against prod just now:

GET https://docs.futureagi.com/docs/cookbook                                -> 200
GET https://docs.futureagi.com/docs/cookbook/quickstart/instrument-and-verify -> 404
GET https://docs.futureagi.com/fi_verify.py                                -> 404

The second 404 is the page itself. The third one matters more than it looks: Step 2 of the page instructs the reader to run

curl -fsSL https://docs.futureagi.com/fi_verify.py -o observability/futureagi/fi_verify.py

so until main carries public/fi_verify.py, anyone following the cookbook from the live site hits a 404 on the first command that fetches anything.

What changed

Nothing was authored in this PR. The 11 commits and 8 files below are the full main...dev delta.

File
src/pages/docs/cookbook/quickstart/instrument-and-verify.mdx	new, +694. The quickstart itself
public/fi_verify.py	new, +252. The checker the page tells you to curl
public/images/docs/cookbook-instrument-and-verify/trace-list.png	new capture
public/images/docs/cookbook-instrument-and-verify/trace-tree.png	new capture
public/images/docs/cookbook-instrument-and-verify/session.png	new capture
src/lib/navigation.ts	+1. Sidebar entry for the new page
src/pages/docs/cookbook/index.mdx	+1/-1. Index link
src/pages/docs/cookbook/platform/index.mdx	+3. Cross-link from the platform section

Verification

• Checksum the page prints is the checksum of the file that ships. The page prints 75ce8d9cb5bafa1cbeea42affe8b464433ab97e438a53410f27678855d484de7 as the expected shasum -a 256 of fi_verify.py. Ran it against the copy on this branch: identical, 11,925 bytes.
• The three captures are real files, not empty placeholders. 154,218 / 187,436 / 322,787 bytes on branch.
• Link audit passed on the way in. Link audit & redirect enforcement was green on docs(cookbook): instrument an existing app and verify it end to end #786 before Khushal merged it.
• Rendered content was reviewed on dev. Images were checked on the dev deploy before the merge.

Blast radius

main...dev is 11 commits and 8 files, and every one of them belongs to this cookbook page. No unrelated work rides along.

The reverse compare dev...main is 0 files, so dev already contains everything on main. main gains exactly the 8 files above and loses nothing.

Rollback

Revert the merge commit. No schema, no migration, no config. The three prod URLs above return to their current state.

Note on the description template

The standard internal template asks for a tests table, a local suite-run screenshot and a test-run video. This is a docs promotion PR with no code and no test suite, and the content it carries was already reviewed and proved in #786, so those sections are deliberately omitted rather than filled with placeholders. The verification that does apply is above.