`#1` 引入了 `loc_additions` 閾值——以「新增行數」評估批量,優先於 `loc_changes`——但**沒有任何設定檔範例帶這個欄位**,所以它在預設安裝下不會生效。 ## 現況 ``` $ grep -rn loc_additions src/presets/ examples/ .gitlab-analysis.example.yml (無結果) ``` `src/commands/release/init.ts:298` 讀 `template.analysis?.thresholds?.loc_additions`,恆為 `undefined`。因此 `src/commands/release/analyze.ts:214-218` 的「新增行數(生效中,優先於 LOC 變更)」區塊永遠不印,`calculateReleaseHealth` 也永遠走 `loc_changes` 的退路。 ## 為什麼這件事重要 `loc_changes` 是 additions + deletions,會把**清技術債的大規模刪除**判成和**大批量新功能**同級。舉例:一次重構淨刪 3000 行(新增 3000、刪除 6000),加總 9000 落在 warning;但實際新增只有 3000,風險遠低於一次新增 9000 行的功能批次。 `#1` 修好了這個判斷邏輯,但使用者要自己手改 YAML 才會啟用——而 YAML 裡沒有範例可抄。 ## 要改的檔案 需同步 **6 份設定檔**(不只 preset): | 檔案 | thresholds 位置 | 現有 `loc_changes` | |---|---|---| | `src/presets/semver.example.yml` | 108-131 | 4000 / 8000 / 8000 | | `src/presets/mobile-app.example.yml` | 76-99 | 5000 / 10000 / 10000 | | `src/presets/date-based.example.yml` | 67-90 | 2000 / 5000 / 5000 | | `.gitlab-analysis.example.yml`(根目錄) | 55-70 | 5000 / 10000 / 10000 | | `examples/gitlab-configs/.gitlab-analysis-ios.yml` | 48-63 | — | | `examples/gitlab-configs/.gitlab-analysis-android.yml` | 49-64 | — | 加上 `src/presets/README.md:192-209` 的「調整健康度閾值」範例區塊。 ## 閾值數字 建議**沿用各檔既有的 `loc_changes` 值**,不發明新比例。理由:`additions ≤ additions + deletions` 恆成立,所以用同一組數字判「只算新增」必然**不會比舊行為更嚴格**,既有使用者升級後不會突然被降級。`loc_additions` 的價值在「大規模刪除不再灌水」,與絕對值無關。 ## 驗收條件 不是「YAML 有那幾行」,而是**它真的被讀進去並生效**。這個 repo 已有反例:preset 裡的 `release_interval_days` 與 `code_freeze_days` 不在 `types/release-config.ts` 的 zod `ThresholdsSchema` 內,載入時被靜默 strip,而 `assessFreezePeriod` 用的是硬編碼常數(見 #6)。所以必須實測: ```bash ./bin/run.js release:init --preset mobile-app ... # 產出的 YAML 要含 loc_additions ./bin/run.js release:validate-config <該檔> # 必須通過 ./bin/run.js release:analyze --show-config ... # 必須印出「新增行數(生效中,優先於 LOC 變更)」 ``` 若 `--show-config` 沒印出那段,代表 `loc_additions` 在某一層被丟掉,要往上游追而不是改 YAML。 另補一條測試釘住「載入 preset 後 `thresholds.loc_additions` 不得為 `undefined`」,防止日後動 schema 又把它 strip 掉。
Activity