@savvy-web/silk-effects 1.3.1 → 1.4.0

package/changesets/errors.js

@@ -300,6 +300,30 @@ var GitError = class extends GitErrorBase {
 		return `git command failed in ${this.cwd}: ${this.command}\n${this.reason}`;
 	}
 };
+/**
+* Base class for {@link ReleasePlanError}.
+*
+* @privateRemarks
+* Required export for api-extractor (anonymous Data.TaggedError base). Do not delete.
+*
+* @internal
+*/
+const ReleasePlanErrorBase = Data.TaggedError("ReleasePlanError");
+/**
+* Release planning, preview, or apply failure.
+*
+* @remarks
+* Wraps any failure from the underlying `@changesets/*` machinery
+* (`getReleasePlan`, `applyReleasePlan`, config resolution) into a typed
+* Effect error, tagged with the phase that failed.
+*
+* @public
+*/
+var ReleasePlanError = class extends ReleasePlanErrorBase {
+	get message() {
+		return `Release plan error (${this.phase}): ${this.reason}`;
+	}
+};
 
 //#endregion
-export { ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, MarkdownParseError, MarkdownParseErrorBase, VersionFileError, VersionFileErrorBase };
+export { ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, MarkdownParseError, MarkdownParseErrorBase, ReleasePlanError, ReleasePlanErrorBase, VersionFileError, VersionFileErrorBase };

package/changesets/index.js

@@ -1,6 +1,6 @@
 import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import { Categories } from "./api/categories.js";
-import { ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, MarkdownParseError, MarkdownParseErrorBase, VersionFileError, VersionFileErrorBase } from "./errors.js";
+import { ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, MarkdownParseError, MarkdownParseErrorBase, ReleasePlanError, ReleasePlanErrorBase, VersionFileError, VersionFileErrorBase } from "./errors.js";
 import { JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, VersionFileConfigSchema, VersionFilesSchema } from "./schemas/version-files.js";
 import { GlobSchema, PackageScopeSchema, PackagesRecordSchema } from "./schemas/package-scope.js";
 import { ChangesetOptionsSchema, RepoSchema } from "./schemas/options.js";
