@playcraft/cli 0.0.44 → 0.0.46

package/project-templates/threejs/game/index.ts

@@ -0,0 +1,76 @@
+import * as THREE from "three";
+import { GAME_CONFIG } from "./config/game-config.js";
+import {
+  publishPlayableRuntime,
+  type PlayablePhase,
+  type SceneManagerContract,
+} from "./contract/publish.js";
+
+/**
+ * Minimal Three.js playable stub — same harness contract as Phaser pack.
+ * Replace during ring 1 build when meta.engineDecision.adapter is threejs.
+ */
+
+export function startGame(parentId: string) {
+  const parent = document.getElementById(parentId);
+  if (!parent) {
+    throw new Error(`#${parentId} not found`);
+  }
+
+  const width = GAME_CONFIG.DESIGN_WIDTH;
+  const height = GAME_CONFIG.DESIGN_HEIGHT;
+
+  const renderer = new THREE.WebGLRenderer({ antialias: true, alpha: false });
+  renderer.setSize(width, height);
+  renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
+  parent.appendChild(renderer.domElement);
+
+  const scene = new THREE.Scene();
+  scene.background = new THREE.Color(0x2a1500);
+
+  const camera = new THREE.PerspectiveCamera(50, width / height, 0.1, 100);
+  camera.position.z = 10;
+
+  const sceneManager: SceneManagerContract = {
+    currentPhase: "HOOK" as PlayablePhase,
+    isGameOver: () => sceneManager.currentPhase === "ENDCARD",
+  };
+
+  const onDebugAutoPlay = () => {
+    sceneManager.currentPhase = "ENDCARD";
+  };
+
+  publishPlayableRuntime({
+    engine: "threejs",
+    engineHandle: renderer,
+    sceneManager,
+    onDebugAutoPlay,
+    getCanvas: () => renderer.domElement,
+    getCaptureFps: () => 60,
+  });
+
+  let frameId = 0;
+  let disposed = false;
+
+  const render = () => {
+    if (disposed) return;
+    renderer.render(scene, camera);
+    frameId = requestAnimationFrame(render);
+  };
+  render();
+
+  return {
+    renderer,
+    destroy(removeCanvas = true) {
+      disposed = true;
+      cancelAnimationFrame(frameId);
+      renderer.dispose();
+      if (removeCanvas && renderer.domElement.parentElement) {
+        renderer.domElement.parentElement.removeChild(renderer.domElement);
+      }
+      if (window.__playable?.engineHandle === renderer) {
+        delete window.__playable;
+      }
+    },
+  };
+}

package/project-templates/threejs/game/runtime-contract.ts

@@ -0,0 +1,15 @@
+/** Re-export neutral contract for imports that expect runtime-contract.ts */
+export type {
+  PlayablePhase,
+  PlayableRuntimeContract,
+  SceneManagerContract,
+} from "./contract/types.js";
+
+export {
+  publishPlayableRuntime,
+  assertPlayableSceneContract,
+  mountDebugClearButton,
+  removeDebugClearButton,
+  isDebugMode,
+  DEBUG_CLEAR_BUTTON_ID,
+} from "./contract/publish.js";

package/project-templates/threejs/globals.d.ts

@@ -0,0 +1,51 @@
+declare module "*.png" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.webp" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.jpg" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.jpeg" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.svg" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.gif" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.mp3" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.ogg" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.wav" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.m4a" {
+  const src: string;
+  export default src;
+}
+
+declare const __DEV__: boolean;

package/project-templates/threejs/index.css

@@ -0,0 +1,34 @@
+*,
+*::before,
+*::after {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+  -webkit-tap-highlight-color: transparent;
+}
+
+html,
+body {
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  background: #000;
+  -webkit-user-select: none;
+  user-select: none;
+  -webkit-touch-callout: none;
+  overscroll-behavior: none;
+  touch-action: none;
+}
+
+#game-container {
+  width: 100%;
+  height: 100%;
+  padding-top: env(safe-area-inset-top);
+  padding-right: env(safe-area-inset-right);
+  padding-bottom: env(safe-area-inset-bottom);
+  padding-left: env(safe-area-inset-left);
+}
+
+canvas {
+  display: block;
+}

