@h-ai/cli 0.1.0-alpha5

package/templates/features/vecdb/routes/api/vecdb/search/+server.ts

@@ -0,0 +1,36 @@
+/**
+ * VecDB Search API — vecdb 功能示例
+ */
+import type { RequestEvent } from '@sveltejs/kit'
+import { kit } from '@h-ai/kit'
+import { vecdb } from '@h-ai/vecdb'
+
+const DEMO_COLLECTION = 'documents'
+
+export async function POST({ request, locals }: RequestEvent) {
+  const body = await request.json().catch(() => null) as { vector?: number[] } | null
+  const vector = body?.vector
+
+  if (!Array.isArray(vector) || vector.length === 0) {
+    return kit.response.badRequest('vector is required')
+  }
+
+  const collectionExists = await vecdb.collection.exists(DEMO_COLLECTION)
+  if (!collectionExists.success) {
+    return kit.response.internalError(collectionExists.error.message)
+  }
+
+  if (!collectionExists.data) {
+    return kit.response.badRequest('vecdb demo collection not initialized')
+  }
+
+  const result = await vecdb.vector.search(DEMO_COLLECTION, vector, { topK: 5 })
+  if (!result.success) {
+    return kit.response.internalError(result.error.message)
+  }
+
+  return kit.response.ok({
+    topK: 5,
+    results: result.data,
+  }, locals.requestId)
+}

package/templates/i18n/project.inlang/settings.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://inlang.com/schema/project-settings",
+  "baseLocale": "zh-CN",
+  "locales": ["zh-CN", "en-US"],
+  "modules": [
+    "../../node_modules/@inlang/plugin-message-format/dist/index.js"
+  ],
+  "plugin.inlang.messageFormat": {
+    "pathPattern": "./messages/{locale}.json"
+  }
+}

package/templates/skills/AGENTS.md

@@ -0,0 +1,26 @@
+# AGENTS.md
+
+> 通用 AI 编程助手指引。详细 Skill 文件位于 `.agents/skills/` 目录。
+
+## 项目概述
+
+本项目使用 hai-framework 构建，基于 SvelteKit 2 + Svelte 5 (Runes) + TailwindCSS 4 + DaisyUI 5 + TypeScript 5.7+。
+
+## 核心规范
+
+- 统一模式：`module.init(config) → use → module.close()`，所有操作返回 `HaiResult<T>`
+- **TDD 驱动开发**：先写测试（Red）→ 确认失败 → 再实现（Green）→ 确认通过 → 重构（Refactor）
+- 禁止 `any`（使用 `unknown` + 缩窄），禁止 `console.log`（使用 `core.logger`）
+- 用户可见文本走 i18n，代码注释中文，日志英文
+- HaiResult 错误直接透传，不重新包装
+- 框架模块公共 API 不抛异常，统一返回 `HaiResult<T>`；不要用 `try/catch` 处理模块返回的错误
+- 质量门禁：`pnpm typecheck && pnpm lint && pnpm test && pnpm --filter <app> test:e2e`
+
+## Skills 参考
+
+所有详细指南位于 `.agents/skills/` 目录，按需阅读：
+
+- **入口**：`hai-build/SKILL.md` — 项目架构总览与 Skill 导航
+- **框架模块**：`hai-core/`、`hai-kit/`、`hai-reldb/`、`hai-iam/`、`hai-crypto/`、`hai-cache/`、`hai-storage/`、`hai-ai/`
+- **UI 组件**：`hai-ui/SKILL.md`
+- **TDD 开发流程**：`hai-app-tests/`（TDD 测试先行）、`hai-app-create/`（TDD 实现）、`hai-app-review/`（TDD 重构审查）

package/templates/skills/CLAUDE.md

