@williamthorsen/release-kit 10.8.0 → 10.9.0

package/dist/esm/showTagPrefixesCommand.js

@@ -1,12 +1,13 @@
+import { formatStatusLine } from '@williamthorsen/nmr-core';
 import { detectRepoType } from "./init/detectRepoType.js";
 import { previewTagPrefixes } from "./previewTagPrefixes.js";
-export async function showTagPrefixesCommand() {
+export async function showTagPrefixesCommand(styles) {
     if (detectRepoType() === 'single-package') {
         process.stdout.write(renderSinglePackage());
         return 0;
     }
     const preview = await previewTagPrefixes();
-    process.stdout.write(renderMonorepo(preview));
+    process.stdout.write(renderMonorepo(preview, styles.stdout));
     return computeExitCode(preview);
 }
 function renderSinglePackage() {
@@ -17,13 +18,13 @@ function renderSinglePackage() {
     ];
     return lines.join('\n');
 }
-function renderMonorepo(preview) {
+function renderMonorepo(preview, style) {
     const lines = ['Workspace tag prefixes:', ''];
     for (const row of preview.workspaces) {
-        lines.push(...renderWorkspaceRow(row));
+        lines.push(...renderWorkspaceRow(row, style));
     }
     if (preview.collisions.length > 0) {
-        lines.push('', ...preview.collisions.map((collision) => `⛔ tag prefix collision: '${collision.tagPrefix}' used by ${collision.workspacePaths.join(', ')}`));
+        lines.push('', ...preview.collisions.map((collision) => formatStatusLine(style, 'failed', `tag prefix collision: '${collision.tagPrefix}' used by ${collision.workspacePaths.join(', ')}`)));
     }
     if (preview.undeclaredCandidates.length > 0) {
         lines.push('', 'Undeclared tag prefixes:', '', ...preview.undeclaredCandidates.map((candidate) => `  '${candidate.prefix}' — ${candidate.tagCount} tags (e.g., ${candidate.exampleTags.join(', ')})`), '', 'Suggested config snippet (adjust `dir` to match your workspace if the guess is wrong, and replace the `name` placeholder with the legacy npm name):', '', renderSuggestedSnippet(preview.undeclaredCandidates), '', "If the suggested `dir` does not match your workspace, adjust before pasting. Each legacy identity requires a `name` — replace the `TODO-fill-in-legacy-npm-name` placeholder with the package's prior npm name.");
@@ -31,20 +32,25 @@ function renderMonorepo(preview) {
     lines.push('');
     return lines.join('\n');
 }
-function renderWorkspaceRow(row) {
+function renderWorkspaceRow(row, style) {
     const lines = [];
     if (row.derivedPrefix === null) {
-        lines.push(`  ${row.workspacePath} — ⛔ derivation failed: ${row.derivationError ?? 'unknown error'}`);
+        const failure = formatStatusLine(style, 'failed', `derivation failed: ${row.derivationError ?? 'unknown error'}`);
+        lines.push(`  ${row.workspacePath} — ${failure}`);
         return lines;
     }
-    const statusMarker = row.derivedTagCount > 0 ? `✅ ${row.derivedTagCount} tags` : '⚠️ no existing tags';
+    const statusMarker = row.derivedTagCount > 0
+        ? formatStatusLine(style, 'passed', `${row.derivedTagCount} tags`)
+        : formatStatusLine(style, 'warning', 'no existing tags');
     lines.push(`  ${row.workspacePath} — derived prefix '${row.derivedPrefix}', ${statusMarker}`);
     for (const entry of row.legacyEntries) {
         if (entry.tagCount > 0) {
-            lines.push(`      ✅ ${entry.tagCount} legacy tags with '${entry.prefix}' prefix (recognized)`);
+            const recognized = `${entry.tagCount} legacy tags with '${entry.prefix}' prefix (recognized)`;
+            lines.push(`      ${formatStatusLine(style, 'passed', recognized)}`);
         }
         else {
-            lines.push(`      ⚠️ recorded legacy prefix '${entry.prefix}' has no tags`);
+            const tagless = `recorded legacy prefix '${entry.prefix}' has no tags`;
+            lines.push(`      ${formatStatusLine(style, 'warning', tagless)}`);
         }
     }
     return lines;

package/dist/esm/sync-labels/generateCommand.d.ts

@@ -1,3 +1,4 @@
+import { type OutputStyle, type StreamStyles } from '@williamthorsen/nmr-core';
 import type { RepoLabelsConfig } from '../types.js';
 import type { LabelDefinition } from './types.js';
 /** Output path for the generated labels file. */
@@ -10,11 +11,12 @@ export declare function formatLabelsYaml(labels: LabelDefinition[], presetHashes
  * Reports an actionable error and returns `undefined` when the config file is missing,
  * fails to load or validate, or carries no `repoLabels` block.
  */
-export declare function loadRepoLabelsConfig(): Promise<RepoLabelsConfig | undefined>;
+export declare function loadRepoLabelsConfig(stderrStyle: OutputStyle): Promise<RepoLabelsConfig | undefined>;
 /** Options for the `sync-labels generate` subcommand. */
 interface GenerateOptions {
     /** Compare the regenerated content against the committed file instead of writing. */
     check?: boolean;
+    styles: StreamStyles;
 }
 /**
  * Runs the `sync-labels generate` command.
@@ -23,5 +25,5 @@ interface GenerateOptions {
  * and writes `.github/labels.yaml` -- or, with `check`, regenerates in memory and reports whether the committed file
  * is stale, writing nothing. Returns 0 on success, 1 on failure.
  */
-export declare function generateCommand({ check }?: GenerateOptions): Promise<number>;
+export declare function generateCommand({ check, styles }: GenerateOptions): Promise<number>;
 export {};

package/dist/esm/sync-labels/generateCommand.js

@@ -19,8 +19,8 @@ export function formatLabelsYaml(labels, presetHashes) {
     const yamlBody = stringify(declared, { singleQuote: true, lineWidth: 0 });
     return headerLines.join('\n') + '\n' + yamlBody;
 }
-export async function loadRepoLabelsConfig() {
-    const result = await loadValidatedConfig();
+export async function loadRepoLabelsConfig(stderrStyle) {
+    const result = await loadValidatedConfig(stderrStyle);
     if (result.status === 'missing') {
         reportError(`No config file found at ${CONFIG_FILE_PATH}. Run \`release-kit sync-labels init\` first.`);
         return undefined;
@@ -34,11 +34,11 @@ export async function loadRepoLabelsConfig() {
     }
     return result.config.repoLabels;
 }
-export async function generateCommand({ check = false } = {}) {
+export async function generateCommand({ check = false, styles }) {
     if (checkRetiredSyncLabelsConfig()) {
         return 1;
     }
-    const repoLabels = await loadRepoLabelsConfig();
+    const repoLabels = await loadRepoLabelsConfig(styles.stderr);
     if (repoLabels === undefined) {
         return 1;
     }

package/dist/esm/sync-labels/initCommand.d.ts

@@ -1,7 +1,9 @@
+import { type StreamStyles } from '@williamthorsen/nmr-core';
 /** Options for the `sync-labels init` subcommand. */
 interface InitOptions {
     dryRun: boolean;
     force: boolean;
+    styles: StreamStyles;
 }
 /**
  * Run the `sync-labels init` subcommand.
@@ -11,5 +13,5 @@ interface InitOptions {
  * printed to stdout for manual paste when the file is already there — an existing,
  * hand-authored config is never rewritten. Returns 0 on success, 1 on failure.
  */
-export declare function syncLabelsInitCommand({ dryRun, force }: InitOptions): Promise<number>;
+export declare function syncLabelsInitCommand({ dryRun, force, styles }: InitOptions): Promise<number>;
 export {};

package/dist/esm/sync-labels/initCommand.js

@@ -8,7 +8,7 @@ import { generateCommand, LABELS_OUTPUT_PATH } from "./generateCommand.js";
 import { checkRetiredSyncLabelsConfig } from "./retiredConfig.js";
 import { buildScopeLabels, renderRepoLabelsBlock, repoLabelsConfigScript, syncLabelsWorkflow } from "./templates.js";
 const WORKFLOW_PATH = '.github/workflows/sync-labels.yaml';
-export async function syncLabelsInitCommand({ dryRun, force }) {
+export async function syncLabelsInitCommand({ dryRun, force, styles }) {
     if (checkRetiredSyncLabelsConfig()) {
         return 1;
     }
@@ -32,14 +32,14 @@ export async function syncLabelsInitCommand({ dryRun, force }) {
         console.info(`  Found ${String(workspacePaths.length)} workspaces`);
     }
     const configExists = existsSync(CONFIG_FILE_PATH);
-    const retiredNames = configExists ? await loadRetiredPackageNames() : [];
+    const retiredNames = configExists ? await loadRetiredPackageNames(styles) : [];
     if (retiredNames === undefined) {
         return 1;
     }
     const scopeLabels = workspacePaths === undefined ? [] : buildScopeLabels(workspacePaths, retiredNames);
     console.info('\n> Scaffolding files');
     const workflowResult = writeFileWithCheck(WORKFLOW_PATH, syncLabelsWorkflow(), { dryRun, overwrite: force });
-    reportWriteResult(workflowResult, dryRun);
+    reportWriteResult(workflowResult, dryRun, styles);
     if (configExists) {
         console.info(`\n> ${CONFIG_FILE_PATH} already exists; add this block to the object passed to defineConfig:\n`);
         console.info(renderRepoLabelsBlock(scopeLabels));
@@ -60,7 +60,7 @@ export async function syncLabelsInitCommand({ dryRun, force }) {
         dryRun,
         overwrite: force,
     });
-    reportWriteResult(configResult, dryRun);
+    reportWriteResult(configResult, dryRun, styles);
     if (workflowResult.outcome === 'failed' || configResult.outcome === 'failed') {
         process.stderr.write('Failed to scaffold one or more files.\n');
         return 1;
@@ -70,7 +70,7 @@ export async function syncLabelsInitCommand({ dryRun, force }) {
     }
     else {
         console.info('\n> Generating labels');
-        const generateExitCode = await generateCommand();
+        const generateExitCode = await generateCommand({ styles });
         if (generateExitCode !== 0) {
             return generateExitCode;
         }
@@ -87,8 +87,8 @@ export async function syncLabelsInitCommand({ dryRun, force }) {
 `);
     return 0;
 }
-async function loadRetiredPackageNames() {
-    const result = await loadValidatedConfig();
+async function loadRetiredPackageNames(styles) {
+    const result = await loadValidatedConfig(styles.stderr);
     if (result.status === 'invalid') {
         return undefined;
     }

package/dist/esm/tagCommand.d.ts

@@ -1,2 +1,3 @@
+import { type StreamStyles } from '@williamthorsen/nmr-core';
 /** Orchestrate the CLI `tag` command: parse flags and delegate to `createTags`. */
-export declare function tagCommand(argv: string[]): void;
+export declare function tagCommand(argv: string[], styles: StreamStyles): void;

package/dist/esm/tagCommand.js

@@ -5,10 +5,10 @@ const tagFlagSchema = {
     dryRun: { long: '--dry-run', type: 'boolean' },
     noGitChecks: { long: '--no-git-checks', type: 'boolean' },
 };
-export function tagCommand(argv) {
+export function tagCommand(argv, styles) {
     const { dryRun, noGitChecks } = parseArgsOrExit(argv, tagFlagSchema).flags;
     try {
-        createTags({ dryRun, noGitChecks });
+        createTags({ dryRun, noGitChecks, style: styles.stdout });
     }
     catch (error) {
         reportError(describeError(error));

package/dist/esm/validateOverridesCommand.d.ts

@@ -1,9 +1,9 @@
+import { type OutputStyle, type StreamStyles } from '@williamthorsen/nmr-core';
 import { type ValidateAllChangelogOverridesInputs, type ValidateAllChangelogOverridesResult } from './changelogOverrides.js';
 import type { ChangelogEntry, ReleaseConfig } from './types.js';
 /**
  * Result of {@link validateOverridesCommand}: tiered exit code paired with a human-readable
- * message. Mirrors the shape of `checkWorkTypesDrift` so the CLI dispatch layer can stay
- * uniformly thin.
+ * message, which keeps the CLI dispatch layer thin.
  *
  * Exit codes:
  * - `0` — clean: no errors, no warnings.
@@ -36,9 +36,9 @@ export interface ValidateOverridesCommandDependencies {
  * Single-package and monorepo modes are handled uniformly: single-package collapses to one
  * project scope; monorepo expands to a project scope plus one scope per workspace.
  */
-export declare function validateOverridesCommand(dependencies?: ValidateOverridesCommandDependencies): Promise<ValidateOverridesCommandResult>;
+export declare function validateOverridesCommand(styles: StreamStyles, dependencies?: ValidateOverridesCommandDependencies): Promise<ValidateOverridesCommandResult>;
 /**
  * Pure formatter — take an aggregated validation result, return the tiered exit code and a
  * rendered message. Exported for unit testing without going through the full discovery path.
  */
-export declare function formatValidateOverridesResult(result: ValidateAllChangelogOverridesResult): ValidateOverridesCommandResult;
+export declare function formatValidateOverridesResult(result: ValidateAllChangelogOverridesResult, style: OutputStyle): ValidateOverridesCommandResult;

package/dist/esm/validateOverridesCommand.js

@@ -1,4 +1,4 @@
-import { formatErrorLine } from '@williamthorsen/nmr-core';
+import { formatErrorLine, formatStatusLine } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { buildChangelogEntries } from "./buildChangelogEntries.js";
 import { resolveOverridePath, validateAllChangelogOverrides, } from "./changelogOverrides.js";
@@ -7,7 +7,7 @@ import { buildTagPattern, getAllTagPrefixes } from "./generateChangelogs.js";
 import { loadConfig, mergeMonorepoConfig, mergeSinglePackageConfig, readRootPackageVersion } from "./loadConfig.js";
 import { validateConfig } from "./validateConfig.js";
 const SYNTHETIC_VALIDATE_TAG = 'validate-only';
-export async function validateOverridesCommand(dependencies = {}) {
+export async function validateOverridesCommand(styles, dependencies = {}) {
     const discover = dependencies.discoverWorkspaces ?? discoverWorkspaces;
     const load = dependencies.loadConfig ?? loadConfig;
     const buildEntries = dependencies.buildEntries ?? defaultBuildEntries;
@@ -44,17 +44,17 @@ export async function validateOverridesCommand(dependencies = {}) {
         return { exitCode: 2, message: formatErrorLine(`Failed to resolve overrides scope: ${describeError(error)}`) };
     }
     const result = validate(inputs);
-    return formatValidateOverridesResult(result);
+    return formatValidateOverridesResult(result, styles.stderr);
 }
-export function formatValidateOverridesResult(result) {
+export function formatValidateOverridesResult(result, style) {
     const { errors, warnings } = result;
     if (errors.length === 0 && warnings.length === 0) {
         return { exitCode: 0, message: 'All override files are valid (no errors, no stale keys).' };
     }
     const exitCode = errors.length > 0 ? 2 : 1;
     const summary = formatSummaryLine(errors.length, warnings.length);
-    const errorLines = errors.map((message) => `  ❌ ${message}`);
-    const warningLines = warnings.map((message) => `  ⚠️  ${message}`);
+    const errorLines = errors.map((message) => `  ${formatStatusLine(style, 'failed', message)}`);
+    const warningLines = warnings.map((message) => `  ${formatStatusLine(style, 'warning', message)}`);
     const message = [summary, '', ...errorLines, ...warningLines].join('\n');
     return { exitCode, message };
 }

package/docs/configuration.md

@@ -1,6 +1,6 @@
 # Configuration
 
-The fields of `.config/release-kit.config.ts`, how a workspace declares its prior identities or a retired package, the rule against colliding tag prefixes, and the patterns that decide a bump.
+The fields of `.config/release-kit.config.ts`, how a workspace declares its prior identities or a retired package, the rule against colliding tag prefixes, the patterns that decide a bump, and the environment variable that sets the output style.
 
 A minimal config file is in the [README](../README.md#configuration).
 
@@ -103,3 +103,25 @@ interface VersionPatterns {
 ```
 
 Default: `{ major: ['!'], minor: ['feat'] }`
+
+## Output style
+
+release-kit prints in one of two styles. `rich` marks each status with an emoji, such as ✅ or 🟠. `plain` replaces each emoji with a word, such as `PASS` or `WARN`, which a reader of a log can search for. The style is decided separately for stdout and stderr, so redirecting one stream to a file leaves the other rich at a terminal.
+
+The `RELEASE_KIT_OUTPUT_STYLE` environment variable sets the style for every command, `init` and `sync-labels init` included:
+
+| Value   | Effect                                                                   |
+| ------- | ------------------------------------------------------------------------ |
+| `auto`  | Detect the style of each stream. The same as leaving the variable unset. |
+| `plain` | Print plain on both streams.                                             |
+| `rich`  | Print rich on both streams, even in a pipe or under CI.                  |
+
+Any other value is a usage error: release-kit reports it and exits with code 1.
+
+The variable outranks detection. Under `auto`, release-kit defers to detection, which reads `CI`, then the stream, then `TERM`. A stream is plain when any of these holds, and rich otherwise:
+
+1. `CI` is set to anything other than an empty string or `false`.
+2. The stream is not a terminal, as when its output is piped or redirected.
+3. `TERM` is `linux`, the Linux virtual console, which draws no emoji.
+
+The style governs emoji alone. Changelog section emoji are file content rather than terminal output, and they are unaffected.

package/docs/work-types.md

@@ -1,8 +1,8 @@
 # Work types and tiers
 
-The taxonomy against which release-kit parses commits: its tiers, the breaking-change policy, section markers, customization, and the commands that compare it with its upstream.
+The taxonomy against which release-kit parses commits: its tiers, the breaking-change policy, section markers, customization, and the maintainer scripts that keep release-kit's copy level with its upstream.
 
-release-kit bundles a copy of the codeassembly canonical taxonomy in `packages/release-kit/src/work-types.json`, kept level by `release-kit work-types sync`. The taxonomy is split into three tiers that drive section rendering and audience classification.
+release-kit bundles a copy of the codeassembly canonical taxonomy in `packages/release-kit/src/work-types.json`, kept level by the [maintainer scripts](#maintaining-the-bundled-taxonomy). The taxonomy is split into three tiers that drive section rendering and audience classification.
 
 | Tier     | Key         | Header                    | Aliases       | `!` policy   |
 | -------- | ----------- | ------------------------- | ------------- | ------------ |
@@ -53,7 +53,7 @@ The release-prepare orchestrators (`releasePrepare`, `releasePrepareMono`, `rele
 ```
 arrays
   Found 1 commits since arrays-v1.0.0
-  ⚠️  1 policy violation:
+  🟠 1 policy violation:
       · def5678 'internal!: refactor cache' — type 'internal' at prefix surface
   Bumping versions (patch)...
   📦 1.0.0 → 1.0.1 (patch)
@@ -103,14 +103,17 @@ Work types from your config are merged with these defaults by key — your entri
 
 The default `devOnlySections` (excluded from public release notes but still written to `CHANGELOG.md`) are derived from the `internal` and `process` tiers (excluding `fmt`). Override via `changelogJson.devOnlySections` in your config; matching is decorator-tolerant, so a bare-name override like `['Internal features']` keeps working against the emoji-prefixed and prefix-decorated default titles.
 
-## `release-kit work-types`
+## Maintaining the bundled taxonomy
 
-Manage the canonical work-types taxonomy used by changelog and release-notes generation.
+`src/workTypesData.ts` mirrors `src/work-types.json` for runtime use. Two maintainer scripts of the release-kit package compare that JSON with its codeassembly upstream and update it. They exist only in a checkout of this repository and are not part of the published `release-kit` CLI.
 
-`check` exits 0 on a match, 1 on drift, 2 when the upstream fetch fails, and 3 when either file is not valid JSON or the upstream fails the shape check. When the upstream URL returns 404, `check` exits 0 with a warning.
+- `nmr work-types:check` compares the content of `src/work-types.json` with the upstream, ignoring the local `$schema` hint.
+- `nmr work-types:sync` overwrites `src/work-types.json` with the upstream when their content differs.
+
+Both run from `packages/release-kit`, or from anywhere in the repository as `nmr -F @williamthorsen/release-kit work-types:check` and `nmr -F @williamthorsen/release-kit work-types:sync`. After `sync` writes the file, update `src/workTypesData.ts` to match; `workTypesData.unit.test.ts` fails until the two agree.
 
-These commands are also exposed as `nmr work-types:check` / `nmr work-types:sync` from any package directory.
+`check` exits 0 on a match, 1 on drift, 2 when the upstream fetch fails, and 3 when either file is not valid JSON or the upstream fails the shape check. When the upstream URL returns 404, `check` exits 0 with a warning.
 
 ### Authenticated fetches
 
-The upstream codeassembly repo is public, so `check` and `sync` need no token. When `GITHUB_TOKEN` is set in the environment, both commands send it as `Authorization: Bearer <token>`.
+The upstream codeassembly repo is public, so `check` and `sync` need no token. When `GITHUB_TOKEN` is set in the environment, both scripts send it as `Authorization: Bearer <token>`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "10.8.0",
+  "version": "10.9.0",
   "description": "Version-bumping and changelog-generation toolkit for release workflows",
   "keywords": [
     "changelog",
@@ -51,20 +51,20 @@
     "schemas/**"
   ],
   "dependencies": {
-    "@williamthorsen/nmr-core": "0.11.1",
-    "@williamthorsen/toolbelt.errors": "0.7.0",
+    "@williamthorsen/nmr-core": "0.12.0",
+    "@williamthorsen/toolbelt.errors": "0.8.1",
     "glob": "13.0.6",
     "json-stringify-pretty-compact": "4.0.0",
     "semver": "7.8.5",
     "yaml": "2.9.0",
-    "zod": "4.5.4"
+    "zod": "4.6.2"
   },
   "devDependencies": {
     "@types/semver": "7.8.0",
-    "@williamthorsen/toolbelt.filesystem": "0.8.3",
-    "@williamthorsen/toolbelt.testing": "0.5.1",
-    "@williamthorsen/toolbelt.vitest": "0.9.0",
-    "readyup": "0.36.0",
+    "@williamthorsen/toolbelt.filesystem": "0.9.1",
+    "@williamthorsen/toolbelt.testing": "0.6.1",
+    "@williamthorsen/toolbelt.vitest": "0.10.1",
+    "readyup": "0.38.0",
     "smol-toml": "1.8.0",
     "vitest": "4.1.11"
   },
@@ -76,9 +76,9 @@
     "registry": "https://registry.npmjs.org"
   },
   "scripts": {
-    "build:post": "node scripts/copy-work-types.js && rdy compile",
+    "build:post": "rdy compile",
     "build:pre": "rdy verify",
-    "work-types:check": "pnpm exec release-kit work-types check",
-    "work-types:sync": "pnpm exec release-kit work-types sync"
+    "work-types:check": "node scripts/check-work-types.ts",
+    "work-types:sync": "node scripts/sync-work-types.ts"
   }
 }

package/presets/labels/common.yaml

@@ -4,7 +4,7 @@
 # Main categories
 - name: ai
   color: a2eeef
-  description: Documentation and configs used by agents
+  description: Guidance on working in this repo, such as its AGENTS.md or a repo-local skill, or its agent config
 - name: breaking
   color: b60205
   description: Breaking API change or removal of functionality
@@ -16,7 +16,7 @@
   description: Marks functionality for future removal
 - name: documentation
   color: a2eeef
-  description: Improvements or additions to documentation
+  description: Documentation for human readers, such as a README, a guide, or a code comment
 - name: feature
   color: '0075ca'
   description: Added or improved external functionality

package/dist/esm/checkWorkTypesDrift.d.ts

@@ -1,35 +0,0 @@
-/** URL of the upstream canonical `work-types.json` published by codeassembly. */
-export declare const UPSTREAM_WORK_TYPES_URL = "https://raw.githubusercontent.com/williamthorsen/codeassembly/main/packages/agents/content/skills/_data/work-types.json";
-/** Outcome of a drift check, paired with a human-readable message. */
-export interface DriftCheckResult {
-    /**
-     * Process exit code semantics:
-     * - `0` — match (or upstream not found, with a warning).
-     * - `1` — drift detected.
-     * - `2` — network error.
-     * - `3` — schema mismatch (upstream JSON does not parse or fails the schema invariants).
-     */
-    exitCode: 0 | 1 | 2 | 3;
-    message: string;
-}
-/** Minimal injection seam so unit tests can substitute a deterministic fetcher. */
-export interface CheckWorkTypesDriftDependencies {
-    /** Absolute path of the local `work-types.json`. Defaults to the bundled file. */
-    localPath?: string;
-    /** HTTP fetcher. Defaults to global `fetch` (Node 18+). */
-    fetch?: typeof globalThis.fetch;
-    /** Override the upstream URL (used by tests; production callers should leave default). */
-    upstreamUrl?: string;
-}
-/**
- * Compare the bundled `work-types.json` against the upstream codeassembly canonical and
- * report drift.
- *
- * Failure modes:
- * - Network error → exit 2 with a diagnostic.
- * - Upstream 404 → exit 0 with a warning.
- * - Schema mismatch → exit 3 with a diagnostic.
- * - Drift → exit 1 with a unified-diff-style message.
- * - Match → exit 0.
- */
-export declare function checkWorkTypesDrift(dependencies?: CheckWorkTypesDriftDependencies): Promise<DriftCheckResult>;

package/dist/esm/checkWorkTypesDrift.js

@@ -1,117 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { formatErrorLine } from '@williamthorsen/nmr-core';
-import { describeError } from '@williamthorsen/toolbelt.errors';
-import { buildFetchInit, hasExpectedTopLevelShape } from "./workTypesUtils.js";
-export const UPSTREAM_WORK_TYPES_URL = 'https://raw.githubusercontent.com/williamthorsen/codeassembly/main/packages/agents/content/skills/_data/work-types.json';
-function resolveDefaultLocalPath() {
-    const moduleDir = dirname(fileURLToPath(import.meta.url));
-    return resolve(moduleDir, 'work-types.json');
-}
-export async function checkWorkTypesDrift(dependencies = {}) {
-    const localPath = dependencies.localPath ?? resolveDefaultLocalPath();
-    const fetcher = dependencies.fetch ?? globalThis.fetch;
-    const url = dependencies.upstreamUrl ?? UPSTREAM_WORK_TYPES_URL;
-    const localContent = readFileSync(localPath, 'utf8');
-    let localJson;
-    try {
-        localJson = JSON.parse(localContent);
-    }
-    catch (error) {
-        return {
-            exitCode: 3,
-            message: `Local work-types.json is not valid JSON: ${describeError(error)}`,
-        };
-    }
-    const fetchInit = buildFetchInit();
-    let response;
-    try {
-        response = fetchInit === undefined ? await fetcher(url) : await fetcher(url, fetchInit);
-    }
-    catch (error) {
-        return {
-            exitCode: 2,
-            message: formatErrorLine(`Failed to fetch upstream work-types.json: ${describeError(error)}`),
-        };
-    }
-    if (response.status === 404) {
-        return {
-            exitCode: 0,
-            message: `Upstream work-types.json not found at ${url}; skipping drift check.`,
-        };
-    }
-    if (!response.ok) {
-        return {
-            exitCode: 2,
-            message: formatErrorLine(`Failed to fetch upstream work-types.json: HTTP ${response.status} ${response.statusText}`),
-        };
-    }
-    const upstreamText = await response.text();
-    let upstreamJson;
-    try {
-        upstreamJson = JSON.parse(upstreamText);
-    }
-    catch (error) {
-        return {
-            exitCode: 3,
-            message: `Upstream work-types.json is not valid JSON: ${describeError(error)}`,
-        };
-    }
-    if (!hasExpectedTopLevelShape(upstreamJson)) {
-        return {
-            exitCode: 3,
-            message: 'Upstream work-types.json does not match the expected schema shape (missing `tiers` or `types`).',
-        };
-    }
-    const normalisedLocal = stripLocalOnlyFields(localJson);
-    if (deepEqual(normalisedLocal, upstreamJson)) {
-        return {
-            exitCode: 0,
-            message: 'Local work-types.json matches upstream.',
-        };
-    }
-    return {
-        exitCode: 1,
-        message: `Drift detected. Local and upstream work-types.json differ. Run \`nmr work-types:sync\` to update from upstream.\nLocal:    ${localPath}\nUpstream: ${url}`,
-    };
-}
-function stripLocalOnlyFields(value) {
-    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
-        return value;
-    }
-    const record = { ...value };
-    delete record['$schema'];
-    return record;
-}
-function deepEqual(a, b) {
-    if (a === b)
-        return true;
-    if (typeof a !== typeof b)
-        return false;
-    if (a === null || b === null)
-        return a === b;
-    if (Array.isArray(a) && Array.isArray(b)) {
-        if (a.length !== b.length)
-            return false;
-        for (let i = 0; i < a.length; i++) {
-            if (!deepEqual(a[i], b[i]))
-                return false;
-        }
-        return true;
-    }
-    if (typeof a === 'object' && typeof b === 'object' && !Array.isArray(a) && !Array.isArray(b)) {
-        const aRecord = { ...a };
-        const bRecord = { ...b };
-        const aKeys = Object.keys(aRecord);
-        const bKeys = Object.keys(bRecord);
-        if (aKeys.length !== bKeys.length)
-            return false;
-        for (const key of aKeys) {
-            if (!deepEqual(aRecord[key], bRecord[key]))
-                return false;
-        }
-        return true;
-    }
-    return false;
-}

package/dist/esm/syncWorkTypes.d.ts

@@ -1,28 +0,0 @@
-/** Outcome of a sync operation. */
-export interface SyncResult {
-    /**
-     * Process exit code semantics:
-     * - `0` — sync succeeded (file may be unchanged).
-     * - `2` — network error or local write failure.
-     * - `3` — schema mismatch (upstream JSON does not parse or fails the shape check).
-     */
-    exitCode: 0 | 2 | 3;
-    message: string;
-}
-/** Minimal injection seam so unit tests can substitute a deterministic fetcher. */
-export interface SyncWorkTypesDependencies {
-    /** Absolute path of the local `work-types.json`. Defaults to the bundled file. */
-    localPath?: string;
-    /** HTTP fetcher. Defaults to global `fetch`. */
-    fetch?: typeof globalThis.fetch;
-    /** Override the upstream URL (used by tests). */
-    upstreamUrl?: string;
-}
-/**
- * Fetch the upstream `work-types.json`, validate its top-level shape, and overwrite the
- * locally-bundled copy with the formatted upstream contents.
- *
- * Output is reformatted to match the local file's conventions (2-space indent, trailing
- * newline) so subsequent diffs are content-driven, not whitespace-driven.
- */
-export declare function syncWorkTypes(dependencies?: SyncWorkTypesDependencies): Promise<SyncResult>;