package/project-templates/threejs/index.html

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover"
+    />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
+    <meta name="format-detection" content="telephone=no" />
+    <title>PlayCraft Playable</title>
+  </head>
+  <body>
+    <div id="game-container"></div>
+    <script type="module" src="/main.ts"></script>
+  </body>
+</html>

package/project-templates/threejs/main.ts

@@ -0,0 +1,9 @@
+import "./index.css";
+import { startGame } from "./game/index";
+
+let game = startGame("game-container");
+
+window.addEventListener("resize", () => {
+  game.destroy?.(true);
+  game = startGame("game-container");
+});

package/project-templates/threejs/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "playcraft-game",
+  "version": "0.1.0",
+  "playcraftTemplateVersion": "0.3.2-alpha.0",
+  "description": "PlayCraft Playable Ads project",
+  "private": true,
+  "scripts": {
+    "dev": "vite",
+    "dev:start": "node skills/_shared/scripts/dev-start.mjs --root=.",
+    "dev:stop": "node skills/_shared/scripts/dev-start.mjs --root=. --stop",
+    "build": "vite build && npm run verify:build",
+    "build:raw": "vite build",
+    "verify:build": "node skills/playable-record/scripts/verify-build.mjs --root=.",
+    "preview": "vite preview",
+    "ensure:project": "node skills/_shared/scripts/ensure-project.mjs --root=.",
+    "ring:gate": "node skills/../.claude/hooks/gate-runner.mjs",
+    "workflow:doctor": "node skills/_shared/scripts/workflow-doctor.mjs --root=.",
+    "workflow:doctor:strict": "node skills/_shared/scripts/workflow-doctor.mjs --root=. --strict",
+    "state:set": "node skills/_shared/scripts/state-set.mjs --root=.",
+    "state:get": "node skills/_shared/scripts/state-get.mjs --root=.",
+    "state:advance-ring": "node skills/_shared/scripts/state-advance-ring.mjs --root=.",
+    "slice:set": "node skills/_shared/scripts/slice-set.mjs --root=.",
+    "verify:slice": "node skills/playable-record/scripts/verify-slice.mjs --root=. --use-dev",
+    "verify:slice-artist": "node skills/playable-record/scripts/verify-slice-artist.mjs --root=.",
+    "verify:slice-ta": "node skills/playable-record/scripts/verify-slice-ta.mjs --root=.",
+    "harness:smoke": "node skills/_shared/scripts/harness-smoke.mjs --root=.",
+    "context:budget": "node skills/_shared/scripts/context-budget.mjs --root=.",
+    "verify:env": "node skills/_shared/scripts/verify-env.mjs --root=.",
+    "skills:check": "node skills/_shared/scripts/skills-check.mjs --root=.",
+    "verify:ui": "python3 skills/playable-verify-ui/scripts/run_all.py",
+    "verify:ui:assets": "python3 skills/playable-verify-ui/scripts/run_all.py --only assets",
+    "verify:ui:layout": "python3 skills/playable-verify-ui/scripts/run_all.py --only layout",
+    "record:mp4": "node skills/playable-record/scripts/record-playable.mjs --root=. --use-dev",
+    "record:focus": "node skills/playable-record/scripts/record-playable.mjs --root=. --use-dev --focus",
+    "typecheck": "tsc --noEmit",
+    "verify:contract": "node skills/playable-record/scripts/verify-contract.mjs --root=. --use-dev",
+    "verify:lifecycle": "node skills/playable-record/scripts/verify-lifecycle.mjs --root=. --use-dev",
+    "verify:firstwin": "node skills/playable-record/scripts/verify-firstwin.mjs --root=. --use-dev",
+    "playground": "node skills/playable-focus/scripts/playground.mjs --root=.",
+    "sweep:L1": "node skills/playable-focus/scripts/playground.mjs --root=. sweep L1",
+    "sweep:G1": "node skills/playable-focus/scripts/playground.mjs --root=. sweep G1",
+    "repack:frames": "python3 skills/playable-fx-peak/scripts/repack-frame-sequence.py",
+    "mark:slices": "python3 skills/playable-art/scripts/import-gpt-art-sheets-v2.py --mark-only",
+    "import:gpt-art": "python3 skills/playable-art/scripts/import-gpt-art-sheets-v2.py",
+    "review:assets": "python3 skills/playable-art/scripts/review-processed-assets.py --root=.",
+    "verify:asset-review": "python3 skills/playable-art/scripts/review-processed-assets.py --root=. --strict --json",
+    "verify:slice-plan": "python3 skills/playable-verify-ui/scripts/verify_slice_plan.py --root=.",
+    "build-atlas": "python3 skills/playable-art/scripts/build-atlas.py",
+    "record:mp4:install": "playwright install chromium",
+    "bootstrap:playground": "node skills/playable-focus/scripts/bootstrap-playground.mjs --root=.",
+    "validate:frame-anchors": "python3 skills/playable-fx-peak/scripts/validate-frame-anchors.py",
+    "placeholder:gen": "python3 skills/_shared/scripts/gen-placeholder.py",
+    "placeholder:pack-sheet": "node skills/_shared/scripts/placeholder-pack-sheet.mjs --root=.",
+    "placeholder:gen-audio": "python3 skills/_shared/scripts/gen-placeholder-audio.py",
+    "verify:placeholders": "node skills/_shared/scripts/verify-placeholders.mjs --root=.",
+    "verify:fusion": "node skills/playable-record/scripts/verify-fusion.mjs --root=. --use-dev",
+    "verify:visual-ring1": "node skills/playable-record/scripts/verify-visual-ring1.mjs --root=. --use-dev",
+    "verify:visual-ring2": "node skills/playable-record/scripts/verify-visual-ring.mjs --root=. --ring=2 --use-dev",
+    "verify:visual-ring3": "node skills/playable-record/scripts/verify-visual-ring.mjs --root=. --ring=3 --use-dev",
+    "verify:vlm-video": "node skills/playable-record/scripts/verify-vlm-video.mjs --root=.",
+    "verify:visual": "python3 skills/playable-verify-ui/scripts/verify_visual.py --root=.",
+    "verify:bg-clean": "python3 skills/playable-verify-ui/scripts/verify_bg_clean.py --root=.",
+    "verify:tile-consistency": "python3 skills/playable-verify-ui/scripts/verify_tile_consistency.py --root=.",
+    "verify:text-overlap": "python3 skills/playable-verify-ui/scripts/verify_text_overlap.py --root=.",
+    "verify:vision": "python3 skills/playable-verify-ui/scripts/verify_vision_evidence.py --root=.",
+    "verify:asset-code-sync": "node skills/_shared/scripts/verify-asset-code-sync.mjs --root=.",
+    "verify:atom-conformance": "node skills/_shared/scripts/verify-atom-conformance.mjs --project=."
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.19.8",
+    "playwright": "^1.59.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.1.3"
+  }
+}

