sku 16.2.0 → 16.3.0-replace-pnpm-plugin-20260907064258

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # sku
 
+## 16.3.0-replace-pnpm-plugin-20260907064258
+
+### Minor Changes
+
+- Migrate from `pnpm-plugin-sku` to static `pnpm-workspace.yaml` configuration. ([#1718](https://github.com/seek-oss/sku/pull/1718))
+
+  ### Summary of Changes
+  - **Static Workspace Configuration**: Sku's recommended pnpm settings are now written directly into `pnpm-workspace.yaml` with `# sku_managed` markers instead of being injected at runtime via `pnpm-plugin-sku`.
+  - **Automatic Migration**: On the first run of a configuration-enabled sku command or postinstall, `pnpm-plugin-sku` is removed from `configDependencies` in `pnpm-workspace.yaml` (and the `configDependencies` field is deleted if empty).
+  - **Two Sync Modes**:
+    - **Additive Sync (configuration-enabled sku commands & postinstall)**: Adds missing managed single-value settings and `allowBuilds` keys, unions and deduplicates array settings (`publicHoistPattern`, `minimumReleaseAgeExclude`, `trustPolicyExclude`), and never overwrites existing config values or removes user-owned entries.
+    - **Enforce Mode (`sku configure`)**: Overwrites managed single-value settings and marked `allowBuilds` keys to match sku defaults in both directions. Unmarked `allowBuilds` overrides are preserved. Removes retired sku defaults that still carry a `# sku_managed` marker.
+    - **Managed Comments**: Comments on entries adopted or overwritten by sku are replaced with the `# sku_managed` marker.
+  - **Mutation Logging**: File creation, additions, adoptions, duplicate removal, migrations, updates, and retirements are logged; aligned files remain silent.
+  - **Drift Warnings**: Regular sku commands warn when managed values differ from sku defaults or when retired entries still have a `# sku_managed` marker, suggesting `sku configure` to align.
+  - **Opt-outs and Escape Hatches**:
+    - `skuSkipConfigure: true` in `package.json` disables the sync on regular sku commands (`skuSkipPostInstall: true` disables it on postinstall). Manual `sku configure` always syncs.
+    - To keep an entry that sku has retired, delete its `# sku_managed` marker comment (or re-add it without a marker) to designate it as user-managed.
+  - **New Project Scaffolding**: `@sku-lib/create` now uses the shared sync engine to emit `pnpm-workspace.yaml` on project creation, without installing `pnpm-plugin-sku` or gating on pnpm versions.
+
 ## 16.2.0
 
 ### Minor Changes

package/dist/packages/sku/package.mjs

@@ -158,7 +158,8 @@ var package_default = {
 		"webpack-bundle-analyzer": "^5.1.1",
 		"webpack-dev-server": "catalog:",
 		"webpack-merge": "^6.0.1",
-		"webpack-node-externals": "^3.0.0"
+		"webpack-node-externals": "^3.0.0",
+		"yaml": "^2.8.3"
 	},
 	devDependencies: {
 		"@sku-private/tsdown": "workspace:*",

package/dist/postinstall.mjs

@@ -4,7 +4,7 @@ import "./private/utils/src/index.mjs";
 import { banner } from "./private/utils/src/console/banner.mjs";
 import "./private/utils/src/console/index.mjs";
 import { createSkuContext } from "./context/createSkuContext.mjs";
-import configureApp_default from "./utils/configureApp.mjs";
+import { configureApp } from "./utils/configureApp.mjs";
 import { createDebug } from "obug";
 //#region src/postinstall.ts
 /**
@@ -17,7 +17,7 @@ const postinstall = async ({ localCwd, packageJson, hasSkuDep }) => {
 	try {
 		log("postinstall", "running configure");
 		const skuContext = await createSkuContext({});
-		configureApp_default(skuContext);
+		await configureApp(skuContext);
 	} catch (error) {
 		console.error("An error occurred running postinstall script. Please check that sku.config.js is correct and try again.");
 		console.error(error);

package/dist/private/utils/src/index.mjs

@@ -1,7 +1,9 @@
 import "./path/toPosixPath.mjs";
 import { cwd, getPathFromCwd, requireFromCwd, setCwd, writeFileToCWD } from "./filesystem/cwd.mjs";
 import "./filesystem/index.mjs";
-import { getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, isPnpm, packageManager, rootDir } from "./packageManager/packageManager.mjs";
+import { getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isPnpm, packageManager, rootDir } from "./packageManager/packageManager.mjs";
+import { MANAGED_BY_SKU_COMMENT, MANAGED_BY_SKU_MARKER, arraySettings, defaultPnpmWorkspaceConfig, objectSettings, pnpmWorkspaceSettings, singleValueSettings } from "./packageManager/pnpmWorkspaceDefaults.mjs";
+import { ensurePnpmWorkspaceConfig } from "./packageManager/ensurePnpmWorkspaceConfig.mjs";
 import "./packageManager/index.mjs";
 import { makeUrl, serverUrls } from "./serverUrls.mjs";
-export { cwd, getAddCommand, getExecuteCommand, getPathFromCwd, getRunCommand, getWhyCommand, isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, isPnpm, makeUrl, packageManager, requireFromCwd, rootDir, serverUrls, setCwd, writeFileToCWD };
+export { MANAGED_BY_SKU_COMMENT, MANAGED_BY_SKU_MARKER, arraySettings, cwd, defaultPnpmWorkspaceConfig, ensurePnpmWorkspaceConfig, getAddCommand, getExecuteCommand, getPathFromCwd, getRunCommand, getWhyCommand, isPnpm, makeUrl, objectSettings, packageManager, pnpmWorkspaceSettings, requireFromCwd, rootDir, serverUrls, setCwd, singleValueSettings, writeFileToCWD };

package/dist/private/utils/src/packageManager/ensurePnpmWorkspaceConfig.mjs

@@ -0,0 +1,50 @@
+import { caution } from "../console/styles.mjs";
+import { rootDir } from "./packageManager.mjs";
+import { defaultPnpmWorkspaceConfig } from "./pnpmWorkspaceDefaults.mjs";
+import { removePnpmPluginSku } from "./removePnpmPluginSku.mjs";
+import { syncArraySettings } from "./syncArraySettings.mjs";
+import { syncObjectSettings } from "./syncObjectSettings.mjs";
+import { syncSingleValueSettings } from "./syncSingleValueSettings.mjs";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { Document, isMap, parseDocument } from "yaml";
+//#region ../../private/utils/src/packageManager/ensurePnpmWorkspaceConfig.ts
+async function ensurePnpmWorkspaceConfig({ mode = "additive", create = false, targetDir = rootDir ?? process.cwd() } = {}) {
+	const filePath = join(targetDir, "pnpm-workspace.yaml");
+	const fileExisted = existsSync(filePath);
+	if (!fileExisted && !create) return;
+	let originalContent = "";
+	let doc;
+	if (fileExisted) {
+		originalContent = await readFile(filePath, "utf-8");
+		doc = parseDocument(originalContent);
+		if (!doc.contents) doc.contents = doc.createNode({});
+		else if (!isMap(doc.contents)) throw new Error(`Cannot sync ${filePath}: the document must contain a YAML mapping`);
+	} else doc = new Document(structuredClone(defaultPnpmWorkspaceConfig));
+	let modified = false;
+	const recordMutation = (message) => {
+		modified = true;
+		console.log(message);
+	};
+	if (!fileExisted) recordMutation("created pnpm-workspace.yaml");
+	const warn = (message) => {
+		console.warn(caution(message));
+	};
+	const context = {
+		doc,
+		mode,
+		recordMutation,
+		warn
+	};
+	removePnpmPluginSku(doc, recordMutation);
+	syncSingleValueSettings(context);
+	syncObjectSettings(context);
+	syncArraySettings(context);
+	if (modified) {
+		const newContent = doc.toString();
+		if (newContent !== originalContent) await writeFile(filePath, newContent, "utf-8");
+	}
+}
+//#endregion
+export { ensurePnpmWorkspaceConfig };

package/dist/private/utils/src/packageManager/index.mjs

@@ -1,2 +1,4 @@
-import { getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, isPnpm, packageManager, rootDir } from "./packageManager.mjs";
-export { getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, isPnpm, packageManager, rootDir };
+import { getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isPnpm, packageManager, rootDir } from "./packageManager.mjs";
+import { MANAGED_BY_SKU_COMMENT, MANAGED_BY_SKU_MARKER, arraySettings, defaultPnpmWorkspaceConfig, objectSettings, pnpmWorkspaceSettings, singleValueSettings } from "./pnpmWorkspaceDefaults.mjs";
+import { ensurePnpmWorkspaceConfig } from "./ensurePnpmWorkspaceConfig.mjs";
+export { MANAGED_BY_SKU_COMMENT, MANAGED_BY_SKU_MARKER, arraySettings, defaultPnpmWorkspaceConfig, ensurePnpmWorkspaceConfig, getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isPnpm, objectSettings, packageManager, pnpmWorkspaceSettings, rootDir, singleValueSettings };

package/dist/private/utils/src/packageManager/packageManager.mjs

@@ -4,7 +4,6 @@ import { detectSync } from "../../../../node_modules/.pnpm/package-manager-detec
 import { caution, strong } from "../console/styles.mjs";
 import { dirname } from "node:path";
 import * as find from "empathic/find";
-import semver from "semver";
 //#region ../../private/utils/src/packageManager/packageManager.ts
 const lockfileByPackageManager = {
 	pnpm: "pnpm-lock.yaml",
@@ -72,9 +71,6 @@ const resolvePackageManager = () => {
 	};
 };
 const { rootDir, packageManager, packageManagerVersion } = resolvePackageManager();
-const isAtLeastPnpmV10 = () => packageManager === "pnpm" && packageManagerVersion && semver.satisfies(packageManagerVersion, ">=10.0.0");
-const recommendedPnpmVersion = "10.13.0";
-const isAtLeastRecommendedPnpmVersion = () => Boolean(packageManager === "pnpm" && packageManagerVersion && semver.satisfies(packageManagerVersion, `>=${recommendedPnpmVersion}`));
 const getCommand = (agent, command, args) => {
 	const resolvedCommand = resolveCommand(agent, command, args);
 	if (!resolvedCommand) throw new Error(`Unable to resolve command: ${agent} ${command} ${args}`);
@@ -116,4 +112,4 @@ const getWhyCommand = () => {
 	return `${packageManager} ${isPnpm ? "why -r" : "why"}`;
 };
 //#endregion
-export { getAddCommand, getCommand, getExecuteCommand, getRunCommand, getWhyCommand, isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, isPnpm, isYarn, packageManager, packageManagerVersion, rootDir };
+export { getAddCommand, getCommand, getExecuteCommand, getRunCommand, getWhyCommand, isPnpm, isYarn, packageManager, rootDir };

package/dist/private/utils/src/packageManager/pnpmWorkspaceDefaults.mjs

@@ -0,0 +1,74 @@
+//#region ../../private/utils/src/packageManager/pnpmWorkspaceDefaults.ts
+const MANAGED_BY_SKU_MARKER = "sku_managed";
+const MANAGED_BY_SKU_COMMENT = `# ${MANAGED_BY_SKU_MARKER}`;
+/** Overwritten wholesale by `sku configure`: sku's value always wins. */
+const singleValueSetting = (value, comment) => ({
+	kind: "value",
+	value,
+	comment
+});
+/** A flat map merged per key. Marked keys are sku-owned, the rest are the user's. */
+const objectSetting = (entries) => ({
+	kind: "object",
+	entries
+});
+/** Unioned and deduped. Marked entries are sku-owned, the rest are the user's. */
+const arraySetting = (entries) => ({
+	kind: "array",
+	entries: entries.map((entry) => typeof entry === "string" ? { value: entry } : entry)
+});
+const minutesPerDay = 1440;
+const minimumReleaseAgeInDays = 3;
+/**
+* Sku's recommended pnpm settings. Each entry declares its own value, merge
+* policy and comments, and everything the sync needs is derived from here.
+*/
+const pnpmWorkspaceSettings = {
+	allowBuilds: objectSetting({
+		"@parcel/watcher": true,
+		"@swc/core": true,
+		"core-js-pure": false,
+		esbuild: true,
+		sku: true,
+		"unrs-resolver": true
+	}),
+	blockExoticSubdeps: singleValueSetting(true),
+	minimumReleaseAge: singleValueSetting(minimumReleaseAgeInDays * minutesPerDay, `${minimumReleaseAgeInDays} days`),
+	minimumReleaseAgeExclude: arraySetting([
+		"@braid-design-system/*",
+		"@capsizecss/*",
+		"@seek/*",
+		"@sku-lib/*",
+		"@vanilla-extract/*",
+		"@vocab/*",
+		"braid-design-system",
+		"browserslist-config-seek",
+		"eslint-config-seek",
+		"sku"
+	]),
+	publicHoistPattern: arraySetting(["eslint", "prettier"]),
+	strictDepBuilds: singleValueSetting(false),
+	trustPolicy: singleValueSetting("off"),
+	trustPolicyExclude: arraySetting([{
+		value: "semver@6.3.1",
+		comment: "dependency of eslint-plugin-react"
+	}])
+};
+const keyedSettings = Object.keys(pnpmWorkspaceSettings).map((key) => ({
+	key,
+	...pnpmWorkspaceSettings[key]
+}));
+const singleValueSettings = keyedSettings.filter((setting) => setting.kind === "value");
+const objectSettings = keyedSettings.filter((setting) => setting.kind === "object");
+const arraySettings = keyedSettings.filter((setting) => setting.kind === "array");
+const settingValue = (setting) => {
+	switch (setting.kind) {
+		case "value": return setting.value;
+		case "object": return { ...setting.entries };
+		case "array": return setting.entries.map(({ value }) => value);
+	}
+};
+/** The settings as plain values, for scaffolding a `pnpm-workspace.yaml` from scratch. */
+const defaultPnpmWorkspaceConfig = Object.fromEntries(keyedSettings.map((setting) => [setting.key, settingValue(setting)]));
+//#endregion
+export { MANAGED_BY_SKU_COMMENT, MANAGED_BY_SKU_MARKER, arraySettings, defaultPnpmWorkspaceConfig, objectSettings, pnpmWorkspaceSettings, singleValueSettings };

package/dist/private/utils/src/packageManager/removePnpmPluginSku.mjs

@@ -0,0 +1,19 @@
+import { getNodeKey } from "./syncShared.mjs";
+import { isMap, isPair, isSeq } from "yaml";
+//#region ../../private/utils/src/packageManager/removePnpmPluginSku.ts
+/**
+* Removes the pnpm-plugin-sku from the configDependencies in pnpm-workspace.yaml
+*/
+const removePnpmPluginSku = (doc, recordMutation) => {
+	if (!doc.has("configDependencies")) return;
+	const cd = doc.get("configDependencies", true);
+	if (!isMap(cd) && !isSeq(cd)) return;
+	const items = cd.items;
+	const remainingItems = items.filter((item) => getNodeKey(isPair(item) ? item.key : item) !== "pnpm-plugin-sku");
+	if (remainingItems.length === items.length) return;
+	cd.items = remainingItems;
+	recordMutation("removed pnpm-plugin-sku from configDependencies in pnpm-workspace.yaml");
+	if (remainingItems.length === 0) doc.delete("configDependencies");
+};
+//#endregion
+export { removePnpmPluginSku };

package/dist/private/utils/src/packageManager/syncArraySettings.mjs

@@ -0,0 +1,75 @@
+import { MANAGED_BY_SKU_COMMENT, arraySettings } from "./pnpmWorkspaceDefaults.mjs";
+import { hasManagedMarker, setManagedComment } from "./syncShared.mjs";
+import { isScalar, isSeq } from "yaml";
+//#region ../../private/utils/src/packageManager/syncArraySettings.ts
+const deduplicateArrayItems = (seqNode, key, context) => {
+	const seenValues = /* @__PURE__ */ new Map();
+	const deduplicatedItems = [];
+	for (const item of seqNode.items) if (isScalar(item) && typeof item.value === "string") {
+		const existingIndex = seenValues.get(item.value);
+		if (existingIndex !== void 0) {
+			const existingItem = deduplicatedItems[existingIndex];
+			if (isScalar(existingItem) && hasManagedMarker(existingItem.comment) && !hasManagedMarker(item.comment)) deduplicatedItems[existingIndex] = item;
+			context.recordMutation(`removed duplicate ${item.value} from ${key} in pnpm-workspace.yaml`);
+			continue;
+		}
+		seenValues.set(item.value, deduplicatedItems.length);
+		deduplicatedItems.push(item);
+	} else deduplicatedItems.push(item);
+	seqNode.items = deduplicatedItems;
+};
+/**
+* Adopts default entries and flags retired ones in an existing array.
+*
+* @returns Whether the item should be removed from the sequence.
+*/
+const processSingleArrayItem = (item, defaultComments, key, context) => {
+	if (!isScalar(item) || typeof item.value !== "string") return false;
+	const val = item.value;
+	if (defaultComments.has(val)) {
+		if (setManagedComment(item, defaultComments.get(val))) context.recordMutation(`adopted ${val} in ${key} in pnpm-workspace.yaml`);
+		return false;
+	}
+	if (hasManagedMarker(item.comment)) {
+		if (context.mode === "enforce") return true;
+		context.warn(`pnpm-workspace.yaml: "${val}" in ${key} is marked with "${MANAGED_BY_SKU_COMMENT}", but is no longer a sku default. Run "sku configure" to remove it, or delete its "${MANAGED_BY_SKU_COMMENT}" marker to keep it as a user-managed entry.`);
+	}
+	return false;
+};
+const processExistingArrayItems = (seqNode, defaultComments, key, context) => {
+	const indicesToRemove = [];
+	for (const [i, item] of seqNode.items.entries()) if (processSingleArrayItem(item, defaultComments, key, context)) indicesToRemove.push(i);
+	for (const idx of indicesToRemove.toReversed()) {
+		const item = seqNode.items[idx];
+		const val = isScalar(item) ? String(item.value) : "";
+		seqNode.items.splice(idx, 1);
+		context.recordMutation(`removed retired entry ${val} from ${key} in pnpm-workspace.yaml`);
+	}
+};
+const appendMissingArrayDefaults = (seqNode, entries, key, context) => {
+	const existingValues = /* @__PURE__ */ new Set();
+	for (const item of seqNode.items) if (isScalar(item) && typeof item.value === "string") existingValues.add(item.value);
+	for (const { value, comment } of entries) if (!existingValues.has(value)) {
+		const newItem = context.doc.createNode(value);
+		setManagedComment(newItem, comment);
+		seqNode.items.push(newItem);
+		existingValues.add(value);
+		context.recordMutation(`added ${value} to ${key} in pnpm-workspace.yaml`);
+	}
+};
+const syncArraySettings = (context) => {
+	for (const { key, entries } of arraySettings) {
+		const defaultComments = new Map(entries.map(({ value, comment }) => [value, comment]));
+		if (!context.doc.has(key)) {
+			context.doc.set(key, context.doc.createNode([]));
+			context.recordMutation(`added ${key} to pnpm-workspace.yaml`);
+		}
+		const seqNode = context.doc.get(key, true);
+		if (!isSeq(seqNode)) continue;
+		deduplicateArrayItems(seqNode, key, context);
+		processExistingArrayItems(seqNode, defaultComments, key, context);
+		appendMissingArrayDefaults(seqNode, entries, key, context);
+	}
+};
+//#endregion
+export { syncArraySettings };

package/dist/private/utils/src/packageManager/syncObjectSettings.mjs

@@ -0,0 +1,67 @@
+import { MANAGED_BY_SKU_COMMENT, objectSettings } from "./pnpmWorkspaceDefaults.mjs";
+import { clearCommentBefore, getNodeKey, hasManagedMarker, setManagedComment } from "./syncShared.mjs";
+import { isMap, isScalar } from "yaml";
+//#region ../../private/utils/src/packageManager/syncObjectSettings.ts
+const markPairAsManaged = (pair, explanatory) => {
+	const modified = setManagedComment(pair.value, explanatory);
+	return clearCommentBefore(pair.key) || modified;
+};
+const syncExistingObjectPair = (pair, key, subKey, defaultVal, context) => {
+	const { doc, mode, recordMutation, warn } = context;
+	if (!isScalar(pair.value)) return;
+	const currentVal = pair.value.value;
+	if (currentVal === defaultVal) {
+		if (markPairAsManaged(pair)) recordMutation(`adopted ${key}.${subKey}: ${String(currentVal)} in pnpm-workspace.yaml`);
+		return;
+	}
+	if (!hasManagedMarker(pair.value.comment)) return;
+	if (mode === "enforce") {
+		pair.value = doc.createNode(defaultVal);
+		setManagedComment(pair.value);
+		clearCommentBefore(pair.key);
+		recordMutation(`updated ${key}.${subKey}: ${String(currentVal)} → ${defaultVal} in pnpm-workspace.yaml`);
+		return;
+	}
+	warn(`pnpm-workspace.yaml: "${key}.${subKey}" has value ${String(currentVal)}, recommended is ${defaultVal}. Run "sku configure" to align.`);
+};
+const syncObjectPair = (mapNode, key, subKey, defaultVal, context) => {
+	const pair = mapNode.items.find((item) => getNodeKey(item.key) === subKey);
+	if (!pair) {
+		const valNode = context.doc.createNode(defaultVal);
+		setManagedComment(valNode);
+		mapNode.set(subKey, valNode);
+		context.recordMutation(`added ${key}.${subKey}: ${defaultVal} to pnpm-workspace.yaml`);
+		return;
+	}
+	syncExistingObjectPair(pair, key, subKey, defaultVal, context);
+};
+const cleanRetiredObjectKeys = (mapNode, key, defaultObj, context) => {
+	const { mode, recordMutation, warn } = context;
+	const itemsToRemove = [];
+	for (const pair of mapNode.items) {
+		const subKey = getNodeKey(pair.key);
+		if (!(subKey in defaultObj)) {
+			if (isScalar(pair.value) && hasManagedMarker(pair.value.comment)) if (mode === "enforce") itemsToRemove.push(subKey);
+			else warn(`pnpm-workspace.yaml: "${subKey}" in ${key} is marked with "${MANAGED_BY_SKU_COMMENT}", but is no longer a sku default. Run "sku configure" to remove it, or delete its "${MANAGED_BY_SKU_COMMENT}" marker to keep it as a user-managed entry.`);
+		}
+	}
+	for (const subKey of itemsToRemove) {
+		mapNode.delete(subKey);
+		recordMutation(`removed retired entry ${key}.${subKey} from pnpm-workspace.yaml`);
+	}
+};
+const syncObjectSettings = (context) => {
+	const { doc } = context;
+	for (const { key, entries } of objectSettings) {
+		if (!doc.has(key)) {
+			doc.set(key, doc.createNode({}));
+			context.recordMutation(`added ${key} to pnpm-workspace.yaml`);
+		}
+		const mapNode = doc.get(key, true);
+		if (!isMap(mapNode)) continue;
+		for (const [subKey, defaultVal] of Object.entries(entries)) syncObjectPair(mapNode, key, subKey, defaultVal, context);
+		cleanRetiredObjectKeys(mapNode, key, entries, context);
+	}
+};
+//#endregion
+export { syncObjectSettings };

package/dist/private/utils/src/packageManager/syncShared.mjs

@@ -0,0 +1,25 @@
+import { MANAGED_BY_SKU_MARKER } from "./pnpmWorkspaceDefaults.mjs";
+import { isScalar } from "yaml";
+//#region ../../private/utils/src/packageManager/syncShared.ts
+const getNodeKey = (node) => isScalar(node) ? String(node.value) : String(node);
+const hasManagedMarker = (comment) => {
+	const trimmed = comment?.trim();
+	if (!trimmed) return false;
+	return trimmed === "sku_managed" || trimmed.endsWith(`# sku_managed`);
+};
+const formatComment = (explanatory) => explanatory ? ` ${explanatory} # ${MANAGED_BY_SKU_MARKER}` : ` ${MANAGED_BY_SKU_MARKER}`;
+const clearCommentBefore = (node) => {
+	if (!isScalar(node) || !node.commentBefore) return false;
+	node.commentBefore = void 0;
+	return true;
+};
+const setManagedComment = (node, explanatory) => {
+	if (!isScalar(node)) return false;
+	const comment = formatComment(explanatory);
+	const modified = node.comment !== comment || Boolean(node.commentBefore);
+	node.comment = comment;
+	node.commentBefore = void 0;
+	return modified;
+};
+//#endregion
+export { clearCommentBefore, getNodeKey, hasManagedMarker, setManagedComment };

package/dist/private/utils/src/packageManager/syncSingleValueSettings.mjs

@@ -0,0 +1,58 @@
+import { singleValueSettings } from "./pnpmWorkspaceDefaults.mjs";
+import { clearCommentBefore, getNodeKey, setManagedComment } from "./syncShared.mjs";
+import { isMap, isScalar } from "yaml";
+//#region ../../private/utils/src/packageManager/syncSingleValueSettings.ts
+const findMapPair = (doc, key) => {
+	if (!isMap(doc.contents)) return;
+	return doc.contents.items.find((pair) => getNodeKey(pair.key) === key);
+};
+const markSingleValueAsManaged = (node, explanatory, doc, key) => {
+	const modified = setManagedComment(node, explanatory);
+	const pair = findMapPair(doc, key);
+	return (pair ? clearCommentBefore(pair.key) : false) || modified;
+};
+const handleMatchingSingleValue = (node, explanatory, currentValue, doc, key, context) => {
+	if (isScalar(node)) {
+		if (markSingleValueAsManaged(node, explanatory, doc, key)) context.recordMutation(`adopted ${key}: ${String(currentValue)} in pnpm-workspace.yaml`);
+		return;
+	}
+	const wrapped = doc.createNode(currentValue);
+	setManagedComment(wrapped, explanatory);
+	doc.set(key, wrapped);
+	context.recordMutation(`adopted ${key}: ${String(currentValue)} in pnpm-workspace.yaml`);
+};
+const updateExistingSingleValue = (key, defaultValue, explanatory, context) => {
+	const { doc, mode, recordMutation, warn } = context;
+	const node = doc.get(key, true);
+	const currentValue = isScalar(node) ? node.value : doc.get(key);
+	if (currentValue === defaultValue) {
+		handleMatchingSingleValue(node, explanatory, currentValue, doc, key, context);
+		return;
+	}
+	if (mode === "enforce") {
+		const updatedNode = doc.createNode(defaultValue);
+		setManagedComment(updatedNode, explanatory);
+		doc.set(key, updatedNode);
+		const pair = findMapPair(doc, key);
+		if (pair) clearCommentBefore(pair.key);
+		recordMutation(`updated ${key}: ${String(currentValue)} → ${defaultValue} in pnpm-workspace.yaml`);
+		return;
+	}
+	warn(`pnpm-workspace.yaml: "${key}" has value ${String(currentValue)}, recommended is ${defaultValue}. Run "sku configure" to align.`);
+};
+const syncSingleValue = ({ key, value: defaultValue, comment }, context) => {
+	const { doc, recordMutation } = context;
+	if (!doc.has(key)) {
+		const node = doc.createNode(defaultValue);
+		setManagedComment(node, comment);
+		doc.set(key, node);
+		recordMutation(`added ${key}: ${defaultValue} to pnpm-workspace.yaml`);
+		return;
+	}
+	updateExistingSingleValue(key, defaultValue, comment, context);
+};
+const syncSingleValueSettings = (context) => {
+	for (const setting of singleValueSettings) syncSingleValue(setting, context);
+};
+//#endregion
+export { syncSingleValueSettings };

package/dist/program/commands/configure/configure.action.mjs

@@ -1,7 +1,7 @@
-import configureApp_default from "../../../utils/configureApp.mjs";
+import { configureApp } from "../../../utils/configureApp.mjs";
 //#region src/program/commands/configure/configure.action.ts
-const configureAction = ({ skuContext }) => {
-	configureApp_default(skuContext);
+const configureAction = async ({ skuContext }) => {
+	await configureApp(skuContext, { mode: "enforce" });
 };
 //#endregion
 export { configureAction };

package/dist/program/commands/configure/configure.command.mjs

@@ -2,7 +2,7 @@ import { Command } from "commander";
 //#region src/program/commands/configure/configure.command.ts
 const configureCommand = new Command("configure").description("Emit and update configuration files for your project.").action(async (options) => {
 	const { configureAction } = await import("./configure.action.mjs");
-	configureAction(options);
+	await configureAction(options);
 });
 //#endregion
 export { configureCommand };

package/dist/program/commands/serve/serve.command.mjs

@@ -6,7 +6,7 @@ import { Command } from "commander";
 const serveCommand = new Command("serve").description("Serve a production build of a statically-rendered application from your local machine.").addOption(siteOption).addOption(portOption).addOption(strictPortOption).addOption(listUrlsOption).action(async ({ site, skuContext }, command) => {
 	const { serveAction } = await import("./serve.action.mjs");
 	const { environment } = command.optsWithGlobals();
-	serveAction({
+	await serveAction({
 		site,
 		environment,
 		skuContext

package/dist/program/commands/translations/helpers/translation-helpers.mjs

@@ -1,6 +1,6 @@
 import { getVocabConfig } from "../../../../services/vocab/config.mjs";
-import { execSync } from "node:child_process";
 import { resolveConfig } from "@vocab/core";
+import { execSync } from "node:child_process";
 //#region src/program/commands/translations/helpers/translation-helpers.ts
 const ensureBranch = async () => {
 	const branch = getGitBranch();

package/dist/utils/configure.mjs

@@ -17,8 +17,8 @@ const configureProject = async (skuContext) => {
 		log(`"skuSkipConfigure" set in ${packageJson}, skipping sku configuration`);
 		return;
 	}
-	const { default: configure } = await import("./configureApp.mjs");
-	await configure(skuContext);
+	const { configureApp } = await import("./configureApp.mjs");
+	await configureApp(skuContext);
 };
 const validatePeerDeps = (skuContext) => {
 	if (skipValidatePeerDeps) {

package/dist/utils/configureApp.mjs

@@ -1,5 +1,6 @@
 import { getPathFromCwd, writeFileToCWD } from "../private/utils/src/filesystem/cwd.mjs";
-import { isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, rootDir } from "../private/utils/src/packageManager/packageManager.mjs";
+import { isPnpm, rootDir } from "../private/utils/src/packageManager/packageManager.mjs";
+import { ensurePnpmWorkspaceConfig } from "../private/utils/src/packageManager/ensurePnpmWorkspaceConfig.mjs";
 import "../private/utils/src/index.mjs";
 import options from "../config/prettier.mjs";
 import { bundleReportFolder } from "../services/webpack/config/plugins/bundleAnalyzer.mjs";
@@ -7,8 +8,6 @@ import { createTSConfig } from "../services/typescript/tsconfig.mjs";
 import getCertificate from "./certificate.mjs";
 import { syncPathAliasImports } from "./pathAliasImports.mjs";
 import { validateSkuConfigFormat } from "./validateSkuConfigFormat.mjs";
-import { getPnpmConfigDependencies } from "../services/packageManager/getPnpmConfigDependencies.mjs";
-import { validatePnpmConfig } from "../services/packageManager/pnpmConfig.mjs";
 import { warnOnLegacyReact } from "./warnOnLegacyReact.mjs";
 import path from "node:path";
 import { rm } from "node:fs/promises";
@@ -18,7 +17,7 @@ import ensureGitignore from "ensure-gitignore";
 const coverageFolder = "coverage";
 const convertToForwardSlashPaths = (pathStr) => pathStr.replace(/\\/g, "/");
 const addSep = (p) => `${p}${path.sep}`;
-var configureApp_default = async (skuContext) => {
+async function configureApp(skuContext, options$1) {
 	const { paths, httpsDevServer, languages, hosts } = skuContext;
 	validateSkuConfigFormat(paths.appSkuConfigPath);
 	const targetDirectories = [.../* @__PURE__ */ new Set([addSep(paths.relativeTarget)])];
@@ -65,16 +64,11 @@ var configureApp_default = async (skuContext) => {
 		comment: "managed by sku",
 		patterns: gitIgnorePatterns.map(convertToForwardSlashPaths)
 	});
-	if (rootDir && isAtLeastPnpmV10()) {
-		const pnpmConfigDependencies = await getPnpmConfigDependencies();
-		const hasRecommendedPnpmVersionInstalled = isAtLeastRecommendedPnpmVersion();
-		const pnpmPluginSkuInstalled = pnpmConfigDependencies.includes("pnpm-plugin-sku");
-		await validatePnpmConfig({
-			hasRecommendedPnpmVersionInstalled,
-			pnpmPluginSkuInstalled
-		});
-	}
+	if (rootDir && isPnpm) await ensurePnpmWorkspaceConfig({
+		targetDir: rootDir,
+		mode: options$1?.mode ?? "additive"
+	});
 	warnOnLegacyReact();
-};
+}
 //#endregion
-export { configureApp_default as default };
+export { configureApp };

package/dist/utils/validatePeerDeps.mjs

@@ -7,8 +7,8 @@ import "../private/utils/src/console/index.mjs";
 import telemetry_default from "../services/telemetry/index.mjs";
 import { readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
-import semver from "semver";
 import { fdir } from "fdir";
+import semver from "semver";
 //#region src/utils/validatePeerDeps.ts
 const asyncMap = (list, fn) => Promise.all(list.map((item) => fn(item)));
 const singletonPackages = ["@vanilla-extract/css"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sku",
-  "version": "16.2.0",
+  "version": "16.3.0-replace-pnpm-plugin-20260907064258",
   "description": "Front-end development toolkit, powered by Webpack, Babel, Vanilla Extract and Jest",
   "types": "./dist/index.d.mts",
   "bin": {
@@ -169,7 +169,8 @@
     "webpack-bundle-analyzer": "^5.1.1",
     "webpack-dev-server": "^5.2.4",
     "webpack-merge": "^6.0.1",
-    "webpack-node-externals": "^3.0.0"
+    "webpack-node-externals": "^3.0.0",
+    "yaml": "^2.8.3"
   },
   "devDependencies": {
     "@sku-private/tsdown": "0.0.0",

package/dist/services/packageManager/getPnpmConfigDependencies.mjs

@@ -1,12 +0,0 @@
-import { execAsync } from "../../utils/execAsync.mjs";
-//#region src/services/packageManager/getPnpmConfigDependencies.ts
-const getPnpmConfigDependencies = async () => {
-	const rawResult = await execAsync(`pnpm config get --json`);
-	if (!rawResult) return [];
-	const result = JSON.parse(rawResult);
-	const configDependencies = result["config-dependencies"] ?? result.configDependencies;
-	if (!configDependencies) return [];
-	return Object.keys(configDependencies);
-};
-//#endregion
-export { getPnpmConfigDependencies };

package/dist/services/packageManager/pnpmConfig.mjs

@@ -1,14 +0,0 @@
-import { accent } from "../../private/utils/src/console/styles.mjs";
-import { banner } from "../../private/utils/src/console/banner.mjs";
-import "../../private/utils/src/console/index.mjs";
-//#region src/services/packageManager/pnpmConfig.ts
-const validatePnpmConfig = async ({ hasRecommendedPnpmVersionInstalled, pnpmPluginSkuInstalled }) => {
-	if (!pnpmPluginSkuInstalled || !hasRecommendedPnpmVersionInstalled) {
-		const messages = [];
-		if (!hasRecommendedPnpmVersionInstalled) messages.push(`Please ensure you are on ${accent("PNPM v10.13.0")} or later.`);
-		messages.push(`Please delete your top-level ${accent("node_modules")} and run "${accent("pnpm add --config pnpm-plugin-sku && pnpm install")}".`);
-		banner("caution", "pnpm-plugin-sku is not configured correctly", messages);
-	}
-};
-//#endregion
-export { validatePnpmConfig };