@icebreakers/monorepo-templates 2.0.0 → 2.0.1

package/assets/.github/workflows/ci.yml

@@ -79,6 +79,6 @@ jobs:
         run: pnpm test
 
       - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

package/assets/.github/workflows/release.yml

@@ -21,6 +21,7 @@ on:
           - prepare
           - publish
           - publish-unpublished
+          - reconcile
       package:
         description: Package used for unpublished-version recovery
         required: false
@@ -29,6 +30,11 @@ on:
         description: Version used for unpublished-version recovery
         required: false
         type: string
+      dry-run:
+        description: Preview release reconciliation without changes
+        required: false
+        default: false
+        type: boolean
 
 env:
   HUSKY: 0
@@ -72,4 +78,5 @@ jobs:
           REPO_RELEASE_MODE: ${{ inputs.mode || 'auto' }}
           REPO_RELEASE_PACKAGE: ${{ inputs.package }}
           REPO_RELEASE_VERSION: ${{ inputs.version }}
+          REPO_RELEASE_DRY_RUN: ${{ inputs.dry-run }}
         run: pnpm exec repo release ci

package/assets/package.json

@@ -3,7 +3,7 @@
   "type": "module",
   "version": "0.0.0",
   "private": true,
-  "packageManager": "pnpm@12.3.4",
+  "packageManager": "pnpm@12.4.2",
   "description": "Source workspace for repoctl and Icebreaker's shared development packages",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
@@ -72,13 +72,13 @@
   },
   "devDependencies": {
     "@commitlint/cli": "^21.2.2",
-    "@eslint/config-inspector": "^3.4.1",
+    "@eslint/config-inspector": "^3.5.0",
     "@icebreakers/commitlint-config": "workspace:*",
     "@icebreakers/eslint-config": "workspace:*",
     "@icebreakers/monorepo": "workspace:*",
     "@icebreakers/stylelint-config": "workspace:*",
-    "@types/node": "^26.5.1",
-    "@vitest/coverage-v8": "~5.0.0",
+    "@types/node": "^26.6.1",
+    "@vitest/coverage-v8": "~5.0.1",
     "eslint": "^10.10.0",
     "execa": "^10.0.1",
     "husky": "^9.1.7",
@@ -89,10 +89,10 @@
     "tailwindcss": "^4.3.3",
     "tsd": "^0.33.0",
     "tsdown": "0.23.0",
-    "turbo": "^2.10.12",
+    "turbo": "^2.10.13",
     "typescript": "^6.0.3",
-    "vitest": "~5.0.0",
-    "yaml": "^2.9.0"
+    "vitest": "~5.0.1",
+    "yaml": "^2.9.1"
   },
   "publishConfig": {
     "access": "public",

package/assets/pnpm-workspace.yaml

@@ -15,15 +15,15 @@ allowBuilds:
   vue-demi: true
   workerd: true
 overrides:
-  prettier: 3.9.6
+  prettier: 3.9.7
   typescript: 6.0.3
   vite: 8.3.0
   postcss: 8.5.28
   postcss-selector-parser: 7.1.6
-  js-yaml: 5.4.1
+  js-yaml: 5.4.2
   nanoid: 6.0.1
-  brace-expansion: 5.0.9
+  brace-expansion: 5.0.12
   cross-spawn: 7.0.6
-  adm-zip: 0.6.0
+  adm-zip: 0.6.1
   uuid: 14.0.2
   esbuild: 0.28.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/monorepo-templates",
   "type": "module",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Built-in project templates and managed workspace assets for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
@@ -51,7 +51,7 @@
     "@inquirer/select": "^5.2.5",
     "commander": "^15.0.0",
     "nanoexec": "^1.1.0",
-    "yaml": "^2.9.0"
+    "yaml": "^2.9.1"
   },
   "publishConfig": {
     "access": "public",

package/templates/client/package.json

@@ -37,37 +37,37 @@
   },
   "dependencies": {
     "@faker-js/faker": "^10.6.0",
-    "@tanstack/vue-query": "^5.102.8",
-    "@tanstack/vue-query-devtools": "^6.1.48",
+    "@tanstack/vue-query": "^5.103.1",
+    "@tanstack/vue-query-devtools": "^6.2.1",
     "@tanstack/vue-table": "^9.2.4",
-    "@tanstack/vue-virtual": "^3.13.38",
-    "@trpc/client": "^11.18.0",
+    "@tanstack/vue-virtual": "^3.13.39",
+    "@trpc/client": "^11.19.0",
     "clsx": "^2.1.1",
     "pinia": "^4.0.3",
-    "tailwind-merge": "^3.6.0",
+    "tailwind-merge": "^3.7.0",
     "tailwind-variants": "^3.3.1",
-    "vue": "^3.5.42",
-    "vue-i18n": "^11.4.10",
+    "vue": "^3.5.43",
+    "vue-i18n": "^11.4.12",
     "vue-router": "^5.3.1"
   },
   "devDependencies": {
-    "@cloudflare/vite-plugin": "^1.54.8",
+    "@cloudflare/vite-plugin": "^1.54.11",
     "@hono/node-server": "^2.1.1",
     "@hono/trpc-server": "^0.4.2",
     "@tailwindcss/vite": "^4.3.3",
-    "@trpc/server": "^11.18.0",
-    "@vitejs/plugin-vue": "^6.0.8",
+    "@trpc/server": "^11.19.0",
+    "@vitejs/plugin-vue": "^6.0.9",
     "@vitejs/plugin-vue-jsx": "^5.1.6",
     "@vue/tsconfig": "^0.9.1",
     "consola": "^3.4.2",
-    "hono": "^4.13.7",
+    "hono": "^4.13.8",
     "tailwindcss": "^4.3.3",
     "typescript": "~6.0.3",
     "vite": "^8.3.0",
     "vite-plugin-vue-devtools": "^8.2.1",
     "vite-tsconfig-paths": "^6.1.1",
     "vue-tsc": "3.3.11",
-    "wrangler": "^4.131.1",
-    "zod": "^4.6.2"
+    "wrangler": "^4.133.0",
+    "zod": "^4.6.5"
   }
 }