package/project-templates/threejs/skills/README.md

@@ -0,0 +1,52 @@
+# Template Skills — 九步核心集（短名）
+
+## 命名（新 → 旧，口语仍可用）
+
+| 新目录名                  | 旧名                            | 用户可说                       |
+| ------------------------- | ------------------------------- | ------------------------------ |
+| **playable-validate**     | playable-video-validate-loop    | video validate loop / 整片优化 |
+| **playable-verify-ui**    | playable-ui-optimization        | ui optimization / 检查 UI      |
+| **playable-record**       | playable-record-playback        | 录屏                           |
+| **playable-debug**        | playable-debug-playback         | 一键通关                       |
+| **playable-art**          | playable-gpt-art-pipeline       | gpt art / 换美术               |
+| **playable-fx-peak**      | playable-frame-fx-peak-pipeline | peak pipeline / 帧光效         |
+| **playable-fx-decompose** | playable-decompose-fx           | decompose / 碎裂               |
+| **playable-animate**      | playable-animation-polish       | 动效手感                       |
+| **playable-focus**        | playable-focus-playground       | L→G / focus lab                |
+
+## 已删除 skill → 内容并入哪里
+
+| 已删                             | 并入                                                                          |
+| -------------------------------- | ----------------------------------------------------------------------------- |
+| playable-ui-regression-checklist | `playable-validate/validation-rules.md` §⑥ + `references/checklist-detail.md` |
+| playable-gpt-fx-frame-animation  | `playable-fx-peak` § GPT 出图与 A/B                                           |
+| playable-ui-reference-matching   | `playable-art` § Reference Matching                                           |
+| playable-frame-text-layout       | `playable-verify-ui` § Frame+Text + `measure_frame_content.py`                |
+| playable-performance-interaction | `playable-animate` § Performance + references                                 |
+| playable-single-html-bundle      | `playable-validate/references/single-html-bundle.md`                          |
+
+## Skill 索引
+
+| 用户意图                    | Skill                                                     | 角色                            |
+| --------------------------- | --------------------------------------------------------- | ------------------------------- |
+| Develop 占位资产            | [playable-placeholder](./playable-placeholder/SKILL.md)   | **Developer** (rings 1–3 build) |
+| 整片 / 当前页面（**默认**） | [playable-validate](./playable-validate/SKILL.md)         | TA / Reviewer                   |
+| 静态素材 / layout           | [playable-verify-ui](./playable-verify-ui/SKILL.md)       |
+| 录屏                        | [playable-record](./playable-record/SKILL.md)             |
+| 一键通关                    | [playable-debug](./playable-debug/SKILL.md)               |
+| GPT 美术                    | [playable-art](./playable-art/SKILL.md)                   |
+| 帧 ADD / repack             | [playable-fx-peak](./playable-fx-peak/SKILL.md)           |
+| 破碎                        | [playable-fx-decompose](./playable-fx-decompose/SKILL.md) |
+| 动效 / 卡顿                 | [playable-animate](./playable-animate/SKILL.md)           |
+| L→G                         | [playable-focus](./playable-focus/SKILL.md)               |
+
+Agent 起手：[\_shared/agent-prep.md](./_shared/agent-prep.md) → `npm run ensure:project`
+
+## 同步与漂移治理
+
+- **`skills/` 下的本地 playable skill 唯一同步源**：`node skills/_shared/scripts/sync-template-skills.mjs`。
+  不要手动逐文件复制或从其它路径拉取；任何对这九个 skill 的更新都应回到 monorepo 源、经此脚本同步，避免多源漂移。
+- **`.claude/skills/` 下的平台 skill 影子副本**：模板对少数平台 skill（`playcraft-image-generation`、
+  `playcraft-audio-generation`、`playcraft-sprite-generation`）保留静态副本并优先于 `@playcraft/skills` 包版本。
+  这是有意 fork——用 `npm run skills:check` 检测它们是否已与包版本漂移（`--strict` 在漂移时非零退出），
+  确保 fork 是"刻意保留"而非"忘记更新"。

