Documentation
Understand the workflow, then trust the evidence.
Installation, workflow, architecture, validation, provider behavior, model control, observability, and reference material for the current public beta.
Start
Getting started
Install DynosAI, configure a provider, initialize a project, and run your first governed workflow.
User guide
The day-to-day DynosAI workflow, commands, scope changes, recovery, and greenfield/brownfield usage.
Studio
Use the guided project hub, project-scoped workflow, approvals, checks, themes and multilingual interface.
Core concepts
Quality and validation
Exactly what DynosAI verifies, how validation profiles work, and what Quality 100 does—and does not—mean.
Compatibility
What DynosAI 1.0 freezes: MCP names, public CLI, schema v6, App Server scope, human gates and optional harness features.
Threat model
Enforced vs not-enforced 1.0 controls, including the honest local-browser and loopback surface.
Architecture
Authority boundaries, workflow state, Git, MCP, memory, verification, and the local-first runtime model.
Model control
Phase-aware budgets, complexity signals, failure classification, route lifecycle, and predictive shadow mode.
Brownfield workflows
How DynosAI indexes existing code and builds an evidence-backed inferred baseline without inventing business truth.
Operations
Providers
Codex and Cursor integration, managed runtime behavior, and transport compatibility decisions.
Observability
MCP telemetry, tokens, context strategy, validation evidence, routing decisions, retries, and audit events.
Testing strategy
The deterministic, migration, provider-native, real-provider, Oracle, wheel, and replay validation layers.
Reference
Project
Project evolution
How DynosAI evolved from persistent workflow state to provider-certified governance.
1.0.0-rc.10 release notes
Governed session continuity. Bounded multi-turn Codex trials in one provider session. Cursor remains Preview. Not production-ready 1.0.
1.0.0-rc.9 release notes
Codex MCP observability. App Server preflight without model turns. Opaque _meta no longer aborts a 2025 session. Not production-ready 1.0.
1.0.0-rc.8 release notes
Provider runtime portability. User-local workspaces, Codex temp-home abort, candidate identity gate. Not production-ready 1.0.
1.0.0-rc.7 release notes
Certification integrity and protocol correctness. Release archive safety, MCP 2026 strict metadata/MRTR, MATRIX runner honesty. Not production-ready 1.0.
1.0.0-rc.6 release notes
Standards and release evidence: MCP 2026 compatibility, unified release gate, eval corpus and distribution ADR. Not production-ready 1.0.
1.0.0-rc.5 release notes
Freeze: threat model, contribution/certification process and loopback honesty. External PRs stay closed. Not production-ready 1.0.
1.0.0-rc.4 release notes
Installation: Studio doctor, verified local wheel, installed-package CI and 0.19.0 upgrade preservation. Not production-ready 1.0.
1.0.0-rc.3 release notes
Eval maturity: acceptance ZIP importer, governed-change cost aggregates and a stable authority prefix. Not production-ready 1.0.
1.0.0-rc.2 release notes
Certification evidence: MATRIX_1.0 not_run cells and two-session lease proof. Historical 0.13 scores are not copied.
1.0.0-rc.1 release notes
Contract freeze: frozen MCP names, optional harness switches, shared release-gate policy. Not production-ready 1.0.
0.19.0 release notes
Ecosystem: capability manifests for Cursor ACP and Codex app-server; uncertified clients and packs refused.
0.18.0 release notes
Secure Autonomous Runtime: Strict/Balanced/Autonomous profiles, runtime-only vault and policy evidence without OS network interception.
0.17.0 release notes
Eval Intelligence: failure attribution, local-trace mining, inbox-only improvement loop and offline regression evidence.
0.16.0 release notes
Governed Agent Teams: DAG waves, file-disjoint leases, claim/fan-in and no extra provider spawn.
0.15.0 release notes
Verified Agent Harness: context handles, ExecutionRuntime, validation integrity, eval registry v0 and execution policy.
0.14.1 release notes
Guided Studio UX refresh: setup, reviews, themes, project checks, help and compatibility boundaries.
0.14.0 release notes
Install, validate and understand compatibility and limitations of the Control Plane & Studio Alpha release.
Code quality
Maintainability review, current module and LOC metrics, hotspots, and characterization-before-extract policy.
ADR: PyPI distribution name
Use dynosai on PyPI, keep the dynosai_flow import, and keep MCP serverInfo as dynosai-flow.
ADR: Agent Plugins
Future plugins follow the portable Agent Plugins spec with a com.dynosai extension. No DynosAI Pack format.
ADR: MCP protocol eras
Support 2026-07-28 plus 2025-11-25 and 2025-06-18 on stdio. Official HTTP conformance is not pretended.
Release process
Versioning, changelog discipline, tests, acceptance matrices, and release-candidate and promotion policy.
Security
Security policy, responsible reporting, and project security boundaries.
Contributing
Maintainer development, release gate and certified-provider process. External pull requests are not currently accepted.
Roadmap
The product roadmap from Local Studio through harness loops, governed agent teams, eval intelligence, secure runtime and 1.0.
Changelog
Release-by-release evolution, fixes, compatibility work, validation, and release and promotion history.