ci: add scope dropdown (monorepo, cli, angular) to release workflows

Each release scope has its own packages, version source, and
independent version track:
- monorepo: 12 core @copilotkit/* packages (shared version)
- cli: copilotkit CLI (independent version)
- angular: @copilotkitnext/angular (independent version)

Branch pattern is now release/publish/<scope>/v<version> and git
tags use <scope>/v<version> for non-monorepo scopes.

Author: tylerslaton

.github/workflows/prerelease.yml

@@ -3,6 +3,14 @@ name: release / pre
 on:
   workflow_dispatch:
     inputs:
+      scope:
+        description: "What to release"
+        required: true
+        type: choice
+        options:
+          - monorepo
+          - cli
+          - angular
       suffix:
         description: "Version suffix (e.g. 'fix-user-issue'). Leave blank for timestamp."
         required: false
@@ -55,9 +63,9 @@ jobs:
 
       - name: Publish prerelease
         run: |
-          ARGS=""
+          ARGS="--scope ${{ inputs.scope }}"
           if [ -n "${{ inputs.suffix }}" ]; then
-            ARGS="--suffix ${{ inputs.suffix }}"
+            ARGS="$ARGS --suffix ${{ inputs.suffix }}"
           fi
           if [ "${{ inputs.dry_run }}" == "true" ]; then
             ARGS="$ARGS --dry-run"

.github/workflows/publish-release.yml

@@ -20,10 +20,19 @@ jobs:
     # Only run when a release PR is merged (not just closed)
     if: >
       github.event.pull_request.merged == true &&
-      startsWith(github.event.pull_request.head.ref, 'release/publish/v')
+      startsWith(github.event.pull_request.head.ref, 'release/publish/')
     runs-on: ubuntu-latest
     timeout-minutes: 20
     steps:
+      - name: Extract scope from branch
+        id: meta
+        run: |
+          BRANCH="${{ github.event.pull_request.head.ref }}"
+          # Branch format: release/publish/<scope>/v<version>
+          SCOPE=$(echo "$BRANCH" | sed 's|release/publish/\([^/]*\)/v.*|\1|')
+          echo "scope=$SCOPE" >> $GITHUB_OUTPUT
+          echo "Detected scope: $SCOPE"
+
       - name: Checkout Repo
         uses: actions/checkout@v4
         with:
@@ -54,7 +63,7 @@ jobs:
 
       - name: Publish to npm
         id: publish
-        run: pnpm tsx scripts/release/publish-release.ts
+        run: pnpm tsx scripts/release/publish-release.ts --scope ${{ steps.meta.outputs.scope }}
         env:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
@@ -67,22 +76,33 @@ jobs:
 
       - name: Create and push git tag
         run: |
-          TAG="v${{ steps.publish.outputs.version }}"
-          git tag -a "$TAG" -m "Release ${{ steps.publish.outputs.version }}"
+          SCOPE="${{ steps.meta.outputs.scope }}"
+          VERSION="${{ steps.publish.outputs.version }}"
+          if [ "$SCOPE" == "monorepo" ]; then
+            TAG="v${VERSION}"
+          else
+            TAG="${SCOPE}/v${VERSION}"
+          fi
+          git tag -a "$TAG" -m "Release ${SCOPE} ${VERSION}"
           git push origin "$TAG"
+          echo "tag=$TAG" >> $GITHUB_OUTPUT
+        id: tag
 
       - name: Create GitHub Release
         uses: actions/github-script@v7
         env:
-          RELEASE_TAG: v${{ steps.publish.outputs.version }}
-          RELEASE_NAME: v${{ steps.publish.outputs.version }}
+          RELEASE_TAG: ${{ steps.tag.outputs.tag }}
+          RELEASE_SCOPE: ${{ steps.meta.outputs.scope }}
+          RELEASE_VERSION: ${{ steps.publish.outputs.version }}
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             const fs = require("fs");
             const { owner, repo } = context.repo;
             const tag = process.env.RELEASE_TAG;
-            const name = process.env.RELEASE_NAME;
+            const scope = process.env.RELEASE_SCOPE;
+            const version = process.env.RELEASE_VERSION;
+            const name = scope === "monorepo" ? `v${version}` : `${scope}/v${version}`;
 
             let body = "";
             try {
@@ -112,6 +132,6 @@ jobs:
         run: |
           echo "## Release Published" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Scope:** ${{ steps.meta.outputs.scope }}" >> $GITHUB_STEP_SUMMARY
           echo "**Version:** ${{ steps.publish.outputs.version }}" >> $GITHUB_STEP_SUMMARY
-          echo "**Tag:** v${{ steps.publish.outputs.version }}" >> $GITHUB_STEP_SUMMARY
-          echo "**npm:** https://www.npmjs.com/package/@copilotkit/react-core/v/${{ steps.publish.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Tag:** ${{ steps.tag.outputs.tag }}" >> $GITHUB_STEP_SUMMARY

.github/workflows/stable-release.yml

@@ -3,6 +3,14 @@ name: release / create-pr
 on:
   workflow_dispatch:
     inputs:
+      scope:
+        description: "What to release"
+        required: true
+        type: choice
+        options:
+          - monorepo
+          - cli
+          - angular
       bump:
         description: "Version bump level"
         required: true
@@ -44,10 +52,10 @@ jobs:
               owner,
               repo,
               state: "open",
-              head_prefix: `${owner}:release/publish/v`,
+              head_prefix: `${owner}:release/publish/`,
             });
 
-            const releasePRs = prs.filter(pr => pr.head.ref.startsWith("release/publish/v"));
+            const releasePRs = prs.filter(pr => pr.head.ref.startsWith("release/publish/"));
             if (releasePRs.length > 0) {
               const existing = releasePRs.map(pr => `  - #${pr.number}: ${pr.title} (${pr.html_url})`).join("\n");
               core.setFailed(
@@ -78,9 +86,9 @@ jobs:
         id: prepare
         run: |
           if [ "${{ inputs.dry_run }}" == "true" ]; then
-            pnpm tsx scripts/release/prepare-release.ts --bump ${{ inputs.bump }} --dry-run
+            pnpm tsx scripts/release/prepare-release.ts --bump ${{ inputs.bump }} --scope ${{ inputs.scope }} --dry-run
           else
-            pnpm tsx scripts/release/prepare-release.ts --bump ${{ inputs.bump }}
+            pnpm tsx scripts/release/prepare-release.ts --bump ${{ inputs.bump }} --scope ${{ inputs.scope }}
           fi
 
       - name: Generate AI release notes
@@ -98,21 +106,21 @@ jobs:
         uses: peter-evans/create-pull-request@v8
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
-          branch: release/publish/v${{ steps.prepare.outputs.version }}
+          branch: release/publish/${{ inputs.scope }}/v${{ steps.prepare.outputs.version }}
           delete-branch: true
-          commit-message: "chore: release v${{ steps.prepare.outputs.version }}"
-          title: "chore: release v${{ steps.prepare.outputs.version }}"
+          commit-message: "chore: release ${{ inputs.scope }} v${{ steps.prepare.outputs.version }}"
+          title: "chore: release ${{ inputs.scope }} v${{ steps.prepare.outputs.version }}"
           body: |
-            ## Release v${{ steps.prepare.outputs.version }}
+            ## Release ${{ inputs.scope }} v${{ steps.prepare.outputs.version }}
 
-            **Bump:** `${{ inputs.bump }}`
+            **Scope:** `${{ inputs.scope }}` | **Bump:** `${{ inputs.bump }}`
 
             ---
 
             ### How this release process works
 
-            1. **This PR was created automatically** by the "Create Release PR" workflow.
-               It bumped all `@copilotkit/*` package versions to `${{ steps.prepare.outputs.version }}`
+            1. **This PR was created automatically** by the "release / create-pr" workflow.
+               It bumped the `${{ inputs.scope }}` packages to `${{ steps.prepare.outputs.version }}`
                and generated AI-enhanced release notes.
 
             2. **CI runs on this PR** — the full test suite (unit tests, lint, type checks, build)
@@ -121,10 +129,10 @@ jobs:
             3. **Review the release notes** in `release-notes.md` in this PR.
                If a Notion draft was created, you can edit the release notes there before merging.
 
-            4. **When this PR is merged**, the `publish-release` workflow automatically:
+            4. **When this PR is merged**, the `release / publish` workflow automatically:
                - Builds all packages
-               - Publishes all `@copilotkit/*` packages to npm at version `${{ steps.prepare.outputs.version }}`
-               - Creates git tag `v${{ steps.prepare.outputs.version }}`
+               - Publishes the `${{ inputs.scope }}` packages to npm at version `${{ steps.prepare.outputs.version }}`
+               - Creates git tag `${{ inputs.scope }}/v${{ steps.prepare.outputs.version }}`
                - Creates a GitHub Release with the final release notes
 
             ### Before merging

package.json

@@ -21,8 +21,8 @@
     "docs": "pnpm -C examples/v2/docs dev",
     "demo:angular": "nx run-many -t dev --projects=examples/v2/angular/demo,examples/v2/angular/demo-server",
     "demo:react": "pnpm -C examples/v2/react/demo dev",
-    "release:prepare:dry": "tsx scripts/release/prepare-release.ts --dry-run",
-    "release:prerelease:dry": "tsx scripts/release/prerelease.ts --dry-run",
+    "release:prepare:dry": "tsx scripts/release/prepare-release.ts --scope monorepo --bump patch --dry-run",
+    "release:prerelease:dry": "tsx scripts/release/prerelease.ts --scope monorepo --dry-run",
     "prepare": "lefthook install",
     "graph": "nx graph",
     "publint": "nx run-many -t publint --projects=packages/**",

release.config.json

@@ -1,18 +1,33 @@
 {
   "prereleaseTag": "canary",
-  "versionedTogether": [
-    "@copilotkit/a2ui-renderer",
-    "@copilotkit/core",
-    "@copilotkit/react-core",
-    "@copilotkit/react-textarea",
-    "@copilotkit/react-ui",
-    "@copilotkit/runtime",
-    "@copilotkit/runtime-client-gql",
-    "@copilotkit/sdk-js",
-    "@copilotkit/shared",
-    "@copilotkit/sqlite-runner",
-    "@copilotkit/voice",
-    "@copilotkit/web-inspector"
-  ],
-  "versionedIndependently": ["@copilotkitnext/angular", "copilotkit"]
+  "scopes": {
+    "monorepo": {
+      "packages": [
+        "@copilotkit/a2ui-renderer",
+        "@copilotkit/core",
+        "@copilotkit/react-core",
+        "@copilotkit/react-textarea",
+        "@copilotkit/react-ui",
+        "@copilotkit/runtime",
+        "@copilotkit/runtime-client-gql",
+        "@copilotkit/sdk-js",
+        "@copilotkit/shared",
+        "@copilotkit/sqlite-runner",
+        "@copilotkit/voice",
+        "@copilotkit/web-inspector"
+      ],
+      "versionSource": "@copilotkit/react-core",
+      "sharedVersion": true
+    },
+    "cli": {
+      "packages": ["copilotkit"],
+      "versionSource": "copilotkit",
+      "sharedVersion": false
+    },
+    "angular": {
+      "packages": ["@copilotkitnext/angular"],
+      "versionSource": "@copilotkitnext/angular",
+      "sharedVersion": false
+    }
+  }
 }

scripts/release/lib/config.ts

@@ -7,13 +7,31 @@ export const ROOT = path.resolve(
   "../../..",
 );
 
+export type ReleaseScope = "monorepo" | "cli" | "angular";
+
+export interface ScopeConfig {
+  packages: string[];
+  versionSource: string;
+  sharedVersion: boolean;
+}
+
 export interface ReleaseConfig {
   prereleaseTag: string;
-  versionedTogether: string[];
-  versionedIndependently: string[];
+  scopes: Record<ReleaseScope, ScopeConfig>;
 }
 
 export function loadConfig(): ReleaseConfig {
   const configPath = path.join(ROOT, "release.config.json");
   return JSON.parse(fs.readFileSync(configPath, "utf8"));
 }
+
+export function getScopeConfig(scope: ReleaseScope): ScopeConfig {
+  const config = loadConfig();
+  const scopeConfig = config.scopes[scope];
+  if (!scopeConfig) {
+    throw new Error(
+      `Unknown scope: ${scope}. Valid scopes: ${Object.keys(config.scopes).join(", ")}`,
+    );
+  }
+  return scopeConfig;
+}

scripts/release/lib/versions.test.ts

@@ -1,4 +1,4 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
+import { describe, it, expect, vi } from "vitest";
 import {
   parseSemver,
   computeNextStableVersion,
@@ -10,9 +10,36 @@ vi.mock("./config.js", () => ({
   ROOT: "/mock",
   loadConfig: () => ({
     prereleaseTag: "canary",
-    versionedTogether: [],
-    versionedIndependently: [],
+    scopes: {
+      monorepo: {
+        packages: [],
+        versionSource: "@copilotkit/react-core",
+        sharedVersion: true,
+      },
+      cli: { packages: [], versionSource: "copilotkit", sharedVersion: false },
+      angular: {
+        packages: [],
+        versionSource: "@copilotkitnext/angular",
+        sharedVersion: false,
+      },
+    },
   }),
+  getScopeConfig: (scope: string) => {
+    const scopes: Record<string, any> = {
+      monorepo: {
+        packages: [],
+        versionSource: "@copilotkit/react-core",
+        sharedVersion: true,
+      },
+      cli: { packages: [], versionSource: "copilotkit", sharedVersion: false },
+      angular: {
+        packages: [],
+        versionSource: "@copilotkitnext/angular",
+        sharedVersion: false,
+      },
+    };
+    return scopes[scope];
+  },
 }));
 
 describe("parseSemver", () => {