@h-ai/cli 0.1.0-alpha.19 → 0.1.0-alpha.20

package/templates/features/iam/routes-h5/auth/register/+page.svelte.hbs

@@ -1,11 +1,13 @@
 {{!-- H5 注册页面 --}}
-<script lang="ts">
+<script lang='ts'>
   /**
    * H5 注册页面
    */
+  import { resolve } from '$app/paths'
 {{#if hasI18n}}
   import * as m from '$lib/paraglide/messages'
 {{/if}}
+  import { Alert, Button, FormField, Input } from '@h-ai/ui'
 
   let username = $state('')
   let password = $state('')
@@ -13,7 +15,8 @@
   let error = $state('')
   let loading = $state(false)
 
-  async function handleRegister() {
+  async function handleRegister(event: SubmitEvent) {
+    event.preventDefault()
     error = ''
     if (password !== confirmPassword) {
 {{#if hasI18n}}
@@ -33,20 +36,23 @@
       const data = await res.json()
       if (data.success) {
         window.location.href = '/auth/login'
-      } else {
+      }
+      else {
 {{#if hasI18n}}
         error = data.error?.message || m.auth_register_failed()
 {{else}}
         error = data.error?.message || '注册失败'
 {{/if}}
       }
-    } catch {
+    }
+    catch {
 {{#if hasI18n}}
       error = m.auth_error_network()
 {{else}}
       error = '网络错误'
 {{/if}}
-    } finally {
+    }
+    finally {
       loading = false
     }
   }
@@ -60,55 +66,52 @@
 {{/if}}
 </svelte:head>
 
-<div class="p-4 pt-12">
+<div class='p-4 pt-12 space-y-4'>
 {{#if hasI18n}}
-  <h1 class="text-2xl font-bold text-center mb-8">{m.auth_register_title()}</h1>
+  <h1 class='text-2xl font-black tracking-tight text-center'>{m.auth_register_title()}</h1>
 {{else}}
-  <h1 class="text-2xl font-bold text-center mb-8">注册</h1>
+  <h1 class='text-2xl font-black tracking-tight text-center'>注册</h1>
 {{/if}}
 
   {#if error}
-    <div class="alert alert-error mb-4">
-      <span>{error}</span>
-    </div>
+    <Alert variant='error'>{error}</Alert>
   {/if}
 
-  <form onsubmit={(e) => { e.preventDefault(); handleRegister() }} class="space-y-4">
-    <div class="form-control">
-{{#if hasI18n}}
-      <input type="text" placeholder={m.auth_label_username()} class="input input-bordered w-full" bind:value={username} required />
-{{else}}
-      <input type="text" placeholder="用户名" class="input input-bordered w-full" bind:value={username} required />
-{{/if}}
-    </div>
-    <div class="form-control">
-{{#if hasI18n}}
-      <input type="password" placeholder={m.auth_label_password()} class="input input-bordered w-full" bind:value={password} required />
-{{else}}
-      <input type="password" placeholder="密码" class="input input-bordered w-full" bind:value={password} required />
-{{/if}}
-    </div>
-    <div class="form-control">
-{{#if hasI18n}}
-      <input type="password" placeholder={m.auth_label_confirm_password()} class="input input-bordered w-full" bind:value={confirmPassword} required />
-{{else}}
-      <input type="password" placeholder="确认密码" class="input input-bordered w-full" bind:value={confirmPassword} required />
-{{/if}}
-    </div>
-    <button type="submit" class="btn btn-primary w-full" disabled={loading}>
+  <form onsubmit={handleRegister} class='space-y-4'>
 {{#if hasI18n}}
+    <FormField label={m.auth_label_username()} required>
+      <Input id='username' type='text' bind:value={username} required />
+    </FormField>
+    <FormField label={m.auth_label_password()} required>
+      <Input id='password' type='password' bind:value={password} required />
+    </FormField>
+    <FormField label={m.auth_label_confirm_password()} required>
+      <Input id='confirmPassword' type='password' bind:value={confirmPassword} required />
+    </FormField>
+    <Button type='submit' variant='primary' loading={loading} class='w-full'>
       {loading ? m.auth_register_loading() : m.auth_register_submit()}
+    </Button>
 {{else}}
+    <FormField label='用户名' required>
+      <Input id='username' type='text' bind:value={username} required />
+    </FormField>
+    <FormField label='密码' required>
+      <Input id='password' type='password' bind:value={password} required />
+    </FormField>
+    <FormField label='确认密码' required>
+      <Input id='confirmPassword' type='password' bind:value={confirmPassword} required />
+    </FormField>
+    <Button type='submit' variant='primary' loading={loading} class='w-full'>
       {loading ? '注册中...' : '注册'}
+    </Button>
 {{/if}}
-    </button>
   </form>
 
-  <div class="text-center mt-6">
+  <div class='text-center'>
 {{#if hasI18n}}
-    <a href="/auth/login" class="link link-primary text-sm">{m.auth_register_to_login()}</a>
+    <a href={resolve('/auth/login', {})} class='link link-primary text-sm'>{m.auth_register_to_login()}</a>
 {{else}}
-    <a href="/auth/login" class="link link-primary text-sm">已有账号？立即登录</a>
+    <a href={resolve('/auth/login', {})} class='link link-primary text-sm'>已有账号？立即登录</a>
 {{/if}}
   </div>
 </div>

package/templates/skills/AGENTS.md

@@ -6,6 +6,8 @@
 
 本项目使用 hai-framework 构建，基于 SvelteKit 2 + Svelte 5 (Runes) + TailwindCSS 4 + DaisyUI 5 + TypeScript 5.7+。
 
+前后端分离工程中，SvelteKit app 主要负责 UI、路由与请求编排；业务 API 与服务端逻辑位于 `packages/<project>-serv`，通过 `@h-ai/serv` 实现。SSR、SPA 或静态输出以各 app 的 adapter 与配置为准，不要把 fullstack 后端业务逻辑写进 SvelteKit 页面、`load` 或前端组件。
+
 ## 核心规范
 
 - 统一模式：`module.init(config) → use → module.close()`，所有操作返回 `HaiResult<T>`
@@ -14,7 +16,15 @@
 - 用户可见文本走 i18n，代码注释中文，日志英文
 - HaiResult 错误直接透传，不重新包装
 - 框架模块公共 API 不抛异常，统一返回 `HaiResult<T>`；不要用 `try/catch` 处理模块返回的错误
-- 质量门禁：`pnpm typecheck && pnpm lint && pnpm test && pnpm --filter <app> test:e2e`
+- 质量门禁按顺序执行：`pnpm typecheck` → `pnpm lint` → `pnpm build`（涉及构建/发布时）→ `pnpm test` → `pnpm --filter <workspace> test:e2e`（涉及 UI/路由/E2E 时）
+
+## 完成条件
+
+- 失败的质量门禁必须先修复；不能提交或回复“已知失败”的改动。
+- 新增/修改功能要同步测试；UI、路由和关键用户流程要同步 E2E。
+- README、`.agents/skills/**/SKILL.md`、代码注释、i18n 消息、公共类型/API contract 与实现保持一致。
+- 修改共享包、公共 API、contract、client、server procedure 或 CLI 模板后，必须检索并更新所有受影响的 `packages/*`、`apps/*` 与脚手架模板。
+- 最终回复必须报告 typecheck/lint/build/test/e2e 状态、已更新文档、已更新依赖方；未执行或未通过项要说明原因和下一步。
 
 ## Skills 参考
 

package/templates/skills/CLAUDE.md

@@ -7,6 +7,7 @@
 ## 使用说明
 
 - 本文件是 Claude Code 的原生项目级指引入口。
-- 项目概述、核心规范与工作流约定统一维护在 `AGENTS.md`；Claude Code 通过 `@AGENTS.md` 复用这些共享规范，避免双份文档漂移。
+- 项目概述、核心规范、质量门禁与完成条件统一维护在 `AGENTS.md`；Claude Code 通过 `@AGENTS.md` 复用这些共享规范，避免双份文档漂移。
+- 如果当前运行环境未自动展开 `@AGENTS.md`，必须先手动阅读 `AGENTS.md`，再开始修改代码或文档。
 - 共享的模块与工作流参考资料维护在 `.agents/skills/` 中；需要具体用法时，可按路径阅读对应 `SKILL.md`。
 - 当前模板为了保持单一 Skill 树，不额外生成 `.claude/skills/`；如需 Claude Code 的原生 project skills 自动发现，需要单独维护该目录。

package/templates/skills/copilot-instructions.md

@@ -9,7 +9,8 @@
 ## 技术栈要点
 
 - **前端框架**：Svelte 5 (Runes: `$props()`, `$state()`, `$derived()`, `$effect()`)
-- **路由/SSR**：SvelteKit 2（文件路由、Handle Hook、load 函数）
+- **SvelteKit 应用层**：使用文件系统路由、`+layout/+page`、`load` 与 `hooks.server.ts` 做 UI/请求编排；SSR/SPA/静态输出以具体 app 的 adapter 与配置为准
+- **Fullstack 服务端**：前后端分离工程的业务 API 在 `packages/<project>-serv` 中通过 `@h-ai/serv` 实现；不要把服务端业务逻辑塞进 SvelteKit 页面、`load` 或前端组件
 - **样式**：TailwindCSS 4 + DaisyUI 5
 - **后端框架**：hai-framework (`@h-ai/core`, `@h-ai/kit`, `@h-ai/reldb`, `@h-ai/iam` 等)
 - **统一模式**：`module.init(config) → use → module.close()`，所有操作返回 `HaiResult<T>`
@@ -37,7 +38,7 @@
 | ---------------- | ----------------------------------------------------- |
 | `hai-build`      | 项目架构、模块依赖、初始化顺序、编码标准              |
 | `hai-core`       | 配置加载、日志、i18n、HaiResult 模型、模块生命周期       |
-| `hai-kit`        | SvelteKit 集成：Handle Hook、守卫、中间件、响应、校验 |
+| `hai-kit`        | SvelteKit 集成：`handle` hook、守卫、中间件、响应、校验 |
 | `hai-ui`         | UI 组件库：三层架构、自动导入、主题、i18n             |
 | `hai-reldb`      | 数据库操作：DDL、SQL、CRUD、事务、分页                |
 | `hai-iam`        | 认证与权限：密码/OTP/LDAP、会话、RBAC                 |
@@ -58,7 +59,22 @@
 
 ## 质量门禁
 
-```bash
-pnpm typecheck && pnpm lint && pnpm test
-pnpm --filter <app-name> test:e2e     # E2E 测试
-```
+改动完成后按顺序执行，失败必须先修复，不能把已知失败留给下一轮：
+
+1. `pnpm typecheck`
+2. `pnpm lint`（可先 `pnpm lint:fix`，再重新执行 `pnpm lint`）
+3. `pnpm build`（涉及构建产物、打包配置、前后端分离工程或发布路径时必须执行）
+4. `pnpm test`
+5. `pnpm --filter <app-or-package> test:e2e`（涉及 UI、路由、浏览器交互或端到端流程时必须执行）
+
+优先使用 `pnpm --filter <workspace-name>` 缩小验证范围；跨包契约、共享类型或根配置变更必须提升到根命令验证。
+
+## 完成条件
+
+- **测试同步**：新增/修改功能必须补单元测试；UI、路由和关键用户流程必须补 E2E 或更新现有 E2E。
+- **文档同步**：README、`.agents/skills/**/SKILL.md`、代码注释与实际行为保持一致；生成模板改动要同步模板与测试断言。
+- **i18n 同步**：所有用户可见文本必须走 i18n，并同时更新 `zh-CN` 与 `en-US` 消息文件。
+- **类型/契约同步**：公共类型、API contract、client、server procedure 与调用方必须一起更新，不能只改一端。
+- **错误处理同步**：新增错误码、错误消息或 HaiResult 形态时，同步文档、测试和调用方处理逻辑。
+- **依赖方传导**：修改共享包、公共 API 或模板后，用全局检索确认引用点，并更新受影响的 `packages/*`、`apps/*`、CLI 模板/脚手架。
+- **完成报告**：最终回复必须列出 typecheck/lint/build/test/e2e 状态、已更新文档、已更新依赖方；未执行或未通过的项目必须说明原因与后续动作。