@savvy-web/silk-effects 7.1.4 → 7.3.0

package/README.md

@@ -181,6 +181,7 @@ The Silk husky hooks are data. `SavvySections` supplies the section identities a
 
 - `SavvyBaseSection` is the shared preamble's identity (key `SAVVY-BASE`); pair it with `savvyBasePreamble()`, which defines `ROOT`, the `in_ci` predicate, `PM` via package-manager detection and `pm_exec`.
 - `SavvyHooksSection` (key `SAVVY-HOOKS`) pairs with `savvyHooksHygiene()`, a self-guarded repo-hygiene block that runs outside CI.
+- `SavvyToolchainSection` (key `SAVVY-TOOLCHAIN`) pairs with `savvyToolchainCheck()`, a self-guarded block that warns when the running package manager has drifted off the repo's `devEngines.packageManager` pin. Warn only — it never blocks and never installs anything. It is self-contained (its hooks carry no `savvy-base` preamble), honours the manager named in the pin rather than assuming pnpm, strips the `+sha512…` integrity tail, skips inexact pins, and says nothing under CI.
 - `savvyToolSection(toolName, command)` builds a consumer's one-line tool section whose content is exactly `in_ci || pm_exec <command>` — the command is appended verbatim, so shell tokens like `$ROOT` and `$1` survive into the output. A `savvy-base` section must come first in the same hook file, so pass both to `syncAll` in that order.
 
 ```typescript

package/changesets/index.js

@@ -42,6 +42,7 @@ import { ReleasePlanner, makeReleasePlannerTest } from "./services/release-plann
 import { SectionCategorySchema } from "./categories/types.js";
 import { CommitHashSchema, VersionTypeSchema } from "./schemas/git.js";
 import { ChangesetSchema, ChangesetSummarySchema, DependencyTypeSchema, DependencyUpdateSchema } from "./schemas/changeset.js";
+import { CoexistingChangesetSchema, RegenDiffRowSchema, RegenPlanSchema, RegenResultSchema } from "./schemas/deps-regen.js";
 import { AppliedReleaseEntrySchema, AppliedReleaseSchema, BumpTypeSchema, ChangesetPreviewSchema, PendingChangesetSchema, PreviewReleaseSchema, VersionFileUpdateRecordSchema } from "./schemas/release-plan.js";
 import { ContentStructureRule as ContentStructureRule$1 } from "./markdownlint/rules/content-structure.js";
 import { DependencyTableFormatRule as DependencyTableFormatRule$1 } from "./markdownlint/rules/dependency-table-format.js";
@@ -72,6 +73,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	ChangesetValidationError: () => ChangesetValidationError,
 	ClassificationReasonSchema: () => ClassificationReasonSchema,
 	ClassificationSchema: () => ClassificationSchema,
+	CoexistingChangesetSchema: () => CoexistingChangesetSchema,
 	CommitHashSchema: () => CommitHashSchema,
 	ConfigInspector: () => ConfigInspector,
 	ConfigurationError: () => ConfigurationError,
@@ -118,6 +120,9 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	PendingChangesetSchema: () => PendingChangesetSchema,
 	PositiveInteger: () => PositiveInteger,
 	PreviewReleaseSchema: () => PreviewReleaseSchema,
+	RegenDiffRowSchema: () => RegenDiffRowSchema,
+	RegenPlanSchema: () => RegenPlanSchema,
+	RegenResultSchema: () => RegenResultSchema,
 	ReleasePlanError: () => ReleasePlanError,
 	ReleasePlanner: () => ReleasePlanner,
 	ReorderSectionsPlugin: () => ReorderSectionsPlugin,
@@ -157,4 +162,4 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 });
 
 //#endregion
-export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogTransformer, ChangesetIOError, ChangesetLinter, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ClassificationReasonSchema, ClassificationSchema, 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, 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, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };
+export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogTransformer, ChangesetIOError, ChangesetLinter, 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, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };

package/changesets/schemas/deps-regen.js

@@ -0,0 +1,78 @@
+import { NonEmptyString } from "./primitives.js";
+import { DependencyActionSchema, DependencyTableTypeSchema } from "./dependency-table.js";
+import { Schema } from "effect";
+
+//#region src/changesets/schemas/deps-regen.ts
+/**
+* Result schemas for DepsRegen: the side-effect-free regen plan and the result
+* of applying it.
+*
+*/
+const RegenDeleteEntrySchema = Schema.Struct({
+	file: Schema.String,
+	package: Schema.String
+}).annotate({ identifier: "RegenDeleteEntry" });
+/**
+* One dependency-diff row emitted by the deps-regen planner.
+*
+* @remarks
+* `computeWorkspaceDependencyDiffs` intentionally falls back to raw unresolved
+* specifier strings (`*`, `>=5.7.0`, `^1.2`, `latest`, etc.). This in-memory
+* plan schema therefore accepts any non-empty `from`/`to` cell instead of the
+* stricter changelog-table version pattern.
+*
+* @public
+*/
+const RegenDiffRowSchema = Schema.Struct({
+	dependency: NonEmptyString,
+	type: DependencyTableTypeSchema,
+	action: DependencyActionSchema,
+	from: NonEmptyString,
+	to: NonEmptyString
+}).annotate({ identifier: "RegenDiffRow" });
+const WorkspaceDependencyDiffPayloadSchema = Schema.Struct({
+	package: Schema.String,
+	relativePath: Schema.String,
+	rows: Schema.Array(RegenDiffRowSchema).check(Schema.isMinLength(1))
+}).annotate({ identifier: "WorkspaceDependencyDiffPayload" });
+const RegenWriteEntrySchema = Schema.Struct({
+	file: Schema.String,
+	package: Schema.String,
+	diff: WorkspaceDependencyDiffPayloadSchema
+}).annotate({ identifier: "RegenWriteEntry" });
+/**
+* A prose-only changeset that coexists with a deps-regen run (informational).
+*
+* @public
+*/
+const CoexistingChangesetSchema = Schema.Struct({
+	/** Absolute path of the untouched prose changeset. */
+	file: Schema.String,
+	/** In-scope packages released by this changeset's frontmatter. */
+	packages: Schema.Array(Schema.String)
+}).annotate({ identifier: "CoexistingChangeset" });
+/**
+* Complete side-effect-free deps-regen plan.
+*
+* @public
+*/
+const RegenPlanSchema = Schema.Struct({
+	toDelete: Schema.Array(RegenDeleteEntrySchema),
+	toWrite: Schema.Array(RegenWriteEntrySchema),
+	skippedMixed: Schema.Array(Schema.String),
+	coexisting: Schema.Array(CoexistingChangesetSchema)
+}).annotate({ identifier: "RegenPlan" });
+/**
+* Result of applying a {@link RegenPlan}.
+*
+* @public
+*/
+const RegenResultSchema = Schema.Struct({
+	deleted: Schema.Array(Schema.String),
+	written: Schema.Array(Schema.String),
+	skippedMixed: Schema.Array(Schema.String),
+	coexisting: Schema.Array(CoexistingChangesetSchema)
+}).annotate({ identifier: "RegenResult" });
+
+//#endregion
+export { CoexistingChangesetSchema, RegenDiffRowSchema, RegenPlanSchema, RegenResultSchema };

package/changesets/services/release-planner.js

@@ -97,6 +97,8 @@ function makeReleasePlannerTest(fixed) {
 * either shells out through `npx` (network) or to an ambient binary, so a
 * fixture that names one passes or fails on what the machine happens to have
 * installed rather than on this rewrite.
+*
+* @internal
 */
 function withChangelogModules(config, changelogModules, phase) {
 	const unformatted = {
@@ -117,7 +119,11 @@ function withChangelogModules(config, changelogModules, phase) {
 		changelog: [changelogModules[configuredId], config.changelog[1]]
 	});
 }
-/** Extract the `## <version>` block (down to the next H2 or EOF) from a changelog. */
+/**
+* Extract the `## <version>` block (down to the next H2 or EOF) from a changelog.
+*
+* @internal
+*/
 function extractVersionBlock(changelog, version) {
 	const lines = changelog.split("\n");
 	const start = lines.findIndex((l) => l.trim() === `## ${version}`);

package/index.d.ts

@@ -3691,34 +3691,109 @@ declare class ChangesetConfig extends ChangesetConfig_base {
   static readonly layer: Layer.Layer<ChangesetConfig, never, ChangesetConfigReader>;
 }
 //#endregion
-//#region src/changesets/utils/dep-diff.d.ts
+//#region src/changesets/schemas/deps-regen.d.ts
 /**
- * A workspace package's worth of dependency-table rows.
+ * One dependency-diff row emitted by the deps-regen planner.
+ *
+ * @remarks
+ * `computeWorkspaceDependencyDiffs` intentionally falls back to raw unresolved
+ * specifier strings (`*`, `>=5.7.0`, `^1.2`, `latest`, etc.). This in-memory
+ * plan schema therefore accepts any non-empty `from`/`to` cell instead of the
+ * stricter changelog-table version pattern.
  *
  * @public
  */
-interface WorkspaceDependencyDiff {
-  /** The workspace package whose `package.json` changed. */
-  readonly package: string;
-  /** Repo-relative path of the package directory (taken from the `after` snapshot). */
-  readonly relativePath: string;
-  /** One row per dependency change, sorted by the existing `sortDependencyRows` convention. */
-  readonly rows: ReadonlyArray<DependencyTableRow>;
-}
+declare const RegenDiffRowSchema: Schema.Struct<{
+  readonly dependency: Schema.String;
+  readonly type: Schema.Literals<readonly ["dependency", "devDependency", "peerDependency", "optionalDependency", "workspace", "config", "runtime", "packageManager"]>;
+  readonly action: Schema.Literals<readonly ["added", "updated", "removed"]>;
+  readonly from: Schema.String;
+  readonly to: Schema.String;
+}>;
 /**
- * Diff two workspace snapshots and return per-package dependency-table rows,
- * comparing already-resolved specifier values per side.
+ * One dependency-diff row emitted by the deps-regen planner.
  *
- * @param before - Snapshot at the older ref (typically the merge base). A
- *   workspace package absent here reports every declared dep as `"added"`.
- * @param after - Snapshot at the newer ref (typically the working tree).
- * @returns One {@link WorkspaceDependencyDiff} entry per workspace package
- *   that has at least one row. Packages with no resolved-value changes are
- *   omitted.
+ * @public
+ */
+type RegenDiffRow = Schema.Schema.Type<typeof RegenDiffRowSchema>;
+/**
+ * A prose-only changeset that coexists with a deps-regen run (informational).
  *
  * @public
  */
-declare function computeWorkspaceDependencyDiffs(before: WorkspaceStateSnapshot, after: WorkspaceStateSnapshot): ReadonlyArray<WorkspaceDependencyDiff>;
+declare const CoexistingChangesetSchema: Schema.Struct<{
+  /** Absolute path of the untouched prose changeset. */
+  readonly file: Schema.String;
+  /** In-scope packages released by this changeset's frontmatter. */
+  readonly packages: Schema.$Array<Schema.String>;
+}>;
+/**
+ * A prose-only changeset that coexists with a deps-regen run (informational).
+ *
+ * @public
+ */
+type CoexistingChangeset = Schema.Schema.Type<typeof CoexistingChangesetSchema>;
+/**
+ * Complete side-effect-free deps-regen plan.
+ *
+ * @public
+ */
+declare const RegenPlanSchema: Schema.Struct<{
+  readonly toDelete: Schema.$Array<Schema.Struct<{
+    readonly file: Schema.String;
+    readonly package: Schema.String;
+  }>>;
+  readonly toWrite: Schema.$Array<Schema.Struct<{
+    readonly file: Schema.String;
+    readonly package: Schema.String;
+    readonly diff: Schema.Struct<{
+      readonly package: Schema.String;
+      readonly relativePath: Schema.String;
+      readonly rows: Schema.$Array<Schema.Struct<{
+        readonly dependency: Schema.String;
+        readonly type: Schema.Literals<readonly ["dependency", "devDependency", "peerDependency", "optionalDependency", "workspace", "config", "runtime", "packageManager"]>;
+        readonly action: Schema.Literals<readonly ["added", "updated", "removed"]>;
+        readonly from: Schema.String;
+        readonly to: Schema.String;
+      }>>;
+    }>;
+  }>>;
+  readonly skippedMixed: Schema.$Array<Schema.String>;
+  readonly coexisting: Schema.$Array<Schema.Struct<{
+    /** Absolute path of the untouched prose changeset. */
+    readonly file: Schema.String;
+    /** In-scope packages released by this changeset's frontmatter. */
+    readonly packages: Schema.$Array<Schema.String>;
+  }>>;
+}>;
+/**
+ * Complete side-effect-free deps-regen plan.
+ *
+ * @public
+ */
+type RegenPlan = Schema.Schema.Type<typeof RegenPlanSchema>;
+/**
+ * Result of applying a {@link RegenPlan}.
+ *
+ * @public
+ */
+declare const RegenResultSchema: Schema.Struct<{
+  readonly deleted: Schema.$Array<Schema.String>;
+  readonly written: Schema.$Array<Schema.String>;
+  readonly skippedMixed: Schema.$Array<Schema.String>;
+  readonly coexisting: Schema.$Array<Schema.Struct<{
+    /** Absolute path of the untouched prose changeset. */
+    readonly file: Schema.String;
+    /** In-scope packages released by this changeset's frontmatter. */
+    readonly packages: Schema.$Array<Schema.String>;
+  }>>;
+}>;
+/**
+ * Result of applying a {@link RegenPlan}.
+ *
+ * @public
+ */
+type RegenResult = Schema.Schema.Type<typeof RegenResultSchema>;
 //#endregion
 //#region src/changesets/services/deps-regen.d.ts
 /**
@@ -3749,58 +3824,6 @@ declare function isPureDependencyChangeset(content: string): {
  * @public
  */
 declare function parseChangesetPackages(content: string): ReadonlyArray<string>;
-/**
- * A prose-only changeset that coexists with the run: it releases at least one
- * package in scope for this run but was left untouched because it carries no
- * `## Dependencies` section. Purely informational (#279) — surfaced so the
- * regen/detect result accounts for every changeset touching an in-scope
- * package, instead of leaving prose entries invisible and forcing a manual
- * `.changeset/` cross-check.
- *
- * @public
- */
-interface CoexistingChangeset {
-  /** Absolute path of the untouched prose changeset. */
-  readonly file: string;
-  /** The in-scope packages its frontmatter releases (out-of-scope names are dropped). */
-  readonly packages: ReadonlyArray<string>;
-}
-/**
- * A complete, side-effect-free regen plan: which stale pure-dependency
- * changesets to delete, which fresh changesets to write (carrying the
- * already-resolved diff), which mixed changesets were left untouched, and
- * which coexisting prose changesets reference in-scope packages.
- *
- * @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>;
-  /** Informational: untouched prose changesets releasing in-scope packages (#279). */
-  readonly coexisting: ReadonlyArray<CoexistingChangeset>;
-}
-/**
- * The result of applying a {@link RegenPlan}: the files actually deleted
- * and written, plus the mixed changesets that were skipped and the
- * coexisting prose changesets carried through from the plan.
- *
- * @public
- */
-interface RegenResult {
-  readonly deleted: ReadonlyArray<string>;
-  readonly written: ReadonlyArray<string>;
-  readonly skippedMixed: ReadonlyArray<string>;
-  /** Informational: untouched prose changesets releasing in-scope packages (#279). */
-  readonly coexisting: ReadonlyArray<CoexistingChangeset>;
-}
 /**
  * Options for {@link DepsRegenShape.plan}.
  *
@@ -4764,6 +4787,35 @@ declare const LegacyVersionFilesSchema: Schema.$Array<Schema.Struct<{
   readonly package: Schema.optional<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). */
