@savvy-web/silk-effects 7.0.1 → 7.1.0

package/README.md

@@ -109,7 +109,7 @@ const tags = strategy.tagsFor([{ name: "@savvy-web/silk-effects", version: "1.0.
 
 #### ChangesetLinter
 
-Validate a changeset file against the Silk section rules. `ChangesetLinter.validateContent(content, filePath?)` and `ChangesetLinter.validateFile(filePath)` are static and synchronous, returning `LintMessage[]` — no Effect, no layers. Rules cover the valid section headings, structural constraints, and the dependency-table format, so a `## Dependencies` section written as prose or a bullet list is reported rather than accepted.
+Validate a changeset file against the Silk section rules. `ChangesetLinter.validateContent(content, filePath?)` and `ChangesetLinter.validateFile(filePath)` are static and synchronous, returning `LintMessage[]` — no Effect, no layers. Rules cover the valid section headings, structural constraints, and the dependency-table format: a `## Dependencies` section must contain a dependency table somewhere between its heading and the next — prose may sit before or after the table — and a section with no table at all is reported at the heading. Each rule is documented under [`docs/rules/`](./docs/rules/CSH001.md) (CSH001 through CSH005).
 
 ```typescript
 import { Changesets } from "@savvy-web/silk-effects";
@@ -294,6 +294,8 @@ const preview = yield* planner.preview(root, {
 
 `Changesets.ReleasePlanner.layer` requires `ConfigInspector` and `FileSystem`.
 
+The `Changesets` namespace also re-exports the stock [`@changesets/changelog-git`](https://www.npmjs.com/package/@changesets/changelog-git) renderer as `Changesets.vanillaChangelogFunctions`, for consumers who want the vanilla changelog output without depending on that package directly.
+
 ---
 
 ### FileSystem + process layer required
@@ -408,6 +410,7 @@ const report = await Effect.runPromise(
 - [Changeset config](./docs/04-changeset-config.md) — reading and decoding `.changeset/config.json`
 - [Config discovery](./docs/05-config-discovery.md) — priority-based config file search
 - [Biome sync](./docs/06-biome-sync.md) — keeping Biome `$schema` URLs current
+- Changeset lint rules — [CSH001](./docs/rules/CSH001.md) through [CSH005](./docs/rules/CSH005.md), the section rules `ChangesetLinter` enforces
 
 ## License
 

package/changesets/api/linter.js

@@ -6,10 +6,10 @@ import { UncategorizedContentRule } from "../remark/rules/uncategorized-content.
 import { stripFrontmatter } from "../utils/strip-frontmatter.js";
 import remarkGfm from "remark-gfm";
 import remarkParse from "remark-parse";
-import remarkStringify from "remark-stringify";
 import { unified } from "unified";
 import { readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
+import remarkStringify from "remark-stringify";
 
 //#region src/changesets/api/linter.ts
 /**

package/changesets/api/transformer.js

@@ -1,8 +1,9 @@
+import { emitMarkdown } from "../utils/markdown-emit.js";
+import { ContributorFootnotesPlugin } from "../remark/plugins/contributor-footnotes.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";
 import { unified } from "unified";
 import { readFileSync, writeFileSync } from "node:fs";
 
@@ -92,8 +93,9 @@ var ChangelogTransformer = class ChangelogTransformer {
 	* @remarks
 	* The input is parsed with `remark-parse` and `remark-gfm` (for table
 	* support), processed through every plugin in {@link SilkChangesetTransformPreset}
-	* in order, and stringified back to markdown. The operation is synchronous
-	* and idempotent.
+	* in order, and emitted back to markdown through the canonical
+	* `@effected/markdown` stringifier. The operation is synchronous and
+	* idempotent.
 	*
 	* @param content - Raw CHANGELOG markdown string (may contain multiple
 	*   version blocks, GFM tables, footnotes, and reference links)
@@ -103,11 +105,12 @@ var ChangelogTransformer = class ChangelogTransformer {
 	*/
 	static transformContent(content, options) {
 		const processor = unified().use(remarkParse).use(remarkGfm);
-		for (const plugin of SilkChangesetTransformPreset) processor.use(plugin);
+		for (const plugin of SilkChangesetTransformPreset) if (plugin === ContributorFootnotesPlugin && options?.thanks !== void 0) processor.use(ContributorFootnotesPlugin, { thanks: options.thanks });
+		else processor.use(plugin);
 		if (options?.maintenance) processor.use(MaintenanceNotePlugin, options.maintenance);
-		processor.use(remarkStringify);
-		const file = processor.processSync(content);
-		return String(file);
+		const parsed = processor.parse(content);
+		const transformed = processor.runSync(parsed);
+		return emitMarkdown(transformed);
 	}
 	/**
 	* Transform a CHANGELOG file in-place.

package/changesets/changelog/getReleaseLine.js

@@ -1,5 +1,6 @@
 import { resolveCommitType } from "../categories/index.js";
 import { GitHubService } from "../services/github.js";
+import { parseMarkdown, stringifyMarkdown } from "../utils/remark-pipeline.js";
 import { GitHubInfoSchema } from "../schemas/github.js";
 import { parseCommitMessage } from "../utils/commit-parser.js";
 import { parseIssueReferences } from "../utils/issue-refs.js";
@@ -41,6 +42,105 @@ import { Effect, Schema } from "effect";
 * @internal
 */
 /**
+* Stringify a single MDAST block node back to markdown, trimmed.
+*
+* @internal
+*/
+function stringifyNode(node) {
+	return stringifyMarkdown({
+		type: "root",
+		children: [node]
+	}).trimEnd();
+}
+/**
+* Render one top-level section content node to markdown.
+*
+* @remarks
+* The emit decision is made on the node type, never on string prefixes:
+*
+* - **paragraph** — rendered as a `- ` bullet, with continuation lines
+*   indented two spaces so multi-line prose stays inside the list item
+*   (the historical behavior for simple prose content).
+* - **heading** — promoted one level so a changeset `###` sub-heading emits
+*   as `####` and can never collide with the changelog's depth-3 category
+*   headings (which the version-block utilities and merge/reorder/dedup
+*   plugins treat as section boundaries). Depths are clamped to the 4–6
+*   range: promoting below 4 could fabricate a version or category heading.
+* - **everything else** (list, table, code fence, blockquote, ...) — passes
+*   through verbatim as a block: never bullet-prefixed, never
+*   continuation-indented.
+*
+* @internal
+*/
+function renderSectionNode(node) {
+	if (node.type === "paragraph") {
+		const [first, ...rest] = stringifyNode(node).split("\n");
+		return [`- ${first}`, ...rest.map((line) => line.length > 0 ? `  ${line}` : line)].join("\n");
+	}
+	if (node.type === "heading") {
+		const heading = node;
+		return stringifyNode({
+			...heading,
+			depth: Math.min(Math.max(heading.depth + 1, 4), 6)
+		});
+	}
+	return stringifyNode(node);
+}
+/**
+* Parse an attribution suffix (e.g. `" [#42](url) Thanks [\@user](url)!"`)
+* into phrasing nodes ready to append to a paragraph, prefixed with a
+* separating space.
+*
+* @internal
+*/
+function attributionPhrasing(attribution) {
+	const trimmed = attribution.trim();
+	if (trimmed === "") return void 0;
+	const first = parseMarkdown(trimmed).children[0];
+	if (first?.type !== "paragraph") return void 0;
+	return [{
+		type: "text",
+		value: " "
+	}, ...first.children];
+}
+/**
+* Find the paragraph of a list's FINAL RENDERED bullet: the last paragraph
+* of the last item, recursing into a trailing nested list first — for
+* `- Parent` / `  - Child`, the child is the bullet a reader sees last, so
+* the attribution must land there, not on the parent line above it.
+*
+* @internal
+*/
+function lastRenderedBulletParagraph(list) {
+	const lastItem = list.children[list.children.length - 1];
+	if (!lastItem) return void 0;
+	for (let i = lastItem.children.length - 1; i >= 0; i--) {
+		const child = lastItem.children[i];
+		if (child.type === "list") {
+			const nested = lastRenderedBulletParagraph(child);
+			if (nested) return nested;
+		} else if (child.type === "paragraph") return child;
+	}
+}
+/**
+* Find the paragraph the attribution should be appended to: the LAST
+* top-level paragraph, or the deepest trailing bullet's paragraph of the
+* LAST top-level list (see {@link lastRenderedBulletParagraph}), across all
+* section content nodes. Tables, headings, code fences and blockquotes are
+* never targets — attribution must not land inside them.
+*
+* @internal
+*/
+function findAttributionTarget(sections) {
+	let target;
+	for (const section of sections) for (const node of section.contentNodes) if (node.type === "paragraph") target = node;
+	else if (node.type === "list") {
+		const lastParagraph = lastRenderedBulletParagraph(node);
+		if (lastParagraph) target = lastParagraph;
+	}
+	return target;
+}
+/**
 * Format a single changeset into a markdown release line.
 *
 * This is the core Effect program that implements the `getReleaseLine` contract
@@ -86,30 +186,24 @@ function getReleaseLine(changeset, versionType, options) {
 		const commitMsg = parseCommitMessage(firstLine);
 		const bodyText = changeset.summary.split("\n").slice(1).join("\n");
 		const issueRefs = parseIssueReferences(bodyText);
-		const attribution = commitInfo ? formatPRAndUserAttribution(commitInfo.pull ?? void 0, commitInfo.user ?? void 0, commitInfo.links) : "";
+		const includeThanks = options.thanks !== false;
+		const attribution = commitInfo ? formatPRAndUserAttribution(commitInfo.pull ?? void 0, includeThanks ? commitInfo.user ?? void 0 : void 0, commitInfo.links) : "";
 		if (parsed.sections.length > 0) {
-			const lines = [];
-			if (parsed.preamble) {
-				lines.push(parsed.preamble);
-				lines.push("");
+			const phrasing = attributionPhrasing(attribution);
+			let standaloneAttribution;
+			if (phrasing) {
+				const target = findAttributionTarget(parsed.sections);
+				if (target) target.children.push(...phrasing);
+				else standaloneAttribution = attribution.trim();
 			}
+			const blocks = [];
+			if (parsed.preamble) blocks.push(parsed.preamble);
 			for (const section of parsed.sections) {
-				lines.push(`### ${section.category.heading}`);
-				lines.push("");
-				if (section.content) {
-					const contentLines = section.content.split("\n");
-					const firstContentLine = contentLines[0];
-					if (firstContentLine.startsWith("- ") || firstContentLine.startsWith("* ")) {
-						lines.push(firstContentLine);
-						lines.push(...contentLines.slice(1));
-					} else {
-						lines.push(`- ${firstContentLine}`);
-						lines.push(...contentLines.slice(1).map((line) => line.length > 0 ? `  ${line}` : line));
-					}
-				}
-				lines.push("");
+				blocks.push(`### ${section.category.heading}`);
+				for (const node of section.contentNodes) blocks.push(renderSectionNode(node));
 			}
-			return `${lines.join("\n").trimEnd()}${attribution}`;
+			if (standaloneAttribution) blocks.push(standaloneAttribution);
+			return blocks.join("\n\n");
 		}
 		const commitType = commitMsg.type ?? versionType;
 		const entryInput = {

package/changesets/changelog/vanilla.js

@@ -0,0 +1,47 @@
+import changelogGit from "@changesets/changelog-git";
+
+//#region src/changesets/changelog/vanilla.ts
+/**
+* The vanilla changesets changelog renderer — `\@changesets/changelog-git`,
+* re-exported.
+*
+* @remarks
+* Some consumers (notably `silk-release-action`) need the STOCK changesets
+* rendering — plain summary lines with commit hashes, no sections, no
+* attribution, no dependency tables — as a fallback or comparison path
+* alongside the silk formatter. Re-exporting the upstream implementation
+* here means those consumers depend only on this package: they get exact
+* parity with `\@changesets/changelog-git` (this is a re-export, never a
+* reimplementation) without declaring the dependency themselves.
+*
+* @see {@link changelogFunctions} in `./index.ts` for the silk formatter
+*   this is the vanilla alternative to
+*/
+/**
+* The stock `\@changesets/changelog-git` changelog implementation.
+*
+* @remarks
+* This is the exact upstream default export (identity-equal, pinned by
+* test), typed against this package's re-exported {@link ChangelogFunctions}
+* interface. Use it wherever the plain changesets rendering is wanted
+* instead of the silk section-aware formatter — e.g. in
+* `.changeset/config.json` via a changelog module that forwards it, or
+* programmatically from a release pipeline.
+*
+* @example
+* ```typescript
+* import { Changesets } from "@savvy-web/silk-effects";
+*
+* const line = await Changesets.vanillaChangelogFunctions.getReleaseLine(
+*   { id: "x", summary: "Fix a thing", releases: [{ name: "pkg", type: "patch" }] },
+*   "patch",
+*   null,
+* );
+* ```
+*
+* @public
+*/
+const vanillaChangelogFunctions = changelogGit;
+
+//#endregion
+export { vanillaChangelogFunctions };

package/changesets/constants.js

@@ -1,6 +1,11 @@
 //#region src/changesets/constants.ts
-/** Base URL for rule documentation on GitHub. */
-const DOCS_BASE = "https://github.com/savvy-web/changesets/blob/main/docs/rules";
+/**
+* Base URL for rule documentation on GitHub.
+*
+* The former home (savvy-web/changesets) is archived; the docs live in the
+* systems monorepo alongside the rule sources (savvy-web/systems#456).
+*/
+const DOCS_BASE = "https://github.com/savvy-web/systems/blob/main/packages/silk-effects/docs/rules";
 /**
 * Documentation URLs for each changeset lint rule.
 *

package/changesets/index.js

@@ -18,9 +18,9 @@ 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 { ContributorFootnotesPlugin } from "./remark/plugins/contributor-footnotes.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";
@@ -28,13 +28,14 @@ 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 { vanillaChangelogFunctions } from "./changelog/vanilla.js";
 import { ClassificationReasonSchema, ClassificationSchema, ConfigInspector, InspectedConfigSchema, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, makeConfigInspectorTest } from "./services/config-inspector.js";
 import { BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, FileStatusSchema, makeBranchAnalyzerTest } from "./services/branch-analyzer.js";
 import { ChangelogService } from "./services/changelog.js";
 import { computeWorkspaceDependencyDiffs } from "./utils/dep-diff.js";
 import { gitMergeBase } from "./utils/git.js";
 import { listPublishablePackageNames } from "./utils/publishability.js";
-import { DepsRegen, DepsRegenDefault, isPureDependencyChangeset, makeDepsRegenDefault } from "./services/deps-regen.js";
+import { DepsRegen, DepsRegenDefault, isPureDependencyChangeset, makeDepsRegenDefault, parseChangesetPackages } from "./services/deps-regen.js";
 import { MaintenanceReasonSchema, MaintenanceTriggerSchema, deriveMaintenanceReason } from "./services/maintenance-reason.js";
 import { VersionFiles } from "./utils/version-files.js";
 import { ReleasePlanner, makeReleasePlannerTest } from "./services/release-planner.js";
@@ -150,8 +151,10 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	makeDepsRegenDefault: () => makeDepsRegenDefault,
 	makeGitHubTest: () => makeGitHubTest,
 	makeReleasePlannerTest: () => makeReleasePlannerTest,
-	serializeDependencyTableToMarkdown: () => serializeDependencyTableToMarkdown
+	parseChangesetPackages: () => parseChangesetPackages,
+	serializeDependencyTableToMarkdown: () => serializeDependencyTableToMarkdown,
+	vanillaChangelogFunctions: () => vanillaChangelogFunctions
 });
 
 //#endregion
-export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogTransformer, ChangesetIOError, ChangesetLinter, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigurationError, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenDefault, FileStatusSchema, GitError, GitHubApiError, GitHubInfoSchema, GitHubService, GlobSchema, HeadingHierarchyRule, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MaintenanceNotePlugin, MaintenanceReasonSchema, MaintenanceTriggerSchema, MarkdownParseError, 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, ReleasePlanner, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };
+export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogTransformer, ChangesetIOError, ChangesetLinter, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigurationError, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenDefault, FileStatusSchema, GitError, GitHubApiError, GitHubInfoSchema, GitHubService, GlobSchema, HeadingHierarchyRule, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MaintenanceNotePlugin, MaintenanceReasonSchema, MaintenanceTriggerSchema, MarkdownParseError, 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, ReleasePlanner, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };

package/changesets/markdownlint/rules/content-structure.js

@@ -44,7 +44,7 @@ function hasContentBetween(tokens, currentIdx, nextIdx) {
 * }
 * ```
 *
-* @see {@link https://github.com/savvy-web/changesets/blob/main/docs/rules/CSH003.md | CSH003 rule documentation}
+* @see {@link https://github.com/savvy-web/systems/blob/main/packages/silk-effects/docs/rules/CSH003.md | CSH003 rule documentation}
 * @see `src/remark/rules/content-structure.ts` for the corresponding remark-lint rule
 *
 * @public
@@ -57,7 +57,7 @@ const ContentStructureRule = {
 	function: function CSH003(params, onError) {
 		const tokens = params.parsers.micromark.tokens;
 		const h2Indices = [];
-		for (let i = 0; i < tokens.length; i++) if (tokens[i].type === "atxHeading" && getHeadingLevel(tokens[i]) === 2) h2Indices.push(i);
+		for (let i = 0; i < tokens.length; i++) if ((tokens[i].type === "atxHeading" || tokens[i].type === "setextHeading") && getHeadingLevel(tokens[i]) === 2) h2Indices.push(i);
 		for (let i = 0; i < h2Indices.length; i++) {
 			const currentIdx = h2Indices[i];
 			if (!hasContentBetween(tokens, currentIdx, i + 1 < h2Indices.length ? h2Indices[i + 1] : tokens.length)) onError({

package/changesets/markdownlint/rules/dependency-table-format.js

@@ -1,5 +1,6 @@
 import { VERSION_RE } from "../../schemas/dependency-table.js";
 import { RULE_DOCS } from "../../constants.js";
+import { scanDependencySection } from "../../utils/dependency-section.js";
 import { getHeadingLevel, getHeadingText, unescapeMarkdown } from "./utils.js";
 
 //#region src/changesets/markdownlint/rules/dependency-table-format.ts
@@ -10,7 +11,9 @@ const VALID_TYPES = /* @__PURE__ */ new Set([
 	"peerDependency",
 	"optionalDependency",
 	"workspace",
-	"config"
+	"config",
+	"runtime",
+	"packageManager"
 ]);
 const VALID_ACTIONS = /* @__PURE__ */ new Set([
 	"added",
@@ -64,19 +67,17 @@ const DependencyTableFormatRule = {
 		const tokens = params.parsers.micromark.tokens;
 		for (let i = 0; i < tokens.length; i++) {
 			const token = tokens[i];
-			if (token.type !== "atxHeading") continue;
+			if (token.type !== "atxHeading" && token.type !== "setextHeading") continue;
 			if (getHeadingLevel(token) !== 2) continue;
 			if (getHeadingText(token).toLowerCase() !== "dependencies") continue;
 			const headingLine = token.startLine;
-			let tableToken = null;
-			for (let j = i + 1; j < tokens.length; j++) {
-				const next = tokens[j];
-				if (next.type === "lineEnding" || next.type === "lineEndingBlank") continue;
-				if (next.type === "atxHeading") break;
-				if (next.type === "table") tableToken = next;
-				break;
-			}
-			if (tableToken === null) {
+			const { table } = scanDependencySection(tokens, i + 1, {
+				isSkippable: (t) => t.type === "lineEnding" || t.type === "lineEndingBlank",
+				isHeading: (t) => t.type === "atxHeading" || t.type === "setextHeading",
+				isTable: (t) => t.type === "table"
+			});
+			const tableToken = table;
+			if (tableToken === void 0) {
 				onError({
 					lineNumber: headingLine,
 					detail: `Dependencies section must contain a table, not a list or paragraph. See: ${RULE_DOCS.CSH005}`

package/changesets/markdownlint/rules/heading-hierarchy.js

@@ -26,7 +26,7 @@ import { getHeadingLevel } from "./utils.js";
 * }
 * ```
 *
-* @see {@link https://github.com/savvy-web/changesets/blob/main/docs/rules/CSH001.md | CSH001 rule documentation}
+* @see {@link https://github.com/savvy-web/systems/blob/main/packages/silk-effects/docs/rules/CSH001.md | CSH001 rule documentation}
 * @see `src/remark/rules/heading-hierarchy.ts` for the corresponding remark-lint rule
 *
 * @public
@@ -39,7 +39,7 @@ const HeadingHierarchyRule = {
 	function: function CSH001(params, onError) {
 		let prevDepth = 0;
 		for (const token of params.parsers.micromark.tokens) {
-			if (token.type !== "atxHeading") continue;
+			if (token.type !== "atxHeading" && token.type !== "setextHeading") continue;
 			const depth = getHeadingLevel(token);
 			if (depth === 1) {
 				onError({

package/changesets/markdownlint/rules/required-sections.js

@@ -27,7 +27,7 @@ import { getHeadingLevel, getHeadingText } from "./utils.js";
 * }
 * ```
 *
-* @see {@link https://github.com/savvy-web/changesets/blob/main/docs/rules/CSH002.md | CSH002 rule documentation}
+* @see {@link https://github.com/savvy-web/systems/blob/main/packages/silk-effects/docs/rules/CSH002.md | CSH002 rule documentation}
 * @see `src/remark/rules/required-sections.ts` for the corresponding remark-lint rule
 *
 * @public
@@ -39,7 +39,7 @@ const RequiredSectionsRule = {
 	parser: "micromark",
 	function: function CSH002(params, onError) {
 		for (const token of params.parsers.micromark.tokens) {
-			if (token.type !== "atxHeading") continue;
+			if (token.type !== "atxHeading" && token.type !== "setextHeading") continue;
 			if (getHeadingLevel(token) !== 2) continue;
 			const text = getHeadingText(token);
 			if (!isValidHeading(text)) onError({

package/changesets/markdownlint/rules/uncategorized-content.js

@@ -27,7 +27,7 @@ import { getHeadingLevel } from "./utils.js";
 * }
 * ```
 *
-* @see {@link https://github.com/savvy-web/changesets/blob/main/docs/rules/CSH004.md | CSH004 rule documentation}
+* @see {@link https://github.com/savvy-web/systems/blob/main/packages/silk-effects/docs/rules/CSH004.md | CSH004 rule documentation}
 * @see `src/remark/rules/uncategorized-content.ts` for the corresponding remark-lint rule
 *
 * @public
@@ -40,9 +40,9 @@ const UncategorizedContentRule = {
 	function: function CSH004(params, onError) {
 		const tokens = params.parsers.micromark.tokens;
 		for (const token of tokens) {
-			if (token.type === "atxHeading" && getHeadingLevel(token) === 2) break;
+			if ((token.type === "atxHeading" || token.type === "setextHeading") && getHeadingLevel(token) === 2) break;
 			if (token.type === "lineEnding" || token.type === "lineEndingBlank" || token.type === "htmlFlow") continue;
-			if (token.type !== "atxHeading") onError({
+			if (token.type !== "atxHeading" && token.type !== "setextHeading") onError({
 				lineNumber: token.startLine,
 				detail: `Content must be placed under a category heading (## heading). Move this content under an appropriate section like "## Features" or "## Bug Fixes". If it doesn't fit an existing category, use "## Other". See: ${RULE_DOCS.CSH004}`
 			});

package/changesets/markdownlint/rules/utils.js

@@ -2,14 +2,25 @@ import { RULE_DOCS } from "../../constants.js";
 
 //#region src/changesets/markdownlint/rules/utils.ts
 /**
-* Get the heading level (1-6) from an `atxHeading` token.
+* Get the heading level (1-6) from an `atxHeading` or `setextHeading` token.
 *
-* @param heading - The `atxHeading` micromark token
-* @returns The heading depth (number of `#` characters), or 0 if no sequence found
+* @remarks
+* remark-parse normalizes setext headings to plain depth-1/2 heading nodes,
+* so the remark siblings of these rules see them as ordinary headings. The
+* micromark extractors must agree, or the two engines disagree about the
+* same file (the issue #367 class of drift).
+*
+* @param heading - The `atxHeading` or `setextHeading` micromark token
+* @returns The heading depth (`#` count, or 1/2 for `=`/`-` setext
+*   underlines), or 0 if no sequence found
 *
 * @internal
 */
 function getHeadingLevel(heading) {
+	if (heading.type === "setextHeading") {
+		const line = heading.children.find((c) => c.type === "setextHeadingLine");
+		return line ? line.text.startsWith("=") ? 1 : 2 : 0;
+	}
 	const sequence = heading.children.find((c) => c.type === "atxHeadingSequence");
 	return sequence ? sequence.text.length : 0;
 }
@@ -39,20 +50,20 @@ function unescapeMarkdown(raw) {
 	return raw.replace(BACKSLASH_ESCAPE_RE, "$1");
 }
 /**
-* Get the plain text content of an `atxHeading` token.
+* Get the plain text content of an `atxHeading` or `setextHeading` token.
 *
 * @remarks
 * Escape-resolved, so a heading compares equal to the same heading as the
 * remark rules see it. `getHeadingLevel` needs no equivalent — it counts
 * sequence characters rather than reading text.
 *
-* @param heading - The `atxHeading` micromark token
+* @param heading - The `atxHeading` or `setextHeading` micromark token
 * @returns The heading text, or empty string if no text token found
 *
 * @internal
 */
 function getHeadingText(heading) {
-	const textToken = heading.children.find((c) => c.type === "atxHeadingText");
+	const textToken = heading.children.find((c) => c.type === "atxHeadingText" || c.type === "setextHeadingText");
 	return textToken ? unescapeMarkdown(textToken.text) : "";
 }
 

package/changesets/remark/plugins/aggregate-dependency-tables.js

@@ -2,6 +2,52 @@ import { collapseDependencyRows, parseDependencyTable, serializeDependencyTable,
 import { getBlockSections, getHeadingText, getVersionBlocks } from "../../utils/version-blocks.js";
 
 //#region src/changesets/remark/plugins/aggregate-dependency-tables.ts
+/**
+* Unwrap dependency tables that an earlier (broken) formatter nested inside
+* list items.
+*
+* @remarks
+* Historical CHANGELOG blocks (e.g. silk\@3.10.0) carry an authored
+* dependency table bullet-wrapped into a list item, which the aggregation
+* pass otherwise cannot recognize. Each list item's tables that parse as
+* dependency tables contribute their rows; ONLY those tables leave the
+* list. The non-table items (e.g. an explanatory bullet alongside the
+* wrapped table) keep their bullet structure: they survive as a List node
+* in the legacy content rather than being flattened to bare paragraphs.
+* When no table in the list parses, the caller keeps the whole list as
+* legacy content untouched.
+*
+* @param list - A list node found inside a `### Dependencies` section
+* @returns Parsed rows plus the remaining non-table content (a pruned copy
+*   of the list, when any items survive)
+*
+* @internal
+*/
+function extractTablesFromList(list) {
+	const rows = [];
+	const keptItems = [];
+	for (const item of list.children) {
+		const keptChildren = [];
+		for (const child of item.children) {
+			if (child.type === "table") try {
+				rows.push(...parseDependencyTable(child));
+				continue;
+			} catch {}
+			keptChildren.push(child);
+		}
+		if (keptChildren.length > 0) keptItems.push({
+			...item,
+			children: keptChildren
+		});
+	}
+	return {
+		rows,
+		rest: keptItems.length > 0 ? [{
+			...list,
+			children: keptItems
+		}] : []
+	};
+}
 const AggregateDependencyTablesPlugin = () => {
 	return (tree) => {
 		const blocks = getVersionBlocks(tree);
@@ -16,7 +62,13 @@ const AggregateDependencyTablesPlugin = () => {
 			} catch {
 				legacyContent.push(node);
 			}
-			else legacyContent.push(node);
+			else if (node.type === "list") {
+				const extracted = extractTablesFromList(node);
+				if (extracted.rows.length > 0) {
+					allRows.push(...extracted.rows);
+					legacyContent.push(...extracted.rest);
+				} else legacyContent.push(node);
+			} else legacyContent.push(node);
 			const collapsed = sortDependencyRows(collapseDependencyRows(allRows));
 			const indicesToRemove = [];
 			for (const section of depSections) {