tokmd-gate 1.14.0

Policy evaluation engine for tokmd analysis receipts
Documentation

tokmd-gate

Evaluate JSON Pointer policies against tokmd receipts.

Problem

CI needs explicit pass/fail rules over structured receipts, not ad hoc scripts.

What it gives you

  • PolicyConfig, PolicyRule, RuleOperator, RuleLevel
  • evaluate_policy for receipt checks
  • evaluate_ratchet_policy for trend gates
  • resolve_pointer for JSON Pointer lookup

Quick use / integration notes

[[rules]]
name = "max_tokens"
pointer = "/derived/totals/tokens"
op = "<="
value = 500000
level = "error"

Supported operators: >, >=, <, <=, ==, !=, in, contains, and exists.

Example

use serde_json::json;
use tokmd_gate::{evaluate_policy, PolicyConfig};

let receipt = json!({
    "derived": {
        "totals": {
            "tokens": 42_000
        }
    }
});

let policy = PolicyConfig::from_toml(r#"
[[rules]]
name = "max_tokens"
pointer = "/derived/totals/tokens"
op = "lte"
value = 500000
level = "error"
"#)?;

let result = evaluate_policy(&receipt, &policy);
assert!(result.passed);

Go deeper

How-to

  • ../../docs/reference-cli.md

Reference

  • src/lib.rs

Explanation

  • ../../docs/explanation.md