@hupan56/wlkj 2.7.12 → 3.0.0

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

@@ -1,281 +1,287 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-report.py - 工作日报/周报生成 + 飞书推送 (阶段 D3)
-
-支撑 /wl-report 命令的数据生成。AI 执行 markdown 指令, 本脚本提供数据。
-
-Usage:
-    python report.py daily                    # 生成今日日报 (打印)
-    python report.py weekly                   # 生成本周周报 (打印)
-    python report.py daily --push-feishu      # 生成并推送到飞书
-    python report.py weekly --push-feishu
-
-输出: 中文格式, 保存到 workspace/members/{dev}/journal/
-"""
-
-import argparse
-import os
-import subprocess
-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
-
-BASE = get_repo_root()
-
-
-def _ensure_developer():
-    """必须有开发者身份。"""
-    dev = get_developer(BASE)
-    if not dev:
-        print('[ERROR] 未设置开发者身份。先跑 /wl-init 注册。', file=sys.stderr)
-        sys.exit(4)
-    return dev
-
-
-def _git_commits(dev: str, since_date: str) -> list:
-    """获取开发者指定日期后的 git 提交。"""
-    try:
-        r = subprocess.run(
-            ['git', 'log', '--author', dev, '--since', since_date,
-             '--pretty=format:%h|%s|%ar', '--no-merges'],
-            capture_output=True, text=True, encoding='utf-8', errors='replace',
-            cwd=str(BASE),
-        )
-        if r.returncode != 0:
-            return []
-        commits = []
-        for line in r.stdout.strip().splitlines():
-            parts = line.split('|', 2)
-            if len(parts) == 3:
-                commits.append({'hash': parts[0], 'msg': parts[1], 'when': parts[2]})
-        return commits
-    except Exception:
-        return []
-
-
-def _my_tasks(dev: str, statuses=None) -> list:
-    """获取我的任务。"""
-    tasks_dir = get_tasks_dir(BASE)
-    if not tasks_dir.is_dir():
-        return []
-    out = []
-    for d in tasks_dir.iterdir():
-        if not d.is_dir():
-            continue
-        data = load_task_json(d)
-        if not data:
-            continue
-        if dev not in (data.get('assignee'), data.get('creator')):
-            continue
-        if statuses and data.get('status') not in statuses:
-            continue
-        out.append({'name': d.name, 'data': data})
-    return out
-
-
-def _finished_today(dev: str) -> list:
-    """今天完成的任务 (从 stage_ts.completed 判断)。"""
-    today_str = date.today().isoformat()
-    out = []
-    tasks_dir = get_tasks_dir(BASE)
-    # 也查归档 (今天 finish 的会归档)
-    archive_dir = BASE / '.qoder' / 'archive'
-    search_dirs = [tasks_dir, archive_dir] if archive_dir.is_dir() else [tasks_dir]
-    for sd in search_dirs:
-        if not sd.is_dir():
-            continue
-        for d in sd.iterdir():
-            if not d.is_dir():
-                continue
-            data = load_task_json(d)
-            if not data:
-                continue
-            if dev not in (data.get('assignee'), data.get('creator')):
-                continue
-            completed_ts = (data.get('stage_ts') or {}).get('completed') or data.get('updated_at', '')
-            if completed_ts.startswith(today_str):
-                out.append({'name': d.name, 'data': data})
-    return out
-
-
-def generate_daily(dev: str) -> str:
-    """生成日报 markdown。"""
-    today = date.today().isoformat()
-    commits = _git_commits(dev, today)
-    finished = _finished_today(dev)
-    in_progress = _my_tasks(dev, statuses=['in_progress'])
-    planning = _my_tasks(dev, statuses=['planning'])
-
-    lines = [
-        f'# 工作日报 - {dev} - {today}',
-        '',
-        '## 今日完成',
-    ]
-    if finished:
-        for t in finished:
-            title = t['data'].get('title', t['name'])
-            lines.append(f'- [{t["name"]}] {title}')
-    elif commits:
-        # 无 finish 任务但有提交
-        seen = set()
-        for c in commits:
-            msg = c['msg']
-            if msg not in seen:
-                lines.append(f'- {msg} ({c["hash"]})')
-                seen.add(msg)
-    else:
-        lines.append('- (今日无完成任务或提交)')
-
-    lines.extend(['', '## 进行中'])
-    if in_progress:
-        for t in in_progress:
-            title = t['data'].get('title', t['name'])
-            due = t['data'].get('due_date', '')
-            due_str = f' (截止 {due})' if due else ''
-            lines.append(f'- [{t["name"]}] {title}{due_str}')
-    else:
-        lines.append('- (无)')
-
-    lines.extend(['', '## 明日计划'])
-    if planning:
-        for t in planning[:3]:
-            title = t['data'].get('title', t['name'])
-            lines.append(f'- [{t["name"]}] {title}')
-    elif in_progress:
-        lines.append('- (继续进行中的任务)')
-    else:
-        lines.append('- (待规划)')
-
-    lines.extend(['', f'## 提交统计', f'- 今日提交: {len(commits)} 次'])
-
-    return '\n'.join(lines)
-
-
-def generate_weekly(dev: str) -> str:
-    """生成周报 markdown。"""
-    # 周一为起点
-    today = date.today()
-    monday = today - timedelta(days=today.weekday())
-    week_str = f'{monday.isoformat()} ~ {today.isoformat()}'
-    since = monday.isoformat()
-
-    commits = _git_commits(dev, since)
-    finished = _finished_this_week(dev, since)
-    in_progress = _my_tasks(dev, statuses=['in_progress'])
-
-    lines = [
-        f'# 周报 - {dev} - {week_str}',
-        '',
-        '## 本周完成',
-    ]
-    if finished:
-        for t in finished:
-            title = t['data'].get('title', t['name'])
-            lines.append(f'- [{t["name"]}] {title}')
-    else:
-        lines.append('- (本周无完成任务)')
-
-    lines.extend([
-        '', '## 关键产出',
-        f'- 提交数: {len(commits)} 次',
-    ])
-    # 提取 REQ/PRD 相关提交
-    prd_commits = [c for c in commits if 'REQ-' in c['msg'].upper() or 'PRD' in c['msg'].upper()]
-    if prd_commits:
-        lines.append(f'- PRD 相关提交: {len(prd_commits)} 次')
-
-    lines.extend(['', '## 进行中'])
-    if in_progress:
-        for t in in_progress:
-            title = t['data'].get('title', t['name'])
-            lines.append(f'- [{t["name"]}] {title}')
-    else:
-        lines.append('- (无)')
-
-    lines.extend(['', '## 下周计划', '- (待规划)'])
-
-    return '\n'.join(lines)
-
-
-def _finished_this_week(dev: str, since: str) -> list:
-    """本周完成的任务。"""
-    out = []
-    tasks_dir = get_tasks_dir(BASE)
-    archive_dir = BASE / '.qoder' / 'archive'
-    search_dirs = [tasks_dir, archive_dir] if archive_dir.is_dir() else [tasks_dir]
-    for sd in search_dirs:
-        if not sd.is_dir():
-            continue
-        for d in sd.iterdir():
-            if not d.is_dir():
-                continue
-            data = load_task_json(d)
-            if not data:
-                continue
-            if dev not in (data.get('assignee'), data.get('creator')):
-                continue
-            completed_ts = (data.get('stage_ts') or {}).get('completed') or data.get('updated_at', '')
-            if completed_ts >= since and data.get('status') == 'completed':
-                out.append({'name': d.name, 'data': data})
-    return out
-
-
-def save_and_maybe_push(content: str, mode: str, push_feishu: bool):
-    """保存报告到 journal 目录, 可选推送飞书。"""
-    dev = get_developer(BASE)
-    journal_dir = BASE / 'workspace' / 'members' / dev / 'journal'
-    journal_dir.mkdir(parents=True, exist_ok=True)
-
-    today = date.today().isoformat()
-    filename = f'{today}-{mode}.md'
-    out_path = journal_dir / filename
-    out_path.write_text(content, encoding='utf-8')
-    print(f'报告已保存: workspace/members/{dev}/journal/{filename}')
-    print('---')
-    print(content)
-
-    if push_feishu:
-        try:
-            from common.feishu import send_card, is_enabled
-            if is_enabled():
-                # 报告作为长文本卡片推送
-                title = f'{dev} 的{"周报" if mode == "weekly" else "日报"} - {today}'
-                # 飞书卡片内容截断 (避免过长)
-                content_short = content[:2000] + ('\n...(截断)' if len(content) > 2000 else '')
-                send_card(title, [content_short], event_type=None, theme='blue')
-                print('\n[feishu] 报告已推送到飞书群')
-            else:
-                print('\n[feishu] 未启用, 跳过推送 (在 config.yaml 设 feishu.enabled: true)')
-        except Exception as e:
-            print(f'\n[feishu] 推送失败 (不影响报告): {e}')
-
-
-def main():
-    parser = argparse.ArgumentParser(description='工作日报/周报生成')
-    parser.add_argument('mode', choices=['daily', 'weekly'], help='日报 or 周报')
-    parser.add_argument('--push-feishu', action='store_true', help='推送到飞书群')
-    args = parser.parse_args()
-
-    dev = _ensure_developer()
-
-    if args.mode == 'daily':
-        content = generate_daily(dev)
-    else:
-        content = generate_weekly(dev)
-
-    save_and_maybe_push(content, args.mode, args.push_feishu)
-
-
-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()
+
+"""
+report.py - 工作日报/周报生成 + 飞书推送 (阶段 D3)
+
+支撑 /wl-report 命令的数据生成。AI 执行 markdown 指令, 本脚本提供数据。
+
+Usage:
+    python report.py daily                    # 生成今日日报 (打印)
+    python report.py weekly                   # 生成本周周报 (打印)
+    python report.py daily --push-feishu      # 生成并推送到飞书
+    python report.py weekly --push-feishu
+
+输出: 中文格式, 保存到 workspace/members/{dev}/journal/
+"""
+
+import argparse
+import os
+import subprocess
+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
+
+BASE = get_repo_root()
+
+
+def _ensure_developer():
+    """必须有开发者身份。"""
+    dev = get_developer(BASE)
+    if not dev:
+        print('[ERROR] 未设置开发者身份。先跑 /wl-init 注册。', file=sys.stderr)
+        sys.exit(4)
+    return dev
+
+
+def _git_commits(dev: str, since_date: str) -> list:
+    """获取开发者指定日期后的 git 提交。"""
+    try:
+        r = subprocess.run(
+            ['git', 'log', '--author', dev, '--since', since_date,
+             '--pretty=format:%h|%s|%ar', '--no-merges'],
+            capture_output=True, text=True, encoding='utf-8', errors='replace',
+            cwd=str(BASE),
+        )
+        if r.returncode != 0:
+            return []
+        commits = []
+        for line in r.stdout.strip().splitlines():
+            parts = line.split('|', 2)
+            if len(parts) == 3:
+                commits.append({'hash': parts[0], 'msg': parts[1], 'when': parts[2]})
+        return commits
+    except Exception:
+        return []
+
+
+def _my_tasks(dev: str, statuses=None) -> list:
+    """获取我的任务。"""
+    tasks_dir = get_tasks_dir(BASE)
+    if not tasks_dir.is_dir():
+        return []
+    out = []
+    for d in tasks_dir.iterdir():
+        if not d.is_dir():
+            continue
+        data = load_task_json(d)
+        if not data:
+            continue
+        if dev not in (data.get('assignee'), data.get('creator')):
+            continue
+        if statuses and data.get('status') not in statuses:
+            continue
+        out.append({'name': d.name, 'data': data})
+    return out
+
+
+def _finished_today(dev: str) -> list:
+    """今天完成的任务 (从 stage_ts.completed 判断)。"""
+    today_str = date.today().isoformat()
+    out = []
+    tasks_dir = get_tasks_dir(BASE)
+    # 也查归档 (今天 finish 的会归档)
+    archive_dir = BASE / '.qoder' / 'archive'
+    search_dirs = [tasks_dir, archive_dir] if archive_dir.is_dir() else [tasks_dir]
+    for sd in search_dirs:
+        if not sd.is_dir():
+            continue
+        for d in sd.iterdir():
+            if not d.is_dir():
+                continue
+            data = load_task_json(d)
+            if not data:
+                continue
+            if dev not in (data.get('assignee'), data.get('creator')):
+                continue
+            completed_ts = (data.get('stage_ts') or {}).get('completed') or data.get('updated_at', '')
+            if completed_ts.startswith(today_str):
+                out.append({'name': d.name, 'data': data})
+    return out
+
+
+def generate_daily(dev: str) -> str:
+    """生成日报 markdown。"""
+    today = date.today().isoformat()
+    commits = _git_commits(dev, today)
+    finished = _finished_today(dev)
+    in_progress = _my_tasks(dev, statuses=['in_progress'])
+    planning = _my_tasks(dev, statuses=['planning'])
+
+    lines = [
+        f'# 工作日报 - {dev} - {today}',
+        '',
+        '## 今日完成',
+    ]
+    if finished:
+        for t in finished:
+            title = t['data'].get('title', t['name'])
+            lines.append(f'- [{t["name"]}] {title}')
+    elif commits:
+        # 无 finish 任务但有提交
+        seen = set()
+        for c in commits:
+            msg = c['msg']
+            if msg not in seen:
+                lines.append(f'- {msg} ({c["hash"]})')
+                seen.add(msg)
+    else:
+        lines.append('- (今日无完成任务或提交)')
+
+    lines.extend(['', '## 进行中'])
+    if in_progress:
+        for t in in_progress:
+            title = t['data'].get('title', t['name'])
+            due = t['data'].get('due_date', '')
+            due_str = f' (截止 {due})' if due else ''
+            lines.append(f'- [{t["name"]}] {title}{due_str}')
+    else:
+        lines.append('- (无)')
+
+    lines.extend(['', '## 明日计划'])
+    if planning:
+        for t in planning[:3]:
+            title = t['data'].get('title', t['name'])
+            lines.append(f'- [{t["name"]}] {title}')
+    elif in_progress:
+        lines.append('- (继续进行中的任务)')
+    else:
+        lines.append('- (待规划)')
+
+    lines.extend(['', f'## 提交统计', f'- 今日提交: {len(commits)} 次'])
+
+    return '\n'.join(lines)
+
+
+def generate_weekly(dev: str) -> str:
+    """生成周报 markdown。"""
+    # 周一为起点
+    today = date.today()
+    monday = today - timedelta(days=today.weekday())
+    week_str = f'{monday.isoformat()} ~ {today.isoformat()}'
+    since = monday.isoformat()
+
+    commits = _git_commits(dev, since)
+    finished = _finished_this_week(dev, since)
+    in_progress = _my_tasks(dev, statuses=['in_progress'])
+
+    lines = [
+        f'# 周报 - {dev} - {week_str}',
+        '',
+        '## 本周完成',
+    ]
+    if finished:
+        for t in finished:
+            title = t['data'].get('title', t['name'])
+            lines.append(f'- [{t["name"]}] {title}')
+    else:
+        lines.append('- (本周无完成任务)')
+
+    lines.extend([
+        '', '## 关键产出',
+        f'- 提交数: {len(commits)} 次',
+    ])
+    # 提取 REQ/PRD 相关提交
+    prd_commits = [c for c in commits if 'REQ-' in c['msg'].upper() or 'PRD' in c['msg'].upper()]
+    if prd_commits:
+        lines.append(f'- PRD 相关提交: {len(prd_commits)} 次')
+
+    lines.extend(['', '## 进行中'])
+    if in_progress:
+        for t in in_progress:
+            title = t['data'].get('title', t['name'])
+            lines.append(f'- [{t["name"]}] {title}')
+    else:
+        lines.append('- (无)')
+
+    lines.extend(['', '## 下周计划', '- (待规划)'])
+
+    return '\n'.join(lines)
+
+
+def _finished_this_week(dev: str, since: str) -> list:
+    """本周完成的任务。"""
+    out = []
+    tasks_dir = get_tasks_dir(BASE)
+    archive_dir = BASE / '.qoder' / 'archive'
+    search_dirs = [tasks_dir, archive_dir] if archive_dir.is_dir() else [tasks_dir]
+    for sd in search_dirs:
+        if not sd.is_dir():
+            continue
+        for d in sd.iterdir():
+            if not d.is_dir():
+                continue
+            data = load_task_json(d)
+            if not data:
+                continue
+            if dev not in (data.get('assignee'), data.get('creator')):
+                continue
+            completed_ts = (data.get('stage_ts') or {}).get('completed') or data.get('updated_at', '')
+            if completed_ts >= since and data.get('status') == 'completed':
+                out.append({'name': d.name, 'data': data})
+    return out
+
+
+def save_and_maybe_push(content: str, mode: str, push_feishu: bool):
+    """保存报告到 journal 目录, 可选推送飞书。"""
+    dev = get_developer(BASE)
+    journal_dir = BASE / 'workspace' / 'members' / dev / 'journal'
+    journal_dir.mkdir(parents=True, exist_ok=True)
+
+    today = date.today().isoformat()
+    filename = f'{today}-{mode}.md'
+    out_path = journal_dir / filename
+    out_path.write_text(content, encoding='utf-8')
+    print(f'报告已保存: workspace/members/{dev}/journal/{filename}')
+    print('---')
+    print(content)
+
+    if push_feishu:
+        try:
+            from common.feishu import send_card, is_enabled
+            if is_enabled():
+                # 报告作为长文本卡片推送
+                title = f'{dev} 的{"周报" if mode == "weekly" else "日报"} - {today}'
+                # 飞书卡片内容截断 (避免过长)
+                content_short = content[:2000] + ('\n...(截断)' if len(content) > 2000 else '')
+                send_card(title, [content_short], event_type=None, theme='blue')
+                print('\n[feishu] 报告已推送到飞书群')
+            else:
+                print('\n[feishu] 未启用, 跳过推送 (在 config.yaml 设 feishu.enabled: true)')
+        except Exception as e:
+            print(f'\n[feishu] 推送失败 (不影响报告): {e}')
+
+
+def main():
+    parser = argparse.ArgumentParser(description='工作日报/周报生成')
+    parser.add_argument('mode', choices=['daily', 'weekly'], help='日报 or 周报')
+    parser.add_argument('--push-feishu', action='store_true', help='推送到飞书群')
+    args = parser.parse_args()
+
+    dev = _ensure_developer()
+
+    if args.mode == 'daily':
+        content = generate_daily(dev)
+    else:
+        content = generate_weekly(dev)
+
+    save_and_maybe_push(content, args.mode, args.push_feishu)
+
+
+if __name__ == '__main__':
+    main()