docs: add AGENTS.md with Cursor Cloud dev environment notes#3
Draft
wangjk9527 wants to merge 2 commits into
Draft
docs: add AGENTS.md with Cursor Cloud dev environment notes#3wangjk9527 wants to merge 2 commits into
wangjk9527 wants to merge 2 commits into
Conversation
提供 deploy.sh 原生部署链路（configure/install/build/start/stop/doctor/tui）， 仅托管 Web + API；补齐无内置 DataLink 的 npm start / stack-runner。 语义 Data Link 改为外置 MCP 对接，deploy 不安装、不启动、不作健康门槛。 基于 main reset 后重提原 datagallery-lab#82。 Co-authored-by: wing <wangjk9527@users.noreply.github.com>
Co-authored-by: wing <wangjk9527@users.noreply.github.com>
wangjk9527
force-pushed
the
cursor/native-one-click-deployment-v2-f252
branch
from
July 26, 2026 07:16
7e2da5b to
1694cc7
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sets up and verifies the DataFoundry development environment for Cursor Cloud agents, and captures durable, non-obvious setup caveats in a new
AGENTS.md.The only committed change is
AGENTS.md(env files,node_modules,storage/,.venvare gitignored). The dependency-refresh step is handled by the environment update script (npm installunder nvm Node 22.22.2).Key finding
.npmrcsetsengine-strict=trueand a transitive dep (posthog-node) requires Node>= 22.22.0, but the VM defaultnodeisv22.14.0→npm installfails withEBADENGINE. The fix is to use the nvm-managed Node22.22.2(documented inAGENTS.mdand used by the update script).Verified in this environment
npm install(postinstalltsc -b)npm run buildnpm run test:webnpm run smoke:data-gatewaynpm run smoke:config-apinpm run smoke:authnpm run dev→ API :8787 + Web :3000Hello-world (core functionality)
Loaded the Web workbench (dev auth auto-login), opened the built-in DTC Growth Review SQLite datasource, and browsed its schema (5 tables + columns) via the Data Gateway — connection test, schema introspection, and read-only schema browsing all succeed without an LLM key.
datafoundry_workbench_schema_browse.mp4
Workbench home
DTC datasource schema (orders table)
To show artifacts inline, enable in settings.