makefx 0.2.1 → 0.2.3

package/makefx.mjs

@@ -838,8 +838,11 @@ function validateProjectConfig(config, configPath) {
 *   makefx spaces --details          Show asset counts per space
 *   makefx spaces --id <space_id>    Show details for a specific space
 *   makefx spaces create <name>      Create a new space
+*   makefx spaces delete <space_id>  Archive a space for support recovery
+*   makefx spaces inspect-deleted <space_id>  Inspect a soft-deleted space
+*   makefx spaces restore <space_id> Restore a soft-deleted space
 */
-var defaultDeps$12 = {
+var defaultDeps$13 = {
 	loadConfig: loadStoredConfig,
 	resolveBaseUrl,
 	saveProjectConfig,
@@ -854,7 +857,7 @@ async function handleSpaces(parsed) {
 		process$1.exitCode = 1;
 	}
 }
-async function executeSpaces(parsed, deps = defaultDeps$12) {
+async function executeSpaces(parsed, deps = defaultDeps$13) {
 	const env = resolveCommandEnvironment(parsed);
 	const showDetails = parsed.options.details === "true";
 	const spaceId = parsed.options.id;
@@ -892,6 +895,40 @@ async function executeSpaces(parsed, deps = defaultDeps$12) {
 			project
 		};
 	}
+	if (subcommand === "delete" || subcommand === "archive") {
+		const targetSpaceId = parsed.positionals[1] || parsed.options.id;
+		if (!targetSpaceId) throw new Error("Space ID is required. Usage: makefx spaces delete <space_id>");
+		const deleted = await deleteSpace(ctx, deps, targetSpaceId);
+		if (jsonOutput) deps.print(JSON.stringify(deleted, null, 2));
+		else printDeletedSpace(targetSpaceId, deleted.message, deps.print);
+		return {
+			type: "delete",
+			spaceId: targetSpaceId,
+			message: deleted.message
+		};
+	}
+	if (subcommand === "inspect-deleted") {
+		const targetSpaceId = parsed.positionals[1] || parsed.options.id;
+		if (!targetSpaceId) throw new Error("Space ID is required. Usage: makefx spaces inspect-deleted <space_id>");
+		const details = await inspectDeletedSpace(ctx, deps, targetSpaceId);
+		if (jsonOutput) deps.print(JSON.stringify(details, null, 2));
+		else printSupportSpaceDetails(details, deps.print);
+		return {
+			type: "inspect-deleted",
+			details
+		};
+	}
+	if (subcommand === "restore") {
+		const targetSpaceId = parsed.positionals[1] || parsed.options.id;
+		if (!targetSpaceId) throw new Error("Space ID is required. Usage: makefx spaces restore <space_id>");
+		const restored = await restoreSpace(ctx, deps, targetSpaceId);
+		if (jsonOutput) deps.print(JSON.stringify(restored, null, 2));
+		else printRestoredSpace(restored, deps.print);
+		return {
+			type: "restore",
+			restored
+		};
+	}
 	if (spaceId) {
 		const details = await getSpaceDetails(ctx, deps, spaceId);
 		if (jsonOutput) deps.print(JSON.stringify(details, null, 2));
@@ -934,6 +971,45 @@ async function createSpace(ctx, deps, name) {
 	}
 	return (await response.json()).space;
 }
+async function deleteSpace(ctx, deps, spaceId) {
+	const response = await deps.fetch(`${ctx.baseUrl}/api/spaces/${encodeURIComponent(spaceId)}`, {
+		method: "DELETE",
+		headers: {
+			"Authorization": `Bearer ${ctx.accessToken}`,
+			"Content-Type": "application/json"
+		}
+	});
+	if (!response.ok) {
+		const error = await response.text();
+		throw new Error(`Failed to delete space: ${response.status} - ${error}`);
+	}
+	return await response.json();
+}
+async function inspectDeletedSpace(ctx, deps, spaceId) {
+	const response = await deps.fetch(`${ctx.baseUrl}/api/support/spaces/${encodeURIComponent(spaceId)}`, { headers: {
+		"Authorization": `Bearer ${ctx.accessToken}`,
+		"Content-Type": "application/json"
+	} });
+	if (!response.ok) {
+		const error = await response.text();
+		throw new Error(`Failed to inspect deleted space: ${response.status} - ${error}`);
+	}
+	return await response.json();
+}
+async function restoreSpace(ctx, deps, spaceId) {
+	const response = await deps.fetch(`${ctx.baseUrl}/api/support/spaces/${encodeURIComponent(spaceId)}/restore`, {
+		method: "POST",
+		headers: {
+			"Authorization": `Bearer ${ctx.accessToken}`,
+			"Content-Type": "application/json"
+		}
+	});
+	if (!response.ok) {
+		const error = await response.text();
+		throw new Error(`Failed to restore space: ${response.status} - ${error}`);
+	}
+	return await response.json();
+}
 function printCreatedSpace(space, env, configPath, print) {
 	const envFlag = env === "production" ? "" : env === "local" ? " --local" : ` --env ${env}`;
 	print(`\nSpace created successfully!\n`);
@@ -946,6 +1022,22 @@ function printCreatedSpace(space, env, configPath, print) {
 	print(`\nTo listen for events:`);
 	print(`  makefx listen --space ${space.id}${envFlag}`);
 }
+function printDeletedSpace(spaceId, message, print) {
+	print(`Space archived: ${spaceId}`);
+	print(message);
+}
+function printSupportSpaceDetails(details, print) {
+	print(`Space: ${details.space.name} (${details.space.id})`);
+	print(`Deleted at: ${details.space.deleted_at ?? "not deleted"}`);
+	print(`Visible memberships: ${details.memberships.filter((member) => member.deleted_at === null).length}`);
+	print(`Total memberships: ${details.memberships.length}`);
+}
+function printRestoredSpace(restored, print) {
+	print(`Space restored: ${restored.space.id}`);
+	print(restored.message);
+	print(`Visible memberships: ${restored.membershipsVisible}`);
+	if (restored.auditLogId) print(`Audit log: ${restored.auditLogId}`);
+}
 async function fetchSpaces(ctx, deps) {
 	const response = await deps.fetch(`${ctx.baseUrl}/api/spaces`, { headers: {
 		"Authorization": `Bearer ${ctx.accessToken}`,
@@ -5077,7 +5169,7 @@ function resolveMediaType(ext, requestedMediaKind) {
 *   makefx upload <file> --space <id> --name <name>    Upload as new asset
 *   makefx upload <file> --space <id> --name <name> --type <type>
 */
-var defaultDeps$11 = {
+var defaultDeps$12 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -5092,11 +5184,11 @@ async function handleUpload(parsed) {
 		await executeUpload(parsed);
 	} catch (error) {
 		console.error(error instanceof Error ? `Error: ${error.message}` : "Error: Upload failed");
-		if (error instanceof UploadUsageError) printUsage$11();
+		if (error instanceof UploadUsageError) printUsage$12();
 		process$1.exitCode = 1;
 	}
 }
-async function executeUpload(parsed, deps = defaultDeps$11) {
+async function executeUpload(parsed, deps = defaultDeps$12) {
 	const filePath = parsed.positionals[0];
 	if (!filePath) throw new UploadUsageError("File path is required");
 	const projectConfig = await deps.loadProjectConfig();
@@ -5111,7 +5203,7 @@ async function executeUpload(parsed, deps = defaultDeps$11) {
 	const provider = parsed.options.provider;
 	const rawProviderMetadata = parsed.options["provider-metadata"] ?? parsed.options.providerMetadata ?? parsed.options.provider_metadata;
 	const rawGenerationProvenance = parsed.options["generation-provenance"] ?? parsed.options.generationProvenance ?? parsed.options.generation_provenance;
-	const sourceVariantId = parsed.options["source-variant"] ?? parsed.options.sourceVariantId ?? parsed.options.parentVariantId;
+	const rawSourceVariantIds = parsed.options["source-variants"] ?? parsed.options.sourceVariants ?? parsed.options.sourceVariantIds ?? parsed.options["source-variant"] ?? parsed.options.sourceVariantId ?? parsed.options.parentVariantId;
 	const rawRelationType = parsed.options["relation-type"] ?? parsed.options.relationType;
 	const rawActiveVariantBehavior = parsed.options["active-variant-behavior"] ?? parsed.options.activeVariantBehavior;
 	const rawCollectionIds = parsed.options.collection ?? parsed.options.collections;
@@ -5128,11 +5220,12 @@ async function executeUpload(parsed, deps = defaultDeps$11) {
 	if (parsed.options["dry-run"] === "true" || parsed.options.dryRun === "true") throw new UploadUsageError("--dry-run is not supported for direct file upload");
 	if (!spaceId) throw new UploadUsageError("--space is required, or run: makefx init --space <id>");
 	if (!assetId && !assetName) throw new UploadUsageError("Either --asset or --name is required");
-	if (!sourceVariantId && (parsed.options["relation-type"] || parsed.options.relationType)) throw new UploadUsageError("--relation-type requires --source-variant");
 	const providerMetadata = parseJsonObjectOption(rawProviderMetadata, "--provider-metadata");
 	const generationProvenance = parseJsonObjectOption(rawGenerationProvenance, "--generation-provenance");
+	const sourceVariantIds = parseCsvOption$1(rawSourceVariantIds, "--source-variant");
 	const relationType = normalizeRelationType(rawRelationType);
 	const activeVariantBehavior = normalizeActiveVariantBehavior(rawActiveVariantBehavior);
+	if (sourceVariantIds.length === 0 && (parsed.options["relation-type"] || parsed.options.relationType)) throw new UploadUsageError("--relation-type requires --source-variant or --source-variants");
 	const collectionPlacements = parseCollectionPlacements({
 		collectionIds: rawCollectionIds,
 		collectionNames: rawCollectionNames,
@@ -5165,7 +5258,7 @@ async function executeUpload(parsed, deps = defaultDeps$11) {
 		if (fileStat.size > 10485760) throw new Error(`File too large (${(fileStat.size / 1024 / 1024).toFixed(2)}MB). Maximum size: 10MB`);
 		await preflightUploadOrganization(ctx, deps, {
 			assetId,
-			sourceVariantId,
+			sourceVariantIds,
 			collectionPlacements,
 			manualRelations
 		});
@@ -5186,16 +5279,17 @@ async function executeUpload(parsed, deps = defaultDeps$11) {
 		if (provider) formData.append("provider", provider);
 		if (providerMetadata) formData.append("providerMetadata", JSON.stringify(providerMetadata));
 		if (generationProvenance) formData.append("generationProvenance", JSON.stringify(generationProvenance));
-		if (sourceVariantId) formData.append("lineage", JSON.stringify([{
-			parentVariantId: sourceVariantId,
+		if (sourceVariantIds.length > 0) formData.append("lineage", JSON.stringify(sourceVariantIds.map((parentVariantId) => ({
+			parentVariantId,
 			relationType
-		}]));
+		}))));
 		if (!jsonOutput) {
 			deps.print(`\nUploading "${fileName}" to space ${spaceId}...`);
 			deps.print(`  Media kind: ${mediaType.mediaKind}`);
 			if (assetId) deps.print(`  Target asset: ${assetId}`);
 			else deps.print(`  Creating asset: "${assetName}" (${assetType})`);
-			if (sourceVariantId) deps.print(`  Source variant: ${sourceVariantId} (${relationType})`);
+			if (sourceVariantIds.length === 1) deps.print(`  Source variant: ${sourceVariantIds[0]} (${relationType})`);
+			else if (sourceVariantIds.length > 1) deps.print(`  Source variants: ${sourceVariantIds.join(", ")} (${relationType})`);
 		}
 		const response = await deps.fetch(`${baseUrl}/api/spaces/${spaceId}/upload`, {
 			method: "POST",
@@ -5372,7 +5466,7 @@ function parseManualRelations(input) {
 }
 async function preflightUploadOrganization(ctx, deps, options) {
 	const needsCollections = options.collectionPlacements.length > 0;
-	const needsAssetState = Boolean(options.sourceVariantId) || options.manualRelations.length > 0 || options.collectionPlacements.some((placement) => placement.pinnedVariantId);
+	const needsAssetState = options.sourceVariantIds.length > 0 || options.manualRelations.length > 0 || options.collectionPlacements.some((placement) => placement.pinnedVariantId);
 	const [collections, state] = await Promise.all([needsCollections ? fetchJson$1(ctx, deps, `/api/spaces/${ctx.spaceId}/collections`) : void 0, needsAssetState ? fetchAssetState(ctx, deps) : void 0]);
 	if (collections) {
 		const collectionList = collections.collections ?? [];
@@ -5387,7 +5481,7 @@ async function preflightUploadOrganization(ctx, deps, options) {
 		}
 	}
 	if (!state) return;
-	if (options.sourceVariantId && !state.variantsById.has(options.sourceVariantId)) throw new Error(`Source variant not found in space: ${options.sourceVariantId}`);
+	for (const sourceVariantId of options.sourceVariantIds) if (!state.variantsById.has(sourceVariantId)) throw new Error(`Source variant not found in space: ${sourceVariantId}`);
 	for (const placement of options.collectionPlacements) {
 		if (!placement.pinnedVariantId) continue;
 		const pinned = state.variantsById.get(placement.pinnedVariantId);
@@ -5483,7 +5577,7 @@ async function fetchJson$1(ctx, deps, requestPath) {
 function stripUndefined(value) {
 	return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== void 0));
 }
-function printUsage$11() {
+function printUsage$12() {
 	console.log(`
 Usage:
   makefx upload <file> --asset <id> [--space <id>]     Upload media to existing asset
@@ -5500,7 +5594,8 @@ Options:
   --provider <name> Provider provenance for uploaded media
   --provider-metadata <json>     Provider metadata JSON object
   --generation-provenance <json> Extra provenance JSON object
-  --source-variant <id>          Existing source variant for upload lineage
+  --source-variant <ids>         Comma-separated source variants for upload lineage
+  --source-variants <ids>        Alias for --source-variant
   --relation-type <type>         Lineage type: derived, refined, or forked (default: derived)
   --active-variant-behavior <b>  if-missing, set-active, or keep
   --collection <ids>             Comma-separated collection IDs for the uploaded asset or variant
@@ -5525,6 +5620,7 @@ Examples:
   makefx upload hero.png --space abc123 --name "Hero Character"
   makefx upload hero.png --space abc123 --name "Hero" --prompt "external render" --provider blender
   makefx upload paintover.png --space abc123 --asset def456 --source-variant var123 --relation-type refined
+  makefx upload scene.png --space abc123 --name "Cocina" --type scene --source-variants anna,roman,bg
   makefx upload hero.png --space abc123 --name "Hero" --collection collection_cast --collection-role character
   makefx upload hero.png --space abc123 --name "Hero" --collection-name "Cast" --collection-role character
   makefx upload thumbnail.png --space abc123 --asset asset_thumb --manual-relation thumbnail_for:asset:asset_target
@@ -19471,6 +19567,7 @@ var UserProfileSchema = object({
 var SessionConfigSchema = object({
 	googleClientId: string$1(),
 	environment: string$1(),
+	mediaCdnBaseUrl: string$1().nullable().optional(),
 	features: object({ rotation: boolean$1() })
 }).openapi("SessionConfig");
 var AuthSessionResponseSchema = object({
@@ -19526,6 +19623,19 @@ var ProviderKeyResponseSchema = object({
 	success: literal(true),
 	provider: ProviderKeySummarySchema
 }).openapi("ProviderKeyResponse");
+var DeleteAccountRequestSchema = object({
+	email: string$1().email(),
+	confirmation: string$1()
+}).openapi("DeleteAccountRequest");
+var DeleteAccountResponseSchema = object({
+	success: literal(true),
+	deleted: boolean$1(),
+	ownedSpacesPurged: number$1().int(),
+	spacePurgeFailures: number$1().int(),
+	sharedMembershipsDeleted: number$1().int(),
+	r2ObjectsDeleted: number$1().int(),
+	d1RowsChanged: number$1().int()
+}).openapi("DeleteAccountResponse");
 var SpaceRoleSchema = _enum([
 	"owner",
 	"editor",
@@ -19538,6 +19648,25 @@ var SpaceSchema = object({
 	role: SpaceRoleSchema,
 	created_at: number$1()
 }).openapi("Space");
+var SupportSpaceMemberSchema = object({
+	space_id: string$1(),
+	user_id: string$1(),
+	role: SpaceRoleSchema,
+	joined_at: number$1(),
+	deleted_at: string$1().nullable(),
+	user: object({
+		id: string$1(),
+		email: string$1(),
+		name: string$1().nullable()
+	})
+}).openapi("SupportSpaceMember");
+var SupportSpaceSchema = object({
+	id: string$1(),
+	name: string$1(),
+	owner_id: string$1(),
+	created_at: number$1(),
+	deleted_at: string$1().nullable()
+}).openapi("SupportSpace");
 var SpaceIdParamsSchema = object({ id: string$1().openapi({ param: {
 	name: "id",
 	in: "path"
@@ -19567,6 +19696,19 @@ var GetSpaceResponseSchema = object({
 	success: literal(true),
 	space: SpaceSchema
 }).openapi("GetSpaceResponse");
+var GetSupportSpaceResponseSchema = object({
+	success: literal(true),
+	space: SupportSpaceSchema,
+	memberships: array(SupportSpaceMemberSchema)
+}).openapi("GetSupportSpaceResponse");
+var RestoreSupportSpaceResponseSchema = object({
+	success: literal(true),
+	space: SupportSpaceSchema,
+	membershipsVisible: number$1().int(),
+	previousDeletedAt: string$1(),
+	auditLogId: string$1().nullable(),
+	message: string$1()
+}).openapi("RestoreSupportSpaceResponse");
 var MediaKindSchema = _enum([
 	"image",
 	"audio",
@@ -20337,6 +20479,12 @@ var apiEndpoints = {
 		paramsSchema: ProviderKeyParamsSchema,
 		responseSchema: ProviderKeyResponseSchema
 	},
+	"DELETE /api/user/account": {
+		method: "DELETE",
+		path: "/api/user/account",
+		jsonSchema: DeleteAccountRequestSchema,
+		responseSchema: DeleteAccountResponseSchema
+	},
 	"POST /api/spaces": {
 		method: "POST",
 		path: "/api/spaces",
@@ -20354,6 +20502,18 @@ var apiEndpoints = {
 		paramsSchema: SpaceIdParamsSchema,
 		responseSchema: GetSpaceResponseSchema
 	},
+	"GET /api/support/spaces/:id": {
+		method: "GET",
+		path: "/api/support/spaces/:id",
+		paramsSchema: SpaceIdParamsSchema,
+		responseSchema: GetSupportSpaceResponseSchema
+	},
+	"POST /api/support/spaces/:id/restore": {
+		method: "POST",
+		path: "/api/support/spaces/:id/restore",
+		paramsSchema: SpaceIdParamsSchema,
+		responseSchema: RestoreSupportSpaceResponseSchema
+	},
 	"GET /api/spaces/:id/assets": {
 		method: "GET",
 		path: "/api/spaces/:id/assets",
@@ -20785,7 +20945,7 @@ async function apiFetch(key, ...args) {
 }
 //#endregion
 //#region src/cli/commands/productions.ts
-var defaultDeps$10 = {
+var defaultDeps$11 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -20799,12 +20959,12 @@ async function handleProductions(parsed) {
 		await executeProductions(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$10();
+		printUsage$11();
 		process$1.exitCode = 1;
 	}
 }
-async function executeProductions(parsed, deps = defaultDeps$10) {
-	const ctx = await buildContext$7(parsed, deps);
+async function executeProductions(parsed, deps = defaultDeps$11) {
+	const ctx = await buildContext$8(parsed, deps);
 	const subcommand = parsed.positionals[0] || "list";
 	if (subcommand === "list") {
 		const records = await listProductionRecords(ctx, deps, readProductionId(parsed, 1));
@@ -20877,7 +21037,7 @@ async function placeProductionRecordForCli(input) {
 		}
 	})).record;
 }
-async function buildContext$7(parsed, deps) {
+async function buildContext$8(parsed, deps) {
 	const projectConfig = await deps.loadProjectConfig();
 	const env = resolveCommandEnvironment(parsed, projectConfig);
 	const spaceId = resolveCommandSpace(parsed, projectConfig);
@@ -20936,10 +21096,10 @@ function readProductionId(parsed, positionalIndex) {
 	return productionId;
 }
 function parsePlaceRequest(parsed) {
-	const productionId = readRequiredOption$1(parsed, "production-id", "productionId");
-	const variantId = readRequiredOption$1(parsed, "variant", "variantId");
-	const sceneLabel = readRequiredOption$1(parsed, "scene-label", "sceneLabel");
-	const timelineStartMs = parseNonNegativeInteger$1(readRequiredOption$1(parsed, "timeline-start-ms", "timelineStartMs"), "--timeline-start-ms");
+	const productionId = readRequiredOption$2(parsed, "production-id", "productionId");
+	const variantId = readRequiredOption$2(parsed, "variant", "variantId");
+	const sceneLabel = readRequiredOption$2(parsed, "scene-label", "sceneLabel");
+	const timelineStartMs = parseNonNegativeInteger$1(readRequiredOption$2(parsed, "timeline-start-ms", "timelineStartMs"), "--timeline-start-ms");
 	const durationValue = readOptionalOption$1(parsed, "duration-ms", "durationMs");
 	return {
 		id: readOptionalOption$1(parsed, "id", "id"),
@@ -20955,7 +21115,7 @@ function parsePlaceRequest(parsed) {
 		metadata: parseMetadataJson(readOptionalOption$1(parsed, "metadata-json", "metadataJson"))
 	};
 }
-function readRequiredOption$1(parsed, kebabName, camelName) {
+function readRequiredOption$2(parsed, kebabName, camelName) {
 	const value = readOptionalOption$1(parsed, kebabName, camelName);
 	if (value === void 0) throw new Error(`--${kebabName} is required`);
 	return value;
@@ -21100,7 +21260,7 @@ function parseJsonObject$1(value) {
 function shellQuote$1(value) {
 	return `'${value.replace(/'/g, "'\\''")}'`;
 }
-function printUsage$10() {
+function printUsage$11() {
 	console.log(`
 Usage:
   makefx productions list --production-id <id>
@@ -22719,7 +22879,7 @@ function cliGenerationSupportsRefs(namespace) {
 //#endregion
 //#region src/cli/commands/forge.ts
 var CLI_GENERATION_MEDIA_KIND = getCliGenerationMediaKind("top-level");
-var defaultDeps$9 = {
+var defaultDeps$10 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -22792,18 +22952,18 @@ async function handleBatch(parsed) {
 }
 async function handleForgeCommand(command, parsed) {
 	try {
-		await executeForgeCommand(command, parsed, defaultDeps$9);
+		await executeForgeCommand(command, parsed, defaultDeps$10);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$9(command);
+		printUsage$10(command);
 		process$1.exitCode = 1;
 	}
 }
-async function executeForgeCommand(command, parsed, deps = defaultDeps$9, options = {}) {
+async function executeForgeCommand(command, parsed, deps = defaultDeps$10, options = {}) {
 	const mediaKind = options.mediaKind || CLI_GENERATION_MEDIA_KIND;
 	if (parsed.options.follow) {
 		if (command === "batch") throw new Error("--follow is only supported for single-output generation commands");
-		const ctx = await buildContext$6(parsed, deps);
+		const ctx = await buildContext$7(parsed, deps);
 		const client = await deps.createClient(ctx.env, ctx.spaceId);
 		try {
 			await client.connect();
@@ -22817,7 +22977,7 @@ async function executeForgeCommand(command, parsed, deps = defaultDeps$9, option
 	validateVideoAudioOptions(parsed, mediaKind);
 	parseVideoGenerationOptions(parsed, mediaKind);
 	if (command !== "batch") validateProductionMetadataOptions(parsed);
-	const ctx = await buildContext$6(parsed, deps);
+	const ctx = await buildContext$7(parsed, deps);
 	const client = await deps.createClient(ctx.env, ctx.spaceId);
 	try {
 		await client.connect();
@@ -22831,7 +22991,7 @@ async function executeForgeCommand(command, parsed, deps = defaultDeps$9, option
 		client.disconnect();
 	}
 }
-async function executeAudioCommand(command, parsed, deps = defaultDeps$9, options = {}) {
+async function executeAudioCommand(command, parsed, deps = defaultDeps$10, options = {}) {
 	const audioProfile = getCliGenerationProfile("audio");
 	if (!audioProfile.commands.includes(command)) throw new Error(`Audio generation does not support ${command}`);
 	const modeEntry = options.mode ? getMediaOperationEntry(options.mode) : void 0;
@@ -22844,7 +23004,7 @@ async function executeAudioCommand(command, parsed, deps = defaultDeps$9, option
 		audioMode: options.mode
 	});
 }
-async function executeVideoCommand(command, parsed, deps = defaultDeps$9) {
+async function executeVideoCommand(command, parsed, deps = defaultDeps$10) {
 	const videoProfile = getCliGenerationProfile("video");
 	if (!videoProfile.commands.includes(command)) throw new Error(`Video generation does not support ${command}`);
 	return executeForgeCommand(command, parsed, deps, {
@@ -23414,7 +23574,7 @@ async function placeProductionRecordFromScene(input) {
 		record
 	});
 }
-async function buildContext$6(parsed, deps) {
+async function buildContext$7(parsed, deps) {
 	const projectConfig = await deps.loadProjectConfig();
 	const env = resolveCommandEnvironment(parsed, projectConfig);
 	const spaceId = resolveCommandSpace(parsed, projectConfig);
@@ -23810,7 +23970,7 @@ function cliImageSizeValues() {
 function cliImageAspectValues() {
 	return cliOptionValues(getImageModelCapabilities().supportedAspectRatios);
 }
-function printUsage$9(command) {
+function printUsage$10(command) {
 	if (command === "generate") {
 		console.log(`
 Usage:
@@ -23863,7 +24023,7 @@ function printBatchResult(result, outputDir, manifestPath, ctx, mediaKind) {
 }
 //#endregion
 //#region src/cli/commands/audio.ts
-var defaultDeps$8 = {
+var defaultDeps$9 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -23876,11 +24036,11 @@ async function handleAudio(parsed) {
 		await executeAudio(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$8();
+		printUsage$9();
 		process$1.exitCode = 1;
 	}
 }
-async function executeAudio(parsed, deps = defaultDeps$8) {
+async function executeAudio(parsed, deps = defaultDeps$9) {
 	const invocation = parseAudioInvocation(parsed.positionals);
 	if (invocation.command === "voices") return executeAudioVoices({
 		...parsed,
@@ -23953,7 +24113,7 @@ function printVoices(response, print) {
 function formatLabels(labels) {
 	return Object.entries(labels).map(([key, value]) => `${key}:${value}`).join(", ");
 }
-function printUsage$8() {
+function printUsage$9() {
 	const modes = AUDIO_FORGE_MEDIA_MODES.join("|");
 	console.log(`
 Usage:
@@ -23982,7 +24142,7 @@ async function handleVideo(parsed) {
 		});
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$7();
+		printUsage$8();
 		process$1.exitCode = 1;
 	}
 }
@@ -23991,7 +24151,7 @@ function parseVideoCommand(value) {
 	if (value && commands.includes(value)) return value;
 	throw new Error("Video command is required: generate, refine, or derive");
 }
-function printUsage$7() {
+function printUsage$8() {
 	const aspectValues = VIDEO_GENERATION_ASPECT_RATIOS.join("|");
 	const resolutionValues = Array.from(new Set(VIDEO_GENERATION_TIERS.flatMap((tier) => getVideoGenerationResolutionsForTier(tier)))).join("|");
 	const durationValues = VIDEO_GENERATION_DURATION_SECONDS.join("|");
@@ -24023,17 +24183,17 @@ Production metadata:
 }
 //#endregion
 //#region src/cli/commands/init.ts
-var defaultDeps$7 = { saveProjectConfig };
+var defaultDeps$8 = { saveProjectConfig };
 async function handleInit(parsed) {
 	try {
 		await executeInit(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$6();
+		printUsage$7();
 		process$1.exitCode = 1;
 	}
 }
-async function executeInit(parsed, deps = defaultDeps$7) {
+async function executeInit(parsed, deps = defaultDeps$8) {
 	const environment = resolveCommandEnvironment(parsed);
 	const spaceId = resolveCommandSpace(parsed);
 	if (!spaceId) throw new Error("--space is required");
@@ -24059,7 +24219,7 @@ async function executeInit(parsed, deps = defaultDeps$7) {
 		spaceId
 	};
 }
-function printUsage$6() {
+function printUsage$7() {
 	console.log(`
 Usage:
   makefx init --space <id> [--env production|stage|local]
@@ -24068,7 +24228,7 @@ Usage:
 }
 //#endregion
 //#region src/cli/commands/runs.ts
-var defaultDeps$6 = {
+var defaultDeps$7 = {
 	loadProjectConfig,
 	listRunManifests,
 	readRunManifest,
@@ -24081,11 +24241,11 @@ async function handleRuns(parsed) {
 		await executeRuns(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$5();
+		printUsage$6();
 		process$1.exitCode = 1;
 	}
 }
-async function executeRuns(parsed, deps = defaultDeps$6) {
+async function executeRuns(parsed, deps = defaultDeps$7) {
 	const projectConfig = await deps.loadProjectConfig();
 	if (!projectConfig?.projectRoot) throw new Error("Make Effects project config not found. Run: makefx init --space <id>");
 	requireDebugAcknowledgement(parsed);
@@ -24203,7 +24363,7 @@ function formatCreated(value) {
 	if (Number.isNaN(date.getTime())) return value;
 	return value.replace("T", " ").replace(/\.\d{3}Z$/, "Z").slice(0, 20);
 }
-function printUsage$5() {
+function printUsage$6() {
 	console.log(`
 Usage:
   makefx runs --debug
@@ -24221,7 +24381,7 @@ For timed scene assembly, use:
 }
 //#endregion
 //#region src/cli/commands/assets.ts
-var defaultDeps$5 = {
+var defaultDeps$6 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -24244,12 +24404,12 @@ async function handleAssets(parsed) {
 		await executeAssets(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$4();
+		printUsage$5();
 		process$1.exitCode = 1;
 	}
 }
-async function executeAssets(parsed, deps = defaultDeps$5) {
-	const ctx = await buildContext$5(parsed, deps);
+async function executeAssets(parsed, deps = defaultDeps$6) {
+	const ctx = await buildContext$6(parsed, deps);
 	const subcommand = parsed.positionals[0] || "list";
 	if (subcommand === "list") {
 		const assets = await listAssets$1(ctx, deps);
@@ -24328,7 +24488,7 @@ async function executeAssets(parsed, deps = defaultDeps$5) {
 function normalizeOption(value) {
 	return !value || value === "true" ? void 0 : value;
 }
-async function buildContext$5(parsed, deps) {
+async function buildContext$6(parsed, deps) {
 	const projectConfig = await deps.loadProjectConfig();
 	const env = resolveCommandEnvironment(parsed, projectConfig);
 	const spaceId = resolveCommandSpace(parsed, projectConfig);
@@ -24507,7 +24667,7 @@ function formatTimestamp(value) {
 	if (Number.isNaN(date.getTime())) return String(value);
 	return date.toISOString().replace("T", " ").replace(/\.\d{3}Z$/, "Z").slice(0, 20);
 }
-function printUsage$4() {
+function printUsage$5() {
 	console.log(`
 Usage:
   makefx assets
@@ -24522,7 +24682,7 @@ Usage:
 }
 //#endregion
 //#region src/cli/commands/variants.ts
-var defaultDeps$4 = {
+var defaultDeps$5 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -24534,12 +24694,12 @@ async function handleVariants(parsed) {
 		await executeVariants(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$3();
+		printUsage$4();
 		process$1.exitCode = 1;
 	}
 }
-async function executeVariants(parsed, deps = defaultDeps$4) {
-	const ctx = await buildContext$4(parsed, deps);
+async function executeVariants(parsed, deps = defaultDeps$5) {
+	const ctx = await buildContext$5(parsed, deps);
 	const subcommand = parsed.positionals[0];
 	if (subcommand === "delete") {
 		const variantId = requireVariantId(parsed, "delete");
@@ -24587,7 +24747,7 @@ function requireVariantId(parsed, verb) {
 	if (!variantId) throw new Error(`Variant ID is required: makefx variants ${verb} <variant-id>`);
 	return variantId;
 }
-async function buildContext$4(parsed, deps) {
+async function buildContext$5(parsed, deps) {
 	const projectConfig = await deps.loadProjectConfig();
 	const env = resolveCommandEnvironment(parsed, projectConfig);
 	const spaceId = resolveCommandSpace(parsed, projectConfig);
@@ -24610,7 +24770,7 @@ async function withVariantClient(ctx, deps, run) {
 		client.disconnect();
 	}
 }
-function printUsage$3() {
+function printUsage$4() {
 	console.log(`
 Usage:
   makefx variants delete <variant-id>
@@ -24627,7 +24787,7 @@ Options:
 }
 //#endregion
 //#region src/cli/commands/styles.ts
-var defaultDeps$3 = {
+var defaultDeps$4 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -24639,26 +24799,26 @@ async function handleStyles(parsed) {
 		await executeStyles(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$2();
+		printUsage$3();
 		process$1.exitCode = 1;
 	}
 }
-async function executeStyles(parsed, deps = defaultDeps$3) {
+async function executeStyles(parsed, deps = defaultDeps$4) {
 	const namespace = parsed.positionals[0] || "presets";
 	if (namespace === "references" || namespace === "refs") return executeReferences(parsed, deps);
-	if (namespace === "collections" || namespace === "collection") return executeCollections(parsed, deps);
+	if (namespace === "collections" || namespace === "collection") return executeCollections$1(parsed, deps);
 	if (namespace === "presets" || namespace === "preset") return executePresets(parsed, deps);
 	throw new Error(`Unknown styles command: ${namespace}`);
 }
 async function executeReferences(parsed, deps) {
-	const ctx = await buildContext$3(parsed, deps);
-	const collectionFilter = readOption(parsed, "collection", "collectionId") || parsed.positionals[1];
+	const ctx = await buildContext$4(parsed, deps);
+	const collectionFilter = readOption$1(parsed, "collection", "collectionId") || parsed.positionals[1];
 	const collections = await listStyleReferenceCollections(ctx, deps);
 	const selected = collectionFilter ? collections.filter((collection) => collection.id === collectionFilter || collection.name === collectionFilter) : collections;
 	if (collectionFilter && selected.length === 0) throw new Error(`Style reference collection not found: ${collectionFilter}`);
 	const references = [];
 	for (const collection of selected) {
-		const items = await listCollectionItems(ctx, deps, collection.id);
+		const items = await listCollectionItems$1(ctx, deps, collection.id);
 		for (const item of items.filter((candidate) => candidate.role === "style_ref")) references.push({
 			collectionId: collection.id,
 			collectionName: collection.name,
@@ -24672,24 +24832,24 @@ async function executeReferences(parsed, deps) {
 		references
 	};
 }
-async function executeCollections(parsed, deps) {
-	const ctx = await buildContext$3(parsed, deps);
+async function executeCollections$1(parsed, deps) {
+	const ctx = await buildContext$4(parsed, deps);
 	const action = parsed.positionals[1] || "list";
 	if (action === "list") {
 		const collections = await listStyleReferenceCollections(ctx, deps);
 		if (parsed.options.json === "true") deps.print(JSON.stringify(collections, null, 2));
-		else printCollections(collections, deps.print);
+		else printCollections$1(collections, deps.print);
 		return {
 			type: "collections",
 			collections
 		};
 	}
 	if (action === "create") {
-		const name = parsed.positionals[2] || readRequiredOption(parsed, "name", "name");
-		const collection = await createCollection(ctx, deps, {
-			id: readOption(parsed, "id", "id"),
+		const name = parsed.positionals[2] || readRequiredOption$1(parsed, "name", "name");
+		const collection = await createCollection$1(ctx, deps, {
+			id: readOption$1(parsed, "id", "id"),
 			name,
-			description: nullableOption(parsed, "description", "description")
+			description: nullableOption$1(parsed, "description", "description")
 		});
 		const items = await upsertStyleReferenceItems(ctx, deps, collection.id, parsed, false);
 		printCollectionMutation("Created", collection, items, deps.print, parsed.options.json === "true");
@@ -24700,16 +24860,16 @@ async function executeCollections(parsed, deps) {
 		};
 	}
 	if (action === "update") {
-		const collectionId = parsed.positionals[2] || readRequiredOption(parsed, "id", "id");
+		const collectionId = parsed.positionals[2] || readRequiredOption$1(parsed, "id", "id");
 		const changes = {};
-		const name = readOption(parsed, "name", "name");
-		const description = nullableOption(parsed, "description", "description");
+		const name = readOption$1(parsed, "name", "name");
+		const description = nullableOption$1(parsed, "description", "description");
 		if (name !== void 0) changes.name = name;
 		if (description !== void 0) changes.description = description;
 		let collection;
-		if (Object.keys(changes).length > 0) collection = await updateCollection(ctx, deps, collectionId, changes);
+		if (Object.keys(changes).length > 0) collection = await updateCollection$1(ctx, deps, collectionId, changes);
 		const items = hasReferenceOptions(parsed) ? await upsertStyleReferenceItems(ctx, deps, collectionId, parsed, parsed.options.append !== "true") : void 0;
-		if (!collection) collection = (await listCollections(ctx, deps)).find((candidate) => candidate.id === collectionId);
+		if (!collection) collection = (await listCollections$1(ctx, deps)).find((candidate) => candidate.id === collectionId);
 		if (!collection) throw new Error(`Collection not found: ${collectionId}`);
 		printCollectionMutation("Updated", collection, items, deps.print, parsed.options.json === "true");
 		return {
@@ -24721,7 +24881,7 @@ async function executeCollections(parsed, deps) {
 	throw new Error(`Unknown styles collections command: ${action}`);
 }
 async function executePresets(parsed, deps) {
-	const ctx = await buildContext$3(parsed, deps);
+	const ctx = await buildContext$4(parsed, deps);
 	const action = parsed.positionals[1] || "list";
 	if (action === "list") {
 		const presets = await listStylePresets(ctx, deps);
@@ -24733,13 +24893,13 @@ async function executePresets(parsed, deps) {
 		};
 	}
 	if (action === "create") {
-		const name = parsed.positionals[2] || readRequiredOption(parsed, "name", "name");
+		const name = parsed.positionals[2] || readRequiredOption$1(parsed, "name", "name");
 		const response = await createStylePreset(ctx, deps, {
-			id: readOption(parsed, "id", "id"),
+			id: readOption$1(parsed, "id", "id"),
 			name,
-			description: nullableOption(parsed, "description", "description"),
-			stylePrompt: readOption(parsed, "prompt", "stylePrompt") ?? "",
-			collectionId: nullableOption(parsed, "collection", "collectionId"),
+			description: nullableOption$1(parsed, "description", "description"),
+			stylePrompt: readOption$1(parsed, "prompt", "stylePrompt") ?? "",
+			collectionId: nullableOption$1(parsed, "collection", "collectionId"),
 			enabled: parsed.options.disable === "true" ? false : true,
 			isDefault: parsed.options.default === "true"
 		});
@@ -24750,7 +24910,7 @@ async function executePresets(parsed, deps) {
 		};
 	}
 	if (action === "update") {
-		const response = await updateStylePreset(ctx, deps, parsed.positionals[2] || readRequiredOption(parsed, "id", "id"), buildPresetUpdate(parsed));
+		const response = await updateStylePreset(ctx, deps, parsed.positionals[2] || readRequiredOption$1(parsed, "id", "id"), buildPresetUpdate(parsed));
 		printPresetMutation("Updated", response.preset, deps.print, parsed.options.json === "true");
 		return {
 			type: "preset",
@@ -24758,7 +24918,7 @@ async function executePresets(parsed, deps) {
 		};
 	}
 	if (action === "enable" || action === "disable") {
-		const response = await updateStylePreset(ctx, deps, parsed.positionals[2] || readRequiredOption(parsed, "id", "id"), { enabled: action === "enable" });
+		const response = await updateStylePreset(ctx, deps, parsed.positionals[2] || readRequiredOption$1(parsed, "id", "id"), { enabled: action === "enable" });
 		printPresetMutation(action === "enable" ? "Enabled" : "Disabled", response.preset, deps.print, parsed.options.json === "true");
 		return {
 			type: "preset",
@@ -24766,7 +24926,7 @@ async function executePresets(parsed, deps) {
 		};
 	}
 	if (action === "delete" || action === "remove") {
-		const presetId = parsed.positionals[2] || readRequiredOption(parsed, "id", "id");
+		const presetId = parsed.positionals[2] || readRequiredOption$1(parsed, "id", "id");
 		await deleteStylePreset(ctx, deps, presetId);
 		if (parsed.options.json === "true") deps.print(JSON.stringify({
 			success: true,
@@ -24780,7 +24940,7 @@ async function executePresets(parsed, deps) {
 	}
 	throw new Error(`Unknown styles presets command: ${action}`);
 }
-async function buildContext$3(parsed, deps) {
+async function buildContext$4(parsed, deps) {
 	const projectConfig = await deps.loadProjectConfig();
 	const env = resolveCommandEnvironment(parsed, projectConfig);
 	const spaceId = resolveCommandSpace(parsed, projectConfig);
@@ -24801,15 +24961,15 @@ async function listAssets(ctx, deps) {
 		baseUrl: ctx.baseUrl,
 		fetch: deps.fetch,
 		params: { id: ctx.spaceId },
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	})).assets;
 }
-async function listCollections(ctx, deps) {
+async function listCollections$1(ctx, deps) {
 	return (await apiFetch("GET /api/spaces/:id/collections", {
 		baseUrl: ctx.baseUrl,
 		fetch: deps.fetch,
 		params: { id: ctx.spaceId },
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	})).collections;
 }
 async function listStyleReferenceCollections(ctx, deps) {
@@ -24817,10 +24977,10 @@ async function listStyleReferenceCollections(ctx, deps) {
 		baseUrl: ctx.baseUrl,
 		fetch: deps.fetch,
 		params: { id: ctx.spaceId },
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	})).collections;
 }
-async function listCollectionItems(ctx, deps, collectionId) {
+async function listCollectionItems$1(ctx, deps, collectionId) {
 	return (await apiFetch("GET /api/spaces/:id/collections/:collectionId/items", {
 		baseUrl: ctx.baseUrl,
 		fetch: deps.fetch,
@@ -24828,19 +24988,19 @@ async function listCollectionItems(ctx, deps, collectionId) {
 			id: ctx.spaceId,
 			collectionId
 		},
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	})).items;
 }
-async function createCollection(ctx, deps, json) {
+async function createCollection$1(ctx, deps, json) {
 	return (await apiFetch("POST /api/spaces/:id/collections", {
 		baseUrl: ctx.baseUrl,
 		fetch: deps.fetch,
 		params: { id: ctx.spaceId },
 		json,
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	})).collection;
 }
-async function updateCollection(ctx, deps, collectionId, json) {
+async function updateCollection$1(ctx, deps, collectionId, json) {
 	return (await apiFetch("PATCH /api/spaces/:id/collections/:collectionId", {
 		baseUrl: ctx.baseUrl,
 		fetch: deps.fetch,
@@ -24849,10 +25009,10 @@ async function updateCollection(ctx, deps, collectionId, json) {
 			collectionId
 		},
 		json,
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	})).collection;
 }
-async function createCollectionItem(ctx, deps, collectionId, json) {
+async function createCollectionItem$1(ctx, deps, collectionId, json) {
 	return (await apiFetch("POST /api/spaces/:id/collections/:collectionId/items", {
 		baseUrl: ctx.baseUrl,
 		fetch: deps.fetch,
@@ -24861,10 +25021,10 @@ async function createCollectionItem(ctx, deps, collectionId, json) {
 			collectionId
 		},
 		json,
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	})).item;
 }
-async function deleteCollectionItem(ctx, deps, collectionId, itemId) {
+async function deleteCollectionItem$1(ctx, deps, collectionId, itemId) {
 	await apiFetch("DELETE /api/spaces/:id/collections/:collectionId/items/:itemId", {
 		baseUrl: ctx.baseUrl,
 		fetch: deps.fetch,
@@ -24873,7 +25033,7 @@ async function deleteCollectionItem(ctx, deps, collectionId, itemId) {
 			collectionId,
 			itemId
 		},
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	});
 }
 async function listStylePresets(ctx, deps) {
@@ -24881,7 +25041,7 @@ async function listStylePresets(ctx, deps) {
 		baseUrl: ctx.baseUrl,
 		fetch: deps.fetch,
 		params: { id: ctx.spaceId },
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	})).presets;
 }
 async function createStylePreset(ctx, deps, json) {
@@ -24890,7 +25050,7 @@ async function createStylePreset(ctx, deps, json) {
 		fetch: deps.fetch,
 		params: { id: ctx.spaceId },
 		json,
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	});
 }
 async function updateStylePreset(ctx, deps, presetId, json) {
@@ -24902,7 +25062,7 @@ async function updateStylePreset(ctx, deps, presetId, json) {
 			presetId
 		},
 		json,
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	});
 }
 async function deleteStylePreset(ctx, deps, presetId) {
@@ -24913,18 +25073,18 @@ async function deleteStylePreset(ctx, deps, presetId) {
 			id: ctx.spaceId,
 			presetId
 		},
-		headers: authHeaders(ctx)
+		headers: authHeaders$1(ctx)
 	});
 }
 async function upsertStyleReferenceItems(ctx, deps, collectionId, parsed, replaceExisting) {
 	const refs = await buildStyleReferenceItemRequests(ctx, deps, parsed);
 	if (refs.length === 0) return [];
 	if (replaceExisting) {
-		const existing = await listCollectionItems(ctx, deps, collectionId);
-		await Promise.all(existing.filter((item) => item.role === "style_ref").map((item) => deleteCollectionItem(ctx, deps, collectionId, item.id)));
+		const existing = await listCollectionItems$1(ctx, deps, collectionId);
+		await Promise.all(existing.filter((item) => item.role === "style_ref").map((item) => deleteCollectionItem$1(ctx, deps, collectionId, item.id)));
 	}
 	const created = [];
-	for (let index = 0; index < refs.length; index += 1) created.push(await createCollectionItem(ctx, deps, collectionId, {
+	for (let index = 0; index < refs.length; index += 1) created.push(await createCollectionItem$1(ctx, deps, collectionId, {
 		...refs[index],
 		role: "style_ref",
 		sortIndex: index
@@ -24932,9 +25092,9 @@ async function upsertStyleReferenceItems(ctx, deps, collectionId, parsed, replac
 	return created;
 }
 async function buildStyleReferenceItemRequests(ctx, deps, parsed) {
-	const assets = parseCsvOptions(parsed, ["assets", "asset"]);
-	const variants = parseCsvOptions(parsed, ["variants", "variant"]);
-	const refs = parseCsvOptions(parsed, ["refs", "ref"]);
+	const assets = parseCsvOptions$1(parsed, ["assets", "asset"]);
+	const variants = parseCsvOptions$1(parsed, ["variants", "variant"]);
+	const refs = parseCsvOptions$1(parsed, ["refs", "ref"]);
 	if (assets.length === 0 && variants.length === 0 && refs.length === 0) return [];
 	const allAssets = await listAssets(ctx, deps);
 	const assetById = new Map(allAssets.map((asset) => [asset.id, asset]));
@@ -24966,10 +25126,10 @@ function dedupeItemRequests(requests) {
 }
 function buildPresetUpdate(parsed) {
 	const update = {};
-	const name = readOption(parsed, "name", "name");
-	const description = nullableOption(parsed, "description", "description");
-	const stylePrompt = readOption(parsed, "prompt", "stylePrompt");
-	const collectionId = nullableOption(parsed, "collection", "collectionId");
+	const name = readOption$1(parsed, "name", "name");
+	const description = nullableOption$1(parsed, "description", "description");
+	const stylePrompt = readOption$1(parsed, "prompt", "stylePrompt");
+	const collectionId = nullableOption$1(parsed, "collection", "collectionId");
 	if (name !== void 0) update.name = name;
 	if (description !== void 0) update.description = description;
 	if (stylePrompt !== void 0) update.stylePrompt = stylePrompt;
@@ -24981,7 +25141,7 @@ function buildPresetUpdate(parsed) {
 	if (Object.keys(update).length === 0) throw new Error("No preset updates provided");
 	return update;
 }
-function authHeaders(ctx) {
+function authHeaders$1(ctx) {
 	return {
 		"Authorization": `Bearer ${ctx.accessToken}`,
 		"Accept": "application/json"
@@ -24997,28 +25157,28 @@ function hasReferenceOptions(parsed) {
 		"variant"
 	].some((key) => Boolean(readRawOption(parsed, key)));
 }
-function parseCsvOptions(parsed, keys) {
+function parseCsvOptions$1(parsed, keys) {
 	return keys.flatMap((key) => parseCsv(readRawOption(parsed, key)));
 }
 function parseCsv(value) {
 	if (!value || value === "true") return [];
 	return value.split(",").map((item) => item.trim()).filter(Boolean);
 }
-function readRequiredOption(parsed, kebabName, camelName) {
-	const value = readOption(parsed, kebabName, camelName);
+function readRequiredOption$1(parsed, kebabName, camelName) {
+	const value = readOption$1(parsed, kebabName, camelName);
 	if (value === void 0) throw new Error(`--${kebabName} is required`);
 	return value;
 }
-function readOption(parsed, kebabName, camelName) {
+function readOption$1(parsed, kebabName, camelName) {
 	const value = readRawOption(parsed, kebabName) ?? readRawOption(parsed, camelName);
 	return !value || value === "true" ? void 0 : value;
 }
 function readRawOption(parsed, key) {
 	return parsed.options[key];
 }
-function nullableOption(parsed, kebabName, camelName) {
+function nullableOption$1(parsed, kebabName, camelName) {
 	if (parsed.options["no-collection"] === "true" && (kebabName === "collection" || camelName === "collectionId")) return null;
-	const value = readOption(parsed, kebabName, camelName);
+	const value = readOption$1(parsed, kebabName, camelName);
 	if (value === void 0) return void 0;
 	return value === "null" || value === "-" ? null : value;
 }
@@ -25038,7 +25198,7 @@ function printReferences(references, print) {
 		print(truncate(reference.collectionName, 26).padEnd(28) + item.subject_type.padEnd(10) + truncate(item.asset_id || "-", 26).padEnd(28) + truncate(item.pinned_variant_id || item.variant_id || "-", 26).padEnd(28) + truncate(item.id, 26));
 	}
 }
-function printCollections(collections, print) {
+function printCollections$1(collections, print) {
 	if (collections.length === 0) {
 		print("No style reference collections found.");
 		return;
@@ -25082,7 +25242,7 @@ function printPresetMutation(verb, preset, print, asJson) {
 	print(`  Collection: ${preset.collection_name || preset.collection_id || "-"}`);
 	print(`  References: ${preset.reference_count}`);
 }
-function printUsage$2() {
+function printUsage$3() {
 	console.log(`
 Usage:
   makefx styles references [--collection <id-or-name>] [--json]
@@ -25107,6 +25267,376 @@ Options:
 `);
 }
 //#endregion
+//#region src/cli/commands/collections.ts
+var defaultDeps$3 = {
+	loadConfig: loadStoredConfig,
+	loadProjectConfig,
+	resolveBaseUrl,
+	fetch,
+	print: console.log
+};
+async function handleCollections(parsed) {
+	try {
+		await executeCollections(parsed);
+	} catch (error) {
+		console.error("Error:", error instanceof Error ? error.message : error);
+		printUsage$2();
+		process$1.exitCode = 1;
+	}
+}
+async function executeCollections(parsed, deps = defaultDeps$3) {
+	const action = parsed.positionals[0] || "list";
+	const ctx = await buildContext$3(parsed, deps);
+	const json = parsed.options.json === "true";
+	if (action === "list") {
+		const collections = await listCollections(ctx, deps);
+		if (json) printJson(collections, deps.print);
+		else printCollections(collections, deps.print);
+		return {
+			type: "list",
+			collections
+		};
+	}
+	if (action === "create") {
+		const collection = await createCollection(ctx, deps, buildCollectionCreateRequest(parsed, parsed.positionals[1] || readRequiredOption(parsed, "name")));
+		if (json) printJson(collection, deps.print);
+		else deps.print(`Created collection ${collection.id} (${collection.name})`);
+		return {
+			type: "collection",
+			collection
+		};
+	}
+	if (action === "update") {
+		const collection = await updateCollection(ctx, deps, parsed.positionals[1] || readRequiredOption(parsed, "id"), buildCollectionUpdateRequest(parsed));
+		if (json) printJson(collection, deps.print);
+		else deps.print(`Updated collection ${collection.id} (${collection.name})`);
+		return {
+			type: "collection",
+			collection
+		};
+	}
+	if (action === "delete" || action === "remove-collection") {
+		const collectionId = parsed.positionals[1] || readRequiredOption(parsed, "id");
+		await deleteCollection(ctx, deps, collectionId);
+		if (json) printJson({
+			success: true,
+			collectionId
+		}, deps.print);
+		else deps.print(`Deleted collection ${collectionId}`);
+		return {
+			type: "delete",
+			collectionId
+		};
+	}
+	if (action === "items" || action === "list-items") {
+		const collectionId = parsed.positionals[1] || readRequiredOption(parsed, "collection");
+		const items = await listCollectionItems(ctx, deps, collectionId);
+		if (json) printJson(items, deps.print);
+		else printItems(collectionId, items, deps.print);
+		return {
+			type: "items",
+			collectionId,
+			items
+		};
+	}
+	if (action === "add") {
+		const collectionId = parsed.positionals[1] || readRequiredOption(parsed, "collection");
+		const requests = buildCollectionItemCreateRequests(parsed);
+		if (requests.length === 0) throw new Error("Provide at least one --asset/--assets or --variant/--variants value");
+		const items = [];
+		for (const request of requests) items.push(await createCollectionItem(ctx, deps, collectionId, request));
+		if (json) printJson(items, deps.print);
+		else deps.print(`Added ${items.length} item${items.length === 1 ? "" : "s"} to ${collectionId}`);
+		return {
+			type: "items-added",
+			collectionId,
+			items
+		};
+	}
+	if (action === "update-item") {
+		const collectionId = parsed.positionals[1] || readRequiredOption(parsed, "collection");
+		const item = await updateCollectionItem(ctx, deps, collectionId, parsed.positionals[2] || readRequiredOption(parsed, "item"), buildItemUpdateRequest(parsed));
+		if (json) printJson(item, deps.print);
+		else deps.print(`Updated collection item ${item.id}`);
+		return {
+			type: "item",
+			collectionId,
+			item
+		};
+	}
+	if (action === "reorder") {
+		const collectionId = parsed.positionals[1] || readRequiredOption(parsed, "collection");
+		const itemIds = parseCsvOptions(parsed, ["items", "item-ids"]);
+		if (itemIds.length === 0) throw new Error("Provide --items <item-id,item-id>");
+		const items = await reorderCollectionItems(ctx, deps, collectionId, { itemIds });
+		if (json) printJson(items, deps.print);
+		else deps.print(`Reordered ${items.length} item${items.length === 1 ? "" : "s"} in ${collectionId}`);
+		return {
+			type: "items",
+			collectionId,
+			items
+		};
+	}
+	if (action === "remove" || action === "delete-item") {
+		const collectionId = parsed.positionals[1] || readRequiredOption(parsed, "collection");
+		const itemId = parsed.positionals[2] || readRequiredOption(parsed, "item");
+		await deleteCollectionItem(ctx, deps, collectionId, itemId);
+		if (json) printJson({
+			success: true,
+			collectionId,
+			itemId
+		}, deps.print);
+		else deps.print(`Removed collection item ${itemId}`);
+		return {
+			type: "item-delete",
+			collectionId,
+			itemId
+		};
+	}
+	throw new Error(`Unknown collections command: ${action}`);
+}
+async function buildContext$3(parsed, deps) {
+	const projectConfig = await deps.loadProjectConfig();
+	const env = resolveCommandEnvironment(parsed, projectConfig);
+	const spaceId = resolveCommandSpace(parsed, projectConfig);
+	if (!spaceId) throw new Error("--space is required, or run: makefx init --space <id>");
+	const config = await deps.loadConfig(env);
+	if (!config) throw new Error(`Not logged in to ${env} environment. Run: ${loginCommandForEnvironment(env)}`);
+	if (config.token.expiresAt < Date.now()) throw new Error(`Token expired for ${env} environment. Run: ${loginCommandForEnvironment(env)}`);
+	if (env === "local") process$1.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+	return {
+		env,
+		spaceId,
+		baseUrl: deps.resolveBaseUrl(env),
+		accessToken: config.token.accessToken
+	};
+}
+function buildCollectionCreateRequest(parsed, name) {
+	const request = { name };
+	const id = readOption(parsed, "id");
+	if (id !== void 0) request.id = id;
+	applyCollectionOptions(request, parsed);
+	return request;
+}
+function buildCollectionUpdateRequest(parsed) {
+	const request = {};
+	const name = readOption(parsed, "name");
+	if (name !== void 0) request.name = name;
+	applyCollectionOptions(request, parsed);
+	if (Object.keys(request).length === 0) throw new Error("No collection updates provided");
+	return request;
+}
+function applyCollectionOptions(request, parsed) {
+	const kind = readOption(parsed, "kind");
+	const color = nullableOption(parsed, "color");
+	const description = nullableOption(parsed, "description");
+	const sortIndex = numberOption(parsed, "sort-index", "sortIndex");
+	if (kind !== void 0) request.kind = kind;
+	if (color !== void 0) request.color = color;
+	if (description !== void 0) request.description = description;
+	if (sortIndex !== void 0) request.sortIndex = sortIndex;
+}
+function buildCollectionItemCreateRequests(parsed) {
+	const role = readOption(parsed, "role");
+	const pinnedVariantId = nullableOption(parsed, "pinned-variant", "pinnedVariantId");
+	const sortIndex = numberOption(parsed, "sort-index", "sortIndex");
+	const base = {};
+	if (role !== void 0) base.role = role;
+	if (pinnedVariantId !== void 0) base.pinnedVariantId = pinnedVariantId;
+	if (sortIndex !== void 0) base.sortIndex = sortIndex;
+	return [...parseCsvOptions(parsed, ["asset", "assets"]).map((assetId) => ({
+		...base,
+		subjectType: "asset",
+		assetId
+	})), ...parseCsvOptions(parsed, ["variant", "variants"]).map((variantId) => ({
+		...base,
+		subjectType: "variant",
+		variantId
+	}))];
+}
+function buildItemUpdateRequest(parsed) {
+	const request = {};
+	const role = readOption(parsed, "role");
+	const pinnedVariantId = nullableOption(parsed, "pinned-variant", "pinnedVariantId");
+	const sortIndex = numberOption(parsed, "sort-index", "sortIndex");
+	if (role !== void 0) request.role = role;
+	if (pinnedVariantId !== void 0) request.pinnedVariantId = pinnedVariantId;
+	if (sortIndex !== void 0) request.sortIndex = sortIndex;
+	if (Object.keys(request).length === 0) throw new Error("No collection item updates provided");
+	return request;
+}
+async function listCollections(ctx, deps) {
+	return (await apiFetch("GET /api/spaces/:id/collections", {
+		baseUrl: ctx.baseUrl,
+		fetch: deps.fetch,
+		params: { id: ctx.spaceId },
+		headers: authHeaders(ctx)
+	})).collections;
+}
+async function createCollection(ctx, deps, json) {
+	return (await apiFetch("POST /api/spaces/:id/collections", {
+		baseUrl: ctx.baseUrl,
+		fetch: deps.fetch,
+		params: { id: ctx.spaceId },
+		json,
+		headers: authHeaders(ctx)
+	})).collection;
+}
+async function updateCollection(ctx, deps, collectionId, json) {
+	return (await apiFetch("PATCH /api/spaces/:id/collections/:collectionId", {
+		baseUrl: ctx.baseUrl,
+		fetch: deps.fetch,
+		params: {
+			id: ctx.spaceId,
+			collectionId
+		},
+		json,
+		headers: authHeaders(ctx)
+	})).collection;
+}
+async function deleteCollection(ctx, deps, collectionId) {
+	await apiFetch("DELETE /api/spaces/:id/collections/:collectionId", {
+		baseUrl: ctx.baseUrl,
+		fetch: deps.fetch,
+		params: {
+			id: ctx.spaceId,
+			collectionId
+		},
+		headers: authHeaders(ctx)
+	});
+}
+async function listCollectionItems(ctx, deps, collectionId) {
+	return (await apiFetch("GET /api/spaces/:id/collections/:collectionId/items", {
+		baseUrl: ctx.baseUrl,
+		fetch: deps.fetch,
+		params: {
+			id: ctx.spaceId,
+			collectionId
+		},
+		headers: authHeaders(ctx)
+	})).items;
+}
+async function createCollectionItem(ctx, deps, collectionId, json) {
+	return (await apiFetch("POST /api/spaces/:id/collections/:collectionId/items", {
+		baseUrl: ctx.baseUrl,
+		fetch: deps.fetch,
+		params: {
+			id: ctx.spaceId,
+			collectionId
+		},
+		json,
+		headers: authHeaders(ctx)
+	})).item;
+}
+async function updateCollectionItem(ctx, deps, collectionId, itemId, json) {
+	return (await apiFetch("PATCH /api/spaces/:id/collections/:collectionId/items/:itemId", {
+		baseUrl: ctx.baseUrl,
+		fetch: deps.fetch,
+		params: {
+			id: ctx.spaceId,
+			collectionId,
+			itemId
+		},
+		json,
+		headers: authHeaders(ctx)
+	})).item;
+}
+async function reorderCollectionItems(ctx, deps, collectionId, json) {
+	return (await apiFetch("POST /api/spaces/:id/collections/:collectionId/items/reorder", {
+		baseUrl: ctx.baseUrl,
+		fetch: deps.fetch,
+		params: {
+			id: ctx.spaceId,
+			collectionId
+		},
+		json,
+		headers: authHeaders(ctx)
+	})).items;
+}
+async function deleteCollectionItem(ctx, deps, collectionId, itemId) {
+	await apiFetch("DELETE /api/spaces/:id/collections/:collectionId/items/:itemId", {
+		baseUrl: ctx.baseUrl,
+		fetch: deps.fetch,
+		params: {
+			id: ctx.spaceId,
+			collectionId,
+			itemId
+		},
+		headers: authHeaders(ctx)
+	});
+}
+function printCollections(collections, print) {
+	if (collections.length === 0) {
+		print("No collections found.");
+		return;
+	}
+	for (const collection of collections) {
+		const suffix = collection.description ? ` - ${collection.description}` : "";
+		print(`${collection.id}\t${collection.name}\t${collection.kind}${suffix}`);
+	}
+}
+function printItems(collectionId, items, print) {
+	if (items.length === 0) {
+		print(`No items found in ${collectionId}.`);
+		return;
+	}
+	for (const item of items) {
+		const subject = item.subject_type === "asset" ? `asset:${item.asset_id}` : `variant:${item.variant_id}`;
+		const pinned = item.pinned_variant_id ? ` pinned:${item.pinned_variant_id}` : "";
+		print(`${item.id}\t${subject}\t${item.role}${pinned}`);
+	}
+}
+function printJson(value, print) {
+	print(JSON.stringify(value, null, 2));
+}
+function authHeaders(ctx) {
+	return {
+		"Authorization": `Bearer ${ctx.accessToken}`,
+		"Accept": "application/json"
+	};
+}
+function readOption(parsed, ...keys) {
+	for (const key of keys) {
+		const value = parsed.options[key];
+		if (value !== void 0 && value !== "true") return value;
+	}
+}
+function readRequiredOption(parsed, ...keys) {
+	const value = readOption(parsed, ...keys);
+	if (!value) throw new Error(`Missing required option --${keys[0]}`);
+	return value;
+}
+function nullableOption(parsed, ...keys) {
+	for (const key of keys) {
+		if (!(key in parsed.options)) continue;
+		const value = parsed.options[key];
+		if (value === "null" || value === "none" || value === "") return null;
+		if (value !== "true") return value;
+	}
+}
+function numberOption(parsed, ...keys) {
+	const value = readOption(parsed, ...keys);
+	if (value === void 0) return void 0;
+	const number = Number(value);
+	if (!Number.isInteger(number)) throw new Error(`Expected integer for --${keys[0]}`);
+	return number;
+}
+function parseCsvOptions(parsed, keys) {
+	return keys.flatMap((key) => (parsed.options[key] || "").split(",").map((value) => value.trim()).filter(Boolean));
+}
+function printUsage$2() {
+	console.error(`Usage:
+  makefx collections list [--json]
+  makefx collections create <name> [--kind <kind>] [--description <text>] [--json]
+  makefx collections update <collection-id> [--name <name>] [--description <text>] [--json]
+  makefx collections delete <collection-id> [--json]
+  makefx collections items <collection-id> [--json]
+  makefx collections add <collection-id> --asset <asset-id>[,<asset-id>] [--variant <variant-id>] [--role <role>] [--json]
+  makefx collections update-item <collection-id> <item-id> [--role <role>] [--pinned-variant <variant-id|none>] [--sort-index <n>] [--json]
+  makefx collections reorder <collection-id> --items <item-id,item-id> [--json]
+  makefx collections remove <collection-id> <item-id> [--json]`);
+}
+//#endregion
 //#region src/cli/commands/usage.ts
 var defaultDeps$2 = {
 	loadConfig: loadStoredConfig,
@@ -25717,7 +26247,7 @@ Options:
 }
 //#endregion
 //#region src/cli/index.ts
-var CLI_VERSION = "0.2.1+2f99bf2b725b";
+var CLI_VERSION = "0.2.3+5e6f9cfaba00";
 async function main() {
 	const argv = process$1.argv.slice(2);
 	if (argv[0] === "--") argv.shift();
@@ -25858,6 +26388,10 @@ function printCommandHelp(command, positionals) {
 		case "style":
 			printStylesHelp();
 			return;
+		case "collections":
+		case "collection":
+			printCollectionsHelp();
+			return;
 		case "rotation":
 			printRotationHelp();
 			return;
@@ -25911,6 +26445,7 @@ Project:
   styles presets                  List style presets
   styles collections              List style reference collections
   styles references               List style reference assets
+  collections                     Manage normal Space collections
 ${rotationHelp}
   tileset "prompt" --type terrain --grid 3x3
                                  Generate a consistent tile set
@@ -25935,6 +26470,10 @@ Spaces:
   spaces --details [--json]    List spaces with asset summaries
   spaces --id <id> [--json]    Show details for a specific space
   spaces create <name>         Create a new space
+  spaces delete <id> [--json]  Archive a space for support recovery
+  spaces inspect-deleted <id> [--json]
+                               Inspect an archived space as an admin
+  spaces restore <id> [--json] Restore an archived space as an admin
 
 Listen:
   listen --space <id>          Connect to space WebSocket and stream all events
@@ -25989,6 +26528,7 @@ Examples:
   makefx productions export --production-id s01e01-a2
   makefx upload hero.png --name "Hero" --collection collection_cast
   makefx upload hero.png --name "Hero" --collection-name "Cast" --json
+  makefx collections add collection_cast --asset asset_123 --role character
   makefx upload thumbnail.png --asset asset_thumb --manual-relation thumbnail_for:asset:asset_target
   makefx assets
   makefx usage --from 2026-06-01
@@ -26053,6 +26593,9 @@ Usage:
   makefx spaces --id <space_id> [--json]
   makefx spaces create <name>
   makefx spaces create --name "My Space" [--init] [--json]
+  makefx spaces delete <space_id> [--json]
+  makefx spaces inspect-deleted <space_id> [--json]
+  makefx spaces restore <space_id> [--json]
 `);
 }
 function printListenHelp() {
@@ -26079,7 +26622,8 @@ Options:
   --provider <name> Provider provenance for uploaded media
   --provider-metadata <json>     Provider metadata JSON object
   --generation-provenance <json> Extra provenance JSON object
-  --source-variant <id>          Existing source variant for upload lineage
+  --source-variant <ids>         Comma-separated source variants for upload lineage
+  --source-variants <ids>        Alias for --source-variant
   --relation-type <type>         Lineage type: derived, refined, or forked (default: derived)
   --active-variant-behavior <b>  if-missing, set-active, or keep
   --collection <ids>             Comma-separated collection IDs for the uploaded asset or variant
@@ -26391,6 +26935,34 @@ Options:
   --local           Shortcut for --env local
 `);
 }
+function printCollectionsHelp() {
+	console.log(`
+Usage:
+  makefx collections list [--json]
+  makefx collections create <name> [--kind cast|backgrounds|scenes|thumbnails|maps|deliverables|custom] [--color <hex>] [--description <text>] [--sort-index <n>] [--json]
+  makefx collections update <collection-id> [--name <name>] [--kind cast|backgrounds|scenes|thumbnails|maps|deliverables|custom] [--color <hex|none>] [--description <text|none>] [--sort-index <n>] [--json]
+  makefx collections delete <collection-id> [--json]
+  makefx collections items <collection-id> [--json]
+  makefx collections add <collection-id> --asset <asset-id>[,<asset-id>] [--variant <variant-id>[,<variant-id>]] [--role <role>] [--pinned-variant <variant-id|none>] [--sort-index <n>] [--json]
+  makefx collections update-item <collection-id> <item-id> [--role <role>] [--pinned-variant <variant-id|none>] [--sort-index <n>] [--json]
+  makefx collections reorder <collection-id> --items <item-id,item-id> [--json]
+  makefx collections remove <collection-id> <item-id> [--json]
+
+Model:
+  Collections organize existing Space assets or exact variants. They do not
+  change generation lineage.
+
+Options:
+  --space <id>      Target space ID; defaults from the initialized project
+  --asset <ids>     Comma-separated asset IDs to add
+  --assets <ids>    Alias for --asset
+  --variant <ids>   Comma-separated variant IDs to add
+  --variants <ids>  Alias for --variant
+  --json            Print machine-readable output
+  --env <env>       Environment (production|stage|local)
+  --local           Shortcut for --env local
+`);
+}
 function printRotationHelp() {
 	if (!isCliRotationEnabled()) {
 		console.log(rotationDisabledMessage());
@@ -26554,6 +27126,10 @@ async function dispatchCommand(command, parsed) {
 		case "style":
 			await handleStyles(parsed);
 			break;
+		case "collections":
+		case "collection":
+			await handleCollections(parsed);
+			break;
 		case "rotation":
 			await handleRotation(parsed);
 			break;