@savvy-web/silk 1.3.7 → 1.3.9

package/packages/silk-effects/dist/dev/pkg/changesets/services/deps-regen.js

@@ -1,13 +1,21 @@
+import { ChangesetConfigReaderLive } from "../../services/ChangesetConfigReader.js";
+import { ChangesetConfig, ChangesetConfigLive } from "../../services/ChangesetConfig.js";
+import { WorkspaceDiscovery } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/services/WorkspaceDiscovery.js";
+import { PointInTimeWorkspace } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/services/PointInTimeWorkspace.js";
+import { PointInTimeWorkspaceLive } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/layers/PointInTimeWorkspaceLive.js";
+import { PublishabilityDetector } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/services/PublishabilityDetector.js";
+import { WorkspaceDiscoveryLive } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/layers/WorkspaceDiscoveryLive.js";
+import { WorkspaceRootLive } from "../../../../../../../node_modules/.pnpm/workspaces-effect@2.0.1_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/layers/WorkspaceRootLive.js";
+import { PublishabilityDetectorAdaptiveLive } from "../../services/SilkPublishability.js";
+import { ChangesetIOError } from "../errors.js";
 import { serializeDependencyTableToMarkdown, sortDependencyRows } from "../utils/dependency-table.js";
-import { CatalogResolver, PublishabilityDetector, WorkspaceDiscovery } from "../../../../../../../node_modules/.pnpm/workspaces-effect@1.2.0_@effect_platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/index.js";
-import { ConfigInspector } from "./config-inspector.js";
+import { ConfigInspector, ConfigInspectorLive } from "./config-inspector.js";
 import { computeWorkspaceDependencyDiffs } from "../utils/dep-diff.js";
+import { gitMergeBase } from "../utils/git.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 { FileSystem } from "@effect/platform";
 import { join, resolve } from "node:path";
