Set up development environment (AGENTS.md)

[manyxu]

Summary

Sets up a working local development environment for the MINNA IoT platform on Linux and documents the non-obvious gotchas for future agents. No application code is modified — only AGENTS.md is added.

What was set up

• Node.js 20.18.1 via nvm (repo-pinned). The VM's default node is v22 via /exec-daemon/node, so the nvm Node must be put on PATH to run the app.
• MongoDB 8.0 (--auth) on 127.0.0.1:27017 with the minna root user the app expects (mongodb://minna:minna1314@localhost:27017/minna?authSource=admin).
• Redis 7 on 127.0.0.1:6379.
• npm dependencies. package.json pins @discordjs/opus to github:discordjs/opus, which fails to compile on a fresh clone (missing opus submodule sources). Workaround: npm install --ignore-scripts then overlay the npm-published prebuilt @discordjs/opus@0.9.0 (--no-save, so package.json is untouched).

Verification

• npm start boots the Express server on :6700 plus plugin servers (ASR :8081/:8082, TTS :8083); Redis + MongoDB connect and the admin user (admin/admin) is auto-seeded.
• Login works end to end: curl "http://127.0.0.1:6700/users/login?username=admin&password=admin" returns {"code":0,...,"access_token":...}.
• GUI hello-world: logged in via the browser and exercised a core action (see PR walkthrough in the agent summary).

Notes

• No linter, test suite, or build step is configured (only npm script is start).
• MongoDB/Redis are stateful services and are intentionally NOT part of the update script; see AGENTS.md for how to start them each session.