@williamthorsen/release-kit 6.0.0 → 7.0.0

package/dist/esm/checkWorkTypesDrift.js

@@ -1,114 +1,116 @@
-import { readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { formatErrorLine } from "@williamthorsen/nmr-core";
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { formatErrorLine } from '@williamthorsen/nmr-core';
 import { buildFetchInit, errorMessage, hasExpectedTopLevelShape } from "./workTypesUtils.js";
-const UPSTREAM_WORK_TYPES_URL = "https://raw.githubusercontent.com/williamthorsen/codeassembly/main/packages/agents/content/skills/_data/work-types.json";
+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");
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    return resolve(moduleDir, 'work-types.json');
 }
-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: ${errorMessage(error)}`
-    };
-  }
-  const fetchInit = buildFetchInit();
-  let response;
-  try {
-    response = fetchInit === void 0 ? await fetcher(url) : await fetcher(url, fetchInit);
-  } catch (error) {
-    return {
-      exitCode: 2,
-      message: formatErrorLine(`Failed to fetch upstream work-types.json: ${errorMessage(error)}`)
-    };
-  }
-  if (response.status === 404) {
-    return {
-      exitCode: 0,
-      message: `Upstream work-types.json not yet published 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: ${errorMessage(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)) {
+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: ${errorMessage(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: ${errorMessage(error)}`),
+        };
+    }
+    if (response.status === 404) {
+        return {
+            exitCode: 0,
+            message: `Upstream work-types.json not yet published 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: ${errorMessage(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: 0,
-      message: "Local work-types.json matches upstream."
+        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}`,
     };
-  }
-  return {
-    exitCode: 1,
-    message: `Drift detected. Local and upstream work-types.json differ. Run \`nmr work-types:sync\` to update from upstream.
-Local:    ${localPath}
-Upstream: ${url}`
-  };
 }
 function stripLocalOnlyFields(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return value;
-  }
-  const record = { ...value };
-  delete record.$schema;
-  return record;
+    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;
+    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;
     }
-    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;
+    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 true;
-  }
-  return false;
+    return false;
 }
-export {
-  UPSTREAM_WORK_TYPES_URL,
-  checkWorkTypesDrift
-};

package/dist/esm/collectPolicyViolations.d.ts

