Skip to content

docs: document local compare API - #395

Closed
mikemikimike wants to merge 1 commit into
aaronlab:mainfrom
mikemikimike:docs/issue-387-compare-api
Closed

docs: document local compare API#395
mikemikimike wants to merge 1 commit into
aaronlab:mainfrom
mikemikimike:docs/issue-387-compare-api

Conversation

@mikemikimike

Copy link
Copy Markdown

Summary

Refs #387

The examples guide already documents the browsertrace compare CLI. This adds the local API endpoint so scripts, dashboards, and automation checks can retrieve the same first-divergence JSON while the local UI is running.

Changes

  • Add the GET /api/compare/<failed_run_id>/<success_run_id> recipe to examples/README.md.
  • Add a metadata regression assertion covering the new documentation.

Compatibility

Documentation and test-only changes; no runtime or server behavior changes.

Validation

  • $env:PYTHONUTF8='1'; python -m pytest tests/test_metadata.py -q — 401 passed, 1 skipped.
  • git diff --check — passed.

The repository-prescribed uv run --python 3.11 --extra dev pytest ... command was attempted first, but uv stalled while downloading Python 3.11 in this environment. The equivalent installed Python test command passed with UTF-8 mode enabled because Windows otherwise defaulted to GBK when reading the repository's UTF-8 docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant