@playdrop/playdrop-cli 0.3.9 → 0.3.11

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.11",
   "build": 1,
   "platforms": {
     "ios": {
@@ -26,20 +26,19 @@
   },
   "clients": {
     "web": {
-      "minimumVersion": "0.3.9",
+      "minimumVersion": "0.3.11",
       "minimumBuild": 1
     },
     "admin": {
-      "minimumVersion": "0.3.9",
+      "minimumVersion": "0.3.11",
       "minimumBuild": 1
     },
     "apple": {
-      "minimumVersion": "0.3.9",
+      "minimumVersion": "0.3.10",
       "minimumBuild": 1
     },
     "cli": {
-      "minimumVersion": "0.3.9",
-      "minimumBuild": 1
+      "minimumVersion": "0.3.11"
     }
   }
 }

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/browse.js

@@ -362,7 +362,7 @@ async function browse(options = {}) {
                     if (apiError.status === 401 || apiError.status === 403) {
                         return {
                             problem: 'Browsing this content requires you to be logged in.',
-                            suggestions: ['Run "playdrop auth login" and retry.'],
+                            suggestions: ['Run "playdrop login" and retry.'],
                         };
                     }
                     return {

package/dist/commands/capture.js

@@ -326,8 +326,8 @@ async function capture(targetArg, options = {}) {
         }
         if (error instanceof types_1.ApiError) {
             (0, messages_1.printErrorWithHelp)(`Could not fetch your account (status ${error.status}).`, [
-                'Run "playdrop auth login" to refresh your session and ensure the API is reachable.',
-                'Use "playdrop auth whoami" afterwards to confirm your status.'
+                'Run "playdrop login" to refresh your session and ensure the API is reachable.',
+                'Use "playdrop whoami" afterwards to confirm your status.',
             ], { command: 'project capture' });
             process.exitCode = 1;
             return;

package/dist/commands/comments.js

@@ -72,7 +72,7 @@ async function browseComments(rawRef, options = {}) {
                     if (apiError.status === 401 || apiError.status === 403) {
                         return {
                             problem: `You do not have access to comments for "${ref.ref}".`,
-                            suggestions: ['Run "playdrop auth login" if this is private content you own.'],
+                            suggestions: ['Run "playdrop login" if this is private content you own.'],
                         };
                     }
                     return {
@@ -125,7 +125,7 @@ async function addComment(rawRef, options = {}) {
                     if (apiError.status === 401 || apiError.status === 403) {
                         return {
                             problem: 'Adding a comment requires you to be logged in.',
-                            suggestions: ['Run "playdrop auth login" and retry.'],
+                            suggestions: ['Run "playdrop login" and retry.'],
                         };
                     }
                     if (apiError.status === 404) {
@@ -166,7 +166,7 @@ async function deleteComment(commentId, options = {}) {
                     if (apiError.status === 401 || apiError.status === 403) {
                         return {
                             problem: 'Deleting a comment requires a valid login with permission to manage it.',
-                            suggestions: ['Run "playdrop auth login" and retry.'],
+                            suggestions: ['Run "playdrop login" and retry.'],
                         };
                     }
                     if (apiError.status === 404) {

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);
@@ -781,7 +877,7 @@ async function create(name, options = {}) {
         const choices = (0, environment_1.formatEnvironmentList)();
         (0, messages_1.printErrorWithHelp)(`Environment "${envName}" from your Playdrop config is not supported.`, [
             `Available environments: ${choices}.`,
-            'Run "playdrop auth login --env <env>" to save a supported environment before creating apps.'
+            'Run "playdrop login --env <env>" to save a supported environment before creating apps.'
         ], { command: 'project create app', includeGeneralHelp: false });
         process.exitCode = 1;
         return;
@@ -1131,7 +1227,7 @@ async function create(name, options = {}) {
                 return;
             }
             if (error instanceof types_1.ApiError) {
-                (0, messages_1.printErrorWithHelp)(`Failed to resolve your creator account (status ${error.status}).`, ['Run "playdrop auth login" to refresh your session, then try again.'], { command: 'project create app' });
+                (0, messages_1.printErrorWithHelp)(`Failed to resolve your creator account (status ${error.status}).`, ['Run "playdrop login" to refresh your session, then try again.'], { command: 'project create app' });
                 process.exitCode = 1;
                 return;
             }
@@ -1141,7 +1237,7 @@ async function create(name, options = {}) {
                 return;
             }
             if (error instanceof Error && error.message === 'missing_creator_username') {
-                (0, messages_1.printErrorWithHelp)('The API did not return a creator username.', ['Run "playdrop auth login" again, then retry.'], { command: 'project create app' });
+                (0, messages_1.printErrorWithHelp)('The API did not return a creator username.', ['Run "playdrop login" again, then retry.'], { command: 'project create app' });
                 process.exitCode = 1;
                 return;
             }

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;
@@ -87,7 +115,7 @@ async function createAuthenticatedClient(commandLabel) {
     if (!envConfig) {
         (0, messages_1.printErrorWithHelp)(`Environment "${envName}" from your Playdrop config is not supported.`, [
             `Available environments: ${(0, environment_1.formatEnvironmentList)()}.`,
-            'Run "playdrop auth login --env <env>" to save a supported environment before retrying.',
+            'Run "playdrop login --env <env>" to save a supported environment before retrying.',
         ], { command: commandLabel, includeGeneralHelp: false });
         process.exitCode = 1;
         throw new Error('unsupported_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/creations.js

@@ -65,7 +65,7 @@ async function resolveCreator(client, rawCreator, command) {
     const response = await client.me();
     const username = response.user?.username?.trim();
     if (!username) {
-        (0, messages_1.printErrorWithHelp)('Could not resolve your current creator account.', ['Run "playdrop auth whoami" to confirm your session, then retry.'], { command });
+        (0, messages_1.printErrorWithHelp)('Could not resolve your current creator account.', ['Run "playdrop whoami" to confirm your session, then retry.'], { command });
         process.exitCode = 1;
         return null;
     }
@@ -283,7 +283,7 @@ async function browseCreations(options = {}) {
             const handled = (0, errors_1.handleCommandFailure)(error, 'creations browse', 'Creation lookup', {
                 apiMessage: (apiError) => ({
                     problem: `Creation lookup failed with status ${apiError.status}.`,
-                    suggestions: ['Run "playdrop auth login" and retry.'],
+                    suggestions: ['Run "playdrop login" and retry.'],
                 }),
             });
             if (!handled) {

package/dist/commands/credits.js

@@ -34,7 +34,7 @@ async function showCreditBalance(options = {}) {
             const handled = (0, errors_1.handleCommandFailure)(error, 'credits balance', 'Credit balance lookup', {
                 apiMessage: (apiError) => ({
                     problem: `Credit balance lookup failed with status ${apiError.status}.`,
-                    suggestions: ['Run "playdrop auth login" and retry.'],
+                    suggestions: ['Run "playdrop login" and retry.'],
                 }),
             });
             if (!handled) {
@@ -80,7 +80,7 @@ async function browseCreditTransactions(options = {}) {
             const handled = (0, errors_1.handleCommandFailure)(error, 'credits transactions', 'Credit transaction lookup', {
                 apiMessage: (apiError) => ({
                     problem: `Credit transaction lookup failed with status ${apiError.status}.`,
-                    suggestions: ['Run "playdrop auth login" and retry.'],
+                    suggestions: ['Run "playdrop login" and retry.'],
                 }),
             });
             if (!handled) {

package/dist/commands/detail.js

@@ -161,7 +161,7 @@ async function detail(rawRef, options = {}) {
                     if (apiError.status === 401 || apiError.status === 403) {
                         return {
                             problem: `You do not have access to "${ref.ref}".`,
-                            suggestions: ['Run "playdrop auth login" if this is private content you own.', 'Use "playdrop help detail" for the ref format.'],
+                            suggestions: ['Run "playdrop login" if this is private content you own.', 'Use "playdrop help detail" for the ref format.'],
                         };
                     }
                     return {

package/dist/commands/dev.js

@@ -120,8 +120,8 @@ async function dev(targetArg, _port, appOption) {
         }
         if (error instanceof types_1.ApiError) {
             (0, messages_1.printErrorWithHelp)(`Could not fetch your account (status ${error.status}).`, [
-                'Run "playdrop auth login" to refresh your session and ensure the API is reachable.',
-                'Use "playdrop auth whoami" afterwards to confirm your status.'
+                'Run "playdrop login" to refresh your session and ensure the API is reachable.',
+                'Use "playdrop whoami" afterwards to confirm your status.',
             ], { command: 'project dev' });
             process.exitCode = 1;
             return;

package/dist/commands/feedback.js

@@ -96,7 +96,7 @@ async function sendFeedback(options = {}) {
             const handled = (0, errors_1.handleCommandFailure)(error, 'feedback send', 'Feedback send', {
                 apiMessage: (apiError) => ({
                     problem: `Feedback send failed with status ${apiError.status}.`,
-                    suggestions: ['Check the provided fields and retry.', 'Run "playdrop auth login" if your session may be stale.'],
+                    suggestions: ['Check the provided fields and retry.', 'Run "playdrop login" if your session may be stale.'],
                 }),
             });
             if (!handled) {

package/dist/commands/generation.js

@@ -601,7 +601,7 @@ function handleAiFailure(error, command, context) {
             if (apiError.status === 401 || apiError.status === 403) {
                 return {
                     problem: `${context} requires you to be logged in.`,
-                    suggestions: ['Run "playdrop auth login" and retry.'],
+                    suggestions: ['Run "playdrop login" and retry.'],
                 };
             }
             return {
@@ -616,7 +616,7 @@ function handleAiFailure(error, command, context) {
     const status = typeof error?.status === 'number' ? Number(error.status) : null;
     if (status !== null) {
         if (status === 401 || status === 403) {
-            (0, messages_1.printErrorWithHelp)(`${context} requires you to be logged in.`, ['Run "playdrop auth login" and retry.'], { command });
+            (0, messages_1.printErrorWithHelp)(`${context} requires you to be logged in.`, ['Run "playdrop login" and retry.'], { command });
         }
         else {
             (0, messages_1.printErrorWithHelp)(`${context} failed with status ${status}.`, ['Retry in a moment.'], { command });

package/dist/commands/gettingStarted.js

@@ -4,7 +4,7 @@ exports.printGettingStarted = printGettingStarted;
 function printGettingStarted() {
     console.log('Start here:\n');
     console.log('1. Log in');
-    console.log('   playdrop auth login');
+    console.log('   playdrop login');
     console.log('');
     console.log('2. Initialize a workspace');
     console.log('   playdrop project init .');