cardbuddy 0.9.1 → 0.11.0

package/dist/vendored/skills/dsl-card-generator/scripts/derive_data_json.py

@@ -0,0 +1,81 @@
+#!/usr/bin/env python3
+"""
+Derive data.json from schema.json
+
+data.json must equal { inputParams[i].key: inputParams[i].defaultValue }.
+Objects/arrays are kept as-is (no deep re-serialization).
+
+Usage:
+    python3 derive_data_json.py <schema.json>            # print derived data.json to stdout
+    python3 derive_data_json.py <schema.json> --overwrite # write data.json next to schema.json
+    python3 derive_data_json.py <schema.json> --check     # compare with existing data.json
+"""
+
+import argparse
+import json
+import os
+import sys
+
+
+def derive(schema):
+    params = schema.get("dictionary", {}).get("inputParams", [])
+    return {p["key"]: p.get("defaultValue") for p in params if "key" in p}
+
+
+def main():
+    ap = argparse.ArgumentParser(description="Derive data.json from a card schema.json")
+    ap.add_argument("schema", help="path to schema.json")
+    ap.add_argument("--overwrite", action="store_true", help="write data.json next to schema.json")
+    ap.add_argument("--check", action="store_true", help="compare with existing data.json and report diffs")
+    args = ap.parse_args()
+
+    if not os.path.isfile(args.schema):
+        print(f"[ERROR] File not found: {args.schema}")
+        return 1
+
+    schema = json.load(open(args.schema, encoding="utf-8"))
+    data = derive(schema)
+
+    if args.check:
+        data_path = os.path.join(os.path.dirname(args.schema), "data.json")
+        if not os.path.isfile(data_path):
+            print(f"[WARN] No data.json beside schema; derived keys: {sorted(data.keys())}")
+            return 1
+        existing = json.load(open(data_path, encoding="utf-8"))
+        if set(data.keys()) != set(existing.keys()):
+            only_schema = sorted(set(data) - set(existing))
+            only_existing = sorted(set(existing) - set(data))
+            print(f"[DIFF] key sets differ")
+            if only_schema:
+                print(f"  missing in data.json: {only_schema}")
+            if only_existing:
+                print(f"  extra in data.json:   {only_existing}")
+            return 1
+        diffs = []
+        for k in data:
+            if k == "otherLangLabels":
+                continue  # tolerated i18n drift
+            if data[k] != existing.get(k):
+                diffs.append((k, data[k], existing.get(k)))
+        if diffs:
+            print(f"[DIFF] {len(diffs)} value mismatch(es):")
+            for k, exp, got in diffs:
+                print(f"  {k}: schema={exp!r} data={got!r}")
+            return 1
+        print(f"[OK] data.json matches inputParams.defaultValue ({len(data)} keys)")
+        return 0
+
+    if args.overwrite:
+        out_path = os.path.join(os.path.dirname(args.schema), "data.json")
+        with open(out_path, "w", encoding="utf-8") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+            f.write("\n")
+        print(f"[OK] Wrote {out_path} ({len(data)} keys)")
+        return 0
+
+    print(json.dumps(data, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.py

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+"""
+paths.py — skill 内部路径与宿主项目路径单一来源（Python 侧）。
+
+自包含约定：
+  - skill 自身的渲染器/元数据资源固定放在 <skill>/vendor/preview；
+  - 宿主项目（卡片与切图所在目录）默认是调用脚本时的 cwd，也可用环境变量覆盖；
+  - 不再向上查找 package.json，因此本 skill 可整体复制到任意项目使用。
+
+环境变量（按优先级覆盖默认值）：
+  DSL_CARD_PROJECT_ROOT  宿主项目根目录（默认 Path.cwd()）
+  DSL_CARD_CARDS_DIR     卡片目录（默认 <project>/src/cards）
+  DSL_CARD_SLICES_DIR    切图目录（默认 <project>/src/slices）
+  DSL_CARD_META_DIR      meta 元数据目录（默认 <skill>/vendor/preview/meta）
+  DSL_CARD_PREVIEW_DIR   自包含预览目录（默认 <skill>/vendor/preview）
+  DSL_CARD_BASELINES_DIR 渲染基线目录（默认 <project>/.card-baselines）
+"""
+import json
+import os
+from pathlib import Path
+
+_HERE = Path(__file__).resolve().parent
+
+# 占位 sentinel：与任何用户传入的 fallback 都不会相同的内部对象。
+_MISSING = object()
+
+# 当前 skill 根目录：scripts/lib -> scripts -> dsl-card-generator
+skill_root = _HERE.parent.parent
+
+# skill 自包含资源根目录。
+vendor_dir = skill_root / "vendor"
+
+# 独立卡片预览目录（vendor/preview）。
+preview_dir = Path(
+    os.environ.get("DSL_CARD_PREVIEW_DIR", str(vendor_dir / "preview"))
+).resolve()
+
+# meta 元数据目录。
+meta_dir = Path(
+    os.environ.get("DSL_CARD_META_DIR", str(preview_dir / "meta"))
+).resolve()
+
+# 宿主项目根目录（默认当前工作目录）。
+project_root = Path(
+    os.environ.get("DSL_CARD_PROJECT_ROOT", str(Path.cwd()))
+).resolve()
+
+# 卡片源数据目录。
+cards_dir = Path(
+    os.environ.get("DSL_CARD_CARDS_DIR", str(project_root / "src" / "cards"))
+).resolve()
+
+# 切图统一落点目录。
+slices_dir = Path(
+    os.environ.get("DSL_CARD_SLICES_DIR", str(project_root / "src" / "slices"))
+).resolve()
+
+# 渲染回归基线目录。
+baselines_dir = Path(
+    os.environ.get("DSL_CARD_BASELINES_DIR", str(project_root / ".card-baselines"))
+).resolve()
+
+# 兼容旧脚本的别名。
+repo_root = project_root
+
+# skills 父目录。
+skills_dir = skill_root.parent
+
+
+def card_dir(card_id: str) -> Path:
+    """解析卡片目录的绝对路径：`<cards_dir>/<id>`。"""
+    return cards_dir / card_id
+
+
+def card_schema_path(card_id: str) -> Path:
+    """解析卡片 schema.json 的绝对路径。"""
+    return cards_dir / card_id / "schema.json"
+
+
+def card_data_path(card_id: str) -> Path:
+    """解析卡片 data.json 的绝对路径。"""
+    return cards_dir / card_id / "data.json"
+
+
+def read_json(p: Path, fallback=_MISSING):
+    """
+    安全读取 JSON（不存在或解析失败时返回 fallback）。
+
+    Args:
+        p: 路径
+        fallback: 不存在/解析失败时的返回值。默认抛错。
+    Returns:
+        解析后的 Python 值
+    """
+    p = Path(p)
+    if not p.is_file():
+        if fallback is _MISSING:
+            raise FileNotFoundError(f"File not found: {p}")
+        return fallback
+    try:
+        return json.loads(p.read_text(encoding="utf-8"))
+    except Exception as e:
+        if fallback is _MISSING:
+            raise RuntimeError(f"Cannot parse JSON {p}: {e}") from e
+        return fallback