aronrepo 3.0.1 → 3.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aron
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -10,7 +10,7 @@ One commit standard and one release engine for JavaScript repositories, built so
 bun add -d aronrepo husky
 ```
 
-`pnpm add -D aronrepo husky` and `npm install -D aronrepo husky` work too. This package is ESM-only and has no peer tools.
+`pnpm add -D aronrepo husky` and `npm install -D aronrepo husky` work too. This package is ESM-only, needs Node.js 22.18 or later, and has no peer tools.
 
 ## Configure
 
@@ -24,6 +24,8 @@ export default {
 }
 ```
 
+A CommonJS package uses `aronrepo.config.mjs`; `aronrepo.config.cjs` and `aronrepo.config.ts` (Node 22.18+) work too.
+
 ```sh
 # .husky/commit-msg
 aronrepo check --edit "$1"

package/dist/cli.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 import { releaseModes } from "./index.js";
-import { c as release, i as explain, n as check, o as policy, r as doctor, t as agents } from "./commands-BRnoLH3z.js";
+import { i as explain, l as release, n as check, o as policy, r as doctor, t as agents } from "./commands-D2xBkCvw.js";
+import fs from "node:fs";
+import path from "node:path";
 import { parseArgs } from "node:util";
 // src/cli.ts
 const help = `Usage: aronrepo <command> [options]
@@ -9,8 +11,9 @@ Commands:
   check     Check commits against the release policy
             --edit <file>             commit-msg hook: message file + staged files
             --message <text>          a message + staged files (or --files)
-            --title <text> [--base <ref> --head <ref>]   a PR title + PR diff
+            --title <text> [--base <ref> --head <ref>]   a PR title + PR diff (or --files)
             --from <ref> [--to <ref>] every commit in a range
+            --files <a,b,...>         changed files, comma-separated, for --message or --title
   explain   Print the next release and the reason for each commit
             [--from <ref>] [--to <ref>]   defaults to the release range of the branch
   release   Publish the next release: npm packages, the version tag, and the GitHub release
@@ -18,50 +21,137 @@ Commands:
   policy    Print the release policy [--json | --markdown]
   agents    Check the AGENTS.md policy block, or regenerate it with --write [--file <path>]
   doctor    Check the Aronrepo setup of this repository
+  help      Print this help
 
 Options:
-  --cwd <dir>                   repository root (default: current directory)
+  --cwd <dir>                   repository root (default: the git repository around the current directory)
   --mode <explicit|auto>        override release.mode from aronrepo.config.js
   --json                        machine-readable output
