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

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { generateConfigFile } from './chunk-LANIDJC7.js';
-import './chunk-YV7WPUI6.js';
+import { generateConfigFile } from './chunk-BPO34NRL.js';
+import './chunk-GSMXGUYF.js';
 import './chunk-2H7UOFLK.js';
 import { readFileSync, existsSync } from 'fs';
 import path2, { resolve } from 'path';
@@ -83,6 +83,67 @@ registerHelpers();
 Handlebars.registerHelper("if_eq", function(a, b, options) {
   return a === b ? options.fn(this) : options.inverse(this);
 });
+var HAI_VERSION = `^${fse.readJsonSync(fileURLToPath(new URL("../../package.json", import.meta.url))).version}`;
+var TEMPLATE_SKIP_IF_EMPTY_MARKER = "@skipIfEmpty";
+var NORMALIZED_RENDER_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".js", ".svelte", ".json", ".css"]);
+var VERSIONS = {
+  antfuEslintConfig: "^9.0.0",
+  apiContract: HAI_VERSION,
+  apiClient: HAI_VERSION,
+  core: HAI_VERSION,
+  serv: HAI_VERSION,
+  ui: HAI_VERSION,
+  // UI / Icon
+  bitsUi: "^2.18.1",
+  iconifyJsonTabler: "^1.2.35",
+  iconifyTailwind: "^1.2.3",
+  // Tailwind / DaisyUI
+  daisyui: "^5.5.20",
+  tailwindcss: "^4.3.0",
+  tailwindcssVite: "^4.3.0",
+  // i18n
+  inlangParaglide: "^2.18.1",
+  inlangMessageFormat: "^4.4.0",
+  // Svelte / Kit
+  svelte: "^5.55.9",
+  svelteKit: "^2.61.1",
+  svelteCheck: "^4.4.8",
+  sveltePlugin: "^7.1.2",
+  adapterAuto: "^7.0.1",
+  adapterStatic: "^3.0.10",
+  // Build / Test
+  vite: "^8.0.14",
+  vitest: "^4.1.7",
+  tsup: "^8.5.1",
+  rimraf: "^6.1.3",
+  // ESLint
+  eslint: "^10.4.0",
+  eslintPluginFormat: "^2.0.1",
+  eslintPluginSvelte: "^3.17.1",
+  svelteEslintParser: "^1.6.1",
+  // Node / TS
+  nodeTypes: "^25.9.1",
+  typescript: "^6.0.3",
+  // E2E
+  playwright: "^1.60.0",
+  // Validation
+  zod: "^4.4.3"
+};
+var FRONTEND_PORTS_DEFAULT = {
+  web: 4173,
+  app: 4174,
+  desktop: 4175
+};
+var FRONTEND_LABELS = {
+  web: "Web",
+  app: "App",
+  miniapp: "Miniapp",
+  desktop: "Desktop"
+};
+var IMPLEMENTED_FRONTENDS = ["web", "app", "desktop"];
+var DEFAULT_FULLSTACK_FRONTENDS = ["web", "app", "desktop"];
+var DEFAULT_THEMES = ["light", "dark"];
+var DEFAULT_THEME_NAME = "light";
 var FEATURE_ROUTE_DIRS = {
   iam: ["routes-shared"],
   storage: ["routes"],
@@ -99,6 +160,8 @@ var FEATURE_APP_ROUTE_DIRS = {
 };
 var FEATURE_ID_REGEX = /^[a-z0-9-]+$/;
 var HBS_SUFFIX_REGEX = /\.hbs$/;
+var NON_IDENTIFIER_CHAR_REGEX = /[^a-z0-9]+/i;
+var IDENTIFIER_START_REGEX = /^[a-z_$]/i;
 function getTemplatesRoot() {
   const currentDir = path2.dirname(fileURLToPath(import.meta.url));
   const distPath = path2.resolve(currentDir, "..", "templates");
@@ -114,11 +177,14 @@ async function copyStaticDir(src, dest, excludePaths) {
   await fse.copy(src, dest, {
     overwrite: true,
     filter: (filePath) => {
+      const rel = path2.relative(src, filePath);
+      if (rel.includes("{{") || rel.includes("}}")) {
+        return false;
+      }
       if (filePath.endsWith(".hbs")) {
         return false;
       }
       if (excludePaths && excludePaths.length > 0) {
-        const rel = path2.relative(src, filePath);
         return !excludePaths.some((p) => rel === p || rel.startsWith(`${p}${path2.sep}`));
       }
       return true;
@@ -158,21 +224,99 @@ function buildTemplateContext(options) {
     featureMap.db = true;
   }
   const isApi = options.appType === "api";
+  const isFullstack = options.appType === "fullstack";
   const isCapacitorApp = options.appType === "android-app";
   return {
     projectName: options.name,
     appType: options.appType,
     features: featureMap,
-    hasUi: !isApi,
-    hasI18n: !isApi,
+    hasUi: !isApi && !isFullstack,
+    hasI18n: !isApi && !isFullstack,
     isCapacitorApp,
     defaultLocale: options.moduleConfigs?.core?.defaultLocale ?? "zh-CN",
-    packageManager: options.packageManager
+    packageManager: options.packageManager,
+    fullstack: isFullstack ? buildFullstackTemplateContext(
+      options.name,
+      options.frontends ?? DEFAULT_FULLSTACK_FRONTENDS,
+      options.moduleConfigs
+    ) : void 0
+  };
+}
+function buildFullstackTemplateContext(projectName, frontendsInput, moduleConfigs) {
+  const selectedFrontends = [...new Set(frontendsInput.length > 0 ? frontendsInput : DEFAULT_FULLSTACK_FRONTENDS)];
+  const portsConfig = moduleConfigs?.fullstack?.ports ?? {};
+  const portFor = (target) => portsConfig[target] ?? FRONTEND_PORTS_DEFAULT[target];
+  const frontendApps = selectedFrontends.filter(isImplementedFrontend).map((target) => ({
+    target,
+    packageName: `${projectName}-${target}`,
+    label: FRONTEND_LABELS[target],
+    port: portFor(target)
+  }));
+  return {
+    versions: VERSIONS,
+    contractPackageName: `${projectName}-contract`,
+    contractExportName: `${toIdentifier(projectName)}Contract`,
+    servPackageName: `${projectName}-serv`,
+    sharedPackageName: `${projectName}-shared`,
+    selectedFrontends,
+    selectedFrontendsJson: `[${selectedFrontends.map((f) => `'${f}'`).join(", ")}]`,
+    frontendApps,
+    e2eFrontend: frontendApps[0],
+    frontends: {
+      web: selectedFrontends.includes("web"),
+      app: selectedFrontends.includes("app"),
+      miniapp: selectedFrontends.includes("miniapp"),
+      desktop: selectedFrontends.includes("desktop")
+    },
+    ports: {
+      web: portFor("web"),
+      app: portFor("app"),
+      desktop: portFor("desktop")
+    },
+    hasMiniapp: selectedFrontends.includes("miniapp"),
+    i18n: resolveI18nContext(moduleConfigs),
+    theme: resolveThemeContext(moduleConfigs)
   };
 }
+function resolveI18nContext(moduleConfigs) {
+  const coreLocale = moduleConfigs?.core?.defaultLocale ?? "zh-CN";
+  const baseLocale = moduleConfigs?.fullstack?.i18n?.baseLocale ?? coreLocale;
+  const fallbackLocale = baseLocale === "en-US" ? "zh-CN" : "en-US";
+  const requested = moduleConfigs?.fullstack?.i18n?.locales;
+  const locales = requested && requested.length > 0 ? [...new Set(requested)] : [baseLocale, fallbackLocale];
+  if (!locales.includes(baseLocale)) {
+    locales.unshift(baseLocale);
+  }
+  return { baseLocale, locales };
+}
+function resolveThemeContext(moduleConfigs) {
+  const defaultTheme = moduleConfigs?.fullstack?.theme?.defaultTheme ?? DEFAULT_THEME_NAME;
+  const requested = moduleConfigs?.fullstack?.theme?.themes;
+  const themes = requested && requested.length > 0 ? [...new Set(requested)] : [...DEFAULT_THEMES];
+  if (!themes.includes(defaultTheme)) {
+    themes.unshift(defaultTheme);
+  }
+  return { defaultTheme, themes };
+}
+function isImplementedFrontend(target) {
+  return IMPLEMENTED_FRONTENDS.includes(target);
+}
+function toIdentifier(value) {
+  const words = value.split(NON_IDENTIFIER_CHAR_REGEX).filter(Boolean);
+  const camel = words.map((word, index) => {
+    const normalized = word.toLowerCase();
+    return index === 0 ? normalized : `${normalized.charAt(0).toUpperCase()}${normalized.slice(1)}`;
+  }).join("");
+  if (!camel)
+    return "app";
+  return IDENTIFIER_START_REGEX.test(camel) ? camel : `app${camel}`;
+}
 async function generateFromTemplates(projectPath, context) {
   const root = getTemplatesRoot();
-  await copyStaticDir(path2.join(root, "base"), projectPath);
+  const includeBaseTemplate = context.appType !== "fullstack";
+  if (includeBaseTemplate) {
+    await copyStaticDir(path2.join(root, "base"), projectPath);
+  }
   const appDir = path2.join(root, "apps", context.appType);
   if (await fse.pathExists(appDir)) {
     const appExcludes = context.hasI18n ? [] : ["messages"];
@@ -211,10 +355,12 @@ async function generateFromTemplates(projectPath, context) {
       await fse.copy(i18nDir, projectPath, { overwrite: true });
     }
   }
-  await fse.ensureDir(path2.join(projectPath, "static"));
+  if (includeBaseTemplate) {
+    await fse.ensureDir(path2.join(projectPath, "static"));
+  }
 }
 async function renderDynamicFiles(templatesRoot, projectPath, context) {
-  const rootDirs = [
+  const rootDirs = context.appType === "fullstack" ? [path2.join(templatesRoot, "apps", context.appType)] : [
     path2.join(templatesRoot, "base"),
     path2.join(templatesRoot, "apps", context.appType)
   ];
@@ -248,17 +394,46 @@ async function renderHbsInDir(dir, destRoot, context) {
   const hbsFiles = await findHbsFiles(dir);
   for (const relPath of hbsFiles) {
     const srcPath = path2.join(dir, relPath);
-    const outRelPath = relPath.replace(HBS_SUFFIX_REGEX, "");
-    const destPath = path2.join(destRoot, outRelPath);
+    const outRelPathTemplate = relPath.replace(HBS_SUFFIX_REGEX, "");
     const template = await fse.readFile(srcPath, "utf-8");
     const compiled = Handlebars.compile(template, { noEscape: true });
     const rendered = compiled(context);
+    if (shouldSkipRenderedFile(template, rendered)) {
+      continue;
+    }
+    const outRelPath = renderOutputPath(outRelPathTemplate, context);
+    if (!isSafeRelativePath(outRelPath)) {
+      continue;
+    }
+    const destPath = path2.join(destRoot, outRelPath);
+    const normalizedRendered = normalizeRenderedContent(rendered, outRelPath);
     await fse.ensureDir(path2.dirname(destPath));
-    await fse.writeFile(destPath, rendered, "utf-8");
+    await fse.writeFile(destPath, normalizedRendered, "utf-8");
   }
 }
+function normalizeRenderedContent(content, outRelPath) {
+  const normalizedLineEndings = content.replace(/\r\n/g, "\n");
+  const ext = path2.extname(outRelPath);
+  const normalized = NORMALIZED_RENDER_EXTENSIONS.has(ext) ? normalizedLineEndings.replace(/\n{3,}/g, "\n\n") : normalizedLineEndings;
+  if (normalized.trim().length === 0) {
+    return "";
+  }
+  return normalized.endsWith("\n") ? normalized : `${normalized}
+`;
+}
+function shouldSkipRenderedFile(template, rendered) {
+  return template.includes(TEMPLATE_SKIP_IF_EMPTY_MARKER) && rendered.trim().length === 0;
+}
+function renderOutputPath(pathTemplate, context) {
+  const normalizedTemplate = pathTemplate.split(path2.sep).join("/");
+  return Handlebars.compile(normalizedTemplate, { noEscape: true })(context);
+}
+function isSafeRelativePath(relativePath) {
+  const normalized = path2.normalize(relativePath);
+  return !path2.isAbsolute(normalized) && normalized !== ".." && !normalized.startsWith(`..${path2.sep}`);
+}
 
-// src/commands/create.ts
+// src/commands/cli-create.ts
 var RE_HTTPS_URL = /^https:\/\/.+/;
 var RE_GIT_SSH_URL = /^git@.+:.+/;
 var APP_TYPES = {
@@ -286,8 +461,20 @@ var APP_TYPES = {
     name: "Android \u5E94\u7528",
     description: "Android \u539F\u751F\u5E94\u7528\uFF08Capacitor + SvelteKit SPA\uFF09\uFF0C\u53EF\u6253\u5305\u4E3A APK",
     defaultFeatures: ["iam", "db", "cache", "crypto", "api-client", "capacitor"]
+  },
+  "fullstack": {
+    name: "\u524D\u540E\u7AEF\u5206\u79BB\u5DE5\u7A0B",
+    description: "\u591A\u5305\u5DE5\u4F5C\u533A\uFF0C\u5305\u542B contract\u3001serv\u3001Web/App/Desktop \u524D\u7AEF",
+    defaultFeatures: []
   }
 };
+var FRONTEND_TARGETS = {
+  web: { name: "Web", description: "\u6D4F\u89C8\u5668 Web \u5E94\u7528", implemented: true },
+  app: { name: "App", description: "\u79FB\u52A8\u7AEF H5/App \u524D\u7AEF", implemented: true },
+  miniapp: { name: "\u5C0F\u7A0B\u5E8F", description: "\u9884\u7559\u76EE\u6807\uFF0C\u5F53\u524D\u53EA\u751F\u6210\u8BF4\u660E\u5360\u4F4D", implemented: false },
+  desktop: { name: "\u684C\u9762\u7AEF", description: "\u684C\u9762\u7AEF\u524D\u7AEF\u5DE5\u7A0B\uFF08Tauri \u9884\u7559\uFF09", implemented: true }
+};
+var DEFAULT_FULLSTACK_FRONTENDS2 = ["web", "app", "desktop"];
 var FEATURES = {
   "iam": {
     id: "iam",
@@ -470,34 +657,38 @@ async function createProject(options) {
       name: resolvedOptions.name,
       appType: resolvedOptions.appType,
       features: resolvedOptions.features,
+      frontends: resolvedOptions.frontends,
       moduleConfigs: resolvedOptions.moduleConfigs,
       packageManager: resolvedOptions.packageManager
     });
     await generateFromTemplates(projectPath, context);
-    const { generateConfigFile: generateConfigFile2 } = await import('./config-templates-S5RI2MC6.js');
-    const configs = resolvedOptions.moduleConfigs;
-    for (const featureId of resolvedOptions.features) {
-      const configKey = getFeatureConfigKey(featureId);
-      if (configKey) {
-        const content = generateConfigFile2(configKey, configs);
-        await writeFile(path2.join(projectPath, "config", `_${configKey}.yml`), content);
+    if (resolvedOptions.appType !== "fullstack") {
+      const { generateConfigFile: generateConfigFile2 } = await import('./cli-config-templates-JCS7T3NU.js');
+      const configs = resolvedOptions.moduleConfigs;
+      for (const featureId of resolvedOptions.features) {
+        const configKey = getFeatureConfigKey(featureId);
+        if (configKey) {
+          const content = generateConfigFile2(configKey, configs);
+          await writeFile(path2.join(projectPath, "config", `_${configKey}.yml`), content);
+        }
       }
+      await writeFile(
+        path2.join(projectPath, "config", "_core.yml"),
+        generateConfigFile2("core", configs)
+      );
+      const { generateEnvExample } = await import('./cli-config-templates-JCS7T3NU.js');
+      await writeFile(
+        path2.join(projectPath, ".env.example"),
+        generateEnvExample(resolvedOptions.features, configs)
+      );
     }
-    await writeFile(
-      path2.join(projectPath, "config", "_core.yml"),
-      generateConfigFile2("core", configs)
-    );
-    const { generateEnvExample } = await import('./config-templates-S5RI2MC6.js');
-    await writeFile(
-      path2.join(projectPath, ".env.example"),
-      generateEnvExample(resolvedOptions.features, configs)
-    );
-    const { generateSkillFiles } = await import('./skill-templates-N5DU5FNX.js');
+    const { generateSkillFiles } = await import('./cli-skill-templates-IMYZPQRG.js');
     await generateSkillFiles(projectPath, resolvedOptions.features, resolvedOptions.appType);
     const appTypeLabel = APP_TYPES[resolvedOptions.appType].name;
+    const readmeContent = resolvedOptions.appType === "fullstack" ? generateFullstackReadme(resolvedOptions.name, resolvedOptions.packageManager, resolvedOptions.frontends) : generateReadme(resolvedOptions.name, appTypeLabel, resolvedOptions.packageManager);
     await writeFile(
       path2.join(projectPath, "README.md"),
-      generateReadme(resolvedOptions.name, appTypeLabel, resolvedOptions.packageManager)
+      readmeContent
     );
     spinner.succeed();
     if (resolvedOptions.git) {
@@ -527,6 +718,7 @@ async function createProject(options) {
   }
 }
 async function resolveOptions(options) {
+  const useDefaults = options.yes ?? false;
   core.logger.info("", {});
   core.logger.info(chalk.bold.cyan("  \u{1F680} hai Agent Framework"));
   core.logger.info(chalk.gray("     AI-Native \xB7 Configuration-Driven \xB7 Security-First"));
@@ -536,7 +728,9 @@ async function resolveOptions(options) {
     process3.exit(1);
   };
   let projectName = options.name;
-  if (!projectName) {
+  if (!projectName && useDefaults) {
+    projectName = "my-app";
+  } else if (!projectName) {
     const { name } = await prompts({
       type: "text",
       name: "name",
@@ -553,7 +747,9 @@ async function resolveOptions(options) {
     projectName = name;
   }
   let resolvedAppType = options.appType;
-  if (!resolvedAppType) {
+  if (!resolvedAppType && useDefaults) {
+    resolvedAppType = "admin";
+  } else if (!resolvedAppType) {
     const { appType } = await prompts({
       type: "select",
       name: "appType",
@@ -567,23 +763,34 @@ async function resolveOptions(options) {
     resolvedAppType = appType;
   }
   const selectedAppType = resolvedAppType || "admin";
+  const selectedFrontends = selectedAppType === "fullstack" ? await resolveFrontendTargets(options.frontends, useDefaults, onCancel) : [];
   let selectedTemplate = options.template;
-  if (!selectedTemplate) {
-    const { template } = await prompts({
-      type: "select",
-      name: "template",
-      message: "\u9009\u62E9\u6A21\u677F:",
-      choices: Object.values(PROJECT_TEMPLATES).map((t) => ({
-        title: `${chalk.bold(t.name.padEnd(10))} ${chalk.gray(t.description)}`,
-        value: t.name
-      })),
-      initial: 1
-    }, { onCancel });
-    selectedTemplate = template;
+  if (selectedAppType === "fullstack") {
+    selectedTemplate = selectedTemplate ?? "custom";
+  } else if (!selectedTemplate) {
+    if (useDefaults) {
+      selectedTemplate = "default";
+    } else {
+      const { template } = await prompts({
+        type: "select",
+        name: "template",
+        message: "\u9009\u62E9\u6A21\u677F:",
+        choices: Object.values(PROJECT_TEMPLATES).map((t) => ({
+          title: `${chalk.bold(t.name.padEnd(10))} ${chalk.gray(t.description)}`,
+          value: t.name
+        })),
+        initial: 1
+      }, { onCancel });
+      selectedTemplate = template;
+    }
   }
   let selectedFeatures = [];
   const appTypeDefaults = APP_TYPES[selectedAppType].defaultFeatures;
-  if (selectedTemplate === "custom" && !options.features) {
+  if (selectedAppType === "fullstack") {
+    selectedFeatures = [];
+  } else if (selectedTemplate === "custom" && !options.features && useDefaults) {
+    selectedFeatures = resolveFeatureDependencies(appTypeDefaults);
+  } else if (selectedTemplate === "custom" && !options.features) {
     const featureChoices = SELECTABLE_FEATURES.map((id) => ({
       title: `${chalk.bold(FEATURES[id].name.padEnd(10))} ${chalk.gray(FEATURES[id].description)}`,
       value: id,
@@ -606,9 +813,11 @@ async function resolveOptions(options) {
     const merged = /* @__PURE__ */ new Set([...templateFeatures, ...appTypeDefaults]);
     selectedFeatures = resolveFeatureDependencies(Array.from(merged));
   }
-  const moduleConfigs = options.moduleConfigs ?? await promptModuleConfigs(selectedFeatures, projectName);
+  const moduleConfigs = selectedAppType === "fullstack" ? options.moduleConfigs ?? {} : options.moduleConfigs ?? (useDefaults ? buildDefaultModuleConfigs(selectedFeatures, projectName) : await promptModuleConfigs(selectedFeatures, projectName));
   let addExamples = options.examples;
-  if (addExamples === void 0) {
+  if (addExamples === void 0 && useDefaults) {
+    addExamples = true;
+  } else if (addExamples === void 0) {
     const { examples } = await prompts({
       type: "confirm",
       name: "examples",
@@ -618,7 +827,10 @@ async function resolveOptions(options) {
     addExamples = examples;
   }
   const detected = await detectPackageManager(options.cwd ?? ".");
-  let packageManager = options.packageManager;
+  let packageManager = selectedAppType === "fullstack" ? "pnpm" : options.packageManager;
+  if (!packageManager && useDefaults) {
+    packageManager = detected;
+  }
   if (!packageManager) {
     const { pm } = await prompts({
       type: "select",
@@ -634,7 +846,9 @@ async function resolveOptions(options) {
     packageManager = pm;
   }
   let install = options.install;
-  if (install === void 0) {
+  if (install === void 0 && useDefaults) {
+    install = true;
+  } else if (install === void 0) {
     const { doInstall } = await prompts({
       type: "confirm",
       name: "doInstall",
@@ -644,7 +858,9 @@ async function resolveOptions(options) {
     install = doInstall;
   }
   let git = options.git;
-  if (git === void 0) {
+  if (git === void 0 && useDefaults) {
+    git = true;
+  } else if (git === void 0) {
     const { initGit } = await prompts({
       type: "confirm",
       name: "initGit",
@@ -654,7 +870,9 @@ async function resolveOptions(options) {
     git = initGit;
   }
   let gitRemote = options.gitRemote;
-  if (git && gitRemote === void 0) {
+  if (git && gitRemote === void 0 && useDefaults) {
+    gitRemote = "";
+  } else if (git && gitRemote === void 0) {
     const { remote } = await prompts({
       type: "text",
       name: "remote",
@@ -673,6 +891,7 @@ async function resolveOptions(options) {
   return {
     name: projectName,
     appType: selectedAppType,
+    frontends: selectedFrontends,
     template: selectedTemplate ?? "default",
     features: selectedFeatures,
     moduleConfigs,
@@ -681,10 +900,58 @@ async function resolveOptions(options) {
     packageManager: packageManager || "pnpm",
     git: git ?? true,
     gitRemote: gitRemote ?? "",
+    yes: useDefaults,
     verbose: options.verbose ?? false,
     cwd: options.cwd ?? "."
   };
 }
+function buildDefaultModuleConfigs(features, projectName) {
+  const configs = {
+    core: { name: projectName, defaultLocale: "zh-CN" }
+  };
+  if (features.includes("db")) {
+    configs.db = { type: "sqlite", database: "./data/app.db" };
+  }
+  if (features.includes("cache")) {
+    configs.cache = { type: "memory" };
+  }
+  if (features.includes("iam")) {
+    configs.iam = { loginPassword: true, loginOtp: false };
+  }
+  if (features.includes("storage")) {
+    configs.storage = { type: "local", localPath: "./data/uploads" };
+  }
+  if (features.includes("ai")) {
+    configs.ai = { defaultProvider: "openai", model: "gpt-4o-mini" };
+  }
+  return configs;
+}
+async function resolveFrontendTargets(frontends, useDefaults, onCancel) {
+  if (frontends && frontends.length > 0) {
+    return normalizeFrontendTargets(frontends);
+  }
+  if (useDefaults) {
+    return DEFAULT_FULLSTACK_FRONTENDS2;
+  }
+  const { selectedFrontends } = await prompts({
+    type: "multiselect",
+    name: "selectedFrontends",
+    message: "\u9009\u62E9\u524D\u7AEF\u76EE\u6807 (\u7A7A\u683C\u9009\u62E9\uFF0C\u56DE\u8F66\u786E\u8BA4):",
+    choices: Object.entries(FRONTEND_TARGETS).map(([id, target]) => ({
+      title: `${chalk.bold(target.name.padEnd(8))} ${chalk.gray(target.description)}`,
+      value: id,
+      selected: DEFAULT_FULLSTACK_FRONTENDS2.includes(id)
+    })),
+    hint: "- \u5C0F\u7A0B\u5E8F\u5F53\u524D\u4E3A\u9884\u7559\u5360\u4F4D\uFF0C\u4E0D\u751F\u6210\u53EF\u8FD0\u884C\u5DE5\u7A0B",
+    instructions: false
+  }, { onCancel });
+  return normalizeFrontendTargets(selectedFrontends ?? DEFAULT_FULLSTACK_FRONTENDS2);
+}
+function normalizeFrontendTargets(frontends) {
+  const validTargets = new Set(Object.keys(FRONTEND_TARGETS));
+  const result = frontends.filter((target) => validTargets.has(target));
+  return [...new Set(result.length > 0 ? result : DEFAULT_FULLSTACK_FRONTENDS2)];
+}
 function resolveFeatureDependencies(features) {
   const result = new Set(features);
   let changed = true;
@@ -890,6 +1157,7 @@ ${pm} dev
 
 \`\`\`bash
 ${pm} build
+${pm} i18n:compile
 ${pm} preview
 \`\`\`
 
@@ -900,6 +1168,62 @@ ${pm} preview
 - [Svelte 5](https://svelte.dev/)
 `;
 }
+function generateFullstackReadme(name, pm, frontends) {
+  const enabledFrontends = frontends.map((target) => FRONTEND_TARGETS[target].name).join(" / ");
+  return `# ${name}
+
+\u57FA\u4E8E hai Agent Framework \u6784\u5EFA\u7684\u524D\u540E\u7AEF\u5206\u79BB\u591A\u5305\u5DE5\u7A0B\u3002
+
+## \u5DE5\u7A0B\u7ED3\u6784
+
+- \`packages/${name}-contract\`\uFF1A\u524D\u540E\u7AEF\u5171\u4EAB API \u5951\u7EA6\u3001Zod Schema \u4E0E\u7C7B\u578B
+- \`packages/${name}-serv\`\uFF1A\u540E\u7AEF API Service\uFF08\u901A\u8FC7 \`@h-ai/serv\` \u66B4\u9732\u6700\u5C0F HTTP App \u62BD\u8C61\uFF0C\u4E0D\u76F4\u63A5\u66B4\u9732 Hono\uFF09
+- \`packages/${name}-shared\`\uFF1A\u8DE8\u7AEF\u5171\u4EAB Shell\u3001\u4E3B\u9898\u3001\u8BED\u8A00\u5207\u6362\u3001API client \u4E0E\u5171\u4EAB messages
+- \`apps/${name}-web\`\uFF1AWeb \u524D\u7AEF${frontends.includes("web") ? "" : "\uFF08\u672A\u542F\u7528\uFF09"}
+- \`apps/${name}-app\`\uFF1A\u79FB\u52A8\u7AEF App/H5 \u524D\u7AEF${frontends.includes("app") ? "" : "\uFF08\u672A\u542F\u7528\uFF09"}
+- \`apps/${name}-desktop\`\uFF1A\u684C\u9762\u7AEF\u524D\u7AEF${frontends.includes("desktop") ? "" : "\uFF08\u672A\u542F\u7528\uFF09"}
+- \`apps/${name}-miniapp\`\uFF1A\u5C0F\u7A0B\u5E8F\u9884\u7559\u8BF4\u660E\u4E0E\u672C\u7AEF inlang messages${frontends.includes("miniapp") ? "\uFF08\u5360\u4F4D\uFF0C\u4E0D\u53C2\u4E0E\u6784\u5EFA\uFF09" : "\uFF08\u672A\u542F\u7528\uFF09"}
+
+\u5DF2\u542F\u7528\u524D\u7AEF\uFF1A${enabledFrontends || "Web / App / Desktop"}
+
+## \u5F00\u53D1
+
+\`\`\`bash
+${pm} install
+${pm} dev
+\`\`\`
+
+## i18n \u4E0E shared \u534F\u540C
+
+- shared\uFF1A\`packages/${name}-shared/project.inlang\` + \`messages/\`\uFF0C\u53EA\u653E\u8DE8\u7AEF\u5171\u4EAB\u7EC4\u4EF6\u6587\u6848\u3002
+- web/app/desktop\uFF1A\u6BCF\u4E2A\u5E94\u7528\u90FD\u6709\u81EA\u5DF1\u7684 \`project.inlang\` + \`messages/\`\uFF0C\u7528\u4E8E\u672C\u7AEF\u9875\u9762\u4E0E\u4EA7\u54C1\u6587\u6848\u3002
+- miniapp\uFF1A\u5F53\u524D\u662F\u5360\u4F4D\uFF0C\u4F46\u4E5F\u6709\u81EA\u5DF1\u7684 \`project.inlang\` + \`messages/\`\uFF0C\u4FBF\u4E8E\u540E\u7EED\u63A5\u5165\u771F\u5B9E\u5C0F\u7A0B\u5E8F\u6846\u67B6\u3002
+- \u65B0\u589E locale \u65F6\uFF0Cshared \u4E0E\u6240\u6709\u542F\u7528\u524D\u7AEF\u7684 \`locales\` \u5FC5\u987B\u540C\u6B65\uFF1B\u8BED\u8A00\u5207\u6362\u5668\u4F1A\u540C\u65F6\u66F4\u65B0 shared runtime \u4E0E\u5BBF\u4E3B\u5E94\u7528 runtime\u3002
+- \`${pm} i18n:compile\` \u4F1A\u7EDF\u4E00\u7F16\u8BD1 shared \u4E0E\u6BCF\u4E2A\u542F\u7528\u524D\u7AEF\u7684 Paraglide \u8F93\u51FA\uFF1B\u5404\u524D\u7AEF\u4E5F\u53EF\u5355\u72EC\u8FD0\u884C \`${pm} --filter ${name}-web paraglide:compile\` \u7B49\u547D\u4EE4\u3002
+
+## \u81EA\u5B9A\u4E49\u5EFA\u8BAE
+
+- \u6539\u5168\u5C40 Shell/\u4E3B\u9898/\u8BED\u8A00\u5207\u6362\uFF1A\u7F16\u8F91 \`packages/${name}-shared\`\u3002
+- \u6539\u67D0\u4E2A\u524D\u7AEF\u9875\u9762\u548C\u6587\u6848\uFF1A\u7F16\u8F91\u5BF9\u5E94 \`apps/${name}-*/src/routes\` \u4E0E \`apps/${name}-*/messages\`\u3002
+- \u6539\u4E3B\u9898\u5217\u8868\uFF1A\u8C03\u6574\u811A\u624B\u67B6\u914D\u7F6E\u4E2D\u7684 \`fullstack.theme.themes\`\uFF0C\u6216\u76F4\u63A5\u7F16\u8F91\u5404\u7AEF \`src/app.css\` \u7684 daisyUI \`themes\`\u3002
+
+## \u8D28\u91CF\u95E8\u7981
+
+\`\`\`bash
+${pm} typecheck
+${pm} lint
+${pm} test
+${pm} test:e2e
+\`\`\`
+
+## \u6587\u6863
+
+- [hai Agent Framework](https://github.com/hai-series/hai-framework)
+- [SvelteKit](https://kit.svelte.dev/)
+- [@h-ai/serv](./.agents/skills/hai-serv/SKILL.md)
+- [@h-ai/ui](./.agents/skills/hai-ui/SKILL.md)
+`;
+}
 function printCompletionMessage(options) {
   core.logger.info("", {});
   core.logger.info(chalk.green("\u2714 \u9879\u76EE\u521B\u5EFA\u6210\u529F\uFF01"));
@@ -919,7 +1243,13 @@ function printCompletionMessage(options) {
   if (!options.install) {
     core.logger.info(chalk.cyan(`  ${options.packageManager} install`));
   }
-  core.logger.info(chalk.cyan(`  ${options.packageManager} dev`));
+  if (options.appType === "fullstack") {
+    core.logger.info(chalk.cyan(`  ${options.packageManager} typecheck`));
+    core.logger.info(chalk.cyan(`  ${options.packageManager} test`));
+    core.logger.info(chalk.cyan(`  ${options.packageManager} test:e2e`));
+  } else {
+    core.logger.info(chalk.cyan(`  ${options.packageManager} dev`));
+  }
   core.logger.info("", {});
 }
 async function detectProject(cwd) {
@@ -943,7 +1273,7 @@ async function detectProject(cwd) {
   }
 }
 
-// src/commands/add.ts
+// src/commands/cli-add.ts
 var MODULE_MAP = {
   // iam 依赖 crypto（password hash）/ db（user 存储）/ cache（session 缓存）
   "iam": { packages: ["@h-ai/iam"], deps: ["crypto", "db", "cache"], configKey: "iam", description: "\u8EAB\u4EFD\u4E0E\u8BBF\u95EE\u7BA1\u7406" },
@@ -1002,7 +1332,7 @@ async function addModule(options) {
       core.logger.info(`\u53EF\u7528\u6A21\u5757: ${Object.keys(MODULE_MAP).join(", ")}`);
       return;
     }
-    const { generateProjectAiSupport, resolveSkillNamesForPackages } = await import('./skill-templates-N5DU5FNX.js');
+    const { generateProjectAiSupport, resolveSkillNamesForPackages } = await import('./cli-skill-templates-IMYZPQRG.js');
     if (moduleDef.packages.every((p) => project.haiPackages.includes(p))) {
       const generatedFiles2 = await generateProjectAiSupport(
         cwd,
@@ -1116,7 +1446,7 @@ async function deployCommand(options) {
   try {
     let deployModule;
     try {
-      deployModule = await import('./src-RZ4DPYNJ.js');
+      deployModule = await import('./src-N4NPS7AG.js');
     } catch {
       core.logger.error(chalk.red("Deploy module not found. Install @h-ai/deploy first:"));
       core.logger.info(chalk.cyan("  pnpm add @h-ai/deploy"));
@@ -1592,7 +1922,7 @@ async function initProject(options) {
   }
 }
 
-// src/index.ts
+// src/cli-main.ts
 function readCliVersion() {
   try {
     const here = path2.dirname(fileURLToPath(import.meta.url));
@@ -1607,12 +1937,14 @@ var VERSION = readCliVersion();
 var cli = cac("hai");
 cli.option("-v, --verbose", "\u663E\u793A\u8BE6\u7EC6\u8F93\u51FA");
 cli.option("-C, --cwd <path>", "\u5DE5\u4F5C\u76EE\u5F55");
-cli.command("create [name]", "\u521B\u5EFA\u65B0\u7684 hai \u9879\u76EE").option("--type <type>", "\u5E94\u7528\u7C7B\u578B (admin, website, h5, api)").option("-t, --template <template>", "\u9879\u76EE\u6A21\u677F (minimal, default, full, custom)").option("-f, --features <features>", "\u529F\u80FD\u5217\u8868 (\u9017\u53F7\u5206\u9694: iam,db,cache,ai,storage,crypto)").option("--examples", "\u6DFB\u52A0\u793A\u4F8B\u4EE3\u7801").option("--no-examples", "\u4E0D\u6DFB\u52A0\u793A\u4F8B\u4EE3\u7801").option("--no-install", "\u4E0D\u5B89\u88C5\u4F9D\u8D56").option("-p, --package-manager <pm>", "\u5305\u7BA1\u7406\u5668 (pnpm, npm, yarn)").option("--no-git", "\u4E0D\u521D\u59CB\u5316 Git").option("--git-remote <url>", "Git \u8FDC\u7A0B\u4ED3\u5E93\u5730\u5740").action(async (name, options) => {
+cli.command("create [name]", "\u521B\u5EFA\u65B0\u7684 hai \u9879\u76EE").option("--type <type>", "\u5E94\u7528\u7C7B\u578B (admin, website, h5, api, android-app, fullstack)").option("--frontends <targets>", "\u524D\u540E\u7AEF\u5206\u79BB\u5DE5\u7A0B\u524D\u7AEF\u76EE\u6807 (\u9017\u53F7\u5206\u9694: web,app,miniapp,desktop)").option("-t, --template <template>", "\u9879\u76EE\u6A21\u677F (minimal, default, full, custom)").option("-f, --features <features>", "\u529F\u80FD\u5217\u8868 (\u9017\u53F7\u5206\u9694: iam,db,cache,ai,storage,crypto)").option("--examples", "\u6DFB\u52A0\u793A\u4F8B\u4EE3\u7801").option("--no-examples", "\u4E0D\u6DFB\u52A0\u793A\u4F8B\u4EE3\u7801").option("--no-install", "\u4E0D\u5B89\u88C5\u4F9D\u8D56").option("-p, --package-manager <pm>", "\u5305\u7BA1\u7406\u5668 (pnpm, npm, yarn)").option("--no-git", "\u4E0D\u521D\u59CB\u5316 Git").option("--git-remote <url>", "Git \u8FDC\u7A0B\u4ED3\u5E93\u5730\u5740").option("-y, --yes", "\u4F7F\u7528\u9ED8\u8BA4\u914D\u7F6E\uFF0C\u8DF3\u8FC7\u4EA4\u4E92").action(async (name, options) => {
   try {
     const features = typeof options.features === "string" ? options.features.split(",").map((f) => f.trim()) : void 0;
+    const frontends = typeof options.frontends === "string" ? options.frontends.split(",").map((f) => f.trim()).filter(Boolean) : void 0;
     await createProject({
       name: name ?? "",
       appType: options.type,
+      frontends,
       template: options.template,
       features,
       examples: options.examples,
@@ -1620,6 +1952,7 @@ cli.command("create [name]", "\u521B\u5EFA\u65B0\u7684 hai \u9879\u76EE").option
       packageManager: options.packageManager,
       git: options.git,
       gitRemote: options.gitRemote,
+      yes: options.yes,
       verbose: options.verbose,
       cwd: options.cwd
     });