@icebreakers/monorepo-templates 1.3.5 → 2.0.1

package/templates/vitepress/zh/ai/create.md

@@ -0,0 +1,45 @@
+---
+description: 给 AI 代理用的非交互配方：pnpm create repoctl --yes 创建 repoctl 工作区。
+outline: deep
+---
+
+# 用 repoctl 创建项目（AI）
+
+当代理被要求用 repoctl 创建新项目时，按本页执行。
+
+## 空目录
+
+不要提问。直接运行：
+
+```bash
+pnpm create repoctl <dir> -- --yes --templates <keys>
+cd <dir>
+pnpm install
+pnpm exec repo init
+pnpm exec repo doctor
+```
+
+等价命令：`npm create repoctl@latest <dir> -- --yes --templates <keys>` 与
+`npx create-repoctl <dir> --yes --templates <keys>`。
+`pnpm create` / `npm create` 的 flag 前必须加 `--`。
+
+## 模板 key
+
+| 用户意图            | `--templates` / `repo new --template` |
+| ------------------- | ------------------------------------- |
+| Vue / 全栈 Web      | `vue-hono`                            |
+| API / Hono 服务     | `hono-server`                         |
+| TypeScript 库 / SDK | `tsdown`                              |
+| Vue 组件库          | `vue-lib`                             |
+| 文档站              | `vitepress`                           |
+| CLI                 | `cli`                                 |
+
+意图不清时省略 `--templates`。初始化后再：
+
+```bash
+pnpm exec repo new <name> --template <key>
+```
+
+## 已有工作区
+
+若已有 `pnpm-workspace.yaml` 和 `repoctl` 依赖，不要再跑 create。改用 `repo new`，然后 `pnpm exec repo check`。

package/templates/vitepress/zh/ai/index.md

@@ -12,6 +12,7 @@ AI 文档入口用于给 Cursor、Claude Code、Codex 和其他 AI 编程工具
 | ------------------------------ | ------------------------------------------------ |
 | `/llms.txt`                    | 轻量文档索引，适合先交给 AI 工具判断要读哪些页面 |
 | `/llms-full.txt`               | 合并后的完整文档，适合需要一次性提供上下文的场景 |
+| [创建项目](./create.md)        | 非交互 `pnpm create repoctl --yes` 配方          |
 | [llms.txt 说明](./llms-txt.md) | 维护约定、访问方式和页面 frontmatter 要求        |
 
 ## 2. 在 AI 工具里怎么用

package/templates/vitepress/zh/index.md

@@ -2,7 +2,7 @@
 layout: page
 aside: false
 pageClass: repoctl-home-page
-title: repoctl
+title: repoctl 官方 Monorepo CLI
 description: 面向 pnpm 与 Turborepo monorepo 的任务型 CLI。
 ---
 

package/templates/vitepress/zh/learn/tools/repoctl-vs-pnpm-turborepo.md

@@ -0,0 +1,16 @@
+---
+title: repoctl、pnpm 与 Turborepo
+description: 了解 repoctl 如何与 pnpm、Turborepo 组合，构成现代 monorepo 工具链。
+---
+
+# repoctl、pnpm 与 Turborepo
+
+pnpm 负责包和依赖，Turborepo 负责任务编排与缓存，repoctl 负责仓库流程、约定、诊断、模板、校验、报告和发布步骤。
+
+| 工具      | 主要职责               |
+| --------- | ---------------------- |
+| pnpm      | workspace 包与依赖管理 |
+| Turborepo | 任务流水线与缓存       |
+| repoctl   | 仓库操作与引导式校验   |
+
+阅读[什么是 repoctl](/zh/start/what-is-repoctl)或[安装 repoctl](/zh/start/install-repoctl)。

package/templates/vitepress/zh/start/index.md

@@ -5,6 +5,8 @@
 ## 选择第一次操作
 
 - 如果还没有运行过命令，阅读[安装并初始化](./install.md)。
+- 阅读[什么是 repoctl？](./what-is-repoctl.md)了解产品定位。
+- 阅读[安装 repoctl](./install-repoctl.md)快速完成设置。
 - 如果已经安装 repoctl，直接[运行第一次诊断](./diagnose.md)。
 - 得到诊断结果后，进入[选择下一项任务](./choose-next.md)。
 
@@ -23,4 +25,4 @@ CLI 支持 pnpm workspace，并能理解 Turborepo 任务图，但不会替代
 
 ## 开始前确认
 
