@icebreakers/monorepo-templates 1.3.5 → 2.0.0

package/assets/.agents/skills/repoctl/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: repoctl
+description: Create and maintain pnpm/Turborepo workspaces with repoctl. Use when the user says 使用 repoctl 创建项目, create a monorepo, pnpm create repoctl, scaffold Vue/Hono/tsdown/vitepress, or run repo init/doctor/new/check.
+---
+
+# repoctl
+
+The package name is `repoctl`. The command is `repo`.
+
+## Empty directory
+
+Do not prompt. Map the request to template keys, then:
+
+```bash
+pnpm create repoctl <dir> -- --yes --templates <keys>
+cd <dir>
+pnpm install
+pnpm exec repo init
+pnpm exec repo doctor
+```
+
+`npm create` and `pnpm create` need the extra `--` before flags. `npx create-repoctl <dir> --yes --templates <keys>` does not.
+
+| User intent              | `--templates` key  |
+| ------------------------ | ------------------ |
+| Vue / full-stack web app | `vue-hono`         |
+| API / Hono service       | `hono-server`      |
+| TypeScript library / SDK | `tsdown`           |
+| Vue component library    | `vue-lib`          |
+| Documentation site       | `vitepress`        |
+| CLI                      | `cli`              |
+| Unspecified              | omit `--templates` |
+
+Then implement the requested feature in the generated workspace.
+
+## Existing repoctl workspace
+
+Look for `pnpm-workspace.yaml` and a `repoctl` / `repo` dependency.
+
+```bash
+pnpm exec repo templates
+pnpm exec repo new <name> --template <key>
+pnpm exec repo check
+```
+
+## Verify
+
+```bash
+pnpm exec repo doctor
+pnpm exec repo check
+```
+
+## Do not
+
+- Do not add packages by copying folders.
+- Do not hang on create prompts; pass `--yes`.
+- Do not create business apps inside the `sonofmagic/repoctl` source repository.
+
+## References
+
+- `references/templates.md` for template keys and `repo new` flags.
+- `references/commands.md` for other CLI commands.
+- `references/config.md` for `repoctl.config.ts`.

package/assets/.agents/skills/repoctl/references/commands.md

