@platforma-sdk/block-tools 2.11.2 → 2.11.4

package/dist/cli.mjs

@@ -1,391 +1,120 @@
-import { H as e, K as t, O as n, U as r, _ as i, _t as a, b as o, et as s, n as c, p as l, rt as ee } from "./config-DpfTzcgG.mjs";
-import { Args as u, Command as d, Flags as f } from "@oclif/core";
-import p from "node:path";
-import m from "node:fs";
+import { H as e, O as t, Q as n, Tt as r, W as i, Y as a, _ as o, b as s, n as c, p as l, q as u, st as d, ut as ee } from "./config-CiC347sB.mjs";
+import { Command as f, Option as p } from "commander";
+import m from "node:path";
+import h from "node:fs";
 import { BlockPackManifest as te, StableChannel as ne, overrideDescriptionVersion as re, overrideManifestVersion as ie } from "@milaboratories/pl-model-middle-layer";
-import { OclifLoggerAdapter as h } from "@milaboratories/ts-helpers-oclif";
+import { ConsoleLoggerAdapter as g } from "@milaboratories/ts-helpers";
 import ae, { parse as oe, parseDocument as se, stringify as ce } from "yaml";
 import { setTimeout as le } from "node:timers/promises";
 import { confirm as ue, input as de, select as fe } from "@inquirer/prompts";
 //#region src/cmd/build-meta.ts
-var pe = class e extends d {
-	static description = "Extracts meta information from blocks package.json and outputs meta.json with embedded binary and textual information linked from the meta section.";
-	static flags = {
-		modulePath: f.string({
-			char: "i",
-			summary: "input module path",
-			helpValue: "<path>",
-			default: "."
-		}),
-		destination: f.string({
-			char: "o",
-			summary: "output meta.json file",
-			helpValue: "<path>",
-			required: !0
-		})
-	};
-	async run() {
-		let { flags: t } = await this.parse(e), n = p.resolve(t.modulePath), i = await s(await ee((await r(n)).meta, n));
-		await m.promises.writeFile(p.resolve(t.destination), JSON.stringify(i));
-	}
-};
+function pe() {
+	let e = new f("build-meta").description("Extracts meta information from blocks package.json and outputs meta.json with embedded binary and textual information linked from the meta section.");
+	return e.option("-i, --modulePath <path>", "input module path", "."), e.requiredOption("-o, --destination <path>", "output meta.json file"), e.action(async (e) => {
+		let t = m.resolve(e.modulePath), n = await d(await ee((await a(t)).meta, t));
+		await h.promises.writeFile(m.resolve(e.destination), JSON.stringify(n));
+	}), e;
+}
 //#endregion
 //#region src/cmd/build-model.ts
 async function me(e) {
 	try {
-		return await m.promises.readFile(e, "utf8");
+		return await h.promises.readFile(e, "utf8");
 	} catch (e) {
 		if (e instanceof Error && "code" in e && e.code === "ENOENT") return;
 		throw e;
 	}
 }
-var he = class e extends d {
-	static description = "Extracts and outputs block model JSON from pre-built block model module";
-	static flags = {
-		modulePath: f.string({
-			char: "i",
-			summary: "input module path",
-			helpValue: "<path>",
-			default: "."
-		}),
-		sourceBundle: f.string({
-			char: "b",
-			summary: "bundled model code to embed into the model for callback-based rendering to work",
-			helpValue: "<path>",
-			default: "./dist/bundle.js"
-		}),
-		destination: f.string({
-			char: "o",
-			summary: "output model file",
-			helpValue: "<path>",
-			default: "./dist/model.json"
-		})
-	};
-	async run() {
-		let { flags: t } = await this.parse(e), { model: n, platforma: r } = a(p.resolve(t.modulePath));
-		if (n ||= r, !n) throw Error("\"model\" export not found");
-		let { config: i } = n;
+function he() {
+	let e = new f("build-model").description("Extracts and outputs block model JSON from pre-built block model module");
+	return e.option("-i, --modulePath <path>", "input module path", "."), e.option("-b, --sourceBundle <path>", "bundled model code to embed into the model for callback-based rendering to work", "./dist/bundle.js"), e.option("-o, --destination <path>", "output model file", "./dist/model.json"), e.action(async (e) => {
+		let { model: t, platforma: n } = r(m.resolve(e.modulePath));
+		if (t ||= n, !t) throw Error("\"model\" export not found");
+		let { config: i } = t;
 		if (!i) throw Error("Malformed \"model\" object, check it is created with \"BlockModel\" and \".done()\" is executed as the call in the chain.");
 		if (!("outputs" in i) || !("sections" in i)) throw Error("\"config\" has unexpected structure");
-		let o = await me(t.sourceBundle);
-		o !== void 0 && (i.code = {
+		let a = await me(e.sourceBundle);
+		a !== void 0 && (i.code = {
 			type: "plain",
-			content: o
-		}), await m.promises.writeFile(p.resolve(t.destination), JSON.stringify(i));
-	}
-}, ge = class e extends d {
-	static description = "List all available global overview snapshots in the registry";
-	static flags = {
-		registry: f.string({
-			char: "r",
-			summary: "full address of the registry",
-			helpValue: "<address>",
-			env: "PL_REGISTRY",
-			required: !0
-		}),
-		json: f.boolean({
-			summary: "output in JSON format",
-			default: !1
-		})
-	};
-	async run() {
-		let { flags: t } = await this.parse(e), n = await new o(i(t.registry), new h(this)).listGlobalOverviewSnapshots();
-		if (t.json) this.log(JSON.stringify(n, null, 2));
-		else if (n.length === 0) this.log("No snapshots found.");
-		else {
-			this.log(`Found ${n.length} snapshot(s):\n`);
-			for (let e of n) this.log(`  ${e.timestamp}`), this.log(`    Path: ${e.path}`), this.log("");
-		}
-	}
-}, _e = class e extends d {
-	static description = "Mark target block stable";
-	static flags = {
-		modulePath: f.string({
-			char: "i",
-			summary: "input module path",
-			helpValue: "<path>",
-			default: "."
-		}),
-		channel: f.string({
-			char: "c",
-			hidden: !0,
-			summary: "custom channel",
-			helpValue: "<channel name>",
-			default: ne
-		}),
-		"version-override": f.file({
-			char: "v",
-			summary: "override package version"
-		}),
-		registry: f.string({
-			char: "r",
-			summary: "full address of the registry",
-			helpValue: "<address>",
-			env: "PL_REGISTRY",
-			required: !0
-		}),
-		refresh: f.boolean({
-			summary: "refresh repository after adding the package",
-			default: !0,
-			allowNo: !0,
-			env: "PL_REGISTRY_REFRESH"
-		}),
-		unmark: f.boolean({
-			summary: "reverses meaning of this command, flag can be used to remove \"stable\" flag from the package",
-			default: !1
-		})
-	};
-	async run() {
-		let { flags: t } = await this.parse(e), n = await r(p.resolve(t.modulePath));
-		t["version-override"] && (n = re(n, t["version-override"]));
-		let a = new o(i(t.registry), new h(this));
-		t.unmark ? await a.removePackageFromChannel(n.id, t.channel) : await a.addPackageToChannel(n.id, t.channel), t.refresh && await a.updateIfNeeded();
-	}
-}, ve = class n extends d {
-	static description = "Builds block pack and outputs a block pack manifest consolidating all references assets into a single folder";
-	static flags = {
-		modulePath: f.string({
-			char: "i",
-			summary: "input module path",
-			helpValue: "<path>",
-			default: "."
-		}),
-		destinationPath: f.string({
-			char: "o",
-			summary: "output folder",
-			helpValue: "<path>",
-			default: "./block-pack"
-		})
-	};
-	async run() {
-		let { flags: r } = await this.parse(n);
-		await t(await e(p.resolve(r.modulePath)), p.resolve(r.destinationPath));
-	}
-};
+			content: a
+		}), await h.promises.writeFile(m.resolve(e.destination), JSON.stringify(i));
+	}), e;
+}
+//#endregion
+//#region src/cmd/pack.ts
+function ge() {
+	let e = new f("pack").description("Builds block pack and outputs a block pack manifest consolidating all references assets into a single folder");
+	return e.option("-i, --modulePath <path>", "input module path", "."), e.option("-o, --destinationPath <path>", "output folder", "./block-pack"), e.action(async (e) => {
+		await n(await u(m.resolve(e.modulePath)), m.resolve(e.destinationPath));
+	}), e;
+}
 //#endregion
 //#region src/cmd/publish.ts
