chore(env): add Cloud Agent development environment for dyro

[Dandre126]

Summary

Adds a reproducible Cursor Cloud Agent development environment for DyroEngineeringFlow (dyro). Previously there was no .cursor/environment.json, so agents started with no uv toolchain.

This is a repository-managed environment: once merged to main, future Cloud Agents automatically pick up .cursor/environment.json (highest-precedence config source) — no dashboard Save required.

What's included

• .cursor/environment.json — minimal repo-managed environment (name + install).
• .cursor/install.sh — an idempotent bootstrap that:
  1. installs the uv package/environment manager (once, into ~/.local/bin, already on the login PATH),
  2. provisions a uv-managed CPython 3.12 so venv creation and python -m build isolation don't depend on the base image shipping python3.x-venv,
  3. runs uv lock --check then uv sync --locked --all-extras --dev (installs the project plus ruff/build/twine),
  4. installs the examples/typescript-runner interop deps via npm ci when Node is present.

Mirrors the toolchain in .github/workflows/ci.yml (uv + locked sync). No dev servers, tests, or migrations run in install, so it terminates quickly and stays idempotent.

Validation

On the setup VM

Check	Result
uv lock --check	Passed (37 packages, no drift)
uv sync --locked --all-extras --dev	Passed (managed CPython 3.12.14)
uv run ruff check src tests experiments	All checks passed
uv run python -m unittest discover -s tests -t .	925 tests OK
uv run python -m compileall -q src tests experiments	Passed
uv run python -m build + clean-venv wheel smoke	Wheel + sdist built; imports/assets/dyro dispatch doctor/bundle-stranger verify OK
dyro --version	dyro 0.7.7
TypeScript interop (npm ci && npm test)	1/1 pass (canonical bytes + Ed25519 signature match Python)
dyro console local dashboard	Loads, secure local session established, workspace shown healthy, detail view opens (see demo video)
Install idempotence	Ran twice; sub-second second run; no lockfile changes

Prebuilt environment build + fresh Cloud Agent

A draft build was created from this branch on a READY VM snapshot and SUCCEEDED; a fresh Cloud Agent booted from that exact build id passed 12/12 read-only checks (uv 0.12.5, dyro 0.7.7, managed CPython 3.12.14, uv sync --locked made no changes, ruff/compile clean, dyro dispatch --dry-run doctor JSON, TS interop test pass).

Demo

dyro_console_dashboard_demo.mp4

Activation

Merging this PR activates the environment for future Cloud Agents (repo-managed config takes precedence over dashboard settings).

_{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)
dyro	Error		Aug 20, 2026 4:22pm
dyro-engineering-flow	Error		Aug 20, 2026 4:22pm