@@ -0,0 +1,243 @@
+# Commands
+
+## init
+
+Purpose: bootstrap workspace metadata plus recommended tooling defaults.
+Usage:
+
+- pnpm exec repo init
+  Options:
+- --preset <minimal|standard>: choose a lighter or fuller setup
+- --force: overwrite existing tooling config files
+  Notes:
+- `standard` is the default preset
+- `minimal` currently focuses on the base TypeScript setup
+
+## new
+
+Purpose: create a new package or app through an intent-driven flow.
+Usage:
+
+- npx repoctl new
+- npx repoctl new my-lib
+  Notes:
+- Prompts for what you want to create first, then maps to a template
+- `library` defaults to `packages/<name>`
+- `web-app`, `api-service`, `docs-site`, and `cli-tool` default to `apps/<name>`
+- Advanced users can still use `repoctl package create` or `repoctl pkg new`
+
+## check
+
+Purpose: run recommended local checks.
+Usage:
+
+- npx repoctl check
+- npx repoctl check --staged
+- npx repoctl check --full
+- npx repoctl check --dry-run
+- npx repoctl check --json --out reports/check-plan.json
+  Notes:
+- default mode runs the lightweight local verification flow
+- `--staged` adds staged typecheck routing
+- `--full` maps to the heavier pre-push verification flow
+- `--dry-run` previews the verification route without running checks
+- `--json` and `--out <file>` emit the same plan for automation and imply dry-run
+
+## doctor
+
+Purpose: diagnose whether the current workspace is ready to use.
+Usage:
+
+- npx repoctl doctor
+- npx repoctl doctor --json
+- npx repoctl doctor --json --out reports/doctor.json
+  Notes:
+- default output is human-readable
+- `--json` emits the structured report only and still exits non-zero when blocking failures exist
+- `--out <file>` persists the text or JSON report and still exits non-zero when blocking failures exist
+
+## upgrade
+
+Purpose: sync repo assets and scripts into the workspace.
+Usage:
+
+- npx repoctl upgrade
+- npx repoctl workspace upgrade
+- npx repoctl ws up
+  Options:
+- --interactive: prompt for overwrites
+- --core: sync core config only (skip GitHub assets)
+- --outDir <dir>: write to another directory
+- --skip-overwrite: never overwrite existing files
+- --overwrite-release: explicitly replace an unmarked custom release workflow
+
+For the first migration of an existing project, bootstrap with
+`pnpm dlx repoctl@latest upgrade --yes`. Managed and official legacy release
+workflows are migrated automatically; unmarked custom workflows are preserved
+unless `--overwrite-release` is supplied.
+
+## release ci
+
+Purpose: provide the single GitHub Actions entrypoint for stable and prerelease orchestration.
+Usage:
+
+- `pnpm exec repo release ci`
+- `pnpm exec repo release ci --mode prepare`
+- `pnpm exec repo release ci --mode publish`
+- `pnpm exec repo release ci --mode publish-unpublished --package <name> --version <version>`
+
+The command uses `GITHUB_TOKEN`, `GITHUB_REPOSITORY`, `GITHUB_API_URL`, and
+`GITHUB_SHA` to upsert the Release PR, package tags, and GitHub Releases. It
+consumes `pnpm-publish-summary.json` and is safe to retry.
+
+## workspace upgrade (alias: ws up)
+
+Purpose: sync monorepo assets and scripts into the workspace.
+Usage:
+
+- npx repoctl workspace upgrade
+- npx repoctl ws up
+  Options:
+- --interactive: prompt for overwrites
+- --core: sync core config only (skip GitHub assets)
+- --outDir <dir>: write to another directory
+- --skip-overwrite: never overwrite existing files
+
+## workspace init (alias: ws init)
+
+Purpose: initialize workspace metadata such as README, package.json, pnpm change intent support, and issue template.
+Usage:
+
+- pnpm exec repo init
+- npx repoctl workspace init
+- npx repoctl ws init
+
+## workspace list (alias: ws ls)
+
+Purpose: list workspace packages for inspection or automation.
+Usage:
+
+- npx repoctl workspace list
+- npx repoctl ws ls --json
+- npx repoctl ws ls --json --out reports/workspaces.json
+  Options:
+- --json: emit structured workspace summary data
+- --out <file>: persist the current text or JSON output
+- --include-private: include private packages
+- --include-root: include the workspace root package
+- --pattern <glob>: add custom workspace globs; repeatable
+
+## tooling init (alias: tg init)
+
+Purpose: generate tooling config files plus matching devDependencies.
+Usage:
+
+- npx repoctl tooling init
+- npx repoctl tooling init eslint tsconfig vitest
+- npx repoctl tg init --all
+  Options:
+- --all: generate every built-in tooling config
+- --force: overwrite existing tooling config files
+  Notes:
+- Built-in tooling targets: commitlint, eslint, stylelint, lint-staged, tsconfig, vitest
+- Generated files also update root package.json devDependencies
+
+## workspace clean (alias: ws clean)
+
+Purpose: remove selected packages and update the repo helper package version.
+Usage:
+
+- npx repoctl workspace clean
+- npx repoctl ws clean
+  Options:
+- --yes: auto confirm
+- --include-private
+- --pinned-version <version>
+
+## env info (alias: e i)
+
+Purpose: print environment details for debugging and automation.
+Usage:
+
+- npx repoctl env info
+- npx repoctl e i --json
+- npx repoctl env info --json --out reports/env.json
+  Options:
+- --json: emit structured environment info
+- --out <file>: persist the current text or JSON output
+  Notes:
+- Includes cwd, workspace root, package manager, Node version, pnpm version,
+  platform, arch, and workspace package count.
+
+## env snapshot (alias: e s)
+
+Purpose: collect a combined debugging snapshot for issues, CI artifacts, or editor integrations.
+Usage:
+
+- npx repoctl env snapshot
+- npx repoctl e s --json
+- npx repoctl env snapshot --json --out reports/snapshot.json
+  Options:
+- --json: emit structured snapshot data
+- --out <file>: persist the current text or JSON output
+  Notes:
+- Includes `env info`, `doctor` report data, and the default `check` plan.
+
+## env mirror (alias: e m)
+
+Purpose: set VSCode binary mirror env.
+Usage:
+
+- npx repoctl env mirror
+- npx repoctl e m
+
+## skills sync
+
+Purpose: sync the `repoctl` skill into global agent skill directories.
+Usage:
+
+- pnpm exec repo skills sync
+- pnpm exec repo skills sync --codex
+- pnpm exec repo skills sync --claude
+- pnpm exec repo skills sync --cursor
+- pnpm exec repo skills sync --agents
+- pnpm exec repo skills sync --grok
+- pnpm exec repo skills sync --all
+
+## ai prompt create (aliases: ai p create, ai p new)
+
+Purpose: generate agentic prompt templates.
+Usage:
+
+- npx repoctl ai prompt create
+- npx repoctl ai p new --name checkout
+- npx repoctl ai prompt create --tasks agentic/tasks.json --format md -f
+  Options:
+- --output <path>
+- --force
+- --format <md|json>
+- --dir <path>
+- --name <name>
+- --tasks <file>
+  Notes:
+- If no --output or --name is set, it prompts for a folder and writes to
+  agentic/prompts/<timestamp>/prompt.md.
+- If --tasks is used, it expects a JSON array of strings or objects.
+
+## package create (alias: pkg new)
+
+Purpose: create a new package from a template.
+Usage:
+
+- npx repoctl new
+- npx repoctl package create [path]
+- npx repoctl pkg new [path]
+  Notes:
+- Prefer `repoctl new` for the lower-cost guided flow.
+- Prompts for a template choice unless defaults are set in repoctl.config.ts or monorepo.config.ts.
+- Explicit `--template` values are validated before writing files. Unknown keys
+  fail with the closest suggestion instead of silently falling back.
+- Use `--json` to print the resolved create plan for automation. It implies
+  `--dry-run` and does not write files.
+- Add `--out <file>` to write the preview or JSON plan to disk. It also implies
+  `--dry-run`.

