yugoo-design 0.1.2 → 0.2.2

package/payload/shared/scripts/studio-panel-drafts-Cu48ih5u.mjs

@@ -1,787 +0,0 @@
-import { Q as pointerKey } from "./core-entry-B6zaTh1o.mjs";
-import { t as loadStudioKit } from "./load-DE29wyw0.mjs";
-import { n as prepareStudioPanelPreview } from "./panel-preview-CPGv8nTe.mjs";
-import { i as readStudioContentArchive, r as readStudioArchiveResource } from "./content-archive-4UdioMU9.mjs";
-import { isAbsolute, join, relative, resolve, sep } from "node:path";
-import { lstat, mkdir, open, readFile, readdir, realpath, rename, rmdir, unlink } from "node:fs/promises";
-import { createHash, randomUUID } from "node:crypto";
-//#region packages/core/src/knowledge-declaration-diagnostics.ts
-function locate(root, path) {
-	let current = root;
-	for (const key of path.split(".").filter(Boolean)) {
-		if (!current) return;
-		const child = current.spec.properties?.[key];
-		if (!child) return;
-		current = {
-			spec: child,
-			pointer: `${current.pointer}/properties/${pointerKey(key)}`,
-			metadata: current.metadata || child.knowledge?.role === "metadata"
-		};
-	}
-	return current;
-}
-/**
-* A direct single-collection selector already declares identifier semantics.
-* Compare it with the owning schema, not names, labels, sample values or graph size.
-* Multi-target selectors, native/absent panels, external/free-form references and
-* explicitly metadata-owned values are outside this bounded diagnostic.
-*/
-function diagnoseKnowledgeDeclarations(skills) {
-	const definitions = new Map(skills.flatMap((skill) => {
-		const schema = skill.metadata?.schemaDocument;
-		const panel = skill.metadata?.panelManifest;
-		return schema && panel ? [[skill.name, {
-			schema,
-			panel
-		}]] : [];
-	}));
-	const candidates = /* @__PURE__ */ new Map();
-	const multiTarget = /* @__PURE__ */ new Set();
-	for (const [name, { schema, panel }] of definitions) {
-		if (schema.knowledge?.source_kind === "derived") continue;
-		const root = {
-			spec: schema,
-			pointer: "",
-			metadata: schema.knowledge?.role === "metadata"
-		};
-		for (const field of panel.fields) {
-			if (!["record_select", "record_multi_select"].includes(field.control)) continue;
-			const multiple = Array.isArray(field.options_from_sections) && field.options_from_sections.length > 1;
-			const owner = field.options_from_panel?.panel_type ?? name;
-			const target = definitions.get(owner);
-			const sectionId = field.options_from_panel?.section_id ?? field.options_from_section;
-			const targetSection = target?.panel.sections.find((section) => section.id === sectionId);
-			const targetPath = targetSection && (targetSection.records_path ?? targetSection.id);
-			const targetSchema = targetPath && target ? locate({
-				spec: target.schema,
-				pointer: "",
-				metadata: target.schema.knowledge?.role === "metadata"
-			}, targetPath) : void 0;
-			const expected = targetPath && targetSchema?.spec.type === "map" && !targetSchema.metadata ? `${owner}/${owner}.json#/${targetPath.split(".").map(pointerKey).join("/")}` : void 0;
-			for (const section of panel.sections) {
-				if (field.applies_to && !field.applies_to.includes(section.id)) continue;
-				const collection = locate(root, section.records_path ?? section.id);
-				if (collection?.spec.type !== "map" || !collection.spec.value) continue;
-				const value = collection.spec.value;
-				let leaf = locate(locate({
-					spec: value,
-					pointer: `${collection.pointer}/value`,
-					metadata: collection.metadata || value.knowledge?.role === "metadata"
-				}, section.fields_path ?? ""), field.key);
-				if (field.control === "record_multi_select" && leaf?.spec.type === "array" && leaf.spec.items) leaf = {
-					spec: leaf.spec.items,
-					pointer: `${leaf.pointer}/items`,
-					metadata: leaf.metadata || leaf.spec.items.knowledge?.role === "metadata"
-				};
-				if (!leaf || leaf.spec.type !== "string" || leaf.metadata) continue;
-				const key = JSON.stringify([name, leaf.pointer]);
-				if (multiple) {
-					multiTarget.add(key);
-					continue;
-				}
-				if (!expected) continue;
-				const previous = candidates.get(key);
-				if (previous) previous.targets.add(expected);
-				else candidates.set(key, {
-					subject: name,
-					schema: leaf,
-					section: section.id,
-					field: field.key,
-					targets: /* @__PURE__ */ new Set([expected])
-				});
-			}
-		}
-	}
-	const diagnostics = [];
-	for (const [key, candidate] of candidates) {
-		if (multiTarget.has(key) || candidate.targets.size !== 1) continue;
-		const expectedTarget = [...candidate.targets][0];
-		const semantics = candidate.schema.spec.knowledge;
-		const declared = semantics?.target?.startsWith("#") ? `${candidate.subject}/${candidate.subject}.json${semantics.target}` : semantics?.target;
-		const code = semantics?.role !== "reference" ? "knowledge.reference_role" : declared !== expectedTarget ? "knowledge.reference_target" : void 0;
-		if (!code) continue;
-		diagnostics.push({
-			code,
-			subject: candidate.subject,
-			schemaPointer: candidate.schema.pointer,
-			panelSection: candidate.section,
-			field: candidate.field,
-			expectedTarget,
-			message: `${candidate.subject}/schema.yaml#${candidate.schema.pointer}: panel.yaml section ${candidate.section} field ${candidate.field} selects records from ${expectedTarget}; ${code === "knowledge.reference_role" ? "the schema does not declare knowledge.role: reference" : `knowledge.target is ${JSON.stringify(semantics?.target ?? null)}`}. Review the owning declaration; no schema or Design Files were changed.`
-		});
-	}
-	return diagnostics.sort((a, b) => a.subject.localeCompare(b.subject) || a.schemaPointer.localeCompare(b.schemaPointer));
-}
-//#endregion
-//#region packages/studio/src/panel-drafts.ts
-/** Host-neutral, versioned Panel working copies; not Kit publication. */
-function checkText$1(panelSource, sampleSource) {
-	if (typeof panelSource !== "string" || typeof sampleSource !== "string" || new TextEncoder().encode(panelSource).length > 1048576 || new TextEncoder().encode(sampleSource).length > 262144) throw new Error("Panel source must be text ≤1 MiB; sample JSON text ≤256 KiB.");
-}
-function checkRevision$1(record, expected) {
-	if (!Number.isSafeInteger(expected) || record.revision !== expected) throw new Error("Draft changed elsewhere. Reopen the latest revision before saving.");
-}
-function content$1(record) {
-	const { id: _id, revision: _revision, ...value } = record;
-	return value;
-}
-/** Shared semantics used by host adapters; no filesystem or runtime tool access. */
-var StudioPanelDraftService = class {
-	repository;
-	sources;
-	constructor(repository, sources) {
-		this.repository = repository;
-		this.sources = sources;
-	}
-	async list() {
-		return (await this.repository.list()).map(({ id, revision, kit, bundle, confirmed }) => ({
-			id,
-			revision,
-			kit,
-			bundle,
-			confirmed
-		}));
-	}
-	read(id) {
-		return this.repository.read(id);
-	}
-	async create(input) {
-		const kitPin = { ...input.kit }, bundlePin = { ...input.bundle };
-		if (!/^[a-z][a-z0-9_]*$/.test(bundlePin.name)) throw new Error("Select an exact Bundle identity.");
-		const sampleSource = input.sampleSource;
-		const snapshot = await this.sources.capture(kitPin);
-		return this.createRetained(snapshot, kitPin, bundlePin, sampleSource);
-	}
-	/** Open only the retained snapshot; imported/template pins need not be installed. */
-	async createFromSnapshot(input) {
-		const kit = { ...input.kit }, bundle = { ...input.bundle }, sampleSource = input.sampleSource;
-		if (!/^[a-z][a-z0-9_]*$/.test(bundle.name)) throw new Error("Select an exact Bundle identity.");
-		return this.createRetained(await this.sources.open(input.snapshotId), kit, bundle, sampleSource);
-	}
-	async createRetained(snapshot, kitPin, bundlePin, sampleSource) {
-		const kit = await loadStudioKit(snapshot.fs, snapshot.root, snapshot.loadOptions);
-		if (kit.name !== kitPin.name || String(kit.version) !== kitPin.version) throw new Error("Source does not match selected Kit pin.");
-		const bundle = kit.skills.find((entry) => entry.name === bundlePin.name && String(entry.version) === bundlePin.version);
-		if (!bundle || typeof bundle.metadata?.panelYaml !== "string") throw new Error("Select an installed declarative Bundle version.");
-		const panelSource = await snapshot.fs.readText(join(bundle.resourceRoot ?? join(snapshot.root, "skills", bundlePin.name), "panel.yaml"));
-		if (panelSource === void 0) throw new Error("Panel source is missing.");
-		const panel = bundle.metadata.panelManifest;
-		const sample = sampleSource ?? JSON.stringify(panel.initial_values ?? {}, null, 2);
-		checkText$1(panelSource, sample);
-		return this.repository.create({
-			kit: kitPin,
-			bundle: bundlePin,
-			baseSnapshot: snapshot.id,
-			panelSource,
-			sampleSource: sample,
-			confirmed: false
-		});
-	}
-	/** Saving incomplete source is allowed; confirmation requires successful compilation. */
-	async save(input) {
-		const { id, expectedRevision, panelSource, sampleSource } = input;
-		checkText$1(panelSource, sampleSource);
-		const current = await this.repository.read(id);
-		checkRevision$1(current, expectedRevision);
-		if (current.confirmed) throw new Error("Confirmed snapshot is locked. Create a new draft to edit it.");
-		return this.repository.replace(id, expectedRevision, {
-			...content$1(current),
-			panelSource,
-			sampleSource
-		});
-	}
-	/** Compile an unsaved editor revision without persisting or touching any project. */
-	async preview(input) {
-		const { id, expectedRevision, panelSource, sampleSource, revision } = input;
-		checkText$1(panelSource, sampleSource);
-		const current = await this.repository.read(id);
-		checkRevision$1(current, expectedRevision);
-		const snapshot = await this.sources.open(current.baseSnapshot);
-		return prepareStudioPanelPreview(snapshot.fs, snapshot.root, {
-			kit: current.kit,
-			bundle: current.bundle,
-			revision,
-			panelSource,
-			sampleSource
-		}, snapshot.loadOptions);
-	}
-	async confirm(input) {
-		const { id, expectedRevision } = input;
-		const current = await this.repository.read(id);
-		checkRevision$1(current, expectedRevision);
-		const result = await this.preview({
-			...current,
-			expectedRevision
-		});
-		if (!result.preview || result.diagnostics.length) return result;
-		const draft = current.confirmed ? current : await this.repository.replace(id, expectedRevision, {
-			...content$1(current),
-			confirmed: true
-		});
-		return {
-			...result,
-			draft
-		};
-	}
-	/** Start another editable revision, sharing the immutable base bytes. */
-	async fork(id) {
-		const current = await this.repository.read(id);
-		return this.repository.create({
-			...content$1(current),
-			confirmed: false
-		});
-	}
-};
-//#endregion
-//#region packages/studio/src/validate.ts
-/** Adapt shared, read-only declaration advice into the existing authoring report. */
-function knowledgeDeclarationWarnings(skills) {
-	return diagnoseKnowledgeDeclarations(skills).map(({ code, message, subject }) => ({
-		code,
-		message,
-		subject,
-		severity: "warning"
-	}));
-}
-//#endregion
-//#region packages/studio/src/kit-drafts.ts
-/** Kit-owned working-copy edits over retained source; never catalog publication. */
-function checkText(mindset, relations) {
-	if (typeof mindset !== "string" || relations !== null && typeof relations !== "string" || new TextEncoder().encode(mindset).length > 1048576 || relations !== null && new TextEncoder().encode(relations).length > 1048576) throw new Error("Kit-owned sources must be UTF-8 text of at most 1 MiB each.");
-}
-function checkRevision(current, expected) {
-	if (!Number.isSafeInteger(expected) || current.revision !== expected) throw new Error("Draft changed elsewhere. Reopen the latest revision.");
-}
-function content(record) {
-	const { id: _id, revision: _revision, ...value } = record;
-	return structuredClone(value);
-}
-function samePins(a, b) {
-	const keys = (pins) => pins.map((pin) => `${pin.name}@${pin.version}`).sort();
-	return JSON.stringify(keys(a)) === JSON.stringify(keys(b));
-}
-/** Only two Kit-owned files are overlaid; no user-supplied paths or live FS fallback. */
-function overlay(snapshot, record) {
-	const root = resolve(snapshot.root);
-	const replacements = /* @__PURE__ */ new Map([[resolve(root, "mindset.md"), record.mindsetSource], [resolve(root, "relations.yaml"), record.relationsSource]]);
-	return {
-		readText: (path) => replacements.has(resolve(path)) ? Promise.resolve(replacements.get(resolve(path)) ?? void 0) : snapshot.fs.readText(path),
-		...snapshot.fs.readResource ? { readResource: async (path) => {
-			if (!replacements.has(resolve(path))) return snapshot.fs.readResource(path);
-			const content = replacements.get(resolve(path));
-			return content == null ? void 0 : {
-				kind: "text",
-				content
-			};
-		} } : {},
-		async listDir(path) {
-			if (resolve(path) !== root) return snapshot.fs.listDir(path);
-			const entries = new Set(await snapshot.fs.listDir(path));
-			entries.add("mindset.md");
-			if (record.relationsSource === null) entries.delete("relations.yaml");
-			else entries.add("relations.yaml");
-			return [...entries].sort();
-		},
-		...snapshot.fs.isDirectory ? { isDirectory: (path) => replacements.has(resolve(path)) ? Promise.resolve(false) : snapshot.fs.isDirectory(path) } : {},
-		...snapshot.fs.realPath ? { realPath: (path) => replacements.has(resolve(path)) ? Promise.resolve(resolve(path)) : snapshot.fs.realPath(path) } : {}
-	};
-}
-var StudioKitDraftService = class {
-	repository;
-	sources;
-	constructor(repository, sources) {
-		this.repository = repository;
-		this.sources = sources;
-	}
-	async list() {
-		return (await this.repository.list()).map(({ id, revision, baseKit, confirmed }) => ({
-			id,
-			revision,
-			baseKit: { ...baseKit },
-			confirmed
-		}));
-	}
-	async read(id) {
-		return structuredClone(await this.repository.read(id));
-	}
-	async create(input) {
-		const pin = { ...input.kit };
-		const snapshot = await this.sources.capture(pin);
-		return this.createRetained(snapshot, pin);
-	}
-	/** Adopt retained, independently validated content; never resolve an installed pin. */
-	async createFromSnapshot(input) {
-		const pin = { ...input.kit }, snapshotId = input.snapshotId;
-		return this.createRetained(await this.sources.open(snapshotId), pin);
-	}
-	async createRetained(snapshot, pin) {
-		const kit = await loadStudioKit(snapshot.fs, snapshot.root, snapshot.loadOptions);
-		if (kit.name !== pin.name || String(kit.version) !== pin.version) throw new Error("Source does not match the selected Kit pin.");
-		const mindsetSource = await snapshot.fs.readText(resolve(snapshot.root, "mindset.md"));
-		if (mindsetSource === void 0) throw new Error("Kit Mindset source is missing.");
-		const relationsSource = await snapshot.fs.readText(resolve(snapshot.root, "relations.yaml")) ?? null;
-		checkText(mindsetSource, relationsSource);
-		return this.repository.create({
-			baseKit: pin,
-			baseSnapshot: snapshot.id,
-			mounts: kit.skills.map((bundle) => ({
-				name: bundle.name,
-				version: String(bundle.version)
-			})),
-			mindsetSource,
-			relationsSource,
-			confirmed: false
-		});
-	}
-	/** Invalid intermediate edits can be retained, but cannot be confirmed. */
-	async save(input) {
-		const { id, expectedRevision, mindsetSource, relationsSource } = input;
-		checkText(mindsetSource, relationsSource);
-		const current = await this.read(id);
-		checkRevision(current, expectedRevision);
-		if (current.confirmed) throw new Error("Confirmed Kit draft is locked. Fork it to continue editing.");
-		return this.repository.replace(id, expectedRevision, {
-			...content(current),
-			mindsetSource,
-			relationsSource
-		});
-	}
-	async compile(current) {
-		checkText(current.mindsetSource, current.relationsSource);
-		const snapshot = await this.sources.open(current.baseSnapshot);
-		const base = await loadStudioKit(snapshot.fs, snapshot.root, snapshot.loadOptions);
-		if (base.name !== current.baseKit.name || String(base.version) !== current.baseKit.version || !samePins(current.mounts, base.skills.map((bundle) => ({
-			name: bundle.name,
-			version: String(bundle.version)
-		})))) throw new Error("Retained source does not match the working-copy base and mount pins.");
-		const fs = overlay(snapshot, current);
-		const candidate = await loadStudioKit(fs, snapshot.root, snapshot.loadOptions);
-		if (!samePins(current.mounts, candidate.skills.map((bundle) => ({
-			name: bundle.name,
-			version: String(bundle.version)
-		})))) throw new Error("Bundle mounts are read-only in this editor. Use an explicit catalog mount operation.");
-		return {
-			snapshot,
-			fs,
-			candidate
-		};
-	}
-	async validate(input) {
-		const { id, expectedRevision } = input;
-		const current = await this.read(id);
-		checkRevision(current, expectedRevision);
-		try {
-			const { candidate } = await this.compile(current);
-			return {
-				valid: true,
-				diagnostics: knowledgeDeclarationWarnings(candidate.skills),
-				revision: current.revision,
-				candidateKit: {
-					name: candidate.name,
-					version: String(candidate.version)
-				}
-			};
-		} catch (error) {
-			return {
-				valid: false,
-				revision: current.revision,
-				diagnostics: [{
-					code: "kit_draft.definition",
-					message: error instanceof Error ? error.message : String(error)
-				}]
-			};
-		}
-	}
-	async preview(input) {
-		const { id, expectedRevision, sampleSource } = input;
-		const bundle = { ...input.bundle };
-		const current = await this.read(id);
-		checkRevision(current, expectedRevision);
-		try {
-			const { fs, snapshot, candidate } = await this.compile(current);
-			if (!current.mounts.some((pin) => pin.name === bundle.name && pin.version === bundle.version)) throw new Error("Select an exact mounted Bundle.");
-			const mounted = candidate.skills.find((skill) => skill.name === bundle.name && String(skill.version) === bundle.version);
-			const panelSource = await fs.readText(resolve(mounted?.resourceRoot ?? resolve(snapshot.root, "skills", bundle.name), "panel.yaml"));
-			if (panelSource === void 0) throw new Error("This Bundle has no declarative Panel preview.");
-			return prepareStudioPanelPreview(fs, snapshot.root, {
-				kit: {
-					name: candidate.name,
-					version: String(candidate.version)
-				},
-				bundle,
-				revision: current.revision,
-				panelSource,
-				sampleSource
-			}, snapshot.loadOptions);
-		} catch (error) {
-			return { diagnostics: [{
-				code: "kit_draft.preview",
-				message: error instanceof Error ? error.message : String(error)
-			}] };
-		}
-	}
-	async confirm(input) {
-		const { id, expectedRevision } = input;
-		const current = await this.read(id);
-		checkRevision(current, expectedRevision);
-		const result = await this.validate({
-			id,
-			expectedRevision
-		});
-		if (!result.valid) return result;
-		const draft = current.confirmed ? current : await this.repository.replace(id, expectedRevision, {
-			...content(current),
-			confirmed: true
-		});
-		return {
-			...result,
-			draft
-		};
-	}
-	async fork(id) {
-		return this.repository.create({
-			...content(await this.read(id)),
-			confirmed: false
-		});
-	}
-};
-//#endregion
-//#region packages/companion/src/studio-panel-drafts.mjs
-/** Local storage ports for the shared Studio draft service. No project writes. */
-const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
-const HASH = /^[0-9a-f]{64}$/;
-const MAX_SOURCE_BYTES = 16777216;
-const MAX_DOCUMENT_BYTES = 2097152;
-const inside = (root, path) => {
-	const rel = relative(root, path);
-	return !isAbsolute(rel) && rel !== ".." && !rel.startsWith(`..${sep}`);
-};
-const hash = (value) => createHash("sha256").update(value).digest("hex");
-/** Explicit stateRoot only; neither the installed Kit nor project is a storage target. */
-async function createStudioPanelDrafts({ stateRoot, kitRoot, readInstalledKit, readInstalledBundle }) {
-	const { repository, sources } = await createStudioDraftPorts({
-		stateRoot,
-		kitRoot,
-		readInstalledKit,
-		readInstalledBundle
-	}, "panel");
-	return new StudioPanelDraftService(repository, sources);
-}
-/** Same locking, snapshot and confinement implementation; separate draft namespaces. */
-async function createStudioDraftPorts({ stateRoot, kitRoot, readInstalledKit, readInstalledBundle }, kind) {
-	if (![
-		"kit",
-		"panel",
-		"instance"
-	].includes(kind)) throw new Error("Select the Kit, Panel or instance draft namespace.");
-	if (!isAbsolute(stateRoot)) throw new Error("Studio requires an explicit absolute state directory.");
-	const kitRootReal = kind === "instance" && kitRoot === void 0 ? void 0 : await realpath(kitRoot);
-	if (kitRootReal && inside(kitRootReal, resolve(stateRoot))) throw new Error("Studio drafts must not live inside the installed Kit.");
-	await mkdir(stateRoot, {
-		recursive: true,
-		mode: 448
-	});
-	const state = await realpath(stateRoot);
-	const root = join(state, `studio-${kind}-drafts`);
-	const format = `studio-${kind}-draft/v1`;
-	if (kitRootReal && inside(kitRootReal, root)) throw new Error("Studio drafts must not live inside the installed Kit.");
-	await mkdir(root, {
-		recursive: true,
-		mode: 448
-	});
-	if ((await lstat(root)).isSymbolicLink()) throw new Error("Studio storage cannot be a symlink.");
-	const snapshots = join(root, "snapshots");
-	await mkdir(snapshots, { mode: 448 }).catch((error) => {
-		if (error.code !== "EEXIST") throw error;
-	});
-	if (!(await lstat(snapshots)).isDirectory() || (await lstat(snapshots)).isSymbolicLink()) throw new Error("Unsafe Studio snapshot directory.");
-	const withLock = async (operation) => {
-		const lock = join(root, "write.lock");
-		try {
-			await mkdir(lock, { mode: 448 });
-		} catch (error) {
-			if (error.code === "EEXIST") throw new Error("Studio is being saved elsewhere. Retry; after a crash, stop Studio before clearing its empty write.lock directory.");
-			throw error;
-		}
-		try {
-			return await operation();
-		} finally {
-			await rmdir(lock);
-		}
-	};
-	const readRegular = async (file, limit) => {
-		const info = await lstat(file);
-		if (!info.isFile() || info.isSymbolicLink() || info.size > limit) throw new Error("Invalid or oversized Studio file.");
-		return readFile(file, "utf8");
-	};
-	const writeAtomic = async (file, text) => {
-		const temporary = join(root, `${randomUUID()}.tmp`);
-		let handle;
-		try {
-			handle = await open(temporary, "wx", 384);
-			await handle.writeFile(text, "utf8");
-			await handle.sync();
-			await handle.close();
-			handle = void 0;
-			await rename(temporary, file);
-		} finally {
-			await handle?.close();
-			await unlink(temporary).catch((error) => {
-				if (error.code !== "ENOENT") throw error;
-			});
-		}
-	};
-	const draftPath = (id) => {
-		if (typeof id !== "string" || !UUID.test(id)) throw new Error("Invalid Studio draft identity.");
-		return join(root, `${id}.json`);
-	};
-	const read = async (id) => {
-		const record = JSON.parse(await readRegular(draftPath(id), MAX_DOCUMENT_BYTES));
-		const pin = (value) => typeof value?.name === "string" && typeof value?.version === "string";
-		const validContent = kind === "panel" ? typeof record.panelSource === "string" && typeof record.sampleSource === "string" && pin(record.kit) && pin(record.bundle) : kind === "instance" ? ["kit", "bundle"].includes(record.kind) && (record.recordVersion === 2 ? pin(record[record.kind]) && typeof record.sourceId === "string" && record.sourceId === `local:${record.kind}:${record[record.kind].name}` && (record.kind !== "bundle" || typeof record.runtimeName === "string") : (record.recordVersion === void 0 || record.recordVersion === 1) && pin(record.source?.kit) && (record.kind !== "bundle" || pin(record.source?.bundle) && typeof record.bundlePath === "string")) && typeof record.title?.zh === "string" && typeof record.title?.en === "string" && record.overlays !== null && typeof record.overlays === "object" && !Array.isArray(record.overlays) && Object.values(record.overlays).every((value) => typeof value === "string") && Array.isArray(record.mounts) && record.mounts.every((mount) => pin(mount.bundle)) && (record.recordVersion !== 2 || record.mounts.every((mount) => typeof mount.bindingKey === "string" && HASH.test(mount.bundle.source?.snapshot) && typeof mount.bundle.source?.sourceId === "string" && (mount.bundle.instanceId === void 0 || UUID.test(mount.bundle.instanceId)) && (mount.bundle.revision === void 0 || Number.isSafeInteger(mount.bundle.revision) && mount.bundle.revision >= 0))) : typeof record.mindsetSource === "string" && (record.relationsSource === null || typeof record.relationsSource === "string") && pin(record.baseKit) && Array.isArray(record.mounts) && record.mounts.every(pin);
-		if (record.format !== format || record.id !== id || !Number.isSafeInteger(record.revision) || record.revision < 0 || !HASH.test(record.baseSnapshot) || typeof record.confirmed !== "boolean" || !validContent) throw new Error("Invalid Studio draft record.");
-		const { format: _format, ...value } = record;
-		return value;
-	};
-	const persist = async (record) => {
-		const text = JSON.stringify({
-			format,
-			...record
-		});
-		if (Buffer.byteLength(text) > MAX_DOCUMENT_BYTES) throw new Error("Studio draft is too large.");
-		await writeAtomic(draftPath(record.id), text);
-		return record;
-	};
-	const repository = {
-		read,
-		async list() {
-			const ids = (await readdir(root)).filter((name) => name.endsWith(".json") && UUID.test(name.slice(0, -5))).sort();
-			return Promise.all(ids.map((name) => read(name.slice(0, -5))));
-		},
-		create: (content) => withLock(() => createUnlocked(content)),
-		replace: (id, expectedRevision, content) => withLock(() => replaceUnlocked(id, expectedRevision, content))
-	};
-	const createUnlocked = async (content) => {
-		if ((await repository.list()).length >= 128) throw new Error("Studio draft limit reached (128). Archive unused drafts before creating more.");
-		return persist({
-			...content,
-			id: randomUUID(),
-			revision: 0
-		});
-	};
-	const replaceUnlocked = async (id, expectedRevision, content) => {
-		const current = await read(id);
-		if (current.revision !== expectedRevision || current.confirmed) throw new Error("Studio draft changed or was confirmed elsewhere. Reopen it before saving.");
-		return persist({
-			...content,
-			id,
-			revision: expectedRevision + 1
-		});
-	};
-	if (kind === "instance") repository.transaction = (operation) => withLock(() => operation({
-		read,
-		list: repository.list,
-		create: createUnlocked,
-		replace: replaceUnlocked,
-		retainTree: (entries) => retainEntriesUnlocked(checkEntries(entries)),
-		async migrate(id, expectedRevision, content) {
-			const current = await read(id);
-			if (current.revision !== expectedRevision || current.recordVersion === 2) throw new Error("Legacy instance changed or was already migrated.");
-			const backup = join(root, `${id}.legacy-v1.json`);
-			const original = JSON.stringify({
-				format,
-				...current
-			});
-			try {
-				if (await readRegular(backup, MAX_DOCUMENT_BYTES) !== original) throw new Error("Existing legacy recovery backup differs from the current record.");
-			} catch (error) {
-				if (error.code !== "ENOENT") throw error;
-				await writeAtomic(backup, original);
-			}
-			return replaceUnlocked(id, expectedRevision, content);
-		}
-	}));
-	const openSnapshot = async (id) => {
-		if (typeof id !== "string" || !HASH.test(id)) throw new Error("Invalid Studio source snapshot.");
-		const text = await readRegular(join(snapshots, `${id}.json`), MAX_SOURCE_BYTES * 2);
-		if (hash(text) !== id) throw new Error("Studio source snapshot integrity check failed.");
-		const document = JSON.parse(text);
-		const closure = Array.isArray(document) ? void 0 : document;
-		if (closure && closure.format !== "studio-source-closure/v1") throw new Error("Invalid Studio source closure.");
-		const entries = closure ? closure.entries : document;
-		const files = new Map(entries);
-		const virtualRoot = resolve(root, "virtual-source", id);
-		const keyOf = (path) => {
-			const absolute = resolve(path);
-			if (!inside(virtualRoot, absolute)) throw new Error("Preview path escapes its source snapshot.");
-			return relative(virtualRoot, absolute).split(sep).join("/");
-		};
-		const children = (path) => {
-			const key = keyOf(path), prefix = key ? `${key}/` : "";
-			return [...new Set([...files.keys()].filter((file) => file.startsWith(prefix)).map((file) => file.slice(prefix.length).split("/")[0]))].sort();
-		};
-		const snapshotRoot = closure ? resolve(virtualRoot, closure.kitPath) : virtualRoot;
-		keyOf(snapshotRoot);
-		const loadOptions = closure ? {
-			sourceId: closure.sourceId,
-			bundles: closure.bundles.map((bundle) => {
-				const rootDir = resolve(virtualRoot, bundle.path);
-				keyOf(rootDir);
-				return {
-					name: bundle.name,
-					version: bundle.version,
-					sourceId: bundle.sourceId,
-					rootDir
-				};
-			})
-		} : void 0;
-		return {
-			id,
-			root: snapshotRoot,
-			storageRoot: virtualRoot,
-			...loadOptions ? { loadOptions } : {},
-			fs: {
-				async readBytes(path) {
-					const bytes = files.get(keyOf(path));
-					return bytes === void 0 ? void 0 : Buffer.from(bytes, "base64");
-				},
-				async readText(path) {
-					const bytes = files.get(keyOf(path));
-					return bytes === void 0 ? void 0 : new TextDecoder("utf-8", { fatal: true }).decode(Buffer.from(bytes, "base64"));
-				},
-				async readResource(path) {
-					const bytes = files.get(keyOf(path));
-					return bytes === void 0 ? void 0 : readStudioArchiveResource(path, Buffer.from(bytes, "base64"));
-				},
-				async listDir(path) {
-					return children(path);
-				},
-				async isDirectory(path) {
-					return children(path).length > 0;
-				},
-				async realPath(path) {
-					keyOf(path);
-					return resolve(path);
-				}
-			}
-		};
-	};
-	const checkEntries = (entries) => {
-		if (!Array.isArray(entries) || entries.length > 4096) throw new Error("Source tree exceeds 4096 files.");
-		const seen = /* @__PURE__ */ new Set();
-		let bytes = 0;
-		return entries.map((entry) => {
-			const { path, base64 } = entry ?? {};
-			if (typeof path !== "string" || !path || path.length > 1024 || /[\\:\u0000-\u001f\u007f]/u.test(path) || path.split("/").some((part) => !part || [
-				".",
-				"..",
-				".git",
-				"node_modules"
-			].includes(part)) || seen.has(path) || typeof base64 !== "string" || Buffer.from(base64, "base64").toString("base64") !== base64) throw new Error("Invalid source tree entry.");
-			seen.add(path);
-			bytes += Buffer.byteLength(base64, "base64");
-			if (bytes > MAX_SOURCE_BYTES) throw new Error("Source tree exceeds 16 MiB.");
-			return [path, base64];
-		}).sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0);
-	};
-	const retainEntriesUnlocked = async (entries, closure) => {
-		const text = JSON.stringify(closure ? {
-			...closure,
-			entries
-		} : entries), id = hash(text), destination = join(snapshots, `${id}.json`);
-		try {
-			if (hash(await readRegular(destination, MAX_SOURCE_BYTES * 2)) !== id) throw new Error("Studio snapshot content mismatch.");
-			return openSnapshot(id);
-		} catch (error) {
-			if (error.code !== "ENOENT") throw error;
-		}
-		const retained = (await readdir(snapshots)).filter((name) => name.endsWith(".json") && HASH.test(name.slice(0, -5)));
-		const countLimit = kind === "instance" ? 1024 : 16;
-		if (retained.length >= countLimit) throw new Error(`Studio source snapshot limit reached (${countLimit}).`);
-		if (kind === "instance") {
-			let total = Buffer.byteLength(text);
-			for (const name of retained) total += (await lstat(join(snapshots, name))).size;
-			if (total > 134217728) throw new Error("Studio instance snapshots exceed the 128 MiB retained-storage limit.");
-		}
-		await writeAtomic(destination, text);
-		return openSnapshot(id);
-	};
-	const retainEntries = (entries, closure) => withLock(() => retainEntriesUnlocked(entries, closure));
-	return {
-		repository,
-		sources: {
-			open: openSnapshot,
-			...kind === "instance" ? { retainTree: (entries) => withLock(() => retainEntriesUnlocked(checkEntries(entries))) } : {},
-			/** Full Kit envelope only: standalone Bundles require an explicit composed Kit context. */
-			async retain(archiveSource) {
-				const archive = readStudioContentArchive(archiveSource);
-				if (archive.kind !== "kit") throw new Error("Retain requires a complete Kit archive; compose standalone Bundle context explicitly.");
-				return retainEntries(archive.files.map((file) => [file.path, file.base64]));
-			},
-			async capture(pin) {
-				if (!kitRootReal || typeof readInstalledKit !== "function") throw new Error("Installed Kit capture is not configured for this storage port.");
-				const installed = await readInstalledKit();
-				if (pin.name !== installed.name || pin.version !== String(installed.version)) throw new Error("Select an exact installed Kit version.");
-				const entries = [], ignored = /* @__PURE__ */ new Set([".git", "node_modules"]);
-				let total = 0, nodes = 0;
-				const walk = async (directory, base, prefix) => {
-					if (++nodes > 8192 || relative(base, directory).split(sep).length > 32) throw new Error("Studio source tree exceeds directory limits.");
-					for (const name of (await readdir(directory)).sort()) {
-						if (ignored.has(name)) continue;
-						const file = join(directory, name), info = await lstat(file);
-						if (info.isSymbolicLink()) throw new Error("Studio cannot snapshot source symlinks.");
-						if (info.isDirectory()) await walk(file, base, prefix);
-						else if (info.isFile()) {
-							if (total + info.size > MAX_SOURCE_BYTES || entries.length >= 4096) throw new Error("Kit preview snapshot exceeds 16 MiB or 4096 files.");
-							const bytes = await readFile(file);
-							total += bytes.length;
-							if (total > MAX_SOURCE_BYTES) throw new Error("Kit preview snapshot exceeds 16 MiB.");
-							entries.push([prefix + relative(base, file).split(sep).join("/"), bytes.toString("base64")]);
-						} else throw new Error("Studio sources must be regular files or directories.");
-					}
-				};
-				const sourceRoot = resolve(installed.sourceRoot ?? kitRootReal);
-				if (await realpath(sourceRoot) !== sourceRoot) throw new Error("Studio cannot snapshot source symlinks.");
-				if (await readFile(join(sourceRoot, "kit.yaml"), "utf8").catch((error) => {
-					if (error.code === "ENOENT") return void 0;
-					throw error;
-				}) === void 0) {
-					await walk(sourceRoot, sourceRoot, "");
-					return retainEntries(entries);
-				}
-				if (!Array.isArray(installed.skills)) throw new Error("Independent capture requires compiled mounted Bundles.");
-				const kitPath = `kits/${installed.name}`, bundles = [];
-				await walk(sourceRoot, sourceRoot, `${kitPath}/`);
-				for (const skill of installed.skills) {
-					const pin = {
-						name: skill.catalogName ?? skill.name,
-						version: String(skill.version)
-					};
-					const retained = await readInstalledBundle?.(pin);
-					const bundleRoot = resolve(retained?.resourceRoot ?? skill.resourceRoot ?? "");
-					if (!retained?.resourceRoot && !skill.resourceRoot) throw new Error("Mounted Bundle source root is missing.");
-					if (await realpath(bundleRoot) !== bundleRoot) throw new Error("Studio cannot snapshot source symlinks.");
-					const path = `bundles/${pin.name}`;
-					await walk(bundleRoot, bundleRoot, `${path}/`);
-					bundles.push({
-						...pin,
-						path,
-						sourceId: retained?.sourceId ?? "companion:explicit-kit"
-					});
-				}
-				const checked = checkEntries(entries.map(([path, base64]) => ({
-					path,
-					base64
-				})));
-				return retainEntries(checked, {
-					format: "studio-source-closure/v1",
-					kitPath,
-					sourceId: "companion:explicit-kit",
-					bundles
-				});
-			}
-		}
-	};
-}
-//#endregion
-export { createStudioPanelDrafts as n, StudioKitDraftService as r, createStudioDraftPorts as t };