package/templates/server/package.json

@@ -66,9 +66,9 @@
   "devDependencies": {
     "@hono/node-server": "^2.1.1",
     "consola": "^3.4.2",
-    "hono": "^4.13.7",
+    "hono": "^4.13.8",
     "tsdown": "0.23.0",
-    "wrangler": "^4.131.1",
-    "zod": "^4.6.2"
+    "wrangler": "^4.133.0",
+    "zod": "^4.6.5"
   }
 }

package/templates/vitepress/.vitepress/config.ts

@@ -9,6 +9,7 @@ export default withMermaid(defineConfig({
   outDir: '.vitepress/dist',
   srcExclude: ['CHANGELOG.md', 'learn/packages/examples/**', 'zh/learn/packages/examples/**'],
   title: 'repoctl',
+  titleTemplate: ':title — Official CLI for pnpm and Turborepo Monorepos',
   description: 'A practical CLI guide for setting up, checking, and maintaining pnpm and Turborepo monorepos.',
   lastUpdated: true,
   cleanUrls: true,

package/templates/vitepress/.vitepress/seo.ts

@@ -29,6 +29,14 @@ export function createPageHead({ page, title, description }: TransformContext):
   const socialImageAlt = isChinese
     ? 'repoctl：面向 pnpm 与 Turborepo monorepo 的任务型 CLI'
     : 'repoctl: task-first CLI for pnpm and Turborepo monorepos'
+  const jsonLd = {
+    '@context': 'https://schema.org',
+    '@graph': [
+      { '@type': 'Organization', 'name': 'repoctl', 'url': siteOrigin, 'logo': `${siteOrigin}/brand/repoctl-mark.svg`, 'sameAs': ['https://github.com/sonofmagic/repoctl', 'https://www.npmjs.com/package/repoctl'] },
+      { '@type': 'SoftwareApplication', 'name': 'repoctl', 'applicationCategory': 'DeveloperApplication', 'operatingSystem': 'macOS, Linux, Windows', 'url': siteOrigin, description, 'sameAs': ['https://github.com/sonofmagic/repoctl', 'https://www.npmjs.com/package/repoctl'], 'offers': { '@type': 'Offer', 'price': '0', 'priceCurrency': 'USD' } },
+      { '@type': 'WebSite', 'name': 'repoctl', 'url': siteOrigin, 'potentialAction': { '@type': 'SearchAction', 'target': `${siteOrigin}/reference/commands?q={search_term_string}`, 'query-input': 'required name=search_term_string' } },
+    ],
+  }
 
   return [
     ['link', { rel: 'canonical', href: canonical }],
@@ -45,10 +53,14 @@ export function createPageHead({ page, title, description }: TransformContext):
     ['meta', { property: 'og:image:width', content: '1200' }],
     ['meta', { property: 'og:image:height', content: '630' }],
     ['meta', { property: 'og:image:alt', content: socialImageAlt }],
+    ['meta', { property: 'og:image:type', content: 'image/png' }],
+    ['meta', { name: 'author', content: 'repoctl contributors' }],
+    ['meta', { name: 'application-name', content: 'repoctl' }],
     ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
     ['meta', { name: 'twitter:title', content: title }],
     ['meta', { name: 'twitter:description', content: description }],
     ['meta', { name: 'twitter:image', content: socialImage }],
     ['meta', { name: 'twitter:image:alt', content: socialImageAlt }],
+    ['script', { type: 'application/ld+json' }, JSON.stringify(jsonLd)],
   ]
 }

package/templates/vitepress/.vitepress/theme/components/HomePage.vue

@@ -5,6 +5,19 @@ import { homeContent } from '../../home/content'
 
 const props = defineProps<{ locale: DocsLocale }>()
 const content = computed(() => homeContent[props.locale])
+const faq = computed(() => props.locale === 'zh'
+  ? [
+      ['repoctl 是什么？', 'repoctl 是面向 pnpm 与 Turborepo monorepo 的任务型 CLI，用于初始化、诊断、创建、校验和发布工作区。'],
+      ['如何安装 repoctl？', '在项目中运行 pnpm add -D repoctl，然后使用 pnpm exec repo init 和 pnpm exec repo doctor。'],
+      ['repoctl 与 pnpm、Turborepo 是什么关系？', 'pnpm 和 Turborepo 负责包管理与任务编排，repoctl 负责把团队约定、检查和日常操作组织成可复用任务。'],
+      ['repo doctor 与 repo check 有什么区别？', 'repo doctor 诊断仓库健康状况，repo check 规划并执行 lint、类型、构建和测试校验。'],
+    ]
+  : [
+      ['What is repoctl?', 'repoctl is a task-first CLI for initializing, diagnosing, creating, checking, and releasing pnpm and Turborepo monorepos.'],
+      ['How do I install repoctl?', 'Run pnpm add -D repoctl, then use pnpm exec repo init and pnpm exec repo doctor.'],
+      ['How does repoctl relate to pnpm and Turborepo?', 'pnpm and Turborepo provide package management and task orchestration; repoctl turns repository conventions and checks into reusable tasks.'],
+      ['What is the difference between repo doctor and repo check?', 'repo doctor diagnoses repository health, while repo check plans and runs lint, type, build, and test checks.'],
+    ])
 </script>
 
 <template>
@@ -108,5 +121,17 @@ const content = computed(() => homeContent[props.locale])
         </a>
       </div>
     </section>
+    <section class="repoctl-home__section repoctl-home__faq" aria-labelledby="repoctl-faq-title">
+      <h2 id="repoctl-faq-title">
+        {{ props.locale === 'zh' ? '常见问题' : 'Frequently asked questions' }}
+      </h2>
+      <details v-for="item in faq" :key="item[0]">
+        <summary>{{ item[0] }}</summary>
+        <p>{{ item[1] }}</p>
+      </details>
+      <script type="application/ld+json">
+        {{ JSON.stringify({ '@context': 'https://schema.org', '@type': 'FAQPage', "mainEntity": faq.map(item => ({ '@type': 'Question', "name": item[0], "acceptedAnswer": { '@type': 'Answer', "text": item[1] } })) }) }}
+      </script>
+    </section>
   </main>
 </template>

package/templates/vitepress/ai/index.md

@@ -4,6 +4,18 @@ outline: deep
 
 # AI Documentation
 
+## Product facts
+
+| Field         | Value                                                |
+| ------------- | ---------------------------------------------------- |
+| Product       | repoctl, task-first CLI for monorepos                |
+| Official site | https://repoctl.icebreaker.top                       |
+| Source        | https://github.com/sonofmagic/repoctl                |
+| npm package   | `repoctl` — https://www.npmjs.com/package/repoctl    |
+| Install       | `pnpm add -D repoctl`                                |
+| Core commands | `repo init`, `repo doctor`, `repo new`, `repo check` |
+| Works with    | pnpm workspaces and Turborepo                        |
+
 repoctl publishes AI-readable documentation alongside the human site.
 
 ## Recommended Entrypoints

package/templates/vitepress/index.md

@@ -2,7 +2,7 @@
 layout: page
 aside: false
 pageClass: repoctl-home-page
-title: repoctl
+title: repoctl Official Monorepo CLI
 description: Task-first CLI for initializing, maintaining, validating, and releasing pnpm and Turborepo monorepos.
 ---
 

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

@@ -0,0 +1,16 @@
+---
+title: repoctl, pnpm, and Turborepo
+description: Understand how repoctl complements pnpm and Turborepo in a modern monorepo toolchain.
+---
+
+# repoctl, pnpm, and Turborepo
+
+pnpm manages packages and dependencies. Turborepo orchestrates tasks and caching. repoctl provides repository workflows, conventions, diagnostics, templates, checks, reports, and release steps.
+
+| Tool      | Primary responsibility                       |
+| --------- | -------------------------------------------- |
+| pnpm      | Workspace packages and dependency management |
+| Turborepo | Task pipelines and caching                   |
+| repoctl   | Repository operations and guided checks      |
+
+See [what repoctl is](/start/what-is-repoctl) and [install repoctl](/start/install-repoctl).

package/templates/vitepress/package.json

@@ -37,7 +37,7 @@
     "typecheck": "vue-tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "vue": "^3.5.42"
+    "vue": "^3.5.43"
   },
   "devDependencies": {
     "@braintree/sanitize-url": "^7.1.2",
@@ -52,6 +52,6 @@
     "vitepress-plugin-llms": "^1.14.0",
     "vitepress-plugin-mermaid": "^2.0.17",
     "vue-tsc": "^3.3.11",
-    "wrangler": "^4.131.1"
+    "wrangler": "^4.133.0"
   }
 }

