Clarify stale context version mismatch

Author: fqjony

.rabbit/context.yaml

@@ -6,7 +6,7 @@ generator:
   tool: dev.kit
   repo: https://github.com/udx/dev.kit
   version: 0.14.0
-  generated_at: 2026-06-26T10:41:30Z
+  generated_at: 2026-07-05T18:10:03Z
   sources:
     homepage: https://udx.dev/kit
     repository: https://github.com/udx/dev.kit

bin/dev-kit

@@ -283,7 +283,7 @@ dev_kit_home_context_reason() {
   fi
 
   if [ -n "$(dev_kit_tool_version)" ] && [ "$generator_version" != "$(dev_kit_tool_version)" ]; then
-    printf '%s' "context was generated by a different dev.kit version"
+    printf 'context was generated by dev.kit %s; current dev.kit is %s' "$generator_version" "$(dev_kit_tool_version)"
     return 0
   fi
 

changes.md

@@ -6,6 +6,7 @@
 - Add regression coverage for reference-only command examples so generated context stays tied to runnable repo-owned surfaces.
 - Add release verification guidance that distinguishes GitHub release, npm registry, tarball, and npmjs.com UI evidence.
 - Add `udx/rabbit-automation-action` to the real-repo validation matrix as a manifest-heavy config contract probe.
+- Clarify stale-context output when generated context came from a different `dev.kit` version by showing both the generator and current versions.
 
 ### 0.13.0
 

tests/suite.sh

@@ -128,6 +128,7 @@ ln -sf "$REPO_DIR/bin/dev-kit" "$DEV_KIT_BIN_DIR/dev.kit"
 export PATH="$DEV_KIT_BIN_DIR:$PATH"
 assert_contains "$(command -v dev.kit)" "$DEV_KIT_BIN_DIR/dev.kit" "suite: uses local dev.kit shim"
 assert_contains "$(dev.kit --version)" "$(awk -F'"' '/"version"/{print $4; exit}' "$REPO_DIR/package.json")" "suite: uses checkout dev.kit version"
+DEV_KIT_VERSION="$(awk -F'"' '/"version"/{print $4; exit}' "$REPO_DIR/package.json")"
 
 # shellcheck disable=SC1090
 . "$DEV_KIT_HOME/bin/env/dev-kit.sh"
@@ -297,6 +298,20 @@ if should_run "core"; then
   assert_contains "$home_repeat_text" "reference: README.md" "home text: shows local gap reference"
   assert_contains "$home_repeat_text" "repair:            fix repo-owned gaps, then rerun dev.kit repo" "home text: prints repair loop next step"
 
+  replace_in_file \
+    "$HOME_ACTION_REPO/.rabbit/context.yaml" \
+    "  version: ${DEV_KIT_VERSION}" \
+    "  version: 0.0.0-test"
+
+  stale_version_home_json="$(cd "$HOME_ACTION_REPO" && dev.kit --json)"
+  assert_contains "$stale_version_home_json" "\"context_status\": \"stale\"" "home: marks version-mismatched context as stale"
+  assert_contains "$stale_version_home_json" "\"context_reason\": \"context was generated by dev.kit 0.0.0-test; current dev.kit is ${DEV_KIT_VERSION}\"" "home: reports stale generator and current versions"
+
+  replace_in_file \
+    "$HOME_ACTION_REPO/.rabbit/context.yaml" \
+    "  version: 0.0.0-test" \
+    "  version: ${DEV_KIT_VERSION}"
+
   replace_in_file \
     "$HOME_ACTION_REPO/.rabbit/context.yaml" \
     "No repo-owned configuration contract was found in docs, manifests, or checked-in example files." \