Set up Cursor Cloud dev environment

[veillette]

Summary

Sets up the development environment for OpticsLab (client-only SceneryStack geometric optics simulation) for Cursor Cloud agents, and verifies it works end-to-end.

• Adds AGENTS.md with a ## Cursor Cloud specific instructions section capturing durable, non-obvious startup/run caveats (dev server usage, slow Vitest suite, git hooks, optional icon generation).
• Update script configured as npm ci (minimal dependency refresh on VM startup).

Verification

All standard commands were run successfully in the cloud VM:

Step	Command	Result
Install	npm ci	494 packages, OK
Lint	npm run lint	Checked 168 files, no issues
Type check	npm run check	Passed (3 tsconfig targets)
Tests	npm test	413 passed (4 files)
Build	npm run build	Built dist/ OK
Dev server	npm start	Vite on http://localhost:5173, HTTP 200

Hello-world task

Built a scene on the Lab screen: added a light beam, then a spherical lens in its path. The ray-tracing engine responded in real time — parallel rays converge through the lens to a focal point.

opticslab_lab_ray_tracing_demo.mp4

Rays converging through a spherical lens

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

  

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

[veillette]

Good

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.