@williamthorsen/release-kit 4.8.0 → 5.1.0

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 = "4.8.0";
+export declare const VERSION = "5.1.0";

package/dist/esm/version.js

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

package/dist/esm/writeReleaseNotesPreviews.d.ts

@@ -0,0 +1,18 @@
+export interface WriteReleaseNotesPreviewsOptions {
+    workspacePath: string;
+    tag: string;
+    changelogJsonPath: string;
+    sectionOrder: string[];
+    dryRun: boolean;
+}
+export interface PreviewFileResult {
+    filePath: string;
+    outcome: 'created' | 'overwritten' | 'skipped-no-readme' | 'failed' | 'dry-run';
+    error?: string;
+}
+export interface WriteReleaseNotesPreviewsResult {
+    injectedReadme?: PreviewFileResult;
+    releaseNotes?: PreviewFileResult;
+    renderSkipped: boolean;
+}
+export declare function writeReleaseNotesPreviews(options: WriteReleaseNotesPreviewsOptions): WriteReleaseNotesPreviewsResult;

package/dist/esm/writeReleaseNotesPreviews.js

@@ -0,0 +1,65 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { writeFileWithCheck } from "@williamthorsen/nmr-core";
+import { extractVersion } from "./changelogJsonUtils.js";
+import { dim } from "./format.js";
+import { renderInjectedReadme } from "./injectReleaseNotesIntoReadme.js";
+function writeReleaseNotesPreviews(options) {
+  const { workspacePath, tag, changelogJsonPath, sectionOrder, dryRun } = options;
+  const version = extractVersion(tag);
+  const readmePath = path.join(workspacePath, "README.md");
+  let readmeExists = existsSync(readmePath);
+  let readmeUnreadable = false;
+  let readmeContent = "";
+  if (readmeExists) {
+    try {
+      readmeContent = readFileSync(readmePath, "utf8");
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.warn(`Warning: failed to read ${readmePath}: ${message}; skipping injected-README preview`);
+      readmeExists = false;
+      readmeUnreadable = true;
+    }
+  }
+  const rendered = renderInjectedReadme(readmeContent, changelogJsonPath, tag, sectionOrder);
+  if (rendered === void 0) {
+    return { renderSkipped: true };
+  }
+  const docsDir = path.join(workspacePath, "docs");
+  const readmePreviewPath = path.join(docsDir, `README.v${version}.md`);
+  const releaseNotesPreviewPath = path.join(docsDir, `RELEASE_NOTES.v${version}.md`);
+  let injectedReadme;
+  if (readmeExists) {
+    injectedReadme = writePreviewFile(readmePreviewPath, rendered.injectedReadme, dryRun);
+  } else {
+    if (!readmeUnreadable) {
+      console.warn(
+        `Warning: ${readmePath} not found; skipping injected-README preview but still writing standalone release notes`
+      );
+    }
+    injectedReadme = { filePath: readmePreviewPath, outcome: "skipped-no-readme" };
+  }
+  const releaseNotesContent = rendered.releaseNotesMarkdown.endsWith("\n") ? rendered.releaseNotesMarkdown : `${rendered.releaseNotesMarkdown}
+`;
+  const releaseNotes = writePreviewFile(releaseNotesPreviewPath, releaseNotesContent, dryRun);
+  return { injectedReadme, releaseNotes, renderSkipped: false };
+}
+function writePreviewFile(filePath, content, dryRun) {
+  if (dryRun) {
+    console.info(dim(`  [dry-run] Would write ${filePath}`));
+    return { filePath, outcome: "dry-run" };
+  }
+  const result = writeFileWithCheck(filePath, content, { dryRun: false, overwrite: true });
+  if (result.outcome === "failed") {
+    console.error(`Error writing ${filePath}: ${result.error ?? "unknown error"}`);
+    return { filePath, outcome: "failed", ...result.error === void 0 ? {} : { error: result.error } };
+  }
+  if (result.outcome === "created" || result.outcome === "overwritten") {
+    console.info(dim(`  Wrote ${filePath}`));
+    return { filePath, outcome: result.outcome };
+  }
+  return { filePath, outcome: "failed", error: `unexpected outcome: ${result.outcome}` };
+}
+export {
+  writeReleaseNotesPreviews
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "4.8.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",
-    "@williamthorsen/node-monorepo-core": "0.2.7"
+    "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/component.d.ts

@@ -1,2 +0,0 @@
-import type { ComponentConfig } from './types.ts';
-export declare function component(workspacePath: string): ComponentConfig;

package/dist/esm/component.js

@@ -1,14 +0,0 @@
-import { basename } from "node:path";
-function component(workspacePath) {
-  const dir = basename(workspacePath);
-  return {
-    dir,
-    tagPrefix: `${dir}-v`,
-    packageFiles: [`${workspacePath}/package.json`],
-    changelogPaths: [workspacePath],
-    paths: [`${workspacePath}/**`]
-  };
-}
-export {
-  component
-};

package/dist/esm/findPackageRoot.d.ts

@@ -1 +0,0 @@
-export declare function findPackageRoot(fromUrl: string): string;

package/dist/esm/findPackageRoot.js

@@ -1,17 +0,0 @@
-import { existsSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-function findPackageRoot(fromUrl) {
-  let dir = dirname(fileURLToPath(fromUrl));
-  while (!existsSync(resolve(dir, "package.json"))) {
-    const parent = dirname(dir);
-    if (parent === dir) {
-      throw new Error("Could not find package root from " + fromUrl);
-    }
-    dir = parent;
-  }
-  return dir;
-}
-export {
-  findPackageRoot
-};

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/githubReleaseCommand.d.ts

@@ -1 +0,0 @@
-export declare function githubReleaseCommand(argv: string[]): Promise<void>;

package/dist/esm/githubReleaseCommand.js

@@ -1,35 +0,0 @@
-import { parseArgs, translateParseError } from "@williamthorsen/node-monorepo-core";
-import { createGithubReleases } from "./createGithubRelease.js";
-import { resolveCommandTags } from "./resolveCommandTags.js";
-import { resolveReleaseNotesConfig } from "./resolveReleaseNotesConfig.js";
-const githubReleaseFlagSchema = {
-  dryRun: { long: "--dry-run", type: "boolean" },
-  only: { long: "--only", type: "string" }
-};
-async function githubReleaseCommand(argv) {
-  let parsed;
-  try {
-    parsed = parseArgs(argv, githubReleaseFlagSchema);
-  } catch (error) {
-    console.error(`Error: ${translateParseError(error)}`);
-    process.exit(1);
-  }
-  const { dryRun } = parsed.flags;
-  const only = parsed.flags.only?.split(",");
-  const resolvedTags = await resolveCommandTags(only);
-  const { releaseNotes, changelogJsonOutputPath } = await resolveReleaseNotesConfig();
-  try {
-    createGithubReleases(
-      resolvedTags,
-      { ...releaseNotes, shouldCreateGithubRelease: true },
-      changelogJsonOutputPath,
-      dryRun
-    );
-  } catch (error) {
-    console.error(`Error creating GitHub Releases: ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
-  }
-}
-export {
-  githubReleaseCommand
-};