docs(agents): add Cursor Cloud dev-environment setup notes

[Tanya7z]

Summary

Sets up the SFMC development environment on the Cloud VM (Linux, Node v22.14.0) and documents durable, non-obvious setup/run caveats for future agents under a new ## Cursor Cloud specific instructions section in AGENTS.md. No application code was modified.

Environment setup performed

• npm install at repo root (npm workspaces monorepo) — set as the startup update script.
• npm run build --workspaces --if-present — builds @sfmc/sdk + all services (their dist/ is gitignored).
• Populated gitignored configs/ from configs-default/ and corrected db_config.json modulesDir ("../modules" → "modules") so the module API resolves the in-repo catalog.
• Started db-server (SFMC_ROOT=$PWD node db-server/dist/index.js, port 3001).

Verification

Item	Command	Result
Health	GET /api/health	{"status":"ok"}
Module catalog	GET /api/sfmc/modules/catalog	22 modules
Hello world (real write)	POST /api/sfmc/modules/feature-economy/{disable,enable}	enabled true→false→true, persisted to module-lock.json
CLI supervisor	node sfmc/dist/main.js status	service table rendered
Self-check	node tools/check-ootb.js	5/6 pass

Pre-existing issues found (not fixed — out of setup scope)

• tools/smoke-modules.js uses spawnSync without importing it → crashes.
• tools/sim-new-user.js spawns non-existent db-server/index.js (real entry is db-server/dist/index.js) → the sim-new-user OOTB check times out (hence 5/6).
• SQLite-backed gameplay routes (economy/lands/coops/…) throw near "?": syntax error (table names interpolated via sql-template-strings). JSON-backed module/config API + health work.
• npm run lint has no eslint.config.js (ESLint v10 flat-config); use per-workspace typecheck.

These are documented in AGENTS.md so future agents don't chase them during setup.

  

[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.

[cursor]

Risk: low. Cursor Bugbot was not present on this PR, so that signal was skipped. Documentation-only addition to AGENTS.md with no application code changes; approved. No reviewers assigned.

  

_{Sent by Cursor Approval Agent: Pull Request Router and Approver}