@savvy-web/silk-effects 9.0.2 → 9.1.0

package/changesets/errors.js

@@ -342,6 +342,36 @@ var ChangesetIOError = class extends ChangesetIOErrorBase {
 	}
 };
 /**
+* Base class for {@link HookReplayError}.
+*
+* @privateRemarks
+* Required export for api-extractor (anonymous Data.TaggedError base). Do not delete.
+*
+* @internal
+*/
+const HookReplayErrorBase = Data.TaggedError("HookReplayError");
+/**
+* A workspace snapshot did not replay the config-dependency hooks the ref
+* declares.
+*
+* @remarks
+* Raised by {@link DepsRegen} before diffing when a ref's
+* `pnpm-workspace.yaml` declares `configDependencies` that the snapshot's
+* `hookReplays` record does not account for, or records at a different
+* version. Catalogs that exist only through a config-dependency hook
+* (`catalog:*:peers`) leave no lockfile trace, so a graph wired with a
+* non-replaying `ConfigDependencyHooks` layer would diff them as unchanged
+* and silently drop every `peerDependency` row — the regression this error
+* exists to make loud (savvy-web/systems#674).
+*
+* @public
+*/
+var HookReplayError = class extends HookReplayErrorBase {
+	get message() {
+		return `config dependencies declared at ${this.ref} were not replayed into its workspace snapshot (${this.missing.join(", ")}); the DepsRegen graph must be wired with a replaying ConfigDependencyHooks layer, or hook-injected peer catalogs diff as unchanged`;
+	}
+};
+/**
 * Base class for {@link ReleasePlanError}.
 *
 * @privateRemarks
@@ -367,4 +397,4 @@ var ReleasePlanError = class extends ReleasePlanErrorBase {
 };
 
 //#endregion
-export { ChangesetIOError, ChangesetIOErrorBase, ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, MarkdownParseError, MarkdownParseErrorBase, ReleasePlanError, ReleasePlanErrorBase, VersionFileError, VersionFileErrorBase };
+export { ChangesetIOError, ChangesetIOErrorBase, ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, HookReplayError, HookReplayErrorBase, MarkdownParseError, MarkdownParseErrorBase, ReleasePlanError, ReleasePlanErrorBase, VersionFileError, VersionFileErrorBase };

package/changesets/index.js

@@ -1,6 +1,6 @@
 import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import { Categories } from "./api/categories.js";
-import { ChangesetIOError, ChangesetValidationError, ConfigurationError, GitError, GitHubApiError, MarkdownParseError, ReleasePlanError, VersionFileError } from "./errors.js";
+import { ChangesetIOError, ChangesetValidationError, ConfigurationError, GitError, GitHubApiError, HookReplayError, MarkdownParseError, ReleasePlanError, VersionFileError } from "./errors.js";
 import { JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, VersionFileConfigSchema, VersionFilesSchema } from "./schemas/version-files.js";
 import { GlobSchema, PackageScopeSchema, PackagesRecordSchema } from "./schemas/package-scope.js";
 import { ChangesetOptionsSchema, RepoSchema } from "./schemas/options.js";
@@ -99,6 +99,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	GitHubService: () => GitHubService,
 	GlobSchema: () => GlobSchema,
 	HeadingHierarchyRule: () => HeadingHierarchyRule,
+	HookReplayError: () => HookReplayError,
 	InspectedConfigSchema: () => InspectedConfigSchema,
 	IssueLinkRefsPlugin: () => IssueLinkRefsPlugin,
 	IssueNumberSchema: () => IssueNumberSchema,
@@ -165,4 +166,4 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 });
 
 //#endregion
-export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogTransformer, ChangesetIOError, ChangesetLinter, ChangesetLogMode, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ClassificationReasonSchema, ClassificationSchema, CoexistingChangesetSchema, CommitHashSchema, ConfigInspector, ConfigurationError, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenDefault, FileStatusSchema, GitError, GitHubApiError, GitHubInfoSchema, GitHubService, GlobSchema, HeadingHierarchyRule, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MaintenanceNotePlugin, MaintenanceReasonSchema, MaintenanceTriggerSchema, MarkdownParseError, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScopeSchema, PackagesRecordSchema, PendingChangesetSchema, PositiveInteger, PreviewReleaseSchema, RegenDiffRowSchema, RegenPlanSchema, RegenResultSchema, ReleasePlanError, ReleasePlanner, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeChangelogFunctions, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };
+export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogTransformer, ChangesetIOError, ChangesetLinter, ChangesetLogMode, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ClassificationReasonSchema, ClassificationSchema, CoexistingChangesetSchema, CommitHashSchema, ConfigInspector, ConfigurationError, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenDefault, FileStatusSchema, GitError, GitHubApiError, GitHubInfoSchema, GitHubService, GlobSchema, HeadingHierarchyRule, HookReplayError, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MaintenanceNotePlugin, MaintenanceReasonSchema, MaintenanceTriggerSchema, MarkdownParseError, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScopeSchema, PackagesRecordSchema, PendingChangesetSchema, PositiveInteger, PreviewReleaseSchema, RegenDiffRowSchema, RegenPlanSchema, RegenResultSchema, ReleasePlanError, ReleasePlanner, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeChangelogFunctions, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };

package/changesets/services/deps-regen.js

@@ -1,16 +1,17 @@
-import { ChangesetIOError } from "../errors.js";
+import { ChangesetIOError, HookReplayError } from "../errors.js";
 import { serializeDependencyTableToMarkdown, sortDependencyRows } from "../utils/dependency-table.js";
 import { ChangesetConfigReader } from "../../services/ChangesetConfigReader.js";
 import { ChangesetConfig } from "../../services/ChangesetConfig.js";
 import { SilkPublishability } from "../../services/SilkPublishability.js";
 import { ConfigInspector } from "./config-inspector.js";
 import { computeWorkspaceDependencyDiffs } from "../utils/dep-diff.js";
-import { gitListChangesetFilesAtRef, gitMergeBase } from "../utils/git.js";
+import { gitListChangesetFilesAtRef, gitMergeBase, gitShowFileAtRef } from "../utils/git.js";
 import { listPublishablePackageNames } from "../utils/publishability.js";
 import { Context, Effect, FileSystem, Layer, Option } from "effect";
 import { basename, join, resolve } from "node:path";
 import { Git } from "@effected/git";
 import { PublishabilityDetector, WorkspaceDiscovery, WorkspaceSnapshots, Workspaces } from "@effected/workspaces";
+import { Yaml } from "@effected/yaml";
 
 //#region src/changesets/services/deps-regen.ts
 /**
@@ -45,80 +46,77 @@ import { PublishabilityDetector, WorkspaceDiscovery, WorkspaceSnapshots, Workspa
 * @see {@link DepsRegen} for the service tag
 *
 */
-const ADJECTIVES = [
-	"brave",
-	"clever",
-	"swift",
-	"silver",
-	"lucky",
-	"happy",
-	"calm",
-	"bright",
-	"quiet",
-	"wild"
-];
-const NOUNS = [
-	"dogs",
-	"cats",
-	"wolves",
-	"foxes",
-	"cups",
-	"ships",
-	"trees",
-	"owls",
-	"cranes",
-	"hills"
-];
-const VERBS = [
-	"laugh",
-	"dream",
-	"fly",
-	"sing",
-	"dance",
-	"wander",
-	"soar",
-	"rest",
-	"leap",
-	"ponder"
-];
-function pickRandomTriplet() {
-	return `${ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)]}-${NOUNS[Math.floor(Math.random() * NOUNS.length)]}-${VERBS[Math.floor(Math.random() * VERBS.length)]}`;
-}
 /**
-* Pick a `<adjective>-<noun>-<verb>` filename slug that does not collide
-* with an existing `.changeset/*.md` OR with a slug already claimed
-* earlier in the same {@link RegenPlan.toWrite} computation. `plan()`
-* never writes to disk, so an on-disk existence check alone cannot see
-* slugs chosen moments earlier in the same call — the `chosen` set closes
-* that gap. The triplet space is 1,000 combinations, so a busy repo can
-* plausibly exhaust it across runs; fall back to a timestamp suffix after
-* 20 unlucky picks.
+* Derive a stable, package-derived `.changeset/*.md` basename for a pure
+* dependency changeset, replacing the earlier random
+* `<adjective>-<noun>-<verb>` slug.
+*
+* @remarks
+* A scoped `@scope/name` package joins its scope and name with `-` before
+* appending the `-deps.md` suffix (e.g. `@savvy-web/cli` →
+* `savvy-web-cli-deps.md`); an unscoped `name` package appends the suffix
+* directly. Any character outside `[a-z0-9-]` in the joined name — dots,
+* underscores, uppercase letters — is lowercased or replaced with `-`, and
+* runs of `-` collapse to one, so the result is always a safe, deterministic
+* filename that a stable-filename overwrite can target run after run.
 *
-* @param fileExists - Effectful on-disk existence check (never fails; a
-*   filesystem error is treated as "does not exist" so filename selection
-*   degrades gracefully rather than blocking the plan).
-* @param changesetDir - Directory checked for on-disk collisions.
-* @param chosen - Basenames (without extension) already picked within this plan;
-*   the picked candidate is added to this set before returning.
+* @param packageName - The workspace package name (e.g. `@savvy-web/cli`).
+* @returns The stable changeset basename, including the `.md` extension.
 * @internal
 */
