@williamthorsen/release-kit 4.6.0 → 4.7.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file.
 
+## [release-kit-v4.7.0] - 2026-04-16
+
+### Features
+
+- Support ## as synthetic ticket prefix in changelogs
+
+  Commits prefixed with `##` are now included in changelogs without requiring a ticket ID. This supports ad-hoc changes made during interactive sessions where creating a ticket and PR adds undesired overhead.
+
 ## [release-kit-v4.6.0] - 2026-04-15
 
 ### Features

package/cliff.toml.template

@@ -5,9 +5,11 @@
 # Examples:
 #   #19 rdy|feat: Add utility functions for common check patterns (#26)
 #   AFG-42 panel|fix: Fix button layout (#73)
+#   ## feat: Quick utility added during interactive session
 #
-# Only ticketed commits (leading #NN or PROJ-NN) are included.
+# Only ticketed commits (leading #NN, PROJ-NN, or ##) are included.
 # Unticketed maintenance commits (deps upgrades, tooling tweaks) are skipped.
+# Use ## as a synthetic ticket prefix for ad-hoc commits that belong in the changelog.
 
 [changelog]
 header = """
@@ -55,27 +57,27 @@ filter_unconventional = false
 split_commits = false
 commit_preprocessors = []
 # Require a ticket-ID prefix for inclusion.
-# Supported prefixes: "#123 ", "#123-1 ", "#123.1 ", "TOOL-123 "
+# Supported prefixes: "#123 ", "#123-1 ", "#123.1 ", "TOOL-123 ", "## "
 commit_parsers = [
   { message = "^release:", skip = true },
   { message = "^Merge", skip = true },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?bugfix(!)?:", group = "Bug fixes" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?ci(!)?:", group = "CI" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?deprecate(!)?:", group = "Deprecated" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?deps?(!)?:", group = "Dependencies" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?docs?(!)?:", group = "Documentation" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?feat(!)?:", group = "Features" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?feature(!)?:", group = "Features" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?fix(!)?:", group = "Bug fixes" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?fmt(!)?:", group = "Formatting" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?internal(!)?:", group = "Internal" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?perf(!)?:", group = "Performance" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?performance(!)?:", group = "Performance" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?refactor(!)?:", group = "Refactoring" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?sec(!)?:", group = "Security" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?security(!)?:", group = "Security" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?tests?(!)?:", group = "Tests" },
-  { message = "^(\\#\\d+([.\\-]\\d+)?|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?tooling(!)?:", group = "Tooling" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?bugfix(!)?:", group = "Bug fixes" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?ci(!)?:", group = "CI" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?deprecate(!)?:", group = "Deprecated" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?deps?(!)?:", group = "Dependencies" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?docs?(!)?:", group = "Documentation" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?feat(!)?:", group = "Features" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?feature(!)?:", group = "Features" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?fix(!)?:", group = "Bug fixes" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?fmt(!)?:", group = "Formatting" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?internal(!)?:", group = "Internal" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?perf(!)?:", group = "Performance" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?performance(!)?:", group = "Performance" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?refactor(!)?:", group = "Refactoring" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?sec(!)?:", group = "Security" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?security(!)?:", group = "Security" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?tests?(!)?:", group = "Tests" },
+  { message = "^(\\#\\d+([.\\-]\\d+)?|\\#\\#|[A-Z]+-\\d+)\\s+([\\w-]+\\|)?tooling(!)?:", group = "Tooling" },
   # Skip unticketed commits (maintenance, deps, initial scaffolding, etc.)
   { message = ".*", skip = true },
 ]

package/dist/esm/.cache

@@ -1 +1 @@
-020cc360fffab3d5b52fc5e388bc432d37399fdfb25c30cff31a23d37f1c2c09
+d3e4e5bacab96fdfcab4ae55b07b4830280060f0bc39bbada29fa8f08e2c9381

package/dist/esm/createGithubRelease.js

@@ -20,10 +20,16 @@ function createGithubRelease(options) {
     console.warn(`Warning: no changelog entry for version ${version}; skipping GitHub Release creation`);
     return false;
   }
+  if (!entry.sections.some(matchesAudience("all"))) {
+    return false;
+  }
   const body = renderReleaseNotesSingle(entry, {
     filter: matchesAudience("all"),
     includeHeading: false
   });
+  if (body.trim() === "") {
+    return false;
+  }
   const args = ["release", "create", tag, "--title", tag, "--notes", body];
   if (dryRun) {
     console.info(`[dry-run] Would run: gh ${args.join(" ")}`);

package/dist/esm/parseCommitMessage.js

@@ -1,4 +1,4 @@
-const COMMIT_PREPROCESSOR_PATTERNS = [/^#\d+([.-]\d+)?\s+/, /^[A-Z]+-\d+\s+/];
+const COMMIT_PREPROCESSOR_PATTERNS = [/^##\s+/, /^#\d+([.-]\d+)?\s+/, /^[A-Z]+-\d+\s+/];
 function parseCommitMessage(message, hash, workTypes, scopeAliases) {
   const stripped = stripTicketPrefix(message);
   const match = stripped.match(/^(?:([^|]+)\|)?(\w+)(?:\(([^)]+)\))?(!)?:\s*(.*)$/);

package/dist/esm/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "4.6.0";
+export declare const VERSION = "4.7.0";

package/dist/esm/version.js

@@ -1,4 +1,4 @@
-const VERSION = "4.6.0";
+const VERSION = "4.7.0";
 export {
   VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "4.6.0",
+  "version": "4.7.0",
   "description": "Version-bumping and changelog-generation toolkit for release workflows",
   "keywords": [],
   "homepage": "https://github.com/williamthorsen/node-monorepo-tools/tree/main/packages/release-kit#readme",

package/dist/esm/init/prompt.d.ts

@@ -1,4 +0,0 @@
-export declare function printStep(message: string): void;
-export declare function printSuccess(message: string): void;
-export declare function printSkip(message: string): void;
-export declare function printError(message: string): void;

package/dist/esm/init/prompt.js

@@ -1,19 +0,0 @@
-function printStep(message) {
-  console.info(`
-> ${message}`);
-}
-function printSuccess(message) {
-  console.info(`  \u2705 ${message}`);
-}
-function printSkip(message) {
-  console.info(`  \u26A0\uFE0F ${message}`);
-}
-function printError(message) {
-  console.error(`  \u274C ${message}`);
-}
-export {
-  printError,
-  printSkip,
-  printStep,
-  printSuccess
-};

package/dist/esm/runReleasePrepare.d.ts

@@ -1,10 +0,0 @@
-import type { MonorepoReleaseConfig, ReleaseConfig, ReleaseType } from './types.ts';
-export declare const RELEASE_TAGS_FILE = "tmp/.release-tags";
-export declare function parseArgs(argv: string[]): {
-    dryRun: boolean;
-    force: boolean;
-    bumpOverride: ReleaseType | undefined;
-    only: string[] | undefined;
-};
-export declare function runReleasePrepare(config: MonorepoReleaseConfig | ReleaseConfig): void;
-export declare function writeReleaseTags(tags: string[], dryRun: boolean): void;

package/dist/esm/runReleasePrepare.js

@@ -1,125 +0,0 @@
-import { mkdirSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
-import { dim } from "./format.js";
-import { releasePrepare } from "./releasePrepare.js";
-import { releasePrepareMono } from "./releasePrepareMono.js";
-const RELEASE_TAGS_FILE = "tmp/.release-tags";
-const VALID_BUMP_TYPES = ["major", "minor", "patch"];
-function isReleaseType(value) {
-  return VALID_BUMP_TYPES.includes(value);
-}
-function isMonorepoConfig(config) {
-  return "components" in config;
-}
-function showHelp() {
-  console.info(`
-Usage: runReleasePrepare [options]
-
-Legacy entry point for release preparation. Prefer the CLI:
-  npx @williamthorsen/release-kit prepare
-
-Options:
-  --dry-run             Run without modifying any files
-  --bump=major|minor|patch  Override the bump type for all components
-  --force               Bypass the "no commits since last tag" check (monorepo only, requires --bump)
-  --only=name1,name2    Only process the named components (comma-separated, monorepo only)
-  --help                Show this help message
-`);
-}
-function parseArgs(argv) {
-  let dryRun = false;
-  let force = false;
-  let bumpOverride;
-  let only;
-  for (const arg of argv) {
-    if (arg === "--dry-run") {
-      dryRun = true;
-    } else if (arg === "--force") {
-      force = true;
-    } else if (arg.startsWith("--bump=")) {
-      const value = arg.slice("--bump=".length);
-      if (!isReleaseType(value)) {
-        console.error(`Error: Invalid bump type "${value}". Must be one of: ${VALID_BUMP_TYPES.join(", ")}`);
-        process.exit(1);
-      }
-      bumpOverride = value;
-    } else if (arg.startsWith("--only=")) {
-      const value = arg.slice("--only=".length);
-      if (!value) {
-        console.error("Error: --only requires a comma-separated list of component names");
-        process.exit(1);
-      }
-      only = value.split(",");
-    } else if (arg === "--help" || arg === "-h") {
-      showHelp();
-      process.exit(0);
-    } else {
-      console.error(`Error: Unknown argument: ${arg}`);
-      process.exit(1);
-    }
-  }
-  if (force && bumpOverride === void 0) {
-    console.error("Error: --force requires --bump to specify the version bump type");
-    process.exit(1);
-  }
-  return { dryRun, force, bumpOverride, only };
-}
-function runReleasePrepare(config) {
-  const { dryRun, force, bumpOverride, only } = parseArgs(process.argv.slice(2));
-  const options = {
-    dryRun,
-    force,
-    ...bumpOverride === void 0 ? {} : { bumpOverride }
-  };
-  if (!isMonorepoConfig(config)) {
-    if (only !== void 0) {
-      console.error("Error: --only is only supported for monorepo configurations");
-      process.exit(1);
-    }
-    try {
-      const tags = releasePrepare(config, options);
-      writeReleaseTags(tags, dryRun);
-    } catch (error) {
-      console.error("Error preparing release:", error instanceof Error ? error.message : String(error));
-      process.exit(1);
-    }
-    return;
-  }
-  let effectiveConfig = config;
-  if (only !== void 0) {
-    const knownNames = config.components.map((c) => c.dir);
-    for (const name of only) {
-      if (!knownNames.includes(name)) {
-        console.error(`Error: Unknown component "${name}". Known components: ${knownNames.join(", ")}`);
-        process.exit(1);
-      }
-    }
-    const filtered = config.components.filter((c) => only.includes(c.dir));
-    effectiveConfig = { ...config, components: filtered };
-  }
-  try {
-    const tags = releasePrepareMono(effectiveConfig, options);
-    writeReleaseTags(tags, dryRun);
-  } catch (error) {
-    console.error("Error preparing release:", error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  }
-}
-function writeReleaseTags(tags, dryRun) {
-  if (tags.length === 0) {
-    return;
-  }
-  if (dryRun) {
-    console.info(dim(`  [dry-run] Would write ${RELEASE_TAGS_FILE}: ${tags.join(" ")}`));
-    return;
-  }
-  mkdirSync(dirname(RELEASE_TAGS_FILE), { recursive: true });
-  writeFileSync(RELEASE_TAGS_FILE, tags.join("\n"), "utf8");
-  console.info(dim(`  Wrote ${RELEASE_TAGS_FILE}: ${tags.join(" ")}`));
-}
-export {
-  RELEASE_TAGS_FILE,
-  parseArgs,
-  runReleasePrepare,
-  writeReleaseTags
-};

package/dist/esm/sync-labels/scaffold.d.ts

@@ -1,6 +0,0 @@
-interface WriteResult {
-    action: 'created' | 'skipped' | 'dry-run' | 'failed';
-    filePath: string;
-}
-export declare function writeIfAbsent(filePath: string, content: string, dryRun: boolean, overwrite: boolean): WriteResult;
-export {};

package/dist/esm/sync-labels/scaffold.js

@@ -1,25 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
-function writeIfAbsent(filePath, content, dryRun, overwrite) {
-  if (existsSync(filePath) && !overwrite) {
-    console.info(`  Skipped ${filePath} (already exists)`);
-    return { action: "skipped", filePath };
-  }
-  if (dryRun) {
-    console.info(`  [dry-run] Would create ${filePath}`);
-    return { action: "dry-run", filePath };
-  }
-  try {
-    mkdirSync(dirname(filePath), { recursive: true });
-    writeFileSync(filePath, content, "utf8");
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(`  Failed to write ${filePath}: ${message}`);
-    return { action: "failed", filePath };
-  }
-  console.info(`  Created ${filePath}`);
-  return { action: "created", filePath };
-}
-export {
-  writeIfAbsent
-};