Merge pull request #364 from siddsachar/feat/unified-client-platform-… #253
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
| name: Docs | |
| on: | |
| workflow_dispatch: | |
| push: | |
| branches: [main] | |
| paths: | |
| - ".github/workflows/docs.yml" | |
| - "docs-site/**" | |
| - "docs/**" | |
| - "docs-content/**" | |
| - "scripts/docs/**" | |
| - "scripts/smoke_docker_server.py" | |
| - "tests/docs/**" | |
| - "README.md" | |
| - "RELEASE_NOTES.md" | |
| - "src/row_bot/agent.py" | |
| - "src/row_bot/agent_context.py" | |
| - "src/row_bot/agent_profiles.py" | |
| - "src/row_bot/agent_runs.py" | |
| - "src/row_bot/agent_runner.py" | |
| - "src/row_bot/agent_tool_catalog.py" | |
| - "src/row_bot/access/**" | |
| - "src/row_bot/app.py" | |
| - "src/row_bot/capability_search.py" | |
| - "src/row_bot/docs_capture.py" | |
| - "src/row_bot/goals.py" | |
| - "src/row_bot/models.py" | |
| - "src/row_bot/skill_discovery.py" | |
| - "src/row_bot/skills_activation.py" | |
| - "src/row_bot/threads.py" | |
| - "src/row_bot/ui/**" | |
| - "src/row_bot/designer/**" | |
| - "src/row_bot/developer/**" | |
| - "src/row_bot/tools/**" | |
| - "src/row_bot/voice/**" | |
| - "src/row_bot/providers/**" | |
| - "src/row_bot/channels/**" | |
| - "src/row_bot/plugins/**" | |
| - "src/row_bot/mcp_client/**" | |
| - "bundled_skills/**" | |
| - "tool_guides/**" | |
| pull_request: | |
| paths: | |
| - ".github/workflows/docs.yml" | |
| - "docs-site/**" | |
| - "docs/**" | |
| - "docs-content/**" | |
| - "scripts/docs/**" | |
| - "scripts/smoke_docker_server.py" | |
| - "tests/docs/**" | |
| - "README.md" | |
| - "RELEASE_NOTES.md" | |
| - "src/row_bot/agent.py" | |
| - "src/row_bot/agent_context.py" | |
| - "src/row_bot/agent_profiles.py" | |
| - "src/row_bot/agent_runs.py" | |
| - "src/row_bot/agent_runner.py" | |
| - "src/row_bot/agent_tool_catalog.py" | |
| - "src/row_bot/access/**" | |
| - "src/row_bot/app.py" | |
| - "src/row_bot/capability_search.py" | |
| - "src/row_bot/docs_capture.py" | |
| - "src/row_bot/goals.py" | |
| - "src/row_bot/models.py" | |
| - "src/row_bot/skill_discovery.py" | |
| - "src/row_bot/skills_activation.py" | |
| - "src/row_bot/threads.py" | |
| - "src/row_bot/ui/**" | |
| - "src/row_bot/designer/**" | |
| - "src/row_bot/developer/**" | |
| - "src/row_bot/tools/**" | |
| - "src/row_bot/voice/**" | |
| - "src/row_bot/providers/**" | |
| - "src/row_bot/channels/**" | |
| - "src/row_bot/plugins/**" | |
| - "src/row_bot/mcp_client/**" | |
| - "bundled_skills/**" | |
| - "tool_guides/**" | |
| concurrency: | |
| group: docs-${{ github.ref }} | |
| cancel-in-progress: true | |
| permissions: | |
| contents: read | |
| jobs: | |
| build: | |
| name: Build docs | |
| runs-on: ubuntu-latest | |
| env: | |
| DOCS_NODE_IMAGE: "node:20.20.2-bookworm" | |
| DOCS_NODE_PLATFORM: "linux/amd64" | |
| NO_UPDATE_NOTIFIER: "1" | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v7 | |
| - name: Set up Python | |
| uses: actions/setup-python@v6 | |
| with: | |
| python-version: "3.12" | |
| - name: Install Python docs dependencies | |
| run: python -m pip install pyyaml pytest pillow | |
| - name: Collect docs inventory | |
| run: python scripts/docs/collect_inventory.py --out docs-build/inventory | |
| - name: Check generated reference pages | |
| run: python scripts/docs/generate_mdx.py --inventory docs-build/inventory --check | |
| - name: Generate LLM docs files | |
| run: python scripts/docs/generate_llms_txt.py --docs-root docs-site/docs --out-dir docs-site/static | |
| - name: Validate committed screenshots | |
| run: python scripts/docs/capture_real_ui_screenshots.py --validate-only | |
| - name: Validate docs source | |
| run: python scripts/docs/validate_public_docs.py | |
| - name: Build docs review report | |
| run: python scripts/docs/build_review_report.py | |
| - name: Run docs automation tests | |
| run: pytest tests/docs -q | |
| - name: Build and verify published docs in canonical container | |
| run: | | |
| docker run --rm \ | |
| --platform "$DOCS_NODE_PLATFORM" \ | |
| --mount "type=bind,src=${GITHUB_WORKSPACE},dst=/repo" \ | |
| --env NO_UPDATE_NOTIFIER \ | |
| "$DOCS_NODE_IMAGE" \ | |
| bash -lc "ln -sf /usr/bin/python3 /usr/local/bin/python && cd /repo/docs-site && npm ci && npm run build:ci && cd /repo && python scripts/docs/sync_github_pages.py --check" |