@savvy-web/silk-effects 2.0.2 → 3.0.0

package/changesets/api/changelog.js

@@ -106,7 +106,7 @@ var Changelog = class {
 	*   Pass `null` to use defaults (no GitHub link resolution).
 	* @returns A promise resolving to the formatted markdown string
 	*/
-	static formatReleaseLine(changeset, versionType, options) {
+	static async formatReleaseLine(changeset, versionType, options) {
 		return changelogFunctions.getReleaseLine(changeset, versionType, options);
 	}
 	/**
@@ -125,7 +125,7 @@ var Changelog = class {
 	* @returns A promise resolving to the formatted markdown string containing
 	*   the dependency update table
 	*/
-	static formatDependencyReleaseLine(changesets, dependenciesUpdated, options) {
+	static async formatDependencyReleaseLine(changesets, dependenciesUpdated, options) {
 		return changelogFunctions.getDependencyReleaseLine(changesets, dependenciesUpdated, options);
 	}
 };

package/changesets/api/transformer.js

@@ -1,9 +1,5 @@
-import { ContributorFootnotesPlugin } from "../remark/plugins/contributor-footnotes.js";
-import { DeduplicateItemsPlugin } from "../remark/plugins/deduplicate-items.js";
-import { IssueLinkRefsPlugin } from "../remark/plugins/issue-link-refs.js";
-import { MergeSectionsPlugin } from "../remark/plugins/merge-sections.js";
-import { NormalizeFormatPlugin } from "../remark/plugins/normalize-format.js";
-import { ReorderSectionsPlugin } from "../remark/plugins/reorder-sections.js";
+import { MaintenanceNotePlugin } from "../remark/plugins/maintenance-note.js";
+import { SilkChangesetTransformPreset } from "../remark/presets.js";
 import remarkGfm from "remark-gfm";
 import remarkParse from "remark-parse";
 import remarkStringify from "remark-stringify";
@@ -24,23 +20,13 @@ import { readFileSync, writeFileSync } from "node:fs";
 * 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
@@ -100,20 +86,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
+	* @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) {
-		const file = unified().use(remarkParse).use(remarkGfm).use(MergeSectionsPlugin).use(ReorderSectionsPlugin).use(DeduplicateItemsPlugin).use(ContributorFootnotesPlugin).use(IssueLinkRefsPlugin).use(NormalizeFormatPlugin).use(remarkStringify).processSync(content);
+	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);
 	}
 	/**
@@ -129,10 +122,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 = readFileSync(filePath, "utf-8");
-		writeFileSync(filePath, ChangelogTransformer.transformContent(content), "utf-8");
+		writeFileSync(filePath, ChangelogTransformer.transformContent(content, options), "utf-8");
 	}
 };
 

package/changesets/changelog/formatting.js

@@ -26,8 +26,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
@@ -37,13 +37,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 `- `)
 *
@@ -51,10 +49,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) {

package/changesets/changelog/getDependencyReleaseLine.js

@@ -15,11 +15,14 @@ import { Effect } from "effect";
 * 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
 *
@@ -85,7 +88,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
@@ -94,19 +98,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.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
-		})));
+		})))}`;
 	});
 }
 

package/changesets/changelog/getReleaseLine.js

@@ -21,7 +21,7 @@ import { Effect, Schema } from "effect";
 *
 * 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
@@ -31,7 +31,6 @@ import { Effect, Schema } from "effect";
 *
 * 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
 *
@@ -62,7 +61,7 @@ import { Effect, Schema } from "effect";
 *    `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.
 *
@@ -96,14 +95,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("");
 			}
@@ -112,8 +113,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}`;
 	});
 }

package/changesets/changelog/index.js

@@ -40,7 +40,7 @@ import { Effect, Layer } from "effect";
 *    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.
 *

package/changesets/index.js

@@ -19,12 +19,15 @@ import { HeadingHierarchyRule } from "./remark/rules/heading-hierarchy.js";
 import { RequiredSectionsRule } from "./remark/rules/required-sections.js";
 import { UncategorizedContentRule } from "./remark/rules/uncategorized-content.js";
 import { ChangesetLinter } from "./api/linter.js";
+import { MaintenanceNotePlugin } from "./remark/plugins/maintenance-note.js";
+import { AggregateDependencyTablesPlugin } from "./remark/plugins/aggregate-dependency-tables.js";
 import { ContributorFootnotesPlugin } from "./remark/plugins/contributor-footnotes.js";
 import { DeduplicateItemsPlugin } from "./remark/plugins/deduplicate-items.js";
 import { IssueLinkRefsPlugin } from "./remark/plugins/issue-link-refs.js";
 import { MergeSectionsPlugin } from "./remark/plugins/merge-sections.js";
 import { NormalizeFormatPlugin } from "./remark/plugins/normalize-format.js";
 import { ReorderSectionsPlugin } from "./remark/plugins/reorder-sections.js";
+import { SilkChangesetPreset, SilkChangesetTransformPreset } from "./remark/presets.js";
 import { ChangelogTransformer } from "./api/transformer.js";
 import { ClassificationReasonSchema, ClassificationSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, InspectedConfigSchema, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, makeConfigInspectorTest } from "./services/config-inspector.js";
 import { BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchFileEntrySchema, FileStatusSchema, makeBranchAnalyzerTest } from "./services/branch-analyzer.js";
@@ -33,6 +36,7 @@ import { computeWorkspaceDependencyDiffs } from "./utils/dep-diff.js";
 import { gitMergeBase } from "./utils/git.js";
 import { listPublishablePackageNames } from "./utils/publishability.js";
 import { DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, isPureDependencyChangeset } from "./services/deps-regen.js";
+import { MaintenanceReasonSchema, MaintenanceTriggerSchema, deriveMaintenanceReason } from "./services/maintenance-reason.js";
 import { VersionFiles } from "./utils/version-files.js";
 import { ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, makeReleasePlannerTest } from "./services/release-planner.js";
 import { SectionCategorySchema } from "./categories/types.js";
@@ -45,8 +49,6 @@ import { HeadingHierarchyRule as HeadingHierarchyRule$1 } from "./markdownlint/r
 import { RequiredSectionsRule as RequiredSectionsRule$1 } from "./markdownlint/rules/required-sections.js";
 import { UncategorizedContentRule as UncategorizedContentRule$1 } from "./markdownlint/rules/uncategorized-content.js";
 import SilkChangesetsRules from "./markdownlint/index.js";
-import { AggregateDependencyTablesPlugin } from "./remark/plugins/aggregate-dependency-tables.js";
-import { SilkChangesetPreset, SilkChangesetTransformPreset } from "./remark/presets.js";
 
 //#region src/changesets/index.ts
 var changesets_exports = /* @__PURE__ */ __exportAll({
@@ -113,6 +115,9 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	JsonPathSchema: () => JsonPathSchema,
 	LegacyVersionFileConfigSchema: () => LegacyVersionFileConfigSchema,
 	LegacyVersionFilesSchema: () => LegacyVersionFilesSchema,
+	MaintenanceNotePlugin: () => MaintenanceNotePlugin,
+	MaintenanceReasonSchema: () => MaintenanceReasonSchema,
+	MaintenanceTriggerSchema: () => MaintenanceTriggerSchema,
 	MarkdownLive: () => MarkdownLive,
 	MarkdownParseError: () => MarkdownParseError,
 	MarkdownParseErrorBase: () => MarkdownParseErrorBase,
@@ -159,6 +164,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	VersionTypeSchema: () => VersionTypeSchema,
 	changelogFunctions: () => changelogFunctions,
 	computeWorkspaceDependencyDiffs: () => computeWorkspaceDependencyDiffs,
+	deriveMaintenanceReason: () => deriveMaintenanceReason,
 	gitMergeBase: () => gitMergeBase,
 	isPureDependencyChangeset: () => isPureDependencyChangeset,
 	listPublishablePackageNames: () => listPublishablePackageNames,
@@ -170,4 +176,4 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 });
 
 //#endregion
