@williamthorsen/release-kit 10.8.0 → 11.0.0

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

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
 import { parseArgsOrExit, readPackageVersion, reportError } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
-import { checkWorkTypesDrift } from "../checkWorkTypesDrift.js";
 import { commitCommand } from "../commitCommand.js";
+import { configFlagSchema } from "../configFlagSchema.js";
 import { createGithubReleaseCommand } from "../createGithubReleaseCommand.js";
 import { showPrepareHelp } from "../help/prepareHelp.js";
 import { initCommand } from "../init/initCommand.js";
 import { prepareCommand } from "../prepareCommand.js";
 import { publishCommand } from "../publishCommand.js";
 import { pushCommand } from "../pushCommand.js";
+import { OUTPUT_STYLE_ENV_VAR, resolveStylesOrExit } from "../resolveStylesOrExit.js";
 import { showTagPrefixesCommand } from "../showTagPrefixesCommand.js";
 import { generateCommand } from "../sync-labels/generateCommand.js";
 import { syncLabelsInitCommand } from "../sync-labels/initCommand.js";
 import { syncLabelsCommand } from "../sync-labels/syncCommand.js";
-import { syncWorkTypes } from "../syncWorkTypes.js";
 import { tagCommand } from "../tagCommand.js";
 import { validateOverridesCommand } from "../validateOverridesCommand.js";
 const VERSION = readPackageVersion(import.meta.url);
@@ -32,12 +32,16 @@ Commands:
   init             Initialize release-kit in the current repository
   overrides        Manage editorial changelog overrides
   sync-labels      Manage GitHub label synchronization
-  work-types       Check for or sync work-type taxonomy drift against the upstream canonical
 
 Options:
   --dry-run        Preview changes without writing files
   --help, -h       Show this help message
   --version, -V    Show the version number
