@savvy-web/silk-effects 3.3.0 → 4.0.0

package/changesets/services/deps-regen.js

@@ -7,24 +7,24 @@ import { ConfigInspector, ConfigInspectorLive } from "./config-inspector.js";
 import { computeWorkspaceDependencyDiffs } from "../utils/dep-diff.js";
 import { gitListChangesetFilesAtRef, gitMergeBase } from "../utils/git.js";
 import { listPublishablePackageNames } from "../utils/publishability.js";
-import { Context, Effect, Layer, Option } from "effect";
+import { Context, Effect, FileSystem, Layer, Option } from "effect";
 import { basename, join, resolve } from "node:path";
-import { FileSystem } from "@effect/platform";
-import { PointInTimeWorkspace, PointInTimeWorkspaceLive, PublishabilityDetector, WorkspaceDiscovery, WorkspaceDiscoveryLive, WorkspaceRootLive } from "workspaces-effect";
+import { Git } from "@effected/git";
+import { PublishabilityDetector, WorkspaceDiscovery, WorkspaceSnapshots, Workspaces } from "@effected/workspaces";
 
 //#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
+* orchestration out of the CLI into a `Context.Service` with a
 * `plan()` / `execute()` split.
 *
 * @remarks
 * `plan()` computes the cumulative dependency diff (merge-base → working
 * 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}
