feat: 会话实测优化——executable 键契约/scope 子仓排除/规则聚合/审计明细

[loong10k]

背景

基于 opencli-java-sdk + codex-java-sdk 六分支发布/审计会话实测的痛点修复（POM 4.1.0 + mvnw 仓库的 Java 门禁、跨仓误伤、whack-a-mole 报错揭示）。

修复项

P0 mvnw 感知死代码（生产者-消费者键不匹配）

• gate_lib Java 门禁读取 _jp.get("executable")，但 java_project.analyze 从不产出该键（wrapper 只体现在 commands[0].argv[0]）→ 替换逻辑恒不触发，POM 4.1.0 仓库照旧走裸 mvn 必失败
• 修复：java_project 产出顶层 executable 键；gate_lib 增加回退纯函数 _java_executable_from_plan（顶层键 → commands argv 里的 mvnw/gradlew）
• 新增契约测试：可执行 mvnw → ./mvnw；缺失 → mvn；不可执行 → UNVERIFIED + 原因含"不可执行"
• UNVERIFIED 消息附自救提示：chmod +x mvnw

scope 子 git 仓排除（跨仓误伤根治）

• 非 git 根（会话工作区根）的全量扫描：排除直接子目录中自带 .git 的独立仓库——它们由各自的提交门禁负责
• 实测误伤场景：workspace 根的 push 脚本触发门禁时，根级脚本与子仓文件混在同一份报告

报告质量

• gate_directive 首行显式标注"本次门禁目标仓库"——cwd 漂移扫到非目标仓时 AI 第一时间发现
• ruff 输出规则聚合计数行（EXE001×2 DTZ011×1）——治理 whack-a-mole 逐条揭示
• python 发现含 [*] 时附加 ruff check --fix 精确命令
• 仓库级 skipGate 补作用域警告（对该克隆所有分支生效、跨会话残留、务必 unset）
• UNVERIFIED（wrapper 缺执行位）附 chmod +x mvnw 自救提示
• record_skip_event 增加可选 detail：skipGate-read-error 与 monorepo-fallback 事件记录具体原因（豁免/跳过可回溯到"哪个仓、什么时候、为什么"）

测试

• 新增 tests/test_session_pain_fixes.py：17 用例（executable 契约 ×3、消费纯函数 ×4、目标仓标签 ×3、[可自动修复提示 ×2、规则聚合 ×2、子仓排除 ×3——含"git 仓根不加子仓排除"的反向断言）
• 夹具 pom 为完整最小 POM（缺 artifactId 会让 _maven 前置失败恒 UNVERIFIED，契约测试无法到达 executable 断言——首跑实测）

验证

• unittest discover -s tests -p 'test_*.py'：269+ 全绿（skipped=4 为环境条件跳过）
• python3 tests/run_all.py：141 通过 / 0 失败 / 0 跳过
• ruff check hooks/ scripts/ tests/：All checks passed