record_evidence
Record experimental results and update belief states in the hypothesis DAG, automatically capturing git context. Batch multiple outcomes in one call to revise beliefs efficiently.
Instructions
Record one result, or many in one call, and update the belief state. Auto-captures git context_hash + git_branch when unset. Record against the hypothesis whose statement you actually tested: evidence against a goal is refused, and evidence against a premise a composition assumed corrupts a confirmation that is still true on its own. Ran several experiments this turn? Report them together with results — one call, applied in order.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Rigour/scale of the test that produced this result. A confirmation at depth d only supports claims tested no deeper than d. | |
| notes | No | ||
| message | No | ||
| metrics | No | ||
| node_id | No | ||
| results | No | Several results at once, applied in the order given. Use this whenever you ran more than one experiment: reporting k results costs one call instead of k. Each entry takes the same fields as a single result. When present, the single-result fields below are ignored. | |
| success | No | ||
| claim_id | No | The claim this result answers. Optional: omit it entirely for a probe you initiated yourself, which is always safe. Pass the one get_next_targets issued for work it handed you, so the lease is released. | |
| duration_s | No | How long the experiment took, in seconds. Optional, and worth sending whenever your probes differ in cost: it is what lets the navigator rank by value per unit cost rather than treating a three-day run and a one-second check as interchangeable. | |
| error_type | No | ||
| source_ref | No | What was actually run to produce this number — a file path, a URL, a CI run id, a commit. Optional, but a trail that says '0.85, from pytest run #4412' is worth more later than one that says '0.85'. | |
| lease_ttl_s | No | TTL for the fused dispatch, if any. | |
| evidence_kind | No | logical | |
| attestation_id | No | Runner-minted attestation id. Provenance fields cannot be supplied here; unknown ids degrade to self-reported. | |
| count_next_targets | No | How many targets you want to be holding when this returns — a top-up, not an addition, so recording a batch of results leaves you with this many, not this many per result. Saves a separate get_next_targets round-trip. Leave at 0 when you are reporting a long-running experiment and are not ready to claim more work — anything claimed and not reported is work nobody else can do. |