@savvy-web/silk 1.3.6 → 1.3.7

package/changesets-markdownlint.d.cts

@@ -3298,7 +3298,105 @@ type Label = Label$1;
 type Severity = Severity$1;
 type Plugin<Tree extends Node$3 = Node$3, Option extends unknown = unknown> = (config?: [level: Label | Severity | boolean, option?: Option] | Label | Option | Severity) => ((tree: Tree, file: VFile, next: TransformCallback<Tree>) => undefined) | undefined;
 //#endregion
+//#region ../../node_modules/.pnpm/@pnpm+catalogs.types@1100.0.0/node_modules/@pnpm/catalogs.types/lib/index.d.ts
+/**
+ * Catalogs parsed from the pnpm-workspace.yaml file.
+ *
+ * https://github.com/pnpm/rfcs/pull/1
+ */
+interface Catalogs {
+  /**
+   * The default catalog.
+   *
+   * The default catalog can be defined in 2 ways.
+   *
+   *   1. Users can specify a top-level "catalog" field or,
+   *   2. An explicitly named "default" catalog under the "catalogs" map.
+   *
+   * This field contains either definition. Note that it's an error to define
+   * the default catalog using both options. The parser will fail when reading
+   * the workspace manifest.
+   */
+  readonly default?: Catalog;
+  /**
+   * Named catalogs.
+   */
+  readonly [catalogName: string]: Catalog | undefined;
+}
+interface Catalog {
+  readonly [dependencyName: string]: string | undefined;
+}
+//#endregion
 //#region ../../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.d.ts
