@remixmate/cli 0.9.49 → 0.9.51

package/skills/template-registry/scripts/countdown_spec.py

@@ -29,10 +29,12 @@ The strategy carries the shape; the template carries every concrete value:
       "sceneStrategy": "countdown",
       "countdown": {
         "countProp": "topN",            // where the count goes in customPayload
-        "itemProp": "item",             // optional, default "item"
-        "indexProp": "rank",            // optional, default "rank"
+        "itemProp": "item",             // where one beat's item goes
+        "indexProp": "rank",            // the index field inside that item
         "legacyCountProps": ["totalItems"],
-        "openingSec": 2.5               // optional, default DEFAULT_OPENING_SEC
+        "openingSec": 2.5,              // optional, default DEFAULT_OPENING_SEC
+        "countPatterns": ["..."]        // optional: regexes that find a count stated
+                                        // in on-screen copy (group 1 = the number)
       }
     }
 
@@ -50,6 +52,8 @@ the count would fall back to "however many cards are present", and the
 
 from __future__ import annotations
 
+import re
+
 #: Opening budget when the template declares none. A generic "an opening is a
 #: beat, not a chapter" value — **not** any one template's measurement. It used
 #: to be 3 hardcoded in gen_script, taken from github-repo-rank's reference film
@@ -88,10 +92,23 @@ def resolve_countdown_spec(template: dict | None) -> dict | None:
         raise CountdownError(
             f"Template '{template_id}' declares capabilities.sceneStrategy=countdown but no "
             "capabilities.countdown.countProp. Declare which customPayload field carries the "
-            "item count (github-repo-rank uses \"topN\")."
+            "item count."
         )
     count_prop = count_prop.strip()
 
+    # itemProp / indexProp 同样必须声明：缺省值只能是某个具体模板的字段名，
+    # 那等于把那个模板写进 CLI。
+    names: dict[str, str] = {}
+    for key in ("itemProp", "indexProp"):
+        value = cfg.get(key)
+        if not isinstance(value, str) or not value.strip():
+            raise CountdownError(
+                f"Template '{template_id}' declares capabilities.sceneStrategy=countdown but no "
+                f"capabilities.countdown.{key}. Declare the customPayload field name — the CLI "
+                "does not guess one."
+            )
+        names[key] = value.strip()
+
     schema = (template or {}).get("customPayloadSchema")
     bounds = schema.get(count_prop) if isinstance(schema, dict) else None
     if not isinstance(bounds, dict):
@@ -119,6 +136,22 @@ def resolve_countdown_spec(template: dict | None) -> dict | None:
     legacy = cfg.get("legacyCountProps")
     legacy = [p for p in legacy if isinstance(p, str) and p.strip()] if isinstance(legacy, list) else []
 
+    patterns = []
+    for raw in cfg.get("countPatterns") or []:
+        try:
+            compiled = re.compile(raw, re.I) if isinstance(raw, str) else None
+        except re.error as exc:
+            raise CountdownError(
+                f"Template '{template_id}': countdown.countPatterns entry {raw!r} is not a valid "
+                f"regex ({exc})."
+            ) from None
+        if compiled is None or compiled.groups < 1:
+            raise CountdownError(
+                f"Template '{template_id}': countdown.countPatterns entry {raw!r} must be a regex "
+                "string with a capturing group for the number."
+            )
+        patterns.append(compiled)
+
     opening_sec = cfg.get("openingSec")
     if not (type(opening_sec) in (int, float) and opening_sec > 0):
         opening_sec = DEFAULT_OPENING_SEC
@@ -127,8 +160,9 @@ def resolve_countdown_spec(template: dict | None) -> dict | None:
         "template_id": template_id,
         "count_prop": count_prop,
         "legacy_count_props": legacy,
-        "item_prop": (cfg.get("itemProp") or "item").strip(),
-        "index_prop": (cfg.get("indexProp") or "rank").strip(),
+        "item_prop": names["itemProp"],
+        "index_prop": names["indexProp"],
+        "count_patterns": patterns,
         "minimum": minimum,
         "maximum": maximum,
         "default": default,
@@ -136,6 +170,22 @@ def resolve_countdown_spec(template: dict | None) -> dict | None:
     }
 
 
