@h-ai/cli 1.0.0-beta.17 → 1.0.0-beta.19

package/templates/apps/api/apps/{{projectName}}-serv/src/lib/server/init.ts.hbs

@@ -53,7 +53,10 @@ function startFeedback(): Promise<void> {
   feedbackClosing = false
   feedbackStarting = (async () => {
     try {
-      const result = await feedback.init({ ...core.config.getOrThrow<import('@h-ai/feedback').FeedbackConfigInput>('feedback'), ...buildMetadata })
+      const result = await feedback.init({
+        ...core.config.getOrThrow<import('@h-ai/feedback').FeedbackConfigInput>('feedback'),
+        ...buildMetadata,
+      })
       if (!result.success) {
         if (feedbackFailure !== result.error.code)
           core.logger.warn('Optional feedback unavailable; business runtime remains ready', { module: 'feedback', code: result.error.code })
@@ -87,106 +90,180 @@ async function closeFeedback() {
   await feedbackStarting
   return feedback.close()
 }
-
 {{/if}}
 
 const runtime = core.module.createRuntime([
-  { name: 'configuration', start: () => {
-    core.init({
-      configDir: './config',
-      configSchemas: {
-        serv: ServConfigSchema,
+  {
+    name: 'configuration',
+    start: () => {
+      core.init({
+        configDir: './config',
+        configSchemas: {
+          serv: ServConfigSchema,
 {{#if features.ai}}
-        ai: AIConfigSchema,
+          ai: AIConfigSchema,
 {{/if}}
 {{#if features.audit}}
-        audit: AuditInitConfigSchema,
+          audit: AuditInitConfigSchema,
 {{/if}}
 {{#if features.cache}}
-        cache: CacheConfigSchema,
+          cache: CacheConfigSchema,
 {{/if}}
 {{#if features.feedback}}
-        feedback: FeedbackConfigSchema,
+          feedback: FeedbackConfigSchema,
 {{/if}}
 {{#if features.iam}}
-        iam: IamConfigSchema,
+          iam: IamConfigSchema,
 {{/if}}
 {{#if features.reach}}
-        reach: ReachConfigSchema,
+          reach: ReachConfigSchema,
 {{/if}}
 {{#if features.db}}
-        db: ReldbConfigSchema,
+          db: ReldbConfigSchema,
 {{/if}}
 {{#if features.audit}}
 {{#if features.scheduler}}
-        scheduler: SchedulerConfigSchema,
+          scheduler: SchedulerConfigSchema,
 {{/if}}
 {{/if}}
 {{#if features.storage}}
-        storage: StorageConfigSchema,
+          storage: StorageConfigSchema,
 {{/if}}
 {{#if features.vecdb}}
-        vecdb: VecdbConfigSchema,
-{{/if}}
-      },
-    })
-  }, close: () => {} },
-  { name: 'serv-config', start: () => core.config.validate('serv', ServConfigSchema), close: () => {} },
+          vecdb: VecdbConfigSchema,
+{{/if}}
+        },
+      })
+    },
+    close: () => { },
+  },
+  {
+    name: 'serv-config',
+    start: () => core.config.validate('serv', ServConfigSchema),
+    close: () => { },
+  },
 {{#if features.db}}
-  { name: 'reldb', start: async () => {
-    const config = ReldbConfigSchema.parse(core.config.getOrThrow('db'))
-    if (config.type === 'sqlite' && config.database !== ':memory:') {
-      const { mkdir } = await import('node:fs/promises')
-      const { dirname } = await import('node:path')
-      await mkdir(dirname(config.database), { recursive: true })
-    }
-    return reldb.init(config)
-  }, close: () => reldb.close() },
+  {
+    name: 'reldb',
+    start: async () => {
+      const config = ReldbConfigSchema.parse(core.config.getOrThrow('db'))
+      if (config.type === 'sqlite' && config.database !== ':memory:') {
+        const { mkdir } = await import('node:fs/promises')
+        const { dirname } = await import('node:path')
+        await mkdir(dirname(config.database), { recursive: true })
+      }
+      return reldb.init(config)
+    },
+    close: () => reldb.close(),
+  },
 {{/if}}
 {{#if features.cache}}
-  { name: 'cache', start: () => cache.init(CacheConfigSchema.parse(core.config.getOrThrow('cache'))), close: () => cache.close() },
+  {
+    name: 'cache',
+    start: () => cache.init(CacheConfigSchema.parse(core.config.getOrThrow('cache'))),
+    close: () => cache.close(),
+  },
 {{/if}}
 {{#if features.vecdb}}
-  { name: 'vecdb', start: () => vecdb.init(VecdbConfigSchema.parse(core.config.getOrThrow('vecdb'))), close: () => vecdb.close() },
+  {
+    name: 'vecdb',
+    start: () => vecdb.init(VecdbConfigSchema.parse(core.config.getOrThrow('vecdb'))),
+    close: () => vecdb.close(),
+  },
 {{/if}}
 {{#if features.crypto}}
-  { name: 'crypto', start: () => crypto.init(), close: () => crypto.close() },
+  {
+    name: 'crypto',
+    start: () => crypto.init(),
+    close: () => crypto.close(),
+  },
 {{/if}}
 {{#if features.storage}}
-  { name: 'storage', start: () => storage.init(StorageConfigSchema.parse(core.config.getOrThrow('storage'))), close: () => storage.close() },
+  {
+    name: 'storage',
+    start: () => storage.init(StorageConfigSchema.parse(core.config.getOrThrow('storage'))),
+    close: () => storage.close(),
+  },
 {{/if}}
 {{#if features.reach}}
-  { name: 'reach', enabled: () => Boolean(core.config.get('reach')), start: () => reach.init(ReachConfigSchema.parse(core.config.getOrThrow('reach'))), close: () => reach.close() },
+  {
+    name: 'reach',
+    enabled: () => Boolean(core.config.get('reach')),
+    start: () => reach.init(ReachConfigSchema.parse(core.config.getOrThrow('reach'))),
+    close: () => reach.close(),
+  },
 {{/if}}
 {{#if features.audit}}
-  { name: 'audit', start: () => audit.init({ ...AuditInitConfigSchema.parse(core.config.get('audit') ?? {}){{#if features.storage}}, storage{{/if}}{{#if features.reach}}, reach{{/if}} }), close: () => audit.close() },
+  {
+    name: 'audit',
+    start: () => audit.init({
+      ...AuditInitConfigSchema.parse(core.config.get('audit') ?? {}),
+{{#if features.storage}}
+      storage,
+{{/if}}
+{{#if features.reach}}
+      reach,
+{{/if}}
+    }),
+    close: () => audit.close(),
+  },
 {{/if}}
 {{#if features.iam}}
-  { name: 'iam', start: () => iam.init({ ...IamConfigSchema.parse(core.config.getOrThrow('iam')){{#if features.reach}}, reach{{/if}} }), close: () => iam.close() },
+  {
+    name: 'iam',
+    start: () => iam.init({
+      ...IamConfigSchema.parse(core.config.getOrThrow('iam')),
+{{#if features.reach}}
+      reach,
+{{/if}}
+    }),
+    close: () => iam.close(),
+  },
 {{/if}}
 {{#if features.audit}}
 {{#if features.scheduler}}
-  { name: 'audit-jobs', enabled: () => Boolean(audit.schedulerPlan), start: async () => {
-    const schedule = audit.schedulerPlan
-    if (!schedule)
-      return
-    const initialized = await scheduler.init({ ...SchedulerConfigSchema.parse(core.config.get('scheduler') ?? {}), ...schedule })
-    if (!initialized.success)
-      return initialized
-    const started = scheduler.start()
-    if (!started.success)
-      await scheduler.close()
-    return started
-  }, close: () => scheduler.close() },
+  {
+    name: 'audit-jobs',
+    enabled: () => Boolean(audit.schedulerPlan),
+    start: async () => {
+      const schedule = audit.schedulerPlan
+      if (!schedule)
+        return
+      const initialized = await scheduler.init({
+        ...SchedulerConfigSchema.parse(core.config.get('scheduler') ?? {}),
+        ...schedule,
+      })
+      if (!initialized.success)
+        return initialized
+      const started = scheduler.start()
+      if (!started.success)
+        await scheduler.close()
+      return started
+    },
+    close: () => scheduler.close(),
+  },
 {{/if}}
 {{/if}}
 {{#if features.feedback}}
-  { name: 'feedback', enabled: () => Boolean(core.config.get('feedback')), start: startFeedback, close: closeFeedback },
+  {
+    name: 'feedback',
+    enabled: () => Boolean(core.config.get('feedback')),
+    start: startFeedback,
+    close: closeFeedback,
+  },
 {{/if}}
 {{#if features.ai}}
-  { name: 'ai', start: () => ai.init(AIConfigSchema.parse(core.config.getOrThrow('ai'))), close: () => ai.close() },
-{{/if}}
-  { name: 'bootstrap', start: () => { core.logger.info('API service initialized') }, close: () => {} },
+  {
+    name: 'ai',
+    start: () => ai.init(AIConfigSchema.parse(core.config.getOrThrow('ai'))),
+    close: () => ai.close(),
+  },
+{{/if}}
+  {
+    name: 'bootstrap',
+    start: () => { core.logger.info('API service initialized') },
+    close: () => { },
+  },
 ])
 
 /** 启动失败只报告模块、错误码和配置路径，私密值不进入错误上下文。 */

package/templates/apps/api/apps/{{projectName}}-serv/src/server/procedures/index.ts.hbs

@@ -1,13 +1,27 @@
 import type { AppProcedureDeps } from './app-procedures.js'
-{{#if features.ai}}import { ai } from '@h-ai/ai'
-{{/if}}{{#if features.feedback}}import { feedback } from '@h-ai/feedback'
-{{/if}}{{#if features.iam}}import { iam } from '@h-ai/iam'
-{{/if}}{{#if features.ai}}import { createAiProcedures } from '@h-ai/serv/features/ai'
-{{/if}}{{#if features.feedback}}import { createFeedbackProcedures } from '@h-ai/serv/features/feedback'
-{{/if}}{{#if features.iam}}import { createIamProcedures } from '@h-ai/serv/features/iam'
-{{/if}}{{#if features.storage}}import { createStorageProcedures } from '@h-ai/serv/features/storage'
+{{#if features.ai}}
+import { ai } from '@h-ai/ai'
+{{/if}}
+{{#if features.feedback}}
+import { feedback } from '@h-ai/feedback'
+{{/if}}
+{{#if features.iam}}
+import { iam } from '@h-ai/iam'
+{{/if}}
+{{#if features.ai}}
+import { createAiProcedures } from '@h-ai/serv/features/ai'
+{{/if}}
+{{#if features.feedback}}
+import { createFeedbackProcedures } from '@h-ai/serv/features/feedback'
+{{/if}}
+{{#if features.iam}}
+import { createIamProcedures } from '@h-ai/serv/features/iam'
+{{/if}}
+{{#if features.storage}}
+import { createStorageProcedures } from '@h-ai/serv/features/storage'
 import { storage } from '@h-ai/storage'
-{{/if}}import { createAppProcedures } from './app-procedures.js'
+{{/if}}
+import { createAppProcedures } from './app-procedures.js'
 
 // @hai-generator:procedures:imports
 
@@ -15,15 +29,21 @@ import { storage } from '@h-ai/storage'
 export function {{api.serviceProceduresFactoryName}}(deps: { app: AppProcedureDeps }) {
   return {
     // @hai-generator:procedures:entries
-{{#if features.iam}}    iam: createIamProcedures({ iam }),
-{{/if}}{{#if features.storage}}    storage: createStorageProcedures({
+{{#if features.iam}}
+    iam: createIamProcedures({ iam }),
+{{/if}}
+{{#if features.storage}}
+    storage: createStorageProcedures({
       storage,
       authorize: ({ context, keys }) => keys.every(key =>
         key.startsWith(`users/${encodeURIComponent(context.session.userId)}/`)),
     }),
-{{/if}}{{#if features.ai}}    // AI 默认绑定可信 session.userId，跨主体访问需另行提供 authorizeObject 策略。
+{{/if}}
+{{#if features.ai}}
+    // AI 默认绑定可信 session.userId，跨主体访问需另行提供 authorizeObject 策略。
     ai: createAiProcedures({ ai }),
-{{/if}}{{#if features.feedback}}
+{{/if}}
+{{#if features.feedback}}
     feedback: createFeedbackProcedures({
       feedback,
       resolveContext: ({ session }) => ({
@@ -31,7 +51,13 @@ export function {{api.serviceProceduresFactoryName}}(deps: { app: AppProcedureDe
         userId: session.userId,
         // 示例角色映射；实际产品应从可信租户与资源权限确定范围。
         permissions: session.roles.includes('admin')
-          ? ['feedback:create', 'feedback:read', 'feedback:process', 'feedback:reopen', 'feedback:export']
+          ? [
+              'feedback:create',
+              'feedback:read',
+              'feedback:process',
+              'feedback:reopen',
+              'feedback:export',
+            ]
           : ['feedback:create'],
       }),
     }),

package/templates/apps/api/apps/{{projectName}}-serv/tests/service.test.ts.hbs

@@ -4,16 +4,28 @@ import type { AddressInfo } from 'node:net'
 import { mkdtempSync, rmSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
-{{#if features.ai}}import { ai } from '@h-ai/ai'
-{{/if}}import { apiClient } from '@h-ai/api-client'
-{{#if features.cache}}import { cache } from '@h-ai/cache'
-{{/if}}import { core } from '@h-ai/core'
-{{#if features.iam}}import { iam } from '@h-ai/iam'
-{{/if}}{{#if features.db}}import { reldb } from '@h-ai/reldb'
-{{/if}}import { serv } from '@h-ai/serv'
-{{#if features.storage}}import { storage } from '@h-ai/storage'
-{{/if}}{{#if features.vecdb}}import { vecdb } from '@h-ai/vecdb'
-{{/if}}import { {{api.contractExportName}} } from '{{api.contractPackageName}}'
+{{#if features.ai}}
+import { ai } from '@h-ai/ai'
+{{/if}}
+import { apiClient } from '@h-ai/api-client'
+{{#if features.cache}}
+import { cache } from '@h-ai/cache'
+{{/if}}
+import { core } from '@h-ai/core'
+{{#if features.iam}}
+import { iam } from '@h-ai/iam'
+{{/if}}
+{{#if features.db}}
+import { reldb } from '@h-ai/reldb'
+{{/if}}
+import { serv } from '@h-ai/serv'
+{{#if features.storage}}
+import { storage } from '@h-ai/storage'
+{{/if}}
+{{#if features.vecdb}}
+import { vecdb } from '@h-ai/vecdb'
+{{/if}}
+import { {{api.contractExportName}} } from '{{api.contractPackageName}}'
 import { afterAll, beforeAll, describe, expect, it, vi } from 'vitest'
 
 import { {{api.serviceAppFactoryName}} } from '../src/app.js'
@@ -23,10 +35,12 @@ let baseUrl = ''
 let client: ReturnType<typeof apiClient.create<typeof {{api.contractExportName}}>>
 let server: ReturnType<typeof serv.listen>
 let servConfig: ServConfig
-{{#if features.storage}}let storageRoot = ''
-{{/if}}{{#if features.vecdb}}let vecdbRoot = ''
+{{#if features.storage}}
+let storageRoot = ''
+{{/if}}
+{{#if features.vecdb}}
+let vecdbRoot = ''
 {{/if}}
-
 {{#if features.iam}}
 function uniqueUser(prefix = 'api') {
   const suffix = `${Date.now().toString(36)}${Math.random().toString(36).slice(2, 6)}`.slice(-8)
@@ -40,8 +54,11 @@ function uniqueUser(prefix = 'api') {
 
 beforeAll(async () => {
   tempRoot = mkdtempSync(join(tmpdir(), '{{projectName}}-service-test-'))
-{{#if features.storage}}  storageRoot = join(tempRoot, 'storage')
-{{/if}}{{#if features.vecdb}}  vecdbRoot = join(tempRoot, 'vecdb')
+{{#if features.storage}}
+  storageRoot = join(tempRoot, 'storage')
+{{/if}}
+{{#if features.vecdb}}
+  vecdbRoot = join(tempRoot, 'vecdb')
 {{/if}}
 
   vi.stubEnv('HAI_SERV_CORS_NATIVEORIGINS', undefined)
@@ -55,27 +72,32 @@ beforeAll(async () => {
   const dbResult = await reldb.init({ type: 'sqlite', database: ':memory:' })
   if (!dbResult.success)
     throw new Error(`reldb: ${dbResult.error.message}`)
-{{/if}}{{#if features.cache}}
+{{/if}}
+{{#if features.cache}}
 
   const cacheResult = await cache.init({ type: 'memory' })
   if (!cacheResult.success)
     throw new Error(`cache: ${cacheResult.error.message}`)
-{{/if}}{{#if features.vecdb}}
+{{/if}}
+{{#if features.vecdb}}
 
   const vecdbResult = await vecdb.init({ type: 'lancedb', path: vecdbRoot })
   if (!vecdbResult.success)
     throw new Error(`vecdb: ${vecdbResult.error.message}`)
-{{/if}}{{#if features.iam}}
+{{/if}}
+{{#if features.iam}}
 
   const iamResult = await iam.init({})
   if (!iamResult.success)
     throw new Error(`iam: ${iamResult.error.message}`)
-{{/if}}{{#if features.storage}}
+{{/if}}
+{{#if features.storage}}
 
   const storageResult = await storage.init({ type: 'local', root: storageRoot })
   if (!storageResult.success)
     throw new Error(`storage: ${storageResult.error.message}`)
-{{/if}}{{#if features.ai}}
+{{/if}}
+{{#if features.ai}}
 
   const aiResult = await ai.init({})
   if (!aiResult.success)
@@ -100,7 +122,9 @@ beforeAll(async () => {
     baseUrl: `${baseUrl}${servConfig.http.apiPrefix}`,
     clientName: 'hai-mobile-app',
     headers: { 'origin': 'capacitor://localhost', 'x-hai-token-transport': 'body' },
-    auth: { storage: apiClient.tokenStorage.memory() },
+    auth: {
+      storage: apiClient.tokenStorage.memory(),
+    },
   })
   if (!initResult.success)
     throw new Error(`client.init: ${initResult.error.message}`)
@@ -109,13 +133,25 @@ beforeAll(async () => {
 afterAll(async () => {
   await client?.close()
   await server?.close()
-{{#if features.ai}}  await ai.close()
-{{/if}}{{#if features.storage}}  await storage.close()
-{{/if}}{{#if features.iam}}  await iam.close()
-{{/if}}{{#if features.vecdb}}  await vecdb.close()
-{{/if}}{{#if features.cache}}  await cache.close()
-{{/if}}{{#if features.db}}  await reldb.close()
-{{/if}}  rmSync(tempRoot, { recursive: true, force: true })
+{{#if features.ai}}
+  await ai.close()
+{{/if}}
+{{#if features.storage}}
+  await storage.close()
+{{/if}}
+{{#if features.iam}}
+  await iam.close()
+{{/if}}
+{{#if features.vecdb}}
+  await vecdb.close()
+{{/if}}
+{{#if features.cache}}
+  await cache.close()
+{{/if}}
+{{#if features.db}}
+  await reldb.close()
+{{/if}}
+  rmSync(tempRoot, { recursive: true, force: true })
   vi.unstubAllEnvs()
 })
 
@@ -135,7 +171,12 @@ describe('{{api.servPackageName}}', () => {
     expect(result.success).toBe(true)
     if (result.success) {
       const config = core.config.getOrThrow<CoreConfig>('core')
-      expect(result.data).toMatchObject({ name: config.name, version: config.version, env: config.env, defaultLocale: config.defaultLocale })
+      expect(result.data).toMatchObject({
+        name: config.name,
+        version: config.version,
+        env: config.env,
+        defaultLocale: config.defaultLocale,
+      })
       expect(typeof result.data.transportEnabled).toBe('boolean')
     }
   })
@@ -145,7 +186,6 @@ describe('{{api.servPackageName}}', () => {
 
     expect(result.success).toBe(false)
   })
-
 {{#if features.iam}}
   it.each([
     ['capacitor://localhost', 'hai-mobile-app'],
@@ -156,7 +196,14 @@ describe('{{api.servPackageName}}', () => {
   ])('refreshes an expired access token at the default native Origin %s', async (origin, clientName) => {
     const native = apiClient.create({{api.contractExportName}})
     try {
-      expect((await native.init({ baseUrl: `${baseUrl}${servConfig.http.apiPrefix}`, clientName, headers: { 'origin': origin, 'x-hai-token-transport': 'body' }, auth: { storage: apiClient.tokenStorage.memory() } })).success).toBe(true)
+      expect((await native.init({
+        baseUrl: `${baseUrl}${servConfig.http.apiPrefix}`,
+        clientName,
+        headers: { 'origin': origin, 'x-hai-token-transport': 'body' },
+        auth: {
+          storage: apiClient.tokenStorage.memory(),
+        },
+      })).success).toBe(true)
       const registration = await apiClient.createAuthActions(native).register(uniqueUser('refresh'))
       expect(registration.success).toBe(true)
       if (!registration.success)

package/templates/apps/api/apps/{{projectName}}-serv/tsup.config.ts.hbs

@@ -6,7 +6,9 @@ import { resolveBuildMetadata } from '../../scripts/build-metadata.js'
 const buildMetadata = resolveBuildMetadata(fileURLToPath(new URL('.', import.meta.url)))
 
 export default defineConfig({
-  define: { __HAI_BUILD_METADATA__: JSON.stringify(buildMetadata) },
+  define: {
+    __HAI_BUILD_METADATA__: JSON.stringify(buildMetadata),
+  },
   async onSuccess() {
     await writeFile(new URL('./dist/build-metadata.json', import.meta.url), JSON.stringify(buildMetadata))
   },

package/templates/apps/api/apps/{{projectName}}-serv/vitest.config.ts.hbs

@@ -3,7 +3,9 @@ import { defineConfig } from 'vitest/config'
 import { resolveBuildMetadata } from '../../scripts/build-metadata.js'
 
 export default defineConfig({
-  define: { __HAI_BUILD_METADATA__: JSON.stringify(resolveBuildMetadata(fileURLToPath(new URL('.', import.meta.url)))) },
+  define: {
+    __HAI_BUILD_METADATA__: JSON.stringify(resolveBuildMetadata(fileURLToPath(new URL('.', import.meta.url)))),
+  },
   test: {
     globals: true,
     environment: 'node',

package/templates/apps/api/e2e/api-serv.spec.ts.hbs

@@ -16,7 +16,9 @@ test.beforeAll(async () => {
   const result = await client.init({
     baseUrl: `${process.env.BASE_URL || 'http://127.0.0.1:3000'}${API_PREFIX}`,
 {{#if features.iam}}
-    auth: { storage: apiClient.tokenStorage.memory() },
+    auth: {
+      storage: apiClient.tokenStorage.memory(),
+    },
 {{/if}}
 {{#if features.crypto}}
     transport: { crypto },
@@ -105,9 +107,24 @@ test('feedback intake is idempotent and creator can append evidence without admi
   expect(duplicate.success).toBe(true)
   if (duplicate.success)
     expect(duplicate.data.id).toBe(created.data.id)
-  const evidence = await client.feedback.reports.appendEvidence({ id: created.data.id, evidence: [{ id: 'event-1', source: 'api-test', sequence: 1, kind: 'business', timestamp: Date.now(), data: { action: 'api-feedback' } }] })
+  const evidence = await client.feedback.reports.appendEvidence({
+    id: created.data.id,
+    evidence: [
+      {
+        id: 'event-1',
+        source: 'api-test',
+        sequence: 1,
+        kind: 'business',
+        timestamp: Date.now(),
+        data: { action: 'api-feedback' },
+      },
+    ],
+  })
   expect(evidence.success).toBe(true)
-  expect((await client.feedback.reports.completeCollection({ id: created.data.id, missing: ['browser-not-applicable'] })).success).toBe(true)
+  expect((await client.feedback.reports.completeCollection({
+    id: created.data.id,
+    missing: ['browser-not-applicable'],
+  })).success).toBe(true)
   expect((await client.feedback.reports.list({})).success).toBe(false)
 })
 {{/if}}

package/templates/apps/api/e2e/capture-evidence.ts.hbs

@@ -15,7 +15,10 @@ export default async function captureEvidence() {
     expect(response?.status()).toBe(200)
     await expect(page.locator('body')).toContainText('ok')
     await mkdir(evidence, { recursive: true })
-    await page.screenshot({ path: path.join(evidence, '{{projectName}}-health.png'), fullPage: true })
+    await page.screenshot({
+      path: path.join(evidence, '{{projectName}}-health.png'),
+      fullPage: true,
+    })
   }
   finally {
     await browser.close()

package/templates/apps/api/eslint.config.js.hbs

@@ -3,7 +3,9 @@ import { haiQualityConfig } from './eslint-rules.js'
 
 export default antfu({
   // unused-imports 使用 TS 规则，JS 同样使用 TS parser 以保持 scope 契约一致。
-  typescript: { files: [GLOB_SRC] },
+  typescript: {
+    files: [GLOB_SRC],
+  },
   formatters: true,
   ignores: [
     '**/dist/**',

package/templates/apps/api/images/serv.Dockerfile.hbs

@@ -1,7 +1,5 @@
 ARG HAI_NODE_IMAGE=node:24.22.1-bookworm-slim
 FROM ${HAI_NODE_IMAGE} AS build
-ARG SQLITE_PREBUILD_MIRROR=
-ENV npm_config_better_sqlite3_binary_host_mirror=$SQLITE_PREBUILD_MIRROR
 
 ENV PNPM_HOME=/pnpm
 ENV PATH=$PNPM_HOME:$PATH
@@ -22,8 +20,9 @@ COPY . .
 ARG HAI_BUILD_ID=
 ARG HAI_BUILD_COMMIT=unknown
 RUN HAI_BUILD_ID="$HAI_BUILD_ID" HAI_BUILD_COMMIT="$HAI_BUILD_COMMIT" pnpm compile
-RUN --mount=type=cache,id={{projectName}}-sqlite,target=/root/.npm/_prebuilds if [ -d node_modules/better-sqlite3 ]; then cd node_modules/better-sqlite3; for attempt in 1 2 3; do node -e "require('node:child_process').execFileSync(process.execPath,[require.resolve('prebuild-install/bin.js'),'--verbose'],{stdio:'inherit'})" && break; [ "$attempt" = 3 ] && exit 1; sleep 3; done; fi
-RUN --mount=type=cache,id={{projectName}}-pnpm,target=/pnpm/store --mount=type=cache,id={{projectName}}-sqlite,target=/root/.npm/_prebuilds pnpm pm deploy --filter {{api.servPackageName}} --prod /prod/app
+# SQLite 13 的原生二进制随 npm 包交付，在构建时验证实际加载。
+RUN if [ -d node_modules/better-sqlite3 ]; then node -e "const Database=require('better-sqlite3');const db=new Database(':memory:');db.prepare('SELECT 1').get();db.close()"; fi
+RUN --mount=type=cache,id={{projectName}}-pnpm,target=/pnpm/store pnpm pm deploy --filter {{api.servPackageName}} --prod /prod/app
 RUN rm -f /prod/app/README* && find /prod/app/dist -type f \( -name '*.map' -o -name '*.d.ts' -o -name '*.d.mts' -o -name '*.d.cts' \) -delete
 
 FROM ${HAI_NODE_IMAGE} AS runtime-base