[PR #837] [MERGED] docs: note Cloud Agent Node.js toolchain #2275

New issue

Closed

opened 2026-10-16 21:16:38 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-16 21:16:38 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/morluto/rea/pull/837
Author: @morluto
Created: 10/7/2026
Status: ✅ Merged
Merged: 10/7/2026
Merged by: @morluto

Base: main ← Head: cursor/cloud-agent-node-787e

📝 Commits (1)

51539a5 docs: note Cloud Agent Node.js toolchain

📊 Changes

1 file changed (+6 additions, -0 deletions)

View changed files

📝 AGENTS.md (+6 -0)

📄 Description

Summary

Cloud Agents on the default image resolve an older Node.js before the version REA development requires. This note records the pinned Node.js 24.18.0 / npm 11.16.0 toolchain and which local workflows do not need Hopper, Ghidra, or IDA.

Problem and expected behavior

.nvmrc and packageManager pin Node.js 24.18.0 and npm 11.16.0. The Cloud Agent image exposes Node.js 22.14.0 earlier on PATH, which is outside engines.node. Future agents need a durable reminder of the installed toolchain and of the optional provider boundary.

Change and scope

Adds a short Cursor Cloud section to AGENTS.md. Environment install itself is configured outside the repository. Hopper, Ghidra, and IDA remain bring-your-own and are not installed by this change.

Contract and boundary impact

Semantic owner and earliest changed stage: documentation only
CLI and MCP/tool-catalog contract: none
Provider, bridge, target-format, or platform compatibility: none
Evidence, artifact, provenance, or reconstruction contract: none
Process execution, authorization, cleanup, or containment impact: none
Generated metadata (docs/product-catalog.json), package, or installation impact: none

Evidence and regression coverage

Tests added or updated: none
Base reproduction or other evidence: node -v on the default image printed v22.14.0 before the toolchain install
User-visible CLI/MCP output (if applicable): not applicable
Remaining proof gaps: none for this documentation note

Validation performed

npm ci — succeeded twice with Node.js 24.18.0 and npm 11.16.0
npm run build:cached — succeeded
npm run check:fast — succeeded
node scripts/rea.mjs doctor --json — host and Node checks healthy; Hopper, Ghidra, and IDA reported missing, as expected
node scripts/rea.mjs analyze-javascript-application on a local sample — returned JavaScript application evidence
npm run test:focused -- tests/composition/javascript-applications/electronApplicationAnalysis.test.ts — 4 tests passed
Fresh Cloud Agent on build bld-20261007-892976f8-d7d3-428e-a6bb-0140f4ea0ecc — Node v24.18.0 and npm 11.16.0 from /usr/local/bin, existing node_modules, npm run build:cached succeeded, JavaScript analysis found greet, and the same focused test passed 4/4

Compatibility, safety, and release

Breaking changes or migration steps: none
Real Hopper/Ghidra, browser, or OS coverage: not run; this change does not claim provider behavior
Package or release metadata impact: none
Security, privacy, process, or containment review: documentation only

Review checklist

The PR has one focused outcome and the title follows type(scope): outcome.
Related issue is linked, or the reason for not linking one is stated above.
Tests cover changed observable behavior and meaningful failure paths.
Owning docs, contracts, and generated metadata are updated where needed.
User-visible CLI/MCP changes include representative output.
I checked the final diff for secrets, unrelated cleanup, and unsupported claims.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/morluto/rea/pull/837 **Author:** [@morluto](https://github.com/morluto) **Created:** 10/7/2026 **Status:** ✅ Merged **Merged:** 10/7/2026 **Merged by:** [@morluto](https://github.com/morluto) **Base:** `main` ← **Head:** `cursor/cloud-agent-node-787e` --- ### 📝 Commits (1) - [`51539a5`](https://github.com/morluto/rea/commit/51539a53ffc80d96c576a662332fae18ba7302db) docs: note Cloud Agent Node.js toolchain ### 📊 Changes **1 file changed** (+6 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `AGENTS.md` (+6 -0) </details> ### 📄 Description  ## Summary Cloud Agents on the default image resolve an older Node.js before the version REA development requires. This note records the pinned Node.js 24.18.0 / npm 11.16.0 toolchain and which local workflows do not need Hopper, Ghidra, or IDA. ## Problem and expected behavior `.nvmrc` and `packageManager` pin Node.js 24.18.0 and npm 11.16.0. The Cloud Agent image exposes Node.js 22.14.0 earlier on `PATH`, which is outside `engines.node`. Future agents need a durable reminder of the installed toolchain and of the optional provider boundary. ## Change and scope Adds a short Cursor Cloud section to `AGENTS.md`. Environment install itself is configured outside the repository. Hopper, Ghidra, and IDA remain bring-your-own and are not installed by this change. ## Contract and boundary impact - Semantic owner and earliest changed stage: documentation only - CLI and MCP/tool-catalog contract: none - Provider, bridge, target-format, or platform compatibility: none - Evidence, artifact, provenance, or reconstruction contract: none - Process execution, authorization, cleanup, or containment impact: none - Generated metadata (`docs/product-catalog.json`), package, or installation impact: none ## Evidence and regression coverage - Tests added or updated: none - Base reproduction or other evidence: `node -v` on the default image printed `v22.14.0` before the toolchain install - User-visible CLI/MCP output (if applicable): not applicable - Remaining proof gaps: none for this documentation note ## Validation performed - `npm ci` — succeeded twice with Node.js 24.18.0 and npm 11.16.0 - `npm run build:cached` — succeeded - `npm run check:fast` — succeeded - `node scripts/rea.mjs doctor --json` — host and Node checks healthy; Hopper, Ghidra, and IDA reported missing, as expected - `node scripts/rea.mjs analyze-javascript-application` on a local sample — returned JavaScript application evidence - `npm run test:focused -- tests/composition/javascript-applications/electronApplicationAnalysis.test.ts` — 4 tests passed - Fresh Cloud Agent on build `bld-20261007-892976f8-d7d3-428e-a6bb-0140f4ea0ecc` — Node v24.18.0 and npm 11.16.0 from `/usr/local/bin`, existing `node_modules`, `npm run build:cached` succeeded, JavaScript analysis found `greet`, and the same focused test passed 4/4 ## Compatibility, safety, and release - Breaking changes or migration steps: none - Real Hopper/Ghidra, browser, or OS coverage: not run; this change does not claim provider behavior - Package or release metadata impact: none - Security, privacy, process, or containment review: documentation only ## Review checklist - [x] The PR has one focused outcome and the title follows `type(scope): outcome`. - [x] Related issue is linked, or the reason for not linking one is stated above. - [x] Tests cover changed observable behavior and meaningful failure paths. - [x] Owning docs, contracts, and generated metadata are updated where needed. - [x] User-visible CLI/MCP changes include representative output. - [x] I checked the final diff for secrets, unrelated cleanup, and unsupported claims.  <div><a href="https://cursor.com/agents/bc-6bfbee93-eb04-4eca-859f-81fc3995787e?cursor_ref=pr_footer&cursor_cta=open_in_web"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-web-light.png"><img alt="Open in Web" width="114" height="28" src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a> <a href="https://cursor.com/background-agent?bcId=bc-6bfbee93-eb04-4eca-859f-81fc3995787e&cursor_ref=pr_footer&cursor_cta=open_in_cursor"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-cursor-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-cursor-light.png"><img alt="Open in Cursor" width="131" height="28" src="https://cursor.com/assets/images/open-in-cursor-dark.png"></picture></a> </div> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-16 21:16:38 +00:00