@savvy-web/silk-effects 7.2.0 → 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/index.d.ts

@@ -9913,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<{
@@ -10848,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.2.0",
+	"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 };