Skip to content

docs: add Cursor Cloud environment setup notes to AGENTS.md#557

Draft
nahime0 wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-18e0
Draft

docs: add Cursor Cloud environment setup notes to AGENTS.md#557
nahime0 wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-18e0

Conversation

@nahime0

@nahime0 nahime0 commented Jul 17, 2026

Copy link
Copy Markdown
Member

What

Sets up and verifies the Cloud Agent development environment for elephc (PHP-to-native compiler in Rust) and records durable, non-obvious cloud caveats in AGENTS.md.

Environment setup

  • Installed Rust 1.95.0 (CI-pinned in .github/docker/ci.Dockerfile) and set it as the rustup default (base image had 1.83.0).
  • Installed missing system libraries: libbz2-dev, libssl-dev (bridge-crate deps). as/ld/gcc already present.
  • Installed cargo-nextest 0.9.140 (used by CI and referenced in AGENTS.md).
  • Update script: cargo build — rebuilds the compiler and materializes the bridge libelephc_*.a staticlibs.

Verification (end-to-end)

  • Clean cargo build (zero warnings).
  • Compiled and ran examples/fizzbuzz/main.php → native binary produces correct output.
  • Focused test passed: cargo test --test codegen_tests fizzbuzz.

elephc_env_verification.log

Changes

  • AGENTS.md: added a ## Cursor Cloud specific instructions section (toolchain pinning, host as/gcc benign linker warnings, php not installed, Docker cross-test scripts unavailable, quick sanity check).

No source code changed.

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

Co-authored-by: Vincenzo Petrucci <nahime0@users.noreply.github.com>
@github-actions github-actions Bot added area:docs Touches documentation without changing code. size:xs Very small pull request. type:docs Changes documentation only. labels Jul 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Touches documentation without changing code. size:xs Very small pull request. type:docs Changes documentation only.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants