tokmd-gate

Policy evaluation engine for tokmd analysis receipts. Enables CI gating based on code metrics.

Usage

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

let receipt: Value = serde_json::from_str(receipt_json)?;
let policy = PolicyConfig::from_file("policy.toml")?;
let result = evaluate_policy(&receipt, &policy)?;

if !result.passed {
    eprintln!("Policy check failed: {} errors, {} warnings", result.errors, result.warnings);
}

Policy File Format

fail_fast = false



[[rules]]

name = "max_tokens"

pointer = "/derived/totals/tokens"

op = "<="

value = 500000

level = "error"

message = "Codebase exceeds token budget"



[[rules]]

name = "min_doc_density"

pointer = "/derived/doc_density/total/ratio"

op = ">="

value = 0.1

level = "warn"

message = "Documentation below 10%"

Supported Operators

• >, >=, <, <=: Numeric comparisons
• ==, !=: Equality checks
• in: Value is in a list
• contains: String/array contains value
• exists: JSON pointer exists

License

MIT OR Apache-2.0