@williamthorsen/release-kit 11.0.0 → 12.0.0

package/dist/esm/collectPolicyViolations.d.ts

@@ -1,15 +0,0 @@
-import type { PolicyViolationHandler } from './parseCommitMessage.js';
-import type { PolicyViolation } from './types.js';
-/**
- * Build a fresh `policyViolations` accumulator paired with the `onPolicyViolation` callback
- * that pushes structured entries into it.
- *
- * Used by all three release-prepare orchestrators (`releasePrepare`, `releasePrepareMono`,
- * `releasePrepareProject`) to collect parser-side `!`-policy violations into a result-attachable
- * array. Centralizing the callback shape keeps the `commitSubject` extraction rule (`firstLine
- * post-split`) consistent across orchestrators.
- */
-export declare function createPolicyViolationCollector(): {
-    violations: PolicyViolation[];
-    onPolicyViolation: PolicyViolationHandler;
-};

package/dist/esm/collectPolicyViolations.js

@@ -1,12 +0,0 @@
-export function createPolicyViolationCollector() {
-    const violations = [];
-    const onPolicyViolation = (commit, type, surface) => {
-        violations.push({
-            commitHash: commit.hash,
-            commitSubject: commit.message.split('\n', 1)[0] ?? '',
-            type,
-            surface,
-        });
-    };
-    return { violations, onPolicyViolation };
-}

package/dist/esm/determineBumpFromCommits.d.ts

@@ -1,17 +0,0 @@
-import { type PolicyViolationHandler } from './parseCommitMessage.js';
-import type { Commit, ReleaseType, VersionPatterns, WorkTypeConfig } from './types.js';
-/** Aggregate result of parsing commits and determining the bump type. */
-export interface BumpDetermination {
-    releaseType: ReleaseType | undefined;
-    parsedCommitCount: number;
-    unparseableCommits: Commit[] | undefined;
-}
-/** Optional configuration for parser-policy plumbing. */
-export interface DetermineBumpOptions {
-    /** Per-canonical-type breaking-policy lookup (drives `!` policy enforcement). */
-    breakingPolicies?: Record<string, 'forbidden' | 'optional' | 'required'>;
-    /** Receives policy-violation notifications from `parseCommitMessage`. */
-    onPolicyViolation?: PolicyViolationHandler;
-}
-/** Parse commits, determine bump type, and apply patch floor when commits exist but none parsed. */
-export declare function determineBumpFromCommits(commits: Commit[], workTypes: Record<string, WorkTypeConfig>, versionPatterns: VersionPatterns, scopeAliases: Record<string, string> | undefined, options?: DetermineBumpOptions): BumpDetermination;

package/dist/esm/determineBumpFromCommits.js

@@ -1,28 +0,0 @@
-import { determineBumpType } from "./determineBumpType.js";
-import { parseCommitMessage, } from "./parseCommitMessage.js";
-export function determineBumpFromCommits(commits, workTypes, versionPatterns, scopeAliases, options) {
-    const parseOptions = {
-        ...(options?.breakingPolicies !== undefined && { breakingPolicies: options.breakingPolicies }),
-        ...(options?.onPolicyViolation !== undefined && { onPolicyViolation: options.onPolicyViolation }),
-    };
-    const parsedCommits = [];
-    const unparseable = [];
-    for (const commit of commits) {
-        const parsed = parseCommitMessage(commit.message, commit.hash, workTypes, scopeAliases, parseOptions);
-        if (parsed === undefined) {
-            unparseable.push(commit);
-        }
-        else {
-            parsedCommits.push(parsed);
-        }
-    }
-    let releaseType = determineBumpType(parsedCommits, workTypes, versionPatterns);
-    if (releaseType === undefined && commits.length > 0) {
-        releaseType = 'patch';
-    }
-    return {
-        releaseType,
-        parsedCommitCount: parsedCommits.length,
-        unparseableCommits: unparseable.length > 0 ? unparseable : undefined,
-    };
-}

package/dist/esm/getCommitsSinceTarget.d.ts

