feat: 分离 config 系统

Author: claude-code-best

How-to-refact-all-claude-code.md

@@ -0,0 +1,15 @@
+# 架构重构方案
+
+1. 编写调研文档, 输出现有架构
+   1. 注意模块解耦, 明确系统边界
+   2. 合理抽象整合新模块, 如果有外部依赖, 我们可以提供抽象接口, 然后实现它
+2. 得到一个大而全的架构调整方案
+   1. 人工审阅
+3. 启动 CC 开始将这个大方案切割为 n 个小方向
+   1. CC 需要并发去编写 /spec/feature-xxx/design.md 文档
+   2. 并发完成之后, 并发让他们根据 design.md 编写 plan.md 文档. plan.md 文档是代码详细设计, 用于执行代码编写
+   3. 由于太多的 feature, 我们需要一个 v6/todo.md 文档来编排任务
+   4. 开始进行按照计划指导  CC 们进行代码编写
+4. 人工验证
+   1. 注意编写完成之后, 需要测试及替换原有代码实现
+   2. 每一轮执行完成之后, 都会重启 cc 保证自己运行自己, 大部分能力是稳定的

package.json

@@ -65,6 +65,7 @@
     "@anthropic-ai/mcpb": "^2.1.2",
     "@anthropic-ai/sandbox-runtime": "^0.0.44",
     "@anthropic/agent": "workspace:*",
+    "@anthropic/config": "workspace:*",
     "@anthropic-ai/sdk": "^0.80.0",
     "@anthropic-ai/vertex-sdk": "^0.14.4",
     "@aws-sdk/client-bedrock": "^3.1020.0",

packages/config/feature-flags.ts

@@ -0,0 +1,103 @@
+/**
+ * FeatureFlagProvider — Unified feature flag interface
+ *
+ * Provides higher-level feature flag access beyond the basic `feature()`
+ * builtin. For boolean compile-time feature flags, continue using
+ * `import { feature } from 'bun:bundle'` directly — `feature()` requires
+ * string literal arguments and cannot be wrapped dynamically.
+ *
+ * This module provides:
+ * - Typed feature value access (non-boolean, GrowthBook-backed)
+ * - Refresh lifecycle (subscribe, trigger)
+ * - Env override inspection
+ */
+
+import {
+  getFeatureValue_CACHED_MAY_BE_STALE,
+  onGrowthBookRefresh,
+  refreshGrowthBookFeatures,
+  hasGrowthBookEnvOverride,
+  getAllGrowthBookFeatures,
+  getGrowthBookConfigOverrides,
+  setGrowthBookConfigOverride,
+  clearGrowthBookConfigOverrides,
+} from '../../src/services/analytics/growthbook.js'
+
+/** Unsubscribe function returned by onRefresh() */
+type Unsubscribe = () => void
+
+/**
+ * FeatureFlagProvider — access GrowthBook feature values and lifecycle.
+ *
+ * For boolean feature flags, use `feature('FLAG_NAME')` from `bun:bundle`.
+ * For typed values (numbers, strings, objects) and refresh management, use this.
+ *
+ * Usage:
+ *   import { FeatureFlagProvider } from '@anthropic/config/feature-flags'
+ *
+ *   const val = FeatureFlagProvider.getValue<number>('MY_CONFIG')
+ *   const unsub = FeatureFlagProvider.onRefresh(() => { ... })
+ */
+export const FeatureFlagProvider = {
+  /**
+   * Get a typed feature value from GrowthBook.
+   * Returns `undefined` if the feature is not set or not yet loaded.
+   *
+   * WARNING: This value may be stale if GrowthBook hasn't refreshed yet.
+   */
+  getValue<T>(name: string): T | undefined {
+    return getFeatureValue_CACHED_MAY_BE_STALE<T>(name)
+  },
+
+  /**
+   * Check if a feature has an environment variable override.
+   */
+  hasEnvOverride(name: string): boolean {
+    return hasGrowthBookEnvOverride(name)
+  },
+
+  /**
+   * Get all known GrowthBook features and their resolved values.
+   */
+  getAll(): Record<string, unknown> {
+    return getAllGrowthBookFeatures()
+  },
+
+  /**
+   * Get local config overrides (ant-only).
+   */
+  getConfigOverrides(): Record<string, unknown> {
+    return getGrowthBookConfigOverrides()
+  },
+
+  /**
+   * Set a local config override (ant-only).
+   */
+  setConfigOverride(name: string, value: unknown): void {
+    setGrowthBookConfigOverride(name, value)
+  },
+
+  /**
+   * Clear all local config overrides (ant-only).
+   */
+  clearConfigOverrides(): void {
+    clearGrowthBookConfigOverrides()
+  },
+
+  /**
+   * Subscribe to GrowthBook refresh events.
+   * Called after each successful refresh.
+   * Returns an unsubscribe function.
+   */
+  onRefresh(callback: () => void): Unsubscribe {
+    return onGrowthBookRefresh(callback)
+  },
+
+  /**
+   * Manually trigger a GrowthBook feature refresh.
+   * Usually not needed — periodic refresh is handled by the analytics service.
+   */
+  async refresh(): Promise<void> {
+    return refreshGrowthBookFeatures()
+  },
+} as const

src/utils/config.ts packages/config/global/config.tssrc/utils/config.ts renamed to packages/config/global/config.ts

@@ -4,46 +4,46 @@ import { unwatchFile, watchFile } from 'fs'
 import memoize from 'lodash-es/memoize.js'
 import pickBy from 'lodash-es/pickBy.js'
 import { basename, dirname, join, resolve } from 'path'
