@orkestrel/scaffold 0.0.16 → 0.0.18

package/dist/src/server/index.cjs

@@ -957,16 +957,16 @@ function packageShortName(name) {
 	return name.startsWith("@orkestrel/") ? name.slice(11) : name;
 }
 /**
-* Read bounded physical local guide mirrors for declared dependencies.
+* Read bounded physical local guide mirrors for package names.
 *
 * @param target - The package root.
-* @param dependencies - The declared dependencies whose mirrors are eligible.
-* @returns Existing guide content keyed by dependency name.
+* @param names - The package names whose mirrors are eligible.
+* @returns Existing guide content keyed by package name.
 */
-function readGuideReferences(target, dependencies) {
+function readGuideReferences(target, names) {
 	const current = {};
-	for (const dependency of dependencies) {
-		const path = `guides/src/${packageShortName(dependency.name)}.md`;
+	for (const name of names) {
+		const path = `guides/src/${packageShortName(name)}.md`;
 		const full = resolvePhysicalPath(target, path, "TARGET", "target");
 		const status = (0, _orkestrel_contract.attempt)(() => (0, node_fs.lstatSync)(full));
 		if (!status.success) {
@@ -977,7 +977,7 @@ function readGuideReferences(target, dependencies) {
 			});
 		}
 		if (!status.value.isFile() || status.value.isSymbolicLink() || status.value.nlink !== 1) throw new _src_core.ScaffoldError("TARGET", `Local guide is not a physical file at ${path}`, { path });
-		current[dependency.name] = readFileText(target, path, "TARGET", "target");
+		current[name] = readFileText(target, path, "TARGET", "target");
 	}
 	return Object.freeze(current);
 }
@@ -1022,11 +1022,11 @@ function syncReportOf(target, guides, versions) {
 * ```
 */
 function hostRoot() {
-	let dir = (0, node_path.dirname)((0, node_url.fileURLToPath)({}.url));
+	let dir = (0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
 	for (;;) {
 		if ((0, node_fs.existsSync)((0, node_path.join)(dir, "package.json"))) return (0, node_path.join)(dir, "dist", "host");
 		const parent = (0, node_path.dirname)(dir);
-		if (parent === dir) throw new _src_core.ScaffoldError("TARGET", "No package root found above the module location", { module: {}.url });
+		if (parent === dir) throw new _src_core.ScaffoldError("TARGET", "No package root found above the module location", { module: require("url").pathToFileURL(__filename).href });
 		dir = parent;
 	}
 }
@@ -3516,8 +3516,10 @@ var Materializer = class {
 * map, a fetched guide byte-equal to its entry verdicts `current`, anything
 * differing or absent from the map verdicts `behind`; WITHOUT the map, every
 * successful fetch verdicts `behind` (no reference means it needs syncing).
-* `pull` builds that map itself from the TARGET's own `guides/src/<short>.md`
-* mirrors, so its verdicts are target-relative; `write` commits only the
+* `pull` builds that map itself from the TARGET's declared dependency mirrors;
+* `mirror` builds it from the registry's exact organization package list,
+* excluding the target's own guide and issuing no registry version reads. Both
+* verdicts are target-relative; `write` commits only the
 * `behind` guides (never `current`, `missing`, or `failed`, which carries no
 * trustworthy content) under the same realpath-anchored containment law
 * `Materializer` enforces. After `destroy()` every method throws `DESTROYED`;
@@ -3575,29 +3577,30 @@ var Sync = class Sync {
 	}
 	async guides(deps, current) {
 		this.#ensureAlive();
-		return this.#guides(deps, current, Float64Array.of(this.#budget));
+		const parsed = parseSyncDependencies(deps, false);
+		return this.#guides(parsed.map((dependency) => dependency.name), current, Float64Array.of(this.#budget));
 	}
 	async versions(deps) {
 		this.#ensureAlive();
 		return this.#versions(deps, Float64Array.of(this.#budget));
 	}
-	#guides(deps, current, allowance) {
-		const parsed = parseSyncDependencies(deps, false);
+	#guides(names, current, allowance) {
+		const parsed = parseSyncNames(names);
 		if (parsed.length > this.#items) throw new _src_core.ScaffoldError("INVALID", "Sync dependency count exceeds its item limit", {
 			items: parsed.length,
 			limit: this.#items
 		});
-		const reference = parseSyncCurrent(current, parsed.map((dependency) => dependency.name), this.#budget);
-		return Sync.#runPool(parsed, this.#concurrency, async (dep) => {
-			const short = packageShortName(dep.name);
+		const reference = parseSyncCurrent(current, parsed, this.#budget);
+		return Sync.#runPool(parsed, this.#concurrency, async (name) => {
+			const short = packageShortName(name);
 			const url = this.#guideUrl(short);
 			const outcome = await Sync.#fetchText(url, this.#guidesTimeout, this.#retries, this.#limit, allowance, this.#controller.signal);
-			const guide = Sync.#toGuideSync(dep.name, short, outcome, reference);
+			const guide = Sync.#toGuideSync(name, short, outcome, reference);
 			if (outcome.kind === "failed") this.#emitter.emit("error", outcome.error);
-			this.#emitter.emit("guide", dep.name);
+			this.#emitter.emit("guide", name);
 			if (this.#strict && (guide.freshness === "missing" || guide.freshness === "failed")) throw new _src_core.ScaffoldError("FETCH", `Failed to fetch guide at ${url}`, {
 				url,
-				name: dep.name
+				name
 			});
 			return guide;
 		});
@@ -3661,16 +3664,9 @@ var Sync = class Sync {
 	*/
 	async catalog() {
 		this.#ensureAlive();
-		const orgUrl = this.#orgUrl();
 		const allowance = Float64Array.of(this.#budget);
-		const orgOutcome = await Sync.#fetchText(orgUrl, this.#registryTimeout, this.#retries, this.#limit, allowance, this.#controller.signal);
-		const names = Sync.#toOrgPackages(orgOutcome, orgUrl);
-		if (names.length > this.#items) throw new _src_core.ScaffoldError("FETCH", `Package list at ${orgUrl} exceeds the item limit`, {
-			url: orgUrl,
-			items: names.length,
-			limit: this.#items
-		});
-		return [...await Sync.#runPool(names, this.#concurrency, async (name) => {
+		const names = await this.#packages(allowance);
+		return await Sync.#runPool(names, this.#concurrency, async (name) => {
 			const packumentOutcome = await Sync.#fetchText(this.#registryUrl(name), this.#registryTimeout, this.#retries, this.#limit, allowance, this.#controller.signal);
 			const packument = Sync.#toPackument(packumentOutcome);
 			const short = packageShortName(name);
@@ -3686,7 +3682,7 @@ var Sync = class Sync {
 				version: packument.version,
 				description
 			};
-		})].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+		});
 	}
 	async pull(target, dependencies) {
 		this.#ensureAlive();
@@ -3695,10 +3691,21 @@ var Sync = class Sync {
 		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 _src_core.ScaffoldError("INVALID", "Sync pull selection is not declared by the target");
 		const name = (0, _src_core.manifestToName)(manifest);
-		const guideDependencies = name === void 0 ? deps : deps.filter((dependency) => dependency.name !== name);
-		const current = readGuideReferences(target, guideDependencies);
+		const guideNames = deps.map((dependency) => dependency.name).filter((dependency) => dependency !== name);
+		const current = readGuideReferences(target, guideNames);
 		const allowance = Float64Array.of(this.#budget);
-		const report = syncReportOf(target, await this.#guides(guideDependencies, current, allowance), await this.#versions(deps, allowance));
+		const report = syncReportOf(target, await this.#guides(guideNames, current, allowance), await this.#versions(deps, allowance));
+		this.#emitter.emit("done", report);
+		return report;
+	}
+	async mirror(target) {
+		this.#ensureAlive();
+		const manifest = readManifest(target);
+		const name = (0, _src_core.manifestToName)(manifest);
+		const allowance = Float64Array.of(this.#budget);
+		const names = (await this.#packages(allowance)).filter((candidate) => candidate !== name);
+		const current = readGuideReferences(target, names);
+		const report = syncReportOf(target, await this.#guides(names, current, allowance), []);
 		this.#emitter.emit("done", report);
 		return report;
 	}
@@ -3791,6 +3798,17 @@ var Sync = class Sync {
 	#orgUrl() {
 		return `${this.#registryBase}/-/org/orkestrel/package`;
 	}
+	async #packages(allowance) {
+		const url = this.#orgUrl();
+		const outcome = await Sync.#fetchText(url, this.#registryTimeout, this.#retries, this.#limit, allowance, this.#controller.signal);
+		const names = Sync.#toOrgPackages(outcome, url);
+		if (names.length > this.#items) throw new _src_core.ScaffoldError("FETCH", `Package list at ${url} exceeds the item limit`, {
+			url,
+			items: names.length,
+			limit: this.#items
+		});
+		return [...names].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+	}
 	static async #runPool(items, concurrency, worker) {
 		const results = new Array(items.length);
 		const state = {