@hupan56/wlkj 3.0.0 → 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/{report → domain/report}/role.py

@@ -1,8 +1,14 @@
 # v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
 import os as _o, sys as _s
-_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+_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, 本文件为兼容转发层)
 #
@@ -11,15 +17,15 @@ from bootstrap import setup; setup()
 #   1. CLI 兼容: skill 脚本里 `ROLE=$(python role.py)` 仍能输出角色名
 #   2. import 兼容: `from role import get_role` 仍可用 (转发到 identity)
 #
-# ⚠️ 新代码请直接用: from common.identity import get_role / from common.guard import ...
+# ⚠️ 新代码请直接用: 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 common.identity import get_role, get_permissions, get_capabilities, can_produce, can_consume  # noqa: E402,F401
+from foundation.identity.identity import get_role, get_permissions, get_capabilities, can_produce, can_consume  # noqa: E402,F401
 
-BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+BASE = get_repo_root()
 
 
 if __name__ == '__main__':

package/templates/qoder/scripts/{report → domain/report}/status.py

@@ -2,7 +2,12 @@
 # -*- coding: utf-8 -*-
 # v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
 import os as _o, sys as _s
-_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+_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()
 
@@ -34,9 +39,9 @@ except (AttributeError, TypeError, OSError):
 
 THIS_DIR = os.path.dirname(os.path.abspath(__file__))
 sys.path.insert(0, THIS_DIR)
-from common.paths import get_repo_root, get_developer, get_tasks_dir, MEMBERS_DIR
-from common.task_utils import load_task_json
-from common.atomicio import safe_read_json
+from foundation.core.paths import get_repo_root, get_developer, get_tasks_dir, MEMBERS_DIR, EVAL_HISTORY_PATH
+from foundation.data.task_utils import load_task_json
+from foundation.io.atomicio import safe_read_json
 
 BASE = get_repo_root()
 INDEX_DIR = BASE / 'data' / 'index'
@@ -230,6 +235,100 @@ def _count_all_feedback():
     return total
 
 
+def _compute_adoption_score():
+    """工作流采纳度 (0-5), 供 compute_health 的 adoption 维度用。
+
+    与 usability_score.py 的 adoption_score 同源逻辑 (避免 import 验证脚本产生环依赖, 内联):
+    取能算的自动采纳指标 (U2一次过审/U3返工/U4违规/U6活跃), 按达标率映射 0-5。
+    无数据 → 中性 2.5。
+    """
+    # U2 一次过审率 + U3 返工 (从 eval-history)
+    records = []
+    if EVAL_HISTORY_PATH.is_file():
+        try:
+            with open(EVAL_HISTORY_PATH, encoding='utf-8') as f:
+                for line in f:
+                    line = line.strip()
+                    if line:
+                        records.append(json.loads(line))
+        except Exception:
+            pass
+
+    scored = []  # 每项 1.0(绿)/0.5(黄)/0(红)
+
+    # U2: 首轮过审率
+    by_prd = {}
+    for r in records:
+        prd = r.get('prd')
+        if not prd:
+            continue
+        t = r.get('time', '')
+        if prd not in by_prd or (t and t < by_prd[prd][0]):
+            by_prd[prd] = (t, r)
+    if by_prd:
+        first_pass = sum(1 for (t, row) in by_prd.values() if row.get('passed'))
+        u2_rate = 100.0 * first_pass / len(by_prd)
+        scored.append(1.0 if u2_rate >= 60 else (0.5 if u2_rate >= 30 else 0.0))
+
+    # U3: 平均返工轮数 (越低越好)
+    if by_prd:
+        per_prd = {}
+        for r in records:
+            if r.get('prd'):
+                per_prd.setdefault(r['prd'], []).append(r)
+        total_evals = sum(len(v) for v in per_prd.values())
+        avg_rework = total_evals / len(per_prd) - 1.0
+        avg_rework = max(avg_rework, 0.0)
+        scored.append(1.0 if avg_rework <= 1.0 else (0.5 if avg_rework <= 2.0 else 0.0))
+
+    # U4 规则违反率 + U6 活跃 (从 feedback)
+    violations = 0
+    prds_gen = 0
+    active_devs = set()
+    now = datetime.now()
+    week_ago = now - timedelta(days=7)
+    if MEMBERS_DIR.is_dir():
+        for dev_dir in MEMBERS_DIR.iterdir():
+            if not dev_dir.is_dir():
+                continue
+            fb = dev_dir / 'journal' / 'feedback.jsonl'
+            if not fb.is_file():
+                continue
+            try:
+                with open(fb, encoding='utf-8') as f:
+                    for line in f:
+                        line = line.strip()
+                        if not line:
+                            continue
+                        e = json.loads(line)
+                        if e.get('event') == 'rule_violation':
+                            violations += 1
+                        if e.get('event') == 'prd_accepted':
+                            prds_gen += 1
+                        # U6: 近7天有事件的 dev
+                        ts = e.get('ts', '')
+                        try:
+                            t = datetime.fromisoformat(str(ts).split('.')[0])
+                            if t >= week_ago:
+                                active_devs.add(e.get('dev'))
+                        except (ValueError, TypeError):
+                            pass
+            except Exception:
+                continue
+    # U4
+    if prds_gen:
+        vrate = 100.0 * violations / prds_gen
+        scored.append(1.0 if vrate <= 10 else (0.5 if vrate <= 25 else 0.0))
+    # U6
+    n_devs = len(active_devs)
+    scored.append(1.0 if n_devs >= 2 else (0.5 if n_devs == 1 else 0.0))
+
+    if not scored:
+        return 2.5  # 无数据, 中性
+    # 达标率 → 0-5 (1.0全绿=5, 全红=0)
+    return round(5.0 * sum(scored) / len(scored), 2)
+
+
 # ============================================================
 # 健康分 (综合)
 # ============================================================
