@hupan56/wlkj 2.7.12 → 3.0.0

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

@@ -1,628 +1,634 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-status.py - 项目状态计算引擎 (支撑 /wl-status 命令)
-
-/wl-status 的 markdown 指令由 AI 执行, 但数据计算 (健康分/周期时间/阻塞图/
-截止日期) 由本脚本提供, 保证数据准确。
-
-Usage:
-    python status.py                    # 全景: current + roadmap + health
-    python status.py health             # 只算健康分
-    python status.py cycle              # 只算周期时间 (从 stage_ts)
-    python status.py deadlines [--days 7]  # 未来 N 天的截止任务
-    python status.py blocked            # 被阻塞的任务图
-"""
-
-import argparse
-import json
-import os
-import sys
-from datetime import datetime, date, timedelta
-from pathlib import Path
-
-try:
-    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
-except (AttributeError, TypeError, OSError):
-    pass
-
-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
-
-BASE = get_repo_root()
-INDEX_DIR = BASE / 'data' / 'index'
-
-
-def load_all_tasks():
-    """加载所有活跃任务 (workspace/tasks/)。"""
-    tasks_dir = get_tasks_dir(BASE)
-    if not tasks_dir.is_dir():
-        return {}
-    out = {}
-    for d in tasks_dir.iterdir():
-        if d.is_dir():
-            data = load_task_json(d)
-            if data:
-                out[d.name] = data
-    return out
-
-
-# ============================================================
-# 周期时间分析 (B4: cycle time)
-# ============================================================
-
-def compute_cycle_times(tasks):
-    """从 stage_ts 算各阶段耗时。
-
-    Returns:
-        {
-            "avg_total_hours": float,     # created -> completed 平均
-            "avg_dev_hours": float,       # started -> completed 平均 (纯开发)
-            "samples": int,               # 有完整时间戳的任务数
-            "by_task": [{name, total_h, dev_h, ...}]
-        }
-    """
-    samples = []
-    for name, data in tasks.items():
-        if data.get("status") != "completed":
-            continue
-        ts = data.get("stage_ts") or {}
-        created = ts.get("created")
-        started = ts.get("started")
-        completed = ts.get("completed")
-        if not created or not completed:
-            continue
-        try:
-            t_created = datetime.fromisoformat(created)
-            t_completed = datetime.fromisoformat(completed)
-            total_h = (t_completed - t_created).total_seconds() / 3600
-            dev_h = None
-            if started:
-                t_started = datetime.fromisoformat(started)
-                dev_h = (t_completed - t_started).total_seconds() / 3600
-            samples.append({
-                "name": name,
-                "title": data.get("title", name),
-                "total_hours": round(total_h, 1),
-                "dev_hours": round(dev_h, 1) if dev_h is not None else None,
-            })
-        except (ValueError, TypeError):
-            continue
-
-    if not samples:
-        return {"avg_total_hours": 0, "avg_dev_hours": 0, "samples": 0, "by_task": []}
-
-    avg_total = sum(s["total_hours"] for s in samples) / len(samples)
-    dev_samples = [s for s in samples if s["dev_hours"] is not None]
-    avg_dev = sum(s["dev_hours"] for s in dev_samples) / len(dev_samples) if dev_samples else 0
-
-    return {
-        "avg_total_hours": round(avg_total, 1),
-        "avg_dev_hours": round(avg_dev, 1),
-        "samples": len(samples),
-        "by_task": sorted(samples, key=lambda x: -x["total_hours"])[:10],
-    }
-
-
-# ============================================================
-# 截止日期提醒 (B4: deadlines)
-# ============================================================
-
-def compute_deadlines(tasks, days=7):
-    """未来 N 天内到期的任务 + 已逾期任务。
-
-    Returns:
-        {
-            "overdue": [...],       # 已逾期未完成
-            "due_soon": [...],      # 未来 days 天内到期
-            "no_date_count": int,   # 无截止日期的活跃任务数
-        }
-    """
-    today = date.today()
-    horizon = today + timedelta(days=days)
-    overdue = []
-    due_soon = []
-    no_date = 0
-
-    for name, data in tasks.items():
-        if data.get("status") == "completed":
-            continue
-        due = data.get("due_date")
-        if not due:
-            no_date += 1
-            continue
-        try:
-            due_d = date.fromisoformat(due)
-        except ValueError:
-            continue
-        item = {
-            "name": name,
-            "title": data.get("title", name),
-            "due_date": due,
-            "assignee": data.get("assignee", "?"),
-            "priority": data.get("priority", "?"),
-            "days_left": (due_d - today).days,
-        }
-        if due_d < today:
-            overdue.append(item)
-        elif due_d <= horizon:
-            due_soon.append(item)
-
-    overdue.sort(key=lambda x: x["days_left"])
-    due_soon.sort(key=lambda x: x["days_left"])
-    return {
-        "overdue": overdue,
-        "due_soon": due_soon,
-        "no_date_count": no_date,
-    }
-
-
-# ============================================================
-# 阻塞图 (B4: blocked)
-# ============================================================
-
-def compute_blocked_graph(tasks):
-    """分析任务间的阻塞关系。
-
-    Returns:
-        {
-            "blocked_tasks": [{name, blocked_by: [...open...], title}],
-            "blocking_count": {blocker_name: count},  # 谁阻塞了最多任务
-        }
-    """
-    blocked = []
-    blocking_count = {}
-    for name, data in tasks.items():
-        if data.get("status") == "completed":
-            continue
-        blocked_by = data.get("blocked_by") or []
-        open_blocks = []
-        for dep in blocked_by:
-            dep_data = tasks.get(dep)
-            if not dep_data or dep_data.get("status") != "completed":
-                open_blocks.append(dep)
-                blocking_count[dep] = blocking_count.get(dep, 0) + 1
-        if open_blocks:
-            blocked.append({
-                "name": name,
-                "title": data.get("title", name),
-                "blocked_by": open_blocks,
-                "assignee": data.get("assignee", "?"),
-            })
-    return {
-        "blocked_tasks": blocked,
-        "blocking_count": dict(sorted(blocking_count.items(), key=lambda x: -x[1])[:5]),
-    }
-
-
-# ============================================================
-# 学习数据采集 (扫全部 dev 的 journal, 修旧版路径 bug)
-# ============================================================
-
-def _count_all_feedback():
-    """统计全团队 feedback 事件总数 (扫 workspace/members/*/journal/feedback.jsonl)。
-
-    旧版读 .qoder/learning/feedback.jsonl (已废弃路径, 文件不存在) → 恒 0 → 学习度恒 2.0。
-    learn.py 早已迁移到 workspace/members/{dev}/journal/, 这里跟上。
-    """
-    if not MEMBERS_DIR.is_dir():
-        return 0
-    total = 0
-    for dev_dir in MEMBERS_DIR.iterdir():
-        if not dev_dir.is_dir():
-            continue
-        fb = dev_dir / 'journal' / 'feedback.jsonl'
-        if fb.is_file():
-            try:
-                with open(fb, encoding='utf-8') as f:
-                    total += sum(1 for line in f if line.strip())
-            except Exception:
-                continue
-    return total
-
-
-# ============================================================
-# 健康分 (综合)
-# ============================================================
-
-def compute_health(tasks):
-    """加权健康分 (满分 5)。
-
-    维度: EVA 合格率 / 索引新鲜度 / 按时交付 / 团队同步 / 流水线 / 学习
-    """
-    scores = {}
-
-    # 1. EVA 合格率 (25%)
-    # eval-history 是 jsonl (每行一个 JSON), 不能用 safe_read_json
-    eval_path = BASE / '.qoder' / 'learning' / 'eval-history.jsonl'
-    if eval_path.is_file():
-        records = []
-        try:
-            with open(eval_path, encoding='utf-8') as f:
-                for line in f:
-                    line = line.strip()
-                    if line:
-                        records.append(json.loads(line))
-            recent = records[-10:]
-            if recent:
-                passed = sum(1 for r in recent if r.get('passed'))
-                scores['eva'] = (passed / len(recent)) * 5
-            else:
-                scores['eva'] = 3.0  # 无数据, 中性
-        except Exception:
-            scores['eva'] = 3.0
-    else:
-        scores['eva'] = 3.0
-
-    # 2. 索引新鲜度 (20%)
-    meta = safe_read_json(INDEX_DIR / '.index-meta.json', default={}) or {}
-    last_sync = meta.get('last_sync', '')
-    try:
-        ts = str(last_sync).replace('T', ' ').split('.')[0].strip()
-        sync_dt = datetime.strptime(ts, '%Y-%m-%d %H:%M')
-        age_days = (datetime.now() - sync_dt).days
-        if age_days <= 7:
-            scores['index'] = 5.0
-        elif age_days <= 14:
-            scores['index'] = 3.0
-        else:
-            scores['index'] = 1.0
-    except Exception:
-        scores['index'] = 2.0
-
-    # 3. 按时交付 (20%) - 从 deadlines 算逾期率
-    deadlines = compute_deadlines(tasks, days=0)
-    total_with_due = len(deadlines['overdue']) + len(deadlines['due_soon']) + 1
-    overdue_rate = len(deadlines['overdue']) / total_with_due if total_with_due else 0
-    scores['on_time'] = max(0, 5 - overdue_rate * 10)
-
-    # 4. 团队同步 (15%) - 简化: 有 ahead 提交 = 有未同步
-    scores['sync'] = 4.0  # 默认良好 (详细检查由 team_sync status 做)
-
-    # 5. 流水线流转 (10%) - 任务在各阶段分布
-    statuses = {}
-    for data in tasks.values():
-        s = data.get('status', '?')
-        statuses[s] = statuses.get(s, 0) + 1
-    # 有 in_progress 且不全卡 planning = 健康
-    if statuses.get('in_progress', 0) > 0:
-        scores['pipeline'] = 4.0
-    elif statuses.get('planning', 0) > 0:
-        scores['pipeline'] = 3.0
-    else:
-        scores['pipeline'] = 2.0
-
-    # 6. 学习 (10%)
-    # 修 bug: 旧代码读 .qoder/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
-
-    # 加权
-    weights = {
-        'eva': 0.25, 'index': 0.20, 'on_time': 0.20,
-        'sync': 0.15, 'pipeline': 0.10, 'learning': 0.10,
-    }
-    total = sum(scores[k] * weights[k] for k in weights)
-    return {
-        'total': round(total, 2),
-        'scores': scores,
-        'weights': weights,
-        'verdict': '健康' if total >= 4 else ('有风险' if total >= 3 else '需关注'),
-    }
-
-
-# ============================================================
-# 流水线自检 (测工具本身, 不测产出) —— 可观测性闭环
-# ============================================================
-
-def _scan_skill_instrumentation():
-    """扫 .qoder/skills/*/SKILL.md, 统计有多少 skill 调了 learn.py record (已埋点)。
-    返回 (已埋点skill列表, 全部skill列表)。
-    """
-    skills_dir = BASE / '.qoder' / 'skills'
-    if not skills_dir.is_dir():
-        return [], []
-    all_skills = []
-    instrumented = []
-    for d in sorted(skills_dir.iterdir()):
-        if not d.is_dir():
-            continue
-        skill_md = d / 'SKILL.md'
-        if not skill_md.is_file():
-            continue
-        all_skills.append(d.name)
-        try:
-            text = skill_md.read_text(encoding='utf-8', errors='ignore')
-        except Exception:
-            continue
-        if 'learn.py' in text and 'record' in text:
-            instrumented.append(d.name)
-    return instrumented, all_skills
-
-
-def _analyze_eva_rounds():
-    """从 eval-history.jsonl 分析 EVA 修正轮数。
-    返回 {samples, rework_count, avg_rounds}。
-    rework = 连续 passed=false 后出现 passed=true 的序列。
-    """
-    eval_path = BASE / '.qoder' / 'learning' / 'eval-history.jsonl'
-    if not eval_path.is_file():
-        return {'samples': 0, 'rework_count': 0, 'avg_rounds': 0}
-    records = []
-    try:
-        with open(eval_path, encoding='utf-8') as f:
-            for line in f:
-                line = line.strip()
-                if line:
-                    try:
-                        records.append(json.loads(line))
-                    except Exception:
-                        continue
-    except Exception:
-        return {'samples': 0, 'rework_count': 0, 'avg_rounds': 0}
-
-    recent = records[-20:]
-    rework = 0
-    total_fail_before_pass = 0
-    fails_in_run = 0
-    for r in recent:
-        if r.get('passed'):
-            if fails_in_run > 0:
-                rework += 1
-                total_fail_before_pass += fails_in_run
-            fails_in_run = 0
-        else:
-            fails_in_run += 1
-    avg_rounds = (total_fail_before_pass / rework + 1) if rework else 0
-    return {
-        'samples': len(recent),
-        'rework_count': rework,
-        'avg_rounds': round(avg_rounds, 1),
-    }
-
-
-def _count_rule_violations():
-    """统计规则违规事件 (没问平台就调脚本)。
-    扫全部 dev 的 journal 里 event=rule_violation 的条数。
-    """
-    if not MEMBERS_DIR.is_dir():
-        return 0
-    count = 0
-    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
-                    try:
-                        if json.loads(line).get('event') == 'rule_violation':
-                            count += 1
-                    except Exception:
-                        continue
-        except Exception:
-            continue
-    return count
-
-
-def compute_pipeline_self():
-    """流水线自检 —— 4 个指标全从已有数据派生, 不增加 PM 操作。
-
-    返回:
-      instrumentation: {done, total, missing}   埋点覆盖率
-      eva: {samples, rework_count, avg_rounds}  EVA 修正轮数
-      violations: int                            规则违规次数
-      verdict: str                               一句话结论
-    """
-    done, total = _scan_skill_instrumentation()
-    missing = [s for s in total if s not in done]
-    eva = _analyze_eva_rounds()
-    violations = _count_rule_violations()
-
-    parts = []
-    cov_pct = (len(done) / len(total) * 100) if total else 0
-    if cov_pct < 50:
-        parts.append('埋点覆盖偏低')
-    if eva['rework_count'] > 0 and eva['avg_rounds'] > 2:
-        parts.append('EVA 修正轮数偏高')
-    if violations > 0:
-        parts.append('存在规则违规')
-    verdict = '；'.join(parts) if parts else '正常'
-
-    return {
-        'instrumentation': {'done': len(done), 'total': len(total),
-                            'missing': missing, 'pct': round(cov_pct)},
-        'eva': eva,
-        'violations': violations,
-        'verdict': verdict,
-    }
-
-
-# ============================================================
-# 角色引导 (该角色该用哪些命令 —— 软引导, 帮新人快速上手)
-# ============================================================
-
-def compute_role_guide():
-    """读当前角色 + config.yaml 的 commands 映射, 返回该角色的建议命令。
-    软引导: 不拦截任何命令, 只是把"你该用什么"摆出来。
-    """
-    # 当前角色 (role.py 的 get_role 逻辑)
-    role = None
-    try:
-        sys.path.insert(0, str(BASE / '.qoder' / 'scripts'))
-        from role import get_role
-        role = get_role()
-    except Exception:
-        pass
-    if not role:
-        role = 'pm'  # 默认
-
-    # 读 config.yaml 的 commands 映射
-    commands = []
-    role_name = role
-    try:
-        import yaml
-        cfg_path = BASE / '.qoder' / 'config.yaml'
-        if cfg_path.is_file():
-            with open(cfg_path, encoding='utf-8') as f:
-                cfg = yaml.safe_load(f) or {}
-            roles = cfg.get('roles', {})
-            rinfo = roles.get(role, {})
-            commands = rinfo.get('commands', [])
-            role_name = rinfo.get('name', role)
-    except Exception:
-        pass
-
-    # 校验建议命令是否真实存在 (command 文件在不在)
-    available = []
-    missing = []
-    cmds_dir = BASE / '.qoder' / 'commands'
-    for cmd in commands:
-        exists = (cmds_dir / (cmd + '.md')).is_file() or \
-                 (cmds_dir / 'optional' / (cmd + '.md')).is_file()
-        (available if exists else missing).append(cmd)
-
-    return {
-        'role': role,
-        'role_name': role_name,
-        'suggested': commands,
-        'available': available,
-        'missing': missing,
-    }
-
-
-# ============================================================
-# 渲染
-# ============================================================
-
-def render_full():
-    tasks = load_all_tasks()
-    print('=' * 50)
-    print('项目状态总览')
-    print('=' * 50)
-    print(f'\n活跃任务: {len(tasks)} 个')
-    dev = get_developer(BASE)
-    if dev:
-        my_tasks = [n for n, d in tasks.items() if dev in (d.get('assignee'), d.get('creator'))]
-        print(f'我的任务: {len(my_tasks)} 个 (开发者: {dev})')
-
-    # 角色引导 (该角色该用哪些命令)
-    rg = compute_role_guide()
-    print(f'当前角色: {rg["role_name"]} ({rg["role"]})')
-    if rg['suggested']:
-        # 标注哪些命令当前可用
-        avail = rg['available']
-        print(f'  建议命令 ({len(avail)}/{len(rg["suggested"])} 可用): '
-              + ' '.join('/' + c for c in avail))
-        if rg['missing']:
-            print(f'  ⚠ 建议但未安装: {", ".join(rg["missing"])}')
-
-    # 健康分
-    print('\n--- 健康度 ---')
-    health = compute_health(tasks)
-    print(f"总分: {health['total']}/5 ({health['verdict']})")
-    for k, v in health['scores'].items():
-        w = health['weights'][k]
-        print(f"  {k:12} {v:.1f} × {w:.0%}")
-
-    # 阻塞
-    print('\n--- 阻塞图 ---')
-    bg = compute_blocked_graph(tasks)
-    if bg['blocked_tasks']:
-        print(f"被阻塞的任务: {len(bg['blocked_tasks'])} 个")
-        for bt in bg['blocked_tasks'][:10]:
-            print(f"  {bt['name']} ({bt['assignee']}) <- {', '.join(bt['blocked_by'])}")
-        if bg['blocking_count']:
-            print(f"阻塞最多的: {bg['blocking_count']}")
-    else:
-        print('无被阻塞的任务')
-
-    # 截止日期
-    print('\n--- 截止日期 (未来 7 天) ---')
-    dl = compute_deadlines(tasks, days=7)
-    if dl['overdue']:
-        print(f"⚠️ 已逾期: {len(dl['overdue'])} 个")
-        for item in dl['overdue'][:5]:
-            print(f"  {item['name']} ({item['days_left']}天前) [{item['priority']}] {item['title']}")
-    if dl['due_soon']:
-        print(f"即将到期: {len(dl['due_soon'])} 个")
-        for item in dl['due_soon'][:5]:
-            print(f"  {item['name']} (还剩{item['days_left']}天) [{item['priority']}] {item['title']}")
-    if not dl['overdue'] and not dl['due_soon']:
-        print('未来 7 天无截止任务')
-    print(f"无截止日期的活跃任务: {dl['no_date_count']} 个")
-
-    # 周期时间
-    print('\n--- 周期时间 ---')
-    ct = compute_cycle_times(tasks)
-    if ct['samples'] > 0:
-        print(f"已完成样本: {ct['samples']} 个")
-        print(f"平均总周期: {ct['avg_total_hours']} 小时 ({ct['avg_total_hours']/24:.1f} 天)")
-        print(f"平均开发时长: {ct['avg_dev_hours']} 小时")
-        if ct['by_task']:
-            print("最慢的 5 个:")
-            for s in ct['by_task'][:5]:
-                print(f"  {s['name']}: {s['total_hours']}h (开发 {s['dev_hours']}h)")
-    else:
-        print('暂无已完成任务的时间戳数据 (stage_ts 在 B3 后才有)')
-
-    # 流水线自检 (测工具本身)
-    print('\n--- 流水线自检 (测工具本身) ---')
-    ps = compute_pipeline_self()
-    inst = ps['instrumentation']
-    cov_mark = '✓' if inst['pct'] >= 50 else '⚠'
-    print(f"  埋点覆盖: {inst['done']}/{inst['total']} skill ({inst['pct']}%) {cov_mark}")
-    if inst['missing']:
-        # 只列前 5 个, 避免刷屏
-        shown = inst['missing'][:5]
-        more = '' if len(inst['missing']) <= 5 else f" 等{len(inst['missing'])}个"
-        print(f"    缺埋点: {', '.join(shown)}{more}")
-    eva = ps['eva']
-    if eva['samples'] > 0:
-        eva_mark = '✓' if eva['avg_rounds'] <= 2 else '⚠'
-        print(f"  EVA 修正: 近{eva['samples']}次 {eva['rework_count']}次打回, "
-              f"平均{eva['avg_rounds']}轮过 {eva_mark}")
-    else:
-        print('  EVA 修正: 暂无评估历史')
-    v_mark = '✓' if ps['violations'] == 0 else '⚠'
-    print(f"  规则违规: {ps['violations']} 次 {v_mark}")
-    print(f"  自检结论: {ps['verdict']}")
-
-
-def main():
-    parser = argparse.ArgumentParser(description='项目状态计算')
-    parser.add_argument('scope', nargs='?', default='all',
-                        choices=['all', 'health', 'cycle', 'deadlines', 'blocked'])
-    parser.add_argument('--days', type=int, default=7, help='截止日期 horizon 天数')
-    args = parser.parse_args()
-
-    tasks = load_all_tasks()
-
-    if args.scope == 'health':
-        h = compute_health(tasks)
-        print(json.dumps(h, indent=2, ensure_ascii=False))
-    elif args.scope == 'cycle':
-        c = compute_cycle_times(tasks)
-        print(json.dumps(c, indent=2, ensure_ascii=False))
-    elif args.scope == 'deadlines':
-        d = compute_deadlines(tasks, args.days)
-        print(json.dumps(d, indent=2, ensure_ascii=False))
-    elif args.scope == 'blocked':
-        b = compute_blocked_graph(tasks)
-        print(json.dumps(b, indent=2, ensure_ascii=False))
-    else:
-        render_full()
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python3
+# -*- 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')
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
+"""
+status.py - 项目状态计算引擎 (支撑 /wl-status 命令)
+
+/wl-status 的 markdown 指令由 AI 执行, 但数据计算 (健康分/周期时间/阻塞图/
+截止日期) 由本脚本提供, 保证数据准确。
+
+Usage:
+    python status.py                    # 全景: current + roadmap + health
+    python status.py health             # 只算健康分
+    python status.py cycle              # 只算周期时间 (从 stage_ts)
+    python status.py deadlines [--days 7]  # 未来 N 天的截止任务
+    python status.py blocked            # 被阻塞的任务图
+"""
+
+import argparse
+import json
+import os
+import sys
+from datetime import datetime, date, timedelta
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+except (AttributeError, TypeError, OSError):
+    pass
+
+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
+
+BASE = get_repo_root()
+INDEX_DIR = BASE / 'data' / 'index'
+
+
+def load_all_tasks():
+    """加载所有活跃任务 (workspace/tasks/)。"""
+    tasks_dir = get_tasks_dir(BASE)
+    if not tasks_dir.is_dir():
+        return {}
+    out = {}
+    for d in tasks_dir.iterdir():
+        if d.is_dir():
+            data = load_task_json(d)
+            if data:
+                out[d.name] = data
+    return out
+
+
+# ============================================================
+# 周期时间分析 (B4: cycle time)
+# ============================================================
+
+def compute_cycle_times(tasks):
+    """从 stage_ts 算各阶段耗时。
+
+    Returns:
+        {
+            "avg_total_hours": float,     # created -> completed 平均
+            "avg_dev_hours": float,       # started -> completed 平均 (纯开发)
+            "samples": int,               # 有完整时间戳的任务数
+            "by_task": [{name, total_h, dev_h, ...}]
+        }
+    """
+    samples = []
+    for name, data in tasks.items():
+        if data.get("status") != "completed":
+            continue
+        ts = data.get("stage_ts") or {}
+        created = ts.get("created")
+        started = ts.get("started")
+        completed = ts.get("completed")
+        if not created or not completed:
+            continue
+        try:
+            t_created = datetime.fromisoformat(created)
+            t_completed = datetime.fromisoformat(completed)
+            total_h = (t_completed - t_created).total_seconds() / 3600
+            dev_h = None
+            if started:
+                t_started = datetime.fromisoformat(started)
+                dev_h = (t_completed - t_started).total_seconds() / 3600
+            samples.append({
+                "name": name,
+                "title": data.get("title", name),
+                "total_hours": round(total_h, 1),
+                "dev_hours": round(dev_h, 1) if dev_h is not None else None,
+            })
+        except (ValueError, TypeError):
+            continue
+
+    if not samples:
+        return {"avg_total_hours": 0, "avg_dev_hours": 0, "samples": 0, "by_task": []}
+
+    avg_total = sum(s["total_hours"] for s in samples) / len(samples)
+    dev_samples = [s for s in samples if s["dev_hours"] is not None]
+    avg_dev = sum(s["dev_hours"] for s in dev_samples) / len(dev_samples) if dev_samples else 0
+
+    return {
+        "avg_total_hours": round(avg_total, 1),
+        "avg_dev_hours": round(avg_dev, 1),
+        "samples": len(samples),
+        "by_task": sorted(samples, key=lambda x: -x["total_hours"])[:10],
+    }
+
+
+# ============================================================
+# 截止日期提醒 (B4: deadlines)
+# ============================================================
+
+def compute_deadlines(tasks, days=7):
+    """未来 N 天内到期的任务 + 已逾期任务。
+
+    Returns:
+        {
+            "overdue": [...],       # 已逾期未完成
+            "due_soon": [...],      # 未来 days 天内到期
+            "no_date_count": int,   # 无截止日期的活跃任务数
+        }
+    """
+    today = date.today()
+    horizon = today + timedelta(days=days)
+    overdue = []
+    due_soon = []
+    no_date = 0
+
+    for name, data in tasks.items():
+        if data.get("status") == "completed":
+            continue
+        due = data.get("due_date")
+        if not due:
+            no_date += 1
+            continue
+        try:
+            due_d = date.fromisoformat(due)
+        except ValueError:
+            continue
+        item = {
+            "name": name,
+            "title": data.get("title", name),
+            "due_date": due,
+            "assignee": data.get("assignee", "?"),
+            "priority": data.get("priority", "?"),
+            "days_left": (due_d - today).days,
+        }
+        if due_d < today:
+            overdue.append(item)
+        elif due_d <= horizon:
+            due_soon.append(item)
+
+    overdue.sort(key=lambda x: x["days_left"])
+    due_soon.sort(key=lambda x: x["days_left"])
+    return {
+        "overdue": overdue,
+        "due_soon": due_soon,
+        "no_date_count": no_date,
+    }
+
+
+# ============================================================
+# 阻塞图 (B4: blocked)
+# ============================================================
+
+def compute_blocked_graph(tasks):
+    """分析任务间的阻塞关系。
+
+    Returns:
+        {
+            "blocked_tasks": [{name, blocked_by: [...open...], title}],
+            "blocking_count": {blocker_name: count},  # 谁阻塞了最多任务
+        }
+    """
+    blocked = []
+    blocking_count = {}
+    for name, data in tasks.items():
+        if data.get("status") == "completed":
+            continue
+        blocked_by = data.get("blocked_by") or []
+        open_blocks = []
+        for dep in blocked_by:
+            dep_data = tasks.get(dep)
+            if not dep_data or dep_data.get("status") != "completed":
+                open_blocks.append(dep)
+                blocking_count[dep] = blocking_count.get(dep, 0) + 1
+        if open_blocks:
+            blocked.append({
+                "name": name,
+                "title": data.get("title", name),
+                "blocked_by": open_blocks,
+                "assignee": data.get("assignee", "?"),
+            })
+    return {
+        "blocked_tasks": blocked,
+        "blocking_count": dict(sorted(blocking_count.items(), key=lambda x: -x[1])[:5]),
+    }
+
+
+# ============================================================
+# 学习数据采集 (扫全部 dev 的 journal, 修旧版路径 bug)
+# ============================================================
+
+def _count_all_feedback():
+    """统计全团队 feedback 事件总数 (扫 workspace/members/*/journal/feedback.jsonl)。
+
+    旧版读 data/learning/feedback.jsonl (已废弃路径, 文件不存在) → 恒 0 → 学习度恒 2.0。
+    learn.py 早已迁移到 workspace/members/{dev}/journal/, 这里跟上。
+    """
+    if not MEMBERS_DIR.is_dir():
+        return 0
+    total = 0
+    for dev_dir in MEMBERS_DIR.iterdir():
+        if not dev_dir.is_dir():
+            continue
+        fb = dev_dir / 'journal' / 'feedback.jsonl'
+        if fb.is_file():
+            try:
+                with open(fb, encoding='utf-8') as f:
+                    total += sum(1 for line in f if line.strip())
+            except Exception:
+                continue
+    return total
+
+
+# ============================================================
+# 健康分 (综合)
+# ============================================================
+
+def compute_health(tasks):
+    """加权健康分 (满分 5)。
+
+    维度: EVA 合格率 / 索引新鲜度 / 按时交付 / 团队同步 / 流水线 / 学习
+    """
+    scores = {}
+
+    # 1. EVA 合格率 (25%)
+    # eval-history 是 jsonl (每行一个 JSON), 不能用 safe_read_json
+    eval_path = BASE / '.qoder' / 'learning' / 'eval-history.jsonl'
+    if eval_path.is_file():
+        records = []
+        try:
+            with open(eval_path, encoding='utf-8') as f:
+                for line in f:
+                    line = line.strip()
+                    if line:
+                        records.append(json.loads(line))
+            recent = records[-10:]
+            if recent:
+                passed = sum(1 for r in recent if r.get('passed'))
+                scores['eva'] = (passed / len(recent)) * 5
+            else:
+                scores['eva'] = 3.0  # 无数据, 中性
+        except Exception:
+            scores['eva'] = 3.0
+    else:
+        scores['eva'] = 3.0
+
+    # 2. 索引新鲜度 (20%)
+    meta = safe_read_json(INDEX_DIR / '.index-meta.json', default={}) or {}
+    last_sync = meta.get('last_sync', '')
+    try:
+        ts = str(last_sync).replace('T', ' ').split('.')[0].strip()
+        sync_dt = datetime.strptime(ts, '%Y-%m-%d %H:%M')
+        age_days = (datetime.now() - sync_dt).days
+        if age_days <= 7:
+            scores['index'] = 5.0
+        elif age_days <= 14:
+            scores['index'] = 3.0
+        else:
+            scores['index'] = 1.0
+    except Exception:
+        scores['index'] = 2.0
+
+    # 3. 按时交付 (20%) - 从 deadlines 算逾期率
+    deadlines = compute_deadlines(tasks, days=0)
+    total_with_due = len(deadlines['overdue']) + len(deadlines['due_soon']) + 1
+    overdue_rate = len(deadlines['overdue']) / total_with_due if total_with_due else 0
+    scores['on_time'] = max(0, 5 - overdue_rate * 10)
+
+    # 4. 团队同步 (15%) - 简化: 有 ahead 提交 = 有未同步
+    scores['sync'] = 4.0  # 默认良好 (详细检查由 team_sync status 做)
+
+    # 5. 流水线流转 (10%) - 任务在各阶段分布
+    statuses = {}
+    for data in tasks.values():
+        s = data.get('status', '?')
+        statuses[s] = statuses.get(s, 0) + 1
+    # 有 in_progress 且不全卡 planning = 健康
+    if statuses.get('in_progress', 0) > 0:
+        scores['pipeline'] = 4.0
+    elif statuses.get('planning', 0) > 0:
+        scores['pipeline'] = 3.0
+    else:
+        scores['pipeline'] = 2.0
+
+    # 6. 学习 (10%)
+    # 修 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
+
+    # 加权
+    weights = {
+        'eva': 0.25, 'index': 0.20, 'on_time': 0.20,
+        'sync': 0.15, 'pipeline': 0.10, 'learning': 0.10,
+    }
+    total = sum(scores[k] * weights[k] for k in weights)
+    return {
+        'total': round(total, 2),
+        'scores': scores,
+        'weights': weights,
+        'verdict': '健康' if total >= 4 else ('有风险' if total >= 3 else '需关注'),
+    }
+
+
+# ============================================================
+# 流水线自检 (测工具本身, 不测产出) —— 可观测性闭环
+# ============================================================
+
+def _scan_skill_instrumentation():
+    """扫 .qoder/skills/*/SKILL.md, 统计有多少 skill 调了 learn.py record (已埋点)。
+    返回 (已埋点skill列表, 全部skill列表)。
+    """
+    skills_dir = BASE / '.qoder' / 'skills'
+    if not skills_dir.is_dir():
+        return [], []
+    all_skills = []
+    instrumented = []
+    for d in sorted(skills_dir.iterdir()):
+        if not d.is_dir():
+            continue
+        skill_md = d / 'SKILL.md'
+        if not skill_md.is_file():
+            continue
+        all_skills.append(d.name)
+        try:
+            text = skill_md.read_text(encoding='utf-8', errors='ignore')
+        except Exception:
+            continue
+        if 'learn.py' in text and 'record' in text:
+            instrumented.append(d.name)
+    return instrumented, all_skills
+
+
+def _analyze_eva_rounds():
+    """从 eval-history.jsonl 分析 EVA 修正轮数。
+    返回 {samples, rework_count, avg_rounds}。
+    rework = 连续 passed=false 后出现 passed=true 的序列。
+    """
+    eval_path = BASE / '.qoder' / 'learning' / 'eval-history.jsonl'
+    if not eval_path.is_file():
+        return {'samples': 0, 'rework_count': 0, 'avg_rounds': 0}
+    records = []
+    try:
+        with open(eval_path, encoding='utf-8') as f:
+            for line in f:
+                line = line.strip()
+                if line:
+                    try:
+                        records.append(json.loads(line))
+                    except Exception:
+                        continue
+    except Exception:
+        return {'samples': 0, 'rework_count': 0, 'avg_rounds': 0}
+
+    recent = records[-20:]
+    rework = 0
+    total_fail_before_pass = 0
+    fails_in_run = 0
+    for r in recent:
+        if r.get('passed'):
+            if fails_in_run > 0:
+                rework += 1
+                total_fail_before_pass += fails_in_run
+            fails_in_run = 0
+        else:
+            fails_in_run += 1
+    avg_rounds = (total_fail_before_pass / rework + 1) if rework else 0
+    return {
+        'samples': len(recent),
+        'rework_count': rework,
+        'avg_rounds': round(avg_rounds, 1),
+    }
+
+
+def _count_rule_violations():
+    """统计规则违规事件 (没问平台就调脚本)。
+    扫全部 dev 的 journal 里 event=rule_violation 的条数。
+    """
+    if not MEMBERS_DIR.is_dir():
+        return 0
+    count = 0
+    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
+                    try:
+                        if json.loads(line).get('event') == 'rule_violation':
+                            count += 1
+                    except Exception:
+                        continue
+        except Exception:
+            continue
+    return count
+
+
+def compute_pipeline_self():
+    """流水线自检 —— 4 个指标全从已有数据派生, 不增加 PM 操作。
+
+    返回:
+      instrumentation: {done, total, missing}   埋点覆盖率
+      eva: {samples, rework_count, avg_rounds}  EVA 修正轮数
+      violations: int                            规则违规次数
+      verdict: str                               一句话结论
+    """
+    done, total = _scan_skill_instrumentation()
+    missing = [s for s in total if s not in done]
+    eva = _analyze_eva_rounds()
+    violations = _count_rule_violations()
+
+    parts = []
+    cov_pct = (len(done) / len(total) * 100) if total else 0
+    if cov_pct < 50:
+        parts.append('埋点覆盖偏低')
+    if eva['rework_count'] > 0 and eva['avg_rounds'] > 2:
+        parts.append('EVA 修正轮数偏高')
+    if violations > 0:
+        parts.append('存在规则违规')
+    verdict = '；'.join(parts) if parts else '正常'
+
+    return {
+        'instrumentation': {'done': len(done), 'total': len(total),
+                            'missing': missing, 'pct': round(cov_pct)},
+        'eva': eva,
+        'violations': violations,
+        'verdict': verdict,
+    }
+
+
+# ============================================================
+# 角色引导 (该角色该用哪些命令 —— 软引导, 帮新人快速上手)
+# ============================================================
+
+def compute_role_guide():
+    """读当前角色 + config.yaml 的 commands 映射, 返回该角色的建议命令。
+    软引导: 不拦截任何命令, 只是把"你该用什么"摆出来。
+    """
+    # 当前角色 (v3.0: 角色能力已并入 common/identity.py)
+    role = None
+    try:
+        sys.path.insert(0, str(BASE / '.qoder' / 'scripts'))
+        from common.identity import get_role
+        role = get_role()
+    except Exception:
+        pass
+    if not role:
+        role = 'pm'  # 默认
+
+    # 读 config.yaml 的 commands 映射
+    commands = []
+    role_name = role
+    try:
+        import yaml
+        cfg_path = BASE / '.qoder' / 'config.yaml'
+        if cfg_path.is_file():
+            with open(cfg_path, encoding='utf-8') as f:
+                cfg = yaml.safe_load(f) or {}
+            roles = cfg.get('roles', {})
+            rinfo = roles.get(role, {})
+            commands = rinfo.get('commands', [])
+            role_name = rinfo.get('name', role)
+    except Exception:
+        pass
+
+    # 校验建议命令是否真实存在 (command 文件在不在)
+    available = []
+    missing = []
+    cmds_dir = BASE / '.qoder' / 'commands'
+    for cmd in commands:
+        exists = (cmds_dir / (cmd + '.md')).is_file() or \
+                 (cmds_dir / 'optional' / (cmd + '.md')).is_file()
+        (available if exists else missing).append(cmd)
+
+    return {
+        'role': role,
+        'role_name': role_name,
+        'suggested': commands,
+        'available': available,
+        'missing': missing,
+    }
+
+
+# ============================================================
+# 渲染
+# ============================================================
+
+def render_full():
+    tasks = load_all_tasks()
+    print('=' * 50)
+    print('项目状态总览')
+    print('=' * 50)
+    print(f'\n活跃任务: {len(tasks)} 个')
+    dev = get_developer(BASE)
+    if dev:
+        my_tasks = [n for n, d in tasks.items() if dev in (d.get('assignee'), d.get('creator'))]
+        print(f'我的任务: {len(my_tasks)} 个 (开发者: {dev})')
+
+    # 角色引导 (该角色该用哪些命令)
+    rg = compute_role_guide()
+    print(f'当前角色: {rg["role_name"]} ({rg["role"]})')
+    if rg['suggested']:
+        # 标注哪些命令当前可用
+        avail = rg['available']
+        print(f'  建议命令 ({len(avail)}/{len(rg["suggested"])} 可用): '
+              + ' '.join('/' + c for c in avail))
+        if rg['missing']:
+            print(f'  ⚠ 建议但未安装: {", ".join(rg["missing"])}')
+
+    # 健康分
+    print('\n--- 健康度 ---')
+    health = compute_health(tasks)
+    print(f"总分: {health['total']}/5 ({health['verdict']})")
+    for k, v in health['scores'].items():
+        w = health['weights'][k]
+        print(f"  {k:12} {v:.1f} × {w:.0%}")
+
+    # 阻塞
+    print('\n--- 阻塞图 ---')
+    bg = compute_blocked_graph(tasks)
+    if bg['blocked_tasks']:
+        print(f"被阻塞的任务: {len(bg['blocked_tasks'])} 个")
+        for bt in bg['blocked_tasks'][:10]:
+            print(f"  {bt['name']} ({bt['assignee']}) <- {', '.join(bt['blocked_by'])}")
+        if bg['blocking_count']:
+            print(f"阻塞最多的: {bg['blocking_count']}")
+    else:
+        print('无被阻塞的任务')
+
+    # 截止日期
+    print('\n--- 截止日期 (未来 7 天) ---')
+    dl = compute_deadlines(tasks, days=7)
+    if dl['overdue']:
+        print(f"⚠️ 已逾期: {len(dl['overdue'])} 个")
+        for item in dl['overdue'][:5]:
+            print(f"  {item['name']} ({item['days_left']}天前) [{item['priority']}] {item['title']}")
+    if dl['due_soon']:
+        print(f"即将到期: {len(dl['due_soon'])} 个")
+        for item in dl['due_soon'][:5]:
+            print(f"  {item['name']} (还剩{item['days_left']}天) [{item['priority']}] {item['title']}")
+    if not dl['overdue'] and not dl['due_soon']:
+        print('未来 7 天无截止任务')
+    print(f"无截止日期的活跃任务: {dl['no_date_count']} 个")
+
+    # 周期时间
+    print('\n--- 周期时间 ---')
+    ct = compute_cycle_times(tasks)
+    if ct['samples'] > 0:
+        print(f"已完成样本: {ct['samples']} 个")
+        print(f"平均总周期: {ct['avg_total_hours']} 小时 ({ct['avg_total_hours']/24:.1f} 天)")
+        print(f"平均开发时长: {ct['avg_dev_hours']} 小时")
+        if ct['by_task']:
+            print("最慢的 5 个:")
+            for s in ct['by_task'][:5]:
+                print(f"  {s['name']}: {s['total_hours']}h (开发 {s['dev_hours']}h)")
+    else:
+        print('暂无已完成任务的时间戳数据 (stage_ts 在 B3 后才有)')
+
+    # 流水线自检 (测工具本身)
+    print('\n--- 流水线自检 (测工具本身) ---')
+    ps = compute_pipeline_self()
+    inst = ps['instrumentation']
+    cov_mark = '✓' if inst['pct'] >= 50 else '⚠'
+    print(f"  埋点覆盖: {inst['done']}/{inst['total']} skill ({inst['pct']}%) {cov_mark}")
+    if inst['missing']:
+        # 只列前 5 个, 避免刷屏
+        shown = inst['missing'][:5]
+        more = '' if len(inst['missing']) <= 5 else f" 等{len(inst['missing'])}个"
+        print(f"    缺埋点: {', '.join(shown)}{more}")
+    eva = ps['eva']
+    if eva['samples'] > 0:
+        eva_mark = '✓' if eva['avg_rounds'] <= 2 else '⚠'
+        print(f"  EVA 修正: 近{eva['samples']}次 {eva['rework_count']}次打回, "
+              f"平均{eva['avg_rounds']}轮过 {eva_mark}")
+    else:
+        print('  EVA 修正: 暂无评估历史')
+    v_mark = '✓' if ps['violations'] == 0 else '⚠'
+    print(f"  规则违规: {ps['violations']} 次 {v_mark}")
+    print(f"  自检结论: {ps['verdict']}")
+
+
+def main():
+    parser = argparse.ArgumentParser(description='项目状态计算')
+    parser.add_argument('scope', nargs='?', default='all',
+                        choices=['all', 'health', 'cycle', 'deadlines', 'blocked'])
+    parser.add_argument('--days', type=int, default=7, help='截止日期 horizon 天数')
+    args = parser.parse_args()
+
+    tasks = load_all_tasks()
+
+    if args.scope == 'health':
+        h = compute_health(tasks)
+        print(json.dumps(h, indent=2, ensure_ascii=False))
+    elif args.scope == 'cycle':
+        c = compute_cycle_times(tasks)
+        print(json.dumps(c, indent=2, ensure_ascii=False))
+    elif args.scope == 'deadlines':
+        d = compute_deadlines(tasks, args.days)
+        print(json.dumps(d, indent=2, ensure_ascii=False))
+    elif args.scope == 'blocked':
+        b = compute_blocked_graph(tasks)
+        print(json.dumps(b, indent=2, ensure_ascii=False))
+    else:
+        render_full()
+
+
+if __name__ == '__main__':
+    main()