@williamthorsen/release-kit 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -2,129 +2,38 @@
 
 All notable changes to this project will be documented in this file.
 
-## [release-kit-v2.0.0] - 2026-03-16
+## [release-kit-v2.1.0] - 2026-03-17
 
 ### Features
 
-- #20 release-kit|feat!: Move reusable release workflow into repo (#26)
-
-Move the reusable release workflow from `williamthorsen/.github` into this repository as `.github/workflows/release-workflow.yaml`, versioned independently via `release-workflow-v{major}` tags. Update `release-kit init` templates to reference the new workflow location. The workflow no longer requires pnpm: it installs release-kit globally and runs it directly.
-
-- #22 release-kit|feat: Add --force flag to release-kit prepare (#25)
-
-Add a `--force` flag that allows release preparation to proceed even when no release-worthy commits are found.
-
 - #7 release-kit|feat!: Slim down release workflow by removing unnecessary pnpm install (#21)
 
-Remove pnpm setup steps from the reusable release workflow. Release-kit is self-contained and invokes git-cliff and prettier via `npx`, so no local dependency installation is needed.
-
-### Refactoring
-
-- #6 release-kit|refactor: Clean up release-kit post-migration issues (#19)
-
-## [release-kit-v1.0.1] - 2026-03-12
+Make release-kit self-contained by invoking git-cliff via `npx --yes` instead of requiring it on PATH, and by appending modified file paths to the format command so lightweight formatters like `npx prettier --write` work without a full `pnpm install`. Update init templates, README, and consuming repo config/workflow to reference workflow v3.
 
-### Bug fixes
-
-- #34 release-kit|fix: Fix failure to find consumer's config (#35)
+- #22 release-kit|feat: Add --force flag to release-kit prepare (#25)
 