-function randomFilename(fileExists, changesetDir, chosen) {
-	return Effect.gen(function* () {
-		for (let i = 0; i < 20; i++) {
-			const candidate = pickRandomTriplet();
-			if (!chosen.has(candidate) && !(yield* fileExists(join(changesetDir, `${candidate}.md`)))) {
-				chosen.add(candidate);
-				return candidate;
-			}
-		}
-		let attempt = 0;
-		let fallback = `${pickRandomTriplet()}-${Date.now()}`;
-		while (chosen.has(fallback) || (yield* fileExists(join(changesetDir, `${fallback}.md`)))) fallback = `${pickRandomTriplet()}-${Date.now()}-${++attempt}`;
-		chosen.add(fallback);
-		return fallback;
-	});
+function depsChangesetFilename(packageName) {
+	return `${(packageName.startsWith("@") ? packageName.slice(1).replace("/", "-") : packageName).toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/-+/g, "-")}-deps.md`;
 }
 /**
+* Extract `configDependencies` (name → declared version, integrity stripped)
+* from a `pnpm-workspace.yaml` text. Anything unparseable or absent reads as
+* "nothing declared" — the guard built on this can only ever be as strict as
+* the committed evidence.
+*
+* @internal
+*/
+const declaredConfigDependencies = (text) => Effect.gen(function* () {
+	if (Option.isNone(text)) return {};
+	const doc = yield* Yaml.parse(text.value).pipe(Effect.orElseSucceed(() => void 0));
+	if (typeof doc !== "object" || doc === null) return {};
+	const raw = doc.configDependencies;
+	if (typeof raw !== "object" || raw === null) return {};
+	const out = {};
+	for (const [name, spec] of Object.entries(raw)) {
+		if (typeof spec !== "string") continue;
+		const plus = spec.indexOf("+");
+		out[name] = plus === -1 ? spec : spec.slice(0, plus);
+	}
+	return out;
+});
+/**
+* Fail with {@link HookReplayError} unless every config dependency `declared`
+* at `ref` is recorded in `snapshot.hookReplays` at the declared version.
+*
+* @remarks
+* Catalogs injected by a config-dependency hook (`catalog:*:peers`) leave no
+* lockfile trace, so a snapshot taken through a NON-replaying
+* `ConfigDependencyHooks` layer answers them from nothing on both sides and a
+* real floor change produces no `peerDependency` row (savvy-web/systems#674).
+* The kit's replaying layers record every declared dependency in
+* `hookReplays` (and fail typed when one cannot be resolved), so a declared
+* name missing from the record means the graph is mis-wired — the one
+* failure a downstream can detect without replaying anything itself. A ref
+* that declares nothing has nothing to check; a snapshot decoded from a
+* pre-`hookReplays` payload never reaches here (`plan()` reads fresh).
+*
+* @internal
+*/
+const assertHooksReplayed = (ref, declared, snapshot) => {
+	const replays = snapshot.hookReplays ?? {};
+	const missing = Object.entries(declared).filter(([name, version]) => replays[name] !== version).map(([name]) => name);
+	return missing.length === 0 ? Effect.void : Effect.fail(new HookReplayError({
+		ref,
+		declared,
+		missing
+	}));
+};
+/**
 * Strict detection of "pure dependency changesets" per the documented
 * rules: single-package frontmatter, single `## Dependencies` heading,
 * no other body content beyond that section.
@@ -365,6 +363,11 @@ function makeShape(snapshots, inspector, discovery, detector, config, fs, provid
 		}
 		const before = yield* snapshots.at(fromRef);
 		const after = options.to ? yield* snapshots.at(options.to) : yield* snapshots.worktree();
+		const workspaceYaml = "pnpm-workspace.yaml";
+		const declaredBefore = yield* declaredConfigDependencies(yield* gitShowFileAtRef(resolvedCwd, fromRef, workspaceYaml).pipe(Effect.provide(provideGit)));
+		const declaredAfter = yield* declaredConfigDependencies(options.to ? yield* gitShowFileAtRef(resolvedCwd, options.to, workspaceYaml).pipe(Effect.provide(provideGit)) : yield* fs.readFileString(join(resolvedCwd, workspaceYaml)).pipe(Effect.option));
+		yield* assertHooksReplayed(fromRef, declaredBefore, before);
+		yield* assertHooksReplayed(options.to ?? "worktree", declaredAfter, after);
 		const rawDiffs = computeWorkspaceDependencyDiffs(before, after);
 		const explicitTargets = /* @__PURE__ */ new Set([...options.packages ?? [], ...options.package ? [options.package] : []]);
 		const excluded = new Set(options.exclude ?? []);
@@ -407,19 +410,30 @@ function makeShape(snapshots, inspector, discovery, detector, config, fs, provid
 		const rewrittenPackages = new Set(resolved.map((d) => d.package));
 		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();
+		const pureByFile = new Map(existingPure.map((p) => [p.file, p.package]));
+		const claimed = /* @__PURE__ */ new Set();
+		const isFreeFor = (file, pkg) => Effect.gen(function* () {
+			if (claimed.has(file) || !authoredOnBranch(file)) return false;
+			const owner = pureByFile.get(file);
+			if (owner !== void 0) return owner === pkg;
+			return !(yield* fileExists(file));
+		});
 		const toWrite = [];
 		for (const diff of resolved) {
-			const filename = yield* randomFilename(fileExists, changesetDir, chosenFilenames);
+			const stable = depsChangesetFilename(diff.package);
+			const stem = stable.slice(0, -3);
+			let file = join(changesetDir, stable);
+			for (let n = 2; !(yield* isFreeFor(file, diff.package)); n++) file = join(changesetDir, `${stem}-${n}.md`);
+			claimed.add(file);
 			toWrite.push({
-				file: join(changesetDir, `${filename}.md`),
+				file,
 				package: diff.package,
 				diff
 			});
 		}
+		const writeTargets = claimed;
 		return {
-			toDelete,
+			toDelete: existingPure.filter((p) => inScopeFor(p.package) && rewrittenPackages.has(p.package) && authoredOnBranch(p.file) && !writeTargets.has(p.file)),
 			toWrite,
 			skippedMixed,
 			coexisting
@@ -509,4 +523,4 @@ function makeDepsRegenDefault(options) {
 const DepsRegenDefault = makeDepsRegenDefault();
 
 //#endregion
-export { DepsRegen, DepsRegenDefault, isPureDependencyChangeset, makeDepsRegenDefault, parseChangesetPackages };
+export { DepsRegen, DepsRegenDefault, depsChangesetFilename, isPureDependencyChangeset, makeDepsRegenDefault, parseChangesetPackages };

package/changesets/utils/git.js

@@ -1,5 +1,5 @@
 import { GitError } from "../errors.js";
-import { Effect } from "effect";
+import { Effect, Option } from "effect";
 import { basename } from "node:path";
 import { Git } from "@effected/git";
 
@@ -54,6 +54,34 @@ function gitListChangesetFilesAtRef(cwd, ref) {
 		return new Set(entries.filter((entry) => entry.path.trim().length > 0).map((entry) => basename(entry.path)));
 	});
 }
+/**
+* Read one tracked file's contents at `ref` via `git show <ref>:<path>`,
+* as `Option.some(text)`; `Option.none()` when the file is absent at that
+* ref, `cwd` is not a git repository, or `ref` does not resolve.
+*
+* @remarks
+* Tolerant of exactly the three "nothing to read" shapes, for the same
+* reason as {@link gitListChangesetFilesAtRef}: the consumer
+* (`DepsRegen.plan()`'s hook-replay guard) treats them as "nothing
+* declared", and a synthetic ref against a bare tmpdir must not turn a unit
+* test into a git failure. Any OTHER failure — git itself erroring — is a
+* {@link GitError}: swallowing it would let an operational fault read as an
+* empty declaration and silently bypass the guard.
+*
+* @internal
+*/
+function gitShowFileAtRef(cwd, ref, path) {
+	return Effect.gen(function* () {
+		return yield* (yield* Git).show(cwd, ref, path).pipe(Effect.catchTags({
+			NotARepositoryError: () => Effect.succeed(Option.none()),
+			UnknownRefError: () => Effect.succeed(Option.none())
+		}), Effect.mapError((error) => new GitError({
+			command: `git show ${ref}:${path}`,
+			cwd,
+			reason: error.message
+		})));
+	});
+}
 
 //#endregion
-export { gitListChangesetFilesAtRef, gitMergeBase };
+export { gitListChangesetFilesAtRef, gitMergeBase, gitShowFileAtRef };

package/index.d.ts

@@ -2832,6 +2832,43 @@ declare class ChangesetIOError extends ChangesetIOErrorBase<{
 }> {
   get message(): string;
 }
+/**
+ * Base class for {@link HookReplayError}.
+ *
+ * @privateRemarks
+ * Required export for api-extractor (anonymous Data.TaggedError base). Do not delete.
+ *
+ * @internal
+ */
+declare const HookReplayErrorBase: 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: "HookReplayError";
+} & Readonly<A>;
+/**
+ * A workspace snapshot did not replay the config-dependency hooks the ref
+ * declares.
+ *
+ * @remarks
+ * Raised by {@link DepsRegen} before diffing when a ref's
+ * `pnpm-workspace.yaml` declares `configDependencies` that the snapshot's
+ * `hookReplays` record does not account for, or records at a different
+ * version. Catalogs that exist only through a config-dependency hook
+ * (`catalog:*:peers`) leave no lockfile trace, so a graph wired with a
+ * non-replaying `ConfigDependencyHooks` layer would diff them as unchanged
+ * and silently drop every `peerDependency` row — the regression this error
+ * exists to make loud (savvy-web/systems#674).
+ *
+ * @public
+ */
+declare class HookReplayError extends HookReplayErrorBase<{
+  /** The git ref whose snapshot was checked, or `"worktree"`. */
+  readonly ref: string;
+  /** Config dependencies declared at `ref` (name → declared version). */
+  readonly declared: Readonly<Record<string, string>>;
+  /** Declared names absent from, or mismatched in, the snapshot's replay record. */
+  readonly missing: ReadonlyArray<string>;
+}> {
+  get message(): string;
+}
 /**
  * Base class for {@link ReleasePlanError}.
  *
@@ -3856,7 +3893,7 @@ interface DepsRegenOptions {
  *
  * @public
  */
-type DepsRegenPlanError = GitError | ChangesetIOError | WorkspaceDiscoveryFailure | WorkspaceSnapshotAtFailure | WorkspaceSnapshotWorktreeFailure;
+type DepsRegenPlanError = GitError | ChangesetIOError | HookReplayError | WorkspaceDiscoveryFailure | WorkspaceSnapshotAtFailure | WorkspaceSnapshotWorktreeFailure;
 /**
  * Effect service interface for the deps regen/detect orchestration.
  *
@@ -5829,7 +5866,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, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetIOError, ChangesetLinter, ChangesetLogMode, ChangesetLogModeValue, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CoexistingChangeset, CoexistingChangesetSchema, CommitHashSchema, ConfigInspector, ConfigInspectorShape, ConfigurationError, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, DepsRegen, DepsRegenDefault, DepsRegenOptions, DepsRegenPlanError, DepsRegenShape, FileStatus, FileStatusSchema, GitError, GitHubApiError, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubService, GitHubServiceShape, GlobSchema, HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MaintenanceNoteOptions, MaintenanceNotePlugin, MaintenanceReason, MaintenanceReasonSchema, MaintenanceTrigger, MaintenanceTriggerSchema, MakeChangelogFunctionsOptions, MarkdownParseError, 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, RegenDiffRow, RegenDiffRowSchema, RegenPlan, RegenPlanSchema, RegenResult, RegenResultSchema, ReleasePlanError, ReleasePlanner, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, TransformOptions, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeChangelogFunctions, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };
+  export { AggregateDependencyTablesPlugin, AppliedRelease, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetIOError, ChangesetLinter, ChangesetLogMode, ChangesetLogModeValue, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CoexistingChangeset, CoexistingChangesetSchema, CommitHashSchema, ConfigInspector, ConfigInspectorShape, ConfigurationError, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, DepsRegen, DepsRegenDefault, DepsRegenOptions, DepsRegenPlanError, DepsRegenShape, FileStatus, FileStatusSchema, GitError, GitHubApiError, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubService, GitHubServiceShape, GlobSchema, HeadingHierarchyRule, HookReplayError, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MaintenanceNoteOptions, MaintenanceNotePlugin, MaintenanceReason, MaintenanceReasonSchema, MaintenanceTrigger, MaintenanceTriggerSchema, MakeChangelogFunctionsOptions, MarkdownParseError, 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, RegenDiffRow, RegenDiffRowSchema, RegenPlan, RegenPlanSchema, RegenResult, RegenResultSchema, ReleasePlanError, ReleasePlanner, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, TransformOptions, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeChangelogFunctions, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };
 }
 //#endregion
 //#region src/commitlint/config/schema.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/silk-effects",
-	"version": "9.0.2",
+	"version": "9.1.0",
 	"private": false,
 	"description": "Shared Effect library for Silk Suite conventions",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/silk-effects",
@@ -43,7 +43,7 @@
 		"@effected/walker": "^0.10.0",
 		"@effected/yaml": "^0.16.0",
 		"@manypkg/get-packages": "^3.1.0",
-		"@savvy-web/silk-core": "0.4.2",
+		"@savvy-web/silk-core": "0.4.3",
 		"mdast-util-heading-range": "^4.0.0",
 		"mdast-util-to-string": "^4.0.0",
 		"remark-gfm": "^4.0.1",
@@ -58,7 +58,7 @@
 		"@effected/commands": "^0.8.0",
 		"@effected/git": "^0.16.0",
 		"@effected/templates": "^0.7.0",
-		"@effected/workspaces": "^0.23.0",
+		"@effected/workspaces": "^0.24.0",
 		"effect": "4.0.0-rc.116"
 	}
 }