package/assets/.agents/skills/repoctl/references/config.md

@@ -0,0 +1,67 @@
+# repoctl.config.ts
+
+Preferred filename: `repoctl.config.ts`
+
+Compatible legacy filename: `monorepo.config.ts`
+
+Rule:
+
+- `repoctl.config.*` has higher priority
+- `monorepo.config.*` remains supported
+- if both exist at the same time, CLI loading fails fast with an error
+
+Use `defineMonorepoConfig` to set default options for CLI commands.
+Only include the fields you need.
+
+Example:
+
+```ts
+import { defineMonorepoConfig } from 'repoctl'
+
+export default defineMonorepoConfig({
+  commands: {
+    ai: {
+      baseDir: 'agentic/prompts',
+      format: 'md',
+      force: false,
+      tasksFile: 'agentic/tasks.json',
+    },
+    create: {
+      defaultTemplate: 'tsdown',
+      renameJson: false,
+      templatesDir: 'packages/monorepo/templates',
+    },
+    clean: {
+      autoConfirm: false,
+      ignorePackages: ['docs'],
+      includePrivate: true,
+      pinnedVersion: 'latest',
+    },
+    upgrade: {
+      skipOverwrite: false,
+      targets: ['.github', 'repoctl.config.ts'],
+      mergeTargets: true,
+    },
+    init: {
+      skipReadme: false,
+      skipPkgJson: false,
+      skipChangeset: false,
+      skipIssueTemplateConfig: false,
+    },
+    mirror: {
+      env: {
+        VSCode_CLI_MIRROR: 'https://example.invalid',
+      },
+    },
+  },
+})
+```
+
+Key areas:
+
+- ai: default output, format, batch tasks
+- create: default template and template directory
+- clean: auto confirm and pinned version control
+- upgrade: overwrite behavior and extra targets
+- init: skip steps for README/package.json/pnpm change intent setup
+- mirror: add or override env mirrors

package/assets/.agents/skills/repoctl/references/templates.md

@@ -0,0 +1,46 @@
+# Templates
+
+Prefer `repo new [name]` for the guided flow. For agents, pass `--template`
+explicitly so the command does not prompt.
+
+Intent defaults:
+
+- library -> `tsdown` -> `packages/<name>`
+- web-app -> `vue-hono` -> `apps/<name>`
+- api-service -> `hono-server` -> `apps/<name>`
+- docs-site -> `vitepress` -> `apps/<name>`
+- cli-tool -> `cli` -> `apps/<name>`
+
+Run `repo templates` to discover template keys, categories, default targets, and
+descriptions. Use `repo templates <key>` for a single template detail page, and
+`repo templates --json` when scripting. Use `repo templates --check` to verify
+template metadata, directories, package.json files, duplicate targets, and
+temporary files; combine it with `--json` for CI. Use `repo templates --markdown`
+or `repo templates <key> --markdown` when generating documentation snippets.
+Add `--out <file>` to write the selected output to disk.
+
+Use `repo new <name> --template <key> --dry-run` to preview the target directory
+and package metadata without writing files. Use `repo new <name> --template <key>
+--json` when a script needs the same create plan as structured data; `--json`
+implies `--dry-run`. Add `--out <file>` to write either preview format to disk.
+
+Explicit template keys are validated before any files are written. If a key is
+misspelled, the CLI fails and prints the closest known key when one is available.
+
+Advanced users can still use `repo package create [path]` or `repo pkg new [path]`
+to select templates directly.
+
+Built-in template map:
+
+- tsdown -> templates/tsdown => packages/tsdown
+- vue-lib -> templates/vue-lib => packages/vue-lib
+- hono-server -> templates/server => apps/server
+- vue-hono -> templates/client => apps/client
+- vitepress -> templates/vitepress => apps/website
+- cli -> templates/cli => apps/cli
+
+Notes:
+
+- The command prompts for template selection unless defaults are set in
+  repoctl.config.ts or monorepo.config.ts.
+- Override mappings with `commands.create.templateMap` and `commands.create.templatesDir`.

package/assets/AGENTS.md

@@ -1,53 +1,42 @@
-# Repository Guidelines
+# Agent instructions
 
-## Project Structure & Module Organization
+This workspace is managed by **repoctl**. The recommended command is `repo`.
+Use `repoctl` only when a longer executable name is clearer. Do not treat this
+repository as the repoctl source project.
 
-This repository is the source workspace for repoctl, a task-first CLI for pnpm and Turborepo monorepos. Product packages live under `packages/`: `repoctl` is the recommended entrypoint, `monorepo` contains the core engine, `monorepo-templates` distributes managed assets, and the create packages provide primary and compatibility bootstrap commands. Private template source workspaces live under `templates/`; they are product assets, not independently published packages. Shared TypeScript and build settings live in root configs such as `turbo.json`, `tsconfig.json`, and `eslint.config.js`.
+## Create packages and apps
 
-## Build, Test, and Development Commands
+```bash
+pnpm exec repo templates
+pnpm exec repo new <name> --template <key>
+```
 
