@orkestrel/scaffold 0.0.108 → 0.0.109

package/dist/bin/main.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { align, renderTable, strip, stripControls, width } from "@orkestrel/console";
 import { attempt, isArray, isDefined, isError, isInstance, isRecord, isString, parseJSON } from "@orkestrel/contract";
-import { AXES, BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFORMANCE_TEST_PATH, Compiler, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, FRAMEWORKS, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, JOURNEY_CONFIG_PATH, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, RESERVED_SHEET_NAMES, SERVICE_SETUP_PATH, SHEET_ENTRY_NAME, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SHOWCASE_PAGES_PATH, SKILLS_CONFIG_PATH, STYLES_ENTRY_PATH, ScaffoldError, THEMES_BARREL_PATH, THEMES_ENTRY_PATH, TREE_TEST_PATH, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToFaces, blueprintToManifestOverrides, blueprintToProjects, blueprintToScripts, blueprintToSheets, blueprintToTestArtifacts, blueprintToWritableScripts, compareVersions, createBlueprint, extractRangeMajor, extractVersion, isFloorPath, isScaffoldError, isSheetName, iterateAnswers, manifestToDependencies, manifestToName, nameToGuide, parseExtension, replaceManifestOverrides, replaceManifestScripts, replacePlanRanges } from "../src/core/index.js";
+import { AXES, BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFORMANCE_TEST_PATH, Compiler, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, FRAMEWORKS, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, JOURNEY_CONFIG_PATH, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, RESERVED_SHEET_NAMES, SERVICE_SETUP_PATH, SHEET_ENTRY_NAME, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SHOWCASE_PAGES_PATH, SKILLS_CONFIG_PATH, STYLES_ENTRY_PATH, ScaffoldError, THEMES_BARREL_PATH, THEMES_ENTRY_PATH, TREE_TEST_PATH, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToFaces, blueprintToManifestOverrides, blueprintToProjects, blueprintToScripts, blueprintToSheets, blueprintToTestArtifacts, blueprintToToolchainHolds, blueprintToWritableScripts, compareVersions, createBlueprint, extractRangeMajor, extractVersion, isFloorPath, isScaffoldError, isSheetName, iterateAnswers, manifestToDependencies, manifestToName, nameToGuide, parseExtension, replaceManifestOverrides, replaceManifestScripts, replacePlanRanges } from "../src/core/index.js";
 import { MAX_INVENTORY_PATHS, Materializer, Upstream, filesToHost, isExactCaseFile, isPhysicalDirectory, isWorktree, listFiles, readFileText, readHostFloor, readHostManifest, readSnapshot, resolveContainedPath } from "../src/server/index.js";
 import { createSession } from "@orkestrel/process/server";
 import { createMarkdown, flattenText, isTableNode } from "@orkestrel/markdown";
@@ -10,7 +10,7 @@ import { normalize } from "node:path";
 import { parseArgs } from "node:util";
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.108",
+	version: "0.0.109",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -87,7 +87,7 @@ var package_default = {
 		"test:templates": "vitest run --config vite.config.ts --no-cache --reporter=dot --project templates",
 		"test:distribution": "vitest run --config vite.config.ts --no-cache --reporter=dot --project distribution",
 		"test:probe": "vitest run --config vite.config.ts --no-cache --reporter=verbose --project probe",
-		"test:bench": "vitest bench --config vite.config.ts --no-cache --project probe",
+		"test:bench": "vitest bench --config vite.config.ts --no-cache --project \"probe (bench)\" --mode benchmark",
 		"test:setup": "vitest run --config vite.config.ts --no-cache --reporter=dot --project setup",
 		"build": "npm run clean && npm run build:src && npm run build:host && npm run build:skills && npm run build:inventory",
 		"build:src": "npm run build:src:core && npm run build:src:server && npm run build:src:bin",
@@ -109,25 +109,24 @@ var package_default = {
 		"@orkestrel/template": "^0.0.10"
 	},
 	devDependencies: {
-		"@microsoft/api-extractor": "^7.59.4",
+		"@microsoft/api-extractor": "^7.60.0",
 		"@orkestrel/browser": "^0.0.29",
 		"@orkestrel/guide": "^0.0.25",
 		"@orkestrel/html": "^0.0.12",
-		"@orkestrel/probe": "^0.0.24",
-		"@orkestrel/test": "^0.0.29",
+		"@orkestrel/probe": "^0.0.25",
+		"@orkestrel/test": "^0.0.30",
 		"@types/node": "^24.19.2",
-		"@vitest/browser-playwright": "^4.1.11",
-		"oxfmt": "^0.74.0",
-		"oxlint": "^1.89.0",
-		"playwright": "^1.63.0",
-		"typescript": "^6.0.3",
+		"@vitest/browser-playwright": "^5.0.5",
+		"oxfmt": "^0.75.0",
+		"oxlint": "^1.90.0",
+		"playwright": "^1.64.1",
+		"typescript": "^7.0.2",
 		"vite": "^8.3.5",
-		"vitest": "^4.1.12"
+		"vitest": "^5.0.5"
 	},
 	engines: { "node": ">=22.18.0" }
 };
