ARIA v0.2.0 is a curated public preview of a contract-first agentic AI engineering platform. It refreshes the public architecture documentation through Phase 12 and publishes a small, reviewable replay-contract code slice without exposing private traces, credentials, run artifacts, or environment-specific runtime data.
This release is intentionally marked as a pre-release. It is designed for architecture review, portfolio evaluation, and contract inspection rather than production deployment.
- Refreshed public documentation for Phase 00 through Phase 12.
- Added a clearer README path for reviewers, including visual architecture previews and an animated runtime preview.
- Documented Phase 11 vendor integration boundaries for AIHawk, Skyvern, OpenAdapt, and browser-use.
- Documented Phase 12 platform consolidation: event-bus abstraction direction, replay contracts, deterministic trace hashing, and replay invariant tests.
- Published the public replay-contract code slice under
src/aria/core/replay. - Restored the public Job Apply model slice used by the v0.2 verification path.
- Kept private data and private research artifacts outside the public preview.
src/aria/core/replay/
├── __init__.py
└── trace.py
tests/unit/
└── test_replay_trace.py
The replay contract validates replay-critical invariants:
- every trace has an execution id,
- every meaningful step has a step id,
- terminal traces require
completed_at, - failed steps require an explicit
error, - step ids are unique inside a trace,
- trace hashes are deterministic for integrity checks.
Phase 11 documents how selected vendor projects can support ARIA without taking over platform ownership.
| Vendor | Public role |
|---|---|
| AIHawk | LinkedIn-oriented job application automation boundary |
| Skyvern | Vision-assisted form workflow boundary |
| OpenAdapt | Learn-by-demonstration and desktop recording boundary |
| browser-use | Browser automation fallback and pattern boundary |
Vendor integrations remain adapters. ARIA stays responsible for contracts, Safety, HITL, observability, and learning boundaries.
Phase 12 closes the first public architecture arc by publishing the first real contract slice for replay-safe traces:
TraceEnvelopeStepRecordReplayRequest- deterministic content hashing
- invariant tests for replay safety
This creates a public bridge toward later releases covering observability, artifact manifests, trust envelopes, MCP runtime selection, control-plane UI, and adaptive learning.
Verified locally on 2026-05-02 before release creation:
pytest tests/unit -q
# 96 passed
pytest tests/integration -q
# 27 passed, 7 skipped
ruff check src/aria/core/replay src/aria/plugins/job_apply/models \
tests/unit/test_replay_trace.py tests/unit/plugins/job_apply \
tests/integration/test_hand.py tests/integration/test_brain_graph.py \
--select E,F,I,ANN,UP,DTZ,TC,PLC,PLW
# All checks passed
The skipped integration tests are service-dependent paths that require external runtime services such as Redis or Redpanda in specific configurations.
Recommended review order:
- Start with
README.md. - Read
Docs/English/phases/README.mdfor the public phase map. - Read
Docs/English/phases/phase-11-vendor-integrations.md. - Read
Docs/English/phases/phase-12-platform-consolidation.md. - Inspect
src/aria/core/replay/trace.py. - Run
tests/unit/test_replay_trace.py.
This release intentionally excludes:
- private credentials and profiles,
- private run outputs and traces,
- environment-specific runtime data,
- large evidence artifacts,
- QLoRA experiments,
- advanced private planning and learning internals,
- full private frontend/control-plane work.
The public repository is meant to be readable, reviewable, and safe to evaluate.
This preview is not a stable production API release. The public replay contract slice is expected to evolve in later public releases as observability, artifact manifests, trust envelopes, MCP governance, and control-plane UI are published.
Rollback target before this release line:
v0.1.7