@playdrop/playdrop-cli 0.16.5 → 0.16.12

package/dist/catalogue.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.APP_DESCRIPTION_RECOMMENDED_MIN_WORDS = exports.APP_DESCRIPTION_RECOMMENDED_MIN_CHARACTERS = void 0;
+exports.APP_RELEASE_NOTES_MAX_CHARACTERS = exports.APP_DESCRIPTION_RECOMMENDED_MIN_WORDS = exports.APP_DESCRIPTION_RECOMMENDED_MIN_CHARACTERS = void 0;
+exports.normalizeAppReleaseNotes = normalizeAppReleaseNotes;
 exports.validateAppMetadata = validateAppMetadata;
 exports.resolveCatalogueTagGroups = resolveCatalogueTagGroups;
 exports.resolveCatalogueEntries = resolveCatalogueEntries;
@@ -15,19 +16,20 @@ const assetSpecs_1 = require("./assetSpecs");
 const catalogue_utils_1 = require("./catalogue-utils");
 const HEX_COLOR_REGEX = /^#?(?:[0-9a-fA-F]{6})$/;
 const SEMVER_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
-const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
+const LEGACY_CATALOGUE_VERSION_KEY = ["schema", "Version"].join("");
 const ASSET_CATEGORY_SET = new Set(types_1.ASSET_CATEGORY_VALUES);
-const LISTING_IMAGE_EXTENSIONS = new Set(['.png']);
-const LISTING_VIDEO_EXTENSIONS = new Set(['.mp4']);
+const LISTING_IMAGE_EXTENSIONS = new Set([".png"]);
+const LISTING_VIDEO_EXTENSIONS = new Set([".mp4"]);
 exports.APP_DESCRIPTION_RECOMMENDED_MIN_CHARACTERS = 120;
 exports.APP_DESCRIPTION_RECOMMENDED_MIN_WORDS = 20;
-const BOXEL_GENERATED_FILE_ROLES = new Set(['mesh', 'preview']);
-const BOXEL_REQUIRED_FILE_ROLES = ['primary', 'mesh', 'preview'];
-const VOX_GENERATED_FILE_ROLES = new Set(['boxel', 'mesh', 'preview']);
-const VOX_REQUIRED_FILE_ROLES = ['primary', 'boxel', 'mesh', 'preview'];
+exports.APP_RELEASE_NOTES_MAX_CHARACTERS = 240;
+const BOXEL_GENERATED_FILE_ROLES = new Set(["mesh", "preview"]);
+const BOXEL_REQUIRED_FILE_ROLES = ["primary", "mesh", "preview"];
+const VOX_GENERATED_FILE_ROLES = new Set(["boxel", "mesh", "preview"]);
+const VOX_REQUIRED_FILE_ROLES = ["primary", "boxel", "mesh", "preview"];
 const MAX_CONTENT_TAGS_PER_ITEM = 20;