package/project-templates/threejs/skills/_shared/agent-prep.md

@@ -0,0 +1,136 @@
+# Agent 自举协议（用户不跑命令）
+
+> **用户怎么说**：「用 `playable-xxx` 技能优化当前 playable / 当前页面」  
+> **Agent 怎么做**：先读本文件完成 **Phase 0 自举**，再读目标 skill 的 **Agent 入口**，全程 **Agent 自己执行 shell**，不要把命令列表丢给用户。
+
+---
+
+## Phase 0 — create 后默认已完成
+
+`playcraft create` 会自动执行 `ensure-project --no-install`，新项目创建后已经具备 `docs/project-state.md`、`logs/`、`workflow:doctor` 等工作流骨架。
+
+Agent 每次开始时优先执行：
+
+```bash
+npm run workflow:doctor
+```
+
+只有当 doctor 提示缺 workflow 文件、项目是旧模板、或用户是在现有目录手动接入 playable pipeline 时，才在 **playable 工程根**（含 `index.html` 或 `game/index.html` 与 `skills/` 的目录）执行：
+
+```bash
+npm run ensure:project -- --no-install
+```
+
+或：
+
+```bash
+node skills/_shared/scripts/ensure-project.mjs --root=. --no-install
+```
+
+（monorepo 里 `testN/` 若 skills 在同级 `../skills/`，ensure-project 会自动写对路径。）
+
+脚本会自动（缺什么补什么）：
+
+| 检查                       | 动作                                   |
+| -------------------------- | -------------------------------------- |
+| `playable.ui.profile.yaml` | 从 skill 模板复制                      |
+| `playground/registry.json` | bootstrap focus-lab + catalog          |
+| `focus-lab/` harness       | bootstrap（不覆盖已有）                |
+| `package.json` scripts     | 合并指向 `skills/` 的标准 npm 脚本     |
+| `node_modules`             | 无则 `npm install`                     |
+| Playwright Chromium        | 无则 `npx playwright install chromium` |
+| `recordings/`              | 创建目录                               |
+
+输出 JSON：`projectRoot`、`skillsRoot`、`relSkills`、`ready`、`warnings`。
+
+**`ready: false` 时**：Agent 修 blocker（缺 game、缺 skills）后再跑 ensure；**不要**让用户手工 bootstrap。
+
+---
+
+## Phase 0.5 — 定位「当前页面 / 优化目标」
+
+用户说「当前页面」时，Agent 推断 **Focus Zone**（不要问用户要命令）：
+
+| 用户意图关键词               | Zone          | 优先 skill                               | L 步 playground id              |
+| ---------------------------- | ------------- | ---------------------------------------- | ------------------------------- |
+| 整片 / 录屏 / 交付           | FLOW          | `playable-validate`                      | `flow:full`                     |
+| ENDCARD / 结算 / CTA         | PHASE:endcard | loop + animation                         | `integration:PHASE:endcard-win` |
+| 消牌 / 碎裂 / match          | EVENT:match   | `playable-fx-decompose` + peak           | `integration:EVENT:match-once`  |
+| 帧动画 / burst / ring / ray  | FX:frame      | `playable-fx-peak`                       | `clean:frame:<spec>`            |
+| 粒子 / 破碎素材              | FX:particle   | `playable-fx-decompose`                  | `clean:particle:<spec>`         |
+| 美术 / atlas / 正式 GPT 美术 | ART           | `playable-art`                           | —                               |
+| 占位图 / 占位音频 / 补齐合约 | PLACEHOLDER   | `playable-placeholder`                   | —                               |
+| UI 布局 / HUD                | UI            | `playable-verify-ui`                     | verify:ui                       |
+| 卡顿 / 点不动                | PERF          | `playable-validate` + `playable-animate` | 录屏 + verify:ui                |
+
+不确定时：**先 `flow:full` 录屏 → validate → 再收窄到 L 步**。
+
+---
+
+## Phase 1 — 调用目标 skill
+
+读取 `skills/<skill-name>/SKILL.md` 的 **Agent 入口** 节，按九步子集执行。
+
+通用 Gate（详见 [validation-rules.md](../playable-validate/validation-rules.md)）：
+
+```
+改代码/素材 → workflow:doctor（状态异常时再 ensure-project）
+           → verify:ui（改 manifest/PNG 后）
+           → 一键通关可达（⑤）
+           → 录屏 / playground record（⑥⑧）
+           → 写 validate 报告（⑨）
+```
+
+---
+
+## Phase 2 — 交付给用户什么
+
+用户只需要看到：
+
+1. **结论**：通过 / 有条件通过 / 未通过
+2. **证据**：最新 MP4 或 focus 录屏路径
+3. **相对上一版**：改善 / 仍存 / 回归（1–3 条）
+4. **报告**：`validate/PLAYABLE-*.md` 或 focus 报告路径
+
+不要贴长串 shell 命令 unless 用户明确要求看命令。
+
+---
+
+## 标准 npm 脚本（ensure-project 会合并）
+
+自包含 starter（`skills/` 在项目内）示例：
+
+```json
+{
+  "verify:ui": "python3 skills/playable-verify-ui/scripts/run_all.py",
+  "ensure:project": "node skills/_shared/scripts/ensure-project.mjs --root=.",
+  "record:mp4": "node skills/playable-record/scripts/record-playable.mjs --root=.",
+  "playground": "node skills/playable-focus/scripts/playground.mjs --root=."
+}
+```
+
+Agent 优先 `npm run <script>`；无 script 时用 `node skills/...` 或 ensure 输出的 `relSkills` 路径。
+
+---
+
+## 目录约定
+
+**自包含 starter（推荐分发）**
+
+```
+my-playable/
+├── Agent.md
+├── skills/              ← 工具链（template 已内置）
+├── game/index.html
+└── package.json
+```
+
+**monorepo（本仓库 testN/）**
+
+```
+workspace/
+├── skills/              ← 共享工具链
+└── testN/               ← 工程根，scripts 指向 ../skills/
+```
+
+在 Cursor 中应打开 **工程根**（含 `Agent.md` 与 `game/` 的那一层）。