@@ -1,21 +0,0 @@
-import type { Commit } from './types.js';
-/**
- * Gets commits since the latest baseline tag matching any of the given prefixes.
- *
- * Uses `git log` to retrieve commit messages and hashes between the closest reachable
- * baseline tag and HEAD. When no tag matches any prefix, all commits reachable from HEAD
- * are returned.
- *
- * Callers must pass at least one prefix; the single-prefix case is the common one (the
- * workspace's derived prefix). Multiple prefixes are used to include historical tag prefixes
- * from `legacyIdentities`.
- *
- * @param tagPrefixes - Tag prefixes to search as a union (e.g., `['core-v', 'old-core-v']`).
- * @param paths - Optional glob patterns to filter commits by path (appended after `--` in `git log`).
- *   Path patterns use POSIX-style forward slashes; Windows compatibility is not guaranteed.
- * @returns An object with the found tag (if any) and the list of commits.
- */
-export declare function getCommitsSinceTarget(tagPrefixes: readonly string[], paths?: string[]): {
-    tag: string | undefined;
-    commits: Commit[];
-};

package/dist/esm/getCommitsSinceTarget.js

@@ -1,66 +0,0 @@
-import { execFileSync } from 'node:child_process';
-import { GIT_OUTPUT_LIMIT } from '@williamthorsen/nmr-core';
-import { chainError } from '@williamthorsen/toolbelt.errors/candidate';
-const FIELD_SEPARATOR = '\u{1F}';
-function isNoTagError(err) {
-    return typeof err === 'object' && err !== null && 'status' in err && err.status === 128;
-}
-function findLatestTag(tagPrefixes) {
-    if (tagPrefixes.length === 0) {
-        throw new Error('findLatestTag: tagPrefixes must contain at least one entry');
-    }
-    const matchArgs = tagPrefixes.map((prefix) => `--match=${prefix}*`);
-    try {
-        const tagResult = execFileSync('git', ['describe', '--tags', '--abbrev=0', ...matchArgs], {
-            encoding: 'utf8',
-            maxBuffer: GIT_OUTPUT_LIMIT,
-            stdio: ['pipe', 'pipe', 'pipe'],
-        }).trim();
-        return tagResult || undefined;
-    }
-    catch (error) {
-        if (isNoTagError(error)) {
-            return undefined;
-        }
-        throw chainError(`Failed to run 'git describe'`, error);
-    }
-}
-const RELEASE_COMMIT_PREFIX = 'release:';
-function parseLogOutput(logOutput) {
-    const commits = [];
-    for (const line of logOutput.split('\n')) {
-        const trimmedLine = line.trim();
-        if (trimmedLine === '') {
-            continue;
-        }
-        const [message, hash] = trimmedLine.split(FIELD_SEPARATOR);
-        if (message !== undefined && hash !== undefined && !message.startsWith(RELEASE_COMMIT_PREFIX)) {
-            commits.push({ message, hash });
-        }
-    }
-    return commits;
-}
-export function getCommitsSinceTarget(tagPrefixes, paths) {
-    const tag = findLatestTag(tagPrefixes);
-    const range = tag === undefined ? 'HEAD' : `${tag}..HEAD`;
-    const format = `%s${FIELD_SEPARATOR}%H`;
-    const args = ['log', range, `--pretty=format:${format}`];
-    if (paths !== undefined && paths.length > 0) {
-        args.push('--', ...paths);
-    }
-    let logOutput;
-    try {
-        logOutput = execFileSync('git', args, {
-            encoding: 'utf8',
-            maxBuffer: GIT_OUTPUT_LIMIT,
-            stdio: ['pipe', 'pipe', 'pipe'],
-        }).trim();
-    }
-    catch (error) {
-        throw chainError(`Failed to run 'git log' for range '${range}'`, error);
-    }
-    if (logOutput === '') {
-        return { tag, commits: [] };
-    }
-    return { tag, commits: parseLogOutput(logOutput) };
-}

package/dist/esm/resolveCliffConfigPath.d.ts

@@ -1,11 +0,0 @@
-/**
- * Resolve the git-cliff configuration file path.
- *
- * Checks candidates in order: explicit `cliffConfigPath` -> `.config/git-cliff.toml` ->
- * `cliff.toml` -> bundled `cliff.toml.template`. Returns the first path that exists,
- * or throws if even the bundled template cannot be found.
- *
- * When an explicit `cliffConfigPath` is provided, it is returned as-is without checking
- * existence, preserving current behavior (git-cliff reports the error if the file is missing).
- */
-export declare function resolveCliffConfigPath(cliffConfigPath: string | undefined, metaUrl: string): string;

package/dist/esm/resolveCliffConfigPath.js

