flu-cli 2.0.5 → 2.1.0

package/scripts/smoke-vnext-generate.mjs

@@ -0,0 +1,1934 @@
+import fs from 'fs'
+import os from 'os'
+import path from 'path'
+import { spawnSync } from 'child_process'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const repoRoot = path.resolve(__dirname, '../../..')
+const cliEntry = path.join(repoRoot, 'packages/cli/index.js')
+const sourceTemplateRoots = {
+  lite: path.join(repoRoot, 'packages', 'core', 'templates', 'template_lite'),
+  modular: path.join(repoRoot, 'packages', 'core', 'templates', 'template_modular'),
+  clean: path.join(repoRoot, 'packages', 'core', 'templates', 'template_clean'),
+}
+
+function assert(condition, message) {
+  if (!condition) {
+    throw new Error(message)
+  }
+}
+
+function runCli(args, cwd, extraEnv = {}) {
+  const result = spawnSync(process.execPath, [cliEntry, ...args], {
+    cwd,
+    env: {
+      ...process.env,
+      FLU_CLI_NON_INTERACTIVE: '1',
+      ...extraEnv,
+    },
+    encoding: 'utf8',
+  })
+
+  if (result.status !== 0) {
+    throw new Error(
+      [
+        `CLI command failed: node ${path.relative(repoRoot, cliEntry)} ${args.join(' ')}`,
+        result.stdout,
+        result.stderr,
+      ]
+        .filter(Boolean)
+        .join('\n'),
+    )
+  }
+
+  return result
+}
+
+function runCliJson(args, cwd, extraEnv = {}) {
+  const result = runCli([...args, '--json'], cwd, extraEnv)
+  const output = result.stdout.trim()
+  assert(output.startsWith('{'), `CLI JSON output should start with JSON object. actual=${output}`)
+  const parsed = JSON.parse(output)
+  assert(parsed.ok === true, `CLI JSON command should be ok: ${output}`)
+  return parsed
+}
+
+function exists(target) {
+  return fs.existsSync(target)
+}
+
+function fileIncludes(target, needle) {
+  return fs.readFileSync(target, 'utf8').includes(needle)
+}
+
+function listDartFiles(dir) {
+  if (!fs.existsSync(dir)) return []
+  const entries = fs.readdirSync(dir, { withFileTypes: true })
+  return entries.flatMap((entry) => {
+    const fullPath = path.join(dir, entry.name)
+    if (entry.isDirectory()) return listDartFiles(fullPath)
+    return entry.name.endsWith('.dart') ? [fullPath] : []
+  })
+}
+
+function readPubspecName(projectRoot) {
+  const pubspec = fs.readFileSync(path.join(projectRoot, 'pubspec.yaml'), 'utf8')
+  const match = pubspec.match(/^name:\s*([a-zA-Z0-9_]+)/m)
+  return match?.[1] || ''
+}
+
+function assertProjectImportsResolvable(projectRoot) {
+  const packageName = readPubspecName(projectRoot)
+  assert(packageName, `pubspec name missing: ${projectRoot}`)
+
+  const errors = []
+  for (const file of listDartFiles(path.join(projectRoot, 'lib'))) {
+    const content = fs.readFileSync(file, 'utf8')
+    const matches = content.matchAll(/^(?:import|export) '([^']+)'/gm)
+    for (const match of matches) {
+      const specifier = match[1]
+      if (specifier.startsWith('.')) {
+        const target = path.normalize(path.join(path.dirname(file), specifier))
+        if (!fs.existsSync(target)) {
+          errors.push(`${path.relative(projectRoot, file)} -> ${specifier}`)
+        }
+        continue
+      }
+
+      const localPrefix = `package:${packageName}/`
+      if (specifier.startsWith(localPrefix)) {
+        const target = path.join(projectRoot, 'lib', specifier.slice(localPrefix.length))
+        if (!fs.existsSync(target)) {
+          errors.push(`${path.relative(projectRoot, file)} -> ${specifier}`)
+        }
+      }
+    }
+  }
+
+  assert(errors.length === 0, `generated Dart imports should resolve:\n${errors.join('\n')}`)
+}
+
+function assertNoLegacyCoreMixinDirs(projectRoot, label) {
+  for (const dirName of ['page', 'service', 'viewmodel']) {
+    assert(
+      !exists(path.join(projectRoot, 'lib/core', dirName)),
+      `${label} should not generate legacy lib/core/${dirName} mixin directory`,
+    )
+  }
+}
+
+function assertNoCoreMixinCandidates(projectRoot, label) {
+  assert(
+    !exists(path.join(projectRoot, 'lib/core/mixins')),
+    `${label} should not generate lib/core/mixins when mixin options are disabled`,
+  )
+}
+
+function assertHomeHasNoStarterNoise(homePath, label) {
+  for (const needle of [
+    '项目已就绪',
+    '运营总览',
+    '模块总览',
+    '分层总览',
+    '交互事件',
+    '运行环境',
+    '协议状态',
+    '数据源',
+    '联系我们',
+  ]) {
+    assert(!fileIncludes(homePath, needle), `${label} home should not include ${needle}`)
+  }
+}
+
+function assertHomeHasNoExampleModule(homePath, label) {
+  assert(
+    !fileIncludes(homePath, "_buildSectionTitle('示例')"),
+    `${label} home should not render examples section without selected examples`,
+  )
+}
+
+function assertHomeHasExampleModule(homePath, label) {
+  assert(
+    fileIncludes(homePath, "_buildSectionTitle('示例')"),
+    `${label} home should render examples section when examples are selected`,
+  )
+}
+
+function homePagePathForTemplate(projectRoot, template) {
+  if (template === 'modular') {
+    return path.join(projectRoot, 'lib/features/home/pages/home_page.dart')
+  }
+  if (template === 'clean') {
+    return path.join(projectRoot, 'lib/features/home/presentation/pages/home_page.dart')
+  }
+  return path.join(projectRoot, 'lib/pages/home_page.dart')
+}
+
+function assertAddPageWorks(
+  projectRoot,
+  pageName,
+  expectedPagePath,
+  expectedViewModelPath,
+  cliArgs = [],
+) {
+  runCli(['add', 'page', pageName, ...cliArgs], projectRoot)
+
+  assert(
+    exists(path.join(projectRoot, expectedPagePath)),
+    `add page should create ${expectedPagePath}`,
+  )
+  if (expectedViewModelPath) {
+    assert(
+      exists(path.join(projectRoot, expectedViewModelPath)),
+      `add page should create ${expectedViewModelPath}`,
+    )
+  }
+  assertProjectImportsResolvable(projectRoot)
+}
+
+function assertAddViewModelWorks(projectRoot, viewModelName, expectedViewModelPath) {
+  runCli(['add', 'vm', viewModelName], projectRoot)
+
+  assert(
+    exists(path.join(projectRoot, expectedViewModelPath)),
+    `add vm should create ${expectedViewModelPath}`,
+  )
+  assertProjectImportsResolvable(projectRoot)
+}
+
+function installFakeFlutter(root) {
+  const sdkRoot = path.join(root, 'fake_flutter')
+  const binDir = path.join(sdkRoot, 'bin')
+  const flutterBin = path.join(binDir, 'flutter')
+
+  fs.mkdirSync(binDir, { recursive: true })
+  fs.writeFileSync(
+    flutterBin,
+    [
+      '#!/bin/sh',
+      'set -eu',
+      'if [ "$#" -ge 1 ] && [ "$1" = "--version" ]; then',
+      '  echo "Flutter 3.35.8 channel stable https://github.com/flutter/flutter.git"',
+      '  echo "Tools Dart 3.9.2 DevTools 2.48.0"',
+      '  exit 0',
+      'fi',
+      'if [ "$#" -ge 2 ] && [ "$1" = "create" ] && [ "$2" = "-h" ]; then',
+      '  echo "Usage: flutter create [arguments] <output directory>"',
+      '  echo "    --platforms    The platforms supported by this project. [android (default), ios (default), web, ohos]"',
+      '  exit 0',
+      'fi',
+      'if [ "$#" -ge 2 ] && [ "$1" = "pub" ] && [ "$2" = "get" ]; then',
+      '  echo "Resolving dependencies..."',
+      '  echo "Got dependencies!"',
+      '  exit 0',
+      'fi',
+      'if [ "$#" -ge 1 ] && [ "$1" = "create" ]; then',
+      '  target=""',
+      '  platforms="android,ios"',
+      '  while [ "$#" -gt 0 ]; do',
+      '    case "$1" in',
+      '      --platforms)',
+      '        shift',
+      '        platforms="$1"',
+      '        ;;',
+      '      *)',
+      '        target="$1"',
+      '        ;;',
+      '    esac',
+      '    shift || true',
+      '  done',
+      '  mkdir -p "$target/lib" "$target/test"',
+      '  printf "name: fake_project\\ndescription: Fake Flutter project for CLI smoke.\\npublish_to: none\\nenvironment:\\n  sdk: \\"^3.0.0\\"\\ndependencies:\\n  flutter:\\n    sdk: flutter\\ndev_dependencies:\\n  flutter_test:\\n    sdk: flutter\\nflutter:\\n  uses-material-design: true\\n" > "$target/pubspec.yaml"',
+      '  cat > "$target/lib/main.dart" <<\'MAIN_EOF\'',
+      "import 'package:flutter/material.dart';",
+      '',
+      'void main() {',
+      '  runApp(const MyApp());',
+      '}',
+      '',
+      'class MyApp extends StatelessWidget {',
+      '  const MyApp({super.key});',
+      '',
+      '  @override',
+      '  Widget build(BuildContext context) {',
+      "    return const MaterialApp(home: Scaffold(body: Center(child: Text('Fake'))));",
+      '  }',
+      '}',
+      'MAIN_EOF',
+      '  cat > "$target/test/widget_test.dart" <<\'TEST_EOF\'',
+      "import 'package:flutter/material.dart';",
+      "import 'package:flutter_test/flutter_test.dart';",
+      '',
+      'void main() {',
+      "  testWidgets('Counter increments smoke test', (WidgetTester tester) async {",
+      '    expect(1 + 1, 2);',
+      '  });',
+      '}',
+      'TEST_EOF',
+      '  oldIFS="$IFS"',
+      '  IFS=","',
+      '  for platform in $platforms; do',
+      '    mkdir -p "$target/$platform"',
+      '    if [ "$platform" = "android" ]; then',
+      '      mkdir -p "$target/android/app/src/main"',
+      '      mkdir -p "$target/android/app/src/debug"',
+      '      printf "android { namespace \\"com.example.fake\\" defaultConfig { applicationId \\"com.example.fake\\" } }\\n" > "$target/android/app/build.gradle"',
+      '      printf "<manifest package=\\"com.example.fake\\"></manifest>\\n" > "$target/android/app/src/main/AndroidManifest.xml"',
+      '    fi',
+      '    if [ "$platform" = "ios" ]; then',
+      '      mkdir -p "$target/ios/Runner"',
+      '      mkdir -p "$target/ios/Runner.xcodeproj"',
+      '      printf "PRODUCT_BUNDLE_IDENTIFIER = com.example.fake;\\n" > "$target/ios/Runner.xcodeproj/project.pbxproj"',
+      '      cat > "$target/ios/Podfile" <<\'PODFILE_EOF\'',
+      "platform :ios, '12.0'",
+      '',
+      "target 'Runner' do",
+      '  use_frameworks!',
+      'end',
+      '',
+      'post_install do |installer|',
+      '  installer.pods_project.targets.each do |target|',
+      '    flutter_additional_ios_build_settings(target)',
+      '  end',
+      'end',
+      'PODFILE_EOF',
+      '      cat > "$target/ios/Runner/Info.plist" <<\'PLIST_EOF\'',
+      '<?xml version="1.0" encoding="UTF-8"?>',
+      '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
+      '<plist version="1.0">',
+      '<dict>',
+      '  <key>CFBundleName</key>',
+      '  <string>Fake</string>',
+      '</dict>',
+      '</plist>',
+      'PLIST_EOF',
+      '    fi',
+      '    if [ "$platform" = "ohos" ]; then',
+      '      mkdir -p "$target/ohos/entry/src/main"',
+      '      cat > "$target/ohos/entry/src/main/module.json5" <<\'OHOS_EOF\'',
+      '{',
+      '  "module": {',
+      '    "name": "entry",',
+      '    "type": "entry",',
+      '    "requestPermissions": [],',
+      '    "abilities": [',
+      '      {',
+      '        "name": "EntryAbility"',
+      '      }',
+      '    ]',
+      '  }',
+      '}',
+      'OHOS_EOF',
+      '    fi',
+      '  done',
+      '  IFS="$oldIFS"',
+      '  echo "Created project $target"',
+      '  echo "All done!"',
+      '  exit 0',
+      'fi',
+      'echo "fake flutter: unsupported command $*" >&2',
+      'exit 1',
+      '',
+    ].join('\n'),
+  )
+  fs.chmodSync(flutterBin, 0o755)
+
+  return flutterBin
+}
+
+const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'flu-cli-vnext-cli-smoke-'))
+
+try {
+  const rootHome = path.join(tmpRoot, 'home')
+  const fakeFlutterBin = installFakeFlutter(tmpRoot)
+  const cacheRoot = path.join(rootHome, '.flu-cli', 'templates')
+  fs.mkdirSync(cacheRoot, { recursive: true })
+  for (const [templateName, sourceTemplateRoot] of Object.entries(sourceTemplateRoots)) {
+    const cachedTemplateRoot = path.join(cacheRoot, `template_${templateName}`)
+    assert(exists(sourceTemplateRoot), `template cache missing: ${sourceTemplateRoot}`)
+    fs.cpSync(sourceTemplateRoot, cachedTemplateRoot, { recursive: true })
+  }
+
+  runCli(
+    [
+      'new',
+      'demo_vnext',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_vnext',
+      '--author',
+      'test',
+      '--auth',
+      '--helpers',
+      'payment,webview,permission,imagePicker',
+      '--examples',
+      'webview,permission,image-picker,payment',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const vnextRoot = path.join(tmpRoot, 'demo_vnext')
+  assert(exists(path.join(vnextRoot, 'lib/core/auth/auth_service.dart')), 'auth service missing')
+  assert(
+    exists(path.join(vnextRoot, 'lib/core/network/interceptors/auth_interceptor.dart')),
+    'auth interceptor missing',
+  )
+  assert(exists(path.join(vnextRoot, 'lib/helpers/payment/index.dart')), 'payment helper missing')
+  assert(exists(path.join(vnextRoot, 'lib/helpers/webview/index.dart')), 'webview helper missing')
+  assert(
+    exists(path.join(vnextRoot, 'lib/helpers/permission/index.dart')),
+    'permission helper missing',
+  )
+  assert(
+    exists(path.join(vnextRoot, 'lib/helpers/image_picker/index.dart')),
+    'image_picker helper missing',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/helpers/payment/index.dart'), 'PaymentExecutor'),
+    'payment helper contract missing',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/helpers/webview/index.dart'), 'WebViewController'),
+    'webview helper should include runnable webview_flutter implementation',
+  )
+  assert(
+    fileIncludes(
+      path.join(vnextRoot, 'lib/examples/webview_example_page.dart'),
+      'https://huozhiye.cn/flu-cli',
+    ),
+    'webview example should open Flu CLI official docs by default',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/helpers/permission/index.dart'), 'permission_handler'),
+    'permission helper should include permission_handler implementation',
+  )
+  assert(
+    fileIncludes(
+      path.join(vnextRoot, 'lib/examples/permission_example_page.dart'),
+      'README.platform-permissions.md',
+    ),
+    'permission example should point users to platform permission guide',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/examples/permission_example_page.dart'), '前往设置'),
+    'permission example should offer open-settings action for permanently denied status',
+  )
+  assert(
+    fileIncludes(
+      path.join(vnextRoot, 'lib/examples/permission_example_page.dart'),
+      'showDialog<bool>',
+    ),
+    'permission example should show pre-permission rationale dialog before system request',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/examples/permission_example_page.dart'), '已授权'),
+    'permission example should render human-readable permission status labels',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/helpers/image_picker/index.dart'), 'ImagePickerHelper'),
+    'image picker helper should include runnable implementation',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/helpers/image_picker/index.dart'), 'readAsBytes'),
+    'image picker helper should capture bytes for in-page preview rendering',
+  )
+  assert(
+    fileIncludes(
+      path.join(vnextRoot, 'lib/examples/image_picker_example_page.dart'),
+      'Image.memory',
+    ),
+    'image picker example should render selected image preview',
+  )
+  assert(
+    fileIncludes(
+      path.join(vnextRoot, 'lib/examples/image_picker_example_page.dart'),
+      '当前已选择图片',
+    ),
+    'image picker example should show selected image summary card',
+  )
+  for (const file of [
+    'lib/examples/webview_example_page.dart',
+    'lib/examples/permission_example_page.dart',
+    'lib/examples/image_picker_example_page.dart',
+    'lib/examples/payment_shell_example_page.dart',
+    'lib/examples/index.dart',
+  ]) {
+    assert(exists(path.join(vnextRoot, file)), `helper example file missing: ${file}`)
+  }
+  assert(
+    fileIncludes(
+      path.join(vnextRoot, 'lib/examples/image_picker_example_page.dart'),
+      "return '$bytes B';",
+    ),
+    'image picker example should avoid unnecessary string interpolation braces',
+  )
+  assert(
+    fs.readFileSync(path.join(vnextRoot, 'lib/examples/index.dart'), 'utf8') ===
+      [
+        "export 'image_picker_example_page.dart';",
+        "export 'payment_shell_example_page.dart';",
+        "export 'permission_example_page.dart';",
+        "export 'webview_example_page.dart';",
+        '',
+      ].join('\n'),
+    'helper examples index should keep exports sorted for strict directives_ordering',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/core/router/app_routes.dart'), 'webviewExample'),
+    'webview example route missing',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/core/router/app_routes.dart'), 'permissionExample'),
+    'permission example route missing',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/core/router/app_routes.dart'), 'imagePickerExample'),
+    'image picker example route missing',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/core/router/app_routes.dart'), 'paymentShellExample'),
+    'payment shell example route missing',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/pages/home_page.dart'), 'AppRoutes.webviewExample'),
+    'webview example home entry missing',
+  )
+  assertHomeHasNoStarterNoise(path.join(vnextRoot, 'lib/pages/home_page.dart'), 'helper examples')
+  assertHomeHasExampleModule(path.join(vnextRoot, 'lib/pages/home_page.dart'), 'helper examples')
+  assert(
+    fileIncludes(
+      path.join(vnextRoot, 'android/app/src/main/AndroidManifest.xml'),
+      'android.permission.CAMERA',
+    ),
+    'Android camera permission missing',
+  )
+  assert(
+    fileIncludes(
+      path.join(vnextRoot, 'android/app/src/main/AndroidManifest.xml'),
+      'android.permission.READ_MEDIA_IMAGES',
+    ),
+    'Android media image permission missing',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'ios/Runner/Info.plist'), 'NSCameraUsageDescription'),
+    'iOS camera usage description missing',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'ios/Runner/Info.plist'), 'NSPhotoLibraryUsageDescription'),
+    'iOS photo usage description missing',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'ios/Podfile'), 'PERMISSION_CAMERA=1'),
+    'iOS Podfile camera macro missing',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'ios/Podfile'), 'PERMISSION_PHOTOS=1'),
+    'iOS Podfile photos macro missing',
+  )
+  assert(
+    fileIncludes(
+      path.join(vnextRoot, 'ios/Podfile'),
+      'target.build_configurations.each do |config|',
+    ),
+    'iOS Podfile macros should be wrapped in target build configurations loop',
+  )
+  assert(
+    exists(path.join(vnextRoot, 'lib/helpers/README.platform-permissions.md')),
+    'helper platform permission README missing',
+  )
+  assert(
+    fileIncludes(
+      path.join(vnextRoot, 'lib/helpers/README.platform-permissions.md'),
+      'ios/Runner/Info.plist',
+    ),
+    'helper platform permission README should mention iOS permission path',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, 'lib/helpers/README.platform-permissions.md'), 'ios/Podfile'),
+    'helper platform permission README should mention iOS Podfile macros',
+  )
+  assert(
+    !exists(path.join(vnextRoot, 'lib/pages/eg_list_page.dart')),
+    'network without networkGallery should not generate gallery list page',
+  )
+  assertNoCoreMixinCandidates(vnextRoot, 'default project')
+  assert(
+    exists(path.join(vnextRoot, 'lib/pages/splash_page.dart')),
+    'default starter project should generate SplashPage',
+  )
+  assert(
+    !exists(path.join(vnextRoot, 'lib/pages/user_list_page.dart')),
+    'default starter project should not keep legacy user list page',
+  )
+  assert(
+    !exists(path.join(vnextRoot, 'lib/viewmodels/user_list_viewmodel.dart')),
+    'default starter project should not keep legacy user list viewmodel',
+  )
+  assert(
+    !exists(path.join(vnextRoot, 'lib/widgets/user_item_widget.dart')),
+    'default starter project should not keep legacy user list widget',
+  )
+  assert(
+    !exists(path.join(vnextRoot, 'lib/models/mock_data.dart')),
+    'network without networkGallery should not generate gallery mock data',
+  )
+  assert(
+    !fileIncludes(path.join(vnextRoot, 'lib/core/router/app_routes.dart'), 'egList'),
+    'network without networkGallery should not register gallery route',
+  )
+  assert(
+    !exists(path.join(vnextRoot, 'lib/services/home_feed_service.dart')),
+    'network without networkGallery should not generate network-backed home feed service',
+  )
+  assert(
+    !fileIncludes(path.join(vnextRoot, 'lib/pages/home_page.dart'), 'AppRoutes.userList'),
+    'default home should not keep legacy user list entry',
+  )
+  assert(
+    !fileIncludes(path.join(vnextRoot, 'lib/core/router/app_routes.dart'), 'userList:'),
+    'default routes should not keep legacy user list route',
+  )
+  assert(
+    !fileIncludes(path.join(vnextRoot, 'lib/pages/index.dart'), 'user_list_page.dart'),
+    'default pages index should not export legacy user list page',
+  )
+  assert(
+    !fileIncludes(path.join(vnextRoot, 'lib/core/index.dart'), 'PaymentHelper'),
+    'helper export leaked into core index',
+  )
+  assert(
+    exists(path.join(vnextRoot, '.flu-cli.json')),
+    'built-in lite project should write .flu-cli.json',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, '.flu-cli.json'), '"template": "lite"'),
+    'generated .flu-cli.json should preserve lite template metadata',
+  )
+  assert(
+    fileIncludes(path.join(vnextRoot, '.flu-cli.json'), '"mode": "mvvm"'),
+    'generated .flu-cli.json should persist architecture mode',
+  )
+  assertProjectImportsResolvable(vnextRoot)
+
+  runCli(
+    [
+      'new',
+      'demo_native_mixins',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_native_mixins',
+      '--author',
+      'test',
+      '--architecture-mode',
+      'native',
+      '--composition-profile',
+      'base_mixins',
+      '--enable-mixin-options',
+      'true',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const nativeMixinsRoot = path.join(tmpRoot, 'demo_native_mixins')
+  assert(
+    fileIncludes(path.join(nativeMixinsRoot, '.flu-cli.json'), '"mode": "native"'),
+    'native architecture mode should persist to .flu-cli.json',
+  )
+  assert(
+    fileIncludes(path.join(nativeMixinsRoot, '.flu-cli.json'), '"native": true'),
+    'native architecture should mark page/viewModel generators as native in .flu-cli.json',
+  )
+  assert(
+    fileIncludes(path.join(nativeMixinsRoot, '.flu-cli.json'), '"withBasePage": false'),
+    'native architecture should disable BasePage generation in .flu-cli.json',
+  )
+  assert(
+    fileIncludes(path.join(nativeMixinsRoot, '.flu-cli.json'), '"withViewModel": false'),
+    'native architecture should disable page ViewModel generation in .flu-cli.json',
+  )
+  assert(
+    fileIncludes(path.join(nativeMixinsRoot, '.flu-cli.json'), '"withBaseViewModel": false'),
+    'native architecture should disable BaseViewModel generation in .flu-cli.json',
+  )
+  assert(
+    !fileIncludes(path.join(nativeMixinsRoot, '.flu-cli.json'), '"mixinOptionDirs"'),
+    'native architecture should not keep mixin option directories in .flu-cli.json',
+  )
+
+  runCli(
+    [
+      'new',
+      'demo_base_mixins',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_base_mixins',
+      '--author',
+      'test',
+      '--network',
+      '--composition-profile',
+      'base_mixins',
+      '--enable-mixin-options',
+      'true',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const baseMixinsRoot = path.join(tmpRoot, 'demo_base_mixins')
+  assert(
+    exists(path.join(baseMixinsRoot, 'lib/core/mixins/page/keep_alive_mixin.dart')),
+    'base_mixins should generate page mixin candidates',
+  )
+  assert(
+    exists(path.join(baseMixinsRoot, 'lib/core/mixins/page/scroll_controller_mixin.dart')),
+    'base_mixins should generate page mixin utility candidates',
+  )
+  assert(
+    exists(path.join(baseMixinsRoot, 'lib/core/mixins/viewmodel/debounce_mixin.dart')),
+    'base_mixins should generate viewmodel mixin candidates',
+  )
+  assert(
+    exists(path.join(baseMixinsRoot, 'lib/core/mixins/service/request_guard_mixin.dart')),
+    'base_mixins should generate service mixin candidates',
+  )
+  assertNoLegacyCoreMixinDirs(baseMixinsRoot, 'base_mixins')
+  assert(
+    fileIncludes(path.join(baseMixinsRoot, '.flu-cli.json'), '"mixinOptionDirs"'),
+    'base_mixins should persist mixin option directories to .flu-cli.json',
+  )
+  assert(
+    fileIncludes(path.join(baseMixinsRoot, '.flu-cli.json'), '"withBasePage": true'),
+    'base_mixins should keep BasePage generation enabled',
+  )
+  assert(
+    exists(path.join(baseMixinsRoot, 'lib/core/base/base_service.dart')),
+    'base_mixins + network should generate BaseService',
+  )
+  assert(
+    fileIncludes(
+      path.join(baseMixinsRoot, 'lib/core/base/base_service.dart'),
+      'abstract class BaseService',
+    ),
+    'base_mixins + network BaseService should be available for generated services',
+  )
+  assert(
+    fileIncludes(path.join(baseMixinsRoot, '.flu-cli.json'), '"baseServiceClass": "BaseService"'),
+    'base_mixins + network should persist BaseService for service generator',
+  )
+  runCli(
+    ['add', 'page', 'mixin_probe', '--mixins', 'KeepAliveMixin,ScrollControllerMixin'],
+    baseMixinsRoot,
+  )
+  assert(
+    fileIncludes(
+      path.join(baseMixinsRoot, 'lib/pages/mixin_probe_page.dart'),
+      'with KeepAliveMixin, ScrollControllerMixin',
+    ),
+    'base_mixins add page should apply selected mixins to generated page',
+  )
+  runCli(['add', 'vm', 'mixin_vm_probe', '--mixins', 'DebounceMixin'], baseMixinsRoot)
+  assert(
+    fileIncludes(
+      path.join(baseMixinsRoot, 'lib/viewmodels/mixin_vm_probe_viewmodel.dart'),
+      'extends BaseViewModel with DebounceMixin',
+    ),
+    'base_mixins add vm should apply selected mixins to generated viewmodel',
+  )
+  runCli(['add', 'service', 'mixin_service_probe', '--mixins', 'RequestGuardMixin'], baseMixinsRoot)
+  assert(
+    fileIncludes(
+      path.join(baseMixinsRoot, 'lib/services/mixin_service_probe_service.dart'),
+      'class MixinServiceProbeService extends BaseService with RequestGuardMixin',
+    ),
+    'base_mixins add service should extend BaseService and apply selected mixins',
+  )
+  assert(
+    fileIncludes(
+      path.join(baseMixinsRoot, 'lib/services/mixin_service_probe_service.dart'),
+      'MixinServiceProbeService({super.http});',
+    ),
+    'base_mixins add service should reuse BaseService http injection',
+  )
+
+  runCli(
+    [
+      'new',
+      'demo_base_mixins_disabled',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_base_mixins_disabled',
+      '--author',
+      'test',
+      '--network',
+      '--composition-profile',
+      'base_mixins',
+      '--enable-mixin-options',
+      'false',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const baseMixinsDisabledRoot = path.join(tmpRoot, 'demo_base_mixins_disabled')
+  assertNoCoreMixinCandidates(baseMixinsDisabledRoot, 'base_mixins disabled')
+  assert(
+    !fileIncludes(path.join(baseMixinsDisabledRoot, '.flu-cli.json'), '"mixinOptionDirs"'),
+    'base_mixins disabled should not persist mixin option directories',
+  )
+  assert(
+    fileIncludes(path.join(baseMixinsDisabledRoot, '.flu-cli.json'), '"withBasePage": true'),
+    'base_mixins disabled should keep BasePage generation enabled',
+  )
+  assert(
+    exists(path.join(baseMixinsDisabledRoot, 'lib/core/base/base_service.dart')),
+    'base mixins disabled + network should still generate BaseService',
+  )
+
+  runCli(
+    [
+      'new',
+      'demo_pure_mixins',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_pure_mixins',
+      '--author',
+      'test',
+      '--network',
+      '--composition-profile',
+      'pure_mixins',
+      '--enable-mixin-options',
+      'true',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const pureMixinsRoot = path.join(tmpRoot, 'demo_pure_mixins')
+  assert(
+    !exists(path.join(pureMixinsRoot, 'lib/core/base/base_service.dart')),
+    'pure_mixins + network should not generate BaseService',
+  )
+  assert(
+    fileIncludes(path.join(pureMixinsRoot, '.flu-cli.json'), '"withBasePage": false'),
+    'pure_mixins should disable BasePage generation in .flu-cli.json',
+  )
+  assert(
+    fileIncludes(path.join(pureMixinsRoot, '.flu-cli.json'), '"withViewModel": true'),
+    'pure_mixins should keep page ViewModel generation enabled',
+  )
+  assert(
+    fileIncludes(path.join(pureMixinsRoot, '.flu-cli.json'), '"withBaseViewModel": false'),
+    'pure_mixins should disable BaseViewModel generation in .flu-cli.json',
+  )
+  assert(
+    exists(path.join(pureMixinsRoot, 'lib/core/mixins/page/keep_alive_mixin.dart')),
+    'pure_mixins should also generate page mixin candidates',
+  )
+  assertHomeHasNoStarterNoise(path.join(pureMixinsRoot, 'lib/pages/home_page.dart'), 'pure_mixins')
+  assertHomeHasNoExampleModule(path.join(pureMixinsRoot, 'lib/pages/home_page.dart'), 'pure_mixins')
+  assertNoLegacyCoreMixinDirs(pureMixinsRoot, 'pure_mixins')
+  assert(
+    fileIncludes(
+      path.join(pureMixinsRoot, 'lib/pages/home_page.dart'),
+      'class HomePage extends StatefulWidget',
+    ),
+    'pure_mixins starter home page should no longer extend BasePage',
+  )
+  assert(
+    !fileIncludes(path.join(pureMixinsRoot, 'lib/pages/home_page.dart'), 'extends BasePage'),
+    'pure_mixins starter home page should not hardcode BasePage',
+  )
+  assert(
+    !exists(path.join(pureMixinsRoot, 'lib/core/base')),
+    'pure_mixins should not keep core/base directory',
+  )
+  assert(
+    fileIncludes(
+      path.join(pureMixinsRoot, 'lib/viewmodels/home_viewmodel.dart'),
+      'extends ChangeNotifier',
+    ),
+    'pure_mixins starter HomeViewModel should not extend BaseViewModel',
+  )
+  assertAddPageWorks(
+    pureMixinsRoot,
+    'profile_check',
+    'lib/pages/profile_check_page.dart',
+    'lib/viewmodels/profile_check_viewmodel.dart',
+  )
+  assert(
+    fileIncludes(
+      path.join(pureMixinsRoot, 'lib/pages/profile_check_page.dart'),
+      'class ProfileCheckPage extends StatefulWidget',
+    ),
+    'pure_mixins add page should generate a plain StatefulWidget page',
+  )
+  assert(
+    !fileIncludes(
+      path.join(pureMixinsRoot, 'lib/pages/profile_check_page.dart'),
+      'extends BasePage',
+    ),
+    'pure_mixins add page should not extend BasePage',
+  )
+  assert(
+    fileIncludes(
+      path.join(pureMixinsRoot, 'lib/viewmodels/profile_check_viewmodel.dart'),
+      'extends ChangeNotifier',
+    ),
+    'pure_mixins add page should generate a plain ChangeNotifier viewmodel',
+  )
+  assertAddViewModelWorks(pureMixinsRoot, 'vm_check', 'lib/viewmodels/vm_check_viewmodel.dart')
+  assert(
+    fileIncludes(
+      path.join(pureMixinsRoot, 'lib/viewmodels/vm_check_viewmodel.dart'),
+      'extends ChangeNotifier',
+    ),
+    'pure_mixins add vm should generate a plain ChangeNotifier viewmodel',
+  )
+  runCli(
+    ['add', 'page', 'pure_mixin_probe', '--mixins', 'KeepAliveMixin,ScrollControllerMixin'],
+    pureMixinsRoot,
+  )
+  assert(
+    fileIncludes(
+      path.join(pureMixinsRoot, 'lib/pages/pure_mixin_probe_page.dart'),
+      'with KeepAliveMixin, ScrollControllerMixin',
+    ),
+    'pure_mixins add page should apply selected mixins to generated pure page',
+  )
+  runCli(['add', 'vm', 'pure_mixin_vm_probe', '--mixins', 'DebounceMixin'], pureMixinsRoot)
+  assert(
+    fileIncludes(
+      path.join(pureMixinsRoot, 'lib/viewmodels/pure_mixin_vm_probe_viewmodel.dart'),
+      'extends ChangeNotifier with DebounceMixin',
+    ),
+    'pure_mixins add vm should apply selected mixins to generated pure viewmodel',
+  )
+  runCli(
+    ['add', 'service', 'pure_mixin_service_probe', '--mixins', 'RequestGuardMixin'],
+    pureMixinsRoot,
+  )
+  assert(
+    fileIncludes(
+      path.join(pureMixinsRoot, 'lib/services/pure_mixin_service_probe_service.dart'),
+      'class PureMixinServiceProbeService with RequestGuardMixin',
+    ),
+    'pure_mixins add service should apply selected mixins to generated pure service',
+  )
+
+  runCli(
+    [
+      'new',
+      'demo_pure_no_base',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_pure_no_base',
+      '--author',
+      'test',
+      '--composition-profile',
+      'pure',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const pureRoot = path.join(tmpRoot, 'demo_pure_no_base')
+  assert(
+    fileIncludes(path.join(pureRoot, '.flu-cli.json'), '"withBasePage": false'),
+    'pure should disable BasePage generation in .flu-cli.json',
+  )
+  assert(
+    fileIncludes(path.join(pureRoot, '.flu-cli.json'), '"withViewModel": true'),
+    'pure should keep page ViewModel generation enabled',
+  )
+  assert(
+    fileIncludes(
+      path.join(pureRoot, 'lib/pages/home_page.dart'),
+      'class HomePage extends StatefulWidget',
+    ),
+    'pure starter home page should use a plain StatefulWidget',
+  )
+  assert(
+    !fileIncludes(path.join(pureRoot, 'lib/pages/home_page.dart'), 'extends BasePage'),
+    'pure starter home page should not hardcode BasePage',
+  )
+  assert(!exists(path.join(pureRoot, 'lib/core/base')), 'pure should not keep core/base directory')
+  assertNoCoreMixinCandidates(pureRoot, 'pure')
+
+  runCli(
+    [
+      'new',
+      'demo_base_profile',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_base_profile',
+      '--author',
+      'test',
+      '--network',
+      '--composition-profile',
+      'base',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const baseProfileRoot = path.join(tmpRoot, 'demo_base_profile')
+  assertAddPageWorks(
+    baseProfileRoot,
+    'profile_check',
+    'lib/pages/profile_check_page.dart',
+    'lib/viewmodels/profile_check_viewmodel.dart',
+  )
+  assert(
+    fileIncludes(
+      path.join(baseProfileRoot, 'lib/pages/profile_check_page.dart'),
+      'class ProfileCheckPage extends BasePage<ProfileCheckViewModel>',
+    ),
+    'base profile add page should continue extending BasePage',
+  )
+  assert(
+    fileIncludes(
+      path.join(baseProfileRoot, 'lib/viewmodels/profile_check_viewmodel.dart'),
+      'extends BaseViewModel',
+    ),
+    'base profile add page should continue generating BaseViewModel',
+  )
+  assertAddViewModelWorks(baseProfileRoot, 'vm_check', 'lib/viewmodels/vm_check_viewmodel.dart')
+  assert(
+    fileIncludes(
+      path.join(baseProfileRoot, 'lib/viewmodels/vm_check_viewmodel.dart'),
+      'extends BaseViewModel',
+    ),
+    'base profile add vm should continue extending BaseViewModel',
+  )
+  assert(
+    exists(path.join(baseProfileRoot, 'lib/core/base/base_service.dart')),
+    'base + network should generate BaseService',
+  )
+  runCli(['add', 'service', 'profile_data'], baseProfileRoot)
+  assert(
+    fileIncludes(
+      path.join(baseProfileRoot, 'lib/services/profile_data_service.dart'),
+      'class ProfileDataService extends BaseService',
+    ),
+    'base + network add service should extend BaseService',
+  )
+  assert(
+    fileIncludes(
+      path.join(baseProfileRoot, 'lib/services/profile_data_service.dart'),
+      'ProfileDataService({super.http});',
+    ),
+    'base + network add service should reuse BaseService http injection',
+  )
+
+  runCli(
+    [
+      'new',
+      'demo_webview_only',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_webview_only',
+      '--author',
+      'test',
+      '--helpers',
+      'webview',
+      '--examples',
+      'webview',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const webviewOnlyRoot = path.join(tmpRoot, 'demo_webview_only')
+  assert(
+    exists(path.join(webviewOnlyRoot, 'lib/examples/webview_example_page.dart')),
+    'webview-only example page missing',
+  )
+  assert(
+    !exists(path.join(webviewOnlyRoot, 'lib/examples/permission_example_page.dart')),
+    'webview-only project should not generate permission example page',
+  )
+  assert(
+    fileIncludes(
+      path.join(webviewOnlyRoot, 'lib/examples/index.dart'),
+      'webview_example_page.dart',
+    ),
+    'webview-only examples index should export webview page',
+  )
+  assert(
+    !fileIncludes(
+      path.join(webviewOnlyRoot, 'lib/examples/index.dart'),
+      'permission_example_page.dart',
+    ),
+    'webview-only examples index should not export missing permission page',
+  )
+  assertHomeHasNoStarterNoise(
+    path.join(webviewOnlyRoot, 'lib/pages/home_page.dart'),
+    'webview-only',
+  )
+  assertHomeHasExampleModule(path.join(webviewOnlyRoot, 'lib/pages/home_page.dart'), 'webview-only')
+  assertProjectImportsResolvable(webviewOnlyRoot)
+
+  runCli(
+    [
+      'new',
+      'demo_network_gallery',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_network_gallery',
+      '--author',
+      'test',
+      '--examples',
+      'networkGallery',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const networkGalleryRoot = path.join(tmpRoot, 'demo_network_gallery')
+  assert(
+    exists(path.join(networkGalleryRoot, 'lib/pages/eg_list_page.dart')),
+    'networkGallery should generate gallery list page',
+  )
+  assert(
+    exists(path.join(networkGalleryRoot, 'lib/services/eg_service.dart')),
+    'networkGallery should generate gallery service',
+  )
+  assert(
+    exists(path.join(networkGalleryRoot, 'lib/models/mock_data.dart')),
+    'networkGallery should generate default mock data',
+  )
+  assert(
+    fileIncludes(path.join(networkGalleryRoot, 'lib/models/mock_data.dart'), 'feedList'),
+    'networkGallery mock data should contain feedList',
+  )
+  assert(
+    fileIncludes(path.join(networkGalleryRoot, 'lib/services/eg_service.dart'), '/feed-app'),
+    'networkGallery should keep gallery request path inside example service',
+  )
+  assert(
+    fileIncludes(
+      path.join(networkGalleryRoot, 'lib/services/eg_service.dart'),
+      'TuChongExampleAdapter',
+    ),
+    'networkGallery should keep gallery response adapter inside example service',
+  )
+  assert(
+    !fileIncludes(
+      path.join(networkGalleryRoot, 'lib/core/network/response_adapter.dart'),
+      'TuChongAdapter',
+    ),
+    'network core should not contain gallery-specific TuChong adapter',
+  )
+  assert(
+    fileIncludes(path.join(networkGalleryRoot, 'lib/pages/eg_list_page.dart'), 'EgListPage'),
+    'networkGallery should generate EgListPage',
+  )
+  assert(
+    fileIncludes(path.join(networkGalleryRoot, 'lib/core/router/app_routes.dart'), 'egList'),
+    'networkGallery should register egList route',
+  )
+  const galleryRoutes = fs.readFileSync(
+    path.join(networkGalleryRoot, 'lib/core/router/app_routes.dart'),
+    'utf8',
+  )
+  const egListMappingCount = (galleryRoutes.match(/egList:\s*\(context\)\s*=>/g) || []).length
+  assert(egListMappingCount === 1, 'networkGallery should register egList route only once')
+  assert(
+    fileIncludes(path.join(networkGalleryRoot, 'lib/pages/home_page.dart'), 'AppRoutes.egList'),
+    'networkGallery should add homepage gallery entry',
+  )
+  assertHomeHasNoStarterNoise(
+    path.join(networkGalleryRoot, 'lib/pages/home_page.dart'),
+    'networkGallery',
+  )
+  assertHomeHasExampleModule(
+    path.join(networkGalleryRoot, 'lib/pages/home_page.dart'),
+    'networkGallery',
+  )
+  const analysisOptions = fs.readFileSync(
+    path.join(networkGalleryRoot, 'analysis_options.yaml'),
+    'utf8',
+  )
+  assert(
+    analysisOptions.includes('prefer_single_quotes: true'),
+    'generated project should apply Flu strict analysis options',
+  )
+  assert(
+    analysisOptions.includes('Flu CLI 生成的项目级 Dart/Flutter 静态检查配置'),
+    'generated analysis_options should explain Flu lint intent',
+  )
+  assert(
+    !analysisOptions.includes('Uncomment to disable'),
+    'generated analysis_options should not keep Flutter default comments',
+  )
+  const generatedReadme = fs.readFileSync(path.join(networkGalleryRoot, 'README.md'), 'utf8')
+  const generatedGuide = fs.readFileSync(
+    path.join(networkGalleryRoot, 'DEVELOPER_GUIDE.md'),
+    'utf8',
+  )
+  const generatedEnvDev = fs.readFileSync(path.join(networkGalleryRoot, '.env.dev'), 'utf8')
+  const generatedEnvStaging = fs.readFileSync(path.join(networkGalleryRoot, '.env.staging'), 'utf8')
+  const generatedEnvProdExample = fs.readFileSync(
+    path.join(networkGalleryRoot, '.env.prod.example'),
+    'utf8',
+  )
+  assert(
+    generatedReadme.includes('当前项目配置'),
+    'generated README should focus on current project configuration',
+  )
+  assert(generatedReadme.includes('首页样板'), 'generated README should explain home sample slot')
+  assert(
+    generatedGuide.includes('项目升级建议'),
+    'generated developer guide should explain upgrade path',
+  )
+  assert(
+    generatedGuide.includes('DEMO_LIST_MODE'),
+    'generated developer guide should explain demo list mode',
+  )
+  assert(
+    generatedEnvDev.includes('DEMO_LIST_MODE=finite'),
+    'generated .env.dev should include finite demo list mode',
+  )
+  assert(
+    fileIncludes(
+      path.join(networkGalleryRoot, 'lib/core/config/app_env.dart'),
+      'defaultValue: true',
+    ),
+    'generated AppEnv should default USE_MOCK_DATA to true for test/dev safety',
+  )
+  assert(
+    generatedEnvStaging.includes('DEMO_LIST_MODE=load_more_error'),
+    'generated .env.staging should include load-more error mode',
+  )
+  assert(
+    generatedEnvProdExample.includes('DEMO_LIST_MODE=standard'),
+    'generated .env.prod.example should include standard mode',
+  )
+  assert(
+    !fileIncludes(path.join(networkGalleryRoot, 'lib/main.dart'), 'kIsWeb'),
+    'generated main.dart should not force mock data by platform',
+  )
+  assert(
+    exists(path.join(networkGalleryRoot, 'lib/viewmodels/user_list_viewmodel.dart')),
+    'networkGallery starter project should generate user list viewmodel for default list slot',
+  )
+  assert(
+    fileIncludes(
+      path.join(networkGalleryRoot, 'lib/viewmodels/user_list_viewmodel.dart'),
+      'EnvConfig.demoListMode',
+    ),
+    'generated list sample should read DEMO_LIST_MODE from EnvConfig',
+  )
+  assert(
+    exists(path.join(networkGalleryRoot, 'lib/services/home_feed_service.dart')),
+    'networkGallery should generate home feed service for default list slot',
+  )
+  assert(
+    exists(path.join(networkGalleryRoot, 'lib/pages/splash_page.dart')),
+    'networkGallery starter project should generate SplashPage',
+  )
+  assert(
+    exists(path.join(networkGalleryRoot, 'lib/pages/user_list_page.dart')),
+    'networkGallery starter project should keep user list page for list slot demo',
+  )
+  assert(
+    fileIncludes(path.join(networkGalleryRoot, 'lib/services/home_feed_service.dart'), '/posts'),
+    'home feed service should use runnable /posts network sample',
+  )
+  assert(
+    fileIncludes(
+      path.join(networkGalleryRoot, 'lib/viewmodels/user_list_viewmodel.dart'),
+      'HomeFeedService',
+    ),
+    'networkGallery list sample should use HomeFeedService',
+  )
+  assert(
+    !fileIncludes(path.join(networkGalleryRoot, 'lib/pages/home_page.dart'), 'AppRoutes.userList'),
+    'networkGallery home should not keep legacy user list entry',
+  )
+  assert(
+    !fileIncludes(path.join(networkGalleryRoot, 'lib/core/router/app_routes.dart'), 'userList:'),
+    'networkGallery routes should not keep legacy user list route',
+  )
+  assertProjectImportsResolvable(networkGalleryRoot)
+
+  runCli(
+    [
+      'new',
+      'demo_harmony',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_harmony',
+      '--author',
+      'test',
+      '--no-network',
+      '--platforms',
+      'harmony',
+      '--helpers',
+      'webview,permission,imagePicker',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const harmonyRoot = path.join(tmpRoot, 'demo_harmony')
+  assert(
+    !exists(path.join(harmonyRoot, 'lib/core/base/base_service.dart')),
+    'base + no-network should not generate BaseService',
+  )
+  assert(
+    exists(path.join(harmonyRoot, 'lib/helpers/README.platform-permissions.md')),
+    'harmony helper permission README missing',
+  )
+  assert(
+    exists(path.join(harmonyRoot, 'lib/helpers/webview/README.md')),
+    'harmony webview helper README missing',
+  )
+  assert(
+    fileIncludes(path.join(harmonyRoot, 'lib/helpers/webview/README.md'), 'Harmony'),
+    'harmony helper README should mention Harmony',
+  )
+  const harmonyPubspec = path.join(harmonyRoot, 'pubspec.yaml')
+  assert(
+    fileIncludes(harmonyPubspec, 'webview_flutter:'),
+    'harmony project should keep webview_flutter for common platforms',
+  )
+  assert(
+    fileIncludes(harmonyPubspec, 'permission_handler:'),
+    'harmony project should keep permission_handler for common platforms',
+  )
+  assert(
+    fileIncludes(harmonyPubspec, 'image_picker:'),
+    'harmony project should keep image_picker for common platforms',
+  )
+  assert(
+    exists(path.join(harmonyRoot, '.flu-cli.json')),
+    'built-in harmony lite project should also write .flu-cli.json',
+  )
+  assert(
+    !exists(path.join(harmonyRoot, 'lib/services/home_feed_service.dart')),
+    'no-network project should not generate network-backed home feed service',
+  )
+  assert(
+    fileIncludes(
+      path.join(harmonyRoot, 'ohos/entry/src/main/module.json5'),
+      'ohos.permission.CAMERA',
+    ),
+    'harmony helper should inject camera permission into module.json5',
+  )
+  assert(
+    fileIncludes(
+      path.join(harmonyRoot, 'ohos/entry/src/main/module.json5'),
+      'ohos.permission.READ_IMAGEVIDEO',
+    ),
+    'harmony helper should inject photo permission into module.json5',
+  )
+  assertProjectImportsResolvable(harmonyRoot)
+
+  runCli(
+    [
+      'new',
+      'demo_permission_only',
+      '--template',
+      'lite',
+      '--state',
+      'provider',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_permission_only',
+      '--author',
+      'test',
+      '--helpers',
+      'permission',
+      '--no-network',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const permissionOnlyRoot = path.join(tmpRoot, 'demo_permission_only')
+  assert(
+    fileIncludes(
+      path.join(permissionOnlyRoot, 'android/app/src/main/AndroidManifest.xml'),
+      'android.permission.CAMERA',
+    ),
+    'permission helper should inject Android camera permission even without examples',
+  )
+  assert(
+    fileIncludes(
+      path.join(permissionOnlyRoot, 'ios/Runner/Info.plist'),
+      'NSPhotoLibraryUsageDescription',
+    ),
+    'permission helper should inject iOS photo description even without examples',
+  )
+  assert(
+    fileIncludes(path.join(permissionOnlyRoot, 'ios/Podfile'), 'PERMISSION_CAMERA=1'),
+    'permission helper should inject iOS camera Podfile macro even without examples',
+  )
+  assertHomeHasNoExampleModule(
+    path.join(permissionOnlyRoot, 'lib/pages/home_page.dart'),
+    'permission helper only',
+  )
+
+  const structureCases = [
+    {
+      template: 'modular',
+      projectName: 'demo_modular',
+      args: ['--auth'],
+      expectedFiles: [
+        'lib/features/home/pages/home_page.dart',
+        'lib/core/network/app_http.dart',
+        'lib/core/auth/auth_service.dart',
+      ],
+      expectedDescription: 'Flu CLI Modular 模板',
+    },
+    {
+      template: 'clean',
+      projectName: 'demo_clean',
+      args: ['--no-network'],
+      expectedFiles: ['lib/features/home/presentation/pages/home_page.dart'],
+      expectedDescription: 'Flu CLI Clean 模板',
+    },
+    {
+      template: 'clean',
+      projectName: 'demo_clean_network',
+      args: [],
+      expectedFiles: [
+        'lib/features/home/presentation/pages/home_page.dart',
+        'lib/features/home/presentation/viewmodels/home_viewmodel.dart',
+        'lib/features/home/presentation/pages/index.dart',
+      ],
+      expectedDescription: 'Flu CLI Clean 模板',
+      pubspecMustInclude: [
+        'dio:',
+        'connectivity_plus:',
+        'json_annotation:',
+        'build_runner:',
+        'json_serializable:',
+      ],
+      fluConfigMustInclude: ['"strategy": "json_serializable"'],
+      extraCliArgs: ['--serialization', 'json_serializable'],
+    },
+    {
+      template: 'modular',
+      projectName: 'demo_modular_gallery',
+      args: ['--examples', 'networkGallery'],
+      expectedFiles: [
+        'lib/features/home/pages/home_page.dart',
+        'lib/features/user/pages/user_list_page.dart',
+        'lib/core/network/app_http.dart',
+      ],
+      expectedDescription: 'Flu CLI Modular 模板',
+    },
+    {
+      template: 'clean',
+      projectName: 'demo_clean_network_gallery',
+      args: ['--examples', 'networkGallery'],
+      expectedFiles: [
+        'lib/features/home/presentation/pages/home_page.dart',
+        'lib/features/home/presentation/viewmodels/home_viewmodel.dart',
+        'lib/core/network/app_http.dart',
+      ],
+      expectedDescription: 'Flu CLI Clean 模板',
+    },
+  ]
+
+  for (const item of structureCases) {
+    runCli(
+      [
+        'new',
+        item.projectName,
+        '--template',
+        item.template,
+        '--state',
+        'provider',
+        '--dir',
+        tmpRoot,
+        '--package',
+        `com.example.${item.projectName}`,
+        '--author',
+        'test',
+        '--flutter-sdk',
+        'custom',
+        '--flutter-bin',
+        fakeFlutterBin,
+        ...(item.extraCliArgs || []),
+        ...item.args,
+      ],
+      repoRoot,
+      { HOME: rootHome },
+    )
+
+    const projectRoot = path.join(tmpRoot, item.projectName)
+    for (const expectedFile of item.expectedFiles) {
+      assert(
+        exists(path.join(projectRoot, expectedFile)),
+        `${item.template} project missing ${expectedFile}`,
+      )
+    }
+    assert(
+      fileIncludes(path.join(projectRoot, 'pubspec.yaml'), item.expectedDescription),
+      `${item.template} pubspec should include template-specific description`,
+    )
+    for (const needle of item.pubspecMustInclude || []) {
+      assert(
+        fileIncludes(path.join(projectRoot, 'pubspec.yaml'), needle),
+        `${item.template} pubspec should include ${needle}`,
+      )
+    }
+    for (const needle of item.fluConfigMustInclude || []) {
+      assert(
+        fileIncludes(path.join(projectRoot, '.flu-cli.json'), needle),
+        `${item.template} .flu-cli.json should include ${needle}`,
+      )
+    }
+    const homePath = homePagePathForTemplate(projectRoot, item.template)
+    assertHomeHasNoStarterNoise(homePath, item.projectName)
+    if (item.args.includes('--examples')) {
+      assertHomeHasExampleModule(homePath, item.projectName)
+    } else {
+      assertHomeHasNoExampleModule(homePath, item.projectName)
+    }
+    assertProjectImportsResolvable(projectRoot)
+
+    if (item.projectName === 'demo_modular') {
+      assert(
+        !exists(path.join(projectRoot, 'lib/features/user/services/home_feed_service.dart')),
+        'modular network project without networkGallery should not generate home feed service',
+      )
+      assert(
+        !exists(path.join(projectRoot, 'lib/features/user/viewmodels/user_list_viewmodel.dart')),
+        'modular network project without networkGallery should not keep legacy user list viewmodel',
+      )
+    }
+
+    if (item.projectName === 'demo_clean') {
+      assert(
+        !exists(
+          path.join(projectRoot, 'lib/features/user/data/datasources/home_feed_service.dart'),
+        ),
+        'clean no-network project should not generate home feed service',
+      )
+    }
+
+    if (item.projectName === 'demo_clean_network') {
+      assert(
+        !exists(
+          path.join(projectRoot, 'lib/features/user/data/datasources/home_feed_service.dart'),
+        ),
+        'clean network project without networkGallery should not generate home feed service',
+      )
+      assert(
+        !exists(
+          path.join(
+            projectRoot,
+            'lib/features/user/presentation/viewmodels/user_list_viewmodel.dart',
+          ),
+        ),
+        'clean network project without networkGallery should not keep legacy user list viewmodel',
+      )
+    }
+
+    if (item.projectName === 'demo_modular_gallery') {
+      assert(
+        exists(path.join(projectRoot, 'lib/features/user/services/home_feed_service.dart')),
+        'modular networkGallery should generate home feed service',
+      )
+      assert(
+        fileIncludes(
+          path.join(projectRoot, 'lib/features/user/viewmodels/user_list_viewmodel.dart'),
+          'HomeFeedService',
+        ),
+        'modular networkGallery list sample should use HomeFeedService',
+      )
+    }
+
+    if (item.projectName === 'demo_clean_network_gallery') {
+      assert(
+        exists(path.join(projectRoot, 'lib/features/user/data/datasources/home_feed_service.dart')),
+        'clean networkGallery should generate home feed service',
+      )
+      assert(
+        fileIncludes(
+          path.join(
+            projectRoot,
+            'lib/features/user/presentation/viewmodels/user_list_viewmodel.dart',
+          ),
+          'HomeFeedService',
+        ),
+        'clean networkGallery list sample should use HomeFeedService',
+      )
+    }
+
+    if (item.template === 'modular') {
+      assertAddPageWorks(
+        projectRoot,
+        'smoke_accept_page',
+        'lib/features/smoke_accept_page/pages/smoke_accept_page_page.dart',
+        'lib/features/smoke_accept_page/viewmodels/smoke_accept_page_viewmodel.dart',
+        ['--feature', 'smoke_accept_page'],
+      )
+    }
+    if (item.template === 'clean' && item.projectName === 'demo_clean') {
+      assertAddPageWorks(
+        projectRoot,
+        'smoke_accept_page',
+        'lib/features/smoke_accept_page/presentation/pages/smoke_accept_page_page.dart',
+        'lib/features/smoke_accept_page/presentation/viewmodels/smoke_accept_page_viewmodel.dart',
+        ['--feature', 'smoke_accept_page'],
+      )
+    }
+  }
+
+  runCli(
+    [
+      'new',
+      'demo_native',
+      '--template',
+      'native',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_native',
+      '--author',
+      'test',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const nativeRoot = path.join(tmpRoot, 'demo_native')
+  assert(
+    exists(path.join(nativeRoot, 'lib', 'main.dart')),
+    'native project should include lib/main.dart',
+  )
+  assert(exists(path.join(nativeRoot, 'android')), 'native project should include android platform')
+  assert(exists(path.join(nativeRoot, 'ios')), 'native project should include ios platform')
+  assert(
+    !exists(path.join(nativeRoot, 'lib', 'core')),
+    'native project should not inject Flu core files',
+  )
+  assert(
+    !exists(path.join(nativeRoot, '.flu-cli.json')),
+    'native project should not write .flu-cli.json by default',
+  )
+
+  runCli(
+    [
+      'new',
+      'demo_native_webview',
+      '--template',
+      'native',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_native_webview',
+      '--author',
+      'test',
+      '--helpers',
+      'webview',
+      '--no-network',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const nativeWebviewRoot = path.join(tmpRoot, 'demo_native_webview')
+  assert(
+    exists(path.join(nativeWebviewRoot, 'lib', 'helpers', 'webview')),
+    'native + webview helper should inject lib/helpers/webview via postSkeletonEnrich',
+  )
+  assert(
+    !exists(path.join(nativeWebviewRoot, 'lib', 'core')),
+    'native + helper should still not inject Flu core',
+  )
+  assert(
+    fileIncludes(path.join(nativeWebviewRoot, 'pubspec.yaml'), 'webview_flutter:'),
+    'native + webview helper should add webview_flutter to pubspec.yaml',
+  )
+  assert(
+    fileIncludes(path.join(nativeWebviewRoot, 'test', 'widget_test.dart'), '/main.dart'),
+    'native + webview widget_test should import main.dart',
+  )
+
+  runCli(
+    [
+      'new',
+      'demo_native_network',
+      '--template',
+      'native',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_native_network',
+      '--author',
+      'test',
+      '--network',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const nativeNetworkRoot = path.join(tmpRoot, 'demo_native_network')
+  assert(
+    exists(path.join(nativeNetworkRoot, 'lib', 'core', 'network', 'app_http.dart')),
+    'native + network should inject lib/core/network via postSkeletonEnrich',
+  )
+  assert(
+    fileIncludes(path.join(nativeNetworkRoot, 'pubspec.yaml'), 'dio:'),
+    'native + network should add dio to pubspec.yaml',
+  )
+  assert(
+    fileIncludes(
+      path.join(nativeNetworkRoot, 'lib', 'core', 'router', 'app_routes.dart'),
+      'routes =>',
+    ),
+    'native network project should patch app_routes placeholder',
+  )
+  assert(
+    fileIncludes(path.join(nativeNetworkRoot, 'test', 'widget_test.dart'), '/main.dart'),
+    'native project widget_test should import main.dart instead of app.dart',
+  )
+  assert(
+    !fileIncludes(path.join(nativeNetworkRoot, 'test', 'widget_test.dart'), '/app.dart'),
+    'native project widget_test should not import missing app.dart',
+  )
+
+  const blueprintRoot = path.join(tmpRoot, 'demo_modular')
+  fs.writeFileSync(
+    path.join(blueprintRoot, 'flu-blueprint.yaml'),
+    [
+      "version: '1'",
+      'features:',
+      '  - name: order',
+      '    pages:',
+      '      - name: order_list',
+      '        type: list-page',
+      '        model: order',
+      '    services:',
+      '      - order',
+      '    models:',
+      '      - order',
+      '',
+    ].join('\n'),
+  )
+  const blueprintResult = runCliJson(['blueprint', 'gen', '--dir', blueprintRoot], repoRoot, {
+    HOME: rootHome,
+  })
+  assert(
+    blueprintResult.data.generated.includes('ListPage:order_list'),
+    'blueprint should generate list page',
+  )
+  assert(
+    blueprintResult.data.generated.includes('Service:order'),
+    'blueprint should generate service',
+  )
+  assert(blueprintResult.data.generated.includes('Model:order'), 'blueprint should generate model')
+  const blueprintPage = fs.readFileSync(
+    path.join(blueprintRoot, 'lib/features/order/pages/order_list_page.dart'),
+    'utf8',
+  )
+  assert(
+    !blueprintPage.includes('item.name'),
+    'blueprint list page should not assume generated models contain a name field',
+  )
+  assert(
+    !blueprintPage.includes('package:provider/provider.dart'),
+    'blueprint generated page should not import unused provider package',
+  )
+  assertProjectImportsResolvable(blueprintRoot)
+
+  const customTemplateRoot = path.join(tmpRoot, 'custom_template')
+  fs.mkdirSync(path.join(customTemplateRoot, 'lib'), { recursive: true })
+  fs.writeFileSync(
+    path.join(customTemplateRoot, 'pubspec.yaml'),
+    [
+      'name: custom_template',
+      'description: local custom template',
+      'publish_to: none',
+      'environment:',
+      '  sdk: "^3.0.0"',
+      'dependencies:',
+      '  flutter:',
+      '    sdk: flutter',
+      'dev_dependencies:',
+      '  flutter_test:',
+      '    sdk: flutter',
+      'flutter:',
+      '  uses-material-design: true',
+      '',
+    ].join('\n'),
+  )
+  fs.writeFileSync(path.join(customTemplateRoot, 'lib', 'main.dart'), 'void main() {}\n')
+
+  const configDir = path.join(rootHome, '.flu-cli')
+  const configPath = path.join(configDir, 'config.json')
+  fs.mkdirSync(configDir, { recursive: true })
+  fs.writeFileSync(
+    configPath,
+    JSON.stringify(
+      {
+        templates: [
+          {
+            id: 'local-smoke-template',
+            name: 'Local Smoke Template',
+            type: 'local',
+            path: customTemplateRoot,
+          },
+        ],
+      },
+      null,
+      2,
+    ),
+  )
+
+  runCli(
+    [
+      'new',
+      'demo_custom_local',
+      '--template',
+      'local-smoke-template',
+      '--dir',
+      tmpRoot,
+      '--package',
+      'com.example.demo_custom_local',
+      '--author',
+      'test',
+      '--flutter-sdk',
+      'custom',
+      '--flutter-bin',
+      fakeFlutterBin,
+    ],
+    repoRoot,
+    { HOME: rootHome },
+  )
+
+  const customRoot = path.join(tmpRoot, 'demo_custom_local')
+  assert(
+    exists(path.join(customRoot, 'pubspec.yaml')),
+    'custom local template project should keep pubspec.yaml',
+  )
+  assert(
+    !exists(path.join(customRoot, '.flu-cli.json')),
+    'custom local template should not auto-write .flu-cli.json',
+  )
+  assert(
+    exists(path.join(customRoot, 'lib', 'core')),
+    'custom local template should still receive default Flu core when not marked native',
+  )
+
+  console.log('cli vNext generate smoke: ok')
+} finally {
+  fs.rmSync(tmpRoot, { recursive: true, force: true })
+}