@playdrop/playdrop-cli 0.3.9 → 0.3.10

package/README.md

@@ -1,6 +1,48 @@
 # @playdrop/playdrop-cli
 
-Command-line interface for creators and AI agents using Playdrop.
+Official Playdrop CLI for the live [Playdrop](https://www.playdrop.ai/) platform.
+
+Use it to browse live examples, create or remix projects, publish browser games and creator apps, and work with AI-generated game assets on Playdrop.
+
+## Install
+
+```bash
+npm install -g @playdrop/playdrop-cli
+```
+
+## Quick Start
+
+```bash
+playdrop auth login
+playdrop auth whoami
+playdrop project init .
+playdrop project create app my-first-game --template playdrop/template/typescript_template
+playdrop project dev my-first-game
+playdrop project publish .
+```
+
+## What You Can Do
+
+- Browse the live Playdrop catalogue of apps, assets, and packs
+- Inspect real references before building or remixing
+- Create, remix, validate, and publish Playdrop projects
+- Manage comments, versions, credits, notifications, and creations
+- Read the public Playdrop docs directly from the CLI
+
+## Links
+
+- Website: [playdrop.ai](https://www.playdrop.ai/)
+- Getting started: [playdrop.ai/docs/getting-started](https://www.playdrop.ai/docs/getting-started)
+- CLI docs: [playdrop.ai/docs/cli](https://www.playdrop.ai/docs/cli)
+- SDK docs: [playdrop.ai/docs/sdk](https://www.playdrop.ai/docs/sdk)
+- Templates and demos: [playdrop.ai/docs/samples/templates-and-demos](https://www.playdrop.ai/docs/samples/templates-and-demos)
+- Public Playdrop skill: [skills.sh/playdrop-ai/playdrop-skills/playdrop](https://skills.sh/playdrop-ai/playdrop-skills/playdrop)
+
+## Live Examples
+
+- [Starter Kit Racing](https://www.playdrop.ai/creators/playdrop/apps/game/starter-kit-racing)
+- [Hangingout](https://www.playdrop.ai/creators/playdrop/apps/game/hangingout)
+- [Top Creators](https://www.playdrop.ai/top-creators)
 
 ## Main Commands
 

package/config/client-meta.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.3.9",
+  "version": "0.3.10",
   "build": 1,
   "platforms": {
     "ios": {
@@ -26,20 +26,19 @@
   },
   "clients": {
     "web": {
-      "minimumVersion": "0.3.9",
+      "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
     "admin": {
-      "minimumVersion": "0.3.9",
+      "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
     "apple": {
-      "minimumVersion": "0.3.9",
+      "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
     "cli": {
-      "minimumVersion": "0.3.9",
-      "minimumBuild": 1
+      "minimumVersion": "0.3.10"
     }
   }
 }

package/dist/catalogue-utils.js

@@ -42,11 +42,18 @@ function parseSurfaceTargets(input) {
     return { map, list };
 }
 const DEFAULT_SURFACE_TARGETS_OBJECT = { desktop: true, mobileLandscape: false, mobilePortrait: false };
+const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
 function parseCatalogueEntries(cataloguePath) {
     try {
         const raw = (0, node_fs_1.readFileSync)(cataloguePath, 'utf8');
-        const data = raw.trim() ? JSON.parse(raw) : {};
-        const entries = Array.isArray(data) ? data : data?.apps;
+        const data = JSON.parse(raw);
+        if (!data || typeof data !== 'object' || Array.isArray(data)) {
+            throw new Error('catalogue.json must be an object');
+        }
+        if (Object.prototype.hasOwnProperty.call(data, LEGACY_CATALOGUE_VERSION_KEY)) {
+            throw new Error('legacy top-level version field is not supported');
+        }
+        const entries = data?.apps;
         return Array.isArray(entries)
             ? entries.filter((entry) => Boolean(entry && typeof entry === 'object'))
             : [];

package/dist/catalogue.d.ts

@@ -1,6 +1,5 @@
 import { type AppSurface, type AppType, type AppHostingMode, type AppVersionVisibility } from '@playdrop/types';
 export type CatalogueJson = {
-    schemaVersion?: number;
     apps?: Array<Record<string, unknown>>;
     assets?: Array<Record<string, unknown>>;
     assetPacks?: Array<Record<string, unknown>>;

package/dist/catalogue.js

@@ -12,6 +12,7 @@ const types_1 = require("@playdrop/types");
 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 ASSET_CATEGORY_SET = new Set(types_1.ASSET_CATEGORY_VALUES);
 const LISTING_IMAGE_EXTENSIONS = new Set(['.png']);
 const LISTING_VIDEO_EXTENSIONS = new Set(['.mp4']);
@@ -192,24 +193,24 @@ function shouldSkipDirectory(name) {
 function readCatalogueFile(rootDir, filePath) {
     try {
         const raw = (0, node_fs_1.readFileSync)(filePath, 'utf8');
-        const parsed = raw.trim() ? JSON.parse(raw) : {};
+        const parsed = JSON.parse(raw);
         if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
             return { error: 'catalogue.json must contain a JSON object' };
         }
-        if (parsed.schemaVersion !== 2) {
-            return { error: 'catalogue.json must set "schemaVersion": 2' };
+        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.' };
         }
         const forbiddenKeys = ['avatars', 'humanoids', 'creatures', 'blocks', 'games'];
         for (const key of forbiddenKeys) {
             if (Object.prototype.hasOwnProperty.call(parsed, key)) {
-                return { error: `catalogue.json schema v2 forbids top-level "${key}"` };
+                return { error: `catalogue.json forbids top-level "${key}"` };
             }
         }
-        const allowedKeys = new Set(['schemaVersion', 'apps', 'assets', 'assetPacks']);
+        const allowedKeys = new Set(['apps', 'assets', 'assetPacks']);
         const unknownKeys = Object.keys(parsed).filter((key) => !allowedKeys.has(key));
         if (unknownKeys.length > 0) {
             return {
-                error: `catalogue.json schema v2 contains unsupported top-level key "${unknownKeys[0]}"`,
+                error: `catalogue.json contains unsupported top-level key "${unknownKeys[0]}"`,
             };
         }
         const directory = (0, node_path_1.dirname)(filePath);
@@ -283,6 +284,9 @@ function walkCatalogueTree(rootDir) {
     files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
     return { files, errors };
 }
+function isCatalogueMarker(file) {
+    return Object.keys(file.data).length === 0;
+}
 const packageJsonCache = new Map();
 function resolvePackageJson(projectDir) {
     const candidate = (0, node_path_1.join)(projectDir, 'package.json');
@@ -633,10 +637,10 @@ function buildAppTasks(rootDir, catalogues, options) {
                 }
                 serverPath = absoluteServerPath;
             }
-            // Parse versioning fields (required in schema v2)
+            // Parse versioning fields.
             const rawVersion = typeof entry.version === 'string' ? entry.version.trim() : '';
             if (!rawVersion) {
-                errors.push(`[${label}] Skipping ${rawName}: app version is required in schema v2 (e.g., "1.0.0").`);
+                errors.push(`[${label}] Skipping ${rawName}: app version is required (e.g., "1.0.0").`);
                 continue;
             }
             if (!SEMVER_REGEX.test(rawVersion)) {
@@ -1398,6 +1402,20 @@ function resolveCatalogueEntries(rootDir, options = {}) {
             errors: discoveryErrors,
         };
     }
+    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: [],
+            assets: [],
+            embeddedAssets: [],
+            assetPacks: [],
+            warnings: [],
+            errors: [
+                '[catalogue.json] Workspace root catalogue.json must be {} when nested catalogue.json files exist below it.',
+            ],
+        };
+    }
     const { tasks: appTasks, warnings: appWarnings, errors: appErrors } = buildAppTasks(rootDir, files, options);
     const { tasks: assetTasks, warnings: assetWarnings, errors: assetErrors } = buildAssetTasks(files);
     const { tasks: assetPackTasks, warnings: assetPackWarnings, errors: assetPackErrors } = buildAssetPackTasks(files);

package/dist/commands/create.js

@@ -21,6 +21,8 @@ const app_1 = require("@playdrop/types/app");
 const catalogue_utils_1 = require("../catalogue-utils");
 const catalogue_1 = require("../catalogue");
 const CATALOGUE_FILENAME = 'catalogue.json';
+const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
+const ALLOWED_CATALOGUE_TOP_LEVEL_KEYS = new Set(['apps', 'assets', 'assetPacks']);
 async function downloadArchive(url) {
     const response = await fetch(url);
     if (!response.ok) {
@@ -147,6 +149,14 @@ function runNpmInstall(projectDir) {
     });
     return result.status === 0;
 }
+function findUnsupportedCatalogueTopLevelKey(parsed) {
+    for (const key of Object.keys(parsed)) {
+        if (!ALLOWED_CATALOGUE_TOP_LEVEL_KEYS.has(key) && key !== 'games') {
+            return key;
+        }
+    }
+    return null;
+}
 function extractEntryPointFromMetadata(metadata) {
     if (!metadata) {
         return null;
@@ -265,9 +275,6 @@ function buildCatalogueEntry(name, metadata, sourceInfo, relativeFilePath) {
 function readCatalogue(path) {
     try {
         const raw = (0, node_fs_1.readFileSync)(path, 'utf8');
-        if (!raw.trim()) {
-            return { schemaVersion: 2, apps: [] };
-        }
         const parsed = JSON.parse(raw);
         if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
             return null;
@@ -278,14 +285,39 @@ function readCatalogue(path) {
         return null;
     }
 }
+function hasNestedCatalogueFiles(rootDir) {
+    const rootCataloguePath = (0, node_path_1.join)(rootDir, CATALOGUE_FILENAME);
+    const stack = [rootDir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        const entries = (0, node_fs_1.readdirSync)(current, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+                continue;
+            }
+            const absolutePath = (0, node_path_1.join)(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(absolutePath);
+                continue;
+            }
+            if (entry.isFile() && entry.name === CATALOGUE_FILENAME && absolutePath !== rootCataloguePath) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
 function ensureCatalogueEntry(name, metadata, cataloguePath, sourceInfo, htmlFilePath) {
     const path = (0, node_path_1.resolve)(cataloguePath);
     const catalogueDir = (0, node_path_1.dirname)(path);
+    if (hasNestedCatalogueFiles(catalogueDir)) {
+        return { path, createdFile: false, addedEntry: false, error: 'workspace_root_marker_required' };
+    }
     const relativeFilePath = (0, node_path_1.relative)(catalogueDir, (0, node_path_1.resolve)(htmlFilePath)) || `${name}.html`;
     const normalizedFilePath = relativeFilePath.replace(/\\/g, '/');
     const entry = buildCatalogueEntry(name, metadata, sourceInfo, normalizedFilePath);
     if (!(0, node_fs_1.existsSync)(path)) {
-        const catalogue = { schemaVersion: 2, apps: [entry] };
+        const catalogue = { apps: [entry] };
         (0, node_fs_1.writeFileSync)(path, `${JSON.stringify(catalogue, null, 2)}\n`);
         return { path, createdFile: true, addedEntry: true };
     }
@@ -293,9 +325,13 @@ function ensureCatalogueEntry(name, metadata, cataloguePath, sourceInfo, htmlFil
     if (!parsed) {
         return { path, createdFile: false, addedEntry: false, error: 'invalid_json' };
     }
-    if (parsed.schemaVersion !== 2) {
+    if (Object.prototype.hasOwnProperty.call(parsed, LEGACY_CATALOGUE_VERSION_KEY)) {
         return { path, createdFile: false, addedEntry: false, error: 'invalid_schema_version' };
     }
+    const unsupportedKey = findUnsupportedCatalogueTopLevelKey(parsed);
+    if (unsupportedKey) {
+        return { path, createdFile: false, addedEntry: false, error: 'unsupported_top_level_key', unsupportedKey };
+    }
     if (!Array.isArray(parsed.apps) && Array.isArray(parsed.games)) {
         return { path, createdFile: false, addedEntry: false, error: 'legacy_games_property' };
     }
@@ -325,7 +361,17 @@ function logCatalogueOutcome(result, name) {
         return false;
     }
     if (result.error === 'invalid_schema_version') {
-        (0, messages_1.printErrorWithHelp)(`${label} must set "schemaVersion": 2.`, ['Update the file to schema v2 and rerun `playdrop project create app`.'], { command: 'project create app' });
+        (0, messages_1.printErrorWithHelp)(`${label} must not define the legacy top-level version field.`, ['Remove the legacy top-level version field from the file and rerun `playdrop project create app`.'], { command: 'project create app' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'unsupported_top_level_key') {
+        (0, messages_1.printErrorWithHelp)(`${label} contains unsupported top-level key "${result.unsupportedKey || 'unknown'}".`, ['Keep catalogue.json limited to apps, assets, and assetPacks, then rerun `playdrop project create app`.'], { command: 'project create app' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'workspace_root_marker_required') {
+        (0, messages_1.printErrorWithHelp)(`${label} must stay {} because nested catalogue.json files already exist below this directory.`, ['Create the app inside its own project folder instead of writing entries into the workspace root catalogue.json.'], { command: 'project create app' });
         process.exitCode = process.exitCode || 1;
         return false;
     }
@@ -344,13 +390,20 @@ function logCatalogueOutcome(result, name) {
 }
 function updateExtractedProjectCatalogue(name, metadata, projectCataloguePath, sourceInfo, htmlFilePath) {
     const path = (0, node_path_1.resolve)(projectCataloguePath);
+    if (hasNestedCatalogueFiles((0, node_path_1.dirname)(path))) {
+        return { path, updated: false, error: 'workspace_root_marker_required' };
+    }
     const parsed = readCatalogue(path);
     if (!parsed) {
         return { path, updated: false, error: 'invalid_json' };
     }
-    if (parsed.schemaVersion !== 2) {
+    if (Object.prototype.hasOwnProperty.call(parsed, LEGACY_CATALOGUE_VERSION_KEY)) {
         return { path, updated: false, error: 'invalid_schema_version' };
     }
+    const unsupportedKey = findUnsupportedCatalogueTopLevelKey(parsed);
+    if (unsupportedKey) {
+        return { path, updated: false, error: 'unsupported_top_level_key', unsupportedKey };
+    }
     if (!Array.isArray(parsed.apps) && Array.isArray(parsed.games)) {
         return { path, updated: false, error: 'legacy_games_property' };
     }
@@ -436,7 +489,17 @@ function logProjectCatalogueOutcome(result, name) {
         return false;
     }
     if (result.error === 'invalid_schema_version') {
-        (0, messages_1.printErrorWithHelp)(`${label} must set "schemaVersion": 2.`, ['Update the file to schema v2 and rerun `playdrop project create app`.'], { command: 'project create app' });
+        (0, messages_1.printErrorWithHelp)(`${label} must not define the legacy top-level version field.`, ['Remove the legacy top-level version field from the file and rerun `playdrop project create app`.'], { command: 'project create app' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'unsupported_top_level_key') {
+        (0, messages_1.printErrorWithHelp)(`${label} contains unsupported top-level key "${result.unsupportedKey || 'unknown'}".`, ['Keep catalogue.json limited to apps, assets, and assetPacks, then rerun `playdrop project create app`.'], { command: 'project create app' });
+        process.exitCode = process.exitCode || 1;
+        return false;
+    }
+    if (result.error === 'workspace_root_marker_required') {
+        (0, messages_1.printErrorWithHelp)(`${label} must stay {} because nested catalogue.json files already exist below this directory.`, ['Create the app inside its own project folder instead of writing entries into the workspace root catalogue.json.'], { command: 'project create app' });
         process.exitCode = process.exitCode || 1;
         return false;
     }
@@ -640,9 +703,10 @@ function parseRemixScaffoldResponse(response, version) {
         if (!externalListingUrl) {
             throw new Error('Remix response missing externalListingUrl');
         }
+        const externalMetadata = parseExternalRemixMetadata(response.metadata);
         return {
             html: null,
-            metadata,
+            metadata: externalMetadata,
             externalListingUrl,
             entryPoint,
             sourceVersion: null,
@@ -650,6 +714,38 @@ function parseRemixScaffoldResponse(response, version) {
     }
     throw new Error(`Unsupported remix mode: ${remixMode || 'missing'}`);
 }
+function parseExternalRemixMetadata(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Remix response missing external metadata');
+    }
+    const record = value;
+    const name = typeof record.name === 'string' ? record.name.trim() : '';
+    const displayName = typeof record.displayName === 'string' ? record.displayName.trim() : '';
+    const description = typeof record.description === 'string' ? record.description.trim() : '';
+    const creatorUsername = typeof record.creatorUsername === 'string' ? record.creatorUsername.trim() : '';
+    const type = (0, app_1.parseAppType)(record.type) ?? '';
+    const emoji = record.emoji;
+    const color = record.color;
+    if (!name || !displayName || !description || !creatorUsername || !type) {
+        throw new Error('Remix response missing required external metadata fields');
+    }
+    if (emoji !== null && typeof emoji !== 'string') {
+        throw new Error('Remix response has invalid external metadata emoji');
+    }
+    if (color !== null && typeof color !== 'string') {
+        throw new Error('Remix response has invalid external metadata color');
+    }
+    return {
+        name,
+        displayName,
+        description,
+        creatorUsername,
+        type,
+        emoji,
+        color,
+        surfaceTargets: (0, catalogue_utils_1.parseSurfaceTargets)(record.surfaceTargets).list,
+    };
+}
 async function fetchRemixScaffold(client, creator, app, version) {
     try {
         const response = await client.fetchRemixScaffold(creator, app, version);

package/dist/commands/createRemixContent.js

@@ -13,6 +13,8 @@ const http_1 = require("../http");
 const messages_1 = require("../messages");
 const init_1 = require("./init");
 const CATALOGUE_FILENAME = 'catalogue.json';
+const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
+const ALLOWED_CATALOGUE_TOP_LEVEL_KEYS = new Set(['apps', 'assets', 'assetPacks']);
 const MIME_TYPE_TO_EXTENSION = {
     'image/png': '.png',
     'image/jpeg': '.jpg',
@@ -67,14 +69,40 @@ function readWorkspaceCatalogue(path) {
         throw new Error(`Invalid catalogue.json at ${path}.`);
     }
     const catalogue = parsed;
-    if (catalogue.schemaVersion !== 2) {
-        throw new Error(`catalogue.json at ${path} must set "schemaVersion": 2.`);
+    if (Object.prototype.hasOwnProperty.call(catalogue, LEGACY_CATALOGUE_VERSION_KEY)) {
+        throw new Error(`catalogue.json at ${path} must not define the legacy top-level version field.`);
+    }
+    const unsupportedKey = Object.keys(catalogue).find((key) => !ALLOWED_CATALOGUE_TOP_LEVEL_KEYS.has(key));
+    if (unsupportedKey) {
+        throw new Error(`catalogue.json at ${path} contains unsupported top-level key "${unsupportedKey}".`);
     }
     return catalogue;
 }
 function writeWorkspaceCatalogue(path, catalogue) {
     (0, node_fs_1.writeFileSync)(path, `${JSON.stringify(catalogue, null, 2)}\n`);
 }
+function assertWorkspaceRootCanOwnEntries(cataloguePath) {
+    const rootDir = (0, node_path_1.resolve)(cataloguePath, '..');
+    const rootCataloguePath = (0, node_path_1.join)(rootDir, CATALOGUE_FILENAME);
+    const stack = [rootDir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        const entries = (0, node_fs_1.readdirSync)(current, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+                continue;
+            }
+            const absolutePath = (0, node_path_1.join)(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(absolutePath);
+                continue;
+            }
+            if (entry.isFile() && entry.name === CATALOGUE_FILENAME && absolutePath !== rootCataloguePath) {
+                throw new Error(`catalogue.json at ${cataloguePath} must stay {} because nested catalogue.json files already exist below this directory.`);
+            }
+        }
+    }
+}
 async function createAuthenticatedClient(commandLabel) {
     const cfg = (0, config_1.loadConfig)();
     const envName = cfg.env;
@@ -178,6 +206,7 @@ async function createAssetRemix(name, remixRef) {
     const client = await createAuthenticatedClient('project create asset');
     const cataloguePath = await ensureWorkspaceCataloguePath();
     const catalogue = readWorkspaceCatalogue(cataloguePath);
+    assertWorkspaceRootCanOwnEntries(cataloguePath);
     ensureUniqueEntryName(catalogue, 'asset', name);
     const detail = await client.fetchAssetBySlug(parsedRef.creatorUsername, parsedRef.name);
     const versions = await client.listAssetVersions(parsedRef.creatorUsername, parsedRef.name, { limit: 200, offset: 0 });
@@ -223,6 +252,7 @@ async function createPackRemix(name, remixRef) {
     const client = await createAuthenticatedClient('project create pack');
     const cataloguePath = await ensureWorkspaceCataloguePath();
     const catalogue = readWorkspaceCatalogue(cataloguePath);
+    assertWorkspaceRootCanOwnEntries(cataloguePath);
     ensureUniqueEntryName(catalogue, 'pack', name);
     const detail = await client.fetchAssetPackBySlug(parsedRef.creatorUsername, parsedRef.name);
     const versions = await client.listAssetPackVersions(parsedRef.creatorUsername, parsedRef.name, { limit: 200, offset: 0 });

package/dist/commands/init.js

@@ -16,7 +16,9 @@ const http_1 = require("../http");
 const environment_1 = require("../environment");
 const messages_1 = require("../messages");
 const clientInfo_1 = require("../clientInfo");
-const DEFAULT_CATALOGUE = `${JSON.stringify({ apps: [] }, null, 2)}\n`;
+const DEFAULT_CATALOGUE = '{}\n';
+const LEGACY_CATALOGUE_VERSION_KEY = ['schema', 'Version'].join('');
+const ALLOWED_CATALOGUE_TOP_LEVEL_KEYS = new Set(['apps', 'assets', 'assetPacks']);
 function ensureTrailingNewline(content) {
     return content.endsWith('\n') ? content : `${content}\n`;
 }
@@ -100,7 +102,33 @@ function normalizeBootstrapPayload(payload) {
     const catalogueRaw = typeof payload.catalogue === 'string' && payload.catalogue.trim().length > 0
         ? payload.catalogue
         : DEFAULT_CATALOGUE;
-    const catalogue = ensureTrailingNewline(catalogueRaw.trim() ? catalogueRaw : DEFAULT_CATALOGUE);
+    const catalogueCandidate = ensureTrailingNewline(catalogueRaw.trim() ? catalogueRaw : DEFAULT_CATALOGUE);
+    let parsedCatalogue;
+    try {
+        parsedCatalogue = JSON.parse(catalogueCandidate);
+    }
+    catch {
+        (0, messages_1.printErrorWithHelp)('Bootstrap payload returned an invalid catalogue.json.', ['Contact the platform team or try again shortly.'], { command: 'project init' });
+        process.exitCode = 1;
+        return null;
+    }
+    if (!parsedCatalogue || typeof parsedCatalogue !== 'object' || Array.isArray(parsedCatalogue)) {
+        (0, messages_1.printErrorWithHelp)('Bootstrap payload returned an invalid catalogue.json.', ['Contact the platform team or try again shortly.'], { command: 'project init' });
+        process.exitCode = 1;
+        return null;
+    }
+    if (Object.prototype.hasOwnProperty.call(parsedCatalogue, LEGACY_CATALOGUE_VERSION_KEY)) {
+        (0, messages_1.printErrorWithHelp)('Bootstrap payload returned a legacy catalogue.json with a top-level version field.', ['Contact the platform team or try again shortly.'], { command: 'project init' });
+        process.exitCode = 1;
+        return null;
+    }
+    const unsupportedKey = Object.keys(parsedCatalogue).find((key) => !ALLOWED_CATALOGUE_TOP_LEVEL_KEYS.has(key));
+    if (unsupportedKey) {
+        (0, messages_1.printErrorWithHelp)(`Bootstrap payload returned catalogue.json with unsupported top-level key "${unsupportedKey}".`, ['Contact the platform team or try again shortly.'], { command: 'project init' });
+        process.exitCode = 1;
+        return null;
+    }
+    const catalogue = catalogueCandidate;
     return { readmeUri, agentsUri, catalogue };
 }
 async function downloadBootstrapAsset(webBase, uri, label) {

package/dist/taskSelection.js

@@ -66,8 +66,8 @@ function selectTasks(pathOrName) {
             if (taskList.length === 0) {
                 errors.push({
                     type: 'no-tasks',
-                    message: `No catalogue.json files were found under ${absolute}.`,
-                    help: ['Add catalogue.json files to the project folders you want to process, then rerun the command.'],
+                    message: `No publishable entries were found under ${absolute}.`,
+                    help: ['Add child catalogue.json files or add apps, assets, or assetPacks to the root catalogue.json, then rerun the command.'],
                     directory: absolute,
                 });
                 return { tasks: [], warnings, errors, resolution: 'directory' };

package/node_modules/@playdrop/config/client-meta.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.3.9",
+  "version": "0.3.10",
   "build": 1,
   "platforms": {
     "ios": {
@@ -26,20 +26,19 @@
   },
   "clients": {
     "web": {
-      "minimumVersion": "0.3.9",
+      "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
     "admin": {
-      "minimumVersion": "0.3.9",
+      "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
     "apple": {
-      "minimumVersion": "0.3.9",
+      "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
     "cli": {
-      "minimumVersion": "0.3.9",
-      "minimumBuild": 1
+      "minimumVersion": "0.3.10"
     }
   }
 }

package/node_modules/@playdrop/config/dist/test/validateClientEnvironment.test.js

@@ -53,6 +53,19 @@ function runtime(overrides = {}) {
         strict_1.default.equal(result.code, 'unsupported_platform_version');
     }
 });
+(0, node_test_1.default)('does not require a build floor for newer cli versions once the version is supported', () => {
+    const meta = (0, index_1.loadClientMeta)();
+    const requiredVersion = meta.clients['cli']?.minimumVersion ?? meta.version;
+    const info = runtime({
+        client: 'cli',
+        clientVersion: requiredVersion,
+        clientBuild: 0,
+        platform: 'macos',
+        platformVersion: '14.0',
+    });
+    const result = (0, index_1.validateClientEnvironment)(info);
+    strict_1.default.equal(result.ok, true);
+});
 (0, node_test_1.default)('returns failure when metadata is incomplete', () => {
     const info = runtime({ clientVersion: '', platformVersion: '' });
     const result = (0, index_1.validateClientEnvironment)(info);