@icebreakers/monorepo-templates 1.3.2 → 1.3.3

package/assets/.github/auto-changeset/github.mjs

@@ -0,0 +1,90 @@
+import { Buffer } from 'node:buffer'
+
+function repositoryParts(repository) {
+  const [owner, name] = repository.split('/')
+  if (!owner || !name) {
+    throw new Error(`Invalid GitHub repository: ${repository}`)
+  }
+  return { owner, name }
+}
+
+function encodePath(path) {
+  return path.split('/').map(segment => encodeURIComponent(segment)).join('/')
+}
+
+export function createGitHubClient({ token, repository, fetchImpl = fetch }) {
+  const { owner, name } = repositoryParts(repository)
+  const apiBase = `https://api.github.com/repos/${owner}/${name}`
+  async function request(path, options = {}) {
+    const response = await fetchImpl(`${apiBase}${path}`, {
+      ...options,
+      headers: {
+        'accept': 'application/vnd.github+json',
+        'authorization': `Bearer ${token}`,
+        'content-type': 'application/json',
+        'x-github-api-version': '2022-11-28',
+        ...(options.headers ?? {}),
+      },
+    })
+    const text = await response.text()
+    let body
+    try {
+      body = text ? JSON.parse(text) : undefined
+    }
+    catch {
+      body = text
+    }
+    if (!response.ok) {
+      throw new Error(`GitHub API ${response.status} ${options.method ?? 'GET'} ${path}: ${typeof body === 'string' ? body : body?.message ?? 'request failed'}`)
+    }
+    return body
+  }
+  return {
+    repository,
+    getPullRequest: number => request(`/pulls/${number}`),
+    getPullRequestFiles: async (number) => {
+      const files = []
+      for (let page = 1; ; page++) {
+        const pageFiles = await request(`/pulls/${number}/files?per_page=100&page=${page}`)
+        files.push(...pageFiles)
+        if (pageFiles.length < 100) {
+          return files
+        }
+      }
+    },
+    getContent: async (path, ref) => {
+      try {
+        const content = await request(`/contents/${encodePath(path)}?ref=${encodeURIComponent(ref)}`)
+        if (Array.isArray(content) || content.encoding !== 'base64') {
+          return undefined
+        }
+        return Buffer.from(content.content.replace(/\n/g, ''), 'base64').toString('utf8')
+      }
+      catch (error) {
+        if (String(error.message).startsWith('GitHub API 404')) {
+          return undefined
+        }
+        throw error
+      }
+    },
+    getRef: ref => request(`/git/ref/${encodePath(ref)}`),
+    getCommit: sha => request(`/git/commits/${sha}`),
+    createBlob: content => request('/git/blobs', { method: 'POST', body: JSON.stringify({ content, encoding: 'utf-8' }) }),
+    createTree: (baseTree, tree) => request('/git/trees', { method: 'POST', body: JSON.stringify({ base_tree: baseTree, tree }) }),
+    createCommit: (message, tree, parents) => request('/git/commits', { method: 'POST', body: JSON.stringify({ message, tree, parents }) }),
+    updateRef: (ref, sha) => request(`/git/refs/heads/${encodePath(ref)}`, { method: 'PATCH', body: JSON.stringify({ sha, force: false }) }),
+    createComment: (number, body) => request(`/issues/${number}/comments`, { method: 'POST', body: JSON.stringify({ body }) }),
+    listComments: async (number) => {
+      const comments = []
+      for (let page = 1; ; page++) {
+        const pageComments = await request(`/issues/${number}/comments?per_page=100&page=${page}`)
+        comments.push(...pageComments)
+        if (pageComments.length < 100) {
+          return comments
+        }
+      }
+    },
+    createBranch: async (branch, sha) => request('/git/refs', { method: 'POST', body: JSON.stringify({ ref: `refs/heads/${branch}`, sha }) }),
+    createPullRequest: input => request('/pulls', { method: 'POST', body: JSON.stringify(input) }),
+  }
+}

package/assets/.github/auto-changeset/index.mjs

