@kitschpatrol/chagent 0.5.0 → 0.6.0

package/dist/bin/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { C as defaultModels, E as version, S as setLogger, T as maxTimeoutMinutes, a as writeChangelog, d as efforts, f as rootChangelogs, i as generateChangelog, n as previewChangelog, r as reviewChangelog, t as assertReviewTerminal, u as agentNames, w as defaults } from "../review-Bl10DPO7.js";
-import { n as assertAmendable, t as amendRelease } from "../lib-DVZXk4YE.js";
-import { t as createProgressLine } from "../progress-DQtRnH1N.js";
+import { C as defaultModels, E as version, S as setLogger, T as maxTimeoutMinutes, a as writeChangelog, d as efforts, f as rootChangelogs, i as generateChangelog, n as previewChangelog, r as reviewChangelog, t as assertReviewTerminal, u as agentNames, w as defaults } from "../review-cNqsjqhu.js";
+import { n as assertAmendable, t as amendRelease } from "../lib-BkbC8akL.js";
+import { t as createProgressLine } from "../progress-BYDpiH8C.js";
 import { createLogger } from "lognow";
 import path from "node:path";
 import yargs from "yargs";

package/dist/lib/bumpp.js

@@ -1,5 +1,5 @@
-import { a as writeChangelog, g as localDate, i as generateChangelog, r as reviewChangelog, t as assertReviewTerminal, y as git } from "../review-Bl10DPO7.js";
-import { t as createProgressLine } from "../progress-DQtRnH1N.js";
+import { a as writeChangelog, g as localDate, i as generateChangelog, r as reviewChangelog, t as assertReviewTerminal, y as git } from "../review-cNqsjqhu.js";
+import { t as createProgressLine } from "../progress-BYDpiH8C.js";
 
 // src/lib/bumpp.ts
 const TAG_TOKEN = /\{(version|oldVersion|tag|releaseType|major|minor|patch|date)\}/gv;

package/dist/lib/index.js

@@ -1,4 +1,4 @@
-import { S as setLogger, a as writeChangelog, i as generateChangelog, l as createAgent, n as previewChangelog, o as defineConfig, r as reviewChangelog, s as loadConfig } from "../review-Bl10DPO7.js";
-import { t as amendRelease } from "../lib-DVZXk4YE.js";
+import { S as setLogger, a as writeChangelog, i as generateChangelog, l as createAgent, n as previewChangelog, o as defineConfig, r as reviewChangelog, s as loadConfig } from "../review-cNqsjqhu.js";
+import { t as amendRelease } from "../lib-BkbC8akL.js";
 
 export { amendRelease, createAgent, defineConfig, generateChangelog, loadConfig, previewChangelog, reviewChangelog, setLogger, writeChangelog };

package/dist/{lib-DVZXk4YE.js → lib-BkbC8akL.js}

@@ -1,4 +1,4 @@
-import { _ as manifestAt, a as writeChangelog, b as isAncestor, c as resolveConfig, h as isVersionOnlyChange, m as inspectRepository, p as LOCKFILE_PATH, s as loadConfig, v as tagVersion, x as runCommand, y as git } from "./review-Bl10DPO7.js";
+import { _ as manifestAt, a as writeChangelog, b as isAncestor, c as resolveConfig, h as isVersionOnlyChange, m as inspectRepository, p as LOCKFILE_PATH, s as loadConfig, v as tagVersion, x as runCommand, y as git } from "./review-cNqsjqhu.js";
 import path from "node:path";
 import { realpath } from "node:fs/promises";
 import semver from "semver";

package/dist/{progress-DQtRnH1N.js → progress-BYDpiH8C.js}

@@ -38,7 +38,7 @@ function createProgressLine(stream) {
 		tick += 1;
 		const elapsed = formatElapsed(performance.now() - started);
 		const { columns = 0 } = stream;
-		const width = columns > 0 ? Math.max(0, columns - 1 - frame.length - 2) : Infinity;
+		const width = columns > 0 ? Math.max(0, columns - 1 - frame.length - 2) : 1e400;
 		const text = `${message.slice(0, Math.max(0, width - elapsed.length - 1))} ${elapsed}`.slice(0, width);
 		return `\r${styleText("magenta", frame, { stream })}${FRAME_PADDING}${text}${CLEAR_TO_LINE_END}`;
 	};

package/dist/{review-Bl10DPO7.js → review-cNqsjqhu.js}

@@ -15,7 +15,7 @@ import { isCancel, select } from "@clack/prompts";
 
 // package.json
 var name = "@kitschpatrol/chagent";
-var version = "0.5.0";
+var version = "0.6.0";
 var engines = { "node": "^24.16.0 || >=26.3.0" };
 
 // src/lib/defaults.ts
