Set up Cursor Cloud dev environment for docgen

[jmjava]

Summary

Sets up and verifies a full development environment for the docgen library/CLI in Cursor Cloud, and captures durable startup guidance for future agents.

The only code/repo change is an added ## Cursor Cloud specific instructions section in AGENTS.md. All environment provisioning is handled by the VM snapshot (system deps) + the startup update script (Python deps).

Environment

• System deps (baked into snapshot): ffmpeg, tesseract-ocr, plus build-essential, python3-dev, libcairo2-dev, libpango1.0-dev, pkg-config (required to build the manim extra).
• Update script (Python deps refresh):

  python3 -m venv .venv
  . .venv/bin/activate
  pip install -e ".[dev,manim]"
  

• Python 3.12.3; installs docgen editable with dev + manim extras.

Verification

Check	Command	Result
Lint	ruff check src/ tests/	All checks passed
Tests	pytest tests/ -v --tb=short	290 passed
CLI pipeline	docgen init → scene-compile → manim	Rendered a real 11.4s h264 MP4
Validation	docgen validate	Ran ffmpeg/tesseract-backed checks
Wizard UI	docgen wizard --port 8501	Flask dev server served interactive UI (HTTP 200)

Hello-world (offline CLI pipeline)

Scaffolded a scratch bundle, compiled a declarative scene spec, and rendered a real Manim video:

Rendered Manim frame

Wizard web UI

docgen_wizard_end_to_end.mp4

Notes

Standard commands live in README.md / pyproject.toml / CI. The new AGENTS.md section documents only non-obvious caveats (venv is not auto-activated, which commands are OpenAI-gated vs offline, the scene-compile wait_segment/timing.json dependency, and that docs/demos/ is a protected consumer bundle).

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