@h-ai/cli 0.1.0-alpha.48 → 0.1.0-alpha.49

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@h-ai/cli",
   "type": "module",
-  "version": "0.1.0-alpha.48",
+  "version": "0.1.0-alpha.49",
   "description": "Hai Framework CLI for project scaffolding and code generation.",
   "license": "Apache-2.0",
   "keywords": [
@@ -34,7 +34,7 @@
     "ora": "^9.1.0",
     "prompts": "^2.4.2",
     "yaml": "^2.7.0",
-    "@h-ai/core": "0.1.0-alpha.48"
+    "@h-ai/core": "0.1.0-alpha.49"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",

package/templates/base/package.json.hbs

@@ -1,6 +1,6 @@
 {
   "name": "{{projectName}}",
-  "version": "0.1.0-alpha.48",
+  "version": "0.1.0-alpha.49",
   "private": true,
   "description": "{{#if_eq appType 'admin'}}Enterprise management system built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'website'}}Enterprise website built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'h5'}}Mobile H5 app built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'api'}}REST API service built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'mobile-app'}}Mobile app built with hai Agent Framework{{/if_eq}}",
   "keywords": ["hai", {{#unless isSvelteOnlyApp}}"sveltekit", {{/unless}}"svelte5", "{{appType}}"],

package/templates/skills/hai-ai/SKILL.md

@@ -202,6 +202,7 @@ await ai.llm.ask('翻译这段话', { tempModel: { model: 'gpt-4o', apiKey: 'sk-
 
 ```ts
 import { createMcpServer, StreamableHTTPServerTransport } from '@h-ai/ai'
+import { core } from '@h-ai/core'
 
 const server = createMcpServer({ name: 'my-server', version: '1.0.0' })
 server.registerTool('search', {
@@ -211,7 +212,7 @@ server.registerTool('search', {
   content: [{ type: 'text', text: `Results for ${query}` }],
 }))
 
-await server.connect(new StreamableHTTPServerTransport({ sessionIdGenerator: crypto.randomUUID }))
+await server.connect(new StreamableHTTPServerTransport({ sessionIdGenerator: core.id.uuid }))
 ```
 
 ## 记忆、RAG 与知识库

package/templates/skills/hai-app-create/SKILL.md

@@ -233,7 +233,7 @@ export async function createArticle(input: CreateArticleInput): Promise<HaiResul
   logger.debug('Creating article', { title: input.title })
 
   const result = await reldb.crud.create('articles', {
-    id: crypto.randomUUID(),
+    id: core.id.uuid(),
     ...input,
     created_at: new Date().toISOString(),
   })

package/templates/skills/hai-core/SKILL.md

@@ -316,6 +316,14 @@ core.id.isValidUUID('f47ac10b-...')    // true/false
 core.id.isValidNanoId('abc123', 6)     // true/false
 ```
 
+#### UUID 生成规范（强制）
+
+- 生成 UUID **一律用 `core.id.uuid()`**，禁止裸调 `crypto.randomUUID()`。
+- 原因：`crypto.randomUUID` 仅在**安全上下文（HTTPS / localhost）**下可用，生产 http 环境会抛
+  `crypto.randomUUID is not a function`；`core.id.uuid()` 已做 `randomUUID → getRandomValues → Math.random` 三级兜底，Node.js 与浏览器通用。
+- 需要不带横线的 compact 形式：`core.id.uuid().replaceAll('-', '')`。
+- 代码评审与新建代码时以此为准，发现裸调 `crypto.randomUUID()` 一律改走 `core.id.uuid()`。
+
 ### 工具函数
 
 #### 类型检查 — `core.typeUtils`

package/templates/skills/hai-reldb/SKILL.md

@@ -307,7 +307,7 @@ class UserRepository extends BaseReldbCrudRepository<User> {
 **自动能力**：
 
 - `createdAt` / `updatedAt` 字段自动填充时间戳
-- 主键生成（非 autoIncrement 主键默认使用 `crypto.randomUUID()`）
+- 主键生成（非 autoIncrement 主键默认使用随机 UUID，底层带安全上下文守卫，不可用时回退；业务侧手动生成 UUID 一律用 `core.id.uuid()`）
 - BOOLEAN → 1/0（SQLite/MySQL）或 true/false（PostgreSQL）
 - TIMESTAMP → 毫秒时间戳（SQLite）或 Date（PG/MySQL）
 - JSON → 字符串序列化（SQLite/MySQL）或原生 JSONB（PG）