Skip to content

Optional Google Stax CSV adapter for the eval loop (format-only, offline) - #41

Merged
CodesbyFebin merged 2 commits into
mainfrom
feat/stax-adapter
Oct 23, 2026
Merged

CodesbyFebin merged 2 commits into
mainfrom
feat/stax-adapter

Conversation

@CodesbyFebin

Copy link
Copy Markdown
Owner

Stacked on #34 (feat/eval-loop).

What

An optional, format-only adapter for Google Stax, which is Apache-2.0. It adds no dependency and makes no network calls.

  • exportSuiteCsv writes a HELLO suite, plus the outputs of an offline run if supplied, as a Stax dataset CSV. A run from a different suite version is refused.
  • importStaxCsv reads a Stax chat export (human ratings and LLM evaluator scores) and returns advisory annotations keyed by case id. HELLO run records and the promotion gate are unchanged.
  • CLI: scripts/stax.mjs export|import. It is off by default because nothing in the app calls it.

Verdict

Stax itself is a Java/Spring + MySQL + GCP Pub/Sub + Terraform platform, and its evaluators call hosted LLMs. That is too heavy for HELLO's offline core, so HELLO only interoperates through files. See docs/INTEGRATIONS-EVAL.md.

Status: built, not verified against a running Stax instance.

Evidence

  • tests/stax-adapter.test.mjs: 7/7, offline.
  • Temp SQLite DB: typecheck ok, 20/20 suites pass. ESLint on the changed files: clean.
  • Parser checked against Stax's bundled sample-data.csv: 14 rows × 11 columns, and all llm_evaluations cells parse as JSON. That file is not committed.
  • CLI round-trip: export then import matched all 6 cases.

Note

#35 also adds docs/INTEGRATIONS-EVAL.md and is based on main, so whichever PR merges second will get an add/add conflict. Keep both sections.

@vercel

vercel Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
hello-os Ready Ready Preview Oct 23, 2026 8:43am UTC

@CodesbyFebin
CodesbyFebin changed the base branch from feat/eval-loop to main October 23, 2026 08:35
# Conflicts:
#	docs/INTEGRATIONS-EVAL.md
#	package.json
@CodesbyFebin
CodesbyFebin merged commit fd1d9c2 into main Oct 23, 2026
3 checks passed
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