Changelog

!!! info “Versioning policy” Docs versions mirror code tags via mike. See Versioning.

v1.0.0 — 2026-04-01

Added

  • autonomy demo policy — in-process policy governance demo (no Docker or control plane required).

  • autonomy run <cmd> [args...] — subprocess supervisor: starts in-process policy runtime, injects AUTONOMY_RUNTIME_URL, propagates subprocess exit codes.

  • autonomy status — advisory control plane reachability check; always exits 0 with actionable hints.

  • autonomy deploy — fleet deployment via HTTP with structured exit codes (2 = not configured, 3 = unreachable, 4 = service error).

  • autonomy config set/get orchestrator.url — persistent CLI configuration at ~/.config/autonomy/config.yaml.

  • edgectl init — standalone edge daemon config generator; produces a minimal valid edge.yaml with a randomly generated fleet salt.

  • Architectural invariant CI (ci/test_arch_invariant.sh): enforces zero root orchestrator imports in cmd/autonomy/commands/.

  • E2E CI scripts (ci/test_e2e_demo.sh, ci/test_e2e_run.sh) added to the mvp-acceptance matrix (4 → 7 scripts).

Changed

  • CLI command structure finalised: GETTING STARTED / FLEET / ADVANCED groups.

  • autonomy ha, autonomy rollout, and all fleet commands are top-level (not nested under autonomy orchestrator).

  • autonomy-orchestrator is a separate binary (cmd/autonomy-orchestrator/); it is not a CLI sub-command.

Fixed

  • autonomy policy load flag: --bundle (was incorrectly documented as --path in some guides).

  • autonomy runtime start flag: --listen (was incorrectly documented as --addr in some guides).

Unreleased (dev)

Added

  • Outbound relay lifecycle engine wiring in edged using persistent Bolt ledger: schedule, inflight CAS claim, ACK terminal state, failed/backoff retry, deadletter state with explicit operator recovery.

  • Startup relay recovery path: InflightToFailed, PruneMissing, and RescheduleReady before workers start.

  • OS-update survival precheck flow: fingerprint detect, manifest signature gate, typed reconstruction operations, boot-epoch advance, and epoch evidence rotation.

  • State-root validation and canonical on-disk path helpers in edge/stateroot.

  • Additional relay and reconstruction observability metrics and logs.

Changed

  • Capability naming is Edge-first (edge/, edged, edgectl).

  • Legacy swarm* compatibility surfaces are removed.

  • Release image names use canonical package names: adk-runtime, adk-orchestrator, adk-gui.

  • Docs IA reorganized by operator intent (#737). The four overlapping top-level groups (Getting Started / Tutorials / Runbooks / Demo) are restructured into audience-first entry points so each reader has one obvious starting place. CE-tier (Community Edition) versus Controlled Deployment (partner/customer, orchestrator-managed) paths are now distinguished in sidebar captions and on landing pages. No CLI commands, make demo-* targets, scripts, runtime behavior, or demo semantics changed — this is a pure information- architecture move.

    Sidebar caption map:

    Before

    After

    Getting Started

    Evaluate + Install & Run (split)

    Tutorials

    Tutorials (placement rule made explicit)

    Runbooks

    Runbooks (CE Operator + Controlled Deployment subgroups)

    Demo

    Demo Stack Reference (retitled)

    Moved-page map (for operators with bookmarks / cached links):

    Old path

    New path

    docs/demo-runbook.md

    docs/runbooks/demo-runbook.md

    “Quickstart” (sidebar label)

    “2-Minute CE Demo” (file path unchanged: docs/quickstart.md)

    “Demo” (sidebar caption)

    “Demo Stack Reference”

    Contributor placement guidance: see Contributing → Doc Placement for where new ADK doc pages belong on the audience-intent axis and the CE/Controlled distribution-mode axis.

Compatibility Notes

  • edged and edgectl are required; swarmd/swarmctl are not shipped.

  • Environment override prefix is EDGE_*.

  • relay.success_condition accepts only one_peer and all_peers.

  • edged precheck is required for the systemd startup path in provided templates.

Evidence

Code:

  • edge/cmd/edged/main.go

  • edge/relay/executor.go

  • edge/relay/recovery.go

  • edge/relay/boltledger.go

  • edge/bootstrap/bootstrap.go

  • edge/bootstrap/install.go

  • edge/stateroot/stateroot.go

  • edge/epoch/epoch.go

Tests:

  • edge/cmd/edged/precheck_test.go

  • edge/relay/executor_test.go

  • edge/relay/recovery_test.go

  • edge/relay/e2e_test.go

  • edge/bootstrap/install_test.go

  • edge/metrics/prometheus_test.go

CI/scripts:

  • .github/workflows/release.yml

  • scripts/release/build_binaries.sh

  • scripts/release/write_release_notes.sh

Captured outputs:

  • docs/_generated/test-outputs/edged-help.txt

  • docs/_generated/test-outputs/edgectl-help.txt

  • docs/_generated/test-outputs/edged-integration.txt

See Also