@@ -0,0 +1,12 @@
+# CLAUDE.md
+
+@AGENTS.md
+
+> Claude Code 项目指引。共享规范通过 `@AGENTS.md` 复用；共享参考资料位于 `.agents/skills/` 目录。
+
+## 使用说明
+
+- 本文件是 Claude Code 的原生项目级指引入口。
+- 项目概述、核心规范与工作流约定统一维护在 `AGENTS.md`；Claude Code 通过 `@AGENTS.md` 复用这些共享规范，避免双份文档漂移。
+- 共享的模块与工作流参考资料维护在 `.agents/skills/` 中；需要具体用法时，可按路径阅读对应 `SKILL.md`。
+- 当前模板为了保持单一 Skill 树，不额外生成 `.claude/skills/`；如需 Claude Code 的原生 project skills 自动发现，需要单独维护该目录。

package/templates/skills/copilot-instructions.md

@@ -0,0 +1,61 @@
+# GitHub Copilot 项目指令
+
+> 本文件作为 GitHub Copilot 的项目级指引，指向 `.agents/skills/` 中的详细 Skill 文件。
+
+## 项目概述
+
+本项目使用 [hai-framework](https://github.com/nicehero/hai-framework) 构建，基于 SvelteKit 2 + Svelte 5 (Runes) + TailwindCSS 4 + DaisyUI 5 + TypeScript 5.7+。
+
+## 技术栈要点
+
+- **前端框架**：Svelte 5 (Runes: `$props()`, `$state()`, `$derived()`, `$effect()`)
+- **路由/SSR**：SvelteKit 2（文件路由、Handle Hook、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>`
+- **单元测试**：Vitest
+- **E2E 测试**：Playwright
+- **包管理**：pnpm
+
+## 编码规范
+
+- 禁止 `any`（使用 `unknown` + 缩窄）
+- 禁止 `console.log`（使用 `core.logger`）
+- 禁止硬编码密钥
+- `xx-main.ts` 仅做生命周期管理和 API 编排，禁止在 main 中编写具体业务逻辑（委托给 `xx-functions.ts` / `xx-runner.ts` 等）
+- 用户可见文本必须走 i18n（`$lib/paraglide/messages.js`）
+- HaiResult 错误直接透传，不重新包装
+- 框架模块公共 API 不抛异常，统一返回 `HaiResult<T>`；不要用 `try/catch` 处理模块返回的错误
+- 日志消息英文、简洁动宾结构
+- 代码注释中文
+
+## Skills 目录
+
+详细的开发指南位于 `.agents/skills/` 目录：
+
+| Skill            | 说明                                                  |
+| ---------------- | ----------------------------------------------------- |
+| `hai-build`      | 项目架构、模块依赖、初始化顺序、编码标准              |
+| `hai-core`       | 配置加载、日志、i18n、HaiResult 模型、模块生命周期       |
+| `hai-kit`        | SvelteKit 集成：Handle Hook、守卫、中间件、响应、校验 |
+| `hai-ui`         | UI 组件库：三层架构、自动导入、主题、i18n             |
+| `hai-reldb`      | 数据库操作：DDL、SQL、CRUD、事务、分页                |
+| `hai-iam`        | 认证与权限：密码/OTP/LDAP、会话、RBAC                 |
+| `hai-crypto`     | 加密：SM2/SM3/SM4、密码哈希、随机生成                 |
+| `hai-cache`      | 缓存：内存/Redis、TTL、集合操作、分布式锁             |
+| `hai-storage`    | 存储：本地/S3、上传下载、预签名 URL                   |
+| `hai-ai`         | AI：LLM 调用、MCP 服务器、工具定义、流处理            |
+| `hai-app-create` | TDD 驱动的功能创建（先测试后实现）                    |
+| `hai-app-review` | 应用代码审查（含 TDD 合规检查）                       |
+| `hai-app-tests`  | TDD 测试规范（Vitest 单元测试 + Playwright E2E）      |
+
+## 开发流程
+
+**必须遵循 TDD**：先写测试（Red）→ 确认失败 → 再实现（Green）→ 确认通过 → 重构（Refactor）。
+
+## 质量门禁
+
+```bash
+pnpm typecheck && pnpm lint && pnpm test
+pnpm --filter <app-name> test:e2e     # E2E 测试
+```