+  readonly relativePath: string;
+  /** One row per dependency change, sorted by the existing `sortDependencyRows` convention. */
+  readonly rows: ReadonlyArray<DependencyTableRow>;
+}
+/**
+ * Diff two workspace snapshots and return per-package dependency-table rows,
+ * comparing already-resolved specifier values per side.
+ *
+ * @param before - Snapshot at the older ref (typically the merge base). A
+ *   workspace package absent here reports every declared dep as `"added"`.
+ * @param after - Snapshot at the newer ref (typically the working tree).
+ * @returns One {@link WorkspaceDependencyDiff} entry per workspace package
+ *   that has at least one row. Packages with no resolved-value changes are
+ *   omitted.
+ *
+ * @public
+ */
+declare function computeWorkspaceDependencyDiffs(before: WorkspaceStateSnapshot, after: WorkspaceStateSnapshot): ReadonlyArray<WorkspaceDependencyDiff>;
+//#endregion
 //#region src/changesets/utils/dependency-table.d.ts
 /**
  * Serialize dependency table rows to a markdown table string.
@@ -5794,7 +5846,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, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CoexistingChangeset, 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, 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, RegenPlan, RegenResult, 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, 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, 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, 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, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };
 }
 //#endregion
 //#region src/commitlint/config/schema.d.ts
@@ -9861,6 +9913,43 @@ declare function savvyHooksHygiene(): string;
  * @public
  */
 declare function savvyToolSection(toolName: string, command: string): Section;
