torben/chemenu
1
1
Fork 0
Code Issues 26 Pull Requests Actions Packages Releases 32 Activity

bootstrap.md: session-id-WARN nach frischem Bootstrap nicht als erwartet dokumentiert #54

New Issue
Closed
opened 2026-09-04 18:47:43 +00:00 by torben · 1 comment
torben commented 2026-09-04 18:47:43 +00:00
Owner
Copy Link
Copy Source

Befund

Nach frischem git clone + instructions/bootstrap.md zeigte tools/wikitool doctor
durchgehend OK, außer session-id: WARN
(WIKITOOL_SESSION_ID is not set - budget falls back to the parent PID). bootstrap.md
dokumentierte dieses Muster für den analogen Fall personalization: FAIL bereits explizit in
Schritt 4 - für session-id fehlte die gleiche Einordnung.

Entscheidung (umgesetzt)

Kein Export-Schritt in bootstrap.md: WIKITOOL_SESSION_ID ist laut
instructions/session-setup.md bewusst pro Arbeitssitzung gesetzt, nicht pro Clone. Ein Export
während bootstrap.md selbst gälte nur für den Bootstrap-Lauf - die tatsächliche Arbeitssitzung
beginnt laut Schritt 6 ("Restart the agent session") danach, in einer neuen Shell, die den
Export nicht mehr sieht. Der naheliegende Fix (Export in Bootstrap einbauen) wäre also eine
Attrappe gewesen.

Stattdessen: neuer Schritt 7 in instructions/bootstrap.md, der den session-id: WARN nach
frischem Bootstrap als erwarteten Zustand benennt (analog zu Schritt 4s
personalization: FAIL) und auf instructions/session-setup.md verweist.

Akzeptanzkriterien

  • instructions/bootstrap.md benennt den session-id: WARN nach frischem Bootstrap
    explizit als erwartet (nicht Teil von Bootstrap), mit Verweis auf
    instructions/session-setup.md. - Schritt 7.
  • Kein neuer Export-Schritt in bootstrap.md.
  • tools/wikitool docs verify und tools/wikitool instructions verify liefen grün, dazu die
    volle pytest-Suite (976 passed) - alle drei vor dem Publish.
  • Versions-Bump --patch (4.7.3 -> 4.7.4, reine Doku-Klarstellung, keine
    Schnittstellenänderung).
  • docs/ auf Staleness geprüft: keine Seite dort behandelt Bootstrap oder Session-Scoping,
    nichts zu aktualisieren.

Verifiziert

docs verify, instructions verify, pytest (976 passed) grün vor Publish. Veröffentlicht als
4.7.4, Commit cc38bcd auf main.

Modell-Herkunft

Design, Umsetzung, Versions-Bump und dieser Abschluss liefen alle in derselben Sitzung auf
Sonnet 5 - kein Modellwechsel nötig, der Umfang war zu klein für die Design/Mechanik-Trennung
aus stack-dev Schritt 3.

