@williamthorsen/release-kit 5.0.0 → 5.2.0

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[];

package/dist/esm/generateChangelogJson.js

@@ -1,232 +0,0 @@
-import { execFileSync } from "node:child_process";
-import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { dirname, join } from "node:path";
-import stringify from "json-stringify-pretty-compact";
-import { extractVersion, isChangelogEntry } from "./changelogJsonUtils.js";
-import { resolveCliffConfigPath } from "./resolveCliffConfigPath.js";
-import { isRecord, isUnknownArray } from "./typeGuards.js";
-function generateChangelogJson(config, changelogPath, tag, dryRun, options) {
-  const outputFile = join(changelogPath, config.changelogJson.outputPath);
-  if (dryRun) {
-    return [outputFile];
-  }
-  const resolvedConfigPath = resolveCliffConfigPath(config.cliffConfigPath, import.meta.url);
-  let cliffConfigPath = resolvedConfigPath;
-  let tempDir;
-  if (resolvedConfigPath.endsWith(".template")) {
-    tempDir = mkdtempSync(join(tmpdir(), "cliff-"));
-    cliffConfigPath = join(tempDir, "cliff.toml");
-    copyFileSync(resolvedConfigPath, cliffConfigPath);
-  }
-  const args = ["--config", cliffConfigPath, "--context", "--tag", tag];
-  if (options?.tagPattern !== void 0) {
-    args.push("--tag-pattern", options.tagPattern);
-  }
-  for (const includePath of options?.includePaths ?? []) {
-    args.push("--include-path", includePath);
-  }
-  try {
-    const contextJson = execFileSync("npx", ["--yes", "git-cliff", ...args], {
-      encoding: "utf8",
-      stdio: ["pipe", "pipe", "inherit"]
-    });
-    const releases = parseCliffContext(contextJson);
-    const devOnlySections = new Set(config.changelogJson.devOnlySections);
-    const entries = transformReleases(releases, devOnlySections);
-    const existingEntries = readExistingEntries(outputFile);
-    const merged = mergeEntries(entries, existingEntries);
-    mkdirSync(dirname(outputFile), { recursive: true });
-    writeFileSync(outputFile, stringify(merged, { maxLength: 100 }) + "\n", "utf8");
-    return [outputFile];
-  } catch (error) {
-    throw new Error(
-      `Failed to generate changelog JSON for ${outputFile}: ${error instanceof Error ? error.message : String(error)}`
-    );
-  } finally {
-    if (tempDir !== void 0) {
-      rmSync(tempDir, { recursive: true, force: true });
-    }
-  }
-}
-function generateSyntheticChangelogJson(config, changelogPath, newVersion, date, propagatedFrom, dryRun) {
-  const outputFile = join(changelogPath, config.changelogJson.outputPath);
-  if (dryRun) {
-    return [outputFile];
-  }
-  const items = propagatedFrom.map((dep) => ({
-    description: `Bumped \`${dep.packageName}\` to ${dep.newVersion}`
-  }));
-  const entry = {
-    version: newVersion,
-    date,
-    sections: [{ title: "Dependency updates", audience: "dev", items }]
-  };
-  const existingEntries = readExistingEntries(outputFile);
-  const merged = mergeEntries([entry], existingEntries);
-  mkdirSync(dirname(outputFile), { recursive: true });
-  writeFileSync(outputFile, stringify(merged, { maxLength: 100 }) + "\n", "utf8");
-  return [outputFile];
-}
-function parseCliffContext(json) {
-  const parsed = JSON.parse(json);
-  if (!isUnknownArray(parsed)) {
-    throw new TypeError("Expected git-cliff --context output to be an array");
-  }
-  return parsed.map(toCliffContextRelease);
-}
-function toCliffContextRelease(value) {
-  if (!isRecord(value)) {
-    return {};
-  }
-  const release = {};
-  if (typeof value.version === "string") {
-    release.version = value.version;
-  }
-  if (typeof value.timestamp === "number") {
-    release.timestamp = value.timestamp;
-  }
-  if (isUnknownArray(value.commits)) {
-    release.commits = value.commits.map(toCliffContextCommit);
-  }
-  return release;
-}
-function toCliffContextCommit(value) {
-  if (!isRecord(value)) {
-    return { message: "" };
-  }
-  const commit = {
-    message: typeof value.message === "string" ? value.message : ""
-  };
-  if (typeof value.group === "string") {
-    commit.group = value.group;
-  }
-  return commit;
-}
-function transformReleases(releases, devOnlySections) {
-  const entries = [];
-  for (const release of releases) {
-    if (release.version === void 0) {
-      continue;
-    }
-    const version = extractVersion(release.version);
-    const date = release.timestamp !== void 0 ? new Date(release.timestamp * 1e3).toISOString().slice(0, 10) : "unreleased";
-    const sectionMap = /* @__PURE__ */ new Map();
-    for (const commit of release.commits ?? []) {
-      const group = commit.group ?? "Other";
-      const description = extractDescription(commit.message);
-      const body = extractBody(commit.message);
-      let items = sectionMap.get(group);
-      if (items === void 0) {
-        items = [];
-        sectionMap.set(group, items);
-      }
-      const item = { description };
-      if (body !== void 0) {
-        item.body = body;
-      }
-      items.push(item);
-    }
-    const sections = [];
-    for (const [title, items] of sectionMap) {
-      if (items.length === 0) {
-        continue;
-      }
-      sections.push({
-        title,
-        audience: devOnlySections.has(title) ? "dev" : "all",
-        items
-      });
-    }
-    if (sections.length > 0) {
-      entries.push({ version, date, sections });
-    }
-  }
-  return entries;
-}
-function extractDescription(message) {
-  const firstLine = message.split("\n")[0] ?? message;
-  const afterColon = firstLine.split(": ").slice(1).join(": ");
-  if (afterColon.length > 0) {
-    return afterColon.charAt(0).toUpperCase() + afterColon.slice(1);
-  }
-  return firstLine;
-}
-const TRAILER_PATTERNS = [
-  /^Signed-off-by:/i,
-  /^Co-authored-by:/i,
-  /^(Closes|Fixes|Resolves)\s+#\d+\s*$/i,
-  /^https?:\/\/\S+\/pull\/\d+\/?\s*$/
-];
-function extractBody(message) {
-  const lines = message.split("\n").slice(1);
-  let start = 0;
-  while (start < lines.length && (lines[start] ?? "").trim() === "") {
-    start += 1;
-  }
-  let end = lines.length;
-  while (end > start) {
-    const line = lines[end - 1] ?? "";
-    const trimmed = line.trim();
-    if (trimmed === "") {
-      end -= 1;
-      continue;
-    }
-    if (TRAILER_PATTERNS.some((pattern) => pattern.test(trimmed))) {
-      end -= 1;
-      continue;
-    }
-    break;
-  }
-  if (end <= start) {
-    return void 0;
-  }
-  return lines.slice(start, end).join("\n").trim();
-}
-function readExistingEntries(filePath) {
-  if (!existsSync(filePath)) {
-    return [];
-  }
-  try {
-    const content = readFileSync(filePath, "utf8");
-    const parsed = JSON.parse(content);
-    if (!isUnknownArray(parsed)) {
-      return [];
-    }
-    return parsed.filter(isChangelogEntry);
-  } catch (error) {
-    console.warn(
-      `Warning: could not parse existing ${filePath}: ${error instanceof Error ? error.message : String(error)}; treating as empty`
-    );
-    return [];
-  }
-}
-function mergeEntries(newEntries, existingEntries) {
-  const versionMap = /* @__PURE__ */ new Map();
-  for (const entry of existingEntries) {
-    versionMap.set(entry.version, entry);
-  }
-  for (const entry of newEntries) {
-    versionMap.set(entry.version, entry);
-  }
-  return [...versionMap.values()].sort((a, b) => compareVersionsDescending(a.version, b.version));
-}
-function parseVersionParts(version) {
-  return version.split(".").map((s) => {
-    const n = Number(s);
-    return Number.isNaN(n) ? 0 : n;
-  });
-}
-function compareVersionsDescending(a, b) {
-  const partsA = parseVersionParts(a);
-  const partsB = parseVersionParts(b);
-  for (let i = 0; i < 3; i++) {
-    const diff = (partsB[i] ?? 0) - (partsA[i] ?? 0);
-    if (diff !== 0) return diff;
-  }
-  return 0;
-}
-export {
-  generateChangelogJson,
-  generateSyntheticChangelogJson
-};

package/dist/esm/version.d.ts

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

package/dist/esm/version.js

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