package/templates/vitepress/public/robots.txt

@@ -0,0 +1,5 @@
+User-agent: *
+Allow: /
+Disallow: /_headers
+
+Sitemap: https://repoctl.icebreaker.top/sitemap.xml

package/templates/vitepress/start/index.md

@@ -5,6 +5,8 @@ Use this section when repoctl is new to you. The shortest useful path is to inst
 ## Pick your first move
 
 - [Install and initialize](./install.md) if this is your first repoctl command.
+- [What is repoctl?](./what-is-repoctl.md) for the product overview.
+- [Install repoctl](./install-repoctl.md) for the shortest setup path.
 - [Run the first diagnosis](./diagnose.md) if repoctl is already installed.
 - [Choose the next task](./choose-next.md) after you have a diagnosis.
 

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

@@ -0,0 +1,16 @@
+---
+title: Install repoctl
+description: Install repoctl in a pnpm monorepo, initialize managed defaults, and run your first repository diagnosis.
+---
+
+# Install repoctl
+
+Install repoctl as a development dependency so every teammate and CI job uses the same version.
+
+```bash
+pnpm add -D repoctl
+pnpm exec repo init
+pnpm exec repo doctor
+```
+
+Continue with [checks](/tasks/checks) or [adopting an existing workspace](/tasks/adopt-existing).

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

@@ -0,0 +1,18 @@
+---
+title: What is repoctl?
+description: repoctl is the official task-first CLI for initializing, diagnosing, and maintaining pnpm and Turborepo monorepos.
+---
+
+# What is repoctl?
+
+repoctl is a task-first CLI for teams that build and maintain pnpm or Turborepo monorepos. It turns repository conventions into repeatable commands for initialization, diagnosis, project creation, checks, reports, and releases.
+
+## Start with repoctl
+
+```bash
+pnpm add -D repoctl
+pnpm exec repo init
+pnpm exec repo doctor
+```
+
+Read the [installation guide](/start/install-repoctl) or [command reference](/reference/commands).

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)。
 

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/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/vue-lib/package.json

@@ -59,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",
+    "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"
   }
 }