jev-harness (Rust)

Zero-overhead System One decision harness & token optimizer for AI coding agents and Tauri applications.

jev-harness wraps TypeSafe Jev System One micro-decisions with local fast heuristics (< 500µs) and remote sub-second inference (70-300ms). It prevents catastrophic token waste ($10-$50/M frontier reasoning calls) by detecting dependency errors, circular failure loops, and deterministic routing locally.

🌐 Multi-Provider Support & OpenCode Zen (Free Tier)

Configure your preferred provider via environment variables or .env:

# Option A: OpenCode Zen Free Tier (No API key required!)
export JEV_PROVIDER="opencode"

# Option B: TypeSafe Direct API
export TYPESAFE_API_KEY="your-typesafe-api-key"

# Option C: OpenRouter
export OPENROUTER_API_KEY="your-openrouter-key"

⚡ Key Capabilities

Test & Process Failure Triage (triage_test_failure):
- Detects missing modules (TS2307, Cannot find module, ModuleNotFoundError, E0463), flaky network timeouts (ETIMEDOUT, ECONNRESET), and syntax errors in < 500µs locally.
- Tells your agent or process runner to install dependencies or retry without invoking expensive frontier LLMs (skip_llm: true).
Loop & Doom Prevention (should_abort_trajectory):
- Evaluates consecutive identical test failures and repetition loops to kill runaway agentic runs before burning budget.
Dynamic Model Routing (route_model_tier):
- Routes simple tasks, typos, and lint errors to fast deterministic models, and reserves expensive 2026 reasoning models (GPT-6 Astra, Claude Fable 5.1 / Claude Opus 5) only for complex architectural asks.
Step Completion Verification (verify_step_completion):
- Confirms criteria satisfaction before concluding multi-step workflows.

📦 Installation

Add to your Cargo.toml:

[dependencies]
jev-harness = "0.1.6"
tokio = { version = "1", features = ["full"] }

Or add via cargo add:

cargo add jev-harness

Or install the standalone CLI:

cargo install jev-harness

🚀 Usage

1. Test Failure Triage

use jev_harness::gates::triage_test_failure;

#[tokio::main]
async fn main() {
    let error_log = "error[E0463]: can't find crate for 'serde'";
    let decision = triage_test_failure(error_log, None).await.unwrap();

    if decision.skip_llm {
        println!("[ACTION] {}", decision.action_recommendation);
    } else {
        println!("[FORWARD] Deep bug detected. Route to frontier LLM.");
    }
}

2. Trajectory Loop Abort Guard

use jev_harness::gates::should_abort_trajectory;

#[tokio::main]
async fn main() {
    let history = "Attempt 1 failed with connection timeout\nAttempt 2 failed with connection timeout";
    let step = "Repeat identical prompt with no code changes";

    let check = should_abort_trajectory(step, history, None).await.unwrap();
    if check.should_abort {
        eprintln!("[KILL AGENT] {}", check.reasoning_summary);
    }
}

3. Model Tier Routing

use jev_harness::gates::route_model_tier;

#[tokio::main]
async fn main() {
    let routing = route_model_tier("Refactor auth system architecture", None).await.unwrap();
    println!("Selected Tier: {}", routing.selected_tier);
    println!("Recommended Model: {}", routing.recommended_model);
}

4. Dynamic Reasoning Effort Modulation (Astra-Jev)

use jev_harness::gates::modulate_reasoning_effort;

#[tokio::main]
async fn main() {
    let step = "git status and inspect modified files";
    let effort = modulate_reasoning_effort(step, "deepseek", Some("deepseek-v4.1-flash"), None).await.unwrap();

    println!("Effort: {}", effort.effort); // low
    println!("Dialect Params: {:?}", effort.provider_params); // {"extra_body": {"thinking": {"type": "enabled"}}, "reasoning_effort": "low"}
    println!("Cache Safe Advisory: {}", effort.cache_safe_recommendation);
}

5. CLI Usage

# Run triage on a traceback
jev test-gate "Cannot find module 'lodash'"
# or alias
jev triage "Cannot find module 'lodash'"

# Trajectory abort check
jev abort-check --plan "Try identical prompt again" --history "Attempt 1 failed"

# Route model tier
jev route --task "Fix typo in variable name"

# Check reasoning effort (Astra-Jev)
jev reasoning-effort --context "git status" --target-provider deepseek

# Check system status
jev status

jev-harness 0.1.6