@@ -0,0 +1,218 @@
+import fs from 'node:fs/promises'
+import process from 'node:process'
+import { createGitHubClient } from './github.mjs'
+
+const CHANGESET_MARKER = '<!-- repoctl-auto-changeset -->'
+const PACKAGE_PATH = /^packages\/([^/]+)\//
+const CHANGESET_PATH = /^\.changeset\/[^/]+\.md$/
+const RELEASE_BRANCH = /^(?:pnpm-release\/|release\/pnpm-version)/
+
+export function packageDirectories(files) {
+  return [...new Set(files
+    .map(file => file.filename ?? file)
+    .filter(filename => !/^packages\/[^/]+\/dist(?:\/|$)/.test(filename))
+    .map(filename => filename.match(PACKAGE_PATH)?.[1])
+    .filter(Boolean))]
+}
+
+export function releaseLevel(labels = []) {
+  const names = labels.map(label => typeof label === 'string' ? label : label.name)
+  if (names.includes('release:major')) {
+    return 'major'
+  }
+  if (names.includes('release:minor')) {
+    return 'minor'
+  }
+  return 'patch'
+}
+
+export function renderChangeset({ packages, level = 'patch', number, title }) {
+  const frontmatter = packages
+    .slice()
+    .sort((a, b) => a.localeCompare(b))
+    .map(name => `${/^[\w.-]+$/.test(name) ? name : JSON.stringify(name)}: ${level}`)
+    .join('\n')
+  const summary = title.replace(/\r?\n/g, ' ').replace(/\s+/g, ' ').trim()
+  return `---\n${frontmatter}\n---\n\n${summary} (#${number})\n`
+}
+
+export function changesetPath(number) {
+  return `.changeset/auto-pr-${number}.md`
+}
+
+export function isReleaseBranch(ref) {
+  return RELEASE_BRANCH.test(ref)
+}
+
+export function hasChangeset(files) {
+  return files.some(file => CHANGESET_PATH.test(file.filename ?? file))
+}
+
+function hasManualChangeset(files, generatedPath) {
+  return files.some((file) => {
+    const filename = file.filename ?? file
+    return CHANGESET_PATH.test(filename) && filename !== generatedPath
+  })
+}
+
+export function isPublishableManifest(manifest) {
+  return Boolean(manifest && typeof manifest.name === 'string' && manifest.private !== true)
+}
+
+async function manifestsForFiles(client, files, ref) {
+  const names = []
+  for (const directory of packageDirectories(files)) {
+    const content = await client.getContent(`packages/${directory}/package.json`, ref)
+    if (!content) {
+      continue
+    }
+    try {
+      const manifest = JSON.parse(content)
+      if (isPublishableManifest(manifest)) {
+        names.push(manifest.name)
+      }
+    }
+    catch {
+      // Ignore a malformed manifest; the normal CI checks will report it.
+    }
+  }
+  return [...new Set(names)]
+}
+
+async function commitChangesets(client, branch, baseSha, entries) {
+  const commit = await client.getCommit(baseSha)
+  const tree = []
+  for (const entry of entries) {
+    const blob = await client.createBlob(entry.content)
+    tree.push({ path: entry.path, mode: '100644', type: 'blob', sha: blob.sha })
+  }
+  const nextTree = await client.createTree(commit.tree.sha, tree)
+  const nextCommit = await client.createCommit('chore(release): add automated changesets', nextTree.sha, [baseSha])
+  await client.updateRef(branch, nextCommit.sha)
+  return nextCommit.sha
+}
+
+async function commentFork(client, number) {
+  const comments = await client.listComments(number)
+  if (comments.some(comment => comment.body?.includes(CHANGESET_MARKER))) {
+    return false
+  }
+  await client.createComment(number, `${CHANGESET_MARKER}\nThis PR changes a publishable package. Please add a .changeset/*.md release intent before merging. You can run pnpm change locally.`)
+  return true
+}
+
+async function prepareEntry(client, pullRequest, files) {
+  const path = changesetPath(pullRequest.number)
+  if (pullRequest.draft || isReleaseBranch(pullRequest.head.ref) || hasManualChangeset(files, path)) {
+    return undefined
+  }
+  const packages = await manifestsForFiles(client, files, pullRequest.head.sha)
+  if (!packages.length) {
+    return undefined
+  }
+  const level = releaseLevel(pullRequest.labels)
+  const content = renderChangeset({ packages, level, number: pullRequest.number, title: pullRequest.title })
+  const existing = await client.getContent(path, pullRequest.head.sha)
+  if (existing && !['patch', 'minor', 'major'].some(candidate => existing === renderChangeset({ packages, level: candidate, number: pullRequest.number, title: pullRequest.title }))) {
+    return undefined
+  }
+  if (existing === content) {
+    return undefined
+  }
+  return {
+    path,
+    content,
+  }
+}
+
+export async function processPullRequest(client, number) {
+  const pullRequest = await client.getPullRequest(number)
+  const files = await client.getPullRequestFiles(number)
+  const entry = await prepareEntry(client, pullRequest, files)
+  if (!entry) {
+    return { action: 'skipped', number }
+  }
+  const repository = pullRequest.base.repo.full_name
+  if (pullRequest.head.repo.full_name !== repository) {
+    await commentFork(client, number)
+    return { action: 'commented', number }
+  }
+  const ref = await client.getRef(`heads/${pullRequest.head.ref}`)
+  await commitChangesets(client, pullRequest.head.ref, ref.object.sha, [entry])
+  return { action: 'committed', number, path: entry.path }
+}
+
+export async function backfillPullRequests(client, numbers, { runId = `${Date.now()}` } = {}) {
+  const baseRef = await client.getRef('heads/main')
+  const entries = []
+  const seen = new Set()
+  const results = []
+  for (const number of numbers) {
+    const pullRequest = await client.getPullRequest(number)
+    if (!pullRequest.merged_at || pullRequest.base.ref !== 'main') {
+      results.push({ action: 'skipped', number })
+      continue
+    }
+    const files = await client.getPullRequestFiles(number)
+    const path = changesetPath(number)
+    if (hasChangeset(files) || seen.has(path) || await client.getContent(path, baseRef.object.sha)) {
+      results.push({ action: 'skipped', number })
+      continue
+    }
+    const packages = await manifestsForFiles(client, files, pullRequest.merge_commit_sha)
+    if (!packages.length) {
+      results.push({ action: 'skipped', number })
+      continue
+    }
+    seen.add(path)
+    entries.push({
+      path,
+      content: renderChangeset({ packages, level: releaseLevel(pullRequest.labels), number, title: pullRequest.title }),
+    })
+    results.push({ action: 'planned', number, path })
+  }
+  if (!entries.length) {
+    return { results, pullRequest: undefined }
+  }
+  const branch = `automation/changeset-backfill-${runId}`
+  await client.createBranch(branch, baseRef.object.sha)
+  await commitChangesets(client, branch, baseRef.object.sha, entries)
+  const created = await client.createPullRequest({
+    base: 'main',
+    head: branch,
+    title: `chore(release): backfill changesets (${numbers.map(number => `#${number}`).join(', ')})`,
+    body: `This PR backfills automated release intents for merged PRs.\n\n${entries.map(entry => `- ${entry.path}`).join('\n')}`,
+  })
+  return { results, pullRequest: created }
+}
+
+async function main() {
+  const eventPath = process.env.GITHUB_EVENT_PATH
+  const event = eventPath ? JSON.parse(await fs.readFile(eventPath, 'utf8')) : undefined
+  const repository = process.env.GITHUB_REPOSITORY ?? event?.repository?.full_name
+  const token = process.env.GITHUB_TOKEN
+  if (!repository || !token) {
+    throw new Error('GITHUB_REPOSITORY and GITHUB_TOKEN are required')
+  }
+  const client = createGitHubClient({ token, repository })
+  if (process.env.GITHUB_EVENT_NAME === 'workflow_dispatch') {
+    const numbers = (process.env.PR_NUMBERS ?? '').split(',').map(value => Number(value.trim())).filter(value => Number.isInteger(value) && value > 0)
+    if (!numbers.length) {
+      throw new Error('PR_NUMBERS must contain at least one PR number')
+    }
+    console.log(JSON.stringify(await backfillPullRequests(client, numbers, { runId: process.env.GITHUB_RUN_ID })))
+    return
+  }
+  const number = event?.pull_request?.number
+  if (!number) {
+    throw new Error('pull_request event payload is required')
+  }
+  console.log(JSON.stringify(await processPullRequest(client, number)))
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch((error) => {
+    console.error(error.stack ?? error)
+    process.exitCode = 1
+  })
+}

