@savvy-web/silk 1.3.10 → 1.3.11

package/changesets-changelog.cjs

@@ -70011,11 +70011,14 @@ const GitHubInfoSchema = effect.Schema.Struct({
 * handles the "Updated dependencies" section that Changesets appends
 * when a package's dependencies are bumped as part of a release.
 *
-* The output is a GFM (GitHub Flavored Markdown) table with columns:
-* `Dependency`, `Type`, `Action`, `From`, `To`. The dependency type
-* is inferred from the consuming package's `package.json` fields
-* (`dependencies`, `devDependencies`, `peerDependencies`,
-* `optionalDependencies`) via the {@link inferDependencyType} helper.
+* The output is a `### Dependencies` h3 heading followed by a GFM
+* (GitHub Flavored Markdown) table with columns: `Dependency`, `Type`,
+* `Action`, `From`, `To`. The dependency type is inferred from the
+* consuming package's `package.json` fields (`dependencies`,
+* `devDependencies`, `peerDependencies`, `optionalDependencies`) via
+* the {@link inferDependencyType} helper. Downstream, the heading is
+* consumed by `AggregateDependencyTablesPlugin`, which locates and
+* merges per-package dependency tables during changelog assembly.
 *
 * ### Dependency type inference
 *
@@ -70081,7 +70084,8 @@ function inferDependencyType(dep) {
 * The function maps each `ModCompWithPackage` entry to a `DependencyTableRow`,
 * inferring the dependency type from the consuming package's `package.json`,
 * then delegates to `serializeDependencyTableToMarkdown` for GFM table
-* rendering. Returns an empty string when no dependencies were updated.
+* rendering, prefixed with a `### Dependencies` heading. Returns an empty
+* string when no dependencies were updated.
 *
 * The `_changesets` and `_options` parameters are part of the Changesets API
 * contract but are not used in the table format. They are retained for
@@ -70090,19 +70094,19 @@ function inferDependencyType(dep) {
 * @param _changesets - Changesets that caused the dependency updates (unused in table format)
 * @param dependenciesUpdated - The list of dependencies that were updated, including old/new versions
 * @param _options - Validated configuration options (unused in table format)
-* @returns An `Effect` that resolves to a formatted markdown table string, or empty string if no dependencies were updated
+* @returns An `Effect` that resolves to a `### Dependencies` heading followed by a formatted markdown table string, or empty string if no dependencies were updated
 */
 function getDependencyReleaseLine(_changesets, dependenciesUpdated, _options) {
 	return effect.Effect.gen(function* () {
 		if (dependenciesUpdated.length === 0) return "";
 		yield* GitHubService;
-		return serializeDependencyTableToMarkdown(dependenciesUpdated.map((dep) => ({
+		return `### Dependencies\n\n${serializeDependencyTableToMarkdown(dependenciesUpdated.map((dep) => ({
 			dependency: dep.name,
 			type: inferDependencyType(dep),
 			action: "updated",
 			from: dep.oldVersion,
 			to: dep.newVersion
-		})));
+		})))}`;
 	});
 }
 //#endregion
@@ -70445,8 +70449,8 @@ const ISSUE_CATEGORIES = [
 /**
 * Format a changelog entry into a markdown string with GitHub links.
 *
-* Produces a commit-link prefix (shortened to 7 characters) followed by the
-* summary text and any issue references, each rendered as GitHub links.
+* Produces the summary text followed by any issue references, each
+* rendered as GitHub links.
 *
 * @remarks
 * The output does **not** include a leading `- ` list marker — the caller
@@ -70456,13 +70460,11 @@ const ISSUE_CATEGORIES = [
 *
 * Output format examples:
 *
-* With commit: `[short-hash](commit-url) Summary text`
+* Without issues: `Summary text`
 *
 * With issues: `Summary text` followed by `Closes: [#1](issue-url)`
 *
-* With both: `[short-hash](commit-url) Summary text` followed by `Fixes: [#2](issue-url)`
-*
-* @param entry - The changelog entry containing commit, summary, and issue data
+* @param entry - The changelog entry containing summary and issue data
 * @param options - Must include `repo` in `owner/repo` format for link generation
 * @returns Formatted markdown string (without leading `- `)
 *
@@ -70470,10 +70472,6 @@ const ISSUE_CATEGORIES = [
 */
 function formatChangelogEntry(entry, options) {
 	const parts = [];
-	if (entry.commit) {
-		const shortHash = entry.commit.substring(0, 7);
-		parts.push(`[\`${shortHash}\`](https://github.com/${options.repo}/commit/${entry.commit})`);
-	}
 	parts.push(entry.summary.trim());
 	const issueLinks = [];
 	for (const { key, label } of ISSUE_CATEGORIES) {
@@ -70547,7 +70545,7 @@ function formatPRAndUserAttribution(pr, user, links) {
 *
 * 1. **Section-aware changesets** — When the changeset summary contains h2
 *    headings (e.g., `## Features`, `## Bug Fixes`), each section is rendered
-*    as an h3 heading with commit-linked list items beneath it. This mode
+*    as an h3 heading with list items beneath it. This mode
 *    produces multi-line output suitable for rich changelogs.
 *
 * 2. **Flat-text changesets** — When the summary is plain text without section
@@ -70557,7 +70555,6 @@ function formatPRAndUserAttribution(pr, user, links) {
 *
 * In both modes, the formatter:
 * - Fetches GitHub metadata (PR number, author) via {@link GitHubService}
-* - Generates shortened commit hash links (`[abc1234](...)`)
 * - Extracts and renders issue references (Closes, Fixes, Refs)
 * - Appends PR and user attribution when available
 *
@@ -70588,7 +70585,7 @@ function formatPRAndUserAttribution(pr, user, links) {
 *    `Fixes #N`, and `Refs #N` patterns.
 * 5. **Build attribution** — Format PR link and user credit from GitHub info.
 * 6. **Section-aware output** — If sections were found, render each as an
-*    h3 heading with commit-linked list items.
+*    h3 heading with list items.
 * 7. **Flat-text fallback** — Otherwise, produce a single `- entry` line
 *    with the resolved category heading.
 *
@@ -70622,14 +70619,16 @@ function getReleaseLine(changeset, versionType, options) {
 			for (const section of parsed.sections) {
 				lines.push(`### ${section.category.heading}`);
 				lines.push("");
-				const commitPrefix = changeset.commit ? `[\`${changeset.commit.substring(0, 7)}\`](https://github.com/${options.repo}/commit/${changeset.commit}) ` : "";
 				if (section.content) {
 					const contentLines = section.content.split("\n");
 					const firstContentLine = contentLines[0];
 					if (firstContentLine.startsWith("- ") || firstContentLine.startsWith("* ")) {
-						lines.push(`${firstContentLine.substring(0, 2)}${commitPrefix}${firstContentLine.substring(2)}`);
+						lines.push(firstContentLine);
 						lines.push(...contentLines.slice(1));
-					} else lines.push(`- ${commitPrefix}${section.content}`);
+					} else {
+						lines.push(`- ${firstContentLine}`);
+						lines.push(...contentLines.slice(1).map((line) => line.length > 0 ? `  ${line}` : line));
+					}
 				}
 				lines.push("");
 			}
@@ -70638,8 +70637,7 @@ function getReleaseLine(changeset, versionType, options) {
 		return `- ${formatChangelogEntry({
 			type: resolveCommitType(commitMsg.type ?? versionType, commitMsg.scope, commitMsg.breaking).heading,
 			summary: changeset.summary,
-			issues: issueRefs,
-			...changeset.commit ? { commit: changeset.commit } : {}
+			issues: issueRefs
 		}, { repo: options.repo })}${attribution}`;
 	});
 }
@@ -70679,7 +70677,7 @@ function getReleaseLine(changeset, versionType, options) {
 *    config is decoded through `ChangesetOptionsSchema`.
 * 2. **Release line formatting** — each changeset is formatted by
 *    `getReleaseLine`, which resolves GitHub metadata, parses sections,
-*    and produces structured markdown with commit links and attribution.
+*    and produces structured markdown with attribution.
 * 3. **Dependency table formatting** — bulk dependency updates are
 *    formatted by `getDependencyReleaseLine` into a markdown table.
 *
@@ -71577,6 +71575,105 @@ function getHeadingText$1(heading) {
 	return toString(heading);
 }
 //#endregion
+//#region ../silk-effects/dist/dev/pkg/changesets/remark/plugins/maintenance-note.js
+function buildNoteChildren(reason) {
+	if (reason.kind === "unspecified" || reason.triggers.length === 0) return [{
+		type: "text",
+		value: "Version-only release to keep workspace versions consistent; no changes to this package."
+	}];
+	const label = reason.kind === "fixed" ? "fixed version group" : "linked version group";
+	const children = [{
+		type: "text",
+		value: "Released in lockstep with "
+	}];
+	reason.triggers.forEach((trigger, index) => {
+		if (index > 0) children.push({
+			type: "text",
+			value: ", "
+		});
+		children.push({
+			type: "inlineCode",
+			value: `${trigger.name}@${trigger.version}`
+		});
+	});
+	children.push({
+		type: "text",
+		value: ` (${label}).`
+	});
+	return children;
+}
+const MaintenanceNotePlugin = (options) => {
+	return (tree) => {
+		const block = getVersionBlocks(tree).find((b) => getHeadingText$1(tree.children[b.headingIndex]) === options.version);
+		if (!block) return;
+		if (block.endIndex > block.startIndex) return;
+		const heading = {
+			type: "heading",
+			depth: 3,
+			children: [{
+				type: "text",
+				value: "Maintenance"
+			}]
+		};
+		const list = {
+			type: "list",
+			ordered: false,
+			spread: false,
+			children: [{
+				type: "listItem",
+				spread: false,
+				children: [{
+					type: "paragraph",
+					children: buildNoteChildren(options.reason)
+				}]
+			}]
+		};
+		tree.children.splice(block.startIndex, 0, heading, list);
+	};
+};
+//#endregion
+//#region ../silk-effects/dist/dev/pkg/changesets/remark/plugins/aggregate-dependency-tables.js
+const AggregateDependencyTablesPlugin = () => {
+	return (tree) => {
+		const blocks = getVersionBlocks(tree);
+		for (let b = blocks.length - 1; b >= 0; b--) {
+			const depSections = getBlockSections(tree, blocks[b]).filter((s) => getHeadingText$1(s.heading).toLowerCase() === "dependencies");
+			if (depSections.length === 0) continue;
+			const allRows = [];
+			const legacyContent = [];
+			for (const section of depSections) for (const node of section.contentNodes) if (node.type === "table") try {
+				const rows = parseDependencyTable(node);
+				allRows.push(...rows);
+			} catch {
+				legacyContent.push(node);
+			}
+			else legacyContent.push(node);
+			const collapsed = sortDependencyRows(collapseDependencyRows(allRows));
+			const indicesToRemove = [];
+			for (const section of depSections) {
+				indicesToRemove.push(section.headingIndex);
+				for (let c = 0; c < section.contentNodes.length; c++) indicesToRemove.push(section.headingIndex + 1 + c);
+			}
+			indicesToRemove.sort((a, b) => b - a);
+			for (const idx of indicesToRemove) tree.children.splice(idx, 1);
+			if (collapsed.length === 0 && legacyContent.length === 0) continue;
+			const insertAt = depSections[0].headingIndex;
+			const newNodes = [];
+			newNodes.push({
+				type: "heading",
+				depth: 3,
+				children: [{
+					type: "text",
+					value: "Dependencies"
+				}]
+			});
+			if (collapsed.length > 0) newNodes.push(serializeDependencyTable(collapsed));
+			newNodes.push(...legacyContent);
+			tree.children.splice(insertAt, 0, ...newNodes);
+		}
+	};
+};
+//#endregion
 //#region ../silk-effects/dist/dev/pkg/changesets/remark/plugins/contributor-footnotes.js
 /**
 * Pattern matching `Thanks @user!` at end of text.
@@ -71701,16 +71798,18 @@ const DeduplicateItemsPlugin = () => {
 		const blocks = getVersionBlocks(tree);
 		for (const block of blocks) {
 			const sections = getBlockSections(tree, block);
-			for (const section of sections) for (const node of section.contentNodes) {
-				if (node.type !== "list") continue;
-				const list = node;
+			for (const section of sections) {
 				const seen = /* @__PURE__ */ new Set();
-				list.children = list.children.filter((item) => {
-					const text = toString(item);
-					if (seen.has(text)) return false;
-					seen.add(text);
-					return true;
-				});
+				for (const node of section.contentNodes) {
+					if (node.type !== "list") continue;
+					const list = node;
+					list.children = list.children.filter((item) => {
+						const text = toString(item);
+						if (seen.has(text)) return false;
+						seen.add(text);
+						return true;
+					});
+				}
 			}
 		}
 		tree.children = tree.children.filter((node) => {
@@ -71882,6 +71981,110 @@ const ReorderSectionsPlugin = () => {
 	};
 };
 //#endregion
+//#region ../silk-effects/dist/dev/pkg/changesets/remark/presets.js
+/**
+* Remark preset collections for changeset lint rules and transform plugins.
+*
+* @remarks
+* Presets bundle related remark plugins into ordered arrays for convenient
+* consumption. Each preset is a `readonly` tuple so that TypeScript can
+* narrow element types. Iterate and `.use()` each entry with `unified()`.
+*
+* @see {@link SilkChangesetPreset} for lint rules
+* @see {@link SilkChangesetTransformPreset} for transform plugins
+*/
+/**
+* Preset combining all changeset lint rules for convenient consumption.
+*
+* @remarks
+* Includes the following rules in order:
+*
+* 1. {@link HeadingHierarchyRule} (CSH001) -- no h1, no depth skips
+* 2. {@link RequiredSectionsRule} (CSH002) -- h2 headings must match a known category
+* 3. {@link ContentStructureRule} (CSH003) -- non-empty sections, code fence languages, non-empty list items
+* 4. {@link UncategorizedContentRule} (CSH004) -- no content before the first h2 heading
+* 5. {@link DependencyTableFormatRule} (CSH005) -- dependency table column/value validation
+*
+* Rule execution order is not significant for lint rules; all rules run
+* independently over the same AST and report warnings to the virtual file.
+*
+* @example
+* ```typescript
+* import { SilkChangesetPreset } from "\@savvy-web/changesets/remark";
+* import remarkParse from "remark-parse";
+* import { unified } from "unified";
+* import { read } from "to-vfile";
+*
+* const processor = unified().use(remarkParse);
+* for (const rule of SilkChangesetPreset) {
+*   processor.use(rule);
+* }
+*
+* const file = await read("changeset.md");
+* const result = await processor.process(file);
+* console.log(result.messages); // lint warnings
+* ```
+*
+* @see {@link SilkChangesetTransformPreset} for the corresponding transform preset
+*
+* @public
+*/
+const SilkChangesetPreset = [
+	HeadingHierarchyRule$1,
+	RequiredSectionsRule$1,
+	ContentStructureRule$1,
+	UncategorizedContentRule$1,
+	DependencyTableFormatRule$1
+];
+/**
+* Ordered array of all transform plugins in the correct execution order.
+*
+* @remarks
+* Plugin ordering is significant -- each plugin may depend on the output of
+* earlier plugins in the pipeline:
+*
+* 1. {@link AggregateDependencyTablesPlugin} -- merge duplicate dependency sections (must run first so downstream plugins see a single Dependencies section)
+* 2. {@link MergeSectionsPlugin} -- merge duplicate h3 headings (must run before reorder so that priority is computed on consolidated sections)
+* 3. {@link ReorderSectionsPlugin} -- sort sections by category priority (Breaking Changes first, Other last)
+* 4. {@link DeduplicateItemsPlugin} -- remove duplicate list items within each section
+* 5. {@link ContributorFootnotesPlugin} -- extract inline `Thanks \@user!` attributions and aggregate them into a summary paragraph per version block
+* 6. {@link IssueLinkRefsPlugin} -- convert inline `[#N](url)` links to reference-style `[#N]` with definitions at the end of each version block
+* 7. {@link NormalizeFormatPlugin} -- final cleanup removing empty sections and empty lists
+*
+* @example
+* ```typescript
+* import { SilkChangesetTransformPreset } from "\@savvy-web/changesets/remark";
+* import remarkGfm from "remark-gfm";
+* import remarkParse from "remark-parse";
+* import remarkStringify from "remark-stringify";
+* import { unified } from "unified";
+* import { read } from "to-vfile";
+*
+* const processor = unified().use(remarkParse).use(remarkGfm);
+* for (const plugin of SilkChangesetTransformPreset) {
+*   processor.use(plugin);
+* }
+* processor.use(remarkStringify);
+*
+* const file = await read("CHANGELOG.md");
+* const result = await processor.process(file);
+* console.log(String(result));
+* ```
+*
+* @see {@link SilkChangesetPreset} for the corresponding lint preset
+*
+* @public
+*/
+const SilkChangesetTransformPreset = [
+	AggregateDependencyTablesPlugin,
+	MergeSectionsPlugin,
+	ReorderSectionsPlugin,
+	DeduplicateItemsPlugin,
+	ContributorFootnotesPlugin,
+	IssueLinkRefsPlugin,
+	NormalizeFormatPlugin
+];
+//#endregion
 //#region ../silk-effects/dist/dev/pkg/changesets/api/transformer.js
 /**
 * Class-based API wrapper for changelog transformation.
@@ -71896,23 +72099,13 @@ const ReorderSectionsPlugin = () => {
 * Static class for post-processing CHANGELOG.md files.
 *
 * Implements the third layer of the three-layer pipeline by running
-* six remark transform plugins in a fixed order to clean up, normalize,
-* and enhance changelog output produced by the formatter layer.
+* the {@link SilkChangesetTransformPreset} plugins (currently seven) in a
+* fixed order to clean up, normalize, and enhance changelog output produced
+* by the formatter layer.
 *
 * @remarks
-* The six plugins run in this order:
-*
-* 1. **MergeSectionsPlugin** -- merges duplicate section headings (e.g., two
-*    "Features" sections from separate changesets are combined into one)
-* 2. **ReorderSectionsPlugin** -- reorders sections by category priority
-*    (Breaking Changes first, Other last) using the {@link Categories} priority values
-* 3. **DeduplicateItemsPlugin** -- removes duplicate list items within a section
-* 4. **ContributorFootnotesPlugin** -- converts inline contributor mentions
-*    into footnote references for cleaner formatting
-* 5. **IssueLinkRefsPlugin** -- converts inline issue/PR links into markdown
-*    reference-style links collected at the bottom of the document
-* 6. **NormalizeFormatPlugin** -- applies consistent formatting (spacing,
-*    trailing newlines, heading levels)
+* See {@link SilkChangesetTransformPreset} for the ordered plugin list and
+* the rationale behind each plugin's position.
 *
 * The transformer operates on the full CHANGELOG.md content (all versions),
 * not just the latest release block. It is idempotent -- running it multiple
@@ -71972,20 +72165,27 @@ var ChangelogTransformer = class ChangelogTransformer {
 	/* v8 ignore next -- private constructor prevents direct instantiation */
 	constructor() {}
 	/**
-	* Transform CHANGELOG markdown content by running all six transform plugins.
+	* Transform CHANGELOG markdown content by running the
+	* {@link SilkChangesetTransformPreset} plugins.
 	*
 	* @remarks
 	* The input is parsed with `remark-parse` and `remark-gfm` (for table
-	* support), processed through all six plugins in order, and stringified
-	* back to markdown. The operation is synchronous and idempotent.
+	* support), processed through every plugin in {@link SilkChangesetTransformPreset}
+	* in order, and stringified back to markdown. The operation is synchronous
+	* and idempotent.
 	*
 	* @param content - Raw CHANGELOG markdown string (may contain multiple
 	*   version blocks, GFM tables, footnotes, and reference links)
-	* @returns The transformed markdown string with sections merged, reordered,
-	*   deduplicated, and normalized
-	*/
-	static transformContent(content) {
-		const file = unified().use(remarkParse).use(remarkGfm).use(MergeSectionsPlugin).use(ReorderSectionsPlugin).use(DeduplicateItemsPlugin).use(ContributorFootnotesPlugin).use(IssueLinkRefsPlugin).use(NormalizeFormatPlugin).use(remarkStringify).processSync(content);
+	* @param options - Optional transformation options, including maintenance note configuration
+	* @returns The transformed markdown string with dependency tables aggregated,
+	*   sections merged, reordered, deduplicated, and normalized
+	*/
+	static transformContent(content, options) {
+		const processor = unified().use(remarkParse).use(remarkGfm);
+		for (const plugin of SilkChangesetTransformPreset) processor.use(plugin);
+		if (options?.maintenance) processor.use(MaintenanceNotePlugin, options.maintenance);
+		processor.use(remarkStringify);
+		const file = processor.processSync(content);
 		return String(file);
 	}
 	/**
@@ -72001,10 +72201,11 @@ var ChangelogTransformer = class ChangelogTransformer {
 	* when invoked without the `--dry-run` or `--check` flags.
 	*
 	* @param filePath - Absolute or relative path to the CHANGELOG.md file
+	* @param options - Optional transformation options, including maintenance note configuration
 	*/
-	static transformFile(filePath) {
+	static transformFile(filePath, options) {
 		const content = (0, node_fs.readFileSync)(filePath, "utf-8");
-		(0, node_fs.writeFileSync)(filePath, ChangelogTransformer.transformContent(content), "utf-8");
+		(0, node_fs.writeFileSync)(filePath, ChangelogTransformer.transformContent(content, options), "utf-8");
 	}
 };
 //#endregion
@@ -76018,6 +76219,67 @@ const ConfigGraph = ChangesetConfigLive.pipe(effect.Layer.provide(ChangesetConfi
 */
 const DepsRegenDefault = DepsRegenLive.pipe(effect.Layer.provide(PointInTimeWorkspaceLive.pipe(effect.Layer.provide(WorkspaceGraph))), effect.Layer.provide(ConfigInspectorLive.pipe(effect.Layer.provide(effect.Layer.mergeAll(ChangesetConfigReaderLive, WorkspaceGraph)))), effect.Layer.provide(PublishabilityDetectorAdaptiveLive.pipe(effect.Layer.provide(ConfigGraph))), effect.Layer.provide(ConfigGraph), effect.Layer.provide(WorkspaceGraph));
 //#endregion
+//#region ../silk-effects/dist/dev/pkg/changesets/services/maintenance-reason.js
+/**
+* A group co-member whose own changesets forced this release.
+*
+* @public
+*/
+const MaintenanceTriggerSchema = effect.Schema.Struct({
+	/** Package name of the triggering co-member. */
+	name: effect.Schema.String,
+	/** The co-member's new version in the same release plan. */
+	version: effect.Schema.String
+});
+/**
+* Why a package is releasing with no changesets of its own.
+*
+* @public
+*/
+const MaintenanceReasonSchema = effect.Schema.Struct({
+	/** Coupling that forced the release; `"unspecified"` when undetermined. */
+	kind: effect.Schema.Literal("fixed", "linked", "unspecified"),
+	/** Triggering co-members; empty for `"unspecified"`. */
+	triggers: effect.Schema.Array(MaintenanceTriggerSchema)
+});
+/**
+* Derive the {@link MaintenanceReason} for a release, or `undefined` when the
+* release has its own changesets (not a maintenance release).
+*
+* @param release - The release to classify.
+* @param plan - The full release plan (source of group co-members).
+* @param config - Resolved changesets config (`fixed` / `linked` groups).
+* @returns The reason, or `undefined` for releases with their own changesets.
+*
+* @remarks
+* Group entries are matched with {@link ChangesetConfig.matches} — exact names
+* and trailing `"@scope/*"` prefixes only, a subset of the micromatch globs
+* changesets accepts. A group entry using richer glob syntax (e.g. `"pkg-*"`)
+* will not match here; the release then degrades gracefully to the
+* `"unspecified"` fallback sentence instead of naming its triggers.
+*
+* @public
+*/
+function deriveMaintenanceReason(release, plan, config) {
+	if (release.changesets.length > 0) return void 0;
+	const groupKinds = [["fixed", config.fixed], ["linked", config.linked]];
+	for (const [kind, groups] of groupKinds) for (const group of groups) {
+		if (!group.some((pattern) => ChangesetConfig.matches(release.name, pattern))) continue;
+		const triggers = plan.releases.filter((r) => r.name !== release.name && r.changesets.length > 0 && group.some((pattern) => ChangesetConfig.matches(r.name, pattern))).map((r) => ({
+			name: r.name,
+			version: r.newVersion
+		}));
+		if (triggers.length > 0) return {
+			kind,
+			triggers
+		};
+	}
+	return {
+		kind: "unspecified",
+		triggers: []
+	};
+}
+//#endregion
 //#region ../silk-effects/dist/dev/pkg/changesets/utils/jsonpath.js
 /**
 * Tokenize a JSONPath string into segments.
@@ -109556,6 +109818,16 @@ function extractVersionBlock(changelog, version) {
 	}
 	return lines.slice(start, end).join("\n").trim();
 }
+/** Maintenance reasons for every changeset-less release in the plan, keyed by package name. */
+function maintenanceReasons(plan, config) {
+	const reasons = /* @__PURE__ */ new Map();
+	for (const r of plan.releases) {
+		if (r.type === "none") continue;
+		const reason = deriveMaintenanceReason(r, plan, config);
+		if (reason) reasons.set(r.name, reason);
+	}
+	return reasons;
+}
 /**
 * Render a non-destructive preview by redirecting every write into a
 * scope-managed temp directory (cleaned up automatically when the scope
@@ -109577,6 +109849,7 @@ function previewEffect(root, fs) {
 				reason: errMsg(e)
 			})
 		});
+		const reasonByName = maintenanceReasons(plan, config);
 		const preMode = plan.preState ? plan.preState.mode : null;
 		const changesets = plan.changesets.map((cs) => ({
 			id: cs.id,
@@ -109645,8 +109918,12 @@ function previewEffect(root, fs) {
 			if (!dir) continue;
 			const clPath = (0, node_path$1.join)(dir, "CHANGELOG.md");
 			if (!(yield* fs.exists(clPath))) continue;
+			const reason = reasonByName.get(r.name);
 			yield* effect.Effect.try({
-				try: () => ChangelogTransformer.transformFile(clPath),
+				try: () => ChangelogTransformer.transformFile(clPath, reason ? { maintenance: {
+					version: r.newVersion,
+					reason
+				} } : void 0),
 				catch: (e) => new ReleasePlanError({
 					phase: "preview",
 					reason: errMsg(e)
@@ -109700,17 +109977,33 @@ function applyEffect(root, dryRun, inspector, fs) {
 			newVersion: r.newVersion
 		}));
 		let touchedFiles = [];
-		if (!dryRun) touchedFiles = yield* effect.Effect.tryPromise({
-			try: async () => {
-				const touched = await applyReleasePlan(plan, packages, config);
-				for (const f of touched) if (f.endsWith("CHANGELOG.md")) ChangelogTransformer.transformFile(f);
-				return touched;
-			},
-			catch: (e) => new ReleasePlanError({
-				phase: "apply",
-				reason: errMsg(e)
-			})
-		});
+		if (!dryRun) {
+			const reasonByName = maintenanceReasons(plan, config);
+			const versionByPkgName = new Map(plan.releases.map((r) => [r.name, r.newVersion]));
+			const nameByDir = /* @__PURE__ */ new Map();
+			for (const p of packages.packages) nameByDir.set(p.dir, p.packageJson.name);
+			if (packages.root.packageJson.name) nameByDir.set(packages.root.dir, packages.root.packageJson.name);
+			touchedFiles = yield* effect.Effect.tryPromise({
+				try: async () => {
+					const touched = await applyReleasePlan(plan, packages, config);
+					for (const f of touched) {
+						if (!f.endsWith("CHANGELOG.md")) continue;
+						const pkgName = nameByDir.get((0, node_path$1.dirname)(f));
+						const reason = pkgName ? reasonByName.get(pkgName) : void 0;
+						const newVersion = pkgName ? versionByPkgName.get(pkgName) : void 0;
+						ChangelogTransformer.transformFile(f, reason && newVersion ? { maintenance: {
+							version: newVersion,
+							reason
+						} } : void 0);
+					}
+					return touched;
+				},
+				catch: (e) => new ReleasePlanError({
+					phase: "apply",
+					reason: errMsg(e)
+				})
+			});
+		}
 		const newVersionByName = new Map(plan.releases.map((r) => [r.name, r.newVersion]));
 		const inspected = yield* inspector.inspect(root).pipe(effect.Effect.catchAll((error) => effect.Effect.logWarning(`Skipping versionFiles update: ${errMsg(error)}`).pipe(effect.Effect.as(null))));
 		let versionFileUpdates = [];
@@ -110514,152 +110807,6 @@ const SilkChangesetsRules = [
 	DependencyTableFormatRule
 ];
 //#endregion
-//#region ../silk-effects/dist/dev/pkg/changesets/remark/plugins/aggregate-dependency-tables.js
-const AggregateDependencyTablesPlugin = () => {
-	return (tree) => {
-		const blocks = getVersionBlocks(tree);
-		for (let b = blocks.length - 1; b >= 0; b--) {
-			const depSections = getBlockSections(tree, blocks[b]).filter((s) => getHeadingText$1(s.heading).toLowerCase() === "dependencies");
-			if (depSections.length === 0) continue;
-			const allRows = [];
-			const legacyContent = [];
-			for (const section of depSections) for (const node of section.contentNodes) if (node.type === "table") try {
-				const rows = parseDependencyTable(node);
-				allRows.push(...rows);
-			} catch {
-				legacyContent.push(node);
-			}
-			else legacyContent.push(node);
-			const collapsed = sortDependencyRows(collapseDependencyRows(allRows));
-			const indicesToRemove = [];
-			for (const section of depSections) {
-				indicesToRemove.push(section.headingIndex);
-				for (let c = 0; c < section.contentNodes.length; c++) indicesToRemove.push(section.headingIndex + 1 + c);
-			}
-			indicesToRemove.sort((a, b) => b - a);
-			for (const idx of indicesToRemove) tree.children.splice(idx, 1);
-			if (collapsed.length === 0 && legacyContent.length === 0) continue;
-			const insertAt = depSections[0].headingIndex;
-			const newNodes = [];
-			newNodes.push({
-				type: "heading",
-				depth: 3,
-				children: [{
-					type: "text",
-					value: "Dependencies"
-				}]
-			});
-			if (collapsed.length > 0) newNodes.push(serializeDependencyTable(collapsed));
-			newNodes.push(...legacyContent);
-			tree.children.splice(insertAt, 0, ...newNodes);
-		}
-	};
-};
-//#endregion
-//#region ../silk-effects/dist/dev/pkg/changesets/remark/presets.js
-/**
-* Remark preset collections for changeset lint rules and transform plugins.
-*
-* @remarks
-* Presets bundle related remark plugins into ordered arrays for convenient
-* consumption. Each preset is a `readonly` tuple so that TypeScript can
-* narrow element types. Iterate and `.use()` each entry with `unified()`.
-*
-* @see {@link SilkChangesetPreset} for lint rules
-* @see {@link SilkChangesetTransformPreset} for transform plugins
-*/
-/**
-* Preset combining all changeset lint rules for convenient consumption.
-*
-* @remarks
-* Includes the following rules in order:
-*
-* 1. {@link HeadingHierarchyRule} (CSH001) -- no h1, no depth skips
-* 2. {@link RequiredSectionsRule} (CSH002) -- h2 headings must match a known category
-* 3. {@link ContentStructureRule} (CSH003) -- non-empty sections, code fence languages, non-empty list items
-* 4. {@link UncategorizedContentRule} (CSH004) -- no content before the first h2 heading
-* 5. {@link DependencyTableFormatRule} (CSH005) -- dependency table column/value validation
-*
-* Rule execution order is not significant for lint rules; all rules run
-* independently over the same AST and report warnings to the virtual file.
-*
-* @example
-* ```typescript
-* import { SilkChangesetPreset } from "\@savvy-web/changesets/remark";
-* import remarkParse from "remark-parse";
-* import { unified } from "unified";
-* import { read } from "to-vfile";
-*
-* const processor = unified().use(remarkParse);
-* for (const rule of SilkChangesetPreset) {
-*   processor.use(rule);
-* }
-*
-* const file = await read("changeset.md");
-* const result = await processor.process(file);
-* console.log(result.messages); // lint warnings
-* ```
-*
-* @see {@link SilkChangesetTransformPreset} for the corresponding transform preset
-*
-* @public
-*/
-const SilkChangesetPreset = [
-	HeadingHierarchyRule$1,
-	RequiredSectionsRule$1,
-	ContentStructureRule$1,
-	UncategorizedContentRule$1,
-	DependencyTableFormatRule$1
-];
-/**
-* Ordered array of all transform plugins in the correct execution order.
-*
-* @remarks
-* Plugin ordering is significant -- each plugin may depend on the output of
-* earlier plugins in the pipeline:
-*
-* 1. {@link AggregateDependencyTablesPlugin} -- merge duplicate dependency sections (must run first so downstream plugins see a single Dependencies section)
-* 2. {@link MergeSectionsPlugin} -- merge duplicate h3 headings (must run before reorder so that priority is computed on consolidated sections)
-* 3. {@link ReorderSectionsPlugin} -- sort sections by category priority (Breaking Changes first, Other last)
-* 4. {@link DeduplicateItemsPlugin} -- remove duplicate list items within each section
-* 5. {@link ContributorFootnotesPlugin} -- extract inline `Thanks \@user!` attributions and aggregate them into a summary paragraph per version block
-* 6. {@link IssueLinkRefsPlugin} -- convert inline `[#N](url)` links to reference-style `[#N]` with definitions at the end of each version block
-* 7. {@link NormalizeFormatPlugin} -- final cleanup removing empty sections and empty lists
-*
-* @example
-* ```typescript
-* import { SilkChangesetTransformPreset } from "\@savvy-web/changesets/remark";
-* import remarkGfm from "remark-gfm";
-* import remarkParse from "remark-parse";
-* import remarkStringify from "remark-stringify";
-* import { unified } from "unified";
-* import { read } from "to-vfile";
-*
-* const processor = unified().use(remarkParse).use(remarkGfm);
-* for (const plugin of SilkChangesetTransformPreset) {
-*   processor.use(plugin);
-* }
-* processor.use(remarkStringify);
-*
-* const file = await read("CHANGELOG.md");
-* const result = await processor.process(file);
-* console.log(String(result));
-* ```
-*
-* @see {@link SilkChangesetPreset} for the corresponding lint preset
-*
-* @public
-*/
-const SilkChangesetTransformPreset = [
-	AggregateDependencyTablesPlugin,
-	MergeSectionsPlugin,
-	ReorderSectionsPlugin,
-	DeduplicateItemsPlugin,
-	ContributorFootnotesPlugin,
-	IssueLinkRefsPlugin,
-	NormalizeFormatPlugin
-];
-//#endregion
 //#region src/changesets/changelog.ts
 /**
 * Changesets API changelog formatter shim for \@savvy-web/silk.
@@ -110734,6 +110881,9 @@ const changelogFunctions = (/* @__PURE__ */ __exportAll({
 	JsonPathSchema: () => JsonPathSchema,
 	LegacyVersionFileConfigSchema: () => LegacyVersionFileConfigSchema,
 	LegacyVersionFilesSchema: () => LegacyVersionFilesSchema,
+	MaintenanceNotePlugin: () => MaintenanceNotePlugin,
+	MaintenanceReasonSchema: () => MaintenanceReasonSchema,
+	MaintenanceTriggerSchema: () => MaintenanceTriggerSchema,
 	MarkdownLive: () => MarkdownLive,
 	MarkdownParseError: () => MarkdownParseError,
 	MarkdownParseErrorBase: () => MarkdownParseErrorBase,
@@ -110780,6 +110930,7 @@ const changelogFunctions = (/* @__PURE__ */ __exportAll({
 	VersionTypeSchema: () => VersionTypeSchema,
 	changelogFunctions: () => changelogFunctions$1,
 	computeWorkspaceDependencyDiffs: () => computeWorkspaceDependencyDiffs,
+	deriveMaintenanceReason: () => deriveMaintenanceReason,
 	gitMergeBase: () => gitMergeBase,
 	isPureDependencyChangeset: () => isPureDependencyChangeset,
 	listPublishablePackageNames: () => listPublishablePackageNames,