@savvy-web/silk 3.8.2 → 3.8.4

package/changesets-changelog.cjs

@@ -2335,7 +2335,7 @@ var GlobSet = class GlobSet extends effect.Schema.Class("GlobSet")(effect.Schema
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/BunExtension.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/BunExtension.js
 /**
 * Extension data specific to bun lockfiles, attached to `Lockfile.extension`
 * when the format is `"bun"`.
@@ -2356,7 +2356,7 @@ var BunExtension = class extends effect.Schema.Class("BunExtension")({
 	trustedDependencies: effect.Schema.optionalKey(effect.Schema.Array(effect.Schema.String))
 }) {};
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.11.0_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/CatalogResolver.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.11.1_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/CatalogResolver.js
 /**
 * Contract for resolving pnpm `catalog:` dependency specifiers to concrete
 * version ranges.
@@ -2402,7 +2402,7 @@ var CatalogResolver = class CatalogResolver extends effect.Context.Service()("@e
 	static noop = effect.Layer.succeed(CatalogResolver, { rangeOf: () => effect.Effect.succeed(effect.Option.none()) });
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.11.0_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/WorkspaceResolver.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.11.1_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/WorkspaceResolver.js
 /**
 * Raised when a `catalog:` or `workspace:` specifier cannot be resolved
 * because the resolution mechanism itself failed — not for an ordinary
@@ -2463,7 +2463,7 @@ var WorkspaceResolver = class WorkspaceResolver extends effect.Context.Service()
 	static noop = effect.Layer.succeed(WorkspaceResolver, { versionOf: () => effect.Effect.succeed(effect.Option.none()) });
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.11.0_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/CatalogAssemblyError.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.11.1_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/CatalogAssemblyError.js
 /**
 * Raised when a workspace's catalogs cannot be assembled — a `pnpm-workspace.yaml`
 * that is unreadable or not valid YAML, a root `package.json` `workspaces` field
@@ -2507,7 +2507,7 @@ var CatalogAssemblyError = class extends effect.Schema.TaggedError()("CatalogAss
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.11.0_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/DependencySection.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.11.1_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/DependencySection.js
 /**
 * The short dependency kind: which dependency map an entry came from, named the
 * way consumers branch on it.
@@ -4122,7 +4122,7 @@ const isComparatorSetSubset = (sub, sup) => {
 	return true;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.11.0_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/DependencySpecifier.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.11.1_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/DependencySpecifier.js
 /**
 * Indicates that a string could not be parsed as a valid dependency specifier.
 *
@@ -4329,7 +4329,7 @@ const DependencySpecifier = Object.assign(brandedSpecifier, {
 	FromString: fromString
 });
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.11.0_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/IntegrityHash.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.11.1_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/IntegrityHash.js
 const SRI_RE = /^(sha1|sha256|sha384|sha512)-[A-Za-z0-9+/]+={0,2}$/;
 const COREPACK_RE = /^(sha1|sha224|sha256|sha384|sha512)\.[0-9a-f]+$/;
 const YARN_RE = /^[0-9]+(c[0-9]+)?\/[0-9a-f]+$/;
@@ -4383,6 +4383,13 @@ const IntegrityHash = Object.assign(brandedIntegrity, {
 });
 const corepackRestricted = brandedIntegrity.pipe(effect.Schema.check(effect.Schema.makeFilter((value) => isCorepack(value) ? void 0 : "Expected a corepack (<algo>.<hex>) integrity hash")));
 const BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+const BASE64_INVALID = 255;
+const BASE64_INDEX = (() => {
+	const table = new Uint8Array("z".charCodeAt(0) + 1);
+	table.fill(BASE64_INVALID);
+	for (let index = 0; index < 64; index += 1) table[BASE64_ALPHABET.charCodeAt(index)] = index;
+	return table;
+})();
 const decodeBase64 = (value) => {
 	const firstPad = value.indexOf("=");
 	const body = firstPad === -1 ? value : value.slice(0, firstPad);
@@ -4394,9 +4401,11 @@ const decodeBase64 = (value) => {
 	let buffer = 0;
 	let bits = 0;
 	const bytes = [];
-	for (const char of body) {
-		const sextet = BASE64_ALPHABET.indexOf(char);
-		if (sextet < 0) return void 0;
+	for (let index = 0; index < body.length; index += 1) {
+		const code = body.charCodeAt(index);
+		if (code >= BASE64_INDEX.length) return void 0;
+		const sextet = BASE64_INDEX[code];
+		if (sextet === BASE64_INVALID) return void 0;
 		buffer = buffer << 6 | sextet;
 		bits += 6;
 		if (bits >= 8) {
@@ -5399,7 +5408,7 @@ var Run = class {
 	static REDACTED = "***";
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.11.0_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/ReleaseAgeGate.js
+//#region ../../node_modules/.pnpm/@effected+npm@0.11.1_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/ReleaseAgeGate.js
 const MS_PER_MINUTE = 6e4;
 /**
 * A source's partial contribution to a {@link ReleaseAgeGate}: the effective
@@ -5569,7 +5578,7 @@ var ReleaseAgeGate = class ReleaseAgeGate extends effect.Schema.Class("ReleaseAg
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/ImporterDependency.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/ImporterDependency.js
 /**
 * One declared dependency of one workspace importer, as the lockfile records it.
 *
@@ -5607,7 +5616,7 @@ var ImporterDependency = class extends effect.Schema.Class("ImporterDependency")
 	depType: DependencyField
 }) {};
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/LockfileImporter.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/LockfileImporter.js
 /**
 * One workspace importer's declared dependencies, as the lockfile records them.
 *
@@ -5631,7 +5640,7 @@ var LockfileImporter = class extends effect.Schema.Class("LockfileImporter")({
 	dependencies: effect.Schema.Array(ImporterDependency)
 }) {};
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/ResolvedPackage.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/ResolvedPackage.js
 const EMPTY_DEPENDENCIES = {};
 const EMPTY_PEER_META = {};
 const EMPTY_EDGE_NAMES = [];
@@ -5721,7 +5730,7 @@ var ResolvedPackage = class extends effect.Schema.Class("ResolvedPackage")({
 	unresolvedEdges: effect.Schema.Array(effect.Schema.String).pipe(effect.Schema.withDecodingDefaultKey(effect.Effect.succeed(EMPTY_EDGE_NAMES)), effect.Schema.withConstructorDefault(effect.Effect.succeed(EMPTY_EDGE_NAMES)))
 }) {};
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/WorkspaceDependency.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/WorkspaceDependency.js
 /**
 * A directed dependency edge between two workspace packages as recorded in
 * the lockfile.
@@ -5743,7 +5752,7 @@ var WorkspaceDependency = class extends effect.Schema.Class("WorkspaceDependency
 	constraint: effect.Schema.String
 }) {};
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/PnpmExtension.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/PnpmExtension.js
 /**
 * Extension data specific to pnpm lockfiles, attached to `Lockfile.extension`
 * when the format is `"pnpm"`.
@@ -5768,7 +5777,7 @@ var PnpmExtension = class extends effect.Schema.Class("PnpmExtension")({
 	}))
 }) {};
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/LockfileFormat.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/LockfileFormat.js
 /**
 * The lockfile formats this package parses: bun's `bun.lock` (JSONC), npm's
 * `package-lock.json` (JSON), pnpm's `pnpm-lock.yaml` and yarn Berry's
@@ -5810,7 +5819,7 @@ const FILENAMES = {
 */
 const filenameFor = (format) => FILENAMES[format][0];
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/internal/shared.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/internal/shared.js
 /**
 * The four dependency sections of a manifest, in a stable order — the shared
 * dependency-sections table (v3's `DEP_SECTIONS`). Each entry is both the
@@ -7812,7 +7821,7 @@ var JsoncModifier = class {
 	});
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/internal/bun.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/internal/bun.js
 const DepRecord$2 = effect.Schema.optionalKey(effect.Schema.Record(effect.Schema.String, effect.Schema.String));
 const OptionalPeers = effect.Schema.optionalKey(effect.Schema.Array(effect.Schema.String));
 const BunWorkspaceEntry = effect.Schema.Struct({
@@ -7989,7 +7998,7 @@ const toFields$3 = (raw) => effect.Effect.gen(function* () {
 	};
 });
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/internal/npm.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/internal/npm.js
 const DepRecord$1 = effect.Schema.optionalKey(effect.Schema.Record(effect.Schema.String, effect.Schema.String));
 const PeerMetaRecord = effect.Schema.optionalKey(effect.Schema.Record(effect.Schema.String, effect.Schema.Struct({ optional: effect.Schema.optionalKey(effect.Schema.Boolean) })));
 const NpmPackageEntry = effect.Schema.Struct({
@@ -15857,7 +15866,7 @@ function deepEqualValues(a, b) {
 	return false;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/internal/documents.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/internal/documents.js
 /**
 * An empty YAML document composes to `null` (`Yaml.parseAll("")` is `[null]`,
 * and the trailing document of an env-only `pnpm-lock.yaml` is `null` too).
@@ -15927,7 +15936,7 @@ const selectSoleDocument = (content) => effect.Effect.gen(function* () {
 	};
 });
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/internal/pnpm.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/internal/pnpm.js
 const PnpmImporterDeps = effect.Schema.optionalKey(effect.Schema.Record(effect.Schema.String, effect.Schema.Struct({
 	specifier: effect.Schema.String,
 	version: effect.Schema.String
@@ -15936,7 +15945,8 @@ const PnpmImporter = effect.Schema.Struct({
 	dependencies: PnpmImporterDeps,
 	devDependencies: PnpmImporterDeps,
 	peerDependencies: PnpmImporterDeps,
-	optionalDependencies: PnpmImporterDeps
+	optionalDependencies: PnpmImporterDeps,
+	publishDirectory: effect.Schema.optionalKey(effect.Schema.String)
 });
 /**
 * The version gate's own input: `lockfileVersion` and nothing else.
@@ -16011,9 +16021,23 @@ const parsePnpm = (content) => effect.Effect.gen(function* () {
 * resolution, which names no instance in this lockfile, from becoming a
 * plausible lie.
 *
+* A failed composition gets one second reading: the recorded version ITSELF as
+* an instance id. That is how pnpm spells an `npm:` alias — the dependency
+* `typescript-classic: npm:typescript@^6.0.3` is recorded as
+* `typescript-classic: typescript@6.0.3`, the referenced instance's own key,
+* peer suffix included when one applies. Still compose-then-verify, not a
+* guess: a plain version (`6.0.3`) can never be an instance id, because ids
+* always carry a name, so the reading admits exactly the alias shape.
+*
+* Unlike {@link resolveImporterEdges}, there is no `workspace:`-specifier
+* ancestor walk here — a snapshot body records no specifier, so that evidence
+* does not exist on this path. The publish-directory map needs no specifier:
+* the importer entry's own `publishDirectory` declaration is exact evidence,
+* available to both paths, and is consulted unconditionally.
+*
 * @internal
 */
-const resolveEdges = (sections, instanceIds) => {
+const resolveEdges = (sections, instanceIds, publishDirTargets) => {
 	const edges = /* @__PURE__ */ new Map();
 	const unnameable = /* @__PURE__ */ new Set();
 	for (const section of sections) {
@@ -16023,11 +16047,13 @@ const resolveEdges = (sections, instanceIds) => {
 			if (version.startsWith(LINK_PREFIX)) {
 				const target = resolveLinkTarget("", version.slice(LINK_PREFIX.length));
 				if (target !== void 0 && instanceIds.has(target)) edges.set(name, target);
+				else if (target !== void 0 && publishDirTargets.has(target)) edges.set(name, publishDirTargets.get(target));
 				else unnameable.add(name);
 				continue;
 			}
 			const bare = `${name}@${version}`;
 			if (instanceIds.has(bare)) edges.set(name, bare);
+			else if (instanceIds.has(version)) edges.set(name, version);
 			else unnameable.add(name);
 		}
 	}
@@ -16043,6 +16069,13 @@ const LINK_PREFIX = "link:";
 * workspace edge can name the workspace importer's instance id.
 * Total: a target that walks above the root yields `undefined`.
 *
+* A target that normalizes to NOTHING — `link:.` recorded root-relative —
+* also yields `undefined` rather than the root importer's ".": the root
+* importer deliberately emits no `ResolvedPackage` row (its path cannot serve
+* as a package name), so mapping the empty target to "." would hand back an id
+* no row carries, and no pnpm output recording that shape has been observed.
+* The edge stays honestly unnameable instead.
+*
 * @internal
 */
 const resolveLinkTarget = (importerPath, target) => {
@@ -16089,22 +16122,28 @@ const owningImporter = (target, importerPaths) => {
 * naming another importer — normalized against this importer's own path. Both
 * are checked against the lockfile's instance ids before being emitted.
 *
-* A `link:` target that is no importer gets one further chance, and only under
-* a `workspace:` SPECIFIER: pnpm resolved that edge through the workspace, so
-* the target directory is known to belong to a workspace package, and
-* {@link owningImporter} names it. The specifier is what makes this a
-* resolution rather than a guess — a hand-written `link:../vendor/stub`
-* specifier names a directory pnpm never claimed was a workspace package, and
-* attributing it to whichever importer happens to contain it would answer with
-* the wrong package's peers instead of admitting it could not name the edge.
-*
-* The snapshot path ({@link resolveEdges}) deliberately does NOT do this: a
-* snapshot body records `name: link:<path>` with no specifier beside it, so the
-* evidence this rule turns on is not available there.
+* A `link:` target that is no importer gets two further chances. First the
+* publish-directory map: an importer that DECLARES `publishDirectory` has told
+* the lockfile exactly which build directory its links point at, so a target
+* matching a declared publish directory names that importer on evidence, no
+* specifier required — {@link resolveEdges} consults the same map for the same
+* reason. Then, and only under a `workspace:` SPECIFIER, the ancestor walk:
+* pnpm resolved that edge through the workspace, so the target directory is
+* known to belong to a workspace package, and {@link owningImporter} names it.
+* The specifier is what makes the walk a resolution rather than a guess — a
+* hand-written `link:../vendor/stub` specifier names a directory pnpm never
+* claimed was a workspace package, and attributing it to whichever importer
+* happens to contain it would answer with the wrong package's peers instead of
+* admitting it could not name the edge. The snapshot path has no specifier and
+* therefore no walk; the publish-directory map is the evidence it does get.
+*
+* A failed `name@version` composition gets the same alias reading as
+* {@link resolveEdges}: the recorded version itself as an instance id, which is
+* how pnpm spells `npm:` aliases.
 *
 * @internal
 */
-const resolveImporterEdges = (importer, importerPath, instanceIds, importerPaths) => {
+const resolveImporterEdges = (importer, importerPath, instanceIds, importerPaths, publishDirTargets) => {
 	const edges = /* @__PURE__ */ new Map();
 	const unnameable = /* @__PURE__ */ new Set();
 	for (const group of importerDepGroups(importer)) {
@@ -16113,13 +16152,14 @@ const resolveImporterEdges = (importer, importerPath, instanceIds, importerPaths
 			if (name === "") continue;
 			if (info.version.startsWith(LINK_PREFIX)) {
 				const target = resolveLinkTarget(importerPath, info.version.slice(5));
-				const owner = target === void 0 ? void 0 : instanceIds.has(target) ? target : info.specifier.startsWith(WORKSPACE_PREFIX) ? owningImporter(target, importerPaths) : void 0;
+				const owner = target === void 0 ? void 0 : instanceIds.has(target) ? target : publishDirTargets.get(target) ?? (info.specifier.startsWith(WORKSPACE_PREFIX) ? owningImporter(target, importerPaths) : void 0);
 				if (owner !== void 0) edges.set(name, owner);
 				else unnameable.add(name);
 				continue;
 			}
 			const bare = `${name}@${info.version}`;
 			if (instanceIds.has(bare)) edges.set(name, bare);
+			else if (instanceIds.has(info.version)) edges.set(name, info.version);
 			else unnameable.add(name);
 		}
 	}
@@ -16175,6 +16215,13 @@ const toFields$1 = (raw) => effect.Effect.gen(function* () {
 		...Object.keys(raw.importers)
 	]);
 	const importerPaths = new Set(Object.keys(raw.importers).filter((path) => path !== "." && path !== ""));
+	const publishDirTargets = /* @__PURE__ */ new Map();
+	for (const [importerPath, importer] of Object.entries(raw.importers)) {
+		if (importerPath === "") continue;
+		if (importer.publishDirectory === void 0) continue;
+		const key = resolveLinkTarget(importerPath, importer.publishDirectory);
+		if (key !== void 0) publishDirTargets.set(key, importerPath);
+	}
 	const emitted = /* @__PURE__ */ new Set();
 	for (const [importerPath, importer] of Object.entries(raw.importers)) {
 		if (importerPath === "." || importerPath === "") continue;
@@ -16184,7 +16231,7 @@ const toFields$1 = (raw) => effect.Effect.gen(function* () {
 			instanceId: importerPath,
 			isWorkspace: true,
 			relativePath: importerPath,
-			...resolveImporterEdges(importer, importerPath, instanceIds, importerPaths)
+			...resolveImporterEdges(importer, importerPath, instanceIds, importerPaths, publishDirTargets)
 		}));
 	}
 	const emit = (instanceId, meta, edges) => effect.Effect.gen(function* () {
@@ -16202,7 +16249,7 @@ const toFields$1 = (raw) => effect.Effect.gen(function* () {
 			...integrity !== void 0 ? { integrity } : {},
 			isWorkspace: false,
 			...peerDeclarations(meta?.peerDependencies, meta?.peerDependenciesMeta),
-			...resolveEdges(edges, instanceIds)
+			...resolveEdges(edges, instanceIds, publishDirTargets)
 		}));
 	});
 	if (snapshots) for (const [key, snapshot] of Object.entries(snapshots)) {
@@ -16229,7 +16276,7 @@ const toFields$1 = (raw) => effect.Effect.gen(function* () {
 	};
 });
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/internal/yarn.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/internal/yarn.js
 const YarnLockfileRaw = effect.Schema.Record(effect.Schema.String, effect.Schema.Unknown);
 const DepRecord = effect.Schema.optionalKey(effect.Schema.Record(effect.Schema.String, effect.Schema.String));
 const YarnEntry = effect.Schema.Struct({
@@ -16405,7 +16452,7 @@ const cleanYarnDeps = (deps) => {
 	return Object.fromEntries(Object.entries(deps).map(([name, value]) => [name, value.startsWith("npm:") ? value.slice(4) : value]));
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/Lockfile.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/Lockfile.js
 const EMPTY_IMPORTERS = [];
 /**
 * Failure of `Lockfile.parse`: the given content is not a valid lockfile of
@@ -16654,7 +16701,7 @@ var Lockfile = class Lockfile extends effect.Schema.Class("Lockfile")({
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/LockfileIntegrity.js
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/LockfileIntegrity.js
 /**
 * The minimal manifest shape {@link LockfileIntegrity.compare} checks a
 * lockfile against: a package name plus the four optional dependency maps.
@@ -19467,7 +19514,7 @@ var Package = class Package extends effect.Schema.Class("Package")({
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspacePackage.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspacePackage.js
 const EMPTY$1 = Object.freeze(Object.create(null));
 const EMPTY_MANIFEST = Object.freeze(Object.create(null));
 /**
@@ -20065,7 +20112,7 @@ var Walker$1 = class {
 	static findRoot = findRoot$1;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspaceRoot.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspaceRoot.js
 /**
 * The marker filenames {@link WorkspaceRoot} probes for, in priority order.
 *
@@ -20252,7 +20299,7 @@ var WorkspaceRoot = class WorkspaceRoot extends effect.Context.Service()("@effec
 	static layerTest = (root) => effect.Layer.effect(WorkspaceRoot, WorkspaceRoot.makeTest(root)).pipe(effect.Layer.provide(effect.Path.layer));
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/limits.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/limits.js
 /**
 * Hard ceiling on directories the enumerator will visit for one pattern set.
 * Guards the pathological case a depth cap alone does not: a wide, shallow
@@ -20270,7 +20317,7 @@ const MAX_ENUMERATION_ENTRIES = 1e5;
 */
 const PRUNED_DIRECTORIES = /* @__PURE__ */ new Set([".git", "node_modules"]);
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/traverse.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/traverse.js
 /** Directory names never descended into. */
 const isPruned = (entry) => PRUNED_DIRECTORIES.has(entry);
 /** Join root-relative POSIX segments; `""` is the root itself. */
@@ -20360,7 +20407,7 @@ var Traversal = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/enumerate.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/enumerate.js
 /** Strip a trailing slash from `GlobPattern.enumerationPrefix` to get a relative directory. */
 const baseOf = (pattern) => pattern.enumerationPrefix.replace(/\/$/, "");
 /**
@@ -20430,7 +20477,7 @@ const enumerate = (root, globs, options) => effect.Effect.gen(function* () {
 	return results;
 });
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/patterns.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/patterns.js
 const stringsOf = (value) => Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : void 0;
 /** The `packages:` list of a `pnpm-workspace.yaml` document. Total on a parsed document. */
 const pnpmPatternsOf = (document) => {
@@ -20487,7 +20534,7 @@ const readPatterns = (root) => effect.Effect.gen(function* () {
 	return manifestPatternsOf(manifest);
 });
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspaceDiscovery.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspaceDiscovery.js
 /**
 * Raised when a workspace member's `package.json` cannot be read, parsed, or
 * used — it is missing, malformed, or lacks a `name` or `version`.
@@ -20943,7 +20990,7 @@ var WorkspaceDiscovery = class WorkspaceDiscovery extends effect.Context.Service
 };
 const isStringRecord$2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value) && Object.values(value).every((entry) => typeof entry === "string");
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/DependencyGraph.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/DependencyGraph.js
 /**
 * Raised when the workspace dependency graph cannot be topologically ordered
 * because it contains a cycle.
@@ -24639,7 +24686,7 @@ var Git = class Git extends effect.Context.Service()("@effected/git/Git") {
 	static layerTest = (overrides = {}) => effect.Layer.succeed(Git, Git.makeTest(overrides));
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/ChangeDetector.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/ChangeDetector.js
 /**
 * Which git refs to compare, and whether to fold in the working tree.
 *
@@ -24895,7 +24942,7 @@ function resolveFromCatalog(catalogs, wantedDependency) {
 	};
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/catalogs.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/catalogs.js
 /** Project a pnpm-workspace manifest's `catalog` / `catalogs` fields into a `Catalogs` map. */
 const inlineCatalogs = (manifest) => {
 	if (manifest.catalog === void 0 && manifest.catalogs === void 0) return {};
@@ -25424,7 +25471,7 @@ var ConfigDependencyHooks = class ConfigDependencyHooks extends effect.Context.S
 	}));
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/PackageManagerName.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/PackageManagerName.js
 /**
 * The four package managers this package understands.
 *
@@ -25799,7 +25846,7 @@ var PackageManagerDetector = class PackageManagerDetector extends effect.Context
 	static layerTest = (overrides = {}) => effect.Layer.succeed(PackageManagerDetector, PackageManagerDetector.makeTest(overrides));
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/LockfileReader.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/LockfileReader.js
 /**
 * Raised when the workspace's lockfile cannot be read off disk.
 *
@@ -25979,7 +26026,7 @@ var LockfileReader = class LockfileReader extends effect.Context.Service()("@eff
 	static layerTest = (overrides = {}) => effect.Layer.succeed(LockfileReader, LockfileReader.makeTest(overrides));
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/Publishability.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/Publishability.js
 /** The public npm registry, used when `publishConfig.registry` says nothing. */
 const DEFAULT_REGISTRY = "https://registry.npmjs.org/";
 /**
@@ -26138,7 +26185,7 @@ var PublishabilityDetector = class extends effect.Context.Service()("@effected/w
 	static layerNone = effect.Layer.succeed(this, this.none);
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/importerVersions.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/internal/importerVersions.js
 /**
 * Strip pnpm's peer-disambiguation suffix from a recorded importer version.
 *
@@ -26224,7 +26271,7 @@ const unanimousVersionOf = (index, dependency) => {
 	return agreed;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspaceCatalogs.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspaceCatalogs.js
 /**
 * An immutable, fully-normalized catalog collection — the one catalog
 * resolution semantic in the package.
@@ -26661,7 +26708,8 @@ var WorkspaceCatalogs = class WorkspaceCatalogs extends effect.Context.Service()
 			}),
 			importerVersions: effect.Effect.fn("WorkspaceCatalogs.importerVersions")(function* () {
 				return (yield* memo).importerVersions;
-			})
+			}),
+			refresh: () => invalidate
 		};
 	});
 	/**
@@ -26726,6 +26774,11 @@ var WorkspaceCatalogs = class WorkspaceCatalogs extends effect.Context.Service()
 	* the importer index from the lockfile's importer blocks — neither is in a
 	* `CatalogSet`) and always die unless stubbed.
 	*
+	* `refresh` defaults to `Effect.void` honestly: the double holds no memo,
+	* so "drop the memoized assembly" is genuinely a no-op — the stubs answer
+	* fresh on every call already. This mirrors `WorkspaceDiscovery.makeTest`'s
+	* `refresh`.
+	*
 	* @example
 	* ```ts
 	* import { CatalogSet, WorkspaceCatalogs } from "@effected/workspaces";
@@ -26745,6 +26798,7 @@ var WorkspaceCatalogs = class WorkspaceCatalogs extends effect.Context.Service()
 			peerDependencyRules: () => unstubbed$1("peerDependencyRules"),
 			releaseAgeGate: () => unstubbed$1("releaseAgeGate"),
 			importerVersions: () => unstubbed$1("importerVersions"),
+			refresh: () => effect.Effect.void,
 			...overrides
 		};
 	};
@@ -26794,7 +26848,7 @@ var WorkspaceCatalogs = class WorkspaceCatalogs extends effect.Context.Service()
 	}));
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspaceStateSnapshot.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspaceStateSnapshot.js
 const EMPTY = Object.freeze(Object.create(null));
 const DependencyMap = effect.Schema.Record(effect.Schema.String, effect.Schema.String).pipe(effect.Schema.withDecodingDefaultKey(effect.Effect.succeed(EMPTY)), effect.Schema.withConstructorDefault(effect.Effect.succeed(EMPTY)));
 /**
@@ -27017,7 +27071,7 @@ var WorkspaceStateSnapshot = class extends effect.Schema.Class("WorkspaceStateSn
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspaceSnapshots.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/WorkspaceSnapshots.js
 /** Whether `value` is a non-null, non-array object. */
 const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /** Whether every value in a record is a string — a usable dependency map. */
@@ -27294,7 +27348,7 @@ var WorkspaceSnapshots = class WorkspaceSnapshots extends effect.Context.Service
 	static layerTest = (overrides = {}) => effect.Layer.succeed(WorkspaceSnapshots, WorkspaceSnapshots.makeTest(overrides));
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/Workspaces.js
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/Workspaces.js
 const compose = (options, catalogsFactory) => {
 	const roots = WorkspaceRoot.layer;
 	const detector = PackageManagerDetector.layer;

package/changesets-changelog.d.cts

@@ -5236,7 +5236,7 @@ declare class UnsatisfiableConstraintError extends UnsatisfiableConstraintError_
   get message(): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+npm@0.11.0_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/index.d.ts
+//#region ../../node_modules/.pnpm/@effected+npm@0.11.1_@effected+semver@0.5.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/npm/index.d.ts
 //#region src/CatalogAssemblyError.d.ts
 declare const CatalogAssemblyError_base: Schema.Class<CatalogAssemblyError, Schema.TaggedStruct<"CatalogAssemblyError", {
   /**
@@ -5829,7 +5829,7 @@ declare class GlobPattern extends GlobPattern_base {
   static readonly FromString: Schema.Codec<GlobPattern, string>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_b5e24f85b508eca09bd100b8bd2084bb/node_modules/@effected/lockfiles/index.d.ts
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.6.2_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__@effected+npm@0.11_ef94318d813876db7fdc8ffae2f92869/node_modules/@effected/lockfiles/index.d.ts
 //#region src/BunExtension.d.ts
 declare const BunExtension_base: Schema.Class<BunExtension, Schema.Struct<{
   readonly _tag: Schema.tag<"bun">;
@@ -6903,7 +6903,7 @@ declare class Package extends Package_base {
   toJsonString(options?: PackageFormatOptions): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.15.1_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/index.d.ts
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.17.0_@effected+jsonc@0.7.0_effect@4.0.0-rc.109__effect@4.0.0-rc.109/node_modules/@effected/workspaces/index.d.ts
 //#region src/WorkspacePackage.d.ts
 declare const PublishConfig_base: Schema.Class<PublishConfig, Schema.Struct<{
   /** Scoped-package visibility. Its presence overrides `private`. */
@@ -8487,6 +8487,26 @@ interface WorkspaceCatalogsShape {
    * nothing rather than failing.
    */
   readonly importerVersions: () => Effect.Effect<ImporterVersions, CatalogAssemblyFailure>;
+  /**
+   * Discard the memoized assembly so the **next** read re-assembles — the same
+   * single read and hook replay as the first, over the workspace as it stands
+   * then.
+   *
+   * @remarks
+   * The explicit memoization boundary for a tool that **mutates the workspace
+   * mid-run** — installs, bumps a config dependency, regenerates the lockfile.
+   * Release-age gating wants the before-state, a post-install peer check the
+   * after-state, and one infinite memo cannot serve both without this call in
+   * between; without it, `peerDependencyRules` keeps answering from the
+   * pre-mutation hook replay and the checker reports findings the new rules
+   * suppress.
+   *
+   * Unconditional and infallible: the memo is already success-only (a failed
+   * or interrupted assembly retries by itself), so `refresh` exists solely to
+   * discard a *successful* assembly that mutation has made stale. Calling it
+   * before any read is harmless.
+   */
+  readonly refresh: () => Effect.Effect<void>;
 }
 /**
  * Options for the {@link WorkspaceCatalogs} layer.
@@ -8592,6 +8612,11 @@ declare class WorkspaceCatalogs extends WorkspaceCatalogs_base {
    * the importer index from the lockfile's importer blocks — neither is in a
    * `CatalogSet`) and always die unless stubbed.
    *
+   * `refresh` defaults to `Effect.void` honestly: the double holds no memo,
+   * so "drop the memoized assembly" is genuinely a no-op — the stubs answer
+   * fresh on every call already. This mirrors `WorkspaceDiscovery.makeTest`'s
+   * `refresh`.
+   *
    * @example
    * ```ts
    * import { CatalogSet, WorkspaceCatalogs } from "@effected/workspaces";