labsiqbal/wrap-session

Sitzung abschließen

Schließe die aktuelle Sitzung sauber ab. Chat ist Entwurf. Datenträger ist Wahrheit.

/wrap-session bedeutet: Sitzungsrückstände inspizieren, dauerhafte Aktionen vorschlagen, auf Genehmigung des Besitzers warten, nur genehmigte Aktionen ausführen und dann einen Beleg schreiben.

Verwendung

Vor dem Verlassen einer Sitzung mit Code, Entscheidungen, Dokumenten, betrieblichen Änderungen oder unerledigten Arbeiten verwenden, die eine andere Sitzung fortsetzen muss.

Smalltalk ohne dauerhafte Dinge überspringen.

Beleg

Ein Beleg pro Sitzung:

~/.local/state/session-wrap/<session_id>.md

Sitzungs-ID des Arbeitsbereichs verwenden, wenn verfügbar. Andernfalls local-YYYYMMDD-HHMMSS-<cwdslug> generieren.

Der Frontmatter des Belegs muss enthalten:

• session_id
• harness: Name des aktiven Arbeitsbereichs oder other
• source: Aktive Sitzungsoberfläche oder other
• cwd: Absoluter Pfad
• project: Nächster Git-Root-Name, nächster Verzeichnisname oder (root)
• wrapped_at: ISO-8601-Zeitstempel
• next: Eine erste Aktion

Überschriften des Texts: Erledigt, Entscheidungen, Geschrieben, Git, Zurückgestellt, Nächstes.

Ein Beleg bedeutet sauberer Abschluss. Unerledigte Arbeit ist zurückgestellt, niemals ein offener Beleg. Erneutes Abschließen derselben Sitzungs-ID überschreibt den alten Beleg.

Ablauf

1. Inspizieren

Sitzungs-ID, Quelle, absolutes aktuelles Verzeichnis, Projektbezeichnung und – falls in einem Git-Arbeitsbaum – git status --short --branch sammeln.

Abschluss: Jedes Belegfeld hat einen wahrheitsgemäßen Wert.

2. Wrap-Plan entwerfen

Noch nicht schreiben. Anzeigen:

WRAP PLAN
project: ...
cwd: ...

Erledigt:
- Ergebnis + Nachweispfad, Commit oder URL

Zu persistierende Entscheidungen:
1. Entscheidung → vorgeschlagener Pfad oder überspringen

Zurückgestellte Arbeiten:
- Element → vorgeschlagenes Backlog, Ticket oder Dokumentenheimat

Git:
- sauber oder absichtlich schmutzig
- vorgeschlagene Commit-Nachricht, falls erforderlich
- push: standardmäßig nein

Gedächtnis:
- stabile Tatsache oder keine

Nächste Sitzung beginnt mit:
- einer Aktion

Auf vorhandene Artefakte verweisen. Nicht den gesamten Chat in ein Dokument kopieren. Jedes unerledigte Element in eine echte Heimat legen oder explizit als übersprungen markieren.

3. Besitzer-Gate

Besitzer bitten, zu genehmigen oder zu bearbeiten:

1. Schreibvorgänge für Entscheidungen, Zurückgestelltes und Gedächtnis
2. Git-Aktion: belassen, committen oder committen+pushen
3. Planbearbeitungen

all, ausgewählte Nummern, Freitextbearbeitungen oder cancel akzeptieren.

Bei cancel: Nichts schreiben und Abbruch melden.

4. Genehmigte Aktionen ausführen

Nur genehmigte Schreib- und Git-Aktionen ausführen. Jede externe Auswirkung vor der Erfolgsmeldung überprüfen. Fehlschläge als Fehlschläge melden.

5. Beleg schreiben

Übergeordnetes Verzeichnis erstellen, falls nicht vorhanden. Schreiben:

---
session_id: <id>
harness: <arbeitsbereich>
source: <sitzungsoberfläche|other>
cwd: <absoluter Pfad>
project: <projekt>
wrapped_at: <ISO-8601>
next: <eine Aktion>
---

# Sitzung abschließen · <projekt>

## Erledigt
- ...

## Entscheidungen
- ...

## Geschrieben
- Pfad — was, oder (keine)

## Git
- ...

## Zurückgestellt
- Element → Heimat, oder (keine)

## Nächstes
- ...

Abschluss: Belegdatei existiert am erwarteten Pfad.

6. Bestätigen

Mit Belegpfad, vorgenommene Datei- oder Git-Änderungen, zurückgestellte Arbeit und deren Heimat sowie die Zeile „Nächstes“ antworten. Stopp.

Optionaler Statusbericht

Begleitdetektor ausführen, wenn verfügbar:

bin/wrap-status.sh
bin/wrap-status.sh init

Er liest die Hermes-state.db plus Belege. init ist explizit und erstellt nur das Belegverzeichnis plus Rollout-Basislinie. Ohne Hermes-Zustandsdatenbank meldet er Belege und beendet erfolgreich.