feat: add undercover mode support with ANT build target

Adds support for building the application in undercover mode by introducing
a new 'ant' build target. This enables specialized functionality for
internal testing scenarios while maintaining the default external build
behavior.

The changes include:
- New --ant flag to scripts/build.ts to specify build target
- Updated define() function to handle process.env values based on build
  target
- Added @types/asciichart dependency for internal metrics visualization
- Set USER_TYPE=external in .env.sample as default
- Enhanced frontend agent guidelines with proper formatting

This builds upon recent TypeScript conversions and maintains compatibility
with existing workflows.

Author: sobird

.claude/agents/frontend-expert.md

@@ -16,10 +16,10 @@ description: 专注于 TypeScript 和现代 CSS 的前端架构专家
 
 ### 沟通准则 (Communication Guidelines)
 
-1.**拒绝直给**：严禁直接贴出完整的 Bug 修复代码。必须先质疑对方的底层逻辑。
-2.**升维打击**：如果对方问一个具体的 CSS 样式，你要谈到设计系统的原子化抽象；如果对方问 Bun 的路径问题，你要谈到运行时环境的跨平台解耦。
-3.**强调闭环**：所有的技术动作必须有反馈，必须能反哺业务。
-4.**亲切称呼**：开头统一使用“同学”，结尾统一使用“共勉”或“对齐一下”。
+1. **拒绝直给**：严禁直接贴出完整的 Bug 修复代码。必须先质疑对方的底层逻辑。
+2. **升维打击**：如果对方问一个具体的 CSS 样式，你要谈到设计系统的原子化抽象；如果对方问 Bun 的路径问题，你要谈到运行时环境的跨平台解耦。
+3. **强调闭环**：所有的技术动作必须有反馈，必须能反哺业务。
+4. **亲切称呼**：开头统一使用“同学”，结尾统一使用“共勉”或“对齐一下”。
 
 ### 响应模板 (Response Templates)
 ### 场景 A：当有人提交了一个 Bug Issue
@@ -47,9 +47,9 @@ description: 专注于 TypeScript 和现代 CSS 的前端架构专家
 
 **建议方向：**
 
-1.**解构**：把路径解析逻辑从业务代码中**抽离**出来，下沉到**配置层**。
-2.**赋能**：利用 `process.execPath` 实现环境自适应，为后续的分发场景提供护城河。
-3.**闭环**：在 `memoize` 之后加上兜底方案，确保系统的可观测性。
+1. **解构**：把路径解析逻辑从业务代码中**抽离**出来，下沉到**配置层**。
+2. **赋能**：利用 `process.execPath` 实现环境自适应，为后续的分发场景提供护城河。
+3. **闭环**：在 `memoize` 之后加上兜底方案，确保系统的可观测性。
 
 先按照这个**打法**去演进一下代码，我们下午再**拉通**看下效果。共勉。”
 

.env.sample

@@ -158,4 +158,5 @@ ANTHROPIC_API_KEY=sk-ant-your-key-here
 # Enable debug logging
 # CLAUDE_DEBUG=1
 
-NODE_ENV=development
+NODE_ENV=development
+USER_TYPE=external

bun.lock

@@ -27,6 +27,7 @@
     "dev": "bun scripts/dev.ts",
     "debug": "bun scripts/debug.ts --debug",
     "build": "bun scripts/build.ts",
+    "build:ant": "bun scripts/build.ts --ant",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
     "test": "bun test",
@@ -139,6 +140,7 @@
     "@commitlint/cli": "^20.5.0",
     "@commitlint/config-conventional": "^20.5.0",
     "@commitlint/types": "^20.5.0",
+    "@types/asciichart": "^1.5.8",
     "@types/bun": "^1.3.11",
     "@types/cacache": "^20.0.1",
     "@types/lodash-es": "^4.17.12",

package.json

@@ -1,4 +1,7 @@
+import type { BuildTarget } from './config';
+
 import { rm } from 'node:fs/promises';
+import { parseArgs } from 'node:util';
 
 import {
   banner, define, external, features,
@@ -10,6 +13,17 @@ const outdir = 'dist';
 // Clean output directory
 await rm(outdir, { recursive: true, force: true });
 
+const { values } = parseArgs({
+  args: Bun.argv,
+  options: {
+    ant: { type: 'boolean', default: false },
+  },
+  strict: false,
+  allowPositionals: true,
+});
+
+const buildTraget: BuildTarget = Boolean(values.ant) ? 'ant' : 'external';
+
 // Bundle
 const result = await Bun.build({
   entrypoints: ['src/entrypoints/cli.tsx'],
@@ -18,7 +32,7 @@ const result = await Bun.build({
   format: 'esm',
   minify: !isDevelopment,
   // compile: true,
-  define: define(),
+  define: define(buildTraget),
   features,
   banner,
   external,

scripts/build.ts

@@ -93,28 +93,31 @@ export const features = [
   // 'WORKFLOW_SCRIPTS',
 ];
 
-type BuildTarget = 'ant' | 'external';
-type BuildEnv = 'development' | 'production' | 'test';
+export const defines = {
+  'MACRO.VERSION': JSON.stringify(version),
+  'MACRO.BUILD_TIME': JSON.stringify(new Date().toISOString()),
+  'MACRO.FEEDBACK_CHANNEL': JSON.stringify(bugs.url),
+  'MACRO.ISSUES_EXPLAINER': JSON.stringify(`report the issue at ${bugs.url}`),
+  'MACRO.NATIVE_PACKAGE_URL': JSON.stringify(name),
+  'MACRO.PACKAGE_URL': JSON.stringify(name),
+  'MACRO.VERSION_CHANGELOG': JSON.stringify(''),
+};
+
+export type BuildTarget = 'ant' | 'external';
+export type BuildEnv = 'development' | 'production' | 'test';
 
 export function define(
   buildTraget: BuildTarget = 'external',
   buildEnv: BuildEnv = 'production',
 ) {
   return {
-    'MACRO.VERSION': JSON.stringify(version),
-    'MACRO.BUILD_TIME': JSON.stringify(new Date().toISOString()),
-    'MACRO.FEEDBACK_CHANNEL': JSON.stringify(bugs.url),
-    'MACRO.ISSUES_EXPLAINER': JSON.stringify(`report the issue at ${bugs.url}`),
-    'MACRO.NATIVE_PACKAGE_URL': JSON.stringify(name),
-    'MACRO.PACKAGE_URL': JSON.stringify(name),
-    'MACRO.VERSION_CHANGELOG': JSON.stringify(''),
-    // 测试使用.env中
-    // 'process.env.NODE_ENV': JSON.stringify(buildEnv),
-    // 'process.env.USER_TYPE': JSON.stringify(buildTraget),
+    ...defines,
+    'process.env.NODE_ENV': JSON.stringify(buildEnv),
+    'process.env.USER_TYPE': JSON.stringify(buildTraget),
   };
 }
 
-export const defineArgs = Object.entries(define()).flatMap(([k, v]) => ['-d', `${k}:${v}`]);
+export const defineArgs = Object.entries(defines).flatMap(([k, v]) => ['-d', `${k}:${v}`]);
 
 export const banner = `#!/usr/bin/env node
 // (c) Anthropic PBC. All rights reserved. Use is subject to the Legal Agreements outlined here: https://code.claude.com/docs/en/legal-and-compliance.