@hupan56/wlkj 2.7.12 → 3.1.2

package/templates/qoder/scripts/domain/report/report_snapshot.py

@@ -0,0 +1,261 @@
+#!/usr/bin/env python3
+"""
+report_snapshot.py — /wl-report 的一次性数据聚合器 (性能优化)
+
+问题: wl-report skill 让 AI 逐个 cat/ls/git log 收集数据, 实测产生 5-7 次工具调用、
+多轮思考。本脚本把 report 需要的全部数据源**一次返回**, 把 7 步顺序采集压成 2 步。
+
+与 status_snapshot.py 同构 (Fast Path 模式), 只是数据源换成 report 需要的:
+  1. .developer           — 当前开发者 (报告归属 + 全局过滤键)
+  2. task.py list --mine  — 我创建/被指派的任务
+  3. journal/feedback     — 今天的学习/反馈事件
+  4. git log --author     — 我的提交 (扫 data/code/ 各项目)
+  5. drafts/ + specs/prd  — 我写的 PRD/草稿
+
+输出: JSON, 缺失的字段标 null 并注明原因。AI 拿到后直接写报告, 不用再探查。
+所有数据严格按 .developer 里的开发者名过滤 (report 的隔离铁律)。
+
+用法:
+  python report_snapshot.py             # 当前仓库, 默认今天
+  python report_snapshot.py /path/repo  # 指定仓库
+  python report_snapshot.py --days 7    # 近 7 天 (周报)
+"""
+import json
+import os
+import subprocess
+import sys
+from datetime import datetime, timedelta
+
+
+def _repo_root():
+    """优先用命令行参数, 否则从环境反推 (.qoder 标记)。"""
+    args = [a for a in sys.argv[1:] if not a.startswith("--")]
+    if args and os.path.isdir(args[0]):
+        return os.path.abspath(args[0])
+    d = os.getcwd()
+    for _ in range(8):
+        if os.path.isdir(os.path.join(d, ".qoder")):
+            return d
+        d = os.path.dirname(d)
+    return os.getcwd()
+
+
+def _days():
+    """--days N 参数, 默认 1 (今天/日报)。"""
+    for i, a in enumerate(sys.argv):
+        if a == "--days" and i + 1 < len(sys.argv):
+            try:
+                return int(sys.argv[i + 1])
+            except ValueError:
+                pass
+    return 1
+
+
+def _read_text(path, limit=4000):
+    """安全读文本文件, 不存在返回 None。"""
+    if not os.path.exists(path):
+        return None
+    try:
+        with open(path, "r", encoding="utf-8") as f:
+            return f.read(limit)
+    except Exception as e:
+        return f"<read_error: {e}>"
+
+
+def _parse_developer(text):
+    """从 .developer 文本里取 name= 行的值; 无则取首行。"""
+    if not text:
+        return None
+    for line in text.splitlines():
+        line = line.strip()
+        if line.startswith("name="):
+            return line[5:].strip()
+    first = text.splitlines()[0].strip() if text.strip() else None
+    return first or None
+
+
+def _run_script(script_rel, repo, args=None, timeout=20):
+    """运行 .qoder/scripts 下的脚本, 返回 (stdout, ok)。"""
+    script = os.path.join(repo, script_rel)
+    if not os.path.exists(script):
+        return None, False
+    try:
+        cmd = [sys.executable, script] + (args or [])
+        r = subprocess.run(
+            cmd, cwd=repo, capture_output=True, text=True, timeout=timeout,
+            encoding="utf-8", errors="replace",
+        )
+        return (r.stdout.strip() if r.returncode == 0 else r.stderr.strip()), r.returncode == 0
+    except Exception as e:
+        return f"<run_error: {e}>", False
+
+
+def _git_log_for_author(repo, author, days):
+    """扫 data/code/ 下各项目的 git log, 按作者过滤。返回 {project: [commits]}。"""
+    code_root = os.path.join(repo, "data", "code")
+    if not os.path.isdir(code_root):
+        return None
+    since = (datetime.now() - timedelta(days=days)).strftime("%Y-%m-%d")
+    result = {}
+    try:
+        for name in sorted(os.listdir(code_root)):
+            proj = os.path.join(code_root, name)
+            if not os.path.isdir(os.path.join(proj, ".git")):
+                continue
+            try:
+                r = subprocess.run(
+                    ["git", "-C", proj, "log", f"--author={author}",
+                     f"--since={since}", "--oneline", "-n", "50"],
+                    capture_output=True, text=True, timeout=8,
+                    encoding="utf-8", errors="replace",
+                )
+                out = r.stdout.strip() if r.returncode == 0 else ""
+                if out:
+                    commits = [l for l in out.splitlines() if l.strip()]
+                    result[name] = commits[:50]
+            except Exception:
+                continue
+    except Exception:
+        pass
+    return result if result else {}
+
+
+def _list_prds_by_author(repo, author, days):
+    """收集 workspace/specs/prd/*.md 和 members/*/drafts 里 author==developer 的 PRD。
+    frontmatter 里有 author 字段就按它过滤; 草稿目录按开发者归属过滤。"""
+    since = datetime.now() - timedelta(days=days + 30)  # PRD 按文件宽松一点
+    hits = []
+
+    # 1. 团队归档的 PRD (按 frontmatter author 过滤)
+    prd_dir = os.path.join(repo, "workspace", "specs", "prd")
+    if os.path.isdir(prd_dir):
+        for name in sorted(os.listdir(prd_dir)):
+            if not name.endswith(".md"):
+                continue
+            fp = os.path.join(prd_dir, name)
+            try:
+                mtime = datetime.fromtimestamp(os.path.getmtime(fp))
+                if mtime < since:
+                    continue
+                head = _read_text(fp, limit=600) or ""
+                # frontmatter 里找 author:
+                is_mine = False
+                if "author:" in head.lower() or "author =" in head.lower():
+                    is_mine = author.lower() in head.lower()
+                if is_mine:
+                    title = name[:-3]
+                    hits.append({"file": f"workspace/specs/prd/{name}",
+                                 "title": title, "mtime": mtime.strftime("%Y-%m-%d")})
+            except Exception:
+                continue
+
+    # 2. 个人草稿 (按目录归属天然隔离, 整个目录都是该开发者的)
+    dev_drafts = os.path.join(repo, "workspace", "members", author, "drafts")
+    if os.path.isdir(dev_drafts):
+        for root, _dirs, files in os.walk(dev_drafts):
+            for fn in files:
+                if fn.endswith(".md"):
+                    fp = os.path.join(root, fn)
+                    try:
+                        mtime = datetime.fromtimestamp(os.path.getmtime(fp))
+                        if mtime >= since:
+                            rel = os.path.relpath(fp, repo).replace("\\", "/")
+                            hits.append({"file": rel, "title": fn[:-3],
+                                         "mtime": mtime.strftime("%Y-%m-%d")})
+                    except Exception:
+                        continue
+    return hits[:50] if hits else []
+
+
+def _journal_today(repo, author, days):
+    """读该开发者 journal 目录近 days 天的 feedback/learning 事件。"""
+    journal = os.path.join(repo, "workspace", "members", author, "journal")
+    if not os.path.isdir(journal):
+        return None
+    since = datetime.now() - timedelta(days=days)
+    events = []
+    for fn in sorted(os.listdir(journal)):
+        fp = os.path.join(journal, fn)
+        if not os.path.isfile(fp):
+            continue
+        try:
+            mtime = datetime.fromtimestamp(os.path.getmtime(fp))
+            if mtime < since:
+                continue
+            if fn.endswith(".jsonl"):
+                # feedback.jsonl: 读近几天的事件行
+                with open(fp, encoding="utf-8") as f:
+                    for line in f:
+                        line = line.strip()
+                        if not line:
+                            continue
+                        try:
+                            ev = json.loads(line)
+                            # 事件带时间戳则按时间过滤, 否则按文件 mtime 已过滤
+                            events.append(ev)
+                        except json.JSONDecodeError:
+                            continue
+            elif fn.endswith((".yaml", ".yml")):
+                txt = _read_text(fp, limit=2000)
+                if txt:
+                    events.append({"_file": fn, "_summary": txt[:500]})
+        except Exception:
+            continue
+    return events[:100] if events else []
+
+
+def snapshot(repo=None, days=None):
+    """收集 wl-report 需要的全部数据, 返回 dict。"""
+    repo = repo or _repo_root()
+    days = days or _days()
+    qd = os.path.join(repo, ".qoder")
+
+    data = {"_repo": repo, "_ts": datetime.now().isoformat(timespec="seconds"),
+            "_days": days}
+
+    # 1. 开发者身份 (report 的全局过滤键)
+    dev_text = _read_text(os.path.join(qd, ".developer"))
+    developer = _parse_developer(dev_text)
+    data["developer"] = developer or "(未设置)"
+    data["developer_raw"] = dev_text
+
+    if not developer or developer == "(未设置)":
+        data["_note"] = "未设置 .developer, 无法按开发者过滤。先 /wl-init。"
+        return data
+
+    # 2-5 四个独立数据源并行采集 (task list 最慢~440ms, 并行后总耗时≈最慢的那个)
+    # task list / git log / journal / prds 互不依赖 → 用线程池同时跑, 砍掉串行等待。
+    from concurrent.futures import ThreadPoolExecutor
+    with ThreadPoolExecutor(max_workers=4) as pool:
+        f_tasks = pool.submit(_run_script, ".qoder/scripts/domain/task/task.py", repo,
+                              ["list", "--mine"])
+        f_journal = pool.submit(_journal_today, repo, developer, days)
+        f_commits = pool.submit(_git_log_for_author, repo, developer, days)
+        f_prds = pool.submit(_list_prds_by_author, repo, developer, days)
+
+    task_out, task_ok = f_tasks.result()
+    data["my_tasks"] = task_out if task_ok else None
+    data["my_tasks_error"] = None if task_ok else task_out
+    data["journal"] = f_journal.result()
+    data["commits"] = f_commits.result()
+    data["my_prds"] = f_prds.result()
+
+    # 6. 报告日期范围 (供 AI 套模板)
+    today = datetime.now().strftime("%Y-%m-%d")
+    start = (datetime.now() - timedelta(days=days - 1)).strftime("%Y-%m-%d")
+    data["date_range"] = f"{start} ~ {today}" if days > 1 else today
+
+    return data
+
+
+def main():
+    repo = None
+    args = [a for a in sys.argv[1:] if not a.startswith("--")]
+    if args:
+        repo = args[0]
+    data = snapshot(repo)
+    print(json.dumps(data, ensure_ascii=False, indent=2, default=str))
+
+
+if __name__ == "__main__":
+    main()

