Files
zeekay ffb8067075 hanzo-research: Rust /v1/research client for self-logging kernel benchmarks
Mirror the Python hanzo_research SDK verbs + semantics:
experiment(hypothesis, predict) -> log(text) -> conclude(verdict, because, value),
plus record / snapshot / report and query / totals. The Verdict enum
(Proven|Refuted|Inconclusive) rejects any other value at compile time; a
refutation is a first-class sealed result. A stated hypothesis with no verdict
seals Inconclusive, never silently a proof.

Zero-config provenance: the first entry method posts the run in-flight and stamps
git sha/branch/dirty, the commit narrative since the experiment's last recorded
run, the crate versions resolved from Cargo.lock, and the host. The caller
supplies none. Records serialize to the identical wire shape as the Python SDK,
proven by an equality test against the golden shape.

Per-org Bearer auth only (no client-forged identity headers); the api key is
redacted from Debug; query values are percent-encoded; artifacts carry a client
sha256 the server verifies.

Deps stay within the resolved lock (ureq 2.12, base64 0.22, sha2 0.10, serde);
hex and percent-encoding are hand-rolled. Blocking client for a bench tool.

Tests: shape identity vs Python golden, running-record empty-log, finish
defaults, attempt shape, content-addressing, key redaction, and an end-to-end
mock-server run of a kernel-perf refutation. Example: examples/kernel_perf.rs.
2026-07-22 22:25:34 -07:00

20 lines
554 B
TOML

[package]
name = "hanzo-research"
version = "0.1.0"
edition = "2021"
description = "Record and query R&D evidence from Rust — the /v1/research client of the Hanzo ML stack."
repository = "https://github.com/hanzoai/ml"
keywords = ["benchmark", "provenance", "research", "machine-learning"]
categories = ["science", "api-bindings"]
license = "MIT OR Apache-2.0"
[dependencies]
serde = { workspace = true }
serde_json = { workspace = true }
ureq = { version = "2.12", features = ["tls", "gzip"] }
base64 = "0.22"
sha2 = "0.10"
[lints]
workspace = true