+/**
+ * Raised when assembling the workspace catalog set fails irrecoverably
+ * (e.g. `pnpm-workspace.yaml` unreadable/malformed, default catalog defined twice).
+ * Per-config-dependency hook failures do NOT raise this — they are logged and skipped.
+ *
+ * @public
+ */
+declare class CatalogAssemblyError extends CatalogAssemblyErrorBase<{
+  readonly source: "manifest" | "config-dependency" | "lockfile";
+  readonly reason: string;
+}> {
+  get message(): string;
+}
+/**
+ * Base constant for {@link CatalogAssemblyError}.
+ *
+ * @privateRemarks
+ * Exported for api-extractor DTS bundling — the `_base` symbol from
+ * `Data.TaggedError` must be visible in the generated .d.ts file.
+ *
+ * @internal
+ */
+declare const CatalogAssemblyErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => YieldableError & {
+  readonly _tag: "CatalogAssemblyError";
+} & Readonly<A>;
+/**
+ * Raised when a `catalog:`/`workspace:` specifier in a manifest cannot be resolved
+ * (unknown catalog, catalog misconfiguration, or unresolvable workspace reference).
+ *
+ * @public
+ */
+declare class CatalogResolutionError extends CatalogResolutionErrorBase<{
+  readonly field: string;
+  readonly dependency: string;
+  readonly specifier: string;
+  readonly reason: string;
+}> {
+  get message(): string;
+}
+/**
+ * Base constant for {@link CatalogResolutionError}.
+ *
+ * @privateRemarks
+ * Exported for api-extractor DTS bundling — the `_base` symbol from
+ * `Data.TaggedError` must be visible in the generated .d.ts file.
+ *
+ * @internal
+ */
+declare const CatalogResolutionErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => YieldableError & {
+  readonly _tag: "CatalogResolutionError";
+} & Readonly<A>;
+/**
+ * Resolves a workspace's catalogs and rewrites catalog:/workspace: specifiers.
+ *
+ * @remarks
+ * Assembles the complete catalog set — inline `pnpm-workspace.yaml` catalogs,
+ * catalogs injected by config dependencies (via pnpmfile `updateConfig` replay),
+ * and lockfile catalogs — without depending on the transient workspace-state file.
+ *
+ * @public
+ */
+declare class CatalogResolver extends CatalogResolver_base {}
+declare const CatalogResolver_base: Context.TagClass<CatalogResolver, "@spencerbeggs/workspaces-effect/CatalogResolver", {
+  /** The complete assembled catalog set for the workspace (cached). */readonly catalogs: () => Effect.Effect<Catalogs, CatalogResolverError>; /** Rewrite all catalog:/workspace: specifiers in a manifest to concrete specs. */
+  readonly resolve: (manifest: ManifestLike) => Effect.Effect<ManifestLike, CatalogResolverError | CatalogResolutionError>; /** Resolve a single dependency specifier; None when no rewrite is needed. */
+  readonly resolveSpecifier: (dependency: string, specifier: string) => Effect.Effect<Option.Option<string>, CatalogResolverError | CatalogResolutionError>;
+}>;
+/** Errors surfaced by CatalogResolver methods (assembly defers I/O to first call). */
+declare type CatalogResolverError = CatalogAssemblyError | LockfileInitError;
 /**
  * Result of comparing two WorkspacePackage dependency snapshots.
  * @public
@@ -3311,6 +3409,122 @@ declare interface DependencyDiff {
     readonly to: string;
   }>;
 }
+/**
+ * Union of errors that may surface from {@link LockfileReader} method calls
+ * because the live layer defers workspace-root discovery, package-manager
+ * detection, and lockfile read/parse to the first invocation.
+ *
+ * @public
+ */
+declare type LockfileInitError = WorkspaceRootNotFoundError | PackageManagerDetectionError | LockfileReadError | LockfileParseError;
+/**
+ * Emitted when a lockfile exists but cannot be parsed.
+ *
+ * @remarks
+ * Raised by {@link LockfileReader} when the lockfile is successfully read from
+ * disk but its contents cannot be parsed into the expected format. Each package
+ * manager has a different lockfile format (YAML for pnpm, JSON for npm/bun,
+ * custom format for yarn Berry).
+ *
+ * Fields:
+ * - `lockfilePath` — absolute path to the lockfile that failed to parse.
+ * - `format` — the package manager format that was attempted (`"pnpm"`, `"npm"`, `"yarn"`, or `"bun"`).
+ * - `cause` — the underlying parse error.
+ *
+ * @example Catching the error
+ * ```typescript
+ * import { Effect } from "effect";
+ * import type { LockfileParseError } from "workspaces-effect";
+ * import { LockfileReader, LockfileReaderLive } from "workspaces-effect";
+ *
+ * const program = Effect.gen(function* () {
+ *   const reader = yield* LockfileReader;
+ *   return yield* reader.read("/workspace/root");
+ * }).pipe(
+ *   Effect.catchTag("LockfileParseError", (e) =>
+ *     Effect.logError(`Cannot parse ${e.format} lockfile at ${e.lockfilePath}`)
+ *   )
+ * );
+ * ```
+ *
+ * @public
+ */
+declare class LockfileParseError extends LockfileParseErrorBase<{
+  readonly lockfilePath: string;
+  readonly format: "pnpm" | "npm" | "yarn" | "bun";
+  readonly cause: unknown;
+}> {
+  get message(): string;
+}
+/**
+ * Base constant for {@link LockfileParseError}.
+ *
+ * @privateRemarks
+ * Exported for api-extractor DTS bundling — the `_base` symbol from
+ * `Data.TaggedError` must be visible in the generated .d.ts file.
+ *
+ * @internal
+ */
+declare const LockfileParseErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => YieldableError & {
+  readonly _tag: "LockfileParseError";
+} & Readonly<A>;
+/**
+ * Emitted when a lockfile cannot be read from disk.
+ *
+ * @remarks
+ * Raised by {@link LockfileReader} when the expected lockfile for the detected
+ * package manager (e.g., `pnpm-lock.yaml`, `package-lock.json`, `yarn.lock`,
+ * `bun.lock`) does not exist or cannot be read due to filesystem permissions.
+ *
+ * Fields:
+ * - `lockfilePath` — absolute path to the lockfile that could not be read.
+ * - `reason` — human-readable explanation (e.g., "file not found", "permission denied").
+ *
+ * @example Catching the error
+ * ```typescript
+ * import { Effect } from "effect";
+ * import type { LockfileReadError } from "workspaces-effect";
+ * import { LockfileReader, LockfileReaderLive } from "workspaces-effect";
+ *
+ * const program = Effect.gen(function* () {
+ *   const reader = yield* LockfileReader;
+ *   return yield* reader.read("/workspace/root");
+ * }).pipe(
+ *   Effect.catchTag("LockfileReadError", (e) =>
+ *     Effect.logWarning(`No lockfile at ${e.lockfilePath}: ${e.reason}`)
+ *   )
+ * );
+ * ```
+ *
+ * @public
+ */
+declare class LockfileReadError extends LockfileReadErrorBase<{
+  readonly lockfilePath: string;
+  readonly reason: string;
+}> {
+  get message(): string;
+}
+/**
+ * Base constant for {@link LockfileReadError}.
+ *
+ * @privateRemarks
+ * Exported for api-extractor DTS bundling — the `_base` symbol from
+ * `Data.TaggedError` must be visible in the generated .d.ts file.
+ *
+ * @internal
+ */
+declare const LockfileReadErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => YieldableError & {
+  readonly _tag: "LockfileReadError";
+} & Readonly<A>;
+declare interface ManifestLike {
+  readonly name: string;
+  readonly version: string;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+  optionalDependencies?: Record<string, string>;
+  [k: string]: unknown;
+}
 /**
  * Emitted when a package.json file cannot be parsed or validated.
  *
@@ -3415,6 +3629,54 @@ declare const PackageJsonSchema: Schema.Struct<{
  * @public
  */
 declare type PackageJsonType = Schema.Schema.Type<typeof PackageJsonSchema>;