package/templates/qoder/scripts/domain/report/role.py

@@ -0,0 +1,39 @@
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+from foundation.core.paths import get_repo_root
+
+# role.py - 角色解析 (v3.0: 已并入 common/identity.py, 本文件为兼容转发层)
+#
+# 角色能力查询 (get_role/can_produce/can_consume/...) 已统一到 common/identity.py,
+# 由 guard.py 强制执行角色边界。本文件保留是为了:
+#   1. CLI 兼容: skill 脚本里 `ROLE=$(python role.py)` 仍能输出角色名
+#   2. import 兼容: `from role import get_role` 仍可用 (转发到 identity)
+#
+# ⚠️ 新代码请直接用: from foundation.identity.identity import get_role / from foundation.identity.guard import ...
+#    本文件未来随 M2 引擎重构可能移除。
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from foundation.identity.identity import get_role, get_permissions, get_capabilities, can_produce, can_consume  # noqa: E402,F401
+
+BASE = get_repo_root()
+
+
+if __name__ == '__main__':
+    # CLI: 输出当前角色名 (供 skill 脚本动态读角色用)
+    # 用法: ROLE=$(python role.py)
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except (AttributeError, IOError):
+        pass
+    r = get_role()
+    print(r or 'pm')  # 无角色默认 pm (软引导, 不报错)