@modulify/conventional-release 0.1.0 → 0.1.2

package/dist/index.mjs

@@ -1,712 +1,53 @@
-import { existsSync, readFileSync } from "node:fs";
-import { join, relative } from "node:path";
-import { pathToFileURL } from "node:url";
-import { Client, createChangesetTraverser } from "@modulify/conventional-git";
-import { writeChangelog, renderChangelog, createChangelogCapacitor } from "@modulify/conventional-changelog";
-import { GitCommander } from "@modulify/git-toolkit";
-import { Runner } from "@modulify/git-toolkit/shell";
-import { read, walk, update } from "@modulify/pkg";
-import { resolveNextVersion, createRecommendationAnalyzer } from "@modulify/conventional-bump";
-function createRunContext({
-  cwd,
-  dry
-}) {
-  return { cwd, dry };
-}
-async function reportStart(reporter, context) {
-  await reporter?.onStart?.(context);
-}
-async function reportScope(reporter, scope, context) {
-  await reporter?.onScope?.(scope, context);
-}
-async function reportSliceStart(reporter, slice, context) {
-  await reporter?.onSliceStart?.(slice, context);
-}
-async function reportSliceSuccess(reporter, slice, context) {
-  await reporter?.onSliceSuccess?.(slice, context);
-}
-async function reportSuccess(reporter, result, context) {
-  await reporter?.onSuccess?.(result, context);
-}
-async function reportError(reporter, error, context) {
-  await reporter?.onError?.(error, context);
-}
-const DEFAULT_CHANGELOG_FILE = "CHANGELOG.md";
-const DEFAULT_RELEASE_PREFIX = "chore(release): ";
-const DEFAULT_RELEASE_MODE = "sync";
-const DEFAULT_DEPENDENCY_POLICY_INTERNAL = "preserve";
-const RELEASE_CONFIG_FILENAMES = [
-  "release.config.ts",
-  "release.config.mjs",
-  "release.config.js"
-];
-async function resolveConfig(cwd, inline) {
-  const root = cwd ?? process.cwd();
-  const fromPackage = loadPackageJsonConfig(root);
-  const fromFile = await loadFileConfig(root);
-  return {
-    ...fromPackage,
-    ...fromFile,
-    ...inline ?? {}
-  };
-}
-function toScopeOptions(config) {
-  const options = { ...config };
-  delete options.changelogFile;
-  return options;
-}
-function toInlineConfig(options) {
-  const config = { ...options };
-  delete config.cwd;
-  delete config.dry;
-  delete config.reporter;
-  return config;
-}
-function loadPackageJsonConfig(cwd) {
-  const file = join(cwd, "package.json");
-  if (!existsSync(file)) {
-    return {};
-  }
-  const content = JSON.parse(readFileSync(file, "utf-8"));
-  return isRecord(content.release) ? content.release : {};
-}
-async function loadFileConfig(cwd) {
-  const configFile = RELEASE_CONFIG_FILENAMES.map((file) => join(cwd, file)).find((file) => existsSync(file));
-  if (!configFile) {
-    return {};
-  }
-  const module = await import(pathToFileURL(configFile).href);
-  const config = module.default ?? module;
-  return isRecord(config) ? config : {};
-}
-function isRecord(value) {
-  return !!value && typeof value === "object";
-}
-function createRuntime({
-  cwd = process.cwd(),
-  dry = false,
-  changelogFile = DEFAULT_CHANGELOG_FILE
-} = {}) {
-  const sh = new Runner(cwd);
-  return {
-    cwd,
-    dry,
-    changelogFile,
-    packageManager: resolvePackageManager(cwd),
-    history: new Client({ cwd }),
-    writeChangelog: (changes) => writeChangelog(changes, {
-      file: dry ? void 0 : join(cwd, changelogFile)
-    }),
-    sh,
-    git: createGit(sh)
-  };
-}
-function createGit(sh) {
-  const git = new GitCommander({ sh });
-  return {
-    add: (files) => git.add(files),
-    commit: (options) => git.commit(options),
-    tag: (options) => git.tag(options)
-  };
-}
-function resolvePackageManager(cwd) {
-  const command = readPackageManager(cwd) ?? inferPackageManagerFromLockfile(cwd) ?? "npm";
-  return {
-    command,
-    lockfile: resolveLockfile(cwd, command)
-  };
-}
-function readPackageManager(cwd) {
-  const file = join(cwd, "package.json");
-  if (!existsSync(file)) {
-    return null;
-  }
-  const content = JSON.parse(readFileSync(file, "utf-8"));
-  if (typeof content.packageManager !== "string" || content.packageManager === "") {
-    return null;
-  }
-  const [name] = content.packageManager.split("@");
-  return isPackageManagerName(name) ? name : null;
-}
-function inferPackageManagerFromLockfile(cwd) {
-  if (existsSync(join(cwd, "yarn.lock"))) return "yarn";
-  if (existsSync(join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync(join(cwd, "package-lock.json"))) return "npm";
-  if (existsSync(join(cwd, "bun.lock"))) return "bun";
-  if (existsSync(join(cwd, "bun.lockb"))) return "bun";
-  return null;
-}
-function resolveLockfile(cwd, command) {
-  if (command === "bun" && existsSync(join(cwd, "bun.lockb"))) {
-    return "bun.lockb";
-  }
-  return {
-    yarn: "yarn.lock",
-    pnpm: "pnpm-lock.yaml",
-    npm: "package-lock.json",
-    bun: "bun.lock"
-  }[command];
-}
-function isPackageManagerName(value) {
-  return value === "yarn" || value === "pnpm" || value === "npm" || value === "bun";
-}
-function toScope(scope, cwd) {
-  return {
-    mode: scope.mode,
-    packages: scope.packages.map((pkg) => toScopePackage(pkg, cwd)),
-    affected: scope.affected.map((pkg) => toScopePackage(pkg, cwd)),
-    slices: scope.slices.map((slice) => toSlice(slice, cwd))
-  };
-}
-async function discover(runtime, options) {
-  const root = read(runtime.cwd);
-  const packages = [];
-  await walk([root], async (pkg) => {
-    packages.push(pkg);
-  });
-  const discovered = sortPackages(
-    uniquePackages(
-      applyWorkspaceFilters(packages, runtime.cwd, options.workspaces)
-    ),
-    runtime.cwd
-  );
-  const mode = options.mode ?? DEFAULT_RELEASE_MODE;
-  const affectedPaths = mode === "hybrid" ? null : await detectAffectedPackages({
-    cwd: runtime.cwd,
-    root,
-    packages: discovered,
-    history: runtime.history,
-    range: {
-      fromTag: options.fromTag,
-      tagPrefix: options.tagPrefix
-    }
-  });
-  const affected = affectedPaths ? sortPackages(
-    uniquePackages(
-      discovered.filter((pkg) => affectedPaths.has(pkg.path))
-    ),
-    runtime.cwd
-  ) : [];
-  const slices = mode === "hybrid" ? await createHybridSlices({
-    root,
-    packages: discovered,
-    cwd: runtime.cwd,
-    history: runtime.history,
-    fromTag: options.fromTag,
-    tagPrefix: options.tagPrefix,
-    partitions: options.partitions
-  }) : createSlices({
-    mode,
-    affected,
-    cwd: runtime.cwd,
-    fromTag: options.fromTag,
-    tagPrefix: options.tagPrefix
-  });
-  const discoveredAffected = mode === "hybrid" ? sortPackages(
-    uniquePackages(
-      slices.flatMap((slice) => slice.packages)
-    ),
-    runtime.cwd
-  ) : affected;
-  return {
-    mode,
-    packages: discovered,
-    affected: discoveredAffected,
-    slices
-  };
-}
-function toScopePackage(pkg, cwd) {
-  return {
-    name: pkg.manifest.name ?? pkg.name,
-    version: pkg.manifest.version,
-    path: toPublicPath(pkg, cwd)
-  };
-}
-function toSlice(slice, cwd) {
-  return {
-    id: slice.id,
-    kind: slice.kind,
-    mode: slice.mode,
-    partition: slice.partition,
-    packages: slice.packages.map((pkg) => toScopePackage(pkg, cwd)),
-    range: slice.range
-  };
-}
-function uniquePackages(packages) {
-  const seen = /* @__PURE__ */ new Set();
-  return packages.filter((pkg) => {
-    if (seen.has(pkg.path)) {
-      return false;
-    }
-    seen.add(pkg.path);
-    return true;
-  });
-}
-function uniqueStrings(values) {
-  return [...new Set(values)];
-}
-function packageIdentity(pkg, cwd) {
-  const name = pkg.manifest.name ?? pkg.name;
-  if (name) {
-    return name;
-  }
-  const path = packagePath(pkg, cwd);
-  return path === "" || path === "." ? "root" : path;
-}
-function createSlices({
-  mode,
-  affected,
-  cwd,
-  fromTag,
-  tagPrefix
-}) {
-  const touched = affected;
-  if (mode === "sync") {
-    return touched.length ? [{
-      id: "sync:default",
-      kind: "sync",
-      mode: "sync",
-      packages: touched,
-      range: {
-        fromTag,
-        tagPrefix
-      }
-    }] : [];
-  }
-  return touched.map((pkg) => ({
-    id: `async:${packageIdentity(pkg, cwd)}`,
-    kind: "async",
-    mode: "async",
-    packages: [pkg],
-    range: {
-      fromTag,
-      tagPrefix
-    }
-  }));
-}
-async function createHybridSlices({
-  root,
-  packages,
-  cwd,
-  history,
-  fromTag,
-  tagPrefix,
-  partitions
-}) {
-  const partitionEntries = Object.entries(partitions ?? {}).sort(([a], [b]) => a.localeCompare(b));
-  const partitioned = [];
-  const usedPaths = /* @__PURE__ */ new Set();
-  for (const [partition, definition] of partitionEntries) {
-    const matched = sortPackages(
-      packages.filter((pkg) => {
-        if (usedPaths.has(pkg.path)) {
-          return false;
-        }
-        return definition.workspaces.some((selector) => matchesPackageSelector(pkg, cwd, selector));
-      }),
-      cwd
-    );
-    for (const pkg of matched) {
-      usedPaths.add(pkg.path);
-    }
-    const affectedPaths = await detectAffectedPackages({
-      cwd,
-      root,
-      packages: matched,
-      history,
-      range: resolvePartitionRange({ fromTag, tagPrefix, partition: definition })
-    });
-    const scoped = matched.filter((pkg) => affectedPaths.has(pkg.path));
-    if (!scoped.length) {
-      continue;
-    }
-    const resolvedRange = resolvePartitionRange({ fromTag, tagPrefix, partition: definition });
-    if (definition.mode === "sync") {
-      partitioned.push({
-        id: `partition:${partition}`,
-        kind: "partition",
-        mode: "sync",
-        partition,
-        packages: scoped,
-        range: resolvedRange
-      });
-      continue;
-    }
-    partitioned.push(...scoped.map((pkg) => ({
-      id: `partition:${partition}:${packageIdentity(pkg, cwd)}`,
-      kind: "partition",
-      mode: "async",
-      partition,
-      packages: [pkg],
-      range: resolvedRange
-    })));
-  }
-  const fallbackCandidates = sortPackages(
-    packages.filter((pkg) => !usedPaths.has(pkg.path)),
-    cwd
-  );
-  const fallbackPaths = await detectAffectedPackages({
-    cwd,
-    root,
-    packages: fallbackCandidates,
-    history,
-    range: {
-      fromTag,
-      tagPrefix
-    }
-  });
-  const remainder = fallbackCandidates.filter((pkg) => fallbackPaths.has(pkg.path));
-  const fallback = remainder.map((pkg) => ({
-    id: `hybrid:${packageIdentity(pkg, cwd)}`,
-    kind: "async",
-    mode: "async",
-    packages: [pkg],
-    range: {
-      fromTag,
-      tagPrefix
-    }
-  }));
-  return [...partitioned, ...fallback];
-}
-function resolvePartitionRange({
-  fromTag,
-  tagPrefix,
-  partition
-}) {
-  return {
-    fromTag: partition.fromTag ?? fromTag,
-    tagPrefix: partition.tagPrefix ?? tagPrefix
-  };
-}
-async function detectAffectedPackages({
-  cwd,
-  root,
-  packages,
-  history,
-  range
-}) {
-  const touched = await readCommitRangePaths(history, range);
-  if (touched === null) {
-    return new Set(packages.map((pkg) => pkg.path));
-  }
-  if (!touched.length) {
-    return /* @__PURE__ */ new Set();
-  }
-  const normalizedRoot = normalizePath(relative(cwd, root.path));
-  const children = packages.filter((pkg) => pkg.path !== root.path).map((pkg) => ({
-    packagePath: pkg.path,
-    relativePath: normalizePath(relative(cwd, pkg.path))
-  })).sort((a, b) => b.relativePath.length - a.relativePath.length);
-  const affected = /* @__PURE__ */ new Set();
-  for (const path of touched.map(normalizePath)) {
-    if (!isPathInside(path, normalizedRoot)) continue;
-    const child = children.find((entry) => isPathInside(path, entry.relativePath));
-    affected.add(child?.packagePath ?? root.path);
-  }
-  return affected;
-}
-function applyWorkspaceFilters(packages, cwd, selector) {
-  if (!selector?.include?.length && !selector?.exclude?.length) {
-    return packages;
-  }
-  return packages.filter((pkg) => {
-    const included = selector.include?.length ? selector.include.some((entry) => matchesPackageSelector(pkg, cwd, entry)) : true;
-    if (!included) {
-      return false;
-    }
-    return !(selector.exclude?.some((entry) => matchesPackageSelector(pkg, cwd, entry)) ?? false);
-  });
-}
-function sortPackages(packages, cwd) {
-  return [...packages].sort((a, b) => packagePath(a, cwd).localeCompare(packagePath(b, cwd)));
-}
-function packagePath(pkg, cwd) {
-  return normalizePath(relative(cwd, pkg.path));
-}
-function toPublicPath(pkg, cwd) {
-  return packagePath(pkg, cwd) || ".";
-}
-function matchesPackageSelector(pkg, cwd, selector) {
-  const name = pkg.manifest.name ?? pkg.name ?? "";
-  const path = packagePath(pkg, cwd);
-  return matchesGlob(name, selector) || matchesGlob(path, selector);
-}
-function matchesGlob(input, pattern) {
-  if (!pattern) return false;
-  if (pattern === "*") return true;
-  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "__DOUBLE_STAR__").replace(/\*/g, "[^/]*").replace(/__DOUBLE_STAR__/g, ".*");
-  return new RegExp(`^${escaped}$`).test(input);
-}
-async function readCommitRangePaths(history, range) {
-  try {
-    const result = await history.traverse({
-      fromTag: range.fromTag,
-      tagPrefix: range.tagPrefix,
-      changeset: true,
-      traversers: [createChangesetTraverser()]
-    });
-    return result.results.get("changeset").paths;
-  } catch {
-    return null;
-  }
-}
-function normalizePath(path) {
-  return path.replace(/\\/g, "/");
-}
-function isPathInside(path, root) {
-  return !root || root === "." || root === path || path.startsWith(`${root}/`);
-}
-async function runScope(runtime, scope, options, reporting) {
-  const slices = [];
-  for (const slice of scope.slices) {
-    if (reporting) {
-      await reportSliceStart(reporting.reporter, toSlice(slice, runtime.cwd), reporting.context);
-    }
-    const result = await executeSlice(runtime, slice, options);
-    if (reporting) {
-      await reportSliceSuccess(reporting.reporter, result, reporting.context);
-    }
-    slices.push(result);
-  }
-  const files = uniqueStrings(
-    slices.flatMap((slice) => slice.files)
-  );
-  const changed = slices.some((slice) => slice.changed);
-  return {
-    mode: scope.mode,
-    changed,
-    dry: runtime.dry,
-    packages: scope.packages.map((pkg) => toScopePackage(pkg, runtime.cwd)),
-    affected: scope.affected.map((pkg) => toScopePackage(pkg, runtime.cwd)),
-    slices,
-    files
-  };
-}
-async function executeSlice(runtime, slice, options) {
-  const normalizedSlice = {
-    ...slice,
-    packages: uniquePackages(slice.packages)
-  };
-  const currentVersion = resolveSliceCurrentVersion(normalizedSlice, runtime.cwd);
-  const releaseMeta = await collectSliceMeta(runtime, normalizedSlice);
-  const release = resolveNextVersion(currentVersion, {
-    recommendation: releaseMeta.recommendation,
-    type: options.releaseAs,
-    prerelease: options.prerelease
-  });
-  const releaseType = String(release.type);
-  const nextVersion = release.version;
-  const base = toSlice(normalizedSlice, runtime.cwd);
-  if (nextVersion === currentVersion) {
-    return {
-      ...base,
-      currentVersion,
-      nextVersion,
-      releaseType,
-      changed: false,
-      dry: runtime.dry,
-      files: []
-    };
-  }
-  const changes = renderChangelog(nextVersion, {
-    notes: releaseMeta.notes,
-    url: await runtime.history.url()
-  });
-  const files = await applySlice(runtime, normalizedSlice, nextVersion, options, changes);
-  const context = createTagContext(normalizedSlice, nextVersion, releaseType, runtime.cwd);
-  const tag = options.tagName ? options.tagName(context) : createDefaultTagName(normalizedSlice, nextVersion, runtime.cwd);
-  if (runtime.dry) {
-    return {
-      ...base,
-      currentVersion,
-      nextVersion,
-      releaseType,
-      changed: true,
-      dry: true,
-      tag,
-      files
-    };
-  }
-  const messageContext = { ...context, tag };
-  const commitMessage = options.commitMessage ? options.commitMessage(messageContext) : DEFAULT_RELEASE_PREFIX + tag;
-  const tagMessage = options.tagMessage ? options.tagMessage(messageContext) : DEFAULT_RELEASE_PREFIX + tag;
-  await runtime.git.add(files);
-  await runtime.git.commit({ files, message: commitMessage });
-  await runtime.git.tag({ name: tag, message: tagMessage });
-  return {
-    ...base,
-    currentVersion,
-    nextVersion,
-    releaseType,
-    changed: true,
-    dry: false,
-    files,
-    tag,
-    commitMessage,
-    tagMessage
-  };
-}
-async function applySlice(runtime, slice, nextVersion, options, changes) {
-  const bumpedPackageNames = slice.packages.reduce((all, pkg) => {
-    const name = pkg.manifest.name ?? pkg.name;
-    if (name) {
-      all.add(name);
-    }
-    return all;
-  }, /* @__PURE__ */ new Set());
-  const dependencyPolicy = options.dependencyPolicy ?? DEFAULT_DEPENDENCY_POLICY_INTERNAL;
-  const files = [];
-  for (const pkg of slice.packages) {
-    const diff = { version: nextVersion };
-    const manifest = pkg.manifest;
-    if (hasDependencies(manifest.peerDependencies)) {
-      diff.peerDependencies = actualizeDependencies(manifest.peerDependencies, nextVersion, bumpedPackageNames, dependencyPolicy);
-    }
-    if (hasDependencies(manifest.dependencies)) {
-      diff.dependencies = actualizeDependencies(manifest.dependencies, nextVersion, bumpedPackageNames, dependencyPolicy);
-    }
-    if (hasDependencies(manifest.optionalDependencies)) {
-      diff.optionalDependencies = actualizeDependencies(manifest.optionalDependencies, nextVersion, bumpedPackageNames, dependencyPolicy);
-    }
-    if (hasDependencies(manifest.devDependencies)) {
-      diff.devDependencies = actualizeDependencies(manifest.devDependencies, nextVersion, bumpedPackageNames, dependencyPolicy);
-    }
-    files.push(relative(runtime.cwd, update(pkg.path, diff, runtime.dry)));
-  }
-  const installArgs = resolveInstallArgs(runtime, options.install);
-  if (!runtime.dry && installArgs) {
-    await runtime.sh.exec(runtime.packageManager.command, ["install", ...installArgs]);
-  }
-  if (!runtime.dry) {
-    await runtime.writeChangelog(changes);
-  }
-  files.push(relative(runtime.cwd, join(runtime.cwd, runtime.packageManager.lockfile)));
-  files.push(relative(runtime.cwd, join(runtime.cwd, runtime.changelogFile)));
-  return uniqueStrings(files);
-}
-async function collectSliceMeta(runtime, slice) {
-  const result = await runtime.history.traverse({
-    ...slice.range,
-    traversers: [createRecommendationAnalyzer({
-      strict: true
-    }), createChangelogCapacitor()]
-  });
-  return {
-    recommendation: result.results.get("recommendation"),
-    notes: result.results.get("changelog")
-  };
-}
-function resolveInstallArgs(runtime, install) {
-  if (install === false) {
-    return null;
-  }
-  if (Array.isArray(install)) {
-    return install;
-  }
-  if (runtime.packageManager.command === "yarn") {
-    return ["--no-immutable"];
-  }
-  return [];
-}
-function createTagContext(slice, version, releaseType, cwd) {
-  return {
-    id: slice.id,
-    kind: slice.kind,
-    mode: slice.mode,
-    partition: slice.partition,
-    packages: slice.packages.map((pkg) => toScopePackage(pkg, cwd)),
-    version,
-    releaseType
-  };
-}
-function resolveSliceCurrentVersion(slice, cwd) {
-  const versions = uniqueStrings(
-    slice.packages.map((pkg) => pkg.manifest.version ?? "0.0.0")
-  );
-  if (slice.mode === "sync" && versions.length > 1) {
-    const packageList = slice.packages.map((pkg) => packageIdentity(pkg, cwd)).join(", ");
-    throw new Error(`Sync release slice "${slice.id}" requires aligned package versions: ${packageList}`);
-  }
-  return versions[0];
-}
-function createDefaultTagName(slice, version, cwd) {
-  if (slice.kind === "sync") {
-    return `v${version}`;
-  }
-  if (slice.partition) {
-    return `${slice.partition}@${version}`;
-  }
-  const identity = packageIdentity(slice.packages[0], cwd);
-  return `${identity}@${version}`;
-}
-function hasDependencies(dependencies) {
-  return !!dependencies && Object.keys(dependencies).length > 0;
-}
-function actualizeDependencies(dependencies, nextVersion, bumpedPackages, internalPolicy) {
-  return Object.keys(dependencies).reduce((all, name) => ({
-    ...all,
-    [name]: bumpedPackages.has(name) ? updateDependencyRange(dependencies[name], nextVersion, internalPolicy) : dependencies[name]
-  }), {});
-}
-function updateDependencyRange(current, nextVersion, policy) {
-  if (policy === "caret") return "^" + nextVersion;
-  if (policy === "exact") return nextVersion;
-  if (current.startsWith("workspace:")) {
-    const value = current.slice("workspace:".length);
-    if (value === "*") return "workspace:*";
-    if (value.startsWith("^")) return `workspace:^${nextVersion}`;
-    if (value.startsWith("~")) return `workspace:~${nextVersion}`;
-    return `workspace:${nextVersion}`;
-  }
-  if (current.startsWith("^")) return "^" + nextVersion;
-  if (current.startsWith("~")) return "~" + nextVersion;
-  return nextVersion;
-}
+import { createRunContext, reportError, reportScope, reportStart, reportSuccess } from "./reporter.mjs";
+import "./constants.mjs";
+import { resolveConfig, toInlineConfig, toScopeOptions } from "./config.mjs";
+import { createRuntime } from "./runtime.mjs";
+import { discover, toScope } from "./plan.mjs";
+import { runScope } from "./execute.mjs";
+//#region src/index.ts
+/** Resolves config, creates a runtime, and executes the release in one high-level call. */
 async function run(options = {}) {
-  const inline = toInlineConfig(options);
-  const cwd = options.cwd ?? process.cwd();
-  const context = createRunContext({
-    cwd,
-    dry: options.dry ?? false
-  });
-  try {
-    await reportStart(options.reporter, context);
-    const config = await resolveConfig(cwd, inline);
-    const scopeOptions = toScopeOptions(config);
-    const runtime = createRuntime({
-      cwd,
-      dry: context.dry,
-      changelogFile: config.changelogFile ?? DEFAULT_CHANGELOG_FILE
-    });
-    const scope = await discover(runtime, scopeOptions);
-    const publicScope = toScope(scope, runtime.cwd);
-    await reportScope(options.reporter, publicScope, context);
-    const result = await runScope(runtime, scope, scopeOptions, options.reporter ? {
-      reporter: options.reporter,
-      context
-    } : void 0);
-    await reportSuccess(options.reporter, result, context);
-    return result;
-  } catch (error) {
-    await reportError(options.reporter, error, context);
-    throw error;
-  }
-}
+	const inline = toInlineConfig(options);
+	const cwd = options.cwd ?? process.cwd();
+	const context = createRunContext({
+		cwd,
+		dry: options.dry ?? false
+	});
+	try {
+		await reportStart(options.reporter, context);
+		const config = await resolveConfig(cwd, inline);
+		const scopeOptions = toScopeOptions(config);
+		const runtime = createRuntime({
+			cwd,
+			dry: context.dry,
+			changelogFile: config.changelogFile ?? "CHANGELOG.md"
+		});
+		const scope = await discover(runtime, scopeOptions);
+		const publicScope = toScope(scope, runtime.cwd);
+		await reportScope(options.reporter, publicScope, context);
+		const result = await runScope(runtime, scope, scopeOptions, options.reporter ? {
+			reporter: options.reporter,
+			context
+		} : void 0);
+		await reportSuccess(options.reporter, result, context);
+		return result;
+	} catch (error) {
+		await reportError(options.reporter, error, context);
+		throw error;
+	}
+}
+/** Resolves config, creates a runtime, and returns a deterministic release scope. */
 async function createScope(options = {}) {
-  const inline = toInlineConfig(options);
-  const cwd = options.cwd ?? process.cwd();
-  const config = await resolveConfig(cwd, inline);
-  const scopeOptions = toScopeOptions(config);
-  const runtime = createRuntime({
-    cwd,
-    dry: options.dry ?? true,
-    changelogFile: config.changelogFile ?? DEFAULT_CHANGELOG_FILE
-  });
-  const scope = await discover(runtime, scopeOptions);
-  return toScope(scope, runtime.cwd);
-}
-export {
-  createScope,
-  resolveConfig,
-  run
-};
+	const inline = toInlineConfig(options);
+	const cwd = options.cwd ?? process.cwd();
+	const config = await resolveConfig(cwd, inline);
+	const scopeOptions = toScopeOptions(config);
+	const runtime = createRuntime({
+		cwd,
+		dry: options.dry ?? true,
+		changelogFile: config.changelogFile ?? "CHANGELOG.md"
+	});
+	return toScope(await discover(runtime, scopeOptions), runtime.cwd);
+}
+//#endregion
+export { createScope, resolveConfig, run };