Update dashboard-managed cloud dev environment (Docker 28.x pin)

[ChimdumebiNebolisa]

Summary

Refreshes and validates the dashboard-managed (snapshot) Cloud Agent development environment end to end, and documents one critical, non-obvious caveat discovered during setup.

The only committed change is a doc update to AGENTS.md; the rest of the work is environment/snapshot state (Docker install, Postgres container) plus the recorded update script.

Key finding: Docker must be pinned to 28.x

Installing the latest Docker (29.x) broke all API/Worker Testcontainers integration tests:

UnixSocketClientProviderStrategy: failed with exception BadRequestException
(Status 400: client version 1.32 is too old. Minimum supported API version is 1.40 ...)

Testcontainers 1.20.4's bundled docker-java negotiates API 1.32, but Docker Engine 29 raised its daemon minimum API to 1.40. Pinning docker-ce/docker-ce-cli to 5:28.5.2-1~ubuntu.24.04~noble (min API 1.24) resolves it with no code or env-var changes. This is now documented in AGENTS.md.

Environment changes (baked into snapshot)

• Installed Docker 28.5.2 (fuse-overlayfs storage driver, iptables-legacy) and started the daemon.
• Created the backline-postgres container (postgres:16-alpine, matches .env / compose).
• Warmed Gradle deps and installed site npm deps + Playwright Chromium.

Update script (dependency refresh only)

npm --prefix site ci
npm --prefix site exec -- playwright install chromium

Docker/Postgres are service-startup concerns (kept out of the update script) and are documented in AGENTS.md. Gradle downloads its deps on build.

Validation

Backline (Java/Gradle):

• ./gradlew clean check — BUILD SUCCESSFUL (all modules, Testcontainers integration tests, JaCoCo coverage floors).
• scripts/check-guardrails.sh and scripts/check-contract-drift.sh — passed.
• Ran API (8080), Worker, Sample API (8081) — all healthy.
• End-to-end CLI: backline doctor → run → history → diff → report. Run went QUEUED → RUNNING → FAILED (expected: demo config includes an intentionally broken endpoint); the ledger recorded 4 checks (3 passed, 1 STATUS_MISMATCH 500 vs 200) and generated a Markdown report.

Site (site/):

• npm ci, typecheck, lint, test (5 pass), build, and Playwright browser:test (8 pass) — all green.

Live API (Swagger UI)

backline_api_swagger_ui_demo.mp4

Swagger UI endpoints

_{To show artifacts inline, enable in settings.}

  

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
backline-site	Ready	Preview	Aug 2, 2026 5:00am