@williamthorsen/release-kit 5.4.0 → 7.0.0

package/dist/esm/releasePrepareMono.js

@@ -1,19 +1,11 @@
-import { execSync } from "node:child_process";
+import { execSync } from 'node:child_process';
 import { buildChangelogEntries } from "./buildChangelogEntries.js";
 import { buildDependencyGraph } from "./buildDependencyGraph.js";
 import { buildEmptyReleaseEntry } from "./buildEmptyReleaseEntry.js";
 import { buildSyntheticChangelogEntry } from "./buildSyntheticChangelogEntry.js";
 import { bumpAllVersions, setAllVersions } from "./bumpAllVersions.js";
-import {
-  mergeChangelogEntriesWithDisk,
-  resolveChangelogJsonPath,
-  upsertChangelogJsonAndReturn
-} from "./changelogJsonFile.js";
-import {
-  applyWorkspaceOverrides,
-  createOverrideContext,
-  formatStaleOverrideKeyWarning
-} from "./changelogOverrides.js";
+import { mergeChangelogEntriesWithDisk, resolveChangelogJsonPath, upsertChangelogJsonAndReturn, } from "./changelogJsonFile.js";
+import { applyWorkspaceOverrides, createOverrideContext, formatStaleOverrideKeyWarning, } from "./changelogOverrides.js";
 import { createPolicyViolationCollector } from "./collectPolicyViolations.js";
 import { isForwardVersion } from "./compareVersions.js";
 import { decideRelease } from "./decideRelease.js";
@@ -30,526 +22,475 @@ import { writeChangelogMarkdown } from "./renderChangelogMarkdown.js";
 import { deriveSectionOrder } from "./resolveReleaseNotesConfig.js";
 import { refreshGitCliffCache } from "./runGitCliff.js";
 import { writeReleaseNotesPreviews } from "./writeReleaseNotesPreviews.js";
