cortex-router 0.1.0

Fail-closed, model-free routing policy that decides between deterministic tools, local models, and an upstream agent.
Documentation
# cortex-router

A fail-closed, model-free routing policy: given a task and its context, it
decides between deterministic tooling, repository analysis, a bounded local
model, or the upstream (strong) agent.

Model self-reported confidence is deliberately absent from the API. Routing
is a function of inspectable inputs only: task text, evidence state, schema
validity, token budgets, mutation authority, and local capability
availability.

## Why

"Should a small local model handle this?" is a safety question, not an
optimization question. This crate answers it with rules you can read, test,
and audit:

- **Fail-closed guards.** Missing or contradictory evidence, a schema
  failure, or a budget overrun always escalates upstream.
- **Mutation is never local.** Anything likely to mutate code or state is
  reserved for the upstream agent.
- **High-risk classes are named.** Security, authentication, concurrency,
  migration, release, deployment, and publication escalate by class.
- **Plans never exceed the caller's bound.** The returned `ContextPlan`
  reports at most the `max_input_tokens` the request declared.

```rust
use cortex_router::{route, EvidenceStatus, ExecutionTarget, RoutingRequest};

let mut request = RoutingRequest::new("Deploy the service to production");
request.evidence = EvidenceStatus::Verified;
let decision = route(&request);
assert_eq!(decision.target, ExecutionTarget::Upstream);
assert!(!decision.advisory_only);

let mut summary = RoutingRequest::new("Summarize the supplied evidence");
summary.evidence = EvidenceStatus::Verified;
assert_eq!(route(&summary).target, ExecutionTarget::Ollama);
```

## Scope and limits

Classification is lexical and currently tuned for English task text, which is
a deliberate trade: it is fast, deterministic, and inspectable, with no model
in the loop. Treat `classify` as a conservative first filter — it escalates
when uncertain — and layer richer signals above it if you need them.

## License

Licensed under either of [Apache License, Version 2.0](LICENSE-APACHE) or
[MIT license](LICENSE-MIT) at your option.