package/project-templates/threejs/skills/_shared/requirements.txt

@@ -0,0 +1 @@
+Pillow>=10.0

package/project-templates/threejs/skills/_shared/scripts/build-evidence-gate.mjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+/**
+ * Knife 12C — ring:gate build/VLM evidence aggregation (read artifacts only).
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { isSliceResolved, normalizeSliceState } from './state-store.mjs';
+import { readBuildArtifact, validateBuildArtifactForSlice } from '../../playable-record/scripts/lib/build-artifact.mjs';
+
+/**
+ * When sliceState is non-empty, ring gate aggregates per-slice build artifacts
+ * instead of re-running verify:* scripts (unless PLAYCRAFT_GATE_RERUN=1).
+ */
+export function evaluateBuildEvidenceForRingGate(projectDir, iteration, sliceState) {
+  const ss = normalizeSliceState(sliceState || {});
+  if (!ss.slices.length) {
+    return {
+      applicable: false,
+      ok: true,
+      blockingIssues: [],
+      routeTo: 'none',
+      nextAction: 'No slice queue — build evidence gate N/A',
+      summary: null,
+    };
+  }
+
+  const blockingIssues = [];
+  const devSlices = ss.slices.filter((s) => s.role === 'developer');
+
+  for (const slice of devSlices) {
+    if (!isSliceResolved(slice)) {
+      blockingIssues.push(`developer slice "${slice.sliceId}" is ${slice.status} — queue not terminal`);
+      continue;
+    }
+    if (slice.status === 'verified') {
+      blockingIssues.push(...validateBuildArtifactForSlice(projectDir, slice));
+    }
+  }
+
+  const vlmSlices = devSlices.filter((s) => s.evidenceTier === 'video-vlm');
+  if (vlmSlices.length > 0) {
+    const verifiedVlm = vlmSlices.filter((s) => s.status === 'verified');
+    if (verifiedVlm.length === 0) {
+      blockingIssues.push(
+        `Ring ${iteration} requires at least one verified video-vlm spine/periphery slice with build + MP4 + VLM evidence`,
+      );
+    }
+  }
+
+  const ring = Math.min(Math.max(Number(iteration) || 1, 1), 4);
+  const vlmPath = path.join(projectDir, `validate/ring${ring}/vlm-video.json`);
+  if (fs.existsSync(vlmPath)) {
+    try {
+      const vlm = JSON.parse(fs.readFileSync(vlmPath, 'utf8'));
+      const failed = (vlm.findings || []).filter((f) => f.status === 'fail' || f.severity === 'P0');
+      if (vlm.ok === false || failed.length > 0) {
+        blockingIssues.push(
+          `validate/ring${ring}/vlm-video.json has ${failed.length} failing finding(s)`,
+        );
+      }
+    } catch {
+      blockingIssues.push(`validate/ring${ring}/vlm-video.json is invalid JSON`);
+    }
+  }
+
+  const firstPending = devSlices.find((s) => s.status === 'pending' || s.status === 'in_progress');
+  return {
+    applicable: true,
+    ok: blockingIssues.length === 0,
+    blockingIssues,
+    routeTo: firstPending?.role || 'developer',
+    nextAction: blockingIssues.length
+      ? `Fix build/VLM evidence: ${blockingIssues[0]}`
+      : 'Build evidence aggregation passed',
+    summary: {
+      devSlices: devSlices.length,
+      verified: devSlices.filter((s) => s.status === 'verified').length,
+      videoVlm: vlmSlices.length,
+    },
+  };
+}
+
+export function shouldAggregateGateEvidence(sliceState) {
+  if (process.env.PLAYCRAFT_GATE_RERUN === '1') return false;
+  const ss = normalizeSliceState(sliceState || {});
+  return ss.slices.length > 0;
+}