Эх сурвалжийг харах

chore: pre-commit 接入循环依赖阻断,暂存区含后端变更即自动校验

暂存区含 cfc-backend/ 或 tools/check_circular_deps.py 变更时,
自动运行 python3 tools/check_circular_deps.py;eager 环非空即返回非 0 阻断提交。
保留既有知识库校验(docs/参考资料/知识库)。

docs/scripts/install_git_hooks.sh 同步更新说明文案(core.hooksPath -> .githooks,幂等)。
Sisyphus 3 долоо хоног өмнө
parent
commit
ee4c9fdeb7

+ 25 - 5
.githooks/pre-commit

@@ -1,13 +1,33 @@
 #!/usr/bin/env bash
-# 知识库提交前校验:暂存区含 docs/参考资料/知识库 变更时自动运行校验脚本。
+# 提交前校验:
+# 1) 知识库校验:暂存区含 docs/参考资料/知识库 变更时运行 docs/scripts/validate_kb.py
+# 2) 循环依赖校验:暂存区含 cfc-backend/ 或 tools/check_circular_deps.py 变更时运行
+#    tools/check_circular_deps.py;eager 循环依赖非空则阻断提交。
 # 阻断不合规提交(返回非 0 时 git commit 会失败),可用 git commit --no-verify 跳过。
+#
+# 启用方式:bash docs/scripts/install_git_hooks.sh(core.hooksPath -> .githooks,幂等)
 set -euo pipefail
 
 ROOT="$(git rev-parse --show-toplevel)"
 KB_DIR="docs/参考资料/知识库"
-VALIDATOR="$ROOT/docs/scripts/validate_kb.py"
+KB_VALIDATOR="$ROOT/docs/scripts/validate_kb.py"
+CIRCULAR_CHECKER="$ROOT/tools/check_circular_deps.py"
 
+PY_BIN="$(command -v python3 || command -v python || true)"
+
+# 1) 知识库校验
 if git diff --cached --name-only -- "$KB_DIR" | grep -q .; then
-  echo "[pre-commit] 检测到知识库变更,运行校验: $VALIDATOR"
-  python3 "$VALIDATOR" "$ROOT/$KB_DIR"
-fi
+  echo "[pre-commit] 检测到知识库变更,运行校验: $KB_VALIDATOR"
+  "$PY_BIN" "$KB_VALIDATOR" "$ROOT/$KB_DIR"
+fi
+
+# 2) 循环依赖强约束(eager 环非空 → 阻断提交)
+STAGED_FILES="$(git diff --cached --name-only)"
+if grep -qE '^(cfc-backend/|tools/check_circular_deps\.py$)' <<< "$STAGED_FILES"; then
+  if [ -z "$PY_BIN" ]; then
+    echo "[pre-commit] 未找到 python3/python,无法执行循环依赖检查(请先安装 Python)" >&2
+    exit 1
+  fi
+  echo "[pre-commit] 检测到后端代码变更,运行循环依赖检查: $CIRCULAR_CHECKER"
+  "$PY_BIN" "$CIRCULAR_CHECKER"
+fi

+ 4 - 2
docs/scripts/install_git_hooks.sh

@@ -1,9 +1,11 @@
 #!/usr/bin/env bash
-# 安装仓库级 git hooks:将 core.hooksPath 指向 .githooks/,启用提交前知识库校验。
+# 安装仓库级 git hooks:将 core.hooksPath 指向 .githooks/,启用提交前校验:
+# 1) 知识库校验(docs/参考资料/知识库 变更)
+# 2) 后端循环依赖强约束(cfc-backend/ 或 tools/check_circular_deps.py 变更,eager 环阻断)
 # 幂等,可重复执行。
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
 git -C "$ROOT" config core.hooksPath .githooks
 echo "hooksPath -> $(git -C "$ROOT" config core.hooksPath)"
-echo "已启用: $ROOT/.githooks/pre-commit (知识库提交前校验)"
+echo "已启用: $ROOT/.githooks/pre-commit (知识库 + 循环依赖 提交前校验)"