+def stated_counts(spec: dict, text: str) -> set[int]:
+    """Counts that on-screen copy states, found with the template's ``countPatterns``.
+
+    How a count is worded (``Top 5`` / ``前 5 名`` / ``5 个技巧``) is the
+    template's copy convention, so the patterns are declared there; a template
+    that declares none gets no check.
+    """
+    found: set[int] = set()
+    for pattern in spec.get("count_patterns") or []:
+        for match in pattern.finditer(text or ""):
+            for group in match.groups():
+                if group is not None and group.isdigit():
+                    found.add(int(group))
+    return found
+
+
 def resolve_count(spec: dict, requested: int | None, scene_count: int | None) -> int:
     """Validate a caller-supplied item count against the template's own bounds.
 

package/skills/template-registry/scripts/registry_loader.py

@@ -22,9 +22,8 @@
   鉴权：只读 PRIV_TOKEN 环境变量。凭证库 / 钥匙串 / 设备授权流由 CLI 的 Node 侧
   唯一鉴权入口负责（src/auth/ensure.ts），并在 spawn 时注入本进程环境。
 
-  monorepo / 显式本地文件等其它来源已**移除**。需要离线 / pinned 数据的维护脚本
-  （check_contracts.py / sync_registry.py）直接走 template_paths 读 monorepo，
-  那是 monorepo-only 工具，不是运行时数据源。
+  monorepo / 显式本地文件等其它来源已**移除**。模板仓库自己的维护工具住在
+  template-library，不经过本模块。
 
 P1.2 — list/detail split (待后端就绪)：
   100+ 模板时 ``GET /api/template/list`` 应该只返摘要（id / name / aspects /
@@ -379,7 +378,7 @@ def load_registry_indexed(
     """Return registry as ``{templateId: template_dict}``.
 
     Filters by the process-wide status gate unless ``include_all_statuses``
-    is set (used by maintenance tooling like ``check_contracts``). Templates
+    is set (e.g. render-video reading an already-chosen template). Templates
     missing ``status`` are treated as ``stable`` for backwards compatibility.
 
     ``ttl_seconds`` / ``http_timeout`` are accepted for API symmetry with

package/skills/template-registry/version.json

@@ -2,6 +2,6 @@
   "skillName": "template-registry",
   "repoName": "agent-skill-media-maker",
   "skillId": "475",
-  "version": "V22",
+  "version": "V23",
   "skillDescription": "Video-template registry skill. Stores every video-template definition and lists the available templates (templateId / name / aspect ratio / style tags).\n\nUse this skill as soon as the user mentions any of these intents:\n- View available templates / list every template\n\nNote: DSL→TemplateBinding is no longer a separate exposed step — once prepare_video_assets receives a template_id it builds the binding internally."
 }

package/skills/template-registry/video_dsl/README.md

@@ -9,27 +9,17 @@ video_dsl/
 ├── schema/                    # DSL Schema 定义
 │   ├── video-dsl-v1alpha1.json          # Video DSL JSON Schema
 │   ├── template-binding-v1alpha1.json    # 模板绑定 Schema
