realtimex-deeptutor 0.5.0.post2__py3-none-any.whl → 0.5.0.post3__py3-none-any.whl

{realtimex_deeptutor-0.5.0.post2.dist-info → realtimex_deeptutor-0.5.0.post3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: realtimex-deeptutor
-Version: 0.5.0.post2
+Version: 0.5.0.post3
 Summary: RealTimeX DeepTutor - Intelligent learning companion with multi-agent collaboration and LightRAG
 License: Apache-2.0
 Requires-Python: >=3.10

{realtimex_deeptutor-0.5.0.post2.dist-info → realtimex_deeptutor-0.5.0.post3.dist-info}/RECORD

@@ -1,5 +1,14 @@
 realtimex_deeptutor/__init__.py,sha256=sSfuCLjJa6BnayszcU4azNl_sr1OzuKgLP10BAtdoh8,1567
-realtimex_deeptutor-0.5.0.post2.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+realtimex_deeptutor-0.5.0.post3.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+scripts/__init__.py,sha256=mxMsCbci-Qon3qWU1JIi93-tYlHAy0NIUbDRmAPVcg0,54
+scripts/audit_prompts.py,sha256=Ltuk7tvsjpKhiobVbYq1volgVFKiVLgSTaE_Is4MGaM,5651
+scripts/check_install.py,sha256=GbApEcDLJ6r0QmYrCVHAFCOK4wolpSLwL3eBRmmD3og,13929
+scripts/generate_roster.py,sha256=COsJ12bvZ5W9TI-wAvKpknKBgHr9uQTvJ_JCz2gVMVo,12369
+scripts/install_all.py,sha256=u-A3eLhk1ua_KCjz8WZMkrVNJN6QdYs7NhGOcsm-Mks,23875
+scripts/migrate_kb.py,sha256=uyJgplkJag35rT2RrwSiT37__gpB4TiA0xh5uVcWIa4,19667
+scripts/start.py,sha256=EYbyjryor0DN_WcxQMSkKWCboM9UjMkv61fWhLyv63I,30300
+scripts/start_web.py,sha256=vzn7TiW7g2RNpAKYPQjHVNtOt6G9MxokEnZE_YWfHu4,22980
+scripts/sync_prompts_from_en.py,sha256=TkBSFilYSwnwo0a3cgRnJ84i02zByAIW12N3ePzBwE8,4677
 src/__init__.py,sha256=UNw3C20mbskiQF3rK3HhjglrG8snhfuiVthc5UsoHX0,1046
 src/agents/__init__.py,sha256=IPhP4RZnCH2kcUDBkdKHO_ciVdyWnuHUCG2flG5Ydcw,885
 src/agents/base_agent.py,sha256=9mntPOWGN9RRlqfy4MBm52TVEZCGBq-uP_zsvoJHbHo,22930
@@ -141,7 +150,7 @@ src/api/utils/notebook_manager.py,sha256=4zTn_J10BmWlCaCJo3bcNWiWUGgLw4hGR92sfj3
 src/api/utils/progress_broadcaster.py,sha256=u1cfxZ2Rek9tSP9sP1hdQMQkh6Dr_6fhzJjBUvFf-3I,2772
 src/api/utils/task_id_manager.py,sha256=E59dJ2rg-_qY7uACNT3Nmzey0fnpZgfMYerW-8QsaNM,3687
 src/cli/__init__.py,sha256=MQ18rJWUlLlk_keWk7lrCjOYW5c_kDfJr5roKDu5ZT8,269
-src/cli/start.py,sha256=Tr0Vyk7JzhLsZqkUpt20pSpb8laumHzPDuFVbNvk8iU,6600
+src/cli/start.py,sha256=KNQ4ulAB4QCcS39Z5TcYWw4UtTzfEFCJg_yZOtg-Brw,6664
 src/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/config/accessors.py,sha256=A06OaUK78MdgLu__6MRcKcVoog1ctDj5fHP4APOyRiI,534
 src/config/constants.py,sha256=C3370U6qkFExKkoNyDDLcf05FIJU0_5MHvpT6mvDQ7A,734
@@ -175,7 +184,7 @@ src/services/__init__.py,sha256=91ZEKiPyPtwFgYRtmkKBrdYAZKVnREUw43itPM5n-WM,1851
 src/services/config/__init__.py,sha256=Vjt0TORUt358yZvNCgoIVnuWJWVPuYiNA6ge9DV-Dyo,1792
 src/services/config/knowledge_base_config.py,sha256=l6QlAivVCBf1Q23YaEkHIHvq3TmsowPJmjDASezBf8c,7266
 src/services/config/loader.py,sha256=1PXImuGe8RpJ8UQpyGcsRhkq_YL9kWJq2f1ylQE4N3Y,8068
-src/services/config/unified_config.py,sha256=zflsAU_XiHNBbVe4uaQX1k1UqVUsGJyMNL8fnir5Hss,32370
+src/services/config/unified_config.py,sha256=3sPs06oU0j6BjPZObh5Zoc1eLDusa1qa8HPGU9rncdY,32338
 src/services/embedding/__init__.py,sha256=ljDq50as6CkKNHK2sSQtX_iXu9TyOMhzzFNs2f7QYKs,1338
 src/services/embedding/client.py,sha256=X5iUbGuXjtk_6Nkl7N4eRXjbL5hPY46JcTfi65UZWus,6003
 src/services/embedding/config.py,sha256=vBJjsTcYLsIpy0bmR7V8etu8eAXdRShjQIYIMcqwIgU,5368
@@ -280,8 +289,8 @@ src/utils/error_utils.py,sha256=ME_9q-DlmxFl-Xvv3ETPZE_iP705x6MXiuAREgWYsjM,2262
 src/utils/json_parser.py,sha256=M_KfrsrNvQPSiFvpKHQV79Aj85_MEcLVc6hnKzvTV58,3243
 src/utils/realtimex.py,sha256=WlGeZ7d-ymXIJ6ZYK2nhjqxArV_7rVHHJLCqaNkcOUw,8648
 src/utils/network/circuit_breaker.py,sha256=BtjogK5R3tG8fuJniS5-PJKZMtwD5P2SkP2JFiQ9sRA,2722
-realtimex_deeptutor-0.5.0.post2.dist-info/METADATA,sha256=TdThltCbaHHOVYhU14uyDrVjtPaZNU95PEVd5n6QcCM,58304
-realtimex_deeptutor-0.5.0.post2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-realtimex_deeptutor-0.5.0.post2.dist-info/entry_points.txt,sha256=slNAzwRLUpqiMtDRZBQIkXbU2vGMHL_om6-o19gYdh8,134
-realtimex_deeptutor-0.5.0.post2.dist-info/top_level.txt,sha256=gmpYj9KuYOk3tTiHiVMhkL2kJYHDR0lejS47k5ROBU4,24
-realtimex_deeptutor-0.5.0.post2.dist-info/RECORD,,
+realtimex_deeptutor-0.5.0.post3.dist-info/METADATA,sha256=cPG-bhP_0bk97uBwQaN9OzVTH9YiVceBLDrNM4_yv8Q,58304
+realtimex_deeptutor-0.5.0.post3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+realtimex_deeptutor-0.5.0.post3.dist-info/entry_points.txt,sha256=slNAzwRLUpqiMtDRZBQIkXbU2vGMHL_om6-o19gYdh8,134
+realtimex_deeptutor-0.5.0.post3.dist-info/top_level.txt,sha256=zUAd6V7jDYhdL7bvg2S38YCM-gVhvd36WqkjxrT-02I,32
+realtimex_deeptutor-0.5.0.post3.dist-info/RECORD,,

{realtimex_deeptutor-0.5.0.post2.dist-info → realtimex_deeptutor-0.5.0.post3.dist-info}/top_level.txt

@@ -1,2 +1,3 @@
 realtimex_deeptutor
+scripts
 src

scripts/__init__.py

@@ -0,0 +1 @@
+# Scripts package - included for package distribution

scripts/audit_prompts.py

@@ -0,0 +1,179 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+Audit prompt parity between prompts/en and prompts/zh|prompts/cn.
+
+Checks:
+- Missing/extra keys (recursive)
+- Placeholder drift in string templates (e.g. {question}, {context})
+
+Usage:
+  python scripts/audit_prompts.py
+  python scripts/audit_prompts.py --fail
+"""
+
+from __future__ import annotations
+
+import argparse
+from dataclasses import dataclass
+from pathlib import Path
+import re
+import sys
+from typing import Any, Iterable
+
+import yaml
+
+PROJECT_ROOT = Path(__file__).resolve().parents[1]
+AGENTS_DIR = PROJECT_ROOT / "src" / "agents"
+
+# Template placeholders are expected to be like {topic}, {knowledge_title}, etc.
+# Avoid false positives from LaTeX (\frac{1}{3}) and Mermaid (B{{Processing}}).
+PLACEHOLDER_RE = re.compile(r"(?<!\{)\{[A-Za-z_][A-Za-z0-9_]*\}(?!\})")
+
+
+def _load_yaml(path: Path) -> Any:
+    with open(path, encoding="utf-8") as f:
+        return yaml.safe_load(f) or {}
+
+
+def _iter_yaml_files(root: Path) -> Iterable[Path]:
+    if not root.exists():
+        return []
+    return sorted([p for p in root.rglob("*.yaml") if p.is_file()])
+
+
+def _get_placeholders(value: Any) -> set[str]:
+    found: set[str] = set()
+    if isinstance(value, str):
+        found |= set(PLACEHOLDER_RE.findall(value))
+    elif isinstance(value, dict):
+        for v in value.values():
+            found |= _get_placeholders(v)
+    elif isinstance(value, list):
+        for v in value:
+            found |= _get_placeholders(v)
+    return found
+
+
+def _collect_keys(value: Any, prefix: str = "") -> set[str]:
+    """
+    Collect dotted key paths for all dict nodes.
+    Leaves (non-dict) are also included as paths.
+    """
+    keys: set[str] = set()
+    if isinstance(value, dict):
+        for k, v in value.items():
+            path = f"{prefix}.{k}" if prefix else str(k)
+            keys.add(path)
+            keys |= _collect_keys(v, path)
+    elif isinstance(value, list):
+        # Lists: we don't expand indices; still consider it a leaf container.
+        if prefix:
+            keys.add(prefix)
+    else:
+        if prefix:
+            keys.add(prefix)
+    return keys
+
+
+@dataclass
+class Diff:
+    missing_zh: list[str]
+    extra_zh: list[str]
+    placeholder_missing_zh: list[str]
+    placeholder_extra_zh: list[str]
+
+
+def _diff(en_obj: Any, zh_obj: Any) -> Diff:
+    en_keys = _collect_keys(en_obj)
+    zh_keys = _collect_keys(zh_obj)
+
+    en_ph = _get_placeholders(en_obj)
+    zh_ph = _get_placeholders(zh_obj)
+
+    return Diff(
+        missing_zh=sorted(en_keys - zh_keys),
+        extra_zh=sorted(zh_keys - en_keys),
+        placeholder_missing_zh=sorted(en_ph - zh_ph),
+        placeholder_extra_zh=sorted(zh_ph - en_ph),
+    )
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--fail", action="store_true", help="exit non-zero on any issue")
+    args = parser.parse_args()
+
+    if not AGENTS_DIR.exists():
+        print(f"Agents directory not found: {AGENTS_DIR}", file=sys.stderr)
+        return 2
+
+    issues = 0
+
+    for module_dir in sorted([p for p in AGENTS_DIR.iterdir() if p.is_dir()]):
+        prompts_dir = module_dir / "prompts"
+        en_dir = prompts_dir / "en"
+        if not en_dir.exists():
+            continue
+
+        # Prefer zh if exists, else cn if exists (but we also compare against cn if present)
+        zh_dir = prompts_dir / "zh"
+        cn_dir = prompts_dir / "cn"
+
+        for en_file in _iter_yaml_files(en_dir):
+            rel = en_file.relative_to(en_dir)
+            candidates = []
+            if zh_dir.exists():
+                candidates.append(("zh", zh_dir / rel))
+            if cn_dir.exists():
+                candidates.append(("cn", cn_dir / rel))
+
+            if not candidates:
+                continue
+
+            en_obj = _load_yaml(en_file)
+
+            for lang_name, zh_file in candidates:
+                if not zh_file.exists():
+                    issues += 1
+                    print(f"[MISSING {lang_name}] {module_dir.name}: {rel.as_posix()}")
+                    continue
+
+                zh_obj = _load_yaml(zh_file)
+                d = _diff(en_obj, zh_obj)
+
+                if d.missing_zh or d.extra_zh or d.placeholder_missing_zh or d.placeholder_extra_zh:
+                    issues += 1
+                    print(f"[DIFF {lang_name}] {module_dir.name}: {rel.as_posix()}")
+                    if d.missing_zh:
+                        print("  - missing keys:")
+                        for k in d.missing_zh[:50]:
+                            print(f"    - {k}")
+                        if len(d.missing_zh) > 50:
+                            print(f"    ... ({len(d.missing_zh) - 50} more)")
+                    if d.extra_zh:
+                        print("  - extra keys:")
+                        for k in d.extra_zh[:50]:
+                            print(f"    - {k}")
+                        if len(d.extra_zh) > 50:
+                            print(f"    ... ({len(d.extra_zh) - 50} more)")
+                    if d.placeholder_missing_zh:
+                        print("  - missing placeholders:")
+                        for p in d.placeholder_missing_zh:
+                            print(f"    - {p}")
+                    if d.placeholder_extra_zh:
+                        print("  - extra placeholders:")
+                        for p in d.placeholder_extra_zh:
+                            print(f"    - {p}")
+
+    if issues == 0:
+        print("OK: prompts are structurally aligned (keys/placeholders).")
+        return 0
+
+    print(f"Found {issues} prompt parity issue(s).")
+    return 1 if args.fail else 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())