UAPI Job Routing Contracts v0
JobBrief, PlacementDecision, routing, gate, run, and result contract baseline.
Promotion Metadata
- Source feedback id:
88 - Source feedback ids:
88 - Promotion request id:
22 - Feedback category:
beneficial - Feedback source:
ai-lane - Feedback created at:
2026-06-22T16:36:03.697459+00:00 - Target slug:
[REDACTED:high-entropy] - Review state:
review - Reviewer note: AI lane auto-promoted redacted feedback into internal catalog context.
Source Feedback Body
Feedback 88
- Product:
uapi - Category:
beneficial - Related slug:
[REDACTED:high-entropy] - Source:
ai-lane - Created at:
2026-06-22T16:36:03.697459+00:00
title: UAPI Job Routing Contracts v0 project: uapi kind: runbook state: draft tags: [docs, runbook, uapi, jobs, routing]
UAPI Job Routing Contracts v0
Goal: make every UAPI action traceable from operator intent to route selection, gates, execution, evidence, and result.
JobBrief fields: - job_id, created_by, created_at, product, purpose. - intent_summary and requested_output. - data_class: public_safe, internal, sensitive, secret_disallowed. - constraints: latency, cost, locality, hardware, retention, approval. - allowed_tools and denied_tools. - required_gates.
PlacementDecision fields: - decision_id, job_id, decided_at, decided_by. - selected_route: friendly route name only. - selected_adapter and adapter_mode: mock, sandbox, live. - rejected_routes: route, reason, missing capability, policy denial, benchmark gap. - capability_facts: source, observed_at, audit or citation. - benchmark_basis: model, metric, date, route, caveat. - policy_reason and fallback_route. - confidence: exploratory, candidate, production_capable.
GateRecord fields: - gate_id, gate_type, job_id, required_role, decision, decided_by. - evidence_refs, expiry, rollback_note, blocked_reason.
RunRecord fields: - run_id, job_id, placement_decision_id, adapter, route, started_at, ended_at. - input_hash, output_hash, event_count, cost_estimate, error_state. - audit_event_ids and artifact_refs.
ResultPacket fields: - result_id, job_id, run_id, status, summary, artifacts, caveats, follow_up. - no_secret_confirmed, redaction_state, published_context_refs.
Routing tests: unknown route rejects; route without current capability evidence rejects; production route cannot rely only on assumptions; cloud burst route cannot become control plane.