-import { getOriginalCwd, getSessionTrustAccepted } from '../bootstrap/state.js'
-import { getAutoMemEntrypoint } from '../memdir/paths.js'
-import { logEvent } from '../services/analytics/index.js'
-import type { McpServerConfig } from '../services/mcp/types.js'
+import { getOriginalCwd, getSessionTrustAccepted } from '../../../src/bootstrap/state.js'
+import { getAutoMemEntrypoint } from '../../../src/memdir/paths.js'
+import { logEvent } from '../../../src/services/analytics/index.js'
+import type { McpServerConfig } from '../../../src/services/mcp/types.js'
 import type {
   BillingType,
   ReferralEligibilityResponse,
-} from '../services/oauth/types.js'
-import { getCwd } from '../utils/cwd.js'
-import { registerCleanup } from './cleanupRegistry.js'
-import { logForDebugging } from './debug.js'
-import { logForDiagnosticsNoPII } from './diagLogs.js'
-import { getGlobalClaudeFile } from './env.js'
-import { getClaudeConfigHomeDir, isEnvTruthy } from './envUtils.js'
-import { ConfigParseError, getErrnoCode } from './errors.js'
-import { writeFileSyncAndFlush_DEPRECATED } from './file.js'
-import { getFsImplementation } from './fsOperations.js'
-import { findCanonicalGitRoot } from './git.js'
-import { safeParseJSON } from './json.js'
-import { stripBOM } from './jsonRead.js'
-import * as lockfile from './lockfile.js'
-import { logError } from './log.js'
-import type { MemoryType } from './memory/types.js'
-import { normalizePathForConfigKey } from './path.js'
-import { getEssentialTrafficOnlyReason } from './privacyLevel.js'
-import { getManagedFilePath } from './settings/managedPath.js'
-import type { ThemeSetting } from './theme.js'
+} from '../../../src/services/oauth/types.js'
+import { getCwd } from '../../../src/utils/cwd.js'
+import { registerCleanup } from '../../../src/utils/cleanupRegistry.js'
+import { logForDebugging } from '../../../src/utils/debug.js'
+import { logForDiagnosticsNoPII } from '../../../src/utils/diagLogs.js'
+import { getGlobalClaudeFile } from '../../../src/utils/env.js'
+import { getClaudeConfigHomeDir, isEnvTruthy } from '../../../src/utils/envUtils.js'
+import { ConfigParseError, getErrnoCode } from '../../../src/utils/errors.js'
+import { writeFileSyncAndFlush_DEPRECATED } from '../../../src/utils/file.js'
+import { getFsImplementation } from '../../../src/utils/fsOperations.js'
+import { findCanonicalGitRoot } from '../../../src/utils/git.js'
+import { safeParseJSON } from '../../../src/utils/json.js'
+import { stripBOM } from '../../../src/utils/jsonRead.js'
+import * as lockfile from '../../../src/utils/lockfile.js'
+import { logError } from '../../../src/utils/log.js'
+import type { MemoryType } from '../../../src/utils/memory/types.js'
+import { normalizePathForConfigKey } from '../../../src/utils/path.js'
+import { getEssentialTrafficOnlyReason } from '../../../src/utils/privacyLevel.js'
+import { getManagedFilePath } from '../settings/managedPath.js'
+import type { ThemeSetting } from '../../../src/utils/theme.js'
 
 /* eslint-disable @typescript-eslint/no-require-imports */
 const teamMemPaths = feature('TEAMMEM')
-  ? (require('../memdir/teamMemPaths.js') as typeof import('../memdir/teamMemPaths.js'))
+  ? (require('../../../src/memdir/teamMemPaths.js') as typeof import('../../../src/memdir/teamMemPaths.js'))
   : null
 const ccrAutoConnect = feature('CCR_AUTO_CONNECT')
-  ? (require('../bridge/bridgeEnabled.js') as typeof import('../bridge/bridgeEnabled.js'))
+  ? (require('../../../src/bridge/bridgeEnabled.js') as typeof import('../../../src/bridge/bridgeEnabled.js'))
   : null
 
 /* eslint-enable @typescript-eslint/no-require-imports */
-import type { ImageDimensions } from './imageResizer.js'
-import type { ModelOption } from './model/modelOptions.js'
-import { jsonParse, jsonStringify } from './slowOperations.js'
+import type { ImageDimensions } from '../../../src/utils/imageResizer.js'
+import type { ModelOption } from '../../../src/utils/model/modelOptions.js'
+import { jsonParse, jsonStringify } from '../../../src/utils/slowOperations.js'
 
 // Re-entrancy guard: prevents getConfig → logEvent → getGlobalConfig → getConfig
 // infinite recursion when the config file is corrupted. logEvent's sampling check
@@ -152,9 +152,9 @@ export type InstallMethod = 'local' | 'native' | 'global' | 'unknown'
 export {
   EDITOR_MODES,
   NOTIFICATION_CHANNELS,
-} from './configConstants.js'
+} from './constants.js'
 
-import type { EDITOR_MODES, NOTIFICATION_CHANNELS } from './configConstants.js'
+import type { EDITOR_MODES, NOTIFICATION_CHANNELS } from './constants.js'
 
 export type NotificationChannel = (typeof NOTIFICATION_CHANNELS)[number]
 
@@ -267,7 +267,7 @@ export type GlobalConfig = {
   }
 
   // /buddy companion soul — bones regenerated from userId on read. See src/buddy/.
-  companion?: import('../buddy/types.js').StoredCompanion
+  companion?: import('../../../src/buddy/types.js').StoredCompanion
   companionMuted?: boolean
 
   // Feedback survey tracking