+/**
+ * Emitted when the package manager type cannot be determined.
+ *
+ * @remarks
+ * Raised by {@link PackageManagerDetector} when heuristics (lockfile presence,
+ * `packageManager` field in root package.json) fail to identify a single
+ * package manager for the workspace.
+ *
+ * Fields:
+ * - `searchPath` — the workspace root path that was inspected.
+ * - `reason` — human-readable explanation of the detection failure.
+ *
+ * @example Catching the error
+ * ```typescript
+ * import { Effect } from "effect";
+ * import type { PackageManagerDetectionError } from "workspaces-effect";
+ * import { PackageManagerDetector, PackageManagerDetectorLive } from "workspaces-effect";
+ *
+ * const program = Effect.gen(function* () {
+ *   const detector = yield* PackageManagerDetector;
+ *   return yield* detector.detect("/workspace/root");
+ * }).pipe(
+ *   Effect.catchTag("PackageManagerDetectionError", (e) =>
+ *     Effect.succeed(`Could not detect PM at ${e.searchPath}: ${e.reason}`)
+ *   )
+ * );
+ * ```
+ *
+ * @public
+ */
+declare class PackageManagerDetectionError extends PackageManagerDetectionErrorBase<{
+  readonly searchPath: string;
+  readonly reason: string;
+}> {
+  get message(): string;
+}
+/**
+ * Base constant for {@link PackageManagerDetectionError}.
+ *
+ * @privateRemarks
+ * Exported for api-extractor DTS bundling — the `_base` symbol from
+ * `Data.TaggedError` must be visible in the generated .d.ts file.
+ *
+ * @internal
+ */
+declare const PackageManagerDetectionErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => YieldableError & {
+  readonly _tag: "PackageManagerDetectionError";
+} & Readonly<A>;
 /**
  * Emitted when a named package is not found in the workspace.
  *
@@ -4027,6 +4289,54 @@ declare const WorkspacePackage_base: Schema.Class<WorkspacePackage, {
  *
  * @public
  */
+/**
+ * Emitted when no workspace root can be found from the search path.
+ *
+ * @remarks
+ * Raised by {@link WorkspaceRoot} when directory traversal from the search path
+ * to the filesystem root finds no workspace markers (pnpm-workspace.yaml or
+ * package.json with workspaces field).
+ *
+ * Fields:
+ * - `searchPath` — the absolute path from which upward traversal started.
+ * - `reason` — human-readable explanation of why no root was found.
+ *
+ * @example Catching the error
+ * ```typescript
+ * import { Effect } from "effect";
+ * import type { WorkspaceRootNotFoundError } from "workspaces-effect";
+ * import { WorkspaceRoot, WorkspaceRootLive } from "workspaces-effect";
+ *
+ * const program = Effect.gen(function* () {
+ *   const root = yield* WorkspaceRoot;
+ *   return yield* root.find("/some/path");
+ * }).pipe(
+ *   Effect.catchTag("WorkspaceRootNotFoundError", (e) =>
+ *     Effect.succeed(`Fallback: ${e.searchPath}`)
+ *   )
+ * );
+ * ```
+ *
+ * @public
+ */
+declare class WorkspaceRootNotFoundError extends WorkspaceRootNotFoundErrorBase<{
+  readonly searchPath: string;
+  readonly reason: string;
+}> {
+  get message(): string;
+}
+/**
+ * Base constant for {@link WorkspaceRootNotFoundError}.
+ *
+ * @privateRemarks
+ * Exported for api-extractor DTS bundling — the `_base` symbol from
+ * `Data.TaggedError` must be visible in the generated .d.ts file.
+ *
+ * @internal
+ */
+declare const WorkspaceRootNotFoundErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => YieldableError & {
+  readonly _tag: "WorkspaceRootNotFoundError";
+} & Readonly<A>;
 //#endregion
 //#region ../silk-effects/dist/dev/pkg/index.d.ts
 //#region \0rolldown/runtime.js
@@ -5585,6 +5895,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.
  *
@@ -5857,7 +6177,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
@@ -5871,11 +6191,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
@@ -5894,9 +6215,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;
   /**
@@ -5929,9 +6251,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
@@ -6016,7 +6338,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
@@ -6027,7 +6349,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.
@@ -7453,6 +7775,228 @@ declare const ChangelogServiceBase: Context.TagClass<ChangelogService, "Changelo
  * @public
  */
 declare class ChangelogService extends ChangelogServiceBase {} //#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/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/services/deps-regen.d.ts
+/**
+ * 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
+ */
+declare const resolveDiffRows: (diff: WorkspaceDependencyDiff, keepDevDeps?: boolean) => Effect.Effect<WorkspaceDependencyDiff, never, CatalogResolver>;
+/**
+ * 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 {@link snapshotFromWorktree}.
+   */
+  readonly to?: string;
+}
+/**
+ * Effect service interface for the deps regen/detect orchestration.
+ *
+ * @public
+ */
+interface DepsRegenShape {
+  /**
+   * Compute a complete {@link RegenPlan} without touching the filesystem.
+   *
+   * @param options - See {@link DepsRegenOptions}.
+   * @returns An Effect yielding the plan, or failing with {@link GitError}.
+   */
+  readonly plan: (options: DepsRegenOptions) => Effect.Effect<RegenPlan, GitError | WorkspaceDiscoveryError, never>;
+  /**
+   * Apply a {@link RegenPlan}: delete stale changesets, write fresh ones.
+   *
+   * @param plan - The plan produced by {@link DepsRegenShape.plan}.
+   * @returns An Effect yielding a {@link RegenResult}.
+   */
+  readonly execute: (plan: RegenPlan) => Effect.Effect<RegenResult, never, 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 {@link WorkspaceSnapshotReader}, {@link ConfigInspector},
+ * `WorkspaceDiscovery`, `CatalogResolver`, and `PublishabilityDetector`
+ * (the last three from `workspaces-effect`).
+ *
+ * @public
+ */
+declare const DepsRegenLive: Layer.Layer<DepsRegen, never, WorkspaceSnapshotReader | ConfigInspector | WorkspaceDiscovery | CatalogResolver | PublishabilityDetector>; //#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"]>;
@@ -7565,60 +8109,6 @@ declare function makeReleasePlannerTest(fixed: {
   readonly preview?: ChangesetPreview;
   readonly apply?: AppliedRelease;
 }): Layer.Layer<ReleasePlanner>; //#endregion
-//#region src/changesets/services/workspace-snapshot.d.ts
-/**
- * One workspace package as it existed at a specific git ref.
- *
- * @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).
@@ -8254,33 +8744,6 @@ declare const LegacyVersionFilesSchema: Schema.Array$<Schema.Struct<{
   paths: Schema.optional<Schema.Array$<Schema.filter<typeof Schema.String>>>; /** Workspace package name to source the version from, bypassing path-based resolution. */
   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.
@@ -9199,7 +9662,7 @@ declare const RequiredSectionsRule$2: Plugin<Root, unknown>; //#endregion
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule$2: 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$2 as ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$2 as 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$2 as 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$2 as RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules$1 as SilkChangesetsRules, UncategorizedContentRule$2 as 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, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule$2 as ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$2 as DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, DepsRegen, DepsRegenBase, DepsRegenLive, DepsRegenOptions, DepsRegenShape, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule$2 as 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$2 as RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules$1 as SilkChangesetsRules, UncategorizedContentRule$2 as UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, resolveDiffRows, serializeDependencyTableToMarkdown, snapshotFromWorktree };
 } //#endregion
 //#region src/commitlint/config/schema.d.ts
 /**