chore: use qoder

Author: sonofmagic

.changeset/fancy-rice-divide.md

@@ -0,0 +1,17 @@
+---
+"@icebreakers/monorepo": patch
+---
+
+feat(clean): 自动删除 .qoder 文件夹
+
+优化 `clean` 命令,现在执行清理操作时会自动删除项目根目录下的 `.qoder` 文件夹。
+
+**变更内容**:
+- 在清理候选列表中添加 `.qoder` 目录
+- 更新相关测试用例以验证新功能
+
+**影响范围**:
+- `monorepo clean` 命令
+- `pnpm script:clean` 命令
+
+`.qoder` 文件夹通常用于存储 AI 助手生成的临时文件和设计文档,在清理项目模板时删除这些文件有助于保持项目的干净状态。

.dockerignore

@@ -1,6 +1,44 @@
+# Dependencies
 node_modules
+**/node_modules/
+
+# Build outputs
+dist
+**/dist/
+
+# Version control
 .git
 .gitignore
+.github
+
+# Documentation
 *.md
-dist
-**/node_modules/
+README*
+
+# Testing
+coverage
+**/coverage/
+**/*.test.ts
+**/*.test.js
+**/*.spec.ts
+**/*.spec.js
+
+# Build caches
+.turbo
+**/.turbo/
+.vitepress/cache
+**/.vitepress/cache
+
+# Development
+.vscode
+.idea
+*.log
+.DS_Store
+
+# CI/CD
+.github/workflows
+
+# Environment
+.env
+.env.*
+!.env.example

.github/workflows/ci.yml

@@ -20,10 +20,10 @@ jobs:
         os: [ubuntu-latest, windows-latest, macos-latest]
         node-version: [20, 22, 24]
     runs-on: ${{ matrix.os }}
-    # To use Remote Caching, uncomment the next lines and follow the steps below.
-    # env:
-    #  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-    #  TURBO_TEAM: ${{ vars.TURBO_TEAM }}
+    # Remote Caching enabled - configure TURBO_TOKEN and TURBO_TEAM in repository settings
+    env:
+      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
+      TURBO_TEAM: ${{ vars.TURBO_TEAM }}
 
     steps:
       - name: Check out code
@@ -38,9 +38,17 @@ jobs:
         with:
           node-version: ${{ matrix.node-version }}
           cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
 
       - name: Install dependencies
-        run: pnpm install
+        run: pnpm install --frozen-lockfile
+
+      - name: Security Audit
+        run: pnpm audit --audit-level=moderate
+        continue-on-error: true
+
+      - name: Lint
+        run: pnpm lint
 
       - name: Build
         run: pnpm build

.npmrc

@@ -3,7 +3,17 @@
 registry=https://registry.npmjs.org/
 ## 可使用国内镜像地址
 # registry=http://registry.npmmirror.com/
+
+## Git 配置
 git-checks=false
+
+## 包管理器配置
 package-manager-strict=false
+
+## 依赖处理
+auto-install-peers=true
+strict-peer-dependencies=false
+resolution-mode=highest
+
 ## 部分场景可能需要开启此配置
 # shamefully-hoist=true

.qoder/quests/fix-clean-ts-type-issue.md

