@playcraft/cli 0.0.55 → 0.0.57

package/dist/remix/clone.js

@@ -0,0 +1,256 @@
+import { spawnSync } from 'node:child_process';
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import { loadGlobalConfig } from '../config.js';
+import { PlayCraftHttpClient } from '../utils/playcraft-http-client.js';
+import { isRemoteCloneSource, resolveRemixCloneTarget, } from './clone-source.js';
+/** Build the branch-scoped Git Smart HTTP URL (no credentials in URL). */
+export function buildRemixGitProxyUrl(apiBaseUrl, projectId, branch) {
+    const base = apiBaseUrl.replace(/\/+$/, '');
+    const encodedBranch = encodeURIComponent(branch);
+    return `${base}/api/git/projects/${encodeURIComponent(projectId)}/branches/${encodedBranch}.git`;
+}
+export function resolveCloneTargetDir(projectId, branch, dir) {
+    if (dir?.trim())
+        return path.resolve(dir.trim());
+    const safeBranch = branch.replace(/[/\\]+/g, '-').replace(/[^a-zA-Z0-9._-]+/g, '-');
+    return path.resolve(process.cwd(), `${projectId}-${safeBranch}`);
+}
+function localServiceUrl(baseUrl, fromPort, toPort) {
+    try {
+        const url = new URL(baseUrl);
+        const isLocal = ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname);
+        if (isLocal && url.port === fromPort)
+            url.port = toPort;
+        return url.toString().replace(/\/+$/, '');
+    }
+    catch {
+        return baseUrl.replace(/\/+$/, '');
+    }
+}
+function createApiClient(options) {
+    const configured = new PlayCraftHttpClient(options);
+    const apiBaseUrl = localServiceUrl(configured.baseUrl, '3000', '3001');
+    if (apiBaseUrl === configured.baseUrl)
+        return configured;
+    return new PlayCraftHttpClient({
+        url: apiBaseUrl,
+        token: configured.token,
+        requestId: configured.requestId,
+    });
+}
+/**
+ * Prefer explicit --url; else env/login config (via PlayCraftHttpClient).
+ * Only use pasted portal origin when no API base is configured yet.
+ */
+function resolveApiBaseHint(options, portalOrigin) {
+    if (options.url?.trim())
+        return options.url.trim();
+    const globalConfig = loadGlobalConfig();
+    const configured = process.env.PLAYCRAFT_API_URL ||
+        process.env.PLAYCRAFT_URL ||
+        (typeof globalConfig.backendUrl === 'string' && globalConfig.backendUrl) ||
+        (typeof globalConfig.url === 'string' && globalConfig.url);
+    if (configured)
+        return undefined;
+    if (portalOrigin?.trim()) {
+        return localServiceUrl(portalOrigin.trim(), '3000', '3001');
+    }
+    return undefined;
+}
+function writePlaycraftMeta(targetDir, meta) {
+    writeFileSync(path.join(targetDir, '.playcraft.json'), `${JSON.stringify(meta, null, 2)}\n`, 'utf8');
+}
+function configureRepoCredentialHelper(targetDir) {
+    // Prefer invoking the same CLI binary the user used.
+    const helper = `!playcraft git-credential`;
+    spawnSync('git', ['config', 'credential.helper', helper], {
+        cwd: targetDir,
+        encoding: 'utf8',
+    });
+    spawnSync('git', ['config', 'credential.useHttpPath', 'true'], {
+        cwd: targetDir,
+        encoding: 'utf8',
+    });
+}
+async function resolveProjectIdFromGitHost(client, repositoryUrl) {
+    try {
+        const data = await client.get(`/git/resolve-repo?repositoryUrl=${encodeURIComponent(repositoryUrl)}`);
+        const projectId = String(data?.projectId || data?.projectUuid || '').trim();
+        if (!projectId) {
+            throw new Error('empty_project_id');
+        }
+        return projectId;
+    }
+    catch {
+        throw new Error('无法根据工蜂/Git 地址定位 PlayCraft 项目（无权限或不存在）。请改用 Remix 详情页 URL，或 --project-id / --branch。');
+    }
+}
+export async function remixClone(options) {
+    const target = resolveRemixCloneTarget({
+        source: options.source,
+        projectId: options.projectId,
+        branch: options.branch,
+    });
+    let projectId = target.projectId?.trim() || '';
+    const branch = String(target.branch || '').trim();
+    if (!branch) {
+        throw new Error('缺少 Remix 分支名。');
+    }
+    if (branch === 'main' || branch === 'master') {
+        throw new Error('不允许 clone 主干分支；请指定 Remix 分支（例如 remix/...）。');
+    }
+    const client = createApiClient({
+        url: resolveApiBaseHint(options, target.origin),
+        token: options.token,
+    });
+    if (target.kind === 'git-host') {
+        if (!target.repositoryUrl) {
+            throw new Error('工蜂/Git 地址无效。');
+        }
+        projectId = await resolveProjectIdFromGitHost(client, target.repositoryUrl);
+    }
+    if (!projectId) {
+        throw new Error('缺少项目 ID。');
+    }
+    const cloneUrl = buildRemixGitProxyUrl(client.baseUrl, projectId, branch);
+    const targetDir = resolveCloneTargetDir(projectId, branch, options.dir);
+    if (existsSync(targetDir) && existsSync(path.join(targetDir, '.git'))) {
+        throw new Error(`目标目录已存在 Git 仓库：${targetDir}`);
+    }
+    mkdirSync(path.dirname(targetDir), { recursive: true });
+    if (!options.json) {
+        process.stderr.write(`[clone] ${cloneUrl}\n`);
+        process.stderr.write(`[clone] → ${targetDir}\n`);
+    }
+    const result = spawnSync('git', [
+        '-c',
+        `http.extraHeader=Authorization: Bearer ${client.token}`,
+        'clone',
+        '--branch',
+        branch,
+        '--single-branch',
+        '--depth',
+        '1',
+        cloneUrl,
+        targetDir,
+    ], {
+        encoding: 'utf8',
+        stdio: options.json ? 'pipe' : 'inherit',
+    });
+    if (result.status !== 0) {
+        const detail = [result.stderr, result.stdout].filter(Boolean).join('\n').trim();
+        throw new Error(detail || `git clone 失败（exit ${result.status}）`);
+    }
+    const meta = {
+        schemaVersion: '1.0',
+        projectId,
+        branch,
+        cloneUrl,
+        clonedAt: new Date().toISOString(),
+    };
+    writePlaycraftMeta(targetDir, meta);
+    configureRepoCredentialHelper(targetDir);
+    let projectType;
+    try {
+        const project = await client.get(`/projects/${encodeURIComponent(projectId)}`);
+        projectType = project?.projectType;
+    }
+    catch {
+        // optional — next-step hints only
+    }
+    if (options.install || options.dev) {
+        const install = spawnSync('npm', ['install'], {
+            cwd: targetDir,
+            encoding: 'utf8',
+            stdio: options.json ? 'pipe' : 'inherit',
+            shell: process.platform === 'win32',
+        });
+        if (install.status !== 0) {
+            throw new Error('npm install 失败');
+        }
+    }
+    if (options.dev) {
+        spawnSync('npm', ['run', 'dev'], {
+            cwd: targetDir,
+            encoding: 'utf8',
+            stdio: 'inherit',
+            shell: process.platform === 'win32',
+        });
+    }
+    if (options.json) {
+        console.log(JSON.stringify({
+            schemaVersion: '1.0',
+            ok: true,
+            command: 'remix.clone',
+            requestId: client.requestId,
+            data: { ...meta, targetDir, projectType, sourceKind: target.kind },
+        }));
+        return;
+    }
+    console.log(`✓ Remix 已克隆到 ${targetDir}`);
+    console.log(`  分支: ${branch}`);
+    console.log(`  remote: ${cloneUrl}`);
+    console.log('');
+    console.log('下一步：');
+    console.log(`  cd ${targetDir}`);
+    if (projectType === 'external') {
+        console.log('  npm install && npm run dev');
+    }
+    else {
+        console.log('  playcraft start --project <project-id>   # PlayCanvas / 本地 Agent 预览');
+    }
+    console.log('  playcraft remix pull   # 拉取远端（沙箱 Save 后）');
+    console.log('  playcraft remix push   # 推回 Remix（Windows 勿直接 git push/pull）');
+}
+export { isRemoteCloneSource, resolveRemixCloneTarget };
+/**
+ * Git credential helper (get/store/erase). Only `get` is implemented:
+ * returns PAT from ~/.playcraft/config.json for PlayCraft git proxy hosts.
+ */
+export function gitCredentialCommand(action) {
+    const op = (action || process.argv[3] || 'get').trim();
+    if (op !== 'get') {
+        // store/erase: no-op (PAT lives in global config)
+        return;
+    }
+    const input = readFileSync(0, 'utf8');
+    const attrs = {};
+    for (const line of input.split(/\r?\n/)) {
+        const eq = line.indexOf('=');
+        if (eq <= 0)
+            continue;
+        attrs[line.slice(0, eq)] = line.slice(eq + 1);
+    }
+    const host = attrs.host || '';
+    const protocol = attrs.protocol || 'https';
+    const reqPath = attrs.path || '';
+    if (!reqPath.includes('/api/git/projects/')) {
+        return;
+    }
+    const globalConfig = loadGlobalConfig();
+    const token = process.env.PLAYCRAFT_TOKEN ||
+        (typeof globalConfig.token === 'string' ? globalConfig.token : undefined);
+    if (!token || !token.startsWith('playcraft_pat_')) {
+        return;
+    }
+    // Optional host check against saved backend URL
+    const configured = (typeof globalConfig.backendUrl === 'string' && globalConfig.backendUrl) ||
+        (typeof globalConfig.url === 'string' && globalConfig.url) ||
+        process.env.PLAYCRAFT_API_URL ||
+        process.env.PLAYCRAFT_URL ||
+        '';
+    if (configured && host) {
+        try {
+            const configuredHost = new URL(configured).host;
+            if (configuredHost && configuredHost !== host) {
+                // Still allow if path is clearly our git proxy (e.g. custom CDN host)
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    process.stdout.write(`username=playcraft\npassword=${token}\n\n`);
+    void protocol;
+}

package/dist/remix/local-git.js

@@ -0,0 +1,56 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+/** @internal exported for tests */
+export function readRemixLocalMeta(repoDir) {
+    const metaPath = path.join(repoDir, '.playcraft.json');
+    if (!existsSync(metaPath)) {
+        throw new Error(`未找到 .playcraft.json（当前目录：${repoDir}）。请先在该目录执行 playcraft remix clone，或 cd 到 clone 得到的目录。`);
+    }
+    try {
+        const raw = JSON.parse(readFileSync(metaPath, 'utf8'));
+        const projectId = String(raw.projectId || '').trim();
+        const branch = String(raw.branch || '').trim();
+        const cloneUrl = String(raw.cloneUrl || '').trim();
+        if (!projectId || !branch || !cloneUrl) {
+            throw new Error('invalid_meta');
+        }
+        return {
+            schemaVersion: '1.0',
+            projectId,
+            branch,
+            cloneUrl,
+            clonedAt: typeof raw.clonedAt === 'string' ? raw.clonedAt : new Date().toISOString(),
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('.playcraft.json'))
+            throw error;
+        throw new Error(`.playcraft.json 无效或损坏：${metaPath}`);
+    }
+}
+/** @internal exported for tests */
+export function assertPlaycraftProxyRemote(cloneUrl) {
+    if (!cloneUrl.includes('/api/git/projects/')) {
+        throw new Error(`当前 .playcraft.json 的 cloneUrl 不是 PlayCraft Git 代理地址。\n` +
+            `请用 playcraft remix clone 重新克隆，不要改 remote 到工蜂 / 其它 Git 主机。\n` +
+            `cloneUrl: ${cloneUrl}`);
+    }
+}
+/**
+ * 运行带 PlayCraft PAT 的 git 子命令：注入 Bearer，并清空 credential.helper，
+ * 避免 Windows Git Credential Manager 弹窗。
+ */
+export function runAuthenticatedGit(gitCommandAndArgs, options) {
+    return spawnSync('git', [
+        '-c',
+        'credential.helper=',
+        '-c',
+        `http.extraHeader=Authorization: Bearer ${options.token}`,
+        ...gitCommandAndArgs,
+    ], {
+        cwd: options.cwd,
+        encoding: 'utf8',
+        stdio: options.pipe ? 'pipe' : 'inherit',
+    });
+}

package/dist/remix/pull.js

@@ -0,0 +1,64 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { PlayCraftHttpClient } from '../utils/playcraft-http-client.js';
+import { assertPlaycraftProxyRemote, readRemixLocalMeta, runAuthenticatedGit, } from './local-git.js';
+/**
+ * 从 PlayCraft Git 代理拉取当前 Remix。
+ * 与 remix push 相同：注入 Bearer PAT，并禁用 credential.helper（避免 Windows GCM）。
+ */
+export async function remixPull(options = {}) {
+    const repoDir = path.resolve(options.dir?.trim() || process.cwd());
+    if (!existsSync(path.join(repoDir, '.git'))) {
+        throw new Error(`目录不是 Git 仓库：${repoDir}`);
+    }
+    const meta = readRemixLocalMeta(repoDir);
+    assertPlaycraftProxyRemote(meta.cloneUrl);
+    const client = new PlayCraftHttpClient({
+        url: options.url,
+        token: options.token,
+    });
+    const gitArgs = options.gitArgs?.length ? options.gitArgs : [];
+    const effectiveArgs = gitArgs.length > 0
+        ? gitArgs
+        : (() => {
+            const upstream = spawnSync('git', ['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}'], {
+                cwd: repoDir,
+                encoding: 'utf8',
+            });
+            if (upstream.status === 0 && upstream.stdout.trim()) {
+                return [];
+            }
+            return ['origin', meta.branch];
+        })();
+    if (!options.json) {
+        process.stderr.write(`[pull] ${meta.cloneUrl}\n`);
+        process.stderr.write(`[pull] branch=${meta.branch} dir=${repoDir}\n`);
+    }
+    const result = runAuthenticatedGit(['pull', ...effectiveArgs], {
+        cwd: repoDir,
+        token: client.token,
+        pipe: Boolean(options.json),
+    });
+    if (result.status !== 0) {
+        const detail = [result.stderr, result.stdout].filter(Boolean).join('\n').trim();
+        throw new Error(detail || `git pull 失败（exit ${result.status}）`);
+    }
+    if (options.json) {
+        console.log(JSON.stringify({
+            schemaVersion: '1.0',
+            ok: true,
+            command: 'remix.pull',
+            requestId: client.requestId,
+            data: {
+                projectId: meta.projectId,
+                branch: meta.branch,
+                cloneUrl: meta.cloneUrl,
+                dir: repoDir,
+                gitArgs: effectiveArgs,
+            },
+        }));
+        return;
+    }
+    console.log(`✓ 已从 Remix 分支 ${meta.branch} 拉取`);
+}

package/dist/remix/push.js

@@ -0,0 +1,70 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { PlayCraftHttpClient } from '../utils/playcraft-http-client.js';
+import { assertPlaycraftProxyRemote, readRemixLocalMeta, runAuthenticatedGit, } from './local-git.js';
+export { assertPlaycraftProxyRemote, readRemixLocalMeta } from './local-git.js';
+/**
+ * Push 当前 Remix 仓库到 PlayCraft Git 代理。
+ *
+ * 故意不用 `git push` + credential.helper：Windows 上 Git Credential Manager
+ * 经常抢走鉴权并弹窗。这里与 clone 一样，用一次性 `http.extraHeader` 注入 PAT，
+ * 并清空本命令的 credential.helper，避免 GCM 介入。
+ */
+export async function remixPush(options = {}) {
+    const repoDir = path.resolve(options.dir?.trim() || process.cwd());
+    if (!existsSync(path.join(repoDir, '.git'))) {
+        throw new Error(`目录不是 Git 仓库：${repoDir}`);
+    }
+    const meta = readRemixLocalMeta(repoDir);
+    assertPlaycraftProxyRemote(meta.cloneUrl);
+    const client = new PlayCraftHttpClient({
+        url: options.url,
+        token: options.token,
+    });
+    const gitArgs = options.gitArgs?.length ? options.gitArgs : [];
+    // 默认推当前分支；不强制改用户已设的 upstream。若无 upstream 且未传参数，
+    // 用 meta.branch 设 -u，避免「没有 upstream」报错。
+    const effectiveArgs = gitArgs.length > 0
+        ? gitArgs
+        : (() => {
+            const upstream = spawnSync('git', ['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}'], {
+                cwd: repoDir,
+                encoding: 'utf8',
+            });
+            if (upstream.status === 0 && upstream.stdout.trim()) {
+                return [];
+            }
+            return ['-u', 'origin', meta.branch];
+        })();
+    if (!options.json) {
+        process.stderr.write(`[push] ${meta.cloneUrl}\n`);
+        process.stderr.write(`[push] branch=${meta.branch} dir=${repoDir}\n`);
+    }
+    const result = runAuthenticatedGit(['push', ...effectiveArgs], {
+        cwd: repoDir,
+        token: client.token,
+        pipe: Boolean(options.json),
+    });
+    if (result.status !== 0) {
+        const detail = [result.stderr, result.stdout].filter(Boolean).join('\n').trim();
+        throw new Error(detail || `git push 失败（exit ${result.status}）`);
+    }
+    if (options.json) {
+        console.log(JSON.stringify({
+            schemaVersion: '1.0',
+            ok: true,
+            command: 'remix.push',
+            requestId: client.requestId,
+            data: {
+                projectId: meta.projectId,
+                branch: meta.branch,
+                cloneUrl: meta.cloneUrl,
+                dir: repoDir,
+                gitArgs: effectiveArgs,
+            },
+        }));
+        return;
+    }
+    console.log(`✓ 已推送到 Remix 分支 ${meta.branch}`);
+}

package/dist/scaffold/templates.js

@@ -3,7 +3,7 @@ import { resolveCliPackageRoot } from './compose.js';
 export const CREATE_TEMPLATES = {
     agent: {
         id: 'agent',
-        dir: 'project-template',
+        dir: 'project-template-v2',
         label: 'Agent Team 工作流（默认）',
         kind: 'agent',
     },

package/dist/utils/agent-api-client.js

@@ -26,6 +26,7 @@ export class AgentApiClient {
     apiUrl;
     token;
     isPat;
+    playcraftEnv;
     constructor() {
         const localConfig = AgentApiClient.loadLocalConfig();
         const globalConfig = loadGlobalConfig();
@@ -47,13 +48,19 @@ export class AgentApiClient {
         this.apiUrl = apiUrl;
         this.token = token;
         this.isPat = isPatToken(token);
+        this.playcraftEnv = (process.env.PLAYCRAFT_ENV ||
+            localConfig.env ||
+            '').trim();
     }
     /** 根据 token 类型构造鉴权 headers */
     authHeaders() {
-        if (this.isPat) {
-            return { 'Authorization': `Bearer ${this.token}` };
+        const headers = this.isPat
+            ? { Authorization: `Bearer ${this.token}` }
+            : { 'X-Sandbox-Token': this.token };
+        if (this.playcraftEnv) {
+            headers['playcraft-env'] = this.playcraftEnv;
         }
-        return { 'X-Sandbox-Token': this.token };
+        return headers;
     }
     /** Absolute pathname under /api/agent/tools (path may omit leading slash). */
     toolsRequestUrl(path) {

package/dist/utils/remix-image-attachments.js

@@ -1,15 +1,9 @@
 import { readFileSync, statSync } from 'node:fs';
 import { basename, extname } from 'node:path';
 import { PlayCraftApiError } from './playcraft-http-client.js';
+import { appendRemixReferenceImagesPrompt, referenceImageExtensions, referenceImageMimeFromExtension, } from '@playcraft/common/agent/reference-images';
 const MAX_IMAGES = 4;
 const MAX_IMAGE_BYTES = 5 * 1024 * 1024;
-const IMAGE_MIME_BY_EXTENSION = {
-    '.gif': 'image/gif',
-    '.jpeg': 'image/jpeg',
-    '.jpg': 'image/jpeg',
-    '.png': 'image/png',
-    '.webp': 'image/webp',
-};
 function attachmentError(code, message, details, retryable = false) {
     return new PlayCraftApiError({ code, message, details, retryable });
 }
@@ -22,9 +16,9 @@ export function readImageAttachments(paths) {
     }
     return candidates.map((sourcePath) => {
         const extension = extname(sourcePath).toLowerCase();
-        const mimeType = IMAGE_MIME_BY_EXTENSION[extension];
+        const mimeType = referenceImageMimeFromExtension(extension);
         if (!mimeType) {
-            throw attachmentError('ATTACHMENT_TYPE_UNSUPPORTED', `不支持的图片格式：${sourcePath}。仅支持 JPEG (Joint Photographic Experts Group, 联合图像专家组)、PNG (Portable Network Graphics, 便携式网络图形)、WebP 和 GIF (Graphics Interchange Format, 图形交换格式)。`, { path: sourcePath, supportedExtensions: Object.keys(IMAGE_MIME_BY_EXTENSION) });
+            throw attachmentError('ATTACHMENT_TYPE_UNSUPPORTED', `不支持的图片格式：${sourcePath}。仅支持 JPEG (Joint Photographic Experts Group, 联合图像专家组)、PNG (Portable Network Graphics, 便携式网络图形)、WebP 和 GIF (Graphics Interchange Format, 图形交换格式)。`, { path: sourcePath, supportedExtensions: [...referenceImageExtensions()] });
         }
         let size;
         try {
@@ -98,28 +92,6 @@ export async function uploadImageAttachments(client, projectId, branch, attachme
     return uploaded;
 }
 export function buildReferenceImagesPrompt(prompt, attachments) {
-    if (attachments.length === 0)
-        return prompt;
-    const pathList = attachments.map((attachment) => `- ${attachment.sandboxPath}`).join('\n');
-    return [
-        prompt,
-        '',
-        '[Reference Images]',
-        `The user attached ${attachments.length} image(s) at these sandbox filesystem paths:`,
-        pathList,
-        '',
-        'These files have already been written to the sandbox filesystem.',
-        '',
-        '**IMPORTANT:** Do NOT read, open, or inspect any of these image files. Do NOT use tools like read_file, cat, or any other file reader on them. The paths themselves are all you need.',
-        '',
-        "Infer each image's purpose from the user's message (e.g. reference for style/composition, UI mockup, screenshot illustrating an issue, asset to import, etc.). For any image you judge to be a visual reference, pass its path directly to `playcraft-generate-image` — do NOT ask the user to confirm, and do NOT attempt to examine the image content first.",
-        '',
-        'When passing references to `playcraft-generate-image`:',
-        '- Put the first reference in `referenceImagePath`, remaining ones in `additionalReferenceImagePaths` as a comma-separated string.',
-        '- Preserve the original order.',
-        '- Up to 8 references total; paths must not contain commas.',
-        '- Save generated images under `src/theme/draft/assets/` unless the user explicitly asks for another project asset location.',
-        '- When reporting saved image paths back to the user, prefer `/project/<repo-relative-path>` such as `/project/src/theme/draft/assets/level-ref.png`, not the full `/projects/<projectId>/<branch>/...` path.',
-    ].join('\n');
+    return appendRemixReferenceImagesPrompt(prompt, attachments.map((attachment) => attachment.sandboxPath));
 }
 export const IMAGE_OPTION_HELP = '一个或多个图片路径（最多 4 张；JPEG (Joint Photographic Experts Group, 联合图像专家组)、PNG (Portable Network Graphics, 便携式网络图形)、WebP、GIF (Graphics Interchange Format, 图形交换格式)，每张不超过 5 MB (Megabyte, 兆字节)）';

package/dist/utils/sandbox-path.js

@@ -0,0 +1,20 @@
+/**
+ * Map legacy sandbox project root aliases onto the real cwd.
+ *
+ * Multi-slot sandboxes use workdir `/projects/{projectId}/{branch}` while many
+ * agent prompts / tools still advertise `/project/...`. CLI commands must treat
+ * `/project` as cwd so post-processing (e.g. remove-background) finds files.
+ */
+import { resolve } from 'path';
+export function resolveSandboxPath(userPath, cwd = process.cwd()) {
+    if (!userPath)
+        return userPath;
+    const forward = userPath.replace(/\\/g, '/');
+    if (forward === '/project') {
+        return cwd;
+    }
+    if (forward.startsWith('/project/')) {
+        return resolve(cwd, forward.slice('/project/'.length));
+    }
+    return userPath;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/cli",
-  "version": "0.0.55",
+  "version": "0.0.57",
   "private": false,
   "type": "module",
   "engines": {
@@ -45,8 +45,8 @@
     "@gltf-transform/core": "^4.3.0",
     "@gltf-transform/extensions": "^4.3.0",
     "@gltf-transform/functions": "^4.3.0",
-    "@playcraft/build": "^0.0.55",
-    "@playcraft/common": "^0.0.55",
+    "@playcraft/build": "^0.0.57",
+    "@playcraft/common": "^0.0.57",
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
     "cors": "^2.8.6",