@williamthorsen/release-kit 5.0.0 → 5.1.0

package/dist/esm/reportPrepare.js

@@ -1,6 +1,6 @@
 import { bold, dim, sectionHeader } from "./format.js";
 function reportPrepare(result) {
-  const isMultiWorkspace = result.workspaces.some((w) => w.name !== void 0);
+  const isMultiWorkspace = result.workspaces.some((w) => w.name !== void 0) || result.project !== void 0;
   if (isMultiWorkspace) {
     return formatMultiWorkspace(result);
   }
@@ -19,34 +19,29 @@ function formatSingleWorkspace(result) {
   }
   formatUnparseableWarning(lines, workspace);
   if (workspace.status === "skipped") {
-    lines.push(`\u23ED\uFE0F  ${workspace.skipReason ?? "Skipped"}`);
+    lines.push(`\u23ED\uFE0F  ${workspace.skipReason}`);
     return lines.join("\n");
   }
   if (workspace.setVersion !== void 0) {
     lines.push(`  Using version override: ${workspace.setVersion}`);
-  } else if (workspace.parsedCommitCount === void 0 && workspace.releaseType !== void 0) {
-    lines.push(`  Using bump override: ${workspace.releaseType}`);
+  } else if (workspace.bumpOverride !== void 0) {
+    lines.push(`  Using bump override: ${workspace.bumpOverride}`);
   }
   if (workspace.releaseType !== void 0) {
     lines.push(dim(`Bumping versions (${workspace.releaseType})...`));
   } else if (workspace.setVersion !== void 0) {
     lines.push(dim(`Bumping versions (version override)...`));
   }
-  if (workspace.currentVersion !== void 0 && workspace.newVersion !== void 0) {
-    if (workspace.setVersion !== void 0) {
-      lines.push(`\u{1F4E6} ${workspace.currentVersion} \u2192 ${bold(workspace.newVersion)} (version override)`);
-    } else if (workspace.releaseType !== void 0) {
-      lines.push(`\u{1F4E6} ${workspace.currentVersion} \u2192 ${bold(workspace.newVersion)} (${workspace.releaseType})`);
-    }
+  if (workspace.setVersion !== void 0) {
+    lines.push(`\u{1F4E6} ${workspace.currentVersion} \u2192 ${bold(workspace.newVersion)} (version override)`);
+  } else if (workspace.releaseType !== void 0) {
+    lines.push(`\u{1F4E6} ${workspace.currentVersion} \u2192 ${bold(workspace.newVersion)} (${workspace.releaseType})`);
   }
   formatBumpFiles(lines, workspace, result.dryRun);
   lines.push(dim("Generating changelogs..."));
   formatChangelogFiles(lines, workspace, result.dryRun);
   formatFormatCommand(lines, result);
-  lines.push(`\u2705 Release preparation complete.`);
-  if (workspace.tag !== void 0) {
-    lines.push(`   \u{1F3F7}\uFE0F  ${bold(workspace.tag)}`);
-  }
+  lines.push(`\u2705 Release preparation complete.`, `   \u{1F3F7}\uFE0F  ${bold(workspace.tag)}`);
   return lines.join("\n");
 }
 function formatMultiWorkspace(result) {
@@ -54,6 +49,9 @@ function formatMultiWorkspace(result) {
   for (const workspace of result.workspaces) {
     formatWorkspaceSection(lines, workspace, result.dryRun);
   }
+  if (result.project !== void 0) {
+    formatProjectSection(lines, result.project, result.dryRun);
+  }
   formatFormatCommand(lines, result);
   formatWarnings(lines, result);
   if (result.tags.length > 0) {
@@ -68,6 +66,59 @@ function formatMultiWorkspace(result) {
   }
   return lines.join("\n");
 }
+function formatProjectSection(lines, project, dryRun) {
+  lines.push(`
+${sectionHeader("project")}`);
+  const since = project.previousTag === void 0 ? "(no previous release found)" : `since ${project.previousTag}`;
+  lines.push(dim(`  Found ${project.commitCount} commits ${since}`));
+  if (project.status === "skipped") {
+    lines.push(`  \u23ED\uFE0F  ${project.skipReason}`);
+    return;
+  }
+  const { releaseType, currentVersion, newVersion, tag } = project;
+  if (project.parsedCommitCount > 0) {
+    lines.push(dim(`  Parsed ${project.parsedCommitCount} typed commits`));
+  }
+  if (project.bumpOverride !== void 0) {
+    lines.push(`  Using bump override: ${project.bumpOverride}`);
+  }
+  formatProjectUnparseable(lines, project);
+  lines.push(
+    dim(`  Bumping versions (${releaseType})...`),
+    `  \u{1F4E6} ${currentVersion} \u2192 ${bold(newVersion)} (${releaseType})`
+  );
+  for (const file of project.bumpedFiles) {
+    if (dryRun) {
+      lines.push(dim(`    [dry-run] Would bump ${file}`));
+    } else {
+      lines.push(dim(`    Bumped ${file}`));
+    }
+  }
+  lines.push(dim("  Generating changelogs..."));
+  for (const file of project.changelogFiles) {
+    if (dryRun) {
+      lines.push(dim(`    [dry-run] Would run: npx --yes git-cliff ... --output ${file}`));
+    } else {
+      lines.push(dim(`    Generating changelog: ${file}`));
+    }
+  }
+  lines.push(`  \u{1F3F7}\uFE0F  ${bold(tag)}`);
+}
+function formatProjectUnparseable(lines, project) {
+  const unparseable = project.unparseableCommits;
+  if (unparseable === void 0 || unparseable.length === 0) {
+    return;
+  }
+  const count = unparseable.length;
+  const isPatchFloor = project.parsedCommitCount === 0;
+  const suffix = isPatchFloor ? " (defaulting to patch bump)" : "";
+  lines.push(`    \u26A0\uFE0F  ${count} commit${count === 1 ? "" : "s"} could not be parsed${suffix}`);
+  for (const commit of unparseable) {
+    const shortHash = commit.hash.slice(0, 7);
+    const truncatedMessage = commit.message.length > 72 ? `${commit.message.slice(0, 69)}...` : commit.message;
+    lines.push(`      \xB7 ${shortHash} ${truncatedMessage}`);
+  }
+}
 function formatWorkspaceSection(lines, workspace, dryRun) {
   if (workspace.name !== void 0) {
     lines.push(`
@@ -76,7 +127,7 @@ ${sectionHeader(workspace.name)}`);
   const since = workspace.previousTag === void 0 ? "(no previous release found)" : `since ${workspace.previousTag}`;
   lines.push(dim(`  Found ${workspace.commitCount} commits ${since}`));
   if (workspace.status === "skipped") {
-    lines.push(`  \u23ED\uFE0F  ${workspace.skipReason ?? "Skipped"}`);
+    lines.push(`  \u23ED\uFE0F  ${workspace.skipReason}`);
     return;
   }
   const { propagatedFrom } = workspace;
@@ -88,23 +139,21 @@ ${sectionHeader(workspace.name)}`);
   formatBumpFiles(lines, workspace, dryRun, "  ");
   lines.push(dim("  Generating changelogs..."));
   formatChangelogFiles(lines, workspace, dryRun, "  ");
-  if (workspace.tag !== void 0) {
-    lines.push(`  \u{1F3F7}\uFE0F  ${bold(workspace.tag)}`);
-  }
+  lines.push(`  \u{1F3F7}\uFE0F  ${bold(workspace.tag)}`);
 }
 function formatCommitSummary(lines, workspace, propagatedFrom, isPropagatedOnly) {
   if (isPropagatedOnly && propagatedFrom !== void 0) {
     const depNames = propagatedFrom.map((p) => p.packageName).join(", ");
     lines.push(dim(`  0 commits (bumped via dependency: ${depNames})`));
-  } else if (workspace.parsedCommitCount !== void 0) {
+  } else if (workspace.parsedCommitCount !== void 0 && workspace.parsedCommitCount > 0) {
     lines.push(dim(`  Parsed ${workspace.parsedCommitCount} typed commits`));
   }
 }
 function formatBumpLabels(lines, workspace, isPropagatedOnly) {
   if (workspace.setVersion !== void 0) {
     lines.push(`  Using version override: ${workspace.setVersion}`);
-  } else if (workspace.parsedCommitCount === void 0 && workspace.releaseType !== void 0 && !isPropagatedOnly) {
-    lines.push(`  Using bump override: ${workspace.releaseType}`);
+  } else if (workspace.bumpOverride !== void 0 && !isPropagatedOnly) {
+    lines.push(`  Using bump override: ${workspace.bumpOverride}`);
   }
   if (workspace.releaseType !== void 0) {
     lines.push(dim(`  Bumping versions (${workspace.releaseType})...`));
@@ -113,9 +162,6 @@ function formatBumpLabels(lines, workspace, isPropagatedOnly) {
   }
 }
 function formatVersionLine(lines, workspace, propagatedFrom, isPropagatedOnly) {
-  if (workspace.currentVersion === void 0 || workspace.newVersion === void 0) {
-    return;
-  }
   if (workspace.setVersion !== void 0) {
     lines.push(`  \u{1F4E6} ${workspace.currentVersion} \u2192 ${bold(workspace.newVersion)} (version override)`);
   } else if (workspace.releaseType !== void 0) {

package/dist/esm/types.d.ts

@@ -22,6 +22,12 @@ export interface ChangelogJsonConfig {
 export interface ReleaseNotesConfig {
     shouldInjectIntoReadme: boolean;
 }
+export interface ProjectConfig {
+    tagPrefix?: string;
+}
+export interface ResolvedProjectConfig {
+    tagPrefix: string;
+}
 export interface PropagationSource {
     packageName: string;
     newVersion: string;
@@ -31,24 +37,58 @@ export interface BumpResult {
     newVersion: string;
     files: string[];
 }
-export interface WorkspacePrepareResult {
-    name?: string | undefined;
-    status: 'released' | 'skipped';
-    previousTag?: string | undefined;
+export interface ReleasedWorkspaceResult {
+    status: 'released';
+    name?: string;
+    previousTag?: string;
     commitCount: number;
-    parsedCommitCount?: number | undefined;
-    releaseType?: ReleaseType | undefined;
-    currentVersion?: string | undefined;
-    newVersion?: string | undefined;
-    tag?: string | undefined;
+    parsedCommitCount?: number;
+    unparseableCommits?: Commit[];
+    releaseType?: ReleaseType;
+    currentVersion: string;
+    newVersion: string;
+    tag: string;
     bumpedFiles: string[];
     changelogFiles: string[];
-    commits?: Commit[] | undefined;
-    unparseableCommits?: Commit[] | undefined;
-    propagatedFrom?: PropagationSource[] | undefined;
-    skipReason?: string | undefined;
-    setVersion?: string | undefined;
+    commits?: Commit[];
+    bumpOverride?: ReleaseType;
+    propagatedFrom?: PropagationSource[];
+    setVersion?: string;
+}
+export interface SkippedWorkspaceResult {
+    status: 'skipped';
+    name?: string;
+    previousTag?: string;
+    commitCount: number;
+    parsedCommitCount?: number;
+    unparseableCommits?: Commit[];
+    skipReason: string;
+}
+export type WorkspacePrepareResult = ReleasedWorkspaceResult | SkippedWorkspaceResult;
+export interface ReleasedProjectResult {
+    status: 'released';
+    previousTag?: string;
+    commitCount: number;
+    parsedCommitCount: number;
+    unparseableCommits?: Commit[];
+    releaseType: ReleaseType;
+    currentVersion: string;
+    newVersion: string;
+    tag: string;
+    bumpedFiles: string[];
+    changelogFiles: string[];
+    commits: Commit[];
+    bumpOverride?: ReleaseType;
+}
+export interface SkippedProjectResult {
+    status: 'skipped';
+    previousTag?: string;
+    commitCount: number;
+    parsedCommitCount: number;
+    unparseableCommits?: Commit[];
+    skipReason: string;
 }
+export type ProjectPrepareResult = ReleasedProjectResult | SkippedProjectResult;
 export interface PrepareResult {
     workspaces: WorkspacePrepareResult[];
     tags: string[];
@@ -59,6 +99,7 @@ export interface PrepareResult {
     } | undefined;
     dryRun: boolean;
     warnings?: string[] | undefined;
+    project?: ProjectPrepareResult | undefined;
 }
 export interface WorkTypeConfig {
     header: string;
@@ -78,6 +119,7 @@ export interface ReleaseKitConfig {
     changelogJson?: Partial<ChangelogJsonConfig>;
     releaseNotes?: Partial<ReleaseNotesConfig>;
     retiredPackages?: RetiredPackage[];
+    project?: ProjectConfig;
 }
 export interface LegacyIdentity {
     name: string;
@@ -124,6 +166,7 @@ export interface MonorepoReleaseConfig {
     scopeAliases?: Record<string, string>;
     changelogJson: ChangelogJsonConfig;
     releaseNotes: ReleaseNotesConfig;
+    project?: ResolvedProjectConfig;
 }
 export interface ReleaseConfig {
     tagPrefix: string;

package/dist/esm/validateConfig.js

@@ -9,6 +9,7 @@ function validateConfig(raw) {
     "changelogJson",
     "cliffConfigPath",
     "formatCommand",
+    "project",
     "releaseNotes",
     "retiredPackages",
     "scopeAliases",
@@ -30,6 +31,7 @@ function validateConfig(raw) {
   validateStringField("cliffConfigPath", raw.cliffConfigPath, config, errors);
   validateScopeAliases(raw.scopeAliases, config, errors);
   validateRetiredPackages(raw.retiredPackages, config, errors);
+  validateProjectConfig(raw.project, config, errors);
   const warnings = [];
   const changelogJsonEnabled = config.changelogJson?.enabled ?? true;
   if (!changelogJsonEnabled && config.releaseNotes?.shouldInjectIntoReadme) {
@@ -75,6 +77,30 @@ function validateChangelogJson(value, config, errors) {
   }
   config.changelogJson = result;
 }
+function validateProjectConfig(value, config, errors) {
+  if (value === void 0) return;
+  if (!isRecord(value)) {
+    errors.push("'project' must be an object");
+    return;
+  }
+  const knownProjectFields = /* @__PURE__ */ new Set(["tagPrefix"]);
+  for (const key of Object.keys(value)) {
+    if (!knownProjectFields.has(key)) {
+      errors.push(`project: unknown field '${key}'`);
+    }
+  }
+  const result = {};
+  if (value.tagPrefix !== void 0) {
+    if (typeof value.tagPrefix !== "string") {
+      errors.push("project.tagPrefix: must be a string");
+    } else if (value.tagPrefix === "") {
+      errors.push("project.tagPrefix: must be a non-empty string");
+    } else {
+      result.tagPrefix = value.tagPrefix;
+    }
+  }
+  config.project = result;
+}
 function validateReleaseNotes(value, config, errors) {
   if (value === void 0) return;
   if (!isRecord(value)) {

package/dist/esm/validateOnlyExcludesStrandedDependents.d.ts

@@ -0,0 +1,14 @@
+import type { DependencyGraph } from './buildDependencyGraph.ts';
+import type { WorkspaceConfig } from './types.ts';
+export interface CommitsProbeResult {
+    has: boolean;
+    tag: string | undefined;
+}
+export interface StrandedDependentViolation {
+    dir: string;
+    downstreamOf: string;
+    tag: string | undefined;
+}
+type CommitsProbe = (workspace: WorkspaceConfig) => CommitsProbeResult;
+export declare function validateOnlyExcludesStrandedDependents(workspaces: readonly WorkspaceConfig[], only: readonly string[], graph: DependencyGraph, hasCommits: CommitsProbe): StrandedDependentViolation[] | undefined;
+export {};

package/dist/esm/validateOnlyExcludesStrandedDependents.js

@@ -0,0 +1,109 @@
+function validateOnlyExcludesStrandedDependents(workspaces, only, graph, hasCommits) {
+  const probeCommits = memoizeCommitsProbe(hasCommits);
+  const workspaceByDir = new Map(workspaces.map((w) => [w.dir, w]));
+  const released = computeReleasedSet(only, workspaceByDir, graph, probeCommits);
+  const violations = collectStrandedViolations(released, new Set(only), graph, probeCommits);
+  if (violations.length === 0) return void 0;
+  violations.sort((a, b) => a.dir.localeCompare(b.dir));
+  return violations;
+}
+function memoizeCommitsProbe(probe) {
+  const cache = /* @__PURE__ */ new Map();
+  return (workspace) => {
+    const cached = cache.get(workspace.dir);
+    if (cached !== void 0) return cached;
+    const result = probe(workspace);
+    cache.set(workspace.dir, result);
+    return result;
+  };
+}
+function computeReleasedSet(only, workspaceByDir, graph, probeCommits) {
+  const released = /* @__PURE__ */ new Set();
+  for (const dir of only) {
+    const workspace = workspaceByDir.get(dir);
+    if (workspace !== void 0 && probeCommits(workspace).has) {
+      released.add(dir);
+    }
+  }
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const dir of only) {
+      if (released.has(dir)) continue;
+      if (hasDependencyIn(dir, graph, released)) {
+        released.add(dir);
+        changed = true;
+      }
+    }
+  }
+  return released;
+}
+function hasDependencyIn(dir, graph, released) {
+  const forwardDeps = graph.dependenciesOf.get(dir);
+  if (forwardDeps === void 0) return false;
+  for (const depPackageName of forwardDeps) {
+    const depDir = graph.packageNameToDir.get(depPackageName);
+    if (depDir !== void 0 && released.has(depDir)) return true;
+  }
+  return false;
+}
+function collectStrandedViolations(released, onlySet, graph, probeCommits) {
+  const violations = [];
+  const violationDirs = /* @__PURE__ */ new Set();
+  const visited = /* @__PURE__ */ new Set();
+  const queue = [];
+  for (const dir of released) {
+    const packageName = graph.dirToPackageName.get(dir);
+    if (packageName !== void 0) {
+      queue.push({ packageName, attributionRoot: dir });
+    }
+  }
+  while (queue.length > 0) {
+    const item = queue.shift();
+    if (item === void 0) break;
+    if (visited.has(item.packageName)) continue;
+    visited.add(item.packageName);
+    const dependents = graph.dependentsOf.get(item.packageName);
+    if (dependents === void 0) continue;
+    for (const dependent of dependents) {
+      visitDependent(dependent, item.attributionRoot, {
+        released,
+        onlySet,
+        graph,
+        probeCommits,
+        queue,
+        violations,
+        violationDirs
+      });
+    }
+  }
+  return violations;
+}
+function visitDependent(dependent, attributionRoot, ctx) {
+  if (ctx.onlySet.has(dependent.dir)) {
+    if (ctx.released.has(dependent.dir)) {
+      enqueueDependent(dependent, ctx);
+    }
+    return;
+  }
+  const probe = ctx.probeCommits(dependent);
+  if (!probe.has) return;
+  if (!ctx.violationDirs.has(dependent.dir)) {
+    ctx.violationDirs.add(dependent.dir);
+    ctx.violations.push({
+      dir: dependent.dir,
+      downstreamOf: attributionRoot,
+      tag: probe.tag
+    });
+  }
+  enqueueDependent(dependent, ctx);
+}
+function enqueueDependent(dependent, ctx) {
+  const packageName = ctx.graph.dirToPackageName.get(dependent.dir);
+  if (packageName !== void 0) {
+    ctx.queue.push({ packageName, attributionRoot: dependent.dir });
+  }
+}
+export {
+  validateOnlyExcludesStrandedDependents
+};

package/dist/esm/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "5.0.0";
+export declare const VERSION = "5.1.0";

package/dist/esm/version.js

@@ -1,4 +1,4 @@
-const VERSION = "5.0.0";
+const VERSION = "5.1.0";
 export {
   VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "5.0.0",
+  "version": "5.1.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",
@@ -28,6 +28,7 @@
     "dist/*",
     "cliff.toml.template",
     "presets/**",
+    "schemas/**",
     "CHANGELOG.md"
   ],
   "dependencies": {
@@ -35,10 +36,12 @@
     "jiti": "2.6.1",
     "js-yaml": "4.1.1",
     "json-stringify-pretty-compact": "4.0.0",
+    "semver": "7.7.4",
     "@williamthorsen/nmr-core": "0.3.0"
   },
   "devDependencies": {
     "@types/js-yaml": "4.0.9",
+    "@types/semver": "7.7.1",
     "smol-toml": "1.6.1"
   },
   "engines": {

package/presets/labels/common.yaml

@@ -8,18 +8,21 @@
 - name: bug
   color: d73a4a
   description: "Something isn't working"
-- name: documentation
-  color: a2eeef
-  description: Improvements or additions to documentation
 - name: deprecation
   color: fbca04
   description: Marks functionality for future removal
+- name: documentation
+  color: a2eeef
+  description: Improvements or additions to documentation
 - name: feature
   color: '0075ca'
   description: Added or improved external functionality
 - name: fix
   color: d73a4a
   description: Fixes a bug
+- name: operational
+  color: '000000'
+  description: Actions outside the codebase
 - name: performance
   color: '0075ca'
   description: Improves performance without changing behavior
@@ -48,6 +51,9 @@
 - name: dependencies
   color: edc287
   description: Change to dependencies
+- name: internal
+  color: 1d76db
+  description: Internal change without external impact
 - name: refactoring
   color: edc287
   description: Improvement to code without change in functionality
@@ -57,9 +63,6 @@
 - name: tooling
   color: edc287
   description: Development tools
-- name: utility
-  color: 1d76db
-  description: Changed internal functionality
 
 # Priority
 - name: 'priority:critical'

package/schemas/label-map.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "label-map",
+  "description": "Maps commit-prefix scopes and types to GitHub label names. Consumed by agent skills, CI tooling, and any script that needs to translate commit conventions into label operations.",
+  "type": "object",
+  "required": ["types", "scopes"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference for editor support."
+    },
+    "types": {
+      "type": "object",
+      "description": "Maps commit-type prefix (e.g., `feat`) to GitHub label name (e.g., `feature`).",
+      "additionalProperties": { "type": "string" }
+    },
+    "scopes": {
+      "type": "object",
+      "description": "Maps commit-scope prefix (e.g., `audit`) to GitHub label name (e.g., `scope:audit`).",
+      "additionalProperties": { "type": "string" }
+    }
+  }
+}

package/dist/esm/generateChangelogJson.d.ts

@@ -1,7 +0,0 @@
-import type { GenerateChangelogOptions } from './generateChangelogs.ts';
-import type { ReleaseConfig } from './types.ts';
-export declare function generateChangelogJson(config: Pick<ReleaseConfig, 'cliffConfigPath' | 'changelogJson'>, changelogPath: string, tag: string, dryRun: boolean, options?: GenerateChangelogOptions): string[];
-export declare function generateSyntheticChangelogJson(config: Pick<ReleaseConfig, 'changelogJson'>, changelogPath: string, newVersion: string, date: string, propagatedFrom: Array<{
-    packageName: string;
-    newVersion: string;
-}>, dryRun: boolean): string[];