@h-ai/cli 0.1.0-alpha5

package/templates/base/e2e/helpers.ts

@@ -0,0 +1,49 @@
+/**
+ * E2E 测试 - 共用工具函数
+ */
+
+import type { APIRequestContext, Page } from '@playwright/test'
+
+/** 生成唯一测试用户 */
+export function uniqueUser(prefix = 'e2e') {
+  const safePrefix = (prefix.replace(/\W/g, '') || 'e2e').slice(0, 8)
+  const entropy = `${Date.now().toString(36)}${Math.random().toString(36).slice(2, 6)}`
+  const id = entropy.slice(-10)
+  const username = `${safePrefix}_${id}`.slice(0, 20)
+  return {
+    username,
+    email: `${safePrefix}_${id}@test.local`,
+    password: 'Test1234!@',
+  }
+}
+
+/** 通过 API 注册用户 */
+export async function registerViaApi(
+  request: APIRequestContext,
+  user: ReturnType<typeof uniqueUser>,
+) {
+  return request.post('/api/auth/register', {
+    data: {
+      username: user.username,
+      email: user.email,
+      password: user.password,
+      confirmPassword: user.password,
+    },
+  })
+}
+
+/** 注册并登录，返回已认证的 Page */
+export async function registerAndLogin(
+  page: Page,
+  request: APIRequestContext,
+  prefix = 'e2e',
+) {
+  const user = uniqueUser(prefix)
+  await registerViaApi(request, user)
+  await page.goto('/login')
+  await page.fill('[name="username"]', user.username)
+  await page.fill('[name="password"]', user.password)
+  await page.click('button[type="submit"]')
+  await page.waitForURL('/')
+  return user
+}

package/templates/base/package.json.hbs