-import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
 
 //#region ../silk-effects/dist/dev/pkg/changesets/services/deps-regen.js
 /**
@@ -17,9 +25,11 @@ import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from
 *
 * @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}
+* tree by default, or between two explicit refs) by snapshotting both
+* sides through `PointInTimeWorkspace`, which resolves `catalog:` /
+* `workspace:` specifiers against each ref's own catalogs and package
+* versions before diffing. It 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
@@ -32,41 +42,6 @@ import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from
 * @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",
@@ -110,30 +85,35 @@ function pickRandomTriplet() {
 * 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.
+* never writes to disk, so an on-disk existence check 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 fileExists - Effectful on-disk existence check (never fails; a
+*   filesystem error is treated as "does not exist" so filename selection
+*   degrades gracefully rather than blocking the plan).
+* @param changesetDir - Directory checked 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;
+function randomFilename(fileExists, changesetDir, chosen) {
+	return Effect.gen(function* () {
+		for (let i = 0; i < 20; i++) {
+			const candidate = pickRandomTriplet();
+			if (!chosen.has(candidate) && !(yield* fileExists(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;
+		let attempt = 0;
+		let fallback = `${pickRandomTriplet()}-${Date.now()}`;
+		while (chosen.has(fallback) || (yield* fileExists(join(changesetDir, `${fallback}.md`)))) fallback = `${pickRandomTriplet()}-${Date.now()}-${++attempt}`;
+		chosen.add(fallback);
+		return fallback;
+	});
 }
 /**
 * Strict detection of "pure dependency changesets" per the documented
@@ -184,43 +164,59 @@ function isPureDependencyChangeset(content) {
 		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) {
+/**
+* List `.changeset/*.md` files (excluding `README.md`) in `changesetDir`.
+* A missing directory is today's behavior for "no changesets yet" and
+* resolves to an empty list; any OTHER failure (e.g. a directory that
+* exists but cannot be read) is a loud {@link ChangesetIOError} — an
+* unreadable `.changeset` dir must not silently masquerade as "no
+* changesets".
+*/
+const listChangesetFiles = (fs, changesetDir) => fs.readDirectory(changesetDir).pipe(Effect.map((names) => names.filter((f) => f.endsWith(".md") && f !== "README.md").map((f) => join(changesetDir, f))), Effect.catchAll((e) => e._tag === "SystemError" && e.reason === "NotFound" ? Effect.succeed([]) : Effect.fail(new ChangesetIOError({
+	path: changesetDir,
+	operation: "list",
+	reason: String(e)
+}))));
+/**
+* Pure-dependency changesets found in `changesetDir`. An individual file
+* that cannot be read (e.g. removed mid-scan, permission race) is skipped —
+* today's semantics — while a failure to list the directory itself
+* propagates as a loud {@link ChangesetIOError}.
+*/
+const findPureDependencyChangesets = (fs, changesetDir) => Effect.gen(function* () {
+	const files = yield* listChangesetFiles(fs, changesetDir);
 	const result = [];
-	for (const file of listChangesetFiles(changesetDir)) {
-		let content;
-		try {
-			content = readFileSync(file, "utf8");
-		} catch {
-			continue;
-		}
-		const detection = isPureDependencyChangeset(content);
+	for (const file of files) {
+		const content = yield* fs.readFileString(file).pipe(Effect.option);
+		if (Option.isNone(content)) continue;
+		const detection = isPureDependencyChangeset(content.value);
 		if (detection.isPure && detection.package) result.push({
 			file,
 			package: detection.package
 		});
 	}
 	return result;
-}
-function findMixedDependencyChangesets(changesetDir) {
+});
+/**
+* Mixed dependency changesets (have a `## Dependencies` heading but fail
+* the strict pure-changeset test) found in `changesetDir`. Same
+* skip-unreadable-file / loud-list-failure semantics as
+* {@link findPureDependencyChangesets}.
+*/
+const findMixedDependencyChangesets = (fs, changesetDir) => Effect.gen(function* () {
+	const files = yield* listChangesetFiles(fs, 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);
+	for (const file of files) {
+		const content = yield* fs.readFileString(file).pipe(Effect.option);
+		if (Option.isNone(content)) continue;
+		if (/^## Dependencies\b/m.test(content.value) && !isPureDependencyChangeset(content.value).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}.
+* Render a single-package, patch-bump changeset for a diff whose rows are
+* already resolved (per-side, inside {@link computeWorkspaceDependencyDiffs})
+* and devDep-filtered.
 */
 function renderChangesetContent(diff) {
 	return `${`---\n"${diff.package}": patch\n---`}\n\n## Dependencies\n\n${serializeDependencyTableToMarkdown([...diff.rows])}\n`;
@@ -252,9 +248,9 @@ var DepsRegen = class extends DepsRegenBase {};
 * implementations, keeping the public `plan`/`execute` signatures
 * requirement-free (`R = never`).
 */
-function makeShape(reader, inspector, discovery, resolver, detector) {
-	const provideResolver = Layer.succeed(CatalogResolver, resolver);
+function makeShape(pit, inspector, discovery, detector, config, fs) {
 	const provideDetector = Layer.succeed(PublishabilityDetector, detector);
+	const fileExists = (p) => fs.exists(p).pipe(Effect.orElseSucceed(() => false));
 	const plan = (options) => Effect.gen(function* () {
 		const resolvedCwd = resolve(options.cwd);
 		const changesetDir = join(resolvedCwd, ".changeset");
@@ -264,41 +260,58 @@ function makeShape(reader, inspector, discovery, resolver, detector) {
 			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 rawDiffs = computeWorkspaceDependencyDiffs(yield* pit.at(fromRef, { cwd: resolvedCwd }), options.to ? yield* pit.at(options.to, { cwd: resolvedCwd }) : yield* pit.worktree({ cwd: resolvedCwd }));
 		const targetPkg = options.package;
-		const publishable = yield* listPublishablePackageNames(yield* discovery.listPackages(resolvedCwd)).pipe(Effect.provide(provideDetector));
+		const livePackages = yield* discovery.listPackages(resolvedCwd);
+		const publishable = yield* listPublishablePackageNames(livePackages, resolvedCwd).pipe(Effect.provide(provideDetector));
+		const versionPrivate = yield* config.versionPrivate(resolvedCwd);
+		const inScope = /* @__PURE__ */ new Set();
+		for (const pkg of livePackages) {
+			if (yield* config.isIgnored(pkg.name, resolvedCwd)) continue;
+			if (publishable.has(pkg.name) || versionPrivate) inScope.add(pkg.name);
+		}
+		const targetIgnored = targetPkg ? yield* config.isIgnored(targetPkg, resolvedCwd) : false;
 		const keepDevDeps = options.includeDevDeps === true;
-		const scoped = targetPkg ? rawDiffs.filter((d) => d.package === targetPkg) : rawDiffs.filter((d) => publishable.has(d.package));
+		const scoped = targetPkg ? targetIgnored ? [] : rawDiffs.filter((d) => d.package === targetPkg) : rawDiffs.filter((d) => inScope.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 rows = keepDevDeps ? [...diff.rows] : diff.rows.filter((r) => r.type !== "devDependency");
+			if (rows.length > 0) resolved.push({
+				...diff,
+				rows: sortDependencyRows(rows)
+			});
 		}
-		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 existingPure = yield* findPureDependencyChangesets(fs, changesetDir);
+		const skippedMixed = yield* findMixedDependencyChangesets(fs, changesetDir);
+		const toDelete = targetPkg ? targetIgnored ? [] : existingPure.filter((p) => p.package === targetPkg) : existingPure.filter((p) => inScope.has(p.package));
 		const chosenFilenames = /* @__PURE__ */ new Set();
-		return {
-			toDelete,
-			toWrite: resolved.map((diff) => ({
-				file: join(changesetDir, `${randomFilename(changesetDir, chosenFilenames)}.md`),
+		const toWrite = [];
+		for (const diff of resolved) {
+			const filename = yield* randomFilename(fileExists, changesetDir, chosenFilenames);
+			toWrite.push({
+				file: join(changesetDir, `${filename}.md`),
 				package: diff.package,
 				diff
-			})),
+			});
+		}
+		return {
+			toDelete,
+			toWrite,
 			skippedMixed
 		};
 	});
-	const execute = (plan) => Effect.sync(() => {
+	const execute = (plan) => Effect.gen(function* () {
 		const deleted = [];
 		const written = [];
 		for (const entry of plan.toWrite) {
-			writeFileSync(entry.file, renderChangesetContent(entry.diff));
+			yield* fs.writeFileString(entry.file, renderChangesetContent(entry.diff)).pipe(Effect.mapError((e) => new ChangesetIOError({
+				path: entry.file,
+				operation: "write",
+				reason: String(e)
+			})));
 			written.push(entry.file);
 		}
-		for (const entry of plan.toDelete) try {
-			unlinkSync(entry.file);
-			deleted.push(entry.file);
-		} catch {}
+		for (const entry of plan.toDelete) if (yield* Effect.isSuccess(fs.remove(entry.file))) deleted.push(entry.file);
 		return {
 			deleted,
 			written,
@@ -313,15 +326,46 @@ function makeShape(reader, inspector, discovery, resolver, detector) {
 /**
 * Live layer for {@link DepsRegen}.
 *
-* Requires {@link WorkspaceSnapshotReader}, {@link ConfigInspector},
-* `WorkspaceDiscovery`, `CatalogResolver`, and `PublishabilityDetector`
-* (the last three from `workspaces-effect`).
+* Requires `PointInTimeWorkspace`, `WorkspaceDiscovery`,
+* `PublishabilityDetector` (all from `workspaces-effect`),
+* {@link ConfigInspector}, {@link ChangesetConfig}, and
+* `FileSystem.FileSystem` (resolved once at construction and closed over by
+* the shape, keeping `plan`/`execute` themselves requirement-free).
 *
 * @public
 */
 const DepsRegenLive = Layer.effect(DepsRegen, Effect.gen(function* () {
-	return makeShape(yield* WorkspaceSnapshotReader, yield* ConfigInspector, yield* WorkspaceDiscovery, yield* CatalogResolver, yield* PublishabilityDetector);
+	return makeShape(yield* PointInTimeWorkspace, yield* ConfigInspector, yield* WorkspaceDiscovery, yield* PublishabilityDetector, yield* ChangesetConfig, yield* FileSystem.FileSystem);
 }));
+const WorkspaceGraph = Layer.mergeAll(WorkspaceRootLive, WorkspaceDiscoveryLive.pipe(Layer.provide(WorkspaceRootLive)));
+const ConfigGraph = ChangesetConfigLive.pipe(Layer.provide(ChangesetConfigReaderLive));
+/**
+* Batteries-included {@link DepsRegen} layer: silk's opinionated default
+* composition of the full dependency graph. Only the platform services
+* remain — note that {@link PointInTimeWorkspace} reads git history, so
+* this layer genuinely requires `CommandExecutor` in addition to
+* `FileSystem`/`Path`: provide a git-capable platform layer
+* (`NodeContext.layer`), not a bare filesystem-only layer.
+*
+* Gating uses silk's adaptive publishability detector
+* ({@link PublishabilityDetectorAdaptiveLive}), so the default semantics
+* are "versionable minus ignored" — identical to the savvy CLI and MCP
+* runtimes. Consumers who need to swap any dependency (test detectors,
+* alternate config sources) should keep composing {@link DepsRegenLive}
+* directly; this layer is purely additive.
+*
+* @example
+* ```typescript
+* import { NodeContext } from "@effect/platform-node";
+* import { Layer } from "effect";
+* import { Changesets } from "@savvy-web/silk-effects";
+*
+* const depsRegen = Changesets.DepsRegenDefault.pipe(Layer.provide(NodeContext.layer));
+* ```
+*
+* @public
+*/
+const DepsRegenDefault = DepsRegenLive.pipe(Layer.provide(PointInTimeWorkspaceLive.pipe(Layer.provide(WorkspaceGraph))), Layer.provide(ConfigInspectorLive.pipe(Layer.provide(Layer.mergeAll(ChangesetConfigReaderLive, WorkspaceGraph)))), Layer.provide(PublishabilityDetectorAdaptiveLive.pipe(Layer.provide(ConfigGraph))), Layer.provide(ConfigGraph), Layer.provide(WorkspaceGraph));
 
 //#endregion
-export { DepsRegen, DepsRegenBase, DepsRegenLive, isPureDependencyChangeset, resolveDiffRows };
+export { DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, isPureDependencyChangeset };

package/packages/silk-effects/dist/dev/pkg/changesets/services/release-planner.cjs

@@ -7,9 +7,8 @@ const require_changesets_config_esm = require('../../../../../../../node_modules
 const require_changesets_apply_release_plan_esm = require('../../../../../../../node_modules/.pnpm/@changesets_apply-release-plan@7.1.1/node_modules/@changesets/apply-release-plan/dist/changesets-apply-release-plan.esm.cjs');
 const require_changesets_get_release_plan_esm = require('../../../../../../../node_modules/.pnpm/@changesets_get-release-plan@4.0.16/node_modules/@changesets/get-release-plan/dist/changesets-get-release-plan.esm.cjs');
 let effect = require("effect");
+let _effect_platform = require("@effect/platform");
 let node_path = require("node:path");
-let node_fs = require("node:fs");
-let node_os = require("node:os");
 
 //#region ../silk-effects/dist/dev/pkg/changesets/services/release-planner.js
 var import_get_packages_cjs = require_get_packages_cjs$1.default;
@@ -37,8 +36,8 @@ const errMsg = (e) => e instanceof Error ? e.message : String(e);
 const ReleasePlannerBase = effect.Context.Tag("ReleasePlanner")();
 /** 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) {
+/** Build the service shape over a resolved {@link ConfigInspector} and {@link FileSystem.FileSystem}. */
+function makeShape(inspector, fs) {
 	const plan = (root) => effect.Effect.tryPromise({
 		try: () => require_changesets_get_release_plan_esm.default(root),
 		catch: (e) => new require_errors.ReleasePlanError({
@@ -46,23 +45,17 @@ function makeShape(inspector) {
 			reason: errMsg(e)
 		})
 	});
-	const preview = (root) => effect.Effect.tryPromise({
-		try: () => previewImpl(root),
-		catch: (e) => new require_errors.ReleasePlanError({
-			phase: "preview",
-			reason: errMsg(e)
-		})
-	});
-	const apply = (root, options) => applyEffect(root, options?.dryRun ?? false, inspector);
+	const preview = (root) => previewEffect(root, fs);
+	const apply = (root, options) => applyEffect(root, options?.dryRun ?? false, inspector, fs);
 	return {
 		plan,
 		preview,
 		apply
 	};
 }
-/** Production layer. Requires {@link ConfigInspector} (used by `apply`). @public */
+/** Production layer. Requires {@link ConfigInspector} (used by `apply`) and `FileSystem`. @public */
 const ReleasePlannerLive = effect.Layer.effect(ReleasePlanner, effect.Effect.gen(function* () {
-	return makeShape(yield* require_config_inspector.ConfigInspector);
+	return makeShape(yield* require_config_inspector.ConfigInspector, yield* _effect_platform.FileSystem.FileSystem);
 }));
 /**
 * Test factory — supply fixed results for any subset of methods. Unsupplied
@@ -93,31 +86,52 @@ function extractVersionBlock(changelog, version) {
 	}
 	return lines.slice(start, end).join("\n").trim();
 }
-async function previewImpl(root) {
-	const [plan, packages] = await Promise.all([require_changesets_get_release_plan_esm.default(root), buildPackages(root)]);
-	const config = await require_changesets_config_esm.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 = (0, node_fs.mkdtempSync)((0, node_path.join)((0, node_os.tmpdir)(), "silk-preview-"));
-	try {
+/**
+* Render a non-destructive preview by redirecting every write into a
+* scope-managed temp directory (cleaned up automatically when the scope
+* closes) and reading the generated CHANGELOG blocks back.
+*/
+function previewEffect(root, fs) {
+	const program = effect.Effect.gen(function* () {
+		const [plan, packages] = yield* effect.Effect.tryPromise({
+			try: () => Promise.all([require_changesets_get_release_plan_esm.default(root), buildPackages(root)]),
+			catch: (e) => new require_errors.ReleasePlanError({
+				phase: "preview",
+				reason: errMsg(e)
+			})
+		});
+		const config = yield* effect.Effect.tryPromise({
+			try: () => require_changesets_config_esm.read(root, packages),
+			catch: (e) => new require_errors.ReleasePlanError({
+				phase: "preview",
+				reason: errMsg(e)
+			})
+		});
+		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 = yield* fs.makeTempDirectoryScoped({ prefix: "silk-preview-" });
 		const mapDir = (dir) => {
 			const rel = (0, node_path.relative)(packages.root.dir, dir);
-			if (rel.startsWith("..") || (0, node_path.isAbsolute)(rel)) throw new Error(`Package directory is outside the workspace root: ${dir}`);
-			return (0, node_path.join)(tempRoot, rel);
+			if (rel.startsWith("..") || (0, node_path.isAbsolute)(rel)) return effect.Effect.fail(new require_errors.ReleasePlanError({
+				phase: "preview",
+				reason: `Package directory is outside the workspace root: ${dir}`
+			}));
+			return effect.Effect.succeed((0, node_path.join)(tempRoot, rel));
 		};
+		const tempDirs = yield* effect.Effect.forEach(packages.packages, (p) => mapDir(p.dir));
 		const tempPackages = {
 			tool: packages.tool,
 			root: {
@@ -125,26 +139,33 @@ async function previewImpl(root) {
 				dir: tempRoot,
 				packageJson: structuredClone(packages.root.packageJson)
 			},
-			packages: packages.packages.map((p) => ({
+			packages: packages.packages.map((p, i) => ({
 				...p,
-				dir: mapDir(p.dir),
+				dir: tempDirs[i],
 				packageJson: structuredClone(p.packageJson)
 			}))
 		};
-		(0, node_fs.mkdirSync)((0, node_path.join)(tempRoot, ".changeset"), { recursive: true });
-		(0, node_fs.cpSync)((0, node_path.join)(root, "package.json"), (0, node_path.join)(tempRoot, "package.json"));
+		yield* fs.makeDirectory((0, node_path.join)(tempRoot, ".changeset"), { recursive: true });
+		yield* fs.copyFile((0, node_path.join)(root, "package.json"), (0, node_path.join)(tempRoot, "package.json"));
 		const preJson = (0, node_path.join)(root, ".changeset", "pre.json");
-		if ((0, node_fs.existsSync)(preJson)) (0, node_fs.cpSync)(preJson, (0, node_path.join)(tempRoot, ".changeset", "pre.json"));
-		for (const p of packages.packages) {
-			const tDir = mapDir(p.dir);
-			(0, node_fs.mkdirSync)(tDir, { recursive: true });
-			(0, node_fs.cpSync)((0, node_path.join)(p.dir, "package.json"), (0, node_path.join)(tDir, "package.json"));
+		if (yield* fs.exists(preJson)) yield* fs.copyFile(preJson, (0, node_path.join)(tempRoot, ".changeset", "pre.json"));
+		for (let i = 0; i < packages.packages.length; i++) {
+			const p = packages.packages[i];
+			const tDir = tempDirs[i];
+			yield* fs.makeDirectory(tDir, { recursive: true });
+			yield* fs.copyFile((0, node_path.join)(p.dir, "package.json"), (0, node_path.join)(tDir, "package.json"));
 			const realCl = (0, node_path.join)(p.dir, "CHANGELOG.md");
-			if ((0, node_fs.existsSync)(realCl)) (0, node_fs.cpSync)(realCl, (0, node_path.join)(tDir, "CHANGELOG.md"));
+			if (yield* fs.exists(realCl)) yield* fs.copyFile(realCl, (0, node_path.join)(tDir, "CHANGELOG.md"));
 		}
 		const rootCl = (0, node_path.join)(packages.root.dir, "CHANGELOG.md");
-		if ((0, node_fs.existsSync)(rootCl)) (0, node_fs.cpSync)(rootCl, (0, node_path.join)(tempRoot, "CHANGELOG.md"));
-		await require_changesets_apply_release_plan_esm.default(plan, tempPackages, config, void 0, root);
+		if (yield* fs.exists(rootCl)) yield* fs.copyFile(rootCl, (0, node_path.join)(tempRoot, "CHANGELOG.md"));
+		yield* effect.Effect.tryPromise({
+			try: () => require_changesets_apply_release_plan_esm.default(plan, tempPackages, config, void 0, root),
+			catch: (e) => new require_errors.ReleasePlanError({
+				phase: "preview",
+				reason: errMsg(e)
+			})
+		});
 		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);
@@ -153,9 +174,15 @@ async function previewImpl(root) {
 			const dir = dirByName.get(r.name);
 			if (!dir) continue;
 			const clPath = (0, node_path.join)(dir, "CHANGELOG.md");
-			if (!(0, node_fs.existsSync)(clPath)) continue;
-			require_transformer.ChangelogTransformer.transformFile(clPath);
-			const content = (0, node_fs.readFileSync)(clPath, "utf-8");
+			if (!(yield* fs.exists(clPath))) continue;
+			yield* effect.Effect.try({
+				try: () => require_transformer.ChangelogTransformer.transformFile(clPath),
+				catch: (e) => new require_errors.ReleasePlanError({
+					phase: "preview",
+					reason: errMsg(e)
+				})
+			});
+			const content = yield* fs.readFileString(clPath);
 			releases.push({
 				name: r.name,
 				type: r.type,
@@ -170,22 +197,17 @@ async function previewImpl(root) {
 			releases,
 			changesets
 		};
-	} finally {
-		(0, node_fs.rmSync)(tempRoot, {
-			recursive: true,
-			force: true
-		});
-	}
+	});
+	return effect.Effect.scoped(program).pipe(effect.Effect.mapError((e) => e instanceof require_errors.ReleasePlanError ? e : new require_errors.ReleasePlanError({
+		phase: "preview",
+		reason: errMsg(e)
+	})));
 }
-/** Re-read a package's version from disk (post-bump) to feed versionFiles. */
-function diskVersion(workspaceDir, fallback) {
-	try {
-		return JSON.parse((0, node_fs.readFileSync)((0, node_path.join)(workspaceDir, "package.json"), "utf-8")).version ?? fallback;
-	} catch {
-		return fallback;
-	}
+/** Re-read a package's version from disk (post-bump) to feed versionFiles; unreadable/unparseable falls back. */
+function diskVersion(workspaceDir, fallback, fs) {
+	return fs.readFileString((0, node_path.join)(workspaceDir, "package.json")).pipe(effect.Effect.flatMap((raw) => effect.Effect.try(() => JSON.parse(raw).version ?? fallback)), effect.Effect.orElseSucceed(() => fallback));
 }
-function applyEffect(root, dryRun, inspector) {
+function applyEffect(root, dryRun, inspector, fs) {
 	return effect.Effect.gen(function* () {
 		const { plan, packages, config } = yield* effect.Effect.tryPromise({
 			try: async () => {
@@ -222,22 +244,24 @@ function applyEffect(root, dryRun, inspector) {
 		const newVersionByName = new Map(plan.releases.map((r) => [r.name, r.newVersion]));
 		const inspected = yield* inspector.inspect(root).pipe(effect.Effect.catchAll((error) => effect.Effect.logWarning(`Skipping versionFiles update: ${errMsg(error)}`).pipe(effect.Effect.as(null))));
 		let versionFileUpdates = [];
-		if (inspected) versionFileUpdates = yield* effect.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 ? require_version_files.VersionFiles.processResolvedVersionFiles(scopes, dryRun) : [];
-			},
-			catch: (e) => new require_errors.ReleasePlanError({
-				phase: "apply",
-				reason: errMsg(e)
-			})
-		});
+		if (inspected) {
+			const candidates = inspected.packages.filter((p) => p.versionFiles.length > 0);
+			const freshVersions = yield* effect.Effect.forEach(candidates, (p) => dryRun ? effect.Effect.succeed(newVersionByName.get(p.name) ?? p.version) : diskVersion(p.workspaceDir, p.version, fs));
+			const scopes = candidates.map((p, i) => {
+				const fresh = freshVersions[i];
+				return fresh !== p.version ? {
+					...p,
+					version: fresh
+				} : p;
+			});
+			versionFileUpdates = yield* effect.Effect.try({
+				try: () => scopes.length > 0 ? require_version_files.VersionFiles.processResolvedVersionFiles(scopes, dryRun) : [],
+				catch: (e) => new require_errors.ReleasePlanError({
+					phase: "apply",
+					reason: errMsg(e)
+				})
+			});
+		}
 		return {
 			dryRun,
 			touchedFiles,