@lark-apaas/coding-steering 0.1.53 → 0.1.54-alpha.20260918074819

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@lark-apaas/coding-steering",
-  "version": "0.1.53",
+  "version": "0.1.54-alpha.20260918074819",
   "description": "Stack-specific steering content for miaoda-coding templates",
   "type": "module",
   "files": [
     "steering"
   ],
+  "scripts": {
+    "lint:md": "markdownlint 'steering/**/*.md' --ignore 'steering/**/skills/**' --ignore 'steering/**/skills_common/**' --ignore 'steering/**/skills_local/**'"
+  },
   "devDependencies": {
     "markdownlint-cli": "^0.47.0"
   },
@@ -17,8 +20,5 @@
     "miaoda",
     "coding-steering"
   ],
-  "license": "MIT",
-  "scripts": {
-    "lint:md": "markdownlint 'steering/**/*.md' --ignore 'steering/**/skills/**' --ignore 'steering/**/skills_common/**' --ignore 'steering/**/skills_local/**'"
-  }
-}
+  "license": "MIT"
+}

package/steering/nestjs-react-fullstack/skills/coding-guide/SKILL.md

@@ -359,15 +359,7 @@ await db.select().from(users).where(eq(users.adminUser, userId));
   | 按月 / 按天筛 date、timestamptz | 半开区间 `and(gte(col, "2026-08-01"), lt(col, "2026-09-01"))`；日期列不能用 `like(col, "2026-08%")` |
   | 数字列过滤（`@Query` 取到的是 string） | 先 `Number(q)` 再进 `eq` |
 
-- **区分 Drizzle helper 与原生 SQL `COUNT()`**：当前模板的 `drizzle-orm@0.44.6` 中，`count()` helper 返回 `number`；原生 SQL `COUNT()` 返回 PostgreSQL `bigint`，驱动结果可能是 `string`。需要保留超过 `Number.MAX_SAFE_INTEGER` 的精确值时，使用 `BigInt` 或保留字符串，不要转成 `Number`。
-
-  ```typescript
-  const [{ total }] = await db.select({ total: count() }).from(users); // total: number
-
-  const rawTotal = '9007199254740993';
-  const exactTotal = BigInt(rawTotal); // ✅ 9007199254740993n
-  const unsafeTotal = Number(rawTotal); // ❌ 9007199254740992，精度丢失
-  ```
+- **`count()` 返回 string**（PostgreSQL bigint）。
 
 - **UUID 多值过滤不要直接插值数组到 `ANY(...::uuid[])`**：在 sql 模板中直接插入 ids 这类 JS 数组，可能被展开成 `($1, $2, ...)::uuid[]`，运行时报 `42846: cannot cast type record to uuid[]`。
 

package/steering/nestjs-react-fullstack/skills_common/mcp-ui-guide/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: mcp-ui-guide
+description: "创建或修改 MCP Apps 的 TSX 界面、UI 检查配置及 shared 依赖时使用。Use when working on server/mcp/ui, MCP Apps UI, TypeScript or ESLint checks."
+steering: true
+steering-topic: mcp_ui_guide
+match-template-name: nestjs-react-fullstack
+---
+
+# MCP Apps UI 开发与检查
+
+UI 是独立浏览器代码，入口为 `server/mcp/ui/<entry>/index.html`，交互逻辑使用独立 TS/TSX 文件。Vite 预设将每个入口构建为单文件 HTML，由 MCP 资源读取。不要将 UI 引入 NestJS 模块，也不要引用 client 业务代码、服务端模块或 Node.js API；可引用不依赖应用 Provider/Router/登录态的 shared 模块。
+
+## 创建配置
+
+只有创建 UI 时才生成下列两个文件；没有 UI 的应用不生成。已有配置应保留并按需调整，不能覆盖用户自定义规则。主工程 tsconfig.node.json 应排除 `server/mcp/ui`，原有 exclude 与继承语义必须保留；主工程 ESLint 排除由平台预设提供。不要为 UI 修改根目录 npm 检查命令或 scripts/lint.js。
+
+`server/mcp/ui/tsconfig.json`：
+
+```json
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "types": [],
+    "strict": true,
+    "allowJs": true,
+    "checkJs": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "baseUrl": "../../..",
+    "paths": { "@shared/*": ["shared/*"] }
+  },
+  "include": ["./**/*"],
+  "exclude": ["node_modules", "dist", "eslint.config.cjs"]
+}
+```
+
+`server/mcp/ui/eslint.config.cjs`：
+
+```js
+module.exports = require('@lark-apaas/fullstack-presets/lib/mcp/eslint-ui');
+```
+
+## 修改后必须执行
+
+从工程根目录依次运行；修改 UI 使用的 shared 模块时也必须运行：
+
+```bash
+npx --no-install tsc --noEmit --project server/mcp/ui/tsconfig.json
+npx --no-install eslint --config server/mcp/ui/eslint.config.cjs "server/mcp/ui/**/*.{ts,tsx,js,jsx}" --max-warnings 0
+npm run build:prod
+```
+
+检查命令退出码；失败必须修复并重新运行，不能通过关闭规则、增加 ignore 或跳过检查交付。确认 `dist/mcp-ui/<entry>.html` 已生成，继续在 MCP 宿主中验证资源加载、工具结果展示和交互。主工程 lint 通过不代表 UI 检查通过，构建成功也不代表类型检查通过。
+
+旧版平台提供的 type:check:mcp-ui / eslint:mcp-ui 聚合或辅助脚本已弃用；使用上面的标准命令，无需新建辅助脚本。已有用户自定义检查命令可以保留。

package/steering/nestjs-react-fullstack/skills_local/coding-guide/SKILL.md

@@ -316,15 +316,7 @@ await db.select().from(users).where(eq(users.adminUser, userId));
 
 ### 使用侧边界陷阱
 
-- **区分 Drizzle helper 与原生 SQL `COUNT()`**：当前模板的 `drizzle-orm@0.44.6` 中，`count()` helper 返回 `number`；原生 SQL `COUNT()` 返回 PostgreSQL `bigint`，驱动结果可能是 `string`。需要保留超过 `Number.MAX_SAFE_INTEGER` 的精确值时，使用 `BigInt` 或保留字符串，不要转成 `Number`。
-
-  ```typescript
-  const [{ total }] = await db.select({ total: count() }).from(users); // total: number
-
-  const rawTotal = '9007199254740993';
-  const exactTotal = BigInt(rawTotal); // ✅ 9007199254740993n
-  const unsafeTotal = Number(rawTotal); // ❌ 9007199254740992，精度丢失
-  ```
+- **`count()` 返回 string**（PostgreSQL bigint）。
 
 - **UUID 列 `inArray` 必须显式 `::uuid[]`**：标准 `inArray(col, ids)` 会运行时报 `42809: op ANY/ALL (array) requires array on right side`。