Skip to content

docs(metric-benchmark): sketch Helix submission and result collection - #159

Draft
mstaats-nvidia wants to merge 1 commit into
mainfrom
docs/metric-benchmark-helix
Draft

mstaats-nvidia wants to merge 1 commit into
mainfrom
docs/metric-benchmark-helix

Conversation

@mstaats-nvidia

@mstaats-nvidia mstaats-nvidia commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

The metric benchmark currently runs prepared cases through a local Harbor loop. This documentation-only proposal adds an optional Helix execution workflow with two thin CLIs: submit the prepared agent/task matrix and return; later check all runs and collect a complete local results directory for analysis.

Based on #157's separate cases/execution/analysis configuration. The proposal keeps cases.yaml unchanged and assumes prep supplies an uploaded-input mapping. It includes per-command guides and an SVG, distinguishes unfinished runs from terminal failures, and identifies the native-evidence compatibility proof required before implementation. No Python implementation, upload/prep tool, new service, or Helix jobs are included.

Review order:

  1. labs/metric-benchmark/docs/assets/helix-execution.svg
  2. labs/metric-benchmark/docs/submit-helix-evals.md
  3. labs/metric-benchmark/docs/download-helix-results.md
  4. The short links in docs/architecture.md and docs/tools.md.

Validation: local Markdown links/anchors and SVG XML checked; rendered SVG inspected; Ruff lint/format, copyright, licenses, and whitespace checks pass. Full pytest: 3,025 passed, 29 skipped (optional integrations, platform-specific checks, and live-provider/model tests); no Helix jobs were submitted or deployment access tested.

Rebased onto main after #157 merged; documentation patch unchanged.


## Compatibility before implementation

The flow above is the intended interface, not a claim that Helix bundles currently

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

worth matching these once the metrics-benchmark flow is ready? I don't think we necessarily want to pin (folks may want to update or use different versions of harbor)

Base automatically changed from feat/metric-benchmark-stage-config to main October 30, 2026 21:36
@mstaats-nvidia
mstaats-nvidia force-pushed the docs/metric-benchmark-helix branch from e73789a to 8ac7273 Compare October 30, 2026 21:38

This branch has not been deployed

No deployments
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.

2 participants