用途：用于构建 Nango 单仓库（monorepo）并验证 TypeScript 编译，适用于跨包改动后的构建与类型检查。Nango 使用 npm workspaces 与 TypeScript 项目引用（不使用 Turborepo/Nx），构建顺序由 tsconfig.build.json 的引用关系决定。
主要能力与用法：所有命令在仓库根目录运行。npm install 用于安装依赖并链接 workspace，在拉取新改动、切换分支或新建 worktree 后必须先执行，否则会出现类似代码问题的 Cannot find module 错误。npm run ts-build 执行全量 TypeScript 构建；npx tsc -p packages/server/tsconfig.build.json --noEmit 做单包类型检查；组合命令可先构建 packages/shared 再检查 server；出现陈旧报错时用 npm run ts-clean && npm run ts-build 清理重建。
依赖分层：核心层 types、utils、frontend 无内部依赖；基础设施层 database、kvstore、logs、keystore；服务层 shared、node-client、nango-yaml、runner、scheduler、orchestrator；应用层 server、webapp、connect-ui、cli。关键规则是 @nangohq/types 为仅声明类型包（emitDeclarationOnly: true），不能导出运行时值，运行时常量应放到 @nangohq/utils。
常见错误：模块找不到通常是依赖未安装或过时，先 npm install；无法解析 @nangohq/types 入口多因导入运行时值，应迁移到 utils；找不到 @nangohq/shared 说明依赖尚未构建，需全量构建；.tsbuildinfo 陈旧导致幽灵错误时执行 ts-clean 后重建。
新增 API 端点类型：在 packages/types/lib/ 对应子目录定义类型，从 packages/types/lib/index.ts 导出，并加入 packages/types/lib/api.endpoints.ts 的 APIEndpoints 联合类型，最后运行 npm run ts-build 验证。其他配置与支持平台暂未提供。