old-docker-actions/release-cleanup
2
0
Fork 0
Code Pull Requests Actions Releases 4 Activity

release-cleanup：文件化補齊、日誌格式統一與 CI 自我清理管線（develop → master） #10

Merged
admin merged 7 commits from develop into master 2026-07-01 01:35:55 +00:00
Conversation 1 Commits 7 Files Changed 6
+219 -91
jiantw83 commented 2026-07-01 01:29:11 +00:00
Member
Copy Link
Copy Source

變更摘要

將 develop 累積的文件化、日誌格式統一與 CI/CD 管線調整釋出到 master，並補上最新一輪 JSDoc 例外說明校正與指令檔更新時間刷新。全部屬文件／註解／CI 設定變更，主程式對外行為未改變。

影響範圍

  • 日誌格式：app/index.js 的等級式輸出統一為 [階段][等級][時間] 格式（Asia/Taipei 時區），移除區段分隔線。
  • 文件化：app/index.js 全函式補齊 JSDoc；entrypoint.sh、Dockerfile、.gitea/workflows/*.yaml 補齊「用途＋更新日期同區塊」與逐行註解；README.md 依規範重建（專案列表／功能列表／使用範例，含錨點一致性）。
  • CI/CD 管線：ci.yaml 改為 PR（opened/synchronize，master 除外）觸發 → 先以 composite action release-tag-version（is_beta）標 beta 版，再以該 beta 版執行本專案 release-cleanup action 做 dogfooding 自我清理；cd.yaml 於 master push 時標版。

重點檔案

  • app/index.js：日誌格式統一 + 全函式 JSDoc；本輪校正 fetchAllPages／deleteUrl 的 @throws（原稱「不擲例外」，補正為底層 fetch 網路錯誤／JSON 解析失敗仍會上拋，由 main().catch 收斂）。
  • README.md：重建，更新時間刷新為 2026/07/01。
  • entrypoint.sh / Dockerfile / .gitea/workflows/ci.yaml / .gitea/workflows/cd.yaml：註解校正與更新日期刷新至 2026/07/01。

風險與注意事項

  • 純文件／註解／CI 設定變更，無程式邏輯異動，語法驗證（node --check、sh -n、YAML 解析）皆通過。
  • Dockerfile 維持零相依單階段 lts-alpine（對本 action 為最小映像，刻意保留）。

內含 commit

  • docs(release-cleanup): 校正 JSDoc 例外說明、刷新指令檔更新時間並重建 README
  • docs(release-cleanup): 文件化補齊、日誌格式統一與 CI 自我清理管線（#9）
  • docs(README): 配合日誌格式調整重建功能列表與使用範例
  • fix(release-cleanup): 日誌改為 [階段][等級][時間] 格式並移除區段分隔線
  • docs(release-cleanup): 修正 ci.yaml 過時用途註解並更新 entrypoint.sh 產生時間戳
  • ci(release-cleanup): ci.yaml 改為 PR 觸發 beta 標版 + 自我清理管線
  • docs(release-cleanup): 補齊 CI workflow 註解、統一日誌格式並重建 README
## 變更摘要 將 `develop` 累積的文件化、日誌格式統一與 CI/CD 管線調整釋出到 `master`，並補上最新一輪 JSDoc 例外說明校正與指令檔更新時間刷新。全部屬文件／註解／CI 設定變更，**主程式對外行為未改變**。 ## 影響範圍 - **日誌格式**：`app/index.js` 的等級式輸出統一為 `[階段][等級][時間]` 格式（Asia/Taipei 時區），移除區段分隔線。 - **文件化**：`app/index.js` 全函式補齊 JSDoc；`entrypoint.sh`、`Dockerfile`、`.gitea/workflows/*.yaml` 補齊「用途＋更新日期同區塊」與逐行註解；`README.md` 依規範重建（專案列表／功能列表／使用範例，含錨點一致性）。 - **CI/CD 管線**：`ci.yaml` 改為 PR（opened/synchronize，master 除外）觸發 → 先以 composite action `release-tag-version`（is_beta）標 beta 版，再以該 beta 版執行本專案 `release-cleanup` action 做 dogfooding 自我清理；`cd.yaml` 於 master push 時標版。 ## 重點檔案 - `app/index.js`：日誌格式統一 + 全函式 JSDoc；本輪校正 `fetchAllPages`／`deleteUrl` 的 `@throws`（原稱「不擲例外」，補正為底層 fetch 網路錯誤／JSON 解析失敗仍會上拋，由 `main().catch` 收斂）。 - `README.md`：重建，更新時間刷新為 2026/07/01。 - `entrypoint.sh` / `Dockerfile` / `.gitea/workflows/ci.yaml` / `.gitea/workflows/cd.yaml`：註解校正與更新日期刷新至 2026/07/01。 ## 風險與注意事項 - 純文件／註解／CI 設定變更，無程式邏輯異動，語法驗證（`node --check`、`sh -n`、YAML 解析）皆通過。 - `Dockerfile` 維持零相依單階段 `lts-alpine`（對本 action 為最小映像，刻意保留）。 ## 內含 commit - docs(release-cleanup): 校正 JSDoc 例外說明、刷新指令檔更新時間並重建 README - docs(release-cleanup): 文件化補齊、日誌格式統一與 CI 自我清理管線（#9） - docs(README): 配合日誌格式調整重建功能列表與使用範例 - fix(release-cleanup): 日誌改為 [階段][等級][時間] 格式並移除區段分隔線 - docs(release-cleanup): 修正 ci.yaml 過時用途註解並更新 entrypoint.sh 產生時間戳 - ci(release-cleanup): ci.yaml 改為 PR 觸發 beta 標版 + 自我清理管線 - docs(release-cleanup): 補齊 CI workflow 註解、統一日誌格式並重建 README
jiantw83 added 7 commits 2026-07-01 01:29:12 +00:00
docs(release-cleanup): 補齊 CI workflow 註解、統一日誌格式並重建 README 15381d07a7 
- .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>
ci(release-cleanup): ci.yaml 改為 PR 觸發 beta 標版 + 自我清理管線 a9b9f95a72 
- 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
Details
CI / Release Cleanup (pull_request) Successful in 3s
Details
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>
fix(release-cleanup): 日誌改為 [階段][等級][時間] 格式並移除區段分隔線 c37b33f397 
- 新增 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
Details
CI / Release Cleanup (pull_request) Successful in 4s
Details
fcf6b0838b 
- 移除 separator/section、新增 stage/formatLog 條目與錨點
- 更新「日誌輸出格式」章節與各範例為 [階段][等級][時間]，同步函式起始行號

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Merge pull request 'docs(release-cleanup): 文件化補齊、日誌格式統一與 CI 自我清理管線' (#9) from ai-review-resolve/develop-20260630-182903 into develop 0ab90be3bb 
Reviewed-on: docker-actions/release-cleanup#9
docs(release-cleanup): 校正 JSDoc 例外說明、刷新指令檔更新時間並重建 README a4fa7fec85
admin approved these changes 2026-07-01 01:35:51 +00:00
admin merged commit 1832151e0e into master 2026-07-01 01:35:55 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
admin
Labels
No items
No labels
Milestone
No items
No Milestone
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

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