-export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogTransformer, ChangesetIOError, ChangesetIOErrorBase, ChangesetLinter, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GlobSchema, HeadingHierarchyRule, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScopeSchema, PackagesRecordSchema, PendingChangesetSchema, PositiveInteger, PreviewReleaseSchema, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };
+export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogTransformer, ChangesetIOError, ChangesetIOErrorBase, ChangesetLinter, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GlobSchema, HeadingHierarchyRule, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MaintenanceNotePlugin, MaintenanceReasonSchema, MaintenanceTriggerSchema, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScopeSchema, PackagesRecordSchema, PendingChangesetSchema, PositiveInteger, PreviewReleaseSchema, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };

package/changesets/remark/plugins/deduplicate-items.js

@@ -7,16 +7,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) => {

package/changesets/remark/plugins/maintenance-note.js

@@ -0,0 +1,61 @@
+import { getHeadingText, getVersionBlocks } from "../../utils/version-blocks.js";
+
+//#region src/changesets/remark/plugins/maintenance-note.ts
+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(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
+export { MaintenanceNotePlugin };

package/changesets/remark/presets.js

@@ -3,13 +3,13 @@ import { DependencyTableFormatRule } from "./rules/dependency-table-format.js";
 import { HeadingHierarchyRule } from "./rules/heading-hierarchy.js";
 import { RequiredSectionsRule } from "./rules/required-sections.js";
 import { UncategorizedContentRule } from "./rules/uncategorized-content.js";
+import { AggregateDependencyTablesPlugin } from "./plugins/aggregate-dependency-tables.js";
 import { ContributorFootnotesPlugin } from "./plugins/contributor-footnotes.js";
 import { DeduplicateItemsPlugin } from "./plugins/deduplicate-items.js";
 import { IssueLinkRefsPlugin } from "./plugins/issue-link-refs.js";
 import { MergeSectionsPlugin } from "./plugins/merge-sections.js";
 import { NormalizeFormatPlugin } from "./plugins/normalize-format.js";
 import { ReorderSectionsPlugin } from "./plugins/reorder-sections.js";
-import { AggregateDependencyTablesPlugin } from "./plugins/aggregate-dependency-tables.js";
 
 //#region src/changesets/remark/presets.ts
 /**

package/changesets/services/maintenance-reason.js

@@ -0,0 +1,66 @@
+import { ChangesetConfig } from "../../services/ChangesetConfig.js";
+import { Schema } from "effect";
+
+//#region src/changesets/services/maintenance-reason.ts
+/**
+* A group co-member whose own changesets forced this release.
+*
+* @public
+*/
+const MaintenanceTriggerSchema = Schema.Struct({
+	/** Package name of the triggering co-member. */
+	name: Schema.String,
+	/** The co-member's new version in the same release plan. */
+	version: Schema.String
+});
+/**
+* Why a package is releasing with no changesets of its own.
+*
+* @public
+*/
+const MaintenanceReasonSchema = Schema.Struct({
+	/** Coupling that forced the release; `"unspecified"` when undetermined. */
+	kind: Schema.Literal("fixed", "linked", "unspecified"),
+	/** Triggering co-members; empty for `"unspecified"`. */
+	triggers: 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
+export { MaintenanceReasonSchema, MaintenanceTriggerSchema, deriveMaintenanceReason };

package/changesets/services/release-planner.js

@@ -1,13 +1,14 @@
 import { ReleasePlanError } from "../errors.js";
 import { ChangelogTransformer } from "../api/transformer.js";
 import { ConfigInspector } from "./config-inspector.js";
+import { deriveMaintenanceReason } from "./maintenance-reason.js";
 import { VersionFiles } from "../utils/version-files.js";
 import { Context, Effect, Layer } from "effect";
-import { isAbsolute, join, relative } from "node:path";
+import { dirname, isAbsolute, join, relative } from "node:path";
 import { FileSystem } from "@effect/platform";
-import applyReleasePlan from "@changesets/apply-release-plan";
-import { read } from "@changesets/config";
-import getReleasePlan from "@changesets/get-release-plan";
+import { applyReleasePlan } from "@changesets/apply-release-plan";
+import { readConfig } from "@changesets/config";
+import { getReleasePlan } from "@changesets/get-release-plan";
 import { getPackages } from "@manypkg/get-packages";
 
 //#region src/changesets/services/release-planner.ts
@@ -23,37 +24,21 @@ import { getPackages } from "@manypkg/get-packages";
 * (e.g. `getChangelogEntry`) is re-implemented.
 *
 */
-const V1_TOOLS = /* @__PURE__ */ new Set([
-	"yarn",
-	"bolt",
-	"pnpm",
-	"lerna",
-	"root"
-]);
+const errMsg = (e) => e instanceof Error ? e.message : String(e);
 /**
-* Single workspace-discovery seam; swap to an Effect-native stack later here.
-*
-* Discovers with `@manypkg/get-packages@3.x` and adapts to the v1 shape:
-* `tool` collapses to its type string (tools unknown to v1 map to `"root"` —
-* the engine never reads `tool` at runtime, only `root.dir`), and
-* `rootDir`/`rootPackage` fold back into `root`.
+* Read the changesets config, surfacing non-throwing `readConfig` errors as a
+* thrown `Error` so callers inside `Effect.tryPromise` land on the existing
+* `ReleasePlanError` mapping. Warnings are returned alongside the config so
+* the caller can log them via the Effect runtime rather than console output.
 */
-const buildPackages = async (root) => {
-	const { tool, rootDir, rootPackage, packages } = await getPackages(root);
-	if (!rootPackage) throw new Error(`Workspace root has no package.json: ${rootDir}`);
+async function loadConfig(root, packages) {
+	const configResult = await readConfig(root, packages);
+	if (configResult.config === void 0) throw new Error(`Invalid changeset config:\n${configResult.errors.join("\n")}`);
 	return {
-		tool: V1_TOOLS.has(tool.type) ? tool.type : "root",
-		root: {
-			dir: rootPackage.dir,
-			packageJson: rootPackage.packageJson
-		},
-		packages: packages.map((p) => ({
-			dir: p.dir,
-			packageJson: p.packageJson
-		}))
+		config: configResult.config,
+		warnings: configResult.warnings
 	};
-};
-const errMsg = (e) => e instanceof Error ? e.message : String(e);
+}
 const _tag = Context.Tag("ReleasePlanner");
 /**
 * Base class for {@link ReleasePlanner}.
@@ -74,7 +59,7 @@ function makeShape(inspector, fs) {
 		})
 	});
 	const preview = (root) => previewEffect(root, fs);
-	const apply = (root, options) => applyEffect(root, options?.dryRun ?? false, inspector, fs);
+	const apply = (root, options) => applyEffect(root, options?.dryRun ?? false, options?.changelogModules, inspector, fs);
 	return {
 		plan,
 		preview,
@@ -114,6 +99,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
@@ -122,19 +117,26 @@ function extractVersionBlock(changelog, version) {
 function previewEffect(root, fs) {
 	const program = Effect.gen(function* () {
 		const [plan, packages] = yield* Effect.tryPromise({
-			try: () => Promise.all([getReleasePlan(root), buildPackages(root)]),
+			try: () => Promise.all([getReleasePlan(root), getPackages(root)]),
 			catch: (e) => new ReleasePlanError({
 				phase: "preview",
 				reason: errMsg(e)
 			})
 		});
-		const config = yield* Effect.tryPromise({
-			try: () => read(root, packages),
+		if (!packages.rootPackage) return yield* Effect.fail(new ReleasePlanError({
+			phase: "preview",
+			reason: `Workspace root has no package.json: ${root}`
+		}));
+		const rootPackage = packages.rootPackage;
+		const { config, warnings } = yield* Effect.tryPromise({
+			try: () => loadConfig(root, packages),
 			catch: (e) => new ReleasePlanError({
 				phase: "preview",
 				reason: errMsg(e)
 			})
 		});
+		yield* Effect.forEach(warnings, (w) => Effect.logWarning(w));
+		const reasonByName = maintenanceReasons(plan, config);
 		const preMode = plan.preState ? plan.preState.mode : null;
 		const changesets = plan.changesets.map((cs) => ({
 			id: cs.id,
@@ -152,7 +154,7 @@ function previewEffect(root, fs) {
 		};
 		const tempRoot = yield* fs.makeTempDirectoryScoped({ prefix: "silk-preview-" });
 		const mapDir = (dir) => {
-			const rel = relative(packages.root.dir, dir);
+			const rel = relative(packages.rootDir, dir);
 			if (rel.startsWith("..") || isAbsolute(rel)) return Effect.fail(new ReleasePlanError({
 				phase: "preview",
 				reason: `Package directory is outside the workspace root: ${dir}`
@@ -162,13 +164,12 @@ function previewEffect(root, fs) {
 		const tempDirs = yield* Effect.forEach(packages.packages, (p) => mapDir(p.dir));
 		const tempPackages = {
 			tool: packages.tool,
-			root: {
-				...packages.root,
+			rootDir: tempRoot,
+			rootPackage: {
 				dir: tempRoot,
-				packageJson: structuredClone(packages.root.packageJson)
+				packageJson: structuredClone(rootPackage.packageJson)
 			},
 			packages: packages.packages.map((p, i) => ({
-				...p,
 				dir: tempDirs[i],
 				packageJson: structuredClone(p.packageJson)
 			}))
@@ -185,7 +186,7 @@ function previewEffect(root, fs) {
 			const realCl = join(p.dir, "CHANGELOG.md");
 			if (yield* fs.exists(realCl)) yield* fs.copyFile(realCl, join(tDir, "CHANGELOG.md"));
 		}
-		const rootCl = join(packages.root.dir, "CHANGELOG.md");
+		const rootCl = join(packages.rootDir, "CHANGELOG.md");
 		if (yield* fs.exists(rootCl)) yield* fs.copyFile(rootCl, join(tempRoot, "CHANGELOG.md"));
 		yield* Effect.tryPromise({
 			try: () => applyReleasePlan(plan, tempPackages, config, void 0, root),
@@ -196,15 +197,19 @@ function previewEffect(root, fs) {
 		});
 		const dirByName = /* @__PURE__ */ new Map();
 		for (const p of tempPackages.packages) dirByName.set(p.packageJson.name, p.dir);
-		if (tempPackages.root.packageJson.name) dirByName.set(tempPackages.root.packageJson.name, tempRoot);
+		if (tempPackages.rootPackage?.packageJson.name) dirByName.set(tempPackages.rootPackage.packageJson.name, tempRoot);
 		const releases = [];
 		for (const r of releasesToRender) {
 			const dir = dirByName.get(r.name);
 			if (!dir) continue;
 			const clPath = join(dir, "CHANGELOG.md");
 			if (!(yield* fs.exists(clPath))) continue;
+			const reason = reasonByName.get(r.name);
 			yield* 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)
@@ -235,15 +240,17 @@ function previewEffect(root, fs) {
 function diskVersion(workspaceDir, fallback, fs) {
 	return fs.readFileString(join(workspaceDir, "package.json")).pipe(Effect.flatMap((raw) => Effect.try(() => JSON.parse(raw).version ?? fallback)), Effect.orElseSucceed(() => fallback));
 }
-function applyEffect(root, dryRun, inspector, fs) {
+function applyEffect(root, dryRun, changelogModules, inspector, fs) {
 	return Effect.gen(function* () {
-		const { plan, packages, config } = yield* Effect.tryPromise({
+		const { plan, packages, config, warnings } = yield* Effect.tryPromise({
 			try: async () => {
-				const [plan, packages] = await Promise.all([getReleasePlan(root), buildPackages(root)]);
+				const [plan, packages] = await Promise.all([getReleasePlan(root), getPackages(root)]);
+				const { config, warnings } = await loadConfig(root, packages);
 				return {
 					plan,
 					packages,
-					config: await read(root, packages)
+					config,
+					warnings
 				};
 			},
 			catch: (e) => new ReleasePlanError({
@@ -251,6 +258,29 @@ function applyEffect(root, dryRun, inspector, fs) {
 				reason: errMsg(e)
 			})
 		});
+		yield* Effect.forEach(warnings, (w) => Effect.logWarning(w));
+		let engineConfig = config;
+		if (changelogModules) {
+			engineConfig = {
+				...config,
+				format: false
+			};
+			if (Array.isArray(config.changelog)) {
+				const configuredId = config.changelog[0];
+				const mapped = changelogModules[configuredId];
+				if (mapped === void 0) {
+					const supported = Object.keys(changelogModules).join(", ");
+					return yield* Effect.fail(new ReleasePlanError({
+						phase: "apply",
+						reason: `changelog id "${configuredId}" is not in changelogModules (supported: ${supported})`
+					}));
+				}
+				engineConfig = {
+					...engineConfig,
+					changelog: [mapped, config.changelog[1]]
+				};
+			}
+		}
 		const releases = plan.releases.filter((r) => r.type !== "none").map((r) => ({
 			name: r.name,
 			type: r.type,
@@ -258,17 +288,33 @@ function applyEffect(root, dryRun, inspector, fs) {
 			newVersion: r.newVersion
 		}));
 		let touchedFiles = [];
-		if (!dryRun) touchedFiles = yield* 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.rootPackage?.packageJson.name) nameByDir.set(packages.rootDir, packages.rootPackage.packageJson.name);
+			touchedFiles = yield* Effect.tryPromise({
+				try: async () => {
+					const touched = await applyReleasePlan(plan, packages, engineConfig);
+					for (const f of touched) {
+						if (!f.endsWith("CHANGELOG.md")) continue;
+						const pkgName = nameByDir.get(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.catchAll((error) => Effect.logWarning(`Skipping versionFiles update: ${errMsg(error)}`).pipe(Effect.as(null))));
 		let versionFileUpdates = [];

package/changesets/vendor/github-info.js

@@ -1,6 +1,6 @@
 import { GitHubApiError } from "../errors.js";
 import { Effect } from "effect";
-import { getInfo } from "@changesets/get-github-info";
+import { getCommitInfo } from "@changesets/get-github-info";
 
 //#region src/changesets/vendor/github-info.ts
 /**
@@ -9,8 +9,14 @@ import { getInfo } from "@changesets/get-github-info";
 * @remarks
 * Bridges the `\@changesets/get-github-info` package (which returns
 * promises) into the Effect ecosystem. The {@link getGitHubInfo}
-* function wraps the upstream `getInfo()` call in `Effect.tryPromise`,
-* mapping failures to {@link GitHubApiError}.
+* function wraps the upstream `getCommitInfo()` call in `Effect.tryPromise`,
+* adapting its structured `CommitInfo | undefined` return back to the
+* legacy {@link GitHubCommitInfo} shape and mapping failures (including a
+* `not found` result) to {@link GitHubApiError}.
+*
+* The upstream v1 package added a `.env` fallback: it reads
+* `GITHUB_TOKEN` from `process.env` directly when no token is otherwise
+* configured, so the caller does not need to plumb one through.
 *
 * The {@link GitHubCommitInfo} type is the only item from this module
 * that is part of the public API (re-exported from the package root).
@@ -24,9 +30,13 @@ import { getInfo } from "@changesets/get-github-info";
 * Fetch GitHub info for a commit, wrapped in Effect.
 *
 * @remarks
-* Calls the upstream `getInfo()` from `\@changesets/get-github-info`
-* within `Effect.tryPromise`. Any thrown error is caught and mapped
-* to a {@link GitHubApiError} with the operation set to `"getInfo"`.
+* Calls the upstream `getCommitInfo()` from `\@changesets/get-github-info`
+* within `Effect.tryPromise`, adapting its structured `CommitInfo`
+* return to the legacy {@link GitHubCommitInfo} shape. An `undefined`
+* result (commit or repo not found) is treated as a thrown error so it
+* is mapped to the same {@link GitHubApiError} failure channel. Any
+* thrown error is caught and mapped to a {@link GitHubApiError} with
+* the operation set to `"getCommitInfo"`.
 *
 * Requires a `GITHUB_TOKEN` environment variable to be set for
 * authenticated API access (the upstream library reads it directly).
@@ -39,13 +49,25 @@ import { getInfo } from "@changesets/get-github-info";
 */
 function getGitHubInfo(params) {
 	return Effect.tryPromise({
-		try: () => getInfo({
-			commit: params.commit,
-			repo: params.repo
-		}),
+		try: async () => {
+			const info = await getCommitInfo({
+				commit: params.commit,
+				repo: params.repo
+			});
+			if (info === void 0) throw new Error(`commit ${params.commit} not found in ${params.repo}`);
+			return {
+				user: info.author?.login ?? null,
+				pull: info.pull?.number ?? null,
+				links: {
+					commit: info.commit.markdownLink,
+					pull: info.pull?.markdownLink ?? null,
+					user: info.author?.markdownLink ?? null
+				}
+			};
+		},
 		/* v8 ignore next 5 -- error mapping tested via GitHubService test layer */
 		catch: (error) => new GitHubApiError({
-			operation: "getInfo",
+			operation: "getCommitInfo",
 			reason: error instanceof Error ? error.message : String(error)
 		})
 	});

package/index.d.ts

@@ -1,7 +1,7 @@
 import { Context, Data, Effect, Equal, Hash, Layer, Option, Schema, Stream } from "effect";
+import { Plugin } from "unified";
 import { Command, CommandExecutor, FileSystem, Path } from "@effect/platform";
 import { PackageManagerDetector, PointInTimeReadError, PointInTimeWorkspace, PublishConfig, PublishTarget, PublishabilityDetector, TopologicalSorter, WorkspaceDiscovery, WorkspaceDiscoveryError, WorkspacePackage, WorkspaceRoot, WorkspaceStateSnapshot } from "workspaces-effect";
-import { Plugin } from "unified";
 import { PlatformError } from "@effect/platform/Error";
 
 //#region \0rolldown/runtime.js
@@ -284,7 +284,9 @@ declare class Categories {
   static isValidHeading(heading: string): boolean;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@changesets+types@6.1.0/node_modules/@changesets/types/dist/declarations/src/index.d.ts
+//#region ../../node_modules/.pnpm/@changesets+types@7.0.0-next.6/node_modules/@changesets/types/dist/index.d.mts
+//#region src/index.d.ts
+type MaybePromise<T> = T | Promise<T>;
 type VersionType$1 = "major" | "minor" | "patch" | "none";
 type AccessType = "public" | "restricted";
 type Release = {
@@ -333,8 +335,43 @@ type PackageJSON = {
     access?: AccessType;
     directory?: string;
     registry?: string;
+    [registry: `${string}:registry`]: string;
+  };
+};
+type PackageGroup = ReadonlyArray<string>;
+type Fixed = ReadonlyArray<PackageGroup>;
+type Linked = ReadonlyArray<PackageGroup>;
+interface PrivatePackages {
+  version: boolean;
+  tag: boolean;
+}
+type Config = {
+  changelog: false | readonly [string, null | Record<string, unknown>];
+  commit: false | readonly [string, null | Record<string, unknown>];
+  fixed: Fixed;
+  linked: Linked;
+  access: AccessType;
+  baseBranch: string;
+  changedFilePatterns: readonly string[];
+  /**
+   * The formatter to use to format changesets and changelogs. Set `false` to disable formatting.
+   * The default value of `"auto"` will auto-detect the formatter based on the project's configuration files.
+   */
+  format: "auto" | "prettier" | "oxfmt" | "deno" | "dprint" | false; /** Features enabled for Private packages */
+  privatePackages: PrivatePackages; /** The minimum bump type to trigger automatic update of internal dependencies that are part of the same release */
+  updateInternalDependencies: "patch" | "minor";
+  ignore: ReadonlyArray<string>; /** This is supposed to be used with pnpm's `link-workspace-packages: false` and Berry's `enableTransparentWorkspaces: false` */
+  bumpVersionsWithWorkspaceProtocolOnly?: boolean;
+  ___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH: Required<ExperimentalOptions>;
+  snapshot: {
+    useCalculatedVersion: boolean;
+    prereleaseTemplate: string | null;
   };
 };
+type ExperimentalOptions = {
+  onlyUpdatePeerDependentsWhenOutOfRange?: boolean;
+  updateInternalDependents?: "always" | "out-of-range";
+};
 type NewChangesetWithCommit = NewChangeset & {
   commit?: string;
 };
@@ -342,8 +379,8 @@ type ModCompWithPackage = ComprehensiveRelease & {
   packageJson: PackageJSON;
   dir: string;
 };
-type GetReleaseLine = (changeset: NewChangesetWithCommit, type: VersionType$1, changelogOpts: null | Record<string, any>) => Promise<string>;
-type GetDependencyReleaseLine = (changesets: NewChangesetWithCommit[], dependenciesUpdated: ModCompWithPackage[], changelogOpts: any) => Promise<string>;
+type GetReleaseLine = (changeset: NewChangesetWithCommit, type: VersionType$1, changelogOpts: null | Record<string, unknown>) => MaybePromise<string>;
+type GetDependencyReleaseLine = (changesets: NewChangesetWithCommit[], dependenciesUpdated: ModCompWithPackage[], changelogOpts: null | Record<string, unknown>) => MaybePromise<string>;
 type ChangelogFunctions = {
   getReleaseLine: GetReleaseLine;
   getDependencyReleaseLine: GetDependencyReleaseLine;
@@ -351,9 +388,6 @@ type ChangelogFunctions = {
 type PreState = {
   mode: "pre" | "exit";
   tag: string;
-  initialVersions: {
-    [pkgName: string]: string;
-  };
   changesets: string[];
 };
 //#endregion
@@ -2056,37 +2090,95 @@ declare class ChangesetLinter {
   static validate(dir: string): LintMessage[];
 }
 //#endregion
-//#region src/changesets/api/transformer.d.ts
+//#region src/changesets/services/maintenance-reason.d.ts
+/**
+ * A group co-member whose own changesets forced this release.
+ *
+ * @public
+ */
+declare const MaintenanceTriggerSchema: Schema.Struct<{
+  /** Package name of the triggering co-member. */name: typeof Schema.String; /** The co-member's new version in the same release plan. */
+  version: typeof Schema.String;
+}>;
 /**
- * Class-based API wrapper for changelog transformation.
+ * A group co-member whose own changesets forced this release.
  *
- * Provides a static class interface that runs all remark transform
- * plugins against CHANGELOG markdown content as the post-processing
- * layer of the three-layer pipeline.
+ * @public
+ */
+type MaintenanceTrigger = typeof MaintenanceTriggerSchema.Type;
+/**
+ * Why a package is releasing with no changesets of its own.
  *
- * @internal
+ * @public
  */
+declare const MaintenanceReasonSchema: Schema.Struct<{
+  /** Coupling that forced the release; `"unspecified"` when undetermined. */kind: Schema.Literal<["fixed", "linked", "unspecified"]>; /** Triggering co-members; empty for `"unspecified"`. */
+  triggers: Schema.Array$<Schema.Struct<{
+    /** Package name of the triggering co-member. */name: typeof Schema.String; /** The co-member's new version in the same release plan. */
+    version: typeof Schema.String;
+  }>>;
+}>;
+/**
+ * Why a package is releasing with no changesets of its own.
+ *
+ * @public
+ */
+type MaintenanceReason = typeof MaintenanceReasonSchema.Type;
+/**
+ * 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
+ */
+declare function deriveMaintenanceReason(release: ComprehensiveRelease, plan: ReleasePlan, config: Config): MaintenanceReason | undefined;
+//#endregion
+//#region src/changesets/remark/plugins/maintenance-note.d.ts
+/**
+ * Options for {@link MaintenanceNotePlugin}.
+ *
+ * @public
+ */
+interface MaintenanceNoteOptions {
+  /** Version heading text to target (e.g. `"2.3.1"`). */
+  readonly version: string;
+  /** Why the package released with no changesets of its own. */
+  readonly reason: MaintenanceReason;
+}
+declare const MaintenanceNotePlugin: Plugin<[MaintenanceNoteOptions], Root>;
+//#endregion
+//#region src/changesets/api/transformer.d.ts
+/**
+ * Optional per-file behavior for {@link ChangelogTransformer}.
+ *
+ * @public
+ */
+interface TransformOptions {
+  /** Insert a Maintenance note into this version block when it ends up empty. */
+  readonly maintenance?: MaintenanceNoteOptions;
+}
 /**
  * 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
@@ -2145,19 +2237,22 @@ declare class ChangesetLinter {
 declare class ChangelogTransformer {
   private 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
+   * @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: string): string;
+  static transformContent(content: string, options?: TransformOptions): string;
   /**
    * Transform a CHANGELOG file in-place.
    *
@@ -2171,8 +2266,9 @@ declare 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: string): void;
+  static transformFile(filePath: string, options?: TransformOptions): void;
 }
 //#endregion
 //#region src/changesets/changelog/index.d.ts
@@ -2604,7 +2700,7 @@ declare class ChangesetConfigError extends ChangesetConfigError_base<{
 //#endregion
 //#region src/schemas/VersioningSchemas.d.ts
 /**
- * Standard changesets configuration matching the `@changesets/config@3.1.1` spec.
+ * Standard changesets configuration matching the `@changesets/config@4.0.0-next.6` spec.
  *
  * @remarks
  * Represents the parsed `.changeset/config.json` file. All fields are optional
@@ -3868,6 +3964,13 @@ interface ReleasePlannerShape {
   /** Natively apply the release (destructive unless `dryRun`). */
   readonly apply: (root: string, options?: {
     readonly dryRun?: boolean;
+    /**
+     * Map configured changelog ids to absolute module paths. When set,
+     * `config.changelog[0]` must be a key of this map (rewritten before the
+     * engine call; unmapped ids fail) and the engine's `format` integration
+     * is disabled — callers in no-`node_modules` contexts own formatting.
+     */
+    readonly changelogModules?: Readonly<Record<string, string>>;
   }) => Effect.Effect<AppliedRelease, ReleasePlanError>;
 }
 /**
@@ -5477,7 +5580,7 @@ declare const RequiredSectionsRule: import("unified-lint-rule").Plugin<Root, unk
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule: import("unified-lint-rule").Plugin<Root, unknown>;
 declare namespace index_d_exports {
-  export { AggregateDependencyTablesPlugin, AppliedRelease, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetIOError, ChangesetIOErrorBase, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, DepsRegenOptions, DepsRegenShape, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PendingChangeset, PendingChangesetSchema, PositiveInteger, PreviewRelease, PreviewReleaseSchema, RegenPlan, RegenResult, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };
+  export { AggregateDependencyTablesPlugin, AppliedRelease, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetIOError, ChangesetIOErrorBase, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, DepsRegenOptions, DepsRegenShape, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MaintenanceNoteOptions, MaintenanceNotePlugin, MaintenanceReason, MaintenanceReasonSchema, MaintenanceTrigger, MaintenanceTriggerSchema, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PendingChangeset, PendingChangesetSchema, PositiveInteger, PreviewRelease, PreviewReleaseSchema, RegenPlan, RegenResult, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, TransformOptions, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };
 }
 //#endregion
 //#region src/commitlint/config/schema.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/silk-effects",
-	"version": "2.0.2",
+	"version": "3.0.0",
 	"private": false,
 	"description": "Shared Effect library for Silk Suite conventions",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/silk-effects",
@@ -28,10 +28,10 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@changesets/apply-release-plan": "^7.1.1",
-		"@changesets/config": "^3.1.4",
-		"@changesets/get-github-info": "^0.8.0",
-		"@changesets/get-release-plan": "^4.0.16",
+		"@changesets/apply-release-plan": "^8.0.0-next.7",
+		"@changesets/config": "^4.0.0-next.6",
+		"@changesets/get-github-info": "^1.0.0-next.3",
+		"@changesets/get-release-plan": "^5.0.0-next.7",
 		"@manypkg/get-packages": "^3.1.0",
 		"jsonc-effect": "^0.3.0",
 		"mdast-util-heading-range": "^4.0.0",

package/schemas/VersioningSchemas.js

@@ -30,7 +30,7 @@ const SnapshotConfig = Schema.Struct({
 	prereleaseTemplate: Schema.optional(Schema.String)
 });
 /**
-* Standard changesets configuration matching the `@changesets/config@3.1.1` spec.
+* Standard changesets configuration matching the `@changesets/config@4.0.0-next.6` spec.
 *
 * @remarks
 * Represents the parsed `.changeset/config.json` file. All fields are optional