chore: bump version

Author: sonofmagic

.changeset/clean-docs-oidc.md

@@ -0,0 +1,5 @@
+---
+"@icebreakers/monorepo": patch
+---
+
+Make `monorepo clean` include private packages and remove README.zh-CN by default, plus document npm OIDC publishing guidance.

apps/website/index.md

@@ -18,7 +18,7 @@ layout: doc
 
 1. **拉取模板**：[GitHub](https://github.com/sonofmagic/monorepo-template) 右上角 `Use this template`，或克隆源码。
 2. **安装依赖**：在 `pnpm-workspace.yaml` 所在目录执行 `pnpm install`（需要 Node.js ≥ 20，推荐 `npm i -g pnpm`）。
-3. **可选清理**：运行 `pnpm script:clean` 移除演示包，仅保留最小打包模板；随后再次执行 `pnpm install` 更新 lockfile。
+3. **可选清理**：直接运行 `npx -y @icebreakers/monorepo@latest clean` 远程执行清理，移除演示包后再执行 `pnpm install`（避免依赖本地构建 `monorepo`）；如已安装依赖，也可使用 `pnpm script:clean`。
 4. **初始化元数据**：`pnpm script:init` 会批量更新 `package.json`、`README.md` 等公共信息。
 
 ## 仓库结构速览
@@ -49,7 +49,7 @@ layout: doc
 
 ```bash
 npx monorepo new           # 创建子包/应用
-npx monorepo clean         # 批量删除已勾选的子项目
+npx -y @icebreakers/monorepo@latest clean  # 远程清理已勾选的子项目，避免依赖本地构建
 npx monorepo sync          # 同步所有包到 npmmirror
 npx monorepo mirror        # 写入 VS Code 镜像配置
 npx monorepo up            # 从最新模板同步配置文件

apps/website/monorepo/publish.md

@@ -98,20 +98,25 @@ jobs:
       - uses: pnpm/action-setup@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          # 这是为了使用新版本的 npm, 只有 npm@11.5.x 以上版本才支持 OIDC
+          # 否则你就必须使用 npm i -g npm@latest 来升级 npm 版本
+          node-version: 24
           cache: pnpm
+          registry-url: https://registry.npmjs.org
       - run: pnpm install
       - name: Create Release Pull Request or Publish to npm
         uses: changesets/action@v1
         with:
           publish: pnpm publish-packages
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          # npm/action-oidc-auth 会设置 NODE_AUTH_TOKEN 供 publish 使用
 ```
 
 `pnpm publish-packages` 为模板内脚本，可替换为自定义构建+发布流程。
 
+> 说明：npm 现行 token 默认 90 天过期，推荐在 CI 中使用 OIDC（如上）动态获取 `NODE_AUTH_TOKEN`，无需手动传入 `NPM_TOKEN`。若使用自托管或其他 CI，需要确保工作流具备 `id-token: write` 权限。
+
 ## 与其他方案对比
 
 | 能力 / 工具    | changesets | lerna 经典模式 | 手写脚本 |

apps/website/why/publish-basic-npm-package.md

@@ -68,7 +68,7 @@ registry.npmjs.org/:_authToken=npm_hashhashhashhashhashhashhashhashhash
 
 假如这一行存在，说明你本地的 `npm Access Token` 就设置好了，然后你才有发包的权限。
 
-> 你也可以在 `https://www.npmjs.com/settings/<你的用户名>/tokens` 中管理你的 `token`，给不同的 `token` 设置不同的作用域，有效期和 `ip` 限制，帮助你适配正常开发，`CI/CD`，`Token` 分发的各种场景
+> 你也可以在 `https://www.npmjs.com/settings/<你的用户名>/tokens` 中管理你的 `token`，给不同的 `token` 设置不同的作用域，有效期（目前最长 90 天）和 `ip` 限制，帮助你适配正常开发，`CI/CD`，`Token` 分发的各种场景；如需避免手动轮换，CI 场景推荐使用 npm 官方的 OIDC 方案获取临时 `NODE_AUTH_TOKEN`，并在工作流开启 `id-token: write` 权限。
 
 同样发私有源包也是同理:
 

monorepo.config.ts

@@ -8,7 +8,7 @@ export default defineMonorepoConfig({
     },
     clean: {
       autoConfirm: false,
-      ignorePackages: ['@icebreakers/website'],
+      includePrivate: true,
     },
     sync: {
       concurrency: 4,

packages/monorepo/src/cli/program.ts

@@ -109,6 +109,9 @@ aiCommand.command('create')
     const shouldUseTasks = Boolean(tasksFile && !opts.output && !opts.name)
 
     if (shouldUseTasks) {
+      if (!tasksFile) {
+        throw new Error('tasks file path is required when using tasks mode')
+      }
       const tasks = await loadAgenticTasks(tasksFile, cwd)
       await generateAgenticTemplates(tasks, {
         cwd,

packages/monorepo/src/commands/clean.ts

@@ -6,15 +6,16 @@ import set from 'set-value'
 import { resolveCommandConfig } from '../core/config'
 import { getWorkspaceData } from '../core/workspace'
 
-function mergeCleanConfig(base: CleanCommandConfig, overrides?: Partial<CleanCommandConfig>) {
+function mergeCleanConfig(base?: CleanCommandConfig, overrides?: Partial<CleanCommandConfig>): CleanCommandConfig {
+  const normalizedBase = base ?? {}
   if (!overrides) {
-    return base
+    return normalizedBase
   }
   const definedOverrides = Object.fromEntries(
     Object.entries(overrides).filter(([, value]) => value !== undefined),
   ) as Partial<CleanCommandConfig>
   return {
-    ...base,
+    ...normalizedBase,
     ...definedOverrides,
   }
 }
@@ -24,7 +25,8 @@ function mergeCleanConfig(base: CleanCommandConfig, overrides?: Partial<CleanCom
  */
 export async function cleanProjects(cwd: string, overrides?: Partial<CleanCommandConfig>) {
   const cleanConfig = mergeCleanConfig(await resolveCommandConfig('clean', cwd), overrides)
-  const workspaceOptions = cleanConfig?.includePrivate ? { ignorePrivatePackage: false } : undefined
+  const includePrivate = cleanConfig?.includePrivate ?? true
+  const workspaceOptions = includePrivate ? { ignorePrivatePackage: false } : undefined
   const { packages, workspaceDir } = await getWorkspaceData(cwd, workspaceOptions)
 
   // 根据配置过滤需要跳过的包，默认全部参与清理。
@@ -59,7 +61,11 @@ export async function cleanProjects(cwd: string, overrides?: Partial<CleanComman
     })
   }
 
-  const candidates = Array.from(new Set(cleanDirs.filter(Boolean)))
+  const readmeZh = path.resolve(workspaceDir, 'README.zh-CN.md')
+  const candidates = Array.from(new Set([
+    ...cleanDirs.filter(Boolean),
+    readmeZh,
+  ]))
   await Promise.all(candidates.map(async (dir) => {
     if (await fs.pathExists(dir)) {
       await fs.remove(dir)

packages/monorepo/src/types/config.ts

@@ -104,7 +104,7 @@ export interface CleanCommandConfig {
   ignorePackages?: string[]
   /**
    * 是否包含 private 包。
-   * @default false
+   * @default true
    */
   includePrivate?: boolean
   /**

packages/monorepo/test/commands/clean.coverage.test.ts

@@ -129,8 +129,10 @@ describe('clean coverage', () => {
 
     await cleanProjects(workspaceDir)
 
+    expect(getWorkspaceDataMock).toHaveBeenCalledWith(workspaceDir, { ignorePrivatePackage: false })
     expect(checkboxMock).toHaveBeenCalled()
     expect(removeMock).toHaveBeenCalledWith('/repo/packages/keep-me')
+    expect(removeMock).toHaveBeenCalledWith('/repo/README.zh-CN.md')
     expect(readJsonMock).toHaveBeenCalledWith('/repo/package.json')
     expect(outputJsonMock).toHaveBeenCalledWith('/repo/package.json', {
       devDependencies: {

packages/monorepo/test/commands/maintenance.test.ts

@@ -33,9 +33,11 @@ describe('cleanProjects', () => {
     const packagesDir = path.join(workspaceDir, 'packages')
     const pkgFooDir = path.join(packagesDir, 'foo')
     const pkgBarDir = path.join(packagesDir, 'bar')
+    const readmeZhPath = path.join(workspaceDir, 'README.zh-CN.md')
 
     await fs.ensureDir(pkgFooDir)
     await fs.ensureDir(pkgBarDir)
+    await fs.writeFile(readmeZhPath, 'should be removed')
     await fs.writeJSON(path.join(workspaceDir, 'package.json'), {
       devDependencies: {
         '@icebreakers/monorepo': '^0.1.0',
@@ -66,6 +68,7 @@ describe('cleanProjects', () => {
 
     expect(await fs.pathExists(pkgFooDir)).toBe(false)
     expect(await fs.pathExists(pkgBarDir)).toBe(false)
+    expect(await fs.pathExists(readmeZhPath)).toBe(false)
 
     const rootPkg = await fs.readJSON(path.join(workspaceDir, 'package.json'))
     expect(rootPkg.devDependencies['@icebreakers/monorepo']).toBe('latest')