@playcraft/cli 0.1.81 → 0.1.83

package/dist/cli-root-help.js

@@ -10,7 +10,6 @@ export function getCliTopicsHelpText() {
         '  Remix 参考 references list/search/import（发现参考并读取当前工程中的固定快照）',
         '             references prepare-starter-template（准备默认起始模板）',
         '  视频理解   video models | video understand | video jobs get/cancel',
-        '  APK 分析   apk analyze --attachment <引用文件> | apk analyze --resume <runId> | apk jobs get/cancel',
         '  平台       build, build-base, build-playable, build-all, analyze, inspect, upgrade',
         '             tools 除 generate-* 外（Git / 沙箱构建 / 发布 / 列表 / Prefab 等，需后端 API）',
         '  沙箱常驻   workspace-runtime serve（Cloud Workspace，由 Runtime 引导配置启动）',

package/dist/commands/apk.js

@@ -52,8 +52,9 @@ function shared(command) {
         .option('--workspace <id>', t('workspace'))
         .option('--timeout <seconds>', t('timeout'));
 }
+/** Hidden until DevRun is reachable from the platform clusters; the command still works when called directly. */
 export function registerApkCommands(program) {
-    const apk = program.command('apk').description(t('topic'));
+    const apk = program.command('apk', { hidden: true }).description(t('topic'));
     shared(apk.command('analyze').description(t('analyze')))
         .option('--attachment <path>', t('attachment'))
         .option('--out <directory>', t('out'))

package/dist/commands/references.js

@@ -16,7 +16,8 @@ export function registerReferenceCommands(program) {
                     ...(options.tag?.length ? { tagCategory: options.tagCategory ?? 'Gameplay', tagValues: options.tag }
                         : options.tagCategory === undefined ? {} : { tagCategory: options.tagCategory }),
                     page: Number(options.page), limit: Number(options.limit) } : {}),
-                ...(action === 'import' ? { projectUuid: options.project, branchName: options.branch } : {}) });
+                ...(action === 'import' ? { projectUuid: options.project, branchName: options.branch } : {}),
+                ...(action === 'prepare-starter-template' ? { templateId: options.template } : {}) });
             const output = { schemaVersion: 'playcraft.references.v1', command: `references.${action}`, ...result };
             if (options.json)
                 console.log(JSON.stringify(output));
