Skip to content

loc_additions 閾值沒有任何設定檔範例帶,新的批量判準預設不生效 #2

Closed

Description

@lis186

#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)。所以必須實測:

./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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions