@savvy-web/silk-effects 1.5.2 → 2.0.0

package/index.d.ts

@@ -1,6 +1,6 @@
 import { Context, Data, Effect, Equal, Hash, Layer, Option, Schema, Stream } from "effect";
-import { Command, CommandExecutor, FileSystem } from "@effect/platform";
-import { PackageManagerDetector, PublishConfig, PublishTarget, PublishabilityDetector, TopologicalSorter, WorkspaceDiscovery, WorkspaceDiscoveryError, WorkspacePackage, WorkspaceRoot } from "workspaces-effect";
+import { Command, CommandExecutor, FileSystem, Path } from "@effect/platform";
+import { PackageManagerDetector, PointInTimeReadError, PointInTimeWorkspace, PublishConfig, PublishTarget, PublishabilityDetector, TopologicalSorter, WorkspaceDiscovery, WorkspaceDiscoveryError, WorkspacePackage, WorkspaceRoot, WorkspaceStateSnapshot } from "workspaces-effect";
 import { Plugin } from "unified";
 import { PlatformError } from "@effect/platform/Error";
 
@@ -1571,6 +1571,16 @@ declare const DependencyTableTypeSchema: Schema.Literal<["dependency", "devDepen
  * @public
  */
 type DependencyTableType = typeof DependencyTableTypeSchema.Type;
+/**
+ * The canonical accepted-value pattern for a dependency-table From/To cell:
+ * the em-dash sentinel (U+2014), a bare/`~`/`^` semver, or — as a last-resort
+ * fallback when a `catalog:`/`workspace:` specifier could not be resolved to a
+ * concrete version — a pnpm protocol string. Non-overlapping alternatives keep
+ * this free of polynomial backtracking (CodeQL).
+ *
+ * @public
+ */
+declare const VERSION_RE: RegExp;
 /**
  * Version string or em dash (U+2014) sentinel for added/removed entries.
  *
@@ -1845,7 +1855,7 @@ declare class DependencyTable {
 /**
  * Class-based API wrapper for changeset linting.
  *
- * Provides a static class interface that runs all remark-lint rules
+ * Provides a static class interface that runs all five remark-lint rules
  * against changeset markdown files and returns structured diagnostics.
  *
  * @internal
@@ -1859,11 +1869,12 @@ declare class DependencyTable {
  * (file, line, column) for integration with editors, CI reporters, and
  * the Effect CLI's `lint` and `check` commands.
  *
- * The four rules that produce lint messages are:
+ * The five rules that produce lint messages are:
  *
  * - **heading-hierarchy** -- ensures headings follow a valid nesting order
  * - **required-sections** -- checks that mandatory sections are present
  * - **content-structure** -- validates the structure of section content
+ * - **dependency-table-format** -- enforces the machine-generated dependency-table format for `## Dependencies` sections
  * - **uncategorized-content** -- flags content outside recognized section headings
  *
  * @public
@@ -1882,9 +1893,10 @@ interface LintMessage {
    * Identifier of the remark-lint rule that produced this message.
    *
    * @remarks
-   * Corresponds to one of the four built-in rules: `"heading-hierarchy"`,
-   * `"required-sections"`, `"content-structure"`, or `"uncategorized-content"`.
-   * Falls back to `"unknown"` if the underlying vfile message has no rule ID.
+   * Corresponds to one of the five built-in rules: `"heading-hierarchy"`,
+   * `"required-sections"`, `"content-structure"`, `"dependency-table-format"`,
+   * or `"uncategorized-content"`. Falls back to `"unknown"` if the underlying
+   * vfile message has no rule ID.
    */
   rule: string;
   /**
@@ -1917,9 +1929,9 @@ interface LintMessage {
 /**
  * Static class for linting changeset markdown files.
  *
- * Runs the four remark-lint rules (heading-hierarchy, required-sections,
- * content-structure, uncategorized-content) against changeset markdown
- * and returns structured {@link LintMessage} diagnostics.
+ * Runs the five remark-lint rules (heading-hierarchy, required-sections,
+ * content-structure, dependency-table-format, uncategorized-content) against
+ * changeset markdown and returns structured {@link LintMessage} diagnostics.
  *
  * @remarks
  * This class implements the pre-validation layer of the three-layer
@@ -2004,7 +2016,7 @@ declare class ChangesetLinter {
    *
    * @remarks
    * Reads the file synchronously, strips YAML frontmatter, and runs all
-   * four lint rules. The file path is preserved in each returned
+   * five lint rules. The file path is preserved in each returned
    * {@link LintMessage} for error reporting.
    *
    * @param filePath - Absolute or relative path to the changeset `.md` file
@@ -2015,7 +2027,7 @@ declare class ChangesetLinter {
    * Validate a markdown string directly.
    *
    * @remarks
-   * Strips YAML frontmatter (if present) and runs all four lint rules
+   * Strips YAML frontmatter (if present) and runs all five lint rules
    * against the remaining content. This method is useful for validating
    * changeset content that is already in memory, such as in test suites
    * or editor integrations.
@@ -2494,6 +2506,53 @@ declare class GitError extends GitErrorBase<{
 }> {
   get message(): string;
 }
+/**
+ * Base class for {@link ChangesetIOError}.
+ *
+ * @privateRemarks
+ * Effect's `Data.TaggedError` creates an anonymous base class that
+ * api-extractor cannot follow without an explicit export.
+ *
+ * @internal
+ */
+declare const ChangesetIOErrorBase: 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: "ChangesetIOError";
+} & Readonly<A>;
+/**
+ * Changeset file I/O failure.
+ *
+ * @remarks
+ * Raised by {@link DepsRegen} when reading, writing, listing, or deleting
+ * `.changeset/*.md` files fails. Deletion failures during
+ * {@link DepsRegenShape.execute} are tolerated (stale changesets are
+ * skip-and-continue, so an interrupted run stays safely re-runnable);
+ * read, list, and write failures are loud.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { ChangesetIOError } from "@savvy-web/changesets";
+ *
+ * declare const program: Effect.Effect<void, ChangesetIOError>;
+ *
+ * const handled = program.pipe(
+ *   Effect.catchTag("ChangesetIOError", (err) =>
+ *     Effect.logError(`changeset ${err.operation} failed at ${err.path}: ${err.reason}`)
+ *   ),
+ * );
+ * ```
+ *
+ * @see {@link DepsRegen} which produces these errors during plan/execute
+ *
+ * @public
+ */
+declare class ChangesetIOError extends ChangesetIOErrorBase<{
+  /** Absolute path of the file or directory the operation targeted. */readonly path: string; /** The failed operation. */
+  readonly operation: "read" | "write" | "delete" | "list"; /** Human-readable failure reason. */
+  readonly reason: string;
+}> {
+  get message(): string;
+}
 /**
  * Base class for {@link ReleasePlanError}.
  *
@@ -3480,6 +3539,246 @@ declare const ChangelogServiceBase: Context.TagClass<ChangelogService, "Changelo
  */
 declare class ChangelogService extends ChangelogServiceBase {}
 //#endregion
+//#region src/services/ChangesetConfig.d.ts
+/**
+ * Changeset operating mode for a workspace root.
+ * @public
+ */
+type ChangesetMode = "silk" | "vanilla" | "none";
+declare const ChangesetConfig_base: Context.TagClass<ChangesetConfig, "@savvy-web/silk-effects/ChangesetConfig", {
+  readonly mode: (root: string) => Effect.Effect<ChangesetMode>;
+  readonly versionPrivate: (root: string) => Effect.Effect<boolean>;
+  readonly ignorePatterns: (root: string) => Effect.Effect<ReadonlyArray<string>>;
+  readonly isIgnored: (name: string, root: string) => Effect.Effect<boolean>;
+  readonly fixed: (root: string) => Effect.Effect<ReadonlyArray<ReadonlyArray<string>>>;
+}>;
+/**
+ * Accessor service over a workspace root's `.changeset/config.json`.
+ *
+ * @remarks
+ * Reads through {@link ChangesetConfigReader} (FileSystem-based) with a per-root cache.
+ * Every accessor is total (error channel `never`): a missing or unreadable config collapses
+ * to `mode: "none"` and empty/false defaults.
+ *
+ * @since 0.4.0
+ * @public
+ */
+declare class ChangesetConfig extends ChangesetConfig_base {
+  /**
+   * The one ignore matcher: exact name match, or `@scope/*` wildcard.
+   *
+   * `"@scope/*"` matches `"@scope/anything"` (prefix kept includes the trailing slash),
+   * but not the bare scope `"@scope"`.
+   */
+  static matches(name: string, pattern: string): boolean;
+}
+/**
+ * Live {@link ChangesetConfig} reading via {@link ChangesetConfigReader}, cached per root.
+ *
+ * @remarks
+ * Requires `ChangesetConfigReader` (which requires `FileSystem`). Provide
+ * `ChangesetConfigReaderLive` + a platform layer (`NodeContext.layer`).
+ *
+ * @since 0.4.0
+ * @public
+ */
+declare const ChangesetConfigLive: Layer.Layer<ChangesetConfig, never, ChangesetConfigReader>;
+//#endregion
+//#region src/changesets/utils/dep-diff.d.ts
+/**
+ * A workspace package's worth of dependency-table rows.
+ *
+ * @public
+ */
+interface WorkspaceDependencyDiff {
+  /** The workspace package whose `package.json` changed. */
+  readonly package: string;
+  /** Repo-relative path of the package directory (taken from the `after` snapshot). */
+  readonly relativePath: string;
+  /** One row per dependency change, sorted by the existing `sortDependencyRows` convention. */
+  readonly rows: ReadonlyArray<DependencyTableRow>;
+}
+/**
+ * Diff two workspace snapshots and return per-package dependency-table rows,
+ * comparing already-resolved specifier values per side.
+ *
+ * @param before - Snapshot at the older ref (typically the merge base). A
+ *   workspace package absent here reports every declared dep as `"added"`.
+ * @param after - Snapshot at the newer ref (typically the working tree).
+ * @returns One {@link WorkspaceDependencyDiff} entry per workspace package
+ *   that has at least one row. Packages with no resolved-value changes are
+ *   omitted.
+ *
+ * @public
+ */
+declare function computeWorkspaceDependencyDiffs(before: WorkspaceStateSnapshot, after: WorkspaceStateSnapshot): ReadonlyArray<WorkspaceDependencyDiff>;
+//#endregion
+//#region src/changesets/services/deps-regen.d.ts
+/**
+ * Strict detection of "pure dependency changesets" per the documented
+ * rules: single-package frontmatter, single `## Dependencies` heading,
+ * no other body content beyond that section.
+ *
+ * @param content - Raw `.changeset/*.md` file contents.
+ * @returns `{ isPure, package }` — `isPure` is `true` only for a
+ *   single-package, Dependencies-only changeset; `package` is the sole
+ *   frontmatter package name (or `null` when not pure).
+ *
+ * @public
+ */
+declare function isPureDependencyChangeset(content: string): {
+  isPure: boolean;
+  package: string | null;
+};
+/**
+ * A complete, side-effect-free regen plan: which stale pure-dependency
+ * changesets to delete, which fresh changesets to write (carrying the
+ * already-resolved diff), and which mixed changesets were left untouched.
+ *
+ * @public
+ */
+interface RegenPlan {
+  readonly toDelete: ReadonlyArray<{
+    readonly file: string;
+    readonly package: string;
+  }>;
+  readonly toWrite: ReadonlyArray<{
+    readonly file: string;
+    readonly package: string;
+    readonly diff: WorkspaceDependencyDiff;
+  }>;
+  readonly skippedMixed: ReadonlyArray<string>;
+}
+/**
+ * The result of applying a {@link RegenPlan}: the files actually deleted
+ * and written, plus the mixed changesets that were skipped.
+ *
+ * @public
+ */
+interface RegenResult {
+  readonly deleted: ReadonlyArray<string>;
+  readonly written: ReadonlyArray<string>;
+  readonly skippedMixed: ReadonlyArray<string>;
+}
+/**
+ * Options for {@link DepsRegenShape.plan}.
+ *
+ * @public
+ */
+interface DepsRegenOptions {
+  /** Project root (containing `.changeset/`). */
+  readonly cwd: string;
+  /** Override the base branch used to compute the merge-base when `from` is omitted. */
+  readonly base?: string;
+  /** Restrict regeneration to a single workspace package. */
+  readonly package?: string;
+  /**
+   * When `true`, retain `devDependency` rows (the `deps detect` path);
+   * when falsy (the `deps regen` default), drop them unconditionally.
+   * Protocol resolution runs regardless.
+   */
+  readonly includeDevDeps?: boolean;
+  /**
+   * Older ref to diff from. Defaults to `git merge-base <base branch> HEAD`.
+   */
+  readonly from?: string;
+  /**
+   * Newer ref to diff to. Defaults to the working tree (staged + unstaged
+   * + untracked) via `PointInTimeWorkspace.worktree`.
+   */
+  readonly to?: string;
+}
+/**
+ * Effect service interface for the deps regen/detect orchestration.
+ *
+ * @public
+ */
+interface DepsRegenShape {
+  /**
+   * Compute a complete {@link RegenPlan}. Read-only against the filesystem:
+   * only inspects the existing `.changeset/*.md` files to detect
+   * stale/mixed changesets.
+   *
+   * @param options - See {@link DepsRegenOptions}.
+   * @returns An Effect yielding the plan, or failing with {@link GitError},
+   *   `WorkspaceDiscoveryError`, {@link ChangesetIOError} (an unreadable
+   *   `.changeset` directory or a genuinely unreadable changeset file list),
+   *   or `PointInTimeReadError` (a snapshot read failed for either ref).
+   */
+  readonly plan: (options: DepsRegenOptions) => Effect.Effect<RegenPlan, GitError | WorkspaceDiscoveryError | ChangesetIOError | PointInTimeReadError, never>;
+  /**
+   * Apply a {@link RegenPlan}: write fresh changesets first, then delete
+   * stale ones. Writes fail loudly with {@link ChangesetIOError}; deletion
+   * failures are tolerated (skip-and-continue) so an interrupted run stays
+   * safely re-runnable.
+   *
+   * @param plan - The plan produced by {@link DepsRegenShape.plan}.
+   * @returns An Effect yielding a {@link RegenResult}.
+   */
+  readonly execute: (plan: RegenPlan) => Effect.Effect<RegenResult, ChangesetIOError, never>;
+}
+/**
+ * @internal
+ */
+declare const DepsRegenBase: Context.TagClass<DepsRegen, "Changesets/DepsRegen", DepsRegenShape>;
+/**
+ * Effect service tag for {@link DepsRegenShape}.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { Changesets } from "@savvy-web/silk-effects";
+ *
+ * const program = Effect.gen(function* () {
+ *   const svc = yield* Changesets.DepsRegen;
+ *   const plan = yield* svc.plan({ cwd: process.cwd() });
+ *   return yield* svc.execute(plan);
+ * });
+ * ```
+ *
+ * @public
+ */
+declare class DepsRegen extends DepsRegenBase {}
+/**
+ * Live layer for {@link DepsRegen}.
+ *
+ * Requires `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
+ */
+declare const DepsRegenLive: Layer.Layer<DepsRegen, never, PointInTimeWorkspace | ConfigInspector | WorkspaceDiscovery | PublishabilityDetector | ChangesetConfig | FileSystem.FileSystem>;
+/**
+ * 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
+ */
+declare const DepsRegenDefault: Layer.Layer<DepsRegen, never, FileSystem.FileSystem | Path.Path | CommandExecutor.CommandExecutor>;
+//#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"]>;
@@ -3580,8 +3879,8 @@ interface ReleasePlannerShape {
 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>;
+/** Production layer. Requires {@link ConfigInspector} (used by `apply`) and `FileSystem`. @public */
+declare const ReleasePlannerLive: Layer.Layer<ReleasePlanner, never, ConfigInspector | FileSystem.FileSystem>;
 /**
  * Test factory — supply fixed results for any subset of methods. Unsupplied
  * methods fail with a `ReleasePlanError`.
@@ -3594,61 +3893,6 @@ declare function makeReleasePlannerTest(fixed: {
   readonly apply?: AppliedRelease;
 }): Layer.Layer<ReleasePlanner>;
 //#endregion
-//#region src/changesets/services/workspace-snapshot.d.ts
-/**
- * One workspace package as it existed at a specific git ref.
- *
- * @public
- */
-interface WorkspaceSnapshot {
-  /** Package name from `package.json#name`. */
-  readonly name: string;
-  /** Repo-relative path of the package directory at this ref. */
-  readonly relativePath: string;
-  /** Package version from `package.json#version`. */
-  readonly version: string;
-  /** Declared `dependencies` (raw strings, including `workspace:` / `catalog:` protocols). */
-  readonly dependencies: Readonly<Record<string, string>>;
-  /** Declared `devDependencies`. */
-  readonly devDependencies: Readonly<Record<string, string>>;
-  /** Declared `peerDependencies`. */
-  readonly peerDependencies: Readonly<Record<string, string>>;
-  /** Declared `optionalDependencies`. */
-  readonly optionalDependencies: Readonly<Record<string, string>>;
-}
-/**
- * Effect service interface for reading workspace snapshots.
- *
- * @public
- */
-interface WorkspaceSnapshotReaderShape {
-  /**
-   * Read every workspace package's snapshot at the given git ref.
-   *
-   * @param cwd - Project root (must be inside a git repo)
-   * @param ref - Any valid git revision spec — branch, tag, SHA, `HEAD~1`, etc.
-   * @returns Effect resolving to one {@link WorkspaceSnapshot} per workspace
-   *   package present at that ref, or failing with {@link GitError}
-   */
-  readonly snapshotAt: (cwd: string, ref: string) => Effect.Effect<ReadonlyArray<WorkspaceSnapshot>, GitError>;
-}
-/**
- * @internal
- */
-declare const WorkspaceSnapshotReaderBase: Context.TagClass<WorkspaceSnapshotReader, "WorkspaceSnapshotReader", WorkspaceSnapshotReaderShape>;
-/**
- * Effect service tag for {@link WorkspaceSnapshotReaderShape}.
- *
- * @public
- */
-declare class WorkspaceSnapshotReader extends WorkspaceSnapshotReaderBase {}
-/**
- * Production layer for {@link WorkspaceSnapshotReader}.
- *
- * @public
- */
-declare const WorkspaceSnapshotReaderLive: Layer.Layer<WorkspaceSnapshotReader>;
-//#endregion
 //#region src/changesets/schemas/changeset.d.ts
 /**
  * Schema for a changeset summary (1--1000 characters).
@@ -4290,34 +4534,6 @@ declare const LegacyVersionFilesSchema: Schema.Array$<Schema.Struct<{
   package: Schema.optional<Schema.filter<typeof Schema.String>>;
 }>>;
 //#endregion
-//#region src/changesets/utils/dep-diff.d.ts
-/**
- * A workspace package's worth of dependency-table rows.
- *
- * @public
- */
-interface WorkspaceDependencyDiff {
-  /** The workspace package whose `package.json` changed. */
-  readonly package: string;
-  /** Repo-relative path of the package directory (taken from the `after` snapshot when available). */
-  readonly relativePath: string;
-  /** One row per dependency change, sorted by the existing `sortDependencyRows` convention. */
-  readonly rows: ReadonlyArray<DependencyTableRow>;
-}
-/**
- * Diff two workspace snapshots and return per-package dependency-table rows.
- *
- * @param before - Snapshot at the older ref (typically the merge base). Pass
- *   `null` for workspace packages that did not exist at the older ref — every
- *   declared dep is then reported as `"added"`.
- * @param after - Snapshot at the newer ref (typically the working tree).
- * @returns One {@link WorkspaceDependencyDiff} entry per workspace package
- *   that has at least one row. Packages with no changes are omitted.
- *
- * @public
- */
-declare function computeWorkspaceDependencyDiffs(beforeSnapshots: ReadonlyArray<WorkspaceSnapshot>, afterSnapshots: ReadonlyArray<WorkspaceSnapshot>): ReadonlyArray<WorkspaceDependencyDiff>;
-//#endregion
 //#region src/changesets/utils/dependency-table.d.ts
 /**
  * Serialize dependency table rows to a markdown table string.
@@ -4346,6 +4562,15 @@ declare function computeWorkspaceDependencyDiffs(beforeSnapshots: ReadonlyArray<
  */
 declare function serializeDependencyTableToMarkdown(rows: DependencyTableRow[]): string;
 //#endregion
+//#region src/changesets/utils/git.d.ts
+/**
+ * Run `git merge-base <base> HEAD`, returning the SHA. Errors propagate
+ * as {@link GitError}.
+ *
+ * @internal
+ */
+declare function gitMergeBase(cwd: string, base: string): Effect.Effect<string, GitError>;
+//#endregion
 //#region src/changesets/utils/publishability.d.ts
 /**
  * Compute the set of currently-publishable workspace package names.
@@ -4354,12 +4579,24 @@ declare function serializeDependencyTableToMarkdown(rows: DependencyTableRow[]):
  * 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
+ * single-root parameter for the same reason.
+ *
  * @param packages - The workspace packages to evaluate
+ * @param root - Absolute path to the project root containing `.changeset/`
  * @returns An Effect yielding a `Set` of publishable package names
  *
  * @public
  */
-declare function listPublishablePackageNames(packages: ReadonlyArray<WorkspacePackage>): Effect.Effect<ReadonlySet<string>, never, PublishabilityDetector>;
+declare function listPublishablePackageNames(packages: ReadonlyArray<WorkspacePackage>, root: string): Effect.Effect<ReadonlySet<string>, never, PublishabilityDetector>;
 //#endregion
 //#region src/changesets/utils/version-files.d.ts
 /**
@@ -4566,28 +4803,6 @@ declare class VersionFiles {
   static processResolvedVersionFiles(scopes: ReadonlyArray<ResolvedPackageScope>, dryRun?: boolean): VersionFileUpdate[];
 }
 //#endregion
-//#region src/changesets/utils/worktree-snapshot.d.ts
-/**
- * Run `git merge-base <base> HEAD`, returning the SHA. Errors propagate
- * as {@link GitError}.
- *
- * @internal
- */
-declare function gitMergeBase(cwd: string, base: string): Effect.Effect<string, GitError>;
-/**
- * Read every workspace package's `package.json` from the live working
- * tree, returning {@link WorkspaceSnapshot} entries matching the shape
- * `WorkspaceSnapshotReader.snapshotAt` produces for git refs.
- *
- * @remarks
- * Falls back to root-only when `pnpm-workspace.yaml` is missing or
- * unparseable. Uses `node:fs.readdirSync` for directory expansion
- * (portable across platforms — `execFileSync("ls")` is not).
- *
- * @internal
- */
-declare function snapshotFromWorktree(cwd: string): ReadonlyArray<WorkspaceSnapshot>;
-//#endregion
 //#region ../../node_modules/.pnpm/micromark-util-types@2.0.2/node_modules/micromark-util-types/index.d.ts
 /**
  * Enum of allowed token types.
@@ -5262,7 +5477,7 @@ declare const RequiredSectionsRule: import("unified-lint-rule").Plugin<Root, unk
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule: import("unified-lint-rule").Plugin<Root, unknown>;
 declare namespace index_d_exports {
-  export { AggregateDependencyTablesPlugin, AppliedRelease, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PendingChangeset, PendingChangesetSchema, PositiveInteger, PreviewRelease, PreviewReleaseSchema, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown, snapshotFromWorktree };
+  export { AggregateDependencyTablesPlugin, AppliedRelease, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetIOError, ChangesetIOErrorBase, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, DepsRegenOptions, DepsRegenShape, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PendingChangeset, PendingChangesetSchema, PositiveInteger, PreviewRelease, PreviewReleaseSchema, RegenPlan, RegenResult, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };
 }
 //#endregion
 //#region src/commitlint/config/schema.d.ts
@@ -9157,51 +9372,6 @@ declare class BiomeSchemaSync extends BiomeSchemaSync_base {}
  */
 declare const BiomeSchemaSyncLive: Layer.Layer<BiomeSchemaSync, never, FileSystem.FileSystem>;
 //#endregion
-//#region src/services/ChangesetConfig.d.ts
-/**
- * Changeset operating mode for a workspace root.
- * @public
- */
-type ChangesetMode = "silk" | "vanilla" | "none";
-declare const ChangesetConfig_base: Context.TagClass<ChangesetConfig, "@savvy-web/silk-effects/ChangesetConfig", {
-  readonly mode: (root: string) => Effect.Effect<ChangesetMode>;
-  readonly versionPrivate: (root: string) => Effect.Effect<boolean>;
-  readonly ignorePatterns: (root: string) => Effect.Effect<ReadonlyArray<string>>;
-  readonly isIgnored: (name: string, root: string) => Effect.Effect<boolean>;
-  readonly fixed: (root: string) => Effect.Effect<ReadonlyArray<ReadonlyArray<string>>>;
-}>;
-/**
- * Accessor service over a workspace root's `.changeset/config.json`.
- *
- * @remarks
- * Reads through {@link ChangesetConfigReader} (FileSystem-based) with a per-root cache.
- * Every accessor is total (error channel `never`): a missing or unreadable config collapses
- * to `mode: "none"` and empty/false defaults.
- *
- * @since 0.4.0
- * @public
- */
-declare class ChangesetConfig extends ChangesetConfig_base {
-  /**
-   * The one ignore matcher: exact name match, or `@scope/*` wildcard.
-   *
-   * `"@scope/*"` matches `"@scope/anything"` (prefix kept includes the trailing slash),
-   * but not the bare scope `"@scope"`.
-   */
-  static matches(name: string, pattern: string): boolean;
-}
-/**
- * Live {@link ChangesetConfig} reading via {@link ChangesetConfigReader}, cached per root.
- *
- * @remarks
- * Requires `ChangesetConfigReader` (which requires `FileSystem`). Provide
- * `ChangesetConfigReaderLive` + a platform layer (`NodeContext.layer`).
- *
- * @since 0.4.0
- * @public
- */
-declare const ChangesetConfigLive: Layer.Layer<ChangesetConfig, never, ChangesetConfigReader>;
-//#endregion
 //#region src/services/ConfigDiscovery.d.ts
 declare const ConfigDiscovery_base: Context.TagClass<ConfigDiscovery, "@savvy-web/silk-effects/ConfigDiscovery", {
   /**

package/package.json

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