@coze-arch/cli 0.0.12-alpha.e3bedc → 0.0.13-alpha.281fed

package/lib/__templates__/expo/client/components/PrettyScrollbar.tsx

@@ -0,0 +1,43 @@
+import { useEffect, ReactNode } from 'react';
+import { Platform } from 'react-native';
+
+const STYLE_ID = 'coze-pretty-scrollbar';
+
+function WebOnlyPrettyScrollbar({ children }: { children: ReactNode }) {
+  useEffect(() => {
+    if (Platform.OS === 'web') {
+      let style = document.getElementById(STYLE_ID);
+      if (!style) {
+        style = document.createElement('style');
+        style.id = STYLE_ID;
+        style.textContent = `
+        ::-webkit-scrollbar {
+          width: 4px;
+          height: 4px;
+        }
+
+        ::-webkit-scrollbar-track {
+          background: transparent;
+        }
+
+        ::-webkit-scrollbar-thumb {
+          background: rgba(0, 0, 0, 0.2);
+          border-radius: 2px;
+        }
+        `;
+        document.head.appendChild(style);
+      }
+
+      return () => {
+        const existingStyle = document.getElementById(STYLE_ID);
+        if (existingStyle) {
+          existingStyle.remove();
+        }
+      }
+    }
+  }, []);
+
+  return <>{children}</>
+}
+
+export { WebOnlyPrettyScrollbar }

package/lib/__templates__/expo/client/components/Provider.tsx

@@ -2,17 +2,20 @@ import { AuthProvider } from '@/contexts/AuthContext';
 import { type ReactNode } from 'react';
 import { GestureHandlerRootView } from 'react-native-gesture-handler';
 import { WebOnlyColorSchemeUpdater } from './ColorSchemeUpdater';
+import { WebOnlyPrettyScrollbar } from './PrettyScrollbar'
 import { HeroUINativeProvider } from '@/heroui';
 
 function Provider({ children }: { children: ReactNode }) {
   return <WebOnlyColorSchemeUpdater>
-    <AuthProvider>
-      <GestureHandlerRootView style={{ flex: 1 }}>
-        <HeroUINativeProvider>
-          {children}
-        </HeroUINativeProvider>
-      </GestureHandlerRootView>
-    </AuthProvider>
+    <WebOnlyPrettyScrollbar>
+      <AuthProvider>
+        <GestureHandlerRootView style={{ flex: 1 }}>
+          <HeroUINativeProvider>
+            {children}
+          </HeroUINativeProvider>
+        </GestureHandlerRootView>
+      </AuthProvider>
+    </WebOnlyPrettyScrollbar>
   </WebOnlyColorSchemeUpdater>
 }
 

package/lib/__templates__/expo/client/eslint.config.mjs

@@ -10,6 +10,7 @@ import reanimated from '../eslint-plugins/reanimated/index.js';
 import reactnative from '../eslint-plugins/react-native/index.js';
 import forbidEmoji from '../eslint-plugins/forbid-emoji/index.js';
 import restrictLinearGradient from '../eslint-plugins/restrict-linear-gradient/index.js';
