@remixmate/cli 0.9.50 → 0.9.51

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())

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

@@ -1,72 +0,0 @@
-"""Centralized monorepo path resolution for template-library artifacts.
-
-Why this module exists
-----------------------
-Before this file landed, every caller that needed to reach into the
-monorepo's ``template-library/`` from inside ``apps/ab-skill/`` had to count
-``..`` segments by hand. The depth differs per call site:
-
-    skills/template-registry/scripts/registry_loader.py    → 5 × ".."
-    skills/template-registry/scripts/check_contracts.py    → 3 × ".."
-    skills/template-registry/video_dsl/runtime/template_binder → 6 × ".."
-    skills/gen-script/scripts/gen_script.py                → 5 × ".."
-    skills/render-video/scripts/render_video.py            → 4 × ".."
-
-Five copies, five chances for an off-by-one bug, and any future directory
-move silently breaks one site without touching the others. This module
-computes the monorepo root **once** from its own location and exposes
-helpers so callers no longer count.
-
-All sibling skills (including the ``list_templates.py`` CLI entry, via
-``registry_loader``) go through these helpers, so the monorepo-root
-computation lives in exactly one place.
-"""
-from __future__ import annotations
-
-import os
-from typing import Optional
-
-__all__ = ["monorepo_root", "monorepo_registry_path", "monorepo_template_src_dir"]
-
-# This file lives at:
-#   <repo>/apps/ab-skill/skills/template-registry/scripts/template_paths.py
-# So the monorepo root is 5 levels up.
-_HERE = os.path.dirname(os.path.abspath(__file__))
-_REPO_ROOT = os.path.normpath(os.path.join(_HERE, "..", "..", "..", "..", ".."))
-
-
-def monorepo_root() -> str:
-    """Absolute path to the ab-platform monorepo root.
-
-    Always returns a string; the caller is responsible for checking
-    ``os.path.isdir(...)`` if the root may genuinely be absent (e.g. when
-    the skill is consumed standalone via the npm package).
-    """
-    return _REPO_ROOT
-
-
-def monorepo_registry_path() -> str:
-    """Path to ``template-library/packages/metadata/registry.json``.
-
-    Always returns the computed path even when the file does not exist —
-    so callers can keep their existing ``os.path.exists(...)`` / try-load
-    branches unchanged. Mirrors the historical behavior of the 4 in-tree
-    helpers it replaces.
-    """
-    return os.path.join(_REPO_ROOT, "template-library", "packages", "metadata", "registry.json")
-
-
-def monorepo_template_src_dir(template_id: str) -> Optional[str]:
-    """Locate a template's source directory under ``template-library``.
-
-    Returns the absolute path **only when the directory exists**; returns
-    ``None`` for the standalone / npm-consumer case where there is no
-    monorepo to reach into. Matches ``gen_script._locate_template_dir``'s
-    historical contract (callers test the result for None).
-    """
-    if not template_id:
-        return None
-    tpl_dir = os.path.join(
-        _REPO_ROOT, "template-library", "packages", "templates", "src", template_id
-    )
-    return tpl_dir if os.path.isdir(tpl_dir) else None