-- `pnpm install` — set up workspaces; ensure Node 22.12+ as defined in `package.json`.
-- `pnpm dev` — run `turbo run dev --parallel` for all apps that expose a `dev` script.
-- `pnpm build` — execute `turbo run build` to build every workspace with caching.
-- `pnpm test` / `pnpm test:dev` — run Vitest suites once or in watch mode across packages.
-- `pnpm lint` — invoke `turbo run lint` to apply ESLint/Stylelint policies repo-wide.
-- `pnpm repo:doctor` — diagnose the source workspace with the same repoctl entrypoint delivered to users.
-- `pnpm --filter @icebreakers/monorepo-templates sync:assets` — refresh the managed assets and template copies from repository sources.
+| Intent                   | Template key  |
+| ------------------------ | ------------- |
+| Vue / full-stack web app | `vue-hono`    |
+| API / Hono service       | `hono-server` |
+| TypeScript library / SDK | `tsdown`      |
+| Vue component library    | `vue-lib`     |
+| Documentation site       | `vitepress`   |
+| CLI                      | `cli`         |
 
-## Coding Style & Naming Conventions
+Preview without writing files: `pnpm exec repo new <name> --template <key> --dry-run`.
 
-Follow the root `.editorconfig`: two-space indentation, LF line endings, UTF-8. Prefer TypeScript (`.ts`/`.tsx`) and Vue SFCs; name files with kebab-case (`user-table.vue`) and exported symbols with PascalCase for components or camelCase for utilities. ESLint (`@icebreakers/eslint-config`) and Stylelint enforce formatting; run `pnpm lint` before committing, and rely on Husky + lint-staged to auto-fix staged files. Any style-related code changes (CSS, SCSS, Less, Vue style blocks, and similar files) must pass Stylelint checks before commit. All changed JavaScript, TypeScript, and Vue code must pass ESLint checks before commit.
+## Verify
 
-`lint-staged.config.js` must include Stylelint checks for staged style files so style validation also runs during pre-commit. It must also route staged TypeScript and Vue files into workspace `typecheck` scripts so Vue workspaces run `vue-tsc` and non-Vue TypeScript workspaces run `tsc`.
+```bash
+pnpm exec repo doctor
+pnpm exec repo check
+```
 
-When a single code file exceeds 300 lines, treat it as a refactor signal and split it into smaller modules before commit whenever the change touches that area. Do not keep appending responsibilities to an already large file when a folder-based split would make the design clearer.
+## Do not
 
-When splitting code, do not create suffix-based sibling files such as `xxx.config.ts` or `xxx.filter.ts` just to move logic around. Create a dedicated folder (for example `xxx/`) and place the split modules inside it with clear responsibilities.
+- Do not add packages by copying folders. Use `repo new`.
+- Do not hand-edit managed root configs that `repo init` / `repo upgrade` own.
+- Do not invent publish versions by hand. Use `pnpm change` for publishable packages.
 
-All generated code must pass ESLint checks, and all generated style files must pass Stylelint checks.
-Generated Vue files or other SFC files that include style blocks are also required to pass Stylelint checks.
+## Requirements
 
-## Testing Guidelines
-
-Vitest powers unit tests located in `test/*.test.ts`. Mirror existing naming by matching the unit under test (`monorepo` utilities map to `packages/monorepo/test/*.test.ts`). Aim for meaningful assertions rather than snapshot defaults, and add coverage checks with `pnpm test -- --coverage`, which writes reports to `coverage/`. When introducing new public APIs, include integration-style tests in the relevant app workspace. AI-assisted validation must run a full test matrix when available, including unit, integration, and E2E tests.
-
-Before running tests, build the packages first and run tests against build artifacts instead of source-only execution to better match real delivery behavior.
-
-TypeScript issues must be fixed before commit. Do not commit with unresolved TypeScript compile or type-check errors.
-
-TypeScript code must be validated with the relevant workspace `typecheck` script and must not contain type errors. Pure TypeScript workspaces are expected to validate with `tsc` (`pnpm typecheck` or `tsc -p tsconfig.json`). Vue workspaces are expected to validate with `vue-tsc` (typically `vue-tsc -b`).
-
-When building TypeScript libraries (type-focused APIs or public type definitions), add and maintain `tsd` type tests to verify exported type behavior.
-
-## Commit & Pull Request Guidelines
-
-Commits must conform to Conventional Commit syntax; recent history uses prefixes like `feat`, `fix`, and `chore`. Example: `feat(server): add auth router`. Use `pnpm commit` (commitlint prompt) or ensure your manual message passes `pnpm commitlint --edit`. Before opening a PR, make sure `pnpm lint` and `pnpm test` succeed, link related issues, and provide screenshots or logs for user-facing changes. Touching publishable packages requires a pnpm change intent (`pnpm change`) so releases stay traceable.
-
-For AI-generated or AI-assisted changes, use this verification order before commit or PR:
-
-1. Run build first (`pnpm build` or the relevant workspace build command).
-2. Run lint checks, ensuring all changed JavaScript, TypeScript, and Vue code passes ESLint and all style-related code passes Stylelint.
-3. Run TypeScript checks and fix all type errors before proceeding. Vue workspaces must pass `vue-tsc`; TypeScript workspaces must pass `tsc`.
-4. For TypeScript libraries, run `tsd` type tests and fix all failures before proceeding.
-5. Run tests against built artifacts, including unit, integration, and E2E suites (when available in the affected workspace).
-6. Before commit, review whether the touched files need splitting or refactoring; do not commit avoidable large-file growth when a clearer module boundary is apparent.
+- Node.js 22.13 or newer
+- pnpm
+- CLI output is English by default; `--lang zh-CN` or `REPOCTL_LANG=zh-CN` selects Simplified Chinese

