@hupan56/wlkj 2.5.0 → 2.7.0

package/templates/qoder/hooks/inject-workflow-state.py

@@ -15,6 +15,31 @@ BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)
 _CACHE = {}
 
 
+def _append_hook_error(log_path, line):
+    """写一行错误到 hook-errors.log, 超 100KB 截断保留最后 50KB (防无限膨胀)。
+
+    best-effort: 任何 IO 失败都静默 (不能让日志写入失败导致 hook 二次崩溃)。
+    """
+    from datetime import datetime
+    try:
+        os.makedirs(os.path.dirname(log_path), exist_ok=True)
+        # 轮转: 文件过大则截断
+        if os.path.isfile(log_path):
+            try:
+                if os.path.getsize(log_path) > 100 * 1024:
+                    with open(log_path, 'r', encoding='utf-8', errors='replace') as f:
+                        tail = f.read()[-50 * 1024:]
+                    with open(log_path, 'w', encoding='utf-8') as f:
+                        f.write(tail)
+            except OSError:
+                pass
+        with open(log_path, 'a', encoding='utf-8') as f:
+            f.write('[{}] inject-workflow-state: {}\n'.format(
+                datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(line)[:200]))
+    except Exception:
+        pass
+
+
 def _read_developer():
     """读当前开发者名 (容错: UTF-8/GBK)."""
     df = os.path.join(BASE, '.qoder', '.developer')
@@ -88,8 +113,8 @@ def get_status():
 
 # Statuses written by task.py: planning -> in_progress -> completed
 GUIDE = {
-    None: 'No active task. Use /wl-prd to start, or /wl-task create.',
-    'planning': 'Task in planning. Use /wl-prd to write the PRD, then /wl-task start.',
+    None: 'No active task. Use /wl-prd-full to start, or /wl-task create.',
+    'planning': 'Task in planning. Use /wl-prd-full to write the PRD, then /wl-task start.',
     'in_progress': 'Dev in progress. /wl-spec to generate spec, /wl-code to implement.',
     'completed': 'Task completed. /wl-task archive to archive, or start the next one.',
 }
@@ -106,7 +131,10 @@ def main():
         if os.path.isfile(state_file):
             last_sig = open(state_file, 'r', encoding='utf-8').read().strip()
             if last_sig == current_sig:
-                return  # 状态没变, 不重复注入 (省 token)
+                # 状态没变, 不重复注入 (省 token), 但仍输出健康标记
+                # QoderWork 看不到任何输出时分不清"缓存跳过"还是"hook 没跑"
+                print('<!-- [hook-ok] inject-workflow-state: state unchanged (cached) -->')
+                return
         open(state_file, 'w', encoding='utf-8').write(current_sig)
     except OSError:
         pass
@@ -119,6 +147,8 @@ def main():
     parts.append('Status: ' + str(st))
     parts.append('Do: ' + g)
     parts.append('</qoder-workflow>')
+    # Hook-1: 健康标记 — 与 session-start 一致, QoderWork 看不到说明 hook 没生效
+    parts.append('<!-- [hook-ok] inject-workflow-state hook ran -->')
     print(NL.join(parts))
 
 
@@ -129,12 +159,8 @@ if __name__ == '__main__':
         # 落盘到日志 (stdout 一次性, 追溯用)
         try:
             from pathlib import Path
-            from datetime import datetime
-            log_path = Path(__file__).resolve().parents[1] / '.runtime' / 'hook-errors.log'
-            log_path.parent.mkdir(parents=True, exist_ok=True)
-            with open(log_path, 'a', encoding='utf-8') as f:
-                f.write('[{}] inject-workflow-state: {}\n'.format(
-                    datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(e)[:200]))
+            log_path = str(Path(__file__).resolve().parents[1] / '.runtime' / 'hook-errors.log')
+            _append_hook_error(log_path, str(e)[:200])
         except Exception:
             pass
         print('<qoder-workflow>')