@@ -1,20 +0,0 @@
-import { existsSync } from 'node:fs';
-import { resolve } from 'node:path';
-import { findPackageRoot } from '@williamthorsen/nmr-core';
-export function resolveCliffConfigPath(cliffConfigPath, metaUrl) {
-    if (cliffConfigPath !== undefined) {
-        return cliffConfigPath;
-    }
-    const candidates = ['.config/git-cliff.toml', 'cliff.toml'];
-    for (const candidate of candidates) {
-        if (existsSync(candidate)) {
-            return candidate;
-        }
-    }
-    const root = findPackageRoot(metaUrl);
-    const bundledPath = resolve(root, 'cliff.toml.template');
-    if (existsSync(bundledPath)) {
-        return bundledPath;
-    }
-    throw new Error(`Could not resolve a git-cliff config file. Searched: ${candidates.join(', ')}, and bundled template at ${bundledPath}`);
-}

package/dist/esm/runGitCliff.d.ts

@@ -1,38 +0,0 @@
-/**
- * The exact `git-cliff` version every invocation resolves.
- *
- * npm's `git-cliff` trails the upstream release, so this pin normally sits behind the newest version cliff
- * itself reports. Bumping it is an edit to this line, once npm publishes the version you want.
- */
-export declare const GIT_CLIFF_VERSION = "2.13.1";
-/** The npx arguments that precede the cliff args at every invocation, and that the dry-run report renders. */
-export declare const GIT_CLIFF_NPX_ARGS: readonly string[];
-/**
- * Invokes `git-cliff` via `npx` and returns the output it produced.
- *
- * Single entry point for `git-cliff` invocations from `release-kit`. Owns three pieces of shared lifecycle
- * that would otherwise duplicate (and silently drift) across call sites: the npx flags, the spawned-process
- * environment, and the temp dir holding both the `.template`→`.toml` config copy and cliff's output file.
- *
- * Output is routed through `--output` to a temp file and read back. `--context` emits a workspace's
- * entire matching tag history on every run, so its size grows without bound with the repo;
- * a file accommodates that, while a pipe is bounded by `maxBuffer`.
- *
- * The npx spec names an exact version, which leaves npm no staleness to check, so `--prefer-offline` skips the
- * per-call registry revalidation round-trip (~2.5 s per invocation on a warm cache) without stranding the run
- * on whatever the cache happens to hold.
- *
- * Two env entries are set for the child. `npm_config_progress=false` suppresses npx's animated stderr spinner,
- * which otherwise renders as a transient flicker. `RUST_LOG=warn` drops cliff's INFO lines, among them the
- * crates.io update notice it emits on every invocation while npm trails upstream, and leaves warnings and errors
- * in place; an inherited `RUST_LOG` wins, so raising the level for debugging still works.
- *
- * The helper injects `--config <path>` and `--output <path>` itself — callers must NOT include either in `cliffArgs`.
- * `--output` is appended last so a caller that passes one anyway cannot redirect the output the helper then reads.
- * The caller is responsible for resolving the cliff config path (via `resolveCliffConfigPath`) before calling,
- * since the resolution depends on the caller's `import.meta.url`.
- *
- * Errors from `execFileSync` are not caught: callers wrap with site-specific messages.
- * The temp-dir cleanup runs in a `finally` so it still happens on throw.
- */
-export declare function runGitCliff(cliffConfigPath: string, cliffArgs: readonly string[]): string;

package/dist/esm/runGitCliff.js

@@ -1,25 +0,0 @@
-import { execFileSync } from 'node:child_process';
-import { copyFileSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-export const GIT_CLIFF_VERSION = '2.13.1';
-export const GIT_CLIFF_NPX_ARGS = ['--prefer-offline', '--yes', `git-cliff@${GIT_CLIFF_VERSION}`];
-export function runGitCliff(cliffConfigPath, cliffArgs) {
-    const tempDir = mkdtempSync(join(tmpdir(), 'cliff-'));
-    try {
-        let configPath = cliffConfigPath;
-        if (cliffConfigPath.endsWith('.template')) {
-            configPath = join(tempDir, 'cliff.toml');
-            copyFileSync(cliffConfigPath, configPath);
-        }
-        const outputPath = join(tempDir, 'output.json');
-        execFileSync('npx', [...GIT_CLIFF_NPX_ARGS, '--config', configPath, ...cliffArgs, '--output', outputPath], {
-            stdio: ['ignore', 'ignore', 'inherit'],
-            env: { ...process.env, npm_config_progress: 'false', RUST_LOG: process.env['RUST_LOG'] ?? 'warn' },
-        });
-        return readFileSync(outputPath, 'utf8');
-    }
-    finally {
-        rmSync(tempDir, { recursive: true, force: true });
-    }
-}