+/**
+ * Section identity for the package-manager toolchain drift check.
+ *
+ * `toolName` is `"savvy-toolchain"`; pair with {@link savvyToolchainCheck}.
+ *
+ * @since 7.3.0
+ * @public
+ */
+declare const SavvyToolchainSection: SectionId;
+/**
+ * Package-manager drift check shared across Silk Suite hook files.
+ *
+ * @remarks
+ * Compares the running package manager's version against the repo's
+ * `devEngines.packageManager` pin and prints a warning on mismatch. **Warn only** —
+ * it never blocks the hook and never installs anything, so nobody mid-bisect or
+ * mid-rebase on an older pin is stranded.
+ *
+ * Deliberately self-contained: its homes are `.husky/post-checkout` and
+ * `.husky/post-merge`, which carry {@link SavvyHooksSection} but no
+ * {@link SavvyBaseSection}, so it defines its own root/CI/pin lookups rather than
+ * depending on `ROOT`, `in_ci` or `PM`. It honours the `name` recorded in the pin
+ * rather than assuming pnpm.
+ *
+ * Every input is treated as optional: no `git` root, no `jq`, no `devEngines` block,
+ * or a package manager that is not on `PATH` all mean "say nothing". Only an exact
+ * pin is comparable, so ranges (`^1.2.3`, `>=1 || <2`) and wildcards (`1.x`) are
+ * skipped, and the `+sha512…` integrity tail `devEngines` versions routinely carry is
+ * stripped before comparison. Skipped under CI, where the runtime action installs the
+ * pin by construction.
+ *
+ * @returns The drift-check shell, with no surrounding markers or trailing newline.
+ *
+ * @since 7.3.0
+ * @public
+ */
+declare function savvyToolchainCheck(): string;
 //#endregion
 //#region src/schemas/WorkspaceAnalysisSchemas.d.ts
 declare const SilkPublishConfig_base: Schema.Class<SilkPublishConfig, Schema.Struct<{
@@ -10796,5 +10885,5 @@ declare namespace index_d_exports$5 {
   export { AffectedResult, AffectedResultType, CacheDiagnosis, CacheDiagnosisType, DryRunParseError, GlobalHashSummary, GraphNode, MissExplanation, NotATurboRepoError, PackageCacheStatus, TaskGraphResult, TaskGraphResultType, TurboCache, TurboDigest, TurboDryRun, TurboDryRunType, TurboDryTask, TurboDryTaskType, TurboEnvVars, TurboError, TurboExecError, TurboGlobalCacheInputs, TurboInspector, TurboInspectorShape, TurboNotInstalledError };
 }
 //#endregion
-export { AnalyzedWorkspace, BiomeSchemaSync, type BiomeSchemaSyncShape, BiomeSyncError, type BiomeSyncOptions, type BiomeSyncResult, ChangesetConfig, ChangesetConfigError, type ChangesetConfigFile, ChangesetConfigReader, type ChangesetConfigReaderShape, type ChangesetConfigShape, type ChangesetMode, index_d_exports as Changesets, index_d_exports$1 as Commitlint, type CommitlintPlugin, type CommitlintUserConfig, ConfigDiscovery, type ConfigDiscoveryOptions, type ConfigDiscoveryShape, type ConfigLocation, ConfigNotFoundError, type ConfigSource, index_d_exports$2 as Lint, index_d_exports$3 as PrBody, type PromptConfig, type PromptSettings, PublishTargetBindingError, type PublishablePackage, type RawPackageJson, type RawPublishConfig, type RawPublishTargets, type RawTargetObject, type RawTargetValue, index_d_exports$4 as Repos, type RuleApplicability, type RuleConfigTuple, type RuleSeverity, type RulesConfig, SavvyBaseSection, SavvyHooksSection, type SilkChangesetConfigFile, SilkPublishConfig, SilkPublishability, SilkWorkspaceAnalyzer, type SilkWorkspaceAnalyzerShape, type TargetBinding, type TargetGroupBinding, type TargetsBinding, index_d_exports$5 as Turbo, WorkspaceAnalysis, WorkspaceAnalysisError, buildSchemaUrl, extractSemver, readTargetsBinding, savvyBasePreamble, savvyHooksHygiene, savvyToolSection };
+export { AnalyzedWorkspace, BiomeSchemaSync, type BiomeSchemaSyncShape, BiomeSyncError, type BiomeSyncOptions, type BiomeSyncResult, ChangesetConfig, ChangesetConfigError, type ChangesetConfigFile, ChangesetConfigReader, type ChangesetConfigReaderShape, type ChangesetConfigShape, type ChangesetMode, index_d_exports as Changesets, index_d_exports$1 as Commitlint, type CommitlintPlugin, type CommitlintUserConfig, ConfigDiscovery, type ConfigDiscoveryOptions, type ConfigDiscoveryShape, type ConfigLocation, ConfigNotFoundError, type ConfigSource, index_d_exports$2 as Lint, index_d_exports$3 as PrBody, type PromptConfig, type PromptSettings, PublishTargetBindingError, type PublishablePackage, type RawPackageJson, type RawPublishConfig, type RawPublishTargets, type RawTargetObject, type RawTargetValue, index_d_exports$4 as Repos, type RuleApplicability, type RuleConfigTuple, type RuleSeverity, type RulesConfig, SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, type SilkChangesetConfigFile, SilkPublishConfig, SilkPublishability, SilkWorkspaceAnalyzer, type SilkWorkspaceAnalyzerShape, type TargetBinding, type TargetGroupBinding, type TargetsBinding, index_d_exports$5 as Turbo, WorkspaceAnalysis, WorkspaceAnalysisError, buildSchemaUrl, extractSemver, readTargetsBinding, savvyBasePreamble, savvyHooksHygiene, savvyToolSection, savvyToolchainCheck };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,4 +1,4 @@
-import { SavvyBaseSection, SavvyHooksSection, savvyBasePreamble, savvyHooksHygiene, savvyToolSection } from "./schemas/SavvySections.js";
+import { SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, savvyBasePreamble, savvyHooksHygiene, savvyToolSection, savvyToolchainCheck } from "./schemas/SavvySections.js";
 import { ChangesetConfigError } from "./errors/ChangesetConfigError.js";
 import { ChangesetConfigReader } from "./services/ChangesetConfigReader.js";
 import { PublishTargetBindingError } from "./errors/PublishTargetBindingError.js";
@@ -18,4 +18,4 @@ import { ConfigDiscovery } from "./services/ConfigDiscovery.js";
 import { SilkWorkspaceAnalyzer } from "./services/SilkWorkspaceAnalyzer.js";
 import { turbo_exports } from "./turbo/index.js";
 
-export { AnalyzedWorkspace, BiomeSchemaSync, BiomeSyncError, ChangesetConfig, ChangesetConfigError, ChangesetConfigReader, changesets_exports as Changesets, commitlint_exports as Commitlint, ConfigDiscovery, ConfigNotFoundError, lint_exports as Lint, pr_body_exports as PrBody, PublishTargetBindingError, repos_exports as Repos, SavvyBaseSection, SavvyHooksSection, SilkPublishConfig, SilkPublishability, SilkWorkspaceAnalyzer, turbo_exports as Turbo, WorkspaceAnalysis, WorkspaceAnalysisError, buildSchemaUrl, extractSemver, readTargetsBinding, savvyBasePreamble, savvyHooksHygiene, savvyToolSection };
+export { AnalyzedWorkspace, BiomeSchemaSync, BiomeSyncError, ChangesetConfig, ChangesetConfigError, ChangesetConfigReader, changesets_exports as Changesets, commitlint_exports as Commitlint, ConfigDiscovery, ConfigNotFoundError, lint_exports as Lint, pr_body_exports as PrBody, PublishTargetBindingError, repos_exports as Repos, SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, SilkPublishConfig, SilkPublishability, SilkWorkspaceAnalyzer, turbo_exports as Turbo, WorkspaceAnalysis, WorkspaceAnalysisError, buildSchemaUrl, extractSemver, readTargetsBinding, savvyBasePreamble, savvyHooksHygiene, savvyToolSection, savvyToolchainCheck };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/silk-effects",
-	"version": "7.1.4",
+	"version": "7.3.0",
 	"private": false,
 	"description": "Shared Effect library for Silk Suite conventions",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/silk-effects",

package/schemas/SavvySections.js

@@ -130,6 +130,65 @@ fi`;
 function savvyToolSection(toolName, command) {
 	return shellSection(toolName).section(`in_ci || pm_exec ${command}`);
 }
+/**
+* Section identity for the package-manager toolchain drift check.
+*
+* `toolName` is `"savvy-toolchain"`; pair with {@link savvyToolchainCheck}.
+*
+* @since 7.3.0
+* @public
+*/
+const SavvyToolchainSection = shellSection("savvy-toolchain");
+/**
+* Package-manager drift check shared across Silk Suite hook files.
+*
+* @remarks
+* Compares the running package manager's version against the repo's
+* `devEngines.packageManager` pin and prints a warning on mismatch. **Warn only** —
+* it never blocks the hook and never installs anything, so nobody mid-bisect or
+* mid-rebase on an older pin is stranded.
+*
+* Deliberately self-contained: its homes are `.husky/post-checkout` and
+* `.husky/post-merge`, which carry {@link SavvyHooksSection} but no
+* {@link SavvyBaseSection}, so it defines its own root/CI/pin lookups rather than
+* depending on `ROOT`, `in_ci` or `PM`. It honours the `name` recorded in the pin
+* rather than assuming pnpm.
+*
+* Every input is treated as optional: no `git` root, no `jq`, no `devEngines` block,
+* or a package manager that is not on `PATH` all mean "say nothing". Only an exact
+* pin is comparable, so ranges (`^1.2.3`, `>=1 || <2`) and wildcards (`1.x`) are
+* skipped, and the `+sha512…` integrity tail `devEngines` versions routinely carry is
+* stripped before comparison. Skipped under CI, where the runtime action installs the
+* pin by construction.
+*
+* @returns The drift-check shell, with no surrounding markers or trailing newline.
+*
+* @since 7.3.0
+* @public
+*/
+function savvyToolchainCheck() {
+	return `if ! { [ -n "$CI" ] || [ -n "$GITHUB_ACTIONS" ]; }; then
+  toolchain_root=$(git rev-parse --show-toplevel 2>/dev/null)
+  toolchain_pm=""
+  toolchain_pin=""
+  if [ -n "$toolchain_root" ] && [ -f "$toolchain_root/package.json" ] && command -v jq >/dev/null 2>&1; then
+    toolchain_pm=$(jq -r '.devEngines.packageManager.name // empty' "$toolchain_root/package.json" 2>/dev/null)
+    toolchain_pin=$(jq -r '.devEngines.packageManager.version // empty' "$toolchain_root/package.json" 2>/dev/null | cut -d'+' -f1)
+  fi
+  # Only an exact pin is comparable: drop ranges (^ ~ >= ||) and wildcards (x, *).
+  case "$toolchain_pin" in ""|[!0-9]*|*[!0-9A-Za-z.-]*|*x*|*X*) toolchain_pin="" ;; esac
+  if [ -n "$toolchain_pm" ] && [ -n "$toolchain_pin" ] && command -v "$toolchain_pm" >/dev/null 2>&1; then
+    toolchain_have=$("$toolchain_pm" --version 2>/dev/null | head -n 1 | tr -d '[:space:]')
+    # A manager that failed or answered with prose says nothing about drift.
+    case "$toolchain_have" in [!0-9]*|*[!0-9A-Za-z.-]*) toolchain_have="" ;; esac
+    if [ -n "$toolchain_have" ] && [ "$toolchain_have" != "$toolchain_pin" ]; then
+      printf '⚠ %s %s does not match %s, the version pinned in devEngines.packageManager.\\n' "$toolchain_pm" "$toolchain_have" "$toolchain_pin" >&2
+      printf '  Lockfiles written by this version may differ from CI. Fix: corepack use %s@%s\\n' "$toolchain_pm" "$toolchain_pin" >&2
+    fi
+  fi
+  unset toolchain_root toolchain_pm toolchain_pin toolchain_have
+fi`;
+}
 
 //#endregion
-export { SavvyBaseSection, SavvyHooksSection, savvyBasePreamble, savvyHooksHygiene, savvyToolSection };
+export { SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, savvyBasePreamble, savvyHooksHygiene, savvyToolSection, savvyToolchainCheck };

package/services/BiomeSchemaSync.js

@@ -1,6 +1,6 @@
 import { BiomeSyncError } from "../errors/BiomeSyncError.js";
 import { Context, Effect, FileSystem, Layer } from "effect";
-import { Jsonc } from "@effected/jsonc";
+import { Jsonc, JsoncEdit, JsoncModifier } from "@effected/jsonc";
 
 //#region src/services/BiomeSchemaSync.ts
 /**
@@ -28,6 +28,16 @@ function buildSchemaUrl(version) {
 	return `https://biomejs.dev/schemas/${version}/schema.json`;
 }
 const BIOME_SCHEMA_HOSTNAME = "biomejs.dev";
