fix: clarify update release checkout output

CHANGELOG.md

@@ -9,6 +9,12 @@ This project uses a lightweight changelog format:
 - `Fixed` for bug fixes.
 - `Security` for vulnerability-related changes.
 
+## 0.5.1 - 2026-06-18
+
+### Fixed
+
+- Clarified `codex-fable5 update` output by showing the target ref, warning when release-tag checkout may detach HEAD, and printing post-update version details.
+
 ## 0.5.0 - 2026-06-18
 
 ### Added

README.ja.md

@@ -40,7 +40,7 @@ FableCodex は、Codex の作業に Fable 風の運用習慣を追加する Code
 安定版をインストールします。
 
 ```bash
-codex plugin marketplace add baskduf/FableCodex --ref v0.5.0
+codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
 codex plugin add codex-fable5@fablecodex
 ```
 
@@ -219,7 +219,7 @@ plugins/codex-fable5/bin/codex-fable5 status
 安定版:
 
 ```bash
-codex plugin marketplace add baskduf/FableCodex --ref v0.5.0
+codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
 codex plugin add codex-fable5@fablecodex
 ```
 

README.ko.md

@@ -40,7 +40,7 @@ FableCodex는 Codex 작업에 Fable식 운영 습관을 더하는 Codex 플러
 안정 버전을 설치합니다.
 
 ```bash
-codex plugin marketplace add baskduf/FableCodex --ref v0.5.0
+codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
 codex plugin add codex-fable5@fablecodex
 ```
 
@@ -219,7 +219,7 @@ plugins/codex-fable5/bin/codex-fable5 status
 안정 버전:
 
 ```bash
-codex plugin marketplace add baskduf/FableCodex --ref v0.5.0
+codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
 codex plugin add codex-fable5@fablecodex
 ```
 

README.md

@@ -40,7 +40,7 @@ It is useful when the cost of a missed step is higher than the cost of a little
 Install the stable release:
 
 ```bash
-codex plugin marketplace add baskduf/FableCodex --ref v0.5.0
+codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
 codex plugin add codex-fable5@fablecodex
 ```
 
@@ -219,7 +219,7 @@ plugins/codex-fable5/bin/codex-fable5 status
 Stable release:
 
 ```bash
-codex plugin marketplace add baskduf/FableCodex --ref v0.5.0
+codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
 codex plugin add codex-fable5@fablecodex
 ```
 

README.zh-CN.md

@@ -40,7 +40,7 @@ FableCodex 是一个 Codex 插件，用来把 Fable 风格的工作习惯加入
 安装稳定版：
 
 ```bash
-codex plugin marketplace add baskduf/FableCodex --ref v0.5.0
+codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
 codex plugin add codex-fable5@fablecodex
 ```
 
@@ -219,7 +219,7 @@ plugins/codex-fable5/bin/codex-fable5 status
 稳定版：
 
 ```bash
-codex plugin marketplace add baskduf/FableCodex --ref v0.5.0
+codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
 codex plugin add codex-fable5@fablecodex
 ```
 

README.zh-TW.md

@@ -40,7 +40,7 @@ FableCodex 是一個 Codex 外掛，會把 Fable 風格的工作習慣加入 Cod
 安裝穩定版：
 
 ```bash
-codex plugin marketplace add baskduf/FableCodex --ref v0.5.0
+codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
 codex plugin add codex-fable5@fablecodex
 ```
 
@@ -219,7 +219,7 @@ plugins/codex-fable5/bin/codex-fable5 status
 穩定版：
 
 ```bash
-codex plugin marketplace add baskduf/FableCodex --ref v0.5.0
+codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
 codex plugin add codex-fable5@fablecodex
 ```
 

plugins/codex-fable5/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-fable5",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Fable-style Codex workflow with source-section coverage, goal and findings gates, verification grounding, VFF routing, and optional provider bridge guidance.",
   "author": {
     "name": "Codex Fable5 Maintainers"

plugins/codex-fable5/bin/codex-fable5

@@ -128,6 +128,7 @@ cmd_update() {
   fi
 
   if [ "$ref" = "main" ]; then
+    printf 'codex-fable5: target ref %s\n' "$ref"
     current_ref=$(git -C "$REPO_ROOT" rev-parse --abbrev-ref HEAD)
     if [ "$current_ref" != "main" ]; then
       git -C "$REPO_ROOT" checkout main
@@ -141,6 +142,11 @@ cmd_update() {
     fi
     current_commit=$(git -C "$REPO_ROOT" rev-parse HEAD)
     target_commit=$(git -C "$REPO_ROOT" rev-parse "$ref^{commit}")
+    target_short=$(git -C "$REPO_ROOT" rev-parse --short "$ref^{commit}")
+    printf 'codex-fable5: target ref %s (%s)\n' "$ref" "$target_short"
+    if printf '%s\n' "$ref" | grep -Eq '^v[0-9]+(\.[0-9]+)*$'; then
+      printf '%s\n' "codex-fable5: checking out a release tag may leave this git checkout in detached HEAD state."
+    fi
     if [ "$current_commit" = "$target_commit" ]; then
       printf 'codex-fable5: already up to date at %s\n' "$ref"
     else
@@ -149,6 +155,8 @@ cmd_update() {
     fi
   fi
 
+  printf '%s\n' "codex-fable5: post-update version:"
+  cmd_version
   printf '%s\n' "codex-fable5: restart Codex to reload the plugin."
 }
 

tests/test_ci_release.py

@@ -285,6 +285,9 @@ def test_update_command_updates_clean_checkout_to_requested_ref(self) -> None:
             )
             self.assertEqual(update.returncode, 0, update.stderr)
             self.assertIn("updates the FableCodex checkout/plugin package only", update.stdout)
+            self.assertIn("target ref v0.4.4", update.stdout)
+            self.assertIn("detached HEAD", update.stdout)
+            self.assertIn("post-update version", update.stdout)
             self.assertIn("restart Codex", update.stdout)
 
             head = subprocess.run(
@@ -374,6 +377,9 @@ def test_update_default_ignores_prerelease_tags(self) -> None:
                 check=False,
             )
             self.assertEqual(update.returncode, 0, update.stderr)
+            self.assertIn("target ref v1.0.0", update.stdout)
+            self.assertIn("detached HEAD", update.stdout)
+            self.assertIn("post-update version", update.stdout)
             self.assertIn("updated to v1.0.0", update.stdout)
 
             head = subprocess.run(