-function ye(e, t) {
+function _e(e, t) {
 	let n = { ...e };
-	for (let e in t) t[e] && typeof t[e] == "object" && !Array.isArray(t[e]) && n[e] && typeof n[e] == "object" && !Array.isArray(n[e]) ? n[e] = ye(n[e], t[e]) : n[e] = t[e];
+	for (let e in t) t[e] && typeof t[e] == "object" && !Array.isArray(t[e]) && n[e] && typeof n[e] == "object" && !Array.isArray(n[e]) ? n[e] = _e(n[e], t[e]) : n[e] = t[e];
 	return n;
 }
-var be = class e extends d {
-	static description = "Publishes the block package and refreshes the registry (for v2 block-pack schema)";
-	static flags = {
-		registry: f.string({
-			char: "r",
-			summary: "full address of the registry",
-			helpValue: "<address>",
-			env: "PL_REGISTRY",
-			required: !0
-		}),
-		manifest: f.file({
-			char: "m",
-			summary: "manifest file path",
-			exists: !0,
-			default: `./block-pack/${n}`
-		}),
-		"version-override": f.file({
-			char: "v",
-			summary: "override package version"
-		}),
-		refresh: f.boolean({
-			summary: "refresh repository after adding the package",
-			default: !0,
-			allowNo: !0,
-			env: "PL_REGISTRY_REFRESH"
-		}),
-		unstable: f.boolean({
-			summary: "do not add the published package to stable channel",
-			default: !1,
-			env: "PL_PUBLISH_UNSTABLE"
-		})
-	};
-	async run() {
-		let { flags: t } = await this.parse(e), n = p.resolve(t.manifest), r = JSON.parse(await m.promises.readFile(n, { encoding: "utf-8" })), a = te.parse(r);
-		a = ye(r, a);
-		let s = p.dirname(n);
-		this.log(`Manifest root = ${s}`), t["version-override"] && (a = ie(a, t["version-override"]));
-		let c = new o(i(t.registry), new h(this));
-		await c.publishPackage(a, async (e) => Buffer.from(await m.promises.readFile(p.resolve(s, e)))), t.unstable || (this.log(`Adding package to ${ne} channel...`), await c.addPackageToChannel(a.description.id, ne)), t.refresh && await c.updateIfNeeded();
-	}
-}, xe = class e extends d {
-	static description = "Refresh overview files based on published but not proecessed artefacts";
-	static flags = {
-		registry: f.string({
-			char: "r",
-			summary: "full address of the registry",
-			helpValue: "<address>",
-			env: "PL_REGISTRY",
-			required: !0
-		}),
-		mode: f.string({
-			char: "m",
-			summary: "refresh mode (allowed valiues: \"force\", \"normal\", \"dry-run\")",
-			helpValue: "<mode>",
-			options: [
-				"force",
-				"normal",
-				"dry-run"
-			],
-			env: "PL_REGISTRY_REFRESH_DRY_RUN",
-			default: "normal"
-		})
-	};
-	async run() {
-		let { flags: t } = await this.parse(e);
-		await new o(i(t.registry), new h(this)).updateIfNeeded(t.mode);
-	}
-}, Se = class e extends d {
-	static description = "Restore global overview from a snapshot";
-	static flags = {
-		registry: f.string({
-			char: "r",
-			summary: "full address of the registry",
-			helpValue: "<address>",
-			env: "PL_REGISTRY",
-			required: !0
-		}),
-		snapshot: f.string({
-			char: "s",
-			summary: "snapshot timestamp ID to restore from",
-			helpValue: "<timestamp>",
-			required: !0
-		}),
-		"skip-confirmation": f.boolean({
-			summary: "skip confirmation prompt (use with caution)",
-			default: !1
-		})
-	};
-	async run() {
-		let { flags: t } = await this.parse(e), n = new o(i(t.registry), new h(this)), r = await n.listGlobalOverviewSnapshots();
-		if (r.find((e) => e.timestamp === t.snapshot) || this.error(`Snapshot '${t.snapshot}' not found. Available snapshots:\n${r.map((e) => `  - ${e.timestamp}`).join("\n") || "  (none)"}`), !t["skip-confirmation"]) {
-			let e = (await import("node:readline")).createInterface({
-				input: process.stdin,
-				output: process.stdout
-			}), n = await new Promise((n) => {
-				e.question(`⚠️  This will overwrite the current global overview with snapshot '${t.snapshot}'.\nAre you sure you want to continue? (y/N): `, n);
-			});
-			if (e.close(), n.toLowerCase() !== "y" && n.toLowerCase() !== "yes") {
-				this.log("Restore cancelled.");
-				return;
-			}
-		}
-		try {
-			await n.restoreGlobalOverviewFromSnapshot(t.snapshot), this.log(`✅ Successfully restored global overview from snapshot '${t.snapshot}'`);
-		} catch (e) {
-			this.error(`Failed to restore from snapshot: ${String(e)}`);
-		}
-	}
-}, Ce = class extends d {
-	static description = "[DEPRECATED] Use `block-tools structure refresh --update-deps-only`. This alias delegates to it.";
-	static examples = ["<%= config.bin %> <%= command.id %>"];
-	async run() {
-		this.warn("`block-tools update-deps` is deprecated and will be removed in a future release. Use `block-tools structure refresh --update-deps-only` instead. Delegating now."), await this.config.runCommand("structure:refresh", ["--update-deps-only"]);
-	}
-};
+function ve() {
+	let n = new f("publish").description("Publishes the block package and refreshes the registry (for v2 block-pack schema)");
+	return n.addOption(new p("-r, --registry <address>", "full address of the registry").env("PL_REGISTRY").makeOptionMandatory()), n.addOption(new p("--registry-serve-url <url>", "CDN serve URL written into block-pack/published.json (npm-consumed blocks)").env("PL_REGISTRY_SERVE_URL").makeOptionMandatory()), n.option("-m, --manifest <path>", "manifest file path", `./block-pack/${t}`), n.option("-v, --version-override <path>", "override package version"), n.addOption(new p("--refresh", "refresh repository after adding the package").default(!0).env("PL_REGISTRY_REFRESH")), n.option("--no-refresh", "do not refresh repository after adding the package"), n.addOption(new p("--unstable", "do not add the published package to stable channel").default(!1).env("PL_PUBLISH_UNSTABLE")), n.action(async (t) => {
+		let n = new g(), r = m.resolve(t.manifest), a = JSON.parse(await h.promises.readFile(r, { encoding: "utf-8" })), c = te.parse(a);
+		c = _e(a, c);
+		let l = m.dirname(r);
+		n.info(`Manifest root = ${l}`), t.versionOverride && (c = ie(c, t.versionOverride));
+		let u = new s(o(t.registry), n);
+		await u.publishPackage(c, async (e) => Buffer.from(await h.promises.readFile(m.resolve(l, e)))), t.unstable || (n.info(`Adding package to ${ne} channel...`), await u.addPackageToChannel(c.description.id, ne)), await i(l, e({
+			registryUrl: t.registryServeUrl,
+			id: c.description.id
+		})), n.info(`Wrote published coordinates to ${m.resolve(l, "published.json")}`), t.refresh && await u.updateIfNeeded();
+	}), n;
+}
 //#endregion
-//#region src/registry_v1/flags.ts
-function we(e) {
-	let t = e.match(/(?<destName>[^/\\]+)=(?<src>.*)/);
-	if (t) {
-		let { src: e, destName: n } = t.groups;
-		return {
-			src: e,
-			destName: n
-		};
-	} else return {
-		src: e,
-		destName: p.basename(e)
-	};
+//#region src/cmd/refresh-registry.ts
+function ye() {
+	let e = new f("refresh-registry").description("Refresh overview files based on published but not proecessed artefacts");
+	return e.addOption(new p("-r, --registry <address>", "full address of the registry").env("PL_REGISTRY").makeOptionMandatory()), e.addOption(new p("-m, --mode <mode>", "refresh mode (allowed valiues: \"force\", \"normal\", \"dry-run\")").choices([
+		"force",
+		"normal",
+		"dry-run"
+	]).env("PL_REGISTRY_REFRESH_DRY_RUN").default("normal")), e.action(async (e) => {
+		await new s(o(e.registry), new g()).updateIfNeeded(e.mode);
+	}), e;
 }
-var Te = f.custom({
-	summary: "target files to upload",
-	helpValue: "file_path | package_name=file_path",
-	parse: async (e) => we(e)
-}), Ee = [
-	"registry",
-	"organization",
-	"package",
-	"version"
-], De = class e extends d {
-	static description = "Uploads V1 package and refreshes the registry";
-	static flags = {
-		registry: f.string({
-			char: "r",
-			summary: "full address of the registry or alias from .pl.reg",
-			helpValue: "<address|alias>",
-			env: "PL_REGISTRY"
-		}),
-		organization: f.string({
-			char: "o",
-			summary: "target organisation",
-			env: "PL_PACKAGE_ORGANIZATION"
-		}),
-		package: f.string({
-			char: "p",
-			summary: "target package",
-			env: "PL_PACKAGE_NAME"
-		}),
-		version: f.string({
-			char: "v",
-			summary: "target version",
-			env: "PL_PACKAGE_VERSION"
-		}),
-		meta: f.file({
-			char: "m",
-			summary: "json file containing meta information to associate with tha package",
-			exists: !0
-		}),
-		file: Te({
-			char: "f",
-			summary: "package files",
-			multiple: !0,
-			default: []
-		}),
-		refresh: f.boolean({
-			summary: "refresh repository after adding the package",
-			default: !0,
-			allowNo: !0,
-			env: "PL_REGISTRY_REFRESH"
-		})
-	};
-	async run() {
-		let { flags: t } = await this.parse(e), n = l.parse({});
-		for (let e of Ee) t[e] && (n[e] = t[e]);
-		t.meta && (t.meta.endsWith(".json") ? n.meta = JSON.parse(await m.promises.readFile(t.meta, { encoding: "utf-8" })) : t.meta.endsWith(".yaml") && (n.meta = ae.parse(await m.promises.readFile(t.meta, { encoding: "utf-8" }))));
-		for (let e of t.file) n.files[e.destName] = e.src;
-		let r = await c(n);
-		this.log(ae.stringify(r.conf));
-		let i = r.createRegistry(new h(this)), a = r.fullPackageName, o = i.constructNewPackage(a);
-		for (let [e, t] of Object.entries(r.conf.files)) {
-			this.log(`Uploading ${t} -> ${e} ...`);
-			let n = await m.promises.readFile(t);
-			await o.addFile(e, n);
-		}
-		this.log("Uploading meta information..."), await o.writeMeta(r.conf.meta), await o.finish(), t.refresh && await i.updateIfNeeded();
-	}
-}, Oe = class {
+//#endregion
+//#region src/cmd/mark-stable.ts
+function be() {
+	let e = new f("mark-stable").description("Mark target block stable");
+	return e.option("-i, --modulePath <path>", "input module path", "."), e.addOption(new p("-c, --channel <channel name>", "custom channel").default(ne).hideHelp()), e.option("-v, --version-override <path>", "override package version"), e.addOption(new p("-r, --registry <address>", "full address of the registry").env("PL_REGISTRY").makeOptionMandatory()), e.addOption(new p("--refresh", "refresh repository after adding the package").default(!0).env("PL_REGISTRY_REFRESH")), e.option("--no-refresh", "do not refresh repository after adding the package"), e.option("--unmark", "reverses meaning of this command, flag can be used to remove \"stable\" flag from the package", !1), e.action(async (e) => {
+		let t = await a(m.resolve(e.modulePath));
+		e.versionOverride && (t = re(t, e.versionOverride));
+		let n = new s(o(e.registry), new g());
+		e.unmark ? await n.removePackageFromChannel(t.id, e.channel) : await n.addPackageToChannel(t.id, e.channel), e.refresh && await n.updateIfNeeded();
+	}), e;
+}
+//#endregion
+//#region src/structure/engine/fs/node.ts
+var xe = class {
 	constructor(e) {
 		this.root = e;
 	}
 	abs(e) {
-		return p.resolve(this.root, e);
+		return m.resolve(this.root, e);
 	}
 	read(e) {
-		return m.readFileSync(this.abs(e), "utf-8");
+		return h.readFileSync(this.abs(e), "utf-8");
 	}
 	write(e, t) {
 		let n = this.abs(e);
-		m.mkdirSync(p.dirname(n), { recursive: !0 }), m.writeFileSync(n, t, "utf-8");
+		h.mkdirSync(m.dirname(n), { recursive: !0 }), h.writeFileSync(n, t, "utf-8");
 	}
 	writeBinary(e, t) {
 		let n = this.abs(e);
-		m.mkdirSync(p.dirname(n), { recursive: !0 }), m.writeFileSync(n, t);
+		h.mkdirSync(m.dirname(n), { recursive: !0 }), h.writeFileSync(n, t);
 	}
 	exists(e) {
 		try {
-			return m.statSync(this.abs(e)), !0;
+			return h.statSync(this.abs(e)), !0;
 		} catch {
 			return !1;
 		}
@@ -393,15 +122,15 @@ var Te = f.custom({
 	list(e) {
 		let t = this.abs(e);
 		try {
-			if (!m.statSync(t).isDirectory()) return [];
+			if (!h.statSync(t).isDirectory()) return [];
 		} catch {
 			return [];
 		}
 		let n = [];
 		function r(e, t) {
-			let i = m.readdirSync(t, { withFileTypes: !0 });
+			let i = h.readdirSync(t, { withFileTypes: !0 });
 			for (let a of i) {
-				let i = e ? `${e}/${a.name}` : a.name, o = p.join(t, a.name);
+				let i = e ? `${e}/${a.name}` : a.name, o = m.join(t, a.name);
 				a.isDirectory() ? r(i, o) : a.isFile() && n.push(i);
 			}
 		}
@@ -410,7 +139,7 @@ var Te = f.custom({
 	listDir(e) {
 		let t = this.abs(e), n;
 		try {
-			n = m.readdirSync(t, { withFileTypes: !0 });
+			n = h.readdirSync(t, { withFileTypes: !0 });
 		} catch {
 			return [];
 		}
@@ -421,48 +150,48 @@ var Te = f.custom({
 	}
 	move(e, t) {
 		let n = this.abs(e), r = this.abs(t);
-		m.mkdirSync(p.dirname(r), { recursive: !0 }), m.renameSync(n, r);
+		h.mkdirSync(m.dirname(r), { recursive: !0 }), h.renameSync(n, r);
 	}
 	delete(e) {
-		m.rmSync(this.abs(e), {
+		h.rmSync(this.abs(e), {
 			recursive: !0,
 			force: !0
 		});
 	}
-}, ke = class {
+}, Se = class {
 	constructor(e) {
 		this.root = e;
 	}
 	staticRead(e) {
-		return m.readFileSync(p.resolve(this.root, "static", e), "utf-8");
+		return h.readFileSync(m.resolve(this.root, "static", e), "utf-8");
 	}
 	staticReadBinary(e) {
-		return m.readFileSync(p.resolve(this.root, "static", e));
+		return h.readFileSync(m.resolve(this.root, "static", e));
 	}
 	textRead(e) {
-		return m.readFileSync(p.resolve(this.root, "text", e), "utf-8");
+		return h.readFileSync(m.resolve(this.root, "text", e), "utf-8");
 	}
 };
-function Ae(e, t) {
+function Ce(e, t) {
 	return e.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (e, n) => t[n] ?? `\${${n}}`);
 }
 //#endregion
 //#region src/structure/engine/flatten.ts
-var je = ["default", "init"];
-function Me(e, t) {
+var we = ["default", "init"];
+function Te(e, t) {
 	if (!e) return t;
 	if (!t) return e;
 	let n = e.endsWith("/") ? e.slice(0, -1) : e, r = t.startsWith("/") ? t.slice(1) : t;
 	return r ? `${n}/${r}` : n;
 }
-function Ne(e, t) {
+function Ee(e, t) {
 	return e.filter((e) => e.scope === t).slice().sort((e, t) => e.path.localeCompare(t.path));
 }
-function Pe(e, t) {
+function De(e, t) {
 	let n = [];
 	function r(e, i, a, o, s) {
 		if (e.kind === "scope") {
-			let n = Ne(t.modules, e.scope);
+			let n = Ee(t.modules, e.scope);
 			for (let t of n) for (let n of e.children) r(n, e.scope, t.path, o, s);
 			return;
 		}
@@ -475,14 +204,14 @@ function Pe(e, t) {
 			for (let t of e.children) r(t, i, a, o, e.modes);
 			return;
 		}
-		if (i === void 0 || a === void 0) throw Error(`flatten: leaf '${Ie(e)}' is not inside a scope() frame`);
+		if (i === void 0 || a === void 0) throw Error(`flatten: leaf '${ke(e)}' is not inside a scope() frame`);
 		if (e.kind === "rename") {
 			n.push({
 				leaf: e,
 				scope: i,
 				modulePath: a,
-				resolvedPath: Me(a, e.from),
-				resolvedTo: Me(a, e.to),
+				resolvedPath: Te(a, e.from),
+				resolvedTo: Te(a, e.to),
 				triggers: o,
 				modes: s
 			});
@@ -492,15 +221,15 @@ function Pe(e, t) {
 			leaf: e,
 			scope: i,
 			modulePath: a,
-			resolvedPath: Me(a, Fe(e)),
+			resolvedPath: Te(a, Oe(e)),
 			triggers: o,
 			modes: s
 		});
 	}
-	for (let t of e.children) r(t, void 0, void 0, [], je);
+	for (let t of e.children) r(t, void 0, void 0, [], we);
 	return n;
 }
-function Fe(e) {
+function Oe(e) {
 	switch (e.kind) {
 		case "fixed":
 		case "managed":
@@ -510,63 +239,63 @@ function Fe(e) {
 		case "rename": return e.from;
 	}
 }
-function Ie(e) {
+function ke(e) {
 	return e.kind === "rename" ? `rename ${e.from} -> ${e.to}` : `${e.kind} ${e.path}`;
 }
 //#endregion
 //#region src/structure/engine/glob.ts
-var Le = /[.+^${}()|[\]\\]/g;
-function Re(e) {
+var Ae = /[.+^${}()|[\]\\]/g;
+function je(e) {
 	let t = "";
 	for (let n = 0; n < e.length; n++) {
 		let r = e[n];
-		r === "*" ? e[n + 1] === "*" ? (n++, e[n + 1] === "/" ? (n++, t += "(?:.*/)?") : t += ".*") : t += "[^/]*" : r === "?" ? t += "[^/]" : t += r.replace(Le, "\\$&");
+		r === "*" ? e[n + 1] === "*" ? (n++, e[n + 1] === "/" ? (n++, t += "(?:.*/)?") : t += ".*") : t += "[^/]*" : r === "?" ? t += "[^/]" : t += r.replace(Ae, "\\$&");
 	}
 	return RegExp(`^${t}$`);
 }
-function ze(e, t) {
-	return Re(e).test(t);
+function Me(e, t) {
+	return je(e).test(t);
 }
 //#endregion
 //#region src/structure/engine/builders.ts
-var g, _;
-function Be(e) {
-	if (!g) throw Error(`${e}() called outside defineStructure(). Builders must run inside the lambda passed to defineStructure(...).`);
-	return g;
+var _, v;
+function Ne(e) {
+	if (!_) throw Error(`${e}() called outside defineStructure(). Builders must run inside the lambda passed to defineStructure(...).`);
+	return _;
 }
-function v(e, t) {
-	let n = Be(e);
+function y(e, t) {
+	let n = Ne(e);
 	n.stack[n.stack.length - 1].push(t);
 }
-function Ve(e, t) {
-	let n = _;
-	_ = e;
+function Pe(e, t) {
+	let n = v;
+	v = e;
 	try {
 		return t();
 	} finally {
-		_ = n;
+		v = n;
 	}
 }
-function He() {
-	return _;
+function Fe() {
+	return v;
 }
-function Ue(e) {
-	if (g) throw Error("defineStructure() cannot be called from inside another defineStructure().");
+function Ie(e) {
+	if (_) throw Error("defineStructure() cannot be called from inside another defineStructure().");
 	let t = [], n = {
 		root: t,
 		stack: [t],
 		inScope: !1
 	};
-	g = n;
+	_ = n;
 	try {
 		if (e(), n.stack.length !== 1) throw Error(`defineStructure: builder body left ${n.stack.length - 1} unclosed group frame(s)`);
 		let r = { children: t };
-		return We(r), r;
+		return Le(r), r;
 	} finally {
-		g = void 0;
+		_ = void 0;
 	}
 }
-function We(e) {
+function Le(e) {
 	let t = /* @__PURE__ */ new Map();
 	function n(e, r) {
 		if (e.kind === "scope") {
@@ -589,8 +318,8 @@ function We(e) {
 		throw Error(`defineStructure validation: path '${t}' under scope '${e}' is declared as both seed and ${n}. Seeds are block-author territory (written once at init, untouched thereafter); engine-managed primitives (fixed/managed/scaffold) rewrite on every refresh. The two contracts cannot coexist on the same path.`);
 	}
 }
-function y(e, t) {
-	let n = Be("scope");
+function b(e, t) {
+	let n = Ne("scope");
 	if (n.inScope) throw Error("scope() cannot nest. Already inside a scope.");
 	let r = {
 		kind: "scope",
@@ -604,22 +333,22 @@ function y(e, t) {
 		n.stack.pop(), n.inScope = !1;
 	}
 }
-var Ge;
-function Ke(e) {
-	Ge = e;
+var Re;
+function ze(e) {
+	Re = e;
 }
-function b(e, t, n) {
-	qe(e, t), n && qe((t) => !e(t), n);
+function x(e, t, n) {
+	Be(e, t), n && Be((t) => !e(t), n);
 }
-function qe(e, t) {
-	if (g) {
-		Je(e, t);
+function Be(e, t) {
+	if (_) {
+		Ve(e, t);
 		return;
 	}
-	if (!(Ge?.(e, t) ?? !1)) throw Error("when() called outside defineStructure() and outside any managed(...) body. Place this call inside one of the two.");
+	if (!(Re?.(e, t) ?? !1)) throw Error("when() called outside defineStructure() and outside any managed(...) body. Place this call inside one of the two.");
 }
-function Je(e, t) {
-	let n = g, r = {
+function Ve(e, t) {
+	let n = _, r = {
 		kind: "when",
 		trigger: e,
 		children: []
@@ -631,11 +360,11 @@ function Je(e, t) {
 		n.stack.pop();
 	}
 }
-function x(e) {
+function S(e) {
 	return (t) => t.filesMatch(e);
 }
-function Ye(e, t, n) {
-	let r = Be(e), i = {
+function He(e, t, n) {
+	let r = Ne(e), i = {
 		kind: "mode",
 		modes: t,
 		children: []
@@ -647,70 +376,70 @@ function Ye(e, t, n) {
 		r.stack.pop();
 	}
 }
-function Xe(e) {
-	Ye("onInitOrUpdate", ["init", "updateDeps"], e);
+function Ue(e) {
+	He("onInitOrUpdate", ["init", "updateDeps"], e);
 }
-function S(e, t) {
-	v("fixed", {
+function C(e, t) {
+	y("fixed", {
 		kind: "fixed",
 		path: e,
 		content: t
 	});
 }
-function C(e, t, n) {
-	v("managed", {
+function w(e, t, n) {
+	y("managed", {
 		kind: "managed",
 		path: e,
 		initial: t,
 		body: n
 	});
 }
-function Ze(e, t) {
-	v("scaffold", {
+function T(e, t) {
+	y("scaffold", {
 		kind: "scaffold",
 		path: e,
 		initial: t
 	});
 }
-function w(e, t) {
-	v("seed", {
+function E(e, t) {
+	y("seed", {
 		kind: "seed",
 		path: e,
 		initial: t
 	});
 }
-function T(e) {
-	v("remove", {
+function D(e) {
+	y("remove", {
 		kind: "remove",
 		path: e
 	});
 }
-function E(e) {
+function O(e) {
 	return {
 		kind: "file",
 		path: e
 	};
 }
-function Qe(e) {
+function We(e) {
 	return {
 		kind: "binary",
 		path: e
 	};
 }
-function $e(e) {
+function Ge(e) {
 	return {
 		kind: "text",
 		value: e
 	};
 }
-function D(e, t) {
+function k(e, t) {
 	return {
 		kind: "tpl",
 		path: e,
 		vars: t
 	};
 }
-function O(e) {
+function A(e) {
 	return {
 		kind: "generate",
 		fn: e
@@ -718,69 +447,69 @@ function O(e) {
 }
 //#endregion
 //#region src/structure/engine/parsers/json.ts
-function et(e) {
+function Ke(e) {
 	return JSON.parse(e);
 }
-var tt = 100, nt = 2;
-function rt(e) {
-	return e.length === 0 ? "[]" : "[" + e.map(it).join(", ") + "]";
+var qe = 100, Je = 2;
+function Ye(e) {
+	return e.length === 0 ? "[]" : "[" + e.map(Xe).join(", ") + "]";
 }
-function it(e) {
-	if (Array.isArray(e)) return rt(e);
-	if (A(e)) {
+function Xe(e) {
+	if (Array.isArray(e)) return Ye(e);
+	if (M(e)) {
 		let t = Object.entries(e);
-		return t.length === 0 ? "{}" : "{ " + t.map(([e, t]) => `${JSON.stringify(e)}: ${it(t)}`).join(", ") + " }";
+		return t.length === 0 ? "{}" : "{ " + t.map(([e, t]) => `${JSON.stringify(e)}: ${Xe(t)}`).join(", ") + " }";
 	}
 	return JSON.stringify(e);
 }
-function at(e, t, n, r) {
-	let i = t + nt, a = " ".repeat(i);
+function Ze(e, t, n, r) {
+	let i = t + Je, a = " ".repeat(i);
 	if (Array.isArray(e)) {
-		let o = rt(e);
-		if (n + o.length + r <= tt) return o;
+		let o = Ye(e);
+		if (n + o.length + r <= qe) return o;
 		let s = e.length - 1;
-		return "[\n" + e.map((e, t) => a + at(e, i, i, t === s ? 0 : 1)).join(",\n") + "\n" + " ".repeat(t) + "]";
+		return "[\n" + e.map((e, t) => a + Ze(e, i, i, t === s ? 0 : 1)).join(",\n") + "\n" + " ".repeat(t) + "]";
 	}
-	if (A(e)) {
+	if (M(e)) {
 		let n = Object.entries(e);
 		if (n.length === 0) return "{}";
 		let r = n.length - 1;
 		return "{\n" + n.map(([e, t], n) => {
 			let o = `${a}${JSON.stringify(e)}: `;
-			return o + at(t, i, o.length, n === r ? 0 : 1);
+			return o + Ze(t, i, o.length, n === r ? 0 : 1);
 		}).join(",\n") + "\n" + " ".repeat(t) + "}";
 	}
 	return JSON.stringify(e);
 }
-function ot(e, t) {
-	return t?.collapse ? at(JSON.parse(JSON.stringify(e ?? null)), 0, 0, 0) + "\n" : JSON.stringify(e, null, 2) + "\n";
+function Qe(e, t) {
+	return t?.collapse ? Ze(JSON.parse(JSON.stringify(e ?? null)), 0, 0, 0) + "\n" : JSON.stringify(e, null, 2) + "\n";
 }
-function k(e) {
+function j(e) {
 	return e === "" || e === void 0 ? [] : e.split(".");
 }
-function A(e) {
+function M(e) {
 	return typeof e == "object" && !!e && !Array.isArray(e);
 }
-function st(e, t) {
-	let n = k(t), r = e;
+function $e(e, t) {
+	let n = j(t), r = e;
 	for (let e of n) {
-		if (!A(r)) return;
+		if (!M(r)) return;
 		r = r[e];
 	}
 	return r;
 }
-function ct(e, t) {
-	let n = k(t);
+function et(e, t) {
+	let n = j(t);
 	if (n.length === 0) return !0;
 	let r = e;
 	for (let e = 0; e < n.length - 1; e++) {
-		if (!A(r)) return !1;
+		if (!M(r)) return !1;
 		r = r[n[e]];
 	}
-	return A(r) ? n[n.length - 1] in r : !1;
+	return M(r) ? n[n.length - 1] in r : !1;
 }
-function lt(e, t, n) {
-	let r = k(t);
+function tt(e, t, n) {
+	let r = j(t);
 	if (r.length === 0) throw Error("setAtPath: jsonPath must be non-empty");
 	let i = e;
 	for (let e = 0; e < r.length - 1; e++) {
@@ -788,22 +517,22 @@ function lt(e, t, n) {
 		if (n === void 0) {
 			let e = {};
 			i[t] = e, i = e;
-		} else if (A(n)) i = n;
+		} else if (M(n)) i = n;
 		else throw Error(`setAtPath: cannot descend into non-object at '${r.slice(0, e + 1).join(".")}'`);
 	}
 	i[r[r.length - 1]] = n;
 }
-function ut(e, t) {
-	let n = k(t);
+function nt(e, t) {
+	let n = j(t);
 	if (n.length === 0) throw Error("deleteAtPath: jsonPath must be non-empty");
 	let r = e;
 	for (let e = 0; e < n.length - 1; e++) {
-		if (!A(r)) return;
+		if (!M(r)) return;
 		r = r[n[e]];
 	}
-	A(r) && delete r[n[n.length - 1]];
+	M(r) && delete r[n[n.length - 1]];
 }
-function dt(e, t) {
+function rt(e, t) {
 	let n = new Set(t), r = Object.keys(e), i = /* @__PURE__ */ new Map();
 	i.set("", []);
 	let a = "";
@@ -818,72 +547,72 @@ function dt(e, t) {
 }
 //#endregion
 //#region src/structure/engine/parsers/lines.ts
-function ft(e) {
+function it(e) {
 	let t = e.split("\n");
 	return t.length > 0 && t[t.length - 1] === "" && t.pop(), t;
 }
-function pt(e) {
+function at(e) {
 	return e.join("\n") + "\n";
 }
-function mt(e) {
+function ot(e) {
 	return e.replace(/(^|\s)#.*$/, "$1").trim();
 }
-function ht(e, t) {
-	let n = mt(e);
+function st(e, t) {
+	let n = ot(e);
 	return n === "" ? !1 : n === t.trim();
 }
-function gt(e, t) {
-	for (let n of e) if (ht(n, t)) return !0;
+function ct(e, t) {
+	for (let n of e) if (st(n, t)) return !0;
 	return !1;
 }
 //#endregion
 //#region src/structure/engine/content-rules.ts
-function _t(e, t) {
+function lt(e, t) {
 	return e === "sdk:" ? t ? "workspace:*" : "catalog:" : e;
 }
-var vt = [
+var ut = [
 	"dependencies",
 	"devDependencies",
 	"peerDependencies",
 	"optionalDependencies"
 ];
-function yt(e, t) {
-	if (P(e)) for (let n of vt) {
+function dt(e, t) {
+	if (I(e)) for (let n of ut) {
 		let r = e[n];
-		if (P(r)) for (let e of Object.keys(r)) r[e] === "sdk:" && (r[e] = t ? "workspace:*" : "catalog:");
+		if (I(r)) for (let e of Object.keys(r)) r[e] === "sdk:" && (r[e] = t ? "workspace:*" : "catalog:");
 	}
 }
-var j;
-function bt(e) {
-	if (!j) throw Error(`${e}() only valid inside a managed(...) body. Move this call inside managed(path, initial, () => {...}).`);
-	return j;
+var N;
+function ft(e) {
+	if (!N) throw Error(`${e}() only valid inside a managed(...) body. Move this call inside managed(path, initial, () => {...}).`);
+	return N;
 }
-function M(e) {
-	let t = bt(e);
+function P(e) {
+	let t = ft(e);
 	if (t.kind !== "json") throw Error(`${e}() requires a JSON-managed body; got '${t.kind}'.`);
 	return t;
 }
-function N(e) {
-	let t = bt(e);
+function F(e) {
+	let t = ft(e);
 	if (t.kind !== "yaml") throw Error(`${e}() requires a YAML-managed body; got '${t.kind}'.`);
 	return t;
 }
-function xt(e) {
-	let t = bt(e);
+function pt(e) {
+	let t = ft(e);
 	if (t.kind !== "lines") throw Error(`${e}() requires a lines-managed body; got '${t.kind}'.`);
 	return t;
 }
-function St(e, t) {
-	let n = e.ctx ?? He();
+function mt(e, t) {
+	let n = e.ctx ?? Fe();
 	if (!n) throw Error(`${t}() needs a RunContext but none is active. Pass { ctx } via the with-managed-* helper or run inside engine.run(...).`);
 	return n;
 }
-function P(e) {
+function I(e) {
 	return typeof e == "object" && !!e && !Array.isArray(e);
 }
-function Ct(e, t, n = {}) {
-	if (j) throw Error("Nested managed(...) body — engine bug.");
-	j = {
+function ht(e, t, n = {}) {
+	if (N) throw Error("Nested managed(...) body — engine bug.");
+	N = {
 		kind: "json",
 		obj: e,
 		ctx: n.ctx,
@@ -892,12 +621,12 @@ function Ct(e, t, n = {}) {
 	try {
 		return t(n.ctx ?? n.triggerContext?.ctx), e;
 	} finally {
-		j = void 0;
+		N = void 0;
 	}
 }
-function wt(e, t, n = {}) {
-	if (j) throw Error("Nested managed(...) body — engine bug.");
-	j = {
+function gt(e, t, n = {}) {
+	if (N) throw Error("Nested managed(...) body — engine bug.");
+	N = {
 		kind: "yaml",
 		doc: e,
 		ctx: n.ctx,
@@ -908,12 +637,12 @@ function wt(e, t, n = {}) {
 	try {
 		return t(n.ctx ?? n.triggerContext?.ctx), e;
 	} finally {
-		j = void 0;
+		N = void 0;
 	}
 }
-function Tt(e, t, n = {}) {
-	if (j) throw Error("Nested managed(...) body — engine bug.");
-	j = {
+function _t(e, t, n = {}) {
+	if (N) throw Error("Nested managed(...) body — engine bug.");
+	N = {
 		kind: "lines",
 		lines: e,
 		ctx: n.ctx,
@@ -922,163 +651,170 @@ function Tt(e, t, n = {}) {
 	try {
 		return t(n.ctx ?? n.triggerContext?.ctx), e;
 	} finally {
-		j = void 0;
+		N = void 0;
 	}
 }
-Ke((e, t) => {
-	if (!j) return !1;
-	let n = j.triggerContext;
+ze((e, t) => {
+	if (!N) return !1;
+	let n = N.triggerContext;
 	if (!n) throw Error("when() inside a managed(...) body requires a triggerContext. The runner supplies it via the `triggerContext` opt to with-managed-*; ensure your test/test helper passes one.");
 	return e(n) && t(), !0;
 });
-function F(e, t) {
-	lt(M("ensureField").obj, e, t);
+function L(e, t) {
+	tt(P("ensureField").obj, e, t);
 }
-function Et(e, t) {
-	let n = M("removeField").obj;
-	ct(n, e) && (t && !t(st(n, e)) || ut(n, e));
+function vt(e, t) {
+	let n = P("removeField").obj;
+	et(n, e) && (t && !t($e(n, e)) || nt(n, e));
 }
-function I(e, t) {
-	F(`scripts.${e}`, t);
+function yt(e, t) {
+	let n = P("requireField").obj;
+	if (!et(n, e)) throw Error(t ?? `requireField: missing field '${e}'`);
 }
-function L(e) {
-	Et(`scripts.${e}`);
+function R(e, t) {
+	L(`scripts.${e}`, t);
 }
-var Dt = [
+function z(e) {
+	vt(`scripts.${e}`);
+}
+var bt = [
 	"dependencies",
 	"devDependencies",
 	"peerDependencies",
 	"optionalDependencies"
 ];
-function R(e, t, n, r) {
-	let i = M(e), a = i.obj, o = n === "sdk:" ? _t(n, St(i, e).isSdkInternal) : n;
-	for (let e of Dt) {
+function B(e, t, n, r) {
+	let i = P(e), a = i.obj, o = n === "sdk:" ? lt(n, mt(i, e).isSdkInternal) : n;
+	for (let e of bt) {
 		if (e === r) continue;
 		let n = a[e];
-		P(n) && t in n && delete n[t];
+		I(n) && t in n && delete n[t];
 	}
-	let s = a[r], c = P(s) ? s : {};
-	c[t] = o, P(s) || (a[r] = c);
+	let s = a[r], c = I(s) ? s : {};
+	c[t] = o, I(s) || (a[r] = c);
 }
-function z(e, t) {
-	R("ensureDep", e, t, "dependencies");
+function V(e, t) {
+	B("ensureDep", e, t, "dependencies");
 }
-function B(e, t) {
-	R("ensureDevDep", e, t, "devDependencies");
+function H(e, t) {
+	B("ensureDevDep", e, t, "devDependencies");
 }
-function Ot(e, t) {
-	R("ensurePeerDep", e, t, "peerDependencies");
+function xt(e, t) {
+	B("ensurePeerDep", e, t, "peerDependencies");
 }
-function V(e) {
-	let t = M("removeDep").obj;
-	for (let n of Dt) {
+function U(e) {
+	let t = P("removeDep").obj;
+	for (let n of bt) {
 		let r = t[n];
-		P(r) && e in r && delete r[e];
+		I(r) && e in r && delete r[e];
 	}
 }
-function H(e) {
-	for (let [t, n] of Object.entries(e)) B(t, n);
+function W(e) {
+	for (let [t, n] of Object.entries(e)) H(t, n);
 }
-function U(e) {
-	for (let [t, n] of Object.entries(e)) Ot(t, n);
+function G(e) {
+	for (let [t, n] of Object.entries(e)) xt(t, n);
 }
-function kt(e, t, n) {
-	let r = St(M(e), e);
-	for (let i of r.modules) i.scope === t && R(e, i.name, "workspace:*", n);
+function St(e, t, n) {
+	let r = mt(P(e), e);
+	for (let i of r.modules) i.scope === t && B(e, i.name, "workspace:*", n);
 }
-function W(e) {
-	kt("ensureWorkspaceScopeDeps", e, "dependencies");
+function Ct(e) {
+	St("ensureWorkspaceScopeDeps", e, "dependencies");
 }
-function At(e) {
-	let t = M("pruneKeysMatching").obj;
+function wt(e) {
+	St("ensureWorkspaceScopeDevDeps", e, "devDependencies");
+}
+function Tt(e) {
+	let t = P("pruneKeysMatching").obj;
 	for (let n of Object.keys(t)) e(n, t[n]) && delete t[n];
 }
-function jt(e, t) {
-	let n = dt(e, t);
+function Et(e, t) {
+	let n = rt(e, t);
 	for (let t of Object.keys(e)) delete e[t];
 	for (let t of Object.keys(n)) e[t] = n[t];
 }
-function G(e) {
-	jt(M("enforceFieldOrder").obj, e);
+function K(e) {
+	Et(P("enforceFieldOrder").obj, e);
 }
-function Mt(e, t) {
+function Dt(e, t) {
 	let n = Object.keys(e).sort(), r = {};
 	for (let t of n) r[t] = e[t];
 	for (let t of Object.keys(e)) delete e[t];
-	for (let i of n) e[i] = r[i], t && P(e[i]) && Mt(e[i], !0);
+	for (let i of n) e[i] = r[i], t && I(e[i]) && Dt(e[i], !0);
 }
-function K(e = "", t = {}) {
+function q(e = "", t = {}) {
 	let n = t.recursive ?? !1;
 	if (e === "" && !n) return;
-	let r = M("enforceAlphabeticalOrder").obj;
+	let r = P("enforceAlphabeticalOrder").obj;
 	if (e === "") {
-		Mt(r, !0);
+		Dt(r, !0);
 		return;
 	}
-	let i = st(r, e);
-	P(i) && Mt(i, n);
+	let i = $e(r, e);
+	I(i) && Dt(i, n);
 }
-function Nt() {
-	let e = N("ensureWorkspaceModulePaths"), t = St(e, "ensureWorkspaceModulePaths").modules.filter((e) => e.path !== "").map((e) => e.path).sort(), n = e.doc.toJSON()?.packages;
+function Ot() {
+	let e = F("ensureWorkspaceModulePaths"), t = mt(e, "ensureWorkspaceModulePaths").modules.filter((e) => e.path !== "").map((e) => e.path).sort(), n = e.doc.toJSON()?.packages;
 	Array.isArray(n) && n.length === t.length && n.every((e, n) => e === t[n]) || e.doc.setIn(["packages"], t);
 }
-function Pt(e, t) {
+function kt(e, t) {
 	let n = e.doc.getIn(["catalog", t]);
 	return typeof n == "string" ? n : void 0;
 }
-function Ft(e, t) {
-	let n = N("ensureCatalogVersion");
-	Pt(n, e) === void 0 && n.doc.setIn(["catalog", e], t);
+function At(e, t) {
+	let n = F("ensureCatalogVersion");
+	kt(n, e) === void 0 && n.doc.setIn(["catalog", e], t);
 }
-function It(e) {
-	let t = N("ensureCatalogLatest");
+function jt(e) {
+	let t = F("ensureCatalogLatest");
 	if (!t.getLatestVersion) return;
 	let n = t.getLatestVersion(e);
-	n !== void 0 && Pt(t, e) !== n && t.doc.setIn(["catalog", e], n);
+	n !== void 0 && kt(t, e) !== n && t.doc.setIn(["catalog", e], n);
 }
-function Lt(e, t) {
-	let n = N("pinCatalogToDependencyOf");
+function Mt(e, t) {
+	let n = F("pinCatalogToDependencyOf");
 	if (!n.getDerivedDependencyPin) return;
 	let r = n.getDerivedDependencyPin(e);
-	r !== void 0 && Pt(n, e) !== r && n.doc.setIn(["catalog", e], r);
+	r !== void 0 && kt(n, e) !== r && n.doc.setIn(["catalog", e], r);
 }
-function Rt(e) {
-	let t = N("ensureCatalogAbsent");
+function Nt(e) {
+	let t = F("ensureCatalogAbsent");
 	t.doc.hasIn(["catalog", e]) && t.doc.deleteIn(["catalog", e]);
 }
-function zt(e) {
-	let t = xt("ensureGitignoreEntries");
-	for (let n of e) gt(t.lines, n) || t.lines.push(n);
+function Pt(e) {
+	let t = pt("ensureGitignoreEntries");
+	for (let n of e) ct(t.lines, n) || t.lines.push(n);
 }
 //#endregion
 //#region src/structure/engine/parsers/yaml.ts
-function Bt(e) {
+function Ft(e) {
 	return se(e);
 }
-function Vt(e) {
+function It(e) {
 	return e.toString();
 }
-var Ht = ".structure";
-function Ut(e, t = 0) {
-	if (e < t) throw new Wt(e, t);
+var Lt = ".structure";
+function Rt(e, t = 0) {
+	if (e < t) throw new zt(e, t);
 }
-var Wt = class extends Error {
+var zt = class extends Error {
 	constructor(e, t) {
 		super(`Block .structure version is ${e}, below floor ${t}. Bootstrap via the legacy-migration skill, then re-run.`), this.version = e, this.floor = t, this.name = "StructureVersionFloorError";
 	}
 };
-function Gt(e, t = 1) {
+function Bt(e, t = 1) {
 	let n = { version: t };
-	e.write(Ht, JSON.stringify(n));
+	e.write(Lt, JSON.stringify(n));
 }
 //#endregion
 //#region src/structure/engine/runner.ts
-var Kt = class extends Error {
+var Vt = class extends Error {
 	constructor(e) {
 		super(`Post-run recheck: rule set not idempotent. Failing item: ${e.primitive} '${e.path}' (scope=${e.scope}, action=${e.action}). Engine bug.`), this.failing = e, this.name = "RecheckError";
 	}
 };
-function qt(e, t, n, r) {
+function Ht(e, t, n, r) {
 	switch (e.kind) {
 		case "text": return e.value;
 		case "file":
@@ -1086,10 +822,10 @@ function qt(e, t, n, r) {
 			return n.staticRead(e.path);
 		case "tpl":
 			if (!n) throw Error(`tpl('${e.path}'): no TemplateProvider configured. Pass opts.templates to engine.run(...).`);
-			return Ae(n.textRead(e.path), typeof e.vars == "function" ? e.vars(r) : e.vars);
+			return Ce(n.textRead(e.path), typeof e.vars == "function" ? e.vars(r) : e.vars);
 		case "generate": {
 			let n = e.fn(r);
-			if (t.endsWith(".json")) return yt(n, r.isSdkInternal), ot(n, { collapse: !t.endsWith("package.json") });
+			if (t.endsWith(".json")) return dt(n, r.isSdkInternal), Qe(n, { collapse: !t.endsWith("package.json") });
 			if (t.endsWith(".yaml") || t.endsWith(".yml")) return ce(n);
 			if (typeof n != "string") throw Error(`generate() for '${t}' must return a string for non-JSON/YAML files; got ${typeof n}`);
 			return n;
@@ -1097,36 +833,36 @@ function qt(e, t, n, r) {
 		case "binary": throw Error(`binary('${e.path}') cannot be resolved to a string; it is only valid inside seed()/scaffold(), which copy it verbatim via fs.writeBinary.`);
 	}
 }
-function Jt(e, t, n, r, i) {
+function Ut(e, t, n, r, i) {
 	if (n.kind === "binary") {
 		if (!r) throw Error(`binary('${n.path}'): no TemplateProvider configured. Pass opts.templates to engine.run(...).`);
 		e.writeBinary(t, r.staticReadBinary(n.path));
 		return;
 	}
-	e.write(t, qt(n, t, r, i));
+	e.write(t, Ht(n, t, r, i));
 }
-function Yt(e, t, n, r, i, a) {
+function Wt(e, t, n, r, i, a) {
 	let o = e.split("/").pop() ?? e;
 	if (e.endsWith(".json")) {
-		let i = et(t);
+		let i = Ke(t);
 		if (typeof i != "object" || !i || Array.isArray(i)) throw Error(`managed: parsed value at '${e}' is not a JSON object`);
-		return Ct(i, n, { triggerContext: r }), ot(i, { collapse: o !== "package.json" });
+		return ht(i, n, { triggerContext: r }), Qe(i, { collapse: o !== "package.json" });
 	}
 	if (e.endsWith(".yaml") || e.endsWith(".yml")) {
-		let e = Bt(t);
-		return wt(e, n, {
+		let e = Ft(t);
+		return gt(e, n, {
 			triggerContext: r,
 			getLatestVersion: i,
 			getDerivedDependencyPin: a
-		}), Vt(e);
+		}), It(e);
 	}
 	if (o === ".gitignore" || o.endsWith(".gitignore")) {
-		let e = ft(t);
-		return Tt(e, n, { triggerContext: r }), pt(e);
+		let e = it(t);
+		return _t(e, n, { triggerContext: r }), at(e);
 	}
 	throw Error(`managed('${e}'): unsupported file kind. Only .json, .yaml, .yml, .gitignore are dispatched.`);
 }
-function Xt(e) {
+function Gt(e) {
 	let t = e.list(""), n = /* @__PURE__ */ new Set();
 	for (let e of t) {
 		n.add(e);
@@ -1135,37 +871,37 @@ function Xt(e) {
 	}
 	return n;
 }
-function Zt(e, t) {
+function Kt(e, t) {
 	let n = t === "" ? t : t.endsWith("/") ? t.slice(0, -1) : t;
 	return e.has(n);
 }
-function Qt(e, t, n) {
+function qt(e, t, n) {
 	return {
 		ctx: t,
 		version: t.version,
-		pathExists: (t) => Zt(e, t),
-		pathMissing: (t) => !Zt(e, t),
+		pathExists: (t) => Kt(e, t),
+		pathMissing: (t) => !Kt(e, t),
 		filesMatch: (t) => {
 			let r = n ? `${n}/${t}` : t;
-			for (let t of e) if (ze(r, t)) return !0;
+			for (let t of e) if (Me(r, t)) return !0;
 			return !1;
 		}
 	};
 }
-function $t(e, t) {
+function Jt(e, t) {
 	for (let n of e.triggers) if (!n(t)) return !1;
 	return !0;
 }
-function en(e, t) {
+function Yt(e, t) {
 	return t ? "init" : e.updateDepsOnly ? "updateDeps" : "default";
 }
-function tn(e, t) {
+function Xt(e, t) {
 	return e.filter((e) => e.modes.includes(t));
 }
-function nn(e, t, n, r, i, a) {
+function Zt(e, t, n, r, i, a) {
 	let o = e.leaf;
 	if (o.kind === "fixed") {
-		let i = qt(o.content, e.resolvedPath, r, a);
+		let i = Ht(o.content, e.resolvedPath, r, a);
 		return t.exists(e.resolvedPath) ? t.read(e.resolvedPath) === i ? void 0 : (n || t.write(e.resolvedPath, i), {
 			scope: e.scope,
 			path: e.resolvedPath,
@@ -1178,13 +914,13 @@ function nn(e, t, n, r, i, a) {
 			action: "create"
 		});
 	}
-	if (o.kind === "scaffold") return t.exists(e.resolvedPath) ? void 0 : (n || Jt(t, e.resolvedPath, o.initial, r, a), {
+	if (o.kind === "scaffold") return t.exists(e.resolvedPath) ? void 0 : (n || Ut(t, e.resolvedPath, o.initial, r, a), {
 		scope: e.scope,
 		path: e.resolvedPath,
 		primitive: "scaffold",
 		action: "create"
 	});
-	if (o.kind === "seed") return !i || t.exists(e.resolvedPath) ? void 0 : (n || Jt(t, e.resolvedPath, o.initial, r, a), {
+	if (o.kind === "seed") return !i || t.exists(e.resolvedPath) ? void 0 : (n || Ut(t, e.resolvedPath, o.initial, r, a), {
 		scope: e.scope,
 		path: e.resolvedPath,
 		primitive: "seed",
@@ -1207,58 +943,58 @@ function nn(e, t, n, r, i, a) {
 		});
 	}
 }
-function rn(e, t, n, r, i, a, o, s) {
+function Qt(e, t, n, r, i, a, o, s) {
 	if (e.leaf.kind !== "managed") return;
-	let c = e.leaf, l = e.resolvedPath, ee = t.exists(l), u, d = !1;
-	ee ? u = t.read(l) : (u = qt(c.initial, l, i, s), d = !0);
-	let f = Yt(l, u, c.body, r, a, o);
-	if (d) return n || t.write(l, f), {
+	let c = e.leaf, l = e.resolvedPath, u = t.exists(l), d, ee = !1;
+	u ? d = t.read(l) : (d = Ht(c.initial, l, i, s), ee = !0);
+	let f = Wt(l, d, c.body, r, a, o);
+	if (ee) return n || t.write(l, f), {
 		scope: e.scope,
 		path: l,
 		primitive: "managed",
 		action: "create"
 	};
-	if (f !== u) return n || t.write(l, f), {
+	if (f !== d) return n || t.write(l, f), {
 		scope: e.scope,
 		path: l,
 		primitive: "managed",
 		action: "update"
 	};
 }
-function an(e, t, n, r, i, a, o, s) {
-	let c = tn(e, en(n, a)), l = [], ee = Xt(t);
+function $t(e, t, n, r, i, a, o, s) {
+	let c = Xt(e, Yt(n, a)), l = [], u = Gt(t);
 	for (let e of c) {
-		if (e.leaf.kind === "managed" || !$t(e, Qt(ee, n, e.modulePath))) continue;
-		let o = nn(e, t, r, i, a, n);
+		if (e.leaf.kind === "managed" || !Jt(e, qt(u, n, e.modulePath))) continue;
+		let o = Zt(e, t, r, i, a, n);
 		o && l.push(o);
 	}
-	let u = Xt(t);
+	let d = Gt(t);
 	for (let e of c) {
 		if (e.leaf.kind !== "managed") continue;
-		let a = Qt(u, n, e.modulePath);
-		if (!$t(e, a)) continue;
-		let c = rn(e, t, r, a, i, o, s, n);
+		let a = qt(d, n, e.modulePath);
+		if (!Jt(e, a)) continue;
+		let c = Qt(e, t, r, a, i, o, s, n);
 		c && l.push(c);
 	}
 	return l;
 }
-function on(e, t, n, r = {}) {
-	return Ve(n, () => {
-		let i = Pe(e, n), a = !!r.initMode, o = an(i, t, n, n.dryRun, r.templates, a, r.registryLookup, r.derivedPinLookup);
+function en(e, t, n, r = {}) {
+	return Pe(n, () => {
+		let i = De(e, n), a = !!r.initMode, o = $t(i, t, n, n.dryRun, r.templates, a, r.registryLookup, r.derivedPinLookup);
 		if (!n.dryRun && !n.updateDepsOnly && !a) {
-			Gt(t);
+			Bt(t);
 			let i = {
 				...r.rediscover ? r.rediscover(t) : n,
 				dryRun: !0
-			}, a = an(Pe(e, i), t, i, !0, r.templates, !1, r.registryLookup, r.derivedPinLookup).filter((e) => e.path !== Ht);
-			if (a.length > 0) throw new Kt(a[0]);
+			}, a = $t(De(e, i), t, i, !0, r.templates, !1, r.registryLookup, r.derivedPinLookup).filter((e) => e.path !== Lt);
+			if (a.length > 0) throw new Vt(a[0]);
 		}
-		return a && !n.dryRun && Gt(t), { changes: o };
+		return a && !n.dryRun && Bt(t), { changes: o };
 	});
 }
 //#endregion
 //#region src/structure/engine/discovery.ts
-var sn = [
+var tn = [
 	"root",
 	"block",
 	"model",
@@ -1266,12 +1002,12 @@ var sn = [
 	"workflow",
 	"test",
 	"software"
-], cn = class extends Error {
+], nn = class extends Error {
 	constructor(e, t) {
 		super(e), this.path = t, this.name = "DiscoveryError";
 	}
 };
-function ln(e) {
+function rn(e) {
 	let t = /* @__PURE__ */ new Set();
 	for (let n of [
 		e.dependencies,
@@ -1281,66 +1017,60 @@ function ln(e) {
 	]) if (n) for (let e of Object.keys(n)) t.add(e);
 	return t;
 }
-function un(e) {
+function an(e) {
 	return e === "" || e === ".";
 }
-function dn(e, t) {
-	let n = e.pkg["block-scope"];
-	if (typeof n == "string") {
-		if (!sn.includes(n)) throw new cn(`package.json "block-scope" must be one of ${sn.join(", ")}, got '${n}'`, e.path);
-		return n;
+function on(e) {
+	let t = e.pkg["block-scope"];
+	if (typeof t == "string") {
+		if (!tn.includes(t)) throw new nn(`package.json "block-scope" must be one of ${tn.join(", ")}, got '${t}'`, e.path);
+		return t;
 	}
-	if (un(e.path)) return "root";
-	let r = ln(e.pkg);
+	if (an(e.path)) return "root";
+	if (e.pkg.block !== void 0) return "block";
+	let n = rn(e.pkg);
 	if (e.pkg["block-software"] !== void 0) return "software";
-	if (r.has("@platforma-sdk/package-builder")) {
-		for (let e of r) if (/^@platforma-open\/.*runenv/.test(e)) return "software";
-	}
-	if (r.has("@platforma-sdk/workflow-tengo")) return "workflow";
-	if ((r.has("@platforma-sdk/ui-vue") || r.has("vue")) && !e.pkg.main) return "ui";
-	if (r.has("@platforma-sdk/block-tools")) {
-		if ([...r].filter((e) => t.has(e) && (e.endsWith(".model") || e.endsWith(".ui") || e.endsWith(".workflow"))).length >= 2) return "block";
-		let n = e.pkg.files;
-		if (Array.isArray(n) && n.length === 2 && n.includes("index.d.ts") && n.includes("index.js")) return "block";
-	}
-	if (r.has("@platforma-sdk/model") && e.pkg.main) return "model";
-	if (r.has("@platforma-sdk/test")) return "test";
-}
-function fn(e) {
-	let t = /* @__PURE__ */ new Set();
-	for (let n of e) typeof n.pkg.name == "string" && t.add(n.pkg.name);
-	let n = [];
-	for (let r of e) {
-		let e = dn(r, t);
-		if (!e) throw new cn(`Unclassified workspace package at '${r.path}'. Add a top-level "block-scope" string to its package.json.`, r.path);
-		n.push({
+	if (n.has("@platforma-sdk/package-builder")) {
+		for (let e of n) if (/^@platforma-open\/.*runenv/.test(e)) return "software";
+	}
+	if (n.has("@platforma-sdk/workflow-tengo")) return "workflow";
+	if ((n.has("@platforma-sdk/ui-vue") || n.has("vue")) && !e.pkg.main) return "ui";
+	if (n.has("@platforma-sdk/model") && e.pkg.main) return "model";
+	if (n.has("@platforma-sdk/test")) return "test";
+}
+function sn(e) {
+	let t = [];
+	for (let n of e) {
+		let e = on(n);
+		if (!e) throw new nn(`Unclassified workspace package at '${n.path}'. Add a top-level "block-scope" string to its package.json.`, n.path);
+		t.push({
 			scope: e,
-			name: r.pkg.name ?? r.path,
-			path: un(r.path) ? "" : r.path
+			name: n.pkg.name ?? n.path,
+			path: an(n.path) ? "" : n.path
 		});
 	}
-	return n;
+	return t;
 }
 //#endregion
 //#region src/structure/engine/ctx.ts
-function q(e, t) {
+function J(e, t) {
 	return e.modules.filter((e) => e.scope === t);
 }
-function pn(e, t) {
-	let n = q(e, t);
+function cn(e, t) {
+	let n = J(e, t);
 	if (n.length === 0) throw Error(`findModule: expected one '${t}' module, found none`);
 	if (n.length > 1) throw Error(`findModule: expected exactly one '${t}' module, found ${n.length}`);
 	return n[0];
 }
-function mn(e, t) {
-	return { [pn(e, t).name]: "workspace:*" };
+function ln(e, t) {
+	return { [cn(e, t).name]: "workspace:*" };
 }
-function hn(e, t) {
+function un(e, t) {
 	let n = {};
-	for (let r of q(e, t)) n[r.name] = "workspace:*";
+	for (let r of J(e, t)) n[r.name] = "workspace:*";
 	return n;
 }
-function gn(e) {
+function dn(e) {
 	let t = e.facadeName, n = [
 		{
 			scope: "root",
@@ -1379,7 +1109,7 @@ function gn(e) {
 		path: "software"
 	}), n;
 }
-function _n(e) {
+function fn(e) {
 	return {
 		isSdkInternal: e.isSdkInternal ?? !1,
 		updateDepsOnly: e.updateDepsOnly ?? !1,
@@ -1391,41 +1121,41 @@ function _n(e) {
 }
 //#endregion
 //#region src/structure/engine/discovery-fs.ts
-var J = class extends Error {
+var Y = class extends Error {
 	constructor(e) {
 		super(e), this.name = "StructureCliError";
 	}
 };
-function vn(e, t) {
+function pn(e, t) {
 	return e === "" ? t : `${e}/${t}`;
 }
-function yn(e, t) {
+function mn(e, t) {
 	try {
 		return JSON.parse(e.read(t));
 	} catch {
 		return;
 	}
 }
-function bn(e) {
-	if (e.includes("*")) throw new J(`pnpm-workspace.yaml 'packages:' entry '${e}' contains a glob. The structurer requires literal package paths — replace the glob with one entry per package directory.`);
+function hn(e) {
+	if (e.includes("*")) throw new Y(`pnpm-workspace.yaml 'packages:' entry '${e}' contains a glob. The structurer requires literal package paths — replace the glob with one entry per package directory.`);
 	let t = e.replace(/^\.\//, "").replace(/\/$/, "");
 	return t === "." ? "" : t;
 }
-function xn(e) {
+function gn(e) {
 	let t;
 	try {
 		t = e.read("pnpm-workspace.yaml");
 	} catch {
-		throw new J("No pnpm-workspace.yaml found. This directory is empty or unrecognisable as a block — run 'block-tools structure init' instead, or pass --sdk-internal for an in-monorepo block.");
+		throw new Y("No pnpm-workspace.yaml found. This directory is empty or unrecognisable as a block — run 'block-tools structure init' instead, or pass --sdk-internal for an in-monorepo block.");
 	}
 	let n = oe(t) ?? {}, r = Array.isArray(n.packages) ? n.packages : [], i = new Set([""]);
 	for (let t of r) {
-		let n = bn(t);
+		let n = hn(t);
 		(n === "" || e.exists(n)) && i.add(n);
 	}
 	let a = [];
 	for (let t of i) {
-		let n = yn(e, vn(t, "package.json"));
+		let n = mn(e, pn(t, "package.json"));
 		n && a.push({
 			path: t,
 			pkg: n
@@ -1433,7 +1163,7 @@ function xn(e) {
 	}
 	return a;
 }
-function Sn(e) {
+function _n(e) {
 	let t = [], n = new Set([
 		"node_modules",
 		".turbo",
@@ -1445,7 +1175,7 @@ function Sn(e) {
 		let o = e.listDir(i);
 		for (let s of o) {
 			if (!s.isDirectory || n.has(s.name)) continue;
-			let o = vn(i, s.name), c = yn(e, vn(o, "package.json"));
+			let o = pn(i, s.name), c = mn(e, pn(o, "package.json"));
 			c && t.push({
 				path: o,
 				pkg: c
@@ -1454,11 +1184,11 @@ function Sn(e) {
 	}
 	return r("", 1), t;
 }
-function Cn(e) {
+function vn(e) {
 	let t = e.indexOf("/");
-	if (!e.startsWith("@") || t < 0) throw new J(`Cannot parse block name '${e}': expected '@npm-org/org-scope.short-name'.`);
+	if (!e.startsWith("@") || t < 0) throw new Y(`Cannot parse block name '${e}': expected '@npm-org/org-scope.short-name'.`);
 	let n = e.slice(0, t), r = e.slice(t + 1), i = r.indexOf(".");
-	if (i < 0) throw new J(`Cannot parse block name '${e}': base name '${r}' has no '.' separating org-scope from short-name.`);
+	if (i < 0) throw new Y(`Cannot parse block name '${e}': base name '${r}' has no '.' separating org-scope from short-name.`);
 	return {
 		facadeName: e,
 		baseName: r,
@@ -1467,23 +1197,23 @@ function Cn(e) {
 		shortName: r.slice(i + 1)
 	};
 }
-function wn(e) {
+function yn(e) {
 	try {
-		let t = JSON.parse(e.read(Ht));
+		let t = JSON.parse(e.read(Lt));
 		return typeof t.version == "number" ? t.version : 0;
 	} catch {
 		return 0;
 	}
 }
-function Tn(e) {
-	let { fs: t, isSdkInternal: n } = e, r = n ? Sn(t) : xn(t);
-	if (r.length === 0) throw new J("No workspace packages found. Run 'block-tools structure init' to scaffold a block.");
-	let i = fn(r), a = wn(t);
-	Ut(a, 0);
+function bn(e) {
+	let { fs: t, isSdkInternal: n } = e, r = n ? _n(t) : gn(t);
+	if (r.length === 0) throw new Y("No workspace packages found. Run 'block-tools structure init' to scaffold a block.");
+	let i = sn(r), a = yn(t);
+	Rt(a, 0);
 	let o = i.find((e) => e.scope === "block") ?? i.find((e) => e.scope === "root");
-	if (!o) throw new J("Could not find a 'block' (or root-as-block) package to derive BlockVars from.");
-	let s = Cn(o.name.replace(/\.block$/, ""));
-	return _n({
+	if (!o) throw new Y("Could not find a 'block' (or root-as-block) package to derive BlockVars from.");
+	let s = vn(o.name.replace(/\.block$/, ""));
+	return fn({
 		isSdkInternal: n,
 		updateDepsOnly: e.updateDepsOnly ?? !1,
 		modules: i,
@@ -1494,7 +1224,7 @@ function Tn(e) {
 }
 //#endregion
 //#region src/structure/rules/shared/key-order.ts
-var Y = [
+var X = [
 	"name",
 	"version",
 	"private",
@@ -1518,7 +1248,7 @@ var Y = [
 ];
 //#endregion
 //#region src/structure/rules/root-package-json.ts
-function En(e) {
+function xn(e) {
 	return {
 		version: "1.0.0",
 		private: !0,
@@ -1551,88 +1281,88 @@ function En(e) {
 		packageManager: "pnpm@9.12.0"
 	};
 }
-function Dn() {
-	F("packageManager", "pnpm@9.12.0"), Et("name"), I("fmt", "turbo run fmt"), I("check", "turbo run check"), I("build", "turbo run build"), I("build:dev", "env PL_PKG_DEV=local turbo run build"), I("test", "env PL_PKG_DEV=local turbo run test --concurrency 1"), I("test:dry-run", "env PL_PKG_DEV=local turbo run test --dry-run=json"), I("mark-stable", "turbo run mark-stable"), I("do-pack", "turbo run do-pack"), I("watch", "turbo watch build"), I("changeset", "changeset"), I("version-packages", "changeset version"), I("update-sdk", "block-tools structure refresh --update-deps-only"), L("update"), I("upgrade-sdk", "block-tools structure refresh --update-deps-only && pnpm i && block-tools structure refresh && pnpm i && pnpm fmt"), H({
+function Sn() {
+	L("packageManager", "pnpm@9.12.0"), vt("name"), R("fmt", "turbo run fmt"), R("check", "turbo run check"), R("build", "turbo run build"), R("build:dev", "env PL_PKG_DEV=local turbo run build"), R("test", "env PL_PKG_DEV=local turbo run test --concurrency 1"), R("test:dry-run", "env PL_PKG_DEV=local turbo run test --dry-run=json"), R("mark-stable", "turbo run mark-stable"), R("do-pack", "turbo run do-pack"), R("watch", "turbo watch build"), R("changeset", "changeset"), R("version-packages", "changeset version"), R("update-sdk", "block-tools structure refresh --update-deps-only"), z("update"), R("upgrade-sdk", "block-tools structure refresh --update-deps-only && pnpm i && block-tools structure refresh && pnpm i && pnpm fmt"), W({
 		"@changesets/cli": "catalog:",
 		"@milaboratories/ts-builder": "sdk:",
 		"@platforma-sdk/block-tools": "sdk:",
 		shx: "catalog:",
 		turbo: "catalog:"
-	}), U({
+	}), G({
 		oxlint: "*",
 		oxfmt: "*"
-	}), At((e, t) => {
+	}), Tt((e, t) => {
 		if (!/^(\/\/|--)/.test(e) || typeof t != "object" || !t) return !1;
 		let n = t;
 		return n.pnpm !== void 0 || n.overrides !== void 0;
-	}), K("dependencies"), K("devDependencies"), K("peerDependencies"), K("optionalDependencies"), G([...Y]);
+	}), q("dependencies"), q("devDependencies"), q("peerDependencies"), q("optionalDependencies"), K([...X]);
 }
 //#endregion
 //#region src/structure/engine/registry-client.ts
-var On = 2, kn = 500, An = 3e4;
-function jn(e) {
+var Cn = 2, wn = 500, Tn = 3e4;
+function En(e) {
 	if (!e) return null;
 	let t = Number(e);
 	if (Number.isFinite(t) && t > 0) return t * 1e3;
 	let n = Date.parse(e);
 	return Number.isNaN(n) ? null : Math.max(0, n - Date.now());
 }
-async function Mn(e) {
+async function Dn(e) {
 	for (let t = 1;; t++) {
 		let n;
 		try {
-			n = await fetch(e, { signal: AbortSignal.timeout(An) });
+			n = await fetch(e, { signal: AbortSignal.timeout(Tn) });
 		} catch (e) {
-			if (t > On) throw e;
-			await le(kn * 2 ** (t - 1) * (.8 + .4 * Math.random()));
+			if (t > Cn) throw e;
+			await le(wn * 2 ** (t - 1) * (.8 + .4 * Math.random()));
 			continue;
 		}
 		if (n.ok) return n;
-		if (!(n.status === 429 || n.status >= 500) || t > On) throw Error(`registry returned HTTP ${n.status}`);
-		let r = jn(n.headers.get("retry-after"));
+		if (!(n.status === 429 || n.status >= 500) || t > Cn) throw Error(`registry returned HTTP ${n.status}`);
+		let r = En(n.headers.get("retry-after"));
 		if (r != null) {
 			await le(r);
 			continue;
 		}
-		await le(kn * 2 ** (t - 1) * (.8 + .4 * Math.random()));
+		await le(wn * 2 ** (t - 1) * (.8 + .4 * Math.random()));
 	}
 }
-function Nn() {
+function On() {
 	return {
 		async getLatestVersion(e) {
-			let t = (await (await Mn(`https://registry.npmjs.org/-/package/${e}/dist-tags`)).json()).latest;
+			let t = (await (await Dn(`https://registry.npmjs.org/-/package/${e}/dist-tags`)).json()).latest;
 			if (!t) throw Error("no 'latest' dist-tag in registry response");
 			return t;
 		},
 		async getDeclaredDependency(e, t, n) {
-			let r = await (await Mn(`https://registry.npmjs.org/${e}/${t}`)).json();
+			let r = await (await Dn(`https://registry.npmjs.org/${e}/${t}`)).json();
 			return r.dependencies?.[n] ?? r.peerDependencies?.[n];
 		}
 	};
 }
-async function Pn(e, t) {
+async function kn(e, t) {
 	let n = await Promise.all(t.map(async (t) => [t, await e.getLatestVersion(t)]));
 	return new Map(n);
 }
-function Fn(e) {
+function An(e) {
 	return (t) => e.get(t);
 }
-var In = [/^@platforma-sdk\//, /^@milaboratories\//];
-function Ln(e) {
-	return In.some((t) => t.test(e));
+var jn = [/^@platforma-sdk\//, /^@milaboratories\//];
+function Mn(e) {
+	return jn.some((t) => t.test(e));
 }
-async function Rn(e, t = Nn()) {
-	return e.length === 0 ? () => void 0 : Fn(await Pn(t, e));
+async function Nn(e, t = On()) {
+	return e.length === 0 ? () => void 0 : An(await kn(t, e));
 }
-function zn(e) {
+function Pn(e) {
 	return /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(e);
 }
-async function Bn(e, t = Nn()) {
+async function Fn(e, t = On()) {
 	if (e.length === 0) return () => void 0;
 	let n = await Promise.all(e.map(async (e) => {
 		let n = await t.getDeclaredDependency(e.of, e.ofVersion ?? "latest", e.entry);
 		if (n === void 0) throw Error(`derived catalog pin '${e.entry}': package '${e.of}'${e.ofVersion ? `@${e.ofVersion}` : " (latest)"} declares no dependency '${e.entry}'. A derived pin requires the source to declare the dep as an exact version.`);
-		if (!zn(n)) throw Error(`derived catalog pin '${e.entry}': package '${e.of}'${e.ofVersion ? `@${e.ofVersion}` : " (latest)"} declares '${e.entry}: ${n}', which is not an exact version. A derived pin requires an exact ('x.y.z') source dependency so the catalog can pin to it precisely.`);
+		if (!Pn(n)) throw Error(`derived catalog pin '${e.entry}': package '${e.of}'${e.ofVersion ? `@${e.ofVersion}` : " (latest)"} declares '${e.entry}: ${n}', which is not an exact version. A derived pin requires an exact ('x.y.z') source dependency so the catalog can pin to it precisely.`);
 		return [e.entry, n];
 	})), r = new Map(n);
 	return (e) => r.get(e);
@@ -1640,7 +1370,7 @@ async function Bn(e, t = Nn()) {
 //#endregion
 //#region src/structure/rules/shared/retired-deps.ts
 //   @vitejs/plugin-vue   — bundled by ts-builder's internal vite config.
-var Vn = [
+var In = [
 	"vite",
 	"tsup",
 	"vue-tsc",
@@ -1648,12 +1378,12 @@ var Vn = [
 	"vite-plugin-dts",
 	"@platforma-sdk/eslint-config"
 ];
-function Hn() {
-	for (let e of Vn) V(e);
+function Ln() {
+	for (let e of In) U(e);
 }
 //#endregion
 //#region src/structure/rules/root-pnpm-workspace.ts
-var X = [
+var Z = [
 	"@platforma-sdk/model",
 	"@platforma-sdk/ui-vue",
 	"@platforma-sdk/workflow-tengo",
@@ -1663,32 +1393,32 @@ var X = [
 	"@platforma-sdk/package-builder",
 	"@milaboratories/ts-builder",
 	"@milaboratories/ts-configs"
-], Un = "0.0.0-init-must-fetch";
-for (let e of X) if (!Ln(e)) throw Error(`SDK_CATALOG_PACKAGES entry '${e}' matches no catalog bump pattern; its placeholder would never be resolved to npm latest on init. Add it to CATALOG_BUMP_PATTERNS or move it to the infra floor.`);
-var Wn = {
+], Rn = "0.0.0-init-must-fetch";
+for (let e of Z) if (!Mn(e)) throw Error(`SDK_CATALOG_PACKAGES entry '${e}' matches no catalog bump pattern; its placeholder would never be resolved to npm latest on init. Add it to CATALOG_BUMP_PATTERNS or move it to the infra floor.`);
+var zn = {
 	turbo: "~2.8.11",
 	shx: "~0.4.0",
 	"@changesets/cli": "~2.29.8",
 	vitest: "~4.0.18"
-}, Gn = [{
+}, Bn = [{
 	entry: "vue",
 	of: "@platforma-sdk/ui-vue"
-}], Kn = "@platforma-open/milaboratories.runenv-python-3", qn = "1.8.2";
-function Jn(e) {
+}], Vn = "@platforma-open/milaboratories.runenv-python-3", Hn = "1.8.2";
+function Un(e) {
 	let t = e.modules.filter((e) => e.path !== "").map((e) => e.path).sort(), n = {};
-	for (let e of X) n[e] = Un;
-	return Object.assign(n, Wn), e.modules.some((e) => e.scope === "software") && (n[Kn] = qn), {
+	for (let e of Z) n[e] = Rn;
+	return Object.assign(n, zn), e.modules.some((e) => e.scope === "software") && (n[Vn] = Hn), {
 		packages: t,
 		catalog: n
 	};
 }
-function Yn() {
-	Nt();
-	for (let e of Vn) Rt(e);
+function Wn() {
+	Ot();
+	for (let e of In) Nt(e);
 }
 //#endregion
 //#region src/structure/rules/root-gitignore.ts
-var Xn = [
+var Gn = [
 	".test_auth.json",
 	"node_modules/",
 	"dist/",
@@ -1703,52 +1433,92 @@ var Xn = [
 	".vscode/sftp.json",
 	"test-dry-run.json"
 ];
-function Zn() {
-	zt(Xn);
+function Kn() {
+	Pt(Gn);
 }
 //#endregion
 //#region src/structure/rules/root.ts
-function Qn() {
-	y("root", () => {
-		b(({ ctx: e }) => !e.isSdkInternal, () => {
-			S("turbo.json", E("root/turbo.json")), S(".vscode/settings.json", E("root/.vscode/settings.json")), C("package.json", O((e) => En(e)), () => {
-				Dn();
-			}), C("pnpm-workspace.yaml", O((e) => Jn(e)), () => {
-				Yn();
-			}), C(".gitignore", E("root/.gitignore"), () => {
-				Zn();
+function qn() {
+	b("root", () => {
+		x(({ ctx: e }) => !e.isSdkInternal, () => {
+			C("turbo.json", O("root/turbo.json")), C(".vscode/settings.json", O("root/.vscode/settings.json")), w("package.json", A((e) => xn(e)), () => {
+				Sn();
+			}), w("pnpm-workspace.yaml", A((e) => Un(e)), () => {
+				Wn();
+			}), w(".gitignore", O("root/.gitignore"), () => {
+				Kn();
 			});
 		});
 	});
 }
 //#endregion
 //#region src/structure/rules/root-ci.ts
-function $n(e) {
+function Jn(e) {
 	return e.split(/[-_]+/).filter((e) => e.length > 0).map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join(" ");
 }
-function er() {
-	y("root", () => {
-		b(({ ctx: e }) => !e.isSdkInternal, () => {
-			S(".github/workflows/build.yaml", D("workflows/build.tpl.yaml", (e) => {
+function Yn() {
+	b("root", () => {
+		x(({ ctx: e }) => !e.isSdkInternal, () => {
+			C(".github/workflows/build.yaml", k("workflows/build.tpl.yaml", (e) => {
 				let t = e.blockVars.shortName;
 				return {
-					appName: `Block: ${$n(t)}`,
+					appName: `Block: ${Jn(t)}`,
 					appNameSlug: `block-${t}`
 				};
-			})), S(".github/workflows/mark-stable.yaml", D("workflows/mark-stable.tpl.yaml", (e) => ({ appName: `Block: ${$n(e.blockVars.shortName)} - Mark Stable` })));
+			})), C(".github/workflows/mark-stable.yaml", k("workflows/mark-stable.tpl.yaml", (e) => ({ appName: `Block: ${Jn(e.blockVars.shortName)} - Mark Stable` })));
 		});
 	});
 }
 //#endregion
 //#region src/structure/rules/block-package-json.ts
-function tr(e) {
+var Xn = {
+	"@platforma-open": {
+		s3: "s3://milab-euce1-prod-pkgs-s3-block-registry/pub/releases/?region=eu-central-1",
+		serveUrl: "https://blocks.pl-open.science"
+	},
+	"@milaboratories": {
+		s3: "s3://milab-euce1-prod-pkgs-s3-block-registry/pub/releases/?region=eu-central-1",
+		serveUrl: "https://block.registry.platforma.bio/releases"
+	}
+}, Zn = {
+	s3: "s3://milab-euce1-prod-pkgs-s3-block-registry/pub/releases/?region=eu-central-1",
+	serveUrl: "https://blocks.pl-open.science"
+}, Qn = {
+	s3: "s3://milab-euce1-prod-pkgs-s3-block-registry/aux/dev/?region=eu-central-1",
+	serveUrl: "https://aux-blocks.pl-open.science"
+};
+function $n(e, t) {
+	let n = t ? Qn : Xn[e] ?? Zn;
+	return `block-tools publish -r ${n.s3} --registry-serve-url ${n.serveUrl}`;
+}
+function er(e) {
 	let t = {};
-	for (let n of q(e, "workflow")) t.workflow = `${n.name}/dist/tengo/tpl/main.plj.gz`;
-	for (let n of q(e, "model")) t.model = `${n.name}/dist/model.json`;
-	for (let n of q(e, "ui")) t.ui = `${n.name}/dist`;
+	for (let n of J(e, "workflow")) t.workflow = `${n.name}/dist/tengo/tpl/main.plj.gz`;
+	for (let n of J(e, "model")) t.model = `${n.name}/dist/model.json`;
+	for (let n of J(e, "ui")) t.ui = `${n.name}/dist`;
 	return t;
 }
-function nr(e) {
+function tr(e, t) {
+	return {
+		build: "ts-builder build --target block-facade && block-tools pack",
+		check: "ts-builder type-check --target block-facade",
+		prepublishOnly: $n(e, t),
+		"do-pack": "pnpm pack && shx mv *.tgz package.tgz"
+	};
+}
+var nr = {
+	"@milaboratories/ts-builder": "sdk:",
+	"@milaboratories/ts-configs": "sdk:",
+	"@platforma-sdk/block-tools": "sdk:",
+	"@platforma-sdk/model": "sdk:",
+	shx: "catalog:",
+	typescript: "catalog:"
+}, rr = { ".": {
+	sources: "./src/index.ts",
+	types: "./dist/index.d.ts",
+	default: "./dist/index.js"
+} };
+function ir(e) {
 	if (Object.keys(e.components).length === 0) throw Error("block.components is empty — no workflow/model/ui module was discovered");
 	let t = e.meta, n = [
 		["block.meta.title", t.title],
@@ -1760,13 +1530,14 @@ function nr(e) {
 	];
 	for (let [e, t] of n) if (typeof t != "string" || t === "") throw Error(`required block field '${e}' is empty`);
 }
-function rr(e) {
+function ar(e) {
 	let t = e.blockVars, n = {
-		...mn(e, "model"),
-		...mn(e, "ui"),
-		...mn(e, "workflow")
+		...nr,
+		...un(e, "model"),
+		...un(e, "ui"),
+		...un(e, "workflow")
 	}, r = {
-		components: tr(e),
+		components: er(e),
 		meta: {
 			title: t.shortName,
 			description: `${t.shortName} block`,
@@ -1778,45 +1549,55 @@ function rr(e) {
 			}
 		}
 	};
-	return nr(r), {
+	return ir(r), {
 		name: `${t.facadeName}.block`,
 		version: "1.0.0",
-		files: ["index.d.ts", "index.js"],
-		scripts: {
-			build: "shx rm -rf ./block-pack && block-tools pack",
-			"mark-stable": "block-tools mark-stable -r 's3://milab-euce1-prod-pkgs-s3-block-registry/pub/releases/?region=eu-central-1'",
-			prepublishOnly: "block-tools pack && block-tools publish -r 's3://milab-euce1-prod-pkgs-s3-block-registry/pub/releases/?region=eu-central-1'",
-			"do-pack": "shx rm -f *.tgz && block-tools pack && pnpm pack && shx mv *.tgz package.tgz"
-		},
-		dependencies: n,
-		devDependencies: {
-			"@platforma-sdk/block-tools": "sdk:",
-			shx: "catalog:"
-		},
+		type: "module",
+		files: ["dist", "block-pack"],
+		main: "./dist/index.js",
+		module: "./dist/index.js",
+		types: "./dist/index.d.ts",
+		exports: rr,
+		scripts: tr(t.npmOrg, e.isSdkInternal),
+		dependencies: {},
+		devDependencies: n,
 		block: r
 	};
 }
-function ir(e) {
-	F("files", ["index.d.ts", "index.js"]), I("build", "shx rm -rf ./block-pack && block-tools pack"), I("mark-stable", "block-tools mark-stable -r 's3://milab-euce1-prod-pkgs-s3-block-registry/pub/releases/?region=eu-central-1'"), I("prepublishOnly", "block-tools pack && block-tools publish -r 's3://milab-euce1-prod-pkgs-s3-block-registry/pub/releases/?region=eu-central-1'"), I("do-pack", "shx rm -f *.tgz && block-tools pack && pnpm pack && shx mv *.tgz package.tgz"), W("model"), W("ui"), W("workflow"), B("@platforma-sdk/block-tools", "sdk:"), B("shx", "catalog:"), F("block.components", tr(e)), K("dependencies"), K("devDependencies"), K("peerDependencies"), K("optionalDependencies"), G([...Y]);
+function or(e) {
+	let t = e.blockVars;
+	L("type", "module"), L("files", ["dist", "block-pack"]), L("main", "./dist/index.js"), L("module", "./dist/index.js"), L("types", "./dist/index.d.ts"), L("exports", rr);
+	let n = tr(t.npmOrg, e.isSdkInternal);
+	for (let [e, t] of Object.entries(n)) R(e, t);
+	z("mark-stable"), wt("model"), wt("ui"), wt("workflow"), H("@milaboratories/ts-builder", "sdk:"), H("@milaboratories/ts-configs", "sdk:"), H("@platforma-sdk/block-tools", "sdk:"), H("@platforma-sdk/model", "sdk:"), H("shx", "catalog:"), H("typescript", "catalog:"), L("block.components", er(e)), yt("version", "facade package.json must carry a 'version' (the facade publishes)"), q("dependencies"), q("devDependencies"), q("peerDependencies"), q("optionalDependencies"), K([...X]);
+}
+//#endregion
+//#region src/structure/rules/shared/pascal-case.ts
+function sr(e) {
+	let t = e.split(/[^A-Za-z0-9]+/).filter((e) => e.length > 0).map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("");
+	return /^[0-9]/.test(t) ? `_${t}` : t;
 }
 //#endregion
 //#region src/structure/rules/block.ts
-function ar() {
-	y("block", () => {
-		S("index.js", E("block/index.js")), S("index.d.ts", E("block/index.d.ts")), w("logos/block-logo.png", Qe("block/logos/block-logo.png")), w("logos/organization-logo.png", Qe("block/logos/organization-logo.png")), C("package.json", O((e) => rr(e)), (e) => {
-			ir(e);
+function cr() {
+	b("block", () => {
+		D("index.js"), D("index.d.ts"), C("src/index.ts", k("block/src/index.tpl.ts", (e) => ({
+			facadeName: e.blockVars.facadeName,
+			pascalName: sr(e.blockVars.shortName)
+		}))), C("src/AGENTS.ts", O("block/src/AGENTS.ts")), T("src/block-extra.ts", O("block/src/block-extra.ts")), T("src/agents-extra.ts", O("block/src/agents-extra.ts")), C("tsconfig.json", O("block/tsconfig.json")), E("logos/block-logo.png", We("block/logos/block-logo.png")), E("logos/organization-logo.png", We("block/logos/organization-logo.png")), w("package.json", A((e) => ar(e)), (e) => {
+			or(e);
 		});
 	});
 }
 //#endregion
 //#region src/structure/rules/shared/colocated-tests.ts
-var Z = "src/**/*.test.ts";
+var Q = "src/**/*.test.ts";
 //#endregion
 //#region src/structure/rules/model-package-json.ts
-function or(e) {
+function lr(e) {
 	return {
 		name: `${e.blockVars.facadeName}.model`,
-		version: "1.0.0",
+		private: !0,
 		type: "module",
 		main: "dist/index.cjs",
 		module: "dist/index.js",
@@ -1847,40 +1628,40 @@ function or(e) {
 		}
 	};
 }
-function sr() {
-	F("type", "module"), F("main", "dist/index.cjs"), F("module", "dist/index.js"), F("types", "dist/index.d.ts"), F("exports", {
+function ur() {
+	L("private", !0), L("type", "module"), L("main", "dist/index.cjs"), L("module", "dist/index.js"), L("types", "dist/index.d.ts"), L("exports", {
 		".": {
 			types: "./dist/index.d.ts",
 			sources: "./src/index.ts",
 			import: "./dist/index.js"
 		},
 		"./dist/*": "./dist/*"
-	}), I("fmt", "ts-builder format"), I("watch", "ts-builder build --target block-model --watch"), I("build", "ts-builder build --target block-model && block-tools build-model"), I("check", "ts-builder check --target block-model"), z("@platforma-sdk/model", "sdk:"), H({
+	}), R("fmt", "ts-builder format"), R("watch", "ts-builder build --target block-model --watch"), R("build", "ts-builder build --target block-model && block-tools build-model"), R("check", "ts-builder check --target block-model"), V("@platforma-sdk/model", "sdk:"), W({
 		"@milaboratories/ts-builder": "sdk:",
 		"@milaboratories/ts-configs": "sdk:",
 		"@platforma-sdk/block-tools": "sdk:"
-	}), U({
+	}), G({
 		"@types/node": "*",
 		typescript: "*"
-	}), b(({ ctx: e }) => !e.isSdkInternal, () => b(x(Z), () => {
-		I("test", "vitest run --passWithNoTests"), B("vitest", "catalog:"), B("@types/node", "*");
-	}, () => V("vitest"))), Hn(), Et("tsup"), L("lint"), K("dependencies"), K("devDependencies"), K("peerDependencies"), K("optionalDependencies"), G([...Y]);
+	}), x(({ ctx: e }) => !e.isSdkInternal, () => x(S(Q), () => {
+		R("test", "vitest run --passWithNoTests"), H("vitest", "catalog:"), H("@types/node", "*");
+	}, () => U("vitest"))), Ln(), vt("tsup"), z("lint"), q("dependencies"), q("devDependencies"), q("peerDependencies"), q("optionalDependencies"), K([...X]);
 }
 //#endregion
 //#region src/structure/rules/model.ts
-function cr() {
-	y("model", () => {
-		b(x(Z), () => S("tsconfig.json", E("model/tsconfig.node.json")), () => S("tsconfig.json", E("model/tsconfig.json"))), S(".oxlintrc.json", E("model/.oxlintrc.json")), S(".oxfmtrc.json", E("model/.oxfmtrc.json")), w("src/index.ts", E("model/src/index.ts")), C("package.json", O((e) => or(e)), () => {
-			sr();
+function dr() {
+	b("model", () => {
+		x(S(Q), () => C("tsconfig.json", O("model/tsconfig.node.json")), () => C("tsconfig.json", O("model/tsconfig.json"))), C(".oxlintrc.json", O("model/.oxlintrc.json")), C(".oxfmtrc.json", O("model/.oxfmtrc.json")), E("src/index.ts", O("model/src/index.ts")), w("package.json", A((e) => lr(e)), () => {
+			ur();
 		});
 	});
 }
 //#endregion
 //#region src/structure/rules/ui-package-json.ts
-function lr(e) {
+function fr(e) {
 	return {
 		name: `${e.blockVars.facadeName}.ui`,
-		version: "1.0.0",
+		private: !0,
 		type: "module",
 		scripts: {
 			fmt: "ts-builder format",
@@ -1892,7 +1673,7 @@ function lr(e) {
 		dependencies: {
 			"@platforma-sdk/ui-vue": "sdk:",
 			vue: "catalog:",
-			...mn(e, "model")
+			...ln(e, "model")
 		},
 		devDependencies: {
 			"@milaboratories/ts-builder": "sdk:",
@@ -1904,32 +1685,32 @@ function lr(e) {
 		}
 	};
 }
-function ur() {
-	F("type", "module"), I("fmt", "ts-builder format"), I("dev", "ts-builder serve --target block-ui"), I("watch", "ts-builder build --target block-ui --watch"), I("build", "ts-builder build --target block-ui"), I("check", "ts-builder check --target block-ui"), z("@platforma-sdk/ui-vue", "sdk:"), z("vue", "catalog:"), W("model"), H({
+function pr() {
+	L("private", !0), L("type", "module"), R("fmt", "ts-builder format"), R("dev", "ts-builder serve --target block-ui"), R("watch", "ts-builder build --target block-ui --watch"), R("build", "ts-builder build --target block-ui"), R("check", "ts-builder check --target block-ui"), V("@platforma-sdk/ui-vue", "sdk:"), V("vue", "catalog:"), Ct("model"), W({
 		"@milaboratories/ts-builder": "sdk:",
 		"@milaboratories/ts-configs": "sdk:"
-	}), Hn(), L("preview"), L("lint"), U({
+	}), Ln(), z("preview"), z("lint"), G({
 		"@types/node": "*",
 		typescript: "*"
-	}), b(({ ctx: e }) => !e.isSdkInternal, () => b(x(Z), () => {
-		I("test", "vitest run --passWithNoTests"), B("vitest", "catalog:"), B("@types/node", "*");
-	}, () => V("vitest"))), K("dependencies"), K("devDependencies"), K("peerDependencies"), K("optionalDependencies"), G([...Y]);
+	}), x(({ ctx: e }) => !e.isSdkInternal, () => x(S(Q), () => {
+		R("test", "vitest run --passWithNoTests"), H("vitest", "catalog:"), H("@types/node", "*");
+	}, () => U("vitest"))), q("dependencies"), q("devDependencies"), q("peerDependencies"), q("optionalDependencies"), K([...X]);
 }
 //#endregion
 //#region src/structure/rules/ui.ts
-function dr() {
-	y("ui", () => {
-		b(x(Z), () => S("tsconfig.json", E("ui/tsconfig.node.json")), () => S("tsconfig.json", E("ui/tsconfig.json"))), S(".oxlintrc.json", E("ui/.oxlintrc.json")), S(".oxfmtrc.json", E("ui/.oxfmtrc.json")), Ze("index.html", E("ui/index.html")), w("src/main.ts", E("ui/src/main.ts")), w("src/app.ts", D("ui/src/app.tpl.ts", (e) => ({ modelPkg: `${e.blockVars.facadeName}.model` }))), w("src/MainPage.vue", D("ui/src/MainPage.tpl.vue", (e) => ({ shortName: e.blockVars.shortName }))), C("package.json", O((e) => lr(e)), () => {
-			ur();
+function mr() {
+	b("ui", () => {
+		x(S(Q), () => C("tsconfig.json", O("ui/tsconfig.node.json")), () => C("tsconfig.json", O("ui/tsconfig.json"))), C(".oxlintrc.json", O("ui/.oxlintrc.json")), C(".oxfmtrc.json", O("ui/.oxfmtrc.json")), T("index.html", O("ui/index.html")), E("src/main.ts", O("ui/src/main.ts")), E("src/app.ts", k("ui/src/app.tpl.ts", (e) => ({ modelPkg: `${e.blockVars.facadeName}.model` }))), E("src/MainPage.vue", k("ui/src/MainPage.tpl.vue", (e) => ({ shortName: e.blockVars.shortName }))), w("package.json", A((e) => fr(e)), () => {
+			pr();
 		});
 	});
 }
 //#endregion
 //#region src/structure/rules/workflow-package-json.ts
-function fr(e) {
+function hr(e) {
 	return {
 		name: `${e.blockVars.facadeName}.workflow`,
-		version: "1.0.0",
+		private: !0,
 		type: "module",
 		scripts: {
 			build: "shx rm -rf dist && pl-tengo build",
@@ -1938,7 +1719,7 @@ function fr(e) {
 		},
 		dependencies: {
 			"@platforma-sdk/workflow-tengo": "sdk:",
-			...hn(e, "software")
+			...un(e, "software")
 		},
 		devDependencies: {
 			"@platforma-sdk/tengo-builder": "sdk:",
@@ -1947,34 +1728,33 @@ function fr(e) {
 		}
 	};
 }
-function pr() {
-	F("type", "module"), I("build", "shx rm -rf dist && pl-tengo build"), I("check", "pl-tengo check"), I("format", "/usr/bin/env emacs --script ./format.el || echo 'No emacs.'"), b(({ ctx: e }) => !e.isSdkInternal, () => b(x(Z), () => {
-		I("test", "vitest run --passWithNoTests"), H({ vitest: "catalog:" });
-	}, () => V("vitest"))), z("@platforma-sdk/workflow-tengo", "sdk:"), W("software"), H({
+function gr() {
+	L("private", !0), L("type", "module"), R("build", "shx rm -rf dist && pl-tengo build"), R("check", "pl-tengo check"), R("format", "/usr/bin/env emacs --script ./format.el || echo 'No emacs.'"), x(({ ctx: e }) => !e.isSdkInternal, () => x(S(Q), () => {
+		R("test", "vitest run --passWithNoTests"), W({ vitest: "catalog:" });
+	}, () => U("vitest"))), V("@platforma-sdk/workflow-tengo", "sdk:"), Ct("software"), W({
 		"@platforma-sdk/tengo-builder": "sdk:",
 		"@platforma-sdk/test": "sdk:",
 		shx: "catalog:"
-	}), Hn(), K("dependencies"), K("devDependencies"), K("peerDependencies"), K("optionalDependencies"), G([...Y]);
+	}), Ln(), q("dependencies"), q("devDependencies"), q("peerDependencies"), q("optionalDependencies"), K([...X]);
 }
 //#endregion
 //#region src/structure/rules/workflow.ts
-function mr() {
-	y("workflow", () => {
-		S("format.el", E("workflow/format.el")), b(({ ctx: e }) => !e.isSdkInternal, () => b(x(Z), () => {
-			S("tsconfig.json", E("workflow/tsconfig.json")), Ze("vitest.config.mts", E("workflow/vitest.config.mts"));
+function _r() {
+	b("workflow", () => {
+		C("format.el", O("workflow/format.el")), x(({ ctx: e }) => !e.isSdkInternal, () => x(S(Q), () => {
+			C("tsconfig.json", O("workflow/tsconfig.json")), T("vitest.config.mts", O("workflow/vitest.config.mts"));
 		}, () => {
-			T("tsconfig.json"), T("vitest.config.mts");
-		})), T("index.js"), T("index.d.ts"), w("src/main.tpl.tengo", D("workflow/src/main.tpl.tengo", (e) => ({ shortName: e.blockVars.shortName }))), C("package.json", O((e) => fr(e)), () => {
-			pr();
+			D("tsconfig.json"), D("vitest.config.mts");
+		})), D("index.js"), D("index.d.ts"), E("src/main.tpl.tengo", k("workflow/src/main.tpl.tengo", (e) => ({ shortName: e.blockVars.shortName }))), w("package.json", A((e) => hr(e)), () => {
+			gr();
 		});
 	});
 }
 //#endregion
 //#region src/structure/rules/test-package-json.ts
-function hr(e) {
+function vr(e) {
 	return {
 		name: `${e.blockVars.facadeName}.test`,
-		version: "1.0.0",
 		private: !0,
 		type: "module",
 		scripts: {
@@ -1991,26 +1771,26 @@ function hr(e) {
 		}
 	};
 }
-function gr() {
-	F("type", "module"), I("fmt", "ts-builder format"), I("check", "ts-builder check --target block-test"), I("test", "vitest run --passWithNoTests"), L("lint"), H({
+function yr() {
+	L("private", !0), L("type", "module"), R("fmt", "ts-builder format"), R("check", "ts-builder check --target block-test"), R("test", "vitest run --passWithNoTests"), z("lint"), W({
 		"@platforma-sdk/test": "sdk:",
 		"@milaboratories/ts-builder": "sdk:",
 		"@milaboratories/ts-configs": "sdk:",
 		vitest: "catalog:"
-	}), U({ typescript: "*" }), V("@types/node"), Hn(), K("dependencies"), K("devDependencies"), K("peerDependencies"), K("optionalDependencies"), G([...Y]);
+	}), G({ typescript: "*" }), U("@types/node"), Ln(), q("dependencies"), q("devDependencies"), q("peerDependencies"), q("optionalDependencies"), K([...X]);
 }
 //#endregion
 //#region src/structure/rules/test.ts
-function _r() {
-	y("test", () => {
-		S("tsconfig.json", E("test/tsconfig.json")), S(".oxlintrc.json", E("test/.oxlintrc.json")), S(".oxfmtrc.json", E("test/.oxfmtrc.json")), Ze("vitest.config.mts", E("test/vitest.config.mts")), w("src/demo.test.ts", $e("import { expect, test } from \"vitest\";\n\ntest(\"scaffolded block sanity check\", () => {\n  expect(true).toBe(true);\n});\n")), C("package.json", O((e) => hr(e)), () => {
-			gr();
+function br() {
+	b("test", () => {
+		C("tsconfig.json", O("test/tsconfig.json")), C(".oxlintrc.json", O("test/.oxlintrc.json")), C(".oxfmtrc.json", O("test/.oxfmtrc.json")), T("vitest.config.mts", O("test/vitest.config.mts")), E("src/demo.test.ts", Ge("import { expect, test } from \"vitest\";\n\ntest(\"scaffolded block sanity check\", () => {\n  expect(true).toBe(true);\n});\n")), w("package.json", A((e) => vr(e)), () => {
+			yr();
 		});
 	});
 }
 //#endregion
 //#region src/structure/rules/software-package-json.ts
-function vr() {
+function xr() {
 	return { entrypoints: { main: { binary: {
 		artifact: {
 			type: "python",
@@ -2025,10 +1805,10 @@ function vr() {
 		cmd: ["python", "{pkg}/main.py"]
 	} } } };
 }
-function yr(e) {
+function Sr(e) {
 	return {
 		name: `${e.blockVars.facadeName}.software`,
-		version: "1.0.0",
+		private: !0,
 		type: "module",
 		description: "Block Software",
 		files: ["./dist/**/*"],
@@ -2038,56 +1818,56 @@ function yr(e) {
 			changeset: "changeset",
 			"version-packages": "changeset version"
 		},
-		"block-software": vr(),
+		"block-software": xr(),
 		devDependencies: {
 			"@platforma-open/milaboratories.runenv-python-3": "catalog:",
 			"@platforma-sdk/package-builder": "sdk:"
 		}
 	};
 }
-function br() {
-	F("type", "module"), F("files", ["./dist/**/*"]), I("build", "pl-pkg build"), I("prepublishOnly", "pl-pkg prepublish"), I("changeset", "changeset"), I("version-packages", "changeset version"), H({
+function Cr() {
+	L("private", !0), L("type", "module"), L("files", ["./dist/**/*"]), R("build", "pl-pkg build"), R("prepublishOnly", "pl-pkg prepublish"), R("changeset", "changeset"), R("version-packages", "changeset version"), W({
 		"@platforma-open/milaboratories.runenv-python-3": "catalog:",
 		"@platforma-sdk/package-builder": "sdk:"
-	}), K("dependencies"), K("devDependencies"), K("peerDependencies"), K("optionalDependencies"), G([...Y]);
+	}), q("dependencies"), q("devDependencies"), q("peerDependencies"), q("optionalDependencies"), K([...X]);
 }
 //#endregion
 //#region src/structure/rules/software.ts
-var xr = "import sys\n\nprint(\"Hello from Python, \" + sys.argv[1] + \"!\")\n", Sr = "# No dependencies specified for this script\n";
-function Cr() {
-	y("software", () => {
-		w("src/main.py", $e(xr)), w("src/requirements.txt", $e(Sr)), C("package.json", O((e) => yr(e)), () => {
-			br();
+var wr = "import sys\n\nprint(\"Hello from Python, \" + sys.argv[1] + \"!\")\n", Tr = "# No dependencies specified for this script\n";
+function Er() {
+	b("software", () => {
+		E("src/main.py", Ge(wr)), E("src/requirements.txt", Ge(Tr)), w("package.json", A((e) => Sr(e)), () => {
+			Cr();
 		});
 	});
 }
-function wr() {
-	y("model", () => {
-		T("eslint.config.mjs"), T("vite.config.mts");
-	}), y("ui", () => {
-		T("eslint.config.mjs"), T("vite.config.ts"), T("tsconfig.app.json"), T("tsconfig.node.json");
-	}), y("test", () => {
-		T("eslint.config.mjs");
-	}), y("root", () => {
-		T(".prettierrc"), C("package.json", O((e) => En(e)), () => {
-			L("pretty"), V("@platforma-sdk/blocks-deps-updater");
+function Dr() {
+	b("model", () => {
+		D("eslint.config.mjs"), D("vite.config.mts");
+	}), b("ui", () => {
+		D("eslint.config.mjs"), D("vite.config.ts"), D("tsconfig.app.json"), D("tsconfig.node.json");
+	}), b("test", () => {
+		D("eslint.config.mjs");
+	}), b("root", () => {
+		D(".prettierrc"), w("package.json", A((e) => xn(e)), () => {
+			z("pretty"), U("@platforma-sdk/blocks-deps-updater");
 		});
 	});
 }
 //#endregion
 //#region src/structure/rules/root-catalog-bump.ts
-function Tr() {
-	Xe(() => {
-		y("root", () => {
-			b(({ ctx: e }) => !e.isSdkInternal, () => {
-				C("pnpm-workspace.yaml", O((e) => Jn(e)), (e) => {
-					for (let e of X) It(e);
-					for (let e of Gn) Lt(e.entry, {
+function Or() {
+	Ue(() => {
+		b("root", () => {
+			x(({ ctx: e }) => !e.isSdkInternal, () => {
+				w("pnpm-workspace.yaml", A((e) => Un(e)), (e) => {
+					for (let e of Z) jt(e);
+					for (let e of Bn) Mt(e.entry, {
 						of: e.of,
 						ofVersion: e.ofVersion
 					});
-					for (let [e, t] of Object.entries(Wn)) Ft(e, t);
-					e.modules.some((e) => e.scope === "software") && Ft(Kn, qn);
+					for (let [e, t] of Object.entries(zn)) At(e, t);
+					e.modules.some((e) => e.scope === "software") && At(Vn, Hn);
 				});
 			});
 		});
@@ -2095,25 +1875,25 @@ function Tr() {
 }
 //#endregion
 //#region src/structure/structure-definition.ts
-var Er = Ue(() => {
-	Qn(), er(), ar(), cr(), dr(), mr(), _r(), Cr(), wr(), Tr();
+var kr = Ie(() => {
+	qn(), Yn(), cr(), dr(), mr(), _r(), br(), Er(), Dr(), Or();
 });
 //#endregion
 //#region src/structure/cli/run-structure.ts
-async function Dr() {
-	return Rn(X.filter(Ln));
+async function Ar() {
+	return Nn(Z.filter(Mn));
 }
-async function Or(e) {
-	let t = p.resolve(e.blockPath), n = e.mode === "check", r = new Oe(t), i = new ke(e.templatesRoot), a = on(Er, r, Tn({
+async function jr(e) {
+	let t = m.resolve(e.blockPath), n = e.mode === "check", r = new xe(t), i = new Se(e.templatesRoot), a = en(kr, r, bn({
 		fs: r,
 		isSdkInternal: e.isSdkInternal,
 		updateDepsOnly: e.updateDepsOnly,
 		dryRun: n
 	}), {
 		templates: i,
-		registryLookup: e.updateDepsOnly ? await Dr() : void 0,
-		derivedPinLookup: e.updateDepsOnly ? await Bn(Gn) : void 0,
-		rediscover: () => Tn({
+		registryLookup: e.updateDepsOnly ? await Ar() : void 0,
+		derivedPinLookup: e.updateDepsOnly ? await Fn(Bn) : void 0,
+		rediscover: () => bn({
 			fs: r,
 			isSdkInternal: e.isSdkInternal,
 			updateDepsOnly: !1,
@@ -2125,61 +1905,188 @@ async function Or(e) {
 		changes: a.changes
 	};
 }
-function kr(e, t) {
+function Mr(e, t) {
 	if (t.length === 0) return `  ${e}: up to date (0 changes)`;
 	let n = t.map((e) => `    ${e.action.padEnd(6)} ${e.primitive.padEnd(8)} ${e.path} [${e.scope}]`);
 	return `  ${e}: ${t.length} change(s)\n${n.join("\n")}`;
 }
 //#endregion
+//#region src/cmd/structure/refresh.ts
+async function Nr(e) {
+	for (let t of e.paths) {
+		let n = await jr({
+			blockPath: t,
+			isSdkInternal: e.isSdkInternal,
+			updateDepsOnly: e.updateDepsOnly,
+			mode: "refresh",
+			templatesRoot: e.templatesRoot,
+			log: (t) => e.logger.info(t)
+		});
+		e.logger.info(Mr(t, n.changes));
+	}
+}
+function Pr(e) {
+	let t = new f("refresh").description("Bring block(s) up to date with the canonical structure. Applies rules, writes files, bumps .structure version. Default mode is offline; --update-deps-only fires only catalog-bump rules (network).");
+	return t.argument("[paths...]", "block path(s); defaults to the current directory"), t.option("--sdk-internal", "block(s) live inside the SDK monorepo; skip root-scope rules"), t.option("--update-deps-only", "fire ONLY catalog-bump rules (npm network). Follow with `pnpm install` then a plain refresh."), t.action(async (t, n) => {
+		let r = t.length > 0 ? t : ["."], i = m.join(e, "src", "structure", "templates");
+		await Nr({
+			paths: r,
+			isSdkInternal: !!n.sdkInternal,
+			updateDepsOnly: !!n.updateDepsOnly,
+			templatesRoot: i,
+			logger: new g()
+		});
+	}), t;
+}
+//#endregion
+//#region src/cmd/update-deps.ts
+function Fr(e) {
+	let t = new f("update-deps").description("[DEPRECATED] Use `block-tools structure refresh --update-deps-only`. This alias delegates to it.");
+	return t.action(async () => {
+		let t = new g();
+		t.warn("`block-tools update-deps` is deprecated and will be removed in a future release. Use `block-tools structure refresh --update-deps-only` instead. Delegating now."), await Nr({
+			paths: ["."],
+			isSdkInternal: !1,
+			updateDepsOnly: !0,
+			templatesRoot: m.join(e, "src", "structure", "templates"),
+			logger: t
+		});
+	}), t;
+}
+//#endregion
+//#region src/cmd/list-overview-snapshots.ts
+function Ir() {
+	let e = new f("list-overview-snapshots").description("List all available global overview snapshots in the registry");
+	return e.addOption(new p("-r, --registry <address>", "full address of the registry").env("PL_REGISTRY").makeOptionMandatory()), e.option("--json", "output in JSON format", !1), e.action(async (e) => {
+		let t = new g(), n = await new s(o(e.registry), t).listGlobalOverviewSnapshots();
+		if (e.json) t.info(JSON.stringify(n, null, 2));
+		else if (n.length === 0) t.info("No snapshots found.");
+		else {
+			t.info(`Found ${n.length} snapshot(s):\n`);
+			for (let e of n) t.info(`  ${e.timestamp}`), t.info(`    Path: ${e.path}`), t.info("");
+		}
+	}), e;
+}
+//#endregion
+//#region src/cmd/restore-overview-from-snapshot.ts
+function Lr() {
+	let e = new f("restore-overview-from-snapshot").description("Restore global overview from a snapshot");
+	return e.addOption(new p("-r, --registry <address>", "full address of the registry").env("PL_REGISTRY").makeOptionMandatory()), e.requiredOption("-s, --snapshot <timestamp>", "snapshot timestamp ID to restore from"), e.option("--skip-confirmation", "skip confirmation prompt (use with caution)", !1), e.action(async (e) => {
+		let t = new g(), n = new s(o(e.registry), t), r = await n.listGlobalOverviewSnapshots();
+		if (!r.find((t) => t.timestamp === e.snapshot)) throw Error(`Snapshot '${e.snapshot}' not found. Available snapshots:\n${r.map((e) => `  - ${e.timestamp}`).join("\n") || "  (none)"}`);
+		if (!e.skipConfirmation) {
+			let n = (await import("node:readline")).createInterface({
+				input: process.stdin,
+				output: process.stdout
+			}), r = await new Promise((t) => {
+				n.question(`⚠️  This will overwrite the current global overview with snapshot '${e.snapshot}'.\nAre you sure you want to continue? (y/N): `, t);
+			});
+			if (n.close(), r.toLowerCase() !== "y" && r.toLowerCase() !== "yes") {
+				t.info("Restore cancelled.");
+				return;
+			}
+		}
+		try {
+			await n.restoreGlobalOverviewFromSnapshot(e.snapshot), t.info(`✅ Successfully restored global overview from snapshot '${e.snapshot}'`);
+		} catch (e) {
+			throw Error(`Failed to restore from snapshot: ${String(e)}`);
+		}
+	}), e;
+}
+//#endregion
+//#region src/registry_v1/flags.ts
+function Rr(e) {
+	let t = e.match(/(?<destName>[^/\\]+)=(?<src>.*)/);
+	if (t) {
+		let { src: e, destName: n } = t.groups;
+		return {
+			src: e,
+			destName: n
+		};
+	} else return {
+		src: e,
+		destName: m.basename(e)
+	};
+}
+function zr(e, t) {
+	return new p(e, t).argParser((e, t) => [...t ?? [], Rr(e)]).default([]);
+}
+//#endregion
+//#region src/cmd/upload-package-v1.ts
+var Br = [
+	"registry",
+	"organization",
+	"package",
+	"version"
+];
+function Vr() {
+	let e = new f("upload-package-v1").description("Uploads V1 package and refreshes the registry");
+	return e.addOption(new p("-r, --registry <address|alias>", "full address of the registry or alias from .pl.reg").env("PL_REGISTRY")), e.addOption(new p("-o, --organization <organization>", "target organisation").env("PL_PACKAGE_ORGANIZATION")), e.addOption(new p("-p, --package <package>", "target package").env("PL_PACKAGE_NAME")), e.addOption(new p("-v, --version <version>", "target version").env("PL_PACKAGE_VERSION")), e.option("-m, --meta <path>", "json file containing meta information to associate with tha package"), e.addOption(zr("-f, --file <file>", "package files")), e.addOption(new p("--refresh", "refresh repository after adding the package").default(!0).env("PL_REGISTRY_REFRESH")), e.option("--no-refresh", "do not refresh repository after adding the package"), e.action(async (e) => {
+		let t = new g(), n = l.parse({});
+		for (let t of Br) e[t] && (n[t] = e[t]);
+		e.meta && (e.meta.endsWith(".json") ? n.meta = JSON.parse(await h.promises.readFile(e.meta, { encoding: "utf-8" })) : e.meta.endsWith(".yaml") && (n.meta = ae.parse(await h.promises.readFile(e.meta, { encoding: "utf-8" }))));
+		for (let t of e.file) n.files[t.destName] = t.src;
+		let r = await c(n);
+		t.info(ae.stringify(r.conf));
+		let i = r.createRegistry(t), a = r.fullPackageName, o = i.constructNewPackage(a);
+		for (let [e, n] of Object.entries(r.conf.files)) {
+			t.info(`Uploading ${n} -> ${e} ...`);
+			let r = await h.promises.readFile(n);
+			await o.addFile(e, r);
+		}
+		t.info("Uploading meta information..."), await o.writeMeta(r.conf.meta), await o.finish(), e.refresh && await i.updateIfNeeded();
+	}), e;
+}
+//#endregion
 //#region src/cmd/structure/check.ts
-var Ar = class e extends d {
-	static description = "Check block(s) against the canonical structure (read-only). Exits non-zero if any diff would land — used as the CI gate.";
-	static examples = ["<%= config.bin %> <%= command.id %> ./my-block", "<%= config.bin %> <%= command.id %> --sdk-internal etc/blocks/*"];
-	static strict = !1;
-	static flags = { "sdk-internal": f.boolean({ description: "block(s) live inside the SDK monorepo; skip root-scope rules" }) };
-	async run() {
-		let { argv: t, flags: n } = await this.parse(e), r = t.length > 0 ? t : ["."], i = p.join(this.config.root, "src", "structure", "templates"), a = !1;
-		for (let e of r) {
-			let t = await Or({
+function Hr(e) {
+	let t = new f("check").description("Check block(s) against the canonical structure (read-only). Exits non-zero if any diff would land — used as the CI gate.");
+	return t.argument("[paths...]", "block path(s); defaults to the current directory"), t.option("--sdk-internal", "block(s) live inside the SDK monorepo; skip root-scope rules"), t.action(async (t, n) => {
+		let r = new g(), i = t.length > 0 ? t : ["."], a = m.join(e, "src", "structure", "templates"), o = !1;
+		for (let e of i) {
+			let t = await jr({
 				blockPath: e,
-				isSdkInternal: n["sdk-internal"],
+				isSdkInternal: !!n.sdkInternal,
 				updateDepsOnly: !1,
 				mode: "check",
-				templatesRoot: i,
-				log: (e) => this.log(e)
+				templatesRoot: a,
+				log: (e) => r.info(e)
 			});
-			this.log(kr(e, t.changes)), t.changes.length > 0 && (a = !0);
+			r.info(Mr(e, t.changes)), t.changes.length > 0 && (o = !0);
 		}
-		a && this.error("Structure check failed: one or more blocks are out of date. Run `structure refresh`.", { exit: 1 });
-	}
-}, Q = ["python"], jr = class extends Error {
+		if (o) throw Error("Structure check failed: one or more blocks are out of date. Run `structure refresh`.");
+	}), t;
+}
+//#endregion
+//#region src/structure/init-block-constructor.ts
+var $ = ["python"], Ur = class extends Error {
 	constructor(e) {
 		super(`Missing required flag --${e} in --non-interactive mode. Supply every BlockVars flag, or drop --non-interactive to be prompted.`), this.name = "InitFlagError";
 	}
 };
-async function $(e, t, n, r) {
+async function Wr(e, t, n, r) {
 	if (e !== void 0 && e !== "") return e;
-	if (n) throw new jr(t);
+	if (n) throw new Ur(t);
 	return r();
 }
-async function Mr(e) {
-	let t = await $(e.npmOrg, "npm-org", e.nonInteractive, () => de({
+async function Gr(e) {
+	let t = await Wr(e.npmOrg, "npm-org", e.nonInteractive, () => de({
 		message: "npm org (e.g. @platforma-open):",
 		default: "@platforma-open"
-	})), n = await $(e.orgScope, "org-scope", e.nonInteractive, () => de({ message: "org scope (e.g. my-org):" })), r = await $(e.shortName, "short-name", e.nonInteractive, () => de({ message: "block short name (e.g. mixcr-clonotyping):" })), i;
+	})), n = await Wr(e.orgScope, "org-scope", e.nonInteractive, () => de({ message: "org scope (e.g. my-org):" })), r = await Wr(e.shortName, "short-name", e.nonInteractive, () => de({ message: "block short name (e.g. mixcr-clonotyping):" })), i;
 	i = e.withSoftware === void 0 ? e.nonInteractive ? !1 : await ue({
 		message: "Include a software module?",
 		default: !1
 	}) : e.withSoftware;
 	let a;
 	if (i) {
-		if (a = await $(e.platform, "platform", e.nonInteractive, () => fe({
+		if (a = await Wr(e.platform, "platform", e.nonInteractive, () => fe({
 			message: "Software platform:",
-			choices: Q.map((e) => ({
+			choices: $.map((e) => ({
 				name: e,
 				value: e
 			}))
-		})), !Q.includes(a)) throw Error(`Unsupported --platform '${a}'. Only ${Q.join(", ")} ${Q.length === 1 ? "is" : "are"} supported at v1.`);
+		})), !$.includes(a)) throw Error(`Unsupported --platform '${a}'. Only ${$.join(", ")} ${$.length === 1 ? "is" : "are"} supported at v1.`);
 	} else if (e.platform) throw Error("--platform was given but software is disabled (--no-software).");
 	return {
 		facadeName: `${t}/${n}.${r}`,
@@ -2190,20 +2097,20 @@ async function Mr(e) {
 		softwarePlatform: a
 	};
 }
-async function Nr(e) {
-	let t = e.vars, n = gn(t), r = new Oe(e.blockPath), i = new ke(e.templatesRoot), a = _n({
+async function Kr(e) {
+	let t = e.vars, n = dn(t), r = new xe(e.blockPath), i = new Se(e.templatesRoot), a = fn({
 		blockVars: t,
 		modules: n,
 		isSdkInternal: !1,
 		version: 1,
 		dryRun: !1
-	}), o = X.filter(Ln), s, c;
+	}), o = Z.filter(Mn), s, c;
 	try {
-		s = await Rn(o), c = await Bn(Gn);
+		s = await Nn(o), c = await Fn(Bn);
 	} catch (e) {
 		throw Error(`init requires network access to resolve SDK catalog versions from npm, but the registry lookup failed: ${e instanceof Error ? e.message : String(e)}`);
 	}
-	return on(Er, r, a, {
+	return en(kr, r, a, {
 		templates: i,
 		initMode: !0,
 		registryLookup: s,
@@ -2211,83 +2118,40 @@ async function Nr(e) {
 	}), e.log(`Initialised block '${t.facadeName}'${t.softwarePlatform ? ` (software: ${t.softwarePlatform})` : " (no software)"} at ${e.blockPath}`), t;
 }
 //#endregion
-//#region src/cmd/index.ts
-var Pr = {
-	"build-meta": pe,
-	"build-model": he,
-	"list-overview-snapshots": ge,
-	"mark-stable": _e,
-	pack: ve,
-	publish: be,
-	"refresh-registry": xe,
-	"restore-overview-from-snapshot": Se,
-	"update-deps": Ce,
-	"upload-package-v1": De,
-	"structure:check": Ar,
-	"structure:init": class e extends d {
-		static description = "Scaffold a fresh Platforma block from the canonical structure. Missing flags are prompted unless --non-interactive.";
-		static examples = ["<%= config.bin %> <%= command.id %> --npm-org @platforma-open --org-scope my-org --short-name demo --no-software --non-interactive", "<%= config.bin %> <%= command.id %> ./demo --npm-org @platforma-open --org-scope my-org --short-name demo --with-software --platform python --non-interactive"];
-		static args = { path: u.string({ description: "target directory (default: <short-name> under the current directory)" }) };
-		static flags = {
-			"npm-org": f.string({ description: "npm org, e.g. @platforma-open" }),
-			"org-scope": f.string({ description: "org scope, e.g. my-org" }),
-			"short-name": f.string({ description: "block short name, e.g. mixcr-clonotyping" }),
-			"with-software": f.boolean({ description: "include a software module" }),
-			"no-software": f.boolean({ description: "omit the software module" }),
-			platform: f.string({
-				description: "software platform (single-valued)",
-				options: [...Q]
-			}),
-			"non-interactive": f.boolean({ description: "error on any missing flag instead of prompting" })
-		};
-		async run() {
-			let { args: t, flags: n } = await this.parse(e);
-			n["with-software"] && n["no-software"] && this.error("--with-software and --no-software are mutually exclusive.");
-			let r = n["with-software"] ? !0 : n["no-software"] ? !1 : void 0, i = await Mr({
-				npmOrg: n["npm-org"],
-				orgScope: n["org-scope"],
-				shortName: n["short-name"],
-				withSoftware: r,
-				platform: n.platform,
-				nonInteractive: n["non-interactive"]
-			});
-			await Nr({
-				vars: i,
-				blockPath: t.path ? p.resolve(t.path) : p.resolve(process.cwd(), i.shortName),
-				templatesRoot: p.join(this.config.root, "src", "structure", "templates"),
-				log: (e) => this.log(e)
-			});
-		}
-	},
-	"structure:refresh": class e extends d {
-		static description = "Bring block(s) up to date with the canonical structure. Applies rules, writes files, bumps .structure version. Default mode is offline; --update-deps-only fires only catalog-bump rules (network).";
-		static examples = [
-			"<%= config.bin %> <%= command.id %> ./my-block",
-			"<%= config.bin %> <%= command.id %> --sdk-internal etc/blocks/*",
-			"<%= config.bin %> <%= command.id %> --update-deps-only"
-		];
-		static strict = !1;
-		static flags = {
-			"sdk-internal": f.boolean({ description: "block(s) live inside the SDK monorepo; skip root-scope rules" }),
-			"update-deps-only": f.boolean({ description: "fire ONLY catalog-bump rules (npm network). Follow with `pnpm install` then a plain refresh." })
-		};
-		async run() {
-			let { argv: t, flags: n } = await this.parse(e), r = t.length > 0 ? t : ["."], i = p.join(this.config.root, "src", "structure", "templates");
-			for (let e of r) {
-				let t = await Or({
-					blockPath: e,
-					isSdkInternal: n["sdk-internal"],
-					updateDepsOnly: n["update-deps-only"],
-					mode: "refresh",
-					templatesRoot: i,
-					log: (e) => this.log(e)
-				});
-				this.log(kr(e, t.changes));
-			}
-		}
-	}
-};
+//#region src/cmd/structure/init.ts
+function qr(e) {
+	let t = new f("init").description("Scaffold a fresh Platforma block from the canonical structure. Missing flags are prompted unless --non-interactive.");
+	return t.argument("[path]", "target directory (default: <short-name> under the current directory)"), t.option("--npm-org <org>", "npm org, e.g. @platforma-open"), t.option("--org-scope <scope>", "org scope, e.g. my-org"), t.option("--short-name <name>", "block short name, e.g. mixcr-clonotyping"), t.option("--with-software", "include a software module"), t.option("--no-software", "omit the software module"), t.addOption(new p("--platform <platform>", "software platform (single-valued)").choices([...$])), t.option("--non-interactive", "error on any missing flag instead of prompting"), t.action(async (t, n) => {
+		let r = new g(), i = n.withSoftware === !0, a = n.software === !1;
+		if (i && a) throw Error("--with-software and --no-software are mutually exclusive.");
+		let o = i ? !0 : a ? !1 : void 0, s = await Gr({
+			npmOrg: n.npmOrg,
+			orgScope: n.orgScope,
+			shortName: n.shortName,
+			withSoftware: o,
+			platform: n.platform,
+			nonInteractive: n.nonInteractive
+		});
+		await Kr({
+			vars: s,
+			blockPath: t ? m.resolve(t) : m.resolve(process.cwd(), s.shortName),
+			templatesRoot: m.join(e, "src", "structure", "templates"),
+			log: (e) => r.info(e)
+		});
+	}), t;
+}
+//#endregion
+//#region src/cli.ts
+function Jr(e = process.cwd()) {
+	let t = new f();
+	t.name("block-tools").description("Utility to manipulate Platforma Blocks and Block Registry"), t.addCommand(pe()), t.addCommand(he()), t.addCommand(ge()), t.addCommand(ve()), t.addCommand(ye()), t.addCommand(be()), t.addCommand(Fr(e)), t.addCommand(Ir()), t.addCommand(Lr()), t.addCommand(Vr());
+	let n = new f("structure").description("Manage block scaffolding against the canonical structure (check / init / refresh)");
+	return n.addCommand(Hr(e)), n.addCommand(qr(e)), n.addCommand(Pr(e)), t.addCommand(n), t;
+}
+async function Yr(e, t) {
+	await Jr(t).parseAsync(e);
+}
 //#endregion
-export { Pr as COMMANDS };
+export { Jr as buildProgram, Yr as run };
 
 //# sourceMappingURL=cli.mjs.map