一份 JSON，兩道決策。

1. 先強制全量：根目錄 go.mod、go.sum、build-lambda.sh、Makefile、bitbucket-pipelines.yml，以及 tracked vendor/**。
2. 再看刪除 / rename 舊側的 .lambda.csda：直接要求全量，不受無關目錄規則豁免。
3. 正向歸屬：Lambda 源碼目錄、直接 / 傳遞 Go 依賴、go:embed；找到就累加 selected 與 reasons。
4. 無歸屬才忽略根目錄：docs / plans / openapi / localstack / stepfunctions / .devcontainer / fargate / php_fargate / saas / cmd / scripts / sidecar；此規則適用新增、修改、刪除及 rename 兩側。
5. 一般檔案忽略：_test.go、Dockerfile*、.dockerignore 只適用還存在的一側；刪除或 rename 舊側若無其他可歸屬 / 可忽略證據，會 fall back。
6. 其餘：unclassified change... → all。例如根目錄 README.md 不等同 docs/**，也可能觸發全量。

注意：目前即使 diff 為空，也會先做依賴與 gitignored 建置輸入檢查，通過後才可能 none。

• firstRelease：完整歷史的本地倉庫沒有 tag，或唯一 tag 正好就在 HEAD。
• undetermined：shallow clone、Git 查詢失敗、HEAD 有多個 tag、候選基準 commit 有多個 tag、有其他 tag 但 first-parent 歷史找不到可用 tag等。
• found：HEAD 在 tag 上，找前一個 first-parent tag；不在 tag 上，找 first-parent 歷史最近 tag；解析為 commit SHA 並確認唯一 tag。
• 沒有 tag 名稱 pattern 過濾，也不做網路 fetch；CI 須先準備完整歷史與 tag。@v1.0.0 是工具版本，不是業務 repo 的比較基準。

兩張圖都已由本機 D2 0.7.1 編譯為 SVG，HTML 內嵌圖檔，不依賴 CDN 或瀏覽器即時 D2 渲染。

d2 --layout elk --pad 32 --no-xml-tag --salt cli cli-flow.d2 cli-flow.svg
d2 --layout elk --pad 32 --no-xml-tag --salt state impact-state.d2 impact-state.svg

CLI flow

shape: sequence_diagram
style: {fill: "#ffffff"; stroke: "#cbd5e1"; font-size: 18}
shell: "使用者 / CI shell" {style: {fill: "#e0f2fe"; stroke: "#0284c7"; font-color: "#0c4a6e"}}
cli: "CLI · Cobra / main.go" {style: {fill: "#e0f2fe"; stroke: "#0284c7"; font-color: "#0c4a6e"}}
engine: "Discover / Impact / Build" {style: {fill: "#f1f5f9"; stroke: "#94a3b8"; font-color: "#172b46"}}
disk: "業務 repo / build 目錄" {style: {fill: "#dcfce7"; stroke: "#16a34a"; font-color: "#14532d"}}
impact: "第 1 次 CLI 呼叫：產生分析 JSON" {
  shell -> cli: "lets-lambda-build impact\nmain → newRootCmd → newImpactCmd.RunE"
  cli -> disk: "1. clearBaseVersionFile()\n清除舊 build/base_version.txt"
  cli -> engine: "2. discover.Discover(repoRoot)\n掃描 *.lambda.csda，取得清單"
  cli -> engine: "3. impact.Compute(base, head)\nGit 差異 + Go 依賴 + 安全檢查"
  engine -> cli: "ImpactResult：all / partial / none\n若回傳 error，停止且不寫新分析 JSON" {style.stroke-dash: 5}
  cli -> disk: "4. writeJSON()\n預設 build/lambda-impact.json"
}
build: "第 2 次 CLI 呼叫：讀取 JSON，決定建置範圍" {
  shell -> cli: "lets-lambda-build build\n--impact-file build/lambda-impact.json"
  cli -> disk: "5. 清除舊 base_version.txt"
  cli -> engine: "6. Discover：重新掃描當前 Lambda"
  cli -> disk: "7. selectByImpactFile()\nReadFile + Unmarshal → 按 mode 選取"
  cli -> cli: "8. baseVersionFromImpact()\n所有 mode 檢查 HEAD / baseStatus / tag\n不可信 → 編譯前報錯停止"
  cli -> engine: "9. build.Build(selected)\n清舊 zip → 編譯 / 打包\nnone：不編譯，但仍清舊 zip"
  engine -> cli: "建置結果；有失敗就停止" {style.stroke-dash: 5}
  cli -> disk: "10. 全部成功才處理 base_version.txt\nfound：寫入 tag；firstRelease：不寫入"
}

Impact state

direction: down
classes: {
  step: {
    style: {fill: "#f1f5f9"; stroke: "#94a3b8"; font-color: "#172b46"; border-radius: 12; font-size: 18}
  }
  check: {
    style: {fill: "#e0f2fe"; stroke: "#0284c7"; font-color: "#0c4a6e"; border-radius: 12; font-size: 18}
  }
  all: {
    style: {fill: "#fff1d6"; stroke: "#d97706"; font-color: "#78350f"; border-radius: 12; font-size: 18}
  }
  error: {
    style: {fill: "#ffe4e6"; stroke: "#e11d48"; font-color: "#881337"; border-radius: 12; font-size: 18}
  }
  good: {
    style: {fill: "#dcfce7"; stroke: "#16a34a"; font-color: "#14532d"; border-radius: 12; font-size: 18}
  }
}
start: "impact.Compute()\n每次重新分析，不讀取上次結果" {class: check}
head: "① HEAD 可解析，且等於目前 checkout？" {class: check}
base: "② 解析比較基準\n省略 --base：ResolveBaseTag()\n明確 --base：ResolveCommit() + TagAtCommit()" {class: check}
preflight: "③ 依序通過安全檢查\nWorkingTreeStatus → git diff\n→ go list -deps → IgnoredPaths\n→ ignoredBuildInputReason" {class: check}
init: "④ 進入逐檔分類\nselected = {} / reasons = {} / fallback = 空" {class: step}
classify: "每個變更路徑，依優先序分類\n1. 強制全量檔案 / tracked vendor\n2. 被刪除或 rename 舊側的 .lambda.csda\n3. Lambda 目錄 / Go 依賴 / go:embed 歸屬\n4. 無關根目錄 / 安全檔案類型\n5. 無法分類 → fallback\nrename：舊側與新側都分類" {class: step}
latch: "收集結果，處理剩餘變更\n可歸屬 → 累加 selected / reasons\n有 fallback → 只記第一個原因\n已記錄的 fallback 不清除、不覆蓋" {class: step}
finish: "⑤ 全部分類完成\nfallback 是否非空？" {class: check}
selected: "⑥ selected 是否為空？" {class: check}
all: "mode = all\nfallbackReason = 第一個觸發原因\n不輸出 lambdas / reasons\nCompute 回傳 result, nil" {class: all}
none: "mode = none\n不輸出 fallbackReason\n不輸出 lambdas / reasons" {class: good}
partial: "mode = partial\n輸出 lambdas + reasons\n不輸出 fallbackReason\n即使選中全部，也仍是 partial" {class: good}
error: "error（不是 mode）\n非零退出，不寫新結果\n舊 JSON 可能仍留在磁碟" {class: error}
output: "CLI writeJSON()\n寫檔成功 → impact 退出 0\n寫檔失敗 → 非零退出" {class: step}
start -> head
head -> error: "否" {style.stroke: "#e11d48"}
head -> base: "是"
base -> all: "自動：firstRelease / undetermined\n或明確 base 無法解析" {style.stroke: "#d97706"}
base -> preflight: "有可用 commit\n明確 base 無唯一 tag 仍繼續\n但 baseStatus = undetermined"
preflight -> all: "查詢 / 分析失敗、dirty tree\n或 gitignored 建置輸入" {style.stroke: "#d97706"}
preflight -> init: "全部通過"
init -> classify -> latch -> finish
finish -> all: "是（fallback 優先）" {style.stroke: "#d97706"}
finish -> selected: "否"
selected -> none: "是"
selected -> partial: "否"
all -> output
none -> output
partial -> output