package/assets/.github/workflows/release-intent-auto.yml

@@ -0,0 +1,40 @@
+name: Automatic Release Intent
+
+on:
+  pull_request_target:
+    types: [opened, synchronize, reopened, ready_for_review, labeled, unlabeled]
+  workflow_dispatch:
+    inputs:
+      pr_numbers:
+        description: Comma-separated merged PR numbers to backfill
+        required: true
+        type: string
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  generate:
+    name: Generate release intent
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out workflow source
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 1
+
+      - name: Setup Node.js environment
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: 24
+
+      - name: Generate or backfill changesets
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+          PR_NUMBERS: ${{ inputs.pr_numbers }}
+        run: node .github/auto-changeset/index.mjs

package/assets/CONTRIBUTING.md

@@ -23,6 +23,10 @@ pnpm test
 
 Changes to publishable packages require a pnpm change intent created with `pnpm change`. Commits must use Conventional Commit syntax.
 
+Pull requests that change a publishable package receive an automatic `.changeset/auto-pr-<number>.md` intent when they come from a branch in this repository. The default bump is `patch`; add the `release:minor` or `release:major` label to override it. Fork pull requests cannot be written to by the workflow, so add the intent manually. Existing hand-written intents are always preserved.
+
+To backfill merged pull requests that predate this automation, run the `Automatic Release Intent` workflow manually with a comma-separated list of PR numbers. The workflow opens one backfill pull request, and the next `repo release ci` run consumes its changesets normally.
+
 The repository includes repoctl's CLI and monorepo engine, template assets, shared lint/config packages, and the `apps/mock` fixture demo. Keep package APIs and independent version lines intact when working across these areas.
 
 When changing templates or managed root assets, update their source first and refresh packaged copies with `pnpm --filter @icebreakers/monorepo-templates sync:assets`.

