1

02 Specifications

github-actions[bot] edited this page 2026-07-29 18:19:12 +00:00

Table of Contents

• Issue-Agent Executable Triage: Specifications
• Acceptance Contract
• API Contract (Target)
• Persistence Contract (Target)
• Assumptions, Risks, Uncertainties

🌍 View in other languages

Issue-Agent Executable Triage: Specifications

Machine status: in_progress

Acceptance Contract

ac_id	requirement	acceptance evidence	status
AC1	Non-dry recorded triage executes through normal chat routing with selected provider, model, and policy	actual issue-agent route reaches chat POST; provider-boundary mock observes selected target; policy is proven consumed by routing	implemented_pending_acceptance
AC2	Persist accepted, running, and terminal state plus sanitized request/prompt, model output, usage, cost, runtime, and terminal error	durable queryable record contains each field for success and failures	pending
AC3	API returns a useful, structured triage result derived from model output	response has stable triage schema and is not a raw opaque provider payload	pending
AC4	Tests cover success, provider/model failure, timeout, and budget stop	each outcome asserts HTTP response and persisted terminal record	pending

API Contract (Target)

field	rule
mode	must be recorded-triage
execution selection	accepts configured provider, model, routingPolicy, and bounded timeoutMs
runId	stable execution identifier returned for every accepted run
result	includes structured triage decision/summary/actions and execution metadata
errors	return sanitized terminal error with explicit terminal status; never leak provider credentials or unredacted issue content

Persistence Contract (Target)

field group	required values
identity	run ID, issue URL/repository/number, mode, timestamps
lifecycle	accepted, running, succeeded, failed, timed_out, or budget_stopped with transition timestamps
input	redacted recorded context and rendered prompt fingerprint/content according to retention policy
routing	requested provider/model/policy and resolved execution target
output	sanitized model output and structured triage result
accounting	input/output/total tokens, cost, and runtime when available
terminal error	normalized code/message for failure, timeout, and budget stop

Assumptions, Risks, Uncertainties

aru_id	type	statement	mitigation	status
ARU-001	risk	X-OmniRoute-Mode may not be a consumed routing-policy input in the chat route	trace the policy contract and test an observable policy effect	open
ARU-002	risk	current catch maps all thrown execution errors to HTTP 400 and does not persist them	introduce typed terminal outcomes and persistence before response mapping	open
ARU-003	risk	current audit row is emitted before execution and cannot represent final execution state	replace/extend with append-only lifecycle records or durable run storage	open
ARU-004	uncertainty	provider response metadata may differ by adapter	normalize accounting fields and preserve unknowns explicitly	open

🏠 Home

🌍 Languages (40+)

---

🚀 Getting Started

• Setup Guide
• User Guide
• Features
• Quick Start (Docker)
• Electron Desktop App
• Termux (Android)
• PWA Guide

🌐 Providers

• Provider Reference
• All Providers
• Free Tiers
• Kiro Setup

🎯 Routing & Combos

• Auto-Combo
• Reasoning Replay

🗜️ Compression

• Compression Guide
• Compression Engines
• RTK Compression
• Language Packs
• Rules Format

🔌 Integrations

• MCP Server
• A2A Server
• Agent Protocols
• OpenCode Plugin
• Webhooks
• Cloud Agents
• Skills
• Memory
• Evals
• Gamification

🏗️ Architecture

• Architecture Overview
• Codebase Documentation
• Repository Map
• Authorization Guide
• Resilience Guide

🔒 Security

• Guardrails
• Compliance
• Error Sanitization
• Public Credentials
• Route Guard Tiers
• Stealth Guide
• CLI Token Auth

📋 Reference

• API Reference
• CLI Tools
• Environment Variables

🚀 Operations

• VM Deployment
• Fly.io Deployment
• Tunnels Guide
• Proxy Guide
• SQLite Runtime
• Coverage Plan
• Release Checklist

ℹ️ More

• Troubleshooting
• i18n / Translations
• Uninstall
• Contributing
• Comparison vs Alternatives

OmniRoute · Website · npm · Docker Hub