@icebreakers/monorepo-templates 1.1.0 → 1.2.1

package/README.md

@@ -1,20 +1,24 @@
 # @icebreakers/monorepo-templates
 
-Template assets and metadata used by `create-icebreaker` and `@icebreakers/monorepo`.
+English | [简体中文](README.zh-CN.md)
 
-This package ships:
+Built-in project templates and managed workspace assets for repoctl.
 
-- `templates/`: app and package templates
-- `assets/`: root workspace config files and upgrade assets for `monorepo`
-- template metadata helpers such as `getTemplateChoices()`, `getTemplateChoice()`, and `getTemplateDefinition()`
+This package is an implementation dependency of `repoctl` and `create-repoctl`. It publishes:
 
-## Template Discovery
+- app, service, library, documentation, and CLI templates;
+- managed root tooling and workflow assets;
+- template metadata and health-check helpers;
+- workspace and individual-template scaffold APIs.
 
 ```ts
-import { getTemplateChoices, getTemplateDefinition } from '@icebreakers/monorepo-templates'
+import {
+  getTemplateChoices,
+  getTemplateDefinition,
+} from '@icebreakers/monorepo-templates'
 
 const libraries = getTemplateChoices({ category: 'library' })
 const vitepress = getTemplateDefinition('vitepress')
 ```
 
-The returned metadata is a cloned snapshot, so callers can safely format it for CLI help, docs, or scaffold previews without mutating the package registry.
+The source workspaces under the repository's `templates/` directory are private. This package is their supported distribution boundary.

package/README.zh-CN.md

@@ -0,0 +1,16 @@
+# @icebreakers/monorepo-templates
+
+[English](README.md) | 简体中文
+
+repoctl 的内置项目模板和受管工作区资产包。
+
+本包是 `repoctl` 与 `create-repoctl` 的实现依赖，发布应用、服务、库、文档站与 CLI 模板，受管根配置和工作流资产，以及模板元数据、健康检查与 scaffold API。
+
+```ts
+import { getTemplateChoices, getTemplateDefinition } from '@icebreakers/monorepo-templates'
+
+const libraries = getTemplateChoices({ category: 'library' })
+const vitepress = getTemplateDefinition('vitepress')
+```
+
+仓库 `templates/` 下的源码工作区均为私有，本包是这些模板的正式分发边界。

package/assets/.github/ISSUE_TEMPLATE/config.yml

@@ -1,7 +1,7 @@
 blank_issues_enabled: false
 contact_links:
   - name: Feature Request
-    url: https://github.com/sonofmagic/monorepo-template/discussions
+    url: https://github.com/sonofmagic/repoctl/discussions
     about: Suggest new features for consideration
   # - name: Discord Chat
   #   url: https://chat.vuejs.org

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

@@ -49,12 +49,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@v7
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          fetch-depth: 0
 
-      - uses: pnpm/action-setup@v6
+      - uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda # v4.1.0
 
       - name: Setup Node.js environment
-        uses: actions/setup-node@v7
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
           node-version: 24
           cache: pnpm

package/assets/AGENTS.md

@@ -2,16 +2,17 @@
 
 ## Project Structure & Module Organization
 
-This pnpm + Turbo monorepo keeps template sources under `templates/` (`cli`, `client`, `server`, `vitepress`, `tsdown`, `vue-lib`) and reusable tooling under `packages/` (e.g., `monorepo`, `create-icebreaker`). Shared TypeScript and build settings live in root configs such as `turbo.json`, `tsconfig.json`, and `eslint.config.js`. Tests sit alongside their targets in `test/*.test.ts`, and each app owns its public assets (`public/`, `worker/`) to keep deployments self-contained.
+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`.
 
 ## Build, Test, and Development Commands
 
-- `pnpm install` — set up workspaces; ensure Node 20+ as defined in `package.json`.
+- `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 script:sync` & `pnpm script:clean` — use the monorepo helper to align dependency versions or clear generated artifacts.
+- `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.
 
 ## Coding Style & Naming Conventions
 

package/assets/CONTRIBUTING.md

@@ -1,3 +1,28 @@
-# Contributing
+# Contributing to repoctl
 
-TODO
+English | [简体中文](CONTRIBUTING.zh-CN.md)
+
+repoctl accepts bug fixes, documentation improvements, tests, and focused feature proposals.
+
+## Development setup
+
+1. Use Node.js 22.12+ and enable Corepack.
+2. Run `pnpm install`.
+3. Create a focused branch from `main`.
+4. Add or update tests with the implementation.
+
+Before opening a pull request, run:
+
+```bash
+pnpm build
+pnpm lint
+pnpm typecheck
+pnpm tsd
+pnpm test
+```
+
+Changes to publishable packages require a pnpm change intent created with `pnpm change`. Commits must use Conventional Commit syntax.
+
+When changing templates or managed root assets, update their source first and refresh packaged copies with `pnpm --filter @icebreakers/monorepo-templates sync:assets`.
+
+Report bugs at https://github.com/sonofmagic/repoctl/issues and use discussions for design questions that do not yet have a concrete implementation.

package/assets/SECURITY.md