@@ -28,13 +28,15 @@ 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 { 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 { VersionFiles } from "./utils/version-files.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";
@@ -49,11 +51,14 @@ import { SilkChangesetPreset, SilkChangesetTransformPreset } from "./remark/pres
 //#region src/changesets/index.ts
 var changesets_exports = /* @__PURE__ */ __exportAll({
 	AggregateDependencyTablesPlugin: () => AggregateDependencyTablesPlugin,
+	AppliedReleaseEntrySchema: () => AppliedReleaseEntrySchema,
+	AppliedReleaseSchema: () => AppliedReleaseSchema,
 	BranchAnalysisSchema: () => BranchAnalysisSchema,
 	BranchAnalyzer: () => BranchAnalyzer,
 	BranchAnalyzerBase: () => BranchAnalyzerBase,
 	BranchAnalyzerLive: () => BranchAnalyzerLive,
 	BranchFileEntrySchema: () => BranchFileEntrySchema,
+	BumpTypeSchema: () => BumpTypeSchema,
 	Categories: () => Categories,
 	Changelog: () => Changelog,
 	ChangelogService: () => ChangelogService,
@@ -61,6 +66,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	ChangelogTransformer: () => ChangelogTransformer,
 	ChangesetLinter: () => ChangesetLinter,
 	ChangesetOptionsSchema: () => ChangesetOptionsSchema,
+	ChangesetPreviewSchema: () => ChangesetPreviewSchema,
 	ChangesetSchema: () => ChangesetSchema,
 	ChangesetSummarySchema: () => ChangesetSummarySchema,
 	ChangesetValidationError: () => ChangesetValidationError,
@@ -116,7 +122,14 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	NormalizeFormatPlugin: () => NormalizeFormatPlugin,
 	PackageScopeSchema: () => PackageScopeSchema,
 	PackagesRecordSchema: () => PackagesRecordSchema,
+	PendingChangesetSchema: () => PendingChangesetSchema,
 	PositiveInteger: () => PositiveInteger,
+	PreviewReleaseSchema: () => PreviewReleaseSchema,
+	ReleasePlanError: () => ReleasePlanError,
+	ReleasePlanErrorBase: () => ReleasePlanErrorBase,
+	ReleasePlanner: () => ReleasePlanner,
+	ReleasePlannerBase: () => ReleasePlannerBase,
+	ReleasePlannerLive: () => ReleasePlannerLive,
 	ReorderSectionsPlugin: () => ReorderSectionsPlugin,
 	RepoSchema: () => RepoSchema,
 	RequiredSectionsRule: () => RequiredSectionsRule,
@@ -132,6 +145,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	VersionFileConfigSchema: () => VersionFileConfigSchema,
 	VersionFileError: () => VersionFileError,
 	VersionFileErrorBase: () => VersionFileErrorBase,
+	VersionFileUpdateRecordSchema: () => VersionFileUpdateRecordSchema,
 	VersionFiles: () => VersionFiles,
 	VersionFilesSchema: () => VersionFilesSchema,
 	VersionOrEmptySchema: () => VersionOrEmptySchema,
@@ -146,6 +160,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	makeBranchAnalyzerTest: () => makeBranchAnalyzerTest,
 	makeConfigInspectorTest: () => makeConfigInspectorTest,
 	makeGitHubTest: () => makeGitHubTest,
+	makeReleasePlannerTest: () => makeReleasePlannerTest,
 	serializeDependencyTableToMarkdown: () => serializeDependencyTableToMarkdown,
 	snapshotFromWorktree: () => snapshotFromWorktree
 });

package/changesets/schemas/release-plan.js

@@ -0,0 +1,57 @@
+import { Schema } from "effect";
+
+//#region src/changesets/schemas/release-plan.ts
+/**
+* Result schemas for the {@link ReleasePlanner} service — the structured
+* preview of pending releases and the result of a native apply.
+*
+* @packageDocumentation
+*/
+/** A semantic-version bump level (the `"none"` plan type is filtered out upstream). @public */
+const BumpTypeSchema = Schema.Literal("major", "minor", "patch");
+/** One package's previewed release: version transition + rendered changelog block. @public */
+const PreviewReleaseSchema = Schema.Struct({
+	name: Schema.String,
+	type: BumpTypeSchema,
+	oldVersion: Schema.String,
+	newVersion: Schema.String,
+	changesetIds: Schema.Array(Schema.String),
+	changelogEntry: Schema.String
+}).annotations({ identifier: "PreviewRelease" });
+/** A parsed pending changeset (id + summary + the packages it bumps). @public */
+const PendingChangesetSchema = Schema.Struct({
+	id: Schema.String,
+	summary: Schema.String,
+	releases: Schema.Array(Schema.Struct({
+		name: Schema.String,
+		type: BumpTypeSchema
+	}))
+}).annotations({ identifier: "PendingChangeset" });
+/** Read-only preview of what the next release would produce. @public */
+const ChangesetPreviewSchema = Schema.Struct({
+	preMode: Schema.NullOr(Schema.Literal("exit", "pre")),
+	releases: Schema.Array(PreviewReleaseSchema),
+	changesets: Schema.Array(PendingChangesetSchema)
+}).annotations({ identifier: "ChangesetPreview" });
+/** One applied package release (version transition). @public */
+const AppliedReleaseEntrySchema = Schema.Struct({
+	name: Schema.String,
+	type: BumpTypeSchema,
+	oldVersion: Schema.String,
+	newVersion: Schema.String
+}).annotations({ identifier: "AppliedReleaseEntry" });
+/** A single versionFiles update applied (or planned, when dry). @public */
+const VersionFileUpdateRecordSchema = Schema.Struct({
+	filePath: Schema.String,
+	version: Schema.String
+}).annotations({ identifier: "VersionFileUpdateRecord" });
+/** Result of {@link ReleasePlanner.apply}. @public */
+const AppliedReleaseSchema = Schema.Struct({
+	dryRun: Schema.Boolean,
+	touchedFiles: Schema.Array(Schema.String),
+	releases: Schema.Array(AppliedReleaseEntrySchema),
+	versionFileUpdates: Schema.Array(VersionFileUpdateRecordSchema)
+}).annotations({ identifier: "AppliedRelease" });
+
+//#endregion
+export { AppliedReleaseEntrySchema, AppliedReleaseSchema, BumpTypeSchema, ChangesetPreviewSchema, PendingChangesetSchema, PreviewReleaseSchema, VersionFileUpdateRecordSchema };

package/changesets/services/release-planner.js

@@ -0,0 +1,252 @@
+import { ReleasePlanError } from "../errors.js";
+import { ChangelogTransformer } from "../api/transformer.js";
+import { ConfigInspector } from "./config-inspector.js";
+import { VersionFiles } from "../utils/version-files.js";
+import { Context, Effect, Layer } from "effect";
+import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { isAbsolute, join, relative } from "node:path";
+import { tmpdir } from "node:os";
+import applyReleasePlan from "@changesets/apply-release-plan";
+import { read } from "@changesets/config";
+import getReleasePlan from "@changesets/get-release-plan";
+import { getPackages } from "@manypkg/get-packages";
+
+//#region src/changesets/services/release-planner.ts
+/**
+* `ReleasePlanner` service — drive the genuine changesets release engine to
+* compute a plan, render a read-only preview, or natively apply a release.
+*
+* @remarks
+* `preview` and `apply` both run the real `@changesets/apply-release-plan`;
+* `preview` redirects every write into a throwaway temp directory by handing
+* the engine a `@manypkg`-shaped `Packages` object whose `dir`s point at temp,
+* then reads the generated CHANGELOG blocks back. No changesets-internal logic
+* (e.g. `getChangelogEntry`) is re-implemented.
+*
+* @packageDocumentation
+*/
+/** Single workspace-discovery seam; swap to an Effect-native stack later here. */
+const buildPackages = (root) => getPackages(root);
+const errMsg = (e) => e instanceof Error ? e.message : String(e);
+const _tag = Context.Tag("ReleasePlanner");
+/**
+* Base class for {@link ReleasePlanner}.
+*
+* @privateRemarks Required export for api-extractor (anonymous Context.Tag base). Do not delete.
+* @internal
+*/
+const ReleasePlannerBase = _tag();
+/** Effect service tag for the release planner. @public */
+var ReleasePlanner = class extends ReleasePlannerBase {};
+/** Build the service shape over a resolved {@link ConfigInspector}. */
+function makeShape(inspector) {
+	const plan = (root) => Effect.tryPromise({
+		try: () => getReleasePlan(root),
+		catch: (e) => new ReleasePlanError({
+			phase: "plan",
+			reason: errMsg(e)
+		})
+	});
+	const preview = (root) => Effect.tryPromise({
+		try: () => previewImpl(root),
+		catch: (e) => new ReleasePlanError({
+			phase: "preview",
+			reason: errMsg(e)
+		})
+	});
+	const apply = (root, options) => applyEffect(root, options?.dryRun ?? false, inspector);
+	return {
+		plan,
+		preview,
+		apply
+	};
+}
+/** Production layer. Requires {@link ConfigInspector} (used by `apply`). @public */
+const ReleasePlannerLive = Layer.effect(ReleasePlanner, Effect.gen(function* () {
+	return makeShape(yield* ConfigInspector);
+}));
+/**
+* Test factory — supply fixed results for any subset of methods. Unsupplied
+* methods fail with a `ReleasePlanError`.
+*
+* @public
+*/
+function makeReleasePlannerTest(fixed) {
+	const fail = (phase) => Effect.fail(new ReleasePlanError({
+		phase,
+		reason: "not provided in test layer"
+	}));
+	return Layer.succeed(ReleasePlanner, {
+		plan: () => fixed.plan ? Effect.succeed(fixed.plan) : fail("plan"),
+		preview: () => fixed.preview ? Effect.succeed(fixed.preview) : fail("preview"),
+		apply: () => fixed.apply ? Effect.succeed(fixed.apply) : fail("apply")
+	});
+}
+/** Extract the `## <version>` block (down to the next H2 or EOF) from a changelog. */
+function extractVersionBlock(changelog, version) {
+	const lines = changelog.split("\n");
+	const start = lines.findIndex((l) => l.trim() === `## ${version}`);
+	if (start === -1) return "";
+	let end = lines.length;
+	for (let i = start + 1; i < lines.length; i++) if (/^## /.test(lines[i])) {
+		end = i;
+		break;
+	}
+	return lines.slice(start, end).join("\n").trim();
+}
+async function previewImpl(root) {
+	const [plan, packages] = await Promise.all([getReleasePlan(root), buildPackages(root)]);
+	const config = await read(root, packages);
+	const preMode = plan.preState ? plan.preState.mode : null;
+	const changesets = plan.changesets.map((cs) => ({
+		id: cs.id,
+		summary: cs.summary,
+		releases: cs.releases.filter((r) => r.type !== "none").map((r) => ({
+			name: r.name,
+			type: r.type
+		}))
+	}));
+	const releasesToRender = plan.releases.filter((r) => r.type !== "none");
+	if (releasesToRender.length === 0) return {
+		preMode,
+		releases: [],
+		changesets
+	};
+	const tempRoot = mkdtempSync(join(tmpdir(), "silk-preview-"));
+	try {
+		const mapDir = (dir) => {
+			const rel = relative(packages.root.dir, dir);
+			if (rel.startsWith("..") || isAbsolute(rel)) throw new Error(`Package directory is outside the workspace root: ${dir}`);
+			return join(tempRoot, rel);
+		};
+		const tempPackages = {
+			tool: packages.tool,
+			root: {
+				...packages.root,
+				dir: tempRoot,
+				packageJson: structuredClone(packages.root.packageJson)
+			},
+			packages: packages.packages.map((p) => ({
+				...p,
+				dir: mapDir(p.dir),
+				packageJson: structuredClone(p.packageJson)
+			}))
+		};
+		mkdirSync(join(tempRoot, ".changeset"), { recursive: true });
+		cpSync(join(root, "package.json"), join(tempRoot, "package.json"));
+		const preJson = join(root, ".changeset", "pre.json");
+		if (existsSync(preJson)) cpSync(preJson, join(tempRoot, ".changeset", "pre.json"));
+		for (const p of packages.packages) {
+			const tDir = mapDir(p.dir);
+			mkdirSync(tDir, { recursive: true });
+			cpSync(join(p.dir, "package.json"), join(tDir, "package.json"));
+			const realCl = join(p.dir, "CHANGELOG.md");
+			if (existsSync(realCl)) cpSync(realCl, join(tDir, "CHANGELOG.md"));
+		}
+		const rootCl = join(packages.root.dir, "CHANGELOG.md");
+		if (existsSync(rootCl)) cpSync(rootCl, join(tempRoot, "CHANGELOG.md"));
+		await applyReleasePlan(plan, tempPackages, config, void 0, root);
+		const dirByName = /* @__PURE__ */ new Map();
+		for (const p of tempPackages.packages) dirByName.set(p.packageJson.name, p.dir);
+		if (tempPackages.root.packageJson.name) dirByName.set(tempPackages.root.packageJson.name, tempRoot);
+		const releases = [];
+		for (const r of releasesToRender) {
+			const dir = dirByName.get(r.name);
+			if (!dir) continue;
+			const clPath = join(dir, "CHANGELOG.md");
+			if (!existsSync(clPath)) continue;
+			ChangelogTransformer.transformFile(clPath);
+			const content = readFileSync(clPath, "utf-8");
+			releases.push({
+				name: r.name,
+				type: r.type,
+				oldVersion: r.oldVersion,
+				newVersion: r.newVersion,
+				changesetIds: [...r.changesets],
+				changelogEntry: extractVersionBlock(content, r.newVersion)
+			});
+		}
+		return {
+			preMode,
+			releases,
+			changesets
+		};
+	} finally {
+		rmSync(tempRoot, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+/** Re-read a package's version from disk (post-bump) to feed versionFiles. */
+function diskVersion(workspaceDir, fallback) {
+	try {
+		return JSON.parse(readFileSync(join(workspaceDir, "package.json"), "utf-8")).version ?? fallback;
+	} catch {
+		return fallback;
+	}
+}
+function applyEffect(root, dryRun, inspector) {
+	return Effect.gen(function* () {
+		const { plan, packages, config } = yield* Effect.tryPromise({
+			try: async () => {
+				const [plan, packages] = await Promise.all([getReleasePlan(root), buildPackages(root)]);
+				return {
+					plan,
+					packages,
+					config: await read(root, packages)
+				};
+			},
+			catch: (e) => new ReleasePlanError({
+				phase: "apply",
+				reason: errMsg(e)
+			})
+		});
+		const releases = plan.releases.filter((r) => r.type !== "none").map((r) => ({
+			name: r.name,
+			type: r.type,
+			oldVersion: r.oldVersion,
+			newVersion: r.newVersion
+		}));
+		let touchedFiles = [];
+		if (!dryRun) touchedFiles = yield* Effect.tryPromise({
+			try: async () => {
+				const touched = await applyReleasePlan(plan, packages, config);
+				for (const f of touched) if (f.endsWith("CHANGELOG.md")) ChangelogTransformer.transformFile(f);
+				return touched;
+			},
+			catch: (e) => new ReleasePlanError({
+				phase: "apply",
+				reason: errMsg(e)
+			})
+		});
+		const newVersionByName = new Map(plan.releases.map((r) => [r.name, r.newVersion]));
+		const inspected = yield* inspector.inspect(root).pipe(Effect.catchAll((error) => Effect.logWarning(`Skipping versionFiles update: ${errMsg(error)}`).pipe(Effect.as(null))));
+		let versionFileUpdates = [];
+		if (inspected) versionFileUpdates = yield* Effect.try({
+			try: () => {
+				const scopes = inspected.packages.filter((p) => p.versionFiles.length > 0).map((p) => {
+					const fresh = dryRun ? newVersionByName.get(p.name) ?? p.version : diskVersion(p.workspaceDir, p.version);
+					return fresh !== p.version ? {
+						...p,
+						version: fresh
+					} : p;
+				});
+				return scopes.length > 0 ? VersionFiles.processResolvedVersionFiles(scopes, dryRun) : [];
+			},
+			catch: (e) => new ReleasePlanError({
+				phase: "apply",
+				reason: errMsg(e)
+			})
+		});
+		return {
+			dryRun,
+			touchedFiles,
+			releases,
+			versionFileUpdates
+		};
+	});
+}
+
+//#endregion
+export { ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, makeReleasePlannerTest };

package/index.d.ts

@@ -305,6 +305,11 @@ type Changeset$1 = {
 type NewChangeset = Changeset$1 & {
   id: string;
 };
+type ReleasePlan = {
+  changesets: NewChangeset[];
+  releases: ComprehensiveRelease[];
+  preState: PreState | undefined;
+};
 type PackageJSON = {
   name: string;
   version: string;
@@ -343,6 +348,14 @@ type ChangelogFunctions = {
   getReleaseLine: GetReleaseLine;
   getDependencyReleaseLine: GetDependencyReleaseLine;
 };
+type PreState = {
+  mode: "pre" | "exit";
+  tag: string;
+  initialVersions: {
+    [pkgName: string]: string;
+  };
+  changesets: string[];
+};
 //#endregion
 //#region src/changesets/api/changelog.d.ts
 /**
@@ -2482,6 +2495,33 @@ declare class GitError extends GitErrorBase<{
 }> {
   get message(): string;
 }
+/**
+ * Base class for {@link ReleasePlanError}.
+ *
+ * @privateRemarks
+ * Required export for api-extractor (anonymous Data.TaggedError base). Do not delete.
+ *
+ * @internal
+ */
+declare const ReleasePlanErrorBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ReleasePlanError";
+} & Readonly<A>;
+/**
+ * Release planning, preview, or apply failure.
+ *
+ * @remarks
+ * Wraps any failure from the underlying `@changesets/*` machinery
+ * (`getReleasePlan`, `applyReleasePlan`, config resolution) into a typed
+ * Effect error, tagged with the phase that failed.
+ *
+ * @public
+ */
+declare class ReleasePlanError extends ReleasePlanErrorBase<{
+  /** The phase that failed. */readonly phase: "plan" | "preview" | "apply"; /** Human-readable failure reason. */
+  readonly reason: string;
+}> {
+  get message(): string;
+}
 //#endregion
 //#region src/errors/ChangesetConfigError.d.ts
 declare const ChangesetConfigError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
@@ -3422,6 +3462,120 @@ declare const ChangelogServiceBase: Context.TagClass<ChangelogService, "Changelo
  */
 declare class ChangelogService extends ChangelogServiceBase {}
 //#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"]>;
+/** A semantic-version bump level. @public */
+type BumpType = Schema.Schema.Type<typeof BumpTypeSchema>;
+/** One package's previewed release: version transition + rendered changelog block. @public */
+declare const PreviewReleaseSchema: Schema.Struct<{
+  name: typeof Schema.String;
+  type: Schema.Literal<["major", "minor", "patch"]>;
+  oldVersion: typeof Schema.String;
+  newVersion: typeof Schema.String;
+  changesetIds: Schema.Array$<typeof Schema.String>;
+  changelogEntry: typeof Schema.String;
+}>;
+/** One package's previewed release. @public */
+type PreviewRelease = Schema.Schema.Type<typeof PreviewReleaseSchema>;
+/** A parsed pending changeset (id + summary + the packages it bumps). @public */
+declare const PendingChangesetSchema: Schema.Struct<{
+  id: typeof Schema.String;
+  summary: typeof Schema.String;
+  releases: Schema.Array$<Schema.Struct<{
+    name: typeof Schema.String;
+    type: Schema.Literal<["major", "minor", "patch"]>;
+  }>>;
+}>;
+/** A parsed pending changeset. @public */
+type PendingChangeset = Schema.Schema.Type<typeof PendingChangesetSchema>;
+/** Read-only preview of what the next release would produce. @public */
+declare const ChangesetPreviewSchema: Schema.Struct<{
+  preMode: Schema.NullOr<Schema.Literal<["exit", "pre"]>>;
+  releases: Schema.Array$<Schema.Struct<{
+    name: typeof Schema.String;
+    type: Schema.Literal<["major", "minor", "patch"]>;
+    oldVersion: typeof Schema.String;
+    newVersion: typeof Schema.String;
+    changesetIds: Schema.Array$<typeof Schema.String>;
+    changelogEntry: typeof Schema.String;
+  }>>;
+  changesets: Schema.Array$<Schema.Struct<{
+    id: typeof Schema.String;
+    summary: typeof Schema.String;
+    releases: Schema.Array$<Schema.Struct<{
+      name: typeof Schema.String;
+      type: Schema.Literal<["major", "minor", "patch"]>;
+    }>>;
+  }>>;
+}>;
+/** Read-only preview of what the next release would produce. @public */
+type ChangesetPreview = Schema.Schema.Type<typeof ChangesetPreviewSchema>;
+/** One applied package release (version transition). @public */
+declare const AppliedReleaseEntrySchema: Schema.Struct<{
+  name: typeof Schema.String;
+  type: Schema.Literal<["major", "minor", "patch"]>;
+  oldVersion: typeof Schema.String;
+  newVersion: typeof Schema.String;
+}>;
+/** A single versionFiles update applied (or planned, when dry). @public */
+declare const VersionFileUpdateRecordSchema: Schema.Struct<{
+  filePath: typeof Schema.String;
+  version: typeof Schema.String;
+}>;
+/** Result of {@link ReleasePlanner.apply}. @public */
+declare const AppliedReleaseSchema: Schema.Struct<{
+  dryRun: typeof Schema.Boolean;
+  touchedFiles: Schema.Array$<typeof Schema.String>;
+  releases: Schema.Array$<Schema.Struct<{
+    name: typeof Schema.String;
+    type: Schema.Literal<["major", "minor", "patch"]>;
+    oldVersion: typeof Schema.String;
+    newVersion: typeof Schema.String;
+  }>>;
+  versionFileUpdates: Schema.Array$<Schema.Struct<{
+    filePath: typeof Schema.String;
+    version: typeof Schema.String;
+  }>>;
+}>;
+/** Result of a native apply. @public */
+type AppliedRelease = Schema.Schema.Type<typeof AppliedReleaseSchema>;
+//#endregion
+//#region src/changesets/services/release-planner.d.ts
+/** The `ReleasePlanner` service surface. @public */
+interface ReleasePlannerShape {
+  /** Compute the in-memory release plan (read-only). */
+  readonly plan: (root: string) => Effect.Effect<ReleasePlan, ReleasePlanError>;
+  /** Render a non-destructive preview of the next release. */
+  readonly preview: (root: string) => Effect.Effect<ChangesetPreview, ReleasePlanError>;
+  /** Natively apply the release (destructive unless `dryRun`). */
+  readonly apply: (root: string, options?: {
+    readonly dryRun?: boolean;
+  }) => Effect.Effect<AppliedRelease, ReleasePlanError>;
+}
+/**
+ * Base class for {@link ReleasePlanner}.
+ *
+ * @privateRemarks Required export for api-extractor (anonymous Context.Tag base). Do not delete.
+ * @internal
+ */
+declare const ReleasePlannerBase: Context.TagClass<ReleasePlanner, "ReleasePlanner", ReleasePlannerShape>;
+/** Effect service tag for the release planner. @public */
+declare class ReleasePlanner extends ReleasePlannerBase {}
+/** Production layer. Requires {@link ConfigInspector} (used by `apply`). @public */
+declare const ReleasePlannerLive: Layer.Layer<ReleasePlanner, never, ConfigInspector>;
+/**
+ * Test factory — supply fixed results for any subset of methods. Unsupplied
+ * methods fail with a `ReleasePlanError`.
+ *
+ * @public
+ */
+declare function makeReleasePlannerTest(fixed: {
+  readonly plan?: ReleasePlan;
+  readonly preview?: ChangesetPreview;
+  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.
@@ -5090,7 +5244,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, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, 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, PositiveInteger, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, 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, 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 };
 }
 //#endregion
 //#region src/commitlint/config/schema.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/silk-effects",
-	"version": "1.3.1",
+	"version": "1.4.0",
 	"private": false,
 	"description": "Shared Effect library for Silk Suite conventions",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/silk-effects",
@@ -28,7 +28,11 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
+		"@changesets/apply-release-plan": "^7.1.1",
+		"@changesets/config": "^3.1.4",
 		"@changesets/get-github-info": "^0.8.0",
+		"@changesets/get-release-plan": "^4.0.16",
+		"@manypkg/get-packages": "^1.1.3",
 		"jsonc-effect": "^0.2.1",
 		"mdast-util-heading-range": "^4.0.0",
 		"mdast-util-to-string": "^4.0.0",