+import expo from '../eslint-plugins/expo/index.js';
 
 export default [
   {
@@ -66,6 +67,7 @@ export default [
       reactnative,
       forbidEmoji,
       restrictLinearGradient,
+      expo,
     },
     rules: {
       // 关闭代码风格规则
@@ -90,6 +92,7 @@ export default [
       'reanimated/ban-mix-use': 'error',
       'forbidEmoji/no-emoji': 'error',
       'restrictLinearGradient/no-linear-gradient-backgroundcolor': 'error',
+      'expo/require-globalcss-and-provider': 'error',
       // 禁止使用 via.placeholder.com 服务
       'no-restricted-syntax': [
         'error',

package/lib/__templates__/expo/eslint-plugins/expo/index.js

@@ -0,0 +1,9 @@
+const requireGlobalCssAndProvider = require('./rule')
+
+const plugin = {
+  rules: {
+    'require-globalcss-and-provider': requireGlobalCssAndProvider,
+  },
+}
+
+module.exports = plugin

package/lib/__templates__/expo/eslint-plugins/expo/rule.js

@@ -0,0 +1,105 @@
+function normalizeFilename(filename) {
+  // ESLint may provide Windows paths; normalize to forward slashes for suffix checks.
+  return typeof filename === 'string' ? filename.replace(/\\/g, '/') : ''
+}
+
+function isTargetLayoutFile(context) {
+  return normalizeFilename(context.getFilename()).endsWith('/app/_layout.tsx')
+}
+
+function isSideEffectImportOf(node, sourceValue) {
+  return (
+    node &&
+    node.type === 'ImportDeclaration' &&
+    node.source &&
+    node.source.type === 'Literal' &&
+    node.source.value === sourceValue &&
+    Array.isArray(node.specifiers) &&
+    node.specifiers.length === 0
+  )
+}
+
+function getProviderImportLocalName(node) {
+  if (
+    !node ||
+    node.type !== 'ImportDeclaration' ||
+    !node.source ||
+    node.source.type !== 'Literal' ||
+    node.source.value !== '@/components/Provider'
+  ) {
+    return null
+  }
+
+  const specifiers = Array.isArray(node.specifiers) ? node.specifiers : []
+  if (specifiers.length !== 1) return null
+  const [specifier] = specifiers
+  if (specifier.type !== 'ImportSpecifier') return null
+  if (!specifier.imported || specifier.imported.type !== 'Identifier') return null
+  if (!specifier.local || specifier.local.type !== 'Identifier') return null
+
+  // Allow `import { Provider } ...` and `import { Provider as XXX } ...`
+  if (specifier.imported.name !== 'Provider') return null
+  return specifier.local.name
+}
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require global.css import and Provider usage in app/_layout.tsx',
+      recommended: 'error',
+    },
+    schema: [],
+    messages: {
+      missingGlobalCssImport: `app/_layout.tsx 必须引入 global.css 文件（参考写法：import '../global.css'）`,
+      requireProviderImportAndUsage:
+        "app/_layout.tsx 必须从 @/components/Provider 导入 Provider（参考写法：import { Provider } from '@/components/Provider'），并使用导入的 Provider 包裹其余组件",
+    },
+  },
+
+  create(context) {
+    if (!isTargetLayoutFile(context)) {
+      return {}
+    }
+
+    let hasGlobalCssImport = false
+    let providerImportLocalName = null
+    let hasProviderJsxUsage = false
+
+    return {
+      Program(node) {
+        const body = Array.isArray(node.body) ? node.body : []
+        for (const stmt of body) {
+          if (isSideEffectImportOf(stmt, '../global.css')) {
+            hasGlobalCssImport = true
+          }
+          const localName = getProviderImportLocalName(stmt)
+          if (localName) {
+            providerImportLocalName = localName
+          }
+        }
+      },
+
+      JSXOpeningElement(node) {
+        if (!node || !node.name) return
+        if (
+          providerImportLocalName &&
+          node.name.type === 'JSXIdentifier' &&
+          node.name.name === providerImportLocalName
+        ) {
+          hasProviderJsxUsage = true
+        }
+      },
+
+      'Program:exit'(node) {
+        if (!hasGlobalCssImport) {
+          context.report({ node, messageId: 'missingGlobalCssImport' })
+        }
+
+        if (!providerImportLocalName || !hasProviderJsxUsage) {
+          context.report({ node, messageId: 'requireProviderImportAndUsage' })
+        }
+      },
+    }
+  },
+}

package/lib/__templates__/expo/eslint-plugins/expo/tech.md

@@ -0,0 +1,108 @@
+# expo 技术设计（layout 规则）
+
+## 目标
+- 强约束 Expo Router 的 `app/_layout.tsx` 模板结构，避免初始化项目后被误删导致运行时样式/上下文缺失
+- 校验 `app/_layout.tsx` 必须：
+  - 包含 `import '../global.css'`
+  - 使用从 `@/components/Provider` 导入的 Provider 组件作为 JSX 组件（允许 `import { Provider } ...` 或 `import { Provider as XXX } ...`）
+- 实现轻量、易维护，不引入新依赖
+
+## 规则命名与对外形态
+- 插件目录：expo/eslint-plugins/expo
+- 规则名：expo/require-globalcss-and-provider
+- 规则类型：problem
+- 默认等级：error
+
+## 规则行为定义
+### 报错
+仅对目标文件 `app/_layout.tsx` 生效，满足以下任一情况报错：
+- 缺少 side-effect import：`import '../global.css'`
+- 缺少或不符合要求的 Provider 导入语句：
+  - 必须从 `@/components/Provider` 导入
+  - 必须为命名导入，导入名必须为 `Provider`
+  - 允许形式：
+    - `import { Provider } from '@/components/Provider';`
+    - `import { Provider as XXX } from '@/components/Provider';`
+- 未在 JSX 中使用导入的 Provider 组件（例如：只导入但从未作为 JSX 组件出现）
+
+### 不报错
+- 非 `app/_layout.tsx` 文件不做检查
+- 目标文件同时满足：
+  - 存在 `import '../global.css'`
+  - 存在 Provider 命名导入（允许 as 别名）
+  - JSX 中至少出现一次 `<Provider ...>` / `<Provider>` 或 `<XXX ...>` / `<XXX>`（XXX 为别名）
+
+## 检测策略
+### 目标文件判定
+- 通过 `context.getFilename()` 获取当前文件路径
+- 仅当路径以 `/app/_layout.tsx` 结尾时启用规则（同时兼容 Windows 路径分隔符做归一化）
+
+### AST 访问节点
+- `Program`：收集顶层 `ImportDeclaration`，判定是否存在目标 import
+- `JSXOpeningElement` / `JSXElement`：判定是否使用 `<Provider>`
+
+### Import 判定细则
+- global.css：
+  - `ImportDeclaration.source.value === '../global.css'`
+  - `ImportDeclaration.specifiers.length === 0`（side-effect import）
+- Provider import（严格形式）：
+  - `ImportDeclaration.source.value === '@/components/Provider'`
+  - `ImportDeclaration.specifiers` 仅包含一个 `ImportSpecifier`
+  - `specifier.imported.name === 'Provider'`，`specifier.local.name` 允许为 `Provider` 或任意别名
+
+## 报错信息
+- messageId: missingGlobalCssImport
+  - 文案：`app/_layout.tsx 必须包含 "import '../global.css';"`
+- messageId: requireProviderImportAndUsage
+  - 文案：`app/_layout.tsx 中必须从 @/components/Provider 导入 Provider（参考写法：import { Provider } from '@/components/Provider'），并使用导入的 Provider 包裹其余组件`
+
+## 典型示例
+### 触发
+- 缺少 global.css：
+  - 未包含 `import '../global.css';`
+- Provider import 形式不对：
+  - `import Provider from '@/components/Provider'`
+  - `import { Provider } from '@/components/provider'`
+- Provider 未使用：
+  - 有 `import { Provider } ...`，但 JSX 中没有 `<Provider>`
+
+### 不触发
+```tsx
+import { Provider } from '@/components/Provider';
+import '../global.css';
+
+export default function RootLayout() {
+  return (
+    <Provider>
+      {/* ... */}
+    </Provider>
+  );
+}
+```
+
+```tsx
+import { Provider as AppProvider } from '@/components/Provider';
+import '../global.css';
+
+export default function RootLayout() {
+  return (
+    <AppProvider>
+      {/* ... */}
+    </AppProvider>
+  );
+}
+```
+
+## 边界与决策
+- 仅做结构约束，不尝试自动修复（fixer）以避免在 TSX 顶部插入 import 引起格式与注释位置变化
+- 仅检查 JSX 中的 `<Provider>` 使用，不做“必须最外层包裹”的结构分析，降低复杂度与误报
+
+## 性能考虑
+- 仅在命中目标文件时启用
+- 仅扫描顶层 import 与 JSX 标签名，复杂度 O(n)
+
+## 测试计划
+- 缺少 global.css import：报 `missingGlobalCssImport`
+- 未从 `@/components/Provider` 正确导入 Provider：报 `requireProviderImportAndUsage`
+- Provider 未在 JSX 使用：报 `requireProviderImportAndUsage`
+- 满足全部要求：不报错

package/lib/__templates__/nextjs/AGENTS.md

@@ -42,6 +42,11 @@
 
 ## 开发规范
 
+### 编码规范
+
+- 默认按 TypeScript `strict` 心智写代码；优先复用当前作用域已声明的变量、函数、类型和导入，禁止引用未声明标识符或拼错变量名。
+- 禁止隐式 `any` 和 `as any`；函数参数、返回值、解构项、事件对象、`catch` 错误在使用前应有明确类型或先完成类型收窄，并清理未使用的变量和导入。
+
 ### Hydration 问题防范
 
 1. 严禁在 JSX 渲染逻辑中直接使用 typeof window、Date.now()、Math.random() 等动态数据。**必须使用 'use client' 并配合 useEffect + useState 确保动态内容仅在客户端挂载后渲染**；同时严禁非法 HTML 嵌套（如 <p> 嵌套 <div>）。

package/lib/__templates__/nextjs/eslint.config.mjs

@@ -10,6 +10,15 @@ const syntaxRules = [
   },
 ];
 
+const nextConfigRestrictedSyntaxRules = [
+  {
+    selector:
+      'Property[key.name=/^(root|outputFileTracingRoot)$/] > Literal[value=/^\\//]',
+    message:
+      '禁止在 next.config 中写死绝对路径，请改用 path.resolve(__dirname, ...)、import.meta.dirname 或 process.cwd() 动态拼接。',
+  },
+];
+
 const eslintConfig = defineConfig([
   ...nextVitals,
   ...nextTs,
@@ -19,6 +28,12 @@ const eslintConfig = defineConfig([
       'no-restricted-syntax': ['error', ...syntaxRules],
     },
   },
+  {
+    files: ['next.config.ts'],
+    rules: {
+      'no-restricted-syntax': ['error', ...nextConfigRestrictedSyntaxRules],
+    },
+  },
   // Override default ignores of eslint-config-next.
   globalIgnores([
     // Default ignores of eslint-config-next:

package/lib/__templates__/taro/src/presets/dev-debug.ts

@@ -3,11 +3,11 @@ import Taro from '@tarojs/taro';
 /**
  * 小程序调试工具
  * 在开发版/体验版自动开启调试模式
- * 支持微信小程序和抖音小程序
+ * 支持微信小程序
  */
 export function devDebug() {
   const env = Taro.getEnv();
-  if (env === Taro.ENV_TYPE.WEAPP || env === Taro.ENV_TYPE.TT) {
+  if (env === Taro.ENV_TYPE.WEAPP) {
     try {
       const accountInfo = Taro.getAccountInfoSync();
       const envVersion = accountInfo.miniProgram.envVersion;

package/lib/__templates__/vite/AGENTS.md

@@ -39,3 +39,8 @@
 ## 开发规范
 
 - 使用 Tailwind CSS 进行样式开发
+
+### 编码规范
+
+- 默认按 TypeScript `strict` 心智写代码；优先复用当前作用域已声明的变量、函数、类型和导入，禁止引用未声明标识符或拼错变量名。
+- 禁止隐式 `any` 和 `as any`；函数参数、返回值、解构项、事件对象、Express `req`/`res`、`catch` 错误在使用前应有明确类型或先完成类型收窄，并清理未使用的变量和导入。

package/lib/cli.js

@@ -2107,7 +2107,7 @@ const EventBuilder = {
 };
 
 var name = "@coze-arch/cli";
-var version = "0.0.12-alpha.e3bedc";
+var version = "0.0.13-alpha.281fed";
 var description = "coze coding devtools cli";
 var license = "MIT";
 var author = "fanwenjie.fe@bytedance.com";
@@ -6037,9 +6037,115 @@ const detectTemplateKey = async (
   }
 };
 
-function _optionalChain$3(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+const PATCH_FG_ENDPOINT =
+  'https://bytegate.zijieapi.com/api/v1/workspace/feature_gates/values?workspace=CozeCoding';
+const PATCH_FG_TIMEOUT_MS = 2000;
+
+const PATCH_FG_REQUEST_BODY = {
+  byteGateClientUrl: 'https://bytegate.zijieapi.com',
+  env: 'ONLINE',
+  region: 'CN',
+  workspace_name: 'CozeCoding',
+  project_path: '/',
+};
+
+
+
+
+
+const PATCH_CLI_FLAG = 'coding.arch.patch_cli';
+const PATCH_FLAGS_ENV_KEY = 'COZE_PATCH_FLAGS_JSON';
+
+const isFlagEnabled = (
+  flags,
+  flag,
+) => flags[flag] === true;
+
+const loadPatchFlags = async () => {
+  const envFlags = process.env[PATCH_FLAGS_ENV_KEY];
+  if (envFlags) {
+    const parsed = safeJsonParse(envFlags, null);
+    if (!parsed) {
+      throw new Error(`Invalid JSON in ${PATCH_FLAGS_ENV_KEY}`);
+    }
+    return Object.entries(parsed).reduce(
+      (acc, [key, value]) => {
+        if (typeof value === 'boolean') {
+          acc[key] = value;
+        }
+        return acc;
+      },
+      {},
+    );
+  }
+
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => {
+    controller.abort();
+  }, PATCH_FG_TIMEOUT_MS);
+
+  let response;
+  try {
+    response = await fetch(PATCH_FG_ENDPOINT, {
+      method: 'POST',
+      headers: {
+        'content-type': 'application/json',
+      },
+      body: JSON.stringify(PATCH_FG_REQUEST_BODY),
+      signal: controller.signal,
+    });
+  } catch (error) {
+    if (controller.signal.aborted) {
+      throw new Error(
+        `Failed to load patch flags: request timed out after ${PATCH_FG_TIMEOUT_MS}ms`,
+      );
+    }
+    throw error;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+
+  if (!response.ok) {
+    throw new Error(`Failed to load patch flags: HTTP ${response.status}`);
+  }
+
+  const result = (await response.json()) 
+
+;
 
+  const values =
+    'data' in result && result.data && typeof result.data === 'object'
+      ? result.data
+      : result;
+
+  if (!values || typeof values !== 'object') {
+    throw new Error('Failed to load patch flags: invalid response shape');
+  }
+
+  return Object.entries(values).reduce(
+    (acc, [key, value]) => {
+      if (typeof value === 'boolean') {
+        acc[key] = value;
+      }
+      return acc;
+    },
+    {},
+  );
+};
+
+const byFlag = (flag) => {
+  const predicate = ((context) =>
+    !context.isFlagEnabled(flag)) ;
+  Object.defineProperty(predicate, 'flag', {
+    value: flag,
+    enumerable: true,
+    configurable: false,
+    writable: false,
+  });
+  return predicate;
+};
 
+function _optionalChain$3(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 const PATCH_ID$2 = 'taro/update-pack-script-for-tt-build@0.0.13';
 const PACKAGE_JSON_FILE = 'package.json';
 const PACK_SCRIPT_FILE = '.cozeproj/scripts/pack.sh';
@@ -6139,6 +6245,7 @@ const hasLegacyPackScript = async (projectFolder) => {
 const patchTaroPackScript = {
   id: PATCH_ID$2,
   template: 'taro',
+  disabled: byFlag('coding.arch.patch_taro_update_pack_script_for_tt_build'),
   operations: [
     {
       kind: 'file-patch',
@@ -6205,6 +6312,7 @@ const readTemplateAgentsContent = async () =>
 const patchTaroAgentsMd = {
   id: PATCH_ID$1,
   template: 'taro',
+  disabled: byFlag('coding.arch.patch_taro_add_agents_md'),
   operations: [
     {
       kind: 'create-file',
@@ -6316,6 +6424,13 @@ const createReplaceNpxWithPnpmPatch = (
 ) => ({
   id: `${template}/replace-npx-with-pnpm@0.0.13`,
   template,
+  disabled: byFlag(
+    template === 'nextjs'
+      ? 'coding.arch.patch_nextjs_replace_npx_with_pnpm'
+      : template === 'vite'
+        ? 'coding.arch.patch_vite_replace_npx_with_pnpm'
+        : 'coding.arch.patch_nuxt_vue_replace_npx_with_pnpm',
+  ),
   operations: [
     {
       kind: 'file-patch',
@@ -6398,6 +6513,7 @@ const PATCH_ID = 'nextjs/next-output-tracing-root@0.0.13';
 const patchNextOutputTracingRoot = {
   id: PATCH_ID,
   template: 'nextjs',
+  disabled: byFlag('coding.arch.patch_nextjs_next_output_tracing_root'),
   operations: [
     {
       kind: 'file-patch',
@@ -6465,6 +6581,67 @@ const getTemplatePatches = (
 function _nullishCoalesce$2(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$2(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 const DEFAULT_LEGACY_VERSION = 'legacy';
 
+const loadFlagsWithFallback = async () => {
+  try {
+    return await loadPatchFlags();
+  } catch (error) {
+    logger.warn(
+      `Patch skipped: failed to load feature gates (${
+        error instanceof Error ? error.message : String(error)
+      })`,
+    );
+    return {};
+  }
+};
+
+const isPatchDisabled = (
+  patch,
+  context,
+) =>
+  typeof patch.disabled === 'function'
+    ? patch.disabled(context)
+    : patch.disabled === true;
+
+const getPatchFlag = (patch) =>
+  typeof patch.disabled === 'function' &&
+  'flag' in patch.disabled &&
+  typeof (patch.disabled ).flag === 'string'
+    ? (patch.disabled ).flag
+    : null;
+
+const showFlags = (
+  template,
+  flags,
+  context,
+) => {
+  logger.info('Feature gates:');
+  logger.info(
+    `  ${PATCH_CLI_FLAG} = ${isFlagEnabled(flags, PATCH_CLI_FLAG) ? 'true' : 'false'}`,
+  );
+
+  const templatePatches = getTemplatePatches(template);
+  if (templatePatches.length === 0) {
+    logger.info(`No registered patches for template: ${template}`);
+    return;
+  }
+
+  logger.info('Patch gates:');
+  templatePatches.forEach(patch => {
+    const flag = getPatchFlag(patch);
+    if (!flag) {
+      logger.info(`  - ${patch.id}`);
+      logger.info('    gate: (none)');
+      return;
+    }
+
+    const enabled = context.isFlagEnabled(flag);
+    logger.info(`  - ${patch.id}`);
+    logger.info(`    flag: ${flag}`);
+    logger.info(`    value: ${enabled ? 'true' : 'false'}`);
+    logger.info(`    status: ${enabled ? 'enabled' : 'disabled by flag'}`);
+  });
+};
+
 const loadExistingTomlConfig = async (
   projectFolder,
 ) => {
@@ -6540,6 +6717,7 @@ const executePatch = async (
 
   const appliedPatches = [...(_optionalChain$2([config, 'access', _5 => _5.project, 'optionalAccess', _6 => _6.appliedPatches]) || [])];
   const projectVersion = _optionalChain$2([config, 'access', _7 => _7.project, 'optionalAccess', _8 => _8.version]);
+  const flags = await loadFlagsWithFallback();
 
   const context = {
     cwd,
@@ -6548,11 +6726,26 @@ const executePatch = async (
     projectVersion,
     appliedPatches,
     cozeConfig: config,
+    flags,
+    isFlagEnabled: flag => isFlagEnabled(flags, flag),
   };
 
-  const candidatePatches = getTemplatePatches(template).filter(
-    patch => patch.disabled !== true && !appliedPatches.includes(patch.id),
-  );
+  if (options.showFlags) {
+    showFlags(template, flags, context);
+    return;
+  }
+
+  if (!context.isFlagEnabled(PATCH_CLI_FLAG)) {
+    logger.info(`Patch skipped: feature gate ${PATCH_CLI_FLAG} is disabled`);
+    return;
+  }
+
+  const candidatePatches = getTemplatePatches(template).filter(patch => {
+    if (isPatchDisabled(patch, context)) {
+      return false;
+    }
+    return !appliedPatches.includes(patch.id);
+  });
 
   const matchedPatches = [];
   for (const patch of candidatePatches) {
@@ -6618,12 +6811,19 @@ const registerCommand$3 = program => {
       'Target directory to patch (defaults to current directory)',
     )
     .option('--dry-run', 'Show matched patches without modifying files')
-    .action(async (directory, command) => {
-      await executePatch({
+    .option('--show-flags', 'Show feature gate status for this template')
+    .action(
+      async (
         directory,
-        dryRun: _optionalChain$2([command, 'optionalAccess', _9 => _9.dryRun]),
-      });
-    });
+        command,
+      ) => {
+        await executePatch({
+          directory,
+          dryRun: _optionalChain$2([command, 'optionalAccess', _9 => _9.dryRun]),
+          showFlags: _optionalChain$2([command, 'optionalAccess', _10 => _10.showFlags]),
+        });
+      },
+    );
 };
 
 function _nullishCoalesce$1(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$1(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.12-alpha.e3bedc",
+  "version": "0.0.13-alpha.281fed",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",