@hupan56/wlkj 2.0.0

package/templates/qoder/scripts/report.py

@@ -0,0 +1,281 @@
+#!/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()

package/templates/qoder/scripts/role.py

@@ -0,0 +1,39 @@
+# role.py - Resolve role from member info
+import os, json, sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from common.paths import get_developer, get_developer_info
+
+BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+def get_role(name=None):
+    if not name:
+        # Prefer role recorded directly in .developer
+        info = get_developer_info()
+        if info and info.get('role'):
+            return info['role']
+        name = get_developer()
+    if not name:
+        return None
+    mf = os.path.join(BASE, 'workspace', 'members', name, 'member.json')
+    if os.path.isfile(mf):
+        try:
+            with open(mf, encoding='utf-8') as f:
+                return json.load(f).get('role')
+        except (OSError, json.JSONDecodeError):
+            return None
+    return None
+
+def get_permissions(role):
+    import yaml
+    cfg = os.path.join(BASE, '.qoder', 'config.yaml')
+    if not os.path.isfile(cfg):
+        return []
+    try:
+        with open(cfg, encoding='utf-8') as f:
+            config = yaml.safe_load(f) or {}
+    except (OSError, yaml.YAMLError):
+        return []
+    roles = config.get('roles', {})
+    r = roles.get(role, {})
+    return r.get('permissions', [])

package/templates/qoder/scripts/run_weekly_update.bat

@@ -0,0 +1,17 @@
+@echo off
+REM QODER Weekly Knowledge Graph Update
+REM Runs every Friday at 18:00
+REM %~dp0 = this script directory; project root is two levels up
+
+cd /d "%~dp0..\.."
+
+echo [%date% %time%] Starting weekly update... >> .qoder\logs\weekly-update.log
+
+REM Step 1: Git pull + PRD collect + Index rebuild
+python .qoder\scripts\git_sync.py >> .qoder\logs\weekly-update.log 2>&1
+
+if errorlevel 1 (
+    echo [%date% %time%] UPDATE FAILED - check log above >> .qoder\logs\weekly-update.log
+) else (
+    echo [%date% %time%] Update complete. >> .qoder\logs\weekly-update.log
+)

package/templates/qoder/scripts/run_weekly_update.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# QODER Weekly Knowledge Graph Update (macOS / Linux)
+# Runs every Friday at 18:00 via cron (see setup_weekly_cron.sh)
+set -u
+cd "$(dirname "$0")/../.." || exit 1
+
+mkdir -p .qoder/logs
+LOG=.qoder/logs/weekly-update.log
+
+echo "[$(date '+%Y-%m-%d %H:%M:%S')] Starting weekly update..." >> "$LOG"
+
+python3 .qoder/scripts/git_sync.py >> "$LOG" 2>&1
+STATUS=$?
+
+if [ $STATUS -ne 0 ]; then
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] UPDATE FAILED (exit $STATUS) - check log above" >> "$LOG"
+else
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] Update complete." >> "$LOG"
+fi
+exit $STATUS