Description
Provision Codex cloud tasks and Claude Code cloud sessions with the repository development dependencies and Backlog.md CLI so agents can follow the project task workflow and run its required test and validation commands.
Acceptance Criteria
- #1 scripts/cloud-environment-setup.sh begins with guidance that non-cloud local agents must not run it
- #2 The script installs Backlog.md and verifies its CLI is available
- #3 The script installs the project Python dependencies and tooling required by make lint, make test, and make validate
- #4 The setup is idempotent and suitable for both Codex and Claude Code cloud setup-script execution
Definition of Done
- #1 make lint
- #2 make test
Implementation Plan
- Add a guarded, fail-fast Bash setup script that resolves the repository root and supports root or passwordless-sudo cloud images.
- Install required Ubuntu system packages, uv, the pinned Backlog.md CLI, pre-commit, and frozen project dependencies with idempotent commands.
- Validate shell syntax, tool availability, and the project lint/test gates; document and commit the result.
Implementation Notes
Added the executable cloud-only setup script with Ubuntu packages, uv-managed locked dependencies, pre-commit, and pinned Backlog.md installation. Kept pre-commit outside pyproject.toml because it is environment bootstrap tooling and changing the lock with the locally available uv release introduced unrelated lockfile churn.
Validation passed: bash -n, executable/content assertions, git diff –check, make lint, and make test (687 passed, 82.84% coverage). The provisioning script itself was intentionally not executed by this non-cloud agent, as required by its local-agent guard comment.
Follow-up fix: replaced the comment-only local-agent guard with a real enforced check (script now exits unless MERAKI_DASHBOARD_HA_CLOUD_SETUP=1 is set), and replaced the unpinned ‘curl | sh’ uv installer with a pinned release tarball download verified against its published SHA-256 checksum before install.
Final Summary
Added an executable Codex/Claude cloud setup script that installs Ubuntu build/runtime packages, uv and locked project dependencies, pre-commit, and Backlog.md 1.50.1. Verified syntax and required setup behavior statically, plus passed the full project lint and test gates (687 tests).