@hupan56/wlkj 2.0.0

package/templates/qoder/scripts/status.py

@@ -0,0 +1,389 @@
+#!/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
+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]),
+    }
+
+
+# ============================================================
+# 健康分 (综合)
+# ============================================================
+
+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%)
+    feedback_path = BASE / '.qoder' / 'learning' / 'feedback.jsonl'
+    if feedback_path.is_file():
+        try:
+            with open(feedback_path, encoding='utf-8') as f:
+                fb_count = sum(1 for _ in f)
+            scores['learning'] = min(5.0, 2.0 + fb_count * 0.1)
+        except Exception:
+            scores['learning'] = 2.0
+    else:
+        scores['learning'] = 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 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})')
+
+    # 健康分
+    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 后才有)')
+
+
+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()