package/assets/CLAUDE.md

@@ -0,0 +1,14 @@
+# Agent instructions
+
+This workspace is managed by **repoctl**. The recommended command is `repo`.
+
+Follow `AGENTS.md` in the workspace root. Create packages with
+`pnpm exec repo new <name> --template <key>`. Verify with
+`pnpm exec repo doctor` and `pnpm exec repo check`.
+
+If you were asked to create a new business project, do not add it inside an
+existing unrelated repository. Use:
+
+```bash
+pnpm create repoctl <dir> -- --yes --templates <keys>
+```

package/assets/package.json

@@ -6,6 +6,7 @@
   "packageManager": "pnpm@12.3.4",
   "description": "Source workspace for repoctl and Icebreaker's shared development packages",
   "author": "ice breaker <hi@sonofmagic.top>",
+  "license": "MIT",
   "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
@@ -71,66 +72,25 @@
   },
   "devDependencies": {
     "@commitlint/cli": "^21.2.2",
-    "@eslint/config-inspector": "^3.4.0",
-    "@eslint/eslintrc": "^3.3.7",
+    "@eslint/config-inspector": "^3.4.1",
     "@icebreakers/commitlint-config": "workspace:*",
     "@icebreakers/eslint-config": "workspace:*",
     "@icebreakers/monorepo": "workspace:*",
     "@icebreakers/stylelint-config": "workspace:*",
-    "@next/eslint-plugin-next": "^16.3.4",
-    "@prettier/plugin-xml": "^3.4.2",
-    "@tanstack/eslint-plugin-query": "^5.102.8",
-    "@types/eslint-plugin-tailwindcss": "^3.17.0",
-    "@types/fs-extra": "^11.0.4",
-    "@types/lodash": "^4.17.25",
-    "@types/lodash-es": "^4.17.12",
-    "@types/micromatch": "^4.0.10",
-    "@types/node": "^26.5.0",
-    "@types/semver": "^7.8.0",
-    "@types/set-value": "^4.0.3",
-    "@typescript-eslint/types": "^8.70.0",
-    "@unocss/eslint-plugin": "66.10.0",
+    "@types/node": "^26.5.1",
     "@vitest/coverage-v8": "~5.0.0",
-    "astro-eslint-parser": "^3.1.0",
-    "ci-info": "^4.4.0",
-    "cross-env": "^10.1.0",
-    "defu": "^6.1.7",
-    "es-toolkit": "^1.52.0",
     "eslint": "^10.10.0",
-    "eslint-plugin-astro": "^3.1.0",
-    "eslint-plugin-mdx": "3.8.1",
-    "eslint-plugin-svelte": "^3.23.0",
     "execa": "^10.0.1",
-    "fast-glob": "^3.3.3",
-    "fs-extra": "^11.4.0",
-    "get-value": "^4.1.0",
     "husky": "^9.1.7",
-    "jiti": "^2.7.0",
-    "lint-staged": "^17.5.0",
-    "lodash": "^4.18.1",
-    "lodash-es": "^4.18.1",
-    "micromatch": "^4.0.8",
+    "lint-staged": "^17.5.1",
     "only-allow": "^1.2.2",
-    "pathe": "^2.0.3",
-    "pkg-types": "^2.3.3",
-    "prettier": "^3.9.6",
-    "prettier-plugin-astro": "^0.14.1",
     "repoctl": "workspace:*",
-    "rimraf": "^6.1.3",
-    "set-value": "^4.1.0",
     "stylelint": "^17.15.0",
-    "svelte": "^5.57.0",
-    "svelte-eslint-parser": "^1.8.1",
     "tailwindcss": "^4.3.3",
     "tsd": "^0.33.0",
     "tsdown": "0.23.0",
-    "tslib": "^2.8.1",
-    "tsup": "^8.5.1",
-    "tsx": "^4.23.13",
     "turbo": "^2.10.12",
-    "type-fest": "^5.9.0",
     "typescript": "^6.0.3",
-    "unbuild": "^3.6.1",
     "vitest": "~5.0.0",
     "yaml": "^2.9.0"
   },

package/assets/pnpm-workspace.yaml

@@ -17,7 +17,7 @@ allowBuilds:
 overrides:
   prettier: 3.9.6
   typescript: 6.0.3
-  vite: 8.2.2
+  vite: 8.3.0
   postcss: 8.5.28
   postcss-selector-parser: 7.1.6
   js-yaml: 5.4.1

