@savvy-web/silk-effects 1.5.1 → 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 };