@icebreakers/monorepo-templates 1.2.1 → 1.3.0

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

@@ -27,14 +27,14 @@ jobs:
 
     steps:
       - name: Check out code
-        uses: actions/checkout@v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 2
 
-      - uses: pnpm/action-setup@v6
+      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
 
       - name: Setup Node.js environment
-        uses: actions/setup-node@v7
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
           node-version: ${{ matrix.node-version }}
           cache: pnpm
@@ -68,6 +68,6 @@ jobs:
         run: pnpm test
 
       - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v7
+        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

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

@@ -30,8 +30,6 @@ on:
         required: false
         type: string
 
-concurrency: ${{ github.workflow }}-${{ github.ref }}
-
 env:
   HUSKY: 0
   NPM_CONFIG_PROVENANCE: true
@@ -42,21 +40,24 @@ permissions:
   pull-requests: write
   id-token: write
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
 jobs:
   release:
-    if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
     name: Release
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
 
-      - uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda # v4.1.0
+      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
 
       - name: Setup Node.js environment
-        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
           node-version: 24
           cache: pnpm
@@ -67,7 +68,7 @@ jobs:
 
       - name: Run repo release CI
         env:
-          GITHUB_TOKEN: ${{ github.token }}
+          GITHUB_TOKEN: ${{ secrets.REPOCTL_RELEASE_TOKEN || secrets.CHANGESETS_RELEASE_TOKEN || github.token }}
           REPO_RELEASE_MODE: ${{ inputs.mode || 'auto' }}
           REPO_RELEASE_PACKAGE: ${{ inputs.package }}
           REPO_RELEASE_VERSION: ${{ inputs.version }}

package/assets/package.json

@@ -6,7 +6,7 @@
   "packageManager": "pnpm@11.22.0",
   "description": "Source workspace for repoctl, a task-first CLI for pnpm and Turborepo monorepos",
   "author": "ice breaker <hi@sonofmagic.top>",
-  "homepage": "https://repo.icebreaker.top",
+  "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sonofmagic/repoctl.git"
@@ -29,6 +29,7 @@
     "tooling:build": "turbo run build --filter=@icebreakers/monorepo --filter=repoctl",
     "dev": "turbo run dev --parallel",
     "test": "vitest run",
+    "test:packaged-doctor": "node scripts/smoke-packaged-doctor.mjs",
     "test:dev": "vitest",
     "lint": "pnpm run tooling:build && turbo run lint",
     "tsd": "turbo run tsd",

package/assets/renovate.json

@@ -5,7 +5,6 @@
     "group:allNonMajor",
     ":semanticCommitTypeAll(chore)"
   ],