+  -h, --help                    print this help
+  -v, --version                 print the aronrepo version
 `;
+const options = {
+	cwd: { type: "string" },
+	mode: { type: "string" },
+	json: { type: "boolean" },
+	markdown: { type: "boolean" },
+	write: { type: "boolean" },
+	file: { type: "string" },
+	edit: { type: "string" },
+	message: { type: "string" },
+	title: { type: "string" },
+	base: { type: "string" },
+	head: { type: "string" },
+	from: { type: "string" },
+	to: { type: "string" },
+	files: { type: "string" },
+	"dry-run": { type: "boolean" },
+	branch: { type: "string" },
+	help: {
+		type: "boolean",
+		short: "h"
+	},
+	version: {
+		type: "boolean",
+		short: "v"
+	}
+};
+const common = [
+	"cwd",
+	"mode",
+	"json",
+	"help"
+];
+/** The options each command reads; any other option is a usage error instead of being ignored. */
+const commandOptions = {
+	check: [
+		...common,
+		"edit",
+		"message",
+		"title",
+		"base",
+		"head",
+		"from",
+		"to",
+		"files"
+	],
+	explain: [
+		...common,
+		"from",
+		"to"
+	],
+	release: [
+		...common,
+		"dry-run",
+		"branch"
+	],
+	policy: [...common, "markdown"],
+	agents: [
+		...common,
+		"file",
+		"write"
+	],
+	doctor: common,
+	help: ["help"]
+};
+function parse(argv) {
+	try {
+		return parseArgs({
+			args: argv,
+			allowPositionals: true,
+			options
+		});
+	} catch (error) {
+		return error;
+	}
+}
+function readVersion() {
+	const file = new URL("../package.json", import.meta.url);
+	return JSON.parse(fs.readFileSync(file, "utf8")).version;
+}
 async function main(argv) {
-	const { positionals, values } = parseArgs({
-		args: argv,
-		allowPositionals: true,
-		options: {
-			cwd: { type: "string" },
-			mode: { type: "string" },
-			json: { type: "boolean" },
-			markdown: { type: "boolean" },
-			write: { type: "boolean" },
-			check: { type: "boolean" },
-			file: { type: "string" },
-			edit: { type: "string" },
-			message: { type: "string" },
-			title: { type: "string" },
-			base: { type: "string" },
-			head: { type: "string" },
-			from: { type: "string" },
-			to: { type: "string" },
-			files: { type: "string" },
-			"dry-run": { type: "boolean" },
-			branch: { type: "string" },
-			help: {
-				type: "boolean",
-				short: "h"
-			}
-		}
-	});
-	const [command] = positionals;
-	if (!command || values.help) return {
-		code: command || values.help ? 0 : 2,
+	const parsed = parse(argv);
+	if (parsed instanceof Error) return {
+		code: 2,
+		output: `${parsed.message}\n\n${help}`
+	};
+	const { positionals, values } = parsed;
+	if (values.version) return {
+		code: 0,
+		output: readVersion()
+	};
+	const [command, ...extra] = positionals;
+	if (extra.length) return {
+		code: 2,
+		output: `Unexpected argument "${extra[0]}".\n\n${help}`
+	};
+	if (command === "help" || values.help && (!command || command in commandOptions)) return {
+		code: 0,
 		output: help
 	};
+	if (!command) return {
+		code: 2,
+		output: help
+	};
+	const allowed = commandOptions[command];
+	if (!allowed) return {
+		code: 2,
+		output: `Unknown command "${command}".\n\n${help}`
+	};
+	const unsupported = Object.keys(values).filter((key) => !allowed.includes(key));
+	if (unsupported.length) return {
+		code: 2,
+		output: `\`aronrepo ${command}\` does not take --${unsupported[0]}.\n\n${help}`
+	};
 	if (values.mode && !releaseModes.includes(values.mode)) return {
 		code: 2,
 		output: `--mode must be one of: ${releaseModes.join(", ")}`
 	};
