@orkestrel/scaffold 0.0.10 → 0.0.12

package/dist/src/server/index.d.cts

@@ -141,7 +141,8 @@ export declare const DEFAULT_SYNC_TIMEOUT = 10000;
  * `app/<environment>/`; a target with no environment on either axis is also a coded
  * `TARGET` failure. The `bin`, `integration`, and `service` facts probe physical
  * directories at `src/bin`, `tests/integration`, and `tests/service`, respectively,
- * never the workspace name. `dependencies` /
+ * while `global` probes the physical exact-case `tests/setupGlobal.ts` file; none is
+ * inferred from the workspace name. `dependencies` /
  * `peers` are the `@orkestrel/`-prefixed entries of `manifest.dependencies` /
  * `manifest.peerDependencies` (a peer flagged `peerDependenciesMeta[name]
  * .optional === true` carries `optional: true`). `extras` is EVERY entry of

package/dist/src/server/index.d.ts

@@ -141,7 +141,8 @@ export declare const DEFAULT_SYNC_TIMEOUT = 10000;
  * `app/<environment>/`; a target with no environment on either axis is also a coded
  * `TARGET` failure. The `bin`, `integration`, and `service` facts probe physical
  * directories at `src/bin`, `tests/integration`, and `tests/service`, respectively,
- * never the workspace name. `dependencies` /
+ * while `global` probes the physical exact-case `tests/setupGlobal.ts` file; none is
+ * inferred from the workspace name. `dependencies` /
  * `peers` are the `@orkestrel/`-prefixed entries of `manifest.dependencies` /
  * `manifest.peerDependencies` (a peer flagged `peerDependenciesMeta[name]
  * .optional === true` carries `optional: true`). `extras` is EVERY entry of

package/dist/src/server/index.js

@@ -1,7 +1,7 @@
-import { CONTROL_CHARACTER_PATTERN, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, HEX_PATTERN, HOST_PATHS, INVALID_PATH_CHARACTER_PATTERN, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_COLLECTION_ITEMS, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, SERVICE_SCRIPT_PATH, SYNC_BASELINE_PATTERN, ScaffoldError, VERSION_PATTERN, blueprint, bytesToHex, contentByteLength, devDependenciesFor, diffPlan, findFileConflict, findPathConflict, hasOnlyDataProperties, hasValidAuditBytes, hasValidSnapshotBytes, isDenseDataArray, isDependency, isEmitterErrorHandler, isPlan, isSyncReport, isWorkspaceName, manifestToDependencies, manifestToName, ownDataValue, parsePlan, parseSyncReport, rangeToFreshness, snapshotPlan, validateDependencyArray, validatePlan } from "../core/index.js";
+import { CONTROL_CHARACTER_PATTERN, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, GLOBAL_SETUP_PATH, HEX_PATTERN, HOST_PATHS, INVALID_PATH_CHARACTER_PATTERN, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_COLLECTION_ITEMS, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, SERVICE_SCRIPT_PATH, SYNC_BASELINE_PATTERN, ScaffoldError, VERSION_PATTERN, blueprint, bytesToHex, contentByteLength, devDependenciesFor, diffPlan, findFileConflict, findPathConflict, hasOnlyDataProperties, hasValidAuditBytes, hasValidSnapshotBytes, isDenseDataArray, isDependency, isEmitterErrorHandler, isPlan, isSyncReport, isWorkspaceName, manifestToDependencies, manifestToName, ownDataValue, parsePlan, parseSyncReport, rangeToFreshness, snapshotPlan, validateDependencyArray, validatePlan } from "../core/index.js";
 import { attempt, booleanShape, createContract, integerShape, isError, isFunction, isRecord, isString, objectShape, optionalShape, parseJSON, parseJSONAs, stringShape } from "@orkestrel/contract";
 import { createHash, randomUUID } from "node:crypto";