package/assets-data.mjs

@@ -13,6 +13,8 @@ const coreAssetTargets = [
   'repoctl.config.ts',
   'package.json',
   'AGENTS.md',
+  'CLAUDE.md',
+  '.agents',
   // pnpm
   'pnpm-workspace.yaml',
   // base tsconfig

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { t as prepareAssets } from "./prepare-DlR-vvls.mjs";
+import { t as prepareAssets } from "./prepare-zIcRa4-K.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-DlR-vvls.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-zIcRa4-K.mjs";
 import path from "node:path";
 import fs, { access, open, rm } from "node:fs/promises";
 import exec from "nanoexec";

package/dist/{prepare-DlR-vvls.mjs → prepare-zIcRa4-K.mjs}

@@ -19,6 +19,8 @@ const coreAssetTargets = [
 	"repoctl.config.ts",
 	"package.json",
 	"AGENTS.md",
+	"CLAUDE.md",
+	".agents",
 	"pnpm-workspace.yaml",
 	"tsconfig.json",
 	"turbo.json",
@@ -204,11 +206,23 @@ function removeSourceRepoReleaseToolingBuildStepContent(content) {
 }
 function sanitizePublishedWorkspaceContent(content) {
 	const workspace = YAML.parse(content);
-	if (!workspace?.versioning || typeof workspace.versioning !== "object") return content;
-	delete workspace.versioning["fixed"];
-	delete workspace.versioning["ignore"];
-	delete workspace.versioning["lanes"];
-	return YAML.stringify(workspace);
+	if (!workspace || typeof workspace !== "object") return content;
+	let changed = false;
+	if (workspace.versioning && typeof workspace.versioning === "object") {
+		delete workspace.versioning["fixed"];
+		delete workspace.versioning["ignore"];
+		delete workspace.versioning["lanes"];
+		changed = true;
+	}
+	if ("catalog" in workspace) {
+		delete workspace.catalog;
+		changed = true;
+	}
+	if ("catalogs" in workspace) {
+		delete workspace.catalogs;
+		changed = true;
+	}
+	return changed ? YAML.stringify(workspace) : content;
 }
 async function pathExists(targetPath) {
 	try {
@@ -272,12 +286,13 @@ async function copyEntry(from, to, overwriteExisting, filter) {
 		throw error;
 	}
 }
+const publishedAgentSourceFiles = /* @__PURE__ */ new Set(["AGENTS.md", "CLAUDE.md"]);
 async function copyAssets(repoRoot, overwriteExisting) {
 	const monorepoAssetRoot = path$1.resolve(repoRoot, "packages/monorepo/assets");
 	for (const target of assetTargets) {
 		const packageAsset = path$1.join(monorepoAssetRoot, toPublishGitignorePath(target));
 		const repoAsset = path$1.join(repoRoot, target);
-		const from = await pathExists(repoAsset) ? repoAsset : packageAsset;
+		const from = publishedAgentSourceFiles.has(target) || !await pathExists(repoAsset) ? packageAsset : repoAsset;
 		if (!await pathExists(from)) continue;
 		const to = path$1.join(assetsDir, toPublishGitignorePath(target));
 		const stats = await fs.stat(from);
@@ -295,6 +310,11 @@ async function writePublishedToolingConfigs() {
 		if (await pathExists(targetPath)) await fs.writeFile(targetPath, content);
 	}));
 }
+async function writePublishedAgentSkill(repoRoot, overwriteExisting) {
+	const skillFrom = path$1.join(repoRoot, "packages/monorepo/resources/skills/repoctl");
+	if (!await pathExists(skillFrom)) return;
+	await copyEntry(skillFrom, path$1.join(assetsDir, ".agents", "skills", "repoctl"), overwriteExisting);
+}
 async function sanitizePublishedWorkspace() {
 	const workspacePath = path$1.join(assetsDir, "pnpm-workspace.yaml");
 	if (!await pathExists(workspacePath)) return;
@@ -344,6 +364,7 @@ async function prepareAssets(options = {}) {
 	await sanitizePublishedWorkspace();
 	await removePublishedReleaseState();
 	await writePublishedToolingConfigs();
+	await writePublishedAgentSkill(repoRoot, overwriteExisting);
 	await removeSourceRepoReleaseToolingBuildStep();
 	await removeSourceRepoWorkerTypeChecks();
 	await copyTemplates(repoRoot, overwriteExisting);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/monorepo-templates",
   "type": "module",
-  "version": "1.3.5",
+  "version": "2.0.0",
   "description": "Built-in project templates and managed workspace assets for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
@@ -35,6 +35,7 @@
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "files": [
+    "README.md",
     "assets",
     "assets-data.mjs",
     "dist",
@@ -42,7 +43,7 @@
     "templates"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.13.0"
   },
   "dependencies": {
     "@inquirer/checkbox": "^5.2.5",
@@ -53,7 +54,8 @@
     "yaml": "^2.9.0"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "scripts": {
     "dev": "tsdown --watch --sourcemap",

package/templates/cli/dev/index.ts

@@ -1,2 +1,4 @@
-#!/usr/bin/env -S npx tsx
-import '../src/cli.ts'
+#!/usr/bin/env -S node --experimental-strip-types
+import { runCli } from '../src/index.ts'
+
+runCli()

package/templates/cli/package.json

@@ -24,8 +24,11 @@
   "bin": {
     "ice": "./dev/index.ts"
   },
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
-    "start": "tsx src/index.ts",
+    "start": "node --experimental-strip-types src/index.ts",
     "dev": "tsdown --watch --sourcemap",
     "build": "tsdown",
     "lint": "eslint .",

package/templates/client/package.json

@@ -4,6 +4,8 @@
   "version": "0.0.1",
   "private": true,
   "description": "Internal Vue and Cloudflare application template shipped with repoctl",
+  "author": "ice breaker <hi@sonofmagic.top>",
+  "license": "MIT",
   "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
@@ -19,6 +21,9 @@
     "cloudflare",
     "template"
   ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "dev": "pnpm cf-typegen && vite --host",
     "build": "pnpm cf-typegen && vue-tsc -b && vite build",
@@ -35,7 +40,7 @@
     "@tanstack/vue-query": "^5.102.8",
     "@tanstack/vue-query-devtools": "^6.1.48",
     "@tanstack/vue-table": "^9.2.4",
-    "@tanstack/vue-virtual": "^3.13.37",
+    "@tanstack/vue-virtual": "^3.13.38",
     "@trpc/client": "^11.18.0",
     "clsx": "^2.1.1",
     "pinia": "^4.0.3",
@@ -46,7 +51,7 @@
     "vue-router": "^5.3.1"
   },
   "devDependencies": {
-    "@cloudflare/vite-plugin": "^1.54.5",
+    "@cloudflare/vite-plugin": "^1.54.8",
     "@hono/node-server": "^2.1.1",
     "@hono/trpc-server": "^0.4.2",
     "@tailwindcss/vite": "^4.3.3",
@@ -58,11 +63,11 @@
     "hono": "^4.13.7",
     "tailwindcss": "^4.3.3",
     "typescript": "~6.0.3",
-    "vite": "^8.2.2",
+    "vite": "^8.3.0",
     "vite-plugin-vue-devtools": "^8.2.1",
     "vite-tsconfig-paths": "^6.1.1",
     "vue-tsc": "3.3.11",
-    "wrangler": "^4.129.1",
-    "zod": "^4.5.4"
+    "wrangler": "^4.131.1",
+    "zod": "^4.6.2"
   }
 }

package/templates/server/package.json

@@ -30,13 +30,16 @@
   "files": [
     "dist"
   ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "dev": "pnpm cf-typegen && wrangler dev",
     "build": "pnpm cf-typegen && tsdown",
     "build:watch": "tsdown --watch --sourcemap",
     "node:build:watch": "pnpm build:watch",
     "node:build": "pnpm build",
-    "node:dev": "tsx watch src/node-entry.ts",
+    "node:dev": "node --watch --experimental-strip-types src/node-entry.ts",
     "node:start": "node dist/node-entry.mjs",
     "test": "vitest run",
     "test:dev": "vitest",
@@ -65,7 +68,7 @@
     "consola": "^3.4.2",
     "hono": "^4.13.7",
     "tsdown": "0.23.0",
-    "wrangler": "^4.129.1",
-    "zod": "^4.5.4"
+    "wrangler": "^4.131.1",
+    "zod": "^4.6.2"
   }
 }

package/templates/server/src/node-entry.ts

@@ -1,8 +1,8 @@
 import { serve } from '@hono/node-server'
 import { consola } from 'consola'
 import { logger } from 'hono/logger'
-import { app } from './app'
-import { port } from './config'
+import { app } from './app.ts'
+import { port } from './config.ts'
 
 app.use(logger())
 serve({

package/templates/server/tsconfig.json

@@ -12,7 +12,8 @@
     "types": [
       "node",
       "vitest/globals"
-    ]
+    ],
+    "allowImportingTsExtensions": true
   },
   "include": [
     "src",

package/templates/tsdown/package.json

@@ -41,6 +41,10 @@
   "files": [
     "dist"
   ],
+  "publishConfig": {},
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "dev": "tsdown -w",
     "build": "tsdown",
@@ -51,6 +55,5 @@
     "lint:fix": "eslint . --fix",
     "typecheck": "tsc -p tsconfig.json",
     "tsd": "pnpm build && tsd --files test-d/**/*.test-d.ts"
-  },
-  "publishConfig": {}
+  }
 }

package/templates/vitepress/ai/create.md

@@ -0,0 +1,45 @@
+---
+description: Non-interactive recipe for AI agents to create a repoctl workspace with pnpm create repoctl --yes.
+outline: deep
+---
+
+# Create a project with repoctl (AI)
+
+Use this page when an agent is asked to create a new project with repoctl.
+
+## Empty directory
+
+Do not prompt. Run:
+
+```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>` and
+`npx create-repoctl <dir> --yes --templates <keys>` are equivalent.
+`pnpm create` and `npm create` need the extra `--` before flags.
+
+## Template keys
+
+| User intent              | `--templates` / `repo new --template` |
+| ------------------------ | ------------------------------------- |
+| Vue / full-stack web app | `vue-hono`                            |
+| API / Hono service       | `hono-server`                         |
+| TypeScript library / SDK | `tsdown`                              |
+| Vue component library    | `vue-lib`                             |
+| Documentation site       | `vitepress`                           |
+| CLI                      | `cli`                                 |
+
+Omit `--templates` when the intent is unclear. After init, create a package with:
+
+```bash
+pnpm exec repo new <name> --template <key>
+```
+
+## Existing workspace
+
+If `pnpm-workspace.yaml` and a `repoctl` dependency already exist, do not run create. Use `repo new` instead, then `pnpm exec repo check`.

package/templates/vitepress/ai/index.md

@@ -11,6 +11,7 @@ repoctl publishes AI-readable documentation alongside the human site.
 - `/llms.txt`: compact English index and product summary.
 - `/llms-full.txt`: combined page content when a larger context is appropriate.
 - `/zh/`: Simplified Chinese documentation.
+- [Create a project](./create.md): non-interactive `pnpm create repoctl --yes` recipe.
 - [llms.txt Guide](./llms-txt.md): usage and maintenance rules.
 
 ## Using It In AI Tools

package/templates/vitepress/package.json

@@ -5,6 +5,7 @@
   "private": true,
   "description": "Documentation website for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
+  "license": "MIT",
   "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
@@ -20,9 +21,12 @@
     "vitepress",
     "monorepo"
   ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "dev": "vitepress dev",
-    "check:locales": "tsx scripts/check-locales.ts",
+    "check:locales": "node --experimental-strip-types scripts/check-locales.ts",
     "build": "pnpm run check:locales && vitepress build",
     "preview": "vitepress preview",
     "deploy": "wrangler deploy",
@@ -42,13 +46,12 @@
     "cytoscape-cose-bilkent": "^4.1.0",
     "dayjs": "^1.11.23",
     "debug": "^4.4.3",
-    "mermaid": "^11.17.2",
+    "mermaid": "^12.0.0",
     "tailwindcss": "^4.3.3",
-    "tsx": "^4.23.13",
     "vitepress": "^1.6.4",
-    "vitepress-plugin-llms": "^1.13.5",
+    "vitepress-plugin-llms": "^1.14.0",
     "vitepress-plugin-mermaid": "^2.0.17",
     "vue-tsc": "^3.3.11",
-    "wrangler": "^4.129.1"
+    "wrangler": "^4.131.1"
   }
 }