@@ -1,21 +1,19 @@
 # Security Policy
 
-## Supported Versions
+English | [简体中文](SECURITY.zh-CN.md)
 
-Use this section to tell people about which versions of your project are
-currently being supported with security updates.
+## Supported versions
 
-| Version | Supported          |
-| ------- | ------------------ |
-| 5.1.x   | :white_check_mark: |
-| 5.0.x   | :x:                |
-| 4.0.x   | :white_check_mark: |
-| < 4.0   | :x:                |
+Security fixes are provided for the latest stable major release of `repoctl` and its fixed-version core package. Upgrade to the latest release before reporting a problem that may already be resolved.
 
-## Reporting a Vulnerability
+## Reporting a vulnerability
 
-Use this section to tell people how to report a vulnerability.
+Do not open a public issue for a suspected vulnerability. Use GitHub's private vulnerability reporting for `sonofmagic/repoctl`:
 
-Tell them where to go, how often they can expect to get an update on a
-reported vulnerability, what to expect if the vulnerability is accepted or
-declined, etc.
+https://github.com/sonofmagic/repoctl/security/advisories/new
+
+Include the affected version, environment, impact, reproduction steps, and any suggested mitigation. Maintainers will acknowledge a complete report as soon as practical and coordinate validation, remediation, and disclosure with the reporter.
+
+## Scope
+
+Reports involving repoctl command execution, generated workflow security, release credentials, dependency handling, path traversal, or unsafe template extraction are in scope. Vulnerabilities in third-party tools should also be reported upstream when appropriate.

package/assets/package.json

@@ -1,17 +1,26 @@
 {
-  "name": "monorepo-template",
+  "name": "repoctl-workspace",
   "type": "module",
   "version": "0.0.0",
   "private": true,
-  "packageManager": "pnpm@11.21.0",
+  "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",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sonofmagic/monorepo-template.git"
+    "url": "git+https://github.com/sonofmagic/repoctl.git"
   },
   "bugs": {
-    "url": "https://github.com/sonofmagic/monorepo-template/issues"
+    "url": "https://github.com/sonofmagic/repoctl/issues"
   },
+  "keywords": [
+    "repoctl",
+    "monorepo",
+    "pnpm",
+    "turborepo",
+    "typescript"
+  ],
   "engines": {
     "node": ">=22.12.0"
   },

package/assets/pnpm-workspace.yaml

@@ -2,20 +2,13 @@ packages:
   - apps/*
   - packages/*
   - templates/*
-  - '!**/test/**'
-
+  - "!**/test/**"
 minimumReleaseAge: 0
-
 versioning:
-  fixed:
-    - ['@icebreakers/monorepo', repoctl]
-  ignore:
-    - '@icebreakers/client'
   changelog:
     storage: repository
-
 allowBuilds:
-  '@tailwindcss/oxide': true
+  "@tailwindcss/oxide": true
   esbuild: true
   msgpackr-extract: true
   sharp: true

package/dist/cli.mjs

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

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

@@ -2,6 +2,7 @@ import * as path$1 from "node:path";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import fs from "node:fs/promises";
+import YAML from "yaml";
 //#region assets-data.mjs
 const coreAssetTargets = [
 	".changeset",
@@ -201,6 +202,14 @@ const sourceRepoReleaseToolingBuildStepPattern = /\r?\n\s+- name: Build Release
 function removeSourceRepoReleaseToolingBuildStepContent(content) {
 	return content.replaceAll(sourceRepoReleaseToolingBuildStepPattern, "\n");
 }
+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);
+}
 async function pathExists(targetPath) {
 	try {
 		await fs.access(targetPath);
@@ -286,6 +295,15 @@ async function writePublishedToolingConfigs() {
 		if (await pathExists(targetPath)) await fs.writeFile(targetPath, content);
 	}));
 }
+async function sanitizePublishedWorkspace() {
+	const workspacePath = path$1.join(assetsDir, "pnpm-workspace.yaml");
+	if (!await pathExists(workspacePath)) return;
+	const content = await fs.readFile(workspacePath, "utf8");
+	await fs.writeFile(workspacePath, sanitizePublishedWorkspaceContent(content), "utf8");
+}
+async function removePublishedReleaseState() {
+	await fs.rm(path$1.join(assetsDir, ".changeset", "ledger.yaml"), { force: true });
+}
 async function removeSourceRepoReleaseToolingBuildStep() {
 	const releaseWorkflowPath = path$1.join(assetsDir, ".github/workflows/release.yml");
 	if (!await pathExists(releaseWorkflowPath)) return;
@@ -310,6 +328,8 @@ async function prepareAssets(options = {}) {
 	await resetDir(assetsDir, overwriteExisting);
 	await resetDir(templatesDir, overwriteExisting);
 	await copyAssets(repoRoot, overwriteExisting);
+	await sanitizePublishedWorkspace();
+	await removePublishedReleaseState();
 	await writePublishedToolingConfigs();
 	await removeSourceRepoReleaseToolingBuildStep();
 	await copyTemplates(repoRoot, overwriteExisting);

package/package.json

@@ -1,19 +1,21 @@
 {
   "name": "@icebreakers/monorepo-templates",
   "type": "module",
-  "version": "1.1.0",
-  "description": "Template assets for icebreaker monorepo scaffolding",
+  "version": "1.2.1",
+  "description": "Built-in project templates and managed workspace assets for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
+  "homepage": "https://repo.icebreaker.top",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sonofmagic/monorepo-template.git",
+    "url": "git+https://github.com/sonofmagic/repoctl.git",
     "directory": "packages/monorepo-templates"
   },
   "bugs": {
-    "url": "https://github.com/sonofmagic/monorepo-template/issues"
+    "url": "https://github.com/sonofmagic/repoctl/issues"
   },
   "keywords": [
+    "repoctl",
     "monorepo",
     "template",
     "scaffold"
@@ -47,7 +49,8 @@
     "@inquirer/input": "^5.1.2",
     "@inquirer/select": "^5.2.1",
     "commander": "^15.0.0",
-    "nanoexec": "^1.1.0"
+    "nanoexec": "^1.1.0",
+    "yaml": "^2.9.0"
   },
   "publishConfig": {
     "access": "public"
@@ -55,6 +58,7 @@
   "scripts": {
     "dev": "tsdown --watch --sourcemap",
     "build": "tsdown",
+    "test": "vitest run",
     "typecheck": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json",
     "tsd": "pnpm build && tsd --files test-d/**/*.test-d.ts",
     "sync:assets": "pnpm run build && node dist/cli.mjs",