-function releasePrepareMono(config, options) {
-  const { dryRun, withReleaseNotes } = options;
-  if (withReleaseNotes === true && !config.changelogJson.enabled) {
-    console.warn("Warning: --with-release-notes requires changelogJson.enabled; skipping preview generation");
-  }
-  const sectionOrder = deriveSectionOrder(resolveWorkTypes(config.workTypes));
-  const overrideContext = createOverrideContext(config.workspaces);
-  const { directBumps, directResults, skippedResults, currentVersions } = determineDirectBumps(config, options);
-  const previousTags = /* @__PURE__ */ new Map();
-  for (const result of directResults.values()) {
-    previousTags.set(result.workspace.dir, result.tag);
-  }
-  for (const skipped of skippedResults) {
-    previousTags.set(skipped.workspace.dir, skipped.tag);
-  }
-  const graph = buildDependencyGraph(config.workspaces);
-  const fullReleaseSet = propagateBumps(directBumps, graph, currentVersions);
-  const { sorted: sortedDirs, cyclicDirs } = topologicalSort(fullReleaseSet, graph);
-  const warnings = [];
-  if (cyclicDirs.length > 0) {
-    warnings.push(
-      `Circular workspace dependencies detected among: ${cyclicDirs.join(", ")}. Propagation metadata may be incomplete for these workspaces.`
-    );
-  }
-  const workspaces = collectSkippedWorkspaces(skippedResults, fullReleaseSet);
-  const previewOptions = {
-    enabled: withReleaseNotes === true && config.changelogJson.enabled,
-    sectionOrder
-  };
-  if (fullReleaseSet.size > 0) {
-    refreshGitCliffCache();
-  }
-  const { tags, modifiedFiles } = executeReleaseSet({
-    sortedDirs,
-    fullReleaseSet,
-    config,
-    directResults,
-    previousTags,
-    dryRun,
-    workspaces,
-    previewOptions,
-    overrideContext,
-    sectionOrder
-  });
-  const configOrder = new Map(config.workspaces.map((w, i) => [w.dir, i]));
-  workspaces.sort((a, b) => {
-    const orderA = configOrder.get(a.name ?? "") ?? 0;
-    const orderB = configOrder.get(b.name ?? "") ?? 0;
-    return orderA - orderB;
-  });
-  let project;
-  if (config.project !== void 0) {
-    project = tryStage(
-      "project release stage",
-      () => releasePrepareProject({
+export function releasePrepareMono(config, options) {
+    const { dryRun, withReleaseNotes } = options;
+    if (withReleaseNotes === true && !config.changelogJson.enabled) {
+        console.warn('Warning: --with-release-notes requires changelogJson.enabled; skipping preview generation');
+    }
+    const sectionOrder = deriveSectionOrder(resolveWorkTypes(config.workTypes));
+    const overrideContext = createOverrideContext(config.workspaces);
+    const { directBumps, directResults, skippedResults, currentVersions } = determineDirectBumps(config, options);
+    const previousTags = new Map();
+    for (const result of directResults.values()) {
+        previousTags.set(result.workspace.dir, result.tag);
+    }
+    for (const skipped of skippedResults) {
+        previousTags.set(skipped.workspace.dir, skipped.tag);
+    }
+    const graph = buildDependencyGraph(config.workspaces);
+    const fullReleaseSet = propagateBumps(directBumps, graph, currentVersions);
+    const { sorted: sortedDirs, cyclicDirs } = topologicalSort(fullReleaseSet, graph);
+    const warnings = [];
+    if (cyclicDirs.length > 0) {
+        warnings.push(`Circular workspace dependencies detected among: ${cyclicDirs.join(', ')}. ` +
+            'Propagation metadata may be incomplete for these workspaces.');
+    }
+    const workspaces = collectSkippedWorkspaces(skippedResults, fullReleaseSet);
+    const previewOptions = {
+        enabled: withReleaseNotes === true && config.changelogJson.enabled,
+        sectionOrder,
+    };
+    if (fullReleaseSet.size > 0) {
+        refreshGitCliffCache();
+    }
+    const { tags, modifiedFiles } = executeReleaseSet({
+        sortedDirs,
+        fullReleaseSet,
         config,
-        options,
-        modifiedFiles,
+        directResults,
+        previousTags,
+        dryRun,
+        workspaces,
+        previewOptions,
+        overrideContext,
+        sectionOrder,
+    });
+    const configOrder = new Map(config.workspaces.map((w, i) => [w.dir, i]));
+    workspaces.sort((a, b) => {
+        const orderA = configOrder.get(a.name ?? '') ?? 0;
+        const orderB = configOrder.get(b.name ?? '') ?? 0;
+        return orderA - orderB;
+    });
+    let project;
+    if (config.project !== undefined) {
+        project = tryStage('project release stage', () => releasePrepareProject({
+            config,
+            options,
+            modifiedFiles,
+            tags,
+            rootOverrides: overrideContext.project,
+            overrideWarnings: overrideContext.overrideWarnings,
+            globalMatchedRootKeys: overrideContext.globalMatchedRootKeys,
+        }));
+    }
+    const formatCommand = runFormatCommand(config, tags, modifiedFiles, dryRun);
+    for (const overrideKey of overrideContext.project.keys()) {
+        if (!overrideContext.globalMatchedRootKeys.has(overrideKey)) {
+            overrideContext.overrideWarnings.push(formatStaleOverrideKeyWarning(overrideKey));
+        }
+    }
+    const allWarnings = [...warnings, ...overrideContext.overrideWarnings];
+    return {
+        workspaces,
         tags,
-        rootOverrides: overrideContext.project,
-        overrideWarnings: overrideContext.overrideWarnings,
-        globalMatchedRootKeys: overrideContext.globalMatchedRootKeys
-      })
-    );
-  }
-  const formatCommand = runFormatCommand(config, tags, modifiedFiles, dryRun);
-  for (const overrideKey of overrideContext.project.keys()) {
-    if (!overrideContext.globalMatchedRootKeys.has(overrideKey)) {
-      overrideContext.overrideWarnings.push(formatStaleOverrideKeyWarning(overrideKey));
-    }
-  }
-  const allWarnings = [...warnings, ...overrideContext.overrideWarnings];
-  return {
-    workspaces,
-    tags,
-    formatCommand,
-    dryRun,
-    ...allWarnings.length > 0 ? { warnings: allWarnings } : {},
-    ...project === void 0 ? {} : { project }
-  };
+        formatCommand,
+        dryRun,
+        ...(allWarnings.length > 0 ? { warnings: allWarnings } : {}),
+        ...(project === undefined ? {} : { project }),
+    };
 }
 function determineDirectBumps(config, options) {
-  const { force, bumpOverride, setVersion } = options;
-  if (setVersion !== void 0 && config.workspaces.length !== 1) {
-    throw new Error(`--set-version requires exactly one workspace; received ${config.workspaces.length}`);
-  }
-  const workTypes = config.workTypes ?? { ...DEFAULT_WORK_TYPES };
-  const versionPatterns = config.versionPatterns ?? { ...DEFAULT_VERSION_PATTERNS };
-  const breakingPolicies = config.breakingPolicies ?? DEFAULT_BREAKING_POLICIES;
-  const directBumps = /* @__PURE__ */ new Map();
-  const directResults = /* @__PURE__ */ new Map();
-  const skippedResults = [];
-  const currentVersions = /* @__PURE__ */ new Map();
-  const hintState = { emitted: false };
-  const knownPrefixes = config.workspaces.flatMap(getAllTagPrefixes);
-  for (const workspace of config.workspaces) {
-    const name = workspace.dir;
-    const stageLabel = workspaceStageLabel(workspace.dir);
-    const { tag, commits } = tryStage(
-      stageLabel,
-      () => getCommitsSinceTarget(getAllTagPrefixes(workspace), workspace.paths)
-    );
-    const since = tag === void 0 ? "(no previous release found)" : `since ${tag}`;
-    if (tag === void 0) {
-      maybeEmitBaselineHint(workspace, knownPrefixes, hintState);
-    }
-    const primaryPackageFile = workspace.packageFiles[0];
-    if (primaryPackageFile !== void 0) {
-      const currentVersion = tryStage(stageLabel, () => readCurrentVersion(primaryPackageFile));
-      if (currentVersion !== void 0) {
-        currentVersions.set(workspace.dir, currentVersion);
-      }
-    }
-    if (setVersion !== void 0) {
-      const currentVersion = currentVersions.get(workspace.dir);
-      if (currentVersion === void 0) {
-        throw new Error(
-          `Cannot validate --set-version: failed to read current version from ${primaryPackageFile ?? "(no package file)"}`
-        );
-      }
-      if (!isForwardVersion(currentVersion, setVersion)) {
-        throw new Error(`--set-version ${setVersion} is not greater than current version ${currentVersion}`);
-      }
-      directBumps.set(workspace.dir, { releaseType: "patch", newVersionOverride: setVersion });
-      directResults.set(workspace.dir, {
-        workspace,
-        tag,
-        commits,
-        releaseType: void 0,
-        parsedCommitCount: void 0,
-        unparseableCommits: void 0,
-        policyViolations: void 0,
-        bumpOverride: void 0,
-        setVersion
-      });
-      continue;
-    }
-    const collector = createPolicyViolationCollector();
-    const decision = tryStage(
-      stageLabel,
-      () => decideRelease({
-        commits,
-        force,
-        bumpOverride,
-        workTypes,
-        versionPatterns,
-        scopeAliases: config.scopeAliases,
-        breakingPolicies,
-        onPolicyViolation: collector.onPolicyViolation,
-        skipReasons: {
-          noCommits: `No commits for ${name} ${since}. Pass --force to release at patch. Skipping.`,
-          noBumpWorthy: `No bump-worthy commits for ${name} ${since}. Pass --force to release at patch (or --force --bump=X for a different level). Skipping.`
+    const { force, bumpOverride, setVersion } = options;
+    if (setVersion !== undefined && config.workspaces.length !== 1) {
+        throw new Error(`--set-version requires exactly one workspace; received ${config.workspaces.length}`);
+    }
+    const workTypes = config.workTypes ?? { ...DEFAULT_WORK_TYPES };
+    const versionPatterns = config.versionPatterns ?? { ...DEFAULT_VERSION_PATTERNS };
+    const breakingPolicies = config.breakingPolicies ?? DEFAULT_BREAKING_POLICIES;
+    const directBumps = new Map();
+    const directResults = new Map();
+    const skippedResults = [];
+    const currentVersions = new Map();
+    const hintState = { emitted: false };
+    const knownPrefixes = config.workspaces.flatMap(getAllTagPrefixes);
+    for (const workspace of config.workspaces) {
+        const name = workspace.dir;
+        const stageLabel = workspaceStageLabel(workspace.dir);
+        const { tag, commits } = tryStage(stageLabel, () => getCommitsSinceTarget(getAllTagPrefixes(workspace), workspace.paths));
+        const since = tag === undefined ? '(no previous release found)' : `since ${tag}`;
+        if (tag === undefined) {
+            maybeEmitBaselineHint(workspace, knownPrefixes, hintState);
         }
-      })
-    );
-    const policyViolations = collector.violations.length > 0 ? collector.violations : void 0;
-    if (decision.outcome === "skip") {
-      skippedResults.push({
-        workspace,
-        tag,
-        commitCount: commits.length,
-        parsedCommitCount: decision.parsedCommitCount,
-        unparseableCommits: decision.unparseableCommits,
-        policyViolations,
-        skipReason: decision.skipReason
-      });
-      continue;
-    }
-    directBumps.set(workspace.dir, { releaseType: decision.releaseType });
-    directResults.set(workspace.dir, {
-      workspace,
-      tag,
-      commits,
-      releaseType: decision.releaseType,
-      parsedCommitCount: decision.parsedCommitCount,
-      unparseableCommits: decision.unparseableCommits,
-      policyViolations,
-      bumpOverride
-    });
-  }
-  return { directBumps, directResults, skippedResults, currentVersions };
+        const primaryPackageFile = workspace.packageFiles[0];
+        if (primaryPackageFile !== undefined) {
+            const currentVersion = tryStage(stageLabel, () => readCurrentVersion(primaryPackageFile));
+            if (currentVersion !== undefined) {
+                currentVersions.set(workspace.dir, currentVersion);
+            }
+        }
+        if (setVersion !== undefined) {
+            const currentVersion = currentVersions.get(workspace.dir);
+            if (currentVersion === undefined) {
+                throw new Error(`Cannot validate --set-version: failed to read current version from ${primaryPackageFile ?? '(no package file)'}`);
+            }
+            if (!isForwardVersion(currentVersion, setVersion)) {
+                throw new Error(`--set-version ${setVersion} is not greater than current version ${currentVersion}`);
+            }
+            directBumps.set(workspace.dir, { releaseType: 'patch', newVersionOverride: setVersion });
+            directResults.set(workspace.dir, {
+                workspace,
+                tag,
+                commits,
+                releaseType: undefined,
+                parsedCommitCount: undefined,
+                unparseableCommits: undefined,
+                policyViolations: undefined,
+                bumpOverride: undefined,
+                setVersion,
+            });
+            continue;
+        }
+        const collector = createPolicyViolationCollector();
+        const decision = tryStage(stageLabel, () => decideRelease({
+            commits,
+            force,
+            bumpOverride,
+            workTypes,
+            versionPatterns,
+            scopeAliases: config.scopeAliases,
+            breakingPolicies,
+            onPolicyViolation: collector.onPolicyViolation,
+            skipReasons: {
+                noCommits: `No commits for ${name} ${since}. Pass --force to release at patch. Skipping.`,
+                noBumpWorthy: `No bump-worthy commits for ${name} ${since}. Pass --force to release at patch (or --force --bump=X for a different level). Skipping.`,
+            },
+        }));
+        const policyViolations = collector.violations.length > 0 ? collector.violations : undefined;
+        if (decision.outcome === 'skip') {
+            skippedResults.push({
+                workspace,
+                tag,
+                commitCount: commits.length,
+                parsedCommitCount: decision.parsedCommitCount,
+                unparseableCommits: decision.unparseableCommits,
+                policyViolations,
+                skipReason: decision.skipReason,
+            });
+            continue;
+        }
+        directBumps.set(workspace.dir, { releaseType: decision.releaseType });
+        directResults.set(workspace.dir, {
+            workspace,
+            tag,
+            commits,
+            releaseType: decision.releaseType,
+            parsedCommitCount: decision.parsedCommitCount,
+            unparseableCommits: decision.unparseableCommits,
+            policyViolations,
+            bumpOverride,
+        });
+    }
+    return { directBumps, directResults, skippedResults, currentVersions };
 }
 function collectSkippedWorkspaces(skippedResults, fullReleaseSet) {
-  const workspaces = [];
-  for (const skipped of skippedResults) {
-    if (fullReleaseSet.has(skipped.workspace.dir)) {
-      continue;
-    }
-    const result = {
-      name: skipped.workspace.dir,
-      status: "skipped",
-      commitCount: skipped.commitCount,
-      skipReason: skipped.skipReason
-    };
-    if (skipped.tag !== void 0) {
-      result.previousTag = skipped.tag;
-    }
-    if (skipped.parsedCommitCount !== void 0) {
-      result.parsedCommitCount = skipped.parsedCommitCount;
-    }
-    if (skipped.unparseableCommits !== void 0) {
-      result.unparseableCommits = skipped.unparseableCommits;
-    }
-    if (skipped.policyViolations !== void 0) {
-      result.policyViolations = skipped.policyViolations;
+    const workspaces = [];
+    for (const skipped of skippedResults) {
+        if (fullReleaseSet.has(skipped.workspace.dir)) {
+            continue;
+        }
+        const result = {
+            name: skipped.workspace.dir,
+            status: 'skipped',
+            commitCount: skipped.commitCount,
+            skipReason: skipped.skipReason,
+        };
+        if (skipped.tag !== undefined) {
+            result.previousTag = skipped.tag;
+        }
+        if (skipped.parsedCommitCount !== undefined) {
+            result.parsedCommitCount = skipped.parsedCommitCount;
+        }
+        if (skipped.unparseableCommits !== undefined) {
+            result.unparseableCommits = skipped.unparseableCommits;
+        }
+        if (skipped.policyViolations !== undefined) {
+            result.policyViolations = skipped.policyViolations;
+        }
+        workspaces.push(result);
     }
-    workspaces.push(result);
-  }
-  return workspaces;
+    return workspaces;
 }
 function executeReleaseSet(args) {
-  const {
-    sortedDirs,
-    fullReleaseSet,
-    config,
-    directResults,
-    previousTags,
-    dryRun,
-    workspaces,
-    previewOptions,
-    overrideContext,
-    sectionOrder
-  } = args;
-  const tags = [];
-  const modifiedFiles = [];
-  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  for (const dir of sortedDirs) {
-    const releaseEntry = fullReleaseSet.get(dir);
-    if (releaseEntry === void 0) {
-      continue;
-    }
-    const workspace = findWorkspace(config.workspaces, dir);
-    if (workspace === void 0) {
-      continue;
-    }
-    tryStage(
-      workspaceStageLabel(dir),
-      () => executeWorkspaceRelease({
-        dir,
+    const { sortedDirs, fullReleaseSet, config, directResults, previousTags, dryRun, workspaces, previewOptions, overrideContext, sectionOrder, } = args;
+    const tags = [];
+    const modifiedFiles = [];
+    const today = new Date().toISOString().slice(0, 10);
+    for (const dir of sortedDirs) {
+        const releaseEntry = fullReleaseSet.get(dir);
+        if (releaseEntry === undefined) {
+            continue;
+        }
+        const workspace = findWorkspace(config.workspaces, dir);
+        if (workspace === undefined) {
+            continue;
+        }
+        tryStage(workspaceStageLabel(dir), () => executeWorkspaceRelease({
+            dir,
+            workspace,
+            releaseEntry,
+            directResult: directResults.get(dir),
+            previousTags,
+            config,
+            dryRun,
+            today,
+            tags,
+            modifiedFiles,
+            workspaces,
+            previewOptions,
+            overrideContext,
+            sectionOrder,
+        }));
+    }
+    return { tags, modifiedFiles };
+}
+function executeWorkspaceRelease(args) {
+    const { dir, workspace, releaseEntry, directResult, previousTags, config, dryRun, today, tags, modifiedFiles, workspaces, previewOptions, overrideContext, sectionOrder, } = args;
+    const setVersionTarget = directResult?.setVersion;
+    const bump = setVersionTarget === undefined
+        ? bumpAllVersions(workspace.packageFiles, releaseEntry.releaseType, dryRun)
+        : setAllVersions(workspace.packageFiles, setVersionTarget, dryRun);
+    const newTag = `${workspace.tagPrefix}${bump.newVersion}`;
+    tags.push(newTag);
+    modifiedFiles.push(...workspace.packageFiles, ...workspace.changelogPaths.map((p) => `${p}/CHANGELOG.md`));
+    const isPropagationOnly = directResult === undefined;
+    const isEmptyRange = directResult !== undefined && directResult.commits.length === 0;
+    const changelogFiles = generateWorkspaceChangelogs({
         workspace,
         releaseEntry,
-        directResult: directResults.get(dir),
-        previousTags,
+        newTag,
+        newVersion: bump.newVersion,
+        isPropagationOnly,
+        isEmptyRange,
         config,
         dryRun,
         today,
-        tags,
         modifiedFiles,
-        workspaces,
         previewOptions,
         overrideContext,
-        sectionOrder
-      })
-    );
-  }
-  return { tags, modifiedFiles };
-}
-function executeWorkspaceRelease(args) {
-  const {
-    dir,
-    workspace,
-    releaseEntry,
-    directResult,
-    previousTags,
-    config,
-    dryRun,
-    today,
-    tags,
-    modifiedFiles,
-    workspaces,
-    previewOptions,
-    overrideContext,
-    sectionOrder
-  } = args;
-  const setVersionTarget = directResult?.setVersion;
-  const bump = setVersionTarget === void 0 ? bumpAllVersions(workspace.packageFiles, releaseEntry.releaseType, dryRun) : setAllVersions(workspace.packageFiles, setVersionTarget, dryRun);
-  const newTag = `${workspace.tagPrefix}${bump.newVersion}`;
-  tags.push(newTag);
-  modifiedFiles.push(...workspace.packageFiles, ...workspace.changelogPaths.map((p) => `${p}/CHANGELOG.md`));
-  const isPropagationOnly = directResult === void 0;
-  const isEmptyRange = directResult !== void 0 && directResult.commits.length === 0;
-  const changelogFiles = generateWorkspaceChangelogs({
-    workspace,
-    releaseEntry,
-    newTag,
-    newVersion: bump.newVersion,
-    isPropagationOnly,
-    isEmptyRange,
-    config,
-    dryRun,
-    today,
-    modifiedFiles,
-    previewOptions,
-    overrideContext,
-    sectionOrder
-  });
-  const released = {
-    name: dir,
-    status: "released",
-    commitCount: directResult?.commits.length ?? 0,
-    currentVersion: bump.currentVersion,
-    newVersion: bump.newVersion,
-    tag: newTag,
-    bumpedFiles: bump.files,
-    changelogFiles
-  };
-  attachReleasedWorkspaceOptionals(released, {
-    previousTag: directResult?.tag ?? previousTags.get(dir),
-    directResult,
-    releaseEntry,
-    setVersionTarget
-  });
-  workspaces.push(released);
+        sectionOrder,
+    });
+    const released = {
+        name: dir,
+        status: 'released',
+        commitCount: directResult?.commits.length ?? 0,
+        currentVersion: bump.currentVersion,
+        newVersion: bump.newVersion,
+        tag: newTag,
+        bumpedFiles: bump.files,
+        changelogFiles,
+    };
+    attachReleasedWorkspaceOptionals(released, {
+        previousTag: directResult?.tag ?? previousTags.get(dir),
+        directResult,
+        releaseEntry,
+        setVersionTarget,
+    });
+    workspaces.push(released);
 }
 function attachReleasedWorkspaceOptionals(released, args) {
-  const { previousTag, directResult, releaseEntry, setVersionTarget } = args;
-  if (previousTag !== void 0) {
-    released.previousTag = previousTag;
-  }
-  if (directResult?.parsedCommitCount !== void 0) {
-    released.parsedCommitCount = directResult.parsedCommitCount;
-  }
-  if (setVersionTarget === void 0) {
-    released.releaseType = releaseEntry.releaseType;
-  }
-  if (directResult?.commits !== void 0) {
-    released.commits = directResult.commits;
-  }
-  if (directResult?.unparseableCommits !== void 0) {
-    released.unparseableCommits = directResult.unparseableCommits;
-  }
-  if (directResult?.policyViolations !== void 0) {
-    released.policyViolations = directResult.policyViolations;
-  }
-  if (releaseEntry.propagatedFrom !== void 0) {
-    released.propagatedFrom = releaseEntry.propagatedFrom;
-  }
-  if (directResult?.bumpOverride !== void 0) {
-    released.bumpOverride = directResult.bumpOverride;
-  }
-  if (setVersionTarget !== void 0) {
-    released.setVersion = setVersionTarget;
-  }
+    const { previousTag, directResult, releaseEntry, setVersionTarget } = args;
+    if (previousTag !== undefined) {
+        released.previousTag = previousTag;
+    }
+    if (directResult?.parsedCommitCount !== undefined) {
+        released.parsedCommitCount = directResult.parsedCommitCount;
+    }
+    if (setVersionTarget === undefined) {
+        released.releaseType = releaseEntry.releaseType;
+    }
+    if (directResult?.commits !== undefined) {
+        released.commits = directResult.commits;
+    }
+    if (directResult?.unparseableCommits !== undefined) {
+        released.unparseableCommits = directResult.unparseableCommits;
+    }
+    if (directResult?.policyViolations !== undefined) {
+        released.policyViolations = directResult.policyViolations;
+    }
+    if (releaseEntry.propagatedFrom !== undefined) {
+        released.propagatedFrom = releaseEntry.propagatedFrom;
+    }
+    if (directResult?.bumpOverride !== undefined) {
+        released.bumpOverride = directResult.bumpOverride;
+    }
+    if (setVersionTarget !== undefined) {
+        released.setVersion = setVersionTarget;
+    }
 }
 function generateWorkspaceChangelogs(args) {
-  const {
-    workspace,
-    releaseEntry,
-    newTag,
-    newVersion,
-    isPropagationOnly,
-    isEmptyRange,
-    config,
-    dryRun,
-    today,
-    modifiedFiles,
-    previewOptions,
-    overrideContext,
-    sectionOrder
-  } = args;
-  const newEntries = buildWorkspaceEntries({
-    workspace,
-    releaseEntry,
-    newTag,
-    newVersion,
-    isPropagationOnly,
-    isEmptyRange,
-    config,
-    today
-  });
-  const applied = applyWorkspaceOverrides(newEntries, workspace.workspacePath, overrideContext);
-  const changelogFiles = [];
-  let firstChangelogJsonPath;
-  for (const changelogPath of workspace.changelogPaths) {
-    const jsonPath = resolveChangelogJsonPath(config, changelogPath);
-    const shouldWriteJson = config.changelogJson.enabled && !dryRun;
-    const mergedEntries = shouldWriteJson ? upsertChangelogJsonAndReturn(jsonPath, applied.entries) : mergeChangelogEntriesWithDisk(jsonPath, applied.entries);
-    if (config.changelogJson.enabled) {
-      modifiedFiles.push(jsonPath);
-      firstChangelogJsonPath ??= jsonPath;
-    }
-    changelogFiles.push(
-      writeChangelogMarkdown({
-        changelogPath,
-        entries: mergedEntries,
-        sectionOrder,
-        dryRun
-      })
-    );
-  }
-  maybeWritePreviews(workspace, newTag, firstChangelogJsonPath, previewOptions, dryRun);
-  return changelogFiles;
+    const { workspace, releaseEntry, newTag, newVersion, isPropagationOnly, isEmptyRange, config, dryRun, today, modifiedFiles, previewOptions, overrideContext, sectionOrder, } = args;
+    const newEntries = buildWorkspaceEntries({
+        workspace,
+        releaseEntry,
+        newTag,
+        newVersion,
+        isPropagationOnly,
+        isEmptyRange,
+        config,
+        today,
+    });
+    const applied = applyWorkspaceOverrides(newEntries, workspace.workspacePath, overrideContext);
+    const changelogFiles = [];
+    let firstChangelogJsonPath;
+    for (const changelogPath of workspace.changelogPaths) {
+        const jsonPath = resolveChangelogJsonPath(config, changelogPath);
+        const shouldWriteJson = config.changelogJson.enabled && !dryRun;
+        const mergedEntries = shouldWriteJson
+            ? upsertChangelogJsonAndReturn(jsonPath, applied.entries)
+            : mergeChangelogEntriesWithDisk(jsonPath, applied.entries);
+        if (config.changelogJson.enabled) {
+            modifiedFiles.push(jsonPath);
+            firstChangelogJsonPath ??= jsonPath;
+        }
+        changelogFiles.push(writeChangelogMarkdown({
+            changelogPath,
+            entries: mergedEntries,
+            sectionOrder,
+            dryRun,
+        }));
+    }
+    maybeWritePreviews(workspace, newTag, firstChangelogJsonPath, previewOptions, dryRun);
+    return changelogFiles;
 }
 function buildWorkspaceEntries(args) {
-  const { workspace, releaseEntry, newTag, newVersion, isPropagationOnly, isEmptyRange, config, today } = args;
-  if (isPropagationOnly && releaseEntry.propagatedFrom !== void 0) {
-    return [buildSyntheticChangelogEntry(releaseEntry.propagatedFrom, newVersion, today)];
-  }
-  if (isEmptyRange) {
-    return [buildEmptyReleaseEntry(newVersion, today)];
-  }
-  const tagPattern = buildTagPattern(getAllTagPrefixes(workspace));
-  return buildChangelogEntries(config, newTag, { tagPattern, includePaths: workspace.paths });
+    const { workspace, releaseEntry, newTag, newVersion, isPropagationOnly, isEmptyRange, config, today } = args;
+    if (isPropagationOnly && releaseEntry.propagatedFrom !== undefined) {
+        return [buildSyntheticChangelogEntry(releaseEntry.propagatedFrom, newVersion, today)];
+    }
+    if (isEmptyRange) {
+        return [buildEmptyReleaseEntry(newVersion, today)];
+    }
+    const tagPattern = buildTagPattern(getAllTagPrefixes(workspace));
+    return buildChangelogEntries(config, newTag, { tagPattern, includePaths: workspace.paths });
 }
 function maybeWritePreviews(workspace, newTag, changelogJsonPath, previewOptions, dryRun) {
-  if (!previewOptions.enabled || changelogJsonPath === void 0) {
-    return;
-  }
-  writeReleaseNotesPreviews({
-    workspacePath: workspace.workspacePath,
-    tag: newTag,
-    changelogJsonPath,
-    sectionOrder: previewOptions.sectionOrder,
-    dryRun
-  });
+    if (!previewOptions.enabled || changelogJsonPath === undefined) {
+        return;
+    }
+    writeReleaseNotesPreviews({
+        workspacePath: workspace.workspacePath,
+        tag: newTag,
+        changelogJsonPath,
+        sectionOrder: previewOptions.sectionOrder,
+        dryRun,
+    });
 }
 function runFormatCommand(config, tags, modifiedFiles, dryRun) {
-  const formatCommandStr = config.formatCommand ?? (hasPrettierConfig() ? "npx prettier --write" : void 0);
-  if (tags.length === 0 || formatCommandStr === void 0) {
-    return void 0;
-  }
-  const fullCommand = `${formatCommandStr} ${modifiedFiles.join(" ")}`;
-  if (dryRun) {
-    return { command: fullCommand, executed: false, files: modifiedFiles };
-  }
-  try {
-    execSync(fullCommand, { stdio: "inherit" });
-  } catch (error) {
-    const baseMessage = error instanceof Error ? error.message : String(error);
-    throw new Error(`format stage: ${baseMessage} (command: '${fullCommand}')`, { cause: error });
-  }
-  return { command: fullCommand, executed: true, files: modifiedFiles };
+    const formatCommandStr = config.formatCommand ?? (hasPrettierConfig() ? 'npx prettier --write' : undefined);
+    if (tags.length === 0 || formatCommandStr === undefined) {
+        return undefined;
+    }
+    const fullCommand = `${formatCommandStr} ${modifiedFiles.join(' ')}`;
+    if (dryRun) {
+        return { command: fullCommand, executed: false, files: modifiedFiles };
+    }
+    try {
+        execSync(fullCommand, { stdio: 'inherit' });
+    }
+    catch (error) {
+        const baseMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`format stage: ${baseMessage} (command: '${fullCommand}')`, { cause: error });
+    }
+    return { command: fullCommand, executed: true, files: modifiedFiles };
 }
 function findWorkspace(workspaces, dir) {
-  return workspaces.find((w) => w.dir === dir);
+    return workspaces.find((w) => w.dir === dir);
 }
 function wrapStageError(stageLabel, error) {
-  const message = error instanceof Error ? error.message : String(error);
-  return new Error(`${stageLabel}: ${message}`, { cause: error });
+    const message = error instanceof Error ? error.message : String(error);
+    return new Error(`${stageLabel}: ${message}`, { cause: error });
 }
 function tryStage(stageLabel, fn) {
-  try {
-    return fn();
-  } catch (error) {
-    throw wrapStageError(stageLabel, error);
-  }
+    try {
+        return fn();
+    }
+    catch (error) {
+        throw wrapStageError(stageLabel, error);
+    }
 }
 function workspaceStageLabel(dir) {
-  return `workspace '${dir}' release stage`;
+    return `workspace '${dir}' release stage`;
 }
 function maybeEmitBaselineHint(workspace, knownPrefixes, state) {
-  if (state.emitted) return;
-  if ((workspace.legacyIdentities?.length ?? 0) > 0) return;
-  const candidates = detectUndeclaredTagPrefixes(knownPrefixes);
-  if (candidates.length === 0) return;
-  const totalTags = candidates.reduce((sum, candidate) => sum + candidate.tagCount, 0);
-  const example = candidates[0]?.exampleTags[0] ?? `${candidates[0]?.prefix ?? ""}?`;
-  console.error(
-    `Hint: no baseline tag found for ${workspace.dir} under '${workspace.tagPrefix}', but ${totalTags} candidate-shaped tags exist (e.g., ${example}). Run 'release-kit show-tag-prefixes' to check for undeclared legacy prefixes.`
-  );
-  state.emitted = true;
+    if (state.emitted)
+        return;
+    if ((workspace.legacyIdentities?.length ?? 0) > 0)
+        return;
+    const candidates = detectUndeclaredTagPrefixes(knownPrefixes);
+    if (candidates.length === 0)
+        return;
+    const totalTags = candidates.reduce((sum, candidate) => sum + candidate.tagCount, 0);
+    const example = candidates[0]?.exampleTags[0] ?? `${candidates[0]?.prefix ?? ''}?`;
+    process.stderr.write(`Hint: no baseline tag found for ${workspace.dir} under '${workspace.tagPrefix}', but ` +
+        `${totalTags} candidate-shaped tags exist (e.g., ${example}). ` +
+        "Run 'release-kit show-tag-prefixes' to check for undeclared legacy prefixes.\n");
+    state.emitted = true;
 }
 function topologicalSort(releaseSet, graph) {
-  const releaseDirs = new Set(releaseSet.keys());
-  if (releaseDirs.size === 0) {
-    return { sorted: [], cyclicDirs: [] };
-  }
-  const inDegree = /* @__PURE__ */ new Map();
-  const forwardEdges = /* @__PURE__ */ new Map();
-  for (const dir of releaseDirs) {
-    inDegree.set(dir, 0);
-    forwardEdges.set(dir, []);
-  }
-  for (const [packageName, dependents] of graph.dependentsOf) {
-    const depDir = graph.packageNameToDir.get(packageName);
-    if (depDir === void 0 || !releaseDirs.has(depDir)) {
-      continue;
-    }
-    for (const dependent of dependents) {
-      if (!releaseDirs.has(dependent.dir)) {
-        continue;
-      }
-      const edges = forwardEdges.get(depDir);
-      if (edges !== void 0) {
-        edges.push(dependent.dir);
-      }
-      inDegree.set(dependent.dir, (inDegree.get(dependent.dir) ?? 0) + 1);
-    }
-  }
-  const queue = [];
-  for (const [dir, degree] of inDegree) {
-    if (degree === 0) {
-      queue.push(dir);
-    }
-  }
-  const sorted = [];
-  while (queue.length > 0) {
-    const dir = queue.shift();
-    if (dir === void 0) {
-      break;
-    }
-    sorted.push(dir);
-    for (const dependent of forwardEdges.get(dir) ?? []) {
-      const newDegree = (inDegree.get(dependent) ?? 1) - 1;
-      inDegree.set(dependent, newDegree);
-      if (newDegree === 0) {
-        queue.push(dependent);
-      }
-    }
-  }
-  const sortedSet = new Set(sorted);
-  const cyclicDirs = [];
-  for (const dir of releaseDirs) {
-    if (!sortedSet.has(dir)) {
-      sorted.push(dir);
-      cyclicDirs.push(dir);
-    }
-  }
-  return { sorted, cyclicDirs };
+    const releaseDirs = new Set(releaseSet.keys());
+    if (releaseDirs.size === 0) {
+        return { sorted: [], cyclicDirs: [] };
+    }
+    const inDegree = new Map();
+    const forwardEdges = new Map();
+    for (const dir of releaseDirs) {
+        inDegree.set(dir, 0);
+        forwardEdges.set(dir, []);
+    }
+    for (const [packageName, dependents] of graph.dependentsOf) {
+        const depDir = graph.packageNameToDir.get(packageName);
+        if (depDir === undefined || !releaseDirs.has(depDir)) {
+            continue;
+        }
+        for (const dependent of dependents) {
+            if (!releaseDirs.has(dependent.dir)) {
+                continue;
+            }
+            const edges = forwardEdges.get(depDir);
+            if (edges !== undefined) {
+                edges.push(dependent.dir);
+            }
+            inDegree.set(dependent.dir, (inDegree.get(dependent.dir) ?? 0) + 1);
+        }
+    }
+    const queue = [];
+    for (const [dir, degree] of inDegree) {
+        if (degree === 0) {
+            queue.push(dir);
+        }
+    }
+    const sorted = [];
+    while (queue.length > 0) {
+        const dir = queue.shift();
+        if (dir === undefined) {
+            break;
+        }
+        sorted.push(dir);
+        for (const dependent of forwardEdges.get(dir) ?? []) {
+            const newDegree = (inDegree.get(dependent) ?? 1) - 1;
+            inDegree.set(dependent, newDegree);
+            if (newDegree === 0) {
+                queue.push(dependent);
+            }
+        }
+    }
+    const sortedSet = new Set(sorted);
+    const cyclicDirs = [];
+    for (const dir of releaseDirs) {
+        if (!sortedSet.has(dir)) {
+            sorted.push(dir);
+            cyclicDirs.push(dir);
+        }
+    }
+    return { sorted, cyclicDirs };
 }
-export {
-  releasePrepareMono
-};