@adamchanadam/agent-handoff-kit 0.3.10 → 0.3.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Agent Handoff Kit
2
2
 
3
- 狀態:目前版本為 `v0.3.10`。這是早期可用版本,仍在持續完善中。
3
+ 狀態:目前版本為 `v0.3.11`。這是早期可用版本,仍在持續完善中。
4
4
 
5
5
  ![Agent Handoff Kit 主視覺](https://raw.githubusercontent.com/Adamchanadam/agent-handoff-kit/main/images/agent-handoff-kit-main-visual2.png)
6
6
 
@@ -257,7 +257,7 @@ Agent Handoff Kit 可與 [Adam-AI-Instructions](https://github.com/prompt-templa
257
257
 
258
258
  ## 目前限制
259
259
 
260
- - 目前版本為 `v0.3.10`。
260
+ - 目前版本為 `v0.3.11`。
261
261
  - 這是早期可用版本,仍在持續完善中。
262
262
  - 升級合併屬窄範圍策略,不是完整的複雜合併工具。
263
263
  - `doctor` 能檢查結構,不能代替 AI 對專案內容的理解。
@@ -1971,18 +1971,21 @@ function printInstallNextSteps(root, conflictCount, mode = "first-install", skip
1971
1971
  // R-031 v0.3.1+: Upgrade substantive next-step block. Distinct from install
1972
1972
  // (`printInstallNextSteps`) because the user is not first-time; pushing them through
1973
1973
  // the onboarding canonical phrase resets context they already have.
1974
- async function printUpgradeNextSteps(root, conflictCount, version, preUpgradeRootVersion) {
1975
- console.log("");
1976
- console.log("============================================================");
1974
+ async function printUpgradeNextSteps(root, conflictCount, version, preUpgradeRootVersion) {
1975
+ console.log("");
1976
+ console.log("============================================================");
1977
+ if (conflictCount > 0) {
1978
+ console.log("⚠️ 升級未完成:有檔案需要人工確認");
1979
+ console.log("============================================================");
1980
+ console.log("⚠️ 狀態:有既有檔案需要人工確認,詳情見 migration report。");
1981
+ console.log("⚠️ 這不是檔案壞掉;工具已停手,沒有覆寫 conflict 檔案。");
1982
+ console.log("📋 下一步:把 migration report 或這段輸出貼給 AI,請它幫你判斷怎樣合併。");
1983
+ console.log("============================================================");
1984
+ return;
1985
+ }
1977
1986
  console.log("✅ 升級完成:Kit 檔案已更新到最新版本");
1978
- console.log("============================================================");
1979
- if (conflictCount > 0) {
1980
- console.log("⚠️ 狀態:有既有檔案需要人工確認,詳情見 migration report。");
1981
- console.log("⚠️ 這不是檔案壞掉;工具已停手,沒有覆寫 conflict 檔案。");
1982
- console.log("📋 下一步:把 migration report 或這段輸出貼給 AI,請它幫你判斷怎樣合併。");
1983
- console.log("");
1984
- }
1985
- // R-031.2 v0.3.2+: Inline whatsnew summary — directly surface what changed in this
1987
+ console.log("============================================================");
1988
+ // R-031.2 v0.3.2+: Inline whatsnew summary — directly surface what changed in this
1986
1989
  // version (and any intermediate versions the user skipped).
1987
1990
  // R-031.3 v0.3.3+: fromVersion now uses pre-upgrade snapshot (captured before
1988
1991
  // inject mutated PROJECT_INDEX), so the range narrative reflects actual user
@@ -1,13 +1,13 @@
1
1
  # v0.3.1
2
2
 
3
- ## 本版新加咗咩
3
+ ## 本版新加了甚麼
4
4
 
5
- CLI 升級流程嘅 messaging 改進 —— 你升完或者第二次跑 upgrade 嗰陣會見到唔同 output。第二次跑 upgrade(零改動)會直接短訊「你已係最新版本」,唔再印「安裝完成」+ 新手起步句嘅完整 ceremony。
5
+ 改善升級流程的提示文字。完成升級、再次執行 `upgrade`、或沒有任何檔案需要更新時,工具會顯示不同提示,避免把「已經是最新版本」誤說成「安裝完成」。
6
6
 
7
- ## 對你已有檔案嘅影響
7
+ ## 對你已有檔案的影響
8
8
 
9
- 完全冇影響。純 CLI source 改進,無 user-facing template 改動,doctor 對既有用戶仍 PASS。
9
+ 本版只調整工具輸出文字,不會改動既有項目內容,也不會改變已安裝的 Kit 文件結構。
10
10
 
11
11
  ## 建議下一步
12
12
 
13
- 跑 doctor confirm 健康即可。
13
+ 執行 `doctor` 檢查項目健康即可。
@@ -0,0 +1,19 @@
1
+ # v0.3.11
2
+
3
+ ## 本版新加了甚麼
4
+
5
+ 本版把 v0.3.10 發佈後留下的用戶旅程檢查補成長期守門。重點不是增加新功能,而是把已驗證的首次安裝、升級、衝突停手與公開文件一致性,轉成每次發佈前都會跑的檢查。
6
+
7
+ ## 對你已有檔案的影響
8
+
9
+ 既有項目不用重裝。升級時若沒有需要合併的內容,工具不會假裝完成一件大事;若遇到不能安全判斷的衝突,會清楚停手並提示先處理衝突。舊版本升上來時,工具也會保留既有資料與本地規則。
10
+
11
+ ## 建議下一步
12
+
13
+ 升級前可先預演:
14
+
15
+ ```bash
16
+ npx --yes @adamchanadam/agent-handoff-kit@latest upgrade --dry-run
17
+ ```
18
+
19
+ 如果預演沒有 conflict,再執行正式升級。升級後可用 `doctor` 檢查項目是否完整;第一次使用的新項目,仍按安裝後顯示的起步句進入 AI 對話。
@@ -1,13 +1,13 @@
1
1
  # v0.3.2
2
2
 
3
- ## 本版新加咗咩
3
+ ## 本版新加了甚麼
4
4
 
5
- Doctor 同 init 命令加入「項目狀態速覽」+「點 confirm 你裝啱咗」。Doctor 跑完會印你嘅版本對齊狀況(CLI / root template / npm latest 三向比較)、上次 closeout 距今幾耐、項目首次安裝距今幾耐。Init 完會印 mini-checklist 答「我裝啱咗嗎」嘅 anxiety,並講清本工具係 background harness(需要連住 AI tool 先見到實際 value)。Upgrade 完會直接 inline print 本版同跨版本嘅 whatsnew 摘要(即你而家睇緊呢段),唔等你 ask AI。
5
+ `doctor` 和 `init` 會顯示「項目狀態速覽」,包括工具版本、項目記錄版本、npm 最新版本、上次收工時間,以及項目首次安裝距今多久。`upgrade` 完成後也會直接顯示本版重點,讓使用者不必再另外查找更新說明。
6
6
 
7
- ## 對你已有檔案嘅影響
7
+ ## 對你已有檔案的影響
8
8
 
9
- 完全冇影響。純 CLI source 改進,無 user-facing template 改動,doctor 對既有用戶仍 PASS。
9
+ 本版只改善工具提示與狀態顯示,不會改動既有項目內容,也不會改變已安裝的 Kit 文件結構。
10
10
 
11
11
  ## 建議下一步
12
12
 
13
- 跑 doctor confirm 健康,順便試吓本版新加嘅「項目狀態速覽」。
13
+ 執行 `doctor` 檢查項目健康,並留意輸出中的「項目狀態速覽」。
@@ -1,13 +1,13 @@
1
1
  # v0.3.3
2
2
 
3
- ## 本版新加咗咩
3
+ ## 本版新加了甚麼
4
4
 
5
- 修補 v0.3.2 用戶實測揭發嘅兩個 narrative coherence bug。升級流程之後 doctor 唔再矛盾講「root 落後 CLI,建議 upgrade」——升完就對齊。跨多版本嘅升級(譬如 v0.1.x 直接升 v0.3.3),whatsnew summary 會明文話你跨度較大,並指你睇 GitHub Release 攞較舊版本嘅完整變更。
5
+ 修正升級後的版本提示矛盾。完成 `upgrade` 後,`doctor` 不應再說項目版本落後於目前工具版本。若使用者從較舊版本直接升級到本版,工具也會提示這次跨度較大,並引導使用者查看 GitHub Release 的完整歷史說明。
6
6
 
7
- ## 對你已有檔案嘅影響
7
+ ## 對你已有檔案的影響
8
8
 
9
- 完全冇影響 user content。Upgrade 之後 `dev/PROJECT_INDEX.md` 嘅「Agent Handoff Kit template version」一行會自動 update 為當前 CLI 版本(呢一行屬 template metadata,唔屬你填嘅內容);其他 row(譬如 External Sources、Fact Base、Workspace Identity)保持不變。
9
+ 本版不會改動使用者填寫的項目內容。`upgrade` 後,`dev/PROJECT_INDEX.md` 內的「Agent Handoff Kit template version」資料列會更新為目前版本;其他由使用者填寫的資料列會保留。
10
10
 
11
11
  ## 建議下一步
12
12
 
13
- 跑 doctor confirm 健康即可。
13
+ 執行 `doctor` 檢查項目健康即可。
@@ -1,12 +1,12 @@
1
1
  # v0.3.4
2
2
 
3
- ## 本版新加咗咩
3
+ ## 本版新加了甚麼
4
4
 
5
5
  本版修補升級後版本敘事不一致的問題。既有專案執行 `upgrade` 後,`dev/PROJECT_INDEX.md` 內的「Agent Handoff Kit template version」資料列會在合併完成後再更新為目前 CLI 版本,避免先更新、後又被舊合併結果覆蓋。
6
6
 
7
7
  升級工具也會辨認「只有版本資料列過期」的情況。即使沒有新增檔案、沒有合併檔案、沒有衝突,只要這一列仍是舊版本,就不會誤報「已經是最新版本,沒有檔案需要建立或合併」。
8
8
 
9
- ## 對你已有檔案嘅影響
9
+ ## 對你已有檔案的影響
10
10
 
11
11
  本版只會更新 `dev/PROJECT_INDEX.md` 的 template version metadata。這一列屬工具維護的模板資料,不是你填寫的項目內容。你在 External Sources、Fact Base、Workspace Identity 等表格中填過的內容仍會保留。
12
12
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adamchanadam/agent-handoff-kit",
3
- "version": "0.3.10",
3
+ "version": "0.3.11",
4
4
  "description": "Lightweight agent harness for project memory, handoff, and multi-session continuity.",
5
5
  "type": "module",
6
6
  "bin": {
package/packs/writing.md CHANGED
@@ -16,12 +16,14 @@ Use for drafting, editing, style, structure, publication copy, documentation pro
16
16
  3. Keep terminology consistent with project docs.
17
17
  4. Mark uncertain claims instead of inventing support.
18
18
  5. Do not bury durable requirements only in prose; use project index, spec, runbook, or handoff when needed.
19
+ 6. For public Traditional Chinese docs or HTML aimed at non-technical readers, use steady written Chinese. Keep English only for commands, paths, URLs, file names, product names, and unavoidable tool names. Avoid mixed half-English fragments, internal governance codes, and developer-only wording in reader-facing prose.
19
20
 
20
21
  ## Checks
21
22
 
22
23
  - Verify requested format, language, and tone.
23
24
  - Check links, commands, names, and version-sensitive claims when relevant.
24
25
  - Check `dev/DOC_SYNC_REGISTRY.md` if public docs or user-facing instructions changed.
26
+ - For public Chinese docs, read the final text as a new user journey: the next action should be clear without technical background.
25
27
 
26
28
  ## Closeout
27
29