@@ -453,10 +453,26 @@ async function leadsSeries(root, candidate, candidates) {
 function pendingTag(pkg, version, previous, patterns) {
 	return (previous?.tag?.includes(previous.version) === true ? previous.tag.replace(previous.version, "{version}") : patterns?.[0] ?? "v{version}").replaceAll("{name}", () => pkg.name).replaceAll("{version}", () => version);
 }
+/**
+* Order releases by Git ancestry, using SemVer only for tags on the same
+* commit.
+*/
+async function sortReleases(repository, releases) {
+	const history = await git(repository.root, [
+		"rev-list",
+		"--topo-order",
+		"--reverse",
+		repository.head
+	]);
+	const positions = new Map(history.split("\n").map((ref, index) => [ref, index]));
+	return releases.toSorted((a, b) => {
+		const difference = (positions.get(a.ref) ?? -1) - (positions.get(b.ref) ?? -1);
+		return difference === 0 ? semver.compare(a.version, b.version) : difference;
+	});
+}
 /** Resolve release intervals from reachable tags and locally bumped manifests. */
 async function resolveReleases(repository, pkg, config, context) {
-	const releases = await taggedReleases(repository, pkg, config);
-	releases.sort((a, b) => semver.compare(a.version, b.version));
+	const releases = await sortReleases(repository, await taggedReleases(repository, pkg, config));
 	for (let index = 1; index < releases.length; index++) {
 		const current = releases[index];
 		const previous = await precedingRelease(repository.root, releases.slice(0, index), current.ref);
@@ -465,7 +481,7 @@ async function resolveReleases(repository, pkg, config, context) {
 	}
 	const latest = releases.at(-1);
 	const currentVersion = pkg.version ?? (pkg.directory === "." ? context?.version : void 0);
-	if (await isPendingRelease(repository, pkg, latest, context) && currentVersion !== void 0) releases.push({
+	if (await isPendingRelease(repository, pkg, releases, context) && currentVersion !== void 0) releases.push({
 		date: context?.date ?? localDate(),
 		pending: true,
 		previousRef: latest?.ref,
@@ -617,13 +633,13 @@ async function taggedReleases(repository, pkg, config) {
 async function precedingRelease(root, candidates, ref) {
 	for (const candidate of candidates.toReversed()) if (await isAncestor(root, candidate.ref, ref)) return candidate;
 }
-async function isPendingRelease(repository, pkg, latest, context) {
+async function isPendingRelease(repository, pkg, releases, context) {
 	const currentVersion = pkg.version ?? (pkg.directory === "." ? context?.version : void 0);
 	const committed = await manifestAt(repository.root, pkg.directory, repository.head);
 	const versionChanged = currentVersion !== void 0 && currentVersion !== committed?.version;
 	const parent = await manifestAt(repository.root, pkg.directory, repository.head + "^");
 	const committedBump = parent?.version !== void 0 && parent.version !== committed?.version;
-	return currentVersion !== void 0 && semver.valid(currentVersion) !== null && (latest === void 0 || semver.gt(currentVersion, latest.version)) && (versionChanged || context !== void 0 || committedBump);
+	return currentVersion !== void 0 && semver.valid(currentVersion) !== null && releases.every((release) => release.version !== semver.valid(currentVersion)) && (versionChanged || context !== void 0 || committedBump && releases.every((release) => release.ref !== repository.head));
 }
 
 // src/lib/cache.ts
@@ -1459,7 +1475,7 @@ function releaseLink(github, release) {
 	return release.previousTag === void 0 ? `${base}/releases/tag/${encodeURIComponent(release.tag)}` : `${base}/compare/${encodeURIComponent(release.previousTag)}...${encodeURIComponent(release.tag)}`;
 }
 /** Insert new sections and update only the draft and its comparison link. */
-function updateMarkdown(original, entries, nodeException, github) {
+function updateMarkdown(original, entries, nodeException, github, releaseOrder) {
 	const content = original ?? "# Changelog\n\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n";
 	const parsed = parseChangelog(content);
 	const { newline } = parsed;
@@ -1468,7 +1484,10 @@ function updateMarkdown(original, entries, nodeException, github) {
 	const definitions = [];
 	let { footer } = parsed;
 	const draft = parsed.sections.find((section) => section.version === "Unreleased");
-	const released = parsed.sections.filter((section) => section.version !== "Unreleased").map((section) => content.slice(section.start, section.end));
+	const released = parsed.sections.filter((section) => section.version !== "Unreleased").map((section) => ({
+		text: content.slice(section.start, section.end),
+		version: section.version
+	}));
 	let draftText = draft === void 0 ? "" : content.slice(draft.start, draft.end);
 	for (const entry of entries) {
 		const { existingBody, release } = entry;
@@ -1485,7 +1504,10 @@ function updateMarkdown(original, entries, nodeException, github) {
 		const section = heading + newline + newline + body.trim() + newline + newline;
 		if (release.version === "Unreleased") draftText = section;
 		else {
-			additions.push(section);
+			additions.push({
+				text: section,
+				version: release.version
+			});
 			if (existingBody !== void 0) draftText = "";
 		}
 		if (link === void 0) continue;
@@ -1497,9 +1519,13 @@ function updateMarkdown(original, entries, nodeException, github) {
 	}
 	if (entries.length === 0 && header === parsed.header) return content;
 	if (draftText === "") footer = footer.replace(UNRELEASED_REFERENCE, "");
-	const generated = sectionSpacing(sectionSpacing(header, newline) + draftText, newline) + additions.toReversed().join("");
-	const preserved = released.join("") + footer;
-	return appendDefinitions(preserved === "" ? generated.trimEnd() + newline : generated + preserved, footer, definitions, newline);
+	const sections = [...additions.toReversed(), ...released];
+	if (releaseOrder !== void 0) {
+		const positions = new Map(releaseOrder.map((version, index) => [version, index]));
+		sections.sort((a, b) => (positions.get(b.version) ?? -1) - (positions.get(a.version) ?? -1));
+	}
+	const result = sectionSpacing(sectionSpacing(header, newline) + draftText, newline) + sections.map((section) => section.text).join("") + footer;
+	return appendDefinitions(footer === "" && released.length === 0 ? result.trimEnd() + newline : result, footer, definitions, newline);
 }
 /** Add link reference definitions after any existing footer. */
 function appendDefinitions(content, footer, definitions, newline) {
@@ -2108,16 +2134,15 @@ function leavesGeneratedDraft(entries, previously) {
 	const draft = entries.find((entry) => entry.release.version === "Unreleased");
 	return previously || draft !== void 0 && (draft.existingBody === void 0 || draft.revise === true);
 }
-/** Select the releases newer than anything the changelog already records. */
+/** Select every reachable release the changelog does not already record. */
 function missingReleases(releases, content = "") {
 	const { sections } = parseChangelog(content);
 	const known = new Set(sections.map((section) => section.version));
 	const recorded = sections.filter((section) => section.version !== "Unreleased").map((section) => section.version);
 	const unrecognized = recorded.filter((version) => semver.valid(version) === null);
 	if (unrecognized.length > 0) throw new Error(`The existing changelog has unrecognized release headings (${unrecognized.join(", ")}). Normalize its release headings before updating it.`);
-	const newest = recorded.toSorted(semver.rcompare)[0];
-	if (newest !== void 0 && releases.every((release) => release.version !== newest)) throw new Error(`Cannot locate the Git release boundary for existing changelog version ${newest}. Fetch its tags or configure tagPatterns.`);
-	return releases.filter((release) => release.version === "Unreleased" || !known.has(release.version) && (newest === void 0 || semver.gt(release.version, newest)));
+	for (const version of recorded) if (releases.every((release) => release.version !== version)) throw new Error(`Cannot locate the Git release boundary for existing changelog version ${version}. Fetch its tags or configure tagPatterns.`);
+	return releases.filter((release) => release.version === "Unreleased" || !known.has(release.version));
 }
 /** Apply an explicit release context only to the package being released. */
 function releaseContext(options, pkg) {
@@ -2216,7 +2241,7 @@ function renderPackage(context, prepared, results, linksFor) {
 			revise
 		});
 	}
-	const after = updateMarkdown(content, entries, exception, repository.github);
+	const after = updateMarkdown(content, entries, exception, repository.github, releases.map((release) => release.version));
 	if (after !== file.content) plan.files.push({
 		after,
 		before: file.content,
@@ -2240,14 +2265,7 @@ function headingAnchor(heading) {
 function missingPackageSummaries(summaries, content = "") {
 	const parsed = parseChangelog(content);
 	const known = new Set(parsed.sections.map((section) => section.version));
-	return summaries.toSorted((a, b) => (a.date ?? "9999").localeCompare(b.date ?? "9999")).filter((summary) => {
-		if (summary.version === "Unreleased" || known.has(`${summary.packageName}@${summary.version}`)) return false;
-		return parsed.sections.every((section) => {
-			const prefix = summary.packageName + "@";
-			const version = section.version.startsWith(prefix) ? section.version.slice(prefix.length) : "";
-			return semver.valid(version) === null || semver.lt(version, summary.version);
-		});
-	});
+	return summaries.filter((summary) => summary.version !== "Unreleased" && !known.has(`${summary.packageName}@${summary.version}`));
 }
 
 // src/lib/workspace.ts
@@ -2320,10 +2338,11 @@ async function prepareIndependent(context, packages) {
 * Write a section for each package release the root does not record yet, and
 * keep the draft's links to packages with unreleased changes current.
 */
-function renderIndependent(context, prepared, results, summaries, exception) {
+async function renderIndependent(context, prepared, results, summaries, exception) {
 	const { plan, repository } = context;
 	const { content, draft, file, unreleased } = prepared;
-	const entries = Array.from(missingPackageSummaries(summaries, content), (summary) => ({
+	const ordered = await sortReleases(repository, summaries.filter((summary) => summary.version !== "Unreleased"));
+	const entries = Array.from(missingPackageSummaries(ordered, content), (summary) => ({
 		changes: results.get(summaryId(summary)) ?? [],
 		links: packageLink(repository, summary),
 		release: {
@@ -2343,7 +2362,7 @@ function renderIndependent(context, prepared, results, summaries, exception) {
 		release: unreleased.release,
 		revise
 	});
-	const after = updateMarkdown(content, entries, exception, repository.github);
+	const after = updateMarkdown(content, entries, exception, repository.github, ordered.map((summary) => `${summary.packageName}@${summary.version}`));
 	if (after !== file.content) plan.files.push({
 		after,
 		before: file.content,
@@ -2387,7 +2406,7 @@ async function generateWorkspace(context) {
 			...root,
 			exception: exception || root.exception
 		}, results, (release) => summaries.filter((summary) => summary.version === release.version && summary.ref === release.ref && !quiet.has(`${summary.changelogPath}@${summary.version}`)).flatMap((summary) => packageLink(repository, summary)));
-	} else if (independent !== void 0) renderIndependent(context, independent, results, summaries, exception);
+	} else if (independent !== void 0) await renderIndependent(context, independent, results, summaries, exception);
 }
 
 // src/lib/generate.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitschpatrol/chagent",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Changelog agent. CLI tool and TypeScript library to generate and update changelogs with a little help from your LLMs.",
   "keywords": [
     "changelog",
@@ -45,7 +45,7 @@
     "dist"
   ],
   "dependencies": {
-    "@clack/prompts": "^1.8.1",
+    "@clack/prompts": "^1.9.0",
     "@types/node": "~24.13.6",
     "cosmiconfig": "^10.0.1",
     "cross-spawn": "^7.0.6",
@@ -67,7 +67,7 @@
     "mdat-plugin-cli-help": "^3.4.2",
     "publint": "^0.3.25",
     "shx": "^0.4.0",
-    "tsdown": "^0.23.5",
+    "tsdown": "^0.23.7",
     "typescript": "~6.0.3",
     "vitest": "^5.1.0"
   },

package/readme.md

@@ -287,6 +287,8 @@ Use `packages` and `exclude` directory globs to customize workspace discovery, a
 
 ### Implementation notes
 
+Release order follows Git ancestry, with SemVer breaking ties between tags on the same commit. Fork releases such as `1.2.0-fork.2` can therefore follow upstream `1.2.0`. Updates fill missing reachable releases even when their versions compare lower than an existing heading, while preserving the text of recorded sections.
+
 Chagent reads reachable version tags and commit history regardless of the project's language. Optional npm metadata supplies workspace discovery, local version-bump detection before tagging, and the conditional Node.js compatibility note. Repository tags remain authoritative even when a root `package.json` has an unrelated tooling version. Other projects use tagged releases, or an explicit `release` context through the library API. Without reliable released-version boundaries, new changes belong to `Unreleased`; version numbers are not invented. An existing release heading with no matching Git boundary requires its tags or a corrected tag pattern. Release headings can be level one or two, with optional links, dates, and a `v` prefix, including the Conventional Changelog format. Headings can name short versions the way tags do, so `## 1.2` and `## v1` record the `1.2.0` and `1.0.0` releases. Level three headings count as releases when they name a version, as standard-version writes patch releases. Chagent stops rather than risk duplicating history when a level one or two heading names a version in another form, or when an unclosed code fence would hide later headings. Broken `package.json` files in history are tolerated. Shallow clones must be completed before generation.
 
 GitHub enrichment uses release dates and commit-associated PR information. PR lookups batch unique commits across all requested releases and packages; each release receives only its associated PRs. **GitHub release-note bodies are never generation inputs.** Changelog files, lockfiles, and `node_modules` are never source evidence. Existing changelog prose is supplied only to preserve edits, avoid duplicate entries, and show the writing style to match: each request carries the changelog's newest release section as a style reference, so new entries follow its voice, punctuation, and reference conventions.