bunset 1.0.10 → 1.0.11

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.0.11
+
+### Features
+
+- add --release option to create GitHub releases with changelog notes (#2)
+- update workspace root package.json version when scope is all (#1)
+
 ## 1.0.10
 
 ### Features

package/README.md

@@ -33,6 +33,8 @@ bunx bunset [options]
 | `--dry-run` | Preview changes without writing files, committing, or tagging |
 | `--debug` | Show detailed inclusion/exclusion reasoning (implies `--dry-run`) |
 | `--no-filter-by-package` | Include all commits in every package changelog (monorepo) |
+| `--push` | Push the release commit and tags to the remote |
+| `--release` | Create a GitHub release per tag with the changelog entry as the release notes (requires `--push` and the `gh` CLI) |
 
 When bump type or scope flags are omitted, interactive prompts will ask.
 
@@ -107,6 +109,8 @@ tag = true                              # create git tags (default: true)
 per-package-tags = false                # pkg@version tags (monorepo)
 tag-prefix = "v"                        # tag prefix (default: auto-detect)
 sections = "all"                          # changelog sections and order ("all" or array)
+push = false                            # push after tagging (default: false)
+release = false                         # create GitHub release per tag (default: false)
 dry-run = false                         # preview without writing
 debug = false                           # detailed reasoning (implies dry-run)
 filter-by-package = true                # per-package filtering (monorepo)
@@ -124,6 +128,8 @@ filter-by-package = true                # per-package filtering (monorepo)
 | `dry-run` | `boolean` | `false` | Preview all changes without writing files, committing, or tagging. |
 | `debug` | `boolean` | `false` | Show detailed inclusion/exclusion reasoning. Implies `dry-run`. |
 | `filter-by-package` | `boolean` | `true` | In a monorepo, only include commits that touched files within each package. Disable with `false` to include all commits in every changelog. |
+| `push` | `boolean` | `false` | Push the release commit and tags to the remote after tagging. |
+| `release` | `boolean` | `false` | Create a GitHub release for each tag with the changelog entry as the release notes. Requires `push = true` and the [`gh` CLI](https://cli.github.com/). When multiple packages share a tag, their entries are combined under per-package headings. |
 
 ## Testing
 

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "bunset",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "module": "src/index.ts",
   "type": "module",
   "bin": {
     "bunset": "src/index.ts"
   },
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/bun": "1.3.13"
   },
   "peerDependencies": {
-    "typescript": "^5"
+    "typescript": "^6.0.3"
   },
   "engines": {
     "bun": "^1.3"

package/src/changelog.test.ts

@@ -1,5 +1,5 @@
 import { test, expect, describe, beforeEach, afterEach } from "bun:test";
-import { buildChangelogEntry, writeChangelog } from "./changelog.ts";
+import { buildChangelogEntry, buildReleaseNotes, writeChangelog } from "./changelog.ts";
 import { COMMIT_TYPES } from "./commits.ts";
 import type { GroupedCommits } from "./types.ts";
 import { mkdtemp, rm } from "node:fs/promises";
@@ -202,3 +202,34 @@ describe("writeChangelog", () => {
     expect(idx1).toBeLessThan(idx2);
   });
 });
+
+describe("buildReleaseNotes", () => {
+  test("returns empty string for no entries", () => {
+    expect(buildReleaseNotes([])).toBe("");
+  });
+
+  test("strips the version heading from a single entry", () => {
+    const entry = "## 1.2.3\n\n### Features\n\n- Add login\n";
+    expect(buildReleaseNotes([{ pkgName: "pkg-a", entry }])).toBe(
+      "### Features\n\n- Add login\n",
+    );
+  });
+
+  test("combines multiple entries under per-package headings", () => {
+    const result = buildReleaseNotes([
+      { pkgName: "pkg-a", entry: "## 1.2.3\n\n### Features\n\n- A\n" },
+      { pkgName: "pkg-b", entry: "## 1.2.3\n\n### Bug Fixes\n\n- B\n" },
+    ]);
+    expect(result).toContain("## pkg-a");
+    expect(result).toContain("## pkg-b");
+    expect(result).toContain("### Features");
+    expect(result).toContain("### Bug Fixes");
+    expect(result).not.toMatch(/^## 1\.2\.3/m);
+    expect(result.indexOf("## pkg-a")).toBeLessThan(result.indexOf("## pkg-b"));
+  });
+
+  test("handles entries without a leading version heading", () => {
+    const entry = "### Features\n\n- Plain entry\n";
+    expect(buildReleaseNotes([{ pkgName: "pkg-a", entry }])).toBe(entry);
+  });
+});

package/src/changelog.ts

@@ -84,6 +84,17 @@ export function buildChangelogEntry(
   return lines.join("\n");
 }
 
+export function buildReleaseNotes(
+  entries: { pkgName: string; entry: string }[],
+): string {
+  const stripVersion = (e: string) => e.replace(/^## [^\n]*\n+/, "");
+  if (entries.length === 0) return "";
+  if (entries.length === 1) return stripVersion(entries[0]!.entry);
+  return entries
+    .map(({ pkgName, entry }) => `## ${pkgName}\n\n${stripVersion(entry)}`)
+    .join("\n\n");
+}
+
 export async function writeChangelog(
   dir: string,
   entry: string,

package/src/cli.ts

@@ -19,6 +19,8 @@ Options:
   --tag-prefix <str>   Tag prefix (auto-detected from last tag, or "v" if no tags)
   --sections <list>    Comma-separated changelog sections, or "all" (default: all)
   --push               Push commit and tags to remote after tagging
+  --release            Create a GitHub release per tag with the changelog entry
+                       as the release notes (requires --push and the gh CLI)
   --dry-run            Preview changes without writing files, committing, or tagging
   --debug              Show detailed inclusion/exclusion reasoning (implies --dry-run)
   --no-filter-by-package
@@ -75,6 +77,7 @@ Config file (.bunset.toml):
     tag-prefix = "v"                        # tag prefix (default: auto-detect)
     sections = "all"                          # changelog sections and order ("all" or array)
     push = false                            # push after tagging (default: false)
+    release = false                         # create GitHub release (default: false)
     dry-run = false                         # preview without writing
     debug = false                           # detailed reasoning (implies dry-run)
     filter-by-package = true                # per-package filtering (monorepo)`);
@@ -99,6 +102,7 @@ export function resolveOptions(
         "per-package-tags": { type: "boolean", default: false },
         sections: { type: "string" },
         push: { type: "boolean", default: false },
+        release: { type: "boolean", default: false },
         "dry-run": { type: "boolean", default: false },
         "filter-by-package": { type: "boolean", default: true },
         "tag-prefix": { type: "string" },
@@ -138,6 +142,7 @@ export function resolveOptions(
     ?? DEFAULT_SECTIONS;
 
   const push = values.push ? true : (config.push ?? false);
+  const release = values.release ? true : (config.release ?? false);
   const debug = values.debug ? true : (config.debug ?? false);
   const dryRun = debug || values["dry-run"] ? true : (config.dryRun ?? false);
 
@@ -150,11 +155,11 @@ export function resolveOptions(
     ?? null;
 
   if (bump && scope && commit !== null && tag !== null) {
-    return { scope, bump, commit, tag, perPackageTags, sections, dryRun, filterByPackage, tagPrefix, push, debug };
+    return { scope, bump, commit, tag, perPackageTags, sections, dryRun, filterByPackage, tagPrefix, push, release, debug };
   }
 
   return promptForMissing(
-    { commit, tag, perPackageTags, sections, dryRun, filterByPackage, tagPrefix, push, debug },
+    { commit, tag, perPackageTags, sections, dryRun, filterByPackage, tagPrefix, push, release, debug },
     bump,
     scope,
     isWs,
@@ -198,6 +203,7 @@ interface MergedDefaults {
   filterByPackage: boolean;
   tagPrefix: string | null;
   push: boolean;
+  release: boolean;
   debug: boolean;
 }
 

package/src/config.ts

@@ -53,6 +53,10 @@ export async function loadConfig(
     config.push = raw.push;
   }
 
+  if (typeof raw.release === "boolean") {
+    config.release = raw.release;
+  }
+
   if (typeof raw.debug === "boolean") {
     config.debug = raw.debug;
   }

package/src/git.ts

@@ -89,3 +89,20 @@ export async function gitPush(
     await $`git -C ${cwd} push --tags`.quiet();
   }
 }
+
+export async function createGithubRelease(
+  cwd: string,
+  tag: string,
+  notes: string,
+): Promise<void> {
+  const proc = Bun.spawn(
+    ["gh", "release", "create", tag, "--title", tag, "--notes-file", "-"],
+    { cwd, stdin: "pipe", stdout: "inherit", stderr: "inherit" },
+  );
+  proc.stdin.write(notes);
+  await proc.stdin.end();
+  const exitCode = await proc.exited;
+  if (exitCode !== 0) {
+    throw new Error(`gh release create exited with code ${exitCode}`);
+  }
+}

package/src/index.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
 
 import { $ } from "bun";
+import { join } from "node:path";
 import { resolveOptions } from "./cli.ts";
 import { loadConfig } from "./config.ts";
 import {
@@ -8,13 +9,14 @@ import {
   groupCommits,
   filterCommitsForPackage,
 } from "./commits.ts";
-import { buildChangelogEntry, writeChangelog } from "./changelog.ts";
+import { buildChangelogEntry, buildReleaseNotes, writeChangelog } from "./changelog.ts";
 import {
   getLastTag,
   getCommitsSince,
   getCommitFiles,
   commitAndTag,
   gitPush,
+  createGithubRelease,
 } from "./git.ts";
 import { getUpdatedDependencies } from "./deps.ts";
 import {
@@ -71,6 +73,21 @@ if (rawCommits.length === 0) {
   process.exit(1);
 }
 
+if (options.release && !options.push) {
+  console.error("--release requires --push (the tag must be on the remote).");
+  process.exit(1);
+}
+
+if (options.release && !options.tag) {
+  console.error("--release requires tagging to be enabled.");
+  process.exit(1);
+}
+
+if (options.release && !options.commit) {
+  console.error("--release requires --commit (tag/push/release run inside the commit step).");
+  process.exit(1);
+}
+
 const parsed = rawCommits.map((c) => parseCommit(c.hash, c.message, c.body));
 
 if (dbg) {
@@ -141,11 +158,23 @@ function packageHasChanges(groups: GroupedCommits): boolean {
   return options.sections.some((type) => groups[type].length > 0);
 }
 
-// When using shared tags, sync all packages to the same target version
+// When scope is "all" in a workspace, also update the workspace root's package.json
+const rootPackageJsonPath = join(cwd, "package.json");
+const updateRoot =
+  isWs &&
+  options.scope === "all" &&
+  !packages.some((p) => p.packageJsonPath === rootPackageJsonPath);
+const rootCurrentVersion = updateRoot
+  ? ((await Bun.file(rootPackageJsonPath).json()).version ?? "0.0.0")
+  : null;
+debug(`update root package.json: ${updateRoot}${updateRoot ? ` (current: ${rootCurrentVersion})` : ""}`);
+
+// When using shared tags, sync all packages (and root, if updating) to the same target version
 let targetVersion: string | null = null;
-if (!options.perPackageTags && packages.length > 1) {
-  const maxVersion = packages.reduce((max, pkg) => {
-    const v = pkg.version ?? "0.0.0";
+if (!options.perPackageTags && (packages.length > 1 || updateRoot)) {
+  const candidateVersions = packages.map((p) => p.version ?? "0.0.0");
+  if (updateRoot && rootCurrentVersion) candidateVersions.push(rootCurrentVersion);
+  const maxVersion = candidateVersions.reduce((max, v) => {
     const [mj1, mn1, p1] = parseSemver(max);
     const [mj2, mn2, p2] = parseSemver(v);
     if (mj2 > mj1) return v;
@@ -162,6 +191,8 @@ if (options.dryRun) {
 
   const tags: string[] = [];
   const filesToCommit: string[] = [];
+  const tagEntries = new Map<string, { pkgName: string; entry: string }[]>();
+  let anyPackageUpdated = false;
 
   for (const pkg of packages) {
     const groups = getPackageGroups(pkg, parsed);
@@ -194,6 +225,7 @@ if (options.dryRun) {
     const newVersion = targetVersion ?? bumpVersion(oldVersion, options.bump);
     console.log(`${pkg.name}: ${oldVersion} → ${newVersion}`);
     filesToCommit.push(pkg.packageJsonPath, `${pkg.path}/CHANGELOG.md`);
+    anyPackageUpdated = true;
 
     const updatedDeps = await getUpdatedDependencies(
       cwd,
@@ -211,14 +243,22 @@ if (options.dryRun) {
     console.log(entry);
 
     if (options.tag) {
-      if (options.perPackageTags) {
-        tags.push(`${pkg.name}@${newVersion}`);
-      } else {
-        tags.push(`${tagPrefix}${newVersion}`);
-      }
+      const tag = options.perPackageTags
+        ? `${pkg.name}@${newVersion}`
+        : `${tagPrefix}${newVersion}`;
+      tags.push(tag);
+      const list = tagEntries.get(tag) ?? [];
+      list.push({ pkgName: pkg.name, entry });
+      tagEntries.set(tag, list);
     }
   }
 
+  if (updateRoot && rootCurrentVersion && anyPackageUpdated) {
+    const newRootVersion = targetVersion ?? bumpVersion(rootCurrentVersion, options.bump);
+    console.log(`(workspace root): ${rootCurrentVersion} → ${newRootVersion}`);
+    filesToCommit.push(rootPackageJsonPath);
+  }
+
   const uniqueTags = [...new Set(tags)];
 
   filesToCommit.push(`${cwd}/bun.lock`);
@@ -244,6 +284,14 @@ if (options.dryRun) {
     console.log("Would push commit and tags to remote.");
   }
 
+  if (options.release) {
+    for (const tag of uniqueTags) {
+      const entries = tagEntries.get(tag) ?? [];
+      console.log(`\nWould create GitHub release ${tag} with notes:`);
+      console.log(buildReleaseNotes(entries));
+    }
+  }
+
   console.log(`\nFiles that would be modified (${filesToCommit.length}):`);
   for (const f of filesToCommit) {
     console.log(`  ${f}`);
@@ -253,6 +301,8 @@ if (options.dryRun) {
 
 const tags: string[] = [];
 const changedFiles: string[] = [];
+const tagEntries = new Map<string, { pkgName: string; entry: string }[]>();
+let anyPackageUpdated = false;
 
 for (const pkg of packages) {
   const groups = getPackageGroups(pkg, parsed);
@@ -269,6 +319,7 @@ for (const pkg of packages) {
     : await updatePackageVersion(pkg.packageJsonPath, options.bump);
   changedFiles.push(pkg.packageJsonPath);
   console.log(`${pkg.name}: ${oldVersion} → ${newVersion}`);
+  anyPackageUpdated = true;
 
   const updatedDeps = await getUpdatedDependencies(
     cwd,
@@ -285,14 +336,24 @@ for (const pkg of packages) {
   changedFiles.push(`${pkg.path}/CHANGELOG.md`);
 
   if (options.tag) {
-    if (options.perPackageTags) {
-      tags.push(`${pkg.name}@${newVersion}`);
-    } else {
-      tags.push(`${tagPrefix}${newVersion}`);
-    }
+    const tag = options.perPackageTags
+      ? `${pkg.name}@${newVersion}`
+      : `${tagPrefix}${newVersion}`;
+    tags.push(tag);
+    const list = tagEntries.get(tag) ?? [];
+    list.push({ pkgName: pkg.name, entry });
+    tagEntries.set(tag, list);
   }
 }
 
+if (updateRoot && anyPackageUpdated) {
+  const { oldVersion, newVersion } = targetVersion
+    ? await setPackageVersion(rootPackageJsonPath, targetVersion)
+    : await updatePackageVersion(rootPackageJsonPath, options.bump);
+  changedFiles.push(rootPackageJsonPath);
+  console.log(`(workspace root): ${oldVersion} → ${newVersion}`);
+}
+
 const uniqueTags = [...new Set(tags)];
 
 if (changedFiles.length === 0) {
@@ -320,6 +381,21 @@ if (options.commit) {
     await gitPush(cwd, uniqueTags);
     console.log("Pushed to remote.");
   }
+
+  if (options.release) {
+    for (const tag of uniqueTags) {
+      const entries = tagEntries.get(tag) ?? [];
+      const notes = buildReleaseNotes(entries);
+      try {
+        await createGithubRelease(cwd, tag, notes);
+        console.log(`Created GitHub release: ${tag}`);
+      } catch (err) {
+        console.warn(
+          `⚠ Failed to create GitHub release ${tag}: ${(err as Error).message}`,
+        );
+      }
+    }
+  }
 }
 
 console.log("Done.");

package/src/types.ts

@@ -24,6 +24,7 @@ export interface CliOptions {
   filterByPackage: boolean;
   tagPrefix: string | null;
   push: boolean;
+  release: boolean;
   debug: boolean;
 }