@@ -0,0 +1,67 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0-alpha5",
+  "private": true,
+  "license": "Apache-2.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:e2e": "playwright test"
+  },
+  "dependencies": {
+    "@h-ai/core": "^0.1.0-alpha5",
+    "@h-ai/kit": "^0.1.0-alpha5"{{#if hasUi}},
+    "@h-ai/ui": "^0.1.0-alpha5"{{/if}}{{#if features.db}},
+    "@h-ai/reldb": "^0.1.0-alpha5"{{/if}}{{#if features.cache}},
+    "@h-ai/cache": "^0.1.0-alpha5"{{/if}}{{#if features.iam}},
+    "@h-ai/iam": "^0.1.0-alpha5"{{/if}}{{#if features.crypto}},
+    "@h-ai/crypto": "^0.1.0-alpha5"{{/if}}{{#if features.storage}},
+    "@h-ai/storage": "^0.1.0-alpha5"{{/if}}{{#if features.ai}},
+    "@h-ai/ai": "^0.1.0-alpha5"{{/if}}{{#if features.audit}},
+    "@h-ai/audit": "^0.1.0-alpha5"{{/if}}{{#if features.reach}},
+    "@h-ai/reach": "^0.1.0-alpha5"{{/if}}{{#if features.payment}},
+    "@h-ai/payment": "^0.1.0-alpha5"{{/if}}{{#if features.vecdb}},
+    "@h-ai/vecdb": "^0.1.0-alpha5"{{/if}}{{#if features.datapipe}},
+    "@h-ai/datapipe": "^0.1.0-alpha5"{{/if}}{{#if features.scheduler}},
+    "@h-ai/scheduler": "^0.1.0-alpha5"{{/if}}{{#if features.deploy}},
+    "@h-ai/deploy": "^0.1.0-alpha5"{{/if}}{{#if features.api-client}},
+    "@h-ai/api-client": "^0.1.0-alpha5"{{/if}}{{#if features.capacitor}},
+    "@h-ai/capacitor": "^0.1.0-alpha5"{{/if}}{{#if isCapacitorApp}},
+    "@h-ai/api-client": "^0.1.0-alpha5",
+    "@h-ai/capacitor": "^0.1.0-alpha5"{{/if}},
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.50.0",
+{{#if isCapacitorApp}}
+    "@capacitor/cli": "^7.0.0",
+    "@capacitor/core": "^7.0.0",
+    "@capacitor/android": "^7.0.0",
+    "@capacitor/preferences": "^7.0.0",
+    "@sveltejs/adapter-static": "^3.0.0",
+{{else}}
+    "@sveltejs/adapter-auto": "^3.0.0",
+{{/if}}
+    "@sveltejs/kit": "^2.0.0",
+    "@sveltejs/vite-plugin-svelte": "^4.0.0",
+    "@types/node": "^22.0.0",
+    "rimraf": "^6.0.0",
+    "svelte": "^5.0.0",
+    "svelte-check": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "vitest": "^2.0.0"{{#if hasUi}},
+    "@tailwindcss/vite": "^4.0.0",
+    "tailwindcss": "^4.0.0",
+    "daisyui": "^5.0.0",
+    "@iconify-json/tabler": "^1.2.0",
+    "@iconify/tailwind4": "^1.0.0"{{/if}}{{#if hasI18n}},
+    "@inlang/paraglide-js": "^2.0.0",
+    "@inlang/plugin-message-format": "^5.0.0"{{/if}}
+  }
+}

package/templates/base/playwright.config.ts

@@ -0,0 +1,32 @@
+import process from 'node:process'
+import { defineConfig } from '@playwright/test'
+
+const baseURL = process.env.BASE_URL || 'http://localhost:4173'
+
+/**
+ * Playwright E2E 测试配置
+ */
+export default defineConfig({
+  testDir: './e2e',
+  fullyParallel: false,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: 2,
+  reporter: 'list',
+  timeout: 30_000,
+
+  use: {
+    baseURL,
+    channel: 'chrome',
+    trace: 'on-first-retry',
+    screenshot: 'only-on-failure',
+  },
+
+  webServer: {
+    command: 'pnpm build && pnpm preview --port 4173 --strictPort',
+    env: { HAI_E2E: '1' },
+    url: baseURL,
+    reuseExistingServer: false,
+    timeout: 180_000,
+  },
+})

package/templates/base/src/app.css

@@ -0,0 +1,2 @@
+@import 'tailwindcss';
+@plugin 'daisyui';

package/templates/base/src/app.d.ts.hbs

@@ -0,0 +1,18 @@
+/// <reference types="@sveltejs/kit" />
+
+declare global {
+  namespace App {
+    interface Locals {
+      /** 请求 ID */
+      requestId: string
+      /** 语言 */
+      locale: string
+{{#if features.iam}}
+      /** 会话信息 */
+      session?: import('@h-ai/kit').SessionData
+{{/if}}
+    }
+  }
+}
+
+export {}

package/templates/base/src/app.html.hbs

@@ -0,0 +1,16 @@
+<!doctype html>
+{{#if hasI18n}}
+<html lang="%lang%">
+{{else}}
+<html lang="{{defaultLocale}}">
+{{/if}}
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <link rel="icon" href="%sveltekit.assets%/favicon.png" />
+    %sveltekit.head%
+  </head>
+  <body data-sveltekit-preload-data="hover">
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
+</html>

package/templates/base/src/hooks.server.ts.hbs

@@ -0,0 +1,123 @@
+/**
+ * =============================================================================
+ * {{projectName}} - Server Hooks
+ * =============================================================================
+ */
+
+import type { Handle } from '@sveltejs/kit'
+import { initApp } from '$lib/server/init.js'
+import { core } from '@h-ai/core'
+import { kit } from '@h-ai/kit'
+{{#if features.iam}}
+import { iam } from '@h-ai/iam'
+{{/if}}
+{{#if features.crypto}}
+import { crypto } from '@h-ai/crypto'
+{{/if}}
+{{#if hasI18n}}
+import { paraglideMiddleware } from '$lib/paraglide/server.js'
+{{/if}}
+
+{{#if features.crypto}}
+// 初始化加密模块（同步）
+crypto.init()
+
+{{/if}}
+// =============================================================================
+// 应用初始化
+// =============================================================================
+
+let appInitPromise: Promise<void> | null = null
+
+async function ensureAppInitialized() {
+  if (!appInitPromise) {
+    appInitPromise = initApp().catch((err: unknown) => {
+      appInitPromise = null
+      throw err
+    })
+  }
+  await appInitPromise
+}
+
+// =============================================================================
+// 初始化 Handle
+// =============================================================================
+
+const initHandle: Handle = async ({ event, resolve }) => {
+  await ensureAppInitialized()
+  return resolve(event)
+}
+
+{{#if hasI18n}}
+// =============================================================================
+// Paraglide i18n Middleware
+// =============================================================================
+
+/**
+ * i18n Handle - 使用 Paraglide middleware 处理语言
+ *
+ * API 请求跳过 paraglideMiddleware（不需要页面级 locale + 避免消耗 body）
+ */
+const i18nHandle: Handle = async ({ event, resolve }) => {
+  if (event.url.pathname.startsWith('/api/')) {
+    const locale = event.cookies.get('PARAGLIDE_LOCALE') ?? '{{defaultLocale}}'
+    event.locals.locale = locale
+    kit.i18n.setLocale(locale)
+    return resolve(event)
+  }
+
+  return paraglideMiddleware(event.request, async ({ locale }) => {
+    event.locals.locale = locale
+    kit.i18n.setLocale(locale)
+    return resolve(event, {
+      transformPageChunk: ({ html }) => html.replace('%lang%', locale),
+    })
+  })
+}
+
+{{/if}}
+// =============================================================================
+// hai Handle（会话验证 + 限流 + 日志）
+// =============================================================================
+
+const haiHandle = kit.createHandle({
+{{#if features.iam}}
+  auth: {
+    verifyToken: async (token) => {
+      const result = await iam.auth.verifyToken(token)
+      return result.success ? result.data : null
+    },
+    operations: iam.auth,
+    loginUrl: '/auth/login',
+    protectedPaths: ['/admin/*', '/api/*'],
+    publicPaths: ['/api/auth/*', '/api/public/*', '/api/health'],
+  },
+{{/if}}
+  rateLimit: { windowMs: 60000, maxRequests: 200 },
+  logging: { logBody: false },
+  onError: (error: unknown, _event) => {
+    core.logger.error('Request error:', { error })
+    return new Response(
+      JSON.stringify({
+        success: false,
+        error: {
+          code: 'INTERNAL_ERROR',
+          message: error instanceof Error ? error.message : 'Unknown error',
+        },
+      }),
+      { status: 500, headers: { 'Content-Type': 'application/json' } },
+    )
+  },
+})
+
+// =============================================================================
+// 组合 Handle
+// =============================================================================
+
+export const handle = kit.sequence(
+  initHandle,
+{{#if hasI18n}}
+  i18nHandle,
+{{/if}}
+  haiHandle,
+)

package/templates/base/src/lib/server/init.ts.hbs

@@ -0,0 +1,190 @@
+/**
+ * =============================================================================
+ * {{projectName}} - 应用初始化
+ * =============================================================================
+ *
+ * 统一管理所有模块的初始化流程。
+ *
+ * 初始化顺序：
+ * 1. core.init — 加载配置文件（约定优于配置）
+{{#if features.db}}
+ * 2. reldb.init — 数据库连接
+{{/if}}
+{{#if features.cache}}
+ * 3. cache.init — 缓存
+{{/if}}
+{{#if features.storage}}
+ * 4. storage.init — 文件存储（可选）
+{{/if}}
+{{#if features.reach}}
+ * 5. reach.init — 触达服务（可选）
+{{/if}}
+{{#if features.iam}}
+ * 6. iam.init — 身份认证
+{{/if}}
+{{#if features.ai}}
+ * 7. ai.init — AI 集成（可选）
+{{/if}}
+ */
+
+import { core } from '@h-ai/core'
+{{#if features.db}}
+import { reldb, ReldbConfigSchema } from '@h-ai/reldb'
+{{/if}}
+{{#if features.cache}}
+import { cache, CacheConfigSchema } from '@h-ai/cache'
+{{/if}}
+{{#if features.iam}}
+import type { IamConfigSettingsInput } from '@h-ai/iam'
+import { iam } from '@h-ai/iam'
+{{/if}}
+{{#if features.storage}}
+import type { StorageConfigInput } from '@h-ai/storage'
+import { storage, StorageConfigSchema } from '@h-ai/storage'
+{{/if}}
+{{#if features.ai}}
+import type { AIConfigInput } from '@h-ai/ai'
+import { ai } from '@h-ai/ai'
+{{/if}}
+{{#if features.reach}}
+import type { ReachConfigInput } from '@h-ai/reach'
+import { reach } from '@h-ai/reach'
+{{/if}}
+{{#if features.audit}}
+import { audit } from '@h-ai/audit'
+{{/if}}
+
+{{#if features.db}}
+type DbConfigInput = Parameters<typeof reldb.init>[0]
+{{/if}}
+{{#if features.cache}}
+type CacheConfigInput = Parameters<typeof cache.init>[0]
+{{/if}}
+
+let initialized = false
+
+/**
+ * 初始化应用
+ */
+export async function initApp(): Promise<void> {
+  if (initialized)
+    return
+
+  // 1. 加载配置
+  core.init({
+    configDir: './config',
+    logging: { level: 'info' },
+  })
+
+{{#if features.db}}
+  // ─── 配置校验 ───
+  const dbValidation = core.config.validate('db', ReldbConfigSchema)
+  if (!dbValidation.success) {
+    throw new Error(`DB config invalid: ${dbValidation.error.message}`)
+  }
+{{/if}}
+{{#if features.cache}}
+  const cacheValidation = core.config.validate('cache', CacheConfigSchema)
+  if (!cacheValidation.success) {
+    throw new Error(`Cache config invalid: ${cacheValidation.error.message}`)
+  }
+{{/if}}
+
+{{#if features.db}}
+  // ─── 获取配置 ───
+  const dbConfig = core.config.getOrThrow<DbConfigInput>('db')
+{{/if}}
+{{#if features.cache}}
+  const cacheConfig = core.config.getOrThrow<CacheConfigInput>('cache')
+{{/if}}
+{{#if features.iam}}
+  const iamConfig = core.config.getOrThrow<IamConfigSettingsInput>('iam')
+{{/if}}
+{{#if features.storage}}
+  const storageConfig = core.config.get<StorageConfigInput>('storage')
+{{/if}}
+{{#if features.ai}}
+  const aiConfig = core.config.get<AIConfigInput>('ai')
+{{/if}}
+{{#if features.reach}}
+  const reachConfig = core.config.get<ReachConfigInput>('reach')
+{{/if}}
+
+{{#if features.db}}
+  // ─── 确保数据目录存在（SQLite） ───
+  if (dbConfig.type === 'sqlite') {
+    const path = await import('node:path')
+    const fs = await import('node:fs')
+    const dbDir = path.dirname(dbConfig.database)
+    if (!fs.existsSync(dbDir)) {
+      fs.mkdirSync(dbDir, { recursive: true })
+    }
+  }
+
+  // ─── 初始化数据库 ───
+  const dbResult = await reldb.init(dbConfig)
+  if (!dbResult.success) {
+    throw new Error(`Database initialization failed: ${dbResult.error.message}`)
+  }
+{{/if}}
+
+{{#if features.cache}}
+  // ─── 初始化缓存 ───
+  const cacheResult = await cache.init(cacheConfig)
+  if (!cacheResult.success) {
+    throw new Error(`Cache initialization failed: ${cacheResult.error.message}`)
+  }
+{{/if}}
+
+{{#if features.storage}}
+  // ─── 初始化存储（可选） ───
+  if (storageConfig) {
+    const storageValidation = core.config.validate('storage', StorageConfigSchema)
+    if (storageValidation.success) {
+      const storageResult = await storage.init(storageConfig)
+      if (!storageResult.success) {
+        core.logger.warn('Storage initialization failed', { error: storageResult.error.message })
+      }
+    }
+  }
+{{/if}}
+
+{{#if features.reach}}
+  // ─── 初始化触达服务（可选） ───
+  if (reachConfig) {
+    const reachResult = await reach.init(reachConfig)
+    if (!reachResult.success) {
+      core.logger.warn('Reach initialization failed', { error: reachResult.error.message })
+    }
+  }
+{{/if}}
+
+{{#if features.iam}}
+  // ─── 初始化 IAM ───
+  const iamResult = await iam.init(iamConfig)
+  if (!iamResult.success) {
+    throw new Error(`IAM initialization failed: ${iamResult.error.message}`)
+  }
+{{/if}}
+
+{{#if features.audit}}
+  // ─── 初始化审计 ───
+  const auditResult = await audit.init()
+  if (!auditResult.success) {
+    core.logger.warn('Audit initialization failed', { error: auditResult.error.message })
+  }
+{{/if}}
+
+{{#if features.ai}}
+  // ─── 初始化 AI（可选） ───
+  if (aiConfig?.llm?.apiKey) {
+    const aiResult = await ai.init(aiConfig)
+    if (!aiResult.success) {
+      core.logger.warn('AI initialization failed', { error: aiResult.error.message })
+    }
+  }
+{{/if}}
+
+  initialized = true
+  core.logger.info('{{projectName}} initialized.')
+}

package/templates/base/svelte.config.js.hbs

@@ -0,0 +1,30 @@
+/**
+ * Svelte 配置
+ */
+{{#if isCapacitorApp}}
+import adapter from '@sveltejs/adapter-static'
+{{else}}
+import adapter from '@sveltejs/adapter-auto'
+{{/if}}
+import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+  preprocess: vitePreprocess(),
+  compilerOptions: {
+    runes: true,
+  },
+  kit: {
+{{#if isCapacitorApp}}
+    adapter: adapter({
+      pages: 'build',
+      assets: 'build',
+      fallback: 'index.html',
+    }),
+{{else}}
+    adapter: adapter(),
+{{/if}}
+  },
+}
+
+export default config

package/templates/base/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "./.svelte-kit/tsconfig.json",
+  "compilerOptions": {
+    "moduleResolution": "bundler",
+    "strict": true,
+    "verbatimModuleSyntax": true
+  }
+}

package/templates/base/vite.config.ts.hbs

@@ -0,0 +1,27 @@
+/**
+ * {{projectName}} - Vite 配置
+ */
+import { sveltekit } from '@sveltejs/kit/vite'
+{{#if hasUi}}
+import tailwindcss from '@tailwindcss/vite'
+{{/if}}
+{{#if hasI18n}}
+import { paraglideVitePlugin } from '@inlang/paraglide-js'
+{{/if}}
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [
+    sveltekit(),
+{{#if hasUi}}
+    tailwindcss(),
+{{/if}}
+{{#if hasI18n}}
+    paraglideVitePlugin({
+      project: './project.inlang',
+      outdir: './src/lib/paraglide',
+      strategy: ['cookie', 'baseLocale'],
+    }),
+{{/if}}
+  ],
+})

package/templates/features/ai/routes/api/chat/+server.ts

@@ -0,0 +1,26 @@
+/**
+ * AI Chat API — ai 功能示例
+ */
+import type { RequestHandler } from './$types'
+import { ai } from '@h-ai/ai'
+import { kit } from '@h-ai/kit'
+
+export const POST: RequestHandler = async ({ request, locals }) => {
+  const { message } = await request.json()
+
+  if (!message) {
+    return kit.response.badRequest('message is required')
+  }
+
+  const result = await ai.llm.ask(message, {
+    systemPrompt: 'You are a helpful assistant.',
+  })
+
+  if (!result.success) {
+    return kit.response.internalError(result.error.message)
+  }
+
+  return kit.response.ok({
+    reply: result.data,
+  }, locals.requestId)
+}

package/templates/features/datapipe/routes/api/datapipe/pipeline/+server.ts

@@ -0,0 +1,41 @@
+/**
+ * DataPipe Pipeline API — datapipe 功能示例
+ */
+import type { RequestEvent } from '@sveltejs/kit'
+import { datapipe } from '@h-ai/datapipe'
+import { kit } from '@h-ai/kit'
+
+export async function POST({ request, locals }: RequestEvent) {
+  const body = await request.json().catch(() => null) as { content?: string } | null
+  const content = body?.content?.trim()
+
+  if (!content) {
+    return kit.response.badRequest('content is required')
+  }
+
+  const cleanedResult = datapipe.clean(content, {
+    removeHtml: true,
+    removeUrls: false,
+    normalizeWhitespace: true,
+  })
+  if (!cleanedResult.success) {
+    return kit.response.internalError(cleanedResult.error.message)
+  }
+
+  const chunksResult = datapipe.chunk(cleanedResult.data, {
+    mode: 'paragraph',
+    maxSize: 500,
+    overlap: 50,
+  })
+  if (!chunksResult.success) {
+    return kit.response.internalError(chunksResult.error.message)
+  }
+
+  const chunks = chunksResult.data
+
+  return kit.response.ok({
+    cleaned: cleanedResult.data,
+    chunkCount: chunks.length,
+    chunks: chunks.slice(0, 5),
+  }, locals.requestId)
+}

package/templates/features/iam/routes-admin/(auth)/+layout.svelte.hbs

@@ -0,0 +1,21 @@
+{{!-- 认证布局（登录/注册共用） --}}
+<script lang="ts">
+  /**
+   * 认证布局（登录/注册共用）
+   */
+  import type { Snippet } from 'svelte'
+
+  interface Props {
+    children: Snippet
+  }
+
+  let { children }: Props = $props()
+</script>
+
+<div class="min-h-screen flex items-center justify-center bg-base-200">
+  <div class="card w-full max-w-md bg-base-100 shadow-xl">
+    <div class="card-body">
+      {@render children()}
+    </div>
+  </div>
+</div>