-//#endregion
-//#region src/bin/constants.ts
+// src/bin/constants.ts
 /**
 * Names the command the executable installs as.
 *
@@ -342,8 +341,7 @@ var SHEET_IMPORT_PATTERN = /from\s+(['"])[^'"]*dist\/src\/[^'"]+\.css\?raw\1/u;
 * refuses it, while a protocol-relative `//` specifier is outside this pattern.
 */
 var ROOT_IMPORT_PATTERN = /^\s*import\s[^'"]*?(['"])(\/(?!\/)[^'"]*)\1/gmu;
-//#endregion
-//#region src/bin/errors.ts
+// src/bin/errors.ts
 /**
 * Represents the error raised when a command line is not a command.
 *
@@ -399,8 +397,7 @@ var UsageError = class extends Error {
 function isUsageError(value) {
 	return isInstance(value, UsageError);
 }
-//#endregion
-//#region src/bin/helpers.ts
+// src/bin/helpers.ts
 /**
 * Reads the option name out of the token usage displays it as.
 *
@@ -832,13 +829,15 @@ function releasesToExit(releases) {
 	return releases.some((release) => release.lookup !== "found" || release.name.startsWith("@orkestrel/") && release.range !== `^${release.latest}`) ? 1 : 0;
 }
 /**
-* Projects foreign floor and supported-major drift into audit questions.
+* Projects foreign floor, supported-major, and held-major drift into audit questions.
 *
 * @param releases - The release verdicts to measure.
 * @param served - Alternate release verdicts used to detect a newer served major.
-* @returns One non-blocking question for each stale floor and each crossed major.
+* @param holds - The toolchain holds selected for this workspace; default: none.
+* @returns One non-blocking question for each stale floor, each crossed major, and each declaration
+* past its hold. A held tool's newer served major reads as its hold and the reason.
 */