+
+Environment:
+  ${OUTPUT_STYLE_ENV_VAR}
+                   Output style: auto (default), plain, or rich. auto prints plain,
+                   without emoji, when CI is set or the stream is not a terminal.
 `);
 }
 function showSyncLabelsHelp() {
@@ -65,9 +69,10 @@ retired packages, then generate .github/labels.yaml. When the config file alread
 exists, print the block for manual paste instead of rewriting the file.
 
 Options:
-  --dry-run     Preview changes without writing files
-  --force       Overwrite existing files instead of skipping them
-  --help, -h    Show this help message
+  --config <path>  Path to config file (default: .config/release-kit.config.ts)
+  --dry-run        Preview changes without writing files
+  --force          Overwrite existing files instead of skipping them
+  --help, -h       Show this help message
 `);
 }
 function showSyncLabelsGenerateHelp() {
@@ -77,8 +82,9 @@ Usage: release-kit sync-labels generate [options]
 Regenerate .github/labels.yaml from the repoLabels block of .config/release-kit.config.ts.
 
 Options:
-  --check       Report whether .github/labels.yaml is stale instead of writing it
-  --help, -h    Show this help message
+  --check          Report whether .github/labels.yaml is stale instead of writing it
+  --config <path>  Path to config file (default: .config/release-kit.config.ts)
+  --help, -h       Show this help message
 `);
 }
 function showSyncLabelsSyncHelp() {
@@ -151,6 +157,7 @@ Create GitHub Releases from changelog.json for tags on HEAD. Private
 (package.json#private) workspaces are skipped with a warning and get no Release.
 
 Options:
+  --config <path>        Path to config file (default: .config/release-kit.config.ts)
   --dry-run              Preview without creating releases
   --tags=tag1,tag2       Only create releases for the named tags (comma-separated, full tag names)
   --help, -h             Show this help message
@@ -166,7 +173,8 @@ derived prefix nor declared in \`legacyIdentities\`, with a copy-pasteable
 config snippet.
 
 Options:
-  --help, -h    Show this help message
+  --config <path>  Path to config file (default: .config/release-kit.config.ts)
+  --help, -h       Show this help message
 `);
 }
 function showOverridesHelp() {
@@ -195,50 +203,8 @@ Exit codes:
   2    Schema/parse or ambiguous-prefix errors (errors dominate)
 
 Options:
-  --help, -h    Show this help message
-`);
-}
-function showWorkTypesHelp() {
-    console.info(`
-Usage: release-kit work-types <subcommand>
-
-Manage the canonical work-types taxonomy used by changelog and release-notes generation.
-
-Subcommands:
-  check         Compare the local work-types.json against the upstream codeassembly canonical
-  sync          Overwrite the local work-types.json with the upstream contents
-
-Exit codes (check):
-  0    Match (or upstream not found, with a warning)
-  1    Drift detected
-  2    Network error
-  3    Schema mismatch
-
-Options:
-  --help, -h    Show this help message
-`);
-}
-function showWorkTypesCheckHelp() {
-    console.info(`
-Usage: release-kit work-types check
-
-Compare the local work-types.json against the upstream codeassembly canonical and report
-drift. Exit 0 on match, 1 on drift, 0 + warning when upstream is not found, 2 on network
-error, 3 on schema mismatch.
-
-Options:
-  --help, -h    Show this help message
-`);
-}
-function showWorkTypesSyncHelp() {
-    console.info(`
-Usage: release-kit work-types sync
-
-Fetch the upstream work-types.json, validate its top-level shape, and overwrite the local
-copy with the upstream content (formatted with 2-space indent + trailing newline).
-
-Options:
-  --help, -h    Show this help message
+  --config <path>  Path to config file (default: .config/release-kit.config.ts)
+  --help, -h       Show this help message
 `);
 }
 function showPublishHelp() {
@@ -251,6 +217,7 @@ silently filtered out. With --tags, an unpublishable tag is skipped with a warni
 any publishable tags still publish.
 
 Options:
+  --config <path>        Path to config file (default: .config/release-kit.config.ts)
   --dry-run              Preview without publishing
   --no-git-checks        Skip the clean-working-tree check
   --tags=tag1,tag2       Only publish the named tags (comma-separated, full tag names)
@@ -269,12 +236,17 @@ if (command === undefined || ['--help', '-h'].includes(command)) {
     process.exit(0);
 }
 const flags = args.slice(1);
+const styles = resolveStylesOrExit({
+    env: process.env,
+    stderrIsTty: process.stderr.isTTY,
+    stdoutIsTty: process.stdout.isTTY,
+});
 if (command === 'prepare') {
     if (flags.some((f) => f === '--help' || f === '-h')) {
         showPrepareHelp();
         process.exit(0);
     }
-    await prepareCommand(flags);
+    await prepareCommand(flags, styles);
     process.exit(0);
 }
 if (command === 'commit') {
@@ -296,7 +268,7 @@ if (command === 'tag') {
         showTagHelp();
         process.exit(0);
     }
-    tagCommand(flags);
+    tagCommand(flags, styles);
     process.exit(0);
 }
 if (command === 'push') {
@@ -304,7 +276,7 @@ if (command === 'push') {
         showPushHelp();
         process.exit(0);
     }
-    await pushCommand(flags);
+    pushCommand(flags);
     process.exit(0);
 }
 if (command === 'create-github-release') {
@@ -312,7 +284,7 @@ if (command === 'create-github-release') {
         showCreateGithubReleaseHelp();
         process.exit(0);
     }
-    await createGithubReleaseCommand(flags);
+    await createGithubReleaseCommand(flags, styles);
     process.exit(0);
 }
 if (command === 'publish') {
@@ -320,7 +292,7 @@ if (command === 'publish') {
         showPublishHelp();
         process.exit(0);
     }
-    await publishCommand(flags);
+    await publishCommand(flags, styles);
     process.exit(0);
 }
 if (command === 'show-tag-prefixes') {
@@ -328,11 +300,8 @@ if (command === 'show-tag-prefixes') {
         showShowTagPrefixesHelp();
         process.exit(0);
     }
-    if (flags.length > 0) {
-        reportError(`Unknown option: ${flags[0]}`);
-        process.exit(1);
-    }
-    const exitCode = await showTagPrefixesCommand();
+    const { config } = parseArgsOrExit(flags, configFlagSchema).flags;
+    const exitCode = await showTagPrefixesCommand(styles, config);
     process.exit(exitCode);
 }
 if (command === 'init') {
@@ -346,7 +315,7 @@ if (command === 'init') {
         withConfig: { long: '--with-config', type: 'boolean' },
     };
     const { dryRun, force, withConfig } = parseArgsOrExit(flags, initFlagSchema).flags;
-    const exitCode = initCommand({ dryRun, force, withConfig });
+    const exitCode = initCommand({ dryRun, force, styles, withConfig });
     process.exit(exitCode);
 }
 if (command === 'sync-labels') {
@@ -362,11 +331,17 @@ if (command === 'sync-labels') {
             process.exit(0);
         }
         const syncLabelsInitFlagSchema = {
+            ...configFlagSchema,
             dryRun: { long: '--dry-run', type: 'boolean' },
             force: { long: '--force', type: 'boolean' },
         };
-        const { dryRun, force } = parseArgsOrExit(subflags, syncLabelsInitFlagSchema).flags;
-        const exitCode = await syncLabelsInitCommand({ dryRun, force });
+        const { config, dryRun, force } = parseArgsOrExit(subflags, syncLabelsInitFlagSchema).flags;
+        const exitCode = await syncLabelsInitCommand({
+            ...(config !== undefined && { configPath: config }),
+            dryRun,
+            force,
+            styles,
+        });
         process.exit(exitCode);
     }
     if (subcommand === 'generate') {
@@ -375,10 +350,11 @@ if (command === 'sync-labels') {
             process.exit(0);
         }
         const generateFlagSchema = {
+            ...configFlagSchema,
             check: { long: '--check', type: 'boolean' },
         };
-        const { check } = parseArgsOrExit(subflags, generateFlagSchema).flags;
-        const exitCode = await generateCommand({ check });
+        const { check, config } = parseArgsOrExit(subflags, generateFlagSchema).flags;
+        const exitCode = await generateCommand({ check, ...(config !== undefined && { configPath: config }), styles });
         process.exit(exitCode);
     }
     if (subcommand === 'sync') {
@@ -409,11 +385,8 @@ if (command === 'overrides') {
             showOverridesValidateHelp();
             process.exit(0);
         }
-        if (subflags.length > 0) {
-            reportError(`Unknown option: ${subflags[0]}`);
-            process.exit(1);
-        }
-        const result = await validateOverridesCommand();
+        const { config } = parseArgsOrExit(subflags, configFlagSchema).flags;
+        const result = await validateOverridesCommand(styles, config);
         if (result.exitCode === 0) {
             console.info(result.message);
         }
@@ -426,53 +399,6 @@ if (command === 'overrides') {
     showOverridesHelp();
     process.exit(1);
 }
-if (command === 'work-types') {
-    const subcommand = flags[0];
-    if (subcommand === undefined || ['--help', '-h'].includes(subcommand)) {
-        showWorkTypesHelp();
-        process.exit(0);
-    }
-    const subflags = flags.slice(1);
-    if (subcommand === 'check') {
-        if (subflags.some((f) => f === '--help' || f === '-h')) {
-            showWorkTypesCheckHelp();
-            process.exit(0);
-        }
-        if (subflags.length > 0) {
-            reportError(`Unknown option: ${subflags[0]}`);
-            process.exit(1);
-        }
-        const result = await checkWorkTypesDrift();
-        if (result.exitCode === 0) {
-            console.info(result.message);
-        }
-        else {
-            process.stderr.write(`${result.message}\n`);
-        }
-        process.exit(result.exitCode);
-    }
-    if (subcommand === 'sync') {
-        if (subflags.some((f) => f === '--help' || f === '-h')) {
-            showWorkTypesSyncHelp();
-            process.exit(0);
-        }
-        if (subflags.length > 0) {
-            reportError(`Unknown option: ${subflags[0]}`);
-            process.exit(1);
-        }
-        const result = await syncWorkTypes();
-        if (result.exitCode === 0) {
-            console.info(result.message);
-        }
-        else {
-            process.stderr.write(`${result.message}\n`);
-        }
-        process.exit(result.exitCode);
-    }
-    reportError(`Unknown subcommand: ${subcommand}`);
-    showWorkTypesHelp();
-    process.exit(1);
-}
 reportError(`Unknown command: ${command}`);
 showUsage();
 process.exit(1);

package/dist/esm/buildChangelogEntries.js

@@ -158,6 +158,7 @@ function extractDescription(message) {
     return firstLine;
 }
 const TRAILER_PATTERNS = [
+    /^Change:/i,
     /^Signed-off-by:/i,
     /^Co-authored-by:/i,
     /^(Closes|Fixes|Resolves)\s+#\d+\s*$/i,

package/dist/esm/configFlagSchema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The `--config` flag, shared by every subcommand that reads the config file.
+ *
+ * Spread into a subcommand's own schema rather than repeated, so that seven subcommands cannot drift to seven
+ * spellings of one flag.
+ */
+export declare const configFlagSchema: {
+    config: {
+        long: string;
+        type: "string";
+    };
+};

package/dist/esm/configFlagSchema.js

@@ -0,0 +1,3 @@
+export const configFlagSchema = {
+    config: { long: '--config', type: 'string' },
+};

package/dist/esm/createGithubReleaseCommand.d.ts

@@ -1,3 +1,4 @@
+import { type StreamStyles } from '@williamthorsen/nmr-core';
 /**
  * Orchestrate the CLI `create-github-release` command: Create GitHub Releases from changelog.json
  * for tags on HEAD (or a comma-separated `--tags` subset), without requiring npm publish.
@@ -5,4 +6,4 @@
  * Private/unpublishable workspaces are skipped with a warning and never get a Release, matching
  * `release-kit publish`; an all-private tag set is a clean no-op.
  */
-export declare function createGithubReleaseCommand(argv: string[]): Promise<void>;
+export declare function createGithubReleaseCommand(argv: string[], styles: StreamStyles): Promise<void>;

package/dist/esm/createGithubReleaseCommand.js

@@ -1,19 +1,23 @@
 import { parseArgsOrExit, reportError } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
+import { configFlagSchema } from "./configFlagSchema.js";
 import { createGithubReleases } from "./createGithubRelease.js";
 import { formatPrivateSkip } from "./formatPrivateSkip.js";
+import { assertConfigUsable } from "./loadValidatedConfig.js";
 import { parseRequestedTags } from "./parseRequestedTags.js";
 import { resolveCommandTags } from "./resolveCommandTags.js";
 import { resolveReleaseNotesConfig } from "./resolveReleaseNotesConfig.js";
 const createGithubReleaseFlagSchema = {
+    ...configFlagSchema,
     dryRun: { long: '--dry-run', type: 'boolean' },
     tags: { long: '--tags', type: 'string' },
 };
-export async function createGithubReleaseCommand(argv) {
+export async function createGithubReleaseCommand(argv, styles) {
     const parsed = parseArgsOrExit(argv, createGithubReleaseFlagSchema);
     const { dryRun } = parsed.flags;
+    await assertConfigUsable(styles.stderr, parsed.flags.config);
     const requestedTags = parseRequestedTags(parsed.flags.tags);
-    const resolvedTags = await resolveCommandTags(requestedTags);
+    const resolvedTags = resolveCommandTags(requestedTags);
     const publishableTags = resolvedTags.filter((resolvedTag) => resolvedTag.isPublishable);
     for (const resolvedTag of resolvedTags) {
         if (!resolvedTag.isPublishable) {
@@ -23,7 +27,9 @@ export async function createGithubReleaseCommand(argv) {
     if (publishableTags.length === 0) {
         return;
     }
-    const { changelogJsonOutputPath, sectionOrder } = await resolveReleaseNotesConfig({ strictLoad: true });
+    const { changelogJsonOutputPath, sectionOrder } = await resolveReleaseNotesConfig(styles.stderr, {
+        ...(parsed.flags.config !== undefined && { configPath: parsed.flags.config }),
+    });
     let outcome;
     try {
         outcome = createGithubReleases(publishableTags, changelogJsonOutputPath, dryRun, sectionOrder);

package/dist/esm/createTags.d.ts

@@ -1,6 +1,8 @@
+import { type OutputStyle } from '@williamthorsen/nmr-core';
 export interface CreateTagsOptions {
     dryRun: boolean;
     noGitChecks: boolean;
+    style: OutputStyle;
 }
 /**
  * Read tag names from the tags file produced by `prepare` and create annotated git tags.

package/dist/esm/createTags.js

@@ -1,9 +1,10 @@
 import { execFileSync } from 'node:child_process';
-import { GIT_OUTPUT_LIMIT, hasErrnoCode } from '@williamthorsen/nmr-core';
+import { formatGlyphLine, GIT_OUTPUT_LIMIT, hasErrnoCode } from '@williamthorsen/nmr-core';
 import { deleteFileIfExists } from "./deleteFileIfExists.js";
+import { RELEASE_GLYPHS } from "./glyphs.js";
 import { readReleaseTags, RELEASE_SUMMARY_FILE, RELEASE_TAGS_FILE } from "./releaseFiles.js";
 export function createTags(options) {
-    const { dryRun, noGitChecks } = options;
+    const { dryRun, noGitChecks, style } = options;
     const tags = readReleaseTags();
     if (tags.length === 0) {
         return [];
@@ -14,7 +15,7 @@ export function createTags(options) {
     if (dryRun) {
         console.info('[dry-run] Would create tags:');
         for (const tag of tags) {
-            console.info(`🏷️ ${tag}`);
+            console.info(formatGlyphLine(RELEASE_GLYPHS, style, 'tag', tag));
         }
         return tags;
     }
@@ -36,7 +37,7 @@ export function createTags(options) {
     }
     console.info('Created tags:');
     for (const tag of tags) {
-        console.info(`🏷️ ${tag}`);
+        console.info(formatGlyphLine(RELEASE_GLYPHS, style, 'tag', tag));
     }
     deleteFileIfExists(RELEASE_TAGS_FILE);
     deleteFileIfExists(RELEASE_SUMMARY_FILE);

package/dist/esm/discoverWorkspaces.d.ts

@@ -1,13 +1,58 @@
+import { type EmptyWorkspaceCause } from '@williamthorsen/nmr-core/workspace';
+export type { EmptyWorkspaceCause } from '@williamthorsen/nmr-core/workspace';
 /**
- * Reads `pnpm-workspace.yaml` and resolves its `packages` globs to discover workspace directories.
+ * What release-kit's workspace discovery produced: the repo releases as a single package, it resolves to a
+ * set of package directories, or it declares a workspace that resolves to none and the cause says which
+ * condition emptied it.
  *
- * Returns an array of workspace-relative directory paths (e.g., `['packages/arrays', 'packages/strings']`).
- * Only directories containing a `package.json` are included.
+ * Held apart from nmr-core's `WorkspaceResolution`, whose `packageDirs` are absolute, because these are
+ * relative to the monorepo root. The two carry incompatible path contracts, and a distinct `kind` for the
+ * single-package case keeps either from standing in for the other.
+ */
+export type WorkspaceDiscovery = {
+    kind: 'empty';
+    cause: FailingWorkspaceCause;
+    patterns: string[];
+} | {
+    kind: 'packages';
+    packageDirs: string[];
+    patterns: string[];
+} | {
+    kind: 'single-package';
+};
+/** A workspace that resolved to no package directory, which every release-kit command treats as a failure. */
+export type EmptyWorkspace = Extract<WorkspaceDiscovery, {
+    kind: 'empty';
+}>;
+/**
+ * The empty-workspace causes that reach a command as a failure.
+ *
+ * `no-packages-list` is absent because a manifest declaring nothing releases as a single package, so no
+ * command ever composes a message for it.
+ */
+export type FailingWorkspaceCause = Exclude<EmptyWorkspaceCause, 'no-packages-list'>;
+/**
+ * Returns the sentence naming which of the five conditions left a workspace holding no package directory, and
+ * the remedy for that one. Each quotes the `packages` list the manifest declares, apart from the two that
+ * reach the matcher with no list to quote.
+ *
+ * The `package.json` requirement is stated under `no-package` because it is a divergence from pnpm, which
+ * recognizes two further manifests, and the reader of a workspace that pnpm resolves has no way to infer it.
+ */
+export declare function describeEmptyWorkspace(workspace: EmptyWorkspace): string;
+/**
+ * Reads `pnpm-workspace.yaml` at `monorepoRoot` and resolves its `packages` patterns, applying pnpm's
+ * semantics — `!`-prefixed exclusions included.
  *
- * Note: The returned paths are full relative paths from the repo root (e.g., `packages/arrays`,
- * `libs/core`). These paths are passed directly to `deriveWorkspaceConfig()`, which uses them for all
- * file path construction and derives the display name via `path.basename()`.
+ * A directory holding no manifest, and one whose manifest declares no `packages` list, both release as a
+ * single package: pnpm resolves each to the root package alone, and a workspace file kept for `catalog:`,
+ * `overrides:`, or `onlyBuiltDependencies:` is the second of them. Every other empty resolution is a failure,
+ * whether the reader declared patterns that matched nothing or a `packages` value the resolver could not read
+ * as patterns at all.
  *
- * @returns The discovered workspace paths, or `undefined` if no workspace config is found.
+ * `packageDirs` come back relative to `monorepoRoot` as POSIX paths, because that is what every consumer
+ * needs: `WorkspaceConfig.paths` feeds `git log -- <paths>`, and `packageFiles` and `changelogPaths` are read
+ * from disk relative to the working directory. The workspace root itself relativizes to `.`, the path
+ * `deriveWorkspaceConfig` reads a root package's manifest through.
  */
-export declare function discoverWorkspaces(): Promise<string[] | undefined>;
+export declare function discoverWorkspaces(monorepoRoot?: string): WorkspaceDiscovery;

package/dist/esm/discoverWorkspaces.js

@@ -1,42 +1,62 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { describeError } from '@williamthorsen/toolbelt.errors';
-import { glob } from 'glob';
-import { parse } from 'yaml';
-import { isRecord } from "./typeGuards.js";
-export async function discoverWorkspaces() {
-    const workspaceFile = 'pnpm-workspace.yaml';
-    if (!existsSync(workspaceFile)) {
-        return undefined;
-    }
-    let content;
-    try {
-        content = readFileSync(workspaceFile, 'utf8');
-    }
-    catch (error) {
-        console.warn(`Warning: Failed to read ${workspaceFile}: ${describeError(error)}`);
-        return undefined;
-    }
-    const parsed = parse(content);
-    if (!isRecord(parsed)) {
-        return undefined;
+import path from 'node:path';
+import { resolveWorkspace } from '@williamthorsen/nmr-core/workspace';
+export function describeEmptyWorkspace(workspace) {
+    const declaredClause = describeDeclaredPatterns(workspace.patterns);
+    switch (workspace.cause) {
+        case 'all-excluded':
+            return (`pnpm-workspace.yaml ${declaredClause}, whose \`!\` entries exclude every directory matched by the ` +
+                'positive patterns. Drop or narrow the exclusion.');
+        case 'no-package':
+            return (`pnpm-workspace.yaml ${declaredClause}, and the matcher found no directory holding a \`package.json\`. ` +
+                'Add one to the directory that should be a package, or declare a pattern reaching a directory that ' +
+                'holds one.');
+        case 'no-pattern':
+            return (`pnpm-workspace.yaml ${declaredClause}, so no pattern reaches the matcher. Declare a positive pattern ` +
+                'such as `packages/*`, and quote any `!` entry, which YAML reads as a tag rather than a string where ' +
+                'it stands bare.');
+        case 'unreadable-manifest':
+            return ('pnpm-workspace.yaml holds no valid YAML, so nothing it declares reaches the matcher. Repair the ' +
+                'syntax error and run the command again. An unterminated quoted string and a mis-indented entry are ' +
+                'the usual ones.');
+        case 'unreadable-packages':
+            return ('pnpm-workspace.yaml declares a `packages` value that is not a list of strings, so nothing it ' +
+                'declares reaches the matcher. Make it a list whose every entry is a quoted pattern; a bare value ' +
+                'and an entry YAML read as a number or a map are the usual ones.');
+        default: {
+            const unhandledCause = workspace.cause;
+            throw new Error(`Unhandled empty-workspace cause: ${String(unhandledCause)}`);
+        }
     }