-│   ├── render-plan-v1alpha1.json         # RenderPlan Schema
-│   └── examples/                         # 各模板的 DSL + Binding 示例
-│       ├── ai-learning-tips.dsl.json
-│       ├── ai-learning-tips.binding.json
-│       ├── html-slide-demo.dsl.json
-│       └── ...
-├── runtime/                   # DSL 运行时工具
-│   ├── dsl_validator.py       # DSL Schema 校验
-│   ├── template_binder.py     # Scene → Slot 绑定（从 @ab-templates/metadata 读取模板）
-│   ├── timeline_compiler.py   # 时间线编译（帧号、字幕切片、旁白分段）
-│   ├── asset_adapter.py       # 素材适配器
-│   └── prompt_enhancer.py     # Prompt 增强
-└── library/                   # 可复用组件库（预留）
-    ├── blocks/                # 功能块（如 CTA、数字人、全屏背景）
-    ├── components/            # 基础组件（音频、文本、背景、装饰）
-    ├── scenes/                # 场景模板（开场钩子、知识点、绘本页）
-    └── videos/                # 完整视频模板（英文绘本等）
+│   └── render-plan-v1alpha1.json         # RenderPlan Schema
+└── runtime/                   # DSL 运行时工具（通用机制，不认识任何具体模板）
+    ├── dsl_validator.py       # DSL 校验（读模板声明做契约检查）
+    ├── payload_contract.py    # customPayload 必填字段检查
+    ├── timeline_compiler.py   # 时间线编译（帧号、字幕切片、旁白分段）
+    └── prompt_enhancer.py     # Prompt 增强
 ```
 
-> **注意**：模板元数据（template.json / registry.json）已迁移至独立的 `template-library` 仓库，
-> 通过 `@ab-templates/metadata` 包发布。`template_binder.py` 直接读取该包产出的 `registry.json`。
+> **注意**：模板元数据（template.json / registry.json）住在独立的 `template-library` 仓库，
+> 运行时经 ab-api 下发，由 `scripts/registry_loader.py` 读取；DSL → TemplateBinding 在 `scripts/match_template.py`。
+> 逐模板的契约与写法只在各自的 `template.json` 里，本目录不列模板、不带模板示例。
 
 ## 核心概念
 
@@ -51,46 +41,13 @@ video_dsl/
                    [render-video] → RenderPlan → MP4 / 剪映草稿
 ```
 
-## 模板列表
-
-| 模板 ID | 名称 | 适用场景 |
-|---------|------|----------|
-| `image-slide` | 图片幻灯片 | 通用知识分享、产品介绍（含 tech 科技风变体） |
-| `picture-book-en` | 英文绘本视频 | 儿童英语启蒙、双语绘本故事 |
-| `image-slideshow` | 图片轮播视频 | 知识分享、种草笔记、技巧总结 |
-| `knowledge-slides` | 知识幻灯片 | 方法论拆解、教程讲解、知识科普 |
-| `html-slide` | 知识看板 | 知识科普、概念讲解、白板风格内容 |
-
 ## runtime 模块说明
 
 | 模块 | 职责 | 被谁调用 |
 |------|------|----------|
 | `dsl_validator.py` | DSL JSON Schema 校验与参数标准化 | gen-script、render-video |
-| `template_binder.py` | 将 DSL scene 映射到模板 slot，生成 TemplateBinding（从 @ab-templates/metadata 读取模板定义） | template-registry |
 | `timeline_compiler.py` | 帧号计算、字幕切片（`split_subtitle`）、旁白分段（`segment_narration`） | render-video（跨 skill import） |
-| `asset_adapter.py` | 素材格式适配 | render-video |
+| `payload_contract.py` | customPayload 必填字段 / 计划素材检查 | dsl_validator、render-video |
 | `prompt_enhancer.py` | 图片 prompt 增强 | render-video |
 
 **注意**：`timeline_compiler.py` 被 `render-video/scripts/render_video.py` 直接 import，修改函数签名需两个 skill 同步测试。
