Documentation Home
Reading order, maintenance rules, and translation policy.
Documentation
Eva-CLI Documentation
Start with the English default entry, and use the Simplified Chinese docs for the current full-detail architecture specifications.
Documentation
Default English entries and detailed Chinese sources
Architecture Overview
The current code map for system boundaries, implemented runtime paths, state ownership, safety rules, and production blockers.
Module Partitioning
The 20-crate workspace map: direct dependencies, runtime handoffs, state ownership, and side-effect boundaries.
Single-Process Rust, Lua, and EventBus Runtime
The implemented synchronous Topic delivery, Lua 5.4, basic-loop, and foreground daemon boundaries.
Lua External Agent Adapter
How Lua Agents invoke external capabilities through Rust-controlled adapters.
Lua Skill, MCP, and Tool Hot Reload
How Lua-hosted capabilities update safely through generation switching.
Skill Implementation Plan
The concrete Skill implementation model: classification, manifests, runtime gates, invocation, and verification.
Agent Memory and Knowledge Base
Memory ownership, context building, and knowledge retrieval boundaries.
Agent Discovery
Discovery, normalization, validation, and registration rules.
Hardware Hotplug
Controlled hardware adapter access and hotplug event handling.
Project Configuration
The landed configuration layout, flat Agent storage model, schema validation, policy, and hot reload limits.
IDEA Plugin Toolchain
Developer tooling requirements for project indexing, Lua Agent editing, manifest validation, Runtime Bridge commands, dry runs, traces, and policy diagnostics.
Process-Level Upgrade
Supervisor, Runtime generations, draining, rollback, and durable recovery.
Backup, Migration, and Release Snapshots
Runtime-owned safety capabilities for backups, migration packages, release snapshots, restores, rollback, and artifact audit.
Eva-CLI User Manual
An SVG-illustrated source user manual covering installation, command surface, JSON output, exit codes, troubleshooting, and current non-goals.
V1.x Incomplete Feature Inventory
A code-backed snapshot of implemented boundaries, remaining production gaps, external blockers, and verification evidence.
V1.x Real Runtime Implementation Plan
Tracks 123 W0-W10 logic-level changes with stable IDs, prerequisites, owning boundaries, and testable evidence; the current snapshot is 49 Done, 6 In verification, and 68 Blocked.
Project Release Plan
The current tag workflow, three-platform verification, GHCR, Actions artifacts, evidence gates, Release records, and failure policy.
Version Management Plan
Cargo and tag forms, enforced file checks, operator policy, immutable identities, and the current main/tag divergence.
GitHub Packages Publishing
The implemented GHCR sequence, tag and digest rules, Buildx evidence, consumer verification, and post-push failure boundary.
V1.0 Capability Boundary (Historical)
The historical V1.0 source milestone boundary; no matching V1.0 Git tag or GitHub Release exists.
V1.0.0 Source Checkpoint
A historical source checkpoint for the early in-memory core, with no matching Git tag or GitHub Release.
V1.5 Release Hardening (Historical)
The v1.5.0 release command surface and the limits of compiled declarations, fixtures, optional evidence, and executed checks.
V1.5 Migration Declaration (Historical)
A historical V1.4 internal-milestone to v1.5.0 migration declaration; release migration is not an automated diff.
V1.5 Compatibility Policy (Historical)
Historical v1.5.0 compatibility commitments and the difference between policy, code contracts, and test coverage.
V1.11.5 Alpha Tag Notes
The tagged emit, Agent, and capability checkpoint; its Ubuntu verification failed and no GitHub Release was created.
V1.11.4 Alpha Release Notes
The alpha prerelease that fixes version metadata on the CLI module split checkpoint, adds release notes, and aligns release readiness evidence with the V1.11.4 tag.
V1.7.4 Alpha Release Notes
The alpha prerelease that adds Lua shadow-load health checks, generation route gating, drain evidence, rollback audit evidence, and the Lua hot-reload lifecycle release gate.
V1.7.3 Alpha Release Notes
The alpha prerelease that adds Lua wall-clock timeout, instruction budget, cancellation token, memory budget, and the Lua resource limits release gate.
V1.7.2 Alpha Release Notes
The alpha prerelease that adds read-only Lua ctx tables, host log/audit observations, ctx.tools.call capability binding, and the Lua host bindings release gate.
V1.7.1 Alpha Release Notes
The alpha prerelease that adds the restricted Lua VM execution boundary, on_event(ctx) execution, stable Lua error mapping, and the Lua VM release gate.
V1.6.5 Alpha Release Notes
The alpha prerelease that adds durable backend diagnostics, inspect.durable JSON output, pending redrive counts, and CI/release smoke coverage.
V1.6.4 Alpha Release Notes
The alpha prerelease that adds runtime recovery scanning, ack-safe event redrive, durable recovery audit records, and the recovery release gate.
V1.6.3 Alpha Release Notes
The alpha prerelease that adds durable task snapshots, durable audit records, and artifact metadata hardening.
V1.6.2 Alpha Release Notes
The alpha prerelease that adds filesystem EventLog, DurableEventBus, queryable dead-letter storage, and durable redrive evidence.
V1.6.1 Alpha Release Notes
The alpha prerelease that starts the durable runtime/storage line with the backend manifest, layout, and migration-lock baseline.
V1.5.1 Release Notes
The patch release that enables GHCR package publication without breaking V1.5 CLI, config, JSON, or documentation path contracts.
V1.5.0 Release Notes
The release-hardening checkpoint, new release commands, stabilized contracts, and explicit non-goals.
V1.5.0 Release Acceptance (Historical)
The immutable v1.5.0 tag, captured 2026-07-06 evidence, Release record, and source-release boundary.
Website and Documentation i18n
Current locale ownership, manifest, document lifecycle, localized assets, build, validation, and publishing rules.