package/templates/qoder/hooks/session-start.py

@@ -10,10 +10,62 @@ if sys.platform == 'win32':
 NL = chr(10)
 BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
+HOOK_ERRORS_LOG = os.path.join(BASE, '.qoder', '.runtime', 'hook-errors.log')
+
+
+def _append_hook_error(log_path, line):
+    """写一行错误到 hook-errors.log, 超 100KB 截断保留最后 50KB (防无限膨胀)。best-effort。"""
+    from datetime import datetime
+    try:
+        os.makedirs(os.path.dirname(log_path), exist_ok=True)
+        if os.path.isfile(log_path):
+            try:
+                if os.path.getsize(log_path) > 100 * 1024:
+                    with open(log_path, 'r', encoding='utf-8', errors='replace') as f:
+                        tail = f.read()[-50 * 1024:]
+                    with open(log_path, 'w', encoding='utf-8') as f:
+                        f.write(tail)
+            except OSError:
+                pass
+        with open(log_path, 'a', encoding='utf-8') as f:
+            f.write('[{}] session-start: {}\n'.format(
+                datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(line)[:200]))
+    except Exception:
+        pass
+
+
+def _recent_hook_errors(hours=24, limit=3):
+    """读最近 N 小时的 hook 错误, 返回最多 limit 条 (供会话注入告警)。
+
+    错误之前只落盘到 .runtime/hook-errors.log, PM 永远看不到 → hook 坏了无感知。
+    改后每次开会话把最近错误摘要注入上下文。
+    """
+    try:
+        from datetime import datetime, timedelta
+        if not os.path.isfile(HOOK_ERRORS_LOG):
+            return []
+        cutoff = datetime.now() - timedelta(hours=hours)
+        recent = []
+        with open(HOOK_ERRORS_LOG, encoding='utf-8', errors='replace') as f:
+            for line in f:
+                line = line.strip()
+                if not line or '[' not in line or ']' not in line:
+                    continue
+                try:
+                    ts = line.split(']')[0].lstrip('[')
+                    dt = datetime.strptime(ts, '%Y-%m-%d %H:%M:%S')
+                    if dt >= cutoff:
+                        recent.append(line)
+                except (ValueError, IndexError):
+                    continue
+        return recent[-limit:] if recent else []
+    except Exception:
+        return []
+
 # Injected as REAL OUTPUT below (a comment here would never reach the AI)
 CRITICAL_RULE = NL.join([
     '## CRITICAL RULE',
-    'When user asks for /wl-prd, ALWAYS ask platform FIRST:',
+    'When user asks for /wl-prd-full, ALWAYS ask platform FIRST:',
     '"这个需求是针对哪个平台？',
     ' 1. Web 管理端 (fywl-ui) - Ant Design Vue + VxeGrid 风格',
     ' 2. APP 移动端 (Carmg-H5) - Vant 风格',
@@ -90,63 +142,94 @@ def get_index_info():
     except OSError:
         pass
 
-    lines.append('## Knowledge Index')
-    lines.append('Use search script (DO NOT read large JSON files directly):')
+    lines.append('## Knowledge Graph')
+    lines.append('MCP工具 (QoderWork自动调用): search_code / get_impact / coverage_matrix / get_workflow 等11个')
     lines.append('  python .qoder/scripts/search_index.py <keyword> [--platform web|app]')
-    lines.append('  python .qoder/scripts/search_index.py --prd <keyword>   # search PRDs')
-    lines.append('  python .qoder/scripts/search_index.py --style <table|form> [--platform p]')
-    lines.append('  python .qoder/scripts/search_index.py --field <name>    # field usage')
-    lines.append('  python .qoder/scripts/search_index.py --api <keyword>   # API endpoints')
-    lines.append('  python .qoder/scripts/search_index.py --components      # UI components')
-    lines.append('  python .qoder/scripts/search_index.py --modules         # project overview')
-    lines.append('  python .qoder/scripts/search_index.py --list            # top keywords')
-
-    meta = load_json_safe(os.path.join(BASE, 'data', 'index', '.index-meta.json'))
-    if meta:
-        projects = meta.get('projects', {})
-        if isinstance(projects, dict):
-            for proj, info in projects.items():
-                if isinstance(info, dict):
-                    files = info.get('files', 0)
-                else:
-                    files = info  # new meta format: {project: file_count}
-                lines.append('  ' + str(proj) + ': ' + str(files) + ' files')
-        elif isinstance(projects, list):
-            for proj in projects:
-                lines.append('  ' + str(proj))
-        lines.append('Last sync: ' + str(meta.get('last_sync', 'unknown')))
-        # Staleness warning (审计发现: cron 从未注册, 索引可能静默过期)
-        last_sync = meta.get('last_sync')
-        if last_sync:
-            try:
-                from datetime import datetime
-                # 兼容多种格式: "2026-06-12 16:49" / ISO
-                ts = str(last_sync).replace('T', ' ').split('.')[0].strip()
-                for fmt in ('%Y-%m-%d %H:%M', '%Y-%m-%d %H:%M:%S', '%Y-%m-%dT%H:%M:%S'):
-                    try:
-                        sync_dt = datetime.strptime(ts, fmt)
-                        break
-                    except ValueError:
-                        continue
-                else:
-                    sync_dt = None
-                if sync_dt:
-                    age_days = (datetime.now() - sync_dt).days
-                    if age_days > 30:
-                        lines.append('[CRITICAL] 索引已 {} 天未更新! 搜索结果严重过期. 跑: python .qoder/scripts/git_sync.py'.format(age_days))
-                    elif age_days > 7:
-                        lines.append('[WARN] 索引已 {} 天未更新, 建议刷新: python .qoder/scripts/git_sync.py'.format(age_days))
-            except Exception:
-                pass  # 日期解析失败不阻塞
-        if meta.get('failures'):
-            lines.append('WARNING: last sync had errors - see data/index/.index-meta.json')
+    lines.append('  python .qoder/scripts/context_pack.py <keyword>   # 一次打包全部上下文')
+
+    # DuckDB 知识图谱状态检查
+    # Read role from .developer file
+    role = 'pm'
+    try:
+        dev_file = os.path.join(BASE, '.qoder', '.developer')
+        if os.path.isfile(dev_file):
+            for _line in open(dev_file, encoding='utf-8'):
+                if _line.strip().startswith('role='):
+                    role = _line.split('=', 1)[1].strip()
+    except Exception:
+        pass
+    db_path = os.path.join(BASE, 'data', 'index', 'kg.duckdb')
+
+    if os.path.isfile(db_path):
+        import time as _time
+        db_mtime = os.path.getmtime(db_path)
+        db_age_hours = (_time.time() - db_mtime) / 3600
+
+        # 检查代码是否比 DuckDB 新 (采样几个文件)
+        code_dir = os.path.join(BASE, 'data', 'code')
+        code_newer = False
+        if os.path.isdir(code_dir):
+            for root, dirs, files in os.walk(code_dir):
+                dirs[:] = [d for d in dirs if d not in ('node_modules', '.git', 'dist', '__pycache__')]
+                depth = root[len(code_dir):].count(os.sep)
+                if depth >= 3:
+                    dirs[:] = []
+                    continue
+                for fn in files:
+                    if fn.endswith(('.vue', '.java', '.ts')):
+                        try:
+                            if os.path.getmtime(os.path.join(root, fn)) > db_mtime:
+                                code_newer = True
+                                break
+                        except OSError:
+                            pass
+                if code_newer:
+                    break
+
+        lines.append('  kg.duckdb: %.0f小时前构建' % db_age_hours)
+
+        if role in ('admin', 'dev'):
+            # 管理员/开发: 能构建
+            if code_newer or db_age_hours > 168:  # 7天 = 168小时
+                lines.append('  [WARN] 知识图谱过期! 代码有新变更.')
+                lines.append('  → 管理员请运行: python .qoder/scripts/kg_build.py')
+                lines.append('  → 完成后: python .qoder/scripts/team_sync.py push (共享给团队)')
+            else:
+                lines.append('  ✓ 知识图谱最新')
+        else:
+            # 非管理员: 只拉取
+            if code_newer or db_age_hours > 168:
+                lines.append('  [WARN] 知识图谱可能过期.')
+                lines.append('  → 运行: python .qoder/scripts/team_sync.py pull (获取管理员最新构建)')
+            else:
+                lines.append('  ✓ 知识图谱最新')
+
+        # 检查是否有未标注的模块 (提示AI做语义标注)
+        try:
+            import subprocess as _sp
+            r = _sp.run([sys.executable, os.path.join(BASE, '.qoder', 'scripts', 'kg_semantic.py'), '--check'],
+                        capture_output=True, text=True, encoding='utf-8', timeout=5)
+            if r.stdout and 'semantic_labeling_needed' in r.stdout:
+                import json as _json
+                data = _json.loads(r.stdout)
+                unlabeled = len(data.get('modules', []))
+                if unlabeled > 0:
+                    lines.append('  [提示] %d个模块未标注中文名, 运行 kg_semantic.py --check 查看' % unlabeled)
+        except Exception:
+            pass
+    else:
+        lines.append('  [MISSING] kg.duckdb 不存在!')
+        if role in ('admin', 'dev'):
+            lines.append('  → 运行: python .qoder/scripts/kg_build.py')
+        else:
+            lines.append('  → 运行: python .qoder/scripts/team_sync.py pull')
 
     return NL.join(lines)
 
 
 def get_style_info():
     """Read style metadata for quick reference"""
-    meta = load_json_safe(os.path.join(BASE, 'data', 'index', 'style-meta.json'))
+    meta = load_json_safe(os.path.join(BASE, 'data', 'index', 'ui-style-meta.json'))
     if not meta:
         return None
 
@@ -174,6 +257,14 @@ def get_style_info():
 def main():
     parts = []
     parts.append('<qoder-context>')
+    # Hook-3: 上次会话以来的 hook 错误告警 (不只落盘, 要让用户/AI 看到)
+    # hook 坏了会导致上下文注入失败 (任务状态/平台规则缺失), 必须可见
+    recent_errors = _recent_hook_errors(hours=24, limit=3)
+    if recent_errors:
+        parts.append('⚠️ [HOOK-WARN] 过去 24h 有 hook 错误 (上下文注入可能失效):')
+        for err in recent_errors:
+            parts.append('  ' + err)
+        parts.append('  详情见 .qoder/.runtime/hook-errors.log; 检查 Python 环境或跑 init_doctor --fix')
     dev = get_developer()
     if dev:
         name = dev.get('name', 'unknown')
@@ -216,17 +307,8 @@ if __name__ == '__main__':
         main()
     except Exception as e:
         # A broken hook must never kill the session - emit minimal context
-        # 同时落盘到日志, 方便后续排查 (stdout 一次性, AI 看完就没了)
-        try:
-            from pathlib import Path
-            log_path = Path(__file__).resolve().parents[1] / '.runtime' / 'hook-errors.log'
-            log_path.parent.mkdir(parents=True, exist_ok=True)
-            from datetime import datetime
-            with open(log_path, 'a', encoding='utf-8') as f:
-                f.write('[{}] session-start: {}\n'.format(
-                    datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(e)[:200]))
-        except Exception:
-            pass  # 日志写失败不影响降级
+        # 同时落盘到日志 (带轮转), 方便下次会话告警
+        _append_hook_error(HOOK_ERRORS_LOG, str(e)[:200])
         print('<qoder-context>')
         print('session-start hook error: ' + str(e)[:200])
         print('  (详情见 .qoder/.runtime/hook-errors.log)')