@mindscraft/branch-video-agent-cli 0.4.3 → 0.4.4

package/README.md

@@ -97,6 +97,8 @@ sidecar 使用 `branch-video-playtest/1`，Web 结果必须提供 iframe 内的
 CI 顺序为：V3 静态 self-test → 草稿 `playtest run` → 外部发布步骤 → `version get` 精确内容读回。发布内容与已测草稿一致时无需再跑发布版全量测试；内容变化后应重新测试。`playtest run` 自身始终只读，不承担发布。
 
 从 `0.4.3` 起，规划器删除被更长场景完整包含的有序前缀场景，保留条件、状态效果与全部目标边；场景数由实际图决定，不固定为 96。重复搜索状态也会合并以减少规划开销。覆盖或路径预算失败仍返回失败，不通过删边取得通过。复测时记录实际可执行文件路径；升级全局 npm 包不会更新任务内复制的旧 CLI。
+
+从 `0.4.4` 起，runner 在现有超时内等待“进入游戏”或“开始体验”入口；已开始播放时直接继续，后续节点和路由断言保持不变。
 
 AIHub 导入公共库示例：
 

package/dist/playtest/runner.d.ts

@@ -1,3 +1,4 @@
+import { type Frame } from 'playwright';
 import type { PlaytestContract, PlaytestLimits, PlaytestScenario, PlaytestScenarioResult } from './types.js';
 type ScriptRecord = Record<string, any>;
 interface RunnerOptions {
@@ -14,6 +15,7 @@ interface RunnerOptions {
         height: number;
     };
 }
+export declare function startPlayback(frame: Frame, entryNodeId: string, entryNodeType: string, timeout: number): Promise<void>;
 export declare function runPlaytestScenarios(options: RunnerOptions): Promise<PlaytestScenarioResult[]>;
 export declare function createDraftPlayerUrl(baseUrl: string): {
     playerUrl: string;

package/dist/playtest/runner.js

@@ -111,12 +111,24 @@ async function waitForNode(frame, nodeId, timeout) {
         throw new PlaytestError('ROUTE_TARGET_MISMATCH', `Expected node ${nodeId}, reached ${actual || 'none'}`, { expected: nodeId, actual });
     }
 }
-async function startPlayback(frame, entryNodeId, entryNodeType, timeout) {
-    const startButton = frame.getByRole('button', { name: '开始体验' });
-    if (await startButton.isVisible().catch(() => false))
-        await startButton.click();
-    await frame.locator('[data-bv-node-id]').first().waitFor({ state: 'visible', timeout });
-    const current = await frame.locator('[data-bv-node-id]').first().getAttribute('data-bv-node-id');
+export async function startPlayback(frame, entryNodeId, entryNodeType, timeout) {
+    const deadline = Date.now() + timeout;
+    const remaining = () => {
+        const value = deadline - Date.now();
+        if (value <= 0)
+            throw new PlaytestError('SCENARIO_TIMEOUT', 'Scenario timeout elapsed before entry playback completed');
+        return value;
+    };
+    const entryNode = frame.locator('[data-bv-node-id]').first();
+    if (!(await entryNode.isVisible().catch(() => false))) {
+        const startButton = frame.getByRole('button', { name: /^(开始体验|进入游戏)$/ }).first();
+        await startButton.or(entryNode).filter({ visible: true }).first().waitFor({ state: 'visible', timeout: remaining() });
+        if (!(await entryNode.isVisible().catch(() => false)) && await startButton.isVisible().catch(() => false)) {
+            await startButton.click({ timeout: remaining() });
+        }
+    }
+    await entryNode.waitFor({ state: 'visible', timeout: remaining() });
+    const current = await entryNode.getAttribute('data-bv-node-id');
     if (current !== entryNodeId) {
         const observed = await readObservedMessages(frame);
         const sawEntry = observed.some((message) => JSON.stringify(message.data).includes(entryNodeId));
@@ -480,6 +492,7 @@ async function runScenario(browser, scenario, options) {
         }));
     }
     let timeoutHandle;
+    const scenarioDeadline = Date.now() + options.limits.scenarioTimeoutMs;
     const scenarioTimeout = new Promise((_, reject) => {
         timeoutHandle = globalThis.setTimeout(() => reject(new PlaytestError('SCENARIO_TIMEOUT', `Scenario ${scenario.id} exceeded ${options.limits.scenarioTimeoutMs}ms`)), options.limits.scenarioTimeoutMs);
     });
@@ -490,7 +503,10 @@ async function runScenario(browser, scenario, options) {
                 const playerFrame = await waitForPlayerFrame(page, options.playerUrl, options.limits.scenarioTimeoutMs);
                 await assertPlayerProtocol(playerFrame, options.limits.scenarioTimeoutMs);
                 const entryNodeId = String(options.script.graph?.entryNodeId || '');
-                await startPlayback(playerFrame, entryNodeId, String(getNode(options.script, entryNodeId).type || ''), options.limits.scenarioTimeoutMs);
+                const entryTimeout = scenarioDeadline - Date.now();
+                if (entryTimeout <= 0)
+                    throw new PlaytestError('SCENARIO_TIMEOUT', `Scenario ${scenario.id} exceeded ${options.limits.scenarioTimeoutMs}ms`);
+                await startPlayback(playerFrame, entryNodeId, String(getNode(options.script, entryNodeId).type || ''), entryTimeout);
                 playerReady = true;
                 await assertNodeMedia(playerFrame, getNode(options.script, entryNodeId));
                 visitedNodes.push(String(options.script.graph?.entryNodeId || ''));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindscraft/branch-video-agent-cli",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Published CLI for branch-video and AIHub agent APIs.",
   "type": "module",
   "bin": {