chore(frontend): polish the draft-run references fix (doc accuracy and a test guard)

[mmabrouk]

Follow-up to #5163. A post-merge review found three accuracy gaps, all fixed here.

What was wrong

• README.md stated the debunked mechanism. It still said a successful commit is what flips the panel into the unsaved state. The project's own research.md (rewritten in [#5162] fix(frontend): forward variant references on draft playground runs #5163) shows the real rule: isDirty means the loaded revision carries unsaved edits, from a user edit or a missed data-committed-revision repoint. The README now matches the research.
• A code comment cited a file that does not exist. The gate comment in agentRequest.ts pointed at services/oss/src/agent/tracing.py. The is_draft = revision is None logic actually lives in sdks/python/agenta/sdk/agents/tracing.py:165. The comment now points there.
• One fallback path had no test. A dirty run whose references contain only application_revision must collapse to references: null (the empty-object fallback). A new test pins that. The three key-absence assertions were also strengthened from toBeUndefined() to not.toHaveProperty(...), which is the actual wire contract (key absent, not key undefined).
• research.md's self-citations were refreshed to the post-fix line numbers, and quotes of the old gate are now marked as the code before the fix instead of carrying stale line references.

Tests

pnpm run test:unit in web/packages/agenta-playground: 197 passed (196 baseline + 1 new). pnpm lint-fix clean.

https://claude.ai/code/session_01CSTSEXSe4DDhoXCFjZpZ5W

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
agenta-documentation	Ready	Preview, Comment	Jul 9, 2026 3:11pm

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

Review profile: CHILL

Plan: Pro Plus

Run ID: ab0ddd46-8e35-4c9b-82fe-661972039f00

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 fix/draft-run-references-polish

---

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