Skip to content

Commit 7827f4b

Browse files
author
Adam Chan
committed
Fix release-state docs and guard
1 parent fd6d3dc commit 7827f4b

15 files changed

Lines changed: 169 additions & 35 deletions

‎CHANGELOG.md‎

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,22 @@
11
# 變更紀錄
22

3-
## v0.3.44 — candidate
3+
## v0.3.45 — 2026-07-18
44

5-
狀態：本地候選，尚未發佈。正式可用版本仍是 v0.3.43。
5+
狀態：正式發佈版本。本版是 v0.3.44 後的發佈狀態一致性 hotfix；GitHub Release 與 npm `@latest` 應以 v0.3.45 為準。
6+
7+
### 發佈狀態一致性
8+
9+
- 修正 v0.3.44 發佈後 README、英文 README、CHANGELOG、版本頁索引與公開 HTML 仍顯示 candidate / 尚未發佈 / v0.3.43 latest 的錯誤。
10+
- 發佈前候選 commit 不再把會進入 npm 或 public main 的 active surface 寫成「尚未發佈」；候選狀態只屬發佈前 QA 報告，不屬使用者入口文案。
11+
- `check-release-readiness.mjs` 新增 release-state coherence gate，阻擋 active public surfaces 在當前版本中殘留 candidate、unpublished 或上一個 npm latest 狀態。
12+
13+
## v0.3.44 — 2026-07-18
14+
15+
狀態：正式發佈版本；後續由 v0.3.45 修正其公開 surface 發佈狀態文案與 QC 漏檢。
616

717
### 中英文公開說明對齊
818

9-
- 本候選正逐頁把英文 README、入門、實操指南、AI 安裝頁與本機工作系統案例對齊繁體中文來源；未完成獨立語意及視覺讀回的頁面不可宣稱完成或作為發佈證據。
19+
- 本版逐頁把英文 README、入門、實操指南、AI 安裝頁與本機工作系統案例對齊繁體中文來源；未完成獨立語意及視覺讀回的頁面不可宣稱完成或作為發佈證據。
1020
- 雙向語言導航和頁面可用性保留為恆常公開表面檢查；完整翻譯對齊只在該中英文文件對有變動時觸發，不能用字數、emoji 或一段舊 PASS 冒充語意驗收。
1121

1222
## v0.3.43 — 2026-07-17

‎README.en.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
[繁體中文](README.md) · [Getting started](https://adamchanadam.github.io/agent-handoff-kit/agent-handoff-kit-intro.en.html) · [Practical guide](https://adamchanadam.github.io/agent-handoff-kit/agent-handoff-kit-guide.en.html) · [AI install page](https://adamchanadam.github.io/agent-handoff-kit/agent-handoff-kit-ai-install.en.html)
44

5-
Current source candidate: `v0.3.44`. The currently published npm release is `v0.3.43`.
5+
Current published release: `v0.3.45` (GitHub Release and npm `@latest`).
66

77
<p align="center">
88
<img src="https://raw.githubusercontent.com/Adamchanadam/agent-handoff-kit/main/images/agent-handoff-kit-promo-30s.gif" alt="Agent Handoff Kit overview animation" width="720">

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
English: [README.en.md](README.en.md) · [Getting started](https://adamchanadam.github.io/agent-handoff-kit/agent-handoff-kit-intro.en.html) · [Practical guide](https://adamchanadam.github.io/agent-handoff-kit/agent-handoff-kit-guide.en.html) · [AI install page](https://adamchanadam.github.io/agent-handoff-kit/agent-handoff-kit-ai-install.en.html)
44

5-
目前候選版本：`v0.3.44`（尚未發佈）；正式可用版本是 `v0.3.43`。
5+
目前正式版本：`v0.3.45`（GitHub Release 與 npm `@latest`）。
66

77
<p align="center">
88
<img src="https://raw.githubusercontent.com/Adamchanadam/agent-handoff-kit/main/images/agent-handoff-kit-promo-30s.gif" alt="Agent Handoff Kit 功能簡介動畫" width="720">

‎agent-handoff-kit-ai-install.en.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,11 @@
1313
<body>
1414
<div class="stripe"></div>
1515
<header><div class="wrap">
16-
<span class="kicker">AI-readable install page · v0.3.44 candidate</span>
16+
<span class="kicker">AI-readable install page · v0.3.45</span>
1717
<p><a href="agent-handoff-kit-ai-install.html" lang="zh-Hant">繁體中文版本</a></p>
1818
<h1>Instructions for an AI<br>to install or upgrade safely.</h1>
1919
<p class="lead">This page is for an agentic AI that can read and write the local folder and run terminal commands. The user should not have to choose an npm command or diagnose a conflict. Read this page before acting in the folder.</p>
20-
<p><strong>Version note:</strong> this source page can be ahead of the published npm package. <code>@latest</code> means the version currently available from the npm registry.</p>
20+
<p><strong>Version note:</strong> this page is aligned with v0.3.45. <code>@latest</code> means the version currently available from the npm registry.</p>
2121
<div class="prompt"><h2>The user only needs to paste this</h2><div class="code">Please read https://adamchanadam.github.io/agent-handoff-kit/agent-handoff-kit-ai-install.en.html, and install or upgrade Agent Handoff Kit in this folder.</div></div>
2222
<div class="ok"><h2>The AI must give this report when it finishes</h2><p>Before running any <code>npx</code> command, remember this section. After installation or upgrade, the AI must not say only “completed” or paste only terminal output. It must explain the result and next step to the user in the following format.</p><p><strong>Completion-report template:</strong> ✅ Installation completed. 📁 Current folder: &lt;absolute path&gt;. 🩺 <code>doctor</code> passed. ⚠️ The next step is not a terminal command; in an AI conversation that can read and write this folder, enter <code>Start Agent Handoff</code> or “開工”. Only if the AI has not yet been pointed at this folder, use: <code>Work in &lt;absolute path&gt;. Read AGENTS.md first, then Start Agent Handoff. Before changing anything, tell me the current state and your recommended next step.</code></p></div>
2323
</div></header>

‎agent-handoff-kit-ai-install.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -191,11 +191,11 @@
191191

192192
<header>
193193
<div class="wrap">
194-
<span class="kicker">AI-readable install page · v0.3.44 candidate</span>
194+
<span class="kicker">AI-readable install page · v0.3.45</span>
195195
<p style="margin:0 0 18px;"><a href="agent-handoff-kit-ai-install.en.html" lang="en">English version</a></p>
196196
<h1>給 AI 讀的<br/>安裝與升級指令</h1>
197197
<p class="lead">本頁給能讀寫本機資料夾、可執行終端機命令的 agentic AI 使用。用戶不用先理解 npm 或選擇指令；AI 讀完本頁後，應在目前資料夾安全判斷要安裝、升級或停止。</p>
198-
<p><strong>版本提示：</strong>本頁版本可能先於 npm 正式發佈；<code>@latest</code> 實際取得版本以 npm registry 為準。</p>
198+
<p><strong>版本提示：</strong>本頁對齊 v0.3.45；<code>@latest</code> 實際取得版本以 npm registry 為準。</p>
199199

200200
<div class="prompt-box">
201201
<h2>用戶只需貼這一句</h2>

0 commit comments

Comments
 (0)