## Befund Nach frischem `git clone` + `instructions/bootstrap.md` zeigte `tools/wikitool doctor` durchgehend `OK`, außer `session-id: WARN` (`WIKITOOL_SESSION_ID is not set - budget falls back to the parent PID`). `bootstrap.md` dokumentierte dieses Muster für den analogen Fall `personalization: FAIL` bereits explizit in Schritt 4 - für `session-id` fehlte die gleiche Einordnung. ## Entscheidung (umgesetzt) Kein Export-Schritt in `bootstrap.md`: `WIKITOOL_SESSION_ID` ist laut `instructions/session-setup.md` bewusst pro Arbeitssitzung gesetzt, nicht pro Clone. Ein Export während `bootstrap.md` selbst gälte nur für den Bootstrap-Lauf - die tatsächliche Arbeitssitzung beginnt laut Schritt 6 ("Restart the agent session") danach, in einer neuen Shell, die den Export nicht mehr sieht. Der naheliegende Fix (Export in Bootstrap einbauen) wäre also eine Attrappe gewesen. Stattdessen: neuer Schritt 7 in `instructions/bootstrap.md`, der den `session-id: WARN` nach frischem Bootstrap als erwarteten Zustand benennt (analog zu Schritt 4s `personalization: FAIL`) und auf `instructions/session-setup.md` verweist. ## Akzeptanzkriterien - [x] `instructions/bootstrap.md` benennt den `session-id: WARN` nach frischem Bootstrap explizit als erwartet (nicht Teil von Bootstrap), mit Verweis auf `instructions/session-setup.md`. - Schritt 7. - [x] Kein neuer Export-Schritt in `bootstrap.md`. - [x] `tools/wikitool docs verify` und `tools/wikitool instructions verify` liefen grün, dazu die volle `pytest`-Suite (976 passed) - alle drei vor dem Publish. - [x] Versions-Bump `--patch` (4.7.3 -> 4.7.4, reine Doku-Klarstellung, keine Schnittstellenänderung). - [x] `docs/` auf Staleness geprüft: keine Seite dort behandelt Bootstrap oder Session-Scoping, nichts zu aktualisieren. ## Verifiziert `docs verify`, `instructions verify`, `pytest` (976 passed) grün vor Publish. Veröffentlicht als 4.7.4, Commit `cc38bcd` auf `main`. ## Modell-Herkunft Design, Umsetzung, Versions-Bump und dieser Abschluss liefen alle in derselben Sitzung auf Sonnet 5 - kein Modellwechsel nötig, der Umfang war zu klein für die Design/Mechanik-Trennung aus `stack-dev` Schritt 3.
torben added the prio/plannedsize/Sarea/processkind/build labels 2026-09-04 18:47:43 +00:00
torben commented 2026-09-04 18:49:38 +00:00
Author
Owner
Copy Link
Copy Source

Changelog: Umgesetzt statt nur entschieden - Schritt 7 in bootstrap.md ergänzt, alle Checks grün, veröffentlicht als 4.7.4 (cc38bcd). docs/ auf Staleness geprüft, nichts betroffen.

**Changelog:** Umgesetzt statt nur entschieden - Schritt 7 in `bootstrap.md` ergänzt, alle Checks grün, veröffentlicht als 4.7.4 (`cc38bcd`). `docs/` auf Staleness geprüft, nichts betroffen.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/corpus
Betrifft Demo-/Testbett-Frage, Inhalt und Umfang von kb/
 area/distribution
Betrifft Auslieferung, Upgrade, Versionierung einer Instanz
 area/kb
Betrifft kb/-Schema, Contract, Confidence, Lint, Wissensbasis
 area/process
Betrifft den Entwicklungsprozess selbst, nicht den Stack als Artefakt
 area/workflow
Betrifft Git, Merge, Branching, Publish, PRs
 kind/build
Spezifiziert, wartet nur noch auf Umsetzungszeit
 kind/decision
Wartet auf eine Betreiberentscheidung
 kind/defect
Befund: Doku und Realitaet, oder zwei Dokus, widersprechen sich
 prio/blocking
Blockiert oder beschaedigt laufende Arbeit - als naechstes
 prio/planned
Traegt bald Zinsen - eingeplant
 prio/waiting
Sinnvoll, wartet auf einen Ausloeser
 size/L
Mehrere Sitzungen oder offene Designfragen vor dem ersten Commit
 size/M
Mehrere Dateien, Contract- oder Instruction-Aenderung, eigener Testaufwand
 size/S
Eine Sitzung, ein Publish, klar umrissener Schnitt
 status/blocked
Wartet auf ein anderes, noch offenes Issue - nicht eigenstaendig bearbeitbar
 status/incoming
Vom Menschen angelegte Anforderung, unvollständig, muss durch den Stack komplettiert werden.
 status/unconfirmed
Gemeldeter Verdacht, noch nicht gegen tatsaechliches Verhalten geprueft - size/prio vorlaeufig
No Label area/process kind/build prio/planned size/S
Milestone
No items
No Milestone
Assignees
Clear assignees
torben
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: torben/chemenu#54
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?