-  "commitBody": "[skip netlify]",
   "rangeStrategy": "bump",
   "npm": {
     "commitMessageTopic": "{{prettyDepType}} {{depName}}"

package/assets-data.mjs

@@ -36,7 +36,6 @@ const extraAssetTargets = [
   'SECURITY.md',
   'CODE_OF_CONDUCT.md',
   'CONTRIBUTING.md',
-  'netlify.toml',
 ]
 
 export const assetTargets = [...coreAssetTargets, ...extraAssetTargets]

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { t as prepareAssets } from "./prepare--cxFop8c.mjs";
+import { t as prepareAssets } from "./prepare-D7eJqEqy.mjs";
 import process from "node:process";
 //#region src/cli.ts
 async function main() {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as toPublishGitignorePath, c as assetsDir, d as templatesDir, f as assetTargets$1, i as isGitignoreFile, l as packageDir, n as createTemplateCopyFilter, o as toWorkspaceGitignorePath, p as getAssetTargets$1, r as shouldSkipTemplatePath, s as templateChoices$1, t as prepareAssets, u as skeletonDir } from "./prepare--cxFop8c.mjs";
+import { a as toPublishGitignorePath, c as assetsDir, d as templatesDir, f as assetTargets$1, i as isGitignoreFile, l as packageDir, n as createTemplateCopyFilter, o as toWorkspaceGitignorePath, p as getAssetTargets$1, r as shouldSkipTemplatePath, s as templateChoices$1, t as prepareAssets, u as skeletonDir } from "./prepare-D7eJqEqy.mjs";
 import path from "node:path";
 import fs, { access, open, rm } from "node:fs/promises";
 import exec from "nanoexec";

package/dist/{prepare--cxFop8c.mjs → prepare-D7eJqEqy.mjs}

@@ -32,8 +32,7 @@ const extraAssetTargets = [
 	"renovate.json",
 	"SECURITY.md",
 	"CODE_OF_CONDUCT.md",
-	"CONTRIBUTING.md",
-	"netlify.toml"
+	"CONTRIBUTING.md"
 ];
 const assetTargets = [...coreAssetTargets, ...extraAssetTargets];
 function getAssetTargets(core = false) {

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@icebreakers/monorepo-templates",
   "type": "module",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Built-in project templates and managed workspace assets for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
-  "homepage": "https://repo.icebreaker.top",
+  "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sonofmagic/repoctl.git",

package/templates/cli/package.json

@@ -6,7 +6,7 @@
   "description": "Internal CLI template shipped with repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
-  "homepage": "https://repo.icebreaker.top",
+  "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sonofmagic/repoctl.git",

package/templates/client/package.json

@@ -4,7 +4,7 @@
   "version": "0.0.1",
   "private": true,
   "description": "Internal Vue and Cloudflare application template shipped with repoctl",
-  "homepage": "https://repo.icebreaker.top",
+  "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sonofmagic/repoctl.git",

package/templates/server/package.json

@@ -6,7 +6,7 @@
   "description": "Internal server package template shipped with repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
-  "homepage": "https://repo.icebreaker.top",
+  "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sonofmagic/repoctl.git",

package/templates/tsdown/package.json

@@ -6,7 +6,7 @@
   "description": "Internal TypeScript library template shipped with repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
-  "homepage": "https://repo.icebreaker.top",
+  "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sonofmagic/repoctl.git",

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

@@ -2,106 +2,8 @@ import Tailwindcss from '@tailwindcss/vite'
 import { defineConfig } from 'vitepress'
 import llmstxt from 'vitepress-plugin-llms'
 import { withMermaid } from 'vitepress-plugin-mermaid'
-
-interface SidebarLabels {
-  repoctl: string
-  repoctlItems: string[]
-  knowledge: string
-  knowledgeItems: string[]
-  packages: string
-  packageItems: string[]
-  ai: string
-  aiItems: string[]
-  tools: string
-  toolItems: string[]
-}
-
-const repoctlPaths = [
-  '',
-  'getting-started',
-  'adopt-existing',
-  'scenarios',
-  'execution-model',
-  'commands',
-  'checks',
-  'doctor',
-  'config',
-  'templates',
-  'template-assets',
-  'workflows',
-  'reports',
-  'troubleshooting',
-  'aliases',
-]
-const knowledgePaths = ['', 'manage', 'publish', 'commands', 'templates', 'troubleshooting']
-const packagePaths = [
-  'how-to-reuse-js-code',
-  'js-cjs-mjs',
-  'js-keywords',
-  'what-is-npm-package',
-  'publish-basic-npm-package',
-  'index',
-  'modern/',
-  'modern/esm-vs-cjs',
-  'modern/dts',
-  'modern/package-entry-points',
-  'modern/bundlers',
-  'modern/typescript',
-]
-const aiPaths = ['', 'llms-txt']
-const toolPaths = ['', 'pnpm', 'turborepo', 'changeset', 'husky', 'lint-staged', 'renovate', 'llms-txt']
-
-const englishLabels: SidebarLabels = {
-  repoctl: 'repoctl',
-  repoctlItems: ['Overview', 'Getting Started', 'Adopt Existing Repos', 'Choose By Scenario', 'Execution Model', 'Command Reference', 'Verification', 'Doctor', 'Configuration', 'Templates', 'Template Assets', 'Workflows and CI', 'Reports', 'Troubleshooting', 'Command Aliases'],
-  knowledge: 'Knowledge Base',
-  knowledgeItems: ['Why Monorepo', 'Managing A Monorepo', 'Publishing and Changelogs', 'Monorepo Commands', 'Template Systems', 'Troubleshooting'],
-  packages: 'Modern Packages',
-  packageItems: ['Reusing JavaScript', 'Module Extensions', 'Runtime Globals', 'What Is An npm Package?', 'Publishing A Package', 'Package Evolution', 'Modern Package Guide', 'ESM vs CommonJS', 'Type Declarations', 'Package Entry Points', 'Bundlers', 'TypeScript'],
-  ai: 'AI',
-  aiItems: ['AI Documentation', 'llms.txt'],
-  tools: 'Tool Guides',
-  toolItems: ['Overview', 'pnpm', 'Turborepo', 'pnpm Versioning', 'Husky', 'lint-staged', 'Renovate', 'llms.txt'],
-}
-
-const chineseLabels: SidebarLabels = {
-  repoctl: 'repoctl',
-  repoctlItems: ['概览', '快速开始', '接入已有仓库', '按场景选命令', '执行模型', '命令速查', '校验链路', 'Doctor 诊断', '配置文件', '模板与创建', '模板资产治理', '工作流与 CI', '报告与自动化输出', '排障', '命令别名'],
-  knowledge: '知识库',
-  knowledgeItems: ['为什么使用 Monorepo', '管理 Monorepo', '发包与变更日志', 'Monorepo 命令', '模板体系', '常见问题排障'],
-  packages: '现代 npm 包',
-  packageItems: ['复用 JavaScript', '模块文件后缀', '运行时关键字', '什么是 npm 包', '发布 npm 包', '包的演进', '现代包指南', 'ESM 与 CommonJS', '类型声明', '包入口', '构建工具', 'TypeScript'],
-  ai: 'AI',
-  aiItems: ['AI 文档', 'llms.txt'],
-  tools: '工具专题',
-  toolItems: ['概览', 'pnpm', 'Turborepo', 'pnpm Versioning', 'Husky', 'lint-staged', 'Renovate', 'llms.txt'],
-}
-
-function prefixed(prefix: string, section: string, paths: string[], labels: string[]) {
-  return paths.map((path, index) => ({
-    text: labels[index]!,
-    link: `${prefix}/${section}/${path}`.replace(/\/+/g, '/'),
-  }))
-}
-
-function createSidebars(prefix: '' | '/zh', labels: SidebarLabels) {
-  const repoctl = [{ text: labels.repoctl, items: prefixed(prefix, 'repoctl', repoctlPaths, labels.repoctlItems) }]
-  const knowledge = [
-    { text: labels.knowledge, items: prefixed(prefix, 'monorepo', knowledgePaths, labels.knowledgeItems) },
-    { text: labels.packages, items: prefixed(prefix, 'why', packagePaths, labels.packageItems) },
-  ]
-  const ai = [{ text: labels.ai, items: prefixed(prefix, 'ai', aiPaths, labels.aiItems) }]
-  const tools = [{ text: labels.tools, items: prefixed(prefix, 'tools', toolPaths, labels.toolItems) }]
-  return {
-    [`${prefix}/repoctl/`]: repoctl,
-    [`${prefix}/knowledge/`]: knowledge,
-    [`${prefix}/monorepo/`]: knowledge,
-    [`${prefix}/why/`]: knowledge,
-    [`${prefix}/ai/`]: ai,
-    [`${prefix}/tools/`]: tools,
-    [`${prefix || ''}/`]: repoctl,
-  }
-}
+import { createNav, createSidebars } from './navigation/routes'
+import { createPageHead, siteOrigin } from './seo'
 
 export default withMermaid(defineConfig({
   outDir: '.vitepress/dist',
@@ -109,6 +11,8 @@ export default withMermaid(defineConfig({
   description: 'Task-first CLI for initializing, maintaining, validating, and releasing pnpm and Turborepo monorepos.',
   lastUpdated: true,
   cleanUrls: true,
+  sitemap: { hostname: siteOrigin },
+  transformHead: createPageHead,
   head: [['link', { rel: 'icon', href: '/logo.jpg' }]],
   themeConfig: {
     logo: '/logo.jpg',
@@ -122,16 +26,9 @@ export default withMermaid(defineConfig({
       title: 'repoctl',
       description: 'Task-first CLI for practical pnpm and Turborepo monorepos.',
       themeConfig: {
-        nav: [
-          { text: 'repoctl', link: '/repoctl/' },
-          { text: 'Getting Started', link: '/repoctl/getting-started' },
-          { text: 'Commands', link: '/repoctl/commands' },
-          { text: 'Knowledge Base', link: '/knowledge/' },
-          { text: 'AI Docs', link: '/ai/' },
-          { text: 'Tool Guides', link: '/tools/' },
-        ],
+        nav: createNav('en'),
         outline: { label: 'On This Page', level: [2, 3] },
-        sidebar: createSidebars('', englishLabels),
+        sidebar: createSidebars('en'),
         editLink: {
           pattern: 'https://github.com/sonofmagic/repoctl/edit/main/templates/vitepress/:path',
           text: 'Edit this page',
@@ -147,16 +44,9 @@ export default withMermaid(defineConfig({
       title: 'repoctl',
       description: '面向 pnpm 与 Turborepo monorepo 的任务型 CLI。',
       themeConfig: {
-        nav: [
-          { text: 'repoctl', link: '/zh/repoctl/' },
-          { text: '快速开始', link: '/zh/repoctl/getting-started' },
-          { text: '命令', link: '/zh/repoctl/commands' },
-          { text: '知识库', link: '/zh/knowledge/' },
-          { text: 'AI 文档', link: '/zh/ai/' },
-          { text: '工具专题', link: '/zh/tools/' },
-        ],
+        nav: createNav('zh'),
         outline: { label: '目录', level: [2, 3] },
-        sidebar: createSidebars('/zh', chineseLabels),
+        sidebar: createSidebars('zh'),
         editLink: {
           pattern: 'https://github.com/sonofmagic/repoctl/edit/main/templates/vitepress/:path',
           text: '为此页提供修改建议',
@@ -173,7 +63,7 @@ export default withMermaid(defineConfig({
       llmstxt({
         title: 'repoctl',
         description: 'Task-first CLI for pnpm and Turborepo monorepos. Simplified Chinese documentation is available under /zh/.',
-        domain: 'https://repo.icebreaker.top',
+        domain: siteOrigin,
         ignoreFiles: [
           'zh/**',
           'en/**',

package/templates/vitepress/.vitepress/env.d.ts

@@ -0,0 +1 @@
+declare module '*.css'

package/templates/vitepress/.vitepress/home/content.ts

@@ -0,0 +1,186 @@
+import type { DocsLocale } from '../navigation/routes'
+import type { HomeContent } from './types'
+
+const english = {
+  hero: {
+    label: 'Task-first monorepo operations',
+    title: 'Run monorepo work.',
+    description: 'One CLI for setup, diagnosis, scaffolding, verification, and release work in pnpm monorepos.',
+    primary: { label: 'Get Started', href: '/repoctl/getting-started' },
+    secondary: { label: 'Explore Commands', href: '/repoctl/commands' },
+    imageAlt: 'A real repoctl doctor report for this workspace',
+  },
+  proof: ['pnpm-native', 'Turborepo-aware', 'Dry-run first', 'JSON and Markdown reports', 'Built for CI'],
+  lifecycle: {
+    title: 'A stable task lifecycle',
+    description: 'Each command answers one repository question and leaves a reportable result.',
+    steps: [
+      { title: 'Initialize', body: 'Install managed root assets and the standard repo scripts.', command: 'repo init' },
+      { title: 'Diagnose', body: 'Inspect workspace structure, tool versions, hooks, and release configuration.', command: 'repo doctor' },
+      { title: 'Create', body: 'Choose a known template and preview every planned file before writing.', command: 'repo new' },
+      { title: 'Verify', body: 'Route lint, typecheck, build, test, and tsd through one repeatable plan.', command: 'repo check' },
+      { title: 'Release', body: 'Record change intent, version fixed groups, publish, and complete hooks.', command: 'repo release' },
+    ],
+  },
+  paths: {
+    title: 'Start where your repository is',
+    description: 'repoctl supports greenfield workspaces and careful adoption without forcing the same migration path.',
+    items: [
+      {
+        title: 'Create a new workspace',
+        body: 'Bootstrap the managed conventions, then scaffold only the packages and applications you need.',
+        commands: ['pnpm create repoctl', 'pnpm run repo:new'],
+        href: '/repoctl/getting-started',
+        linkLabel: 'Create a repository',
+      },
+      {
+        title: 'Adopt an existing workspace',
+        body: 'Capture a redacted baseline, preview asset drift, and opt into changes in reviewable steps.',
+        commands: ['repo doctor --markdown --redact', 'repo upgrade --no-overwrite'],
+        href: '/repoctl/adopt-existing',
+        linkLabel: 'Plan an adoption',
+      },
+    ],
+  },
+  capabilities: {
+    title: 'Repository work with explicit boundaries',
+    description: 'The CLI keeps templates, managed assets, checks, and reports separate so automation stays understandable.',
+    items: [
+      { title: 'Managed assets', body: 'Compare standard root files before replacing local decisions.' },
+      { title: 'Template catalog', body: 'Create libraries, CLIs, services, clients, and docs from named templates.' },
+      { title: 'Verification planner', body: 'See the exact task graph in dry-run, JSON, or Markdown before execution.' },
+      { title: 'Environment reports', body: 'Share redacted support context without leaking repository paths or tokens.' },
+    ],
+  },
+  commands: {
+    title: 'A command map you can remember',
+    description: 'Daily commands stay short. Explicit modes are available when scripts need stable output.',
+    items: [
+      { command: 'repo init', purpose: 'Set up conventions' },
+      { command: 'repo doctor', purpose: 'Diagnose repository health' },
+      { command: 'repo templates', purpose: 'Inspect available templates' },
+      { command: 'repo new', purpose: 'Create a workspace project' },
+      { command: 'repo check', purpose: 'Plan or run verification' },
+      { command: 'repo env', purpose: 'Report runtime context' },
+      { command: 'repo upgrade', purpose: 'Reconcile managed assets' },
+      { command: 'repo release', purpose: 'Version and publish packages' },
+    ],
+  },
+  automation: {
+    title: 'Readable by people and automation',
+    description: 'Preview destructive work, write stable artifacts, and redact support output at the command boundary.',
+    formats: ['Terminal', 'JSON', 'Markdown', 'File output'],
+    code: 'repo check --full --dry-run --json --out reports/check-plan.json\nrepo env support --markdown --redact --out reports/support.md',
+  },
+  quickstart: {
+    title: 'Get to a useful diagnosis first',
+    description: 'Install repoctl locally, inspect the repository, then choose the next task from evidence.',
+    code: 'pnpm add -D repoctl\npnpm exec repo init\npnpm exec repo doctor\npnpm exec repo check --dry-run',
+    link: { label: 'Read the full setup guide', href: '/repoctl/getting-started' },
+  },
+  docs: {
+    title: 'Continue with the task in front of you',
+    description: 'The documentation is organized by repository outcome, with deeper references when you need implementation details.',
+    items: [
+      { label: 'Choose by scenario', href: '/repoctl/scenarios', body: 'Map a repository goal to the smallest command sequence.' },
+      { label: 'Execution model', href: '/repoctl/execution-model', body: 'Understand planning, writes, subprocesses, and output.' },
+      { label: 'Configuration', href: '/repoctl/config', body: 'Set defaults without hiding command-line overrides.' },
+      { label: 'Workflows and CI', href: '/repoctl/workflows', body: 'Build local and automated verification paths.' },
+      { label: 'Troubleshooting', href: '/repoctl/troubleshooting', body: 'Diagnose common setup, template, and release failures.' },
+      { label: 'AI documentation', href: '/ai/', body: 'Give coding tools concise or full Markdown context.' },
+    ],
+  },
+} satisfies HomeContent
+
+const chinese = {
+  hero: {
+    label: '面向任务的 monorepo 操作入口',
+    title: '运行 monorepo 工作。',
+    description: '用一套 CLI 完成 pnpm monorepo 的初始化、诊断、创建、校验与发布。',
+    primary: { label: '快速开始', href: '/zh/repoctl/getting-started' },
+    secondary: { label: '查看命令', href: '/zh/repoctl/commands' },
+    imageAlt: 'repoctl 对当前仓库生成的真实 doctor 报告',
+  },
+  proof: ['原生支持 pnpm', '理解 Turborepo', '优先 dry-run', 'JSON 与 Markdown 报告', '适用于 CI'],
+  lifecycle: {
+    title: '稳定的任务生命周期',
+    description: '每条命令回答一个仓库问题，并留下可以复查和保存的结果。',
+    steps: [
+      { title: '初始化', body: '安装受管根目录资产和标准 repo 脚本。', command: 'repo init' },
+      { title: '诊断', body: '检查 workspace 结构、工具版本、hooks 与发布配置。', command: 'repo doctor' },
+      { title: '创建', body: '选择已知模板，在写入前预览完整文件计划。', command: 'repo new' },
+      { title: '校验', body: '用一份可复现计划串联 lint、typecheck、build、test 与 tsd。', command: 'repo check' },
+      { title: '发布', body: '记录变更意图、更新固定版本组、发布并执行收尾 hook。', command: 'repo release' },
+    ],
+  },
+  paths: {
+    title: '从仓库当前状态开始',
+    description: 'repoctl 同时支持新建项目和渐进接入，不强迫两类仓库走同一条迁移路线。',
+    items: [
+      {
+        title: '创建新 workspace',
+        body: '先生成受管约定，再按需创建具体的包和应用。',
+        commands: ['pnpm create repoctl', 'pnpm run repo:new'],
+        href: '/zh/repoctl/getting-started',
+        linkLabel: '创建仓库',
+      },
+      {
+        title: '接入已有 workspace',
+        body: '保存脱敏基线，预览资产差异，再用可审查的小步骤逐项接入。',
+        commands: ['repo doctor --markdown --redact', 'repo upgrade --no-overwrite'],
+        href: '/zh/repoctl/adopt-existing',
+        linkLabel: '制定接入计划',
+      },
+    ],
+  },
+  capabilities: {
+    title: '边界清楚的仓库任务',
+    description: '模板、受管资产、校验与报告相互独立，让自动化保持透明。',
+    items: [
+      { title: '受管资产', body: '覆盖本地决策前，先比较标准根目录文件。' },
+      { title: '模板目录', body: '按名称创建类库、CLI、服务、客户端与文档站。' },
+      { title: '校验计划', body: '执行前通过 dry-run、JSON 或 Markdown 查看完整任务图。' },
+      { title: '环境报告', body: '隐藏仓库路径和 token 后再共享排障上下文。' },
+    ],
+  },
+  commands: {
+    title: '记得住的命令地图',
+    description: '日常入口保持简短，脚本需要稳定输出时再使用显式模式。',
+    items: [
+      { command: 'repo init', purpose: '建立仓库约定' },
+      { command: 'repo doctor', purpose: '诊断仓库健康状态' },
+      { command: 'repo templates', purpose: '查看可用模板' },
+      { command: 'repo new', purpose: '创建 workspace 项目' },
+      { command: 'repo check', purpose: '规划或执行校验' },
+      { command: 'repo env', purpose: '输出运行环境' },
+      { command: 'repo upgrade', purpose: '同步受管资产' },
+      { command: 'repo release', purpose: '更新版本并发布' },
+    ],
+  },
+  automation: {
+    title: '同时服务人和自动化',
+    description: '在命令边界预览写入、保存稳定产物，并对支持信息执行脱敏。',
+    formats: ['终端', 'JSON', 'Markdown', '文件输出'],
+    code: 'repo check --full --dry-run --json --out reports/check-plan.json\nrepo env support --markdown --redact --out reports/support.md',
+  },
+  quickstart: {
+    title: '先得到一份有效诊断',
+    description: '本地安装 repoctl，检查仓库，再根据证据选择下一项任务。',
+    code: 'pnpm add -D repoctl\npnpm exec repo init\npnpm exec repo doctor\npnpm exec repo check --dry-run',
+    link: { label: '阅读完整安装指南', href: '/zh/repoctl/getting-started' },
+  },
+  docs: {
+    title: '继续处理眼前的任务',
+    description: '文档按仓库目标组织，需要实现细节时再进入对应参考页。',
+    items: [
+      { label: '按场景选命令', href: '/zh/repoctl/scenarios', body: '把仓库目标映射为最短命令链路。' },
+      { label: '执行模型', href: '/zh/repoctl/execution-model', body: '理解计划、写入、子进程和输出。' },
+      { label: '配置文件', href: '/zh/repoctl/config', body: '设置默认值，同时保留命令行覆盖。' },
+      { label: '工作流与 CI', href: '/zh/repoctl/workflows', body: '建立本地和自动化校验路径。' },
+      { label: '排障', href: '/zh/repoctl/troubleshooting', body: '诊断常见的安装、模板与发布问题。' },
+      { label: 'AI 文档', href: '/zh/ai/', body: '为编程工具提供精简或完整 Markdown 上下文。' },
+    ],
+  },
+} satisfies HomeContent
+
+export const homeContent: Record<DocsLocale, HomeContent> = { en: english, zh: chinese }

package/templates/vitepress/.vitepress/home/types.ts

@@ -0,0 +1,65 @@
+export interface HomeLink {
+  label: string
+  href: string
+}
+
+export interface HomeStep {
+  title: string
+  body: string
+  command: string
+}
+
+export interface HomeContent {
+  hero: {
+    label: string
+    title: string
+    description: string
+    primary: HomeLink
+    secondary: HomeLink
+    imageAlt: string
+  }
+  proof: string[]
+  lifecycle: {
+    title: string
+    description: string
+    steps: HomeStep[]
+  }
+  paths: {
+    title: string
+    description: string
+    items: Array<{
+      title: string
+      body: string
+      commands: string[]
+      href: string
+      linkLabel: string
+    }>
+  }
+  capabilities: {
+    title: string
+    description: string
+    items: Array<{ title: string, body: string }>
+  }
+  commands: {
+    title: string
+    description: string
+    items: Array<{ command: string, purpose: string }>
+  }
+  automation: {
+    title: string
+    description: string
+    formats: string[]
+    code: string
+  }
+  quickstart: {
+    title: string
+    description: string
+    code: string
+    link: HomeLink
+  }
+  docs: {
+    title: string
+    description: string
+    items: Array<HomeLink & { body: string }>
+  }
+}