@@ -0,0 +1,159 @@
+# TypeScript 类型问题修复 - clean.ts
+
+## 问题描述
+
+在 `packages/monorepo/src/commands/clean.ts` 文件中，由于启用了 `exactOptionalPropertyTypes: true` 这个严格的 TypeScript 编译选项，导致以下类型错误：
+
+```
+不能将类型"string | undefined"分配给类型"string"。
+  不能将类型"undefined"分配给类型"string"。
+```
+
+**错误位置**: 第 53-62 行的 `choices` 数组映射
+
+**根本原因**:
+
+- `x.manifest.name` 的类型是 `string | undefined`
+- 当值为 `undefined` 时，直接赋值给 `description` 属性违反了 `exactOptionalPropertyTypes` 规则
+- 该规则要求可选属性只能显式设置为其定义的类型，不能通过 `undefined` 值来表示"未设置"
+
+## 解决方案
+
+### 修复前代码
+
+```typescript
+cleanDirs = await checkbox<string>({
+  message: '请选择需要清理的目录',
+  choices: filteredPackages.map((x) => {
+    return {
+      name: path.relative(workspaceDir, x.rootDir),
+      value: x.rootDir,
+      checked: true,
+      description: x.manifest.name, // ❌ 类型错误：可能是 undefined
+    }
+  }),
+})
+```
+
+### 修复后代码
+
+```typescript
+cleanDirs = await checkbox<string>({
+  message: '请选择需要清理的目录',
+  choices: filteredPackages.map((x) => {
+    const baseChoice = {
+      name: path.relative(workspaceDir, x.rootDir),
+      value: x.rootDir,
+      checked: true,
+    }
+    // ✅ 只在有值时才添加 description 属性
+    return x.manifest.name
+      ? { ...baseChoice, description: x.manifest.name }
+      : baseChoice
+  }),
+})
+```
+
+## 技术要点
+
+### exactOptionalPropertyTypes 规则说明
+
+这是 TypeScript 4.4+ 引入的严格类型检查选项，用于区分：
+
+- **未设置的属性** (属性不存在)
+- **设置为 undefined 的属性** (属性存在但值为 undefined)
+
+**示例**:
+
+```typescript
+interface Person {
+  name: string
+  age?: number // 可选属性
+}
+
+// 启用 exactOptionalPropertyTypes 前
+const p1: Person = { name: 'Alice', age: undefined } // ✅ 允许
+const p2: Person = { name: 'Bob' } // ✅ 允许
+
+// 启用 exactOptionalPropertyTypes 后
+const p1: Person = { name: 'Alice', age: undefined } // ❌ 错误
+const p2: Person = { name: 'Bob' } // ✅ 允许
+```
+
+### 修复策略
+
+采用**条件对象展开**模式：
+
+1. 创建基础对象（包含必需属性）
+2. 根据条件动态添加可选属性
+3. 使用对象展开运算符合并
+
+**优点**:
+
+- 类型安全
+- 代码简洁
+- 符合 TypeScript 严格模式最佳实践
+
+## 验证结果
+
+### 构建验证
+
+```bash
+$ pnpm --filter @icebreakers/monorepo build
+✔ Build complete in 1791ms (CJS)
+✔ Build complete in 1794ms (ESM)
+```
+
+### 测试验证
+
+```bash
+$ pnpm --filter @icebreakers/monorepo test
+✓ 34 个测试文件通过
+✓ 102 个测试用例通过
+Duration: 4.32s
+```
+
+### 类型检查
+
+- ✅ 无 TypeScript 编译错误
+- ✅ 无 ESLint 错误
+- ✅ 所有严格类型检查通过
+
+## 影响范围
+
+**修改的文件**:
+
+- `packages/monorepo/src/commands/clean.ts` (第 51-63 行)
+
+**影响的功能**:
+
+- `monorepo clean` 命令的交互式包选择功能
+- 清理时的包列表显示
+
+**向后兼容性**:
+
+- ✅ 完全兼容，无破坏性变更
+- ✅ 功能行为保持不变
+- ✅ API 接口保持不变
+
+## 相关配置
+
+**启用的 TypeScript 严格选项** (tsconfig.json):
+
+```json
+{
+  "compilerOptions": {
+    "strict": true,
+    "exactOptionalPropertyTypes": true,
+    "noUncheckedIndexedAccess": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitOverride": true
+  }
+}
+```
+
+## 总结
+
+通过采用条件对象展开模式，成功修复了 `exactOptionalPropertyTypes` 严格模式下的类型错误。修复后的代码更加类型安全，符合 TypeScript 最佳实践，同时保持了代码的可读性和简洁性。
+
+这次修复也验证了项目在第一阶段优化中启用的严格 TypeScript 配置的有效性，确保了代码质量的提升。

.qoder/quests/monorepo-clean-optimization.md

@@ -0,0 +1,85 @@
+# packages/monorepo clean 命令优化
+
+## 变更说明
+
+优化了 `@icebreakers/monorepo` 包的 `clean` 命令,现在执行清理操作时会自动删除项目根目录下的 `.qoder` 文件夹。
+
+## 修改的文件
+
+### 1. `packages/monorepo/src/commands/clean.ts`
+
+**修改内容**:
+
+- 在 `candidates` 列表中添加了 `.qoder` 目录
+- 现在清理操作会同时删除:
+  - 用户选择的包目录
+  - `README.zh-CN.md` 文件
+  - `.qoder` 文件夹 (新增)
+
+**代码变更**:
+
+```typescript
+const readmeZh = path.resolve(workspaceDir, 'README.zh-CN.md')
+const qoderDir = path.resolve(workspaceDir, '.qoder') // 新增
+const candidates = Array.from(new Set([
+  ...cleanDirs.filter(Boolean),
+  readmeZh,
+  qoderDir, // 新增
+]))
+```
+
+### 2. `packages/monorepo/test/commands/clean.coverage.test.ts`
+
+**修改内容**:
+
+- 更新测试用例以验证 `.qoder` 目录会被删除
+- 添加断言确保 `fs.remove` 被正确调用
+
+**代码变更**:
+
+```typescript
+expect(removeMock).toHaveBeenCalledWith('/repo/.qoder')
+```
+
+## 使用方式
+
+执行清理命令时,`.qoder` 文件夹会自动被删除:
+
+```bash
+# 交互式选择要清理的包
+pnpm script:clean
+
+# 或使用 monorepo CLI
+monorepo clean
+
+# 自动清理所有包(跳过交互)
+monorepo clean --yes
+```
+
+## 验证
+
+所有测试通过:
+
+- ✅ `test/commands/clean.coverage.test.ts` - 单元测试通过
+- ✅ 全部 102 个测试通过
+- ✅ Lint 检查通过
+- ✅ 构建成功
+
+## 影响范围
+
+- **影响的命令**: `monorepo clean`, `pnpm script:clean`
+- **删除的内容**: `.qoder` 文件夹(如果存在)
+- **向后兼容**: 完全兼容,不影响现有功能
+- **副作用**: 无,`.qoder` 文件夹不存在时会被安全忽略
+
+## 技术细节
+
+`.qoder` 文件夹通常用于存储 AI 助手生成的设计文档、任务记录等临时文件。在清理项目模板时删除这些文件可以:
+
+- 保持项目的干净状态
+- 避免将 AI 助手的临时文件带入新项目
+- 符合 clean 命令的预期行为
+
+## 相关 Issue
+
+该优化是基于用户反馈,确保项目清理时移除所有非必要的临时文件和缓存目录。