docs(release-cleanup): 文件化補齊、日誌格式統一與 CI 自我清理管線 #9

Merged
admin merged 5 commits from ai-review-resolve/develop-20260630-182903 into develop 2026-07-01 01:10:25 +00:00
Member

變更摘要

彙整本次 release-cleanup action 的文件化、CI 強化與日誌格式修正(共 5 個 commit),目標分支 develop

重點變更

  • app/index.js(日誌格式):統一為 [階段][等級][時間]: 訊息。新增 stage() 設定目前階段、timestamp() 取 Asia/Taipei 時間、formatLog() 共用組裝;等級 INF(含成功)/WRN/ERR。階段為 參數檢查取得舊版本刪除舊版本。移除舊的 separator()/section() 分隔區塊(啟動橫幅改由 entrypoint.sh 輸出)。對外行為、控制流、exit code 不變;fail 走 stderr、其餘走 stdout。
  • .gitea/workflows/ci.yaml:改為 PR 觸發的 release-tag-version(is_beta) → release-cleanup 自我清理管線(dogfooding),補齊逐行註解與正確的開頭用途註解。
  • .gitea/workflows/cd.yaml:補齊「用途+更新日期」同一註解區塊與逐行註解。
  • entrypoint.sh:更新容器啟動橫幅的產生時間戳。
  • README.md:重建專案列表、功能列表、使用範例;新增「日誌輸出格式」章節(含 [階段][等級][時間] 說明),並更新為新的公開函式面(含 stage/timestamp/formatLog)。

影響範圍

  • 唯一對外行為變更:action 的 CI log 行格式改為 [階段][等級][時間](判斷邏輯、exit code、輸出串流不變)。
  • ci.yaml 觸發內容改變:PR 開啟/同步時會標 beta 版並執行 release-cleanup(自我清理)。

風險/注意事項

  • 若有既有的 log 解析流程,需留意日誌行格式已改變(新增 [階段] 前綴與等級碼)。
  • 請確認 ci.yaml dogfooding 行為符合預期。

驗證

  • node --check app/index.jsci.yaml/cd.yamlyaml.safe_loadsh -n entrypoint.sh 皆通過。
  • 隔離測試(未執行 main、未呼叫 API)確認 log 輸出為 [階段][等級][時間]: 訊息fail 走 stderr。
  • README 錨點一致性、函式起始行號對應皆通過。
## 變更摘要 彙整本次 `release-cleanup` action 的文件化、CI 強化與日誌格式修正(共 5 個 commit),目標分支 `develop`。 ## 重點變更 - **app/index.js(日誌格式)**:統一為 `[階段][等級][時間]: 訊息`。新增 `stage()` 設定目前階段、`timestamp()` 取 Asia/Taipei 時間、`formatLog()` 共用組裝;等級 `INF`(含成功)/`WRN`/`ERR`。階段為 `參數檢查` → `取得舊版本` → `刪除舊版本`。移除舊的 `separator()`/`section()` 分隔區塊(啟動橫幅改由 `entrypoint.sh` 輸出)。對外行為、控制流、exit code 不變;`fail` 走 stderr、其餘走 stdout。 - **.gitea/workflows/ci.yaml**:改為 PR 觸發的 `release-tag-version`(is_beta) → `release-cleanup` 自我清理管線(dogfooding),補齊逐行註解與正確的開頭用途註解。 - **.gitea/workflows/cd.yaml**:補齊「用途+更新日期」同一註解區塊與逐行註解。 - **entrypoint.sh**:更新容器啟動橫幅的產生時間戳。 - **README.md**:重建專案列表、功能列表、使用範例;新增「日誌輸出格式」章節(含 `[階段][等級][時間]` 說明),並更新為新的公開函式面(含 `stage`/`timestamp`/`formatLog`)。 ## 影響範圍 - 唯一對外行為變更:action 的 CI log 行格式改為 `[階段][等級][時間]`(判斷邏輯、exit code、輸出串流不變)。 - `ci.yaml` 觸發內容改變:PR 開啟/同步時會標 beta 版並執行 `release-cleanup`(自我清理)。 ## 風險/注意事項 - 若有既有的 log 解析流程,需留意日誌行格式已改變(新增 `[階段]` 前綴與等級碼)。 - 請確認 `ci.yaml` dogfooding 行為符合預期。 ## 驗證 - `node --check app/index.js`、`ci.yaml`/`cd.yaml` 之 `yaml.safe_load`、`sh -n entrypoint.sh` 皆通過。 - 隔離測試(未執行 `main`、未呼叫 API)確認 log 輸出為 `[階段][等級][時間]: 訊息`,`fail` 走 stderr。 - README 錨點一致性、函式起始行號對應皆通過。
jiantw83 added 3 commits 2026-06-30 10:29:58 +00:00
- .gitea/workflows/ci.yaml、cd.yaml:新增用途/更新日期區塊與逐行註解(指令邏輯不變)
- app/index.js:日誌統一為 [等級][台灣時間]: 訊息(新增 timestamp helper,INF/WRN/ERR;行為、控制流、exit code、stdout/stderr 皆等價)
- README.md:重建專案列表三表/功能列表/使用範例,新增日誌格式說明與 timestamp 功能

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- release-tag-version job:以 is_beta: true 標註 beta 版並輸出 version
- release-cleanup job:needs 前者,於該 beta 版本上執行 release-cleanup action(dogfooding 自我清理)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
docs(release-cleanup): 修正 ci.yaml 過時用途註解並更新 entrypoint.sh 產生時間戳
CI / Release Tag Version (pull_request) Successful in 29s
CI / Release Cleanup (pull_request) Successful in 3s
9d8cbb6f1c
- ci.yaml:開頭用途註解改為描述實際的 release-tag-version(beta) + release-cleanup 自我清理管線(邏輯不變)
- entrypoint.sh:更新產生時間戳為 2026/06/30 18:19:59

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
jiantw83 added 2 commits 2026-07-01 01:07:13 +00:00
- 新增 stage() 設定目前階段、formatLog() 共用組裝,log 統一為 [階段][等級][時間]: 訊息
- 階段對應 參數檢查/取得舊版本/刪除舊版本;移除 separator()/section() 的 ==== / ---- 分隔區塊
- 行為、控制流、exit code 不變;fail 仍走 stderr、其餘走 stdout

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
docs(README): 配合日誌格式調整重建功能列表與使用範例
CI / Release Tag Version (pull_request) Successful in 2m4s
CI / Release Cleanup (pull_request) Successful in 4s
fcf6b0838b
- 移除 separator/section、新增 stage/formatLog 條目與錨點
- 更新「日誌輸出格式」章節與各範例為 [階段][等級][時間],同步函式起始行號

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
admin merged commit 0ab90be3bb into develop 2026-07-01 01:10:25 +00:00
admin deleted branch ai-review-resolve/develop-20260630-182903 2026-07-01 01:10:25 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: old-docker-actions/release-cleanup#9