-const APP_ALLOWED_LICENSES = new Set(['CLOSED', 'PLAYDROP', 'MIT']);
-const ASSET_ALLOWED_LICENSES = new Set(['CLOSED', 'PLAYDROP', 'CC0']);
+const APP_ALLOWED_LICENSES = new Set(["CLOSED", "PLAYDROP", "MIT"]);
+const ASSET_ALLOWED_LICENSES = new Set(["CLOSED", "PLAYDROP", "CC0"]);
 const ASSET_SUBCATEGORY_SET_BY_CATEGORY = types_1.ASSET_SUBCATEGORY_DEFINITIONS.reduce((acc, definition) => {
     if (!acc[definition.category]) {
         acc[definition.category] = new Set();
@@ -35,28 +37,47 @@ const ASSET_SUBCATEGORY_SET_BY_CATEGORY = types_1.ASSET_SUBCATEGORY_DEFINITIONS.
     acc[definition.category].add(definition.subcategory);
     return acc;
 }, {});
+function normalizeAppReleaseNotes(value, options = {}) {
+    if (value === undefined) {
+        if (options.required) {
+            throw new Error("agent_task_release_notes_missing: catalogue releaseNotes must contain one line with 1..240 characters.");
+        }
+        return undefined;
+    }
+    const releaseNotes = value.trim();
+    if (!releaseNotes) {
+        throw new Error("agent_task_release_notes_missing: catalogue releaseNotes must contain one line with 1..240 characters.");
+    }
+    if (/[\r\n]/.test(releaseNotes)) {
+        throw new Error(`agent_task_release_notes_multiline: releaseNotes has ${releaseNotes.split(/\r\n|\r|\n/).length} lines; expected one line with 1..240 characters.`);
+    }
+    if (releaseNotes.length > exports.APP_RELEASE_NOTES_MAX_CHARACTERS) {
+        throw new Error(`agent_task_release_notes_too_long: releaseNotes length=${releaseNotes.length}; expected 1..240 characters on one line.`);
+    }
+    return releaseNotes;
+}
 function normalizeFileRole(role) {
     return role.trim().toLowerCase();
 }
 function inferGeneratedModel3DFormat(category, subcategory, format, files) {
-    if (category !== 'MODEL_3D' || !(0, types_1.isModel3DAssetSubcategory)('MODEL_3D', subcategory)) {
+    if (category !== "MODEL_3D" || !(0, types_1.isModel3DAssetSubcategory)("MODEL_3D", subcategory)) {
         return null;
     }
-    const normalizedFormat = typeof format === 'string' ? format.trim().toUpperCase() : '';
-    if (normalizedFormat === 'PLAYDROP_BOXEL_JSON' || normalizedFormat === 'VOX') {
+    const normalizedFormat = typeof format === "string" ? format.trim().toUpperCase() : "";
+    if (normalizedFormat === "PLAYDROP_BOXEL_JSON" || normalizedFormat === "VOX") {
         return normalizedFormat;
     }
-    const primary = typeof files?.primary === 'string' ? files.primary.trim().toLowerCase() : '';
-    if (primary.endsWith('.boxel.json')) {
-        return 'PLAYDROP_BOXEL_JSON';
+    const primary = typeof files?.primary === "string" ? files.primary.trim().toLowerCase() : "";
+    if (primary.endsWith(".boxel.json")) {
+        return "PLAYDROP_BOXEL_JSON";
     }
-    if (primary.endsWith('.vox')) {
-        return 'VOX';
+    if (primary.endsWith(".vox")) {
+        return "VOX";
     }
     return null;
 }
 function getGeneratedModel3DFileRoles(format) {
-    if (format === 'VOX') {
+    if (format === "VOX") {
         return {
             generated: VOX_GENERATED_FILE_ROLES,
             required: VOX_REQUIRED_FILE_ROLES,
@@ -69,15 +90,15 @@ function getGeneratedModel3DFileRoles(format) {
 }
 function extractGlbJsonChunk(buffer) {
     if (buffer.length < 20) {
-        throw new Error('invalid_glb_payload');
+        throw new Error("invalid_glb_payload");
     }
-    if (buffer.toString('utf8', 0, 4) !== 'glTF') {
-        throw new Error('invalid_glb_payload');
+    if (buffer.toString("utf8", 0, 4) !== "glTF") {
+        throw new Error("invalid_glb_payload");
     }
     const version = buffer.readUInt32LE(4);
     const declaredLength = buffer.readUInt32LE(8);
     if (version !== 2 || declaredLength !== buffer.length) {
-        throw new Error('invalid_glb_payload');
+        throw new Error("invalid_glb_payload");
     }
     let offset = 12;
     while (offset + 8 <= buffer.length) {
@@ -85,45 +106,41 @@ function extractGlbJsonChunk(buffer) {
         const chunkType = buffer.readUInt32LE(offset + 4);
         offset += 8;
         if (offset + chunkLength > buffer.length) {
-            throw new Error('invalid_glb_payload');
+            throw new Error("invalid_glb_payload");
         }
         const chunk = buffer.subarray(offset, offset + chunkLength);
         offset += chunkLength;
-        if (chunkType !== 0x4E4F534A) {
+        if (chunkType !== 0x4e4f534a) {
             continue;
         }
-        const payload = chunk.toString('utf8').replace(/\0+$/, '').trimEnd();
+        const payload = chunk.toString("utf8").replace(/\0+$/, "").trimEnd();
         try {
             const parsed = JSON.parse(payload);
-            if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-                throw new Error('invalid_glb_payload');
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+                throw new Error("invalid_glb_payload");
             }
             return parsed;
         }
         catch {
-            throw new Error('invalid_glb_payload');
+            throw new Error("invalid_glb_payload");
         }
     }
-    throw new Error('invalid_glb_payload');
+    throw new Error("invalid_glb_payload");
 }
 function validateSelfContainedGlb(filePath) {
     const gltf = extractGlbJsonChunk((0, node_fs_1.readFileSync)(filePath));
     const buffers = Array.isArray(gltf.buffers) ? gltf.buffers : [];
     for (const entry of buffers) {
-        const uri = entry && typeof entry === 'object' && typeof entry.uri === 'string'
-            ? entry.uri.trim()
-            : '';
-        if (uri && !uri.startsWith('data:')) {
-            throw new Error('glb_external_dependency_unsupported');
+        const uri = entry && typeof entry === "object" && typeof entry.uri === "string" ? entry.uri.trim() : "";
+        if (uri && !uri.startsWith("data:")) {
+            throw new Error("glb_external_dependency_unsupported");
         }
     }
     const images = Array.isArray(gltf.images) ? gltf.images : [];
     for (const entry of images) {
-        const uri = entry && typeof entry === 'object' && typeof entry.uri === 'string'
-            ? entry.uri.trim()
-            : '';
-        if (uri && !uri.startsWith('data:')) {
-            throw new Error('glb_external_dependency_unsupported');
+        const uri = entry && typeof entry === "object" && typeof entry.uri === "string" ? entry.uri.trim() : "";
+        if (uri && !uri.startsWith("data:")) {
+            throw new Error("glb_external_dependency_unsupported");
         }
     }
 }
@@ -166,10 +183,10 @@ function validateListingAssetPath(baseDir, relativePath, fieldName) {
 }
 function validateListingAssetExtension(relativePath, fieldName, kind) {
     const extension = (0, node_path_1.extname)(relativePath).toLowerCase();
-    if (kind === 'image' && !LISTING_IMAGE_EXTENSIONS.has(extension)) {
+    if (kind === "image" && !LISTING_IMAGE_EXTENSIONS.has(extension)) {
         return `${fieldName} must use a .png file. Received "${relativePath}".`;
     }
-    if (kind === 'video' && !LISTING_VIDEO_EXTENSIONS.has(extension)) {
+    if (kind === "video" && !LISTING_VIDEO_EXTENSIONS.has(extension)) {
         return `${fieldName} must use a .mp4 file. Received "${relativePath}".`;
     }
     return undefined;
@@ -199,14 +216,8 @@ function resolveListingMediaEntries(input) {
     for (let index = 0; index < input.value.length; index += 1) {
         const value = input.value[index];
         const fieldName = `${input.fieldName}[${index}]`;
-        const objectValue = value && typeof value === 'object' && !Array.isArray(value)
-            ? value
-            : null;
-        const relativePath = typeof value === 'string'
-            ? value.trim()
-            : typeof objectValue?.path === 'string'
-                ? objectValue.path.trim()
-                : '';
+        const objectValue = value && typeof value === "object" && !Array.isArray(value) ? value : null;
+        const relativePath = typeof value === "string" ? value.trim() : typeof objectValue?.path === "string" ? objectValue.path.trim() : "";
         if (!relativePath) {
             return { paths, metadata, error: `${fieldName} must be a path string or an object with a non-empty path` };
         }
@@ -222,22 +233,26 @@ function resolveListingMediaEntries(input) {
             fileKey: `${input.fileKeyPrefix}:${index}`,
         };
         if (objectValue) {
-            for (const key of ['title', 'alt', 'caption', 'description']) {
+            for (const key of ["title", "alt", "caption", "description"]) {
                 const raw = objectValue[key];
                 if (raw === undefined) {
                     continue;
                 }
-                if (typeof raw !== 'string' || raw.trim().length === 0) {
+                if (typeof raw !== "string" || raw.trim().length === 0) {
                     return { paths, metadata, error: `${fieldName}.${key} must be a non-empty string when provided` };
                 }
                 const normalized = raw.trim();
                 if (normalized.length > LISTING_MEDIA_TEXT_LIMITS[key]) {
-                    return { paths, metadata, error: `${fieldName}.${key} must be ${LISTING_MEDIA_TEXT_LIMITS[key]} characters or fewer` };
+                    return {
+                        paths,
+                        metadata,
+                        error: `${fieldName}.${key} must be ${LISTING_MEDIA_TEXT_LIMITS[key]} characters or fewer`,
+                    };
                 }
                 item[key] = normalized;
             }
             if (objectValue.slug !== undefined) {
-                if (typeof objectValue.slug !== 'string' || !LISTING_MEDIA_SLUG_REGEX.test(objectValue.slug.trim())) {
+                if (typeof objectValue.slug !== "string" || !LISTING_MEDIA_SLUG_REGEX.test(objectValue.slug.trim())) {
                     return { paths, metadata, error: `${fieldName}.slug must use lowercase words separated by hyphens` };
                 }
                 item.slug = objectValue.slug.trim();
@@ -252,7 +267,7 @@ function normalizeCatalogueRemixRef(value, expectedKind, errors, context) {
     if (value === undefined || value === null) {
         return undefined;
     }
-    if (typeof value !== 'string') {
+    if (typeof value !== "string") {
         errors.push(`${context} remix must be a canonical ${expectedKind} version ref string.`);
         return undefined;
     }
@@ -278,15 +293,15 @@ function normalizeCatalogueRelations(value, errors, context) {
     }
     const rows = [];
     for (const relation of value) {
-        if (!relation || typeof relation !== 'object') {
+        if (!relation || typeof relation !== "object") {
             continue;
         }
-        const type = typeof relation.type === 'string' ? relation.type.trim().toUpperCase() : '';
-        const to = typeof relation.to === 'string' ? relation.to.trim() : '';
+        const type = typeof relation.type === "string" ? relation.type.trim().toUpperCase() : "";
+        const to = typeof relation.to === "string" ? relation.to.trim() : "";
         if (!type || !to) {
             continue;
         }
-        if (type === 'REMIXES') {
+        if (type === "REMIXES") {
             errors.push(`${context} relations must not use REMIXES. Use the dedicated remix field instead.`);
             continue;
         }
@@ -303,17 +318,17 @@ function normalizeCatalogueAppDependencyAssets(value, errors, context) {
     const seenRuntimeKeys = new Set();
     for (let index = 0; index < value.length; index += 1) {
         const entry = value[index];
-        const ref = typeof entry === 'string'
+        const ref = typeof entry === "string"
             ? entry.trim()
-            : entry && typeof entry === 'object' && !Array.isArray(entry) && typeof entry.ref === 'string'
+            : entry && typeof entry === "object" && !Array.isArray(entry) && typeof entry.ref === "string"
                 ? entry.ref.trim()
-                : '';
+                : "";
         if (!ref) {
             errors.push(`${context} uses.assets[${index}] must be a non-empty asset ref string or { ref, runtimeKey } object.`);
             continue;
         }
         const parsed = (0, types_1.parseContentVersionRef)(ref);
-        if (!parsed || parsed.kind !== 'asset') {
+        if (!parsed || parsed.kind !== "asset") {
             errors.push(`${context} uses.assets[${index}] must be a canonical asset version ref.`);
             continue;
         }
@@ -322,9 +337,9 @@ function normalizeCatalogueAppDependencyAssets(value, errors, context) {
             errors.push(`${context} uses.assets contains duplicate ref "${normalizedRef}".`);
             continue;
         }
-        const runtimeKey = entry && typeof entry === 'object' && !Array.isArray(entry) && typeof entry.runtimeKey === 'string'
+        const runtimeKey = entry && typeof entry === "object" && !Array.isArray(entry) && typeof entry.runtimeKey === "string"
             ? entry.runtimeKey.trim()
-            : '';
+            : "";
         if (runtimeKey) {
             if (seenRuntimeKeys.has(runtimeKey)) {
                 errors.push(`${context} uses.assets contains duplicate runtimeKey "${runtimeKey}".`);
@@ -352,12 +367,12 @@ function normalizeCatalogueAppDependencyPacks(value, errors, context) {
     const seenRefs = new Set();
     for (let index = 0; index < value.length; index += 1) {
         const entry = value[index];
-        if (typeof entry !== 'string' || entry.trim().length === 0) {
+        if (typeof entry !== "string" || entry.trim().length === 0) {
             errors.push(`${context} uses.packs[${index}] must be a non-empty pack version ref string. Use "pack:playdrop/name@version", not { ref, runtimeKey }.`);
             continue;
         }
         const parsed = (0, types_1.parseContentVersionRef)(entry.trim());
-        if (!parsed || parsed.kind !== 'pack') {
+        if (!parsed || parsed.kind !== "pack") {
             errors.push(`${context} uses.packs[${index}] must be a canonical pack version ref.`);
             continue;
         }
@@ -372,7 +387,7 @@ function normalizeCatalogueAppDependencyPacks(value, errors, context) {
     return rows;
 }
 function rejectLegacyShopPriceCoinsField(value, errors, context) {
-    if (Object.prototype.hasOwnProperty.call(value, 'shopPriceCoins')) {
+    if (Object.prototype.hasOwnProperty.call(value, "shopPriceCoins")) {
         errors.push(`${context} uses legacy shopPriceCoins. Rename it to shopPriceCredits.`);
         return true;
     }
@@ -390,11 +405,11 @@ function normalizeCatalogueTags(value, errors, context) {
     const seenRefs = new Set();
     for (let index = 0; index < value.length; index += 1) {
         const entry = value[index];
-        if (typeof entry !== 'string' || entry.trim().length === 0) {
+        if (typeof entry !== "string" || entry.trim().length === 0) {
             errors.push(`${context} tags[${index}] must be a non-empty canonical tag ref string.`);
             continue;
         }
-        let normalizedRef = '';
+        let normalizedRef = "";
         try {
             normalizedRef = (0, types_1.normalizeTagRef)(entry);
         }
@@ -426,9 +441,9 @@ function normalizeCatalogueAllowedTargetKinds(value, errors, context) {
     const seenKinds = new Set();
     for (let index = 0; index < value.length; index += 1) {
         const entry = value[index];
-        const normalizedKind = typeof entry === 'string' ? entry.trim().toUpperCase() : '';
+        const normalizedKind = typeof entry === "string" ? entry.trim().toUpperCase() : "";
         if (!types_1.SAVED_ITEM_KIND_VALUES.includes(normalizedKind)) {
-            errors.push(`${context} allowedTargetKinds[${index}] must be one of ${types_1.SAVED_ITEM_KIND_VALUES.join(', ')}.`);
+            errors.push(`${context} allowedTargetKinds[${index}] must be one of ${types_1.SAVED_ITEM_KIND_VALUES.join(", ")}.`);
             continue;
         }
         const savedItemKind = normalizedKind;
@@ -442,8 +457,8 @@ function normalizeCatalogueAllowedTargetKinds(value, errors, context) {
     return normalizedKinds;
 }
 function normalizeRelativePath(root, target) {
-    const rel = (0, node_path_1.relative)(root, target).split(node_path_1.sep).join('/');
-    return rel.replace(/^\/+/, '');
+    const rel = (0, node_path_1.relative)(root, target).split(node_path_1.sep).join("/");
+    return rel.replace(/^\/+/, "");
 }
 function tryRealpath(path) {
     try {
@@ -455,34 +470,34 @@ function tryRealpath(path) {
 }
 function normalizePathForComparison(path) {
     const actual = tryRealpath(path) ?? (0, node_path_1.resolve)(path);
-    return actual.split(node_path_1.sep).join('/');
+    return actual.split(node_path_1.sep).join("/");
 }
 function shouldSkipDirectory(name) {
     if (!name)
         return true;
-    if (name === '.' || name === '..')
+    if (name === "." || name === "..")
         return true;
-    if (name.startsWith('.'))
+    if (name.startsWith("."))
         return true;
-    return name === 'node_modules';
+    return name === "node_modules";
 }
 function readCatalogueFile(rootDir, filePath) {
     try {
-        const raw = (0, node_fs_1.readFileSync)(filePath, 'utf8');
+        const raw = (0, node_fs_1.readFileSync)(filePath, "utf8");
         const parsed = JSON.parse(raw);
-        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-            return { error: 'catalogue.json must contain a JSON object' };
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            return { error: "catalogue.json must contain a JSON object" };
         }
         if (Object.prototype.hasOwnProperty.call(parsed, LEGACY_CATALOGUE_VERSION_KEY)) {
-            return { error: 'catalogue.json must not define the legacy top-level version field. Remove it and retry.' };
+            return { error: "catalogue.json must not define the legacy top-level version field. Remove it and retry." };
         }
-        const forbiddenKeys = ['avatars', 'humanoids', 'creatures', 'blocks', 'games'];
+        const forbiddenKeys = ["avatars", "humanoids", "creatures", "blocks", "games"];
         for (const key of forbiddenKeys) {
             if (Object.prototype.hasOwnProperty.call(parsed, key)) {
                 return { error: `catalogue.json forbids top-level "${key}"` };
             }
         }
-        const allowedKeys = new Set(['apps', 'tagGroups', 'assetSpecs', 'assets', 'assetPacks']);
+        const allowedKeys = new Set(["apps", "tagGroups", "assetSpecs", "assets", "assetPacks"]);
         const unknownKeys = Object.keys(parsed).filter((key) => !allowedKeys.has(key));
         if (unknownKeys.length > 0) {
             return {
@@ -490,18 +505,18 @@ function readCatalogueFile(rootDir, filePath) {
             };
         }
         const directory = (0, node_path_1.dirname)(filePath);
-        const relativePath = (0, node_path_1.relative)(rootDir, filePath) || 'catalogue.json';
+        const relativePath = (0, node_path_1.relative)(rootDir, filePath) || "catalogue.json";
         return {
             file: {
                 absolutePath: filePath,
-                relativePath: relativePath.replace(/\\/g, '/'),
+                relativePath: relativePath.replace(/\\/g, "/"),
                 directory,
                 data: parsed,
             },
         };
     }
     catch (error) {
-        return { error: `Invalid catalogue.json (${error?.message || 'failed to parse JSON'})` };
+        return { error: `Invalid catalogue.json (${error?.message || "failed to parse JSON"})` };
     }
 }
 function walkCatalogueTree(rootDir) {
@@ -521,11 +536,11 @@ function walkCatalogueTree(rootDir) {
         if (visited.has(realPath))
             continue;
         visited.add(realPath);
-        const candidate = (0, node_path_1.join)(displayPath, 'catalogue.json');
+        const candidate = (0, node_path_1.join)(displayPath, "catalogue.json");
         if ((0, node_fs_1.existsSync)(candidate) && (0, node_fs_1.statSync)(candidate).isFile()) {
             const result = readCatalogueFile(rootDir, candidate);
             if (result.error) {
-                errors.push(`[${normalizeRelativePath(rootDir, candidate) || 'catalogue.json'}] ${result.error}`);
+                errors.push(`[${normalizeRelativePath(rootDir, candidate) || "catalogue.json"}] ${result.error}`);
             }
             else if (result.file) {
                 files.push(result.file);
@@ -565,7 +580,7 @@ function isCatalogueMarker(file) {
 }
 const packageJsonCache = new Map();
 function resolvePackageJson(projectDir) {
-    const candidate = (0, node_path_1.join)(projectDir, 'package.json');
+    const candidate = (0, node_path_1.join)(projectDir, "package.json");
     if (!(0, node_fs_1.existsSync)(candidate)) {
         return null;
     }
@@ -582,44 +597,44 @@ function readPackageJsonManifest(packageJsonPath) {
         return packageJsonCache.get(packageJsonPath);
     }
     try {
-        const raw = (0, node_fs_1.readFileSync)(packageJsonPath, 'utf8');
+        const raw = (0, node_fs_1.readFileSync)(packageJsonPath, "utf8");
         const parsed = raw.trim() ? JSON.parse(raw) : {};
         packageJsonCache.set(packageJsonPath, parsed);
         return parsed;
     }
     catch (error) {
-        throw new Error(error?.message || 'failed to parse package.json');
+        throw new Error(error?.message || "failed to parse package.json");
     }
 }
 function collectMissingMetadata(entry) {
     const missing = [];
-    if (typeof entry.displayName !== 'string' || !entry.displayName.trim()) {
-        missing.push('displayName');
+    if (typeof entry.displayName !== "string" || !entry.displayName.trim()) {
+        missing.push("displayName");
     }
-    if (typeof entry.description !== 'string' || !entry.description.trim()) {
-        missing.push('description');
+    if (typeof entry.description !== "string" || !entry.description.trim()) {
+        missing.push("description");
     }
-    const emojiProvided = Object.prototype.hasOwnProperty.call(entry, 'emoji');
+    const emojiProvided = Object.prototype.hasOwnProperty.call(entry, "emoji");
     if (!emojiProvided) {
-        missing.push('emoji');
+        missing.push("emoji");
     }
     else {
         const emojiValue = entry.emoji;
         if (emojiValue !== null) {
-            if (typeof emojiValue !== 'string' || !emojiValue.trim()) {
-                missing.push('emoji');
+            if (typeof emojiValue !== "string" || !emojiValue.trim()) {
+                missing.push("emoji");
             }
         }
     }
-    const colorProvided = Object.prototype.hasOwnProperty.call(entry, 'color');
+    const colorProvided = Object.prototype.hasOwnProperty.call(entry, "color");
     if (!colorProvided) {
-        missing.push('color');
+        missing.push("color");
     }
     else {
         const colorValue = entry.color;
         if (colorValue !== null) {
-            if (typeof colorValue !== 'string' || !colorValue.trim()) {
-                missing.push('color');
+            if (typeof colorValue !== "string" || !colorValue.trim()) {
+                missing.push("color");
             }
         }
     }
@@ -627,45 +642,45 @@ function collectMissingMetadata(entry) {
 }
 function formatMissingMetadata(missing) {
     if (missing.length === 0)
-        return '';
+        return "";
     if (missing.length === 1)
         return `no ${missing[0]} provided`;
     if (missing.length === 2)
         return `no ${missing[0]} or ${missing[1]} provided`;
     const last = missing[missing.length - 1];
-    const initial = missing.slice(0, -1).join(', ');
+    const initial = missing.slice(0, -1).join(", ");
     return `no ${initial}, or ${last} provided`;
 }
 function normalizeAssetVisibilityValue(raw, errors, label) {
-    if (typeof raw !== 'string' || raw.trim().length === 0) {
+    if (typeof raw !== "string" || raw.trim().length === 0) {
         return undefined;
     }
     const normalized = raw.trim().toUpperCase();
-    if (normalized !== 'PUBLIC' && normalized !== 'PRIVATE') {
+    if (normalized !== "PUBLIC" && normalized !== "PRIVATE") {
         errors.push(`[${label}] visibility must be PUBLIC or PRIVATE.`);
         return undefined;
     }
     return normalized;
 }
 function normalizeContentLicenseValue(raw, errors, label, allowedValues, defaultValue = types_1.DEFAULT_CONTENT_LICENSE) {
-    if (raw === undefined || raw === null || (typeof raw === 'string' && raw.trim().length === 0)) {
+    if (raw === undefined || raw === null || (typeof raw === "string" && raw.trim().length === 0)) {
         return defaultValue;
     }
     const parsed = (0, types_1.parseContentLicense)(raw);
     if (!parsed || !allowedValues.has(parsed)) {
-        errors.push(`[${label}] license must be one of ${Array.from(allowedValues).join(', ')}.`);
+        errors.push(`[${label}] license must be one of ${Array.from(allowedValues).join(", ")}.`);
         return null;
     }
     return parsed;
 }
 function normalizeInheritedContentLicenseValue(raw, inheritedValue, errors, label, allowedValues) {
-    if (raw === undefined || raw === null || (typeof raw === 'string' && raw.trim().length === 0)) {
+    if (raw === undefined || raw === null || (typeof raw === "string" && raw.trim().length === 0)) {
         return inheritedValue;
     }
     return normalizeContentLicenseValue(raw, errors, label, allowedValues);
 }
 function normalizeAssetCategoryValue(raw, errors, label) {
-    if (typeof raw !== 'string' || raw.trim().length === 0) {
+    if (typeof raw !== "string" || raw.trim().length === 0) {
         errors.push(`${label} must define category.`);
         return null;
     }
@@ -677,17 +692,17 @@ function normalizeAssetCategoryValue(raw, errors, label) {
     return normalized;
 }
 function normalizeAssetSubcategoryValue(raw, category, errors, label) {
-    if (category === 'CUSTOM') {
+    if (category === "CUSTOM") {
         if (raw === undefined || raw === null) {
             return null;
         }
-        if (typeof raw === 'string' && raw.trim().length === 0) {
+        if (typeof raw === "string" && raw.trim().length === 0) {
             return null;
         }
         errors.push(`${label} must not define subcategory when category is CUSTOM.`);
         return null;
     }
-    if (typeof raw !== 'string' || raw.trim().length === 0) {
+    if (typeof raw !== "string" || raw.trim().length === 0) {
         errors.push(`${label} must define subcategory.`);
         return null;
     }
@@ -708,19 +723,19 @@ function validateOptionalEmoji(value, hasEmojiField, errors) {
     if (!hasEmojiField) {
         return emoji;
     }
-    if (emoji !== null && typeof emoji === 'string') {
+    if (emoji !== null && typeof emoji === "string") {
         const trimmed = emoji.trim();
         if (!trimmed) {
             return null;
         }
         if (Array.from(trimmed).length > 4) {
-            errors.push('emoji must be a single character');
+            errors.push("emoji must be a single character");
             return emoji;
         }
         return trimmed;
     }
     if (emoji !== null) {
-        errors.push('emoji must be a string or null');
+        errors.push("emoji must be a string or null");
     }
     return emoji;
 }
@@ -729,19 +744,19 @@ function validateOptionalColor(value, hasColorField, errors) {
     if (!hasColorField) {
         return color;
     }
-    if (color !== null && typeof color === 'string') {
+    if (color !== null && typeof color === "string") {
         const trimmed = color.trim();
         if (!trimmed) {
             return null;
         }
         if (!HEX_COLOR_REGEX.test(trimmed)) {
-            errors.push('color must be a hex RGB value like #FFAA00');
+            errors.push("color must be a hex RGB value like #FFAA00");
             return color;
         }
-        return trimmed.startsWith('#') ? trimmed.toUpperCase() : `#${trimmed.toUpperCase()}`;
+        return trimmed.startsWith("#") ? trimmed.toUpperCase() : `#${trimmed.toUpperCase()}`;
     }
     if (color !== null) {
-        errors.push('color must be a string or null');
+        errors.push("color must be a string or null");
     }
     return color;
 }
@@ -750,17 +765,17 @@ function validateAchievementDefinitions(value, catalogueDir, errors) {
         return [];
     }
     if (!Array.isArray(value)) {
-        errors.push('achievements must be an array');
+        errors.push("achievements must be an array");
         return [];
     }
     const seenKeys = new Set();
     const definitions = [];
     value.forEach((entry, index) => {
-        if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
             errors.push(`achievements[${index}] must be an object`);
             return;
         }
-        const key = typeof entry.key === 'string' ? entry.key.trim() : '';
+        const key = typeof entry.key === "string" ? entry.key.trim() : "";
         if (!(0, types_1.isPlayerMetaKey)(key)) {
             errors.push(`achievements[${index}].key must match the player meta key format`);
             return;
@@ -770,33 +785,33 @@ function validateAchievementDefinitions(value, catalogueDir, errors) {
             return;
         }
         seenKeys.add(key);
-        const displayName = typeof entry.displayName === 'string' ? entry.displayName.trim() : '';
+        const displayName = typeof entry.displayName === "string" ? entry.displayName.trim() : "";
         if (!displayName) {
             errors.push(`achievements[${index}].displayName must be a non-empty string`);
             return;
         }
-        const description = typeof entry.description === 'string' ? entry.description.trim() : '';
+        const description = typeof entry.description === "string" ? entry.description.trim() : "";
         if (!description) {
             errors.push(`achievements[${index}].description must be a non-empty string`);
             return;
         }
         const kind = (0, types_1.parseAppAchievementKind)(entry.kind);
         if (!kind) {
-            errors.push(`achievements[${index}].kind must be one of ${types_1.APP_ACHIEVEMENT_KIND_VALUES.join(', ')}`);
+            errors.push(`achievements[${index}].kind must be one of ${types_1.APP_ACHIEVEMENT_KIND_VALUES.join(", ")}`);
             return;
         }
         const hidden = Boolean(entry.hidden);
-        const status = (0, types_1.parsePlayerMetaDefinitionStatus)(entry.status ?? 'ACTIVE');
+        const status = (0, types_1.parsePlayerMetaDefinitionStatus)(entry.status ?? "ACTIVE");
         if (!status) {
-            errors.push(`achievements[${index}].status must be one of ${types_1.PLAYER_META_DEFINITION_STATUS_VALUES.join(', ')}`);
+            errors.push(`achievements[${index}].status must be one of ${types_1.PLAYER_META_DEFINITION_STATUS_VALUES.join(", ")}`);
             return;
         }
-        const icon = typeof entry.icon === 'string' ? entry.icon.trim() : '';
+        const icon = typeof entry.icon === "string" ? entry.icon.trim() : "";
         if (!icon) {
             errors.push(`achievements[${index}].icon must be a non-empty PNG path`);
             return;
         }
-        const iconExtensionError = validateListingAssetExtension(icon, `achievements[${index}].icon`, 'image');
+        const iconExtensionError = validateListingAssetExtension(icon, `achievements[${index}].icon`, "image");
         if (iconExtensionError) {
             errors.push(iconExtensionError);
             return;
@@ -808,7 +823,7 @@ function validateAchievementDefinitions(value, catalogueDir, errors) {
         }
         const iconPath = resolveListingAssetPath(catalogueDir, icon);
         let maxProgress;
-        if (kind === 'INCREMENTAL') {
+        if (kind === "INCREMENTAL") {
             if (!Number.isSafeInteger(entry.maxProgress) || Number(entry.maxProgress) <= 0) {
                 errors.push(`achievements[${index}].maxProgress must be a positive safe integer`);
                 return;
@@ -838,17 +853,17 @@ function validateLeaderboardDefinitions(value, errors) {
         return [];
     }
     if (!Array.isArray(value)) {
-        errors.push('leaderboards must be an array');
+        errors.push("leaderboards must be an array");
         return [];
     }
     const seenKeys = new Set();
     const definitions = [];
     value.forEach((entry, index) => {
-        if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
             errors.push(`leaderboards[${index}] must be an object`);
             return;
         }
-        const key = typeof entry.key === 'string' ? entry.key.trim() : '';
+        const key = typeof entry.key === "string" ? entry.key.trim() : "";
         if (!(0, types_1.isPlayerMetaKey)(key)) {
             errors.push(`leaderboards[${index}].key must match the player meta key format`);
             return;
@@ -858,36 +873,36 @@ function validateLeaderboardDefinitions(value, errors) {
             return;
         }
         seenKeys.add(key);
-        const displayName = typeof entry.displayName === 'string' ? entry.displayName.trim() : '';
+        const displayName = typeof entry.displayName === "string" ? entry.displayName.trim() : "";
         if (!displayName) {
             errors.push(`leaderboards[${index}].displayName must be a non-empty string`);
             return;
         }
-        const description = typeof entry.description === 'string' ? entry.description.trim() : '';
+        const description = typeof entry.description === "string" ? entry.description.trim() : "";
         if (!description) {
             errors.push(`leaderboards[${index}].description must be a non-empty string`);
             return;
         }
         const scoreType = (0, types_1.parseAppLeaderboardScoreType)(entry.scoreType);
         if (!scoreType) {
-            errors.push(`leaderboards[${index}].scoreType must be one of ${types_1.APP_LEADERBOARD_SCORE_TYPE_VALUES.join(', ')}`);
+            errors.push(`leaderboards[${index}].scoreType must be one of ${types_1.APP_LEADERBOARD_SCORE_TYPE_VALUES.join(", ")}`);
             return;
         }
         const sort = (0, types_1.parseAppLeaderboardSort)(entry.sort);
         if (!sort) {
-            errors.push(`leaderboards[${index}].sort must be one of ${types_1.APP_LEADERBOARD_SORT_VALUES.join(', ')}`);
+            errors.push(`leaderboards[${index}].sort must be one of ${types_1.APP_LEADERBOARD_SORT_VALUES.join(", ")}`);
             return;
         }
         if (!(0, types_1.isValidLeaderboardDefinitionCombination)(scoreType, sort)) {
             errors.push(`leaderboards[${index}] must use INTEGER + DESC or TIME_MS + ASC`);
             return;
         }
-        const status = (0, types_1.parsePlayerMetaDefinitionStatus)(entry.status ?? 'ACTIVE');
+        const status = (0, types_1.parsePlayerMetaDefinitionStatus)(entry.status ?? "ACTIVE");
         if (!status) {
-            errors.push(`leaderboards[${index}].status must be one of ${types_1.PLAYER_META_DEFINITION_STATUS_VALUES.join(', ')}`);
+            errors.push(`leaderboards[${index}].status must be one of ${types_1.PLAYER_META_DEFINITION_STATUS_VALUES.join(", ")}`);
             return;
         }
-        const unitLabel = typeof entry.unitLabel === 'string' && entry.unitLabel.trim().length > 0
+        const unitLabel = typeof entry.unitLabel === "string" && entry.unitLabel.trim().length > 0
             ? entry.unitLabel.trim()
             : undefined;
         definitions.push({
@@ -909,26 +924,26 @@ function validateAppMetadata(entry) {
     if (missingFields.length > 0) {
         warnings.push(formatMissingMetadata(missingFields));
     }
-    const emoji = validateOptionalEmoji(entry.emoji, Object.prototype.hasOwnProperty.call(entry, 'emoji'), errors);
-    const color = validateOptionalColor(entry.color, Object.prototype.hasOwnProperty.call(entry, 'color'), errors);
+    const emoji = validateOptionalEmoji(entry.emoji, Object.prototype.hasOwnProperty.call(entry, "emoji"), errors);
+    const color = validateOptionalColor(entry.color, Object.prototype.hasOwnProperty.call(entry, "color"), errors);
     let type;
-    if (typeof entry.type === 'string' && entry.type.trim()) {
+    if (typeof entry.type === "string" && entry.type.trim()) {
         const parsedType = (0, types_1.parseAppType)(entry.type.trim());
         if (!parsedType) {
-            errors.push(`type must be one of ${types_1.APP_TYPE_VALUES.join(', ')}`);
+            errors.push(`type must be one of ${types_1.APP_TYPE_VALUES.join(", ")}`);
         }
         else {
             type = parsedType;
         }
     }
     let displayName;
-    if (typeof entry.displayName === 'string' && entry.displayName.trim()) {
+    if (typeof entry.displayName === "string" && entry.displayName.trim()) {
         displayName = entry.displayName.trim();
     }
     let subtitle;
-    if (Object.prototype.hasOwnProperty.call(entry, 'subtitle')) {
-        if (typeof entry.subtitle !== 'string' || entry.subtitle.trim().length === 0) {
-            errors.push('subtitle must be a non-empty string when provided');
+    if (Object.prototype.hasOwnProperty.call(entry, "subtitle")) {
+        if (typeof entry.subtitle !== "string" || entry.subtitle.trim().length === 0) {
+            errors.push("subtitle must be a non-empty string when provided");
         }
         else if (entry.subtitle.trim().length > types_1.APP_SUBTITLE_MAX_LENGTH) {
             errors.push(`subtitle must be ${types_1.APP_SUBTITLE_MAX_LENGTH} characters or fewer`);
@@ -938,25 +953,25 @@ function validateAppMetadata(entry) {
         }
     }
     let description;
-    if (typeof entry.description === 'string') {
+    if (typeof entry.description === "string") {
         description = entry.description;
         const normalizedDescription = description.trim();
         const wordCount = normalizedDescription ? normalizedDescription.split(/\s+/).length : 0;
-        if (normalizedDescription
-            && (normalizedDescription.length < exports.APP_DESCRIPTION_RECOMMENDED_MIN_CHARACTERS
-                || wordCount < exports.APP_DESCRIPTION_RECOMMENDED_MIN_WORDS)) {
+        if (normalizedDescription &&
+            (normalizedDescription.length < exports.APP_DESCRIPTION_RECOMMENDED_MIN_CHARACTERS ||
+                wordCount < exports.APP_DESCRIPTION_RECOMMENDED_MIN_WORDS)) {
             warnings.push(`description is ${normalizedDescription.length} characters and ${wordCount} words. Aim for at least ${exports.APP_DESCRIPTION_RECOMMENDED_MIN_CHARACTERS} characters and ${exports.APP_DESCRIPTION_RECOMMENDED_MIN_WORDS} words describing what the player does, the objective, and the game's distinctive hook.`);
         }
     }
     let editorSupported;
-    if (Object.prototype.hasOwnProperty.call(entry, 'editorSupported')) {
-        if (typeof entry.editorSupported !== 'boolean') {
-            errors.push('editorSupported must be true or false');
+    if (Object.prototype.hasOwnProperty.call(entry, "editorSupported")) {
+        if (typeof entry.editorSupported !== "boolean") {
+            errors.push("editorSupported must be true or false");
         }
         else {
             editorSupported = entry.editorSupported;
-            if (editorSupported && entry.hostingMode === 'EXTERNAL') {
-                errors.push('editorSupported can only be true for HOSTED apps, not external apps');
+            if (editorSupported && entry.hostingMode === "EXTERNAL") {
+                errors.push("editorSupported can only be true for HOSTED apps, not external apps");
             }
         }
     }
@@ -968,20 +983,20 @@ function validateAppMetadata(entry) {
         surfaceTargetsMap = { ...parsed.map };
     }
     catch (error) {
-        errors.push(error?.message || 'invalid surfaceTargets');
+        errors.push(error?.message || "invalid surfaceTargets");
     }
     let primarySurface;
-    if (Object.prototype.hasOwnProperty.call(entry, 'primarySurface')) {
+    if (Object.prototype.hasOwnProperty.call(entry, "primarySurface")) {
         primarySurface = (0, types_1.parseAppSurface)(entry.primarySurface) ?? undefined;
         if (!primarySurface) {
-            errors.push('primarySurface must be DESKTOP, MOBILE_LANDSCAPE, or MOBILE_PORTRAIT');
+            errors.push("primarySurface must be DESKTOP, MOBILE_LANDSCAPE, or MOBILE_PORTRAIT");
         }
         else if (!surfaceTargetsList.includes(primarySurface)) {
             errors.push(`primarySurface ${primarySurface} must also be enabled in surfaceTargets`);
         }
     }
     let playtestTapes;
-    if (Object.prototype.hasOwnProperty.call(entry, 'playtestTapes')) {
+    if (Object.prototype.hasOwnProperty.call(entry, "playtestTapes")) {
         const normalized = (0, types_1.normalizeAppPlaytestTapes)(entry.playtestTapes, {
             surfaceTargets: surfaceTargetsList,
             requireComplete: true,
@@ -1011,32 +1026,32 @@ function validateAppMetadata(entry) {
     };
 }
 function formatAppPlaytestTapeError(error) {
-    const parts = error.split(':');
+    const parts = error.split(":");
     const code = parts[0] ?? error;
-    const surface = parts[1] ?? 'UNKNOWN';
-    if (code === 'playtest_tape_start_only_input_left_active') {
-        const count = parts[2] ?? 'unknown';
+    const surface = parts[1] ?? "UNKNOWN";
+    if (code === "playtest_tape_start_only_input_left_active") {
+        const count = parts[2] ?? "unknown";
         return `${error}: playtestTapes.${surface}.startOnlyEventCount=${count} ends while an input is held; include the matching keyUp or pointerUp inside the startup prefix.`;
     }
-    if (code === 'playtest_tape_primary_verb_events_required') {
-        const verb = parts[2] ?? 'unknown';
+    if (code === "playtest_tape_primary_verb_events_required") {
+        const verb = parts[2] ?? "unknown";
         return `${error}: playtestTapes.${surface} must demonstrate primaryVerb "${verb}" at least once after startup; secondary controls are allowed.`;
     }
-    if (code === 'playtest_tape_primary_verb_gesture_required') {
-        const verb = parts[2] ?? 'unknown';
+    if (code === "playtest_tape_primary_verb_gesture_required") {
+        const verb = parts[2] ?? "unknown";
         return `${error}: playtestTapes.${surface} primaryVerb "${verb}" requires one complete pointerDown, pointerMove, pointerUp gesture after startup.`;
     }
-    if (code === 'invalid_playtest_tape_key') {
-        const index = parts[2] ?? 'unknown';
+    if (code === "invalid_playtest_tape_key") {
+        const index = parts[2] ?? "unknown";
         return `${error}: playtestTapes.${surface}.events[${index}].key must be a browser key string with 1..64 characters; use a single space " " for the space bar.`;
     }
-    if (code === 'invalid_playtest_tape_event_type') {
-        const index = parts[2] ?? 'unknown';
-        const actual = parts[3] ?? 'missing';
+    if (code === "invalid_playtest_tape_event_type") {
+        const index = parts[2] ?? "unknown";
+        const actual = parts[3] ?? "missing";
         return `${error}: playtestTapes.${surface}.events[${index}].type="${actual}"; expected tap, pointerDown, pointerMove, pointerUp, keyDown, or keyUp.`;
     }
-    if (code === 'invalid_playtest_tape_success_signal_description') {
-        const index = parts[2] ?? 'unknown';
+    if (code === "invalid_playtest_tape_success_signal_description") {
+        const index = parts[2] ?? "unknown";
         return `${error}: playtestTapes.${surface}.successSignals[${index}].description must contain 1..240 characters.`;
     }
     return error;
@@ -1046,10 +1061,10 @@ function buildAppTasks(rootDir, catalogues, options) {
     const warnings = [];
     const errors = [];
     const seen = new Map();
-    const filterName = options.filterName ? options.filterName.trim() : '';
-    const filterFile = options.filterFile ? normalizePathForComparison(options.filterFile) : '';
+    const filterName = options.filterName ? options.filterName.trim() : "";
+    const filterFile = options.filterFile ? normalizePathForComparison(options.filterFile) : "";
     for (const file of catalogues) {
-        const label = file.relativePath || 'catalogue.json';
+        const label = file.relativePath || "catalogue.json";
         const rawApps = Array.isArray(file.data.apps) ? file.data.apps : [];
         if (rawApps.length === 0) {
             const legacyGames = Array.isArray(file.data.games);
@@ -1059,23 +1074,23 @@ function buildAppTasks(rootDir, catalogues, options) {
             continue;
         }
         for (const entry of rawApps) {
-            if (!entry || typeof entry !== 'object') {
+            if (!entry || typeof entry !== "object") {
                 errors.push(`[${label}] Invalid app entry; expected object.`);
                 continue;
             }
-            const rawName = typeof entry.name === 'string' ? entry.name.trim() : '';
+            const rawName = typeof entry.name === "string" ? entry.name.trim() : "";
             if (!rawName) {
                 errors.push(`[${label}] App entry is missing a name.`);
                 continue;
             }
             const ownedAssetNameMatch = filterName
-                ? Array.isArray(entry.ownedAssets)
-                    && entry.ownedAssets.some((ownedAsset) => ownedAsset
-                        && typeof ownedAsset === 'object'
-                        && typeof ownedAsset.name === 'string'
-                        && ownedAsset.name.trim() === filterName)
+                ? Array.isArray(entry.ownedAssets) &&
+                    entry.ownedAssets.some((ownedAsset) => ownedAsset &&
+                        typeof ownedAsset === "object" &&
+                        typeof ownedAsset.name === "string" &&
+                        ownedAsset.name.trim() === filterName)
                 : true;
-            const fileField = typeof entry.file === 'string' && entry.file.trim().length > 0
+            const fileField = typeof entry.file === "string" && entry.file.trim().length > 0
                 ? entry.file.trim()
                 : `${rawName}.html`;
             const absoluteFilePath = (0, node_path_1.resolve)(file.directory, fileField);
@@ -1091,13 +1106,13 @@ function buildAppTasks(rootDir, catalogues, options) {
             }
             seen.set(rawName, label);
             // Check for external mode early (before file validation)
-            const rawExternalUrlEarly = typeof entry.externalUrl === 'string' ? entry.externalUrl.trim() : '';
-            const rawHostingModeEarly = typeof entry.hostingMode === 'string' ? entry.hostingMode.trim().toUpperCase() : '';
-            const isExternalMode = rawHostingModeEarly === 'EXTERNAL' || (rawExternalUrlEarly && rawExternalUrlEarly.startsWith('https://'));
+            const rawExternalUrlEarly = typeof entry.externalUrl === "string" ? entry.externalUrl.trim() : "";
+            const rawHostingModeEarly = typeof entry.hostingMode === "string" ? entry.hostingMode.trim().toUpperCase() : "";
+            const isExternalMode = rawHostingModeEarly === "EXTERNAL" || (rawExternalUrlEarly && rawExternalUrlEarly.startsWith("https://"));
             // Only validate file path for non-external apps
             if (!isExternalMode) {
                 const relativeToProject = (0, node_path_1.relative)(file.directory, absoluteFilePath);
-                if (relativeToProject.startsWith('..')) {
+                if (relativeToProject.startsWith("..")) {
                     errors.push(`[${label}] Skipping ${rawName}: file path escapes project directory (${fileField}).`);
                     continue;
                 }
@@ -1111,15 +1126,15 @@ function buildAppTasks(rootDir, catalogues, options) {
                 try {
                     packageManifest = readPackageJsonManifest(packageJsonPath);
                     const scripts = packageManifest?.scripts;
-                    if (scripts && typeof scripts.validate === 'string' && scripts.validate.trim().length > 0) {
+                    if (scripts && typeof scripts.validate === "string" && scripts.validate.trim().length > 0) {
                         hasValidateScript = true;
                     }
-                    if (scripts && typeof scripts.format === 'string' && scripts.format.trim().length > 0) {
+                    if (scripts && typeof scripts.format === "string" && scripts.format.trim().length > 0) {
                         hasFormatScript = true;
                     }
                 }
                 catch (error) {
-                    errors.push(`[${label}] Skipping ${rawName}: failed to read package.json (${error?.message || 'unknown error'}).`);
+                    errors.push(`[${label}] Skipping ${rawName}: failed to read package.json (${error?.message || "unknown error"}).`);
                     continue;
                 }
             }
@@ -1142,11 +1157,11 @@ function buildAppTasks(rootDir, catalogues, options) {
             }
             const metadata = validateAppMetadata(entry);
             if (metadata.errors.length > 0) {
-                errors.push(`[${label}] Skipping ${rawName}: ${metadata.errors.join('; ')}`);
+                errors.push(`[${label}] Skipping ${rawName}: ${metadata.errors.join("; ")}`);
                 continue;
             }
             if (metadata.warnings.length > 0) {
-                warnings.push(`${label} (${metadata.warnings.join('; ')})`);
+                warnings.push(`${label} (${metadata.warnings.join("; ")})`);
             }
             const errorCountBeforePlayerMeta = errors.length;
             const achievements = validateAchievementDefinitions(entry.achievements, file.directory, errors);
@@ -1162,7 +1177,7 @@ function buildAppTasks(rootDir, catalogues, options) {
                 warnings.push(`${label} (${rawName}: package.json missing "format" script)`);
             }
             // Parse versioning fields.
-            const rawVersion = typeof entry.version === 'string' ? entry.version.trim() : '';
+            const rawVersion = typeof entry.version === "string" ? entry.version.trim() : "";
             if (!rawVersion) {
                 errors.push(`[${label}] Skipping ${rawName}: app version is required (e.g., "1.0.0").`);
                 continue;
@@ -1172,93 +1187,106 @@ function buildAppTasks(rootDir, catalogues, options) {
                 continue;
             }
             const version = rawVersion;
-            const releaseNotes = typeof entry.releaseNotes === 'string' ? entry.releaseNotes : undefined;
+            let releaseNotes;
+            if (Object.prototype.hasOwnProperty.call(entry, "releaseNotes")) {
+                if (typeof entry.releaseNotes !== "string") {
+                    errors.push(`[${label}] Skipping ${rawName}: releaseNotes must be a string containing one line with 1..240 characters.`);
+                    continue;
+                }
+                try {
+                    releaseNotes = normalizeAppReleaseNotes(entry.releaseNotes);
+                }
+                catch (error) {
+                    errors.push(`[${label}] Skipping ${rawName}: ${error instanceof Error ? error.message : String(error)}`);
+                    continue;
+                }
+            }
             let versionVisibility;
-            const rawVisibility = typeof entry.visibility === 'string' ? entry.visibility.trim().toUpperCase() : '';
+            const rawVisibility = typeof entry.visibility === "string" ? entry.visibility.trim().toUpperCase() : "";
             if (rawVisibility) {
                 if (!types_1.APP_VERSION_VISIBILITY_VALUES.includes(rawVisibility)) {
-                    errors.push(`[${label}] Skipping ${rawName}: visibility must be one of ${types_1.APP_VERSION_VISIBILITY_VALUES.join(', ')}.`);
+                    errors.push(`[${label}] Skipping ${rawName}: visibility must be one of ${types_1.APP_VERSION_VISIBILITY_VALUES.join(", ")}.`);
                     continue;
                 }
                 versionVisibility = rawVisibility;
             }
             let hostingMode;
-            const rawHostingMode = typeof entry.hostingMode === 'string' ? entry.hostingMode.trim().toUpperCase() : '';
+            const rawHostingMode = typeof entry.hostingMode === "string" ? entry.hostingMode.trim().toUpperCase() : "";
             if (rawHostingMode) {
                 if (!types_1.APP_HOSTING_MODE_VALUES.includes(rawHostingMode)) {
-                    errors.push(`[${label}] Skipping ${rawName}: hostingMode must be one of ${types_1.APP_HOSTING_MODE_VALUES.join(', ')}.`);
+                    errors.push(`[${label}] Skipping ${rawName}: hostingMode must be one of ${types_1.APP_HOSTING_MODE_VALUES.join(", ")}.`);
                     continue;
                 }
                 hostingMode = rawHostingMode;
             }
             let authMode;
-            const rawAuthMode = typeof entry.authMode === 'string' ? entry.authMode.trim().toUpperCase() : '';
+            const rawAuthMode = typeof entry.authMode === "string" ? entry.authMode.trim().toUpperCase() : "";
             if (rawAuthMode) {
                 if (!types_1.APP_AUTH_MODE_VALUES.includes(rawAuthMode)) {
-                    errors.push(`[${label}] Skipping ${rawName}: authMode must be one of ${types_1.APP_AUTH_MODE_VALUES.join(', ')}.`);
+                    errors.push(`[${label}] Skipping ${rawName}: authMode must be one of ${types_1.APP_AUTH_MODE_VALUES.join(", ")}.`);
                     continue;
                 }
                 authMode = rawAuthMode;
             }
             let controllerMode;
-            const rawControllerMode = typeof entry.controllerMode === 'string' ? entry.controllerMode.trim().toUpperCase() : '';
+            const rawControllerMode = typeof entry.controllerMode === "string" ? entry.controllerMode.trim().toUpperCase() : "";
             if (rawControllerMode) {
                 if (!types_1.APP_CONTROLLER_MODE_VALUES.includes(rawControllerMode)) {
-                    errors.push(`[${label}] Skipping ${rawName}: controllerMode must be one of ${types_1.APP_CONTROLLER_MODE_VALUES.join(', ')}.`);
+                    errors.push(`[${label}] Skipping ${rawName}: controllerMode must be one of ${types_1.APP_CONTROLLER_MODE_VALUES.join(", ")}.`);
                     continue;
                 }
                 controllerMode = rawControllerMode;
             }
             let previewable;
-            if (Object.prototype.hasOwnProperty.call(entry, 'previewable')) {
-                if (typeof entry.previewable !== 'boolean') {
+            if (Object.prototype.hasOwnProperty.call(entry, "previewable")) {
+                if (typeof entry.previewable !== "boolean") {
                     errors.push(`[${label}] Skipping ${rawName}: previewable must be true or false.`);
                     continue;
                 }
                 previewable = Boolean(entry.previewable);
             }
             let editorSupported;
-            if (Object.prototype.hasOwnProperty.call(entry, 'editorSupported')) {
-                if (typeof entry.editorSupported !== 'boolean') {
+            if (Object.prototype.hasOwnProperty.call(entry, "editorSupported")) {
+                if (typeof entry.editorSupported !== "boolean") {
                     errors.push(`[${label}] Skipping ${rawName}: editorSupported must be true or false.`);
                     continue;
                 }
                 editorSupported = Boolean(entry.editorSupported);
             }
             let externalUrl;
-            const rawExternalUrl = typeof entry.externalUrl === 'string' ? entry.externalUrl.trim() : '';
+            const rawExternalUrl = typeof entry.externalUrl === "string" ? entry.externalUrl.trim() : "";
             if (rawExternalUrl) {
-                if (!rawExternalUrl.startsWith('https://')) {
+                if (!rawExternalUrl.startsWith("https://")) {
                     errors.push(`[${label}] Skipping ${rawName}: externalUrl must be an HTTPS URL.`);
                     continue;
                 }
                 externalUrl = rawExternalUrl;
             }
             // Validate hostingMode / externalUrl consistency
-            if (hostingMode === 'EXTERNAL' && !externalUrl) {
+            if (hostingMode === "EXTERNAL" && !externalUrl) {
                 errors.push(`[${label}] Skipping ${rawName}: externalUrl is required when hostingMode is EXTERNAL.`);
                 continue;
             }
-            if (externalUrl && hostingMode !== 'EXTERNAL') {
+            if (externalUrl && hostingMode !== "EXTERNAL") {
                 // Auto-set hostingMode to EXTERNAL if externalUrl is provided
-                hostingMode = 'EXTERNAL';
+                hostingMode = "EXTERNAL";
             }
-            if ((hostingMode ?? 'HOSTED') === 'EXTERNAL' && previewable) {
+            if ((hostingMode ?? "HOSTED") === "EXTERNAL" && previewable) {
                 errors.push(`[${label}] Skipping ${rawName}: previewable can only be true for HOSTED apps.`);
                 continue;
             }
-            if ((hostingMode ?? 'HOSTED') === 'EXTERNAL' && editorSupported) {
+            if ((hostingMode ?? "HOSTED") === "EXTERNAL" && editorSupported) {
                 errors.push(`[${label}] Skipping ${rawName}: editorSupported can only be true for HOSTED apps.`);
                 continue;
             }
-            const defaultLicense = (hostingMode ?? 'HOSTED') === 'EXTERNAL' ? 'CLOSED' : types_1.DEFAULT_CONTENT_LICENSE;
+            const defaultLicense = (hostingMode ?? "HOSTED") === "EXTERNAL" ? "CLOSED" : types_1.DEFAULT_CONTENT_LICENSE;
             const license = normalizeContentLicenseValue(entry.license, errors, `${label} app "${rawName}"`, APP_ALLOWED_LICENSES, defaultLicense);
             if (!license) {
                 continue;
             }
             // Parse username field (admin-only)
             let username;
-            const rawUsername = typeof entry.username === 'string' ? entry.username.trim() : '';
+            const rawUsername = typeof entry.username === "string" ? entry.username.trim() : "";
             if (rawUsername) {
                 username = rawUsername;
             }
@@ -1266,7 +1294,7 @@ function buildAppTasks(rootDir, catalogues, options) {
             let listing;
             const rawListing = entry.listing;
             let listingValidationFailed = false;
-            if (rawListing && typeof rawListing === 'object') {
+            if (options.listingAssets !== "ignore" && rawListing && typeof rawListing === "object") {
                 const resolvedListing = {
                     screenshotPortraitPaths: [],
                     screenshotLandscapePaths: [],
@@ -1275,15 +1303,15 @@ function buildAppTasks(rootDir, catalogues, options) {
                     mediaMetadata: [],
                 };
                 // Icon
-                if (typeof rawListing.icon === 'string' && rawListing.icon.trim()) {
+                if (typeof rawListing.icon === "string" && rawListing.icon.trim()) {
                     const iconPath = rawListing.icon.trim();
-                    const extensionError = validateListingAssetExtension(iconPath, 'listing.icon', 'image');
+                    const extensionError = validateListingAssetExtension(iconPath, "listing.icon", "image");
                     if (extensionError) {
                         errors.push(`[${label}] Skipping ${rawName}: ${extensionError}`);
                         listingValidationFailed = true;
                     }
                     else {
-                        const validationError = validateListingAssetPath(file.directory, iconPath, 'listing.icon');
+                        const validationError = validateListingAssetPath(file.directory, iconPath, "listing.icon");
                         if (validationError) {
                             errors.push(`[${label}] Skipping ${rawName}: ${validationError}`);
                             listingValidationFailed = true;
@@ -1294,20 +1322,20 @@ function buildAppTasks(rootDir, catalogues, options) {
                     }
                 }
                 // Hero images
-                const rawHeroPortrait = typeof rawListing.heroPortrait === 'string' && rawListing.heroPortrait.trim()
+                const rawHeroPortrait = typeof rawListing.heroPortrait === "string" && rawListing.heroPortrait.trim()
                     ? rawListing.heroPortrait.trim()
-                    : typeof rawListing.heroPortraitPath === 'string' && rawListing.heroPortraitPath.trim()
+                    : typeof rawListing.heroPortraitPath === "string" && rawListing.heroPortraitPath.trim()
                         ? rawListing.heroPortraitPath.trim()
-                        : '';
+                        : "";
                 if (!listingValidationFailed && rawHeroPortrait) {
                     const heroPortraitPath = rawHeroPortrait;
-                    const extensionError = validateListingAssetExtension(heroPortraitPath, 'listing.heroPortrait', 'image');
+                    const extensionError = validateListingAssetExtension(heroPortraitPath, "listing.heroPortrait", "image");
                     if (extensionError) {
                         errors.push(`[${label}] Skipping ${rawName}: ${extensionError}`);
                         listingValidationFailed = true;
                     }
                     else {
-                        const validationError = validateListingAssetPath(file.directory, heroPortraitPath, 'listing.heroPortrait');
+                        const validationError = validateListingAssetPath(file.directory, heroPortraitPath, "listing.heroPortrait");
                         if (validationError) {
                             errors.push(`[${label}] Skipping ${rawName}: ${validationError}`);
                             listingValidationFailed = true;
@@ -1317,20 +1345,20 @@ function buildAppTasks(rootDir, catalogues, options) {
                         }
                     }
                 }
-                const rawHeroLandscape = typeof rawListing.heroLandscape === 'string' && rawListing.heroLandscape.trim()
+                const rawHeroLandscape = typeof rawListing.heroLandscape === "string" && rawListing.heroLandscape.trim()
                     ? rawListing.heroLandscape.trim()
-                    : typeof rawListing.heroLandscapePath === 'string' && rawListing.heroLandscapePath.trim()
+                    : typeof rawListing.heroLandscapePath === "string" && rawListing.heroLandscapePath.trim()
                         ? rawListing.heroLandscapePath.trim()
-                        : '';
+                        : "";
                 if (!listingValidationFailed && rawHeroLandscape) {
                     const heroLandscapePath = rawHeroLandscape;
-                    const extensionError = validateListingAssetExtension(heroLandscapePath, 'listing.heroLandscape', 'image');
+                    const extensionError = validateListingAssetExtension(heroLandscapePath, "listing.heroLandscape", "image");
                     if (extensionError) {
                         errors.push(`[${label}] Skipping ${rawName}: ${extensionError}`);
                         listingValidationFailed = true;
                     }
                     else {
-                        const validationError = validateListingAssetPath(file.directory, heroLandscapePath, 'listing.heroLandscape');
+                        const validationError = validateListingAssetPath(file.directory, heroLandscapePath, "listing.heroLandscape");
                         if (validationError) {
                             errors.push(`[${label}] Skipping ${rawName}: ${validationError}`);
                             listingValidationFailed = true;
@@ -1341,10 +1369,34 @@ function buildAppTasks(rootDir, catalogues, options) {
                     }
                 }
                 for (const mediaField of [
-                    { value: rawListing.screenshotsPortrait, fieldName: 'listing.screenshotsPortrait', kind: 'image', fileKeyPrefix: 'screenshotsPortrait', target: resolvedListing.screenshotPortraitPaths },
-                    { value: rawListing.screenshotsLandscape, fieldName: 'listing.screenshotsLandscape', kind: 'image', fileKeyPrefix: 'screenshotsLandscape', target: resolvedListing.screenshotLandscapePaths },
-                    { value: rawListing.videosPortrait, fieldName: 'listing.videosPortrait', kind: 'video', fileKeyPrefix: 'videosPortrait', target: resolvedListing.videoPortraitPaths },
-                    { value: rawListing.videosLandscape, fieldName: 'listing.videosLandscape', kind: 'video', fileKeyPrefix: 'videosLandscape', target: resolvedListing.videoLandscapePaths },
+                    {
+                        value: rawListing.screenshotsPortrait,
+                        fieldName: "listing.screenshotsPortrait",
+                        kind: "image",
+                        fileKeyPrefix: "screenshotsPortrait",
+                        target: resolvedListing.screenshotPortraitPaths,
+                    },
+                    {
+                        value: rawListing.screenshotsLandscape,
+                        fieldName: "listing.screenshotsLandscape",
+                        kind: "image",
+                        fileKeyPrefix: "screenshotsLandscape",
+                        target: resolvedListing.screenshotLandscapePaths,
+                    },
+                    {
+                        value: rawListing.videosPortrait,
+                        fieldName: "listing.videosPortrait",
+                        kind: "video",
+                        fileKeyPrefix: "videosPortrait",
+                        target: resolvedListing.videoPortraitPaths,
+                    },
+                    {
+                        value: rawListing.videosLandscape,
+                        fieldName: "listing.videosLandscape",
+                        kind: "video",
+                        fileKeyPrefix: "videosLandscape",
+                        target: resolvedListing.videoLandscapePaths,
+                    },
                 ]) {
                     if (listingValidationFailed)
                         break;
@@ -1363,14 +1415,16 @@ function buildAppTasks(rootDir, catalogues, options) {
                     mediaField.target.push(...resolvedMedia.paths);
                     resolvedListing.mediaMetadata.push(...resolvedMedia.metadata);
                 }
-                if (!listingValidationFailed && typeof rawListing.captureReport === 'string' && rawListing.captureReport.trim()) {
+                if (!listingValidationFailed &&
+                    typeof rawListing.captureReport === "string" &&
+                    rawListing.captureReport.trim()) {
                     const captureReportPath = rawListing.captureReport.trim();
-                    if ((0, node_path_1.extname)(captureReportPath).toLowerCase() !== '.json') {
+                    if ((0, node_path_1.extname)(captureReportPath).toLowerCase() !== ".json") {
                         errors.push(`[${label}] Skipping ${rawName}: listing.captureReport must point to a JSON file.`);
                         listingValidationFailed = true;
                     }
                     else {
-                        const validationError = validateListingAssetPath(file.directory, captureReportPath, 'listing.captureReport');
+                        const validationError = validateListingAssetPath(file.directory, captureReportPath, "listing.captureReport");
                         if (validationError) {
                             errors.push(`[${label}] Skipping ${rawName}: ${validationError}`);
                             listingValidationFailed = true;
@@ -1392,7 +1446,7 @@ function buildAppTasks(rootDir, catalogues, options) {
                 continue;
             }
             let design;
-            if (Object.prototype.hasOwnProperty.call(entry, 'design')) {
+            if (Object.prototype.hasOwnProperty.call(entry, "design")) {
                 const parsedDesign = (0, types_1.normalizeAppVersionDesign)(entry.design);
                 if (!parsedDesign.ok) {
                     errors.push(`[${label}] App "${rawName}" ${parsedDesign.error}`);
@@ -1401,7 +1455,7 @@ function buildAppTasks(rootDir, catalogues, options) {
                 design = parsedDesign.value;
             }
             let tweaks;
-            if (Object.prototype.hasOwnProperty.call(entry, 'tweaks')) {
+            if (Object.prototype.hasOwnProperty.call(entry, "tweaks")) {
                 const parsedTweaks = (0, types_1.normalizeAppTweaks)(entry.tweaks);
                 if (!parsedTweaks.ok) {
                     errors.push(`[${label}] App "${rawName}" ${parsedTweaks.error}`);
@@ -1410,13 +1464,13 @@ function buildAppTasks(rootDir, catalogues, options) {
                 tweaks = parsedTweaks.value;
             }
             const errorCountBeforeTagMetadata = errors.length;
-            const remix = normalizeCatalogueRemixRef(entry.remix, 'app', errors, `[${label}] App "${rawName}"`);
+            const remix = normalizeCatalogueRemixRef(entry.remix, "app", errors, `[${label}] App "${rawName}"`);
             const tags = normalizeCatalogueTags(entry.tags, errors, `[${label}] App "${rawName}"`);
             const graphRelations = normalizeCatalogueRelations(entry.relations, errors, `[${label}] App "${rawName}"`) ?? [];
             if (errors.length > errorCountBeforeTagMetadata) {
                 continue;
             }
-            if (Object.prototype.hasOwnProperty.call(entry, 'embeddedAssets')) {
+            if (Object.prototype.hasOwnProperty.call(entry, "embeddedAssets")) {
                 errors.push(`[${label}] App "${rawName}" uses legacy embeddedAssets. Rename it to ownedAssets.`);
                 continue;
             }
@@ -1426,12 +1480,12 @@ function buildAppTasks(rootDir, catalogues, options) {
                 : [];
             for (let ownedIndex = 0; ownedIndex < rawOwnedAssets.length; ownedIndex++) {
                 const owned = rawOwnedAssets[ownedIndex];
-                const ownedName = typeof owned?.name === 'string' ? owned.name.trim() : '';
+                const ownedName = typeof owned?.name === "string" ? owned.name.trim() : "";
                 if (!ownedName) {
                     errors.push(`[${label}] Skipping ${rawName}: ownedAssets[${ownedIndex}] is missing a name.`);
                     continue;
                 }
-                const runtimeKey = typeof owned?.runtimeKey === 'string' && owned.runtimeKey.trim().length > 0
+                const runtimeKey = typeof owned?.runtimeKey === "string" && owned.runtimeKey.trim().length > 0
                     ? owned.runtimeKey.trim()
                     : undefined;
                 const category = normalizeAssetCategoryValue(owned?.category, errors, `[${label}] Skipping ${rawName}: owned asset "${ownedName}"`);
@@ -1439,20 +1493,22 @@ function buildAppTasks(rootDir, catalogues, options) {
                     continue;
                 }
                 const subcategory = normalizeAssetSubcategoryValue(owned?.subcategory, category, errors, `[${label}] Skipping ${rawName}: owned asset "${ownedName}"`);
-                if (subcategory === null && category !== 'CUSTOM') {
+                if (subcategory === null && category !== "CUSTOM") {
                     continue;
                 }
-                const fileEntries = owned?.files && typeof owned.files === 'object' && !Array.isArray(owned.files)
+                const fileEntries = owned?.files && typeof owned.files === "object" && !Array.isArray(owned.files)
                     ? owned.files
                     : null;
                 const assetSpec = (0, assetSpecs_1.normalizeAssetSpecVersionRef)(owned?.assetSpec, errors, `[${label}] App "${rawName}" owned asset "${ownedName}"`);
-                const ownedFormat = typeof owned?.format === 'string' && owned.format.trim().length > 0
+                const ownedFormat = typeof owned?.format === "string" && owned.format.trim().length > 0
                     ? owned.format.trim().toUpperCase()
                     : undefined;
                 const generatedModel3DFormat = subcategory
                     ? inferGeneratedModel3DFormat(category, subcategory, ownedFormat, fileEntries)
                     : null;
-                const generatedModel3DRoles = generatedModel3DFormat ? getGeneratedModel3DFileRoles(generatedModel3DFormat) : null;
+                const generatedModel3DRoles = generatedModel3DFormat
+                    ? getGeneratedModel3DFileRoles(generatedModel3DFormat)
+                    : null;
                 if (!fileEntries || Object.keys(fileEntries).length === 0) {
                     errors.push(`[${label}] Skipping ${rawName}: owned asset "${ownedName}" must define files.`);
                     continue;
@@ -1461,7 +1517,7 @@ function buildAppTasks(rootDir, catalogues, options) {
                 const filePaths = {};
                 let ownedAssetHasError = false;
                 for (const [role, fileValue] of Object.entries(fileEntries)) {
-                    if (typeof fileValue !== 'string' || !fileValue.trim()) {
+                    if (typeof fileValue !== "string" || !fileValue.trim()) {
                         errors.push(`[${label}] Skipping ${rawName}: owned asset "${ownedName}" file role "${role}" must be a non-empty string path.`);
                         ownedAssetHasError = true;
                         continue;
@@ -1472,7 +1528,7 @@ function buildAppTasks(rootDir, catalogues, options) {
                     const allowMissingGenerated = Boolean(generatedModel3DRoles?.generated.has(normalizedRole));
                     if (!(0, node_fs_1.existsSync)(absoluteEmbeddedPath) || !(0, node_fs_1.statSync)(absoluteEmbeddedPath).isFile()) {
                         if (allowMissingGenerated) {
-                            files[role] = relativeEmbeddedPath.replace(/\\/g, '/');
+                            files[role] = relativeEmbeddedPath.replace(/\\/g, "/");
                             filePaths[role] = absoluteEmbeddedPath;
                             continue;
                         }
@@ -1480,7 +1536,7 @@ function buildAppTasks(rootDir, catalogues, options) {
                         ownedAssetHasError = true;
                         continue;
                     }
-                    files[role] = relativeEmbeddedPath.replace(/\\/g, '/');
+                    files[role] = relativeEmbeddedPath.replace(/\\/g, "/");
                     filePaths[role] = absoluteEmbeddedPath;
                 }
                 if (ownedAssetHasError) {
@@ -1490,26 +1546,26 @@ function buildAppTasks(rootDir, catalogues, options) {
                     const normalizedRoles = new Set(Object.keys(files).map((role) => normalizeFileRole(role)));
                     const missingRoles = generatedModel3DRoles.required.filter((role) => !normalizedRoles.has(role));
                     if (missingRoles.length > 0) {
-                        errors.push(`[${label}] Skipping ${rawName}: owned asset "${ownedName}" with subcategory=${subcategory} must define files.${missingRoles.join(' and files.')}.`);
+                        errors.push(`[${label}] Skipping ${rawName}: owned asset "${ownedName}" with subcategory=${subcategory} must define files.${missingRoles.join(" and files.")}.`);
                         continue;
                     }
                 }
-                if (category === 'SPRITESHEET') {
-                    const hasAtlas = Object.prototype.hasOwnProperty.call(files, 'atlas');
-                    const hasManifest = Object.prototype.hasOwnProperty.call(files, 'manifest');
+                if (category === "SPRITESHEET") {
+                    const hasAtlas = Object.prototype.hasOwnProperty.call(files, "atlas");
+                    const hasManifest = Object.prototype.hasOwnProperty.call(files, "manifest");
                     if (!hasAtlas || !hasManifest) {
                         errors.push(`[${label}] Skipping ${rawName}: owned asset "${ownedName}" with category=SPRITESHEET must define files.atlas and files.manifest.`);
                         continue;
                     }
                 }
-                if (category === 'AUDIO') {
-                    const hasPrimary = Object.prototype.hasOwnProperty.call(files, 'primary');
+                if (category === "AUDIO") {
+                    const hasPrimary = Object.prototype.hasOwnProperty.call(files, "primary");
                     if (!hasPrimary) {
                         errors.push(`[${label}] Skipping ${rawName}: owned asset "${ownedName}" with category=AUDIO must define files.primary.`);
                         continue;
                     }
                 }
-                if (category === 'MODEL_3D' && ownedFormat === 'GLB') {
+                if (category === "MODEL_3D" && ownedFormat === "GLB") {
                     const primaryPath = filePaths.primary;
                     if (!primaryPath) {
                         errors.push(`[${label}] Skipping ${rawName}: owned asset "${ownedName}" with format=GLB must define files.primary.`);
@@ -1519,8 +1575,8 @@ function buildAppTasks(rootDir, catalogues, options) {
                         validateSelfContainedGlb(primaryPath);
                     }
                     catch (error) {
-                        const message = typeof error?.message === 'string' ? error.message : 'invalid_glb_payload';
-                        if (message === 'glb_external_dependency_unsupported') {
+                        const message = typeof error?.message === "string" ? error.message : "invalid_glb_payload";
+                        if (message === "glb_external_dependency_unsupported") {
                             errors.push(`[${label}] Skipping ${rawName}: owned asset "${ownedName}" GLB must embed all buffers and textures instead of referencing external files.`);
                         }
                         else {
@@ -1541,12 +1597,14 @@ function buildAppTasks(rootDir, catalogues, options) {
                     continue;
                 }
                 ownedAssets.push({
-                    kind: 'owned-asset',
+                    kind: "owned-asset",
                     appName: rawName,
                     name: ownedName,
                     runtimeKey,
-                    displayName: typeof owned?.displayName === 'string' && owned.displayName.trim().length > 0 ? owned.displayName.trim() : undefined,
-                    description: typeof owned?.description === 'string' ? owned.description : undefined,
+                    displayName: typeof owned?.displayName === "string" && owned.displayName.trim().length > 0
+                        ? owned.displayName.trim()
+                        : undefined,
+                    description: typeof owned?.description === "string" ? owned.description : undefined,
                     cataloguePath: label,
                     category,
                     subcategory,
@@ -1555,7 +1613,7 @@ function buildAppTasks(rootDir, catalogues, options) {
                     visibility: normalizeAssetVisibilityValue(owned?.visibility, errors, `${label} owned asset "${ownedName}"`),
                     license: ownedLicense,
                     tags: ownedTags,
-                    shopListed: typeof owned?.shopListed === 'boolean' ? owned.shopListed : undefined,
+                    shopListed: typeof owned?.shopListed === "boolean" ? owned.shopListed : undefined,
                     shopPriceCredits: Number.isInteger(owned?.shopPriceCredits) ? Number(owned.shopPriceCredits) : undefined,
                     files,
                     filePaths,
@@ -1591,13 +1649,13 @@ function buildAppTasks(rootDir, catalogues, options) {
                 continue;
             }
             tasks.push({
-                kind: 'app',
+                kind: "app",
                 name: rawName,
                 cataloguePath: label,
                 catalogueAbsolutePath: file.absolutePath,
                 catalogueDir: file.directory,
                 filePath: absoluteFilePath,
-                relativeFile: fileField.replace(/\\/g, '/'),
+                relativeFile: fileField.replace(/\\/g, "/"),
                 projectDir: file.directory,
                 packageJsonPath,
                 isTypescriptProject,
@@ -1653,15 +1711,17 @@ function buildAssetSpecTasks(catalogues) {
     const errors = [];
     const seen = new Map();
     for (const file of catalogues) {
-        const label = file.relativePath || 'catalogue.json';
-        const rawAssetSpecs = Array.isArray(file.data.assetSpecs) ? file.data.assetSpecs : [];
+        const label = file.relativePath || "catalogue.json";
+        const rawAssetSpecs = Array.isArray(file.data.assetSpecs)
+            ? file.data.assetSpecs
+            : [];
         for (let index = 0; index < rawAssetSpecs.length; index += 1) {
             const entry = rawAssetSpecs[index];
-            if (!entry || typeof entry !== 'object') {
+            if (!entry || typeof entry !== "object") {
                 errors.push(`[${label}] Invalid assetSpecs[${index}] entry; expected object.`);
                 continue;
             }
-            const name = typeof entry.name === 'string' ? entry.name.trim() : '';
+            const name = typeof entry.name === "string" ? entry.name.trim() : "";
             if (!name) {
                 errors.push(`[${label}] assetSpecs[${index}] is missing a name.`);
                 continue;
@@ -1669,7 +1729,7 @@ function buildAssetSpecTasks(catalogues) {
             if (!(0, assetSpecs_1.validateAssetSpecName)(name, errors, `[${label}] Asset spec "${name}"`)) {
                 continue;
             }
-            const version = typeof entry.version === 'string' ? entry.version.trim() : '';
+            const version = typeof entry.version === "string" ? entry.version.trim() : "";
             if (!SEMVER_REGEX.test(version)) {
                 errors.push(`[${label}] Asset spec "${name}" must define a semver version.`);
                 continue;
@@ -1680,12 +1740,12 @@ function buildAssetSpecTasks(catalogues) {
                 continue;
             }
             seen.set(dedupeKey, label);
-            const displayName = typeof entry.displayName === 'string' ? entry.displayName.trim() : '';
+            const displayName = typeof entry.displayName === "string" ? entry.displayName.trim() : "";
             if (!displayName) {
                 errors.push(`[${label}] Asset spec "${name}@${version}" must define displayName.`);
                 continue;
             }
-            const symbol = typeof entry.symbol === 'string' ? entry.symbol.trim() : '';
+            const symbol = typeof entry.symbol === "string" ? entry.symbol.trim() : "";
             if (!symbol) {
                 errors.push(`[${label}] Asset spec "${name}@${version}" must define symbol.`);
                 continue;
@@ -1695,7 +1755,7 @@ function buildAssetSpecTasks(catalogues) {
                 errors.push(`[${label}] Asset spec "${name}@${version}" symbol file not found at ${symbolPath}.`);
                 continue;
             }
-            const contractField = typeof entry.contract === 'string' ? entry.contract.trim() : '';
+            const contractField = typeof entry.contract === "string" ? entry.contract.trim() : "";
             if (!contractField) {
                 errors.push(`[${label}] Asset spec "${name}@${version}" must define contract.`);
                 continue;
@@ -1705,10 +1765,10 @@ function buildAssetSpecTasks(catalogues) {
                 continue;
             }
             let validationKind = loadedContract.validationKind;
-            if (typeof entry.validationKind === 'string' && entry.validationKind.trim().length > 0) {
+            if (typeof entry.validationKind === "string" && entry.validationKind.trim().length > 0) {
                 const normalizedValidationKind = entry.validationKind.trim().toUpperCase();
                 if (!types_1.ASSET_SPEC_VALIDATION_KIND_VALUES.includes(normalizedValidationKind)) {
-                    errors.push(`[${label}] Asset spec "${name}@${version}" validationKind must be one of ${types_1.ASSET_SPEC_VALIDATION_KIND_VALUES.join(', ')}.`);
+                    errors.push(`[${label}] Asset spec "${name}@${version}" validationKind must be one of ${types_1.ASSET_SPEC_VALIDATION_KIND_VALUES.join(", ")}.`);
                     continue;
                 }
                 if (normalizedValidationKind !== loadedContract.validationKind) {
@@ -1717,24 +1777,24 @@ function buildAssetSpecTasks(catalogues) {
                 }
                 validationKind = normalizedValidationKind;
             }
-            let status = 'ACTIVE';
-            if (typeof entry.status === 'string' && entry.status.trim().length > 0) {
+            let status = "ACTIVE";
+            if (typeof entry.status === "string" && entry.status.trim().length > 0) {
                 const normalizedStatus = entry.status.trim().toUpperCase();
                 if (!types_1.ASSET_SPEC_STATUS_VALUES.includes(normalizedStatus)) {
-                    errors.push(`[${label}] Asset spec "${name}@${version}" status must be one of ${types_1.ASSET_SPEC_STATUS_VALUES.join(', ')}.`);
+                    errors.push(`[${label}] Asset spec "${name}@${version}" status must be one of ${types_1.ASSET_SPEC_STATUS_VALUES.join(", ")}.`);
                     continue;
                 }
                 status = normalizedStatus;
             }
             const visibility = normalizeAssetVisibilityValue(entry.visibility, errors, `${label} asset spec "${name}@${version}"`);
-            const successorVersion = typeof entry.successorVersion === 'string' && entry.successorVersion.trim().length > 0
+            const successorVersion = typeof entry.successorVersion === "string" && entry.successorVersion.trim().length > 0
                 ? entry.successorVersion.trim()
                 : undefined;
             if (successorVersion && !SEMVER_REGEX.test(successorVersion)) {
                 errors.push(`[${label}] Asset spec "${name}@${version}" successorVersion must be a semver string.`);
                 continue;
             }
-            const documentationField = typeof entry.documentation === 'string' && entry.documentation.trim().length > 0
+            const documentationField = typeof entry.documentation === "string" && entry.documentation.trim().length > 0
                 ? entry.documentation.trim()
                 : undefined;
             const documentationPath = documentationField ? (0, node_path_1.resolve)(file.directory, documentationField) : undefined;
@@ -1743,19 +1803,19 @@ function buildAssetSpecTasks(catalogues) {
                 continue;
             }
             tasks.push({
-                kind: 'asset-spec',
+                kind: "asset-spec",
                 name,
                 version,
                 displayName,
-                description: typeof entry.description === 'string' ? entry.description.trim() || undefined : undefined,
+                description: typeof entry.description === "string" ? entry.description.trim() || undefined : undefined,
                 cataloguePath: label,
                 catalogueAbsolutePath: file.absolutePath,
                 catalogueDir: file.directory,
-                username: typeof entry.username === 'string' && entry.username.trim().length > 0 ? entry.username.trim() : undefined,
+                username: typeof entry.username === "string" && entry.username.trim().length > 0 ? entry.username.trim() : undefined,
                 visibility,
                 validationKind,
                 status,
-                releaseNotes: typeof entry.releaseNotes === 'string' ? entry.releaseNotes : undefined,
+                releaseNotes: typeof entry.releaseNotes === "string" ? entry.releaseNotes : undefined,
                 successorVersion,
                 symbolPath,
                 contractPath: loadedContract.contractPath,
@@ -1786,21 +1846,21 @@ function buildAssetTasks(catalogues, assetSpecTasks) {
         }
     }
     for (const file of catalogues) {
-        const label = file.relativePath || 'catalogue.json';
+        const label = file.relativePath || "catalogue.json";
         const rawAssets = Array.isArray(file.data.assets) ? file.data.assets : [];
         for (let index = 0; index < rawAssets.length; index++) {
             const entry = rawAssets[index];
-            if (!entry || typeof entry !== 'object') {
+            if (!entry || typeof entry !== "object") {
                 errors.push(`[${label}] Invalid assets[${index}] entry; expected object.`);
                 continue;
             }
-            const name = typeof entry.name === 'string' ? entry.name.trim() : '';
+            const name = typeof entry.name === "string" ? entry.name.trim() : "";
             if (!name) {
                 errors.push(`[${label}] assets[${index}] is missing a name.`);
                 continue;
             }
-            const hasDisplayName = Object.prototype.hasOwnProperty.call(entry, 'displayName');
-            const displayName = typeof entry.displayName === 'string' ? entry.displayName.trim() : '';
+            const hasDisplayName = Object.prototype.hasOwnProperty.call(entry, "displayName");
+            const displayName = typeof entry.displayName === "string" ? entry.displayName.trim() : "";
             if (hasDisplayName && displayName.length === 0) {
                 errors.push(`[${label}] Asset "${name}" displayName must be a non-empty string.`);
                 continue;
@@ -1812,7 +1872,7 @@ function buildAssetTasks(catalogues, assetSpecTasks) {
             }
             seen.set(dedupeKey, label);
             const assetSpec = (0, assetSpecs_1.normalizeAssetSpecVersionRef)(entry.assetSpec, errors, `[${label}] Asset "${name}"`);
-            const isCustomAsset = typeof assetSpec === 'string';
+            const isCustomAsset = typeof assetSpec === "string";
             let category;
             let subcategory;
             let format;
@@ -1832,15 +1892,20 @@ function buildAssetTasks(catalogues, assetSpecTasks) {
                 if (!subcategory) {
                     continue;
                 }
-                format = typeof entry.format === 'string' && entry.format.trim().length > 0 ? entry.format.trim().toUpperCase() : undefined;
+                format =
+                    typeof entry.format === "string" && entry.format.trim().length > 0
+                        ? entry.format.trim().toUpperCase()
+                        : undefined;
             }
-            const fileEntries = entry.files && typeof entry.files === 'object' && !Array.isArray(entry.files)
+            const fileEntries = entry.files && typeof entry.files === "object" && !Array.isArray(entry.files)
                 ? entry.files
                 : null;
             const generatedModel3DFormat = !isCustomAsset && category && subcategory
                 ? inferGeneratedModel3DFormat(category, subcategory, format, fileEntries)
                 : null;
-            const generatedModel3DRoles = generatedModel3DFormat ? getGeneratedModel3DFileRoles(generatedModel3DFormat) : null;
+            const generatedModel3DRoles = generatedModel3DFormat
+                ? getGeneratedModel3DFileRoles(generatedModel3DFormat)
+                : null;
             if (!fileEntries || Object.keys(fileEntries).length === 0) {
                 errors.push(`[${label}] Asset "${name}" must define files.`);
                 continue;
@@ -1849,7 +1914,7 @@ function buildAssetTasks(catalogues, assetSpecTasks) {
             const filePaths = {};
             let hasError = false;
             for (const [role, value] of Object.entries(fileEntries)) {
-                if (typeof value !== 'string' || !value.trim()) {
+                if (typeof value !== "string" || !value.trim()) {
                     errors.push(`[${label}] Asset "${name}" file role "${role}" must be a non-empty string path.`);
                     hasError = true;
                     continue;
@@ -1860,7 +1925,7 @@ function buildAssetTasks(catalogues, assetSpecTasks) {
                 const allowMissingGenerated = Boolean(generatedModel3DRoles?.generated.has(normalizedRole));
                 if (!(0, node_fs_1.existsSync)(absolutePath) || !(0, node_fs_1.statSync)(absolutePath).isFile()) {
                     if (allowMissingGenerated) {
-                        files[role] = relativePath.replace(/\\/g, '/');
+                        files[role] = relativePath.replace(/\\/g, "/");
                         filePaths[role] = absolutePath;
                         continue;
                     }
@@ -1868,7 +1933,7 @@ function buildAssetTasks(catalogues, assetSpecTasks) {
                     hasError = true;
                     continue;
                 }
-                files[role] = relativePath.replace(/\\/g, '/');
+                files[role] = relativePath.replace(/\\/g, "/");
                 filePaths[role] = absolutePath;
             }
             if (hasError) {
@@ -1878,35 +1943,33 @@ function buildAssetTasks(catalogues, assetSpecTasks) {
                 const normalizedRoles = new Set(Object.keys(files).map((role) => normalizeFileRole(role)));
                 const missingRoles = generatedModel3DRoles.required.filter((role) => !normalizedRoles.has(role));
                 if (missingRoles.length > 0) {
-                    errors.push(`[${label}] Asset "${name}" with subcategory=${subcategory} must define files.${missingRoles.join(' and files.')}.`);
+                    errors.push(`[${label}] Asset "${name}" with subcategory=${subcategory} must define files.${missingRoles.join(" and files.")}.`);
                     continue;
                 }
             }
-            if (!isCustomAsset && category === 'SPRITESHEET') {
-                const hasAtlas = Object.prototype.hasOwnProperty.call(files, 'atlas');
-                const hasManifest = Object.prototype.hasOwnProperty.call(files, 'manifest');
+            if (!isCustomAsset && category === "SPRITESHEET") {
+                const hasAtlas = Object.prototype.hasOwnProperty.call(files, "atlas");
+                const hasManifest = Object.prototype.hasOwnProperty.call(files, "manifest");
                 if (!hasAtlas || !hasManifest) {
                     errors.push(`[${label}] Asset "${name}" with category=SPRITESHEET must define files.atlas and files.manifest.`);
                     continue;
                 }
             }
-            if (!isCustomAsset && category === 'AUDIO') {
-                const hasPrimary = Object.prototype.hasOwnProperty.call(files, 'primary');
+            if (!isCustomAsset && category === "AUDIO") {
+                const hasPrimary = Object.prototype.hasOwnProperty.call(files, "primary");
                 if (!hasPrimary) {
                     errors.push(`[${label}] Asset "${name}" with category=AUDIO must define files.primary.`);
                     continue;
                 }
             }
             const errorCountBeforeTagMetadata = errors.length;
-            const remix = normalizeCatalogueRemixRef(entry.remix, 'asset', errors, `[${label}] Asset "${name}"`);
+            const remix = normalizeCatalogueRemixRef(entry.remix, "asset", errors, `[${label}] Asset "${name}"`);
             const tags = normalizeCatalogueTags(entry.tags, errors, `[${label}] Asset "${name}"`);
             const relations = normalizeCatalogueRelations(entry.relations, errors, `[${label}] Asset "${name}"`);
             if (errors.length > errorCountBeforeTagMetadata) {
                 continue;
             }
-            const username = typeof entry.username === 'string' && entry.username.trim().length > 0
-                ? entry.username.trim()
-                : undefined;
+            const username = typeof entry.username === "string" && entry.username.trim().length > 0 ? entry.username.trim() : undefined;
             if (rejectLegacyShopPriceCoinsField(entry, errors, `[${label}] Asset "${name}"`)) {
                 continue;
             }
@@ -1931,7 +1994,7 @@ function buildAssetTasks(catalogues, assetSpecTasks) {
                 continue;
             }
             tasks.push({
-                kind: 'asset',
+                kind: "asset",
                 name,
                 displayName: displayName || undefined,
                 cataloguePath: label,
@@ -1944,7 +2007,7 @@ function buildAssetTasks(catalogues, assetSpecTasks) {
                 visibility: normalizeAssetVisibilityValue(entry.visibility, errors, `${label} asset "${name}"`),
                 license,
                 tags,
-                shopListed: typeof entry.shopListed === 'boolean' ? entry.shopListed : undefined,
+                shopListed: typeof entry.shopListed === "boolean" ? entry.shopListed : undefined,
                 shopPriceCredits: Number.isInteger(entry.shopPriceCredits) ? Number(entry.shopPriceCredits) : undefined,
                 files,
                 filePaths,
@@ -1961,21 +2024,23 @@ function buildAssetPackTasks(catalogues) {
     const errors = [];
     const seen = new Map();
     for (const file of catalogues) {
-        const label = file.relativePath || 'catalogue.json';
-        const rawPacks = Array.isArray(file.data.assetPacks) ? file.data.assetPacks : [];
+        const label = file.relativePath || "catalogue.json";
+        const rawPacks = Array.isArray(file.data.assetPacks)
+            ? file.data.assetPacks
+            : [];
         for (let index = 0; index < rawPacks.length; index++) {
             const entry = rawPacks[index];
-            if (!entry || typeof entry !== 'object') {
+            if (!entry || typeof entry !== "object") {
                 errors.push(`[${label}] Invalid assetPacks[${index}] entry; expected object.`);
                 continue;
             }
-            const name = typeof entry.name === 'string' ? entry.name.trim() : '';
+            const name = typeof entry.name === "string" ? entry.name.trim() : "";
             if (!name) {
                 errors.push(`[${label}] assetPacks[${index}] is missing a name.`);
                 continue;
             }
-            const displayName = typeof entry.displayName === 'string' ? entry.displayName.trim() : '';
-            const version = typeof entry.version === 'string' ? entry.version.trim() : '';
+            const displayName = typeof entry.displayName === "string" ? entry.displayName.trim() : "";
+            const version = typeof entry.version === "string" ? entry.version.trim() : "";
             if (!SEMVER_REGEX.test(version)) {
                 errors.push(`[${label}] Asset pack "${name}" must define a semver version.`);
                 continue;
@@ -1991,7 +2056,9 @@ function buildAssetPackTasks(catalogues) {
                 continue;
             }
             const assets = Array.isArray(entry.assets)
-                ? entry.assets.filter((value) => typeof value === 'string' && value.trim().length > 0).map((value) => value.trim())
+                ? entry.assets
+                    .filter((value) => typeof value === "string" && value.trim().length > 0)
+                    .map((value) => value.trim())
                 : [];
             const ownedAssets = [];
             const rawOwnedAssets = Array.isArray(entry.ownedAssets)
@@ -1999,12 +2066,12 @@ function buildAssetPackTasks(catalogues) {
                 : [];
             for (let ownedIndex = 0; ownedIndex < rawOwnedAssets.length; ownedIndex++) {
                 const owned = rawOwnedAssets[ownedIndex];
-                const ownedName = typeof owned?.name === 'string' ? owned.name.trim() : '';
+                const ownedName = typeof owned?.name === "string" ? owned.name.trim() : "";
                 if (!ownedName) {
                     errors.push(`[${label}] Skipping asset pack "${name}": ownedAssets[${ownedIndex}] is missing a name.`);
                     continue;
                 }
-                if (typeof owned?.runtimeKey === 'string' && owned.runtimeKey.trim().length > 0) {
+                if (typeof owned?.runtimeKey === "string" && owned.runtimeKey.trim().length > 0) {
                     errors.push(`[${label}] Skipping asset pack "${name}": owned asset "${ownedName}" must not define runtimeKey.`);
                     continue;
                 }
@@ -2013,20 +2080,22 @@ function buildAssetPackTasks(catalogues) {
                     continue;
                 }
                 const subcategory = normalizeAssetSubcategoryValue(owned?.subcategory, category, errors, `[${label}] Skipping asset pack "${name}": owned asset "${ownedName}"`);
-                if (subcategory === null && category !== 'CUSTOM') {
+                if (subcategory === null && category !== "CUSTOM") {
                     continue;
                 }
-                const fileEntries = owned?.files && typeof owned.files === 'object' && !Array.isArray(owned.files)
+                const fileEntries = owned?.files && typeof owned.files === "object" && !Array.isArray(owned.files)
                     ? owned.files
                     : null;
                 const assetSpec = (0, assetSpecs_1.normalizeAssetSpecVersionRef)(owned?.assetSpec, errors, `[${label}] Asset pack "${name}" owned asset "${ownedName}"`);
-                const ownedFormat = typeof owned?.format === 'string' && owned.format.trim().length > 0
+                const ownedFormat = typeof owned?.format === "string" && owned.format.trim().length > 0
                     ? owned.format.trim().toUpperCase()
                     : undefined;
                 const generatedModel3DFormat = subcategory
                     ? inferGeneratedModel3DFormat(category, subcategory, ownedFormat, fileEntries)
                     : null;
-                const generatedModel3DRoles = generatedModel3DFormat ? getGeneratedModel3DFileRoles(generatedModel3DFormat) : null;
+                const generatedModel3DRoles = generatedModel3DFormat
+                    ? getGeneratedModel3DFileRoles(generatedModel3DFormat)
+                    : null;
                 if (!fileEntries || Object.keys(fileEntries).length === 0) {
                     errors.push(`[${label}] Skipping asset pack "${name}": owned asset "${ownedName}" must define files.`);
                     continue;
@@ -2035,7 +2104,7 @@ function buildAssetPackTasks(catalogues) {
                 const filePaths = {};
                 let ownedAssetHasError = false;
                 for (const [role, fileValue] of Object.entries(fileEntries)) {
-                    if (typeof fileValue !== 'string' || !fileValue.trim()) {
+                    if (typeof fileValue !== "string" || !fileValue.trim()) {
                         errors.push(`[${label}] Skipping asset pack "${name}": owned asset "${ownedName}" file role "${role}" must be a non-empty string path.`);
                         ownedAssetHasError = true;
                         continue;
@@ -2046,7 +2115,7 @@ function buildAssetPackTasks(catalogues) {
                     const allowMissingGenerated = Boolean(generatedModel3DRoles?.generated.has(normalizedRole));
                     if (!(0, node_fs_1.existsSync)(absoluteOwnedPath) || !(0, node_fs_1.statSync)(absoluteOwnedPath).isFile()) {
                         if (allowMissingGenerated) {
-                            files[role] = relativeOwnedPath.replace(/\\/g, '/');
+                            files[role] = relativeOwnedPath.replace(/\\/g, "/");
                             filePaths[role] = absoluteOwnedPath;
                             continue;
                         }
@@ -2054,7 +2123,7 @@ function buildAssetPackTasks(catalogues) {
                         ownedAssetHasError = true;
                         continue;
                     }
-                    files[role] = relativeOwnedPath.replace(/\\/g, '/');
+                    files[role] = relativeOwnedPath.replace(/\\/g, "/");
                     filePaths[role] = absoluteOwnedPath;
                 }
                 if (ownedAssetHasError) {
@@ -2064,19 +2133,19 @@ function buildAssetPackTasks(catalogues) {
                     const normalizedRoles = new Set(Object.keys(files).map((role) => normalizeFileRole(role)));
                     const missingRoles = generatedModel3DRoles.required.filter((role) => !normalizedRoles.has(role));
                     if (missingRoles.length > 0) {
-                        errors.push(`[${label}] Skipping asset pack "${name}": owned asset "${ownedName}" with subcategory=${subcategory} must define files.${missingRoles.join(' and files.')}.`);
+                        errors.push(`[${label}] Skipping asset pack "${name}": owned asset "${ownedName}" with subcategory=${subcategory} must define files.${missingRoles.join(" and files.")}.`);
                         continue;
                     }
                 }
-                if (category === 'SPRITESHEET') {
-                    const hasAtlas = Object.prototype.hasOwnProperty.call(files, 'atlas');
-                    const hasManifest = Object.prototype.hasOwnProperty.call(files, 'manifest');
+                if (category === "SPRITESHEET") {
+                    const hasAtlas = Object.prototype.hasOwnProperty.call(files, "atlas");
+                    const hasManifest = Object.prototype.hasOwnProperty.call(files, "manifest");
                     if (!hasAtlas || !hasManifest) {
                         errors.push(`[${label}] Skipping asset pack "${name}": owned asset "${ownedName}" with category=SPRITESHEET must define files.atlas and files.manifest.`);
                         continue;
                     }
                 }
-                if (category === 'AUDIO' && !Object.prototype.hasOwnProperty.call(files, 'primary')) {
+                if (category === "AUDIO" && !Object.prototype.hasOwnProperty.call(files, "primary")) {
                     errors.push(`[${label}] Skipping asset pack "${name}": owned asset "${ownedName}" with category=AUDIO must define files.primary.`);
                     continue;
                 }
@@ -2094,8 +2163,10 @@ function buildAssetPackTasks(catalogues) {
                 ownedAssets.push({
                     name: ownedName,
                     cataloguePath: label,
-                    displayName: typeof owned?.displayName === 'string' && owned.displayName.trim().length > 0 ? owned.displayName.trim() : undefined,
-                    description: typeof owned?.description === 'string' ? owned.description : undefined,
+                    displayName: typeof owned?.displayName === "string" && owned.displayName.trim().length > 0
+                        ? owned.displayName.trim()
+                        : undefined,
+                    description: typeof owned?.description === "string" ? owned.description : undefined,
                     category,
                     subcategory,
                     assetSpec,
@@ -2103,23 +2174,23 @@ function buildAssetPackTasks(catalogues) {
                     visibility: normalizeAssetVisibilityValue(owned?.visibility, errors, `${label} asset pack "${name}" owned asset "${ownedName}"`),
                     license: ownedLicense,
                     tags: ownedTags,
-                    shopListed: typeof owned?.shopListed === 'boolean' ? owned.shopListed : undefined,
+                    shopListed: typeof owned?.shopListed === "boolean" ? owned.shopListed : undefined,
                     shopPriceCredits: Number.isInteger(owned?.shopPriceCredits) ? Number(owned.shopPriceCredits) : undefined,
                     files,
                     filePaths,
                 });
             }
             let hostingMode;
-            const rawHostingMode = typeof entry.hostingMode === 'string' ? entry.hostingMode.trim().toUpperCase() : '';
+            const rawHostingMode = typeof entry.hostingMode === "string" ? entry.hostingMode.trim().toUpperCase() : "";
             if (rawHostingMode) {
                 if (!types_1.APP_HOSTING_MODE_VALUES.includes(rawHostingMode)) {
-                    errors.push(`[${label}] Asset pack "${name}" hostingMode must be one of ${types_1.APP_HOSTING_MODE_VALUES.join(', ')}.`);
+                    errors.push(`[${label}] Asset pack "${name}" hostingMode must be one of ${types_1.APP_HOSTING_MODE_VALUES.join(", ")}.`);
                     continue;
                 }
                 hostingMode = rawHostingMode;
             }
             let externalUrl;
-            const rawExternalUrl = typeof entry.externalUrl === 'string' ? entry.externalUrl.trim() : '';
+            const rawExternalUrl = typeof entry.externalUrl === "string" ? entry.externalUrl.trim() : "";
             if (rawExternalUrl) {
                 if (!/^https:\/\//i.test(rawExternalUrl)) {
                     errors.push(`[${label}] Asset pack "${name}" externalUrl must be an HTTPS URL.`);
@@ -2128,7 +2199,7 @@ function buildAssetPackTasks(catalogues) {
                 externalUrl = rawExternalUrl;
             }
             let downloadUrl;
-            const rawDownloadUrl = typeof entry.downloadUrl === 'string' ? entry.downloadUrl.trim() : '';
+            const rawDownloadUrl = typeof entry.downloadUrl === "string" ? entry.downloadUrl.trim() : "";
             if (rawDownloadUrl) {
                 if (!/^https:\/\//i.test(rawDownloadUrl)) {
                     errors.push(`[${label}] Asset pack "${name}" downloadUrl must be an HTTPS URL.`);
@@ -2136,38 +2207,36 @@ function buildAssetPackTasks(catalogues) {
                 }
                 downloadUrl = rawDownloadUrl;
             }
-            if (hostingMode === 'EXTERNAL' && !externalUrl) {
+            if (hostingMode === "EXTERNAL" && !externalUrl) {
                 errors.push(`[${label}] Asset pack "${name}" externalUrl is required when hostingMode is EXTERNAL.`);
                 continue;
             }
-            if (externalUrl && hostingMode !== 'EXTERNAL') {
-                hostingMode = 'EXTERNAL';
+            if (externalUrl && hostingMode !== "EXTERNAL") {
+                hostingMode = "EXTERNAL";
             }
-            if (assets.length === 0 && ownedAssets.length === 0 && hostingMode !== 'EXTERNAL') {
+            if (assets.length === 0 && ownedAssets.length === 0 && hostingMode !== "EXTERNAL") {
                 errors.push(`[${label}] Asset pack "${name}" must reference at least one asset.`);
                 continue;
             }
             const errorCountBeforeTagMetadata = errors.length;
-            const remix = normalizeCatalogueRemixRef(entry.remix, 'pack', errors, `[${label}] Asset pack "${name}@${version}"`);
+            const remix = normalizeCatalogueRemixRef(entry.remix, "pack", errors, `[${label}] Asset pack "${name}@${version}"`);
             const tags = normalizeCatalogueTags(entry.tags, errors, `[${label}] Asset pack "${name}@${version}"`);
             const relations = normalizeCatalogueRelations(entry.relations, errors, `[${label}] Asset pack "${name}@${version}"`);
             if (errors.length > errorCountBeforeTagMetadata) {
                 continue;
             }
-            const username = typeof entry.username === 'string' && entry.username.trim().length > 0
-                ? entry.username.trim()
-                : undefined;
-            const visibility = typeof entry.visibility === 'string' && entry.visibility.trim().length > 0
+            const username = typeof entry.username === "string" && entry.username.trim().length > 0 ? entry.username.trim() : undefined;
+            const visibility = typeof entry.visibility === "string" && entry.visibility.trim().length > 0
                 ? entry.visibility.trim().toUpperCase()
                 : undefined;
-            if (visibility && visibility !== 'PUBLIC' && visibility !== 'PRIVATE') {
+            if (visibility && visibility !== "PUBLIC" && visibility !== "PRIVATE") {
                 errors.push(`[${label}] Asset pack "${name}" visibility must be PUBLIC or PRIVATE.`);
                 continue;
             }
             let listing;
             const rawListing = entry.listing;
             let listingValidationFailed = false;
-            if (rawListing && typeof rawListing === 'object') {
+            if (rawListing && typeof rawListing === "object") {
                 const resolvedListing = {
                     screenshotPortraitPaths: [],
                     screenshotLandscapePaths: [],
@@ -2175,15 +2244,15 @@ function buildAssetPackTasks(catalogues) {
                     videoLandscapePaths: [],
                     mediaMetadata: [],
                 };
-                if (typeof rawListing.icon === 'string' && rawListing.icon.trim()) {
+                if (typeof rawListing.icon === "string" && rawListing.icon.trim()) {
                     const iconPath = rawListing.icon.trim();
-                    const extensionError = validateListingAssetExtension(iconPath, 'assetPacks.listing.icon', 'image');
+                    const extensionError = validateListingAssetExtension(iconPath, "assetPacks.listing.icon", "image");
                     if (extensionError) {
                         errors.push(`[${label}] Skipping asset pack "${name}": ${extensionError}`);
                         listingValidationFailed = true;
                     }
                     else {
-                        const validationError = validateListingAssetPath(file.directory, iconPath, 'assetPacks.listing.icon');
+                        const validationError = validateListingAssetPath(file.directory, iconPath, "assetPacks.listing.icon");
                         if (validationError) {
                             errors.push(`[${label}] Skipping asset pack "${name}": ${validationError}`);
                             listingValidationFailed = true;
@@ -2193,15 +2262,15 @@ function buildAssetPackTasks(catalogues) {
                         }
                     }
                 }
-                if (!listingValidationFailed && typeof rawListing.heroPortrait === 'string' && rawListing.heroPortrait.trim()) {
+                if (!listingValidationFailed && typeof rawListing.heroPortrait === "string" && rawListing.heroPortrait.trim()) {
                     const heroPortraitPath = rawListing.heroPortrait.trim();
-                    const extensionError = validateListingAssetExtension(heroPortraitPath, 'assetPacks.listing.heroPortrait', 'image');
+                    const extensionError = validateListingAssetExtension(heroPortraitPath, "assetPacks.listing.heroPortrait", "image");
                     if (extensionError) {
                         errors.push(`[${label}] Skipping asset pack "${name}": ${extensionError}`);
                         listingValidationFailed = true;
                     }
                     else {
-                        const validationError = validateListingAssetPath(file.directory, heroPortraitPath, 'assetPacks.listing.heroPortrait');
+                        const validationError = validateListingAssetPath(file.directory, heroPortraitPath, "assetPacks.listing.heroPortrait");
                         if (validationError) {
                             errors.push(`[${label}] Skipping asset pack "${name}": ${validationError}`);
                             listingValidationFailed = true;
@@ -2211,15 +2280,17 @@ function buildAssetPackTasks(catalogues) {
                         }
                     }
                 }
-                if (!listingValidationFailed && typeof rawListing.heroLandscape === 'string' && rawListing.heroLandscape.trim()) {
+                if (!listingValidationFailed &&
+                    typeof rawListing.heroLandscape === "string" &&
+                    rawListing.heroLandscape.trim()) {
                     const heroLandscapePath = rawListing.heroLandscape.trim();
-                    const extensionError = validateListingAssetExtension(heroLandscapePath, 'assetPacks.listing.heroLandscape', 'image');
+                    const extensionError = validateListingAssetExtension(heroLandscapePath, "assetPacks.listing.heroLandscape", "image");
                     if (extensionError) {
                         errors.push(`[${label}] Skipping asset pack "${name}": ${extensionError}`);
                         listingValidationFailed = true;
                     }
                     else {
-                        const validationError = validateListingAssetPath(file.directory, heroLandscapePath, 'assetPacks.listing.heroLandscape');
+                        const validationError = validateListingAssetPath(file.directory, heroLandscapePath, "assetPacks.listing.heroLandscape");
                         if (validationError) {
                             errors.push(`[${label}] Skipping asset pack "${name}": ${validationError}`);
                             listingValidationFailed = true;
@@ -2230,10 +2301,34 @@ function buildAssetPackTasks(catalogues) {
                     }
                 }
                 for (const mediaField of [
-                    { value: rawListing.screenshotsPortrait, fieldName: 'assetPacks.listing.screenshotsPortrait', kind: 'image', fileKeyPrefix: 'screenshotsPortrait', target: resolvedListing.screenshotPortraitPaths },
-                    { value: rawListing.screenshotsLandscape, fieldName: 'assetPacks.listing.screenshotsLandscape', kind: 'image', fileKeyPrefix: 'screenshotsLandscape', target: resolvedListing.screenshotLandscapePaths },
-                    { value: rawListing.videosPortrait, fieldName: 'assetPacks.listing.videosPortrait', kind: 'video', fileKeyPrefix: 'videosPortrait', target: resolvedListing.videoPortraitPaths },
-                    { value: rawListing.videosLandscape, fieldName: 'assetPacks.listing.videosLandscape', kind: 'video', fileKeyPrefix: 'videosLandscape', target: resolvedListing.videoLandscapePaths },
+                    {
+                        value: rawListing.screenshotsPortrait,
+                        fieldName: "assetPacks.listing.screenshotsPortrait",
+                        kind: "image",
+                        fileKeyPrefix: "screenshotsPortrait",
+                        target: resolvedListing.screenshotPortraitPaths,
+                    },
+                    {
+                        value: rawListing.screenshotsLandscape,
+                        fieldName: "assetPacks.listing.screenshotsLandscape",
+                        kind: "image",
+                        fileKeyPrefix: "screenshotsLandscape",
+                        target: resolvedListing.screenshotLandscapePaths,
+                    },
+                    {
+                        value: rawListing.videosPortrait,
+                        fieldName: "assetPacks.listing.videosPortrait",
+                        kind: "video",
+                        fileKeyPrefix: "videosPortrait",
+                        target: resolvedListing.videoPortraitPaths,
+                    },
+                    {
+                        value: rawListing.videosLandscape,
+                        fieldName: "assetPacks.listing.videosLandscape",
+                        kind: "video",
+                        fileKeyPrefix: "videosLandscape",
+                        target: resolvedListing.videoLandscapePaths,
+                    },
                 ]) {
                     if (listingValidationFailed)
                         break;
@@ -2257,15 +2352,15 @@ function buildAssetPackTasks(catalogues) {
                 }
                 listing = resolvedListing;
             }
-            const previewApp = typeof entry.previewApp === 'string'
+            const previewApp = typeof entry.previewApp === "string"
                 ? String(entry.previewApp).trim()
-                : '';
+                : "";
             if (previewApp.length > 0) {
                 errors.push(`[${label}] Skipping asset pack "${name}": previewApp is no longer supported during publish. Upload the pack first, then set previewAppVersionId explicitly with creations asset-packs update.`);
                 continue;
             }
             tasks.push({
-                kind: 'asset-pack',
+                kind: "asset-pack",
                 name,
                 displayName: displayName || undefined,
                 version,
@@ -2279,7 +2374,7 @@ function buildAssetPackTasks(catalogues) {
                 downloadUrl,
                 visibility,
                 license,
-                releaseNotes: typeof entry.releaseNotes === 'string' ? entry.releaseNotes : undefined,
+                releaseNotes: typeof entry.releaseNotes === "string" ? entry.releaseNotes : undefined,
                 tags,
                 listing,
                 relations,
@@ -2296,13 +2391,13 @@ function resolveCatalogueTagGroups(rootDir) {
             errors: discoveryErrors,
         };
     }
-    const rootCatalogue = files.find((file) => file.relativePath === 'catalogue.json');
-    const hasNestedCatalogues = files.some((file) => file.relativePath !== 'catalogue.json');
+    const rootCatalogue = files.find((file) => file.relativePath === "catalogue.json");
+    const hasNestedCatalogues = files.some((file) => file.relativePath !== "catalogue.json");
     if (rootCatalogue && hasNestedCatalogues && !isCatalogueMarker(rootCatalogue)) {
         return {
             groups: [],
             errors: [
-                '[catalogue.json] Workspace root catalogue.json must be {} when nested catalogue.json files exist below it.',
+                "[catalogue.json] Workspace root catalogue.json must be {} when nested catalogue.json files exist below it.",
             ],
         };
     }
@@ -2310,15 +2405,15 @@ function resolveCatalogueTagGroups(rootDir) {
     const errors = [];
     const seenGroupSlugs = new Set();
     for (const file of files) {
-        const label = file.relativePath || 'catalogue.json';
+        const label = file.relativePath || "catalogue.json";
         const rawGroups = Array.isArray(file.data.tagGroups) ? file.data.tagGroups : [];
         for (let index = 0; index < rawGroups.length; index += 1) {
             const entry = rawGroups[index];
-            if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+            if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
                 errors.push(`[${label}] tagGroups[${index}] must be an object.`);
                 continue;
             }
-            const slug = typeof entry.slug === 'string' ? entry.slug.trim().toLowerCase() : '';
+            const slug = typeof entry.slug === "string" ? entry.slug.trim().toLowerCase() : "";
             if (!slug || !(0, types_1.isValidTagSlug)(slug)) {
                 errors.push(`[${label}] tagGroups[${index}] slug must use lowercase slug format.`);
                 continue;
@@ -2327,7 +2422,7 @@ function resolveCatalogueTagGroups(rootDir) {
                 errors.push(`[${label}] Duplicate tag group slug "${slug}".`);
                 continue;
             }
-            const displayName = typeof entry.displayName === 'string' ? entry.displayName.trim() : '';
+            const displayName = typeof entry.displayName === "string" ? entry.displayName.trim() : "";
             if (!displayName) {
                 errors.push(`[${label}] tagGroups[${index}] displayName must be a non-empty string.`);
                 continue;
@@ -2342,11 +2437,11 @@ function resolveCatalogueTagGroups(rootDir) {
             const seenTagSlugs = new Set();
             for (let tagIndex = 0; tagIndex < entry.tags.length; tagIndex += 1) {
                 const rawTag = entry.tags[tagIndex];
-                if (!rawTag || typeof rawTag !== 'object' || Array.isArray(rawTag)) {
+                if (!rawTag || typeof rawTag !== "object" || Array.isArray(rawTag)) {
                     errors.push(`[${label}] Tag group "${slug}" tags[${tagIndex}] must be an object.`);
                     continue;
                 }
-                const tagSlug = typeof rawTag.slug === 'string' ? rawTag.slug.trim().toLowerCase() : '';
+                const tagSlug = typeof rawTag.slug === "string" ? rawTag.slug.trim().toLowerCase() : "";
                 if (!tagSlug || !(0, types_1.isValidTagSlug)(tagSlug)) {
                     errors.push(`[${label}] Tag group "${slug}" tags[${tagIndex}] slug must use lowercase slug format.`);
                     continue;
@@ -2355,7 +2450,7 @@ function resolveCatalogueTagGroups(rootDir) {
                     errors.push(`[${label}] Tag group "${slug}" contains duplicate tag slug "${tagSlug}".`);
                     continue;
                 }
-                const tagDisplayName = typeof rawTag.displayName === 'string' ? rawTag.displayName.trim() : '';
+                const tagDisplayName = typeof rawTag.displayName === "string" ? rawTag.displayName.trim() : "";
                 if (!tagDisplayName) {
                     errors.push(`[${label}] Tag group "${slug}" tag "${tagSlug}" displayName must be a non-empty string.`);
                     continue;
@@ -2400,8 +2495,8 @@ function resolveCatalogueEntries(rootDir, options = {}) {
             errors: discoveryErrors,
         };
     }
-    const rootCatalogue = files.find((file) => file.relativePath === 'catalogue.json');
-    const hasNestedCatalogues = files.some((file) => file.relativePath !== 'catalogue.json');
+    const rootCatalogue = files.find((file) => file.relativePath === "catalogue.json");
+    const hasNestedCatalogues = files.some((file) => file.relativePath !== "catalogue.json");
     if (rootCatalogue && hasNestedCatalogues && !isCatalogueMarker(rootCatalogue)) {
         return {
             apps: [],
@@ -2411,7 +2506,7 @@ function resolveCatalogueEntries(rootDir, options = {}) {
             assetPacks: [],
             warnings: [],
             errors: [
-                '[catalogue.json] Workspace root catalogue.json must be {} when nested catalogue.json files exist below it.',
+                "[catalogue.json] Workspace root catalogue.json must be {} when nested catalogue.json files exist below it.",
             ],
         };
     }
@@ -2437,7 +2532,7 @@ function findNearestCatalogue(startDir) {
     const visited = new Set();
     while (!visited.has(current)) {
         visited.add(current);
-        const candidate = (0, node_path_1.join)(current, 'catalogue.json');
+        const candidate = (0, node_path_1.join)(current, "catalogue.json");
         if ((0, node_fs_1.existsSync)(candidate) && (0, node_fs_1.statSync)(candidate).isFile()) {
             return candidate;
         }
@@ -2455,70 +2550,70 @@ function resolveWorkspaceApp(options) {
         if ((0, node_fs_1.existsSync)(absolute)) {
             const stats = (0, node_fs_1.statSync)(absolute);
             if (stats.isDirectory()) {
-                const cataloguePath = (0, node_path_1.join)(absolute, 'catalogue.json');
+                const cataloguePath = (0, node_path_1.join)(absolute, "catalogue.json");
                 if (!(0, node_fs_1.existsSync)(cataloguePath)) {
                     return {
-                        kind: 'not_found',
-                        reason: 'catalogue_missing',
+                        kind: "not_found",
+                        reason: "catalogue_missing",
                         message: `Directory ${absolute} does not contain catalogue.json.`,
                     };
                 }
-                return { kind: 'directory', cataloguePath };
+                return { kind: "directory", cataloguePath };
             }
-            if (!stats.isFile() || (0, node_path_1.extname)(absolute).toLowerCase() !== '.html') {
+            if (!stats.isFile() || (0, node_path_1.extname)(absolute).toLowerCase() !== ".html") {
                 return {
-                    kind: 'not_found',
-                    reason: 'app_missing',
+                    kind: "not_found",
+                    reason: "app_missing",
                     message: `Target ${absolute} is not an app HTML file.`,
                 };
             }
-            return { kind: 'file', htmlPath: absolute };
+            return { kind: "file", htmlPath: absolute };
         }
         const lookup = resolveCatalogueEntries(cwd, { filterName: target });
         if (lookup.errors.length > 0) {
             return {
-                kind: 'not_found',
-                reason: 'app_missing',
+                kind: "not_found",
+                reason: "app_missing",
                 message: lookup.errors[0],
             };
         }
         if (lookup.apps.length > 1) {
             return {
-                kind: 'not_found',
-                reason: 'multiple_apps',
+                kind: "not_found",
+                reason: "multiple_apps",
                 message: `Multiple catalogue entries share the app name "${target}".`,
             };
         }
         if (lookup.apps.length === 1) {
-            return { kind: 'app', task: lookup.apps[0], warnings: lookup.warnings };
+            return { kind: "app", task: lookup.apps[0], warnings: lookup.warnings };
         }
         return {
-            kind: 'not_found',
-            reason: 'app_missing',
+            kind: "not_found",
+            reason: "app_missing",
             message: `App "${target}" was not found in any catalogue.json under ${cwd}.`,
         };
     }
     const nearestCatalogue = findNearestCatalogue(cwd);
     if (!nearestCatalogue) {
         return {
-            kind: 'not_found',
-            reason: 'catalogue_missing',
-            message: 'Run this command inside a workspace with catalogue.json or provide a path.',
+            kind: "not_found",
+            reason: "catalogue_missing",
+            message: "Run this command inside a workspace with catalogue.json or provide a path.",
         };
     }
     const catalogueDir = (0, node_path_1.dirname)(nearestCatalogue);
     const lookup = resolveCatalogueEntries(catalogueDir);
     if (lookup.errors.length > 0) {
         return {
-            kind: 'not_found',
-            reason: 'app_missing',
+            kind: "not_found",
+            reason: "app_missing",
             message: lookup.errors[0],
         };
     }
     if (lookup.apps.length === 0) {
         return {
-            kind: 'not_found',
-            reason: 'no_apps',
+            kind: "not_found",
+            reason: "no_apps",
             message: `No apps found in ${nearestCatalogue}.`,
         };
     }
@@ -2526,21 +2621,21 @@ function resolveWorkspaceApp(options) {
         const matched = lookup.apps.find((task) => task.name === appName);
         if (!matched) {
             return {
-                kind: 'not_found',
-                reason: 'app_missing',
+                kind: "not_found",
+                reason: "app_missing",
                 message: `App "${appName}" was not found in ${nearestCatalogue}.`,
             };
         }
-        return { kind: 'app', task: matched, warnings: lookup.warnings };
+        return { kind: "app", task: matched, warnings: lookup.warnings };
     }
     if (lookup.apps.length > 1) {
         return {
-            kind: 'not_found',
-            reason: 'multiple_apps',
+            kind: "not_found",
+            reason: "multiple_apps",
             message: `Multiple apps found in ${nearestCatalogue}. Specify the app name to continue.`,
         };
     }
-    return { kind: 'app', task: lookup.apps[0], warnings: lookup.warnings };
+    return { kind: "app", task: lookup.apps[0], warnings: lookup.warnings };
 }
 function formatMetadataWarnings(warnings) {
     return new Set(warnings);
@@ -2551,7 +2646,7 @@ function formatMissingMetadataWarnings(task) {
     }
     return `${task.cataloguePath} (${formatMissingMetadata(task.missingMetadata)})`;
 }
-function findAppTaskByFile(htmlPath) {
+function findAppTaskByFile(htmlPath, options = {}) {
     const normalizedFilePath = normalizePathForComparison(htmlPath);
     const visited = new Set();
     let currentDir = (0, node_path_1.dirname)(normalizedFilePath);
@@ -2559,6 +2654,7 @@ function findAppTaskByFile(htmlPath) {
         visited.add(currentDir);
         const result = resolveCatalogueEntries(currentDir, {
             filterFile: normalizedFilePath,
+            listingAssets: options.listingAssets,
         });
         if (result.errors.length > 0) {
             return { errors: result.errors, warnings: [], task: undefined };