@hupan56/wlkj 3.3.13 → 3.3.15

package/templates/qoder/scripts/foundation/bootstrap.py

@@ -1,156 +1,145 @@
-# -*- coding: utf-8 -*-
-# Windows 控制台 UTF-8 修复（ctypes 直调 Windows API；所有经 bootstrap 引导的脚本都受益）
-import sys as _s
-if _s.platform == 'win32':
-    import ctypes as _ct, io as _io
-    try:
-        _ct.windll.kernel32.SetConsoleOutputCP(65001)
-        _ct.windll.kernel32.SetConsoleCP(65001)
-        _s.stdout = _io.TextIOWrapper(_s.stdout.buffer, encoding='utf-8', errors='replace')
-        _s.stderr = _io.TextIOWrapper(_s.stderr.buffer, encoding='utf-8', errors='replace')
-    except Exception:
-        pass
-"""
-bootstrap.py - 统一 CLI 启动样板 (DRY) + 子目录化路径自举 (v3.0)
-
-治"70处 sys.path + 50处 reconfigure" + 子目录化后的路径定位。
-
-子目录化后, 脚本在 scripts/domain/kg/kg.py, 它的 dirname(__file__)=scripts/domain/kg/,
-直接 sys.path.insert(scripts/domain/kg/) 后 `from foundation.x` 会断 (foundation 在 scripts/foundation/)。
-
-本模块的 setup() 解决: 无论脚本在 scripts/ 根还是 scripts/某子包/,
-都能正确定位 scripts/ 根并注入, 让 `from foundation.x` 和跨包 import 都能用。
-
-核心: _find_scripts_root() 向上找含 'foundation/' 子目录的那个目录 = scripts/ 根。
-
-Usage (两种姿势):
-    # 姿势1: 子包脚本开头 (推荐)
-    import os, sys
-    _S = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))  # 子包→scripts
-    if _S not in sys.path: sys.path.insert(0, _S)
-    from bootstrap import setup; setup()
-
-    # 姿势2: scripts/ 根脚本 (老姿势仍可用)
-    from bootstrap import setup; setup()
-"""
-
-import os
-import sys
-
-__all__ = ["setup", "SCRIPTS_DIR", "REPO_ROOT", "find_scripts_root", "ensure_scripts_path"]
-
-
-def find_scripts_root(start=None):
-    """定位 .qoder/scripts/ 根目录。
-
-    策略: 从 start (默认 __file__ 的目录) 向上找, 直到某目录含 'common/' 子目录
-    且该 common/ 下有 bootstrap.py (即本文件) → 那就是 scripts/ 根。
-    兜底: 找含 '.qoder' 的目录 + '/scripts'。
-    """
-    start = start or os.path.dirname(os.path.abspath(__file__))
-    cur = start
-    for _ in range(10):
-        # scripts/ 根的标志: 含 common/bootstrap.py
-        if os.path.isfile(os.path.join(cur, "foundation", "bootstrap.py")):
-            return cur
-        parent = os.path.dirname(cur)
-        if parent == cur:
-            break
-        cur = parent
-    # 兜底: cwd 向上找 .qoder/scripts
-    cwd = os.getcwd()
-    for _ in range(10):
-        cand = os.path.join(cwd, ".qoder", "scripts")
-        if os.path.isdir(cand):
-            return cand
-        parent = os.path.dirname(cwd)
-        if parent == cwd:
-            break
-        cwd = parent
-    return start
-
-
-def ensure_scripts_path(start=None):
-    """确保 scripts/ 根在 sys.path 最前。幂等。
-
-    子包脚本调用此函数后, `from foundation.x` 即可用。
-    """
-    root = find_scripts_root(start)
-    if root not in sys.path:
-        sys.path.insert(0, root)
-    return root
-
-
-def _find_scripts_dir() -> str:
-    """[内部] 定位 scripts/ 根 (兼容旧名)。"""
-    return find_scripts_root()
-
-
-def ensure_utf8_stdio():
-    """UTF-8 stdio 配置 (v3.0: 从 utf8.py 并入)。
-
-    把 stdout/stderr 切到 UTF-8, 失败则忽略 (不崩溃)。
-    幂等: 多次调用无害。
-    """
-    for stream_name in ("stdout", "stderr"):
-        stream = getattr(sys, stream_name, None)
-        if stream is None:
-            continue
-        reconfigure = getattr(stream, "reconfigure", None)
-        if reconfigure is None:
-            continue
-        try:
-            reconfigure(encoding="utf-8", errors="replace")
-        except (TypeError, ValueError, OSError, IOError):
-            try:
-                reconfigure(encoding="utf-8")
-            except Exception:
-                pass
-
-
-def setup():
-    """统一 CLI 启动初始化。幂等。
-
-    做: ① ensure_utf8_stdio ② scripts/ 根注入 sys.path ③ scripts/common/ 注入
-    Returns: (SCRIPTS_DIR, REPO_ROOT)
-    """
-    # 先确保 scripts/ 根在 path (本文件可能在 common/ 或被引用)
-    scripts_dir = ensure_scripts_root = find_scripts_root()
-    if scripts_dir not in sys.path:
-        sys.path.insert(0, scripts_dir)
-    common_dir = os.path.join(scripts_dir, "foundation")
-    if os.path.isdir(common_dir) and common_dir not in sys.path:
-        sys.path.insert(0, common_dir)
-    # 注入所有子包目录 (kg/build/mcp/test/setup/carriers/task/search/report)
-    # 让跨包 import (旧式不带前缀, 如 import search_index) 仍可用
-    try:
-        for _name in os.listdir(scripts_dir):
-            _subdir = os.path.join(scripts_dir, _name)
-            if os.path.isdir(_subdir) and _subdir not in sys.path:
-                sys.path.insert(0, _subdir)
-    except OSError:
-        pass
-
-    # 1. UTF-8 stdio (v3.0: utf8.py 已并入 bootstrap, 内联实现)
-    try:
-        ensure_utf8_stdio()
-    except Exception:
-        for sname in ("stdout", "stderr"):
-            s = getattr(sys, sname, None)
-            rc = getattr(s, "reconfigure", None) if s else None
-            if rc:
-                try:
-                    rc(encoding="utf-8", errors="replace")
-                except Exception:
-                    try:
-                        rc(encoding="utf-8")
-                    except Exception:
-                        pass
-
-    repo_root = os.path.dirname(os.path.dirname(scripts_dir))
-    return scripts_dir, repo_root
-
-
-# 模块级常量
-SCRIPTS_DIR = find_scripts_root()
-REPO_ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(SCRIPTS_DIR))))
+# -*- coding: utf-8 -*-
+"""
+bootstrap.py - 统一 CLI 启动样板 (DRY) + 子目录化路径自举 (v3.0)
+
+治"70处 sys.path + 50处 reconfigure" + 子目录化后的路径定位。
+
+子目录化后, 脚本在 scripts/domain/kg/kg.py, 它的 dirname(__file__)=scripts/domain/kg/,
+直接 sys.path.insert(scripts/domain/kg/) 后 `from foundation.x` 会断 (foundation 在 scripts/foundation/)。
+
+本模块的 setup() 解决: 无论脚本在 scripts/ 根还是 scripts/某子包/,
+都能正确定位 scripts/ 根并注入, 让 `from foundation.x` 和跨包 import 都能用。
+
+核心: _find_scripts_root() 向上找含 'foundation/' 子目录的那个目录 = scripts/ 根。
+
+Usage (两种姿势):
+    # 姿势1: 子包脚本开头 (推荐)
+    import os, sys
+    _S = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))  # 子包→scripts
+    if _S not in sys.path: sys.path.insert(0, _S)
+    from bootstrap import setup; setup()
+
+    # 姿势2: scripts/ 根脚本 (老姿势仍可用)
+    from bootstrap import setup; setup()
+"""
+
+import os
+import sys
+
+__all__ = ["setup", "SCRIPTS_DIR", "REPO_ROOT", "find_scripts_root", "ensure_scripts_path"]
+
+
+def find_scripts_root(start=None):
+    """定位 .qoder/scripts/ 根目录。
+
+    策略: 从 start (默认 __file__ 的目录) 向上找, 直到某目录含 'common/' 子目录
+    且该 common/ 下有 bootstrap.py (即本文件) → 那就是 scripts/ 根。
+    兜底: 找含 '.qoder' 的目录 + '/scripts'。
+    """
+    start = start or os.path.dirname(os.path.abspath(__file__))
+    cur = start
+    for _ in range(10):
+        # scripts/ 根的标志: 含 common/bootstrap.py
+        if os.path.isfile(os.path.join(cur, "foundation", "bootstrap.py")):
+            return cur
+        parent = os.path.dirname(cur)
+        if parent == cur:
+            break
+        cur = parent
+    # 兜底: cwd 向上找 .qoder/scripts
+    cwd = os.getcwd()
+    for _ in range(10):
+        cand = os.path.join(cwd, ".qoder", "scripts")
+        if os.path.isdir(cand):
+            return cand
+        parent = os.path.dirname(cwd)
+        if parent == cwd:
+            break
+        cwd = parent
+    return start
+
+
+def ensure_scripts_path(start=None):
+    """确保 scripts/ 根在 sys.path 最前。幂等。
+
+    子包脚本调用此函数后, `from foundation.x` 即可用。
+    """
+    root = find_scripts_root(start)
+    if root not in sys.path:
+        sys.path.insert(0, root)
+    return root
+
+
+def _find_scripts_dir() -> str:
+    """[内部] 定位 scripts/ 根 (兼容旧名)。"""
+    return find_scripts_root()
+
+
+def ensure_utf8_stdio():
+    """UTF-8 stdio 配置 (v3.0: 从 utf8.py 并入)。
+
+    把 stdout/stderr 切到 UTF-8, 失败则忽略 (不崩溃)。
+    幂等: 多次调用无害。
+    """
+    for stream_name in ("stdout", "stderr"):
+        stream = getattr(sys, stream_name, None)
+        if stream is None:
+            continue
+        reconfigure = getattr(stream, "reconfigure", None)
+        if reconfigure is None:
+            continue
+        try:
+            reconfigure(encoding="utf-8", errors="replace")
+        except (TypeError, ValueError, OSError, IOError):
+            try:
+                reconfigure(encoding="utf-8")
+            except Exception:
+                pass
+
+
+def setup():
+    """统一 CLI 启动初始化。幂等。
+
+    做: ① ensure_utf8_stdio ② scripts/ 根注入 sys.path ③ scripts/common/ 注入
+    Returns: (SCRIPTS_DIR, REPO_ROOT)
+    """
+    # 先确保 scripts/ 根在 path (本文件可能在 common/ 或被引用)
+    scripts_dir = ensure_scripts_root = find_scripts_root()
+    if scripts_dir not in sys.path:
+        sys.path.insert(0, scripts_dir)
+    common_dir = os.path.join(scripts_dir, "foundation")
+    if os.path.isdir(common_dir) and common_dir not in sys.path:
+        sys.path.insert(0, common_dir)
+    # 注入所有子包目录 (kg/build/mcp/test/setup/carriers/task/search/report)
+    # 让跨包 import (旧式不带前缀, 如 import search_index) 仍可用
+    try:
+        for _name in os.listdir(scripts_dir):
+            _subdir = os.path.join(scripts_dir, _name)
+            if os.path.isdir(_subdir) and _subdir not in sys.path:
+                sys.path.insert(0, _subdir)
+    except OSError:
+        pass
+
+    # 1. UTF-8 stdio (v3.0: utf8.py 已并入 bootstrap, 内联实现)
+    try:
+        ensure_utf8_stdio()
+    except Exception:
+        for sname in ("stdout", "stderr"):
+            s = getattr(sys, sname, None)
+            rc = getattr(s, "reconfigure", None) if s else None
+            if rc:
+                try:
+                    rc(encoding="utf-8", errors="replace")
+                except Exception:
+                    try:
+                        rc(encoding="utf-8")
+                    except Exception:
+                        pass
+
+    repo_root = os.path.dirname(os.path.dirname(scripts_dir))
+    return scripts_dir, repo_root
+
+
+# 模块级常量
+SCRIPTS_DIR = find_scripts_root()
+REPO_ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(SCRIPTS_DIR))))