@@ -45,7 +46,8 @@ export function registerReferenceCommands(program) {
     const scope = (command) => command.option('--workspace <id>', message('workspace'))
         .option('--directory <name>', message('directory')).option('--json', message('json'));
     scope(references.command('list').description(message('list'))).action(options => run('list', options));
-    scope(references.command('prepare-starter-template').description(message('prepareStarterTemplate'))).action(options => run('prepare-starter-template', options));
+    scope(references.command('prepare-starter-template').description(message('prepareStarterTemplate'))
+        .option('--template <id>', message('template'))).action(options => run('prepare-starter-template', options));
     scope(references.command('search [query]').description(message('search'))
         .option('--source <source>', message('source'), 'recommended')
         .option('--tag <value>', message('tag'), (value, previous) => [...previous, value], [])

package/dist/references/messages.js

@@ -4,6 +4,7 @@ const messages = {
         list: 'List verified local Remix references and their paths', search: 'Search accessible recommended or community Remixes',
         import: 'Import a fixed Remix source snapshot into the current engineering directory',
         prepareStarterTemplate: 'Prepare a verified starter template in a temporary directory',
+        template: 'Starter template: cocos (default) or threejs',
         query: 'Search names, branches, tags, creators or templates', source: 'recommended or community', project: 'Source project identifier', branch: 'Exact source branch',
         tag: 'Match a tag value; repeat to match any of the values', tagCategory: 'Tag category; defaults to Gameplay when --tag is used',
         workspace: 'Current cloud workspace identifier (must match this conversation)', directory: 'Current engineering directory (must match this conversation)',
@@ -24,6 +25,7 @@ const messages = {
         description: '为当前云工作区发现并导入 Remix 源码参考',
         list: '列出已验证的本地 Remix 参考及路径', search: '搜索可访问的推荐或社区 Remix', import: '把固定版本的 Remix 源码参考导入当前工程',
         prepareStarterTemplate: '将经过校验的起始模板准备到临时目录',
+        template: '起始模板：cocos（默认）或 threejs',
         query: '搜索名称、分支、标签、创建者或模板', source: 'recommended（推荐）或 community（社区）', project: '来源项目标识', branch: '准确的来源分支名',
         tag: '匹配的标签值；可重复指定，匹配任意一个值', tagCategory: '标签分类；使用 --tag 时默认为 Gameplay',
         workspace: '当前云工作区标识（必须与本对话一致）', directory: '当前工程目录（必须与本对话一致）',

package/dist/references/protocol.js

@@ -1,5 +1,6 @@
 import { join } from 'node:path';
 import { z } from 'zod';
+import { WORKSPACE_STARTER_TEMPLATE_IDS } from '@playcraft/common/cloud-workspace/runtime';
 const scope = {
     cwd: z.string().min(1).max(4096),
     workspaceId: z.string().uuid().optional(),
@@ -11,7 +12,9 @@ const scope = {
 export const remixReferenceToolRequestSchema = z
     .discriminatedUnion('action', [
     z.object({ ...scope, action: z.literal('list') }).strict(),
-    z.object({ ...scope, action: z.literal('prepare-starter-template') }).strict(),
+    z
+        .object({ ...scope, action: z.literal('prepare-starter-template'), templateId: z.enum(WORKSPACE_STARTER_TEMPLATE_IDS).optional() })
+        .strict(),
     z
         .object({
         ...scope,

package/dist/workspace-runtime/codex/app-server.js

@@ -33,7 +33,7 @@ function withModelShell(config, modelConfigId) {
 const ENGINEERING_BATCH_INSTRUCTIONS = [
     'For a single replica, work directly in the current repository and preserve the user-provided references. Do not create a batch for a single replica.',
     'If the repository is empty, initialize it using the default starter template before implementing the replica; preserve existing workspace metadata and files. If the template is unavailable, report the failure instead of substituting another template.',
-    'A repository is empty only when it has no user project files, including ignored files; workspace metadata, skills, references and attachments do not count as a project. For an empty repository, run playcraft references prepare-starter-template --json and merge the returned staged template into the current repository. Preserve existing files and workspace configuration, merge .gitignore without replacing it, preserve executable permissions, and report conflicts or preparation failures instead of overwriting files or creating a batch. Once finished, remove only the exact staging directory returned by the command.',
+    'A repository is empty only when it has no user project files, including ignored files; workspace metadata, skills, references and attachments do not count as a project. For an empty repository, run playcraft references prepare-starter-template --template <cocos|threejs> --json and merge the returned staged template into the current repository. Always declare --template explicitly: use threejs when the user asks for a Three.js project, and cocos when the user asks for Cocos or does not specify an engine. Preserve existing files and workspace configuration, merge .gitignore without replacing it, preserve executable permissions, and report conflicts or preparation failures instead of overwriting files or creating a batch. Once finished, remove only the exact staging directory returned by the command.',
     'When the user requests multiple independent engineering variants, create a real platform batch using playcraft tools create-batch --prompt <the complete request, including constraints established in this conversation> --workspace-id <the trusted batch request workspaceId> --source-directory <the trusted batch request sourceDirectoryName> --client-request-id <the trusted batch request clientRequestId> --json.',
     'Distinguish independent variants from multiple assets, levels or themes within one engineering project. Use the current session directory supplied by the runtime as the batch source; do not infer it from a preview or another conversation.',
     'The platform freezes the current source and generates each planned variant in its own Remix directory. Submission authorizes automatic generation without another prompt approval. Keep the source unchanged for this batch; do not replace independent variants with theme switching in the source.',

package/dist/workspace-runtime/codex/model-broker.js

@@ -94,29 +94,9 @@ export class WorkspaceModelBroker {
             activate: (readOnly = false) => {
                 if (!this.valid(entry) || this.routes.get(routeKey) !== route)
                     throw new Error('model_access_denied');
-                const priorFeedback = route.selected?.feedback;
-                let refsBlocked = Boolean(entry.refsBlocked || priorFeedback?.refsBlocked && priorFeedback.clientRequestId === clientRequestId);
-                if (sessionId && clientRequestId) {
-                    const overlaps = (this.state.journal.listOperations?.() ?? []).some(({ operation }) => ['session.turn', 'session.review', 'session.compact'].includes(operation.kind)
-                        && ['dispatched', 'accepted', 'uncertain'].includes(operation.status)
-                        && operation.generation === this.state.config.generation && operation.runtimeEpoch === this.state.runtimeEpoch
-                        && (operation.sessionId !== sessionId || operation.clientRequestId !== clientRequestId));
-                    if (overlaps) {
-                        refsBlocked = true;
-                        // A completed overlapping turn may leave shells alive. Only a later turn gets a new safe boundary.
-                        for (const prepared of this.entries.values()) {
-                            if (prepared.epoch === this.state.runtimeEpoch)
-                                prepared.refsBlocked = true;
-                        }
-                        for (const existing of this.routes.values()) {
-                            if (existing.epoch === this.state.runtimeEpoch && existing.selected?.feedback)
-                                existing.selected.feedback.refsBlocked = true;
-                        }
-                    }
-                }
                 route.lastAdmissionReason = undefined;
                 route.selected = { entry, model: credential.model,
-                    ...(sessionId && clientRequestId ? { feedback: { sessionId, clientRequestId, cwd, boundaryId, readOnly, refsBlocked,
+                    ...(sessionId && clientRequestId ? { feedback: { sessionId, clientRequestId, cwd, boundaryId, readOnly,
                             ...(originCwd ? { originCwd } : {}) } } : {}) };
             },
             model: credential.model,

package/dist/workspace-runtime/codex/remix-references-broker.js

@@ -43,11 +43,12 @@ export class WorkspaceRemixReferencesBroker {
             .map((item) => item.operation)
             .filter((operation) => ['session.turn', 'session.review', 'session.compact'].includes(operation.kind) &&
             ACTIVE.has(operation.status) &&
+            operation.sessionId === context.sessionId &&
+            operation.clientRequestId === context.clientRequestId &&
             operation.generation === state.config.generation &&
             operation.runtimeEpoch === state.runtimeEpoch);
         const operation = operations.length === 1 ? operations[0] : undefined;
         if (!valid() ||
-            context.refsBlocked ||
             state.journal.destroyed() ||
             !operation ||
             operation.kind !== 'session.turn' ||
@@ -182,7 +183,7 @@ export class WorkspaceRemixReferencesBroker {
                     sessionId: context.sessionId, wait: false,
                 }, async () => {
                     await this.current(context, valid, true);
-                    const raw = await this.upstream(scope, { action: 'starter-template' }, WORKSPACE_REMIX_REFERENCE_BODY_MAX_BYTES);
+                    const raw = await this.upstream(scope, { action: 'starter-template', templateId: input.templateId }, WORKSPACE_REMIX_REFERENCE_BODY_MAX_BYTES);
                     await this.current(context, valid, true);
                     return prepareStarterTemplate(context.cwd, raw, () => this.operation(context, valid, true));
                 });

package/dist/workspace-runtime/codex/skill-discovery-broker.js

@@ -24,7 +24,7 @@ export class WorkspaceSkillDiscoveryBroker {
             && operation.generation === state.config.generation && operation.runtimeEpoch === state.runtimeEpoch
             && ['dispatched', 'accepted'].includes(operation.status));
         const operation = operations.length === 1 ? operations[0] : undefined;
-        if (!valid() || context.refsBlocked || state.journal.destroyed() || !operation?.workspaceId || !operation.directoryName
+        if (!valid() || state.journal.destroyed() || !operation?.workspaceId || !operation.directoryName
             || operation.directoryName === 'root' || !operation.nativeThreadId || !operation.nativeTurnId
             || !session || session.threadId !== operation.nativeThreadId || session.activeTurnId !== operation.nativeTurnId
             || session.cwd !== context.cwd || session.workspaceId !== operation.workspaceId

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/cli",
-  "version": "0.1.81",
+  "version": "0.1.83",
   "private": false,
   "type": "module",
   "engines": {
@@ -57,8 +57,8 @@
     "@gltf-transform/core": "^4.3.0",
     "@gltf-transform/extensions": "^4.3.0",
     "@gltf-transform/functions": "^4.3.0",
-    "@playcraft/build": "0.1.81",
-    "@playcraft/common": "0.1.81",
+    "@playcraft/build": "0.1.83",
+    "@playcraft/common": "0.1.83",
     "better-sqlite3-pinned": "npm:better-sqlite3@13.0.3",
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",

package/project-template-v2/.playcraft/skills.lock.json

@@ -106,13 +106,6 @@
       "surface": "sandbox-agent",
       "mountPath": ".playcraft/skills/remix__playcraft-adsdk"
     },
-    {
-      "skillRef": "remix/playcraft-apk-replication",
-      "version": "1.1.0",
-      "artifactHash": "a7c16b036e4cbce07c5c03d1b4e98a4d42312e997a1ea0ad3ceb2d1e85ecebb9",
-      "surface": "sandbox-agent",
-      "mountPath": ".playcraft/skills/remix__playcraft-apk-replication"
-    },
     {
       "skillRef": "remix/playcraft-audio-generation",
       "version": "1.4.0",