@savvy-web/silk-effects 1.5.2 → 1.6.0

package/changesets/api/linter.js

@@ -1,8 +1,10 @@
 import { ContentStructureRule } from "../remark/rules/content-structure.js";
+import { DependencyTableFormatRule } from "../remark/rules/dependency-table-format.js";
 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 { 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";
@@ -13,7 +15,7 @@ import { join } from "node:path";
 /**
 * Class-based API wrapper for changeset linting.
 *
-* Provides a static class interface that runs all remark-lint rules
+* Provides a static class interface that runs all five remark-lint rules
 * against changeset markdown files and returns structured diagnostics.
 *
 * @internal
@@ -21,9 +23,9 @@ import { join } from "node:path";
 /**
 * Static class for linting changeset markdown files.
 *
-* Runs the four remark-lint rules (heading-hierarchy, required-sections,
-* content-structure, uncategorized-content) against changeset markdown
-* and returns structured {@link LintMessage} diagnostics.
+* Runs the five remark-lint rules (heading-hierarchy, required-sections,
+* content-structure, dependency-table-format, uncategorized-content) against
+* changeset markdown and returns structured {@link LintMessage} diagnostics.
 *
 * @remarks
 * This class implements the pre-validation layer of the three-layer
@@ -109,7 +111,7 @@ var ChangesetLinter = class ChangesetLinter {
 	*
 	* @remarks
 	* Reads the file synchronously, strips YAML frontmatter, and runs all
-	* four lint rules. The file path is preserved in each returned
+	* five lint rules. The file path is preserved in each returned
 	* {@link LintMessage} for error reporting.
 	*
 	* @param filePath - Absolute or relative path to the changeset `.md` file
@@ -123,7 +125,7 @@ var ChangesetLinter = class ChangesetLinter {
 	* Validate a markdown string directly.
 	*
 	* @remarks
-	* Strips YAML frontmatter (if present) and runs all four lint rules
+	* Strips YAML frontmatter (if present) and runs all five lint rules
 	* against the remaining content. This method is useful for validating
 	* changeset content that is already in memory, such as in test suites
 	* or editor integrations.
@@ -135,7 +137,7 @@ var ChangesetLinter = class ChangesetLinter {
 	*/
 	static validateContent(content, filePath = "<input>") {
 		const body = stripFrontmatter(content);
-		return unified().use(remarkParse).use(remarkStringify).use(HeadingHierarchyRule).use(RequiredSectionsRule).use(ContentStructureRule).use(UncategorizedContentRule).processSync(body).messages.map((msg) => ({
+		return unified().use(remarkParse).use(remarkGfm).use(remarkStringify).use(HeadingHierarchyRule).use(RequiredSectionsRule).use(ContentStructureRule).use(DependencyTableFormatRule).use(UncategorizedContentRule).processSync(body).messages.map((msg) => ({
 			file: filePath,
 			/* v8 ignore next 3 -- ruleId/line/column fallbacks; remark-lint always provides these */
 			rule: msg.ruleId ?? msg.source ?? "unknown",

package/changesets/index.js

@@ -7,13 +7,14 @@ import { ChangesetOptionsSchema, RepoSchema } from "./schemas/options.js";
 import { GitHubLive, GitHubService, GitHubServiceBase, makeGitHubTest } from "./services/github.js";
 import { MarkdownLive, MarkdownService, MarkdownServiceBase } from "./services/markdown.js";
 import { NonEmptyString, PositiveInteger } from "./schemas/primitives.js";
-import { DependencyActionSchema, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, VersionOrEmptySchema } from "./schemas/dependency-table.js";
+import { DependencyActionSchema, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, VERSION_RE, VersionOrEmptySchema } from "./schemas/dependency-table.js";
 import { serializeDependencyTableToMarkdown } from "./utils/dependency-table.js";
 import { GitHubInfoSchema, IssueNumberSchema, UrlOrMarkdownLinkSchema, UsernameSchema } from "./schemas/github.js";
 import changelogFunctions from "./changelog/index.js";
 import { Changelog } from "./api/changelog.js";
 import { DependencyTable } from "./api/dependency-table.js";
 import { ContentStructureRule } from "./remark/rules/content-structure.js";
+import { DependencyTableFormatRule } from "./remark/rules/dependency-table-format.js";
 import { HeadingHierarchyRule } from "./remark/rules/heading-hierarchy.js";
 import { RequiredSectionsRule } from "./remark/rules/required-sections.js";
 import { UncategorizedContentRule } from "./remark/rules/uncategorized-content.js";
@@ -28,24 +29,24 @@ 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";
 import { ChangelogService, ChangelogServiceBase } from "./services/changelog.js";
+import { computeWorkspaceDependencyDiffs } from "./utils/dep-diff.js";
+import { listPublishablePackageNames } from "./utils/publishability.js";
+import { gitMergeBase, snapshotFromWorktree } from "./utils/worktree-snapshot.js";
+import { WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive } from "./services/workspace-snapshot.js";
+import { DepsRegen, DepsRegenBase, DepsRegenLive, isPureDependencyChangeset, resolveDiffRows } from "./services/deps-regen.js";
 import { VersionFiles } from "./utils/version-files.js";
 import { ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, makeReleasePlannerTest } from "./services/release-planner.js";
-import { WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive } from "./services/workspace-snapshot.js";
 import { SectionCategorySchema } from "./categories/types.js";
 import { CommitHashSchema, VersionTypeSchema } from "./schemas/git.js";
 import { ChangesetSchema, ChangesetSummarySchema, DependencyTypeSchema, DependencyUpdateSchema } from "./schemas/changeset.js";
 import { AppliedReleaseEntrySchema, AppliedReleaseSchema, BumpTypeSchema, ChangesetPreviewSchema, PendingChangesetSchema, PreviewReleaseSchema, VersionFileUpdateRecordSchema } from "./schemas/release-plan.js";
-import { computeWorkspaceDependencyDiffs } from "./utils/dep-diff.js";
-import { listPublishablePackageNames } from "./utils/publishability.js";
-import { gitMergeBase, snapshotFromWorktree } from "./utils/worktree-snapshot.js";
 import { ContentStructureRule as ContentStructureRule$1 } from "./markdownlint/rules/content-structure.js";
-import { DependencyTableFormatRule } from "./markdownlint/rules/dependency-table-format.js";
+import { DependencyTableFormatRule as DependencyTableFormatRule$1 } from "./markdownlint/rules/dependency-table-format.js";
 import { HeadingHierarchyRule as HeadingHierarchyRule$1 } from "./markdownlint/rules/heading-hierarchy.js";
 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 { DependencyTableFormatRule as DependencyTableFormatRule$1 } from "./remark/rules/dependency-table-format.js";
 import { SilkChangesetPreset, SilkChangesetTransformPreset } from "./remark/presets.js";
 
 //#region src/changesets/index.ts
@@ -84,12 +85,15 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	DeduplicateItemsPlugin: () => DeduplicateItemsPlugin,
 	DependencyActionSchema: () => DependencyActionSchema,
 	DependencyTable: () => DependencyTable,
-	DependencyTableFormatRule: () => DependencyTableFormatRule$1,
+	DependencyTableFormatRule: () => DependencyTableFormatRule,
 	DependencyTableRowSchema: () => DependencyTableRowSchema,
 	DependencyTableSchema: () => DependencyTableSchema,
 	DependencyTableTypeSchema: () => DependencyTableTypeSchema,
 	DependencyTypeSchema: () => DependencyTypeSchema,
 	DependencyUpdateSchema: () => DependencyUpdateSchema,
+	DepsRegen: () => DepsRegen,
+	DepsRegenBase: () => DepsRegenBase,
+	DepsRegenLive: () => DepsRegenLive,
 	FileStatusSchema: () => FileStatusSchema,
 	GitError: () => GitError,
 	GitErrorBase: () => GitErrorBase,
@@ -113,7 +117,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	MarkdownService: () => MarkdownService,
 	MarkdownServiceBase: () => MarkdownServiceBase,
 	MarkdownlintContentStructureRule: () => ContentStructureRule$1,
-	MarkdownlintDependencyTableFormatRule: () => DependencyTableFormatRule,
+	MarkdownlintDependencyTableFormatRule: () => DependencyTableFormatRule$1,
 	MarkdownlintHeadingHierarchyRule: () => HeadingHierarchyRule$1,
 	MarkdownlintRequiredSectionsRule: () => RequiredSectionsRule$1,
 	MarkdownlintUncategorizedContentRule: () => UncategorizedContentRule$1,
@@ -142,6 +146,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	UncategorizedContentRule: () => UncategorizedContentRule,
 	UrlOrMarkdownLinkSchema: () => UrlOrMarkdownLinkSchema,
 	UsernameSchema: () => UsernameSchema,
+	VERSION_RE: () => VERSION_RE,
 	VersionFileConfigSchema: () => VersionFileConfigSchema,
 	VersionFileError: () => VersionFileError,
 	VersionFileErrorBase: () => VersionFileErrorBase,
@@ -156,14 +161,16 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	changelogFunctions: () => changelogFunctions,
 	computeWorkspaceDependencyDiffs: () => computeWorkspaceDependencyDiffs,
 	gitMergeBase: () => gitMergeBase,
+	isPureDependencyChangeset: () => isPureDependencyChangeset,
 	listPublishablePackageNames: () => listPublishablePackageNames,
 	makeBranchAnalyzerTest: () => makeBranchAnalyzerTest,
 	makeConfigInspectorTest: () => makeConfigInspectorTest,
 	makeGitHubTest: () => makeGitHubTest,
 	makeReleasePlannerTest: () => makeReleasePlannerTest,
+	resolveDiffRows: () => resolveDiffRows,
 	serializeDependencyTableToMarkdown: () => serializeDependencyTableToMarkdown,
 	snapshotFromWorktree: () => snapshotFromWorktree
 });
 
 //#endregion
-export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogTransformer, ChangesetLinter, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$1 as DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, 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 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, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, gitMergeBase, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown, snapshotFromWorktree };
+export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogTransformer, 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, 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, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, resolveDiffRows, serializeDependencyTableToMarkdown, snapshotFromWorktree };

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

@@ -1,3 +1,4 @@
+import { VERSION_RE } from "../../schemas/dependency-table.js";
 import { RULE_DOCS } from "../../constants.js";
 import { getHeadingLevel, getHeadingText } from "./utils.js";
 
@@ -23,7 +24,6 @@ const EXPECTED_HEADERS = [
 	"from",
 	"to"
 ];
-const VERSION_RE = /^(\u2014|[~^]?\d+\.\d+\.\d+(?:[-+.][\w.+-]*)?)$/;
 /**
 * Extract text from a `tableHeader` or `tableData` cell token.
 *

package/changesets/remark/presets.js

@@ -1,4 +1,5 @@
 import { ContentStructureRule } from "./rules/content-structure.js";
+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";
@@ -9,7 +10,6 @@ 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";
-import { DependencyTableFormatRule } from "./rules/dependency-table-format.js";
 
 //#region src/changesets/remark/presets.ts
 /**

package/changesets/schemas/dependency-table.js

@@ -68,6 +68,16 @@ const DependencyActionSchema = Schema.Literal("added", "updated", "removed");
 */
 const DependencyTableTypeSchema = Schema.Literal("dependency", "devDependency", "peerDependency", "optionalDependency", "workspace", "config");
 /**
+* The canonical accepted-value pattern for a dependency-table From/To cell:
+* the em-dash sentinel (U+2014), a bare/`~`/`^` semver, or — as a last-resort
+* fallback when a `catalog:`/`workspace:` specifier could not be resolved to a
+* concrete version — a pnpm protocol string. Non-overlapping alternatives keep
+* this free of polynomial backtracking (CodeQL).
+*
+* @public
+*/
+const VERSION_RE = /^(\u2014|[~^]?\d+\.\d+\.\d+(?:[-+.][\w.+-]+)?|(?:catalog|workspace|npm|jsr|file|link|portal):[^\s|]+)$/;
+/**
 * Version string or em dash (U+2014) sentinel for added/removed entries.
 *
 * @remarks
@@ -93,7 +103,7 @@ const DependencyTableTypeSchema = Schema.Literal("dependency", "devDependency",
 *
 * @public
 */
-const VersionOrEmptySchema = Schema.String.pipe(Schema.pattern(/^(\u2014|[~^]?\d+\.\d+\.\d+(?:[-+.][\w.+-]*)?)$/));
+const VersionOrEmptySchema = Schema.String.pipe(Schema.pattern(VERSION_RE));
 /**
 * Schema for a single dependency table row.
 *
@@ -185,4 +195,4 @@ const DependencyTableRowSchema = Schema.Struct({
 const DependencyTableSchema = Schema.Array(DependencyTableRowSchema).pipe(Schema.minItems(1));
 
 //#endregion
-export { DependencyActionSchema, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, VersionOrEmptySchema };
+export { DependencyActionSchema, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, VERSION_RE, VersionOrEmptySchema };

package/changesets/services/deps-regen.js

@@ -0,0 +1,328 @@
+import { serializeDependencyTableToMarkdown, sortDependencyRows } from "../utils/dependency-table.js";
+import { ConfigInspector } from "./config-inspector.js";
+import { computeWorkspaceDependencyDiffs } from "../utils/dep-diff.js";
+import { listPublishablePackageNames } from "../utils/publishability.js";
+import { gitMergeBase, snapshotFromWorktree } from "../utils/worktree-snapshot.js";
+import { WorkspaceSnapshotReader } from "./workspace-snapshot.js";
+import { Context, Effect, Layer, Option } from "effect";
+import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { CatalogResolver, PublishabilityDetector, WorkspaceDiscovery } from "workspaces-effect";
+
+//#region src/changesets/services/deps-regen.ts
+/**
+* `Changesets.DepsRegen` service — lift the `deps regen` / `deps detect`
+* orchestration out of the CLI into a `Context.Tag` service with a
+* `plan()` / `execute()` split.
+*
+* @remarks
+* `plan()` computes the cumulative dependency diff (merge-base → working
+* tree by default, or between two explicit refs), resolves `catalog:` /
+* `workspace:` specifiers to concrete versions, drops `devDependency`
+* rows (unless `includeDevDeps`), and returns a complete {@link RegenPlan}
+* (target filenames + stale-changeset deletes) WITHOUT touching the
+* filesystem. `execute()` applies a plan — writing the fresh changesets
+* first, then deleting the stale pure-dependency ones (so an interrupted
+* run loses nothing and is safely re-runnable).
+*
+* This is the single source of truth for regen/detect: the CLI commands
+* and MCP tools are thin adapters over this service.
+*
+* @see {@link DepsRegen} for the service tag
+* @see {@link DepsRegenLive} for the production layer
+*
+*/
+/** The em-dash sentinel (U+2014) used for added ("from") / removed ("to") cells. */
+const EM_DASH = "—";
+/** Whether a From/To cell holds a pnpm protocol specifier that could resolve to a version. */
+const isProtocol = (v) => /^(?:catalog|workspace|npm|jsr|file|link|portal):/.test(v);
+/**
+* Resolve protocol From/To cells to concrete versions (raw-string fallback
+* when unresolved or on resolver error), leave em-dash sentinels untouched,
+* then optionally drop `devDependency` rows, and re-sort.
+*
+* @param diff - One workspace package's dependency-table rows.
+* @param keepDevDeps - When `true`, retain `devDependency` rows; otherwise
+*   drop them unconditionally (the regen default).
+* @returns An Effect yielding the transformed {@link WorkspaceDependencyDiff}.
+*
+* @public
+*/
+const resolveDiffRows = (diff, keepDevDeps = false) => Effect.gen(function* () {
+	const resolver = yield* CatalogResolver;
+	const resolveCell = (dep, value) => isProtocol(value) ? resolver.resolveSpecifier(dep, value).pipe(Effect.map((opt) => Option.getOrElse(opt, () => value)), Effect.catchAll((error) => Effect.logWarning(`DepsRegen: catalog resolution failed for "${dep}" (${value}); keeping raw specifier: ${String(error)}`).pipe(Effect.as(value)))) : Effect.succeed(value);
+	const rows = [];
+	for (const row of diff.rows) {
+		if (!keepDevDeps && row.type === "devDependency") continue;
+		const from = row.from === EM_DASH ? EM_DASH : yield* resolveCell(row.dependency, row.from);
+		const to = row.to === EM_DASH ? EM_DASH : yield* resolveCell(row.dependency, row.to);
+		rows.push({
+			...row,
+			from,
+			to
+		});
+	}
+	return {
+		...diff,
+		rows: sortDependencyRows(rows)
+	};
+});
+const ADJECTIVES = [
+	"brave",
+	"clever",
+	"swift",
+	"silver",
+	"lucky",
+	"happy",
+	"calm",
+	"bright",
+	"quiet",
+	"wild"
+];
+const NOUNS = [
+	"dogs",
+	"cats",
+	"wolves",
+	"foxes",
+	"cups",
+	"ships",
+	"trees",
+	"owls",
+	"cranes",
+	"hills"
+];
+const VERBS = [
+	"laugh",
+	"dream",
+	"fly",
+	"sing",
+	"dance",
+	"wander",
+	"soar",
+	"rest",
+	"leap",
+	"ponder"
+];
+function pickRandomTriplet() {
+	return `${ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)]}-${NOUNS[Math.floor(Math.random() * NOUNS.length)]}-${VERBS[Math.floor(Math.random() * VERBS.length)]}`;
+}
+/**
+* Pick a `<adjective>-<noun>-<verb>` filename slug that does not collide
+* with an existing `.changeset/*.md` OR with a slug already claimed
+* earlier in the same {@link RegenPlan.toWrite} computation. `plan()`
+* never writes to disk, so `existsSync` alone cannot see slugs chosen
+* moments earlier in the same call — the `chosen` set closes that gap.
+* The triplet space is 1,000 combinations, so a busy repo can plausibly
+* exhaust it across runs; fall back to a timestamp suffix after 20
+* unlucky picks.
+*
+* @param changesetDir - Directory checked via `existsSync` for on-disk collisions.
+* @param chosen - Basenames (without extension) already picked within this plan;
+*   the picked candidate is added to this set before returning.
+* @internal
+*/
+function randomFilename(changesetDir, chosen) {
+	for (let i = 0; i < 20; i++) {
+		const candidate = pickRandomTriplet();
+		if (!chosen.has(candidate) && !existsSync(join(changesetDir, `${candidate}.md`))) {
+			chosen.add(candidate);
+			return candidate;
+		}
+	}
+	let attempt = 0;
+	let fallback = `${pickRandomTriplet()}-${Date.now()}`;
+	while (chosen.has(fallback) || existsSync(join(changesetDir, `${fallback}.md`))) fallback = `${pickRandomTriplet()}-${Date.now()}-${++attempt}`;
+	chosen.add(fallback);
+	return fallback;
+}
+/**
+* Strict detection of "pure dependency changesets" per the documented
+* rules: single-package frontmatter, single `## Dependencies` heading,
+* no other body content beyond that section.
+*
+* @param content - Raw `.changeset/*.md` file contents.
+* @returns `{ isPure, package }` — `isPure` is `true` only for a
+*   single-package, Dependencies-only changeset; `package` is the sole
+*   frontmatter package name (or `null` when not pure).
+*
+* @public
+*/
+function isPureDependencyChangeset(content) {
+	const fmMatch = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+	if (!fmMatch) return {
+		isPure: false,
+		package: null
+	};
+	const frontmatter = fmMatch[1];
+	const body = (fmMatch[2] ?? "").trim();
+	const fmLines = frontmatter.split(/\r?\n/).filter((l) => l.trim().length > 0 && !/^\s*#/.test(l));
+	if (fmLines.length !== 1) return {
+		isPure: false,
+		package: null
+	};
+	const pkgMatch = fmLines[0].match(/^\s*["']?([^"':\s]+)["']?\s*:\s*([a-z]+)\s*$/);
+	if (!pkgMatch) return {
+		isPure: false,
+		package: null
+	};
+	const pkg = pkgMatch[1];
+	const bodyTrimmed = body.replace(/^\s+/, "");
+	if (!/^## Dependencies\b/.test(bodyTrimmed)) return {
+		isPure: false,
+		package: null
+	};
+	if ((bodyTrimmed.match(/^## /gm) ?? []).length !== 1) return {
+		isPure: false,
+		package: null
+	};
+	if (/^# /m.test(bodyTrimmed)) return {
+		isPure: false,
+		package: null
+	};
+	return {
+		isPure: true,
+		package: pkg
+	};
+}
+function listChangesetFiles(changesetDir) {
+	if (!existsSync(changesetDir)) return [];
+	return readdirSync(changesetDir).filter((f) => f.endsWith(".md") && f !== "README.md").map((f) => join(changesetDir, f));
+}
+function findPureDependencyChangesets(changesetDir) {
+	const result = [];
+	for (const file of listChangesetFiles(changesetDir)) {
+		let content;
+		try {
+			content = readFileSync(file, "utf8");
+		} catch {
+			continue;
+		}
+		const detection = isPureDependencyChangeset(content);
+		if (detection.isPure && detection.package) result.push({
+			file,
+			package: detection.package
+		});
+	}
+	return result;
+}
+function findMixedDependencyChangesets(changesetDir) {
+	const result = [];
+	for (const file of listChangesetFiles(changesetDir)) {
+		let content;
+		try {
+			content = readFileSync(file, "utf8");
+		} catch {
+			continue;
+		}
+		if (/^## Dependencies\b/m.test(content) && !isPureDependencyChangeset(content).isPure) result.push(file);
+	}
+	return result;
+}
+/**
+* Render a single-package, patch-bump changeset for a diff whose rows have
+* already been resolved/filtered by {@link resolveDiffRows}.
+*/
+function renderChangesetContent(diff) {
+	return `${`---\n"${diff.package}": patch\n---`}\n\n## Dependencies\n\n${serializeDependencyTableToMarkdown([...diff.rows])}\n`;
+}
+const _tag = Context.Tag("Changesets/DepsRegen");
+/**
+* @internal
+*/
+const DepsRegenBase = _tag();
+/**
+* Effect service tag for {@link DepsRegenShape}.
+*
+* @example
+* ```typescript
+* import { Effect } from "effect";
+* import { Changesets } from "@savvy-web/silk-effects";
+*
+* const program = Effect.gen(function* () {
+*   const svc = yield* Changesets.DepsRegen;
+*   const plan = yield* svc.plan({ cwd: process.cwd() });
+*   return yield* svc.execute(plan);
+* });
+* ```
+*
+* @public
+*/
+var DepsRegen = class extends DepsRegenBase {};
+/**
+* Build a {@link DepsRegenShape} that closes over already-resolved service
+* implementations, keeping the public `plan`/`execute` signatures
+* requirement-free (`R = never`).
+*/
+function makeShape(reader, inspector, discovery, resolver, detector) {
+	const provideResolver = Layer.succeed(CatalogResolver, resolver);
+	const provideDetector = Layer.succeed(PublishabilityDetector, detector);
+	const plan = (options) => Effect.gen(function* () {
+		const resolvedCwd = resolve(options.cwd);
+		const changesetDir = join(resolvedCwd, ".changeset");
+		let fromRef = options.from;
+		if (!fromRef) {
+			let baseBranch = options.base;
+			if (!baseBranch) baseBranch = (yield* inspector.inspect(resolvedCwd).pipe(Effect.catchTag("ConfigurationError", () => Effect.succeed({ baseBranch: "main" })))).baseBranch;
+			fromRef = yield* gitMergeBase(resolvedCwd, baseBranch);
+		}
+		const rawDiffs = computeWorkspaceDependencyDiffs(yield* reader.snapshotAt(resolvedCwd, fromRef), options.to ? yield* reader.snapshotAt(resolvedCwd, options.to) : snapshotFromWorktree(resolvedCwd));
+		const targetPkg = options.package;
+		const publishable = yield* listPublishablePackageNames(yield* discovery.listPackages(resolvedCwd)).pipe(Effect.provide(provideDetector));
+		const keepDevDeps = options.includeDevDeps === true;
+		const scoped = targetPkg ? rawDiffs.filter((d) => d.package === targetPkg) : rawDiffs.filter((d) => publishable.has(d.package));
+		const resolved = [];
+		for (const diff of scoped) {
+			const next = yield* resolveDiffRows(diff, keepDevDeps).pipe(Effect.provide(provideResolver));
+			if (next.rows.length > 0) resolved.push(next);
+		}
+		const existingPure = findPureDependencyChangesets(changesetDir);
+		const skippedMixed = findMixedDependencyChangesets(changesetDir);
+		const toDelete = targetPkg ? existingPure.filter((p) => p.package === targetPkg) : existingPure.filter((p) => publishable.has(p.package));
+		const chosenFilenames = /* @__PURE__ */ new Set();
+		return {
+			toDelete,
+			toWrite: resolved.map((diff) => ({
+				file: join(changesetDir, `${randomFilename(changesetDir, chosenFilenames)}.md`),
+				package: diff.package,
+				diff
+			})),
+			skippedMixed
+		};
+	});
+	const execute = (plan) => Effect.sync(() => {
+		const deleted = [];
+		const written = [];
+		for (const entry of plan.toWrite) {
+			writeFileSync(entry.file, renderChangesetContent(entry.diff));
+			written.push(entry.file);
+		}
+		for (const entry of plan.toDelete) try {
+			unlinkSync(entry.file);
+			deleted.push(entry.file);
+		} catch {}
+		return {
+			deleted,
+			written,
+			skippedMixed: plan.skippedMixed
+		};
+	});
+	return {
+		plan,
+		execute
+	};
+}
+/**
+* Live layer for {@link DepsRegen}.
+*
+* Requires {@link WorkspaceSnapshotReader}, {@link ConfigInspector},
+* `WorkspaceDiscovery`, `CatalogResolver`, and `PublishabilityDetector`
+* (the last three from `workspaces-effect`).
+*
+* @public
+*/
+const DepsRegenLive = Layer.effect(DepsRegen, Effect.gen(function* () {
+	return makeShape(yield* WorkspaceSnapshotReader, yield* ConfigInspector, yield* WorkspaceDiscovery, yield* CatalogResolver, yield* PublishabilityDetector);
+}));
+
+//#endregion
+export { DepsRegen, DepsRegenBase, DepsRegenLive, isPureDependencyChangeset, resolveDiffRows };

package/index.d.ts

@@ -1,6 +1,6 @@
 import { Context, Data, Effect, Equal, Hash, Layer, Option, Schema, Stream } from "effect";
 import { Command, CommandExecutor, FileSystem } from "@effect/platform";
-import { PackageManagerDetector, PublishConfig, PublishTarget, PublishabilityDetector, TopologicalSorter, WorkspaceDiscovery, WorkspaceDiscoveryError, WorkspacePackage, WorkspaceRoot } from "workspaces-effect";
+import { CatalogResolver, PackageManagerDetector, PublishConfig, PublishTarget, PublishabilityDetector, TopologicalSorter, WorkspaceDiscovery, WorkspaceDiscoveryError, WorkspacePackage, WorkspaceRoot } from "workspaces-effect";
 import { Plugin } from "unified";
 import { PlatformError } from "@effect/platform/Error";
 
@@ -1571,6 +1571,16 @@ declare const DependencyTableTypeSchema: Schema.Literal<["dependency", "devDepen
  * @public
  */
 type DependencyTableType = typeof DependencyTableTypeSchema.Type;
+/**
+ * The canonical accepted-value pattern for a dependency-table From/To cell:
+ * the em-dash sentinel (U+2014), a bare/`~`/`^` semver, or — as a last-resort
+ * fallback when a `catalog:`/`workspace:` specifier could not be resolved to a
+ * concrete version — a pnpm protocol string. Non-overlapping alternatives keep
+ * this free of polynomial backtracking (CodeQL).
+ *
+ * @public
+ */
+declare const VERSION_RE: RegExp;
 /**
  * Version string or em dash (U+2014) sentinel for added/removed entries.
  *
@@ -1845,7 +1855,7 @@ declare class DependencyTable {
 /**
  * Class-based API wrapper for changeset linting.
  *
- * Provides a static class interface that runs all remark-lint rules
+ * Provides a static class interface that runs all five remark-lint rules
  * against changeset markdown files and returns structured diagnostics.
  *
  * @internal
@@ -1859,11 +1869,12 @@ declare class DependencyTable {
  * (file, line, column) for integration with editors, CI reporters, and
  * the Effect CLI's `lint` and `check` commands.
  *
- * The four rules that produce lint messages are:
+ * The five rules that produce lint messages are:
  *
  * - **heading-hierarchy** -- ensures headings follow a valid nesting order
  * - **required-sections** -- checks that mandatory sections are present
  * - **content-structure** -- validates the structure of section content
+ * - **dependency-table-format** -- enforces the machine-generated dependency-table format for `## Dependencies` sections
  * - **uncategorized-content** -- flags content outside recognized section headings
  *
  * @public
@@ -1882,9 +1893,10 @@ interface LintMessage {
    * Identifier of the remark-lint rule that produced this message.
    *
    * @remarks
-   * Corresponds to one of the four built-in rules: `"heading-hierarchy"`,
-   * `"required-sections"`, `"content-structure"`, or `"uncategorized-content"`.
-   * Falls back to `"unknown"` if the underlying vfile message has no rule ID.
+   * Corresponds to one of the five built-in rules: `"heading-hierarchy"`,
+   * `"required-sections"`, `"content-structure"`, `"dependency-table-format"`,
+   * or `"uncategorized-content"`. Falls back to `"unknown"` if the underlying
+   * vfile message has no rule ID.
    */
   rule: string;
   /**
@@ -1917,9 +1929,9 @@ interface LintMessage {
 /**
  * Static class for linting changeset markdown files.
  *
- * Runs the four remark-lint rules (heading-hierarchy, required-sections,
- * content-structure, uncategorized-content) against changeset markdown
- * and returns structured {@link LintMessage} diagnostics.
+ * Runs the five remark-lint rules (heading-hierarchy, required-sections,
+ * content-structure, dependency-table-format, uncategorized-content) against
+ * changeset markdown and returns structured {@link LintMessage} diagnostics.
  *
  * @remarks
  * This class implements the pre-validation layer of the three-layer
@@ -2004,7 +2016,7 @@ declare class ChangesetLinter {
    *
    * @remarks
    * Reads the file synchronously, strips YAML frontmatter, and runs all
-   * four lint rules. The file path is preserved in each returned
+   * five lint rules. The file path is preserved in each returned
    * {@link LintMessage} for error reporting.
    *
    * @param filePath - Absolute or relative path to the changeset `.md` file
@@ -2015,7 +2027,7 @@ declare class ChangesetLinter {
    * Validate a markdown string directly.
    *
    * @remarks
-   * Strips YAML frontmatter (if present) and runs all four lint rules
+   * Strips YAML frontmatter (if present) and runs all five lint rules
    * against the remaining content. This method is useful for validating
    * changeset content that is already in memory, such as in test suites
    * or editor integrations.
@@ -3480,6 +3492,231 @@ declare const ChangelogServiceBase: Context.TagClass<ChangelogService, "Changelo
  */
 declare class ChangelogService extends ChangelogServiceBase {}
 //#endregion
+//#region src/changesets/services/workspace-snapshot.d.ts
+/**
+ * One workspace package as it existed at a specific git ref.
+ *
+ * @public
+ */
+interface WorkspaceSnapshot {
+  /** Package name from `package.json#name`. */
+  readonly name: string;
+  /** Repo-relative path of the package directory at this ref. */
+  readonly relativePath: string;
+  /** Package version from `package.json#version`. */
+  readonly version: string;
+  /** Declared `dependencies` (raw strings, including `workspace:` / `catalog:` protocols). */
+  readonly dependencies: Readonly<Record<string, string>>;
+  /** Declared `devDependencies`. */
+  readonly devDependencies: Readonly<Record<string, string>>;
+  /** Declared `peerDependencies`. */
+  readonly peerDependencies: Readonly<Record<string, string>>;
+  /** Declared `optionalDependencies`. */
+  readonly optionalDependencies: Readonly<Record<string, string>>;
+}
+/**
+ * Effect service interface for reading workspace snapshots.
+ *
+ * @public
+ */
+interface WorkspaceSnapshotReaderShape {
+  /**
+   * Read every workspace package's snapshot at the given git ref.
+   *
+   * @param cwd - Project root (must be inside a git repo)
+   * @param ref - Any valid git revision spec — branch, tag, SHA, `HEAD~1`, etc.
+   * @returns Effect resolving to one {@link WorkspaceSnapshot} per workspace
+   *   package present at that ref, or failing with {@link GitError}
+   */
+  readonly snapshotAt: (cwd: string, ref: string) => Effect.Effect<ReadonlyArray<WorkspaceSnapshot>, GitError>;
+}
+/**
+ * @internal
+ */
+declare const WorkspaceSnapshotReaderBase: Context.TagClass<WorkspaceSnapshotReader, "WorkspaceSnapshotReader", WorkspaceSnapshotReaderShape>;
+/**
+ * Effect service tag for {@link WorkspaceSnapshotReaderShape}.
+ *
+ * @public
+ */
+declare class WorkspaceSnapshotReader extends WorkspaceSnapshotReaderBase {}
+/**
+ * Production layer for {@link WorkspaceSnapshotReader}.
+ *
+ * @public
+ */
+declare const WorkspaceSnapshotReaderLive: Layer.Layer<WorkspaceSnapshotReader>;
+//#endregion
+//#region src/changesets/utils/dep-diff.d.ts
+/**
+ * A workspace package's worth of dependency-table rows.
+ *
+ * @public
+ */
+interface WorkspaceDependencyDiff {
+  /** The workspace package whose `package.json` changed. */
+  readonly package: string;
+  /** Repo-relative path of the package directory (taken from the `after` snapshot when available). */
+  readonly relativePath: string;
+  /** One row per dependency change, sorted by the existing `sortDependencyRows` convention. */
+  readonly rows: ReadonlyArray<DependencyTableRow>;
+}
+/**
+ * Diff two workspace snapshots and return per-package dependency-table rows.
+ *
+ * @param before - Snapshot at the older ref (typically the merge base). Pass
+ *   `null` for workspace packages that did not exist at the older ref — every
+ *   declared dep is then reported as `"added"`.
+ * @param after - Snapshot at the newer ref (typically the working tree).
+ * @returns One {@link WorkspaceDependencyDiff} entry per workspace package
+ *   that has at least one row. Packages with no changes are omitted.
+ *
+ * @public
+ */
+declare function computeWorkspaceDependencyDiffs(beforeSnapshots: ReadonlyArray<WorkspaceSnapshot>, afterSnapshots: ReadonlyArray<WorkspaceSnapshot>): ReadonlyArray<WorkspaceDependencyDiff>;
+//#endregion
+//#region src/changesets/services/deps-regen.d.ts
+/**
+ * Resolve protocol From/To cells to concrete versions (raw-string fallback
+ * when unresolved or on resolver error), leave em-dash sentinels untouched,
+ * then optionally drop `devDependency` rows, and re-sort.
+ *
+ * @param diff - One workspace package's dependency-table rows.
+ * @param keepDevDeps - When `true`, retain `devDependency` rows; otherwise
+ *   drop them unconditionally (the regen default).
+ * @returns An Effect yielding the transformed {@link WorkspaceDependencyDiff}.
+ *
+ * @public
+ */
+declare const resolveDiffRows: (diff: WorkspaceDependencyDiff, keepDevDeps?: boolean) => Effect.Effect<WorkspaceDependencyDiff, never, CatalogResolver>;
+/**
+ * Strict detection of "pure dependency changesets" per the documented
+ * rules: single-package frontmatter, single `## Dependencies` heading,
+ * no other body content beyond that section.
+ *
+ * @param content - Raw `.changeset/*.md` file contents.
+ * @returns `{ isPure, package }` — `isPure` is `true` only for a
+ *   single-package, Dependencies-only changeset; `package` is the sole
+ *   frontmatter package name (or `null` when not pure).
+ *
+ * @public
+ */
+declare function isPureDependencyChangeset(content: string): {
+  isPure: boolean;
+  package: string | null;
+};
+/**
+ * A complete, side-effect-free regen plan: which stale pure-dependency
+ * changesets to delete, which fresh changesets to write (carrying the
+ * already-resolved diff), and which mixed changesets were left untouched.
+ *
+ * @public
+ */
+interface RegenPlan {
+  readonly toDelete: ReadonlyArray<{
+    readonly file: string;
+    readonly package: string;
+  }>;
+  readonly toWrite: ReadonlyArray<{
+    readonly file: string;
+    readonly package: string;
+    readonly diff: WorkspaceDependencyDiff;
+  }>;
+  readonly skippedMixed: ReadonlyArray<string>;
+}
+/**
+ * The result of applying a {@link RegenPlan}: the files actually deleted
+ * and written, plus the mixed changesets that were skipped.
+ *
+ * @public
+ */
+interface RegenResult {
+  readonly deleted: ReadonlyArray<string>;
+  readonly written: ReadonlyArray<string>;
+  readonly skippedMixed: ReadonlyArray<string>;
+}
+/**
+ * Options for {@link DepsRegenShape.plan}.
+ *
+ * @public
+ */
+interface DepsRegenOptions {
+  /** Project root (containing `.changeset/`). */
+  readonly cwd: string;
+  /** Override the base branch used to compute the merge-base when `from` is omitted. */
+  readonly base?: string;
+  /** Restrict regeneration to a single workspace package. */
+  readonly package?: string;
+  /**
+   * When `true`, retain `devDependency` rows (the `deps detect` path);
+   * when falsy (the `deps regen` default), drop them unconditionally.
+   * Protocol resolution runs regardless.
+   */
+  readonly includeDevDeps?: boolean;
+  /**
+   * Older ref to diff from. Defaults to `git merge-base <base branch> HEAD`.
+   */
+  readonly from?: string;
+  /**
+   * Newer ref to diff to. Defaults to the working tree (staged + unstaged
+   * + untracked) via {@link snapshotFromWorktree}.
+   */
+  readonly to?: string;
+}
+/**
+ * Effect service interface for the deps regen/detect orchestration.
+ *
+ * @public
+ */
+interface DepsRegenShape {
+  /**
+   * Compute a complete {@link RegenPlan} without touching the filesystem.
+   *
+   * @param options - See {@link DepsRegenOptions}.
+   * @returns An Effect yielding the plan, or failing with {@link GitError}.
+   */
+  readonly plan: (options: DepsRegenOptions) => Effect.Effect<RegenPlan, GitError | WorkspaceDiscoveryError, never>;
+  /**
+   * Apply a {@link RegenPlan}: delete stale changesets, write fresh ones.
+   *
+   * @param plan - The plan produced by {@link DepsRegenShape.plan}.
+   * @returns An Effect yielding a {@link RegenResult}.
+   */
+  readonly execute: (plan: RegenPlan) => Effect.Effect<RegenResult, never, never>;
+}
+/**
+ * @internal
+ */
+declare const DepsRegenBase: Context.TagClass<DepsRegen, "Changesets/DepsRegen", DepsRegenShape>;
+/**
+ * Effect service tag for {@link DepsRegenShape}.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { Changesets } from "@savvy-web/silk-effects";
+ *
+ * const program = Effect.gen(function* () {
+ *   const svc = yield* Changesets.DepsRegen;
+ *   const plan = yield* svc.plan({ cwd: process.cwd() });
+ *   return yield* svc.execute(plan);
+ * });
+ * ```
+ *
+ * @public
+ */
+declare class DepsRegen extends DepsRegenBase {}
+/**
+ * Live layer for {@link DepsRegen}.
+ *
+ * Requires {@link WorkspaceSnapshotReader}, {@link ConfigInspector},
+ * `WorkspaceDiscovery`, `CatalogResolver`, and `PublishabilityDetector`
+ * (the last three from `workspaces-effect`).
+ *
+ * @public
+ */
+declare const DepsRegenLive: Layer.Layer<DepsRegen, never, WorkspaceSnapshotReader | ConfigInspector | WorkspaceDiscovery | CatalogResolver | PublishabilityDetector>;
+//#endregion
 //#region src/changesets/schemas/release-plan.d.ts
 /** A semantic-version bump level (the `"none"` plan type is filtered out upstream). @public */
 declare const BumpTypeSchema: Schema.Literal<["major", "minor", "patch"]>;
@@ -3594,61 +3831,6 @@ declare function makeReleasePlannerTest(fixed: {
   readonly apply?: AppliedRelease;
 }): Layer.Layer<ReleasePlanner>;
 //#endregion
-//#region src/changesets/services/workspace-snapshot.d.ts
-/**
- * One workspace package as it existed at a specific git ref.
- *
- * @public
- */
-interface WorkspaceSnapshot {
-  /** Package name from `package.json#name`. */
-  readonly name: string;
-  /** Repo-relative path of the package directory at this ref. */
-  readonly relativePath: string;
-  /** Package version from `package.json#version`. */
-  readonly version: string;
-  /** Declared `dependencies` (raw strings, including `workspace:` / `catalog:` protocols). */
-  readonly dependencies: Readonly<Record<string, string>>;
-  /** Declared `devDependencies`. */
-  readonly devDependencies: Readonly<Record<string, string>>;
-  /** Declared `peerDependencies`. */
-  readonly peerDependencies: Readonly<Record<string, string>>;
-  /** Declared `optionalDependencies`. */
-  readonly optionalDependencies: Readonly<Record<string, string>>;
-}
-/**
- * Effect service interface for reading workspace snapshots.
- *
- * @public
- */
-interface WorkspaceSnapshotReaderShape {
-  /**
-   * Read every workspace package's snapshot at the given git ref.
-   *
-   * @param cwd - Project root (must be inside a git repo)
-   * @param ref - Any valid git revision spec — branch, tag, SHA, `HEAD~1`, etc.
-   * @returns Effect resolving to one {@link WorkspaceSnapshot} per workspace
-   *   package present at that ref, or failing with {@link GitError}
-   */
-  readonly snapshotAt: (cwd: string, ref: string) => Effect.Effect<ReadonlyArray<WorkspaceSnapshot>, GitError>;
-}
-/**
- * @internal
- */
-declare const WorkspaceSnapshotReaderBase: Context.TagClass<WorkspaceSnapshotReader, "WorkspaceSnapshotReader", WorkspaceSnapshotReaderShape>;
-/**
- * Effect service tag for {@link WorkspaceSnapshotReaderShape}.
- *
- * @public
- */
-declare class WorkspaceSnapshotReader extends WorkspaceSnapshotReaderBase {}
-/**
- * Production layer for {@link WorkspaceSnapshotReader}.
- *
- * @public
- */
-declare const WorkspaceSnapshotReaderLive: Layer.Layer<WorkspaceSnapshotReader>;
-//#endregion
 //#region src/changesets/schemas/changeset.d.ts
 /**
  * Schema for a changeset summary (1--1000 characters).
@@ -4290,34 +4472,6 @@ declare const LegacyVersionFilesSchema: Schema.Array$<Schema.Struct<{
   package: Schema.optional<Schema.filter<typeof Schema.String>>;
 }>>;
 //#endregion
-//#region src/changesets/utils/dep-diff.d.ts
-/**
- * A workspace package's worth of dependency-table rows.
- *
- * @public
- */
-interface WorkspaceDependencyDiff {
-  /** The workspace package whose `package.json` changed. */
-  readonly package: string;
-  /** Repo-relative path of the package directory (taken from the `after` snapshot when available). */
-  readonly relativePath: string;
-  /** One row per dependency change, sorted by the existing `sortDependencyRows` convention. */
-  readonly rows: ReadonlyArray<DependencyTableRow>;
-}
-/**
- * Diff two workspace snapshots and return per-package dependency-table rows.
- *
- * @param before - Snapshot at the older ref (typically the merge base). Pass
- *   `null` for workspace packages that did not exist at the older ref — every
- *   declared dep is then reported as `"added"`.
- * @param after - Snapshot at the newer ref (typically the working tree).
- * @returns One {@link WorkspaceDependencyDiff} entry per workspace package
- *   that has at least one row. Packages with no changes are omitted.
- *
- * @public
- */
-declare function computeWorkspaceDependencyDiffs(beforeSnapshots: ReadonlyArray<WorkspaceSnapshot>, afterSnapshots: ReadonlyArray<WorkspaceSnapshot>): ReadonlyArray<WorkspaceDependencyDiff>;
-//#endregion
 //#region src/changesets/utils/dependency-table.d.ts
 /**
  * Serialize dependency table rows to a markdown table string.
@@ -5262,7 +5416,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, 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, 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, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown, snapshotFromWorktree };
+  export { AggregateDependencyTablesPlugin, AppliedRelease, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, 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, 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, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, resolveDiffRows, serializeDependencyTableToMarkdown, snapshotFromWorktree };
 }
 //#endregion
 //#region src/commitlint/config/schema.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/silk-effects",
-	"version": "1.5.2",
+	"version": "1.6.0",
 	"private": false,
 	"description": "Shared Effect library for Silk Suite conventions",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/silk-effects",
@@ -33,14 +33,14 @@
 		"@changesets/get-github-info": "^0.8.0",
 		"@changesets/get-release-plan": "^4.0.16",
 		"@manypkg/get-packages": "^1.1.3",
-		"jsonc-effect": "^0.2.1",
+		"jsonc-effect": "^0.3.0",
 		"mdast-util-heading-range": "^4.0.0",
 		"mdast-util-to-string": "^4.0.0",
 		"prettier": "^3.8.4",
 		"remark-gfm": "^4.0.1",
 		"remark-parse": "^11.0.0",
 		"remark-stringify": "^11.0.0",
-		"semver-effect": "^0.2.1",
+		"semver-effect": "^0.3.0",
 		"shell-quote": "^1.9.0",
 		"sort-package-json": "^4.0.0",
 		"tinyglobby": "^0.2.17",
@@ -49,7 +49,7 @@
 		"unist-util-visit": "^5.1.0",
 		"workspaces-effect": "^1.2.0",
 		"yaml": "^2.9.0",
-		"yaml-effect": "^0.6.0",
+		"yaml-effect": "^0.7.0",
 		"yaml-lint": "^1.7.0"
 	},
 	"peerDependencies": {