+* sides through `@effected/workspaces`' `WorkspaceSnapshots`, 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
@@ -176,7 +176,7 @@ function isPureDependencyChangeset(content) {
 * 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({
+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.catch((e) => e._tag === "PlatformError" && e.reason._tag === "NotFound" ? Effect.succeed([]) : Effect.fail(new ChangesetIOError({
 	path: changesetDir,
 	operation: "list",
 	reason: String(e)
@@ -225,11 +225,6 @@ const findMixedDependencyChangesets = (fs, changesetDir) => Effect.gen(function*
 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}.
 *
@@ -247,13 +242,13 @@ const DepsRegenBase = _tag();
 *
 * @public
 */
-var DepsRegen = class extends DepsRegenBase {};
+var DepsRegen = class extends Context.Service()("Changesets/DepsRegen") {};
 /**
 * Build a {@link DepsRegenShape} that closes over already-resolved service
 * implementations, keeping the public `plan`/`execute` signatures
 * requirement-free (`R = never`).
 */
-function makeShape(pit, inspector, discovery, detector, config, fs) {
+function makeShape(snapshots, inspector, discovery, detector, config, fs, provideGit) {
 	const provideDetector = Layer.succeed(PublishabilityDetector, detector);
 	const fileExists = (p) => fs.exists(p).pipe(Effect.orElseSucceed(() => false));
 	const plan = (options) => Effect.gen(function* () {
@@ -265,12 +260,12 @@ function makeShape(pit, inspector, discovery, detector, config, fs) {
 		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);
+			fromRef = yield* gitMergeBase(resolvedCwd, baseBranch).pipe(Effect.provide(provideGit));
 		}
-		const rawDiffs = computeWorkspaceDependencyDiffs(yield* pit.at(fromRef, { cwd: resolvedCwd }), options.to ? yield* pit.at(options.to, { cwd: resolvedCwd }) : yield* pit.worktree({ cwd: resolvedCwd }));
+		const rawDiffs = computeWorkspaceDependencyDiffs(yield* snapshots.at(fromRef), options.to ? yield* snapshots.at(options.to) : yield* snapshots.worktree());
 		const explicitTargets = /* @__PURE__ */ new Set([...options.packages ?? [], ...options.package ? [options.package] : []]);
 		const excluded = new Set(options.exclude ?? []);
-		const livePackages = yield* discovery.listPackages(resolvedCwd);
+		const livePackages = yield* discovery.listPackages();
 		const publishable = yield* listPublishablePackageNames(livePackages, resolvedCwd).pipe(Effect.provide(provideDetector));
 		const versionPrivate = yield* config.versionPrivate(resolvedCwd);
 		const inScope = /* @__PURE__ */ new Set();
@@ -298,7 +293,7 @@ function makeShape(pit, inspector, discovery, detector, config, fs) {
 		const existingPure = yield* findPureDependencyChangesets(fs, changesetDir);
 		const skippedMixed = yield* findMixedDependencyChangesets(fs, changesetDir);
 		const rewrittenPackages = new Set(resolved.map((d) => d.package));
-		const atMergeBase = yield* gitListChangesetFilesAtRef(resolvedCwd, fromRef);
+		const atMergeBase = yield* gitListChangesetFilesAtRef(resolvedCwd, fromRef).pipe(Effect.provide(provideGit));
 		const authoredOnBranch = (file) => !atMergeBase.has(basename(file));
 		const toDelete = existingPure.filter((p) => inScopeFor(p.package) && rewrittenPackages.has(p.package) && authoredOnBranch(p.file));
 		const chosenFilenames = /* @__PURE__ */ new Set();
@@ -343,8 +338,9 @@ function makeShape(pit, inspector, discovery, detector, config, fs) {
 /**
 * Live layer for {@link DepsRegen}.
 *
-* Requires `PointInTimeWorkspace`, `WorkspaceDiscovery`,
-* `PublishabilityDetector` (all from `workspaces-effect`),
+* Requires `WorkspaceSnapshots`, `WorkspaceDiscovery`,
+* `PublishabilityDetector` (all from `@effected/workspaces`),
+* `Git` (from `@effected/git`, backing merge-base resolution),
 * {@link ConfigInspector}, {@link ChangesetConfig}, and
 * `FileSystem.FileSystem` (resolved once at construction and closed over by
 * the shape, keeping `plan`/`execute` themselves requirement-free).
@@ -352,17 +348,47 @@ function makeShape(pit, inspector, discovery, detector, config, fs) {
 * @public
 */
 const DepsRegenLive = Layer.effect(DepsRegen, Effect.gen(function* () {
-	return makeShape(yield* PointInTimeWorkspace, yield* ConfigInspector, yield* WorkspaceDiscovery, yield* PublishabilityDetector, yield* ChangesetConfig, yield* FileSystem.FileSystem);
+	const snapshots = yield* WorkspaceSnapshots;
+	const inspector = yield* ConfigInspector;
+	const discovery = yield* WorkspaceDiscovery;
+	const detector = yield* PublishabilityDetector;
+	const config = yield* ChangesetConfig;
+	const fs = yield* FileSystem.FileSystem;
+	const git = yield* Git;
+	return makeShape(snapshots, inspector, discovery, detector, config, fs, Layer.succeed(Git, git));
 }));
-const WorkspaceGraph = Layer.mergeAll(WorkspaceRootLive, WorkspaceDiscoveryLive.pipe(Layer.provide(WorkspaceRootLive)));
 const ConfigGraph = ChangesetConfigLive.pipe(Layer.provide(ChangesetConfigReaderLive));
 /**
+* Build the batteries-included {@link DepsRegen} layer over a
+* `@effected/workspaces` kit graph bound to `options.cwd`.
+*
+* @remarks
+* The kit's root-consuming services (`WorkspaceDiscovery`,
+* `WorkspaceSnapshots`, `WorkspaceRoot`) resolve their workspace root from
+* the layer they were built with — single-root by design. {@link DepsRegenDefault}
+* is this builder bound with no options (root from `process.cwd()`, read
+* lazily); pass an explicit `cwd` when planning against a different root
+* (fixtures, multi-repo hosts).
+*
+* `Workspaces.layerWithGit` mints a fresh layer reference per call, so the
+* graph is bound ONCE per builder call and shared across every internal
+* branch — layer memoization by reference constructs each kit service
+* exactly once.
+*
+* @public
+*/
+function makeDepsRegenDefault(options) {
+	const kitGraph = Workspaces.layerWithGit(options);
+	return DepsRegenLive.pipe(Layer.provide(ConfigInspectorLive.pipe(Layer.provide(Layer.mergeAll(ChangesetConfigReaderLive, kitGraph)))), Layer.provide(PublishabilityDetectorAdaptiveLive.pipe(Layer.provide(Layer.mergeAll(ConfigGraph, kitGraph)))), Layer.provide(ConfigGraph), Layer.provide(kitGraph));
+}
+/**
 * 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
+* composition of the full dependency graph, root-bound to `process.cwd()`
+* (see {@link makeDepsRegenDefault} for an explicit root). Only the platform
+* services remain — note that `WorkspaceSnapshots` reads git history, so
+* this layer genuinely requires `ChildProcessSpawner` in addition to
 * `FileSystem`/`Path`: provide a git-capable platform layer
-* (`NodeContext.layer`), not a bare filesystem-only layer.
+* (`NodeServices.layer`), not a bare filesystem-only layer.
 *
 * Gating uses silk's adaptive publishability detector
 * ({@link PublishabilityDetectorAdaptiveLive}), so the default semantics
@@ -373,16 +399,16 @@ const ConfigGraph = ChangesetConfigLive.pipe(Layer.provide(ChangesetConfigReader
 *
 * @example
 * ```typescript
-* import { NodeContext } from "@effect/platform-node";
+* import { NodeServices } from "@effect/platform-node";
 * import { Layer } from "effect";
 * import { Changesets } from "@savvy-web/silk-effects";
 *
-* const depsRegen = Changesets.DepsRegenDefault.pipe(Layer.provide(NodeContext.layer));
+* const depsRegen = Changesets.DepsRegenDefault.pipe(Layer.provide(NodeServices.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));
+const DepsRegenDefault = makeDepsRegenDefault();
 
 //#endregion
-export { DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, isPureDependencyChangeset };
+export { DepsRegen, DepsRegenDefault, DepsRegenLive, isPureDependencyChangeset, makeDepsRegenDefault };

package/changesets/services/github.js

@@ -23,18 +23,6 @@ import { Context, Effect, Layer } from "effect";
 * @see {@link GitHubLive} for the production layer
 * @see {@link makeGitHubTest} for constructing test layers
 */
-const _tag = Context.Tag("GitHubService");
-/**
-* Base class for GitHubService.
-*
-* @privateRemarks
-* This export is required for api-extractor documentation generation.
-* Effect's Context.Tag creates an anonymous base class that must be
-* explicitly exported to avoid "forgotten export" warnings. Do not delete.
-*
-* @internal
-*/
-const GitHubServiceBase = _tag();
 /**
 * Effect service tag for GitHub API operations.
 *
@@ -43,7 +31,7 @@ const GitHubServiceBase = _tag();
 * service instance.
 *
 * @remarks
-* This tag follows the standard Effect `Context.Tag` pattern. Two layers
+* This tag follows the standard Effect `Context.Service` pattern. Two layers
 * are provided out of the box:
 *
 * - {@link GitHubLive} — production layer backed by the GitHub REST API
@@ -90,11 +78,10 @@ const GitHubServiceBase = _tag();
 * @see {@link GitHubServiceShape} for the service interface
 * @see {@link GitHubLive} for the production layer
 * @see {@link makeGitHubTest} for creating test layers
-* @see {@link GitHubServiceBase} for the api-extractor base class
 *
 * @public
 */
-var GitHubService = class extends GitHubServiceBase {};
+var GitHubService = class extends Context.Service()("GitHubService") {};
 /**
 * Production layer for {@link GitHubService}.
 *
@@ -175,4 +162,4 @@ function makeGitHubTest(responses) {
 }
 
 //#endregion
-export { GitHubLive, GitHubService, GitHubServiceBase, makeGitHubTest };
+export { GitHubLive, GitHubService, makeGitHubTest };

package/changesets/services/maintenance-reason.js

@@ -20,7 +20,11 @@ const MaintenanceTriggerSchema = Schema.Struct({
 */
 const MaintenanceReasonSchema = Schema.Struct({
 	/** Coupling that forced the release; `"unspecified"` when undetermined. */
-	kind: Schema.Literal("fixed", "linked", "unspecified"),
+	kind: Schema.Literals([
+		"fixed",
+		"linked",
+		"unspecified"
+	]),
 	/** Triggering co-members; empty for `"unspecified"`. */
 	triggers: Schema.Array(MaintenanceTriggerSchema)
 });

package/changesets/services/markdown.js

@@ -22,18 +22,6 @@ import { Context, Effect, Layer } from "effect";
 * @see {@link MarkdownServiceShape} for the service interface
 * @see {@link MarkdownLive} for the production layer
 */
-const _tag = Context.Tag("MarkdownService");
-/**
-* Base class for MarkdownService.
-*
-* @privateRemarks
-* This export is required for api-extractor documentation generation.
-* Effect's Context.Tag creates an anonymous base class that must be
-* explicitly exported to avoid "forgotten export" warnings. Do not delete.
-*
-* @internal
-*/
-const MarkdownServiceBase = _tag();
 /**
 * Effect service tag for markdown parsing and stringification.
 *
@@ -42,7 +30,7 @@ const MarkdownServiceBase = _tag();
 * service instance.
 *
 * @remarks
-* This tag follows the standard Effect `Context.Tag` pattern. The
+* This tag follows the standard Effect `Context.Service` pattern. The
 * {@link MarkdownLive} layer provides the default implementation backed by
 * the remark/unified pipeline. For testing, you can supply a custom layer
 * via `Layer.succeed(MarkdownService, { parse: ..., stringify: ... })`.
@@ -64,11 +52,10 @@ const MarkdownServiceBase = _tag();
 *
 * @see {@link MarkdownServiceShape} for the service interface
 * @see {@link MarkdownLive} for the production layer
-* @see {@link MarkdownServiceBase} for the api-extractor base class
 *
 * @public
 */
-var MarkdownService = class extends MarkdownServiceBase {};
+var MarkdownService = class extends Context.Service()("MarkdownService") {};
 /**
 * Production layer for {@link MarkdownService}.
 *
@@ -103,4 +90,4 @@ const MarkdownLive = Layer.succeed(MarkdownService, {
 });
 
 //#endregion
-export { MarkdownLive, MarkdownService, MarkdownServiceBase };
+export { MarkdownLive, MarkdownService };

package/changesets/services/release-planner.js

@@ -3,9 +3,8 @@ import { ChangelogTransformer } from "../api/transformer.js";
 import { ConfigInspector } from "./config-inspector.js";
 import { deriveMaintenanceReason } from "./maintenance-reason.js";
 import { VersionFiles } from "../utils/version-files.js";
-import { Context, Effect, Layer } from "effect";
+import { Context, Effect, FileSystem, Layer } from "effect";
 import { dirname, isAbsolute, join, relative } from "node:path";
-import { FileSystem } from "@effect/platform";
 import { applyReleasePlan } from "@changesets/apply-release-plan";
 import { readConfig } from "@changesets/config";
 import { getReleasePlan } from "@changesets/get-release-plan";
@@ -39,16 +38,8 @@ async function loadConfig(root, packages) {
 		warnings: configResult.warnings
 	};
 }
-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 {};
+var ReleasePlanner = class extends Context.Service()("ReleasePlanner") {};
 /** Build the service shape over a resolved {@link ConfigInspector} and {@link FileSystem.FileSystem}. */
 function makeShape(inspector, fs) {
 	const plan = (root) => Effect.tryPromise({
@@ -316,7 +307,7 @@ function applyEffect(root, dryRun, changelogModules, inspector, fs) {
 			});
 		}
 		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))));
+		const inspected = yield* inspector.inspect(root).pipe(Effect.catch((error) => Effect.logWarning(`Skipping versionFiles update: ${errMsg(error)}`).pipe(Effect.as(null))));
 		let versionFileUpdates = [];
 		if (inspected) {
 			const candidates = inspected.packages.filter((p) => p.versionFiles.length > 0);
@@ -346,4 +337,4 @@ function applyEffect(root, dryRun, changelogModules, inspector, fs) {
 }
 
 //#endregion
-export { ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, extractVersionBlock, makeReleasePlannerTest };
+export { ReleasePlanner, ReleasePlannerLive, extractVersionBlock, makeReleasePlannerTest };

package/changesets/utils/commit-parser.js

@@ -1,23 +1,5 @@
 //#region src/changesets/utils/commit-parser.ts
 /**
-* Conventional commit message parsing.
-*
-* Implements a parser for the
-* {@link https://www.conventionalcommits.org/ | Conventional Commits}
-* specification, extracting type, scope, breaking-change indicator,
-* description, and body from commit messages.
-*
-* @remarks
-* The parser uses a single regex pass for the first line, then splits
-* remaining lines to extract the body. Non-conventional messages are
-* returned with only the `description` field populated (set to the
-* full message text).
-*
-* @see {@link Changelog} for the public API that consumes parsed commits
-*
-* @internal
-*/
-/**
 * Matches conventional commit format: `type(scope)!: description`.
 *
 * Capture groups:

package/changesets/utils/dep-diff.js

@@ -2,33 +2,6 @@ import { sortDependencyRows } from "./dependency-table.js";
 import { Option } from "effect";
 
 //#region src/changesets/utils/dep-diff.ts
-/**
-* Compute per-workspace-package dependency-table rows from two
-* {@link WorkspaceStateSnapshot}s, resolving `catalog:` / `workspace:`
-* specifiers against each side's own catalogs and package versions BEFORE
-* comparing.
-*
-* @remarks
-* Operates on declared dependencies only (the `dependencies` /
-* `devDependencies` / `peerDependencies` / `optionalDependencies` fields
-* of each workspace's `package.json`). Lockfile-only movements
-* (resolved versions changing while declared ranges stay put) are
-* intentionally excluded — those happen on every `pnpm install` and
-* would generate constant noise.
-*
-* Each side carries its own catalogs and package versions, so a specifier
-* is resolved against the snapshot it belongs to: `catalog:silk` resolves
-* to that ref's `silk` catalog entry, `workspace:*` to that ref's target
-* package version. A row is emitted iff the two RESOLVED values differ (or
-* the dependency was added/removed) — a package that merely adopted a
-* `catalog:` specifier without changing the concrete version produces NO
-* row. When a side cannot resolve a specifier (no matching catalog entry,
-* plain range, etc.) it falls back to the raw specifier string.
-*
-* @see {@link DependencyTableRow} for the row schema
-* @see {@link WorkspaceStateSnapshot} for the input shape
-*
-*/
 /** The em-dash sentinel (U+2014) used for added ("from") / removed ("to") cells. */
 const EM_DASH = "—";
 const DEP_TYPE_MAP = [

package/changesets/utils/git.js

@@ -1,17 +1,18 @@
 import { GitError } from "../errors.js";
 import { Effect } from "effect";
 import { basename } from "node:path";
-import { execFileSync } from "node:child_process";
+import { Git } from "@effected/git";
 
 //#region src/changesets/utils/git.ts
 /**
 * Git helpers for the changesets deps regen/detect orchestration.
 *
 * @remarks
-* `PointInTimeWorkspace` (from `workspaces-effect`) reads both sides of a
-* dependency diff over `CommandExecutor`. The one git operation it does not
-* cover is resolving the default `--from` ref — the merge-base with the base
-* branch — which stays here as a synchronous `execFileSync` shell-out.
+* `WorkspaceSnapshots` (from `@effected/workspaces`) reads both sides of a
+* dependency diff. The one git operation it does not cover is resolving the
+* default `--from` ref — the merge-base with the base branch — which is
+* delegated to `@effected/git`'s `Git` service (spawning through
+* `ChildProcessSpawner`, provided at the app edge).
 *
 * @internal
 */
@@ -22,34 +23,17 @@ import { execFileSync } from "node:child_process";
 * @internal
 */
 function gitMergeBase(cwd, base) {
-	return Effect.try({
-		try: () => execFileSync("git", [
-			"merge-base",
-			base,
-			"HEAD"
-		], {
+	return Effect.gen(function* () {
+		return yield* (yield* Git).mergeBase(cwd, base, "HEAD").pipe(Effect.mapError((error) => new GitError({
+			command: `git merge-base ${base} HEAD`,
 			cwd,
-			encoding: "utf8",
-			stdio: [
-				"ignore",
-				"pipe",
-				"pipe"
-			]
-		}).trim(),
-		catch: (error) => {
-			const stderr = error.stderr;
-			const text = typeof stderr === "string" ? stderr : stderr?.toString() ?? "";
-			return new GitError({
-				command: `git merge-base ${base} HEAD`,
-				cwd,
-				reason: text.trim() || (error.message ?? String(error))
-			});
-		}
+			reason: error.message
+		})));
 	});
 }
 /**
 * List the basenames of `.changeset/*.md` files tracked at `ref` (e.g. the
-* merge base), via `git ls-tree -r --name-only`. Used by `DepsRegen.plan()`
+* merge base), via `git ls-tree -r`. Used by `DepsRegen.plan()`
 * to protect changesets authored by already-merged PRs from being deleted by
 * an unrelated branch's regen run (#258).
 *
@@ -65,28 +49,9 @@ function gitMergeBase(cwd, base) {
 * @internal
 */
 function gitListChangesetFilesAtRef(cwd, ref) {
-	return Effect.sync(() => {
-		try {
-			const out = execFileSync("git", [
-				"ls-tree",
-				"-r",
-				"--name-only",
-				ref,
-				"--",
-				".changeset"
-			], {
-				cwd,
-				encoding: "utf8",
-				stdio: [
-					"ignore",
-					"pipe",
-					"pipe"
-				]
-			});
-			return new Set(out.split(/\r?\n/).filter((line) => line.trim().length > 0).map((path) => basename(path)));
-		} catch {
-			return /* @__PURE__ */ new Set();
-		}
+	return Effect.gen(function* () {
+		const entries = yield* (yield* Git).lsTree(cwd, ref, { pathspec: [".changeset"] }).pipe(Effect.catch(() => Effect.succeed([])));
+		return new Set(entries.filter((entry) => entry.path.trim().length > 0).map((entry) => basename(entry.path)));
 	});
 }
 

package/changesets/utils/issue-refs.js

@@ -1,18 +1,5 @@
 //#region src/changesets/utils/issue-refs.ts
 /**
-* GitHub issue reference parsing from commit messages.
-*
-* @remarks
-* Extracts categorized issue references (`Closes`, `Fixes`, `Refs`) from
-* commit message bodies. Supports multiple formats including with/without
-* colons, singular/plural keywords, and comma-separated issue lists.
-* Input is truncated to 10,000 characters to prevent ReDoS on adversarial input.
-*
-* @see {@link Changelog} for the public API that consumes issue references
-*
-* @internal
-*/
-/**
 * Matches "closes #123" or "close: #456, #789" patterns (case-insensitive).
 *
 * Capture group `[1]` contains the comma-separated issue number list.

package/changesets/utils/logger.js

@@ -1,18 +1,5 @@
 //#region src/changesets/utils/logger.ts
 /**
-* Simple logging utility for changelog generation.
-*
-* @remarks
-* Provides environment-aware warning output:
-* - **GitHub Actions**: emits `::warning::` annotations that surface in
-*   the Actions UI
-* - **Local development**: falls back to `console.warn`
-* - **Test environment**: suppressed entirely when `process.env.VITEST`
-*   is set, preventing noisy test output
-*
-* @internal
-*/
-/**
 * Log a warning message.
 *
 * @remarks

package/changesets/utils/markdown-link.js

@@ -1,19 +1,5 @@
 //#region src/changesets/utils/markdown-link.ts
 /**
-* Markdown link extraction utilities.
-*
-* @remarks
-* Handles the inconsistency where `\@changesets/get-github-info` sometimes
-* returns markdown-formatted links (e.g., `[#17](https://...)`) instead
-* of plain URLs. Provides a regex pattern and extraction function to
-* normalize these values.
-*
-* @see {@link Changelog} for the public API that uses link extraction
-*   during changelog generation
-*
-* @internal
-*/
-/**
 * Pattern matching markdown link format: `[text](url)`.
 *
 * Capture groups:

package/changesets/utils/publishability.js

@@ -1,47 +1,34 @@
 import { Effect } from "effect";
-import { PublishabilityDetector } from "workspaces-effect";
+import { PublishabilityDetector } from "@effected/workspaces";
 
 //#region src/changesets/utils/publishability.ts
 /**
-* Publishability helpers for the changeset CLI commands.
-*
-* @remarks
-* Provides `listPublishablePackageNames`, a convenience wrapper around
-* {@link SilkPublishability} that returns a `Set<string>` of
-* publishable package names. Used by the `deps detect` and `deps regen`
-* commands to filter out workspace packages whose dependency changes
-* would never reach a release.
-*
-*/
-/**
 * Compute the set of currently-publishable workspace package names.
 *
 * @remarks
 * Uses the currently-active {@link SilkPublishability} — wire the
 * {@link SilkPublishabilityDetectorLive} layer to get silk semantics.
 *
-* `root` is passed through verbatim to `detector.detect(pkg, root)` for every
-* package — it must be the project root (the directory containing
-* `.changeset/`), NOT the individual package's directory. The vanilla
-* `PublishabilityDetectorLive` and plain `SilkPublishabilityDetectorLive`
-* both ignore this argument, but the ignore/mode-aware
-* `PublishabilityDetectorAdaptiveLive` reads `.changeset/config.json`
-* relative to it, so passing a package subdirectory silently makes every
-* package resolve to "not publishable". Mirrors
-* {@link SilkPublishability.listPublishable}, which takes the same
+* The kit's `PublishabilityDetector.detect` contract no longer receives the
+* workspace root — the ignore/mode-aware `PublishabilityDetectorAdaptiveLive`
+* derives the `.changeset/config.json` root per package from the package's
+* own discovery coordinates (`pkg.path` ascended by `pkg.relativePath`).
+* The `root` parameter is retained for signature stability
+* but is no longer consulted. Mirrors
+* {@link SilkPublishability.listPublishable}, which keeps the same inert
 * single-root parameter for the same reason.
 *
 * @param packages - The workspace packages to evaluate
-* @param root - Absolute path to the project root containing `.changeset/`
+* @param _root - Retained for signature stability; no longer consulted
 * @returns An Effect yielding a `Set` of publishable package names
 *
 * @public
 */
-function listPublishablePackageNames(packages, root) {
+function listPublishablePackageNames(packages, _root) {
 	return Effect.gen(function* () {
 		const detector = yield* PublishabilityDetector;
 		const names = /* @__PURE__ */ new Set();
-		for (const pkg of packages) if ((yield* detector.detect(pkg, root)).length > 0) names.add(pkg.name);
+		for (const pkg of packages) if ((yield* detector.detect(pkg)).length > 0) names.add(pkg.name);
 		return names;
 	});
 }

package/changesets/utils/strip-frontmatter.js

@@ -1,24 +1,5 @@
 //#region src/changesets/utils/strip-frontmatter.ts
 /**
-* Utility for stripping YAML frontmatter from changeset files.
-*
-* @remarks
-* Changeset `.md` files produced by `\@changesets/cli` contain YAML
-* frontmatter (delimited by `---`) specifying which packages are
-* affected and their version bump types. This frontmatter must be
-* removed before remark-lint processing, as remark-parse does not
-* handle YAML frontmatter natively without `remark-frontmatter`.
-*
-* The regex used is non-greedy (`[\s\S]*?`) to match only the first
-* frontmatter block and avoid stripping content after a second `---`
-* delimiter that might appear in the document body.
-*
-* @see {@link ChangesetLinter} for the public API that uses frontmatter
-*   stripping during changeset validation
-*
-* @internal
-*/
-/**
 * Strip leading YAML frontmatter from a markdown string.
 *
 * Removes the `---\n...\n---\n` block at the start of the content.