Ota v1.6.16 Now available
v1.6.16 makes version identity machine-readable, strengthens minimum-version enforcement, and improves agent-safe contract boundaries.
Idea
v1.6.16 is a contract-truth release.
Across real repos, two recurring risks showed up: machines could not always distinguish binary identity from capability support, and readiness signals could drift across command surfaces or selected execution paths. That creates uncertainty for maintainers and unsafe assumptions for agents.
This release focuses on one principle: contracts should fail early, report clearly, and keep provenance explicit.
Feature
v1.6.16 ships core improvements around identity, compatibility, and boundary safety:
- Machine-readable build identity:
ota --version --jsonnow returns stable provenance fields (semver,source_build,commit,dirty),schema_version, and additivecontract_capabilities[]. - Compatibility-locked version JSON: the version output is now formalized with a published schema and conformance coverage.
- Minimum-version enforcement at load time across command surfaces: contracts fail early on stale binaries, not only during
validate. - Feature-first compatibility diagnostics: minimum-version failures now explain contract minimum, current binary identity, unsupported feature (when known), and next recovery step.
- Unified preview verdict semantics:
doctor,ota run --dry-run, andota up --dry-runnow share centralized status behavior and consistentpreview_statusoutput. - Stronger agent boundaries: duplicate path overlap between
agent.writable_pathsandagent.protected_pathsis rejected; task side effects (writes,network,external_state) are surfaced and validated for safer execution. - Better selected-path determinism: scoped requirements, toolchain scoping, runtime probing, and readiness wait budgets now behave more accurately on the selected workflow path.
This is a reliability release. It reduces hidden assumptions and gives both humans and agents a clearer proof lane from contract to execution.
Docs
If you want to adopt these capabilities directly, use these docs:
- Get Started: Install Ota and verify with
ota doctor. - Contract reference: Contract (
metadata.ota.minimum_version,agent,tasks, scoped requirements). - Command reference: Commands (
ota --version --json,ota doctor,ota run --dry-run,ota up --dry-run). - JSON validation: JSON output for machine-readable command contracts.
Release
v1.6.16 is live here: https://ota.run/releases/v1.6.16
If you already run Ota, verify quickly:
ota --version --jsonota validateota doctorota run <task> --dry-run --jsonIf your repo enforces minimum versions, this release gives you clearer capability diagnostics and safer boundary behavior for automated execution.
Take action