-你需要 Node.js 22.12 或更新版本，并确保 pnpm 在 PATH 中。从仓库根目录执行命令，这样 repoctl 才能读取 workspace 配置。
+你需要 Node.js 22.13 或更新版本，并确保 pnpm 在 PATH 中。从仓库根目录执行命令，这样 repoctl 才能读取 workspace 配置。

package/templates/vitepress/zh/start/install-repoctl.md

@@ -0,0 +1,16 @@
+---
+title: 安装 repoctl
+description: 在 pnpm monorepo 中安装 repoctl，初始化受管默认值并运行第一次仓库诊断。
+---
+
+# 安装 repoctl
+
+把 repoctl 安装为开发依赖，让成员和 CI 使用同一个版本。
+
+```bash
+pnpm add -D repoctl
+pnpm exec repo init
+pnpm exec repo doctor
+```
+
+接着阅读[运行校验](/zh/tasks/checks)或[接入已有 workspace](/zh/tasks/adopt-existing)。

package/templates/vitepress/zh/start/install.md

@@ -4,7 +4,7 @@
 
 ## 准备环境
 
-- Node.js 20 或更高版本。
+- Node.js 22.13 或更高版本。
 - pnpm。推荐通过 Corepack 启用：`corepack enable`。
 - Git。`repo doctor` 会读取仓库信息，用来补全 package metadata 和诊断提交链路。
 

package/templates/vitepress/zh/start/what-is-repoctl.md

@@ -0,0 +1,16 @@
+---
+title: 什么是 repoctl？
+description: repoctl 是面向 pnpm 与 Turborepo monorepo 的官方任务型 CLI，用于初始化、诊断和维护仓库。
+---
+
+# 什么是 repoctl？
+
+repoctl 把仓库约定变成可重复执行的初始化、诊断、创建、校验、报告和发布命令。
+
+```bash
+pnpm add -D repoctl
+pnpm exec repo init
+pnpm exec repo doctor
+```
+
+继续阅读[安装 repoctl](/zh/start/install-repoctl)或[命令速查](/zh/reference/commands)。

package/templates/vitepress/zh/tasks/adopt-existing.md

@@ -8,7 +8,7 @@
 
 - 在 workspace 根目录执行命令。
 - 提交或暂存与本次接入无关的本地改动。
-- 确认 Node.js 22.12 或更新版本以及 pnpm 可用。
+- 确认 Node.js 22.13 或更新版本以及 pnpm 可用。
 
 ## 最小命令
 

package/templates/vue-lib/package.json

@@ -5,7 +5,7 @@
   "private": true,
   "description": "Internal Vue library template shipped with repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
-  "license": "ISC",
+  "license": "MIT",
   "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
@@ -32,6 +32,9 @@
   "files": [
     "dist"
   ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "build": "vue-tsc -b && vite build",
     "test": "vitest run",
@@ -56,13 +59,13 @@
     "types": "./dist/index.d.ts"
   },
   "devDependencies": {
-    "@vitejs/plugin-vue": "^6.0.8",
-    "@vue/test-utils": "^2.5.0",
+    "@vitejs/plugin-vue": "^6.0.9",
+    "@vue/test-utils": "^2.5.1",
     "@vue/tsconfig": "^0.9.1",
-    "jsdom": "^30.0.1",
-    "vite": "^8.2.2",
+    "jsdom": "^30.1.0",
+    "vite": "^8.3.0",
     "vite-plugin-dts": "^5.1.0",
-    "vue": "^3.5.42",
+    "vue": "^3.5.43",
     "vue-tsc": "^3.3.11"
   }
 }

package/templates/vue-lib/tsconfig.node.json

@@ -21,5 +21,5 @@
     "skipLibCheck": true,
     "noUncheckedSideEffectImports": true
   },
-  "include": ["vite.config.ts"]
+  "include": ["vite.config.ts", "vite.shared.config.ts"]
 }

package/templates/vue-lib/vite.config.ts

@@ -1,8 +1,8 @@
+import path from 'node:path'
 import Vue from '@vitejs/plugin-vue'
-import path from 'pathe'
 import { mergeConfig } from 'vite'
 import DTS from 'vite-plugin-dts'
-import { sharedConfig } from './vite.shared.config'
+import { sharedConfig } from './vite.shared.config.ts'
 
 export default mergeConfig(sharedConfig, {
   plugins: [

package/templates/vue-lib/vite.shared.config.ts

@@ -1,7 +1,7 @@
-import path from 'pathe'
+import path from 'node:path'
+import { defineConfig } from 'vite'
 
 // https://vite.dev/guide/build.html#library-mode
-import { defineConfig } from 'vite'
 
 export const sharedConfig = defineConfig({
   resolve: {