package/templates/qoder/scripts/foundation/io/context_cache.py

@@ -1,94 +1,94 @@
-"""context_cache.py — 按 REQ-id 缓存 context_pack/rag_search 结果（T1.3 跨命令上下文缓存）。
-
-PRD→spec→code 链路里同一 REQ 反复拉同一份上下文（3 次 KG/MCP 往返）→ 缓存复用，省 token + 减反复搜。
-
-存储: workspace/specs/{REQ}/.context-cache.json
-结构: {query_hash: {"query":..., "text":..., "ts":...}}
-TTL 默认 24h（PRD/spec 改动后用 invalidate(req) 显式失效）。
-
-纯模块，无外部依赖；任何异常 fail-open（缓存坏了不影响主流程，调用方降级直拉）。
-"""
-import os
-import json
-import time
-import hashlib
-
-DEFAULT_TTL = 24 * 3600  # 24h
-
-
-def _repo_root():
-    """从本文件向上找含 workspace/ 或 .qoder/ 的目录作仓库根。"""
-    d = os.path.dirname(os.path.abspath(__file__))
-    for _ in range(7):
-        if os.path.isdir(os.path.join(d, "workspace")) or os.path.isdir(os.path.join(d, ".qoder")):
-            return d
-        parent = os.path.dirname(d)
-        if parent == d:
-            break
-        d = parent
-    return os.getcwd()
-
-
-def _sanitize(req_id):
-    return "".join(c for c in str(req_id) if c.isalnum() or c in "-_") or "unknown"
-
-
-def cache_path(req_id, base=None):
-    base = base or _repo_root()
-    return os.path.join(base, "workspace", "specs", _sanitize(req_id), ".context-cache.json")
-
-
-def _load(path):
-    try:
-        with open(path, encoding="utf-8") as f:
-            data = json.load(f)
-            return data if isinstance(data, dict) else {}
-    except Exception:
-        return {}
-
-
-def _save(path, data):
-    try:
-        os.makedirs(os.path.dirname(path), exist_ok=True)
-        tmp = path + ".tmp"
-        with open(tmp, "w", encoding="utf-8") as f:
-            json.dump(data, f, ensure_ascii=False, indent=2)
-        os.replace(tmp, path)  # 原子写
-        return True
-    except Exception:
-        return False
-
-
-def _qhash(query):
-    return hashlib.md5(query.strip().lower().encode("utf-8")).hexdigest()[:12]
-
-
-def get(req_id, query, ttl=DEFAULT_TTL, base=None):
-    """命中且未过期 → 返回 text；否则 None。"""
-    data = _load(cache_path(req_id, base))
-    entry = data.get(_qhash(query))
-    if not entry:
-        return None
-    if ttl and (time.time() - float(entry.get("ts", 0))) > ttl:
-        return None
-    return entry.get("text")
-
-
-def put(req_id, query, text, base=None):
-    """写一条缓存（覆盖同 query 旧值）。"""
-    path = cache_path(req_id, base)
-    data = _load(path)
-    data[_qhash(query)] = {"query": query, "text": text, "ts": time.time()}
-    return _save(path, data)
-
-
-def invalidate(req_id, base=None):
-    """清整个 REQ 的缓存（PRD/spec 改动后调）。"""
-    return _save(cache_path(req_id, base), {})
-
-
-def stats(req_id, base=None):
-    """缓存条数 + query 摘要（调试/观测命中率用）。"""
-    data = _load(cache_path(req_id, base))
-    return {"entries": len(data),
-            "queries": [str(e.get("query", ""))[:40] for e in data.values()]}
+"""context_cache.py — 按 REQ-id 缓存 context_pack/rag_search 结果（T1.3 跨命令上下文缓存）。
+
+PRD→spec→code 链路里同一 REQ 反复拉同一份上下文（3 次 KG/MCP 往返）→ 缓存复用，省 token + 减反复搜。
+
+存储: workspace/specs/{REQ}/.context-cache.json
+结构: {query_hash: {"query":..., "text":..., "ts":...}}
+TTL 默认 24h（PRD/spec 改动后用 invalidate(req) 显式失效）。
+
+纯模块，无外部依赖；任何异常 fail-open（缓存坏了不影响主流程，调用方降级直拉）。
+"""
+import os
+import json
+import time
+import hashlib
+
+DEFAULT_TTL = 24 * 3600  # 24h
+
+
+def _repo_root():
+    """从本文件向上找含 workspace/ 或 .qoder/ 的目录作仓库根。"""
+    d = os.path.dirname(os.path.abspath(__file__))
+    for _ in range(7):
+        if os.path.isdir(os.path.join(d, "workspace")) or os.path.isdir(os.path.join(d, ".qoder")):
+            return d
+        parent = os.path.dirname(d)
+        if parent == d:
+            break
+        d = parent
+    return os.getcwd()
+
+
+def _sanitize(req_id):
+    return "".join(c for c in str(req_id) if c.isalnum() or c in "-_") or "unknown"
+
+
+def cache_path(req_id, base=None):
+    base = base or _repo_root()
+    return os.path.join(base, "workspace", "specs", _sanitize(req_id), ".context-cache.json")
+
+
+def _load(path):
+    try:
+        with open(path, encoding="utf-8") as f:
+            data = json.load(f)
+            return data if isinstance(data, dict) else {}
+    except Exception:
+        return {}
+
+
+def _save(path, data):
+    try:
+        os.makedirs(os.path.dirname(path), exist_ok=True)
+        tmp = path + ".tmp"
+        with open(tmp, "w", encoding="utf-8") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+        os.replace(tmp, path)  # 原子写
+        return True
+    except Exception:
+        return False
+
+
+def _qhash(query):
+    return hashlib.md5(query.strip().lower().encode("utf-8")).hexdigest()[:12]
+
+
+def get(req_id, query, ttl=DEFAULT_TTL, base=None):
+    """命中且未过期 → 返回 text；否则 None。"""
+    data = _load(cache_path(req_id, base))
+    entry = data.get(_qhash(query))
+    if not entry:
+        return None
+    if ttl and (time.time() - float(entry.get("ts", 0))) > ttl:
+        return None
+    return entry.get("text")
+
+
+def put(req_id, query, text, base=None):
+    """写一条缓存（覆盖同 query 旧值）。"""
+    path = cache_path(req_id, base)
+    data = _load(path)
+    data[_qhash(query)] = {"query": query, "text": text, "ts": time.time()}
+    return _save(path, data)
+
+
+def invalidate(req_id, base=None):
+    """清整个 REQ 的缓存（PRD/spec 改动后调）。"""
+    return _save(cache_path(req_id, base), {})
+
+
+def stats(req_id, base=None):
+    """缓存条数 + query 摘要（调试/观测命中率用）。"""
+    data = _load(cache_path(req_id, base))
+    return {"entries": len(data),
+            "queries": [str(e.get("query", ""))[:40] for e in data.values()]}