-function releasesToQuestions(releases, served = releases) {
+function releasesToQuestions(releases, served = releases, holds = {}) {
 	return Iterator.from(releases).flatMap((release) => {
 		if (release.name.startsWith("@orkestrel/")) return [];
 		const declared = extractRangeMajor(release.range);
@@ -847,15 +846,25 @@ function releasesToQuestions(releases, served = releases) {
 		const floor = extractVersion(release.range.startsWith("^") || release.range.startsWith("~") ? release.range.slice(1) : release.range);
 		const alternate = served.find((candidate) => candidate.name === release.name);
 		const published = release.major ?? (alternate?.lookup === "found" ? extractVersion(alternate.latest)?.[0] : void 0);
-		return [...declared !== void 0 && current !== void 0 && resolved !== void 0 && floor !== void 0 && resolved[0] === declared && compareVersions(current, floor.join(".")) > 0 ? [{
-			field: "dependencies",
-			message: `${release.name} declares the floor ${release.range}, while the registry serves ${current} within major ${String(declared)}.`,
-			blocking: false
-		}] : [], ...declared !== void 0 && published !== void 0 && declared < published ? [{
-			field: "dependencies",
-			message: `${release.name} declares major ${String(declared)}, while the registry serves major ${String(published)}.`,
-			blocking: false
-		}] : []];
+		const hold = Object.hasOwn(holds, release.name) ? holds[release.name] : void 0;
+		const held = hold === void 0 ? void 0 : extractRangeMajor(hold.range);
+		return [
+			...declared !== void 0 && current !== void 0 && resolved !== void 0 && floor !== void 0 && resolved[0] === declared && compareVersions(current, floor.join(".")) > 0 ? [{
+				field: "dependencies",
+				message: `${release.name} declares the floor ${release.range}, while the registry serves ${current} within major ${String(declared)}.`,
+				blocking: false
+			}] : [],
+			...declared !== void 0 && published !== void 0 && declared < published ? [{
+				field: "dependencies",
+				message: hold !== void 0 && held === declared ? `${release.name} is held at major ${String(declared)}, while the registry serves major ${String(published)}: ${hold.reason}.` : `${release.name} declares major ${String(declared)}, while the registry serves major ${String(published)}.`,
+				blocking: false
+			}] : [],
+			...declared !== void 0 && hold !== void 0 && held !== void 0 && declared > held ? [{
+				field: "dependencies",
+				message: `${release.name} declares major ${String(declared)}, past its hold at major ${String(held)}: ${hold.reason}.`,
+				blocking: false
+			}] : []
+		];
 	}).toArray();
 }
 /**
@@ -1615,8 +1624,7 @@ function findGitRefusal(target, count, chunk) {
 	if (count + chunk.records.length > MAX_INVENTORY_PATHS) return `The git query for target at ${target} exceeded the working-tree inventory limit.`;
 	return chunk.pending.length > MAX_PATH_LENGTH + 3 ? `The git query for target at ${target} returned an unfinished record beyond the supported path limit.` : void 0;
 }
-//#endregion
-//#region src/bin/GitQuery.ts
+// src/bin/GitQuery.ts
 /**
 * Represents one git query read as its NUL-separated records.
 *
@@ -1727,8 +1735,7 @@ var GitQuery = class {
 		if (!this.#controller.signal.aborted) this.#controller.abort(new ScaffoldError("TARGET", message, { target: this.#target }));
 	}
 };
-//#endregion
-//#region src/bin/CLI.ts
+// src/bin/CLI.ts
 /**
 * Represents the executable: one command line in, one exit code out.
 *
@@ -1882,7 +1889,7 @@ var CLI = class {
 		const groups = selectionToGroups(command.groups);
 		const declared = manifestToWritableDependencies(manifest, blueprint);
 		const versions = await this.#versions(declared, command.offline === true, blueprint);
-		const questions = [...this.#targetQuestions(target, blueprint, groups), ...releasesToQuestions(versions.releases)];
+		const questions = [...this.#targetQuestions(target, blueprint, groups), ...releasesToQuestions(versions.releases, void 0, blueprintToToolchainHolds(blueprint))];
 		const host = await this.#host(command.from, target, command.offline === true);
 		try {
 			const [measured] = this.#survey(host.materializer, blueprint, target, groups);
@@ -2359,9 +2366,9 @@ var CLI = class {
 	#compile(blueprint, groups) {
 		const compiler = new Compiler();
 		try {
-			const scaffolding = compiler.compile(blueprint, groups);
-			if (scaffolding.plan !== void 0 && scaffolding.questions.length === 0) return scaffolding.plan;
-			throw new ScaffoldError("BLOCKED", scaffolding.questions.map((question) => `${question.field}: ${question.message}`).join(" "), { questions: scaffolding.questions.length });
+			const result = compiler.compile(blueprint, groups);
+			if (result.plan !== void 0 && result.questions.length === 0) return result.plan;
+			throw new ScaffoldError("BLOCKED", result.questions.map((question) => `${question.field}: ${question.message}`).join(" "), { questions: result.questions.length });
 		} finally {
 			compiler.destroy();
 		}
@@ -2369,13 +2376,13 @@ var CLI = class {
 	#survey(materializer, blueprint, target, groups) {
 		const compiler = new Compiler();
 		try {
-			const scaffolding = compiler.compile(blueprint, groups);
-			if (scaffolding.plan === void 0) return [compiler.audit(blueprint, {}, groups), void 0];
-			const measured = materializer.audit(scaffolding.plan, target);
+			const result = compiler.compile(blueprint, groups);
+			if (result.plan === void 0) return [compiler.audit(blueprint, {}, groups), void 0];
+			const measured = materializer.audit(result.plan, target);
 			return [{
 				...measured,
-				questions: [...measured.questions, ...scaffolding.questions]
-			}, scaffolding.plan];
+				questions: [...measured.questions, ...result.questions]
+			}, result.plan];
 		} finally {
 			compiler.destroy();
 		}
@@ -2781,13 +2788,11 @@ var CLI = class {
 		this.#diagnostic(sanitizeLine(line));
 	}
 };
-//#endregion
-//#region src/bin/main.ts
+// src/bin/main.ts
 process.stdout.on("error", (error) => {
 	if ("code" in error && error.code === "EPIPE") return;
 	throw error;
 });
 process.exitCode = await new CLI({ upstream: environmentToUpstream(process.env) }).execute(process.argv.slice(2));
-//#endregion
 
 //# sourceMappingURL=main.js.map