package/templates/vitepress/scripts/check-locales.ts

@@ -2,8 +2,8 @@ import type { DocsLocale } from '../.vitepress/navigation/routes'
 import { readdir, readFile, stat } from 'node:fs/promises'
 import path from 'node:path'
 import process from 'node:process'
-import { homeContent } from '../.vitepress/home/content'
-import { routePath, routeSections } from '../.vitepress/navigation/routes'
+import { homeContent } from '../.vitepress/home/content.ts'
+import { routePath, routeSections } from '../.vitepress/navigation/routes.ts'
 
 const root = process.cwd()
 const ignoredDirectories = new Set(['.vitepress', 'node_modules'])

package/templates/vitepress/start/index.md

@@ -23,4 +23,4 @@ The CLI works with pnpm workspaces and understands Turborepo task graphs. It doe
 
 ## Before you continue
 
-You need Node.js 22.12 or newer and pnpm available on your path. Run commands from the repository root so repoctl can read the workspace configuration.
+You need Node.js 22.13 or newer and pnpm available on your path. Run commands from the repository root so repoctl can read the workspace configuration.

package/templates/vitepress/start/install.md

@@ -4,7 +4,7 @@ This guide follows the order you would use when adding repoctl to a workspace.
 
 ## Prerequisites
 
-- Node.js 20 or newer.
+- Node.js 22.13 or newer.
 - pnpm. Corepack is recommended: `corepack enable`.
 - Git. `repo doctor` reads repository metadata and checks the commit workflow.
 

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

@@ -8,7 +8,7 @@ Use this task when a workspace already has scripts, hooks, or configuration that
 
 - Run commands from the workspace root.
 - Commit or stash unrelated local changes.
-- Confirm that Node.js 22.12 or newer and pnpm are available.
+- Confirm that Node.js 22.13 or newer and pnpm are available.
 
 ## Smallest Command
 

package/templates/vitepress/tsconfig.json

@@ -4,6 +4,7 @@
     "module": "ESNext",
     "moduleResolution": "Bundler",
     "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
     "strict": true,
     "noEmit": true,
     "skipLibCheck": true

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/start/index.md

@@ -23,4 +23,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.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/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",
@@ -60,7 +63,7 @@
     "@vue/test-utils": "^2.5.0",
     "@vue/tsconfig": "^0.9.1",
     "jsdom": "^30.0.1",
-    "vite": "^8.2.2",
+    "vite": "^8.3.0",
     "vite-plugin-dts": "^5.1.0",
     "vue": "^3.5.42",
     "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: {