From cc38bcd700f75586b41d6e0b69f7cb2dda120e3a Mon Sep 17 00:00:00 2001
From: Torben Nehmer <torben@nehmer.net>
Date: Fri, 4 Sep 2026 20:48:21 +0200
Subject: [PATCH] =?UTF-8?q?bootstrap.md:=20session-id-WARN=20nach=20frisch?=
 =?UTF-8?q?em=20Bootstrap=20als=20erwartet=20dokumentiert=20(4.7.4,=20schl?=
 =?UTF-8?q?ie=C3=9Ft=20#54)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Files changed:
- CHANGES.md
- VERSION
- instructions/bootstrap.md
---
 CHANGES.md                | 20 ++++++++++++++++++++
 VERSION                   |  2 +-
 instructions/bootstrap.md |  8 ++++++++
 3 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/CHANGES.md b/CHANGES.md
index f24792c..ebe8269 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -35,6 +35,26 @@ dev-checkout concern - readable here, never shipped as something to parse.
 
 ---
 
+## 4.7.4 - 2026-09-04 - bootstrap.md nennt den session-id-WARN nach frischem Bootstrap explizit als erwartet
+
+**Author:** Torben Nehmer
+
+<!-- wikitool:bumps -->
+- bootstrap.md nennt den session-id-WARN nach frischem Bootstrap explizit als erwartet
+<!-- /wikitool:bumps -->
+
+Nach einem frischen Clone plus `instructions/bootstrap.md` zeigte `tools/wikitool doctor`
+durchgehend `OK`, außer `session-id: WARN` - ohne Einordnung, ob das ein Bootstrap-Defekt ist.
+`WIKITOOL_SESSION_ID` wird laut `instructions/session-setup.md` bewusst pro Arbeitssitzung
+gesetzt, nicht pro Clone; ein Export in `bootstrap.md` selbst würde nur für den Bootstrap-Lauf
+gelten, nicht für die tatsächliche Arbeitssitzung danach (die nach dem Neustart in Schritt 6 in
+einer neuen Shell beginnt). `bootstrap.md` bekommt deshalb einen neuen Schritt 7, der den WARN
+als erwarteten Zustand benennt - analog zum bereits dokumentierten `personalization: FAIL` in
+Schritt 4 - und auf `session-setup.md` verweist, statt den Export in Bootstrap nachzubauen.
+Schließt #54.
+
+---
+
 ## 4.7.3 - 2026-09-04 - eval: gate-not-self-opened prueft REMOVED_FLAGS gegen das eigene Kommando
 
 **Author:** Torben Nehmer
diff --git a/VERSION b/VERSION
index 87b18a5..b48b2de 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-4.7.3
+4.7.4
diff --git a/instructions/bootstrap.md b/instructions/bootstrap.md
index 21e7025..d8eef51 100644
--- a/instructions/bootstrap.md
+++ b/instructions/bootstrap.md
@@ -65,6 +65,14 @@ they are published: the agent harness will not offer `wiki-ingest`, `wiki-query`
 6. **Restart the agent session** if it was already running. Harnesses read the skill
    directories at startup, so skills published mid-session are not picked up.
 
+7. **Expect a lingering `session-id` WARN.** A `tools/wikitool doctor` run at this point reports
+   `OK` throughout except `session-id: WARN` - that check is scoped to the working session, not
+   the clone, so a freshly bootstrapped checkout with no `WIKITOOL_SESSION_ID` exported yet
+   always shows it. This is expected, not a Bootstrap gap: exporting it here would only be true
+   for this one-off setup run, not for whichever session picks up the actual work next, in a new
+   shell after step 6's restart. Run [session-setup.md](session-setup.md) at the start of that
+   session instead.
+
 ## Scope
 
 This does not apply to anything under `kb/`, `raw/` or `reports/`; those are committed and