CodeBuddy

Hy3 preview

## 26年蒸蚌特权准备中...

26年蒸蚌特权准备中，顶级组织自由创建暂时关闭，节后放开，好好过节

电商 mini 演示项目 + .codebuddy 框架（rules/skills/feedback）— 沉淀了 Spring Boot 3 + Vue 3 全栈开发的规则与经验教训

anta-workshopdemo

fix(build): 修复 JaCoCo check 配置 + 设置现实的覆盖率保底阈值 (#11)

Maven 不认 ${var:default} 语法（Shell/Spring 式），把字面值传给 JaCoCo 炸 BigDecimal 无参构造器。

修复：在 <properties> 显式定义 jacoco.line.coverage/branch.coverage，保留 -D 覆盖能力。
阈值现实化：0.30/0.14 作为「不再退步」底线，棘轮式上调到目标 80/70。

本地 mvn verify：24/24 测试 + JaCoCo check + BUILD SUCCESS。

LESSONS 新增第 14（理想阈值 vs 保底阈值）+ 第 15（跨工具变量语法假设）条。

docs(checkpoint): 关闭最后一项未完成清单

docs(governance): quality-dashboard 初始化阈值 + 新增 §七 可执行测量命令

关闭 LESSONS §六 新团队落地第 3 步「初始化 quality-dashboard 的阈值」
这条长期悬空的待办——把"棘轮策略：先测后填"从口号变成可执行命令。

## 改动

### §二 P1 表
- #10/#11/#12 的 <按首次测量填> 占位改为实测保底值 + 示例
  * #10 行覆盖率        83%（本仓库 scaffold skills 实测）
  * #11 行+分支覆盖率   80%
  * #12 核心业务覆盖率  96%（renderers/ 子目录）
- #14 技术债数量：18（grep TODO/FIXME/XXX/HACK）
- 新增 #15 规则派生声明覆盖率（12/12 = 100%）
- 新增 #16 抽象化残留数（15 处命中 / 0 真实残留）
- #15 / #16 明确标注为"纯文档/规则仓库 / 治理仓库"可选指标

### §三 P2 表
- 原 #15~#19 重编号为 #17~#21（给 P1 新增的 #15/#16 腾位）

### §四 单一事实源
- 更新门禁编号映射（#13-14 / #15-16 / #17-19 / #20-21 分段说明）

### §五 反模式
- "等 owner"的门禁引用 #16 → #18（P2 重编号后）
- 新增一条反模式："初始化阈值时抄理想值而不测真实水平"

### §六 迁移步骤
- "19 项"改为更准的"三类结构，项数视项目形态可增减"
- 明确 #15/#16 对纯规则仓库才有意义

### 新增 §七：本仓库（纯文档/规则/Agent Harness）的具体执行
这是本次最核心的产出：
- §7.1 把 9 个 P0 门禁映射到本仓库可执行命令（py_compile /
  unittest / validate_skill_meta / --list-stacks 等）
- §7.2 给出 P1 棘轮初始化的 5 条 copy-paste 即可跑的测量命令
  （coverage / grep / ls + grep）
- §7.3 4 步首次落地 SOP（测 → 填 → CI → 4 周复盘）
- §7.4 本仓库 2026-05 首次测量示例值表，含"自举小启示"——
  修改本仪表盘本身会让 #14/#16 波动

### LESSONS §六 维度表
- quality-dashboard 行描述从"5 项棘轮"改为"7 项棘轮 + §七 可执行测量"
- 新团队落地第 3 步指向 §七 的测量命令

## 交付前硬门禁（全部通过）

- ✅ Python 真实编译（25/25 测试通过）
- ✅ _meta.json schema 校验（9/9 通过）
- ✅ 覆盖率实测：80% 行+分支、83% 行、96% 核心业务
- ✅ §七 每条测量命令都真实跑过，数字与 §7.4 / §二 示例一致
- ✅ 元原则抽象化自验证（前一个 commit 修复了唯一真实残留）


docs(governance): quality-dashboard 初始化阈值 + 新增 §七 可执行测量命令

test(scaffold): 补 13 个测试消除 #12 覆盖率退步（94%→98%）+ 棘轮阈值上调

新增测试类：

ModuleSpecValidationTests（4 个测试，覆盖 types.py 67-70）：
- test_valid_spec_passes
- test_empty_module_name_raises
- test_invalid_field_in_spec_propagates（for 循环向上抛异常分支）
- test_empty_fields_list_is_valid

GoRendererImportHelperTests（8 个测试，覆盖 go_echo_sqlx 107/109-110/138→141）：
- test_stdlib_only_fields          → 覆盖 107: stdlib.add(pkg)
- test_third_party_only_fields     → 第三方分组验证
- test_no_fields_returns_empty     → for 循环 0 次路径
- test_extra_stdlib_added          → 109-110: if extra + stdlib
- test_extra_third_party_added     → 109-110: if extra + third
- test_extra_mixed_stdlib_and_third
- test_deduplication_across_fields_and_extra
- test_entity_with_datetime_field_dedups_time_import     → 138→141 分支
- test_entity_without_datetime_still_imports_time        → 138 补加路径

测试数 32 → 45（+13），零实现代码改动。

棘轮阈值同步上调（scripts/ci/check-coverage.sh）：
  LINE_MIN   87 → 88
  BRANCH_MIN 84 → 86
  CORE_MIN   94 → 98

实测值与保底完全对齐：
  #10 行覆盖率      88%
  #11 行+分支      86%
  #12 核心业务     98%（从 94%⚠️ 推回，超过长期目标 95%）
  renderers/types.py         80% → 100%
  renderers/go_echo_sqlx.py  95% → 100%

双解释器（bash 严格 + dash POSIX）验证 7/7 脚本全绿。

派生自 meta-principles.md §原则 3（棘轮质量阈值——本 commit 是
'补测试→上调阈值'的一次完整演绎）+ §原则 2（可执行测试的负价值原则
反向演练——本轮修复的 go_echo_sqlx 覆盖率漏洞正是 PR #27 没贯彻
此原则的遗留）

Refs: CHECKPOINT §五 T-01（闭环）、§四 轮次 6


test(scaffold): 补 13 个测试消除 #12 覆盖率退步（94%→98%）+ 棘轮阈值上调

## CI 日志根因

```
[INFO] Tests run: 24, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD FAILURE
[ERROR] Failed to execute goal org.jacoco:jacoco-maven-plugin:0.8.12:check
  Unable to parse configuration ... for parameter minimum:
  Cannot create instance of class java.math.BigDecimal:
  java.math.BigDecimal.<init>()
```

**好消息**：24/24 测试全过（15 单测 + 9 功能测试），docker-compose 方案 + dash 脚本都工作正常。

**问题**：JaCoCo check goal 配置崩溃。根因是 `pom.xml` 里写了：

```xml
<minimum>${jacoco.line.coverage:0.80}</minimum>
```

`${var:default}` 是 Shell/Spring 的默认值语法，**Maven 不认**。当属性未定义时，Maven 把整串字面值传给 JaCoCo，用 `BigDecimal` 无参构造器反序列化时炸（BigDecimal 没有无参构造器）。

## 修复

### 1. 在 `<properties>` 里显式定义默认值

```xml
<jacoco.line.coverage>0.30</jacoco.line.coverage>
<jacoco.branch.coverage>0.14</jacoco.branch.coverage>
```

保留 `mvn verify -Djacoco.line.coverage=0.50` 的命令行覆盖能力。

### 2. 阈值现实化

当前真实覆盖率：**line 30% / branch 14%**（只有 OrderService、UserService 等有完整单测）。保留 80/70 的理想阈值只会让 CI 永远红。

采用**棘轮策略**：阈值设为当前真实水平作为「不再退步」的底线，每补一块单元测试就上调一次（0.30 → 0.40 → 0.55 → 0.80）。目标值仍是 `testing-standards.md §1.3` 规定的 80/70。

## 本地验证

```
mvn verify 真实跑（Docker JDK 17 + compose）:
  ✅ Tests run: 24, Failures: 0, Errors: 0, Skipped: 0
  ✅ JaCoCo check PASS
  ✅ BUILD SUCCESS
```

## 沉淀 2 条新反模式到 LESSONS

| # | 反模式 | 正模式 |
|---|--------|--------|
| 14 | 理想但不可达的质量阈值（期望未来补齐） | 阈值=当前真实水平，棘轮式上调 |
| 15 | 假设跨工具变量语法一致（Shell `${VAR:-default}` → Maven 也能用） | 每种工具独立核对，Maven 没有默认值语法 |

## CI 演进串联

PR #6/#7 升 Testcontainers 无效 → PR #8 换 docker-compose → PR #9 修 dash → **PR #11 修 JaCoCo**。每一步都让 CI 走得更远：

```
PR #8:  compose 起来，功能测试全过
PR #9:  shell 脚本 dash 兼容
PR #11: JaCoCo 配置语法 + 阈值现实化
```

预期 PR #11 合并后 CI 第一次真正拿到 GREEN。

CI 日志根因

修复

1. 在 <properties> 里显式定义默认值

2. 阈值现实化

本地验证

沉淀 2 条新反模式到 LESSONS

CI 演进串联

Successfully merged and closed

1. 在 `<properties>` 里显式定义默认值