@hupan56/wlkj 3.3.13 → 3.3.15

package/templates/qoder/hooks/pre-tool-use-commit.py

@@ -1,124 +1,124 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""pre-tool-use-commit.py - P0-3 w3: wl-commit msg 门禁（PreToolUse on Bash git commit）
-
-stop-eval.py 里 _enforce_commit_msg_gate 的**正确落点**：pre-tool-use（commit 执行前验 msg），
-而非 stop-eval（后者 git log -1 不分"本轮 wl-commit" vs 平台开发/工具 commit → 误拦）。
-
-做法（确定性 + 不误拦其他）：
-  1. PreToolUse 命中 Bash + command 含 "git commit"
-  2. 提取 -m 消息（兼容 -m "x" / -m 'x' / --message=x / 多 -m）
-  3. 查需求关联标记 [#REQ-<uuid>] (S3) 或 [#<禅道号>] (S5.1)
-  4. 缺标记：
-     - 默认 ADVISORY（exit 0 + stdout 强提醒）—— 不阻断，避免误拦工具/平台/文档 commit
-     - 环境变量 WLCOMMIT_GATE_BLOCK=1 时 → exit 2 硬拦（wl-commit 强流程场景才开）
-
-铁律：永远 exit 0（除非 BLOCK 模式显式开）；失败 try/except 静默（hook 崩绝不阻塞）。
-非 git commit 命令 / 非 Bash → exit 0。
-"""
-import json
-import os
-import re
-import sys
-
-if sys.platform == 'win32':
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-        sys.stderr.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')
-
-# 需求关联标记：[#REQ-xxx] 或 [#123]（禅道号）
-_REQ_TAG_RE = re.compile(r'\[#REQ-[\w-]+\]|\[#\d+\]')
-# 提取 git commit -m 的消息（兼容引号/多段/--message= / 组合短旗 -am）
-# (?:^|\s)-[a-zA-Z]*m  匹配 -m / -am / -cm 等（单 dash 短旗组合；空白前缀避 --message 误匹）
-_M_QUOTED = re.compile(r'''(?:^|\s)-[a-zA-Z]*m\s*(['"])(.*?)\1''', re.S)
-_M_BARE = re.compile(r'(?:^|\s)-[a-zA-Z]*m\s+(\S.*?)\s*(?=(?:^|\s)-[a-zA-Z]*m\s|$)', re.S)
-_MSG_EQ = re.compile(r'(?:^|\s)--message=(\S.*?)\s*(?:--|$)', re.S)
-
-
-def _read_stdin():
-    try:
-        raw = sys.stdin.read()
-        if raw and raw.strip():
-            return json.loads(raw)
-    except Exception:
-        pass
-    return {}
-
-
-def _extract_msg(command):
-    """从 git commit 命令里提取 commit message（拼多 -m）。提不到返 ''。"""
-    if "--message=" in command:
-        m = _MSG_EQ.search(command)
-        if m:
-            return m.group(1).strip()
-    # 所有 -m "..." / -m '...' 段拼接
-    parts = _M_QUOTED.findall(command)  # [(quote, msg), ...]
-    if parts:
-        return "\n".join(p[1] for p in parts).strip()
-    # 裸 -m word（无引号）
-    m = _M_BARE.search(command)
-    if m:
-        return m.group(1).strip()
-    return ""
-
-
-def _log_err(line):
-    from datetime import datetime
-    try:
-        os.makedirs(os.path.dirname(HOOK_ERRORS_LOG), exist_ok=True)
-        with open(HOOK_ERRORS_LOG, 'a', encoding='utf-8') as f:
-            f.write('[{}] pre-tool-use-commit: {}{}'.format(
-                datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(line)[:200], NL))
-    except Exception:
-        pass
-
-
-def main():
-    data = _read_stdin()
-    tool = data.get("tool_name") or data.get("tool") or ""
-    if tool.lower() not in ("bash", "shell", "execute_bash"):
-        sys.exit(0)
-    tinput = data.get("tool_input") or data.get("input") or {}
-    command = tinput.get("command") or tinput.get("cmd") or ""
-    if not isinstance(command, str) or "git commit" not in command:
-        sys.exit(0)
-    # 跳过 --amend 无 -m / 自动生成（如 merge commit）—— 只验带 -m 的显式 commit
-    msg = _extract_msg(command)
-    if not msg:
-        sys.exit(0)  # 提不到 -m（可能 -F 文件或 amend），不拦
-    if _REQ_TAG_RE.search(msg):
-        sys.exit(0)  # 含需求标记，放行
-
-    # 缺标记
-    block_mode = os.environ.get("WLCOMMIT_GATE_BLOCK", "").lower() in ("1", "true", "yes")
-    preview = msg.replace("\n", " ")[:100]
-    if block_mode:
-        sys.stderr.write(
-            '【wl-commit msg 门禁·硬拦】commit msg 缺需求关联标记:\n  %s\n'
-            '修复: git commit --amend 补 [#REQ-<uuid>] (S3) 或 [#<禅道号>] (S5.1 push 后)。\n'
-            '(此硬拦由 WLCOMMIT_GATE_BLOCK=1 开启；平台/工具/文档 commit 关该 env 或走非 wl-commit 流程。)\n'
-            % preview)
-        sys.exit(2)
-    # 默认 advisory：不阻断，强提醒
-    sys.stdout.write(
-        '⚠️ 【wl-commit msg 提醒】本次 commit msg 缺需求关联标记 [#REQ-xxx]/[#禅道号]:\n'
-        '  %s\n'
-        '若这是 /wl-commit 流程，建议 amend 补标记关联需求(F1 闭环数据)；'
-        '若是平台/工具/文档 commit 可忽略本提醒。\n' % preview)
-    sys.exit(0)
-
-
-if __name__ == "__main__":
-    try:
-        main()
-    except SystemExit:
-        raise
-    except Exception as e:
-        _log_err("fatal: %s" % str(e)[:150])
-        sys.exit(0)  # 永不阻塞
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""pre-tool-use-commit.py - P0-3 w3: wl-commit msg 门禁（PreToolUse on Bash git commit）
+
+stop-eval.py 里 _enforce_commit_msg_gate 的**正确落点**：pre-tool-use（commit 执行前验 msg），
+而非 stop-eval（后者 git log -1 不分"本轮 wl-commit" vs 平台开发/工具 commit → 误拦）。
+
+做法（确定性 + 不误拦其他）：
+  1. PreToolUse 命中 Bash + command 含 "git commit"
+  2. 提取 -m 消息（兼容 -m "x" / -m 'x' / --message=x / 多 -m）
+  3. 查需求关联标记 [#REQ-<uuid>] (S3) 或 [#<禅道号>] (S5.1)
+  4. 缺标记：
+     - 默认 ADVISORY（exit 0 + stdout 强提醒）—— 不阻断，避免误拦工具/平台/文档 commit
+     - 环境变量 WLCOMMIT_GATE_BLOCK=1 时 → exit 2 硬拦（wl-commit 强流程场景才开）
+
+铁律：永远 exit 0（除非 BLOCK 模式显式开）；失败 try/except 静默（hook 崩绝不阻塞）。
+非 git commit 命令 / 非 Bash → exit 0。
+"""
+import json
+import os
+import re
+import sys
+
+if sys.platform == 'win32':
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+        sys.stderr.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')
+
+# 需求关联标记：[#REQ-xxx] 或 [#123]（禅道号）
+_REQ_TAG_RE = re.compile(r'\[#REQ-[\w-]+\]|\[#\d+\]')
+# 提取 git commit -m 的消息（兼容引号/多段/--message= / 组合短旗 -am）
+# (?:^|\s)-[a-zA-Z]*m  匹配 -m / -am / -cm 等（单 dash 短旗组合；空白前缀避 --message 误匹）
+_M_QUOTED = re.compile(r'''(?:^|\s)-[a-zA-Z]*m\s*(['"])(.*?)\1''', re.S)
+_M_BARE = re.compile(r'(?:^|\s)-[a-zA-Z]*m\s+(\S.*?)\s*(?=(?:^|\s)-[a-zA-Z]*m\s|$)', re.S)
+_MSG_EQ = re.compile(r'(?:^|\s)--message=(\S.*?)\s*(?:--|$)', re.S)
+
+
+def _read_stdin():
+    try:
+        raw = sys.stdin.read()
+        if raw and raw.strip():
+            return json.loads(raw)
+    except Exception:
+        pass
+    return {}
+
+
+def _extract_msg(command):
+    """从 git commit 命令里提取 commit message（拼多 -m）。提不到返 ''。"""
+    if "--message=" in command:
+        m = _MSG_EQ.search(command)
+        if m:
+            return m.group(1).strip()
+    # 所有 -m "..." / -m '...' 段拼接
+    parts = _M_QUOTED.findall(command)  # [(quote, msg), ...]
+    if parts:
+        return "\n".join(p[1] for p in parts).strip()
+    # 裸 -m word（无引号）
+    m = _M_BARE.search(command)
+    if m:
+        return m.group(1).strip()
+    return ""
+
+
+def _log_err(line):
+    from datetime import datetime
+    try:
+        os.makedirs(os.path.dirname(HOOK_ERRORS_LOG), exist_ok=True)
+        with open(HOOK_ERRORS_LOG, 'a', encoding='utf-8') as f:
+            f.write('[{}] pre-tool-use-commit: {}{}'.format(
+                datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(line)[:200], NL))
+    except Exception:
+        pass
+
+
+def main():
+    data = _read_stdin()
+    tool = data.get("tool_name") or data.get("tool") or ""
+    if tool.lower() not in ("bash", "shell", "execute_bash"):
+        sys.exit(0)
+    tinput = data.get("tool_input") or data.get("input") or {}
+    command = tinput.get("command") or tinput.get("cmd") or ""
+    if not isinstance(command, str) or "git commit" not in command:
+        sys.exit(0)
+    # 跳过 --amend 无 -m / 自动生成（如 merge commit）—— 只验带 -m 的显式 commit
+    msg = _extract_msg(command)
+    if not msg:
+        sys.exit(0)  # 提不到 -m（可能 -F 文件或 amend），不拦
+    if _REQ_TAG_RE.search(msg):
+        sys.exit(0)  # 含需求标记，放行
+
+    # 缺标记
+    block_mode = os.environ.get("WLCOMMIT_GATE_BLOCK", "").lower() in ("1", "true", "yes")
+    preview = msg.replace("\n", " ")[:100]
+    if block_mode:
+        sys.stderr.write(
+            '【wl-commit msg 门禁·硬拦】commit msg 缺需求关联标记:\n  %s\n'
+            '修复: git commit --amend 补 [#REQ-<uuid>] (S3) 或 [#<禅道号>] (S5.1 push 后)。\n'
+            '(此硬拦由 WLCOMMIT_GATE_BLOCK=1 开启；平台/工具/文档 commit 关该 env 或走非 wl-commit 流程。)\n'
+            % preview)
+        sys.exit(2)
+    # 默认 advisory：不阻断，强提醒
+    sys.stdout.write(
+        '⚠️ 【wl-commit msg 提醒】本次 commit msg 缺需求关联标记 [#REQ-xxx]/[#禅道号]:\n'
+        '  %s\n'
+        '若这是 /wl-commit 流程，建议 amend 补标记关联需求(F1 闭环数据)；'
+        '若是平台/工具/文档 commit 可忽略本提醒。\n' % preview)
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except SystemExit:
+        raise
+    except Exception as e:
+        _log_err("fatal: %s" % str(e)[:150])
+        sys.exit(0)  # 永不阻塞