-	const common = {
+	if (values.cwd && !fs.existsSync(values.cwd)) return {
+		code: 2,
+		output: `--cwd ${values.cwd} does not exist.`
+	};
+	const shared = {
 		...values.cwd ? { cwd: values.cwd } : {},
 		...values.mode ? { mode: values.mode } : {},
 		...values.json ? { json: true } : {}
@@ -69,40 +159,48 @@ async function main(argv) {
 	const optional = (...keys) => Object.fromEntries(keys.filter((key) => values[key] !== void 0).map((key) => [key, values[key]]));
 	switch (command) {
 		case "check": return check({
-			...common,
-			...optional("edit", "message", "title", "base", "head", "from", "to"),
+			...shared,
+			...optional("message", "title", "base", "head", "from", "to"),
+			...values.edit !== void 0 ? { edit: path.resolve(values.edit) } : {},
 			...values.files !== void 0 ? { files: values.files.split(",").map((file) => file.trim()).filter(Boolean) } : {}
 		});
 		case "explain": return explain({
-			...common,
+			...shared,
 			...optional("from", "to")
 		});
 		case "release": return release({
-			...common,
+			...shared,
 			...optional("branch"),
 			...values["dry-run"] ? { dryRun: true } : {}
 		});
 		case "policy": return policy({
-			...common,
+			...shared,
 			...values.markdown ? { markdown: true } : {}
 		});
 		case "agents": return agents({
-			...common,
+			...shared,
 			...optional("file"),
 			...values.write ? { write: true } : {}
 		});
-		case "doctor": return doctor(common);
-		default: return {
-			code: 2,
-			output: `Unknown command "${command}".\n\n${help}`
-		};
+		default: return doctor(shared);
 	}
 }
+const json = process.argv.includes("--json");
 main(process.argv.slice(2)).then(({ code, output }) => {
-	if (output) (code === 0 ? process.stdout : process.stderr).write(`${output}\n`);
+	if (output) {
+		const text = json && code === 2 && !output.trimStart().startsWith("{") ? JSON.stringify({
+			error: output.split("\n")[0],
+			code
+		}) : output;
+		(code === 2 ? process.stderr : process.stdout).write(`${text}\n`);
+	}
 	process.exitCode = code;
 }).catch((error) => {
-	process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+	const message = error instanceof Error ? error.message : String(error);
+	process.stderr.write(`${json ? JSON.stringify({
+		error: message,
+		code: 1
+	}) : message}\n`);
 	process.exitCode = 1;
 });
 export {};

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { parseArgs } from 'node:util'\nimport { releaseModes, type ReleaseMode } from './index'\nimport { agents, check, doctor, explain, policy, release, type CommandResult } from './commands'\n\nconst help = `Usage: aronrepo <command> [options]\n\nCommands:\n  check     Check commits against the release policy\n            --edit <file>             commit-msg hook: message file + staged files\n            --message <text>          a message + staged files (or --files)\n            --title <text> [--base <ref> --head <ref>]   a PR title + PR diff\n            --from <ref> [--to <ref>] every commit in a range\n  explain   Print the next release and the reason for each commit\n            [--from <ref>] [--to <ref>]   defaults to the release range of the branch\n  release   Publish the next release: npm packages, the version tag, and the GitHub release\n            [--dry-run] [--branch <name>]  prints the plan and notes without changes\n  policy    Print the release policy [--json | --markdown]\n  agents    Check the AGENTS.md policy block, or regenerate it with --write [--file <path>]\n  doctor    Check the Aronrepo setup of this repository\n\nOptions:\n  --cwd <dir>                   repository root (default: current directory)\n  --mode <explicit|auto>        override release.mode from aronrepo.config.js\n  --json                        machine-readable output\n`\n\nasync function main(argv: string[]): Promise<CommandResult> {\n    const { positionals, values } = parseArgs({\n        args: argv,\n        allowPositionals: true,\n        options: {\n            cwd: { type: 'string' },\n            mode: { type: 'string' },\n            json: { type: 'boolean' },\n            markdown: { type: 'boolean' },\n            write: { type: 'boolean' },\n            check: { type: 'boolean' },\n            file: { type: 'string' },\n            edit: { type: 'string' },\n            message: { type: 'string' },\n            title: { type: 'string' },\n            base: { type: 'string' },\n            head: { type: 'string' },\n            from: { type: 'string' },\n            to: { type: 'string' },\n            files: { type: 'string' },\n            'dry-run': { type: 'boolean' },\n            branch: { type: 'string' },\n            help: { type: 'boolean', short: 'h' }\n        }\n    })\n    const [command] = positionals\n    if (!command || values.help) return { code: command || values.help ? 0 : 2, output: help }\n    if (values.mode && !releaseModes.includes(values.mode as ReleaseMode)) {\n        return { code: 2, output: `--mode must be one of: ${releaseModes.join(', ')}` }\n    }\n    const common = {\n        ...(values.cwd ? { cwd: values.cwd } : {}),\n        ...(values.mode ? { mode: values.mode as ReleaseMode } : {}),\n        ...(values.json ? { json: true } : {})\n    }\n    const optional = <K extends keyof typeof values>(...keys: K[]) =>\n        Object.fromEntries(keys.filter((key) => values[key] !== undefined).map((key) => [key, values[key]]))\n\n    switch (command) {\n        case 'check':\n            return check({\n                ...common,\n                ...optional('edit', 'message', 'title', 'base', 'head', 'from', 'to'),\n                ...(values.files !== undefined ? { files: values.files.split(',').map((file) => file.trim()).filter(Boolean) } : {})\n            })\n        case 'explain':\n            return explain({ ...common, ...optional('from', 'to') })\n        case 'release':\n            return release({ ...common, ...optional('branch'), ...(values['dry-run'] ? { dryRun: true } : {}) })\n        case 'policy':\n            return policy({ ...common, ...(values.markdown ? { markdown: true } : {}) })\n        case 'agents':\n            return agents({ ...common, ...optional('file'), ...(values.write ? { write: true } : {}) })\n        case 'doctor':\n            return doctor(common)\n        default:\n            return { code: 2, output: `Unknown command \"${command}\".\\n\\n${help}` }\n    }\n}\n\nmain(process.argv.slice(2))\n    .then(({ code, output }) => {\n        if (output) (code === 0 ? process.stdout : process.stderr).write(`${output}\\n`)\n        process.exitCode = code\n    })\n    .catch((error: unknown) => {\n        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n        process.exitCode = 1\n    })\n"],"mappings":"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"}
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport fs from 'node:fs'\nimport path from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { releaseModes, type ReleaseMode } from './index'\nimport { agents, check, doctor, explain, policy, release, type CommandResult } from './commands'\n\nconst help = `Usage: aronrepo <command> [options]\n\nCommands:\n  check     Check commits against the release policy\n            --edit <file>             commit-msg hook: message file + staged files\n            --message <text>          a message + staged files (or --files)\n            --title <text> [--base <ref> --head <ref>]   a PR title + PR diff (or --files)\n            --from <ref> [--to <ref>] every commit in a range\n            --files <a,b,...>         changed files, comma-separated, for --message or --title\n  explain   Print the next release and the reason for each commit\n            [--from <ref>] [--to <ref>]   defaults to the release range of the branch\n  release   Publish the next release: npm packages, the version tag, and the GitHub release\n            [--dry-run] [--branch <name>]  prints the plan and notes without changes\n  policy    Print the release policy [--json | --markdown]\n  agents    Check the AGENTS.md policy block, or regenerate it with --write [--file <path>]\n  doctor    Check the Aronrepo setup of this repository\n  help      Print this help\n\nOptions:\n  --cwd <dir>                   repository root (default: the git repository around the current directory)\n  --mode <explicit|auto>        override release.mode from aronrepo.config.js\n  --json                        machine-readable output\n  -h, --help                    print this help\n  -v, --version                 print the aronrepo version\n`\n\nconst options = {\n    cwd: { type: 'string' },\n    mode: { type: 'string' },\n    json: { type: 'boolean' },\n    markdown: { type: 'boolean' },\n    write: { type: 'boolean' },\n    file: { type: 'string' },\n    edit: { type: 'string' },\n    message: { type: 'string' },\n    title: { type: 'string' },\n    base: { type: 'string' },\n    head: { type: 'string' },\n    from: { type: 'string' },\n    to: { type: 'string' },\n    files: { type: 'string' },\n    'dry-run': { type: 'boolean' },\n    branch: { type: 'string' },\n    help: { type: 'boolean', short: 'h' },\n    version: { type: 'boolean', short: 'v' }\n} as const\n\ntype OptionName = keyof typeof options\n\nconst common: OptionName[] = ['cwd', 'mode', 'json', 'help']\n\n/** The options each command reads; any other option is a usage error instead of being ignored. */\nconst commandOptions: Record<string, OptionName[]> = {\n    check: [...common, 'edit', 'message', 'title', 'base', 'head', 'from', 'to', 'files'],\n    explain: [...common, 'from', 'to'],\n    release: [...common, 'dry-run', 'branch'],\n    policy: [...common, 'markdown'],\n    agents: [...common, 'file', 'write'],\n    doctor: common,\n    help: ['help']\n}\n\nfunction parse(argv: string[]) {\n    try {\n        return parseArgs({ args: argv, allowPositionals: true, options })\n    } catch (error) {\n        return error as Error\n    }\n}\n\nfunction readVersion() {\n    const file = new URL('../package.json', import.meta.url)\n    return (JSON.parse(fs.readFileSync(file, 'utf8')) as { version: string }).version\n}\n\nasync function main(argv: string[]): Promise<CommandResult> {\n    const parsed = parse(argv)\n    // A usage error exits with 2 and shows the usage, like an unknown command.\n    if (parsed instanceof Error) return { code: 2, output: `${parsed.message}\\n\\n${help}` }\n    const { positionals, values } = parsed\n    if (values.version) return { code: 0, output: readVersion() }\n    const [command, ...extra] = positionals\n    if (extra.length) return { code: 2, output: `Unexpected argument \"${extra[0]}\".\\n\\n${help}` }\n    if (command === 'help' || (values.help && (!command || command in commandOptions))) return { code: 0, output: help }\n    if (!command) return { code: 2, output: help }\n    const allowed = commandOptions[command]\n    if (!allowed) return { code: 2, output: `Unknown command \"${command}\".\\n\\n${help}` }\n    const unsupported = (Object.keys(values) as OptionName[]).filter((key) => !allowed.includes(key))\n    if (unsupported.length) return { code: 2, output: `\\`aronrepo ${command}\\` does not take --${unsupported[0]}.\\n\\n${help}` }\n    if (values.mode && !releaseModes.includes(values.mode as ReleaseMode)) {\n        return { code: 2, output: `--mode must be one of: ${releaseModes.join(', ')}` }\n    }\n    if (values.cwd && !fs.existsSync(values.cwd)) return { code: 2, output: `--cwd ${values.cwd} does not exist.` }\n    const shared = {\n        ...(values.cwd ? { cwd: values.cwd } : {}),\n        ...(values.mode ? { mode: values.mode as ReleaseMode } : {}),\n        ...(values.json ? { json: true } : {})\n    }\n    const optional = <K extends keyof typeof values>(...keys: K[]) =>\n        Object.fromEntries(keys.filter((key) => values[key] !== undefined).map((key) => [key, values[key]]))\n\n    switch (command) {\n        case 'check':\n            return check({\n                ...shared,\n                ...optional('message', 'title', 'base', 'head', 'from', 'to'),\n                // A path on the command line is relative to the current directory, not to --cwd.\n                ...(values.edit !== undefined ? { edit: path.resolve(values.edit) } : {}),\n                ...(values.files !== undefined ? { files: values.files.split(',').map((file) => file.trim()).filter(Boolean) } : {})\n            })\n        case 'explain':\n            return explain({ ...shared, ...optional('from', 'to') })\n        case 'release':\n            return release({ ...shared, ...optional('branch'), ...(values['dry-run'] ? { dryRun: true } : {}) })\n        case 'policy':\n            return policy({ ...shared, ...(values.markdown ? { markdown: true } : {}) })\n        case 'agents':\n            return agents({ ...shared, ...optional('file'), ...(values.write ? { write: true } : {}) })\n        default:\n            return doctor(shared)\n    }\n}\n\nconst json = process.argv.includes('--json')\n\nmain(process.argv.slice(2))\n    .then(({ code, output }) => {\n        // Reports, including failed checks, go to stdout so `--json > file` and pipes keep them; usage errors go to stderr.\n        if (output) {\n            const text = json && code === 2 && !output.trimStart().startsWith('{') ? JSON.stringify({ error: output.split('\\n')[0], code }) : output\n            const stream = code === 2 ? process.stderr : process.stdout\n            stream.write(`${text}\\n`)\n        }\n        process.exitCode = code\n    })\n    .catch((error: unknown) => {\n        const message = error instanceof Error ? error.message : String(error)\n        process.stderr.write(`${json ? JSON.stringify({ error: message, code: 1 }) : message}\\n`)\n        process.exitCode = 1\n    })\n"],"mappings":"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"}