package/templates/cli/package.json

@@ -2,18 +2,25 @@
   "name": "@icebreakers/cli",
   "type": "module",
   "version": "0.0.0",
-  "description": "icebreaker's cli template",
+  "private": true,
+  "description": "Internal CLI template shipped with repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
+  "homepage": "https://repo.icebreaker.top",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sonofmagic/monorepo-template.git",
+    "url": "git+https://github.com/sonofmagic/repoctl.git",
     "directory": "templates/cli"
   },
   "bugs": {
-    "url": "https://github.com/sonofmagic/monorepo-template/issues"
+    "url": "https://github.com/sonofmagic/repoctl/issues"
   },
-  "keywords": [],
+  "keywords": [
+    "repoctl",
+    "cli",
+    "template",
+    "typescript"
+  ],
   "bin": {
     "ice": "./dev/index.ts"
   },

package/templates/client/package.json

@@ -3,6 +3,22 @@
   "type": "module",
   "version": "0.0.1",
   "private": true,
+  "description": "Internal Vue and Cloudflare application template shipped with repoctl",
+  "homepage": "https://repo.icebreaker.top",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sonofmagic/repoctl.git",
+    "directory": "templates/client"
+  },
+  "bugs": {
+    "url": "https://github.com/sonofmagic/repoctl/issues"
+  },
+  "keywords": [
+    "repoctl",
+    "vue",
+    "cloudflare",
+    "template"
+  ],
   "scripts": {
     "dev": "vite --host",
     "build": "vue-tsc -b && vite build",
@@ -45,7 +61,7 @@
     "vite": "^8.2.1",
     "vite-plugin-vue-devtools": "^8.2.1",
     "vite-tsconfig-paths": "^6.1.1",
-    "vue-tsc": "3.3.9",
+    "vue-tsc": "3.3.10",
     "wrangler": "^4.123.0",
     "zod": "^4.4.3"
   }

package/templates/server/package.json

@@ -2,18 +2,25 @@
   "name": "@icebreakers/server",
   "type": "module",
   "version": "0.0.1",
-  "description": "tsdown build package template",
+  "private": true,
+  "description": "Internal server package template shipped with repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
+  "homepage": "https://repo.icebreaker.top",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sonofmagic/monorepo-template.git",
+    "url": "git+https://github.com/sonofmagic/repoctl.git",
     "directory": "templates/server"
   },
   "bugs": {
-    "url": "https://github.com/sonofmagic/monorepo-template/issues"
+    "url": "https://github.com/sonofmagic/repoctl/issues"
   },
-  "keywords": [],
+  "keywords": [
+    "repoctl",
+    "server",
+    "hono",
+    "template"
+  ],
   "sideEffects": false,
   "exports": {
     ".": "./src/index.ts",

package/templates/tsdown/package.json

@@ -2,18 +2,25 @@
   "name": "@icebreakers/tsdown-template",
   "type": "module",
   "version": "0.0.0",
-  "description": "tsdown bundler template",
+  "private": true,
+  "description": "Internal TypeScript library template shipped with repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
+  "homepage": "https://repo.icebreaker.top",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sonofmagic/monorepo-template.git",
+    "url": "git+https://github.com/sonofmagic/repoctl.git",
     "directory": "templates/tsdown"
   },
   "bugs": {
-    "url": "https://github.com/sonofmagic/monorepo-template/issues"
+    "url": "https://github.com/sonofmagic/repoctl/issues"
   },
-  "keywords": [],
+  "keywords": [
+    "repoctl",
+    "typescript",
+    "library",
+    "template"
+  ],
   "sideEffects": false,
   "exports": {
     ".": {