-    const packagesField = parsed['packages'];
-    if (!Array.isArray(packagesField)) {
-        return undefined;
+}
+export function discoverWorkspaces(monorepoRoot = process.cwd()) {
+    const resolution = resolveWorkspace(monorepoRoot);
+    if (resolution.kind === 'not-a-workspace') {
+        return { kind: 'single-package' };
     }
-    const patterns = packagesField.filter((p) => typeof p === 'string');
-    if (patterns.length === 0) {
-        return undefined;
+    if (resolution.kind === 'empty') {
+        const { cause, patterns } = resolution;
+        return cause === 'no-packages-list' ? { kind: 'single-package' } : { cause, kind: 'empty', patterns };
     }
-    const directories = [];
-    for (const pattern of patterns) {
-        const matches = await glob(pattern, { posix: true });
-        for (const match of matches) {
-            if (existsSync(join(match, 'package.json'))) {
-                directories.push(match);
-            }
-        }
+    return {
+        ...resolution,
+        packageDirs: resolution.packageDirs.map((packageDir) => relativizeToPosix(monorepoRoot, packageDir)),
+    };
+}
+function describeDeclaredPatterns(patterns) {
+    const quotablePatterns = patterns.filter((pattern) => pattern.trim() !== '');
+    const emptiedCount = patterns.length - quotablePatterns.length;
+    if (emptiedCount === 0) {
+        return `declares ${renderQuotedList(patterns)}`;
     }
-    return directories.length > 0 ? [...directories].sort() : undefined;
+    const emptiedClause = `${String(emptiedCount)} ${emptiedCount === 1 ? 'entry' : 'entries'} that YAML left empty`;
+    return quotablePatterns.length === 0
+        ? `declares ${emptiedClause}`
+        : `declares ${renderQuotedList(quotablePatterns)}, beside ${emptiedClause}`;
+}
+function relativizeToPosix(monorepoRoot, packageDir) {
+    const relativeDir = path.relative(monorepoRoot, packageDir);
+    return relativeDir === '' ? '.' : relativeDir.split(path.sep).join('/');
+}
+function renderQuotedList(patterns) {
+    return patterns.map((pattern) => `\`${pattern}\``).join(', ');
 }

package/dist/esm/format.d.ts

@@ -1,6 +1,6 @@
-/** Wrap text in ANSI bold. */
-export declare function bold(text: string): string;
-/** Wrap text in ANSI dim. */
-export declare function dim(text: string): string;
-/** Render a section header for separating workspaces in CLI output. */
+/** Styles text bold, returning it unstyled for a stream that cannot render color. */
+export declare function bold(text: string, stream?: NodeJS.WritableStream): string;
+/** Styles text dim, returning it unstyled for a stream that cannot render color. */
+export declare function dim(text: string, stream?: NodeJS.WritableStream): string;
+/** Renders a section header for separating workspaces in CLI output. */
 export declare function sectionHeader(name: string): string;

package/dist/esm/format.js

@@ -1,8 +1,9 @@
-export function bold(text) {
-    return `\u{1B}[1m${text}\u{1B}[0m`;
+import { styleText } from 'node:util';
+export function bold(text, stream = process.stdout) {
+    return styleText('bold', text, { stream });
 }
-export function dim(text) {
-    return `\u{1B}[2m${text}\u{1B}[0m`;
+export function dim(text, stream = process.stdout) {
+    return styleText('dim', text, { stream });
 }
 export function sectionHeader(name) {
     return `━━━ ${name} ━━━`;

package/dist/esm/glyphs.d.ts

@@ -0,0 +1,3 @@
+/** Glyphs that name no status; a status marker comes from nmr-core's `STATUS_GLYPHS`. */
+export declare const RELEASE_GLYPHS: Readonly<Record<"plain" | "rich", Readonly<Record<"bump" | "dryRun" | "tag", import("@williamthorsen/toolbelt.terminal/candidate").Glyph>>>>;
+export type ReleaseGlyphName = keyof (typeof RELEASE_GLYPHS)['rich'];

package/dist/esm/glyphs.js

@@ -0,0 +1,6 @@
+import { defineGlyphSet } from '@williamthorsen/nmr-core';
+export const RELEASE_GLYPHS = defineGlyphSet({
+    bump: { plain: 'BUMP', rich: '📦' },
+    dryRun: { plain: '', rich: '🔍' },
+    tag: { plain: 'TAG', rich: '🔖' },
+});