@@ -1,5 +1,5 @@
-import type { PolicyViolationHandler } from './parseCommitMessage.ts';
-import type { PolicyViolation } from './types.ts';
+import type { PolicyViolationHandler } from './parseCommitMessage.js';
+import type { PolicyViolation } from './types.js';
 export declare function createPolicyViolationCollector(): {
     violations: PolicyViolation[];
     onPolicyViolation: PolicyViolationHandler;

package/dist/esm/collectPolicyViolations.js

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

package/dist/esm/commitCommand.js

@@ -1,53 +1,55 @@
-import { execFileSync } from "node:child_process";
-import { readFileSync } from "node:fs";
-import { parseArgsOrExit } from "@williamthorsen/nmr-core";
+import { execFileSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { parseArgsOrExit } from '@williamthorsen/nmr-core';
 import { RELEASE_SUMMARY_FILE, RELEASE_TAGS_FILE } from "./prepareCommand.js";
 const commitFlagSchema = {
-  dryRun: { long: "--dry-run", type: "boolean" }
+    dryRun: { long: '--dry-run', type: 'boolean' },
 };
-function commitCommand(argv) {
-  const dryRun = parseArgsOrExit(argv, commitFlagSchema).flags.dryRun;
-  let tagsContent;
-  try {
-    tagsContent = readFileSync(RELEASE_TAGS_FILE, "utf8");
-  } catch {
-    throw new Error("No tags file found. Run `release-kit prepare` first.");
-  }
-  const tags = tagsContent.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
-  if (tags.length === 0) {
-    throw new Error("Tags file is empty. Run `release-kit prepare` first.");
-  }
-  let summary = "";
-  try {
-    summary = readFileSync(RELEASE_SUMMARY_FILE, "utf8").trim();
-  } catch (error) {
-    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-    } else {
-      throw error;
+export function commitCommand(argv) {
+    const dryRun = parseArgsOrExit(argv, commitFlagSchema).flags.dryRun;
+    let tagsContent;
+    try {
+        tagsContent = readFileSync(RELEASE_TAGS_FILE, 'utf8');
+    }
+    catch {
+        throw new Error('No tags file found. Run `release-kit prepare` first.');
+    }
+    const tags = tagsContent
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    if (tags.length === 0) {
+        throw new Error('Tags file is empty. Run `release-kit prepare` first.');
     }
-  }
-  const title = `release: ${tags.join(" ")}`;
-  const message = summary.length > 0 ? `${title}
-
-${summary}` : title;
-  if (dryRun) {
-    console.info("[dry-run] Would create commit with message:\n");
-    console.info(message);
+    let summary = '';
     try {
-      const status = execFileSync("git", ["status", "--porcelain"], { encoding: "utf8" });
-      if (status.trim().length > 0) {
-        console.info("\nUncommitted changes:");
-        console.info(status.trimEnd());
-      }
-    } catch {
-      console.info("(Could not determine uncommitted changes)");
+        summary = readFileSync(RELEASE_SUMMARY_FILE, 'utf8').trim();
     }
-    return;
-  }
-  execFileSync("git", ["add", "-A"]);
-  execFileSync("git", ["commit", "-m", message]);
-  console.info(`Created release commit: ${title}`);
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+        }
+        else {
+            throw error;
+        }
+    }
+    const title = `release: ${tags.join(' ')}`;
+    const message = summary.length > 0 ? `${title}\n\n${summary}` : title;
+    if (dryRun) {
+        console.info('[dry-run] Would create commit with message:\n');
+        console.info(message);
+        try {
+            const status = execFileSync('git', ['status', '--porcelain'], { encoding: 'utf8' });
+            if (status.trim().length > 0) {
+                console.info('\nUncommitted changes:');
+                console.info(status.trimEnd());
+            }
+        }
+        catch {
+            console.info('(Could not determine uncommitted changes)');
+        }
+        return;
+    }
+    execFileSync('git', ['add', '-A']);
+    execFileSync('git', ['commit', '-m', message]);
+    console.info(`Created release commit: ${title}`);
 }
-export {
-  commitCommand
-};

package/dist/esm/compareVersions.js

@@ -1,27 +1,24 @@
 const CANONICAL_SEMVER_PATTERN = /^(\d+)\.(\d+)\.(\d+)$/;
 function parseCanonicalSemver(version) {
-  const match = version.match(CANONICAL_SEMVER_PATTERN);
-  if (!match) {
-    throw new Error(`Invalid semver version: '${version}'`);
-  }
-  const [, major = "", minor = "", patch = ""] = match;
-  return {
-    major: Number.parseInt(major, 10),
-    minor: Number.parseInt(minor, 10),
-    patch: Number.parseInt(patch, 10)
-  };
+    const match = version.match(CANONICAL_SEMVER_PATTERN);
+    if (!match) {
+        throw new Error(`Invalid semver version: '${version}'`);
+    }
+    const [, major = '', minor = '', patch = ''] = match;
+    return {
+        major: Number.parseInt(major, 10),
+        minor: Number.parseInt(minor, 10),
+        patch: Number.parseInt(patch, 10),
+    };
 }
-function isForwardVersion(current, target) {
-  const currentParsed = parseCanonicalSemver(current);
-  const targetParsed = parseCanonicalSemver(target);
-  if (targetParsed.major !== currentParsed.major) {
-    return targetParsed.major > currentParsed.major;
-  }
-  if (targetParsed.minor !== currentParsed.minor) {
-    return targetParsed.minor > currentParsed.minor;
-  }
-  return targetParsed.patch > currentParsed.patch;
+export function isForwardVersion(current, target) {
+    const currentParsed = parseCanonicalSemver(current);
+    const targetParsed = parseCanonicalSemver(target);
+    if (targetParsed.major !== currentParsed.major) {
+        return targetParsed.major > currentParsed.major;
+    }
+    if (targetParsed.minor !== currentParsed.minor) {
+        return targetParsed.minor > currentParsed.minor;
+    }
+    return targetParsed.patch > currentParsed.patch;
 }
-export {
-  isForwardVersion
-};

package/dist/esm/createGithubRelease.js

@@ -1,64 +1,61 @@
-import { execFileSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { join } from "node:path";
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
 import { extractVersion, readChangelogEntries } from "./changelogJsonUtils.js";
 import { matchesAudience, renderReleaseNotesSingle } from "./renderReleaseNotes.js";
-function createGithubRelease(options) {
-  const { tag, changelogJsonPath, dryRun, sectionOrder } = options;
-  if (!existsSync(changelogJsonPath)) {
-    console.warn(`Warning: ${changelogJsonPath} not found; skipping GitHub Release creation`);
-    return { status: "skipped", reason: "no-entry" };
-  }
-  const version = extractVersion(tag);
-  const entries = readChangelogEntries(changelogJsonPath);
-  if (entries === void 0) {
-    console.warn(`Warning: could not parse ${changelogJsonPath}; skipping GitHub Release creation`);
-    return { status: "skipped", reason: "no-entry" };
-  }
-  const entry = entries.find((e) => e.version === version);
-  if (entry === void 0) {
-    console.warn(`Warning: no changelog entry for version ${version}; skipping GitHub Release creation`);
-    return { status: "skipped", reason: "no-entry" };
-  }
-  if (!entry.sections.some(matchesAudience("all"))) {
-    return { status: "skipped", reason: "no-audience-content" };
-  }
-  const body = renderReleaseNotesSingle(entry, {
-    filter: matchesAudience("all"),
-    includeHeading: false,
-    ...sectionOrder === void 0 ? {} : { sectionOrder }
-  });
-  if (body.trim() === "") {
-    return { status: "skipped", reason: "empty-body" };
-  }
-  const args = ["release", "create", tag, "--title", tag, "--notes", body];
-  if (dryRun) {
-    console.info(`[dry-run] Would run: gh ${args.join(" ")}`);
-    return { status: "created" };
-  }
-  execFileSync("gh", args, { stdio: "inherit" });
-  return { status: "created" };
-}
-function createGithubReleases(tags, changelogJsonOutputPath, dryRun, sectionOrder) {
-  const created = [];
-  const skipped = [];
-  for (const { tag, workspacePath } of tags) {
-    const changelogJsonPath = join(workspacePath, changelogJsonOutputPath);
-    const result = createGithubRelease({
-      tag,
-      changelogJsonPath,
-      dryRun,
-      ...sectionOrder === void 0 ? {} : { sectionOrder }
+export function createGithubRelease(options) {
+    const { tag, changelogJsonPath, dryRun, sectionOrder } = options;
+    if (!existsSync(changelogJsonPath)) {
+        console.warn(`Warning: ${changelogJsonPath} not found; skipping GitHub Release creation`);
+        return { status: 'skipped', reason: 'no-entry' };
+    }
+    const version = extractVersion(tag);
+    const entries = readChangelogEntries(changelogJsonPath);
+    if (entries === undefined) {
+        console.warn(`Warning: could not parse ${changelogJsonPath}; skipping GitHub Release creation`);
+        return { status: 'skipped', reason: 'no-entry' };
+    }
+    const entry = entries.find((e) => e.version === version);
+    if (entry === undefined) {
+        console.warn(`Warning: no changelog entry for version ${version}; skipping GitHub Release creation`);
+        return { status: 'skipped', reason: 'no-entry' };
+    }
+    if (!entry.sections.some(matchesAudience('all'))) {
+        return { status: 'skipped', reason: 'no-audience-content' };
+    }
+    const body = renderReleaseNotesSingle(entry, {
+        filter: matchesAudience('all'),
+        includeHeading: false,
+        ...(sectionOrder === undefined ? {} : { sectionOrder }),
     });
-    if (result.status === "created") {
-      created.push(tag);
-    } else {
-      skipped.push({ tag, reason: result.reason });
+    if (body.trim() === '') {
+        return { status: 'skipped', reason: 'empty-body' };
+    }
+    const args = ['release', 'create', tag, '--title', tag, '--notes', body];
+    if (dryRun) {
+        console.info(`[dry-run] Would run: gh ${args.join(' ')}`);
+        return { status: 'created' };
+    }
+    execFileSync('gh', args, { stdio: 'inherit' });
+    return { status: 'created' };
+}
+export function createGithubReleases(tags, changelogJsonOutputPath, dryRun, sectionOrder) {
+    const created = [];
+    const skipped = [];
+    for (const { tag, workspacePath } of tags) {
+        const changelogJsonPath = join(workspacePath, changelogJsonOutputPath);
+        const result = createGithubRelease({
+            tag,
+            changelogJsonPath,
+            dryRun,
+            ...(sectionOrder === undefined ? {} : { sectionOrder }),
+        });
+        if (result.status === 'created') {
+            created.push(tag);
+        }
+        else {
+            skipped.push({ tag, reason: result.reason });
+        }
     }
-  }
-  return { created, skipped };
+    return { created, skipped };
 }
-export {
-  createGithubRelease,
-  createGithubReleases
-};

package/dist/esm/createGithubReleaseCommand.js

@@ -1,30 +1,28 @@
-import { parseArgsOrExit, reportError } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit, reportError } from '@williamthorsen/nmr-core';
 import { createGithubReleases } from "./createGithubRelease.js";
 import { parseRequestedTags } from "./parseRequestedTags.js";
 import { resolveCommandTags } from "./resolveCommandTags.js";
 import { resolveReleaseNotesConfig } from "./resolveReleaseNotesConfig.js";
 const createGithubReleaseFlagSchema = {
-  dryRun: { long: "--dry-run", type: "boolean" },
-  tags: { long: "--tags", type: "string" }
+    dryRun: { long: '--dry-run', type: 'boolean' },
+    tags: { long: '--tags', type: 'string' },
 };
-async function createGithubReleaseCommand(argv) {
-  const parsed = parseArgsOrExit(argv, createGithubReleaseFlagSchema);
-  const { dryRun } = parsed.flags;
-  const requestedTags = parseRequestedTags(parsed.flags.tags);
-  const resolvedTags = await resolveCommandTags(requestedTags);
-  const { changelogJsonOutputPath, sectionOrder } = await resolveReleaseNotesConfig({ strictLoad: true });
-  let outcome;
-  try {
-    outcome = createGithubReleases(resolvedTags, changelogJsonOutputPath, dryRun, sectionOrder);
-  } catch (error) {
-    reportError(`Failed to create GitHub Releases: ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
-  }
-  if (outcome.skipped.length > 0) {
-    const formatted = outcome.skipped.map((s) => `${s.tag} (${s.reason})`).join(", ");
-    console.info(`Skipped ${outcome.skipped.length} tag(s) with no releasable content: ${formatted}.`);
-  }
+export async function createGithubReleaseCommand(argv) {
+    const parsed = parseArgsOrExit(argv, createGithubReleaseFlagSchema);
+    const { dryRun } = parsed.flags;
+    const requestedTags = parseRequestedTags(parsed.flags.tags);
+    const resolvedTags = await resolveCommandTags(requestedTags);
+    const { changelogJsonOutputPath, sectionOrder } = await resolveReleaseNotesConfig({ strictLoad: true });
+    let outcome;
+    try {
+        outcome = createGithubReleases(resolvedTags, changelogJsonOutputPath, dryRun, sectionOrder);
+    }
+    catch (error) {
+        reportError(`Failed to create GitHub Releases: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    if (outcome.skipped.length > 0) {
+        const formatted = outcome.skipped.map((s) => `${s.tag} (${s.reason})`).join(', ');
+        console.info(`Skipped ${outcome.skipped.length} tag(s) with no releasable content: ${formatted}.`);
+    }
 }
-export {
-  createGithubReleaseCommand
-};