-
-## library 组件库（预留）
-
-`library/` 目录采用四层分级设计，用于存放可复用的 DSL 片段：
-
-- **components/**：最小粒度的基础组件（音频、文本、背景、头像、装饰、媒体、叠加层）
-- **blocks/**：由多个 component 组合而成的功能块（CTA 按钮、数字人区域、全屏背景图、标题区、产品卡片、配音条、双语字幕）
-- **scenes/**：完整的场景模板（开场钩子、知识点讲解、绘本封面/内页/结尾、CTA 结尾、数字人口播）
-- **videos/**：完整的视频模板（英文绘本等）
-
-组件库当前为目录骨架，后续可填充具体的 JSON 片段供 Agent 和 gen_script.py 复用。
-
-## 示例文件
-
-`schema/examples/` 下包含各模板的完整 DSL + Binding 示例，是 Agent 生成 DSL 时的权威参考：
-
-- `ai-learning-tips.*` — image-slide 模板示例
-- `html-slide-demo.*` — html-slide 模板示例
-- `knowledge-slides-demo.*` — knowledge-slides 模板示例
-- `animal-friends-picturebook.*` — picture-book-en 模板示例
-
-Agent 在为指定模板生成 DSL 时，必须先读取对应示例，按模板原生要求生成。

package/skills/template-registry/video_dsl/runtime/__init__.py

@@ -6,6 +6,5 @@ and gen-script). Public modules:
 
     - timeline_compiler  : DSL → Remotion frame-axis timeline + subtitle splits
     - prompt_enhancer    : LLM image-prompt enrichment used by gen-script
-    - template_binder    : registry summary writer (sync_registry helper)
     - dsl_validator      : DSL validation (structural / integrity / full presets)
 """

package/skills/template-registry/video_dsl/runtime/dsl_validator.py

@@ -31,7 +31,7 @@ VALID_PURPOSES = {"opening", "intro", "point", "example", "explanation", "transi
 VALID_LAYOUTS = {"full-visual", "split-left-right", "split-top-bottom", "picture-in-picture", "text-overlay", "avatar-with-bg", "kenburns"}
 
 # 场景数上限的兜底值。叙事弧类模板的合理上界——20 段以上的短视频必然过碎。
-# "一页素材一个场景"的模板（ppt-to-video）场景数由源文件页数决定，应当用
+# "一页素材一个场景"的模板（capabilities.payloadHydration）场景数由源文件页数决定，应当用
 # ``capabilities.maxScenes`` 抬高；这个常量只是没声明时的默认。
 DEFAULT_MAX_SCENES = 20
 
@@ -61,21 +61,17 @@ def max_scenes_for_template(template_config: Optional[dict]) -> int:
 VALID_ASSET_TYPES = {"image", "video", "audio", "avatar", "subtitle", "bgm"}
 VALID_ASSET_SOURCES = {"existing", "gen-image", "gen-video", "gen-voice", "gen-digital-human"}
 
-# 由 Composition 消费、而非 slide 组件消费的字段。前八个与模板侧
-# utils/slidePayload.ts 的 FRAME_LEVEL_KEYS 同源 ——「整包态」binder 会把它们混进
-# templateData，出现在那里是正当的，不该被当成未声明字段。highlightMap 同理（模板
-# 一般在 slideSchemas._shared 里声明它，这里兜底没声明的情况）。
-_SLIDE_FRAME_LEVEL_KEYS = frozenset({
-    "slideId",
-    "titleText",
-    "subtitleText",
-    "watermarkText",
-    "narrationAssetId",
-    "narrationSrc",
-    "background",
-    "templateData",
-    "highlightMap",
-})
+def _frame_level_keys(tpl: dict) -> frozenset:
+    """模板声明的 frame 级字段（``capabilities.frameLevelKeys.keys``）。
+
+    这些字段由 Composition 消费、不属于任何 slide 载荷；「整包态」binder 会把它们
+    混进 templateData，出现在那里是正当的，不该被当成未声明字段。名单是模板的事实，
+    CLI 不保留副本 —— 没声明的模板就是空集。``highlightMap`` 这类跨版式字段走
+    ``slideSchemas._shared``，不在这里。
+    """
+    spec = (tpl.get("capabilities") or {}).get("frameLevelKeys")
+    keys = spec.get("keys") if isinstance(spec, dict) else None
+    return frozenset(k for k in keys if isinstance(k, str)) if isinstance(keys, list) else frozenset()
 
 # CJK 汉字范围（简繁通用）+ 常见中文标点
 _CJK_PATTERN = re.compile(r"[一-鿿㐀-䶿＀-￯　-〿]")
@@ -144,11 +140,32 @@ def _line_sync_slides_for_template(template_id: Optional[str]) -> dict[str, str]
     O(1) lookup via ``registry_loader.get_template``; safe to call once per
     scene at 100+ templates without scanning the full list.
     """
-    tpl = _get_template_cfg(template_id)
-    if not tpl:
-        return {}
-    spec = tpl.get("lineSyncSlides") or {}
-    return {k: v for k, v in spec.items() if isinstance(v, str)}
+    return line_sync_slides(_get_template_cfg(template_id))
+
+
+def line_sync_slides(tpl: Optional[dict]) -> dict[str, str]:
+    """模板的 ``lineSyncSlides`` 声明：slideId → templateData 里卡片数组的键。
+
+    校验层（narration.items 数对齐）与 render-video（自动 highlightMap 的上限裁剪）
+    读的是同一份声明，CLI 不保留任何卡片键表的副本。
+    """
+    spec = (tpl or {}).get("lineSyncSlides") or {}
+    return {k: v for k, v in spec.items() if not k.startswith("_") and isinstance(v, str)}
+
+
+def step_alignment_field(tpl: Optional[dict]) -> Optional[str]:
+    """模板 ``capabilities.stepAlignment`` 声明的动作数组字段；未声明返回 None。
+
+    只认 ``alignTo`` 缺省或 ``narration-sentences``（第 i 个动作 = 第 i 句旁白）。
+    """
+    caps = (tpl or {}).get("capabilities")
+    spec = caps.get("stepAlignment") if isinstance(caps, dict) else None
+    if not isinstance(spec, dict):
+        return None
+    if spec.get("alignTo") not in (None, "narration-sentences"):
+        return None
+    field = spec.get("payloadField")
+    return field if isinstance(field, str) and field else None
 
 
 def _get_template_cfg(template_id: Optional[str]) -> Optional[dict]:
@@ -280,7 +297,7 @@ def _check_scenes_max(dsl: dict) -> list[ValidationError]:
 
     上限由模板的 ``capabilities.maxScenes`` 声明,缺省 ``DEFAULT_MAX_SCENES``(20)。
     20 这个数字是给"叙事弧"类模板定的——一条 60 秒短视频排到 20 段已经过碎。但
-    "一页素材一个场景"的模板(ppt-to-video 逐页讲解)的场景数由源文件页数决定,
+    "一页素材一个场景"的模板(逐页讲解一份源文件)的场景数由源文件页数决定,
     跟叙事节奏无关:2026-09-23 线上一份 23 页 PPT 就是在这里被砍到 20 页,
     而且砍得毫无声响,直到下游报 ``customPayload.slide (required)`` ×20 才暴露。
     所以上限改成模板自己声明,并且这里的报错要说清它是谁定的。
@@ -576,8 +593,7 @@ def _check_slide_cross_field(dsl: dict) -> list[ValidationError]:
     schemas = tpl.get("slideSchemas")
     if not isinstance(schemas, dict):
         return []
-    line_sync = {k: v for k, v in (tpl.get("lineSyncSlides") or {}).items()
-                 if isinstance(v, str)}
+    line_sync = line_sync_slides(tpl)
 
     errors: list[ValidationError] = []
 
@@ -673,8 +689,7 @@ def _check_line_sync_narration(dsl: dict) -> list[ValidationError]:
     tpl = _get_template_cfg(_pick_template_id(dsl))
     if not tpl:
         return []
-    line_sync = {k: v for k, v in (tpl.get("lineSyncSlides") or {}).items()
-                 if isinstance(v, str)}
+    line_sync = line_sync_slides(tpl)
     if not line_sync:
         return []
     schemas = tpl.get("slideSchemas") if isinstance(tpl.get("slideSchemas"), dict) else {}
@@ -751,14 +766,8 @@ def _check_step_narration_alignment(dsl: dict) -> list[ValidationError]:
     tpl = _get_template_cfg(_pick_template_id(dsl))
     if not tpl:
         return []
-    caps = tpl.get("capabilities")
-    spec = caps.get("stepAlignment") if isinstance(caps, dict) else None
-    if not isinstance(spec, dict):
-        return []
-    field = spec.get("payloadField")
-    if not isinstance(field, str) or not field:
-        return []
-    if spec.get("alignTo") not in (None, "narration-sentences"):
+    field = step_alignment_field(tpl)
+    if not field:
         return []
 
     try:
@@ -877,7 +886,7 @@ def _check_slide_payload_fields(dsl: dict) -> list[ValidationError]:
             extra_allowed=shared,
             # frame 级字段由 Composition 消费,「整包态」binder 会把它们混进
             # templateData —— 出现在这里是正当的,不算未声明字段。
-            skip_keys=_SLIDE_FRAME_LEVEL_KEYS,
+            skip_keys=_frame_level_keys(tpl),
         )
 
     return errors

package/skills/template-registry/video_dsl/schema/video-dsl-v1alpha1.json

@@ -243,7 +243,7 @@
                 "items": {
                   "type": "array",
                   "items": { "type": "string" },
-                  "description": "每行一个卡片的叙述句。长度必须等于 templateData 里对应数组（concepts/pillars/eras/items）的长度"
+                  "description": "每行一个卡片的叙述句。长度必须等于 templateData 里对应数组的长度（数组键由模板的 lineSyncSlides[slideId] 声明）"
                 },
                 "outro": { "type": "string", "description": "可选：收尾句（此期间无卡片高亮）" },
                 "assetRef": { "type": "string", "description": "旁白音频 assetId" },

package/skills/template-registry/scripts/check_contracts.py

@@ -1,179 +0,0 @@
-#!/usr/bin/env python3
-"""Cross-module contract checker: template-library ↔ remotion-renderer.
-
-Verifies that every `compositionId` referenced from the @ab-templates/metadata
-registry.json is:
-  1. Registered in `<monorepo-root>/remotion-renderer/src/core/compositions/manifest.ts`
-  2. Mapped there to the SAME `templateId` as the template entry's
-     top-level `templateId` field
-
-Exit non-zero with a useful diff if the two sides disagree.
-
-Usage:
-    python3 scripts/check_contracts.py
-"""
-from __future__ import annotations
-
-import json
-import os
-import re
-import sys
-from typing import Iterator
-
-from template_paths import monorepo_registry_path, monorepo_root
-
-_REGISTRY_PATH = monorepo_registry_path()
-_MANIFEST_PATH = os.path.abspath(
-    os.path.join(
-        monorepo_root(),
-        "remotion-renderer",
-        "src",
-        "core",
-        "compositions",
-        "manifest.ts",
-    )
-)
-
-
-# Matches a single manifest row:
-#   SomeCompositionId: { component: Foo, templateId: "t-id", slot: "opening" },
-_MANIFEST_ROW_RE = re.compile(
-    r'^\s*(?P<cid>[A-Za-z0-9_]+)\s*:\s*\{\s*'
-    r'component\s*:\s*[A-Za-z0-9_]+\s*,\s*'
-    r'templateId\s*:\s*"(?P<tid>[^"]+)"\s*,\s*'
-    r'slot\s*:\s*"(?P<slot>[^"]+)"\s*\}\s*,?\s*$'
-)
-
-
-def parse_manifest(path: str) -> dict[str, dict[str, str]]:
-    """Parse manifest.ts and return {compositionId: {templateId, slot}}."""
-    if not os.path.isfile(path):
-        raise FileNotFoundError(f"manifest.ts not found at {path}")
-
-    with open(path, "r", encoding="utf-8") as f:
-        text = f.read()
-
-    start_marker = "// MANIFEST_ENTRIES:START"
-    end_marker = "// MANIFEST_ENTRIES:END"
-    start = text.find(start_marker)
-    end = text.find(end_marker)
-    if start == -1 or end == -1 or end < start:
-        raise ValueError(
-            f"manifest.ts is missing {start_marker} / {end_marker} markers"
-        )
-
-    block = text[start:end]
-    entries: dict[str, dict[str, str]] = {}
-    for line in block.splitlines():
-        m = _MANIFEST_ROW_RE.match(line)
-        if not m:
-            continue
-        entries[m.group("cid")] = {
-            "templateId": m.group("tid"),
-            "slot": m.group("slot"),
-        }
-
-    if not entries:
-        raise ValueError(
-            f"No manifest entries parsed from {path}. Did the format change?"
-        )
-    return entries
-
-
-def _iter_composition_ids(node: object) -> Iterator[str]:
-    """Walk an arbitrary JSON tree and yield every `compositionId` value."""
-    if isinstance(node, dict):
-        cid = node.get("compositionId")
-        if isinstance(cid, str):
-            yield cid
-        for v in node.values():
-            yield from _iter_composition_ids(v)
-    elif isinstance(node, list):
-        for v in node:
-            yield from _iter_composition_ids(v)
-
-
-def collect_template_references(registry_path: str) -> list[dict[str, str]]:
-    """Return a list of {templateId, compositionId, file} for every reference in the registry."""
-    refs: list[dict[str, str]] = []
-    if not os.path.isfile(registry_path):
-        print(f"WARN: registry.json not found at {registry_path}", file=sys.stderr)
-        return refs
-
-    with open(registry_path, "r", encoding="utf-8") as f:
-        data = json.load(f)
-
-    for tpl in data.get("templates", []):
-        tid = tpl.get("templateId")
-        if not tid:
-            continue
-        for cid in _iter_composition_ids(tpl):
-            refs.append({"templateId": tid, "compositionId": cid, "file": registry_path})
-    return refs
-
-
-def main() -> int:
-    try:
-        manifest = parse_manifest(_MANIFEST_PATH)
-    except (FileNotFoundError, ValueError) as e:
-        print(f"FAIL: {e}", file=sys.stderr)
-        return 2
-
-    refs = collect_template_references(_REGISTRY_PATH)
-
-    errors: list[str] = []
-    seen: set[str] = set()
-
-    for ref in refs:
-        cid = ref["compositionId"]
-        tid = ref["templateId"]
-        rel = os.path.relpath(ref["file"], monorepo_root())
-        seen.add(cid)
-
-        entry = manifest.get(cid)
-        if entry is None:
-            errors.append(
-                f"{rel}: compositionId '{cid}' is referenced but not in manifest.ts"
-            )
-            continue
-        if entry["templateId"] != tid:
-            errors.append(
-                f"{rel}: compositionId '{cid}' is registered under templateId "
-                f"'{entry['templateId']}' in manifest.ts, but template.json declares "
-                f"templateId '{tid}'"
-            )
-
-    # Warn (non-fatal) about manifest entries never referenced by any template.
-    unused = sorted(set(manifest.keys()) - seen)
-    for cid in unused:
-        print(
-            f"WARN: manifest.ts entry '{cid}' is not referenced by any "
-            f"template.json (templateId={manifest[cid]['templateId']})",
-            file=sys.stderr,
-        )
-
-    # 命名空间唯一性说明：compositionId 是否全库唯一，由 template-library 的
-    # generateManifest 在生成 manifest.ts 时保障（跨模板撞名直接抛
-    # DuplicateCompositionIdError、CI 失败）。manifest.ts 因此按构造即唯一，
-    # 本脚本读取的已是去重结果，无需再校验唯一性。
-    #
-    # （已移除早期 P1.1 的 `<templateId>/` 前缀 warning：权威 schema 的
-    # compositionId pattern 为 PascalCase `^[A-Z][A-Za-z0-9]*$`，本就禁止 `/`，
-    # 前缀建议与 schema 矛盾且非必需——唯一性已由上游硬保障。）
-
-    if errors:
-        print("FAIL: contract check found inconsistencies:", file=sys.stderr)
-        for e in errors:
-            print(f"  - {e}", file=sys.stderr)
-        return 1
-
-    print(
-        f"OK: {len(refs)} compositionId references across "
-        f"{len({r['templateId'] for r in refs})} templates match manifest.ts "
-        f"({len(manifest)} entries)."
-    )
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

package/skills/template-registry/scripts/sync_registry.py

@@ -1,44 +0,0 @@
-#!/usr/bin/env python3
-"""Write a local registry-cache.json from @ab-templates/metadata.
-
-Usage:
-    python3 scripts/sync_registry.py                    # write cache
-    python3 scripts/sync_registry.py --registry <path>  # use custom registry source
-
-The cache is a lightweight summary for LLM prompts and offline use.
-The authoritative source is template-library/packages/metadata/registry.json.
-"""
-from __future__ import annotations
-
-import argparse
-import sys
-import os
-
-# Make video_dsl.runtime importable regardless of CWD.
-_SKILL_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
-sys.path.insert(0, _SKILL_DIR)
-
-from video_dsl.runtime.template_binder import sync_registry  # noqa: E402
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
-    parser.add_argument(
-        "--registry",
-        default=None,
-        help="Path to @ab-templates/metadata registry.json (auto-detected if omitted)",
-    )
-    parser.add_argument(
-        "--output",
-        default=None,
-        help="Output path for the cache file (default: video_dsl/registry-cache.json)",
-    )
-    args = parser.parse_args()
-
-    out = sync_registry(output_path=args.output, registry_path=args.registry)
-    print(f"wrote {out}")
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())