@@ -243,7 +342,7 @@ def compute_health(tasks):
 
     # 1. EVA 合格率 (25%)
     # eval-history 是 jsonl (每行一个 JSON), 不能用 safe_read_json
-    eval_path = BASE / '.qoder' / 'learning' / 'eval-history.jsonl'
+    eval_path = EVAL_HISTORY_PATH
     if eval_path.is_file():
         records = []
         try:
@@ -301,17 +400,21 @@ def compute_health(tasks):
     else:
         scores['pipeline'] = 2.0
 
-    # 6. 学习 (10%)
+    # 6. 学习 (5%)
     # 修 bug: 旧代码读 data/learning/feedback.jsonl (旧路径, 已废弃),
     # 但 learn.py 实际写 workspace/members/{dev}/journal/feedback.jsonl。
     # 迁移了写路径没迁移读路径 → 学习度恒为 2.0。改为扫全部 dev 的 journal。
     fb_count = _count_all_feedback()
     scores['learning'] = min(5.0, 2.0 + fb_count * 0.1) if fb_count else 2.0
 
+    # 7. 工作流采纳 (10%) — 与 EVA/学习并列, 回答"用不用得起来"
+    # 复用 usability_score.py 的采纳分逻辑 (不 import 验证脚本, 内联等价计算避免环依赖)
+    scores['adoption'] = _compute_adoption_score()
+
     # 加权
     weights = {
         'eva': 0.25, 'index': 0.20, 'on_time': 0.20,
-        'sync': 0.15, 'pipeline': 0.10, 'learning': 0.10,
+        'sync': 0.15, 'pipeline': 0.05, 'learning': 0.05, 'adoption': 0.10,
     }
     total = sum(scores[k] * weights[k] for k in weights)
     return {
@@ -356,7 +459,7 @@ def _analyze_eva_rounds():
     返回 {samples, rework_count, avg_rounds}。
     rework = 连续 passed=false 后出现 passed=true 的序列。
     """
-    eval_path = BASE / '.qoder' / 'learning' / 'eval-history.jsonl'
+    eval_path = EVAL_HISTORY_PATH
     if not eval_path.is_file():
         return {'samples': 0, 'rework_count': 0, 'avg_rounds': 0}
     records = []
@@ -466,7 +569,7 @@ def compute_role_guide():
     role = None
     try:
         sys.path.insert(0, str(BASE / '.qoder' / 'scripts'))
-        from common.identity import get_role
+        from foundation.identity.identity import get_role
         role = get_role()
     except Exception:
         pass

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

@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+"""
+status_snapshot.py — /wl-status 的一次性数据聚合器 (性能优化)
+
+问题: wl-status skill 让 AI 逐个 cat/ls 收集数据, 实测产生 5 轮迭代、10+ 次工具调用。
+本脚本把 status 需要的全部数据源**一次返回**, 把 5 轮迭代压成 1 轮。
+
+聚合的数据源 (来自 wl-status SKILL.md):
+  1. .developer          — 当前开发者
+  2. .index-meta.json    — 图谱新鲜度
+  3. eval-history.jsonl  — EVA 评估历史 (健康度趋势)
+  4. feedback.jsonl      — 学习反馈记录
+  5. config.yaml         — 项目配置
+  6. task.py list        — 任务列表
+  7. team_sync.py status — 团队同步状态
+  8. tasks 目录          — 任务文件清单
+  9. learning/patterns   — 学习模式
+
+输出: JSON, 缺失的字段标 null 并注明原因。AI 拿到后直接算健康度, 不用再探查。
+
+用法:
+  python status_snapshot.py            # 当前仓库
+  python status_snapshot.py /path/to/repo
+"""
+import json
+import os
+import subprocess
+import sys
+from datetime import datetime
+
+
+def _repo_root():
+    """优先用命令行参数, 否则从环境反推。"""
+    if len(sys.argv) > 1 and os.path.isdir(sys.argv[1]):
+        return os.path.abspath(sys.argv[1])
+    # 同 task.py 的逻辑: 找 .qoder 标记
+    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 _read_text(path, limit=20000):
+    """安全读文本文件, 不存在返回 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 _read_json(path):
+    if not os.path.exists(path):
+        return None
+    try:
+        with open(path, "r", encoding="utf-8") as f:
+            return json.load(f)
+    except Exception as e:
+        return {"_error": str(e)}
+
+
+def _read_jsonl_tail(path, n=10):
+    """读 jsonl 最后 n 行 (评估/反馈历史, 只关心最近的)。"""
+    if not os.path.exists(path):
+        return None
+    try:
+        with open(path, "r", encoding="utf-8") as f:
+            lines = [l.strip() for l in f if l.strip()]
+        out = []
+        for l in lines[-n:]:
+            try:
+                out.append(json.loads(l))
+            except json.JSONDecodeError:
+                continue
+        return out
+    except Exception:
+        return 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 _list_dir(path):
+    if not os.path.isdir(path):
+        return None
+    try:
+        items = sorted(os.listdir(path))
+        return items[:50]  # 限 50 项防爆
+    except Exception:
+        return None
+
+
+def _index_freshness(meta):
+    """从 .index-meta.json 算新鲜度(距今天数)。"""
+    if not isinstance(meta, dict):
+        return None
+    last = meta.get("last_sync") or meta.get("last_build") or meta.get("updated")
+    if not last:
+        return None
+    try:
+        # 兼容多种时间格式
+        ts = str(last).replace("Z", "+00:00")
+        dt = datetime.fromisoformat(ts)
+        if dt.tzinfo:
+            dt = dt.replace(tzinfo=None)
+        return (datetime.now() - dt).days
+    except Exception:
+        return None
+
+
+def snapshot(repo=None):
+    """收集 wl-status 需要的全部数据, 返回 dict。"""
+    repo = repo or _repo_root()
+    qd = os.path.join(repo, ".qoder")
+
+    data = {"_repo": repo, "_ts": datetime.now().isoformat(timespec="seconds")}
+
+    # 1. 开发者身份
+    data["developer"] = _read_text(os.path.join(qd, ".developer")) or "(未设置)"
+
+    # 2. 图谱索引新鲜度
+    meta = _read_json(os.path.join(repo, "data", "index", ".index-meta.json"))
+    data["index_meta"] = meta
+    data["index_age_days"] = _index_freshness(meta)
+
+    # 3. EVA 评估历史 (健康度趋势)
+    data["eval_history"] = _read_jsonl_tail(
+        os.path.join(qd, "learning", "eval-history.jsonl"), n=10)
+
+    # 4. 学习反馈
+    data["feedback_count"] = None
+    fb = os.path.join(qd, "learning", "feedback.jsonl")
+    if os.path.exists(fb):
+        try:
+            with open(fb, encoding="utf-8") as f:
+                data["feedback_count"] = sum(1 for _ in f)
+        except Exception:
+            pass
+
+    # 5. 项目配置 (只取关键摘要, 防过大)
+    cfg = _read_text(os.path.join(qd, "config.yaml"), limit=4000)
+    data["config_summary"] = cfg[:4000] if cfg else None
+
+    # 6. 任务列表 (调 task.py list)
+    task_out, task_ok = _run_script(".qoder/scripts/domain/task/task.py", repo, args=["list"])
+    data["task_list"] = task_out if task_ok else None
+    data["task_list_error"] = None if task_ok else task_out
+
+    # 7. 团队同步状态 (调 team_sync.py status)
+    sync_out, sync_ok = _run_script(".qoder/scripts/domain/task/team_sync.py", repo,
+                                    args=["status"], timeout=15)
+    data["team_sync"] = sync_out if sync_ok else None
+    data["team_sync_error"] = None if sync_ok else sync_out
+
+    # 8. 任务目录结构
+    data["tasks_dir"] = _list_dir(os.path.join(qd, "workspace", "tasks"))
+
+    # 9. 学习模式
+    data["patterns"] = _list_dir(os.path.join(qd, "learning", "patterns"))
+
+    # 10. 成员目录 (团队规模)
+    data["members"] = _list_dir(os.path.join(qd, "workspace", "members"))
+
+    return data
+
+
+def main():
+    repo = sys.argv[1] if len(sys.argv) > 1 else None
+    data = snapshot(repo)
+    print(json.dumps(data, ensure_ascii=False, indent=2, default=str))
+
+
+if __name__ == "__main__":
+    main()

package/templates/qoder/scripts/{report → domain/requirement}/archive_prd.py

@@ -2,9 +2,15 @@
 # -*- coding: utf-8 -*-
 # v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
 import os as _o, sys as _s
-_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+_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
 
 """
 archive_prd.py - PRD 按时间归档到个人工作区
@@ -41,7 +47,7 @@ except (AttributeError, TypeError, OSError, IOError):
 
 # 让 common/ 可被 import（直接当脚本跑时）
 _THIS_DIR = os.path.dirname(os.path.abspath(__file__))
-_COMMON = os.path.join(_THIS_DIR, "common")
+_COMMON = os.path.join(_THIS_DIR, "foundation")
 if _COMMON not in sys.path:
     sys.path.insert(0, _COMMON)