+function normalizeHostname(hostname) {
+	return hostname.toLowerCase().replace(/\.+$/, "");
+}
+function isBiomeSchemaUrl(schema) {
+	try {
+		return normalizeHostname(new URL(schema).hostname) === BIOME_SCHEMA_HOSTNAME;
+	} catch {
+		return false;
+	}
+}
 /** Check which biome config files exist in cwd. */
 function findBiomeConfigs(cwd, fs) {
 	const candidates = [`${cwd}/biome.json`, `${cwd}/biome.jsonc`];
@@ -100,7 +110,7 @@ var BiomeSchemaSync = class extends Context.Service()("@savvy-web/silk-effects/B
 					skipped.push(configPath);
 					continue;
 				}
-				if (!schema.includes(BIOME_SCHEMA_HOSTNAME)) {
+				if (!isBiomeSchemaUrl(schema)) {
 					skipped.push(configPath);
 					continue;
 				}
@@ -109,8 +119,14 @@ var BiomeSchemaSync = class extends Context.Service()("@savvy-web/silk-effects/B
 					continue;
 				}
 				if (write) {
-					const updated_content = raw.replaceAll(schema, expectedUrl);
-					yield* fs.writeFileString(configPath, updated_content).pipe(Effect.mapError(
+					const updatedContent = yield* JsoncModifier.modify(raw, ["$schema"], expectedUrl).pipe(Effect.map((edits) => JsoncEdit.applyAll(raw, edits)), Effect.mapError(
+						/* v8 ignore next 4 -- error path requires a JSONC edit failure */
+						(error) => new BiomeSyncError({
+							path: configPath,
+							reason: `Failed to update JSONC: ${String(error)}`
+						})
+					));
+					yield* fs.writeFileString(configPath, updatedContent).pipe(Effect.mapError(
 						/* v8 ignore next 4 -- error path requires a filesystem write failure */
 						(cause) => new BiomeSyncError({
 							path: configPath,