-Resolves the config file path to an absolute path using `process.cwd()` before passing it to both `existsSync` and `jiti.import()`. Previously, `jiti.import()` received a bare relative path which it resolved against `import.meta.url` (the package's install location), making it impossible for consumers to load their config files. Also fixes root tsconfig includes to cover `.config/` and removes a stale duplicate comment.
+Add a `--force` flag to `release-kit prepare` that bypasses the "no commits since last tag" check in monorepo mode, allowing version bumping and changelog generation to proceed even when no new commits are found since the last release tag. The flag requires `--bump` since there are no commits to infer bump type from. The local release workflow gains a `force` boolean input for future use.
 
-## [release-kit-v1.0.0] - 2026-03-12
+- #20 release-kit|feat!: Move reusable release workflow into repo (#26)
 
-### Features
+Moves the reusable release workflow from `williamthorsen/.github` into this repo as `release-workflow.yaml`, stripping all pnpm-related steps since release-kit now runs git-cliff and prettier via `npx` internally. Updates this repo's caller workflow to use a relative path and update init templates to reference the new location. Establishes a naming convention (`{name}-workflow.yaml` for reusable, `{name}.yaml` for callers) and independent versioning strategy (`{name}-workflow-v{major}` tags), documented in `.github/workflows/README.md`.
 
-- #28 release-kit|feat!: Migrate to CLI-driven release preparation with auto-discovery (#31)
+- #30 release-kit|feat: Allow git-cliff to be used without config (#31)
 
-Replaces release-kit's script-based release preparation with a self-contained CLI (`npx @williamthorsen/release-kit prepare`) that auto-discovers workspaces from `pnpm-workspace.yaml`. Adds workspace auto-discovery, TypeScript config loading via jiti, config validation, and a `component()` factory that accepts full workspace-relative paths. Refactors the type system: `WorkTypeConfig` becomes a record keyed by type name, version-bump rules move to a separate `VersionPatterns` structure, and `ComponentConfig` gains a `dir` field for canonical directory identity.
+Adds a `resolveCliffConfigPath()` function that searches for a git-cliff config in a 4-step cascade (explicit path → `.config/git-cliff.toml` → `cliff.toml` → bundled `cliff.toml.template`), eliminating the requirement for consuming repos to maintain a cliff config copy. Restructures the `init` command to scaffold only the workflow file by default, with new `--with-config` and `--force` flags. Moves `.release-tags` from `/tmp/release-kit/` to project-local `tmp/` for predictable behavior in local runs.
 
 ### Refactoring
 
-- #28 release-kit|refactor: Adjust location of config & tags file
-
-### Tooling
-
-- #28 release-kit|tooling: Remove legacy release-kit scripts
-
-## [release-kit-v0.3.0] - 2026-03-11
-
-### Features
-
-- Release-kit|feat: Extract CLI runner into release-kit and co-locate scripts with workflow
-
-Move release script logic (arg parsing, validation, component filtering) into a reusable `runReleasePrepare` function in the release-kit package. Consuming repos now provide only their config and call `runReleasePrepare(config)`.
-
-Relocate release-prepare.ts and release.config.ts from scripts/ to .github/scripts/ so they live alongside the workflow they serve.
-
-- #20 release-kit|feat: Add release-kit init CLI command for automated repo setup (#22)
-
-Add an interactive `npx release-kit init` CLI command that checks repo eligibility, detects monorepo vs single-package layout, scaffolds workflow/scripts/config files, and updates `package.json` with release scripts.
-
-Also expand `runReleasePrepare` to polymorphically handle both `MonorepoReleaseConfig` and `ReleaseConfig`, and update the esbuild plugin to preserve shebangs during compilation.
-
-- #24 release-kit|feat: Return computed tags from release prepare and write .release-tags (#27)
-
-`releasePrepare` and `releasePrepareMono` now return `string[]` of computed tag names instead of `void`. `runReleasePrepare` writes these tags to a `.release-tags` file (one tag per line) so the CI workflow can read them instead of independently deriving tag names from `git diff`. In dry-run mode the file is not written. This makes `tagPrefix` the single source of truth for tag names, eliminating the mismatch between TypeScript-computed tags and workflow-derived tags.
-
-## [strings-v3.1.1] - 2026-03-10
-
-### Tooling
-
-- \*|tooling: Change package registry from github to npmjs
-
-## [tools-v3.0.1] - 2026-03-10
-
-### Tooling
-
-- \*|tooling: Change package registry from github to npmjs
-
-## [release-kit-v0.2.1] - 2026-03-09
-
-### Tooling
-
-- Root|tooling: Make release-kit public
-
-## [release-kit-v0.2.0] - 2026-03-09
-
-### Documentation
-
-- Release-kit|docs: Rewrite README as adoption guide
-
-Replace minimal API docs with end-to-end adoption guide covering single-package and monorepo configurations, release scripts, GitHub Actions workflows that commit directly to `main`.
-
-### Tooling
-
-- #13 root|tooling: Migrate from changesets to release-kit (#16)
-
-Replaces the `@changesets/cli`-based release workflow with the in-house `release-kit` package, adding `git-cliff` for changelog generation, a monorepo release config for all 13 packages, and a CLI wrapper script. Removes all changeset infrastructure and creates per-package baseline version tags.
-
-- #10 root|tooling: Publish release-kit to GitHub Package Registry (#17)
-
-Adds release infrastructure for the toolbelt monorepo: a GitHub Actions `workflow_dispatch` workflow that automates the full release cycle (prepare, commit, tag, push) on `main`, convenience `release:prepare` scripts in the release-kit package, and a `RELEASING.md` documenting the workflow-based release process.
+- #6 release-kit|refactor: Clean up release-kit post-migration issues (#19)
 
-- #10 root|tooling: Streamline release-kit adoption
+Addresses five code quality issues and a test coverage gap identified during the release-kit migration (#5). Extracts a duplicated `isRecord` type guard into a shared module, eliminates a double-read in `bumpAllVersions`, improves error handling in `usesPnpm` by replacing a silent catch with a structured error boundary, removes an unreachable `'feature'` pattern from version defaults, and adds an integration test for scaffold template path resolution.
 
-## [tools-v3.0.0] - 2026-03-08
+## [release-kit-v1.0.1] - 2026-03-14
 
 ### Features
 
-- #7 release|feat: Create release-kit package (#9)
-
-Creates the `@williamthorsen/release-kit` package in the `toolbelt` monorepo, extracting version-bumping and changelog-generation logic from `skypilot-site` and `devtools/afg` into a reusable library. The package provides functions for parsing conventional commits, determining semver bump types, updating `package.json` versions across workspaces, and generating changelogs via `git-cliff`.
-
-Add contextual error messages to all I/O operations: file reads/writes in bumpAllVersions, execSync calls in generateChangelogs and releasePrepare, and git commands in getCommitsSinceTarget.
-
-Differentiate expected "no tag" errors from real failures in git describe. Replace string-based commit separator with null-byte to prevent collisions with commit message content. Log git log failures before returning empty results.
-
-Add tests for uppercase/mixed-case type resolution, workspace+breaking combo parsing, breaking-on-first-commit early return, and empty workTypes. Strengthen alias tests to use toStrictEqual for full shape
-verification.
-
-Simplify determineBumpType by replacing the redundant isKeyOf guard on RELEASE_PRIORITY with a direct lookup, since bump is already typed as ReleaseType. Simplify parseCommitMessage by replacing mutable object construction with a conditional spread for the optional workspace field.
-
-Add workspaceAliases field to ReleaseConfig and integrate into parseCommitMessage for resolving workspace shorthand names to canonical names. Replace execSync with execFileSync using argument arrays in generateChangelogs and getCommitsSinceTarget to prevent shell injection from paths with special characters. Remove redundant length-check guard in bumpAllVersions, keeping the undefined guard that also narrows the type.
-
-### Refactoring
+- #5 release-kit|feat: Migrate release-kit from toolbelt (#18)
 
-- Release-kit|refactor: Inline isKeyOf and remove toolbelt.objects dependency
+Migrates the complete `@williamthorsen/release-kit` package (v1.0.1) from `williamthorsen/toolbelt` into `packages/release-kit/`, adds shebang preservation to the shared esbuild plugin for CLI binaries, and sets up dogfooding infrastructure so this monorepo uses release-kit for its own releases.
 
 <!-- generated by git-cliff -->

package/README.md

@@ -13,17 +13,14 @@ pnpm add -D @williamthorsen/release-kit
 ## Quick start
 
 ```bash
-# 1. Set up release-kit in your repo (scaffolds workflow + optional config)
+# 1. Set up release-kit in your repo (scaffolds the release workflow)
 npx @williamthorsen/release-kit init
 
 # 2. Preview what a release would do
 npx @williamthorsen/release-kit prepare --dry-run
-
-# 3. Copy cliff.toml.template to your repo root (if init didn't create one)
-cp node_modules/@williamthorsen/release-kit/cliff.toml.template cliff.toml
 ```
 
-That's it for most repos. The CLI auto-discovers workspaces and applies sensible defaults. Customize only what you need via `.config/release-kit.config.ts`.
+That's it for most repos. The CLI auto-discovers workspaces and applies sensible defaults. The bundled `cliff.toml.template` is used automatically — no need to copy it. Customize only what you need via `.config/release-kit.config.ts`.
 
 ## How it works
 
@@ -31,7 +28,7 @@ That's it for most repos. The CLI auto-discovers workspaces and applies sensible
 2. **Config loading**: loads `.config/release-kit.config.ts` (if present) via [jiti](https://github.com/unjs/jiti) and merges it with discovered defaults.
 3. **Commit analysis**: for each component, finds commits since the last version tag, parses them for type and scope, and determines the appropriate version bump.
 4. **Version bump + changelog**: bumps `package.json` versions and generates changelogs via `git-cliff`.
-5. **Release tags file**: writes computed tags to `/tmp/release-kit/.release-tags` for CI consumption.
+5. **Release tags file**: writes computed tags to `tmp/.release-tags` for the release workflow to read when tagging and pushing.
 
 ## CLI reference
 
@@ -59,21 +56,23 @@ node packages/release-kit/dist/esm/bin/release-kit.js prepare --dry-run
 
 ### `release-kit init`
 
-Initialize release-kit in the current repository. Scaffolds a GitHub Actions workflow and an optional config file.
+Initialize release-kit in the current repository. By default, scaffolds only the GitHub Actions workflow file. Use `--with-config` to also scaffold configuration files.
 
 ```
 Usage: release-kit init [options]
 
 Options:
-  --dry-run     Preview changes without writing files
-  --help, -h    Show help
+  --with-config    Also scaffold .config/release-kit.config.ts and .config/git-cliff.toml
+  --force          Overwrite existing files instead of skipping them
+  --dry-run        Preview changes without writing files
+  --help, -h       Show help
 ```
 
 Scaffolded files:
 
-- `.config/release-kit.config.ts` — starter config with commented-out customization examples
 - `.github/workflows/release.yaml` — workflow that delegates to a reusable release workflow
-- `cliff.toml` — copied from the bundled template (prompted if missing)
+- `.config/release-kit.config.ts` — starter config with commented-out customization examples (with `--with-config`)
+- `.config/git-cliff.toml` — copied from the bundled template (with `--with-config`)
 
 ## Configuration
 
@@ -105,14 +104,14 @@ The config file supports both `export default config` and `export const config =
 
 ### `ReleaseKitConfig` reference
 
-| Field              | Type                             | Description                                                                                    |
-| ------------------ | -------------------------------- | ---------------------------------------------------------------------------------------------- |
-| `cliffConfigPath`  | `string`                         | Path to `cliff.toml` (defaults to `'cliff.toml'`)                                              |
-| `components`       | `ComponentOverride[]`            | Override or exclude discovered components (matched by `dir`)                                   |
-| `formatCommand`    | `string`                         | Shell command to run after changelog generation; modified file paths are appended as arguments |
-| `versionPatterns`  | `VersionPatterns`                | Rules for which commit types trigger major/minor bumps                                         |
-| `workspaceAliases` | `Record<string, string>`         | Maps shorthand workspace names to canonical names in commits                                   |
-| `workTypes`        | `Record<string, WorkTypeConfig>` | Work type definitions, merged with defaults by key                                             |
+| Field              | Type                             | Description                                                                                                                   |
+| ------------------ | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `cliffConfigPath`  | `string`                         | Explicit path to cliff config. If omitted, resolved automatically: `.config/git-cliff.toml` → `cliff.toml` → bundled template |
+| `components`       | `ComponentOverride[]`            | Override or exclude discovered components (matched by `dir`)                                                                  |
+| `formatCommand`    | `string`                         | Shell command to run after changelog generation; modified file paths are appended as arguments                                |
+| `versionPatterns`  | `VersionPatterns`                | Rules for which commit types trigger major/minor bumps                                                                        |
+| `workspaceAliases` | `Record<string, string>`         | Maps shorthand workspace names to canonical names in commits                                                                  |
+| `workTypes`        | `Record<string, WorkTypeConfig>` | Work type definitions, merged with defaults by key                                                                            |
 
 All fields are optional.
 
@@ -259,7 +258,7 @@ jobs:
         if: steps.check.outputs.changed == 'true'
         id: tags
         run: |
-          TAGS=$(cat /tmp/release-kit/.release-tags | tr '\n' ' ')
+          TAGS=$(cat tmp/.release-tags | tr '\n' ' ')
           echo "tags=$TAGS" >> "$GITHUB_OUTPUT"
           echo "Releasing: $TAGS"
 
@@ -297,7 +296,7 @@ And the tag step with:
   if: steps.check.outputs.changed == 'true'
   id: tags
   run: |
-    TAG=$(cat /tmp/release-kit/.release-tags)
+    TAG=$(cat tmp/.release-tags)
     echo "tag=$TAG" >> "$GITHUB_OUTPUT"
 ```
 
@@ -316,19 +315,20 @@ Or use the GitHub UI: Actions > Release > Run workflow.
 
 ## cliff.toml setup
 
-The package includes a `cliff.toml.template` with a generic git-cliff configuration that:
+The package includes a bundled `cliff.toml.template` that is used automatically when no custom config is found. The resolution order is:
+
+1. Explicit `cliffConfigPath` in `.config/release-kit.config.ts`
+2. `.config/git-cliff.toml`
+3. `cliff.toml` (repo root)
+4. Bundled `cliff.toml.template` (automatic fallback)
+
+The bundled template provides a generic git-cliff configuration that:
 
 - Strips issue-ticket prefixes matching `^[A-Z]+-\d+\s+` (e.g., `TOOL-123 `, `AFG-456 `)
 - Handles both `type: description` and `workspace|type: description` commit formats
 - Groups commits by work type into changelog sections
 
-Copy it to your repo root:
-
-```bash
-cp node_modules/@williamthorsen/release-kit/cliff.toml.template cliff.toml
-```
-
-Then customize as needed for your project.
+To customize, scaffold a local copy with `release-kit init --with-config` and edit `.config/git-cliff.toml`.
 
 ## External dependencies
 
@@ -386,5 +386,6 @@ If your format command does not accept file arguments, update it to one that doe
 3. Delete the `.changeset/` directory.
 4. Run `npx @williamthorsen/release-kit init` to scaffold workflow and config files.
 5. Remove `changeset:*` scripts from `package.json` (no replacement needed — the CLI handles everything).
-6. Copy `cliff.toml.template` to your repo root as `cliff.toml` (if `init` didn't create one).
-7. Create an initial version tag for each package (e.g., `git tag v1.0.0` or `git tag arrays-v1.0.0`).
+6. Create an initial version tag for each package (e.g., `git tag v1.0.0` or `git tag arrays-v1.0.0`).
+
+No cliff config copy is needed — the bundled template is used automatically. To customize, run `release-kit init --with-config`.

package/dist/esm/.cache

@@ -1 +1 @@
-f3265b81405ed17fde593f32d16e47fc2fc43f6a87805009ff7d808d5c61a2af
+c3020d624e72bb577d60cb16ff223c951d26227fa82aec1c15894f2b2429603f

package/dist/esm/bin/release-kit.js

@@ -19,11 +19,13 @@ function showInitHelp() {
 Usage: release-kit init [options]
 
 Initialize release-kit in the current repository.
-Scaffolds workflow and config files.
+By default, scaffolds only the GitHub Actions workflow file.
 
 Options:
-  --dry-run     Preview changes without writing files
-  --help, -h    Show this help message
+  --with-config   Also scaffold .config/release-kit.config.ts and .config/git-cliff.toml
+  --force         Overwrite existing files instead of skipping them
+  --dry-run       Preview changes without writing files
+  --help, -h      Show this help message
 `);
 }
 function showPrepareHelp() {
@@ -59,13 +61,16 @@ if (command === "init") {
     showInitHelp();
     process.exit(0);
   }
-  const unknownFlags = flags.filter((f) => f !== "--dry-run" && f !== "--help" && f !== "-h");
+  const knownInitFlags = /* @__PURE__ */ new Set(["--dry-run", "--force", "--with-config", "--help", "-h"]);
+  const unknownFlags = flags.filter((f) => !knownInitFlags.has(f));
   if (unknownFlags.length > 0) {
     console.error(`Error: Unknown option: ${unknownFlags[0]}`);
     process.exit(1);
   }
   const dryRun = flags.includes("--dry-run");
-  const exitCode = await initCommand({ dryRun });
+  const force = flags.includes("--force");
+  const withConfig = flags.includes("--with-config");
+  const exitCode = initCommand({ dryRun, force, withConfig });
   process.exit(exitCode);
 }
 console.error(`Error: Unknown command: ${command}`);

package/dist/esm/generateChangelogs.js

@@ -1,6 +1,7 @@
 import { execFileSync } from "node:child_process";
+import { resolveCliffConfigPath } from "./resolveCliffConfigPath.js";
 function generateChangelog(config, changelogPath, tag, dryRun, options) {
-  const cliffConfigPath = config.cliffConfigPath ?? "cliff.toml";
+  const cliffConfigPath = resolveCliffConfigPath(config.cliffConfigPath, import.meta.url);
   const outputFile = `${changelogPath}/CHANGELOG.md`;
   const args = ["--config", cliffConfigPath, "--output", outputFile, "--tag", tag];
   for (const includePath of options?.includePaths ?? []) {

package/dist/esm/init/checks.d.ts

@@ -5,5 +5,3 @@ export interface CheckResult {
 export declare function isGitRepo(): CheckResult;
 export declare function hasPackageJson(): CheckResult;
 export declare function usesPnpm(): CheckResult;
-export declare function hasCliffToml(): CheckResult;
-export declare function notAlreadyInitialized(): CheckResult;

package/dist/esm/init/checks.js

@@ -29,25 +29,8 @@ function usesPnpm() {
     message: "This project does not appear to use pnpm. A pnpm-lock.yaml or packageManager field is required."
   };
 }
-function hasCliffToml() {
-  if (existsSync("cliff.toml")) {
-    return { ok: true };
-  }
-  return { ok: false, message: "No cliff.toml found. This file is required for changelog generation." };
-}
-function notAlreadyInitialized() {
-  if (!existsSync(".config/release-kit.config.ts") && !existsSync(".github/scripts/release.config.ts")) {
-    return { ok: true };
-  }
-  return {
-    ok: false,
-    message: "release-kit appears to be already initialized."
-  };
-}
 export {
-  hasCliffToml,
   hasPackageJson,
   isGitRepo,
-  notAlreadyInitialized,
   usesPnpm
 };

package/dist/esm/init/initCommand.d.ts

@@ -1,5 +1,7 @@
 interface InitOptions {
     dryRun: boolean;
+    force: boolean;
+    withConfig: boolean;
 }
-export declare function initCommand({ dryRun }: InitOptions): Promise<number>;
+export declare function initCommand({ dryRun, force, withConfig }: InitOptions): number;
 export {};

package/dist/esm/init/initCommand.js

@@ -1,7 +1,7 @@
-import { hasCliffToml, hasPackageJson, isGitRepo, notAlreadyInitialized, usesPnpm } from "./checks.js";
+import { hasPackageJson, isGitRepo, usesPnpm } from "./checks.js";
 import { detectRepoType } from "./detectRepoType.js";
-import { confirm, printError, printStep, printSuccess } from "./prompt.js";
-import { copyCliffTemplate, scaffoldFiles } from "./scaffold.js";
+import { printError, printStep, printSuccess } from "./prompt.js";
+import { scaffoldFiles } from "./scaffold.js";
 function runRequiredCheck(label, result) {
   if (result.ok) {
     printSuccess(label);
@@ -10,59 +10,47 @@ function runRequiredCheck(label, result) {
   printError(result.message ?? `${label} failed`);
   return false;
 }
-async function checkEligibility(dryRun) {
+function checkEligibility() {
   printStep("Checking eligibility");
-  if (!runRequiredCheck("Git repository detected", isGitRepo())) return { status: "fail", overwrite: false };
-  if (!runRequiredCheck("package.json found", hasPackageJson())) return { status: "fail", overwrite: false };
-  if (!runRequiredCheck("pnpm detected", usesPnpm())) return { status: "fail", overwrite: false };
-  const cliffCheck = hasCliffToml();
-  if (cliffCheck.ok) {
-    printSuccess("cliff.toml found");
-  } else {
-    console.info("");
-    const shouldCreate = await confirm("No cliff.toml found. Create one from the bundled template?");
-    if (shouldCreate) {
-      copyCliffTemplate(dryRun);
-    } else {
-      printError("cliff.toml is required for changelog generation. Aborting.");
-      return { status: "fail", overwrite: false };
-    }
-  }
-  const initCheck = notAlreadyInitialized();
-  if (!initCheck.ok) {
-    console.info("");
-    const shouldOverwrite = await confirm("release-kit appears to be already initialized. Overwrite existing files?");
-    if (!shouldOverwrite) {
-      console.info("Aborting.");
-      return { status: "abort", overwrite: false };
-    }
-    return { status: "pass", overwrite: true };
-  }
-  return { status: "pass", overwrite: false };
+  if (!runRequiredCheck("Git repository detected", isGitRepo())) return false;
+  if (!runRequiredCheck("package.json found", hasPackageJson())) return false;
+  if (!runRequiredCheck("pnpm detected", usesPnpm())) return false;
+  return true;
 }
-async function initCommand({ dryRun }) {
+function initCommand({ dryRun, force, withConfig }) {
   if (dryRun) {
     console.info("[dry-run mode]");
   }
-  let eligibility;
+  let eligible;
   try {
-    eligibility = await checkEligibility(dryRun);
+    eligible = checkEligibility();
   } catch (error) {
     printError(`Eligibility check failed: ${error instanceof Error ? error.message : String(error)}`);
     return 1;
   }
-  if (eligibility.status === "fail") return 1;
-  if (eligibility.status === "abort") return 0;
+  if (!eligible) return 1;
   printStep("Detecting repo type");
-  const repoType = detectRepoType();
+  let repoType;
+  try {
+    repoType = detectRepoType();
+  } catch (error) {
+    printError(`Failed to detect repo type: ${error instanceof Error ? error.message : String(error)}`);
+    return 1;
+  }
   printSuccess(`Detected: ${repoType}`);
   printStep("Scaffolding files");
-  scaffoldFiles({ repoType, dryRun, overwrite: eligibility.overwrite });
+  try {
+    scaffoldFiles({ repoType, dryRun, overwrite: force, withConfig });
+  } catch (error) {
+    printError(`Failed to scaffold files: ${error instanceof Error ? error.message : String(error)}`);
+    return 1;
+  }
   printStep("Next steps");
+  const configHint = withConfig ? "1. (Optional) Customize .config/release-kit.config.ts and .config/git-cliff.toml." : "1. (Optional) Run again with --with-config to scaffold config files.";
   console.info(`
-  1. (Optional) Customize .config/release-kit.config.ts to exclude components, override version patterns, add custom work types, etc.
+  ${configHint}
   2. Test by running: npx @williamthorsen/release-kit prepare --dry-run
-  3. Commit the generated workflow file (and config file if created).
+  3. Commit the generated files.
 `);
   return 0;
 }

package/dist/esm/init/prompt.d.ts

@@ -1,4 +1,3 @@
-export declare function confirm(question: string): Promise<boolean>;
 export declare function printStep(message: string): void;
 export declare function printSuccess(message: string): void;
 export declare function printSkip(message: string): void;

package/dist/esm/init/prompt.js

@@ -1,28 +1,17 @@
-import { createInterface } from "node:readline/promises";
-async function confirm(question) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const answer = await rl.question(`${question} (y/n) `);
-    return answer.trim().toLowerCase().startsWith("y");
-  } finally {
-    rl.close();
-  }
-}
 function printStep(message) {
   console.info(`
 > ${message}`);
 }
 function printSuccess(message) {
-  console.info(`  [ok] ${message}`);
+  console.info(`  \u2705 ${message}`);
 }
 function printSkip(message) {
-  console.info(`  [skip] ${message}`);
+  console.info(`  \u26A0\uFE0F ${message}`);
 }
 function printError(message) {
-  console.error(`  [error] ${message}`);
+  console.error(`  \u274C ${message}`);
 }
 export {
-  confirm,
   printError,
   printSkip,
   printStep,

package/dist/esm/init/scaffold.d.ts

@@ -3,7 +3,8 @@ interface ScaffoldOptions {
     repoType: RepoType;
     dryRun: boolean;
     overwrite: boolean;
+    withConfig: boolean;
 }
-export declare function copyCliffTemplate(dryRun: boolean): void;
-export declare function scaffoldFiles({ repoType, dryRun, overwrite }: ScaffoldOptions): void;
+export declare function copyCliffTemplate(dryRun: boolean, overwrite: boolean): void;
+export declare function scaffoldFiles({ repoType, dryRun, overwrite, withConfig }: ScaffoldOptions): void;
 export {};

package/dist/esm/init/scaffold.js

@@ -33,7 +33,7 @@ function writeIfAbsent(filePath, content, dryRun, overwrite) {
     printSuccess(`Created ${filePath}`);
   }
 }
-function copyCliffTemplate(dryRun) {
+function copyCliffTemplate(dryRun, overwrite) {
   const thisDir = dirname(fileURLToPath(import.meta.url));
   const templatePath = resolve(thisDir, "..", "..", "..", "cliff.toml.template");
   if (!existsSync(templatePath)) {
@@ -48,15 +48,13 @@ function copyCliffTemplate(dryRun) {
     printError(`Failed to read cliff.toml.template: ${message}`);
     return;
   }
-  writeIfAbsent("cliff.toml", content, dryRun, false);
+  writeIfAbsent(".config/git-cliff.toml", content, dryRun, overwrite);
 }
-function scaffoldFiles({ repoType, dryRun, overwrite }) {
-  const files = [
-    { path: ".config/release-kit.config.ts", content: releaseConfigScript(repoType) },
-    { path: ".github/workflows/release.yaml", content: releaseWorkflow(repoType) }
-  ];
-  for (const file of files) {
-    writeIfAbsent(file.path, file.content, dryRun, overwrite);
+function scaffoldFiles({ repoType, dryRun, overwrite, withConfig }) {
+  writeIfAbsent(".github/workflows/release.yaml", releaseWorkflow(repoType), dryRun, overwrite);
+  if (withConfig) {
+    writeIfAbsent(".config/release-kit.config.ts", releaseConfigScript(repoType), dryRun, overwrite);
+    copyCliffTemplate(dryRun, overwrite);
   }
 }
 export {

package/dist/esm/prepareCommand.js

@@ -24,7 +24,7 @@ async function prepareCommand(argv) {
     if (errors.length > 0) {
       console.error("Invalid config:");
       for (const err of errors) {
-        console.error(`  - ${err}`);
+        console.error(`  \u274C ${err}`);
       }
       process.exit(1);
     }

package/dist/esm/resolveCliffConfigPath.d.ts

@@ -0,0 +1 @@
+export declare function resolveCliffConfigPath(cliffConfigPath: string | undefined, metaUrl: string): string;

package/dist/esm/resolveCliffConfigPath.js

@@ -0,0 +1,25 @@
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+function resolveCliffConfigPath(cliffConfigPath, metaUrl) {
+  if (cliffConfigPath !== void 0) {
+    return cliffConfigPath;
+  }
+  const candidates = [".config/git-cliff.toml", "cliff.toml"];
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  const thisDir = dirname(fileURLToPath(metaUrl));
+  const bundledPath = resolve(thisDir, "..", "..", "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}`
+  );
+}
+export {
+  resolveCliffConfigPath
+};

package/dist/esm/runReleasePrepare.d.ts

@@ -1,5 +1,5 @@
 import type { MonorepoReleaseConfig, ReleaseConfig, ReleaseType } from './types.ts';
-export declare const RELEASE_TAGS_FILE = "/tmp/release-kit/.release-tags";
+export declare const RELEASE_TAGS_FILE = "tmp/.release-tags";
 export declare function parseArgs(argv: string[]): {
     dryRun: boolean;
     force: boolean;

package/dist/esm/runReleasePrepare.js

@@ -2,7 +2,7 @@ import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
 import { releasePrepare } from "./releasePrepare.js";
 import { releasePrepareMono } from "./releasePrepareMono.js";
-const RELEASE_TAGS_FILE = "/tmp/release-kit/.release-tags";
+const RELEASE_TAGS_FILE = "tmp/.release-tags";
 const VALID_BUMP_TYPES = ["major", "minor", "patch"];
 function isReleaseType(value) {
   return VALID_BUMP_TYPES.includes(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "2.0.0",
+  "version": "2.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",