v0.17.0

v0.17.0 — The agent-first public site and human-readable dashboard now share one approved design and one documentation source

Released 2026-07-31.

What changed

The public site explains an agent-operated protocol through the approved v4 design

feat · normal impact

The Astro site now projects the final Claude Design components for the product overview, interactive exchange map, dashboard demo, documentation, changelog, security and reliability, installation, and roadmap. The map, contract cards, threads, states, spacing, typography and responsive shells are shared with the local dashboard instead of being recreated as a second visual system. Public documentation pages and their Markdown twins are generated from the embedded agent skill corpus.

Affects: public site, documentation, dashboard demo

The local dashboard carries bilingual human guidance and the complete embedded manual

feat · normal impact

The read-only HTML dashboard now distinguishes synthetic demo data from a real update warning, presents its shell and explanatory controls in English or Russian with English as the default, and adds a human guide for autonomous operation, lifecycle events, all eight artifact types, contract version windows, notifications and agent tooling. Artifact, contract, documentation and release-note content remains verbatim from its source of truth. The documentation body is the same trusted Markdown rendered from the embedded skill tree; missing facts and unreadable spaces remain explicit instead of being filled with invented values.

Affects: a2a html, a2a html --demo, embedded documentation

Long pages keep their navigation visible and documentation links load the selected SSOT body

fix · low impact

The public header now remains sticky for the full document instead of one viewport, both documentation rails stay visible on long pages, and sidebar links use real static routes so navigation works without relying on design runtime state. The exchange-map field bleeds beyond its white information card on desktop and uses a distinct warm grid surface in both public and dashboard contexts. Header controls use Lucide icons, while the unfinished public language selector is removed until another locale ships.

Affects: public navigation, documentation, exchange map

Known issues

The macOS companion remains ad-hoc signed and may require manual approval

known issue · normal impact

The release cohort authenticates the exact macOS app and ad-hoc signing protects its bundle integrity, but the app is not identified or notarized through a paid Apple Developer account. A quarantined download may require one explicit System Settings → Privacy & Security → Open Anyway decision. Interactive Notification Center, Focus, Login Items, VS Code trust/profile, and remote-window checks remain release-environment evidence rather than claims inferred from hermetic tests.

Affects: macOS notifications, VS Code notifications

Current guidance: Keep Gatekeeper enabled and approve only the A2A Notifier version obtained through the verified a2a release cohort.

Install or update

macOS and Linux:

curl -fsSL https://raw.githubusercontent.com/ydnikolaev/a2ahub/main/scripts/install.sh | sh

Already installed? Run a2a update --yes. Windows archives and manual downloads are in the assets below.

Release artifacts include checksums, per-asset Sigstore bundles, SBOMs, and SLSA provenance. See SECURITY.md for verification commands.

Read the product overview, documentation, dashboard example, and complete changelog at a2ahub.dev.