C++ docs: fix Lemonade install, add version consistency check#444
Merged
Conversation
…check - Replace `pip install lemonade-server` with binary installer downloads (MSI for Windows, .deb for Linux) matching LEMONADE_VERSION v9.3.0 in docs/cpp/setup.mdx and cpp/README.md - Update prerequisites table to show explicit version (9.3.0) instead of "latest" - Add util/check_doc_versions.py: scans docs for hardcoded Lemonade version strings and validates they match src/gaia/version.py - Integrate version check into util/lint.py as --doc-versions (check 8/8) - Add version consistency step to .github/workflows/docs.yml so CI catches stale version references on PRs Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
github-actions
Bot
added
documentation
…, docs refresh - Rewrite health agent system prompt with full inline PowerShell commands per investigation strategy (eliminates 4B model misinterpreting command labels as tool names) - Consolidate menu to 6 reliable options, drop unreliable query types - Add CleanConsole::printFinalAnswer() JSON extraction and FINDING/DECISION line stripping for clean terminal output - Replace health-agent.mdx placeholder with actual video demo - Shorten and clean up wifi-agent.mdx and quickstart.mdx docs - Restructure docs.json C++ navigation (promote testing/api-reference, reorder user guides) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
kovtcharov-amd
approved these changes
Mar 7, 2026
The testing.mdx file was referenced in docs.json but not committed, causing the Docs Validation CI to fail. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2 tasks
itomek
pushed a commit
that referenced
this pull request
Mar 12, 2026
## Summary - **Fix Lemonade install instructions** in C++ docs (`docs/cpp/setup.mdx`, `cpp/README.md`): replace `pip install lemonade-server` with binary installer downloads (MSI for Windows, `.deb` for Linux) matching `LEMONADE_VERSION` v9.3.0 - **Add `util/check_doc_versions.py`**: scans all docs for hardcoded Lemonade version strings and validates they match `src/gaia/version.py` — prevents stale version references after bumps - **Integrate into CI**: added as a step in `.github/workflows/docs.yml` and as `--doc-versions` check (8/8) in `util/lint.py` ## Test plan - [x] `python util/check_doc_versions.py` passes with matching versions - [x] `python util/check_doc_versions.py` correctly detects mismatches when `LEMONADE_VERSION` is changed - [x] `python util/lint.py --doc-versions` passes and integrates into lint summary - [x] `python util/lint.py --doc-versions` fails correctly when versions mismatch - [x] CI `docs.yml` workflow runs successfully on this PR 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
github-merge-queue Bot
pushed a commit
that referenced
this pull request
Mar 13, 2026
## Summary - Replace exponential backoff poll loop (60 attempts × up to 30s = ~30 min worst case) with fixed 10s poll and 5 min hard cap - Add `timeout-minutes: 15` on the job as a safety net - Prevents merge queue from hanging indefinitely when model download is slow on cold runners ## Context PR #444 was blocked in the merge queue for 18+ min because the Lemonade server startup loop was waiting too long. Normal PR runs complete in 3-9 min. ## Test plan - [ ] Verify GAIA CLI Linux test completes within expected timeframe - [ ] Confirm merge queue no longer hangs on this workflow 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/cpp/setup.mdx,cpp/README.md): replacepip install lemonade-serverwith binary installer downloads (MSI for Windows,.debfor Linux) matchingLEMONADE_VERSIONv9.3.0util/check_doc_versions.py: scans all docs for hardcoded Lemonade version strings and validates they matchsrc/gaia/version.py— prevents stale version references after bumps.github/workflows/docs.ymland as--doc-versionscheck (8/8) inutil/lint.pyTest plan
python util/check_doc_versions.pypasses with matching versionspython util/check_doc_versions.pycorrectly detects mismatches whenLEMONADE_VERSIONis changedpython util/lint.py --doc-versionspasses and integrates into lint summarypython util/lint.py --doc-versionsfails correctly when versions mismatchdocs.ymlworkflow runs successfully on this PR🤖 Generated with Claude Code