package/assets/package.json

@@ -90,7 +90,7 @@
     "@types/set-value": "^4.0.3",
     "@typescript-eslint/types": "^8.69.0",
     "@unocss/eslint-plugin": "66.9.2",
-    "@vitest/coverage-v8": "~4.1.11",
+    "@vitest/coverage-v8": "~5.0.0",
     "astro-eslint-parser": "^3.1.0",
     "ci-info": "^4.4.0",
     "cross-env": "^10.1.0",
@@ -112,7 +112,7 @@
     "micromatch": "^4.0.8",
     "only-allow": "^1.2.2",
     "pathe": "^2.0.3",
-    "pkg-types": "^2.3.1",
+    "pkg-types": "^2.3.2",
     "prettier": "^3.9.6",
     "prettier-plugin-astro": "^0.14.1",
     "repoctl": "workspace:*",
@@ -131,7 +131,7 @@
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "unbuild": "^3.6.1",
-    "vitest": "~4.1.11",
+    "vitest": "~5.0.0",
     "yaml": "^2.9.0"
   },
   "publishConfig": {

package/assets/pnpm-workspace.yaml

@@ -18,8 +18,8 @@ overrides:
   prettier: 3.9.6
   typescript: 6.0.3
   vite: 8.2.2
-  postcss: 8.5.26
-  postcss-selector-parser: 7.1.5
+  postcss: 8.5.28
+  postcss-selector-parser: 7.1.6
   js-yaml: 5.4.1
   nanoid: 6.0.1
   brace-expansion: 5.0.9

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/monorepo-templates",
   "type": "module",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "Built-in project templates and managed workspace assets for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
@@ -45,9 +45,9 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@inquirer/checkbox": "^5.2.3",
-    "@inquirer/input": "^5.1.4",
-    "@inquirer/select": "^5.2.3",
+    "@inquirer/checkbox": "^5.2.4",
+    "@inquirer/input": "^5.1.5",
+    "@inquirer/select": "^5.2.4",
     "commander": "^15.0.0",
     "nanoexec": "^1.1.0",
     "yaml": "^2.9.0"

package/templates/client/package.json

@@ -43,7 +43,7 @@
     "tailwind-variants": "^3.3.1",
     "vue": "^3.5.42",
     "vue-i18n": "^11.4.10",
-    "vue-router": "^5.3.0"
+    "vue-router": "^5.3.1"
   },
   "devDependencies": {
     "@cloudflare/vite-plugin": "^1.54.3",