-import { chmodSync, closeSync, constants, copyFileSync, existsSync, fstatSync, linkSync, lstatSync, mkdirSync, openSync, opendirSync, readSync, realpathSync, renameSync, rmSync, rmdirSync, writeFileSync } from "node:fs";
+import { chmodSync, closeSync, constants, copyFileSync, existsSync, fstatSync, linkSync, lstatSync, mkdirSync, openSync, opendirSync, readSync, readdirSync, realpathSync, renameSync, rmSync, rmdirSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { flattenText, isBlockquoteNode, isParagraphNode, parseDocument, walkNodes } from "@orkestrel/markdown";
@@ -1745,7 +1745,8 @@ function selectOrkestrelEntries(value) {
 * `app/<environment>/`; a target with no environment on either axis is also a coded
 * `TARGET` failure. The `bin`, `integration`, and `service` facts probe physical
 * directories at `src/bin`, `tests/integration`, and `tests/service`, respectively,
-* never the workspace name. `dependencies` /
+* while `global` probes the physical exact-case `tests/setupGlobal.ts` file; none is
+* inferred from the workspace name. `dependencies` /
 * `peers` are the `@orkestrel/`-prefixed entries of `manifest.dependencies` /
 * `manifest.peerDependencies` (a peer flagged `peerDependenciesMeta[name]
 * .optional === true` carries `optional: true`). `extras` is EVERY entry of
@@ -1774,7 +1775,8 @@ function selectOrkestrelEntries(value) {
 * ```
 */
 function deriveBlueprint(target) {
-	const parsed = parseJSON(readManifest(target));
+	const text = readManifest(target);
+	const parsed = parseJSON(text);
 	if (!isRecord(parsed)) throw new ScaffoldError("TARGET", `Manifest at ${target} is not a valid JSON object`, { target });
 	const src = ENVIRONMENTS.filter((environment) => isRealDirectory(join(target, "src", environment)));
 	const app = ENVIRONMENTS.filter((environment) => isRealDirectory(join(target, "app", environment)));
@@ -1798,11 +1800,15 @@ function deriveBlueprint(target) {
 	const keywords = Array.isArray(rawKeywords) && rawKeywords.every((word) => typeof word === "string") ? rawKeywords : [];
 	const rawVersion = ownDataValue(parsed, "version");
 	const version = typeof rawVersion === "string" ? rawVersion : DEFAULT_VERSION;
-	const rawNode = ownDataValue(ownDataValue(parsed, "engines"), "node");
+	const rawEngines = ownDataValue(parsed, "engines");
+	const rawNode = ownDataValue(rawEngines, "node");
 	const engines = typeof rawNode === "string" ? rawNode : DEFAULT_ENGINES;
 	const bin = isRealDirectory(join(target, "src", "bin"));
 	const integration = isRealDirectory(join(target, "tests", "integration"));
 	const service = isRealDirectory(join(target, "tests", "service"));
+	const tests = join(target, dirname(GLOBAL_SETUP_PATH));
+	const entries = attempt(() => readdirSync(tests));
+	const global = entries.success && entries.value.includes(basename(GLOBAL_SETUP_PATH)) && isRealFile(join(target, GLOBAL_SETUP_PATH));
 	if (service) {
 		const missing = [];
 		if (!isRealFile(join(target, "tests", "setupService.ts"))) missing.push("tests/setupService.ts");
@@ -1840,7 +1846,8 @@ function deriveBlueprint(target) {
 		extras: [],
 		bin,
 		integration,
-		service
+		service,
+		global
 	}))));
 	const rawDevDependencies = ownDataValue(parsed, "devDependencies");
 	const devDependencies = isRecord(rawDevDependencies) ? rawDevDependencies : {};
@@ -1861,7 +1868,8 @@ function deriveBlueprint(target) {
 		overrides: [],
 		bin,
 		integration,
-		service
+		service,
+		global
 	});
 }
 /**
@@ -2516,7 +2524,8 @@ function stageHost(root, out, paths = HOST_PATHS) {
 				root,
 				destination: entry.destination
 			});
-			mkdirSync(dirname(resolvePhysicalPath(staging, entry.storage, "WRITE", "staging")), { recursive: true });
+			const destination = resolvePhysicalPath(staging, entry.storage, "WRITE", "staging");
+			mkdirSync(dirname(destination), { recursive: true });
 			validateWriteAnchor(stagingAnchor, "host staging root");
 			const containedDestination = resolvePhysicalPath(staging, entry.storage, "WRITE", "staging");
 			copyFileSync(source, containedDestination, constants.COPYFILE_EXCL);
@@ -3228,7 +3237,8 @@ var Materializer = class {
 				const sourceDigest = digestFile(source);
 				const expectedHex = preview.value[file.path];
 				if (expectedHex === void 0 || sourceDigest !== digestHex(expectedHex)) throw new ScaffoldError("WRITE", `Prune target changed at ${file.path}`, { path: file.path });
-				mkdirSync(dirname(resolvePhysicalPath(transaction.backup, file.path, "WRITE", "quarantine")), { recursive: true });
+				const destination = resolvePhysicalPath(transaction.backup, file.path, "WRITE", "quarantine");
+				mkdirSync(dirname(destination), { recursive: true });
 				validateWriteTarget(transaction, void 0);
 				const containedDestination = resolvePhysicalPath(transaction.backup, file.path, "WRITE", "quarantine");
 				renameSync(source, containedDestination);
@@ -3344,7 +3354,8 @@ var Materializer = class {
 			return;
 		}
 		if (manifest === void 0 && artifact.hex === void 0) {
-			const status = lstatSync(resolvePhysicalPath(this.#host, source, "TARGET", "host"));
+			const directory = resolvePhysicalPath(this.#host, source, "TARGET", "host");
+			const status = lstatSync(directory);
 			if (!status.isDirectory() || status.isSymbolicLink()) throw new ScaffoldError("TARGET", `Host artifact is not a physical directory at ${source}`, { source });
 			const destination = resolvePhysicalPath(transaction.stage, artifact.path, "WRITE", "staging");
 			mkdirSync(destination, { recursive: true });
@@ -3687,7 +3698,8 @@ var Sync = class Sync {
 					limit: MAX_ARTIFACT_BYTES
 				});
 				validateWriteDirectories(transaction);
-				mkdirSync(dirname(resolvePhysicalPath(transaction.stage, guide.path, "WRITE", "staging")), { recursive: true });
+				const candidate = resolvePhysicalPath(transaction.stage, guide.path, "WRITE", "staging");
+				mkdirSync(dirname(candidate), { recursive: true });
 				validateWriteDirectories(transaction);
 				const destination = resolvePhysicalPath(transaction.stage, guide.path, "WRITE", "staging");
 				writeFileSync(destination, guide.content, {