Skip to content

feat(reports): add composable experiment reports and line charts - #48

Merged
marcfranquesa merged 1 commit into
mainfrom
feat/experiment-reports
Oct 7, 2026
Merged

marcfranquesa merged 1 commit into
mainfrom
feat/experiment-reports

Conversation

@marcfranquesa

@marcfranquesa marcfranquesa commented Oct 6, 2026 •

Copy link
Copy Markdown
Owner

Adds per-experiment reports declared in an optional report.yaml, with Markdown, line-chart, and responsive row blocks. Static builds embed reports and their data in an offline snapshot; live serving refreshes reports from the same source as the experiment metadata.

Line charts show a dot for every recorded value, preserve missing-value gaps, and align card heights within rows. Keyboard inspection and semantic data tables provide access to values. SVG legend swatches use the same colors and exact dash patterns as the plotted lines.

Report loading batches selected experiment IDs, enumerating each parent directory once per batch while preserving exact-name checks, directory confinement, and source/data limits. Reports support configured experiment directories and nested IDs. Build and serve share the CLI snapshot loader; build remains local-only, while serve chooses source winners before loading reports. The web handler receives snapshots rather than reading project files.

Browser code is grouped under internal/web/assets, with markup under templates. assets.go owns embedding and explicit dependency order. Graph, page navigation, report focus/state, and live polling have separate owners. Palette tokens, shared report layout, and line-specific styling are separate; static output still includes all assets inline. Live refresh preserves the selected catalog view and focused links when a source's remote URL changes.

Missing CSV results display an unavailable state. Invalid report configuration or data fails the build without replacing its snapshot, and live refresh retains the last valid view. Includes documentation and example fixtures.

Validation:

  • Full go test -race ./..., go vet ./..., JavaScript syntax checks, and git diff --check passed after integration with configurable experiment layouts.
  • Report-controller/live-refresh behavioral checks passed; a focus regression probe covered changed, unchanged, and removed remote/report links in list and graph details.
  • Baseline comparison preserved report data and semantic markup apart from legend swatches. Browser checks covered points, gaps, equal-height cards, desktop/mobile layout, keyboard inspection, live selection/focus/table state, and stale-hash navigation.
  • Configured-directory/nested-ID tests cover path confinement, exact spelling, source precedence, and actual local-only CLI report builds.
  • Readonly documentation generation passed. The full documentation site build runs in CI; Hugo is not installed locally.
  • GitHub CI passed the Linux and macOS race/vet jobs, documentation site build, and packaging check at commit 6b958aa.

@marcfranquesa
marcfranquesa force-pushed the feat/experiment-reports branch from 6b958aa to d64cc2e Compare October 6, 2026 23:58
@marcfranquesa
marcfranquesa merged commit 8a4bdf2 into main Oct 7, 2026
6 checks passed
@marcfranquesa
marcfranquesa deleted the feat/experiment-reports branch October 7, 2026 00:01
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