@orkestrel/scaffold 0.0.4 → 0.0.6

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

@@ -153,8 +153,8 @@ export declare const DEFAULT_SYNC_TIMEOUT = 10000;
  * dev-installed for local testing) is likewise excluded from `extras` — it
  * already appears as a `peer`/`dependency` above, and double-counting it as
  * an `extra` would land it in `peers ∩ extras`, a blocking `validateBlueprint`
- * gate. `overrides` is always `[]` — derivation cannot know a caller's
- * template-override intent.
+ * gate. `overrides` is always `[]` — derivation cannot recover a caller's
+ * artifact-override intent from repository state.
  * @returns The reconstructed `Blueprint`.
  * @throws `ScaffoldError('TARGET', …)` when `target`'s manifest is unreadable
  *   (via `readManifest`), is not valid JSON, its name is unsafe for its
@@ -210,6 +210,8 @@ export declare function discardWriteTransaction(transaction: WriteTransaction):
  *   `@orkestrel/`. A child with an unreadable or unparsable `package.json`,
  *   or a non-`@orkestrel` name, is skipped silently — it simply is not a
  *   fleet member.
+ * @throws `ScaffoldError('TARGET', …)` when a child directory name contains
+ *   terminal controls and therefore cannot be safely inspected or reported.
  *
  * @example
  * ```ts

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

@@ -153,8 +153,8 @@ export declare const DEFAULT_SYNC_TIMEOUT = 10000;
  * dev-installed for local testing) is likewise excluded from `extras` — it
  * already appears as a `peer`/`dependency` above, and double-counting it as
  * an `extra` would land it in `peers ∩ extras`, a blocking `validateBlueprint`
- * gate. `overrides` is always `[]` — derivation cannot know a caller's
- * template-override intent.
+ * gate. `overrides` is always `[]` — derivation cannot recover a caller's
+ * artifact-override intent from repository state.
  * @returns The reconstructed `Blueprint`.
  * @throws `ScaffoldError('TARGET', …)` when `target`'s manifest is unreadable
  *   (via `readManifest`), is not valid JSON, its name is unsafe for its
@@ -210,6 +210,8 @@ export declare function discardWriteTransaction(transaction: WriteTransaction):
  *   `@orkestrel/`. A child with an unreadable or unparsable `package.json`,
  *   or a non-`@orkestrel` name, is skipped silently — it simply is not a
  *   fleet member.
+ * @throws `ScaffoldError('TARGET', …)` when a child directory name contains
+ *   terminal controls and therefore cannot be safely inspected or reported.
  *
  * @example
  * ```ts

package/dist/src/server/index.js

@@ -1,4 +1,4 @@
-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, SYNC_BASELINE_PATTERN, ScaffoldError, VERSION_PATTERN, blueprint, bytesToHex, contentByteLength, devDependenciesFor, diffPlan, findFileConflict, findPathConflict, hasOnlyDataProperties, hasValidAuditBytes, hasValidSnapshotBytes, isDenseDataArray, isDependency, isEmitterErrorHandler, isPlan, isSyncReport, isWorkspaceName, manifestToDependencies, ownDataValue, parsePlan, parseSyncReport, rangeToFreshness, snapshotPlan, validateDependencyArray, validatePlan } from "../core/index.js";
+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, 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";
@@ -1747,8 +1747,8 @@ function selectOrkestrelEntries(value) {
 * dev-installed for local testing) is likewise excluded from `extras` — it
 * already appears as a `peer`/`dependency` above, and double-counting it as
 * an `extra` would land it in `peers ∩ extras`, a blocking `validateBlueprint`
-* gate. `overrides` is always `[]` — derivation cannot know a caller's
-* template-override intent.
+* gate. `overrides` is always `[]` — derivation cannot recover a caller's
+* artifact-override intent from repository state.
 * @returns The reconstructed `Blueprint`.
 * @throws `ScaffoldError('TARGET', …)` when `target`'s manifest is unreadable
 *   (via `readManifest`), is not valid JSON, its name is unsafe for its
@@ -2860,6 +2860,8 @@ function consumeCatalogAllowance(allowance, root) {
 *   `@orkestrel/`. A child with an unreadable or unparsable `package.json`,
 *   or a non-`@orkestrel` name, is skipped silently — it simply is not a
 *   fleet member.
+* @throws `ScaffoldError('TARGET', …)` when a child directory name contains
+*   terminal controls and therefore cannot be safely inspected or reported.
 *
 * @example
 * ```ts
@@ -2887,6 +2889,7 @@ function discoverPackages(root, allowance = new Float64Array([MAX_HOST_ENTRIES])
 			if (entry === null) break;
 			consumeCatalogAllowance(allowance, root);
 			if (!entry.isDirectory()) continue;
+			if (!isTerminalText(entry.name)) throw new ScaffoldError("TARGET", "Fleet discovery found a non-portable directory");
 			const directory = join(root, entry.name);
 			const text = attempt(() => readFileText(directory, "package.json", "TARGET", "package", MAX_MANIFEST_BYTES));
 			if (!text.success) continue;
@@ -3601,12 +3604,15 @@ var Sync = class Sync {
 	}
 	async pull(target, dependencies) {
 		this.#ensureAlive();
-		const declared = manifestToDependencies(readManifest(target));
+		const manifest = readManifest(target);
+		const declared = manifestToDependencies(manifest);
 		const deps = dependencies === void 0 ? declared : parseSyncDependencies(dependencies, false);
 		if (dependencies !== void 0 && deps.some((dependency) => !declared.some((candidate) => candidate.name === dependency.name && candidate.range === dependency.range))) throw new ScaffoldError("INVALID", "Sync pull selection is not declared by the target");
-		const current = readGuideReferences(target, deps);
+		const name = manifestToName(manifest);
+		const guideDependencies = name === void 0 ? deps : deps.filter((dependency) => dependency.name !== name);
+		const current = readGuideReferences(target, guideDependencies);
 		const allowance = Float64Array.of(this.#budget);
-		const report = syncReportOf(target, await this.#guides(deps, current, allowance), await this.#versions(deps, allowance));
+		const report = syncReportOf(target, await this.#guides(guideDependencies, current, allowance), await this.#versions(deps, allowance));
 		this.#emitter.emit("done", report);
 		return report;
 	}