@hupan56/wlkj 3.3.0 → 3.3.2

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

@@ -1,365 +1,365 @@
-# session-start.py - Inject project context on session start
-import os, json, sys
-
-if sys.platform == 'win32':
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-    except Exception:
-        pass
-
-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 []
-
-# v3.0 M4: 删 CRITICAL_RULE (会话开始主动推销工作流铁律 → 非侵入式改造)
-# 平台询问逻辑保留在 wl-pipeline.md 规则1 (命令启动后才生效, 不在会话开头强推)
-
-
-def load_json_safe(path):
-    try:
-        with open(path, encoding='utf-8') as f:
-            return json.load(f)
-    except Exception:
-        return None
-
-
-def get_developer():
-    df = os.path.join(BASE, '.qoder', '.developer')
-    if not os.path.isfile(df):
-        return None
-    try:
-        with open(df, encoding='utf-8') as f:
-            content = f.read()
-    except Exception:
-        return None
-    info = {}
-    for line in content.strip().splitlines():
-        for sep in ('=', ':'):
-            if sep in line:
-                k, v = line.split(sep, 1)
-                info[k.strip()] = v.strip()
-                break
-    return info or None
-
-
-def get_active_tasks():
-    td = os.path.join(BASE, 'workspace', 'tasks')
-    if not os.path.isdir(td):
-        return []
-    tasks = []
-    for d in sorted(os.listdir(td)):
-        data = load_json_safe(os.path.join(td, d, 'task.json'))
-        if data is None:
-            continue
-        tasks.append({
-            'name': d,
-            'title': data.get('title', d),
-            'status': data.get('status', 'unknown')
-        })
-    return tasks
-
-
-def get_team_size():
-    md = os.path.join(BASE, 'workspace', 'members')
-    if not os.path.isdir(md):
-        return 0
-    return len([d for d in os.listdir(md) if os.path.isdir(os.path.join(md, d))])
-
-
-def get_index_info():
-    lines = []
-    # Hook-3: 检查 hook 错误日志, 超过 3 条新错误时告警
-    try:
-        log_path = os.path.join(BASE, '.qoder', '.runtime', 'hook-errors.log')
-        if os.path.isfile(log_path):
-            with open(log_path, 'r', encoding='utf-8', errors='replace') as f:
-                errors = [l for l in f.readlines() if l.strip()]
-            # 只看最近 24h 的错误
-            recent = errors[-10:]  # 取最后 10 行检查
-            if len(recent) >= 3:
-                lines.append('[WARN] hook 最近频繁失败 (%d 条错误), 详情见 .qoder/.runtime/hook-errors.log' % len(recent))
-                lines.append('  跑 python .qoder/scripts/setup/init_doctor.py --fix 排查')
-    except OSError:
-        pass
-
-    lines.append('## Knowledge Graph')
-    lines.append('MCP工具 (Qoder/QoderWork自动调用): search_code / rag_search / get_impact / project_brief / graphrag_ask 等43个')
-    lines.append('  python .qoder/scripts/orchestration/wlkj.py search <keyword> [--platform web|app]')
-    lines.append('  python .qoder/scripts/orchestration/wlkj.py context <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
-    # ★ 知识层健康检查：全迁 PG 后不再检查本地 kg.duckdb（已删除），改探活 MCP 知识层。
-    # 复用 wlinkj-workflow/mcp_config.json 的 token+url，调 get_knowledge_health 拿真实健康分。
-    # best-effort：任何失败都不阻塞会话启动（与其它 hook 铁律一致）。
-    kg_info = None
-    try:
-        import json as _json
-        import urllib.request as _url
-        cfg_path = os.path.join(BASE, 'wlinkj-workflow', 'mcp_config.json')
-        if os.path.isfile(cfg_path):
-            _cfg = _json.load(open(cfg_path, encoding='utf-8'))
-            _srv = _cfg.get('mcpServers', {}).get('wlinkj-knowledge', {})
-            _url_s = _srv.get('url', '')
-            _tok = _srv.get('token', '')
-            if _url_s and _tok and _url_s != 'WILL_BE_FILLED_BY_WL_INIT':
-                _rpc = {"jsonrpc": "2.0", "id": 1, "method": "tools/call",
-                        "params": {"name": "get_knowledge_health", "arguments": {}}}
-                _req = _url.Request(_url_s, data=_json.dumps(_rpc).encode(),
-                                    headers={"Content-Type": "application/json",
-                                             "X-MCP-Token": _tok}, method="POST")
-                _resp = _url.urlopen(_req, timeout=4).read()
-                kg_info = _json.loads(_json.loads(_resp)["result"]["content"][0]["text"])
-    except Exception:
-        kg_info = None
-
-    if kg_info and isinstance(kg_info, dict) and "error" not in kg_info:
-        lines.append('  ✓ 知识层在线 (PG@5432): 健康分 %s / 覆盖 %s / 新鲜 %s / 完整 %s' % (
-            kg_info.get("score", "?"), kg_info.get("coverage", "?"),
-            kg_info.get("freshness", "?"), kg_info.get("completeness", "?")))
-        issues = kg_info.get("issues", []) or []
-        if issues and role in ('admin', 'dev'):
-            lines.append('  [提示] 健康问题: ' + '; '.join(str(i)[:60] for i in issues[:2]))
-    else:
-        lines.append('  [WARN] 知识层未响应（MCP 后端未启动？）')
-        lines.append('  → 启动: cd wlinkj-workspace && start_pg.bat（后端 :10010）')
-
-    return NL.join(lines)
-
-
-def get_style_info():
-    """Read style metadata for quick reference"""
-    meta = load_json_safe(os.path.join(BASE, 'data', 'index', 'ui-style-meta.json'))
-    if not meta:
-        return None
-
-    lines = []
-    lines.append('## UI Style Index')
-    lines.append('Style search: python .qoder/scripts/orchestration/wlkj.py style --style <table|form|modal>')
-    lines.append('Field search: python .qoder/scripts/orchestration/wlkj.py search --field <name>')
-
-    for proj, d in meta.get('projects', {}).items():
-        vue = d.get('vue_files', 0)
-        if vue > 0:
-            pt = d.get('page_types', {})
-            types_str = ', '.join([k + ':' + str(v) for k, v in pt.items() if v > 0])
-            lines.append('  ' + proj + ': ' + str(vue) + ' Vue (' + types_str + ')')
-
-    lines.append('Top components: ' + ', '.join(list(meta.get('common_components', {}).keys())[:8]))
-    lines.append('Field map: ' + str(meta.get('field_count', 0)) + ' entries')
-
-    if os.path.isdir(os.path.join(BASE, 'data', 'style')):
-        lines.append('Style PDFs: data/style/ (design specs, code takes priority)')
-
-    return NL.join(lines)
-
-
-def get_usability_summary():
-    """读工作流可用性指标, 把"不达标"项注入会话上下文。
-
-    吸收宿主 SessionStart hook 能力: 不用等用户跑 /wl-status, 每次开会话主动
-    暴露"工作流用没用起来"的红灯项。只展示红/黄 (绿的不打扰), 无数据则不显示。
-    (与 usability_score.py 同源逻辑, 但 hook 内联精简版, 避免 import 验证脚本拖慢启动)
-    """
-    lines = []
-    try:
-        # U2 一次过审率 (从 eval-history 取首条)
-        eval_path = os.path.join(BASE, 'data', 'learning', 'eval-history.jsonl')
-        records = []
-        if os.path.isfile(eval_path):
-            with open(eval_path, encoding='utf-8', errors='replace') as f:
-                for ln in f:
-                    ln = ln.strip()
-                    if ln:
-                        try:
-                            records.append(json.loads(ln))
-                        except Exception:
-                            continue
-        # 取最近 7 天
-        from datetime import datetime, timedelta
-        cutoff = datetime.now() - timedelta(days=7)
-        recent = []
-        for r in records:
-            t = r.get('time', '')
-            try:
-                if datetime.fromisoformat(str(t).split('.')[0]) >= cutoff:
-                    recent.append(r)
-            except Exception:
-                continue
-
-        issues = []  # 只收红/黄
-        if recent:
-            passed = sum(1 for r in recent if r.get('passed'))
-            rate = 100.0 * passed / len(recent)
-            if rate < 60:  # 黄线 30, 红线 60
-                tag = '🔴' if rate < 30 else '🟡'
-                issues.append('%s 一次过审率 %.0f%% (<60%% 目标) — PRD 质量需提升' % (tag, rate))
-
-        # U4 规则违反率 (从 feedback)
-        fb_dir = os.path.join(BASE, 'workspace', 'members')
-        violations = 0
-        prds_gen = 0
-        if os.path.isdir(fb_dir):
-            for dev in os.listdir(fb_dir):
-                fb = os.path.join(fb_dir, dev, 'journal', 'feedback.jsonl')
-                if not os.path.isfile(fb):
-                    continue
-                try:
-                    with open(fb, encoding='utf-8', errors='replace') as f:
-                        for ln in f:
-                            if '"rule_violation"' in ln:
-                                violations += 1
-                            elif '"prd_accepted"' in ln:
-                                prds_gen += 1
-                except Exception:
-                    continue
-        if prds_gen and violations:
-            vrate = 100.0 * violations / prds_gen
-            if vrate > 10:
-                tag = '🔴' if vrate > 25 else '🟡'
-                issues.append('%s 规则违反率 %.0f%% (>10%% 目标) — 关键规则没拦住' % (tag, vrate))
-
-        if issues:
-            lines.append('## Workflow Usability (近7天)')
-            lines.append('工作流"用不用得起来"红灯 (详情: wlkj.py usability):')
-            for it in issues:
-                lines.append('  ' + it)
-    except Exception:
-        pass  # hook 失败绝不阻塞会话
-    return NL.join(lines) if lines else ''
-
-
-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')
-        # role 真源在 member.json (.developer 常无 role= 行 → 显示 unknown)。
-        # 回退查 member.json, 再回退 'pm' (绝不显示 unknown, 误导 AI)。
-        role = dev.get('role')
-        if not role or role == 'unknown':
-            try:
-                mj = os.path.join(BASE, 'workspace', 'members', name, 'member.json')
-                if os.path.isfile(mj):
-                    m = json.load(open(mj, encoding='utf-8'))
-                    role = m.get('role') or 'pm'
-            except Exception:
-                pass
-            role = role or 'pm'
-        parts.append('Developer: ' + name + ' (' + role + ')')
-        parts.append('Workspace: workspace/members/' + name + '/')
-    else:
-        parts.append('Developer: NOT SET. Run /wl-init to register.')
-    team = get_team_size()
-    if team > 0:
-        parts.append('Team members: ' + str(team))
-    tasks = get_active_tasks()
-    if tasks:
-        parts.append('Active tasks:')
-        for t in tasks:
-            parts.append('  [' + t['status'] + '] ' + t['name'] + ' - ' + t['title'])
-
-    usability = get_usability_summary()
-    if usability:
-        parts.append('')
-        parts.append(usability)
-
-    parts.append('')
-
-    idx_info = get_index_info()
-    if idx_info:
-        parts.append('')
-        parts.append(idx_info)
-
-    style_info = get_style_info()
-    if style_info:
-        parts.append('')
-        parts.append(style_info)
-
-    parts.append('</qoder-context>')
-    # Hook-1: 健康标记 — AI 能感知 hook 是否真的跑了
-    # QoderWork/Quest 里看不到 [hook-ok] 就知道 hook 没生效, 要自取上下文
-    parts.append('<!-- [hook-ok] session-start hook ran successfully -->')
-    print(NL.join(parts))
-
-
-if __name__ == '__main__':
-    try:
-        main()
-    except Exception as e:
-        # A broken hook must never kill the session - emit minimal context
-        # 同时落盘到日志 (带轮转), 方便下次会话告警
-        _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)')
-        print('</qoder-context>')
+# session-start.py - Inject project context on session start
+import os, json, sys
+
+if sys.platform == 'win32':
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+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 []
+
+# v3.0 M4: 删 CRITICAL_RULE (会话开始主动推销工作流铁律 → 非侵入式改造)
+# 平台询问逻辑保留在 wl-pipeline.md 规则1 (命令启动后才生效, 不在会话开头强推)
+
+
+def load_json_safe(path):
+    try:
+        with open(path, encoding='utf-8') as f:
+            return json.load(f)
+    except Exception:
+        return None
+
+
+def get_developer():
+    df = os.path.join(BASE, '.qoder', '.developer')
+    if not os.path.isfile(df):
+        return None
+    try:
+        with open(df, encoding='utf-8') as f:
+            content = f.read()
+    except Exception:
+        return None
+    info = {}
+    for line in content.strip().splitlines():
+        for sep in ('=', ':'):
+            if sep in line:
+                k, v = line.split(sep, 1)
+                info[k.strip()] = v.strip()
+                break
+    return info or None
+
+
+def get_active_tasks():
+    td = os.path.join(BASE, 'workspace', 'tasks')
+    if not os.path.isdir(td):
+        return []
+    tasks = []
+    for d in sorted(os.listdir(td)):
+        data = load_json_safe(os.path.join(td, d, 'task.json'))
+        if data is None:
+            continue
+        tasks.append({
+            'name': d,
+            'title': data.get('title', d),
+            'status': data.get('status', 'unknown')
+        })
+    return tasks
+
+
+def get_team_size():
+    md = os.path.join(BASE, 'workspace', 'members')
+    if not os.path.isdir(md):
+        return 0
+    return len([d for d in os.listdir(md) if os.path.isdir(os.path.join(md, d))])
+
+
+def get_index_info():
+    lines = []
+    # Hook-3: 检查 hook 错误日志, 超过 3 条新错误时告警
+    try:
+        log_path = os.path.join(BASE, '.qoder', '.runtime', 'hook-errors.log')
+        if os.path.isfile(log_path):
+            with open(log_path, 'r', encoding='utf-8', errors='replace') as f:
+                errors = [l for l in f.readlines() if l.strip()]
+            # 只看最近 24h 的错误
+            recent = errors[-10:]  # 取最后 10 行检查
+            if len(recent) >= 3:
+                lines.append('[WARN] hook 最近频繁失败 (%d 条错误), 详情见 .qoder/.runtime/hook-errors.log' % len(recent))
+                lines.append('  跑 python .qoder/scripts/setup/init_doctor.py --fix 排查')
+    except OSError:
+        pass
+
+    lines.append('## Knowledge Graph')
+    lines.append('MCP工具 (Qoder/QoderWork自动调用): search_code / rag_search / get_impact / project_brief / graphrag_ask 等43个')
+    lines.append('  python .qoder/scripts/orchestration/wlkj.py search <keyword> [--platform web|app]')
+    lines.append('  python .qoder/scripts/orchestration/wlkj.py context <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
+    # ★ 知识层健康检查：全迁 PG 后不再检查本地 kg.duckdb（已删除），改探活 MCP 知识层。
+    # 复用 .qoder/mcp_config.json 的 token+url，调 get_knowledge_health 拿真实健康分。
+    # best-effort：任何失败都不阻塞会话启动（与其它 hook 铁律一致）。
+    kg_info = None
+    try:
+        import json as _json
+        import urllib.request as _url
+        cfg_path = os.path.join(BASE, '.qoder', 'mcp_config.json')
+        if os.path.isfile(cfg_path):
+            _cfg = _json.load(open(cfg_path, encoding='utf-8'))
+            _srv = _cfg.get('mcpServers', {}).get('wlinkj-knowledge', {})
+            _url_s = _srv.get('url', '')
+            _tok = _srv.get('token', '')
+            if _url_s and _tok and _url_s != 'WILL_BE_FILLED_BY_WL_INIT':
+                _rpc = {"jsonrpc": "2.0", "id": 1, "method": "tools/call",
+                        "params": {"name": "get_knowledge_health", "arguments": {}}}
+                _req = _url.Request(_url_s, data=_json.dumps(_rpc).encode(),
+                                    headers={"Content-Type": "application/json",
+                                             "X-MCP-Token": _tok}, method="POST")
+                _resp = _url.urlopen(_req, timeout=4).read()
+                kg_info = _json.loads(_json.loads(_resp)["result"]["content"][0]["text"])
+    except Exception:
+        kg_info = None
+
+    if kg_info and isinstance(kg_info, dict) and "error" not in kg_info:
+        lines.append('  ✓ 知识层在线 (PG@5432): 健康分 %s / 覆盖 %s / 新鲜 %s / 完整 %s' % (
+            kg_info.get("score", "?"), kg_info.get("coverage", "?"),
+            kg_info.get("freshness", "?"), kg_info.get("completeness", "?")))
+        issues = kg_info.get("issues", []) or []
+        if issues and role in ('admin', 'dev'):
+            lines.append('  [提示] 健康问题: ' + '; '.join(str(i)[:60] for i in issues[:2]))
+    else:
+        lines.append('  [WARN] 知识层未响应（MCP 后端未启动？）')
+        lines.append('  → 启动: cd wlinkj-workspace && start_pg.bat（后端 :10010）')
+
+    return NL.join(lines)
+
+
+def get_style_info():
+    """Read style metadata for quick reference"""
+    meta = load_json_safe(os.path.join(BASE, 'data', 'index', 'ui-style-meta.json'))
+    if not meta:
+        return None
+
+    lines = []
+    lines.append('## UI Style Index')
+    lines.append('Style search: python .qoder/scripts/orchestration/wlkj.py style --style <table|form|modal>')
+    lines.append('Field search: python .qoder/scripts/orchestration/wlkj.py search --field <name>')
+
+    for proj, d in meta.get('projects', {}).items():
+        vue = d.get('vue_files', 0)
+        if vue > 0:
+            pt = d.get('page_types', {})
+            types_str = ', '.join([k + ':' + str(v) for k, v in pt.items() if v > 0])
+            lines.append('  ' + proj + ': ' + str(vue) + ' Vue (' + types_str + ')')
+
+    lines.append('Top components: ' + ', '.join(list(meta.get('common_components', {}).keys())[:8]))
+    lines.append('Field map: ' + str(meta.get('field_count', 0)) + ' entries')
+
+    if os.path.isdir(os.path.join(BASE, 'data', 'style')):
+        lines.append('Style PDFs: data/style/ (design specs, code takes priority)')
+
+    return NL.join(lines)
+
+
+def get_usability_summary():
+    """读工作流可用性指标, 把"不达标"项注入会话上下文。
+
+    吸收宿主 SessionStart hook 能力: 不用等用户跑 /wl-status, 每次开会话主动
+    暴露"工作流用没用起来"的红灯项。只展示红/黄 (绿的不打扰), 无数据则不显示。
+    (与 usability_score.py 同源逻辑, 但 hook 内联精简版, 避免 import 验证脚本拖慢启动)
+    """
+    lines = []
+    try:
+        # U2 一次过审率 (从 eval-history 取首条)
+        eval_path = os.path.join(BASE, 'data', 'learning', 'eval-history.jsonl')
+        records = []
+        if os.path.isfile(eval_path):
+            with open(eval_path, encoding='utf-8', errors='replace') as f:
+                for ln in f:
+                    ln = ln.strip()
+                    if ln:
+                        try:
+                            records.append(json.loads(ln))
+                        except Exception:
+                            continue
+        # 取最近 7 天
+        from datetime import datetime, timedelta
+        cutoff = datetime.now() - timedelta(days=7)
+        recent = []
+        for r in records:
+            t = r.get('time', '')
+            try:
+                if datetime.fromisoformat(str(t).split('.')[0]) >= cutoff:
+                    recent.append(r)
+            except Exception:
+                continue
+
+        issues = []  # 只收红/黄
+        if recent:
+            passed = sum(1 for r in recent if r.get('passed'))
+            rate = 100.0 * passed / len(recent)
+            if rate < 60:  # 黄线 30, 红线 60
+                tag = '🔴' if rate < 30 else '🟡'
+                issues.append('%s 一次过审率 %.0f%% (<60%% 目标) — PRD 质量需提升' % (tag, rate))
+
+        # U4 规则违反率 (从 feedback)
+        fb_dir = os.path.join(BASE, 'workspace', 'members')
+        violations = 0
+        prds_gen = 0
+        if os.path.isdir(fb_dir):
+            for dev in os.listdir(fb_dir):
+                fb = os.path.join(fb_dir, dev, 'journal', 'feedback.jsonl')
+                if not os.path.isfile(fb):
+                    continue
+                try:
+                    with open(fb, encoding='utf-8', errors='replace') as f:
+                        for ln in f:
+                            if '"rule_violation"' in ln:
+                                violations += 1
+                            elif '"prd_accepted"' in ln:
+                                prds_gen += 1
+                except Exception:
+                    continue
+        if prds_gen and violations:
+            vrate = 100.0 * violations / prds_gen
+            if vrate > 10:
+                tag = '🔴' if vrate > 25 else '🟡'
+                issues.append('%s 规则违反率 %.0f%% (>10%% 目标) — 关键规则没拦住' % (tag, vrate))
+
+        if issues:
+            lines.append('## Workflow Usability (近7天)')
+            lines.append('工作流"用不用得起来"红灯 (详情: wlkj.py usability):')
+            for it in issues:
+                lines.append('  ' + it)
+    except Exception:
+        pass  # hook 失败绝不阻塞会话
+    return NL.join(lines) if lines else ''
+
+
+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')
+        # role 真源在 member.json (.developer 常无 role= 行 → 显示 unknown)。
+        # 回退查 member.json, 再回退 'pm' (绝不显示 unknown, 误导 AI)。
+        role = dev.get('role')
+        if not role or role == 'unknown':
+            try:
+                mj = os.path.join(BASE, 'workspace', 'members', name, 'member.json')
+                if os.path.isfile(mj):
+                    m = json.load(open(mj, encoding='utf-8'))
+                    role = m.get('role') or 'pm'
+            except Exception:
+                pass
+            role = role or 'pm'
+        parts.append('Developer: ' + name + ' (' + role + ')')
+        parts.append('Workspace: workspace/members/' + name + '/')
+    else:
+        parts.append('Developer: NOT SET. Run /wl-init to register.')
+    team = get_team_size()
+    if team > 0:
+        parts.append('Team members: ' + str(team))
+    tasks = get_active_tasks()
+    if tasks:
+        parts.append('Active tasks:')
+        for t in tasks:
+            parts.append('  [' + t['status'] + '] ' + t['name'] + ' - ' + t['title'])
+
+    usability = get_usability_summary()
+    if usability:
+        parts.append('')
+        parts.append(usability)
+
+    parts.append('')
+
+    idx_info = get_index_info()
+    if idx_info:
+        parts.append('')
+        parts.append(idx_info)
+
+    style_info = get_style_info()
+    if style_info:
+        parts.append('')
+        parts.append(style_info)
+
+    parts.append('</qoder-context>')
+    # Hook-1: 健康标记 — AI 能感知 hook 是否真的跑了
+    # QoderWork/Quest 里看不到 [hook-ok] 就知道 hook 没生效, 要自取上下文
+    parts.append('<!-- [hook-ok] session-start hook ran successfully -->')
+    print(NL.join(parts))
+
+
+if __name__ == '__main__':
+    try:
+        main()
+    except Exception as e:
+        # A broken hook must never kill the session - emit minimal context
+        # 同时落盘到日志 (带轮转), 方便下次会话告警
+        _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)')
+        print('</qoder-context>')